@salesforce/sfdx-agent-sdk 0.34.0 → 0.35.0

package/CHANGELOG.md

@@ -3,6 +3,21 @@
 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

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';
 /**
@@ -109,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

@@ -106,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';
@@ -127,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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/sfdx-agent-sdk",
-  "version": "0.34.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.30.0",
-    "@salesforce/sfdx-agent-harness-mastra": "0.33.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",