@slopus/happy-agent-base 0.0.6 → 0.0.8

package/dist/AgentTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"AgentTool.js","sourceRoot":"","sources":["../sources/AgentTool.ts"],"names":[],"mappings":"AA0FA,qEAAqE;AACrE,MAAM,UAAU,eAAe,CAC3B,IAA6B;IAE7B,OAAO,IAAI,CAAC;AAChB,CAAC"}
+{"version":3,"file":"AgentTool.js","sourceRoot":"","sources":["../sources/AgentTool.ts"],"names":[],"mappings":"AAkHA,qEAAqE;AACrE,MAAM,UAAU,eAAe,CAC3B,IAA6B;IAE7B,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/inTx.d.ts

@@ -0,0 +1,17 @@
+import { type Context } from "@steve.kite/stdlib";
+/** Work whose database operations should share one outer Agent Storage transaction. */
+export type AgentTransactionWork<Result> = (ctx: Context) => Result | PromiseLike<Result>;
+declare global {
+    namespace stdlib {
+        interface ContextExtensions {
+            readonly inTx: <Result>(work: AgentTransactionWork<Result>) => Promise<Awaited<Result>>;
+        }
+    }
+}
+/**
+ * Run work inside the database transaction carried by `ctx`, or open the one outer transaction
+ * for its root database. Nested calls reuse the current transaction; transaction concurrency
+ * belongs to the Drizzle database and its driver.
+ */
+export declare function inTx<Result>(ctx: Context, work: AgentTransactionWork<Result>): Promise<Awaited<Result>>;
+//# sourceMappingURL=inTx.d.ts.map

package/dist/inTx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inTx.d.ts","sourceRoot":"","sources":["../sources/inTx.ts"],"names":[],"mappings":"AAEA,OAAO,EAA6C,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAU7F,uFAAuF;AACvF,MAAM,MAAM,oBAAoB,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;AAE1F,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,MAAM,CAAC;QACb,UAAU,iBAAiB;YACvB,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;SAC3F;KACJ;CACJ;AAWD;;;;GAIG;AACH,wBAAsB,IAAI,CAAC,MAAM,EAC7B,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,GACnC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAgD1B"}

package/dist/inTx.js

@@ -0,0 +1,65 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import { registerContextExtension, withAfterCommit } from "@steve.kite/stdlib";
+import { isAgentSQLiteDatabase } from "./AgentDatabase.js";
+import { agentDatabase, agentStorageTransaction, withAgentStorageTransaction, } from "./AgentContexts.js";
+const activeTransactions = new AsyncLocalStorage();
+registerContextExtension("inTx", (ctx) => async (work) => await inTx(ctx, work));
+/**
+ * Run work inside the database transaction carried by `ctx`, or open the one outer transaction
+ * for its root database. Nested calls reuse the current transaction; transaction concurrency
+ * belongs to the Drizzle database and its driver.
+ */
+export async function inTx(ctx, work) {
+    const carried = agentStorageTransaction(ctx);
+    const ambient = activeTransactions.getStore();
+    if (ambient !== undefined && !ambient.lifetime.aborted) {
+        if (carried === ambient)
+            return await work(ctx);
+        throw new Error("Work started inside an agent storage transaction must use that transaction's context.");
+    }
+    if (carried !== undefined) {
+        if (carried.lifetime.aborted) {
+            throw new Error("The agent storage transaction carried by this context has ended.");
+        }
+        return await work(ctx);
+    }
+    const root = agentDatabase(ctx);
+    if (root === undefined) {
+        throw new Error("Context has no agent database.");
+    }
+    const commit = async (transactionCtx) => {
+        let runAfterCommit;
+        const result = await runDrizzleTransaction(root, async (database) => {
+            const [afterCommitCtx, drain] = withAfterCommit(transactionCtx);
+            runAfterCommit = drain;
+            const lifetime = new AbortController();
+            const state = {
+                database,
+                root,
+                lifetime: lifetime.signal,
+            };
+            const txCtx = withAgentStorageTransaction(afterCommitCtx, state);
+            try {
+                return await activeTransactions.run(state, async () => await work(txCtx));
+            }
+            finally {
+                lifetime.abort();
+            }
+        });
+        try {
+            await runAfterCommit();
+        }
+        catch (error) {
+            transactionCtx.log.warn("Agent storage committed, but post-commit work failed.", error);
+        }
+        return result;
+    };
+    return await commit(ctx);
+}
+async function runDrizzleTransaction(database, work) {
+    if (isAgentSQLiteDatabase(database)) {
+        return await database.transaction(async (transaction) => await work(transaction));
+    }
+    return await database.transaction(async (transaction) => await work(transaction));
+}
+//# sourceMappingURL=inTx.js.map

package/dist/inTx.js.map

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

package/dist/index.d.ts

@@ -6,22 +6,25 @@ export { AgentSystemLocal, type AgentSystemLocalOptions } from "./AgentSystemLoc
 export { AgentSystemRef } from "./AgentSystemRef.js";
 export { AgentRef } from "./AgentRef.js";
 export { agentSystem, withAgentSystem } from "./AgentSystemContext.js";
-export { agentConfig, agentConfigSchema, agentFeatureConfig, agentMetadata, agentEnvironment, agentEnvironmentSchema, agentFeatureConfigSchema, agentPlatformSchema, currentAgentEnvironment, withAgentConfig, type AgentConfig, type AgentEnvironment, type AgentFeatureConfig, type AgentPlatform, } from "./AgentConfig.js";
+export { agentConfig, agentConfigSchema, agentModuleConfig, agentMetadata, agentEnvironment, agentEnvironmentSchema, agentModuleConfigSchema, agentPlatformSchema, currentAgentEnvironment, withAgentConfig, type AgentConfig, type AgentEnvironment, type AgentModuleConfig, type AgentPlatform, } from "./AgentConfig.js";
 export { agentMessageMetadataSchema, agentMetadataSchema, agentMetadataValueSchema, cuid2Schema, type AgentMessageMetadata, type AgentMetadata, type AgentMetadataChange, type AgentMetadataValue, } from "./AgentMetadata.js";
+export { type AgentMessageAcceptance } from "./AgentMessageAcceptance.js";
 export { AgentStorage, type AgentStorageLock, type AgentStorageOptions } from "./AgentStorage.js";
+export { agentDatabaseRows, agentDatabaseRun, isAgentSQLiteDatabase, type AgentDatabase, type AgentDatabaseFacade, type AgentModuleMigration, type AgentPostgresDatabase, type AgentSQLiteDatabase, type AgentStorageTransaction, } from "./AgentDatabase.js";
 export { type AgentModel } from "./AgentModel.js";
 export { knownModels, type Model } from "./models.js";
 export { AgentBase, type AgentBaseAwaitOptions, type AgentBaseMessageOptions, type AgentBaseOptions, type AgentBaseQueueMode, } from "./AgentBase.js";
-export { agentEffort, agentId, agentKV, agentModel, agentPermissionMode, agentProvider, agentRunKV, agentServiceTier, withAgentContext, withAgentKV, withAgentPermissionMode, withAgentRunKV, } from "./AgentContexts.js";
+export { agentDatabase, agentEffort, agentId, agentKV, agentModel, agentPermissionMode, agentProvider, agentRunKV, agentServiceTier, withAgentContext, withAgentDatabase, withAgentKV, withAgentPermissionMode, withAgentRunKV, } from "./AgentContexts.js";
 export { agentPermissionModeLabel, agentPermissionModeSchema, isAgentPermissionMode, DEFAULT_AGENT_PERMISSION_MODE, type AgentPermissionMode, } from "./AgentPermissionMode.js";
 export { agentTaskContext, taskContextBeforeToolCall, withAgentTaskContext, } from "./AgentTaskContext.js";
+export { inTx, type AgentTransactionWork } from "./inTx.js";
 export { AgentKV } from "./AgentKV.js";
-export { type AgentBaseAcceptedMessage, type AgentBaseHooks, type AgentBaseInference, type AgentBaseModelChange, type AgentBasePermissionModeChange, type AgentBasePersistedEvent, type AgentBaseToolCall, type AgentBaseToolCallDecision, type AgentBaseToolOutcome, type AgentBaseTurn, type AgentBaseTurnStart, type MaybePromise, } from "./AgentBaseHooks.js";
+export { type AgentBaseAcceptedMessage, type AgentBaseHooks, type AgentBaseInference, type AgentBaseInferenceStart, type AgentBaseLoop, type AgentBaseModelChange, type AgentBasePermissionModeChange, type AgentBasePersistedEvent, type AgentBaseSettlement, type AgentBaseToolCall, type AgentBaseToolCallDecision, type AgentBaseToolOutcome, type AgentBaseTurn, type AgentBaseTurnStart, type MaybePromise, } from "./AgentBaseHooks.js";
 export { type AgentPersistence, type AgentRecord } from "./AgentPersistence.js";
 export { agentBasePendingStateOf, agentBaseStoreOwesWork, AGENT_BASE_PENDING_KEY, type AgentBasePendingStage, type AgentBasePendingState, } from "./AgentBasePending.js";
 export { type AgentBaseState } from "./AgentBaseState.js";
-export { type AgentFeature, type AgentFeatureAgent, type AgentFeatureScope, } from "./AgentFeature.js";
-export { type AgentFeatureAction } from "./AgentFeatureAction.js";
+export { type AgentModule, type AgentModuleAgent, type AgentModuleAgentLifecycle, type AgentModuleScope, type AgentModuleSystemScope, } from "./AgentModule.js";
+export { type AgentModuleAction } from "./AgentModuleAction.js";
 export { AgentProviders, type AgentProviderSelection, type AgentProviderSource, } from "./AgentProviders.js";
-export { defineAgentTool, type AgentTool, type AgentToolAutoPermissionActionDescriber, type AgentToolAutoPermissionPredicate, type AnyAgentTool, } from "./AgentTool.js";
+export { defineAgentTool, type AgentTool, type AgentToolCall, type AgentToolAutoPermissionActionDescriber, type AgentToolAutoPermissionPredicate, type AnyAgentTool, } from "./AgentTool.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../sources/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAG5E,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAGvE,OAAO,EACH,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,wBAAwB,EACxB,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,aAAa,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACH,0BAA0B,EAC1B,mBAAmB,EACnB,wBAAwB,EACxB,WAAW,EACX,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGlG,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAGtD,OAAO,EACH,SAAS,EACT,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACH,WAAW,EACX,OAAO,EACP,OAAO,EACP,UAAU,EACV,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,uBAAuB,EACvB,cAAc,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,wBAAwB,EACxB,yBAAyB,EACzB,qBAAqB,EACrB,6BAA6B,EAC7B,KAAK,mBAAmB,GAC3B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACH,gBAAgB,EAChB,yBAAyB,EACzB,oBAAoB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EACH,KAAK,wBAAwB,EAC7B,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,YAAY,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,EACH,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,GAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,EACH,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAGlE,OAAO,EACH,cAAc,EACd,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,GAC3B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACH,eAAe,EACf,KAAK,SAAS,EACd,KAAK,sCAAsC,EAC3C,KAAK,gCAAgC,EACrC,KAAK,YAAY,GACpB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../sources/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAG5E,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAGvE,OAAO,EACH,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,aAAa,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACH,0BAA0B,EAC1B,mBAAmB,EACnB,wBAAwB,EACxB,WAAW,EACX,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAClG,OAAO,EACH,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,GAC/B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAGtD,OAAO,EACH,SAAS,EACT,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACH,aAAa,EACb,WAAW,EACX,OAAO,EACP,OAAO,EACP,UAAU,EACV,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,uBAAuB,EACvB,cAAc,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,wBAAwB,EACxB,yBAAyB,EACzB,qBAAqB,EACrB,6BAA6B,EAC7B,KAAK,mBAAmB,GAC3B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACH,gBAAgB,EAChB,yBAAyB,EACzB,oBAAoB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,IAAI,EAAE,KAAK,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EACH,KAAK,wBAAwB,EAC7B,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,YAAY,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,EACH,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,GAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,EACH,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,GAC9B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGhE,OAAO,EACH,cAAc,EACd,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,GAC3B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACH,eAAe,EACf,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,sCAAsC,EAC3C,KAAK,gCAAgC,EACrC,KAAK,YAAY,GACpB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -8,25 +8,28 @@ export { AgentSystemRef } from "./AgentSystemRef.js";
 export { AgentRef } from "./AgentRef.js";
 export { agentSystem, withAgentSystem } from "./AgentSystemContext.js";
 // Agent configuration: fixed environment/settings, mergeable metadata, and its context carrier.
-export { agentConfig, agentConfigSchema, agentFeatureConfig, agentMetadata, agentEnvironment, agentEnvironmentSchema, agentFeatureConfigSchema, agentPlatformSchema, currentAgentEnvironment, withAgentConfig, } from "./AgentConfig.js";
+export { agentConfig, agentConfigSchema, agentModuleConfig, agentMetadata, agentEnvironment, agentEnvironmentSchema, agentModuleConfigSchema, agentPlatformSchema, currentAgentEnvironment, withAgentConfig, } from "./AgentConfig.js";
 export { agentMessageMetadataSchema, agentMetadataSchema, agentMetadataValueSchema, cuid2Schema, } from "./AgentMetadata.js";
+export {} from "./AgentMessageAcceptance.js";
 export { AgentStorage } from "./AgentStorage.js";
+export { agentDatabaseRows, agentDatabaseRun, isAgentSQLiteDatabase, } from "./AgentDatabase.js";
 // Provider/model routing and the curated model catalog.
 export {} from "./AgentModel.js";
 export { knownModels } from "./models.js";
 // The run loop itself: its context carriers, key-value store, hook contracts, and persistence.
 export { AgentBase, } from "./AgentBase.js";
-export { agentEffort, agentId, agentKV, agentModel, agentPermissionMode, agentProvider, agentRunKV, agentServiceTier, withAgentContext, withAgentKV, withAgentPermissionMode, withAgentRunKV, } from "./AgentContexts.js";
+export { agentDatabase, agentEffort, agentId, agentKV, agentModel, agentPermissionMode, agentProvider, agentRunKV, agentServiceTier, withAgentContext, withAgentDatabase, withAgentKV, withAgentPermissionMode, withAgentRunKV, } from "./AgentContexts.js";
 export { agentPermissionModeLabel, agentPermissionModeSchema, isAgentPermissionMode, DEFAULT_AGENT_PERMISSION_MODE, } from "./AgentPermissionMode.js";
 export { agentTaskContext, taskContextBeforeToolCall, withAgentTaskContext, } from "./AgentTaskContext.js";
+export { inTx } from "./inTx.js";
 export { AgentKV } from "./AgentKV.js";
 export {} from "./AgentBaseHooks.js";
 export {} from "./AgentPersistence.js";
 export { agentBasePendingStateOf, agentBaseStoreOwesWork, AGENT_BASE_PENDING_KEY, } from "./AgentBasePending.js";
 export {} from "./AgentBaseState.js";
-// Features: pluggable capabilities that compose into an agent's hooks, tools, and instructions.
-export {} from "./AgentFeature.js";
-export {} from "./AgentFeatureAction.js";
+// Modules: pluggable capabilities that compose into an agent's hooks, tools, and instructions.
+export {} from "./AgentModule.js";
+export {} from "./AgentModuleAction.js";
 // Registry of provider sources agents resolve their selected models through.
 export { AgentProviders, } from "./AgentProviders.js";
 // Tool definitions.

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../sources/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,8EAA8E;AAC9E,OAAO,EAAE,KAAK,EAAqB,MAAM,YAAY,CAAC;AACtD,OAAO,EAAoB,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAqD,MAAM,kBAAkB,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAgC,MAAM,uBAAuB,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAEvE,gGAAgG;AAChG,OAAO,EACH,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,wBAAwB,EACxB,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,GAKlB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACH,0BAA0B,EAC1B,mBAAmB,EACnB,wBAAwB,EACxB,WAAW,GAKd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAmD,MAAM,mBAAmB,CAAC;AAElG,wDAAwD;AACxD,OAAO,EAAmB,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAc,MAAM,aAAa,CAAC;AAEtD,+FAA+F;AAC/F,OAAO,EACH,SAAS,GAKZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACH,WAAW,EACX,OAAO,EACP,OAAO,EACP,UAAU,EACV,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,uBAAuB,EACvB,cAAc,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,wBAAwB,EACxB,yBAAyB,EACzB,qBAAqB,EACrB,6BAA6B,GAEhC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACH,gBAAgB,EAChB,yBAAyB,EACzB,oBAAoB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAaN,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAA2C,MAAM,uBAAuB,CAAC;AAChF,OAAO,EACH,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,GAGzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAuB,MAAM,qBAAqB,CAAC;AAE1D,gGAAgG;AAChG,OAAO,EAIN,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAA2B,MAAM,yBAAyB,CAAC;AAElE,6EAA6E;AAC7E,OAAO,EACH,cAAc,GAGjB,MAAM,qBAAqB,CAAC;AAE7B,oBAAoB;AACpB,OAAO,EACH,eAAe,GAKlB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../sources/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,8EAA8E;AAC9E,OAAO,EAAE,KAAK,EAAqB,MAAM,YAAY,CAAC;AACtD,OAAO,EAAoB,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAqD,MAAM,kBAAkB,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAgC,MAAM,uBAAuB,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAEvE,gGAAgG;AAChG,OAAO,EACH,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,GAKlB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACH,0BAA0B,EAC1B,mBAAmB,EACnB,wBAAwB,EACxB,WAAW,GAKd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAA+B,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAmD,MAAM,mBAAmB,CAAC;AAClG,OAAO,EACH,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,GAOxB,MAAM,oBAAoB,CAAC;AAE5B,wDAAwD;AACxD,OAAO,EAAmB,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAc,MAAM,aAAa,CAAC;AAEtD,+FAA+F;AAC/F,OAAO,EACH,SAAS,GAKZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACH,aAAa,EACb,WAAW,EACX,OAAO,EACP,OAAO,EACP,UAAU,EACV,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,uBAAuB,EACvB,cAAc,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,wBAAwB,EACxB,yBAAyB,EACzB,qBAAqB,EACrB,6BAA6B,GAEhC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACH,gBAAgB,EAChB,yBAAyB,EACzB,oBAAoB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,IAAI,EAA6B,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAgBN,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAA2C,MAAM,uBAAuB,CAAC;AAChF,OAAO,EACH,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,GAGzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAuB,MAAM,qBAAqB,CAAC;AAE1D,+FAA+F;AAC/F,OAAO,EAMN,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAA0B,MAAM,wBAAwB,CAAC;AAEhE,6EAA6E;AAC7E,OAAO,EACH,cAAc,GAGjB,MAAM,qBAAqB,CAAC;AAE7B,oBAAoB;AACpB,OAAO,EACH,eAAe,GAMlB,MAAM,gBAAgB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slopus/happy-agent-base",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "Durable runtime for Happy agents.",
   "license": "MIT",
   "repository": {
@@ -26,8 +26,9 @@
   "dependencies": {
     "@paralleldrive/cuid2": "^3.3.0",
     "@sinclair/typebox": "^0.34.49",
-    "@slopus/happy-providers": "0.0.7",
-    "@steve.kite/stdlib": "0.0.8"
+    "@slopus/happy-providers": "0.0.8",
+    "@steve.kite/stdlib": "0.0.10",
+    "drizzle-orm": "^0.45.2"
   },
   "devDependencies": {
     "@types/node": "^24.0.10",

package/dist/AgentFeature.d.ts

@@ -1,184 +0,0 @@
-import type { ProviderModelCompatibilityType, SessionEvent, SessionReasoningEffort, SessionServiceTier, SessionSystemMessage, SessionToolCallBlock, SessionToolResultMessage } from "@slopus/happy-providers";
-import type { Context } from "@steve.kite/stdlib";
-import type { AgentBaseAcceptedMessage, AgentBaseInference, AgentBaseModelChange, AgentBasePermissionModeChange, AgentBasePersistedEvent, AgentBaseToolCall, AgentBaseToolCallDecision, AgentBaseToolOutcome, AgentBaseTurn, AgentBaseTurnStart, MaybePromise } from "./AgentBaseHooks.js";
-import type { AgentFeatureAction } from "./AgentFeatureAction.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 feature instance serves every agent in a collection,
- * so this — rather than anything the feature was constructed with — is what tells it whose turn
- * it is looking at, and what that agent is about to run on.
- */
-export interface AgentFeatureAgent {
-    /** 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 feature 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 feature whose tools act on the machine is what decides
-     * what this mode actually permits.
-     */
-    readonly permissionMode: AgentPermissionMode;
-}
-/**
- * What every hook of a feature 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 feature'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 AgentFeatureScope {
-    /** The agent this hook is running for, and the selection it is running on. */
-    readonly agent: AgentFeatureAgent;
-    /**
-     * The feature's durable store for this one agent, scoped to `feature.<name>`. It belongs to
-     * the agent's conversation: it outlives every run, and it is cleared when the identity is
-     * created again. Renaming a feature orphans everything it stored here.
-     */
-    readonly kv: AgentKV;
-    /**
-     * The feature'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 feature's store for the run in progress, erased in the transaction that settles the
-     * agent. It is where a feature 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;
-}
-/**
- * One independent capability of an `Agent`: a feature implements any subset of the agent hooks,
- * and the agent merges every feature'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 `AgentFeatureScope` second.
- * System start hooks instead receive the system context and its deadlock-safe `AgentSystemRef`.
- */
-export interface AgentFeature<Tool extends AnyAgentTool = AnyAgentTool> {
-    /**
-     * A stable identifier for the feature. Its persisted key-value entries live under this
-     * name, so renaming a feature orphans everything it stored.
-     */
-    readonly name: string;
-    /**
-     * The first hook a feature receives. Called once after the owning AgentSystem acquires its
-     * store lock and before any agent is restored or started. Every feature initializes
-     * concurrently, and agent work begins only after all of them settle successfully.
-     */
-    readonly beforeStart?: (ctx: Context, agents: AgentSystemRef) => MaybePromise<void>;
-    /**
-     * Called once after every durable-active agent has been restored and started. Every feature
-     * runs concurrently, and system creation resolves only after all of them settle successfully.
-     */
-    readonly afterStart?: (ctx: Context, agents: AgentSystemRef) => MaybePromise<void>;
-    /** Observes every session event; the run awaits it and contains its failure. */
-    readonly onEvent?: (ctx: Context, scope: AgentFeatureScope, event: SessionEvent) => MaybePromise<unknown>;
-    /** Runs inside the transaction committing a completed assistant block. */
-    readonly onEventTransact?: (ctx: Context, scope: AgentFeatureScope, event: AgentBasePersistedEvent) => MaybePromise<void>;
-    /** Merged after the base state and every earlier feature's instructions, in feature order. */
-    readonly instructions?: (ctx: Context, scope: AgentFeatureScope) => MaybePromise<string>;
-    /** Merged after the base state and every earlier feature's tools, in feature order. */
-    readonly tools?: (ctx: Context, scope: AgentFeatureScope) => MaybePromise<readonly Tool[]>;
-    /**
-     * Runs inside the transaction that makes a dispatched batch durable, once per call in it.
-     * Features run in array order and a failure propagates, rolling the dispatch back.
-     */
-    readonly beforeToolCallTransact?: (ctx: Context, scope: AgentFeatureScope, call: SessionToolCallBlock) => MaybePromise<void>;
-    /**
-     * Decides what to do with one validated call before it runs. Features 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: AgentFeatureScope, call: AgentBaseToolCall) => MaybePromise<AgentBaseToolCallDecision | undefined>;
-    /** Observes what one call produced, before its result is committed. */
-    readonly afterToolCall?: (ctx: Context, scope: AgentFeatureScope, outcome: AgentBaseToolOutcome) => MaybePromise<void>;
-    /**
-     * Runs inside the transaction appending one tool result to the durable conversation. Features
-     * run in array order and a failure propagates, rolling that commit back.
-     */
-    readonly afterToolCallTransact?: (ctx: Context, scope: AgentFeatureScope, result: SessionToolResultMessage) => MaybePromise<void>;
-    /** The first feature that returns a handoff message wins the reset injection. */
-    readonly modelChanged?: (ctx: Context, scope: AgentFeatureScope, change: AgentBaseModelChange) => MaybePromise<SessionSystemMessage | undefined>;
-    /**
-     * Runs inside the transaction appending a queued message to the durable conversation, once per
-     * message. Features run in array order and a failure propagates, rolling the consumption back.
-     */
-    readonly messageAcceptedTransact?: (ctx: Context, scope: AgentFeatureScope, accepted: AgentBaseAcceptedMessage) => MaybePromise<void>;
-    /** Observes the same messages once the consumption has committed. */
-    readonly messageAccepted?: (ctx: Context, scope: AgentFeatureScope, accepted: AgentBaseAcceptedMessage) => MaybePromise<void>;
-    /** Transactional counterpart to `permissionModeChanged`; a failure rolls the change back. */
-    readonly permissionModeChangedTransact?: (ctx: Context, scope: AgentFeatureScope, change: AgentBasePermissionModeChange) => MaybePromise<void>;
-    /** Observes a permission-mode change a consumed message made, once it is durable. */
-    readonly permissionModeChanged?: (ctx: Context, scope: AgentFeatureScope, change: AgentBasePermissionModeChange) => MaybePromise<void>;
-    /** Transactional counterpart to `metadataChanged`; a failure rolls the merge back. */
-    readonly metadataChangedTransact?: (ctx: Context, scope: AgentFeatureScope, change: AgentMetadataChange) => MaybePromise<void>;
-    /** Observes the complete merged agent metadata after it commits. */
-    readonly metadataChanged?: (ctx: Context, scope: AgentFeatureScope, change: AgentMetadataChange) => MaybePromise<void>;
-    /** Transactional counterpart to `beforeAgentLoop`. */
-    readonly beforeAgentLoopTransact?: (ctx: Context, scope: AgentFeatureScope) => MaybePromise<void>;
-    /** Called when the loop leaves the settled state and begins working. */
-    readonly beforeAgentLoop?: (ctx: Context, scope: AgentFeatureScope) => MaybePromise<void>;
-    /** Transactional counterpart to `beforeTurn`. */
-    readonly beforeTurnTransact?: (ctx: Context, scope: AgentFeatureScope, turn: AgentBaseTurnStart) => MaybePromise<void>;
-    /**
-     * Receives the measured size of the context the turn is about to run on. Actions from every
-     * feature are concatenated and applied before the turn's first inference.
-     */
-    readonly beforeTurn?: (ctx: Context, scope: AgentFeatureScope, turn: AgentBaseTurnStart) => MaybePromise<readonly AgentFeatureAction[] | undefined>;
-    /** Transactional counterpart to `beforeInference`. */
-    readonly beforeInferenceTransact?: (ctx: Context, scope: AgentFeatureScope) => MaybePromise<void>;
-    /** Called immediately before each inference request. */
-    readonly beforeInference?: (ctx: Context, scope: AgentFeatureScope) => MaybePromise<void>;
-    /** Transactional counterpart to `afterInference`. */
-    readonly afterInferenceTransact?: (ctx: Context, scope: AgentFeatureScope, inference: AgentBaseInference) => MaybePromise<void>;
-    /** Receives how the response ended and the token counts the provider measured for it. */
-    readonly afterInference?: (ctx: Context, scope: AgentFeatureScope, inference: AgentBaseInference) => MaybePromise<void>;
-    /** Transactional counterpart to `afterTurn`. */
-    readonly afterTurnTransact?: (ctx: Context, scope: AgentFeatureScope, turn: AgentBaseTurn) => MaybePromise<void>;
-    /**
-     * Receives the token counts the turn's last measured response reported. Actions from every
-     * feature are concatenated and applied together.
-     */
-    readonly afterTurn?: (ctx: Context, scope: AgentFeatureScope, turn: AgentBaseTurn) => MaybePromise<readonly AgentFeatureAction[] | undefined>;
-    /** Transactional counterpart to `afterAgentLoop`. */
-    readonly afterAgentLoopTransact?: (ctx: Context, scope: AgentFeatureScope) => MaybePromise<void>;
-    /** Actions from every feature are concatenated and applied together. */
-    readonly afterAgentLoop?: (ctx: Context, scope: AgentFeatureScope) => MaybePromise<readonly AgentFeatureAction[] | undefined>;
-    /**
-     * Called inside the transaction that records the agent as settled. The feature's stores write
-     * into that transaction, so what a feature 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 feature wrote, and the agent stays recorded as working.
-     */
-    readonly afterAgentSettledTransact?: (ctx: Context, scope: AgentFeatureScope) => MaybePromise<void>;
-    /** Called once after the loop has fully settled and no feature reopened it. */
-    readonly afterAgentSettled?: (ctx: Context, scope: AgentFeatureScope) => MaybePromise<void>;
-}
-//# sourceMappingURL=AgentFeature.d.ts.map

package/dist/AgentFeature.d.ts.map

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

package/dist/AgentFeature.js

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

package/dist/AgentFeature.js.map

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

package/dist/AgentFeatureAction.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AgentFeatureAction.d.ts","sourceRoot":"","sources":["../sources/AgentFeatureAction.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,kBAAkB,GACxB;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/AgentFeatureAction.js

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

package/dist/AgentFeatureAction.js.map

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