macro-agent 0.2.4 → 0.2.6

package/dist/map/adapter/interface.d.ts

@@ -0,0 +1,450 @@
+/**
+ * MAPAdapter Interface
+ *
+ * Defines the interface for the MAP adapter layer that handles external
+ * client connections to macro-agent via the Multi-Agent Protocol.
+ *
+ * The adapter sits at the external boundary, handling:
+ * - JSON-RPC protocol (via BaseConnection from MAP SDK)
+ * - Connection/participant lifecycle
+ * - External subscription management
+ * - Extension method dispatch (`_macro/*` methods)
+ * - Event streaming to subscribers
+ * - Auth/permission checks
+ *
+ * Does NOT own:
+ * - Address resolution (delegates to MessageRouter)
+ * - Wake/delivery decisions (delegates to MessageRouter)
+ * - Agent process lifecycle (delegates to AgentManager)
+ * - Internal agent-to-agent routing
+ *
+ * @see specs/s-5qir_map_integration_for_macro_agent.md
+ */
+import type { ParticipantId, ParticipantType, ParticipantCapabilities, ConnectedParticipant, SubscriptionId, SubscriptionFilter, EventNotification, AuthCredentials, AuthResult, MAPEventType } from "./types.js";
+import type { Address, SendOptions, ScopeId } from "../types.js";
+import type { AgentId } from "../../store/types/index.js";
+/**
+ * Bidirectional stream for MAP connections.
+ * Compatible with MAP SDK's Stream type.
+ */
+export interface Stream {
+    readable: ReadableStream<unknown>;
+    writable: WritableStream<unknown>;
+}
+/**
+ * Context provided to extension handlers.
+ */
+export interface ExtensionContext {
+    /** The participant making the request */
+    participantId: ParticipantId;
+    /** Participant's capabilities */
+    capabilities: ParticipantCapabilities;
+    /** Session ID for the connection */
+    sessionId: string;
+}
+/**
+ * Handler function for extension methods.
+ * Extension methods use the pattern: `_macro/<namespace>/<method>`
+ *
+ * @param context - Request context including participant info
+ * @param params - Method parameters
+ * @returns Method result
+ */
+export type ExtensionHandler = (context: ExtensionContext, params: unknown) => Promise<unknown>;
+/**
+ * Agent exposure configuration.
+ * Controls which agents are visible to external participants.
+ */
+export interface AgentExposure {
+    /** Whether agents are public by default (default: true) */
+    publicByDefault?: boolean;
+    /** Glob patterns for agents that are always public */
+    publicAgents?: string[];
+    /** Glob patterns for agents that are always hidden (takes precedence) */
+    hiddenAgents?: string[];
+}
+/**
+ * Scope exposure configuration.
+ * Controls which scopes are visible to external participants.
+ */
+export interface ScopeExposure {
+    /** Whether scopes are public by default (default: true) */
+    publicByDefault?: boolean;
+    /** Glob patterns for scopes that are always public */
+    publicScopes?: string[];
+    /** Glob patterns for scopes that are always hidden (takes precedence) */
+    hiddenScopes?: string[];
+}
+/**
+ * Event exposure configuration.
+ * Controls which event types are visible to external participants.
+ */
+export interface EventExposure {
+    /** Event types that are exposed (whitelist - if provided, only these are visible) */
+    exposedTypes?: MAPEventType[];
+    /** Event types that are always hidden (blacklist - takes precedence) */
+    hiddenTypes?: MAPEventType[];
+}
+/**
+ * System-level exposure configuration.
+ * This is Layer 1 of the MAP permission model.
+ */
+export interface SystemExposure {
+    /** Agent visibility configuration */
+    agents?: AgentExposure;
+    /** Scope visibility configuration */
+    scopes?: ScopeExposure;
+    /** Event visibility configuration */
+    events?: EventExposure;
+}
+/**
+ * Resource limits for the adapter.
+ * Enforces capacity constraints to prevent resource exhaustion.
+ */
+export interface AdapterLimits {
+    /** Maximum total concurrent connections */
+    maxConnections?: number;
+    /** Maximum connections per unique client identity */
+    maxConnectionsPerClient?: number;
+    /** Maximum subscriptions per connection */
+    maxSubscriptionsPerConnection?: number;
+    /** Maximum message size in bytes */
+    maxMessageSize?: number;
+    /** Request timeout in milliseconds */
+    requestTimeoutMs?: number;
+    /** Maximum events stored in replay buffer (default: 10000) */
+    maxReplayBufferSize?: number;
+}
+/**
+ * Authentication handler function type.
+ */
+export type AuthenticateHandler = (participantType: ParticipantType, credentials: AuthCredentials) => Promise<AuthResult>;
+/**
+ * MAPAdapter configuration.
+ */
+export interface MAPAdapterConfig {
+    /** System name for identification */
+    name?: string;
+    /** System version */
+    version?: string;
+    /** Default capabilities for anonymous/unauthenticated connections */
+    anonymousCapabilities?: ParticipantCapabilities;
+    /** Default capabilities for authenticated clients */
+    defaultClientCapabilities?: ParticipantCapabilities;
+    /** Default capabilities for authenticated agents */
+    defaultAgentCapabilities?: ParticipantCapabilities;
+    /** Authentication handler */
+    authenticate?: AuthenticateHandler;
+    /** System-level exposure configuration (Layer 1 permissions) */
+    exposure?: SystemExposure;
+    /** Resource limits */
+    limits?: AdapterLimits;
+}
+/**
+ * Message payload for sending via MAP.
+ */
+export interface MessagePayload {
+    /** Message content type */
+    type?: string;
+    /** Message content */
+    content: unknown;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Result of sending a message.
+ */
+export interface SendResult {
+    /** Message ID */
+    messageId: string;
+    /** Agents the message was delivered to */
+    delivered: AgentId[];
+    /** Agents where delivery failed */
+    failed?: Array<{
+        agentId: AgentId;
+        reason: string;
+    }>;
+}
+/**
+ * Filter for listing agents.
+ */
+export interface AgentFilter {
+    /** Filter by agent states */
+    states?: string[];
+    /** Filter by roles */
+    roles?: string[];
+    /** Filter by scope membership */
+    scopes?: ScopeId[];
+    /** Filter by parent agent */
+    parent?: AgentId;
+}
+/**
+ * ACP capability advertisement (matches MAP SDK's ACPCapability).
+ */
+export interface ACPCapability {
+    /** ACP protocol version supported (e.g., '2024-10-07') */
+    version?: string;
+    /** ACP features supported by this agent */
+    features?: string[];
+}
+/**
+ * Agent capabilities advertised via MAP (matches MAP SDK's ParticipantCapabilities).
+ */
+export interface AgentCapabilities {
+    /** Protocols supported by this agent (e.g., ["acp"]) */
+    protocols?: string[];
+    /** ACP capability details (present if 'acp' is in protocols array) */
+    acp?: ACPCapability;
+    /** Additional capability flags */
+    [key: string]: unknown;
+}
+/**
+ * Agent info returned by queries.
+ */
+export interface AgentInfo {
+    id: AgentId;
+    name?: string;
+    role?: string;
+    state: string;
+    parent?: AgentId;
+    scopes: ScopeId[];
+    metadata?: Record<string, unknown>;
+    createdAt: number;
+    /** Agent capabilities (protocols, features) */
+    capabilities?: AgentCapabilities;
+}
+/**
+ * Scope info returned by queries.
+ */
+export interface ScopeInfo {
+    id: ScopeId;
+    name?: string;
+    members: AgentId[];
+    createdAt: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Handler for adapter events.
+ */
+export type AdapterEventHandler = (event: AdapterEvent) => void;
+/**
+ * Events emitted by the adapter.
+ */
+export type AdapterEvent = {
+    type: "participant.connected";
+    participant: ConnectedParticipant;
+} | {
+    type: "participant.disconnected";
+    participantId: ParticipantId;
+    reason?: string;
+} | {
+    type: "subscription.created";
+    subscriptionId: SubscriptionId;
+} | {
+    type: "subscription.removed";
+    subscriptionId: SubscriptionId;
+} | {
+    type: "error";
+    error: Error;
+    context?: string;
+};
+/**
+ * MAPAdapter interface.
+ *
+ * The adapter is the external-facing component that:
+ * - Accepts MAP protocol connections from clients, agents, and gateways
+ * - Manages participant lifecycle and authentication
+ * - Handles subscriptions and event streaming
+ * - Dispatches extension method calls
+ * - Enforces system-level permissions (Layer 1)
+ *
+ * The adapter delegates to internal components:
+ * - MessageRouter: For message routing and delivery
+ * - AgentManager: For agent lifecycle operations
+ * - EventStore: For event persistence and replay
+ */
+export interface MAPAdapter {
+    /** Adapter configuration */
+    readonly config: MAPAdapterConfig;
+    /**
+     * Accept a new connection from a stream.
+     *
+     * Performs the MAP connection handshake:
+     * 1. Receive `map/connect` request
+     * 2. Authenticate credentials (if provided)
+     * 3. Assign capabilities based on auth result
+     * 4. Return connection info
+     *
+     * @param stream - Bidirectional stream for the connection
+     * @returns Connected participant info
+     * @throws If authentication fails or limits exceeded
+     */
+    acceptConnection(stream: Stream): Promise<ConnectedParticipant>;
+    /**
+     * Disconnect a participant.
+     *
+     * Cleans up:
+     * - Active subscriptions
+     * - Pending requests
+     * - Connection resources
+     *
+     * Emits `participant.disconnected` event.
+     *
+     * @param id - Participant to disconnect
+     * @param reason - Optional disconnect reason
+     */
+    disconnectParticipant(id: ParticipantId, reason?: string): Promise<void>;
+    /**
+     * Get all connected participants.
+     */
+    getParticipants(): ConnectedParticipant[];
+    /**
+     * Get a specific participant by ID.
+     */
+    getParticipant(id: ParticipantId): ConnectedParticipant | undefined;
+    /**
+     * Send a message to the specified address.
+     *
+     * Performs permission checks, resolves the address, and routes
+     * the message through the internal MessageRouter.
+     *
+     * @param participantId - Sending participant
+     * @param to - Target address
+     * @param payload - Message payload
+     * @param options - Send options (priority, delivery hint)
+     * @returns Send result with delivery status
+     * @throws If participant lacks messaging capability
+     */
+    sendMessage(participantId: ParticipantId, to: Address, payload: MessagePayload, options?: SendOptions): Promise<SendResult>;
+    /**
+     * Create a subscription for a participant.
+     *
+     * The subscription will receive events matching the filter,
+     * subject to the participant's visibility permissions.
+     *
+     * @param participantId - Subscribing participant
+     * @param filter - Event filter criteria
+     * @returns Subscription ID for management
+     * @throws If participant lacks subscribe capability or limits exceeded
+     */
+    createSubscription(participantId: ParticipantId, filter?: SubscriptionFilter): Promise<SubscriptionId>;
+    /**
+     * Remove a subscription.
+     *
+     * @param subscriptionId - Subscription to remove
+     */
+    removeSubscription(subscriptionId: SubscriptionId): Promise<void>;
+    /**
+     * Get all subscription IDs for a participant.
+     */
+    getSubscriptions(participantId: ParticipantId): SubscriptionId[];
+    /**
+     * Pause a subscription (stop receiving events).
+     */
+    pauseSubscription(subscriptionId: SubscriptionId): Promise<void>;
+    /**
+     * Resume a paused subscription.
+     */
+    resumeSubscription(subscriptionId: SubscriptionId): Promise<void>;
+    /**
+     * List agents visible to the participant.
+     *
+     * Results are filtered by:
+     * 1. System exposure rules
+     * 2. Participant capabilities
+     * 3. Optional filter criteria
+     *
+     * @param participantId - Querying participant
+     * @param filter - Optional filter criteria
+     * @returns List of visible agents
+     */
+    listAgents(participantId: ParticipantId, filter?: AgentFilter): AgentInfo[];
+    /**
+     * Get details of a specific agent.
+     *
+     * @param participantId - Querying participant
+     * @param agentId - Agent to query
+     * @returns Agent info or undefined if not visible
+     */
+    getAgent(participantId: ParticipantId, agentId: AgentId): AgentInfo | undefined;
+    /**
+     * List scopes visible to the participant.
+     *
+     * @param participantId - Querying participant
+     * @returns List of visible scopes
+     */
+    listScopes(participantId: ParticipantId): ScopeInfo[];
+    /**
+     * Get details of a specific scope.
+     *
+     * @param participantId - Querying participant
+     * @param scopeId - Scope to query
+     * @returns Scope info or undefined if not visible
+     */
+    getScope(participantId: ParticipantId, scopeId: ScopeId): ScopeInfo | undefined;
+    /**
+     * Emit an event to all matching subscribers.
+     *
+     * The event is filtered per-subscriber based on:
+     * 1. Subscription filter match
+     * 2. System exposure rules
+     * 3. Participant visibility permissions
+     *
+     * @param event - Event to emit
+     */
+    emitEvent(event: EventNotification): void;
+    /**
+     * Register a handler for adapter events.
+     *
+     * @param handler - Event handler function
+     * @returns Unsubscribe function
+     */
+    onEvent(handler: AdapterEventHandler): () => void;
+    /**
+     * Register an extension method handler.
+     *
+     * Extensions use the pattern: `_macro/<namespace>/<method>`
+     * For example: `_macro/task/list`, `_macro/wake`
+     *
+     * @param method - Full method name (e.g., "_macro/task/list")
+     * @param handler - Handler function
+     */
+    registerExtension(method: string, handler: ExtensionHandler): void;
+    /**
+     * Unregister an extension method.
+     *
+     * @param method - Method name to unregister
+     */
+    unregisterExtension(method: string): void;
+    /**
+     * Get list of registered extension methods.
+     */
+    getExtensions(): string[];
+    /**
+     * Check if an extension method is registered.
+     */
+    hasExtension(method: string): boolean;
+    /**
+     * Start the adapter.
+     *
+     * Initializes resources and begins accepting connections.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the adapter.
+     *
+     * Disconnects all participants and releases resources.
+     *
+     * @param graceful - If true, wait for pending operations (default: true)
+     */
+    stop(graceful?: boolean): Promise<void>;
+    /**
+     * Check if the adapter is running.
+     */
+    isRunning(): boolean;
+}
+/**
+ * Factory function for creating MAPAdapter instances.
+ */
+export type MAPAdapterFactory = (config?: MAPAdapterConfig) => MAPAdapter;
+//# sourceMappingURL=interface.d.ts.map

package/dist/map/adapter/interface.d.ts.map

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

package/dist/map/adapter/interface.js

@@ -0,0 +1,24 @@
+/**
+ * MAPAdapter Interface
+ *
+ * Defines the interface for the MAP adapter layer that handles external
+ * client connections to macro-agent via the Multi-Agent Protocol.
+ *
+ * The adapter sits at the external boundary, handling:
+ * - JSON-RPC protocol (via BaseConnection from MAP SDK)
+ * - Connection/participant lifecycle
+ * - External subscription management
+ * - Extension method dispatch (`_macro/*` methods)
+ * - Event streaming to subscribers
+ * - Auth/permission checks
+ *
+ * Does NOT own:
+ * - Address resolution (delegates to MessageRouter)
+ * - Wake/delivery decisions (delegates to MessageRouter)
+ * - Agent process lifecycle (delegates to AgentManager)
+ * - Internal agent-to-agent routing
+ *
+ * @see specs/s-5qir_map_integration_for_macro_agent.md
+ */
+export {};
+//# sourceMappingURL=interface.js.map

package/dist/map/adapter/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../../src/map/adapter/interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG"}

package/dist/map/adapter/mail-handler-adapter.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Mail Protocol Handler Adapter
+ *
+ * Creates a HandlerRegistry for mail/* protocol methods that can be
+ * merged into the MAPAdapter's RPC handler. Delegates to MailService
+ * for business logic.
+ *
+ * Implements the following MAP mail protocol methods:
+ * - mail/create — Create a conversation
+ * - mail/get — Get conversation details
+ * - mail/list — List conversations
+ * - mail/close — Close a conversation
+ * - mail/join — Join a conversation
+ * - mail/leave — Leave a conversation
+ * - mail/turn — Record a turn
+ * - mail/turns/list — List turns
+ * - mail/thread/create — Create a thread
+ * - mail/thread/list — List threads
+ * - mail/replay — Replay turns
+ */
+import { type HandlerRegistry } from "./rpc-handler.js";
+import type { MailService } from "../../mail/mail-service.js";
+/**
+ * Create mail protocol handlers backed by a MailService.
+ */
+export declare function createMailHandlers(mailService: MailService): HandlerRegistry;
+//# sourceMappingURL=mail-handler-adapter.d.ts.map

package/dist/map/adapter/mail-handler-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail-handler-adapter.d.ts","sourceRoot":"","sources":["../../../src/map/adapter/mail-handler-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAY,KAAK,eAAe,EAAuB,MAAM,kBAAkB,CAAC;AACvF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,WAAW,GAAG,eAAe,CAgZ5E"}