macro-agent 0.0.14 → 0.0.16

package/dist/map/utils/address-translation.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Address Translation Utilities
+ *
+ * Provides bidirectional translation between MAP addresses and
+ * legacy MessageRouter channel format. Used during migration to
+ * support both addressing schemes.
+ *
+ * @see specs/s-5qir_map_integration_for_macro_agent.md
+ */
+import type { Address } from "../types.js";
+import type { ChannelType } from "../../router/types.js";
+import type { AgentId } from "../../store/types/index.js";
+/**
+ * Legacy channel format from MessageRouter.
+ * Used for translation during migration.
+ */
+export interface LegacyChannel {
+    type: ChannelType;
+    /** Target ID (agent_id, task_id, or topic name) */
+    target: string;
+    /** Role name for role channels */
+    role?: string;
+    /** Coordinator ID for scoped role channels */
+    coordinatorId?: AgentId;
+    /** Broadcast scope */
+    scope?: string;
+}
+/**
+ * Translate a MAP Address to legacy MessageRouter channel format.
+ *
+ * Used during migration to route messages through the existing
+ * MessageRouter while accepting MAP-style addresses.
+ *
+ * @param address - MAP address to translate
+ * @returns Legacy channel format
+ * @throws Error if address type is not supported in legacy format
+ */
+export declare function addressToChannel(address: Address): LegacyChannel;
+/**
+ * Translate a legacy MessageRouter channel to MAP address format.
+ *
+ * Used to migrate existing code to the new addressing scheme.
+ *
+ * @param channel - Legacy channel to translate
+ * @returns MAP address
+ * @throws Error if channel type is unknown
+ */
+export declare function channelToAddress(channel: LegacyChannel): Address;
+/**
+ * Check if a MAP address can be translated to legacy channel format.
+ *
+ * Returns false for address types that were added in MAP and have
+ * no equivalent in the legacy MessageRouter.
+ *
+ * @param address - Address to check
+ * @returns true if address can be translated to legacy format
+ */
+export declare function isLegacyCompatible(address: Address): boolean;
+/**
+ * Get a list of address features that are not legacy compatible.
+ *
+ * @param address - Address to check
+ * @returns Array of incompatible feature names, empty if fully compatible
+ */
+export declare function getLegacyIncompatibilities(address: Address): string[];
+/**
+ * Error thrown when a MAP address cannot be translated to legacy format.
+ */
+export declare class AddressTranslationError extends Error {
+    readonly address: Address;
+    constructor(message: string, address: Address);
+}
+/**
+ * Error thrown when a legacy channel cannot be translated to MAP format.
+ */
+export declare class ChannelTranslationError extends Error {
+    readonly channel: LegacyChannel;
+    constructor(message: string, channel: LegacyChannel);
+}
+/**
+ * Attempt to translate an address, returning undefined if not compatible.
+ *
+ * @param address - Address to translate
+ * @returns Legacy channel or undefined if not compatible
+ */
+export declare function tryAddressToChannel(address: Address): LegacyChannel | undefined;
+/**
+ * Create a mapping table entry for documentation/debugging.
+ */
+export interface AddressMapping {
+    mapAddress: string;
+    legacyChannel: string;
+    notes?: string;
+}
+/**
+ * Get the address mapping table for documentation.
+ */
+export declare function getAddressMappingTable(): AddressMapping[];
+//# sourceMappingURL=address-translation.d.ts.map

package/dist/map/utils/address-translation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address-translation.d.ts","sourceRoot":"","sources":["../../../src/map/utils/address-translation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,OAAO,EASR,MAAM,aAAa,CAAC;AAcrB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAU,MAAM,4BAA4B,CAAC;AAMlE;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CA0FhE;AAMD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAsChE;AAMD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAW5D;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAiBrE;AAMD;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;gBAEd,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;CAK9C;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;gBAEpB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa;CAKpD;AAMD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,GACf,aAAa,GAAG,SAAS,CAU3B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,cAAc,EAAE,CAuDzD"}

package/dist/map/utils/address-translation.js

@@ -0,0 +1,285 @@
+/**
+ * Address Translation Utilities
+ *
+ * Provides bidirectional translation between MAP addresses and
+ * legacy MessageRouter channel format. Used during migration to
+ * support both addressing schemes.
+ *
+ * @see specs/s-5qir_map_integration_for_macro_agent.md
+ */
+import { isAgentAddress, isAgentsAddress, isScopeAddress, isRoleAddress, isBroadcastAddress, isTaskAddress, isAncestorsAddress, isDescendantsAddress, isParentAddress, isChildrenAddress, isSiblingsAddress, } from "../types.js";
+// =============================================================================
+// Address to Channel Translation
+// =============================================================================
+/**
+ * Translate a MAP Address to legacy MessageRouter channel format.
+ *
+ * Used during migration to route messages through the existing
+ * MessageRouter while accepting MAP-style addresses.
+ *
+ * @param address - MAP address to translate
+ * @returns Legacy channel format
+ * @throws Error if address type is not supported in legacy format
+ */
+export function addressToChannel(address) {
+    // Direct agent addressing
+    if (isAgentAddress(address)) {
+        return {
+            type: "agent",
+            target: address.agent,
+        };
+    }
+    // Multi-agent addressing (not supported in legacy)
+    if (isAgentsAddress(address)) {
+        throw new AddressTranslationError("Multi-agent addressing not supported in legacy format", address);
+    }
+    // Scope addressing → topic channel
+    if (isScopeAddress(address)) {
+        return {
+            type: "topic",
+            target: address.scope,
+        };
+    }
+    // Role addressing
+    if (isRoleAddress(address)) {
+        return {
+            type: "role",
+            target: address.role,
+            role: address.role,
+            coordinatorId: address.within,
+        };
+    }
+    // Broadcast addressing
+    if (isBroadcastAddress(address)) {
+        return {
+            type: "broadcast",
+            target: "all",
+        };
+    }
+    // Task addressing (macro-agent extension)
+    if (isTaskAddress(address)) {
+        return {
+            type: "task",
+            target: address.task,
+        };
+    }
+    // Ancestors → lineage channel
+    if (isAncestorsAddress(address)) {
+        return {
+            type: "lineage",
+            target: "ancestors",
+        };
+    }
+    // Descendants → subtree channel
+    if (isDescendantsAddress(address)) {
+        return {
+            type: "subtree",
+            target: "descendants",
+        };
+    }
+    // New hierarchical types not supported in legacy
+    if (isParentAddress(address)) {
+        throw new AddressTranslationError("Parent addressing not supported in legacy format", address);
+    }
+    if (isChildrenAddress(address)) {
+        throw new AddressTranslationError("Children addressing not supported in legacy format", address);
+    }
+    if (isSiblingsAddress(address)) {
+        throw new AddressTranslationError("Siblings addressing not supported in legacy format", address);
+    }
+    throw new AddressTranslationError("Unknown address type", address);
+}
+// =============================================================================
+// Channel to Address Translation
+// =============================================================================
+/**
+ * Translate a legacy MessageRouter channel to MAP address format.
+ *
+ * Used to migrate existing code to the new addressing scheme.
+ *
+ * @param channel - Legacy channel to translate
+ * @returns MAP address
+ * @throws Error if channel type is unknown
+ */
+export function channelToAddress(channel) {
+    switch (channel.type) {
+        case "agent":
+            return { agent: channel.target };
+        case "task":
+            return { task: channel.target };
+        case "topic":
+            return { scope: channel.target };
+        case "role":
+            if (channel.coordinatorId) {
+                return { role: channel.role ?? channel.target, within: channel.coordinatorId };
+            }
+            return { role: channel.role ?? channel.target };
+        case "broadcast":
+            // Check for scoped broadcast (e.g., "workers" → role: "worker")
+            if (channel.scope && channel.scope !== "all") {
+                // Convert plural scope to singular role: "workers" → "worker"
+                const role = channel.scope.replace(/s$/, "");
+                return { role };
+            }
+            return { broadcast: true };
+        case "lineage":
+            return { ancestors: true };
+        case "subtree":
+            return { descendants: true };
+        default:
+            throw new ChannelTranslationError(`Unknown channel type: ${channel.type}`, channel);
+    }
+}
+// =============================================================================
+// Legacy Compatibility Check
+// =============================================================================
+/**
+ * Check if a MAP address can be translated to legacy channel format.
+ *
+ * Returns false for address types that were added in MAP and have
+ * no equivalent in the legacy MessageRouter.
+ *
+ * @param address - Address to check
+ * @returns true if address can be translated to legacy format
+ */
+export function isLegacyCompatible(address) {
+    // Multi-agent addressing is new
+    if (isAgentsAddress(address))
+        return false;
+    // These hierarchical types are new
+    if (isParentAddress(address))
+        return false;
+    if (isChildrenAddress(address))
+        return false;
+    if (isSiblingsAddress(address))
+        return false;
+    // All other types have legacy equivalents
+    return true;
+}
+/**
+ * Get a list of address features that are not legacy compatible.
+ *
+ * @param address - Address to check
+ * @returns Array of incompatible feature names, empty if fully compatible
+ */
+export function getLegacyIncompatibilities(address) {
+    const incompatibilities = [];
+    if (isAgentsAddress(address)) {
+        incompatibilities.push("multi-agent addressing");
+    }
+    if (isParentAddress(address)) {
+        incompatibilities.push("parent addressing");
+    }
+    if (isChildrenAddress(address)) {
+        incompatibilities.push("children addressing");
+    }
+    if (isSiblingsAddress(address)) {
+        incompatibilities.push("siblings addressing");
+    }
+    return incompatibilities;
+}
+// =============================================================================
+// Error Classes
+// =============================================================================
+/**
+ * Error thrown when a MAP address cannot be translated to legacy format.
+ */
+export class AddressTranslationError extends Error {
+    address;
+    constructor(message, address) {
+        super(`${message}: ${JSON.stringify(address)}`);
+        this.name = "AddressTranslationError";
+        this.address = address;
+    }
+}
+/**
+ * Error thrown when a legacy channel cannot be translated to MAP format.
+ */
+export class ChannelTranslationError extends Error {
+    channel;
+    constructor(message, channel) {
+        super(`${message}: ${JSON.stringify(channel)}`);
+        this.name = "ChannelTranslationError";
+        this.channel = channel;
+    }
+}
+// =============================================================================
+// Utility Functions
+// =============================================================================
+/**
+ * Attempt to translate an address, returning undefined if not compatible.
+ *
+ * @param address - Address to translate
+ * @returns Legacy channel or undefined if not compatible
+ */
+export function tryAddressToChannel(address) {
+    if (!isLegacyCompatible(address)) {
+        return undefined;
+    }
+    try {
+        return addressToChannel(address);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Get the address mapping table for documentation.
+ */
+export function getAddressMappingTable() {
+    return [
+        {
+            mapAddress: '{ agent: "id" }',
+            legacyChannel: '{ type: "agent", target: "id" }',
+        },
+        {
+            mapAddress: '{ task: "id" }',
+            legacyChannel: '{ type: "task", target: "id" }',
+        },
+        {
+            mapAddress: '{ scope: "id" }',
+            legacyChannel: '{ type: "topic", target: "id" }',
+        },
+        {
+            mapAddress: '{ role: "worker" }',
+            legacyChannel: '{ type: "role", role: "worker" }',
+        },
+        {
+            mapAddress: '{ role: "worker", within: "scope" }',
+            legacyChannel: '{ type: "role", role: "worker", coordinatorId: "scope" }',
+        },
+        {
+            mapAddress: "{ broadcast: true }",
+            legacyChannel: '{ type: "broadcast" }',
+        },
+        {
+            mapAddress: "{ ancestors: true }",
+            legacyChannel: '{ type: "lineage" }',
+        },
+        {
+            mapAddress: "{ descendants: true }",
+            legacyChannel: '{ type: "subtree" }',
+        },
+        {
+            mapAddress: "{ parent: true }",
+            legacyChannel: "N/A",
+            notes: "Not supported in legacy format",
+        },
+        {
+            mapAddress: "{ children: true }",
+            legacyChannel: "N/A",
+            notes: "Not supported in legacy format",
+        },
+        {
+            mapAddress: "{ siblings: true }",
+            legacyChannel: "N/A",
+            notes: "Not supported in legacy format",
+        },
+        {
+            mapAddress: '{ agents: ["a", "b"] }',
+            legacyChannel: "N/A",
+            notes: "Not supported in legacy format",
+        },
+    ];
+}
+//# sourceMappingURL=address-translation.js.map

package/dist/map/utils/address-translation.js.map

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

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

@@ -0,0 +1,7 @@
+export {};
+/**
+ * MAP Utilities Module
+ *
+ * Provides utility functions for MAP integration.
+ */
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/map/utils/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/map/utils/index.js

@@ -0,0 +1,7 @@
+export {};
+/**
+ * MAP Utilities Module
+ *
+ * Provides utility functions for MAP integration.
+ */
+//# sourceMappingURL=index.js.map

package/dist/map/utils/index.js.map

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

package/dist/store/event-store.js

@@ -1025,6 +1025,7 @@ function applySpawnEvent(store, event, notify) {
     store.setRow('agents', agentId, {
         id: agentId,
         session_id: payload.session_id,
+        provider_session_id: '',
         parent: parent ?? '',
         lineage: JSON.stringify(lineage),
         state: 'spawning',
@@ -1069,11 +1070,16 @@ function applyStatusEvent(store, event, notify) {
     const payload = event.payload;
     // Handle specific status types
     if (payload.status_type === 'started') {
-        store.setPartialRow('agents', agentId, {
+        const updates = {
             state: 'running',
             started_at: event.timestamp,
             last_activity_at: event.timestamp,
-        });
+        };
+        // Store the provider's session ID (e.g., Claude Code UUID for --resume)
+        if (payload.provider_session_id) {
+            updates.provider_session_id = payload.provider_session_id;
+        }
+        store.setPartialRow('agents', agentId, updates);
     }
     else {
         // Always update last_activity_at on any status event
@@ -1311,6 +1317,7 @@ function rowToAgent(row) {
     return {
         id: row.id,
         session_id: row.session_id,
+        provider_session_id: row.provider_session_id || undefined,
         parent: row.parent || null,
         lineage: row.lineage ? JSON.parse(row.lineage) : [],
         state: row.state,