macro-agent 0.2.5 → 0.2.6

package/dist/mcp/tools/inject_context.d.ts

@@ -0,0 +1,61 @@
+/**
+ * inject_context MCP Tool
+ *
+ * Allows agents to inject context into another agent's session.
+ * Used for time-sensitive steering that can't wait for message checking.
+ *
+ * @module mcp/tools/inject_context
+ * @see s-9rld In-Flight Steering spec section 3.1
+ */
+import { z } from "zod";
+import type { AgentId } from "../../store/types/index.js";
+import type { AgentManager } from "../../agent/agent-manager.js";
+import type { MessageRouter } from "../../router/message-router.js";
+import { type InjectionResult } from "../../steering/index.js";
+/**
+ * Zod schema for inject_context tool input
+ */
+export declare const InjectContextSchema: {
+    target_agent_id: z.ZodString;
+    content: z.ZodString;
+    urgent: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    reason: z.ZodOptional<z.ZodString>;
+};
+/**
+ * Tool info for registration
+ */
+export declare const INJECT_CONTEXT_TOOL_INFO: {
+    name: string;
+    description: string;
+};
+/**
+ * Dependencies for the inject_context tool
+ */
+export interface InjectContextToolDeps {
+    agentManager: AgentManager;
+    messageRouter: MessageRouter;
+}
+/**
+ * Input args for the inject_context tool
+ */
+export interface InjectContextArgs {
+    target_agent_id: string;
+    content: string;
+    urgent?: boolean;
+    reason?: string;
+}
+/**
+ * Create the handler for the inject_context tool
+ */
+export declare function createInjectContextHandler(deps: InjectContextToolDeps, callerAgentId: AgentId): (args: InjectContextArgs) => Promise<InjectionResult>;
+/**
+ * Format the tool result for MCP response
+ */
+export declare function formatInjectContextResult(result: InjectionResult): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+};
+//# sourceMappingURL=inject_context.d.ts.map

package/dist/mcp/tools/inject_context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject_context.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/inject_context.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,yBAAyB,CAAC;AAMjC;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;CAgB/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;CAgBpC,CAAC;AAMF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,EAAE,aAAa,CAAC;CAC9B;AAMD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,qBAAqB,EAC3B,aAAa,EAAE,OAAO,IA4CR,MAAM,iBAAiB,KAAG,OAAO,CAAC,eAAe,CAAC,CAQjE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,eAAe,GAAG;IAClE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAeA"}

package/dist/mcp/tools/inject_context.js

@@ -0,0 +1,123 @@
+/**
+ * inject_context MCP Tool
+ *
+ * Allows agents to inject context into another agent's session.
+ * Used for time-sensitive steering that can't wait for message checking.
+ *
+ * @module mcp/tools/inject_context
+ * @see s-9rld In-Flight Steering spec section 3.1
+ */
+import { z } from "zod";
+import { injectContext, } from "../../steering/index.js";
+// =============================================================================
+// Schema Definition
+// =============================================================================
+/**
+ * Zod schema for inject_context tool input
+ */
+export const InjectContextSchema = {
+    target_agent_id: z
+        .string()
+        .describe("The agent ID to inject context into"),
+    content: z
+        .string()
+        .describe("The context message to inject"),
+    urgent: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("If true, interrupts current work immediately instead of queueing"),
+    reason: z
+        .string()
+        .optional()
+        .describe("Optional reason for the injection (for audit logs)"),
+};
+/**
+ * Tool info for registration
+ */
+export const INJECT_CONTEXT_TOOL_INFO = {
+    name: "inject_context",
+    description: `Inject context into another agent's session. Use this for time-sensitive
+steering that can't wait for the agent to check messages.
+
+The context will appear in the target agent's next turn, or immediately if urgent=true.
+
+Fallback behavior:
+- If injection not supported, falls back to interrupting the agent
+- If that fails, sends a high-priority message instead
+
+Use cases:
+- Priority changes ("Pause feature X, work on Y first")
+- Urgent information ("Build is failing, check your types")
+- Health checks ("Are you stuck? Report status")
+- Context updates ("Worker 2 finished the API, you can use it now")`,
+};
+/**
+ * Create the handler for the inject_context tool
+ */
+export function createInjectContextHandler(deps, callerAgentId) {
+    // Create injection deps that wrap AgentManager and MessageRouter
+    const injectionDeps = {
+        getSession(agentId) {
+            const session = deps.agentManager.getSession(agentId);
+            if (!session)
+                return null;
+            // Cast to InjectableSession interface
+            return {
+                inject: async (content) => session.inject(content),
+                supportsInject: () => session.supportsInject(),
+                checkInjectSupport: async () => {
+                    // Try a no-op inject to check support
+                    try {
+                        const result = await session.inject("");
+                        return result.success;
+                    }
+                    catch {
+                        return false;
+                    }
+                },
+                interruptWith: (content) => session.interruptWith(content),
+            };
+        },
+        isPrompting(agentId) {
+            return deps.agentManager.isPrompting(agentId);
+        },
+        async sendMessage(fromAgentId, toAgentId, content, priority) {
+            await deps.messageRouter.sendToAddress({
+                from: fromAgentId ?? callerAgentId,
+                to: { agent: toAgentId },
+                content,
+                options: { priority },
+            });
+        },
+    };
+    return async (args) => {
+        return injectContext(injectionDeps, args.target_agent_id, args.content, {
+            urgent: args.urgent,
+            allowInterrupt: true, // MCP tool always allows interrupt fallback
+            source: { type: "agent", agentId: callerAgentId },
+            reason: args.reason,
+        });
+    };
+}
+/**
+ * Format the tool result for MCP response
+ */
+export function formatInjectContextResult(result) {
+    if (result.success) {
+        let text = `Context injected via ${result.method}`;
+        if (result.note) {
+            text += `: ${result.note}`;
+        }
+        return {
+            content: [{ type: "text", text }],
+        };
+    }
+    else {
+        return {
+            content: [{ type: "text", text: `Injection failed: ${result.error}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=inject_context.js.map

package/dist/mcp/tools/inject_context.js.map

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

package/dist/mcp/tools/list_claimable_tasks.d.ts

@@ -0,0 +1,38 @@
+/**
+ * list_claimable_tasks() MCP Tool
+ *
+ * Lists tasks available for claiming. Allows agents to preview
+ * what's in the task pool before claiming.
+ *
+ * @module mcp/tools/list_claimable_tasks
+ */
+import { z } from "zod";
+import type { TaskBackend, ExtendedTask } from "../../task/backend/types.js";
+import type { ToolContext } from "../types.js";
+export declare const ListClaimableTasksSchema: {
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    root_tasks_only: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodOptional<z.ZodNumber>;
+};
+export interface ListClaimableTasksDeps {
+    taskBackend: TaskBackend;
+}
+export declare function createListClaimableTasksHandler(_context: ToolContext, deps: ListClaimableTasksDeps): (args: {
+    tags?: string[];
+    root_tasks_only?: boolean;
+    limit?: number;
+}) => Promise<{
+    tasks: ExtendedTask[];
+    count: number;
+    message: string;
+}>;
+export declare const LIST_CLAIMABLE_TASKS_TOOL_INFO: {
+    name: string;
+    description: string;
+    schema: {
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        root_tasks_only: z.ZodOptional<z.ZodBoolean>;
+        limit: z.ZodOptional<z.ZodNumber>;
+    };
+};
+//# sourceMappingURL=list_claimable_tasks.d.ts.map

package/dist/mcp/tools/list_claimable_tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_claimable_tasks.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/list_claimable_tasks.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAe,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC1F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAM/C,eAAO,MAAM,wBAAwB;;;;CAapC,CAAC;AAMF,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,WAAW,EACrB,IAAI,EAAE,sBAAsB,IAEd,MAAM;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,KAAG,OAAO,CAAC;IACV,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CA6BH;AAMD,eAAO,MAAM,8BAA8B;;;;;;;;CAK1C,CAAC"}

package/dist/mcp/tools/list_claimable_tasks.js

@@ -0,0 +1,63 @@
+/**
+ * list_claimable_tasks() MCP Tool
+ *
+ * Lists tasks available for claiming. Allows agents to preview
+ * what's in the task pool before claiming.
+ *
+ * @module mcp/tools/list_claimable_tasks
+ */
+import { z } from "zod";
+// =============================================================================
+// Schema
+// =============================================================================
+export const ListClaimableTasksSchema = {
+    tags: z
+        .array(z.string())
+        .optional()
+        .describe("Only list tasks with at least one matching tag"),
+    root_tasks_only: z
+        .boolean()
+        .optional()
+        .describe("Only list root tasks (no parent)"),
+    limit: z
+        .number()
+        .optional()
+        .describe("Maximum number of tasks to return (default: 20)"),
+};
+export function createListClaimableTasksHandler(_context, deps) {
+    return async (args) => {
+        if (!deps.taskBackend.listClaimable) {
+            return {
+                tasks: [],
+                count: 0,
+                message: "Task backend does not support listClaimable operations",
+            };
+        }
+        const filter = {};
+        if (args.tags)
+            filter.tags = args.tags;
+        if (args.root_tasks_only)
+            filter.rootTasksOnly = args.root_tasks_only;
+        let tasks = await deps.taskBackend.listClaimable(filter);
+        const limit = args.limit ?? 20;
+        if (tasks.length > limit) {
+            tasks = tasks.slice(0, limit);
+        }
+        return {
+            tasks,
+            count: tasks.length,
+            message: tasks.length > 0
+                ? `Found ${tasks.length} claimable task(s)`
+                : "No claimable tasks available",
+        };
+    };
+}
+// =============================================================================
+// Tool Info
+// =============================================================================
+export const LIST_CLAIMABLE_TASKS_TOOL_INFO = {
+    name: "list_claimable_tasks",
+    description: "List tasks available for claiming. Shows pending, unblocked, unassigned tasks. Requires task.claim capability.",
+    schema: ListClaimableTasksSchema,
+};
+//# sourceMappingURL=list_claimable_tasks.js.map

package/dist/mcp/tools/list_claimable_tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_claimable_tasks.js","sourceRoot":"","sources":["../../../src/mcp/tools/list_claimable_tasks.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,gFAAgF;AAChF,SAAS;AACT,gFAAgF;AAEhF,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI,EAAE,CAAC;SACJ,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,gDAAgD,CAAC;IAC7D,eAAe,EAAE,CAAC;SACf,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,kCAAkC,CAAC;IAC/C,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,iDAAiD,CAAC;CAC/D,CAAC;AAUF,MAAM,UAAU,+BAA+B,CAC7C,QAAqB,EACrB,IAA4B;IAE5B,OAAO,KAAK,EAAE,IAIb,EAIE,EAAE;QACH,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC;YACpC,OAAO;gBACL,KAAK,EAAE,EAAE;gBACT,KAAK,EAAE,CAAC;gBACR,OAAO,EAAE,wDAAwD;aAClE,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAgB,EAAE,CAAC;QAC/B,IAAI,IAAI,CAAC,IAAI;YAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvC,IAAI,IAAI,CAAC,eAAe;YAAE,MAAM,CAAC,aAAa,GAAG,IAAI,CAAC,eAAe,CAAC;QAEtE,IAAI,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAEzD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAC/B,IAAI,KAAK,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;YACzB,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAChC,CAAC;QAED,OAAO;YACL,KAAK;YACL,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,OAAO,EACL,KAAK,CAAC,MAAM,GAAG,CAAC;gBACd,CAAC,CAAC,SAAS,KAAK,CAAC,MAAM,oBAAoB;gBAC3C,CAAC,CAAC,8BAA8B;SACrC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EACT,gHAAgH;IAClH,MAAM,EAAE,wBAAwB;CACjC,CAAC"}

package/dist/mcp/tools/unclaim_task.d.ts

@@ -0,0 +1,31 @@
+/**
+ * unclaim_task() MCP Tool
+ *
+ * Allows agents with `task.claim` capability to release a claimed task
+ * back to the pending pool.
+ *
+ * @module mcp/tools/unclaim_task
+ */
+import { z } from "zod";
+import type { TaskBackend } from "../../task/backend/types.js";
+import type { ToolContext } from "../types.js";
+export declare const UnclaimTaskSchema: {
+    task_id: z.ZodString;
+};
+export interface UnclaimTaskDeps {
+    taskBackend: TaskBackend;
+}
+export declare function createUnclaimTaskHandler(_context: ToolContext, deps: UnclaimTaskDeps): (args: {
+    task_id: string;
+}) => Promise<{
+    success: boolean;
+    message: string;
+}>;
+export declare const UNCLAIM_TASK_TOOL_INFO: {
+    name: string;
+    description: string;
+    schema: {
+        task_id: z.ZodString;
+    };
+};
+//# sourceMappingURL=unclaim_task.d.ts.map

package/dist/mcp/tools/unclaim_task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unclaim_task.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/unclaim_task.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAM/C,eAAO,MAAM,iBAAiB;;CAE7B,CAAC;AAMF,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,WAAW,EACrB,IAAI,EAAE,eAAe,IAEP,MAAM;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,KAAG,OAAO,CAAC;IACV,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAqBH;AAMD,eAAO,MAAM,sBAAsB;;;;;;CAKlC,CAAC"}

package/dist/mcp/tools/unclaim_task.js

@@ -0,0 +1,47 @@
+/**
+ * unclaim_task() MCP Tool
+ *
+ * Allows agents with `task.claim` capability to release a claimed task
+ * back to the pending pool.
+ *
+ * @module mcp/tools/unclaim_task
+ */
+import { z } from "zod";
+// =============================================================================
+// Schema
+// =============================================================================
+export const UnclaimTaskSchema = {
+    task_id: z.string().describe("ID of the task to unclaim"),
+};
+export function createUnclaimTaskHandler(_context, deps) {
+    return async (args) => {
+        if (!deps.taskBackend.unclaim) {
+            return {
+                success: false,
+                message: "Task backend does not support unclaim operations",
+            };
+        }
+        try {
+            await deps.taskBackend.unclaim(args.task_id);
+            return {
+                success: true,
+                message: `Task ${args.task_id} unclaimed and returned to pending pool`,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                message: `Failed to unclaim task: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    };
+}
+// =============================================================================
+// Tool Info
+// =============================================================================
+export const UNCLAIM_TASK_TOOL_INFO = {
+    name: "unclaim_task",
+    description: "Release a claimed task back to the pending pool so another agent can pick it up. Requires task.claim capability.",
+    schema: UnclaimTaskSchema,
+};
+//# sourceMappingURL=unclaim_task.js.map

package/dist/mcp/tools/unclaim_task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unclaim_task.js","sourceRoot":"","sources":["../../../src/mcp/tools/unclaim_task.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,gFAAgF;AAChF,SAAS;AACT,gFAAgF;AAEhF,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;CAC1D,CAAC;AAUF,MAAM,UAAU,wBAAwB,CACtC,QAAqB,EACrB,IAAqB;IAErB,OAAO,KAAK,EAAE,IAEb,EAGE,EAAE;QACH,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YAC9B,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,kDAAkD;aAC5D,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC7C,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,QAAQ,IAAI,CAAC,OAAO,yCAAyC;aACvE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,2BAA2B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;aAC7F,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,cAAc;IACpB,WAAW,EACT,kHAAkH;IACpH,MAAM,EAAE,iBAAiB;CAC1B,CAAC"}

package/dist/mcp/tools/wait_for_activity.d.ts

@@ -0,0 +1,60 @@
+/**
+ * wait_for_activity MCP Tool
+ *
+ * Allows agents to block until a matching activity occurs.
+ * Useful for monitors and coordinators that need to react to events.
+ *
+ * @module mcp/tools/wait_for_activity
+ * @see s-9rld In-Flight Steering spec section 3.4
+ */
+import { z } from "zod";
+import type { ToolContext } from "../types.js";
+import type { ActivityWatcher } from "../../activity/watcher.js";
+import type { WaitForActivityResult } from "../../activity/types.js";
+/**
+ * Zod schema for wait_for_activity tool input
+ */
+export declare const WaitForActivitySchema: {
+    event_types: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    timeout_ms: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    scope: z.ZodOptional<z.ZodObject<{
+        subtree: z.ZodOptional<z.ZodString>;
+        role: z.ZodOptional<z.ZodString>;
+        target_agent: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+};
+/**
+ * Tool registration info for use with MCP server
+ */
+export declare const WAIT_FOR_ACTIVITY_TOOL_INFO: {
+    name: string;
+    description: string;
+    schema: {
+        event_types: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        timeout_ms: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        scope: z.ZodOptional<z.ZodObject<{
+            subtree: z.ZodOptional<z.ZodString>;
+            role: z.ZodOptional<z.ZodString>;
+            target_agent: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    };
+};
+/**
+ * Dependencies for the wait_for_activity tool
+ */
+export interface WaitForActivityToolDeps {
+    activityWatcher: ActivityWatcher;
+}
+/**
+ * Create the wait_for_activity tool handler
+ */
+export declare function createWaitForActivityHandler(context: ToolContext, deps: WaitForActivityToolDeps): (args: {
+    event_types?: string[];
+    timeout_ms?: number;
+    scope?: {
+        subtree?: string;
+        role?: string;
+        target_agent?: string;
+    };
+}) => Promise<WaitForActivityResult>;
+//# sourceMappingURL=wait_for_activity.d.ts.map

package/dist/mcp/tools/wait_for_activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait_for_activity.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/wait_for_activity.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAIV,qBAAqB,EACtB,MAAM,yBAAyB,CAAC;AAMjC;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;CAkBjC,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;CAKvC,CAAC;AAMF;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,eAAe,EAAE,eAAe,CAAC;CAClC;AAMD;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,uBAAuB,IAEf,MAAM;IAClB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH,KAAG,OAAO,CAAC,qBAAqB,CAAC,CA6FnC"}

package/dist/mcp/tools/wait_for_activity.js

@@ -0,0 +1,135 @@
+/**
+ * wait_for_activity MCP Tool
+ *
+ * Allows agents to block until a matching activity occurs.
+ * Useful for monitors and coordinators that need to react to events.
+ *
+ * @module mcp/tools/wait_for_activity
+ * @see s-9rld In-Flight Steering spec section 3.4
+ */
+import { z } from "zod";
+// =============================================================================
+// Schema Definition
+// =============================================================================
+/**
+ * Zod schema for wait_for_activity tool input
+ */
+export const WaitForActivitySchema = {
+    event_types: z
+        .array(z.string())
+        .optional()
+        .describe("Event types to wait for (empty = all events)"),
+    timeout_ms: z
+        .number()
+        .optional()
+        .default(30000)
+        .describe("Timeout in milliseconds (default: 30000)"),
+    scope: z
+        .object({
+        subtree: z.string().optional().describe("Only events from this agent's subtree"),
+        role: z.string().optional().describe("Only events from agents with this role"),
+        target_agent: z.string().optional().describe("Only events targeting this agent"),
+    })
+        .optional()
+        .describe("Scope filter for events"),
+};
+// =============================================================================
+// Tool Info
+// =============================================================================
+/**
+ * Tool registration info for use with MCP server
+ */
+export const WAIT_FOR_ACTIVITY_TOOL_INFO = {
+    name: "wait_for_activity",
+    description: "Block until a matching activity event occurs or timeout. Useful for monitors and coordinators to react to events.",
+    schema: WaitForActivitySchema,
+};
+// =============================================================================
+// Handler
+// =============================================================================
+/**
+ * Create the wait_for_activity tool handler
+ */
+export function createWaitForActivityHandler(context, deps) {
+    return async (args) => {
+        const { activityWatcher } = deps;
+        const timeoutMs = args.timeout_ms ?? 30000;
+        const eventTypes = (args.event_types ?? []);
+        const scope = args.scope
+            ? {
+                subtree: args.scope.subtree,
+                role: args.scope.role,
+                targetAgent: args.scope.target_agent,
+            }
+            : undefined;
+        return new Promise((resolve) => {
+            let resolved = false;
+            let timeoutHandle = null;
+            // Activity listener
+            const listener = (activity) => {
+                // Check if already resolved
+                if (resolved)
+                    return;
+                // Check event type filter
+                if (eventTypes.length > 0 &&
+                    !eventTypes.includes(activity.type)) {
+                    return;
+                }
+                // Check scope filter
+                if (scope) {
+                    // Check subtree filter
+                    if (scope.subtree && activity.source?.agent_id) {
+                        // Would need to check lineage - for now, just check direct match
+                        // In a full implementation, we'd use relevance.ts helpers
+                        if (activity.source.agent_id !== scope.subtree) {
+                            // TODO: Check if source is in subtree
+                        }
+                    }
+                    // Check role filter
+                    if (scope.role && activity.source?.role) {
+                        if (activity.source.role !== scope.role &&
+                            !activity.source.role?.startsWith(`${scope.role}.`)) {
+                            return;
+                        }
+                    }
+                    // Check target agent filter
+                    if (scope.targetAgent) {
+                        if (activity.target?.type !== "agent" ||
+                            activity.target.target !== scope.targetAgent) {
+                            return;
+                        }
+                    }
+                }
+                // Activity matches - resolve
+                resolved = true;
+                if (timeoutHandle) {
+                    clearTimeout(timeoutHandle);
+                }
+                unsubscribe();
+                resolve({
+                    triggered: true,
+                    activity: {
+                        type: activity.type,
+                        source: activity.source,
+                        timestamp: activity.timestamp,
+                        details: activity.details,
+                    },
+                });
+            };
+            // Subscribe to activity events
+            const unsubscribe = activityWatcher.addActivityListener(listener);
+            // Set timeout
+            timeoutHandle = setTimeout(() => {
+                if (resolved)
+                    return;
+                resolved = true;
+                unsubscribe();
+                resolve({
+                    triggered: false,
+                    timeout: true,
+                });
+            }, timeoutMs);
+        });
+    };
+}
+//# sourceMappingURL=wait_for_activity.js.map

package/dist/mcp/tools/wait_for_activity.js.map

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