@iqai/adk-cli/CHANGELOG.md

CLI tool for creating, running, and testing ADK-TS agents

# @iqai/adk-cli

## 0.4.8

### Patch Changes

- Updated dependencies [d25219b]
- Updated dependencies [2336621]
- Updated dependencies [b4b6887]
- Updated dependencies [751b3e9]
- Updated dependencies [800239b]
- Updated dependencies [d35873a]
- Updated dependencies [c6ff7ef]
- Updated dependencies [fbb3c30]
- Updated dependencies [7c9ddf6]
  - @iqai/adk@0.8.5

## 0.4.7

### Patch Changes

- Updated dependencies [621aa3f]
  - @iqai/adk@0.8.4

## 0.4.6

### Patch Changes

- Updated dependencies [0c189c7]
  - @iqai/adk@0.8.3

## 0.4.5

### Patch Changes

- Updated dependencies [c1093ed]
- Updated dependencies [deb7ec5]
  - @iqai/adk@0.8.2

## 0.4.4

### Patch Changes

- Updated dependencies [58eeac4]
  - @iqai/adk@0.8.1

## 0.4.3

### Patch Changes

- Updated dependencies [d7d8b78]
  - @iqai/adk@0.8.0

## 0.4.2

### Patch Changes

- 094ee58: Fix debug trace session polling to handle missing or empty sessions gracefully.

  Previously, the `/debug/trace/session/:sessionId` endpoint would throw `NotFoundException` errors when the frontend polled for sessions that did not exist, were cleared during hot reload, or had no recorded spans. This change returns empty results instead, preventing repeated 404 errors and reducing noisy logs during normal development workflows.

- d671e06: Add `ToolOutputFilterPlugin` to intelligently reduce large tool outputs before downstream processing.

  The plugin dynamically generates safe `jq` filters using an LLM to extract only relevant data, applying adaptive and iterative filtering until configurable size or key-count targets are met. This improves performance, prevents context window overflows, and supports per-tool enablement, schema-aware filtering, and strict security checks against unsafe filters.

- Updated dependencies [6e3eddc]
- Updated dependencies [df81392]
- Updated dependencies [7066213]
- Updated dependencies [d671e06]
- Updated dependencies [8bf7a31]
  - @iqai/adk@0.7.0

## 0.4.1

### Patch Changes

- Updated dependencies [78bac0e]
  - @iqai/adk@0.6.6

## 0.4.0

### Minor Changes

- e0d20c0: Add MCP docs IDE integration step to `adk new` command flow. Users can now configure the @iqai/mcp-docs server directly during project creation for seamless access to ADK documentation in their IDE.

### Patch Changes

- f85e4bb: ADK Web Versioning - Bundled UI Support

  Added bundled web UI mode allowing the CLI to serve the web interface directly, eliminating CORS issues and simplifying local development setup.

  **Key Changes:**
  - Configured Next.js for static export with automatic asset copying to CLI package
  - Enhanced API URL resolution to support both bundled (same-origin) and hosted modes
  - Implemented SPA fallback middleware for serving static web assets
  - Extracted DEFAULT_API_PORT constant and added --web-url option for custom configurations
  - Updated API client hooks with proper SSR guards for static generation

  **Benefits:**
  - Eliminates CORS issues when running locally
  - Simplifies setup (no separate web server needed)
  - Maintains compatibility with hosted mode for development/production

## 0.3.38

### Patch Changes

- 3666f6e: Introduced backend support for **trace visualization** of agent execution sessions. The system now captures OpenTelemetry spans in-memory (in addition to OTLP export), groups them by `sessionId`, and exposes them via a new debug API. This enables the UI to reconstruct full execution trees and timelines for agents, tools, and LLM calls.

  **Highlights**
  - In-memory span storage with rolling buffer scoped per session
  - Dual export: OTLP + in-memory trace store
  - New API: `GET /debug/trace/session/:sessionId`
  - Visualization-ready trace format (IDs, hierarchy, timing, attributes)
  - Designed for local development and debugging workflows

- Updated dependencies [3666f6e]
  - @iqai/adk@0.6.5

## 0.3.37

### Patch Changes

- Updated dependencies [3382057]
  - @iqai/adk@0.6.4

## 0.3.36

### Patch Changes

- Updated dependencies [ad1b38b]
  - @iqai/adk@0.6.3

## 0.3.35

### Patch Changes

- 96e9661: Add Context Caching support for ADK Apps using Gemini 2.0+ models.

  This feature allows agents to reuse extended instructions or large contextual data across requests, reducing token usage and improving performance. Caching behavior is configurable at the App or Agent level via `contextCacheConfig`, with controls for minimum token threshold, cache TTL, and maximum usage intervals.

  All agents within an App can benefit from shared cached context, minimizing redundant data sent to the model while preserving correctness.

- Updated dependencies [8f2167a]
- Updated dependencies [f2dfa13]
- Updated dependencies [96e9661]
  - @iqai/adk@0.6.2

## 0.3.34

### Patch Changes

- Updated dependencies [3f78ed9]
  - @iqai/adk@0.6.1

## 0.3.33

### Patch Changes

- Updated dependencies [7186de5]
- Updated dependencies [c2f9b02]
- Updated dependencies [1387333]
  - @iqai/adk@0.6.0

## 0.3.32

### Patch Changes

- Updated dependencies [27d6bd9]
  - @iqai/adk@0.5.9

## 0.3.31

### Patch Changes

- Updated dependencies [d92892c]
- Updated dependencies [0ada268]
  - @iqai/adk@0.5.8

## 0.3.30

### Patch Changes

- Updated dependencies [b938be4]
  - @iqai/adk@0.5.7

## 0.3.29

### Patch Changes

- 4e7e9e9: Add environment variable validation with clear error messages for missing required variables. Improves developer experience by providing actionable guidance on .env file configuration and distinguishing between required and optional variables.
- 74223fc: fix: error handling in adk-cli

## 0.3.28

### Patch Changes

- 8d5ba1e: ADK WEB now supports voice input
- Updated dependencies [8d5ba1e]
  - @iqai/adk@0.5.6

## 0.3.27

### Patch Changes

- Updated dependencies [05bb1b8]
  - @iqai/adk@0.5.5

## 0.3.26

### Patch Changes

- Updated dependencies [2167a47]
  - @iqai/adk@0.5.4

## 0.3.25

### Patch Changes

- 0082494: fix: env parsing

## 0.3.24

### Patch Changes

- 8143f4f: refactor: simplified agent loaders and managers

## 0.3.23

### Patch Changes

- 737493f: Fix hot reload state sync and State Panel UI issues

## 0.3.22

### Patch Changes

- 1ec769a: fix: improve type safety across cli and adk package
- 9ba699c: fix: state persistence
- 4fbb724: Fix: state management
- 69d3431: fix: state persistence and allows initial state of agents to be passed down to proper sessions
- Updated dependencies [1ec769a]
- Updated dependencies [9ba699c]
- Updated dependencies [4fbb724]
- Updated dependencies [edfe628]
  - @iqai/adk@0.5.3

## 0.3.21

### Patch Changes

- Updated dependencies [ae81c74]
  - @iqai/adk@0.5.2

## 0.3.20

### Patch Changes

- 170dafc: fix: multiple cache file creation
- 31264cb: Improves the logging for adk run by silencing the logs from agent processes by default
- Updated dependencies [d8fd6e8]
  - @iqai/adk@0.5.1

## 0.3.19

### Patch Changes

- 67a3547: Add next js starter template
- 7a7c9b0: Fix root agent state load & add state polling

## 0.3.18

### Patch Changes

- Updated dependencies [9c8441c]
  - @iqai/adk@0.5.0

## 0.3.17

### Patch Changes

- Updated dependencies [1b00e47]
  - @iqai/adk@0.4.1

## 0.3.16

### Patch Changes

- 4123905: fix cross platform (windows) adk-cli run issues (path resolution)

## 0.3.15

### Patch Changes

- 2fdd83f: Refactor graceful shutdown handling for server commands
- Updated dependencies [c538a1a]
  - @iqai/adk@0.4.0

## 0.3.14

### Patch Changes

- 9f8b3e5: Adds check for ADK web to check server compatibility
- 46cee30: Adds agent name in adk web

## 0.3.13

### Patch Changes

- Updated dependencies [737cb0f]
  - @iqai/adk@0.3.7

## 0.3.12

### Patch Changes

- b56741c: Add graph panel to sidebar component to showcase agent architecture

## 0.3.11

### Patch Changes

- 0c139d9: Defer TypeScript cache cleanup to process exit for better debugging and reliable cleanup.

## 0.3.10

### Patch Changes

- 3a848a2: Allows loading agents from different folder levels

## 0.3.9

### Patch Changes

- b2efa0b: Remove local option

## 0.3.8

### Patch Changes

- 0d9fd88: fix issues with path resolution

## 0.3.7

### Patch Changes

- aa41656: Fix TypeScript Path Resolution in Agent Loader
- Updated dependencies [edadab9]
  - @iqai/adk@0.3.6

## 0.3.6

### Patch Changes

- Updated dependencies [8ce3a6f]
  - @iqai/adk@0.3.5

## 0.3.5

### Patch Changes

- Updated dependencies [f365669]
  - @iqai/adk@0.3.4

## 0.3.4

### Patch Changes

- dd1d22e: fix: improve ADK run command exit handling
- 49ea60a: Fix session persistence in adk-cli and adk-web to prevent new sessions on refresh
- 964e4a7: Adds --version support for adk cli

## 0.3.3

### Patch Changes

- 4c0476b: Adds adk cache directory to skip from scanning avoiding session creation in loop bug

## 0.3.2

### Patch Changes

- Updated dependencies [5d19967]
  - @iqai/adk@0.3.3

## 0.3.1

### Patch Changes

- 2da690a: - **Dependency Updates:**
  - Upgraded dependencies and devDependencies across multiple packages ensuring compatibility with the latest library versions.

  - **Schema Handling:**
    - Transitioned schema conversion to use `z.toJSONSchema`, reducing dependencies.
    - Enhanced type safety in the workflow tool's schema handling.

  - **Error Reporting and Validation:**
    - Improved error messages in `AgentBuilder` for better debugging.
    - Enhanced output validation for LLM.

  - **AI SDK and Model Integration:**
    - Refined model ID handling in `AiSdkLlm`.
    - Updated field references to align with AI SDK changes.

  - **Code Quality Enhancements:**
    - Improved import order and code formatting for consistency.

  This changeset ensures improved stability, security, and developer experience across the updated packages.

- Updated dependencies [2da690a]
  - @iqai/adk@0.3.2

## 0.3.0

### Minor Changes

- b6c0344: Improved adk cli experience

### Patch Changes

- Updated dependencies [b6c0344]
  - @iqai/adk@0.3.1

## 0.2.9

### Patch Changes

- Updated dependencies [c890576]
- Updated dependencies [b0fdba9]
- Updated dependencies [3561208]
  - @iqai/adk@0.3.0

## 0.2.8

### Patch Changes

- Updated dependencies [e1dc750]
  - @iqai/adk@0.2.5

## 0.2.7

### Patch Changes

- ea74fa0: Adds near shade agent template
- Updated dependencies [dc2c3eb]
  - @iqai/adk@0.2.4

## 0.2.6

### Patch Changes

- 40381d9: Enhance the loading mechanism to check for multiple environment files in a specified priority order, ensuring that environment variables are set only if they are not already defined. Additionally, provide warnings for any errors encountered while loading these files.

## 0.2.5

### Patch Changes

- 6a3a9ba: Add support for attaching media files to agent on adk-cli & adk-web

## 0.2.4

### Patch Changes

- Updated dependencies [298edf1]
  - @iqai/adk@0.2.3

## 0.2.3

### Patch Changes

- Updated dependencies [0485d51]
  - @iqai/adk@0.2.2

## 0.2.2

### Patch Changes

- Updated dependencies [765592d]
- Updated dependencies [14fdbf4]
  - @iqai/adk@0.2.1

## 0.2.1

### Patch Changes

- 8bf5d5d: Fixes template selection not working in adk new command

## 0.2.0

### Minor Changes

- 17341fc: Refactor agent loading and resolution logic with enhanced flexibility and reliability

  This major enhancement improves the ADK CLI server's agent loading capabilities and adds new features to the core framework:

  **CLI Server Improvements:**
  - **Modular Architecture**: Refactored monolithic server file into organized modules (`server/index.ts`, `server/routes.ts`, `server/services.ts`, `server/types.ts`)
  - **Enhanced Agent Resolution**: New `resolveAgentExport` method supports multiple export patterns:
    - Direct agent exports: `export const agent = new LlmAgent(...)`
    - Function factories: `export function agent() { return new LlmAgent(...) }`
    - Async factories: `export async function agent() { return new LlmAgent(...) }`
    - Container objects: `export default { agent: ... }`
    - Primitive exports with fallback scanning
  - **Improved TypeScript Import Handling**: Better project root detection and module resolution for TypeScript files

  **Core Framework Enhancements:**
  - **New AgentBuilder Method**: Added `withAgent()` method to directly provide existing agent instances with definition locking to prevent accidental configuration overwrites
  - **Two-Tier Tool Deduplication**: Implemented robust deduplication logic to prevent duplicate function declarations that cause errors with LLM providers (especially Google)
  - **Better Type Safety**: Improved type definitions and replaced `any[]` usage with proper typed interfaces

  **Testing & Reliability:**
  - **Comprehensive Test Coverage**: New `agent-resolution.test.ts` with extensive fixtures testing various agent export patterns
  - **Multiple Test Fixtures**: Added 6 different agent export pattern examples for validation
  - **Edge Case Handling**: Improved error handling and logging throughout the agent loading pipeline

  These changes provide a more flexible, reliable, and maintainable foundation for agent development and deployment while maintaining backward compatibility.

### Patch Changes

- Updated dependencies [17341fc]
- Updated dependencies [1564b7b]
  - @iqai/adk@0.2.0

## 0.1.1

### Patch Changes

- c4e642a: downgraded info level logs to debug, removed legacy starter in create-adk-project and new adk cli initial version!
- Updated dependencies [c4e642a]
  - @iqai/adk@0.1.22