dexto 1.6.16 → 1.6.17

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

@@ -1,3 +1,4 @@
+import type { StreamingEvent } from '@dexto/core';
 import { z } from 'zod';
 import type { DeployAgent } from './config.js';
 declare const CloudAgentStateSchema: z.ZodObject<{
@@ -7,6 +8,43 @@ declare const CloudAgentStateSchema: z.ZodObject<{
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     status: z.ZodString;
 }, z.ZodTypeAny, "passthrough">>;
+declare const CloudChatContentPartSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    text: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    type: "text";
+    text: string;
+}, {
+    type: "text";
+    text: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"image">;
+    image: z.ZodString;
+    mimeType: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    type: "image";
+    image: string;
+    mimeType?: string | undefined;
+}, {
+    type: "image";
+    image: string;
+    mimeType?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"file">;
+    data: z.ZodString;
+    mimeType: z.ZodString;
+    filename: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    type: "file";
+    data: string;
+    mimeType: string;
+    filename?: string | undefined;
+}, {
+    type: "file";
+    data: string;
+    mimeType: string;
+    filename?: string | undefined;
+}>]>;
 export interface DeployCloudAgentResult {
     cloudAgentId: string;
     agentUrl: string;
@@ -35,6 +73,40 @@ export interface CloudAgentDeleteResult {
     cloudAgentId: string;
     agentUrl: string;
 }
+export interface CloudChatSessionResult {
+    id: string;
+    createdAt: number | null;
+    lastActivity: number | null;
+    messageCount: number;
+    title: string | null;
+    workspaceId: string | null;
+    parentSessionId: string | null;
+}
+export interface CloudChatHistoryMessageResult {
+    role: 'user' | 'assistant' | 'system' | 'tool';
+    content: z.output<typeof CloudChatContentPartSchema>[];
+    timestamp?: number;
+    name?: string;
+    toolCallId?: string;
+    success?: boolean;
+    reasoning?: string;
+    model?: string;
+    provider?: string;
+}
+export interface CloudChatHistoryResult {
+    history: CloudChatHistoryMessageResult[];
+    isBusy: boolean;
+    stale: boolean;
+}
+export interface CloudChatApprovalDecision {
+    status: 'approved' | 'denied' | 'cancelled';
+    formData?: Record<string, unknown>;
+    rememberChoice?: boolean;
+    rememberPattern?: string;
+    rememberDirectory?: boolean;
+    reason?: string;
+    message?: string;
+}
 export declare function resolveSandboxBaseUrl(): string;
 export declare function createDeployClient(): {
     deployWorkspace(input: {
@@ -46,6 +118,26 @@ export declare function createDeployClient(): {
     listCloudAgents(): Promise<CloudAgentListItemResult[]>;
     stopCloudAgent(cloudAgentId: string): Promise<CloudAgentStopResult>;
     deleteCloudAgent(cloudAgentId: string): Promise<CloudAgentDeleteResult>;
+    listCloudAgentSessions(cloudAgentId: string): Promise<CloudChatSessionResult[]>;
+    createCloudAgentSession(cloudAgentId: string, input?: {
+        sessionId?: string;
+    }): Promise<CloudChatSessionResult>;
+    getCloudAgentSessionHistory(cloudAgentId: string, sessionId: string): Promise<CloudChatHistoryResult>;
+    resetCloudAgentSession(cloudAgentId: string, sessionId: string): Promise<void>;
+    clearCloudAgentSessionContext(cloudAgentId: string, sessionId: string): Promise<void>;
+    deleteCloudAgentSession(cloudAgentId: string, sessionId: string): Promise<void>;
+    generateCloudAgentSessionTitle(cloudAgentId: string, sessionId: string): Promise<{
+        title: string | null;
+        sessionId: string;
+    } | null>;
+    cancelCloudAgentSessionRun(cloudAgentId: string, sessionId: string): Promise<void>;
+    listCloudAgentApprovals(cloudAgentId: string, sessionId: string): Promise<unknown[]>;
+    submitCloudAgentApproval(cloudAgentId: string, approvalId: string, decision: CloudChatApprovalDecision): Promise<void>;
+    streamCloudAgentMessage(cloudAgentId: string, input: {
+        sessionId: string;
+        content: string;
+        signal?: AbortSignal;
+    }): Promise<AsyncIterableIterator<StreamingEvent>>;
 };
 export {};
 //# sourceMappingURL=client.d.ts.map

package/dist/cli/commands/deploy/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/deploy/client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAO/C,QAAA,MAAM,qBAAqB;;;;;;gCAIT,CAAC;AAgGnB,MAAM,WAAW,sBAAsB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,qBAAqB,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,sBAAsB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,qBAAqB,CAAC,CAAC;IAC9C,KAAK,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,qBAAqB,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,oBAAoB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAaD,wBAAgB,qBAAqB,IAAI,MAAM,CAY9C;AAuED,wBAAgB,kBAAkB;2BAEG;QACzB,KAAK,EAAE,WAAW,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,OAAO,CAAC,sBAAsB,CAAC;gCAsCD,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;uBAkBjD,OAAO,CAAC,wBAAwB,EAAE,CAAC;iCAkBzB,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;mCA0BpC,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;EAgBpF"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/deploy/client.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/deploy/client.js

@@ -1,7 +1,8 @@
 import { promises as fs } from 'fs';
 import path from 'path';
+import { createMessageStream } from '@dexto/client-sdk';
 import { z } from 'zod';
-import { getAuthToken, getDextoApiKey } from '../../auth/service.js';
+import { getAuthToken, getDextoApiKey, loadAuth } from '../../auth/service.js';
 const SANDBOX_URL_ENV_VAR = 'DEXTO_SANDBOX_URL';
 const DEFAULT_SANDBOX_URL = 'https://sandbox.dexto.ai';
 const CloudAgentStateSchema = z
@@ -96,6 +97,90 @@ const DeleteResponseSchema = z
         .optional(),
 })
     .passthrough();
+const CloudChatContentPartSchema = z
+    .discriminatedUnion('type', [
+    z
+        .object({
+        type: z.literal('text'),
+        text: z.string(),
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal('image'),
+        image: z.string(),
+        mimeType: z.string().optional(),
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal('file'),
+        data: z.string(),
+        mimeType: z.string(),
+        filename: z.string().optional(),
+    })
+        .strict(),
+])
+    .describe('Cloud chat content part');
+const CloudChatSessionSchema = z
+    .object({
+    id: z.string(),
+    createdAt: z.number().nullable().optional(),
+    lastActivity: z.number().nullable().optional(),
+    messageCount: z.number().int().nonnegative().optional(),
+    title: z.string().nullable().optional(),
+    workspaceId: z.string().nullable().optional(),
+    parentSessionId: z.string().nullable().optional(),
+})
+    .passthrough();
+const CloudChatSessionListResponseSchema = z
+    .object({
+    sessions: z.array(CloudChatSessionSchema),
+})
+    .passthrough();
+const CloudChatSessionResponseSchema = z
+    .object({
+    session: CloudChatSessionSchema,
+})
+    .passthrough();
+const CloudChatHistoryMessageSchema = z
+    .object({
+    role: z.enum(['user', 'assistant', 'system', 'tool']),
+    content: z.array(CloudChatContentPartSchema),
+    timestamp: z.number().optional(),
+    name: z.string().optional(),
+    toolCallId: z.string().optional(),
+    success: z.boolean().optional(),
+    reasoning: z.string().optional(),
+    model: z.string().optional(),
+    provider: z.string().optional(),
+    displayData: z.unknown().optional(),
+    presentationSnapshot: z.unknown().optional(),
+})
+    .passthrough();
+const CloudChatHistoryResponseSchema = z
+    .object({
+    history: z.array(CloudChatHistoryMessageSchema),
+    isBusy: z.boolean().optional(),
+    stale: z.boolean().optional(),
+})
+    .passthrough();
+const CloudChatApprovalsResponseSchema = z
+    .object({
+    approvals: z.array(z.unknown()).default([]),
+})
+    .passthrough();
+function normalizeCloudChatSession(session) {
+    return {
+        id: session.id,
+        createdAt: session.createdAt ?? null,
+        lastActivity: session.lastActivity ?? null,
+        messageCount: session.messageCount ?? 0,
+        title: session.title ?? null,
+        workspaceId: session.workspaceId ?? null,
+        parentSessionId: session.parentSessionId ?? null,
+    };
+}
 class SandboxApiError extends Error {
     status;
     constructor(message, status) {
@@ -117,14 +202,19 @@ export function resolveSandboxBaseUrl() {
     return DEFAULT_SANDBOX_URL;
 }
 async function resolveAccessToken() {
-    const dextoApiKey = await getDextoApiKey();
-    if (dextoApiKey && dextoApiKey.trim().length > 0) {
-        return dextoApiKey.trim();
+    const auth = await loadAuth();
+    const storedDextoApiKey = auth?.dextoApiKey?.trim();
+    if (storedDextoApiKey && storedDextoApiKey.length > 0) {
+        return storedDextoApiKey;
     }
     const authToken = await getAuthToken();
     if (authToken && authToken.trim().length > 0) {
         return authToken.trim();
     }
+    const dextoApiKey = await getDextoApiKey();
+    if (dextoApiKey && dextoApiKey.trim().length > 0) {
+        return dextoApiKey.trim();
+    }
     throw new Error('Authentication required. Run `dexto login` before using `dexto deploy`.');
 }
 async function parseJsonResponse(response) {
@@ -265,5 +355,171 @@ export function createDeployClient() {
                 agentUrl: data.agentUrl,
             };
         },
+        async listCloudAgentSessions(cloudAgentId) {
+            const response = await request(`/cloud-agents/${encodeURIComponent(cloudAgentId)}/agent/sessions`, {
+                method: 'GET',
+            });
+            if (!response.ok) {
+                await throwApiError(response);
+            }
+            const payload = CloudChatSessionListResponseSchema.parse(await response.json());
+            return payload.sessions.map(normalizeCloudChatSession);
+        },
+        async createCloudAgentSession(cloudAgentId, input) {
+            const response = await request(`/cloud-agents/${encodeURIComponent(cloudAgentId)}/agent/sessions`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(input ?? {}),
+            });
+            if (!response.ok) {
+                await throwApiError(response);
+            }
+            const payload = CloudChatSessionResponseSchema.parse(await response.json());
+            return normalizeCloudChatSession(payload.session);
+        },
+        async getCloudAgentSessionHistory(cloudAgentId, sessionId) {
+            const response = await request(`/cloud-agents/${encodeURIComponent(cloudAgentId)}/agent/sessions/${encodeURIComponent(sessionId)}/history`, {
+                method: 'GET',
+            });
+            if (!response.ok) {
+                await throwApiError(response);
+            }
+            const payload = CloudChatHistoryResponseSchema.parse(await response.json());
+            return {
+                history: payload.history.map((entry) => ({
+                    role: entry.role,
+                    content: entry.content,
+                    ...(entry.timestamp !== undefined ? { timestamp: entry.timestamp } : {}),
+                    ...(entry.name !== undefined ? { name: entry.name } : {}),
+                    ...(entry.toolCallId !== undefined ? { toolCallId: entry.toolCallId } : {}),
+                    ...(entry.success !== undefined ? { success: entry.success } : {}),
+                    ...(entry.reasoning !== undefined ? { reasoning: entry.reasoning } : {}),
+                    ...(entry.model !== undefined ? { model: entry.model } : {}),
+                    ...(entry.provider !== undefined ? { provider: entry.provider } : {}),
+                })),
+                isBusy: payload.isBusy ?? false,
+                stale: payload.stale === true,
+            };
+        },
+        async resetCloudAgentSession(cloudAgentId, sessionId) {
+            const response = await request(`/cloud-agents/${encodeURIComponent(cloudAgentId)}/agent/sessions/${encodeURIComponent(sessionId)}/reset`, {
+                method: 'POST',
+            });
+            if (!response.ok) {
+                await throwApiError(response);
+            }
+        },
+        async clearCloudAgentSessionContext(cloudAgentId, sessionId) {
+            const response = await request(`/cloud-agents/${encodeURIComponent(cloudAgentId)}/agent/sessions/${encodeURIComponent(sessionId)}/clear-context`, {
+                method: 'POST',
+            });
+            if (!response.ok) {
+                await throwApiError(response);
+            }
+        },
+        async deleteCloudAgentSession(cloudAgentId, sessionId) {
+            const response = await request(`/cloud-agents/${encodeURIComponent(cloudAgentId)}/agent/sessions/${encodeURIComponent(sessionId)}`, {
+                method: 'DELETE',
+            });
+            if (!response.ok) {
+                await throwApiError(response);
+            }
+        },
+        async generateCloudAgentSessionTitle(cloudAgentId, sessionId) {
+            const response = await request(`/cloud-agents/${encodeURIComponent(cloudAgentId)}/agent/sessions/${encodeURIComponent(sessionId)}/generate-title`, {
+                method: 'POST',
+            });
+            if (!response.ok) {
+                await throwApiError(response);
+            }
+            const payload = z
+                .object({
+                title: z.string().nullable().optional(),
+                sessionId: z.string().optional(),
+            })
+                .passthrough()
+                .parse(await response.json());
+            return {
+                title: payload.title ?? null,
+                sessionId: payload.sessionId ?? sessionId,
+            };
+        },
+        async cancelCloudAgentSessionRun(cloudAgentId, sessionId) {
+            const response = await request(`/cloud-agents/${encodeURIComponent(cloudAgentId)}/agent/sessions/${encodeURIComponent(sessionId)}/cancel`, {
+                method: 'POST',
+            });
+            if (!response.ok) {
+                await throwApiError(response);
+            }
+        },
+        async listCloudAgentApprovals(cloudAgentId, sessionId) {
+            const response = await request(`/cloud-agents/${encodeURIComponent(cloudAgentId)}/agent/approvals?sessionId=${encodeURIComponent(sessionId)}`, {
+                method: 'GET',
+            });
+            if (!response.ok) {
+                await throwApiError(response);
+            }
+            const payload = CloudChatApprovalsResponseSchema.parse(await response.json());
+            return payload.approvals;
+        },
+        async submitCloudAgentApproval(cloudAgentId, approvalId, decision) {
+            const response = await request(`/cloud-agents/${encodeURIComponent(cloudAgentId)}/agent/approvals/${encodeURIComponent(approvalId)}`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    status: decision.status,
+                    ...(decision.formData !== undefined ? { formData: decision.formData } : {}),
+                    ...(decision.rememberChoice !== undefined
+                        ? { rememberChoice: decision.rememberChoice }
+                        : {}),
+                    ...(decision.rememberPattern !== undefined
+                        ? { rememberPattern: decision.rememberPattern }
+                        : {}),
+                    ...(decision.rememberDirectory !== undefined
+                        ? { rememberDirectory: decision.rememberDirectory }
+                        : {}),
+                    ...(decision.reason !== undefined ? { reason: decision.reason } : {}),
+                    ...(decision.message !== undefined ? { message: decision.message } : {}),
+                }),
+            });
+            if (!response.ok) {
+                await throwApiError(response);
+            }
+        },
+        async streamCloudAgentMessage(cloudAgentId, input) {
+            const responsePromise = request(`/cloud-agents/${encodeURIComponent(cloudAgentId)}/agent/message-stream`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Accept: 'text/event-stream',
+                },
+                body: JSON.stringify({
+                    sessionId: input.sessionId,
+                    content: input.content,
+                }),
+                ...(input.signal ? { signal: input.signal } : {}),
+            });
+            const response = await responsePromise;
+            if (response.status === 202 &&
+                response.headers.get('content-type')?.includes('application/json')) {
+                const busyPayload = await response.json().catch(() => null);
+                const parsed = z
+                    .object({
+                    hint: z.string().optional(),
+                })
+                    .passthrough()
+                    .safeParse(busyPayload);
+                throw new Error(parsed.success
+                    ? (parsed.data.hint ?? 'Cloud session is busy')
+                    : 'Cloud session is busy');
+            }
+            return createMessageStream(Promise.resolve(response), {
+                ...(input.signal ? { signal: input.signal } : {}),
+            });
+        },
     };
 }

package/dist/cli/commands/deploy/index.d.ts

@@ -7,5 +7,6 @@ export declare function handleDeployOpenCommand(): Promise<void>;
 export declare function handleDeployStatusCommand(): Promise<void>;
 export declare function handleDeployStopCommand(): Promise<void>;
 export declare function handleDeployDeleteCommand(options?: InteractiveOptions): Promise<void>;
+export declare function handleDeployChatCommand(cloudAgentId?: string): Promise<void>;
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/cli/commands/deploy/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/deploy/index.ts"],"names":[],"mappings":"AA4BA,UAAU,kBAAkB;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAyHD,wBAAsB,mBAAmB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8ErF;AAED,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CAiD7D;AAED,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CAqB7D;AAED,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC,CAkB/D;AAED,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CA4B7D;AAED,wBAAsB,yBAAyB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2C3F"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/deploy/index.ts"],"names":[],"mappings":"AA6BA,UAAU,kBAAkB;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AA4MD,wBAAsB,mBAAmB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8ErF;AAED,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CAiD7D;AAED,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CAqB7D;AAED,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC,CAkB/D;AAED,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CA4B7D;AAED,wBAAsB,yBAAyB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2C3F;AAED,wBAAsB,uBAAuB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOlF"}

package/dist/cli/commands/deploy/index.js

@@ -12,6 +12,7 @@ import { discoverPrimaryWorkspaceAgent, isAgentYamlPath } from './entry-agent.js
 import { getCloudAgentDashboardUrl } from './links.js';
 import { loadWorkspaceDeployLink, removeWorkspaceDeployLink, saveWorkspaceDeployLink, } from './state.js';
 import { createWorkspaceSnapshot } from './snapshot.js';
+import { startCloudChatCli } from '../../cloud-chat.js';
 function isInteractive(options) {
     return options?.interactive !== false;
 }
@@ -58,6 +59,70 @@ function formatCloudAgentListItem(cloudAgent, linkedToWorkspace) {
     }
     return lines.join('\n');
 }
+function formatCloudAgentSelectionLabel(cloudAgent) {
+    const trimmedName = cloudAgent.name?.trim();
+    const heading = trimmedName && trimmedName !== cloudAgent.cloudAgentId
+        ? `${trimmedName} (${cloudAgent.cloudAgentId})`
+        : cloudAgent.cloudAgentId;
+    return `${heading} ${chalk.gray('[')}${formatCloudAgentStatus(cloudAgent.state.status)}${chalk.gray(']')}`;
+}
+function sortCloudAgentsForChat(cloudAgents, linkedCloudAgentId) {
+    return cloudAgents.slice().sort((left, right) => {
+        const leftIsLinked = linkedCloudAgentId !== null && left.cloudAgentId === linkedCloudAgentId;
+        const rightIsLinked = linkedCloudAgentId !== null && right.cloudAgentId === linkedCloudAgentId;
+        if (leftIsLinked !== rightIsLinked) {
+            return leftIsLinked ? -1 : 1;
+        }
+        const leftReady = left.state.status === 'ready';
+        const rightReady = right.state.status === 'ready';
+        if (leftReady !== rightReady) {
+            return leftReady ? -1 : 1;
+        }
+        const leftName = (left.name?.trim() || left.cloudAgentId).toLowerCase();
+        const rightName = (right.name?.trim() || right.cloudAgentId).toLowerCase();
+        return leftName.localeCompare(rightName);
+    });
+}
+async function selectCloudAgentForChat(workspaceRoot) {
+    const deployLink = await loadWorkspaceDeployLink(workspaceRoot);
+    const spinner = p.spinner();
+    spinner.start('Loading cloud agents...');
+    const client = createDeployClient();
+    let cloudAgents;
+    try {
+        cloudAgents = await client.listCloudAgents();
+    }
+    catch (error) {
+        spinner.stop(chalk.red('✗ Failed to load cloud agents'));
+        throw error;
+    }
+    spinner.stop(chalk.green('✓ Cloud agents loaded'));
+    if (cloudAgents.length === 0) {
+        throw new Error('No cloud agents available yet. Run `dexto deploy` first, or pass a cloud agent ID explicitly.');
+    }
+    const linkedCloudAgentId = deployLink?.cloudAgentId ?? null;
+    const sortedCloudAgents = sortCloudAgentsForChat(cloudAgents, linkedCloudAgentId);
+    const selected = await p.select({
+        message: 'Choose a cloud agent to chat with',
+        options: sortedCloudAgents.map((cloudAgent) => {
+            const isLinked = linkedCloudAgentId !== null && cloudAgent.cloudAgentId === linkedCloudAgentId;
+            const hintParts = [cloudAgent.agentUrl];
+            if (isLinked) {
+                hintParts.unshift('Linked to this workspace');
+            }
+            return {
+                value: cloudAgent.cloudAgentId,
+                label: formatCloudAgentSelectionLabel(cloudAgent),
+                hint: hintParts.join(' • '),
+            };
+        }),
+    });
+    if (p.isCancel(selected)) {
+        p.cancel('Cloud chat cancelled');
+        process.exit(0);
+    }
+    return selected;
+}
 function resolveWorkspaceRoot() {
     return findDextoProjectRoot(process.cwd()) ?? process.cwd();
 }
@@ -295,3 +360,11 @@ export async function handleDeployDeleteCommand(options) {
         throw error;
     }
 }
+export async function handleDeployChatCommand(cloudAgentId) {
+    const workspaceRoot = resolveWorkspaceRoot();
+    const selectedCloudAgentId = cloudAgentId ?? (await selectCloudAgentForChat(workspaceRoot));
+    await startCloudChatCli({
+        cloudAgentId: selectedCloudAgentId,
+        workspaceRoot,
+    });
+}

package/dist/cli/commands/deploy/register.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/deploy/register.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,MAAM,WAAW,4BAA4B;IACzC,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,qBAAqB,CAAC,EAAE,OAAO,EAAE,EAAE,4BAA4B,GAAG,IAAI,CAqHrF"}
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/deploy/register.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,MAAM,WAAW,4BAA4B;IACzC,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,qBAAqB,CAAC,EAAE,OAAO,EAAE,EAAE,4BAA4B,GAAG,IAAI,CA4IrF"}

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

@@ -7,6 +7,8 @@ export function registerDeployCommand({ program }) {
 Examples:
   $ dexto deploy
   $ dexto deploy list
+  $ dexto deploy chat
+  $ dexto deploy chat sbx_123
   $ dexto deploy open
   $ dexto deploy status
   $ dexto deploy stop
@@ -25,6 +27,23 @@ Examples:
             safeExit('deploy', 1, 'error');
         }
     }));
+    deployCommand
+        .command('chat')
+        .description('Start Ink CLI chat against a selected or explicit cloud agent')
+        .argument('[cloudAgentId]', 'Cloud agent ID (omit to choose from your available cloud agents)')
+        .action(withAnalytics('deploy chat', async (cloudAgentId) => {
+        try {
+            const { handleDeployChatCommand } = await import('./index.js');
+            await handleDeployChatCommand(cloudAgentId);
+            safeExit('deploy chat', 0);
+        }
+        catch (err) {
+            if (err instanceof ExitSignal)
+                throw err;
+            console.error(`❌ dexto deploy chat command failed: ${err}`);
+            safeExit('deploy chat', 1, 'error');
+        }
+    }));
     deployCommand
         .command('list')
         .description('List cloud deployments for your account')

package/dist/index-main.js

@@ -100,6 +100,7 @@ program
     .description('AI-powered CLI and WebUI for interacting with MCP servers.')
     .version(cliVersion, '-v, --version', 'output the current version')
     .option('-a, --agent <id|path>', 'Agent ID or path to agent config file')
+    .option('--cloud-agent <id>', 'Connect the interactive CLI to a deployed cloud agent by ID')
     .option('-p, --prompt <text>', 'Start the interactive CLI and immediately run the prompt')
     .option('-s, --strict', 'Require all server connections to succeed')
     .option('--no-verbose', 'Disable verbose output')
@@ -445,8 +446,9 @@ program
     // the first positional argument as an agent name to avoid ambiguity with prompts.
     // ——— FORCE CLI MODE FOR PROMPT/SESSION FLAGS ———
     // If a prompt or session flag was provided, force CLI mode.
-    if ((initialPrompt || opts.continue || opts.resume) && opts.mode !== 'cli') {
-        console.error(`ℹ️  Forcing CLI mode due to --prompt/--continue/--resume.`);
+    if ((initialPrompt || opts.continue || opts.resume || opts.cloudAgent) &&
+        opts.mode !== 'cli') {
+        console.error(`ℹ️  Forcing CLI mode due to --prompt/--continue/--resume/--cloud-agent.`);
         console.error(`   Original mode: ${opts.mode} → Overridden to: cli`);
         opts.mode = 'cli';
     }
@@ -456,6 +458,28 @@ program
         console.error('💡 For non-interactive runs, use `dexto run "<prompt>"`, or use --mode server for automation.');
         safeExit('main', 1, 'no-tty');
     }
+    if (opts.cloudAgent) {
+        if (opts.agent) {
+            console.error('❌ `--agent` and `--cloud-agent` are mutually exclusive. Use one chat target at a time.');
+            safeExit('main', 1, 'cloud-agent-conflict');
+        }
+        try {
+            const { startCloudChatCli } = await import('./cli/cloud-chat.js');
+            await startCloudChatCli({
+                cloudAgentId: String(opts.cloudAgent),
+                ...(initialPrompt ? { initialPrompt } : {}),
+                ...(opts.resume ? { resume: String(opts.resume) } : {}),
+                ...(opts.continue ? { continueMostRecent: true } : {}),
+            });
+            safeExit('main', 0);
+        }
+        catch (err) {
+            if (err instanceof ExitSignal)
+                throw err;
+            console.error(`❌ Cloud chat failed: ${err}`);
+            safeExit('main', 1, 'cloud-chat-error');
+        }
+    }
     // ——— Infer provider & API key from model ———
     if (opts.model) {
         if (opts.model.includes('/')) {

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

@@ -1,4 +1,6 @@
-import type { DextoAgent } from '@dexto/core';
+interface ShutdownTarget {
+    stop?: (() => Promise<void>) | undefined;
+}
 export interface GracefulShutdownOptions {
     /**
      * When true, the first SIGINT is ignored to let the application handle it
@@ -11,5 +13,6 @@ export interface GracefulShutdownOptions {
      */
     forceExitTimeout?: number;
 }
-export declare function registerGracefulShutdown(getCurrentAgent: () => DextoAgent, 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":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C,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,UAAU,EACjC,OAAO,GAAE,uBAA4B,GACtC,IAAI,CA6GN"}
+{"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"}

package/dist/utils/graceful-shutdown.js

@@ -14,7 +14,9 @@ export function registerGracefulShutdown(getCurrentAgent, options = {}) {
         logger.info(`Received ${signal}, shutting down gracefully...`);
         try {
             const agent = getCurrentAgent();
-            await agent.stop();
+            if (typeof agent.stop === 'function') {
+                await agent.stop();
+            }
             process.exit(0);
         }
         catch (error) {
@@ -63,7 +65,9 @@ export function registerGracefulShutdown(getCurrentAgent, options = {}) {
             isShuttingDown = true;
             try {
                 const agent = getCurrentAgent();
-                await agent.stop();
+                if (typeof agent.stop === 'function') {
+                    await agent.stop();
+                }
             }
             catch (innerError) {
                 logger.error(`Error during shutdown initiated by uncaughtException: ${innerError instanceof Error ? innerError.message : String(innerError)}`, { error: innerError });
@@ -77,7 +81,9 @@ export function registerGracefulShutdown(getCurrentAgent, options = {}) {
             isShuttingDown = true;
             try {
                 const agent = getCurrentAgent();
-                await agent.stop();
+                if (typeof agent.stop === 'function') {
+                    await agent.stop();
+                }
             }
             catch (innerError) {
                 logger.error(`Error during shutdown initiated by unhandledRejection: ${innerError instanceof Error ? innerError.message : String(innerError)}`, { error: innerError });