macro-agent 0.1.1 → 0.1.3

package/dist/cognitive/types.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Cognitive Module - Bridge Types
+ *
+ * Structurally compatible with cognitive-core's runtime types (AgentSession,
+ * AgentMessage, ToolCall) without importing from cognitive-core.
+ * TypeScript's structural typing makes these assignable without casting.
+ *
+ * Stripped to what OpenHive needs: agent execution + session tracking.
+ * Atlas, trajectory extraction, and ACP extensions are handled by OpenHive.
+ */
+import type { AgentId } from "../store/types/index.js";
+import type { TasksAdapter, InboxAdapter } from "../adapters/types.js";
+export interface CognitiveAgentMessage {
+    role: "user" | "assistant" | "system" | "tool_use" | "tool_result";
+    content: string;
+    toolName?: string;
+    toolInput?: unknown;
+    toolOutput?: unknown;
+    timestamp: Date;
+}
+export interface CognitiveToolCall {
+    id: string;
+    name: string;
+    input: unknown;
+    output?: unknown;
+    error?: string;
+    startTime: Date;
+    endTime?: Date;
+}
+export type CognitiveAgentState = "idle" | "running" | "paused" | "completed" | "failed";
+export interface CognitiveTask {
+    description: string;
+    context?: Record<string, unknown>;
+    domain?: string;
+}
+/**
+ * Agent session — represents a running or completed agent execution.
+ * Structurally matches cognitive-core's AgentSession.
+ */
+export interface CognitiveAgentSession {
+    id: string;
+    agentType: string;
+    task: CognitiveTask;
+    state: CognitiveAgentState;
+    messages: CognitiveAgentMessage[];
+    toolCalls: CognitiveToolCall[];
+    startTime: Date;
+    endTime?: Date;
+    result?: unknown;
+    error?: string;
+    metadata: Record<string, unknown>;
+}
+/**
+ * Configuration for spawning an agent.
+ * Structurally matches cognitive-core's AgentSpawnConfig (core fields).
+ */
+export interface CognitiveAgentSpawnConfig {
+    agentType: string;
+    task: CognitiveTask;
+    systemPromptAdditions?: string;
+    env?: Record<string, string>;
+    cwd?: string;
+    timeout?: number;
+    onMessage?: (message: CognitiveAgentMessage) => void;
+}
+/**
+ * Event emitted when a cognitive session completes (success or failure).
+ */
+export interface SessionCompleteEvent {
+    sessionId: string;
+    agentId: string;
+    state: CognitiveAgentState;
+    duration_ms: number;
+    message_count: number;
+    tool_call_count: number;
+}
+/**
+ * Configuration for MacroAgentBackend.
+ *
+ * Stripped to essentials: agent lifecycle + optional task tracking.
+ * Atlas/trajectory handling is done by OpenHive, not the swarm.
+ */
+export interface MacroAgentBackendConfig {
+    /** Max follow-up prompts if agent doesn't call done(). Default: 1 */
+    maxFollowUps?: number;
+    /** Fraction of timeout at which to send "wrap up" nudge. Default: 0.8 */
+    softTimeoutRatio?: number;
+    /** Optional TasksAdapter for tracking analyst tasks. */
+    tasksAdapter?: TasksAdapter;
+    /** Callback invoked when a session completes (success or failure). */
+    onSessionComplete?: (event: SessionCompleteEvent) => void;
+    /** Optional inbox adapter for sending session.complete notifications. */
+    inboxAdapter?: InboxAdapter;
+    /** When true, spawned analysts are children of coordinatorAgentId. */
+    useTeam?: boolean;
+    /** Parent agent ID when useTeam is true. */
+    coordinatorAgentId?: AgentId;
+}
+/**
+ * Internal session tracking state.
+ */
+export interface MacroSessionState {
+    agentId: AgentId;
+    session: CognitiveAgentSession;
+    config: CognitiveAgentSpawnConfig;
+    runPromise: Promise<void>;
+    taskId?: string;
+}
+export interface CognitiveBatchConfig {
+    tasks: CognitiveAgentSpawnConfig[];
+    maxConcurrency?: number;
+}
+export interface CognitiveBatchTaskResult {
+    config: CognitiveAgentSpawnConfig;
+    session?: CognitiveAgentSession;
+    error?: string;
+}
+export interface CognitiveBatchResult {
+    results: CognitiveBatchTaskResult[];
+    completed: number;
+    failed: number;
+    cancelled: boolean;
+}
+export interface CognitiveBatchHandle {
+    totalTasks: number;
+    waitForAll(): Promise<CognitiveBatchResult>;
+    cancel(): Promise<CognitiveBatchResult>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/cognitive/types.js

@@ -0,0 +1,12 @@
+/**
+ * Cognitive Module - Bridge Types
+ *
+ * Structurally compatible with cognitive-core's runtime types (AgentSession,
+ * AgentMessage, ToolCall) without importing from cognitive-core.
+ * TypeScript's structural typing makes these assignable without casting.
+ *
+ * Stripped to what OpenHive needs: agent execution + session tracking.
+ * Atlas, trajectory extraction, and ACP extensions are handled by OpenHive.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cognitive/types.js.map

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

package/dist/cognitive/workspace-handler.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Workspace Execution Handler
+ *
+ * Bridge between OpenHive's workspace.execute MAP messages and
+ * macro-agent's MacroAgentBackend. Receives workspace tasks from
+ * OpenHive, spawns analyst agents, and sends results back.
+ *
+ * Registered as a MAP notification handler on the swarm's inbound
+ * WebSocket connection to the OpenHive hub.
+ *
+ * Protocol:
+ *   Hive → Swarm: x-openhive/learning.workspace.execute
+ *     { request_id, prompt, cwd, system_context, timeout }
+ *   Swarm → Hive: x-openhive/learning.workspace.result
+ *     { request_id, success, output, structured, duration_ms }
+ */
+import type { MacroAgentBackend } from "./macro-agent-backend.js";
+export interface WorkspaceHandlerDeps {
+    backend: MacroAgentBackend;
+    /** Send a JSON-RPC notification back to the hub */
+    sendToHub: (message: object) => void;
+}
+export interface WorkspaceExecuteParams {
+    request_id: string;
+    prompt: string;
+    cwd: string;
+    system_context?: string;
+    timeout?: number;
+}
+/**
+ * Handle an incoming workspace.execute request from OpenHive.
+ *
+ * Spawns an analyst agent via MacroAgentBackend, waits for completion,
+ * then sends the result back to the hub.
+ */
+export declare function handleWorkspaceExecute(deps: WorkspaceHandlerDeps, params: WorkspaceExecuteParams): Promise<void>;
+/**
+ * Check if a MAP notification is a workspace.execute request.
+ */
+export declare function isWorkspaceExecuteMessage(msg: {
+    method?: string;
+}): msg is {
+    method: "x-openhive/learning.workspace.execute";
+    params: WorkspaceExecuteParams;
+};
+//# sourceMappingURL=workspace-handler.d.ts.map

package/dist/cognitive/workspace-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-handler.d.ts","sourceRoot":"","sources":["../../src/cognitive/workspace-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,mDAAmD;IACnD,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,oBAAoB,EAC1B,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,IAAI,CAAC,CA8Gf;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACvB,GAAG,IAAI;IAAE,MAAM,EAAE,uCAAuC,CAAC;IAAC,MAAM,EAAE,sBAAsB,CAAA;CAAE,CAE5F"}

package/dist/cognitive/workspace-handler.js

@@ -0,0 +1,135 @@
+/**
+ * Workspace Execution Handler
+ *
+ * Bridge between OpenHive's workspace.execute MAP messages and
+ * macro-agent's MacroAgentBackend. Receives workspace tasks from
+ * OpenHive, spawns analyst agents, and sends results back.
+ *
+ * Registered as a MAP notification handler on the swarm's inbound
+ * WebSocket connection to the OpenHive hub.
+ *
+ * Protocol:
+ *   Hive → Swarm: x-openhive/learning.workspace.execute
+ *     { request_id, prompt, cwd, system_context, timeout }
+ *   Swarm → Hive: x-openhive/learning.workspace.result
+ *     { request_id, success, output, structured, duration_ms }
+ */
+/**
+ * Handle an incoming workspace.execute request from OpenHive.
+ *
+ * Spawns an analyst agent via MacroAgentBackend, waits for completion,
+ * then sends the result back to the hub.
+ */
+export async function handleWorkspaceExecute(deps, params) {
+    const { backend, sendToHub } = deps;
+    const { request_id, prompt, cwd, system_context, timeout } = params;
+    const startTime = Date.now();
+    try {
+        // Build spawn config from the workspace task
+        const spawnConfig = {
+            agentType: "claude-code",
+            task: {
+                description: prompt,
+                context: { workspace_cwd: cwd },
+            },
+            systemPromptAdditions: system_context,
+            cwd,
+            timeout: timeout || 300_000,
+        };
+        // Spawn analyst agent — this runs to completion
+        const session = await backend.spawn(spawnConfig);
+        // Wait for the session to complete (backend runs it in background)
+        // Poll until session state changes from "running"
+        const deadline = Date.now() + (timeout || 300_000);
+        while (Date.now() < deadline) {
+            const current = await backend.getSession(session.id);
+            if (!current || current.state !== "running")
+                break;
+            await new Promise((r) => setTimeout(r, 500));
+        }
+        const finalSession = await backend.getSession(session.id);
+        const durationMs = Date.now() - startTime;
+        if (!finalSession || finalSession.state === "running") {
+            // Timed out
+            await backend.terminate(session.id).catch(() => { });
+            sendToHub({
+                jsonrpc: "2.0",
+                method: "x-openhive/learning.workspace.result",
+                params: {
+                    request_id,
+                    success: false,
+                    output: "",
+                    error: "Workspace execution timed out",
+                    duration_ms: durationMs,
+                },
+            });
+            return;
+        }
+        // Collect output — read from workspace output directory if available
+        let output = "";
+        let structured = undefined;
+        if (finalSession.state === "completed") {
+            // The agent should have written output files to cwd/output/
+            try {
+                const fs = await import("fs");
+                const path = await import("path");
+                const outputDir = path.join(cwd, "output");
+                if (fs.existsSync(outputDir)) {
+                    const files = fs.readdirSync(outputDir).filter((f) => f.endsWith(".json"));
+                    if (files.length > 0) {
+                        const content = fs.readFileSync(path.join(outputDir, files[0]), "utf-8");
+                        output = content;
+                        try {
+                            structured = JSON.parse(content);
+                        }
+                        catch {
+                            /* not valid JSON, use raw text */
+                        }
+                    }
+                }
+            }
+            catch {
+                /* output collection is best-effort */
+            }
+            // Fallback: use session result
+            if (!output && finalSession.result) {
+                output = typeof finalSession.result === "string"
+                    ? finalSession.result
+                    : JSON.stringify(finalSession.result);
+                structured = finalSession.result;
+            }
+        }
+        sendToHub({
+            jsonrpc: "2.0",
+            method: "x-openhive/learning.workspace.result",
+            params: {
+                request_id,
+                success: finalSession.state === "completed",
+                output,
+                structured,
+                error: finalSession.error,
+                duration_ms: durationMs,
+            },
+        });
+    }
+    catch (err) {
+        sendToHub({
+            jsonrpc: "2.0",
+            method: "x-openhive/learning.workspace.result",
+            params: {
+                request_id,
+                success: false,
+                output: "",
+                error: err instanceof Error ? err.message : String(err),
+                duration_ms: Date.now() - startTime,
+            },
+        });
+    }
+}
+/**
+ * Check if a MAP notification is a workspace.execute request.
+ */
+export function isWorkspaceExecuteMessage(msg) {
+    return msg.method === "x-openhive/learning.workspace.execute";
+}
+//# sourceMappingURL=workspace-handler.js.map

package/dist/cognitive/workspace-handler.js.map

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

package/dist/config/project-config.d.ts

@@ -8,6 +8,15 @@
  *
  * @module config/project-config
  */
+/**
+ * Entry in the `teams` config for declaring additional team templates.
+ */
+export interface TeamConfigEntry {
+    /** Template name (defaults to the key) */
+    template?: string;
+    /** Auto-start on server boot (default: false) */
+    autoStart?: boolean;
+}
 /**
  * Typed configuration schema for multiagent.
  *
@@ -15,8 +24,10 @@
  * Environment variables override file-based config.
  */
 export interface MultiagentConfig {
-    /** Team template name to load on startup */
+    /** Default team template name to load on startup */
     team?: string;
+    /** Additional teams available for dynamic or auto-start loading */
+    teams?: Record<string, TeamConfigEntry>;
     /** Server port (default: 3001) */
     port?: number;
     /** Server host (default: "localhost") */
@@ -68,7 +79,7 @@ export declare function getProjectConfigPath(projectPath?: string): string;
 /**
  * Get the global config file path.
  *
- * @returns Absolute path to ~/.multiagent/config.json
+ * @returns Absolute path to ~/.multiagent/config.json (or MACRO_AGENT_HOME/config.json)
  */
 export declare function getGlobalConfigPath(): string;
 /**

package/dist/config/project-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-config.d.ts","sourceRoot":"","sources":["../../src/config/project-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAUH;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,4BAA4B;IAC5B,IAAI,CAAC,EAAE;QACL,4BAA4B;QAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,0BAA0B;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF,0BAA0B;IAC1B,IAAI,CAAC,EAAE;QACL,2CAA2C;QAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,gCAAgC;QAChC,SAAS,CAAC,EAAE;YACV,sCAAsC;YACtC,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,gDAAgD;YAChD,UAAU,CAAC,EAAE,OAAO,CAAC;YACrB,iEAAiE;YACjE,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,sEAAsE;YACtE,gBAAgB,CAAC,EAAE,OAAO,CAAC;SAC5B,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,qDAAqD;IACrD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAMD,4BAA4B;AAC5B,eAAO,MAAM,UAAU,gBAAgB,CAAC;AAExC,uBAAuB;AACvB,eAAO,MAAM,WAAW,gBAAgB,CAAC;AA0CzC;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAGjE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAMD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,aAAa,CAErE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,IAAI,gBAAgB,CAEnD;AAsCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAgCvE;AAMD,MAAM,MAAM,sBAAsB,GAAG,aAAa,GAAG,gBAAgB,CAAC;AAEtE,qBAAa,kBAAmB,SAAQ,KAAK;aAGzB,IAAI,EAAE,sBAAsB;aAC5B,UAAU,EAAE,MAAM;gBAFlC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,sBAAsB,EAC5B,UAAU,EAAE,MAAM;CAKrC"}
+{"version":3,"file":"project-config.d.ts","sourceRoot":"","sources":["../../src/config/project-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAUH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAExC,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,4BAA4B;IAC5B,IAAI,CAAC,EAAE;QACL,4BAA4B;QAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,0BAA0B;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF,0BAA0B;IAC1B,IAAI,CAAC,EAAE;QACL,2CAA2C;QAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,gCAAgC;QAChC,SAAS,CAAC,EAAE;YACV,sCAAsC;YACtC,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,gDAAgD;YAChD,UAAU,CAAC,EAAE,OAAO,CAAC;YACrB,iEAAiE;YACjE,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,sEAAsE;YACtE,gBAAgB,CAAC,EAAE,OAAO,CAAC;SAC5B,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,qDAAqD;IACrD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAMD,4BAA4B;AAC5B,eAAO,MAAM,UAAU,gBAAgB,CAAC;AAExC,uBAAuB;AACvB,eAAO,MAAM,WAAW,gBAAgB,CAAC;AA0CzC;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAGjE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAG5C;AAMD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,aAAa,CAErE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,IAAI,gBAAgB,CAEnD;AAsCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB,CA0CvE;AAMD,MAAM,MAAM,sBAAsB,GAAG,aAAa,GAAG,gBAAgB,CAAC;AAEtE,qBAAa,kBAAmB,SAAQ,KAAK;aAGzB,IAAI,EAAE,sBAAsB;aAC5B,UAAU,EAAE,MAAM;gBAFlC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,sBAAsB,EAC5B,UAAU,EAAE,MAAM;CAKrC"}

package/dist/config/project-config.js

@@ -60,10 +60,11 @@ export function getProjectConfigPath(projectPath) {
 /**
  * Get the global config file path.
  *
- * @returns Absolute path to ~/.multiagent/config.json
+ * @returns Absolute path to ~/.multiagent/config.json (or MACRO_AGENT_HOME/config.json)
  */
 export function getGlobalConfigPath() {
-    return path.join(os.homedir(), CONFIG_DIR, CONFIG_FILE);
+    const globalDir = process.env.MACRO_AGENT_HOME || path.join(os.homedir(), CONFIG_DIR);
+    return path.join(globalDir, CONFIG_FILE);
 }
 // =============================================================================
 // Individual Loaders
@@ -156,6 +157,15 @@ export function loadMergedConfig(projectPath) {
     if (process.env.MACRO_NO_AUTH === "true") {
         merged.auth = { ...(merged.auth ?? {}), disabled: true };
     }
+    // MACRO_TEAMS: comma-separated template names to auto-start
+    if (process.env.MACRO_TEAMS) {
+        const names = process.env.MACRO_TEAMS.split(",").map(s => s.trim()).filter(Boolean);
+        const teams = { ...(merged.teams ?? {}) };
+        for (const name of names) {
+            teams[name] = { ...teams[name], autoStart: true };
+        }
+        merged.teams = teams;
+    }
     return merged;
 }
 export class ProjectConfigError extends Error {

package/dist/config/project-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"project-config.js","sourceRoot":"","sources":["../../src/config/project-config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"project-config.js","sourceRoot":"","sources":["../../src/config/project-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAwE7B,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,4BAA4B;AAC5B,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAC;AAExC,uBAAuB;AACvB,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;AAEzC,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF;;;;GAIG;AACH,SAAS,cAAc,CAAC,UAAkB;IACxC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAEjD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3E,MAAM,IAAI,kBAAkB,CAC1B,qCAAqC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,MAAM,EAAE,EACtF,gBAAgB,EAChB,UAAU,CACX,CAAC;QACJ,CAAC;QACD,OAAO,MAAiC,CAAC;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,kBAAkB;YAAE,MAAM,KAAK,CAAC;QACrD,MAAM,IAAI,kBAAkB,CAC1B,mBAAmB,UAAU,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAC1F,aAAa,EACb,UAAU,CACX,CAAC;IACJ,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,WAAoB;IACvD,MAAM,IAAI,GAAG,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;IACtF,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AAC3C,CAAC;AAED,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAoB;IACpD,OAAO,cAAc,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAkB,CAAC;AAC5E,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,cAAc,CAAC,mBAAmB,EAAE,CAAqB,CAAC;AACnE,CAAC;AAED,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF;;;GAGG;AACH,SAAS,SAAS,CAAoC,MAAS,EAAE,MAA+B;IAC9F,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;IAE7B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,SAAS,GAAI,MAAkC,CAAC,GAAG,CAAC,CAAC;QAE3D,IACE,SAAS,KAAK,SAAS;YACvB,SAAS,KAAK,IAAI;YAClB,OAAO,SAAS,KAAK,QAAQ;YAC7B,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;YACzB,OAAO,SAAS,KAAK,QAAQ;YAC7B,SAAS,KAAK,IAAI;YAClB,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EACzB,CAAC;YACA,MAAkC,CAAC,GAAG,CAAC,GAAG,SAAS,CAClD,SAAoC,EACpC,SAAoC,CACrC,CAAC;QACJ,CAAC;aAAM,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAClC,MAAkC,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;QACvD,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAAoB;IACnD,MAAM,YAAY,GAAG,gBAAgB,EAAE,CAAC;IACxC,MAAM,aAAa,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAErD,oCAAoC;IACpC,oCAAoC;IACpC,MAAM,MAAM,GAAqB,SAAS,CACxC,YAAuC,EACvC,aAAwC,CACrB,CAAC;IAEtB,4DAA4D;IAC5D,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC;IACpF,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,CAAC;QACtC,MAAM,CAAC,IAAI,GAAG;YACZ,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACtB,SAAS,EAAE;gBACT,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,IAAI,EAAE,CAAC;gBACjC,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB;aAC/C;SACF,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,CAAC;IACpF,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,MAAM,EAAE,CAAC;QACzC,MAAM,CAAC,IAAI,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC3D,CAAC;IAED,4DAA4D;IAC5D,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACpF,MAAM,KAAK,GAAoC,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;QAC3E,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QACpD,CAAC;QACD,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAQD,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAGzB;IACA;IAHlB,YACE,OAAe,EACC,IAA4B,EAC5B,UAAkB;QAElC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAwB;QAC5B,eAAU,GAAV,UAAU,CAAQ;QAGlC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF"}

package/dist/control/control-client.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Control Socket Client
+ *
+ * Connects to the main process control socket from MCP subprocesses.
+ * Provides typed methods for lifecycle operations (spawn, terminate, etc.)
+ * Supports auto-reconnect with exponential backoff on socket close.
+ *
+ * @module control/control-client
+ */
+export interface ControlClientOptions {
+    timeout?: number;
+    reconnect?: boolean;
+    maxRetries?: number;
+    onReconnected?: () => void;
+}
+export declare class ControlClient {
+    private socket;
+    private buffer;
+    private pending;
+    private seq;
+    private _connected;
+    private _reconnecting;
+    private _permanentlyDisconnected;
+    private readonly socketPath;
+    private readonly timeout;
+    private readonly reconnectEnabled;
+    private readonly maxRetries;
+    private readonly onReconnected?;
+    private reconnectTimer;
+    constructor(socketPath: string, options?: ControlClientOptions | number);
+    get connected(): boolean;
+    get reconnecting(): boolean;
+    connect(): Promise<void>;
+    private connectInternal;
+    private startReconnect;
+    private attemptReconnect;
+    disconnect(): void;
+    spawn(options: {
+        task: string;
+        parent?: string | null;
+        role?: string;
+        cwd?: string;
+        team_instance?: string;
+        customPrompt?: string;
+    }): Promise<{
+        agent_id: string;
+        name?: string;
+        session_id: string;
+        task_id?: string;
+        role?: string;
+    }>;
+    terminate(agentId: string, reason: string): Promise<void>;
+    getAgent(agentId: string): Promise<unknown>;
+    listAgents(filter?: Record<string, unknown>): Promise<unknown[]>;
+    getChildren(agentId: string): Promise<unknown[]>;
+    getHierarchy(agentId: string, depth?: number): Promise<unknown>;
+    ping(): Promise<boolean>;
+    healthCheck(agentId: string, mcpPid: number): Promise<boolean>;
+    private send;
+    private sendRaw;
+    private processBuffer;
+}
+//# sourceMappingURL=control-client.d.ts.map

package/dist/control/control-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-client.d.ts","sourceRoot":"","sources":["../../src/control/control-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;CAC5B;AAMD,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,OAAO,CAGD;IACd,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,wBAAwB,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAU;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAa;IAC5C,OAAO,CAAC,cAAc,CAA8C;gBAExD,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM;IAevE,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,YAAY,IAAI,OAAO,CAE1B;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B,OAAO,CAAC,eAAe;IAqDvB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,gBAAgB;IAsCxB,UAAU,IAAI,IAAI;IAqBZ,KAAK,CAAC,OAAO,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC;QACV,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IAKI,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK3C,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAKhE,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAKhD,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,CAAC;IASb,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IASxB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YAWtD,IAAI;IAclB,OAAO,CAAC,OAAO;IA+Bf,OAAO,CAAC,aAAa;CA4BtB"}