@cuylabs/agent-core 5.3.0 → 5.5.0

package/dist/{chunk-MO7V4H4A.js → chunk-ZETYNQ35.js}

@@ -236,15 +236,19 @@ Use \`check_dispatch\` to monitor progress after starting.`,
       ),
       brief: z.string().describe("Detailed instructions for the dispatch target."),
       title: z.string().optional().describe("Short title for tracking."),
-      parentSessionId: z.string().optional().describe("Parent session ID for context linking.")
+      parentSessionId: z.string().optional().describe("Parent session ID for context linking."),
+      parentTurnId: z.string().optional().describe("Parent turn ID for context linking.")
     }),
-    execute: async (params) => {
+    execute: async (params, ctx) => {
       try {
         const record = await runtime.start({
           targetType: params.targetType,
           brief: params.brief,
           title: params.title,
-          parentSessionId: params.parentSessionId
+          parentSessionId: params.parentSessionId ?? ctx.sessionID,
+          parentTurnId: params.parentTurnId ?? ctx.turnID,
+          abort: ctx.abort,
+          emitEvent: ctx.emitEvent
         });
         return formatDispatchStarted(record);
       } catch (error) {
@@ -320,14 +324,16 @@ function createDispatchListTool(runtime) {
         'Filter by status: "running", "completed", "failed", "cancelled".'
       ),
       targetType: z.string().optional().describe("Filter by target type."),
-      parentSessionId: z.string().optional().describe("Filter by parent session.")
+      parentSessionId: z.string().optional().describe("Filter by parent session."),
+      parentTurnId: z.string().optional().describe("Filter by parent turn.")
     }),
     execute: async (params) => {
       try {
         const records = await runtime.list({
           status: params.status,
           targetType: params.targetType,
-          parentSessionId: params.parentSessionId
+          parentSessionId: params.parentSessionId,
+          parentTurnId: params.parentTurnId
         });
         return formatDispatchList(records);
       } catch (error) {
@@ -350,6 +356,167 @@ function createDispatchTools(runtime) {
 
 // src/dispatch/runtime.ts
 import { randomUUID } from "crypto";
+var EMPTY_DISPATCH_USAGE = {
+  inputTokens: 0,
+  outputTokens: 0,
+  totalTokens: 0
+};
+function dispatchEventContext(record) {
+  return {
+    dispatchId: record.id,
+    role: record.targetType,
+    title: record.title,
+    parentSessionId: record.parentSessionId,
+    parentTurnId: record.parentTurnId,
+    parentDispatchId: record.parentDispatchId,
+    depth: record.depth,
+    agentPath: record.agentPath,
+    childSessionId: record.sessionId,
+    executionId: record.executionId
+  };
+}
+async function emitDispatchProgress(emitEvent, event) {
+  if (!emitEvent) {
+    return;
+  }
+  try {
+    await emitEvent(event);
+  } catch {
+  }
+}
+async function appendDispatchEvent(options) {
+  if (!options.eventStore) {
+    return;
+  }
+  try {
+    await options.eventStore.append({
+      dispatchId: options.record.id,
+      targetType: options.record.targetType,
+      title: options.record.title,
+      parentSessionId: options.record.parentSessionId,
+      parentTurnId: options.record.parentTurnId,
+      parentDispatchId: options.record.parentDispatchId,
+      depth: options.record.depth,
+      agentPath: options.record.agentPath,
+      childSessionId: options.record.sessionId,
+      executionId: options.record.executionId,
+      createdAt: options.now(),
+      event: options.event
+    });
+  } catch {
+  }
+}
+async function publishDispatchProgress(options) {
+  await appendDispatchEvent({
+    eventStore: options.eventStore,
+    record: options.record,
+    event: options.event,
+    now: options.now
+  });
+  await emitDispatchProgress(options.emitEvent, options.event);
+}
+function shouldForwardChildEvent(event) {
+  switch (event.type) {
+    case "status":
+    case "tool-start":
+    case "tool-result":
+    case "tool-error":
+    case "approval-request":
+    case "approval-resolved":
+    case "human-input-request":
+    case "human-input-resolved":
+    case "error":
+      return true;
+    default:
+      return false;
+  }
+}
+function isSubAgentProgressEvent(event) {
+  switch (event.type) {
+    case "subagent-start":
+    case "subagent-event":
+    case "subagent-complete":
+    case "subagent-error":
+      return true;
+    default:
+      return false;
+  }
+}
+function joinDispatchAgentPath(parentAgentPath, dispatchId) {
+  const parent = parentAgentPath?.replace(/\/+$/g, "") ?? "";
+  const child = dispatchId.replace(/^\/+/g, "");
+  return parent ? `${parent}/${child}` : child;
+}
+async function cancelRunningChildDispatches(runtime, reason) {
+  if (!runtime) {
+    return;
+  }
+  const running = await runtime.list({ status: "running" });
+  await Promise.all(
+    running.map(async (record) => {
+      try {
+        await runtime.cancel(record.id, reason);
+      } catch {
+      }
+    })
+  );
+}
+async function runChildDispatchWithProgress(options) {
+  let response = "";
+  let usage = EMPTY_DISPATCH_USAGE;
+  const toolCalls = [];
+  const context = dispatchEventContext(options.record);
+  for await (const event of options.child.chat(
+    options.sessionId,
+    options.message,
+    {
+      abort: options.abort
+    }
+  )) {
+    if (isSubAgentProgressEvent(event)) {
+      await emitDispatchProgress(options.emitEvent, event);
+      continue;
+    }
+    if (shouldForwardChildEvent(event)) {
+      await publishDispatchProgress({
+        eventStore: options.eventStore,
+        record: options.record,
+        now: options.now,
+        emitEvent: options.emitEvent,
+        event: {
+          type: "subagent-event",
+          ...context,
+          event
+        }
+      });
+    }
+    switch (event.type) {
+      case "text-delta":
+        response += event.text;
+        break;
+      case "tool-result":
+        toolCalls.push({ name: event.toolName, result: event.result });
+        break;
+      case "complete":
+        if (event.usage) {
+          usage = {
+            inputTokens: event.usage.inputTokens ?? 0,
+            outputTokens: event.usage.outputTokens ?? 0,
+            totalTokens: event.usage.totalTokens ?? 0
+          };
+        }
+        if (event.output !== void 0) {
+          response = event.output;
+        }
+        break;
+      case "error":
+        throw event.error;
+      default:
+        break;
+    }
+  }
+  return { response, usage, toolCalls };
+}
 function allowsFurtherDispatch(role) {
   return role.allowFurtherDispatch ?? false;
 }
@@ -415,6 +582,9 @@ function buildRoleChild(parent, role) {
   if (role.model) {
     forkOptions.model = role.model;
   }
+  if (role.reasoningLevel) {
+    forkOptions.reasoningLevel = role.reasoningLevel;
+  }
   if (role.maxSteps) {
     forkOptions.maxSteps = role.maxSteps;
   }
@@ -434,39 +604,46 @@ function createLocalDispatchRuntime(options) {
     maxConcurrent = DEFAULT_LOCAL_DISPATCH_CONCURRENCY,
     maxDepth = DEFAULT_LOCAL_DISPATCH_DEPTH,
     currentDepth = 0,
+    parentDispatchId: runtimeParentDispatchId,
+    parentAgentPath,
     sessionTitlePrefix = DEFAULT_LOCAL_DISPATCH_TITLE_PREFIX,
     now = () => (/* @__PURE__ */ new Date()).toISOString(),
     createId = () => randomUUID(),
     childToolIds = DEFAULT_DISPATCH_TOOL_IDS,
     createChildTools = createDispatchTools,
-    buildChild: customBuildChild
+    buildChild: customBuildChild,
+    eventStore
   } = options;
   const dispatches = /* @__PURE__ */ new Map();
   const roleIndex = new Map(roles.map((role) => [role.name, role]));
-  function buildChild(role) {
+  function buildChild(role, scope) {
     const child = customBuildChild ? customBuildChild(parent, role) : buildRoleChild(parent, role);
     for (const toolId of childToolIds) {
       child.removeTool?.(toolId);
     }
-    if (allowsFurtherDispatch(role) && currentDepth + 1 < maxDepth) {
+    if (allowsFurtherDispatch(role) && scope.childDepth < maxDepth) {
       const childRuntime = createLocalDispatchRuntime({
         parent: child,
         roles,
         maxConcurrent,
         maxDepth,
-        currentDepth: currentDepth + 1,
+        currentDepth: scope.childDepth,
+        parentDispatchId: scope.parentDispatchId,
+        parentAgentPath: scope.parentAgentPath,
         sessionTitlePrefix,
         now,
         createId,
         childToolIds,
         createChildTools,
-        buildChild: customBuildChild
+        buildChild: customBuildChild,
+        eventStore
       });
       for (const tool of createChildTools(childRuntime)) {
         child.addTool(tool);
       }
+      return { child, childRuntime };
     }
-    return child;
+    return { child };
   }
   function describeTargets() {
     return roles.map((role) => ({
@@ -495,10 +672,17 @@ function createLocalDispatchRuntime(options) {
       );
     }
     const id = createId();
-    const child = buildChild(role);
     const abort = new AbortController();
     const timestamp = now();
     const title = input.title ?? `${sessionTitlePrefix}: ${role.name}`;
+    const depth = input.depth ?? currentDepth;
+    const parentDispatchId = input.parentDispatchId ?? runtimeParentDispatchId;
+    const agentPath = input.agentPath ?? joinDispatchAgentPath(parentAgentPath, id);
+    const { child, childRuntime } = buildChild(role, {
+      parentDispatchId: id,
+      parentAgentPath: agentPath,
+      childDepth: depth + 1
+    });
     if (input.abort) {
       if (input.abort.aborted) {
         abort.abort(input.abort.reason);
@@ -525,13 +709,40 @@ function createLocalDispatchRuntime(options) {
       createdAt: timestamp,
       updatedAt: timestamp,
       parentSessionId: input.parentSessionId,
+      parentTurnId: input.parentTurnId,
+      parentDispatchId,
+      depth,
+      agentPath,
       sessionId,
       executionId: id,
       redirectCount: 0
     };
     const promise = (async () => {
       try {
-        const result = await child.send(sessionId, input.brief, {
+        const shouldCaptureProgress = Boolean(input.emitEvent || eventStore);
+        const startEvent = {
+          type: "subagent-start",
+          ...dispatchEventContext(record)
+        };
+        if (shouldCaptureProgress) {
+          await publishDispatchProgress({
+            eventStore,
+            record,
+            event: startEvent,
+            now,
+            emitEvent: input.emitEvent
+          });
+        }
+        const result = shouldCaptureProgress ? await runChildDispatchWithProgress({
+          child,
+          sessionId,
+          message: input.brief,
+          abort: abort.signal,
+          record,
+          eventStore,
+          now,
+          ...input.emitEvent ? { emitEvent: input.emitEvent } : {}
+        }) : await child.send(sessionId, input.brief, {
           abort: abort.signal
         });
         const active = dispatches.get(id);
@@ -547,21 +758,58 @@ function createLocalDispatchRuntime(options) {
             },
             toolCalls: result.toolCalls ?? []
           };
+          if (shouldCaptureProgress) {
+            await publishDispatchProgress({
+              eventStore,
+              record: active.record,
+              now,
+              emitEvent: input.emitEvent,
+              event: {
+                type: "subagent-complete",
+                ...dispatchEventContext(active.record),
+                output: active.record.result.response,
+                usage: active.record.result.usage,
+                toolCalls: active.record.result.toolCalls
+              }
+            });
+          }
         }
       } catch (error) {
         const active = dispatches.get(id);
         if (active && active.record.status === "running") {
           if (abort.signal.aborted) {
             active.record.status = "cancelled";
+            active.record.error = String(abort.signal.reason ?? "Cancelled");
           } else {
             active.record.status = "failed";
             active.record.error = error instanceof Error ? error.message : String(error);
           }
           active.record.updatedAt = now();
+          if (input.emitEvent || eventStore) {
+            await publishDispatchProgress({
+              eventStore,
+              record: active.record,
+              now,
+              emitEvent: input.emitEvent,
+              event: {
+                type: "subagent-error",
+                ...dispatchEventContext(active.record),
+                status: active.record.status,
+                error: active.record.error ?? active.record.status
+              }
+            });
+          }
         }
       }
     })();
-    dispatches.set(id, { record, child, abort, promise });
+    dispatches.set(id, {
+      record,
+      child,
+      ...childRuntime ? { childRuntime } : {},
+      abort,
+      promise,
+      ...input.emitEvent ? { emitEvent: input.emitEvent } : {}
+    });
     return { ...record };
   }
   async function check(id, options2) {
@@ -599,14 +847,34 @@ function createLocalDispatchRuntime(options) {
       throw new Error(`No dispatch with ID "${id}".`);
     }
     if (active.record.status !== "running") {
+      await cancelRunningChildDispatches(
+        active.childRuntime,
+        reason ?? "Parent dispatch closed"
+      );
       return { ...active.record };
     }
-    active.abort.abort(reason ?? "Cancelled");
     active.record.status = "cancelled";
     active.record.updatedAt = now();
     if (reason) {
       active.record.error = reason;
     }
+    active.abort.abort(reason ?? "Cancelled");
+    await cancelRunningChildDispatches(
+      active.childRuntime,
+      reason ?? "Parent dispatch cancelled"
+    );
+    await publishDispatchProgress({
+      eventStore,
+      record: active.record,
+      now,
+      emitEvent: active.emitEvent,
+      event: {
+        type: "subagent-error",
+        ...dispatchEventContext(active.record),
+        status: "cancelled",
+        error: active.record.error ?? "Cancelled"
+      }
+    });
     return { ...active.record };
   }
   async function list(options2) {
@@ -623,6 +891,17 @@ function createLocalDispatchRuntime(options) {
         (r) => r.parentSessionId === options2.parentSessionId
       );
     }
+    if (options2?.parentTurnId) {
+      records = records.filter((r) => r.parentTurnId === options2.parentTurnId);
+    }
+    if (options2?.parentDispatchId) {
+      records = records.filter(
+        (r) => r.parentDispatchId === options2.parentDispatchId
+      );
+    }
+    if (options2?.agentPath) {
+      records = records.filter((r) => r.agentPath === options2.agentPath);
+    }
     return records;
   }
   return {
@@ -631,7 +910,8 @@ function createLocalDispatchRuntime(options) {
     check,
     redirect,
     cancel,
-    list
+    list,
+    listEvents: async (filter) => eventStore?.list(filter) ?? []
   };
 }
 

package/dist/dispatch/event-store.d.ts

@@ -0,0 +1,15 @@
+import type { DispatchEventFilter, DispatchEventRecord, DispatchEventRecordInput, DispatchEventStore } from "./types.js";
+/**
+ * In-memory dispatch event store.
+ *
+ * Useful for tests and single-process hosts. Production hosts that need
+ * restart-safe background dispatch history should provide a durable
+ * implementation of `DispatchEventStore`.
+ */
+export declare class InMemoryDispatchEventStore implements DispatchEventStore {
+    private events;
+    private sequence;
+    append(event: DispatchEventRecordInput): Promise<DispatchEventRecord>;
+    list(filter?: DispatchEventFilter): Promise<DispatchEventRecord[]>;
+}
+//# sourceMappingURL=event-store.d.ts.map

package/dist/dispatch/event-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-store.d.ts","sourceRoot":"","sources":["../../src/dispatch/event-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AA8DpB;;;;;;GAMG;AACH,qBAAa,0BAA2B,YAAW,kBAAkB;IACnE,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,QAAQ,CAAK;IAEf,MAAM,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAWrE,IAAI,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;CAKzE"}

package/dist/dispatch/executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/dispatch/executor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/dispatch/executor.ts"],"names":[],"mappings":"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"}

package/dist/dispatch/index.d.ts

@@ -1,6 +1,7 @@
-export type { DispatchCheckOptions, DispatchListOptions, DispatchRole, DispatchRecord, DispatchResult, DispatchRuntime, DispatchStartInput, DispatchState, DispatchTarget, DispatchTargetInspection, DispatchTargetStartInput, DispatchTargetStartResult, DispatchTargetSummary, DispatchUsage, LocalDispatchRuntimeOptions, } from "./types.js";
+export type { DispatchCheckOptions, DispatchEventFilter, DispatchEventRecord, DispatchEventRecordInput, DispatchEventStore, DispatchEventSink, DispatchListOptions, DispatchRole, DispatchRecord, DispatchResult, DispatchRuntime, DispatchStartInput, DispatchState, DispatchTarget, DispatchTargetInspection, DispatchTargetStartInput, DispatchTargetStartResult, DispatchTargetSummary, DispatchUsage, LocalDispatchRuntimeOptions, } from "./types.js";
 export { DISPATCH_STATES, DEFAULT_DISPATCH_TOOL_IDS, DEFAULT_LOCAL_DISPATCH_CONCURRENCY, DEFAULT_LOCAL_DISPATCH_DEPTH, DEFAULT_LOCAL_DISPATCH_TITLE_PREFIX, } from "./types.js";
 export { createLocalDispatchRuntime } from "./runtime.js";
+export { InMemoryDispatchEventStore } from "./event-store.js";
 export { createDispatchTools } from "./tools.js";
 export type { CompositeDispatchTaskExecutorOptions, DispatchExternalTaskControlOptions, DispatchTaskExecutorOptions, DispatchTaskExecutorRoute, RuntimeDispatchExecutorOptions, RuntimeDispatchTargetOptions, } from "./executor.js";
 export { createCompositeDispatchTaskExecutor, createDispatchExternalTaskControl, createDispatchTaskExecutor, createRuntimeDispatchExecutor, createRuntimeDispatchTargets, ensureNonEmpty, mergeInspection, } from "./executor.js";

package/dist/dispatch/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dispatch/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,wBAAwB,EACxB,wBAAwB,EACxB,yBAAyB,EACzB,qBAAqB,EACrB,aAAa,EACb,2BAA2B,GAC5B,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,kCAAkC,EAClC,4BAA4B,EAC5B,mCAAmC,GACpC,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EACV,oCAAoC,EACpC,kCAAkC,EAClC,2BAA2B,EAC3B,yBAAyB,EACzB,8BAA8B,EAC9B,4BAA4B,GAC7B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,mCAAmC,EACnC,iCAAiC,EACjC,0BAA0B,EAC1B,6BAA6B,EAC7B,4BAA4B,EAC5B,cAAc,EACd,eAAe,GAChB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dispatch/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,wBAAwB,EACxB,wBAAwB,EACxB,yBAAyB,EACzB,qBAAqB,EACrB,aAAa,EACb,2BAA2B,GAC5B,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,kCAAkC,EAClC,4BAA4B,EAC5B,mCAAmC,GACpC,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EACV,oCAAoC,EACpC,kCAAkC,EAClC,2BAA2B,EAC3B,yBAAyB,EACzB,8BAA8B,EAC9B,4BAA4B,GAC7B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,mCAAmC,EACnC,iCAAiC,EACjC,0BAA0B,EAC1B,6BAA6B,EAC7B,4BAA4B,EAC5B,cAAc,EACd,eAAe,GAChB,MAAM,eAAe,CAAC"}

package/dist/dispatch/index.js

@@ -1,4 +1,5 @@
 import {
+  InMemoryDispatchEventStore,
   createCompositeDispatchTaskExecutor,
   createDispatchExternalTaskControl,
   createDispatchTaskExecutor,
@@ -6,7 +7,7 @@ import {
   createRuntimeDispatchTargets,
   ensureNonEmpty,
   mergeInspection
-} from "../chunk-JZRLCTSD.js";
+} from "../chunk-2BRLPF3Z.js";
 import {
   DEFAULT_DISPATCH_TOOL_IDS,
   DEFAULT_LOCAL_DISPATCH_CONCURRENCY,
@@ -15,7 +16,7 @@ import {
   DISPATCH_STATES,
   createDispatchTools,
   createLocalDispatchRuntime
-} from "../chunk-MO7V4H4A.js";
+} from "../chunk-ZETYNQ35.js";
 import "../chunk-EDKZOPUV.js";
 import "../chunk-SZ2XBPTW.js";
 import "../chunk-MJML3A2F.js";
@@ -26,6 +27,7 @@ export {
   DEFAULT_LOCAL_DISPATCH_DEPTH,
   DEFAULT_LOCAL_DISPATCH_TITLE_PREFIX,
   DISPATCH_STATES,
+  InMemoryDispatchEventStore,
   createCompositeDispatchTaskExecutor,
   createDispatchExternalTaskControl,
   createDispatchTaskExecutor,

package/dist/dispatch/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/dispatch/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EAKV,eAAe,EAIf,2BAA2B,EAC5B,MAAM,YAAY,CAAC;AAmHpB;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,2BAA2B,GACnC,eAAe,CA2PjB"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/dispatch/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,OAAO,KAAK,EAQV,eAAe,EAIf,2BAA2B,EAC5B,MAAM,YAAY,CAAC;AA4VpB;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,2BAA2B,GACnC,eAAe,CAwXjB"}

package/dist/dispatch/tool-factories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-factories.d.ts","sourceRoot":"","sources":["../../src/dispatch/tool-factories.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,KAAK,EAAE,eAAe,EAAyB,MAAM,YAAY,CAAC;AAmBzE,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,eAAe,GACvB,IAAI,CAAC,OAAO,CAsCd;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,eAAe,GACvB,IAAI,CAAC,OAAO,CA6Bd;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,eAAe,GACvB,IAAI,CAAC,OAAO,CAkBd;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,eAAe,GACvB,IAAI,CAAC,OAAO,CAiBd;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC,OAAO,CA8B7E"}
+{"version":3,"file":"tool-factories.d.ts","sourceRoot":"","sources":["../../src/dispatch/tool-factories.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,KAAK,EAAE,eAAe,EAAyB,MAAM,YAAY,CAAC;AAmBzE,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,eAAe,GACvB,IAAI,CAAC,OAAO,CA6Cd;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,eAAe,GACvB,IAAI,CAAC,OAAO,CA6Bd;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,eAAe,GACvB,IAAI,CAAC,OAAO,CAkBd;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,eAAe,GACvB,IAAI,CAAC,OAAO,CAiBd;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC,OAAO,CAgC7E"}

package/dist/dispatch/types.d.ts

@@ -1,9 +1,11 @@
 import type { LanguageModel } from "ai";
 import type { Agent } from "../agent/instance/index.js";
 import type { AgentMiddleware } from "../middleware/types.js";
+import type { ReasoningLevel } from "../models/reasoning/index.js";
 import type { Profile } from "../profiles/types.js";
 import type { PromptConfig } from "../prompt/types.js";
 import type { Tool } from "../tool/tool.js";
+import type { AgentEvent } from "../types/events.js";
 export declare const DISPATCH_STATES: readonly ["running", "completed", "failed", "cancelled"];
 export type DispatchState = (typeof DISPATCH_STATES)[number];
 export declare const DEFAULT_DISPATCH_TOOL_IDS: readonly ["start_dispatch", "check_dispatch", "redirect_dispatch", "cancel_dispatch", "list_dispatches"];
@@ -14,6 +16,7 @@ export interface DispatchRole {
     systemPrompt?: string;
     prompt?: PromptConfig;
     model?: LanguageModel;
+    reasoningLevel?: ReasoningLevel;
     skills?: string[];
     maxSteps?: number;
     additionalMiddleware?: AgentMiddleware[];
@@ -33,7 +36,12 @@ export interface DispatchTargetStartInput {
     brief: string;
     title: string;
     parentSessionId?: string;
+    parentTurnId?: string;
+    parentDispatchId?: string;
+    depth?: number;
+    agentPath?: string;
     sessionId?: string;
+    abort?: AbortSignal;
 }
 export interface DispatchTargetStartResult {
     sessionId?: string;
@@ -52,6 +60,49 @@ export interface DispatchResult {
         result: unknown;
     }>;
 }
+export type DispatchEventSink = (event: AgentEvent) => void | Promise<void>;
+/** Input accepted by a dispatch event store before it assigns identity. */
+export interface DispatchEventRecordInput {
+    dispatchId: string;
+    targetType: string;
+    title: string;
+    parentSessionId?: string;
+    parentTurnId?: string;
+    parentDispatchId?: string;
+    depth?: number;
+    agentPath?: string;
+    childSessionId?: string;
+    executionId?: string;
+    createdAt: string;
+    event: AgentEvent;
+}
+/** A stored dispatch event with store-assigned identity and ordering. */
+export interface DispatchEventRecord extends DispatchEventRecordInput {
+    id: string;
+    sequence: number;
+}
+/** Query filter for dispatch event history. */
+export interface DispatchEventFilter {
+    dispatchId?: string;
+    parentSessionId?: string;
+    parentTurnId?: string;
+    parentDispatchId?: string;
+    agentPath?: string;
+    childSessionId?: string;
+    targetType?: string;
+    type?: AgentEvent["type"] | readonly AgentEvent["type"][];
+    afterSequence?: number;
+}
+/**
+ * Separate persistence surface for dispatch/subagent progress.
+ *
+ * Implementations should store UI/audit progress outside session chat history
+ * so child-agent activity does not pollute the parent model context.
+ */
+export interface DispatchEventStore {
+    append(event: DispatchEventRecordInput): Promise<DispatchEventRecord>;
+    list(filter?: DispatchEventFilter): Promise<DispatchEventRecord[]>;
+}
 export interface DispatchRecord {
     id: string;
     targetType: string;
@@ -61,6 +112,10 @@ export interface DispatchRecord {
     createdAt: string;
     updatedAt: string;
     parentSessionId?: string;
+    parentTurnId?: string;
+    parentDispatchId?: string;
+    depth?: number;
+    agentPath?: string;
     sessionId?: string;
     executionId?: string;
     redirectCount: number;
@@ -97,7 +152,13 @@ export interface DispatchStartInput {
     brief: string;
     title?: string;
     parentSessionId?: string;
+    parentTurnId?: string;
+    parentDispatchId?: string;
+    depth?: number;
+    agentPath?: string;
     abort?: AbortSignal;
+    /** Optional parent turn event sink for live child progress forwarding. */
+    emitEvent?: DispatchEventSink;
 }
 export interface DispatchCheckOptions {
     waitMs?: number;
@@ -106,6 +167,9 @@ export interface DispatchListOptions {
     status?: DispatchState | readonly DispatchState[];
     targetType?: string;
     parentSessionId?: string;
+    parentTurnId?: string;
+    parentDispatchId?: string;
+    agentPath?: string;
 }
 export interface DispatchRuntime {
     describeTargets(): readonly DispatchTargetSummary[];
@@ -114,6 +178,7 @@ export interface DispatchRuntime {
     redirect(id: string, message: string): Promise<DispatchRecord>;
     cancel(id: string, reason?: string): Promise<DispatchRecord>;
     list(options?: DispatchListOptions): Promise<DispatchRecord[]>;
+    listEvents?(filter?: DispatchEventFilter): Promise<DispatchEventRecord[]>;
 }
 export interface LocalDispatchRuntimeOptions {
     parent: Agent;
@@ -121,12 +186,15 @@ export interface LocalDispatchRuntimeOptions {
     maxConcurrent?: number;
     maxDepth?: number;
     currentDepth?: number;
+    parentDispatchId?: string;
+    parentAgentPath?: string;
     sessionTitlePrefix?: string;
     now?: () => string;
     createId?: () => string;
     childToolIds?: readonly string[];
     createChildTools?: (runtime: DispatchRuntime) => readonly Tool.AnyInfo[];
     buildChild?: (parent: Agent, role: DispatchRole) => Agent;
+    eventStore?: DispatchEventStore;
 }
 export declare const DEFAULT_LOCAL_DISPATCH_CONCURRENCY = 6;
 export declare const DEFAULT_LOCAL_DISPATCH_DEPTH = 2;