@oni.bot/core 0.6.1

package/dist/hitl/resume.d.ts

@@ -0,0 +1,33 @@
+import type { ONICheckpoint } from "../types.js";
+import type { InterruptValue } from "./interrupt.js";
+export interface HITLSession<S> {
+    threadId: string;
+    resumeId: string;
+    node: string;
+    interrupt: InterruptValue;
+    checkpoint: ONICheckpoint<S>;
+    createdAt: number;
+    status: "pending" | "resumed" | "expired";
+}
+export declare class HITLSessionStore<S> {
+    private sessions;
+    record(threadId: string, interrupt: InterruptValue, checkpoint: ONICheckpoint<S>): HITLSession<S>;
+    get(resumeId: string): HITLSession<S> | null;
+    getByThread(threadId: string): HITLSession<S>[];
+    markResumed(resumeId: string): void;
+    pendingCount(): number;
+    all(): HITLSession<S>[];
+}
+export declare class HITLInterruptException<S = unknown> {
+    readonly threadId: string;
+    readonly interrupt: InterruptValue;
+    readonly state: S;
+    readonly isHITLInterrupt = true;
+    constructor(threadId: string, interrupt: InterruptValue, state: S);
+    /** Convenience: was this a getUserInput request? */
+    get isUserInputRequest(): boolean;
+    get prompt(): string | undefined;
+    get inputType(): string | undefined;
+    get choices(): string[] | undefined;
+}
+//# sourceMappingURL=resume.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resume.d.ts","sourceRoot":"","sources":["../../src/hitl/resume.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAmB,aAAa,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,gBAAgB,CAAC;AAMlE,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,QAAQ,EAAI,MAAM,CAAC;IACnB,QAAQ,EAAI,MAAM,CAAC;IACnB,IAAI,EAAQ,MAAM,CAAC;IACnB,SAAS,EAAG,cAAc,CAAC;IAC3B,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAC7B,SAAS,EAAG,MAAM,CAAC;IACnB,MAAM,EAAM,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;CAC/C;AAED,qBAAa,gBAAgB,CAAC,CAAC;IAC7B,OAAO,CAAC,QAAQ,CAAqC;IAErD,MAAM,CACJ,QAAQ,EAAI,MAAM,EAClB,SAAS,EAAG,cAAc,EAC1B,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,GAC3B,WAAW,CAAC,CAAC,CAAC;IAcjB,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI;IAI5C,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE;IAM/C,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKnC,YAAY,IAAI,MAAM;IAItB,GAAG,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE;CAGxB;AAMD,qBAAa,sBAAsB,CAAC,CAAC,GAAG,OAAO;aAI3B,QAAQ,EAAG,MAAM;aACjB,SAAS,EAAE,cAAc;aACzB,KAAK,EAAM,CAAC;IAL9B,QAAQ,CAAC,eAAe,QAAQ;gBAGd,QAAQ,EAAG,MAAM,EACjB,SAAS,EAAE,cAAc,EACzB,KAAK,EAAM,CAAC;IAG9B,oDAAoD;IACpD,IAAI,kBAAkB,IAAI,OAAO,CAMhC;IAED,IAAI,MAAM,IAAI,MAAM,GAAG,SAAS,CAG/B;IAED,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAGlC;IAED,IAAI,OAAO,IAAI,MAAM,EAAE,GAAG,SAAS,CAGlC;CACF"}

package/dist/hitl/resume.js

@@ -0,0 +1,72 @@
+// ============================================================
+// @oni.bot/core/hitl — Resume & HITL Session Management
+// ============================================================
+export class HITLSessionStore {
+    sessions = new Map();
+    record(threadId, interrupt, checkpoint) {
+        const session = {
+            threadId,
+            resumeId: interrupt.resumeId,
+            node: interrupt.node,
+            interrupt,
+            checkpoint,
+            createdAt: Date.now(),
+            status: "pending",
+        };
+        this.sessions.set(interrupt.resumeId, session);
+        return session;
+    }
+    get(resumeId) {
+        return this.sessions.get(resumeId) ?? null;
+    }
+    getByThread(threadId) {
+        return [...this.sessions.values()].filter((s) => s.threadId === threadId && s.status === "pending");
+    }
+    markResumed(resumeId) {
+        const s = this.sessions.get(resumeId);
+        if (s)
+            s.status = "resumed";
+    }
+    pendingCount() {
+        return [...this.sessions.values()].filter((s) => s.status === "pending").length;
+    }
+    all() {
+        return [...this.sessions.values()];
+    }
+}
+// ----------------------------------------------------------------
+// Pending interrupt surface — what callers catch
+// ----------------------------------------------------------------
+export class HITLInterruptException {
+    threadId;
+    interrupt;
+    state;
+    isHITLInterrupt = true;
+    constructor(threadId, interrupt, state) {
+        this.threadId = threadId;
+        this.interrupt = interrupt;
+        this.state = state;
+    }
+    /** Convenience: was this a getUserInput request? */
+    get isUserInputRequest() {
+        return (typeof this.interrupt.value === "object" &&
+            this.interrupt.value !== null &&
+            this.interrupt.value.__type === "user_input_request");
+    }
+    get prompt() {
+        if (!this.isUserInputRequest)
+            return undefined;
+        return this.interrupt.value.prompt;
+    }
+    get inputType() {
+        if (!this.isUserInputRequest)
+            return undefined;
+        return this.interrupt.value.inputType;
+    }
+    get choices() {
+        if (!this.isUserInputRequest)
+            return undefined;
+        return this.interrupt.value.choices;
+    }
+}
+//# sourceMappingURL=resume.js.map

package/dist/hitl/resume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.js","sourceRoot":"","sources":["../../src/hitl/resume.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,wDAAwD;AACxD,+DAA+D;AAmB/D,MAAM,OAAO,gBAAgB;IACnB,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;IAErD,MAAM,CACJ,QAAkB,EAClB,SAA0B,EAC1B,UAA4B;QAE5B,MAAM,OAAO,GAAmB;YAC9B,QAAQ;YACR,QAAQ,EAAG,SAAS,CAAC,QAAQ;YAC7B,IAAI,EAAO,SAAS,CAAC,IAAI;YACzB,SAAS;YACT,UAAU;YACV,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,MAAM,EAAK,SAAS;SACrB,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC/C,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,GAAG,CAAC,QAAgB;QAClB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;IAC7C,CAAC;IAED,WAAW,CAAC,QAAgB;QAC1B,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CACvC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,CACzD,CAAC;IACJ,CAAC;IAED,WAAW,CAAC,QAAgB;QAC1B,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,CAAC;YAAE,CAAC,CAAC,MAAM,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED,YAAY;QACV,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IAClF,CAAC;IAED,GAAG;QACD,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACrC,CAAC;CACF;AAED,mEAAmE;AACnE,iDAAiD;AACjD,mEAAmE;AAEnE,MAAM,OAAO,sBAAsB;IAIf;IACA;IACA;IALT,eAAe,GAAG,IAAI,CAAC;IAEhC,YACkB,QAAiB,EACjB,SAAyB,EACzB,KAAY;QAFZ,aAAQ,GAAR,QAAQ,CAAS;QACjB,cAAS,GAAT,SAAS,CAAgB;QACzB,UAAK,GAAL,KAAK,CAAO;IAC3B,CAAC;IAEJ,oDAAoD;IACpD,IAAI,kBAAkB;QACpB,OAAO,CACL,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,KAAK,QAAQ;YACxC,IAAI,CAAC,SAAS,CAAC,KAAK,KAAK,IAAI;YAC5B,IAAI,CAAC,SAAS,CAAC,KAAgC,CAAC,MAAM,KAAK,oBAAoB,CACjF,CAAC;IACJ,CAAC;IAED,IAAI,MAAM;QACR,IAAI,CAAC,IAAI,CAAC,kBAAkB;YAAE,OAAO,SAAS,CAAC;QAC/C,OAAQ,IAAI,CAAC,SAAS,CAAC,KAAgC,CAAC,MAAgB,CAAC;IAC3E,CAAC;IAED,IAAI,SAAS;QACX,IAAI,CAAC,IAAI,CAAC,kBAAkB;YAAE,OAAO,SAAS,CAAC;QAC/C,OAAQ,IAAI,CAAC,SAAS,CAAC,KAAgC,CAAC,SAAmB,CAAC;IAC9E,CAAC;IAED,IAAI,OAAO;QACT,IAAI,CAAC,IAAI,CAAC,kBAAkB;YAAE,OAAO,SAAS,CAAC;QAC/C,OAAQ,IAAI,CAAC,SAAS,CAAC,KAAgC,CAAC,OAAmB,CAAC;IAC9E,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,57 @@
+export { StateGraph, MessageGraph } from "./graph.js";
+export type { CompileOptions, ONIMessage, ONIToolCall, MessageState, ONISkeletonV3 } from "./graph.js";
+export { MemoryCheckpointer, NoopCheckpointer, PersistentCheckpointer } from "./checkpoint.js";
+export { SqliteCheckpointer, NamespacedCheckpointer, PostgresCheckpointer } from "./checkpointers/index.js";
+export { START, END } from "./types.js";
+export { lastValue, appendList, mergeObject, ephemeralValue } from "./types.js";
+export { Send, Command } from "./types.js";
+export type { CommandOptions } from "./types.js";
+export { messagesChannel, messagesReducer, messagesStateChannels, RemoveMessage, UpdateMessage, humanMessage, aiMessage, systemMessage, toolMessage, getMessageById, filterByRole, trimMessages, } from "./messages/index.js";
+export type { Message, BaseMessage, MessagesState, MessageUpdate } from "./messages/index.js";
+export { interrupt, getUserInput, getUserApproval, getUserSelection, HITLSessionStore, HITLInterruptException, NodeInterruptSignal, } from "./hitl/index.js";
+export type { InterruptValue, ResumeValue, GetUserInputOptions, HITLSession } from "./hitl/index.js";
+export { InMemoryStore, NamespacedStore, AgentMemoryStore, } from "./store/index.js";
+export type { StoreItem, SearchResult, Namespace, StoreKey, EmbedFn } from "./store/index.js";
+export { BaseStore } from "./store/index.js";
+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 { streamEvents } from "./stream-events.js";
+export type { StreamEvent } from "./stream-events.js";
+export { buildGraphDescriptor, toMermaidDetailed } from "./inspect.js";
+export type { GraphDescriptor, GraphNode, GraphEdge, NodeType } from "./inspect.js";
+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 { 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";
+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 type { ToolDefinition, ToolContext, DefineToolOptions, ToolPermissions } from "./tools/index.js";
+export { defineTool, executeTool, executeToolCalls } from "./tools/index.js";
+export { RequestReplyBroker } from "./coordination/request-reply.js";
+export type { PendingRequest } from "./coordination/request-reply.js";
+export { PubSub, topicMatches } from "./coordination/pubsub.js";
+export type { TopicMessage } from "./coordination/pubsub.js";
+export type { LifecycleEvent, EventType, EventHandler, EventListeners } from "./events/index.js";
+export { EventBus } from "./events/index.js";
+export type { GuardrailsConfig, BudgetConfig, ContentFilter, ContentFilterResult, AuditEntry } from "./guardrails/index.js";
+export { checkToolPermission, getPermittedTools, ToolPermissionError } from "./guardrails/index.js";
+export { BudgetTracker, BudgetExceededError } from "./guardrails/index.js";
+export { piiFilter, topicFilter, customFilter, runFilters } from "./guardrails/index.js";
+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 { google } from "./models/google.js";
+export { ollama } from "./models/ollama.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"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,MAAM,gBAAgB,CAAC;AAChF,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGvE,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,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;AAC1B,YAAY,EACV,aAAa,EAAE,WAAW,EAAE,eAAe,EAC3C,cAAc,EAAE,aAAa,EAC7B,YAAY,EAAE,SAAS,EAAE,cAAc,EACvC,gBAAgB,EAAE,eAAe,EAAE,yBAAyB,EAC5D,SAAS,EAAE,eAAe,EAC1B,aAAa,EAAE,eAAe,EAAE,kBAAkB,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,sBAAsB,GAC3J,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,EACL,QAAQ,EAAE,oBAAoB,EAAE,mBAAmB,EACnD,iBAAiB,EAAE,iBAAiB,EAAE,kBAAkB,EACxD,YAAY,GACb,MAAM,aAAa,CAAC;AAGrB,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,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,58 @@
+// ============================================================
+// @oni.bot/core v0.4.0 — Public API
+// ============================================================
+// -- Graph builder & skeletons
+export { StateGraph, MessageGraph } from "./graph.js";
+// -- Checkpointers
+export { MemoryCheckpointer, NoopCheckpointer, PersistentCheckpointer } from "./checkpoint.js";
+export { SqliteCheckpointer, NamespacedCheckpointer, PostgresCheckpointer } from "./checkpointers/index.js";
+// -- Sentinel values
+export { START, END } from "./types.js";
+// -- Channel constructors
+export { lastValue, appendList, mergeObject, ephemeralValue } from "./types.js";
+// -- Send + Command
+export { Send, Command } from "./types.js";
+// -- Messages (addMessages reducer)  ← NEW
+export { messagesChannel, messagesReducer, messagesStateChannels, RemoveMessage, UpdateMessage, humanMessage, aiMessage, systemMessage, toolMessage, getMessageById, filterByRole, trimMessages, } from "./messages/index.js";
+// -- HITL: interrupt() + getUserInput  ← NEW
+export { interrupt, getUserInput, getUserApproval, getUserSelection, HITLSessionStore, HITLInterruptException, NodeInterruptSignal, } from "./hitl/index.js";
+// -- Cross-thread Store  ← NEW
+export { InMemoryStore, NamespacedStore, AgentMemoryStore, } from "./store/index.js";
+export { BaseStore } from "./store/index.js";
+// -- Injected tools  ← NEW
+export { createInjectedTool } from "./injected.js";
+// -- Runtime Context  ← NEW
+export { getConfig, getStore, getStreamWriter, getCurrentState, getRemainingSteps } from "./context.js";
+// -- Token streaming  ← NEW
+export { emitToken, TokenStreamWriter, StreamWriterImpl } from "./streaming.js";
+// -- Stream events protocol  ← NEW
+export { streamEvents } from "./stream-events.js";
+// -- Graph inspection  ← NEW
+export { buildGraphDescriptor, toMermaidDetailed } from "./inspect.js";
+// -- Functional API  ← NEW
+export { entrypoint, pipe, branch, task } from "./functional.js";
+// -- Retry
+export { withRetry } from "./retry.js";
+// -- Swarm primitives
+export { SwarmGraph, AgentRegistry, AgentPool, AgentPool as Pool, Handoff, createSupervisorNode, baseSwarmChannels, createMessage, getInbox, consumeInbox, formatInbox, } 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";
+// -- Errors
+export { ONIError, InvalidSkeletonError, RecursionLimitError, NodeNotFoundError, EdgeConflictError, NodeExecutionError, ONIInterrupt, } from "./errors.js";
+export { defineTool, executeTool, executeToolCalls } from "./tools/index.js";
+// Coordination
+export { RequestReplyBroker } from "./coordination/request-reply.js";
+export { PubSub, topicMatches } from "./coordination/pubsub.js";
+export { EventBus } from "./events/index.js";
+export { checkToolPermission, getPermittedTools, ToolPermissionError } from "./guardrails/index.js";
+export { BudgetTracker, BudgetExceededError } from "./guardrails/index.js";
+export { piiFilter, topicFilter, customFilter, runFilters } from "./guardrails/index.js";
+export { AuditLog } from "./guardrails/index.js";
+export { anthropic } from "./models/anthropic.js";
+export { openai } from "./models/openai.js";
+export { google } from "./models/google.js";
+export { ollama } from "./models/ollama.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/injected.d.ts

@@ -0,0 +1,26 @@
+import type { BaseStore } from "./store/index.js";
+export interface InjectedToolOptions<S, Args extends Record<string, unknown>> {
+    name: string;
+    description: string;
+    /** JSON Schema for the tool's arguments (visible to LLM — no injected params) */
+    schema: Record<string, unknown>;
+    /** Tool implementation receiving args + injected dependencies */
+    fn: (args: Args, injected: {
+        state: S;
+        store: BaseStore | null;
+    }) => Promise<unknown> | unknown;
+}
+export interface InjectedTool<S, Args extends Record<string, unknown>> {
+    name: string;
+    description: string;
+    schema: Record<string, unknown>;
+    /** Call the tool — state and store are injected from runtime context */
+    fn: (args: Args) => Promise<unknown>;
+}
+/**
+ * Create a tool that automatically receives state and store from the
+ * runtime context. The schema only includes the tool's own arguments,
+ * not the injected dependencies.
+ */
+export declare function createInjectedTool<S, Args extends Record<string, unknown>>(opts: InjectedToolOptions<S, Args>): InjectedTool<S, Args>;
+//# sourceMappingURL=injected.d.ts.map

package/dist/injected.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injected.d.ts","sourceRoot":"","sources":["../src/injected.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,WAAW,mBAAmB,CAAC,CAAC,EAAE,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,iEAAiE;IACjE,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;QAAE,KAAK,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACjG;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,EAAE,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,wEAAwE;IACxE,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACtC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxE,IAAI,EAAE,mBAAmB,CAAC,CAAC,EAAE,IAAI,CAAC,GACjC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,CAWvB"}

package/dist/injected.js

@@ -0,0 +1,25 @@
+// ============================================================
+// @oni.bot/core — Injected Tool Factory
+// ============================================================
+// Creates tools that automatically receive state and store
+// from the runtime context, hiding these from the tool schema.
+// ============================================================
+import { getCurrentState, getStore } from "./context.js";
+/**
+ * Create a tool that automatically receives state and store from the
+ * runtime context. The schema only includes the tool's own arguments,
+ * not the injected dependencies.
+ */
+export function createInjectedTool(opts) {
+    return {
+        name: opts.name,
+        description: opts.description,
+        schema: opts.schema,
+        fn: async (args) => {
+            const state = getCurrentState();
+            const store = getStore();
+            return opts.fn(args, { state, store });
+        },
+    };
+}
+//# sourceMappingURL=injected.js.map

package/dist/injected.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injected.js","sourceRoot":"","sources":["../src/injected.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,wCAAwC;AACxC,+DAA+D;AAC/D,2DAA2D;AAC3D,+DAA+D;AAC/D,+DAA+D;AAE/D,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAoBzD;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAkC;IAElC,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,EAAE,EAAE,KAAK,EAAE,IAAU,EAAE,EAAE;YACvB,MAAM,KAAK,GAAG,eAAe,EAAK,CAAC;YACnC,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACzC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/inspect.d.ts

@@ -0,0 +1,31 @@
+import type { Edge } from "./types.js";
+export type NodeType = "start" | "end" | "node" | "subgraph";
+export interface GraphNode {
+    id: string;
+    type: NodeType;
+    hasRetry: boolean;
+    isSubgraph: boolean;
+}
+export interface GraphEdge {
+    from: string;
+    to: string;
+    type: "static" | "conditional";
+    label?: string;
+}
+export interface GraphDescriptor {
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+    /** Nodes that have no outgoing edges to non-END nodes */
+    terminals: string[];
+    /** Nodes that can reach themselves (cycles) */
+    cycles: string[][];
+    /** Topologically sorted node order (if acyclic) */
+    topoOrder: string[] | null;
+}
+export declare function buildGraphDescriptor<S>(nodeMap: Map<string, {
+    name: string;
+    retry?: unknown;
+    subgraph?: unknown;
+}>, edges: Edge<S>[]): GraphDescriptor;
+export declare function toMermaidDetailed(descriptor: GraphDescriptor): string;
+//# sourceMappingURL=inspect.d.ts.map

package/dist/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../src/inspect.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAY,IAAI,EAAE,MAAM,YAAY,CAAC;AAMjD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;AAE7D,MAAM,WAAW,SAAS;IACxB,EAAE,EAAQ,MAAM,CAAC;IACjB,IAAI,EAAM,QAAQ,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAS,MAAM,CAAC;IACpB,EAAE,EAAW,MAAM,CAAC;IACpB,IAAI,EAAS,QAAQ,GAAG,aAAa,CAAC;IACtC,KAAK,CAAC,EAAO,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAM,SAAS,EAAE,CAAC;IACvB,KAAK,EAAM,SAAS,EAAE,CAAC;IACvB,yDAAyD;IACzD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,+CAA+C;IAC/C,MAAM,EAAK,MAAM,EAAE,EAAE,CAAC;IACtB,mDAAmD;IACnD,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CAC5B;AAMD,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,EAC3E,KAAK,EAAI,IAAI,CAAC,CAAC,CAAC,EAAE,GACjB,eAAe,CAsCjB;AAiFD,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,eAAe,GAAG,MAAM,CAqBrE"}

package/dist/inspect.js

@@ -0,0 +1,139 @@
+// ============================================================
+// @oni.bot/core — Graph Inspection API
+// ============================================================
+// Returns a structured object describing the graph topology.
+// Used by: visualizers, AgentOS ADE, debuggers, validators.
+// ============================================================
+import { START, END } from "./types.js";
+// ----------------------------------------------------------------
+// buildGraphDescriptor — called by StateGraph.getGraph()
+// ----------------------------------------------------------------
+export function buildGraphDescriptor(nodeMap, edges) {
+    // Build node list
+    const nodes = [
+        { id: START, type: "start", hasRetry: false, isSubgraph: false },
+        { id: END, type: "end", hasRetry: false, isSubgraph: false },
+    ];
+    for (const [id, def] of nodeMap) {
+        nodes.push({
+            id,
+            type: def.subgraph ? "subgraph" : "node",
+            hasRetry: !!def.retry,
+            isSubgraph: !!def.subgraph,
+        });
+    }
+    // Build edge list
+    const graphEdges = edges.map((e) => ({
+        from: e.from,
+        to: e.type === "static" ? e.to : "conditional",
+        type: e.type,
+        label: e.type === "conditional" ? "condition" : undefined,
+    }));
+    // Find terminal nodes
+    const nodeIds = new Set(nodes.map((n) => n.id));
+    const hasOutgoing = new Set(edges.map((e) => e.from));
+    const terminals = nodes
+        .filter((n) => n.id !== START && n.id !== END && !hasOutgoing.has(n.id))
+        .map((n) => n.id);
+    // Detect cycles (DFS)
+    const cycles = detectCycles(nodeIds, graphEdges);
+    // Topological sort (Kahn's algorithm, returns null if cyclic)
+    const topoOrder = cycles.length === 0 ? topoSort(nodeIds, graphEdges) : null;
+    return { nodes, edges: graphEdges, terminals, cycles, topoOrder };
+}
+// ----------------------------------------------------------------
+// Cycle detection — DFS
+// ----------------------------------------------------------------
+function detectCycles(nodes, edges) {
+    const adj = new Map();
+    for (const id of nodes)
+        adj.set(id, []);
+    for (const e of edges) {
+        if (e.to !== "conditional")
+            adj.get(e.from)?.push(e.to);
+    }
+    const cycles = [];
+    const visited = new Set();
+    const stack = new Set();
+    const path = [];
+    function dfs(node) {
+        if (stack.has(node)) {
+            // Found a cycle — extract it
+            const cycleStart = path.indexOf(node);
+            if (cycleStart >= 0)
+                cycles.push(path.slice(cycleStart));
+            return;
+        }
+        if (visited.has(node))
+            return;
+        visited.add(node);
+        stack.add(node);
+        path.push(node);
+        for (const neighbor of adj.get(node) ?? []) {
+            dfs(neighbor);
+        }
+        path.pop();
+        stack.delete(node);
+    }
+    for (const id of nodes)
+        dfs(id);
+    return cycles;
+}
+// ----------------------------------------------------------------
+// Topological sort — Kahn's algorithm
+// ----------------------------------------------------------------
+function topoSort(nodes, edges) {
+    const inDegree = new Map();
+    const adj = new Map();
+    for (const id of nodes) {
+        inDegree.set(id, 0);
+        adj.set(id, []);
+    }
+    for (const e of edges) {
+        if (e.to === "conditional")
+            continue;
+        adj.get(e.from)?.push(e.to);
+        inDegree.set(e.to, (inDegree.get(e.to) ?? 0) + 1);
+    }
+    const queue = [...nodes].filter((n) => (inDegree.get(n) ?? 0) === 0);
+    const result = [];
+    while (queue.length > 0) {
+        const node = queue.shift();
+        result.push(node);
+        for (const neighbor of adj.get(node) ?? []) {
+            const deg = (inDegree.get(neighbor) ?? 0) - 1;
+            inDegree.set(neighbor, deg);
+            if (deg === 0)
+                queue.push(neighbor);
+        }
+    }
+    return result;
+}
+// ----------------------------------------------------------------
+// Mermaid generator (richer than the basic one in StateGraph)
+// ----------------------------------------------------------------
+export function toMermaidDetailed(descriptor) {
+    const lines = ["graph TD"];
+    for (const edge of descriptor.edges) {
+        if (edge.type === "static") {
+            lines.push(`    ${edge.from} --> ${edge.to}`);
+        }
+        else {
+            lines.push(`    ${edge.from} -->|${edge.label ?? "?"}| ${edge.from}_router`);
+            lines.push(`    ${edge.from}_router:::conditional`);
+        }
+    }
+    for (const node of descriptor.nodes) {
+        if (node.id === START)
+            lines.push(`    style ${node.id} fill:#7c3aed,color:#fff`);
+        else if (node.id === END)
+            lines.push(`    style ${node.id} fill:#1e1e2e,color:#fff`);
+        else if (node.isSubgraph)
+            lines.push(`    style ${node.id} fill:#0ea5e9,color:#fff`);
+        else if (node.hasRetry)
+            lines.push(`    style ${node.id} fill:#f59e0b,color:#000`);
+    }
+    lines.push(`    classDef conditional fill:#6b7280,color:#fff`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=inspect.js.map

package/dist/inspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.js","sourceRoot":"","sources":["../src/inspect.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,uCAAuC;AACvC,+DAA+D;AAC/D,6DAA6D;AAC7D,4DAA4D;AAC5D,+DAA+D;AAE/D,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAkCxC,mEAAmE;AACnE,yDAAyD;AACzD,mEAAmE;AAEnE,MAAM,UAAU,oBAAoB,CAClC,OAA2E,EAC3E,KAAkB;IAElB,kBAAkB;IAClB,MAAM,KAAK,GAAgB;QACzB,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE;QAChE,EAAE,EAAE,EAAE,GAAG,EAAI,IAAI,EAAE,KAAK,EAAI,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE;KACjE,CAAC;IAEF,KAAK,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC;YACT,EAAE;YACF,IAAI,EAAQ,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM;YAC9C,QAAQ,EAAI,CAAC,CAAC,GAAG,CAAC,KAAK;YACvB,UAAU,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ;SAC3B,CAAC,CAAC;IACL,CAAC;IAED,kBAAkB;IAClB,MAAM,UAAU,GAAgB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChD,IAAI,EAAG,CAAC,CAAC,IAAc;QACvB,EAAE,EAAK,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC,EAAa,CAAC,CAAC,CAAC,aAAa;QAC7D,IAAI,EAAG,CAAC,CAAC,IAAI;QACb,KAAK,EAAE,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;KAC1D,CAAC,CAAC,CAAC;IAEJ,sBAAsB;IACtB,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAc,CAAC,CAAC,CAAC;IAChE,MAAM,SAAS,GAAG,KAAK;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SACvE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAEpB,sBAAsB;IACtB,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAEjD,8DAA8D;IAC9D,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAE7E,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AACpE,CAAC;AAED,mEAAmE;AACnE,wBAAwB;AACxB,mEAAmE;AAEnE,SAAS,YAAY,CACnB,KAAkB,EAClB,KAAkB;IAElB,MAAM,GAAG,GAAG,IAAI,GAAG,EAAoB,CAAC;IACxC,KAAK,MAAM,EAAE,IAAI,KAAK;QAAE,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,EAAE,KAAK,aAAa;YAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,KAAK,GAAK,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,IAAI,GAAe,EAAE,CAAC;IAE5B,SAAS,GAAG,CAAC,IAAY;QACvB,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,6BAA6B;YAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,UAAU,IAAI,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;YACzD,OAAO;QACT,CAAC;QACD,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO;QAE9B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEhB,KAAK,MAAM,QAAQ,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAC3C,GAAG,CAAC,QAAQ,CAAC,CAAC;QAChB,CAAC;QAED,IAAI,CAAC,GAAG,EAAE,CAAC;QACX,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IAED,KAAK,MAAM,EAAE,IAAI,KAAK;QAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAChC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,mEAAmE;AACnE,sCAAsC;AACtC,mEAAmE;AAEnE,SAAS,QAAQ,CAAC,KAAkB,EAAE,KAAkB;IACtD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,MAAM,GAAG,GAAQ,IAAI,GAAG,EAAoB,CAAC;IAE7C,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;QAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAAC,CAAC;IACjE,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,EAAE,KAAK,aAAa;YAAE,SAAS;QACrC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC5B,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,KAAK,GAAI,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAG,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClB,KAAK,MAAM,QAAQ,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAC3C,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAC9C,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YAC5B,IAAI,GAAG,KAAK,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,mEAAmE;AACnE,8DAA8D;AAC9D,mEAAmE;AAEnE,MAAM,UAAU,iBAAiB,CAAC,UAA2B;IAC3D,MAAM,KAAK,GAAa,CAAC,UAAU,CAAC,CAAC;IAErC,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;QACpC,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,QAAQ,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAChD,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,QAAQ,IAAI,CAAC,KAAK,IAAI,GAAG,KAAK,IAAI,CAAC,IAAI,SAAS,CAAC,CAAC;YAC7E,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,uBAAuB,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;QACpC,IAAS,IAAI,CAAC,EAAE,KAAK,KAAK;YAAK,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,EAAE,0BAA0B,CAAC,CAAC;aACrF,IAAI,IAAI,CAAC,EAAE,KAAK,GAAG;YAAO,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,EAAE,0BAA0B,CAAC,CAAC;aACrF,IAAI,IAAI,CAAC,UAAU;YAAO,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,EAAE,0BAA0B,CAAC,CAAC;aACrF,IAAI,IAAI,CAAC,QAAQ;YAAS,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,EAAE,0BAA0B,CAAC,CAAC;IAC5F,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;IAC/D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/messages/index.d.ts

@@ -0,0 +1,66 @@
+import type { Channel } from "../types.js";
+export interface BaseMessage {
+    id?: string;
+    role: "user" | "assistant" | "system" | "tool";
+    content: string;
+    name?: string;
+    tool_call_id?: string;
+    tool_calls?: Array<{
+        id: string;
+        name: string;
+        args: Record<string, unknown>;
+    }>;
+    /** Arbitrary metadata */
+    metadata?: Record<string, unknown>;
+}
+export type Message = BaseMessage & {
+    id: string;
+};
+export declare class RemoveMessage {
+    readonly id: string;
+    readonly __type: "RemoveMessage";
+    constructor(id: string);
+}
+export declare class UpdateMessage {
+    readonly id: string;
+    readonly patch: Partial<BaseMessage>;
+    readonly __type: "UpdateMessage";
+    constructor(id: string, patch: Partial<BaseMessage>);
+}
+export type MessageUpdate = BaseMessage | RemoveMessage | UpdateMessage;
+/**
+ * Smart reducer for message arrays.
+ * - Appending new messages: deduplicates by ID
+ * - RemoveMessage: removes message with matching ID
+ * - UpdateMessage: patches message with matching ID
+ */
+export declare function messagesReducer(current: Message[], update: MessageUpdate | MessageUpdate[]): Message[];
+/**
+ * A channel that uses the smart addMessages reducer.
+ *
+ * @example
+ * const graph = new StateGraph<MessagesState>({
+ *   channels: {
+ *     messages: messagesChannel(),
+ *   }
+ * });
+ */
+export declare function messagesChannel(): Channel<Message[]>;
+export type MessagesState = {
+    messages: Message[];
+};
+export declare const messagesStateChannels: {
+    messages: Channel<Message[]>;
+};
+export declare function humanMessage(content: string, id?: string): Message;
+export declare function aiMessage(content: string, opts?: {
+    id?: string;
+    tool_calls?: Message["tool_calls"];
+}): Message;
+export declare function systemMessage(content: string, id?: string): Message;
+export declare function toolMessage(content: string, tool_call_id: string, id?: string): Message;
+export declare function getMessageById(messages: Message[], id: string): Message | undefined;
+export declare function filterByRole(messages: Message[], role: Message["role"]): Message[];
+/** Trim message history to last N messages (keeps system message at index 0) */
+export declare function trimMessages(messages: Message[], maxMessages: number): Message[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/messages/index.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAM3C,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAY,MAAM,CAAC;IACtB,IAAI,EAAW,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;IACxD,OAAO,EAAQ,MAAM,CAAC;IACtB,IAAI,CAAC,EAAU,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAI,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IAClF,yBAAyB;IACzB,QAAQ,CAAC,EAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAGD,MAAM,MAAM,OAAO,GAAG,WAAW,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAMnD,qBAAa,aAAa;aAEI,EAAE,EAAE,MAAM;IADtC,QAAQ,CAAC,MAAM,EAAG,eAAe,CAAU;gBACf,EAAE,EAAE,MAAM;CACvC;AAED,qBAAa,aAAa;aAGN,EAAE,EAAM,MAAM;aACd,KAAK,EAAG,OAAO,CAAC,WAAW,CAAC;IAH9C,QAAQ,CAAC,MAAM,EAAG,eAAe,CAAU;gBAEzB,EAAE,EAAM,MAAM,EACd,KAAK,EAAG,OAAO,CAAC,WAAW,CAAC;CAE/C;AAED,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,aAAa,GAAG,aAAa,CAAC;AAmBxE;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAAE,EAClB,MAAM,EAAG,aAAa,GAAG,aAAa,EAAE,GACvC,OAAO,EAAE,CAyBX;AAMD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAKpD;AAMD,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,qBAAqB;;CAEjC,CAAC;AAMF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAElE;AAED,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;CAAE,GACzD,OAAO,CAET;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAEvF;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAEnF;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,EAAE,CAElF;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,EAAE,CAKhF"}