@ycodium-ai/agent-fake 0.2.2743 → 0.2.2808

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"`), or `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)
+- `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)
 - `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

@@ -40,7 +40,10 @@ var FAKE_CARD = {
     additionalProperties: false,
     "x-ycodium-form-order": ["replyText"],
     properties: {
-      script: { type: "string", enum: ["plain", "approval-tool", "async-question", "stream"] },
+      script: {
+        type: "string",
+        enum: ["plain", "approval-tool", "async-question", "stream", "mcp-send"]
+      },
       streamChunks: { type: "integer", minimum: 1 },
       streamIntervalMs: { type: "integer", minimum: 0 },
       // 额度与用量怎么答（见 fakeUsage.ts）；不进设置表单，开发与验收时手改实例配置。
@@ -188,6 +191,64 @@ var createFakeUsage = (input) => {
   return { readQuota, readTokenUsage, redeemQuotaReset };
 };
 
+// src/mcpSend.ts
+var PROTOCOL_VERSION = "2025-06-18";
+function builtinMcpServer(servers) {
+  const server = servers?.find((entry) => entry.transport.type === "http");
+  return server === void 0 ? null : server;
+}
+function parseMessage(text) {
+  const data = text.split(/\r?\n/).filter((line) => line.startsWith("data:")).map((line) => line.slice(5).trim());
+  const json = data.length > 0 ? data.at(-1) : text.trim();
+  return json.length === 0 ? null : JSON.parse(json);
+}
+async function callMcpTool(input) {
+  const post = async (headers, body) => {
+    const response = await input.fetch(input.server.transport.url, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        accept: "application/json, text/event-stream",
+        ...headers
+      },
+      body: JSON.stringify({ jsonrpc: "2.0", ...body })
+    });
+    const text = await response.text();
+    if (!response.ok)
+      throw new Error(
+        `MCP ${String(body.method)} failed: HTTP ${response.status} ${text.slice(0, 200)}`
+      );
+    return { response, message: parseMessage(text) };
+  };
+  const base = { ...input.server.transport.headers };
+  const initialized = await post(base, {
+    id: 1,
+    method: "initialize",
+    params: {
+      protocolVersion: PROTOCOL_VERSION,
+      capabilities: {},
+      clientInfo: { name: "agent-fake", version: "1.0.0" }
+    }
+  });
+  const sessionId = initialized.response.headers.get("mcp-session-id");
+  const session = {
+    ...base,
+    "mcp-protocol-version": PROTOCOL_VERSION,
+    ...sessionId === null ? {} : { "mcp-session-id": sessionId }
+  };
+  await post(session, { method: "notifications/initialized" });
+  const called = await post(session, {
+    id: 2,
+    method: "tools/call",
+    params: { name: input.name, arguments: input.arguments }
+  });
+  if (called.message?.error !== void 0)
+    throw new Error(
+      `MCP tools/call ${input.name} failed: ${called.message.error.message ?? "error"}`
+    );
+  return called.message?.result;
+}
+
 // src/fakeInstance.ts
 var yieldTick = () => Promise.resolve();
 var EventBus = class {
@@ -246,7 +307,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 : "plain";
+  return script === "approval-tool" || script === "async-question" || script === "stream" || script === "mcp-send" ? script : "plain";
 }
 var FAKE_STREAM_TEXT = [
   "Here is the plan for the change, step by step.\n\n",
@@ -285,7 +346,7 @@ var createFakeInstance = (config, host) => {
   const streamOptions = parseStreamOptions(config);
   const pendingDecisions = /* @__PURE__ */ new Map();
   let seq = 0;
-  let inflight = null;
+  const inflight = /* @__PURE__ */ new Map();
   let disposed = false;
   const nextId = (prefix) => `${prefix}-fake-${++seq}-${NodeCrypto.randomUUID()}`;
   const now = () => (/* @__PURE__ */ new Date()).toISOString();
@@ -308,7 +369,7 @@ var createFakeInstance = (config, host) => {
     if (!booked) throw new Error(`unknown thread ${threadId}`);
     return booked;
   };
-  const finishTurn = (booked, turnId, state, items) => {
+  const finishTurn = (booked, turnId, state, items, errorMessage) => {
     booked.turns.push({ id: turnId, items });
     const { activeTurnId: _cleared, ...idle } = booked.session;
     booked.session = {
@@ -316,8 +377,37 @@ var createFakeInstance = (config, host) => {
       status: "idle",
       updatedAt: now()
     };
-    emit("turn.completed", booked.session.threadId, { state }, { turnId });
-    inflight = null;
+    emit(
+      "turn.completed",
+      booked.session.threadId,
+      errorMessage === void 0 ? { state } : { state, errorMessage },
+      { turnId }
+    );
+    if (inflight.get(booked.session.threadId)?.turnId === turnId) {
+      inflight.delete(booked.session.threadId);
+    }
+  };
+  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 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)}`;
+    }
   };
   const runApprovalToolScript = async (threadId, turnId, signal) => {
     const isAborted = () => signal?.aborted === true;
@@ -434,6 +524,77 @@ var createFakeInstance = (config, host) => {
     await yieldTick();
     return isAborted() ? null : fakeReply;
   };
+  const runScriptedTurn = async (booked, threadId, turnId, signal, input) => {
+    const aborted = () => signal.aborted;
+    await yieldTick();
+    if (aborted()) {
+      finishTurn(booked, turnId, "interrupted", []);
+      return;
+    }
+    if (script === "async-question" && booked.asked !== true) {
+      booked.asked = true;
+      emit(
+        "content.delta",
+        threadId,
+        { streamKind: "assistant_text", delta: replyText },
+        { turnId }
+      );
+      emit(
+        "user-input.requested",
+        threadId,
+        { questions: FAKE_ASYNC_QUESTIONS, responseMode: "message" },
+        { turnId, requestId: nextId("question") }
+      );
+      await yieldTick();
+      finishTurn(booked, turnId, aborted() ? "interrupted" : "completed", [
+        { kind: "assistant", text: replyText }
+      ]);
+      return;
+    }
+    if (script === "mcp-send") {
+      const text = await runMcpSendScript(booked, input);
+      emit("content.delta", threadId, { streamKind: "assistant_text", delta: text }, { turnId });
+      await yieldTick();
+      finishTurn(booked, turnId, aborted() ? "interrupted" : "completed", [
+        { kind: "assistant", text }
+      ]);
+      return;
+    }
+    if (script === "stream") {
+      let text = "";
+      for (let index = 0; index < streamOptions.chunks; index++) {
+        if (aborted()) break;
+        const delta = fakeStreamChunk(index);
+        text += delta;
+        emit("content.delta", threadId, { streamKind: "assistant_text", delta }, { turnId });
+        await new Promise((resolve) => setTimeout(resolve, streamOptions.intervalMs));
+      }
+      finishTurn(booked, turnId, aborted() ? "interrupted" : "completed", [
+        { kind: "assistant", text }
+      ]);
+      return;
+    }
+    if (script === "approval-tool") {
+      const finalText = await runApprovalToolScript(threadId, turnId, signal);
+      finishTurn(
+        booked,
+        turnId,
+        aborted() ? "interrupted" : "completed",
+        finalText === null ? [] : [{ kind: "assistant", text: finalText }]
+      );
+      return;
+    }
+    emit("content.delta", threadId, { streamKind: "assistant_text", delta: replyText }, { turnId });
+    await yieldTick();
+    finishTurn(booked, turnId, aborted() ? "interrupted" : "completed", [
+      { kind: "assistant", text: replyText }
+    ]);
+  };
+  const failTurn = (booked, turnId, error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    host.log.warn("scripted turn failed", { threadId: booked.session.threadId, message });
+    finishTurn(booked, turnId, "failed", [], message);
+  };
   const instance = {
     probe: async () => ({
       installed: true,
@@ -460,7 +621,7 @@ var createFakeInstance = (config, host) => {
         ...input.discardResumeCursor === true || input.resumeCursor === void 0 ? {} : { resumeCursor: input.resumeCursor },
         ...input.bindingGeneration === void 0 ? {} : { bindingGeneration: input.bindingGeneration }
       };
-      threads.set(input.threadId, { session, turns: [] });
+      threads.set(input.threadId, { session, turns: [], mcpServers: input.mcpServers });
       emit(
         "session.started",
         input.threadId,
@@ -472,14 +633,13 @@ var createFakeInstance = (config, host) => {
     sendTurn: async (input, signal) => {
       if (disposed) throw new Error("instance disposed");
       const booked = requireThread(input.threadId);
-      if (inflight !== null) throw new Error("turn already in flight");
+      if (inflight.has(input.threadId)) throw new Error("turn already in flight");
       const turnId = input.expectedTurnId ?? nextId("turn");
-      let aborted = signal?.aborted === true;
-      const onAbort = () => {
-        aborted = true;
-      };
-      signal?.addEventListener("abort", onAbort);
-      inflight = { threadId: input.threadId, turnId, abort: onAbort };
+      const turnAbort = new AbortController();
+      const abortTurn = () => turnAbort.abort();
+      if (signal?.aborted === true) abortTurn();
+      signal?.addEventListener("abort", abortTurn);
+      inflight.set(input.threadId, { turnId, abort: abortTurn });
       booked.session = {
         ...booked.session,
         status: "running",
@@ -487,82 +647,30 @@ var createFakeInstance = (config, host) => {
         updatedAt: now()
       };
       emit("turn.started", input.threadId, {}, { turnId });
+      const result = { threadId: input.threadId, turnId };
+      const run = () => runScriptedTurn(booked, input.threadId, turnId, turnAbort.signal, input.input);
+      const settle = () => {
+        signal?.removeEventListener("abort", abortTurn);
+        if (inflight.get(input.threadId)?.turnId === turnId) inflight.delete(input.threadId);
+      };
+      if (script === "approval-tool" || script === "stream" || script === "mcp-send") {
+        signal?.removeEventListener("abort", abortTurn);
+        void run().catch((error) => failTurn(booked, turnId, error)).finally(settle);
+        return result;
+      }
       try {
-        await yieldTick();
-        if (aborted) {
-          finishTurn(booked, turnId, "interrupted", []);
-          return { threadId: input.threadId, turnId };
-        }
-        if (script === "async-question" && booked.asked !== true) {
-          booked.asked = true;
-          emit(
-            "content.delta",
-            input.threadId,
-            { streamKind: "assistant_text", delta: replyText },
-            { turnId }
-          );
-          emit(
-            "user-input.requested",
-            input.threadId,
-            { questions: FAKE_ASYNC_QUESTIONS, responseMode: "message" },
-            { turnId, requestId: nextId("question") }
-          );
-          await yieldTick();
-          finishTurn(booked, turnId, aborted ? "interrupted" : "completed", [
-            { kind: "assistant", text: replyText }
-          ]);
-          return { threadId: input.threadId, turnId };
-        }
-        if (script === "stream") {
-          let text = "";
-          for (let index = 0; index < streamOptions.chunks; index++) {
-            if (aborted) break;
-            const delta = fakeStreamChunk(index);
-            text += delta;
-            emit(
-              "content.delta",
-              input.threadId,
-              { streamKind: "assistant_text", delta },
-              { turnId }
-            );
-            await new Promise((resolve) => setTimeout(resolve, streamOptions.intervalMs));
-          }
-          finishTurn(booked, turnId, aborted ? "interrupted" : "completed", [
-            { kind: "assistant", text }
-          ]);
-          return { threadId: input.threadId, turnId };
-        }
-        if (script === "approval-tool") {
-          const finalText = await runApprovalToolScript(input.threadId, turnId, signal);
-          finishTurn(booked, turnId, aborted ? "interrupted" : "completed", [
-            ...finalText === null ? [] : [{ kind: "assistant", text: finalText }]
-          ]);
-          return { threadId: input.threadId, turnId };
-        }
-        emit(
-          "content.delta",
-          input.threadId,
-          { streamKind: "assistant_text", delta: replyText },
-          { turnId }
-        );
-        await yieldTick();
-        if (aborted) {
-          finishTurn(booked, turnId, "interrupted", [{ kind: "assistant", text: replyText }]);
-          return { threadId: input.threadId, turnId };
-        }
-        finishTurn(booked, turnId, "completed", [{ kind: "assistant", text: replyText }]);
-        return { threadId: input.threadId, turnId };
+        await run();
+        return result;
       } finally {
-        signal?.removeEventListener("abort", onAbort);
-        if (inflight?.turnId === turnId) inflight = null;
+        settle();
       }
     },
     interruptTurn: async (threadId, turnId) => {
-      if (inflight === null) return;
-      if (inflight.threadId !== threadId) return;
-      if (turnId !== void 0 && inflight.turnId !== turnId) return;
-      host.log.info("interrupt turn", { threadId, turnId: inflight.turnId });
-      inflight.abort();
+      const running = inflight.get(threadId);
+      if (running === void 0) return;
+      if (turnId !== void 0 && running.turnId !== turnId) return;
+      host.log.info("interrupt turn", { threadId, turnId: running.turnId });
+      running.abort();
     },
     respondToRequest: async (threadId, requestId, decision) => {
       host.log.info("respondToRequest", { threadId, requestId, decision });
@@ -576,7 +684,7 @@ var createFakeInstance = (config, host) => {
       host.log.info("respondToUserInput ignored");
     },
     stopSession: async (threadId) => {
-      if (inflight?.threadId === threadId) inflight.abort();
+      inflight.get(threadId)?.abort();
       threads.delete(threadId);
     },
     readThread: async (threadId) => {
@@ -587,8 +695,8 @@ var createFakeInstance = (config, host) => {
     usage: createFakeUsage({ instanceId: host.instanceId, script: parseUsageScript(config) }),
     dispose: async () => {
       disposed = true;
-      inflight?.abort();
-      inflight = null;
+      for (const running of inflight.values()) running.abort();
+      inflight.clear();
       for (const settle of pendingDecisions.values()) settle("cancel");
       pendingDecisions.clear();
       threads.clear();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ycodium-ai/agent-fake",
-  "version": "0.2.2743",
+  "version": "0.2.2808",
   "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.2743",
+    "@ycodium-ai/plugin-api": "0.2.2808",
     "ycodium-executor-testing": "0.0.0"
   },
   "ycodium": {