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

package/dist/sse.cjs

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const b=require("./conversation-Cv1wdvCR.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-Cvh-IVRV.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-B7eGUXi-.js";
+import { l as b } from "./conversation-CZfbgCXd.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

@@ -283,8 +283,8 @@
   background: var(--make-ai-internal-bg);
   border-bottom: 1px solid var(--make-ai-internal-border);
   display: grid;
-  gap: 8px;
-  grid-template-columns: auto 1fr auto;
+  gap: 10px;
+  grid-template-columns: minmax(0, 1fr) auto minmax(0, 1fr);
   grid-row: 1;
   height: var(--make-ai-internal-header-height);
   min-height: var(--make-ai-internal-header-height);
@@ -327,6 +327,7 @@
 
 .make-ai-assistant__avatar svg,
 .make-ai-assistant__icon-button svg,
+.make-ai-assistant__task-list-trigger svg,
 .make-ai-assistant__send svg {
   fill: none;
   height: 20px;
@@ -359,6 +360,71 @@
   align-items: center;
   display: flex;
   gap: 2px;
+  justify-self: end;
+  min-width: 0;
+}
+
+.make-ai-assistant__header-leading {
+  justify-self: start;
+  min-width: 0;
+}
+
+.make-ai-assistant__header-center {
+  align-items: center;
+  display: flex;
+  gap: 8px;
+  justify-self: center;
+  max-width: min(100%, 310px);
+  min-width: 0;
+}
+
+.make-ai-assistant__header-center > .make-ai-assistant__avatar {
+  border-radius: 50%;
+  height: 30px;
+  width: 30px;
+}
+
+.make-ai-assistant__header-center > .make-ai-assistant__avatar svg {
+  height: 17px;
+  width: 17px;
+}
+
+.make-ai-assistant__task-list-trigger {
+  align-items: center;
+  background: transparent;
+  border: 1px solid transparent;
+  border-radius: 9px;
+  color: var(--make-ai-internal-text-secondary);
+  cursor: pointer;
+  display: inline-flex;
+  font-size: var(--make-ai-internal-font-size-meta);
+  gap: 6px;
+  height: 34px;
+  max-width: 118px;
+  padding: 0 8px;
+  white-space: nowrap;
+}
+
+.make-ai-assistant__task-list-trigger:hover,
+.make-ai-assistant__task-list-trigger[aria-expanded="true"] {
+  background: var(--make-ai-internal-surface);
+  border-color: color-mix(in srgb, var(--make-ai-internal-accent) 30%, var(--make-ai-internal-border));
+  color: var(--make-ai-internal-text);
+}
+
+.make-ai-assistant__task-list-trigger svg:first-child {
+  height: 17px;
+  width: 17px;
+}
+
+.make-ai-assistant__task-list-trigger svg:last-child {
+  height: 12px;
+  transition: transform 160ms ease;
+  width: 12px;
+}
+
+.make-ai-assistant__task-list-trigger[aria-expanded="true"] svg:last-child {
+  transform: rotate(180deg);
 }
 
 .make-ai-assistant__header-content,
@@ -375,6 +441,7 @@
 
 .make-ai-assistant__header-title-row {
   gap: 8px;
+  justify-content: center;
 }
 
 .make-ai-assistant__header-title {
@@ -385,6 +452,17 @@
   white-space: nowrap;
 }
 
+.make-ai-assistant__current-conversation {
+  color: var(--make-ai-internal-text-secondary);
+  flex: 0 1 auto;
+  font-size: var(--make-ai-internal-font-size-caption);
+  line-height: var(--make-ai-internal-line-height-caption);
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
 .make-ai-assistant__read-only-tag {
   background: color-mix(in srgb, var(--make-ai-internal-accent) 10%, var(--make-ai-internal-bg));
   border: 1px solid color-mix(in srgb, var(--make-ai-internal-accent) 24%, var(--make-ai-internal-border));
@@ -399,6 +477,7 @@
 
 .make-ai-assistant__header-context {
   gap: 6px;
+  justify-content: center;
   margin-top: 1px;
 }
 
@@ -1260,14 +1339,15 @@
 }
 
 .make-ai-assistant__composer {
-  align-items: flex-end;
   background: var(--make-ai-internal-surface);
   border: 1px solid var(--make-ai-internal-border);
   border-radius: 15px;
-  display: flex;
-  gap: 9px;
-  min-height: 54px;
-  padding: 7px 8px 7px 12px;
+  display: grid;
+  gap: 7px 10px;
+  grid-template-columns: minmax(0, 1fr) auto;
+  grid-template-rows: minmax(46px, auto) 36px;
+  min-height: 96px;
+  padding: 10px 10px 8px;
   transition: background 160ms ease, border-color 160ms ease, box-shadow 160ms ease;
 }
 
@@ -1285,10 +1365,12 @@
   color: var(--make-ai-internal-text);
   font-size: var(--make-ai-internal-font-size-body);
   line-height: var(--make-ai-internal-line-height-body);
-  max-height: 112px;
-  min-height: 38px;
+  grid-column: 1 / -1;
+  grid-row: 1;
+  max-height: 128px;
+  min-height: 46px;
   outline: 0;
-  padding: 4px 0 2px;
+  padding: 2px 5px;
   resize: none;
   width: 100%;
 }
@@ -1312,12 +1394,20 @@
   flex: 0 0 auto;
   height: 34px;
   justify-content: center;
-  margin-bottom: 2px;
   position: relative;
   transition: background 160ms ease, box-shadow 160ms ease, opacity 160ms ease;
   width: 34px;
 }
 
+.make-ai-assistant__composer-actions {
+  align-items: center;
+  display: flex;
+  gap: 7px;
+  grid-column: 2;
+  grid-row: 2;
+  justify-self: end;
+}
+
 .make-ai-assistant__send::before {
   content: "";
   inset: -5px;
@@ -1555,11 +1645,33 @@ button.make-ai-artifact__record:hover { background: var(--make-ai-internal-accen
 
 @container (max-width: 360px) {
   .make-ai-assistant__header {
-    gap: 8px;
-    grid-template-columns: auto minmax(0, 1fr) auto;
+    gap: 6px;
+    grid-template-columns: minmax(0, 1fr) auto minmax(0, 1fr);
     padding: 7px var(--make-ai-internal-panel-gutter-compact);
   }
 
+  .make-ai-assistant__task-list-trigger {
+    max-width: 34px;
+    padding: 0 8px;
+  }
+
+  .make-ai-assistant__task-list-trigger > span,
+  .make-ai-assistant__task-list-trigger svg:last-child,
+  .make-ai-assistant__current-conversation,
+  .make-ai-assistant__read-only-tag,
+  .make-ai-assistant__header-context {
+    display: none;
+  }
+
+  .make-ai-assistant__header-center {
+    gap: 6px;
+  }
+
+  .make-ai-assistant__header-center > .make-ai-assistant__avatar {
+    height: 26px;
+    width: 26px;
+  }
+
   .make-ai-assistant__body {
     padding: 16px var(--make-ai-internal-panel-gutter-compact) 24px;
   }
@@ -1738,6 +1850,305 @@ button.make-ai-artifact__record:hover { background: var(--make-ai-internal-accen
   }
 }
 
+.make-ai-assistant__conversation-controls {
+  background: var(--make-ai-internal-surface);
+  border: 1px solid var(--make-ai-internal-border);
+  border-radius: 12px;
+  box-shadow: 0 14px 34px color-mix(in srgb, var(--make-ai-internal-text) 12%, transparent);
+  font-size: var(--make-ai-internal-font-size-meta);
+  left: var(--make-ai-internal-panel-gutter);
+  max-height: min(430px, calc(100% - var(--make-ai-internal-header-height) - 24px));
+  overflow: auto;
+  padding: 12px 8px 8px;
+  position: absolute;
+  top: calc(var(--make-ai-internal-header-height) + 8px);
+  width: min(300px, calc(100% - var(--make-ai-internal-panel-gutter) * 2));
+  z-index: calc(var(--make-ai-internal-z-index) + 1);
+}
+
+.make-ai-assistant__panel--managed {
+  grid-template-rows: auto minmax(0, 1fr) auto;
+}
+
+.make-ai-assistant__response-status { color: var(--make-ai-internal-text-secondary); font-size: var(--make-ai-internal-font-size-meta); }
+
+.make-ai-assistant__conversation-heading {
+  align-items: center;
+  color: var(--make-ai-internal-text-secondary);
+  display: flex;
+  font-size: var(--make-ai-internal-font-size-caption);
+  justify-content: space-between;
+  letter-spacing: .02em;
+  min-height: 26px;
+  padding: 0 7px 6px;
+}
+
+.make-ai-assistant__conversation-list {
+  max-height: 220px;
+  overflow: auto;
+  overscroll-behavior: contain;
+}
+
+.make-ai-assistant__conversation-list > p {
+  color: var(--make-ai-internal-text-secondary);
+  margin: 16px 8px;
+  text-align: center;
+}
+
+.make-ai-assistant__conversation-row {
+  align-items: center;
+  display: flex;
+  gap: 2px;
+  min-width: 0;
+}
+
+.make-ai-assistant__conversation-row > button:first-child {
+  align-items: center;
+  border-color: transparent;
+  display: flex;
+  flex: 1;
+  gap: 8px;
+  min-height: 36px;
+  min-width: 0;
+  overflow: hidden;
+  padding: 0 8px;
+  text-align: left;
+}
+
+.make-ai-assistant__conversation-row > button:first-child svg,
+.make-ai-assistant__conversation-new svg {
+  fill: none;
+  flex: 0 0 auto;
+  height: 16px;
+  stroke: currentColor;
+  stroke-linecap: round;
+  stroke-linejoin: round;
+  stroke-width: 1.7;
+  width: 16px;
+}
+
+.make-ai-assistant__conversation-row > button:first-child span {
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.make-ai-assistant__conversation-row > button[aria-pressed="true"] {
+  background: var(--make-ai-internal-accent-soft);
+  color: var(--make-ai-internal-accent);
+}
+
+.make-ai-assistant__conversation-row > button:last-child {
+  background: transparent;
+  border-color: transparent;
+  color: var(--make-ai-internal-text-secondary);
+  flex: 0 0 auto;
+  height: 30px;
+  padding: 0;
+  width: 30px;
+}
+
+.make-ai-assistant__conversation-more,
+.make-ai-assistant__conversation-refresh {
+  background: transparent !important;
+  border-color: transparent !important;
+  color: var(--make-ai-internal-text-secondary) !important;
+}
+
+.make-ai-assistant__conversation-more {
+  margin-top: 4px;
+  width: 100%;
+}
+
+.make-ai-assistant__conversation-management {
+  border-top: 1px solid var(--make-ai-internal-border);
+  margin-top: 8px;
+  padding: 8px 7px 0;
+}
+
+.make-ai-assistant__conversation-management summary {
+  color: var(--make-ai-internal-text-secondary);
+  cursor: pointer;
+}
+
+.make-ai-assistant__conversation-actions {
+  align-items: center;
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+  padding-top: 8px;
+}
+
+.make-ai-assistant__conversation-actions input {
+  flex: 1;
+  min-width: 100px;
+}
+
+.make-ai-assistant__conversation-error {
+  color: var(--make-ai-internal-danger);
+  display: grid;
+  gap: 6px;
+  padding: 8px 7px 0;
+}
+
+.make-ai-assistant__conversation-new {
+  align-items: center;
+  background: transparent !important;
+  border-color: transparent !important;
+  border-radius: 8px !important;
+  border-top: 1px solid var(--make-ai-internal-border) !important;
+  color: var(--make-ai-internal-accent) !important;
+  display: flex;
+  font-weight: 650 !important;
+  gap: 8px;
+  justify-content: flex-start;
+  margin-top: 8px;
+  min-height: 40px;
+  padding: 8px !important;
+  width: 100%;
+}
+
+.make-ai-assistant__conversation-new:hover {
+  background: var(--make-ai-internal-accent-soft) !important;
+}
+
+.make-ai-assistant__conversation-controls button,
+.make-ai-assistant__feedback button,
+.make-ai-assistant__attachment button {
+  background: var(--make-ai-internal-surface);
+  border: 1px solid var(--make-ai-internal-border);
+  border-radius: 6px;
+  color: inherit;
+  cursor: pointer;
+  font: inherit;
+  padding: 4px 8px;
+}
+.make-ai-assistant__feedback { display: flex; flex-wrap: wrap; gap: 6px; font-size: var(--make-ai-internal-font-size-meta); }
+.make-ai-assistant__feedback button[aria-pressed="true"] { color: var(--make-ai-internal-accent); border-color: var(--make-ai-internal-accent); }
+.make-ai-assistant__feedback form { display: grid; flex-basis: 100%; gap: 6px; }
+.make-ai-assistant__feedback input,
+.make-ai-assistant__feedback textarea,
+.make-ai-assistant__conversation-actions input { border: 1px solid var(--make-ai-internal-border); border-radius: 6px; color: inherit; font: inherit; padding: 6px; width: 100%; }
+.make-ai-assistant__attachment { align-items: center; display: flex; flex-wrap: wrap; gap: 6px; padding: 8px; border: 1px solid var(--make-ai-internal-border); border-radius: 8px; font-size: var(--make-ai-internal-font-size-meta); }
+.make-ai-assistant__attachment img,
+.make-ai-assistant__attachment video { max-height: 260px; max-width: 100%; object-fit: contain; }
+.make-ai-assistant__attachment audio { max-width: 100%; }
+
+.make-ai-assistant__attachment-composer {
+  align-self: center;
+  font-size: var(--make-ai-internal-font-size-meta);
+  grid-column: 1;
+  grid-row: 2;
+  justify-self: start;
+  position: relative;
+}
+
+.make-ai-assistant__attachment-trigger {
+  align-items: center;
+  background: transparent;
+  border: 1px solid transparent;
+  border-radius: 50%;
+  color: var(--make-ai-internal-text-secondary);
+  cursor: pointer;
+  display: flex;
+  height: 34px;
+  justify-content: center;
+  padding: 0;
+  width: 34px;
+}
+
+.make-ai-assistant__attachment-trigger:hover,
+.make-ai-assistant__attachment-trigger[aria-expanded="true"] {
+  background: var(--make-ai-internal-surface-strong);
+  border-color: color-mix(in srgb, var(--make-ai-internal-accent) 24%, var(--make-ai-internal-border));
+  color: var(--make-ai-internal-text);
+}
+
+.make-ai-assistant__attachment-trigger svg,
+.make-ai-assistant__attachment-menu svg {
+  fill: none;
+  height: 18px;
+  stroke: currentColor;
+  stroke-linecap: round;
+  stroke-linejoin: round;
+  stroke-width: 1.7;
+  width: 18px;
+}
+
+.make-ai-assistant__attachment-menu {
+  background: var(--make-ai-internal-surface);
+  border: 1px solid var(--make-ai-internal-border);
+  border-radius: 10px;
+  bottom: calc(100% + 8px);
+  box-shadow: 0 12px 28px color-mix(in srgb, var(--make-ai-internal-text) 12%, transparent);
+  left: 0;
+  min-width: 168px;
+  padding: 5px;
+  position: absolute;
+  z-index: calc(var(--make-ai-internal-z-index) + 2);
+}
+
+.make-ai-assistant__attachment-menu button {
+  align-items: center;
+  background: transparent;
+  border: 0;
+  border-radius: 7px;
+  color: var(--make-ai-internal-text);
+  cursor: pointer;
+  display: flex;
+  gap: 9px;
+  min-height: 38px;
+  padding: 0 10px;
+  text-align: left;
+  width: 100%;
+}
+
+.make-ai-assistant__attachment-menu button:hover {
+  background: var(--make-ai-internal-surface-strong);
+}
+
+.make-ai-assistant__attachment-drafts {
+  font-size: var(--make-ai-internal-font-size-meta);
+  max-height: 140px;
+  overflow: auto;
+  padding-bottom: 8px;
+}
+
+.make-ai-assistant__attachment-drafts ul {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+  list-style: none;
+  margin: 0;
+  padding: 0;
+}
+
+.make-ai-assistant__attachment-drafts li {
+  align-items: center;
+  background: var(--make-ai-internal-surface);
+  border: 1px solid var(--make-ai-internal-border);
+  border-radius: 8px;
+  display: flex;
+  flex-wrap: wrap;
+  gap: 4px;
+  padding: 5px 7px;
+}
+
+.make-ai-assistant__attachment-drafts button {
+  background: transparent;
+  border: 0;
+  color: var(--make-ai-internal-accent);
+  cursor: pointer;
+  padding: 2px 4px;
+}
+
+.make-ai-assistant__conversation-controls button:focus-visible,
+.make-ai-assistant__feedback button:focus-visible,
+.make-ai-assistant__attachment button:focus-visible,
+.make-ai-assistant__attachment-composer button:focus-visible,
+.make-ai-assistant__attachment-drafts button:focus-visible { outline: 2px solid var(--make-ai-internal-accent); outline-offset: 2px; }
+
 @media (prefers-reduced-motion: reduce) {
   .make-ai-assistant__drawer,
   .make-ai-assistant__launcher-orbit,
@@ -1756,4 +2167,8 @@ button.make-ai-artifact__record:hover { background: var(--make-ai-internal-accen
   .make-ai-assistant__process summary::after {
     transition: none;
   }
+
+  .make-ai-assistant__task-list-trigger svg:last-child {
+    transition: none;
+  }
 }

package/docs/backend-contract.md

@@ -1,4 +1,4 @@
-# Make AI 助手后端 V1 配合合同
+# Make AI 助手后端配合合同
 
 ## Make Console 当前 Web 接口
 
@@ -26,28 +26,15 @@ Console BFF 与 Make App Browser API 的认证和资源模型不同，不能只
 transport。平台包分别提供 `/make-console` 与 `/make-app` 两个入口，聊天 UI 与 Artifact
 模板保持共享。
 
-## Make App 现有后端接入
+## Make App 当前后端接入
 
-Make App 内嵌助手可以通过 `/make-app` adapter 对接宿主已有的 Browser API。npm 包只定义
-下列语义操作，不定义或拼接任何部署路径：
+Make App 通过 `/make-app` adapter 消费当前唯一契约。包提供 Chat 管理、历史、输入、输出、反馈、上传和原件的语义方法，实际 URL/身份与代理由宿主负责。完整接口映射与时序见 [接入说明](make-app-integration.md)。
 
-| 语义操作 | 输入 | 输出 |
-| --- | --- | --- |
-| 定位会话 | 当前 `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。
+宿主返回裸 JSON，204 没有 body，内容读取返回 Uint8Array。Chat 的 title/pinned 修改和删除使用 expectedRevision；创建和反馈使用稳定 requestId；发送使用稳定 messageId。历史从数值 cursor 正向读取，列表使用独立不透明游标。
+
+SSE 使用 response.subscribed/state、output_item.added/output_text.delta/output_item.done、reset/snapshot 以及 completed/failed/cancelled。输出项身份与最终持久消息身份分离；生成完成后读历史对账，再提交反馈。快照覆盖已有视图；关闭订阅不会取消 Run，显式取消可能先返回 202，随后确认终态。
+
+附件先完成分段上传，引用 ready 内容的长度/MIME/摘要后发送。模型媒体能力逐类验收，不能凭上传成功开放。当前 Make App 没有 Artifact 或重新生成的服务器语义，不发送未定义的 context/capabilities 扩展。
 
 ## 通用标准接口能力
 

package/docs/make-app-integration.md

@@ -0,0 +1,80 @@
+# Make App 当前契约接入
+
+本分支将现有 `/make-app` 入口原地接入当前个人多会话、反馈、附件和 item/part SSE 契约。没有协议版本选择，没有隐式定位单一会话，也不自动替宿主做登录。包版本发布号与业务协议无关。
+
+## 宿主接线
+
+从 `@qfei-design/make-ai-assistant/make-app` 导入 `createMakeAppAssistantTransport`，从 `/react` 导入 `MakeAiAssistant` 或 `AssistantPanel`。实现下面的语义回调；可复制 [宿主回调映射](../examples/make-app/transport.ts) 中的映射，替换为 POC 已有认证请求封装。所有 URL、Cookie 转发与服务端鉴权属于宿主。
+
+| 宿主回调 | 作用与结果 |
+|---|---|
+| resolveScope(context) | 返回明确的 appKey、agentId、identityKey；用户或租户变化时 identityKey 必须改变 |
+| listAgents | 产品内启用 Agent 数组的裸响应 |
+| createChat | requestId 幂等创建；返回 Chat |
+| listChats | 当前用户在产品/Agent 下的列表；返回 chats、nextCursor、hasMore |
+| getChat / updateChat / deleteChat | 详情、title/pinned 更新、软删除；更新/删除带 expectedRevision |
+| loadHistory | 指定 chatId 和数值 cursor；返回 messages、nextCursor、hasMore |
+| sendMessage | 稳定 messageId；text 或 parts 二选一；返回 chatId、responseId、acceptedCursor |
+| getResponse / cancelResponse | 权威快照、独立取消；取消可能返回仍 running 的快照与 cancelRequested=true |
+| setFeedback | 持久助手 messageId、requestId、like/dislike/none，以及可选 reason/comment |
+| startUpload / getUpload | 上传初始化与 completedParts 续传进度 |
+| uploadPart / completeUpload | 从 0 编号的二进制分段，全部完成后获取 ready 内容引用 |
+| readContent | 鉴权后原始 Uint8Array，不能把 contentRef 当公开 URL |
+| eventSourceFactory | 以 chatId、responseId、cursor 创建带凭据的 EventSource；包负责关闭与重连 |
+
+JSON 回调返回服务端裸对象，204 返回 void，内容返回 Uint8Array。不要在所有响应上统一解包 data 或 JSON.parse。每个异步回调都必须传递 AbortSignal。scopeKey 仅隔离浏览器内的状态，不能代替服务器授权。
+
+会话查询和创建相互独立。`loadConversation(context,{threadId,cursor,signal})` 只恢复选中的会话，不隐式创建；UI 点击新建或首次主动发送才创建。公开返回的 `threadId` 对应 chatId，responseId 对应执行 Run。
+
+## 包提供的交互
+
+内置面板可列出、选择、新建会话，编辑标题、置顶/取消置顶、确认删除；改名/置顶/删除失败保留用户可见错误。修订冲突后读取最新详情，不自动换 revision 覆盖。
+
+输入和重试保存稳定 UUID。多个输入可能对应同一 responseId；面板控制器在响应维度保持一个订阅，关闭面板继续保留当前 UI，切会话/身份或卸载只释放本地连接。停止按钮调用 cancelResponse，并等待终态；完成与取消竞争时接受服务端最终结果。
+
+输出按 itemId/partId 归并，完整 done 文本覆盖增量。中间模型活动放在过程区域，不能充当最终可反馈消息。response.completed 后读取历史对账，切换到持久助手 messageId，再开放反馈。点踩说明提交失败保留表单，重新提交复用未知结果的原意图；撤销用 rating=none。
+
+文件选择、拖拽和粘贴进入同一上传队列。分段大小读 partSize，重试先查 completedParts；未 ready 的附件不能发送。暂停/移除只影响本地任务和草稿，当前没有远程上传取消接口。附件卡片可鉴权下载和受控预览，不执行 HTML/SVG/脚本。
+
+## 流式事件与恢复
+
+公开流消费 `response.subscribed/state/output_item.added/output_text.delta/output_item.done/reset/snapshot/completed/failed/cancelled`。这些事件在 adapter 转换为 headless 的响应事件，不复用通用 SSE 的消息身份来猜最终答案。
+
+公开 `AssistantEvent` 增加：
+
+- response.accepted：输入受理与 responseId 关联。
+- response.state、response.output_item.added、response.output_text.delta、response.output_item.done：运行状态和项级输出。
+- response.snapshot：覆盖该响应已确认的输出视图。
+- response.reconciled：持久消息对账。
+- response.terminal：completed/failed/cancelled 终态。
+
+`AssistantConversationState.responses` 保存各响应状态，activeRunId 只是当前活动响应的便利字段，不是唯一运行事实。终态后迟到增量不能重新打开响应。原有通用 SSE、Console、Mock 与 Artifact 公共入口仍各自归一化到同一 headless 合同。
+
+EventSource.onerror 后先关闭旧实例，再由 adapter 从最后处理游标有界重连；不要同时设置第二套宿主重连循环。query cursor 优先于 Last-Event-ID。reset 后消费服务器快照；通道连续失败时切到权威快照。快照没有完整在途 token，也没有可直接切回 Redis 的水位，不能将任意旧 delta 追加到快照。
+
+完成对账失败会报告恢复错误，不能被重连逻辑吞掉。普通断网与 HTTP/SSE 读取失败都不等同于业务 Run 已取消。
+
+## 限制与未开放能力
+
+| 事项 | 当前行为 |
+|---|---|
+| 输入 | 文本累计 8 KiB UTF-8；最多 32 个有序 parts；整体消息 JSON 64 KiB |
+| 上传 | 单文件 64 MiB，分段当前 1 MiB；服务端按完整 Namespace 限流/限容量 |
+| 历史 | cursor=-1 从最早事件正向扫描，limit 数底层事件；空可见页仍可 hasMore=true |
+| 长历史 | 分页继续加载，有界展示最近加载的 200 条/正文预算；不会声称首个窗口是全部历史 |
+| 模型媒体能力 | modelInputKinds 默认只有 text；逐类真实模型验收后由宿主开放 |
+| 未完成上传 | 服务端当前 24 小时失效；无公开 abort/清理，容量不保证自动回收 |
+| 下载 | 当前为 attachment/octet-stream，不承诺 Range/206；预览用本地受控 Blob |
+| Artifact/页面上下文 | 通用能力保留；当前 Make App 请求不携带 context/capabilities，不从 Markdown 猜 Artifact |
+| 重新生成 | 没有服务端替换语义，保持关闭；普通再次提问属于新消息 |
+
+后端模型媒体适配未启用时，内部 LLM 可能返回 unsupported_media；公开消息先受理为 202 后再以 AI_RUN_FAILED 终止。前端不能依赖消息 POST 直接返回 422。
+
+## 后续 POC 接手
+
+1. 对接现有统一登录和 Service，完成所有语义回调；认证过期、产品/Agent/用户切换都重新核对。
+2. 由宿主决定当前选中会话的 URL/持久化导航、草稿体验、Agent 入口和主题布局。刷新后可从包的列表选择历史会话恢复。
+3. 用真实宿主验证未缓冲 SSE、断网重连、取消、修订冲突、反馈回显和附件字节；本地示例不是已部署 POC。
+4. 经接手人检查后，按现有 GitLab CI 发布 alpha，再升级 POC 依赖。当前用户要求只交 feature 分支，本轮不发包、不部署 Dev。
+
+完整字段说明以 agent-design 的 MakeAppProtocol/OpenAPI 与接口手册为准；交接飞书文档同时提供 17 项 HTTP 清单、请求示例、分支和本地验收结果。

package/examples/make-app/README.md

@@ -0,0 +1,11 @@
+# Make App 接入示例
+
+本示例消费包的公开 `/react`、`/make-app` 和样式入口，展示 17 项语义回调如何连接宿主同源服务。所有 POC 复用包内会话、流式、反馈和上传状态，不复制其内部实现。
+
+先在仓库根目录执行 `corepack pnpm build`，再执行 `corepack pnpm make-app:build`。输出在本目录的 dist，仅供宿主服务托管或本地验收；本例不处理登录、不读取 Token，也不提供生产 BFF。
+
+宿主提供同源 `GET /runtime-config`，响应为 `{appKey, appName, agentId, identityKey}`；identityKey 是用户/租户变化时同步变化的非凭据缓存隔离键。该配置不构成服务器授权。生产 POC 应将示例 request 换成已有认证客户端，并沿现有 Service/Make Gateway 转发公共接口。
+
+当前 Make App 后端只支持文本模型输入；示例的 modelInputKinds 为 `["text"]`。图片、文件、非实时音视频可先上传和查看原件，模型理解逐类验收后再配置开放。不要以文件上传成功判断模型已经支持。
+
+详见 [接入说明](../../docs/make-app-integration.md)。正式发布仍由原仓库 GitLab CI 负责。