macro-agent 0.2.5 → 0.2.6

package/dist/peer/task-delegation.d.ts

@@ -0,0 +1,189 @@
+/**
+ * TaskDelegation - Task delegation pattern for distributed hierarchy
+ *
+ * Simplest relationship pattern - one macro-agent delegates discrete tasks
+ * to another without establishing a persistent hierarchy.
+ *
+ * Features:
+ * - Loose coupling (no persistent state beyond active tasks)
+ * - Response modes: final-only or progress-updates
+ * - Idempotent task IDs for safe retries
+ */
+import type { PeerAddress } from "./types.js";
+import type { PatternHandler, HierarchyResponse } from "./hierarchy-protocol.js";
+import type { CapabilityManager } from "./capability-manager.js";
+/**
+ * Response mode for task delegation
+ */
+export type TaskResponseMode = "final-only" | "progress-updates";
+/**
+ * Task delegation request parameters
+ */
+export interface TaskDelegationParams {
+    /** Caller-provided task ID for idempotency */
+    taskId: string;
+    /** Description of what to do */
+    description: string;
+    /** Additional context for the task */
+    context?: Record<string, unknown>;
+    /** Response mode */
+    responseMode: TaskResponseMode;
+    /** Timeout in ms (optional) */
+    timeout?: number;
+}
+/**
+ * Task delegation result (immediate acknowledgment)
+ */
+export interface TaskDelegationResult {
+    /** Whether the task was accepted */
+    accepted: boolean;
+    /** Reason if not accepted */
+    reason?: string;
+}
+/**
+ * Task progress status
+ */
+export type TaskProgressStatus = "in_progress" | "checkpoint";
+/**
+ * Task progress update payload
+ */
+export interface TaskProgressPayload {
+    /** Task ID */
+    taskId: string;
+    /** Progress status */
+    status: TaskProgressStatus;
+    /** Optional message */
+    message?: string;
+    /** Progress percentage (0-100) */
+    progress?: number;
+    /** Checkpoint data for resumption */
+    checkpoint?: unknown;
+}
+/**
+ * Task completion status
+ */
+export type TaskCompletionStatus = "completed" | "failed";
+/**
+ * Task completion payload
+ */
+export interface TaskCompletePayload {
+    /** Task ID */
+    taskId: string;
+    /** Completion status */
+    status: TaskCompletionStatus;
+    /** Result if completed successfully */
+    result?: unknown;
+    /** Error if failed */
+    error?: {
+        code: number;
+        message: string;
+    };
+}
+/**
+ * Internal task state
+ */
+export interface DelegatedTask {
+    /** Task ID */
+    taskId: string;
+    /** Peer that delegated the task */
+    fromPeerId: string;
+    /** Task description */
+    description: string;
+    /** Task context */
+    context?: Record<string, unknown>;
+    /** Response mode */
+    responseMode: TaskResponseMode;
+    /** When the task was received */
+    receivedAt: number;
+    /** Timeout timestamp (if set) */
+    timeoutAt?: number;
+    /** Current status */
+    status: "pending" | "in_progress" | "completed" | "failed";
+}
+/**
+ * Outbound task state (for tracking delegated tasks)
+ */
+export interface OutboundTask {
+    /** Task ID */
+    taskId: string;
+    /** Target peer ID */
+    toPeerId: string;
+    /** Response mode */
+    responseMode: TaskResponseMode;
+    /** When the task was sent */
+    sentAt: number;
+    /** Timeout timestamp */
+    timeoutAt?: number;
+    /** Progress callback (if progress-updates mode) */
+    onProgress?: (progress: TaskProgressPayload) => void;
+    /** Completion callback */
+    onComplete: (result: TaskCompletePayload) => void;
+    /** Timeout handle */
+    timeoutHandle?: ReturnType<typeof setTimeout>;
+}
+/**
+ * Callback for handling delegated tasks
+ */
+export type TaskDelegationCallback = (task: DelegatedTask) => Promise<{
+    accepted: boolean;
+    reason?: string;
+}>;
+export interface TaskDelegationManagerConfig {
+    /** Capability manager for permission checks */
+    capabilityManager?: CapabilityManager;
+    /** Default timeout for tasks in ms */
+    defaultTimeout?: number;
+    /** Maximum concurrent inbound tasks (optional) */
+    maxConcurrentTasks?: number;
+    /** Callback when a task is delegated to us */
+    onTaskReceived?: TaskDelegationCallback;
+}
+export interface TaskDelegationManager {
+    /**
+     * Get the pattern handler for routing
+     */
+    getHandler(): PatternHandler;
+    /**
+     * Delegate a task to a peer
+     */
+    delegateTask(toPeerId: string, params: TaskDelegationParams, callbacks: {
+        onProgress?: (progress: TaskProgressPayload) => void;
+        onComplete: (result: TaskCompletePayload) => void;
+    }): Promise<TaskDelegationResult>;
+    /**
+     * Report progress on a task (as the delegatee)
+     */
+    reportProgress(taskId: string, progress: Omit<TaskProgressPayload, "taskId">): void;
+    /**
+     * Complete a task (as the delegatee)
+     */
+    completeTask(taskId: string, result: Omit<TaskCompletePayload, "taskId">): void;
+    /**
+     * Get a delegated task by ID
+     */
+    getTask(taskId: string): DelegatedTask | undefined;
+    /**
+     * List all active inbound tasks
+     */
+    listInboundTasks(): DelegatedTask[];
+    /**
+     * List all active outbound tasks
+     */
+    listOutboundTasks(): OutboundTask[];
+    /**
+     * Set the send functions (injected by PeerManager)
+     */
+    setSendFunctions(fns: {
+        sendRequest: (to: PeerAddress, method: string, params: unknown) => Promise<HierarchyResponse>;
+        sendMessage: (to: PeerAddress, type: string, payload: unknown) => Promise<void>;
+    }): void;
+}
+/**
+ * Create a TaskDelegationManager
+ */
+export declare function createTaskDelegationManager(config?: TaskDelegationManagerConfig): TaskDelegationManager;
+/**
+ * Generate a unique task ID
+ */
+export declare function generateTaskId(): string;
+//# sourceMappingURL=task-delegation.d.ts.map

package/dist/peer/task-delegation.d.ts.map

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

package/dist/peer/task-delegation.js

@@ -0,0 +1,303 @@
+/**
+ * TaskDelegation - Task delegation pattern for distributed hierarchy
+ *
+ * Simplest relationship pattern - one macro-agent delegates discrete tasks
+ * to another without establishing a persistent hierarchy.
+ *
+ * Features:
+ * - Loose coupling (no persistent state beyond active tasks)
+ * - Response modes: final-only or progress-updates
+ * - Idempotent task IDs for safe retries
+ */
+import { nanoid } from "nanoid";
+import { capabilityDenied, taskRejected, } from "./hierarchy-errors.js";
+/**
+ * Create a TaskDelegationManager
+ */
+export function createTaskDelegationManager(config = {}) {
+    const { capabilityManager, defaultTimeout = 300000, // 5 minutes default
+    maxConcurrentTasks, onTaskReceived, } = config;
+    // Inbound tasks (tasks delegated TO us)
+    const inboundTasks = new Map();
+    // Outbound tasks (tasks we delegated)
+    const outboundTasks = new Map();
+    // Send functions (injected by PeerManager)
+    let sendRequest = null;
+    let sendMessage = null;
+    /**
+     * Set send functions
+     */
+    function setSendFunctions(fns) {
+        sendRequest = fns.sendRequest;
+        sendMessage = fns.sendMessage;
+    }
+    /**
+     * Check if peer has task-delegation capability
+     */
+    function checkCapability(peerId) {
+        if (!capabilityManager) {
+            return true; // No capability manager = no restrictions
+        }
+        return capabilityManager.hasCapability(peerId, { type: "task-delegation" });
+    }
+    /**
+     * Handle incoming task/delegate request
+     */
+    async function handleDelegateRequest(from, params) {
+        const peerId = extractPeerId(from);
+        // Check capability
+        if (!checkCapability(peerId)) {
+            return {
+                error: capabilityDenied("task-delegation", peerId).toResponseError(),
+            };
+        }
+        // Validate params
+        const taskParams = params;
+        if (!taskParams.taskId || !taskParams.description) {
+            return {
+                error: {
+                    code: 4005,
+                    message: "INVALID_REQUEST",
+                    data: { reason: "taskId and description are required" },
+                },
+            };
+        }
+        // Check for duplicate (idempotency)
+        const existing = inboundTasks.get(taskParams.taskId);
+        if (existing) {
+            // Return success for idempotent retry
+            return {
+                result: { accepted: true, taskId: taskParams.taskId },
+            };
+        }
+        // Check concurrent task limit
+        if (maxConcurrentTasks !== undefined) {
+            const activeTasks = Array.from(inboundTasks.values()).filter((t) => t.status === "pending" || t.status === "in_progress");
+            if (activeTasks.length >= maxConcurrentTasks) {
+                return {
+                    error: taskRejected(taskParams.taskId, "Maximum concurrent tasks reached").toResponseError(),
+                };
+            }
+        }
+        // Create task
+        const task = {
+            taskId: taskParams.taskId,
+            fromPeerId: peerId,
+            description: taskParams.description,
+            context: taskParams.context,
+            responseMode: taskParams.responseMode || "final-only",
+            receivedAt: Date.now(),
+            timeoutAt: taskParams.timeout ? Date.now() + taskParams.timeout : undefined,
+            status: "pending",
+        };
+        // Store task
+        inboundTasks.set(task.taskId, task);
+        // Notify callback if provided
+        if (onTaskReceived) {
+            try {
+                const result = await onTaskReceived(task);
+                if (!result.accepted) {
+                    inboundTasks.delete(task.taskId);
+                    return {
+                        error: taskRejected(task.taskId, result.reason).toResponseError(),
+                    };
+                }
+            }
+            catch (err) {
+                inboundTasks.delete(task.taskId);
+                return {
+                    error: taskRejected(task.taskId, err instanceof Error ? err.message : "Task rejected").toResponseError(),
+                };
+            }
+        }
+        return {
+            result: { accepted: true, taskId: task.taskId },
+        };
+    }
+    /**
+     * Handle incoming task/progress message
+     */
+    function handleProgressMessage(from, payload) {
+        const progress = payload;
+        const outbound = outboundTasks.get(progress.taskId);
+        if (outbound && outbound.onProgress) {
+            outbound.onProgress(progress);
+        }
+    }
+    /**
+     * Handle incoming task/complete message
+     */
+    function handleCompleteMessage(from, payload) {
+        const complete = payload;
+        const outbound = outboundTasks.get(complete.taskId);
+        if (outbound) {
+            // Clear timeout
+            if (outbound.timeoutHandle) {
+                clearTimeout(outbound.timeoutHandle);
+            }
+            // Remove from tracking
+            outboundTasks.delete(complete.taskId);
+            // Notify callback
+            outbound.onComplete(complete);
+        }
+    }
+    /**
+     * Delegate a task to a peer
+     */
+    async function delegateTask(toPeerId, params, callbacks) {
+        if (!sendRequest) {
+            throw new Error("TaskDelegationManager not connected to PeerManager");
+        }
+        // Send delegation request
+        const response = await sendRequest(toPeerId, "task/delegate", params);
+        if (response.error) {
+            return { accepted: false, reason: response.error.message };
+        }
+        const result = response.result;
+        if (result.accepted) {
+            // Track the outbound task
+            const timeout = params.timeout || defaultTimeout;
+            const outbound = {
+                taskId: params.taskId,
+                toPeerId,
+                responseMode: params.responseMode,
+                sentAt: Date.now(),
+                timeoutAt: Date.now() + timeout,
+                onProgress: callbacks.onProgress,
+                onComplete: callbacks.onComplete,
+            };
+            // Set up timeout
+            outbound.timeoutHandle = setTimeout(() => {
+                outboundTasks.delete(params.taskId);
+                callbacks.onComplete({
+                    taskId: params.taskId,
+                    status: "failed",
+                    error: { code: 4004, message: "TASK_TIMEOUT" },
+                });
+            }, timeout);
+            outboundTasks.set(params.taskId, outbound);
+        }
+        return result;
+    }
+    /**
+     * Report progress on a task
+     */
+    function reportProgress(taskId, progress) {
+        const task = inboundTasks.get(taskId);
+        if (!task) {
+            return;
+        }
+        // Only send progress if responseMode is progress-updates
+        if (task.responseMode !== "progress-updates") {
+            return;
+        }
+        // Update task status
+        task.status = "in_progress";
+        // Send progress message
+        if (sendMessage) {
+            sendMessage(task.fromPeerId, "task/progress", {
+                taskId,
+                ...progress,
+            });
+        }
+    }
+    /**
+     * Complete a task
+     */
+    function completeTask(taskId, result) {
+        const task = inboundTasks.get(taskId);
+        if (!task) {
+            return;
+        }
+        // Update task status
+        task.status = result.status === "completed" ? "completed" : "failed";
+        // Send completion message
+        if (sendMessage) {
+            sendMessage(task.fromPeerId, "task/complete", {
+                taskId,
+                ...result,
+            });
+        }
+        // Remove from tracking after a delay (for idempotency)
+        setTimeout(() => {
+            inboundTasks.delete(taskId);
+        }, 60000); // Keep for 1 minute for retries
+    }
+    /**
+     * Get a delegated task by ID
+     */
+    function getTask(taskId) {
+        return inboundTasks.get(taskId);
+    }
+    /**
+     * List all active inbound tasks
+     */
+    function listInboundTasks() {
+        return Array.from(inboundTasks.values());
+    }
+    /**
+     * List all active outbound tasks
+     */
+    function listOutboundTasks() {
+        return Array.from(outboundTasks.values());
+    }
+    /**
+     * Pattern handler for routing
+     */
+    const handler = {
+        async handleRequest(from, method, params) {
+            switch (method) {
+                case "task/delegate":
+                    return handleDelegateRequest(from, params);
+                default:
+                    return {
+                        error: {
+                            code: 4005,
+                            message: "INVALID_REQUEST",
+                            data: { method, reason: "Unknown task method" },
+                        },
+                    };
+            }
+        },
+        handleMessage(from, type, payload) {
+            switch (type) {
+                case "task/progress":
+                    handleProgressMessage(from, payload);
+                    break;
+                case "task/complete":
+                    handleCompleteMessage(from, payload);
+                    break;
+            }
+        },
+    };
+    function getHandler() {
+        return handler;
+    }
+    return {
+        getHandler,
+        delegateTask,
+        reportProgress,
+        completeTask,
+        getTask,
+        listInboundTasks,
+        listOutboundTasks,
+        setSendFunctions,
+    };
+}
+// ─────────────────────────────────────────────────────────────────
+// Utility Functions
+// ─────────────────────────────────────────────────────────────────
+/**
+ * Extract peer ID from address
+ */
+function extractPeerId(address) {
+    const slashIndex = address.indexOf("/");
+    return slashIndex === -1 ? address : address.substring(0, slashIndex);
+}
+/**
+ * Generate a unique task ID
+ */
+export function generateTaskId() {
+    return `task_${nanoid(12)}`;
+}
+//# sourceMappingURL=task-delegation.js.map

package/dist/peer/task-delegation.js.map

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

package/dist/peer/transports/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Peer transport implementations
+ *
+ * Example transports for peer-to-peer communication between macro-agents.
+ */
+export { LocalPeerTransport, createLocalTransport, type LocalTransportConfig, } from "./local-transport.js";
+export { WebSocketPeerTransport, createWebSocketTransport, type WebSocketTransportConfig, type PeerRegistryEntry, } from "./websocket-transport.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/peer/transports/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/peer/transports/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,GACvB,MAAM,0BAA0B,CAAC"}

package/dist/peer/transports/index.js

@@ -0,0 +1,8 @@
+/**
+ * Peer transport implementations
+ *
+ * Example transports for peer-to-peer communication between macro-agents.
+ */
+export { LocalPeerTransport, createLocalTransport, } from "./local-transport.js";
+export { WebSocketPeerTransport, createWebSocketTransport, } from "./websocket-transport.js";
+//# sourceMappingURL=index.js.map

package/dist/peer/transports/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/peer/transports/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,kBAAkB,EAClB,oBAAoB,GAErB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,sBAAsB,EACtB,wBAAwB,GAGzB,MAAM,0BAA0B,CAAC"}

package/dist/peer/transports/local-transport.d.ts

@@ -0,0 +1,56 @@
+/**
+ * LocalPeerTransport - Unix socket-based transport for same-machine peer communication
+ *
+ * Provides an IPC-based implementation of PeerTransport for macro-agents
+ * running on the same machine but in different processes.
+ *
+ * Each peer creates a Unix socket server at a known path (based on peer ID).
+ * To communicate with a peer, it connects to that peer's socket.
+ */
+import type { PeerTransport, PeerHandler, PeerMessage, PeerRequest, PeerResponse, PeerAddress } from "../types.js";
+export interface LocalTransportConfig {
+    /** This peer's unique ID */
+    peerId: string;
+    /** Directory for socket files (defaults to /tmp/macro-agent-peers) */
+    socketDir?: string;
+    /** Timeout for requests in ms (defaults to 30000) */
+    requestTimeout?: number;
+}
+export declare class LocalPeerTransport implements PeerTransport {
+    private peerId;
+    private socketDir;
+    private requestTimeout;
+    private server;
+    private connections;
+    private pendingRequests;
+    private handler;
+    constructor(config: LocalTransportConfig);
+    /**
+     * Start the transport server and begin listening for connections
+     */
+    start(handler: PeerHandler): Promise<void>;
+    /**
+     * Stop the transport server and close all connections
+     */
+    stop(): Promise<void>;
+    /**
+     * Send a message to a peer (fire-and-forget)
+     */
+    sendMessage(to: PeerAddress, message: PeerMessage): Promise<void>;
+    /**
+     * Send a request to a peer and wait for response
+     */
+    sendRequest(to: PeerAddress, request: PeerRequest): Promise<PeerResponse>;
+    private getSocketPath;
+    private extractPeerId;
+    private getOrCreateConnection;
+    private handleIncomingConnection;
+    private setupSocketHandlers;
+    private handleWireMessage;
+    private writeMessage;
+}
+/**
+ * Create a LocalPeerTransport instance
+ */
+export declare function createLocalTransport(config: LocalTransportConfig): LocalPeerTransport;
+//# sourceMappingURL=local-transport.d.ts.map

package/dist/peer/transports/local-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-transport.d.ts","sourceRoot":"","sources":["../../../src/peer/transports/local-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,EACZ,WAAW,EACZ,MAAM,aAAa,CAAC;AAMrB,MAAM,WAAW,oBAAoB;IACnC,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IAEf,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAkBD,qBAAa,kBAAmB,YAAW,aAAa;IACtD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAS;IAE/B,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,WAAW,CAAsC;IACzD,OAAO,CAAC,eAAe,CAAkD;IACzE,OAAO,CAAC,OAAO,CAA4B;gBAE/B,MAAM,EAAE,oBAAoB;IAMxC;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BhD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB3B;;OAEG;IACG,WAAW,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAcvE;;OAEG;IACG,WAAW,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAoC/E,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,aAAa;YAMP,qBAAqB;IAuBnC,OAAO,CAAC,wBAAwB;IA2ChC,OAAO,CAAC,mBAAmB;IA8B3B,OAAO,CAAC,iBAAiB;IAyCzB,OAAO,CAAC,YAAY;CAIrB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,oBAAoB,GAC3B,kBAAkB,CAEpB"}