@ycodium-ai/agent-fake 0.2.2944 → 0.2.2948

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), `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.”)
+- `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), `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.”), or `lane` (the UI probe `lane1-journey.ts` script: the user message's `lane:stream|plain|approve|question|attach|hold` picks the turn; `hold` accepts a second `sendTurn` with the in-flight turn id as a steer and folds that text into the reply; `config.holdMs` is how long `hold` waits, default 15000)
 - `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

@@ -29,7 +29,9 @@ var FAKE_CARD = {
   everydayHarness: false,
   capabilities: {
     sessionModelSwitch: "unsupported",
-    runtimeModeSwitch: "next-turn"
+    runtimeModeSwitch: "next-turn",
+    // lane 脚本会把插话并进正在跑的那一轮；不声明的话界面不给「发送到当前轮次」。
+    turnSteering: true
   },
   credentialSources: [],
   diagnostics: [],
@@ -42,10 +44,20 @@ var FAKE_CARD = {
     properties: {
       script: {
         type: "string",
-        enum: ["plain", "approval-tool", "async-question", "stream", "mcp-send", "visualize"]
+        enum: [
+          "plain",
+          "approval-tool",
+          "async-question",
+          "stream",
+          "mcp-send",
+          "visualize",
+          "lane"
+        ]
       },
       streamChunks: { type: "integer", minimum: 1 },
       streamIntervalMs: { type: "integer", minimum: 0 },
+      // lane 的 hold 最多等插话多久；不进设置表单。
+      holdMs: { type: "integer", minimum: 0 },
       // stream 脚本循环切片的源文本；性能探针用它换上可控的长回复，不进设置表单。
       streamText: { type: "string" },
       // 额度与用量怎么答（见 fakeUsage.ts）；不进设置表单，开发与验收时手改实例配置。
@@ -74,6 +86,235 @@ var FAKE_CARD = {
 // src/fakeInstance.ts
 import * as NodeCrypto from "node:crypto";
 
+// src/laneScript.ts
+import * as NodeFS from "node:fs";
+import * as NodePath from "node:path";
+var LANE_STREAM_DONE = "LANE_STREAM_DONE";
+var LANE_PLAIN_DONE = "LANE_PLAIN_DONE";
+var LANE_APPROVAL_DONE = "LANE_APPROVAL_DONE";
+var LANE_APPROVAL_DECLINED = "LANE_APPROVAL_DECLINED";
+var LANE_QUESTION_ASKED = "LANE_QUESTION_ASKED";
+var LANE_QUESTION_TEXT = "Which database should I use?";
+var LANE_ATTACH_DONE = "LANE_ATTACH_DONE";
+var LANE_HOLD_DONE = "LANE_HOLD_DONE";
+var LANE_STEERED_PREFIX = "LANE_STEERED:";
+var LANE_IMAGE_NAME = "lane1.png";
+var LANE_DOCUMENT_NAME = "lane1.pdf";
+var LANE_STREAM_TEXT = [
+  "Here is a longer note so the timeline can scroll.",
+  "The first paragraph stays on screen while the rest arrives in pieces.",
+  "Each piece is short on purpose: the probe sends the next message before this turn ends.",
+  "Scroll up after this reply and the position should survive a tab switch."
+].join(" ");
+var LANE_PNG = Buffer.from(
+  "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg==",
+  "base64"
+);
+var LANE_PDF = Buffer.from(
+  "%PDF-1.1\n1 0 obj<</Type/Catalog/Pages 2 0 R>>endobj\n2 0 obj<</Type/Pages/Count 1/Kids[3 0 R]>>endobj\n3 0 obj<</Type/Page/Parent 2 0 R/MediaBox[0 0 200 200]>>endobj\ntrailer<</Root 1 0 R>>\n%%EOF\n"
+);
+function parseLaneKind(input) {
+  const match = /lane:(stream|plain|approve|question|attach|hold)\b/.exec(input ?? "");
+  const kind = match?.[1];
+  return kind === "stream" || kind === "plain" || kind === "approve" || kind === "question" || kind === "attach" || kind === "hold" ? kind : "plain";
+}
+function laneTurnOptions(input, stream) {
+  const holdMs = input?.config?.holdMs;
+  return {
+    streamChunks: stream.chunks,
+    streamIntervalMs: stream.intervalMs,
+    holdMs: typeof holdMs === "number" && holdMs >= 0 ? holdMs : 15e3
+  };
+}
+async function openShellApproval(input) {
+  const itemId = input.nextItemId();
+  const args = { command: input.detail };
+  input.emit(
+    "item.started",
+    { itemType: "command_execution", status: "inProgress", title: input.detail, data: args },
+    { itemId }
+  );
+  input.emit(
+    "request.opened",
+    {
+      requestType: "exec_command_approval",
+      toolName: "shell",
+      detail: input.detail,
+      args
+    },
+    { requestId: input.requestId }
+  );
+  const decision = await new Promise((resolve) => {
+    let settled = false;
+    const settle = (value) => {
+      if (settled) return;
+      settled = true;
+      input.signal.removeEventListener("abort", onAbort);
+      input.pending.delete(input.requestId);
+      resolve(value);
+    };
+    const onAbort = () => settle("cancel");
+    input.signal.addEventListener("abort", onAbort);
+    if (input.signal.aborted) {
+      settle("cancel");
+      return;
+    }
+    input.pending.set(input.requestId, settle);
+  });
+  input.emit(
+    "request.resolved",
+    {
+      requestType: "exec_command_approval",
+      decision: decision === "allow" ? "accept" : decision === "deny" ? "decline" : "cancel"
+    },
+    { requestId: input.requestId }
+  );
+  input.emit(
+    "item.completed",
+    {
+      itemType: "command_execution",
+      status: decision === "allow" ? "completed" : "declined",
+      title: input.detail,
+      data: args
+    },
+    { itemId }
+  );
+  return decision;
+}
+var delay = (ms, signal) => new Promise((resolve) => {
+  if (signal.aborted || ms <= 0) {
+    resolve();
+    return;
+  }
+  const timer = setTimeout(resolve, ms);
+  signal.addEventListener(
+    "abort",
+    () => {
+      clearTimeout(timer);
+      resolve();
+    },
+    { once: true }
+  );
+});
+var assistant = (emit, delta) => {
+  emit("content.delta", { streamKind: "assistant_text", delta });
+};
+function acceptLaneSteer(input) {
+  const { running } = input;
+  if (running === void 0 || !input.enabled) return null;
+  if (input.expectedTurnId !== void 0 && input.expectedTurnId !== running.turnId) return null;
+  const text = input.text?.trim() ?? "";
+  if (text !== "") {
+    const parts = input.steered.get(input.threadId) ?? [];
+    parts.push(text);
+    input.steered.set(input.threadId, parts);
+  }
+  return { threadId: input.threadId, turnId: running.turnId };
+}
+async function runLaneTurn(ctx) {
+  const kind = parseLaneKind(ctx.input);
+  if (ctx.signal.aborted) return null;
+  switch (kind) {
+    case "stream":
+      return streamTurn(ctx);
+    case "approve":
+      return approveTurn(ctx);
+    case "question":
+      return questionTurn(ctx);
+    case "attach":
+      return attachTurn(ctx);
+    case "hold":
+      return holdTurn(ctx);
+    case "plain":
+      assistant(ctx.emit, LANE_PLAIN_DONE);
+      await delay(0, ctx.signal);
+      return ctx.signal.aborted ? null : LANE_PLAIN_DONE;
+    default: {
+      const unreachable = kind;
+      return unreachable;
+    }
+  }
+}
+async function streamTurn(ctx) {
+  let text = "";
+  const pieces = Math.max(1, ctx.options.streamChunks);
+  for (let index = 0; index < pieces; index += 1) {
+    if (ctx.signal.aborted) return null;
+    const start = index * 24 % LANE_STREAM_TEXT.length;
+    const delta = LANE_STREAM_TEXT.slice(start, start + 24) || LANE_STREAM_TEXT.slice(0, 24);
+    text += delta;
+    assistant(ctx.emit, delta);
+    await delay(ctx.options.streamIntervalMs, ctx.signal);
+  }
+  if (ctx.signal.aborted) return null;
+  assistant(ctx.emit, LANE_STREAM_DONE);
+  return `${text}${LANE_STREAM_DONE}`;
+}
+async function approveTurn(ctx) {
+  const requestId = ctx.nextId("req");
+  const decision = await ctx.approve({ requestId, detail: "echo lane1-approve" });
+  if (decision === "cancel" || ctx.signal.aborted) return null;
+  const text = decision === "allow" ? LANE_APPROVAL_DONE : LANE_APPROVAL_DECLINED;
+  assistant(ctx.emit, text);
+  await delay(0, ctx.signal);
+  return ctx.signal.aborted ? null : text;
+}
+function questionTurn(ctx) {
+  if (ctx.signal.aborted) return null;
+  assistant(ctx.emit, LANE_QUESTION_ASKED);
+  ctx.emit(
+    "user-input.requested",
+    {
+      questions: [
+        {
+          id: "q0",
+          header: LANE_QUESTION_TEXT,
+          question: LANE_QUESTION_TEXT,
+          options: [
+            { label: "Postgres", description: "" },
+            { label: "SQLite", description: "" }
+          ],
+          allowFreeform: true,
+          multiSelect: false
+        }
+      ],
+      responseMode: "message"
+    },
+    { requestId: ctx.nextId("question") }
+  );
+  return LANE_QUESTION_ASKED;
+}
+function attachTurn(ctx) {
+  if (ctx.signal.aborted) return null;
+  NodeFS.mkdirSync(ctx.cwd, { recursive: true });
+  const imagePath = NodePath.join(ctx.cwd, LANE_IMAGE_NAME);
+  const documentPath = NodePath.join(ctx.cwd, LANE_DOCUMENT_NAME);
+  NodeFS.writeFileSync(imagePath, LANE_PNG);
+  NodeFS.writeFileSync(documentPath, LANE_PDF);
+  ctx.emit("assistant.artifact.produced", {
+    artifacts: [
+      { path: imagePath, name: LANE_IMAGE_NAME, mimeType: "image/png" },
+      { path: documentPath, name: LANE_DOCUMENT_NAME, mimeType: "application/pdf" }
+    ]
+  });
+  assistant(ctx.emit, LANE_ATTACH_DONE);
+  return LANE_ATTACH_DONE;
+}
+async function holdTurn(ctx) {
+  assistant(ctx.emit, "holding the turn");
+  const deadline = Date.now() + ctx.options.holdMs;
+  let steered = "";
+  while (!ctx.signal.aborted && Date.now() < deadline) {
+    steered = ctx.takeSteered();
+    if (steered !== "") break;
+    await delay(50, ctx.signal);
+  }
+  if (ctx.signal.aborted) return null;
+  const text = steered === "" ? LANE_HOLD_DONE : `${LANE_HOLD_DONE} ${LANE_STEERED_PREFIX}${steered}`;
+  assistant(ctx.emit, text);
+  return text;
+}
+
 // src/fakeUsage.ts
 var FAKE_USAGE_SCRIPTS = [
   "available",
@@ -287,6 +528,29 @@ async function runMcpCalls(input) {
   return lines.join("\n");
 }
 
+// src/streamScript.ts
+var FAKE_STREAM_TEXT = [
+  "Here is the plan for the change, step by step.\n\n",
+  "1. Read the current implementation and note the hot path.\n",
+  "2. Move the measurement out of the commit phase.\n",
+  "3. Verify the numbers on a production build.\n\n",
+  "```ts\nexport function measure(root: HTMLElement) {\n  return root.getBoundingClientRect().height;\n}\n```\n\n",
+  "The **important** part is that the timeline only re-renders the streaming row, ",
+  "not the whole list, so each delta stays cheap even on a long conversation. "
+].join("");
+var STREAM_CHUNK_CHARS = 12;
+var parseStreamOptions = (input) => {
+  const config = input?.config ?? {};
+  const customText = typeof config.streamText === "string" && config.streamText !== "" ? config.streamText : null;
+  const chunks = typeof config.streamChunks === "number" && config.streamChunks >= 1 ? Math.floor(config.streamChunks) : customText === null ? 200 : Math.ceil(customText.length / STREAM_CHUNK_CHARS);
+  const intervalMs = typeof config.streamIntervalMs === "number" && config.streamIntervalMs >= 0 ? config.streamIntervalMs : 30;
+  return { chunks, intervalMs, text: customText ?? FAKE_STREAM_TEXT };
+};
+var fakeStreamChunk = (text, index) => {
+  const start = index * STREAM_CHUNK_CHARS % text.length;
+  return text.slice(start, start + STREAM_CHUNK_CHARS) || text.slice(0, STREAM_CHUNK_CHARS);
+};
+
 // src/visualizeScript.ts
 var WIRE_NAME = "mcp__ycodium__visualize_visualize";
 var TITLE = "Monthly sales";
@@ -427,29 +691,8 @@ 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 === "visualize" ? script : "plain";
+  return script === "approval-tool" || script === "async-question" || script === "stream" || script === "mcp-send" || script === "visualize" || script === "lane" ? script : "plain";
 }
-var FAKE_STREAM_TEXT = [
-  "Here is the plan for the change, step by step.\n\n",
-  "1. Read the current implementation and note the hot path.\n",
-  "2. Move the measurement out of the commit phase.\n",
-  "3. Verify the numbers on a production build.\n\n",
-  "```ts\nexport function measure(root: HTMLElement) {\n  return root.getBoundingClientRect().height;\n}\n```\n\n",
-  "The **important** part is that the timeline only re-renders the streaming row, ",
-  "not the whole list, so each delta stays cheap even on a long conversation. "
-].join("");
-var STREAM_CHUNK_CHARS = 12;
-var parseStreamOptions = (input) => {
-  const config = input?.config ?? {};
-  const customText = typeof config.streamText === "string" && config.streamText !== "" ? config.streamText : null;
-  const chunks = typeof config.streamChunks === "number" && config.streamChunks >= 1 ? Math.floor(config.streamChunks) : customText === null ? 200 : Math.ceil(customText.length / STREAM_CHUNK_CHARS);
-  const intervalMs = typeof config.streamIntervalMs === "number" && config.streamIntervalMs >= 0 ? config.streamIntervalMs : 30;
-  return { chunks, intervalMs, text: customText ?? FAKE_STREAM_TEXT };
-};
-var fakeStreamChunk = (text, index) => {
-  const start = index * STREAM_CHUNK_CHARS % text.length;
-  return text.slice(start, start + STREAM_CHUNK_CHARS) || text.slice(0, STREAM_CHUNK_CHARS);
-};
 var parseReplyText = (input) => {
   const envelope = input;
   const replyText = envelope?.config?.replyText;
@@ -472,6 +715,8 @@ var createFakeInstance = (config, host) => {
   const failStartSession = parseFailStartSession(config);
   const streamOptions = parseStreamOptions(config);
   const previewHoldMs = parsePreviewHoldMs(config);
+  const laneOptions = laneTurnOptions(config, streamOptions);
+  const steeredInputs = /* @__PURE__ */ new Map();
   const pendingDecisions = /* @__PURE__ */ new Map();
   let seq = 0;
   const inflight = /* @__PURE__ */ new Map();
@@ -707,6 +952,34 @@ var createFakeInstance = (config, host) => {
       ]);
       return;
     }
+    if (script === "lane") {
+      const text = await runLaneTurn({
+        threadId,
+        turnId,
+        cwd: booked.session.cwd ?? host.workspacePath(threadId),
+        input,
+        signal,
+        options: laneOptions,
+        emit: (type, payload, extra) => emit(type, threadId, payload, { turnId, ...extra }),
+        nextId,
+        takeSteered: () => (steeredInputs.get(threadId) ?? []).splice(0).join("\n"),
+        approve: (request) => openShellApproval({
+          requestId: request.requestId,
+          detail: request.detail,
+          signal,
+          nextItemId: () => nextId("item"),
+          pending: pendingDecisions,
+          emit: (type, payload, extra) => emit(type, threadId, payload, { turnId, ...extra })
+        })
+      });
+      finishTurn(
+        booked,
+        turnId,
+        signal.aborted || text === null ? "interrupted" : "completed",
+        text === null ? [] : [{ kind: "assistant", text }]
+      );
+      return;
+    }
     if (script === "approval-tool") {
       const finalText = await runApprovalToolScript(threadId, turnId, signal);
       finishTurn(
@@ -767,7 +1040,17 @@ var createFakeInstance = (config, host) => {
     sendTurn: async (input, signal) => {
       if (disposed) throw new Error("instance disposed");
       const booked = requireThread(input.threadId);
-      if (inflight.has(input.threadId)) throw new Error("turn already in flight");
+      const running = inflight.get(input.threadId);
+      const steered = acceptLaneSteer({
+        running,
+        enabled: script === "lane",
+        expectedTurnId: input.expectedTurnId,
+        text: input.input,
+        threadId: input.threadId,
+        steered: steeredInputs
+      });
+      if (steered !== null) return steered;
+      if (running !== void 0) throw new Error("turn already in flight");
       const turnId = input.expectedTurnId ?? nextId("turn");
       const turnAbort = new AbortController();
       const abortTurn = () => turnAbort.abort();
@@ -787,7 +1070,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" || script === "visualize") {
+      if (script === "approval-tool" || script === "stream" || script === "mcp-send" || script === "visualize" || script === "lane") {
         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.2944",
+  "version": "0.2.2948",
   "description": "Minimal fake executor for plugin authors and host orchestration tests.",
   "keywords": [
     "ycodium",
@@ -21,8 +21,8 @@
     "@types/node": "24.12.4",
     "esbuild": "0.28.1",
     "vite-plus": "0.2.2",
-    "@ycodium-ai/plugin-api": "0.2.2944",
-    "ycodium-executor-testing": "0.0.0"
+    "ycodium-executor-testing": "0.0.0",
+    "@ycodium-ai/plugin-api": "0.2.2948"
   },
   "ycodium": {
     "plugin": "./dist/index.js",