# Release Notes Install or upgrade to the latest version ```bash npm install -g @treasuredata/tdx@latest ``` ## Release Channels tdx offers two release channels: - **Stable** (default) — Thoroughly tested releases, recommended for most users - **Next** — Early access to new features before they are promoted to stable ### Installation ```bash # Stable (default) npm install -g @treasuredata/tdx@latest # Next channel (early access) npm install -g @treasuredata/tdx@next ``` ### Switching Channels To receive update notifications for a specific channel: ```bash # Switch to next channel tdx use release_channel next --default # Switch back to stable tdx use release_channel stable --default ``` ### How It Works All releases are published to the **next** channel first. After validation, releases are promoted to **stable**. Stable channel users only see promoted releases in update notifications. You can check your current channel with `tdx use release_channel`. ### Treasure Studio In Treasure Studio, you can select the release channel in **Settings > General > Release Channel**. You can also click **Check for Updates** to manually check for new versions. ## v0.26.7 (2026-02-19) ### New Features - **Grid Dashboard preview** - New generic `preview_grid_dashboard` tool renders multi-page grid dashboards in the artifact panel. Any skill can use it to visualize KPI cards, gauges, score bars, Chart.js charts, sortable tables, and markdown cells with cell merging - **Action Report preview** - New generic `preview_action_report` tool renders prioritized action cards with As-Is/To-Be diffs, executive summary, and Copy as Markdown button. Works with any skill that produces structured recommendations - **SerpAPI connector** - Added SerpAPI as a new connector in Settings > Connected Services, enabling SERP analysis with AI Overview detection - **Auto-preview markdown files** - When the AI agent writes or edits a markdown file, a rendered preview automatically appears in the artifact panel - **Job submit result export** - New `--result ` option for `tdx job submit` to specify a result export destination ### Improvements - **Image zoom** - Image artifacts now display inline with click-to-zoom support - **ESC key stops streaming** - Press ESC to stop AI response generation (same as the stop button) - **Recommended skill repositories** - Settings > Skills now shows recommended repositories for quick setup - **Dashboard validation** - Grid dashboard and action report YAML validation now uses Zod schemas, catching incorrect field names and missing required fields with clear error messages ### Using Analysis Skills The grid dashboard and action report preview tools are designed to work with analysis skills. To use them, change your td-skills repository branch to `feature/add-analysis-skills` in Settings > Skills > Repositories. ## v0.26.6 (2026-02-17) ### New Features - **Google Search Console connector** - Added Google Search Console as a new connector in Settings > Connected Services, enabling SEO AI Agent workflows with tools for search analytics, site listing, URL inspection, and sitemap management ### Improvements - **Compaction status indicator** - Studio now shows a visual indicator with spinner when conversation context is being auto-compacted - **Bang command artifacts** - Bang commands (`!tdx query ...`) now display rich artifacts (tables, MCP App UIs) instead of raw text, and support `--key value` flag syntax for MCP tools ### Bug Fixes - **Chat input blocked during compaction** - Chat input is now disabled while context compaction is running to prevent unexpected behavior ## v0.26.5 (2026-02-16) ### New Features - **Command palette** - Added VS Code-style command palette (⌘⇧P) with category filters for Skills, Connectors, Tools, and CLI commands - **Bang commands** - Type `!` to directly execute tdx CLI commands (`!tdx databases`) or MCP tools (`!preview_journey /path`) from the chat input - **Slash command autocomplete** - Type `/` to browse and instantly execute available skills ### Bug Fixes - **Glean connector URL validation** - Added real-time validation to prevent entering invalid Glean URLs with API paths (e.g., `/mcp`, `/api`) - **Glean document reader** - Fixed schema validation to accept both single URL string and URL array formats ## v0.26.4 (2026-02-15) ### Bug Fixes - **Journey preview merge lines** - Fixed merge connector lines overshooting in nested condition waits within journey preview ## v0.26.3 (2026-02-15) ### New Features - **Branch selector for skill repositories** - Added a branch selector dropdown in Settings > Repositories, allowing you to switch marketplace branches and auto-reinstall plugins ## v0.26.2 (2026-02-14) ### Improvements - **Secure connector management** - Glean, HubSpot, and Atlassian connectors now use built-in local tools with keychain-stored tokens, replacing remote MCP servers for more reliable connections ## v0.26.1 (2026-02-14) ### Bug Fixes - **Studio startup update notification** - Suppressed transient "Checking for updates..." spinner at startup; update status now only appears for manual checks - **Studio cache crash** - Fixed a crash when running inside Treasure Studio caused by attempting to create a cache directory at the filesystem root ## v0.26.0 (2026-02-14) ### New Features - **Streaming indicator in chat history** - Studio sidebar now shows a streaming indicator for active chats, making it easy to see which conversations are in progress - **Smooth output panel animation** - Opening the Studio output panel now uses a smooth slide animation for a more polished experience ### Improvements - **Updated Studio color palette** - Studio UI now uses the Treasure Data crystal color palette for a more consistent visual identity - **Cleaner macOS titlebar** - Pane headers are integrated into the macOS titlebar zone for a cleaner Studio layout - **Compact tool call display** - Single-line tool calls now display more compactly in Studio chat - **Responsive layout** - Chat window and buttons adapt better to narrow window sizes ### Bug Fixes - **Welcome screen flicker** - Fixed flickering when switching between Studio chats - **Task list pinning** - Task-list artifacts now stay pinned to the top of the output panel - **Duplicate status bar** - Fixed duplicate status bar appearing when checking for updates from Settings - **SQL preview wrapping** - SQL previews no longer wrap unexpectedly, with consistent header labels > Treasure Studio releases: [github.com/treasure-data/tdx-studio/releases](https://github.com/treasure-data/tdx-studio/releases) ## v0.25.8 (2026-02-13) ### New Features - **New chart types in Treasure Studio** - Added sankey diagrams, treemaps, and funnel charts for richer data visualization - **Atlassian MCP server** - Connect Jira and Confluence via OAuth directly from the MCP server catalog - **Journey preview MCP app** - Visualize journey YAML files as interactive flowcharts in Treasure Studio - **Internet search toggle** - New privacy setting to disable internet search in Treasure Studio for compliance needs ### Improvements - **Updated chart color palette** - Charts now use the Treasure Data color style for better visual consistency ### Bug Fixes - **Failed tool call status** - Tool calls that fail now correctly display red status indicators in Treasure Studio - **Chart artifact sizing** - Chart artifacts now default to compact size for better space utilization > Treasure Studio releases: [github.com/treasure-data/tdx-studio/releases](https://github.com/treasure-data/tdx-studio/releases) ## v0.25.7 (2026-02-13) ### New Features - **Google Analytics (GA4) integration** - View GA4 properties, run reports, and explore metadata directly in Treasure Studio with OAuth-based read-only access ### Bug Fixes - **MCP tool discovery on macOS** - Fixed OAuth tokens not syncing to macOS Keychain, which prevented MCP tools from being discovered after connecting a service > Treasure Studio releases: [github.com/treasure-data/tdx-studio/releases](https://github.com/treasure-data/tdx-studio/releases) ## v0.25.6 (2026-02-13) ### New Features - **Parent segment RT and personalization commands** - New `tdx ps rt list`, `tdx ps rt validate`, `tdx ps pz list`, and `tdx ps pz init` subcommands for managing RT 2.0 and personalization configurations - **Check for Updates button** - Manually check for new versions from **Settings > General > Release Channel** in Treasure Studio ### Bug Fixes - **Chat folder display** - Fixed folder names not displaying correctly for existing chats in Treasure Studio - **Output panel cleanup** - Fixed output panel staying open when switching chats or creating a new chat > Treasure Studio releases: [github.com/treasure-data/tdx-studio/releases](https://github.com/treasure-data/tdx-studio/releases) ## v0.25.5 (2026-02-13) ### New Features - **Experimental knowledge bases and artifacts for agents** - `tdx agent pull/push/clone` now support experimental knowledge base and artifact resources for advanced agent development ## v0.25.4 (2026-02-12) ### Improvements - **Proactive OAuth token refresh** - MCP server OAuth tokens are now refreshed automatically before expiry, preventing connection failures due to stale tokens - **Faster skill activation** - Reduced latency when activating skills by including installed plugins in the warmup phase > Treasure Studio releases: [github.com/treasure-data/tdx-studio/releases](https://github.com/treasure-data/tdx-studio/releases) ## v0.25.3 (2026-02-12) ### New Features - **Release channels** - tdx now offers stable and next release channels, allowing early access to new features via `tdx use release_channel next --default` or in Treasure Studio settings - **Connector health check** - Test connection button in Treasure Studio connector settings shows diagnostics including latency, token status, and detailed error messages > Treasure Studio releases: [github.com/treasure-data/tdx-studio/releases](https://github.com/treasure-data/tdx-studio/releases) ## v0.25.2 (2026-02-11) ### New Features - **Google Drive, Docs, Sheets, Slides integration** - Access Google Drive files and read Google Docs, Sheets, and Slides directly in Treasure Studio with OAuth-based read-only access > Treasure Studio releases: [github.com/treasure-data/tdx-studio/releases](https://github.com/treasure-data/tdx-studio/releases) ## v0.25.1 (2026-02-11) ### New Features - **Redesigned connector catalog** - Browse and manage connected services through a unified catalog with connect/disconnect actions, brand icons, and alphabetical sorting ### Bug Fixes - **MCP tool results stuck** - Fixed MCP tool results getting stuck in "running" state in Treasure Studio > Treasure Studio releases: [github.com/treasure-data/tdx-studio/releases](https://github.com/treasure-data/tdx-studio/releases) ## v0.25.0 (2026-02-11) ### New Features - **Sub-agent streaming in Treasure Studio** - Chat with AI Foundry agents directly inside Treasure Studio with real-time streaming responses and tool activity indicators - **MCP OAuth connector catalog** - Connect external services like HubSpot via OAuth directly from Treasure Studio ### Performance - **Faster chat startup** - New chat sessions display content faster by eliminating unnecessary "Initializing..." delays - **Reduced token usage** - MCP tool definitions are now loaded on-demand, reducing initial context token consumption > Treasure Studio releases: [github.com/treasure-data/tdx-studio/releases](https://github.com/treasure-data/tdx-studio/releases) ## v0.24.0 (2026-02-10) ### New Features - **Google Calendar integration** - View Google Calendar events directly in Treasure Studio with OAuth-based read-only access - **Gmail integration** - Read Gmail messages directly in Treasure Studio with read-only access - **Conversation search** - Search through past conversations in Treasure Studio - **Skills selector** - Browse and activate skills directly from the chat input - **Office file inline preview** - Preview DOCX, PPTX, XLSX, and HTML files inline in Treasure Studio - **Task list artifacts** - Agent task lists now render as interactive artifacts in the chat - **Drag-and-drop tabs** - Reorder tabs and artifacts by dragging and dropping - **File path display in tool cards** - Edit and Write tool cards now show file paths with click-to-open ### Improvements - **Redesigned welcome screen** - Fresh welcome screen with rotating word icons - **Full-screen settings** - Settings window now opens full-screen with tabbed navigation - **Slash command feedback** - Slash commands now show visual feedback when activated - **Task interruption notification** - Chat shows a clear notification when a task is interrupted - **Profile-scoped chat history** - Chat history is now filtered by the active profile ### Bug Fixes - **Credit usage history** - Fixed credit usage monitor not loading past conversation credits - **Profile switching cleanup** - Fixed profile switch not properly cleaning up streaming, artifacts, and attachments - **Dropdown menu transparency** - Fixed translucent dropdown menus in the packaged Electron app - **Chat message overflow** - Fixed chat messages overflowing their containers - **HTML preview** - Fixed HTML preview failing on first render - **Auto updater** - Fixed auto updater failing while CI builds release artifacts - **TODO list spinner** - Fixed spinner not stopping when chat stream ends or is interrupted > Treasure Studio releases: [github.com/treasure-data/tdx-studio/releases](https://github.com/treasure-data/tdx-studio/releases) ## v0.23.0 (2026-02-09) ### New Features - **Credit usage monitor** - Treasure Studio now shows real-time AI credit usage (session / today / month) next to the model selector - **MCP server management** - Add and manage MCP servers directly in Treasure Studio settings with OAuth2 authentication support - **Skills management UI** - Browse, install, and manage skills and custom skill repositories from the Treasure Studio settings panel - **PDF and Office file preview** - PDF files now render inline in Treasure Studio; Office files open in external applications - **Account rename and delete** - Rename or remove accounts directly from the account selector in Treasure Studio - **Behavior tables in `tdx ps desc`** - `tdx ps desc` now displays behavior tables alongside attributes, with new `--output` flag for JSON/TSV output ### Bug Fixes - **Tool call cancellation** - Fixed cancel action causing 400 errors in Treasure Studio chat - **Chat font size consistency** - Fixed inconsistent font sizes across Treasure Studio UI > Treasure Studio releases: [github.com/treasure-data/tdx-studio/releases](https://github.com/treasure-data/tdx-studio/releases) ## v0.22.0 (2026-02-09) ### New Features - **Treasure Studio redesign** - Refreshed UI with a clean, minimal aesthetic and improved visual hierarchy - **Mid-conversation model switching** - Model selector moved to the chat input bar, allowing model changes between messages - **Native macOS dictation** - Use macOS dictation to compose messages in Treasure Studio ### Improvements - **Query result viewer** - Smarter table column widths, float rounding, and SQL wrapping in interactive query results - **Empty message prevention** - Chat input now validates and prevents sending empty messages > Treasure Studio releases: [github.com/treasure-data/tdx-studio/releases](https://github.com/treasure-data/tdx-studio/releases) ## v0.21.0 (2026-02-05) ### Breaking Changes - **Removed `tdx llm proxy` command** - The standalone LLM proxy command has been removed. Use `tdx claude` instead, which handles proxy setup automatically. ### New Features - **HTTP proxy support** - Added proxy support for corporate networks via `--proxy` option, `TDX_PROXY` / `HTTPS_PROXY` environment variables, or profile config - **Interactive query results in Treasure Studio** - Query output tables are now parsed into interactive artifacts with sorting, pagination, TSV export, and SQL toggle ### Improvements - **Background auto-updates in Treasure Studio** - Updates now download silently in the background with a non-intrusive status bar, replacing the blocking dialog ## v0.20.2 (2026-02-04) ### Bug Fixes - **Chat context preserved after restart** - Fixed conversation context loss when switching between chats or restarting Treasure Studio - **Chat input height reset** - Fixed textarea not resetting height after sending a message ## v0.20.1 (2026-02-04) ### Bug Fixes - **Profile credential resolution** - Fixed `--profile` CLI flag being ignored for credential resolution when keychain is unavailable ## v0.20.0 (2026-02-03) ### Breaking Changes - **Removed `TD_API_KEY` support** - Use `TDX_API_KEY` instead - **Removed `.env` file support** - Use environment variables or `tdx auth setup` for credentials ### Improvements - **Profile-specific credentials** - Support profile-specific API keys via `TDX_API_KEY_` env vars (e.g., `TDX_API_KEY_TD1`, `TDX_API_KEY_PRODUCTION`) - **Profile source display** - `tdx status` now shows where the active profile came from (CLI flag, session, config, or TDX_PROFILE env) ### Bug Fixes - **Treasure Studio profile switching** - Fixed profile switching in Treasure Studio to correctly use the selected profile's credentials ## v0.19.2 (2026-02-03) ### Bug Fixes - **IME input support** - Fixed Treasure Studio submitting chat messages when pressing Enter to confirm IME (Japanese/Chinese/Korean) input ## v0.19.1 (2026-02-03) ### Bug Fixes - **Profile switching** - Treasure Studio now opens a new chat session when switching profiles - **Auto re-authentication** - Treasure Studio automatically re-authenticates when credentials are missing - **macOS window behavior** - Treasure Studio now properly quits when the window is closed on macOS ## v0.19.0 (2026-02-02) ### New Features - **Multi-account support** - Treasure Studio now supports switching between multiple TD accounts - **Full Claude Code features** - `tdx claude` now supports all Claude Code features on all TD sites (US, JP, EU, AP) ### Bug Fixes - **Workflow pull stability** - Fixed gzip validation errors (TAR_BAD_ARCHIVE) when pulling workflow projects - **Workflow pull UX** - Improved `wf pull` behavior in non-interactive mode ## v0.17.0 (2026-01-30) ### New Features - **Schedule commands** - New `tdx job schedule` commands for managing scheduled queries - **MCP Apps support** - Treasure Studio now supports MCP Apps with the Parent Segment Explorer app - **Split window support** - Treasure Studio now supports split windows for side-by-side viewing - **Artifact recovery** - Recover artifacts from tool cards in Treasure Studio chat history ### Improvements - **New chart types** - Treasure Studio adds new chart types with improved x-axis label display - **Auto-updater UX** - Treasure Studio shows progress indicator and notifications during updates ### Bug Fixes - **Chat auto-scroll** - Fixed auto-scroll behavior in Treasure Studio chat - **Auto-update stability** - Fixed app freeze that could occur after auto-update errors ## v0.16.11 (2026-01-27) Treasure Studio (preview) is now available from the public GitHub release page. Download the .dmg from https://github.com/treasure-data/tdx-studio/releases to install. ### New Features - **Faster chat session startup** - Chat sessions start faster with pre-warming - **Automatic td-skills updates** - Latest td-skills are automatically installed and updated - **Auto-updater** - Treasure Studio automatically updates when a new version is available - **MCP tool support** - MCP tools installed for Claude Code can now be used in Treasure Studio - **Token usage logging** - View token usage with `tdx claude usage` ### Improvements - **Enhanced chart and tool call display** - Improved visualization of charts and tool calls - **Markdown file viewer** - File viewer now supports markdown rendering ### Bug Fixes - **Bedrock/Vertex AI settings conflict** - Fixed an issue when users already have their own Bedrock/Vertex AI settings in .claude/settings.json ## v0.16.8 (2026-01-23) ### New Features - **Agent test filtering** - New `--tags` option for `tdx agent test` to run specific test subsets ### Improvements - **Treasure Studio enhancements** - Added chart rendering, artifact panel, model selector, and improved chat history handling ## v0.16.7 (2026-01-21) ### New Features - **Status command** - New `tdx status` command as a convenient alias that shows both authentication and context status in one view - **Parent segment knowledge base support** - Agent configurations can now use `parent_segment` as a knowledge base tool target ## v0.16.6 (2026-01-20) ### New Features - **Re-authenticate button in Studio** - Studio app now has a re-authenticate button in the Settings panel for easier credential refresh ### Bug Fixes - **Windows Studio stability** - Fixed MSYS environment variable handling in Studio on Windows ## v0.16.5 (2026-01-20) ### New Features - **Chat integration support for agents** - `tdx agent pull/push/clone` now support generic chat integrations (Slack, MS Teams, LINE, etc.) in agent configurations - **Re-evaluate agent test runs** - New `--reeval` flag for `tdx agent test` to re-evaluate cached test runs with updated prompts or evaluation criteria ### Improvements - **Better Engage editor type validation** - `--editor-type` option now shows allowed values in help text and validates input - **Improved Windows authentication** - Replaced keychain library for more reliable credential storage on Windows ## v0.16.0 (2026-01-16) ### Breaking Changes - **Agent pull folder naming** - `tdx agent pull` now preserves Unicode characters, case, and spaces in folder names instead of normalizing them to lowercase ASCII. Existing folders will be auto-renamed to match the new format on pull. ## v0.15.0 (2026-01-16) ### New Features - **MCP server command** - New `tdx mcp` command to run tdx as an MCP (Model Context Protocol) server, enabling integration with AI assistants like Claude Desktop, Cursor, and other MCP-compatible tools - **Agent testing** - New `tdx agent test` command for automated LLM agent testing with configurable test cases and evaluation metrics ## v0.14.7 (2026-01-14) ### Bug Fixes - **Claude proxy environment handling** - Fixed `tdx claude` to disable Bedrock/Vertex environment variables when using the TD proxy, preventing conflicts with existing AWS/GCP configurations - **Clearer error messages** - Network and API errors now display the root cause instead of generic "fetch failed" messages ### Documentation - **Windows WSL2 installation guide** - Added step-by-step guide for installing tdx on Windows using WSL2 ## v0.14.6 (2026-01-13) ### Bug Fixes - **Windows shell process** - Fixed DeprecationWarning when spawning shell processes on Windows - **Agent pull pagination** - Fixed `tdx agent pull` only retrieving the first 20 agents when more exist ## v0.14.5 (2026-01-13) ### New Features - **Default profile management** - New `--default` option for `tdx use` and `tdx profile` commands to set a profile as the default, plus new `tdx profile unset` command to remove the default ### Bug Fixes - **Windows authentication** - Fixed `tdx auth setup` failing on Windows due to path handling issues - **Windows Claude Code detection** - Fixed Claude Code executable not found in PowerShell environments - **Windows spinner display** - Reduced spinner flicker on Windows terminals for smoother output ## v0.14.4 (2026-01-09) ### Bug Fixes - **Usage tracker stability** - Corrupted usage log files no longer break `tdx claude stats` cache rebuilding ## v0.14.3 (2026-01-09) ### Bug Fixes - **Default site persistence** - Running `tdx auth setup` without `--profile` now correctly persists the site selection for future commands ## v0.14.2 (2026-01-08) ### New Features - **`.digdagignore` support** - Workflow push now respects `.digdagignore` files to exclude files from upload, following gitignore syntax with support for wildcards, negation patterns, and nested ignore files at any directory level ## v0.14.1 (2026-01-07) ### New Features - **Named profile creation** - `tdx profile create` now accepts an optional name argument to create profiles with specific names in a single command ## v0.14.0 (2026-01-04) ### New Features - **Interactive workflow session navigation** - `tdx wf sessions` now shows an interactive cursor-based selector in terminal mode, allowing you to navigate sessions with arrow keys and press Enter to view the task timeline - **Type-to-filter sessions** - In the interactive selector, type to filter sessions by workflow name for quick navigation through large lists - **Direct timeline navigation** - New `--session-id` and `--attempt-id` options for `tdx wf timeline` to jump directly to specific sessions or attempts without interactive selection - **Adaptive terminal layout** - Session timeline now uses full terminal width dynamically, with 70% allocated to names and 30% to timeline bars - **Improved session display** - Sessions now show project names inline (dimmed) with vertically aligned workflow names for better readability ### Improvements - **Task timeline layout** - Fixed icon alignment using consistent 2-char width emojis, removed bold formatting from attempt header, and added helpful tip for viewing detailed logs - **Better Esc handling** - Pressing Esc in session selector now cleanly exits without selecting a session (workaround for prompts library limitation) - **Cleaner visual hierarchy** - Attempt IDs now dimmed, project names shown without bold, better color usage throughout ### Bug Fixes - **Fixed double paging** - `tdx wf sessions | less` no longer invokes less twice when piping to external pager - **Workflow project not found** - Project not found errors no longer show stack traces, displaying clean error messages instead ### Documentation - **Terminal recommendations** - Added recommended terminals (iTerm2, Ghostty, PowerShell, WSL2) to introduction for best emoji and color support ## v0.13.2 (2026-01-03) ### Bug Fixes - **Journey single-file targeting** - Fixed `tdx journey push` and `tdx sg pull` to correctly filter to a single file when a specific YAML path is specified - **Journey version handling** - Improved handling of multi-version journeys during push/pull operations for better reliability ## v0.13.1 (2026-01-03) ### New Features - **Clickable terminal links** - URLs are now automatically clickable in terminal output, removing the need for `-w` flags to open web console pages - **Journey command alias** - New `tdx journeys` alias for `tdx journey list` command ### Bug Fixes - **Journey round-trip stability** - Fixed issues with journey push/pull consistency to ensure clean round-trips without spurious diffs - **Journey push targeting** - Fixed single-file targeting when pushing specific journey files - **Empty segment rules** - Fixed handling of empty segment rules in `tdx sg pull` - **Journey list filtering** - Fixed `tdx journey list` to show only the latest version of each journey ### Performance - **Faster recursive listing** - Optimized API calls for recursive segment/journey listing using `/entities/by-folder` endpoint ### Improvements - **Better list ordering** - Improved ordering and display of segments and journeys in list commands ## v0.13.0 (2026-01-02) ### New Features - **Profile management commands** - New dedicated commands for managing profiles: - `tdx profile` - List all profiles - `tdx profile create` - Interactive profile creation with site selection and API key validation - `tdx profile remove ` - Remove a profile - `tdx profile set =` - Update profile configuration - **Improved workflow listing** - `tdx wf projects`, `tdx wf workflows`, `tdx wf sessions`, and `tdx wf attempts` now use a cleaner list format with status icons (✅ ❌ 🔄), pagination support via `--limit`, and glob pattern filtering ### Breaking Changes - **Removed `tdx context` command** - Use `tdx profile` commands instead for profile management ### Bug Fixes - **Agent clone context** - `tdx agent clone` no longer switches context automatically after cloning ## v0.12.1 (2025-12-28) ### New Features - **Environment variable configuration** - New `TDX_PROFILE` and `TDX_SITE` environment variables for setting defaults in CI/CD and scripting scenarios ### Documentation - **Marketing as Code book** - New comprehensive guide at [tdx.treasuredata.com/book/](/treasure-code/book) covering CDP concepts, segment management, and workflow automation with tdx ## v0.12.0 (2025-12-27) ### New Features - **Sync-style workflow management** - New `tdx wf pull` and `tdx wf push` commands for managing workflow projects locally with diff preview before pushing, similar to `tdx sg` and `tdx journey` - **Workflow clone** - New `tdx wf clone --name ` command to copy workflow projects to a new name, useful for deploying to different environments - **Interactive workflow run** - `tdx wf run` without arguments now shows an interactive selector to choose a workflow - **Session context for run** - `tdx wf run ` now works when a default project is set via `tdx wf use` ### Breaking Changes - **Renamed `wf push` to `wf upload`** - The legacy digdag-style push command is now `tdx wf upload`. The new `tdx wf push` is sync-style with diff preview. ## v0.11.0 (2025-12-26) ### New Features - **Workflow secrets commands** - New `tdx wf secrets list`, `tdx wf secrets set`, and `tdx wf secrets delete` commands for managing workflow project secrets - **Default workflow project** - New `tdx wf use ` command to set a default workflow project, eliminating the need to specify `--project` on every command ### Bug Fixes - **Connector config normalization** - Fixed handling of camelCase legacy settings in activation connector configs ## v0.10.1 (2025-12-26) ### Bug Fixes - **Journey embedded segments** - Fixed an issue where embedded segments could be duplicated when pushing journeys ## v0.10.0 (2025-12-26) ### New Features - **YAML validation commands** - New `tdx sg validate` and `tdx journey validate` commands for offline validation of segment and journey YAML files before pushing - Validates segment rules, operator types, and required fields - Validates journey step references, embedded segment references, and A/B test percentages - Shows error locations with line numbers and context ### Performance - **Faster pull/push** - Optimized API calls and increased parallelization for segment and journey workflows ### Improvements - **SDK architecture** - Refactored internal SDK structure with cleaner type definitions and modular organization ### Bug Fixes - **Journey round-trip stability** - Improved segment name handling across multi-version journeys ## v0.9.8 (2025-12-23) ### New Features - **Journey wait step branching** - Wait steps now support different `next` paths for condition matched vs timeout outcomes ## v0.9.7 (2025-12-23) ### Bug Fixes - **Journey jump steps** - Fixed an issue with jump target resolution ## v0.9.6 (2025-12-23) ### New Features - **Connection name support** - `tdx connection schema ` now accepts connection names in addition to connection IDs ### Improvements - **Journey pull/push stability** - Improved segment matching and ordering for more reliable round-trip syncing ## v0.9.5 (2025-12-22) ### New Features - **Directory option** - New `-C/--directory` global option to run tdx commands from a different working directory - **Connector config validation** - `tdx sg push` and `tdx journey push` now validate `connector_config` against connection schemas before pushing ## v0.9.4 (2025-12-19) ### Bug Fixes - **Agent tool handling** - Fixed `tdx agent pull/push/clone` to properly handle all tool types including built-in tools ## v0.9.3 (2025-12-19) ### New Features - **Text knowledge base support** - `tdx agent pull/push` now support text-based knowledge bases stored as markdown files with YAML frontmatter ## v0.9.2 (2025-12-19) ### Bug Fixes - **Agent name resolution** - Fixed 404 error when using `tdx agent pull` with certain project names ## v0.9.1 (2025-12-19) ### Bug Fixes - **Agent clone compatibility** - Fixed `tdx agent clone` failing when source agent has tools without function descriptions ## v0.9.0 (2025-12-18) ### New Features - **Agent commands** - New `tdx agent` command group for managing LLM projects as local YAML files - `tdx agent pull/push` - Sync LLM project configurations between TD and local files - `tdx agent clone` - Copy an existing LLM project to a new project - **YAML diff preview** - Agent pull/push now show YAML diffs before applying changes - **Web console URLs** - Agent commands show console URLs for easy navigation ### Improvements - **Agent context support** - `tdx use agent ` sets the default agent for subsequent commands - **Default agent preference** - `tdx chat` now remembers and uses your preferred default agent ### Deprecations - `tdx llm backup/restore` commands are deprecated in favor of `tdx agent pull/push` ## v0.8.12 (2025-12-18) ### New Features - **Journey push command** - New `tdx journey push` command to push journey YAML files independently from segments - **Web console URLs for journeys** - New `-w` option for `tdx journey list/view` and `tdx sg list` to show journey URLs ### Bug Fixes - **Stable journey YAML ordering** - Journey YAML files now have consistent field ordering to avoid spurious diffs - **Claude Code version check** - Added version check (minimum 2.0.20) for td-skills support with clear upgrade instructions ## v0.8.11 (2025-12-17) ### New Features - **Embedded activations in journeys** - Journey YAML files now support embedded activation definitions ### Bug Fixes - **Journey segment rule format** - Fixed segment rules in journeys to use correct group format matching the UI ## v0.8.10 (2025-12-17) ### Bug Fixes - **Journey folder default** - New journeys now use the parent segment folder as default location ## v0.8.9 (2025-12-16) ### New Features - **Journey support** - `tdx sg pull/push` now support CDP journeys with a human-readable YAML format ## v0.8.5 - v0.8.8 (2025-12-12) ### Improvements - **Docker container support** - Fixed process ID handling issues when running in containerized environments ## v0.8.4 (2025-12-10) ### New Features - **SQL file auto-detection** - `tdx query` now auto-detects `.sql` file arguments and stdin input without requiring flags - **Web console URLs for segments** - New `-w` option for `tdx sg list/view` to show web console URLs ### Improvements - **Unified segment YAML schema** - `value` and `values` fields are now interchangeable in segment YAML definitions - **Better segment error messages** - Syntax errors now show the file path for easier debugging ## v0.8.3 (2025-12-09) ### New Features - **Continue and resume options** - New `-c/--continue` and `-r/--resume` options for `tdx claude` to continue previous conversations ### Improvements - **New tdx-skills for Claude** - Added `tdx-skills/parent-segment` and `tdx-skills/segment` skills for managing CDP parent and child segments via Claude Code - **Improved Claude tool calls** - Better handling of tool calls in `tdx claude` for more reliable interactions - **Enhanced status line** - Shows `site:account_id` in Claude Code status line for better context ## v0.8.0 (2025-12-08) ### New Features - **Segment YAML management** - New `tdx sg pull/push` commands for managing segment configurations as local YAML files with activation sync - **Connection discovery** - New `tdx connection list` command to discover available connections for segment activations - **User management** - New `tdx user list` command to look up users in your account ### Improvements - **Human-readable connection names** - Segment and parent segment YAML files now use connection names instead of IDs - **Better ps fields output** - Shows attribute names and includes enriched attributes - **Renamed ps info to ps view** - `tdx ps info` renamed to `tdx ps view` with `-w` option to open in console ## v0.7.2 (2025-12-05) ### Bug Fixes - **Context support for ps commands** - `tdx ps validate/preview/run` now use context parent segment when name is omitted - **Fixed ps pull -u** - Context now updates even when local file is already up to date - **Fixed parent segment URL** - Console links after `tdx ps push` now point to correct console-next URL ## v0.7.1 (2025-12-05) ### Bug Fixes - **Fixed CLI startup error** - Resolved missing dependency causing `ERR_MODULE_NOT_FOUND` when running tdx ## v0.7.0 (2025-12-04) ### New Features - **Parent segment YAML management** - New `tdx ps pull/push` commands for managing parent segment configurations as local YAML files - **Parent segment validation** - `tdx ps validate` to check schema and join statistics against source tables - **Parent segment preview** - `tdx ps preview` to show sample data from master, attributes, and behaviors - **Parent segment run** - `tdx ps run` to push changes and trigger workflow execution - **Parent segment info commands** - `tdx ps fields/info/desc/sql/show` to explore parent segment data - **Context support** - Set context with `tdx ps use` or `tdx ps pull -u` to omit name in subsequent commands ## v0.6.0 (2025-12-03) ### New Features - **Unified context commands** - `tdx use` command for managing session-level context - **Profile shorthand** - New `-p` shorthand for `--profile` option (e.g., `tdx -p myprofile databases`) - **Environment variable authentication** - Support for `TDX_API_KEY` and `TDX_API_KEY_` environment variables ### Bug Fixes - **Profile credential precedence** - Fixed `TD_API_KEY` environment variable incorrectly taking precedence over `--profile` credential ## v0.5.1 (2025-12-01) ### New Features - **Interactive chat selector** - New `tdx chats` and `tdx llm history` commands with interactive chat selection UI ## v0.5.0 (2025-11-29) ### New Features - **Claude usage tracking** - New `tdx claude usage` command to view Claude API usage statistics with profile filtering - **AI Suite credit monitoring** - Real-time credit consumption displayed in Claude Code status line - **Flexible proxy control** - New `--no-proxy` option to skip TD LLM proxy setup for `tdx claude` ### Documentation - **Experimental feature disclaimer** - Added clear experimental status for `tdx claude` command - **Restructured navigation** - Merged Architecture section into SDK documentation for better organization ### Other Changes - **Updated licensing** - Clarified proprietary nature of the project ## v0.4.6 (2025-11-28) ### New Features - **Consistent list command structure** - All resource types now support `tdx xxx list` pattern (e.g., `tdx database list`, `tdx table list`, `tdx job list`) - **Plural command aliases** - Use plural forms as shortcuts: `tdx databases`, `tdx tables`, `tdx segments`, `tdx jobs` - **Workflow list commands** - Added `tdx wf project list`, `tdx wf session list`, `tdx wf attempt list` with plural aliases - **LLM list commands** - Added `tdx llm project list`, `tdx llm agent list` with plural aliases - **Engage list commands** - Added `tdx engage campaign list`, `tdx engage template list`, `tdx engage workspace list` with plural aliases ## v0.4.5 (2025-11-28) ### New Features - **Engage campaign management** - Full CRUD operations for campaigns, templates, and workspaces with `create`, `update`, `delete` subcommands - **Campaign lifecycle commands** - `launch`, `pause`, `resume`, `duplicate` commands for campaign management - **Workspace session context** - Set workspace once with `tdx use engage_workspace` for all subsequent commands - **Segment targeting** - `--segment` option to target campaigns by segment path (e.g., "Audience/Segment") - **Delivery scheduling** - `--start-at` and `--timezone` options for campaign scheduling ## v0.4.4 (2025-11-27) ### New Features - **Engage Suite commands** - New `tdx engage` commands for managing campaigns, email templates, and workspaces with name-based selection support ## v0.4.2 (2025-11-27) ### New Features - **LLM project backup/restore** - New `tdx llm project backup` and `tdx llm project restore` commands for backing up and restoring LLM project configurations ### Bug Fixes - **Improved keychain error handling** - Better distinction between "not found" and "access denied" errors with clear guidance to run `tdx auth setup` ## v0.4.0 (2025-11-26) ### Secure API Key Storage - **Keychain-based credential storage** - API keys now stored securely in system keychain (macOS Keychain, Windows Credential Manager, Linux Secret Service) - **In-memory credential cache** - 5-minute TTL cache reduces keychain lookups - **Auto-migration from `.env` files** - Legacy credentials automatically migrated to keychain on first use - **Graceful fallback** - Works seamlessly in headless environments where keychain is unavailable ### Authentication Improvements - **Detailed API error messages** - Authentication failures now show helpful error details from the server - **Profile-aware setup** - `tdx auth setup` shows `--profile` flag in example commands when using profiles ## v0.3.5 (2025-11-26) ### Workflow Command Improvements - **New `tdx wf run` command** - Start workflow attempts directly from CLI with parameters and custom session time - **Reorganized attempt subcommands** - `tdx wf attempt [logs|tasks|kill|retry]` for better UX - **Fixed `tdx wf logs` command** - Rewrote to use correct Digdag API with interactive task selector - **Improved attempt output** - Vertical format display with expanded params section ## v0.3.0 - v0.3.4 (2025-11-25 - 2025-11-26) - Interactive authentication setup (`tdx auth setup`) - `tdx auth status` as alias for `tdx auth` - Pre-installed sql-skills and workflow-skills plugins for Claude Code - tdx-basic skill instruction in Claude Code prompt - VitePress documentation site with GitHub Pages deployment - TypeDoc SDK API documentation - Renamed proxy.log to tdx.log - Fixed ephemeral shell detection for consistent session IDs - Various dependency updates and bug fixes ## v0.2.x (2025-11-20 - 2025-11-24) - LLM proxy session context with cache expiration - `--last` flag for `llm history` command - File-based logging for LLM proxy - Build time and git revision in `--version` output - Token count estimation for Anthropic proxy - Various bug fixes and stability improvements ## v0.1.x (2025-11-14 - 2025-11-19) - Initial release - Core CLI commands: database, table, query, job - CDP segment management - Workflow commands - LLM/Chat integration with TD LLM API - Claude Code integration (`tdx claude`) - Multi-site support (US, JP, EU, AP) - Context management (profiles, sessions) - Multiple output formats (table, JSON, JSONL, TSV) For detailed changelogs, see [GitHub Releases](https://github.com/treasure-data/tdx/releases).