@sensigo/realm-cli 0.35.0 → 0.37.0

package/dist/agent/fixtures/tool-schemas.d.ts

@@ -0,0 +1,42 @@
+/**
+ * REAL, unmodified: GitHub's `list_pull_requests` tool.
+ *
+ * Ineligible for strict, and it fails for BOTH of the census's dominant reasons at once:
+ *   - no `additionalProperties: false` anywhere (G1 — near-universal in the wild: 192/193
+ *     measured schemas), and
+ *   - `minimum`/`maximum` on the pagination parameters (G2-hard — the dominant github class,
+ *     54 of 116 tools).
+ * Neither is realm's to fix: this schema belongs to the MCP server that publishes it.
+ */
+export declare const GITHUB_LIST_PULL_REQUESTS_SCHEMA: Record<string, unknown>;
+/**
+ * SYNTHETIC, strict-eligible with ZERO optional properties — the only shape that draws no
+ * caveats at all. Every property is `required`, so it also consumes zero of the 24-optional
+ * budget, which makes it the neutral element in the budget-composition pins.
+ */
+export declare const ELIGIBLE_NO_OPTIONALS_SCHEMA: Record<string, unknown>;
+/**
+ * SYNTHETIC, ineligible (no `additionalProperties: false`) and carrying ZERO optional properties.
+ *
+ * The zero-optional part is load-bearing for test isolation: it lets a pin use an ineligible tool
+ * WITHOUT that tool's optional count being able to disturb the budget arithmetic, so a mutation
+ * to the eligible-only budget rule reds only the pin that targets that rule.
+ */
+export declare const INELIGIBLE_NO_OPTIONALS_SCHEMA: Record<string, unknown>;
+/**
+ * Builds a synthetic strict-eligible schema with exactly `optionalCount` optional properties —
+ * the budget pins need precise, arbitrary optional counts (up to and across the API's 24 limit)
+ * that no real corpus schema happens to provide.
+ */
+export declare function eligibleWithOptionals(optionalCount: number): Record<string, unknown>;
+/**
+ * CONVERTER-DERIVED: the shape a zod-v3-style `toJSONSchema` emits — an explicit
+ * `additionalProperties: false` (which is why this class is strict-attachable at all) alongside a
+ * `$schema` dialect stamp and optional properties.
+ *
+ * Eligible WITH caveats, and it is the realistic caveat cell: the census found the `$schema`
+ * stamp to be the universal caveat driver, and any optional property additionally draws
+ * `optional_emission`. Both are informational — neither blocks strict.
+ */
+export declare const CONVERTER_DERIVED_WITH_CAVEATS_SCHEMA: Record<string, unknown>;
+//# sourceMappingURL=tool-schemas.d.ts.map

package/dist/agent/fixtures/tool-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-schemas.d.ts","sourceRoot":"","sources":["../../../src/agent/fixtures/tool-schemas.ts"],"names":[],"mappings":"AAoBA;;;;;;;;;GASG;AACH,eAAO,MAAM,gCAAgC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CA0DpE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAQhE,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAIlE,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWpF;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,qCAAqC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CASzE,CAAC"}

package/dist/agent/fixtures/tool-schemas.js

@@ -0,0 +1,150 @@
+// Tool-argument schema fixtures for issue #311 (strict MCP tool-call arguments).
+//
+// Three populations, each earning its place:
+//   1. REAL, third-party, ineligible — proves the verdict function's behaviour against a schema
+//      realm did not author and cannot change.
+//   2. SYNTHETIC eligible — no public MCP server in the census ships a clean strict-attachable
+//      schema (0/238 clean; 21/238 attachable, 20 of those from one server via a converter
+//      accident), so the eligible cells MUST be synthetic. They are honest clones in shape, not
+//      inventions of a schema style nobody uses.
+//   3. CONVERTER-DERIVED with caveats — the shape a zod-v3-style converter emits: explicit
+//      `additionalProperties: false` plus a `$schema` dialect stamp and optional properties.
+//
+// ATTRIBUTION — the fixture in population 1 is copied VERBATIM from:
+//   github/github-mcp-server, pkg/github/__toolsnaps__/list_pull_requests.snap
+//   Licence: MIT (Copyright (c) 2024 GitHub, Inc.)
+//   Snapshot: commit 0ea1f775a7c73eff1bd2e25904d01136756bbfe2, fetched 2026-08-16.
+// It is a SNAPSHOT, deliberately frozen: it pins how realm assesses a real published tool schema
+// as of that date. If upstream changes its schema, this fixture must NOT be silently refreshed —
+// re-snapshot it deliberately, with the commit and date updated here, and re-read the pins.
+/**
+ * REAL, unmodified: GitHub's `list_pull_requests` tool.
+ *
+ * Ineligible for strict, and it fails for BOTH of the census's dominant reasons at once:
+ *   - no `additionalProperties: false` anywhere (G1 — near-universal in the wild: 192/193
+ *     measured schemas), and
+ *   - `minimum`/`maximum` on the pagination parameters (G2-hard — the dominant github class,
+ *     54 of 116 tools).
+ * Neither is realm's to fix: this schema belongs to the MCP server that publishes it.
+ */
+export const GITHUB_LIST_PULL_REQUESTS_SCHEMA = {
+    type: 'object',
+    required: ['owner', 'repo'],
+    properties: {
+        base: { description: 'Filter by base branch', type: 'string' },
+        direction: { description: 'Sort direction', enum: ['asc', 'desc'], type: 'string' },
+        fields: {
+            description: "Subset of fields to return for each pull request. If omitted, all fields are returned. Use this to reduce response size when you only need specific fields; omitting 'body' in particular drops the largest per-result data.",
+            items: {
+                enum: [
+                    'number',
+                    'title',
+                    'body',
+                    'state',
+                    'draft',
+                    'merged',
+                    'mergeable_state',
+                    'html_url',
+                    'user',
+                    'labels',
+                    'assignees',
+                    'requested_reviewers',
+                    'merged_by',
+                    'head',
+                    'base',
+                    'additions',
+                    'deletions',
+                    'changed_files',
+                    'commits',
+                    'comments',
+                    'created_at',
+                    'updated_at',
+                    'closed_at',
+                    'merged_at',
+                    'milestone',
+                ],
+                type: 'string',
+            },
+            type: 'array',
+        },
+        head: { description: 'Filter by head user/org and branch', type: 'string' },
+        owner: { description: 'Repository owner', type: 'string' },
+        page: { description: 'Page number for pagination (min 1)', minimum: 1, type: 'number' },
+        perPage: {
+            description: 'Results per page for pagination (min 1, max 100)',
+            maximum: 100,
+            minimum: 1,
+            type: 'number',
+        },
+        repo: { description: 'Repository name', type: 'string' },
+        sort: {
+            description: 'Sort by',
+            enum: ['created', 'updated', 'popularity', 'long-running'],
+            type: 'string',
+        },
+        state: { description: 'Filter by state', type: 'string' },
+    },
+};
+/**
+ * SYNTHETIC, strict-eligible with ZERO optional properties — the only shape that draws no
+ * caveats at all. Every property is `required`, so it also consumes zero of the 24-optional
+ * budget, which makes it the neutral element in the budget-composition pins.
+ */
+export const ELIGIBLE_NO_OPTIONALS_SCHEMA = {
+    type: 'object',
+    additionalProperties: false,
+    required: ['owner', 'repo'],
+    properties: {
+        owner: { type: 'string', description: 'Repository owner' },
+        repo: { type: 'string', description: 'Repository name' },
+    },
+};
+/**
+ * SYNTHETIC, ineligible (no `additionalProperties: false`) and carrying ZERO optional properties.
+ *
+ * The zero-optional part is load-bearing for test isolation: it lets a pin use an ineligible tool
+ * WITHOUT that tool's optional count being able to disturb the budget arithmetic, so a mutation
+ * to the eligible-only budget rule reds only the pin that targets that rule.
+ */
+export const INELIGIBLE_NO_OPTIONALS_SCHEMA = {
+    type: 'object',
+    required: ['x'],
+    properties: { x: { type: 'string' } },
+};
+/**
+ * Builds a synthetic strict-eligible schema with exactly `optionalCount` optional properties —
+ * the budget pins need precise, arbitrary optional counts (up to and across the API's 24 limit)
+ * that no real corpus schema happens to provide.
+ */
+export function eligibleWithOptionals(optionalCount) {
+    const properties = { id: { type: 'string' } };
+    for (let i = 0; i < optionalCount; i += 1) {
+        properties[`opt_${i}`] = { type: 'string' };
+    }
+    return {
+        type: 'object',
+        additionalProperties: false,
+        required: ['id'], // `id` is required, so exactly `optionalCount` properties are optional
+        properties,
+    };
+}
+/**
+ * CONVERTER-DERIVED: the shape a zod-v3-style `toJSONSchema` emits — an explicit
+ * `additionalProperties: false` (which is why this class is strict-attachable at all) alongside a
+ * `$schema` dialect stamp and optional properties.
+ *
+ * Eligible WITH caveats, and it is the realistic caveat cell: the census found the `$schema`
+ * stamp to be the universal caveat driver, and any optional property additionally draws
+ * `optional_emission`. Both are informational — neither blocks strict.
+ */
+export const CONVERTER_DERIVED_WITH_CAVEATS_SCHEMA = {
+    $schema: 'https://json-schema.org/draft/2020-12/schema',
+    type: 'object',
+    additionalProperties: false,
+    required: ['url'],
+    properties: {
+        url: { type: 'string', description: 'Target URL' },
+        timeout: { type: 'number', description: 'Optional timeout in milliseconds' },
+    },
+};
+//# sourceMappingURL=tool-schemas.js.map

package/dist/agent/fixtures/tool-schemas.js.map

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

package/dist/agent/mcp/mcp-extensions.d.ts

@@ -11,6 +11,16 @@ export interface ToolDefinition {
     name: string;
     description: string;
     inputSchema: Record<string, unknown>;
+    /**
+     * Issue #311: attach `strict: true` to THIS tool on the wire. Additive-optional; absent (the
+     * default) is today's behaviour byte-identical.
+     *
+     * The SELECTION decision lives entirely in run-agent (per-tool eligibility verdict + the
+     * declared-order budget walk) and rides down per tool here, rather than as a name list in the
+     * options object, so the marker can never drift out of sync with the tools array it describes.
+     * A provider that ignores this field simply sends every tool unconstrained.
+     */
+    strict?: boolean;
 }
 export type ToolExecutor = (toolName: string, args: Record<string, unknown>) => Promise<unknown>;
 export interface StepWithToolsResult {
@@ -25,12 +35,38 @@ export interface StepWithToolsResult {
      */
     correctionCount?: number;
     /**
-     * Issue #236: additive, present only on the tools-path leg the design's by-construction-only
-     * coverage note describes (G6 makes every tools-bearing step ineligible for strict end-to-end,
-     * so this is never populated by AnthropicProvider in v1 — the field exists so a FUTURE
-     * provider/version can populate it without another interface change).
+     * Issue #236: additive, present only on the tools-path leg.
+     *
+     * Issue #311 truth-fix: the original note here claimed this "is never populated by
+     * AnthropicProvider in v1" because "G6 makes every tools-bearing step ineligible for strict
+     * end-to-end". That premise died with #311's Phase-A gate change — strict is now genuinely
+     * reachable on a tools-bearing step, applied to TOOL-CALL ARGUMENTS. This field still carries
+     * the step-OUTPUT meta only; the tool-arguments story is assembled by run-agent from the
+     * per-tool verdicts plus `toolArgsStrictDrop` below.
      */
     structuredOutput?: StructuredOutputMeta;
+    /**
+     * Issue #311: what the WIRE did to strict during this call, when a live 400/503 forced realm to
+     * drop it part-way through the attempt. Absent when nothing was dropped.
+     *
+     * The provider reports only what it observed (status class + captured message + how many
+     * strict-decorated requests had already returned 200); it never assembles evidence. run-agent
+     * owns the `tool_args` block, because only it knows the declared tool order, each tool's
+     * eligibility verdict, and which tools the budget walk selected.
+     */
+    toolArgsStrictDrop?: {
+        /** Status-derived label ONLY — never parsed out of the message body. */
+        reason: 'api_rejected_schema' | 'grammar_unavailable' | 'service_unavailable';
+        /** The raw API error text, verbatim, for the operator to compare against the provider's own. */
+        api_message?: string;
+        /** Issue #313: the provider's machine-readable error fields, captured verbatim. `null` is
+         *  preserved and meaningful (OpenAI returns both null for the model-unsupported class).
+         *  Never keyed on — capture-only, same discipline as the step-level pair. */
+        api_param?: string | null;
+        api_code?: string | null;
+        /** Strict-decorated requests that returned 200 before the drop; 0 = the first one was rejected. */
+        strict_turns_before_drop: number;
+    };
 }
 export interface McpClient {
     /**

package/dist/agent/mcp/mcp-extensions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-extensions.d.ts","sourceRoot":"","sources":["../../../src/agent/mcp/mcp-extensions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC5F,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,CAAC;AAGhD,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAGD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAGD,MAAM,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAGjG,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,SAAS,EAAE,cAAc,EAAE,CAAC;IAE5B;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;CACzC;AAGD,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACpE,8CAA8C;IAC9C,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1F;;;;OAIG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B"}
+{"version":3,"file":"mcp-extensions.d.ts","sourceRoot":"","sources":["../../../src/agent/mcp/mcp-extensions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC5F,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,CAAC;AAGhD,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAGD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAGD,MAAM,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAGjG,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,SAAS,EAAE,cAAc,EAAE,CAAC;IAE5B;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;IACxC;;;;;;;;OAQG;IACH,kBAAkB,CAAC,EAAE;QACnB,wEAAwE;QACxE,MAAM,EAAE,qBAAqB,GAAG,qBAAqB,GAAG,qBAAqB,CAAC;QAC9E,gGAAgG;QAChG,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB;;qFAE6E;QAC7E,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,mGAAmG;QACnG,wBAAwB,EAAE,MAAM,CAAC;KAClC,CAAC;CACH;AAGD,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACpE,8CAA8C;IAC9C,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1F;;;;OAIG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B"}

package/dist/agent/providers/agent-utils.d.ts

@@ -79,4 +79,26 @@ export declare function summarizeAgentValidationErrors(rawErrors: RawValidationE
 export declare function renderValidationSummaryEntry(entry: AgentValidationErrorEntry): string;
 /** Returns a Promise that rejects with a timeout error after `ms` milliseconds. */
 export declare function rejectAfter(ms: number): Promise<never>;
+/**
+ * Issue #313: the ONE shared HTTP-status extractor, hoisted verbatim from anthropic-provider.ts
+ * so both provider ladders key on the same duck-type instead of maintaining a copy each.
+ *
+ * Duck-typed by necessity — both `@anthropic-ai/sdk` and `openai` are consumer-supplied peer
+ * dependencies (absent from this repo and CI), so neither SDK's real error class can be
+ * imported or `instanceof`-checked here. `.status` is the documented public `APIError` contract
+ * of both SDKs. ACCEPTED RESIDUAL, on record and owner-ratified: this shape cannot be verified
+ * in CI. It inherits exactly the class the owner ratified for the Anthropic SDK in #236 — if a
+ * future SDK major renamed the field, the ladder would stop engaging and every strict failure
+ * would surface as a plain error rather than a silent wrong downgrade (fail-loud, not fail-quiet).
+ */
+export declare function extractHttpStatus(err: unknown): number | undefined;
+/**
+ * Issue #313: the provider's machine-readable error fields, captured VERBATIM for evidence.
+ * `null` is preserved and meaningful — OpenAI returns `param: null, code: null` for the
+ * model-unsupported class, where the message is prose-only. Realm never keys on these.
+ */
+export declare function extractApiErrorFields(err: unknown): {
+    api_param?: string | null;
+    api_code?: string | null;
+};
 //# sourceMappingURL=agent-utils.d.ts.map

package/dist/agent/providers/agent-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-utils.d.ts","sourceRoot":"","sources":["../../../src/agent/providers/agent-utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AActF;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,wBAAwB,CAAC,EAAE,MAAM,EACjC,qBAAqB,CAAC,EAAE,OAAO,GAC9B,MAAM,CASR;AAUD,6EAA6E;AAC7E,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAE5E;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAqBlD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAG3D;AAED,yFAAyF;AACzF,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAMpF;AAqED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAQ9E;AAiBD;;;;;;GAMG;AACH,MAAM,WAAW,yBAA0B,SAAQ,2BAA2B;IAC5E;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,kBAAkB,EAAE,GAC9B,yBAAyB,EAAE,CA0C7B;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,yBAAyB,GAAG,MAAM,CAarF;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAItD"}
+{"version":3,"file":"agent-utils.d.ts","sourceRoot":"","sources":["../../../src/agent/providers/agent-utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AActF;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,wBAAwB,CAAC,EAAE,MAAM,EACjC,qBAAqB,CAAC,EAAE,OAAO,GAC9B,MAAM,CASR;AAUD,6EAA6E;AAC7E,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAE5E;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAqBlD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAG3D;AAED,yFAAyF;AACzF,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAMpF;AAqED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAQ9E;AAiBD;;;;;;GAMG;AACH,MAAM,WAAW,yBAA0B,SAAQ,2BAA2B;IAC5E;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,kBAAkB,EAAE,GAC9B,yBAAyB,EAAE,CA0C7B;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,yBAAyB,GAAG,MAAM,CAarF;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAItD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAMlE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG;IACnD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAOA"}

package/dist/agent/providers/agent-utils.js

@@ -255,4 +255,40 @@ export function renderValidationSummaryEntry(entry) {
 export function rejectAfter(ms) {
     return new Promise((_, reject) => setTimeout(() => reject(new Error(`tool call timed out after ${ms}ms`)), ms));
 }
+/**
+ * Issue #313: the ONE shared HTTP-status extractor, hoisted verbatim from anthropic-provider.ts
+ * so both provider ladders key on the same duck-type instead of maintaining a copy each.
+ *
+ * Duck-typed by necessity — both `@anthropic-ai/sdk` and `openai` are consumer-supplied peer
+ * dependencies (absent from this repo and CI), so neither SDK's real error class can be
+ * imported or `instanceof`-checked here. `.status` is the documented public `APIError` contract
+ * of both SDKs. ACCEPTED RESIDUAL, on record and owner-ratified: this shape cannot be verified
+ * in CI. It inherits exactly the class the owner ratified for the Anthropic SDK in #236 — if a
+ * future SDK major renamed the field, the ladder would stop engaging and every strict failure
+ * would surface as a plain error rather than a silent wrong downgrade (fail-loud, not fail-quiet).
+ */
+export function extractHttpStatus(err) {
+    if (typeof err === 'object' && err !== null && 'status' in err) {
+        const status = err.status;
+        if (typeof status === 'number')
+            return status;
+    }
+    return undefined;
+}
+/**
+ * Issue #313: the provider's machine-readable error fields, captured VERBATIM for evidence.
+ * `null` is preserved and meaningful — OpenAI returns `param: null, code: null` for the
+ * model-unsupported class, where the message is prose-only. Realm never keys on these.
+ */
+export function extractApiErrorFields(err) {
+    if (typeof err !== 'object' || err === null)
+        return {};
+    const e = err;
+    const out = {};
+    if ('param' in e)
+        out.api_param = typeof e.param === 'string' ? e.param : null;
+    if ('code' in e)
+        out.api_code = typeof e.code === 'string' ? e.code : null;
+    return out;
+}
 //# sourceMappingURL=agent-utils.js.map

package/dist/agent/providers/agent-utils.js.map

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

package/dist/agent/providers/anthropic-provider.d.ts

@@ -1,5 +1,5 @@
 import { type StructuredOutputMeta } from '@sensigo/realm';
-import { ToolCapableLlmProvider } from './llm-provider.js';
+import { ToolCapableLlmProvider, type ProviderCapabilities } from './llm-provider.js';
 import type { ToolDefinition, ToolExecutor, StepWithToolsResult } from '../mcp/mcp-extensions.js';
 /**
  * Thrown when the ladder's OWN drop-strict retry ALSO fails — design §4 [R2-7]: (a) carries the
@@ -23,6 +23,17 @@ export declare class StructuredOutputLadderError extends Error {
 export declare class AnthropicProvider extends ToolCapableLlmProvider {
     private readonly model;
     constructor(model: string);
+    /**
+     * Issue #311 (capability guard). AnthropicProvider is the ONLY provider that reads
+     * `ToolDefinition.strict` and threads it onto the request (see the `anthropicTools.push` in
+     * `callStepWithTools`). Declaring `toolArgsStrict` here is what authorizes run-agent to mark
+     * tools and to record `strict_sent: true` in evidence — a provider whose wire builder ignores
+     * the marker must never produce that claim.
+     *
+     * `jsonMode` keeps the base value: this provider constrains output via the submit TOOL, never
+     * via a `response_format` json_object mode.
+     */
+    capabilities(): ProviderCapabilities;
     private getClient;
     /**
      * Shared body for `callStep`/`callStepWithMeta` (issue #236). `strictRequested` is `undefined`

package/dist/agent/providers/anthropic-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic-provider.d.ts","sourceRoot":"","sources":["../../../src/agent/providers/anthropic-provider.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAEV,cAAc,EACd,YAAY,EACZ,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AA8FlC;;;;;;;GAOG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,CAAC;gBAE9C,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,oBAAoB,EACtC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAMhC;AA8DD;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,sBAAsB;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,MAAM;YAK5B,SAAS;IAoBvB;;;;;OAKG;YACW,gBAAgB;IA0GxB,QAAQ,CACZ,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,wBAAwB,CAAC,EAAE,MAAM,GAChC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAUnC;yFACqF;IACtE,gBAAgB,CAC7B,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,wBAAwB,CAAC,EAAE,MAAM,EACjC,IAAI,CAAC,EAAE;QAAE,sBAAsB,CAAC,EAAE,OAAO,CAAA;KAAE,GAC1C,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,IAAI,CAAC,EAAE,oBAAoB,CAAA;KAAE,CAAC;IAS5E;;;;OAIG;IACG,iBAAiB,CACrB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,cAAc,EAAE,EACvB,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE;QACP,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACtC,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChD,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjD,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,wBAAwB,CAAC,EAAE,MAAM,CAAC;KACnC,GACA,OAAO,CAAC,mBAAmB,CAAC;CAwThC"}
+{"version":3,"file":"anthropic-provider.d.ts","sourceRoot":"","sources":["../../../src/agent/providers/anthropic-provider.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,KAAK,EAEV,cAAc,EACd,YAAY,EACZ,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AAuFlC;;;;;;;GAOG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,CAAC;gBAE9C,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,oBAAoB,EACtC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAMhC;AA8DD;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,sBAAsB;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,MAAM;IAI1C;;;;;;;;;OASG;IACH,YAAY,IAAI,oBAAoB;YAKtB,SAAS;IAoBvB;;;;;OAKG;YACW,gBAAgB;IA0GxB,QAAQ,CACZ,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,wBAAwB,CAAC,EAAE,MAAM,GAChC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAUnC;yFACqF;IACtE,gBAAgB,CAC7B,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,wBAAwB,CAAC,EAAE,MAAM,EACjC,IAAI,CAAC,EAAE;QAAE,sBAAsB,CAAC,EAAE,OAAO,CAAA;KAAE,GAC1C,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,IAAI,CAAC,EAAE,oBAAoB,CAAA;KAAE,CAAC;IAS5E;;;;OAIG;IACG,iBAAiB,CACrB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,cAAc,EAAE,EACvB,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE;QACP,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACtC,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChD,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjD,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,wBAAwB,CAAC,EAAE,MAAM,CAAC;KACnC,GACA,OAAO,CAAC,mBAAmB,CAAC;CAmZhC"}

package/dist/agent/providers/anthropic-provider.js

@@ -2,7 +2,7 @@
 // Requires @anthropic-ai/sdk >= 0.20.0 as an optional peer dependency (npm install @anthropic-ai/sdk).
 import { WorkflowError, validateAgentSubmission, } from '@sensigo/realm';
 import { ToolCapableLlmProvider } from './llm-provider.js';
-import { sanitizeError, serializeToolResult, parseNamespacedId, extractJsonObject, rejectAfter, buildSystemPrompt, summarizeAgentValidationErrors, renderValidationSummaryEntry, } from './agent-utils.js';
+import { sanitizeError, serializeToolResult, parseNamespacedId, extractJsonObject, rejectAfter, buildSystemPrompt, summarizeAgentValidationErrors, renderValidationSummaryEntry, extractHttpStatus, } from './agent-utils.js';
 /** The tool offered at `tool_choice:'auto'` so the model can return structured output directly —
  * `tool_use.input` arrives pre-parsed, eliminating the fenced/prefaced-JSON parse-failure class by
  * construction. `auto` (never forced) preserves reason-then-answer: a workflow whose output schema
@@ -59,17 +59,8 @@ function resolveMaxTokens(model) {
  *  — the label match keys on THIS string only, never a broader "any 503" heuristic). A stale/
  *  non-matching message degrades to the generic `service_unavailable` label (fail-safe). */
 const GRAMMAR_UNAVAILABLE_TEXT = 'Grammar compilation is temporarily unavailable';
-/** Duck-typed extraction — the `@anthropic-ai/sdk` package is a consumer-supplied peer dependency
- *  (absent from this repo and CI), so its real error class can never be imported/instanceof-
- *  checked here. `.status`/`.message` are the SDK's own long-stable public `APIError` contract. */
-function extractHttpStatus(err) {
-    if (typeof err === 'object' && err !== null && 'status' in err) {
-        const status = err.status;
-        if (typeof status === 'number')
-            return status;
-    }
-    return undefined;
-}
+// Issue #313: `extractHttpStatus` now lives in agent-utils.ts, shared with the OpenAI ladder —
+// a pure move, zero behaviour change. `extractErrorMessage` deliberately stays local.
 function extractErrorMessage(err) {
     return err instanceof Error ? err.message : String(err);
 }
@@ -139,6 +130,19 @@ export class AnthropicProvider extends ToolCapableLlmProvider {
         super();
         this.model = model;
     }
+    /**
+     * Issue #311 (capability guard). AnthropicProvider is the ONLY provider that reads
+     * `ToolDefinition.strict` and threads it onto the request (see the `anthropicTools.push` in
+     * `callStepWithTools`). Declaring `toolArgsStrict` here is what authorizes run-agent to mark
+     * tools and to record `strict_sent: true` in evidence — a provider whose wire builder ignores
+     * the marker must never produce that claim.
+     *
+     * `jsonMode` keeps the base value: this provider constrains output via the submit TOOL, never
+     * via a `response_format` json_object mode.
+     */
+    capabilities() {
+        return { jsonMode: false, toolArgsStrict: true, providerId: 'anthropic' };
+    }
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     async getClient() {
         // Dynamically import @anthropic-ai/sdk to keep it an optional peer dependency.
@@ -276,6 +280,10 @@ export class AnthropicProvider extends ToolCapableLlmProvider {
                 name: tool.name,
                 description: tool.description,
                 input_schema: tool.inputSchema, // note: input_schema, not parameters
+                // issue #311: per-tool strict, same spread SHAPE as buildSubmitTool's own `strict` option
+                // — the key only ever appears when run-agent selected this tool, so a non-selected tool's
+                // wire entry stays byte-identical to today's.
+                ...(tool.strict === true ? { strict: true } : {}),
             });
         }
         const maxCalls = options.maxToolCalls ?? 20;
@@ -291,8 +299,15 @@ export class AnthropicProvider extends ToolCapableLlmProvider {
         let correction_count = 0;
         const tool_call_records = [];
         const system = buildSystemPrompt(options.inputSchema, options.agentProfileInstructions);
-        /** Attaches `correctionCount` to a result only when at least one correction happened. */
-        const withCorrectionCount = (result) => correction_count > 0 ? { ...result, correctionCount: correction_count } : result;
+        /** Attaches `correctionCount` to a result only when at least one correction happened, plus
+         *  (issue #311) the tool-args drop facts when the ladder below dropped strict mid-attempt.
+         *  This is the single result chokepoint for `callStepWithTools` — every successful return
+         *  goes through it, so neither field can be forgotten on a new exit path. */
+        const withCorrectionCount = (result) => ({
+            ...result,
+            ...(correction_count > 0 ? { correctionCount: correction_count } : {}),
+            ...(toolArgsStrictDrop !== undefined ? { toolArgsStrictDrop } : {}),
+        });
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         const history = [{ role: 'user', content: prompt }];
         const buildMainCallOpts = () => {
@@ -302,10 +317,79 @@ export class AnthropicProvider extends ToolCapableLlmProvider {
                 system,
                 messages: history,
             };
-            if (anthropicTools.length > 0)
-                opts['tools'] = anthropicTools;
+            if (anthropicTools.length > 0) {
+                // issue #311: once strict has been dropped, every later turn sends STRIPPED COPIES rather
+                // than the mutated originals. Mutating the shared objects in place would retroactively
+                // rewrite the request objects already handed to the SDK for earlier turns — an aliasing
+                // hazard, and it makes the wire history unreadable (a request that genuinely carried
+                // strict would appear never to have). Pre-drop — which includes every step that never
+                // opted in — the original array is passed exactly as before, with no copy.
+                opts['tools'] = toolArgsStrictStripped
+                    ? anthropicTools.map(({ strict: _strict, ...rest }) => rest)
+                    : anthropicTools;
+            }
             return opts;
         };
+        // -----------------------------------------------------------------------------------------
+        // issue #311 — the tool-arguments fallback ladder. ONE wrap point on the main agentic loop's
+        // only `messages.create`, which covers every turn of the loop including the #224
+        // in-conversation correction turns.
+        //
+        // Deliberately SEPARATE from the #236 ladder above (which owns the step-OUTPUT dimension on
+        // the callStep/callStepWithMeta path): the two dimensions fail independently, and the
+        // stickiness rules differ (see below). Status-only, exactly like #236 — the arm keys on HTTP
+        // status ∧ strict-carried, NEVER on message text.
+        // -----------------------------------------------------------------------------------------
+        let toolArgsStrictActive = anthropicTools.some((t) => t.strict === true);
+        let toolArgsStrictStripped = false;
+        let strictTurnsBeforeDrop = 0;
+        let toolArgsStrictDrop;
+        /** Stops sending strict for the REST of this invocation (the immediate retry included). */
+        const dropToolArgsStrict = () => {
+            toolArgsStrictActive = false;
+            toolArgsStrictStripped = true;
+        };
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const createMainTurn = async () => {
+            const carriedStrict = toolArgsStrictActive;
+            try {
+                const response = await // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                 client.messages.create(buildMainCallOpts());
+                // Only a strict-DECORATED request that came back 200 counts toward the disclosed
+                // "turns before drop" — that is exactly what the number claims.
+                if (carriedStrict)
+                    strictTurnsBeforeDrop += 1;
+                return response;
+            }
+            catch (err) {
+                // A turn that carried NO strict is none of this ladder's business: its 400 is a real
+                // failure of the request itself and must propagate untouched, never be re-attributed to
+                // structured output.
+                if (!carriedStrict)
+                    throw err;
+                const status = extractHttpStatus(err);
+                if (status !== 400 && status !== 503)
+                    throw err; // unrelated failure — never engage
+                const api_message = extractErrorMessage(err);
+                const reason = status === 400
+                    ? 'api_rejected_schema'
+                    : api_message.includes(GRAMMAR_UNAVAILABLE_TEXT)
+                        ? 'grammar_unavailable'
+                        : 'service_unavailable';
+                // Recorded BEFORE the drop so `strict_turns_before_drop` reports the 200s that preceded
+                // this rejection (0 = the first strict-carrying turn of the attempt was rejected).
+                toolArgsStrictDrop = {
+                    reason,
+                    api_message,
+                    strict_turns_before_drop: strictTurnsBeforeDrop,
+                };
+                dropToolArgsStrict();
+                // Retry the SAME turn once, unconstrained. A failure here is a genuine call failure and
+                // propagates — realm does not swallow it behind the ladder.
+                return await // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                 client.messages.create(buildMainCallOpts());
+            }
+        };
         // Forces a final answer: offers the __realm_submit__ tool at tool_choice:'auto' when a schema is
         // available (mirrors callStep's P0 mechanism — tool_use.input arrives pre-parsed, no parse step);
         // otherwise forces a plain text answer (tool_choice:'none', no tools array — can't type a tool
@@ -313,11 +397,20 @@ export class AnthropicProvider extends ToolCapableLlmProvider {
         // history ends with a valid user turn. NOT restructuring the agentic loop / MCP tools array —
         // this synthetic tool only ever appears on this ONE isolated extraction call.
         const performFinalExtraction = async () => {
-            // issue #236: buildSubmitTool's `strict` option is never threaded here — BY CONSTRUCTION,
-            // not by omission. This call site lives inside callStepWithTools, which only ever runs for
-            // tools-bearing steps; G6 makes every tools-bearing step ineligible for strict end-to-end
-            // in v1 (design §4 [CG]), so run-agent structurally never has a `true` to pass down this
-            // path. No end-to-end pin is possible here — do not add one.
+            // issue #236 + #311: buildSubmitTool's `strict` option is never threaded here — BY DESIGN
+            // now, no longer by construction.
+            //
+            // The old reasoning was that G6 made every tools-bearing step ineligible for strict, so a
+            // `true` could never reach this path at all. #311 killed that premise: a tools-bearing step
+            // CAN now be strict-declared, and its tools do carry strict on the wire. What #311 does NOT
+            // change is this call: the final extraction asks the model for the STEP'S OUTPUT, which on
+            // the tools fork is deliberately never grammar-constrained (that is precisely what the
+            // step-level `unsupported_context_tools` disclosure reports). Constraining it here would
+            // make that disclosure a lie.
+            //
+            // The old "no end-to-end pin is possible here — do not add one" instruction is therefore
+            // obsolete and is REPLACED: the pin is now both possible and required (test plan pin 15 —
+            // on an opted-in tools step, this call's opts never contain `strict`).
             const finalSubmitTool = options.inputSchema !== undefined ? buildSubmitTool(options.inputSchema) : undefined;
             const finalOpts = {
                 model: this.model,
@@ -376,8 +469,7 @@ export class AnthropicProvider extends ToolCapableLlmProvider {
             });
         };
         while (true) {
-            const response = await // eslint-disable-next-line @typescript-eslint/no-explicit-any
-             client.messages.create(buildMainCallOpts());
+            const response = await createMainTurn();
             const toolUseBlocks = response.content.filter((b) => b.type === 'tool_use');
             if (toolUseBlocks.length > 0) {
                 history.push({ role: 'assistant', content: response.content });