@salesforce/sfdx-agent-harness-claude 0.1.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/LICENSE.txt ADDED
@@ -0,0 +1,21 @@
1
+ Terms of Use
2
+
3
+ Copyright 2026 Salesforce, Inc. All rights reserved.
4
+
5
+ These Terms of Use govern the download, installation, and/or use of this software provided by Salesforce, Inc. ("Salesforce") (the "Software"), were last updated on March 24, 2026, and constitute a legally binding agreement between you and Salesforce. If you do not agree to these Terms of Use, do not install or use the Software. The Software may link to third-party software components licensed under various open source licenses ("Open Source Components"). These Terms of Use pertain solely to Salesforce's proprietary code in the Software. It does not alter or extend any rights or obligations regarding the Open Source Components. For clarity, your use of the Open Source Components is governed by the terms of the applicable open source license(s). You are solely responsible for complying with the terms and conditions of those open source licenses.
6
+
7
+ Salesforce grants you a worldwide, non-exclusive, no-charge, royalty-free copyright license to reproduce, revocable, publicly display, publicly perform, sublicense, and distribute the Software and derivative works subject to these Terms. These Terms shall be included in all copies or substantial portions of the Software.
8
+
9
+ Subject to the limited rights expressly granted hereunder, Salesforce reserves all rights, title, and interest in and to all intellectual property subsisting in the Software. No rights are granted to you hereunder other than as expressly set forth herein. Users residing in countries on the United States Office of Foreign Assets Control sanction list, or which are otherwise subject to a US export embargo, may not use the Software.
10
+
11
+ Implementation of the Software may require development work, for which you are responsible. The Software may contain bugs, errors and incompatibilities and is made available on an AS IS basis without support, updates, or service level commitments.
12
+
13
+ Salesforce reserves the right at any time to modify, suspend, or discontinue, the Software (or any part thereof) with or without notice. You agree that Salesforce shall not be liable to you or to any third party for any modification, suspension, or discontinuance.
14
+
15
+ You agree to defend Salesforce against any claim, demand, suit or proceeding made or brought against Salesforce by a third party arising out of or accruing from (a) your use of the Software, and (b) any application you develop with the Software that infringes any copyright, trademark, trade secret, trade dress, patent, or other intellectual property right of any person or defames any person or violates their rights of publicity or privacy (each a "Claim Against Salesforce"), and will indemnify Salesforce from any damages, attorney fees, and costs finally awarded against Salesforce as a result of, or for any amounts paid by Salesforce under a settlement approved by you in writing of, a Claim Against Salesforce, provided Salesforce (x) promptly gives you written notice of the Claim Against Salesforce, (y) gives you sole control of the defense and settlement of the Claim Against Salesforce (except that you may not settle any Claim Against Salesforce unless it unconditionally releases Salesforce of all liability), and (z) gives you all reasonable assistance, at your expense.
16
+
17
+ WITHOUT LIMITING THE GENERALITY OF THE FOREGOING, THE SOFTWARE IS NOT SUPPORTED AND IS PROVIDED "AS IS," WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. IN NO EVENT SHALL SALESFORCE HAVE ANY LIABILITY FOR ANY DAMAGES, INCLUDING, BUT NOT LIMITED TO, DIRECT, INDIRECT, SPECIAL, INCIDENTAL, PUNITIVE, OR CONSEQUENTIAL DAMAGES, OR DAMAGES BASED ON LOST PROFITS, DATA, OR USE, IN CONNECTION WITH THE SOFTWARE, HOWEVER CAUSED AND WHETHER IN CONTRACT, TORT, OR UNDER ANY OTHER THEORY OF LIABILITY, WHETHER OR NOT YOU HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
18
+
19
+ These Terms of Use shall be governed exclusively by the internal laws of the State of California, without regard to its conflicts of laws rules. Each party hereby consents to the exclusive jurisdiction of the state and federal courts located in San Francisco County, California to adjudicate any dispute arising out of or relating to these Terms of Use and the download, installation, and/or use of the Software. Except as expressly stated herein, these Terms of Use constitute the entire agreement between the parties, and supersede all prior and contemporaneous agreements, proposals, or representations, written or oral, concerning their subject matter. No modification, amendment, or waiver of any provision of these Terms of Use shall be effective unless it is by an update to these Terms of Use that Salesforce makes available, or is in writing and signed by the party against whom the modification, amendment, or waiver is to be asserted.
20
+
21
+ Data Privacy: Salesforce may collect, process, and store device, system, and other information related to your use of the Software. This information includes, but is not limited to, IP address, user metrics, and other data ("Usage Data"). Salesforce may use Usage Data for analytics, product development, and marketing purposes. You acknowledge that files generated in conjunction with the Software may contain sensitive or confidential data, and you are solely responsible for anonymizing and protecting such data.
package/README.md ADDED
@@ -0,0 +1,72 @@
1
+ # @salesforce/sfdx-agent-harness-claude
2
+
3
+ Claude Agent SDK-backed `AgentHarness` implementation for [`@salesforce/sfdx-agent-sdk`](../sfdx-agent-sdk). Provides
4
+ `ClaudeHarnessFactory`, the entry point consumers pass to `createAgentManager`.
5
+
6
+ ## Install
7
+
8
+ ```bash
9
+ npm install @salesforce/sfdx-agent-sdk @salesforce/sfdx-agent-harness-claude
10
+ ```
11
+
12
+ ## Quick start
13
+
14
+ ```ts
15
+ import { createAgentManager } from '@salesforce/sfdx-agent-sdk';
16
+ import { ClaudeHarnessFactory, DirectClaudeTransportResolver } from '@salesforce/sfdx-agent-harness-claude';
17
+
18
+ const harnessFactory = new ClaudeHarnessFactory({
19
+ resolver: new DirectClaudeTransportResolver(() => process.env.ANTHROPIC_API_KEY!),
20
+ });
21
+
22
+ const manager = await createAgentManager('/path/to/storage', harnessFactory);
23
+ ```
24
+
25
+ See the [`@salesforce/sfdx-agent-sdk` README](../sfdx-agent-sdk/README.md) for the full consumer-facing API. For
26
+ internal architecture, see [ARCHITECTURE.md](ARCHITECTURE.md).
27
+
28
+ ## Public API
29
+
30
+ | Export | Kind | Description |
31
+ | ------------------------------- | --------- | -------------------------------------------------------------------------------------- |
32
+ | `ClaudeHarnessFactory` | class | `HarnessFactory` that produces a Claude-backed `AgentHarness` bound to a storage root. |
33
+ | `ClaudeHarnessFactoryConfig` | interface | Configuration for `ClaudeHarnessFactory` (`resolver`, optional `queryDefaults`). |
34
+ | `ClaudeTransportResolver` | interface | Strategy for resolving transport env, auth, and native model ID for the subprocess. |
35
+ | `ClaudeTransportResolverResult` | type | Return type of `ClaudeTransportResolver.resolve()` (`env` + `nativeModelId`). |
36
+ | `ClaudeQueryDefaults` | type | Consumer-overridable defaults for the Claude `query()` call (excludes `model`). |
37
+ | `DirectClaudeTransportResolver` | class | Resolver for direct Anthropic API access (sets `ANTHROPIC_API_KEY`). |
38
+
39
+ ### Using a custom resolver
40
+
41
+ ```ts
42
+ import { createAgentManager } from '@salesforce/sfdx-agent-sdk';
43
+ import { ClaudeHarnessFactory } from '@salesforce/sfdx-agent-harness-claude';
44
+ import type { ClaudeTransportResolver } from '@salesforce/sfdx-agent-harness-claude';
45
+
46
+ const resolver: ClaudeTransportResolver = {
47
+ async resolve(orgJwt, modelId) {
48
+ return {
49
+ env: { ANTHROPIC_API_KEY: '...' },
50
+ nativeModelId: 'anthropic.claude-sonnet-4-6',
51
+ };
52
+ },
53
+ };
54
+
55
+ const harnessFactory = new ClaudeHarnessFactory({ resolver });
56
+ const manager = await createAgentManager('/path/to/storage', harnessFactory);
57
+ ```
58
+
59
+ ### Supplying query defaults
60
+
61
+ ```ts
62
+ const harnessFactory = new ClaudeHarnessFactory({
63
+ resolver: new DirectClaudeTransportResolver(() => process.env.ANTHROPIC_API_KEY!),
64
+ queryDefaults: {
65
+ maxTurns: 5,
66
+ },
67
+ });
68
+ ```
69
+
70
+ ## Development
71
+
72
+ See [DEVELOPING.md](DEVELOPING.md) for build, test, and packaging instructions.
@@ -0,0 +1,19 @@
1
+ import type { SDKMessage } from '@anthropic-ai/claude-agent-sdk';
2
+ import type { ChatEvent, MessagePart } from '@salesforce/sfdx-agent-sdk';
3
+ import type { LogBus } from '@salesforce/agentic-common';
4
+ export declare class ClaudeEventAdapter {
5
+ private started;
6
+ private stepIndex;
7
+ private pendingToolCalls;
8
+ private toolCallNames;
9
+ private readonly logBus?;
10
+ constructor(logBus?: LogBus);
11
+ mapMessage(msg: SDKMessage): ChatEvent[];
12
+ private mapResult;
13
+ private mapStreamEvent;
14
+ private mapContentBlockStart;
15
+ private mapContentBlockStop;
16
+ private mapMessageDelta;
17
+ private mapContentBlockDelta;
18
+ }
19
+ export declare function mapSessionMessageContent(message: unknown): string | MessagePart[];
@@ -0,0 +1,206 @@
1
+ /*
2
+ * Copyright 2026, Salesforce, Inc. All rights reserved.
3
+ * See LICENSE.txt for license terms.
4
+ */
5
+ export class ClaudeEventAdapter {
6
+ started = false;
7
+ stepIndex = 0;
8
+ pendingToolCalls = new Map();
9
+ toolCallNames = new Map();
10
+ logBus;
11
+ constructor(logBus) {
12
+ this.logBus = logBus;
13
+ }
14
+ mapMessage(msg) {
15
+ const events = [];
16
+ if (!this.started) {
17
+ this.started = true;
18
+ events.push({ type: 'start' });
19
+ }
20
+ if (msg.type === 'stream_event') {
21
+ this.mapStreamEvent(msg, events);
22
+ }
23
+ else if (msg.type === 'result') {
24
+ this.mapResult(msg, events);
25
+ }
26
+ else {
27
+ this.logBus?.debug('Unmapped SDK message type', { chunkType: msg.type });
28
+ events.push({ type: 'unmapped-chunk', chunkType: msg.type, rawChunk: msg });
29
+ }
30
+ return events;
31
+ }
32
+ mapResult(msg, events) {
33
+ if (msg.subtype === 'success') {
34
+ events.push({
35
+ type: 'finish',
36
+ finishReason: mapStopReason(msg.stop_reason),
37
+ usage: { inputTokens: msg.usage.input_tokens, outputTokens: msg.usage.output_tokens },
38
+ });
39
+ }
40
+ else {
41
+ const detail = msg.errors.join('; ') || 'unknown';
42
+ events.push({ type: 'error', error: new Error(`Query failed: ${detail}`), code: detail });
43
+ events.push({ type: 'finish', finishReason: 'error' });
44
+ }
45
+ }
46
+ mapStreamEvent(msg, events) {
47
+ const { event } = msg;
48
+ if (event.type === 'message_start') {
49
+ events.push({ type: 'step-start', stepIndex: this.stepIndex });
50
+ }
51
+ else if (event.type === 'content_block_start') {
52
+ this.mapContentBlockStart(event, events);
53
+ }
54
+ else if (event.type === 'content_block_delta') {
55
+ this.mapContentBlockDelta(event, events);
56
+ }
57
+ else if (event.type === 'content_block_stop') {
58
+ this.mapContentBlockStop(event, events);
59
+ }
60
+ else if (event.type === 'message_delta') {
61
+ this.mapMessageDelta(event, events);
62
+ }
63
+ else {
64
+ this.logBus?.debug('Unmapped stream event type', { chunkType: event.type });
65
+ events.push({ type: 'unmapped-chunk', chunkType: event.type, rawChunk: msg });
66
+ }
67
+ }
68
+ mapContentBlockStart(event, events) {
69
+ const block = event.content_block;
70
+ if (block.type === 'tool_use') {
71
+ this.pendingToolCalls.set(event.index, { id: block.id, name: block.name, argsJson: '' });
72
+ this.toolCallNames.set(block.id, block.name);
73
+ }
74
+ else if (block.type === 'mcp_tool_result') {
75
+ const toolName = this.toolCallNames.get(block.tool_use_id) ?? 'unknown';
76
+ events.push({
77
+ type: 'tool-result',
78
+ toolCallId: block.tool_use_id,
79
+ toolName,
80
+ result: block.content,
81
+ isError: block.is_error,
82
+ });
83
+ }
84
+ }
85
+ mapContentBlockStop(event, events) {
86
+ const pending = this.pendingToolCalls.get(event.index);
87
+ if (!pending)
88
+ return;
89
+ this.pendingToolCalls.delete(event.index);
90
+ let args = {};
91
+ try {
92
+ args = pending.argsJson ? JSON.parse(pending.argsJson) : {};
93
+ }
94
+ catch {
95
+ this.logBus?.warn('Failed to parse tool call arguments', {
96
+ toolCallId: pending.id,
97
+ toolName: pending.name,
98
+ });
99
+ }
100
+ events.push({
101
+ type: 'tool-call',
102
+ toolCallId: pending.id,
103
+ toolName: pending.name,
104
+ args,
105
+ });
106
+ }
107
+ mapMessageDelta(event, events) {
108
+ const usage = event.usage.output_tokens
109
+ ? { outputTokens: event.usage.output_tokens }
110
+ : undefined;
111
+ events.push({
112
+ type: 'step-finish',
113
+ stepIndex: this.stepIndex,
114
+ finishReason: mapStopReason(event.delta.stop_reason),
115
+ usage,
116
+ });
117
+ this.stepIndex++;
118
+ }
119
+ mapContentBlockDelta(event, events) {
120
+ const { delta } = event;
121
+ if (delta.type === 'text_delta') {
122
+ events.push({ type: 'text-delta', text: delta.text });
123
+ }
124
+ else if (delta.type === 'thinking_delta') {
125
+ events.push({ type: 'reasoning-delta', text: delta.thinking });
126
+ }
127
+ else if (delta.type === 'input_json_delta') {
128
+ const pending = this.pendingToolCalls.get(event.index);
129
+ if (pending) {
130
+ pending.argsJson += delta.partial_json;
131
+ }
132
+ }
133
+ }
134
+ }
135
+ function mapStopReason(stopReason) {
136
+ switch (stopReason) {
137
+ case 'end_turn':
138
+ return 'stop';
139
+ case 'max_tokens':
140
+ case 'model_context_window_exceeded':
141
+ return 'length';
142
+ case 'tool_use':
143
+ return 'tool-calls';
144
+ case 'refusal':
145
+ return 'content-filter';
146
+ default:
147
+ return 'other';
148
+ }
149
+ }
150
+ function extractContentBlocks(message) {
151
+ if (Array.isArray(message))
152
+ return message;
153
+ if (message && typeof message === 'object' && 'content' in message) {
154
+ const content = message.content;
155
+ if (typeof content === 'string')
156
+ return [{ type: 'text', text: content }];
157
+ if (Array.isArray(content))
158
+ return content;
159
+ }
160
+ return null;
161
+ }
162
+ export function mapSessionMessageContent(message) {
163
+ if (typeof message === 'string')
164
+ return message;
165
+ const blocks = extractContentBlocks(message);
166
+ if (!blocks)
167
+ return JSON.stringify(message);
168
+ const parts = [];
169
+ for (const block of blocks) {
170
+ switch (block.type) {
171
+ case 'text':
172
+ if (typeof block.text === 'string')
173
+ parts.push({ type: 'text', text: block.text });
174
+ break;
175
+ case 'thinking':
176
+ if (typeof block.thinking === 'string')
177
+ parts.push({ type: 'reasoning', text: block.thinking });
178
+ break;
179
+ case 'tool_use':
180
+ if (block.id && block.name) {
181
+ // Anthropic API guarantees tool_use.input is a JSON object; typed as unknown upstream
182
+ parts.push({
183
+ type: 'tool-call',
184
+ toolCallId: block.id,
185
+ toolName: block.name,
186
+ args: (block.input ?? {}),
187
+ });
188
+ }
189
+ break;
190
+ case 'tool_result':
191
+ if (block.tool_use_id) {
192
+ parts.push({
193
+ type: 'tool-result',
194
+ toolCallId: block.tool_use_id,
195
+ toolName: '',
196
+ result: block.content,
197
+ });
198
+ }
199
+ break;
200
+ default:
201
+ parts.push({ type: 'text', text: JSON.stringify(block) });
202
+ }
203
+ }
204
+ return parts.length > 0 ? parts : JSON.stringify(message);
205
+ }
206
+ //# sourceMappingURL=claude-event-adapter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"claude-event-adapter.js","sourceRoot":"","sources":["../src/claude-event-adapter.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ import type { PermissionMode } from '@anthropic-ai/claude-agent-sdk';
2
+ import type { HarnessFactory, AgentHarness } from '@salesforce/sfdx-agent-sdk';
3
+ import type { ClaudeTransportResolver } from './claude-transport-resolver.js';
4
+ import type { ClaudeQueryDefaults } from './claude-query-options-builder.js';
5
+ export interface ClaudeHarnessFactoryConfig {
6
+ resolver: ClaudeTransportResolver;
7
+ permissionMode: PermissionMode;
8
+ queryDefaults?: ClaudeQueryDefaults;
9
+ }
10
+ export declare class ClaudeHarnessFactory implements HarnessFactory {
11
+ private readonly config;
12
+ readonly harnessId = "claude";
13
+ readonly protocolVersion = 1;
14
+ constructor(config: ClaudeHarnessFactoryConfig);
15
+ create(storageRootFolder: string): Promise<AgentHarness>;
16
+ }
@@ -0,0 +1,27 @@
1
+ /*
2
+ * Copyright 2026, Salesforce, Inc. All rights reserved.
3
+ * See LICENSE.txt for license terms.
4
+ */
5
+ import { ClaudeQueryEnvBuilder } from './claude-query-env-builder.js';
6
+ import { ClaudeQueryOptionsBuilder } from './claude-query-options-builder.js';
7
+ import { ClaudeHarness } from './claude-harness.js';
8
+ export class ClaudeHarnessFactory {
9
+ config;
10
+ harnessId = 'claude';
11
+ protocolVersion = 1;
12
+ constructor(config) {
13
+ this.config = config;
14
+ }
15
+ async create(storageRootFolder) {
16
+ const envBuilder = new ClaudeQueryEnvBuilder(this.config.resolver, storageRootFolder);
17
+ const permissionDefaults = {
18
+ permissionMode: this.config.permissionMode,
19
+ ...(this.config.permissionMode === 'bypassPermissions'
20
+ ? { allowDangerouslySkipPermissions: true }
21
+ : {}),
22
+ };
23
+ const optionsBuilder = new ClaudeQueryOptionsBuilder({ ...permissionDefaults, ...this.config.queryDefaults });
24
+ return new ClaudeHarness(envBuilder, optionsBuilder);
25
+ }
26
+ }
27
+ //# sourceMappingURL=claude-harness-factory.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"claude-harness-factory.js","sourceRoot":"","sources":["../src/claude-harness-factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAQpD,MAAM,OAAO,oBAAoB;IAIA;IAHpB,SAAS,GAAG,QAAQ,CAAC;IACrB,eAAe,GAAG,CAAC,CAAC;IAE7B,YAA6B,MAAkC;QAAlC,WAAM,GAAN,MAAM,CAA4B;IAAG,CAAC;IAEnE,KAAK,CAAC,MAAM,CAAC,iBAAyB;QAClC,MAAM,UAAU,GAAG,IAAI,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;QACtF,MAAM,kBAAkB,GAAG;YACvB,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc;YAC1C,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,KAAK,mBAAmB;gBAClD,CAAC,CAAC,EAAE,+BAA+B,EAAE,IAAa,EAAE;gBACpD,CAAC,CAAC,EAAE,CAAC;SACZ,CAAC;QACF,MAAM,cAAc,GAAG,IAAI,yBAAyB,CAAC,EAAE,GAAG,kBAAkB,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;QAC9G,OAAO,IAAI,aAAa,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IACzD,CAAC;CACJ"}
@@ -0,0 +1,38 @@
1
+ import { type LogRecord, type UniqueIDGenerator, type Unsubscribe } from '@salesforce/agentic-common';
2
+ import { type AgentHarness, type ChatStreamResult, type HarnessAgentConfig, type McpServerInfo, type Message, type StreamOptions, type TelemetryEventCallback, type ToolResultInfo } from '@salesforce/sfdx-agent-sdk';
3
+ import type { LLMGatewayClient } from '@salesforce/llm-gateway-sdk';
4
+ import type { ClaudeQueryEnvBuilder } from './claude-query-env-builder.js';
5
+ import type { ClaudeQueryOptionsBuilder } from './claude-query-options-builder.js';
6
+ export declare class ClaudeHarness implements AgentHarness {
7
+ private readonly envBuilder;
8
+ private readonly optionsBuilder;
9
+ readonly harnessId = "claude";
10
+ readonly protocolVersion = 1;
11
+ private readonly buses;
12
+ private readonly agents;
13
+ private readonly idGenerator;
14
+ private shuttingDown;
15
+ constructor(envBuilder: ClaudeQueryEnvBuilder, optionsBuilder: ClaudeQueryOptionsBuilder, idGenerator?: UniqueIDGenerator);
16
+ shutdown(): Promise<void>;
17
+ onTelemetry(callback: TelemetryEventCallback): Unsubscribe;
18
+ onLog(callback: (record: LogRecord) => void): Unsubscribe;
19
+ createAgent(agentId: string, projectRoot: string, llmGatewayClient: LLMGatewayClient, config?: HarnessAgentConfig, _options?: {
20
+ abortSignal?: AbortSignal;
21
+ }): Promise<void>;
22
+ destroyAgent(agentId: string): Promise<boolean>;
23
+ getAgentIds(): Promise<string[]>;
24
+ getMcpServerInfo(_agentId: string): McpServerInfo[];
25
+ createThread(agentId: string, threadId?: string): Promise<string>;
26
+ destroyThread(agentId: string, threadId: string): Promise<void>;
27
+ getThreadIds(agentId: string): Promise<string[]>;
28
+ cloneThread(_agentId: string, _sourceThreadId: string, _targetThreadId?: string): Promise<string>;
29
+ compactThread(_agentId: string, _threadId: string): Promise<string>;
30
+ stream(agentId: string, threadId: string, message: string, streamOptions?: StreamOptions): Promise<ChatStreamResult>;
31
+ submitToolResult(_agentId: string, _threadId: string, _toolResult: ToolResultInfo): Promise<ChatStreamResult>;
32
+ approveToolCall(_agentId: string, _threadId: string, _toolCallId: string): Promise<ChatStreamResult>;
33
+ declineToolCall(_agentId: string, _threadId: string, _toolCallId: string): Promise<ChatStreamResult>;
34
+ getMessages(agentId: string, threadId: string): Promise<Message[]>;
35
+ clearMessages(agentId: string, threadId: string): Promise<void>;
36
+ private buildContextPrompt;
37
+ addContext(agentId: string, threadId: string, messages: Message[]): Promise<void>;
38
+ }
@@ -0,0 +1,196 @@
1
+ /*
2
+ * Copyright 2026, Salesforce, Inc. All rights reserved.
3
+ * See LICENSE.txt for license terms.
4
+ */
5
+ import { UUIDGenerator } from '@salesforce/agentic-common';
6
+ import { AgentSDKError, AgentSDKErrorType, HarnessBusOwner, } from '@salesforce/sfdx-agent-sdk';
7
+ import { deleteSession, getSessionMessages, query } from '@anthropic-ai/claude-agent-sdk';
8
+ import { ClaudeEventAdapter, mapSessionMessageContent } from './claude-event-adapter.js';
9
+ export class ClaudeHarness {
10
+ envBuilder;
11
+ optionsBuilder;
12
+ harnessId = 'claude';
13
+ protocolVersion = 1;
14
+ buses = new HarnessBusOwner();
15
+ agents = new Map();
16
+ idGenerator;
17
+ shuttingDown = false;
18
+ constructor(envBuilder, optionsBuilder, idGenerator = new UUIDGenerator()) {
19
+ this.envBuilder = envBuilder;
20
+ this.optionsBuilder = optionsBuilder;
21
+ this.idGenerator = idGenerator;
22
+ }
23
+ async shutdown() {
24
+ if (this.shuttingDown)
25
+ return;
26
+ this.shuttingDown = true;
27
+ this.agents.clear();
28
+ this.buses.dispose();
29
+ }
30
+ onTelemetry(callback) {
31
+ return this.buses.onTelemetry(callback);
32
+ }
33
+ onLog(callback) {
34
+ return this.buses.onLog(callback);
35
+ }
36
+ async createAgent(agentId, projectRoot, llmGatewayClient, config = {}, _options) {
37
+ if (this.agents.has(agentId)) {
38
+ throw new Error(`Agent with id "${agentId}" is already registered`);
39
+ }
40
+ this.agents.set(agentId, {
41
+ projectRoot,
42
+ config,
43
+ modelId: llmGatewayClient.getModel().name,
44
+ threads: new Map(),
45
+ });
46
+ }
47
+ async destroyAgent(agentId) {
48
+ return this.agents.delete(agentId);
49
+ }
50
+ async getAgentIds() {
51
+ return [...this.agents.keys()];
52
+ }
53
+ getMcpServerInfo(_agentId) {
54
+ return [];
55
+ }
56
+ async createThread(agentId, threadId) {
57
+ const agent = this.agents.get(agentId);
58
+ if (!agent) {
59
+ throw new Error(`Agent "${agentId}" not found`);
60
+ }
61
+ const id = threadId ?? this.idGenerator.getUniqueId();
62
+ agent.threads.set(id, { hasStreamed: false, pendingContext: [] });
63
+ return id;
64
+ }
65
+ async destroyThread(agentId, threadId) {
66
+ const agent = this.agents.get(agentId);
67
+ if (!agent) {
68
+ throw new Error(`Agent "${agentId}" not found`);
69
+ }
70
+ const threadState = agent.threads.get(threadId);
71
+ if (threadState?.hasStreamed) {
72
+ await deleteSession(threadId, { dir: agent.projectRoot });
73
+ }
74
+ agent.threads.delete(threadId);
75
+ }
76
+ async getThreadIds(agentId) {
77
+ const agent = this.agents.get(agentId);
78
+ if (!agent) {
79
+ throw new Error(`Agent "${agentId}" not found`);
80
+ }
81
+ return [...agent.threads.keys()];
82
+ }
83
+ async cloneThread(_agentId, _sourceThreadId, _targetThreadId) {
84
+ throw new AgentSDKError('Thread cloning is not supported by the Claude harness.', AgentSDKErrorType.NOT_SUPPORTED);
85
+ }
86
+ async compactThread(_agentId, _threadId) {
87
+ throw new AgentSDKError('The Claude SDK manages context compaction internally. Manual compaction is not supported.', AgentSDKErrorType.NOT_SUPPORTED);
88
+ }
89
+ async stream(agentId, threadId, message, streamOptions) {
90
+ const agentState = this.agents.get(agentId);
91
+ if (!agentState) {
92
+ throw new Error(`Agent "${agentId}" not found`);
93
+ }
94
+ const { projectRoot, config, modelId } = agentState;
95
+ const threadState = agentState.threads.get(threadId);
96
+ if (!config.orgJwt) {
97
+ throw new Error(`Agent "${agentId}" has no orgJwt configured`);
98
+ }
99
+ const { env, nativeModelId } = await this.envBuilder.build(config.orgJwt, modelId);
100
+ const sessionOptions = threadState?.hasStreamed ? { resume: threadId } : { sessionId: threadId };
101
+ const pendingContext = threadState?.pendingContext ?? [];
102
+ const contextConfig = pendingContext.length > 0
103
+ ? { ...config, instructions: this.buildContextPrompt(config.instructions, pendingContext) }
104
+ : config;
105
+ const options = this.optionsBuilder.build(projectRoot, contextConfig, streamOptions, env, sessionOptions, nativeModelId);
106
+ if (streamOptions?.abortSignal) {
107
+ streamOptions.abortSignal.throwIfAborted();
108
+ const controller = new AbortController();
109
+ streamOptions.abortSignal.addEventListener('abort', () => controller.abort(), { once: true });
110
+ options.abortController = controller;
111
+ }
112
+ if (threadState && pendingContext.length > 0) {
113
+ threadState.pendingContext = [];
114
+ }
115
+ const queryResult = query({ prompt: message, options });
116
+ if (threadState) {
117
+ threadState.hasStreamed = true;
118
+ }
119
+ const adapter = new ClaudeEventAdapter(this.buses.getLogBus());
120
+ async function* eventStream() {
121
+ try {
122
+ for await (const msg of queryResult) {
123
+ for (const event of adapter.mapMessage(msg)) {
124
+ yield event;
125
+ }
126
+ }
127
+ }
128
+ catch (err) {
129
+ const error = err instanceof Error ? err : new Error(String(err));
130
+ yield { type: 'error', error };
131
+ yield { type: 'finish', finishReason: 'error' };
132
+ }
133
+ }
134
+ // Known gap: textStream is a no-op; consumers should use eventStream text-delta events
135
+ async function* textStream() { }
136
+ return {
137
+ eventStream: eventStream(),
138
+ textStream: textStream(),
139
+ };
140
+ }
141
+ async submitToolResult(_agentId, _threadId, _toolResult) {
142
+ throw new AgentSDKError('Manual tool result submission is not supported by the Claude harness.', AgentSDKErrorType.NOT_SUPPORTED);
143
+ }
144
+ async approveToolCall(_agentId, _threadId, _toolCallId) {
145
+ throw new AgentSDKError('Tool approval is not supported by the Claude harness.', AgentSDKErrorType.NOT_SUPPORTED);
146
+ }
147
+ async declineToolCall(_agentId, _threadId, _toolCallId) {
148
+ throw new AgentSDKError('Tool decline is not supported by the Claude harness.', AgentSDKErrorType.NOT_SUPPORTED);
149
+ }
150
+ async getMessages(agentId, threadId) {
151
+ const agent = this.agents.get(agentId);
152
+ if (!agent) {
153
+ throw new Error(`Agent "${agentId}" not found`);
154
+ }
155
+ const sessionMessages = await getSessionMessages(threadId, { dir: agent.projectRoot });
156
+ return sessionMessages.map((msg) => ({
157
+ id: msg.uuid,
158
+ role: msg.type,
159
+ content: mapSessionMessageContent(msg.message),
160
+ }));
161
+ }
162
+ async clearMessages(agentId, threadId) {
163
+ const agent = this.agents.get(agentId);
164
+ if (!agent) {
165
+ throw new Error(`Agent "${agentId}" not found`);
166
+ }
167
+ const threadState = agent.threads.get(threadId);
168
+ if (!threadState) {
169
+ throw new Error(`Thread "${threadId}" not found`);
170
+ }
171
+ if (threadState.hasStreamed) {
172
+ await deleteSession(threadId, { dir: agent.projectRoot });
173
+ threadState.hasStreamed = false;
174
+ }
175
+ threadState.pendingContext = [];
176
+ }
177
+ buildContextPrompt(baseInstructions, messages) {
178
+ const contextBlock = messages
179
+ .map((m) => `[${m.role}]: ${typeof m.content === 'string' ? m.content : JSON.stringify(m.content)}`)
180
+ .join('\n');
181
+ const prefix = baseInstructions ? `${baseInstructions}\n\n` : '';
182
+ return `${prefix}<prior-context>\n${contextBlock}\n</prior-context>`;
183
+ }
184
+ async addContext(agentId, threadId, messages) {
185
+ const agent = this.agents.get(agentId);
186
+ if (!agent) {
187
+ throw new Error(`Agent "${agentId}" not found`);
188
+ }
189
+ const threadState = agent.threads.get(threadId);
190
+ if (!threadState) {
191
+ throw new Error(`Thread "${threadId}" not found`);
192
+ }
193
+ threadState.pendingContext.push(...messages);
194
+ }
195
+ }
196
+ //# sourceMappingURL=claude-harness.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"claude-harness.js","sourceRoot":"","sources":["../src/claude-harness.ts"],"names":[],"mappings":"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"}