@honeybee-ai/incubator 1.1.0

package/dist/transports/ipc.js

@@ -0,0 +1,93 @@
+/**
+ * IPCTransport — Unix socket client for cross-incubator Honeycomb events.
+ *
+ * Connects to the IPCBroker started by `wgl up`. Sends/receives NDJSON
+ * messages over a Unix domain socket.
+ */
+import { connect } from 'node:net';
+export class IPCTransport {
+    socket = null;
+    handlers = new Map();
+    buffer = '';
+    opts;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async connect() {
+        return new Promise((resolve, reject) => {
+            const sock = connect(this.opts.socketPath, () => {
+                this.socket = sock;
+                // Register with broker
+                this.send({
+                    type: 'register',
+                    hive: this.opts.hiveName,
+                    publishes: this.opts.publishes,
+                    subscribes: this.opts.subscribes,
+                });
+                resolve();
+            });
+            sock.setEncoding('utf8');
+            sock.on('data', (chunk) => this.onData(chunk));
+            sock.on('error', (err) => {
+                if (!this.socket)
+                    reject(err);
+            });
+        });
+    }
+    async publish(topic, event) {
+        this.send({
+            type: 'event',
+            hive: this.opts.hiveName,
+            topic,
+            event,
+        });
+    }
+    subscribe(topic, handler) {
+        let set = this.handlers.get(topic);
+        if (!set) {
+            set = new Set();
+            this.handlers.set(topic, set);
+        }
+        set.add(handler);
+        return () => {
+            set.delete(handler);
+            if (set.size === 0)
+                this.handlers.delete(topic);
+        };
+    }
+    async close() {
+        this.handlers.clear();
+        if (this.socket) {
+            this.socket.end();
+            this.socket = null;
+        }
+    }
+    send(msg) {
+        if (this.socket) {
+            this.socket.write(JSON.stringify(msg) + '\n');
+        }
+    }
+    onData(chunk) {
+        this.buffer += chunk;
+        const lines = this.buffer.split('\n');
+        this.buffer = lines.pop(); // keep incomplete line in buffer
+        for (const line of lines) {
+            if (!line)
+                continue;
+            try {
+                const msg = JSON.parse(line);
+                if (msg.type === 'forward') {
+                    const set = this.handlers.get(msg.topic);
+                    if (set) {
+                        for (const handler of set)
+                            handler(msg.event);
+                    }
+                }
+            }
+            catch {
+                // Ignore malformed messages
+            }
+        }
+    }
+}
+//# sourceMappingURL=ipc.js.map

package/dist/transports/ipc.js.map

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

package/dist/transports/types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Honeycomb transport layer — cross-incubator event routing.
+ *
+ * Level 1 (within-incubator) uses TopicRouter directly.
+ * Level 2 (cross-incubator) uses HoneycombTransport over IPC/TCP.
+ */
+export interface TopicEvent {
+    sourceHive: string;
+    topic: string;
+    data: unknown;
+    publishedBy: string;
+    timestamp: string;
+}
+export interface HoneycombTransport {
+    /** Publish a topic event to remote hives. */
+    publish(topic: string, event: TopicEvent): Promise<void>;
+    /** Subscribe to incoming events for a topic. Returns unsubscribe fn. */
+    subscribe(topic: string, handler: (event: TopicEvent) => void): () => void;
+    /** Connect to broker (if applicable). */
+    connect(): Promise<void>;
+    /** Disconnect from broker. */
+    close(): Promise<void>;
+}
+/** Wire protocol messages (NDJSON over Unix socket). */
+export type BrokerMessage = {
+    type: 'register';
+    hive: string;
+    publishes: string[];
+    subscribes: string[];
+} | {
+    type: 'event';
+    hive: string;
+    topic: string;
+    event: TopicEvent;
+} | {
+    type: 'forward';
+    topic: string;
+    event: TopicEvent;
+};

package/dist/transports/types.js

@@ -0,0 +1,8 @@
+/**
+ * Honeycomb transport layer — cross-incubator event routing.
+ *
+ * Level 1 (within-incubator) uses TopicRouter directly.
+ * Level 2 (cross-incubator) uses HoneycombTransport over IPC/TCP.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/transports/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/transports/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/types.d.ts

@@ -0,0 +1,45 @@
+export interface StateEntry {
+    key: string;
+    value: unknown;
+    category?: string;
+    setBy: string;
+    setAt: string;
+    updatedAt: string;
+    ttlMs?: number;
+}
+export interface Claim {
+    resource: string;
+    value: string;
+    owner: string;
+    status: 'active' | 'released' | 'expired';
+    claimedAt: string;
+    ttlMs?: number;
+}
+export interface IncubatorEvent {
+    id: number;
+    type: string;
+    data: unknown;
+    publishedBy: string;
+    publishedAt: string;
+}
+export interface Discovery {
+    id: string;
+    topic: string;
+    content: string;
+    category?: string;
+    publishedBy: string;
+    publishedAt: string;
+}
+export interface ClaimResult {
+    status: 'approved' | 'rejected';
+    claim: Claim;
+}
+export type { Message, HelpRequest, ProgressReport, Conflict, RoleAssignment, ReinforcementRequest, Proposal, } from '@agentcoordinationprotocol/spec';
+export interface Snapshot {
+    state: StateEntry[];
+    claims: Claim[];
+    events: IncubatorEvent[];
+    discoveries: Discovery[];
+    eventCursor: number;
+    savedAt: string;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils.d.ts

@@ -0,0 +1,3 @@
+export declare function generateId(): string;
+export declare function matchGlob(pattern: string, text: string): boolean;
+export declare function isExpired(timestamp: string, ttlMs?: number): boolean;

package/dist/utils.js

@@ -0,0 +1,36 @@
+let idCounter = 0;
+export function generateId() {
+    return `${Date.now()}-${++idCounter}`;
+}
+export function matchGlob(pattern, text) {
+    // Linear-time wildcard matching (no regex, no backtracking)
+    let pi = 0, ti = 0;
+    let starP = -1, starT = -1;
+    while (ti < text.length) {
+        if (pi < pattern.length && (pattern[pi] === '?' || pattern[pi] === text[ti])) {
+            pi++;
+            ti++;
+        }
+        else if (pi < pattern.length && pattern[pi] === '*') {
+            starP = pi++;
+            starT = ti;
+        }
+        else if (starP >= 0) {
+            pi = starP + 1;
+            ti = ++starT;
+        }
+        else {
+            return false;
+        }
+    }
+    while (pi < pattern.length && pattern[pi] === '*')
+        pi++;
+    return pi === pattern.length;
+}
+export function isExpired(timestamp, ttlMs) {
+    if (!ttlMs)
+        return false;
+    const created = new Date(timestamp).getTime();
+    return Date.now() > created + ttlMs;
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,IAAI,SAAS,GAAG,CAAC,CAAC;AAElB,MAAM,UAAU,UAAU;IACxB,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,IAAY;IACrD,4DAA4D;IAC5D,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACnB,IAAI,KAAK,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;IAC3B,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACxB,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,GAAG,IAAI,OAAO,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAC7E,EAAE,EAAE,CAAC;YAAC,EAAE,EAAE,CAAC;QACb,CAAC;aAAM,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,EAAE,CAAC,KAAK,GAAG,EAAE,CAAC;YACtD,KAAK,GAAG,EAAE,EAAE,CAAC;YAAC,KAAK,GAAG,EAAE,CAAC;QAC3B,CAAC;aAAM,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACtB,EAAE,GAAG,KAAK,GAAG,CAAC,CAAC;YAAC,EAAE,GAAG,EAAE,KAAK,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,EAAE,CAAC,KAAK,GAAG;QAAE,EAAE,EAAE,CAAC;IACxD,OAAO,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,SAAiB,EAAE,KAAc;IACzD,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;IAC9C,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,GAAG,KAAK,CAAC;AACtC,CAAC"}

package/dist/waggle/client.d.ts

@@ -0,0 +1,16 @@
+import type { ToolClient } from '../agent/tool-client.js';
+import type { ToolDef } from '../agent/types.js';
+import type { CompoundContext } from './compound.js';
+/**
+ * ToolClient that wraps the compound handler.
+ * The runner sees exactly ONE tool (waggle). All operations
+ * are batched and routed internally by the compound handler.
+ */
+export declare class WaggleToolClient implements ToolClient {
+    private ctx;
+    constructor(ctx: CompoundContext);
+    getToolDefs(): ToolDef[];
+    hasToolName(name: string): boolean;
+    callTool(_name: string, args: Record<string, unknown>): Promise<string>;
+    close(): Promise<void>;
+}

package/dist/waggle/client.js

@@ -0,0 +1,28 @@
+import { compoundHandler } from './compound.js';
+import { WAGGLE_TOOL_DEF, parseWaggleArgs } from './index.js';
+/**
+ * ToolClient that wraps the compound handler.
+ * The runner sees exactly ONE tool (waggle). All operations
+ * are batched and routed internally by the compound handler.
+ */
+export class WaggleToolClient {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    getToolDefs() {
+        return [WAGGLE_TOOL_DEF];
+    }
+    hasToolName(name) {
+        return name === 'waggle';
+    }
+    async callTool(_name, args) {
+        const parsed = parseWaggleArgs(args);
+        const result = await compoundHandler(parsed, this.ctx);
+        return JSON.stringify(result);
+    }
+    async close() {
+        // No-op — compound handler has no connections to close
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/waggle/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/waggle/client.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE9D;;;;GAIG;AACH,MAAM,OAAO,gBAAgB;IACP;IAApB,YAAoB,GAAoB;QAApB,QAAG,GAAH,GAAG,CAAiB;IAAG,CAAC;IAE5C,WAAW;QACT,OAAO,CAAC,eAAe,CAAC,CAAC;IAC3B,CAAC;IAED,WAAW,CAAC,IAAY;QACtB,OAAO,IAAI,KAAK,QAAQ,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAa,EAAE,IAA6B;QACzD,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,MAAqB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QACtE,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,uDAAuD;IACzD,CAAC;CACF"}

package/dist/waggle/compound.d.ts

@@ -0,0 +1,22 @@
+import type { WaggleInput, WaggleResult, WaitSpec, NormalizedWait, AcpBackend, Primitives } from './types.js';
+import type { ToolResult } from '../propolis/tools/types.js';
+import type { TelemetryReporter } from '@honeybee-ai/hivemind-sdk/telemetry';
+import type { PluginManager } from '../plugins/index.js';
+type EnvHandler = (args: Record<string, unknown>) => Promise<ToolResult>;
+/** Build env handler map from PluginManager (replaces propolis-direct loading). */
+export declare function createHandlerMap(pluginManager: PluginManager): Map<string, EnvHandler>;
+export interface CompoundContext {
+    /** Map of handler name → handler function (from PluginManager). */
+    handlers: Map<string, EnvHandler>;
+    /** ACP backend for coordination ops (null = no coordination). */
+    acp?: AcpBackend | null;
+    /** Allowed primitives per role (null = all allowed). */
+    primitives?: Primitives | null;
+    /** Telemetry reporter (optional). */
+    telemetry?: TelemetryReporter;
+    /** Dynamic env action names (from PluginManager). Falls back to DEFAULT_ENV_ACTIONS. */
+    envActions?: Set<string>;
+}
+export declare function normalizeWait(spec: WaitSpec | undefined | false): NormalizedWait | null;
+export declare function compoundHandler(input: WaggleInput, ctx: CompoundContext): Promise<WaggleResult>;
+export {};

package/dist/waggle/compound.js

@@ -0,0 +1,194 @@
+/** Build env handler map from PluginManager (replaces propolis-direct loading). */
+export function createHandlerMap(pluginManager) {
+    return pluginManager.getHandlerMap();
+}
+// ─── Action name mapping ────────────────────────────────────────────
+/** Map waggle action names to propolis handler names where they differ. */
+const ENV_ACTION_MAP = {
+    shell: 'run',
+    scrape: 'scrape_page',
+};
+/** ACP coordination primitives. */
+const ACP_ACTIONS = new Set(['publish', 'claim', 'release', 'get_state', 'set_state']);
+/**
+ * All known env action names.
+ * Populated dynamically from PluginManager, plus waggle aliases.
+ * Falls back to the classic set when no PluginManager is wired.
+ */
+const DEFAULT_ENV_ACTIONS = new Set([
+    'read_file', 'write_file', 'patch_file', 'list_files', 'glob', 'grep',
+    'shell', 'git_status', 'git_diff', 'git_commit', 'git_log',
+    'fetch', 'scrape',
+    'pty_spawn', 'pty_send', 'pty_read', 'pty_resize', 'pty_close',
+]);
+// ─── Wait normalization ─────────────────────────────────────────────
+export function normalizeWait(spec) {
+    if (spec === undefined || spec === false || spec === null)
+        return null;
+    if (spec === true)
+        return { types: null, timeout: 0, pureDelay: false };
+    if (typeof spec === 'string')
+        return { types: [spec], timeout: 0, pureDelay: false };
+    if (Array.isArray(spec))
+        return { types: spec.length > 0 ? spec : null, timeout: 0, pureDelay: false };
+    if (typeof spec === 'number')
+        return { types: null, timeout: spec, pureDelay: true };
+    return {
+        types: spec.types && spec.types.length > 0 ? spec.types : null,
+        timeout: spec.timeout ?? 0,
+        pureDelay: false,
+    };
+}
+// ─── Compound handler ───────────────────────────────────────────────
+export async function compoundHandler(input, ctx) {
+    const results = [];
+    const envActions = ctx.envActions ?? DEFAULT_ENV_ACTIONS;
+    // Execute ops sequentially
+    for (const op of input.dance) {
+        const action = op.do;
+        const opStart = Date.now();
+        if (ACP_ACTIONS.has(action)) {
+            // Check ACP primitive filtering
+            if (ctx.primitives?.acp && !ctx.primitives.acp.includes(action)) {
+                results.push({ op: action, ok: false, error: `action '${action}' not permitted for this role` });
+                continue;
+            }
+            const result = await executeAcpOp(op, ctx.acp);
+            ctx.telemetry?.record('tool_call', { action, success: result.ok, latency_ms: Date.now() - opStart });
+            results.push(result);
+        }
+        else if (envActions.has(action) || ctx.handlers.has(action) || ctx.handlers.has(ENV_ACTION_MAP[action] ?? '')) {
+            // Check env primitive filtering
+            if (ctx.primitives?.env && !ctx.primitives.env.includes(action)) {
+                results.push({ op: action, ok: false, error: `action '${action}' not permitted for this role` });
+                continue;
+            }
+            const result = await executeEnvOp(op, ctx.handlers, envActions);
+            ctx.telemetry?.record('tool_call', { action, success: result.ok, latency_ms: Date.now() - opStart });
+            results.push(result);
+        }
+        else {
+            results.push({ op: action, ok: false, error: `unknown action: '${action}'` });
+        }
+    }
+    // Handle wait
+    const waitSpec = normalizeWait(input.wait);
+    let wakeEvents;
+    if (waitSpec) {
+        if (waitSpec.pureDelay) {
+            // Pure delay — just sleep, no event matching
+            await new Promise(r => setTimeout(r, waitSpec.timeout));
+            wakeEvents = [];
+        }
+        else if (ctx.acp) {
+            wakeEvents = await ctx.acp.waitForWake({
+                types: waitSpec.types,
+                timeout: waitSpec.timeout,
+            });
+        }
+        else {
+            // No ACP backend — sleep if timeout, else return immediately
+            if (waitSpec.timeout > 0) {
+                await new Promise(r => setTimeout(r, waitSpec.timeout));
+            }
+            wakeEvents = [];
+        }
+    }
+    return {
+        results,
+        ...(wakeEvents !== undefined ? { wakeEvents } : {}),
+    };
+}
+// ─── Env op execution ───────────────────────────────────────────────
+async function executeEnvOp(op, handlers, envActions = DEFAULT_ENV_ACTIONS) {
+    const action = op.do;
+    const handlerName = ENV_ACTION_MAP[action] ?? action;
+    const handler = handlers.get(handlerName);
+    if (!handler) {
+        if (envActions.has(action)) {
+            return { op: action, ok: false, error: 'Environment tools not available. Install @honeybee-ai/propolis.' };
+        }
+        return { op: action, ok: false, error: `unknown action: '${action}'` };
+    }
+    try {
+        // Build args — everything except 'do'
+        const args = {};
+        for (const [k, v] of Object.entries(op)) {
+            if (k !== 'do')
+                args[k] = v;
+        }
+        // Map git_diff 'cached' → 'staged' for handler compatibility
+        if (action === 'git_diff' && 'cached' in args) {
+            args.staged = args.cached;
+            delete args.cached;
+        }
+        // Map git_commit 'files' array → comma-separated string
+        if (action === 'git_commit' && Array.isArray(args.files)) {
+            args.files = args.files.join(',');
+        }
+        const result = await handler(args);
+        return unwrapToolResult(action, result);
+    }
+    catch (err) {
+        return { op: action, ok: false, error: err.message };
+    }
+}
+// ─── ACP op execution ───────────────────────────────────────────────
+async function executeAcpOp(op, acp) {
+    if (!acp) {
+        return { op: op.do, ok: false, error: 'no ACP backend available' };
+    }
+    try {
+        let resultStr;
+        switch (op.do) {
+            case 'publish':
+                resultStr = await acp.publishEvent(op.type, op.data ?? {});
+                break;
+            case 'claim':
+                resultStr = await acp.claimResource(op.resource, op.value);
+                break;
+            case 'release':
+                resultStr = await acp.releaseResource(op.resource);
+                break;
+            case 'get_state':
+                resultStr = await acp.getState();
+                break;
+            case 'set_state':
+                resultStr = await acp.setState(op.key, op.value);
+                break;
+            default:
+                return { op: op.do, ok: false, error: `unknown ACP action: '${op.do}'` };
+        }
+        return unwrapJsonResult(op.do, resultStr);
+    }
+    catch (err) {
+        return { op: op.do, ok: false, error: err.message };
+    }
+}
+// ─── Result unwrapping ──────────────────────────────────────────────
+function unwrapToolResult(action, result) {
+    const text = result.content?.[0]?.text ?? JSON.stringify(result);
+    try {
+        const parsed = JSON.parse(text);
+        if (parsed.error) {
+            return { op: action, ok: false, error: parsed.error };
+        }
+        return { op: action, ok: true, data: parsed };
+    }
+    catch {
+        return { op: action, ok: true, data: text };
+    }
+}
+function unwrapJsonResult(action, resultStr) {
+    try {
+        const parsed = JSON.parse(resultStr);
+        if (parsed.error) {
+            return { op: action, ok: false, error: parsed.error };
+        }
+        return { op: action, ok: true, data: parsed };
+    }
+    catch {
+        return { op: action, ok: true, data: resultStr };
+    }
+}
+//# sourceMappingURL=compound.js.map

package/dist/waggle/compound.js.map

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

package/dist/waggle/index.d.ts

@@ -0,0 +1,25 @@
+export { compoundHandler, normalizeWait, createHandlerMap } from './compound.js';
+export type { CompoundContext } from './compound.js';
+export { WaggleToolClient } from './client.js';
+export type { WaggleInput, WaggleResult, WaitSpec, NormalizedWait, Operation, OpResult, AcpBackend, Primitives, } from './types.js';
+import type { ToolDef } from '../agent/types.js';
+/** All known waggle action names. */
+export declare const ALL_ACTIONS: readonly ["read_file", "write_file", "patch_file", "list_files", "glob", "grep", "shell", "git_status", "git_diff", "git_commit", "git_log", "fetch", "scrape", "publish", "claim", "release", "get_state", "set_state"];
+export declare const ENV_ACTIONS: ("claim" | "shell" | "scrape" | "publish" | "release" | "get_state" | "set_state" | "read_file" | "write_file" | "patch_file" | "list_files" | "glob" | "grep" | "git_status" | "git_diff" | "git_commit" | "git_log" | "fetch")[];
+export declare const ACP_ACTIONS: ("claim" | "shell" | "scrape" | "publish" | "release" | "get_state" | "set_state" | "read_file" | "write_file" | "patch_file" | "list_files" | "glob" | "grep" | "git_status" | "git_diff" | "git_commit" | "git_log" | "fetch")[];
+/**
+ * Single tool definition for the LLM.
+ * The agent sees exactly ONE tool, no matter how many capabilities exist underneath.
+ */
+export declare const WAGGLE_TOOL_DEF: ToolDef;
+/**
+ * Parse the LLM's waggle tool call args into WaggleInput.
+ * The LLM sends ops as a JSON string (or already-parsed array).
+ */
+export declare function parseWaggleArgs(args: Record<string, unknown>): {
+    dance: Array<{
+        do: string;
+        [k: string]: unknown;
+    }>;
+    wait?: unknown;
+};

package/dist/waggle/index.js

@@ -0,0 +1,77 @@
+export { compoundHandler, normalizeWait, createHandlerMap } from './compound.js';
+export { WaggleToolClient } from './client.js';
+/** All known waggle action names. */
+export const ALL_ACTIONS = [
+    // Env
+    'read_file', 'write_file', 'patch_file', 'list_files', 'glob', 'grep',
+    'shell', 'git_status', 'git_diff', 'git_commit', 'git_log',
+    'fetch', 'scrape',
+    // ACP
+    'publish', 'claim', 'release', 'get_state', 'set_state',
+];
+export const ENV_ACTIONS = ALL_ACTIONS.slice(0, 13);
+export const ACP_ACTIONS = ALL_ACTIONS.slice(13);
+/**
+ * Single tool definition for the LLM.
+ * The agent sees exactly ONE tool, no matter how many capabilities exist underneath.
+ */
+export const WAGGLE_TOOL_DEF = {
+    type: 'function',
+    function: {
+        name: 'waggle',
+        description: [
+            'Execute operations and optionally wait for events. Ops run sequentially.',
+            'Actions: read_file, write_file, patch_file, list_files, glob, grep, shell,',
+            'git_status, git_diff, git_commit, git_log, fetch, scrape,',
+            'publish, claim, release, get_state, set_state.',
+            'Wait: true (any event), "type" (specific), ["a","b"] (any of), number (sleep ms), {types,timeout}.',
+        ].join(' '),
+        parameters: {
+            type: 'object',
+            properties: {
+                dance: {
+                    type: 'string',
+                    description: 'JSON array of operations. Each op: { "do": "action", ...params }. Example: [{"do":"read_file","path":"src/index.ts"},{"do":"publish","type":"file.read","data":{"path":"src/index.ts"}}]',
+                },
+                wait: {
+                    type: 'string',
+                    description: 'Optional wait spec after ops. true, "event_type", ["a","b"], 30000, or {"types":["a"],"timeout":5000}. Omit for no wait.',
+                },
+            },
+            required: ['dance'],
+        },
+    },
+};
+/**
+ * Parse the LLM's waggle tool call args into WaggleInput.
+ * The LLM sends ops as a JSON string (or already-parsed array).
+ */
+export function parseWaggleArgs(args) {
+    const raw = args.dance;
+    let dance;
+    if (typeof raw === 'string') {
+        dance = JSON.parse(raw);
+    }
+    else if (Array.isArray(raw)) {
+        dance = raw;
+    }
+    else {
+        dance = [];
+    }
+    let wait;
+    if (args.wait !== undefined) {
+        if (typeof args.wait === 'string') {
+            try {
+                wait = JSON.parse(args.wait);
+            }
+            catch {
+                wait = args.wait; // plain string event type
+            }
+        }
+        else {
+            wait = args.wait;
+        }
+    }
+    return { dance: dance, wait };
+}
+//# sourceMappingURL=index.js.map

package/dist/waggle/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/waggle/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAQ/C,qCAAqC;AACrC,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM;IACN,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM;IACrE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS;IAC1D,OAAO,EAAE,QAAQ;IACjB,MAAM;IACN,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW;CAC/C,CAAC;AAEX,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACpD,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAEjD;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAY;IACtC,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE;QACR,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE;YACX,0EAA0E;YAC1E,4EAA4E;YAC5E,2DAA2D;YAC3D,gDAAgD;YAChD,oGAAoG;SACrG,CAAC,IAAI,CAAC,GAAG,CAAC;QACX,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0LAA0L;iBACxM;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0HAA0H;iBACxI;aACF;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB;KACF;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAA6B;IAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC;IACvB,IAAI,KAAgB,CAAC;IACrB,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;SAAM,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,KAAK,GAAG,GAAG,CAAC;IACd,CAAC;SAAM,CAAC;QACN,KAAK,GAAG,EAAE,CAAC;IACb,CAAC;IAED,IAAI,IAAa,CAAC;IAClB,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAClC,IAAI,CAAC;gBACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/B,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,0BAA0B;YAC9C,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,KAAoD,EAAE,IAAI,EAAE,CAAC;AAC/E,CAAC"}