macro-agent 0.1.1 → 0.1.3

package/dist/metrics/index.js

@@ -1,2 +1,7 @@
-export { getThroughputMetrics, getUtilizationMetrics, getErrorMetrics, } from "./metrics.js";
+/**
+ * Metrics module — observability for macro-agent.
+ *
+ * @module metrics
+ */
+export { collectMetrics } from "./metrics.js";
 //# sourceMappingURL=index.js.map

package/dist/metrics/index.js.map

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/metrics/metrics.d.ts

@@ -1,79 +1,18 @@
 /**
- * Metrics Module
+ * Metrics collection for macro-agent.
  *
- * Computes throughput, utilization, and error metrics from EventStore data.
- * No new events needed — aggregates existing spawn, terminate, task, and
- * status events.
+ * Single entry point: `collectMetrics()` gathers agent, task, and
+ * system metrics into a point-in-time snapshot.
  *
  * @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;
-}
+import type { MacroAgentSystemV2 } from "../boot-v2.js";
+import type { MetricsSnapshot } from "./types.js";
 /**
- * Compute throughput metrics for a time window.
+ * Collect a point-in-time metrics snapshot from the running system.
  *
- * @param eventStore - EventStore to query
- * @param windowMs - Time window in milliseconds (default: 5 minutes)
+ * @param system - The booted MacroAgentSystemV2 instance.
+ * @param startTime - `Date.now()` value captured at boot, used for uptime.
  */
-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;
+export declare function collectMetrics(system: MacroAgentSystemV2, startTime: number): Promise<MetricsSnapshot>;
 //# sourceMappingURL=metrics.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/metrics/metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAIV,eAAe,EAChB,MAAM,YAAY,CAAC;AAapB;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,kBAAkB,EAC1B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,CAAC,CAa1B"}

package/dist/metrics/metrics.js

@@ -1,166 +1,110 @@
 /**
- * Metrics Module
+ * Metrics collection for macro-agent.
  *
- * Computes throughput, utilization, and error metrics from EventStore data.
- * No new events needed — aggregates existing spawn, terminate, task, and
- * status events.
+ * Single entry point: `collectMetrics()` gathers agent, task, and
+ * system metrics into a point-in-time snapshot.
  *
  * @module metrics/metrics
  */
-// =============================================================================
-// Implementation
-// =============================================================================
+// ─────────────────────────────────────────────────────────────────
+// Constants
+// ─────────────────────────────────────────────────────────────────
+/** Threshold for considering an agent unhealthy (ms). */
+const UNHEALTHY_THRESHOLD_MS = 60_000;
+// ─────────────────────────────────────────────────────────────────
+// Public API
+// ─────────────────────────────────────────────────────────────────
 /**
- * Compute throughput metrics for a time window.
+ * Collect a point-in-time metrics snapshot from the running system.
  *
- * @param eventStore - EventStore to query
- * @param windowMs - Time window in milliseconds (default: 5 minutes)
+ * @param system - The booted MacroAgentSystemV2 instance.
+ * @param startTime - `Date.now()` value captured at boot, used for uptime.
  */
-export function getThroughputMetrics(eventStore, windowMs = 5 * 60 * 1000) {
-    const now = Date.now();
-    const windowStart = now - windowMs;
-    const taskEvents = eventStore.query({
-        type: "task",
-        after: windowStart,
-    });
-    let tasksCompleted = 0;
-    let tasksFailed = 0;
-    let tasksCreated = 0;
-    let totalCompletionTimeMs = 0;
-    let completedWithTime = 0;
-    for (const event of taskEvents) {
-        const action = event.payload?.action;
-        if (action === "created") {
-            tasksCreated++;
-        }
-        else if (action === "completed") {
-            tasksCompleted++;
-            // Try to compute completion time
-            const taskId = event.payload?.task_id;
-            if (taskId) {
-                const task = eventStore.getTask(taskId);
-                if (task?.created_at && task?.completed_at) {
-                    totalCompletionTimeMs += task.completed_at - task.created_at;
-                    completedWithTime++;
-                }
-            }
-        }
-        else if (action === "failed") {
-            tasksFailed++;
-        }
-    }
-    const windowMinutes = windowMs / 60000;
-    const completedPerMinute = windowMinutes > 0 ? tasksCompleted / windowMinutes : 0;
+export async function collectMetrics(system, startTime) {
+    const [agents, tasks, systemMetrics] = await Promise.all([
+        collectAgentMetrics(system),
+        collectTaskMetrics(system),
+        collectSystemMetrics(system, startTime),
+    ]);
     return {
-        tasksCompleted,
-        tasksFailed,
-        tasksCreated,
-        avgCompletionTimeMs: completedWithTime > 0
-            ? Math.round(totalCompletionTimeMs / completedWithTime)
-            : null,
-        completedPerMinute: Math.round(completedPerMinute * 100) / 100,
-        windowStart,
-        windowEnd: now,
+        timestamp: new Date().toISOString(),
+        agents,
+        tasks,
+        system: systemMetrics,
     };
 }
-/**
- * Compute utilization metrics (current snapshot + window).
- *
- * @param eventStore - EventStore to query
- * @param windowMs - Time window for spawn/stop counts (default: 5 minutes)
- */
-export function getUtilizationMetrics(eventStore, windowMs = 5 * 60 * 1000) {
-    const now = Date.now();
-    const windowStart = now - windowMs;
-    // Current agents
-    const allAgents = eventStore.listAgents();
-    const activeAgents = allAgents.filter((a) => a.state === "running" || a.state === "spawning");
-    // Agents by role
-    const agentsByRole = {};
-    for (const agent of activeAgents) {
-        const role = agent.role ?? "unknown";
-        agentsByRole[role] = (agentsByRole[role] ?? 0) + 1;
-    }
-    // Agents by state
-    const agentsByState = {};
-    for (const agent of allAgents) {
-        agentsByState[agent.state] = (agentsByState[agent.state] ?? 0) + 1;
+// ─────────────────────────────────────────────────────────────────
+// Agent Metrics
+// ─────────────────────────────────────────────────────────────────
+async function collectAgentMetrics(system) {
+    const agents = system.agentStore.listAgents();
+    const byState = {};
+    const byRole = {};
+    const byTeam = {};
+    for (const agent of agents) {
+        // Count by state
+        byState[agent.state] = (byState[agent.state] ?? 0) + 1;
+        // Count by role
+        byRole[agent.role] = (byRole[agent.role] ?? 0) + 1;
+        // Count by team (skip agents without a team)
+        if (agent.team) {
+            byTeam[agent.team] = (byTeam[agent.team] ?? 0) + 1;
+        }
     }
-    // Count spawn and terminate events in window
-    const spawnEvents = eventStore.query({
-        type: "spawn",
-        after: windowStart,
-    });
-    const terminateEvents = eventStore.query({
-        type: "stop",
-        after: windowStart,
-    });
+    const unhealthy = system.controlServer.getUnhealthyAgents(UNHEALTHY_THRESHOLD_MS).length;
     return {
-        activeAgents: activeAgents.length,
-        totalSpawned: spawnEvents.length,
-        totalStopped: terminateEvents.length,
-        agentsByRole,
-        agentsByState,
+        total: agents.length,
+        byState,
+        byRole,
+        byTeam,
+        unhealthy,
     };
 }
-/**
- * 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 function getErrorMetrics(eventStore, windowMs = 30 * 60 * 1000, maxRecent = 20) {
-    const now = Date.now();
-    const windowStart = now - windowMs;
-    // Query status events that indicate errors
-    const statusEvents = eventStore.query({
-        type: "status",
-        after: windowStart,
-    });
-    const errors = [];
-    const errorsByType = {};
-    for (const event of statusEvents) {
-        const statusType = event.payload?.status_type;
-        if (statusType !== "failed")
-            continue;
-        const agentId = event.source?.agent_id ?? "unknown";
-        const summary = event.payload?.summary ?? "Unknown error";
-        const errorType = event.payload?.details?.signal ??
-            "agent_failed";
-        errors.push({
-            timestamp: event.timestamp,
-            agentId,
-            type: errorType,
-            summary,
-        });
-        errorsByType[errorType] = (errorsByType[errorType] ?? 0) + 1;
+// ─────────────────────────────────────────────────────────────────
+// Task Metrics
+// ─────────────────────────────────────────────────────────────────
+async function collectTaskMetrics(system) {
+    // If the tasks adapter is not connected, return null
+    if (!system.tasksAdapter.connected) {
+        return null;
     }
-    // Also count task failures
-    const taskEvents = eventStore.query({
-        type: "task",
-        after: windowStart,
-    });
-    for (const event of taskEvents) {
-        if (event.payload?.action !== "failed")
-            continue;
-        const agentId = event.source?.agent_id ?? "unknown";
-        const taskId = event.payload?.task_id ?? "unknown";
-        errors.push({
-            timestamp: event.timestamp,
-            agentId,
-            type: "task_failed",
-            summary: `Task ${taskId} failed`,
-        });
-        errorsByType["task_failed"] = (errorsByType["task_failed"] ?? 0) + 1;
+    try {
+        const [allTasks, readyTasks] = await Promise.all([
+            system.tasksAdapter.listTasks(),
+            system.tasksAdapter.queryReady(),
+        ]);
+        const byStatus = {};
+        let blocked = 0;
+        for (const task of allTasks) {
+            byStatus[task.status] = (byStatus[task.status] ?? 0) + 1;
+            if (task.status === "blocked") {
+                blocked++;
+            }
+        }
+        return {
+            byStatus,
+            ready: readyTasks.length,
+            blocked,
+        };
     }
-    // Sort by timestamp descending and limit
-    errors.sort((a, b) => b.timestamp - a.timestamp);
-    const recentErrors = errors.slice(0, maxRecent);
+    catch {
+        // opentasks daemon may have disconnected — non-fatal
+        return null;
+    }
+}
+// ─────────────────────────────────────────────────────────────────
+// System Metrics
+// ─────────────────────────────────────────────────────────────────
+async function collectSystemMetrics(system, startTime) {
+    const uptime = Date.now() - startTime;
+    const triggerQueueDepth = system.triggerSystem.queue.getAgentsWithEvents().length;
+    // CronService.list() returns all enabled jobs
+    const cronJobs = await system.triggerSystem.cronService.list();
+    const cronJobCount = cronJobs.length;
     return {
-        totalErrors: errors.length,
-        errorsByType,
-        recentErrors,
+        uptime,
+        triggerQueueDepth,
+        cronJobCount,
     };
 }
 //# sourceMappingURL=metrics.js.map

package/dist/metrics/metrics.js.map

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

package/dist/metrics/types.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Metrics type definitions.
+ *
+ * @module metrics/types
+ */
+export interface AgentMetrics {
+    /** Total number of agents. */
+    total: number;
+    /** Count of agents by state (e.g., running, stopped). */
+    byState: Record<string, number>;
+    /** Count of agents by role (e.g., worker, coordinator). */
+    byRole: Record<string, number>;
+    /** Count of agents by team. */
+    byTeam: Record<string, number>;
+    /** Number of agents with stale MCP heartbeats. */
+    unhealthy: number;
+}
+export interface TaskMetrics {
+    /** Count of tasks by status (open, in_progress, blocked, closed). */
+    byStatus: Record<string, number>;
+    /** Number of tasks ready to be worked on (no active blockers). */
+    ready: number;
+    /** Number of blocked tasks. */
+    blocked: number;
+}
+export interface SystemMetrics {
+    /** Uptime in milliseconds since boot. */
+    uptime: number;
+    /** Number of agents with queued trigger events. */
+    triggerQueueDepth: number;
+    /** Number of registered cron jobs. */
+    cronJobCount: number;
+}
+export interface MetricsSnapshot {
+    /** ISO timestamp of when this snapshot was collected. */
+    timestamp: string;
+    /** Agent metrics. */
+    agents: AgentMetrics;
+    /** Task metrics, or null if opentasks is unavailable. */
+    tasks: TaskMetrics | null;
+    /** System-level metrics. */
+    system: SystemMetrics;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/metrics/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,MAAM,WAAW,WAAW;IAC1B,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;CACtB;AAMD,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,yDAAyD;IACzD,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,4BAA4B;IAC5B,MAAM,EAAE,aAAa,CAAC;CACvB"}

package/dist/metrics/types.js

@@ -0,0 +1,7 @@
+/**
+ * Metrics type definitions.
+ *
+ * @module metrics/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/metrics/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/metrics/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/roles/builtin/coordinator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../../src/roles/builtin/coordinator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQlD;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,EAAE,cA+C7B,CAAC"}
+{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../../src/roles/builtin/coordinator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AASlD;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,EAAE,cAgD7B,CAAC"}

package/dist/roles/builtin/coordinator.js

@@ -4,7 +4,7 @@
  * Plans work, assigns tasks, tracks progress.
  * IS the batch - orchestrates workers and integrator.
  */
-import { FILE_CAPABILITIES, TASK_CAPABILITIES, AGENT_CAPABILITIES, MSG_CAPABILITIES, } from "../capabilities.js";
+import { FILE_CAPABILITIES, TASK_CAPABILITIES, AGENT_CAPABILITIES, MSG_CAPABILITIES, WORKSPACE_CAPABILITIES, } from "../capabilities.js";
 /**
  * Coordinator Role
  *
@@ -33,6 +33,7 @@ export const CoordinatorRole = {
         MSG_CAPABILITIES.SEND,
         MSG_CAPABILITIES.BROADCAST,
         MSG_CAPABILITIES.SUBSCRIBE,
+        WORKSPACE_CAPABILITIES.STREAM,
         // Note: lifecycle.done is optional, configured per-coordinator
     ],
     workspace: {

package/dist/roles/builtin/coordinator.js.map

@@ -1 +1 @@
-{"version":3,"file":"coordinator.js","sourceRoot":"","sources":["../../../src/roles/builtin/coordinator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,eAAe,GAAmB;IAC7C,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,aAAa;IAC1B,WAAW,EAAE,2DAA2D;IAExE,YAAY,EAAE;QACZ,iBAAiB,CAAC,IAAI;QACtB,iBAAiB,CAAC,KAAK,EAAE,mCAAmC;QAC5D,iBAAiB,CAAC,MAAM;QACxB,iBAAiB,CAAC,MAAM;QACxB,iBAAiB,CAAC,MAAM;QACxB,iBAAiB,CAAC,KAAK;QACvB,kBAAkB,CAAC,YAAY;QAC/B,kBAAkB,CAAC,gBAAgB;QACnC,kBAAkB,CAAC,aAAa;QAChC,kBAAkB,CAAC,SAAS;QAC5B,gBAAgB,CAAC,IAAI;QACrB,gBAAgB,CAAC,SAAS;QAC1B,gBAAgB,CAAC,SAAS;QAC1B,+DAA+D;KAChE;IAED,SAAS,EAAE;QACT,IAAI,EAAE,KAAK;QACX,sDAAsD;QACtD,aAAa,EAAE,iCAAiC;QAChD,kBAAkB,EAAE,IAAI;QACxB,iDAAiD;QACjD,sBAAsB,EAAE,IAAI;KAC7B;IAED,SAAS,EAAE;QACT,IAAI,EAAE,YAAY;QAClB,gBAAgB,EAAE,IAAI;KACvB;IAED,QAAQ,EAAE;QACR,aAAa,EAAE;YACb,aAAa;YACb,gBAAgB;YAChB,eAAe;YACf,mBAAmB;YACnB,aAAa;YACb,iBAAiB;SAClB;QACD,OAAO,EAAE,CAAC,eAAe,CAAC;KAC3B;CACF,CAAC"}
+{"version":3,"file":"coordinator.js","sourceRoot":"","sources":["../../../src/roles/builtin/coordinator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,eAAe,GAAmB;IAC7C,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,aAAa;IAC1B,WAAW,EAAE,2DAA2D;IAExE,YAAY,EAAE;QACZ,iBAAiB,CAAC,IAAI;QACtB,iBAAiB,CAAC,KAAK,EAAE,mCAAmC;QAC5D,iBAAiB,CAAC,MAAM;QACxB,iBAAiB,CAAC,MAAM;QACxB,iBAAiB,CAAC,MAAM;QACxB,iBAAiB,CAAC,KAAK;QACvB,kBAAkB,CAAC,YAAY;QAC/B,kBAAkB,CAAC,gBAAgB;QACnC,kBAAkB,CAAC,aAAa;QAChC,kBAAkB,CAAC,SAAS;QAC5B,gBAAgB,CAAC,IAAI;QACrB,gBAAgB,CAAC,SAAS;QAC1B,gBAAgB,CAAC,SAAS;QAC1B,sBAAsB,CAAC,MAAM;QAC7B,+DAA+D;KAChE;IAED,SAAS,EAAE;QACT,IAAI,EAAE,KAAK;QACX,sDAAsD;QACtD,aAAa,EAAE,iCAAiC;QAChD,kBAAkB,EAAE,IAAI;QACxB,iDAAiD;QACjD,sBAAsB,EAAE,IAAI;KAC7B;IAED,SAAS,EAAE;QACT,IAAI,EAAE,YAAY;QAClB,gBAAgB,EAAE,IAAI;KACvB;IAED,QAAQ,EAAE;QACR,aAAa,EAAE;YACb,aAAa;YACb,gBAAgB;YAChB,eAAe;YACf,mBAAmB;YACnB,aAAa;YACb,iBAAiB;SAClB;QACD,OAAO,EAAE,CAAC,eAAe,CAAC;KAC3B;CACF,CAAC"}

package/dist/roles/builtin/integrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"integrator.d.ts","sourceRoot":"","sources":["../../../src/roles/builtin/integrator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AASlD;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,EAAE,cAkC5B,CAAC"}
+{"version":3,"file":"integrator.d.ts","sourceRoot":"","sources":["../../../src/roles/builtin/integrator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAUlD;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,EAAE,cAmC5B,CAAC"}

package/dist/roles/builtin/integrator.js

@@ -4,7 +4,7 @@
  * Handles merging worker branches into integration branch.
  * Persistent, spawns resolver workers on conflict.
  */
-import { FILE_CAPABILITIES, GIT_CAPABILITIES, AGENT_CAPABILITIES, LIFECYCLE_CAPABILITIES, MSG_CAPABILITIES, } from "../capabilities.js";
+import { FILE_CAPABILITIES, GIT_CAPABILITIES, AGENT_CAPABILITIES, LIFECYCLE_CAPABILITIES, MSG_CAPABILITIES, WORKSPACE_CAPABILITIES, } from "../capabilities.js";
 /**
  * Integrator Role
  *
@@ -28,6 +28,7 @@ export const IntegratorRole = {
         LIFECYCLE_CAPABILITIES.DONE,
         MSG_CAPABILITIES.SEND,
         MSG_CAPABILITIES.SUBSCRIBE,
+        WORKSPACE_CAPABILITIES.INTEGRATE,
     ],
     workspace: {
         type: "own",

package/dist/roles/builtin/integrator.js.map

@@ -1 +1 @@
-{"version":3,"file":"integrator.js","sourceRoot":"","sources":["../../../src/roles/builtin/integrator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,YAAY;IACzB,WAAW,EACT,8EAA8E;IAEhF,YAAY,EAAE;QACZ,iBAAiB,CAAC,IAAI;QACtB,iBAAiB,CAAC,KAAK;QACvB,gBAAgB,CAAC,MAAM;QACvB,gBAAgB,CAAC,KAAK;QACtB,gBAAgB,CAAC,IAAI;QACrB,kBAAkB,CAAC,YAAY,EAAE,qCAAqC;QACtE,sBAAsB,CAAC,IAAI;QAC3B,gBAAgB,CAAC,IAAI;QACrB,gBAAgB,CAAC,SAAS;KAC3B;IAED,SAAS,EAAE;QACT,IAAI,EAAE,KAAK;QACX,6EAA6E;QAC7E,aAAa,EAAE,yCAAyC;QACxD,kBAAkB,EAAE,IAAI;KACzB;IAED,SAAS,EAAE;QACT,IAAI,EAAE,YAAY;QAClB,gBAAgB,EAAE,IAAI;KACvB;IAED,QAAQ,EAAE;QACR,aAAa,EAAE,CAAC,eAAe,EAAE,aAAa,CAAC;QAC/C,OAAO,EAAE,CAAC,gBAAgB,EAAE,eAAe,EAAE,mBAAmB,CAAC;KAClE;CACF,CAAC"}
+{"version":3,"file":"integrator.js","sourceRoot":"","sources":["../../../src/roles/builtin/integrator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,YAAY;IACzB,WAAW,EACT,8EAA8E;IAEhF,YAAY,EAAE;QACZ,iBAAiB,CAAC,IAAI;QACtB,iBAAiB,CAAC,KAAK;QACvB,gBAAgB,CAAC,MAAM;QACvB,gBAAgB,CAAC,KAAK;QACtB,gBAAgB,CAAC,IAAI;QACrB,kBAAkB,CAAC,YAAY,EAAE,qCAAqC;QACtE,sBAAsB,CAAC,IAAI;QAC3B,gBAAgB,CAAC,IAAI;QACrB,gBAAgB,CAAC,SAAS;QAC1B,sBAAsB,CAAC,SAAS;KACjC;IAED,SAAS,EAAE;QACT,IAAI,EAAE,KAAK;QACX,6EAA6E;QAC7E,aAAa,EAAE,yCAAyC;QACxD,kBAAkB,EAAE,IAAI;KACzB;IAED,SAAS,EAAE;QACT,IAAI,EAAE,YAAY;QAClB,gBAAgB,EAAE,IAAI;KACvB;IAED,QAAQ,EAAE;QACR,aAAa,EAAE,CAAC,eAAe,EAAE,aAAa,CAAC;QAC/C,OAAO,EAAE,CAAC,gBAAgB,EAAE,eAAe,EAAE,mBAAmB,CAAC;KAClE;CACF,CAAC"}

package/dist/roles/builtin/worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../../src/roles/builtin/worker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAalD;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,EAAE,cA6CxB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,cA+ChC,CAAC"}
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../../src/roles/builtin/worker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAclD;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,EAAE,cA8CxB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,cAgDhC,CAAC"}

package/dist/roles/builtin/worker.js

@@ -4,7 +4,7 @@
  * Executes discrete tasks, writes code, runs tests.
  * Ephemeral, task-bound with 30-minute stale timeout.
  */
-import { FILE_CAPABILITIES, GIT_CAPABILITIES, EXEC_CAPABILITIES, LIFECYCLE_CAPABILITIES, AGENT_CAPABILITIES, MSG_CAPABILITIES, } from "../capabilities.js";
+import { FILE_CAPABILITIES, GIT_CAPABILITIES, EXEC_CAPABILITIES, LIFECYCLE_CAPABILITIES, AGENT_CAPABILITIES, MSG_CAPABILITIES, WORKSPACE_CAPABILITIES, } from "../capabilities.js";
 /** 30 minutes in milliseconds (stale timeout) */
 const STALE_TIMEOUT_MS = 30 * 60 * 1000;
 /**
@@ -33,6 +33,7 @@ export const WorkerRole = {
         LIFECYCLE_CAPABILITIES.DONE,
         AGENT_CAPABILITIES.SPAWN_WORKER,
         MSG_CAPABILITIES.SEND,
+        WORKSPACE_CAPABILITIES.WORKTREE,
     ],
     workspace: {
         type: "own",
@@ -82,6 +83,7 @@ export const ResolverWorkerRole = {
         LIFECYCLE_CAPABILITIES.DONE,
         AGENT_CAPABILITIES.SPAWN_WORKER,
         MSG_CAPABILITIES.SEND,
+        WORKSPACE_CAPABILITIES.WORKTREE,
     ],
     // Inherits workspace from worker
     workspace: {

package/dist/roles/builtin/worker.js.map

@@ -1 +1 @@
-{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../../src/roles/builtin/worker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,iDAAiD;AACjD,MAAM,gBAAgB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAExC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,UAAU,GAAmB;IACxC,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,QAAQ;IACrB,WAAW,EAAE,kDAAkD;IAE/D,YAAY,EAAE;QACZ,iBAAiB,CAAC,IAAI;QACtB,iBAAiB,CAAC,KAAK;QACvB,iBAAiB,CAAC,MAAM;QACxB,gBAAgB,CAAC,MAAM;QACvB,iBAAiB,CAAC,OAAO;QACzB,iBAAiB,CAAC,KAAK;QACvB,iBAAiB,CAAC,IAAI;QACtB,iBAAiB,CAAC,IAAI;QACtB,sBAAsB,CAAC,IAAI;QAC3B,kBAAkB,CAAC,YAAY;QAC/B,gBAAgB,CAAC,IAAI;KACtB;IAED,SAAS,EAAE;QACT,IAAI,EAAE,KAAK;QACX,aAAa,EAAE,mDAAmD;QAClE,kBAAkB,EAAE,IAAI;KACzB;IAED,SAAS,EAAE;QACT,IAAI,EAAE,WAAW;QACjB,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,gBAAgB;QAC/B,gBAAgB,EAAE,IAAI;QACtB,WAAW,EAAE,IAAI;KAClB;IAED,QAAQ,EAAE;QACR,aAAa,EAAE,CAAC,eAAe,EAAE,cAAc,CAAC;QAChD,OAAO,EAAE,CAAC,aAAa,EAAE,eAAe,CAAC;KAC1C;IAED,YAAY,EAAE;;;;;;4GAM4F;CAC3G,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAmB;IAChD,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,iBAAiB;IAC9B,WAAW,EAAE,8CAA8C;IAC3D,OAAO,EAAE,QAAQ;IAEjB,oCAAoC;IACpC,YAAY,EAAE;QACZ,iBAAiB,CAAC,IAAI;QACtB,iBAAiB,CAAC,KAAK;QACvB,iBAAiB,CAAC,MAAM;QACxB,gBAAgB,CAAC,MAAM;QACvB,iBAAiB,CAAC,OAAO;QACzB,iBAAiB,CAAC,KAAK;QACvB,iBAAiB,CAAC,IAAI;QACtB,iBAAiB,CAAC,IAAI;QACtB,sBAAsB,CAAC,IAAI;QAC3B,kBAAkB,CAAC,YAAY;QAC/B,gBAAgB,CAAC,IAAI;KACtB;IAED,iCAAiC;IACjC,SAAS,EAAE;QACT,IAAI,EAAE,KAAK;QACX,aAAa,EAAE,kDAAkD;QACjE,kBAAkB,EAAE,IAAI;KACzB;IAED,iCAAiC;IACjC,SAAS,EAAE;QACT,IAAI,EAAE,WAAW;QACjB,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,gBAAgB;QAC/B,gBAAgB,EAAE,IAAI;QACtB,WAAW,EAAE,IAAI;KAClB;IAED,QAAQ,EAAE;QACR,aAAa,EAAE,CAAC,eAAe,EAAE,cAAc,CAAC;QAChD,OAAO,EAAE,CAAC,aAAa,EAAE,eAAe,CAAC;KAC1C;IAED,YAAY,EAAE;;;;6BAIa;CAC5B,CAAC"}
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../../src/roles/builtin/worker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAE5B,iDAAiD;AACjD,MAAM,gBAAgB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAExC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,UAAU,GAAmB;IACxC,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,QAAQ;IACrB,WAAW,EAAE,kDAAkD;IAE/D,YAAY,EAAE;QACZ,iBAAiB,CAAC,IAAI;QACtB,iBAAiB,CAAC,KAAK;QACvB,iBAAiB,CAAC,MAAM;QACxB,gBAAgB,CAAC,MAAM;QACvB,iBAAiB,CAAC,OAAO;QACzB,iBAAiB,CAAC,KAAK;QACvB,iBAAiB,CAAC,IAAI;QACtB,iBAAiB,CAAC,IAAI;QACtB,sBAAsB,CAAC,IAAI;QAC3B,kBAAkB,CAAC,YAAY;QAC/B,gBAAgB,CAAC,IAAI;QACrB,sBAAsB,CAAC,QAAQ;KAChC;IAED,SAAS,EAAE;QACT,IAAI,EAAE,KAAK;QACX,aAAa,EAAE,mDAAmD;QAClE,kBAAkB,EAAE,IAAI;KACzB;IAED,SAAS,EAAE;QACT,IAAI,EAAE,WAAW;QACjB,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,gBAAgB;QAC/B,gBAAgB,EAAE,IAAI;QACtB,WAAW,EAAE,IAAI;KAClB;IAED,QAAQ,EAAE;QACR,aAAa,EAAE,CAAC,eAAe,EAAE,cAAc,CAAC;QAChD,OAAO,EAAE,CAAC,aAAa,EAAE,eAAe,CAAC;KAC1C;IAED,YAAY,EAAE;;;;;;4GAM4F;CAC3G,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAmB;IAChD,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,iBAAiB;IAC9B,WAAW,EAAE,8CAA8C;IAC3D,OAAO,EAAE,QAAQ;IAEjB,oCAAoC;IACpC,YAAY,EAAE;QACZ,iBAAiB,CAAC,IAAI;QACtB,iBAAiB,CAAC,KAAK;QACvB,iBAAiB,CAAC,MAAM;QACxB,gBAAgB,CAAC,MAAM;QACvB,iBAAiB,CAAC,OAAO;QACzB,iBAAiB,CAAC,KAAK;QACvB,iBAAiB,CAAC,IAAI;QACtB,iBAAiB,CAAC,IAAI;QACtB,sBAAsB,CAAC,IAAI;QAC3B,kBAAkB,CAAC,YAAY;QAC/B,gBAAgB,CAAC,IAAI;QACrB,sBAAsB,CAAC,QAAQ;KAChC;IAED,iCAAiC;IACjC,SAAS,EAAE;QACT,IAAI,EAAE,KAAK;QACX,aAAa,EAAE,kDAAkD;QACjE,kBAAkB,EAAE,IAAI;KACzB;IAED,iCAAiC;IACjC,SAAS,EAAE;QACT,IAAI,EAAE,WAAW;QACjB,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,gBAAgB;QAC/B,gBAAgB,EAAE,IAAI;QACtB,WAAW,EAAE,IAAI;KAClB;IAED,QAAQ,EAAE;QACR,aAAa,EAAE,CAAC,eAAe,EAAE,cAAc,CAAC;QAChD,OAAO,EAAE,CAAC,aAAa,EAAE,eAAe,CAAC;KAC1C;IAED,YAAY,EAAE;;;;6BAIa;CAC5B,CAAC"}

package/dist/roles/capabilities.d.ts

@@ -53,6 +53,12 @@ export declare const MSG_CAPABILITIES: {
     BROADCAST: "msg.broadcast";
     SUBSCRIBE: "msg.subscribe";
 };
+/** Workspace capabilities */
+export declare const WORKSPACE_CAPABILITIES: {
+    WORKTREE: "workspace.worktree";
+    STREAM: "workspace.stream";
+    INTEGRATE: "workspace.integrate";
+};
 /** Wildcard capability */
 export declare const WILDCARD_CAPABILITY: "*";
 /**

package/dist/roles/capabilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/roles/capabilities.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAMhE,kCAAkC;AAClC,eAAO,MAAM,iBAAiB;;;;CAI7B,CAAC;AAEF,iCAAiC;AACjC,eAAO,MAAM,gBAAgB;;;;;;CAM5B,CAAC;AAEF,oCAAoC;AACpC,eAAO,MAAM,kBAAkB;;;;;;CAM9B,CAAC;AAEF,6BAA6B;AAC7B,eAAO,MAAM,sBAAsB;;;;CAIlC,CAAC;AAEF,mCAAmC;AACnC,eAAO,MAAM,iBAAiB;;;;;;CAM7B,CAAC;AAEF,6BAA6B;AAC7B,eAAO,MAAM,iBAAiB;;;;;CAK7B,CAAC;AAEF,iCAAiC;AACjC,eAAO,MAAM,gBAAgB;;;;CAI5B,CAAC;AAEF,0BAA0B;AAC1B,eAAO,MAAM,mBAAmB,EAAG,GAAY,CAAC;AAMhD;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,GAAG,CAAC,UAAU,CAsC3C,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,IAAI,UAAU,CAU9E;AAMD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,iBAwCjC,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,EAUxC,CAAC;AAEF;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,UAAU,EAAE,EAC1B,YAAY,EAAE,MAAM,EAAE,GACrB,MAAM,EAAE,CAkBV;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,GACf,OAAO,CAMT"}
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/roles/capabilities.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAMhE,kCAAkC;AAClC,eAAO,MAAM,iBAAiB;;;;CAI7B,CAAC;AAEF,iCAAiC;AACjC,eAAO,MAAM,gBAAgB;;;;;;CAM5B,CAAC;AAEF,oCAAoC;AACpC,eAAO,MAAM,kBAAkB;;;;;;CAM9B,CAAC;AAEF,6BAA6B;AAC7B,eAAO,MAAM,sBAAsB;;;;CAIlC,CAAC;AAEF,mCAAmC;AACnC,eAAO,MAAM,iBAAiB;;;;;;CAM7B,CAAC;AAEF,6BAA6B;AAC7B,eAAO,MAAM,iBAAiB;;;;;CAK7B,CAAC;AAEF,iCAAiC;AACjC,eAAO,MAAM,gBAAgB;;;;CAI5B,CAAC;AAEF,6BAA6B;AAC7B,eAAO,MAAM,sBAAsB;;;;CAIlC,CAAC;AAEF,0BAA0B;AAC1B,eAAO,MAAM,mBAAmB,EAAG,GAAY,CAAC;AAMhD;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,GAAG,CAAC,UAAU,CA0C3C,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,IAAI,UAAU,CAU9E;AAMD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,iBAwCjC,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,EAUxC,CAAC;AAEF;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,UAAU,EAAE,EAC1B,YAAY,EAAE,MAAM,EAAE,GACrB,MAAM,EAAE,CAkBV;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,GACf,OAAO,CAMT"}

package/dist/roles/capabilities.js

@@ -55,6 +55,12 @@ export const MSG_CAPABILITIES = {
     BROADCAST: "msg.broadcast",
     SUBSCRIBE: "msg.subscribe",
 };
+/** Workspace capabilities */
+export const WORKSPACE_CAPABILITIES = {
+    WORKTREE: "workspace.worktree", // Gets own git worktree; done() submits to merge queue
+    STREAM: "workspace.stream", // Creates integration stream at spawn
+    INTEGRATE: "workspace.integrate", // Joins stream; processes merge queue entries
+};
 /** Wildcard capability */
 export const WILDCARD_CAPABILITY = "*";
 // =============================================================================
@@ -99,6 +105,10 @@ export const ALL_CAPABILITIES = new Set([
     MSG_CAPABILITIES.SEND,
     MSG_CAPABILITIES.BROADCAST,
     MSG_CAPABILITIES.SUBSCRIBE,
+    // Workspace
+    WORKSPACE_CAPABILITIES.WORKTREE,
+    WORKSPACE_CAPABILITIES.STREAM,
+    WORKSPACE_CAPABILITIES.INTEGRATE,
     // Wildcard
     WILDCARD_CAPABILITY,
 ]);