@decibelsystems/tools 2.0.0

package/dist/tools/coordinator/coordinator.d.ts

@@ -0,0 +1,168 @@
+/**
+ * Minimal Coordinator for Multi-Chat v1 (ADR-0004)
+ *
+ * Three primitives:
+ * 1. Lock Table - exclusive locks for resources
+ * 2. Agent Registry - who's online and what they can do
+ * 3. Event Log - append-only audit trail
+ *
+ * Design principles:
+ * - Fail loud: lock conflicts return failure, don't queue
+ * - File-based: YAML/JSONL in .decibel/coordinator/
+ * - Idempotent: re-locking same resource by same agent = OK
+ * - Auto-cleanup: stale agents (120s) get locks released
+ */
+export interface Lock {
+    resource: string;
+    owner: string;
+    acquired_at: string;
+    expires_at: string;
+    reason?: string;
+}
+export interface Agent {
+    id: string;
+    capabilities: string[];
+    status: 'active' | 'busy' | 'idle';
+    last_seen: string;
+    current_task?: string;
+}
+export interface CoordEvent {
+    ts: string;
+    agent: string;
+    action: string;
+    resource?: string;
+    reason?: string;
+    details?: Record<string, unknown>;
+}
+export interface CoordRegisterInput {
+    agent_id: string;
+    capabilities: string[];
+    project_id?: string;
+}
+export interface CoordRegisterOutput {
+    agent_id: string;
+    registered_at: string;
+    capabilities: string[];
+}
+export interface CoordHeartbeatInput {
+    agent_id: string;
+    current_task?: string;
+    status?: 'active' | 'busy' | 'idle';
+    project_id?: string;
+}
+export interface CoordHeartbeatOutput {
+    agent_id: string;
+    last_seen: string;
+    stale_agents: string[];
+    released_locks: string[];
+}
+export interface CoordLockInput {
+    agent_id: string;
+    resource: string;
+    reason?: string;
+    project_id?: string;
+}
+export interface CoordLockOutput {
+    acquired: boolean;
+    resource: string;
+    holder?: string;
+    held_since?: string;
+    expires_at?: string;
+}
+export interface CoordUnlockInput {
+    agent_id: string;
+    resource: string;
+    project_id?: string;
+}
+export interface CoordUnlockOutput {
+    released: boolean;
+    resource: string;
+    was_held_by?: string;
+}
+export interface CoordStatusInput {
+    project_id?: string;
+}
+export interface CoordStatusOutput {
+    agents: Agent[];
+    locks: Lock[];
+    stale_agents: string[];
+}
+export interface CoordLogInput {
+    project_id?: string;
+    limit?: number;
+    agent_id?: string;
+    action?: string;
+}
+export interface CoordLogOutput {
+    events: CoordEvent[];
+    total_count: number;
+}
+export type MessageStatus = 'pending' | 'acked' | 'completed';
+export interface CoordMessage {
+    id: string;
+    from: string;
+    to: string;
+    intent: string;
+    payload: Record<string, unknown>;
+    reply_to?: string;
+    status: MessageStatus;
+    created_at: string;
+    acked_at?: string;
+    completed_at?: string;
+    result?: Record<string, unknown>;
+    expires_at: string;
+}
+export interface CoordSendInput {
+    to: string;
+    from: string;
+    intent: string;
+    payload: Record<string, unknown>;
+    reply_to?: string;
+    ttl_ms?: number;
+    project_id?: string;
+}
+export interface CoordSendOutput {
+    message_id: string;
+    to: string;
+    from: string;
+    intent: string;
+    expires_at: string;
+}
+export interface CoordInboxInput {
+    agent_id: string;
+    status?: MessageStatus;
+    limit?: number;
+    project_id?: string;
+}
+export interface CoordInboxOutput {
+    messages: CoordMessage[];
+    total: number;
+}
+export interface CoordAckInput {
+    message_id: string;
+    agent_id: string;
+    result?: Record<string, unknown>;
+    project_id?: string;
+}
+export interface CoordAckOutput {
+    message_id: string;
+    status: MessageStatus;
+    from: string;
+    intent: string;
+}
+export interface CoordError {
+    error: string;
+    message: string;
+}
+declare function isCoordError(result: unknown): result is CoordError;
+export declare function coordRegister(input: CoordRegisterInput): Promise<CoordRegisterOutput | CoordError>;
+export declare function coordHeartbeat(input: CoordHeartbeatInput): Promise<CoordHeartbeatOutput | CoordError>;
+export declare function coordLock(input: CoordLockInput): Promise<CoordLockOutput | CoordError>;
+export declare function coordUnlock(input: CoordUnlockInput): Promise<CoordUnlockOutput | CoordError>;
+export declare function coordStatus(input: CoordStatusInput): Promise<CoordStatusOutput | CoordError>;
+export declare function coordLog(input: CoordLogInput): Promise<CoordLogOutput | CoordError>;
+export declare function coordSend(input: CoordSendInput): Promise<CoordSendOutput | CoordError>;
+export declare function coordInbox(input: CoordInboxInput): Promise<CoordInboxOutput | CoordError>;
+export declare function coordAck(input: CoordAckInput): Promise<CoordAckOutput | CoordError>;
+export { isCoordError };
+//# sourceMappingURL=coordinator.d.ts.map

package/dist/tools/coordinator/coordinator.d.ts.map

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