@salesforce/sfdx-agent-sdk 0.30.0 → 0.31.0

package/CHANGELOG.md

@@ -3,6 +3,17 @@
 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.31.0] - 2026-07-07
+
+### Features
+- **agent-sdk**: registry-driven model-connectivity smoke @W-23292476@ ([#641](https://github.com/forcedotcom/agentic-dx/pull/641))
+
+### Fixes
+- **harness-mastra**: getMessages() round-trips the tool-call part @W-23351939 ([#648](https://github.com/forcedotcom/agentic-dx/pull/648))
+
+### Chores
+- **deps-dev**: bump the dev-dependencies group with 3 updates ([#642](https://github.com/forcedotcom/agentic-dx/pull/642))
+
 ## [0.30.0] - 2026-07-03
 
 _No changes — released alongside dependent packages._

package/dist/agent-connectivity-resolver.d.ts

@@ -1,7 +1,7 @@
 import { Model } from './models/index.js';
 import { type JSONWebToken, type OrgConnection, type OrgConnectionFactory } from '@salesforce/agentic-common';
 import type { AgentConfig } from './harness/harness-config.js';
-import type { ModelConnectivityInfo } from './types/model-connectivity-info.js';
+import type { ModelConnectivityInfo, ProviderHint } from './types/model-connectivity-info.js';
 /**
  * The result of resolving an agent's connectivity.
  *
@@ -82,6 +82,27 @@ export declare class DefaultAgentConnectivityResolver implements AgentConnectivi
      */
     resolve(projectRoot: string, config: AgentConfig): Promise<ResolvedConnectivity>;
 }
+/**
+ * Maps a Salesforce gateway-routed {@link Model} to the wire shape the harness will
+ * speak. Anthropic models go to the `/invoke-with-response-stream` (Bedrock-Anthropic)
+ * pass-through endpoint; OpenAI models go to the `/responses` (OpenAI Responses)
+ * pass-through endpoint. Throws for any model whose family cannot be inferred from
+ * its `name` — a programming error worth surfacing eagerly rather than silently
+ * defaulting.
+ *
+ * **Scope:** This helper is for the Salesforce gateway path only — both
+ * `llmgateway__BedrockAnthropic*` and `llmgateway__Anthropic*` prefixes go to the
+ * gateway's Bedrock pass-through, so both collapse to `'bedrock-anthropic'`. A
+ * consumer wanting direct-Anthropic auth (`providerHint: 'anthropic'`) drives that
+ * path through {@link ApiKeyConnectivityResolver} with an explicit `providerHint`
+ * argument, not through this resolver.
+ *
+ * Exported (module-path only, not on the public `index.ts` surface) so e2e test
+ * resolvers reuse the same prefix→hint mapping rather than re-deriving it — a
+ * divergent hand-rolled ternary in `test/e2e/e2e-setup.ts` misrouted the
+ * `sfdc_ai__Default*` geo ids to `bedrock-anthropic` (W-23292476).
+ */
+export declare function pickProviderHintForGatewayModel(model: Model): ProviderHint;
 /**
  * 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

@@ -69,8 +69,13 @@ export class DefaultAgentConnectivityResolver {
  * consumer wanting direct-Anthropic auth (`providerHint: 'anthropic'`) drives that
  * path through {@link ApiKeyConnectivityResolver} with an explicit `providerHint`
  * argument, not through this resolver.
+ *
+ * Exported (module-path only, not on the public `index.ts` surface) so e2e test
+ * resolvers reuse the same prefix→hint mapping rather than re-deriving it — a
+ * divergent hand-rolled ternary in `test/e2e/e2e-setup.ts` misrouted the
+ * `sfdc_ai__Default*` geo ids to `bedrock-anthropic` (W-23292476).
  */
-function pickProviderHintForGatewayModel(model) {
+export function pickProviderHintForGatewayModel(model) {
     const name = model.name;
     if (name.startsWith('llmgateway__BedrockAnthropic') || name.startsWith('llmgateway__Anthropic')) {
         return 'bedrock-anthropic';

package/dist/harness/agent-harness.d.ts

@@ -406,6 +406,17 @@ export interface AgentHarness {
      * MUST populate `Message.createdAt` on every returned message. MUST return
      * messages sorted ascending by `createdAt`.
      *
+     * **Tool calls MUST round-trip both halves.** For every completed tool
+     * invocation the returned history MUST contain BOTH a `tool-call`
+     * {@link MessagePart} (carrying the model's `toolName` + `args`) AND a
+     * `tool-result` part (carrying the outcome). The two share a `toolCallId`.
+     * A harness that collapses a completed call to only its `tool-result` makes
+     * history harness-dependent — the model's original call (name + args) is
+     * lost on read — which breaks any consumer that renders, replays, or audits
+     * tool activity from history (e.g. an AG-UI `MESSAGES_SNAPSHOT`). This is a
+     * cross-harness contract; the Claude harness, which stores the call and
+     * result as distinct blocks, is the reference behavior (#647).
+     *
      * @param agentId - ID of the agent.
      * @param threadId - ID of the conversation thread.
      * @returns All messages in chronological order (ascending by `createdAt`).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/sfdx-agent-sdk",
-  "version": "0.30.0",
+  "version": "0.31.0",
   "description": "Harness-agnostic agentic infrastructure for Salesforce developer experience tooling",
   "type": "module",
   "main": "dist/index.js",
@@ -29,6 +29,8 @@
     "test:e2e": "tsc --build ./test/tsconfig.json && vitest run -c ./test/e2e/vitest.config.ts",
     "test:e2e:local": "node scripts/local-e2e.mjs",
     "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",
     "verify": "tsx scripts/verify.ts"
   },
   "license": "SEE LICENSE IN LICENSE.txt",
@@ -44,8 +46,8 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@salesforce/sfdx-agent-harness-claude": "0.26.0",
-    "@salesforce/sfdx-agent-harness-mastra": "0.29.0",
+    "@salesforce/sfdx-agent-harness-claude": "0.27.0",
+    "@salesforce/sfdx-agent-harness-mastra": "0.30.0",
     "@types/node": "^22.20.0",
     "@vitest/coverage-istanbul": "^4.1.8",
     "@vitest/eslint-plugin": "^1.6.20",
@@ -56,11 +58,11 @@
     "eslint-plugin-n": "^18.2.1",
     "globals": "^17.6.0",
     "lint-staged": "^17.0.7",
-    "prettier": "^3.9.0",
+    "prettier": "^3.9.4",
     "rimraf": "^6.1.3",
-    "tsx": "^4.22.4",
+    "tsx": "^4.23.0",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.61.0",
+    "typescript-eslint": "^8.62.1",
     "vitest": "^4.1.8"
   },
   "engines": {