dexto 1.4.0 → 1.5.0

package/README.md

@@ -309,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
@@ -326,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
@@ -381,6 +400,42 @@ See our [Dexto Agent SDK docs](https://docs.dexto.ai/docs/guides/dexto-sdk) for
 
 ## 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.

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,33 +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
 
 # Elicitation configuration - required for ask_user tool
 elicitation:
   enabled: true
   timeout: 120000
 
-# Internal tools - all coding tools enabled
+# 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,11 +77,11 @@ 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
@@ -113,6 +113,8 @@ elicitation:
 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;AAQ9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,EACH,cAAc,EACd,gBAAgB,EAShB,KAAK,kBAAkB,EAC1B,MAAM,eAAe,CAAC;AAwEvB,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,CA6VnC;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,9 +1,26 @@
 import os from 'node:os';
-import { createAgentCard, logger, AgentError, DextoAgent } from '@dexto/core';
+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()
@@ -23,12 +40,14 @@ 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, true);
+        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);
@@ -51,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);
@@ -205,6 +224,8 @@ export async function initializeHonoApi(agent, agentCardOverride, listenPort, ag
             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)
@@ -232,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();
@@ -279,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

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

@@ -1 +1 @@
-{"version":3,"file":"cli-subscriber.d.ts","sourceRoot":"","sources":["../../src/cli/cli-subscriber.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAU,UAAU,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD;;;GAGG;AACH,qBAAa,aAAc,YAAW,eAAe;IACjD,OAAO,CAAC,gBAAgB,CAAc;IACtC,OAAO,CAAC,iBAAiB,CAAC,CAAa;IACvC,OAAO,CAAC,gBAAgB,CAAC,CAAyB;IAElD,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IA0BxC;;;OAGG;IACH,OAAO,IAAI,IAAI;IAcf,UAAU,IAAI,IAAI;IAIlB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM3B,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAK9C,YAAY,CACR,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,mBAAmB,EAC9B,SAAS,CAAC,EAAE,OAAO,EACnB,OAAO,CAAC,EAAE,OAAO,GAClB,IAAI;IAMP,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IA0B9B,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IA0B3B,mBAAmB,IAAI,IAAI;IAM3B;;;OAGG;IACG,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAsBxF"}
+{"version":3,"file":"cli-subscriber.d.ts","sourceRoot":"","sources":["../../src/cli/cli-subscriber.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAU,UAAU,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,mBAAmB,EAAiB,MAAM,aAAa,CAAC;AAGtE;;;GAGG;AACH,qBAAa,aAAc,YAAW,eAAe;IACjD,OAAO,CAAC,gBAAgB,CAAc;IACtC,OAAO,CAAC,iBAAiB,CAAC,CAAa;IACvC,OAAO,CAAC,gBAAgB,CAAC,CAAyB;IAElD,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IA6BxC;;;OAGG;IACH,OAAO,IAAI,IAAI;IAcf,UAAU,IAAI,IAAI;IAIlB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM3B,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAK9C,YAAY,CACR,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,mBAAmB,EAC9B,SAAS,CAAC,EAAE,OAAO,EACnB,OAAO,CAAC,EAAE,OAAO,GAClB,IAAI;IAMP,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IA0B9B,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAyC3B,mBAAmB,IAAI,IAAI;IAM3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoBzB;;;OAGG;IACG,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAsBxF"}

package/dist/cli/cli-subscriber.js

@@ -6,6 +6,7 @@
  * No TUI, no boxes - just clean text output
  */
 import { logger } from '@dexto/core';
+import { capture } from '../analytics/index.js';
 /**
  * Event subscriber for CLI headless mode
  * Implements the standard EventSubscriber pattern used throughout the codebase
@@ -30,7 +31,10 @@ export class CLISubscriber {
             }
             // For error case (success=false), the error is handled via llm:error event
         });
-        eventBus.on('llm:response', (payload) => this.onResponse(payload.content));
+        eventBus.on('llm:response', (payload) => {
+            this.onResponse(payload.content);
+            this.captureTokenUsage(payload);
+        });
         eventBus.on('llm:error', (payload) => this.onError(payload.error));
         eventBus.on('session:reset', this.onConversationReset.bind(this));
     }
@@ -93,9 +97,21 @@ export class CLISubscriber {
     onError(error) {
         // Clear any partial response state
         this.streamingContent = '';
-        // Show error to stderr for immediate user feedback (with stack for debugging)
+        // Show error to stderr for immediate user feedback
         console.error(`❌ Error: ${error.message}`);
+        // Show recovery guidance if available (for DextoRuntimeError)
+        if ('recovery' in error && error.recovery) {
+            const recoveryMessages = Array.isArray(error.recovery)
+                ? error.recovery
+                : [error.recovery];
+            console.error('');
+            recoveryMessages.forEach((msg) => {
+                console.error(`💡 ${msg}`);
+            });
+        }
+        // Show stack for debugging if available
         if (error.stack) {
+            console.error('');
             console.error(error.stack);
         }
         // Log details to file
@@ -103,6 +119,7 @@ export class CLISubscriber {
             stack: error.stack,
             name: error.name,
             cause: error.cause,
+            recovery: 'recovery' in error ? error.recovery : undefined,
         });
         // Reject completion promise if waiting
         if (this.completionReject) {
@@ -117,6 +134,27 @@ export class CLISubscriber {
         this.streamingContent = '';
         logger.info('🔄 Conversation history cleared.', null, 'blue');
     }
+    /**
+     * Capture LLM token usage analytics
+     */
+    captureTokenUsage(payload) {
+        const { tokenUsage, provider, model, sessionId } = payload;
+        if (!tokenUsage || (!tokenUsage.inputTokens && !tokenUsage.outputTokens)) {
+            return;
+        }
+        capture('dexto_llm_tokens_consumed', {
+            source: 'cli',
+            sessionId,
+            provider,
+            model,
+            inputTokens: tokenUsage.inputTokens,
+            outputTokens: tokenUsage.outputTokens,
+            reasoningTokens: tokenUsage.reasoningTokens,
+            totalTokens: tokenUsage.totalTokens,
+            cacheReadTokens: tokenUsage.cacheReadTokens,
+            cacheWriteTokens: tokenUsage.cacheWriteTokens,
+        });
+    }
     /**
      * Run agent in headless mode and wait for completion
      * Returns a promise that resolves when the response is complete

package/dist/cli/commands/create-app.d.ts

@@ -1,18 +1,20 @@
+type AppType = 'script' | 'webapp';
+export interface CreateAppOptions {
+    fromImage?: string;
+    fromCore?: boolean;
+    type?: AppType;
+}
 /**
- * Creates basic scaffolding for a Dexto project
- * sets up git and gitignore, and sets up initial dependencies
- * Does not add scripts to package.json or create tsconfig.json which require the directory name
- * @param name - The name of the project
+ * Creates a Dexto application with two possible modes:
+ * - from-image: Use existing image (recommended)
+ * - from-core: Build from @dexto/core with custom providers (advanced)
+ *
+ * Note: To create a new image that extends another image, use `dexto create-image` instead.
+ *
+ * @param name - Optional name of the app project
+ * @param options - Optional flags to specify mode and base image
  * @returns The absolute path to the created project directory
  */
-export declare function createDextoProject(name?: string): Promise<string>;
-/**
- * Adds the dexto scripts to the package.json. Assumes the package.json already exists and is accessible
- * @param directory - The directory of the project
- */
-export declare function addDextoScriptsToPackageJson(directory: string, projectPath: string): Promise<void>;
-/** Creates a tsconfig.json file in the project directory */
-export declare function createTsconfigJson(projectPath: string, directory: string): Promise<void>;
-/** Adds notes for users to get started with their new initialized Dexto project */
-export declare function postCreateDexto(projectPath: string, directory: string): Promise<void>;
+export declare function createDextoProject(name?: string, options?: CreateAppOptions): Promise<string>;
+export {};
 //# sourceMappingURL=create-app.d.ts.map

package/dist/cli/commands/create-app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-app.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/create-app.ts"],"names":[],"mappings":"AAYA;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkGvE;AAED;;;GAGG;AACH,wBAAsB,4BAA4B,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,iBAQxF;AAED,4DAA4D;AAC5D,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,iBAoB9E;AAED,mFAAmF;AACnF,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,iBAW3E"}
+{"version":3,"file":"create-app.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/create-app.ts"],"names":[],"mappings":"AA8BA,KAAK,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEnC,MAAM,WAAW,gBAAgB;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACpC,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,gBAAgB,GAC3B,OAAO,CAAC,MAAM,CAAC,CA0JjB"}