@sepveneto/dnde-agent 0.2.0 → 0.2.1

package/README.md

@@ -42,6 +42,7 @@ register({
 - 主 Agent 的 `tools` 始终为空，只负责分诊和 handoff。
 - 子 Agent 由宿主定义，或直接注入已经构造好的 Agents SDK `Agent`。
 - 子 Agent 负责实际分析、业务查询和页面编辑。
+- 子 Agent 完成任务后通过 `transfer_back_to_main` 将控制权交还主 Agent。
 - 未提供匹配子 Agent 时，主 Agent 会说明当前能力不足，不会自行读取或修改页面。
 
 这种边界可确保业务权限、工具实现和具体编辑策略不进入 Agent Runtime。
@@ -92,7 +93,8 @@ const pageAgent = new Agent({
   instructions: [
     '先调用 get_current_editor 和 get_widgets。',
     '页面修改必须通过 apply_editor_dsl 提交完整、版本化的 DSL。',
-    '完成后直接结束并返回处理结果。',
+    '任务全部完成后调用 transfer_back_to_main 交还控制权。',
+    '需要用户补充信息时不要交还，等待用户回复后继续当前任务。',
   ].join('\n'),
   tools: [
     ...editorTools,
@@ -104,9 +106,9 @@ const pageAgent = new Agent({
 const subAgents: AgentSubAgent[] = [pageAgent]
 ```
 
-`Agent` 会原样成为主 Agent 的 handoff 值，模型、工具、结构化输出等配置都由宿主
-决定。运行时不会重复创建 Agent、包装 handoff 或适配普通工具定义，也不会修改子
-Agent 的 `handoffs`。
+运行时会创建子 Agent 的轻量副本，并追加 `transfer_back_to_main` handoff；模型、工具、
+结构化输出和宿主原有的 `handoffs` 保持不变。子 Agent 完成任务后交还控制权，由主 Agent
+统一回复用户。
 
 只读子 Agent 不添加 `editorTools` 即可，不会自动获得文档修改能力。结构化输出等其它
 SDK 能力直接在创建 Agent 时配置 `outputType`。
@@ -149,14 +151,13 @@ interface EditorDsl {
     | {
         op: 'delete'
         uuid: string
-        confirmToken?: string
       }
   >
 }
 ```
 
 `baseRevision` 必须来自 `get_current_editor`。宿主在应用前校验 revision、组件能力、
-字段作用域和删除确认令牌；整批操作由编辑器原子执行。
+字段作用域；整批操作由编辑器原子执行。
 
 ### 公开 DSL 工具
 

package/dist/{agent-DZUWgLKQ.js → agent-B8UEh-Q5.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-DGG6v34-.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-BxIDwmiL.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

@@ -13,7 +13,7 @@ export interface CreateAgentsOptions {
  */
 export declare function createAgents(options: CreateAgentsOptions): {
     agent: Agent<unknown, "text">;
-    subAgents: AgentSubAgent[];
-    agents: (AgentSubAgent | Agent<unknown, "text">)[];
+    subAgents: Agent<any, any>[];
+    agents: (Agent<any, any> | Agent<unknown, "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":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAGtC,eAAO,MAAM,mBAAmB,kBAAkB,CAAA;AAClD,eAAO,MAAM,qBAAqB,6BAA6B,CAAA;AAE/D,8CAA8C;AAC9C,MAAM,MAAM,aAAa,GAAG,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;AAE3C,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,aAAa,EAAE,CAAA;CAC5B;AAmBD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB;;;;EA+BxD"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAW,MAAM,gBAAgB,CAAA;AAG/C,eAAO,MAAM,mBAAmB,kBAAkB,CAAA;AAClD,eAAO,MAAM,qBAAqB,6BAA6B,CAAA;AAG/D,8CAA8C;AAC9C,MAAM,MAAM,aAAa,GAAG,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;AAE3C,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,aAAa,EAAE,CAAA;CAC5B;AAmBD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB;;;;EAyCxD"}

package/dist/editorDsl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"editorDsl.d.ts","sourceRoot":"","sources":["../src/editorDsl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAc,MAAM,gBAAgB,CAAA;AAC9D,OAAO,KAAK,EAEV,YAAY,EAEb,MAAM,SAAS,CAAA;AAGhB,eAAO,MAAM,4BAA4B,uBAAuB,CAAA;AAChE,eAAO,MAAM,qBAAqB,gBAAgB,CAAA;AAClD,eAAO,MAAM,6BAA6B,wBAAwB,CAAA;AAClE,eAAO,MAAM,0BAA0B,qBAAqB,CAAA;AAC5D,eAAO,MAAM,yBAAyB,oBAAoB,CAAA;AAsH1D,MAAM,WAAW,2BAA2B;IAC1C,mEAAmE;IACnE,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,qDAAqD;IACrD,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAwCD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,YAAY,EACjB,OAAO,GAAE,2BAAgC,GACxC,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAgG/B;AAED,+EAA+E;AAC/E,eAAO,MAAM,iBAAiB,6BAAuB,CAAA"}
+{"version":3,"file":"editorDsl.d.ts","sourceRoot":"","sources":["../src/editorDsl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAc,MAAM,gBAAgB,CAAA;AAC9D,OAAO,KAAK,EAEV,YAAY,EAEb,MAAM,SAAS,CAAA;AAGhB,eAAO,MAAM,4BAA4B,uBAAuB,CAAA;AAChE,eAAO,MAAM,qBAAqB,gBAAgB,CAAA;AAClD,eAAO,MAAM,6BAA6B,wBAAwB,CAAA;AAClE,eAAO,MAAM,0BAA0B,qBAAqB,CAAA;AAC5D,eAAO,MAAM,yBAAyB,oBAAoB,CAAA;AAqH1D,MAAM,WAAW,2BAA2B;IAC1C,mEAAmE;IACnE,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,qDAAqD;IACrD,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAwCD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,YAAY,EACjB,OAAO,GAAE,2BAAgC,GACxC,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAgG/B;AAED,+EAA+E;AAC/E,eAAO,MAAM,iBAAiB,6BAAuB,CAAA"}