@honeybee-ai/incubator 1.1.0

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

@@ -0,0 +1,20 @@
+import type { AcpClient } from '@agentcoordinationprotocol/sdk';
+/**
+ * Polls incubator for events between agent iterations.
+ * Buffers events and formats them as context messages for the LLM.
+ */
+export declare class EventClient {
+    private client;
+    private cursor;
+    private agentId;
+    constructor(client: AcpClient, agentId: string);
+    /**
+     * Poll for new events since last check.
+     * Returns formatted context messages for injection into the conversation.
+     */
+    drain(): Promise<string[]>;
+    /**
+     * Poll for messages addressed to this agent.
+     */
+    drainMessages(): Promise<string[]>;
+}

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

@@ -0,0 +1,60 @@
+/**
+ * Polls incubator for events between agent iterations.
+ * Buffers events and formats them as context messages for the LLM.
+ */
+export class EventClient {
+    client;
+    cursor = 0;
+    agentId;
+    constructor(client, agentId) {
+        this.client = client;
+        this.agentId = agentId;
+    }
+    /**
+     * Poll for new events since last check.
+     * Returns formatted context messages for injection into the conversation.
+     */
+    async drain() {
+        try {
+            const res = await this.client.getEvents(this.cursor);
+            if (!res.ok)
+                return [];
+            const data = res.data;
+            if (!data.events || data.events.length === 0)
+                return [];
+            this.cursor = data.cursor;
+            // Filter out our own events
+            const otherEvents = data.events.filter(e => e.agentId !== this.agentId);
+            if (otherEvents.length === 0)
+                return [];
+            // Format events as context messages
+            return otherEvents.map(e => {
+                const source = e.agentId;
+                const payload = typeof e.data === 'string' ? e.data : JSON.stringify(e.data);
+                return `Event from ${source}: [${e.type}] ${payload}`;
+            });
+        }
+        catch {
+            // Server unreachable — skip event polling
+            return [];
+        }
+    }
+    /**
+     * Poll for messages addressed to this agent.
+     */
+    async drainMessages() {
+        try {
+            const res = await this.client.getMessages();
+            if (!res.ok)
+                return [];
+            const messages = res.data;
+            if (!messages || messages.length === 0)
+                return [];
+            return messages.map(m => `Message from ${m.from}: ${m.content}`);
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=event-client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event-client.js","sourceRoot":"","sources":["../../../src/agent/acp/event-client.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAO,WAAW;IACd,MAAM,CAAY;IAClB,MAAM,GAAG,CAAC,CAAC;IACX,OAAO,CAAS;IAExB,YAAY,MAAiB,EAAE,OAAe;QAC5C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrD,IAAI,CAAC,GAAG,CAAC,EAAE;gBAAE,OAAO,EAAE,CAAC;YAEvB,MAAM,IAAI,GAAG,GAAG,CAAC,IAGhB,CAAC;YAEF,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YAExD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YAE1B,4BAA4B;YAC5B,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC;YACxE,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YAExC,oCAAoC;YACpC,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;gBACzB,MAAM,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC;gBACzB,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC7E,OAAO,cAAc,MAAM,MAAM,CAAC,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACxD,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,0CAA0C;YAC1C,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa;QACjB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YAC5C,IAAI,CAAC,GAAG,CAAC,EAAE;gBAAE,OAAO,EAAE,CAAC;YAEvB,MAAM,QAAQ,GAAG,GAAG,CAAC,IAInB,CAAC;YAEH,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YAElD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACnE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}

package/dist/agent/acp/event-matcher.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Event type matcher with glob pattern support.
+ * Returns a function that tests event types against a set of patterns.
+ *
+ * Supports:
+ *   "turn"          — exact match
+ *   "turn.*"        — matches "turn.player_2", "turn.seer", etc.
+ *   "turn.player_*" — matches "turn.player_2", "turn.player_3"
+ *   "*.player_2"    — matches "turn.player_2", "speech.player_2"
+ *
+ * Globs use `*` to match within a dot-segment (any chars except `.`).
+ */
+export declare function createTypeMatcher(types: string[]): (eventType: string) => boolean;

package/dist/agent/acp/event-matcher.js

@@ -0,0 +1,31 @@
+/**
+ * Event type matcher with glob pattern support.
+ * Returns a function that tests event types against a set of patterns.
+ *
+ * Supports:
+ *   "turn"          — exact match
+ *   "turn.*"        — matches "turn.player_2", "turn.seer", etc.
+ *   "turn.player_*" — matches "turn.player_2", "turn.player_3"
+ *   "*.player_2"    — matches "turn.player_2", "speech.player_2"
+ *
+ * Globs use `*` to match within a dot-segment (any chars except `.`).
+ */
+export function createTypeMatcher(types) {
+    const exact = new Set();
+    const patterns = [];
+    for (const t of types) {
+        if (t.includes('*')) {
+            // Escape regex-special chars (except *), replace * with [^.]* (match within segment)
+            const escaped = t.replace(/[.+?^${}()|[\]\\]/g, '\\$&').replace(/\*/g, '[^.]*');
+            patterns.push(new RegExp('^' + escaped + '$'));
+        }
+        else {
+            exact.add(t);
+        }
+    }
+    // Fast path: no globs, pure Set lookup
+    if (patterns.length === 0)
+        return (type) => exact.has(type);
+    return (type) => exact.has(type) || patterns.some(p => p.test(type));
+}
+//# sourceMappingURL=event-matcher.js.map

package/dist/agent/acp/event-matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-matcher.js","sourceRoot":"","sources":["../../../src/agent/acp/event-matcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAe;IAC/C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,qFAAqF;YACrF,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAChF,QAAQ,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,GAAG,GAAG,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC;QACjD,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACf,CAAC;IACH,CAAC;IAED,uCAAuC;IACvC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAE5D,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACvE,CAAC"}

package/dist/agent/acp/progress.d.ts

@@ -0,0 +1,23 @@
+import type { AcpClient } from '@agentcoordinationprotocol/sdk';
+/**
+ * Reports agent progress via ACP events.
+ */
+export declare class ProgressReporter {
+    private client;
+    private agentId;
+    private startTime;
+    private iterationCount;
+    constructor(client: AcpClient, agentId: string);
+    /**
+     * Report iteration progress.
+     */
+    reportIteration(iteration: number, maxIterations: number): Promise<void>;
+    /**
+     * Report completion.
+     */
+    reportComplete(summary: string, usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    }): Promise<void>;
+}

package/dist/agent/acp/progress.js

@@ -0,0 +1,54 @@
+/**
+ * Reports agent progress via ACP events.
+ */
+export class ProgressReporter {
+    client;
+    agentId;
+    startTime;
+    iterationCount = 0;
+    constructor(client, agentId) {
+        this.client = client;
+        this.agentId = agentId;
+        this.startTime = Date.now();
+    }
+    /**
+     * Report iteration progress.
+     */
+    async reportIteration(iteration, maxIterations) {
+        this.iterationCount = iteration;
+        const progress = iteration / maxIterations;
+        // Only report every 5 iterations to avoid flooding
+        if (iteration % 5 !== 0 && iteration !== 1)
+            return;
+        try {
+            await this.client.publishEvent('agent.progress', {
+                agent: this.agentId,
+                iteration,
+                maxIterations,
+                progress: Math.round(progress * 100),
+                elapsed: Date.now() - this.startTime,
+            });
+        }
+        catch {
+            // Best-effort reporting
+        }
+    }
+    /**
+     * Report completion.
+     */
+    async reportComplete(summary, usage) {
+        try {
+            await this.client.publishEvent('agent.complete', {
+                agent: this.agentId,
+                summary,
+                iterations: this.iterationCount,
+                elapsed: Date.now() - this.startTime,
+                ...(usage ? { usage } : {}),
+            });
+        }
+        catch {
+            // Best-effort reporting
+        }
+    }
+}
+//# sourceMappingURL=progress.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../../src/agent/acp/progress.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,gBAAgB;IACnB,MAAM,CAAY;IAClB,OAAO,CAAS;IAChB,SAAS,CAAS;IAClB,cAAc,GAAG,CAAC,CAAC;IAE3B,YAAY,MAAiB,EAAE,OAAe;QAC5C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,SAAiB,EAAE,aAAqB;QAC5D,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;QAChC,MAAM,QAAQ,GAAG,SAAS,GAAG,aAAa,CAAC;QAE3C,mDAAmD;QACnD,IAAI,SAAS,GAAG,CAAC,KAAK,CAAC,IAAI,SAAS,KAAK,CAAC;YAAE,OAAO;QAEnD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,gBAAgB,EAAE;gBAC/C,KAAK,EAAE,IAAI,CAAC,OAAO;gBACnB,SAAS;gBACT,aAAa;gBACb,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC;gBACpC,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS;aACrC,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,OAAe,EAAE,KAA+E;QACnH,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,gBAAgB,EAAE;gBAC/C,KAAK,EAAE,IAAI,CAAC,OAAO;gBACnB,OAAO;gBACP,UAAU,EAAE,IAAI,CAAC,cAAc;gBAC/B,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS;gBACpC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC5B,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;IACH,CAAC;CACF"}

package/dist/agent/acp/runtime.d.ts

@@ -0,0 +1,156 @@
+import { type WakeCondition } from './ws-event-client.js';
+interface ControlStatus {
+    halted: boolean;
+    paused: boolean;
+    reason?: string;
+}
+export interface ProtocolResponse {
+    protocol: {
+        name: string;
+        title: string;
+    };
+    role: {
+        name: string;
+        description: string;
+    };
+    current_phase: string;
+    instructions: string;
+    phases: Record<string, {
+        description: string;
+        terminal?: boolean;
+    }>;
+    governance?: Record<string, unknown>;
+    team?: Array<{
+        agent: string;
+        role: string;
+    }>;
+    rules?: Record<string, {
+        loop?: boolean;
+        steps: Array<{
+            action: string;
+            description?: string;
+            hint?: string;
+            params?: Record<string, unknown>;
+        }>;
+    }>;
+    resources?: Record<string, unknown>;
+    wait?: {
+        types?: string[];
+        max_timeout?: number;
+    };
+    /** Context retention: 0 = stateless (reset each iteration), N = keep last N exchanges. Omit for full history. */
+    context?: number;
+    /** LLM temperature override from spec. */
+    temperature?: number;
+    /** Disable LLM reasoning/thinking (e.g. gpt-oss). false = disable. */
+    reasoning?: boolean;
+    /** Reasoning effort level (e.g. 'low', 'medium', 'high'). */
+    reasoning_effort?: string;
+}
+export interface AcpRuntimeConfig {
+    serverUrl: string;
+    namespace: string;
+    agentId: string;
+    role: string;
+    maxIterations: number;
+    verbose?: boolean;
+    /** Use WebSocket for event delivery instead of polling. */
+    useWebSocket?: boolean;
+}
+/**
+ * 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 declare class AcpRuntime {
+    private client;
+    private claims;
+    private events;
+    private progress;
+    private config;
+    private iterationCount;
+    private wsClient;
+    constructor(config: AcpRuntimeConfig);
+    /**
+     * Connect to incubator and register role.
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect — release claims, close WS, and report completion.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Wait for a wake event. Used by sleep/wake agents between iterations.
+     * Returns formatted event strings, or empty array on timeout.
+     */
+    waitForWake(condition: WakeCondition): Promise<string[]>;
+    /**
+     * Get the last inject string from a dance-enabled WS connection.
+     * Consumed on read.
+     */
+    getLastInject(): string | null;
+    /**
+     * Call a dance tool on the server via WebSocket.
+     */
+    callDanceTool(tool: string, args: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Get dance tool definitions from the server (received via WS).
+     */
+    getDanceTools(): import('../types.js').ToolDef[] | null;
+    /**
+     * Called by runner before each iteration.
+     * Returns context messages to inject (events from other agents).
+     */
+    beforeIteration(): Promise<string[]>;
+    /**
+     * Called when Propolis executes a file write.
+     * Auto-acquires file claim. Returns error message if conflict, null if OK.
+     */
+    onFileWrite(path: string): Promise<string | null>;
+    /**
+     * Called on task completion — release claims and report.
+     */
+    onComplete(summary: string, usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    }): Promise<void>;
+    /**
+     * Fetch protocol from incubator for system prompt generation.
+     */
+    fetchProtocol(): Promise<ProtocolResponse | null>;
+    /**
+     * Publish a coordination event (exposed as synthetic tool in invisible mode).
+     */
+    publishEvent(type: string, data?: Record<string, unknown>): Promise<string>;
+    /**
+     * Set shared state (exposed as synthetic tool in invisible mode).
+     */
+    setState(key: string, value: unknown): Promise<string>;
+    /**
+     * Get shared state (exposed as synthetic tool in invisible mode).
+     */
+    getState(): Promise<string>;
+    /**
+     * Claim exclusive ownership of a resource (exposed as synthetic tool).
+     */
+    claimResource(resource: string, reason?: string): Promise<string>;
+    /**
+     * Release a previously claimed resource (exposed as synthetic tool).
+     */
+    releaseResource(resource: string): Promise<string>;
+    /**
+     * Check halt/pause status.
+     */
+    checkControl(): Promise<ControlStatus>;
+    /**
+     * Wait for resume after pause.
+     */
+    waitForResume(pollIntervalMs?: number): Promise<string>;
+}
+export {};