@dexto/orchestration 1.5.8 → 1.6.1

package/dist/index.d.ts

@@ -1,11 +1,42 @@
-export { AgentController, AgentControllerConfig } from './agent-controller.js';
-export { SignalBus, SignalHandler, SignalPredicate } from './signal-bus.js';
-export { TaskRegistry, TaskRegistryConfig } from './task-registry.js';
+/**
+ * @dexto/orchestration
+ *
+ * Agent orchestration layer for background task management,
+ * event-driven completion handling, and async workflows.
+ *
+ * Key components:
+ * - TaskRegistry: Tracks background tasks and their results
+ * - SignalBus: Routes completion signals between components
+ * - ConditionEngine: Evaluates composable wait conditions
+ *
+ * Example usage:
+ * ```typescript
+ * import { ConditionEngine, SignalBus, TaskRegistry } from '@dexto/orchestration';
+ *
+ * const signalBus = new SignalBus();
+ * const taskRegistry = new TaskRegistry(signalBus);
+ * const conditionEngine = new ConditionEngine(taskRegistry, signalBus);
+ *
+ * // Start a background task
+ * taskRegistry.register({
+ *   type: 'generic',
+ *   taskId: 'my-task',
+ *   description: 'My task',
+ *   promise: someAsyncOperation(),
+ * });
+ *
+ * // Wait for completion
+ * const { signal } = await conditionEngine.wait({
+ *   type: 'task',
+ *   taskId: 'my-task',
+ * });
+ * ```
+ */
+export { SignalBus, type SignalHandler, type SignalPredicate } from './signal-bus.js';
+export { TaskRegistry, type TaskRegistryConfig } from './task-registry.js';
 export { ConditionEngine } from './condition-engine.js';
-export { AgentState, ProcessResult, RegisterTaskOptions, Signal, SignalType, Task, TaskEntry, TaskFilter, TaskInfo, TaskResult, TaskStatus, WaitCondition, WaitResult } from './types.js';
-export { StartTaskInput, StartTaskInputSchema, StartTaskOutput, TaskStarter, createGenericTaskStarter, createStartTaskTool } from './tools/start-task.js';
-export { WaitForInput, WaitForInputSchema, WaitForOutput, createWaitForTool } from './tools/wait-for.js';
-export { CheckTaskInput, CheckTaskInputSchema, CheckTaskOutput, createCheckTaskTool } from './tools/check-task.js';
-export { ListTasksInput, ListTasksInputSchema, ListTasksOutput, TaskListItem, createListTasksTool } from './tools/list-tasks.js';
-export { OrchestrationTool, OrchestrationToolContext } from './tools/types.js';
-import 'zod';
+export type { Task, TaskStatus, TaskEntry, TaskResult, ProcessResult, Signal, SignalType, WaitCondition, WaitResult, AgentState, TaskInfo, TaskFilter, RegisterTaskOptions, } from './types.js';
+export { createWaitForTool, createCheckTaskTool, createListTasksTool } from './tools/index.js';
+export type { WaitForInput, WaitForOutput, CheckTaskInput, CheckTaskOutput, ListTasksInput, ListTasksOutput, TaskListItem, } from './tools/index.js';
+export { WaitForInputSchema, CheckTaskInputSchema, ListTasksInputSchema } from './tools/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAGH,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,YAAY,EACR,IAAI,EACJ,UAAU,EACV,SAAS,EACT,UAAU,EACV,aAAa,EACb,MAAM,EACN,UAAU,EACV,aAAa,EACb,UAAU,EACV,UAAU,EACV,QAAQ,EACR,UAAU,EACV,mBAAmB,GACtB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE/F,YAAY,EACR,YAAY,EACZ,aAAa,EACb,cAAc,EACd,eAAe,EACf,cAAc,EACd,eAAe,EACf,YAAY,GACf,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -1,32 +1,16 @@
-import { AgentController } from "./agent-controller.js";
 import { SignalBus } from "./signal-bus.js";
 import { TaskRegistry } from "./task-registry.js";
 import { ConditionEngine } from "./condition-engine.js";
-import {
-  createStartTaskTool,
-  createWaitForTool,
-  createCheckTaskTool,
-  createListTasksTool,
-  createGenericTaskStarter
-} from "./tools/index.js";
-import {
-  StartTaskInputSchema,
-  WaitForInputSchema,
-  CheckTaskInputSchema,
-  ListTasksInputSchema
-} from "./tools/index.js";
+import { createWaitForTool, createCheckTaskTool, createListTasksTool } from "./tools/index.js";
+import { WaitForInputSchema, CheckTaskInputSchema, ListTasksInputSchema } from "./tools/index.js";
 export {
-  AgentController,
   CheckTaskInputSchema,
   ConditionEngine,
   ListTasksInputSchema,
   SignalBus,
-  StartTaskInputSchema,
   TaskRegistry,
   WaitForInputSchema,
   createCheckTaskTool,
-  createGenericTaskStarter,
   createListTasksTool,
-  createStartTaskTool,
   createWaitForTool
 };

package/dist/signal-bus.d.ts

@@ -1,24 +1,22 @@
-import { Signal, SignalType } from './types.js';
-
 /**
  * SignalBus
  *
  * Event emitter for routing orchestration signals.
  * Supports typed subscriptions and promise-based waiting.
  */
-
+import type { Signal, SignalType } from './types.js';
 /**
  * Handler function for signal subscriptions
  */
-type SignalHandler<T extends Signal = Signal> = (signal: T) => void;
+export type SignalHandler<T extends Signal = Signal> = (signal: T) => void;
 /**
  * Predicate function for filtering signals
  */
-type SignalPredicate = (signal: Signal) => boolean;
+export type SignalPredicate = (signal: Signal) => boolean;
 /**
  * SignalBus - Routes signals between orchestration components
  */
-declare class SignalBus {
+export declare class SignalBus {
     private emitter;
     constructor();
     /**
@@ -74,5 +72,4 @@ declare class SignalBus {
      */
     clear(): void;
 }
-
-export { SignalBus, type SignalHandler, type SignalPredicate };
+//# sourceMappingURL=signal-bus.d.ts.map

package/dist/signal-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-bus.d.ts","sourceRoot":"","sources":["../src/signal-bus.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC;AAE3E;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;AAE1D;;GAEG;AACH,qBAAa,SAAS;IAClB,OAAO,CAAC,OAAO,CAAsB;;IAOrC;;OAEG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAO1B;;;OAGG;IACH,EAAE,CAAC,CAAC,SAAS,UAAU,EACnB,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC,GACrD,MAAM,IAAI;IAKb;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,IAAI;IAKzC;;OAEG;IACH,IAAI,CAAC,CAAC,SAAS,UAAU,EACrB,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC,GACrD,IAAI;IAIP;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC,GAAG,IAAI;IAI9F;;;;;OAKG;IACH,OAAO,CAAC,SAAS,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgCtE;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAW9D;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAepE;;;OAGG;IACG,eAAe,CACjB,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,CAAC,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GACxD,OAAO,CAAC,MAAM,EAAE,CAAC;IAmEpB;;OAEG;IACH,KAAK,IAAI,IAAI;CAGhB"}

package/dist/task-registry.d.ts

@@ -1,17 +1,15 @@
-import { Task, RegisterTaskOptions, TaskEntry, TaskStatus, TaskInfo, TaskFilter } from './types.js';
-import { SignalBus } from './signal-bus.js';
-
 /**
  * TaskRegistry
  *
  * Tracks all background tasks and their results.
  * Emits signals on task completion for the ConditionEngine.
  */
-
+import type { Task, TaskEntry, TaskStatus, TaskInfo, TaskFilter, RegisterTaskOptions } from './types.js';
+import type { SignalBus } from './signal-bus.js';
 /**
  * Configuration for TaskRegistry
  */
-interface TaskRegistryConfig {
+export interface TaskRegistryConfig {
     /** Maximum number of concurrent tasks (default: 20) */
     maxTasks?: number;
     /** TTL for completed task results in ms (default: 5 minutes) */
@@ -20,7 +18,7 @@ interface TaskRegistryConfig {
 /**
  * TaskRegistry - Manages background task lifecycle
  */
-declare class TaskRegistry {
+export declare class TaskRegistry {
     private tasks;
     private signalBus;
     private config;
@@ -120,5 +118,4 @@ declare class TaskRegistry {
      */
     get size(): number;
 }
-
-export { TaskRegistry, type TaskRegistryConfig };
+//# sourceMappingURL=task-registry.d.ts.map

package/dist/task-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-registry.d.ts","sourceRoot":"","sources":["../src/task-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACR,IAAI,EACJ,SAAS,EACT,UAAU,EACV,QAAQ,EACR,UAAU,EACV,mBAAmB,EACtB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,MAAM,CAA+B;gBAEjC,SAAS,EAAE,SAAS,EAAE,MAAM,GAAE,kBAAuB;IAQjE;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAW1B;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,mBAAwB,GAAG,MAAM;IA4C/D;;;;;OAKG;IACH,iBAAiB,CACb,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EACzB,OAAO,GAAE,mBAAwB,GAClC,MAAM;IAgBT;;OAEG;IACH,mBAAmB,CACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EACzB,OAAO,GAAE,mBAAwB,GAClC,MAAM;IAYT;;OAEG;IACH,mBAAmB,CACf,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EACzB,OAAO,GAAE,mBAAwB,GAClC,MAAM;IAWT;;OAEG;IACH,OAAO,CAAC,cAAc;IAuBtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAuBpB;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IA0B5B;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI1C;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIjD;;OAEG;IACH,SAAS,CACL,MAAM,EAAE,MAAM,GACf;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS;IAavE;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IA2B7C;;OAEG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,QAAQ,EAAE;IA2BrC;;OAEG;IACH,eAAe,IAAI,MAAM;IAUzB;;OAEG;IACH,gBAAgB,IAAI,QAAQ,EAAE;IAO9B;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI;IAS1C;;OAEG;IACH,OAAO,CAAC,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM;IAcjC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI5B;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACJ"}

package/dist/tools/check-task.cjs

@@ -23,18 +23,24 @@ __export(check_task_exports, {
 });
 module.exports = __toCommonJS(check_task_exports);
 var import_zod = require("zod");
+var import_core = require("@dexto/core");
 const CheckTaskInputSchema = import_zod.z.object({
   /** Task ID to check */
   taskId: import_zod.z.string().describe("Task ID to check status of")
 }).strict();
-function createCheckTaskTool() {
+function createCheckTaskTool(taskRegistry) {
   return {
     id: "check_task",
     description: "Check the status of a background task. Returns immediately without waiting. Use this to poll task status or check if a task is done.",
     inputSchema: CheckTaskInputSchema,
-    execute: async (rawInput, context) => {
-      const input = CheckTaskInputSchema.parse(rawInput);
-      const info = context.taskRegistry.getInfo(input.taskId);
+    presentation: {
+      describeHeader: (input) => (0, import_core.createLocalToolCallHeader)({
+        title: "Check Task",
+        argsText: (0, import_core.truncateForHeader)(input.taskId, 80)
+      })
+    },
+    execute: async (input, _context) => {
+      const info = taskRegistry.getInfo(input.taskId);
       if (!info) {
         return {
           taskId: input.taskId,

package/dist/tools/check-task.d.ts

@@ -1,20 +1,15 @@
-import { z } from 'zod';
-import { OrchestrationTool } from './types.js';
-import '../task-registry.js';
-import '../types.js';
-import '../signal-bus.js';
-import '../condition-engine.js';
-
 /**
  * check_task Tool
  *
  * Non-blocking status check for a background task.
  */
-
+import { z } from 'zod';
+import type { Tool } from '@dexto/core';
+import type { TaskRegistry } from '../task-registry.js';
 /**
  * Input schema for check_task tool
  */
-declare const CheckTaskInputSchema: z.ZodObject<{
+export declare const CheckTaskInputSchema: z.ZodObject<{
     /** Task ID to check */
     taskId: z.ZodString;
 }, "strict", z.ZodTypeAny, {
@@ -22,11 +17,11 @@ declare const CheckTaskInputSchema: z.ZodObject<{
 }, {
     taskId: string;
 }>;
-type CheckTaskInput = z.output<typeof CheckTaskInputSchema>;
+export type CheckTaskInput = z.output<typeof CheckTaskInputSchema>;
 /**
  * Output from check_task tool
  */
-interface CheckTaskOutput {
+export interface CheckTaskOutput {
     /** Task ID */
     taskId: string;
     /** Whether task was found */
@@ -51,6 +46,5 @@ interface CheckTaskOutput {
 /**
  * Create the check_task tool
  */
-declare function createCheckTaskTool(): OrchestrationTool;
-
-export { type CheckTaskInput, CheckTaskInputSchema, type CheckTaskOutput, createCheckTaskTool };
+export declare function createCheckTaskTool(taskRegistry: TaskRegistry): Tool<typeof CheckTaskInputSchema>;
+//# sourceMappingURL=check-task.d.ts.map

package/dist/tools/check-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-task.d.ts","sourceRoot":"","sources":["../../src/tools/check-task.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,oBAAoB;IAEzB,uBAAuB;;;;;;EAGlB,CAAC;AAEd,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,cAAc;IACd,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,gBAAgB;IAChB,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IACvC,qBAAqB;IACrB,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IACtE,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC,OAAO,oBAAoB,CAAC,CAyCjG"}

package/dist/tools/check-task.js

@@ -1,16 +1,22 @@
 import { z } from "zod";
+import { createLocalToolCallHeader, truncateForHeader } from "@dexto/core";
 const CheckTaskInputSchema = z.object({
   /** Task ID to check */
   taskId: z.string().describe("Task ID to check status of")
 }).strict();
-function createCheckTaskTool() {
+function createCheckTaskTool(taskRegistry) {
   return {
     id: "check_task",
     description: "Check the status of a background task. Returns immediately without waiting. Use this to poll task status or check if a task is done.",
     inputSchema: CheckTaskInputSchema,
-    execute: async (rawInput, context) => {
-      const input = CheckTaskInputSchema.parse(rawInput);
-      const info = context.taskRegistry.getInfo(input.taskId);
+    presentation: {
+      describeHeader: (input) => createLocalToolCallHeader({
+        title: "Check Task",
+        argsText: truncateForHeader(input.taskId, 80)
+      })
+    },
+    execute: async (input, _context) => {
+      const info = taskRegistry.getInfo(input.taskId);
       if (!info) {
         return {
           taskId: input.taskId,

package/dist/tools/index.cjs

@@ -20,17 +20,12 @@ var tools_exports = {};
 __export(tools_exports, {
   CheckTaskInputSchema: () => import_check_task2.CheckTaskInputSchema,
   ListTasksInputSchema: () => import_list_tasks2.ListTasksInputSchema,
-  StartTaskInputSchema: () => import_start_task2.StartTaskInputSchema,
   WaitForInputSchema: () => import_wait_for2.WaitForInputSchema,
   createCheckTaskTool: () => import_check_task.createCheckTaskTool,
-  createGenericTaskStarter: () => import_start_task.createGenericTaskStarter,
   createListTasksTool: () => import_list_tasks.createListTasksTool,
-  createStartTaskTool: () => import_start_task.createStartTaskTool,
   createWaitForTool: () => import_wait_for.createWaitForTool
 });
 module.exports = __toCommonJS(tools_exports);
-var import_start_task = require("./start-task.js");
-var import_start_task2 = require("./start-task.js");
 var import_wait_for = require("./wait-for.js");
 var import_wait_for2 = require("./wait-for.js");
 var import_check_task = require("./check-task.js");
@@ -41,11 +36,8 @@ var import_list_tasks2 = require("./list-tasks.js");
 0 && (module.exports = {
   CheckTaskInputSchema,
   ListTasksInputSchema,
-  StartTaskInputSchema,
   WaitForInputSchema,
   createCheckTaskTool,
-  createGenericTaskStarter,
   createListTasksTool,
-  createStartTaskTool,
   createWaitForTool
 });

package/dist/tools/index.d.ts

@@ -1,10 +1,15 @@
-export { StartTaskInput, StartTaskInputSchema, StartTaskOutput, TaskStarter, createGenericTaskStarter, createStartTaskTool } from './start-task.js';
-export { WaitForInput, WaitForInputSchema, WaitForOutput, createWaitForTool } from './wait-for.js';
-export { CheckTaskInput, CheckTaskInputSchema, CheckTaskOutput, createCheckTaskTool } from './check-task.js';
-export { ListTasksInput, ListTasksInputSchema, ListTasksOutput, TaskListItem, createListTasksTool } from './list-tasks.js';
-export { OrchestrationTool, OrchestrationToolContext } from './types.js';
-import 'zod';
-import '../types.js';
-import '../task-registry.js';
-import '../signal-bus.js';
-import '../condition-engine.js';
+/**
+ * Orchestration Tools
+ *
+ * Tools for managing background tasks in agent workflows.
+ */
+export { createWaitForTool } from './wait-for.js';
+export type { WaitForInput, WaitForOutput } from './wait-for.js';
+export { WaitForInputSchema } from './wait-for.js';
+export { createCheckTaskTool } from './check-task.js';
+export type { CheckTaskInput, CheckTaskOutput } from './check-task.js';
+export { CheckTaskInputSchema } from './check-task.js';
+export { createListTasksTool } from './list-tasks.js';
+export type { ListTasksInput, ListTasksOutput, TaskListItem } from './list-tasks.js';
+export { ListTasksInputSchema } from './list-tasks.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/tools/index.js

@@ -1,5 +1,3 @@
-import { createStartTaskTool, createGenericTaskStarter } from "./start-task.js";
-import { StartTaskInputSchema } from "./start-task.js";
 import { createWaitForTool } from "./wait-for.js";
 import { WaitForInputSchema } from "./wait-for.js";
 import { createCheckTaskTool } from "./check-task.js";
@@ -9,11 +7,8 @@ import { ListTasksInputSchema } from "./list-tasks.js";
 export {
   CheckTaskInputSchema,
   ListTasksInputSchema,
-  StartTaskInputSchema,
   WaitForInputSchema,
   createCheckTaskTool,
-  createGenericTaskStarter,
   createListTasksTool,
-  createStartTaskTool,
   createWaitForTool
 };

package/dist/tools/list-tasks.cjs

@@ -23,19 +23,31 @@ __export(list_tasks_exports, {
 });
 module.exports = __toCommonJS(list_tasks_exports);
 var import_zod = require("zod");
+var import_core = require("@dexto/core");
 const ListTasksInputSchema = import_zod.z.object({
   /** Filter by status */
   status: import_zod.z.enum(["pending", "running", "completed", "failed", "cancelled", "all"]).optional().default("all").describe("Filter tasks by status"),
   /** Filter by type */
   type: import_zod.z.enum(["agent", "process", "generic"]).optional().describe("Filter tasks by type")
 }).strict();
-function createListTasksTool() {
+function createListTasksTool(taskRegistry) {
   return {
     id: "list_tasks",
     description: "List all background tasks with optional filtering by status or type. Returns task information and counts.",
     inputSchema: ListTasksInputSchema,
-    execute: async (rawInput, context) => {
-      const input = ListTasksInputSchema.parse(rawInput);
+    presentation: {
+      describeHeader: (input) => {
+        const bits = [];
+        if (input.status && input.status !== "all") bits.push(`status=${input.status}`);
+        if (input.type) bits.push(`type=${input.type}`);
+        const argsText = bits.length > 0 ? (0, import_core.truncateForHeader)(bits.join(", "), 120) : void 0;
+        return (0, import_core.createLocalToolCallHeader)({
+          title: "List Tasks",
+          ...argsText ? { argsText } : {}
+        });
+      }
+    },
+    execute: async (input, _context) => {
       const filter = {};
       if (input.status && input.status !== "all") {
         filter.status = input.status;
@@ -43,8 +55,8 @@ function createListTasksTool() {
       if (input.type) {
         filter.type = input.type;
       }
-      const tasks = context.taskRegistry.list(filter);
-      const allTasks = context.taskRegistry.list();
+      const tasks = taskRegistry.list(filter);
+      const allTasks = taskRegistry.list();
       const counts = {
         running: 0,
         completed: 0,

package/dist/tools/list-tasks.d.ts

@@ -1,20 +1,16 @@
-import { z } from 'zod';
-import { TaskStatus } from '../types.js';
-import { OrchestrationTool } from './types.js';
-import '../task-registry.js';
-import '../signal-bus.js';
-import '../condition-engine.js';
-
 /**
  * list_tasks Tool
  *
  * List all tracked background tasks with optional filtering.
  */
-
+import { z } from 'zod';
+import type { TaskStatus } from '../types.js';
+import type { Tool } from '@dexto/core';
+import type { TaskRegistry } from '../task-registry.js';
 /**
  * Input schema for list_tasks tool
  */
-declare const ListTasksInputSchema: z.ZodObject<{
+export declare const ListTasksInputSchema: z.ZodObject<{
     /** Filter by status */
     status: z.ZodDefault<z.ZodOptional<z.ZodEnum<["pending", "running", "completed", "failed", "cancelled", "all"]>>>;
     /** Filter by type */
@@ -26,11 +22,11 @@ declare const ListTasksInputSchema: z.ZodObject<{
     type?: "agent" | "process" | "generic" | undefined;
     status?: "pending" | "running" | "completed" | "failed" | "cancelled" | "all" | undefined;
 }>;
-type ListTasksInput = z.output<typeof ListTasksInputSchema>;
+export type ListTasksInput = z.output<typeof ListTasksInputSchema>;
 /**
  * Task info in list output
  */
-interface TaskListItem {
+export interface TaskListItem {
     taskId: string;
     type: 'agent' | 'process' | 'generic';
     status: TaskStatus;
@@ -42,7 +38,7 @@ interface TaskListItem {
 /**
  * Output from list_tasks tool
  */
-interface ListTasksOutput {
+export interface ListTasksOutput {
     /** List of tasks matching filter */
     tasks: TaskListItem[];
     /** Total count */
@@ -59,6 +55,5 @@ interface ListTasksOutput {
 /**
  * Create the list_tasks tool
  */
-declare function createListTasksTool(): OrchestrationTool;
-
-export { type ListTasksInput, ListTasksInputSchema, type ListTasksOutput, type TaskListItem, createListTasksTool };
+export declare function createListTasksTool(taskRegistry: TaskRegistry): Tool<typeof ListTasksInputSchema>;
+//# sourceMappingURL=list-tasks.d.ts.map

package/dist/tools/list-tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-tasks.d.ts","sourceRoot":"","sources":["../../src/tools/list-tasks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,oBAAoB;IAEzB,uBAAuB;;IAOvB,qBAAqB;;;;;;;;EAGhB,CAAC;AAEd,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IACtC,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,oCAAoC;IACpC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,MAAM,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;KACnB,CAAC;CACL;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC,OAAO,oBAAoB,CAAC,CAyEjG"}

package/dist/tools/list-tasks.js

@@ -1,17 +1,29 @@
 import { z } from "zod";
+import { createLocalToolCallHeader, truncateForHeader } from "@dexto/core";
 const ListTasksInputSchema = z.object({
   /** Filter by status */
   status: z.enum(["pending", "running", "completed", "failed", "cancelled", "all"]).optional().default("all").describe("Filter tasks by status"),
   /** Filter by type */
   type: z.enum(["agent", "process", "generic"]).optional().describe("Filter tasks by type")
 }).strict();
-function createListTasksTool() {
+function createListTasksTool(taskRegistry) {
   return {
     id: "list_tasks",
     description: "List all background tasks with optional filtering by status or type. Returns task information and counts.",
     inputSchema: ListTasksInputSchema,
-    execute: async (rawInput, context) => {
-      const input = ListTasksInputSchema.parse(rawInput);
+    presentation: {
+      describeHeader: (input) => {
+        const bits = [];
+        if (input.status && input.status !== "all") bits.push(`status=${input.status}`);
+        if (input.type) bits.push(`type=${input.type}`);
+        const argsText = bits.length > 0 ? truncateForHeader(bits.join(", "), 120) : void 0;
+        return createLocalToolCallHeader({
+          title: "List Tasks",
+          ...argsText ? { argsText } : {}
+        });
+      }
+    },
+    execute: async (input, _context) => {
       const filter = {};
       if (input.status && input.status !== "all") {
         filter.status = input.status;
@@ -19,8 +31,8 @@ function createListTasksTool() {
       if (input.type) {
         filter.type = input.type;
       }
-      const tasks = context.taskRegistry.list(filter);
-      const allTasks = context.taskRegistry.list();
+      const tasks = taskRegistry.list(filter);
+      const allTasks = taskRegistry.list();
       const counts = {
         running: 0,
         completed: 0,

package/dist/tools/wait-for.cjs

@@ -25,6 +25,7 @@ module.exports = __toCommonJS(wait_for_exports);
 var import_zod = require("zod");
 var import_crypto = require("crypto");
 var import_condition_engine = require("../condition-engine.js");
+var import_core = require("@dexto/core");
 const WaitForInputSchema = import_zod.z.object({
   /** Wait for a single task */
   taskId: import_zod.z.string().optional().describe("Task ID to wait for"),
@@ -96,15 +97,23 @@ function formatOutput(signal, allSignals) {
   }
   return baseOutput;
 }
-function createWaitForTool() {
+function createWaitForTool(conditionEngine) {
   return {
     id: "wait_for",
     description: "Wait for background task(s) to complete. Blocks execution until the condition is met. Use taskId for a single task, or taskIds with mode for multiple tasks.",
     inputSchema: WaitForInputSchema,
-    execute: async (rawInput, context) => {
-      const input = WaitForInputSchema.parse(rawInput);
+    presentation: {
+      describeHeader: (input) => {
+        const argsText = input.taskId ? (0, import_core.truncateForHeader)(input.taskId, 80) : input.taskIds && input.taskIds.length > 0 ? (0, import_core.truncateForHeader)(`${input.taskIds.length} tasks`, 80) : void 0;
+        return (0, import_core.createLocalToolCallHeader)({
+          title: "Wait",
+          ...argsText ? { argsText } : {}
+        });
+      }
+    },
+    execute: async (input, _context) => {
       const condition = buildCondition(input);
-      const { signal, allSignals } = await context.conditionEngine.wait(condition);
+      const { signal, allSignals } = await conditionEngine.wait(condition);
       return formatOutput(signal, allSignals);
     }
   };

package/dist/tools/wait-for.d.ts

@@ -1,21 +1,16 @@
-import { z } from 'zod';
-import { OrchestrationTool } from './types.js';
-import '../task-registry.js';
-import '../types.js';
-import '../signal-bus.js';
-import '../condition-engine.js';
-
 /**
  * wait_for Tool
  *
  * Suspends agent execution until condition is met using a blocking promise.
  * TurnExecutor naturally awaits tool execution, so this works seamlessly.
  */
-
+import { z } from 'zod';
+import { ConditionEngine } from '../condition-engine.js';
+import type { Tool } from '@dexto/core';
 /**
  * Input schema for wait_for tool
  */
-declare const WaitForInputSchema: z.ZodEffects<z.ZodObject<{
+export declare const WaitForInputSchema: z.ZodEffects<z.ZodObject<{
     /** Wait for a single task */
     taskId: z.ZodOptional<z.ZodString>;
     /** Wait for multiple tasks */
@@ -45,11 +40,11 @@ declare const WaitForInputSchema: z.ZodEffects<z.ZodObject<{
     taskIds?: string[] | undefined;
     mode?: "any" | "all" | undefined;
 }>;
-type WaitForInput = z.infer<typeof WaitForInputSchema>;
+export type WaitForInput = z.output<typeof WaitForInputSchema>;
 /**
  * Output from wait_for tool
  */
-interface WaitForOutput {
+export interface WaitForOutput {
     /** Task ID that triggered the return (for 'any' mode) */
     taskId: string;
     /** Final status */
@@ -69,6 +64,5 @@ interface WaitForOutput {
 /**
  * Create the wait_for tool
  */
-declare function createWaitForTool(): OrchestrationTool;
-
-export { type WaitForInput, WaitForInputSchema, type WaitForOutput, createWaitForTool };
+export declare function createWaitForTool(conditionEngine: ConditionEngine): Tool<typeof WaitForInputSchema>;
+//# sourceMappingURL=wait-for.d.ts.map

package/dist/tools/wait-for.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-for.d.ts","sourceRoot":"","sources":["../../src/tools/wait-for.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,kBAAkB;IAEvB,6BAA6B;;IAG7B,8BAA8B;;IAG9B,2EAA2E;;IAO3E,8BAA8B;;;;;;;;;;;;;;;;;;;;;;EAQjC,CAAC;AAEN,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC;IACzD,0BAA0B;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,UAAU,CAAC,EAAE,KAAK,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;QAC7C,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACN;AAoFD;;GAEG;AACH,wBAAgB,iBAAiB,CAC7B,eAAe,EAAE,eAAe,GACjC,IAAI,CAAC,OAAO,kBAAkB,CAAC,CA+BjC"}