@cuylabs/agent-core 4.9.0 → 5.0.0

package/dist/dispatch/executor.d.ts

@@ -0,0 +1,56 @@
+import type { ExternalTaskControl, MemberRuntime, TaskExecutor, TaskExecutorInput } from "../team/coordinator/types.js";
+import type { TeamTask } from "../team/types.js";
+import type { DispatchRecord, DispatchRuntime, DispatchTarget, DispatchTargetInspection, DispatchTargetStartResult, DispatchTargetSummary } from "./types.js";
+export interface DispatchTaskExecutorOptions<RecordT extends DispatchRecord = DispatchRecord, InspectionT extends DispatchTargetInspection = DispatchTargetInspection> {
+    targets: readonly DispatchTarget<RecordT, InspectionT>[];
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+    now?: () => string;
+    resolveTargetName?: (input: TaskExecutorInput) => string;
+    createRecord?: (input: {
+        taskInput: TaskExecutorInput;
+        target: DispatchTarget<RecordT, InspectionT>;
+        dispatchId: string;
+        startedAt: string;
+        startResult: DispatchTargetStartResult;
+    }) => RecordT;
+}
+export interface DispatchExternalTaskControlOptions<RecordT extends DispatchRecord = DispatchRecord, InspectionT extends DispatchTargetInspection = DispatchTargetInspection> {
+    targets: readonly DispatchTarget<RecordT, InspectionT>[];
+    now?: () => string;
+    resolveTargetName?: (input: {
+        task: TeamTask;
+        runtime: MemberRuntime;
+    }) => string;
+    createRecord?: (input: {
+        task: TeamTask;
+        runtime: MemberRuntime;
+        target: DispatchTarget<RecordT, InspectionT>;
+        dispatchId: string;
+        startedAt: string;
+    }) => RecordT;
+}
+export interface DispatchTaskExecutorRoute {
+    matches(input: TaskExecutorInput): boolean;
+    executor: TaskExecutor;
+}
+export interface CompositeDispatchTaskExecutorOptions {
+    routes: readonly DispatchTaskExecutorRoute[];
+    fallback?: TaskExecutor;
+}
+export interface RuntimeDispatchTargetOptions {
+    runtime: DispatchRuntime;
+    filter?: (target: DispatchTargetSummary) => boolean;
+}
+export interface RuntimeDispatchExecutorOptions extends Omit<DispatchTaskExecutorOptions, "targets"> {
+    runtime: DispatchRuntime;
+    filter?: (target: DispatchTargetSummary) => boolean;
+}
+export declare function ensureNonEmpty(input: string, label: string): string;
+export declare function mergeInspection<RecordT extends DispatchRecord, InspectionT extends DispatchTargetInspection>(record: RecordT, inspection: InspectionT | undefined, fallbackNow: string): RecordT;
+export declare function createRuntimeDispatchTargets(options: RuntimeDispatchTargetOptions): DispatchTarget[];
+export declare function createDispatchTaskExecutor<RecordT extends DispatchRecord = DispatchRecord, InspectionT extends DispatchTargetInspection = DispatchTargetInspection>(options: DispatchTaskExecutorOptions<RecordT, InspectionT>): TaskExecutor;
+export declare function createCompositeDispatchTaskExecutor(options: CompositeDispatchTaskExecutorOptions): TaskExecutor;
+export declare function createRuntimeDispatchExecutor(options: RuntimeDispatchExecutorOptions): TaskExecutor;
+export declare function createDispatchExternalTaskControl<RecordT extends DispatchRecord = DispatchRecord, InspectionT extends DispatchTargetInspection = DispatchTargetInspection>(options: DispatchExternalTaskControlOptions<RecordT, InspectionT>): ExternalTaskControl;
+//# sourceMappingURL=executor.d.ts.map

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

@@ -0,0 +1 @@
+{"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,95 +1,7 @@
-import { bz as LocalDispatchRuntimeOptions, a$ as DispatchRuntime, T as Tool, d9 as TaskExecutorInput, d8 as TaskExecutor, aY as DispatchRecord, b3 as DispatchTargetInspection, b2 as DispatchTarget, dr as TeamTask, bF as MemberRuntime, b5 as DispatchTargetStartResult, b6 as DispatchTargetSummary, be as ExternalTaskControl } from '../instance-Bg61WSyz.js';
-export { aP as DEFAULT_DISPATCH_TOOL_IDS, aQ as DEFAULT_LOCAL_DISPATCH_CONCURRENCY, aR as DEFAULT_LOCAL_DISPATCH_DEPTH, aS as DEFAULT_LOCAL_DISPATCH_TITLE_PREFIX, aV as DISPATCH_STATES, aW as DispatchCheckOptions, aX as DispatchListOptions, aZ as DispatchResult, a_ as DispatchRole, b0 as DispatchStartInput, b1 as DispatchState, b4 as DispatchTargetStartInput, b7 as DispatchUsage } from '../instance-Bg61WSyz.js';
-import '../types-C_LCeYNg.js';
-import 'ai';
-import '../types-RSCv7nQ4.js';
-import 'zod';
-import '../types-CQaXbRsS.js';
-import '../types-DMjoFKKv.js';
-import '@modelcontextprotocol/sdk/client/auth.js';
-import '@modelcontextprotocol/sdk/types.js';
-import '@ai-sdk/provider-utils';
-import '../sandbox/index.js';
-import '../llm-error-D93FNNLY.js';
-
-/**
- * Local in-process DispatchRuntime.
- *
- * Launches child agents as background async tasks, tracks them in a Map,
- * and supports redirect (via `agent.intervene()`), cancel (via
- * AbortController), and status polling.
- *
- * @packageDocumentation
- */
-
-/**
- * Create a local in-process `DispatchRuntime`.
- *
- * This is the simplest runtime — child agents are forked from the parent
- * and run as background Promise tasks in the same process. Use
- * `createDaprDispatchRuntime()` for durable distributed dispatch.
- */
-declare function createLocalDispatchRuntime(options: LocalDispatchRuntimeOptions): DispatchRuntime;
-
-/**
- * Create the standard dispatch tools from a `DispatchRuntime`.
- *
- * Returns `start_dispatch`, `check_dispatch`, `redirect_dispatch`,
- * `cancel_dispatch`, and `list_dispatches`.
- */
-declare function createDispatchTools(runtime: DispatchRuntime): Tool.AnyInfo[];
-
-interface DispatchTaskExecutorOptions<RecordT extends DispatchRecord = DispatchRecord, InspectionT extends DispatchTargetInspection = DispatchTargetInspection> {
-    targets: readonly DispatchTarget<RecordT, InspectionT>[];
-    timeoutMs?: number;
-    pollIntervalMs?: number;
-    now?: () => string;
-    resolveTargetName?: (input: TaskExecutorInput) => string;
-    createRecord?: (input: {
-        taskInput: TaskExecutorInput;
-        target: DispatchTarget<RecordT, InspectionT>;
-        dispatchId: string;
-        startedAt: string;
-        startResult: DispatchTargetStartResult;
-    }) => RecordT;
-}
-interface DispatchExternalTaskControlOptions<RecordT extends DispatchRecord = DispatchRecord, InspectionT extends DispatchTargetInspection = DispatchTargetInspection> {
-    targets: readonly DispatchTarget<RecordT, InspectionT>[];
-    now?: () => string;
-    resolveTargetName?: (input: {
-        task: TeamTask;
-        runtime: MemberRuntime;
-    }) => string;
-    createRecord?: (input: {
-        task: TeamTask;
-        runtime: MemberRuntime;
-        target: DispatchTarget<RecordT, InspectionT>;
-        dispatchId: string;
-        startedAt: string;
-    }) => RecordT;
-}
-interface DispatchTaskExecutorRoute {
-    matches(input: TaskExecutorInput): boolean;
-    executor: TaskExecutor;
-}
-interface CompositeDispatchTaskExecutorOptions {
-    routes: readonly DispatchTaskExecutorRoute[];
-    fallback?: TaskExecutor;
-}
-interface RuntimeDispatchTargetOptions {
-    runtime: DispatchRuntime;
-    filter?: (target: DispatchTargetSummary) => boolean;
-}
-interface RuntimeDispatchExecutorOptions extends Omit<DispatchTaskExecutorOptions, "targets"> {
-    runtime: DispatchRuntime;
-    filter?: (target: DispatchTargetSummary) => boolean;
-}
-declare function ensureNonEmpty(input: string, label: string): string;
-declare function mergeInspection<RecordT extends DispatchRecord, InspectionT extends DispatchTargetInspection>(record: RecordT, inspection: InspectionT | undefined, fallbackNow: string): RecordT;
-declare function createRuntimeDispatchTargets(options: RuntimeDispatchTargetOptions): DispatchTarget[];
-declare function createDispatchTaskExecutor<RecordT extends DispatchRecord = DispatchRecord, InspectionT extends DispatchTargetInspection = DispatchTargetInspection>(options: DispatchTaskExecutorOptions<RecordT, InspectionT>): TaskExecutor;
-declare function createCompositeDispatchTaskExecutor(options: CompositeDispatchTaskExecutorOptions): TaskExecutor;
-declare function createRuntimeDispatchExecutor(options: RuntimeDispatchExecutorOptions): TaskExecutor;
-declare function createDispatchExternalTaskControl<RecordT extends DispatchRecord = DispatchRecord, InspectionT extends DispatchTargetInspection = DispatchTargetInspection>(options: DispatchExternalTaskControlOptions<RecordT, InspectionT>): ExternalTaskControl;
-
-export { type CompositeDispatchTaskExecutorOptions, type DispatchExternalTaskControlOptions, DispatchRecord, DispatchRuntime, DispatchTarget, DispatchTargetInspection, DispatchTargetStartResult, DispatchTargetSummary, type DispatchTaskExecutorOptions, type DispatchTaskExecutorRoute, LocalDispatchRuntimeOptions, type RuntimeDispatchExecutorOptions, type RuntimeDispatchTargetOptions, createCompositeDispatchTaskExecutor, createDispatchExternalTaskControl, createDispatchTaskExecutor, createDispatchTools, createLocalDispatchRuntime, createRuntimeDispatchExecutor, createRuntimeDispatchTargets, ensureNonEmpty, mergeInspection };
+export type { DispatchCheckOptions, 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 { 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";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/dispatch/index.js

@@ -15,10 +15,11 @@ import {
   DISPATCH_STATES,
   createDispatchTools,
   createLocalDispatchRuntime
-} from "../chunk-HSUPTXNV.js";
+} from "../chunk-556CPZ3J.js";
+import "../chunk-EDKZOPUV.js";
 import "../chunk-SZ2XBPTW.js";
-import "../chunk-Q742PSH3.js";
-import "../chunk-H3GRHFFG.js";
+import "../chunk-MJML3A2F.js";
+import "../chunk-CGP6UNCQ.js";
 export {
   DEFAULT_DISPATCH_TOOL_IDS,
   DEFAULT_LOCAL_DISPATCH_CONCURRENCY,

package/dist/dispatch/results.d.ts

@@ -0,0 +1,9 @@
+import type { Tool } from "../tool/tool.js";
+import type { DispatchRecord } from "./types.js";
+export declare function formatDispatchStarted(record: DispatchRecord): Tool.ExecuteResult;
+export declare function formatDispatchChecked(record: DispatchRecord): Tool.ExecuteResult;
+export declare function formatDispatchRedirected(record: DispatchRecord): Tool.ExecuteResult;
+export declare function formatDispatchCancelled(record: DispatchRecord): Tool.ExecuteResult;
+export declare function formatDispatchList(records: DispatchRecord[]): Tool.ExecuteResult;
+export declare function formatDispatchError(label: string, error: unknown): Tool.ExecuteResult;
+//# sourceMappingURL=results.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"results.d.ts","sourceRoot":"","sources":["../../src/dispatch/results.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA0BjD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,cAAc,GACrB,IAAI,CAAC,aAAa,CAapB;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,cAAc,GACrB,IAAI,CAAC,aAAa,CAUpB;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,cAAc,GACrB,IAAI,CAAC,aAAa,CAWpB;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,cAAc,GACrB,IAAI,CAAC,aAAa,CAUpB;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,cAAc,EAAE,GACxB,IAAI,CAAC,aAAa,CAmBpB;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,GACb,IAAI,CAAC,aAAa,CAOpB"}

package/dist/dispatch/runtime.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Local in-process DispatchRuntime.
+ *
+ * Launches child agents as background async tasks, tracks them in a Map,
+ * and supports redirect (via `agent.intervene()`), cancel (via
+ * AbortController), and status polling.
+ *
+ * @packageDocumentation
+ */
+import type { DispatchRuntime, LocalDispatchRuntimeOptions } from "./types.js";
+/**
+ * Create a local in-process `DispatchRuntime`.
+ *
+ * This is the simplest runtime — child agents are forked from the parent
+ * and run as background Promise tasks in the same process. Use
+ * `createDaprDispatchRuntime()` for durable distributed dispatch.
+ */
+export declare function createLocalDispatchRuntime(options: LocalDispatchRuntimeOptions): DispatchRuntime;
+//# sourceMappingURL=runtime.d.ts.map

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

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

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

@@ -0,0 +1,8 @@
+import { Tool } from "../tool/tool.js";
+import type { DispatchRuntime } from "./types.js";
+export declare function createDispatchStartTool(runtime: DispatchRuntime): Tool.AnyInfo;
+export declare function createDispatchCheckTool(runtime: DispatchRuntime): Tool.AnyInfo;
+export declare function createDispatchRedirectTool(runtime: DispatchRuntime): Tool.AnyInfo;
+export declare function createDispatchCancelTool(runtime: DispatchRuntime): Tool.AnyInfo;
+export declare function createDispatchListTool(runtime: DispatchRuntime): Tool.AnyInfo;
+//# sourceMappingURL=tool-factories.d.ts.map

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

@@ -0,0 +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"}

package/dist/dispatch/tools.d.ts

@@ -0,0 +1,10 @@
+import type { Tool } from "../tool/tool.js";
+import type { DispatchRuntime } from "./types.js";
+/**
+ * Create the standard dispatch tools from a `DispatchRuntime`.
+ *
+ * Returns `start_dispatch`, `check_dispatch`, `redirect_dispatch`,
+ * `cancel_dispatch`, and `list_dispatches`.
+ */
+export declare function createDispatchTools(runtime: DispatchRuntime): Tool.AnyInfo[];
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/dispatch/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AASlD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC,OAAO,EAAE,CAQ5E"}

package/dist/dispatch/types.d.ts

@@ -0,0 +1,131 @@
+import type { LanguageModel } from "ai";
+import type { Agent } from "../agent/instance/index.js";
+import type { AgentMiddleware } from "../middleware/types.js";
+import type { Profile } from "../profiles/types.js";
+import type { Tool } from "../tool/tool.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"];
+export interface DispatchRole {
+    name: string;
+    description: string;
+    profile?: Profile;
+    systemPrompt?: string;
+    model?: LanguageModel;
+    maxSteps?: number;
+    additionalMiddleware?: AgentMiddleware[];
+    additionalTools?: Tool.AnyInfo[];
+    /**
+     * When false (default), the standard dispatch tools are removed from the
+     * child so background work does not recurse by accident.
+     */
+    allowFurtherDispatch?: boolean;
+}
+export interface DispatchTargetSummary {
+    name: string;
+    description: string;
+}
+export interface DispatchTargetStartInput {
+    id: string;
+    brief: string;
+    title: string;
+    parentSessionId?: string;
+    sessionId?: string;
+}
+export interface DispatchTargetStartResult {
+    sessionId?: string;
+    executionId?: string;
+}
+export interface DispatchUsage {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+}
+export interface DispatchResult {
+    response: string;
+    usage: DispatchUsage;
+    toolCalls: Array<{
+        name: string;
+        result: unknown;
+    }>;
+}
+export interface DispatchRecord {
+    id: string;
+    targetType: string;
+    title: string;
+    brief: string;
+    status: DispatchState;
+    createdAt: string;
+    updatedAt: string;
+    parentSessionId?: string;
+    sessionId?: string;
+    executionId?: string;
+    redirectCount: number;
+    lastRedirect?: string;
+    result?: DispatchResult;
+    error?: string;
+}
+export interface DispatchTargetInspection {
+    status?: DispatchRecord["status"];
+    sessionId?: string;
+    executionId?: string;
+    updatedAt?: string;
+    result?: DispatchResult;
+    error?: string;
+}
+export interface DispatchTarget<RecordT extends DispatchRecord = DispatchRecord, InspectionT extends DispatchTargetInspection = DispatchTargetInspection> {
+    name: string;
+    description: string;
+    start(input: DispatchTargetStartInput): Promise<DispatchTargetStartResult>;
+    redirect(input: {
+        record: RecordT;
+        message: string;
+    }): Promise<void>;
+    cancel(input: {
+        record: RecordT;
+        reason?: string;
+    }): Promise<void>;
+    check?(input: {
+        record: RecordT;
+    }): Promise<InspectionT | undefined>;
+}
+export interface DispatchStartInput {
+    targetType: string;
+    brief: string;
+    title?: string;
+    parentSessionId?: string;
+    abort?: AbortSignal;
+}
+export interface DispatchCheckOptions {
+    waitMs?: number;
+}
+export interface DispatchListOptions {
+    status?: DispatchState | readonly DispatchState[];
+    targetType?: string;
+    parentSessionId?: string;
+}
+export interface DispatchRuntime {
+    describeTargets(): readonly DispatchTargetSummary[];
+    start(input: DispatchStartInput): Promise<DispatchRecord>;
+    check(id: string, options?: DispatchCheckOptions): Promise<DispatchRecord | undefined>;
+    redirect(id: string, message: string): Promise<DispatchRecord>;
+    cancel(id: string, reason?: string): Promise<DispatchRecord>;
+    list(options?: DispatchListOptions): Promise<DispatchRecord[]>;
+}
+export interface LocalDispatchRuntimeOptions {
+    parent: Agent;
+    roles: readonly DispatchRole[];
+    maxConcurrent?: number;
+    maxDepth?: number;
+    currentDepth?: number;
+    sessionTitlePrefix?: string;
+    now?: () => string;
+    createId?: () => string;
+    childToolIds?: readonly string[];
+    createChildTools?: (runtime: DispatchRuntime) => readonly Tool.AnyInfo[];
+    buildChild?: (parent: Agent, role: DispatchRole) => Agent;
+}
+export declare const DEFAULT_LOCAL_DISPATCH_CONCURRENCY = 6;
+export declare const DEFAULT_LOCAL_DISPATCH_DEPTH = 2;
+export declare const DEFAULT_LOCAL_DISPATCH_TITLE_PREFIX = "Dispatch";
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/events/event-bus/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * EventBus — channel-based event streaming for agent runtimes.
+ *
+ * Available via:
+ *   import { createEventBus, type EventBus } from "@cuylabs/agent-core";
+ *   import { createEventBus, type EventBus } from "@cuylabs/agent-core/events";
+ *   import { createEventBus, type EventBus } from "@cuylabs/agent-core/events/event-bus";
+ *
+ * @module
+ */
+export type { EventBus, EventBusMessage, EventBusOptions, EventBusSubscribeOptions, EventBusSubscription, } from "./types.js";
+export { createEventBus } from "./local.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/events/event-bus/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/events/event-bus/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,YAAY,EACV,QAAQ,EACR,eAAe,EACf,eAAe,EACf,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/events/event-bus/index.js

@@ -0,0 +1,6 @@
+import {
+  createEventBus
+} from "../../chunk-CFBSQLP5.js";
+export {
+  createEventBus
+};

package/dist/events/event-bus/local.d.ts

@@ -0,0 +1,14 @@
+/**
+ * In-process EventBus implementation.
+ *
+ * Events are published by producers and consumed by subscribers via
+ * async iterators. Each channel maintains a history buffer for replay
+ * (e.g. SSE `Last-Event-ID` resume). Channels are automatically
+ * cleaned up after a configurable retention period with no subscribers.
+ */
+import type { EventBus, EventBusOptions } from "./types.js";
+/**
+ * Create a new in-process event bus.
+ */
+export declare function createEventBus(options?: EventBusOptions): EventBus;
+//# sourceMappingURL=local.d.ts.map

package/dist/events/event-bus/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../../src/events/event-bus/local.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAmB,eAAe,EAAE,MAAM,YAAY,CAAC;AAuB7E;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,eAAoB,GAAG,QAAQ,CA6NtE"}

package/dist/events/event-bus/types.d.ts

@@ -0,0 +1,78 @@
+/**
+ * EventBus — channel-based event streaming interface.
+ *
+ * Defines how events are published and consumed in a channel-keyed
+ * pub/sub model. The default implementation (`createEventBus`) is
+ * in-process with history replay. A distributed runtime can supply
+ * its own implementation that bridges to external infrastructure
+ * (e.g. Dapr pub/sub, Redis Streams, Kafka).
+ *
+ * Each channel is typically a session ID or workflow instance ID.
+ * Events flow from producers (workflow activities, agent execution)
+ * to consumers (SSE endpoints, WebSocket connections, TUI renderers).
+ */
+export interface EventBusMessage {
+    /** Channel this message was published to. */
+    channel: string;
+    /** Event type — matches AgentEvent.type for agent events. */
+    type: string;
+    /** Serializable event payload. */
+    data: unknown;
+    /** Monotonically increasing sequence within the channel. */
+    seq: number;
+}
+export interface EventBusSubscription {
+    /** Async iterator that yields events as they arrive. */
+    [Symbol.asyncIterator](): AsyncIterableIterator<EventBusMessage>;
+    /** Stop receiving events. Safe to call multiple times. */
+    unsubscribe(): void;
+}
+export interface EventBusSubscribeOptions {
+    /**
+     * Replay messages strictly after this sequence number.
+     * Used to implement SSE resume via `Last-Event-ID`.
+     */
+    afterSeq?: number;
+}
+export interface EventBusOptions {
+    /**
+     * Maximum retained messages per channel for replay.
+     * Older messages are dropped from the head of the history buffer.
+     */
+    maxHistoryMessages?: number;
+    /**
+     * Maximum buffered live messages per subscriber before the subscriber
+     * is disconnected to avoid unbounded memory growth.
+     */
+    maxBufferedMessages?: number;
+    /**
+     * How long (ms) to retain channel history with no active subscribers
+     * so reconnecting clients can resume after transient disconnects.
+     */
+    channelRetentionMs?: number;
+}
+export interface EventBus {
+    /**
+     * Publish an event to all subscribers of `channel`.
+     * Non-blocking — if no one is listening the event is still retained
+     * in the channel history for replay.
+     */
+    publish(channel: string, type: string, data: unknown): void;
+    /**
+     * Subscribe to events on `channel`. Returns an async iterable that
+     * yields events as they arrive and completes when `close(channel)` is
+     * called or the subscription is unsubscribed.
+     */
+    subscribe(channel: string, options?: EventBusSubscribeOptions): EventBusSubscription;
+    /**
+     * Close a channel. All active subscriptions complete their iterators.
+     * Subsequent publishes to this channel start a fresh stream.
+     */
+    close(channel: string, finalEvent?: {
+        type: string;
+        data: unknown;
+    }): void;
+    /** Number of active channels (channels with at least one subscriber). */
+    readonly activeChannels: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/events/event-bus/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/events/event-bus/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAC;CACb;AAMD,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,qBAAqB,CAAC,eAAe,CAAC,CAAC;IACjE,0DAA0D;IAC1D,WAAW,IAAI,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,QAAQ;IACvB;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAE5D;;;;OAIG;IACH,SAAS,CACP,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,wBAAwB,GACjC,oBAAoB,CAAC;IAExB;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAE3E,yEAAyE;IACzE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC"}

package/dist/events/index.d.ts

@@ -1,93 +1,14 @@
 /**
- * EventBus — channel-based event streaming interface.
+ * Event primitives for agent runtimes.
  *
- * Defines how events are published and consumed in a channel-keyed
- * pub/sub model. The default implementation (`createEventBus`) is
- * in-process with history replay. A distributed runtime can supply
- * its own implementation that bridges to external infrastructure
- * (e.g. Dapr pub/sub, Redis Streams, Kafka).
+ * - `AgentSignal` / `LocalSignal`: per-agent, typed, in-process event fan-out.
+ * - `EventBus` / `createEventBus`: channel-based async event streaming with
+ *   replay and backpressure for SSE, WebSocket, and distributed runtimes.
  *
- * Each channel is typically a session ID or workflow instance ID.
- * Events flow from producers (workflow activities, agent execution)
- * to consumers (SSE endpoints, WebSocket connections, TUI renderers).
+ * @module
  */
-interface EventBusMessage {
-    /** Channel this message was published to. */
-    channel: string;
-    /** Event type — matches AgentEvent.type for agent events. */
-    type: string;
-    /** Serializable event payload. */
-    data: unknown;
-    /** Monotonically increasing sequence within the channel. */
-    seq: number;
-}
-interface EventBusSubscription {
-    /** Async iterator that yields events as they arrive. */
-    [Symbol.asyncIterator](): AsyncIterableIterator<EventBusMessage>;
-    /** Stop receiving events. Safe to call multiple times. */
-    unsubscribe(): void;
-}
-interface EventBusSubscribeOptions {
-    /**
-     * Replay messages strictly after this sequence number.
-     * Used to implement SSE resume via `Last-Event-ID`.
-     */
-    afterSeq?: number;
-}
-interface EventBusOptions {
-    /**
-     * Maximum retained messages per channel for replay.
-     * Older messages are dropped from the head of the history buffer.
-     */
-    maxHistoryMessages?: number;
-    /**
-     * Maximum buffered live messages per subscriber before the subscriber
-     * is disconnected to avoid unbounded memory growth.
-     */
-    maxBufferedMessages?: number;
-    /**
-     * How long (ms) to retain channel history with no active subscribers
-     * so reconnecting clients can resume after transient disconnects.
-     */
-    channelRetentionMs?: number;
-}
-interface EventBus {
-    /**
-     * Publish an event to all subscribers of `channel`.
-     * Non-blocking — if no one is listening the event is still retained
-     * in the channel history for replay.
-     */
-    publish(channel: string, type: string, data: unknown): void;
-    /**
-     * Subscribe to events on `channel`. Returns an async iterable that
-     * yields events as they arrive and completes when `close(channel)` is
-     * called or the subscription is unsubscribed.
-     */
-    subscribe(channel: string, options?: EventBusSubscribeOptions): EventBusSubscription;
-    /**
-     * Close a channel. All active subscriptions complete their iterators.
-     * Subsequent publishes to this channel start a fresh stream.
-     */
-    close(channel: string, finalEvent?: {
-        type: string;
-        data: unknown;
-    }): void;
-    /** Number of active channels (channels with at least one subscriber). */
-    readonly activeChannels: number;
-}
-
-/**
- * In-process EventBus implementation.
- *
- * Events are published by producers and consumed by subscribers via
- * async iterators. Each channel maintains a history buffer for replay
- * (e.g. SSE `Last-Event-ID` resume). Channels are automatically
- * cleaned up after a configurable retention period with no subscribers.
- */
-
-/**
- * Create a new in-process event bus.
- */
-declare function createEventBus(options?: EventBusOptions): EventBus;
-
-export { type EventBus, type EventBusMessage, type EventBusOptions, type EventBusSubscribeOptions, type EventBusSubscription, createEventBus };
+export type { AgentSignal } from "./signal/index.js";
+export { LocalSignal } from "./signal/index.js";
+export type { EventBus, EventBusMessage, EventBusOptions, EventBusSubscribeOptions, EventBusSubscription, } from "./event-bus/index.js";
+export { createEventBus } from "./event-bus/index.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,YAAY,EACV,QAAQ,EACR,eAAe,EACf,eAAe,EACf,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}