@framers/agentos 0.12.12 → 0.12.14

package/dist/api/runtime/agentCognitiveMemory.d.ts

@@ -0,0 +1,82 @@
+/**
+ * @file agentCognitiveMemory.ts
+ * Cognitive memory for GMIs built from agent options (`agent({ runtime: 'gmi' })`,
+ * spec D7): a {@link CognitiveMemoryManager} over an in-memory vector store, the
+ * in-memory knowledge graph, an embedding manager for `memory.embedding`, a
+ * working memory of its own and the persona's HEXACO traits.
+ *
+ * One manager serves every session of an agent. Each GMI's memory bridge passes
+ * the session's mood on every encode, retrieve and assemble call and scopes
+ * recall to the session's user and conversation, so the manager's own mood
+ * callback is neutral. The memory graph runs on the `'knowledge-graph'` backend
+ * over the same in-memory knowledge graph, because the `'graphology'` backend
+ * needs graphology, an optional peer dependency. Consolidation runs only when
+ * `memory.consolidation.enabled` is true. The build embeds one test text through
+ * the embedding model it sets up, so a model that cannot answer, or answers with
+ * another size than memory expects, fails the build instead of leaving memory empty.
+ */
+import { CognitiveMemoryManager } from '../../cognition/memory/CognitiveMemoryManager.js';
+import type { CognitiveMechanismsConfig } from '../../cognition/memory/mechanisms/types.js';
+import type { IPersonaDefinition } from '../../cognition/substrate/personas/IPersonaDefinition.js';
+import type { IEmbeddingManager } from '../../core/embeddings/IEmbeddingManager.js';
+import type { MemoryConfig } from '../types.js';
+type Env = Readonly<Record<string, string | undefined>>;
+/**
+ * Checks, when the agent is built, that cognitive memory has an embedding model
+ * it can use, so a missing or unusable one fails before the first send. Reads
+ * the environment only to pick the provider when `memory.embedding` is unset;
+ * credentials are read when the memory is built.
+ *
+ * @param memory - The agent's memory config.
+ * @param env - The environment to read OPENAI_API_KEY and OLLAMA_BASE_URL from (defaults to `process.env`).
+ * @throws {Error} Naming `memory.embedding` when no provider is set or detected, when the
+ *   provider has no embeddings (Anthropic, Groq, xAI, the Claude Code and Gemini CLIs), when the
+ *   model does not resolve, or when the model's output size is unknown and
+ *   `memory.embedding.dimension` is unset or not a positive integer.
+ */
+export declare function assertEmbeddingAvailable(memory: MemoryConfig, env?: Env): void;
+/**
+ * The checks on `memory.embedding` that read no environment, for `gmi()` to run
+ * when the agent is built: with a provider set, that it has embeddings, that the
+ * model resolves on it, that a declared dimension is a positive integer, and that
+ * the model's output size is known or declared. With no provider set, the
+ * provider is picked from the environment when the memory is first built, and
+ * only a declared dimension is checked here.
+ *
+ * @param memory - The agent's memory config.
+ * @throws {Error} Naming `memory.embedding`, as {@link assertEmbeddingAvailable} does.
+ */
+export declare function assertEmbeddingConfig(memory: MemoryConfig): void;
+export interface AgentCognitiveMemoryOptions {
+    /** The agent's persona: its id is the memory's owner (`agentId`), its traits shape encoding. */
+    persona: IPersonaDefinition;
+    memory: MemoryConfig;
+    /** The memory mechanisms to run; none when undefined. */
+    mechanisms?: CognitiveMechanismsConfig;
+    /**
+     * An embedding manager to use instead of one built from `memory.embedding`
+     * (tests, and hosts that own one). The caller keeps ownership: `close()` does not shut it down.
+     */
+    embeddingManager?: IEmbeddingManager;
+}
+export interface AgentCognitiveMemory {
+    manager: CognitiveMemoryManager;
+    /**
+     * Shuts the manager down and releases the vector store and the embedding
+     * manager this builder created. Later calls return the first call's promise.
+     */
+    close(): Promise<void>;
+}
+/**
+ * Builds and initialises the cognitive memory manager an agent's GMIs share.
+ *
+ * @param opts - The persona, the memory config, the mechanisms and an optional embedding manager.
+ * @returns The manager and a `close()` that releases it.
+ * @throws {Error} When the embedding model is missing or unusable (see {@link assertEmbeddingAvailable}),
+ *   when its provider has no credentials or fails to start, when a test embedding through it
+ *   fails or returns another size than memory expects (skipped for an embedding manager the
+ *   caller passes), or when the manager fails to initialise.
+ */
+export declare function createAgentCognitiveMemory(opts: AgentCognitiveMemoryOptions): Promise<AgentCognitiveMemory>;
+export {};
+//# sourceMappingURL=agentCognitiveMemory.d.ts.map

package/dist/api/runtime/agentCognitiveMemory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentCognitiveMemory.d.ts","sourceRoot":"","sources":["../../../src/api/runtime/agentCognitiveMemory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,kDAAkD,CAAC;AAE1F,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AAM5F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0DAA0D,CAAC;AAEnG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAGpF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA+BhD,KAAK,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;AA4ExD;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,GAAE,GAAiB,GAAG,IAAI,CAE3F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAMhE;AAED,MAAM,WAAW,2BAA2B;IAC1C,gGAAgG;IAChG,OAAO,EAAE,kBAAkB,CAAC;IAC5B,MAAM,EAAE,YAAY,CAAC;IACrB,yDAAyD;IACzD,UAAU,CAAC,EAAE,yBAAyB,CAAC;IACvC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;CACtC;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,sBAAsB,CAAC;IAChC;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAgFD;;;;;;;;;GASG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,2BAA2B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAgEjH"}

package/dist/api/runtime/agentCognitiveMemory.js

@@ -0,0 +1,277 @@
+/**
+ * @file agentCognitiveMemory.ts
+ * Cognitive memory for GMIs built from agent options (`agent({ runtime: 'gmi' })`,
+ * spec D7): a {@link CognitiveMemoryManager} over an in-memory vector store, the
+ * in-memory knowledge graph, an embedding manager for `memory.embedding`, a
+ * working memory of its own and the persona's HEXACO traits.
+ *
+ * One manager serves every session of an agent. Each GMI's memory bridge passes
+ * the session's mood on every encode, retrieve and assemble call and scopes
+ * recall to the session's user and conversation, so the manager's own mood
+ * callback is neutral. The memory graph runs on the `'knowledge-graph'` backend
+ * over the same in-memory knowledge graph, because the `'graphology'` backend
+ * needs graphology, an optional peer dependency. Consolidation runs only when
+ * `memory.consolidation.enabled` is true. The build embeds one test text through
+ * the embedding model it sets up, so a model that cannot answer, or answers with
+ * another size than memory expects, fails the build instead of leaving memory empty.
+ */
+import { CognitiveMemoryManager } from '../../cognition/memory/CognitiveMemoryManager.js';
+import { KnowledgeGraph } from '../../cognition/memory/retrieval/graph/knowledge/KnowledgeGraph.js';
+import { EmbeddingManager } from '../../cognition/rag/EmbeddingManager.js';
+import { InMemoryVectorStore } from '../../cognition/rag/vector_stores/InMemoryVectorStore.js';
+import { InMemoryWorkingMemory } from '../../cognition/substrate/memory/InMemoryWorkingMemory.js';
+import { HEXACO_TRAIT_KEYS, normalizeHexacoTraits } from '../../cognition/substrate/personas/hexaco.js';
+import { createProviderManager, resolveModelOption, resolveProvider } from '../model.js';
+/**
+ * Output sizes of the embedding models agentos knows, as each returns them when
+ * no `dimensions` is requested: OpenAI's (text-embedding-3 in
+ * https://developers.openai.com/api/docs/guides/embeddings; all three as
+ * OpenAIProvider records them for its model listing), nomic-embed-text's
+ * (https://huggingface.co/nomic-ai/nomic-embed-text-v1.5) and Gemini's (the
+ * sizes GeminiProvider's catalog records).
+ */
+const KNOWN_EMBEDDING_DIMENSIONS = new Map([
+    ['text-embedding-3-small', 1536],
+    ['text-embedding-3-large', 3072],
+    ['text-embedding-ada-002', 1536],
+    ['nomic-embed-text', 768],
+    ['gemini-embedding-001', 3072],
+    ['gemini-embedding-2', 3072],
+]);
+/** Providers whose agentos implementation has no embeddings: their `generateEmbeddings` always throws. */
+const PROVIDERS_WITHOUT_EMBEDDINGS = new Map([
+    ['anthropic', 'Anthropic'],
+    ['groq', 'Groq'],
+    ['xai', 'xAI'],
+    ['claude-code-cli', 'The Claude Code CLI'],
+    ['gemini-cli', 'The Gemini CLI'],
+]);
+const NEUTRAL_PAD = { valence: 0, arousal: 0, dominance: 0 };
+function messageOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/** An Error carrying the error it reports as `cause`. */
+function errorWithCause(message, cause) {
+    return Object.assign(new Error(message), { cause });
+}
+function refuseProviderWithoutEmbeddings(providerId) {
+    const label = PROVIDERS_WITHOUT_EMBEDDINGS.get(providerId.toLowerCase());
+    if (label) {
+        throw new Error(`gmi(): ${label} has no embedding models in agentos; set memory.embedding to a provider that has them, such as openai or ollama.`);
+    }
+}
+/** The size of a model in {@link KNOWN_EMBEDDING_DIMENSIONS}, also under a vendor prefix (`openai/...`) or an Ollama tag (`...:latest`). */
+function knownDimension(modelId) {
+    const exact = KNOWN_EMBEDDING_DIMENSIONS.get(modelId);
+    if (exact !== undefined)
+        return exact;
+    const base = modelId.slice(modelId.lastIndexOf('/') + 1).split(':')[0];
+    return KNOWN_EMBEDDING_DIMENSIONS.get(base);
+}
+/** `memory.embedding.dimension`, refused when it is set and is not a positive integer. */
+function checkedDimension(memory) {
+    const declared = memory.embedding?.dimension;
+    if (declared !== undefined && !(Number.isInteger(declared) && declared > 0)) {
+        throw new Error(`gmi(): memory.embedding.dimension must be a positive integer; got ${String(declared)}.`);
+    }
+    return declared;
+}
+/**
+ * Resolves the embedding model from `memory.embedding`, or, when it is unset,
+ * from the environment: OpenAI's default embedding model when OPENAI_API_KEY is
+ * set, else Ollama's when OLLAMA_BASE_URL is set. Only checks whether those two
+ * are set; the provider's credentials are resolved when the memory is built.
+ */
+function resolveEmbeddingTarget(memory, env) {
+    const requested = memory.embedding?.provider || (env.OPENAI_API_KEY ? 'openai' : env.OLLAMA_BASE_URL ? 'ollama' : undefined);
+    if (!requested) {
+        throw new Error('gmi(): cognitive memory needs an embedding model. Set memory.embedding: { provider, model } or set OPENAI_API_KEY or OLLAMA_BASE_URL.');
+    }
+    refuseProviderWithoutEmbeddings(requested);
+    let model;
+    try {
+        model = resolveModelOption({ provider: requested, model: memory.embedding?.model }, 'embedding');
+    }
+    catch (error) {
+        throw errorWithCause(`gmi(): memory.embedding: ${messageOf(error)}`, error);
+    }
+    // A `provider:model` id names its own provider, which may be one that cannot embed.
+    refuseProviderWithoutEmbeddings(model.providerId);
+    const declared = checkedDimension(memory);
+    const dimension = declared ?? knownDimension(model.modelId);
+    if (dimension === undefined) {
+        throw new Error(`gmi(): set memory.embedding.dimension for the embedding model '${model.modelId}'; agentos does not know its output size.`);
+    }
+    return { ...model, dimension };
+}
+/**
+ * Checks, when the agent is built, that cognitive memory has an embedding model
+ * it can use, so a missing or unusable one fails before the first send. Reads
+ * the environment only to pick the provider when `memory.embedding` is unset;
+ * credentials are read when the memory is built.
+ *
+ * @param memory - The agent's memory config.
+ * @param env - The environment to read OPENAI_API_KEY and OLLAMA_BASE_URL from (defaults to `process.env`).
+ * @throws {Error} Naming `memory.embedding` when no provider is set or detected, when the
+ *   provider has no embeddings (Anthropic, Groq, xAI, the Claude Code and Gemini CLIs), when the
+ *   model does not resolve, or when the model's output size is unknown and
+ *   `memory.embedding.dimension` is unset or not a positive integer.
+ */
+export function assertEmbeddingAvailable(memory, env = process.env) {
+    resolveEmbeddingTarget(memory, env);
+}
+/**
+ * The checks on `memory.embedding` that read no environment, for `gmi()` to run
+ * when the agent is built: with a provider set, that it has embeddings, that the
+ * model resolves on it, that a declared dimension is a positive integer, and that
+ * the model's output size is known or declared. With no provider set, the
+ * provider is picked from the environment when the memory is first built, and
+ * only a declared dimension is checked here.
+ *
+ * @param memory - The agent's memory config.
+ * @throws {Error} Naming `memory.embedding`, as {@link assertEmbeddingAvailable} does.
+ */
+export function assertEmbeddingConfig(memory) {
+    if (memory.embedding?.provider) {
+        resolveEmbeddingTarget(memory, {});
+        return;
+    }
+    checkedDimension(memory);
+}
+/** The text the build embeds once to check the embedding model. */
+const PROBE_TEXT = 'cognitive memory embedding check';
+/**
+ * Embeds {@link PROBE_TEXT} once through the provider and model the embedding
+ * manager will call, and fails when the model cannot answer (an Ollama model
+ * that was never pulled, a model the provider does not serve) or answers with
+ * another size than memory expects. Without this check the build succeeds and
+ * memory stays empty: the embedding manager drops each failed or wrong-size
+ * vector, the memory store refuses the trace, and the GMI's memory bridge only
+ * records a trace warning.
+ *
+ * @param provider - The provider the embedding manager will call.
+ * @param model - The resolved provider and model.
+ * @param expected - The vector size memory expects.
+ * @param declared - `memory.embedding.dimension`, when set.
+ */
+async function probeEmbeddingModel(provider, model, expected, declared) {
+    const label = `cognitive memory's embedding model '${model.modelId}' on ${model.providerId}`;
+    let response;
+    try {
+        response = await provider.generateEmbeddings(model.modelId, [PROBE_TEXT]);
+    }
+    catch (error) {
+        throw errorWithCause(`gmi(): ${label} failed a test call (memory.embedding): ${messageOf(error)}`, error);
+    }
+    if (response?.error) {
+        throw errorWithCause(`gmi(): ${label} failed a test call (memory.embedding): ${response.error.message}`, response.error);
+    }
+    const vector = response?.data?.[0]?.embedding;
+    const size = Array.isArray(vector) ? vector.length : 0;
+    if (size === 0) {
+        throw new Error(`gmi(): ${label} returned no vector for a test call (memory.embedding).`);
+    }
+    if (size !== expected) {
+        const expectation = declared !== undefined
+            ? `memory.embedding.dimension (${declared}) declares ${declared}`
+            : `agentos expects ${expected} for this model`;
+        throw new Error(`gmi(): ${label} returns ${size} values, while ${expectation}; set memory.embedding.dimension to ${size}.`);
+    }
+}
+async function buildEmbeddingManager(memory) {
+    const target = resolveEmbeddingTarget(memory, process.env);
+    let resolved;
+    let providerManager;
+    try {
+        resolved = resolveProvider(target.providerId, target.modelId);
+        providerManager = await createProviderManager(resolved);
+    }
+    catch (error) {
+        // The chat model may run on the same provider with other credentials; name the memory's.
+        throw errorWithCause(`gmi(): cognitive memory could not start its embedding provider '${target.providerId}' (memory.embedding): ${messageOf(error)}`, error);
+    }
+    const provider = providerManager.getProvider(resolved.providerId);
+    if (!provider) {
+        throw new Error(`gmi(): cognitive memory's embedding provider '${resolved.providerId}' is not available (memory.embedding).`);
+    }
+    await probeEmbeddingModel(provider, resolved, target.dimension, memory.embedding?.dimension);
+    const manager = new EmbeddingManager();
+    await manager.initialize({
+        embeddingModels: [{ modelId: resolved.modelId, providerId: resolved.providerId, dimension: target.dimension, isDefault: true }],
+        defaultModelId: resolved.modelId,
+        enableCache: true,
+    }, providerManager);
+    return { manager, dimension: target.dimension };
+}
+/**
+ * Builds and initialises the cognitive memory manager an agent's GMIs share.
+ *
+ * @param opts - The persona, the memory config, the mechanisms and an optional embedding manager.
+ * @returns The manager and a `close()` that releases it.
+ * @throws {Error} When the embedding model is missing or unusable (see {@link assertEmbeddingAvailable}),
+ *   when its provider has no credentials or fails to start, when a test embedding through it
+ *   fails or returns another size than memory expects (skipped for an embedding manager the
+ *   caller passes), or when the manager fails to initialise.
+ */
+export async function createAgentCognitiveMemory(opts) {
+    const owned = opts.embeddingManager === undefined;
+    const embedding = opts.embeddingManager
+        ? { manager: opts.embeddingManager, dimension: await opts.embeddingManager.getEmbeddingDimension() }
+        : await buildEmbeddingManager(opts.memory);
+    const storeId = `gmi-memory-${opts.persona.id}`;
+    const vectorStoreConfig = {
+        id: storeId,
+        type: 'in_memory',
+        similarityMetric: 'cosine',
+        defaultEmbeddingDimension: embedding.dimension,
+    };
+    const vectorStore = new InMemoryVectorStore();
+    await vectorStore.initialize(vectorStoreConfig);
+    const knowledgeGraph = new KnowledgeGraph();
+    await knowledgeGraph.initialize();
+    const workingMemory = new InMemoryWorkingMemory();
+    await workingMemory.initialize(storeId);
+    // Canonical trait names (honestyHumility reads as honesty); 0.5 for a trait the persona leaves out.
+    const declared = normalizeHexacoTraits(opts.persona.personalityTraits);
+    const traits = {};
+    for (const key of HEXACO_TRAIT_KEYS)
+        traits[key] = declared[key] ?? 0.5;
+    const consolidationEnabled = opts.memory.consolidation?.enabled === true;
+    if (consolidationEnabled && opts.memory.consolidation?.interval) {
+        console.warn(`[agentos] gmi(): memory.consolidation.interval ('${opts.memory.consolidation.interval}') is not applied; consolidation runs every hour.`);
+    }
+    const config = {
+        workingMemory,
+        knowledgeGraph,
+        vectorStore,
+        embeddingManager: embedding.manager,
+        agentId: opts.persona.id,
+        traits,
+        moodProvider: () => ({ ...NEUTRAL_PAD }),
+        featureDetectionStrategy: 'keyword',
+        graph: { backend: 'knowledge-graph' },
+        ...(opts.mechanisms ? { cognitiveMechanisms: opts.mechanisms } : {}),
+        consolidation: { enabled: consolidationEnabled },
+    };
+    const manager = new CognitiveMemoryManager();
+    await manager.initialize(config);
+    let closing;
+    return {
+        manager,
+        close: () => (closing ?? (closing = (async () => {
+            try {
+                await manager.shutdown();
+            }
+            finally {
+                try {
+                    await vectorStore.shutdown();
+                }
+                finally {
+                    if (owned)
+                        await embedding.manager.shutdown?.();
+                }
+            }
+        })())),
+    };
+}
+//# sourceMappingURL=agentCognitiveMemory.js.map

package/dist/api/runtime/agentCognitiveMemory.js.map

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

package/dist/api/runtime/approval-gate.d.ts

@@ -5,9 +5,12 @@
  * tool loops of `generateText` and `streamText` and the prompt-tool shim call
  * it after `onBeforeToolExecution`, on the arguments that hook left. It never
  * throws: a rejection, a handler error, a timeout, a guardrail block and a
- * received gate that threw all skip the tool. A handler error or an
- * `onTimeout: 'error'` timeout is stored in the owner's slot, which `agency()`
- * checks when its strategy settles.
+ * received gate that threw all skip the tool. A handler error (a throw, an
+ * answer whose `approved` is not a boolean, or a failure after the handler
+ * answered) or an `onTimeout: 'error'` timeout is stored in the owner's slot,
+ * which `agency()` checks when its strategy settles; the model is told only
+ * that the approval handler failed, and the error itself goes to the slot and
+ * `on.error`.
  */
 import type { AgencyOptions, ApprovalDecision, ApprovalRequest } from '../types.js';
 /**
@@ -76,11 +79,13 @@ export interface CreateApprovalGateOptions {
  * (or every tool, for `'*'`), the handler is asked through
  * {@link resolveApprovalDecision}; an approved decision runs the post-approval
  * guardrails over the arguments unless `hitl.guardrailOverride` is `false`.
- * A `modifications.toolArgs` on the decision is not applied: argument
- * rewriting belongs to `onBeforeToolExecution`, which ran first. Once the
- * slot holds an error (the call will reject) or its owner has settled, the
- * gate skips every tool without asking the handler or firing approval
- * events; after settlement it also drops any later error.
+ * An approval that carries `modifications.toolArgs` (anything but `undefined`
+ * or `null`) is refused: the gate never applies other arguments, so the call
+ * is skipped rather than run with the ones the approver meant to replace.
+ * Argument rewriting belongs to `onBeforeToolExecution`, which ran first.
+ * Once the slot holds an error (the call will reject) or its owner has
+ * settled, the gate skips every tool without asking the handler or firing
+ * approval events; after settlement it also drops any later error.
  */
 export declare function createApprovalGate(o: CreateApprovalGateOptions): ApprovalGateFn;
 /**

package/dist/api/runtime/approval-gate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"approval-gate.d.ts","sourceRoot":"","sources":["../../../src/api/runtime/approval-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGpF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,OAAO,MAAoD,CAAC;AAE3F,+DAA+D;AAC/D,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,kCAAkC;AAClC,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,gBAAgB,KAAK,OAAO,CAAC,OAAO,gBAAgB,GAAG,eAAe,CAAC,CAAC;AAE5G,gHAAgH;AAChH,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,yDAAyD;AACzD,wBAAgB,kBAAkB,IAAI,YAAY,CAEjD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,SAAS,CAI9E;AAqBD;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,WAAW,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,EAC9C,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,gBAAgB,CAAC,CA4B3B;AAED,6CAA6C;AAC7C,MAAM,WAAW,yBAAyB;IACxC,kFAAkF;IAClF,IAAI,EAAE,WAAW,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;IACzC,sFAAsF;IACtF,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,EAAE,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;IACxB,+DAA+D;IAC/D,IAAI,EAAE,YAAY,CAAC;IACnB,qGAAqG;IACrG,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,yBAAyB,GAAG,cAAc,CAqE/E;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,gBAAgB,GAAG,eAAe,CAAC,CAOtI"}
+{"version":3,"file":"approval-gate.d.ts","sourceRoot":"","sources":["../../../src/api/runtime/approval-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGpF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,OAAO,MAAoD,CAAC;AAE3F,+DAA+D;AAC/D,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,kCAAkC;AAClC,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,gBAAgB,KAAK,OAAO,CAAC,OAAO,gBAAgB,GAAG,eAAe,CAAC,CAAC;AAE5G,gHAAgH;AAChH,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,yDAAyD;AACzD,wBAAgB,kBAAkB,IAAI,YAAY,CAEjD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,SAAS,CAI9E;AAqCD;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,WAAW,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,EAC9C,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,gBAAgB,CAAC,CA4B3B;AAED,6CAA6C;AAC7C,MAAM,WAAW,yBAAyB;IACxC,kFAAkF;IAClF,IAAI,EAAE,WAAW,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;IACzC,sFAAsF;IACtF,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,EAAE,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;IACxB,+DAA+D;IAC/D,IAAI,EAAE,YAAY,CAAC;IACnB,qGAAqG;IACrG,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,yBAAyB,GAAG,cAAc,CAmG/E;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,gBAAgB,GAAG,eAAe,CAAC,CAOtI"}

package/dist/api/runtime/approval-gate.js

@@ -24,6 +24,15 @@ export function composeReceivedGate(value) {
     return async () => refusal('the received approval gate is not a function');
 }
 const refusal = (reason) => ({ skipped: true, reason });
+/**
+ * What the model is told when the handler fails or an `'error'` timeout
+ * fires. Fixed, because an error's message can name a URL or a credential
+ * (fetch's for a webhook URL that carries one does), and the refusal reason
+ * is sent to the model provider as the tool result.
+ */
+const HANDLER_FAILED = 'the approval handler failed';
+/** Why an approval that names other arguments is refused: the gate approves or refuses, and never applies them. */
+const TOOL_ARGS_NOT_APPLIED = 'the arguments the approval names (modifications.toolArgs) are not applied; rewrite them in onBeforeToolExecution';
 /** Anything but the exact approval is a refusal; a refusal keeps its own string reason. */
 function asVerdict(verdict, fallback) {
     if (verdict === APPROVAL_GRANTED)
@@ -33,6 +42,10 @@ function asVerdict(verdict, fallback) {
         : fallback;
     return refusal(reason);
 }
+/** Whether a handler's answer is a decision: an object whose `approved` is a boolean. */
+function isDecision(answer) {
+    return answer !== null && typeof answer === 'object' && typeof answer.approved === 'boolean';
+}
 function safeCall(fn, event) {
     try {
         fn?.(event);
@@ -83,11 +96,13 @@ export async function resolveApprovalDecision(hitlConfig, request) {
  * (or every tool, for `'*'`), the handler is asked through
  * {@link resolveApprovalDecision}; an approved decision runs the post-approval
  * guardrails over the arguments unless `hitl.guardrailOverride` is `false`.
- * A `modifications.toolArgs` on the decision is not applied: argument
- * rewriting belongs to `onBeforeToolExecution`, which ran first. Once the
- * slot holds an error (the call will reject) or its owner has settled, the
- * gate skips every tool without asking the handler or firing approval
- * events; after settlement it also drops any later error.
+ * An approval that carries `modifications.toolArgs` (anything but `undefined`
+ * or `null`) is refused: the gate never applies other arguments, so the call
+ * is skipped rather than run with the ones the approver meant to replace.
+ * Argument rewriting belongs to `onBeforeToolExecution`, which ran first.
+ * Once the slot holds an error (the call will reject) or its owner has
+ * settled, the gate skips every tool without asking the handler or firing
+ * approval events; after settlement it also drops any later error.
  */
 export function createApprovalGate(o) {
     const listed = o.hitl.approvals?.beforeTool ?? [];
@@ -116,6 +131,11 @@ export function createApprovalGate(o) {
             const parent = asVerdict(verdict, 'not approved by the parent agency');
             if (parent !== APPROVAL_GRANTED)
                 return parent;
+            // The parent's approval can arrive after this call ended (a concurrent
+            // approval failed, or the owner settled): it runs nothing and asks no one.
+            const afterParent = stopped();
+            if (afterParent)
+                return afterParent;
         }
         if (!covers(info.name))
             return APPROVAL_GRANTED;
@@ -129,40 +149,70 @@ export function createApprovalGate(o) {
             context: { agentCalls: [], totalTokens: 0, totalCostUSD: 0, elapsedMs: 0 },
         };
         safeCall(o.on?.approvalRequested, request);
-        let decision;
-        try {
-            decision = await resolveApprovalDecision(o.hitl, request);
-        }
-        catch (err) {
+        /**
+         * A handler error. Before settlement the first is stored in the slot and
+         * each one goes to `on.error`; the model is told only that the handler
+         * failed.
+         */
+        const failed = (err) => {
             if (!o.slot.settled) {
                 // A rejection with no reason still fails the call.
                 if (o.slot.error === undefined)
                     o.slot.error = err === undefined ? new AgencyConfigError('HITL approval failed') : err;
                 safeCall(o.on?.error, { agent: o.agentName, error: err instanceof Error ? err : new Error(String(err)), timestamp: Date.now() });
             }
-            return refusal(err instanceof Error ? err.message : 'approval failed');
+            return refusal(HANDLER_FAILED);
+        };
+        let decision;
+        try {
+            const answer = await resolveApprovalDecision(o.hitl, request);
+            // An answer whose `approved` is not a boolean (a webhook that answers
+            // `null`, a string) is a handler error, never an approval.
+            if (!isDecision(answer))
+                throw new AgencyConfigError('HITL handler returned a malformed decision: approved must be a boolean');
+            decision = answer;
+        }
+        catch (err) {
+            return failed(err);
         }
         // A decision that arrives after the call ended (a concurrent approval
         // failed, or the owner settled) fires nothing and runs nothing.
         const late = stopped();
         if (late)
             return late;
-        safeCall(o.on?.approvalDecided, decision);
-        if (!decision.approved)
-            return refusal(decision.reason ?? 'rejected by the approval handler');
-        if (o.hitl.guardrailOverride !== false) {
-            const { runPostApprovalGuardrails } = await import('../agency.js');
-            const result = await runPostApprovalGuardrails(info.name, info.args, o.hitl.postApprovalGuardrails ?? ['pii-redaction', 'code-safety'], o.on);
-            // The guardrail check is awaited: a call that ended meanwhile fires nothing.
-            const afterGuardrails = stopped();
-            if (afterGuardrails)
-                return afterGuardrails;
-            if (!result.passed) {
-                safeCall(o.on?.guardrailHitlOverride, { guardrailId: result.guardrailId, reason: result.reason, toolName: info.name, timestamp: Date.now() });
-                return refusal(`guardrail ${result.guardrailId}: ${result.reason}`);
+        try {
+            safeCall(o.on?.approvalDecided, decision);
+            if (!decision.approved)
+                return refusal(decision.reason ?? 'rejected by the approval handler');
+            // Arguments are rewritten in onBeforeToolExecution, never by a decision:
+            // an approval that names other arguments is refused, so the call never
+            // runs with the ones the approver meant to replace.
+            if (decision.modifications?.toolArgs != null)
+                return refusal(TOOL_ARGS_NOT_APPLIED);
+            if (o.hitl.guardrailOverride !== false) {
+                const { runPostApprovalGuardrails } = await import('../agency.js');
+                // The import yields, and the guardrails fire their events as soon as
+                // they run: a call that ended meanwhile runs none of them.
+                const beforeGuardrails = stopped();
+                if (beforeGuardrails)
+                    return beforeGuardrails;
+                const result = await runPostApprovalGuardrails(info.name, info.args, o.hitl.postApprovalGuardrails ?? ['pii-redaction', 'code-safety'], o.on);
+                // The guardrail check is awaited: a call that ended meanwhile fires nothing.
+                const afterGuardrails = stopped();
+                if (afterGuardrails)
+                    return afterGuardrails;
+                if (!result.passed) {
+                    safeCall(o.on?.guardrailHitlOverride, { guardrailId: result.guardrailId, reason: result.reason, toolName: info.name, timestamp: Date.now() });
+                    return refusal(`guardrail ${result.guardrailId}: ${result.reason}`);
+                }
             }
+            return stopped() ?? APPROVAL_GRANTED;
+        }
+        catch (err) {
+            // A failure after the handler answered (arguments the guardrails cannot
+            // serialize, such as a BigInt a hook added) is a handler error too.
+            return failed(err);
         }
-        return stopped() ?? APPROVAL_GRANTED;
     };
 }
 /**

package/dist/api/runtime/approval-gate.js.map

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