@weave_protocol/domere 1.0.18 → 1.2.0

package/dist/index.d.ts

@@ -13,4 +13,5 @@ export * from './storage/index.js';
 export * from "./audit/index.js";
 export * from "./handoff/index.js";
 export * from "./compliance/index.js";
+export * from "./orchestration/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAMH,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AA2BnE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,CAAC;AAC3C,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAMH,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AA2BnE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,CAAC;AAC3C,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC"}

package/dist/index.js

@@ -38,4 +38,5 @@ export * from './storage/index.js';
 export * from "./audit/index.js";
 export * from "./handoff/index.js";
 export * from "./compliance/index.js";
+export * from "./orchestration/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAEnG,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;AACjG,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;AACxC,MAAM,WAAW,GAAG,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAC;AAEnD,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;AAExF,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IACjD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC,IAAI,EAAE,IAA+B,CAAC,CAAC;QACnF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAChF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACxG,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;AAC7C,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE1D,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,CAAC;AAC3C,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AAEnC,qBAAqB;AACrB,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAEnG,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;AACjG,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;AACxC,MAAM,WAAW,GAAG,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAC;AAEnD,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;AAExF,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IACjD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC,IAAI,EAAE,IAA+B,CAAC,CAAC;QACnF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAChF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACxG,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;AAC7C,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE1D,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,CAAC;AAC3C,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AAEnC,qBAAqB;AACrB,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC"}

package/dist/orchestration/index.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Dōmere - Orchestration Module
+ *
+ * Multi-agent coordination infrastructure for AI systems.
+ * Provides task scheduling, agent registry, and shared state management.
+ */
+export * from './scheduler.js';
+export * from './registry.js';
+export * from './state.js';
+import { TaskScheduler, Task } from './scheduler.js';
+import { AgentRegistry, Agent } from './registry.js';
+import { StateManager } from './state.js';
+export interface OrchestratorConfig {
+    max_agents?: number;
+    default_task_timeout_ms?: number;
+    heartbeat_interval_ms?: number;
+    state_conflict_resolution?: 'last-write-wins' | 'first-write-wins' | 'merge' | 'manual';
+    auto_reassign_on_failure?: boolean;
+}
+export interface OrchestratorStats {
+    agents: {
+        total: number;
+        ready: number;
+        busy: number;
+        offline: number;
+    };
+    tasks: {
+        total: number;
+        queued: number;
+        running: number;
+        completed: number;
+        failed: number;
+    };
+    state: {
+        keys: number;
+        branches: number;
+        locks: number;
+    };
+}
+/**
+ * Unified orchestrator combining scheduler, registry, and state
+ */
+export declare class Orchestrator {
+    readonly scheduler: TaskScheduler;
+    readonly registry: AgentRegistry;
+    readonly state: StateManager;
+    private config;
+    private running;
+    constructor(config?: OrchestratorConfig);
+    /**
+     * Start the orchestrator
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the orchestrator
+     */
+    stop(): Promise<void>;
+    /**
+     * Register an agent
+     */
+    registerAgent(params: {
+        id?: string;
+        name?: string;
+        capabilities: string[];
+        max_concurrent_tasks?: number;
+    }): Promise<Agent>;
+    /**
+     * Submit a task
+     */
+    submitTask(params: {
+        intent: string;
+        priority?: 'critical' | 'high' | 'normal' | 'low' | 'background';
+        dependencies?: string[];
+        required_capabilities?: string[];
+        timeout_ms?: number;
+    }): Promise<Task>;
+    /**
+     * Get orchestrator statistics
+     */
+    getStats(): OrchestratorStats;
+    /**
+     * Agent heartbeat (call from agent)
+     */
+    heartbeat(agentId: string, currentTasks: string[]): Promise<{
+        ok: boolean;
+        tasks_to_run?: Task[];
+    }>;
+    /**
+     * Report task started (call from agent)
+     */
+    taskStarted(agentId: string, taskId: string): Promise<void>;
+    /**
+     * Report task progress (call from agent)
+     */
+    taskProgress(agentId: string, taskId: string, percent: number, message?: string): Promise<void>;
+    /**
+     * Report task completed (call from agent)
+     */
+    taskCompleted(agentId: string, taskId: string, result?: any): Promise<void>;
+    /**
+     * Report task failed (call from agent)
+     */
+    taskFailed(agentId: string, taskId: string, error: string): Promise<void>;
+    private setupEventHandlers;
+    /**
+     * Get shared state value
+     */
+    getState(key: string): Promise<any>;
+    /**
+     * Set shared state value (with optional lock)
+     */
+    setState(key: string, value: any, agentId: string, options?: {
+        lock?: boolean;
+    }): Promise<void>;
+    /**
+     * Lock state key
+     */
+    lockState(key: string, agentId: string, durationMs?: number): Promise<boolean>;
+    /**
+     * Unlock state key
+     */
+    unlockState(key: string, agentId: string): Promise<boolean>;
+}
+export default Orchestrator;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/orchestration/index.js

@@ -0,0 +1,258 @@
+/**
+ * Dōmere - Orchestration Module
+ *
+ * Multi-agent coordination infrastructure for AI systems.
+ * Provides task scheduling, agent registry, and shared state management.
+ */
+export * from './scheduler.js';
+export * from './registry.js';
+export * from './state.js';
+import { TaskScheduler } from './scheduler.js';
+import { AgentRegistry } from './registry.js';
+import { StateManager } from './state.js';
+/**
+ * Unified orchestrator combining scheduler, registry, and state
+ */
+export class Orchestrator {
+    scheduler;
+    registry;
+    state;
+    config;
+    running = false;
+    constructor(config) {
+        this.config = {
+            max_agents: 16,
+            default_task_timeout_ms: 300000,
+            heartbeat_interval_ms: 5000,
+            state_conflict_resolution: 'last-write-wins',
+            auto_reassign_on_failure: true,
+            ...config,
+        };
+        // Initialize components
+        this.registry = new AgentRegistry({
+            heartbeat_interval_ms: this.config.heartbeat_interval_ms,
+            heartbeat_timeout_ms: this.config.heartbeat_interval_ms * 3,
+        });
+        this.scheduler = new TaskScheduler({
+            agentGetter: async () => {
+                const agents = this.registry.getAllAgents();
+                return agents.map(a => ({
+                    id: a.id,
+                    available: a.status === 'ready' || a.status === 'busy',
+                    capabilities: a.capabilities,
+                    current_load: a.metrics.current_load,
+                }));
+            },
+        });
+        this.state = new StateManager({
+            conflict_resolution: this.config.state_conflict_resolution,
+        });
+        // Wire up event handlers
+        this.setupEventHandlers();
+    }
+    /**
+     * Start the orchestrator
+     */
+    async start() {
+        this.running = true;
+        console.log('[Orchestrator] Started');
+    }
+    /**
+     * Stop the orchestrator
+     */
+    async stop() {
+        this.running = false;
+        // Drain all agents
+        const agents = this.registry.getAllAgents();
+        for (const agent of agents) {
+            await this.registry.drain(agent.id);
+        }
+        console.log('[Orchestrator] Stopped');
+    }
+    /**
+     * Register an agent
+     */
+    async registerAgent(params) {
+        const agents = this.registry.getAllAgents();
+        if (agents.length >= this.config.max_agents) {
+            throw new Error(`Maximum agents (${this.config.max_agents}) reached`);
+        }
+        const agent = await this.registry.register({
+            agent_id: params.id,
+            name: params.name,
+            capabilities: params.capabilities,
+            max_concurrent_tasks: params.max_concurrent_tasks,
+            heartbeat_interval_ms: this.config.heartbeat_interval_ms,
+        });
+        return agent;
+    }
+    /**
+     * Submit a task
+     */
+    async submitTask(params) {
+        const task = await this.scheduler.createTask({
+            intent: params.intent,
+            priority: params.priority,
+            dependencies: params.dependencies,
+            constraints: {
+                required_capabilities: params.required_capabilities,
+                max_duration_ms: params.timeout_ms || this.config.default_task_timeout_ms,
+            },
+        });
+        // Try to assign immediately if agents available
+        try {
+            const queued = this.scheduler.getTasksByStatus('queued');
+            if (queued.find(t => t.id === task.id)) {
+                await this.scheduler.assignTask(task.id);
+            }
+        }
+        catch (e) {
+            // No available agent, will be assigned later
+        }
+        return task;
+    }
+    /**
+     * Get orchestrator statistics
+     */
+    getStats() {
+        const agentStats = this.registry.getStats();
+        const taskStats = this.scheduler.getStats();
+        const stateStats = this.state.getStats();
+        return {
+            agents: {
+                total: agentStats.total_agents,
+                ready: agentStats.by_status.ready,
+                busy: agentStats.by_status.busy,
+                offline: agentStats.by_status.offline + agentStats.by_status.failed,
+            },
+            tasks: {
+                total: taskStats.total_tasks,
+                queued: taskStats.by_status.queued,
+                running: taskStats.by_status.running,
+                completed: taskStats.by_status.completed,
+                failed: taskStats.by_status.failed,
+            },
+            state: {
+                keys: stateStats.total_keys,
+                branches: stateStats.branches,
+                locks: stateStats.active_locks,
+            },
+        };
+    }
+    /**
+     * Agent heartbeat (call from agent)
+     */
+    async heartbeat(agentId, currentTasks) {
+        const result = await this.registry.heartbeat({
+            agent_id: agentId,
+            current_tasks: currentTasks,
+        });
+        if (!result.acknowledged) {
+            return { ok: false };
+        }
+        // Check for new tasks to assign
+        const agent = this.registry.getAgent(agentId);
+        if (!agent)
+            return { ok: false };
+        const availableSlots = agent.max_concurrent_tasks - agent.current_tasks.length;
+        const tasksToRun = [];
+        for (let i = 0; i < availableSlots; i++) {
+            const task = await this.scheduler.getNextTask(agentId, agent.capabilities);
+            if (task) {
+                await this.scheduler.assignTask(task.id, agentId);
+                await this.registry.assignTask(agentId, task.id);
+                tasksToRun.push(task);
+            }
+            else {
+                break;
+            }
+        }
+        return { ok: true, tasks_to_run: tasksToRun.length > 0 ? tasksToRun : undefined };
+    }
+    /**
+     * Report task started (call from agent)
+     */
+    async taskStarted(agentId, taskId) {
+        await this.scheduler.startTask(taskId, agentId);
+    }
+    /**
+     * Report task progress (call from agent)
+     */
+    async taskProgress(agentId, taskId, percent, message) {
+        await this.scheduler.reportProgress(taskId, agentId, percent, undefined, message);
+    }
+    /**
+     * Report task completed (call from agent)
+     */
+    async taskCompleted(agentId, taskId, result) {
+        const taskResult = await this.scheduler.completeTask(taskId, agentId, result);
+        await this.registry.completeTask(agentId, taskId, true, taskResult.duration_ms);
+    }
+    /**
+     * Report task failed (call from agent)
+     */
+    async taskFailed(agentId, taskId, error) {
+        const taskResult = await this.scheduler.failTask(taskId, agentId, error);
+        await this.registry.completeTask(agentId, taskId, false, taskResult.duration_ms);
+    }
+    // ===========================================================================
+    // Event Handlers
+    // ===========================================================================
+    setupEventHandlers() {
+        // Handle agent going offline
+        this.registry.onAgentDown(async (agent, activeTasks) => {
+            console.log(`[Orchestrator] Agent ${agent.id} went down with ${activeTasks.length} active tasks`);
+            if (this.config.auto_reassign_on_failure) {
+                // Release all locks held by agent
+                await this.state.releaseAllLocks(agent.id);
+                // Reassign tasks
+                const reassignments = await this.scheduler.reassignFromAgent(agent.id);
+                console.log(`[Orchestrator] Reassigned ${reassignments.length} tasks from failed agent`);
+            }
+        });
+        // Log task completions
+        this.scheduler.onAnyTaskComplete((result) => {
+            console.log(`[Orchestrator] Task ${result.task_id} ${result.status} in ${result.duration_ms}ms`);
+        });
+    }
+    // ===========================================================================
+    // Convenience Methods for State
+    // ===========================================================================
+    /**
+     * Get shared state value
+     */
+    async getState(key) {
+        return this.state.get(key);
+    }
+    /**
+     * Set shared state value (with optional lock)
+     */
+    async setState(key, value, agentId, options) {
+        if (options?.lock) {
+            const lockResult = await this.state.acquireLock({ key, holder: agentId });
+            if (!lockResult.acquired) {
+                throw new Error(`Could not acquire lock on ${key}: ${lockResult.reason}`);
+            }
+        }
+        await this.state.set(key, value, { agent_id: agentId });
+    }
+    /**
+     * Lock state key
+     */
+    async lockState(key, agentId, durationMs) {
+        const result = await this.state.acquireLock({
+            key,
+            holder: agentId,
+            duration_ms: durationMs,
+        });
+        return result.acquired;
+    }
+    /**
+     * Unlock state key
+     */
+    async unlockState(key, agentId) {
+        return this.state.releaseLock(key, agentId);
+    }
+}
+export default Orchestrator;
+//# sourceMappingURL=index.js.map

package/dist/orchestration/index.js.map

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

package/dist/orchestration/registry.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Dōmere - Agent Registry
+ *
+ * Agent lifecycle management, health monitoring, and capability tracking
+ * for multi-agent AI orchestration systems.
+ */
+export type AgentStatus = 'initializing' | 'ready' | 'busy' | 'overloaded' | 'draining' | 'offline' | 'failed';
+export interface Agent {
+    id: string;
+    name?: string;
+    status: AgentStatus;
+    registered_at: Date;
+    last_heartbeat: Date;
+    capabilities: string[];
+    max_concurrent_tasks: number;
+    current_tasks: string[];
+    metrics: AgentMetrics;
+    config: AgentConfig;
+    metadata: Record<string, any>;
+}
+export interface AgentConfig {
+    heartbeat_interval_ms: number;
+    heartbeat_timeout_ms: number;
+    drain_timeout_ms: number;
+    auto_recover: boolean;
+}
+export interface AgentMetrics {
+    tasks_completed: number;
+    tasks_failed: number;
+    total_duration_ms: number;
+    avg_duration_ms: number;
+    success_rate: number;
+    current_load: number;
+    uptime_ms: number;
+    last_task_completed_at?: Date;
+}
+export interface AgentRegistration {
+    agent_id?: string;
+    name?: string;
+    capabilities: string[];
+    max_concurrent_tasks?: number;
+    heartbeat_interval_ms?: number;
+    metadata?: Record<string, any>;
+}
+export interface HeartbeatPayload {
+    agent_id: string;
+    status?: AgentStatus;
+    current_tasks?: string[];
+    metrics_update?: Partial<AgentMetrics>;
+    metadata_update?: Record<string, any>;
+}
+export interface AgentQuery {
+    capabilities?: string[];
+    status?: AgentStatus[];
+    min_available_slots?: number;
+    max_load?: number;
+    exclude?: string[];
+}
+export interface AgentEvent {
+    type: 'registered' | 'ready' | 'busy' | 'overloaded' | 'draining' | 'offline' | 'failed' | 'recovered' | 'deregistered';
+    agent_id: string;
+    timestamp: Date;
+    details?: Record<string, any>;
+}
+export declare class AgentRegistry {
+    private agents;
+    private heartbeatTimers;
+    private eventCallbacks;
+    private globalEventCallbacks;
+    private defaultConfig;
+    constructor(defaultConfig?: Partial<AgentConfig>);
+    /**
+     * Register a new agent
+     */
+    register(params: AgentRegistration): Promise<Agent>;
+    /**
+     * Mark agent as ready
+     */
+    setReady(agentId: string): Promise<void>;
+    /**
+     * Process heartbeat from agent
+     */
+    heartbeat(payload: HeartbeatPayload): Promise<{
+        acknowledged: boolean;
+        instructions?: string[];
+    }>;
+    /**
+     * Get agent by ID
+     */
+    getAgent(agentId: string): Agent | undefined;
+    /**
+     * Get all agents
+     */
+    getAllAgents(): Agent[];
+    /**
+     * Find agents matching criteria
+     */
+    findAgents(query: AgentQuery): Agent[];
+    /**
+     * Get best agent for a task
+     */
+    getBestAgent(query: AgentQuery & {
+        prefer_lowest_load?: boolean;
+        prefer_highest_success?: boolean;
+    }): Agent | null;
+    /**
+     * Assign task to agent
+     */
+    assignTask(agentId: string, taskId: string): Promise<boolean>;
+    /**
+     * Complete task for agent
+     */
+    completeTask(agentId: string, taskId: string, success: boolean, durationMs: number): Promise<void>;
+    /**
+     * Start draining agent (stop accepting new tasks)
+     */
+    drain(agentId: string): Promise<{
+        drained: boolean;
+        remaining_tasks: number;
+    }>;
+    /**
+     * Deregister agent
+     */
+    deregister(agentId: string, force?: boolean): Promise<{
+        success: boolean;
+        orphaned_tasks: string[];
+    }>;
+    /**
+     * Get agent statistics
+     */
+    getStats(): {
+        total_agents: number;
+        by_status: Record<AgentStatus, number>;
+        total_capacity: number;
+        total_load: number;
+        avg_success_rate: number;
+    };
+    /**
+     * Subscribe to agent events
+     */
+    onAgentEvent(agentId: string, callback: (event: AgentEvent) => void): () => void;
+    /**
+     * Subscribe to all agent events
+     */
+    onAnyAgentEvent(callback: (event: AgentEvent) => void): () => void;
+    /**
+     * Subscribe to agent going offline/failed
+     */
+    onAgentDown(callback: (agent: Agent, activeTasks: string[]) => void): () => void;
+    private startHeartbeatMonitor;
+    private resetHeartbeatTimer;
+    private handleHeartbeatTimeout;
+    private emitEvent;
+}
+export default AgentRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/orchestration/registry.d.ts.map

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