@salesforce/sfdx-agent-sdk 0.32.0 → 0.34.0

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/dist/policy-resolver.d.ts

@@ -36,8 +36,10 @@ export type ResolverTiers = {
     /** Harness-shipped built-in rules (e.g. `MASTRA_BUILT_IN_TOOL_POLICIES`). */
     harness?: ReadonlyArray<ToolPolicyRule>;
     /**
-     * Synthetic rules from harness factory inputs during a deprecation window.
-     * Today: Claude's `bypassApprovalTools` translation. Empty after Phase 4.
+     * Reserved slot for synthetic rules a harness factory injects between the
+     * harness built-ins and the consumer's `toolPolicies`. No harness populates
+     * it today; it is kept so a future factory-injected tier can slot in
+     * without reshaping the resolver signature or the concatenation order.
      */
     factory?: ReadonlyArray<ToolPolicyRule>;
 };

package/dist/types/tools.d.ts

@@ -21,8 +21,8 @@ import type { McpToolAnnotations } from '../mcp-config.js';
  * For harness-executed (native) tools such as MCP tools, use
  * `AgentConfig.mcpServers` — those run in the harness and never need
  * `submitToolResult`. To gate harness-executed tool calls with human approval,
- * use `StreamOptions.requireToolApproval` plus `approveToolCall` /
- * `declineToolCall`.
+ * configure `AgentConfig.toolPolicies` / `AgentConfig.defaultToolDecision`
+ * plus `approveToolCall` / `declineToolCall`.
  *
  * Structurally compatible with AI SDK `LanguageModelV4FunctionTool`.
  */