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

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

@@ -1,19 +1,19 @@
 :where(.make-ai-assistant, .make-ai-artifact) {
   --make-ai-internal-accent: var(--make-ai-accent, var(--make-color-primary, #5147f3));
   --make-ai-internal-accent-strong: var(--make-ai-accent-strong, var(--make-color-primary-hover, #4037da));
-  --make-ai-internal-accent-soft: var(--make-ai-accent-soft, color-mix(in srgb, var(--make-ai-internal-accent) 10%, white));
-  --make-ai-internal-bg: var(--make-ai-bg, var(--make-color-bg, #ffffff));
-  --make-ai-internal-surface: var(--make-ai-surface, var(--make-color-bg-subtle, #f7f8fb));
-  --make-ai-internal-surface-strong: var(--make-ai-surface-strong, var(--make-color-bg-muted, #f0f2f7));
-  --make-ai-internal-text: var(--make-ai-text, var(--make-color-text, #1f2430));
-  --make-ai-internal-text-secondary: var(--make-ai-text-secondary, var(--make-color-text-secondary, #687080));
-  --make-ai-internal-border: var(--make-ai-border, var(--make-color-border, #e5e8ef));
+  --make-ai-internal-accent-soft: var(--make-ai-accent-soft, color-mix(in srgb, var(--make-ai-internal-accent) 10%, var(--make-ai-internal-bg)));
+  --make-ai-internal-bg: var(--make-ai-bg, var(--make-color-bg, #fcfcff));
+  --make-ai-internal-surface: var(--make-ai-surface, var(--make-color-bg-subtle, #f8f8fc));
+  --make-ai-internal-surface-strong: var(--make-ai-surface-strong, var(--make-color-bg-muted, #f0f0f6));
+  --make-ai-internal-text: var(--make-ai-text, var(--make-color-text, #252631));
+  --make-ai-internal-text-secondary: var(--make-ai-text-secondary, var(--make-color-text-secondary, #666979));
+  --make-ai-internal-border: var(--make-ai-border, var(--make-color-border, #e4e5ed));
   --make-ai-internal-success: var(--make-ai-success, var(--make-color-success, #1a9a61));
   --make-ai-internal-warning: var(--make-ai-warning, var(--make-color-warning, #c77b00));
   --make-ai-internal-danger: var(--make-ai-danger, var(--make-color-danger, #d04444));
   --make-ai-internal-radius: var(--make-ai-radius, var(--make-radius-large, 14px));
-  --make-ai-internal-shadow: var(--make-ai-shadow, 0 18px 52px rgb(23 26 38 / 16%));
-  --make-ai-internal-drawer-width: var(--make-ai-drawer-width, 408px);
+  --make-ai-internal-shadow: var(--make-ai-shadow, 0 18px 48px rgb(30 31 43 / 12%));
+  --make-ai-internal-drawer-width: var(--make-ai-drawer-width, 432px);
   --make-ai-internal-z-index: var(--make-ai-z-index, 1050);
 }
 
@@ -33,7 +33,7 @@
 
 .make-ai-assistant {
   color: var(--make-ai-internal-text);
-  font-family: Inter, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+  font-family: inherit;
 }
 
 .make-ai-assistant button,
@@ -47,27 +47,27 @@
 
 .make-ai-assistant__launcher {
   align-items: center;
-  background: linear-gradient(145deg, color-mix(in srgb, var(--make-ai-internal-accent) 82%, #9f91ff), var(--make-ai-internal-accent));
-  border: 0;
+  background: var(--make-ai-internal-accent);
+  border: 1px solid color-mix(in srgb, var(--make-ai-internal-accent) 70%, var(--make-ai-internal-border));
   border-radius: 50%;
   bottom: 28px;
-  box-shadow: 0 10px 30px color-mix(in srgb, var(--make-ai-internal-accent) 32%, transparent);
-  color: white;
+  box-shadow: 0 10px 24px color-mix(in srgb, var(--make-ai-internal-accent) 22%, transparent);
+  color: #fcfcff;
   cursor: pointer;
   display: flex;
-  height: 54px;
+  height: 50px;
   justify-content: center;
   padding: 0;
   position: fixed;
   right: 28px;
   transition: box-shadow 180ms ease, transform 180ms ease;
-  width: 54px;
+  width: 50px;
   z-index: calc(var(--make-ai-internal-z-index) + 2);
 }
 
 .make-ai-assistant__launcher:hover {
-  box-shadow: 0 14px 36px color-mix(in srgb, var(--make-ai-internal-accent) 42%, transparent);
-  transform: translateY(-2px) scale(1.03);
+  box-shadow: 0 12px 28px color-mix(in srgb, var(--make-ai-internal-accent) 28%, transparent);
+  transform: translateY(-2px);
 }
 
 .make-ai-assistant__launcher:focus-visible,
@@ -89,11 +89,10 @@
 }
 
 .make-ai-assistant__launcher-orbit {
-  border: 1px solid color-mix(in srgb, var(--make-ai-internal-accent) 46%, transparent);
+  border: 1px solid color-mix(in srgb, var(--make-ai-internal-accent) 30%, transparent);
   border-radius: 50%;
-  inset: -7px;
+  inset: -5px;
   position: absolute;
-  animation: make-ai-pulse 2.2s ease-out infinite;
 }
 
 .make-ai-assistant__drawer {
@@ -107,11 +106,12 @@
   top: 0;
   width: min(var(--make-ai-internal-drawer-width), 100vw);
   z-index: var(--make-ai-internal-z-index);
-  animation: make-ai-drawer-in 220ms cubic-bezier(.2, .75, .35, 1);
+  animation: make-ai-drawer-in 180ms cubic-bezier(.2, .75, .35, 1);
 }
 
 .make-ai-assistant__panel {
   background: var(--make-ai-internal-bg);
+  container-type: inline-size;
   display: grid;
   grid-template-rows: auto auto minmax(0, 1fr) auto;
   height: 100%;
@@ -124,8 +124,8 @@
   display: grid;
   gap: 10px;
   grid-template-columns: auto 1fr auto;
-  min-height: 72px;
-  padding: 14px 16px;
+  min-height: 70px;
+  padding: 14px 18px;
 }
 
 .make-ai-assistant__header h2,
@@ -136,33 +136,24 @@
 }
 
 .make-ai-assistant__header h2 {
-  font-size: 16px;
-  font-weight: 650;
+  font-size: 15px;
+  font-weight: 700;
   letter-spacing: -.01em;
   line-height: 22px;
 }
 
 .make-ai-assistant__header p {
-  align-items: center;
   color: var(--make-ai-internal-text-secondary);
-  display: flex;
   font-size: 12px;
-  gap: 6px;
-  margin-top: 2px;
-}
-
-.make-ai-assistant__online-dot {
-  background: var(--make-ai-internal-success);
-  border-radius: 50%;
-  height: 6px;
-  width: 6px;
+  line-height: 18px;
+  margin-top: 1px;
 }
 
 .make-ai-assistant__avatar {
   align-items: center;
   background: var(--make-ai-internal-accent-soft);
   border: 1px solid color-mix(in srgb, var(--make-ai-internal-accent) 12%, transparent);
-  border-radius: 11px;
+  border-radius: 10px;
   color: var(--make-ai-internal-accent);
   display: inline-flex;
   flex: 0 0 auto;
@@ -209,21 +200,23 @@
 
 .make-ai-assistant__privacy-note {
   align-items: center;
-  background: var(--make-ai-internal-accent-soft);
-  color: color-mix(in srgb, var(--make-ai-internal-accent) 76%, var(--make-ai-internal-text));
+  background: var(--make-ai-internal-surface);
+  border: 1px solid color-mix(in srgb, var(--make-ai-internal-border) 84%, transparent);
+  color: var(--make-ai-internal-text-secondary);
   display: flex;
   font-size: 12px;
   gap: 8px;
-  margin: 12px 14px 0;
+  line-height: 1.5;
+  margin: 12px 18px 0;
   padding: 8px 10px;
-  border-radius: 8px;
+  border-radius: 10px;
 }
 
 .make-ai-assistant__body {
   min-height: 0;
   overflow: auto;
   overscroll-behavior: contain;
-  padding: 18px 14px 28px;
+  padding: 22px 18px 30px;
 }
 
 .make-ai-assistant__empty {
@@ -260,8 +253,8 @@
 .make-ai-assistant__message {
   align-items: flex-start;
   display: flex;
-  gap: 9px;
-  margin-bottom: 22px;
+  gap: 10px;
+  margin-bottom: 24px;
 }
 
 .make-ai-assistant__message--user {
@@ -271,38 +264,54 @@
 .make-ai-assistant__message-stack {
   display: flex;
   flex-direction: column;
-  gap: 10px;
-  max-width: calc(100% - 45px);
+  gap: 8px;
   min-width: 0;
 }
 
+.make-ai-assistant__message--assistant .make-ai-assistant__message-stack {
+  flex: 1;
+  max-width: calc(100% - 38px);
+}
+
 .make-ai-assistant__message--user .make-ai-assistant__message-stack {
   align-items: flex-end;
+  max-width: min(82%, 330px);
+}
+
+.make-ai-assistant__message-sender {
+  color: var(--make-ai-internal-text-secondary);
+  font-size: 12px;
+  font-weight: 600;
+  line-height: 16px;
+}
+
+.make-ai-assistant__message--user .make-ai-assistant__message-sender {
+  color: color-mix(in srgb, var(--make-ai-internal-accent) 72%, var(--make-ai-internal-text));
 }
 
 .make-ai-assistant__bubble {
-  background: var(--make-ai-internal-surface);
-  border-radius: 4px 14px 14px;
+  color: var(--make-ai-internal-text);
   font-size: 14px;
-  line-height: 1.65;
-  padding: 10px 12px;
+  line-height: 1.7;
   white-space: pre-wrap;
 }
 
 .make-ai-assistant__message--user .make-ai-assistant__bubble {
-  background: var(--make-ai-internal-accent-soft);
-  border-radius: 14px 4px 14px 14px;
+  background: color-mix(in srgb, var(--make-ai-internal-accent) 10%, var(--make-ai-internal-surface));
+  border: 1px solid color-mix(in srgb, var(--make-ai-internal-accent) 12%, var(--make-ai-internal-border));
+  border-radius: 16px 5px 16px 16px;
   color: color-mix(in srgb, var(--make-ai-internal-accent) 68%, var(--make-ai-internal-text));
+  padding: 10px 13px;
 }
 
 .make-ai-assistant__typing {
   align-items: center;
   background: var(--make-ai-internal-surface);
-  border-radius: 4px 14px 14px;
+  border-radius: 10px;
   display: flex;
   gap: 4px;
-  height: 38px;
-  padding: 0 13px;
+  height: 34px;
+  padding: 0 12px;
 }
 
 .make-ai-assistant__typing span {
@@ -317,29 +326,63 @@
 .make-ai-assistant__typing span:nth-child(2) { animation-delay: 140ms; }
 .make-ai-assistant__typing span:nth-child(3) { animation-delay: 280ms; }
 
-.make-ai-assistant__error {
-  background: color-mix(in srgb, var(--make-ai-internal-danger) 8%, white);
-  border: 1px solid color-mix(in srgb, var(--make-ai-internal-danger) 20%, transparent);
+.make-ai-assistant__message-status {
   border-radius: 10px;
-  color: var(--make-ai-internal-danger);
   display: flex;
   flex-direction: column;
   font-size: 13px;
-  gap: 3px;
-  margin-left: 45px;
+  gap: 4px;
+  line-height: 1.55;
   padding: 10px 12px;
 }
 
+.make-ai-assistant__message-status--error {
+  background: color-mix(in srgb, var(--make-ai-internal-danger) 7%, var(--make-ai-internal-surface));
+  border: 1px solid color-mix(in srgb, var(--make-ai-internal-danger) 22%, var(--make-ai-internal-border));
+  color: var(--make-ai-internal-danger);
+}
+
+.make-ai-assistant__progress {
+  align-items: center;
+  color: var(--make-ai-internal-text-secondary);
+  display: flex;
+  font-size: 12px;
+  gap: 7px;
+  line-height: 18px;
+  min-height: 24px;
+}
+
+.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 {
+  align-self: flex-start;
+  background: transparent;
+  border: 1px solid currentColor;
+  border-radius: 7px;
+  color: inherit;
+  cursor: pointer;
+  font-size: 12px;
+  font-weight: 600;
+  margin-top: 3px;
+  padding: 5px 9px;
+}
+
 .make-ai-assistant__composer-region {
   background: var(--make-ai-internal-bg);
   border-top: 1px solid var(--make-ai-internal-border);
-  padding: 10px 14px 8px;
+  padding: 12px 18px 10px;
 }
 
 .make-ai-assistant__suggestions {
   display: flex;
-  gap: 7px;
-  margin-bottom: 9px;
+  gap: 8px;
+  margin-bottom: 10px;
   overflow: auto;
   scrollbar-width: none;
 }
@@ -347,12 +390,12 @@
 .make-ai-assistant__suggestions button {
   background: var(--make-ai-internal-surface);
   border: 1px solid var(--make-ai-internal-border);
-  border-radius: 999px;
+  border-radius: 8px;
   color: var(--make-ai-internal-text-secondary);
   cursor: pointer;
   flex: 0 0 auto;
   font-size: 12px;
-  padding: 6px 10px;
+  padding: 7px 10px;
 }
 
 .make-ai-assistant__suggestions button:hover {
@@ -364,10 +407,10 @@
   align-items: flex-end;
   background: var(--make-ai-internal-bg);
   border: 1px solid var(--make-ai-internal-border);
-  border-radius: 12px;
+  border-radius: 16px;
   display: flex;
   gap: 8px;
-  padding: 9px 9px 9px 12px;
+  padding: 10px 10px 10px 13px;
   transition: border-color 160ms ease, box-shadow 160ms ease;
 }
 
@@ -380,9 +423,9 @@
   background: transparent;
   border: 0;
   color: var(--make-ai-internal-text);
-  line-height: 1.5;
-  max-height: 116px;
-  min-height: 42px;
+  line-height: 1.55;
+  max-height: 120px;
+  min-height: 46px;
   outline: 0;
   padding: 1px 0;
   resize: none;
@@ -390,21 +433,21 @@
 }
 
 .make-ai-assistant__composer textarea::placeholder {
-  color: color-mix(in srgb, var(--make-ai-internal-text-secondary) 75%, white);
+  color: color-mix(in srgb, var(--make-ai-internal-text-secondary) 75%, var(--make-ai-internal-bg));
 }
 
 .make-ai-assistant__send {
   align-items: center;
   background: var(--make-ai-internal-accent);
   border: 0;
-  border-radius: 9px;
-  color: white;
+  border-radius: 50%;
+  color: #fcfcff;
   cursor: pointer;
   display: flex;
   flex: 0 0 auto;
-  height: 34px;
+  height: 36px;
   justify-content: center;
-  width: 34px;
+  width: 36px;
 }
 
 .make-ai-assistant__send:hover:not(:disabled) { background: var(--make-ai-internal-accent-strong); }
@@ -420,7 +463,8 @@
 .make-ai-assistant__composer-region > p {
   color: var(--make-ai-internal-text-secondary);
   font-size: 10px;
-  margin: 7px 0 0;
+  line-height: 1.45;
+  margin: 8px 0 0;
   text-align: center;
 }
 
@@ -508,7 +552,7 @@
 
 .make-ai-artifact__action--primary {
   background: var(--make-ai-internal-accent);
-  color: white;
+  color: #fcfcff;
 }
 
 .make-ai-artifact__action--secondary {
@@ -539,7 +583,7 @@
 .make-ai-artifact__trend-label { color: var(--make-ai-internal-text-secondary); font-size: 11px; margin-bottom: 8px; }
 .make-ai-artifact__trend-bars { align-items: flex-end; display: flex; gap: 5px; height: 112px; }
 .make-ai-artifact__trend-point { align-items: center; display: flex; flex: 1; flex-direction: column; height: 100%; justify-content: flex-end; min-width: 0; }
-.make-ai-artifact__trend-bar { background: linear-gradient(to top, var(--make-ai-internal-accent), color-mix(in srgb, var(--make-ai-internal-accent) 42%, white)); border-radius: 4px 4px 1px 1px; min-height: 4px; width: min(18px, 70%); }
+.make-ai-artifact__trend-bar { background: var(--make-ai-internal-accent); border-radius: 4px 4px 1px 1px; min-height: 4px; width: min(18px, 70%); }
 .make-ai-artifact__trend-point small { color: var(--make-ai-internal-text-secondary); font-size: 9px; margin-top: 5px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; width: 100%; text-align: center; }
 
 .make-ai-artifact__ranking { list-style: none; margin: 12px 0 0; padding: 0; }
@@ -608,6 +652,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.2",
   "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.2",
+    "npm": "npm install @qfei-design/make-ai-assistant@^0.1.2",
+    "yarn": "yarn add @qfei-design/make-ai-assistant@^0.1.2"
   },
   "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.3",
   "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.",