macro-agent 0.1.1 → 0.1.3

package/dist/map/types.d.ts

@@ -1,245 +1,181 @@
 /**
- * MAP (Multi-Agent Protocol) Core Types
+ * MAP Sidecar Types
  *
- * This module defines the core addressing and messaging types for MAP integration.
- * These types replace the channel-based addressing in MessageRouter with
- * MAP-native hierarchical addressing.
+ * Configuration, interfaces, and wire format types for the MAP hub sidecar.
+ * The sidecar connects macro-agent to an OpenHive MAP hub for agent observability,
+ * trajectory reporting, task bridging, and cross-swarm coordination.
  *
- * @see specs/s-5qir_map_integration_for_macro_agent.md
- */
-import type { AgentId, TaskId } from "../store/types/index.js";
-/**
- * Scope identifier for MAP scopes (equivalent to topics/channels).
- * Scopes are explicitly created containers for agent communication.
- */
-export type ScopeId = string;
-/**
- * Direct address targeting a single agent.
- */
-export interface AgentAddress {
-    agent: AgentId;
+ * @module map/types
+ */
+import type { AgentManager } from "../agent/agent-manager.js";
+import type { AgentStore } from "../agent/agent-store.js";
+import type { InboxAdapter, TasksAdapter } from "../adapters/types.js";
+export interface MAPSidecarConfig {
+    /** MAP hub WebSocket URL (e.g., "ws://localhost:8080" or "wss://hub.openhive.dev") */
+    server: string;
+    /** Authentication token (appended as ?token= query param) */
+    token?: string;
+    /** MAP scope for broadcasting events (default: "swarm:macro-agent") */
+    scope?: string;
+    /** System ID for federation (default: "macro-agent") */
+    systemId?: string;
+    /** Opaque credential for server-driven auth (verified mode) */
+    credential?: string;
+    /** Agent name for MAP registration (default: "macro-agent-sidecar") */
+    agentName?: string;
+    /** Trajectory sync level */
+    trajectorySyncLevel?: "off" | "lifecycle" | "metrics" | "full";
+    /** Mesh transport (agentic-mesh P2P) */
+    mesh?: {
+        enabled?: boolean;
+        peerId?: string;
+    };
+    /** Reconnection settings (SDK-level) */
+    reconnection?: {
+        enabled?: boolean;
+        maxRetries?: number;
+        baseDelayMs?: number;
+        maxDelayMs?: number;
+    };
+    /** Slow reconnect interval after SDK retries exhausted (ms, default: 60000) */
+    reconnectIntervalMs?: number;
 }
-/**
- * Direct address targeting multiple agents.
- */
-export interface AgentsAddress {
-    agents: AgentId[];
+export interface MAPSidecarDeps {
+    agentManager: AgentManager;
+    agentStore: AgentStore;
+    inboxAdapter: InboxAdapter;
+    tasksAdapter: TasksAdapter;
 }
-/**
- * Scope-based address targeting all members of a scope.
- */
-export interface ScopeAddress {
-    scope: ScopeId;
+export interface MAPSidecar {
+    /** Start the sidecar (connect to hub, subscribe to events) */
+    start(): Promise<void>;
+    /** Stop the sidecar (disconnect, unsubscribe) */
+    stop(): Promise<void>;
+    /** Whether the sidecar is connected to the hub */
+    readonly connected: boolean;
+    /** Report a trajectory checkpoint manually */
+    reportCheckpoint(checkpoint: TrajectoryCheckpointPayload): Promise<TrajectoryCheckpointResult | null>;
 }
 /**
- * Role-based address targeting agents by role.
- * Optionally scoped to a specific scope.
- */
-export interface RoleAddress {
-    role: string;
-    /** Optional scope to limit role resolution */
-    within?: ScopeId;
+ * Trajectory checkpoint payload — matches cc-swarm wire format.
+ * Top-level fields are snake_case per the OpenHive trajectory protocol.
+ */
+export interface TrajectoryCheckpointPayload {
+    /** Checkpoint ID (e.g., "<sessionId>-step<N>") */
+    id: string;
+    /** Session identifier */
+    session_id: string;
+    /** Agent name (e.g., "macro-agent-sidecar") */
+    agent: string;
+    /** Git branch (nullable) */
+    branch: string | null;
+    /** Files touched in this checkpoint period */
+    files_touched: string[];
+    /** Total checkpoint count in session */
+    checkpoints_count: number;
+    /** Token usage metrics (when sync level >= "metrics") */
+    token_usage?: {
+        input_tokens?: number;
+        output_tokens?: number;
+        cache_creation_tokens?: number;
+        cache_read_tokens?: number;
+        api_call_count?: number;
+    };
+    /** Additional metadata */
+    metadata?: {
+        project?: string;
+        projectPath?: string;
+        template?: string;
+        firstPrompt?: string;
+        phase?: string;
+        [key: string]: unknown;
+    };
 }
-/**
- * Address targeting the sender's parent agent.
- */
-export interface ParentAddress {
-    parent: true;
+/** Response from trajectory/checkpoint extension call */
+export interface TrajectoryCheckpointResult {
+    ok: boolean;
+    resource_id?: string;
+    created?: boolean;
+    checkpoint_id?: string;
 }
-/**
- * Address targeting the sender's direct children.
- */
-export interface ChildrenAddress {
-    children: true;
-    /** Max depth (1 = direct children only, default: 1) */
-    depth?: number;
+/** Inbound content request from the hub */
+export interface TrajectoryContentRequest {
+    request_id: string;
+    checkpoint_id: string;
 }
-/**
- * Address targeting the sender's ancestors (parent, grandparent, etc.).
- */
-export interface AncestorsAddress {
-    ancestors: true;
-    /** Max depth (default: Infinity) */
-    depth?: number;
+/** Inbound task assignment from hub */
+export interface CoordinationTaskAssign {
+    title: string;
+    description?: string;
+    assigned_to?: string;
+    assigned_by: string;
+    priority?: string;
+    context?: Record<string, unknown>;
+    deadline?: string;
 }
-/**
- * Address targeting the sender's descendants (children, grandchildren, etc.).
- */
-export interface DescendantsAddress {
-    descendants: true;
-    /** Max depth (default: Infinity) */
-    depth?: number;
+/** Inbound task status update from hub */
+export interface CoordinationTaskStatus {
+    task_id: string;
+    status: string;
+    progress?: number;
+    result?: unknown;
+    error?: string;
 }
-/**
- * Address targeting the sender's siblings (agents with same parent).
- */
-export interface SiblingsAddress {
-    siblings: true;
+/** Inbound context share from hub */
+export interface CoordinationContextShare {
+    hive_id?: string;
+    source_swarm_id: string;
+    context_type: string;
+    data: unknown;
+    target_swarm_ids?: string[];
+    ttl_seconds?: number;
 }
-/**
- * Broadcast address targeting all agents in the system.
- */
-export interface BroadcastAddress {
-    broadcast: true;
+/** Inbound message from hub */
+export interface CoordinationMessage {
+    hive_id?: string;
+    from_swarm_id: string;
+    to_swarm_id: string;
+    content_type: string;
+    content: unknown;
+    reply_to?: string;
+    metadata?: Record<string, unknown>;
 }
-/**
- * Task-based address (macro-agent extension).
- * Routes to the agent assigned to the specified task.
- */
-export interface TaskAddress {
-    task: TaskId;
+/** Task bridge interface for emitting task events to MAP */
+export interface TaskBridge {
+    taskCreated(task: {
+        id: string;
+        title: string;
+        status: string;
+        assignee?: string;
+    }): Promise<void>;
+    taskStatusChanged(taskId: string, previous: string, current: string, agentId?: string): Promise<void>;
+    taskAssigned(taskId: string, assignee: string): Promise<void>;
 }
-/**
- * System identifier for federated systems.
- * Format: `<domain>/<system>/<instance>`
- * Example: `example.com/macro-agent/prod-east`
- */
-export type SystemId = string;
-/**
- * Address targeting an agent in a federated system.
- * Used for cross-system message routing.
- */
-export interface FederatedAgentAddress {
-    /** Target system identifier */
-    system: SystemId;
-    /** Agent ID within the target system */
-    agent: AgentId;
+/** Trajectory reporter interface */
+export interface TrajectoryReporter {
+    reportCheckpoint(checkpoint: TrajectoryCheckpointPayload): Promise<TrajectoryCheckpointResult | null>;
+    stop(): void;
 }
-/**
- * Address targeting a scope in a federated system.
- * Used for cross-system scope-based messaging.
- */
-export interface FederatedScopeAddress {
-    /** Target system identifier */
-    system: SystemId;
-    /** Scope ID within the target system */
-    scope: ScopeId;
+/** Configuration for the MAP server that accepts inbound connections */
+export interface MapServerConfig {
+    /** Port for MAP WebSocket server (default: 3002) */
+    port?: number;
+    /** Host to bind (default: "127.0.0.1") */
+    host?: string;
+    /** WebSocket path (default: "/map") */
+    path?: string;
+    /** Server name for MAP protocol (default: "macro-agent") */
+    name?: string;
 }
-/**
- * Union of all federated address types.
- */
-export type FederatedAddress = FederatedAgentAddress | FederatedScopeAddress;
-/**
- * Union of all hierarchical address types.
- */
-export type HierarchicalAddress = ParentAddress | ChildrenAddress | AncestorsAddress | DescendantsAddress | SiblingsAddress;
-/**
- * MAP Address type for message routing.
- *
- * Addresses specify where messages should be delivered. They replace
- * the channel-based addressing in the legacy MessageRouter.
- *
- * Address types:
- * - Direct: { agent } or { agents } - target specific agent(s)
- * - Structural: { scope } or { role } - target by scope or role
- * - Hierarchical: { parent }, { children }, { ancestors }, { descendants }, { siblings }
- * - Broadcast: { broadcast: true } - all agents
- * - Extension: { task } - macro-agent specific task addressing
- * - Federated: { system, agent } or { system, scope } - cross-system addressing
- */
-export type Address = AgentAddress | AgentsAddress | ScopeAddress | RoleAddress | HierarchicalAddress | BroadcastAddress | TaskAddress | FederatedAddress;
-/**
- * Check if address targets a single agent.
- */
-export declare function isAgentAddress(addr: Address): addr is AgentAddress;
-/**
- * Check if address targets multiple agents.
- */
-export declare function isAgentsAddress(addr: Address): addr is AgentsAddress;
-/**
- * Check if address targets a scope.
- */
-export declare function isScopeAddress(addr: Address): addr is ScopeAddress;
-/**
- * Check if address targets by role.
- */
-export declare function isRoleAddress(addr: Address): addr is RoleAddress;
-/**
- * Check if address targets parent.
- */
-export declare function isParentAddress(addr: Address): addr is ParentAddress;
-/**
- * Check if address targets children.
- */
-export declare function isChildrenAddress(addr: Address): addr is ChildrenAddress;
-/**
- * Check if address targets ancestors.
- */
-export declare function isAncestorsAddress(addr: Address): addr is AncestorsAddress;
-/**
- * Check if address targets descendants.
- */
-export declare function isDescendantsAddress(addr: Address): addr is DescendantsAddress;
-/**
- * Check if address targets siblings.
- */
-export declare function isSiblingsAddress(addr: Address): addr is SiblingsAddress;
-/**
- * Check if address is hierarchical (relative to sender).
- */
-export declare function isHierarchicalAddress(addr: Address): addr is HierarchicalAddress;
-/**
- * Check if address is a broadcast.
- */
-export declare function isBroadcastAddress(addr: Address): addr is BroadcastAddress;
-/**
- * Check if address targets a task (macro-agent extension).
- */
-export declare function isTaskAddress(addr: Address): addr is TaskAddress;
-/**
- * Check if address is a direct address (agent or agents).
- */
-export declare function isDirectAddress(addr: Address): addr is AgentAddress | AgentsAddress;
-/**
- * Check if address is structural (scope or role).
- */
-export declare function isStructuralAddress(addr: Address): addr is ScopeAddress | RoleAddress;
-/**
- * Check if address targets an agent in a federated system.
- */
-export declare function isFederatedAgentAddress(addr: Address): addr is FederatedAgentAddress;
-/**
- * Check if address targets a scope in a federated system.
- */
-export declare function isFederatedScopeAddress(addr: Address): addr is FederatedScopeAddress;
-/**
- * Check if address is a federated address (cross-system).
- */
-export declare function isFederatedAddress(addr: Address): addr is FederatedAddress;
-/**
- * Message priority levels.
- * Higher priority messages may wake sleeping agents.
- * Re-exported from router/types.ts to maintain single source of truth.
- */
-import type { MessagePriority } from "../router/types.js";
-export type { MessagePriority };
-/**
- * Delivery hint for message routing.
- *
- * - queue: Add to recipient's message queue (default)
- * - inject: Attempt to inject into active session
- * - interrupt: Interrupt current activity to deliver
- */
-export type DeliveryHint = "queue" | "inject" | "interrupt";
-/**
- * Options for sending messages.
- */
-export interface SendOptions {
-    /** Message priority (default: 'normal') */
-    priority?: MessagePriority;
-    /** Delivery hint for the router (default: 'queue') */
-    delivery?: DeliveryHint;
-    /** Correlation ID for request/response tracking */
-    correlationId?: string;
-    /** Optional timeout in milliseconds */
-    timeoutMs?: number;
+/** MAP server instance for accepting inbound MAP connections */
+export interface MAPServerInstance {
+    /** Start the server */
+    start(): Promise<void>;
+    /** Stop the server */
+    stop(): Promise<void>;
+    /** Get the WebSocket URL */
+    getUrl(): string;
+    /** Get number of active connections */
+    getConnectionCount(): number;
 }
-/**
- * Get a human-readable description of an address.
- */
-export declare function describeAddress(addr: Address): string;
-/**
- * Normalize an address by applying default values.
- */
-export declare function normalizeAddress<T extends Address>(addr: T): T;
 //# sourceMappingURL=types.d.ts.map

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

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

package/dist/map/types.js

@@ -1,170 +1,11 @@
 /**
- * MAP (Multi-Agent Protocol) Core Types
+ * MAP Sidecar Types
  *
- * This module defines the core addressing and messaging types for MAP integration.
- * These types replace the channel-based addressing in MessageRouter with
- * MAP-native hierarchical addressing.
+ * Configuration, interfaces, and wire format types for the MAP hub sidecar.
+ * The sidecar connects macro-agent to an OpenHive MAP hub for agent observability,
+ * trajectory reporting, task bridging, and cross-swarm coordination.
  *
- * @see specs/s-5qir_map_integration_for_macro_agent.md
+ * @module map/types
  */
-// =============================================================================
-// Type Guards
-// =============================================================================
-/**
- * Check if address targets a single agent.
- */
-export function isAgentAddress(addr) {
-    return "agent" in addr;
-}
-/**
- * Check if address targets multiple agents.
- */
-export function isAgentsAddress(addr) {
-    return "agents" in addr;
-}
-/**
- * Check if address targets a scope.
- */
-export function isScopeAddress(addr) {
-    return "scope" in addr;
-}
-/**
- * Check if address targets by role.
- */
-export function isRoleAddress(addr) {
-    return "role" in addr;
-}
-/**
- * Check if address targets parent.
- */
-export function isParentAddress(addr) {
-    return "parent" in addr;
-}
-/**
- * Check if address targets children.
- */
-export function isChildrenAddress(addr) {
-    return "children" in addr;
-}
-/**
- * Check if address targets ancestors.
- */
-export function isAncestorsAddress(addr) {
-    return "ancestors" in addr;
-}
-/**
- * Check if address targets descendants.
- */
-export function isDescendantsAddress(addr) {
-    return "descendants" in addr;
-}
-/**
- * Check if address targets siblings.
- */
-export function isSiblingsAddress(addr) {
-    return "siblings" in addr;
-}
-/**
- * Check if address is hierarchical (relative to sender).
- */
-export function isHierarchicalAddress(addr) {
-    return (isParentAddress(addr) ||
-        isChildrenAddress(addr) ||
-        isAncestorsAddress(addr) ||
-        isDescendantsAddress(addr) ||
-        isSiblingsAddress(addr));
-}
-/**
- * Check if address is a broadcast.
- */
-export function isBroadcastAddress(addr) {
-    return "broadcast" in addr;
-}
-/**
- * Check if address targets a task (macro-agent extension).
- */
-export function isTaskAddress(addr) {
-    return "task" in addr;
-}
-/**
- * Check if address is a direct address (agent or agents).
- */
-export function isDirectAddress(addr) {
-    return isAgentAddress(addr) || isAgentsAddress(addr);
-}
-/**
- * Check if address is structural (scope or role).
- */
-export function isStructuralAddress(addr) {
-    return isScopeAddress(addr) || isRoleAddress(addr);
-}
-/**
- * Check if address targets an agent in a federated system.
- */
-export function isFederatedAgentAddress(addr) {
-    return "system" in addr && "agent" in addr;
-}
-/**
- * Check if address targets a scope in a federated system.
- */
-export function isFederatedScopeAddress(addr) {
-    return "system" in addr && "scope" in addr;
-}
-/**
- * Check if address is a federated address (cross-system).
- */
-export function isFederatedAddress(addr) {
-    return "system" in addr;
-}
-// =============================================================================
-// Utility Functions
-// =============================================================================
-/**
- * Get a human-readable description of an address.
- */
-export function describeAddress(addr) {
-    // Check federated addresses first (they have 'system' + another field)
-    if (isFederatedAgentAddress(addr))
-        return `federated:${addr.system}/agent:${addr.agent}`;
-    if (isFederatedScopeAddress(addr))
-        return `federated:${addr.system}/scope:${addr.scope}`;
-    if (isAgentAddress(addr))
-        return `agent:${addr.agent}`;
-    if (isAgentsAddress(addr))
-        return `agents:[${addr.agents.join(", ")}]`;
-    if (isScopeAddress(addr))
-        return `scope:${addr.scope}`;
-    if (isRoleAddress(addr))
-        return addr.within ? `role:${addr.role}@${addr.within}` : `role:${addr.role}`;
-    if (isParentAddress(addr))
-        return "parent";
-    if (isChildrenAddress(addr))
-        return addr.depth ? `children(depth=${addr.depth})` : "children";
-    if (isAncestorsAddress(addr))
-        return addr.depth ? `ancestors(depth=${addr.depth})` : "ancestors";
-    if (isDescendantsAddress(addr))
-        return addr.depth ? `descendants(depth=${addr.depth})` : "descendants";
-    if (isSiblingsAddress(addr))
-        return "siblings";
-    if (isBroadcastAddress(addr))
-        return "broadcast";
-    if (isTaskAddress(addr))
-        return `task:${addr.task}`;
-    return "unknown";
-}
-/**
- * Normalize an address by applying default values.
- */
-export function normalizeAddress(addr) {
-    if (isChildrenAddress(addr) && addr.depth === undefined) {
-        return { ...addr, depth: 1 };
-    }
-    if (isDescendantsAddress(addr) && addr.depth === undefined) {
-        return { ...addr, depth: Infinity };
-    }
-    if (isAncestorsAddress(addr) && addr.depth === undefined) {
-        return { ...addr, depth: Infinity };
-    }
-    return addr;
-}
+export {};
 //# sourceMappingURL=types.js.map

package/dist/map/types.js.map

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

package/dist/mcp/index.d.ts

@@ -1,6 +1,6 @@
 /**
- * MCP module exports
+ * MCP module exports (V2)
  */
 export * from "./types.js";
-export * from "./mcp-server.js";
+export * from "./mcp-server-v2.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC"}

package/dist/mcp/index.js

@@ -1,6 +1,6 @@
 /**
- * MCP module exports
+ * MCP module exports (V2)
  */
 export * from "./types.js";
-export * from "./mcp-server.js";
+export * from "./mcp-server-v2.js";
 //# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC"}