@slopus/happy-agent-base 0.0.6 → 0.0.8

package/dist/AgentKV.js.map

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

package/dist/AgentMessageAcceptance.d.ts

@@ -0,0 +1,14 @@
+/** The outcome of offering one caller-identified message to an agent. */
+export interface AgentMessageAcceptance {
+    /** The caller-supplied or Base-generated cuid2 identity. */
+    readonly id: string;
+    /** Which delivery queue accepted the message. */
+    readonly delivery: "send" | "steer";
+    /**
+     * Whether this identity was inserted now or was already known. This is the durable result
+     * unless the caller explicitly requests non-waiting delivery; in that mode Base returns the
+     * current process's immediate reservation. The target's own loop always uses that mode.
+     */
+    readonly accepted: "created" | "existing";
+}
+//# sourceMappingURL=AgentMessageAcceptance.d.ts.map

package/dist/AgentMessageAcceptance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentMessageAcceptance.d.ts","sourceRoot":"","sources":["../sources/AgentMessageAcceptance.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,MAAM,WAAW,sBAAsB;IACnC,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IACpC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,UAAU,CAAC;CAC7C"}

package/dist/AgentMessageAcceptance.js

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

package/dist/AgentMessageAcceptance.js.map

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

package/dist/AgentMetadata.d.ts

@@ -6,8 +6,8 @@ export declare const agentMetadataValueSchema: import("@sinclair/typebox").TRecu
 /** The TypeScript type inferred from {@link agentMetadataValueSchema}. */
 export type AgentMetadataValue = Static<typeof agentMetadataValueSchema>;
 /**
- * Metadata attached to one queued message. Features own additional fields; `hideFromUser` is the
- * common hint that a presentation feature should keep this message out of the user-visible view.
+ * Metadata attached to one queued message. Modules own additional fields; `hideFromUser` is the
+ * common hint that a presentation module should keep this message out of the user-visible view.
  */
 export declare const agentMessageMetadataSchema: import("@sinclair/typebox").TIntersect<[import("@sinclair/typebox").TObject<{
     hideFromUser: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
@@ -15,7 +15,7 @@ export declare const agentMessageMetadataSchema: import("@sinclair/typebox").TIn
 /** The TypeScript type inferred from {@link agentMessageMetadataSchema}. */
 export type AgentMessageMetadata = Static<typeof agentMessageMetadataSchema>;
 /**
- * Mutable-by-replacement metadata describing one agent. Features own additional fields; `title`
+ * Mutable-by-replacement metadata describing one agent. Modules own additional fields; `title`
  * is the common human-readable label.
  */
 export declare const agentMetadataSchema: import("@sinclair/typebox").TIntersect<[import("@sinclair/typebox").TObject<{

package/dist/AgentMetadata.js

@@ -16,8 +16,8 @@ export const agentMetadataValueSchema = Type.Recursive((value) => Type.Union([
     Type.Record(Type.String(), value),
 ]));
 /**
- * Metadata attached to one queued message. Features own additional fields; `hideFromUser` is the
- * common hint that a presentation feature should keep this message out of the user-visible view.
+ * Metadata attached to one queued message. Modules own additional fields; `hideFromUser` is the
+ * common hint that a presentation module should keep this message out of the user-visible view.
  */
 export const agentMessageMetadataSchema = Type.Intersect([
     Type.Object({
@@ -26,7 +26,7 @@ export const agentMessageMetadataSchema = Type.Intersect([
     Type.Record(Type.String(), agentMetadataValueSchema),
 ]);
 /**
- * Mutable-by-replacement metadata describing one agent. Features own additional fields; `title`
+ * Mutable-by-replacement metadata describing one agent. Modules own additional fields; `title`
  * is the common human-readable label.
  */
 export const agentMetadataSchema = Type.Intersect([

package/dist/AgentModule.d.ts

@@ -0,0 +1,209 @@
+import type { ProviderModelCompatibilityType, SessionEvent, SessionReasoningEffort, SessionServiceTier, SessionSystemMessage, SessionToolCallBlock, SessionToolResultMessage } from "@slopus/happy-providers";
+import type { Context } from "@steve.kite/stdlib";
+import type { AgentDatabase, AgentDatabaseFacade, AgentModuleMigration } from "./AgentDatabase.js";
+import type { AgentBaseAcceptedMessage, AgentBaseInference, AgentBaseInferenceStart, AgentBaseLoop, AgentBaseModelChange, AgentBasePermissionModeChange, AgentBasePersistedEvent, AgentBaseToolCall, AgentBaseToolCallDecision, AgentBaseToolOutcome, AgentBaseSettlement, AgentBaseTurn, AgentBaseTurnStart, MaybePromise } from "./AgentBaseHooks.js";
+import type { AgentModuleAction } from "./AgentModuleAction.js";
+import type { AgentKV } from "./AgentKV.js";
+import type { AgentMetadata, AgentMetadataChange } from "./AgentMetadata.js";
+import type { AgentPermissionMode } from "./AgentPermissionMode.js";
+import type { AgentSystemRef } from "./AgentSystemRef.js";
+import type { AnyAgentTool } from "./AgentTool.js";
+/**
+ * The agent a hook is serving, in full. One module instance serves every agent in a collection,
+ * so this — rather than anything the module was constructed with — is what tells it whose turn
+ * it is looking at, and what that agent is about to run on.
+ */
+export interface AgentModuleAgent {
+    /** The generated or caller-supplied cuid2 identity, stable for the agent's whole life. */
+    readonly id: string;
+    /** The immutable descriptive metadata currently stored in this agent's configuration. */
+    readonly metadata: AgentMetadata | undefined;
+    /** The registry ID of the provider in force, which one agent may switch between. */
+    readonly provider: string;
+    /**
+     * What kind of provider that ID is registered as — `"claude"`, `"codex"`, and so on. It is
+     * the vendor shape a module has to reason about when a provider ID alone says nothing, and
+     * is absent when the ID is not registered.
+     */
+    readonly providerKind: ProviderModelCompatibilityType | undefined;
+    /** The model in force, absent when none was ever selected. */
+    readonly model: string | undefined;
+    /** The reasoning effort in force, absent when none was ever selected. */
+    readonly effort: SessionReasoningEffort | undefined;
+    /** The service tier in force, absent when none was ever selected. */
+    readonly tier: SessionServiceTier | undefined;
+    /**
+     * How much of the machine the agent may touch. The runtime carries it and makes its changes
+     * durable but enforces nothing, so a module whose tools act on the machine is what decides
+     * what this mode actually permits.
+     */
+    readonly permissionMode: AgentPermissionMode;
+}
+/**
+ * What every hook of a module is handed alongside the context: which agent it is running for,
+ * and the three stores it may write to, each with its own lifetime.
+ *
+ * They are passed rather than read off the context because a module's own dependencies are not
+ * ambient state to be looked up: a hook is given exactly what it is entitled to, and cannot be
+ * handed a context that quietly means a different agent.
+ */
+export interface AgentModuleScope<Database extends AgentDatabase = AgentDatabase> {
+    /** The active Drizzle database or transaction facade for this hook. */
+    readonly database: AgentDatabaseFacade<Database>;
+    /** The agent this hook is running for, and the selection it is running on. */
+    readonly agent: AgentModuleAgent;
+    /**
+     * The module's durable store for this one agent, scoped to `module.<name>`. It belongs to
+     * the agent's conversation: it outlives every run, and it is cleared when the identity is
+     * created again. Renaming a module orphans everything it stored here.
+     */
+    readonly kv: AgentKV;
+    /**
+     * The module's durable store shared by every agent in the collection, and outliving all of
+     * them. Work one agent owes another lives here, since an agent's own store belongs to its
+     * conversation alone.
+     */
+    readonly sharedKV: AgentKV;
+    /**
+     * The module's store for the run in progress, erased in the transaction that settles the
+     * agent. It is where a module keeps what only makes sense while the agent is working, so a
+     * crash mid-run leaves notes a resumed run can read, and a finished run leaves none at all.
+     */
+    readonly runKV: AgentKV;
+}
+/** Immutable agent identity and metadata observed at a system lifecycle boundary. */
+export interface AgentModuleAgentLifecycle {
+    readonly id: string;
+    readonly metadata: AgentMetadata | undefined;
+}
+/** System-owned capabilities handed to module lifecycle observers. */
+export interface AgentModuleSystemScope<Database extends AgentDatabase = AgentDatabase> {
+    readonly database: AgentDatabaseFacade<Database>;
+    readonly agents: AgentSystemRef<Database>;
+    readonly sharedKV: AgentKV;
+}
+/**
+ * One independent capability of an `Agent`: a module implements any subset of the agent hooks,
+ * and the agent merges every module's implementations into the singular hooks its internal
+ * `AgentBase` runs with. The hook contracts are the same as `AgentBaseHooks`; see there for
+ * when each hook fires and what its return value means.
+ *
+ * Agent-scoped hooks receive the agent's context first and their `AgentModuleScope<Database>` second.
+ * System start hooks instead receive the system context and its deadlock-safe `AgentSystemRef`.
+ */
+export interface AgentModule<Tool extends AnyAgentTool = AnyAgentTool, Database extends AgentDatabase = AgentDatabase> {
+    /**
+     * A stable identifier for the module. Its persisted key-value entries live under this
+     * name, so renaming a module orphans everything it stored.
+     */
+    readonly name: string;
+    /**
+     * Ordered durable migrations owned by this module. Keys are immutable identities and may
+     * only be appended; each function and its success marker commit atomically before beforeStart.
+     */
+    readonly migrations?: readonly AgentModuleMigration<Database>[];
+    /**
+     * The first hook a module receives. Called once after the owning AgentSystem acquires its
+     * store lock and before any agent is restored or started. Every module initializes
+     * concurrently, and agent work begins only after all of them settle successfully.
+     */
+    readonly beforeStart?: (ctx: Context, agents: AgentSystemRef<Database>, database: Database) => MaybePromise<void>;
+    /**
+     * Called once after every durable-active agent has been restored and started. Every module
+     * runs concurrently, and system creation resolves only after all of them settle successfully.
+     */
+    readonly afterStart?: (ctx: Context, agents: AgentSystemRef<Database>, database: Database) => MaybePromise<void>;
+    readonly agentCreatedTransact?: (ctx: Context, scope: AgentModuleSystemScope<Database>, agent: AgentModuleAgentLifecycle) => MaybePromise<void>;
+    readonly agentCreated?: (ctx: Context, scope: AgentModuleSystemScope<Database>, agent: AgentModuleAgentLifecycle) => MaybePromise<void>;
+    readonly agentRestoredTransact?: (ctx: Context, scope: AgentModuleSystemScope<Database>, agent: AgentModuleAgentLifecycle) => MaybePromise<void>;
+    readonly agentRestored?: (ctx: Context, scope: AgentModuleSystemScope<Database>, agent: AgentModuleAgentLifecycle) => MaybePromise<void>;
+    readonly agentArchivedTransact?: (ctx: Context, scope: AgentModuleSystemScope<Database>, agent: AgentModuleAgentLifecycle) => MaybePromise<void>;
+    readonly agentArchived?: (ctx: Context, scope: AgentModuleSystemScope<Database>, agent: AgentModuleAgentLifecycle) => MaybePromise<void>;
+    /** Observes every session event; the run awaits it and contains its failure. */
+    readonly onEvent?: (ctx: Context, scope: AgentModuleScope<Database>, event: SessionEvent) => MaybePromise<unknown>;
+    /** Runs inside the transaction committing a completed assistant block. */
+    readonly onEventTransact?: (ctx: Context, scope: AgentModuleScope<Database>, event: AgentBasePersistedEvent) => MaybePromise<void>;
+    /** Merged after the base state and every earlier module's instructions, in module order. */
+    readonly instructions?: (ctx: Context, scope: AgentModuleScope<Database>) => MaybePromise<string>;
+    /** Merged after the base state and every earlier module's tools, in module order. */
+    readonly tools?: (ctx: Context, scope: AgentModuleScope<Database>) => MaybePromise<readonly Tool[]>;
+    /**
+     * Runs inside the transaction that makes a dispatched batch durable, once per call in it.
+     * Modules run in array order and a failure propagates, rolling the dispatch back.
+     */
+    readonly beforeToolCallTransact?: (ctx: Context, scope: AgentModuleScope<Database>, call: SessionToolCallBlock) => MaybePromise<void>;
+    /**
+     * Decides what to do with one validated call before it runs. Modules are asked in array
+     * order: what one of them amends is what the next one sees, and the first to answer the model
+     * settles the call and ends the chain.
+     */
+    readonly beforeToolCall?: (ctx: Context, scope: AgentModuleScope<Database>, call: AgentBaseToolCall) => MaybePromise<AgentBaseToolCallDecision | undefined>;
+    /** Observes what one call produced, before its result is committed. */
+    readonly afterToolCall?: (ctx: Context, scope: AgentModuleScope<Database>, outcome: AgentBaseToolOutcome) => MaybePromise<void>;
+    /**
+     * Runs inside the transaction appending one tool result to the durable conversation. Modules
+     * run in array order and a failure propagates, rolling that commit back.
+     */
+    readonly afterToolCallTransact?: (ctx: Context, scope: AgentModuleScope<Database>, result: SessionToolResultMessage) => MaybePromise<void>;
+    /** The first module that returns a handoff message wins the reset injection. */
+    readonly modelChanged?: (ctx: Context, scope: AgentModuleScope<Database>, change: AgentBaseModelChange) => MaybePromise<SessionSystemMessage | undefined>;
+    /**
+     * Runs inside the transaction appending a queued message to the durable conversation, once per
+     * message. Modules run in array order and a failure propagates, rolling the consumption back.
+     */
+    readonly messageAcceptedTransact?: (ctx: Context, scope: AgentModuleScope<Database>, accepted: AgentBaseAcceptedMessage) => MaybePromise<void>;
+    /** Observes the same messages once the consumption has committed. */
+    readonly messageAccepted?: (ctx: Context, scope: AgentModuleScope<Database>, accepted: AgentBaseAcceptedMessage) => MaybePromise<void>;
+    /** Transactional counterpart to `permissionModeChanged`; a failure rolls the change back. */
+    readonly permissionModeChangedTransact?: (ctx: Context, scope: AgentModuleScope<Database>, change: AgentBasePermissionModeChange) => MaybePromise<void>;
+    /** Observes a permission-mode change a consumed message made, once it is durable. */
+    readonly permissionModeChanged?: (ctx: Context, scope: AgentModuleScope<Database>, change: AgentBasePermissionModeChange) => MaybePromise<void>;
+    /** Transactional counterpart to `metadataChanged`; a failure rolls the merge back. */
+    readonly metadataChangedTransact?: (ctx: Context, scope: AgentModuleScope<Database>, change: AgentMetadataChange) => MaybePromise<void>;
+    /** Observes the complete merged agent metadata after it commits. */
+    readonly metadataChanged?: (ctx: Context, scope: AgentModuleScope<Database>, change: AgentMetadataChange) => MaybePromise<void>;
+    /** Transactional counterpart to `beforeAgentLoop`. */
+    readonly beforeAgentLoopTransact?: (ctx: Context, scope: AgentModuleScope<Database>, loop: AgentBaseLoop) => MaybePromise<void>;
+    /** Called when the loop leaves the settled state and begins working. */
+    readonly beforeAgentLoop?: (ctx: Context, scope: AgentModuleScope<Database>, loop: AgentBaseLoop) => MaybePromise<void>;
+    /** Transactional counterpart to `beforeTurn`. */
+    readonly beforeTurnTransact?: (ctx: Context, scope: AgentModuleScope<Database>, turn: AgentBaseTurnStart) => MaybePromise<void>;
+    /**
+     * Receives the measured size of the context the turn is about to run on. Actions from every
+     * module are concatenated and applied before the turn's first inference.
+     */
+    readonly beforeTurn?: (ctx: Context, scope: AgentModuleScope<Database>, turn: AgentBaseTurnStart) => MaybePromise<readonly AgentModuleAction[] | undefined>;
+    /** Transactional counterpart to `beforeInference`. */
+    readonly beforeInferenceTransact?: (ctx: Context, scope: AgentModuleScope<Database>, inference: AgentBaseInferenceStart) => MaybePromise<void>;
+    /** Called immediately before each inference request. */
+    readonly beforeInference?: (ctx: Context, scope: AgentModuleScope<Database>, inference: AgentBaseInferenceStart) => MaybePromise<void>;
+    /** Transactional counterpart to `afterInference`. */
+    readonly afterInferenceTransact?: (ctx: Context, scope: AgentModuleScope<Database>, inference: AgentBaseInference) => MaybePromise<void>;
+    /** Receives how the response ended and the token counts the provider measured for it. */
+    readonly afterInference?: (ctx: Context, scope: AgentModuleScope<Database>, inference: AgentBaseInference) => MaybePromise<void>;
+    /** Transactional counterpart to `afterTurn`. */
+    readonly afterTurnTransact?: (ctx: Context, scope: AgentModuleScope<Database>, turn: AgentBaseTurn) => MaybePromise<void>;
+    /**
+     * Receives the token counts the turn's last measured response reported. Actions from every
+     * module are concatenated and applied together.
+     */
+    readonly afterTurn?: (ctx: Context, scope: AgentModuleScope<Database>, turn: AgentBaseTurn) => MaybePromise<readonly AgentModuleAction[] | undefined>;
+    /** Transactional counterpart to `afterAgentLoop`. */
+    readonly afterAgentLoopTransact?: (ctx: Context, scope: AgentModuleScope<Database>, loop: AgentBaseLoop) => MaybePromise<void>;
+    /** Actions from every module are concatenated and applied together. */
+    readonly afterAgentLoop?: (ctx: Context, scope: AgentModuleScope<Database>, loop: AgentBaseLoop) => MaybePromise<readonly AgentModuleAction[] | undefined>;
+    /**
+     * Called inside the transaction that records the agent as settled. The module's stores write
+     * into that transaction, so what a module concludes about the run and the fact that the run
+     * is over become durable together. The `Transact` suffix is what marks a hook as running
+     * inside a transaction. The run store is erased by that same transaction, so this is the last
+     * chance to keep any part of what the run wrote about itself.
+     *
+     * Unlike the observing hooks, a failure here is not contained: it rolls the settlement back
+     * along with everything every module wrote, and the agent stays recorded as working.
+     */
+    readonly afterAgentSettledTransact?: (ctx: Context, scope: AgentModuleScope<Database>, settlement: AgentBaseSettlement) => MaybePromise<void>;
+    /** Called once after the loop has fully settled and no module reopened it. */
+    readonly afterAgentSettled?: (ctx: Context, scope: AgentModuleScope<Database>, settlement: AgentBaseSettlement) => MaybePromise<void>;
+}
+//# sourceMappingURL=AgentModule.d.ts.map

package/dist/AgentModule.d.ts.map

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

package/dist/AgentModule.js

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

package/dist/AgentModule.js.map

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

package/dist/{AgentFeatureAction.d.ts → AgentModuleAction.d.ts}

@@ -5,7 +5,7 @@ import type { AgentMessageMetadata } from "./AgentMetadata.js";
  * the ordinary durable queues, or trigger a compaction. An action drives the loop exactly like
  * an external call to `steer`, `send`, or `compact` would.
  */
-export type AgentFeatureAction = {
+export type AgentModuleAction = {
     readonly type: "steer";
     readonly id?: string;
     readonly message: SessionUserMessage;
@@ -18,4 +18,4 @@ export type AgentFeatureAction = {
 } | {
     readonly type: "compact";
 };
-//# sourceMappingURL=AgentFeatureAction.d.ts.map
+//# sourceMappingURL=AgentModuleAction.d.ts.map

package/dist/AgentModuleAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentModuleAction.d.ts","sourceRoot":"","sources":["../sources/AgentModuleAction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GACvB;IACI,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CAC5C,GACD;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CAC5C,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC"}

package/dist/AgentModuleAction.js

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

package/dist/AgentModuleAction.js.map

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

package/dist/AgentPermissionMode.d.ts

@@ -5,7 +5,7 @@ import { type Static } from "@sinclair/typebox";
  * The mode is part of what an agent is running on, exactly like its model: it is carried on every
  * context the agent derives, it is durable, and a message may change it. What the runtime does not
  * do is enforce it — the loop has no idea what any particular tool touches. Enforcement belongs to
- * the features and tools that know, and they read the mode in force from the context they are
+ * the modules and tools that know, and they read the mode in force from the context they are
  * given.
  */
 export declare const agentPermissionModeSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"read_only">, import("@sinclair/typebox").TLiteral<"workspace_write">, import("@sinclair/typebox").TLiteral<"auto">, import("@sinclair/typebox").TLiteral<"full_access">]>;

package/dist/AgentPermissionMode.js

@@ -6,7 +6,7 @@ import { Value } from "@sinclair/typebox/value";
  * The mode is part of what an agent is running on, exactly like its model: it is carried on every
  * context the agent derives, it is durable, and a message may change it. What the runtime does not
  * do is enforce it — the loop has no idea what any particular tool touches. Enforcement belongs to
- * the features and tools that know, and they read the mode in force from the context they are
+ * the modules and tools that know, and they read the mode in force from the context they are
  * given.
  */
 export const agentPermissionModeSchema = Type.Union([

package/dist/AgentPersistence.d.ts

@@ -1,5 +1,6 @@
 import type { SessionAssistantBlock, SessionMessage, SessionSystemMessage, SessionToolResultMessage, SessionUserMessage } from "@slopus/happy-providers";
 import type { Context } from "@steve.kite/stdlib";
+import type { AgentDatabase } from "./AgentDatabase.js";
 import type { AgentMessageMetadata } from "./AgentMetadata.js";
 /**
  * One record of the main context store. Only content that is part of the model context lives
@@ -36,15 +37,17 @@ export type AgentRecord = {
  * ignored database conflict; history replacement removes keys for the records it deletes.
  * Exactly one owner connects to a store, and the agent serializes its own record and bookkeeping
  * writes through one lock, so history order always matches storage order. Key-value operations —
- * a feature's or a tool's — run as they come, so each one has to be atomic on its own, but no
+ * a module's or a tool's — run as they come, so each one has to be atomic on its own, but no
  * implementation ever has to defend against a second owner.
  */
 export interface AgentPersistence {
+    /** The root Drizzle facade for this store. */
+    readonly database: AgentDatabase;
     /**
      * Run work atomically. The implementation opens a transaction and passes work a derived
-     * context that its own operations recognize; how the transaction rides on that context is
-     * entirely the implementation's business. Work resolving commits every operation; a thrown
-     * error rolls them all back.
+     * context that its own operations recognize and that carries stdlib's universal
+     * `afterCommit` scope. Work resolving commits every operation and then drains that scope; a
+     * thrown error rolls everything back without draining it.
      */
     transaction<Result>(ctx: Context, work: (ctx: Context) => Promise<Result>): Promise<Result>;
     /** Every record in the main context store, in append order. */

package/dist/AgentPersistence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentPersistence.d.ts","sourceRoot":"","sources":["../sources/AgentPersistence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,qBAAqB,EACrB,cAAc,EACd,oBAAoB,EACpB,wBAAwB,EACxB,kBAAkB,EACrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,GACjB;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CAC5C,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAA;CAAE,GACjE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CAAA;CAAE,GACrE;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAA;CAAE,GACnE;IACI,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;CAChD,CAAC;AAER;;;;;;;;;;GAUG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5F,+DAA+D;IAC/D,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAAC;IACpD,gEAAgE;IAChE,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD;;;;OAIG;IACH,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,0EAA0E;IAC1E,UAAU,CACN,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,MAAM,GACf,OAAO,CAAC,SAAS;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC,CAAC;IACzE,wEAAwE;IACxE,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE;;;OAGG;IACH,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChF,mDAAmD;IACnD,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD"}
+{"version":3,"file":"AgentPersistence.d.ts","sourceRoot":"","sources":["../sources/AgentPersistence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,qBAAqB,EACrB,cAAc,EACd,oBAAoB,EACpB,wBAAwB,EACxB,kBAAkB,EACrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,GACjB;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CAC5C,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAA;CAAE,GACjE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CAAA;CAAE,GACrE;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAA;CAAE,GACnE;IACI,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;CAChD,CAAC;AAER;;;;;;;;;;GAUG;AACH,MAAM,WAAW,gBAAgB;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5F,+DAA+D;IAC/D,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAAC;IACpD,gEAAgE;IAChE,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD;;;;OAIG;IACH,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,0EAA0E;IAC1E,UAAU,CACN,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,MAAM,GACf,OAAO,CAAC,SAAS;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC,CAAC;IACzE,wEAAwE;IACxE,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE;;;OAGG;IACH,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChF,mDAAmD;IACnD,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD"}

package/dist/AgentPersistenceDrizzle.d.ts

@@ -0,0 +1,29 @@
+import type { Context } from "@steve.kite/stdlib";
+import { type AgentDatabase } from "./AgentDatabase.js";
+import type { AgentPersistence, AgentRecord } from "./AgentPersistence.js";
+/** The database shared by every persistence scope in one AgentStorage. */
+export interface AgentPersistenceDrizzleOptions<Database extends AgentDatabase = AgentDatabase> {
+    readonly database: Database;
+}
+/**
+ * Drizzle-backed records and key-value entries for either the collection root or one agent.
+ * Tables are shared by every instance; `ownerId` is empty for collection state and the cuid2
+ * agent identity for a conversation.
+ */
+export declare class AgentPersistenceDrizzle<Database extends AgentDatabase = AgentDatabase> implements AgentPersistence {
+    #private;
+    constructor(options: AgentPersistenceDrizzleOptions<Database>, ownerId: string);
+    get database(): AgentDatabase;
+    transaction<Result>(ctx: Context, work: (ctx: Context) => Promise<Result>): Promise<Result>;
+    load(ctx: Context): Promise<readonly AgentRecord[]>;
+    append(ctx: Context, record: AgentRecord): Promise<void>;
+    clearRecords(ctx: Context): Promise<void>;
+    readValues(ctx: Context, prefix: string): Promise<readonly {
+        readonly key: string;
+        readonly value: unknown;
+    }[]>;
+    writeValue(ctx: Context, key: string, value: unknown): Promise<void>;
+    writeValueIfAbsent(ctx: Context, key: string, value: unknown): Promise<boolean>;
+    deleteValue(ctx: Context, key: string): Promise<void>;
+}
+//# sourceMappingURL=AgentPersistenceDrizzle.d.ts.map

package/dist/AgentPersistenceDrizzle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentPersistenceDrizzle.d.ts","sourceRoot":"","sources":["../sources/AgentPersistenceDrizzle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAGH,KAAK,aAAa,EAErB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAG3E,0EAA0E;AAC1E,MAAM,WAAW,8BAA8B,CAAC,QAAQ,SAAS,aAAa,GAAG,aAAa;IAC1F,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC/B;AAED;;;;GAIG;AACH,qBAAa,uBAAuB,CAChC,QAAQ,SAAS,aAAa,GAAG,aAAa,CAChD,YAAW,gBAAgB;;IAIzB,YAAY,OAAO,EAAE,8BAA8B,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,MAAM,EAG7E;IAED,IAAI,QAAQ,IAAI,aAAa,CAE5B;IAEK,WAAW,CAAC,MAAM,EACpB,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,GACxC,OAAO,CAAC,MAAM,CAAC,CAEjB;IAEK,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAWxD;IAEK,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAU7D;IAEK,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAO9C;IAEK,UAAU,CACZ,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,MAAM,GACf,OAAO,CAAC,SAAS;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC,CAYvE;IAEK,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAYzE;IAEK,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAapF;IAEK,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ1D;CAgCJ"}

package/dist/AgentPersistenceDrizzle.js

@@ -0,0 +1,112 @@
+import { sql } from "drizzle-orm";
+import { agentDatabaseRows, agentDatabaseRun, } from "./AgentDatabase.js";
+import { agentStorageTransaction, withAgentDatabase } from "./AgentContexts.js";
+import { inTx } from "./inTx.js";
+/**
+ * Drizzle-backed records and key-value entries for either the collection root or one agent.
+ * Tables are shared by every instance; `ownerId` is empty for collection state and the cuid2
+ * agent identity for a conversation.
+ */
+export class AgentPersistenceDrizzle {
+    #options;
+    #ownerId;
+    constructor(options, ownerId) {
+        this.#options = options;
+        this.#ownerId = ownerId;
+    }
+    get database() {
+        return this.#options.database;
+    }
+    async transaction(ctx, work) {
+        return await inTx(this.#bound(ctx), work);
+    }
+    async load(ctx) {
+        return await this.#operation(ctx, async (database) => {
+            const rows = await agentDatabaseRows(database, sql `SELECT record_json
+                    FROM happy_agent_records
+                    WHERE owner_id = ${this.#ownerId}
+                    ORDER BY position`);
+            return rows.map(({ record_json }) => JSON.parse(record_json));
+        });
+    }
+    async append(ctx, record) {
+        await this.#operation(ctx, async (database) => {
+            await agentDatabaseRun(database, sql `INSERT INTO happy_agent_records (owner_id, position, record_json)
+                    SELECT ${this.#ownerId}, COALESCE(MAX(position), -1) + 1, ${JSON.stringify(record)}
+                    FROM happy_agent_records
+                    WHERE owner_id = ${this.#ownerId}`);
+        });
+    }
+    async clearRecords(ctx) {
+        await this.#operation(ctx, async (database) => {
+            await agentDatabaseRun(database, sql `DELETE FROM happy_agent_records WHERE owner_id = ${this.#ownerId}`);
+        });
+    }
+    async readValues(ctx, prefix) {
+        return await this.#operation(ctx, async (database) => {
+            const rows = await agentDatabaseRows(database, sql `SELECT key, value_json
+                    FROM happy_agent_values
+                    WHERE owner_id = ${this.#ownerId}
+                      AND substr(key, 1, length(${prefix})) = ${prefix}
+                    ORDER BY key`);
+            return rows.map(({ key, value_json }) => ({ key, value: JSON.parse(value_json) }));
+        });
+    }
+    async writeValue(ctx, key, value) {
+        const encoded = JSON.stringify(value);
+        if (encoded === undefined)
+            throw new Error("Agent storage cannot persist undefined.");
+        await this.#operation(ctx, async (database) => {
+            await agentDatabaseRun(database, sql `INSERT INTO happy_agent_values (owner_id, key, value_json)
+                    VALUES (${this.#ownerId}, ${key}, ${encoded})
+                    ON CONFLICT (owner_id, key)
+                    DO UPDATE SET value_json = EXCLUDED.value_json`);
+        });
+    }
+    async writeValueIfAbsent(ctx, key, value) {
+        const encoded = JSON.stringify(value);
+        if (encoded === undefined)
+            throw new Error("Agent storage cannot persist undefined.");
+        return await this.#operation(ctx, async (database) => {
+            const rows = await agentDatabaseRows(database, sql `INSERT INTO happy_agent_values (owner_id, key, value_json)
+                    VALUES (${this.#ownerId}, ${key}, ${encoded})
+                    ON CONFLICT (owner_id, key) DO NOTHING
+                    RETURNING key`);
+            return rows.length > 0;
+        });
+    }
+    async deleteValue(ctx, key) {
+        await this.#operation(ctx, async (database) => {
+            await agentDatabaseRun(database, sql `DELETE FROM happy_agent_values
+                    WHERE owner_id = ${this.#ownerId} AND key = ${key}`);
+        });
+    }
+    async #operation(ctx, work) {
+        const transaction = agentStorageTransaction(ctx);
+        if (transaction !== undefined) {
+            if (transaction.lifetime.aborted) {
+                throw new Error("The agent storage transaction carried by this context has ended.");
+            }
+            if (transaction.root !== this.#options.database) {
+                throw new Error("A transaction context cannot be used with another agent storage.");
+            }
+            return await work(transaction.database);
+        }
+        return await inTx(withAgentDatabase(ctx, this.#options.database), async (txCtx) => {
+            return await work(txCtx.db);
+        });
+    }
+    #bound(ctx) {
+        const transaction = agentStorageTransaction(ctx);
+        if (transaction === undefined)
+            return withAgentDatabase(ctx, this.#options.database);
+        if (transaction.lifetime.aborted) {
+            throw new Error("The agent storage transaction carried by this context has ended.");
+        }
+        if (transaction.root !== this.#options.database) {
+            throw new Error("A transaction context cannot be used with another agent storage.");
+        }
+        return ctx;
+    }
+}
+//# sourceMappingURL=AgentPersistenceDrizzle.js.map

package/dist/AgentPersistenceDrizzle.js.map

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