@aaac/runtime 0.1.19 → 0.1.21
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 +1 -1
- package/dist/adapters/claude-agent-sdk.js +73 -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 +299 -0
- package/dist/chunk-FNB3PE74.js.map +1 -0
- package/dist/index.d.ts +83 -3
- package/dist/index.js +329 -228
- package/dist/index.js.map +1 -1
- package/dist/{task-runner-DV49qwpk.d.ts → task-runner-CuJ3uLj8.d.ts} +44 -1
- package/package.json +6 -2
|
@@ -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-CuJ3uLj8.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-CuJ3uLj8.js';
|
|
2
2
|
import 'zod';
|
|
3
3
|
import '../context-DKkamYX_.js';
|
|
4
4
|
import '@aaac/observability';
|
|
@@ -1,3 +1,9 @@
|
|
|
1
|
+
import {
|
|
2
|
+
emitLlmTurnClose,
|
|
3
|
+
emitLlmTurnOpen,
|
|
4
|
+
emitToolExecClose,
|
|
5
|
+
emitToolExecOpen
|
|
6
|
+
} from "../chunk-FNB3PE74.js";
|
|
1
7
|
import {
|
|
2
8
|
buildClaudeMcpServer
|
|
3
9
|
} from "../chunk-LONLL3K2.js";
|
|
@@ -48,6 +54,20 @@ function buildClaudeHooks(guardrails) {
|
|
|
48
54
|
};
|
|
49
55
|
return { PreToolUse: [preToolUseHook] };
|
|
50
56
|
}
|
|
57
|
+
function truncateInputSummary(input, maxLen = 80) {
|
|
58
|
+
if (input == null) return "";
|
|
59
|
+
let str;
|
|
60
|
+
if (typeof input === "string") {
|
|
61
|
+
str = input;
|
|
62
|
+
} else {
|
|
63
|
+
try {
|
|
64
|
+
str = JSON.stringify(input);
|
|
65
|
+
} catch {
|
|
66
|
+
str = String(input);
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
return str.length > maxLen ? str.slice(0, maxLen - 3) + "..." : str;
|
|
70
|
+
}
|
|
51
71
|
var ClaudeAgentSdkAdapter = class _ClaudeAgentSdkAdapter {
|
|
52
72
|
cwd;
|
|
53
73
|
model;
|
|
@@ -136,23 +156,71 @@ var ClaudeAgentSdkAdapter = class _ClaudeAgentSdkAdapter {
|
|
|
136
156
|
} catch {
|
|
137
157
|
}
|
|
138
158
|
}
|
|
139
|
-
async runQuery(prompt, options, onProgress) {
|
|
159
|
+
async runQuery(prompt, options, onProgress, observer, parentSpanId) {
|
|
140
160
|
const queryFn = await this.resolveQueryFn();
|
|
141
161
|
const stream = queryFn({ prompt, options });
|
|
142
162
|
let resultText = "";
|
|
143
163
|
let sessionId = "";
|
|
164
|
+
let turnNumber = 0;
|
|
165
|
+
let currentTurnSpanId;
|
|
166
|
+
let currentTurnStart = 0;
|
|
167
|
+
let toolCallsInTurn = 0;
|
|
168
|
+
const openToolSpans = [];
|
|
169
|
+
const closePendingToolSpans = () => {
|
|
170
|
+
for (const ts of openToolSpans) {
|
|
171
|
+
emitToolExecClose(observer, ts.spanId, ts.toolName, Date.now() - ts.startMs);
|
|
172
|
+
}
|
|
173
|
+
openToolSpans.length = 0;
|
|
174
|
+
};
|
|
175
|
+
const closeCurrentTurn = () => {
|
|
176
|
+
if (currentTurnSpanId) {
|
|
177
|
+
emitLlmTurnClose(observer, currentTurnSpanId, turnNumber, Date.now() - currentTurnStart, {
|
|
178
|
+
toolCallsCount: toolCallsInTurn || void 0
|
|
179
|
+
});
|
|
180
|
+
currentTurnSpanId = void 0;
|
|
181
|
+
}
|
|
182
|
+
};
|
|
144
183
|
for await (const message of stream) {
|
|
145
184
|
if (message.session_id) sessionId = message.session_id;
|
|
146
185
|
if (message.type === "result") {
|
|
186
|
+
closePendingToolSpans();
|
|
187
|
+
closeCurrentTurn();
|
|
147
188
|
if (message.subtype === "success") {
|
|
148
189
|
resultText = message.result;
|
|
149
190
|
} else if (message.subtype === "error") {
|
|
150
191
|
throw new Error(`Claude Agent SDK error: ${message.error}`);
|
|
151
192
|
}
|
|
152
|
-
} else if (
|
|
153
|
-
|
|
193
|
+
} else if (message.type === "assistant") {
|
|
194
|
+
closePendingToolSpans();
|
|
195
|
+
closeCurrentTurn();
|
|
196
|
+
turnNumber++;
|
|
197
|
+
toolCallsInTurn = 0;
|
|
198
|
+
currentTurnStart = Date.now();
|
|
199
|
+
currentTurnSpanId = emitLlmTurnOpen(observer, parentSpanId, turnNumber, this.model);
|
|
200
|
+
const content = message.message?.content;
|
|
201
|
+
if (content) {
|
|
202
|
+
for (const block of content) {
|
|
203
|
+
if (block.type === "tool_use" && block.name) {
|
|
204
|
+
toolCallsInTurn++;
|
|
205
|
+
const summary = truncateInputSummary(block.input);
|
|
206
|
+
const toolSpanId = emitToolExecOpen(observer, currentTurnSpanId, block.name, summary, turnNumber);
|
|
207
|
+
if (toolSpanId) {
|
|
208
|
+
openToolSpans.push({ spanId: toolSpanId, toolName: block.name, startMs: Date.now() });
|
|
209
|
+
}
|
|
210
|
+
}
|
|
211
|
+
}
|
|
212
|
+
}
|
|
213
|
+
if (onProgress) {
|
|
214
|
+
emitProgressFromSdkMessage(message, onProgress, sessionId);
|
|
215
|
+
}
|
|
216
|
+
} else {
|
|
217
|
+
if (onProgress) {
|
|
218
|
+
emitProgressFromSdkMessage(message, onProgress, sessionId);
|
|
219
|
+
}
|
|
154
220
|
}
|
|
155
221
|
}
|
|
222
|
+
closePendingToolSpans();
|
|
223
|
+
closeCurrentTurn();
|
|
156
224
|
return { text: resultText, sessionId };
|
|
157
225
|
}
|
|
158
226
|
// -------------------------------------------------------------------------
|
|
@@ -166,7 +234,7 @@ var ClaudeAgentSdkAdapter = class _ClaudeAgentSdkAdapter {
|
|
|
166
234
|
const userPrompt = split ? split.user : prompt;
|
|
167
235
|
const opts = this.buildOptions(options.readonly, void 0, systemPrompt, options.agents, options.allowDynamicWorkflow);
|
|
168
236
|
await this.attachLibraryTools(opts, options.libraryTools);
|
|
169
|
-
const { text, sessionId } = await this.runQuery(userPrompt, opts, options.onProgress);
|
|
237
|
+
const { text, sessionId } = await this.runQuery(userPrompt, opts, options.onProgress, options.observer, options.parentSpanId);
|
|
170
238
|
this.lastSessionId = sessionId;
|
|
171
239
|
this.lastMemoryRef = {
|
|
172
240
|
id: sessionId,
|
|
@@ -195,7 +263,7 @@ var ClaudeAgentSdkAdapter = class _ClaudeAgentSdkAdapter {
|
|
|
195
263
|
const agents = request.options.agents ?? request.agents;
|
|
196
264
|
const opts = this.buildOptions(request.options.readonly, resume, systemPrompt, agents, request.options.allowDynamicWorkflow);
|
|
197
265
|
await this.attachLibraryTools(opts, request.options.libraryTools);
|
|
198
|
-
const { text, sessionId } = await this.runQuery(userPrompt, opts, request.options.onProgress);
|
|
266
|
+
const { text, sessionId } = await this.runQuery(userPrompt, opts, request.options.onProgress, request.options.observer, request.options.parentSpanId);
|
|
199
267
|
this.lastSessionId = sessionId;
|
|
200
268
|
this.lastMemoryRef = {
|
|
201
269
|
id: sessionId,
|
|
@@ -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 { 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// 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\"]\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 ): 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 for await (const message of stream) {\n if (message.session_id) sessionId = message.session_id;\n if (message.type === \"result\") {\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 (onProgress) {\n emitProgressFromSdkMessage(message, onProgress, sessionId);\n }\n }\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);\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);\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 } 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\"]\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":[]}
|
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-CuJ3uLj8.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-CuJ3uLj8.js';
|
|
2
2
|
import 'zod';
|
|
3
3
|
import '../context-DKkamYX_.js';
|
|
4
4
|
import '@aaac/observability';
|
|
@@ -0,0 +1,299 @@
|
|
|
1
|
+
// src/lib/observability-bridge.ts
|
|
2
|
+
import { generateId } from "@aaac/observability";
|
|
3
|
+
function createExecutionEnvelope(params = {}) {
|
|
4
|
+
const envelope = {
|
|
5
|
+
run_id: generateId(),
|
|
6
|
+
timestamp: (/* @__PURE__ */ new Date()).toISOString()
|
|
7
|
+
};
|
|
8
|
+
if (params.parentRunId !== void 0) envelope.parent_run_id = params.parentRunId;
|
|
9
|
+
if (params.componentId !== void 0) envelope.component_id = params.componentId;
|
|
10
|
+
if (params.fromAgent !== void 0) envelope.from_agent = params.fromAgent;
|
|
11
|
+
if (params.toAgent !== void 0) envelope.to_agent = params.toAgent;
|
|
12
|
+
if (params.contractVersion !== void 0) envelope.contract_version = params.contractVersion;
|
|
13
|
+
if (params.adapter !== void 0) envelope.adapter = params.adapter;
|
|
14
|
+
if (params.model !== void 0) envelope.model = params.model;
|
|
15
|
+
if (params.taskInstanceId !== void 0) envelope.task_instance_id = params.taskInstanceId;
|
|
16
|
+
return envelope;
|
|
17
|
+
}
|
|
18
|
+
function attrs(base) {
|
|
19
|
+
const out = {};
|
|
20
|
+
for (const [k, v] of Object.entries(base)) {
|
|
21
|
+
if (v !== void 0 && v !== "") out[k] = v;
|
|
22
|
+
}
|
|
23
|
+
return out;
|
|
24
|
+
}
|
|
25
|
+
function tokenAttrs(meta) {
|
|
26
|
+
const out = {};
|
|
27
|
+
const tu = meta.token_usage;
|
|
28
|
+
if (tu && typeof tu === "object") {
|
|
29
|
+
const t = tu;
|
|
30
|
+
if (typeof t.input_tokens === "number") out["token_usage.input"] = t.input_tokens;
|
|
31
|
+
if (typeof t.output_tokens === "number") out["token_usage.output"] = t.output_tokens;
|
|
32
|
+
if (typeof t.total_tokens === "number") out["token_usage.total"] = t.total_tokens;
|
|
33
|
+
if (typeof t.cache_read_input_tokens === "number") out["token_usage.cache_read"] = t.cache_read_input_tokens;
|
|
34
|
+
if (typeof t.cache_creation_input_tokens === "number") out["token_usage.cache_creation"] = t.cache_creation_input_tokens;
|
|
35
|
+
}
|
|
36
|
+
if (typeof meta.cost_usd === "number") out["cost_usd"] = meta.cost_usd;
|
|
37
|
+
return out;
|
|
38
|
+
}
|
|
39
|
+
function emitSessionOpen(observer, envelope, workflowId) {
|
|
40
|
+
if (!observer) return void 0;
|
|
41
|
+
const spanId = envelope.run_id;
|
|
42
|
+
observer({
|
|
43
|
+
source: "aaac-runtime",
|
|
44
|
+
eventType: "agent.session",
|
|
45
|
+
lifecycle: "open",
|
|
46
|
+
spanId,
|
|
47
|
+
parentSpanId: envelope.parent_run_id,
|
|
48
|
+
attributes: attrs({
|
|
49
|
+
axis: "agent",
|
|
50
|
+
"agent.session_id": envelope.run_id,
|
|
51
|
+
"agent.run_id": envelope.run_id,
|
|
52
|
+
"workflow.id": workflowId,
|
|
53
|
+
"agent.component_id": envelope.component_id,
|
|
54
|
+
"agent.model": envelope.model,
|
|
55
|
+
adapter: envelope.adapter,
|
|
56
|
+
contract_version: envelope.contract_version
|
|
57
|
+
})
|
|
58
|
+
});
|
|
59
|
+
return spanId;
|
|
60
|
+
}
|
|
61
|
+
function emitSessionClose(observer, spanId, envelope, durationMs, status, errorMessage) {
|
|
62
|
+
if (!observer) return;
|
|
63
|
+
const metaAttrs = envelope.execution_metadata ? tokenAttrs(envelope.execution_metadata) : {};
|
|
64
|
+
observer({
|
|
65
|
+
source: "aaac-runtime",
|
|
66
|
+
eventType: "agent.session",
|
|
67
|
+
lifecycle: "close",
|
|
68
|
+
spanId,
|
|
69
|
+
attributes: {
|
|
70
|
+
...attrs({
|
|
71
|
+
axis: "agent",
|
|
72
|
+
"agent.session_id": envelope.run_id,
|
|
73
|
+
"agent.session.duration_ms": durationMs,
|
|
74
|
+
"agent.status": status,
|
|
75
|
+
"agent.error": errorMessage
|
|
76
|
+
}),
|
|
77
|
+
...metaAttrs
|
|
78
|
+
}
|
|
79
|
+
});
|
|
80
|
+
}
|
|
81
|
+
function emitSubagentOpen(observer, envelope, parentSpanId, taskId, agentRole) {
|
|
82
|
+
if (!observer) return void 0;
|
|
83
|
+
const spanId = envelope.run_id;
|
|
84
|
+
observer({
|
|
85
|
+
source: "aaac-runtime",
|
|
86
|
+
eventType: "agent.subagent",
|
|
87
|
+
lifecycle: "open",
|
|
88
|
+
spanId,
|
|
89
|
+
parentSpanId,
|
|
90
|
+
attributes: attrs({
|
|
91
|
+
axis: "agent",
|
|
92
|
+
"agent.role": agentRole,
|
|
93
|
+
"agent.kind": "task",
|
|
94
|
+
"task.id": taskId,
|
|
95
|
+
"agent.run_id": envelope.run_id,
|
|
96
|
+
"agent.parent_run_id": envelope.parent_run_id,
|
|
97
|
+
"agent.model": envelope.model,
|
|
98
|
+
adapter: envelope.adapter,
|
|
99
|
+
"agent.component_id": envelope.component_id,
|
|
100
|
+
"agent.from_agent": envelope.from_agent,
|
|
101
|
+
"agent.to_agent": envelope.to_agent
|
|
102
|
+
})
|
|
103
|
+
});
|
|
104
|
+
return spanId;
|
|
105
|
+
}
|
|
106
|
+
function emitSubagentClose(observer, spanId, envelope, durationMs, status, agentRole, errorMessage) {
|
|
107
|
+
if (!observer) return;
|
|
108
|
+
const metaAttrs = envelope.execution_metadata ? tokenAttrs(envelope.execution_metadata) : {};
|
|
109
|
+
observer({
|
|
110
|
+
source: "aaac-runtime",
|
|
111
|
+
eventType: "agent.subagent",
|
|
112
|
+
lifecycle: "close",
|
|
113
|
+
spanId,
|
|
114
|
+
attributes: {
|
|
115
|
+
...attrs({
|
|
116
|
+
axis: "agent",
|
|
117
|
+
"agent.role": agentRole,
|
|
118
|
+
"agent.status": status,
|
|
119
|
+
"agent.duration_ms": durationMs,
|
|
120
|
+
"agent.error": errorMessage
|
|
121
|
+
}),
|
|
122
|
+
...metaAttrs
|
|
123
|
+
}
|
|
124
|
+
});
|
|
125
|
+
}
|
|
126
|
+
function emitIterationOpen(observer, parentSpanId, evaluateTaskId, loopTo, iterationNumber, maxIterations) {
|
|
127
|
+
if (!observer) return void 0;
|
|
128
|
+
const spanId = generateId();
|
|
129
|
+
observer({
|
|
130
|
+
source: "aaac-runtime",
|
|
131
|
+
eventType: "evaluate.iteration",
|
|
132
|
+
lifecycle: "open",
|
|
133
|
+
spanId,
|
|
134
|
+
parentSpanId,
|
|
135
|
+
attributes: attrs({
|
|
136
|
+
axis: "agent",
|
|
137
|
+
"evaluate.task": evaluateTaskId,
|
|
138
|
+
"evaluate.loop_to": loopTo,
|
|
139
|
+
"evaluate.iteration": iterationNumber,
|
|
140
|
+
"evaluate.max_iterations": maxIterations
|
|
141
|
+
})
|
|
142
|
+
});
|
|
143
|
+
return spanId;
|
|
144
|
+
}
|
|
145
|
+
function emitIterationClose(observer, spanId, evaluateTaskId, iterationNumber, verdict, durationMs, feedbackInjected) {
|
|
146
|
+
if (!observer) return;
|
|
147
|
+
observer({
|
|
148
|
+
source: "aaac-runtime",
|
|
149
|
+
eventType: "evaluate.iteration",
|
|
150
|
+
lifecycle: "close",
|
|
151
|
+
spanId,
|
|
152
|
+
attributes: attrs({
|
|
153
|
+
axis: "agent",
|
|
154
|
+
"evaluate.task": evaluateTaskId,
|
|
155
|
+
"evaluate.iteration": iterationNumber,
|
|
156
|
+
"evaluate.verdict": verdict,
|
|
157
|
+
"evaluate.duration_ms": durationMs,
|
|
158
|
+
"evaluate.feedback_injected": feedbackInjected
|
|
159
|
+
})
|
|
160
|
+
});
|
|
161
|
+
}
|
|
162
|
+
function emitIterationMetric(observer, parentSpanId, evaluateTaskId, totalIterations, terminalOutcome) {
|
|
163
|
+
if (!observer) return;
|
|
164
|
+
const spanId = generateId();
|
|
165
|
+
observer({
|
|
166
|
+
source: "aaac-runtime",
|
|
167
|
+
eventType: "evaluate.metric",
|
|
168
|
+
lifecycle: "instant",
|
|
169
|
+
spanId,
|
|
170
|
+
parentSpanId,
|
|
171
|
+
attributes: attrs({
|
|
172
|
+
axis: "agent",
|
|
173
|
+
"evaluate.task": evaluateTaskId,
|
|
174
|
+
"evaluate.total_iterations": totalIterations,
|
|
175
|
+
"evaluate.terminal_outcome": terminalOutcome
|
|
176
|
+
})
|
|
177
|
+
});
|
|
178
|
+
}
|
|
179
|
+
function emitLlmTurnOpen(observer, parentSpanId, turnNumber, model) {
|
|
180
|
+
if (!observer) return void 0;
|
|
181
|
+
const spanId = generateId();
|
|
182
|
+
observer({
|
|
183
|
+
source: "aaac-runtime",
|
|
184
|
+
eventType: "agent.llm_turn",
|
|
185
|
+
lifecycle: "open",
|
|
186
|
+
spanId,
|
|
187
|
+
parentSpanId,
|
|
188
|
+
attributes: attrs({
|
|
189
|
+
axis: "agent",
|
|
190
|
+
"llm.turn_number": turnNumber,
|
|
191
|
+
"llm.model": model
|
|
192
|
+
})
|
|
193
|
+
});
|
|
194
|
+
return spanId;
|
|
195
|
+
}
|
|
196
|
+
function emitLlmTurnClose(observer, spanId, turnNumber, durationMs, tokenAttrs2) {
|
|
197
|
+
if (!observer) return;
|
|
198
|
+
observer({
|
|
199
|
+
source: "aaac-runtime",
|
|
200
|
+
eventType: "agent.llm_turn",
|
|
201
|
+
lifecycle: "close",
|
|
202
|
+
spanId,
|
|
203
|
+
attributes: attrs({
|
|
204
|
+
axis: "agent",
|
|
205
|
+
"llm.turn_number": turnNumber,
|
|
206
|
+
"llm.duration_ms": durationMs,
|
|
207
|
+
"llm.input_tokens": tokenAttrs2?.inputTokens,
|
|
208
|
+
"llm.output_tokens": tokenAttrs2?.outputTokens,
|
|
209
|
+
"llm.cache_hit_tokens": tokenAttrs2?.cacheHitTokens,
|
|
210
|
+
"llm.tool_calls_count": tokenAttrs2?.toolCallsCount
|
|
211
|
+
})
|
|
212
|
+
});
|
|
213
|
+
}
|
|
214
|
+
function emitToolExecOpen(observer, parentSpanId, toolName, inputSummary, turnNumber) {
|
|
215
|
+
if (!observer) return void 0;
|
|
216
|
+
const spanId = generateId();
|
|
217
|
+
observer({
|
|
218
|
+
source: "aaac-runtime",
|
|
219
|
+
eventType: "agent.tool_exec",
|
|
220
|
+
lifecycle: "open",
|
|
221
|
+
spanId,
|
|
222
|
+
parentSpanId,
|
|
223
|
+
attributes: attrs({
|
|
224
|
+
axis: "agent",
|
|
225
|
+
"tool.name": toolName,
|
|
226
|
+
"tool.input_summary": inputSummary,
|
|
227
|
+
"llm.turn_number": turnNumber
|
|
228
|
+
})
|
|
229
|
+
});
|
|
230
|
+
return spanId;
|
|
231
|
+
}
|
|
232
|
+
function emitToolExecClose(observer, spanId, toolName, durationMs) {
|
|
233
|
+
if (!observer) return;
|
|
234
|
+
observer({
|
|
235
|
+
source: "aaac-runtime",
|
|
236
|
+
eventType: "agent.tool_exec",
|
|
237
|
+
lifecycle: "close",
|
|
238
|
+
spanId,
|
|
239
|
+
attributes: attrs({
|
|
240
|
+
axis: "agent",
|
|
241
|
+
"tool.name": toolName,
|
|
242
|
+
"tool.duration_ms": durationMs
|
|
243
|
+
})
|
|
244
|
+
});
|
|
245
|
+
}
|
|
246
|
+
function emitToolchainOpen(observer, parentSpanId, toolchainId, operation, artifactIds, componentId) {
|
|
247
|
+
if (!observer) return void 0;
|
|
248
|
+
const spanId = generateId();
|
|
249
|
+
observer({
|
|
250
|
+
source: "aaac-runtime",
|
|
251
|
+
eventType: "toolchain.execution",
|
|
252
|
+
lifecycle: "open",
|
|
253
|
+
spanId,
|
|
254
|
+
parentSpanId,
|
|
255
|
+
attributes: attrs({
|
|
256
|
+
axis: "toolchain",
|
|
257
|
+
"toolchain.id": toolchainId,
|
|
258
|
+
"toolchain.operation": operation,
|
|
259
|
+
"toolchain.artifact_ids": artifactIds.join(","),
|
|
260
|
+
"agent.component_id": componentId
|
|
261
|
+
})
|
|
262
|
+
});
|
|
263
|
+
return spanId;
|
|
264
|
+
}
|
|
265
|
+
function emitToolchainClose(observer, spanId, toolchainId, operation, durationMs, status, errorMessage) {
|
|
266
|
+
if (!observer) return;
|
|
267
|
+
observer({
|
|
268
|
+
source: "aaac-runtime",
|
|
269
|
+
eventType: "toolchain.execution",
|
|
270
|
+
lifecycle: "close",
|
|
271
|
+
spanId,
|
|
272
|
+
attributes: attrs({
|
|
273
|
+
axis: "toolchain",
|
|
274
|
+
"toolchain.id": toolchainId,
|
|
275
|
+
"toolchain.operation": operation,
|
|
276
|
+
"toolchain.status": status,
|
|
277
|
+
"toolchain.duration_ms": durationMs,
|
|
278
|
+
...errorMessage ? { "toolchain.error": errorMessage } : {}
|
|
279
|
+
})
|
|
280
|
+
});
|
|
281
|
+
}
|
|
282
|
+
|
|
283
|
+
export {
|
|
284
|
+
createExecutionEnvelope,
|
|
285
|
+
emitSessionOpen,
|
|
286
|
+
emitSessionClose,
|
|
287
|
+
emitSubagentOpen,
|
|
288
|
+
emitSubagentClose,
|
|
289
|
+
emitIterationOpen,
|
|
290
|
+
emitIterationClose,
|
|
291
|
+
emitIterationMetric,
|
|
292
|
+
emitLlmTurnOpen,
|
|
293
|
+
emitLlmTurnClose,
|
|
294
|
+
emitToolExecOpen,
|
|
295
|
+
emitToolExecClose,
|
|
296
|
+
emitToolchainOpen,
|
|
297
|
+
emitToolchainClose
|
|
298
|
+
};
|
|
299
|
+
//# sourceMappingURL=chunk-FNB3PE74.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// ── 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): 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 }),\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"]}
|