@qfei-design/make-ai-assistant 0.1.0 → 0.1.2

package/dist/sse.cjs

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const b=require("./conversation-DpYszfVd.cjs"),S=1e6,u=e=>typeof e=="object"&&e!==null&&!Array.isArray(e),p=(e,t,r)=>{const a=Object.keys(e).find(s=>s.toLowerCase()===t.toLowerCase());a&&delete e[a],e[t]=r},A=e=>{const t={};return Array.isArray(e)?e.forEach(([r,a])=>p(t,r,a)):e&&typeof e.forEach=="function"?e.forEach((r,a)=>p(t,a,r)):e&&Object.entries(e).forEach(([r,a])=>p(t,r,a)),p(t,"Accept","text/event-stream"),p(t,"Content-Type","application/json"),t},I=(e,t)=>{if(!u(t))throw new Error("Invalid assistant SSE event: data");if(Object.prototype.hasOwnProperty.call(t,"type"))throw new Error("Invalid assistant SSE event: unsupported field");try{return b.parseAssistantEvent({...t,type:e})}catch(r){throw r instanceof Error&&r.message.startsWith("Invalid assistant event")?new Error(r.message.replace("Invalid assistant event","Invalid assistant SSE event")):r}},w=e=>{if(!e.trim())return;const t=e.split(`
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const b=require("./conversation-Yku9Lzj_.cjs"),S=1e6,u=e=>typeof e=="object"&&e!==null&&!Array.isArray(e),p=(e,t,r)=>{const a=Object.keys(e).find(s=>s.toLowerCase()===t.toLowerCase());a&&delete e[a],e[t]=r},A=e=>{const t={};return Array.isArray(e)?e.forEach(([r,a])=>p(t,r,a)):e&&typeof e.forEach=="function"?e.forEach((r,a)=>p(t,a,r)):e&&Object.entries(e).forEach(([r,a])=>p(t,r,a)),p(t,"Accept","text/event-stream"),p(t,"Content-Type","application/json"),t},I=(e,t)=>{if(!u(t))throw new Error("Invalid assistant SSE event: data");if(Object.prototype.hasOwnProperty.call(t,"type"))throw new Error("Invalid assistant SSE event: unsupported field");try{return b.parseAssistantEvent({...t,type:e})}catch(r){throw r instanceof Error&&r.message.startsWith("Invalid assistant event")?new Error(r.message.replace("Invalid assistant event","Invalid assistant SSE event")):r}},w=e=>{if(!e.trim())return;const t=e.split(`
 `),r=t.find(n=>n.startsWith("event:"))?.slice(6).trim(),a=t.filter(n=>n.startsWith("data:")).map(n=>n.slice(5).trimStart()).join(`
 `);if(t.some(n=>n.startsWith("event:")||n.startsWith("data:"))){if(!r||!a)throw new Error("Invalid assistant SSE event: missing event or data");try{return I(r,JSON.parse(a))}catch(n){throw n instanceof Error&&n.message.startsWith("Invalid assistant SSE event")?n:new Error("Invalid assistant SSE event: JSON")}}};async function*T(e,t,r=S){if(!e.body)throw new Error("当前运行环境无法读取 AI 助手流式响应");const a=e.body.getReader(),s=new TextDecoder;let n="",d=!1,h=!1,l;const c=()=>(l??=a.cancel().catch(o=>{console.error("[make-ai-assistant] SSE reader cancellation failed",{errorType:o instanceof Error?o.name:typeof o})}),l),f=()=>{c()};t?.addEventListener("abort",f,{once:!0});const m=o=>{const i=o.type==="error"||o.type==="run.cancelled"||o.type==="run.complete";return h||=i,i};try{for(;;){if(t?.aborted)throw new DOMException("Aborted","AbortError");const o=await a.read();if(t?.aborted)throw new DOMException("Aborted","AbortError");let i=s.decode(o.value,{stream:!o.done});d&&(i=`\r${i}`,d=!1),!o.done&&i.endsWith("\r")&&(i=i.slice(0,-1),d=!0),o.done&&d&&(i+="\r",d=!1),n+=i.replace(/\r\n|\r/g,`
 `);let E=n.indexOf(`

package/dist/sse.mjs

@@ -1,4 +1,4 @@
-import { p as b } from "./conversation-B5kECJz8.js";
+import { p as b } from "./conversation-Dy2Sghjv.js";
 const S = 1e6, u = (e) => typeof e == "object" && e !== null && !Array.isArray(e), E = (e, t, r) => {
   const a = Object.keys(e).find(
     (s) => s.toLowerCase() === t.toLowerCase()

package/dist/styles.css

@@ -330,6 +330,34 @@
   padding: 10px 12px;
 }
 
+.make-ai-assistant__progress {
+  align-items: center;
+  color: var(--make-ai-internal-text-secondary);
+  display: flex;
+  font-size: 12px;
+  gap: 7px;
+  margin-left: 45px;
+}
+
+.make-ai-assistant__progress > span {
+  animation: make-ai-pulse 1.2s ease-in-out infinite;
+  background: var(--make-ai-internal-accent);
+  border-radius: 50%;
+  height: 7px;
+  width: 7px;
+}
+
+.make-ai-assistant__retry {
+  background: var(--make-ai-internal-accent);
+  border: 0;
+  border-radius: 8px;
+  color: white;
+  cursor: pointer;
+  font-size: 12px;
+  margin-top: 4px;
+  padding: 7px 12px;
+}
+
 .make-ai-assistant__composer-region {
   background: var(--make-ai-internal-bg);
   border-top: 1px solid var(--make-ai-internal-border);
@@ -608,6 +636,7 @@ button.make-ai-artifact__record:hover { background: var(--make-ai-internal-accen
 @media (prefers-reduced-motion: reduce) {
   .make-ai-assistant__drawer,
   .make-ai-assistant__launcher-orbit,
+  .make-ai-assistant__progress > span,
   .make-ai-assistant__typing span {
     animation: none;
   }

package/docs/backend-contract.md

@@ -1,8 +1,57 @@
 # Make AI 助手后端 V1 配合合同
 
-## 接口能力
+## Make Console 当前 Web 接口
 
-后端第一版至少提供以下能力：
+`/make-console` adapter 对应 Console BFF 的五个语义操作。普通接口由宿主解包响应 `data`，
+SSE 保持原始 `text/event-stream`：
+
+| 语义操作 | Console Web 接口 |
+| --- | --- |
+| 查询 Agent | `GET /api/make/console/v1/apps/{appKey}/agent`，读取 `data.agents` |
+| 创建/复用 Session | `POST /api/make/console/v1/apps/{appKey}/agent/{agentID}/sessions` |
+| 读取持久事件 | `GET /api/make/console/v1/apps/{appKey}/agent/{agentID}/sessions/{sessionID}/events?from={seq}&limit={limit}` |
+| 发送消息 | `POST /api/make/console/v1/apps/{appKey}/agent/messages?agentID={agentID}`，Body 为 `{ text }` |
+| 订阅 Run | `GET /api/make/console/v1/apps/{appKey}/agent/{agentID}/sessions/{sessionID}/runs/{runID}/stream?after={cursor}` |
+
+Console 浏览器请求使用已有登录态的 `credentials: "include"`，EventSource 使用
+`withCredentials: true`。前端包和 App 业务代码不得读取、写入或复制 `zs_session`。
+租户、操作人、Agent 指令、模型和 MCP 工具均由 Console/Context/Runtime 服务端链路确定。
+
+SSE 事件包括：`ready` 建连、`run-output` 增量或终态、`fallback` 实时流降级以及注释心跳。
+`output_text.delta` 只追加到当前气泡；`response.completed` 后必须读取持久事件完成最终对账；
+`response.failed` 使用稳定 `failureCode`；`fallback` 从用户消息 `seq + 1` 开始轮询。持久
+`message` 事件且 `actor.kind=agent` 的完整文本是最终事实源。
+
+Console BFF 与 Make App Browser API 的认证和资源模型不同，不能只替换 base URL 复用同一
+transport。平台包分别提供 `/make-console` 与 `/make-app` 两个入口，聊天 UI 与 Artifact
+模板保持共享。
+
+## Make App 现有后端接入
+
+Make App 内嵌助手可以通过 `/make-app` adapter 对接宿主已有的 Browser API。npm 包只定义
+下列语义操作，不定义或拼接任何部署路径：
+
+| 语义操作 | 输入 | 输出 |
+| --- | --- | --- |
+| 定位会话 | 当前 `MakeAssistantHostContext` | `{ chatId }` |
+| 加载历史 | `{ chatId, cursor: -1, limit }` | `{ messages }` |
+| 提交消息 | `{ chatId, messageId, text }` | `{ chatId, responseId, acceptedCursor }` |
+| 订阅响应 | `{ chatId, responseId, cursor }` | 兼容 adapter 合同的 EventSource |
+
+实际请求由宿主认证边界发起。URL、请求方法、Cookie、Ingress、Service 代理、租户与当前用户
+解析都由宿主决定；浏览器不能读取或构造服务端凭证。宿主必须传递 `AbortSignal`，并在取消
+后尽快停止尚未完成的请求。
+
+当前事件包括 `run.started`、`response.delta`、`response.progress`、
+`response.message`、`response.completed`、`response.failed` 和 `heartbeat`。
+`response.message` 是完整文本替换，不是 delta。当前接口没有新建会话、远程取消和
+Artifact；前端必须按能力降级，不应伪造这些能力。
+Make App adapter 会在 `JSON.parse` 前限制单个 EventSource `data` 字符数，默认
+1,000,000；历史恢复最多接受 200 条消息、1,000,000 字符正文和 500 个 Artifact。
+
+## 通用标准接口能力
+
+当接入自有 Agent 后端或未来统一协议时，建议至少提供以下能力：
 
 1. 创建或继续一次 run；
 2. 通过 SSE 流式返回文本与 Artifact；
@@ -20,7 +69,7 @@
 | `GET` | `/api/assistant/threads/:threadId` | 会话与历史消息 |
 | `DELETE` | `/api/assistant/threads/:threadId` | 删除会话，可放到后续版本 |
 
-宿主 UI 只调用自己的 Service `/api`，不直接调用 Make API、模型服务或透传 Make token。
+宿主 UI 只经过平台同源入口或自己的 Service `/api`，不直接调用数据 API、模型服务或透传 Make token。
 
 ## Run 请求
 

package/package.ai.json

@@ -1,6 +1,6 @@
 {
   "packageName": "@qfei-design/make-ai-assistant",
-  "minimumRuntimeVersion": "0.1.0",
+  "minimumRuntimeVersion": "0.1.1",
   "readOrder": [
     "package.ai.json",
     "README.md",
@@ -15,14 +15,16 @@
     "ssrSupported": true
   },
   "install": {
-    "pnpm": "pnpm add @qfei-design/make-ai-assistant@^0.1.0",
-    "npm": "npm install @qfei-design/make-ai-assistant@^0.1.0",
-    "yarn": "yarn add @qfei-design/make-ai-assistant@^0.1.0"
+    "pnpm": "pnpm add @qfei-design/make-ai-assistant@^0.1.1",
+    "npm": "npm install @qfei-design/make-ai-assistant@^0.1.1",
+    "yarn": "yarn add @qfei-design/make-ai-assistant@^0.1.1"
   },
   "exports": [
     "@qfei-design/make-ai-assistant",
     "@qfei-design/make-ai-assistant/react",
     "@qfei-design/make-ai-assistant/sse",
+    "@qfei-design/make-ai-assistant/make-app",
+    "@qfei-design/make-ai-assistant/make-console",
     "@qfei-design/make-ai-assistant/testing",
     "@qfei-design/make-ai-assistant/styles.css",
     "@qfei-design/make-ai-assistant/artifact-v1.schema.json"
@@ -37,6 +39,8 @@
     "Artifact V1 contracts and validation",
     "Conversation event reduction",
     "Standard abortable SSE transport",
+    "Host-injected Make App AI semantic transport",
+    "Host-injected Make Console Agent and Run semantic transport",
     "Template registration and capability negotiation",
     "Floating launcher, right drawer and embedded assistant panel",
     "Platform artifact templates",
@@ -44,7 +48,7 @@
   ],
   "hostResponsibilities": [
     "Current App and route context",
-    "SSE or AG-UI transport adapter",
+    "Authenticated semantic operations and EventSource boundary",
     "Service authentication and server-side authorization",
     "Safe action execution and route mapping",
     "Optional App-specific templates and theme variables"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qfei-design/make-ai-assistant",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Platform-wide Make AI Assistant contracts, React shell, and context-aware artifact templates.",
   "type": "module",
   "sideEffects": [
@@ -25,6 +25,16 @@
       "import": "./dist/sse.mjs",
       "require": "./dist/sse.cjs"
     },
+    "./make-app": {
+      "types": "./dist/make-app.d.ts",
+      "import": "./dist/make-app.mjs",
+      "require": "./dist/make-app.cjs"
+    },
+    "./make-console": {
+      "types": "./dist/make-console.d.ts",
+      "import": "./dist/make-console.mjs",
+      "require": "./dist/make-console.cjs"
+    },
     "./testing": {
       "types": "./dist/testing/index.d.ts",
       "import": "./dist/testing.mjs",

package/recipes.json

@@ -39,6 +39,42 @@
         "Ending a stream without run.complete, run.cancelled or error"
       ]
     },
+    {
+      "id": "make-app-browser-api",
+      "summary": "Connect the assistant to the existing Make App AI Browser API.",
+      "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"
+      ],
+      "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"
+      ]
+    },
+    {
+      "id": "make-console-agent-api",
+      "summary": "Connect the assistant to the Make Console Agent, Session, durable-event and Run SSE APIs.",
+      "use": [
+        "@qfei-design/make-ai-assistant/make-console:createMakeConsoleAssistantTransport"
+      ],
+      "hostProvides": [
+        "Authenticated semantic callbacks for Agent lookup, Session lookup, durable events and message submission",
+        "Credentialed Run EventSource factory",
+        "Current Make Console App context"
+      ],
+      "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",
+        "Reusing the Make App Browser API transport by only replacing its base URL"
+      ]
+    },
     {
       "id": "app-artifact-template",
       "summary": "Register an App-specific result template without changing the platform package.",