@sepveneto/dnde-agent 0.2.0-beta.4 → 0.2.0-beta.5

package/README.md

@@ -51,6 +51,64 @@ interface AgentHostApi {
 默认带三个基于编辑器 API 的工具：`get_current_editor`、`get_widgets`、
 `editor_operator`。写操作和历史不可逆操作应先取得用户确认。
 
+### 初始化与增量修改
+
+Agent 会先读取 `get_current_editor` 的快照，再结合用户当前消息、聊天记录和
+附件内容判断工作模式：
+
+- **初始化**：用户要求按清单、文档或整页需求从零创建页面，或明确要求重建；
+- **增量修改**：用户要求在现有页面上新增、编辑、删除或移动局部内容。
+
+页面已有内容、但请求又像是一份完整清单时，Agent 会先向用户确认是否覆盖，
+不会自行清空页面。初始化和增量修改都可以通过同一个 `editor_operator` 写入，
+区别在于进入初始化后需要先调用宿主提供的初始化工具。
+
+宿主可以提供一个 `initialization` 角色的工具。主 Agent 判断为初始化后，通过
+`start_initialization` 暂时移交给独立的初始化子 Agent；子 Agent 只绑定这个
+指定名称的工具，调用完成后通过 `finish_initialization` 交还主 Agent。用户交互、
+业务接口查询以及返回数据都由宿主工具自己决定：
+
+```ts
+import {
+  defineInitializationTool,
+} from '@sepveneto/dnde-agent'
+import { z } from 'zod'
+
+const confirmInitialization = defineInitializationTool({
+  name: 'confirm_initialization',
+  description: '让用户确认本次初始化方式。',
+  parameters: z.object({
+    checklistSummary: z.string().optional(),
+  }),
+  async execute({ checklistSummary }) {
+    return host.confirmInitialization(checklistSummary)
+  },
+})
+```
+
+提供这个工具后，主 Agent 不会直接调用它，也不会把它暴露在普通增删改流程中。
+初始化子 Agent 仅能使用该工具，不能使用编辑器工具或其他业务工具。工具返回后
+控制权交还主 Agent，由主 Agent 重新确认组件类型并通过 `editor_operator`
+创建页面。未提供初始化工具时，Agent 会在对话中询问用户是否按清单继续。
+
+初始化工具必须返回以下三种结果之一：
+
+```ts
+{ mode: 'custom' } // 模型按用户清单自主设计
+{
+  mode: 'reference',
+  referenceId: '用户输入的参考数据 ID',
+  referenceData: { /* 宿主根据 ID 查询到的实际参考数据 */ }
+}
+{ mode: 'cancelled' } // 用户取消初始化
+```
+
+`reference` 模式必须由用户提供参考数据 ID。宿主工具应使用该 ID 调用参考数据
+详情接口，并把实际数据作为 `referenceData` 返回给主 Agent；主 Agent 不得自行
+选择、编造参考项，也不得只凭裸 ID 继续。完成选择后，仍按正常编辑流程依次调用
+可用组件查询、业务数据工具和 `editor_operator`，不会跳过业务工具直接生成业务
+数据。
+
 ### 添加组件时的业务数据
 
 `items` 通常是由业务 ID 查询并组装的复杂数据，不能交给模型生成。业务工具

package/dist/{agent--M87gUL-.js → agent-CvnsNxDC.js}

@@ -1,7 +1,7 @@
 var V = Object.defineProperty;
 var Q = (t, s, e) => s in t ? V(t, s, { enumerable: !0, configurable: !0, writable: !0, value: e }) : t[s] = e;
 var a = (t, s, e) => Q(t, typeof s != "symbol" ? s + "" : s, e);
-import { C as E, U as x, r as X, t as I, o as v, s as y, a as Z, w as A, i as q, e as ee, A as te, n as k, b as R, p as C, c as se, S as ie, d as ne, M as re, f as ae } from "./index-BozWbCey.js";
+import { C as E, U as x, r as X, t as I, o as v, s as y, a as Z, w as A, i as q, e as ee, A as te, n as k, b as R, p as C, c as se, S as ie, d as ne, M as re, f as ae } from "./index-d_JuxVCt.js";
 function oe(t) {
   return t ? !(typeof t == "object" && t && "constructor" in t && typeof t.constructor == "function" ? t.constructor.name : "").includes("ChatCompletions") : !0;
 }

package/dist/agents.d.ts

@@ -15,5 +15,7 @@ export interface CreateAgentsOptions {
  */
 export declare function createAgents(options: CreateAgentsOptions): {
     agent: Agent<any, "text">;
+    initializationAgent: Agent<any, "text"> | undefined;
+    agents: Agent<any, "text">[];
 };
 //# sourceMappingURL=agents.d.ts.map

package/dist/agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAA;AACjD,OAAO,KAAK,EAAwB,YAAY,EAAsB,MAAM,SAAS,CAAA;AACrF,OAAO,EAAE,KAAK,EAAQ,MAAM,gBAAgB,CAAA;AAO5C,eAAO,MAAM,mBAAmB,kBAAkB,CAAA;AAClD,eAAO,MAAM,qBAAqB,6BAA6B,CAAA;AAE/D,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,YAAY,CAAA;IACjB,KAAK,CAAC,EAAE,mBAAmB,EAAE,CAAA;IAC7B,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC3C;AAsLD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB;;EA8BxD"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAA;AACjD,OAAO,KAAK,EAAwB,YAAY,EAAsB,MAAM,SAAS,CAAA;AACrF,OAAO,EAAE,KAAK,EAAiB,MAAM,gBAAgB,CAAA;AAgBrD,eAAO,MAAM,mBAAmB,kBAAkB,CAAA;AAClD,eAAO,MAAM,qBAAqB,6BAA6B,CAAA;AAE/D,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,YAAY,CAAA;IACjB,KAAK,CAAC,EAAE,mBAAmB,EAAE,CAAA;IAC7B,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC3C;AAuLD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB;;;;EAiFxD"}

package/dist/editorContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"editorContext.d.ts","sourceRoot":"","sources":["../src/editorContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,SAAS,CAAA;AAEhB;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACpC,kBAAkB,CAKpB;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,oBAAoB,CAAA;IAC/B,yEAAyE;IACzE,YAAY,CAAC,EAAE,OAAO,EAAE,CAAA;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,kBAAkB,GAC1B,uBAAuB,CA6BzB;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CASjE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,EAAE,uBAAuB,EACjC,MAAM,EAAE,OAAO,GACd,IAAI,CAGN"}
+{"version":3,"file":"editorContext.d.ts","sourceRoot":"","sources":["../src/editorContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,SAAS,CAAA;AAEhB;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACpC,kBAAkB,CAKpB;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,oBAAoB,CAAA;IAC/B,yEAAyE;IACzE,YAAY,CAAC,EAAE,OAAO,EAAE,CAAA;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,kBAAkB,GAC1B,uBAAuB,CA2BzB;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CASjE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,EAAE,uBAAuB,EACjC,MAAM,EAAE,OAAO,GACd,IAAI,CAGN"}