@aaac/runtime 0.1.22 → 0.1.24
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/dist/adapters/adk-sdk.d.ts +1 -1
- package/dist/adapters/claude-agent-sdk.d.ts +9 -1
- package/dist/adapters/claude-agent-sdk.js +68 -5
- package/dist/adapters/claude-agent-sdk.js.map +1 -1
- package/dist/adapters/mock.d.ts +1 -1
- package/dist/adapters/openai-agents-sdk.d.ts +1 -1
- package/dist/{chunk-FNB3PE74.js → chunk-3HT5BILT.js} +5 -3
- package/dist/chunk-3HT5BILT.js.map +1 -0
- package/dist/index.d.ts +3 -31
- package/dist/index.js +92 -12
- package/dist/index.js.map +1 -1
- package/dist/{task-runner-CuJ3uLj8.d.ts → task-runner-Bl3SZfft.d.ts} +61 -2
- package/package.json +1 -1
- package/dist/chunk-FNB3PE74.js.map +0 -1
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { S as SdkAdapter, G as GuardrailHooks, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef } from '../task-runner-
|
|
1
|
+
import { S as SdkAdapter, G as GuardrailHooks, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef } from '../task-runner-Bl3SZfft.js';
|
|
2
2
|
import 'zod';
|
|
3
3
|
import '../context-DKkamYX_.js';
|
|
4
4
|
import '@aaac/observability';
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { S as SdkAdapter, G as GuardrailHooks, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef } from '../task-runner-
|
|
1
|
+
import { S as SdkAdapter, G as GuardrailHooks, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef, T as TokenUsage } from '../task-runner-Bl3SZfft.js';
|
|
2
2
|
import 'zod';
|
|
3
3
|
import '../context-DKkamYX_.js';
|
|
4
4
|
import '@aaac/observability';
|
|
@@ -39,6 +39,12 @@ type SDKMessage = {
|
|
|
39
39
|
tool_name?: string;
|
|
40
40
|
summary?: string;
|
|
41
41
|
message?: SDKBetaMessage;
|
|
42
|
+
usage?: {
|
|
43
|
+
input_tokens?: number;
|
|
44
|
+
output_tokens?: number;
|
|
45
|
+
cache_read_input_tokens?: number;
|
|
46
|
+
cache_creation_input_tokens?: number;
|
|
47
|
+
};
|
|
42
48
|
};
|
|
43
49
|
type QueryOptions = Record<string, unknown>;
|
|
44
50
|
type QueryFn = (params: {
|
|
@@ -77,6 +83,7 @@ declare class ClaudeAgentSdkAdapter implements SdkAdapter {
|
|
|
77
83
|
private cacheConfig;
|
|
78
84
|
private lastSessionId;
|
|
79
85
|
private lastMemoryRef;
|
|
86
|
+
private lastTokenUsage;
|
|
80
87
|
private queryFn;
|
|
81
88
|
constructor(config?: ClaudeAgentSdkAdapterConfig);
|
|
82
89
|
private resolveQueryFn;
|
|
@@ -87,6 +94,7 @@ declare class ClaudeAgentSdkAdapter implements SdkAdapter {
|
|
|
87
94
|
followUp(message: string): Promise<string>;
|
|
88
95
|
sendExecution(request: AgentExecutionRequest): Promise<string>;
|
|
89
96
|
getLastMemoryRef(): MemoryRef | null;
|
|
97
|
+
getLastTokenUsage(): TokenUsage | null;
|
|
90
98
|
isCompatible(compat: string): boolean;
|
|
91
99
|
/**
|
|
92
100
|
* Inject a custom query function for testing.
|
|
@@ -3,7 +3,7 @@ import {
|
|
|
3
3
|
emitLlmTurnOpen,
|
|
4
4
|
emitToolExecClose,
|
|
5
5
|
emitToolExecOpen
|
|
6
|
-
} from "../chunk-
|
|
6
|
+
} from "../chunk-3HT5BILT.js";
|
|
7
7
|
import {
|
|
8
8
|
buildClaudeMcpServer
|
|
9
9
|
} from "../chunk-LONLL3K2.js";
|
|
@@ -78,6 +78,7 @@ var ClaudeAgentSdkAdapter = class _ClaudeAgentSdkAdapter {
|
|
|
78
78
|
cacheConfig;
|
|
79
79
|
lastSessionId = null;
|
|
80
80
|
lastMemoryRef = null;
|
|
81
|
+
lastTokenUsage = null;
|
|
81
82
|
queryFn = null;
|
|
82
83
|
constructor(config = {}) {
|
|
83
84
|
this.cwd = config.cwd ?? process.cwd();
|
|
@@ -161,10 +162,18 @@ var ClaudeAgentSdkAdapter = class _ClaudeAgentSdkAdapter {
|
|
|
161
162
|
const stream = queryFn({ prompt, options });
|
|
162
163
|
let resultText = "";
|
|
163
164
|
let sessionId = "";
|
|
165
|
+
let totalInputTokens = 0;
|
|
166
|
+
let totalOutputTokens = 0;
|
|
167
|
+
let totalCacheReadTokens = 0;
|
|
168
|
+
let totalCacheCreationTokens = 0;
|
|
169
|
+
let hasUsageData = false;
|
|
164
170
|
let turnNumber = 0;
|
|
165
171
|
let currentTurnSpanId;
|
|
166
172
|
let currentTurnStart = 0;
|
|
167
173
|
let toolCallsInTurn = 0;
|
|
174
|
+
let turnInputTokens = 0;
|
|
175
|
+
let turnOutputTokens = 0;
|
|
176
|
+
let turnCacheHitTokens = 0;
|
|
168
177
|
const openToolSpans = [];
|
|
169
178
|
const closePendingToolSpans = () => {
|
|
170
179
|
for (const ts of openToolSpans) {
|
|
@@ -175,14 +184,40 @@ var ClaudeAgentSdkAdapter = class _ClaudeAgentSdkAdapter {
|
|
|
175
184
|
const closeCurrentTurn = () => {
|
|
176
185
|
if (currentTurnSpanId) {
|
|
177
186
|
emitLlmTurnClose(observer, currentTurnSpanId, turnNumber, Date.now() - currentTurnStart, {
|
|
187
|
+
inputTokens: turnInputTokens || void 0,
|
|
188
|
+
outputTokens: turnOutputTokens || void 0,
|
|
189
|
+
cacheHitTokens: turnCacheHitTokens || void 0,
|
|
178
190
|
toolCallsCount: toolCallsInTurn || void 0
|
|
179
191
|
});
|
|
180
192
|
currentTurnSpanId = void 0;
|
|
181
193
|
}
|
|
182
194
|
};
|
|
195
|
+
const captureUsage = (usage, perTurn = true) => {
|
|
196
|
+
if (!usage) return;
|
|
197
|
+
if (typeof usage.input_tokens === "number") {
|
|
198
|
+
totalInputTokens += usage.input_tokens;
|
|
199
|
+
if (perTurn) turnInputTokens += usage.input_tokens;
|
|
200
|
+
hasUsageData = true;
|
|
201
|
+
}
|
|
202
|
+
if (typeof usage.output_tokens === "number") {
|
|
203
|
+
totalOutputTokens += usage.output_tokens;
|
|
204
|
+
if (perTurn) turnOutputTokens += usage.output_tokens;
|
|
205
|
+
hasUsageData = true;
|
|
206
|
+
}
|
|
207
|
+
if (typeof usage.cache_read_input_tokens === "number") {
|
|
208
|
+
totalCacheReadTokens += usage.cache_read_input_tokens;
|
|
209
|
+
if (perTurn) turnCacheHitTokens += usage.cache_read_input_tokens;
|
|
210
|
+
hasUsageData = true;
|
|
211
|
+
}
|
|
212
|
+
if (typeof usage.cache_creation_input_tokens === "number") {
|
|
213
|
+
totalCacheCreationTokens += usage.cache_creation_input_tokens;
|
|
214
|
+
hasUsageData = true;
|
|
215
|
+
}
|
|
216
|
+
};
|
|
183
217
|
for await (const message of stream) {
|
|
184
218
|
if (message.session_id) sessionId = message.session_id;
|
|
185
219
|
if (message.type === "result") {
|
|
220
|
+
captureUsage(message.usage, false);
|
|
186
221
|
closePendingToolSpans();
|
|
187
222
|
closeCurrentTurn();
|
|
188
223
|
if (message.subtype === "success") {
|
|
@@ -195,8 +230,12 @@ var ClaudeAgentSdkAdapter = class _ClaudeAgentSdkAdapter {
|
|
|
195
230
|
closeCurrentTurn();
|
|
196
231
|
turnNumber++;
|
|
197
232
|
toolCallsInTurn = 0;
|
|
233
|
+
turnInputTokens = 0;
|
|
234
|
+
turnOutputTokens = 0;
|
|
235
|
+
turnCacheHitTokens = 0;
|
|
198
236
|
currentTurnStart = Date.now();
|
|
199
237
|
currentTurnSpanId = emitLlmTurnOpen(observer, parentSpanId, turnNumber, this.model);
|
|
238
|
+
captureUsage(message.usage);
|
|
200
239
|
const content = message.message?.content;
|
|
201
240
|
if (content) {
|
|
202
241
|
for (const block of content) {
|
|
@@ -214,6 +253,7 @@ var ClaudeAgentSdkAdapter = class _ClaudeAgentSdkAdapter {
|
|
|
214
253
|
emitProgressFromSdkMessage(message, onProgress, sessionId);
|
|
215
254
|
}
|
|
216
255
|
} else {
|
|
256
|
+
captureUsage(message.usage);
|
|
217
257
|
if (onProgress) {
|
|
218
258
|
emitProgressFromSdkMessage(message, onProgress, sessionId);
|
|
219
259
|
}
|
|
@@ -221,7 +261,14 @@ var ClaudeAgentSdkAdapter = class _ClaudeAgentSdkAdapter {
|
|
|
221
261
|
}
|
|
222
262
|
closePendingToolSpans();
|
|
223
263
|
closeCurrentTurn();
|
|
224
|
-
|
|
264
|
+
const tokenUsage = hasUsageData ? {
|
|
265
|
+
inputTokens: totalInputTokens,
|
|
266
|
+
outputTokens: totalOutputTokens,
|
|
267
|
+
totalTokens: totalInputTokens + totalOutputTokens,
|
|
268
|
+
...totalCacheReadTokens > 0 ? { cacheReadTokens: totalCacheReadTokens } : {},
|
|
269
|
+
...totalCacheCreationTokens > 0 ? { cacheCreationTokens: totalCacheCreationTokens } : {}
|
|
270
|
+
} : void 0;
|
|
271
|
+
return { text: resultText, sessionId, tokenUsage };
|
|
225
272
|
}
|
|
226
273
|
// -------------------------------------------------------------------------
|
|
227
274
|
// SdkAdapter interface
|
|
@@ -229,13 +276,15 @@ var ClaudeAgentSdkAdapter = class _ClaudeAgentSdkAdapter {
|
|
|
229
276
|
async send(prompt, options) {
|
|
230
277
|
this.lastSessionId = null;
|
|
231
278
|
this.lastMemoryRef = null;
|
|
279
|
+
this.lastTokenUsage = null;
|
|
232
280
|
const split = options.splitPrompt;
|
|
233
281
|
const systemPrompt = split?.system;
|
|
234
282
|
const userPrompt = split ? split.user : prompt;
|
|
235
283
|
const opts = this.buildOptions(options.readonly, void 0, systemPrompt, options.agents, options.allowDynamicWorkflow);
|
|
236
284
|
await this.attachLibraryTools(opts, options.libraryTools);
|
|
237
|
-
const { text, sessionId } = await this.runQuery(userPrompt, opts, options.onProgress, options.observer, options.parentSpanId);
|
|
285
|
+
const { text, sessionId, tokenUsage } = await this.runQuery(userPrompt, opts, options.onProgress, options.observer, options.parentSpanId);
|
|
238
286
|
this.lastSessionId = sessionId;
|
|
287
|
+
this.lastTokenUsage = tokenUsage ?? null;
|
|
239
288
|
this.lastMemoryRef = {
|
|
240
289
|
id: sessionId,
|
|
241
290
|
provider: "claude-agent-sdk",
|
|
@@ -249,13 +298,23 @@ var ClaudeAgentSdkAdapter = class _ClaudeAgentSdkAdapter {
|
|
|
249
298
|
throw new Error("followUp() called before send() \u2014 no active session");
|
|
250
299
|
}
|
|
251
300
|
const opts = this.buildOptions(false, this.lastSessionId);
|
|
252
|
-
const { text, sessionId } = await this.runQuery(message, opts);
|
|
301
|
+
const { text, sessionId, tokenUsage } = await this.runQuery(message, opts);
|
|
253
302
|
this.lastSessionId = sessionId;
|
|
303
|
+
if (tokenUsage) {
|
|
304
|
+
this.lastTokenUsage = this.lastTokenUsage ? {
|
|
305
|
+
inputTokens: this.lastTokenUsage.inputTokens + tokenUsage.inputTokens,
|
|
306
|
+
outputTokens: this.lastTokenUsage.outputTokens + tokenUsage.outputTokens,
|
|
307
|
+
totalTokens: (this.lastTokenUsage.totalTokens ?? 0) + (tokenUsage.totalTokens ?? 0),
|
|
308
|
+
cacheReadTokens: (this.lastTokenUsage.cacheReadTokens ?? 0) + (tokenUsage.cacheReadTokens ?? 0) || void 0,
|
|
309
|
+
cacheCreationTokens: (this.lastTokenUsage.cacheCreationTokens ?? 0) + (tokenUsage.cacheCreationTokens ?? 0) || void 0
|
|
310
|
+
} : tokenUsage;
|
|
311
|
+
}
|
|
254
312
|
return text;
|
|
255
313
|
}
|
|
256
314
|
async sendExecution(request) {
|
|
257
315
|
this.lastSessionId = null;
|
|
258
316
|
this.lastMemoryRef = null;
|
|
317
|
+
this.lastTokenUsage = null;
|
|
259
318
|
const resume = request.memoryRef?.id;
|
|
260
319
|
const split = request.splitPrompt;
|
|
261
320
|
const systemPrompt = split?.system;
|
|
@@ -263,8 +322,9 @@ var ClaudeAgentSdkAdapter = class _ClaudeAgentSdkAdapter {
|
|
|
263
322
|
const agents = request.options.agents ?? request.agents;
|
|
264
323
|
const opts = this.buildOptions(request.options.readonly, resume, systemPrompt, agents, request.options.allowDynamicWorkflow);
|
|
265
324
|
await this.attachLibraryTools(opts, request.options.libraryTools);
|
|
266
|
-
const { text, sessionId } = await this.runQuery(userPrompt, opts, request.options.onProgress, request.options.observer, request.options.parentSpanId);
|
|
325
|
+
const { text, sessionId, tokenUsage } = await this.runQuery(userPrompt, opts, request.options.onProgress, request.options.observer, request.options.parentSpanId);
|
|
267
326
|
this.lastSessionId = sessionId;
|
|
327
|
+
this.lastTokenUsage = tokenUsage ?? null;
|
|
268
328
|
this.lastMemoryRef = {
|
|
269
329
|
id: sessionId,
|
|
270
330
|
provider: "claude-agent-sdk",
|
|
@@ -277,6 +337,9 @@ var ClaudeAgentSdkAdapter = class _ClaudeAgentSdkAdapter {
|
|
|
277
337
|
getLastMemoryRef() {
|
|
278
338
|
return this.lastMemoryRef;
|
|
279
339
|
}
|
|
340
|
+
getLastTokenUsage() {
|
|
341
|
+
return this.lastTokenUsage;
|
|
342
|
+
}
|
|
280
343
|
isCompatible(compat) {
|
|
281
344
|
return compat.startsWith("claude-agent-sdk@");
|
|
282
345
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/adapters/claude-agent-sdk.ts"],"sourcesContent":["/**\n * Claude Agent SDK Adapter — implements SdkAdapter for @anthropic-ai/claude-agent-sdk\n *\n * Uses the `query()` function from the Claude Agent SDK to run Claude as a\n * stateful coding agent with tool execution (Read, Edit, Bash, etc.).\n *\n * Supports:\n * - send() — start a new query session and return the result text\n * - followUp() — resume the same session for output-format corrections\n * - sendExecution() — rich path using full contract context\n *\n * The SDK returns an AsyncGenerator of SDKMessage events. The adapter iterates\n * the stream, extracts the final result text from the SDKResultSuccess message,\n * and captures the session_id for followUp via `resume`.\n *\n * GuardrailHooks are mapped to the SDK's PreToolUse hook system.\n */\n\nimport type {\n SdkAdapter,\n AdapterSendOptions,\n AgentExecutionRequest,\n AgentProgressEvent,\n CacheConfig,\n CandidateAgent,\n} from \"../lib/task-runner.js\";\nimport type { ObserverEmitFn } from \"../lib/observability-bridge.js\";\nimport {\n emitLlmTurnOpen,\n emitLlmTurnClose,\n emitToolExecOpen,\n emitToolExecClose,\n} from \"../lib/observability-bridge.js\";\nimport type { GuardrailHooks } from \"../lib/guardrail-hooks.js\";\nimport type { MemoryRef } from \"../lib/memory-store.js\";\nimport type { LibraryToolRegistry } from \"../lib/library-tool-binding.js\";\nimport { buildClaudeMcpServer } from \"../lib/library-tool-sdk.js\";\n\n/**\n * Subset of the Claude Agent SDK `AgentDefinition` shape we populate.\n * Verified against node_modules/@anthropic-ai/claude-agent-sdk/sdk.d.ts:38\n * (`description`, `prompt`, optional `tools`, `model`).\n */\ntype ClaudeAgentDefinition = {\n description: string;\n prompt: string;\n tools?: string[];\n model?: string;\n};\n\n// ---------------------------------------------------------------------------\n// Duck-typed SDK types (avoid hard compile-time dependency on zod v4)\n// ---------------------------------------------------------------------------\n\ntype SDKResultSuccess = {\n type: \"result\";\n subtype: \"success\";\n result: string;\n session_id: string;\n};\n\ntype SDKResultError = {\n type: \"result\";\n subtype: \"error\";\n error: string;\n session_id: string;\n};\n\ntype SDKContentBlock = {\n type: string;\n name?: string;\n text?: string;\n input?: unknown;\n};\n\ntype SDKBetaMessage = {\n content?: SDKContentBlock[];\n};\n\ntype SDKMessage = {\n type: string;\n subtype?: string;\n result?: string;\n error?: string;\n session_id?: string;\n tool_name?: string;\n summary?: string;\n message?: SDKBetaMessage;\n};\n\ntype HookCallbackInput = {\n hook_event_name: string;\n tool_name: string;\n tool_input: unknown;\n [key: string]: unknown;\n};\n\ntype HookCallbackOutput = {\n hookEventName: string;\n permissionDecision?: \"allow\" | \"deny\" | \"ask\";\n permissionDecisionReason?: string;\n additionalContext?: string;\n};\n\ntype HookCallbackMatcher = {\n tool_name?: string;\n hooks: Array<(input: HookCallbackInput) => HookCallbackOutput | Promise<HookCallbackOutput>>;\n};\n\ntype QueryOptions = Record<string, unknown>;\n\ntype QueryFn = (params: {\n prompt: string;\n options?: QueryOptions;\n}) => AsyncGenerator<SDKMessage, void>;\n\n// ---------------------------------------------------------------------------\n// Guardrail hook bridge\n// ---------------------------------------------------------------------------\n\nfunction buildClaudeHooks(\n guardrails: GuardrailHooks,\n): Partial<Record<string, HookCallbackMatcher[]>> {\n const preToolUseHook: HookCallbackMatcher = {\n hooks: [\n (input: HookCallbackInput): HookCallbackOutput => {\n const toolInput = input.tool_input as Record<string, unknown> | undefined;\n const toolName = input.tool_name;\n\n if (toolName === \"Bash\" || toolName === \"Shell\") {\n const command = (toolInput?.command ?? toolInput?.input) as string | undefined;\n if (command) {\n const result = guardrails.beforeShellExecution({ command });\n if (result.permission === \"deny\") {\n return {\n hookEventName: \"PreToolUse\",\n permissionDecision: \"deny\",\n permissionDecisionReason: result.user_message ?? result.agent_message,\n };\n }\n if (result.additionalContext) {\n return { hookEventName: \"PreToolUse\", additionalContext: result.additionalContext };\n }\n }\n }\n\n const filePath = (toolInput?.file_path ?? toolInput?.path) as string | undefined;\n if (filePath) {\n const pathResult = guardrails.preToolUse({\n tool_name: toolName,\n tool_input: { file_path: filePath },\n });\n if (pathResult.permission === \"deny\") {\n return {\n hookEventName: \"PreToolUse\",\n permissionDecision: \"deny\",\n permissionDecisionReason: pathResult.user_message ?? pathResult.agent_message,\n };\n }\n if (pathResult.additionalContext) {\n return { hookEventName: \"PreToolUse\", additionalContext: pathResult.additionalContext };\n }\n }\n\n return { hookEventName: \"PreToolUse\" };\n },\n ],\n };\n\n return { PreToolUse: [preToolUseHook] };\n}\n\n// ---------------------------------------------------------------------------\n// Input summary truncation\n// ---------------------------------------------------------------------------\n\nfunction truncateInputSummary(input: unknown, maxLen = 80): string {\n if (input == null) return \"\";\n let str: string;\n if (typeof input === \"string\") {\n str = input;\n } else {\n try { str = JSON.stringify(input); } catch { str = String(input); }\n }\n return str.length > maxLen ? str.slice(0, maxLen - 3) + \"...\" : str;\n}\n\n// ---------------------------------------------------------------------------\n// Config\n// ---------------------------------------------------------------------------\n\nexport interface ClaudeAgentSdkAdapterConfig {\n /** Working directory for the agent. Defaults to process.cwd(). */\n cwd?: string;\n /** Model identifier (e.g. \"claude-sonnet-4-20250514\"). Uses SDK default if omitted. */\n model?: string;\n /**\n * Available tools. Defaults to read-only or read-write set based on AdapterSendOptions.\n * Set to `{ type: 'preset', preset: 'claude_code' }` for all Claude Code tools.\n */\n tools?: string[] | { type: \"preset\"; preset: \"claude_code\" };\n /** Permission mode. Defaults to \"bypassPermissions\" for automated workflows. */\n permissionMode?: \"default\" | \"acceptEdits\" | \"bypassPermissions\" | \"plan\";\n /** Max turns before stopping. */\n maxTurns?: number;\n /** Runtime guardrail hooks enforced via PreToolUse SDK hooks. */\n guardrailHooks?: GuardrailHooks;\n /** Prompt caching configuration. Enabled by default. */\n cacheConfig?: CacheConfig;\n}\n\n// ---------------------------------------------------------------------------\n// Adapter\n// ---------------------------------------------------------------------------\n\nexport class ClaudeAgentSdkAdapter implements SdkAdapter {\n private cwd: string;\n private model: string | undefined;\n private tools: string[] | { type: \"preset\"; preset: \"claude_code\" } | undefined;\n private permissionMode: string;\n private maxTurns: number | undefined;\n private guardrailHooks: GuardrailHooks | undefined;\n private cacheConfig: CacheConfig;\n private lastSessionId: string | null = null;\n private lastMemoryRef: MemoryRef | null = null;\n private queryFn: QueryFn | null = null;\n\n constructor(config: ClaudeAgentSdkAdapterConfig = {}) {\n this.cwd = config.cwd ?? process.cwd();\n this.model = config.model;\n this.tools = config.tools;\n this.permissionMode = config.permissionMode ?? \"bypassPermissions\";\n this.maxTurns = config.maxTurns;\n this.guardrailHooks = config.guardrailHooks;\n this.cacheConfig = config.cacheConfig ?? { enabled: true };\n }\n\n // -------------------------------------------------------------------------\n // Internal helpers\n // -------------------------------------------------------------------------\n\n private async resolveQueryFn(): Promise<QueryFn> {\n if (this.queryFn) return this.queryFn;\n\n const sdk = (await import(\"@anthropic-ai/claude-agent-sdk\")) as {\n query: QueryFn;\n };\n this.queryFn = sdk.query;\n return this.queryFn;\n }\n\n private buildOptions(\n readonly: boolean,\n resume?: string,\n systemPrompt?: string[],\n agents?: CandidateAgent[],\n allowDynamicWorkflow?: boolean,\n ): QueryOptions {\n const opts: QueryOptions = {\n cwd: this.cwd,\n permissionMode: this.permissionMode,\n allowDangerouslySkipPermissions: this.permissionMode === \"bypassPermissions\",\n // SDK isolation: do not load ambient .claude/ settings, skills, or agents\n // from disk. The runtime injects everything in-code, so disk discovery\n // would break component isolation and reproducibility.\n settingSources: [],\n };\n\n if (this.model) opts.model = this.model;\n if (this.maxTurns) opts.maxTurns = this.maxTurns;\n\n let toolList: string[] | { type: \"preset\"; preset: \"claude_code\" };\n if (this.tools) {\n toolList = Array.isArray(this.tools) ? [...this.tools] : this.tools;\n } else {\n toolList = readonly\n ? [\"Read\", \"Glob\", \"Grep\", \"Bash\"]\n : [\"Read\", \"Glob\", \"Grep\", \"Edit\", \"Write\", \"Bash\"];\n }\n\n // When candidate sub-agents are registered (model B), the entry agent needs\n // the sub-agent delegation tool to invoke them. The restricted tool list\n // above omits it, so add it explicitly — otherwise the LLM has no way to\n // delegate. The SDK names this tool \"Task\"/\"Agent\" (docs use both; tool_use\n // events surface it as \"Agent\"), so allow both for robustness across\n // SDK versions. (A \"preset\" tools config already includes it.)\n if (agents && agents.length > 0 && Array.isArray(toolList)) {\n for (const t of [\"Task\", \"Agent\"]) {\n if (!toolList.includes(t)) toolList.push(t);\n }\n }\n\n if (allowDynamicWorkflow && Array.isArray(toolList)) {\n if (!toolList.includes(\"Workflow\")) toolList.push(\"Workflow\");\n }\n opts.tools = toolList;\n\n if (resume) opts.resume = resume;\n\n if (systemPrompt && this.cacheConfig.enabled !== false) {\n opts.systemPrompt = systemPrompt;\n }\n\n // Register candidate sub-agents so the LLM can delegate via the Agent/Task\n // tool (model B, LLM-internal routing). Keyed by candidate name.\n if (agents && agents.length > 0) {\n const record: Record<string, ClaudeAgentDefinition> = {};\n for (const a of agents) {\n record[a.name] = {\n description: a.description,\n prompt: a.prompt,\n ...(a.tools ? { tools: a.tools } : {}),\n ...(a.model ? { model: a.model } : {}),\n };\n }\n opts.agents = record;\n }\n\n if (this.guardrailHooks) {\n opts.hooks = buildClaudeHooks(this.guardrailHooks);\n }\n\n return opts;\n }\n\n private async attachLibraryTools(\n opts: QueryOptions,\n libraryTools?: LibraryToolRegistry,\n ): Promise<void> {\n if (!libraryTools || libraryTools.getAll().length === 0) return;\n\n try {\n const server = await buildClaudeMcpServer(libraryTools);\n if (server) {\n const existing = (opts.mcpServers ?? []) as unknown[];\n opts.mcpServers = [...existing, server];\n }\n } catch {\n // SDK functions unavailable; library tools silently skipped for Claude\n }\n }\n\n private async runQuery(\n prompt: string,\n options: QueryOptions,\n onProgress?: (event: AgentProgressEvent) => void,\n observer?: ObserverEmitFn,\n parentSpanId?: string,\n ): Promise<{ text: string; sessionId: string }> {\n const queryFn = await this.resolveQueryFn();\n const stream = queryFn({ prompt, options });\n\n let resultText = \"\";\n let sessionId = \"\";\n\n // Inner turn-level instrumentation state\n let turnNumber = 0;\n let currentTurnSpanId: string | undefined;\n let currentTurnStart = 0;\n let toolCallsInTurn = 0;\n const openToolSpans: Array<{ spanId: string; toolName: string; startMs: number }> = [];\n\n const closePendingToolSpans = (): void => {\n for (const ts of openToolSpans) {\n emitToolExecClose(observer, ts.spanId, ts.toolName, Date.now() - ts.startMs);\n }\n openToolSpans.length = 0;\n };\n\n const closeCurrentTurn = (): void => {\n if (currentTurnSpanId) {\n emitLlmTurnClose(observer, currentTurnSpanId, turnNumber, Date.now() - currentTurnStart, {\n toolCallsCount: toolCallsInTurn || undefined,\n });\n currentTurnSpanId = undefined;\n }\n };\n\n for await (const message of stream) {\n if (message.session_id) sessionId = message.session_id;\n\n if (message.type === \"result\") {\n closePendingToolSpans();\n closeCurrentTurn();\n if (message.subtype === \"success\") {\n resultText = (message as SDKResultSuccess).result;\n } else if (message.subtype === \"error\") {\n throw new Error(`Claude Agent SDK error: ${(message as SDKResultError).error}`);\n }\n } else if (message.type === \"assistant\") {\n closePendingToolSpans();\n closeCurrentTurn();\n\n turnNumber++;\n toolCallsInTurn = 0;\n currentTurnStart = Date.now();\n currentTurnSpanId = emitLlmTurnOpen(observer, parentSpanId, turnNumber, this.model);\n\n const content = message.message?.content;\n if (content) {\n for (const block of content) {\n if (block.type === \"tool_use\" && block.name) {\n toolCallsInTurn++;\n const summary = truncateInputSummary(block.input);\n const toolSpanId = emitToolExecOpen(observer, currentTurnSpanId, block.name, summary, turnNumber);\n if (toolSpanId) {\n openToolSpans.push({ spanId: toolSpanId, toolName: block.name, startMs: Date.now() });\n }\n }\n }\n }\n\n if (onProgress) {\n emitProgressFromSdkMessage(message, onProgress, sessionId);\n }\n } else {\n if (onProgress) {\n emitProgressFromSdkMessage(message, onProgress, sessionId);\n }\n }\n }\n\n closePendingToolSpans();\n closeCurrentTurn();\n\n return { text: resultText, sessionId };\n }\n\n // -------------------------------------------------------------------------\n // SdkAdapter interface\n // -------------------------------------------------------------------------\n\n async send(\n prompt: string,\n options: AdapterSendOptions,\n ): Promise<string> {\n this.lastSessionId = null;\n this.lastMemoryRef = null;\n\n const split = options.splitPrompt;\n const systemPrompt = split?.system;\n const userPrompt = split ? split.user : prompt;\n const opts = this.buildOptions(options.readonly, undefined, systemPrompt, options.agents, options.allowDynamicWorkflow);\n await this.attachLibraryTools(opts, options.libraryTools);\n const { text, sessionId } = await this.runQuery(userPrompt, opts, options.onProgress, options.observer, options.parentSpanId);\n\n this.lastSessionId = sessionId;\n this.lastMemoryRef = {\n id: sessionId,\n provider: \"claude-agent-sdk\",\n compat: \"claude-agent-sdk@0.2\",\n created_at: new Date().toISOString(),\n };\n return text;\n }\n\n async followUp(message: string): Promise<string> {\n if (!this.lastSessionId) {\n throw new Error(\"followUp() called before send() — no active session\");\n }\n const opts = this.buildOptions(false, this.lastSessionId);\n const { text, sessionId } = await this.runQuery(message, opts);\n this.lastSessionId = sessionId;\n return text;\n }\n\n async sendExecution(request: AgentExecutionRequest): Promise<string> {\n this.lastSessionId = null;\n this.lastMemoryRef = null;\n\n const resume = request.memoryRef?.id;\n const split = request.splitPrompt;\n const systemPrompt = split?.system;\n const userPrompt = split ? split.user : request.prompt;\n const agents = request.options.agents ?? request.agents;\n const opts = this.buildOptions(request.options.readonly, resume, systemPrompt, agents, request.options.allowDynamicWorkflow);\n await this.attachLibraryTools(opts, request.options.libraryTools);\n const { text, sessionId } = await this.runQuery(userPrompt, opts, request.options.onProgress, request.options.observer, request.options.parentSpanId);\n\n this.lastSessionId = sessionId;\n this.lastMemoryRef = {\n id: sessionId,\n provider: \"claude-agent-sdk\",\n compat: \"claude-agent-sdk@0.2\",\n created_at: new Date().toISOString(),\n parent_run_id: request.memoryRef?.id,\n };\n return text;\n }\n\n getLastMemoryRef(): MemoryRef | null {\n return this.lastMemoryRef;\n }\n\n isCompatible(compat: string): boolean {\n return compat.startsWith(\"claude-agent-sdk@\");\n }\n\n // -------------------------------------------------------------------------\n // Test support\n // -------------------------------------------------------------------------\n\n /**\n * Inject a custom query function for testing.\n * Bypasses the dynamic import of @anthropic-ai/claude-agent-sdk.\n */\n static withQueryFn(\n queryFn: QueryFn,\n config?: ClaudeAgentSdkAdapterConfig,\n ): ClaudeAgentSdkAdapter {\n const adapter = new ClaudeAgentSdkAdapter(config);\n adapter.queryFn = queryFn;\n return adapter;\n }\n}\n\n// ---------------------------------------------------------------------------\n// Progress event mapping\n// ---------------------------------------------------------------------------\n\nfunction emitProgressFromSdkMessage(\n message: SDKMessage,\n onProgress: (event: AgentProgressEvent) => void,\n sessionId?: string,\n): void {\n const sid = message.session_id ?? sessionId;\n switch (message.type) {\n case \"assistant\": {\n const content = message.message?.content;\n if (!content) break;\n for (const block of content) {\n if (block.type === \"tool_use\" && block.name) {\n const input = block.input && typeof block.input === \"object\"\n ? block.input as Record<string, unknown>\n : undefined;\n onProgress({ type: \"tool_use\", tool_name: block.name, input, session_id: sid });\n } else if (block.type === \"text\" && block.text) {\n onProgress({ type: \"text\", message: block.text, session_id: sid });\n }\n }\n break;\n }\n case \"tool_progress\":\n if (message.tool_name) {\n onProgress({ type: \"tool_use\", tool_name: message.tool_name, session_id: sid });\n }\n break;\n case \"tool_use_summary\":\n if (message.summary) {\n onProgress({ type: \"status\", message: message.summary, session_id: sid });\n }\n break;\n default:\n break;\n }\n}\n"],"mappings":"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","names":[]}
|
|
1
|
+
{"version":3,"sources":["../../src/adapters/claude-agent-sdk.ts"],"sourcesContent":["/**\n * Claude Agent SDK Adapter — implements SdkAdapter for @anthropic-ai/claude-agent-sdk\n *\n * Uses the `query()` function from the Claude Agent SDK to run Claude as a\n * stateful coding agent with tool execution (Read, Edit, Bash, etc.).\n *\n * Supports:\n * - send() — start a new query session and return the result text\n * - followUp() — resume the same session for output-format corrections\n * - sendExecution() — rich path using full contract context\n *\n * The SDK returns an AsyncGenerator of SDKMessage events. The adapter iterates\n * the stream, extracts the final result text from the SDKResultSuccess message,\n * and captures the session_id for followUp via `resume`.\n *\n * GuardrailHooks are mapped to the SDK's PreToolUse hook system.\n */\n\nimport type {\n SdkAdapter,\n AdapterSendOptions,\n AgentExecutionRequest,\n AgentProgressEvent,\n CacheConfig,\n CandidateAgent,\n} from \"../lib/task-runner.js\";\nimport type { ObserverEmitFn, TokenUsage } from \"../lib/observability-bridge.js\";\nimport {\n emitLlmTurnOpen,\n emitLlmTurnClose,\n emitToolExecOpen,\n emitToolExecClose,\n} from \"../lib/observability-bridge.js\";\nimport type { GuardrailHooks } from \"../lib/guardrail-hooks.js\";\nimport type { MemoryRef } from \"../lib/memory-store.js\";\nimport type { LibraryToolRegistry } from \"../lib/library-tool-binding.js\";\nimport { buildClaudeMcpServer } from \"../lib/library-tool-sdk.js\";\n\n/**\n * Subset of the Claude Agent SDK `AgentDefinition` shape we populate.\n * Verified against node_modules/@anthropic-ai/claude-agent-sdk/sdk.d.ts:38\n * (`description`, `prompt`, optional `tools`, `model`).\n */\ntype ClaudeAgentDefinition = {\n description: string;\n prompt: string;\n tools?: string[];\n model?: string;\n};\n\n// ---------------------------------------------------------------------------\n// Duck-typed SDK types (avoid hard compile-time dependency on zod v4)\n// ---------------------------------------------------------------------------\n\ntype SDKResultSuccess = {\n type: \"result\";\n subtype: \"success\";\n result: string;\n session_id: string;\n};\n\ntype SDKResultError = {\n type: \"result\";\n subtype: \"error\";\n error: string;\n session_id: string;\n};\n\ntype SDKContentBlock = {\n type: string;\n name?: string;\n text?: string;\n input?: unknown;\n};\n\ntype SDKBetaMessage = {\n content?: SDKContentBlock[];\n};\n\ntype SDKMessage = {\n type: string;\n subtype?: string;\n result?: string;\n error?: string;\n session_id?: string;\n tool_name?: string;\n summary?: string;\n message?: SDKBetaMessage;\n usage?: {\n input_tokens?: number;\n output_tokens?: number;\n cache_read_input_tokens?: number;\n cache_creation_input_tokens?: number;\n };\n};\n\ntype HookCallbackInput = {\n hook_event_name: string;\n tool_name: string;\n tool_input: unknown;\n [key: string]: unknown;\n};\n\ntype HookCallbackOutput = {\n hookEventName: string;\n permissionDecision?: \"allow\" | \"deny\" | \"ask\";\n permissionDecisionReason?: string;\n additionalContext?: string;\n};\n\ntype HookCallbackMatcher = {\n tool_name?: string;\n hooks: Array<(input: HookCallbackInput) => HookCallbackOutput | Promise<HookCallbackOutput>>;\n};\n\ntype QueryOptions = Record<string, unknown>;\n\ntype QueryFn = (params: {\n prompt: string;\n options?: QueryOptions;\n}) => AsyncGenerator<SDKMessage, void>;\n\n// ---------------------------------------------------------------------------\n// Guardrail hook bridge\n// ---------------------------------------------------------------------------\n\nfunction buildClaudeHooks(\n guardrails: GuardrailHooks,\n): Partial<Record<string, HookCallbackMatcher[]>> {\n const preToolUseHook: HookCallbackMatcher = {\n hooks: [\n (input: HookCallbackInput): HookCallbackOutput => {\n const toolInput = input.tool_input as Record<string, unknown> | undefined;\n const toolName = input.tool_name;\n\n if (toolName === \"Bash\" || toolName === \"Shell\") {\n const command = (toolInput?.command ?? toolInput?.input) as string | undefined;\n if (command) {\n const result = guardrails.beforeShellExecution({ command });\n if (result.permission === \"deny\") {\n return {\n hookEventName: \"PreToolUse\",\n permissionDecision: \"deny\",\n permissionDecisionReason: result.user_message ?? result.agent_message,\n };\n }\n if (result.additionalContext) {\n return { hookEventName: \"PreToolUse\", additionalContext: result.additionalContext };\n }\n }\n }\n\n const filePath = (toolInput?.file_path ?? toolInput?.path) as string | undefined;\n if (filePath) {\n const pathResult = guardrails.preToolUse({\n tool_name: toolName,\n tool_input: { file_path: filePath },\n });\n if (pathResult.permission === \"deny\") {\n return {\n hookEventName: \"PreToolUse\",\n permissionDecision: \"deny\",\n permissionDecisionReason: pathResult.user_message ?? pathResult.agent_message,\n };\n }\n if (pathResult.additionalContext) {\n return { hookEventName: \"PreToolUse\", additionalContext: pathResult.additionalContext };\n }\n }\n\n return { hookEventName: \"PreToolUse\" };\n },\n ],\n };\n\n return { PreToolUse: [preToolUseHook] };\n}\n\n// ---------------------------------------------------------------------------\n// Input summary truncation\n// ---------------------------------------------------------------------------\n\nfunction truncateInputSummary(input: unknown, maxLen = 80): string {\n if (input == null) return \"\";\n let str: string;\n if (typeof input === \"string\") {\n str = input;\n } else {\n try { str = JSON.stringify(input); } catch { str = String(input); }\n }\n return str.length > maxLen ? str.slice(0, maxLen - 3) + \"...\" : str;\n}\n\n// ---------------------------------------------------------------------------\n// Config\n// ---------------------------------------------------------------------------\n\nexport interface ClaudeAgentSdkAdapterConfig {\n /** Working directory for the agent. Defaults to process.cwd(). */\n cwd?: string;\n /** Model identifier (e.g. \"claude-sonnet-4-20250514\"). Uses SDK default if omitted. */\n model?: string;\n /**\n * Available tools. Defaults to read-only or read-write set based on AdapterSendOptions.\n * Set to `{ type: 'preset', preset: 'claude_code' }` for all Claude Code tools.\n */\n tools?: string[] | { type: \"preset\"; preset: \"claude_code\" };\n /** Permission mode. Defaults to \"bypassPermissions\" for automated workflows. */\n permissionMode?: \"default\" | \"acceptEdits\" | \"bypassPermissions\" | \"plan\";\n /** Max turns before stopping. */\n maxTurns?: number;\n /** Runtime guardrail hooks enforced via PreToolUse SDK hooks. */\n guardrailHooks?: GuardrailHooks;\n /** Prompt caching configuration. Enabled by default. */\n cacheConfig?: CacheConfig;\n}\n\n// ---------------------------------------------------------------------------\n// Adapter\n// ---------------------------------------------------------------------------\n\nexport class ClaudeAgentSdkAdapter implements SdkAdapter {\n private cwd: string;\n private model: string | undefined;\n private tools: string[] | { type: \"preset\"; preset: \"claude_code\" } | undefined;\n private permissionMode: string;\n private maxTurns: number | undefined;\n private guardrailHooks: GuardrailHooks | undefined;\n private cacheConfig: CacheConfig;\n private lastSessionId: string | null = null;\n private lastMemoryRef: MemoryRef | null = null;\n private lastTokenUsage: TokenUsage | null = null;\n private queryFn: QueryFn | null = null;\n\n constructor(config: ClaudeAgentSdkAdapterConfig = {}) {\n this.cwd = config.cwd ?? process.cwd();\n this.model = config.model;\n this.tools = config.tools;\n this.permissionMode = config.permissionMode ?? \"bypassPermissions\";\n this.maxTurns = config.maxTurns;\n this.guardrailHooks = config.guardrailHooks;\n this.cacheConfig = config.cacheConfig ?? { enabled: true };\n }\n\n // -------------------------------------------------------------------------\n // Internal helpers\n // -------------------------------------------------------------------------\n\n private async resolveQueryFn(): Promise<QueryFn> {\n if (this.queryFn) return this.queryFn;\n\n const sdk = (await import(\"@anthropic-ai/claude-agent-sdk\")) as {\n query: QueryFn;\n };\n this.queryFn = sdk.query;\n return this.queryFn;\n }\n\n private buildOptions(\n readonly: boolean,\n resume?: string,\n systemPrompt?: string[],\n agents?: CandidateAgent[],\n allowDynamicWorkflow?: boolean,\n ): QueryOptions {\n const opts: QueryOptions = {\n cwd: this.cwd,\n permissionMode: this.permissionMode,\n allowDangerouslySkipPermissions: this.permissionMode === \"bypassPermissions\",\n // SDK isolation: do not load ambient .claude/ settings, skills, or agents\n // from disk. The runtime injects everything in-code, so disk discovery\n // would break component isolation and reproducibility.\n settingSources: [],\n };\n\n if (this.model) opts.model = this.model;\n if (this.maxTurns) opts.maxTurns = this.maxTurns;\n\n let toolList: string[] | { type: \"preset\"; preset: \"claude_code\" };\n if (this.tools) {\n toolList = Array.isArray(this.tools) ? [...this.tools] : this.tools;\n } else {\n toolList = readonly\n ? [\"Read\", \"Glob\", \"Grep\", \"Bash\"]\n : [\"Read\", \"Glob\", \"Grep\", \"Edit\", \"Write\", \"Bash\"];\n }\n\n // When candidate sub-agents are registered (model B), the entry agent needs\n // the sub-agent delegation tool to invoke them. The restricted tool list\n // above omits it, so add it explicitly — otherwise the LLM has no way to\n // delegate. The SDK names this tool \"Task\"/\"Agent\" (docs use both; tool_use\n // events surface it as \"Agent\"), so allow both for robustness across\n // SDK versions. (A \"preset\" tools config already includes it.)\n if (agents && agents.length > 0 && Array.isArray(toolList)) {\n for (const t of [\"Task\", \"Agent\"]) {\n if (!toolList.includes(t)) toolList.push(t);\n }\n }\n\n if (allowDynamicWorkflow && Array.isArray(toolList)) {\n if (!toolList.includes(\"Workflow\")) toolList.push(\"Workflow\");\n }\n opts.tools = toolList;\n\n if (resume) opts.resume = resume;\n\n if (systemPrompt && this.cacheConfig.enabled !== false) {\n opts.systemPrompt = systemPrompt;\n }\n\n // Register candidate sub-agents so the LLM can delegate via the Agent/Task\n // tool (model B, LLM-internal routing). Keyed by candidate name.\n if (agents && agents.length > 0) {\n const record: Record<string, ClaudeAgentDefinition> = {};\n for (const a of agents) {\n record[a.name] = {\n description: a.description,\n prompt: a.prompt,\n ...(a.tools ? { tools: a.tools } : {}),\n ...(a.model ? { model: a.model } : {}),\n };\n }\n opts.agents = record;\n }\n\n if (this.guardrailHooks) {\n opts.hooks = buildClaudeHooks(this.guardrailHooks);\n }\n\n return opts;\n }\n\n private async attachLibraryTools(\n opts: QueryOptions,\n libraryTools?: LibraryToolRegistry,\n ): Promise<void> {\n if (!libraryTools || libraryTools.getAll().length === 0) return;\n\n try {\n const server = await buildClaudeMcpServer(libraryTools);\n if (server) {\n const existing = (opts.mcpServers ?? []) as unknown[];\n opts.mcpServers = [...existing, server];\n }\n } catch {\n // SDK functions unavailable; library tools silently skipped for Claude\n }\n }\n\n private async runQuery(\n prompt: string,\n options: QueryOptions,\n onProgress?: (event: AgentProgressEvent) => void,\n observer?: ObserverEmitFn,\n parentSpanId?: string,\n ): Promise<{ text: string; sessionId: string; tokenUsage?: TokenUsage }> {\n const queryFn = await this.resolveQueryFn();\n const stream = queryFn({ prompt, options });\n\n let resultText = \"\";\n let sessionId = \"\";\n\n // Token usage accumulation across all messages in this query\n let totalInputTokens = 0;\n let totalOutputTokens = 0;\n let totalCacheReadTokens = 0;\n let totalCacheCreationTokens = 0;\n let hasUsageData = false;\n\n // Inner turn-level instrumentation state\n let turnNumber = 0;\n let currentTurnSpanId: string | undefined;\n let currentTurnStart = 0;\n let toolCallsInTurn = 0;\n let turnInputTokens = 0;\n let turnOutputTokens = 0;\n let turnCacheHitTokens = 0;\n const openToolSpans: Array<{ spanId: string; toolName: string; startMs: number }> = [];\n\n const closePendingToolSpans = (): void => {\n for (const ts of openToolSpans) {\n emitToolExecClose(observer, ts.spanId, ts.toolName, Date.now() - ts.startMs);\n }\n openToolSpans.length = 0;\n };\n\n const closeCurrentTurn = (): void => {\n if (currentTurnSpanId) {\n emitLlmTurnClose(observer, currentTurnSpanId, turnNumber, Date.now() - currentTurnStart, {\n inputTokens: turnInputTokens || undefined,\n outputTokens: turnOutputTokens || undefined,\n cacheHitTokens: turnCacheHitTokens || undefined,\n toolCallsCount: toolCallsInTurn || undefined,\n });\n currentTurnSpanId = undefined;\n }\n };\n\n const captureUsage = (usage: SDKMessage[\"usage\"], perTurn = true): void => {\n if (!usage) return;\n if (typeof usage.input_tokens === \"number\") {\n totalInputTokens += usage.input_tokens;\n if (perTurn) turnInputTokens += usage.input_tokens;\n hasUsageData = true;\n }\n if (typeof usage.output_tokens === \"number\") {\n totalOutputTokens += usage.output_tokens;\n if (perTurn) turnOutputTokens += usage.output_tokens;\n hasUsageData = true;\n }\n if (typeof usage.cache_read_input_tokens === \"number\") {\n totalCacheReadTokens += usage.cache_read_input_tokens;\n if (perTurn) turnCacheHitTokens += usage.cache_read_input_tokens;\n hasUsageData = true;\n }\n if (typeof usage.cache_creation_input_tokens === \"number\") {\n totalCacheCreationTokens += usage.cache_creation_input_tokens;\n hasUsageData = true;\n }\n };\n\n for await (const message of stream) {\n if (message.session_id) sessionId = message.session_id;\n\n if (message.type === \"result\") {\n captureUsage(message.usage, false);\n closePendingToolSpans();\n closeCurrentTurn();\n if (message.subtype === \"success\") {\n resultText = (message as SDKResultSuccess).result;\n } else if (message.subtype === \"error\") {\n throw new Error(`Claude Agent SDK error: ${(message as SDKResultError).error}`);\n }\n } else if (message.type === \"assistant\") {\n closePendingToolSpans();\n closeCurrentTurn();\n\n turnNumber++;\n toolCallsInTurn = 0;\n turnInputTokens = 0;\n turnOutputTokens = 0;\n turnCacheHitTokens = 0;\n currentTurnStart = Date.now();\n currentTurnSpanId = emitLlmTurnOpen(observer, parentSpanId, turnNumber, this.model);\n\n captureUsage(message.usage);\n\n const content = message.message?.content;\n if (content) {\n for (const block of content) {\n if (block.type === \"tool_use\" && block.name) {\n toolCallsInTurn++;\n const summary = truncateInputSummary(block.input);\n const toolSpanId = emitToolExecOpen(observer, currentTurnSpanId, block.name, summary, turnNumber);\n if (toolSpanId) {\n openToolSpans.push({ spanId: toolSpanId, toolName: block.name, startMs: Date.now() });\n }\n }\n }\n }\n\n if (onProgress) {\n emitProgressFromSdkMessage(message, onProgress, sessionId);\n }\n } else {\n captureUsage(message.usage);\n if (onProgress) {\n emitProgressFromSdkMessage(message, onProgress, sessionId);\n }\n }\n }\n\n closePendingToolSpans();\n closeCurrentTurn();\n\n const tokenUsage: TokenUsage | undefined = hasUsageData\n ? {\n inputTokens: totalInputTokens,\n outputTokens: totalOutputTokens,\n totalTokens: totalInputTokens + totalOutputTokens,\n ...(totalCacheReadTokens > 0 ? { cacheReadTokens: totalCacheReadTokens } : {}),\n ...(totalCacheCreationTokens > 0 ? { cacheCreationTokens: totalCacheCreationTokens } : {}),\n }\n : undefined;\n\n return { text: resultText, sessionId, tokenUsage };\n }\n\n // -------------------------------------------------------------------------\n // SdkAdapter interface\n // -------------------------------------------------------------------------\n\n async send(\n prompt: string,\n options: AdapterSendOptions,\n ): Promise<string> {\n this.lastSessionId = null;\n this.lastMemoryRef = null;\n this.lastTokenUsage = null;\n\n const split = options.splitPrompt;\n const systemPrompt = split?.system;\n const userPrompt = split ? split.user : prompt;\n const opts = this.buildOptions(options.readonly, undefined, systemPrompt, options.agents, options.allowDynamicWorkflow);\n await this.attachLibraryTools(opts, options.libraryTools);\n const { text, sessionId, tokenUsage } = await this.runQuery(userPrompt, opts, options.onProgress, options.observer, options.parentSpanId);\n\n this.lastSessionId = sessionId;\n this.lastTokenUsage = tokenUsage ?? null;\n this.lastMemoryRef = {\n id: sessionId,\n provider: \"claude-agent-sdk\",\n compat: \"claude-agent-sdk@0.2\",\n created_at: new Date().toISOString(),\n };\n return text;\n }\n\n async followUp(message: string): Promise<string> {\n if (!this.lastSessionId) {\n throw new Error(\"followUp() called before send() — no active session\");\n }\n const opts = this.buildOptions(false, this.lastSessionId);\n const { text, sessionId, tokenUsage } = await this.runQuery(message, opts);\n this.lastSessionId = sessionId;\n if (tokenUsage) {\n this.lastTokenUsage = this.lastTokenUsage\n ? {\n inputTokens: this.lastTokenUsage.inputTokens + tokenUsage.inputTokens,\n outputTokens: this.lastTokenUsage.outputTokens + tokenUsage.outputTokens,\n totalTokens: (this.lastTokenUsage.totalTokens ?? 0) + (tokenUsage.totalTokens ?? 0),\n cacheReadTokens: (this.lastTokenUsage.cacheReadTokens ?? 0) + (tokenUsage.cacheReadTokens ?? 0) || undefined,\n cacheCreationTokens: (this.lastTokenUsage.cacheCreationTokens ?? 0) + (tokenUsage.cacheCreationTokens ?? 0) || undefined,\n }\n : tokenUsage;\n }\n return text;\n }\n\n async sendExecution(request: AgentExecutionRequest): Promise<string> {\n this.lastSessionId = null;\n this.lastMemoryRef = null;\n this.lastTokenUsage = null;\n\n const resume = request.memoryRef?.id;\n const split = request.splitPrompt;\n const systemPrompt = split?.system;\n const userPrompt = split ? split.user : request.prompt;\n const agents = request.options.agents ?? request.agents;\n const opts = this.buildOptions(request.options.readonly, resume, systemPrompt, agents, request.options.allowDynamicWorkflow);\n await this.attachLibraryTools(opts, request.options.libraryTools);\n const { text, sessionId, tokenUsage } = await this.runQuery(userPrompt, opts, request.options.onProgress, request.options.observer, request.options.parentSpanId);\n\n this.lastSessionId = sessionId;\n this.lastTokenUsage = tokenUsage ?? null;\n this.lastMemoryRef = {\n id: sessionId,\n provider: \"claude-agent-sdk\",\n compat: \"claude-agent-sdk@0.2\",\n created_at: new Date().toISOString(),\n parent_run_id: request.memoryRef?.id,\n };\n return text;\n }\n\n getLastMemoryRef(): MemoryRef | null {\n return this.lastMemoryRef;\n }\n\n getLastTokenUsage(): TokenUsage | null {\n return this.lastTokenUsage;\n }\n\n isCompatible(compat: string): boolean {\n return compat.startsWith(\"claude-agent-sdk@\");\n }\n\n // -------------------------------------------------------------------------\n // Test support\n // -------------------------------------------------------------------------\n\n /**\n * Inject a custom query function for testing.\n * Bypasses the dynamic import of @anthropic-ai/claude-agent-sdk.\n */\n static withQueryFn(\n queryFn: QueryFn,\n config?: ClaudeAgentSdkAdapterConfig,\n ): ClaudeAgentSdkAdapter {\n const adapter = new ClaudeAgentSdkAdapter(config);\n adapter.queryFn = queryFn;\n return adapter;\n }\n}\n\n// ---------------------------------------------------------------------------\n// Progress event mapping\n// ---------------------------------------------------------------------------\n\nfunction emitProgressFromSdkMessage(\n message: SDKMessage,\n onProgress: (event: AgentProgressEvent) => void,\n sessionId?: string,\n): void {\n const sid = message.session_id ?? sessionId;\n switch (message.type) {\n case \"assistant\": {\n const content = message.message?.content;\n if (!content) break;\n for (const block of content) {\n if (block.type === \"tool_use\" && block.name) {\n const input = block.input && typeof block.input === \"object\"\n ? block.input as Record<string, unknown>\n : undefined;\n onProgress({ type: \"tool_use\", tool_name: block.name, input, session_id: sid });\n } else if (block.type === \"text\" && block.text) {\n onProgress({ type: \"text\", message: block.text, session_id: sid });\n }\n }\n break;\n }\n case \"tool_progress\":\n if (message.tool_name) {\n onProgress({ type: \"tool_use\", tool_name: message.tool_name, session_id: sid });\n }\n break;\n case \"tool_use_summary\":\n if (message.summary) {\n onProgress({ type: \"status\", message: message.summary, session_id: sid });\n }\n break;\n default:\n break;\n }\n}\n"],"mappings":"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","names":[]}
|
package/dist/adapters/mock.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { S as SdkAdapter, A as AdapterSendOptions, M as MemoryRef } from '../task-runner-
|
|
1
|
+
import { S as SdkAdapter, A as AdapterSendOptions, M as MemoryRef } from '../task-runner-Bl3SZfft.js';
|
|
2
2
|
import 'zod';
|
|
3
3
|
import '../context-DKkamYX_.js';
|
|
4
4
|
import '@aaac/observability';
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { S as SdkAdapter, G as GuardrailHooks, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef } from '../task-runner-
|
|
1
|
+
import { S as SdkAdapter, G as GuardrailHooks, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef } from '../task-runner-Bl3SZfft.js';
|
|
2
2
|
import 'zod';
|
|
3
3
|
import '../context-DKkamYX_.js';
|
|
4
4
|
import '@aaac/observability';
|
|
@@ -176,7 +176,7 @@ function emitIterationMetric(observer, parentSpanId, evaluateTaskId, totalIterat
|
|
|
176
176
|
})
|
|
177
177
|
});
|
|
178
178
|
}
|
|
179
|
-
function emitLlmTurnOpen(observer, parentSpanId, turnNumber, model) {
|
|
179
|
+
function emitLlmTurnOpen(observer, parentSpanId, turnNumber, model, llmParams) {
|
|
180
180
|
if (!observer) return void 0;
|
|
181
181
|
const spanId = generateId();
|
|
182
182
|
observer({
|
|
@@ -188,7 +188,9 @@ function emitLlmTurnOpen(observer, parentSpanId, turnNumber, model) {
|
|
|
188
188
|
attributes: attrs({
|
|
189
189
|
axis: "agent",
|
|
190
190
|
"llm.turn_number": turnNumber,
|
|
191
|
-
"llm.model": model
|
|
191
|
+
"llm.model": model,
|
|
192
|
+
"llm.temperature": llmParams?.temperature,
|
|
193
|
+
"llm.reasoning_effort": llmParams?.reasoningEffort
|
|
192
194
|
})
|
|
193
195
|
});
|
|
194
196
|
return spanId;
|
|
@@ -296,4 +298,4 @@ export {
|
|
|
296
298
|
emitToolchainOpen,
|
|
297
299
|
emitToolchainClose
|
|
298
300
|
};
|
|
299
|
-
//# sourceMappingURL=chunk-
|
|
301
|
+
//# sourceMappingURL=chunk-3HT5BILT.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/lib/observability-bridge.ts"],"sourcesContent":["/**\n * observability-bridge.ts\n *\n * Bridge between @aaac/runtime execution and @aaac/observability agent-axis spans.\n *\n * Responsibilities:\n * - Generate ExecutionEnvelope (run_id = UUIDv7) for every task/workflow execution\n * - Emit agent.session (open/close) for runWorkflow() — root run span\n * - Emit agent.subagent (open/close) for runTask() — handoff/task span\n * - Emit toolchain.execution (open/close) for toolchain tool invocations\n * - Observer is OPTIONAL — all emit* functions are no-ops when observer is undefined\n *\n * No circular dependency: @aaac/observability does NOT import @aaac/runtime.\n * Types (ExecutionEnvelope, EmitInput) are consumed from @aaac/observability.\n *\n * event-catalog.md §1.5, §2.2 / OBSERVABILITY_TASKS.md Phase 1 / architecture.md §6, §7\n */\n\nimport { generateId } from \"@aaac/observability\";\nimport type { ExecutionEnvelope, EmitInput, AttrValue } from \"@aaac/observability\";\n\n// ── Re-exports ────────────────────────────────────────────────────────────────\n\nexport type { ExecutionEnvelope } from \"@aaac/observability\";\n\n// ── TokenUsage ────────────────────────────────────────────────────────────────\n\n/** Token usage metrics returned by LLM adapters after a query/session. */\nexport interface TokenUsage {\n inputTokens: number;\n outputTokens: number;\n totalTokens?: number;\n cacheReadTokens?: number;\n cacheCreationTokens?: number;\n}\n\n// ── ObserverEmitFn ────────────────────────────────────────────────────────────\n\n/**\n * Minimal observer emit signature — structurally matches EventCollector.emit().\n * Pass `collector.emit.bind(collector)` to wire up the full observability pipeline.\n * When undefined, all emission is a no-op.\n */\nexport type ObserverEmitFn = (event: EmitInput) => void;\n\n// ── Envelope creation ─────────────────────────────────────────────────────────\n\nexport interface EnvelopeParams {\n /** run_id of the parent execution (populated by workflow-runner for task spans). */\n parentRunId?: string;\n /** Component / agent identifier from the agent-contracts definition. */\n componentId?: string;\n /** Agent that issued this execution (handoff source). */\n fromAgent?: string;\n /** Agent that receives this execution (handoff target). */\n toAgent?: string;\n /** agent-contracts schema version. */\n contractVersion?: string;\n /** LLM adapter identifier (e.g. 'claude-agent-sdk'). */\n adapter?: string;\n /** LLM model identifier (e.g. 'claude-opus-4-5'). */\n model?: string;\n /** Task instance identifier within the run. */\n taskInstanceId?: string;\n}\n\n/**\n * Create an ExecutionEnvelope with a fresh UUIDv7 run_id and current timestamp.\n * Only defined fields are included — undefined values are omitted.\n */\nexport function createExecutionEnvelope(params: EnvelopeParams = {}): ExecutionEnvelope {\n const envelope: ExecutionEnvelope = {\n run_id: generateId(),\n timestamp: new Date().toISOString(),\n };\n if (params.parentRunId !== undefined) envelope.parent_run_id = params.parentRunId;\n if (params.componentId !== undefined) envelope.component_id = params.componentId;\n if (params.fromAgent !== undefined) envelope.from_agent = params.fromAgent;\n if (params.toAgent !== undefined) envelope.to_agent = params.toAgent;\n if (params.contractVersion !== undefined) envelope.contract_version = params.contractVersion;\n if (params.adapter !== undefined) envelope.adapter = params.adapter;\n if (params.model !== undefined) envelope.model = params.model;\n if (params.taskInstanceId !== undefined) envelope.task_instance_id = params.taskInstanceId;\n return envelope;\n}\n\n// ── attribute builder helpers ─────────────────────────────────────────────────\n\n/** Build attribute record; omits keys with undefined/empty-string values. */\nfunction attrs(base: Record<string, AttrValue | undefined>): Record<string, AttrValue> {\n const out: Record<string, AttrValue> = {};\n for (const [k, v] of Object.entries(base)) {\n if (v !== undefined && v !== \"\") out[k] = v;\n }\n return out;\n}\n\n/** Extract numeric token_usage fields into flat attributes. */\nfunction tokenAttrs(meta: Record<string, unknown>): Record<string, AttrValue> {\n const out: Record<string, AttrValue> = {};\n const tu = meta.token_usage;\n if (tu && typeof tu === \"object\") {\n const t = tu as Record<string, unknown>;\n if (typeof t.input_tokens === \"number\") out[\"token_usage.input\"] = t.input_tokens;\n if (typeof t.output_tokens === \"number\") out[\"token_usage.output\"] = t.output_tokens;\n if (typeof t.total_tokens === \"number\") out[\"token_usage.total\"] = t.total_tokens;\n if (typeof t.cache_read_input_tokens === \"number\") out[\"token_usage.cache_read\"] = t.cache_read_input_tokens;\n if (typeof t.cache_creation_input_tokens === \"number\") out[\"token_usage.cache_creation\"] = t.cache_creation_input_tokens;\n }\n if (typeof meta.cost_usd === \"number\") out[\"cost_usd\"] = meta.cost_usd;\n return out;\n}\n\n// ── agent.session ─────────────────────────────────────────────────────────────\n\n/**\n * Emit an agent.session open span (root workflow/session execution).\n *\n * Uses envelope.run_id as the spanId so that child agent.subagent spans can\n * reference it as parentSpanId for hierarchical correlation.\n *\n * Returns the spanId emitted (= envelope.run_id).\n * Returns undefined when observer is undefined (no-op).\n *\n * event-catalog.md §2.2 — required: agent.session_id; axis: agent\n */\nexport function emitSessionOpen(\n observer: ObserverEmitFn | undefined,\n envelope: ExecutionEnvelope,\n workflowId: string,\n): string | undefined {\n if (!observer) return undefined;\n\n const spanId = envelope.run_id;\n observer({\n source: \"aaac-runtime\",\n eventType: \"agent.session\",\n lifecycle: \"open\",\n spanId,\n parentSpanId: envelope.parent_run_id,\n attributes: attrs({\n axis: \"agent\",\n \"agent.session_id\": envelope.run_id,\n \"agent.run_id\": envelope.run_id,\n \"workflow.id\": workflowId,\n \"agent.component_id\": envelope.component_id,\n \"agent.model\": envelope.model,\n adapter: envelope.adapter,\n contract_version: envelope.contract_version,\n }),\n });\n return spanId;\n}\n\n/**\n * Emit an agent.session close span.\n *\n * `errorMessage` is set on the exception path (workflow body threw) so the\n * failure cause is recorded alongside the run status. Omitted on the normal path.\n *\n * event-catalog.md §2.2 — optional: agent.session.duration_ms, agent.status, agent.error\n */\nexport function emitSessionClose(\n observer: ObserverEmitFn | undefined,\n spanId: string,\n envelope: ExecutionEnvelope,\n durationMs: number,\n status: string,\n errorMessage?: string,\n): void {\n if (!observer) return;\n\n const metaAttrs: Record<string, AttrValue> =\n envelope.execution_metadata ? tokenAttrs(envelope.execution_metadata) : {};\n\n observer({\n source: \"aaac-runtime\",\n eventType: \"agent.session\",\n lifecycle: \"close\",\n spanId,\n attributes: {\n ...attrs({\n axis: \"agent\",\n \"agent.session_id\": envelope.run_id,\n \"agent.session.duration_ms\": durationMs,\n \"agent.status\": status,\n \"agent.error\": errorMessage,\n }),\n ...metaAttrs,\n },\n });\n}\n\n// ── agent.subagent ────────────────────────────────────────────────────────────\n\n/**\n * Emit an agent.subagent open span (task/handoff execution).\n *\n * Uses envelope.run_id as the spanId and parentSpanId for hierarchical correlation\n * (typically the session span's run_id).\n *\n * Returns the spanId emitted (= envelope.run_id).\n * Returns undefined when observer is undefined (no-op).\n *\n * event-catalog.md §2.2 — required: agent.role; axis: agent\n */\nexport function emitSubagentOpen(\n observer: ObserverEmitFn | undefined,\n envelope: ExecutionEnvelope,\n parentSpanId: string | undefined,\n taskId: string,\n agentRole: string,\n): string | undefined {\n if (!observer) return undefined;\n\n const spanId = envelope.run_id;\n observer({\n source: \"aaac-runtime\",\n eventType: \"agent.subagent\",\n lifecycle: \"open\",\n spanId,\n parentSpanId,\n attributes: attrs({\n axis: \"agent\",\n \"agent.role\": agentRole,\n \"agent.kind\": \"task\",\n \"task.id\": taskId,\n \"agent.run_id\": envelope.run_id,\n \"agent.parent_run_id\": envelope.parent_run_id,\n \"agent.model\": envelope.model,\n adapter: envelope.adapter,\n \"agent.component_id\": envelope.component_id,\n \"agent.from_agent\": envelope.from_agent,\n \"agent.to_agent\": envelope.to_agent,\n }),\n });\n return spanId;\n}\n\n/**\n * Emit an agent.subagent close span.\n *\n * `errorMessage` records the failure cause on `agent.error` (parity with\n * emitSessionClose); it is omitted from the attributes when undefined.\n *\n * event-catalog.md §2.2 — optional: agent.duration_ms, agent.status, agent.error,\n * token_usage, cost_usd\n */\nexport function emitSubagentClose(\n observer: ObserverEmitFn | undefined,\n spanId: string,\n envelope: ExecutionEnvelope,\n durationMs: number,\n status: string,\n agentRole: string,\n errorMessage?: string,\n): void {\n if (!observer) return;\n\n const metaAttrs: Record<string, AttrValue> =\n envelope.execution_metadata ? tokenAttrs(envelope.execution_metadata) : {};\n\n observer({\n source: \"aaac-runtime\",\n eventType: \"agent.subagent\",\n lifecycle: \"close\",\n spanId,\n attributes: {\n ...attrs({\n axis: \"agent\",\n \"agent.role\": agentRole,\n \"agent.status\": status,\n \"agent.duration_ms\": durationMs,\n \"agent.error\": errorMessage,\n }),\n ...metaAttrs,\n },\n });\n}\n\n// ── evaluate.iteration ────────────────────────────────────────────────────────\n\n/**\n * Emit an evaluate.iteration open span (one closed-loop iteration).\n *\n * Returns the spanId emitted (= generated UUIDv7).\n * Returns undefined when observer is undefined (no-op).\n */\nexport function emitIterationOpen(\n observer: ObserverEmitFn | undefined,\n parentSpanId: string | undefined,\n evaluateTaskId: string,\n loopTo: string,\n iterationNumber: number,\n maxIterations: number,\n): string | undefined {\n if (!observer) return undefined;\n\n const spanId = generateId();\n observer({\n source: \"aaac-runtime\",\n eventType: \"evaluate.iteration\",\n lifecycle: \"open\",\n spanId,\n parentSpanId,\n attributes: attrs({\n axis: \"agent\",\n \"evaluate.task\": evaluateTaskId,\n \"evaluate.loop_to\": loopTo,\n \"evaluate.iteration\": iterationNumber,\n \"evaluate.max_iterations\": maxIterations,\n }),\n });\n return spanId;\n}\n\n/**\n * Emit an evaluate.iteration close span.\n */\nexport function emitIterationClose(\n observer: ObserverEmitFn | undefined,\n spanId: string,\n evaluateTaskId: string,\n iterationNumber: number,\n verdict: string,\n durationMs: number,\n feedbackInjected: boolean,\n): void {\n if (!observer) return;\n\n observer({\n source: \"aaac-runtime\",\n eventType: \"evaluate.iteration\",\n lifecycle: \"close\",\n spanId,\n attributes: attrs({\n axis: \"agent\",\n \"evaluate.task\": evaluateTaskId,\n \"evaluate.iteration\": iterationNumber,\n \"evaluate.verdict\": verdict,\n \"evaluate.duration_ms\": durationMs,\n \"evaluate.feedback_injected\": feedbackInjected,\n }),\n });\n}\n\n/**\n * Emit an evaluate.metric instant event when an evaluate step terminates.\n */\nexport function emitIterationMetric(\n observer: ObserverEmitFn | undefined,\n parentSpanId: string | undefined,\n evaluateTaskId: string,\n totalIterations: number,\n terminalOutcome: string,\n): void {\n if (!observer) return;\n\n const spanId = generateId();\n observer({\n source: \"aaac-runtime\",\n eventType: \"evaluate.metric\",\n lifecycle: \"instant\",\n spanId,\n parentSpanId,\n attributes: attrs({\n axis: \"agent\",\n \"evaluate.task\": evaluateTaskId,\n \"evaluate.total_iterations\": totalIterations,\n \"evaluate.terminal_outcome\": terminalOutcome,\n }),\n });\n}\n\n// ── InnerSpanOptions (for adapter plumbing) ──────────────────────────────────\n\n/** Options forwarded from task-runner to adapters for inner turn-level spans. */\nexport interface InnerSpanOptions {\n observer?: ObserverEmitFn;\n parentSpanId?: string;\n}\n\n// ── agent.llm_turn ───────────────────────────────────────────────────────────\n\n/**\n * Emit an agent.llm_turn open span when a new LLM turn begins.\n *\n * Returns the spanId emitted (= generated UUIDv7).\n * Returns undefined when observer is undefined (no-op).\n */\nexport function emitLlmTurnOpen(\n observer: ObserverEmitFn | undefined,\n parentSpanId: string | undefined,\n turnNumber: number,\n model?: string,\n llmParams?: { temperature?: number; reasoningEffort?: string },\n): string | undefined {\n if (!observer) return undefined;\n\n const spanId = generateId();\n observer({\n source: \"aaac-runtime\",\n eventType: \"agent.llm_turn\",\n lifecycle: \"open\",\n spanId,\n parentSpanId,\n attributes: attrs({\n axis: \"agent\",\n \"llm.turn_number\": turnNumber,\n \"llm.model\": model,\n \"llm.temperature\": llmParams?.temperature,\n \"llm.reasoning_effort\": llmParams?.reasoningEffort,\n }),\n });\n return spanId;\n}\n\n/**\n * Emit an agent.llm_turn close span.\n */\nexport function emitLlmTurnClose(\n observer: ObserverEmitFn | undefined,\n spanId: string,\n turnNumber: number,\n durationMs: number,\n tokenAttrs?: {\n inputTokens?: number;\n outputTokens?: number;\n cacheHitTokens?: number;\n toolCallsCount?: number;\n },\n): void {\n if (!observer) return;\n\n observer({\n source: \"aaac-runtime\",\n eventType: \"agent.llm_turn\",\n lifecycle: \"close\",\n spanId,\n attributes: attrs({\n axis: \"agent\",\n \"llm.turn_number\": turnNumber,\n \"llm.duration_ms\": durationMs,\n \"llm.input_tokens\": tokenAttrs?.inputTokens,\n \"llm.output_tokens\": tokenAttrs?.outputTokens,\n \"llm.cache_hit_tokens\": tokenAttrs?.cacheHitTokens,\n \"llm.tool_calls_count\": tokenAttrs?.toolCallsCount,\n }),\n });\n}\n\n// ── agent.tool_exec ──────────────────────────────────────────────────────────\n\n/**\n * Emit an agent.tool_exec open span when a tool execution begins.\n *\n * Returns the spanId emitted (= generated UUIDv7).\n * Returns undefined when observer is undefined (no-op).\n */\nexport function emitToolExecOpen(\n observer: ObserverEmitFn | undefined,\n parentSpanId: string | undefined,\n toolName: string,\n inputSummary: string,\n turnNumber: number,\n): string | undefined {\n if (!observer) return undefined;\n\n const spanId = generateId();\n observer({\n source: \"aaac-runtime\",\n eventType: \"agent.tool_exec\",\n lifecycle: \"open\",\n spanId,\n parentSpanId,\n attributes: attrs({\n axis: \"agent\",\n \"tool.name\": toolName,\n \"tool.input_summary\": inputSummary,\n \"llm.turn_number\": turnNumber,\n }),\n });\n return spanId;\n}\n\n/**\n * Emit an agent.tool_exec close span.\n */\nexport function emitToolExecClose(\n observer: ObserverEmitFn | undefined,\n spanId: string,\n toolName: string,\n durationMs: number,\n): void {\n if (!observer) return;\n\n observer({\n source: \"aaac-runtime\",\n eventType: \"agent.tool_exec\",\n lifecycle: \"close\",\n spanId,\n attributes: attrs({\n axis: \"agent\",\n \"tool.name\": toolName,\n \"tool.duration_ms\": durationMs,\n }),\n });\n}\n\n// ── toolchain.execution ──────────────────────────────────────────────────────\n\n/**\n * Emit a toolchain.execution open span when a toolchain tool is invoked.\n *\n * Returns the spanId emitted (= generated UUIDv7).\n * Returns undefined when observer is undefined (no-op).\n */\nexport function emitToolchainOpen(\n observer: ObserverEmitFn | undefined,\n parentSpanId: string | undefined,\n toolchainId: string,\n operation: string,\n artifactIds: string[],\n componentId?: string,\n): string | undefined {\n if (!observer) return undefined;\n\n const spanId = generateId();\n observer({\n source: \"aaac-runtime\",\n eventType: \"toolchain.execution\",\n lifecycle: \"open\",\n spanId,\n parentSpanId,\n attributes: attrs({\n axis: \"toolchain\",\n \"toolchain.id\": toolchainId,\n \"toolchain.operation\": operation,\n \"toolchain.artifact_ids\": artifactIds.join(\",\"),\n \"agent.component_id\": componentId,\n }),\n });\n return spanId;\n}\n\n/**\n * Emit a toolchain.execution close span.\n */\nexport function emitToolchainClose(\n observer: ObserverEmitFn | undefined,\n spanId: string,\n toolchainId: string,\n operation: string,\n durationMs: number,\n status: \"success\" | \"failure\",\n errorMessage?: string,\n): void {\n if (!observer) return;\n\n observer({\n source: \"aaac-runtime\",\n eventType: \"toolchain.execution\",\n lifecycle: \"close\",\n spanId,\n attributes: attrs({\n axis: \"toolchain\",\n \"toolchain.id\": toolchainId,\n \"toolchain.operation\": operation,\n \"toolchain.status\": status,\n \"toolchain.duration_ms\": durationMs,\n ...(errorMessage ? { \"toolchain.error\": errorMessage } : {}),\n }),\n });\n}\n"],"mappings":"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","names":["tokenAttrs"]}
|
package/dist/index.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { O as ObserverEmitFn,
|
|
2
|
-
export {
|
|
1
|
+
import { O as ObserverEmitFn, b as TaskContext, c as TaskOutcome, d as AgentContractLike, e as TaskContractLike, P as PromptBuilderOptions, W as WorkflowResult, S as SdkAdapter, f as WorkflowRegistries, H as HandoffInput, g as StepCompleteEvent, h as StepResult, D as DelegateStep, i as GuardrailRuleData, j as MemoryStore, M as MemoryRef, k as SdkFunctionTool, G as GuardrailHooks, R as ResolvedComponent, l as ArtifactBindingConfig, m as RunToolchainChecksOptions, n as TaskRunResult, L as LibraryToolRegistry, o as ResolvedToolchain, p as LibraryToolDefinition, q as HookResponse, r as GuardrailCheckResult } from './task-runner-Bl3SZfft.js';
|
|
2
|
+
export { s as AdapterOrFactory, A as AdapterSendOptions, a as AgentExecutionRequest, t as AgentProgressEvent, B as BoundResolveOptions, u as BoundResolver, C as CacheConfig, v as CandidateAgent, w as ConvergenceEnvelope, x as ConvergenceEnvelopePayload, E as EnvelopeParams, y as EvaluateStep, z as GateStep, F as GuardrailCheckFunctions, I as GuardrailRule, J as HookContext, K as InMemoryStore, N as InnerSpanOptions, Q as ModelAwareSdkAdapterFactory, U as ModelClass, V as ModelMappingConfig, X as ModelResolver, Y as ModelResolverOptions, Z as ReceiveSpec, _ as ResolvedModel, $ as RetryDecision, a0 as SdkAdapterFactory, a1 as SplitPrompt, a2 as TaskRunOptions, T as TokenUsage, a3 as ToolchainCheckResult, a4 as ToolchainManifest, a5 as ToolchainManifestSchema, a6 as WorkflowContractLike, a7 as WorkflowInvocation, a8 as WorkflowRunOptions, a9 as WorkflowStep, aa as buildCandidateAgents, ab as buildGateEvaluationPrompt, ac as buildPerAgentGuardrails, ad as buildRetryFollowUp, ae as buildSdkFunctionTools, af as buildSplitTaskPrompt, ag as buildTaskPrompt, ah as createExecutionEnvelope, ai as createGuardrailHooks, aj as createGuardrailHooksForAgent, ak as createGuardrailHooksFromRules, al as createLibraryToolRegistry, am as createModelResolver, an as createRegistryFromSdkTools, ao as deriveToolchainsForAgents, ap as emitIterationClose, aq as emitIterationMetric, ar as emitIterationOpen, as as emitLlmTurnClose, at as emitLlmTurnOpen, au as emitSessionClose, av as emitSessionOpen, aw as emitSubagentClose, ax as emitSubagentOpen, ay as emitToolExecClose, az as emitToolExecOpen, aA as emitToolchainClose, aB as emitToolchainOpen, aC as extractStructuredResult, aD as getBlockingViolations, aE as getEffectiveGuardrailIds, aF as getGuardrailRulesForAgent, aG as getWarnings, aH as guardrailContextToRuleData, aI as hasBlockingViolation, aJ as parseGateEvaluationResponse, aK as renderAgentSystemPrompt, aL as runTask, aM as runToolchainChecks, aN as runWorkflow, aO as zodSchemaToPromptDescription, aP as zodSchemaToYamlExample } from './task-runner-Bl3SZfft.js';
|
|
3
3
|
import { z } from 'zod';
|
|
4
4
|
import { OperationIR, ComponentIR } from '@aaac/contracts';
|
|
5
5
|
import { ResolvedConfig } from './generator/index.js';
|
|
@@ -355,34 +355,6 @@ declare class AgentLogWriter {
|
|
|
355
355
|
}>;
|
|
356
356
|
}
|
|
357
357
|
|
|
358
|
-
/**
|
|
359
|
-
* Library Tool → SDK Function Tool conversion.
|
|
360
|
-
*
|
|
361
|
-
* Converts LibraryToolDefinition entries into SDK-native function tools
|
|
362
|
-
* that each adapter can register with its respective LLM SDK.
|
|
363
|
-
*
|
|
364
|
-
* Each adapter receives tools in its native format:
|
|
365
|
-
* - Claude Agent SDK: MCP tool via createSdkMcpServer + tool()
|
|
366
|
-
* - OpenAI Agents SDK: function tool object
|
|
367
|
-
* - Google ADK: FunctionDeclaration tool
|
|
368
|
-
*/
|
|
369
|
-
|
|
370
|
-
/**
|
|
371
|
-
* Adapter-agnostic function tool descriptor. Adapters convert this
|
|
372
|
-
* into their SDK-specific tool format.
|
|
373
|
-
*/
|
|
374
|
-
interface SdkFunctionTool {
|
|
375
|
-
name: string;
|
|
376
|
-
description: string;
|
|
377
|
-
inputSchema: Record<string, unknown>;
|
|
378
|
-
handler: (args: Record<string, unknown>) => Promise<string>;
|
|
379
|
-
}
|
|
380
|
-
/**
|
|
381
|
-
* Build adapter-agnostic function tool descriptors from a LibraryToolRegistry.
|
|
382
|
-
* Each tool's handler calls registry.execute() and serialises the result.
|
|
383
|
-
*/
|
|
384
|
-
declare function buildSdkFunctionTools(registry: LibraryToolRegistry): SdkFunctionTool[];
|
|
385
|
-
|
|
386
358
|
/**
|
|
387
359
|
* Analyzer Bridge — integrates artifact-contracts-analyzer as a standard
|
|
388
360
|
* runtime tool provider.
|
|
@@ -891,4 +863,4 @@ declare function executePrompt(message: string, ir: ComponentIR, binding: Runtim
|
|
|
891
863
|
/** Package version string. */
|
|
892
864
|
declare const version: string;
|
|
893
865
|
|
|
894
|
-
export { type AaacInvocationContext, type AaacObserver, type AaacPolicy, type AaacRuntime, AgentContractLike, AgentLogWriter, type AgentLogWriterOptions, type AgentPlugin, type AnalyzeImpactInput, type AnalyzerBridge, type AnalyzerBridgeOptions, ArtifactBindingConfig, type ArtifactResolveOptions, type ArtifactResolveResult, type BuildCallGraphInput, type ComponentScope, type CreateAdapterOptions, type CreateComponentScopeOptions, type CreateProjectRuntimeOptions, DelegateStep, type DslContext, DslValidationError, type EvaluateGuardrailOptions, type EvaluateGuardrailResult, type ExecuteOptions, type ExecuteTaskOptions, type ExecuteWorkflowOptions, FileMemoryStore, type GenerateContextPackInput, type GuardStatusOptions, type GuardStatusResult, GuardrailCheckResult, GuardrailHooks, type GuardrailListEntry, type GuardrailResult, GuardrailRuleData, HandoffInput, HookResponse, LibraryToolDefinition, LibraryToolRegistry, type ListGuardrailsOptions, type ListGuardrailsResult, type LoadDslOptions, MemoryRef, MemoryStore, type MemoryStoreEntry, type NavigationContext, type NavigationContextOptions, ObserverEmitFn, type OperationHandler, type OperationMemoryRefConfig, type OperationToolDef, PROJECT_CONFIG_FILENAME, type PermissionMode, type PluginLoadResult, PluginRegistry, type ProcessEditOptions, type ProcessTaskOptions, type ProcessWorkflowOptions, type ProgressSink, type ProgressSinkOptions, type ProjectRuntime, type PromptBuilderArgs, PromptBuilderOptions, type PromptExecuteOptions, type PromptResult, type RequiredEntities, type ResolvedAdapterSelection, ResolvedComponent, ResolvedToolchain, type RunLogEvent, RunToolchainChecksOptions, type Runtime, type RuntimeBinding, type RuntimeConfig, SdkAdapter,
|
|
866
|
+
export { type AaacInvocationContext, type AaacObserver, type AaacPolicy, type AaacRuntime, AgentContractLike, AgentLogWriter, type AgentLogWriterOptions, type AgentPlugin, type AnalyzeImpactInput, type AnalyzerBridge, type AnalyzerBridgeOptions, ArtifactBindingConfig, type ArtifactResolveOptions, type ArtifactResolveResult, type BuildCallGraphInput, type ComponentScope, type CreateAdapterOptions, type CreateComponentScopeOptions, type CreateProjectRuntimeOptions, DelegateStep, type DslContext, DslValidationError, type EvaluateGuardrailOptions, type EvaluateGuardrailResult, type ExecuteOptions, type ExecuteTaskOptions, type ExecuteWorkflowOptions, FileMemoryStore, type GenerateContextPackInput, type GuardStatusOptions, type GuardStatusResult, GuardrailCheckResult, GuardrailHooks, type GuardrailListEntry, type GuardrailResult, GuardrailRuleData, HandoffInput, HookResponse, LibraryToolDefinition, LibraryToolRegistry, type ListGuardrailsOptions, type ListGuardrailsResult, type LoadDslOptions, MemoryRef, MemoryStore, type MemoryStoreEntry, type NavigationContext, type NavigationContextOptions, ObserverEmitFn, type OperationHandler, type OperationMemoryRefConfig, type OperationToolDef, PROJECT_CONFIG_FILENAME, type PermissionMode, type PluginLoadResult, PluginRegistry, type ProcessEditOptions, type ProcessTaskOptions, type ProcessWorkflowOptions, type ProgressSink, type ProgressSinkOptions, type ProjectRuntime, type PromptBuilderArgs, PromptBuilderOptions, type PromptExecuteOptions, type PromptResult, type RequiredEntities, type ResolvedAdapterSelection, ResolvedComponent, ResolvedToolchain, type RunLogEvent, RunToolchainChecksOptions, type Runtime, type RuntimeBinding, type RuntimeConfig, SdkAdapter, SdkFunctionTool, StepCompleteEvent, StepResult, TaskContext, TaskContractLike, type TaskHookContext, TaskOutcome, TaskRunResult, WorkflowBuilder, type WorkflowHookContext, WorkflowRegistries, WorkflowResult, buildGuardrailRulesFromDsl, buildNavigationContext, buildRegistriesFromDsl, createAdapter, createAnalyzerBridge, createComponentScope, createProgressSink, createProjectRuntime, createRuntime, createRuntimeBinding, emitProcessEdit, emitProcessTaskClose, emitProcessTaskOpen, emitProcessWorkflowClose, emitProcessWorkflowOpen, evaluateGuardrail, executePrompt, executeTask, executeWorkflow, findProjectConfig, guardStatus, isContextPack, jsonSchemaToZod, listGuardrails, loadDslContext, loadPlugins, loadPluginsFromDirectory, loadPluginsFromPaths, operationsToTools, parseRouterResponse, pluginRegistry, renderContextPackPrompt, resolveArtifacts, version };
|