@m6d/cortex-server 2.0.0 → 2.1.0

package/src/lib/cc/registry.ts

@@ -1,11 +1,23 @@
 import type { ControlCenterClient } from "./client";
-import type { RuntimeAgentConfig } from "./types";
+import type { RuntimeAgentConfig, ToolInteraction } from "./types";
 
 export type CcToolBinding = {
     toolId: string;
     readOnly: boolean;
 };
 
+/**
+ * An interactive tool resolved for this turn. Declared to the model as a real
+ * client-executed tool — never a sandbox binding — so its call streams to the
+ * widget as a tool-call part and parks the run until the flow settles.
+ */
+export type CcInteractiveTool = {
+    toolId: string;
+    signature: string;
+    interaction: ToolInteraction;
+    inputSchema?: Record<string, unknown>;
+};
+
 /**
  * Turn-scoped and mutable: seeded from /resolve, extended by searchTools
  * mid-turn so a tool discovered at step 3 is callable at step 4.
@@ -14,9 +26,10 @@ export type CcToolRegistry = Map<string, CcToolBinding>;
 
 export function registerCcTools(
     registry: CcToolRegistry,
-    tools: { name: string; toolId: string; readOnly: boolean }[],
+    tools: { name: string; toolId: string; readOnly: boolean; interaction?: ToolInteraction }[],
 ) {
     for (const tool of tools) {
+        if (tool.interaction) continue;
         registry.set(tool.name, { toolId: tool.toolId, readOnly: tool.readOnly });
     }
 }
@@ -50,6 +63,7 @@ export type CcRuntime = {
     agentId: string;
     config: RuntimeAgentConfig;
     registry: CcToolRegistry;
+    interactiveTools: Map<string, CcInteractiveTool>;
     threadId: string;
     turnKey: string;
     userId: string;

package/src/lib/cc/types.ts

@@ -17,6 +17,7 @@ export {
     type ResolveResponse,
     type RuntimeAgentConfig,
     type SearchRequest,
+    type ToolInteraction,
 } from "@cortex/contracts/runtime";
 
 const knownRuntimeErrorKinds = new Set<string>(RUNTIME_ERROR_KINDS);

package/src/lib/routes/chat.ts

@@ -6,6 +6,7 @@ import { HTTPException } from "hono/http-exception";
 import type { CortexAppEnv } from "@/types";
 import { requireAuth } from "@/auth/middleware";
 import { startTurn } from "@/ai/index";
+import { initiateInteractiveTool } from "@/ai/interactive";
 import { abortRun, getRunId, joinLog, offsetBelongsToRun } from "@/ai/active-runs";
 import { notify } from "@/ws/connections";
 import { requireOwnedThread } from "./owned-thread";
@@ -91,6 +92,28 @@ export function createChatRoutes() {
         return resumeServerSentEventsResponse({ adapter: joinLog(chatId, runId) });
     });
 
+    /**
+     * Runs an interactive tool's initiate call for a pending tool call and
+     * returns the widget's embed payload. `interactive: false` tells the
+     * widget the call is not an interactive CC tool — fall back to its
+     * default rendering. The payload never reaches the model.
+     */
+    app.post("/chat/:chatId/tools/:toolCallId/initiate", requireAuth, async function (c) {
+        const config = c.get("agentConfig");
+        const { id: userId, token } = c.get("user");
+        const thread = await requireOwnedThread(c, c.req.param("chatId"));
+
+        return c.json(
+            await initiateInteractiveTool({
+                config,
+                thread,
+                userId,
+                token,
+                toolCallId: c.req.param("toolCallId"),
+            }),
+        );
+    });
+
     app.post("/chat/:chatId/abort", requireAuth, async function (c) {
         const agentId = c.get("agentId");
         const userId = c.get("user").id;