@salesforce/sfdx-agent-sdk 0.70.0 → 0.72.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -3,6 +3,16 @@
3
3
  All notable changes to `@salesforce/sfdx-agent-sdk` are documented in this file.
4
4
  Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
5
5
 
6
+ ## [0.72.0] - 2026-09-02
7
+
8
+ ### Features
9
+ - **harness-openai,harness-conformance,agent-sdk**: render session context + carry-forward + bare-tool fidelity @W-23632694@ ([#759](https://github.com/forcedotcom/agentic-dx/pull/759))
10
+
11
+ ## [0.71.0] - 2026-09-02
12
+
13
+ ### Chores
14
+ - bump dependencies to latest in-range, minor/patch versions @W-23913439@ ([#781](https://github.com/forcedotcom/agentic-dx/pull/781))
15
+
6
16
  ## [0.70.0] - 2026-09-02
7
17
 
8
18
  ### Features
package/README.md CHANGED
@@ -174,7 +174,7 @@ A single conversation thread.
174
174
  | `getContextUsage` | `() => ContextUsage` | Snapshot of how much of the model's context window the most recent turn used. |
175
175
  | `addMessages` | `(message: string \| Message[]) => Promise<void>` | Append real transcript messages (`user` / `assistant` / `tool`) to the thread **without requesting an agent response** — the write-only half of a turn. The messages persist, appear in `getMessageHistory()`, and replay to the model as prior conversation on the next `chat()`. Use it to seed earlier turns (e.g. file contents as a user message) before the first live prompt; the SDK equivalent of the service's `POST /messages` with `noReply=true`. **Not** `setSessionContext`: this writes _transcript history_ (visible in `getMessageHistory`, additive); `setSessionContext` writes an _out-of-history overlay object_ (never in history, whole-object replace). `'system'` is not a valid role here — system-level state rides `setSessionContext` / `AgentConfig.instructions`. |
176
176
  | `addContext` | `(message: string \| Message[]) => Promise<void>` | **Deprecated** — renamed to `addMessages` (identical signature/behavior); delegates to it. The old name read as a sibling of `setSessionContext`, but the two are distinct channels. Will be removed in a future release; migrate to `addMessages`. |
177
- | `setSessionContext` | `(content: SessionContext) => Promise<void>` | Replace this session's session-context object in full (whole-object set, not a merge). Persisted per-thread and durable across restart; kept out of message history, so it never appears in `getMessageHistory()`. **Rendering is staged per harness** — the Mastra and Claude harnesses render the stored object into the model's system-level context on every subsequent turn (deterministic, key-ordered); OpenAI Agents stages its rendering in a follow-up PR (persistence is already live on all three). Delegates to `AgentHarness.setSessionContext` — see that method's JSDoc for the full delivery/durability/isolation contract. |
177
+ | `setSessionContext` | `(content: SessionContext) => Promise<void>` | Replace this session's session-context object in full (whole-object set, not a merge). Persisted per-thread and durable across restart; kept out of message history, so it never appears in `getMessageHistory()`. Rendered into the model's system-level context on every subsequent turn (deterministic, key-ordered) on all three harnesses (**Mastra** W-23632686, **Claude** W-23632691, and **OpenAI** W-23632694). Delegates to `AgentHarness.setSessionContext` — see that method's JSDoc for the full delivery/durability/isolation contract. |
178
178
  | `getSessionContext` | `() => Promise<SessionContext>` | Read this session's current session-context object. Returns `{}` (an empty object) — never `null` or `undefined` — when nothing has been set on this thread yet, so callers never need a null-check. Unrelated to `getContextUsage()`, which reports context-window token occupancy, not the seeded context object. |
179
179
  | `subscribe` | `(callback: (event: ChatEvent) => void) => void` | Register a real-time event listener. |
180
180
  | `unsubscribe` | `(callback: (event: ChatEvent) => void) => void` | Remove a listener. |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@salesforce/sfdx-agent-sdk",
3
- "version": "0.70.0",
3
+ "version": "0.72.0",
4
4
  "description": "Harness-agnostic agentic infrastructure for Salesforce developer experience tooling",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -43,29 +43,29 @@
43
43
  "LICENSE.txt"
44
44
  ],
45
45
  "dependencies": {
46
- "@salesforce/agentic-common": "0.18.0"
46
+ "@salesforce/agentic-common": "0.19.0"
47
47
  },
48
48
  "devDependencies": {
49
49
  "@eslint/js": "^10.0.1",
50
- "@salesforce/sfdx-agent-harness-claude": "0.66.0",
51
- "@salesforce/sfdx-agent-harness-mastra": "0.69.0",
52
- "@salesforce/sfdx-agent-harness-openai": "0.35.0",
50
+ "@salesforce/sfdx-agent-harness-claude": "0.68.0",
51
+ "@salesforce/sfdx-agent-harness-mastra": "0.71.0",
52
+ "@salesforce/sfdx-agent-harness-openai": "0.37.0",
53
53
  "@types/node": "^22.20.1",
54
- "@vitest/coverage-istanbul": "^4.1.10",
54
+ "@vitest/coverage-istanbul": "^4.1.11",
55
55
  "@vitest/eslint-plugin": "^1.6.27",
56
56
  "eslint": "^10.9.1",
57
57
  "eslint-config-prettier": "^10.1.8",
58
58
  "eslint-import-resolver-typescript": "^4.4.5",
59
59
  "eslint-plugin-import": "^2.32.0",
60
60
  "eslint-plugin-n": "^18.3.0",
61
- "globals": "^17.11.0",
61
+ "globals": "^17.12.0",
62
62
  "lint-staged": "^17.3.0",
63
63
  "prettier": "^3.9.6",
64
64
  "rimraf": "^6.1.3",
65
65
  "tsx": "^4.23.12",
66
66
  "typescript": "^7.0.2",
67
67
  "typescript-eslint": "^8.68.0",
68
- "vitest": "^4.1.8"
68
+ "vitest": "^4.1.11"
69
69
  },
70
70
  "engines": {
71
71
  "node": ">=22.22.1"