macro-agent 0.0.10 → 0.0.12

package/dist/mcp/tools/claim_task.js

@@ -0,0 +1,58 @@
+/**
+ * claim_task() MCP Tool
+ *
+ * Allows agents with `task.claim` capability to claim the next available task.
+ * Used in the pull model where agents autonomously pick up work.
+ *
+ * @module mcp/tools/claim_task
+ */
+import { z } from "zod";
+// =============================================================================
+// Schema
+// =============================================================================
+export const ClaimTaskSchema = {
+    tags: z
+        .array(z.string())
+        .optional()
+        .describe("Only claim tasks with at least one matching tag"),
+    root_tasks_only: z
+        .boolean()
+        .optional()
+        .describe("Only claim root tasks (no parent)"),
+};
+export function createClaimTaskHandler(context, deps) {
+    return async (args) => {
+        if (!deps.taskBackend.claim) {
+            return {
+                claimed: false,
+                message: "Task backend does not support claim operations",
+            };
+        }
+        const filter = {};
+        if (args.tags)
+            filter.tags = args.tags;
+        if (args.root_tasks_only)
+            filter.rootTasksOnly = args.root_tasks_only;
+        const task = await deps.taskBackend.claim(context.agent_id, filter);
+        if (!task) {
+            return {
+                claimed: false,
+                message: "No claimable tasks available",
+            };
+        }
+        return {
+            claimed: true,
+            task,
+            message: `Claimed task ${task.id}: ${task.description}`,
+        };
+    };
+}
+// =============================================================================
+// Tool Info
+// =============================================================================
+export const CLAIM_TASK_TOOL_INFO = {
+    name: "claim_task",
+    description: "Claim the next available task from the task pool. Returns the claimed task or null if none available. Requires task.claim capability.",
+    schema: ClaimTaskSchema,
+};
+//# sourceMappingURL=claim_task.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claim_task.js","sourceRoot":"","sources":["../../../src/mcp/tools/claim_task.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,gFAAgF;AAChF,SAAS;AACT,gFAAgF;AAEhF,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,CAAC;SACJ,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,iDAAiD,CAAC;IAC9D,eAAe,EAAE,CAAC;SACf,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,mCAAmC,CAAC;CACjD,CAAC;AAUF,MAAM,UAAU,sBAAsB,CACpC,OAAoB,EACpB,IAAmB;IAEnB,OAAO,KAAK,EAAE,IAGb,EAIE,EAAE;QACH,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;YAC5B,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,gDAAgD;aAC1D,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,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAEpE,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,8BAA8B;aACxC,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,IAAI;YACJ,OAAO,EAAE,gBAAgB,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE;SACxD,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,uIAAuI;IACzI,MAAM,EAAE,eAAe;CACxB,CAAC"}

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

@@ -47,11 +47,24 @@ export interface DoneToolDeps {
         /** Get merge queue for coordinating worker merges */
         getMergeQueue?(): AllHandlerDeps["mergeQueue"];
     };
+    /** Optional RoleRegistry for capability-based done() checks */
+    roleRegistry?: import("../../roles/types.js").RoleRegistry;
+    /** Optional MailService for recording completion turns */
+    mailService?: import("../../mail/mail-service.js").MailService;
+    /** Optional ConversationMap for agent-to-conversation lookup */
+    conversationMap?: import("../../mail/conversation-map.js").ConversationMap;
+    /** Optional integration strategy (from team config) */
+    integrationStrategy?: import("../../workspace/strategies/types.js").IntegrationStrategy;
+    /** Optional task mode from team config */
+    taskMode?: "push" | "pull";
 }
 /**
- * Check if an agent has the lifecycle.done capability
+ * Check if an agent has the lifecycle.done capability.
+ *
+ * Uses RoleRegistry for capability resolution, supporting both built-in
+ * roles and team-defined roles that extend them.
  */
-export declare function hasLifecycleDoneCapability(eventStore: EventStore, agentId: string): {
+export declare function hasLifecycleDoneCapability(eventStore: EventStore, agentId: string, roleRegistry?: import("../../roles/types.js").RoleRegistry): {
     hasCapability: boolean;
     role: string;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"done.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/done.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAY,UAAU,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEvF,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAMtF;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;CAgBtB,CAAC;AAMF;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,UAAU,CAAC;IACvB,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,EAAE,aAAa,CAAC;IAC7B,WAAW,EAAE,WAAW,CAAC;IACzB,gBAAgB,CAAC,EAAE;QACjB,iCAAiC;QACjC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG;YAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;YAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,QAAQ,CAAC,EAAE,MAAM,CAAC;SACnB,GAAG,IAAI,CAAC;QACT,qDAAqD;QACrD,aAAa,CAAC,IAAI,cAAc,CAAC,YAAY,CAAC,CAAC;KAChD,CAAC;CACH;AAMD;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,MAAM,GACd;IAAE,aAAa,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CA2B1C;AAMD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,MAAM,EACZ,gBAAgB,CAAC,EAAE,YAAY,CAAC,kBAAkB,CAAC,GAClD,gBAAgB,CAwBlB;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,IAC1D,MAAM;IAClB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,KAAG,OAAO,CAAC,UAAU,CAAC,CAmHxB;AAMD;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;CAK1B,CAAC"}
+{"version":3,"file":"done.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/done.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAY,UAAU,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEvF,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAMtF;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;CAgBtB,CAAC;AAMF;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,UAAU,CAAC;IACvB,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,EAAE,aAAa,CAAC;IAC7B,WAAW,EAAE,WAAW,CAAC;IACzB,gBAAgB,CAAC,EAAE;QACjB,iCAAiC;QACjC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG;YAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;YAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,QAAQ,CAAC,EAAE,MAAM,CAAC;SACnB,GAAG,IAAI,CAAC;QACT,qDAAqD;QACrD,aAAa,CAAC,IAAI,cAAc,CAAC,YAAY,CAAC,CAAC;KAChD,CAAC;IACF,+DAA+D;IAC/D,YAAY,CAAC,EAAE,OAAO,sBAAsB,EAAE,YAAY,CAAC;IAC3D,0DAA0D;IAC1D,WAAW,CAAC,EAAE,OAAO,4BAA4B,EAAE,WAAW,CAAC;IAC/D,gEAAgE;IAChE,eAAe,CAAC,EAAE,OAAO,gCAAgC,EAAE,eAAe,CAAC;IAC3E,uDAAuD;IACvD,mBAAmB,CAAC,EAAE,OAAO,qCAAqC,EAAE,mBAAmB,CAAC;IACxF,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAMD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,OAAO,sBAAsB,EAAE,YAAY,GACzD;IAAE,aAAa,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CA4B1C;AAMD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,MAAM,EACZ,gBAAgB,CAAC,EAAE,YAAY,CAAC,kBAAkB,CAAC,GAClD,gBAAgB,CAwBlB;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,IAC1D,MAAM;IAClB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,KAAG,OAAO,CAAC,UAAU,CAAC,CAqJxB;AAMD;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;CAK1B,CAAC"}

package/dist/mcp/tools/done.js

@@ -37,27 +37,30 @@ export const DoneSchema = {
 // Capability Check
 // =============================================================================
 /**
- * Check if an agent has the lifecycle.done capability
+ * Check if an agent has the lifecycle.done capability.
+ *
+ * Uses RoleRegistry for capability resolution, supporting both built-in
+ * roles and team-defined roles that extend them.
  */
-export function hasLifecycleDoneCapability(eventStore, agentId) {
+export function hasLifecycleDoneCapability(eventStore, agentId, roleRegistry) {
     // Get the agent to find their role
     const agent = eventStore.getAgent(agentId);
     if (!agent) {
         return { hasCapability: false, role: "unknown" };
     }
-    // Get the agent's role (set at spawn time) or default to "worker"
-    // In the future, this should query the RoleRegistry for full capability lookup
     const role = agent.role ?? "worker";
-    // Check if the role has lifecycle.done capability
-    // For now, we check based on known roles that have this capability
-    // In the future, this should query the RoleRegistry
+    // Use RoleRegistry for capability lookup when available
+    if (roleRegistry) {
+        const hasCapability = roleRegistry.hasCapability(role, "lifecycle.done");
+        return { hasCapability, role };
+    }
+    // Fallback: check base role via prefix match against known built-in roles
     const rolesWithDoneCapability = new Set([
         "worker",
         "worker.resolver",
         "integrator",
         "monitor",
     ]);
-    // Check exact match or prefix match
     const hasCapability = rolesWithDoneCapability.has(role) ||
         rolesWithDoneCapability.has(role.split(".")[0]);
     return { hasCapability, role };
@@ -99,11 +102,11 @@ export function buildLifecycleContext(toolContext, eventStore, role, workspaceMa
  */
 export function createDoneHandler(context, deps) {
     return async (args) => {
-        const { eventStore, agentManager, messageRouter, taskManager, workspaceManager } = deps;
+        const { eventStore, agentManager, messageRouter, taskManager, workspaceManager, roleRegistry, mailService, conversationMap } = deps;
         // ─────────────────────────────────────────────────────────────────────────
         // Step 1: Check capability
         // ─────────────────────────────────────────────────────────────────────────
-        const { hasCapability, role } = hasLifecycleDoneCapability(eventStore, context.agent_id);
+        const { hasCapability, role } = hasLifecycleDoneCapability(eventStore, context.agent_id, roleRegistry);
         if (!hasCapability) {
             return {
                 success: false,
@@ -156,6 +159,36 @@ export function createDoneHandler(context, deps) {
             // Continue even if emit fails
         }
         // ─────────────────────────────────────────────────────────────────────────
+        // Step 4b: Record completion turn and close conversation (Mail)
+        // ─────────────────────────────────────────────────────────────────────────
+        if (mailService && conversationMap) {
+            try {
+                const convId = conversationMap.getAgentConversation(context.agent_id);
+                if (convId) {
+                    // Record completion turn
+                    mailService.recordTurn({
+                        conversationId: convId,
+                        participant: context.agent_id,
+                        contentType: "event",
+                        content: {
+                            event: `agent.${args.status}`,
+                            summary: args.summary,
+                            details: args.details,
+                        },
+                    });
+                    // Close the conversation
+                    mailService.closeConversation({
+                        conversationId: convId,
+                        closedBy: context.agent_id,
+                        reason: args.status,
+                    });
+                }
+            }
+            catch {
+                // Never fail done() due to mail errors
+            }
+        }
+        // ─────────────────────────────────────────────────────────────────────────
         // Step 5: Dispatch to role-specific handler
         // ─────────────────────────────────────────────────────────────────────────
         const doneArgs = {
@@ -171,6 +204,8 @@ export function createDoneHandler(context, deps) {
             getWorkspacePath: workspaceManager
                 ? (agentId) => workspaceManager.getWorkspace(agentId)?.path
                 : undefined,
+            integrationStrategy: deps.integrationStrategy,
+            taskMode: deps.taskMode,
         };
         const handlerResult = await dispatchDone(lifecycleContext, doneArgs, cleanupStatus, handlerDeps);
         // ─────────────────────────────────────────────────────────────────────────

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

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

@@ -0,0 +1,2 @@
+export { getThroughputMetrics, getUtilizationMetrics, getErrorMetrics, type ThroughputMetrics, type UtilizationMetrics, type ErrorMetrics, type ErrorEntry, } from "./metrics.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,UAAU,GAChB,MAAM,cAAc,CAAC"}

package/dist/metrics/index.js

@@ -0,0 +1,2 @@
+export { getThroughputMetrics, getUtilizationMetrics, getErrorMetrics, } from "./metrics.js";
+//# sourceMappingURL=index.js.map

package/dist/metrics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,GAKhB,MAAM,cAAc,CAAC"}

package/dist/metrics/metrics.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Metrics Module
+ *
+ * Computes throughput, utilization, and error metrics from EventStore data.
+ * No new events needed — aggregates existing spawn, terminate, task, and
+ * status events.
+ *
+ * @module metrics/metrics
+ */
+import type { EventStore } from "../store/event-store.js";
+export interface ThroughputMetrics {
+    /** Tasks completed in the time window */
+    tasksCompleted: number;
+    /** Tasks failed in the time window */
+    tasksFailed: number;
+    /** Total tasks created in the time window */
+    tasksCreated: number;
+    /** Average completion time in ms (completed tasks only) */
+    avgCompletionTimeMs: number | null;
+    /** Tasks per minute (completed) */
+    completedPerMinute: number;
+    /** Time window start */
+    windowStart: number;
+    /** Time window end */
+    windowEnd: number;
+}
+export interface UtilizationMetrics {
+    /** Currently running agents */
+    activeAgents: number;
+    /** Total agents spawned in the time window */
+    totalSpawned: number;
+    /** Total agents stopped in the time window */
+    totalStopped: number;
+    /** Agents by role */
+    agentsByRole: Record<string, number>;
+    /** Agents by state */
+    agentsByState: Record<string, number>;
+}
+export interface ErrorMetrics {
+    /** Total errors in the time window */
+    totalErrors: number;
+    /** Errors by type */
+    errorsByType: Record<string, number>;
+    /** Recent errors (last N) */
+    recentErrors: ErrorEntry[];
+}
+export interface ErrorEntry {
+    /** Timestamp */
+    timestamp: number;
+    /** Agent ID */
+    agentId: string;
+    /** Error type/category */
+    type: string;
+    /** Error summary */
+    summary: string;
+}
+/**
+ * Compute throughput metrics for a time window.
+ *
+ * @param eventStore - EventStore to query
+ * @param windowMs - Time window in milliseconds (default: 5 minutes)
+ */
+export declare function getThroughputMetrics(eventStore: EventStore, windowMs?: number): ThroughputMetrics;
+/**
+ * Compute utilization metrics (current snapshot + window).
+ *
+ * @param eventStore - EventStore to query
+ * @param windowMs - Time window for spawn/stop counts (default: 5 minutes)
+ */
+export declare function getUtilizationMetrics(eventStore: EventStore, windowMs?: number): UtilizationMetrics;
+/**
+ * Compute error metrics for a time window.
+ *
+ * @param eventStore - EventStore to query
+ * @param windowMs - Time window in milliseconds (default: 30 minutes)
+ * @param maxRecent - Maximum recent errors to return (default: 20)
+ */
+export declare function getErrorMetrics(eventStore: EventStore, windowMs?: number, maxRecent?: number): ErrorMetrics;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/metrics/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/metrics/metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAO1D,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,cAAc,EAAE,MAAM,CAAC;IAEvB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IAEpB,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IAErB,2DAA2D;IAC3D,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnC,mCAAmC;IACnC,kBAAkB,EAAE,MAAM,CAAC;IAE3B,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IAEpB,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,+BAA+B;IAC/B,YAAY,EAAE,MAAM,CAAC;IAErB,8CAA8C;IAC9C,YAAY,EAAE,MAAM,CAAC;IAErB,8CAA8C;IAC9C,YAAY,EAAE,MAAM,CAAC;IAErB,qBAAqB;IACrB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAErC,sBAAsB;IACtB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IAEpB,qBAAqB;IACrB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAErC,6BAA6B;IAC7B,YAAY,EAAE,UAAU,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAElB,eAAe;IACf,OAAO,EAAE,MAAM,CAAC;IAEhB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IAEb,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,UAAU,EACtB,QAAQ,GAAE,MAAsB,GAC/B,iBAAiB,CAqDnB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,UAAU,EACtB,QAAQ,GAAE,MAAsB,GAC/B,kBAAkB,CAwCpB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,UAAU,EACtB,QAAQ,GAAE,MAAuB,EACjC,SAAS,GAAE,MAAW,GACrB,YAAY,CAmEd"}