@nxuss/lemma 0.1.1 → 0.2.0

package/dist/esm/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/esm/protocol/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/protocol/types.ts"],"names":[],"mappings":"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"}

package/dist/esm/protocol/types.js

@@ -0,0 +1,54 @@
+/**
+ * Inter-Agent Protocol (I.A.P.) v1.0.0
+ *
+ * TypeScript type definitions for standardized agent-to-agent communication
+ * via the Subconscious Router.
+ */
+/**
+ * Capability types that agents can advertise
+ */
+export 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 || (CapabilityType = {}));
+/**
+ * Message types in the I.A.P. protocol
+ */
+export 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 || (MessageType = {}));
+/**
+ * Status of a task in the system
+ */
+export 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 || (TaskStatus = {}));
+//# sourceMappingURL=types.js.map

package/dist/esm/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,MAAM,CAAN,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,KAAd,cAAc,QASzB;AAED;;GAEG;AACH,MAAM,CAAN,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,KAAX,WAAW,QAetB;AAED;;GAEG;AACH,MAAM,CAAN,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,KAAV,UAAU,QAQrB"}

package/dist/esm/protocol/utils.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Inter-Agent Protocol (I.A.P.) v1.0.0
+ *
+ * Utility functions for message creation and handling
+ */
+import { IAPMessage, MessageType, AgentId, TaskId, MessageId, AgentHandshake, TaskProposal, TaskBid, ContextTransfer, ErrorMessage, CapabilityDiscovery, TaskAssignment, TaskResult, Heartbeat, DisconnectMessage } from './types';
+/**
+ * Generates a unique message ID
+ */
+export declare function generateMessageId(): MessageId;
+/**
+ * Generates a unique task ID
+ */
+export declare function generateTaskId(): TaskId;
+/**
+ * Generates a unique agent ID
+ */
+export declare function generateAgentId(prefix?: string): AgentId;
+/**
+ * Gets current timestamp in ISO 8601 format
+ */
+export declare function getCurrentTimestamp(): string;
+/**
+ * Creates a base I.A.P. message structure
+ */
+export declare function createBaseMessage(type: MessageType, from: AgentId, to: AgentId | 'router', payload: any, correlationId?: string): IAPMessage;
+/**
+ * Creates a handshake message
+ */
+export declare function createHandshakeMessage(handshake: AgentHandshake): IAPMessage;
+/**
+ * Creates a capability discovery message
+ */
+export declare function createCapabilityDiscoveryMessage(discovery: CapabilityDiscovery): IAPMessage;
+/**
+ * Creates a task proposal message
+ */
+export declare function createTaskProposalMessage(proposal: TaskProposal): IAPMessage;
+/**
+ * Creates a task bid message
+ */
+export declare function createTaskBidMessage(bid: TaskBid, agentId: AgentId): IAPMessage;
+/**
+ * Creates a task assignment message
+ */
+export declare function createTaskAssignmentMessage(assignment: TaskAssignment): IAPMessage;
+/**
+ * Creates a task result message
+ */
+export declare function createTaskResultMessage(result: TaskResult): IAPMessage;
+/**
+ * Creates a context transfer message
+ */
+export declare function createContextTransferMessage(transfer: ContextTransfer): IAPMessage;
+/**
+ * Creates an error message
+ */
+export declare function createErrorMessage(from: AgentId, to: AgentId | 'router', error: ErrorMessage, correlationId?: string): IAPMessage;
+/**
+ * Creates a heartbeat message
+ */
+export declare function createHeartbeatMessage(heartbeat: Heartbeat): IAPMessage;
+/**
+ * Creates a disconnect message
+ */
+export declare function createDisconnectMessage(disconnect: DisconnectMessage): IAPMessage;
+/**
+ * Serializes a message to JSON string
+ */
+export declare function serializeMessage(message: IAPMessage): string;
+/**
+ * Deserializes a JSON string to a message
+ */
+export declare function deserializeMessage(json: string): IAPMessage;
+/**
+ * Extracts correlation ID from a message
+ */
+export declare function getCorrelationId(message: IAPMessage): string | undefined;
+/**
+ * Checks if a message is a request type
+ */
+export declare function isRequestMessage(type: MessageType): boolean;
+/**
+ * Checks if a message is a response type
+ */
+export declare function isResponseMessage(type: MessageType): boolean;
+/**
+ * Calculates message size in bytes
+ */
+export declare function getMessageSize(message: IAPMessage): number;
+/**
+ * Compresses large payloads (placeholder for actual compression)
+ */
+export declare function compressPayload(payload: any): {
+    data: string;
+    compressed: boolean;
+};
+/**
+ * Decompresses payloads (placeholder for actual decompression)
+ */
+export declare function decompressPayload(data: string, compressed: boolean): any;
+/**
+ * Creates a response message from a request
+ */
+export declare function createResponseMessage(request: IAPMessage, responseType: MessageType, payload: any): IAPMessage;
+/**
+ * Checks if a message has expired based on deadline
+ */
+export declare function isMessageExpired(message: IAPMessage, deadlineMs?: number): boolean;
+/**
+ * Calculates message age in milliseconds
+ */
+export declare function getMessageAge(message: IAPMessage): number;
+/**
+ * Redacts sensitive information from a message for logging
+ */
+export declare function redactMessage(message: IAPMessage): IAPMessage;
+/**
+ * Formats a message for human-readable logging
+ */
+export declare function formatMessageForLog(message: IAPMessage): string;
+/**
+ * Batch messages for efficient transmission
+ */
+export declare function batchMessages(messages: IAPMessage[]): string;
+/**
+ * Unbatch messages from a batch transmission
+ */
+export declare function unbatchMessages(batch: string): IAPMessage[];
+//# sourceMappingURL=utils.d.ts.map

package/dist/esm/protocol/utils.d.ts.map

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