@salesforce/sfdx-agent-sdk 0.28.0 → 0.30.0

package/CHANGELOG.md

@@ -3,6 +3,15 @@
 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.30.0] - 2026-07-03
+
+_No changes — released alongside dependent packages._
+
+## [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

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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/sfdx-agent-sdk",
-  "version": "0.28.0",
+  "version": "0.30.0",
   "description": "Harness-agnostic agentic infrastructure for Salesforce developer experience tooling",
   "type": "module",
   "main": "dist/index.js",
@@ -44,8 +44,8 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@salesforce/sfdx-agent-harness-claude": "0.24.0",
-    "@salesforce/sfdx-agent-harness-mastra": "0.27.0",
+    "@salesforce/sfdx-agent-harness-claude": "0.26.0",
+    "@salesforce/sfdx-agent-harness-mastra": "0.29.0",
     "@types/node": "^22.20.0",
     "@vitest/coverage-istanbul": "^4.1.8",
     "@vitest/eslint-plugin": "^1.6.20",