@salesforce/sfdx-agent-sdk 0.33.0 → 0.35.0

package/CHANGELOG.md

@@ -3,6 +3,26 @@
 All notable changes to `@salesforce/sfdx-agent-sdk` are documented in this file.
 Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [0.35.0] - 2026-07-22
+
+### Features
+- **harness-openai**: full conformance gate + e2e closeout @W-23447579@ ([#684](https://github.com/forcedotcom/agentic-dx/pull/684))
+- **harness-openai**: scaffold OpenAI Agents SDK harness with connectivity + streamed turn @W-23447570@ ([#675](https://github.com/forcedotcom/agentic-dx/pull/675))
+
+### Fixes
+- **ci**: bump openai harness off seed version so it can publish @W-23447579@ ([#686](https://github.com/forcedotcom/agentic-dx/pull/686))
+
+### Tests
+- **agent-sdk**: add raw-gateway fetch probe to isolate SDK/harness bugs from gateway failures @W-23477193@ ([#674](https://github.com/forcedotcom/agentic-dx/pull/674))
+
+### Chores
+- **deps-dev**: bump eslint from 10.6.0 to 10.7.0 in the eslint group ([#680](https://github.com/forcedotcom/agentic-dx/pull/680))
+
+## [0.34.0] - 2026-07-15
+
+### Features
+- **agent-sdk,harness-claude,harness-mastra**: per-model gateway config — geo-aware ids, thinking mode, param exclusion @W-23447370@ ([#672](https://github.com/forcedotcom/agentic-dx/pull/672))
+
 ## [0.33.0] - 2026-07-14
 
 ### Features

package/README.md

@@ -34,7 +34,7 @@ for (const failure of manager.getRestoreFailures()) {
 //    storage folder will replay this agent automatically.
 const agent = await manager.createAgent('/path/to/project', {
   agentId: 'developer-assistant',
-  modelId: 'llmgateway__OpenAIGPT5',
+  modelId: 'sfdc_ai__DefaultGPT5',
   instructions: 'You are a helpful Salesforce developer assistant.',
 });
 
@@ -232,19 +232,19 @@ function onApprovalRequest(event: ToolApprovalRequestEvent): Promise<boolean> {
 
 #### `AgentConfig`
 
-| Field                  | Type                 | Description                                                                                                                                                                                                                                                                                                                          |
-| ---------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `orgAlias?`            | `string`             | Salesforce org alias or username. Falls back to project/default org.                                                                                                                                                                                                                                                                 |
-| `modelId?`             | `ModelName \| Model` | LLM model selector. Pass a `ModelName` enum value for an in-tree model (e.g. `'llmgateway__OpenAIGPT5'`), or a pre-built `Model` instance to opt into a Bedrock-Anthropic Claude variant the SDK has not yet released — see `createClaudeModel(gatewayId, overrides)` exported from this package.                                    |
-| `name?`                | `string`             | Human-readable agent name.                                                                                                                                                                                                                                                                                                           |
-| `description?`         | `string`             | Agent purpose description.                                                                                                                                                                                                                                                                                                           |
-| `instructions?`        | `string`             | System instructions for the agent.                                                                                                                                                                                                                                                                                                   |
-| `tools?`               | `ToolDefinition[]`   | Consumer-executed tool schemas.                                                                                                                                                                                                                                                                                                      |
-| `mcpServers?`          | `MCPConfiguration`   | MCP server connections.                                                                                                                                                                                                                                                                                                              |
-| `skills?`              | `string[]`           | Each entry is either an individual skill folder (containing `SKILL.md`) or a parent folder containing skill subfolders. Relative and absolute paths supported; forms can be mixed in the same array.                                                                                                                                 |
-| `rules?`               | `string[]`           | Each entry is either an individual `.md` rule file or a directory of `.md` rule files (scanned one level deep, alphabetical, non-`.md` skipped). Bodies are composed verbatim into the agent's effective system prompt; YAML frontmatter is optional and stripped if present. Matches Claude Code's `.claude/rules/*.md` convention. |
-| `toolPolicies?`        | `ToolPolicyRule[]`   | Ordered per-tool approval rules resolved by `resolveToolApprovalPolicy` (cross-tier deny-wins / within-tier last-wins). Author directly or via `definePolicy(...)`. See "Tool Approval Policy" below.                                                                                                                                |
-| `defaultToolDecision?` | `Decision`           | Fallback decision when no rule matches. Defaults to `'allow'` (no policy ⇒ no gating). Set to `'require-approval'` for a fail-closed posture (recommended for catalogs with un-annotated MCP servers).                                                                                                                               |
+| Field                  | Type                 | Description                                                                                                                                                                                                                                                                                                                                                                  |
+| ---------------------- | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `orgAlias?`            | `string`             | Salesforce org alias or username. Falls back to project/default org.                                                                                                                                                                                                                                                                                                         |
+| `modelId?`             | `ModelName \| Model` | LLM model selector. Pass a `ModelName` enum value for an in-tree model (e.g. `'sfdc_ai__DefaultGPT5'`), or a pre-built `Model` instance to opt into a Bedrock-Anthropic Claude variant the SDK has not yet released — see `createClaudeModel(gatewayId, overrides)` exported from this package. Legacy pinned `llmgateway__*` ids still resolve via a back-compat alias map. |
+| `name?`                | `string`             | Human-readable agent name.                                                                                                                                                                                                                                                                                                                                                   |
+| `description?`         | `string`             | Agent purpose description.                                                                                                                                                                                                                                                                                                                                                   |
+| `instructions?`        | `string`             | System instructions for the agent.                                                                                                                                                                                                                                                                                                                                           |
+| `tools?`               | `ToolDefinition[]`   | Consumer-executed tool schemas.                                                                                                                                                                                                                                                                                                                                              |
+| `mcpServers?`          | `MCPConfiguration`   | MCP server connections.                                                                                                                                                                                                                                                                                                                                                      |
+| `skills?`              | `string[]`           | Each entry is either an individual skill folder (containing `SKILL.md`) or a parent folder containing skill subfolders. Relative and absolute paths supported; forms can be mixed in the same array.                                                                                                                                                                         |
+| `rules?`               | `string[]`           | Each entry is either an individual `.md` rule file or a directory of `.md` rule files (scanned one level deep, alphabetical, non-`.md` skipped). Bodies are composed verbatim into the agent's effective system prompt; YAML frontmatter is optional and stripped if present. Matches Claude Code's `.claude/rules/*.md` convention.                                         |
+| `toolPolicies?`        | `ToolPolicyRule[]`   | Ordered per-tool approval rules resolved by `resolveToolApprovalPolicy` (cross-tier deny-wins / within-tier last-wins). Author directly or via `definePolicy(...)`. See "Tool Approval Policy" below.                                                                                                                                                                        |
+| `defaultToolDecision?` | `Decision`           | Fallback decision when no rule matches. Defaults to `'allow'` (no policy ⇒ no gating). Set to `'require-approval'` for a fail-closed posture (recommended for catalogs with un-annotated MCP servers).                                                                                                                                                                       |
 
 #### `StreamOptions`
 
@@ -1037,7 +1037,7 @@ The connectivity facts a harness needs to make an LLM request. Five fields. Auth
 | --------------- | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `model`         | `Model`                                 | Capability descriptor used for pre-flight multimodal validation and SDK-side context-usage reporting.                                                                                                                                                                                                                |
 | `baseUrl`       | `string`                                | Provider-native or gateway base URL (no trailing slash, no path beyond the API root). Harnesses concat the wire-shape-specific path.                                                                                                                                                                                 |
-| `nativeModelId` | `string`                                | Wire id the provider SDK sets on the request body's `model` field. May differ from `model.name` (e.g. Anthropic-direct expects `claude-sonnet-4-6`; the Salesforce gateway expects `llmgateway__BedrockAnthropicClaude46Sonnet`).                                                                                    |
+| `nativeModelId` | `string`                                | Wire id the provider SDK sets on the request body's `model` field. May differ from `model.name` (e.g. Anthropic-direct expects `claude-sonnet-4-6`; the Salesforce gateway expects `sfdc_ai__DefaultBedrockAnthropicClaude46Sonnet`).                                                                                |
 | `providerHint`  | `ProviderHint`                          | Wire shape the harness should speak. The manager validates this against the harness's `supportedProviderHints` before any harness work begins; a harness only sees hints it recognizes.                                                                                                                              |
 | `getHeaders`    | `() => Promise<Record<string, string>>` | Returns the FULL header set (Authorization included) for the NEXT outbound request. **Per-call invocation contract.** Mastra harnesses MUST call this on every HTTP call (inside their fetch wrapper); Claude harnesses MUST call this once per subprocess spawn. Caching the returned map across requests is a bug. |
 
@@ -1084,7 +1084,7 @@ const manager = await createAgentManager('/path/to/storage', new MastraHarnessFa
 | `getApiKey`          | `() => string \| Promise<string>` | Returns the API key. Re-evaluated on every `resolve()` call, and the resulting `getHeaders()` re-invokes it on every header read so a rotating key source (env var, secret store, BYOK toggle) lands without reconstructing the resolver.                                       |
 | `baseUrl`            | `string`                          | Fully-qualified provider URL with API version segment (e.g. `https://api.openai.com/v1`, not `https://api.openai.com`).                                                                                                                                                         |
 | `providerHint`       | `ProviderHint`                    | Wire shape. Must be one a harness in the consumer's setup advertises via `HarnessFactory.supportedProviderHints`.                                                                                                                                                               |
-| `nativeModelIdFor?`  | `(model: Model) => string`        | Optional translator from canonical `model.name` to the endpoint-native model id. Direct-provider endpoints expect their own naming (`claude-sonnet-4-6`); gateway-shaped endpoints accept the canonical `llmgateway__*` id verbatim. Defaults to `model.name`.                  |
+| `nativeModelIdFor?`  | `(model: Model) => string`        | Optional translator from canonical `model.name` to the endpoint-native model id. Direct-provider endpoints expect their own naming (`claude-sonnet-4-6`); gateway-shaped endpoints accept the canonical `sfdc_ai__Default*` id verbatim. Defaults to `model.name`.              |
 | `connectionFactory?` | `OrgConnectionFactory`            | Optional. When supplied, the resolver mints an org connection + JWT alongside the api-key bag — the BYOK shape (api-key authenticates the LLM; org JWT authenticates MCP servers / identity). Without it, `orgConnection` and `orgJwt` are omitted from `ResolvedConnectivity`. |
 
 The resolver throws `AgentSDKError(NOT_SUPPORTED)` when `getApiKey()` returns empty / nullish so consumers see "the
@@ -1096,6 +1096,11 @@ header bag. **Reserved auth headers are not overridable**: the resolver spreads
 `Authorization` / `Content-Type` last, so a `Model` instance whose `customHeaders` includes an `Authorization` key
 silently shadows nothing — the resolver wins.
 
+`Model.excludedParameters` is an optional denylist of generation parameters the LLM Gateway rejects for the model.
+Harnesses consult it before forwarding a generation parameter — currently only `temperature`, which the gateway
+deprecated for Claude Opus 4.7+ and now rejects. A model that lists `temperature` (the in-tree Opus 4.7 / 4.8 models do)
+has it stripped from the request; leaving `excludedParameters` unset (the default) forwards every parameter unchanged.
+
 #### `HarnessAgentConfig`
 
 Harness-facing configuration derived from `AgentConfig`. Strips `orgAlias` (resolved above the harness) and adds:

package/dist/agent-connectivity-resolver.d.ts

@@ -1,5 +1,5 @@
 import { Model } from './models/index.js';
-import { type JSONWebToken, type OrgConnection, type OrgConnectionFactory } from '@salesforce/agentic-common';
+import { type JSONWebToken, type OrgConnection, type OrgConnectionFactory, SfApiEnv } from '@salesforce/agentic-common';
 import type { AgentConfig } from './harness/harness-config.js';
 import type { ModelConnectivityInfo, ProviderHint } from './types/model-connectivity-info.js';
 /**
@@ -90,11 +90,17 @@ export declare class DefaultAgentConnectivityResolver implements AgentConnectivi
  * its `name` — a programming error worth surfacing eagerly rather than silently
  * defaulting.
  *
- * **Scope:** This helper is for the Salesforce gateway path only — both
- * `llmgateway__BedrockAnthropic*` and `llmgateway__Anthropic*` prefixes go to the
- * gateway's Bedrock pass-through, so both collapse to `'bedrock-anthropic'`. A
- * consumer wanting direct-Anthropic auth (`providerHint: 'anthropic'`) drives that
- * path through {@link ApiKeyConnectivityResolver} with an explicit `providerHint`
+ * **Scope:** This helper is for the Salesforce gateway path only. It keys on the
+ * model FAMILY segment, not the namespace prefix, because the geo-aware
+ * `sfdc_ai__Default*` prefix is shared across families: `sfdc_ai__DefaultBedrockAnthropic*`
+ * is a Claude model that must reach the Bedrock pass-through, while
+ * `sfdc_ai__DefaultGPT*` is an OpenAI model that must reach the Responses endpoint.
+ * Matching on the bare `sfdc_ai__Default` prefix alone would mis-route every geo
+ * Claude id onto the OpenAI wire path (wire-observed 500/502 — W-23256760). Both
+ * `BedrockAnthropic*` and `Anthropic*` families collapse to `'bedrock-anthropic'`
+ * (the gateway's Bedrock pass-through) under either namespace prefix. A consumer
+ * wanting direct-Anthropic auth (`providerHint: 'anthropic'`) drives that path
+ * through {@link ApiKeyConnectivityResolver} with an explicit `providerHint`
  * argument, not through this resolver.
  *
  * Exported (module-path only, not on the public `index.ts` surface) so e2e test
@@ -103,6 +109,34 @@ export declare class DefaultAgentConnectivityResolver implements AgentConnectivi
  * `sfdc_ai__Default*` geo ids to `bedrock-anthropic` (W-23292476).
  */
 export declare function pickProviderHintForGatewayModel(model: Model): ProviderHint;
+/**
+ * Returns the Salesforce LLM Gateway base URL for the given environment.
+ *
+ * Includes the `/ai/gpt/v1` API root: the pass-through endpoints
+ * (`/responses` for OpenAI Responses, `/model/<id>/invoke-with-response-stream`
+ * for Bedrock-Anthropic) live under this prefix, and provider SDKs
+ * (`@anthropic-ai/bedrock-sdk`, `openai`) construct their per-model paths by
+ * concatenation onto the base URL the consumer supplies.
+ *
+ * Exported (module-path only, not on the public `index.ts` surface) so the
+ * `test/smoke/raw-gateway-probe.ts` diagnostic targets the exact same gateway
+ * URL production does, rather than re-stating the env→URL switch (which drifted
+ * before — W-23292476). Same rationale as {@link pickProviderHintForGatewayModel}.
+ */
+export declare function salesforceGatewayBaseUrl(env: SfApiEnv): string;
+/**
+ * Builds the full header set for a Salesforce LLM Gateway request, including the
+ * Authorization Bearer JWT, tenant-key, feature-id, and any model-specific custom
+ * headers. Re-evaluated on every harness call so JWT rotations land on the next
+ * request without rebuilding the bag.
+ *
+ * Exported (module-path only, not on the public `index.ts` surface) so the
+ * `test/smoke/raw-gateway-probe.ts` diagnostic sends the exact same header bag
+ * production does — the minted `Bearer <jwt>` + tenant-key + feature-id is the
+ * one part a hand-rolled request gets wrong, and duplicating it would let the
+ * probe silently drift from the real auth shape.
+ */
+export declare function buildSalesforceGatewayHeaders(orgJwt: JSONWebToken, model: Model): Promise<Record<string, string>>;
 /**
  * Resolves an `AgentConfig.modelId` value (which may be a {@link ModelName} enum value, a
  * pre-built {@link Model} instance, or `undefined`) to a concrete {@link Model}.

package/dist/agent-connectivity-resolver.js

@@ -2,7 +2,7 @@
  * Copyright 2026, Salesforce, Inc. All rights reserved.
  * See LICENSE.txt for license terms.
  */
-import { Model, ModelName, Models, createClaudeModel } from './models/index.js';
+import { Model, ModelName, Models, createClaudeModel, LEGACY_MODEL_ID_ALIASES, } from './models/index.js';
 import { createJWTFromConnection, RealOrgConnectionFactory, SfApiEnv, } from '@salesforce/agentic-common';
 // TODO(@W-22782317): Temporary workaround — only on prod orgs the LLM Gateway must
 // route requests through AgentforceVibes rather than the default VibesService. Remove once a
@@ -63,11 +63,17 @@ export class DefaultAgentConnectivityResolver {
  * its `name` — a programming error worth surfacing eagerly rather than silently
  * defaulting.
  *
- * **Scope:** This helper is for the Salesforce gateway path only — both
- * `llmgateway__BedrockAnthropic*` and `llmgateway__Anthropic*` prefixes go to the
- * gateway's Bedrock pass-through, so both collapse to `'bedrock-anthropic'`. A
- * consumer wanting direct-Anthropic auth (`providerHint: 'anthropic'`) drives that
- * path through {@link ApiKeyConnectivityResolver} with an explicit `providerHint`
+ * **Scope:** This helper is for the Salesforce gateway path only. It keys on the
+ * model FAMILY segment, not the namespace prefix, because the geo-aware
+ * `sfdc_ai__Default*` prefix is shared across families: `sfdc_ai__DefaultBedrockAnthropic*`
+ * is a Claude model that must reach the Bedrock pass-through, while
+ * `sfdc_ai__DefaultGPT*` is an OpenAI model that must reach the Responses endpoint.
+ * Matching on the bare `sfdc_ai__Default` prefix alone would mis-route every geo
+ * Claude id onto the OpenAI wire path (wire-observed 500/502 — W-23256760). Both
+ * `BedrockAnthropic*` and `Anthropic*` families collapse to `'bedrock-anthropic'`
+ * (the gateway's Bedrock pass-through) under either namespace prefix. A consumer
+ * wanting direct-Anthropic auth (`providerHint: 'anthropic'`) drives that path
+ * through {@link ApiKeyConnectivityResolver} with an explicit `providerHint`
  * argument, not through this resolver.
  *
  * Exported (module-path only, not on the public `index.ts` surface) so e2e test
@@ -77,16 +83,20 @@ export class DefaultAgentConnectivityResolver {
  */
 export function pickProviderHintForGatewayModel(model) {
     const name = model.name;
-    if (name.startsWith('llmgateway__BedrockAnthropic') || name.startsWith('llmgateway__Anthropic')) {
+    if (name.startsWith('llmgateway__BedrockAnthropic') ||
+        name.startsWith('llmgateway__Anthropic') ||
+        name.startsWith('sfdc_ai__DefaultBedrockAnthropic') ||
+        name.startsWith('sfdc_ai__DefaultAnthropic')) {
         return 'bedrock-anthropic';
     }
     if (name.startsWith('llmgateway__OpenAI') || name.startsWith('sfdc_ai__Default')) {
-        // `sfdc_ai__Default*` is the geo-aware OpenAI route (W-23256760): the
-        // gateway selects the regional deployment, but the wire shape is still
-        // OpenAI Responses, so it resolves to the same providerHint.
+        // `sfdc_ai__Default*` (minus the Anthropic families handled above) is the
+        // geo-aware OpenAI route (W-23256760): the gateway selects the regional
+        // deployment, but the wire shape is still OpenAI Responses, so it resolves
+        // to the same providerHint.
         return 'openai-responses';
     }
-    throw new Error(`Cannot infer providerHint for model "${name}". Salesforce gateway models must start with "llmgateway__BedrockAnthropic*", "llmgateway__OpenAI*", or "sfdc_ai__Default*".`);
+    throw new Error(`Cannot infer providerHint for model "${name}". Salesforce gateway models must start with "sfdc_ai__DefaultBedrockAnthropic*", "sfdc_ai__DefaultGPT*", or a legacy "llmgateway__BedrockAnthropic*" / "llmgateway__OpenAI*" id.`);
 }
 /**
  * Returns the Salesforce LLM Gateway base URL for the given environment.
@@ -96,8 +106,13 @@ export function pickProviderHintForGatewayModel(model) {
  * for Bedrock-Anthropic) live under this prefix, and provider SDKs
  * (`@anthropic-ai/bedrock-sdk`, `openai`) construct their per-model paths by
  * concatenation onto the base URL the consumer supplies.
+ *
+ * Exported (module-path only, not on the public `index.ts` surface) so the
+ * `test/smoke/raw-gateway-probe.ts` diagnostic targets the exact same gateway
+ * URL production does, rather than re-stating the env→URL switch (which drifted
+ * before — W-23292476). Same rationale as {@link pickProviderHintForGatewayModel}.
  */
-function salesforceGatewayBaseUrl(env) {
+export function salesforceGatewayBaseUrl(env) {
     switch (env) {
         case SfApiEnv.Dev:
             return 'https://dev.api.salesforce.com/ai/gpt/v1';
@@ -117,8 +132,14 @@ function salesforceGatewayBaseUrl(env) {
  * Authorization Bearer JWT, tenant-key, feature-id, and any model-specific custom
  * headers. Re-evaluated on every harness call so JWT rotations land on the next
  * request without rebuilding the bag.
+ *
+ * Exported (module-path only, not on the public `index.ts` surface) so the
+ * `test/smoke/raw-gateway-probe.ts` diagnostic sends the exact same header bag
+ * production does — the minted `Bearer <jwt>` + tenant-key + feature-id is the
+ * one part a hand-rolled request gets wrong, and duplicating it would let the
+ * probe silently drift from the real auth shape.
  */
-async function buildSalesforceGatewayHeaders(orgJwt, model) {
+export async function buildSalesforceGatewayHeaders(orgJwt, model) {
     const [jwtValue, tenantKey] = await Promise.all([orgJwt.getValue(), orgJwt.getTenantKey()]);
     // Order matters: spread `customHeaders` FIRST so the resolver-set auth /
     // tenant / feature-id headers win on conflict. `customHeaders` is for
@@ -168,12 +189,19 @@ function rehydratePersistedModel(persisted) {
     if (typeof obj.name !== 'string') {
         throw new Error(`Cannot resolve modelId: missing string "name" on persisted object.`);
     }
-    // If the persisted name matches an in-tree model, prefer the strict registry — the
-    // returned instance has the correct prototype and the canonical caps.
-    if (Object.values(ModelName).includes(obj.name)) {
+    // If the persisted name matches an in-tree model — a current `ModelName` value OR a
+    // legacy pinned id the alias map remaps (e.g. an `AgentConfig` written before the
+    // geo-aware rename) — prefer the strict registry, which returns an instance with the
+    // correct prototype and canonical caps. `getByName` consults the alias map itself.
+    if (Object.values(ModelName).includes(obj.name) || obj.name in LEGACY_MODEL_ID_ALIASES) {
         return Models.getByName(obj.name);
     }
-    if (!obj.name.startsWith('llmgateway__BedrockAnthropic')) {
+    // Escape-hatch rehydration (consumer-built Claude variants via createClaudeModel):
+    // accept both the geo-aware `sfdc_ai__DefaultBedrockAnthropic*` prefix and the legacy
+    // pinned `llmgateway__BedrockAnthropic*` prefix so instances persisted under either
+    // scheme rehydrate during the deprecation window.
+    if (!obj.name.startsWith('sfdc_ai__DefaultBedrockAnthropic') &&
+        !obj.name.startsWith('llmgateway__BedrockAnthropic')) {
         throw new Error(`Cannot rehydrate persisted model "${obj.name}". Only Bedrock-Anthropic Claude variants are supported via the consumer-built Model escape hatch.`);
     }
     return createClaudeModel(obj.name, {
@@ -183,7 +211,8 @@ function rehydratePersistedModel(persisted) {
         contextWindow: obj.contextWindow,
         supportsPromptCache: obj.supportsPromptCache,
         supportedFormats: obj.supportedFormats,
-        permittedParameters: obj.permittedParameters,
+        excludedParameters: obj.excludedParameters,
+        thinkingMode: obj.thinkingMode,
         customHeaders: obj.customHeaders,
     });
 }

package/dist/index.d.ts

@@ -10,7 +10,7 @@ export { DEFAULT_MAX_STEPS } from './harness/harness-config.js';
 export type { MCPConfiguration, MCPServerConfig, MCPStdioServerConfig, MCPRemoteServerConfig, McpServerInfo, McpServerErrorCategory, McpServerErrorDetail, McpToolInfo, McpToolAnnotations, } from './mcp-config.js';
 export { McpServerStatus, mcpServerConfigEqual } from './mcp-config.js';
 export { Model, ModelName, createClaudeModel, Models, validateMultimodalFiles } from './models/index.js';
-export type { ClaudeModelOverrides, MultimodalFile, SupportedFileFormat } from './models/index.js';
+export type { ClaudeModelOverrides, MultimodalFile, SupportedFileFormat, ThinkingMode } from './models/index.js';
 export { MimeType } from './models/index.js';
 export { inferSfApiEnv, SfApiEnv } from '@salesforce/agentic-common';
 export { type AgentManager, type RestoreFailure, createAgentManager } from './agent-manager.js';

package/dist/models/claude-opus-4-5.d.ts

@@ -1,4 +1,4 @@
-import { Model, ModelName } from './model.js';
+import { Model, ModelName, type ThinkingMode } from './model.js';
 import { type SupportedFileFormat } from './types.js';
 export declare class ClaudeOpus45 extends Model {
     readonly name: ModelName;
@@ -7,5 +7,6 @@ export declare class ClaudeOpus45 extends Model {
     readonly maxOutputTokens: number;
     readonly contextWindow: number;
     readonly supportsPromptCache: boolean;
+    readonly thinkingMode: ThinkingMode;
     readonly supportedFormats: readonly SupportedFileFormat[];
 }

package/dist/models/claude-opus-4-5.js

@@ -12,6 +12,10 @@ export class ClaudeOpus45 extends Model {
     maxOutputTokens = 64000;
     contextWindow = 200000;
     supportsPromptCache = true;
+    // The Bedrock 4.5 backend accepts only the legacy `thinking.type: "enabled"`
+    // shape and rejects `"adaptive"` (which arrives with 4.6+). Verified on the
+    // wire; see the harness thinking-mode probe.
+    thinkingMode = 'enabled';
     supportedFormats = [
         { name: 'png', mimeType: MimeType.Png, maxBytesPerFile: 3.75 * 1024 * 1024 },
         { name: 'jpeg', mimeType: MimeType.Jpeg, maxBytesPerFile: 3.75 * 1024 * 1024 },

package/dist/models/claude-opus-4-6.d.ts

@@ -1,4 +1,4 @@
-import { Model, ModelName } from './model.js';
+import { Model, ModelName, type ThinkingMode } from './model.js';
 import { type SupportedFileFormat } from './types.js';
 export declare class ClaudeOpus46 extends Model {
     readonly name: ModelName;
@@ -7,5 +7,6 @@ export declare class ClaudeOpus46 extends Model {
     readonly maxOutputTokens: number;
     readonly contextWindow: number;
     readonly supportsPromptCache: boolean;
+    readonly thinkingMode: ThinkingMode;
     readonly supportedFormats: readonly SupportedFileFormat[];
 }

package/dist/models/claude-opus-4-6.js

@@ -13,6 +13,10 @@ export class ClaudeOpus46 extends Model {
     maxOutputTokens = 128_000;
     contextWindow = 1_000_000;
     supportsPromptCache = true;
+    // The Bedrock 4.6+ backend requires the `thinking.type: "adaptive"` shape and
+    // rejects the legacy `"enabled"`. Verified on the wire; see the harness
+    // thinking-mode probe.
+    thinkingMode = 'adaptive';
     supportedFormats = [
         { name: 'png', mimeType: MimeType.Png, maxBytesPerFile: 3.75 * 1024 * 1024 },
         { name: 'jpeg', mimeType: MimeType.Jpeg, maxBytesPerFile: 3.75 * 1024 * 1024 },

package/dist/models/claude-opus-4-7.d.ts

@@ -1,4 +1,4 @@
-import { Model, ModelName } from './model.js';
+import { Model, ModelName, type ThinkingMode } from './model.js';
 import { type SupportedFileFormat } from './types.js';
 export declare class ClaudeOpus47 extends Model {
     readonly name: ModelName;
@@ -7,5 +7,7 @@ export declare class ClaudeOpus47 extends Model {
     readonly maxOutputTokens: number;
     readonly contextWindow: number;
     readonly supportsPromptCache: boolean;
+    readonly excludedParameters: string[];
+    readonly thinkingMode: ThinkingMode;
     readonly supportedFormats: readonly SupportedFileFormat[];
 }

package/dist/models/claude-opus-4-7.js

@@ -13,6 +13,13 @@ export class ClaudeOpus47 extends Model {
     maxOutputTokens = 128_000;
     contextWindow = 1_000_000;
     supportsPromptCache = true;
+    // The gateway deprecated `temperature` for Opus 4.7+ and rejects requests
+    // that include it, so the harness strips it before the request is sent.
+    excludedParameters = ['temperature'];
+    // The Bedrock 4.6+ backend requires the `thinking.type: "adaptive"` shape and
+    // rejects the legacy `"enabled"` the bundled CLI defaults to for this model.
+    // Verified on the wire; see the harness thinking-mode probe.
+    thinkingMode = 'adaptive';
     supportedFormats = [
         { name: 'png', mimeType: MimeType.Png, maxBytesPerFile: 3.75 * 1024 * 1024 },
         { name: 'jpeg', mimeType: MimeType.Jpeg, maxBytesPerFile: 3.75 * 1024 * 1024 },

package/dist/models/claude-opus-4-8.d.ts

@@ -1,4 +1,4 @@
-import { Model, ModelName } from './model.js';
+import { Model, ModelName, type ThinkingMode } from './model.js';
 import { type SupportedFileFormat } from './types.js';
 export declare class ClaudeOpus48 extends Model {
     readonly name: ModelName;
@@ -7,5 +7,7 @@ export declare class ClaudeOpus48 extends Model {
     readonly maxOutputTokens: number;
     readonly contextWindow: number;
     readonly supportsPromptCache: boolean;
+    readonly excludedParameters: string[];
+    readonly thinkingMode: ThinkingMode;
     readonly supportedFormats: readonly SupportedFileFormat[];
 }

package/dist/models/claude-opus-4-8.js

@@ -13,6 +13,13 @@ export class ClaudeOpus48 extends Model {
     maxOutputTokens = 128_000;
     contextWindow = 1_000_000;
     supportsPromptCache = true;
+    // The gateway deprecated `temperature` for Opus 4.7+ and rejects requests
+    // that include it, so the harness strips it before the request is sent.
+    excludedParameters = ['temperature'];
+    // The Bedrock 4.6+ backend requires the `thinking.type: "adaptive"` shape and
+    // rejects the legacy `"enabled"` the bundled CLI defaults to for this model.
+    // Verified on the wire; see the harness thinking-mode probe.
+    thinkingMode = 'adaptive';
     supportedFormats = [
         { name: 'png', mimeType: MimeType.Png, maxBytesPerFile: 3.75 * 1024 * 1024 },
         { name: 'jpeg', mimeType: MimeType.Jpeg, maxBytesPerFile: 3.75 * 1024 * 1024 },

package/dist/models/claude-sonnet-4-5.d.ts

@@ -1,4 +1,4 @@
-import { Model, ModelName } from './model.js';
+import { Model, ModelName, type ThinkingMode } from './model.js';
 import { type SupportedFileFormat } from './types.js';
 export declare class ClaudeSonnet45 extends Model {
     readonly name: ModelName;
@@ -7,5 +7,6 @@ export declare class ClaudeSonnet45 extends Model {
     readonly maxOutputTokens: number;
     readonly contextWindow: number;
     readonly supportsPromptCache: boolean;
+    readonly thinkingMode: ThinkingMode;
     readonly supportedFormats: readonly SupportedFileFormat[];
 }

package/dist/models/claude-sonnet-4-5.js

@@ -12,6 +12,10 @@ export class ClaudeSonnet45 extends Model {
     maxOutputTokens = 8192;
     contextWindow = 200000;
     supportsPromptCache = true;
+    // The Bedrock 4.5 backend accepts only the legacy `thinking.type: "enabled"`
+    // shape and rejects `"adaptive"` (which arrives with 4.6+). Verified on the
+    // wire; see the harness thinking-mode probe.
+    thinkingMode = 'enabled';
     // Multimodal limits: 3.75 MiB / image, 4.5 MiB / PDF, 5 PDFs / request
     // Reference: https://help.salesforce.com/s/articleView?id=ai.generative_ai_llm_multimodal_support.htm&type=5
     supportedFormats = [

package/dist/models/claude-sonnet-4-6.d.ts

@@ -1,4 +1,4 @@
-import { Model, ModelName } from './model.js';
+import { Model, ModelName, type ThinkingMode } from './model.js';
 import { type SupportedFileFormat } from './types.js';
 export declare class ClaudeSonnet46 extends Model {
     readonly name: ModelName;
@@ -7,5 +7,6 @@ export declare class ClaudeSonnet46 extends Model {
     readonly maxOutputTokens: number;
     readonly contextWindow: number;
     readonly supportsPromptCache: boolean;
+    readonly thinkingMode: ThinkingMode;
     readonly supportedFormats: readonly SupportedFileFormat[];
 }

package/dist/models/claude-sonnet-4-6.js

@@ -12,6 +12,10 @@ export class ClaudeSonnet46 extends Model {
     maxOutputTokens = 16384;
     contextWindow = 200000;
     supportsPromptCache = true;
+    // The Bedrock 4.6+ backend requires the `thinking.type: "adaptive"` shape and
+    // rejects the legacy `"enabled"`. Verified on the wire; see the harness
+    // thinking-mode probe.
+    thinkingMode = 'adaptive';
     // Multimodal limits: 3.75 MiB / image, 4.5 MiB / PDF, 5 PDFs / request
     supportedFormats = [
         { name: 'png', mimeType: MimeType.Png, maxBytesPerFile: 3.75 * 1024 * 1024 },

package/dist/models/create-claude-model.d.ts

@@ -1,4 +1,4 @@
-import { Model } from './model.js';
+import { Model, type ThinkingMode } from './model.js';
 import { type SupportedFileFormat } from './types.js';
 /**
  * Optional overrides for {@link createClaudeModel}. Any field omitted falls back to a conservative
@@ -19,8 +19,15 @@ export type ClaudeModelOverrides = {
     supportsPromptCache?: boolean;
     /** Multimodal file format caps. Defaults to the Claude image+PDF caps. */
     supportedFormats?: readonly SupportedFileFormat[];
-    /** Gateway-permitted generation parameters for this model. */
-    permittedParameters?: string[];
+    /** Generation parameters the gateway rejects for this model and the harness must strip. */
+    excludedParameters?: string[];
+    /**
+     * How this model expects extended thinking to be requested on the wire
+     * (`'enabled'` for Claude 4.5, `'adaptive'` for 4.6+). Omit unless the
+     * harness's default thinking shape is wrong for this variant's gateway
+     * backend. See {@link Model.thinkingMode}.
+     */
+    thinkingMode?: ThinkingMode;
     /**
      * Extra HTTP headers to attach to chat requests for this model. Use for vendor
      * labels (`anthropic-version`, model-tag opt-in headers) only — reserved
@@ -42,8 +49,8 @@ export type ClaudeModelOverrides = {
  *
  * @example
  * ```ts
- * const model = createClaudeModel('llmgateway__BedrockAnthropicClaude48Opus', {
- *     displayId: 'Claude Opus 4.8',
+ * const model = createClaudeModel('sfdc_ai__DefaultBedrockAnthropicClaude49Opus', {
+ *     displayId: 'Claude Opus 4.9',
  *     maxInputTokens: 1_000_000,
  *     contextWindow: 1_000_000,
  *     maxOutputTokens: 128_000,

package/dist/models/create-claude-model.js

@@ -24,8 +24,8 @@ const DEFAULT_CLAUDE_SUPPORTED_FORMATS = [
  *
  * @example
  * ```ts
- * const model = createClaudeModel('llmgateway__BedrockAnthropicClaude48Opus', {
- *     displayId: 'Claude Opus 4.8',
+ * const model = createClaudeModel('sfdc_ai__DefaultBedrockAnthropicClaude49Opus', {
+ *     displayId: 'Claude Opus 4.9',
  *     maxInputTokens: 1_000_000,
  *     contextWindow: 1_000_000,
  *     maxOutputTokens: 128_000,
@@ -44,7 +44,8 @@ class InlineClaudeModel extends Model {
     contextWindow;
     supportsPromptCache;
     supportedFormats;
-    permittedParameters;
+    excludedParameters;
+    thinkingMode;
     customHeaders;
     constructor(gatewayId, overrides) {
         super();
@@ -55,7 +56,8 @@ class InlineClaudeModel extends Model {
         this.contextWindow = overrides.contextWindow ?? 200_000;
         this.supportsPromptCache = overrides.supportsPromptCache ?? true;
         this.supportedFormats = overrides.supportedFormats ?? DEFAULT_CLAUDE_SUPPORTED_FORMATS;
-        this.permittedParameters = overrides.permittedParameters;
+        this.excludedParameters = overrides.excludedParameters;
+        this.thinkingMode = overrides.thinkingMode;
         this.customHeaders = overrides.customHeaders;
     }
 }

package/dist/models/{gpt-5-1-geo.d.ts → gpt-5-1.d.ts}

@@ -4,7 +4,7 @@ import { type SupportedFileFormat } from './types.js';
  * GPT-5.1 on the geo-aware `sfdc_ai__Default*` gateway route — routes to the
  * OpenAI Responses wire shape (Mastra harness). See W-23256760.
  */
-export declare class GPT51Geo extends Model {
+export declare class GPT51 extends Model {
     readonly name: ModelName;
     readonly displayId: string;
     readonly maxInputTokens: number;

package/dist/models/{gpt-5-1-geo.js → gpt-5-1.js}

@@ -8,9 +8,9 @@ import { MimeType } from './types.js';
  * GPT-5.1 on the geo-aware `sfdc_ai__Default*` gateway route — routes to the
  * OpenAI Responses wire shape (Mastra harness). See W-23256760.
  */
-export class GPT51Geo extends Model {
-    name = ModelName.GPT_5_1_GEO;
-    displayId = 'GPT-5.1 (geo-aware)';
+export class GPT51 extends Model {
+    name = ModelName.GPT_5_1;
+    displayId = 'GPT-5.1';
     // source of truth: https://git.soma.salesforce.com/a360/file-metadata/blob/master/fm-model-config/src/main/resources/ai/file-metadata/model/openai/llmgateway/OpenAIGPT51.yml
     maxInputTokens = 272000;
     maxOutputTokens = 128000;
@@ -22,4 +22,4 @@ export class GPT51Geo extends Model {
         { name: 'pdf', mimeType: MimeType.Pdf },
     ];
 }
-//# sourceMappingURL=gpt-5-1-geo.js.map
+//# sourceMappingURL=gpt-5-1.js.map

package/dist/models/{gpt-5-2-geo.d.ts → gpt-5-2.d.ts}

@@ -4,7 +4,7 @@ import { type SupportedFileFormat } from './types.js';
  * GPT-5.2 on the geo-aware `sfdc_ai__Default*` gateway route — routes to the
  * OpenAI Responses wire shape (Mastra harness). See W-23256760.
  */
-export declare class GPT52Geo extends Model {
+export declare class GPT52 extends Model {
     readonly name: ModelName;
     readonly displayId: string;
     readonly maxInputTokens: number;

package/dist/models/{gpt-5-2-geo.js → gpt-5-2.js}

@@ -8,9 +8,9 @@ import { MimeType } from './types.js';
  * GPT-5.2 on the geo-aware `sfdc_ai__Default*` gateway route — routes to the
  * OpenAI Responses wire shape (Mastra harness). See W-23256760.
  */
-export class GPT52Geo extends Model {
-    name = ModelName.GPT_5_2_GEO;
-    displayId = 'GPT-5.2 (geo-aware)';
+export class GPT52 extends Model {
+    name = ModelName.GPT_5_2;
+    displayId = 'GPT-5.2';
     maxInputTokens = 272000;
     maxOutputTokens = 128000;
     contextWindow = 272000;
@@ -21,4 +21,4 @@ export class GPT52Geo extends Model {
         { name: 'pdf', mimeType: MimeType.Pdf },
     ];
 }
-//# sourceMappingURL=gpt-5-2-geo.js.map
+//# sourceMappingURL=gpt-5-2.js.map

package/dist/models/gpt-5-4.d.ts

@@ -1,5 +1,10 @@
 import { Model, ModelName } from './model.js';
 import { type SupportedFileFormat } from './types.js';
+/**
+ * GPT-5.4 on the geo-aware `sfdc_ai__DefaultGPT54` gateway route — routes to the
+ * OpenAI Responses wire shape (Mastra harness). The pinned `llmgateway__OpenAIGPT54`
+ * route was collapsed onto this geo id (W-23256760).
+ */
 export declare class GPT54 extends Model {
     readonly name: ModelName;
     readonly displayId: string;

package/dist/models/gpt-5-4.js

@@ -4,6 +4,11 @@
  */
 import { Model, ModelName } from './model.js';
 import { MimeType } from './types.js';
+/**
+ * GPT-5.4 on the geo-aware `sfdc_ai__DefaultGPT54` gateway route — routes to the
+ * OpenAI Responses wire shape (Mastra harness). The pinned `llmgateway__OpenAIGPT54`
+ * route was collapsed onto this geo id (W-23256760).
+ */
 export class GPT54 extends Model {
     name = ModelName.GPT_5_4;
     displayId = 'GPT-5.4';

package/dist/models/gpt-5.d.ts

@@ -1,5 +1,10 @@
 import { Model, ModelName } from './model.js';
 import { type SupportedFileFormat } from './types.js';
+/**
+ * GPT-5 on the geo-aware `sfdc_ai__DefaultGPT5` gateway route — routes to the
+ * OpenAI Responses wire shape (Mastra harness). The pinned `llmgateway__OpenAIGPT5`
+ * route was collapsed onto this geo id (W-23256760).
+ */
 export declare class GPT5 extends Model {
     readonly name: ModelName;
     readonly displayId: string;

package/dist/models/gpt-5.js

@@ -4,6 +4,11 @@
  */
 import { Model, ModelName } from './model.js';
 import { MimeType } from './types.js';
+/**
+ * GPT-5 on the geo-aware `sfdc_ai__DefaultGPT5` gateway route — routes to the
+ * OpenAI Responses wire shape (Mastra harness). The pinned `llmgateway__OpenAIGPT5`
+ * route was collapsed onto this geo id (W-23256760).
+ */
 export class GPT5 extends Model {
     name = ModelName.GPT_5;
     displayId = 'GPT-5';

package/dist/models/index.d.ts

@@ -1,14 +1,12 @@
 import { Model, ModelName } from './model.js';
-export { Model, ModelName } from './model.js';
+export { Model, ModelName, type ThinkingMode } from './model.js';
 export { MimeType, type SupportedFileFormat, type MultimodalFile } from './types.js';
 export { validateMultimodalFiles, MAX_FILES_PER_REQUEST, MAX_TOTAL_FILE_BYTES } from './multimodal.js';
 export { GPT5 } from './gpt-5.js';
+export { GPT51 } from './gpt-5-1.js';
+export { GPT52 } from './gpt-5-2.js';
 export { GPT54 } from './gpt-5-4.js';
 export { GPT55 } from './gpt-5-5.js';
-export { GPT5Geo } from './gpt-5-geo.js';
-export { GPT51Geo } from './gpt-5-1-geo.js';
-export { GPT52Geo } from './gpt-5-2-geo.js';
-export { GPT54Geo } from './gpt-5-4-geo.js';
 export { ClaudeSonnet45 } from './claude-sonnet-4-5.js';
 export { ClaudeSonnet46 } from './claude-sonnet-4-6.js';
 export { ClaudeOpus45 } from './claude-opus-4-5.js';
@@ -16,6 +14,16 @@ export { ClaudeOpus46 } from './claude-opus-4-6.js';
 export { ClaudeOpus47 } from './claude-opus-4-7.js';
 export { ClaudeOpus48 } from './claude-opus-4-8.js';
 export { createClaudeModel, type ClaudeModelOverrides } from './create-claude-model.js';
+/**
+ * Legacy pinned wire-ids that predate the geo-aware `sfdc_ai__Default*` rename,
+ * mapped to their canonical {@link ModelName}. Consulted by {@link getByName} so an
+ * `AgentConfig` persisted before the rename still resolves to the current in-tree
+ * model — with canonical caps and prototype — instead of throwing on restore.
+ *
+ * Only the pinned ids that were REPLACED need entries; the geo GPT ids
+ * (`sfdc_ai__DefaultGPT5` etc.) are already live `ModelName` values.
+ */
+export declare const LEGACY_MODEL_ID_ALIASES: Readonly<Record<string, ModelName>>;
 export declare function getDefault(): Model;
 export declare function getByName(modelName: ModelName): Model;
 export declare const Models: {

package/dist/models/index.js

@@ -4,12 +4,10 @@
  */
 import { Model, ModelName } from './model.js';
 import { GPT5 } from './gpt-5.js';
+import { GPT51 } from './gpt-5-1.js';
+import { GPT52 } from './gpt-5-2.js';
 import { GPT54 } from './gpt-5-4.js';
 import { GPT55 } from './gpt-5-5.js';
-import { GPT5Geo } from './gpt-5-geo.js';
-import { GPT51Geo } from './gpt-5-1-geo.js';
-import { GPT52Geo } from './gpt-5-2-geo.js';
-import { GPT54Geo } from './gpt-5-4-geo.js';
 import { ClaudeSonnet45 } from './claude-sonnet-4-5.js';
 import { ClaudeSonnet46 } from './claude-sonnet-4-6.js';
 import { ClaudeOpus45 } from './claude-opus-4-5.js';
@@ -20,12 +18,10 @@ export { Model, ModelName } from './model.js';
 export { MimeType } from './types.js';
 export { validateMultimodalFiles, MAX_FILES_PER_REQUEST, MAX_TOTAL_FILE_BYTES } from './multimodal.js';
 export { GPT5 } from './gpt-5.js';
+export { GPT51 } from './gpt-5-1.js';
+export { GPT52 } from './gpt-5-2.js';
 export { GPT54 } from './gpt-5-4.js';
 export { GPT55 } from './gpt-5-5.js';
-export { GPT5Geo } from './gpt-5-geo.js';
-export { GPT51Geo } from './gpt-5-1-geo.js';
-export { GPT52Geo } from './gpt-5-2-geo.js';
-export { GPT54Geo } from './gpt-5-4-geo.js';
 export { ClaudeSonnet45 } from './claude-sonnet-4-5.js';
 export { ClaudeSonnet46 } from './claude-sonnet-4-6.js';
 export { ClaudeOpus45 } from './claude-opus-4-5.js';
@@ -33,35 +29,53 @@ export { ClaudeOpus46 } from './claude-opus-4-6.js';
 export { ClaudeOpus47 } from './claude-opus-4-7.js';
 export { ClaudeOpus48 } from './claude-opus-4-8.js';
 export { createClaudeModel } from './create-claude-model.js';
+/**
+ * Legacy pinned wire-ids that predate the geo-aware `sfdc_ai__Default*` rename,
+ * mapped to their canonical {@link ModelName}. Consulted by {@link getByName} so an
+ * `AgentConfig` persisted before the rename still resolves to the current in-tree
+ * model — with canonical caps and prototype — instead of throwing on restore.
+ *
+ * Only the pinned ids that were REPLACED need entries; the geo GPT ids
+ * (`sfdc_ai__DefaultGPT5` etc.) are already live `ModelName` values.
+ */
+export const LEGACY_MODEL_ID_ALIASES = {
+    llmgateway__OpenAIGPT5: ModelName.GPT_5,
+    llmgateway__OpenAIGPT54: ModelName.GPT_5_4,
+    llmgateway__OpenAIGPT55: ModelName.GPT_5_5,
+    llmgateway__BedrockAnthropicClaude45Sonnet: ModelName.CLAUDE_SONNET_4_5,
+    llmgateway__BedrockAnthropicClaude46Sonnet: ModelName.CLAUDE_SONNET_4_6,
+    llmgateway__BedrockAnthropicClaude45Opus: ModelName.CLAUDE_OPUS_4_5,
+    llmgateway__BedrockAnthropicClaude46Opus: ModelName.CLAUDE_OPUS_4_6,
+    llmgateway__BedrockAnthropicClaude47Opus: ModelName.CLAUDE_OPUS_4_7,
+    llmgateway__BedrockAnthropicClaude48Opus: ModelName.CLAUDE_OPUS_4_8,
+};
 export function getDefault() {
     return new ClaudeSonnet46();
 }
 export function getByName(modelName) {
-    if (modelName === ModelName.GPT_5)
+    // Map a legacy pinned id to its canonical member; leave canonical ids untouched.
+    const canonical = LEGACY_MODEL_ID_ALIASES[modelName] ?? modelName;
+    if (canonical === ModelName.GPT_5)
         return new GPT5();
-    if (modelName === ModelName.GPT_5_4)
+    if (canonical === ModelName.GPT_5_1)
+        return new GPT51();
+    if (canonical === ModelName.GPT_5_2)
+        return new GPT52();
+    if (canonical === ModelName.GPT_5_4)
         return new GPT54();
-    if (modelName === ModelName.GPT_5_5)
+    if (canonical === ModelName.GPT_5_5)
         return new GPT55();
-    if (modelName === ModelName.GPT_5_GEO)
-        return new GPT5Geo();
-    if (modelName === ModelName.GPT_5_1_GEO)
-        return new GPT51Geo();
-    if (modelName === ModelName.GPT_5_2_GEO)
-        return new GPT52Geo();
-    if (modelName === ModelName.GPT_5_4_GEO)
-        return new GPT54Geo();
-    if (modelName === ModelName.CLAUDE_SONNET_4_5)
+    if (canonical === ModelName.CLAUDE_SONNET_4_5)
         return new ClaudeSonnet45();
-    if (modelName === ModelName.CLAUDE_SONNET_4_6)
+    if (canonical === ModelName.CLAUDE_SONNET_4_6)
         return new ClaudeSonnet46();
-    if (modelName === ModelName.CLAUDE_OPUS_4_5)
+    if (canonical === ModelName.CLAUDE_OPUS_4_5)
         return new ClaudeOpus45();
-    if (modelName === ModelName.CLAUDE_OPUS_4_6)
+    if (canonical === ModelName.CLAUDE_OPUS_4_6)
         return new ClaudeOpus46();
-    if (modelName === ModelName.CLAUDE_OPUS_4_7)
+    if (canonical === ModelName.CLAUDE_OPUS_4_7)
         return new ClaudeOpus47();
-    if (modelName === ModelName.CLAUDE_OPUS_4_8)
+    if (canonical === ModelName.CLAUDE_OPUS_4_8)
         return new ClaudeOpus48();
     throw new Error(`No model mapping exists for "${modelName}".`);
 }

package/dist/models/model.d.ts

@@ -1,6 +1,32 @@
 import type { SupportedFileFormat } from './types.js';
+/**
+ * How a model expects extended-thinking / reasoning to be requested on the wire.
+ * Mirrors the Anthropic thinking-config discriminator:
+ *
+ * - `'enabled'` — the legacy fixed-budget shape (`thinking.type: "enabled"`).
+ *   Required by the Bedrock-Anthropic Claude 4.5 generation; the 4.6+ backends
+ *   reject it.
+ * - `'adaptive'` — the newer "model decides how much to think" shape
+ *   (`thinking.type: "adaptive"`). Required by Claude Opus 4.6+ / Sonnet 4.6+;
+ *   the 4.5 backends reject it.
+ * - `'disabled'` — no extended thinking.
+ *
+ * The two shapes are NOT interchangeable across model versions — see
+ * {@link Model.thinkingMode}.
+ */
+export type ThinkingMode = 'enabled' | 'adaptive' | 'disabled';
 /**
  * The canonical Salesforce LLM-Gateway model ids the SDK ships in-tree.
+ *
+ * The ids use the geo-aware `sfdc_ai__Default*` prefix: the gateway resolves
+ * the regional deployment for data-residency, latency, and failover, rather
+ * than pinning a single deployment. This replaced the older pinned
+ * `llmgateway__*` prefix, which the gateway advised against because it may not
+ * honor fallback (W-23256760). The pinned OpenAI + geo OpenAI members that used
+ * to coexist were collapsed onto their single geo id. Legacy pinned strings
+ * still resolve via {@link Models.getByName} through a back-compat alias map so
+ * persisted `AgentConfig`s keep restoring.
+ *
  * Consumer-built variants via {@link createClaudeModel} carry an arbitrary
  * gateway id string (the escape hatch for Bedrock-Anthropic Claude
  * variants the SDK has not released yet); cross-harness code that
@@ -10,19 +36,17 @@ import type { SupportedFileFormat } from './types.js';
  * silently miss escape-hatch ids.
  */
 export declare enum ModelName {
-    GPT_5 = "llmgateway__OpenAIGPT5",
-    GPT_5_4 = "llmgateway__OpenAIGPT54",
-    GPT_5_5 = "llmgateway__OpenAIGPT55",
-    GPT_5_GEO = "sfdc_ai__DefaultGPT5",
-    GPT_5_1_GEO = "sfdc_ai__DefaultGPT51",
-    GPT_5_2_GEO = "sfdc_ai__DefaultGPT52",
-    GPT_5_4_GEO = "sfdc_ai__DefaultGPT54",
-    CLAUDE_SONNET_4_5 = "llmgateway__BedrockAnthropicClaude45Sonnet",
-    CLAUDE_SONNET_4_6 = "llmgateway__BedrockAnthropicClaude46Sonnet",
-    CLAUDE_OPUS_4_5 = "llmgateway__BedrockAnthropicClaude45Opus",
-    CLAUDE_OPUS_4_6 = "llmgateway__BedrockAnthropicClaude46Opus",
-    CLAUDE_OPUS_4_7 = "llmgateway__BedrockAnthropicClaude47Opus",
-    CLAUDE_OPUS_4_8 = "llmgateway__BedrockAnthropicClaude48Opus"
+    GPT_5 = "sfdc_ai__DefaultGPT5",
+    GPT_5_1 = "sfdc_ai__DefaultGPT51",
+    GPT_5_2 = "sfdc_ai__DefaultGPT52",
+    GPT_5_4 = "sfdc_ai__DefaultGPT54",
+    GPT_5_5 = "sfdc_ai__DefaultGPT55",
+    CLAUDE_SONNET_4_5 = "sfdc_ai__DefaultBedrockAnthropicClaude45Sonnet",
+    CLAUDE_SONNET_4_6 = "sfdc_ai__DefaultBedrockAnthropicClaude46Sonnet",
+    CLAUDE_OPUS_4_5 = "sfdc_ai__DefaultBedrockAnthropicClaude45Opus",
+    CLAUDE_OPUS_4_6 = "sfdc_ai__DefaultBedrockAnthropicClaude46Opus",
+    CLAUDE_OPUS_4_7 = "sfdc_ai__DefaultBedrockAnthropicClaude47Opus",
+    CLAUDE_OPUS_4_8 = "sfdc_ai__DefaultBedrockAnthropicClaude48Opus"
 }
 /**
  * Abstract description of a model the SDK / harness can talk to. Used for:
@@ -55,7 +79,34 @@ export declare abstract class Model {
      * empty array means the model is text-only.
      */
     abstract readonly supportedFormats: readonly SupportedFileFormat[];
-    readonly permittedParameters?: string[];
+    /**
+     * Denylist of generation parameters the LLM Gateway rejects for this
+     * model. Harnesses consult it before forwarding a generation parameter —
+     * currently only `temperature`, which the gateway deprecated for Claude
+     * Opus 4.7+ and now rejects. A model that lists a parameter here has it
+     * stripped from the outbound request.
+     *
+     * `undefined` (the default) means nothing is excluded: every parameter the
+     * harness would send is forwarded. Set it only for models that must
+     * suppress a parameter the gateway no longer accepts.
+     */
+    readonly excludedParameters?: string[];
+    /**
+     * How this model expects extended thinking to be requested on the wire, when
+     * a harness that drives reasoning models (e.g. the Claude harness) would
+     * otherwise send a thinking config. The two Anthropic shapes are not
+     * interchangeable across model generations — the Bedrock-Anthropic backend
+     * rejects `thinking.type: "enabled"` for Claude 4.6+ and rejects
+     * `thinking.type: "adaptive"` for Claude 4.5 — so the accepted shape is a
+     * per-model property the harness must consult rather than assume.
+     *
+     * `undefined` (the default) means the harness uses whatever thinking config
+     * it would natively send (for the Claude harness, the bundled CLI's per-model
+     * default). Set it only for models where that default is wrong for the
+     * gateway — currently the in-tree Claude models, which pin `'enabled'` (4.5)
+     * or `'adaptive'` (4.6+).
+     */
+    readonly thinkingMode?: ThinkingMode;
     /**
      * Vendor-specific HTTP headers to add to every outbound request for this model
      * (e.g. `anthropic-version`, model-tag opt-in headers). Merged with the

package/dist/models/model.js

@@ -4,6 +4,16 @@
  */
 /**
  * The canonical Salesforce LLM-Gateway model ids the SDK ships in-tree.
+ *
+ * The ids use the geo-aware `sfdc_ai__Default*` prefix: the gateway resolves
+ * the regional deployment for data-residency, latency, and failover, rather
+ * than pinning a single deployment. This replaced the older pinned
+ * `llmgateway__*` prefix, which the gateway advised against because it may not
+ * honor fallback (W-23256760). The pinned OpenAI + geo OpenAI members that used
+ * to coexist were collapsed onto their single geo id. Legacy pinned strings
+ * still resolve via {@link Models.getByName} through a back-compat alias map so
+ * persisted `AgentConfig`s keep restoring.
+ *
  * Consumer-built variants via {@link createClaudeModel} carry an arbitrary
  * gateway id string (the escape hatch for Bedrock-Anthropic Claude
  * variants the SDK has not released yet); cross-harness code that
@@ -14,22 +24,17 @@
  */
 export var ModelName;
 (function (ModelName) {
-    ModelName["GPT_5"] = "llmgateway__OpenAIGPT5";
-    ModelName["GPT_5_4"] = "llmgateway__OpenAIGPT54";
-    ModelName["GPT_5_5"] = "llmgateway__OpenAIGPT55";
-    // Geo-aware `sfdc_ai__Default*` route: the gateway selects the regional
-    // OpenAI deployment. Distinct ids from the pinned `llmgateway__OpenAIGPT*`
-    // entries above so both routings coexist (W-23256760).
-    ModelName["GPT_5_GEO"] = "sfdc_ai__DefaultGPT5";
-    ModelName["GPT_5_1_GEO"] = "sfdc_ai__DefaultGPT51";
-    ModelName["GPT_5_2_GEO"] = "sfdc_ai__DefaultGPT52";
-    ModelName["GPT_5_4_GEO"] = "sfdc_ai__DefaultGPT54";
-    ModelName["CLAUDE_SONNET_4_5"] = "llmgateway__BedrockAnthropicClaude45Sonnet";
-    ModelName["CLAUDE_SONNET_4_6"] = "llmgateway__BedrockAnthropicClaude46Sonnet";
-    ModelName["CLAUDE_OPUS_4_5"] = "llmgateway__BedrockAnthropicClaude45Opus";
-    ModelName["CLAUDE_OPUS_4_6"] = "llmgateway__BedrockAnthropicClaude46Opus";
-    ModelName["CLAUDE_OPUS_4_7"] = "llmgateway__BedrockAnthropicClaude47Opus";
-    ModelName["CLAUDE_OPUS_4_8"] = "llmgateway__BedrockAnthropicClaude48Opus";
+    ModelName["GPT_5"] = "sfdc_ai__DefaultGPT5";
+    ModelName["GPT_5_1"] = "sfdc_ai__DefaultGPT51";
+    ModelName["GPT_5_2"] = "sfdc_ai__DefaultGPT52";
+    ModelName["GPT_5_4"] = "sfdc_ai__DefaultGPT54";
+    ModelName["GPT_5_5"] = "sfdc_ai__DefaultGPT55";
+    ModelName["CLAUDE_SONNET_4_5"] = "sfdc_ai__DefaultBedrockAnthropicClaude45Sonnet";
+    ModelName["CLAUDE_SONNET_4_6"] = "sfdc_ai__DefaultBedrockAnthropicClaude46Sonnet";
+    ModelName["CLAUDE_OPUS_4_5"] = "sfdc_ai__DefaultBedrockAnthropicClaude45Opus";
+    ModelName["CLAUDE_OPUS_4_6"] = "sfdc_ai__DefaultBedrockAnthropicClaude46Opus";
+    ModelName["CLAUDE_OPUS_4_7"] = "sfdc_ai__DefaultBedrockAnthropicClaude47Opus";
+    ModelName["CLAUDE_OPUS_4_8"] = "sfdc_ai__DefaultBedrockAnthropicClaude48Opus";
 })(ModelName || (ModelName = {}));
 /**
  * Abstract description of a model the SDK / harness can talk to. Used for:
@@ -51,7 +56,34 @@ export var ModelName;
  * Reference: https://docs.internal.salesforce.com/ai/einstein/gateway/models-and-providers/
  */
 export class Model {
-    permittedParameters;
+    /**
+     * Denylist of generation parameters the LLM Gateway rejects for this
+     * model. Harnesses consult it before forwarding a generation parameter —
+     * currently only `temperature`, which the gateway deprecated for Claude
+     * Opus 4.7+ and now rejects. A model that lists a parameter here has it
+     * stripped from the outbound request.
+     *
+     * `undefined` (the default) means nothing is excluded: every parameter the
+     * harness would send is forwarded. Set it only for models that must
+     * suppress a parameter the gateway no longer accepts.
+     */
+    excludedParameters;
+    /**
+     * How this model expects extended thinking to be requested on the wire, when
+     * a harness that drives reasoning models (e.g. the Claude harness) would
+     * otherwise send a thinking config. The two Anthropic shapes are not
+     * interchangeable across model generations — the Bedrock-Anthropic backend
+     * rejects `thinking.type: "enabled"` for Claude 4.6+ and rejects
+     * `thinking.type: "adaptive"` for Claude 4.5 — so the accepted shape is a
+     * per-model property the harness must consult rather than assume.
+     *
+     * `undefined` (the default) means the harness uses whatever thinking config
+     * it would natively send (for the Claude harness, the bundled CLI's per-model
+     * default). Set it only for models where that default is wrong for the
+     * gateway — currently the in-tree Claude models, which pin `'enabled'` (4.5)
+     * or `'adaptive'` (4.6+).
+     */
+    thinkingMode;
     /**
      * Vendor-specific HTTP headers to add to every outbound request for this model
      * (e.g. `anthropic-version`, model-tag opt-in headers). Merged with the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/sfdx-agent-sdk",
-  "version": "0.33.0",
+  "version": "0.35.0",
   "description": "Harness-agnostic agentic infrastructure for Salesforce developer experience tooling",
   "type": "module",
   "main": "dist/index.js",
@@ -31,6 +31,7 @@
     "test:e2e:local:cleanup": "node scripts/local-e2e-cleanup.mjs",
     "test:smoke": "tsc --build ./test/tsconfig.json && vitest run -c ./test/smoke/vitest.config.ts",
     "test:smoke:local": "node scripts/local-smoke.mjs",
+    "test:raw-probe:local": "node scripts/local-raw-probe.mjs",
     "verify": "tsx scripts/verify.ts"
   },
   "license": "SEE LICENSE IN LICENSE.txt",
@@ -46,16 +47,17 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@salesforce/sfdx-agent-harness-claude": "0.29.0",
-    "@salesforce/sfdx-agent-harness-mastra": "0.32.0",
+    "@salesforce/sfdx-agent-harness-claude": "0.31.0",
+    "@salesforce/sfdx-agent-harness-mastra": "0.34.0",
+    "@salesforce/sfdx-agent-harness-openai": "0.0.1",
     "@types/node": "^22.20.0",
     "@vitest/coverage-istanbul": "^4.1.10",
-    "@vitest/eslint-plugin": "^1.6.23",
+    "@vitest/eslint-plugin": "^1.6.22",
     "eslint": "^10.7.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-import-resolver-typescript": "^4.4.5",
     "eslint-plugin-import": "^2.32.0",
-    "eslint-plugin-n": "^18.2.2",
+    "eslint-plugin-n": "^18.2.1",
     "globals": "^17.6.0",
     "lint-staged": "^17.0.7",
     "prettier": "^3.9.4",

package/dist/models/gpt-5-4-geo.d.ts

@@ -1,16 +0,0 @@
-import { Model, ModelName } from './model.js';
-import { type SupportedFileFormat } from './types.js';
-/**
- * GPT-5.4 on the geo-aware `sfdc_ai__Default*` gateway route — the regional
- * counterpart to the pinned `llmgateway__OpenAIGPT54` route ({@link GPT54}).
- * Routes to the OpenAI Responses wire shape (Mastra harness). See W-23256760.
- */
-export declare class GPT54Geo extends Model {
-    readonly name: ModelName;
-    readonly displayId: string;
-    readonly maxInputTokens: number;
-    readonly maxOutputTokens: number;
-    readonly contextWindow: number;
-    readonly supportsPromptCache: boolean;
-    readonly supportedFormats: readonly SupportedFileFormat[];
-}

package/dist/models/gpt-5-4-geo.js

@@ -1,26 +0,0 @@
-/*
- * Copyright 2026, Salesforce, Inc. All rights reserved.
- * See LICENSE.txt for license terms.
- */
-import { Model, ModelName } from './model.js';
-import { MimeType } from './types.js';
-/**
- * GPT-5.4 on the geo-aware `sfdc_ai__Default*` gateway route — the regional
- * counterpart to the pinned `llmgateway__OpenAIGPT54` route ({@link GPT54}).
- * Routes to the OpenAI Responses wire shape (Mastra harness). See W-23256760.
- */
-export class GPT54Geo extends Model {
-    name = ModelName.GPT_5_4_GEO;
-    displayId = 'GPT-5.4 (geo-aware)';
-    // Source of truth: https://git.soma.salesforce.com/a360/file-metadata/blob/master/fm-model-config/src/main/resources/ai/file-metadata/model/openai/llmgateway/OpenAIGPT54.yml
-    maxInputTokens = 1050000;
-    maxOutputTokens = 128000;
-    contextWindow = 1050000;
-    supportsPromptCache = false;
-    supportedFormats = [
-        { name: 'png', mimeType: MimeType.Png },
-        { name: 'jpeg', mimeType: MimeType.Jpeg },
-        { name: 'pdf', mimeType: MimeType.Pdf },
-    ];
-}
-//# sourceMappingURL=gpt-5-4-geo.js.map

package/dist/models/gpt-5-geo.d.ts

@@ -1,17 +0,0 @@
-import { Model, ModelName } from './model.js';
-import { type SupportedFileFormat } from './types.js';
-/**
- * GPT-5 on the geo-aware `sfdc_ai__Default*` gateway route — the gateway
- * picks the regional OpenAI deployment, distinct from the pinned
- * `llmgateway__OpenAIGPT5` route ({@link GPT5}). Routes to the OpenAI
- * Responses wire shape (Mastra harness). See W-23256760.
- */
-export declare class GPT5Geo extends Model {
-    readonly name: ModelName;
-    readonly displayId: string;
-    readonly maxInputTokens: number;
-    readonly maxOutputTokens: number;
-    readonly contextWindow: number;
-    readonly supportsPromptCache: boolean;
-    readonly supportedFormats: readonly SupportedFileFormat[];
-}

package/dist/models/gpt-5-geo.js

@@ -1,28 +0,0 @@
-/*
- * Copyright 2026, Salesforce, Inc. All rights reserved.
- * See LICENSE.txt for license terms.
- */
-import { Model, ModelName } from './model.js';
-import { MimeType } from './types.js';
-/**
- * GPT-5 on the geo-aware `sfdc_ai__Default*` gateway route — the gateway
- * picks the regional OpenAI deployment, distinct from the pinned
- * `llmgateway__OpenAIGPT5` route ({@link GPT5}). Routes to the OpenAI
- * Responses wire shape (Mastra harness). See W-23256760.
- */
-export class GPT5Geo extends Model {
-    name = ModelName.GPT_5_GEO;
-    displayId = 'GPT-5 (geo-aware)';
-    // Reference: https://git.soma.salesforce.com/a360/file-metadata/blob/master/fm-model-config/src/main/resources/ai/file-metadata/model/openai/sfdc_ai/DefaultOpenAIGPT5.yml
-    maxInputTokens = 272000;
-    maxOutputTokens = 128000;
-    contextWindow = 272000;
-    supportsPromptCache = false;
-    // same as gpt-5
-    supportedFormats = [
-        { name: 'png', mimeType: MimeType.Png },
-        { name: 'jpeg', mimeType: MimeType.Jpeg },
-        { name: 'pdf', mimeType: MimeType.Pdf },
-    ];
-}
-//# sourceMappingURL=gpt-5-geo.js.map