@nxuss/lemma 0.1.0

package/dist/protocol/iap.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Inter-Agent Protocol (I.A.P.) v1.0
+ * Standardized communication layer for autonomous AI agents
+ */
+import { IAPMessage, HandshakePayload, TaskRequest, TaskResponse } from '../types/index';
+export type AgentHandshake = HandshakePayload;
+export interface TaskBid {
+    taskId: string;
+    agentId: string;
+    bidAmount: number;
+    estimatedTime?: number;
+    confidence?: number;
+    metadata?: Record<string, any>;
+}
+export declare class IAPProtocol {
+    static readonly VERSION = "1.0.0";
+    /**
+     * Create a handshake message
+     */
+    static createHandshake(handshake: HandshakePayload): IAPMessage;
+    /**
+     * Create a task request message
+     */
+    static createTaskRequest(request: TaskRequest): IAPMessage;
+    /**
+     * Create a task response message
+     */
+    static createTaskResponse(response: TaskResponse): IAPMessage;
+    /**
+     * Create a task bid message
+     */
+    static createTaskBid(bid: TaskBid): IAPMessage;
+    /**
+     * Create a heartbeat message
+     */
+    static createHeartbeat(agentId: string): IAPMessage;
+    /**
+     * Create an error message
+     */
+    static createError(error: string, details?: Record<string, unknown>): IAPMessage;
+    /**
+     * Validate an IAP message
+     */
+    static validate(message: unknown): message is IAPMessage;
+    /**
+     * Parse a raw message string into an IAP message
+     */
+    static parse(raw: string): IAPMessage;
+    /**
+     * Serialize an IAP message to string
+     */
+    static serialize(message: IAPMessage): string;
+}
+//# sourceMappingURL=iap.d.ts.map

package/dist/protocol/iap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iap.d.ts","sourceRoot":"","sources":["../../src/protocol/iap.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAkB,gBAAgB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGzG,MAAM,MAAM,cAAc,GAAG,gBAAgB,CAAC;AAE9C,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,qBAAa,WAAW;IACtB,MAAM,CAAC,QAAQ,CAAC,OAAO,WAAW;IAElC;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,SAAS,EAAE,gBAAgB,GAAG,UAAU;IAQ/D;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU;IAQ1D;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,UAAU;IAQ7D;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU;IAQ9C;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU;IAQnD;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU;IAQhF;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,UAAU;IAexD;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU;IAYrC;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM;CAG9C"}

package/dist/protocol/iap.js

@@ -0,0 +1,108 @@
+"use strict";
+/**
+ * Inter-Agent Protocol (I.A.P.) v1.0
+ * Standardized communication layer for autonomous AI agents
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IAPProtocol = void 0;
+const index_1 = require("../types/index");
+class IAPProtocol {
+    /**
+     * Create a handshake message
+     */
+    static createHandshake(handshake) {
+        return {
+            type: index_1.IAPMessageType.HANDSHAKE,
+            payload: handshake,
+            timestamp: Date.now(),
+        };
+    }
+    /**
+     * Create a task request message
+     */
+    static createTaskRequest(request) {
+        return {
+            type: index_1.IAPMessageType.TASK_REQUEST,
+            payload: request,
+            timestamp: Date.now(),
+        };
+    }
+    /**
+     * Create a task response message
+     */
+    static createTaskResponse(response) {
+        return {
+            type: index_1.IAPMessageType.TASK_RESPONSE,
+            payload: response,
+            timestamp: Date.now(),
+        };
+    }
+    /**
+     * Create a task bid message
+     */
+    static createTaskBid(bid) {
+        return {
+            type: index_1.IAPMessageType.TASK_ASSIGN,
+            payload: bid,
+            timestamp: Date.now(),
+        };
+    }
+    /**
+     * Create a heartbeat message
+     */
+    static createHeartbeat(agentId) {
+        return {
+            type: index_1.IAPMessageType.HEARTBEAT,
+            payload: { agentId },
+            timestamp: Date.now(),
+        };
+    }
+    /**
+     * Create an error message
+     */
+    static createError(error, details) {
+        return {
+            type: index_1.IAPMessageType.ERROR,
+            payload: { error, ...details },
+            timestamp: Date.now(),
+        };
+    }
+    /**
+     * Validate an IAP message
+     */
+    static validate(message) {
+        if (typeof message !== 'object' || message === null) {
+            return false;
+        }
+        const msg = message;
+        if (!msg.type || !msg.payload || !msg.timestamp) {
+            return false;
+        }
+        // Check if type is a valid IAPMessageType enum value
+        return Object.values(index_1.IAPMessageType).includes(msg.type);
+    }
+    /**
+     * Parse a raw message string into an IAP message
+     */
+    static parse(raw) {
+        try {
+            const parsed = JSON.parse(raw);
+            if (!this.validate(parsed)) {
+                throw new Error('Invalid IAP message format');
+            }
+            return parsed;
+        }
+        catch (error) {
+            throw new Error(`Failed to parse IAP message: ${error}`);
+        }
+    }
+    /**
+     * Serialize an IAP message to string
+     */
+    static serialize(message) {
+        return JSON.stringify(message);
+    }
+}
+exports.IAPProtocol = IAPProtocol;
+IAPProtocol.VERSION = '1.0.0';
+//# sourceMappingURL=iap.js.map

package/dist/protocol/iap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iap.js","sourceRoot":"","sources":["../../src/protocol/iap.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,0CAAyG;AAczG,MAAa,WAAW;IAGtB;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,SAA2B;QAChD,OAAO;YACL,IAAI,EAAE,sBAAc,CAAC,SAAS;YAC9B,OAAO,EAAE,SAAS;YAClB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,OAAoB;QAC3C,OAAO;YACL,IAAI,EAAE,sBAAc,CAAC,YAAY;YACjC,OAAO,EAAE,OAAO;YAChB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,QAAsB;QAC9C,OAAO;YACL,IAAI,EAAE,sBAAc,CAAC,aAAa;YAClC,OAAO,EAAE,QAAQ;YACjB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,GAAY;QAC/B,OAAO;YACL,IAAI,EAAE,sBAAc,CAAC,WAAW;YAChC,OAAO,EAAE,GAAG;YACZ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,OAAe;QACpC,OAAO;YACL,IAAI,EAAE,sBAAc,CAAC,SAAS;YAC9B,OAAO,EAAE,EAAE,OAAO,EAAE;YACpB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,KAAa,EAAE,OAAiC;QACjE,OAAO;YACL,IAAI,EAAE,sBAAc,CAAC,KAAK;YAC1B,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE;YAC9B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAgB;QAC9B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACpD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,GAAG,GAAG,OAA8B,CAAC;QAE3C,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;YAChD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,qDAAqD;QACrD,OAAO,MAAM,CAAC,MAAM,CAAC,sBAAc,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAsB,CAAC,CAAC;IAC5E,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,GAAW;QACtB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;YAChD,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,gCAAgC,KAAK,EAAE,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,OAAmB;QAClC,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;;AA3GH,kCA4GC;AA3GiB,mBAAO,GAAG,OAAO,CAAC"}

package/dist/protocol/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Inter-Agent Protocol (I.A.P.) v1.0.0
+ *
+ * Main entry point for the protocol implementation
+ */
+export * from './types';
+export * from './validators';
+export * from './flows';
+export * from './utils';
+export declare const IAP_VERSION = "1.0.0";
+export declare const IAP_NAME = "Inter-Agent Protocol";
+/**
+ * Protocol metadata
+ */
+export declare const PROTOCOL_INFO: {
+    name: string;
+    version: string;
+    description: string;
+    repository: string;
+    documentation: string;
+    license: string;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/protocol/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,SAAS,CAAC;AAGxB,cAAc,cAAc,CAAC;AAG7B,cAAc,SAAS,CAAC;AAGxB,cAAc,SAAS,CAAC;AAGxB,eAAO,MAAM,WAAW,UAAU,CAAC;AACnC,eAAO,MAAM,QAAQ,yBAAyB,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;CAOzB,CAAC"}

package/dist/protocol/index.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * Inter-Agent Protocol (I.A.P.) v1.0.0
+ *
+ * Main entry point for the protocol implementation
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROTOCOL_INFO = exports.IAP_NAME = exports.IAP_VERSION = void 0;
+// Export all types
+__exportStar(require("./types"), exports);
+// Export validators
+__exportStar(require("./validators"), exports);
+// Export flows
+__exportStar(require("./flows"), exports);
+// Export utilities
+__exportStar(require("./utils"), exports);
+// Version information
+exports.IAP_VERSION = '1.0.0';
+exports.IAP_NAME = 'Inter-Agent Protocol';
+/**
+ * Protocol metadata
+ */
+exports.PROTOCOL_INFO = {
+    name: exports.IAP_NAME,
+    version: exports.IAP_VERSION,
+    description: 'Standardized communication protocol for autonomous AI agents',
+    repository: 'https://github.com/subconscious-router/iap',
+    documentation: 'https://docs.subconscious-router.dev/iap',
+    license: 'MIT'
+};
+//# sourceMappingURL=index.js.map

package/dist/protocol/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/protocol/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;;AAEH,mBAAmB;AACnB,0CAAwB;AAExB,oBAAoB;AACpB,+CAA6B;AAE7B,eAAe;AACf,0CAAwB;AAExB,mBAAmB;AACnB,0CAAwB;AAExB,sBAAsB;AACT,QAAA,WAAW,GAAG,OAAO,CAAC;AACtB,QAAA,QAAQ,GAAG,sBAAsB,CAAC;AAE/C;;GAEG;AACU,QAAA,aAAa,GAAG;IAC3B,IAAI,EAAE,gBAAQ;IACd,OAAO,EAAE,mBAAW;IACpB,WAAW,EAAE,8DAA8D;IAC3E,UAAU,EAAE,4CAA4C;IACxD,aAAa,EAAE,0CAA0C;IACzD,OAAO,EAAE,KAAK;CACf,CAAC"}

package/dist/protocol/types.d.ts

@@ -0,0 +1,332 @@
+/**
+ * Inter-Agent Protocol (I.A.P.) v1.0.0
+ *
+ * TypeScript type definitions for standardized agent-to-agent communication
+ * via the Subconscious Router.
+ */
+/**
+ * Unique identifier for agents in the network
+ */
+export type AgentId = string;
+/**
+ * Unique identifier for tasks
+ */
+export type TaskId = string;
+/**
+ * Unique identifier for messages
+ */
+export type MessageId = string;
+/**
+ * Timestamp in ISO 8601 format
+ */
+export type Timestamp = string;
+/**
+ * Capability types that agents can advertise
+ */
+export declare enum CapabilityType {
+    TEXT_GENERATION = "text_generation",
+    CODE_EXECUTION = "code_execution",
+    WEB_SEARCH = "web_search",
+    DATA_ANALYSIS = "data_analysis",
+    IMAGE_GENERATION = "image_generation",
+    FILE_OPERATIONS = "file_operations",
+    API_INTEGRATION = "api_integration",
+    CUSTOM = "custom"
+}
+/**
+ * Message types in the I.A.P. protocol
+ */
+export declare enum MessageType {
+    HANDSHAKE = "handshake",
+    HANDSHAKE_ACK = "handshake_ack",
+    CAPABILITY_DISCOVERY = "capability_discovery",
+    CAPABILITY_RESPONSE = "capability_response",
+    TASK_PROPOSAL = "task_proposal",
+    TASK_BID = "task_bid",
+    TASK_ASSIGNMENT = "task_assignment",
+    TASK_ACCEPTANCE = "task_acceptance",
+    TASK_REJECTION = "task_rejection",
+    CONTEXT_TRANSFER = "context_transfer",
+    TASK_RESULT = "task_result",
+    ERROR = "error",
+    HEARTBEAT = "heartbeat",
+    DISCONNECT = "disconnect"
+}
+/**
+ * Status of a task in the system
+ */
+export declare enum TaskStatus {
+    PROPOSED = "proposed",
+    BIDDING = "bidding",
+    ASSIGNED = "assigned",
+    IN_PROGRESS = "in_progress",
+    COMPLETED = "completed",
+    FAILED = "failed",
+    CANCELLED = "cancelled"
+}
+/**
+ * Describes a specific capability/tool available to an agent
+ */
+export interface AgentCapability {
+    /** Unique identifier for this capability */
+    id: string;
+    /** Type of capability */
+    type: CapabilityType;
+    /** Human-readable name */
+    name: string;
+    /** Detailed description of what this capability does */
+    description: string;
+    /** JSON Schema describing input parameters */
+    inputSchema?: Record<string, any>;
+    /** JSON Schema describing output format */
+    outputSchema?: Record<string, any>;
+    /** Estimated cost in tokens or API credits */
+    estimatedCost?: number;
+    /** Average execution time in milliseconds */
+    averageLatency?: number;
+    /** Additional metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * Initial handshake message sent by an agent joining the network
+ */
+export interface AgentHandshake {
+    /** Unique identifier for this agent */
+    agentId: AgentId;
+    /** Human-readable agent name */
+    name: string;
+    /** Agent version (semantic versioning) */
+    version: string;
+    /** Framework or platform (e.g., "LangChain", "CrewAI", "AutoGPT") */
+    framework?: string;
+    /** List of capabilities this agent provides */
+    capabilities: AgentCapability[];
+    /** Maximum concurrent tasks this agent can handle */
+    maxConcurrentTasks?: number;
+    /** Agent's current load (0.0 to 1.0) */
+    currentLoad?: number;
+    /** Additional metadata about the agent */
+    metadata?: Record<string, any>;
+    /** Protocol version this agent supports */
+    protocolVersion: string;
+}
+/**
+ * Acknowledgment of successful handshake
+ */
+export interface HandshakeAck {
+    /** Router's acknowledgment */
+    success: boolean;
+    /** Assigned session ID */
+    sessionId: string;
+    /** Router version */
+    routerVersion: string;
+    /** Number of currently connected agents */
+    connectedAgents: number;
+    /** Optional welcome message or instructions */
+    message?: string;
+}
+/**
+ * Request to discover available capabilities in the network
+ */
+export interface CapabilityDiscovery {
+    /** Agent requesting discovery */
+    requesterId: AgentId;
+    /** Optional filter by capability type */
+    filterByType?: CapabilityType[];
+    /** Optional filter by minimum performance criteria */
+    minPerformance?: {
+        maxLatency?: number;
+        maxCost?: number;
+    };
+}
+/**
+ * Response containing available capabilities
+ */
+export interface CapabilityResponse {
+    /** Map of agent IDs to their capabilities */
+    agents: Record<AgentId, {
+        name: string;
+        capabilities: AgentCapability[];
+        currentLoad: number;
+    }>;
+    /** Total number of available agents */
+    totalAgents: number;
+    /** Timestamp of response */
+    timestamp: Timestamp;
+}
+/**
+ * Proposal for a task to be executed
+ */
+export interface TaskProposal {
+    /** Unique task identifier */
+    taskId: TaskId;
+    /** Agent proposing the task */
+    proposerId: AgentId;
+    /** Human-readable task description */
+    description: string;
+    /** Required capability type */
+    requiredCapability: CapabilityType;
+    /** Specific capability ID if known */
+    specificCapabilityId?: string;
+    /** Input parameters for the task */
+    input: Record<string, any>;
+    /** Maximum acceptable latency in milliseconds */
+    maxLatency?: number;
+    /** Maximum acceptable cost */
+    maxCost?: number;
+    /** Priority level (1-10, higher is more urgent) */
+    priority?: number;
+    /** Deadline for task completion */
+    deadline?: Timestamp;
+    /** Context data needed for execution */
+    context?: Record<string, any>;
+}
+/**
+ * Bid from an agent to execute a proposed task
+ */
+export interface TaskBid {
+    /** Reference to the task being bid on */
+    taskId: TaskId;
+    /** Agent making the bid */
+    bidderId: AgentId;
+    /** Estimated execution time in milliseconds */
+    estimatedLatency: number;
+    /** Estimated cost in tokens or credits */
+    estimatedCost: number;
+    /** Confidence score (0.0 to 1.0) in successful execution */
+    confidence: number;
+    /** Agent's current queue depth */
+    queueDepth: number;
+    /** Earliest time the agent can start (if queued) */
+    earliestStartTime?: Timestamp;
+    /** Additional notes or conditions */
+    notes?: string;
+}
+/**
+ * Assignment of a task to a specific agent
+ */
+export interface TaskAssignment {
+    /** Task being assigned */
+    taskId: TaskId;
+    /** Agent assigned to execute */
+    assignedTo: AgentId;
+    /** Original proposer */
+    proposerId: AgentId;
+    /** Timestamp of assignment */
+    assignedAt: Timestamp;
+    /** Expected completion time */
+    expectedCompletion?: Timestamp;
+}
+/**
+ * Transfer of context/state between agents
+ */
+export interface ContextTransfer {
+    /** Source agent */
+    fromAgent: AgentId;
+    /** Destination agent */
+    toAgent: AgentId;
+    /** Related task ID */
+    taskId: TaskId;
+    /** Context type identifier */
+    contextType: string;
+    /** The actual context data */
+    data: Record<string, any>;
+    /** Optional embedding vector for semantic indexing */
+    embedding?: number[];
+    /** Compression format if data is compressed */
+    compression?: 'gzip' | 'brotli' | 'none';
+    /** Checksum for data integrity */
+    checksum?: string;
+}
+/**
+ * Result of a completed task
+ */
+export interface TaskResult {
+    /** Task that was completed */
+    taskId: TaskId;
+    /** Agent that executed the task */
+    executorId: AgentId;
+    /** Execution status */
+    status: TaskStatus;
+    /** Output data */
+    output?: Record<string, any>;
+    /** Error information if failed */
+    error?: {
+        code: string;
+        message: string;
+        details?: any;
+    };
+    /** Actual execution time in milliseconds */
+    actualLatency: number;
+    /** Actual cost incurred */
+    actualCost: number;
+    /** Timestamp of completion */
+    completedAt: Timestamp;
+    /** Optional metadata about execution */
+    metadata?: Record<string, any>;
+}
+/**
+ * Error message
+ */
+export interface ErrorMessage {
+    /** Error code */
+    code: string;
+    /** Human-readable error message */
+    message: string;
+    /** Related message ID if applicable */
+    relatedMessageId?: MessageId;
+    /** Related task ID if applicable */
+    relatedTaskId?: TaskId;
+    /** Additional error details */
+    details?: any;
+    /** Whether the error is recoverable */
+    recoverable: boolean;
+}
+/**
+ * Base message structure for all I.A.P. messages
+ */
+export interface IAPMessage {
+    /** Unique message identifier */
+    messageId: MessageId;
+    /** Type of message */
+    type: MessageType;
+    /** Sender agent ID */
+    from: AgentId;
+    /** Recipient agent ID (or 'router' for broadcast) */
+    to: AgentId | 'router';
+    /** Message timestamp */
+    timestamp: Timestamp;
+    /** Protocol version */
+    protocolVersion: string;
+    /** Message payload (type depends on message type) */
+    payload: AgentHandshake | HandshakeAck | CapabilityDiscovery | CapabilityResponse | TaskProposal | TaskBid | TaskAssignment | TaskResult | ContextTransfer | ErrorMessage | Record<string, any>;
+    /** Optional correlation ID for request-response tracking */
+    correlationId?: string;
+    /** Optional metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * Heartbeat message to maintain connection
+ */
+export interface Heartbeat {
+    /** Agent sending heartbeat */
+    agentId: AgentId;
+    /** Current load (0.0 to 1.0) */
+    currentLoad: number;
+    /** Number of active tasks */
+    activeTasks: number;
+    /** Uptime in seconds */
+    uptime: number;
+}
+/**
+ * Disconnect notification
+ */
+export interface DisconnectMessage {
+    /** Agent disconnecting */
+    agentId: AgentId;
+    /** Reason for disconnect */
+    reason: string;
+    /** Whether disconnect is graceful */
+    graceful: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/protocol/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/protocol/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC;AAE5B;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B;;GAEG;AACH,oBAAY,cAAc;IACxB,eAAe,oBAAoB;IACnC,cAAc,mBAAmB;IACjC,UAAU,eAAe;IACzB,aAAa,kBAAkB;IAC/B,gBAAgB,qBAAqB;IACrC,eAAe,oBAAoB;IACnC,eAAe,oBAAoB;IACnC,MAAM,WAAW;CAClB;AAED;;GAEG;AACH,oBAAY,WAAW;IACrB,SAAS,cAAc;IACvB,aAAa,kBAAkB;IAC/B,oBAAoB,yBAAyB;IAC7C,mBAAmB,wBAAwB;IAC3C,aAAa,kBAAkB;IAC/B,QAAQ,aAAa;IACrB,eAAe,oBAAoB;IACnC,eAAe,oBAAoB;IACnC,cAAc,mBAAmB;IACjC,gBAAgB,qBAAqB;IACrC,WAAW,gBAAgB;IAC3B,KAAK,UAAU;IACf,SAAS,cAAc;IACvB,UAAU,eAAe;CAC1B;AAED;;GAEG;AACH,oBAAY,UAAU;IACpB,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,WAAW,gBAAgB;IAC3B,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,SAAS,cAAc;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAC;IAEX,yBAAyB;IACzB,IAAI,EAAE,cAAc,CAAC;IAErB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IAEb,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IAEpB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAElC,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEnC,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IAEjB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IAEb,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAEhB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,+CAA+C;IAC/C,YAAY,EAAE,eAAe,EAAE,CAAC;IAEhC,qDAAqD;IACrD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE/B,2CAA2C;IAC3C,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,OAAO,EAAE,OAAO,CAAC;IAEjB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAElB,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAC;IAEtB,2CAA2C;IAC3C,eAAe,EAAE,MAAM,CAAC;IAExB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iCAAiC;IACjC,WAAW,EAAE,OAAO,CAAC;IAErB,yCAAyC;IACzC,YAAY,CAAC,EAAE,cAAc,EAAE,CAAC;IAEhC,sDAAsD;IACtD,cAAc,CAAC,EAAE;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,eAAe,EAAE,CAAC;QAChC,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IAEH,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IAEpB,4BAA4B;IAC5B,SAAS,EAAE,SAAS,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IAEf,+BAA+B;IAC/B,UAAU,EAAE,OAAO,CAAC;IAEpB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IAEpB,+BAA+B;IAC/B,kBAAkB,EAAE,cAAc,CAAC;IAEnC,sCAAsC;IACtC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE3B,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IAEf,2BAA2B;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAElB,+CAA+C;IAC/C,gBAAgB,EAAE,MAAM,CAAC;IAEzB,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAC;IAEtB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IAEnB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IAEnB,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,SAAS,CAAC;IAE9B,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IAEf,gCAAgC;IAChC,UAAU,EAAE,OAAO,CAAC;IAEpB,wBAAwB;IACxB,UAAU,EAAE,OAAO,CAAC;IAEpB,8BAA8B;IAC9B,UAAU,EAAE,SAAS,CAAC;IAEtB,+BAA+B;IAC/B,kBAAkB,CAAC,EAAE,SAAS,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mBAAmB;IACnB,SAAS,EAAE,OAAO,CAAC;IAEnB,wBAAwB;IACxB,OAAO,EAAE,OAAO,CAAC;IAEjB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IAEf,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;IAEpB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE1B,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IAEzC,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IAEf,mCAAmC;IACnC,UAAU,EAAE,OAAO,CAAC;IAEpB,uBAAuB;IACvB,MAAM,EAAE,UAAU,CAAC;IAEnB,kBAAkB;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE7B,kCAAkC;IAClC,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,GAAG,CAAC;KACf,CAAC;IAEF,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAC;IAEtB,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IAEnB,8BAA8B;IAC9B,WAAW,EAAE,SAAS,CAAC;IAEvB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IAEb,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAEhB,uCAAuC;IACvC,gBAAgB,CAAC,EAAE,SAAS,CAAC;IAE7B,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,GAAG,CAAC;IAEd,uCAAuC;IACvC,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,gCAAgC;IAChC,SAAS,EAAE,SAAS,CAAC;IAErB,sBAAsB;IACtB,IAAI,EAAE,WAAW,CAAC;IAElB,sBAAsB;IACtB,IAAI,EAAE,OAAO,CAAC;IAEd,qDAAqD;IACrD,EAAE,EAAE,OAAO,GAAG,QAAQ,CAAC;IAEvB,wBAAwB;IACxB,SAAS,EAAE,SAAS,CAAC;IAErB,uBAAuB;IACvB,eAAe,EAAE,MAAM,CAAC;IAExB,qDAAqD;IACrD,OAAO,EACH,cAAc,GACd,YAAY,GACZ,mBAAmB,GACnB,kBAAkB,GAClB,YAAY,GACZ,OAAO,GACP,cAAc,GACd,UAAU,GACV,eAAe,GACf,YAAY,GACZ,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAExB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,8BAA8B;IAC9B,OAAO,EAAE,OAAO,CAAC;IAEjB,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;IAEpB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IAEpB,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,OAAO,EAAE,OAAO,CAAC;IAEjB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IAEf,qCAAqC;IACrC,QAAQ,EAAE,OAAO,CAAC;CACnB"}

package/dist/protocol/types.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * Inter-Agent Protocol (I.A.P.) v1.0.0
+ *
+ * TypeScript type definitions for standardized agent-to-agent communication
+ * via the Subconscious Router.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaskStatus = exports.MessageType = exports.CapabilityType = void 0;
+/**
+ * Capability types that agents can advertise
+ */
+var CapabilityType;
+(function (CapabilityType) {
+    CapabilityType["TEXT_GENERATION"] = "text_generation";
+    CapabilityType["CODE_EXECUTION"] = "code_execution";
+    CapabilityType["WEB_SEARCH"] = "web_search";
+    CapabilityType["DATA_ANALYSIS"] = "data_analysis";
+    CapabilityType["IMAGE_GENERATION"] = "image_generation";
+    CapabilityType["FILE_OPERATIONS"] = "file_operations";
+    CapabilityType["API_INTEGRATION"] = "api_integration";
+    CapabilityType["CUSTOM"] = "custom";
+})(CapabilityType || (exports.CapabilityType = CapabilityType = {}));
+/**
+ * Message types in the I.A.P. protocol
+ */
+var MessageType;
+(function (MessageType) {
+    MessageType["HANDSHAKE"] = "handshake";
+    MessageType["HANDSHAKE_ACK"] = "handshake_ack";
+    MessageType["CAPABILITY_DISCOVERY"] = "capability_discovery";
+    MessageType["CAPABILITY_RESPONSE"] = "capability_response";
+    MessageType["TASK_PROPOSAL"] = "task_proposal";
+    MessageType["TASK_BID"] = "task_bid";
+    MessageType["TASK_ASSIGNMENT"] = "task_assignment";
+    MessageType["TASK_ACCEPTANCE"] = "task_acceptance";
+    MessageType["TASK_REJECTION"] = "task_rejection";
+    MessageType["CONTEXT_TRANSFER"] = "context_transfer";
+    MessageType["TASK_RESULT"] = "task_result";
+    MessageType["ERROR"] = "error";
+    MessageType["HEARTBEAT"] = "heartbeat";
+    MessageType["DISCONNECT"] = "disconnect";
+})(MessageType || (exports.MessageType = MessageType = {}));
+/**
+ * Status of a task in the system
+ */
+var TaskStatus;
+(function (TaskStatus) {
+    TaskStatus["PROPOSED"] = "proposed";
+    TaskStatus["BIDDING"] = "bidding";
+    TaskStatus["ASSIGNED"] = "assigned";
+    TaskStatus["IN_PROGRESS"] = "in_progress";
+    TaskStatus["COMPLETED"] = "completed";
+    TaskStatus["FAILED"] = "failed";
+    TaskStatus["CANCELLED"] = "cancelled";
+})(TaskStatus || (exports.TaskStatus = TaskStatus = {}));
+//# sourceMappingURL=types.js.map

package/dist/protocol/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/protocol/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAsBH;;GAEG;AACH,IAAY,cASX;AATD,WAAY,cAAc;IACxB,qDAAmC,CAAA;IACnC,mDAAiC,CAAA;IACjC,2CAAyB,CAAA;IACzB,iDAA+B,CAAA;IAC/B,uDAAqC,CAAA;IACrC,qDAAmC,CAAA;IACnC,qDAAmC,CAAA;IACnC,mCAAiB,CAAA;AACnB,CAAC,EATW,cAAc,8BAAd,cAAc,QASzB;AAED;;GAEG;AACH,IAAY,WAeX;AAfD,WAAY,WAAW;IACrB,sCAAuB,CAAA;IACvB,8CAA+B,CAAA;IAC/B,4DAA6C,CAAA;IAC7C,0DAA2C,CAAA;IAC3C,8CAA+B,CAAA;IAC/B,oCAAqB,CAAA;IACrB,kDAAmC,CAAA;IACnC,kDAAmC,CAAA;IACnC,gDAAiC,CAAA;IACjC,oDAAqC,CAAA;IACrC,0CAA2B,CAAA;IAC3B,8BAAe,CAAA;IACf,sCAAuB,CAAA;IACvB,wCAAyB,CAAA;AAC3B,CAAC,EAfW,WAAW,2BAAX,WAAW,QAetB;AAED;;GAEG;AACH,IAAY,UAQX;AARD,WAAY,UAAU;IACpB,mCAAqB,CAAA;IACrB,iCAAmB,CAAA;IACnB,mCAAqB,CAAA;IACrB,yCAA2B,CAAA;IAC3B,qCAAuB,CAAA;IACvB,+BAAiB,CAAA;IACjB,qCAAuB,CAAA;AACzB,CAAC,EARW,UAAU,0BAAV,UAAU,QAQrB"}