dexto 1.3.0 → 1.5.0

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;IAsBxC;;;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
@@ -23,8 +24,17 @@ export class CLISubscriber {
             // Ignore reasoning chunks for headless mode
         });
         eventBus.on('llm:tool-call', (payload) => this.onToolCall(payload.toolName, payload.args));
-        eventBus.on('llm:tool-result', (payload) => this.onToolResult(payload.toolName, payload.sanitized, payload.rawResult, payload.success));
-        eventBus.on('llm:response', (payload) => this.onResponse(payload.content));
+        eventBus.on('llm:tool-result', (payload) => {
+            // Only call onToolResult when we have sanitized result (success case)
+            if (payload.sanitized) {
+                this.onToolResult(payload.toolName, payload.sanitized, payload.rawResult, payload.success);
+            }
+            // For error case (success=false), the error is handled via llm:error event
+        });
+        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));
     }
@@ -87,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
@@ -97,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) {
@@ -111,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"}