npm - @qfei-design/make-ai-assistant - Versions diffs - 0.2.9 → 0.2.11 - Mend

@qfei-design/make-ai-assistant 0.2.9 → 0.2.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (38) hide show

package/PUBLIC_API.md +17 -23
package/README.md +12 -24
package/capabilities.json +36 -9
package/dist/conversation-CZfbgCXd.js +1111 -0
package/dist/conversation-Cvh-IVRV.cjs +1 -0
package/dist/core/conversation-management.d.ts +212 -0
package/dist/core/conversation.d.ts +34 -2
package/dist/core/index.d.ts +2 -0
package/dist/core/response-state.d.ts +8 -0
package/dist/index.cjs +1 -1
package/dist/index.mjs +4 -4
package/dist/make-app/protocol.d.ts +27 -0
package/dist/make-app/stream.d.ts +20 -0
package/dist/make-app.cjs +1 -1
package/dist/make-app.d.ts +46 -11
package/dist/make-app.mjs +698 -259
package/dist/make-console.cjs +1 -1
package/dist/make-console.mjs +1 -1
package/dist/react/conversation-controls.d.ts +20 -0
package/dist/react/use-attachments.d.ts +33 -0
package/dist/react/use-conversation-manager.d.ts +35 -0
package/dist/react.cjs +4 -4
package/dist/react.mjs +2000 -845
package/dist/sse.cjs +1 -1
package/dist/sse.mjs +1 -1
package/dist/styles.css +428 -13
package/docs/backend-contract.md +8 -21
package/docs/make-app-integration.md +80 -0
package/examples/make-app/README.md +11 -0
package/examples/make-app/index.html +5 -0
package/examples/make-app/main.tsx +34 -0
package/examples/make-app/style.css +4 -0
package/examples/make-app/transport.ts +163 -0
package/examples/make-app/vite.config.ts +7 -0
package/package.json +10 -2
package/recipes.json +36 -13
package/dist/conversation-B7eGUXi-.js +0 -727
package/dist/conversation-Cv1wdvCR.cjs +0 -1

package/examples/make-app/index.html ADDED Viewed

@@ -0,0 +1,5 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head><meta charset="UTF-8" /><meta name="viewport" content="width=device-width, initial-scale=1.0" /><title>Make App 助手接入验收</title></head>
+  <body><div id="root"></div><script type="module" src="/main.tsx"></script></body>
+</html>

package/examples/make-app/main.tsx ADDED Viewed

@@ -0,0 +1,34 @@
+import { StrictMode } from "react";
+import { createRoot } from "react-dom/client";
+import { AssistantPanel } from "@qfei-design/make-ai-assistant/react";
+import { createHostTransport, type Configuration } from "./transport";
+import "@qfei-design/make-ai-assistant/styles.css";
+import "./style.css";
+const config: Configuration = await fetch("/runtime-config").then((response) =>
+  response.json(),
+);
+if (
+  ![config.appKey, config.agentId, config.identityKey].every(
+    (value) => typeof value === "string" && value.length > 0,
+  )
+)
+  throw new Error("缺少宿主产品、Agent 或身份配置");
+const transport = createHostTransport(config);
+createRoot(document.getElementById("root")!).render(
+  <StrictMode>
+    <main className="example-shell">
+      <p className="example-notice">本地接入验收 · 使用宿主配置的真实后端</p>
+      <AssistantPanel
+        context={{
+          app: { id: config.appKey, name: config.appName },
+          location: { pathname: "/" },
+          locale: "zh-CN",
+          timezone: "Asia/Shanghai",
+        }}
+        transport={transport}
+        suggestions={[]}
+      />
+    </main>
+  </StrictMode>,
+);

package/examples/make-app/style.css ADDED Viewed

@@ -0,0 +1,4 @@
+body { margin: 0; background: #f4f6f9; font-family: system-ui, sans-serif; }
+.example-shell { margin: 20px auto; max-width: 880px; padding: 0 12px; }
+.example-notice { color: #617086; font-size: 12px; }
+.example-shell .make-ai-assistant__panel { background: white; border: 1px solid #dbe3ef; border-radius: 12px; height: calc(100dvh - 85px); min-height: 420px; }

package/examples/make-app/transport.ts ADDED Viewed

@@ -0,0 +1,163 @@
+import {
+  createMakeAppAssistantTransport,
+  type MakeAppAssistantEventSource,
+  type MakeAppAssistantEventSourceEvent,
+} from "@qfei-design/make-ai-assistant/make-app";
+export interface Configuration {
+  appKey: string;
+  appName: string;
+  agentId: string;
+  identityKey: string;
+}
+export function createHostTransport(
+  config: Configuration,
+  fetcher: typeof fetch = fetch,
+) {
+  const prefix = "/api/make/app/ai";
+  const id = encodeURIComponent;
+  const query = (values: Record<string, string | number | undefined>) =>
+    new URLSearchParams(
+      Object.entries(values)
+        .filter(
+          (entry): entry is [string, string | number] => entry[1] !== undefined,
+        )
+        .map(([key, value]) => [key, String(value)]),
+    ).toString();
+  const request = async (
+    path: string,
+    init: RequestInit = {},
+    binary = false,
+  ) => {
+    // 替换为 POC 已有的认证请求封装；本示例同样只访问宿主同源接口。
+    const response = await fetcher(prefix + path, {
+      credentials: "include",
+      ...init,
+    });
+    if (!response.ok) {
+      const body = await response.json().catch(() => ({}));
+      throw Object.assign(new Error("请求未完成"), {
+        status: response.status,
+        code: body.code,
+      });
+    }
+    if (response.status === 204) return undefined;
+    return binary
+      ? new Uint8Array(await response.arrayBuffer())
+      : response.json();
+  };
+  const json = (
+    method: string,
+    body: unknown,
+    signal?: AbortSignal,
+  ): RequestInit => ({
+    method,
+    signal,
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(body),
+  });
+  return createMakeAppAssistantTransport({
+    resolveScope: () => ({
+      appKey: config.appKey,
+      agentId: config.agentId,
+      identityKey: config.identityKey,
+    }),
+    listAgents: (input, options) => request(`/agents?${query(input)}`, options),
+    listChats: (input, options) => request(`/chats?${query(input)}`, options),
+    createChat: (input, options) =>
+      request("/chats", json("POST", input, options.signal)),
+    getChat: ({ chatId }, options) => request(`/chats/${id(chatId)}`, options),
+    updateChat: ({ chatId, ...body }, options) =>
+      request(`/chats/${id(chatId)}`, json("PATCH", body, options.signal)),
+    deleteChat: async ({ chatId, expectedRevision }, options) => {
+      await request(`/chats/${id(chatId)}?${query({ expectedRevision })}`, {
+        method: "DELETE",
+        signal: options.signal,
+      });
+    },
+    loadHistory: ({ chatId, ...page }, options) =>
+      request(`/chats/${id(chatId)}/messages?${query(page)}`, options),
+    sendMessage: ({ chatId, ...body }, options) =>
+      request(
+        `/chats/${id(chatId)}/messages`,
+        json("POST", body, options.signal),
+      ),
+    getResponse: ({ chatId, responseId }, options) =>
+      request(`/chats/${id(chatId)}/responses/${id(responseId)}`, options),
+    cancelResponse: ({ chatId, responseId }, options) =>
+      request(
+        `/chats/${id(chatId)}/responses/${id(responseId)}/cancel`,
+        json("POST", {}, options.signal),
+      ),
+    setFeedback: ({ chatId, messageId, ...body }, options) =>
+      request(
+        `/chats/${id(chatId)}/messages/${id(messageId)}/feedback`,
+        json("PUT", body, options.signal),
+      ),
+    startUpload: ({ chatId, ...body }, options) =>
+      request(
+        `/chats/${id(chatId)}/uploads`,
+        json("POST", body, options.signal),
+      ),
+    getUpload: ({ chatId, uploadId }, options) =>
+      request(`/chats/${id(chatId)}/uploads/${id(uploadId)}`, options),
+    uploadPart: async ({ chatId, uploadId, part, bytes }, options) => {
+      await request(
+        `/chats/${id(chatId)}/uploads/${id(uploadId)}/parts/${part}`,
+        {
+          method: "PUT",
+          signal: options.signal,
+          headers: { "Content-Type": "application/octet-stream" },
+          body: new Uint8Array(bytes).buffer,
+        },
+      );
+    },
+    completeUpload: ({ chatId, uploadId }, options) =>
+      request(
+        `/chats/${id(chatId)}/uploads/${id(uploadId)}/complete`,
+        json("POST", {}, options.signal),
+      ),
+    readContent: async ({ chatId, contentRef }, options) =>
+      request(`/chats/${id(chatId)}/content/${id(contentRef)}`, options, true),
+    eventSourceFactory: ({ chatId, responseId, cursor }, init) => {
+      const source = new EventSource(
+        `${prefix}/chats/${id(chatId)}/events?${query({ responseId, cursor })}`,
+        init,
+      );
+      type Listener = (event: MakeAppAssistantEventSourceEvent) => void;
+      const listeners = new Map<string, Map<Listener, EventListener>>();
+      const wrapped: MakeAppAssistantEventSource = {
+        get readyState() {
+          return source.readyState;
+        },
+        onerror: null,
+        addEventListener(type, listener) {
+          const receive: EventListener = (event) => {
+            const message = event as MessageEvent<unknown>;
+            if (typeof message.data === "string")
+              listener({
+                data: message.data,
+                lastEventId: message.lastEventId,
+              });
+          };
+          const group = listeners.get(type) ?? new Map();
+          group.set(listener, receive);
+          listeners.set(type, group);
+          source.addEventListener(type, receive);
+        },
+        removeEventListener(type, listener) {
+          const receive = listeners.get(type)?.get(listener);
+          if (receive) source.removeEventListener(type, receive);
+          listeners.get(type)?.delete(listener);
+        },
+        close() {
+          source.close();
+        },
+      };
+      source.onerror = (event) => wrapped.onerror?.(event);
+      return wrapped;
+    },
+    // 按实际模型验收开放类型；上传存储能力与模型理解能力独立。
+    modelInputKinds: ["text"],
+  });
+}

package/examples/make-app/vite.config.ts ADDED Viewed

@@ -0,0 +1,7 @@
+import react from "@vitejs/plugin-react";
+import { defineConfig } from "vite";
+export default defineConfig({
+  root: "examples/make-app",
+  plugins: [react()],
+  build: { outDir: "dist", emptyOutDir: true },
+});

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@qfei-design/make-ai-assistant",
-  "version": "0.2.9",
+  "version": "0.2.11",
   "description": "Platform-wide Make AI Assistant contracts, React shell, and context-aware artifact templates.",
   "type": "module",
   "sideEffects": [
@@ -55,13 +55,21 @@
     "recipes.json",
     "capabilities.json",
     "docs/artifact-v1.md",
-    "docs/backend-contract.md"
+    "docs/backend-contract.md",
+    "docs/make-app-integration.md",
+    "examples/make-app/main.tsx",
+    "examples/make-app/style.css",
+    "examples/make-app/README.md",
+    "examples/make-app/vite.config.ts",
+    "examples/make-app/index.html",
+    "examples/make-app/transport.ts"
   ],
   "scripts": {
     "test": "vitest run",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "build": "vite build && tsc -p tsconfig.build.json --emitDeclarationOnly && node scripts/copy-styles.mjs && node scripts/smoke-dist.mjs",
     "gallery:build": "vite build --config examples/gallery/vite.config.ts",
+    "make-app:build": "vite build --config examples/make-app/vite.config.ts",
     "sprint:init": "qfei-release sprint-init",
     "release:init": "qfei-release release-init",
     "publish:alpha": "qfei-release publish --channel alpha",

package/recipes.json CHANGED Viewed

@@ -14,7 +14,10 @@
         "AssistantTransport",
         "ArtifactActionHandler"
       ],
-      "readNext": ["README.md", "PUBLIC_API.md"],
+      "readNext": [
+        "README.md",
+        "PUBLIC_API.md"
+      ],
       "commonMistakes": [
         "Calling Make API directly from the UI",
         "Passing Make tokens through the package",
@@ -32,7 +35,10 @@
         "Service endpoint",
         "Optional credentials and request headers"
       ],
-      "readNext": ["README.md", "docs/backend-contract.md"],
+      "readNext": [
+        "README.md",
+        "docs/backend-contract.md"
+      ],
       "commonMistakes": [
         "Importing the SSE implementation from the headless root",
         "Sending Make tokens from the browser",
@@ -41,20 +47,27 @@
     },
     {
       "id": "make-app-browser-api",
-      "summary": "Connect the assistant to the existing Make App AI Browser API.",
+      "summary": "接入当前 Make App 多会话、反馈、类型化附件和 item/part SSE 合同。",
       "use": [
         "@qfei-design/make-ai-assistant/make-app:createMakeAppAssistantTransport"
       ],
       "hostProvides": [
-        "Authenticated semantic callbacks for chat lookup, history and message submission",
-        "Credentialed response EventSource factory",
-        "Current Make App context"
+        "明确 appKey/agentId/identityKey 的 resolveScope",
+        "17 项已认证语义回调及带凭据的 EventSource 工厂",
+        "实际模型已验收的 modelInputKinds"
+      ],
+      "readNext": [
+        "README.md",
+        "PUBLIC_API.md",
+        "docs/backend-contract.md",
+        "docs/make-app-integration.md"
       ],
-      "readNext": ["README.md", "PUBLIC_API.md", "docs/backend-contract.md"],
       "commonMistakes": [
-        "Creating or forwarding service credentials in browser code",
-        "Treating response.message as a text delta",
-        "Showing new-chat or remote-cancel controls when the backend does not support them"
+        "浏览器读写服务凭据",
+        "将 itemId 当作持久反馈 messageId",
+        "用关闭连接冒充远程取消",
+        "忽略空历史页的 hasMore",
+        "把上传成功视为模型理解成功"
       ]
     },
     {
@@ -68,7 +81,11 @@
         "Credentialed Run EventSource factory",
         "Current Make Console App context"
       ],
-      "readNext": ["README.md", "PUBLIC_API.md", "docs/backend-contract.md"],
+      "readNext": [
+        "README.md",
+        "PUBLIC_API.md",
+        "docs/backend-contract.md"
+      ],
       "commonMistakes": [
         "Reading or copying zs_session in application code",
         "Treating SSE as the durable source of truth",
@@ -88,7 +105,10 @@
         "canRender predicate based on Artifact semantics and host context",
         "Accessible React presentation"
       ],
-      "readNext": ["README.md", "PUBLIC_API.md"],
+      "readNext": [
+        "README.md",
+        "PUBLIC_API.md"
+      ],
       "commonMistakes": [
         "Registering a business-specific template as a platform default",
         "Using a backend component name as an executable import path",
@@ -106,7 +126,10 @@
         "App context",
         "Optional request-specific mock response"
       ],
-      "readNext": ["README.md", "PUBLIC_API.md"],
+      "readNext": [
+        "README.md",
+        "PUBLIC_API.md"
+      ],
       "commonMistakes": [
         "Building a second mock-only component path",
         "Putting POC business fixtures into platform default templates",