@nhtio/adk 0.1.0-master-2a4e1bd2 → 0.1.0-master-cd595e6f

package/batteries/llm/claude_code_cli/helpers.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../../chunk-Cek0wNdY.js");
-const require_tool_call = require("../../../tool_call-DgqVwL5n.js");
-require("../../../common-BV3HGeLj.js");
-const require_helpers = require("../../../helpers-Tvvwpx1M.js");
+const require_tool_call = require("../../../tool_call-Fs_Uh5wQ.js");
+require("../../../common-H44Ik9ou.js");
+const require_helpers = require("../../../helpers-CEjjkXso.js");
 const require_batteries_llm_claude_code_cli_exceptions = require("./exceptions.cjs");
 //#region src/batteries/llm/claude_code_cli/helpers.ts
 /**

package/batteries/llm/claude_code_cli/helpers.mjs

@@ -1,6 +1,6 @@
-import { n as Media } from "../../../tool_call-CPjyvkm4.mjs";
-import "../../../common-v9Jo9M5k.mjs";
-import { A as renderMemories, B as retrievableToAttrs, C as looksLikeSpooledArtifact, D as renderArtifactHandleBody, F as renderThirdPartyPrivateRetrievables, G as toolsToChatCompletionsTools, H as sanitizeFilenameForDescription, I as renderThirdPartyPublicRetrievables, L as renderThought, M as renderRetrievableSafetyDirective, N as renderRetrievables, O as renderChatCompletionsSystemPrompt, P as renderStandingInstructions, R as renderTrustedContent, S as floorTrustTier, T as neutraliseDeveloperRulesTag, U as sanitizeMimeType, _ as defaultRenderUntrustedContent, a as defaultRenderArtifactHandleBody, b as escapeXmlAttribute, c as defaultRenderMemories, d as defaultRenderRetrievables, f as defaultRenderStandingInstructions, g as defaultRenderTrustedContent, h as defaultRenderThought, i as defaultFilterThoughts, j as renderRetrievableHandleBody, k as renderFirstPartyRetrievables, l as defaultRenderRetrievableHandleBody, m as defaultRenderThirdPartyPublicRetrievables, o as defaultRenderChatCompletionsSystemPrompt, p as defaultRenderThirdPartyPrivateRetrievables, r as defaultDescriptionToChatCompletionsJsonSchema, s as defaultRenderFirstPartyRetrievables, u as defaultRenderRetrievableSafetyDirective, v as defaultToolsToChatCompletionsTools, w as memoryToAttrs, x as filterThoughts, y as descriptionToChatCompletionsJsonSchema, z as renderUntrustedContent } from "../../../helpers-CDmLDBq5.mjs";
+import { n as Media } from "../../../tool_call-Cfaj-6zK.mjs";
+import "../../../common-BpdHIpQE.mjs";
+import { A as renderMemories, B as retrievableToAttrs, C as looksLikeSpooledArtifact, D as renderArtifactHandleBody, F as renderThirdPartyPrivateRetrievables, G as toolsToChatCompletionsTools, H as sanitizeFilenameForDescription, I as renderThirdPartyPublicRetrievables, L as renderThought, M as renderRetrievableSafetyDirective, N as renderRetrievables, O as renderChatCompletionsSystemPrompt, P as renderStandingInstructions, R as renderTrustedContent, S as floorTrustTier, T as neutraliseDeveloperRulesTag, U as sanitizeMimeType, _ as defaultRenderUntrustedContent, a as defaultRenderArtifactHandleBody, b as escapeXmlAttribute, c as defaultRenderMemories, d as defaultRenderRetrievables, f as defaultRenderStandingInstructions, g as defaultRenderTrustedContent, h as defaultRenderThought, i as defaultFilterThoughts, j as renderRetrievableHandleBody, k as renderFirstPartyRetrievables, l as defaultRenderRetrievableHandleBody, m as defaultRenderThirdPartyPublicRetrievables, o as defaultRenderChatCompletionsSystemPrompt, p as defaultRenderThirdPartyPrivateRetrievables, r as defaultDescriptionToChatCompletionsJsonSchema, s as defaultRenderFirstPartyRetrievables, u as defaultRenderRetrievableSafetyDirective, v as defaultToolsToChatCompletionsTools, w as memoryToAttrs, x as filterThoughts, y as descriptionToChatCompletionsJsonSchema, z as renderUntrustedContent } from "../../../helpers-BH7HTtkD.mjs";
 import { E_CLAUDE_CODE_CLI_UNSUPPORTED_MEDIA_MODALITY } from "./exceptions.mjs";
 //#region src/batteries/llm/claude_code_cli/helpers.ts
 /**

package/batteries/llm/claude_code_cli/types.d.ts

@@ -12,7 +12,8 @@
  * harnesses) and is re-exported here for convenience.
  */
 import type { ClaudeCodeCliExtraArg } from "./wire";
-import type { SpoolStore, TokenEncoding } from "../../../common";
+import type { SpoolStore } from "../../../common";
+import type { TokenEncodingId } from "../../../types";
 import type { ChatCompletionsBucketOrder, UnsupportedMediaPolicy, ChatHelpersCommon } from "../chat_common/types";
 import type { Tokenizable, Memory, Message, Thought, ToolCall, Retrievable, Tool, ArtifactTool, ToolRegistry, SpooledArtifact, Media } from "../../../common";
 export type { DescriptionLike, JsonSchema, UntrustedContentAttrs, TrustedContentAttrs, StandingInstructionAttrs, MemoryAttrs, RetrievableAttrs, ThoughtAttrs, ChatCompletionsBucketLabel, ChatCompletionsBucketOrder, ChatCompletionsTool, UnsupportedMediaPolicy, ChatCompletionsRetryConfig, ChatHelpersCommon, } from "../chat_common/types";
@@ -168,7 +169,7 @@ export interface ClaudeCodeCliAdapterOptions {
     /** Size of the model's token context window for the ADK pre-flight guard. */
     contextWindow?: number;
     /** Tokenizer encoding configuration for token counting. */
-    tokenEncoding?: TokenEncoding | null;
+    tokenEncoding?: TokenEncodingId | null;
     /**
      * @deprecated Single-turn dispatch is the fixed battery contract. Only `1` is accepted; the
      * option is ignored because argv always carries `--max-turns 1`.

package/batteries/llm/claude_code_cli/validation.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../../chunk-Cek0wNdY.js");
-const require_tokenizable = require("../../../tokenizable-CWW7iSrD.js");
-const require_common = require("../../../common-BV3HGeLj.js");
+const require_tokenizable = require("../../../tokenizable-BMZuGWRd.js");
+const require_common = require("../../../common-H44Ik9ou.js");
 require("../../../guards.cjs");
 const require_batteries_llm_claude_code_cli_exceptions = require("./exceptions.cjs");
 let _nhtio_validation = require("@nhtio/validation");
@@ -13,7 +13,7 @@ var bucketOrderSchema = _nhtio_validation.validator.array().items(bucketLabelSch
 	"retrievables",
 	"timeline"
 ]);
-var tokenEncodingSchema = _nhtio_validation.validator.alternatives(_nhtio_validation.validator.string().valid(...require_tokenizable.TokenEncoding), _nhtio_validation.validator.any().valid(null).optional()).default(null);
+var tokenEncodingSchema = _nhtio_validation.validator.alternatives(_nhtio_validation.validator.string().min(1).description(`Known encodings: ${require_tokenizable.TokenEncoding.join(", ")}`), _nhtio_validation.validator.any().valid(null).optional()).default(null);
 var unsupportedMediaPolicySchema = _nhtio_validation.validator.alternatives(_nhtio_validation.validator.string().valid("throw", "fallback-stash", "synthetic-description"), _nhtio_validation.validator.object({
 	mode: _nhtio_validation.validator.string().valid("fallback-stash").required(),
 	stashKeys: _nhtio_validation.validator.array().items(_nhtio_validation.validator.string().min(1)).required()

package/batteries/llm/claude_code_cli/validation.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"validation.cjs","names":[],"sources":["../../../../src/batteries/llm/claude_code_cli/validation.ts"],"sourcesContent":["/**\n * Runtime validation schema and wrapper for Claude Code CLI adapter options.\n *\n * @module @nhtio/adk/batteries/llm/claude_code_cli/validation\n *\n * @remarks\n * Schema and call-site wrapper for validating `ClaudeCodeCliAdapterOptions`. Used at construction\n * time and at the start of every iteration against the merged options shape (stash > executor >\n * constructor). Throws `E_INVALID_CLAUDE_CODE_CLI_OPTIONS` on failure — same hard-fail policy as\n * every other ADK contract.\n *\n * Three invariants enforced here that have no equivalent in the other LLM batteries:\n * - `apiKey`/`authToken` are mutually exclusive AND at least one is required (`.xor`).\n * - `extraArgs` entries are validated against a strict six-flag allowlist, with per-flag value\n *   arity, and every value string is rejected if it starts with `-` — the fix for the `--betas`\n *   variadic-value injection hazard (a value string spelling another flag would otherwise reach\n *   the CLI's own argv parser as a distinct token).\n * - `process.platform` is checked at validation time: this battery is POSIX-only in v1 (reliable\n *   process-group control requires POSIX process groups), mirroring\n *   `src/batteries/sandbox/node/srt_enforcer.ts`'s own platform-boundary precedent.\n */\n\nimport { isError } from '@nhtio/adk/guards'\nimport { validator, ValidationError } from '@nhtio/validation'\nimport { E_INVALID_CLAUDE_CODE_CLI_OPTIONS } from './exceptions'\nimport { byteStoreSchema, TokenEncoding } from '@nhtio/adk/common'\nimport type { ClaudeCodeCliAdapterOptions } from './types'\n\n// ─── Sub-schemas ──────────────────────────────────────────────────────────────\n\nconst bucketLabelSchema = validator\n  .string()\n  .valid('standingInstructions', 'memories', 'retrievables', 'timeline')\n\nconst bucketOrderSchema = validator\n  .array()\n  .items(bucketLabelSchema)\n  .unique()\n  .default(['standingInstructions', 'memories', 'retrievables', 'timeline'])\n\nconst tokenEncodingSchema = validator\n  .alternatives(validator.string().valid(...TokenEncoding), validator.any().valid(null).optional())\n  .default(null)\n\nconst unsupportedMediaPolicySchema = validator\n  .alternatives(\n    validator.string().valid('throw', 'fallback-stash', 'synthetic-description'),\n    validator\n      .object({\n        mode: validator.string().valid('fallback-stash').required(),\n        stashKeys: validator.array().items(validator.string().min(1)).required(),\n      })\n      .unknown(false)\n  )\n  .default('throw')\n\nconst helperSchema = validator.function()\n\nconst helpersSchema = validator\n  .object({\n    descriptionToChatCompletionsJsonSchema: helperSchema.optional(),\n    renderUntrustedContent: helperSchema.optional(),\n    renderTrustedContent: helperSchema.optional(),\n    renderStandingInstructions: helperSchema.optional(),\n    renderMemories: helperSchema.optional(),\n    renderRetrievables: helperSchema.optional(),\n    renderRetrievableHandleBody: helperSchema.optional(),\n    renderRetrievableSafetyDirective: helperSchema.optional(),\n    renderFirstPartyRetrievables: helperSchema.optional(),\n    renderThirdPartyPublicRetrievables: helperSchema.optional(),\n    renderThirdPartyPrivateRetrievables: helperSchema.optional(),\n    renderThought: helperSchema.optional(),\n    filterThoughts: helperSchema.optional(),\n    toolsToChatCompletionsTools: helperSchema.optional(),\n    renderChatCompletionsSystemPrompt: helperSchema.optional(),\n    renderClaudeCodeCliTimelineMessage: helperSchema.optional(),\n    renderClaudeCodeCliToolCallResult: helperSchema.optional(),\n    buildClaudeCodeCliPrompt: helperSchema.optional(),\n  })\n  .unknown(false)\n\n// `extraArgs`: a structured allowlist, not a flat string[]. Every value string, in every\n// position, is rejected if it starts with `-` — the fix for the --betas injection hazard.\nconst NOT_A_FLAG_RE = /^(?!-).+$/\n\nconst singleValueSchema = validator.string().min(1).pattern(NOT_A_FLAG_RE)\nconst multiValueSchema = validator\n  .array()\n  .items(validator.string().min(1).pattern(NOT_A_FLAG_RE))\n  .min(1)\n\nconst extraArgSchema = validator\n  .alternatives(\n    // --betas is the only flag accepting a string[] value.\n    validator\n      .object({\n        flag: validator.string().valid('--betas').required(),\n        value: multiValueSchema.required(),\n      })\n      .unknown(false),\n    // --prompt-suggestions is the only flag with an OPTIONAL value.\n    validator\n      .object({\n        flag: validator.string().valid('--prompt-suggestions').required(),\n        value: singleValueSchema.optional(),\n      })\n      .unknown(false),\n    // Every remaining allowlisted flag requires a single non-empty, non-flag-shaped string value.\n    validator\n      .object({\n        flag: validator.string().valid('--effort', '--agent', '--json-schema', '--name').required(),\n        value: singleValueSchema.required(),\n      })\n      .unknown(false)\n  )\n  .required()\n\nconst extraArgsSchema = validator.array().items(extraArgSchema).optional()\n\n// ─── Top-level schema ─────────────────────────────────────────────────────────\n\n/**\n * Validator schema for `ClaudeCodeCliAdapterOptions`. Used by `validateOptions` at construction\n * time and again at the start of every iteration after options have been merged (stash > executor\n * > constructor). Rejects unknown top-level keys so typos fail loud.\n */\nexport const claudeCodeCliOptionsSchema = validator\n  .object<ClaudeCodeCliAdapterOptions>({\n    // ADK control\n    execa: validator.function().optional(),\n    wrapperPath: validator.string().optional(),\n    claudeBin: validator.string().default('claude'),\n    appendSystemPrompt: validator.string().optional(),\n    apiKey: validator.string().optional(),\n    authToken: validator.string().optional(),\n    baseURL: validator.string().optional(),\n    cwd: validator.string().optional(),\n    addDir: validator.array().items(validator.string().min(1)).optional(),\n    disallowedTools: validator.array().items(validator.string().min(1)).default([]),\n    maxTurns: validator\n      .number()\n      .valid(1)\n      .messages({\n        'any.only':\n          'maxTurns is deprecated and inert: single-turn dispatch is the fixed battery contract; ' +\n          'only maxTurns: 1 is accepted, and the option is ignored because argv always carries --max-turns 1.',\n      })\n      .optional(),\n    contextWindow: validator.number().integer().min(1).optional(),\n    tokenEncoding: tokenEncodingSchema,\n    maxBudgetUsd: validator.number().min(0).optional(),\n    fallbackModel: validator.array().items(validator.string().min(1)).optional(),\n    selfIdentity: validator.string().min(1).default('assistant'),\n    autoAck: validator.boolean().default(false),\n    forwardSubagentText: validator.boolean().default(false),\n    bucketOrder: bucketOrderSchema,\n    thoughtSurfacing: validator\n      .string()\n      .valid('all-self', 'latest-self', 'all')\n      .default('all-self'),\n    replayCompatibility: validator.array().items(validator.string().min(1)).default([]),\n    helpers: helpersSchema.optional(),\n    spoolStore: byteStoreSchema.optional(),\n    unsupportedMediaPolicy: unsupportedMediaPolicySchema,\n    unsupportedResultMediaPolicy: unsupportedMediaPolicySchema,\n    extraArgs: extraArgsSchema,\n\n    // CLI-native safety caps / timeouts\n    streamIdleTimeoutMs: validator.number().integer().min(0).default(60_000),\n    startupTimeoutMs: validator.number().integer().min(0).default(45_000),\n    disposeGraceMs: validator.number().integer().min(0).default(2_000),\n    mcpToolIdleTimeoutMs: validator.number().integer().min(0).optional(),\n    disableTelemetry: validator.boolean().optional(),\n    disableErrorReporting: validator.boolean().optional(),\n    disableNonessentialTraffic: validator.boolean().optional(),\n\n    // Required\n    model: validator.string().required(),\n  })\n  .unknown(false)\n  // Exactly one of apiKey/authToken must be set.\n  .xor('apiKey', 'authToken')\n  // POSIX-only in v1: reliable process-group control requires POSIX process groups, mirroring\n  // src/batteries/sandbox/node/srt_enforcer.ts's own platform-boundary precedent — refuse rather\n  // than silently degrade.\n  .custom((value, helpers) => {\n    // POSIX-only in v1: reliable process-group control requires process.kill(-pid, signal),\n    // which has no Windows equivalent — refuse rather than silently degrade, mirroring\n    // src/batteries/sandbox/node/srt_enforcer.ts's own platform-boundary precedent.\n    if (process.platform !== 'darwin' && process.platform !== 'linux') {\n      return helpers.error('any.invalid')\n    }\n    return value\n  })\n\nconst isValidationError = (value: unknown): value is ValidationError =>\n  isError(value) && Array.isArray((value as ValidationError).details)\n\nconst formatValidationDetails = (err: ValidationError): string =>\n  err.details.map((d) => d.message).join(' and ')\n\n/**\n * Validates an arbitrary input against `claudeCodeCliOptionsSchema` and returns the resolved\n * options shape. Throws `E_INVALID_CLAUDE_CODE_CLI_OPTIONS` (carrying the validator's error\n * report on `cause`) on failure.\n *\n * @param input - The raw options object to validate.\n * @returns The resolved options object with defaults filled in.\n */\nexport const validateOptions = (input: unknown): ClaudeCodeCliAdapterOptions => {\n  const { value, error } = claudeCodeCliOptionsSchema.validate(input, {\n    abortEarly: false,\n    convert: false,\n  })\n  if (error) {\n    throw new E_INVALID_CLAUDE_CODE_CLI_OPTIONS([formatValidationDetails(error)], { cause: error })\n  }\n  return value as ClaudeCodeCliAdapterOptions\n}\n\n// suppress unused import warning when the alias isn't referenced\nvoid isValidationError\n"],"mappings":"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"}
+{"version":3,"file":"validation.cjs","names":[],"sources":["../../../../src/batteries/llm/claude_code_cli/validation.ts"],"sourcesContent":["/**\n * Runtime validation schema and wrapper for Claude Code CLI adapter options.\n *\n * @module @nhtio/adk/batteries/llm/claude_code_cli/validation\n *\n * @remarks\n * Schema and call-site wrapper for validating `ClaudeCodeCliAdapterOptions`. Used at construction\n * time and at the start of every iteration against the merged options shape (stash > executor >\n * constructor). Throws `E_INVALID_CLAUDE_CODE_CLI_OPTIONS` on failure — same hard-fail policy as\n * every other ADK contract.\n *\n * Three invariants enforced here that have no equivalent in the other LLM batteries:\n * - `apiKey`/`authToken` are mutually exclusive AND at least one is required (`.xor`).\n * - `extraArgs` entries are validated against a strict six-flag allowlist, with per-flag value\n *   arity, and every value string is rejected if it starts with `-` — the fix for the `--betas`\n *   variadic-value injection hazard (a value string spelling another flag would otherwise reach\n *   the CLI's own argv parser as a distinct token).\n * - `process.platform` is checked at validation time: this battery is POSIX-only in v1 (reliable\n *   process-group control requires POSIX process groups), mirroring\n *   `src/batteries/sandbox/node/srt_enforcer.ts`'s own platform-boundary precedent.\n */\n\nimport { isError } from '@nhtio/adk/guards'\nimport { validator, ValidationError } from '@nhtio/validation'\nimport { E_INVALID_CLAUDE_CODE_CLI_OPTIONS } from './exceptions'\nimport { byteStoreSchema, TokenEncoding } from '@nhtio/adk/common'\nimport type { ClaudeCodeCliAdapterOptions } from './types'\n\n// ─── Sub-schemas ──────────────────────────────────────────────────────────────\n\nconst bucketLabelSchema = validator\n  .string()\n  .valid('standingInstructions', 'memories', 'retrievables', 'timeline')\n\nconst bucketOrderSchema = validator\n  .array()\n  .items(bucketLabelSchema)\n  .unique()\n  .default(['standingInstructions', 'memories', 'retrievables', 'timeline'])\n\nconst tokenEncodingSchema = validator\n  .alternatives(\n    // Known values are suggestions from the canonical list, not a whitelist: consumers may provide\n    // a custom or newer tokenizer name. The field accepts any non-empty string, explicit null, or\n    // absent (undefined = \"no token counting\"). `.optional()` preserves the null/undefined\n    // disposition required by adk/require-validator-any-required.\n    validator\n      .string()\n      .min(1)\n      .description(`Known encodings: ${TokenEncoding.join(', ')}`),\n    validator.any().valid(null).optional()\n  )\n  .default(null)\n\nconst unsupportedMediaPolicySchema = validator\n  .alternatives(\n    validator.string().valid('throw', 'fallback-stash', 'synthetic-description'),\n    validator\n      .object({\n        mode: validator.string().valid('fallback-stash').required(),\n        stashKeys: validator.array().items(validator.string().min(1)).required(),\n      })\n      .unknown(false)\n  )\n  .default('throw')\n\nconst helperSchema = validator.function()\n\nconst helpersSchema = validator\n  .object({\n    descriptionToChatCompletionsJsonSchema: helperSchema.optional(),\n    renderUntrustedContent: helperSchema.optional(),\n    renderTrustedContent: helperSchema.optional(),\n    renderStandingInstructions: helperSchema.optional(),\n    renderMemories: helperSchema.optional(),\n    renderRetrievables: helperSchema.optional(),\n    renderRetrievableHandleBody: helperSchema.optional(),\n    renderRetrievableSafetyDirective: helperSchema.optional(),\n    renderFirstPartyRetrievables: helperSchema.optional(),\n    renderThirdPartyPublicRetrievables: helperSchema.optional(),\n    renderThirdPartyPrivateRetrievables: helperSchema.optional(),\n    renderThought: helperSchema.optional(),\n    filterThoughts: helperSchema.optional(),\n    toolsToChatCompletionsTools: helperSchema.optional(),\n    renderChatCompletionsSystemPrompt: helperSchema.optional(),\n    renderClaudeCodeCliTimelineMessage: helperSchema.optional(),\n    renderClaudeCodeCliToolCallResult: helperSchema.optional(),\n    buildClaudeCodeCliPrompt: helperSchema.optional(),\n  })\n  .unknown(false)\n\n// `extraArgs`: a structured allowlist, not a flat string[]. Every value string, in every\n// position, is rejected if it starts with `-` — the fix for the --betas injection hazard.\nconst NOT_A_FLAG_RE = /^(?!-).+$/\n\nconst singleValueSchema = validator.string().min(1).pattern(NOT_A_FLAG_RE)\nconst multiValueSchema = validator\n  .array()\n  .items(validator.string().min(1).pattern(NOT_A_FLAG_RE))\n  .min(1)\n\nconst extraArgSchema = validator\n  .alternatives(\n    // --betas is the only flag accepting a string[] value.\n    validator\n      .object({\n        flag: validator.string().valid('--betas').required(),\n        value: multiValueSchema.required(),\n      })\n      .unknown(false),\n    // --prompt-suggestions is the only flag with an OPTIONAL value.\n    validator\n      .object({\n        flag: validator.string().valid('--prompt-suggestions').required(),\n        value: singleValueSchema.optional(),\n      })\n      .unknown(false),\n    // Every remaining allowlisted flag requires a single non-empty, non-flag-shaped string value.\n    validator\n      .object({\n        flag: validator.string().valid('--effort', '--agent', '--json-schema', '--name').required(),\n        value: singleValueSchema.required(),\n      })\n      .unknown(false)\n  )\n  .required()\n\nconst extraArgsSchema = validator.array().items(extraArgSchema).optional()\n\n// ─── Top-level schema ─────────────────────────────────────────────────────────\n\n/**\n * Validator schema for `ClaudeCodeCliAdapterOptions`. Used by `validateOptions` at construction\n * time and again at the start of every iteration after options have been merged (stash > executor\n * > constructor). Rejects unknown top-level keys so typos fail loud.\n */\nexport const claudeCodeCliOptionsSchema = validator\n  .object<ClaudeCodeCliAdapterOptions>({\n    // ADK control\n    execa: validator.function().optional(),\n    wrapperPath: validator.string().optional(),\n    claudeBin: validator.string().default('claude'),\n    appendSystemPrompt: validator.string().optional(),\n    apiKey: validator.string().optional(),\n    authToken: validator.string().optional(),\n    baseURL: validator.string().optional(),\n    cwd: validator.string().optional(),\n    addDir: validator.array().items(validator.string().min(1)).optional(),\n    disallowedTools: validator.array().items(validator.string().min(1)).default([]),\n    maxTurns: validator\n      .number()\n      .valid(1)\n      .messages({\n        'any.only':\n          'maxTurns is deprecated and inert: single-turn dispatch is the fixed battery contract; ' +\n          'only maxTurns: 1 is accepted, and the option is ignored because argv always carries --max-turns 1.',\n      })\n      .optional(),\n    contextWindow: validator.number().integer().min(1).optional(),\n    tokenEncoding: tokenEncodingSchema,\n    maxBudgetUsd: validator.number().min(0).optional(),\n    fallbackModel: validator.array().items(validator.string().min(1)).optional(),\n    selfIdentity: validator.string().min(1).default('assistant'),\n    autoAck: validator.boolean().default(false),\n    forwardSubagentText: validator.boolean().default(false),\n    bucketOrder: bucketOrderSchema,\n    thoughtSurfacing: validator\n      .string()\n      .valid('all-self', 'latest-self', 'all')\n      .default('all-self'),\n    replayCompatibility: validator.array().items(validator.string().min(1)).default([]),\n    helpers: helpersSchema.optional(),\n    spoolStore: byteStoreSchema.optional(),\n    unsupportedMediaPolicy: unsupportedMediaPolicySchema,\n    unsupportedResultMediaPolicy: unsupportedMediaPolicySchema,\n    extraArgs: extraArgsSchema,\n\n    // CLI-native safety caps / timeouts\n    streamIdleTimeoutMs: validator.number().integer().min(0).default(60_000),\n    startupTimeoutMs: validator.number().integer().min(0).default(45_000),\n    disposeGraceMs: validator.number().integer().min(0).default(2_000),\n    mcpToolIdleTimeoutMs: validator.number().integer().min(0).optional(),\n    disableTelemetry: validator.boolean().optional(),\n    disableErrorReporting: validator.boolean().optional(),\n    disableNonessentialTraffic: validator.boolean().optional(),\n\n    // Required\n    model: validator.string().required(),\n  })\n  .unknown(false)\n  // Exactly one of apiKey/authToken must be set.\n  .xor('apiKey', 'authToken')\n  // POSIX-only in v1: reliable process-group control requires POSIX process groups, mirroring\n  // src/batteries/sandbox/node/srt_enforcer.ts's own platform-boundary precedent — refuse rather\n  // than silently degrade.\n  .custom((value, helpers) => {\n    // POSIX-only in v1: reliable process-group control requires process.kill(-pid, signal),\n    // which has no Windows equivalent — refuse rather than silently degrade, mirroring\n    // src/batteries/sandbox/node/srt_enforcer.ts's own platform-boundary precedent.\n    if (process.platform !== 'darwin' && process.platform !== 'linux') {\n      return helpers.error('any.invalid')\n    }\n    return value\n  })\n\nconst isValidationError = (value: unknown): value is ValidationError =>\n  isError(value) && Array.isArray((value as ValidationError).details)\n\nconst formatValidationDetails = (err: ValidationError): string =>\n  err.details.map((d) => d.message).join(' and ')\n\n/**\n * Validates an arbitrary input against `claudeCodeCliOptionsSchema` and returns the resolved\n * options shape. Throws `E_INVALID_CLAUDE_CODE_CLI_OPTIONS` (carrying the validator's error\n * report on `cause`) on failure.\n *\n * @param input - The raw options object to validate.\n * @returns The resolved options object with defaults filled in.\n */\nexport const validateOptions = (input: unknown): ClaudeCodeCliAdapterOptions => {\n  const { value, error } = claudeCodeCliOptionsSchema.validate(input, {\n    abortEarly: false,\n    convert: false,\n  })\n  if (error) {\n    throw new E_INVALID_CLAUDE_CODE_CLI_OPTIONS([formatValidationDetails(error)], { cause: error })\n  }\n  return value as ClaudeCodeCliAdapterOptions\n}\n\n// suppress unused import warning when the alias isn't referenced\nvoid isValidationError\n"],"mappings":"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"}

package/batteries/llm/claude_code_cli/validation.mjs

@@ -1,5 +1,5 @@
-import { n as TokenEncoding } from "../../../tokenizable-DLMP68ZV.mjs";
-import { o as byteStoreSchema } from "../../../common-v9Jo9M5k.mjs";
+import { n as TokenEncoding } from "../../../tokenizable-VB4Av8GF.mjs";
+import { o as byteStoreSchema } from "../../../common-BpdHIpQE.mjs";
 import "../../../guards.mjs";
 import { E_INVALID_CLAUDE_CODE_CLI_OPTIONS } from "./exceptions.mjs";
 import { validator } from "@nhtio/validation";
@@ -11,7 +11,7 @@ var bucketOrderSchema = validator.array().items(bucketLabelSchema).unique().defa
 	"retrievables",
 	"timeline"
 ]);
-var tokenEncodingSchema = validator.alternatives(validator.string().valid(...TokenEncoding), validator.any().valid(null).optional()).default(null);
+var tokenEncodingSchema = validator.alternatives(validator.string().min(1).description(`Known encodings: ${TokenEncoding.join(", ")}`), validator.any().valid(null).optional()).default(null);
 var unsupportedMediaPolicySchema = validator.alternatives(validator.string().valid("throw", "fallback-stash", "synthetic-description"), validator.object({
 	mode: validator.string().valid("fallback-stash").required(),
 	stashKeys: validator.array().items(validator.string().min(1)).required()

package/batteries/llm/claude_code_cli/validation.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"validation.mjs","names":[],"sources":["../../../../src/batteries/llm/claude_code_cli/validation.ts"],"sourcesContent":["/**\n * Runtime validation schema and wrapper for Claude Code CLI adapter options.\n *\n * @module @nhtio/adk/batteries/llm/claude_code_cli/validation\n *\n * @remarks\n * Schema and call-site wrapper for validating `ClaudeCodeCliAdapterOptions`. Used at construction\n * time and at the start of every iteration against the merged options shape (stash > executor >\n * constructor). Throws `E_INVALID_CLAUDE_CODE_CLI_OPTIONS` on failure — same hard-fail policy as\n * every other ADK contract.\n *\n * Three invariants enforced here that have no equivalent in the other LLM batteries:\n * - `apiKey`/`authToken` are mutually exclusive AND at least one is required (`.xor`).\n * - `extraArgs` entries are validated against a strict six-flag allowlist, with per-flag value\n *   arity, and every value string is rejected if it starts with `-` — the fix for the `--betas`\n *   variadic-value injection hazard (a value string spelling another flag would otherwise reach\n *   the CLI's own argv parser as a distinct token).\n * - `process.platform` is checked at validation time: this battery is POSIX-only in v1 (reliable\n *   process-group control requires POSIX process groups), mirroring\n *   `src/batteries/sandbox/node/srt_enforcer.ts`'s own platform-boundary precedent.\n */\n\nimport { isError } from '@nhtio/adk/guards'\nimport { validator, ValidationError } from '@nhtio/validation'\nimport { E_INVALID_CLAUDE_CODE_CLI_OPTIONS } from './exceptions'\nimport { byteStoreSchema, TokenEncoding } from '@nhtio/adk/common'\nimport type { ClaudeCodeCliAdapterOptions } from './types'\n\n// ─── Sub-schemas ──────────────────────────────────────────────────────────────\n\nconst bucketLabelSchema = validator\n  .string()\n  .valid('standingInstructions', 'memories', 'retrievables', 'timeline')\n\nconst bucketOrderSchema = validator\n  .array()\n  .items(bucketLabelSchema)\n  .unique()\n  .default(['standingInstructions', 'memories', 'retrievables', 'timeline'])\n\nconst tokenEncodingSchema = validator\n  .alternatives(validator.string().valid(...TokenEncoding), validator.any().valid(null).optional())\n  .default(null)\n\nconst unsupportedMediaPolicySchema = validator\n  .alternatives(\n    validator.string().valid('throw', 'fallback-stash', 'synthetic-description'),\n    validator\n      .object({\n        mode: validator.string().valid('fallback-stash').required(),\n        stashKeys: validator.array().items(validator.string().min(1)).required(),\n      })\n      .unknown(false)\n  )\n  .default('throw')\n\nconst helperSchema = validator.function()\n\nconst helpersSchema = validator\n  .object({\n    descriptionToChatCompletionsJsonSchema: helperSchema.optional(),\n    renderUntrustedContent: helperSchema.optional(),\n    renderTrustedContent: helperSchema.optional(),\n    renderStandingInstructions: helperSchema.optional(),\n    renderMemories: helperSchema.optional(),\n    renderRetrievables: helperSchema.optional(),\n    renderRetrievableHandleBody: helperSchema.optional(),\n    renderRetrievableSafetyDirective: helperSchema.optional(),\n    renderFirstPartyRetrievables: helperSchema.optional(),\n    renderThirdPartyPublicRetrievables: helperSchema.optional(),\n    renderThirdPartyPrivateRetrievables: helperSchema.optional(),\n    renderThought: helperSchema.optional(),\n    filterThoughts: helperSchema.optional(),\n    toolsToChatCompletionsTools: helperSchema.optional(),\n    renderChatCompletionsSystemPrompt: helperSchema.optional(),\n    renderClaudeCodeCliTimelineMessage: helperSchema.optional(),\n    renderClaudeCodeCliToolCallResult: helperSchema.optional(),\n    buildClaudeCodeCliPrompt: helperSchema.optional(),\n  })\n  .unknown(false)\n\n// `extraArgs`: a structured allowlist, not a flat string[]. Every value string, in every\n// position, is rejected if it starts with `-` — the fix for the --betas injection hazard.\nconst NOT_A_FLAG_RE = /^(?!-).+$/\n\nconst singleValueSchema = validator.string().min(1).pattern(NOT_A_FLAG_RE)\nconst multiValueSchema = validator\n  .array()\n  .items(validator.string().min(1).pattern(NOT_A_FLAG_RE))\n  .min(1)\n\nconst extraArgSchema = validator\n  .alternatives(\n    // --betas is the only flag accepting a string[] value.\n    validator\n      .object({\n        flag: validator.string().valid('--betas').required(),\n        value: multiValueSchema.required(),\n      })\n      .unknown(false),\n    // --prompt-suggestions is the only flag with an OPTIONAL value.\n    validator\n      .object({\n        flag: validator.string().valid('--prompt-suggestions').required(),\n        value: singleValueSchema.optional(),\n      })\n      .unknown(false),\n    // Every remaining allowlisted flag requires a single non-empty, non-flag-shaped string value.\n    validator\n      .object({\n        flag: validator.string().valid('--effort', '--agent', '--json-schema', '--name').required(),\n        value: singleValueSchema.required(),\n      })\n      .unknown(false)\n  )\n  .required()\n\nconst extraArgsSchema = validator.array().items(extraArgSchema).optional()\n\n// ─── Top-level schema ─────────────────────────────────────────────────────────\n\n/**\n * Validator schema for `ClaudeCodeCliAdapterOptions`. Used by `validateOptions` at construction\n * time and again at the start of every iteration after options have been merged (stash > executor\n * > constructor). Rejects unknown top-level keys so typos fail loud.\n */\nexport const claudeCodeCliOptionsSchema = validator\n  .object<ClaudeCodeCliAdapterOptions>({\n    // ADK control\n    execa: validator.function().optional(),\n    wrapperPath: validator.string().optional(),\n    claudeBin: validator.string().default('claude'),\n    appendSystemPrompt: validator.string().optional(),\n    apiKey: validator.string().optional(),\n    authToken: validator.string().optional(),\n    baseURL: validator.string().optional(),\n    cwd: validator.string().optional(),\n    addDir: validator.array().items(validator.string().min(1)).optional(),\n    disallowedTools: validator.array().items(validator.string().min(1)).default([]),\n    maxTurns: validator\n      .number()\n      .valid(1)\n      .messages({\n        'any.only':\n          'maxTurns is deprecated and inert: single-turn dispatch is the fixed battery contract; ' +\n          'only maxTurns: 1 is accepted, and the option is ignored because argv always carries --max-turns 1.',\n      })\n      .optional(),\n    contextWindow: validator.number().integer().min(1).optional(),\n    tokenEncoding: tokenEncodingSchema,\n    maxBudgetUsd: validator.number().min(0).optional(),\n    fallbackModel: validator.array().items(validator.string().min(1)).optional(),\n    selfIdentity: validator.string().min(1).default('assistant'),\n    autoAck: validator.boolean().default(false),\n    forwardSubagentText: validator.boolean().default(false),\n    bucketOrder: bucketOrderSchema,\n    thoughtSurfacing: validator\n      .string()\n      .valid('all-self', 'latest-self', 'all')\n      .default('all-self'),\n    replayCompatibility: validator.array().items(validator.string().min(1)).default([]),\n    helpers: helpersSchema.optional(),\n    spoolStore: byteStoreSchema.optional(),\n    unsupportedMediaPolicy: unsupportedMediaPolicySchema,\n    unsupportedResultMediaPolicy: unsupportedMediaPolicySchema,\n    extraArgs: extraArgsSchema,\n\n    // CLI-native safety caps / timeouts\n    streamIdleTimeoutMs: validator.number().integer().min(0).default(60_000),\n    startupTimeoutMs: validator.number().integer().min(0).default(45_000),\n    disposeGraceMs: validator.number().integer().min(0).default(2_000),\n    mcpToolIdleTimeoutMs: validator.number().integer().min(0).optional(),\n    disableTelemetry: validator.boolean().optional(),\n    disableErrorReporting: validator.boolean().optional(),\n    disableNonessentialTraffic: validator.boolean().optional(),\n\n    // Required\n    model: validator.string().required(),\n  })\n  .unknown(false)\n  // Exactly one of apiKey/authToken must be set.\n  .xor('apiKey', 'authToken')\n  // POSIX-only in v1: reliable process-group control requires POSIX process groups, mirroring\n  // src/batteries/sandbox/node/srt_enforcer.ts's own platform-boundary precedent — refuse rather\n  // than silently degrade.\n  .custom((value, helpers) => {\n    // POSIX-only in v1: reliable process-group control requires process.kill(-pid, signal),\n    // which has no Windows equivalent — refuse rather than silently degrade, mirroring\n    // src/batteries/sandbox/node/srt_enforcer.ts's own platform-boundary precedent.\n    if (process.platform !== 'darwin' && process.platform !== 'linux') {\n      return helpers.error('any.invalid')\n    }\n    return value\n  })\n\nconst isValidationError = (value: unknown): value is ValidationError =>\n  isError(value) && Array.isArray((value as ValidationError).details)\n\nconst formatValidationDetails = (err: ValidationError): string =>\n  err.details.map((d) => d.message).join(' and ')\n\n/**\n * Validates an arbitrary input against `claudeCodeCliOptionsSchema` and returns the resolved\n * options shape. Throws `E_INVALID_CLAUDE_CODE_CLI_OPTIONS` (carrying the validator's error\n * report on `cause`) on failure.\n *\n * @param input - The raw options object to validate.\n * @returns The resolved options object with defaults filled in.\n */\nexport const validateOptions = (input: unknown): ClaudeCodeCliAdapterOptions => {\n  const { value, error } = claudeCodeCliOptionsSchema.validate(input, {\n    abortEarly: false,\n    convert: false,\n  })\n  if (error) {\n    throw new E_INVALID_CLAUDE_CODE_CLI_OPTIONS([formatValidationDetails(error)], { cause: error })\n  }\n  return value as ClaudeCodeCliAdapterOptions\n}\n\n// suppress unused import warning when the alias isn't referenced\nvoid isValidationError\n"],"mappings":"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"}
+{"version":3,"file":"validation.mjs","names":[],"sources":["../../../../src/batteries/llm/claude_code_cli/validation.ts"],"sourcesContent":["/**\n * Runtime validation schema and wrapper for Claude Code CLI adapter options.\n *\n * @module @nhtio/adk/batteries/llm/claude_code_cli/validation\n *\n * @remarks\n * Schema and call-site wrapper for validating `ClaudeCodeCliAdapterOptions`. Used at construction\n * time and at the start of every iteration against the merged options shape (stash > executor >\n * constructor). Throws `E_INVALID_CLAUDE_CODE_CLI_OPTIONS` on failure — same hard-fail policy as\n * every other ADK contract.\n *\n * Three invariants enforced here that have no equivalent in the other LLM batteries:\n * - `apiKey`/`authToken` are mutually exclusive AND at least one is required (`.xor`).\n * - `extraArgs` entries are validated against a strict six-flag allowlist, with per-flag value\n *   arity, and every value string is rejected if it starts with `-` — the fix for the `--betas`\n *   variadic-value injection hazard (a value string spelling another flag would otherwise reach\n *   the CLI's own argv parser as a distinct token).\n * - `process.platform` is checked at validation time: this battery is POSIX-only in v1 (reliable\n *   process-group control requires POSIX process groups), mirroring\n *   `src/batteries/sandbox/node/srt_enforcer.ts`'s own platform-boundary precedent.\n */\n\nimport { isError } from '@nhtio/adk/guards'\nimport { validator, ValidationError } from '@nhtio/validation'\nimport { E_INVALID_CLAUDE_CODE_CLI_OPTIONS } from './exceptions'\nimport { byteStoreSchema, TokenEncoding } from '@nhtio/adk/common'\nimport type { ClaudeCodeCliAdapterOptions } from './types'\n\n// ─── Sub-schemas ──────────────────────────────────────────────────────────────\n\nconst bucketLabelSchema = validator\n  .string()\n  .valid('standingInstructions', 'memories', 'retrievables', 'timeline')\n\nconst bucketOrderSchema = validator\n  .array()\n  .items(bucketLabelSchema)\n  .unique()\n  .default(['standingInstructions', 'memories', 'retrievables', 'timeline'])\n\nconst tokenEncodingSchema = validator\n  .alternatives(\n    // Known values are suggestions from the canonical list, not a whitelist: consumers may provide\n    // a custom or newer tokenizer name. The field accepts any non-empty string, explicit null, or\n    // absent (undefined = \"no token counting\"). `.optional()` preserves the null/undefined\n    // disposition required by adk/require-validator-any-required.\n    validator\n      .string()\n      .min(1)\n      .description(`Known encodings: ${TokenEncoding.join(', ')}`),\n    validator.any().valid(null).optional()\n  )\n  .default(null)\n\nconst unsupportedMediaPolicySchema = validator\n  .alternatives(\n    validator.string().valid('throw', 'fallback-stash', 'synthetic-description'),\n    validator\n      .object({\n        mode: validator.string().valid('fallback-stash').required(),\n        stashKeys: validator.array().items(validator.string().min(1)).required(),\n      })\n      .unknown(false)\n  )\n  .default('throw')\n\nconst helperSchema = validator.function()\n\nconst helpersSchema = validator\n  .object({\n    descriptionToChatCompletionsJsonSchema: helperSchema.optional(),\n    renderUntrustedContent: helperSchema.optional(),\n    renderTrustedContent: helperSchema.optional(),\n    renderStandingInstructions: helperSchema.optional(),\n    renderMemories: helperSchema.optional(),\n    renderRetrievables: helperSchema.optional(),\n    renderRetrievableHandleBody: helperSchema.optional(),\n    renderRetrievableSafetyDirective: helperSchema.optional(),\n    renderFirstPartyRetrievables: helperSchema.optional(),\n    renderThirdPartyPublicRetrievables: helperSchema.optional(),\n    renderThirdPartyPrivateRetrievables: helperSchema.optional(),\n    renderThought: helperSchema.optional(),\n    filterThoughts: helperSchema.optional(),\n    toolsToChatCompletionsTools: helperSchema.optional(),\n    renderChatCompletionsSystemPrompt: helperSchema.optional(),\n    renderClaudeCodeCliTimelineMessage: helperSchema.optional(),\n    renderClaudeCodeCliToolCallResult: helperSchema.optional(),\n    buildClaudeCodeCliPrompt: helperSchema.optional(),\n  })\n  .unknown(false)\n\n// `extraArgs`: a structured allowlist, not a flat string[]. Every value string, in every\n// position, is rejected if it starts with `-` — the fix for the --betas injection hazard.\nconst NOT_A_FLAG_RE = /^(?!-).+$/\n\nconst singleValueSchema = validator.string().min(1).pattern(NOT_A_FLAG_RE)\nconst multiValueSchema = validator\n  .array()\n  .items(validator.string().min(1).pattern(NOT_A_FLAG_RE))\n  .min(1)\n\nconst extraArgSchema = validator\n  .alternatives(\n    // --betas is the only flag accepting a string[] value.\n    validator\n      .object({\n        flag: validator.string().valid('--betas').required(),\n        value: multiValueSchema.required(),\n      })\n      .unknown(false),\n    // --prompt-suggestions is the only flag with an OPTIONAL value.\n    validator\n      .object({\n        flag: validator.string().valid('--prompt-suggestions').required(),\n        value: singleValueSchema.optional(),\n      })\n      .unknown(false),\n    // Every remaining allowlisted flag requires a single non-empty, non-flag-shaped string value.\n    validator\n      .object({\n        flag: validator.string().valid('--effort', '--agent', '--json-schema', '--name').required(),\n        value: singleValueSchema.required(),\n      })\n      .unknown(false)\n  )\n  .required()\n\nconst extraArgsSchema = validator.array().items(extraArgSchema).optional()\n\n// ─── Top-level schema ─────────────────────────────────────────────────────────\n\n/**\n * Validator schema for `ClaudeCodeCliAdapterOptions`. Used by `validateOptions` at construction\n * time and again at the start of every iteration after options have been merged (stash > executor\n * > constructor). Rejects unknown top-level keys so typos fail loud.\n */\nexport const claudeCodeCliOptionsSchema = validator\n  .object<ClaudeCodeCliAdapterOptions>({\n    // ADK control\n    execa: validator.function().optional(),\n    wrapperPath: validator.string().optional(),\n    claudeBin: validator.string().default('claude'),\n    appendSystemPrompt: validator.string().optional(),\n    apiKey: validator.string().optional(),\n    authToken: validator.string().optional(),\n    baseURL: validator.string().optional(),\n    cwd: validator.string().optional(),\n    addDir: validator.array().items(validator.string().min(1)).optional(),\n    disallowedTools: validator.array().items(validator.string().min(1)).default([]),\n    maxTurns: validator\n      .number()\n      .valid(1)\n      .messages({\n        'any.only':\n          'maxTurns is deprecated and inert: single-turn dispatch is the fixed battery contract; ' +\n          'only maxTurns: 1 is accepted, and the option is ignored because argv always carries --max-turns 1.',\n      })\n      .optional(),\n    contextWindow: validator.number().integer().min(1).optional(),\n    tokenEncoding: tokenEncodingSchema,\n    maxBudgetUsd: validator.number().min(0).optional(),\n    fallbackModel: validator.array().items(validator.string().min(1)).optional(),\n    selfIdentity: validator.string().min(1).default('assistant'),\n    autoAck: validator.boolean().default(false),\n    forwardSubagentText: validator.boolean().default(false),\n    bucketOrder: bucketOrderSchema,\n    thoughtSurfacing: validator\n      .string()\n      .valid('all-self', 'latest-self', 'all')\n      .default('all-self'),\n    replayCompatibility: validator.array().items(validator.string().min(1)).default([]),\n    helpers: helpersSchema.optional(),\n    spoolStore: byteStoreSchema.optional(),\n    unsupportedMediaPolicy: unsupportedMediaPolicySchema,\n    unsupportedResultMediaPolicy: unsupportedMediaPolicySchema,\n    extraArgs: extraArgsSchema,\n\n    // CLI-native safety caps / timeouts\n    streamIdleTimeoutMs: validator.number().integer().min(0).default(60_000),\n    startupTimeoutMs: validator.number().integer().min(0).default(45_000),\n    disposeGraceMs: validator.number().integer().min(0).default(2_000),\n    mcpToolIdleTimeoutMs: validator.number().integer().min(0).optional(),\n    disableTelemetry: validator.boolean().optional(),\n    disableErrorReporting: validator.boolean().optional(),\n    disableNonessentialTraffic: validator.boolean().optional(),\n\n    // Required\n    model: validator.string().required(),\n  })\n  .unknown(false)\n  // Exactly one of apiKey/authToken must be set.\n  .xor('apiKey', 'authToken')\n  // POSIX-only in v1: reliable process-group control requires POSIX process groups, mirroring\n  // src/batteries/sandbox/node/srt_enforcer.ts's own platform-boundary precedent — refuse rather\n  // than silently degrade.\n  .custom((value, helpers) => {\n    // POSIX-only in v1: reliable process-group control requires process.kill(-pid, signal),\n    // which has no Windows equivalent — refuse rather than silently degrade, mirroring\n    // src/batteries/sandbox/node/srt_enforcer.ts's own platform-boundary precedent.\n    if (process.platform !== 'darwin' && process.platform !== 'linux') {\n      return helpers.error('any.invalid')\n    }\n    return value\n  })\n\nconst isValidationError = (value: unknown): value is ValidationError =>\n  isError(value) && Array.isArray((value as ValidationError).details)\n\nconst formatValidationDetails = (err: ValidationError): string =>\n  err.details.map((d) => d.message).join(' and ')\n\n/**\n * Validates an arbitrary input against `claudeCodeCliOptionsSchema` and returns the resolved\n * options shape. Throws `E_INVALID_CLAUDE_CODE_CLI_OPTIONS` (carrying the validator's error\n * report on `cause`) on failure.\n *\n * @param input - The raw options object to validate.\n * @returns The resolved options object with defaults filled in.\n */\nexport const validateOptions = (input: unknown): ClaudeCodeCliAdapterOptions => {\n  const { value, error } = claudeCodeCliOptionsSchema.validate(input, {\n    abortEarly: false,\n    convert: false,\n  })\n  if (error) {\n    throw new E_INVALID_CLAUDE_CODE_CLI_OPTIONS([formatValidationDetails(error)], { cause: error })\n  }\n  return value as ClaudeCodeCliAdapterOptions\n}\n\n// suppress unused import warning when the alias isn't referenced\nvoid isValidationError\n"],"mappings":"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"}

package/batteries/llm/claude_code_cli.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Cek0wNdY.js");
-const require_helpers = require("../../helpers-Tvvwpx1M.js");
+const require_helpers = require("../../helpers-CEjjkXso.js");
 const require_batteries_llm_claude_code_cli_exceptions = require("./claude_code_cli/exceptions.cjs");
 const require_batteries_llm_claude_code_cli_validation = require("./claude_code_cli/validation.cjs");
 const require_batteries_llm_claude_code_cli_helpers = require("./claude_code_cli/helpers.cjs");

package/batteries/llm/claude_code_cli.mjs

@@ -1,4 +1,4 @@
-import { A as renderMemories, D as renderArtifactHandleBody, F as renderThirdPartyPrivateRetrievables, G as toolsToChatCompletionsTools, I as renderThirdPartyPublicRetrievables, L as renderThought, M as renderRetrievableSafetyDirective, N as renderRetrievables, O as renderChatCompletionsSystemPrompt, P as renderStandingInstructions, R as renderTrustedContent, _ as defaultRenderUntrustedContent, a as defaultRenderArtifactHandleBody, c as defaultRenderMemories, d as defaultRenderRetrievables, f as defaultRenderStandingInstructions, g as defaultRenderTrustedContent, h as defaultRenderThought, i as defaultFilterThoughts, j as renderRetrievableHandleBody, k as renderFirstPartyRetrievables, l as defaultRenderRetrievableHandleBody, m as defaultRenderThirdPartyPublicRetrievables, o as defaultRenderChatCompletionsSystemPrompt, p as defaultRenderThirdPartyPrivateRetrievables, r as defaultDescriptionToChatCompletionsJsonSchema, s as defaultRenderFirstPartyRetrievables, u as defaultRenderRetrievableSafetyDirective, v as defaultToolsToChatCompletionsTools, x as filterThoughts, y as descriptionToChatCompletionsJsonSchema, z as renderUntrustedContent } from "../../helpers-CDmLDBq5.mjs";
+import { A as renderMemories, D as renderArtifactHandleBody, F as renderThirdPartyPrivateRetrievables, G as toolsToChatCompletionsTools, I as renderThirdPartyPublicRetrievables, L as renderThought, M as renderRetrievableSafetyDirective, N as renderRetrievables, O as renderChatCompletionsSystemPrompt, P as renderStandingInstructions, R as renderTrustedContent, _ as defaultRenderUntrustedContent, a as defaultRenderArtifactHandleBody, c as defaultRenderMemories, d as defaultRenderRetrievables, f as defaultRenderStandingInstructions, g as defaultRenderTrustedContent, h as defaultRenderThought, i as defaultFilterThoughts, j as renderRetrievableHandleBody, k as renderFirstPartyRetrievables, l as defaultRenderRetrievableHandleBody, m as defaultRenderThirdPartyPublicRetrievables, o as defaultRenderChatCompletionsSystemPrompt, p as defaultRenderThirdPartyPrivateRetrievables, r as defaultDescriptionToChatCompletionsJsonSchema, s as defaultRenderFirstPartyRetrievables, u as defaultRenderRetrievableSafetyDirective, v as defaultToolsToChatCompletionsTools, x as filterThoughts, y as descriptionToChatCompletionsJsonSchema, z as renderUntrustedContent } from "../../helpers-BH7HTtkD.mjs";
 import { E_CLAUDE_CODE_CLI_BINARY_NOT_FOUND, E_CLAUDE_CODE_CLI_CONTEXT_OVERFLOW, E_CLAUDE_CODE_CLI_MCP_BRIDGE_STARTUP_FAILED, E_CLAUDE_CODE_CLI_PROCESS_EXITED_NONZERO, E_CLAUDE_CODE_CLI_STARTUP_TIMEOUT, E_CLAUDE_CODE_CLI_STREAM_ERROR, E_CLAUDE_CODE_CLI_STREAM_STALLED, E_CLAUDE_CODE_CLI_TURN_FAILED, E_CLAUDE_CODE_CLI_UNSUPPORTED_MEDIA_MODALITY, E_CLAUDE_CODE_CLI_WRAPPER_CRASHED, E_CLAUDE_CODE_CLI_WRAPPER_SPAWN_ERROR, E_INVALID_CLAUDE_CODE_CLI_OPTIONS } from "./claude_code_cli/exceptions.mjs";
 import { claudeCodeCliOptionsSchema, validateOptions } from "./claude_code_cli/validation.mjs";
 import { buildClaudeCodeCliPrompt, defaultBuildClaudeCodeCliPrompt, defaultRenderClaudeCodeCliTimelineMessage, defaultRenderClaudeCodeCliToolCallResult, renderClaudeCodeCliTimelineMessage, renderClaudeCodeCliToolCallResult } from "./claude_code_cli/helpers.mjs";

package/batteries/llm/gemini_generate_content/adapter.cjs

@@ -1,14 +1,14 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../../chunk-Cek0wNdY.js");
 const require_guards = require("../../../guards-05Uq3J4M.js");
-const require_tokenizable = require("../../../tokenizable-CWW7iSrD.js");
-const require_spooled_artifact = require("../../../spooled_artifact-DriNQRj7.js");
-const require_thought = require("../../../thought--fRgOwTP.js");
-const require_tool_call = require("../../../tool_call-DgqVwL5n.js");
-require("../../../common-BV3HGeLj.js");
+const require_tokenizable = require("../../../tokenizable-BMZuGWRd.js");
+const require_spooled_artifact = require("../../../spooled_artifact-BpcesRBv.js");
+const require_thought = require("../../../thought-bS7O9O5H.js");
+const require_tool_call = require("../../../tool_call-Fs_Uh5wQ.js");
+require("../../../common-H44Ik9ou.js");
 require("../../../guards.cjs");
 const require_tool_parsers = require("../../../tool_parsers-csSBFWob.js");
-const require_helpers = require("../../../helpers-Tvvwpx1M.js");
+const require_helpers = require("../../../helpers-CEjjkXso.js");
 const require_batteries_llm_gemini_generate_content_exceptions = require("./exceptions.cjs");
 const require_batteries_llm_gemini_generate_content_validation = require("./validation.cjs");
 const require_batteries_llm_gemini_generate_content_helpers = require("./helpers.cjs");
@@ -43,6 +43,7 @@ var DEFAULT_BASE_URL = "https://generativelanguage.googleapis.com/v1beta";
 * Gemini reasoning session. See the option's TSDoc for why this is the default.
 */
 var DEFAULT_SENTINEL = "skip_thought_signature_validator";
+var estimateTokensOf = async (value, encoding) => Promise.resolve(value.estimateTokens(encoding));
 var computeChecksum = (tool, args) => (0, js_sha256.sha256)(`${tool}:${require_spooled_artifact.canonicalStringify(args)}`);
 /** Merge the three option layers, later winning. */
 var mergeOptions = (...layers) => {
@@ -120,6 +121,7 @@ var GeminiGenerateContentAdapter = class GeminiGenerateContentAdapter {
 			};
 			const stashRaw = ctx.stash.get(adapterClass.STASH_KEY, {});
 			const merged = require_batteries_llm_gemini_generate_content_validation.validateOptions(mergeOptions(baseline, overrides, require_guards.isObject(stashRaw) ? stashRaw : {}));
+			if (merged.tokenEncoding !== void 0 && merged.tokenEncoding !== null && merged.contextWindow === void 0) throw new require_batteries_llm_gemini_generate_content_exceptions.E_INVALID_GEMINI_GENERATE_CONTENT_OPTIONS(["tokenEncoding is non-null but contextWindow is undefined"]);
 			const resolved = resolveHelpers(merged.helpers);
 			const selfIdentity = "assistant";
 			const dispatchStreamId = (0, uuid.v6)();
@@ -133,6 +135,26 @@ var GeminiGenerateContentAdapter = class GeminiGenerateContentAdapter {
 				unsupportedMediaPolicy: merged.unsupportedMediaPolicy ?? "throw",
 				warn
 			}));
+			if (merged.tokenEncoding !== void 0 && merged.tokenEncoding !== null && merged.contextWindow !== void 0) {
+				const encoding = merged.tokenEncoding;
+				let total = await estimateTokensOf(ctx.systemPrompt, encoding);
+				for (const value of ctx.standingInstructions) total += await estimateTokensOf(value, encoding);
+				for (const memory of ctx.turnMemories) total += await estimateTokensOf(memory.content, encoding);
+				for (const retrievable of ctx.turnRetrievables) total += await estimateTokensOf(retrievable.inline ? retrievable.content : new require_tokenizable.Tokenizable(`[Reference available: ${retrievable.id}]`), encoding);
+				for (const message of ctx.turnMessages) if (message.content !== void 0) total += await estimateTokensOf(message.content, encoding);
+				for (const thought of ctx.turnThoughts) total += await estimateTokensOf(thought.content, encoding);
+				for (const result of renderedToolCallResults.values()) total += await estimateTokensOf(new require_tokenizable.Tokenizable(JSON.stringify(result)), encoding);
+				const tools = ctx.tools.visible();
+				if (tools.length > 0) {
+					const toolTokens = await estimateTokensOf(new require_tokenizable.Tokenizable(JSON.stringify(resolved.toolsToGeminiTools(tools))), encoding);
+					total += Math.ceil(toolTokens * 1.5);
+				}
+				if (total + (merged.maxOutputTokens ?? 0) > merged.contextWindow) throw new require_batteries_llm_gemini_generate_content_exceptions.E_GEMINI_GENERATE_CONTENT_CONTEXT_OVERFLOW([
+					total + (merged.maxOutputTokens ?? 0),
+					merged.contextWindow,
+					encoding
+				]);
+			}
 			const request = await resolved.buildGeminiRequest({
 				systemPrompt: ctx.systemPrompt,
 				standingInstructions: ctx.standingInstructions,
@@ -264,7 +286,7 @@ var GeminiGenerateContentAdapter = class GeminiGenerateContentAdapter {
 					message: `generation ended with finishReason=${finishReason ?? "unknown"} and no function calls`,
 					payload: { finishReason: finishReason ?? "unknown" }
 				});
-				ctx.ack();
+				if (merged.autoAck) ctx.ack();
 				return;
 			}
 			for (const call of calls) {

package/batteries/llm/gemini_generate_content/adapter.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.cjs","names":["#baseline"],"sources":["../../../../src/batteries/llm/gemini_generate_content/adapter.ts"],"sourcesContent":["/**\n * Cross-environment executor adapter for Google's native Gemini `generateContent` endpoint.\n *\n * @module @nhtio/adk/batteries/llm/gemini_generate_content/adapter\n *\n * @remarks\n * Targets `POST {baseURL}/models/{model}:generateContent` (and `:streamGenerateContent` when\n * `stream` is set) — Gemini's OWN wire format, not an OpenAI-compatible façade in front of it.\n *\n * That distinction is the reason this battery exists. Pointing `openai_chat_completions` at a\n * Gemini-compatible gateway means some translator, not the ADK, decides how your primitives become\n * `contents[]` — including whether a `thoughtSignature` is stamped, whether consecutive same-role\n * turns get merged, and how a tool result is correlated to its call. For ordinary use that is fine.\n * For anything that needs to reason about what the VENDOR actually received — an ordering guard, a\n * wire-shape audit, a bug report against Google — the translation has to be ours and observable.\n * See the validation battery's \"Which API surface a rule applies to\" guide.\n *\n * Options layer exactly as the other batteries: constructor baseline → `executor()` overrides →\n * per-iteration `ctx.stash.geminiGenerateContent`, re-validated each iteration.\n */\n\nimport { DateTime } from 'luxon'\nimport { sha256 } from 'js-sha256'\nimport { v6 as uuidv6 } from 'uuid'\nimport { validateOptions } from './validation'\nimport { normalizeToolName } from '../chat_common/helpers'\nimport { isError, isObject, isInstanceOf } from '@nhtio/adk/guards'\nimport { resolveToolCallParser } from '../chat_common/tool_parsers'\nimport { canonicalStringify } from '../../../lib/utils/canonical_json'\nimport { ArtifactTool, Media, Message, Thought, Tokenizable, ToolCall } from '@nhtio/adk/common'\nimport {\n  E_GEMINI_INVALID_TOOL_CALL_ARGS,\n  E_GEMINI_MISSING_THOUGHT_SIGNATURE,\n  E_GEMINI_REQUEST_FAILED,\n  E_GEMINI_STREAM_ERROR,\n} from './exceptions'\nimport {\n  DEFAULT_GEMINI_BUCKET_ORDER,\n  buildGeminiRequest,\n  extractGeminiGeneration,\n  mediaToGeminiInlineData,\n  renderGeminiToolResult,\n  toolsToGeminiTools,\n} from './helpers'\nimport {\n  descriptionToChatCompletionsJsonSchema,\n  filterThoughts,\n  renderChatCompletionsSystemPrompt,\n  renderFirstPartyRetrievables,\n  renderMemories,\n  renderRetrievableSafetyDirective,\n  renderRetrievables,\n  renderStandingInstructions,\n  renderThirdPartyPrivateRetrievables,\n  renderThirdPartyPublicRetrievables,\n  renderThought,\n  renderTrustedContent,\n  renderUntrustedContent,\n} from '../chat_common/helpers'\nimport type { DispatchContext } from '@nhtio/adk/types'\nimport type { SpooledArtifact, Tool } from '@nhtio/adk/common'\nimport type { DispatchExecutorFn, DispatchExecutorHelpers } from '@nhtio/adk/types'\nimport type {\n  GeminiGenerateContentAdapterOptions,\n  GeminiGenerateContentHelpers,\n  GeminiGenerateContentResponse,\n} from './types'\n\nconst nowIso = (): string => DateTime.now().toISO() ?? new Date().toISOString()\n\nconst DEFAULT_BASE_URL = 'https://generativelanguage.googleapis.com/v1beta'\n/**\n * Google's documented portable sentinel for replaying tool history that did not originate from a\n * Gemini reasoning session. See the option's TSDoc for why this is the default.\n */\nconst DEFAULT_SENTINEL = 'skip_thought_signature_validator'\n\nconst computeChecksum = (tool: string, args: Record<string, unknown>): string =>\n  sha256(`${tool}:${canonicalStringify(args)}`)\n\n/** Merge the three option layers, later winning. */\nconst mergeOptions = (\n  ...layers: Array<Partial<GeminiGenerateContentAdapterOptions> | undefined>\n): Partial<GeminiGenerateContentAdapterOptions> => {\n  const out: Record<string, unknown> = {}\n  for (const layer of layers) {\n    if (!layer) continue\n    for (const [k, v] of Object.entries(layer)) if (v !== undefined) out[k] = v\n  }\n  return out as Partial<GeminiGenerateContentAdapterOptions>\n}\n\n/** Fill every injectable helper, preferring the caller's override. */\nconst resolveHelpers = (\n  overrides: Partial<GeminiGenerateContentHelpers> | undefined\n): GeminiGenerateContentHelpers => {\n  const src = (overrides ?? {}) as Record<string, unknown>\n  const pick = <T>(key: string, fallback: T): T => (src[key] as T | undefined) ?? fallback\n  return {\n    descriptionToChatCompletionsJsonSchema: pick(\n      'descriptionToChatCompletionsJsonSchema',\n      descriptionToChatCompletionsJsonSchema\n    ),\n    renderUntrustedContent: pick('renderUntrustedContent', renderUntrustedContent),\n    renderTrustedContent: pick('renderTrustedContent', renderTrustedContent),\n    renderStandingInstructions: pick('renderStandingInstructions', renderStandingInstructions),\n    renderMemories: pick('renderMemories', renderMemories),\n    renderRetrievables: pick('renderRetrievables', renderRetrievables),\n    renderRetrievableSafetyDirective: pick(\n      'renderRetrievableSafetyDirective',\n      renderRetrievableSafetyDirective\n    ),\n    renderFirstPartyRetrievables: pick(\n      'renderFirstPartyRetrievables',\n      renderFirstPartyRetrievables\n    ),\n    renderThirdPartyPublicRetrievables: pick(\n      'renderThirdPartyPublicRetrievables',\n      renderThirdPartyPublicRetrievables\n    ),\n    renderThirdPartyPrivateRetrievables: pick(\n      'renderThirdPartyPrivateRetrievables',\n      renderThirdPartyPrivateRetrievables\n    ),\n    renderThought: pick('renderThought', renderThought),\n    filterThoughts: pick('filterThoughts', filterThoughts),\n    renderChatCompletionsSystemPrompt: pick(\n      'renderChatCompletionsSystemPrompt',\n      renderChatCompletionsSystemPrompt\n    ),\n    toolsToGeminiTools: pick('toolsToGeminiTools', toolsToGeminiTools),\n    renderGeminiToolResult: pick('renderGeminiToolResult', renderGeminiToolResult),\n    buildGeminiRequest: pick('buildGeminiRequest', buildGeminiRequest),\n  } as GeminiGenerateContentHelpers\n}\n\n/**\n * Native Gemini `generateContent` executor adapter.\n *\n * @example\n * ```ts\n * const adapter = new GeminiGenerateContentAdapter({\n *   model: 'gemini-2.5-flash-lite',\n *   apiKey: process.env.GEMINI_API_KEY,\n * })\n * const runner = new TurnRunner({ executorCallback: adapter.executor(), ... })\n * ```\n */\nexport class GeminiGenerateContentAdapter {\n  /** Per-iteration override key on `ctx.stash`. */\n  public static readonly STASH_KEY = 'geminiGenerateContent' as const\n\n  readonly #baseline: GeminiGenerateContentAdapterOptions\n\n  /**\n   * @param options - Constructor-baseline options, re-validated每 iteration after overrides merge.\n   * @throws {@link E_INVALID_GEMINI_GENERATE_CONTENT_OPTIONS} when `options` is invalid.\n   */\n  constructor(options: unknown) {\n    this.#baseline = validateOptions(options)\n  }\n\n  /** Narrowing guard for cross-realm instances. */\n  public static isGeminiGenerateContentAdapter(\n    value: unknown\n  ): value is GeminiGenerateContentAdapter {\n    return isInstanceOf(value, 'GeminiGenerateContentAdapter', GeminiGenerateContentAdapter)\n  }\n\n  /**\n   * Build a {@link DispatchExecutorFn} bound to the baseline plus optional executor-scope overrides.\n   *\n   * @param overrides - Higher precedence than the baseline, lower than `ctx.stash`.\n   */\n  executor(overrides?: Partial<GeminiGenerateContentAdapterOptions>): DispatchExecutorFn {\n    const baseline = this.#baseline\n    const adapterClass = GeminiGenerateContentAdapter\n    return async (ctx: DispatchContext, helpers: DispatchExecutorHelpers): Promise<void> => {\n      const warn = (message: string): void => {\n        helpers.log.warn({ kind: 'helper-warning', message })\n      }\n\n      // ── merge & validate ────────────────────────────────────────────────\n      const stashRaw = ctx.stash.get(adapterClass.STASH_KEY, {}) as unknown\n      const stashOverrides = isObject(stashRaw)\n        ? (stashRaw as Partial<GeminiGenerateContentAdapterOptions>)\n        : {}\n      const merged = validateOptions(mergeOptions(baseline, overrides, stashOverrides))\n      const resolved = resolveHelpers(merged.helpers)\n      const selfIdentity = 'assistant'\n      const dispatchStreamId = uuidv6()\n\n      // ── pre-render tool results ─────────────────────────────────────────\n      // Gemini wants an OBJECT in functionResponse.response, so results are rendered ahead of\n      // assembly and keyed by the live ToolCall instance. Keying by id lets a duplicate id\n      // overwrite an earlier result before assembly.\n      const renderedToolCallResults = new Map<ToolCall, Record<string, unknown>>()\n      for (const tc of ctx.turnToolCalls) {\n        renderedToolCallResults.set(\n          tc,\n          await resolved.renderGeminiToolResult({\n            toolCall: tc,\n            results: tc.results as never,\n            tool: ctx.tools.get(tc.tool) as Tool | ArtifactTool | undefined,\n            renderUntrustedContent: resolved.renderUntrustedContent,\n            renderTrustedContent: resolved.renderTrustedContent,\n            unsupportedMediaPolicy: merged.unsupportedMediaPolicy ?? 'throw',\n            warn,\n          })\n        )\n      }\n\n      // ── assemble ────────────────────────────────────────────────────────\n      const request = await resolved.buildGeminiRequest({\n        systemPrompt: ctx.systemPrompt,\n        standingInstructions: ctx.standingInstructions,\n        memories: ctx.turnMemories,\n        retrievables: ctx.turnRetrievables,\n        messages: ctx.turnMessages,\n        thoughts: ctx.turnThoughts,\n        toolCalls: ctx.turnToolCalls,\n        tools: ctx.tools,\n        renderedToolCallResults,\n        bucketOrder: merged.bucketOrder ?? (DEFAULT_GEMINI_BUCKET_ORDER as never),\n        selfIdentity,\n        thoughtSurfacing: merged.thoughtSurfacing ?? 'all-self',\n        replayCompatibility: [],\n        thoughtSignatureSentinel:\n          merged.thoughtSignatureSentinel === undefined\n            ? DEFAULT_SENTINEL\n            : merged.thoughtSignatureSentinel,\n        helpers: resolved,\n        decodeMedia: mediaToGeminiInlineData,\n        unsupportedMediaPolicy: merged.unsupportedMediaPolicy,\n        warn,\n      })\n\n      const generationConfig = {\n        ...(merged.maxOutputTokens !== undefined\n          ? { maxOutputTokens: merged.maxOutputTokens }\n          : {}),\n        ...(merged.temperature !== undefined ? { temperature: merged.temperature } : {}),\n        ...(merged.topP !== undefined ? { topP: merged.topP } : {}),\n        ...(merged.topK !== undefined ? { topK: merged.topK } : {}),\n        ...(merged.stopSequences ? { stopSequences: merged.stopSequences } : {}),\n        ...(merged.thinkingConfig ? { thinkingConfig: merged.thinkingConfig } : {}),\n      }\n      const body = {\n        ...request,\n        ...(Object.keys(generationConfig).length > 0 ? { generationConfig } : {}),\n        ...(merged.toolConfig ? { toolConfig: merged.toolConfig } : {}),\n        ...(merged.safetySettings ? { safetySettings: merged.safetySettings } : {}),\n      }\n\n      // Prompt-assembled tap: the EXACT body about to be POSTed. An ADK-control key — stripped\n      // from the wire request, never sent. Observer errors are swallowed so a tap can never\n      // corrupt a generation.\n      if (merged.onPromptAssembled) {\n        try {\n          merged.onPromptAssembled({\n            battery: 'gemini_generate_content',\n            kind: 'request-body',\n            messages: body.contents,\n            tools: body.tools,\n            requestBody: body,\n            streamed: merged.stream === true,\n            streamId: dispatchStreamId,\n          })\n        } catch {\n          /* observer errors are non-fatal */\n        }\n      }\n\n      // ── dispatch ────────────────────────────────────────────────────────\n      const base = (merged.baseURL ?? DEFAULT_BASE_URL).replace(/\\/$/, '')\n      const action = merged.stream === true ? 'streamGenerateContent' : 'generateContent'\n      const url = `${base}/models/${merged.model}:${action}`\n      const headers: Record<string, string> = { 'Content-Type': 'application/json' }\n      if (merged.apiKey) {\n        // Google's own endpoint wants x-goog-api-key; several gateways in front of it accept only\n        // Authorization, hence the switch rather than sending both.\n        if (merged.useBearerAuth === true) headers.Authorization = `Bearer ${merged.apiKey}`\n        else headers['x-goog-api-key'] = merged.apiKey\n      }\n\n      const doFetch = merged.fetch ?? globalThis.fetch\n      let parsed: GeminiGenerateContentResponse\n      try {\n        const res = await doFetch(url, {\n          method: 'POST',\n          headers,\n          body: JSON.stringify(body),\n          signal: merged.timeoutMs ? AbortSignal.timeout(merged.timeoutMs) : ctx.abortSignal,\n        })\n        const text = await res.text()\n        if (!res.ok) {\n          // Classify the vendor's own signature rejection separately — it is actionable, and\n          // Gemini's generic INVALID_ARGUMENT body gives a caller nothing to act on.\n          if (/thought_signature|thoughtSignature/i.test(text)) {\n            ctx.nack(new E_GEMINI_MISSING_THOUGHT_SIGNATURE([text.slice(0, 400)]))\n            return\n          }\n          ctx.nack(new E_GEMINI_REQUEST_FAILED([res.status, text.slice(0, 400)]))\n          return\n        }\n        parsed = JSON.parse(text) as GeminiGenerateContentResponse\n      } catch (err) {\n        ctx.nack(new E_GEMINI_STREAM_ERROR([isError(err) ? err.message : String(err)]))\n        return\n      }\n\n      // ── interpret ───────────────────────────────────────────────────────\n      const { text, reasoning, functionCalls, finishReason } = extractGeminiGeneration(parsed)\n      const responseId = uuidv6()\n\n      if (text.length > 0) {\n        const messageId = `${responseId}:message`\n        helpers.reportMessage(messageId, text, { isComplete: true })\n        await ctx.storeMessage(\n          new Message({\n            id: messageId,\n            role: 'assistant',\n            content: text,\n            identity: selfIdentity,\n            createdAt: nowIso(),\n            updatedAt: nowIso(),\n          })\n        )\n      }\n      if (reasoning.length > 0) {\n        const thoughtId = `${responseId}:thought`\n        helpers.reportThought(thoughtId, reasoning, { isComplete: true })\n        await ctx.storeThought(\n          new Thought({\n            id: thoughtId,\n            content: reasoning,\n            identity: selfIdentity,\n            createdAt: nowIso(),\n            updatedAt: nowIso(),\n          })\n        )\n      }\n\n      // Fallback recovery: only consulted when the provider returned NO structured calls, so a\n      // native functionCall always wins over a parsed one.\n      let calls = functionCalls.map((c) => ({ id: uuidv6(), name: c.name, args: c.args }))\n      if (calls.length === 0 && merged.localToolCallParser !== undefined && text.length > 0) {\n        const parser = resolveToolCallParser(merged.localToolCallParser)\n        // The parser returns { calls, cleanedText } — not an iterable of calls — and the\n        // second argument carries the tool names actually offered this turn so a parser can\n        // reject a hallucinated name rather than manufacture a call for it.\n        const recovered = parser(text, { toolNames: ctx.tools.all().map((t) => t.name) })\n        for (const call of recovered.calls) {\n          calls.push({\n            id: uuidv6(),\n            name: call.name,\n            args: (call.arguments ?? {}) as Record<string, unknown>,\n          })\n        }\n      }\n\n      if (merged.onRawGeneration) {\n        try {\n          merged.onRawGeneration({\n            rawText: text,\n            cleanedText: text,\n            reasoning: reasoning.length > 0 ? [reasoning] : [],\n            toolCalls: calls.map((c) => ({ name: c.name, arguments: c.args as never })),\n            streamed: merged.stream === true,\n            streamId: dispatchStreamId,\n          })\n        } catch {\n          /* observer errors are non-fatal */\n        }\n      }\n\n      if (calls.length === 0) {\n        // `finishReason` is recorded for the caller; an empty generation is NOT an error here —\n        // it is a real vendor outcome and the runner decides what to do with it.\n        helpers.log.trace({\n          kind: 'gemini-finish',\n          message: `generation ended with finishReason=${finishReason ?? 'unknown'} and no function calls`,\n          payload: { finishReason: finishReason ?? 'unknown' },\n        })\n        ctx.ack()\n        return\n      }\n\n      for (const call of calls) {\n        if (ctx.abortSignal.aborted) return\n        const toolName = normalizeToolName(call.name)\n        const tool = ctx.tools.get(toolName) as Tool | ArtifactTool | undefined\n        const completedAt = nowIso()\n\n        if (!isObject(call.args)) {\n          const results = new Tokenizable(\n            new E_GEMINI_INVALID_TOOL_CALL_ARGS([JSON.stringify(call.args)]).message\n          )\n          helpers.reportToolCall(call.id, { tool: toolName, args: {} })\n          helpers.reportToolCall(call.id, { results, isError: true, isComplete: true })\n          await ctx.storeToolCall(\n            new ToolCall({\n              id: call.id,\n              tool: toolName,\n              args: {},\n              checksum: computeChecksum(toolName, {}),\n              isComplete: true,\n              isError: true,\n              results,\n              createdAt: completedAt,\n              updatedAt: completedAt,\n              completedAt,\n            })\n          )\n          continue\n        }\n\n        if (!tool) {\n          const available = ctx.tools\n            .all()\n            .map((t) => t.name)\n            .sort()\n          const results = new Tokenizable(\n            available.length > 0\n              ? `Tool not found: ${toolName}. Available tools: ${available.join(', ')}.`\n              : `Tool not found: ${toolName}. No tools are available this turn.`\n          )\n          helpers.reportToolCall(call.id, { tool: toolName, args: call.args })\n          helpers.reportToolCall(call.id, { results, isError: true, isComplete: true })\n          await ctx.storeToolCall(\n            new ToolCall({\n              id: call.id,\n              tool: toolName,\n              args: call.args,\n              checksum: computeChecksum(toolName, call.args),\n              isComplete: true,\n              isError: true,\n              results,\n              createdAt: completedAt,\n              updatedAt: completedAt,\n              completedAt,\n            })\n          )\n          continue\n        }\n\n        helpers.reportToolCall(call.id, { tool: tool.name, args: call.args })\n        let results: Tokenizable | SpooledArtifact | SpooledArtifact[] | Media | Media[] =\n          new Tokenizable('')\n        let isToolError = false\n        try {\n          const raw = await tool.executor(ctx)(call.args)\n          results = Tokenizable.isTokenizable(raw)\n            ? raw\n            : new Tokenizable(typeof raw === 'string' ? raw : JSON.stringify(raw ?? ''))\n        } catch (err) {\n          isToolError = true\n          results = new Tokenizable(isError(err) ? err.message : String(err))\n        }\n        const finishedAt = nowIso()\n        helpers.reportToolCall(call.id, { results, isError: isToolError, isComplete: true })\n        await ctx.storeToolCall(\n          new ToolCall({\n            id: call.id,\n            tool: tool.name,\n            args: call.args,\n            checksum: computeChecksum(tool.name, call.args),\n            isComplete: true,\n            isError: isToolError,\n            results,\n            createdAt: finishedAt,\n            updatedAt: finishedAt,\n            completedAt: finishedAt,\n          })\n        )\n      }\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"adapter.cjs","names":["#baseline"],"sources":["../../../../src/batteries/llm/gemini_generate_content/adapter.ts"],"sourcesContent":["/**\n * Cross-environment executor adapter for Google's native Gemini `generateContent` endpoint.\n *\n * @module @nhtio/adk/batteries/llm/gemini_generate_content/adapter\n *\n * @remarks\n * Targets `POST {baseURL}/models/{model}:generateContent` (and `:streamGenerateContent` when\n * `stream` is set) — Gemini's OWN wire format, not an OpenAI-compatible façade in front of it.\n *\n * That distinction is the reason this battery exists. Pointing `openai_chat_completions` at a\n * Gemini-compatible gateway means some translator, not the ADK, decides how your primitives become\n * `contents[]` — including whether a `thoughtSignature` is stamped, whether consecutive same-role\n * turns get merged, and how a tool result is correlated to its call. For ordinary use that is fine.\n * For anything that needs to reason about what the VENDOR actually received — an ordering guard, a\n * wire-shape audit, a bug report against Google — the translation has to be ours and observable.\n * See the validation battery's \"Which API surface a rule applies to\" guide.\n *\n * Options layer exactly as the other batteries: constructor baseline → `executor()` overrides →\n * per-iteration `ctx.stash.geminiGenerateContent`, re-validated each iteration.\n */\n\nimport { DateTime } from 'luxon'\nimport { sha256 } from 'js-sha256'\nimport { v6 as uuidv6 } from 'uuid'\nimport { validateOptions } from './validation'\nimport { normalizeToolName } from '../chat_common/helpers'\nimport { isError, isObject, isInstanceOf } from '@nhtio/adk/guards'\nimport { resolveToolCallParser } from '../chat_common/tool_parsers'\nimport { canonicalStringify } from '../../../lib/utils/canonical_json'\nimport { ArtifactTool, Media, Message, Thought, Tokenizable, ToolCall } from '@nhtio/adk/common'\nimport {\n  DEFAULT_GEMINI_BUCKET_ORDER,\n  buildGeminiRequest,\n  extractGeminiGeneration,\n  mediaToGeminiInlineData,\n  renderGeminiToolResult,\n  toolsToGeminiTools,\n} from './helpers'\nimport {\n  E_GEMINI_GENERATE_CONTENT_CONTEXT_OVERFLOW,\n  E_INVALID_GEMINI_GENERATE_CONTENT_OPTIONS,\n  E_GEMINI_INVALID_TOOL_CALL_ARGS,\n  E_GEMINI_MISSING_THOUGHT_SIGNATURE,\n  E_GEMINI_REQUEST_FAILED,\n  E_GEMINI_STREAM_ERROR,\n} from './exceptions'\nimport {\n  descriptionToChatCompletionsJsonSchema,\n  filterThoughts,\n  renderChatCompletionsSystemPrompt,\n  renderFirstPartyRetrievables,\n  renderMemories,\n  renderRetrievableSafetyDirective,\n  renderRetrievables,\n  renderStandingInstructions,\n  renderThirdPartyPrivateRetrievables,\n  renderThirdPartyPublicRetrievables,\n  renderThought,\n  renderTrustedContent,\n  renderUntrustedContent,\n} from '../chat_common/helpers'\nimport type { DispatchContext } from '@nhtio/adk/types'\nimport type { Memory, SpooledArtifact, Tool } from '@nhtio/adk/common'\nimport type { TokenEncoding, TokenEncodingId } from '@nhtio/adk/types'\nimport type { DispatchExecutorFn, DispatchExecutorHelpers } from '@nhtio/adk/types'\nimport type {\n  GeminiGenerateContentAdapterOptions,\n  GeminiGenerateContentHelpers,\n  GeminiGenerateContentResponse,\n} from './types'\n\nconst nowIso = (): string => DateTime.now().toISO() ?? new Date().toISOString()\n\nconst DEFAULT_BASE_URL = 'https://generativelanguage.googleapis.com/v1beta'\n/**\n * Google's documented portable sentinel for replaying tool history that did not originate from a\n * Gemini reasoning session. See the option's TSDoc for why this is the default.\n */\nconst DEFAULT_SENTINEL = 'skip_thought_signature_validator'\n\nconst estimateTokensOf = async (\n  value: { estimateTokens: (encoding: TokenEncoding) => number | Promise<number> },\n  encoding: TokenEncodingId\n): Promise<number> => Promise.resolve(value.estimateTokens(encoding as TokenEncoding))\n\nconst computeChecksum = (tool: string, args: Record<string, unknown>): string =>\n  sha256(`${tool}:${canonicalStringify(args)}`)\n\n/** Merge the three option layers, later winning. */\nconst mergeOptions = (\n  ...layers: Array<Partial<GeminiGenerateContentAdapterOptions> | undefined>\n): Partial<GeminiGenerateContentAdapterOptions> => {\n  const out: Record<string, unknown> = {}\n  for (const layer of layers) {\n    if (!layer) continue\n    for (const [k, v] of Object.entries(layer)) if (v !== undefined) out[k] = v\n  }\n  return out as Partial<GeminiGenerateContentAdapterOptions>\n}\n\n/** Fill every injectable helper, preferring the caller's override. */\nconst resolveHelpers = (\n  overrides: Partial<GeminiGenerateContentHelpers> | undefined\n): GeminiGenerateContentHelpers => {\n  const src = (overrides ?? {}) as Record<string, unknown>\n  const pick = <T>(key: string, fallback: T): T => (src[key] as T | undefined) ?? fallback\n  return {\n    descriptionToChatCompletionsJsonSchema: pick(\n      'descriptionToChatCompletionsJsonSchema',\n      descriptionToChatCompletionsJsonSchema\n    ),\n    renderUntrustedContent: pick('renderUntrustedContent', renderUntrustedContent),\n    renderTrustedContent: pick('renderTrustedContent', renderTrustedContent),\n    renderStandingInstructions: pick('renderStandingInstructions', renderStandingInstructions),\n    renderMemories: pick('renderMemories', renderMemories),\n    renderRetrievables: pick('renderRetrievables', renderRetrievables),\n    renderRetrievableSafetyDirective: pick(\n      'renderRetrievableSafetyDirective',\n      renderRetrievableSafetyDirective\n    ),\n    renderFirstPartyRetrievables: pick(\n      'renderFirstPartyRetrievables',\n      renderFirstPartyRetrievables\n    ),\n    renderThirdPartyPublicRetrievables: pick(\n      'renderThirdPartyPublicRetrievables',\n      renderThirdPartyPublicRetrievables\n    ),\n    renderThirdPartyPrivateRetrievables: pick(\n      'renderThirdPartyPrivateRetrievables',\n      renderThirdPartyPrivateRetrievables\n    ),\n    renderThought: pick('renderThought', renderThought),\n    filterThoughts: pick('filterThoughts', filterThoughts),\n    renderChatCompletionsSystemPrompt: pick(\n      'renderChatCompletionsSystemPrompt',\n      renderChatCompletionsSystemPrompt\n    ),\n    toolsToGeminiTools: pick('toolsToGeminiTools', toolsToGeminiTools),\n    renderGeminiToolResult: pick('renderGeminiToolResult', renderGeminiToolResult),\n    buildGeminiRequest: pick('buildGeminiRequest', buildGeminiRequest),\n  } as GeminiGenerateContentHelpers\n}\n\n/**\n * Native Gemini `generateContent` executor adapter.\n *\n * @example\n * ```ts\n * const adapter = new GeminiGenerateContentAdapter({\n *   model: 'gemini-2.5-flash-lite',\n *   apiKey: process.env.GEMINI_API_KEY,\n * })\n * const runner = new TurnRunner({ executorCallback: adapter.executor(), ... })\n * ```\n */\nexport class GeminiGenerateContentAdapter {\n  /** Per-iteration override key on `ctx.stash`. */\n  public static readonly STASH_KEY = 'geminiGenerateContent' as const\n\n  readonly #baseline: GeminiGenerateContentAdapterOptions\n\n  /**\n   * @param options - Constructor-baseline options, re-validated每 iteration after overrides merge.\n   * @throws {@link E_INVALID_GEMINI_GENERATE_CONTENT_OPTIONS} when `options` is invalid.\n   */\n  constructor(options: unknown) {\n    this.#baseline = validateOptions(options)\n  }\n\n  /** Narrowing guard for cross-realm instances. */\n  public static isGeminiGenerateContentAdapter(\n    value: unknown\n  ): value is GeminiGenerateContentAdapter {\n    return isInstanceOf(value, 'GeminiGenerateContentAdapter', GeminiGenerateContentAdapter)\n  }\n\n  /**\n   * Build a {@link DispatchExecutorFn} bound to the baseline plus optional executor-scope overrides.\n   *\n   * @param overrides - Higher precedence than the baseline, lower than `ctx.stash`.\n   */\n  executor(overrides?: Partial<GeminiGenerateContentAdapterOptions>): DispatchExecutorFn {\n    const baseline = this.#baseline\n    const adapterClass = GeminiGenerateContentAdapter\n    return async (ctx: DispatchContext, helpers: DispatchExecutorHelpers): Promise<void> => {\n      const warn = (message: string): void => {\n        helpers.log.warn({ kind: 'helper-warning', message })\n      }\n\n      // ── merge & validate ────────────────────────────────────────────────\n      const stashRaw = ctx.stash.get(adapterClass.STASH_KEY, {}) as unknown\n      const stashOverrides = isObject(stashRaw)\n        ? (stashRaw as Partial<GeminiGenerateContentAdapterOptions>)\n        : {}\n      const merged = validateOptions(mergeOptions(baseline, overrides, stashOverrides))\n      if (\n        merged.tokenEncoding !== undefined &&\n        merged.tokenEncoding !== null &&\n        merged.contextWindow === undefined\n      ) {\n        throw new E_INVALID_GEMINI_GENERATE_CONTENT_OPTIONS([\n          'tokenEncoding is non-null but contextWindow is undefined',\n        ])\n      }\n      const resolved = resolveHelpers(merged.helpers)\n      const selfIdentity = 'assistant'\n      const dispatchStreamId = uuidv6()\n\n      // ── pre-render tool results ─────────────────────────────────────────\n      // Gemini wants an OBJECT in functionResponse.response, so results are rendered ahead of\n      // assembly and keyed by the live ToolCall instance. Keying by id lets a duplicate id\n      // overwrite an earlier result before assembly.\n      const renderedToolCallResults = new Map<ToolCall, Record<string, unknown>>()\n      for (const tc of ctx.turnToolCalls) {\n        renderedToolCallResults.set(\n          tc,\n          await resolved.renderGeminiToolResult({\n            toolCall: tc,\n            results: tc.results as never,\n            tool: ctx.tools.get(tc.tool) as Tool | ArtifactTool | undefined,\n            renderUntrustedContent: resolved.renderUntrustedContent,\n            renderTrustedContent: resolved.renderTrustedContent,\n            unsupportedMediaPolicy: merged.unsupportedMediaPolicy ?? 'throw',\n            warn,\n          })\n        )\n      }\n\n      // ── context window enforcement ───────────────────────────────────────\n      if (\n        merged.tokenEncoding !== undefined &&\n        merged.tokenEncoding !== null &&\n        merged.contextWindow !== undefined\n      ) {\n        const encoding = merged.tokenEncoding\n        let total = await estimateTokensOf(ctx.systemPrompt, encoding)\n        for (const value of ctx.standingInstructions)\n          total += await estimateTokensOf(value, encoding)\n        for (const memory of ctx.turnMemories as Set<Memory>) {\n          total += await estimateTokensOf(memory.content, encoding)\n        }\n        for (const retrievable of ctx.turnRetrievables) {\n          total += await estimateTokensOf(\n            retrievable.inline\n              ? (retrievable.content as any)\n              : new Tokenizable(`[Reference available: ${retrievable.id}]`),\n            encoding\n          )\n        }\n        for (const message of ctx.turnMessages) {\n          if (message.content !== undefined)\n            total += await estimateTokensOf(message.content, encoding)\n        }\n        for (const thought of ctx.turnThoughts)\n          total += await estimateTokensOf(thought.content, encoding)\n        for (const result of renderedToolCallResults.values()) {\n          total += await estimateTokensOf(new Tokenizable(JSON.stringify(result)), encoding)\n        }\n        const tools = ctx.tools.visible()\n        // Tool DECLARATIONS: the Gemini wire ships tools as an array, which the PROVIDER\n        // serializes server-side into the model's own format. Tally the tokens of the wire\n        // tools JSON (`JSON.stringify`) as an honest FLOOR — a truthful lower bound. We add\n        // a highly conservative 50% margin to cover JSON structural overhead and nested formatting.\n        if (tools.length > 0) {\n          const toolTokens = await estimateTokensOf(\n            new Tokenizable(JSON.stringify(resolved.toolsToGeminiTools(tools))),\n            encoding\n          )\n          total += Math.ceil(toolTokens * 1.5)\n        }\n        if (total + (merged.maxOutputTokens ?? 0) > merged.contextWindow) {\n          throw new E_GEMINI_GENERATE_CONTENT_CONTEXT_OVERFLOW([\n            total + (merged.maxOutputTokens ?? 0),\n            merged.contextWindow,\n            encoding,\n          ])\n        }\n      }\n\n      // ── assemble ────────────────────────────────────────────────────────\n      const request = await resolved.buildGeminiRequest({\n        systemPrompt: ctx.systemPrompt,\n        standingInstructions: ctx.standingInstructions,\n        memories: ctx.turnMemories,\n        retrievables: ctx.turnRetrievables,\n        messages: ctx.turnMessages,\n        thoughts: ctx.turnThoughts,\n        toolCalls: ctx.turnToolCalls,\n        tools: ctx.tools,\n        renderedToolCallResults,\n        bucketOrder: merged.bucketOrder ?? (DEFAULT_GEMINI_BUCKET_ORDER as never),\n        selfIdentity,\n        thoughtSurfacing: merged.thoughtSurfacing ?? 'all-self',\n        replayCompatibility: [],\n        thoughtSignatureSentinel:\n          merged.thoughtSignatureSentinel === undefined\n            ? DEFAULT_SENTINEL\n            : merged.thoughtSignatureSentinel,\n        helpers: resolved,\n        decodeMedia: mediaToGeminiInlineData,\n        unsupportedMediaPolicy: merged.unsupportedMediaPolicy,\n        warn,\n      })\n\n      const generationConfig = {\n        ...(merged.maxOutputTokens !== undefined\n          ? { maxOutputTokens: merged.maxOutputTokens }\n          : {}),\n        ...(merged.temperature !== undefined ? { temperature: merged.temperature } : {}),\n        ...(merged.topP !== undefined ? { topP: merged.topP } : {}),\n        ...(merged.topK !== undefined ? { topK: merged.topK } : {}),\n        ...(merged.stopSequences ? { stopSequences: merged.stopSequences } : {}),\n        ...(merged.thinkingConfig ? { thinkingConfig: merged.thinkingConfig } : {}),\n      }\n      const body = {\n        ...request,\n        ...(Object.keys(generationConfig).length > 0 ? { generationConfig } : {}),\n        ...(merged.toolConfig ? { toolConfig: merged.toolConfig } : {}),\n        ...(merged.safetySettings ? { safetySettings: merged.safetySettings } : {}),\n      }\n\n      // Prompt-assembled tap: the EXACT body about to be POSTed. An ADK-control key — stripped\n      // from the wire request, never sent. Observer errors are swallowed so a tap can never\n      // corrupt a generation.\n      if (merged.onPromptAssembled) {\n        try {\n          merged.onPromptAssembled({\n            battery: 'gemini_generate_content',\n            kind: 'request-body',\n            messages: body.contents,\n            tools: body.tools,\n            requestBody: body,\n            streamed: merged.stream === true,\n            streamId: dispatchStreamId,\n          })\n        } catch {\n          /* observer errors are non-fatal */\n        }\n      }\n\n      // ── dispatch ────────────────────────────────────────────────────────\n      const base = (merged.baseURL ?? DEFAULT_BASE_URL).replace(/\\/$/, '')\n      const action = merged.stream === true ? 'streamGenerateContent' : 'generateContent'\n      const url = `${base}/models/${merged.model}:${action}`\n      const headers: Record<string, string> = { 'Content-Type': 'application/json' }\n      if (merged.apiKey) {\n        // Google's own endpoint wants x-goog-api-key; several gateways in front of it accept only\n        // Authorization, hence the switch rather than sending both.\n        if (merged.useBearerAuth === true) headers.Authorization = `Bearer ${merged.apiKey}`\n        else headers['x-goog-api-key'] = merged.apiKey\n      }\n\n      const doFetch = merged.fetch ?? globalThis.fetch\n      let parsed: GeminiGenerateContentResponse\n      try {\n        const res = await doFetch(url, {\n          method: 'POST',\n          headers,\n          body: JSON.stringify(body),\n          signal: merged.timeoutMs ? AbortSignal.timeout(merged.timeoutMs) : ctx.abortSignal,\n        })\n        const text = await res.text()\n        if (!res.ok) {\n          // Classify the vendor's own signature rejection separately — it is actionable, and\n          // Gemini's generic INVALID_ARGUMENT body gives a caller nothing to act on.\n          if (/thought_signature|thoughtSignature/i.test(text)) {\n            ctx.nack(new E_GEMINI_MISSING_THOUGHT_SIGNATURE([text.slice(0, 400)]))\n            return\n          }\n          ctx.nack(new E_GEMINI_REQUEST_FAILED([res.status, text.slice(0, 400)]))\n          return\n        }\n        parsed = JSON.parse(text) as GeminiGenerateContentResponse\n      } catch (err) {\n        ctx.nack(new E_GEMINI_STREAM_ERROR([isError(err) ? err.message : String(err)]))\n        return\n      }\n\n      // ── interpret ───────────────────────────────────────────────────────\n      const { text, reasoning, functionCalls, finishReason } = extractGeminiGeneration(parsed)\n      const responseId = uuidv6()\n\n      if (text.length > 0) {\n        const messageId = `${responseId}:message`\n        helpers.reportMessage(messageId, text, { isComplete: true })\n        await ctx.storeMessage(\n          new Message({\n            id: messageId,\n            role: 'assistant',\n            content: text,\n            identity: selfIdentity,\n            createdAt: nowIso(),\n            updatedAt: nowIso(),\n          })\n        )\n      }\n      if (reasoning.length > 0) {\n        const thoughtId = `${responseId}:thought`\n        helpers.reportThought(thoughtId, reasoning, { isComplete: true })\n        await ctx.storeThought(\n          new Thought({\n            id: thoughtId,\n            content: reasoning,\n            identity: selfIdentity,\n            createdAt: nowIso(),\n            updatedAt: nowIso(),\n          })\n        )\n      }\n\n      // Fallback recovery: only consulted when the provider returned NO structured calls, so a\n      // native functionCall always wins over a parsed one.\n      let calls = functionCalls.map((c) => ({ id: uuidv6(), name: c.name, args: c.args }))\n      if (calls.length === 0 && merged.localToolCallParser !== undefined && text.length > 0) {\n        const parser = resolveToolCallParser(merged.localToolCallParser)\n        // The parser returns { calls, cleanedText } — not an iterable of calls — and the\n        // second argument carries the tool names actually offered this turn so a parser can\n        // reject a hallucinated name rather than manufacture a call for it.\n        const recovered = parser(text, { toolNames: ctx.tools.all().map((t) => t.name) })\n        for (const call of recovered.calls) {\n          calls.push({\n            id: uuidv6(),\n            name: call.name,\n            args: (call.arguments ?? {}) as Record<string, unknown>,\n          })\n        }\n      }\n\n      if (merged.onRawGeneration) {\n        try {\n          merged.onRawGeneration({\n            rawText: text,\n            cleanedText: text,\n            reasoning: reasoning.length > 0 ? [reasoning] : [],\n            toolCalls: calls.map((c) => ({ name: c.name, arguments: c.args as never })),\n            streamed: merged.stream === true,\n            streamId: dispatchStreamId,\n          })\n        } catch {\n          /* observer errors are non-fatal */\n        }\n      }\n\n      if (calls.length === 0) {\n        // `finishReason` is recorded for the caller; an empty generation is NOT an error here —\n        // it is a real vendor outcome and the runner decides what to do with it.\n        helpers.log.trace({\n          kind: 'gemini-finish',\n          message: `generation ended with finishReason=${finishReason ?? 'unknown'} and no function calls`,\n          payload: { finishReason: finishReason ?? 'unknown' },\n        })\n        if (merged.autoAck) ctx.ack()\n        return\n      }\n\n      for (const call of calls) {\n        if (ctx.abortSignal.aborted) return\n        const toolName = normalizeToolName(call.name)\n        const tool = ctx.tools.get(toolName) as Tool | ArtifactTool | undefined\n        const completedAt = nowIso()\n\n        if (!isObject(call.args)) {\n          const results = new Tokenizable(\n            new E_GEMINI_INVALID_TOOL_CALL_ARGS([JSON.stringify(call.args)]).message\n          )\n          helpers.reportToolCall(call.id, { tool: toolName, args: {} })\n          helpers.reportToolCall(call.id, { results, isError: true, isComplete: true })\n          await ctx.storeToolCall(\n            new ToolCall({\n              id: call.id,\n              tool: toolName,\n              args: {},\n              checksum: computeChecksum(toolName, {}),\n              isComplete: true,\n              isError: true,\n              results,\n              createdAt: completedAt,\n              updatedAt: completedAt,\n              completedAt,\n            })\n          )\n          continue\n        }\n\n        if (!tool) {\n          const available = ctx.tools\n            .all()\n            .map((t) => t.name)\n            .sort()\n          const results = new Tokenizable(\n            available.length > 0\n              ? `Tool not found: ${toolName}. Available tools: ${available.join(', ')}.`\n              : `Tool not found: ${toolName}. No tools are available this turn.`\n          )\n          helpers.reportToolCall(call.id, { tool: toolName, args: call.args })\n          helpers.reportToolCall(call.id, { results, isError: true, isComplete: true })\n          await ctx.storeToolCall(\n            new ToolCall({\n              id: call.id,\n              tool: toolName,\n              args: call.args,\n              checksum: computeChecksum(toolName, call.args),\n              isComplete: true,\n              isError: true,\n              results,\n              createdAt: completedAt,\n              updatedAt: completedAt,\n              completedAt,\n            })\n          )\n          continue\n        }\n\n        helpers.reportToolCall(call.id, { tool: tool.name, args: call.args })\n        let results: Tokenizable | SpooledArtifact | SpooledArtifact[] | Media | Media[] =\n          new Tokenizable('')\n        let isToolError = false\n        try {\n          const raw = await tool.executor(ctx)(call.args)\n          results = Tokenizable.isTokenizable(raw)\n            ? raw\n            : new Tokenizable(typeof raw === 'string' ? raw : JSON.stringify(raw ?? ''))\n        } catch (err) {\n          isToolError = true\n          results = new Tokenizable(isError(err) ? err.message : String(err))\n        }\n        const finishedAt = nowIso()\n        helpers.reportToolCall(call.id, { results, isError: isToolError, isComplete: true })\n        await ctx.storeToolCall(\n          new ToolCall({\n            id: call.id,\n            tool: tool.name,\n            args: call.args,\n            checksum: computeChecksum(tool.name, call.args),\n            isComplete: true,\n            isError: isToolError,\n            results,\n            createdAt: finishedAt,\n            updatedAt: finishedAt,\n            completedAt: finishedAt,\n          })\n        )\n      }\n    }\n  }\n}\n"],"mappings":"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"}

package/batteries/llm/gemini_generate_content/adapter.mjs

@@ -1,13 +1,13 @@
 import { n as isInstanceOf, r as isObject, t as isError } from "../../../guards-BEpY7lBI.mjs";
-import { r as Tokenizable } from "../../../tokenizable-DLMP68ZV.mjs";
-import { h as canonicalStringify } from "../../../spooled_artifact-BkueYJhR.mjs";
-import { n as Message, t as Thought } from "../../../thought-B8JAi3-W.mjs";
-import { t as ToolCall } from "../../../tool_call-CPjyvkm4.mjs";
-import "../../../common-v9Jo9M5k.mjs";
+import { r as Tokenizable } from "../../../tokenizable-VB4Av8GF.mjs";
+import { h as canonicalStringify } from "../../../spooled_artifact-Bw_7swIp.mjs";
+import { n as Message, t as Thought } from "../../../thought-BE1KGEhV.mjs";
+import { t as ToolCall } from "../../../tool_call-Cfaj-6zK.mjs";
+import "../../../common-BpdHIpQE.mjs";
 import "../../../guards.mjs";
 import { O as resolveToolCallParser } from "../../../tool_parsers-DgZhgxV8.mjs";
-import { A as renderMemories, E as normalizeToolName, F as renderThirdPartyPrivateRetrievables, I as renderThirdPartyPublicRetrievables, L as renderThought, M as renderRetrievableSafetyDirective, N as renderRetrievables, O as renderChatCompletionsSystemPrompt, P as renderStandingInstructions, R as renderTrustedContent, k as renderFirstPartyRetrievables, x as filterThoughts, y as descriptionToChatCompletionsJsonSchema, z as renderUntrustedContent } from "../../../helpers-CDmLDBq5.mjs";
-import { E_GEMINI_INVALID_TOOL_CALL_ARGS, E_GEMINI_MISSING_THOUGHT_SIGNATURE, E_GEMINI_REQUEST_FAILED, E_GEMINI_STREAM_ERROR } from "./exceptions.mjs";
+import { A as renderMemories, E as normalizeToolName, F as renderThirdPartyPrivateRetrievables, I as renderThirdPartyPublicRetrievables, L as renderThought, M as renderRetrievableSafetyDirective, N as renderRetrievables, O as renderChatCompletionsSystemPrompt, P as renderStandingInstructions, R as renderTrustedContent, k as renderFirstPartyRetrievables, x as filterThoughts, y as descriptionToChatCompletionsJsonSchema, z as renderUntrustedContent } from "../../../helpers-BH7HTtkD.mjs";
+import { E_GEMINI_GENERATE_CONTENT_CONTEXT_OVERFLOW, E_GEMINI_INVALID_TOOL_CALL_ARGS, E_GEMINI_MISSING_THOUGHT_SIGNATURE, E_GEMINI_REQUEST_FAILED, E_GEMINI_STREAM_ERROR, E_INVALID_GEMINI_GENERATE_CONTENT_OPTIONS } from "./exceptions.mjs";
 import { validateOptions } from "./validation.mjs";
 import { DEFAULT_GEMINI_BUCKET_ORDER, buildGeminiRequest, extractGeminiGeneration, mediaToGeminiInlineData, renderGeminiToolResult, toolsToGeminiTools } from "./helpers.mjs";
 import { DateTime } from "luxon";
@@ -41,6 +41,7 @@ var DEFAULT_BASE_URL = "https://generativelanguage.googleapis.com/v1beta";
 * Gemini reasoning session. See the option's TSDoc for why this is the default.
 */
 var DEFAULT_SENTINEL = "skip_thought_signature_validator";
+var estimateTokensOf = async (value, encoding) => Promise.resolve(value.estimateTokens(encoding));
 var computeChecksum = (tool, args) => sha256(`${tool}:${canonicalStringify(args)}`);
 /** Merge the three option layers, later winning. */
 var mergeOptions = (...layers) => {
@@ -118,6 +119,7 @@ var GeminiGenerateContentAdapter = class GeminiGenerateContentAdapter {
 			};
 			const stashRaw = ctx.stash.get(adapterClass.STASH_KEY, {});
 			const merged = validateOptions(mergeOptions(baseline, overrides, isObject(stashRaw) ? stashRaw : {}));
+			if (merged.tokenEncoding !== void 0 && merged.tokenEncoding !== null && merged.contextWindow === void 0) throw new E_INVALID_GEMINI_GENERATE_CONTENT_OPTIONS(["tokenEncoding is non-null but contextWindow is undefined"]);
 			const resolved = resolveHelpers(merged.helpers);
 			const selfIdentity = "assistant";
 			const dispatchStreamId = v6();
@@ -131,6 +133,26 @@ var GeminiGenerateContentAdapter = class GeminiGenerateContentAdapter {
 				unsupportedMediaPolicy: merged.unsupportedMediaPolicy ?? "throw",
 				warn
 			}));
+			if (merged.tokenEncoding !== void 0 && merged.tokenEncoding !== null && merged.contextWindow !== void 0) {
+				const encoding = merged.tokenEncoding;
+				let total = await estimateTokensOf(ctx.systemPrompt, encoding);
+				for (const value of ctx.standingInstructions) total += await estimateTokensOf(value, encoding);
+				for (const memory of ctx.turnMemories) total += await estimateTokensOf(memory.content, encoding);
+				for (const retrievable of ctx.turnRetrievables) total += await estimateTokensOf(retrievable.inline ? retrievable.content : new Tokenizable(`[Reference available: ${retrievable.id}]`), encoding);
+				for (const message of ctx.turnMessages) if (message.content !== void 0) total += await estimateTokensOf(message.content, encoding);
+				for (const thought of ctx.turnThoughts) total += await estimateTokensOf(thought.content, encoding);
+				for (const result of renderedToolCallResults.values()) total += await estimateTokensOf(new Tokenizable(JSON.stringify(result)), encoding);
+				const tools = ctx.tools.visible();
+				if (tools.length > 0) {
+					const toolTokens = await estimateTokensOf(new Tokenizable(JSON.stringify(resolved.toolsToGeminiTools(tools))), encoding);
+					total += Math.ceil(toolTokens * 1.5);
+				}
+				if (total + (merged.maxOutputTokens ?? 0) > merged.contextWindow) throw new E_GEMINI_GENERATE_CONTENT_CONTEXT_OVERFLOW([
+					total + (merged.maxOutputTokens ?? 0),
+					merged.contextWindow,
+					encoding
+				]);
+			}
 			const request = await resolved.buildGeminiRequest({
 				systemPrompt: ctx.systemPrompt,
 				standingInstructions: ctx.standingInstructions,
@@ -262,7 +284,7 @@ var GeminiGenerateContentAdapter = class GeminiGenerateContentAdapter {
 					message: `generation ended with finishReason=${finishReason ?? "unknown"} and no function calls`,
 					payload: { finishReason: finishReason ?? "unknown" }
 				});
-				ctx.ack();
+				if (merged.autoAck) ctx.ack();
 				return;
 			}
 			for (const call of calls) {