macro-agent 0.1.1 → 0.1.3

package/dist/map/adapter/extensions/workspace.d.ts

@@ -1,57 +0,0 @@
-/**
- * Workspace Info Extension Method (_macro/workspace/info)
- *
- * Exposes workspace information to external MAP clients.
- * Returns limited info (no filesystem paths) for security.
- *
- * @see specs/s-5qir_map_integration_for_macro_agent.md
- */
-import type { MAPAdapter } from "../interface.js";
-import type { AgentId } from "../../../store/types/index.js";
-/**
- * Workspace role types
- */
-type WorkspaceRole = "worker" | "integrator" | "coordinator";
-/**
- * Internal workspace type (matches WorkspaceManager output)
- */
-export interface InternalWorkspace {
-    agentId: AgentId;
-    path: string;
-    branch: string;
-    streamId: string;
-    role: WorkspaceRole;
-    createdAt: number;
-    taskId?: string;
-    baseBranch?: string;
-    coordinatorId?: string;
-    childWorkspacePaths?: Map<AgentId, string>;
-}
-/**
- * Services required for workspace extension
- */
-export interface WorkspaceExtensionServices {
-    /**
-     * Get workspace for an agent
-     */
-    getWorkspace: (agentId: AgentId) => InternalWorkspace | null;
-    /**
-     * Check if agent exists
-     */
-    agentExists: (agentId: AgentId) => boolean;
-}
-/**
- * Register workspace extension method with the MAPAdapter.
- *
- * @param adapter - MAPAdapter instance
- * @param services - Workspace extension services
- */
-export declare function registerWorkspaceExtension(adapter: MAPAdapter, services: WorkspaceExtensionServices): void;
-/**
- * Unregister workspace extension method.
- *
- * @param adapter - MAPAdapter instance
- */
-export declare function unregisterWorkspaceExtension(adapter: MAPAdapter): void;
-export {};
-//# sourceMappingURL=workspace.d.ts.map

package/dist/map/adapter/extensions/workspace.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../../src/map/adapter/extensions/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAsC,MAAM,iBAAiB,CAAC;AACtF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAY7D;;GAEG;AACH,KAAK,aAAa,GAAG,QAAQ,GAAG,YAAY,GAAG,aAAa,CAAC;AA8B7D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAElB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,YAAY,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,iBAAiB,GAAG,IAAI,CAAC;IAE7D;;OAEG;IACH,WAAW,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;CAC5C;AAsED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,0BAA0B,GACnC,IAAI,CAEN;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAEtE"}

package/dist/map/adapter/extensions/workspace.js

@@ -1,81 +0,0 @@
-/**
- * Workspace Info Extension Method (_macro/workspace/info)
- *
- * Exposes workspace information to external MAP clients.
- * Returns limited info (no filesystem paths) for security.
- *
- * @see specs/s-5qir_map_integration_for_macro_agent.md
- */
-import { RPCError } from "../rpc-handler.js";
-// =============================================================================
-// Handler Implementation
-// =============================================================================
-function createWorkspaceInfoHandler(services) {
-    return async (_context, params) => {
-        const { agentId } = (params ?? {});
-        if (!agentId) {
-            throw RPCError.invalidParams("agentId is required");
-        }
-        // Check agent exists
-        if (!services.agentExists(agentId)) {
-            throw RPCError.notFound("agent", agentId);
-        }
-        // Get workspace
-        const workspace = services.getWorkspace(agentId);
-        if (!workspace) {
-            // Agent exists but has no workspace
-            return { workspace: null };
-        }
-        // Convert to public info (exclude path)
-        const info = {
-            agentId: workspace.agentId,
-            role: workspace.role,
-            branch: workspace.branch,
-            streamId: workspace.streamId,
-            createdAt: workspace.createdAt,
-        };
-        // Add role-specific fields
-        switch (workspace.role) {
-            case "worker":
-                if (workspace.taskId) {
-                    info.taskId = workspace.taskId;
-                }
-                if (workspace.baseBranch) {
-                    info.baseBranch = workspace.baseBranch;
-                }
-                break;
-            case "integrator":
-                if (workspace.coordinatorId) {
-                    info.coordinatorId = workspace.coordinatorId;
-                }
-                break;
-            case "coordinator":
-                if (workspace.childWorkspacePaths) {
-                    info.childCount = workspace.childWorkspacePaths.size;
-                }
-                break;
-        }
-        return { workspace: info };
-    };
-}
-// =============================================================================
-// Registration
-// =============================================================================
-/**
- * Register workspace extension method with the MAPAdapter.
- *
- * @param adapter - MAPAdapter instance
- * @param services - Workspace extension services
- */
-export function registerWorkspaceExtension(adapter, services) {
-    adapter.registerExtension("_macro/workspace/info", createWorkspaceInfoHandler(services));
-}
-/**
- * Unregister workspace extension method.
- *
- * @param adapter - MAPAdapter instance
- */
-export function unregisterWorkspaceExtension(adapter) {
-    adapter.unregisterExtension("_macro/workspace/info");
-}
-//# sourceMappingURL=workspace.js.map

package/dist/map/adapter/extensions/workspace.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../../../src/map/adapter/extensions/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AA4E7C,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF,SAAS,0BAA0B,CACjC,QAAoC;IAEpC,OAAO,KAAK,EAAE,QAA0B,EAAE,MAAe,EAAE,EAAE;QAC3D,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,CAAwB,CAAC;QAE1D,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,QAAQ,CAAC,aAAa,CAAC,qBAAqB,CAAC,CAAC;QACtD,CAAC;QAED,qBAAqB;QACrB,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,OAAkB,CAAC,EAAE,CAAC;YAC9C,MAAM,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC5C,CAAC;QAED,gBAAgB;QAChB,MAAM,SAAS,GAAG,QAAQ,CAAC,YAAY,CAAC,OAAkB,CAAC,CAAC;QAE5D,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,oCAAoC;YACpC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QAC7B,CAAC;QAED,wCAAwC;QACxC,MAAM,IAAI,GAAkB;YAC1B,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,MAAM,EAAE,SAAS,CAAC,MAAM;YACxB,QAAQ,EAAE,SAAS,CAAC,QAAQ;YAC5B,SAAS,EAAE,SAAS,CAAC,SAAS;SAC/B,CAAC;QAEF,2BAA2B;QAC3B,QAAQ,SAAS,CAAC,IAAI,EAAE,CAAC;YACvB,KAAK,QAAQ;gBACX,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;oBACrB,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;gBACjC,CAAC;gBACD,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;oBACzB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC,UAAU,CAAC;gBACzC,CAAC;gBACD,MAAM;YAER,KAAK,YAAY;gBACf,IAAI,SAAS,CAAC,aAAa,EAAE,CAAC;oBAC5B,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC,aAAa,CAAC;gBAC/C,CAAC;gBACD,MAAM;YAER,KAAK,aAAa;gBAChB,IAAI,SAAS,CAAC,mBAAmB,EAAE,CAAC;oBAClC,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC,mBAAmB,CAAC,IAAI,CAAC;gBACvD,CAAC;gBACD,MAAM;QACV,CAAC;QAED,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IAC7B,CAAC,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAAmB,EACnB,QAAoC;IAEpC,OAAO,CAAC,iBAAiB,CAAC,uBAAuB,EAAE,0BAA0B,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC3F,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAAC,OAAmB;IAC9D,OAAO,CAAC,mBAAmB,CAAC,uBAAuB,CAAC,CAAC;AACvD,CAAC"}

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

@@ -1,20 +0,0 @@
-/**
- * MAP Adapter Module
- *
- * Provides types, interfaces, and implementations for the MAP adapter layer
- * that handles external client connections.
- *
- * @see specs/s-5qir_map_integration_for_macro_agent.md
- */
-export * from "./types.js";
-export * from "./interface.js";
-export { createConnectionManager, ConnectionManagerImpl, ConnectionError, type ConnectionManager, type ConnectionManagerConfig, type ConnectionManagerEvent, type ConnectionManagerEventHandler, type ConnectOptions, type ConnectionErrorCode, } from "./connection-manager.js";
-export { createSubscriptionManager, SubscriptionManagerImpl, SubscriptionError, type SubscriptionManager, type SubscriptionManagerConfig, type SubscriptionManagerEvent, type SubscriptionManagerEventHandler, type MatchResult, type SubscriptionErrorCode, } from "./subscription-manager.js";
-export { RPCHandler, createRPCHandler, RPCError, JSON_RPC_ERRORS, MAP_ERRORS, isRequest, isNotification, isResponse, isErrorResponse, createSuccessResponse, createErrorResponse, createNotification, createLoggingMiddleware, createCapabilityMiddleware, type RequestId, type JsonRpcRequest, type JsonRpcNotification, type JsonRpcError, type JsonRpcSuccessResponse, type JsonRpcErrorResponse, type JsonRpcResponse, type JsonRpcMessage, type HandlerContext, type MethodHandler, type HandlerRegistry, type Middleware, type RPCHandlerConfig, type ProcessResult, } from "./rpc-handler.js";
-export { MAPAdapterImpl, createMAPAdapter, type MAPAdapterServices, } from "./map-adapter.js";
-export { ACPOverMAPHandler, type ACPEnvelope, type ACPOverMAPConfig, type ACPNotificationEmitter, } from "./acp-over-map.js";
-export { translateEvent, translateEvents, createEventStreamAdapter, type TranslationResult, type TranslationContext, type EventStreamAdapterOptions, } from "./event-translator.js";
-export { EventLog, underscoreToDot, dotToUnderscore, type EventLogConfig, type LoggedEvent, type EventLogQueryParams, type EventLogFilter, type EventLogQueryResult, } from "./event-log.js";
-export { createMAPWebSocketHandler, setupMAPWebSocket, type MAPWebSocketHandler, type MAPWebSocketConfig, type MAPWebSocketSetup, } from "./websocket-integration.js";
-export { registerMacroExtensions, unregisterMacroExtensions, registerTaskExtensions, unregisterTaskExtensions, registerWakeExtension, unregisterWakeExtension, registerWorkspaceExtension, unregisterWorkspaceExtension, registerWorkspaceFileExtensions, unregisterWorkspaceFileExtensions, registerUpdateMetadataExtension, unregisterUpdateMetadataExtension, registerMCPBridgeExtensions, unregisterMCPBridgeExtensions, MACRO_EXTENSION_METHODS, EXTENSION_CAPABILITIES, MCP_BRIDGE_METHODS, type MacroExtensionServices, type TaskExtensionServices, type WakeExtensionServices, type WorkspaceExtensionServices, type WorkspaceFileServices, type UpdateMetadataExtensionServices, type MCPBridgeServices, type SessionInfo, type InternalWorkspace, registerAgentLifecycleExtensions, unregisterAgentLifecycleExtensions, AGENT_LIFECYCLE_METHODS, type AgentLifecycleExtensionServices, registerResumeExtension, unregisterResumeExtension, type ResumeExtensionServices, } from "./extensions/index.js";
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/map/adapter/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAG/B,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,6BAA6B,EAClC,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,+BAA+B,EACpC,KAAK,WAAW,EAChB,KAAK,qBAAqB,GAC3B,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,QAAQ,EACR,eAAe,EACf,UAAU,EACV,SAAS,EACT,cAAc,EACd,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,EACvB,0BAA0B,EAC1B,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,aAAa,GACnB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,KAAK,kBAAkB,GACxB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,GAC5B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,cAAc,EACd,eAAe,EACf,wBAAwB,EACxB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,GAC/B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,QAAQ,EACR,eAAe,EACf,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,GACvB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAEL,uBAAuB,EACvB,yBAAyB,EACzB,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,4BAA4B,EAC5B,+BAA+B,EAC/B,iCAAiC,EACjC,+BAA+B,EAC/B,iCAAiC,EACjC,2BAA2B,EAC3B,6BAA6B,EAE7B,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,EAElB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,EAC/B,KAAK,qBAAqB,EAC1B,KAAK,+BAA+B,EACpC,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EAEtB,gCAAgC,EAChC,kCAAkC,EAClC,uBAAuB,EACvB,KAAK,+BAA+B,EAEpC,uBAAuB,EACvB,yBAAyB,EACzB,KAAK,uBAAuB,GAC7B,MAAM,uBAAuB,CAAC"}

package/dist/map/adapter/index.js

@@ -1,38 +0,0 @@
-/**
- * MAP Adapter Module
- *
- * Provides types, interfaces, and implementations for the MAP adapter layer
- * that handles external client connections.
- *
- * @see specs/s-5qir_map_integration_for_macro_agent.md
- */
-// Types and interfaces
-export * from "./types.js";
-export * from "./interface.js";
-// Connection management
-export { createConnectionManager, ConnectionManagerImpl, ConnectionError, } from "./connection-manager.js";
-// Subscription management
-export { createSubscriptionManager, SubscriptionManagerImpl, SubscriptionError, } from "./subscription-manager.js";
-// JSON-RPC handling
-export { RPCHandler, createRPCHandler, RPCError, JSON_RPC_ERRORS, MAP_ERRORS, isRequest, isNotification, isResponse, isErrorResponse, createSuccessResponse, createErrorResponse, createNotification, createLoggingMiddleware, createCapabilityMiddleware, } from "./rpc-handler.js";
-// MAPAdapter implementation
-export { MAPAdapterImpl, createMAPAdapter, } from "./map-adapter.js";
-// ACP-over-MAP support
-export { ACPOverMAPHandler, } from "./acp-over-map.js";
-// Event translation
-export { translateEvent, translateEvents, createEventStreamAdapter, } from "./event-translator.js";
-// Event log (replay support)
-export { EventLog, underscoreToDot, dotToUnderscore, } from "./event-log.js";
-// WebSocket integration
-export { createMAPWebSocketHandler, setupMAPWebSocket, } from "./websocket-integration.js";
-// Extension methods (_macro/*)
-export { 
-// Registration
-registerMacroExtensions, unregisterMacroExtensions, registerTaskExtensions, unregisterTaskExtensions, registerWakeExtension, unregisterWakeExtension, registerWorkspaceExtension, unregisterWorkspaceExtension, registerWorkspaceFileExtensions, unregisterWorkspaceFileExtensions, registerUpdateMetadataExtension, unregisterUpdateMetadataExtension, registerMCPBridgeExtensions, unregisterMCPBridgeExtensions, 
-// Constants
-MACRO_EXTENSION_METHODS, EXTENSION_CAPABILITIES, MCP_BRIDGE_METHODS, 
-// Agent lifecycle
-registerAgentLifecycleExtensions, unregisterAgentLifecycleExtensions, AGENT_LIFECYCLE_METHODS, 
-// Resume
-registerResumeExtension, unregisterResumeExtension, } from "./extensions/index.js";
-//# sourceMappingURL=index.js.map

package/dist/map/adapter/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/map/adapter/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,uBAAuB;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAE/B,wBAAwB;AACxB,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,eAAe,GAOhB,MAAM,yBAAyB,CAAC;AAEjC,0BAA0B;AAC1B,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,iBAAiB,GAOlB,MAAM,2BAA2B,CAAC;AAEnC,oBAAoB;AACpB,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,QAAQ,EACR,eAAe,EACf,UAAU,EACV,SAAS,EACT,cAAc,EACd,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,EACvB,0BAA0B,GAe3B,MAAM,kBAAkB,CAAC;AAE1B,4BAA4B;AAC5B,OAAO,EACL,cAAc,EACd,gBAAgB,GAEjB,MAAM,kBAAkB,CAAC;AAE1B,uBAAuB;AACvB,OAAO,EACL,iBAAiB,GAIlB,MAAM,mBAAmB,CAAC;AAE3B,oBAAoB;AACpB,OAAO,EACL,cAAc,EACd,eAAe,EACf,wBAAwB,GAIzB,MAAM,uBAAuB,CAAC;AAE/B,6BAA6B;AAC7B,OAAO,EACL,QAAQ,EACR,eAAe,EACf,eAAe,GAMhB,MAAM,gBAAgB,CAAC;AAExB,wBAAwB;AACxB,OAAO,EACL,yBAAyB,EACzB,iBAAiB,GAIlB,MAAM,4BAA4B,CAAC;AAEpC,+BAA+B;AAC/B,OAAO;AACL,eAAe;AACf,uBAAuB,EACvB,yBAAyB,EACzB,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,4BAA4B,EAC5B,+BAA+B,EAC/B,iCAAiC,EACjC,+BAA+B,EAC/B,iCAAiC,EACjC,2BAA2B,EAC3B,6BAA6B;AAC7B,YAAY;AACZ,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB;AAWlB,kBAAkB;AAClB,gCAAgC,EAChC,kCAAkC,EAClC,uBAAuB;AAEvB,SAAS;AACT,uBAAuB,EACvB,yBAAyB,GAE1B,MAAM,uBAAuB,CAAC"}

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

@@ -1,450 +0,0 @@
-/**
- * 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