create-windy 0.8.3 → 0.9.1

package/template/apps/agent-server/plugins/tool-catalog/use-tool.test.ts

@@ -0,0 +1,160 @@
+import { expect, test } from "bun:test";
+import { readFileSync } from "node:fs";
+import { runInNewContext } from "node:vm";
+
+type Client = {
+  useToolInConversation(
+    ctx: unknown,
+    tool: unknown,
+    close: () => void,
+  ): Promise<void>;
+};
+function client() {
+  let result!: Client;
+  runInNewContext(readFileSync(new URL("client.js", import.meta.url), "utf8"), {
+    window: {
+      __ModuleLoader__: {
+        load: (definition: { factory(require: () => object): Client }) => {
+          result = definition.factory(() => ({}));
+        },
+      },
+    },
+  });
+  return result;
+}
+const tool = {
+  name: "mcp__windy__case_search_internal",
+  displayName: "查询案件",
+  categoryLabel: "案件",
+};
+function fixture(draft = "已有材料 @原件.pdf") {
+  const calls: string[] = [];
+  let scopeId = "current";
+  let insertion:
+    | { text: string; span: { start: number; end: number; draftRev: number } }
+    | undefined;
+  const state = { draft, draftRev: 9, phase: "plain" };
+  const scope = {
+    bail(_scope: unknown, event: string, request: typeof insertion) {
+      calls.push(event);
+      insertion = request;
+      return true;
+    },
+  };
+  const ctx = {
+    sessions: {
+      list: {
+        getSnapshot: () => ({
+          byId: { [scopeId]: { id: scopeId, retainedBy: { mainView: 1 } } },
+        }),
+      },
+      using: async (
+        id: string,
+        options: { source: string },
+        run: (reference: {
+          ready: Promise<{ ctx: typeof scope }>;
+        }) => Promise<void>,
+      ) => {
+        expect(id).toBe("current");
+        expect(options.source).toBe("controllerOperation");
+        calls.push("retain");
+        try {
+          await run({ ready: Promise.resolve({ ctx: scope }) });
+        } finally {
+          calls.push("release");
+        }
+      },
+    },
+    conversation: {
+      input: {
+        for: (subject: unknown) => {
+          expect(subject).toBe(scope);
+          return {
+            state: { getSnapshot: () => state },
+            focus: () => calls.push("focus"),
+          };
+        },
+      },
+    },
+    uiWorkspace: {
+      openSession: (id: string) => calls.push(`open:${id}`),
+      startSession: () => {
+        throw Error("must not create another conversation");
+      },
+    },
+  };
+  return {
+    ctx,
+    calls,
+    state,
+    insertion: () => insertion,
+    switchSession: () => {
+      scopeId = "different";
+    },
+  };
+}
+test("card appends a Chinese intent to the exact current draft without sending or clearing references", async () => {
+  const f = fixture();
+  await client().useToolInConversation(f.ctx, tool, () =>
+    f.calls.push("close"),
+  );
+  expect(f.insertion()).toEqual({
+    text: `\n\n请使用「查询案件」（案件）处理当前研判任务；请先确认所需信息和当前范围，参数不齐时向我询问。`,
+    span: {
+      start: f.state.draft.length,
+      end: f.state.draft.length,
+      draftRev: 9,
+    },
+  });
+  expect(f.state.draft).toBe("已有材料 @原件.pdf");
+  expect(f.insertion()?.text).not.toContain("mcp__");
+  expect(f.calls).toEqual([
+    "retain",
+    "slash/input-insert-text",
+    "open:current",
+    "close",
+    "focus",
+    "release",
+  ]);
+});
+test("busy drafts and navigation races never write to the old or a different conversation", async () => {
+  const busy = fixture();
+  busy.state.phase = "submitting";
+  await expect(
+    client().useToolInConversation(busy.ctx, tool, () => {}),
+  ).rejects.toThrow("输入框正在处理");
+  expect(busy.insertion()).toBeUndefined();
+  const switched = fixture();
+  const original = switched.ctx.sessions.using;
+  switched.ctx.sessions.using = (...args) => {
+    switched.switchSession();
+    return original(...args);
+  };
+  await expect(
+    client().useToolInConversation(switched.ctx, tool, () => {}),
+  ).rejects.toThrow("当前对话已切换");
+  expect(switched.insertion()).toBeUndefined();
+  expect(switched.calls).not.toContain("open:current");
+});
+test("without a current session the existing workspace flow prepares an unsent draft with no forced scope", async () => {
+  let options: unknown;
+  let closed = false;
+  await client().useToolInConversation(
+    {
+      sessions: { list: { getSnapshot: () => ({ byId: {} }) } },
+      uiWorkspace: {
+        startSession: (workspace: unknown, value: unknown) => {
+          expect(workspace).toBeUndefined();
+          options = value;
+        },
+      },
+    },
+    tool,
+    () => {
+      closed = true;
+    },
+  );
+  expect(options).toMatchObject({ clearPreviousDraft: false });
+  expect((options as { prompt: string }).prompt).toContain("查询案件");
+  expect(closed).toBe(true);
+});

package/template/apps/agent-server/plugins/tool-presentation/README.md

@@ -0,0 +1,7 @@
+# 工具结果呈现
+
+通过公开tool.call.toolview插槽显示当前授权目录的中文名称、工具发现选择及真实结果状态。执行名称、参数与持久记录保持原值。
+
+通用层只识别明确的审批、排队、失败、取消和完成回执；不从领域DTO猜测业务保存、实体详情链接或图表。领域结果呈现由项目插件注册。工具成功返回不等于后续业务完成。
+
+`build-client.ts` 从通用投影源码生成 `client.results.js` 并更新主入口revision；部署时整体发布插件目录。

package/template/apps/agent-server/plugins/tool-presentation/build-client.ts

@@ -0,0 +1,29 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { createHash } from "node:crypto";
+const root = import.meta.dir;
+const revisions: string[] = [];
+for (const [entry, chunk] of [
+  ["result-model.mjs", "client.results.js"],
+] as const) {
+  const built = await Bun.build({
+    entrypoints: [`${root}/${entry}`],
+    target: "browser",
+    format: "cjs",
+    minify: true,
+  });
+  if (!built.success) throw new Error(built.logs.map(String).join("\n"));
+  const bundle = await built.outputs[0]!.text();
+  const sourceDigest = createHash("sha256").update(bundle).digest("hex");
+  const source = `// Generated by build-client.ts from ${entry} and its imports.\n// Bundle SHA256: ${sourceDigest}\n/* eslint-disable */\n// prettier-ignore\nwindow.__ModuleLoader__.load({id:"@southwind-ai/dsh-tool-presentation/${chunk}",factory(){const module={exports:{}};\n${bundle}\nreturn module.exports;}});\n`;
+  await writeFile(`${root}/${chunk}`, source);
+  revisions.push(createHash("sha256").update(source).digest("hex"));
+}
+const revision = createHash("sha256")
+  .update(revisions.join(":"))
+  .digest("hex")
+  .slice(0, 16);
+const main = await readFile(`${root}/client.js`, "utf8");
+await writeFile(
+  `${root}/client.js`,
+  `// Result module revision: ${revision}\n${main.replace(/^\/\/ Result module revision: [^\n]+\n/, "")}`,
+);

package/template/apps/agent-server/plugins/tool-presentation/client.js

@@ -0,0 +1,312 @@
+// Result module revision: b3376111b7e7f0ff
+window.__ModuleLoader__.load({
+  id: "@southwind-ai/dsh-tool-presentation",
+  factory(require) {
+    const React = require("react"),
+      h = React.createElement;
+    const {
+      DisclosureRow,
+      IconBrowseOutlineRegular,
+    } = require("@deepseek-ai/dsh-client-ui-primitives");
+    const labels = new Map([["discover_business_tools", "查找业务工具"]]);
+    const listeners = new Set();
+    let revision = 0;
+    let projectResult, discoveryPresentation, readResult;
+    require
+      .async?.("./client.results.js")
+      .then((module) => {
+        projectResult = module.projectToolResult;
+        discoveryPresentation = module.discoveryPresentation;
+        readResult = module.readToolResult;
+        revision++;
+        for (const listener of listeners) listener();
+      })
+      .catch(() => {});
+    for (const item of window.__WINDY_TOOL_DISPLAY__ || []) {
+      labels.set(item.name, item.displayName || "业务查询工具");
+      const key = window.__WINDY_BUSINESS_RESULT_KEYS__?.[item.name];
+      if (key) labels.set(key, item.displayName || "业务查询工具");
+    }
+    const label = (name) =>
+      labels.get(name) ||
+      labels.get(
+        `mcp__windy__${String(name).replace(/[^A-Za-z0-9_-]/g, "_")}`,
+      ) ||
+      (/^[a-z][a-z0-9-]*(?:\.[a-z0-9-]+)+$/.test(name) ? name : "") ||
+      (String(name).startsWith("mcp__windy__") ? "业务查询工具" : "工作区工具");
+    function useLabels() {
+      React.useSyncExternalStore(
+        (listener) => {
+          listeners.add(listener);
+          return () => listeners.delete(listener);
+        },
+        () => revision,
+      );
+    }
+    function argsOf(block) {
+      try {
+        return JSON.parse(block.call?.argsRaw || block.argsRaw || "{}");
+      } catch {
+        return {};
+      }
+    }
+    function ToolView({ toolName, phase, block, useDisclosure }) {
+      useLabels();
+      const { expanded, toggle } = useDisclosure();
+      const args = argsOf(block),
+        discovering = toolName === "discover_business_tools";
+      const names = Array.isArray(args.names)
+        ? args.names.map(label).join("、")
+        : "";
+      const summary = discovering
+        ? names
+          ? `选择：${names}`
+          : args.query
+            ? `搜索：${String(args.query).slice(0, 60)}`
+            : "查找可用的业务工具"
+        : toolName.startsWith("mcp__windy__")
+          ? "查询获准访问的业务资料"
+          : "处理获准使用的工作区材料";
+      const complete = phase === "result",
+        failed = complete && block.isError;
+      const keys = window.__WINDY_BUSINESS_RESULT_KEYS__ ?? {};
+      const businessKey = Object.hasOwn(keys, toolName)
+        ? keys[toolName]
+        : toolName;
+      const receipt = projectResult?.(businessKey, phase, block);
+      const status = failed
+        ? "未完成"
+        : (receipt?.statusLabel ?? (complete ? "调用完成" : "正在处理"));
+      let result, discovery;
+      if (complete && discovering && !failed) {
+        discovery = discoveryPresentation?.(readResult?.(block), (name) =>
+          labels.get(name),
+        );
+        result = discovery?.summary;
+      } else if (complete)
+        result = (block.content || [])
+          .filter((part) => part.type === "text")
+          .map((part) => part.text)
+          .join("\n");
+      const row = h(
+        DisclosureRow,
+        {
+          icon: h(IconBrowseOutlineRegular, { size: 14 }),
+          title:
+            discovery?.label ??
+            (discovering && names ? `准备工具：${names}` : label(toolName)),
+          open: expanded,
+          expandable: true,
+          onToggle: toggle,
+          running: !complete,
+          collapsedContent: h(
+            "span",
+            {
+              style:
+                complete &&
+                !failed &&
+                (!receipt || ["returned", "completed"].includes(receipt.state))
+                  ? {
+                      color: "var(--dsw-alias-state-success-primary)",
+                      background: "var(--dsw-alias-state-success-tertiary)",
+                      borderRadius: 12,
+                      padding: "2px 8px",
+                    }
+                  : {},
+            },
+            status,
+          ),
+        },
+        h(
+          "div",
+          { style: { fontSize: 13, lineHeight: "20px", padding: "8px 0" } },
+          (discovery?.summary || receipt?.summary || (!complete && summary)) &&
+            h(
+              "p",
+              { role: "status" },
+              discovery?.summary || receipt?.summary || summary,
+            ),
+          receipt?.action &&
+            h(
+              "a",
+              {
+                href: receipt.action.href,
+                target: "_blank",
+                rel: "noopener noreferrer",
+              },
+              receipt.action.label,
+            ),
+          ...(receipt?.entities ?? []).map((entity) =>
+            h(
+              "section",
+              {
+                key: entity.id,
+                style: {
+                  borderTop: "1px solid var(--dsw-alias-border-l3)",
+                  marginTop: 8,
+                  paddingTop: 8,
+                },
+              },
+              h(
+                "a",
+                {
+                  href: entity.href,
+                  target: "_blank",
+                  rel: "noopener noreferrer",
+                },
+                h("strong", null, entity.name),
+              ),
+              h("span", { style: { marginLeft: 8 } }, entity.statusLabel),
+              ...entity.details.map((detail) =>
+                h(
+                  "p",
+                  {
+                    key: detail.label,
+                    style: { whiteSpace: "pre-wrap", overflowWrap: "anywhere" },
+                  },
+                  `${detail.label}：${detail.value}`,
+                ),
+              ),
+            ),
+          ),
+          complete &&
+            !receipt?.entities?.length &&
+            !receipt?.action &&
+            (!receipt || receipt.state === "returned") &&
+            !discovery &&
+            h(
+              "pre",
+              {
+                style: {
+                  whiteSpace: "pre-wrap",
+                  overflowWrap: "anywhere",
+                  maxHeight: 320,
+                  overflow: "auto",
+                },
+              },
+              result || status,
+            ),
+        ),
+      );
+      return row;
+    }
+    function afterEntry(ctx, slot, key, install) {
+      ctx.slots.inject(slot, () => {
+        let original, dispose;
+        const reconcile = () => {
+          const next = ctx.slots
+            .entries(slot)
+            .find(
+              (entry) =>
+                (entry.options.key || entry.options.id) === key &&
+                entry.options.priority !== -100,
+            );
+          if (next === original) return;
+          dispose?.();
+          original = next;
+          dispose = next ? install(next) : undefined;
+        };
+        const off = ctx.slots.subscribe(slot, reconcile);
+        reconcile();
+        return () => {
+          off();
+          dispose?.();
+        };
+      });
+    }
+    return {
+      inject: ["slots"],
+      apply(ctx) {
+        const registered = new Map();
+        const registerTool = (name) => {
+          if (registered.has(name)) return;
+          registered.set(
+            name,
+            ctx.slots.register(
+              { name: "tool.call.toolview", key: name, priority: -100 },
+              ToolView,
+            ),
+          );
+        };
+        ctx.slots.inject("tool.call.toolview", () => {
+          registerTool("discover_business_tools");
+          const preserved = new Set([
+            "read",
+            "read_image",
+            "write",
+            "edit",
+            "glob",
+            "grep",
+            "bash",
+            "skill",
+            "ask_user_question",
+            "todo_write",
+            "present",
+            "subagent",
+            "send_message",
+            "interrupt_agent",
+          ]);
+          for (const item of window.__WINDY_TOOL_DISPLAY__ || []) {
+            if (!preserved.has(item.name)) registerTool(item.name);
+            const key = window.__WINDY_BUSINESS_RESULT_KEYS__?.[item.name];
+            if (key) registerTool(key);
+          }
+          const controller = new AbortController();
+          const refresh = async () => {
+            try {
+              const response = await fetch(
+                new URL("windy/tool-catalog?display=all", document.baseURI),
+                { credentials: "same-origin", signal: controller.signal },
+              );
+              if (!response.ok) return;
+              const data = await response.json();
+              for (const item of data.items || []) {
+                labels.set(item.name, item.displayName || "业务查询工具");
+                if (!preserved.has(item.name)) registerTool(item.name);
+              }
+              revision++;
+              for (const listener of listeners) listener();
+            } catch {
+              /* Keep the initial Chinese labels when metadata cannot refresh. */
+            }
+          };
+          void refresh();
+          window.addEventListener("focus", refresh);
+          return () => {
+            controller.abort();
+            window.removeEventListener("focus", refresh);
+            for (const dispose of registered.values()) dispose();
+            registered.clear();
+          };
+        });
+        afterEntry(ctx, "conversation.chat.node", "context", (original) => {
+          function ContextView(props) {
+            useLabels();
+            const content = props.node.data.content;
+            const translated = content.map((part) =>
+              part.type === "tool-addition" || part.type === "tool-removal"
+                ? { ...part, toolName: label(part.toolName) }
+                : part,
+            );
+            return h(original.component, {
+              ...props,
+              node: {
+                ...props.node,
+                data: { ...props.node.data, content: translated },
+              },
+            });
+          }
+          return ctx.slots.register(
+            {
+              name: "conversation.chat.node",
+              key: "context",
+              priority: -100,
+              locale: original.locale,
+            },
+            ContextView,
+          );
+        });
+      },
+    };
+  },
+});

package/template/apps/agent-server/plugins/tool-presentation/client.results.js

@@ -0,0 +1,9 @@
+// Generated by build-client.ts from result-model.mjs and its imports.
+// Bundle SHA256: 9cc75903960e89845c8c178979d39ea6ab5ec321a071391f683e3e1a62b88683
+/* eslint-disable */
+// prettier-ignore
+window.__ModuleLoader__.load({id:"@southwind-ai/dsh-tool-presentation/client.results.js",factory(){const module={exports:{}};
+var{defineProperty:s,getOwnPropertyNames:$,getOwnPropertyDescriptor:B}=Object,S=Object.prototype.hasOwnProperty;function c(n){return this[n]}var j=(n)=>{var i=(e??=new WeakMap).get(n),d;if(i)return i;if(i=s({},"__esModule",{value:!0}),n&&typeof n==="object"||typeof n==="function"){for(var o of $(n))if(!S.call(i,o))s(i,o,{get:c.bind(n,o),enumerable:!(d=B(n,o))||d.enumerable})}return e.set(n,i),i},e;var w=(n)=>n;function z(n,i){this[n]=w.bind(null,i)}var D=(n,i)=>{for(var d in i)s(n,d,{get:i[d],enumerable:!0,configurable:!0,set:z.bind(i,d)})};var T={};D(T,{readToolResult:()=>_,projectToolResult:()=>P,discoveryPresentation:()=>g,businessResultTools:()=>N});module.exports=j(T);function g(n,i=()=>{return}){let d=Array.isArray(n?.items)?n.items:[],o=[...d,...Array.isArray(n?.loadedTools)?n.loadedTools:[]],t=(r)=>{let y=o.find((h)=>h?.name===r)?.displayName??i(r);return typeof y==="string"&&y.trim()&&!/mcp__|discover_business_tools/.test(y)?y.trim().slice(0,80):void 0},m=Array.isArray(n?.loaded)?[...new Set(n.loaded.filter((r)=>typeof r==="string").map(t).filter(Boolean))].slice(0,8):[],f=[...new Set(d.map((r)=>t(r?.name)).filter(Boolean))].slice(0,6);return{label:m.length?`可用工具：${m.join("、")}`:"查找业务工具",summary:m.length?"":f.length?`找到：${f.join("、")}`:Array.isArray(n?.loaded)&&n.loaded.length?`${n.loaded.length} 个授权工具可用。`:"未找到匹配的业务工具。"}}var N={},A={"waiting-approval":["awaiting-approval","待审批","尚未执行，审批通过后仍需继续原请求。"],"awaiting-approval":["awaiting-approval","待审批","尚未执行，审批通过后仍需继续原请求。"],APPROVAL_PENDING:["awaiting-approval","待审批","尚未执行。"],APPROVAL_DENIED:["failed","审批未通过","本次操作未执行。"],"needs-input":["awaiting-input","待补充信息","请补充必要信息后继续。"],"waiting-input":["awaiting-input","待补充信息","请补充必要信息后继续。"],"awaiting-confirmation":["awaiting-input","待确认","请核对方案后继续。"],queued:["queued","排队中","任务已进入队列。"],pending:["queued","待处理","任务已受理，尚未完成。"],running:["running","处理中","完成后以正式回执为准。"],submitted:["queued","已提交","已提交后续处理，尚未完成。"],failed:["failed","处理失败","本次操作未成功完成。"],error:["failed","处理失败","本次操作未成功完成。"],cancelled:["cancelled","已取消","本次操作已取消。"],canceled:["cancelled","已取消","本次操作已取消。"],"timed-out":["failed","已超时","请核对当前任务状态。"],succeeded:["completed","处理完成","工具返回成功回执。"],completed:["completed","处理完成","工具返回完成回执。"]};function _(n){for(let i of n?.content??[]){if(i.type!=="text"||typeof i.text!=="string"||i.text.length>1048576)continue;try{let d=n.isError&&i.text.startsWith("Error: ")?i.text.slice(7):i.text,o;try{o=JSON.parse(d)}catch{o=JSON.parse(d.split(`
+`,1)[0])}if(o&&typeof o==="object"&&!Array.isArray(o))return o}catch{}}}function P(n,i,d={}){let o={label:"工具处理",state:"running",statusLabel:i==="preparing"?"准备中":"处理中",summary:"等待工具返回。",entities:[]};if(i!=="result")return o;let t=_(d),m=typeof t?.status==="string"&&Object.hasOwn(A,t.status)?A[t.status]:void 0;if(d.isError)return{...o,state:"failed",statusLabel:"处理失败",summary:"工具未成功返回，请核对执行详情。"};if(m)[o.state,o.statusLabel,o.summary]=m;else Object.assign(o,{state:"returned",statusLabel:"调用完成",summary:""});if(n==="save_workflow_skill"&&t?.status==="saved"&&/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(t.name??""))Object.assign(o,{state:"completed",statusLabel:"技能已保存",summary:`调用名 /${t.name}，仅当前用户工作区可用。`});return o}
+
+return module.exports;}});