@slopus/happy-agent-base 0.0.1 → 0.0.2

package/dist/Agent.d.ts

@@ -1,31 +1,86 @@
 import type { SessionUserMessage } from "@slopus/happy-providers";
 import type { Context } from "@steve.kite/stdlib";
-import { type AgentBaseMessageOptions, type AgentBaseOptions } from "./AgentBase.js";
+import { type AgentBaseAwaitOptions, type AgentBaseMessageOptions, type AgentBaseOptions } from "./AgentBase.js";
 import type { AgentBaseState } from "./AgentBaseState.js";
 import type { AgentFeature } from "./AgentFeature.js";
+import type { AgentKV } from "./AgentKV.js";
 import type { AnyAgentTool } from "./AgentTool.js";
+/**
+ * Everything `AgentBase` is constructed with, except its hooks: an agent's behavior comes from
+ * its features, and the singular hooks the base runs with are merged from them.
+ */
 export interface AgentOptions<Tool extends AnyAgentTool = AnyAgentTool> extends Omit<AgentBaseOptions, "hooks"> {
     /** Independent capabilities whose hook implementations are merged, in array order. */
     readonly features?: readonly AgentFeature<Tool>[];
+    /**
+     * The store features share with every other agent built over the same storage. Each feature
+     * is handed its own scope of it, which is where anything outliving one conversation belongs.
+     */
+    readonly sharedKV: AgentKV;
 }
 /**
  * A thin wrapper around `AgentBase` that assembles its behavior from features. Each feature
  * implements any subset of the agent hooks on its own; the agent merges them into the singular
- * private hooks its internal base runs with. Observing hooks fan out to every feature in array
- * order, instructions concatenate, tools concatenate, lifecycle actions concatenate, and the
- * first feature to answer a reset injection wins.
+ * private hooks its internal base runs with.
+ *
+ * Features are independent. Observing hooks — events and lifecycle brackets — fan out to every
+ * feature in array order with per-feature isolation, so one throwing feature never silences the
+ * others, and lifecycle actions concatenate across features with a failing feature losing only
+ * its own actions. Correctness hooks are loud instead: instructions and tools concatenate in
+ * feature order — extending the base state, which `AgentBase` puts first — and a failure there
+ * fails the turn rather than running with a wrong configuration. For a model change, every
+ * feature observes the change, the first returned handoff wins, and a feature failure during an
+ * incompatible change rejects the switch so the history survives.
  */
 export declare class Agent<Tool extends AnyAgentTool = AnyAgentTool> {
     #private;
-    constructor(ctx: Context, options: AgentOptions<Tool>);
+    /**
+     * A new agent over a fresh identity, with its features' hooks merged into one set. Touches
+     * no storage.
+     */
+    static create<Tool extends AnyAgentTool = AnyAgentTool>(ctx: Context, options: AgentOptions<Tool>): Promise<Agent<Tool>>;
+    /**
+     * An agent over an identity that may already have durable state, with that state's one
+     * externally meaningful fact — whether it has work left — read before it is handed back.
+     */
+    static load<Tool extends AnyAgentTool = AnyAgentTool>(ctx: Context, options: AgentOptions<Tool>): Promise<Agent<Tool>>;
+    /**
+     * Load the agent and set it going again if it has work left, or answer with nothing when it
+     * has none — how an owner coming up carries on what an earlier process was in the middle of.
+     */
+    static loadActive<Tool extends AnyAgentTool = AnyAgentTool>(ctx: Context, options: AgentOptions<Tool>): Promise<Agent<Tool> | undefined>;
+    /**
+     * Wrap an already-built base. Private, because an agent is made by `create` or by `load`,
+     * and which of the two the caller means is worth saying.
+     */
+    private constructor();
+    /** The stable session identity this agent was created with. */
     get id(): string;
+    /**
+     * The feature this agent runs under `name`, when it has one. An individual feature holds the
+     * state of the single agent it was built for, so this is how that agent's owner reaches what
+     * belongs to it — a goal to pause, for instance. A shared feature is answered here too, but
+     * it is the collection's instance, serving every agent at once.
+     */
+    feature(name: string): AgentFeature<Tool> | undefined;
+    /**
+     * The base's mutable instructions and tools, which every inference reads and every feature's
+     * own contribution extends.
+     */
     get state(): AgentBaseState;
-    steer(ctx: Context, message: SessionUserMessage, options?: AgentBaseMessageOptions): Promise<void>;
-    send(ctx: Context, message: SessionUserMessage, options?: AgentBaseMessageOptions): Promise<void>;
+    /** Queue a user message that injects as soon as the current response and tool batch finish. */
+    steer(ctx: Context, message: SessionUserMessage, options?: AgentBaseMessageOptions & AgentBaseAwaitOptions): Promise<void>;
+    /** Queue a user message that injects only when the agent would otherwise stop. */
+    send(ctx: Context, message: SessionUserMessage, options?: AgentBaseMessageOptions & AgentBaseAwaitOptions): Promise<void>;
+    /** Start the loop without a new message, continuing a turn an earlier run left unfinished. */
     start(): void;
+    /** Wait until the agent has nothing left to do, including work it accepted but never began. */
     waitForIdle(): Promise<void>;
-    compact(ctx: Context): Promise<void>;
-    abort(): Promise<void>;
+    /** Ask for the conversation to be replaced by the provider's summary of it. */
+    compact(ctx: Context, options?: AgentBaseAwaitOptions): Promise<void>;
+    /** Cancel the active turn, leaving queued messages durable for the next one. */
+    abort(ctx: Context, options?: AgentBaseAwaitOptions): Promise<void>;
+    /** Finish everything already accepted, then destroy the provider session. */
     close(): Promise<void>;
 }
 //# sourceMappingURL=Agent.d.ts.map

package/dist/Agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Agent.d.ts","sourceRoot":"","sources":["../sources/Agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAwB,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACxF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAa,KAAK,uBAAuB,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEhG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,YAAY,CAAC,IAAI,SAAS,YAAY,GAAG,YAAY,CAClE,SAAQ,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACvC,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;CACrD;AAED;;;;;;GAMG;AACH,qBAAa,KAAK,CAAC,IAAI,SAAS,YAAY,GAAG,YAAY;;IAGvD,YAAY,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,EAMpD;IAED,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,IAAI,KAAK,IAAI,cAAc,CAE1B;IAEK,KAAK,CACP,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE,uBAAuB,GAClC,OAAO,CAAC,IAAI,CAAC,CAEf;IAEK,IAAI,CACN,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE,uBAAuB,GAClC,OAAO,CAAC,IAAI,CAAC,CAEf;IAED,KAAK,IAAI,IAAI,CAEZ;IAEK,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAEjC;IAEK,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzC;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;CACJ"}
+{"version":3,"file":"Agent.d.ts","sourceRoot":"","sources":["../sources/Agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAwB,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACxF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAEH,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACxB,MAAM,gBAAgB,CAAC;AAYxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAqB,MAAM,mBAAmB,CAAC;AAEzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,IAAI,SAAS,YAAY,GAAG,YAAY,CAAE,SAAQ,IAAI,CAChF,gBAAgB,EAChB,OAAO,CACV;IACG,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;IAClD;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,KAAK,CAAC,IAAI,SAAS,YAAY,GAAG,YAAY;;IAMvD;;;OAGG;IACH,OAAa,MAAM,CAAC,IAAI,SAAS,YAAY,GAAG,YAAY,EACxD,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,GAC5B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAGtB;IAED;;;OAGG;IACH,OAAa,IAAI,CAAC,IAAI,SAAS,YAAY,GAAG,YAAY,EACtD,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,GAC5B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAGtB;IAED;;;OAGG;IACH,OAAa,UAAU,CAAC,IAAI,SAAS,YAAY,GAAG,YAAY,EAC5D,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,GAC5B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAIlC;IAED;;;OAGG;IACH,OAAO,eAGN;IAED,+DAA+D;IAC/D,IAAI,EAAE,IAAI,MAAM,CAEf;IAED;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,SAAS,CAEpD;IAED;;;OAGG;IACH,IAAI,KAAK,IAAI,cAAc,CAE1B;IAED,+FAA+F;IACzF,KAAK,CACP,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE,uBAAuB,GAAG,qBAAqB,GAC1D,OAAO,CAAC,IAAI,CAAC,CAEf;IAED,kFAAkF;IAC5E,IAAI,CACN,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE,uBAAuB,GAAG,qBAAqB,GAC1D,OAAO,CAAC,IAAI,CAAC,CAEf;IAED,8FAA8F;IAC9F,KAAK,IAAI,IAAI,CAEZ;IAED,+FAA+F;IACzF,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAEjC;IAED,+EAA+E;IACzE,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1E;IAED,gFAAgF;IAC1E,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAExE;IAED,6EAA6E;IACvE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;CACJ"}

package/dist/Agent.js

@@ -1,118 +1,325 @@
-import { AgentBase } from "./AgentBase.js";
+import { AgentBase, } from "./AgentBase.js";
+import { agentEffort, agentKV, agentModel, agentProvider, agentRunKV, agentServiceTier, withAgentKV, withAgentRunKV, } from "./AgentContexts.js";
 /**
  * A thin wrapper around `AgentBase` that assembles its behavior from features. Each feature
  * implements any subset of the agent hooks on its own; the agent merges them into the singular
- * private hooks its internal base runs with. Observing hooks fan out to every feature in array
- * order, instructions concatenate, tools concatenate, lifecycle actions concatenate, and the
- * first feature to answer a reset injection wins.
+ * private hooks its internal base runs with.
+ *
+ * Features are independent. Observing hooks — events and lifecycle brackets — fan out to every
+ * feature in array order with per-feature isolation, so one throwing feature never silences the
+ * others, and lifecycle actions concatenate across features with a failing feature losing only
+ * its own actions. Correctness hooks are loud instead: instructions and tools concatenate in
+ * feature order — extending the base state, which `AgentBase` puts first — and a failure there
+ * fails the turn rather than running with a wrong configuration. For a model change, every
+ * feature observes the change, the first returned handoff wins, and a feature failure during an
+ * incompatible change rejects the switch so the history survives.
  */
 export class Agent {
+    /** The session this agent is a facade over; every operation delegates straight to it. */
     #base;
-    constructor(ctx, options) {
-        const { features, ...base } = options;
-        this.#base = new AgentBase(ctx, {
-            ...base,
-            hooks: mergeFeatures(features ?? []),
-        });
+    /** The features whose hooks were merged into the base, kept in the order they were given. */
+    #features;
+    /**
+     * A new agent over a fresh identity, with its features' hooks merged into one set. Touches
+     * no storage.
+     */
+    static async create(ctx, options) {
+        const { features, base } = split(options);
+        return new Agent(await AgentBase.create(ctx, base), features);
     }
+    /**
+     * An agent over an identity that may already have durable state, with that state's one
+     * externally meaningful fact — whether it has work left — read before it is handed back.
+     */
+    static async load(ctx, options) {
+        const { features, base } = split(options);
+        return new Agent(await AgentBase.load(ctx, base), features);
+    }
+    /**
+     * Load the agent and set it going again if it has work left, or answer with nothing when it
+     * has none — how an owner coming up carries on what an earlier process was in the middle of.
+     */
+    static async loadActive(ctx, options) {
+        const { features, base } = split(options);
+        const loaded = await AgentBase.loadActive(ctx, base);
+        return loaded === undefined ? undefined : new Agent(loaded, features);
+    }
+    /**
+     * Wrap an already-built base. Private, because an agent is made by `create` or by `load`,
+     * and which of the two the caller means is worth saying.
+     */
+    constructor(base, features) {
+        this.#features = features;
+        this.#base = base;
+    }
+    /** The stable session identity this agent was created with. */
     get id() {
         return this.#base.id;
     }
+    /**
+     * The feature this agent runs under `name`, when it has one. An individual feature holds the
+     * state of the single agent it was built for, so this is how that agent's owner reaches what
+     * belongs to it — a goal to pause, for instance. A shared feature is answered here too, but
+     * it is the collection's instance, serving every agent at once.
+     */
+    feature(name) {
+        return this.#features.find((feature) => feature.name === name);
+    }
+    /**
+     * The base's mutable instructions and tools, which every inference reads and every feature's
+     * own contribution extends.
+     */
     get state() {
         return this.#base.state;
     }
+    /** Queue a user message that injects as soon as the current response and tool batch finish. */
     async steer(ctx, message, options) {
         await this.#base.steer(ctx, message, options);
     }
+    /** Queue a user message that injects only when the agent would otherwise stop. */
     async send(ctx, message, options) {
         await this.#base.send(ctx, message, options);
     }
+    /** Start the loop without a new message, continuing a turn an earlier run left unfinished. */
     start() {
         this.#base.start();
     }
+    /** Wait until the agent has nothing left to do, including work it accepted but never began. */
     async waitForIdle() {
         await this.#base.waitForIdle();
     }
-    async compact(ctx) {
-        await this.#base.compact(ctx);
+    /** Ask for the conversation to be replaced by the provider's summary of it. */
+    async compact(ctx, options) {
+        await this.#base.compact(ctx, options);
     }
-    async abort() {
-        await this.#base.abort();
+    /** Cancel the active turn, leaving queued messages durable for the next one. */
+    async abort(ctx, options) {
+        await this.#base.abort(ctx, options);
     }
+    /** Finish everything already accepted, then destroy the provider session. */
     async close() {
         await this.#base.close();
     }
 }
 /**
  * Merge every feature's hook implementations into one `AgentBaseHooks`. A hook is provided only
- * when at least one feature implements it, so the base's own fallbacks — such as the mutable
- * state for instructions and tools — stay in effect otherwise.
+ * when at least one feature implements it, so the base's own behavior — the mutable state alone
+ * for instructions and tools — stays in effect otherwise.
  */
-function mergeFeatures(features) {
+/**
+ * Separate the features from the options the base is built with, and merge their hooks into the
+ * one set the base observes the run through. Both factories need exactly this, and the merge has
+ * to happen before the base exists.
+ */
+function split(options) {
+    const { features, sharedKV, ...rest } = options;
+    const resolved = features ?? [];
+    return {
+        features: resolved,
+        base: { ...rest, hooks: mergeFeatures(resolved, options, sharedKV) },
+    };
+}
+function mergeFeatures(features, options, sharedKV) {
+    /** What one feature's hook is handed alongside the context, for this call. */
+    const scopeOf = (ctx, feature) => featureScope(ctx, feature, options, sharedKV);
     const withInstructions = features.filter((feature) => feature.instructions !== undefined);
     const withTools = features.filter((feature) => feature.tools !== undefined);
+    const withToolExecution = features.filter((feature) => feature.aroundToolExecution !== undefined);
     const withModelChanged = features.filter((feature) => feature.modelChanged !== undefined);
+    const withEvents = features.filter((feature) => feature.onEvent !== undefined);
+    // Observing hooks fan out with per-feature isolation: one throwing feature must never
+    // prevent the features after it from observing.
     const fanOut = (pick) => {
         const implemented = features.filter((feature) => pick(feature) !== undefined);
         if (implemented.length === 0)
             return undefined;
-        return (ctx) => {
-            for (const feature of implemented)
-                pick(feature)?.(ctx);
+        return async (ctx, ...args) => {
+            for (const feature of implemented) {
+                try {
+                    await pick(feature)?.(featureCtx(ctx, feature), scopeOf(ctx, feature), ...args);
+                }
+                catch {
+                    // Features observe independently; one failing never silences the rest.
+                }
+            }
         };
     };
+    // Transactional hooks run in order inside one transaction, and a failure propagates: the
+    // features here are writing alongside the fact being committed, so containing one feature's
+    // failure would commit a conclusion the rest of the transaction contradicts.
+    const chain = (pick) => {
+        const implemented = features.filter((feature) => pick(feature) !== undefined);
+        if (implemented.length === 0)
+            return undefined;
+        return async (ctx) => {
+            for (const feature of implemented) {
+                await pick(feature)?.(featureCtx(ctx, feature), scopeOf(ctx, feature));
+            }
+        };
+    };
+    // Action hooks concatenate what every feature asks for; a failing feature loses only its
+    // own actions.
     const collect = (pick) => {
         const implemented = features.filter((feature) => pick(feature) !== undefined);
         if (implemented.length === 0)
             return undefined;
-        return (ctx) => implemented.flatMap((feature) => pick(feature)?.(ctx) ?? []);
+        return async (ctx, ...args) => {
+            const actions = [];
+            for (const feature of implemented) {
+                try {
+                    actions.push(...((await pick(feature)?.(featureCtx(ctx, feature), scopeOf(ctx, feature), ...args)) ?? []));
+                }
+                catch {
+                    // Features act independently; one failing never discards the rest.
+                }
+            }
+            return actions;
+        };
     };
-    const onEvent = fanOutEvent(features);
     return {
-        ...(onEvent === undefined ? {} : { onEvent }),
+        ...(withEvents.length === 0
+            ? {}
+            : {
+                onEvent: ((ctx, event) => {
+                    for (const feature of withEvents) {
+                        try {
+                            feature.onEvent?.(featureCtx(ctx, feature), scopeOf(ctx, feature), event);
+                        }
+                        catch {
+                            // Features observe independently; one failing never silences
+                            // the rest.
+                        }
+                    }
+                }),
+            }),
         ...(withInstructions.length === 0
             ? {}
             : {
-                instructions: (ctx) => withInstructions
-                    .map((feature) => feature.instructions?.(ctx) ?? "")
-                    .filter((text) => text.length > 0)
-                    .join("\n\n"),
+                // Correctness hook: a failing feature propagates and fails the turn.
+                instructions: async (ctx) => {
+                    const texts = [];
+                    for (const feature of withInstructions) {
+                        texts.push((await feature.instructions?.(featureCtx(ctx, feature), scopeOf(ctx, feature))) ?? "");
+                    }
+                    return texts.filter((text) => text.length > 0).join("\n\n");
+                },
             }),
         ...(withTools.length === 0
             ? {}
             : {
-                tools: (ctx) => withTools.flatMap((feature) => [...(feature.tools?.(ctx) ?? [])]),
+                // Correctness hook: a failing feature propagates and fails the turn; the
+                // base validates the merged list against duplicate names.
+                tools: async (ctx) => {
+                    const tools = [];
+                    for (const feature of withTools) {
+                        tools.push(...((await feature.tools?.(featureCtx(ctx, feature), scopeOf(ctx, feature))) ?? []));
+                    }
+                    return tools;
+                },
+            }),
+        ...(withToolExecution.length === 0
+            ? {}
+            : {
+                // Correctness middleware: the first feature is the outermost wrapper, and a
+                // failure propagates to the base so it becomes this call's error result.
+                aroundToolExecution: async (ctx, execution) => {
+                    const invoke = async (index) => {
+                        const feature = withToolExecution[index];
+                        if (feature === undefined)
+                            return await execution.execute();
+                        let continued;
+                        return await feature.aroundToolExecution?.(featureCtx(ctx, feature), scopeOf(ctx, feature), {
+                            ...execution,
+                            // A wrapper may inspect the continuation from more than one
+                            // code path; every call joins the same downstream execution.
+                            execute: () => (continued ??= invoke(index + 1)),
+                        });
+                    };
+                    return await invoke(0);
+                },
             }),
         ...(withModelChanged.length === 0
             ? {}
             : {
-                modelChanged: (ctx, change) => {
+                modelChanged: async (ctx, change) => {
                     let injected;
-                    // Every feature observes the change; the first returned message wins.
+                    let failed = false;
+                    let failure;
+                    // Every feature observes the change even when an earlier one fails;
+                    // the first returned handoff wins.
                     for (const feature of withModelChanged) {
-                        const message = feature.modelChanged?.(ctx, change);
-                        injected ??= message;
+                        try {
+                            const message = await feature.modelChanged?.(featureCtx(ctx, feature), scopeOf(ctx, feature), change);
+                            injected ??= message;
+                        }
+                        catch (error) {
+                            if (!failed) {
+                                failed = true;
+                                failure = error;
+                            }
+                        }
                     }
+                    // A failing feature during an incompatible change rejects the switch,
+                    // preserving the history; on a compatible change it merely observed.
+                    if (failed && change.wasReset)
+                        throw failure;
                     return injected;
                 },
             }),
         ...spread("beforeAgentLoop", fanOut((feature) => feature.beforeAgentLoop)),
-        ...spread("beforeTurn", fanOut((feature) => feature.beforeTurn)),
+        ...spread("beforeTurn", collect((feature) => feature.beforeTurn)),
         ...spread("beforeInference", fanOut((feature) => feature.beforeInference)),
         ...spread("afterInference", fanOut((feature) => feature.afterInference)),
         ...spread("afterTurn", collect((feature) => feature.afterTurn)),
         ...spread("afterAgentLoop", collect((feature) => feature.afterAgentLoop)),
+        ...spread("afterAgentSettledTransact", chain((feature) => feature.afterAgentSettledTransact)),
+        ...spread("afterAgentSettled", fanOut((feature) => feature.afterAgentSettled)),
     };
 }
-function fanOutEvent(features) {
-    const implemented = features.filter((feature) => feature.onEvent !== undefined);
-    if (implemented.length === 0)
-        return undefined;
-    return (ctx, event) => {
-        for (const feature of implemented)
-            feature.onEvent?.(ctx, event);
+/**
+ * The context a feature's hooks run on: the agent's context with both key-value stores narrowed
+ * to the feature's own name, so features never see each other's persisted entries — and neither
+ * does a tool one of them runs.
+ */
+function featureCtx(ctx, feature) {
+    const kv = agentKV(ctx);
+    const runKV = agentRunKV(ctx);
+    const scoped = kv === undefined ? ctx : withAgentKV(ctx, kv.scoped("feature", feature.name));
+    return runKV === undefined
+        ? scoped
+        : withAgentRunKV(scoped, runKV.scoped("feature", feature.name));
+}
+/**
+ * What a feature's hook is handed alongside the context: the agent it is serving, and its own
+ * scope of each of the three stores. The selection comes from the context the agent derived for
+ * this call, so a hook always sees the model, effort, and tier the work is actually running on
+ * rather than the ones the agent was built with.
+ */
+function featureScope(ctx, feature, options, sharedKV) {
+    const kv = agentKV(ctx);
+    const runKV = agentRunKV(ctx);
+    if (kv === undefined || runKV === undefined) {
+        throw new Error(`The feature "${feature.name}" was called on a context carrying no agent stores.`);
+    }
+    const provider = agentProvider(ctx) ?? options.provider;
+    return {
+        agent: {
+            id: options.id,
+            provider,
+            providerKind: options.providers.typeOf(provider) ?? undefined,
+            model: agentModel(ctx) ?? options.model,
+            effort: agentEffort(ctx) ?? options.effort,
+            tier: agentServiceTier(ctx) ?? options.serviceTier,
+        },
+        kv: kv.scoped("feature", feature.name),
+        sharedKV: sharedKV.scoped(feature.name),
+        runKV: runKV.scoped("feature", feature.name),
     };
 }
+/**
+ * One optional entry to spread into the merged hooks: the key when a merged implementation
+ * exists, and nothing at all when no feature implemented it, so the base keeps its own behavior.
+ */
 function spread(key, value) {
     return value === undefined ? {} : { [key]: value };
 }

package/dist/Agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"Agent.js","sourceRoot":"","sources":["../sources/Agent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Agent.js","sourceRoot":"","sources":["../sources/Agent.ts"],"names":[],"mappings":"AAGA,OAAO,EACH,SAAS,GAIZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACH,WAAW,EACX,OAAO,EACP,UAAU,EACV,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,cAAc,GACjB,MAAM,oBAAoB,CAAC;AAyB5B;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,KAAK;IACd,yFAAyF;IAChF,KAAK,CAAY;IAC1B,6FAA6F;IACpF,SAAS,CAAgC;IAElD;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CACf,GAAY,EACZ,OAA2B;QAE3B,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QAC1C,OAAO,IAAI,KAAK,CAAC,MAAM,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC;IAClE,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,CACb,GAAY,EACZ,OAA2B;QAE3B,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QAC1C,OAAO,IAAI,KAAK,CAAC,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC;IAChE,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,UAAU,CACnB,GAAY,EACZ,OAA2B;QAE3B,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACrD,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC1E,CAAC;IAED;;;OAGG;IACH,YAAoB,IAAe,EAAE,QAAuC;QACxE,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACtB,CAAC;IAED,+DAA+D;IAC/D,IAAI,EAAE;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,IAAY;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACnE,CAAC;IAED;;;OAGG;IACH,IAAI,KAAK;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;IAC5B,CAAC;IAED,+FAA+F;IAC/F,KAAK,CAAC,KAAK,CACP,GAAY,EACZ,OAA2B,EAC3B,OAAyD;QAEzD,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAED,kFAAkF;IAClF,KAAK,CAAC,IAAI,CACN,GAAY,EACZ,OAA2B,EAC3B,OAAyD;QAEzD,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IAED,8FAA8F;IAC9F,KAAK;QACD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,+FAA+F;IAC/F,KAAK,CAAC,WAAW;QACb,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;IACnC,CAAC;IAED,+EAA+E;IAC/E,KAAK,CAAC,OAAO,CAAC,GAAY,EAAE,OAA+B;QACvD,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,gFAAgF;IAChF,KAAK,CAAC,KAAK,CAAC,GAAY,EAAE,OAA+B;QACrD,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,6EAA6E;IAC7E,KAAK,CAAC,KAAK;QACP,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;CACJ;AAED;;;;GAIG;AACH;;;;GAIG;AACH,SAAS,KAAK,CACV,OAA2B;IAE3B,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAChD,MAAM,QAAQ,GAAG,QAAQ,IAAI,EAAE,CAAC;IAChC,OAAO;QACH,QAAQ,EAAE,QAAQ;QAClB,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE;KACvE,CAAC;AACN,CAAC;AAED,SAAS,aAAa,CAClB,QAAuC,EACvC,OAA2B,EAC3B,QAAiB;IAEjB,8EAA8E;IAC9E,MAAM,OAAO,GAAG,CAAC,GAAY,EAAE,OAA2B,EAAqB,EAAE,CAC7E,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAClD,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC;IAC1F,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;IAC5E,MAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CACrC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,mBAAmB,KAAK,SAAS,CACzD,CAAC;IACF,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC;IAC1F,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC;IAC/E,sFAAsF;IACtF,gDAAgD;IAChD,MAAM,MAAM,GAAG,CACX,IAIe,EACkD,EAAE;QACnE,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC,CAAC;QAC9E,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAC/C,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,EAAE;YAC1B,KAAK,MAAM,OAAO,IAAI,WAAW,EAAE,CAAC;gBAChC,IAAI,CAAC;oBACD,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;gBACpF,CAAC;gBAAC,MAAM,CAAC;oBACL,uEAAuE;gBAC3E,CAAC;YACL,CAAC;QACL,CAAC,CAAC;IACN,CAAC,CAAC;IACF,yFAAyF;IACzF,4FAA4F;IAC5F,6EAA6E;IAC7E,MAAM,KAAK,GAAG,CACV,IAEiF,EACpC,EAAE;QAC/C,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC,CAAC;QAC9E,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAC/C,OAAO,KAAK,EAAE,GAAG,EAAE,EAAE;YACjB,KAAK,MAAM,OAAO,IAAI,WAAW,EAAE,CAAC;gBAChC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;YAC3E,CAAC;QACL,CAAC,CAAC;IACN,CAAC,CAAC;IACF,yFAAyF;IACzF,eAAe;IACf,MAAM,OAAO,GAAG,CACZ,IAQe,EAGH,EAAE;QACd,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC,CAAC;QAC9E,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAC/C,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,EAAE;YAC1B,MAAM,OAAO,GAAyB,EAAE,CAAC;YACzC,KAAK,MAAM,OAAO,IAAI,WAAW,EAAE,CAAC;gBAChC,IAAI,CAAC;oBACD,OAAO,CAAC,IAAI,CACR,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,CACtB,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,EACxB,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,EACrB,GAAG,IAAI,CACV,CAAC,IAAI,EAAE,CAAC,CACZ,CAAC;gBACN,CAAC;gBAAC,MAAM,CAAC;oBACL,mEAAmE;gBACvE,CAAC;YACL,CAAC;YACD,OAAO,OAAO,CAAC;QACnB,CAAC,CAAC;IACN,CAAC,CAAC;IACF,OAAO;QACH,GAAG,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;YACvB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACI,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;oBACrB,KAAK,MAAM,OAAO,IAAI,UAAU,EAAE,CAAC;wBAC/B,IAAI,CAAC;4BACD,OAAO,CAAC,OAAO,EAAE,CACb,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,EACxB,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,EACrB,KAAK,CACR,CAAC;wBACN,CAAC;wBAAC,MAAM,CAAC;4BACL,6DAA6D;4BAC7D,YAAY;wBAChB,CAAC;oBACL,CAAC;gBACL,CAAC,CAAqC;aACzC,CAAC;QACR,GAAG,CAAC,gBAAgB,CAAC,MAAM,KAAK,CAAC;YAC7B,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACI,qEAAqE;gBACrE,YAAY,EAAE,KAAK,EAAE,GAAY,EAAE,EAAE;oBACjC,MAAM,KAAK,GAAa,EAAE,CAAC;oBAC3B,KAAK,MAAM,OAAO,IAAI,gBAAgB,EAAE,CAAC;wBACrC,KAAK,CAAC,IAAI,CACN,CAAC,MAAM,OAAO,CAAC,YAAY,EAAE,CACzB,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,EACxB,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CACxB,CAAC,IAAI,EAAE,CACX,CAAC;oBACN,CAAC;oBACD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAChE,CAAC;aACJ,CAAC;QACR,GAAG,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;YACtB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACI,yEAAyE;gBACzE,0DAA0D;gBAC1D,KAAK,EAAE,KAAK,EAAE,GAAY,EAAE,EAAE;oBAC1B,MAAM,KAAK,GAAmB,EAAE,CAAC;oBACjC,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE,CAAC;wBAC9B,KAAK,CAAC,IAAI,CACN,GAAG,CAAC,CAAC,MAAM,OAAO,CAAC,KAAK,EAAE,CACtB,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,EACxB,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CACxB,CAAC,IAAI,EAAE,CAAC,CACZ,CAAC;oBACN,CAAC;oBACD,OAAO,KAAK,CAAC;gBACjB,CAAC;aACJ,CAAC;QACR,GAAG,CAAC,iBAAiB,CAAC,MAAM,KAAK,CAAC;YAC9B,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACI,4EAA4E;gBAC5E,yEAAyE;gBACzE,mBAAmB,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE;oBAC1C,MAAM,MAAM,GAAG,KAAK,EAAE,KAAa,EAAoB,EAAE;wBACrD,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;wBACzC,IAAI,OAAO,KAAK,SAAS;4BAAE,OAAO,MAAM,SAAS,CAAC,OAAO,EAAE,CAAC;wBAC5D,IAAI,SAAuC,CAAC;wBAC5C,OAAO,MAAM,OAAO,CAAC,mBAAmB,EAAE,CACtC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,EACxB,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,EACrB;4BACI,GAAG,SAAS;4BACZ,4DAA4D;4BAC5D,6DAA6D;4BAC7D,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,SAAS,KAAK,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;yBACnD,CACJ,CAAC;oBACN,CAAC,CAAC;oBACF,OAAO,MAAM,MAAM,CAAC,CAAC,CAAC,CAAC;gBAC3B,CAAC;aACJ,CAAC;QACR,GAAG,CAAC,gBAAgB,CAAC,MAAM,KAAK,CAAC;YAC7B,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACI,YAAY,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE;oBAChC,IAAI,QAA0C,CAAC;oBAC/C,IAAI,MAAM,GAAG,KAAK,CAAC;oBACnB,IAAI,OAAgB,CAAC;oBACrB,oEAAoE;oBACpE,mCAAmC;oBACnC,KAAK,MAAM,OAAO,IAAI,gBAAgB,EAAE,CAAC;wBACrC,IAAI,CAAC;4BACD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,YAAY,EAAE,CACxC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,EACxB,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,EACrB,MAAM,CACT,CAAC;4BACF,QAAQ,KAAK,OAAO,CAAC;wBACzB,CAAC;wBAAC,OAAO,KAAc,EAAE,CAAC;4BACtB,IAAI,CAAC,MAAM,EAAE,CAAC;gCACV,MAAM,GAAG,IAAI,CAAC;gCACd,OAAO,GAAG,KAAK,CAAC;4BACpB,CAAC;wBACL,CAAC;oBACL,CAAC;oBACD,sEAAsE;oBACtE,qEAAqE;oBACrE,IAAI,MAAM,IAAI,MAAM,CAAC,QAAQ;wBAAE,MAAM,OAAO,CAAC;oBAC7C,OAAO,QAAQ,CAAC;gBACpB,CAAC;aACJ,CAAC;QACR,GAAG,MAAM,CACL,iBAAiB,EACjB,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,eAAe,CAAC,CAC/C;QACD,GAAG,MAAM,CACL,YAAY,EACZ,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAC3C;QACD,GAAG,MAAM,CACL,iBAAiB,EACjB,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,eAAe,CAAC,CAC/C;QACD,GAAG,MAAM,CACL,gBAAgB,EAChB,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,CAC9C;QACD,GAAG,MAAM,CACL,WAAW,EACX,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAC1C;QACD,GAAG,MAAM,CACL,gBAAgB,EAChB,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,CAC/C;QACD,GAAG,MAAM,CACL,2BAA2B,EAC3B,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,yBAAyB,CAAC,CACxD;QACD,GAAG,MAAM,CACL,mBAAmB,EACnB,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,iBAAiB,CAAC,CACjD;KACJ,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,SAAS,UAAU,CAAC,GAAY,EAAE,OAAkC;IAChE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACxB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7F,OAAO,KAAK,KAAK,SAAS;QACtB,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AACxE,CAAC;AAED;;;;;GAKG;AACH,SAAS,YAAY,CACjB,GAAY,EACZ,OAA2B,EAC3B,OAA2B,EAC3B,QAAiB;IAEjB,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACxB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,EAAE,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CACX,gBAAgB,OAAO,CAAC,IAAI,qDAAqD,CACpF,CAAC;IACN,CAAC;IACD,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC;IACxD,OAAO;QACH,KAAK,EAAE;YACH,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,QAAQ;YACR,YAAY,EAAE,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,SAAS;YAC7D,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,KAAK;YACvC,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM;YAC1C,IAAI,EAAE,gBAAgB,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,WAAW;SACrD;QACD,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC;QACtC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;QACvC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC;KAC/C,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,SAAS,MAAM,CACX,GAAQ,EACR,KAAwB;IAExB,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAE,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAA4B,CAAC;AAClF,CAAC"}