@salesforce/sfdx-agent-sdk 0.48.0 → 0.49.0

package/CHANGELOG.md

@@ -3,6 +3,11 @@
 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.49.0] - 2026-08-14
+
+### Fixes
+- **agent-sdk**: export ACCEPTED_MODEL_WIRE_IDS for wire-boundary modelId validation @W-23694670@ ([#752](https://github.com/forcedotcom/agentic-dx/pull/752))
+
 ## [0.48.0] - 2026-08-10
 
 _No changes — released alongside dependent packages._

package/README.md

@@ -1176,6 +1176,10 @@ recognizes today, plus an escape hatch for consumers who need a Claude variant t
 - `Model` — abstract base class. Returned by `Models.getByName(...)` and accepted as an `AgentConfig.modelId` value.
 - `ModelName` — enum of in-tree model identifiers.
 - `Models` — registry: `Models.getByName(name)`, `Models.getDefault()`.
+- `ACCEPTED_MODEL_WIRE_IDS` — the `readonly string[]` union of canonical `ModelName` values and the legacy pinned
+  `llmgateway__*` alias keys `Models.getByName(...)` remaps. Consumers that validate an inbound `modelId` (e.g. a REST
+  body schema) should enumerate against this set, not `Object.values(ModelName)` alone, so a legacy id the resolver can
+  heal is not rejected at the wire boundary.
 - `createClaudeModel(gatewayId, overrides?)` — escape-hatch factory for opting into a Bedrock-Anthropic Claude variant
   the SDK has not released yet (`AgentConfig.modelId` accepts the returned instance directly).
 - `ClaudeModelOverrides` — optional caps for `createClaudeModel`.

package/dist/index.d.ts

@@ -9,7 +9,7 @@ export type { AgentConfig, HarnessAgentConfig, StreamOptions } from './harness/h
 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 { Model, ModelName, createClaudeModel, Models, validateMultimodalFiles, ACCEPTED_MODEL_WIRE_IDS, } 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';

package/dist/index.js

@@ -10,7 +10,7 @@
 export { BUILT_IN_TOOL_POLICIES, SKILL_BRIDGE_SERVER_ID, definePolicy, matcherMatches, resolveToolApprovalPolicy, } from './policy-resolver.js';
 export { DEFAULT_MAX_STEPS } from './harness/harness-config.js';
 export { McpServerStatus, mcpServerConfigEqual } from './mcp-config.js';
-export { Model, ModelName, createClaudeModel, Models, validateMultimodalFiles } from './models/index.js';
+export { Model, ModelName, createClaudeModel, Models, validateMultimodalFiles, ACCEPTED_MODEL_WIRE_IDS, } from './models/index.js';
 export { MimeType } from './models/index.js';
 export { inferSfApiEnv, SfApiEnv } from '@salesforce/agentic-common';
 // ── Agent Layer ─────────────────────────────────────────────────────

package/dist/models/index.d.ts

@@ -25,6 +25,16 @@ export { createClaudeModel, type ClaudeModelOverrides } from './create-claude-mo
  * (`sfdc_ai__DefaultGPT5` etc.) are already live `ModelName` values.
  */
 export declare const LEGACY_MODEL_ID_ALIASES: Readonly<Record<string, ModelName>>;
+/**
+ * Every model id accepted on an inbound request: the canonical {@link ModelName}
+ * values plus the legacy `llmgateway__*` alias keys {@link getByName} remaps.
+ *
+ * Consumers validating an inbound `modelId` should enumerate against this set, not
+ * `Object.values(ModelName)` alone — otherwise a legacy id is rejected at the wire
+ * boundary before the resolver that would heal it is reached. Deriving both this
+ * set and the resolver from {@link LEGACY_MODEL_ID_ALIASES} keeps them from drifting.
+ */
+export declare const ACCEPTED_MODEL_WIRE_IDS: readonly string[];
 export declare function getDefault(): Model;
 export declare function getByName(modelName: ModelName): Model;
 export declare const Models: {

package/dist/models/index.js

@@ -51,6 +51,19 @@ export const LEGACY_MODEL_ID_ALIASES = {
     llmgateway__BedrockAnthropicClaude47Opus: ModelName.CLAUDE_OPUS_4_7,
     llmgateway__BedrockAnthropicClaude48Opus: ModelName.CLAUDE_OPUS_4_8,
 };
+/**
+ * Every model id accepted on an inbound request: the canonical {@link ModelName}
+ * values plus the legacy `llmgateway__*` alias keys {@link getByName} remaps.
+ *
+ * Consumers validating an inbound `modelId` should enumerate against this set, not
+ * `Object.values(ModelName)` alone — otherwise a legacy id is rejected at the wire
+ * boundary before the resolver that would heal it is reached. Deriving both this
+ * set and the resolver from {@link LEGACY_MODEL_ID_ALIASES} keeps them from drifting.
+ */
+export const ACCEPTED_MODEL_WIRE_IDS = Object.freeze([
+    ...Object.values(ModelName),
+    ...Object.keys(LEGACY_MODEL_ID_ALIASES),
+]);
 export function getDefault() {
     return new ClaudeSonnet46();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/sfdx-agent-sdk",
-  "version": "0.48.0",
+  "version": "0.49.0",
   "description": "Harness-agnostic agentic infrastructure for Salesforce developer experience tooling",
   "type": "module",
   "main": "dist/index.js",
@@ -47,9 +47,9 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@salesforce/sfdx-agent-harness-claude": "0.44.0",
-    "@salesforce/sfdx-agent-harness-mastra": "0.47.0",
-    "@salesforce/sfdx-agent-harness-openai": "0.13.0",
+    "@salesforce/sfdx-agent-harness-claude": "0.45.0",
+    "@salesforce/sfdx-agent-harness-mastra": "0.48.0",
+    "@salesforce/sfdx-agent-harness-openai": "0.14.0",
     "@types/node": "^22.20.1",
     "@vitest/coverage-istanbul": "^4.1.10",
     "@vitest/eslint-plugin": "^1.6.26",