dexto 1.3.0 → 1.5.0

package/README.md

@@ -132,6 +132,7 @@ dexto --agent nano-banana-agent
 - **Triage Agent** – Demo multi-agent customer support routing system
 - **Workflow Builder Agent** – Build and manage n8n automation workflows
 - **Product Analysis Agent** – Product analytics and insights using PostHog
+- **Gaming Agent** – Play GameBoy games like Pokemon through an emulator
 
 Each agent is pre-configured with the right tools, prompts, and LLM settings for its domain. No setup required—just install and start building.
 
@@ -270,8 +271,8 @@ dexto --agent ./agents/examples/email_slack.yml
 | **Headless Server** | `dexto --mode server` | REST & SSE streaming APIs for agent interaction |
 | **MCP Server (Agent)** | `dexto --mode mcp` | Exposing your agent as a tool for others via stdio |
 | **MCP Server (Aggregator)** | `dexto mcp --group-servers` | Re-exposing tools from multiple MCP servers via stdio |
-| **Discord Bot** | `dexto --mode discord` | Community servers & channels ([Requires Setup](https://github.com/truffle-ai/dexto/blob/HEAD/packages/cli/src/discord/README.md)) |
-| **Telegram Bot** | `dexto --mode telegram` | Mobile chat ([Requires Setup](https://github.com/truffle-ai/dexto/blob/HEAD/packages/cli/src/telegram/README.md)) |
+| **Discord Bot** | [See `examples/discord-bot/`](examples/discord-bot/) | Community servers & channels (reference implementation) |
+| **Telegram Bot** | [See `examples/telegram-bot/`](examples/telegram-bot/) | Mobile chat (reference implementation) |
 
 Run `dexto --help` for **all flags, sub-commands, and environment variables**.
 
@@ -308,14 +309,31 @@ systemPrompt: |
 
 Switch between providers instantly—no code changes required.
 
+#### Built-in Providers
+
+| Provider | Models | Setup |
+|----------|--------|-------|
+| **OpenAI** | `gpt-5.1-chat-latest`, `gpt-5.1`, `gpt-5.1-codex`, `gpt-5-mini`, `gpt-4.1`, `gpt-4o`, `o4-mini`, `o3`, `o1` | API key |
+| **Anthropic** | `claude-sonnet-4-5-20250929`, `claude-opus-4-5-20251101`, `claude-haiku-4-5-20251001`, `claude-3-7-sonnet-20250219` | API key |
+| **Google** | `gemini-3-pro-preview`, `gemini-3-pro-image-preview`, `gemini-3-flash-preview`, `gemini-2.5-pro`, `gemini-2.5-flash`, `gemini-2.0-flash` | API key |
+| **Groq** | `llama-3.3-70b-versatile`, `gemma-2-9b-it`, `openai/gpt-oss-20b`, `openai/gpt-oss-120b`, `moonshotai/kimi-k2-instruct`, `meta-llama/llama-4-scout-17b-16e-instruct`, `meta-llama/llama-4-maverick-17b-128e-instruct`, `deepseek-r1-distill-llama-70b`, `qwen/qwen3-32b` | API key |
+| **xAI** | `grok-4`, `grok-3`, `grok-3-mini`, `grok-code-fast-1` | API key |
+| **Cohere** | `command-a-03-2025`, `command-r-plus`, `command-r`, `command-r7b` | API key |
+
+#### Cloud Platforms
+
+| Provider | Models | Setup |
+|----------|--------|-------|
+| **Vertex AI** | Gemini, Claude | GCP credentials ([docs](https://docs.dexto.ai/docs/guides/supported-llm-providers#google-cloud-vertex-ai)) |
+| **AWS Bedrock** | Claude, Nova, Llama, Mistral | AWS credentials ([docs](https://docs.dexto.ai/docs/guides/supported-llm-providers#amazon-bedrock)) |
+
+#### Gateway Providers
+
 | Provider | Models | Setup |
 |----------|--------|-------|
-| **OpenAI** | `gpt-5.1-chat-latest`, `gpt-5.1`, `gpt-5.1-codex`, `gpt-5.1-codex-mini`, `gpt-5`, `gpt-5-mini`, `gpt-5-nano`, `gpt-5-pro`, `gpt-5-codex`, `gpt-4.1`, `gpt-4.1-mini`, `gpt-4.1-nano`, `gpt-4o`, `gpt-4o-mini`, `gpt-4o-audio-preview`, `o4-mini`, `o3`, `o3-mini`, `o1` | `change model in UI and add api key` |
-| **Anthropic** | `claude-haiku-4-5-20251001`, `claude-sonnet-4-5-20250929`, `claude-opus-4-5-20251101`, `claude-opus-4-1-20250805`, `claude-4-opus-20250514`, `claude-4-sonnet-20250514`, `claude-3-7-sonnet-20250219`, `claude-3-5-sonnet-20240620`, `claude-3-5-haiku-20241022` | `change model in UI and add api key` |
-| **Google** | `gemini-3-pro-preview`, `gemini-3-pro-image-preview`, `gemini-2.5-pro`, `gemini-2.5-flash`, `gemini-2.5-flash-lite`, `gemini-2.0-flash`, `gemini-2.0-flash-lite` | `change model in UI and add api key` |
-| **Groq** | `llama-3.3-70b-versatile`, `meta-llama/llama-4-scout-17b-16e-instruct`, `meta-llama/llama-4-maverick-17b-128e-instruct`, `qwen/qwen3-32b`, `gemma-2-9b-it`, `openai/gpt-oss-20b`, `openai/gpt-oss-120b`, `moonshotai/kimi-k2-instruct`, `deepseek-r1-distill-llama-70b` | `change model in UI and add api key` |
-| **xAI** | `grok-4`, `grok-3`, `grok-3-mini`, `grok-code-fast-1` | `change model in UI and add api key` |
-| **Cohere** | `command-a-03-2025`, `command-r-plus`, `command-r`, `command-r7b` | `change model in UI and add api key` |
+| **OpenRouter** | 100+ models via `provider/model` format | API key |
+| **Glama** | Multi-provider access via `provider/model` format | API key |
+| **LiteLLM** | Self-hosted proxy for any provider | API key + baseURL |
 
 ```bash
 # Switch models via CLI
@@ -325,7 +343,9 @@ dexto -m gemini-2.5-pro
 
 You can configure things like LLM, system prompt, MCP servers, storage, sessions, human-in-the loop, telemetry and more!
 
-See our [Configuration Guide](https://docs.dexto.ai/docs/category/agent-configuration-guide) for complete setup instructions.
+You can also switch within the interactive CLI (/model) and in the web UI easily without needing to set up configuration.
+
+See our [Configuration Guide](https://docs.dexto.ai/docs/category/agent-configuration-guide) and [Supported LLM Providers](https://docs.dexto.ai/docs/guides/supported-llm-providers) for complete setup instructions.
 
 
 ## Dexto Agent SDK
@@ -353,24 +373,69 @@ await agent.start();
 const session = await agent.createSession();
 
 // Use generate() for simple request/response
-const response = await agent.generate('What is TypeScript?', {
-  sessionId: session.id
-});
+const response = await agent.generate('What is TypeScript?', session.id);
 console.log(response.content);
 
 // Conversations maintain context within a session
-await agent.generate('Write a haiku about it', { sessionId: session.id });
-await agent.generate('Make it funnier', { sessionId: session.id });
+await agent.generate('Write a haiku about it', session.id);
+await agent.generate('Make it funnier', session.id);
+
+// Multimodal: send images or files
+await agent.generate([
+  { type: 'text', text: 'Describe this image' },
+  { type: 'image', image: base64Data, mimeType: 'image/png' }
+], session.id);
+
+// Streaming for real-time UIs
+for await (const event of await agent.stream('Write a story', session.id)) {
+  if (event.name === 'llm:chunk') process.stdout.write(event.content);
+}
 
 await agent.stop();
 ```
 
-See our [Dexto Agent SDK docs](https://docs.dexto.ai/api/category/dexto-sdk/) for complete examples with MCP tools, sessions, and advanced features.
+See our [Dexto Agent SDK docs](https://docs.dexto.ai/docs/guides/dexto-sdk) for multimodal content, streaming, MCP tools, and advanced features.
 
 ---
 
 ## Advanced Usage
 
+### Starting a Server
+
+Start a Dexto server programmatically to expose REST and SSE streaming APIs to interact and manage your agent backend.
+
+```typescript
+import { DextoAgent } from '@dexto/core';
+import { startHonoApiServer } from 'dexto';
+
+// Create and configure agent
+const agent = new DextoAgent({
+  llm: {
+    provider: 'openai',
+    model: 'gpt-5-mini',
+    apiKey: process.env.OPENAI_API_KEY
+  },
+  mcpServers: {
+    filesystem: {
+      type: 'stdio',
+      command: 'npx',
+      args: ['-y', '@modelcontextprotocol/server-filesystem', '.']
+    }
+  }
+});
+
+// Start server on port 3001
+const { server } = await startHonoApiServer(agent, 3001);
+
+console.log('Dexto server running at http://localhost:3001');
+// Server provides REST API and SSE streaming endpoints
+// POST /api/message - Send messages
+// GET /api/sessions - List sessions
+// See docs.dexto.ai/api/rest/ for all endpoints
+```
+
+This starts an HTTP server with full REST and SSE APIs, enabling integration with web frontends, webhooks, and other services. See the [REST API Documentation](https://docs.dexto.ai/api/rest/) for available endpoints.
+
 ### Session Management
 
 Create and manage multiple conversation sessions with persistent storage.
@@ -381,7 +446,7 @@ await agent.start();
 
 // Create and manage sessions
 const session = await agent.createSession('user-123');
-await agent.generate('Hello, how can you help me?', { sessionId: session.id });
+await agent.generate('Hello, how can you help me?', session.id);
 
 // List and manage sessions
 const sessions = await agent.listSessions();
@@ -508,10 +573,12 @@ Agent Selection:
 
 Advanced Modes:
   dexto --mode server      Run as API server
-  dexto --mode discord     Run as Discord bot
-  dexto --mode telegram    Run as Telegram bot
   dexto --mode mcp         Run as MCP server
 
+Platform Integrations (Reference Implementations):
+  See examples/discord-bot/     Run as Discord bot
+  See examples/telegram-bot/    Run as Telegram bot
+
 Session Commands: dexto session list|history|delete • search
 Search: dexto search <query> [--session <id>] [--role <role>]
 
@@ -534,15 +601,13 @@ Options:
   --skip-setup                     Skip global setup validation (useful for MCP
                                    mode, automation)
   -m, --model <model>              Specify the LLM model to use
-  --router <router>                Specify the LLM router to use (vercel or
-                                   in-built)
   --auto-approve                   Always approve tool executions without
                                    confirmation prompts
   -c, --continue                   Continue most recent conversation
   -r, --resume <sessionId>         Resume session by ID
   --mode <mode>                    The application in which dexto should talk
-                                   to you - web | cli | server | discord |
-                                   telegram | mcp (default: "web")
+                                   to you - web | cli | server | mcp
+                                   (default: "web")
   --port <port>                    port for the server (default: 3000 for web,
                                    3001 for server mode)
   --no-auto-install                Disable automatic installation of missing

package/dist/agents/agent-registry.json

@@ -125,6 +125,15 @@
       "tags": ["posthog", "analytics", "product", "insights", "feature-flags", "mcp"],
       "source": "product-analysis-agent/",
       "main": "product-analysis-agent.yml"
+    },
+    "gaming-agent": {
+      "id": "gaming-agent",
+      "name": "Gaming Agent",
+      "description": "AI agent that plays GameBoy games like Pokemon through an emulator with screen capture and button controls",
+      "author": "Truffle AI",
+      "tags": ["gaming", "gameboy", "pokemon", "emulator", "mcp"],
+      "source": "gaming-agent/",
+      "main": "gaming-agent.yml"
     }
   }
 }

package/dist/agents/agent-template.yml

@@ -26,10 +26,10 @@ systemPrompt:
         Use these tools when appropriate to answer user queries.
         You can use multiple tools in sequence to solve complex problems.
         After each tool result, determine if you need more information or can provide a final answer.
-    - id: dateTime
+    - id: date
       type: dynamic
       priority: 10
-      source: dateTime
+      source: date
       enabled: true
 
 # LLM configuration - describes the language model to use

package/dist/agents/coding-agent/coding-agent.yml

@@ -1,6 +1,10 @@
 # Coding Agent Configuration
 # Optimized for software development with internal coding tools
 
+# Image: Specifies the provider bundle for this agent
+# This agent requires local development tools (filesystem, process)
+image: '@dexto/image-local'
+
 # System prompt configuration - defines the agent's behavior as a coding assistant
 systemPrompt:
   contributors:
@@ -44,7 +48,7 @@ greeting: "👨‍💻 Ready to code! What are we building today?"
 # LLM configuration - using a powerful model for coding tasks
 llm:
   provider: anthropic
-  model: claude-haiku-4-5-20251001  # More powerful model for complex coding tasks
+  model: claude-sonnet-4-5-20250929
   apiKey: $ANTHROPIC_API_KEY
 
 storage:
@@ -68,28 +72,35 @@ toolConfirmation:
     # Tools that never require approval (safe, read-only operations)
     alwaysAllow:
       - internal--ask_user
-      - internal--read_file      # Read files without approval
-      - internal--glob_files     # Search for files without approval
-      - internal--grep_content   # Search within files without approval
-      - internal--bash_output    # Check background process output
-      - internal--kill_process   # Kill processes without approval
+      - custom--filesystem-tools--read_file      # Read files without approval
+      - custom--filesystem-tools--glob_files     # Search for files without approval
+      - custom--filesystem-tools--grep_content   # Search within files without approval
+      - custom--process-tools--bash_output       # Check background process output
+      - custom--process-tools--kill_process      # Kill processes without approval
 
     # Tools that are always denied (dangerous operations)
     # Uncomment to restrict certain operations
     # alwaysDeny:
-    #   - internal--bash_exec--rm -rf*  # Prevent recursive deletion
+    #   - custom--process-tools--bash_exec--rm -rf*  # Prevent recursive deletion
 
-# Internal tools - all coding tools enabled
+# Elicitation configuration - required for ask_user tool
+elicitation:
+  enabled: true
+  timeout: 120000
+
+# Internal tools - core tools that are always available
 internalTools:
   - ask_user       # Ask questions and collect input
-  - read_file      # Read file contents with pagination support
-  - glob_files     # Find files using glob patterns (e.g., "**/*.ts")
-  - grep_content   # Search file contents using regex patterns
-  - write_file     # Write content to files (requires approval)
-  - edit_file      # Edit files by replacing text (requires approval)
-  - bash_exec      # Execute shell commands (requires approval)
-  - bash_output    # Retrieve output from background processes
-  - kill_process   # Terminate background processes
+
+# Custom tools - filesystem and process tools from image-local
+customTools:
+  - type: filesystem-tools
+    allowedPaths: ["."]
+    blockedPaths: [".git", "node_modules/.bin", ".env"]
+    blockedExtensions: [".exe", ".dll", ".so"]
+    enableBackups: false
+  - type: process-tools
+    securityLevel: moderate
 
 # Internal resources configuration - expanded for coding projects
 internalResources:

package/dist/agents/database-agent/database-agent.yml

@@ -105,10 +105,10 @@ systemPrompt:
         Remember: You're demonstrating intelligent database interaction through
         natural conversation and data analysis.
 
-    - id: dateTime
+    - id: date
       type: dynamic
       priority: 10
-      source: dateTime
+      source: date
       enabled: true
 
 # Storage configuration

package/dist/agents/default-agent.yml

@@ -25,10 +25,10 @@ systemPrompt:
         Use these tools when appropriate to answer user queries.
         You can use multiple tools in sequence to solve complex problems.
         After each tool result, determine if you need more information or can provide a final answer.
-    - id: dateTime
+    - id: date
       type: dynamic
       priority: 10
-      source: dateTime
+      source: date
       enabled: true
 
 # Memory configuration - controls how memories are included in system prompt
@@ -77,15 +77,15 @@ storage:
     type: sqlite
     # path: ./data/dexto.db  # Optional: customize database location
   blob:
-    type: local  # 'local', 's3', 'gcs', 'azure' (s3, gcs, azure coming in future Phases)
+    type: local  # CLI provides storePath automatically
+    # storePath: ./data/blobs  # Optional: customize blob storage location (defaults to agent-specific path)
     maxBlobSize: 52428800     # 50MB per blob
     maxTotalSize: 1073741824  # 1GB total storage
-    cleanupAfterDays: 30      # Auto-cleanup blobs older than 30 days
-    # storePath: (automatically provided by CLI as ~/.dexto/blobs/<agent-id>)
+    cleanupAfterDays: 30
 
 toolConfirmation:
   mode: manual
-  timeout: 120000          # Time to wait for approval (ms)
+  # timeout: <optional>      # Time to wait for approval (ms). Omit for no timeout (wait indefinitely)
   allowedToolsStorage: memory  # 'memory' or 'storage' for persisting allowed tools
 
   # Optional: Static tool policies for fine-grained allow/deny control
@@ -107,12 +107,14 @@ toolConfirmation:
 # Allows auto-approve for tools while still supporting user input requests
 elicitation:
   enabled: true            # Enable ask_user tool and MCP server elicitations
-  timeout: 120000          # Time to wait for user input (ms)
+  # timeout: <optional>    # Time to wait for user input (ms). Omit for no timeout (wait indefinitely)
 
 # Internal tools - built-in Dexto capabilities
 internalTools:
   - ask_user  # Allows the agent to ask you questions and collect structured input
   - delegate_to_url
+  - list_resources
+  - get_resource
 
 # Internal resources configuration - manages file system access and blob storage
 # NOTE: Blob storage capacity and backend settings are in the 'storage.blob' section above

package/dist/agents/github-agent/github-agent.yml

@@ -47,10 +47,10 @@ systemPrompt:
         - After each tool interaction, decide whether additional context is needed or if you can deliver a confident answer
 
         Stay practical, keep responses focused on the user’s goal, and highlight any assumptions or risks you notice.
-    - id: dateTime
+    - id: date
       type: dynamic
       priority: 10
-      source: dateTime
+      source: date
       enabled: true
 
 # Storage configuration

package/dist/agents/product-name-researcher/product-name-researcher.yml

@@ -139,10 +139,10 @@ systemPrompt:
 
         Use these tools strategically to provide comprehensive product name validation that combines technical availability with market intelligence.
 
-    - id: dateTime
+    - id: date
       type: dynamic
       priority: 10
-      source: dateTime
+      source: date
       enabled: true
 
 # LLM configuration

package/dist/agents/talk2pdf-agent/talk2pdf-agent.yml

@@ -33,10 +33,10 @@ systemPrompt:
         - "Extract all content containing 'invoice' from /path/to/file.pdf and explain what you found."
         
         Always ask for the file path if not provided. If a file is not a PDF or does not exist, inform the user.
-    - id: dateTime
+    - id: date
       type: dynamic
       priority: 10
-      source: dateTime
+      source: date
       enabled: true
 
 # Storage configuration

package/dist/analytics/events.d.ts

@@ -1,4 +1,5 @@
 import type { ExecutionContext } from '@dexto/agent-management';
+import type { SharedAnalyticsEventMap } from '@dexto/analytics';
 export interface BaseEventContext {
     app?: 'dexto';
     app_version?: string;
@@ -44,8 +45,6 @@ export interface CliCommandTimeoutEvent extends CliCommandBaseEvent {
     timeoutMs: number;
 }
 export type CliCommandEvent = CliCommandStartEvent | CliCommandEndEvent | CliCommandTimeoutEvent;
-export interface SessionStartEvent {
-}
 export interface PromptEvent {
     mode: 'cli' | 'headless';
     provider: string;
@@ -54,14 +53,17 @@ export interface PromptEvent {
 export interface SetupEvent {
     provider: string;
     model: string;
-    hadApiKeyBefore: boolean;
+    hadApiKeyBefore?: boolean;
     setupMode: 'interactive' | 'non-interactive';
+    setupVariant?: 'quick-start' | 'custom';
+    defaultMode?: string;
+    hasBaseURL?: boolean;
+    apiKeySkipped?: boolean;
 }
 export interface InstallAgentEvent {
     agent: string;
     status: 'installed' | 'skipped' | 'failed';
     force: boolean;
-    injectPreferences: boolean;
     reason?: string;
     error_message?: string;
 }
@@ -94,8 +96,13 @@ export interface InitProjectEvent {
     provider: string;
     providedKey: boolean;
 }
-export interface DextoAnalyticsEventMap {
-    dexto_session_start: SessionStartEvent;
+/**
+ * CLI analytics event map extending shared events with CLI-specific events.
+ *
+ * IMPORTANT: If an event is also tracked by WebUI, move it to SharedAnalyticsEventMap
+ * in @dexto/analytics to avoid duplication.
+ */
+export interface DextoAnalyticsEventMap extends SharedAnalyticsEventMap {
     dexto_cli_command: CliCommandEvent;
     dexto_prompt: PromptEvent;
     dexto_setup: SetupEvent;

package/dist/analytics/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/analytics/events.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/analytics/events.ts"],"names":[],"mappings":"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"}

package/dist/analytics/index.d.ts

@@ -7,7 +7,7 @@ interface InitOptions {
  *
  * - Respects DEXTO_ANALYTICS_DISABLED.
  * - Creates/loads the anonymous distinctId and a per-process session_id.
- * - Emits a dexto_session_start event for each process run.
+ * - Emits a dexto_session_created event for each process run.
  */
 export declare function initAnalytics(opts: InitOptions): Promise<void>;
 /**

package/dist/analytics/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAcA,OAAO,EACH,kBAAkB,EAClB,qBAAqB,EAErB,kBAAkB,EAClB,oBAAoB,EACvB,MAAM,aAAa,CAAC;AAErB,UAAU,WAAW;IACjB,UAAU,EAAE,MAAM,CAAC;CACtB;AAqBD;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAkCpE;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,SAAS,kBAAkB,EACnD,KAAK,EAAE,IAAI,EACX,UAAU,GAAE,qBAAqB,CAAC,IAAI,CAAqC,GAC5E,IAAI,CAWN;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAQvD;AAMD;;;GAGG;AACH,wBAAsB,cAAc,CAChC,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,MAAM,GAAG,OAAO,CAAC,CAAM,GAClE,OAAO,CAAC,IAAI,CAAC,CAYf;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,KAAK,GAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,YAAY,CAAC,CAAM,GAC3F,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACtB,GAAG,IAAI,CAAC,CAiBR"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAcA,OAAO,EACH,kBAAkB,EAClB,qBAAqB,EAErB,kBAAkB,EAClB,oBAAoB,EACvB,MAAM,aAAa,CAAC;AAErB,UAAU,WAAW;IACjB,UAAU,EAAE,MAAM,CAAC;CACtB;AAqBD;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAsCpE;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,SAAS,kBAAkB,EACnD,KAAK,EAAE,IAAI,EACX,UAAU,GAAE,qBAAqB,CAAC,IAAI,CAAqC,GAC5E,IAAI,CAWN;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAQvD;AAMD;;;GAGG;AACH,wBAAsB,cAAc,CAChC,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,MAAM,GAAG,OAAO,CAAC,CAAM,GAClE,OAAO,CAAC,IAAI,CAAC,CAYf;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,KAAK,GAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,YAAY,CAAC,CAAM,GAC3F,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACtB,GAAG,IAAI,CAAC,CAiBR"}

package/dist/analytics/index.js

@@ -26,7 +26,7 @@ function baseProps() {
  *
  * - Respects DEXTO_ANALYTICS_DISABLED.
  * - Creates/loads the anonymous distinctId and a per-process session_id.
- * - Emits a dexto_session_start event for each process run.
+ * - Emits a dexto_session_created event for each process run.
  */
 export async function initAnalytics(opts) {
     if (enabled || client)
@@ -60,7 +60,11 @@ export async function initAnalytics(opts) {
             // Ignore flush errors: analytics should never block process exit.
         }
     });
-    capture('dexto_session_start', {});
+    capture('dexto_session_created', {
+        source: 'cli',
+        sessionId: sessionId || 'unknown',
+        trigger: 'manual',
+    });
 }
 /**
  * Capture a single analytics event with optional properties.

package/dist/api/server-hono.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server-hono.d.ts","sourceRoot":"","sources":["../../src/api/server-hono.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAuC,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,EACH,cAAc,EACd,gBAAgB,EAShB,KAAK,kBAAkB,EAC1B,MAAM,eAAe,CAAC;AAiBvB,MAAM,MAAM,wBAAwB,GAAG;IACnC,GAAG,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;IACvC,MAAM,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,QAAQ,CAAC,CAAC;IACtD,iBAAiB,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAC1F,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E,iBAAiB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/E,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7E,oBAAoB,EAAE,MAAM,IAAI,CAAC;IACjC,gBAAgB,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CAC9C,CAAC;AAGF,wBAAsB,iBAAiB,CACnC,KAAK,EAAE,UAAU,EACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,EACtC,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,kBAAkB,GACjC,OAAO,CAAC,wBAAwB,CAAC,CA2VnC;AAED,wBAAsB,kBAAkB,CACpC,KAAK,EAAE,UAAU,EACjB,IAAI,SAAO,EACX,iBAAiB,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,EACtC,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,kBAAkB,GACjC,OAAO,CAAC;IACP,MAAM,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,QAAQ,CAAC,CAAC;IACtD,iBAAiB,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC;CAC7F,CAAC,CAgCD"}
+{"version":3,"file":"server-hono.d.ts","sourceRoot":"","sources":["../../src/api/server-hono.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAuC,MAAM,aAAa,CAAC;AAQ9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,EACH,cAAc,EACd,gBAAgB,EAShB,KAAK,kBAAkB,EAC1B,MAAM,eAAe,CAAC;AA6FvB,MAAM,MAAM,wBAAwB,GAAG;IACnC,GAAG,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;IACvC,MAAM,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,QAAQ,CAAC,CAAC;IACtD,iBAAiB,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAC1F,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E,iBAAiB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/E,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7E,oBAAoB,EAAE,MAAM,IAAI,CAAC;IACjC,gBAAgB,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CAC9C,CAAC;AAGF,wBAAsB,iBAAiB,CACnC,KAAK,EAAE,UAAU,EACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,EACtC,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,kBAAkB,GACjC,OAAO,CAAC,wBAAwB,CAAC,CAiWnC;AAED,wBAAsB,kBAAkB,CACpC,KAAK,EAAE,UAAU,EACjB,IAAI,SAAO,EACX,iBAAiB,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,EACtC,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,kBAAkB,GACjC,OAAO,CAAC;IACP,MAAM,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,QAAQ,CAAC,CAAC;IACtD,iBAAiB,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC;CAC7F,CAAC,CAgCD"}

package/dist/api/server-hono.js

@@ -1,10 +1,61 @@
 import os from 'node:os';
-import { createAgentCard, logger, AgentError, DextoAgent } from '@dexto/core';
-import { loadAgentConfig, enrichAgentConfig } from '@dexto/agent-management';
-import { Dexto, deriveDisplayName } from '@dexto/agent-management';
+import { DextoAgent, createAgentCard, logger, AgentError } from '@dexto/core';
+import { loadAgentConfig, enrichAgentConfig, deriveDisplayName, getAgentRegistry, AgentFactory, } from '@dexto/agent-management';
 import { createDextoApp, createNodeServer, createMcpTransport as createServerMcpTransport, createMcpHttpHandlers, initializeMcpServer as initializeServerMcpServer, createManualApprovalHandler, WebhookEventSubscriber, A2ASseEventSubscriber, ApprovalCoordinator, } from '@dexto/server';
 import { registerGracefulShutdown } from '../utils/graceful-shutdown.js';
 const DEFAULT_AGENT_VERSION = '1.0.0';
+/**
+ * Load image dynamically based on config and environment
+ * Priority: Config image field > Environment variable > Default
+ * Images are optional, but default to image-local for convenience
+ */
+async function loadImageForConfig(config) {
+    const imageName = config.image || process.env.DEXTO_IMAGE || '@dexto/image-local';
+    try {
+        await import(imageName);
+        logger.debug(`Loaded image: ${imageName}`);
+    }
+    catch (err) {
+        const errorMsg = `Failed to load image '${imageName}': ${err instanceof Error ? err.message : String(err)}`;
+        logger.error(errorMsg);
+        throw new Error(errorMsg);
+    }
+}
+/**
+ * List all agents (installed and available)
+ * Replacement for old Dexto.listAgents()
+ */
+async function listAgents() {
+    return AgentFactory.listAgents({
+        descriptionFallback: 'No description',
+        customAgentDescriptionFallback: 'Custom agent',
+    });
+}
+/**
+ * Create an agent from an agent ID
+ * Replacement for old Dexto.createAgent()
+ * Uses registry.resolveAgent() which auto-installs if needed
+ */
+async function createAgentFromId(agentId) {
+    try {
+        // Use registry to resolve agent path (auto-installs if not present)
+        const registry = getAgentRegistry();
+        const agentPath = await registry.resolveAgent(agentId, true);
+        // Load and enrich agent config
+        const config = await loadAgentConfig(agentPath);
+        const enrichedConfig = enrichAgentConfig(config, agentPath, {
+            logLevel: 'info', // Server uses info-level logging for visibility
+        });
+        // Load image dynamically based on config
+        await loadImageForConfig(enrichedConfig);
+        // Create agent instance
+        logger.info(`Creating agent: ${agentId} from ${agentPath}`);
+        return new DextoAgent(enrichedConfig, agentPath);
+    }
+    catch (error) {
+        throw new Error(`Failed to create agent '${agentId}': ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
 function resolvePort(listenPort) {
     if (typeof listenPort === 'number') {
         return listenPort;
@@ -19,7 +70,7 @@ function resolveBaseUrl(port) {
 export async function initializeHonoApi(agent, agentCardOverride, listenPort, agentId, webRoot, webUIConfig) {
     // Declare before registering shutdown hook to avoid TDZ on signals
     let activeAgent = agent;
-    let activeAgentId = agentId || 'default-agent';
+    let activeAgentId = agentId || 'coding-agent';
     let isSwitchingAgent = false;
     registerGracefulShutdown(() => activeAgent);
     const resolvedPort = resolvePort(listenPort);
@@ -52,7 +103,7 @@ export async function initializeHonoApi(agent, agentCardOverride, listenPort, ag
      * Helper to resolve agent ID to { id, name } by looking up in registry
      */
     async function resolveAgentInfo(agentId) {
-        const agents = await Dexto.listAgents();
+        const agents = await listAgents();
         const agent = agents.installed.find((a) => a.id === agentId) ??
             agents.available.find((a) => a.id === agentId);
         return {
@@ -135,7 +186,7 @@ export async function initializeHonoApi(agent, agentCardOverride, listenPort, ag
             const { Telemetry } = await import('@dexto/core');
             await Telemetry.shutdownGlobal();
             // 2. Create new agent from registry (will initialize fresh telemetry in createAgentServices)
-            newAgent = await Dexto.createAgent(agentId);
+            newAgent = await createAgentFromId(agentId);
             // 3. Use common switch logic (register subscribers, start agent, stop previous)
             return await performAgentSwitch(newAgent, agentId, bridge);
         }
@@ -170,7 +221,11 @@ export async function initializeHonoApi(agent, agentCardOverride, listenPort, ag
             // 2. Load agent configuration from file path
             const config = await loadAgentConfig(filePath);
             // 3. Enrich config with per-agent paths (logs, storage, etc.)
-            const enrichedConfig = enrichAgentConfig(config, filePath);
+            const enrichedConfig = enrichAgentConfig(config, filePath, {
+                logLevel: 'info', // Server uses info-level logging for visibility
+            });
+            // 3.5. Load image dynamically based on config
+            await loadImageForConfig(enrichedConfig);
             // 4. Create new agent instance directly (will initialize fresh telemetry in createAgentServices)
             newAgent = new DextoAgent(enrichedConfig, filePath);
             // 5. Use enriched agentId (derived from config or filename during enrichment)
@@ -198,7 +253,8 @@ export async function initializeHonoApi(agent, agentCardOverride, listenPort, ag
     }
     // Getter functions for routes (always use current agent)
     // getAgent automatically ensures agent is available before returning it
-    const getAgent = () => {
+    // Accepts Context parameter for compatibility with GetAgentFn type
+    const getAgent = (_ctx) => {
         // CRITICAL: Check agent availability before every access to prevent race conditions
         // during agent switching, stopping, or startup failures
         ensureAgentAvailable();
@@ -245,7 +301,7 @@ export async function initializeHonoApi(agent, agentCardOverride, listenPort, ag
     }
     // Create bridge with app
     bridgeRef = createNodeServer(app, {
-        getAgent,
+        getAgent: () => activeAgent,
         mcpHandlers: mcpTransport ? createMcpHttpHandlers(mcpTransport) : null,
     });
     // Register webhook subscriber for LLM streaming events

package/dist/cli/cli-subscriber.d.ts

@@ -30,6 +30,10 @@ export declare class CLISubscriber implements EventSubscriber {
     onResponse(text: string): void;
     onError(error: Error): void;
     onConversationReset(): void;
+    /**
+     * Capture LLM token usage analytics
+     */
+    private captureTokenUsage;
     /**
      * Run agent in headless mode and wait for completion
      * Returns a promise that resolves when the response is complete