@sepveneto/dnde-agent 0.2.0 → 0.2.2

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/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/{agent-DZUWgLKQ.js → chunks/agent-C7KN73yy.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, l as x, m as X, t as v, o as I, s as y, n as Z, w as A, p as q, q as ee, u as te, v as k, x as R, y as C, i as se, S as ie, z as ne, B as re, E as ae } from "./index-DeZzIl57.js";
 function oe(t) {
   return t ? !(typeof t == "object" && t && "constructor" in t && typeof t.constructor == "function" ? t.constructor.name : "").includes("ChatCompletions") : !0;
 }
@@ -280,9 +280,9 @@ function T(t) {
     if (n.startsWith(D))
       r = xe(s, i);
     else if (n.startsWith(M))
-      r = Ie(s, i);
-    else if (n.startsWith(F))
       r = ve(s, i);
+    else if (n.startsWith(F))
+      r = Ie(s, i);
     else
       return {
         ok: !1,
@@ -320,7 +320,7 @@ function xe(t, s) {
     nextIndex: s
   };
 }
-function Ie(t, s) {
+function ve(t, s) {
   const e = S(t[s], M);
   return e ? (s += 1, s < t.length - 1 && !N(t[s]) ? { error: `Delete File patch for ${e} must not include a diff.` } : {
     operation: {
@@ -330,7 +330,7 @@ function Ie(t, s) {
     nextIndex: s
   }) : { error: `Missing path in apply_patch header: ${t[s]}` };
 }
-function ve(t, s) {
+function Ie(t, s) {
   const e = S(t[s], F);
   if (!e)
     return { error: `Missing path in apply_patch header: ${t[s]}` };
@@ -443,17 +443,17 @@ class Ee extends E {
         return ke(o, f);
       }
     };
-    return G(this._modelInstance) ? r.push(I({
+    return G(this._modelInstance) ? r.push(v({
       name: "view_image",
       description: "Returns an image output from a path in the sandbox workspace or an explicitly granted sandbox path.",
-      parameters: v({
+      parameters: I({
         path: y().describe("Path to an image file in the sandbox workspace or an explicitly granted sandbox path")
       }),
       execute: async ({ path: o }, h, c) => await l(o, c)
-    })) : r.push(I({
+    })) : r.push(v({
       name: "view_image",
       description: "Returns an image from a path in the sandbox workspace or an explicitly granted sandbox path as a data URL or reference string.",
-      parameters: v({
+      parameters: I({
         path: y().describe("Path to an image file in the sandbox workspace or an explicitly granted sandbox path")
       }),
       execute: async ({ path: o }, h, c) => we(await l(o, c))
@@ -499,10 +499,10 @@ class Ne extends E {
     if (!e.execCommand)
       throw new x("Shell sandbox sessions must provide execCommand().");
     const i = [
-      I({
+      v({
         name: "exec_command",
         description: "Runs a command in a PTY, returning output or a session ID for ongoing interaction.",
-        parameters: v({
+        parameters: I({
           cmd: y().min(1).describe("Shell command to execute."),
           workdir: y().optional().describe("Optional working directory to run the command in; defaults to the turn cwd."),
           shell: y().optional().describe("Shell binary to launch. Defaults to the user's default shell."),
@@ -534,10 +534,10 @@ class Ne extends E {
         }
       })
     ];
-    return (n = e.supportsPty) != null && n.call(e) && e.writeStdin && i.push(I({
+    return (n = e.supportsPty) != null && n.call(e) && e.writeStdin && i.push(v({
       name: "write_stdin",
       description: "Writes characters to an existing unified exec session and returns recent output.",
-      parameters: v({
+      parameters: I({
         session_id: k().int().describe("Identifier of the running unified exec session."),
         chars: y().default("").describe("Bytes to write to stdin (may be empty to poll)."),
         yield_time_ms: k().int().min(0).default(Fe).describe("How long to wait (in milliseconds) for output before yielding."),
@@ -607,12 +607,12 @@ function Le() {
 const We = {
   default: Le
 };
-var H, z;
-class J extends (z = se, H = ie, z) {
+var z, H;
+class J extends (H = se, z = ie, H) {
   constructor(e) {
     var i, n;
     super(e);
-    a(this, H, !0);
+    a(this, z, !0);
     a(this, "defaultManifest");
     a(this, "baseInstructions");
     a(this, "capabilities");