@salesforce/sfdx-agent-sdk 0.27.0 → 0.29.0

package/CHANGELOG.md

@@ -3,6 +3,20 @@
 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.29.0] - 2026-07-02
+
+### Features
+- **agent-sdk**: support GPT5/5.1/5.2/5.4 geo-aware + Opus 4.8 @W-23256760@ ([#635](https://github.com/forcedotcom/agentic-dx/pull/635))
+
+## [0.28.0] - 2026-06-30
+
+### Features
+- **sdk,harness-mastra,harness-claude**: add bareToolName to MCP tool events for remember matcher @W-23090030 ([#634](https://github.com/forcedotcom/agentic-dx/pull/634))
+
+### Chores
+- **deps-dev**: bump the eslint group across 1 directory with 2 updates ([#629](https://github.com/forcedotcom/agentic-dx/pull/629))
+- **deps-dev**: bump prettier from 3.8.4 to 3.9.0 in the dev-dependencies group ([#628](https://github.com/forcedotcom/agentic-dx/pull/628))
+
 ## [0.27.0] - 2026-06-29
 
 ### Fixes

package/README.md

@@ -196,10 +196,10 @@ Discriminated union (`event.type`) of streaming events:
 | `start`                 | —                                                                                       | Stream has begun.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 | `text-delta`            | `text`                                                                                  | Incremental response text.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
 | `reasoning-delta`       | `text`                                                                                  | Chain-of-thought fragment.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
-| `tool-call`             | `toolCallId`, `toolName`, `args`, `annotations?`, `serverName?`                         | Tool invocation. `annotations` is the MCP-spec hints (`readOnlyHint`, `destructiveHint`, …) when the source declared them; `serverName` is set when the tool came from an MCP server.                                                                                                                                                                                                                                                                                                                                          |
+| `tool-call`             | `toolCallId`, `toolName`, `args`, `annotations?`, `serverName?`, `bareToolName?`        | Tool invocation. `annotations` is the MCP-spec hints (`readOnlyHint`, `destructiveHint`, …) when the source declared them; `serverName` is set when the tool came from an MCP server. `toolName` is the harness-namespaced display name; `bareToolName` is the un-namespaced leaf paired with `serverName` (set for MCP tools only) — use the `(serverName, bareToolName)` pair, never string-split `toolName`, for cross-harness identity.                                                                                       |
 | `tool-call-delta`       | `toolCallId`, `toolName?`, `argsTextDelta`                                              | Incremental fragment of a tool call's args JSON, emitted while the model composes the call. Concatenate successive deltas for the same `toolCallId` to build the args text; the parsed result matches the terminal `tool-call.args`. Useful for live-typing tool inputs UI; consumers that don't need streaming-args can ignore this event and continue reading the parsed `args` on the terminal `tool-call`. `toolName` is optional (Claude's signal does not carry it on the wire).                                         |
-| `tool-approval-request` | `toolCall: ToolCallInfo`, `annotations?`, `serverName?`                                 | Engine requests approval before executing a tool. Same `annotations` / `serverName` semantics as `tool-call`.                                                                                                                                                                                                                                                                                                                                                                                                                  |
-| `tool-result`           | `toolCallId`, `toolName`, `result`, `isError?`, `error?`, `annotations?`, `serverName?` | Tool execution completed. `error` is present when `isError` is true (best-effort: harnesses may synthesize an `Error` from a string payload, so `error.stack` is not guaranteed to point at the tool's throw site; the field may be absent on empty error payloads). Same `annotations` / `serverName` semantics as `tool-call`.                                                                                                                                                                                               |
+| `tool-approval-request` | `toolCall: ToolCallInfo`, `annotations?`, `serverName?`, `bareToolName?`                | Engine requests approval before executing a tool. Same `annotations` / `serverName` / `bareToolName` semantics as `tool-call`. `bareToolName` is the field the SDK reads to build the `remember` policy matcher (see [Tool Approval](#tool-approval)).                                                                                                                                                                                                                                                                          |
+| `tool-result`           | `toolCallId`, `toolName`, `result`, `isError?`, `error?`, `annotations?`, `serverName?`, `bareToolName?` | Tool execution completed. `error` is present when `isError` is true (best-effort: harnesses may synthesize an `Error` from a string payload, so `error.stack` is not guaranteed to point at the tool's throw site; the field may be absent on empty error payloads). Same `annotations` / `serverName` / `bareToolName` semantics as `tool-call`.                                                                                                                                                                              |
 | `tool-progress`         | `toolCallId`, `toolName`, `output?`, `parentToolCallId?`                                | Incremental progress signal from a long-running tool call. Distinct from `tool-result`: zero or more `tool-progress` events may be emitted before exactly one terminal `tool-result`. `output` and `parentToolCallId` are best-effort enrichment that depends on the tool — the event itself is the load-bearing "tool is still working" signal; consumers SHOULD NOT branch on which optional fields are present. Useful for "tool is working" UI on long-running tools (build, test, deploy, large search, sub-agent tasks). |
 | `step-start`            | `stepIndex`                                                                             | New LLM invocation step began.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
 | `step-finish`           | `stepIndex`, `finishReason`, `usage?`                                                   | Step completed with per-step token usage.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
@@ -320,9 +320,12 @@ const config: AgentConfig = {
 | Deny always  | `declineToolCall(id, { remember: true })` | Append a `deny` `remember` rule, persist, then settle.   |
 
 With `{ remember: true }` the SDK derives the matcher from the pending `tool-approval-request`'s
-`(toolName, serverName?)`, appends a `source: 'remember'` rule to `AgentConfig.toolPolicies`, and persists it via
-`updateAgentConfig` **before** settling — so the decision survives a restart and a persistence failure surfaces as the
-settle's rejection. A `remember` settle for a `toolCallId` with no pending approval throws `TOOL_CALL_NOT_FOUND`.
+`(serverName?, bareToolName ?? toolName)` — `bareToolName` is the harness-supplied un-namespaced leaf for MCP tools
+(building the matcher from the namespaced display `toolName` would never match on replay); built-in tools have no
+`bareToolName` and their `toolName` is already bare. It appends a `source: 'remember'` rule to
+`AgentConfig.toolPolicies` and persists it via `updateAgentConfig` **before** settling — so the decision survives a
+restart and a persistence failure surfaces as the settle's rejection. A `remember` settle for a `toolCallId` with no
+pending approval throws `TOOL_CALL_NOT_FOUND`.
 
 #### `MCPConfiguration`
 

package/dist/agent-connectivity-resolver.js

@@ -75,10 +75,13 @@ function pickProviderHintForGatewayModel(model) {
     if (name.startsWith('llmgateway__BedrockAnthropic') || name.startsWith('llmgateway__Anthropic')) {
         return 'bedrock-anthropic';
     }
-    if (name.startsWith('llmgateway__OpenAI')) {
+    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.
         return 'openai-responses';
     }
-    throw new Error(`Cannot infer providerHint for model "${name}". Salesforce gateway models must start with "llmgateway__BedrockAnthropic*" or "llmgateway__OpenAI*".`);
+    throw new Error(`Cannot infer providerHint for model "${name}". Salesforce gateway models must start with "llmgateway__BedrockAnthropic*", "llmgateway__OpenAI*", or "sfdc_ai__Default*".`);
 }
 /**
  * Returns the Salesforce LLM Gateway base URL for the given environment.

package/dist/chat-session.js

@@ -512,8 +512,15 @@ export class DefaultChatSession {
             // rule. Drained on settle, and on every terminal `finish` (see
             // `wrapEventStream`) so a stale entry can't be remembered after the
             // turn that requested it has ended.
+            //
+            // For an MCP tool, `event.toolCall.toolName` is the harness-namespaced
+            // DISPLAY name (`${server}_${tool}` / `mcp__${server}__${tool}`), which
+            // the SDK's `mcp` matcher would never match on replay. The harness
+            // supplies the un-namespaced leaf on `event.bareToolName` (paired with
+            // `serverName`); prefer it. Built-in / consumer tools leave
+            // `bareToolName` undefined and their `toolName` is already bare.
             this.pendingApprovalsByToolCallId.set(event.toolCall.toolCallId, {
-                toolName: event.toolCall.toolName,
+                toolName: event.bareToolName ?? event.toolCall.toolName,
                 ...(event.serverName ? { serverName: event.serverName } : {}),
             });
             this.telemetryBus.emit({

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

@@ -0,0 +1,11 @@
+import { Model, ModelName } from './model.js';
+import { type SupportedFileFormat } from './types.js';
+export declare class ClaudeOpus48 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/claude-opus-4-8.js

@@ -0,0 +1,22 @@
+/*
+ * Copyright 2026, Salesforce, Inc. All rights reserved.
+ * See LICENSE.txt for license terms.
+ */
+import { Model, ModelName } from './model.js';
+import { MimeType } from './types.js';
+export class ClaudeOpus48 extends Model {
+    name = ModelName.CLAUDE_OPUS_4_8;
+    displayId = 'Claude Opus 4.8';
+    // Caps mirror Opus 4.7 pending the gateway registry entry for
+    // BedrockAnthropicClaude48Opus.yml (W-23256760).
+    maxInputTokens = 1_000_000;
+    maxOutputTokens = 128_000;
+    contextWindow = 1_000_000;
+    supportsPromptCache = true;
+    supportedFormats = [
+        { name: 'png', mimeType: MimeType.Png, maxBytesPerFile: 3.75 * 1024 * 1024 },
+        { name: 'jpeg', mimeType: MimeType.Jpeg, maxBytesPerFile: 3.75 * 1024 * 1024 },
+        { name: 'pdf', mimeType: MimeType.Pdf, maxBytesPerFile: 4.5 * 1024 * 1024, maxFilesPerRequest: 5 },
+    ];
+}
+//# sourceMappingURL=claude-opus-4-8.js.map

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

@@ -0,0 +1,15 @@
+import { Model, ModelName } from './model.js';
+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 {
+    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-1-geo.js

@@ -0,0 +1,25 @@
+/*
+ * 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.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)';
+    // 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;
+    contextWindow = 272000;
+    supportsPromptCache = false;
+    supportedFormats = [
+        { name: 'png', mimeType: MimeType.Png },
+        { name: 'jpeg', mimeType: MimeType.Jpeg },
+        { name: 'pdf', mimeType: MimeType.Pdf },
+    ];
+}
+//# sourceMappingURL=gpt-5-1-geo.js.map

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

@@ -0,0 +1,15 @@
+import { Model, ModelName } from './model.js';
+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 {
+    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-2-geo.js

@@ -0,0 +1,24 @@
+/*
+ * 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.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)';
+    maxInputTokens = 272000;
+    maxOutputTokens = 128000;
+    contextWindow = 272000;
+    supportsPromptCache = false;
+    supportedFormats = [
+        { name: 'png', mimeType: MimeType.Png },
+        { name: 'jpeg', mimeType: MimeType.Jpeg },
+        { name: 'pdf', mimeType: MimeType.Pdf },
+    ];
+}
+//# sourceMappingURL=gpt-5-2-geo.js.map

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

@@ -0,0 +1,16 @@
+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

@@ -0,0 +1,26 @@
+/*
+ * 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

@@ -0,0 +1,17 @@
+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

@@ -0,0 +1,28 @@
+/*
+ * 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

package/dist/models/index.d.ts

@@ -5,11 +5,16 @@ export { validateMultimodalFiles, MAX_FILES_PER_REQUEST, MAX_TOTAL_FILE_BYTES }
 export { GPT5 } from './gpt-5.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';
 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';
 export declare function getDefault(): Model;
 export declare function getByName(modelName: ModelName): Model;

package/dist/models/index.js

@@ -6,22 +6,32 @@ import { Model, ModelName } from './model.js';
 import { GPT5 } from './gpt-5.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';
 import { ClaudeOpus46 } from './claude-opus-4-6.js';
 import { ClaudeOpus47 } from './claude-opus-4-7.js';
+import { ClaudeOpus48 } from './claude-opus-4-8.js';
 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 { 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';
 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';
 export function getDefault() {
     return new ClaudeSonnet46();
@@ -33,6 +43,14 @@ export function getByName(modelName) {
         return new GPT54();
     if (modelName === 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)
         return new ClaudeSonnet45();
     if (modelName === ModelName.CLAUDE_SONNET_4_6)
@@ -43,6 +61,8 @@ export function getByName(modelName) {
         return new ClaudeOpus46();
     if (modelName === ModelName.CLAUDE_OPUS_4_7)
         return new ClaudeOpus47();
+    if (modelName === ModelName.CLAUDE_OPUS_4_8)
+        return new ClaudeOpus48();
     throw new Error(`No model mapping exists for "${modelName}".`);
 }
 export const Models = { getDefault, getByName };

package/dist/models/model.d.ts

@@ -13,11 +13,16 @@ 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_7 = "llmgateway__BedrockAnthropicClaude47Opus",
+    CLAUDE_OPUS_4_8 = "llmgateway__BedrockAnthropicClaude48Opus"
 }
 /**
  * Abstract description of a model the SDK / harness can talk to. Used for:

package/dist/models/model.js

@@ -17,11 +17,19 @@ export var 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 || (ModelName = {}));
 /**
  * Abstract description of a model the SDK / harness can talk to. Used for:

package/dist/types/events.d.ts

@@ -67,6 +67,17 @@ export type ToolCallEvent = ToolCallInfo & {
      * server. `undefined` for consumer-declared tools or workspace tools.
      */
     serverName?: string;
+    /**
+     * The un-namespaced MCP tool name — the `(serverName, bareToolName)` pair
+     * equals `McpToolInfo.(serverName, toolName)`. Populated by the harness iff
+     * {@link serverName} is set; `undefined` for built-in / consumer / workspace
+     * tools (whose `toolName` is already bare). The display `toolName` field
+     * keeps the harness-namespaced form (Mastra `${server}_${tool}`, Claude
+     * `mcp__${server}__${tool}`); this is the policy-identity leaf the SDK builds
+     * a `{ type: 'mcp', serverName, toolName }` matcher from — harness-agnostic
+     * consumers MUST NOT derive it by string-splitting the display name.
+     */
+    bareToolName?: string;
 };
 /**
  * An incremental fragment of a tool call's args JSON, emitted while the
@@ -128,6 +139,18 @@ export type ToolApprovalRequestEvent = {
      * have no MCP origin.
      */
     serverName?: string;
+    /**
+     * The un-namespaced MCP tool name (the `(serverName, bareToolName)` pair
+     * equals `McpToolInfo.(serverName, toolName)`). Populated by the harness iff
+     * {@link serverName} is set. **This is the field
+     * {@link ChatSession.approveToolCall}(id, { remember: true }) reads to build
+     * the persisted `{ type: 'mcp', serverName, toolName }` rule** — the display
+     * `toolCall.toolName` keeps the harness-namespaced form, which the SDK's
+     * `mcp` matcher would never match on replay. `undefined` for built-in /
+     * consumer tools, whose `toolCall.toolName` is already the bare name the
+     * matcher uses.
+     */
+    bareToolName?: string;
 };
 /**
  * A real-time stream event indicating a tool execution has completed.
@@ -151,6 +174,14 @@ export type ToolResultEvent = ToolResultInfo & {
      * server. `undefined` for consumer-declared tools or workspace tools.
      */
     serverName?: string;
+    /**
+     * The un-namespaced MCP tool name; the `(serverName, bareToolName)` pair
+     * equals `McpToolInfo.(serverName, toolName)`. Populated by the harness iff
+     * {@link serverName} is set; `undefined` for built-in / consumer / workspace
+     * tools. The display `toolName` keeps the harness-namespaced form. See
+     * {@link ToolCallEvent.bareToolName}.
+     */
+    bareToolName?: string;
 };
 /**
  * An incremental tool-progress signal emitted while a long-running tool call is

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/sfdx-agent-sdk",
-  "version": "0.27.0",
+  "version": "0.29.0",
   "description": "Harness-agnostic agentic infrastructure for Salesforce developer experience tooling",
   "type": "module",
   "main": "dist/index.js",
@@ -44,19 +44,19 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@salesforce/sfdx-agent-harness-claude": "0.23.0",
-    "@salesforce/sfdx-agent-harness-mastra": "0.26.0",
+    "@salesforce/sfdx-agent-harness-claude": "0.25.0",
+    "@salesforce/sfdx-agent-harness-mastra": "0.28.0",
     "@types/node": "^22.20.0",
     "@vitest/coverage-istanbul": "^4.1.8",
     "@vitest/eslint-plugin": "^1.6.20",
-    "eslint": "^10.5.0",
+    "eslint": "^10.6.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-import-resolver-typescript": "^4.4.5",
     "eslint-plugin-import": "^2.32.0",
-    "eslint-plugin-n": "^18.1.0",
+    "eslint-plugin-n": "^18.2.1",
     "globals": "^17.6.0",
     "lint-staged": "^17.0.7",
-    "prettier": "^3.8.4",
+    "prettier": "^3.9.0",
     "rimraf": "^6.1.3",
     "tsx": "^4.22.4",
     "typescript": "^6.0.3",