create-windy 0.8.2 → 0.9.1

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

@@ -0,0 +1,178 @@
+import type { ContextMessageNode } from "@deepseek-ai/dsh-client-ui-conversation/client";
+import { expect, test } from "bun:test";
+import { readFileSync } from "node:fs";
+import { runInNewContext } from "node:vm";
+type Node = {
+  type: unknown;
+  props: Record<string, unknown>;
+  children: unknown[];
+};
+type Component = (props: Record<string, unknown>) => Node;
+function fixture() {
+  const registrations = new Map<string, Component>();
+  const rawName = "mcp__windy__case_directory_summary_3ec3141a232e";
+  const createElement = (
+    type: unknown,
+    props: Record<string, unknown>,
+    ...children: unknown[]
+  ): Node => ({
+    type,
+    props: props || {},
+    children: children.flat(Infinity).filter(Boolean),
+  });
+  const original: Component = (props) => createElement("context", props);
+  const cleanups: (() => void)[] = [];
+  runInNewContext(
+    readFileSync(new URL("./client.js", import.meta.url), "utf8"),
+    {
+      document: { baseURI: "http://windy.test/agent/" },
+      URL,
+      AbortController,
+      fetch: async () => ({ ok: false }),
+      window: {
+        __WINDY_BUSINESS_RESULT_KEYS__: { [rawName]: "case.search" },
+        __WINDY_TOOL_DISPLAY__: [
+          { name: rawName, displayName: "案件数量与类型统计" },
+        ],
+        addEventListener: () => {},
+        removeEventListener: () => {},
+        __ModuleLoader__: {
+          load(module: {
+            factory(require: (name: string) => object): {
+              apply(ctx: unknown): void;
+            };
+          }) {
+            module
+              .factory((name) =>
+                name === "react"
+                  ? { createElement, useSyncExternalStore: () => 0 }
+                  : {
+                      DisclosureRow: "DisclosureRow",
+                      IconBrowseOutlineRegular: "Icon",
+                    },
+              )
+              .apply({
+                slots: {
+                  inject: (_name: string, register: () => () => void) => {
+                    const dispose = register();
+                    if (dispose) cleanups.push(dispose);
+                  },
+                  register: (
+                    options: { name: string; key: string },
+                    component: Component,
+                  ) => {
+                    registrations.set(
+                      `${options.name}:${options.key}`,
+                      component,
+                    );
+                    return () => {};
+                  },
+                  subscribe: () => () => {},
+                  entries: () => [
+                    {
+                      component: original,
+                      options: { key: "context" },
+                      locale: "chat",
+                    },
+                  ],
+                },
+              });
+          },
+        },
+      },
+    },
+  );
+  return { rawName, registrations, cleanups };
+}
+function visible(node: unknown): string {
+  if (typeof node === "string") return node;
+  if (!node || typeof node !== "object") return "";
+  const value = node as Node;
+  return [value.props?.title, ...value.children.map(visible)].join(" ");
+}
+test("historical calls and discovery selections use Chinese display names while persisted identifiers remain intact", () => {
+  const f = fixture();
+  const get = (key: string) =>
+    f.registrations.get(`tool.call.toolview:${key}`)!;
+  const call = Object.freeze({
+    argsRaw: JSON.stringify({ names: [f.rawName] }),
+  });
+  const disclosure = () => ({ expanded: true, toggle: () => {} });
+  const rendered = get("discover_business_tools")({
+    toolName: "discover_business_tools",
+    phase: "result",
+    block: {
+      call,
+      isError: false,
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({
+            loaded: [f.rawName],
+            items: [{ name: f.rawName }],
+          }),
+        },
+      ],
+    },
+    useDisclosure: disclosure,
+  });
+  expect(rendered.props.title).toBe("准备工具：案件数量与类型统计");
+  expect(visible(rendered)).toContain("案件数量与类型统计");
+  expect(visible(rendered)).not.toMatch(/mcp__|discover_business_tools|DSH/);
+  const business = get(f.rawName)({
+    toolName: f.rawName,
+    phase: "start",
+    block: { argsRaw: "{}" },
+    useDisclosure: disclosure,
+  });
+  expect(business.props.title).toBe("案件数量与类型统计");
+  expect(call.argsRaw).toContain(f.rawName);
+  for (const cleanup of f.cleanups) cleanup();
+});
+test("tool addition notices translate only a read-only UI copy and keep ordinary injected context", () => {
+  const f = fixture();
+  const context = f.registrations.get("conversation.chat.node:context")!;
+  const content = Object.freeze([
+    Object.freeze({ type: "tool-addition", toolName: f.rawName }),
+    Object.freeze({ type: "text", text: "原始材料保持原样" }),
+  ]);
+  const data = Object.freeze({
+    kind: "context",
+    seq: 7,
+    time: 1720000000000,
+    content,
+    source: { kind: "tool" },
+    producer: { role: "inject", label: "tool-update" },
+    form: null,
+  } satisfies ContextMessageNode);
+  const node = Object.freeze({ kind: "context", data });
+  const rendered = context({ node });
+  const translated = (
+    rendered.props.node as {
+      data: { content: { type: string; toolName?: string; text?: string }[] };
+    }
+  ).data.content;
+  expect(translated[0]!.toolName).toBe("案件数量与类型统计");
+  expect(translated[1]!.text).toBe("原始材料保持原样");
+  expect((content[0] as { toolName: string }).toolName).toBe(f.rawName);
+  expect(translated).not.toBe(content);
+  for (const cleanup of f.cleanups) cleanup();
+});
+
+test("business history uses the same concrete tool label and never labels a failed receipt completed", () => {
+  const f = fixture();
+  const view = f.registrations.get("tool.call.toolview:case.search")!;
+  const rendered = view({
+    toolName: "case.search",
+    phase: "result",
+    block: {
+      isError: true,
+      content: [{ type: "text", text: "运行已失败，未取得该调用结果" }],
+    },
+    useDisclosure: () => ({ expanded: true, toggle() {} }),
+  });
+  expect(rendered.props.title).toBe("案件数量与类型统计");
+  expect(visible(rendered.props.collapsedContent)).toContain("未完成");
+  expect(visible(rendered.props.collapsedContent)).not.toContain("调用完成");
+  for (const cleanup of f.cleanups) cleanup();
+});

package/template/apps/agent-server/plugins/tool-presentation/index.mjs

@@ -0,0 +1,10 @@
+export const name = "windy-tool-presentation";
+export function apply(ctx) {
+  ctx.on("webserver/index-inject", (table) =>
+    table.push({
+      kind: "global",
+      name: "__WINDY_BUSINESS_RESULT_KEYS__",
+      value: {},
+    }),
+  );
+}

package/template/apps/agent-server/plugins/tool-presentation/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@southwind-ai/dsh-tool-presentation",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "build:client": "bun build-client.ts"
+  },
+  "exports": {
+    ".": "./index.mjs",
+    "./client": "./client.js",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-chat",
+        "@deepseek-ai/dsh-client-ui-tool",
+        "@deepseek-ai/dsh-client-ui-primitives"
+      ]
+    }
+  }
+}

package/template/apps/agent-server/plugins/tool-presentation/result-discovery.mjs

@@ -0,0 +1,43 @@
+/** Display only names from the returned authorized catalogue or known tool metadata. */
+export function discoveryPresentation(value, resolveName = () => undefined) {
+  const items = Array.isArray(value?.items) ? value.items : [];
+  const metadata = [
+    ...items,
+    ...(Array.isArray(value?.loadedTools) ? value.loadedTools : []),
+  ];
+  const display = (name) => {
+    const title =
+      metadata.find((item) => item?.name === name)?.displayName ??
+      resolveName(name);
+    return typeof title === "string" &&
+      title.trim() &&
+      !/mcp__|discover_business_tools/.test(title)
+      ? title.trim().slice(0, 80)
+      : undefined;
+  };
+  const selected = Array.isArray(value?.loaded)
+    ? [
+        ...new Set(
+          value.loaded
+            .filter((name) => typeof name === "string")
+            .map(display)
+            .filter(Boolean),
+        ),
+      ].slice(0, 8)
+    : [];
+  const found = [
+    ...new Set(items.map((item) => display(item?.name)).filter(Boolean)),
+  ].slice(0, 6);
+  return {
+    label: selected.length
+      ? `可用工具：${selected.join("、")}`
+      : "查找业务工具",
+    summary: selected.length
+      ? ""
+      : found.length
+        ? `找到：${found.join("、")}`
+        : Array.isArray(value?.loaded) && value.loaded.length
+          ? `${value.loaded.length} 个授权工具可用。`
+          : "未找到匹配的业务工具。",
+  };
+}

package/template/apps/agent-server/plugins/tool-presentation/result-model.d.mts

@@ -0,0 +1,51 @@
+export interface BusinessResultChart {
+  id: string;
+  title: string;
+  variant: "bar" | "line" | "donut";
+  items: { name: string; value: number }[];
+  valueLabel: string;
+  unit: string;
+  sourceLabel: string;
+  scopeLabel: string;
+  coverage: { returned: number; total?: number; partial: boolean };
+  note?: string;
+}
+export interface BusinessResultEntity {
+  kind: string;
+  id: string;
+  name: string;
+  statusLabel: string;
+  href: string;
+  details: { label: string; value: string }[];
+}
+export interface BusinessToolResult {
+  label: string;
+  state:
+    | "running"
+    | "queued"
+    | "awaiting-approval"
+    | "awaiting-input"
+    | "completed"
+    | "returned"
+    | "failed"
+    | "cancelled";
+  statusLabel: string;
+  summary: string;
+  entities: BusinessResultEntity[];
+  charts?: BusinessResultChart[];
+  action?: { label: string; href: string };
+}
+export const businessResultTools: Record<string, [string, string]>;
+export function readToolResult(block: {
+  content?: readonly unknown[];
+}): Record<string, unknown> | undefined;
+export function projectToolResult(
+  toolKey: string,
+  phase: string,
+  block?: { content?: readonly unknown[]; isError?: boolean },
+): BusinessToolResult;
+
+export function discoveryPresentation(
+  value: unknown,
+  resolveName?: (name: string) => string | undefined,
+): { label: string; summary: string };

package/template/apps/agent-server/plugins/tool-presentation/result-model.mjs

@@ -0,0 +1,96 @@
+export { discoveryPresentation } from "./result-discovery.mjs";
+export const businessResultTools = {};
+const states = {
+  "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", "处理完成", "工具返回完成回执。"],
+};
+export function readToolResult(block) {
+  for (const part of block?.content ?? []) {
+    if (
+      part.type !== "text" ||
+      typeof part.text !== "string" ||
+      part.text.length > 1048576
+    )
+      continue;
+    try {
+      const raw =
+        block.isError && part.text.startsWith("Error: ")
+          ? part.text.slice(7)
+          : part.text;
+      let value;
+      try {
+        value = JSON.parse(raw);
+      } catch {
+        value = JSON.parse(raw.split("\n", 1)[0]);
+      }
+      if (value && typeof value === "object" && !Array.isArray(value))
+        return value;
+    } catch {
+      /* Unstructured text is not a completion receipt. */
+    }
+  }
+}
+export function projectToolResult(toolKey, phase, block = {}) {
+  const result = {
+    label: "工具处理",
+    state: "running",
+    statusLabel: phase === "preparing" ? "准备中" : "处理中",
+    summary: "等待工具返回。",
+    entities: [],
+  };
+  if (phase !== "result") return result;
+  const value = readToolResult(block);
+  const declared =
+    typeof value?.status === "string" && Object.hasOwn(states, value.status)
+      ? states[value.status]
+      : undefined;
+  if (block.isError)
+    return {
+      ...result,
+      state: "failed",
+      statusLabel: "处理失败",
+      summary: "工具未成功返回，请核对执行详情。",
+    };
+  if (declared) [result.state, result.statusLabel, result.summary] = declared;
+  else
+    Object.assign(result, {
+      state: "returned",
+      statusLabel: "调用完成",
+      summary: "",
+    });
+  if (
+    toolKey === "save_workflow_skill" &&
+    value?.status === "saved" &&
+    /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(value.name ?? "")
+  )
+    Object.assign(result, {
+      state: "completed",
+      statusLabel: "技能已保存",
+      summary: `调用名 /${value.name}，仅当前用户工作区可用。`,
+    });
+  return result;
+}

package/template/apps/agent-server/plugins/workspace/README.md

@@ -0,0 +1,5 @@
+# 工作区
+
+通用插件向官方 workspaceRegistry 注册“我的工作区”，名称来自 `project/host.ts`。会话、目录切换与文件交互复用官方界面。
+
+Windy通用层不包含案件目录、产品Copilot历史或领域范围选择。项目可通过额外公开DSH插件提供范围显示；元数据仅组织材料，不构成数据授权。业务工具每次调用仍由Host重新授权。

package/template/apps/agent-server/plugins/workspace/index.mjs

@@ -0,0 +1,8 @@
+export const name = "windy-workspaces";
+export const inject = ["workspaceRegistry"];
+export async function apply(ctx, config = {}) {
+  await ctx.workspaceRegistry.create(
+    process.cwd(),
+    config.label || "我的工作区",
+  );
+}

package/template/apps/agent-server/plugins/workspace/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "@southwind-ai/dsh-workspace",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "exports": {
+    ".": "./index.mjs",
+    "./package.json": "./package.json"
+  }
+}

package/template/apps/agent-server/plugins/workspace/style.css

@@ -0,0 +1,124 @@
+/* DSH publishes compiled component CSS; local slot styles use its semantic tokens. */
+.windy-workspace-picker.windy-workspace-picker {
+  width: min(640px, 100%);
+  max-height: 100%;
+  gap: 16px;
+  padding-bottom: 16px;
+  text-align: left;
+}
+.windy-workspace-picker-content {
+  min-height: 0;
+  overflow: hidden;
+}
+.windy-workspace-picker-content > :last-child {
+  min-height: 0;
+  margin-top: 16px;
+}
+.windy-workspace-body {
+  display: grid;
+  grid-template-rows: auto auto minmax(0, 1fr);
+  gap: 12px;
+  min-height: 0;
+}
+.windy-workspace-global.windy-workspace-global {
+  justify-content: flex-start;
+  width: 100%;
+  gap: 8px;
+}
+.windy-workspace-search {
+  width: 100%;
+  box-sizing: border-box;
+}
+.windy-workspace-results {
+  min-height: 80px;
+  max-height: 360px;
+  overflow: auto;
+  overscroll-behavior: contain;
+}
+.windy-workspace-list {
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+.windy-workspace-list > li + li {
+  border-top: 1px solid var(--dsw-alias-border-l2);
+}
+.windy-workspace-case.windy-workspace-case {
+  display: flex;
+  align-items: center;
+  justify-content: flex-start;
+  gap: 12px;
+  width: 100%;
+  height: auto;
+  min-height: 52px;
+  padding: 10px 8px;
+  text-align: left;
+  border-radius: var(--dsw-radius-sm);
+}
+.windy-workspace-case > svg,
+.windy-workspace-case > :last-child {
+  flex-shrink: 0;
+}
+.windy-workspace-case-copy {
+  flex: 1;
+  min-width: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+}
+.windy-workspace-case-name {
+  overflow-wrap: anywhere;
+  line-height: 20px;
+}
+.windy-workspace-case-number {
+  font-size: 12px;
+  line-height: 18px;
+  color: var(--dsw-alias-label-secondary);
+  overflow-wrap: anywhere;
+}
+.windy-workspace-footer {
+  display: flex;
+  align-items: center;
+  flex-wrap: wrap;
+  gap: 8px;
+  width: 100%;
+}
+.windy-workspace-count {
+  flex: 1;
+  color: var(--dsw-alias-label-secondary);
+  font-size: 12px;
+}
+.windy-workspace-pagination {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  white-space: nowrap;
+}
+.windy-workspace-page {
+  font-size: 12px;
+  font-variant-numeric: tabular-nums;
+  color: var(--dsw-alias-label-secondary);
+}
+.windy-workspace-state {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  flex-wrap: wrap;
+  gap: 8px;
+  padding: 20px 8px;
+  margin: 0;
+  font-size: 14px;
+  color: var(--dsw-alias-label-secondary);
+}
+.windy-workspace-error {
+  color: var(--dsw-alias-state-error-primary);
+}
+@media (max-width: 480px) {
+  .windy-workspace-case.windy-workspace-case {
+    flex-wrap: wrap;
+    gap: 6px;
+  }
+  .windy-workspace-case > :last-child {
+    margin-left: 22px;
+  }
+}

package/template/apps/agent-server/project/host.ts

@@ -0,0 +1,13 @@
+import type { DshHostConfiguration } from "../host-contracts.js";
+
+/** Project-owned composition: business instructions and plugins are supplied here. */
+export const projectHost: DshHostConfiguration = {
+  presetId: "windy",
+  assistantName: "Windy Agent",
+  assistantDescription: "处理授权资料、查询业务信息并交付可核验的工作成果。",
+  workspaceLabel: "我的工作区",
+  instructions: [],
+  skillDirectories: [],
+  plugins: [],
+  boundaryRoutes: [],
+};

package/template/apps/agent-server/runtime/artifacts.ts

@@ -0,0 +1,115 @@
+import sharp, { type OutputInfo } from "sharp";
+import { createHash } from "node:crypto";
+import { AttachmentId } from "@deepseek-ai/dsh-attachment";
+import type { ImageBlock } from "@deepseek-ai/dsh-llm";
+import type { RuntimeConfig } from "./config.js";
+import { SafeError, type RunRequest } from "./contracts.js";
+export interface PreparedImage {
+  block: ImageBlock;
+  dataUrl: string;
+}
+export async function prepareImages(
+  request: RunRequest,
+  config: RuntimeConfig,
+  signal: AbortSignal,
+): Promise<PreparedImage[]> {
+  if (!request.artifacts.length) return [];
+  const maxArtifacts = Number(request.limits.maxArtifacts ?? 0),
+    maxPixels = Number(request.limits.maxPixelsPerArtifact ?? 0);
+  if (!request.inputModalities.includes("image") || !maxArtifacts || !maxPixels)
+    throw new SafeError("INVALID_INPUT", "Operation 未授权图片输入");
+  if (request.artifacts.length > maxArtifacts)
+    throw new SafeError("BUDGET_EXCEEDED", "图片数量超过任务上限");
+  const endpoint = new URL(config.artifactUrl),
+    toolHost = new URL(config.toolHostUrl);
+  if (
+    endpoint.origin !== toolHost.origin ||
+    endpoint.username ||
+    endpoint.password ||
+    endpoint.search ||
+    endpoint.hash
+  )
+    throw new SafeError("FORBIDDEN", "图片下载入口不在授权范围", false, 403);
+  const result: PreparedImage[] = [];
+  let consumed = 0;
+  for (const artifact of request.artifacts) {
+    if (
+      !["image/jpeg", "image/png", "image/webp"].includes(artifact.mediaType) ||
+      artifact.byteSize < 1 ||
+      artifact.byteSize > request.limits.maxInputBytes - consumed
+    )
+      throw new SafeError("INVALID_INPUT", "图片类型或声明大小无效");
+    const response = await fetch(endpoint, {
+      signal,
+      redirect: "error",
+      headers: {
+        authorization: `Bearer ${config.internalToken}`,
+        "x-ai-artifact-ref": artifact.value,
+      },
+    });
+    if (
+      !response.ok ||
+      response.headers.get("content-type")?.split(";")[0] !==
+        artifact.mediaType ||
+      !response.body
+    ) {
+      await response.body?.cancel();
+      throw new SafeError("RUNTIME_UNAVAILABLE", "无法读取图片 Artifact", true);
+    }
+    const reader = response.body.getReader(),
+      chunks: Uint8Array[] = [];
+    let size = 0;
+    try {
+      for (;;) {
+        const chunk = await reader.read();
+        if (chunk.done) break;
+        size += chunk.value.length;
+        if (size > artifact.byteSize)
+          throw new SafeError("BUDGET_EXCEEDED", "图片内容超过声明大小");
+        chunks.push(chunk.value);
+      }
+    } finally {
+      await reader.cancel();
+    }
+    const raw = Buffer.concat(chunks);
+    if (
+      size !== artifact.byteSize ||
+      createHash("sha256").update(raw).digest("hex") !== artifact.sha256
+    )
+      throw new SafeError("INVALID_INPUT", "图片完整性校验失败");
+    let normalized: { data: Buffer; info: OutputInfo };
+    try {
+      normalized = await sharp(raw, {
+        limitInputPixels: Math.min(maxPixels, 100000000),
+        animated: false,
+        failOn: "warning",
+      })
+        .rotate()
+        .png()
+        .toBuffer({ resolveWithObject: true });
+    } catch {
+      throw new SafeError("INVALID_INPUT", "图片内容损坏或像素超过上限");
+    }
+    signal.throwIfAborted();
+    consumed += normalized.data.length;
+    if (consumed > request.limits.maxInputBytes)
+      throw new SafeError("BUDGET_EXCEEDED", "归一化图片总大小超过上限");
+    const attachmentId = AttachmentId(
+      createHash("sha256").update(normalized.data).digest("hex"),
+    );
+    result.push({
+      block: {
+        type: "image",
+        attachment: {
+          attachmentId,
+          mediaType: "image/png",
+          bytes: normalized.data.length,
+          width: normalized.info.width,
+          height: normalized.info.height,
+        },
+      },
+      dataUrl: `data:image/png;base64,${normalized.data.toString("base64")}`,
+    });
+  }
+  return result;
+}