@honeybee-ai/incubator 1.1.0

package/dist/agent/acp/runtime.js

@@ -0,0 +1,337 @@
+import { createAcpClient } from '@agentcoordinationprotocol/sdk';
+import { ClaimManager } from './claim-manager.js';
+import { EventClient } from './event-client.js';
+import { ProgressReporter } from './progress.js';
+import { WebSocketEventClient } from './ws-event-client.js';
+/**
+ * Invisible ACP coordination layer.
+ * Wraps AcpClient and provides:
+ * - Lazy file-level claims on writes
+ * - Event polling between iterations
+ * - Progress reporting
+ * - Control status (halt/pause) checking
+ *
+ * The LLM never sees coordination tools — it only gets environment tools from Propolis.
+ */
+export class AcpRuntime {
+    client;
+    claims;
+    events;
+    progress;
+    config;
+    iterationCount = 0;
+    wsClient = null;
+    constructor(config) {
+        this.config = config;
+        this.client = createAcpClient({
+            server: config.serverUrl,
+            agentId: config.agentId,
+            namespace: config.namespace,
+        });
+        this.claims = new ClaimManager(this.client);
+        this.events = new EventClient(this.client, config.agentId);
+        this.progress = new ProgressReporter(this.client, config.agentId);
+        if (config.useWebSocket) {
+            this.wsClient = new WebSocketEventClient(config.serverUrl, config.namespace, config.agentId, config.role);
+        }
+    }
+    /**
+     * Connect to incubator and register role.
+     */
+    async connect() {
+        try {
+            await this.client.requestRole(this.config.role);
+        }
+        catch {
+            // Server may not support role registration — continue
+        }
+        // Connect WebSocket for push-based events
+        if (this.wsClient) {
+            try {
+                await this.wsClient.connect();
+            }
+            catch {
+                // WS unavailable — fall back to polling
+                this.wsClient = null;
+            }
+        }
+    }
+    /**
+     * Disconnect — release claims, close WS, and report completion.
+     */
+    async disconnect() {
+        await this.claims.releaseAll();
+        if (this.wsClient) {
+            this.wsClient.close();
+            this.wsClient = null;
+        }
+    }
+    /**
+     * Wait for a wake event. Used by sleep/wake agents between iterations.
+     * Returns formatted event strings, or empty array on timeout.
+     */
+    async waitForWake(condition) {
+        if (this.wsClient) {
+            return this.wsClient.waitForWake(condition);
+        }
+        // Fallback: poll for events
+        const deadline = condition.timeout && condition.timeout > 0
+            ? Date.now() + condition.timeout
+            : 0;
+        const POLL_INTERVAL = 2000;
+        while (deadline === 0 || Date.now() < deadline) {
+            const events = await this.events.drain();
+            if (events.length > 0) {
+                if (condition.types) {
+                    const typeSet = new Set(condition.types);
+                    const matching = events.filter(e => {
+                        // Extract type from format "Event from X: [type] data"
+                        const m = e.match(/\[([^\]]+)\]/);
+                        return m && typeSet.has(m[1]);
+                    });
+                    if (matching.length > 0)
+                        return matching;
+                }
+                else {
+                    return events;
+                }
+            }
+            await new Promise(r => setTimeout(r, POLL_INTERVAL));
+        }
+        return []; // timeout
+    }
+    /**
+     * Get the last inject string from a dance-enabled WS connection.
+     * Consumed on read.
+     */
+    getLastInject() {
+        return this.wsClient?.getLastInject() ?? null;
+    }
+    /**
+     * Call a dance tool on the server via WebSocket.
+     */
+    async callDanceTool(tool, args) {
+        if (!this.wsClient) {
+            throw new Error('Dance tool calls require WebSocket connection');
+        }
+        return this.wsClient.callDanceTool(tool, args);
+    }
+    /**
+     * Get dance tool definitions from the server (received via WS).
+     */
+    getDanceTools() {
+        return this.wsClient?.getDanceTools() ?? null;
+    }
+    /**
+     * Called by runner before each iteration.
+     * Returns context messages to inject (events from other agents).
+     */
+    async beforeIteration() {
+        this.iterationCount++;
+        await this.progress.reportIteration(this.iterationCount, this.config.maxIterations);
+        const messages = [];
+        // Drain events — prefer WS buffer, fall back to polling
+        if (this.wsClient) {
+            const wsEvents = this.wsClient.drain();
+            messages.push(...wsEvents);
+        }
+        else {
+            const events = await this.events.drain();
+            messages.push(...events);
+        }
+        // Drain direct messages (always via polling — messages aren't on WS)
+        const directMessages = await this.events.drainMessages();
+        messages.push(...directMessages);
+        return messages;
+    }
+    /**
+     * Called when Propolis executes a file write.
+     * Auto-acquires file claim. Returns error message if conflict, null if OK.
+     */
+    async onFileWrite(path) {
+        return this.claims.ensureClaim(path);
+    }
+    /**
+     * Called on task completion — release claims and report.
+     */
+    async onComplete(summary, usage) {
+        await this.progress.reportComplete(summary, usage);
+        await this.claims.releaseAll();
+    }
+    /**
+     * Fetch protocol from incubator for system prompt generation.
+     */
+    async fetchProtocol() {
+        try {
+            const res = await this.client.getProtocol(this.config.role);
+            if (!res.ok)
+                return null;
+            const data = res.data;
+            // If the response has 'loaded' property, it's the raw spec format
+            if ('loaded' in data) {
+                return buildFromRawSpec(data, this.config.role);
+            }
+            // Otherwise it's already in ProtocolResponse format
+            return data;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Publish a coordination event (exposed as synthetic tool in invisible mode).
+     */
+    async publishEvent(type, data = {}) {
+        try {
+            const res = await this.client.publishEvent(type, data);
+            if (!res.ok)
+                return JSON.stringify({ error: `Failed to publish event: ${res.status}` });
+            return JSON.stringify({ published: true, type });
+        }
+        catch (err) {
+            return JSON.stringify({ error: `publishEvent failed: ${err.message}` });
+        }
+    }
+    /**
+     * Set shared state (exposed as synthetic tool in invisible mode).
+     */
+    async setState(key, value) {
+        try {
+            const res = await this.client.setState(key, value);
+            if (!res.ok)
+                return JSON.stringify({ error: `Failed to set state: ${res.status}` });
+            return JSON.stringify({ ok: true, key });
+        }
+        catch (err) {
+            return JSON.stringify({ error: `setState failed: ${err.message}` });
+        }
+    }
+    /**
+     * Get shared state (exposed as synthetic tool in invisible mode).
+     */
+    async getState() {
+        try {
+            const res = await this.client.getState();
+            if (!res.ok)
+                return JSON.stringify({ error: `Failed to get state: ${res.status}` });
+            return JSON.stringify(res.data);
+        }
+        catch (err) {
+            return JSON.stringify({ error: `getState failed: ${err.message}` });
+        }
+    }
+    /**
+     * Claim exclusive ownership of a resource (exposed as synthetic tool).
+     */
+    async claimResource(resource, reason) {
+        try {
+            const res = await this.client.claim(resource, reason ?? resource, { ttlMs: 5 * 60 * 1000 });
+            if (!res.ok)
+                return JSON.stringify({ error: `Failed to claim: ${res.status}` });
+            const data = res.data;
+            if (data.status === 'approved') {
+                return JSON.stringify({ status: 'approved', resource });
+            }
+            const owner = data.claim?.owner ?? 'another agent';
+            return JSON.stringify({ status: 'rejected', resource, owner, message: `Already claimed by ${owner}` });
+        }
+        catch (err) {
+            return JSON.stringify({ error: `claimResource failed: ${err.message}` });
+        }
+    }
+    /**
+     * Release a previously claimed resource (exposed as synthetic tool).
+     */
+    async releaseResource(resource) {
+        try {
+            const res = await this.client.releaseClaim(resource);
+            if (!res.ok)
+                return JSON.stringify({ error: `Failed to release: ${res.status}` });
+            return JSON.stringify({ released: true, resource });
+        }
+        catch (err) {
+            return JSON.stringify({ error: `releaseResource failed: ${err.message}` });
+        }
+    }
+    /**
+     * Check halt/pause status.
+     */
+    async checkControl() {
+        try {
+            const res = await this.client.getControlStatus();
+            if (!res.ok)
+                return { halted: false, paused: false };
+            const data = res.data;
+            return {
+                halted: data.halted ?? false,
+                paused: data.paused ?? false,
+                reason: data.reason,
+            };
+        }
+        catch {
+            return { halted: false, paused: false };
+        }
+    }
+    /**
+     * Wait for resume after pause.
+     */
+    async waitForResume(pollIntervalMs = 2000) {
+        while (true) {
+            await new Promise(resolve => setTimeout(resolve, pollIntervalMs));
+            const status = await this.checkControl();
+            if (!status.paused) {
+                return 'resumed';
+            }
+        }
+    }
+}
+/**
+ * Transform the raw spec from REST /api/protocol into ProtocolResponse format.
+ */
+function buildFromRawSpec(data, role) {
+    if (!data.loaded || !data.spec)
+        return null;
+    const spec = data.spec;
+    const roleNames = Object.keys(spec.roles);
+    const roleName = roleNames.includes(role) ? role : roleNames[0];
+    const roleDef = spec.roles[roleName];
+    if (!roleDef)
+        return null;
+    const phaseNames = Object.keys(spec.phases);
+    const currentPhase = phaseNames[0]; // default to first phase
+    const phases = {};
+    for (const [name, def] of Object.entries(spec.phases)) {
+        phases[name] = { description: def.description, ...(def.terminal ? { terminal: true } : {}) };
+    }
+    // Extract rules for this role (keyed by phase)
+    const roleRules = spec.rules?.[roleName];
+    const rules = {};
+    if (roleRules) {
+        for (const [phase, rule] of Object.entries(roleRules)) {
+            rules[phase] = rule;
+        }
+    }
+    // Extract wait spec and context from role definition (if present)
+    const wait = roleDef.wait;
+    const context = roleDef.context;
+    const temperature = roleDef.temperature;
+    const reasoning = roleDef.reasoning;
+    const reasoning_effort = roleDef.reasoning_effort;
+    return {
+        protocol: { name: spec.name, title: spec.title },
+        role: { name: roleName, description: roleDef.description },
+        current_phase: currentPhase,
+        instructions: `Follow the ${spec.title} protocol as the ${roleName} role.`,
+        phases,
+        ...(spec.governance ? { governance: spec.governance } : {}),
+        ...(data.team?.length ? { team: data.team } : {}),
+        ...(Object.keys(rules).length > 0 ? { rules } : {}),
+        ...(spec.resources ? { resources: spec.resources } : {}),
+        ...(wait ? { wait } : {}),
+        ...(context !== undefined ? { context } : {}),
+        ...(temperature !== undefined ? { temperature } : {}),
+        ...(reasoning !== undefined ? { reasoning } : {}),
+        ...(reasoning_effort ? { reasoning_effort } : {}),
+    };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/agent/acp/runtime.js.map

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

package/dist/agent/acp/ws-event-client.d.ts

@@ -0,0 +1,64 @@
+export interface WakeCondition {
+    types?: string[] | null;
+    timeout?: number;
+}
+export declare class WebSocketEventClient {
+    private ws;
+    private buffer;
+    private agentId;
+    private role;
+    private serverUrl;
+    private namespace;
+    private lastCursor;
+    private closed;
+    private reconnecting;
+    private lastInject;
+    private danceCallResolvers;
+    private danceTools;
+    /** Pending waitForWake resolvers */
+    private waiters;
+    constructor(serverUrl: string, namespace: string, agentId: string, role?: string);
+    /**
+     * Connect to incubator's /ws endpoint with optional replay cursor.
+     */
+    connect(since?: number): Promise<void>;
+    /**
+     * Attempt to reconnect with exponential backoff.
+     * Replays from last cursor to catch missed events.
+     */
+    private reconnect;
+    /**
+     * Non-blocking drain: return + clear buffer as formatted strings.
+     * Same format as polling EventClient.drain().
+     */
+    drain(): string[];
+    /**
+     * Blocking: resolve when a matching event arrives.
+     * Checks buffer first (resolves immediately if match exists).
+     */
+    waitForWake(condition: WakeCondition): Promise<string[]>;
+    /**
+     * Get the last inject string received with an event.
+     * Consumed on read — returns null on subsequent calls until a new inject arrives.
+     */
+    getLastInject(): string | null;
+    /**
+     * Get dance tool definitions received from the server.
+     * Returns null if no dance tools were sent.
+     */
+    getDanceTools(): import('../types.js').ToolDef[] | null;
+    /**
+     * Call a dance tool on the server via WebSocket.
+     * Returns a promise that resolves with the tool result.
+     */
+    callDanceTool(tool: string, args: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Close the WebSocket and resolve all pending waiters.
+     */
+    close(): void;
+    /** Get the last known cursor position for reconnection. */
+    get cursor(): number;
+    /** Whether the WebSocket is currently connected. */
+    get connected(): boolean;
+    private formatEvent;
+}

package/dist/agent/acp/ws-event-client.js

@@ -0,0 +1,263 @@
+import WebSocket from 'ws';
+import { createTypeMatcher } from './event-matcher.js';
+/**
+ * WebSocket-based event client that connects to incubator's /ws endpoint.
+ * Replaces polling with push-based event delivery for reactive agents.
+ */
+const MAX_RECONNECTS = 10;
+const MAX_RECONNECT_DELAY = 30_000;
+export class WebSocketEventClient {
+    ws = null;
+    buffer = [];
+    agentId;
+    role;
+    serverUrl;
+    namespace;
+    lastCursor = 0;
+    closed = false;
+    reconnecting = false;
+    lastInject = null;
+    danceCallResolvers = new Map();
+    danceTools = null;
+    /** Pending waitForWake resolvers */
+    waiters = [];
+    constructor(serverUrl, namespace, agentId, role) {
+        this.serverUrl = serverUrl;
+        this.namespace = namespace;
+        this.agentId = agentId;
+        this.role = role ?? '';
+    }
+    /**
+     * Connect to incubator's /ws endpoint with optional replay cursor.
+     */
+    connect(since) {
+        if (this.closed)
+            return Promise.reject(new Error('Client is closed'));
+        return new Promise((resolve, reject) => {
+            const wsUrl = this.serverUrl.replace(/^http/, 'ws');
+            const params = new URLSearchParams({
+                namespace: this.namespace,
+                agentId: this.agentId,
+                role: this.role,
+                ...(since !== undefined ? { since: String(since) } : {}),
+            });
+            this.ws = new WebSocket(`${wsUrl}/ws?${params}`);
+            this.ws.on('open', () => resolve());
+            this.ws.on('error', (err) => reject(err));
+            this.ws.on('message', (data) => {
+                try {
+                    const msg = JSON.parse(data.toString());
+                    if (msg.type === 'ping' || msg.type === 'replay_done')
+                        return;
+                    // Handle dance_tools — store tool definitions from server
+                    if (msg.type === 'dance_tools' && Array.isArray(msg.tools)) {
+                        this.danceTools = msg.tools;
+                        return;
+                    }
+                    // Handle dance_result — resolve pending callDanceTool promise
+                    if (msg.type === 'dance_result' && typeof msg.callId === 'string') {
+                        const resolver = this.danceCallResolvers.get(msg.callId);
+                        if (resolver) {
+                            this.danceCallResolvers.delete(msg.callId);
+                            resolver(msg.result);
+                        }
+                        return; // Don't process as regular event
+                    }
+                    // Track inject from event messages
+                    if (msg.type === 'event' && typeof msg.inject === 'string') {
+                        this.lastInject = msg.inject;
+                    }
+                    // Unwrap incubator WS envelope: { type: 'event', event: {...} }
+                    const inner = (msg.type === 'event' && msg.event) ? msg.event : msg;
+                    const event = {
+                        type: inner.type ?? inner.event_type ?? msg.type ?? '',
+                        data: inner.data ?? inner,
+                        agentId: inner.publishedBy ?? inner.agentId ?? inner.agent_id ?? '',
+                        seq: inner.id ?? inner.seq ?? msg.seq ?? 0,
+                    };
+                    // Filter own events
+                    if (event.agentId === this.agentId)
+                        return;
+                    // Track cursor
+                    if (event.seq > this.lastCursor) {
+                        this.lastCursor = event.seq;
+                    }
+                    // Check waiters first
+                    let consumed = false;
+                    for (let i = this.waiters.length - 1; i >= 0; i--) {
+                        const waiter = this.waiters[i];
+                        if (!waiter.matcher || waiter.matcher(event.type)) {
+                            if (waiter.timer)
+                                clearTimeout(waiter.timer);
+                            this.waiters.splice(i, 1);
+                            waiter.resolve([this.formatEvent(event)]);
+                            consumed = true;
+                            break;
+                        }
+                    }
+                    if (!consumed) {
+                        this.buffer.push(event);
+                    }
+                }
+                catch {
+                    // Ignore malformed messages
+                }
+            });
+            this.ws.on('close', () => {
+                this.ws = null;
+                // Auto-reconnect if not intentionally closed
+                if (!this.closed && !this.reconnecting) {
+                    this.reconnect();
+                }
+            });
+        });
+    }
+    /**
+     * Attempt to reconnect with exponential backoff.
+     * Replays from last cursor to catch missed events.
+     */
+    async reconnect() {
+        this.reconnecting = true;
+        for (let attempt = 1; attempt <= MAX_RECONNECTS; attempt++) {
+            if (this.closed)
+                break;
+            const delay = Math.min(1000 * Math.pow(2, attempt - 1), MAX_RECONNECT_DELAY);
+            await new Promise(r => setTimeout(r, delay));
+            if (this.closed)
+                break;
+            try {
+                await this.connect(this.lastCursor);
+                this.reconnecting = false;
+                return;
+            }
+            catch {
+                // retry
+            }
+        }
+        this.reconnecting = false;
+        // Exhausted retries — waiters will stay blocked until timeout or close
+    }
+    /**
+     * Non-blocking drain: return + clear buffer as formatted strings.
+     * Same format as polling EventClient.drain().
+     */
+    drain() {
+        if (this.buffer.length === 0)
+            return [];
+        const events = this.buffer.splice(0);
+        return events.map(e => this.formatEvent(e));
+    }
+    /**
+     * Blocking: resolve when a matching event arrives.
+     * Checks buffer first (resolves immediately if match exists).
+     */
+    waitForWake(condition) {
+        const matcher = condition.types
+            ? createTypeMatcher(condition.types)
+            : null;
+        // Check buffer first
+        const matchIdx = this.buffer.findIndex(e => !matcher || matcher(e.type));
+        if (matchIdx !== -1) {
+            const event = this.buffer.splice(matchIdx, 1)[0];
+            return Promise.resolve([this.formatEvent(event)]);
+        }
+        // If closed, return immediately
+        if (this.closed || !this.ws) {
+            return Promise.resolve([]);
+        }
+        // Register waiter
+        return new Promise((resolve) => {
+            const waiter = { resolve, matcher };
+            if (condition.timeout && condition.timeout > 0) {
+                waiter.timer = setTimeout(() => {
+                    const idx = this.waiters.indexOf(waiter);
+                    if (idx !== -1)
+                        this.waiters.splice(idx, 1);
+                    resolve([]);
+                }, condition.timeout);
+            }
+            this.waiters.push(waiter);
+        });
+    }
+    /**
+     * Get the last inject string received with an event.
+     * Consumed on read — returns null on subsequent calls until a new inject arrives.
+     */
+    getLastInject() {
+        const inject = this.lastInject;
+        this.lastInject = null;
+        return inject;
+    }
+    /**
+     * Get dance tool definitions received from the server.
+     * Returns null if no dance tools were sent.
+     */
+    getDanceTools() {
+        return this.danceTools;
+    }
+    /**
+     * Call a dance tool on the server via WebSocket.
+     * Returns a promise that resolves with the tool result.
+     */
+    async callDanceTool(tool, args) {
+        const callId = `dance_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+        return new Promise((resolve, reject) => {
+            if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+                reject(new Error('WebSocket not connected'));
+                return;
+            }
+            // Timeout after 30s
+            const timer = setTimeout(() => {
+                this.danceCallResolvers.delete(callId);
+                reject(new Error(`Dance tool call "${tool}" timed out`));
+            }, 30_000);
+            this.danceCallResolvers.set(callId, (result) => {
+                clearTimeout(timer);
+                resolve(result);
+            });
+            this.ws.send(JSON.stringify({
+                type: 'dance_call',
+                tool,
+                args,
+                callId,
+                agentId: this.agentId,
+                role: this.role,
+            }));
+        });
+    }
+    /**
+     * Close the WebSocket and resolve all pending waiters.
+     */
+    close() {
+        this.closed = true;
+        // Resolve all pending waiters with empty
+        for (const waiter of this.waiters) {
+            if (waiter.timer)
+                clearTimeout(waiter.timer);
+            waiter.resolve([]);
+        }
+        this.waiters = [];
+        // Reject all pending dance calls
+        for (const [, resolver] of this.danceCallResolvers) {
+            resolver({ error: 'Client closed' });
+        }
+        this.danceCallResolvers.clear();
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+    }
+    /** Get the last known cursor position for reconnection. */
+    get cursor() {
+        return this.lastCursor;
+    }
+    /** Whether the WebSocket is currently connected. */
+    get connected() {
+        return this.ws?.readyState === WebSocket.OPEN;
+    }
+    formatEvent(e) {
+        const payload = typeof e.data === 'string' ? e.data : JSON.stringify(e.data);
+        return `Event from ${e.agentId}: [${e.type}] ${payload}`;
+    }
+}
+//# sourceMappingURL=ws-event-client.js.map