weifuwu 0.57.0 → 0.58.0

package/dist/client/index.js

@@ -1584,6 +1584,133 @@ function auth(options) {
   };
 }
 
+// src/client/ai.ts
+var RECORD_LIMIT = 1e3;
+function aiStream(url, body, options) {
+  const controller = new AbortController();
+  const external = options?.signal;
+  if (external) {
+    if (external.aborted) controller.abort();
+    else external.addEventListener("abort", () => controller.abort(), { once: true });
+  }
+  const traceId = options?.traceId ?? randomId();
+  const record = options?.record !== false;
+  const events = [];
+  const done = (async () => {
+    let res;
+    try {
+      res = await fetch(url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "X-Trace-Id": traceId,
+          Accept: "text/event-stream",
+          ...options?.headers
+        },
+        body: JSON.stringify(body),
+        signal: controller.signal
+      });
+    } catch (err) {
+      if (controller.signal.aborted) return;
+      options?.onError?.({ code: "provider_error", message: err instanceof Error ? err.message : String(err) });
+      return;
+    }
+    if (!res.ok) {
+      options?.onError?.({
+        code: httpErrorCode(res.status),
+        message: `HTTP ${res.status} ${res.statusText}`
+      });
+      return;
+    }
+    try {
+      for await (const { name, data } of parseWfEvents(res.body)) {
+        if (controller.signal.aborted) return;
+        pushEvent(events, { name, data }, record);
+        dispatch(name, data, options ?? {});
+      }
+    } catch (err) {
+      if (controller.signal.aborted) return;
+      options?.onError?.({ code: "provider_error", message: err instanceof Error ? err.message : String(err) });
+    }
+  })();
+  return {
+    abort: () => controller.abort(),
+    done,
+    traceId,
+    events
+  };
+}
+function dispatch(name, data, o) {
+  switch (name) {
+    case "wf:token":
+      return o.onToken?.(data.text);
+    case "wf:tool_call":
+      return o.onToolCall?.(data);
+    case "wf:tool_result":
+      return o.onToolResult?.(data);
+    case "wf:tool_progress":
+      return o.onToolProgress?.(data);
+    case "wf:step":
+      return o.onStep?.(data);
+    case "wf:approval_request":
+      return o.onApproval?.(data);
+    case "wf:usage":
+      return o.onUsage?.(data);
+    case "wf:done":
+      return o.onDone?.(data);
+    case "wf:error":
+      return o.onError?.(data);
+    default:
+      return o.onEvent?.(name, data);
+  }
+}
+async function* parseWfEvents(stream) {
+  const reader = stream.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      buffer += decoder.decode(value, { stream: true });
+      const blocks = buffer.split("\n\n");
+      buffer = blocks.pop() ?? "";
+      for (const block of blocks) {
+        let name = "message";
+        let data = "";
+        for (const line of block.split("\n")) {
+          if (line.startsWith("event: ")) name = line.slice(7);
+          else if (line.startsWith("data: ")) data += line.slice(6);
+        }
+        if (!data) continue;
+        try {
+          yield { name, data: JSON.parse(data) };
+        } catch {
+        }
+      }
+    }
+  } finally {
+    reader.releaseLock();
+  }
+}
+function pushEvent(events, e, record) {
+  if (!record) return;
+  if (events.length >= RECORD_LIMIT) events.shift();
+  events.push(e);
+}
+function httpErrorCode(status) {
+  if (status === 401 || status === 403) return "auth_failed";
+  if (status === 429) return "rate_limited";
+  if (status >= 500) return "provider_error";
+  return "invalid_request";
+}
+function randomId() {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+  return `trace-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
+}
+
 // src/client/error-boundary.ts
 function ErrorBoundary(props, ctx) {
   let error = null;
@@ -1842,6 +1969,7 @@ export {
   Fragment,
   Portal,
   RouteView,
+  aiStream,
   api,
   asyncComponent,
   auth,

package/dist/components/ApprovalCard/ApprovalCard.d.ts

@@ -0,0 +1,30 @@
+import type { Component } from '../../client/vnode.ts';
+import type { WfApprovalRequest } from '../../ai/types.ts';
+/**
+ * ApprovalCard — 人工审批卡片（wf: 协议 §4.5 交互原语）
+ *
+ * 状态机：pending（待批，允许/拒绝 + 备注）→ approved / rejected / timeout（终态）。
+ * 纯受控组件：决策回传由 onApprove / onReject 上抛（app 负责 POST /approve）。
+ *
+ * ```tsx
+ * <ApprovalCard
+ *   request={approvalReq}
+ *   onApprove={() => respond('approved')}
+ *   onReject={(note) => respond('rejected', note)}
+ * />
+ * ```
+ */
+export type ApprovalStatus = 'pending' | 'approved' | 'rejected' | 'timeout';
+export interface ApprovalCardProps {
+    /** wf:approval_request 数据 */
+    request: WfApprovalRequest;
+    /** 卡片状态（默认 pending） */
+    status?: ApprovalStatus;
+    /** 用户点"允许" */
+    onApprove?: () => void;
+    /** 用户点"拒绝"，note 为可选备注（进 agent 上下文） */
+    onReject?: (note?: string) => void;
+    /** 自定义详情渲染（默认显示 name + args） */
+    renderDetail?: (request: WfApprovalRequest) => any;
+}
+export declare const ApprovalCard: Component<ApprovalCardProps>;

package/dist/components/ToolCallCard/ToolCallCard.d.ts

@@ -0,0 +1,23 @@
+import type { Component } from '../../client/vnode.ts';
+import type { WfToolCall, WfToolProgress, WfToolResult } from '../../ai/types.ts';
+/**
+ * ToolCallCard — 工具调用卡片（wf: 协议 §4 交互原语）
+ *
+ * 纯展示组件：接收协议事件数据 + 可选回调，无内部状态。
+ * 状态机：running（等待/执行中，带进度条）→ ok / error（有 result 时）。
+ *
+ * ```tsx
+ * <ToolCallCard call={toolCall} progress={progress} result={result} />
+ * ```
+ */
+export interface ToolCallCardProps {
+    /** wf:tool_call 数据 */
+    call: WfToolCall;
+    /** wf:tool_progress 数据（可选，展示进度条） */
+    progress?: WfToolProgress;
+    /** wf:tool_result 数据（可选，ok/error 终态） */
+    result?: WfToolResult;
+    /** 自定义参数渲染（默认 JSON.stringify） */
+    renderArgs?: (args: Record<string, unknown>) => any;
+}
+export declare const ToolCallCard: Component<ToolCallCardProps>;

package/dist/components/index.d.ts

@@ -92,3 +92,7 @@ export type { EditorProps, ToolbarItem } from './Editor/Editor.ts';
 export { ThemeSwitch } from './ThemeSwitch/ThemeSwitch.ts';
 export type { ThemeSwitchProps, ThemeMode } from './ThemeSwitch/ThemeSwitch.ts';
 export { applyTheme, getTheme } from './ThemeSwitch/ThemeSwitch.ts';
+export { ToolCallCard } from './ToolCallCard/ToolCallCard.ts';
+export type { ToolCallCardProps } from './ToolCallCard/ToolCallCard.ts';
+export { ApprovalCard } from './ApprovalCard/ApprovalCard.ts';
+export type { ApprovalCardProps, ApprovalStatus } from './ApprovalCard/ApprovalCard.ts';

package/dist/components/index.js

@@ -3084,9 +3084,94 @@ var ThemeSwitch = (initProps, ctx) => {
     }, segments);
   };
 };
+
+// src/components/ToolCallCard/ToolCallCard.ts
+var stateIcon = { running: "\u2699", ok: "\u2713", error: "\u2715" };
+var ToolCallCard = (_init, _ctx) => (props) => {
+  const { call, progress, result, renderArgs } = props;
+  const state = result ? result.ok ? "ok" : "error" : "running";
+  const argsNode = renderArgs ? renderArgs(call.args) : h("code", { class: "wf-toolcall-args" }, JSON.stringify(call.args));
+  const progressNode = progress ? [
+    progress.message ? h("div", { class: "wf-toolcall-msg" }, `${progress.message} (${progress.step}/${progress.total})`) : null,
+    h("div", { class: "wf-toolcall-bar", role: "progressbar", "aria-valuenow": progress.step, "aria-valuemax": progress.total }, [
+      h("div", {
+        class: "wf-toolcall-bar-fill",
+        style: { width: `${Math.min(100, progress.step / Math.max(1, progress.total) * 100)}%` }
+      })
+    ])
+  ] : null;
+  const errorNode = result && !result.ok && result.error ? h("div", { class: "wf-toolcall-error" }, `${result.error.code}: ${result.error.message}`) : null;
+  return h("div", { class: `wf-toolcall wf-toolcall--${state}` }, [
+    h("div", { class: "wf-toolcall-header" }, [
+      h("span", { class: `wf-toolcall-icon wf-toolcall-icon--${state}` }, stateIcon[state]),
+      h("span", { class: "wf-toolcall-name" }, call.name)
+    ]),
+    h("div", { class: "wf-toolcall-body" }, [argsNode, progressNode, errorNode].filter(Boolean))
+  ]);
+};
+
+// src/components/ApprovalCard/ApprovalCard.ts
+var statusText = {
+  pending: "\u7B49\u5F85\u5BA1\u6279",
+  approved: "\u5DF2\u6279\u51C6",
+  rejected: "\u5DF2\u62D2\u7EDD",
+  timeout: "\u5BA1\u6279\u8D85\u65F6"
+};
+var ApprovalCard = (_init, ctx) => {
+  let note = "";
+  let showNote = false;
+  return (props) => {
+    const { request, status = "pending", onApprove, onReject, renderDetail } = props;
+    const detail = renderDetail ? renderDetail(request) : [
+      h("div", { class: "wf-approval-name" }, request.name),
+      h("code", { class: "wf-approval-args" }, JSON.stringify(request.args))
+    ];
+    const actions = status === "pending" ? h("div", { class: "wf-approval-actions" }, [
+      showNote ? h("div", { class: "wf-approval-note" }, [
+        h("input", {
+          class: "wf-approval-note-input",
+          placeholder: "\u5907\u6CE8\uFF08\u62D2\u7EDD\u539F\u56E0\uFF0C\u5C06\u8FDB\u5165 agent \u4E0A\u4E0B\u6587\uFF09\u2026",
+          value: note,
+          onInput: (e) => {
+            note = e.target.value;
+          }
+        })
+      ]) : null,
+      h("div", { class: "wf-approval-btns" }, [
+        h("button", {
+          class: "wf-btn wf-btn--primary wf-btn--sm",
+          type: "button",
+          onClick: () => onApprove?.()
+        }, "\u5141\u8BB8"),
+        h("button", {
+          class: "wf-btn wf-btn--danger wf-btn--sm",
+          type: "button",
+          onClick: () => {
+            if (!showNote) {
+              showNote = true;
+              ctx.ui.render();
+              return;
+            }
+            onReject?.(note);
+          }
+        }, showNote ? "\u786E\u8BA4\u62D2\u7EDD" : "\u62D2\u7EDD")
+      ])
+    ].filter(Boolean)) : h("div", { class: `wf-approval-status wf-approval-status--${status}` }, statusText[status]);
+    return h("div", { class: `wf-approval wf-approval--${status}` }, [
+      h("div", { class: "wf-approval-header" }, [
+        h("span", { class: "wf-approval-icon" }, status === "pending" ? "\u23F8" : status === "approved" ? "\u2713" : "\u2715"),
+        h("span", { class: "wf-approval-title" }, "\u5DE5\u5177\u5BA1\u6279")
+      ]),
+      h("div", { class: "wf-approval-detail" }, detail),
+      request.reason ? h("div", { class: "wf-approval-reason" }, request.reason) : null,
+      actions
+    ]);
+  };
+};
 export {
   Accordion,
   Alert,
+  ApprovalCard,
   Avatar,
   Badge,
   Breadcrumb,
@@ -3127,6 +3212,7 @@ export {
   Textarea,
   ThemeSwitch,
   Toast,
+  ToolCallCard,
   Tooltip,
   applyTheme,
   confirm,

package/dist/components/style.css

@@ -3617,3 +3617,141 @@ code {
   cursor: not-allowed;
 }
 
+/* weifuwu/components — ToolCallCard */
+
+.wf-toolcall {
+  border: 1px solid var(--wf-color-border);
+  border-radius: var(--wf-radius);
+  padding: var(--wf-space) var(--wf-space-md);
+  font-family: var(--wf-font-sans);
+  font-size: var(--wf-font-size-sm);
+  line-height: var(--wf-line-height);
+  background: var(--wf-color-bg-tertiary);
+}
+
+.wf-toolcall-header {
+  display: flex;
+  align-items: center;
+  gap: var(--wf-gap-xs);
+  margin-bottom: var(--wf-gap-xs);
+}
+
+.wf-toolcall-icon { font-size: var(--wf-font-size-sm); }
+
+.wf-toolcall-icon--running { color: var(--wf-color-info); }
+.wf-toolcall-icon--ok { color: var(--wf-color-success); }
+.wf-toolcall-icon--error { color: var(--wf-color-error); }
+
+.wf-toolcall-name {
+  font-weight: var(--wf-font-weight-semibold);
+  color: var(--wf-color-text);
+}
+
+.wf-toolcall-args {
+  color: var(--wf-color-text-secondary);
+  font-size: var(--wf-font-size-xs);
+  word-break: break-all;
+}
+
+.wf-toolcall-msg {
+  color: var(--wf-color-text-secondary);
+  font-size: var(--wf-font-size-xs);
+  margin-top: var(--wf-gap-xs);
+}
+
+.wf-toolcall-bar {
+  height: 4px;
+  border-radius: 2px;
+  background: var(--wf-color-bg-tertiary);
+  overflow: hidden;
+  margin-top: var(--wf-gap-xs);
+}
+
+.wf-toolcall-bar-fill {
+  height: 100%;
+  background: var(--wf-color-info);
+  transition: width var(--wf-transition);
+}
+
+.wf-toolcall-error {
+  color: var(--wf-color-error);
+  font-size: var(--wf-font-size-xs);
+  margin-top: var(--wf-gap-xs);
+}
+
+/* weifuwu/components — ApprovalCard */
+
+.wf-approval {
+  border: 1px solid var(--wf-color-warning);
+  border-radius: var(--wf-radius);
+  padding: var(--wf-space) var(--wf-space-md);
+  font-family: var(--wf-font-sans);
+  font-size: var(--wf-font-size-sm);
+  line-height: var(--wf-line-height);
+  background: var(--wf-color-warning-bg);
+}
+
+.wf-approval--approved { border-color: var(--wf-color-success); background: var(--wf-color-success-bg); }
+.wf-approval--rejected { border-color: var(--wf-color-error); background: var(--wf-color-error-bg); }
+.wf-approval--timeout { border-color: var(--wf-color-border); background: var(--wf-color-bg-tertiary); }
+
+.wf-approval-header {
+  display: flex;
+  align-items: center;
+  gap: var(--wf-gap-xs);
+  font-weight: var(--wf-font-weight-semibold);
+  color: var(--wf-color-warning);
+}
+
+.wf-approval--approved .wf-approval-header { color: var(--wf-color-success); }
+.wf-approval--rejected .wf-approval-header { color: var(--wf-color-error); }
+.wf-approval--timeout .wf-approval-header { color: var(--wf-color-text-secondary); }
+
+.wf-approval-detail {
+  margin-top: var(--wf-gap-xs);
+  color: var(--wf-color-text);
+}
+
+.wf-approval-name { font-weight: var(--wf-font-weight-medium); }
+
+.wf-approval-args {
+  color: var(--wf-color-text-secondary);
+  font-size: var(--wf-font-size-xs);
+  word-break: break-all;
+}
+
+.wf-approval-reason {
+  color: var(--wf-color-text-secondary);
+  font-size: var(--wf-font-size-xs);
+  margin-top: var(--wf-gap-xs);
+}
+
+.wf-approval-actions {
+  margin-top: var(--wf-gap-sm);
+  display: flex;
+  flex-direction: column;
+  gap: var(--wf-gap-xs);
+}
+
+.wf-approval-btns {
+  display: flex;
+  gap: var(--wf-gap-xs);
+}
+
+.wf-approval-note-input {
+  width: 100%;
+  box-sizing: border-box;
+  font-family: var(--wf-font-sans);
+  font-size: var(--wf-font-size-xs);
+  padding: var(--wf-control-pad-y) var(--wf-space);
+  border: var(--wf-border-width) solid var(--wf-color-border);
+  border-radius: var(--wf-radius);
+  color: var(--wf-color-text);
+}
+
+.wf-approval-status {
+  margin-top: var(--wf-gap-xs);
+  font-size: var(--wf-font-size-xs);
+  color: var(--wf-color-text-secondary);
+}
+

package/dist/index.d.ts

@@ -21,6 +21,9 @@ export { userSystem } from './user/index.ts';
 export type { UserSystemOptions, UserInjected, AuthApi, RegisterInput } from './user/index.ts';
 export { queue } from './queue/index.ts';
 export type { QueueOptions, QueueClient, QueueInjected, QueueWorker, WorkerOptions, AddOptions, Job } from './queue/index.ts';
+export { ai } from './ai/index.ts';
+export type { AiOptions, AiInjected, AiClient, AiClientModule, ChatResponse, AgentConfig, AgentTool, AgentRunner, ToolContext, } from './ai/index.ts';
+export type { WfStreamEvent, WfMessageStart, WfToken, WfUsage, WfDone, WfError, WfErrorCode, WfToolCall, WfToolResult, WfToolProgress, WfStep, WfApprovalRequest, WfApprovalResponse, WfApprovalDecision, ChatMessage, ChatParams, MessageRole, ToolCall, ToolDefinition, } from './ai/types.ts';
 export { ui } from './ui/index.ts';
 export { uiSsr } from './ui/ssr-page.ts';
 export type { UiSsrOptions } from './ui/ssr-page.ts';