@aiden-ade/sandbox-agent 0.1.15 → 0.1.16

package/dist/sandbox.js

@@ -0,0 +1,185 @@
+/**
+ * Sandbox mode: connects to WS server, runs CoreAgent in a multi-turn loop.
+ * Runs INSIDE the E2B sandbox.
+ */
+import { CoreAgent } from "./core-agent.js";
+import { WebPresenter } from "./web-presenter.js";
+import { WSClient } from "./ws-client.js";
+import { AGENT_VERSION } from "./version.js";
+export async function runSandbox(config) {
+    let currentTask = config.task;
+    let currentImages = [];
+    let stopped = false;
+    let pendingMessageResolve = null;
+    let currentAgent = null;
+    // Per-turn enrichment state — updated from each incoming WS payload.
+    // Seeded from config for the first turn; overwritten on every subsequent turn.
+    let currentTaskMeta = undefined;
+    let currentWorkflowTools = undefined;
+    let currentMaxIterations = config.maxIterations ?? 50;
+    let currentTaskId = config.taskId;
+    let currentConversationId = config.sessionId;
+    let currentTeamId = config.teamId;
+    let currentUser = config.currentUser;
+    console.info("[sandbox] Connecting to WS server", { wsUrl: config.wsUrl, sessionId: config.sessionId });
+    const wsClient = new WSClient(config.wsUrl, config.sessionId, config.taskId, config.sessionToken, {
+        onUserMessage: (payload) => {
+            if (pendingMessageResolve) {
+                const resolve = pendingMessageResolve;
+                pendingMessageResolve = null;
+                resolve(payload);
+            }
+            else {
+                console.warn("[sandbox] No handler for user message — dropped");
+            }
+        },
+        onStop: () => {
+            console.info("[sandbox] Stop signal received");
+            if (currentAgent) {
+                const killed = currentAgent.kill();
+                if (!killed)
+                    currentAgent.abort();
+            }
+        },
+        onToolResponse: (toolId, response) => {
+            if (currentAgent) {
+                const sent = currentAgent.sendToolResponse(toolId, response);
+                if (!sent) {
+                    console.warn("[sandbox] Failed to deliver tool_response to agent stdin", { toolId });
+                }
+            }
+            else {
+                console.warn("[sandbox] No active agent for tool_response", { toolId });
+            }
+        },
+        onConnect: () => console.info("[sandbox] WS connected"),
+        onDisconnect: (reason) => console.info(`[sandbox] WS disconnected: ${reason}`),
+    }, AGENT_VERSION);
+    try {
+        await wsClient.waitForConnection();
+    }
+    catch (error) {
+        console.error("[sandbox] Failed to connect to WS server:", error.message);
+        process.exit(1);
+    }
+    const presenter = new WebPresenter(wsClient, config.sessionId);
+    presenter.setSuppressSessionLifecycle(true);
+    let lastProviderSessionId = config.providerSessionId;
+    let activeBackendKind = config.backendKind || "claude_cli";
+    let activeAgentId = config.agentId;
+    let activeAgentPrompt = config.agentPrompt;
+    let activeModel = config.model;
+    let activeContextWindow = config.contextWindow;
+    let activeEffortLevel = config.effortLevel;
+    let activeMode = config.mode || "agent";
+    while (!stopped) {
+        if (currentTask?.trim()) {
+            const agent = new CoreAgent(presenter, {
+                backendKind: activeBackendKind,
+            });
+            currentAgent = agent;
+            let result;
+            try {
+                result = await agent.run({
+                    task: currentTask,
+                    maxIterations: currentMaxIterations,
+                    teamPath: config.projectPath,
+                    cwd: config.projectPath,
+                    backendKind: activeBackendKind,
+                    agentId: activeAgentId,
+                    agentPrompt: activeAgentPrompt,
+                    mode: activeMode,
+                    selectedModel: activeModel,
+                    selectedContextWindow: activeContextWindow ?? null,
+                    selectedEffortLevel: activeEffortLevel ?? null,
+                    providerSessionId: lastProviderSessionId ?? undefined,
+                    taskMeta: currentTaskMeta,
+                    taskId: currentTaskId,
+                    conversationId: currentConversationId,
+                    teamId: currentTeamId,
+                    currentUser,
+                    workflowTools: currentWorkflowTools,
+                    images: currentImages.length > 0
+                        ? currentImages.map((img) => ({
+                            id: img.id,
+                            data: img.data,
+                            mimeType: img.mimeType,
+                            filename: img.filename,
+                            width: 0,
+                            height: 0,
+                        }))
+                        : undefined,
+                });
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                console.error("[sandbox] Agent run failed:", errorMessage);
+                result = { success: false, summary: "Agent run failed", filesModified: [], planFilesCreated: [], iterations: 0, error: errorMessage };
+            }
+            currentAgent = null;
+            if (result?.providerSessionId) {
+                lastProviderSessionId = result.providerSessionId;
+            }
+            if (stopped)
+                break;
+        }
+        // Wait for next user message
+        const nextPayload = await new Promise((resolve) => {
+            pendingMessageResolve = resolve;
+        });
+        if (nextPayload === null || stopped) {
+            break;
+        }
+        currentTask = nextPayload.text;
+        currentImages = nextPayload.images ?? [];
+        if (nextPayload.providerSessionId) {
+            lastProviderSessionId = nextPayload.providerSessionId;
+        }
+        if (nextPayload.backendKind) {
+            activeBackendKind = nextPayload.backendKind;
+        }
+        if (nextPayload.agentId !== undefined) {
+            activeAgentId = nextPayload.agentId;
+        }
+        if (nextPayload.agentPrompt !== undefined) {
+            activeAgentPrompt = nextPayload.agentPrompt;
+        }
+        if (nextPayload.selectedModel) {
+            activeModel = nextPayload.selectedModel;
+        }
+        if (nextPayload.selectedContextWindow !== undefined) {
+            activeContextWindow = nextPayload.selectedContextWindow;
+        }
+        if (nextPayload.selectedEffortLevel !== undefined) {
+            activeEffortLevel = nextPayload.selectedEffortLevel;
+        }
+        if (nextPayload.mode) {
+            activeMode = nextPayload.mode;
+        }
+        // Update per-turn enrichment fields from the incoming payload
+        if (nextPayload.taskMeta !== undefined) {
+            currentTaskMeta = nextPayload.taskMeta;
+        }
+        if (nextPayload.workflowTools !== undefined) {
+            currentWorkflowTools = nextPayload.workflowTools;
+        }
+        if (nextPayload.maxIterations !== undefined) {
+            currentMaxIterations = nextPayload.maxIterations;
+        }
+        if (nextPayload.taskId !== undefined) {
+            currentTaskId = nextPayload.taskId;
+        }
+        if (nextPayload.conversationId !== undefined) {
+            currentConversationId = nextPayload.conversationId;
+        }
+        if (nextPayload.currentUser !== undefined) {
+            currentUser = nextPayload.currentUser;
+        }
+        if (nextPayload.teamId !== undefined) {
+            currentTeamId = nextPayload.teamId;
+        }
+    }
+    presenter.setSuppressSessionLifecycle(false);
+    wsClient.close();
+}
+//# sourceMappingURL=sandbox.js.map

package/dist/sandbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.js","sourceRoot":"","sources":["../src/sandbox.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Re-exports from the canonical shared agent types.
+ * Single source of truth: packages/shared/src/agent/types.ts
+ */
+export * from "@aiden/shared/agent";
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,qBAAqB,CAAC"}

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * Re-exports from the canonical shared agent types.
+ * Single source of truth: packages/shared/src/agent/types.ts
+ */
+export * from "@aiden/shared/agent";
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,qBAAqB,CAAC"}

package/dist/updater.d.ts

@@ -0,0 +1,15 @@
+export interface UpdatePayload {
+    devMode: boolean;
+    version?: string;
+}
+/**
+ * Install the new agent version via npm.
+ * Returns true if the install succeeded.
+ */
+export declare function installUpdate(payload: UpdatePayload): Promise<boolean>;
+/**
+ * Spawn a new agent process with the same env vars, then exit this process.
+ * Preserves the provider session ID so the new agent can resume Claude context.
+ */
+export declare function respawnAgent(lastProviderSessionId?: string): void;
+//# sourceMappingURL=updater.d.ts.map

package/dist/updater.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updater.d.ts","sourceRoot":"","sources":["../src/updater.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAe5E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAmBjE"}

package/dist/updater.js

@@ -0,0 +1,50 @@
+/**
+ * Self-update logic for the sandbox agent.
+ * In prod/staging, installs the new version from npm.
+ */
+import { execSync, spawn } from "node:child_process";
+const DEFAULT_PATH = "/home/user/.local/node/bin:/home/user/.local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin";
+/**
+ * Install the new agent version via npm.
+ * Returns true if the install succeeded.
+ */
+export async function installUpdate(payload) {
+    const version = payload.version ?? "latest";
+    try {
+        console.info(`[updater] Installing @aiden-ade/sandbox-agent@${version} via npm`);
+        execSync(`npm install -g @aiden-ade/sandbox-agent@${version}`, {
+            timeout: 60_000,
+            env: { ...process.env, PATH: DEFAULT_PATH },
+            stdio: "pipe",
+        });
+        console.info("[updater] npm install complete");
+        return true;
+    }
+    catch (error) {
+        console.error("[updater] npm install failed:", error.message);
+        return false;
+    }
+}
+/**
+ * Spawn a new agent process with the same env vars, then exit this process.
+ * Preserves the provider session ID so the new agent can resume Claude context.
+ */
+export function respawnAgent(lastProviderSessionId) {
+    const env = { ...process.env };
+    if (lastProviderSessionId) {
+        env.AIDEN_PROVIDER_SESSION_ID = lastProviderSessionId;
+    }
+    console.info("[updater] Spawning new agent process");
+    const child = spawn("aiden-agent", [], {
+        detached: true,
+        stdio: "ignore",
+        env: { ...env, PATH: DEFAULT_PATH },
+    });
+    child.unref();
+    // Give the new process a moment to start before we exit
+    setTimeout(() => {
+        console.info("[updater] Old agent exiting after respawn");
+        process.exit(0);
+    }, 500);
+}
+//# sourceMappingURL=updater.js.map

package/dist/updater.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updater.js","sourceRoot":"","sources":["../src/updater.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,YAAY,GAAG,+GAA+G,CAAC;AAOrI;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAsB;IACxD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,QAAQ,CAAC;IAC5C,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,iDAAiD,OAAO,UAAU,CAAC,CAAC;QACjF,QAAQ,CAAC,2CAA2C,OAAO,EAAE,EAAE;YAC7D,OAAO,EAAE,MAAM;YACf,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE;YAC3C,KAAK,EAAE,MAAM;SACd,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;QACzE,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,qBAA8B;IACzD,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC/B,IAAI,qBAAqB,EAAE,CAAC;QAC1B,GAAG,CAAC,yBAAyB,GAAG,qBAAqB,CAAC;IACxD,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,KAAK,CAAC,aAAa,EAAE,EAAE,EAAE;QACrC,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,QAAQ;QACf,GAAG,EAAE,EAAE,GAAG,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE;KACpC,CAAC,CAAC;IACH,KAAK,CAAC,KAAK,EAAE,CAAC;IAEd,wDAAwD;IACxD,UAAU,CAAC,GAAG,EAAE;QACd,OAAO,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;QAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,EAAE,GAAG,CAAC,CAAC;AACV,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const AGENT_VERSION = "0.1.8";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,UAAU,CAAC"}

package/dist/version.js

@@ -0,0 +1,2 @@
+export const AGENT_VERSION = "0.1.8";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC"}

package/dist/web-presenter.d.ts

@@ -0,0 +1,33 @@
+import type { WSClient } from "./ws-client.js";
+import type { AgentConfig, AgentResult, ExitPlanModeInput, UsageUpdate } from "./types.js";
+import type { AgentPresenter } from "./types.js";
+export declare class WebPresenter implements AgentPresenter {
+    private wsClient;
+    private conversationId;
+    private suppressSessionLifecycle;
+    constructor(wsClient: WSClient, conversationId: string);
+    setSuppressSessionLifecycle(suppress: boolean): void;
+    onStart(config: AgentConfig): void;
+    onLog(message: string): void;
+    onAssistantText(text: string): void;
+    onThinking(text: string): void;
+    onToolUse(tool: string, input: unknown, toolId: string): void;
+    onToolResult(toolId: string, content: string, isError?: boolean): void;
+    onTurnComplete(content: unknown[]): void;
+    onUsageUpdate(usage: UsageUpdate): void;
+    onAskUser(id: string, questions: unknown[]): void;
+    onTodoWrite(todos: unknown[]): void;
+    onExitPlanMode(id: string, input: ExitPlanModeInput, planFilePath?: string): void;
+    onCheckpoint(id: string): void;
+    onActivity(status: string): void;
+    onOpenBrowserTab(browserId: string, url?: string): void;
+    recordRawTranscript(): void;
+    onError(message: string, _isAgentError?: boolean): void;
+    onComplete(result: AgentResult): void;
+    /**
+     * Manually emit session lifecycle events and close.
+     * Called after the multi-turn loop exits.
+     */
+    emitSessionEnd(result: AgentResult): Promise<void>;
+}
+//# sourceMappingURL=web-presenter.d.ts.map

package/dist/web-presenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-presenter.d.ts","sourceRoot":"","sources":["../src/web-presenter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAc,WAAW,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACvG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,qBAAa,YAAa,YAAW,cAAc;IACjD,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,wBAAwB,CAAS;gBAE7B,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM;IAKtD,2BAA2B,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAIpD,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAIlC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAInC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI9B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAI7D,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI;IAUtE,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI;IAIxC,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAIvC,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI;IAIjD,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI;IAInC,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI;IAIjF,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI9B,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIhC,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAIvD,mBAAmB,IAAI,IAAI;IAI3B,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,IAAI;IAQvD,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAkBrC;;;OAGG;IACG,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAQzD"}

package/dist/web-presenter.js

@@ -0,0 +1,100 @@
+export class WebPresenter {
+    wsClient;
+    conversationId;
+    suppressSessionLifecycle = false;
+    constructor(wsClient, conversationId) {
+        this.wsClient = wsClient;
+        this.conversationId = conversationId;
+    }
+    setSuppressSessionLifecycle(suppress) {
+        this.suppressSessionLifecycle = suppress;
+    }
+    onStart(config) {
+        this.wsClient.emitEvent({ type: "start", task: config.task, ts: Date.now() });
+    }
+    onLog(message) {
+        console.error(message);
+    }
+    onAssistantText(text) {
+        this.wsClient.emitEvent({ type: "text", text, ts: Date.now() });
+    }
+    onThinking(text) {
+        this.wsClient.emitEvent({ type: "thinking", text, ts: Date.now() });
+    }
+    onToolUse(tool, input, toolId) {
+        this.wsClient.emitEvent({ type: "tool_use", id: toolId, name: tool, input, ts: Date.now() });
+    }
+    onToolResult(toolId, content, isError) {
+        this.wsClient.emitEvent({
+            type: "tool_result",
+            id: toolId,
+            content,
+            ts: Date.now(),
+            ...(isError ? { is_error: true } : {}),
+        });
+    }
+    onTurnComplete(content) {
+        this.wsClient.emitEvent({ type: "turn_complete", content, ts: Date.now() });
+    }
+    onUsageUpdate(usage) {
+        this.wsClient.emitEvent({ type: "usage", usage });
+    }
+    onAskUser(id, questions) {
+        this.wsClient.emitEvent({ type: "ask_user", id, questions });
+    }
+    onTodoWrite(todos) {
+        this.wsClient.emitEvent({ type: "todo_write", todos });
+    }
+    onExitPlanMode(id, input, planFilePath) {
+        this.wsClient.emitEvent({ type: "exit_plan_mode", id, input, ...(planFilePath ? { planFilePath } : {}) });
+    }
+    onCheckpoint(id) {
+        this.wsClient.emitEvent({ type: "checkpoint", id });
+    }
+    onActivity(status) {
+        this.wsClient.emitEvent({ type: "activity", status, ts: Date.now() });
+    }
+    onOpenBrowserTab(browserId, url) {
+        this.wsClient.emitEvent({ type: "open_browser_tab", browserId, ...(url ? { url } : {}) });
+    }
+    recordRawTranscript() {
+        // No-op for sandbox — raw transcripts stay in the container
+    }
+    onError(message, _isAgentError) {
+        this.wsClient.emitEvent({ type: "error", message });
+        if (!this.suppressSessionLifecycle) {
+            this.wsClient.emitEvent({ type: "session_error", error: message });
+            this.wsClient.close();
+        }
+    }
+    onComplete(result) {
+        // Always send query_complete so the server persists query content
+        this.wsClient.emitEvent({ type: "query_complete", result, ts: Date.now() });
+        // In multi-turn mode (suppressSessionLifecycle=true), skip session lifecycle
+        if (this.suppressSessionLifecycle) {
+            return;
+        }
+        // Single-turn mode: also send session lifecycle event and close
+        if (result.success) {
+            this.wsClient.emitEvent({ type: "session_complete", result });
+        }
+        else {
+            this.wsClient.emitEvent({ type: "session_error", error: result.error || "Unknown error" });
+        }
+        this.wsClient.close();
+    }
+    /**
+     * Manually emit session lifecycle events and close.
+     * Called after the multi-turn loop exits.
+     */
+    async emitSessionEnd(result) {
+        if (result.success) {
+            this.wsClient.emitEvent({ type: "session_complete", result });
+        }
+        else {
+            this.wsClient.emitEvent({ type: "session_error", error: result.error || "Unknown error" });
+        }
+        this.wsClient.close();
+    }
+}
+//# sourceMappingURL=web-presenter.js.map

package/dist/web-presenter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-presenter.js","sourceRoot":"","sources":["../src/web-presenter.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,YAAY;IACf,QAAQ,CAAW;IACnB,cAAc,CAAS;IACvB,wBAAwB,GAAG,KAAK,CAAC;IAEzC,YAAY,QAAkB,EAAE,cAAsB;QACpD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACvC,CAAC;IAED,2BAA2B,CAAC,QAAiB;QAC3C,IAAI,CAAC,wBAAwB,GAAG,QAAQ,CAAC;IAC3C,CAAC;IAED,OAAO,CAAC,MAAmB;QACzB,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,KAAK,CAAC,OAAe;QACnB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAED,eAAe,CAAC,IAAY;QAC1B,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,SAAS,CAAC,IAAY,EAAE,KAAc,EAAE,MAAc;QACpD,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC/F,CAAC;IAED,YAAY,CAAC,MAAc,EAAE,OAAe,EAAE,OAAiB;QAC7D,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;YACtB,IAAI,EAAE,aAAa;YACnB,EAAE,EAAE,MAAM;YACV,OAAO;YACP,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;YACd,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvC,CAAC,CAAC;IACL,CAAC;IAED,cAAc,CAAC,OAAkB;QAC/B,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,aAAa,CAAC,KAAkB;QAC9B,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,SAAS,CAAC,EAAU,EAAE,SAAoB;QACxC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,WAAW,CAAC,KAAgB;QAC1B,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,cAAc,CAAC,EAAU,EAAE,KAAwB,EAAE,YAAqB;QACxE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAC5G,CAAC;IAED,YAAY,CAAC,EAAU;QACrB,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,UAAU,CAAC,MAAc;QACvB,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,gBAAgB,CAAC,SAAiB,EAAE,GAAY;QAC9C,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,mBAAmB;QACjB,4DAA4D;IAC9D,CAAC;IAED,OAAO,CAAC,OAAe,EAAE,aAAuB;QAC9C,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,CAAC,wBAAwB,EAAE,CAAC;YACnC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YACnE,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;IAED,UAAU,CAAC,MAAmB;QAC5B,kEAAkE;QAClE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAE5E,6EAA6E;QAC7E,IAAI,IAAI,CAAC,wBAAwB,EAAE,CAAC;YAClC,OAAO;QACT,CAAC;QAED,gEAAgE;QAChE,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,CAAC,CAAC;QAChE,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,eAAe,EAAE,CAAC,CAAC;QAC7F,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,cAAc,CAAC,MAAmB;QACtC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,CAAC,CAAC;QAChE,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,eAAe,EAAE,CAAC,CAAC;QAC7F,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/ws-client.d.ts

@@ -0,0 +1,79 @@
+import type { AgentEvent } from "./types.js";
+export interface ResolvedImage {
+    id: string;
+    data: string;
+    mimeType: string;
+    filename: string;
+}
+export interface UserMessagePayload {
+    text: string;
+    images?: ResolvedImage[];
+    providerSessionId?: string;
+    backendKind?: string;
+    agentId?: string;
+    agentPrompt?: string;
+    selectedModel?: string;
+    selectedContextWindow?: string | null;
+    selectedEffortLevel?: string | null;
+    mode?: string;
+    /** Structured task metadata for system prompt injection. */
+    taskMeta?: {
+        id: string;
+        title: string;
+        description: string | null;
+        status: string;
+        priority: string;
+        labels: string[] | null;
+        assignees: Array<{
+            name: string | null;
+            email: string;
+        }>;
+        descriptionAttachmentIds?: Array<{
+            id: string;
+            filename: string;
+        }>;
+    };
+    /** Workflow tool allowlist (present when triggered from a workflow). */
+    workflowTools?: Array<{
+        type: string;
+        id: string;
+    }>;
+    /** Agent run ID for status tracking. */
+    runId?: string;
+    /** Message ID that triggered this run. */
+    messageId?: string;
+    /** Maximum number of agent iterations. */
+    maxIterations?: number;
+    /** Task ID for MCP artifact creation. */
+    taskId?: string;
+    /** Conversation ID for MCP artifact creation. */
+    conversationId?: string;
+    /** Role attached to this conversation. */
+    /** Team ID of the active team context — injected into system prompt for MCP calls. */
+    teamId?: string;
+    /** User who initiated the run. */
+    currentUser?: {
+        id: string;
+        name: string | null;
+        email: string;
+    };
+}
+export interface WSClientCallbacks {
+    onUserMessage: (payload: UserMessagePayload) => void;
+    onStop: () => void;
+    onToolResponse?: (toolId: string, response: string) => void;
+    onConnect?: () => void;
+    onDisconnect?: (reason: string) => void;
+}
+export declare class WSClient {
+    private socket;
+    constructor(wsUrl: string, sessionId: string, // conversationId
+    taskId: string, token: string, // sandboxSessionToken
+    callbacks: WSClientCallbacks, agentVersion?: string);
+    emitEvent(event: AgentEvent): void;
+    waitForConnection(timeoutMs?: number): Promise<void>;
+    get connected(): boolean;
+    close(): void;
+    private setupListeners;
+}
+//# sourceMappingURL=ws-client.d.ts.map

package/dist/ws-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-client.d.ts","sourceRoot":"","sources":["../src/ws-client.ts"],"names":[],"mappings":"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"}

package/dist/ws-client.js

@@ -0,0 +1,74 @@
+import { io } from "socket.io-client";
+export class WSClient {
+    socket;
+    constructor(wsUrl, sessionId, // conversationId
+    taskId, token, // sandboxSessionToken
+    callbacks, agentVersion) {
+        this.socket = io(wsUrl, {
+            query: { type: "agent", sessionId, taskId, agentVersion: agentVersion ?? "" },
+            auth: { token },
+            transports: ["websocket"],
+            reconnection: true,
+            reconnectionAttempts: Infinity,
+            reconnectionDelay: 1000,
+            reconnectionDelayMax: 5000,
+            timeout: 20_000,
+            upgrade: false,
+            extraHeaders: { "ngrok-skip-browser-warning": "1" },
+        });
+        this.setupListeners(callbacks);
+    }
+    emitEvent(event) {
+        this.socket.emit("agent_event", event);
+    }
+    waitForConnection(timeoutMs = 15000) {
+        return new Promise((resolve, reject) => {
+            if (this.socket.connected) {
+                resolve();
+                return;
+            }
+            const timeout = setTimeout(() => reject(new Error(`WSClient connection timeout after ${timeoutMs}ms`)), timeoutMs);
+            this.socket.once("connect", () => { clearTimeout(timeout); resolve(); });
+            this.socket.once("connect_error", (err) => { clearTimeout(timeout); reject(new Error(`WSClient connection failed: ${err.message}`)); });
+        });
+    }
+    get connected() { return this.socket.connected; }
+    close() { this.socket.disconnect(); }
+    setupListeners(callbacks) {
+        this.socket.on("connect", () => { console.debug("[WSClient] Connected to WS server"); callbacks.onConnect?.(); });
+        this.socket.on("disconnect", (reason) => { console.debug(`[WSClient] Disconnected: ${reason}`); callbacks.onDisconnect?.(reason); });
+        this.socket.on("connect_error", (error) => { console.warn(`[WSClient] Connection error: ${error.message}`); });
+        this.socket.on("user_message", (data, ack) => {
+            ack?.({ ok: true });
+            callbacks.onUserMessage({
+                text: data.text,
+                images: data.images,
+                providerSessionId: data.providerSessionId,
+                backendKind: data.backendKind,
+                agentId: data.agentId,
+                agentPrompt: data.agentPrompt,
+                selectedModel: data.selectedModel,
+                selectedContextWindow: data.selectedContextWindow,
+                selectedEffortLevel: data.selectedEffortLevel,
+                mode: data.mode,
+                taskMeta: data.taskMeta,
+                workflowTools: data.workflowTools,
+                runId: data.runId,
+                messageId: data.messageId,
+                maxIterations: data.maxIterations,
+                taskId: data.taskId,
+                conversationId: data.conversationId,
+                teamId: data.teamId,
+                currentUser: data.currentUser,
+            });
+        });
+        this.socket.on("stop", () => { callbacks.onStop(); });
+        this.socket.on("tool_response", (data) => {
+            if (data?.toolId && typeof data.response === "string") {
+                callbacks.onToolResponse?.(data.toolId, data.response);
+            }
+        });
+        this.socket.on("error", (data) => { console.error(`[WSClient] Server error: ${data.message} (${data.code})`); });
+    }
+}
+//# sourceMappingURL=ws-client.js.map

package/dist/ws-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-client.js","sourceRoot":"","sources":["../src/ws-client.ts"],"names":[],"mappings":"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"}