@slopus/happy-agent-base 0.0.5 → 0.0.7

package/dist/AgentKV.js

@@ -1,35 +1,39 @@
-import { withLifetime } from "@steve.kite/stdlib";
-/**
- * Refuse a store operation whose context has already ended. What a holder of a store may do is
- * decided by the context it is given rather than by the object: a store used inside a transaction,
- * or handed to a tool for the length of its turn, keeps working exactly as long as that work
- * does. Using it afterwards is a mistake in the caller, and says so instead of quietly writing
- * into a transaction that has committed or a turn that was cancelled.
- */
-function assertLive(ctx) {
-    if (ctx.lifetime?.aborted === true) {
-        throw new Error("The store cannot be used: the work its context belongs to has ended.");
-    }
-}
+import { asyncLock, withLifetime } from "@steve.kite/stdlib";
 /**
  * A key-value store scoped under one prefix of the agent's sorted store. The agent carries a
- * session-scoped instance on its context, and narrows it for each caller: a feature works
+ * session-scoped instance on its context, and narrows it for each caller: a module works
  * under its own name, a tool execution under its call ID. Keys are always relative to the
  * scope — a holder can neither see nor touch anything outside it. Segments join with `.`.
  *
- * The object is nothing but a scope: every operation runs on the context it is given, so which
- * transaction a write joins and how long the handle stays usable are both decided by that
- * context and never by the handle.
+ * Every operation runs on the context it is given, so that context decides which transaction a
+ * write joins. Most handles also take their lifetime from that context; explicitly bounded
+ * handles, such as a tool call's KV, additionally become unusable when their owner ends.
  */
 export class AgentKV {
     /** The absolute key prefix of this scope, ending with the separator. */
     prefix;
     /** The append-only store this scope reads and writes through. */
     #persistence;
+    /** An object-owned lifetime used by bounded stores such as one tool invocation's KV. */
+    #available;
+    /** Serializes this scope tree so disposal always follows every write that already started. */
+    #lock;
     /** Build a scope over `prefix` of `persistence`. */
-    constructor(persistence, prefix) {
+    constructor(persistence, prefix, available = () => true, lock) {
         this.#persistence = persistence;
         this.prefix = prefix;
+        this.#available = available;
+        this.#lock = lock;
+    }
+    /**
+     * A handle to this scope whose operations serialize with all descendants derived from it.
+     * Agent base uses this only for one tool call, so disposal can drain writes already in flight
+     * without serializing unrelated module and agent stores.
+     *
+     * @internal
+     */
+    serialized() {
+        return new AgentKV(this.#persistence, this.prefix, this.#available, asyncLock({ reentry: "block" }));
     }
     /**
      * A narrower store under `segments` within this scope. Each segment is exactly one level:
@@ -39,25 +43,39 @@ export class AgentKV {
      */
     scoped(...segments) {
         const escaped = segments.map((segment) => segment.replaceAll("%", "%25").replaceAll(".", "%2E"));
-        return new AgentKV(this.#persistence, `${this.prefix}${escaped.join(".")}.`);
+        return new AgentKV(this.#persistence, `${this.prefix}${escaped.join(".")}.`, this.#available, this.#lock);
+    }
+    /**
+     * A handle to this exact scope that becomes permanently unusable when `signal` aborts.
+     * Narrower scopes inherit the same bound. Agent base uses this for call KV so no context can
+     * recreate invocation state after the winning result erases it.
+     */
+    until(signal, available = () => true) {
+        return new AgentKV(this.#persistence, this.prefix, () => this.#available() && !signal.aborted && available(), this.#lock);
     }
     /** The stored value, or undefined when the key is absent. */
     async read(ctx, key) {
-        assertLive(ctx);
-        const full = `${this.prefix}${key}`;
-        const entries = await this.#persistence.readValues(ctx, full);
-        return entries.find((entry) => entry.key === full)?.value;
+        return await this.#locked(ctx, async (lockCtx) => {
+            const full = `${this.prefix}${key}`;
+            const entries = await this.#persistence.readValues(lockCtx, full);
+            return entries.find((entry) => entry.key === full)?.value;
+        });
     }
     /** Every entry under the scope — or under `prefix` within it — with scope-relative keys. */
     async list(ctx, prefix = "") {
-        assertLive(ctx);
-        const entries = await this.#persistence.readValues(ctx, `${this.prefix}${prefix}`);
-        return entries.map(({ key, value }) => ({ key: key.slice(this.prefix.length), value }));
+        return await this.#locked(ctx, async (lockCtx) => {
+            const entries = await this.#persistence.readValues(lockCtx, `${this.prefix}${prefix}`);
+            return entries.map(({ key, value }) => ({
+                key: key.slice(this.prefix.length),
+                value,
+            }));
+        });
     }
     /** Store the value under `key`, replacing whatever was there before. */
     async write(ctx, key, value) {
-        assertLive(ctx);
-        await this.#persistence.writeValue(ctx, `${this.prefix}${key}`, value);
+        await this.#locked(ctx, async (lockCtx) => {
+            await this.#persistence.writeValue(lockCtx, `${this.prefix}${key}`, value);
+        });
     }
     /**
      * Read, decide, and write, so the value the updater sees is exactly the value it replaces.
@@ -65,13 +83,39 @@ export class AgentKV {
      * updater that throws leaves the stored value untouched.
      */
     async update(ctx, key, updater) {
-        assertLive(ctx);
-        const full = `${this.prefix}${key}`;
-        const entries = await this.#persistence.readValues(ctx, full);
-        const current = entries.find((entry) => entry.key === full)?.value;
-        const next = await updater(current);
-        await this.#persistence.writeValue(ctx, full, next);
-        return next;
+        return await this.#locked(ctx, async (lockCtx) => {
+            const full = `${this.prefix}${key}`;
+            const entries = await this.#persistence.readValues(lockCtx, full);
+            const current = entries.find((entry) => entry.key === full)?.value;
+            const next = await updater(current);
+            await this.#persistence.writeValue(lockCtx, full, next);
+            return next;
+        });
+    }
+    /**
+     * Return the durable value already stored under `key`, or create and store it exactly once.
+     * The read and possible write share one persistence transaction, and an existing outer
+     * transaction is reused. A tool can use this on its call-bound KV for retry-stable operation
+     * identities without coupling them to a provider call ID.
+     */
+    async getOrCreate(ctx, key, create) {
+        return await this.#locked(ctx, async (lockCtx) => {
+            return await this.#persistence.transaction(lockCtx, async (txCtx) => {
+                const full = `${this.prefix}${key}`;
+                const entries = await this.#persistence.readValues(txCtx, full);
+                const existing = entries.find((entry) => entry.key === full);
+                if (existing !== undefined)
+                    return existing.value;
+                const value = await create();
+                if (await this.#persistence.writeValueIfAbsent(txCtx, full, value))
+                    return value;
+                const winner = (await this.#persistence.readValues(txCtx, full)).find((entry) => entry.key === full);
+                if (winner === undefined) {
+                    throw new Error("The durable get-or-create value disappeared before it was read.");
+                }
+                return winner.value;
+            });
+        });
     }
     /**
      * Run work as one atomic step of the underlying store: everything it writes commits together,
@@ -80,7 +124,7 @@ export class AgentKV {
      * cannot be written into after it has committed.
      */
     async transaction(ctx, work) {
-        assertLive(ctx);
+        this.#assertLive(ctx);
         return await this.#persistence.transaction(ctx, async (txCtx) => {
             const committed = new AbortController();
             const liveCtx = withLifetime(txCtx, committed.signal);
@@ -99,16 +143,39 @@ export class AgentKV {
      * write.
      */
     async clear(ctx) {
-        assertLive(ctx);
-        const entries = await this.#persistence.readValues(ctx, this.prefix);
-        for (const entry of entries) {
-            await this.#persistence.deleteValue(ctx, entry.key);
-        }
+        await this.#locked(ctx, async (lockCtx) => {
+            const entries = await this.#persistence.readValues(lockCtx, this.prefix);
+            for (const entry of entries) {
+                await this.#persistence.deleteValue(lockCtx, entry.key);
+            }
+        });
     }
     /** Remove the entry stored under `key`, if any. */
     async delete(ctx, key) {
-        assertLive(ctx);
-        await this.#persistence.deleteValue(ctx, `${this.prefix}${key}`);
+        await this.#locked(ctx, async (lockCtx) => {
+            await this.#persistence.deleteValue(lockCtx, `${this.prefix}${key}`);
+        });
+    }
+    /** Re-check availability only after every earlier operation in this scope tree has finished. */
+    async #locked(ctx, work) {
+        if (this.#lock === undefined) {
+            this.#assertLive(ctx);
+            return await work(ctx);
+        }
+        return await this.#lock.runInLock(ctx, async (lockCtx) => {
+            this.#assertLive(lockCtx);
+            return await work(lockCtx);
+        });
+    }
+    /**
+     * Refuse a store operation when either its caller-owned context or this bounded handle has
+     * ended. The latter is what makes call KV stay erased even if retained code supplies a fresh
+     * unrelated context after commit.
+     */
+    #assertLive(ctx) {
+        if (ctx.lifetime?.aborted === true || !this.#available()) {
+            throw new Error("The store cannot be used: the work its context belongs to has ended.");
+        }
     }
 }
 //# sourceMappingURL=AgentKV.js.map

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":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAgC,MAAM,oBAAoB,CAAC;AAI3F;;;;;;;;;GASG;AACH,MAAM,OAAO,OAAO;IAChB,wEAAwE;IAC/D,MAAM,CAAS;IAExB,iEAAiE;IACxD,YAAY,CAAmB;IACxC,wFAAwF;IAC/E,UAAU,CAAgB;IACnC,8FAA8F;IACrF,KAAK,CAAwB;IAEtC,oDAAoD;IACpD,YACI,WAA6B,EAC7B,MAAc,EACd,SAAS,GAAG,GAAG,EAAE,CAAC,IAAI,EACtB,IAAgB;QAEhB,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACtB,CAAC;IAED;;;;;;OAMG;IACH,UAAU;QACN,OAAO,IAAI,OAAO,CACd,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,UAAU,EACf,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAClC,CAAC;IACN,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,GAAG,QAA2B;QACjC,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACrC,OAAO,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CACxD,CAAC;QACF,OAAO,IAAI,OAAO,CACd,IAAI,CAAC,YAAY,EACjB,GAAG,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EACrC,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,KAAK,CACb,CAAC;IACN,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAmB,EAAE,SAAS,GAAG,GAAG,EAAE,CAAC,IAAI;QAC7C,OAAO,IAAI,OAAO,CACd,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,MAAM,EACX,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,SAAS,EAAE,EACzD,IAAI,CAAC,KAAK,CACb,CAAC;IACN,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,IAAI,CAAC,GAAY,EAAE,GAAW;QAChC,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YAC7C,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YACpC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAClE,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,KAAK,IAAI,CAAC,EAAE,KAAK,CAAC;QAC9D,CAAC,CAAC,CAAC;IACP,CAAC;IAED,4FAA4F;IAC5F,KAAK,CAAC,IAAI,CACN,GAAY,EACZ,MAAM,GAAG,EAAE;QAEX,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YAC7C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;YACvF,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;gBACpC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;gBAClC,KAAK;aACR,CAAC,CAAC,CAAC;QACR,CAAC,CAAC,CAAC;IACP,CAAC;IAED,wEAAwE;IACxE,KAAK,CAAC,KAAK,CAAC,GAAY,EAAE,GAAW,EAAE,KAAc;QACjD,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACtC,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;QAC/E,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CACR,GAAY,EACZ,GAAW,EACX,OAAqD;QAErD,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YAC7C,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YACpC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAClE,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,KAAK,IAAI,CAAC,EAAE,KAAK,CAAC;YACnE,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;YACpC,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YACxD,OAAO,IAAI,CAAC;QAChB,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,WAAW,CACb,GAAY,EACZ,GAAW,EACX,MAAoC;QAEpC,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YAC7C,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBAChE,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;gBACpC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;gBAChE,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC;gBAC7D,IAAI,QAAQ,KAAK,SAAS;oBAAE,OAAO,QAAQ,CAAC,KAAc,CAAC;gBAC3D,MAAM,KAAK,GAAG,MAAM,MAAM,EAAE,CAAC;gBAC7B,IAAI,MAAM,IAAI,CAAC,YAAY,CAAC,kBAAkB,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC;oBAAE,OAAO,KAAK,CAAC;gBACjF,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CACjE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,KAAK,IAAI,CAChC,CAAC;gBACF,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;oBACvB,MAAM,IAAI,KAAK,CACX,iEAAiE,CACpE,CAAC;gBACN,CAAC;gBACD,OAAO,MAAM,CAAC,KAAc,CAAC;YACjC,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,WAAW,CACb,GAAY,EACZ,IAAsD;QAEtD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACtB,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YAC5D,MAAM,SAAS,GAAG,IAAI,eAAe,EAAE,CAAC;YACxC,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;YACtD,IAAI,CAAC;gBACD,OAAO,MAAM,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACrC,CAAC;oBAAS,CAAC;gBACP,SAAS,CAAC,KAAK,EAAE,CAAC;YACtB,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAK,CAAC,GAAY;QACpB,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACtC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACzE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC1B,MAAM,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;YAC5D,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;IAED,mDAAmD;IACnD,KAAK,CAAC,MAAM,CAAC,GAAY,EAAE,GAAW;QAClC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACtC,MAAM,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC,CAAC;QACzE,CAAC,CAAC,CAAC;IACP,CAAC;IAED,gGAAgG;IAChG,KAAK,CAAC,OAAO,CAAS,GAAY,EAAE,IAAuC;QACvE,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YACtB,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACrD,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAC1B,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;OAIG;IACH,WAAW,CAAC,GAAY;QACpB,IAAI,GAAG,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;YACvD,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;QAC5F,CAAC;IACL,CAAC;CACJ"}

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

@@ -0,0 +1,37 @@
+import { type Static } from "@sinclair/typebox";
+/** A cuid2 identity: two to thirty-two lowercase alphanumeric characters, opening with a letter. */
+export declare const cuid2Schema: import("@sinclair/typebox").TString;
+/** JSON values metadata may contain, so every metadata object is safe to persist and clone. */
+export declare const agentMetadataValueSchema: import("@sinclair/typebox").TRecursive<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TBoolean, import("@sinclair/typebox").TNull, import("@sinclair/typebox").TArray<import("@sinclair/typebox").TThis>, import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TThis>]>>;
+/** The TypeScript type inferred from {@link agentMetadataValueSchema}. */
+export type AgentMetadataValue = Static<typeof agentMetadataValueSchema>;
+/**
+ * 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>;
+}>, import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TRecursive<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TBoolean, import("@sinclair/typebox").TNull, import("@sinclair/typebox").TArray<import("@sinclair/typebox").TThis>, import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TThis>]>>>]>;
+/** The TypeScript type inferred from {@link agentMessageMetadataSchema}. */
+export type AgentMessageMetadata = Static<typeof agentMessageMetadataSchema>;
+/**
+ * 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<{
+    title: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>, import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TRecursive<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TBoolean, import("@sinclair/typebox").TNull, import("@sinclair/typebox").TArray<import("@sinclair/typebox").TThis>, import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TThis>]>>>]>;
+/** The TypeScript type inferred from {@link agentMetadataSchema}. */
+export type AgentMetadata = Static<typeof agentMetadataSchema>;
+/** What metadata-change hooks see after an update has been merged with the previous object. */
+export interface AgentMetadataChange {
+    /** The agent whose metadata changed. */
+    readonly agentId: string;
+    /** The complete immutable metadata before the update. */
+    readonly previousMetadata: AgentMetadata;
+    /** The immutable fields supplied by this update. */
+    readonly update: AgentMetadata;
+    /** The complete immutable result after the shallow merge. */
+    readonly metadata: AgentMetadata;
+}
+//# sourceMappingURL=AgentMetadata.d.ts.map

package/dist/AgentMetadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentMetadata.d.ts","sourceRoot":"","sources":["../sources/AgentMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGtD,oGAAoG;AACpG,eAAO,MAAM,WAAW,qCAItB,CAAC;AAEH,+FAA+F;AAC/F,eAAO,MAAM,wBAAwB,qZASpC,CAAC;AAEF,0EAA0E;AAC1E,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEzE;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;meAKrC,CAAC;AAEH,4EAA4E;AAC5E,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE7E;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;meAK9B,CAAC;AAEH,qEAAqE;AACrE,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAE/D,+FAA+F;AAC/F,MAAM,WAAW,mBAAmB;IAChC,wCAAwC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC;IACzC,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;CACpC"}

package/dist/AgentMetadata.js

@@ -0,0 +1,74 @@
+import { Type } from "@sinclair/typebox";
+import { Value } from "@sinclair/typebox/value";
+/** A cuid2 identity: two to thirty-two lowercase alphanumeric characters, opening with a letter. */
+export const cuid2Schema = Type.String({
+    minLength: 2,
+    maxLength: 32,
+    pattern: "^[a-z][a-z0-9]*$",
+});
+/** JSON values metadata may contain, so every metadata object is safe to persist and clone. */
+export const agentMetadataValueSchema = Type.Recursive((value) => Type.Union([
+    Type.String(),
+    Type.Number(),
+    Type.Boolean(),
+    Type.Null(),
+    Type.Array(value),
+    Type.Record(Type.String(), value),
+]));
+/**
+ * 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({
+        hideFromUser: Type.Optional(Type.Boolean()),
+    }),
+    Type.Record(Type.String(), agentMetadataValueSchema),
+]);
+/**
+ * Mutable-by-replacement metadata describing one agent. Modules own additional fields; `title`
+ * is the common human-readable label.
+ */
+export const agentMetadataSchema = Type.Intersect([
+    Type.Object({
+        title: Type.Optional(Type.String()),
+    }),
+    Type.Record(Type.String(), agentMetadataValueSchema),
+]);
+/** @internal Validate, clone, and deeply freeze message metadata at its ownership boundary. */
+export function ownAgentMessageMetadata(metadata) {
+    if (metadata === undefined)
+        return undefined;
+    if (!Value.Check(agentMessageMetadataSchema, metadata)) {
+        throw new Error("The message metadata is not valid.");
+    }
+    return immutableClone(metadata);
+}
+/** @internal Validate, clone, and deeply freeze agent metadata at its ownership boundary. */
+export function ownAgentMetadata(metadata) {
+    if (metadata === undefined)
+        return undefined;
+    if (!Value.Check(agentMetadataSchema, metadata)) {
+        throw new Error("The agent metadata is not valid.");
+    }
+    return immutableClone(metadata);
+}
+/** Clone one persisted value and freeze every object reachable through ordinary properties. */
+function immutableClone(value) {
+    return deepFreeze(structuredClone(value), new WeakSet());
+}
+function deepFreeze(value, seen) {
+    if (value === null || typeof value !== "object")
+        return value;
+    if (seen.has(value))
+        return value;
+    seen.add(value);
+    for (const key of Reflect.ownKeys(value)) {
+        const descriptor = Object.getOwnPropertyDescriptor(value, key);
+        if (descriptor !== undefined && "value" in descriptor) {
+            deepFreeze(descriptor.value, seen);
+        }
+    }
+    return Object.freeze(value);
+}
+//# sourceMappingURL=AgentMetadata.js.map

package/dist/AgentMetadata.js.map

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

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":"AAAA,OAAO,KAAK,EACR,8BAA8B,EAC9B,YAAY,EACZ,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EAC3B,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACnG,OAAO,KAAK,EACR,wBAAwB,EACxB,kBAAkB,EAClB,uBAAuB,EACvB,aAAa,EACb,oBAAoB,EACpB,6BAA6B,EAC7B,uBAAuB,EACvB,iBAAiB,EACjB,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,YAAY,EACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC7B,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,yFAAyF;IACzF,QAAQ,CAAC,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IAC7C,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,YAAY,EAAE,8BAA8B,GAAG,SAAS,CAAC;IAClE,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,sBAAsB,GAAG,SAAS,CAAC;IACpD,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAC9C;;;;OAIG;IACH,QAAQ,CAAC,cAAc,EAAE,mBAAmB,CAAC;CAChD;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB,CAAC,QAAQ,SAAS,aAAa,GAAG,aAAa;IAC5E,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACjD,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CAC3B;AAED,qFAAqF;AACrF,MAAM,WAAW,yBAAyB;IACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;CAChD;AAED,sEAAsE;AACtE,MAAM,WAAW,sBAAsB,CAAC,QAAQ,SAAS,aAAa,GAAG,aAAa;IAClF,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW,CACxB,IAAI,SAAS,YAAY,GAAG,YAAY,EACxC,QAAQ,SAAS,aAAa,GAAG,aAAa;IAE9C;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,oBAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC;IAChE;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CACnB,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,EAChC,QAAQ,EAAE,QAAQ,KACjB,YAAY,CAAC,IAAI,CAAC,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,CAClB,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,EAChC,QAAQ,EAAE,QAAQ,KACjB,YAAY,CAAC,IAAI,CAAC,CAAC;IACxB,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAC5B,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,sBAAsB,CAAC,QAAQ,CAAC,EACvC,KAAK,EAAE,yBAAyB,KAC/B,YAAY,CAAC,IAAI,CAAC,CAAC;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,CACpB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,sBAAsB,CAAC,QAAQ,CAAC,EACvC,KAAK,EAAE,yBAAyB,KAC/B,YAAY,CAAC,IAAI,CAAC,CAAC;IACxB,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAC7B,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,sBAAsB,CAAC,QAAQ,CAAC,EACvC,KAAK,EAAE,yBAAyB,KAC/B,YAAY,CAAC,IAAI,CAAC,CAAC;IACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,CACrB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,sBAAsB,CAAC,QAAQ,CAAC,EACvC,KAAK,EAAE,yBAAyB,KAC/B,YAAY,CAAC,IAAI,CAAC,CAAC;IACxB,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAC7B,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,sBAAsB,CAAC,QAAQ,CAAC,EACvC,KAAK,EAAE,yBAAyB,KAC/B,YAAY,CAAC,IAAI,CAAC,CAAC;IACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,CACrB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,sBAAsB,CAAC,QAAQ,CAAC,EACvC,KAAK,EAAE,yBAAyB,KAC/B,YAAY,CAAC,IAAI,CAAC,CAAC;IACxB,gFAAgF;IAChF,QAAQ,CAAC,OAAO,CAAC,EAAE,CACf,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EACjC,KAAK,EAAE,YAAY,KAClB,YAAY,CAAC,OAAO,CAAC,CAAC;IAC3B,0EAA0E;IAC1E,QAAQ,CAAC,eAAe,CAAC,EAAE,CACvB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EACjC,KAAK,EAAE,uBAAuB,KAC7B,YAAY,CAAC,IAAI,CAAC,CAAC;IACxB,4FAA4F;IAC5F,QAAQ,CAAC,YAAY,CAAC,EAAE,CACpB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,KAChC,YAAY,CAAC,MAAM,CAAC,CAAC;IAC1B,qFAAqF;IACrF,QAAQ,CAAC,KAAK,CAAC,EAAE,CACb,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,KAChC,YAAY,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,sBAAsB,CAAC,EAAE,CAC9B,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EACjC,IAAI,EAAE,oBAAoB,KACzB,YAAY,CAAC,IAAI,CAAC,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,CACtB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EACjC,IAAI,EAAE,iBAAiB,KACtB,YAAY,CAAC,yBAAyB,GAAG,SAAS,CAAC,CAAC;IACzD,uEAAuE;IACvE,QAAQ,CAAC,aAAa,CAAC,EAAE,CACrB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EACjC,OAAO,EAAE,oBAAoB,KAC5B,YAAY,CAAC,IAAI,CAAC,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAC7B,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EACjC,MAAM,EAAE,wBAAwB,KAC/B,YAAY,CAAC,IAAI,CAAC,CAAC;IACxB,gFAAgF;IAChF,QAAQ,CAAC,YAAY,CAAC,EAAE,CACpB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EACjC,MAAM,EAAE,oBAAoB,KAC3B,YAAY,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAAC;IACpD;;;OAGG;IACH,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAC/B,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EACjC,QAAQ,EAAE,wBAAwB,KACjC,YAAY,CAAC,IAAI,CAAC,CAAC;IACxB,qEAAqE;IACrE,QAAQ,CAAC,eAAe,CAAC,EAAE,CACvB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EACjC,QAAQ,EAAE,wBAAwB,KACjC,YAAY,CAAC,IAAI,CAAC,CAAC;IACxB,6FAA6F;IAC7F,QAAQ,CAAC,6BAA6B,CAAC,EAAE,CACrC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EACjC,MAAM,EAAE,6BAA6B,KACpC,YAAY,CAAC,IAAI,CAAC,CAAC;IACxB,qFAAqF;IACrF,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAC7B,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EACjC,MAAM,EAAE,6BAA6B,KACpC,YAAY,CAAC,IAAI,CAAC,CAAC;IACxB,sFAAsF;IACtF,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAC/B,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EACjC,MAAM,EAAE,mBAAmB,KAC1B,YAAY,CAAC,IAAI,CAAC,CAAC;IACxB,oEAAoE;IACpE,QAAQ,CAAC,eAAe,CAAC,EAAE,CACvB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EACjC,MAAM,EAAE,mBAAmB,KAC1B,YAAY,CAAC,IAAI,CAAC,CAAC;IACxB,sDAAsD;IACtD,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAC/B,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EACjC,IAAI,EAAE,aAAa,KAClB,YAAY,CAAC,IAAI,CAAC,CAAC;IACxB,wEAAwE;IACxE,QAAQ,CAAC,eAAe,CAAC,EAAE,CACvB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EACjC,IAAI,EAAE,aAAa,KAClB,YAAY,CAAC,IAAI,CAAC,CAAC;IACxB,iDAAiD;IACjD,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAC1B,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EACjC,IAAI,EAAE,kBAAkB,KACvB,YAAY,CAAC,IAAI,CAAC,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,CAClB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EACjC,IAAI,EAAE,kBAAkB,KACvB,YAAY,CAAC,SAAS,iBAAiB,EAAE,GAAG,SAAS,CAAC,CAAC;IAC5D,sDAAsD;IACtD,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAC/B,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EACjC,SAAS,EAAE,uBAAuB,KACjC,YAAY,CAAC,IAAI,CAAC,CAAC;IACxB,wDAAwD;IACxD,QAAQ,CAAC,eAAe,CAAC,EAAE,CACvB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EACjC,SAAS,EAAE,uBAAuB,KACjC,YAAY,CAAC,IAAI,CAAC,CAAC;IACxB,qDAAqD;IACrD,QAAQ,CAAC,sBAAsB,CAAC,EAAE,CAC9B,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EACjC,SAAS,EAAE,kBAAkB,KAC5B,YAAY,CAAC,IAAI,CAAC,CAAC;IACxB,yFAAyF;IACzF,QAAQ,CAAC,cAAc,CAAC,EAAE,CACtB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EACjC,SAAS,EAAE,kBAAkB,KAC5B,YAAY,CAAC,IAAI,CAAC,CAAC;IACxB,gDAAgD;IAChD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CACzB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EACjC,IAAI,EAAE,aAAa,KAClB,YAAY,CAAC,IAAI,CAAC,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,CACjB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EACjC,IAAI,EAAE,aAAa,KAClB,YAAY,CAAC,SAAS,iBAAiB,EAAE,GAAG,SAAS,CAAC,CAAC;IAC5D,qDAAqD;IACrD,QAAQ,CAAC,sBAAsB,CAAC,EAAE,CAC9B,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EACjC,IAAI,EAAE,aAAa,KAClB,YAAY,CAAC,IAAI,CAAC,CAAC;IACxB,uEAAuE;IACvE,QAAQ,CAAC,cAAc,CAAC,EAAE,CACtB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EACjC,IAAI,EAAE,aAAa,KAClB,YAAY,CAAC,SAAS,iBAAiB,EAAE,GAAG,SAAS,CAAC,CAAC;IAC5D;;;;;;;;;OASG;IACH,QAAQ,CAAC,yBAAyB,CAAC,EAAE,CACjC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EACjC,UAAU,EAAE,mBAAmB,KAC9B,YAAY,CAAC,IAAI,CAAC,CAAC;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CACzB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EACjC,UAAU,EAAE,mBAAmB,KAC9B,YAAY,CAAC,IAAI,CAAC,CAAC;CAC3B"}

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":""}