@ycodium-ai/agent-fake 0.2.2938 → 0.2.2944

package/README.md

@@ -4,7 +4,7 @@ A minimal executor plugin. It starts no CLI and replays a fixed event script:
 
 - `startSession` emits `session.started`
 - `sendTurn` emits `turn.started`, one `content.delta`, then `turn.completed` (the host binds the turn by `turn.started`)
-- `config.script` picks the script: `plain` (default), `approval-tool` (two approvals before the reply), `async-question` (on a thread's first turn, the reply plus one non-blocking `user-input.requested` with `responseMode: "message"`), `stream` (a Markdown answer in `config.streamChunks` deltas, default 200, one every `config.streamIntervalMs`, default 30; the UI probe `interaction-table.ts` measures streaming with it), or `mcp-send` (a turn whose input is a JSON object is passed as the arguments of one real `send_message` call through the built-in MCP server the host handed to `startSession`, the same path a real agent takes; the reply is the tool result, and any other input gets the plain reply)
+- `config.script` picks the script: `plain` (default), `approval-tool` (two approvals before the reply), `async-question` (on a thread's first turn, the reply plus one non-blocking `user-input.requested` with `responseMode: "message"`), `stream` (a Markdown answer in `config.streamChunks` deltas, default 200, one every `config.streamIntervalMs`, default 30; the UI probe `interaction-table.ts` measures streaming with it), `mcp-send` (real calls through the built-in MCP server the host handed to `startSession`, the same path a real agent takes: a turn whose input is a JSON object is passed as the arguments of one `send_message` call, and a JSON array of `{ "tool": "…", "arguments": { … } }` is called step by step, for example `ycodium_plugin_define`, then `ycodium_plugin_run`, then a tool the mounted plugin contributes; the reply has one line per call with its result or error, and any other input gets the plain reply), or `visualize` (emits one in-progress builtin tool row, holds for `config.previewHoldMs` milliseconds so the input preview can paint, then one real `visualize_visualize` call on that same server; the tool row’s result is the MCP confirmation text, and the reply is “The figure is in the card above.”)
 - `interruptTurn` (or an aborted `AbortSignal`) ends the in-flight turn as `interrupted`
 - `readThread` returns the bookkeeping the instance recorded
 - `probe` reports two models, `fake` (default) and `fake-large`

package/dist/index.js

@@ -42,7 +42,7 @@ var FAKE_CARD = {
     properties: {
       script: {
         type: "string",
-        enum: ["plain", "approval-tool", "async-question", "stream", "mcp-send"]
+        enum: ["plain", "approval-tool", "async-question", "stream", "mcp-send", "visualize"]
       },
       streamChunks: { type: "integer", minimum: 1 },
       streamIntervalMs: { type: "integer", minimum: 0 },
@@ -250,6 +250,124 @@ async function callMcpTool(input) {
     );
   return called.message?.result;
 }
+var isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+function parseMcpSendInput(input) {
+  let parsed;
+  try {
+    parsed = JSON.parse(input ?? "");
+  } catch {
+    return null;
+  }
+  if (isRecord(parsed)) return [{ tool: "send_message", arguments: parsed }];
+  if (!Array.isArray(parsed) || parsed.length === 0) return null;
+  const calls = [];
+  for (const entry of parsed) {
+    if (!isRecord(entry) || typeof entry.tool !== "string" || entry.tool.length === 0) return null;
+    const args = entry.arguments ?? {};
+    if (!isRecord(args)) return null;
+    calls.push({ tool: entry.tool, arguments: args });
+  }
+  return calls;
+}
+async function runMcpCalls(input) {
+  const lines = [];
+  for (const call of input.calls) {
+    try {
+      const result = await callMcpTool({
+        fetch: input.fetch,
+        server: input.server,
+        name: call.tool,
+        arguments: call.arguments
+      });
+      lines.push(`mcp-send ${call.tool}: ${JSON.stringify(result)}`);
+    } catch (error) {
+      lines.push(`mcp-send ${call.tool} failed: ${String(error)}`);
+    }
+  }
+  return lines.join("\n");
+}
+
+// src/visualizeScript.ts
+var WIRE_NAME = "mcp__ycodium__visualize_visualize";
+var TITLE = "Monthly sales";
+var FRAGMENT = "<section><h1>Monthly sales</h1><p>Jan 12 \xB7 Feb 18 \xB7 Mar 15</p></section>";
+var REPLY = "The figure is in the card above.";
+function parsePreviewHoldMs(input) {
+  const config = input?.config;
+  const raw = config?.previewHoldMs;
+  if (typeof raw !== "number" || !Number.isFinite(raw) || raw < 0) return 0;
+  return Math.min(3e4, Math.floor(raw));
+}
+function confirmationText(result) {
+  const content = result?.content;
+  if (!Array.isArray(content)) return "";
+  const chunks = [];
+  for (const entry of content) {
+    const text = entry?.text;
+    if (typeof text === "string" && text.length > 0) chunks.push(text);
+  }
+  return chunks.join("\n");
+}
+function hold(ms, signal) {
+  if (ms === 0 || signal.aborted) return Promise.resolve();
+  return new Promise((resolve) => {
+    let timer;
+    const finish = () => {
+      if (timer !== void 0) clearTimeout(timer);
+      signal.removeEventListener("abort", finish);
+      resolve();
+    };
+    timer = setTimeout(finish, ms);
+    signal.addEventListener("abort", finish, { once: true });
+  });
+}
+async function runVisualizeTurn(input) {
+  const args = JSON.stringify({ action: "create", title: TITLE, fragment: FRAGMENT });
+  const tool = (status, result) => ({
+    itemType: "dynamic_tool_call",
+    status,
+    title: WIRE_NAME,
+    data: {
+      toolName: WIRE_NAME,
+      argumentText: args,
+      ...result === void 0 ? {} : { result }
+    }
+  });
+  input.emit("item.started", input.threadId, tool("inProgress"), {
+    turnId: input.turnId,
+    itemId: input.itemId
+  });
+  await hold(input.holdMs, input.signal);
+  if (input.signal.aborted) return null;
+  const server = builtinMcpServer(input.mcpServers);
+  if (server === null) {
+    const failure = "visualize: no MCP server was handed to this session";
+    input.emit("item.completed", input.threadId, tool("completed", failure), {
+      turnId: input.turnId,
+      itemId: input.itemId
+    });
+    return failure;
+  }
+  let resultText;
+  try {
+    resultText = confirmationText(
+      await callMcpTool({
+        fetch: input.fetch,
+        server,
+        name: "visualize_visualize",
+        arguments: { action: "create", title: TITLE, fragment: FRAGMENT }
+      })
+    );
+  } catch (error) {
+    resultText = `visualize failed: ${String(error)}`;
+  }
+  if (input.signal.aborted) return null;
+  input.emit("item.completed", input.threadId, tool("completed", resultText), {
+    turnId: input.turnId,
+    itemId: input.itemId
+  });
+  return resultText.length > 0 ? REPLY : "visualize failed: empty tool result";
+}
 
 // src/fakeInstance.ts
 var yieldTick = () => Promise.resolve();
@@ -309,7 +427,7 @@ var FAKE_ASYNC_QUESTIONS = [
 function parseScript(input) {
   const envelope = input;
   const script = envelope?.config?.script;
-  return script === "approval-tool" || script === "async-question" || script === "stream" || script === "mcp-send" ? script : "plain";
+  return script === "approval-tool" || script === "async-question" || script === "stream" || script === "mcp-send" || script === "visualize" ? script : "plain";
 }
 var FAKE_STREAM_TEXT = [
   "Here is the plan for the change, step by step.\n\n",
@@ -353,6 +471,7 @@ var createFakeInstance = (config, host) => {
   const replyText = parseReplyText(config);
   const failStartSession = parseFailStartSession(config);
   const streamOptions = parseStreamOptions(config);
+  const previewHoldMs = parsePreviewHoldMs(config);
   const pendingDecisions = /* @__PURE__ */ new Map();
   let seq = 0;
   const inflight = /* @__PURE__ */ new Map();
@@ -397,26 +516,11 @@ var createFakeInstance = (config, host) => {
     }
   };
   const runMcpSendScript = async (booked, input) => {
-    let args;
-    try {
-      args = JSON.parse(input ?? "");
-    } catch {
-      return replyText;
-    }
-    if (typeof args !== "object" || args === null || Array.isArray(args)) return replyText;
+    const calls = parseMcpSendInput(input);
+    if (calls === null) return replyText;
     const server = builtinMcpServer(booked.mcpServers);
     if (server === null) return "mcp-send: no MCP server was handed to this session";
-    try {
-      const result = await callMcpTool({
-        fetch: host.fetch,
-        server,
-        name: "send_message",
-        arguments: args
-      });
-      return `mcp-send: ${JSON.stringify(result)}`;
-    } catch (error) {
-      return `mcp-send failed: ${String(error)}`;
-    }
+    return runMcpCalls({ fetch: host.fetch, server, calls });
   };
   const runApprovalToolScript = async (threadId, turnId, signal) => {
     const isAborted = () => signal?.aborted === true;
@@ -560,6 +664,26 @@ var createFakeInstance = (config, host) => {
       ]);
       return;
     }
+    if (script === "visualize") {
+      const text = await runVisualizeTurn({
+        threadId,
+        turnId,
+        itemId: nextId("item"),
+        holdMs: previewHoldMs,
+        signal,
+        fetch: host.fetch,
+        mcpServers: booked.mcpServers,
+        emit
+      });
+      if (text === null || aborted()) {
+        finishTurn(booked, turnId, "interrupted", []);
+        return;
+      }
+      emit("content.delta", threadId, { streamKind: "assistant_text", delta: text }, { turnId });
+      await yieldTick();
+      finishTurn(booked, turnId, "completed", [{ kind: "assistant", text }]);
+      return;
+    }
     if (script === "mcp-send") {
       const text = await runMcpSendScript(booked, input);
       emit("content.delta", threadId, { streamKind: "assistant_text", delta: text }, { turnId });
@@ -663,7 +787,7 @@ var createFakeInstance = (config, host) => {
         signal?.removeEventListener("abort", abortTurn);
         if (inflight.get(input.threadId)?.turnId === turnId) inflight.delete(input.threadId);
       };
-      if (script === "approval-tool" || script === "stream" || script === "mcp-send") {
+      if (script === "approval-tool" || script === "stream" || script === "mcp-send" || script === "visualize") {
         signal?.removeEventListener("abort", abortTurn);
         void run().catch((error) => failTurn(booked, turnId, error)).finally(settle);
         return result;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ycodium-ai/agent-fake",
-  "version": "0.2.2938",
+  "version": "0.2.2944",
   "description": "Minimal fake executor for plugin authors and host orchestration tests.",
   "keywords": [
     "ycodium",
@@ -21,7 +21,7 @@
     "@types/node": "24.12.4",
     "esbuild": "0.28.1",
     "vite-plus": "0.2.2",
-    "@ycodium-ai/plugin-api": "0.2.2938",
+    "@ycodium-ai/plugin-api": "0.2.2944",
     "ycodium-executor-testing": "0.0.0"
   },
   "ycodium": {