@oni.bot/core 0.6.3 → 1.0.0

package/dist/harness/validate-args.js

@@ -0,0 +1,132 @@
+// ============================================================
+// @oni.bot/core/harness — Tool Argument Validator
+// Lightweight JSON Schema subset validation for tool call args.
+// Catches malformed model outputs before they reach tool execute().
+// ============================================================
+/**
+ * Validate tool call arguments against the tool's JSON Schema.
+ * Returns null if valid, or a descriptive error string if invalid.
+ *
+ * Supports the JSON Schema subset used by our tool definitions:
+ * - type: "object", "string", "number", "integer", "boolean", "array"
+ * - required: string[] (required property names)
+ * - properties: Record<string, schema> (property schemas)
+ * - enum: any[] (allowed values)
+ * - items: schema (array item schema)
+ * - minimum, maximum (number bounds)
+ * - minLength, maxLength (string bounds)
+ */
+export function validateToolArgs(args, schema, toolName) {
+    // If no schema or empty schema, accept anything
+    if (!schema || Object.keys(schema).length === 0)
+        return null;
+    // args must be an object (tool args are always key-value pairs)
+    if (args === null || args === undefined) {
+        return `${toolName}: expected arguments object, got ${args === null ? "null" : "undefined"}`;
+    }
+    if (typeof args !== "object" || Array.isArray(args)) {
+        return `${toolName}: expected arguments object, got ${Array.isArray(args) ? "array" : typeof args}`;
+    }
+    const obj = args;
+    const errors = [];
+    // Check required properties
+    const required = schema.required;
+    if (required && Array.isArray(required)) {
+        for (const key of required) {
+            if (obj[key] === undefined || obj[key] === null) {
+                errors.push(`missing required parameter "${key}"`);
+            }
+        }
+    }
+    // Check property types
+    const properties = schema.properties;
+    if (properties && typeof properties === "object") {
+        for (const [key, propSchema] of Object.entries(properties)) {
+            const value = obj[key];
+            if (value === undefined || value === null)
+                continue; // missing handled by required check
+            const propError = validateValue(value, propSchema, key);
+            if (propError)
+                errors.push(propError);
+        }
+    }
+    if (errors.length === 0)
+        return null;
+    return `${toolName}: invalid arguments — ${errors.join("; ")}`;
+}
+/**
+ * Validate a single value against a property schema.
+ * Returns null if valid, or error string.
+ */
+function validateValue(value, schema, path) {
+    const expectedType = schema.type;
+    if (expectedType) {
+        const actual = getJSONType(value);
+        // "integer" accepts numbers that are whole
+        if (expectedType === "integer") {
+            if (typeof value !== "number" || !Number.isInteger(value)) {
+                return `"${path}" must be an integer, got ${actual}`;
+            }
+        }
+        else if (expectedType !== actual) {
+            // Allow number for "string" type (common model error — coerce)
+            // Allow boolean for "string" type (common model error — coerce)
+            // We DON'T coerce here — we just report the mismatch clearly
+            return `"${path}" must be type ${expectedType}, got ${actual}`;
+        }
+    }
+    // Enum check
+    const enumValues = schema.enum;
+    if (enumValues && Array.isArray(enumValues)) {
+        if (!enumValues.includes(value)) {
+            return `"${path}" must be one of [${enumValues.map(v => JSON.stringify(v)).join(", ")}], got ${JSON.stringify(value)}`;
+        }
+    }
+    // Number bounds
+    if (typeof value === "number") {
+        const min = schema.minimum;
+        const max = schema.maximum;
+        if (min !== undefined && value < min) {
+            return `"${path}" must be >= ${min}, got ${value}`;
+        }
+        if (max !== undefined && value > max) {
+            return `"${path}" must be <= ${max}, got ${value}`;
+        }
+    }
+    // String bounds
+    if (typeof value === "string") {
+        const minLen = schema.minLength;
+        const maxLen = schema.maxLength;
+        if (minLen !== undefined && value.length < minLen) {
+            return `"${path}" must have length >= ${minLen}, got ${value.length}`;
+        }
+        if (maxLen !== undefined && value.length > maxLen) {
+            return `"${path}" must have length <= ${maxLen}, got ${value.length}`;
+        }
+    }
+    // Array items
+    if (Array.isArray(value)) {
+        const MAX_ARRAY_ITEMS = 1000;
+        if (value.length > MAX_ARRAY_ITEMS) {
+            return `"${path}" array too large (${value.length} items, max ${MAX_ARRAY_ITEMS})`;
+        }
+        if (schema.items) {
+            const itemSchema = schema.items;
+            for (let i = 0; i < value.length; i++) {
+                const itemError = validateValue(value[i], itemSchema, `${path}[${i}]`);
+                if (itemError)
+                    return itemError;
+            }
+        }
+    }
+    return null;
+}
+/** Map a JS value to its JSON Schema type name */
+function getJSONType(value) {
+    if (value === null)
+        return "null";
+    if (Array.isArray(value))
+        return "array";
+    return typeof value; // "string", "number", "boolean", "object"
+}
+//# sourceMappingURL=validate-args.js.map

package/dist/harness/validate-args.js.map

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

package/dist/hitl/interrupt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interrupt.d.ts","sourceRoot":"","sources":["../../src/hitl/interrupt.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,KAAK,EAAK,OAAO,CAAC;IAClB,yCAAyC;IACzC,IAAI,EAAM,MAAM,CAAC;IACjB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAK,OAAO,CAAC;CACnB;AAMD,qBAAa,mBAAmB;aAGZ,KAAK,EAAK,OAAO;aACjB,QAAQ,EAAE,MAAM;IAHlC,QAAQ,CAAC,eAAe,QAAQ;gBAEd,KAAK,EAAK,OAAO,EACjB,QAAQ,EAAE,MAAM;CAEnC;AAMD,UAAU,gBAAgB;IACxB,QAAQ,EAAK,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,SAAS,EAAI,OAAO,CAAC;CACtB;AAKD,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAEpE;AAED,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED,wBAAgB,oBAAoB,IAAI,gBAAgB,GAAG,IAAI,CAE9D;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAkBvE;AAMD,MAAM,WAAW,mBAAmB;IAClC,+BAA+B;IAC/B,MAAM,EAAQ,MAAM,CAAC;IACrB,+CAA+C;IAC/C,KAAK,CAAC,EAAQ,MAAM,CAAC;IACrB,8DAA8D;IAC9D,QAAQ,CAAC,EAAK,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,GAAG,MAAM,CAAC;IACnD,+BAA+B;IAC/B,SAAS,CAAC,EAAI,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IAChE,6CAA6C;IAC7C,OAAO,CAAC,EAAM,MAAM,EAAE,CAAC;CACxB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAAC,CAAC,GAAG,OAAO,EAC5C,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,CAAC,CAAC,CAUZ;AAMD;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEtE;AAMD,wBAAsB,gBAAgB,CACpC,MAAM,EAAG,MAAM,EACf,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,MAAM,CAAC,CAEjB"}
+{"version":3,"file":"interrupt.d.ts","sourceRoot":"","sources":["../../src/hitl/interrupt.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,KAAK,EAAK,OAAO,CAAC;IAClB,yCAAyC;IACzC,IAAI,EAAM,MAAM,CAAC;IACjB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAK,OAAO,CAAC;CACnB;AAMD,qBAAa,mBAAmB;aAGZ,KAAK,EAAK,OAAO;aACjB,QAAQ,EAAE,MAAM;IAHlC,QAAQ,CAAC,eAAe,QAAQ;gBAEd,KAAK,EAAK,OAAO,EACjB,QAAQ,EAAE,MAAM;CAEnC;AAMD,UAAU,gBAAgB;IACxB,QAAQ,EAAK,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,SAAS,EAAI,OAAO,CAAC;CACtB;AAKD,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAEpE;AAED,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED,wBAAgB,oBAAoB,IAAI,gBAAgB,GAAG,IAAI,CAE9D;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAkBvE;AAMD,MAAM,WAAW,mBAAmB;IAClC,+BAA+B;IAC/B,MAAM,EAAQ,MAAM,CAAC;IACrB,+CAA+C;IAC/C,KAAK,CAAC,EAAQ,MAAM,CAAC;IACrB,8DAA8D;IAC9D,QAAQ,CAAC,EAAK,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,GAAG,MAAM,CAAC;IACnD,+BAA+B;IAC/B,SAAS,CAAC,EAAI,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IAChE,6CAA6C;IAC7C,OAAO,CAAC,EAAM,MAAM,EAAE,CAAC;CACxB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAAC,CAAC,GAAG,OAAO,EAC5C,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,CAAC,CAAC,CAUZ;AAMD;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEtE;AAMD,wBAAsB,gBAAgB,CACpC,MAAM,EAAG,MAAM,EACf,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,MAAM,CAAC,CAEjB"}

package/dist/hitl/interrupt.js

@@ -14,6 +14,7 @@
 // node to throw a structured interrupt that the runner catches,
 // checkpoints, and re-raises to the caller.
 // ============================================================
+import { AsyncLocalStorage } from "node:async_hooks";
 // ----------------------------------------------------------------
 // Internal signal — thrown inside a node, caught by Pregel runner
 // ----------------------------------------------------------------
@@ -26,16 +27,16 @@ export class NodeInterruptSignal {
         this.resumeId = resumeId;
     }
 }
-// Per-async-context slot (global for now; can be AsyncLocalStorage in Node)
-let _currentCtx = null;
+// AsyncLocalStorage slot — isolates concurrent executions
+const interruptALS = new AsyncLocalStorage();
 export function _installInterruptContext(ctx) {
-    _currentCtx = ctx;
+    interruptALS.enterWith(ctx);
 }
 export function _clearInterruptContext() {
-    _currentCtx = null;
+    interruptALS.enterWith(undefined);
 }
 export function _getInterruptContext() {
-    return _currentCtx;
+    return interruptALS.getStore() ?? null;
 }
 // ----------------------------------------------------------------
 // interrupt(value) — call this inside any node
@@ -57,7 +58,7 @@ export function _getInterruptContext() {
  * });
  */
 export async function interrupt(value) {
-    const ctx = _currentCtx;
+    const ctx = interruptALS.getStore();
     if (!ctx) {
         throw new Error("interrupt() called outside of an ONI node execution context. " +
             "Make sure you're calling interrupt() inside an addNode() function.");

package/dist/hitl/interrupt.js.map

@@ -1 +1 @@
-{"version":3,"file":"interrupt.js","sourceRoot":"","sources":["../../src/hitl/interrupt.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,gDAAgD;AAChD,+DAA+D;AAC/D,6DAA6D;AAC7D,2DAA2D;AAC3D,yDAAyD;AACzD,EAAE;AACF,8DAA8D;AAC9D,sEAAsE;AACtE,0EAA0E;AAC1E,EAAE;AACF,8DAA8D;AAC9D,gEAAgE;AAChE,gEAAgE;AAChE,4CAA4C;AAC5C,+DAA+D;AA2B/D,mEAAmE;AACnE,kEAAkE;AAClE,mEAAmE;AAEnE,MAAM,OAAO,mBAAmB;IAGZ;IACA;IAHT,eAAe,GAAG,IAAI,CAAC;IAChC,YACkB,KAAiB,EACjB,QAAgB;QADhB,UAAK,GAAL,KAAK,CAAY;QACjB,aAAQ,GAAR,QAAQ,CAAQ;IAC/B,CAAC;CACL;AAYD,4EAA4E;AAC5E,IAAI,WAAW,GAA4B,IAAI,CAAC;AAEhD,MAAM,UAAU,wBAAwB,CAAC,GAAqB;IAC5D,WAAW,GAAG,GAAG,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,mEAAmE;AACnE,+CAA+C;AAC/C,mEAAmE;AAEnE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAc,KAAc;IACzD,MAAM,GAAG,GAAG,WAAW,CAAC;IAExB,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,+DAA+D;YAC/D,oEAAoE,CACrE,CAAC;IACJ,CAAC;IAED,kEAAkE;IAClE,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAClB,OAAO,GAAG,CAAC,WAAgB,CAAC;IAC9B,CAAC;IAED,gEAAgE;IAChE,MAAM,QAAQ,GAAG,GAAG,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACxF,MAAM,IAAI,mBAAmB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AACjD,CAAC;AAmBD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAyB;IAEzB,OAAO,SAAS,CAAI;QAClB,MAAM,EAAK,oBAAoB;QAC/B,MAAM,EAAK,IAAI,CAAC,MAAM;QACtB,KAAK,EAAM,IAAI,CAAC,KAAK;QACrB,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,MAAM;QACnC,OAAO,EAAI,IAAI,CAAC,OAAO;QACvB,sDAAsD;QACtD,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ;KAC9B,CAAC,CAAC;AACL,CAAC;AAED,mEAAmE;AACnE,2CAA2C;AAC3C,mEAAmE;AAEnE;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAc;IAClD,OAAO,YAAY,CAAU,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,mEAAmE;AACnE,sCAAsC;AACtC,mEAAmE;AAEnE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAe,EACf,OAAiB;IAEjB,OAAO,YAAY,CAAS,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;AACxE,CAAC"}
+{"version":3,"file":"interrupt.js","sourceRoot":"","sources":["../../src/hitl/interrupt.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,gDAAgD;AAChD,+DAA+D;AAC/D,6DAA6D;AAC7D,2DAA2D;AAC3D,yDAAyD;AACzD,EAAE;AACF,8DAA8D;AAC9D,sEAAsE;AACtE,0EAA0E;AAC1E,EAAE;AACF,8DAA8D;AAC9D,gEAAgE;AAChE,gEAAgE;AAChE,4CAA4C;AAC5C,+DAA+D;AAE/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AA0BrD,mEAAmE;AACnE,kEAAkE;AAClE,mEAAmE;AAEnE,MAAM,OAAO,mBAAmB;IAGZ;IACA;IAHT,eAAe,GAAG,IAAI,CAAC;IAChC,YACkB,KAAiB,EACjB,QAAgB;QADhB,UAAK,GAAL,KAAK,CAAY;QACjB,aAAQ,GAAR,QAAQ,CAAQ;IAC/B,CAAC;CACL;AAYD,0DAA0D;AAC1D,MAAM,YAAY,GAAG,IAAI,iBAAiB,EAAoB,CAAC;AAE/D,MAAM,UAAU,wBAAwB,CAAC,GAAqB;IAC5D,YAAY,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,YAAY,CAAC,SAAS,CAAC,SAAgB,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,YAAY,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC;AACzC,CAAC;AAED,mEAAmE;AACnE,+CAA+C;AAC/C,mEAAmE;AAEnE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAc,KAAc;IACzD,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC;IAEpC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,+DAA+D;YAC/D,oEAAoE,CACrE,CAAC;IACJ,CAAC;IAED,kEAAkE;IAClE,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAClB,OAAO,GAAG,CAAC,WAAgB,CAAC;IAC9B,CAAC;IAED,gEAAgE;IAChE,MAAM,QAAQ,GAAG,GAAG,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACxF,MAAM,IAAI,mBAAmB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AACjD,CAAC;AAmBD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAyB;IAEzB,OAAO,SAAS,CAAI;QAClB,MAAM,EAAK,oBAAoB;QAC/B,MAAM,EAAK,IAAI,CAAC,MAAM;QACtB,KAAK,EAAM,IAAI,CAAC,KAAK;QACrB,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,MAAM;QACnC,OAAO,EAAI,IAAI,CAAC,OAAO;QACvB,sDAAsD;QACtD,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ;KAC9B,CAAC,CAAC;AACL,CAAC;AAED,mEAAmE;AACnE,2CAA2C;AAC3C,mEAAmE;AAEnE;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAc;IAClD,OAAO,YAAY,CAAU,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,mEAAmE;AACnE,sCAAsC;AACtC,mEAAmE;AAEnE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAe,EACf,OAAiB;IAEjB,OAAO,YAAY,CAAS,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;AACxE,CAAC"}

package/dist/index.d.ts

@@ -17,8 +17,8 @@ export { createInjectedTool } from "./injected.js";
 export type { InjectedTool, InjectedToolOptions } from "./injected.js";
 export { getConfig, getStore, getStreamWriter, getCurrentState, getRemainingSteps } from "./context.js";
 export type { RunContext, StreamWriter } from "./context.js";
-export { emitToken, TokenStreamWriter, StreamWriterImpl } from "./streaming.js";
-export type { TokenStreamEvent, AnyStreamEvent } from "./streaming.js";
+export { emitToken, TokenStreamWriter, StreamWriterImpl, BoundedBuffer } from "./streaming.js";
+export type { TokenStreamEvent, AnyStreamEvent, BackpressureStrategy } from "./streaming.js";
 export { streamEvents } from "./stream-events.js";
 export type { StreamEvent } from "./stream-events.js";
 export { buildGraphDescriptor, toMermaidDetailed } from "./inspect.js";
@@ -26,8 +26,12 @@ export type { GraphDescriptor, GraphNode, GraphEdge, NodeType } from "./inspect.
 export { entrypoint, pipe, branch, task } from "./functional.js";
 export type { TaskDef, EntrypointOptions, TaskOptions } from "./functional.js";
 export { withRetry } from "./retry.js";
-export { SwarmGraph, AgentRegistry, AgentPool, AgentPool as Pool, Handoff, createSupervisorNode, baseSwarmChannels, createMessage, getInbox, consumeInbox, formatInbox, } from "./swarm/index.js";
-export type { SwarmAgentDef, AgentStatus, AgentCapability, HandoffOptions, HandoffRecord, SwarmMessage, SwarmMeta, BaseSwarmState, SupervisorConfig, SupervisorState, SupervisorRoutingStrategy, RuleRoute, AgentPoolConfig, SwarmTopology, SwarmExtensions, HierarchicalConfig, FanOutConfig, PipelineConfig, PeerNetworkConfig, MapReduceConfig, DebateConfig, HierarchicalMeshConfig, } from "./swarm/index.js";
+export { CircuitBreaker } from "./circuit-breaker.js";
+export type { CircuitState, CircuitBreakerConfig } from "./circuit-breaker.js";
+export { DeadLetterQueue } from "./dlq.js";
+export type { DeadLetter } from "./dlq.js";
+export { SwarmGraph, AgentRegistry, AgentPool, AgentPool as Pool, Handoff, createSupervisorNode, baseSwarmChannels, quickAgent, createMessage, getInbox, consumeInbox, formatInbox, SwarmTracer, SwarmSnapshotStore, DynamicScalingMonitor, toSwarmMermaid, } from "./swarm/index.js";
+export type { SwarmAgentDef, AgentStatus, AgentCapability, AgentErrorContext, AgentLifecycleHooks, HandoffOptions, HandoffRecord, SwarmMessage, SwarmMeta, BaseSwarmState, SupervisorConfig, SupervisorState, SupervisorRoutingStrategy, RuleRoute, AgentPoolConfig, SwarmTopology, SwarmExtensions, SwarmCompileOptions, HierarchicalConfig, FanOutConfig, PipelineConfig, PeerNetworkConfig, MapReduceConfig, DebateConfig, HierarchicalMeshConfig, AgentManifestEntry, AgentRecord, SwarmEvent, SwarmEventListener, SwarmSnapshot, SwarmSnapshotDiff, SnapshotCaptureOptions, ScalingConfig, ScalingDecision, ScalingHistoryEntry, } from "./swarm/index.js";
 export { createToolNode, toolsCondition, createReactAgent } from "./prebuilt/index.js";
 export type { ONITool, CreateReactAgentOptions, ONILanguageModel, LLMToolSchema } from "./prebuilt/index.js";
 export type { AgentNode, AgentContext, DefineAgentOptions, FunctionalAgentOptions, SwarmMessageView } from "./agents/index.js";
@@ -35,7 +39,10 @@ export { defineAgent } from "./agents/define-agent.js";
 export { agent } from "./agents/functional-agent.js";
 export { buildAgentContext } from "./agents/context.js";
 export type { Channel, ChannelSchema, Annotated, NodeFn, NodeReturn, NodeDefinition, Edge, StaticEdge, ConditionalEdge, InterruptConfig, DynamicInterrupt, RetryPolicy, CachePolicy, ONIConfig, ONICheckpoint, ONICheckpointer, CheckpointListOptions, ONISkeleton, ONIStreamEvent, ONIInterruptEvent, CustomStreamEvent, MessageStreamEvent, StreamMode, NodeName, StartNode, EndNode, } from "./types.js";
-export { ONIError, InvalidSkeletonError, RecursionLimitError, NodeNotFoundError, EdgeConflictError, NodeExecutionError, ONIInterrupt, } from "./errors.js";
+export { ONITracer } from "./telemetry.js";
+export type { SpanLike, TracerLike } from "./telemetry.js";
+export { ONIError, InvalidSkeletonError, RecursionLimitError, NodeNotFoundError, EdgeConflictError, NodeExecutionError, NodeTimeoutError, CircuitBreakerOpenError, SwarmDeadlockError, ModelAPIError, ModelRateLimitError, ModelContextLengthError, CheckpointCorruptError, StoreKeyNotFoundError, ONIInterrupt, } from "./errors.js";
+export type { ErrorCategory, ONIErrorOptions } from "./errors.js";
 export type { ToolDefinition, ToolContext, DefineToolOptions, ToolPermissions } from "./tools/index.js";
 export { defineTool, executeTool, executeToolCalls } from "./tools/index.js";
 export { RequestReplyBroker } from "./coordination/request-reply.js";
@@ -52,6 +59,10 @@ export { AuditLog } from "./guardrails/index.js";
 export type { ONIModel, ONIModelMessage, ONIModelToolCall, ChatParams, ChatResponse, ChatChunk, TokenUsage, ModelCapabilities, ModelOptions, LLMToolDef, JSONSchema, } from "./models/index.js";
 export { anthropic } from "./models/anthropic.js";
 export { openai } from "./models/openai.js";
+export { openrouter } from "./models/openrouter.js";
+export type { OpenRouterOptions } from "./models/openrouter.js";
 export { google } from "./models/google.js";
 export { ollama } from "./models/ollama.js";
+export { ONIHarness, agentLoop, wrapWithAgentLoop, TodoModule, HooksEngine, ContextCompactor, SafetyGate, SkillLoader, generateId, } from "./harness/index.js";
+export type { HarnessConfig, AgentNodeConfig, AgentLoopConfig, LoopMessage, LoopMessageType, LoopToolResult, HarnessToolContext, SwarmAgentCompat, Todo, TodoState, TodoStatus, TodoPriority, HookEvent, HookDefinition, HookResult, HooksConfig, CompactorConfig, SafetyGateConfig, SafetyCheckResult, SkillDefinition, } from "./harness/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAQ,YAAY,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGvG,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC/F,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAG5G,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAGxC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGhF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,OAAO,EACL,eAAe,EAAE,eAAe,EAAE,qBAAqB,EACvD,aAAa,EAAE,aAAa,EAC5B,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EACnD,cAAc,EAAE,YAAY,EAAE,YAAY,GAC3C,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAG9F,OAAO,EACL,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAC1D,gBAAgB,EAAE,sBAAsB,EACxC,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGrG,OAAO,EACL,aAAa,EAAE,eAAe,EAAE,gBAAgB,GACjD,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC9F,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGvE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACxG,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG7D,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/F,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAG7F,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACvE,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAGpF,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACjE,YAAY,EAAE,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG/E,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAG/E,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG3C,OAAO,EACL,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,IAAI,IAAI,EACvD,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,UAAU,EAC5D,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAClD,WAAW,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,cAAc,GACvE,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,aAAa,EAAE,WAAW,EAAE,eAAe,EAC3C,iBAAiB,EAAE,mBAAmB,EACtC,cAAc,EAAE,aAAa,EAC7B,YAAY,EAAE,SAAS,EAAE,cAAc,EACvC,gBAAgB,EAAE,eAAe,EAAE,yBAAyB,EAC5D,SAAS,EAAE,eAAe,EAC1B,aAAa,EAAE,eAAe,EAAE,mBAAmB,EACnD,kBAAkB,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,sBAAsB,EAC1H,kBAAkB,EAAE,WAAW,EAC/B,UAAU,EAAE,kBAAkB,EAC9B,aAAa,EAAE,iBAAiB,EAAE,sBAAsB,EACxD,aAAa,EAAE,eAAe,EAAE,mBAAmB,GACpD,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvF,YAAY,EAAE,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAG7G,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC/H,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,YAAY,EACV,OAAO,EAAE,aAAa,EAAE,SAAS,EACjC,MAAM,EAAE,UAAU,EAAE,cAAc,EAClC,IAAI,EAAE,UAAU,EAAE,eAAe,EACjC,eAAe,EAAE,gBAAgB,EACjC,WAAW,EAAE,WAAW,EACxB,SAAS,EACT,aAAa,EAAE,eAAe,EAC9B,qBAAqB,EACrB,WAAW,EACX,cAAc,EAAE,iBAAiB,EACjC,iBAAiB,EAAE,kBAAkB,EACrC,UAAU,EACV,QAAQ,EAAE,SAAS,EAAE,OAAO,GAC7B,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG3D,OAAO,EACL,QAAQ,EAAE,oBAAoB,EAAE,mBAAmB,EACnD,iBAAiB,EAAE,iBAAiB,EAAE,kBAAkB,EACxD,gBAAgB,EAAE,uBAAuB,EAAE,kBAAkB,EAC7D,aAAa,EAAE,mBAAmB,EAAE,uBAAuB,EAC3D,sBAAsB,EAAE,qBAAqB,EAC7C,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGlE,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxG,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAG7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,YAAY,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAChE,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAG7D,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACjG,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG7C,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAC5H,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACpG,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACzF,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjD,YAAY,EACV,QAAQ,EACR,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,UAAU,GACX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAG5C,OAAO,EACL,UAAU,EAAE,SAAS,EAAE,iBAAiB,EACxC,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAClE,UAAU,GACX,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,aAAa,EAAE,eAAe,EAAE,eAAe,EAC/C,WAAW,EAAE,eAAe,EAAE,cAAc,EAC5C,kBAAkB,EAAE,gBAAgB,EACpC,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EACzC,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAClD,eAAe,EAAE,gBAAgB,EAAE,iBAAiB,EACpD,eAAe,GAChB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,5 +1,5 @@
 // ============================================================
-// @oni.bot/core v0.4.0 — Public API
+// @oni.bot/core v0.8.1 — Public API
 // ============================================================
 // -- Graph builder & skeletons
 export { StateGraph, MessageGraph } from "./graph.js";
@@ -12,36 +12,42 @@ export { START, END } from "./types.js";
 export { lastValue, appendList, mergeObject, ephemeralValue } from "./types.js";
 // -- Send + Command
 export { Send, Command } from "./types.js";
-// -- Messages (addMessages reducer)  ← NEW
+// -- Messages (addMessages reducer)
 export { messagesChannel, messagesReducer, messagesStateChannels, RemoveMessage, UpdateMessage, humanMessage, aiMessage, systemMessage, toolMessage, getMessageById, filterByRole, trimMessages, } from "./messages/index.js";
-// -- HITL: interrupt() + getUserInput  ← NEW
+// -- HITL: interrupt() + getUserInput
 export { interrupt, getUserInput, getUserApproval, getUserSelection, HITLSessionStore, HITLInterruptException, NodeInterruptSignal, } from "./hitl/index.js";
-// -- Cross-thread Store  ← NEW
+// -- Cross-thread Store
 export { InMemoryStore, NamespacedStore, AgentMemoryStore, } from "./store/index.js";
 export { BaseStore } from "./store/index.js";
-// -- Injected tools  ← NEW
+// -- Injected tools
 export { createInjectedTool } from "./injected.js";
-// -- Runtime Context  ← NEW
+// -- Runtime Context
 export { getConfig, getStore, getStreamWriter, getCurrentState, getRemainingSteps } from "./context.js";
-// -- Token streaming  ← NEW
-export { emitToken, TokenStreamWriter, StreamWriterImpl } from "./streaming.js";
-// -- Stream events protocol  ← NEW
+// -- Token streaming
+export { emitToken, TokenStreamWriter, StreamWriterImpl, BoundedBuffer } from "./streaming.js";
+// -- Stream events protocol
 export { streamEvents } from "./stream-events.js";
-// -- Graph inspection  ← NEW
+// -- Graph inspection
 export { buildGraphDescriptor, toMermaidDetailed } from "./inspect.js";
-// -- Functional API  ← NEW
+// -- Functional API
 export { entrypoint, pipe, branch, task } from "./functional.js";
 // -- Retry
 export { withRetry } from "./retry.js";
+// -- Circuit Breaker
+export { CircuitBreaker } from "./circuit-breaker.js";
+// -- Dead Letter Queue
+export { DeadLetterQueue } from "./dlq.js";
 // -- Swarm primitives
-export { SwarmGraph, AgentRegistry, AgentPool, AgentPool as Pool, Handoff, createSupervisorNode, baseSwarmChannels, createMessage, getInbox, consumeInbox, formatInbox, } from "./swarm/index.js";
+export { SwarmGraph, AgentRegistry, AgentPool, AgentPool as Pool, Handoff, createSupervisorNode, baseSwarmChannels, quickAgent, createMessage, getInbox, consumeInbox, formatInbox, SwarmTracer, SwarmSnapshotStore, DynamicScalingMonitor, toSwarmMermaid, } from "./swarm/index.js";
 // -- Prebuilt nodes
 export { createToolNode, toolsCondition, createReactAgent } from "./prebuilt/index.js";
 export { defineAgent } from "./agents/define-agent.js";
 export { agent } from "./agents/functional-agent.js";
 export { buildAgentContext } from "./agents/context.js";
+// -- Telemetry (zero-dep OTel adapter)
+export { ONITracer } from "./telemetry.js";
 // -- Errors
-export { ONIError, InvalidSkeletonError, RecursionLimitError, NodeNotFoundError, EdgeConflictError, NodeExecutionError, ONIInterrupt, } from "./errors.js";
+export { ONIError, InvalidSkeletonError, RecursionLimitError, NodeNotFoundError, EdgeConflictError, NodeExecutionError, NodeTimeoutError, CircuitBreakerOpenError, SwarmDeadlockError, ModelAPIError, ModelRateLimitError, ModelContextLengthError, CheckpointCorruptError, StoreKeyNotFoundError, ONIInterrupt, } from "./errors.js";
 export { defineTool, executeTool, executeToolCalls } from "./tools/index.js";
 // Coordination
 export { RequestReplyBroker } from "./coordination/request-reply.js";
@@ -53,6 +59,9 @@ export { piiFilter, topicFilter, customFilter, runFilters } from "./guardrails/i
 export { AuditLog } from "./guardrails/index.js";
 export { anthropic } from "./models/anthropic.js";
 export { openai } from "./models/openai.js";
+export { openrouter } from "./models/openrouter.js";
 export { google } from "./models/google.js";
 export { ollama } from "./models/ollama.js";
+// Harness (agentic loop layer)
+export { ONIHarness, agentLoop, wrapWithAgentLoop, TodoModule, HooksEngine, ContextCompactor, SafetyGate, SkillLoader, generateId, } from "./harness/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,oCAAoC;AACpC,+DAA+D;AAE/D,+BAA+B;AAC/B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAQ,YAAY,CAAC;AAGxD,mBAAmB;AACnB,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC/F,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAE5G,qBAAqB;AACrB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAExC,0BAA0B;AAC1B,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEhF,oBAAoB;AACpB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAG3C,2CAA2C;AAC3C,OAAO,EACL,eAAe,EAAE,eAAe,EAAE,qBAAqB,EACvD,aAAa,EAAE,aAAa,EAC5B,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EACnD,cAAc,EAAE,YAAY,EAAE,YAAY,GAC3C,MAAM,qBAAqB,CAAC;AAG7B,6CAA6C;AAC7C,OAAO,EACL,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAC1D,gBAAgB,EAAE,sBAAsB,EACxC,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAGzB,+BAA+B;AAC/B,OAAO,EACL,aAAa,EAAE,eAAe,EAAE,gBAAgB,GACjD,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,2BAA2B;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGnD,4BAA4B;AAC5B,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGxG,4BAA4B;AAC5B,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGhF,mCAAmC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,6BAA6B;AAC7B,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGvE,2BAA2B;AAC3B,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAGjE,WAAW;AACX,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,sBAAsB;AACtB,OAAO,EACL,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,IAAI,IAAI,EACvD,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAChD,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,GACnD,MAAM,kBAAkB,CAAC;AAU1B,oBAAoB;AACpB,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAKvF,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAmBxD,YAAY;AACZ,OAAO,EACL,QAAQ,EAAE,oBAAoB,EAAE,mBAAmB,EACnD,iBAAiB,EAAE,iBAAiB,EAAE,kBAAkB,EACxD,YAAY,GACb,MAAM,aAAa,CAAC;AAIrB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAE7E,eAAe;AACf,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAErE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAKhE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAI7C,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACpG,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACzF,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAgBjD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/internal/timeout.d.ts

@@ -0,0 +1,2 @@
+export declare function runWithTimeout<T>(operation: () => Promise<T>, timeoutMs: number | undefined, createTimeoutError: () => Error): Promise<T>;
+//# sourceMappingURL=timeout.d.ts.map

package/dist/internal/timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.d.ts","sourceRoot":"","sources":["../../src/internal/timeout.ts"],"names":[],"mappings":"AAAA,wBAAsB,cAAc,CAAC,CAAC,EACpC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,kBAAkB,EAAE,MAAM,KAAK,GAC9B,OAAO,CAAC,CAAC,CAAC,CAgBZ"}

package/dist/internal/timeout.js

@@ -0,0 +1,16 @@
+export async function runWithTimeout(operation, timeoutMs, createTimeoutError) {
+    if (timeoutMs == null || timeoutMs <= 0) {
+        return operation();
+    }
+    return await new Promise((resolve, reject) => {
+        const timer = setTimeout(() => reject(createTimeoutError()), timeoutMs);
+        if (typeof timer === "object" && timer !== null && "unref" in timer && typeof timer.unref === "function") {
+            timer.unref();
+        }
+        Promise.resolve()
+            .then(operation)
+            .then(resolve, reject)
+            .finally(() => clearTimeout(timer));
+    });
+}
+//# sourceMappingURL=timeout.js.map

package/dist/internal/timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.js","sourceRoot":"","sources":["../../src/internal/timeout.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,SAA2B,EAC3B,SAA6B,EAC7B,kBAA+B;IAE/B,IAAI,SAAS,IAAI,IAAI,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QACxC,OAAO,SAAS,EAAE,CAAC;IACrB,CAAC;IAED,OAAO,MAAM,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC9C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;QACxE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YACzG,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC;QAED,OAAO,CAAC,OAAO,EAAE;aACd,IAAI,CAAC,SAAS,CAAC;aACf,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC;aACrB,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/lsp/client.d.ts

@@ -0,0 +1,70 @@
+/**
+ * LSP Client — Language Server Protocol client over stdio.
+ *
+ * Manages a single language server connection:
+ * - Spawn process with Content-Length framed JSON-RPC
+ * - Initialize handshake (capabilities, rootUri)
+ * - Track open files with version numbers
+ * - Receive and cache diagnostics per file
+ * - touchFile() → open/change → await diagnostics
+ *
+ * Swarm-aware: A single LSPClient instance is shared across all agents.
+ * Concurrent touchFile() calls are safe — file versions are tracked atomically.
+ *
+ * Zero-dependency: uses only node:child_process and node:path.
+ */
+import type { LSPServerConfig, LSPClientState, LSPClientInfo, LSPDiagnostic } from "./types.js";
+export declare class LSPClient {
+    private readonly config;
+    private readonly rootDir;
+    private process;
+    private state;
+    private serverInfo?;
+    private nextId;
+    private pending;
+    private buffer;
+    private fileVersions;
+    private diagnosticsCache;
+    private diagnosticsWaiters;
+    constructor(config: LSPServerConfig, rootDir: string);
+    /**
+     * Start the language server and complete the initialize handshake.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the language server.
+     */
+    stop(): void;
+    /**
+     * Notify the server about a file change and optionally wait for diagnostics.
+     *
+     * If the file hasn't been opened yet, sends didOpen. Otherwise sends didChange.
+     * Reads the file content from disk.
+     */
+    touchFile(filePath: string, waitForDiagnostics?: boolean): Promise<void>;
+    /**
+     * Get cached diagnostics for a file.
+     */
+    getDiagnostics(filePath: string): LSPDiagnostic[];
+    /**
+     * Get all cached diagnostics keyed by file path.
+     */
+    getAllDiagnostics(): Map<string, LSPDiagnostic[]>;
+    getState(): LSPClientState;
+    getInfo(): LSPClientInfo;
+    getServerId(): string;
+    private waitForDiagnostics;
+    private notifyDiagnosticsWaiters;
+    private removeWaiter;
+    private clearAllWaiters;
+    private sendRequest;
+    private sendNotification;
+    private writeMessage;
+    private processBuffer;
+    private handleMessage;
+    private handleNotification;
+    private uriToPath;
+    private handleProcessExit;
+    private rejectAllPending;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/lsp/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/lsp/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACb,aAAa,EAMd,MAAM,YAAY,CAAC;AA2BpB,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,UAAU,CAAC,CAAqC;IAGxD,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,MAAM,CAAM;IAGpB,OAAO,CAAC,YAAY,CAA6B;IAGjD,OAAO,CAAC,gBAAgB,CAAsC;IAC9D,OAAO,CAAC,kBAAkB,CAA0C;gBAExD,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM;IAOpD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA4E5B;;OAEG;IACH,IAAI,IAAI,IAAI;IAoBZ;;;;;OAKG;IACG,SAAS,CACb,QAAQ,EAAE,MAAM,EAChB,kBAAkB,UAAQ,GACzB,OAAO,CAAC,IAAI,CAAC;IA6ChB;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE;IAIjD;;OAEG;IACH,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC;IAMjD,QAAQ,IAAI,cAAc;IAI1B,OAAO,IAAI,aAAa;IASxB,WAAW,IAAI,MAAM;IAMrB,OAAO,CAAC,kBAAkB;IAuB1B,OAAO,CAAC,wBAAwB;IAahC,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,WAAW;IA6BnB,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,aAAa;IAiCrB,OAAO,CAAC,aAAa;IA6CrB,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,SAAS;IAmBjB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,gBAAgB;CAOzB"}