@nxuss/lemma 0.1.0 → 0.2.0

package/dist/esm/protocol/flows.js

@@ -0,0 +1,338 @@
+/**
+ * Inter-Agent Protocol (I.A.P.) v1.0.0
+ *
+ * Protocol flow definitions and state machine logic
+ */
+import { MessageType, TaskStatus } from './types';
+/**
+ * Protocol flow states
+ */
+export var FlowState;
+(function (FlowState) {
+    // Connection flow
+    FlowState["DISCONNECTED"] = "disconnected";
+    FlowState["HANDSHAKING"] = "handshaking";
+    FlowState["CONNECTED"] = "connected";
+    // Task flow
+    FlowState["IDLE"] = "idle";
+    FlowState["DISCOVERING"] = "discovering";
+    FlowState["PROPOSING"] = "proposing";
+    FlowState["BIDDING"] = "bidding";
+    FlowState["ASSIGNING"] = "assigning";
+    FlowState["EXECUTING"] = "executing";
+    FlowState["TRANSFERRING_CONTEXT"] = "transferring_context";
+    FlowState["COMPLETING"] = "completing";
+    // Error states
+    FlowState["ERROR"] = "error";
+    FlowState["DISCONNECTING"] = "disconnecting";
+})(FlowState || (FlowState = {}));
+/**
+ * Valid state transitions
+ */
+export const VALID_TRANSITIONS = {
+    [FlowState.DISCONNECTED]: [FlowState.HANDSHAKING],
+    [FlowState.HANDSHAKING]: [FlowState.CONNECTED, FlowState.ERROR, FlowState.DISCONNECTED],
+    [FlowState.CONNECTED]: [FlowState.IDLE, FlowState.DISCOVERING, FlowState.DISCONNECTING],
+    [FlowState.IDLE]: [FlowState.DISCOVERING, FlowState.PROPOSING, FlowState.DISCONNECTING],
+    [FlowState.DISCOVERING]: [FlowState.IDLE, FlowState.PROPOSING, FlowState.ERROR],
+    [FlowState.PROPOSING]: [FlowState.BIDDING, FlowState.IDLE, FlowState.ERROR],
+    [FlowState.BIDDING]: [FlowState.ASSIGNING, FlowState.IDLE, FlowState.ERROR],
+    [FlowState.ASSIGNING]: [FlowState.EXECUTING, FlowState.ERROR],
+    [FlowState.EXECUTING]: [FlowState.TRANSFERRING_CONTEXT, FlowState.COMPLETING, FlowState.ERROR],
+    [FlowState.TRANSFERRING_CONTEXT]: [FlowState.EXECUTING, FlowState.COMPLETING, FlowState.ERROR],
+    [FlowState.COMPLETING]: [FlowState.IDLE],
+    [FlowState.ERROR]: [FlowState.IDLE, FlowState.DISCONNECTING],
+    [FlowState.DISCONNECTING]: [FlowState.DISCONNECTED]
+};
+/**
+ * Message type to state mapping
+ */
+export const MESSAGE_TO_STATE = {
+    [MessageType.HANDSHAKE]: FlowState.HANDSHAKING,
+    [MessageType.HANDSHAKE_ACK]: FlowState.CONNECTED,
+    [MessageType.CAPABILITY_DISCOVERY]: FlowState.DISCOVERING,
+    [MessageType.CAPABILITY_RESPONSE]: FlowState.IDLE,
+    [MessageType.TASK_PROPOSAL]: FlowState.PROPOSING,
+    [MessageType.TASK_BID]: FlowState.BIDDING,
+    [MessageType.TASK_ASSIGNMENT]: FlowState.ASSIGNING,
+    [MessageType.TASK_ACCEPTANCE]: FlowState.EXECUTING,
+    [MessageType.TASK_REJECTION]: FlowState.IDLE,
+    [MessageType.CONTEXT_TRANSFER]: FlowState.TRANSFERRING_CONTEXT,
+    [MessageType.TASK_RESULT]: FlowState.COMPLETING,
+    [MessageType.ERROR]: FlowState.ERROR,
+    [MessageType.HEARTBEAT]: FlowState.CONNECTED,
+    [MessageType.DISCONNECT]: FlowState.DISCONNECTING
+};
+/**
+ * Connection Flow: Agent joins the network
+ */
+export const CONNECTION_FLOW = {
+    name: 'Connection Flow',
+    description: 'Agent handshake and registration with the router',
+    steps: [
+        {
+            step: 1,
+            actor: 'agent',
+            messageType: MessageType.HANDSHAKE,
+            description: 'Agent sends handshake with capabilities',
+            required: true,
+            nextSteps: [2]
+        },
+        {
+            step: 2,
+            actor: 'router',
+            messageType: MessageType.HANDSHAKE_ACK,
+            description: 'Router acknowledges and assigns session',
+            required: true,
+            nextSteps: [3]
+        },
+        {
+            step: 3,
+            actor: 'agent',
+            messageType: MessageType.HEARTBEAT,
+            description: 'Agent sends periodic heartbeats',
+            required: true,
+            nextSteps: [3, 4]
+        },
+        {
+            step: 4,
+            actor: 'agent',
+            messageType: MessageType.DISCONNECT,
+            description: 'Agent gracefully disconnects',
+            required: false,
+            nextSteps: []
+        }
+    ]
+};
+/**
+ * Discovery Flow: Agent discovers available capabilities
+ */
+export const DISCOVERY_FLOW = {
+    name: 'Discovery Flow',
+    description: 'Agent queries available capabilities in the network',
+    steps: [
+        {
+            step: 1,
+            actor: 'agent',
+            messageType: MessageType.CAPABILITY_DISCOVERY,
+            description: 'Agent requests capability information',
+            required: true,
+            nextSteps: [2]
+        },
+        {
+            step: 2,
+            actor: 'router',
+            messageType: MessageType.CAPABILITY_RESPONSE,
+            description: 'Router responds with available agents and capabilities',
+            required: true,
+            nextSteps: []
+        }
+    ]
+};
+/**
+ * Task Negotiation Flow: Task proposal, bidding, and assignment
+ */
+export const TASK_NEGOTIATION_FLOW = {
+    name: 'Task Negotiation Flow',
+    description: 'Complete flow from task proposal to assignment',
+    steps: [
+        {
+            step: 1,
+            actor: 'agent',
+            messageType: MessageType.TASK_PROPOSAL,
+            description: 'Agent proposes a task to be executed',
+            required: true,
+            nextSteps: [2]
+        },
+        {
+            step: 2,
+            actor: 'router',
+            messageType: MessageType.TASK_PROPOSAL,
+            description: 'Router broadcasts task to capable agents',
+            required: true,
+            nextSteps: [3]
+        },
+        {
+            step: 3,
+            actor: 'agent',
+            messageType: MessageType.TASK_BID,
+            description: 'Capable agents submit bids',
+            required: true,
+            nextSteps: [4]
+        },
+        {
+            step: 4,
+            actor: 'router',
+            messageType: MessageType.TASK_ASSIGNMENT,
+            description: 'Router assigns task to best bidder',
+            required: true,
+            nextSteps: [5, 6]
+        },
+        {
+            step: 5,
+            actor: 'agent',
+            messageType: MessageType.TASK_ACCEPTANCE,
+            description: 'Assigned agent accepts the task',
+            required: true,
+            nextSteps: [7]
+        },
+        {
+            step: 6,
+            actor: 'agent',
+            messageType: MessageType.TASK_REJECTION,
+            description: 'Assigned agent rejects (fallback to next bidder)',
+            required: false,
+            nextSteps: [4]
+        },
+        {
+            step: 7,
+            actor: 'agent',
+            messageType: MessageType.TASK_RESULT,
+            description: 'Agent returns task result',
+            required: true,
+            nextSteps: []
+        }
+    ]
+};
+/**
+ * Context Transfer Flow: Stateful handoff between agents
+ */
+export const CONTEXT_TRANSFER_FLOW = {
+    name: 'Context Transfer Flow',
+    description: 'Transfer execution context between agents',
+    steps: [
+        {
+            step: 1,
+            actor: 'agent',
+            messageType: MessageType.CONTEXT_TRANSFER,
+            description: 'Source agent sends context to router',
+            required: true,
+            nextSteps: [2]
+        },
+        {
+            step: 2,
+            actor: 'router',
+            messageType: MessageType.CONTEXT_TRANSFER,
+            description: 'Router forwards context to destination agent',
+            required: true,
+            nextSteps: []
+        }
+    ]
+};
+/**
+ * Validates if a state transition is allowed
+ */
+export function isValidTransition(from, to) {
+    const allowedTransitions = VALID_TRANSITIONS[from];
+    return allowedTransitions ? allowedTransitions.includes(to) : false;
+}
+/**
+ * Gets the expected state for a message type
+ */
+export function getStateForMessage(messageType) {
+    return MESSAGE_TO_STATE[messageType] || FlowState.ERROR;
+}
+/**
+ * Determines the next expected message types for a given state
+ */
+export function getExpectedMessages(state) {
+    const expectedMessages = [];
+    for (const [messageType, targetState] of Object.entries(MESSAGE_TO_STATE)) {
+        if (isValidTransition(state, targetState)) {
+            expectedMessages.push(messageType);
+        }
+    }
+    return expectedMessages;
+}
+/**
+ * Task lifecycle tracker
+ */
+export class TaskLifecycle {
+    constructor() {
+        this.taskStates = new Map();
+        this.taskHistory = new Map();
+    }
+    /**
+     * Updates task status
+     */
+    updateStatus(taskId, status) {
+        const currentStatus = this.taskStates.get(taskId);
+        // Validate transition
+        if (currentStatus && !this.isValidTaskTransition(currentStatus, status)) {
+            throw new Error(`Invalid task transition: ${currentStatus} -> ${status} for task ${taskId}`);
+        }
+        this.taskStates.set(taskId, status);
+        // Track history
+        const history = this.taskHistory.get(taskId) || [];
+        history.push(status);
+        this.taskHistory.set(taskId, history);
+    }
+    /**
+     * Gets current task status
+     */
+    getStatus(taskId) {
+        return this.taskStates.get(taskId);
+    }
+    /**
+     * Gets task history
+     */
+    getHistory(taskId) {
+        return this.taskHistory.get(taskId) || [];
+    }
+    /**
+     * Validates task status transition
+     */
+    isValidTaskTransition(from, to) {
+        const validTransitions = {
+            [TaskStatus.PROPOSED]: [TaskStatus.BIDDING, TaskStatus.CANCELLED],
+            [TaskStatus.BIDDING]: [TaskStatus.ASSIGNED, TaskStatus.CANCELLED],
+            [TaskStatus.ASSIGNED]: [TaskStatus.IN_PROGRESS, TaskStatus.CANCELLED],
+            [TaskStatus.IN_PROGRESS]: [TaskStatus.COMPLETED, TaskStatus.FAILED, TaskStatus.CANCELLED],
+            [TaskStatus.COMPLETED]: [],
+            [TaskStatus.FAILED]: [],
+            [TaskStatus.CANCELLED]: []
+        };
+        return validTransitions[from]?.includes(to) || false;
+    }
+    /**
+     * Removes completed or failed tasks
+     */
+    cleanup(olderThanMs = 3600000) {
+        const now = Date.now();
+        const cutoff = now - olderThanMs;
+        // This is a simplified cleanup - in production, you'd track timestamps
+        for (const [taskId, status] of this.taskStates.entries()) {
+            if (status === TaskStatus.COMPLETED || status === TaskStatus.FAILED) {
+                this.taskStates.delete(taskId);
+                this.taskHistory.delete(taskId);
+            }
+        }
+    }
+}
+/**
+ * Creates a new flow context
+ */
+export function createFlowContext(agentId) {
+    return {
+        currentState: FlowState.DISCONNECTED,
+        agentId,
+        lastTransitionTime: Date.now()
+    };
+}
+/**
+ * Transitions flow context to a new state
+ */
+export function transitionFlow(context, messageType) {
+    const newState = getStateForMessage(messageType);
+    if (!isValidTransition(context.currentState, newState)) {
+        throw new Error(`Invalid flow transition: ${context.currentState} -> ${newState} ` +
+            `(message: ${messageType})`);
+    }
+    return {
+        ...context,
+        currentState: newState,
+        lastMessageType: messageType,
+        lastTransitionTime: Date.now()
+    };
+}
+//# sourceMappingURL=flows.js.map

package/dist/esm/protocol/flows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flows.js","sourceRoot":"","sources":["../../../src/protocol/flows.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEL,WAAW,EACX,UAAU,EAGX,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,MAAM,CAAN,IAAY,SAmBX;AAnBD,WAAY,SAAS;IACnB,kBAAkB;IAClB,0CAA6B,CAAA;IAC7B,wCAA2B,CAAA;IAC3B,oCAAuB,CAAA;IAEvB,YAAY;IACZ,0BAAa,CAAA;IACb,wCAA2B,CAAA;IAC3B,oCAAuB,CAAA;IACvB,gCAAmB,CAAA;IACnB,oCAAuB,CAAA;IACvB,oCAAuB,CAAA;IACvB,0DAA6C,CAAA;IAC7C,sCAAyB,CAAA;IAEzB,eAAe;IACf,4BAAe,CAAA;IACf,4CAA+B,CAAA;AACjC,CAAC,EAnBW,SAAS,KAAT,SAAS,QAmBpB;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAmC;IAC/D,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC;IACjD,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,YAAY,CAAC;IACvF,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,aAAa,CAAC;IACvF,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,aAAa,CAAC;IACvF,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC;IAC/E,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC;IAC3E,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC;IAC3E,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC;IAC7D,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,oBAAoB,EAAE,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC,KAAK,CAAC;IAC9F,CAAC,SAAS,CAAC,oBAAoB,CAAC,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC,KAAK,CAAC;IAC9F,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC;IACxC,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,aAAa,CAAC;IAC5D,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,CAAC,SAAS,CAAC,YAAY,CAAC;CACpD,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAmC;IAC9D,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,WAAW;IAC9C,CAAC,WAAW,CAAC,aAAa,CAAC,EAAE,SAAS,CAAC,SAAS;IAChD,CAAC,WAAW,CAAC,oBAAoB,CAAC,EAAE,SAAS,CAAC,WAAW;IACzD,CAAC,WAAW,CAAC,mBAAmB,CAAC,EAAE,SAAS,CAAC,IAAI;IACjD,CAAC,WAAW,CAAC,aAAa,CAAC,EAAE,SAAS,CAAC,SAAS;IAChD,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,OAAO;IACzC,CAAC,WAAW,CAAC,eAAe,CAAC,EAAE,SAAS,CAAC,SAAS;IAClD,CAAC,WAAW,CAAC,eAAe,CAAC,EAAE,SAAS,CAAC,SAAS;IAClD,CAAC,WAAW,CAAC,cAAc,CAAC,EAAE,SAAS,CAAC,IAAI;IAC5C,CAAC,WAAW,CAAC,gBAAgB,CAAC,EAAE,SAAS,CAAC,oBAAoB;IAC9D,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC,UAAU;IAC/C,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,KAAK;IACpC,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,SAAS;IAC5C,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC,aAAa;CAClD,CAAC;AAuBF;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAiB;IAC3C,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,kDAAkD;IAC/D,KAAK,EAAE;QACL;YACE,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,OAAO;YACd,WAAW,EAAE,WAAW,CAAC,SAAS;YAClC,WAAW,EAAE,yCAAyC;YACtD,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,CAAC,CAAC,CAAC;SACf;QACD;YACE,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,QAAQ;YACf,WAAW,EAAE,WAAW,CAAC,aAAa;YACtC,WAAW,EAAE,yCAAyC;YACtD,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,CAAC,CAAC,CAAC;SACf;QACD;YACE,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,OAAO;YACd,WAAW,EAAE,WAAW,CAAC,SAAS;YAClC,WAAW,EAAE,iCAAiC;YAC9C,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;SAClB;QACD;YACE,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,OAAO;YACd,WAAW,EAAE,WAAW,CAAC,UAAU;YACnC,WAAW,EAAE,8BAA8B;YAC3C,QAAQ,EAAE,KAAK;YACf,SAAS,EAAE,EAAE;SACd;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAiB;IAC1C,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,qDAAqD;IAClE,KAAK,EAAE;QACL;YACE,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,OAAO;YACd,WAAW,EAAE,WAAW,CAAC,oBAAoB;YAC7C,WAAW,EAAE,uCAAuC;YACpD,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,CAAC,CAAC,CAAC;SACf;QACD;YACE,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,QAAQ;YACf,WAAW,EAAE,WAAW,CAAC,mBAAmB;YAC5C,WAAW,EAAE,wDAAwD;YACrE,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,EAAE;SACd;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAiB;IACjD,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,gDAAgD;IAC7D,KAAK,EAAE;QACL;YACE,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,OAAO;YACd,WAAW,EAAE,WAAW,CAAC,aAAa;YACtC,WAAW,EAAE,sCAAsC;YACnD,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,CAAC,CAAC,CAAC;SACf;QACD;YACE,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,QAAQ;YACf,WAAW,EAAE,WAAW,CAAC,aAAa;YACtC,WAAW,EAAE,0CAA0C;YACvD,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,CAAC,CAAC,CAAC;SACf;QACD;YACE,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,OAAO;YACd,WAAW,EAAE,WAAW,CAAC,QAAQ;YACjC,WAAW,EAAE,4BAA4B;YACzC,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,CAAC,CAAC,CAAC;SACf;QACD;YACE,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,QAAQ;YACf,WAAW,EAAE,WAAW,CAAC,eAAe;YACxC,WAAW,EAAE,oCAAoC;YACjD,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;SAClB;QACD;YACE,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,OAAO;YACd,WAAW,EAAE,WAAW,CAAC,eAAe;YACxC,WAAW,EAAE,iCAAiC;YAC9C,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,CAAC,CAAC,CAAC;SACf;QACD;YACE,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,OAAO;YACd,WAAW,EAAE,WAAW,CAAC,cAAc;YACvC,WAAW,EAAE,kDAAkD;YAC/D,QAAQ,EAAE,KAAK;YACf,SAAS,EAAE,CAAC,CAAC,CAAC;SACf;QACD;YACE,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,OAAO;YACd,WAAW,EAAE,WAAW,CAAC,WAAW;YACpC,WAAW,EAAE,2BAA2B;YACxC,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,EAAE;SACd;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAiB;IACjD,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,2CAA2C;IACxD,KAAK,EAAE;QACL;YACE,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,OAAO;YACd,WAAW,EAAE,WAAW,CAAC,gBAAgB;YACzC,WAAW,EAAE,sCAAsC;YACnD,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,CAAC,CAAC,CAAC;SACf;QACD;YACE,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,QAAQ;YACf,WAAW,EAAE,WAAW,CAAC,gBAAgB;YACzC,WAAW,EAAE,8CAA8C;YAC3D,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,EAAE;SACd;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAe,EAAE,EAAa;IAC9D,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACnD,OAAO,kBAAkB,CAAC,CAAC,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AACtE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAwB;IACzD,OAAO,gBAAgB,CAAC,WAAW,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAgB;IAClD,MAAM,gBAAgB,GAAkB,EAAE,CAAC;IAE3C,KAAK,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC1E,IAAI,iBAAiB,CAAC,KAAK,EAAE,WAAW,CAAC,EAAE,CAAC;YAC1C,gBAAgB,CAAC,IAAI,CAAC,WAA0B,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,aAAa;IAA1B;QACU,eAAU,GAA4B,IAAI,GAAG,EAAE,CAAC;QAChD,gBAAW,GAA8B,IAAI,GAAG,EAAE,CAAC;IAqE7D,CAAC;IAnEC;;OAEG;IACH,YAAY,CAAC,MAAc,EAAE,MAAkB;QAC7C,MAAM,aAAa,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAElD,sBAAsB;QACtB,IAAI,aAAa,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,aAAa,EAAE,MAAM,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,KAAK,CACb,4BAA4B,aAAa,OAAO,MAAM,aAAa,MAAM,EAAE,CAC5E,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAEpC,gBAAgB;QAChB,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,MAAc;QACtB,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,MAAc;QACvB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC5C,CAAC;IAED;;OAEG;IACK,qBAAqB,CAAC,IAAgB,EAAE,EAAc;QAC5D,MAAM,gBAAgB,GAAqC;YACzD,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC;YACjE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,SAAS,CAAC;YACjE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,UAAU,CAAC,SAAS,CAAC;YACrE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,SAAS,CAAC;YACzF,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,EAAE;YAC1B,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE;YACvB,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,EAAE;SAC3B,CAAC;QAEF,OAAO,gBAAgB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,cAAsB,OAAO;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,GAAG,GAAG,WAAW,CAAC;QAEjC,uEAAuE;QACvE,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;YACzD,IAAI,MAAM,KAAK,UAAU,CAAC,SAAS,IAAI,MAAM,KAAK,UAAU,CAAC,MAAM,EAAE,CAAC;gBACpE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC/B,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAcD;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAgB;IAChD,OAAO;QACL,YAAY,EAAE,SAAS,CAAC,YAAY;QACpC,OAAO;QACP,kBAAkB,EAAE,IAAI,CAAC,GAAG,EAAE;KAC/B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAoB,EACpB,WAAwB;IAExB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAEjD,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CACb,4BAA4B,OAAO,CAAC,YAAY,OAAO,QAAQ,GAAG;YAClE,aAAa,WAAW,GAAG,CAC5B,CAAC;IACJ,CAAC;IAED,OAAO;QACL,GAAG,OAAO;QACV,YAAY,EAAE,QAAQ;QACtB,eAAe,EAAE,WAAW;QAC5B,kBAAkB,EAAE,IAAI,CAAC,GAAG,EAAE;KAC/B,CAAC;AACJ,CAAC"}

package/dist/esm/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/esm/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/esm/protocol/iap.js

@@ -0,0 +1,104 @@
+/**
+ * Inter-Agent Protocol (I.A.P.) v1.0
+ * Standardized communication layer for autonomous AI agents
+ */
+import { IAPMessageType } from '../types/index';
+export class IAPProtocol {
+    /**
+     * Create a handshake message
+     */
+    static createHandshake(handshake) {
+        return {
+            type: IAPMessageType.HANDSHAKE,
+            payload: handshake,
+            timestamp: Date.now(),
+        };
+    }
+    /**
+     * Create a task request message
+     */
+    static createTaskRequest(request) {
+        return {
+            type: IAPMessageType.TASK_REQUEST,
+            payload: request,
+            timestamp: Date.now(),
+        };
+    }
+    /**
+     * Create a task response message
+     */
+    static createTaskResponse(response) {
+        return {
+            type: IAPMessageType.TASK_RESPONSE,
+            payload: response,
+            timestamp: Date.now(),
+        };
+    }
+    /**
+     * Create a task bid message
+     */
+    static createTaskBid(bid) {
+        return {
+            type: IAPMessageType.TASK_ASSIGN,
+            payload: bid,
+            timestamp: Date.now(),
+        };
+    }
+    /**
+     * Create a heartbeat message
+     */
+    static createHeartbeat(agentId) {
+        return {
+            type: IAPMessageType.HEARTBEAT,
+            payload: { agentId },
+            timestamp: Date.now(),
+        };
+    }
+    /**
+     * Create an error message
+     */
+    static createError(error, details) {
+        return {
+            type: 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(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);
+    }
+}
+IAPProtocol.VERSION = '1.0.0';
+//# sourceMappingURL=iap.js.map

package/dist/esm/protocol/iap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iap.js","sourceRoot":"","sources":["../../../src/protocol/iap.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAc,cAAc,EAA+C,MAAM,gBAAgB,CAAC;AAczG,MAAM,OAAO,WAAW;IAGtB;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,SAA2B;QAChD,OAAO;YACL,IAAI,EAAE,cAAc,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,cAAc,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,cAAc,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,cAAc,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,cAAc,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,cAAc,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,cAAc,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;;AA1Ge,mBAAO,GAAG,OAAO,CAAC"}

package/dist/esm/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/esm/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/esm/protocol/index.js

@@ -0,0 +1,28 @@
+/**
+ * Inter-Agent Protocol (I.A.P.) v1.0.0
+ *
+ * Main entry point for the protocol implementation
+ */
+// Export all types
+export * from './types';
+// Export validators
+export * from './validators';
+// Export flows
+export * from './flows';
+// Export utilities
+export * from './utils';
+// Version information
+export const IAP_VERSION = '1.0.0';
+export const IAP_NAME = 'Inter-Agent Protocol';
+/**
+ * Protocol metadata
+ */
+export const PROTOCOL_INFO = {
+    name: IAP_NAME,
+    version: 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/esm/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,cAAc,SAAS,CAAC;AAExB,oBAAoB;AACpB,cAAc,cAAc,CAAC;AAE7B,eAAe;AACf,cAAc,SAAS,CAAC;AAExB,mBAAmB;AACnB,cAAc,SAAS,CAAC;AAExB,sBAAsB;AACtB,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AACnC,MAAM,CAAC,MAAM,QAAQ,GAAG,sBAAsB,CAAC;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,WAAW;IACpB,WAAW,EAAE,8DAA8D;IAC3E,UAAU,EAAE,4CAA4C;IACxD,aAAa,EAAE,0CAA0C;IACzD,OAAO,EAAE,KAAK;CACf,CAAC"}