dexto 1.6.18 → 1.6.19

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

@@ -23,8 +23,8 @@ export type HonoInitializationResult = {
     ensureAgentAvailable: () => void;
     getActiveAgentId: () => string | undefined;
 };
-export declare function initializeHonoApi(agent: DextoAgent, agentCardOverride?: Partial<AgentCard>, listenPort?: number, agentId?: string, configFilePath?: string, webRoot?: string, webUIConfig?: WebUIRuntimeConfig): Promise<HonoInitializationResult>;
-export declare function startHonoApiServer(agent: DextoAgent, port?: number, agentCardOverride?: Partial<AgentCard>, agentId?: string, configFilePath?: string, webRoot?: string, webUIConfig?: WebUIRuntimeConfig): Promise<{
+export declare function initializeHonoApi(agent: DextoAgent, agentCardOverride?: Partial<AgentCard>, listenPort?: number, agentId?: string, configFilePath?: string, workspaceRoot?: string, webRoot?: string, webUIConfig?: WebUIRuntimeConfig): Promise<HonoInitializationResult>;
+export declare function startHonoApiServer(agent: DextoAgent, port?: number, agentCardOverride?: Partial<AgentCard>, agentId?: string, configFilePath?: string, workspaceRoot?: string, webRoot?: string, webUIConfig?: WebUIRuntimeConfig): Promise<{
     server: ReturnType<typeof createNodeServer>['server'];
     webhookSubscriber?: NonNullable<ReturnType<typeof createNodeServer>['webhookSubscriber']>;
 }>;

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":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAuC,MAAM,aAAa,CAAC;AAY9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,EACH,cAAc,EACd,gBAAgB,EAShB,KAAK,kBAAkB,EAC1B,MAAM,eAAe,CAAC;AA+FvB,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,cAAc,CAAC,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,kBAAkB,GACjC,OAAO,CAAC,wBAAwB,CAAC,CAmXnC;AAED,wBAAsB,kBAAkB,CACpC,KAAK,EAAE,UAAU,EACjB,IAAI,SAAO,EACX,iBAAiB,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,EACtC,OAAO,CAAC,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,MAAM,EACvB,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,CAiCD"}
+{"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;AAY9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,EACH,cAAc,EACd,gBAAgB,EAShB,KAAK,kBAAkB,EAC1B,MAAM,eAAe,CAAC;AAmGvB,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,cAAc,CAAC,EAAE,MAAM,EACvB,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,kBAAkB,GACjC,OAAO,CAAC,wBAAwB,CAAC,CA4XnC;AAED,wBAAsB,kBAAkB,CACpC,KAAK,EAAE,UAAU,EACjB,IAAI,SAAO,EACX,iBAAiB,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,EACtC,OAAO,CAAC,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,MAAM,EACvB,aAAa,CAAC,EAAE,MAAM,EACtB,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,CAkCD"}

package/dist/api/server-hono.js

@@ -5,6 +5,7 @@ import { applyUserPreferences } from '../config/cli-overrides.js';
 import { createFileSessionLoggerFactory } from '../utils/session-logger-factory.js';
 import { createDextoApp, createNodeServer, createMcpTransport as createServerMcpTransport, createMcpHttpHandlers, initializeMcpServer as initializeServerMcpServer, createManualApprovalHandler, WebhookEventSubscriber, A2ASseEventSubscriber, ApprovalCoordinator, } from '@dexto/server';
 import { registerGracefulShutdown } from '../utils/graceful-shutdown.js';
+import { applyWorkspaceToAgent } from '../utils/workspace.js';
 const DEFAULT_AGENT_VERSION = '1.0.0';
 const sessionLoggerFactory = createFileSessionLoggerFactory();
 /**
@@ -25,7 +26,7 @@ async function listAgents() {
  * Applies user preferences (preferences.yml) to ALL agents, not just the default.
  * See feature-plans/auto-update.md section 8.11 - Three-Layer LLM Resolution.
  */
-async function createAgentFromId(agentId) {
+async function createAgentFromId(agentId, workspaceRoot) {
     try {
         // Use registry to resolve agent path (auto-installs if not present)
         const registry = getAgentRegistry();
@@ -53,7 +54,10 @@ async function createAgentFromId(agentId) {
         return await createDextoAgentFromConfig({
             config,
             configPath: agentPath,
-            enrichOptions: { logLevel: 'info' },
+            enrichOptions: {
+                logLevel: 'info',
+                ...(workspaceRoot ? { workspaceRoot } : {}),
+            },
             overrides: { sessionLoggerFactory },
         });
     }
@@ -72,7 +76,7 @@ function resolveBaseUrl(port) {
     return process.env.DEXTO_BASE_URL ?? `http://localhost:${port}`;
 }
 //TODO (migration): consider moving this to the server package
-export async function initializeHonoApi(agent, agentCardOverride, listenPort, agentId, configFilePath, webRoot, webUIConfig) {
+export async function initializeHonoApi(agent, agentCardOverride, listenPort, agentId, configFilePath, workspaceRoot, webRoot, webUIConfig) {
     // Declare before registering shutdown hook to avoid TDZ on signals
     let activeAgent = agent;
     let activeAgentId = agentId || 'coding-agent';
@@ -160,6 +164,9 @@ export async function initializeHonoApi(agent, agentCardOverride, listenPort, ag
         await wireServicesToAgent(newAgent);
         logger.info(`Starting new agent: ${agentId}`);
         await newAgent.start();
+        if (workspaceRoot) {
+            await applyWorkspaceToAgent(newAgent, workspaceRoot);
+        }
         // Update agent card for A2A and MCP routes
         agentCardData = createAgentCard({
             defaultName: agentId,
@@ -195,7 +202,7 @@ export async function initializeHonoApi(agent, agentCardOverride, listenPort, ag
             // 2. Create new agent from registry (will initialize fresh telemetry in createAgentServices)
             const registry = getAgentRegistry();
             newAgentConfigPath = await registry.resolveAgent(agentId, true);
-            newAgent = await createAgentFromId(agentId);
+            newAgent = await createAgentFromId(agentId, workspaceRoot);
             // 3. Use common switch logic (register subscribers, start agent, stop previous)
             return await performAgentSwitch(newAgent, agentId, newAgentConfigPath, bridge);
         }
@@ -247,7 +254,10 @@ export async function initializeHonoApi(agent, agentCardOverride, listenPort, ag
             newAgent = await createDextoAgentFromConfig({
                 config,
                 configPath: filePath,
-                enrichOptions: { logLevel: 'info' },
+                enrichOptions: {
+                    logLevel: 'info',
+                    ...(workspaceRoot ? { workspaceRoot } : {}),
+                },
                 overrides: { sessionLoggerFactory },
             });
             // 4. Use enriched agentId (derived from config or filename during enrichment)
@@ -351,6 +361,9 @@ export async function initializeHonoApi(agent, agentCardOverride, listenPort, ag
     // Start the initial agent now that approval handler is set and subscribers are wired
     logger.info('Starting initial agent...');
     await activeAgent.start();
+    if (workspaceRoot) {
+        await applyWorkspaceToAgent(activeAgent, workspaceRoot);
+    }
     // Initialize MCP server after agent has started
     if (mcpTransport) {
         try {
@@ -376,8 +389,8 @@ export async function initializeHonoApi(agent, agentCardOverride, listenPort, ag
         getActiveAgentId: () => activeAgentId,
     };
 }
-export async function startHonoApiServer(agent, port = 3000, agentCardOverride, agentId, configFilePath, webRoot, webUIConfig) {
-    const { server, webhookSubscriber } = await initializeHonoApi(agent, agentCardOverride, port, agentId, configFilePath, webRoot, webUIConfig);
+export async function startHonoApiServer(agent, port = 3000, agentCardOverride, agentId, configFilePath, workspaceRoot, webRoot, webUIConfig) {
+    const { server, webhookSubscriber } = await initializeHonoApi(agent, agentCardOverride, port, agentId, configFilePath, workspaceRoot, webRoot, webUIConfig);
     server.listen(port, '0.0.0.0', () => {
         const networkInterfaces = os.networkInterfaces();
         let localIp = 'localhost';

package/dist/cli/modes/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/cli/modes/cli.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAsBpD,wBAAsB,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAwKxE"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/cli/modes/cli.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAuBpD,wBAAsB,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAgLxE"}

package/dist/cli/modes/cli.js

@@ -1,6 +1,7 @@
 import chalk from 'chalk';
 import { logger } from '@dexto/core';
 import { safeExit, ExitSignal } from '../../analytics/wrapper.js';
+import { applyWorkspaceToAgent } from '../../utils/workspace.js';
 async function getMostRecentSessionId(agent) {
     const sessionIds = await agent.listSessions();
     if (sessionIds.length === 0) {
@@ -18,7 +19,7 @@ async function getMostRecentSessionId(agent) {
     return mostRecentId;
 }
 export async function runCliMode(context) {
-    const { agent, opts, validatedConfig, resolvedPath, initialPrompt, getVersionCheckResult } = context;
+    const { agent, opts, workspaceRoot, validatedConfig, resolvedPath, initialPrompt, getVersionCheckResult, } = context;
     const needsHandler = validatedConfig.permissions.mode === 'manual' || validatedConfig.elicitation.enabled;
     if (needsHandler) {
         const { createCLIApprovalHandler } = await import('../approval/index.js');
@@ -26,8 +27,9 @@ export async function runCliMode(context) {
         agent.setApprovalHandler(handler);
         logger.debug('CLI approval handler configured for Ink CLI');
     }
-    await agent.start();
     try {
+        await agent.start();
+        await applyWorkspaceToAgent(agent, workspaceRoot);
         const llmConfig = agent.getCurrentLLMConfig();
         const { requiresApiKey } = await import('@dexto/core');
         if (requiresApiKey(llmConfig.provider) && !llmConfig.apiKey?.trim()) {

package/dist/cli/modes/context.d.ts

@@ -11,6 +11,7 @@ export interface MainModeOptions {
 export interface MainModeContext {
     agent: DextoAgent;
     opts: MainModeOptions;
+    workspaceRoot: string;
     validatedConfig: ValidatedAgentConfig;
     resolvedPath: string;
     derivedAgentId: string;

package/dist/cli/modes/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/cli/modes/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,eAAe,CAAC;IACtB,eAAe,EAAE,oBAAoB,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,qBAAqB,EAAE,MAAM,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;CAC3D"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/cli/modes/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,eAAe,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,oBAAoB,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,qBAAqB,EAAE,MAAM,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;CAC3D"}

package/dist/cli/modes/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/cli/modes/server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,wBAAsB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA0C3E"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/cli/modes/server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,wBAAsB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAkD3E"}

package/dist/cli/modes/server.js

@@ -1,6 +1,6 @@
 import { getPort } from '../../utils/port-utils.js';
 export async function runServerMode(context) {
-    const { agent, opts, derivedAgentId, resolvedPath, getVersionCheckResult } = context;
+    const { agent, opts, workspaceRoot, derivedAgentId, resolvedPath, getVersionCheckResult } = context;
     const { startHonoApiServer } = await import('../../api/server-hono.js');
     const agentCard = agent.config.agentCard ?? {};
     const defaultPort = (() => {
@@ -20,7 +20,7 @@ export async function runServerMode(context) {
     const apiPort = getPort(process.env.PORT, defaultPort, 'PORT');
     const apiUrl = process.env.DEXTO_URL ?? `http://localhost:${apiPort}`;
     console.log('🌐 Starting server (REST APIs + SSE)...');
-    await startHonoApiServer(agent, apiPort, agentCard, derivedAgentId, resolvedPath);
+    await startHonoApiServer(agent, apiPort, agentCard, derivedAgentId, resolvedPath, workspaceRoot);
     console.log(`✅ Server running at ${apiUrl}`);
     console.log('Available endpoints:');
     console.log('  POST /api/message - Send async message');

package/dist/cli/modes/web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../../src/cli/modes/web.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,wBAAsB,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAmExE"}
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../../src/cli/modes/web.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,wBAAsB,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAqExE"}

package/dist/cli/modes/web.js

@@ -1,7 +1,7 @@
 import chalk from 'chalk';
 import { getPort } from '../../utils/port-utils.js';
 export async function runWebMode(context) {
-    const { agent, opts, derivedAgentId, resolvedPath, getVersionCheckResult } = context;
+    const { agent, opts, workspaceRoot, derivedAgentId, resolvedPath, getVersionCheckResult } = context;
     const [{ resolveWebRoot }, { startHonoApiServer }, { getWebUIAnalyticsConfig }] = await Promise.all([
         import('../../web.js'),
         import('../../api/server-hono.js'),
@@ -30,7 +30,7 @@ export async function runWebMode(context) {
         console.info('For development: Run "pnpm dev" for hot reload');
     }
     const webUIConfig = webRoot ? { analytics: await getWebUIAnalyticsConfig() } : undefined;
-    await startHonoApiServer(agent, port, agent.config.agentCard || {}, derivedAgentId, resolvedPath, webRoot, webUIConfig);
+    await startHonoApiServer(agent, port, agent.config.agentCard || {}, derivedAgentId, resolvedPath, workspaceRoot, webRoot, webUIConfig);
     console.log(chalk.green(`✅ Server running at ${serverUrl}`));
     const webUpdateInfo = await getVersionCheckResult();
     if (webUpdateInfo) {

package/dist/index-main.js

@@ -356,6 +356,7 @@ async function bootstrapAgentFromGlobalOpts(options) {
         services,
     }));
     await agent.start();
+    await (await import('./utils/workspace.js')).applyWorkspaceToAgent(agent, workspaceRoot);
     // Register graceful shutdown
     const shutdown = async () => {
         try {
@@ -417,6 +418,7 @@ program
         logger.debug('WARNING: .env file not found; copy .env.example and set your API keys.');
     }
     const opts = program.opts();
+    const workspaceRoot = findDextoProjectRoot(process.cwd()) ?? process.cwd();
     // Set dev mode early to use local repo agents instead of ~/.dexto
     if (opts.dev) {
         process.env.DEXTO_DEV_MODE = 'true';
@@ -722,7 +724,6 @@ program
         // Enrichment adds filesystem paths to storage (schema has in-memory defaults)
         // Interactive CLI mode: only log to file (console would interfere with chat UI)
         const isInteractiveCli = opts.mode === 'cli';
-        const workspaceRoot = findDextoProjectRoot(process.cwd()) ?? process.cwd();
         const enrichedConfig = enrichAgentConfig(configWithImageDefaults, resolvedPath, {
             isInteractiveCli,
             logLevel: 'info', // CLI uses info-level logging for visibility
@@ -826,6 +827,7 @@ program
         // - other modes: start immediately (no approval support)
         if (opts.mode !== 'web' && opts.mode !== 'server' && opts.mode !== 'cli') {
             await agent.start();
+            await (await import('./utils/workspace.js')).applyWorkspaceToAgent(agent, workspaceRoot);
         }
         // Derive a concise agent ID for display purposes (used by API/UI)
         // Prefer agentCard.name, otherwise extract from filename
@@ -851,6 +853,7 @@ program
     await dispatchMainMode({
         agent,
         opts: mainModeOpts,
+        workspaceRoot,
         validatedConfig,
         resolvedPath,
         derivedAgentId,

package/dist/utils/workspace.d.ts

@@ -0,0 +1,9 @@
+import type { DextoAgent } from '@dexto/core';
+type WorkspaceAwareAgent = Pick<DextoAgent, 'getWorkspace' | 'setWorkspace'>;
+/**
+ * Keep the runtime workspace in sync with the host-resolved project root so
+ * prompt contributors and downstream services don't fall back to process.cwd().
+ */
+export declare function applyWorkspaceToAgent(agent: WorkspaceAwareAgent, workspaceRoot: string): Promise<void>;
+export {};
+//# sourceMappingURL=workspace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/utils/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,KAAK,mBAAmB,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,GAAG,cAAc,CAAC,CAAC;AAE7E;;;GAGG;AACH,wBAAsB,qBAAqB,CACvC,KAAK,EAAE,mBAAmB,EAC1B,aAAa,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/utils/workspace.js

@@ -0,0 +1,17 @@
+/**
+ * Keep the runtime workspace in sync with the host-resolved project root so
+ * prompt contributors and downstream services don't fall back to process.cwd().
+ */
+export async function applyWorkspaceToAgent(agent, workspaceRoot) {
+    const normalizedWorkspaceRoot = workspaceRoot.trim();
+    if (!normalizedWorkspaceRoot) {
+        return;
+    }
+    const currentWorkspace = await agent.getWorkspace();
+    if (currentWorkspace?.path === normalizedWorkspaceRoot) {
+        return;
+    }
+    await agent.setWorkspace({
+        path: normalizedWorkspaceRoot,
+    });
+}