@nodetool-ai/websocket 0.7.0-rc.11

package/dist/agent/codex-agent.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Codex SDK agent integration.
+ *
+ * Uses the official @openai/codex-sdk to manage threads and stream events.
+ */
+import type { AgentTransport } from "./transport.js";
+import type { AgentMessage, AgentModelDescriptor, FrontendToolManifest } from "./types.js";
+export declare function listCodexModels(): Promise<AgentModelDescriptor[]>;
+export declare class CodexQuerySession {
+    private closed;
+    private readonly model;
+    private readonly workspacePath;
+    private readonly systemPrompt;
+    private readonly reasoningEffort;
+    private threadId;
+    private inFlight;
+    private abortController;
+    constructor(options: {
+        model: string;
+        workspacePath: string;
+        resumeSessionId?: string;
+        systemPrompt?: string;
+        reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh";
+    });
+    private escapeTomlString;
+    /**
+     * Write a managed `[mcp_servers.nodetool-ui]` block to the project-scoped
+     * `.codex/config.toml` so Codex discovers the NodeTool MCP server before
+     * the thread starts.
+     */
+    private ensureMcpConfig;
+    private getThread;
+    private buildPrompt;
+    send(message: string, _transport: AgentTransport | null, sessionId: string, manifest: FrontendToolManifest[], onMessage?: (message: AgentMessage) => void, mcpServerUrl?: string | null): Promise<AgentMessage[]>;
+    private convertEvent;
+    private convertItemToStreamMessage;
+    private convertCompletedItem;
+    interrupt(): Promise<void>;
+    close(): void;
+}
+//# sourceMappingURL=codex-agent.d.ts.map

package/dist/agent/codex-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-agent.d.ts","sourceRoot":"","sources":["../../src/agent/codex-agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiBH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EACV,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAepB,wBAAsB,eAAe,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAKvE;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAMlB;IACd,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,eAAe,CAAgC;gBAE3C,OAAO,EAAE;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,eAAe,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;KACnE;IAQD,OAAO,CAAC,gBAAgB;IAIxB;;;;OAIG;YACW,eAAe;IAsD7B,OAAO,CAAC,SAAS;IAsBjB,OAAO,CAAC,WAAW;IAiBb,IAAI,CACR,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,cAAc,GAAG,IAAI,EACjC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,oBAAoB,EAAE,EAChC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,EAC3C,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAC3B,OAAO,CAAC,YAAY,EAAE,CAAC;IA2E1B,OAAO,CAAC,YAAY;IAsCpB,OAAO,CAAC,0BAA0B;IAkGlC,OAAO,CAAC,oBAAoB;IA6BtB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAMhC,KAAK,IAAI,IAAI;CASd"}

package/dist/agent/codex-agent.js

@@ -0,0 +1,334 @@
+/**
+ * Codex SDK agent integration.
+ *
+ * Uses the official @openai/codex-sdk to manage threads and stream events.
+ */
+import { randomUUID } from "node:crypto";
+import { mkdirSync, writeFileSync, readFileSync, existsSync, } from "node:fs";
+import { join } from "node:path";
+import { createLogger } from "@nodetool-ai/config";
+import { Codex, } from "@openai/codex-sdk";
+const log = createLogger("nodetool.websocket.agent.codex");
+const NODETOOL_MCP_BEGIN = "# BEGIN NODETOOL MCP";
+const NODETOOL_MCP_END = "# END NODETOOL MCP";
+let codexInstance = null;
+function getCodex() {
+    if (!codexInstance) {
+        codexInstance = new Codex();
+    }
+    return codexInstance;
+}
+export async function listCodexModels() {
+    return [
+        { id: "gpt-5.4", label: "GPT-5.4", isDefault: true, provider: "codex" },
+        { id: "gpt-5.4-mini", label: "GPT-5.4 Mini", provider: "codex" },
+    ];
+}
+export class CodexQuerySession {
+    closed = false;
+    model;
+    workspacePath;
+    systemPrompt;
+    reasoningEffort;
+    threadId;
+    inFlight = false;
+    abortController = null;
+    constructor(options) {
+        this.model = options.model;
+        this.workspacePath = options.workspacePath;
+        this.systemPrompt = options.systemPrompt ?? "";
+        this.reasoningEffort = options.reasoningEffort;
+        this.threadId = options.resumeSessionId ?? null;
+    }
+    escapeTomlString(value) {
+        return value.replaceAll("\\", "\\\\").replaceAll('"', '\\"');
+    }
+    /**
+     * Write a managed `[mcp_servers.nodetool-ui]` block to the project-scoped
+     * `.codex/config.toml` so Codex discovers the NodeTool MCP server before
+     * the thread starts.
+     */
+    async ensureMcpConfig(mcpServerUrl) {
+        if (!mcpServerUrl) {
+            log.warn("MCP tool server URL not available for Codex session");
+            return;
+        }
+        const codexDir = join(this.workspacePath, ".codex");
+        const configPath = join(codexDir, "config.toml");
+        const managedBlock = [
+            NODETOOL_MCP_BEGIN,
+            "[mcp_servers.nodetool-ui]",
+            `url = "${this.escapeTomlString(mcpServerUrl)}"`,
+            'startup_timeout_sec = 20',
+            'tool_timeout_sec = 60',
+            "enabled = true",
+            "required = true",
+            NODETOOL_MCP_END,
+            "",
+        ].join("\n");
+        try {
+            mkdirSync(codexDir, { recursive: true });
+            const existing = existsSync(configPath)
+                ? readFileSync(configPath, "utf8")
+                : "";
+            const managedPattern = new RegExp(`${NODETOOL_MCP_BEGIN}[\\s\\S]*?${NODETOOL_MCP_END}\\n?`, "m");
+            const nextConfig = managedPattern.test(existing)
+                ? existing.replace(managedPattern, managedBlock)
+                : existing.trim().length > 0
+                    ? `${existing.trimEnd()}\n\n${managedBlock}`
+                    : managedBlock;
+            if (nextConfig === existing) {
+                return;
+            }
+            log.info(existing.length > 0
+                ? `Updating NodeTool MCP server in ${configPath}`
+                : `Creating ${configPath} for Codex MCP integration`);
+            writeFileSync(configPath, nextConfig, "utf8");
+        }
+        catch (error) {
+            log.warn(`Failed to write .codex/config.toml: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    getThread() {
+        const codex = getCodex();
+        const threadOptions = {
+            model: this.model,
+            workingDirectory: this.workspacePath,
+            skipGitRepoCheck: true,
+            approvalPolicy: "never",
+            sandboxMode: "workspace-write",
+            ...(this.reasoningEffort && {
+                modelReasoningEffort: this.reasoningEffort,
+            }),
+        };
+        if (this.threadId) {
+            log.info(`Resuming Codex thread: ${this.threadId}`);
+            return codex.resumeThread(this.threadId, threadOptions);
+        }
+        log.info(`Starting new Codex thread (model: ${this.model})`);
+        return codex.startThread(threadOptions);
+    }
+    buildPrompt(message, manifest) {
+        const manifestText = manifest.length > 0
+            ? `Available frontend UI tools in this session:\n${manifest
+                .map((tool) => `- ${tool.name}: ${tool.description}`)
+                .join("\n")}\n\n`
+            : "";
+        if (this.systemPrompt.trim().length > 0) {
+            return `System instructions:\n${this.systemPrompt}\n\nWorkspace: ${this.workspacePath}\n\n${manifestText}${message}`;
+        }
+        return `${manifestText}${message}`;
+    }
+    async send(message, _transport, sessionId, manifest, onMessage, mcpServerUrl) {
+        if (this.closed) {
+            throw new Error("Cannot send to a closed session");
+        }
+        if (this.inFlight) {
+            throw new Error("A Codex request is already in progress for this session");
+        }
+        this.inFlight = true;
+        this.abortController = new AbortController();
+        try {
+            await this.ensureMcpConfig(mcpServerUrl ?? null);
+            const thread = this.getThread();
+            const prompt = this.buildPrompt(message, manifest);
+            const { events } = await thread.runStreamed(prompt, {
+                signal: this.abortController.signal,
+            });
+            const outputMessages = [];
+            const itemTexts = new Map();
+            for await (const event of events) {
+                if (event.type === "thread.started") {
+                    this.threadId = event.thread_id;
+                    log.info(`Codex thread started: ${this.threadId}`);
+                    continue;
+                }
+                const agentMsg = this.convertEvent(event, sessionId, itemTexts);
+                if (!agentMsg)
+                    continue;
+                outputMessages.push(agentMsg);
+                if (onMessage) {
+                    onMessage(agentMsg);
+                }
+            }
+            const doneMsg = {
+                type: "system",
+                uuid: randomUUID(),
+                session_id: this.threadId ?? sessionId,
+            };
+            outputMessages.push(doneMsg);
+            if (onMessage) {
+                onMessage(doneMsg);
+            }
+            return outputMessages;
+        }
+        catch (error) {
+            if (this.abortController?.signal.aborted) {
+                log.info("Codex turn was interrupted");
+                return [];
+            }
+            const errorMsg = {
+                type: "result",
+                uuid: randomUUID(),
+                session_id: this.threadId ?? sessionId,
+                subtype: "error",
+                is_error: true,
+                errors: [error instanceof Error ? error.message : String(error)],
+            };
+            if (onMessage) {
+                onMessage(errorMsg);
+            }
+            return [errorMsg];
+        }
+        finally {
+            this.abortController = null;
+            this.inFlight = false;
+        }
+    }
+    convertEvent(event, sessionId, itemTexts) {
+        const resolvedSessionId = this.threadId ?? sessionId;
+        switch (event.type) {
+            case "item.started":
+            case "item.updated":
+                return this.convertItemToStreamMessage(event.item, resolvedSessionId, itemTexts);
+            case "item.completed":
+                return this.convertCompletedItem(event.item, resolvedSessionId, itemTexts);
+            case "turn.failed":
+                return {
+                    type: "result",
+                    uuid: randomUUID(),
+                    session_id: resolvedSessionId,
+                    subtype: "error",
+                    is_error: true,
+                    errors: [event.error.message],
+                };
+            default:
+                return null;
+        }
+    }
+    convertItemToStreamMessage(item, sessionId, itemTexts) {
+        if (item.type === "agent_message") {
+            const prev = itemTexts.get(item.id) ?? "";
+            if (item.text !== prev) {
+                itemTexts.set(item.id, item.text);
+                return {
+                    type: "assistant",
+                    uuid: item.id,
+                    session_id: sessionId,
+                    content: [{ type: "text", text: item.text }],
+                };
+            }
+            return null;
+        }
+        if (item.type === "command_execution") {
+            return {
+                type: "assistant",
+                uuid: item.id,
+                session_id: sessionId,
+                content: [],
+                tool_calls: [
+                    {
+                        id: item.id,
+                        type: "function",
+                        function: {
+                            name: "commandExecution",
+                            arguments: JSON.stringify({ command: item.command }),
+                        },
+                    },
+                ],
+            };
+        }
+        if (item.type === "file_change") {
+            return {
+                type: "assistant",
+                uuid: item.id,
+                session_id: sessionId,
+                content: [],
+                tool_calls: [
+                    {
+                        id: item.id,
+                        type: "function",
+                        function: {
+                            name: "fileChange",
+                            arguments: JSON.stringify({ changes: item.changes }),
+                        },
+                    },
+                ],
+            };
+        }
+        if (item.type === "mcp_tool_call") {
+            return {
+                type: "assistant",
+                uuid: item.id,
+                session_id: sessionId,
+                content: [],
+                tool_calls: [
+                    {
+                        id: item.id,
+                        type: "function",
+                        function: {
+                            name: item.tool,
+                            arguments: JSON.stringify(item.arguments ?? {}),
+                        },
+                    },
+                ],
+            };
+        }
+        if (item.type === "web_search") {
+            return {
+                type: "assistant",
+                uuid: item.id,
+                session_id: sessionId,
+                content: [],
+                tool_calls: [
+                    {
+                        id: item.id,
+                        type: "function",
+                        function: {
+                            name: "webSearch",
+                            arguments: JSON.stringify({ query: item.query }),
+                        },
+                    },
+                ],
+            };
+        }
+        return null;
+    }
+    convertCompletedItem(item, sessionId, itemTexts) {
+        if (item.type === "agent_message" && item.text.trim().length > 0) {
+            itemTexts.delete(item.id);
+            return {
+                type: "assistant",
+                uuid: item.id,
+                session_id: sessionId,
+                content: [{ type: "text", text: item.text }],
+            };
+        }
+        if (item.type === "error") {
+            return {
+                type: "result",
+                uuid: item.id,
+                session_id: sessionId,
+                subtype: "error",
+                is_error: true,
+                errors: [item.message],
+            };
+        }
+        return null;
+    }
+    async interrupt() {
+        if (this.abortController) {
+            this.abortController.abort();
+        }
+    }
+    close() {
+        if (this.closed) {
+            return;
+        }
+        this.closed = true;
+        if (this.abortController) {
+            this.abortController.abort();
+        }
+    }
+}
+//# sourceMappingURL=codex-agent.js.map

package/dist/agent/codex-agent.js.map

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

package/dist/agent/index.d.ts

@@ -0,0 +1,6 @@
+export { getAgentRuntime, type AgentRuntime, type AgentSdkProvider, type AgentQuerySession, } from "./agent-runtime.js";
+export type { AgentTransport } from "./transport.js";
+export { startMcpToolServer, setMcpToolServerTransport, clearMcpToolServerTransport, getMcpToolServerUrl, stopMcpToolServer, } from "./mcp-tool-server.js";
+export { default as agentSocketRoute } from "./socket-route.js";
+export type { AgentProvider, AgentModelDescriptor, AgentModelParams, AgentSessionOptions, AgentModelsRequest, AgentListSessionsRequest, AgentSessionInfoEntry, AgentGetSessionMessagesRequest, AgentTranscriptMessage, AgentMessage, FrontendToolManifest, AgentClientMessage, AgentServerMessage, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/agent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,2BAA2B,EAC3B,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAChE,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,EACrB,8BAA8B,EAC9B,sBAAsB,EACtB,YAAY,EACZ,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/agent/index.js

@@ -0,0 +1,4 @@
+export { getAgentRuntime, } from "./agent-runtime.js";
+export { startMcpToolServer, setMcpToolServerTransport, clearMcpToolServerTransport, getMcpToolServerUrl, stopMcpToolServer, } from "./mcp-tool-server.js";
+export { default as agentSocketRoute } from "./socket-route.js";
+//# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,GAIhB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,2BAA2B,EAC3B,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/agent/llm-agent.d.ts

@@ -0,0 +1,51 @@
+/**
+ * LlmAgentSdkProvider — runs an in-process LLM as an agent against the same
+ * `ui_*` tool surface the Claude/Codex/OpenCode/Pi harnesses use, and the
+ * same workflow-builder system prompt.
+ *
+ * Architecture:
+ *
+ *   AgentPanel (renderer)
+ *     │
+ *     └── /ws/agent (AgentSocketTransport)
+ *           │
+ *           ├── create_session{ provider:"llm", chatProviderId, model }
+ *           ├── send_message{ message }
+ *           │
+ *           ▼
+ *     LlmAgentSession.send()
+ *       │
+ *       ├── manifest := transport.requestToolManifest(sessionId)
+ *       ├── tools    := manifest.map(UiBridgeTool)   (each delegates back to
+ *       │                                              transport.executeTool)
+ *       ├── provider := getProvider(chatProviderId)   (anthropic/openai/...)
+ *       │
+ *       └── processChat({ provider, model, tools, ... })
+ *             ├── streams text chunks  ──► onMessage(AgentMessage{type:"assistant"})
+ *             ├── invokes tool         ──► UiBridgeTool.process()
+ *             │                                ──► transport.executeTool()
+ *             │                                       ──► renderer runs ui_* tool
+ *             └── returns final assistant text
+ *
+ * Unlike the harness providers, there is no subprocess and no MCP server
+ * here; tool dispatch is direct over the existing AgentTransport.
+ */
+import type { AgentListSessionsRequest, AgentModelDescriptor, AgentSessionInfoEntry, AgentTranscriptMessage } from "@nodetool-ai/protocol";
+import { type AgentQuerySession, type AgentSdkProvider } from "./sdk-provider.js";
+export declare class LlmAgentSdkProvider implements AgentSdkProvider {
+    readonly name = "llm";
+    listModels(userId: string, _workspacePath?: string): Promise<AgentModelDescriptor[]>;
+    createSession(options: {
+        model: string;
+        workspacePath: string;
+        userId: string;
+        resumeSessionId?: string;
+        systemPrompt?: string;
+        chatProviderId?: string;
+    }): AgentQuerySession;
+    listSessions(options: AgentListSessionsRequest, userId: string): Promise<AgentSessionInfoEntry[]>;
+    getSessionMessages(options: {
+        sessionId: string;
+    }, userId: string): Promise<AgentTranscriptMessage[]>;
+}
+//# sourceMappingURL=llm-agent.d.ts.map

package/dist/agent/llm-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-agent.d.ts","sourceRoot":"","sources":["../../src/agent/llm-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAiBH,OAAO,KAAK,EAEV,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EAEvB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,mBAAmB,CAAC;AAkb3B,qBAAa,mBAAoB,YAAW,gBAAgB;IAC1D,QAAQ,CAAC,IAAI,SAAS;IAEhB,UAAU,CACd,MAAM,EAAE,MAAM,EACd,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAOlC,aAAa,CAAC,OAAO,EAAE;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,aAAa,EAAE,MAAM,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,iBAAiB;IAoBf,YAAY,CAChB,OAAO,EAAE,wBAAwB,EACjC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAqD7B,kBAAkB,CACtB,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,EAC9B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,sBAAsB,EAAE,CAAC;CAmDrC"}