dexto 1.13.5 → 1.14.1

package/dist/cli/commands/run/register.js

@@ -1,3 +1,6 @@
+import { Option } from 'commander';
+import { handleHeadlessApproval } from '../../approval/headless-approval-handler.js';
+import { writeHeadlessResult } from './output.js';
 import { resolveAgentPath } from '@dexto/agent-management';
 import { withAnalytics, safeExit, ExitSignal } from '../../../analytics/wrapper.js';
 export function registerRunCommand({ program, cliVersion, bootstrapAgentFromGlobalOpts, }) {
@@ -5,6 +8,9 @@ export function registerRunCommand({ program, cliVersion, bootstrapAgentFromGlob
         .command('run [prompt]')
         .description('Run a single prompt non-interactively (headless mode)')
         .option('-m, --model <model>', 'Specify the LLM model to use for this run')
+        .addOption(new Option('--format <format>', 'Output format')
+        .choices(['text', 'json', 'jsonl'])
+        .default('text'))
         .addHelpText('after', `
 Examples:
   $ dexto run "summarize this repository"
@@ -13,6 +19,8 @@ Examples:
 `)
         .action(withAnalytics('run', async (promptArg, runOptions) => {
         let agent;
+        let sessionId;
+        let result = {};
         let exitCode = 0;
         let exitReason = 'ok';
         try {
@@ -20,15 +28,19 @@ Examples:
             const prompt = await resolveHeadlessPrompt(promptArg);
             if (prompt.trim().length === 0) {
                 writeHeadlessError('Prompt cannot be empty.');
+                result = { fatalError: new Error('Prompt cannot be empty.') };
                 exitCode = 1;
                 exitReason = 'empty-prompt';
             }
             else {
-                const bootstrapOptions = runOptions?.model
+                const bootstrapOptions = runOptions.model
                     ? { mode: 'headless-run', modelOverride: runOptions.model }
                     : { mode: 'headless-run' };
                 agent = await bootstrapAgentFromGlobalOpts(bootstrapOptions);
                 const session = await agent.createSession();
+                sessionId = session.id;
+                const approvalAgent = agent;
+                approvalAgent.setApprovalHandler((request) => handleHeadlessApproval(request, approvalAgent, session.id));
                 const globalOpts = program.opts();
                 const resolvedAgentPath = await resolveAgentPath(globalOpts.agent, globalOpts.autoInstall !== false);
                 printHeadlessRunSummary({
@@ -39,13 +51,21 @@ Examples:
                     cliVersion,
                 });
                 printHeadlessMcpStartup(agent);
-                const runResult = await executeHeadlessRun(agent, session.id, prompt);
+                const runResult = await executeHeadlessRun(agent, session.id, prompt, runOptions.format);
+                result = runResult;
                 if (runResult.finalMessage !== undefined) {
                     printHeadlessAssistantResponse(runResult.finalMessage, runResult.totalTokens);
-                    writeFinalMessageToStdout(runResult.finalMessage);
+                    if (runOptions.format === 'text') {
+                        writeFinalMessageToStdout(runResult.finalMessage);
+                    }
                 }
                 else {
                     writeHeadlessError('No final response was produced.');
+                    result = {
+                        ...runResult,
+                        fatalError: runResult.fatalError ??
+                            new Error('No final response was produced.'),
+                    };
                     exitCode = 1;
                     exitReason = 'no-final-response';
                 }
@@ -59,6 +79,9 @@ Examples:
             if (err instanceof ExitSignal)
                 throw err;
             const errorMessage = err instanceof Error ? err.message : String(err);
+            result = {
+                fatalError: err instanceof Error ? err : new Error(errorMessage),
+            };
             process.stderr.write(`dexto run failed: ${errorMessage}\n`);
             exitCode = 1;
             exitReason = 'error';
@@ -73,6 +96,7 @@ Examples:
                 }
             }
         }
+        await writeHeadlessResult(runOptions.format, result, sessionId);
         safeExit('run', exitCode, exitReason);
     }));
 }

package/dist/cli/commands/setup.d.ts

@@ -2,6 +2,7 @@ import { z } from 'zod';
 declare const SetupCommandSchema: z.ZodObject<{
     provider: z.ZodOptional<z.ZodEnum<{
         "dexto-nova": "dexto-nova";
+        local: "local";
         openai: "openai";
         "openai-compatible": "openai-compatible";
         anthropic: "anthropic";
@@ -16,7 +17,6 @@ declare const SetupCommandSchema: z.ZodObject<{
         glama: "glama";
         vertex: "vertex";
         bedrock: "bedrock";
-        local: "local";
         ollama: "ollama";
     }>>;
     model: z.ZodOptional<z.ZodString>;
@@ -25,11 +25,11 @@ declare const SetupCommandSchema: z.ZodObject<{
     force: z.ZodDefault<z.ZodBoolean>;
     defaultMode: z.ZodOptional<z.ZodEnum<{
         cli: "cli";
+        mcp: "mcp";
         web: "web";
         server: "server";
         discord: "discord";
         telegram: "telegram";
-        mcp: "mcp";
     }>>;
     quickStart: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strict>;

package/dist/cli/commands/trace/client.d.ts

@@ -15,8 +15,8 @@ declare const RunTraceSpanSchema: z.ZodObject<{
     startedAt: z.ZodString;
     status: z.ZodEnum<{
         failed: "failed";
-        completed: "completed";
         cancelled: "cancelled";
+        completed: "completed";
         running: "running";
     }>;
     traceId: z.ZodString;
@@ -46,8 +46,8 @@ declare const RunTraceSchema: z.ZodObject<{
         startedAt: z.ZodString;
         status: z.ZodEnum<{
             failed: "failed";
-            completed: "completed";
             cancelled: "cancelled";
+            completed: "completed";
             running: "running";
         }>;
         traceId: z.ZodString;

package/dist/cli/utils/options.js

@@ -30,6 +30,7 @@ export function validateCliOptions(opts) {
             return !isNaN(port) && port > 0 && port <= 65535;
         }, { message: 'Port must be a number between 1 and 65535' })
             .optional(),
+        permissionsMode: z.enum(['manual', 'auto-approve']).optional(),
         autoApprove: z
             .boolean()
             .optional()
@@ -39,7 +40,7 @@ export function validateCliOptions(opts) {
             .boolean()
             .optional()
             .default(false)
-            .describe('Start the interactive CLI in bypass permissions mode (auto-approve approval prompts)'),
+            .describe('Select auto-approve permissions'),
         elicitation: z
             .boolean()
             .optional()
@@ -91,6 +92,7 @@ export function validateCliOptions(opts) {
         provider: opts.provider,
         model: opts.model,
         interactive: opts.interactive,
+        permissionsMode: opts.permissionsMode,
         autoApprove: opts.autoApprove,
         bypassPermissions: opts.bypassPermissions,
         elicitation: opts.elicitation,

package/dist/config/cli-overrides.d.ts

@@ -20,7 +20,7 @@
  */
 import type { AgentConfig } from '@dexto/agent-config';
 import { type LLMProvider } from '@dexto/llm';
-import { type LLMConfig } from '@dexto/core';
+import { type LLMConfig, type PermissionsMode } from '@dexto/core';
 import type { GlobalPreferences } from '@dexto/agent-management';
 /**
  * CLI config override type for fields that can be overridden via CLI
@@ -28,6 +28,8 @@ import type { GlobalPreferences } from '@dexto/agent-management';
  */
 export interface CLIConfigOverrides extends Partial<Pick<LLMConfig, 'provider' | 'model' | 'apiKey'>> {
     autoApprove?: boolean;
+    bypassPermissions?: boolean;
+    permissionsMode?: PermissionsMode;
     /** When false (via --no-elicitation), disables elicitation */
     elicitation?: boolean;
 }

package/dist/config/cli-overrides.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-overrides.d.ts","sourceRoot":"","sources":["../../src/config/cli-overrides.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAKH,KAAK,WAAW,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAA+C,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAC1F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE;;;GAGG;AACH,MAAM,WAAW,kBACb,SAAQ,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC,CAAC;IACjE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,yBAAyB;IACtC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,2BAA2B,EAAE,OAAO,CAAC;IACrC,wBAAwB,EAAE,OAAO,CAAC;IAClC,yBAAyB,EAAE,OAAO,CAAC;CACtC;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC7B,UAAU,EAAE,WAAW,EACvB,YAAY,CAAC,EAAE,kBAAkB,GAClC,WAAW,CAuCb;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAChC,UAAU,EAAE,WAAW,EACvB,WAAW,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACxC,WAAW,CAwBb;AAED,wBAAgB,uBAAuB,CACnC,UAAU,EAAE,WAAW,EACvB,OAAO,EAAE,yBAAyB,GACnC,WAAW,CAyCb;AAcD,wBAAgB,oBAAoB,CAChC,QAAQ,EAAE,WAAW,EACrB,SAAS,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC,GAC3D,OAAO,CAgBT;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,WAAW,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,WAAW,GAAG,SAAS,CAAC;IACtC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,aAAa,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACnC,WAAW,EAAE,WAAW,EACxB,WAAW,EAAE,iBAAiB,GAAG,IAAI,EACrC,cAAc,EAAE,MAAM,GAAG,SAAS,GACnC,wBAAwB,CAwC1B"}
+{"version":3,"file":"cli-overrides.d.ts","sourceRoot":"","sources":["../../src/config/cli-overrides.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAKH,KAAK,WAAW,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAGH,KAAK,SAAS,EACd,KAAK,eAAe,EACvB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE;;;GAGG;AACH,MAAM,WAAW,kBACb,SAAQ,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC,CAAC;IACjE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,8DAA8D;IAC9D,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,yBAAyB;IACtC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,2BAA2B,EAAE,OAAO,CAAC;IACrC,wBAAwB,EAAE,OAAO,CAAC;IAClC,yBAAyB,EAAE,OAAO,CAAC;CACtC;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC7B,UAAU,EAAE,WAAW,EACvB,YAAY,CAAC,EAAE,kBAAkB,GAClC,WAAW,CAoDb;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAChC,UAAU,EAAE,WAAW,EACvB,WAAW,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACxC,WAAW,CAwBb;AAED,wBAAgB,uBAAuB,CACnC,UAAU,EAAE,WAAW,EACvB,OAAO,EAAE,yBAAyB,GACnC,WAAW,CAyCb;AAcD,wBAAgB,oBAAoB,CAChC,QAAQ,EAAE,WAAW,EACrB,SAAS,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC,GAC3D,OAAO,CAgBT;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,WAAW,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,WAAW,GAAG,SAAS,CAAC;IACtC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,aAAa,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACnC,WAAW,EAAE,WAAW,EACxB,WAAW,EAAE,iBAAiB,GAAG,IAAI,EACrC,cAAc,EAAE,MAAM,GAAG,SAAS,GACnC,wBAAwB,CAwC1B"}

package/dist/config/cli-overrides.js

@@ -19,7 +19,7 @@
  * - Merge strategy configuration for non-LLM fields
  */
 import { LLM_PROVIDERS, getDefaultModelForProvider, requiresApiKey, requiresBaseURL, } from '@dexto/llm';
-import { EnvExpandedString, resolveApiKeyForProvider } from '@dexto/core';
+import { EnvExpandedString, resolveApiKeyForProvider, } from '@dexto/core';
 /**
  * Applies CLI overrides to an agent configuration
  * This merges CLI arguments into the base config without validation.
@@ -34,6 +34,10 @@ export function applyCLIOverrides(baseConfig, cliOverrides) {
         // No overrides, return base config as-is (no validation yet)
         return baseConfig;
     }
+    if (cliOverrides.permissionsMode === 'manual' &&
+        (cliOverrides.autoApprove || cliOverrides.bypassPermissions)) {
+        throw new Error('--permissions-mode manual conflicts with --auto-approve and --bypass-permissions.');
+    }
     // Create a deep copy of the base config for modification
     const mergedConfig = JSON.parse(JSON.stringify(baseConfig));
     // Apply CLI overrides to LLM config (llm is required in AgentConfig)
@@ -46,11 +50,13 @@ export function applyCLIOverrides(baseConfig, cliOverrides) {
     if (cliOverrides.apiKey) {
         mergedConfig.llm.apiKey = cliOverrides.apiKey;
     }
-    if (cliOverrides.autoApprove) {
+    if (cliOverrides.permissionsMode ||
+        cliOverrides.autoApprove ||
+        cliOverrides.bypassPermissions) {
         // Ensure permissions section exists before overriding
         mergedConfig.permissions = {
             ...(mergedConfig.permissions ?? {}),
-            mode: 'auto-approve',
+            mode: cliOverrides.permissionsMode ?? 'auto-approve',
         };
     }
     if (cliOverrides.elicitation === false) {

package/dist/index-main.js

@@ -1,10 +1,11 @@
 import { existsSync, readFileSync } from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
-import { Command } from 'commander';
+import { Command, Option } from 'commander';
 import * as p from '@clack/prompts';
 import chalk from 'chalk';
 import { withAnalytics, safeExit, ExitSignal } from './analytics/wrapper.js';
+import { handleHeadlessApproval } from './cli/approval/headless-approval-handler.js';
 function readVersionFromPackageJson(packageJsonPath) {
     if (!existsSync(packageJsonPath)) {
         return undefined;
@@ -46,7 +47,7 @@ process.env.DEXTO_CLI_VERSION = cliVersion;
 import { logger, startLlmRegistryAutoUpdate, DextoAgent, isPath } from '@dexto/core';
 import { getAllSupportedModels, getProviderFromModel } from '@dexto/llm';
 import { applyImageDefaults, cleanNullValues, AgentConfigSchema, loadImage, resolveServicesFromConfig, toDextoAgentOptions, } from '@dexto/agent-config';
-import { getDextoPackageRoot, resolveAgentPath, loadAgentConfig, findDextoProjectRoot, globalPreferencesExist, loadGlobalPreferences, resolveBundledScript, enrichAgentConfig, isDextoAuthEnabled, createModelAuthResolver, resolveApiKeyForProvider, getPrimaryApiKeyEnvVar, } from '@dexto/agent-management';
+import { registerConfiguredSkillPrompts, getDextoPackageRoot, resolveAgentPath, loadAgentConfig, findDextoProjectRoot, globalPreferencesExist, loadGlobalPreferences, resolveBundledScript, enrichAgentConfig, isDextoAuthEnabled, createModelAuthResolver, resolveApiKeyForProvider, getPrimaryApiKeyEnvVar, } from '@dexto/agent-management';
 import { validateCliOptions, handleCliOptionsError } from './cli/utils/options.js';
 import { validateAgentConfig } from './cli/utils/config-validation.js';
 import { applyCLIOverrides, applyStartupLLMFallback, applyUserPreferences, } from './config/cli-overrides.js';
@@ -55,6 +56,7 @@ import { registerSessionCommand } from './cli/commands/session/register.js';
 import { registerSearchCommand } from './cli/commands/search/register.js';
 import { registerAuthCommand } from './cli/commands/auth/register.js';
 import { registerBillingCommand } from './cli/commands/billing/register.js';
+import { registerCloudCommand } from './cli/commands/cloud/register.js';
 import { registerMcpCommand } from './cli/commands/mcp/register.js';
 import { registerImageCommand } from './cli/commands/image/register.js';
 import { registerPluginCommand } from './cli/commands/plugin/register.js';
@@ -110,8 +112,9 @@ program
     .option('--no-interactive', 'Disable interactive prompts and API key setup')
     .option('--skip-setup', 'Skip global setup validation (useful for MCP mode, automation)')
     .option('-m, --model <model>', 'Specify the LLM model to use')
-    .option('--auto-approve', 'Always approve tool executions without approval prompts')
-    .option('--bypass-permissions', 'Start the interactive CLI in bypass permissions mode (auto-approve approval prompts)')
+    .addOption(new Option('--permissions-mode <mode>', "Override the local agent's configured approval mode").choices(['manual', 'auto-approve']))
+    .option('--auto-approve', 'Select auto-approve permissions (mandatory approvals still apply)')
+    .option('--bypass-permissions', 'Select auto-approve permissions (alias for --permissions-mode auto-approve)')
     .option('--no-elicitation', 'Disable elicitation (agent cannot prompt user for input)')
     .option('-c, --continue', 'Continue most recent session (CLI mode)')
     .option('-r, --resume <sessionId>', 'Resume a session by ID (CLI mode)')
@@ -343,6 +346,9 @@ async function bootstrapAgentFromGlobalOpts(options) {
             console.error(err.message);
         }
         console.error(`💡 Install it with: dexto image install ${imageName}`);
+        if (isHeadlessRun) {
+            throw new Error(`Failed to load image '${imageName}'`, { cause: err });
+        }
         safeExit('bootstrap', 1, 'image-load-failed');
     }
     const configWithImageDefaults = applyImageDefaults(mergedConfig, image.defaults);
@@ -361,13 +367,6 @@ async function bootstrapAgentFromGlobalOpts(options) {
             transports: [{ type: 'silent' }],
         };
     }
-    // Override approval config for non-interactive commands.
-    // Headless operations default to auto-approve and disable elicitation to
-    // avoid waiting for interactive approval handlers.
-    enrichedConfig.permissions = {
-        ...(enrichedConfig.permissions ?? {}),
-        mode: 'auto-approve',
-    };
     enrichedConfig.elicitation = {
         enabled: false,
         ...(enrichedConfig.elicitation?.timeout !== undefined && {
@@ -376,6 +375,7 @@ async function bootstrapAgentFromGlobalOpts(options) {
     };
     const validatedConfig = AgentConfigSchema.parse(enrichedConfig);
     const services = await resolveServicesFromConfig(validatedConfig, image, { workspaceRoot });
+    registerConfiguredSkillPrompts(services.skills, validatedConfig.prompts);
     const agent = new DextoAgent(toDextoAgentOptions({
         config: validatedConfig,
         services,
@@ -385,6 +385,7 @@ async function bootstrapAgentFromGlobalOpts(options) {
             authResolver: createModelAuthResolver(),
         },
     }));
+    agent.setApprovalHandler((request) => handleHeadlessApproval(request, agent, undefined));
     await agent.start();
     await (await import('./utils/workspace.js')).applyWorkspaceToAgent(agent, workspaceRoot);
     // Register graceful shutdown
@@ -411,6 +412,7 @@ registerSessionCommand(runtimeCommandContext);
 registerSearchCommand(runtimeCommandContext);
 registerAuthCommand(runtimeCommandContext);
 registerBillingCommand(runtimeCommandContext);
+registerCloudCommand(program);
 registerMcpCommand({ program });
 // 13) Main dexto CLI - Interactive (CLI) or run in other modes (--mode web/server/mcp)
 program
@@ -861,6 +863,7 @@ program
         const services = await resolveServicesFromConfig(validatedConfig, image, {
             workspaceRoot,
         });
+        registerConfiguredSkillPrompts(services.skills, validatedConfig.prompts);
         agent = new DextoAgent(toDextoAgentOptions({
             config: validatedConfig,
             services,

package/dist/utils/env.d.ts

@@ -1,3 +1,5 @@
+/** Read an environment value from before CLI dotenv loading. */
+export declare function getIncomingEnvironmentVariable(name: string): string | undefined;
 /**
  * Multi-layer environment variable loading with context awareness.
  * Loads environment variables in priority order:

package/dist/utils/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/utils/env.ts"],"names":[],"mappings":"AASA;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,CAC1C,SAAS,GAAE,MAAsB,GAClC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAgDjC;AAED;;;;;;GAMG;AACH,wBAAsB,8BAA8B,CAChD,SAAS,GAAE,MAAsB,GAClC,OAAO,CAAC,IAAI,CAAC,CAKf"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/utils/env.ts"],"names":[],"mappings":"AAWA,gEAAgE;AAChE,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE/E;AAED;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,CAC1C,SAAS,GAAE,MAAsB,GAClC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAgDjC;AAED;;;;;;GAMG;AACH,wBAAsB,8BAA8B,CAChD,SAAS,GAAE,MAAsB,GAClC,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/utils/env.js

@@ -2,6 +2,11 @@ import * as path from 'path';
 import { homedir } from 'os';
 import dotenv from 'dotenv';
 import { getExecutionContext, ensureDextoGlobalDirectory, getDextoEnvPath, } from '@dexto/agent-management';
+let incomingEnvironment;
+/** Read an environment value from before CLI dotenv loading. */
+export function getIncomingEnvironmentVariable(name) {
+    return (incomingEnvironment ?? process.env)[name];
+}
 /**
  * Multi-layer environment variable loading with context awareness.
  * Loads environment variables in priority order:
@@ -67,6 +72,7 @@ export async function loadEnvironmentVariables(startPath = process.cwd()) {
  * @param startPath Starting directory for project detection
  */
 export async function applyLayeredEnvironmentLoading(startPath = process.cwd()) {
+    incomingEnvironment = { ...process.env };
     await ensureDextoGlobalDirectory();
     const layeredEnv = await loadEnvironmentVariables(startPath);
     Object.assign(process.env, layeredEnv);

package/dist/utils/graceful-shutdown.d.ts

@@ -13,6 +13,6 @@ export interface GracefulShutdownOptions {
      */
     forceExitTimeout?: number;
 }
-export declare function registerGracefulShutdown(getCurrentAgent: () => ShutdownTarget, options?: GracefulShutdownOptions): void;
+export declare function registerGracefulShutdown(getCurrentAgent: () => ShutdownTarget, options?: GracefulShutdownOptions): () => void;
 export {};
 //# sourceMappingURL=graceful-shutdown.d.ts.map

package/dist/utils/graceful-shutdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graceful-shutdown.d.ts","sourceRoot":"","sources":["../../src/utils/graceful-shutdown.ts"],"names":[],"mappings":"AAEA,UAAU,cAAc;IACpB,IAAI,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;CAC5C;AAED,MAAM,WAAW,uBAAuB;IACpC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,wBAAwB,CACpC,eAAe,EAAE,MAAM,cAAc,EACrC,OAAO,GAAE,uBAA4B,GACtC,IAAI,CAmHN"}
+{"version":3,"file":"graceful-shutdown.d.ts","sourceRoot":"","sources":["../../src/utils/graceful-shutdown.ts"],"names":[],"mappings":"AAEA,UAAU,cAAc;IACpB,IAAI,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;CAC5C;AAED,MAAM,WAAW,uBAAuB;IACpC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,wBAAwB,CACpC,eAAe,EAAE,MAAM,cAAc,EACrC,OAAO,GAAE,uBAA4B,GACtC,MAAM,IAAI,CAoIZ"}

package/dist/utils/graceful-shutdown.js

@@ -24,13 +24,19 @@ export function registerGracefulShutdown(getCurrentAgent, options = {}) {
             process.exit(1);
         }
     };
-    signals.forEach((signal) => {
-        process.on(signal, () => performShutdown(signal));
+    const signalListeners = signals.map((signal) => {
+        const listener = () => {
+            void performShutdown(signal);
+        };
+        process.on(signal, listener);
+        return { signal, listener };
     });
+    let sigintListener;
+    let resetTimer;
     // In ink mode, handle SIGINT specially - allow first one to pass through to Ink
     if (inkMode) {
         let firstSigintTime = null;
-        process.on('SIGINT', () => {
+        sigintListener = () => {
             const now = Date.now();
             // If already shutting down, ignore
             if (isShuttingDown)
@@ -39,7 +45,7 @@ export function registerGracefulShutdown(getCurrentAgent, options = {}) {
             if (firstSigintTime === null) {
                 firstSigintTime = now;
                 // Set timeout to clear the "first sigint" state
-                setTimeout(() => {
+                resetTimer = setTimeout(() => {
                     if (firstSigintTime !== null &&
                         Date.now() - firstSigintTime >= forceExitTimeout) {
                         firstSigintTime = null;
@@ -56,10 +62,11 @@ export function registerGracefulShutdown(getCurrentAgent, options = {}) {
                 // Timeout expired, treat as new first SIGINT
                 firstSigintTime = now;
             }
-        });
+        };
+        process.on('SIGINT', sigintListener);
     }
     // Handle uncaught exceptions
-    process.on('uncaughtException', async (error) => {
+    const exceptionListener = async (error) => {
         logger.error(`Uncaught exception: ${error instanceof Error ? error.message : String(error)}`, { error }, 'red');
         if (!isShuttingDown) {
             isShuttingDown = true;
@@ -74,8 +81,9 @@ export function registerGracefulShutdown(getCurrentAgent, options = {}) {
             }
         }
         process.exit(1);
-    });
-    process.on('unhandledRejection', async (reason) => {
+    };
+    process.on('uncaughtException', exceptionListener);
+    const rejectionListener = async (reason) => {
         logger.error(`Unhandled rejection: ${reason}`, { reason }, 'red');
         if (!isShuttingDown) {
             isShuttingDown = true;
@@ -90,5 +98,16 @@ export function registerGracefulShutdown(getCurrentAgent, options = {}) {
             }
         }
         process.exit(1);
-    });
+    };
+    process.on('unhandledRejection', rejectionListener);
+    return () => {
+        for (const { signal, listener } of signalListeners)
+            process.off(signal, listener);
+        if (sigintListener)
+            process.off('SIGINT', sigintListener);
+        if (resetTimer)
+            clearTimeout(resetTimer);
+        process.off('uncaughtException', exceptionListener);
+        process.off('unhandledRejection', rejectionListener);
+    };
 }

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "dexto",
-  "version": "1.13.5",
+  "version": "1.14.1",
   "type": "module",
   "bin": {
     "dexto": "./dist/index.js"
   },
   "dependencies": {
     "@clack/prompts": "^0.10.1",
-    "@modelcontextprotocol/sdk": "^1.28.0",
+    "@modelcontextprotocol/sdk": "^1.32.1",
     "@opentelemetry/instrumentation-http": "^0.210.0",
     "@opentelemetry/instrumentation-undici": "^0.20.0",
     "@opentelemetry/core": "^1.28.0",
@@ -34,18 +34,18 @@
     "ws": "^8.18.1",
     "yaml": "^2.8.3",
     "zod": "^4.3.6",
-    "@dexto/agent-config": "1.13.5",
-    "@dexto/agent-management": "1.13.5",
-    "@dexto/analytics": "1.13.5",
-    "@dexto/client-sdk": "1.13.5",
-    "@dexto/core": "1.13.5",
-    "@dexto/image-local": "1.13.5",
-    "@dexto/image-logger-agent": "1.13.5",
-    "@dexto/llm": "1.13.5",
-    "@dexto/registry": "1.13.5",
-    "@dexto/server": "1.13.5",
-    "@dexto/storage": "1.13.5",
-    "@dexto/tui": "1.13.5"
+    "@dexto/agent-config": "1.14.1",
+    "@dexto/agent-management": "1.14.1",
+    "@dexto/analytics": "1.14.1",
+    "@dexto/client-sdk": "1.14.1",
+    "@dexto/core": "1.14.1",
+    "@dexto/image-local": "1.14.1",
+    "@dexto/image-logger-agent": "1.14.1",
+    "@dexto/llm": "1.14.1",
+    "@dexto/registry": "1.14.1",
+    "@dexto/server": "1.14.1",
+    "@dexto/storage": "1.14.1",
+    "@dexto/tui": "1.14.1"
   },
   "devDependencies": {
     "@types/ws": "^8.5.11",