@cogitator-ai/types 0.1.0

package/dist/swarm.d.ts

@@ -0,0 +1,362 @@
+/**
+ * Swarm types for multi-agent coordination
+ */
+import type { Agent } from './agent';
+import type { RunResult, Span } from './runtime';
+export type SwarmStrategy = 'hierarchical' | 'round-robin' | 'consensus' | 'auction' | 'pipeline' | 'debate';
+export interface SwarmAgentMetadata {
+    /** Agent's areas of expertise */
+    expertise?: string[];
+    /** Priority in task assignment (higher = preferred) */
+    priority?: number;
+    /** Role in the swarm */
+    role?: 'supervisor' | 'worker' | 'moderator' | 'router' | 'advocate' | 'critic';
+    /** Weight for weighted voting */
+    weight?: number;
+    /** Custom metadata */
+    custom?: Record<string, unknown>;
+}
+export type SwarmAgentState = 'idle' | 'running' | 'completed' | 'failed';
+export interface SwarmAgent {
+    agent: Agent;
+    metadata: SwarmAgentMetadata;
+    state: SwarmAgentState;
+    lastResult?: RunResult;
+    messageCount: number;
+    tokenCount: number;
+}
+export interface HierarchicalConfig {
+    /** Maximum delegation depth (default: 3) */
+    maxDelegationDepth?: number;
+    /** Allow workers to communicate with each other */
+    workerCommunication?: boolean;
+    /** Route all messages through supervisor */
+    routeThrough?: 'supervisor' | 'direct';
+    /** Visibility of worker outputs to supervisor */
+    visibility?: 'full' | 'summary' | 'none';
+}
+export interface RoundRobinConfig {
+    /** Enable sticky sessions (same agent handles follow-ups) */
+    sticky?: boolean;
+    /** Key function for sticky routing */
+    stickyKey?: (input: unknown) => string;
+    /** Rotation strategy */
+    rotation?: 'sequential' | 'random';
+}
+export interface ConsensusConfig {
+    /** Voting threshold (0-1), default: 0.5 for majority */
+    threshold: number;
+    /** Maximum discussion rounds */
+    maxRounds: number;
+    /** Resolution strategy */
+    resolution: 'majority' | 'unanimous' | 'weighted';
+    /** Action on no consensus */
+    onNoConsensus: 'escalate' | 'supervisor-decides' | 'fail';
+    /** Weights for weighted voting (agentName -> weight) */
+    weights?: Record<string, number>;
+}
+export interface AuctionConfig {
+    /** Bidding strategy */
+    bidding: 'capability-match' | 'custom';
+    /** Custom bid function (agent, task) -> bid score */
+    bidFunction?: (agent: SwarmAgent, task: string) => Promise<number> | number;
+    /** Winner selection */
+    selection: 'highest-bid' | 'weighted-random';
+    /** Minimum bid to participate (0-1) */
+    minBid?: number;
+}
+export interface PipelineStage {
+    name: string;
+    agent: Agent;
+    /** If true, acts as a quality gate */
+    gate?: boolean;
+}
+export interface PipelineGateConfig {
+    /** Condition to pass gate */
+    condition: (output: unknown) => boolean;
+    /** Action on gate failure */
+    onFail: 'retry-previous' | 'abort' | 'skip' | `goto:${string}`;
+    /** Maximum retries */
+    maxRetries: number;
+}
+export interface PipelineContext {
+    input: unknown;
+    stageIndex: number;
+    stageName: string;
+    previousOutputs: Map<string, unknown>;
+}
+export interface PipelineConfig {
+    /** Pipeline stages in order */
+    stages: PipelineStage[];
+    /** Stage input transformer */
+    stageInput?: (prevOutput: unknown, stage: PipelineStage, ctx: PipelineContext) => unknown;
+    /** Gate configurations */
+    gates?: Record<string, PipelineGateConfig>;
+}
+export interface DebateConfig {
+    /** Number of debate rounds */
+    rounds: number;
+    /** Max tokens per turn */
+    turnDuration?: number;
+    /** Debate format */
+    format?: 'structured' | 'freeform';
+}
+export type SwarmMessageType = 'request' | 'response' | 'notification' | 'error';
+export interface SwarmMessage {
+    id: string;
+    swarmId: string;
+    from: string;
+    to: string | 'broadcast';
+    type: SwarmMessageType;
+    channel?: string;
+    content: string;
+    payload?: unknown;
+    replyTo?: string;
+    correlationId?: string;
+    timestamp: number;
+    metadata?: Record<string, unknown>;
+}
+export interface MessageBusConfig {
+    enabled: boolean;
+    protocol: 'direct' | 'broadcast' | 'pub-sub';
+    /** Max message length in characters */
+    maxMessageLength?: number;
+    /** Max messages per turn per agent */
+    maxMessagesPerTurn?: number;
+    /** Max total messages in swarm run */
+    maxTotalMessages?: number;
+}
+export interface MessageBus {
+    send(message: Omit<SwarmMessage, 'id' | 'timestamp'>): Promise<SwarmMessage>;
+    broadcast(from: string, content: string, channel?: string): Promise<void>;
+    subscribe(agentName: string, handler: (msg: SwarmMessage) => void): () => void;
+    getMessages(agentName: string, limit?: number): SwarmMessage[];
+    getConversation(agent1: string, agent2: string): SwarmMessage[];
+    getAllMessages(): SwarmMessage[];
+    clear(): void;
+}
+export interface BlackboardSection<T = unknown> {
+    name: string;
+    data: T;
+    lastModified: number;
+    modifiedBy: string;
+    version: number;
+}
+export interface BlackboardConfig {
+    enabled: boolean;
+    /** Initial sections with their data */
+    sections: Record<string, unknown>;
+    /** Lock sections during write (optimistic locking) */
+    locking?: boolean;
+    /** Track history of changes */
+    trackHistory?: boolean;
+}
+export interface BlackboardHistoryEntry {
+    value: unknown;
+    writtenBy: string;
+    timestamp: number;
+    version: number;
+}
+export interface BlackboardEntry<T = unknown> {
+    section: string;
+    key?: string;
+    value: T;
+    version: number;
+    writtenBy: string;
+    timestamp: number;
+}
+export interface Blackboard {
+    read<T = unknown>(section: string): T;
+    write<T>(section: string, data: T, agentName: string): void;
+    append<T>(section: string, item: T, agentName: string): void;
+    has(section: string): boolean;
+    delete(section: string): void;
+    subscribe(section: string, handler: (data: unknown, agentName: string) => void): () => void;
+    getSections(): string[];
+    getSection<T = unknown>(section: string): BlackboardSection<T> | undefined;
+    getHistory(section: string): BlackboardHistoryEntry[];
+    clear(): void;
+}
+export type SwarmEventType = 'swarm:start' | 'swarm:complete' | 'swarm:error' | 'agent:start' | 'agent:complete' | 'agent:error' | 'message:sent' | 'message:received' | 'blackboard:write' | 'consensus:vote' | 'consensus:round' | 'auction:bid' | 'auction:winner' | 'debate:turn' | 'debate:round' | 'pipeline:stage' | 'pipeline:gate' | string;
+export interface SwarmEvent {
+    type: SwarmEventType;
+    timestamp: number;
+    agentName?: string;
+    data?: unknown;
+}
+export type SwarmEventHandler = (event: SwarmEvent) => void | Promise<void>;
+export interface SwarmEventEmitter {
+    on(event: SwarmEventType | '*', handler: SwarmEventHandler): () => void;
+    once(event: SwarmEventType, handler: SwarmEventHandler): () => void;
+    emit(event: SwarmEventType, data?: unknown, agentName?: string): void;
+    off(event: SwarmEventType, handler: SwarmEventHandler): void;
+    removeAllListeners(event?: SwarmEventType): void;
+    getEvents(): SwarmEvent[];
+}
+export interface SwarmResourceConfig {
+    /** Max concurrent agent runs (default: 4) */
+    maxConcurrency?: number;
+    /** Total token budget for the swarm run */
+    tokenBudget?: number;
+    /** Cost limit in dollars */
+    costLimit?: number;
+    /** Time limit in ms */
+    timeout?: number;
+    /** Per-agent limits */
+    perAgent?: {
+        maxIterations?: number;
+        maxTokens?: number;
+        timeout?: number;
+    };
+}
+export interface SwarmResourceUsage {
+    totalTokens: number;
+    totalCost: number;
+    elapsedTime: number;
+    agentUsage: Map<string, {
+        tokens: number;
+        cost: number;
+        runs: number;
+        duration: number;
+    }>;
+}
+export type SwarmErrorAction = 'retry' | 'skip' | 'failover' | 'abort';
+export interface SwarmErrorConfig {
+    /** Action on agent failure */
+    onAgentFailure: SwarmErrorAction;
+    /** Retry configuration */
+    retry?: {
+        maxRetries: number;
+        backoff: 'constant' | 'linear' | 'exponential';
+        initialDelay?: number;
+        maxDelay?: number;
+    };
+    /** Failover agent mapping (primaryAgent -> backupAgent) */
+    failover?: Record<string, string>;
+    /** Circuit breaker configuration */
+    circuitBreaker?: {
+        enabled: boolean;
+        /** Open circuit after N failures */
+        threshold: number;
+        /** Reset timeout in ms */
+        resetTimeout: number;
+    };
+    /** Allow returning partial results on failure */
+    partialResults?: boolean;
+}
+export interface SwarmConfig {
+    name: string;
+    strategy: SwarmStrategy;
+    /** Supervisor agent for hierarchical strategy */
+    supervisor?: Agent;
+    /** Worker agents for hierarchical strategy */
+    workers?: Agent[];
+    /** General agents for round-robin, consensus, auction */
+    agents?: Agent[];
+    /** Pipeline stages for pipeline strategy */
+    stages?: PipelineStage[];
+    /** Moderator agent for debate strategy */
+    moderator?: Agent;
+    /** Router agent for specialist routing */
+    router?: Agent;
+    hierarchical?: HierarchicalConfig;
+    roundRobin?: RoundRobinConfig;
+    consensus?: ConsensusConfig;
+    auction?: AuctionConfig;
+    pipeline?: PipelineConfig;
+    debate?: DebateConfig;
+    messaging?: MessageBusConfig;
+    blackboard?: BlackboardConfig;
+    resources?: SwarmResourceConfig;
+    errorHandling?: SwarmErrorConfig;
+    observability?: {
+        /** Enable tracing */
+        tracing?: boolean;
+        /** Log all messages */
+        messageLogging?: boolean;
+        /** Log blackboard changes */
+        blackboardLogging?: boolean;
+    };
+}
+export interface SwarmRunOptions {
+    /** Input to the swarm */
+    input: string;
+    /** Additional context passed to all agents */
+    context?: Record<string, unknown>;
+    /** Thread ID for memory persistence */
+    threadId?: string;
+    /** Override timeout */
+    timeout?: number;
+    onAgentStart?: (agentName: string) => void;
+    onAgentComplete?: (agentName: string, result: RunResult) => void;
+    onAgentError?: (agentName: string, error: Error) => void;
+    onMessage?: (message: SwarmMessage) => void;
+    onEvent?: (event: SwarmEvent) => void;
+}
+export interface SwarmResult {
+    swarmId: string;
+    swarmName: string;
+    strategy: SwarmStrategy;
+    output: unknown;
+    structured?: unknown;
+    agentResults: Map<string, RunResult>;
+    /** Votes from consensus strategy */
+    votes?: Map<string, unknown>;
+    /** Bids from auction strategy */
+    bids?: Map<string, number>;
+    /** Winner from auction strategy */
+    auctionWinner?: string;
+    /** Debate transcript from debate strategy */
+    debateTranscript?: SwarmMessage[];
+    /** Pipeline outputs per stage */
+    pipelineOutputs?: Map<string, unknown>;
+    usage: SwarmResourceUsage;
+    trace: {
+        traceId: string;
+        spans: Span[];
+        events: SwarmEvent[];
+        messages: SwarmMessage[];
+    };
+    error?: Error;
+}
+export interface ISwarm {
+    readonly name: string;
+    readonly config: SwarmConfig;
+    readonly messageBus: MessageBus;
+    readonly blackboard: Blackboard;
+    readonly events: SwarmEventEmitter;
+    run(options: SwarmRunOptions): Promise<SwarmResult>;
+    getAgent(name: string): SwarmAgent | undefined;
+    getAgents(): SwarmAgent[];
+    pause(): void;
+    resume(): void;
+    abort(): void;
+}
+export interface StrategyResult {
+    output: unknown;
+    structured?: unknown;
+    agentResults: Map<string, RunResult>;
+    votes?: Map<string, unknown>;
+    bids?: Map<string, number>;
+    auctionWinner?: string;
+    debateTranscript?: SwarmMessage[];
+    pipelineOutputs?: Map<string, unknown>;
+}
+export interface SwarmCoordinatorInterface {
+    runAgent(agentName: string, input: string, context?: Record<string, unknown>): Promise<RunResult>;
+    runAgentsParallel(agents: {
+        name: string;
+        input: string;
+        context?: Record<string, unknown>;
+    }[], maxConcurrency?: number): Promise<Map<string, RunResult>>;
+    getAgent(name: string): SwarmAgent | undefined;
+    getAgents(): SwarmAgent[];
+    getAgentsByRole(role: SwarmAgentMetadata['role']): SwarmAgent[];
+    readonly messageBus: MessageBus;
+    readonly blackboard: Blackboard;
+    readonly events: SwarmEventEmitter;
+}
+export interface IStrategy {
+    execute(options: SwarmRunOptions): Promise<StrategyResult>;
+}
+//# sourceMappingURL=swarm.d.ts.map

package/dist/swarm.d.ts.map

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

package/dist/swarm.js

@@ -0,0 +1,5 @@
+/**
+ * Swarm types for multi-agent coordination
+ */
+export {};
+//# sourceMappingURL=swarm.js.map

package/dist/swarm.js.map

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

package/dist/tool.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Tool types for agent capabilities
+ */
+import type { ZodType } from 'zod';
+import type { SandboxConfig } from './sandbox';
+export interface ToolConfig<TParams = unknown, TResult = unknown> {
+    name: string;
+    description: string;
+    parameters: ZodType<TParams>;
+    execute: (params: TParams, context: ToolContext) => Promise<TResult>;
+    sideEffects?: ('filesystem' | 'network' | 'database' | 'process')[];
+    requiresApproval?: boolean | ((params: TParams) => boolean);
+    timeout?: number;
+    /** Sandbox configuration for isolated execution */
+    sandbox?: SandboxConfig;
+}
+export interface Tool<TParams = unknown, TResult = unknown> {
+    name: string;
+    description: string;
+    parameters: ZodType<TParams>;
+    execute: (params: TParams, context: ToolContext) => Promise<TResult>;
+    sideEffects?: ('filesystem' | 'network' | 'database' | 'process')[];
+    requiresApproval?: boolean | ((params: TParams) => boolean);
+    timeout?: number;
+    /** Sandbox configuration for isolated execution */
+    sandbox?: SandboxConfig;
+    toJSON: () => ToolSchema;
+}
+export interface ToolContext {
+    agentId: string;
+    runId: string;
+    signal: AbortSignal;
+}
+export interface ToolSchema {
+    name: string;
+    description: string;
+    parameters: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+//# sourceMappingURL=tool.d.ts.map

package/dist/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AACnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,MAAM,WAAW,UAAU,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACrE,WAAW,CAAC,EAAE,CAAC,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC,EAAE,CAAC;IACpE,gBAAgB,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACrE,WAAW,CAAC,EAAE,CAAC,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC,EAAE,CAAC;IACpE,gBAAgB,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,MAAM,UAAU,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH"}

package/dist/tool.js

@@ -0,0 +1,5 @@
+/**
+ * Tool types for agent capabilities
+ */
+export {};
+//# sourceMappingURL=tool.js.map

package/dist/tool.js.map

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