@honeybee-ai/incubator 1.1.0

package/dist/dances.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Dance file loader — loads JS modules whose exports become virtual tools.
+ * Runs entirely on the incubator (server-side).
+ */
+import type { ToolDef } from './agent/types.js';
+export interface DanceToolDef {
+    description: string;
+    params: Record<string, {
+        type: string;
+        description?: string;
+    }>;
+    handler: (ctx: DanceContext) => Promise<DanceResult>;
+}
+export interface DanceContext {
+    args: Record<string, unknown>;
+    state: Record<string, string>;
+    agent: {
+        role: string;
+        agentId: string;
+    };
+    acp: DanceAcpHelper;
+}
+export interface DanceAcpHelper {
+    publish(type: string, data?: unknown): Promise<void>;
+    claim(resource: string): Promise<string>;
+    release(resource: string): Promise<void>;
+    setState(key: string, value: string): Promise<void>;
+}
+export type DanceResult = {
+    result: unknown;
+    wait?: unknown;
+} | {
+    error: string;
+};
+export interface InjectFn {
+    (ctx: {
+        state: Record<string, string>;
+        agent: {
+            role: string;
+            agentId: string;
+        };
+    }): string;
+}
+export interface DanceModule {
+    inject?: InjectFn;
+    tools: Map<string, DanceToolDef>;
+}
+/**
+ * Load a dance file via dynamic import. Validates exports.
+ * Returns a DanceModule with optional inject and tool map.
+ */
+export declare function loadDances(filePath: string): Promise<DanceModule>;
+/**
+ * Convert dance tool definitions to LLM ToolDef format.
+ */
+export declare function danceToolDefs(mod: DanceModule): ToolDef[];
+/**
+ * Build an ACP helper that wraps incubator stores for use in dance handlers.
+ */
+export declare function buildAcpHelper(stores: {
+    publishEvent: (ns: string, type: string, data?: unknown, agentId?: string) => Promise<void>;
+    claimResource: (ns: string, resource: string, agentId: string, ttl?: number) => Promise<string>;
+    releaseResource: (ns: string, claimId: string) => Promise<void>;
+    setState: (ns: string, key: string, value: string) => Promise<void>;
+}, namespace: string, agentId: string): DanceAcpHelper;
+/**
+ * Execute a dance tool handler with full context.
+ */
+export declare function callDanceTool(mod: DanceModule, toolName: string, args: Record<string, unknown>, agentRole: string, agentId: string, getState: () => Promise<Record<string, string>>, acpHelper: DanceAcpHelper): Promise<DanceResult>;
+/**
+ * Run inject for a specific agent. Returns formatted string or null if no inject.
+ */
+export declare function runInject(mod: DanceModule, state: Record<string, string>, agentRole: string, agentId: string): string | null;

package/dist/dances.js

@@ -0,0 +1,122 @@
+// ─── Loader ────────────────────────────────────────────────────
+/**
+ * Load a dance file via dynamic import. Validates exports.
+ * Returns a DanceModule with optional inject and tool map.
+ */
+export async function loadDances(filePath) {
+    const mod = await import(filePath);
+    const tools = new Map();
+    let inject;
+    for (const [name, exp] of Object.entries(mod)) {
+        if (name === 'default')
+            continue; // skip default export
+        if (name === 'inject') {
+            if (typeof exp !== 'function') {
+                throw new Error(`Dance file: "inject" must be a function, got ${typeof exp}`);
+            }
+            inject = exp;
+            continue;
+        }
+        // Everything else is a tool
+        if (!exp || typeof exp !== 'object')
+            continue;
+        const tool = exp;
+        if (typeof tool.handler !== 'function') {
+            throw new Error(`Dance file: tool "${name}" must have a handler function`);
+        }
+        if (typeof tool.description !== 'string') {
+            throw new Error(`Dance file: tool "${name}" must have a description string`);
+        }
+        tools.set(name, {
+            description: tool.description,
+            params: tool.params ?? {},
+            handler: tool.handler,
+        });
+    }
+    return { inject, tools };
+}
+/**
+ * Convert dance tool definitions to LLM ToolDef format.
+ */
+export function danceToolDefs(mod) {
+    const defs = [];
+    for (const [name, tool] of mod.tools) {
+        const properties = {};
+        const required = [];
+        for (const [param, def] of Object.entries(tool.params)) {
+            properties[param] = {
+                type: def.type,
+                description: def.description ?? '',
+            };
+            required.push(param); // all params required by default
+        }
+        defs.push({
+            type: 'function',
+            function: {
+                name,
+                description: tool.description,
+                parameters: {
+                    type: 'object',
+                    properties,
+                    required,
+                },
+            },
+        });
+    }
+    return defs;
+}
+/**
+ * Build an ACP helper that wraps incubator stores for use in dance handlers.
+ */
+export function buildAcpHelper(stores, namespace, agentId) {
+    return {
+        async publish(type, data) {
+            await stores.publishEvent(namespace, type, data, agentId);
+        },
+        async claim(resource) {
+            return stores.claimResource(namespace, resource, agentId);
+        },
+        async release(claimId) {
+            await stores.releaseResource(namespace, claimId);
+        },
+        async setState(key, value) {
+            await stores.setState(namespace, key, value);
+        },
+    };
+}
+/**
+ * Execute a dance tool handler with full context.
+ */
+export async function callDanceTool(mod, toolName, args, agentRole, agentId, getState, acpHelper) {
+    const tool = mod.tools.get(toolName);
+    if (!tool) {
+        return { error: `Unknown dance tool: ${toolName}` };
+    }
+    const state = await getState();
+    const ctx = {
+        args,
+        state,
+        agent: { role: agentRole, agentId },
+        acp: acpHelper,
+    };
+    try {
+        return await tool.handler(ctx);
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+/**
+ * Run inject for a specific agent. Returns formatted string or null if no inject.
+ */
+export function runInject(mod, state, agentRole, agentId) {
+    if (!mod.inject)
+        return null;
+    try {
+        return mod.inject({ state, agent: { role: agentRole, agentId } });
+    }
+    catch (err) {
+        return `[inject error: ${err instanceof Error ? err.message : String(err)}]`;
+    }
+}
+//# sourceMappingURL=dances.js.map

package/dist/dances.js.map

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

package/dist/guard.d.ts

@@ -0,0 +1,52 @@
+import type { Stores } from './stores/interfaces.js';
+interface ScanResult {
+    pass: boolean;
+    score: number;
+    action: 'PASS' | 'LOG' | 'WARN' | 'BLOCK';
+    findings: Array<{
+        category: string;
+        severity: string;
+        description: string;
+    }>;
+    summary: string;
+}
+export interface Guard {
+    scan(message: string): ScanResult;
+}
+export declare class CarapaceBlockedError extends Error {
+    readonly score: number;
+    readonly action: string;
+    readonly findings: ScanResult['findings'];
+    constructor(result: ScanResult);
+}
+/**
+ * Load carapace (CJS) from an ESM context via createRequire.
+ * Carapace uses __dirname + fs.readFileSync for pattern loading — cannot be ESM-imported.
+ */
+export declare function loadGuard(verbose?: boolean): Guard;
+/**
+ * Concatenate text fields and run a single scan.
+ * Throws CarapaceBlockedError on BLOCK, logs on WARN.
+ */
+interface TelemetryLike {
+    record(type: string, meta: Record<string, unknown>): void;
+}
+/**
+ * Wrap store methods with Carapace scanning.
+ * Writes throw CarapaceBlockedError on BLOCK. Reads silently filter out poisoned entries.
+ * Internal system events bypass the guard.
+ */
+export declare function createGuardedStores(stores: Stores, guard: Guard, verbose?: boolean, telemetry?: TelemetryLike): Stores;
+/**
+ * Scan a snapshot's entries on load. Returns counts of blocked items.
+ * Mutates the snapshot arrays in place, removing poisoned entries.
+ */
+export declare function scanSnapshot(snapshot: {
+    state: unknown[];
+    claims: unknown[];
+    events: unknown[];
+    discoveries: unknown[];
+}, guard: Guard, verbose?: boolean, telemetry?: TelemetryLike): {
+    blocked: number;
+};
+export {};

package/dist/guard.js

@@ -0,0 +1,210 @@
+import { createRequire } from 'node:module';
+export class CarapaceBlockedError extends Error {
+    score;
+    action;
+    findings;
+    constructor(result) {
+        super(`[carapace] Blocked: ${result.summary}`);
+        this.name = 'CarapaceBlockedError';
+        this.score = result.score;
+        this.action = result.action;
+        this.findings = result.findings;
+    }
+}
+/**
+ * Load carapace (CJS) from an ESM context via createRequire.
+ * Carapace uses __dirname + fs.readFileSync for pattern loading — cannot be ESM-imported.
+ */
+export function loadGuard(verbose) {
+    const require = createRequire(import.meta.url);
+    const mod = require('@honeybee-ai/carapace');
+    if (verbose) {
+        console.error('[incubator] carapace loaded');
+    }
+    return mod;
+}
+function scanFields(guard, fields, verbose, telemetry) {
+    const text = fields.filter(Boolean).join(' ');
+    if (!text)
+        return;
+    const result = guard.scan(text);
+    if (verbose && result.findings.length > 0) {
+        const ts = new Date().toISOString().slice(11, 23);
+        console.error(`  ${ts} [carapace] score=${result.score} action=${result.action} findings=${result.findings.length}`);
+    }
+    if (result.action !== 'PASS' && telemetry) {
+        telemetry.record('guard_scan', {
+            action: result.action, score: result.score,
+            findingsCount: result.findings.length, side: 'write',
+        });
+    }
+    if (result.action === 'BLOCK') {
+        throw new CarapaceBlockedError(result);
+    }
+    if (result.action === 'WARN' && verbose) {
+        const ts = new Date().toISOString().slice(11, 23);
+        console.error(`  ${ts} [carapace] WARN: ${result.summary}`);
+    }
+}
+/**
+ * Scan fields and return true if content is clean (PASS/LOG/WARN), false if BLOCK.
+ * Used for read-side filtering — poisoned data is silently dropped, not thrown.
+ */
+function isClean(guard, fields, verbose, telemetry) {
+    const text = fields.filter(Boolean).join(' ');
+    if (!text)
+        return true;
+    const result = guard.scan(text);
+    if (result.action === 'BLOCK') {
+        if (verbose) {
+            const ts = new Date().toISOString().slice(11, 23);
+            console.error(`  ${ts} [carapace] READ BLOCKED: score=${result.score} — poisoned entry filtered out`);
+        }
+        telemetry?.record('guard_scan', {
+            action: 'BLOCK', score: result.score,
+            findingsCount: result.findings.length, side: 'read',
+        });
+        return false;
+    }
+    return true;
+}
+function stringify(v) {
+    if (typeof v === 'string')
+        return v;
+    if (v == null)
+        return '';
+    return JSON.stringify(v);
+}
+/**
+ * Wrap store methods with Carapace scanning.
+ * Writes throw CarapaceBlockedError on BLOCK. Reads silently filter out poisoned entries.
+ * Internal system events bypass the guard.
+ */
+export function createGuardedStores(stores, guard, verbose, telemetry) {
+    // ClaimStore and DiscoveryStore emit internal events like "claim.acquired" and
+    // "discovery.published" — these are system-generated and bypass the guard.
+    // We only guard user-facing methods.
+    return {
+        state: {
+            set: async (key, value, agentId, category, ttlMs) => {
+                scanFields(guard, [key, stringify(value), category], verbose, telemetry);
+                return stores.state.set(key, value, agentId, category, ttlMs);
+            },
+            get: async (key) => {
+                const entry = await stores.state.get(key);
+                if (!entry)
+                    return null;
+                if (!isClean(guard, [entry.key, stringify(entry.value), entry.category], verbose, telemetry))
+                    return null;
+                return entry;
+            },
+            delete: (key) => stores.state.delete(key),
+            query: async (pattern, category) => {
+                const entries = await stores.state.query(pattern, category);
+                return entries.filter(e => isClean(guard, [e.key, stringify(e.value), e.category], verbose, telemetry));
+            },
+            getAll: () => stores.state.getAll(),
+            load: (entries) => stores.state.load(entries),
+        },
+        events: {
+            publish: async (type, data, agentId) => {
+                scanFields(guard, [type, stringify(data)], verbose, telemetry);
+                return stores.events.publish(type, data, agentId);
+            },
+            getEvents: async (since, type) => {
+                const result = await stores.events.getEvents(since, type);
+                return {
+                    events: result.events.filter(e => isClean(guard, [e.type, stringify(e.data)], verbose, telemetry)),
+                    cursor: result.cursor,
+                };
+            },
+            getCursor: () => stores.events.getCursor(),
+            getAll: () => stores.events.getAll(),
+            load: (events, cursor) => stores.events.load(events, cursor),
+        },
+        claims: {
+            claim: async (resource, value, agentId, ttlMs) => {
+                scanFields(guard, [resource, value], verbose, telemetry);
+                return stores.claims.claim(resource, value, agentId, ttlMs);
+            },
+            release: (resource, agentId) => stores.claims.release(resource, agentId),
+            check: async (resource) => {
+                const claim = await stores.claims.check(resource);
+                if (!claim)
+                    return null;
+                if (!isClean(guard, [claim.resource, claim.value], verbose, telemetry))
+                    return null;
+                return claim;
+            },
+            list: async (pattern) => {
+                const claims = await stores.claims.list(pattern);
+                return claims.filter(c => isClean(guard, [c.resource, c.value], verbose, telemetry));
+            },
+            getAll: () => stores.claims.getAll(),
+            load: (claims) => stores.claims.load(claims),
+        },
+        discoveries: {
+            publish: async (topic, content, agentId, category) => {
+                scanFields(guard, [topic, content, category], verbose, telemetry);
+                return stores.discoveries.publish(topic, content, agentId, category);
+            },
+            search: async (query, category) => {
+                const discoveries = await stores.discoveries.search(query, category);
+                return discoveries.filter(d => isClean(guard, [d.topic, d.content, d.category], verbose, telemetry));
+            },
+            getAll: () => stores.discoveries.getAll(),
+            load: (discoveries) => stores.discoveries.load(discoveries),
+        },
+        messages: {
+            send: async (from, to, content, replyTo) => {
+                scanFields(guard, [content], verbose, telemetry);
+                return stores.messages.send(from, to, content, replyTo);
+            },
+            getFor: (agentId, since) => stores.messages.getFor(agentId, since),
+            getAll: () => stores.messages.getAll(),
+        },
+        help: {
+            request: async (agentId, problem, needsCapability, urgency) => {
+                scanFields(guard, [problem, needsCapability], verbose, telemetry);
+                return stores.help.request(agentId, problem, needsCapability, urgency);
+            },
+            claim: (requestId, agentId) => stores.help.claim(requestId, agentId),
+            resolve: (requestId, agentId) => stores.help.resolve(requestId, agentId),
+            list: (status) => stores.help.list(status),
+        },
+        progress: stores.progress,
+        conflicts: stores.conflicts,
+        roles: stores.roles,
+        proposals: stores.proposals,
+        reinforcements: stores.reinforcements,
+        control: stores.control,
+        runs: stores.runs,
+    };
+}
+/**
+ * Scan a snapshot's entries on load. Returns counts of blocked items.
+ * Mutates the snapshot arrays in place, removing poisoned entries.
+ */
+export function scanSnapshot(snapshot, guard, verbose, telemetry) {
+    let blocked = 0;
+    const scanAndFilter = (items, getFields) => {
+        return items.filter(item => {
+            if (isClean(guard, getFields(item), verbose, telemetry))
+                return true;
+            blocked++;
+            return false;
+        });
+    };
+    snapshot.state = scanAndFilter(snapshot.state, e => [e.key, stringify(e.value), e.category]);
+    snapshot.claims = scanAndFilter(snapshot.claims, c => [c.resource, c.value]);
+    snapshot.events = scanAndFilter(snapshot.events, e => [e.type, stringify(e.data)]);
+    snapshot.discoveries = scanAndFilter(snapshot.discoveries, d => [d.topic, d.content, d.category]);
+    if (blocked > 0) {
+        console.error(`[incubator] Carapace: ${blocked} poisoned entries removed from snapshot`);
+        telemetry?.record('guard_scan', {
+            action: 'BLOCK', side: 'snapshot', blockedCount: blocked,
+        });
+    }
+    return { blocked };
+}
+//# sourceMappingURL=guard.js.map

package/dist/guard.js.map

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

package/dist/heartbeat.d.ts

@@ -0,0 +1,41 @@
+import type { Stores } from './stores/interfaces.js';
+/** Heartbeat config from protocol governance (avoids spec version dependency) */
+interface HeartbeatGovernance {
+    heartbeat?: {
+        stale_after_ms?: number;
+        dead_after_ms?: number;
+        auto_release_claims?: boolean;
+    };
+}
+export interface HeartbeatConfig {
+    stale_after_ms: number;
+    dead_after_ms: number;
+    auto_release_claims: boolean;
+    check_interval_ms: number;
+}
+export declare class HeartbeatMonitor {
+    private lastActivity;
+    private staleNotified;
+    private deadNotified;
+    private config;
+    private stores;
+    private timer;
+    constructor(stores: Stores, governance?: HeartbeatGovernance);
+    /** Record activity for an agent (called on every API request) */
+    touch(agentId: string): void;
+    /** Start the periodic check timer */
+    start(): void;
+    /** Stop the timer */
+    stop(): void;
+    /** Run a single check cycle (public for testing) */
+    check(): Promise<void>;
+    private handleStale;
+    private handleDeath;
+    /** Get all tracked agents and their status */
+    getStatus(): Array<{
+        agent: string;
+        lastActivity: number;
+        status: 'alive' | 'stale' | 'dead';
+    }>;
+}
+export {};

package/dist/heartbeat.js

@@ -0,0 +1,104 @@
+const DEFAULTS = {
+    stale_after_ms: 30000,
+    dead_after_ms: 60000,
+    auto_release_claims: true,
+    check_interval_ms: 10000,
+};
+export class HeartbeatMonitor {
+    lastActivity = new Map();
+    staleNotified = new Set();
+    deadNotified = new Set();
+    config;
+    stores;
+    timer = null;
+    constructor(stores, governance) {
+        this.stores = stores;
+        this.config = {
+            stale_after_ms: governance?.heartbeat?.stale_after_ms ?? DEFAULTS.stale_after_ms,
+            dead_after_ms: governance?.heartbeat?.dead_after_ms ?? DEFAULTS.dead_after_ms,
+            auto_release_claims: governance?.heartbeat?.auto_release_claims ?? DEFAULTS.auto_release_claims,
+            check_interval_ms: DEFAULTS.check_interval_ms,
+        };
+    }
+    /** Record activity for an agent (called on every API request) */
+    touch(agentId) {
+        this.lastActivity.set(agentId, Date.now());
+        // If agent was stale, clear stale notification (they came back)
+        this.staleNotified.delete(agentId);
+        this.deadNotified.delete(agentId);
+    }
+    /** Start the periodic check timer */
+    start() {
+        if (this.timer)
+            return;
+        this.timer = setInterval(() => this.check(), this.config.check_interval_ms);
+    }
+    /** Stop the timer */
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    /** Run a single check cycle (public for testing) */
+    async check() {
+        const now = Date.now();
+        for (const [agentId, lastTime] of this.lastActivity) {
+            const elapsed = now - lastTime;
+            if (elapsed >= this.config.dead_after_ms && !this.deadNotified.has(agentId)) {
+                await this.handleDeath(agentId);
+                this.deadNotified.add(agentId);
+            }
+            else if (elapsed >= this.config.stale_after_ms && !this.staleNotified.has(agentId)) {
+                await this.handleStale(agentId);
+                this.staleNotified.add(agentId);
+            }
+        }
+    }
+    async handleStale(agentId) {
+        const assignment = await this.stores.roles.getByAgent(agentId);
+        await this.stores.events.publish('agent.stale', {
+            agent: agentId,
+            role: assignment?.role,
+            last_activity: new Date(this.lastActivity.get(agentId)).toISOString(),
+        }, 'server');
+    }
+    async handleDeath(agentId) {
+        const assignment = await this.stores.roles.getByAgent(agentId);
+        const releasedClaims = [];
+        if (this.config.auto_release_claims) {
+            const claims = await this.stores.claims.list();
+            for (const claim of claims) {
+                if (claim.owner === agentId) {
+                    await this.stores.claims.release(claim.resource, agentId);
+                    releasedClaims.push(claim.resource);
+                }
+            }
+        }
+        // Remove role assignment
+        await this.stores.roles.remove(agentId);
+        await this.stores.events.publish('agent.died', {
+            agent: agentId,
+            role: assignment?.role,
+            released_claims: releasedClaims,
+        }, 'server');
+        // Clean up tracking
+        this.lastActivity.delete(agentId);
+    }
+    /** Get all tracked agents and their status */
+    getStatus() {
+        const now = Date.now();
+        const result = [];
+        for (const [agentId, lastTime] of this.lastActivity) {
+            const elapsed = now - lastTime;
+            let status = 'alive';
+            if (elapsed >= this.config.dead_after_ms)
+                status = 'dead';
+            else if (elapsed >= this.config.stale_after_ms)
+                status = 'stale';
+            result.push({ agent: agentId, lastActivity: lastTime, status });
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/heartbeat.js.map

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