@slopus/happy-agent-base 0.0.1 → 0.0.3

package/dist/AgentTool.d.ts

@@ -1,6 +1,14 @@
 import type { SessionOutputBlock, SessionToolLarkGrammar } from "@slopus/happy-providers";
 import type { Static, TSchema } from "@sinclair/typebox";
 import type { Context } from "@steve.kite/stdlib";
+/** A tool-owned decision about one invocation while the agent is in Auto mode. */
+export type AgentToolAutoPermissionPredicate<Args> = {
+    bivarianceHack(args: Args, ctx: Context): boolean | Promise<boolean>;
+}["bivarianceHack"];
+/** Human-readable description of the exact action an Auto reviewer is deciding on. */
+export type AgentToolAutoPermissionActionDescriber<Args> = {
+    bivarianceHack(args: Args, ctx: Context): string;
+}["bivarianceHack"];
 /**
  * An executable tool with TypeBox-typed arguments and structured result. The descriptor fields
  * mirror the provider session tool. The agent validates arguments against `parameters` before
@@ -9,7 +17,9 @@ import type { Context } from "@steve.kite/stdlib";
  * becomes an error tool result for the model rather than failing the run.
  */
 export interface AgentTool<Args extends TSchema = TSchema, Result extends TSchema = TSchema> {
+    /** The tool name the model calls. */
     readonly name: string;
+    /** Optional grouping the tool is exposed under, such as an MCP server name. */
     readonly namespace?: string;
     /** Description of the containing namespace, when this tool is namespaced. */
     readonly namespaceDescription?: string;
@@ -21,13 +31,41 @@ export interface AgentTool<Args extends TSchema = TSchema, Result extends TSchem
         readonly type: string;
         readonly [key: string]: unknown;
     };
+    /** Model-facing explanation of what the tool does and when to use it. */
     readonly description?: string;
+    /** TypeBox schema the model's arguments are validated against before execute runs. */
     readonly parameters?: Args;
+    /** TypeBox schema the structured result is validated against after execute runs. */
     readonly returnType: Result;
     /** Provider-neutral request to expose this tool through native tool discovery. */
     readonly defer?: boolean;
     /** Ignored by providers that do not support grammar-based tools. */
     readonly grammar?: SessionToolLarkGrammar;
+    /**
+     * Provider-shaped guidance shown only in Auto mode. Use this for fields the model must set
+     * when it intentionally requests review or Full access.
+     */
+    readonly autoPermissionInstructions?: string;
+    /**
+     * Describes the exact action and boundary an Auto reviewer is deciding on. A tool whose
+     * `shouldReviewInAutoMode` can return true must provide this description.
+     */
+    readonly describeAutoPermissionAction?: AgentToolAutoPermissionActionDescriber<Static<Args>>;
+    /**
+     * The tool cannot be contained by Rig's local restricted modes, so it is available only in
+     * Auto or Full access. This does not itself approve an Auto invocation.
+     */
+    readonly requiresAutoOrFullAccess?: boolean;
+    /**
+     * Whether this exact invocation requires an Auto review. Every tool owns this decision;
+     * routine tools state that explicitly with a predicate that returns false.
+     */
+    readonly shouldReviewInAutoMode: AgentToolAutoPermissionPredicate<Static<Args>>;
+    /**
+     * Whether an approved invocation must temporarily run in Full access. Review and elevation
+     * are deliberately separate decisions; omission means the current sandbox remains active.
+     */
+    readonly shouldRunInFullAccessInAutoMode?: AgentToolAutoPermissionPredicate<Static<Args>>;
     /**
      * A durable tool is safe to execute again, so an interrupted call is retried when the agent
      * restarts. A non-durable call interrupted by a restart becomes an error tool result instead.
@@ -38,7 +76,9 @@ export interface AgentTool<Args extends TSchema = TSchema, Result extends TSchem
      * observe cancellation and stop its own work.
      */
     execute(ctx: Context, args: Static<Args>): Promise<Static<Result>>;
+    /** Renders a validated result into the content blocks the model actually sees. */
     toLLM(result: Static<Result>): readonly SessionOutputBlock[];
+    /** Whether a structured result should be reported to the model as an error. */
     isError?(result: Static<Result>): boolean;
 }
 export type AnyAgentTool = AgentTool<any, any>;

package/dist/AgentTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentTool.d.ts","sourceRoot":"","sources":["../sources/AgentTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,kBAAkB,EAClB,sBAAsB,EACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,WAAW,SAAS,CACtB,IAAI,SAAS,OAAO,GAAG,OAAO,EAC9B,MAAM,SAAS,OAAO,GAAG,OAAO;IAEhC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,6EAA6E;IAC7E,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAC7E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,kFAAkF;IAClF,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,oEAAoE;IACpE,QAAQ,CAAC,OAAO,CAAC,EAAE,sBAAsB,CAAC;IAC1C;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACnE,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,SAAS,kBAAkB,EAAE,CAAC;IAC7D,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC;CAC7C;AAMD,MAAM,MAAM,YAAY,GAAG,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAE/C,qEAAqE;AACrE,wBAAgB,eAAe,CAC3B,KAAK,CAAC,IAAI,SAAS,OAAO,EAC1B,KAAK,CAAC,MAAM,SAAS,OAAO,EAC9B,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAExD"}
+{"version":3,"file":"AgentTool.d.ts","sourceRoot":"","sources":["../sources/AgentTool.ts"],"names":[],"mappings":"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"}

package/dist/AgentTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"AgentTool.js","sourceRoot":"","sources":["../sources/AgentTool.ts"],"names":[],"mappings":"AAsDA,qEAAqE;AACrE,MAAM,UAAU,eAAe,CAG7B,IAA6B;IAC3B,OAAO,IAAI,CAAC;AAChB,CAAC"}
+{"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"}

package/dist/index.d.ts

@@ -1,11 +1,25 @@
+/** Public surface of `@slopus/happy-agent-base`, re-exported by concern. */
 export { Agent, type AgentOptions } from "./Agent.js";
-export { AgentBase, type AgentBaseMessageOptions, type AgentBaseOptions, type AgentBaseQueueMode, } from "./AgentBase.js";
-export { agentBaseEffort, agentBaseModel, agentBaseProvider, agentBaseServiceTier, withAgentBaseContext, } from "./AgentBaseContext.js";
-export { type AgentBaseHooks, type AgentBaseModelChange } from "./AgentBaseHooks.js";
-export { type AgentBasePersistence, type AgentBaseRecord, } from "./AgentBasePersistence.js";
+export { type AgentSystem } from "./AgentSystem.js";
+export { type AgentInitialContext } from "./AgentSystem.js";
+export { AgentSystemLocal, type AgentSystemLocalOptions } from "./AgentSystemLocal.js";
+export { AgentSystemRef } from "./AgentSystemRef.js";
+export { AgentRef } from "./AgentRef.js";
+export { agentSystem, withAgentSystem } from "./AgentSystemContext.js";
+export { agentConfig, agentConfigSchema, agentFeatureConfig, agentEnvironment, agentEnvironmentSchema, agentFeatureConfigSchema, agentPlatformSchema, currentAgentEnvironment, withAgentConfig, type AgentConfig, type AgentEnvironment, type AgentFeatureConfig, type AgentPlatform, } from "./AgentConfig.js";
+export { AgentStorage, type AgentStorageLock, type AgentStorageOptions } from "./AgentStorage.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, agentProvider, agentRunKV, agentServiceTier, withAgentContext, withAgentKV, withAgentRunKV, } from "./AgentContexts.js";
+export { agentTaskContext, taskContextBeforeToolCall, withAgentTaskContext, } from "./AgentTaskContext.js";
+export { AgentKV } from "./AgentKV.js";
+export { type AgentBaseHooks, type AgentBaseInference, type AgentBaseModelChange, type AgentBaseToolExecution, 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 } from "./AgentFeature.js";
+export { type AgentFeature, type AgentFeatureAgent, type AgentFeatureScope, } from "./AgentFeature.js";
 export { type AgentFeatureAction } from "./AgentFeatureAction.js";
-export { AgentProviders } from "./AgentProviders.js";
-export { defineAgentTool, type AgentTool, type AnyAgentTool, } from "./AgentTool.js";
+export { AgentProviders, type AgentProviderSelection, type AgentProviderSource, } from "./AgentProviders.js";
+export { defineAgentTool, type AgentTool, 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,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EACH,SAAS,EACT,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACH,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EACH,KAAK,oBAAoB,EACzB,KAAK,eAAe,GACvB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EACH,eAAe,EACf,KAAK,SAAS,EACd,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,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,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,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,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,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,cAAc,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,gBAAgB,EAChB,yBAAyB,EACzB,oBAAoB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EACH,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,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"}

package/dist/index.js

@@ -1,11 +1,32 @@
+/** Public surface of `@slopus/happy-agent-base`, re-exported by concern. */
+// Agent instances and the collection that creates, resolves, and stores them.
 export { Agent } from "./Agent.js";
+export {} from "./AgentSystem.js";
+export {} from "./AgentSystem.js";
+export { AgentSystemLocal } from "./AgentSystemLocal.js";
+export { AgentSystemRef } from "./AgentSystemRef.js";
+export { AgentRef } from "./AgentRef.js";
+export { agentSystem, withAgentSystem } from "./AgentSystemContext.js";
+// Static agent configuration: environment, per-feature settings, and their context carrier.
+export { agentConfig, agentConfigSchema, agentFeatureConfig, agentEnvironment, agentEnvironmentSchema, agentFeatureConfigSchema, agentPlatformSchema, currentAgentEnvironment, withAgentConfig, } from "./AgentConfig.js";
+export { AgentStorage } from "./AgentStorage.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 { agentBaseEffort, agentBaseModel, agentBaseProvider, agentBaseServiceTier, withAgentBaseContext, } from "./AgentBaseContext.js";
+export { agentEffort, agentId, agentKV, agentModel, agentProvider, agentRunKV, agentServiceTier, withAgentContext, withAgentKV, withAgentRunKV, } from "./AgentContexts.js";
+export { agentTaskContext, taskContextBeforeToolCall, withAgentTaskContext, } from "./AgentTaskContext.js";
+export { AgentKV } from "./AgentKV.js";
 export {} from "./AgentBaseHooks.js";
-export {} from "./AgentBasePersistence.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";
-export { AgentProviders } from "./AgentProviders.js";
+// Registry of provider sources agents resolve their selected models through.
+export { AgentProviders, } from "./AgentProviders.js";
+// Tool definitions.
 export { defineAgentTool, } from "./AgentTool.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../sources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAqB,MAAM,YAAY,CAAC;AACtD,OAAO,EACH,SAAS,GAIZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACH,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAkD,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAGN,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAuB,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAqB,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAA2B,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EACH,eAAe,GAGlB,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,EAA4B,MAAM,kBAAkB,CAAC;AAC5D,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,4FAA4F;AAC5F,OAAO,EACH,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,wBAAwB,EACxB,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,GAKlB,MAAM,kBAAkB,CAAC;AAC1B,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,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,cAAc,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,gBAAgB,EAChB,yBAAyB,EACzB,oBAAoB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAQN,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"}

package/dist/models.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Curated model catalog for rig defaults.
+ *
+ * Order matches the Conductor model picker.
+ */
+/** Model metadata exposed by a provider. */
+export interface Model<TThinkingLevel extends string = string> {
+    /** The model identifier as the provider knows it. */
+    id: string;
+    /** Human-readable label shown in the model picker. */
+    name: string;
+    /** Thinking levels this model accepts, in picker order. */
+    thinkingLevels: readonly TThinkingLevel[];
+    /** The thinking level used when nothing more specific was requested. */
+    defaultThinkingLevel: TThinkingLevel;
+    /** Maximum input context accepted by the model. */
+    contextWindow?: number;
+    /** Smaller effective window used to decide when automatic compaction begins. */
+    autoCompactWindow?: number;
+}
+/** Anthropic's Fable 5, full effort ladder over a 1M-token context. */
+export declare const modelAnthropicFable5: Model<"high" | "low" | "max" | "medium" | "off" | "ultra" | "xhigh">;
+/** Anthropic's Opus 5, full effort ladder over a 1M-token context. */
+export declare const modelAnthropicOpus5: Model<"high" | "low" | "max" | "medium" | "off" | "ultra" | "xhigh">;
+/** Anthropic's Opus 4.8, full effort ladder over a 1M-token context. */
+export declare const modelAnthropicOpus48: Model<"high" | "low" | "max" | "medium" | "off" | "ultra" | "xhigh">;
+/** Anthropic's Opus 4.7, full effort ladder over a 1M-token context. */
+export declare const modelAnthropicOpus47: Model<"high" | "low" | "max" | "medium" | "off" | "ultra" | "xhigh">;
+/** Anthropic's Opus 4.6, a 1M-token context but without the xhigh/ultra effort levels. */
+export declare const modelAnthropicOpus46: Model<"high" | "low" | "max" | "medium" | "off">;
+/** Anthropic's Sonnet 5, full effort ladder over a 1M-token context. */
+export declare const modelAnthropicSonnet5: Model<"high" | "low" | "max" | "medium" | "off" | "ultra" | "xhigh">;
+/** Anthropic's Sonnet 4.6, 1M-token context variant without the xhigh/ultra effort levels. */
+export declare const modelAnthropicSonnet461m: Model<"high" | "low" | "max" | "medium" | "off">;
+/** Anthropic's Sonnet 4.6, the non-1M variant with the smaller default context window. */
+export declare const modelAnthropicSonnet46: Model<"high" | "low" | "max" | "medium" | "off">;
+/** Anthropic's Haiku 4.5, which has no thinking levels beyond off. */
+export declare const modelAnthropicHaiku45: Model<"off">;
+/** OpenAI's GPT-5.5, including the minimal effort level below low. */
+export declare const modelOpenaiGpt55: Model<"high" | "low" | "medium" | "minimal" | "off" | "xhigh">;
+/** OpenAI's GPT-5.6 Sol, full effort ladder up to ultra. */
+export declare const modelOpenaiGpt56Sol: Model<"high" | "low" | "max" | "medium" | "off" | "ultra" | "xhigh">;
+/** OpenAI's GPT-5.6 Terra, full effort ladder up to ultra. */
+export declare const modelOpenaiGpt56Terra: Model<"high" | "low" | "max" | "medium" | "off" | "ultra" | "xhigh">;
+/** OpenAI's GPT-5.6 Luna, full effort ladder up to max but without ultra. */
+export declare const modelOpenaiGpt56Luna: Model<"high" | "low" | "max" | "medium" | "off" | "xhigh">;
+/** OpenAI's GPT-5.4, including the minimal effort level below low. */
+export declare const modelOpenaiGpt54: Model<"high" | "low" | "medium" | "minimal" | "off" | "xhigh">;
+/**
+ * Reviews one proposed action for Auto permissions. It never appears in the model picker and is
+ * never used for ordinary inference, so it is deliberately absent from the profile catalog.
+ */
+export declare const modelOpenaiCodexAutoReview: Model<"high" | "low" | "medium" | "xhigh">;
+/** xAI's Grok Build, which only ever runs at its single "on" thinking level. */
+export declare const modelXaiGrokBuild: Model<"on">;
+/** xAI's Grok 4.5. */
+export declare const modelXaiGrok45: Model<"high" | "low" | "medium">;
+/** xAI's Composer 2.5, which has no thinking levels beyond off. */
+export declare const modelXaiGrokComposer25Fast: Model<"off">;
+/** Every model definition in the catalog, in picker order. */
+export declare const knownModels: readonly Model[];
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../sources/models.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,4CAA4C;AAC5C,MAAM,WAAW,KAAK,CAAC,cAAc,SAAS,MAAM,GAAG,MAAM;IACzD,qDAAqD;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,cAAc,EAAE,SAAS,cAAc,EAAE,CAAC;IAC1C,wEAAwE;IACxE,oBAAoB,EAAE,cAAc,CAAC;IACrC,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAcD,uEAAuE;AACvE,eAAO,MAAM,oBAAoB,sEAO/B,CAAC;AAEH,sEAAsE;AACtE,eAAO,MAAM,mBAAmB,sEAO9B,CAAC;AAEH,wEAAwE;AACxE,eAAO,MAAM,oBAAoB,sEAO/B,CAAC;AAEH,wEAAwE;AACxE,eAAO,MAAM,oBAAoB,sEAO/B,CAAC;AAEH,0FAA0F;AAC1F,eAAO,MAAM,oBAAoB,kDAO/B,CAAC;AAEH,wEAAwE;AACxE,eAAO,MAAM,qBAAqB,sEAOhC,CAAC;AAEH,8FAA8F;AAC9F,eAAO,MAAM,wBAAwB,kDAOnC,CAAC;AAEH,0FAA0F;AAC1F,eAAO,MAAM,sBAAsB,kDAMjC,CAAC;AAEH,sEAAsE;AACtE,eAAO,MAAM,qBAAqB,cAMhC,CAAC;AAEH,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,gEAM3B,CAAC;AAEH,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB,sEAM9B,CAAC;AAEH,8DAA8D;AAC9D,eAAO,MAAM,qBAAqB,sEAMhC,CAAC;AAEH,6EAA6E;AAC7E,eAAO,MAAM,oBAAoB,4DAM/B,CAAC;AAEH,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,gEAM3B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,0BAA0B,4CAMrC,CAAC;AAEH,gFAAgF;AAChF,eAAO,MAAM,iBAAiB,aAM5B,CAAC;AAEH,sBAAsB;AACtB,eAAO,MAAM,cAAc,kCAMzB,CAAC;AAEH,mEAAmE;AACnE,eAAO,MAAM,0BAA0B,cAMrC,CAAC;AAEH,8DAA8D;AAC9D,eAAO,MAAM,WAAW,EAAE,SAAS,KAAK,EAmBvC,CAAC"}

package/dist/models.js

@@ -0,0 +1,185 @@
+/**
+ * Curated model catalog for rig defaults.
+ *
+ * Order matches the Conductor model picker.
+ */
+/** Statically typed helper for constructing a model definition. */
+function defineModel(model) {
+    return model;
+}
+/** Anthropic's Fable 5, full effort ladder over a 1M-token context. */
+export const modelAnthropicFable5 = defineModel({
+    id: "anthropic/fable-5",
+    name: "Fable 5",
+    thinkingLevels: ["off", "low", "medium", "high", "xhigh", "max", "ultra"],
+    defaultThinkingLevel: "medium",
+    contextWindow: 1_000_000,
+    autoCompactWindow: 333_000,
+});
+/** Anthropic's Opus 5, full effort ladder over a 1M-token context. */
+export const modelAnthropicOpus5 = defineModel({
+    id: "anthropic/opus-5",
+    name: "Opus 5 1M",
+    thinkingLevels: ["off", "low", "medium", "high", "xhigh", "max", "ultra"],
+    defaultThinkingLevel: "medium",
+    contextWindow: 1_000_000,
+    autoCompactWindow: 333_000,
+});
+/** Anthropic's Opus 4.8, full effort ladder over a 1M-token context. */
+export const modelAnthropicOpus48 = defineModel({
+    id: "anthropic/opus-4-8",
+    name: "Opus 4.8 1M",
+    thinkingLevels: ["off", "low", "medium", "high", "xhigh", "max", "ultra"],
+    defaultThinkingLevel: "medium",
+    contextWindow: 1_000_000,
+    autoCompactWindow: 333_000,
+});
+/** Anthropic's Opus 4.7, full effort ladder over a 1M-token context. */
+export const modelAnthropicOpus47 = defineModel({
+    id: "anthropic/opus-4-7",
+    name: "Opus 4.7 1M",
+    thinkingLevels: ["off", "low", "medium", "high", "xhigh", "max", "ultra"],
+    defaultThinkingLevel: "medium",
+    contextWindow: 1_000_000,
+    autoCompactWindow: 333_000,
+});
+/** Anthropic's Opus 4.6, a 1M-token context but without the xhigh/ultra effort levels. */
+export const modelAnthropicOpus46 = defineModel({
+    id: "anthropic/opus-4-6",
+    name: "Opus 4.6 1M",
+    thinkingLevels: ["off", "low", "medium", "high", "max"],
+    defaultThinkingLevel: "medium",
+    contextWindow: 1_000_000,
+    autoCompactWindow: 333_000,
+});
+/** Anthropic's Sonnet 5, full effort ladder over a 1M-token context. */
+export const modelAnthropicSonnet5 = defineModel({
+    id: "anthropic/sonnet-5",
+    name: "Sonnet 5",
+    thinkingLevels: ["off", "low", "medium", "high", "xhigh", "max", "ultra"],
+    defaultThinkingLevel: "medium",
+    contextWindow: 1_000_000,
+    autoCompactWindow: 333_000,
+});
+/** Anthropic's Sonnet 4.6, 1M-token context variant without the xhigh/ultra effort levels. */
+export const modelAnthropicSonnet461m = defineModel({
+    id: "anthropic/sonnet-4-6-1m",
+    name: "Sonnet 4.6 1M",
+    thinkingLevels: ["off", "low", "medium", "high", "max"],
+    defaultThinkingLevel: "medium",
+    contextWindow: 1_000_000,
+    autoCompactWindow: 333_000,
+});
+/** Anthropic's Sonnet 4.6, the non-1M variant with the smaller default context window. */
+export const modelAnthropicSonnet46 = defineModel({
+    id: "anthropic/sonnet-4-6",
+    name: "Sonnet 4.6",
+    thinkingLevels: ["off", "low", "medium", "high", "max"],
+    defaultThinkingLevel: "medium",
+    contextWindow: 200_000,
+});
+/** Anthropic's Haiku 4.5, which has no thinking levels beyond off. */
+export const modelAnthropicHaiku45 = defineModel({
+    id: "anthropic/haiku-4-5",
+    name: "Haiku 4.5",
+    thinkingLevels: ["off"],
+    defaultThinkingLevel: "off",
+    contextWindow: 200_000,
+});
+/** OpenAI's GPT-5.5, including the minimal effort level below low. */
+export const modelOpenaiGpt55 = defineModel({
+    id: "openai/gpt-5.5",
+    name: "GPT-5.5",
+    thinkingLevels: ["off", "minimal", "low", "medium", "high", "xhigh"],
+    defaultThinkingLevel: "medium",
+    contextWindow: 272_000,
+});
+/** OpenAI's GPT-5.6 Sol, full effort ladder up to ultra. */
+export const modelOpenaiGpt56Sol = defineModel({
+    id: "openai/gpt-5.6-sol",
+    name: "GPT-5.6 Sol",
+    thinkingLevels: ["off", "low", "medium", "high", "xhigh", "max", "ultra"],
+    defaultThinkingLevel: "medium",
+    contextWindow: 372_000,
+});
+/** OpenAI's GPT-5.6 Terra, full effort ladder up to ultra. */
+export const modelOpenaiGpt56Terra = defineModel({
+    id: "openai/gpt-5.6-terra",
+    name: "GPT-5.6 Terra",
+    thinkingLevels: ["off", "low", "medium", "high", "xhigh", "max", "ultra"],
+    defaultThinkingLevel: "medium",
+    contextWindow: 372_000,
+});
+/** OpenAI's GPT-5.6 Luna, full effort ladder up to max but without ultra. */
+export const modelOpenaiGpt56Luna = defineModel({
+    id: "openai/gpt-5.6-luna",
+    name: "GPT-5.6 Luna",
+    thinkingLevels: ["off", "low", "medium", "high", "xhigh", "max"],
+    defaultThinkingLevel: "medium",
+    contextWindow: 372_000,
+});
+/** OpenAI's GPT-5.4, including the minimal effort level below low. */
+export const modelOpenaiGpt54 = defineModel({
+    id: "openai/gpt-5.4",
+    name: "GPT-5.4",
+    thinkingLevels: ["off", "minimal", "low", "medium", "high", "xhigh"],
+    defaultThinkingLevel: "medium",
+    contextWindow: 272_000,
+});
+/**
+ * Reviews one proposed action for Auto permissions. It never appears in the model picker and is
+ * never used for ordinary inference, so it is deliberately absent from the profile catalog.
+ */
+export const modelOpenaiCodexAutoReview = defineModel({
+    id: "openai/codex-auto-review",
+    name: "Codex Auto Review",
+    thinkingLevels: ["low", "medium", "high", "xhigh"],
+    defaultThinkingLevel: "low",
+    contextWindow: 272_000,
+});
+/** xAI's Grok Build, which only ever runs at its single "on" thinking level. */
+export const modelXaiGrokBuild = defineModel({
+    id: "xai/grok-build",
+    name: "Grok Build",
+    thinkingLevels: ["on"],
+    defaultThinkingLevel: "on",
+    contextWindow: 500_000,
+});
+/** xAI's Grok 4.5. */
+export const modelXaiGrok45 = defineModel({
+    id: "xai/grok-4.5",
+    name: "Grok 4.5",
+    thinkingLevels: ["low", "medium", "high"],
+    defaultThinkingLevel: "high",
+    contextWindow: 500_000,
+});
+/** xAI's Composer 2.5, which has no thinking levels beyond off. */
+export const modelXaiGrokComposer25Fast = defineModel({
+    id: "xai/grok-composer-2.5-fast",
+    name: "Composer 2.5",
+    thinkingLevels: ["off"],
+    defaultThinkingLevel: "off",
+    contextWindow: 200_000,
+});
+/** Every model definition in the catalog, in picker order. */
+export const knownModels = [
+    modelAnthropicFable5,
+    modelAnthropicOpus5,
+    modelAnthropicOpus48,
+    modelAnthropicOpus47,
+    modelAnthropicOpus46,
+    modelAnthropicSonnet5,
+    modelAnthropicSonnet461m,
+    modelAnthropicSonnet46,
+    modelAnthropicHaiku45,
+    modelOpenaiGpt55,
+    modelOpenaiGpt56Sol,
+    modelOpenaiGpt56Terra,
+    modelOpenaiGpt56Luna,
+    modelOpenaiGpt54,
+    modelOpenaiCodexAutoReview,
+    modelXaiGrokBuild,
+    modelXaiGrok45,
+    modelXaiGrokComposer25Fast,
+];
+//# sourceMappingURL=models.js.map

package/dist/models.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@slopus/happy-agent-base",
-  "version": "0.0.1",
-  "description": "Shared foundations for Happy coding agents.",
+  "version": "0.0.3",
+  "description": "Durable runtime for Happy agents.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -24,8 +24,9 @@
     "access": "public"
   },
   "dependencies": {
+    "@paralleldrive/cuid2": "^3.3.0",
     "@sinclair/typebox": "^0.34.49",
-    "@slopus/happy-providers": "0.0.5",
+    "@slopus/happy-providers": "0.0.7",
     "@steve.kite/stdlib": "0.0.8"
   },
   "devDependencies": {
@@ -39,6 +40,7 @@
   "scripts": {
     "build": "node --eval \"import('node:fs/promises').then(({ rm }) => rm('dist', { force: true, recursive: true }))\" && tsc -p tsconfig.build.json",
     "check": "tsc --noEmit",
-    "test": "vitest run --passWithNoTests"
+    "test": "vitest run --passWithNoTests",
+    "test:real": "RIG_LIVE_TEST=1 vitest run tests/real-gym"
   }
 }

package/dist/AgentBaseContext.d.ts

@@ -1,22 +0,0 @@
-import type { SessionReasoningEffort, SessionServiceTier } from "@slopus/happy-providers";
-import { type Context } from "@steve.kite/stdlib";
-/**
- * Derive the agent's context carrying its provider ID, model, effort, and service tier — all serializable
- * values. The agent applies this once at construction, so hooks and tool executions can read
- * the values back through the accessors below.
- */
-export declare function withAgentBaseContext(ctx: Context, values: {
-    readonly provider: string;
-    readonly model?: string | undefined;
-    readonly effort?: SessionReasoningEffort | undefined;
-    readonly serviceTier?: SessionServiceTier | undefined;
-}): Context;
-/** The model configured for the agent owning this context, when one was set. */
-export declare function agentBaseModel(ctx: Context): string | undefined;
-/** The reasoning effort configured for the agent owning this context, when one was set. */
-export declare function agentBaseEffort(ctx: Context): SessionReasoningEffort | undefined;
-/** The registry ID of the provider of the agent owning this context. */
-export declare function agentBaseProvider(ctx: Context): string | undefined;
-/** The service tier configured for the agent owning this context, when one was set. */
-export declare function agentBaseServiceTier(ctx: Context): SessionServiceTier | undefined;
-//# sourceMappingURL=AgentBaseContext.d.ts.map

package/dist/AgentBaseContext.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AgentBaseContext.d.ts","sourceRoot":"","sources":["../sources/AgentBaseContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC1F,OAAO,EAA0B,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAmB1E;;;;GAIG;AACH,wBAAgB,oBAAoB,CAChC,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE;IACJ,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;CACzD,GACF,OAAO,CAKT;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAE/D;AAED,2FAA2F;AAC3F,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,sBAAsB,GAAG,SAAS,CAEhF;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAElE;AAED,uFAAuF;AACvF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,CAEjF"}

package/dist/AgentBaseContext.js

@@ -1,33 +0,0 @@
-import { createContextNamespace } from "@steve.kite/stdlib";
-const modelNamespace = createContextNamespace("agentBaseModel", undefined);
-const effortNamespace = createContextNamespace("agentBaseEffort", undefined);
-const providerNamespace = createContextNamespace("agentBaseProvider", undefined);
-const serviceTierNamespace = createContextNamespace("agentBaseServiceTier", undefined);
-/**
- * Derive the agent's context carrying its provider ID, model, effort, and service tier — all serializable
- * values. The agent applies this once at construction, so hooks and tool executions can read
- * the values back through the accessors below.
- */
-export function withAgentBaseContext(ctx, values) {
-    const withProvider = providerNamespace.set(ctx, values.provider);
-    const withModel = modelNamespace.set(withProvider, values.model);
-    const withEffort = effortNamespace.set(withModel, values.effort);
-    return serviceTierNamespace.set(withEffort, values.serviceTier);
-}
-/** The model configured for the agent owning this context, when one was set. */
-export function agentBaseModel(ctx) {
-    return modelNamespace.get(ctx);
-}
-/** The reasoning effort configured for the agent owning this context, when one was set. */
-export function agentBaseEffort(ctx) {
-    return effortNamespace.get(ctx);
-}
-/** The registry ID of the provider of the agent owning this context. */
-export function agentBaseProvider(ctx) {
-    return providerNamespace.get(ctx);
-}
-/** The service tier configured for the agent owning this context, when one was set. */
-export function agentBaseServiceTier(ctx) {
-    return serviceTierNamespace.get(ctx);
-}
-//# sourceMappingURL=AgentBaseContext.js.map

package/dist/AgentBaseContext.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"AgentBaseContext.js","sourceRoot":"","sources":["../sources/AgentBaseContext.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAgB,MAAM,oBAAoB,CAAC;AAE1E,MAAM,cAAc,GAAG,sBAAsB,CACzC,gBAAgB,EAChB,SAAS,CACZ,CAAC;AACF,MAAM,eAAe,GAAG,sBAAsB,CAC1C,iBAAiB,EACjB,SAAS,CACZ,CAAC;AACF,MAAM,iBAAiB,GAAG,sBAAsB,CAC5C,mBAAmB,EACnB,SAAS,CACZ,CAAC;AACF,MAAM,oBAAoB,GAAG,sBAAsB,CAC/C,sBAAsB,EACtB,SAAS,CACZ,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAChC,GAAY,EACZ,MAKC;IAED,MAAM,YAAY,GAAG,iBAAiB,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IACjE,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IACjE,MAAM,UAAU,GAAG,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACjE,OAAO,oBAAoB,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;AACpE,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,cAAc,CAAC,GAAY;IACvC,OAAO,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,eAAe,CAAC,GAAY;IACxC,OAAO,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACpC,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,iBAAiB,CAAC,GAAY;IAC1C,OAAO,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,oBAAoB,CAAC,GAAY;IAC7C,OAAO,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACzC,CAAC"}

package/dist/AgentBasePersistence.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AgentBasePersistence.d.ts","sourceRoot":"","sources":["../sources/AgentBasePersistence.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;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GACrB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAA;CAAE,GAC/D;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;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAA;CAAE,CAAC;AAEpF;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACjC;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EACd,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,GACxC,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAAC;IACxD,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D;;;;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,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD"}

package/dist/AgentBasePersistence.js

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

package/dist/AgentBasePersistence.js.map

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