opentasks 0.0.4 → 0.0.6

package/dist/providers/map-client-factory.js

@@ -0,0 +1,123 @@
+/**
+ * MAP Client Factory
+ *
+ * Creates a MAPTaskClient from a MAP server connection.
+ * Used by the daemon to wire the MAP provider and event bridge.
+ *
+ * The factory dynamically imports @multi-agent-protocol/sdk so that
+ * the dependency is optional — if the SDK is not installed, the factory
+ * returns null and the MAP provider is gracefully skipped.
+ */
+// ============================================================================
+// Factory
+// ============================================================================
+/**
+ * Create a MAP client by connecting to a MAP server.
+ *
+ * Dynamically imports the MAP SDK. Returns null if:
+ * - The SDK is not installed
+ * - The connection fails
+ *
+ * The returned client satisfies the MAPTaskClient interface and can be
+ * passed directly to createMAPProvider(). The send function can be passed
+ * to createMAPEventBridge().
+ *
+ * @param options - Connection options
+ * @returns MAPClientResult or null on failure
+ */
+export async function createMAPClient(options) {
+    const { server, agentName = 'opentasks-daemon', scope = '', systemId = 'default', timeout = 30000, } = options;
+    try {
+        // Dynamic import — SDK is optional
+        const sdk = await import('@multi-agent-protocol/sdk');
+        const { AgentConnection } = sdk;
+        const connection = await AgentConnection.connect(server, {
+            name: agentName,
+            role: 'daemon',
+            scopes: scope ? [scope] : [],
+            capabilities: {
+                tasks: {
+                    canCreate: true,
+                    canAssign: true,
+                    canUpdate: true,
+                    canList: true,
+                },
+            },
+            metadata: {
+                systemId,
+                type: 'opentasks-daemon',
+            },
+            reconnection: {
+                enabled: true,
+                maxRetries: 10,
+                baseDelayMs: 1000,
+                maxDelayMs: 30000,
+            },
+        });
+        // Task event listeners for the Watchable trait
+        const eventCallbacks = [];
+        // Listen for incoming messages that contain task events
+        connection.onMessage((message) => {
+            const payload = (message.payload ?? {});
+            if (payload.type?.startsWith('task.')) {
+                const event = {
+                    type: payload.type,
+                    data: payload,
+                };
+                for (const cb of eventCallbacks) {
+                    try {
+                        cb(event);
+                    }
+                    catch {
+                        // Don't let callback errors break the loop
+                    }
+                }
+            }
+        });
+        const client = {
+            async createTask(params) {
+                return connection.createTask(params);
+            },
+            async assignTask(taskId, agentId) {
+                return connection.assignTask(taskId, agentId);
+            },
+            async updateTask(params) {
+                return connection.updateTask(params);
+            },
+            async listTasks(params) {
+                return connection.listTasks(params ?? {});
+            },
+            onTaskEvent(callback) {
+                eventCallbacks.push(callback);
+                return () => {
+                    const idx = eventCallbacks.indexOf(callback);
+                    if (idx >= 0)
+                        eventCallbacks.splice(idx, 1);
+                };
+            },
+        };
+        const send = (eventType, data) => {
+            // Send as a message to the scope (observers see message_sent events)
+            // The data includes the event type for receivers to dispatch on
+            if (!scope)
+                return; // Cannot send without a target scope
+            connection.send({ scope }, { type: eventType, ...data }).catch(() => {
+                // Best effort — don't block on send failures
+            });
+        };
+        const disconnect = async () => {
+            try {
+                await connection.disconnect();
+            }
+            catch {
+                // Ignore disconnect errors
+            }
+        };
+        return { client, send, disconnect };
+    }
+    catch {
+        // SDK not installed or connection failed — graceful degradation
+        return null;
+    }
+}
+//# sourceMappingURL=map-client-factory.js.map

package/dist/providers/map-client-factory.js.map

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

package/dist/providers/map-event-bridge.d.ts

@@ -0,0 +1,146 @@
+/**
+ * MAP Event Bridge
+ *
+ * Translates OpenTasks graph changes into MAP task events for observability.
+ * Standalone utility — can be used by the daemon (attached to graph store changes)
+ * or by individual agent processes (emit-your-own-actions pattern).
+ *
+ * The bridge is independent of the MAP provider. The provider handles inbound
+ * (MAP → OpenTasks); the bridge handles outbound (OpenTasks → MAP).
+ *
+ * Accepts either a send function or a MAP connection object (compatible with
+ * agent-inbox's MapConnection interface), so multiple systems can share one
+ * connection — e.g., agent-inbox handles messaging while this bridge handles
+ * task events, both over the same MAP connection.
+ *
+ * Usage patterns:
+ *
+ * 1. With a send function:
+ *    ```
+ *    const bridge = createMAPEventBridge({ send, agentId: 'agent-alice' });
+ *    bridge.emitTaskCreated({ id: 'task-1', title: 'Do thing', status: 'open' });
+ *    ```
+ *
+ * 2. With a shared MAP connection (e.g., from agent-inbox or MAP SDK):
+ *    ```
+ *    const bridge = createMAPEventBridge({
+ *      connection: mapConnection,
+ *      scope: 'swarm:my-team',
+ *      agentId: 'agent-alice',
+ *    });
+ *    bridge.emitTaskStatus('task-1', 'open', 'in_progress');
+ *    ```
+ *
+ * 3. Attached to daemon watch events via IPC:
+ *    ```
+ *    const bridge = createMAPEventBridge({ send, agentId: 'agent-bob' });
+ *    daemonClient.on('watch.event', (event) => bridge.handleProviderChange('native', event));
+ *    ```
+ */
+import type { ProviderChangeEvent } from './traits/Watchable.js';
+/**
+ * Function that sends a MAP event over a connection.
+ *
+ * This is the only dependency on the MAP transport layer.
+ * A ClientConnection's sendEvent, a BaseConnection's sendNotification,
+ * or any custom function that puts events on the wire.
+ */
+export type MAPEventSender = (eventType: string, data: Record<string, unknown>) => void;
+/**
+ * Minimal MAP connection interface for sharing a connection with other systems.
+ *
+ * Compatible with:
+ * - agent-inbox's MapConnection
+ * - MAP SDK's AgentConnection / ClientConnection
+ * - Any object with a send(to, payload, meta?) method
+ *
+ * The bridge borrows the connection — it does NOT own its lifecycle
+ * and will not disconnect it on stop().
+ */
+export interface MAPConnection {
+    send(to: {
+        scope?: string;
+        agentId?: string;
+    } | string, payload: unknown, meta?: Record<string, unknown>): Promise<void>;
+}
+/**
+ * Minimal task info needed to emit MAP events.
+ * Matches the shape agents already have when they perform task operations.
+ */
+export interface TaskInfo {
+    id: string;
+    title?: string;
+    status?: string;
+    description?: string;
+    assignee?: string | null;
+    meta?: Record<string, unknown>;
+}
+/**
+ * Configuration for creating a MAP event bridge.
+ *
+ * Provide either `send` (a raw function) or `connection` + `scope`
+ * (a shared MAP connection object). If both are provided, `send` takes precedence.
+ */
+export interface MAPEventBridgeConfig {
+    /**
+     * Function to send MAP events over the wire.
+     * If provided, this is used directly. Mutually exclusive with `connection`.
+     */
+    send?: MAPEventSender;
+    /**
+     * A shared MAP connection object (e.g., from agent-inbox or MAP SDK).
+     * The bridge adapts connection.send() into the event sender.
+     * The bridge does NOT own the connection lifecycle.
+     */
+    connection?: MAPConnection;
+    /**
+     * MAP scope to send events to. Required when using `connection`.
+     * Ignored when using `send` directly.
+     */
+    scope?: string;
+    /**
+     * Origin identifier stamped on all emitted events.
+     * Used to prevent echo loops — receivers can filter events
+     * that originated from their own system.
+     */
+    agentId?: string;
+    /**
+     * Optional filter — return false to suppress an event.
+     * Called before sending. Useful for filtering by provider,
+     * node type, or any other criteria.
+     */
+    filter?: (eventType: string, data: Record<string, unknown>) => boolean;
+}
+/**
+ * MAP Event Bridge instance
+ */
+export interface MAPEventBridge {
+    /** Emit a task.created event */
+    emitTaskCreated(task: TaskInfo): void;
+    /** Emit a task.status event */
+    emitTaskStatus(taskId: string, previous: string, current: string): void;
+    /** Emit a task.assigned event */
+    emitTaskAssigned(taskId: string, assignee: string): void;
+    /** Emit a task.completed event */
+    emitTaskCompleted(taskId: string, result?: unknown): void;
+    /**
+     * Handle a ProviderChangeEvent from the graph store.
+     * Translates it to the appropriate MAP event(s) and sends.
+     *
+     * @param providerName - Name of the provider that produced the change
+     * @param event - The provider change event
+     */
+    handleProviderChange(providerName: string, event: ProviderChangeEvent): void;
+    /** Stop the bridge and prevent further events from being sent */
+    stop(): void;
+    /** Whether the bridge is active */
+    readonly active: boolean;
+}
+/**
+ * Create a MAP event bridge
+ *
+ * @param config - Bridge configuration (provide `send` or `connection` + `scope`)
+ * @returns A MAPEventBridge instance
+ */
+export declare function createMAPEventBridge(config: MAPEventBridgeConfig): MAPEventBridge;
+//# sourceMappingURL=map-event-bridge.d.ts.map

package/dist/providers/map-event-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-event-bridge.d.ts","sourceRoot":"","sources":["../../src/providers/map-event-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAA2B,MAAM,uBAAuB,CAAC;AAM1F;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;AAExF;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,CACF,EAAE,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,EACjD,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;IAEtB;;;;OAIG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC;IAE3B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;CACxE;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAG7B,gCAAgC;IAChC,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IAEtC,+BAA+B;IAC/B,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAExE,iCAAiC;IACjC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzD,kCAAkC;IAClC,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAI1D;;;;;;OAMG;IACH,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAE7E,iEAAiE;IACjE,IAAI,IAAI,IAAI,CAAC;IAEb,mCAAmC;IACnC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAyBD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,CAoKjF"}

package/dist/providers/map-event-bridge.js

@@ -0,0 +1,208 @@
+/**
+ * MAP Event Bridge
+ *
+ * Translates OpenTasks graph changes into MAP task events for observability.
+ * Standalone utility — can be used by the daemon (attached to graph store changes)
+ * or by individual agent processes (emit-your-own-actions pattern).
+ *
+ * The bridge is independent of the MAP provider. The provider handles inbound
+ * (MAP → OpenTasks); the bridge handles outbound (OpenTasks → MAP).
+ *
+ * Accepts either a send function or a MAP connection object (compatible with
+ * agent-inbox's MapConnection interface), so multiple systems can share one
+ * connection — e.g., agent-inbox handles messaging while this bridge handles
+ * task events, both over the same MAP connection.
+ *
+ * Usage patterns:
+ *
+ * 1. With a send function:
+ *    ```
+ *    const bridge = createMAPEventBridge({ send, agentId: 'agent-alice' });
+ *    bridge.emitTaskCreated({ id: 'task-1', title: 'Do thing', status: 'open' });
+ *    ```
+ *
+ * 2. With a shared MAP connection (e.g., from agent-inbox or MAP SDK):
+ *    ```
+ *    const bridge = createMAPEventBridge({
+ *      connection: mapConnection,
+ *      scope: 'swarm:my-team',
+ *      agentId: 'agent-alice',
+ *    });
+ *    bridge.emitTaskStatus('task-1', 'open', 'in_progress');
+ *    ```
+ *
+ * 3. Attached to daemon watch events via IPC:
+ *    ```
+ *    const bridge = createMAPEventBridge({ send, agentId: 'agent-bob' });
+ *    daemonClient.on('watch.event', (event) => bridge.handleProviderChange('native', event));
+ *    ```
+ */
+// ============================================================================
+// Status Mapping
+// ============================================================================
+/**
+ * Map OpenTasks status to MAP task status for outbound events
+ */
+function toMAPStatus(status) {
+    switch (status?.toLowerCase()) {
+        case 'open': return 'open';
+        case 'in_progress': return 'in_progress';
+        case 'blocked': return 'blocked';
+        case 'closed': return 'completed';
+        case 'completed': return 'completed';
+        case 'failed': return 'failed';
+        default: return 'open';
+    }
+}
+// ============================================================================
+// Factory
+// ============================================================================
+/**
+ * Create a MAP event bridge
+ *
+ * @param config - Bridge configuration (provide `send` or `connection` + `scope`)
+ * @returns A MAPEventBridge instance
+ */
+export function createMAPEventBridge(config) {
+    const { agentId, filter } = config;
+    // Resolve the send function from either direct `send` or `connection` + `scope`
+    let send;
+    if (config.send) {
+        send = config.send;
+    }
+    else if (config.connection) {
+        const connection = config.connection;
+        const scope = config.scope || '';
+        const target = scope ? { scope } : {};
+        send = (eventType, data) => {
+            connection.send(target, { type: eventType, ...data }).catch(() => {
+                // Best effort — don't block on send failures
+            });
+        };
+    }
+    else {
+        throw new Error('MAPEventBridgeConfig requires either `send` or `connection`');
+    }
+    let active = true;
+    function emit(eventType, data) {
+        if (!active)
+            return;
+        // Stamp origin metadata
+        if (agentId) {
+            data._origin = agentId;
+        }
+        // Apply filter
+        if (filter && !filter(eventType, data))
+            return;
+        send(eventType, data);
+    }
+    const bridge = {
+        // ==================================================================
+        // Direct Emit Methods
+        // ==================================================================
+        emitTaskCreated(task) {
+            emit('task.created', {
+                task: {
+                    id: task.id,
+                    ...(task.title !== undefined && { title: task.title }),
+                    ...(task.status !== undefined && { status: toMAPStatus(task.status) }),
+                    ...(task.description !== undefined && { description: task.description }),
+                    ...(task.assignee !== undefined && { assignee: task.assignee }),
+                    ...(task.meta !== undefined && { meta: task.meta }),
+                },
+            });
+        },
+        emitTaskStatus(taskId, previous, current) {
+            emit('task.status', {
+                taskId,
+                previous: toMAPStatus(previous),
+                current: toMAPStatus(current),
+            });
+            // Also emit task.completed if the new status is a terminal state
+            if (current === 'completed' || current === 'closed') {
+                emit('task.completed', { taskId });
+            }
+        },
+        emitTaskAssigned(taskId, assignee) {
+            emit('task.assigned', {
+                taskId,
+                agentId: assignee,
+            });
+        },
+        emitTaskCompleted(taskId, result) {
+            emit('task.completed', {
+                taskId,
+                ...(result !== undefined && { result }),
+            });
+        },
+        // ==================================================================
+        // Provider Change Handler
+        // ==================================================================
+        handleProviderChange(providerName, event) {
+            if (!active)
+                return;
+            // Only handle node events (not edge events)
+            if (event.kind !== 'node')
+                return;
+            // Skip changes from the MAP provider to prevent echo loops
+            if (providerName === 'map')
+                return;
+            const nodeEvent = event.event;
+            // Only bridge task-type nodes
+            const nodeType = nodeEvent.node?.type;
+            if (nodeType && nodeType !== 'task')
+                return;
+            switch (nodeEvent.type) {
+                case 'created': {
+                    if (nodeEvent.node) {
+                        bridge.emitTaskCreated({
+                            id: nodeEvent.nodeId,
+                            title: nodeEvent.node.title,
+                            status: nodeEvent.node.status,
+                            description: nodeEvent.node.content,
+                            assignee: nodeEvent.node.rawData?.assignee,
+                            meta: nodeEvent.node.rawData,
+                        });
+                    }
+                    break;
+                }
+                case 'updated': {
+                    const changedFields = nodeEvent.changedFields;
+                    const previousValues = nodeEvent.previousValues;
+                    // Status change
+                    if (changedFields?.includes('status') && previousValues?.status) {
+                        const previous = String(previousValues.status);
+                        const current = nodeEvent.node?.status ?? 'open';
+                        bridge.emitTaskStatus(nodeEvent.nodeId, previous, current);
+                    }
+                    // Assignment change
+                    if (changedFields?.includes('assignee') && nodeEvent.node?.rawData?.assignee) {
+                        bridge.emitTaskAssigned(nodeEvent.nodeId, String(nodeEvent.node.rawData.assignee));
+                    }
+                    // If no specific fields reported, emit a generic status event
+                    // based on current node state (best effort)
+                    if (!changedFields && nodeEvent.node?.status) {
+                        const previous = previousValues?.status
+                            ? String(previousValues.status)
+                            : 'open';
+                        bridge.emitTaskStatus(nodeEvent.nodeId, previous, nodeEvent.node.status);
+                    }
+                    break;
+                }
+                case 'deleted': {
+                    // MAP has no delete — emit as status change to 'failed'
+                    bridge.emitTaskStatus(nodeEvent.nodeId, 'open', 'failed');
+                    break;
+                }
+            }
+        },
+        stop() {
+            active = false;
+        },
+        get active() {
+            return active;
+        },
+    };
+    return bridge;
+}
+//# sourceMappingURL=map-event-bridge.js.map

package/dist/providers/map-event-bridge.js.map

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

package/dist/providers/map.d.ts

@@ -0,0 +1,115 @@
+/**
+ * MAP (Multi-Agent Protocol) Provider
+ *
+ * Provider that bridges MAP task operations with OpenTasks.
+ * Handles map:// URI scheme for tasks managed via MAP.
+ *
+ * Supports three scenarios:
+ * 1. Same OpenTasks repo — MAP used for real-time coordination, native provider resolves tasks
+ * 2. Cross-system — tasks on a remote system accessed via MAP task methods
+ * 3. Mixed — local tasks with MAP-based assignment to external agents
+ *
+ * The provider depends on a MAPTaskClient interface, which can be satisfied by:
+ * - A MAP SDK ClientConnection (hub topology)
+ * - A MAP SDK BaseConnection wrapper (peer topology)
+ * - A local adapter (same-repo coordination, no network)
+ */
+import type { Provider } from './types.js';
+import type { TaskManageable } from './traits/TaskManageable.js';
+import type { Watchable } from './traits/Watchable.js';
+/**
+ * MAP task status values (matches MAP SDK MAPTaskStatus)
+ */
+export type MAPTaskStatus = 'open' | 'in_progress' | 'blocked' | 'completed' | 'failed';
+/**
+ * MAP task structure (matches MAP SDK MAPTask)
+ */
+export interface MAPTask {
+    id: string;
+    assignee?: string | null;
+    title?: string;
+    status?: MAPTaskStatus;
+    description?: string;
+    meta?: Record<string, unknown>;
+}
+/**
+ * MAP task event (for Watchable support)
+ */
+export interface MAPTaskEvent {
+    type: 'task.created' | 'task.assigned' | 'task.status' | 'task.completed';
+    data: Record<string, unknown>;
+}
+/**
+ * Interface for anything that can perform MAP task operations.
+ *
+ * This is the abstraction boundary between OpenTasks and MAP.
+ * Implementations include:
+ * - MAP SDK ClientConnection (satisfies this naturally)
+ * - A future PeerConnection
+ * - A local GraphStore adapter (for same-repo scenario)
+ *
+ * The interface uses the same parameter/response shapes as the MAP SDK
+ * so that ClientConnection can be passed directly without an adapter.
+ */
+export interface MAPTaskClient {
+    createTask(params: {
+        task: Omit<MAPTask, 'id'> & {
+            id?: string;
+        };
+    }): Promise<{
+        task: MAPTask;
+    }>;
+    assignTask(taskId: string, agentId: string): Promise<{
+        task: MAPTask;
+    }>;
+    updateTask(params: {
+        taskId: string;
+        status?: MAPTaskStatus;
+        title?: string;
+        description?: string;
+        assignee?: string | null;
+        meta?: Record<string, unknown>;
+    }): Promise<{
+        task: MAPTask;
+    }>;
+    listTasks(params?: {
+        filter?: {
+            assignee?: string;
+            status?: MAPTaskStatus | MAPTaskStatus[];
+        };
+        limit?: number;
+        cursor?: string;
+    }): Promise<{
+        tasks: MAPTask[];
+        hasMore: boolean;
+        nextCursor?: string;
+    }>;
+    /**
+     * Subscribe to task events. Optional — enables the Watchable trait.
+     * Returns an unsubscribe function.
+     */
+    onTaskEvent?(callback: (event: MAPTaskEvent) => void): () => void;
+}
+/**
+ * Configuration for MAP provider
+ */
+export interface MAPProviderConfig {
+    /** The MAP task client to use for operations */
+    client: MAPTaskClient;
+    /**
+     * System identifier for this MAP connection.
+     * Used in URIs: map://{systemId}/{taskId}
+     * Defaults to 'default'.
+     */
+    systemId?: string;
+    /** Request timeout in ms */
+    timeout?: number;
+}
+/**
+ * Create a MAP provider
+ *
+ * @param config - Provider configuration including the MAPTaskClient
+ * @returns A Provider that implements TaskManageable and optionally Watchable
+ */
+export declare function createMAPProvider(config: MAPProviderConfig): Provider & TaskManageable & Partial<Watchable>;
+//# sourceMappingURL=map.d.ts.map

package/dist/providers/map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../src/providers/map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EACV,QAAQ,EAST,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,cAAc,EAAkD,MAAM,4BAA4B,CAAC;AACjH,OAAO,KAAK,EAAE,SAAS,EAAyC,MAAM,uBAAuB,CAAC;AAM9F;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,aAAa,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAExF;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,cAAc,GAAG,eAAe,GAAG,aAAa,GAAG,gBAAgB,CAAC;IAC1E,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,MAAM,EAAE;QACjB,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG;YAAE,EAAE,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC7C,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAE/B,UAAU,CACR,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAE9B,UAAU,CAAC,MAAM,EAAE;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,aAAa,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAChC,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAE/B,SAAS,CAAC,MAAM,CAAC,EAAE;QACjB,MAAM,CAAC,EAAE;YACP,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,MAAM,CAAC,EAAE,aAAa,GAAG,aAAa,EAAE,CAAC;SAC1C,CAAC;QACF,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC;QACV,KAAK,EAAE,OAAO,EAAE,CAAC;QACjB,OAAO,EAAE,OAAO,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IAEH;;;OAGG;IACH,WAAW,CAAC,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACnE;AAMD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,MAAM,EAAE,aAAa,CAAC;IAEtB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAoFD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,iBAAiB,GACxB,QAAQ,GAAG,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,CAsXhD"}