@oni.bot/core 0.6.1

package/dist/guardrails/budget.js

@@ -0,0 +1,154 @@
+export class BudgetExceededError extends Error {
+    kind;
+    current;
+    limit;
+    constructor(kind, current, limit) {
+        super(kind === "cost"
+            ? `Budget exceeded: cost $${current.toFixed(4)} exceeds limit $${limit.toFixed(4)}`
+            : `Budget exceeded: ${current} tokens exceeds limit of ${limit} tokens (${kind})`);
+        this.kind = kind;
+        this.current = current;
+        this.limit = limit;
+        this.name = "BudgetExceededError";
+    }
+}
+/** Default pricing per million tokens for common models */
+export const DEFAULT_PRICING = {
+    "claude-opus-4-6": { input: 15.0, output: 75.0 },
+    "claude-sonnet-4-6": { input: 3.0, output: 15.0 },
+    "gpt-4o": { input: 2.5, output: 10.0 },
+    "gpt-4o-mini": { input: 0.15, output: 0.6 },
+    "gemini-2.0-flash": { input: 0.1, output: 0.4 },
+};
+export class BudgetTracker {
+    agentTokens = new Map();
+    totalInput = 0;
+    totalOutput = 0;
+    totalCost = 0;
+    pricing;
+    config;
+    constructor(config, customPricing) {
+        this.config = config;
+        this.pricing = { ...DEFAULT_PRICING, ...customPricing };
+    }
+    record(agentName, modelId, usage) {
+        const entries = [];
+        // Update agent-level counters
+        const existing = this.agentTokens.get(agentName) ?? { input: 0, output: 0 };
+        existing.input += usage.inputTokens;
+        existing.output += usage.outputTokens;
+        this.agentTokens.set(agentName, existing);
+        // Update run-level counters
+        this.totalInput += usage.inputTokens;
+        this.totalOutput += usage.outputTokens;
+        // Calculate cost for this usage
+        const pricing = this.pricing[modelId];
+        if (pricing) {
+            const cost = (usage.inputTokens / 1_000_000) * pricing.input +
+                (usage.outputTokens / 1_000_000) * pricing.output;
+            this.totalCost += cost;
+        }
+        const now = Date.now();
+        const agentTotal = existing.input + existing.output;
+        const runTotal = this.totalInput + this.totalOutput;
+        const mode = this.config.onBudgetExceeded ?? "error";
+        // Check per-agent limit
+        if (this.config.maxTokensPerAgent !== undefined) {
+            const limit = this.config.maxTokensPerAgent;
+            if (agentTotal > limit) {
+                if (mode === "error") {
+                    throw new BudgetExceededError("agent", agentTotal, limit);
+                }
+                entries.push({
+                    timestamp: now,
+                    agent: agentName,
+                    action: "budget.exceeded",
+                    data: { kind: "agent", current: agentTotal, limit },
+                });
+            }
+            else if (agentTotal >= limit * 0.8) {
+                entries.push({
+                    timestamp: now,
+                    agent: agentName,
+                    action: "budget.warning",
+                    data: { kind: "agent", current: agentTotal, limit, percent: Math.round((agentTotal / limit) * 100) },
+                });
+            }
+        }
+        // Check per-run token limit
+        if (this.config.maxTokensPerRun !== undefined) {
+            const limit = this.config.maxTokensPerRun;
+            if (runTotal > limit) {
+                if (mode === "error") {
+                    throw new BudgetExceededError("run", runTotal, limit);
+                }
+                entries.push({
+                    timestamp: now,
+                    agent: agentName,
+                    action: "budget.exceeded",
+                    data: { kind: "run", current: runTotal, limit },
+                });
+            }
+            else if (runTotal >= limit * 0.8) {
+                entries.push({
+                    timestamp: now,
+                    agent: agentName,
+                    action: "budget.warning",
+                    data: { kind: "run", current: runTotal, limit, percent: Math.round((runTotal / limit) * 100) },
+                });
+            }
+        }
+        // Check cost limit
+        if (this.config.maxCostPerRun !== undefined) {
+            const limit = this.config.maxCostPerRun;
+            if (this.totalCost > limit) {
+                if (mode === "error") {
+                    throw new BudgetExceededError("cost", this.totalCost, limit);
+                }
+                entries.push({
+                    timestamp: now,
+                    agent: agentName,
+                    action: "budget.exceeded",
+                    data: { kind: "cost", current: this.totalCost, limit },
+                });
+            }
+            else if (this.totalCost >= limit * 0.8) {
+                entries.push({
+                    timestamp: now,
+                    agent: agentName,
+                    action: "budget.warning",
+                    data: { kind: "cost", current: this.totalCost, limit, percent: Math.round((this.totalCost / limit) * 100) },
+                });
+            }
+        }
+        return entries;
+    }
+    getAgentTokens(name) {
+        const entry = this.agentTokens.get(name);
+        return entry ? entry.input + entry.output : 0;
+    }
+    getTotalTokens() {
+        return this.totalInput + this.totalOutput;
+    }
+    getTotalCost() {
+        return this.totalCost;
+    }
+    isOverBudget() {
+        const runTotal = this.totalInput + this.totalOutput;
+        if (this.config.maxTokensPerRun !== undefined && runTotal > this.config.maxTokensPerRun) {
+            return true;
+        }
+        if (this.config.maxCostPerRun !== undefined && this.totalCost > this.config.maxCostPerRun) {
+            return true;
+        }
+        if (this.config.maxTokensPerAgent !== undefined) {
+            for (const [, entry] of this.agentTokens) {
+                if (entry.input + entry.output > this.config.maxTokensPerAgent) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=budget.js.map

package/dist/guardrails/budget.js.map

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

package/dist/guardrails/filters.d.ts

@@ -0,0 +1,24 @@
+import type { ContentFilter, ContentFilterResult } from "./types.js";
+export interface PiiFilterOptions {
+    block: Array<"email" | "ssn" | "phone" | "creditCard">;
+    redact?: boolean;
+}
+export declare function piiFilter(options: PiiFilterOptions): ContentFilter;
+export interface TopicFilterOptions {
+    blocked?: string[];
+}
+export declare function topicFilter(options: TopicFilterOptions): ContentFilter;
+export interface CustomFilterOptions {
+    name: string;
+    check: (content: string) => ContentFilterResult;
+    apply: "input" | "output" | "both";
+}
+export declare function customFilter(options: CustomFilterOptions): ContentFilter;
+export interface FilterPipelineResult {
+    passed: boolean;
+    content: string;
+    blockedBy?: string;
+    reason?: string;
+}
+export declare function runFilters(filters: ContentFilter[], content: string, direction: "input" | "output"): FilterPipelineResult;
+//# sourceMappingURL=filters.d.ts.map

package/dist/guardrails/filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../../src/guardrails/filters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAkBrE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,KAAK,CAAC,OAAO,GAAG,KAAK,GAAG,OAAO,GAAG,YAAY,CAAC,CAAC;IACvD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,aAAa,CA2BlE;AAID,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,aAAa,CAgBtE;AAID,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,mBAAmB,CAAC;IAChD,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;CACpC;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,aAAa,CAMxE;AAID,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,UAAU,CACxB,OAAO,EAAE,aAAa,EAAE,EACxB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,OAAO,GAAG,QAAQ,GAC5B,oBAAoB,CA2BtB"}

package/dist/guardrails/filters.js

@@ -0,0 +1,87 @@
+// ── PII patterns ──────────────────────────────────────────────────
+const PII_PATTERNS = {
+    email: /[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}/g,
+    ssn: /\b\d{3}-\d{2}-\d{4}\b/g,
+    phone: /\b(?:\+?1[-.\s]?)?\(?\d{3}\)?[-.\s]?\d{3}[-.\s]?\d{4}\b/g,
+    creditCard: /\b(?:\d{4}[-\s]?){3}\d{4}\b/g,
+};
+const REDACT_LABELS = {
+    email: "[EMAIL REDACTED]",
+    ssn: "[SSN REDACTED]",
+    phone: "[PHONE REDACTED]",
+    creditCard: "[CREDIT CARD REDACTED]",
+};
+export function piiFilter(options) {
+    const { block, redact = false } = options;
+    return {
+        name: "pii",
+        apply: "both",
+        check(content) {
+            for (const kind of block) {
+                const pattern = PII_PATTERNS[kind];
+                if (!pattern)
+                    continue;
+                // Reset lastIndex for global regex
+                pattern.lastIndex = 0;
+                if (pattern.test(content)) {
+                    if (redact) {
+                        // Reset again for replace
+                        pattern.lastIndex = 0;
+                        const redacted = content.replace(pattern, REDACT_LABELS[kind]);
+                        return { blocked: true, reason: `PII detected: ${kind}`, redacted };
+                    }
+                    return { blocked: true, reason: `PII detected: ${kind}` };
+                }
+            }
+            return { blocked: false };
+        },
+    };
+}
+export function topicFilter(options) {
+    const blockedTopics = (options.blocked ?? []).map(t => t.toLowerCase());
+    return {
+        name: "topic",
+        apply: "both",
+        check(content) {
+            const lower = content.toLowerCase();
+            for (const topic of blockedTopics) {
+                if (lower.includes(topic)) {
+                    return { blocked: true, reason: `Blocked topic: ${topic}` };
+                }
+            }
+            return { blocked: false };
+        },
+    };
+}
+export function customFilter(options) {
+    return {
+        name: options.name,
+        apply: options.apply,
+        check: options.check,
+    };
+}
+export function runFilters(filters, content, direction) {
+    let currentContent = content;
+    for (const filter of filters) {
+        // Skip filters that don't apply to this direction
+        if (filter.apply !== "both" && filter.apply !== direction) {
+            continue;
+        }
+        const result = filter.check(currentContent);
+        if (result.blocked) {
+            if (result.redacted !== undefined) {
+                // Redaction mode — update content and continue
+                currentContent = result.redacted;
+                continue;
+            }
+            return {
+                passed: false,
+                content: currentContent,
+                blockedBy: filter.name,
+                reason: result.reason,
+            };
+        }
+    }
+    return { passed: true, content: currentContent };
+}
+//# sourceMappingURL=filters.js.map

package/dist/guardrails/filters.js.map

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

package/dist/guardrails/index.d.ts

@@ -0,0 +1,8 @@
+export type { GuardrailsConfig, BudgetConfig, ContentFilter, ContentFilterResult, AuditEntry } from "./types.js";
+export { ToolPermissionError, checkToolPermission, getPermittedTools } from "./permissions.js";
+export { BudgetTracker, BudgetExceededError, DEFAULT_PRICING } from "./budget.js";
+export type { ModelPricing } from "./budget.js";
+export { piiFilter, topicFilter, customFilter, runFilters } from "./filters.js";
+export type { PiiFilterOptions, TopicFilterOptions, CustomFilterOptions, FilterPipelineResult } from "./filters.js";
+export { AuditLog } from "./audit.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/guardrails/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/guardrails/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGjH,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG/F,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAClF,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAChF,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGpH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/guardrails/index.js

@@ -0,0 +1,9 @@
+// Permissions
+export { ToolPermissionError, checkToolPermission, getPermittedTools } from "./permissions.js";
+// Budget
+export { BudgetTracker, BudgetExceededError, DEFAULT_PRICING } from "./budget.js";
+// Filters
+export { piiFilter, topicFilter, customFilter, runFilters } from "./filters.js";
+// Audit
+export { AuditLog } from "./audit.js";
+//# sourceMappingURL=index.js.map

package/dist/guardrails/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/guardrails/index.ts"],"names":[],"mappings":"AAGA,cAAc;AACd,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE/F,SAAS;AACT,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGlF,UAAU;AACV,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAGhF,QAAQ;AACR,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/guardrails/permissions.d.ts

@@ -0,0 +1,9 @@
+import type { ToolPermissions } from "../tools/types.js";
+export declare class ToolPermissionError extends Error {
+    readonly agent: string;
+    readonly tool: string;
+    constructor(agent: string, tool: string);
+}
+export declare function checkToolPermission(permissions: ToolPermissions, agentName: string, toolName: string): void;
+export declare function getPermittedTools(permissions: ToolPermissions, agentName: string, allTools: string[]): string[];
+//# sourceMappingURL=permissions.d.ts.map

package/dist/guardrails/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../src/guardrails/permissions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,qBAAa,mBAAoB,SAAQ,KAAK;aAChB,KAAK,EAAE,MAAM;aAAkB,IAAI,EAAE,MAAM;gBAA3C,KAAK,EAAE,MAAM,EAAkB,IAAI,EAAE,MAAM;CAIxE;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAM3G;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAK/G"}

package/dist/guardrails/permissions.js

@@ -0,0 +1,29 @@
+export class ToolPermissionError extends Error {
+    agent;
+    tool;
+    constructor(agent, tool) {
+        super(`Agent "${agent}" is not permitted to use tool "${tool}"`);
+        this.agent = agent;
+        this.tool = tool;
+        this.name = "ToolPermissionError";
+    }
+}
+export function checkToolPermission(permissions, agentName, toolName) {
+    const allowed = permissions[agentName];
+    if (allowed === undefined)
+        return;
+    if (allowed === "*")
+        return;
+    if (Array.isArray(allowed) && allowed.includes(toolName))
+        return;
+    throw new ToolPermissionError(agentName, toolName);
+}
+export function getPermittedTools(permissions, agentName, allTools) {
+    const allowed = permissions[agentName];
+    if (allowed === undefined)
+        return allTools;
+    if (allowed === "*")
+        return allTools;
+    return allowed.filter(t => allTools.includes(t));
+}
+//# sourceMappingURL=permissions.js.map

package/dist/guardrails/permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../src/guardrails/permissions.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAChB;IAA+B;IAA3D,YAA4B,KAAa,EAAkB,IAAY;QACrE,KAAK,CAAC,UAAU,KAAK,mCAAmC,IAAI,GAAG,CAAC,CAAC;QADvC,UAAK,GAAL,KAAK,CAAQ;QAAkB,SAAI,GAAJ,IAAI,CAAQ;QAErE,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB,CAAC,WAA4B,EAAE,SAAiB,EAAE,QAAgB;IACnG,MAAM,OAAO,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IACvC,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO;IAClC,IAAI,OAAO,KAAK,GAAG;QAAE,OAAO;IAC5B,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO;IACjE,MAAM,IAAI,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,WAA4B,EAAE,SAAiB,EAAE,QAAkB;IACnG,MAAM,OAAO,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IACvC,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC3C,IAAI,OAAO,KAAK,GAAG;QAAE,OAAO,QAAQ,CAAC;IACrC,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/guardrails/types.d.ts

@@ -0,0 +1,30 @@
+import type { ToolPermissions } from "../tools/types.js";
+export interface BudgetConfig {
+    maxTokensPerAgent?: number;
+    maxTokensPerRun?: number;
+    maxCostPerRun?: number;
+    onBudgetExceeded?: "interrupt" | "error" | "warn";
+}
+export interface ContentFilterResult {
+    blocked: boolean;
+    reason?: string;
+    redacted?: string;
+}
+export interface ContentFilter {
+    name: string;
+    apply: "input" | "output" | "both";
+    check: (content: string) => ContentFilterResult;
+}
+export interface GuardrailsConfig {
+    toolPermissions?: ToolPermissions;
+    budget?: BudgetConfig;
+    filters?: ContentFilter[];
+    audit?: boolean;
+}
+export interface AuditEntry {
+    timestamp: number;
+    agent: string;
+    action: "llm.request" | "llm.response" | "tool.call" | "tool.result" | "filter.blocked" | "budget.warning" | "budget.exceeded";
+    data: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/guardrails/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/guardrails/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,WAAW,YAAY;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;CACnD;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IACnC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,mBAAmB,CAAC;CACjD;AAED,MAAM,WAAW,gBAAgB;IAC/B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,aAAa,GAAG,cAAc,GAAG,WAAW,GAAG,aAAa,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,iBAAiB,CAAC;IAC/H,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B"}

package/dist/guardrails/types.js

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

package/dist/guardrails/types.js.map

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

package/dist/hitl/index.d.ts

@@ -0,0 +1,5 @@
+export { interrupt, getUserInput, getUserApproval, getUserSelection, NodeInterruptSignal, _installInterruptContext, _clearInterruptContext, _getInterruptContext, } from "./interrupt.js";
+export type { InterruptValue, ResumeValue, GetUserInputOptions, } from "./interrupt.js";
+export { HITLSessionStore, HITLInterruptException, } from "./resume.js";
+export type { HITLSession } from "./resume.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hitl/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,cAAc,EACd,WAAW,EACX,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/hitl/index.js

@@ -0,0 +1,3 @@
+export { interrupt, getUserInput, getUserApproval, getUserSelection, NodeInterruptSignal, _installInterruptContext, _clearInterruptContext, _getInterruptContext, } from "./interrupt.js";
+export { HITLSessionStore, HITLInterruptException, } from "./resume.js";
+//# sourceMappingURL=index.js.map

package/dist/hitl/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hitl/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAQxB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,aAAa,CAAC"}

package/dist/hitl/interrupt.d.ts

@@ -0,0 +1,81 @@
+export interface InterruptValue {
+    /** Value the node is surfacing to the human */
+    value: unknown;
+    /** Which node triggered the interrupt */
+    node: string;
+    /** Unique resume key for this interrupt point */
+    resumeId: string;
+    timestamp: number;
+}
+export interface ResumeValue {
+    resumeId: string;
+    value: unknown;
+}
+export declare class NodeInterruptSignal {
+    readonly value: unknown;
+    readonly resumeId: string;
+    readonly isNodeInterrupt = true;
+    constructor(value: unknown, resumeId: string);
+}
+interface InterruptContext {
+    nodeName: string;
+    resumeValue: unknown | undefined;
+    hasResume: boolean;
+}
+export declare function _installInterruptContext(ctx: InterruptContext): void;
+export declare function _clearInterruptContext(): void;
+export declare function _getInterruptContext(): InterruptContext | null;
+/**
+ * Pause execution and surface `value` to the human.
+ * Returns the human's response when execution resumes.
+ *
+ * @example
+ * addNode("review", async (state) => {
+ *   const decision = await interrupt({
+ *     message: "Approve this action?",
+ *     data:    state.pendingAction,
+ *   });
+ *   if (decision === "approve") {
+ *     return { approved: true };
+ *   }
+ *   return { approved: false, reason: decision };
+ * });
+ */
+export declare function interrupt<T = unknown>(value: unknown): Promise<T>;
+export interface GetUserInputOptions {
+    /** Prompt shown to the user */
+    prompt: string;
+    /** Optional field name for structured input */
+    field?: string;
+    /** Validation — if it returns false, the input is rejected */
+    validate?: (input: unknown) => boolean | string;
+    /** Expected input type hint */
+    inputType?: "text" | "boolean" | "number" | "select" | "json";
+    /** For "select" inputType — valid choices */
+    choices?: string[];
+}
+/**
+ * Pause execution and collect structured input from the human.
+ * A semantic alias for interrupt() with richer metadata.
+ *
+ * @example
+ * addNode("get_approval", async (state) => {
+ *   const approved = await getUserInput({
+ *     prompt:    `Approve deployment of ${state.version}?`,
+ *     inputType: "boolean",
+ *   });
+ *   return { approved: approved as boolean };
+ * });
+ */
+export declare function getUserInput<T = unknown>(opts: GetUserInputOptions): Promise<T>;
+/**
+ * Ask the human for a yes/no decision.
+ *
+ * @example
+ * const ok = await getUserApproval("Deploy to production?");
+ * if (!ok) return { aborted: true };
+ */
+export declare function getUserApproval(prompt: string): Promise<boolean>;
+export declare function getUserSelection(prompt: string, choices: string[]): Promise<string>;
+export {};
+//# sourceMappingURL=interrupt.d.ts.map

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

@@ -0,0 +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"}

package/dist/hitl/interrupt.js

@@ -0,0 +1,116 @@
+// ============================================================
+// @oni.bot/core/hitl — interrupt() function API
+// ============================================================
+// Allows calling interrupt(value) from INSIDE a node body to
+// pause execution mid-node, surface a value to the caller,
+// and resume with a response when the user provides one.
+//
+// This is fundamentally different from interruptBefore/After:
+//   - interruptBefore/After: pauses at node BOUNDARIES (compile-time)
+//   - interrupt(): pauses at ARBITRARY POINTS inside node logic (runtime)
+//
+// Implementation uses a context-local execution slot that the
+// Pregel runner installs before calling each node, allowing the
+// node to throw a structured interrupt that the runner catches,
+// checkpoints, and re-raises to the caller.
+// ============================================================
+// ----------------------------------------------------------------
+// Internal signal — thrown inside a node, caught by Pregel runner
+// ----------------------------------------------------------------
+export class NodeInterruptSignal {
+    value;
+    resumeId;
+    isNodeInterrupt = true;
+    constructor(value, resumeId) {
+        this.value = value;
+        this.resumeId = resumeId;
+    }
+}
+// Per-async-context slot (global for now; can be AsyncLocalStorage in Node)
+let _currentCtx = null;
+export function _installInterruptContext(ctx) {
+    _currentCtx = ctx;
+}
+export function _clearInterruptContext() {
+    _currentCtx = null;
+}
+export function _getInterruptContext() {
+    return _currentCtx;
+}
+// ----------------------------------------------------------------
+// interrupt(value) — call this inside any node
+// ----------------------------------------------------------------
+/**
+ * Pause execution and surface `value` to the human.
+ * Returns the human's response when execution resumes.
+ *
+ * @example
+ * addNode("review", async (state) => {
+ *   const decision = await interrupt({
+ *     message: "Approve this action?",
+ *     data:    state.pendingAction,
+ *   });
+ *   if (decision === "approve") {
+ *     return { approved: true };
+ *   }
+ *   return { approved: false, reason: decision };
+ * });
+ */
+export async function interrupt(value) {
+    const ctx = _currentCtx;
+    if (!ctx) {
+        throw new Error("interrupt() called outside of an ONI node execution context. " +
+            "Make sure you're calling interrupt() inside an addNode() function.");
+    }
+    // If we already have a resume value for this execution, return it
+    if (ctx.hasResume) {
+        return ctx.resumeValue;
+    }
+    // No resume yet — throw the interrupt signal to pause execution
+    const resumeId = `${ctx.nodeName}-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+    throw new NodeInterruptSignal(value, resumeId);
+}
+/**
+ * Pause execution and collect structured input from the human.
+ * A semantic alias for interrupt() with richer metadata.
+ *
+ * @example
+ * addNode("get_approval", async (state) => {
+ *   const approved = await getUserInput({
+ *     prompt:    `Approve deployment of ${state.version}?`,
+ *     inputType: "boolean",
+ *   });
+ *   return { approved: approved as boolean };
+ * });
+ */
+export async function getUserInput(opts) {
+    return interrupt({
+        __type: "user_input_request",
+        prompt: opts.prompt,
+        field: opts.field,
+        inputType: opts.inputType ?? "text",
+        choices: opts.choices,
+        // Validator serialized as string for display purposes
+        hasValidator: !!opts.validate,
+    });
+}
+// ----------------------------------------------------------------
+// getUserApproval — boolean HITL shorthand
+// ----------------------------------------------------------------
+/**
+ * Ask the human for a yes/no decision.
+ *
+ * @example
+ * const ok = await getUserApproval("Deploy to production?");
+ * if (!ok) return { aborted: true };
+ */
+export async function getUserApproval(prompt) {
+    return getUserInput({ prompt, inputType: "boolean" });
+}
+// ----------------------------------------------------------------
+// getUserSelection — pick from a list
+// ----------------------------------------------------------------
+export async function getUserSelection(prompt, choices) {
+    return getUserInput({ prompt, inputType: "select", choices });
+}
+//# sourceMappingURL=interrupt.js.map

package/dist/hitl/interrupt.js.map

@@ -0,0 +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"}