macro-agent 0.0.10 → 0.0.12

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

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

@@ -1 +0,0 @@
-{"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

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

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

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

package/dist/map/utils/index.js

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

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

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