@oni.bot/core 0.6.1

package/dist/agents/functional-agent.js

@@ -0,0 +1,115 @@
+// ============================================================
+// @oni.bot/core — agent() — Functional Agent Factory
+// ============================================================
+// Creates an AgentNode from a user-supplied handler function.
+//
+// Usage:
+//   agent("myAgent", async (ctx) => { ... })
+//   agent("myAgent", { model, tools }, async (ctx) => { ... })
+//
+// The handler receives an AgentContext with chat(), stream(),
+// executeTools(), coordination methods, and runtime context.
+// ============================================================
+import { buildAgentContext } from "./context.js";
+// Try to import runtime context getters — these work inside Pregel
+import { _getRunContext, } from "../context.js";
+/**
+ * agent() — create a functional agent node
+ *
+ * Overloads:
+ *   agent(name, handler)
+ *   agent(name, opts, handler)
+ */
+export function agent(name, fnOrOpts, fn) {
+    let handler;
+    let opts = {};
+    if (typeof fnOrOpts === "function") {
+        handler = fnOrOpts;
+    }
+    else {
+        opts = fnOrOpts;
+        if (!fn) {
+            throw new Error(`agent("${name}", opts, fn): handler function is required when passing options.`);
+        }
+        handler = fn;
+    }
+    const { model, tools = [], systemPrompt, maxSteps = 10, maxTokens, } = opts;
+    const _nodeFn = async (state, config) => {
+        // Accumulator for send() calls — merged into state update as swarmMessages
+        const pendingMessages = [];
+        // Try to get runtime context from AsyncLocalStorage (available inside Pregel)
+        const runCtx = _getRunContext();
+        const effectiveConfig = config ?? runCtx?.config ?? {};
+        const effectiveStore = runCtx?.store ?? null;
+        const effectiveWriter = runCtx?.writer ?? null;
+        const effectiveRemaining = runCtx
+            ? runCtx.recursionLimit - runCtx.step
+            : maxSteps;
+        const ctx = buildAgentContext({
+            model,
+            tools,
+            agentName: name,
+            systemPrompt,
+            config: effectiveConfig,
+            store: effectiveStore,
+            state,
+            streamWriter: effectiveWriter,
+            remainingSteps: effectiveRemaining,
+            onSend: (agent, payload) => {
+                pendingMessages.push({
+                    to: agent,
+                    content: payload,
+                    timestamp: Date.now(),
+                });
+            },
+            getInbox: () => {
+                // Read swarmMessages from state if available
+                const msgs = state.swarmMessages;
+                if (!Array.isArray(msgs))
+                    return [];
+                return msgs.filter((m) => m !== null && typeof m === "object");
+            },
+            onRequest: async (_agent, _payload) => {
+                // Request/response coordination will be fully wired in Task 12
+                throw new Error("request() is not yet wired — see Task 12 (enhanced coordination).");
+            },
+            onReply: (msg, payload) => {
+                if (msg._replyChannel) {
+                    msg._replyChannel(payload);
+                }
+            },
+            onPublish: (_topic, _data) => {
+                // Pub/sub coordination will be fully wired in Task 12
+            },
+        });
+        // Execute the user handler
+        const result = await handler(ctx);
+        // Merge pending swarm messages into the result
+        if (pendingMessages.length > 0) {
+            const existing = Array.isArray(result.swarmMessages)
+                ? result.swarmMessages
+                : [];
+            result.swarmMessages = [
+                ...existing,
+                ...pendingMessages.map((m) => ({
+                    id: `${name}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+                    from: name,
+                    content: m.content,
+                    timestamp: m.timestamp,
+                })),
+            ];
+        }
+        return result;
+    };
+    return {
+        name,
+        model,
+        tools,
+        systemPrompt,
+        maxSteps,
+        maxTokens,
+        _nodeFn,
+        _isAgent: true,
+    };
+}
+//# sourceMappingURL=functional-agent.js.map

package/dist/agents/functional-agent.js.map

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

package/dist/agents/index.d.ts

@@ -0,0 +1,6 @@
+export type { AgentContext, AgentNode, DefineAgentOptions, FunctionalAgentOptions, SwarmMessageView, } from "./types.js";
+export { buildAgentContext } from "./context.js";
+export type { BuildAgentContextOptions } from "./context.js";
+export { defineAgent } from "./define-agent.js";
+export { agent } from "./functional-agent.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAE7D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/agents/index.js

@@ -0,0 +1,7 @@
+// ============================================================
+// @oni.bot/core — Agents barrel exports
+// ============================================================
+export { buildAgentContext } from "./context.js";
+export { defineAgent } from "./define-agent.js";
+export { agent } from "./functional-agent.js";
+//# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,wCAAwC;AACxC,+DAA+D;AAU/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGjD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/agents/types.d.ts

@@ -0,0 +1,62 @@
+import type { ONIModel, ONIModelMessage, ChatResponse, ChatChunk, ToolResult } from "../models/types.js";
+import type { ToolDefinition } from "../tools/types.js";
+import type { ONIConfig } from "../types.js";
+import type { BaseStore } from "../store/index.js";
+import type { StreamWriter } from "../context.js";
+export interface SwarmMessageView {
+    id: string;
+    from: string;
+    content: unknown;
+    timestamp: number;
+    replyTo?: string;
+    /** Internal: channel used by reply() — not part of public API contract */
+    _replyChannel?: (payload: unknown) => void;
+}
+export interface AgentContext<S = Record<string, unknown>> {
+    chat(messages: ONIModelMessage[]): Promise<ChatResponse>;
+    stream(messages: ONIModelMessage[]): AsyncGenerator<ChatChunk>;
+    executeTools(calls: Array<{
+        id: string;
+        name: string;
+        args: Record<string, unknown>;
+    }>): Promise<ToolResult[]>;
+    send(agent: string, payload: unknown): void;
+    inbox(): SwarmMessageView[];
+    request(agent: string, payload: unknown): Promise<unknown>;
+    reply(msg: SwarmMessageView, payload: unknown): void;
+    publish(topic: string, data: unknown): void;
+    config: ONIConfig;
+    store: BaseStore | null;
+    state: S;
+    streamWriter: StreamWriter | null;
+    remainingSteps: number;
+    agentName: string;
+}
+export interface DefineAgentOptions {
+    name: string;
+    description?: string;
+    model: ONIModel;
+    tools?: ToolDefinition[];
+    systemPrompt?: string;
+    maxSteps?: number;
+    maxTokens?: number;
+}
+export interface FunctionalAgentOptions {
+    model?: ONIModel;
+    tools?: ToolDefinition[];
+    systemPrompt?: string;
+    maxSteps?: number;
+    maxTokens?: number;
+}
+export interface AgentNode<S = Record<string, unknown>> {
+    name: string;
+    description?: string;
+    model?: ONIModel;
+    tools: ToolDefinition[];
+    systemPrompt?: string;
+    maxSteps: number;
+    maxTokens?: number;
+    _nodeFn: (state: S, config?: ONIConfig) => Promise<Partial<S>>;
+    _isAgent: true;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/agents/types.js

@@ -0,0 +1,8 @@
+// ============================================================
+// @oni.bot/core — Agent Types
+// ============================================================
+// Defines the type contracts for both declarative (defineAgent)
+// and functional (agent) agent factories.
+// ============================================================
+export {};
+//# sourceMappingURL=types.js.map

package/dist/agents/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,8BAA8B;AAC9B,+DAA+D;AAC/D,gEAAgE;AAChE,0CAA0C;AAC1C,+DAA+D"}

package/dist/checkpoint.d.ts

@@ -0,0 +1,27 @@
+import type { ONICheckpoint, ONICheckpointer, CheckpointListOptions } from "./types.js";
+export declare class MemoryCheckpointer<S> implements ONICheckpointer<S> {
+    private store;
+    get(threadId: string): Promise<ONICheckpoint<S> | null>;
+    put(checkpoint: ONICheckpoint<S>): Promise<void>;
+    list(threadId: string, opts?: CheckpointListOptions): Promise<ONICheckpoint<S>[]>;
+    delete(threadId: string): Promise<void>;
+    getAt(threadId: string, step: number): Promise<ONICheckpoint<S> | null>;
+    /** Clone a thread's history up to `step` under a new threadId */
+    fork(sourceThreadId: string, step: number, newThreadId: string): Promise<boolean>;
+    clear(): void;
+}
+export declare class NoopCheckpointer<S> implements ONICheckpointer<S> {
+    get(_: string): Promise<null>;
+    put(_: ONICheckpoint<S>): Promise<void>;
+    list(_: string): Promise<ONICheckpoint<S>[]>;
+    delete(_: string): Promise<void>;
+}
+export declare abstract class PersistentCheckpointer<S> implements ONICheckpointer<S> {
+    abstract get(threadId: string): Promise<ONICheckpoint<S> | null>;
+    abstract put(checkpoint: ONICheckpoint<S>): Promise<void>;
+    abstract list(threadId: string, opts?: CheckpointListOptions): Promise<ONICheckpoint<S>[]>;
+    abstract delete(threadId: string): Promise<void>;
+    getAt(threadId: string, step: number): Promise<ONICheckpoint<S> | null>;
+    fork(source: string, step: number, dest: string): Promise<boolean>;
+}
+//# sourceMappingURL=checkpoint.d.ts.map

package/dist/checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../src/checkpoint.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAMxF,qBAAa,kBAAkB,CAAC,CAAC,CAAE,YAAW,eAAe,CAAC,CAAC,CAAC;IAC9D,OAAO,CAAC,KAAK,CAAyC;IAEhD,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAMvD,GAAG,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAShD,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IAiBjF,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvC,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAK7E,iEAAiE;IAC3D,IAAI,CACR,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC;IAWnB,KAAK,IAAI,IAAI;CACd;AAMD,qBAAa,gBAAgB,CAAC,CAAC,CAAE,YAAW,eAAe,CAAC,CAAC,CAAC;IACtD,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAC7B,GAAG,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IACvC,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5C,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CACvC;AAOD,8BAAsB,sBAAsB,CAAC,CAAC,CAAE,YAAW,eAAe,CAAC,CAAC,CAAC;IAC3E,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAyC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACtG,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,GAA6B,OAAO,CAAC,IAAI,CAAC;IACnF,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAU,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IACjG,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAsC,OAAO,CAAC,IAAI,CAAC;IAE7E,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAKvE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CASzE"}

package/dist/checkpoint.js

@@ -0,0 +1,91 @@
+// ============================================================
+// @oni.bot/core — Checkpointers v2
+// Adds: time-travel, fork, SQLite-ready interface stubs
+// ============================================================
+// ----------------------------------------------------------------
+// MemoryCheckpointer — dev/test, full history retained
+// ----------------------------------------------------------------
+export class MemoryCheckpointer {
+    store = new Map();
+    async get(threadId) {
+        const history = this.store.get(threadId);
+        if (!history?.length)
+            return null;
+        return history[history.length - 1] ?? null;
+    }
+    async put(checkpoint) {
+        const existing = this.store.get(checkpoint.threadId) ?? [];
+        // Overwrite if same step exists (idempotent)
+        const idx = existing.findIndex((c) => c.step === checkpoint.step);
+        if (idx >= 0)
+            existing[idx] = { ...checkpoint };
+        else
+            existing.push({ ...checkpoint });
+        this.store.set(checkpoint.threadId, existing);
+    }
+    async list(threadId, opts) {
+        let items = [...(this.store.get(threadId) ?? [])];
+        if (opts?.before !== undefined) {
+            items = items.filter(c => c.step < opts.before);
+        }
+        if (opts?.filter) {
+            items = items.filter(c => {
+                if (!c.metadata)
+                    return false;
+                return Object.entries(opts.filter).every(([k, v]) => c.metadata[k] === v);
+            });
+        }
+        if (opts?.limit !== undefined) {
+            items = items.slice(0, opts.limit);
+        }
+        return items;
+    }
+    async delete(threadId) {
+        this.store.delete(threadId);
+    }
+    // ---- Time-travel extensions ----
+    async getAt(threadId, step) {
+        const history = this.store.get(threadId) ?? [];
+        return history.find((c) => c.step === step) ?? null;
+    }
+    /** Clone a thread's history up to `step` under a new threadId */
+    async fork(sourceThreadId, step, newThreadId) {
+        const history = this.store.get(sourceThreadId) ?? [];
+        const upTo = history.filter((c) => c.step <= step);
+        if (!upTo.length)
+            return false;
+        this.store.set(newThreadId, upTo.map((c) => ({ ...c, threadId: newThreadId })));
+        return true;
+    }
+    clear() { this.store.clear(); }
+}
+// ----------------------------------------------------------------
+// NoopCheckpointer — stateless default
+// ----------------------------------------------------------------
+export class NoopCheckpointer {
+    async get(_) { return null; }
+    async put(_) { }
+    async list(_) { return []; }
+    async delete(_) { }
+}
+// ----------------------------------------------------------------
+// Base class for persistent checkpointers (SQLite, Redis, etc.)
+// Subclass this and implement the abstract methods.
+// ----------------------------------------------------------------
+export class PersistentCheckpointer {
+    async getAt(threadId, step) {
+        const all = await this.list(threadId);
+        return all.find((c) => c.step === step) ?? null;
+    }
+    async fork(source, step, dest) {
+        const all = await this.list(source);
+        const upTo = all.filter((c) => c.step <= step);
+        if (!upTo.length)
+            return false;
+        for (const c of upTo) {
+            await this.put({ ...c, threadId: dest });
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=checkpoint.js.map

package/dist/checkpoint.js.map

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

package/dist/checkpointers/index.d.ts

@@ -0,0 +1,4 @@
+export { SqliteCheckpointer } from "./sqlite.js";
+export { NamespacedCheckpointer } from "./namespaced.js";
+export { PostgresCheckpointer } from "./postgres.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/checkpointers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}

package/dist/checkpointers/index.js

@@ -0,0 +1,5 @@
+export { SqliteCheckpointer } from "./sqlite.js";
+export { NamespacedCheckpointer } from "./namespaced.js";
+export { PostgresCheckpointer } from "./postgres.js";
+// Redis coming next: export { RedisCheckpointer } from "./redis.js";
+//# sourceMappingURL=index.js.map

package/dist/checkpointers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/checkpointers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,qEAAqE"}

package/dist/checkpointers/namespaced.d.ts

@@ -0,0 +1,12 @@
+import type { ONICheckpoint, ONICheckpointer, CheckpointListOptions } from "../types.js";
+export declare class NamespacedCheckpointer<S> implements ONICheckpointer<S> {
+    private readonly inner;
+    private readonly ns;
+    constructor(inner: ONICheckpointer<S>, ns: string);
+    private prefix;
+    get(threadId: string): Promise<ONICheckpoint<S> | null>;
+    put(checkpoint: ONICheckpoint<S>): Promise<void>;
+    list(threadId: string, opts?: CheckpointListOptions): Promise<ONICheckpoint<S>[]>;
+    delete(threadId: string): Promise<void>;
+}
+//# sourceMappingURL=namespaced.d.ts.map

package/dist/checkpointers/namespaced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespaced.d.ts","sourceRoot":"","sources":["../../src/checkpointers/namespaced.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzF,qBAAa,sBAAsB,CAAC,CAAC,CAAE,YAAW,eAAe,CAAC,CAAC,CAAC;IAEhE,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,EAAE;gBADF,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,EACzB,EAAE,EAAE,MAAM;IAG7B,OAAO,CAAC,MAAM;IAIR,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAMvD,GAAG,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhD,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IAKjF,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG9C"}

package/dist/checkpointers/namespaced.js

@@ -0,0 +1,37 @@
+// ============================================================
+// @oni.bot/core — Namespaced Checkpointer Wrapper
+// ============================================================
+// Prefixes threadId with a namespace for checkpoint isolation.
+// Used by subgraphs to avoid checkpoint collisions with parent.
+// ============================================================
+export class NamespacedCheckpointer {
+    inner;
+    ns;
+    constructor(inner, ns) {
+        this.inner = inner;
+        this.ns = ns;
+    }
+    prefix(threadId) {
+        return `${threadId}:${this.ns}`;
+    }
+    async get(threadId) {
+        const cp = await this.inner.get(this.prefix(threadId));
+        if (!cp)
+            return null;
+        return { ...cp, threadId };
+    }
+    async put(checkpoint) {
+        await this.inner.put({
+            ...checkpoint,
+            threadId: this.prefix(checkpoint.threadId),
+        });
+    }
+    async list(threadId, opts) {
+        const items = await this.inner.list(this.prefix(threadId), opts);
+        return items.map(c => ({ ...c, threadId }));
+    }
+    async delete(threadId) {
+        await this.inner.delete(this.prefix(threadId));
+    }
+}
+//# sourceMappingURL=namespaced.js.map

package/dist/checkpointers/namespaced.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespaced.js","sourceRoot":"","sources":["../../src/checkpointers/namespaced.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,kDAAkD;AAClD,+DAA+D;AAC/D,+DAA+D;AAC/D,gEAAgE;AAChE,+DAA+D;AAI/D,MAAM,OAAO,sBAAsB;IAEd;IACA;IAFnB,YACmB,KAAyB,EACzB,EAAU;QADV,UAAK,GAAL,KAAK,CAAoB;QACzB,OAAE,GAAF,EAAE,CAAQ;IAC1B,CAAC;IAEI,MAAM,CAAC,QAAgB;QAC7B,OAAO,GAAG,QAAQ,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,QAAgB;QACxB,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QACvD,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QACrB,OAAO,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,UAA4B;QACpC,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;YACnB,GAAG,UAAU;YACb,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC;SAC3C,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAgB,EAAE,IAA4B;QACvD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC;QACjE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,QAAgB;QAC3B,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/checkpointers/postgres.d.ts

@@ -0,0 +1,13 @@
+import type { ONICheckpoint, ONICheckpointer, CheckpointListOptions } from "../types.js";
+export declare class PostgresCheckpointer<S> implements ONICheckpointer<S> {
+    private readonly pool;
+    private constructor();
+    static create<S>(connectionString: string): Promise<PostgresCheckpointer<S>>;
+    get(threadId: string): Promise<ONICheckpoint<S> | null>;
+    put(cp: ONICheckpoint<S>): Promise<void>;
+    list(threadId: string, opts?: CheckpointListOptions): Promise<ONICheckpoint<S>[]>;
+    delete(threadId: string): Promise<void>;
+    close(): Promise<void>;
+    private deserialize;
+}
+//# sourceMappingURL=postgres.d.ts.map

package/dist/checkpointers/postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../src/checkpointers/postgres.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAOzF,qBAAa,oBAAoB,CAAC,CAAC,CAAE,YAAW,eAAe,CAAC,CAAC,CAAC;IAC5C,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAzC,OAAO;WAEM,MAAM,CAAC,CAAC,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;IA2B5E,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAQvD,GAAG,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBxC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IA8BjF,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,OAAO,CAAC,WAAW;CAgBpB"}

package/dist/checkpointers/postgres.js

@@ -0,0 +1,100 @@
+// ============================================================
+// @oni.bot/core — PostgreSQL Checkpointer
+// ============================================================
+// Production-grade checkpointer using PostgreSQL.
+// Requires `pg` as an optional peer dependency.
+// ============================================================
+export class PostgresCheckpointer {
+    pool;
+    constructor(pool) {
+        this.pool = pool;
+    }
+    static async create(connectionString) {
+        // @ts-ignore — pg is an optional peer dependency
+        const pg = await import("pg");
+        const Pool = pg.Pool ?? pg.default?.Pool ?? pg;
+        const pool = new Pool({ connectionString });
+        await pool.query(`
+      CREATE TABLE IF NOT EXISTS oni_checkpoints (
+        thread_id      TEXT    NOT NULL,
+        step           INTEGER NOT NULL,
+        agent_id       TEXT,
+        state          JSONB   NOT NULL,
+        next_nodes     JSONB   NOT NULL,
+        pending_sends  JSONB   NOT NULL DEFAULT '[]',
+        metadata       JSONB,
+        pending_writes JSONB,
+        timestamp      BIGINT  NOT NULL,
+        PRIMARY KEY (thread_id, step)
+      )
+    `);
+        await pool.query(`CREATE INDEX IF NOT EXISTS idx_oni_cp_thread ON oni_checkpoints (thread_id)`);
+        return new PostgresCheckpointer(pool);
+    }
+    async get(threadId) {
+        const { rows } = await this.pool.query("SELECT * FROM oni_checkpoints WHERE thread_id=$1 ORDER BY step DESC LIMIT 1", [threadId]);
+        return rows.length > 0 ? this.deserialize(rows[0]) : null;
+    }
+    async put(cp) {
+        await this.pool.query(`INSERT INTO oni_checkpoints
+        (thread_id, step, agent_id, state, next_nodes, pending_sends, metadata, pending_writes, timestamp)
+       VALUES ($1,$2,$3,$4,$5,$6,$7,$8,$9)
+       ON CONFLICT (thread_id, step)
+       DO UPDATE SET state=$4, next_nodes=$5, pending_sends=$6, metadata=$7, pending_writes=$8, timestamp=$9`, [
+            cp.threadId,
+            cp.step,
+            cp.agentId ?? null,
+            JSON.stringify(cp.state),
+            JSON.stringify(cp.nextNodes),
+            JSON.stringify(cp.pendingSends ?? []),
+            cp.metadata ? JSON.stringify(cp.metadata) : null,
+            cp.pendingWrites ? JSON.stringify(cp.pendingWrites) : null,
+            cp.timestamp,
+        ]);
+    }
+    async list(threadId, opts) {
+        let sql = "SELECT * FROM oni_checkpoints WHERE thread_id=$1";
+        const params = [threadId];
+        let paramIdx = 2;
+        if (opts?.before !== undefined) {
+            sql += ` AND step < $${paramIdx++}`;
+            params.push(opts.before);
+        }
+        sql += " ORDER BY step ASC";
+        if (opts?.limit !== undefined) {
+            sql += ` LIMIT $${paramIdx++}`;
+            params.push(opts.limit);
+        }
+        const { rows } = await this.pool.query(sql, params);
+        let items = rows.map(r => this.deserialize(r));
+        if (opts?.filter) {
+            items = items.filter(c => {
+                if (!c.metadata)
+                    return false;
+                return Object.entries(opts.filter).every(([k, v]) => c.metadata[k] === v);
+            });
+        }
+        return items;
+    }
+    async delete(threadId) {
+        await this.pool.query("DELETE FROM oni_checkpoints WHERE thread_id=$1", [threadId]);
+    }
+    async close() {
+        await this.pool.end();
+    }
+    deserialize(row) {
+        const parse = (val) => typeof val === "string" ? JSON.parse(val) : val;
+        return {
+            threadId: row.thread_id,
+            step: row.step,
+            agentId: row.agent_id ?? undefined,
+            state: parse(row.state),
+            nextNodes: parse(row.next_nodes),
+            pendingSends: parse(row.pending_sends),
+            metadata: row.metadata ? parse(row.metadata) : undefined,
+            pendingWrites: row.pending_writes ? parse(row.pending_writes) : undefined,
+            timestamp: Number(row.timestamp),
+        };
+    }
+}
+//# sourceMappingURL=postgres.js.map

package/dist/checkpointers/postgres.js.map

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

package/dist/checkpointers/sqlite.d.ts

@@ -0,0 +1,14 @@
+import type { ONICheckpoint, ONICheckpointer, CheckpointListOptions } from "../types.js";
+export declare class SqliteCheckpointer<S> implements ONICheckpointer<S> {
+    private readonly db;
+    private constructor();
+    static create<S>(dbPath: string): Promise<SqliteCheckpointer<S>>;
+    get(threadId: string): Promise<ONICheckpoint<S> | null>;
+    put(cp: ONICheckpoint<S>): Promise<void>;
+    list(threadId: string, opts?: CheckpointListOptions): Promise<ONICheckpoint<S>[]>;
+    delete(threadId: string): Promise<void>;
+    getAt(threadId: string, step: number): Promise<ONICheckpoint<S> | null>;
+    close(): void;
+    private deserialize;
+}
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/checkpointers/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/checkpointers/sqlite.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAQzF,qBAAa,kBAAkB,CAAC,CAAC,CAAE,YAAW,eAAe,CAAC,CAAC,CAAC;IAC1C,OAAO,CAAC,QAAQ,CAAC,EAAE;IAAvC,OAAO;WAEM,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;IA2BhE,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAOvD,GAAG,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAYxC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IA6BjF,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAK7E,KAAK,IAAI,IAAI;IAEb,OAAO,CAAC,WAAW;CAYpB"}