@aaac/runtime 0.1.24 → 0.1.26
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 +9 -1
- package/dist/adapters/adk-sdk.js +111 -6
- package/dist/adapters/adk-sdk.js.map +1 -1
- package/dist/adapters/claude-agent-sdk.d.ts +1 -1
- package/dist/adapters/claude-agent-sdk.js +2 -4
- 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 +10 -1
- package/dist/adapters/openai-agents-sdk.js +114 -7
- package/dist/adapters/openai-agents-sdk.js.map +1 -1
- package/dist/{chunk-3HT5BILT.js → chunk-LWMRO7RR.js} +107 -2
- package/dist/chunk-LWMRO7RR.js.map +1 -0
- package/dist/index.d.ts +2 -2
- package/dist/index.js +20 -9
- package/dist/index.js.map +1 -1
- package/dist/{task-runner-Bl3SZfft.d.ts → task-runner-CVh7Luc_.d.ts} +38 -1
- package/package.json +1 -1
- package/dist/chunk-3HT5BILT.js.map +0 -1
- package/dist/chunk-LONLL3K2.js +0 -94
- package/dist/chunk-LONLL3K2.js.map +0 -1
|
@@ -1,6 +1,10 @@
|
|
|
1
1
|
import {
|
|
2
|
-
buildOpenAIFunctionTools
|
|
3
|
-
|
|
2
|
+
buildOpenAIFunctionTools,
|
|
3
|
+
emitLlmTurnClose,
|
|
4
|
+
emitLlmTurnOpen,
|
|
5
|
+
emitToolExecClose,
|
|
6
|
+
emitToolExecOpen
|
|
7
|
+
} from "../chunk-LWMRO7RR.js";
|
|
4
8
|
|
|
5
9
|
// src/adapters/openai-agents-sdk.ts
|
|
6
10
|
function buildInputGuardrails(guardrails) {
|
|
@@ -19,6 +23,20 @@ function buildInputGuardrails(guardrails) {
|
|
|
19
23
|
}
|
|
20
24
|
];
|
|
21
25
|
}
|
|
26
|
+
function truncateInputSummary(input, maxLen = 80) {
|
|
27
|
+
if (input == null) return "";
|
|
28
|
+
let str;
|
|
29
|
+
if (typeof input === "string") {
|
|
30
|
+
str = input;
|
|
31
|
+
} else {
|
|
32
|
+
try {
|
|
33
|
+
str = JSON.stringify(input);
|
|
34
|
+
} catch {
|
|
35
|
+
str = String(input);
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
return str.length > maxLen ? str.slice(0, maxLen - 3) + "..." : str;
|
|
39
|
+
}
|
|
22
40
|
var OpenAIAgentsSdkAdapter = class _OpenAIAgentsSdkAdapter {
|
|
23
41
|
model;
|
|
24
42
|
maxTurns;
|
|
@@ -30,6 +48,7 @@ var OpenAIAgentsSdkAdapter = class _OpenAIAgentsSdkAdapter {
|
|
|
30
48
|
lastResponseId = null;
|
|
31
49
|
lastAgent = null;
|
|
32
50
|
lastMemoryRef = null;
|
|
51
|
+
lastTokenUsage = null;
|
|
33
52
|
AgentClass = null;
|
|
34
53
|
runFn = null;
|
|
35
54
|
streamRunFn = null;
|
|
@@ -115,15 +134,84 @@ var OpenAIAgentsSdkAdapter = class _OpenAIAgentsSdkAdapter {
|
|
|
115
134
|
}
|
|
116
135
|
return "";
|
|
117
136
|
}
|
|
118
|
-
async runWithProgress(agent, input, runOpts, onProgress) {
|
|
137
|
+
async runWithProgress(agent, input, runOpts, onProgress, observer, parentSpanId) {
|
|
119
138
|
const { run, streamRun } = await this.resolveSdk();
|
|
120
|
-
if (!onProgress
|
|
139
|
+
if (!onProgress && !observer) {
|
|
140
|
+
if (!streamRun) return run(agent, input, runOpts);
|
|
141
|
+
const streamResult2 = await streamRun(agent, input, runOpts);
|
|
142
|
+
for await (const _event of streamResult2.streamEvents()) {
|
|
143
|
+
}
|
|
144
|
+
return streamResult2;
|
|
145
|
+
}
|
|
146
|
+
if (!streamRun) {
|
|
121
147
|
return run(agent, input, runOpts);
|
|
122
148
|
}
|
|
123
149
|
const streamResult = await streamRun(agent, input, runOpts);
|
|
150
|
+
let turnNumber = 0;
|
|
151
|
+
let currentTurnSpanId;
|
|
152
|
+
let currentTurnStart = 0;
|
|
153
|
+
let toolCallsInTurn = 0;
|
|
154
|
+
const openToolSpans = [];
|
|
155
|
+
const closePendingToolSpans = () => {
|
|
156
|
+
for (const ts of openToolSpans) {
|
|
157
|
+
emitToolExecClose(observer, ts.spanId, ts.toolName, Date.now() - ts.startMs);
|
|
158
|
+
}
|
|
159
|
+
openToolSpans.length = 0;
|
|
160
|
+
};
|
|
161
|
+
const closeCurrentTurn = () => {
|
|
162
|
+
if (currentTurnSpanId) {
|
|
163
|
+
emitLlmTurnClose(observer, currentTurnSpanId, turnNumber, Date.now() - currentTurnStart, {
|
|
164
|
+
toolCallsCount: toolCallsInTurn || void 0
|
|
165
|
+
});
|
|
166
|
+
currentTurnSpanId = void 0;
|
|
167
|
+
}
|
|
168
|
+
};
|
|
124
169
|
for await (const event of streamResult.streamEvents()) {
|
|
125
|
-
emitProgressFromOpenAIEvent(event, onProgress);
|
|
170
|
+
if (onProgress) emitProgressFromOpenAIEvent(event, onProgress);
|
|
171
|
+
switch (event.type) {
|
|
172
|
+
case "reasoning_item_created": {
|
|
173
|
+
closePendingToolSpans();
|
|
174
|
+
closeCurrentTurn();
|
|
175
|
+
turnNumber++;
|
|
176
|
+
toolCallsInTurn = 0;
|
|
177
|
+
currentTurnStart = Date.now();
|
|
178
|
+
currentTurnSpanId = emitLlmTurnOpen(observer, parentSpanId, turnNumber, this.model);
|
|
179
|
+
break;
|
|
180
|
+
}
|
|
181
|
+
case "tool_called": {
|
|
182
|
+
if (!currentTurnSpanId) {
|
|
183
|
+
turnNumber++;
|
|
184
|
+
toolCallsInTurn = 0;
|
|
185
|
+
currentTurnStart = Date.now();
|
|
186
|
+
currentTurnSpanId = emitLlmTurnOpen(observer, parentSpanId, turnNumber, this.model);
|
|
187
|
+
}
|
|
188
|
+
toolCallsInTurn++;
|
|
189
|
+
const toolName = event.item?.toolName ?? "unknown";
|
|
190
|
+
const summary = truncateInputSummary(event.item?.toolInput);
|
|
191
|
+
const toolSpanId = emitToolExecOpen(observer, currentTurnSpanId, toolName, summary, turnNumber);
|
|
192
|
+
if (toolSpanId) {
|
|
193
|
+
openToolSpans.push({ spanId: toolSpanId, toolName, startMs: Date.now() });
|
|
194
|
+
}
|
|
195
|
+
break;
|
|
196
|
+
}
|
|
197
|
+
case "tool_output": {
|
|
198
|
+
if (openToolSpans.length > 0) {
|
|
199
|
+
const ts = openToolSpans.shift();
|
|
200
|
+
emitToolExecClose(observer, ts.spanId, ts.toolName, Date.now() - ts.startMs);
|
|
201
|
+
}
|
|
202
|
+
break;
|
|
203
|
+
}
|
|
204
|
+
case "handoff_occurred": {
|
|
205
|
+
closePendingToolSpans();
|
|
206
|
+
closeCurrentTurn();
|
|
207
|
+
break;
|
|
208
|
+
}
|
|
209
|
+
default:
|
|
210
|
+
break;
|
|
211
|
+
}
|
|
126
212
|
}
|
|
213
|
+
closePendingToolSpans();
|
|
214
|
+
closeCurrentTurn();
|
|
127
215
|
return streamResult;
|
|
128
216
|
}
|
|
129
217
|
// -------------------------------------------------------------------------
|
|
@@ -141,6 +229,7 @@ var OpenAIAgentsSdkAdapter = class _OpenAIAgentsSdkAdapter {
|
|
|
141
229
|
this.lastResponseId = null;
|
|
142
230
|
this.lastAgent = null;
|
|
143
231
|
this.lastMemoryRef = null;
|
|
232
|
+
this.lastTokenUsage = null;
|
|
144
233
|
const { Agent } = await this.resolveSdk();
|
|
145
234
|
const split = options.splitPrompt;
|
|
146
235
|
let instructions;
|
|
@@ -155,9 +244,10 @@ var OpenAIAgentsSdkAdapter = class _OpenAIAgentsSdkAdapter {
|
|
|
155
244
|
const libTools = await this.resolveLibraryTools(options.libraryTools);
|
|
156
245
|
const agent = this.createAgent(Agent, instructions, options.readonly, options.agents, libTools);
|
|
157
246
|
const runOpts = this.buildRunOptions();
|
|
158
|
-
const result = await this.runWithProgress(agent, runInput, runOpts, options.onProgress);
|
|
247
|
+
const result = await this.runWithProgress(agent, runInput, runOpts, options.onProgress, options.observer, options.parentSpanId);
|
|
159
248
|
this.lastResponseId = result.lastResponseId ?? null;
|
|
160
249
|
this.lastAgent = agent;
|
|
250
|
+
this.lastTokenUsage = this.extractTokenUsage(result);
|
|
161
251
|
this.lastMemoryRef = this.lastResponseId ? {
|
|
162
252
|
id: this.lastResponseId,
|
|
163
253
|
provider: "openai-responses",
|
|
@@ -181,6 +271,7 @@ var OpenAIAgentsSdkAdapter = class _OpenAIAgentsSdkAdapter {
|
|
|
181
271
|
this.lastResponseId = null;
|
|
182
272
|
this.lastAgent = null;
|
|
183
273
|
this.lastMemoryRef = null;
|
|
274
|
+
this.lastTokenUsage = null;
|
|
184
275
|
const { Agent } = await this.resolveSdk();
|
|
185
276
|
const split = request.splitPrompt;
|
|
186
277
|
let instructions;
|
|
@@ -196,9 +287,10 @@ var OpenAIAgentsSdkAdapter = class _OpenAIAgentsSdkAdapter {
|
|
|
196
287
|
const libTools = await this.resolveLibraryTools(request.options.libraryTools);
|
|
197
288
|
const agent = this.createAgent(Agent, instructions, request.options.readonly, agents, libTools);
|
|
198
289
|
const runOpts = this.buildRunOptions(request.memoryRef?.id);
|
|
199
|
-
const result = await this.runWithProgress(agent, runInput, runOpts, request.options.onProgress);
|
|
290
|
+
const result = await this.runWithProgress(agent, runInput, runOpts, request.options.onProgress, request.options.observer, request.options.parentSpanId);
|
|
200
291
|
this.lastResponseId = result.lastResponseId ?? null;
|
|
201
292
|
this.lastAgent = agent;
|
|
293
|
+
this.lastTokenUsage = this.extractTokenUsage(result);
|
|
202
294
|
this.lastMemoryRef = this.lastResponseId ? {
|
|
203
295
|
id: this.lastResponseId,
|
|
204
296
|
provider: "openai-responses",
|
|
@@ -211,9 +303,24 @@ var OpenAIAgentsSdkAdapter = class _OpenAIAgentsSdkAdapter {
|
|
|
211
303
|
getLastMemoryRef() {
|
|
212
304
|
return this.lastMemoryRef;
|
|
213
305
|
}
|
|
306
|
+
getLastTokenUsage() {
|
|
307
|
+
return this.lastTokenUsage;
|
|
308
|
+
}
|
|
214
309
|
isCompatible(compat) {
|
|
215
310
|
return compat.startsWith("openai-agents-sdk@");
|
|
216
311
|
}
|
|
312
|
+
extractTokenUsage(result) {
|
|
313
|
+
const usage = result.usage;
|
|
314
|
+
if (!usage) return null;
|
|
315
|
+
if (typeof usage.input_tokens !== "number" && typeof usage.output_tokens !== "number") return null;
|
|
316
|
+
const inputTokens = usage.input_tokens ?? 0;
|
|
317
|
+
const outputTokens = usage.output_tokens ?? 0;
|
|
318
|
+
return {
|
|
319
|
+
inputTokens,
|
|
320
|
+
outputTokens,
|
|
321
|
+
totalTokens: usage.total_tokens ?? inputTokens + outputTokens
|
|
322
|
+
};
|
|
323
|
+
}
|
|
217
324
|
// -------------------------------------------------------------------------
|
|
218
325
|
// Test support
|
|
219
326
|
// -------------------------------------------------------------------------
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/adapters/openai-agents-sdk.ts"],"sourcesContent":["/**\n * OpenAI Agents SDK Adapter — implements SdkAdapter for @openai/agents\n *\n * Uses the `run()` function (or `Runner`) from the OpenAI Agents SDK to execute\n * an Agent with instructions derived from the contract prompt.\n *\n * Supports:\n * - send() — create a fresh Agent + run() and return finalOutput\n * - followUp() — resume the same conversation via previousResponseId\n * - sendExecution() — rich path using full contract context\n *\n * The SDK's `run()` returns a RunResult with `finalOutput` (the model's final\n * text output) and `lastResponseId` for continuation.\n *\n * GuardrailHooks are mapped to the SDK's InputGuardrail 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 { buildOpenAIFunctionTools } from \"../lib/library-tool-sdk.js\";\n\n// ---------------------------------------------------------------------------\n// Duck-typed SDK types (avoid hard compile-time dependency on @openai/agents)\n// ---------------------------------------------------------------------------\n\ntype RunResult = {\n finalOutput?: string | unknown;\n lastResponseId?: string;\n newItems?: Array<{\n type: string;\n rawItem?: { type?: string; content?: unknown };\n [key: string]: unknown;\n }>;\n state?: unknown;\n};\n\ntype AgentOptions = {\n name: string;\n model?: string;\n instructions: string | ((ctx: unknown) => string);\n tools?: unknown[];\n inputGuardrails?: unknown[];\n outputType?: unknown;\n [key: string]: unknown;\n};\n\ntype AgentInstance = AgentOptions & { [key: string]: unknown };\n\ntype RunOptions = {\n maxTurns?: number | null;\n signal?: AbortSignal;\n previousResponseId?: string;\n stream?: boolean;\n context?: unknown;\n [key: string]: unknown;\n};\n\ntype AgentConstructor = new (options: AgentOptions) => AgentInstance;\n\ntype RunFn = (\n agent: AgentInstance,\n input: string | unknown[],\n options?: RunOptions,\n) => Promise<RunResult>;\n\ntype StreamedRunResult = RunResult & {\n streamEvents(): AsyncIterable<RunStreamEvent>;\n};\n\ntype RunStreamEvent = {\n type: string;\n name?: string;\n item?: {\n type: string;\n toolName?: string;\n agent?: { name?: string };\n [key: string]: unknown;\n };\n [key: string]: unknown;\n};\n\ntype StreamRunFn = (\n agent: AgentInstance,\n input: string | unknown[],\n options?: RunOptions,\n) => Promise<StreamedRunResult>;\n\n// ---------------------------------------------------------------------------\n// Guardrail bridge\n// ---------------------------------------------------------------------------\n\nfunction buildInputGuardrails(\n guardrails: GuardrailHooks,\n): unknown[] {\n return [\n {\n name: \"contract-runtime-guardrail\",\n execute: async ({ input }: { input: unknown }) => {\n const inputStr = typeof input === \"string\"\n ? input\n : JSON.stringify(input);\n\n const results = guardrails.runChecks({ command: inputStr });\n const blocking = results.filter((r) => !r.passed && r.action === \"block\");\n\n return {\n outputInfo: { results },\n tripwireTriggered: blocking.length > 0,\n };\n },\n },\n ];\n}\n\n// ---------------------------------------------------------------------------\n// Config\n// ---------------------------------------------------------------------------\n\nexport interface OpenAIAgentsSdkAdapterConfig {\n /** Model identifier (e.g. \"gpt-4.1\", \"gpt-5.5\"). Uses SDK default if omitted. */\n model?: string;\n /** Maximum conversation turns per run. Defaults to 10 (SDK default). */\n maxTurns?: number;\n /** Runtime guardrail hooks enforced via InputGuardrail. */\n guardrailHooks?: GuardrailHooks;\n /** Additional tools to pass to the Agent. */\n tools?: unknown[];\n /** Agent name prefix. Defaults to \"contract-agent\". */\n agentName?: string;\n /** AbortSignal for cancellation. */\n signal?: AbortSignal;\n /** Prompt caching configuration. Enabled by default. */\n cacheConfig?: CacheConfig;\n}\n\n// ---------------------------------------------------------------------------\n// Adapter\n// ---------------------------------------------------------------------------\n\nexport class OpenAIAgentsSdkAdapter implements SdkAdapter {\n private model: string | undefined;\n private maxTurns: number | undefined;\n private guardrailHooks: GuardrailHooks | undefined;\n private tools: unknown[] | undefined;\n private agentName: string;\n private signal: AbortSignal | undefined;\n private cacheConfig: CacheConfig;\n private lastResponseId: string | null = null;\n private lastAgent: AgentInstance | null = null;\n private lastMemoryRef: MemoryRef | null = null;\n\n private AgentClass: AgentConstructor | null = null;\n private runFn: RunFn | null = null;\n private streamRunFn: StreamRunFn | null = null;\n\n constructor(config: OpenAIAgentsSdkAdapterConfig = {}) {\n this.model = config.model;\n this.maxTurns = config.maxTurns;\n this.guardrailHooks = config.guardrailHooks;\n this.tools = config.tools;\n this.agentName = config.agentName ?? \"contract-agent\";\n this.signal = config.signal;\n this.cacheConfig = config.cacheConfig ?? { enabled: true };\n }\n\n // -------------------------------------------------------------------------\n // Internal helpers\n // -------------------------------------------------------------------------\n\n private async resolveSdk(): Promise<{ Agent: AgentConstructor; run: RunFn; streamRun?: StreamRunFn }> {\n if (this.AgentClass && this.runFn) {\n return { Agent: this.AgentClass, run: this.runFn, streamRun: this.streamRunFn ?? undefined };\n }\n\n const sdk = (await import(\"@openai/agents\")) as unknown as {\n Agent: AgentConstructor;\n run: RunFn;\n };\n this.AgentClass = sdk.Agent;\n this.runFn = sdk.run;\n return { Agent: this.AgentClass, run: this.runFn };\n }\n\n private createAgent(\n Agent: AgentConstructor,\n instructions: string,\n _readonly: boolean,\n agents?: CandidateAgent[],\n extraTools?: unknown[],\n ): AgentInstance {\n const opts: AgentOptions = {\n name: this.agentName,\n instructions,\n };\n\n if (this.model) opts.model = this.model;\n const mergedTools = [\n ...(this.tools ?? []),\n ...(extraTools ?? []),\n ];\n if (mergedTools.length > 0) opts.tools = mergedTools;\n\n if (this.guardrailHooks) {\n opts.inputGuardrails = buildInputGuardrails(this.guardrailHooks);\n }\n\n // Register candidate sub-agents as handoffs so the main agent can delegate\n // to them (model B, LLM-internal routing). Each becomes its own Agent.\n if (agents && agents.length > 0) {\n opts.handoffs = agents.map((a) => {\n const subOpts: AgentOptions = { name: a.name, instructions: a.prompt };\n if (a.model) subOpts.model = a.model;\n if (a.tools) subOpts.tools = a.tools;\n return new Agent(subOpts);\n });\n }\n\n return new Agent(opts);\n }\n\n private buildRunOptions(previousResponseId?: string): RunOptions {\n const opts: RunOptions = {};\n\n if (this.maxTurns !== undefined) opts.maxTurns = this.maxTurns;\n if (this.signal) opts.signal = this.signal;\n if (previousResponseId) opts.previousResponseId = previousResponseId;\n\n return opts;\n }\n\n private extractOutput(result: RunResult): string {\n if (typeof result.finalOutput === \"string\") {\n return result.finalOutput;\n }\n\n if (result.finalOutput !== undefined && result.finalOutput !== null) {\n return JSON.stringify(result.finalOutput, null, 2);\n }\n\n if (result.newItems) {\n const textParts: string[] = [];\n for (const item of result.newItems) {\n if (item.type === \"message_output_item\" || item.type === \"text\") {\n const rawItem = item.rawItem as Record<string, unknown> | undefined;\n if (rawItem?.content) {\n const content = rawItem.content;\n if (Array.isArray(content)) {\n for (const part of content) {\n if (typeof part === \"object\" && part !== null && \"text\" in part) {\n textParts.push((part as { text: string }).text);\n }\n }\n } else if (typeof content === \"string\") {\n textParts.push(content);\n }\n }\n }\n }\n if (textParts.length > 0) return textParts.join(\"\\n\");\n }\n\n return \"\";\n }\n\n private async runWithProgress(\n agent: AgentInstance,\n input: string,\n runOpts: RunOptions,\n onProgress?: (event: AgentProgressEvent) => void,\n ): Promise<RunResult> {\n const { run, streamRun } = await this.resolveSdk();\n\n if (!onProgress || !streamRun) {\n return run(agent, input, runOpts);\n }\n\n const streamResult = await streamRun(agent, input, runOpts);\n for await (const event of streamResult.streamEvents()) {\n emitProgressFromOpenAIEvent(event, onProgress);\n }\n return streamResult;\n }\n\n // -------------------------------------------------------------------------\n // SdkAdapter interface\n // -------------------------------------------------------------------------\n\n private async resolveLibraryTools(\n libraryTools?: LibraryToolRegistry,\n ): Promise<unknown[]> {\n if (!libraryTools || libraryTools.getAll().length === 0) return [];\n try {\n return await buildOpenAIFunctionTools(libraryTools);\n } catch {\n return [];\n }\n }\n\n async send(\n prompt: string,\n options: AdapterSendOptions,\n ): Promise<string> {\n this.lastResponseId = null;\n this.lastAgent = null;\n this.lastMemoryRef = null;\n\n const { Agent } = await this.resolveSdk();\n const split = options.splitPrompt;\n let instructions: string;\n let runInput: string;\n\n if (split && this.cacheConfig.enabled !== false) {\n instructions = split.system.join(\"\\n\\n---\\n\\n\");\n runInput = split.user;\n } else {\n instructions = prompt;\n runInput = prompt;\n }\n\n const libTools = await this.resolveLibraryTools(options.libraryTools);\n const agent = this.createAgent(Agent, instructions, options.readonly, options.agents, libTools);\n const runOpts = this.buildRunOptions();\n const result = await this.runWithProgress(agent, runInput, runOpts, options.onProgress);\n\n this.lastResponseId = result.lastResponseId ?? null;\n this.lastAgent = agent;\n this.lastMemoryRef = this.lastResponseId ? {\n id: this.lastResponseId,\n provider: \"openai-responses\",\n compat: \"openai-agents-sdk@0.10\",\n created_at: new Date().toISOString(),\n } : null;\n\n return this.extractOutput(result);\n }\n\n async followUp(message: string): Promise<string> {\n if (!this.lastResponseId) {\n throw new Error(\"followUp() called before send() — no active session\");\n }\n\n const { run } = await this.resolveSdk();\n const agent = this.lastAgent!;\n const runOpts = this.buildRunOptions(this.lastResponseId);\n\n const result = await run(agent, message, runOpts);\n\n this.lastResponseId = result.lastResponseId ?? this.lastResponseId;\n\n return this.extractOutput(result);\n }\n\n async sendExecution(request: AgentExecutionRequest): Promise<string> {\n this.lastResponseId = null;\n this.lastAgent = null;\n this.lastMemoryRef = null;\n\n const { Agent } = await this.resolveSdk();\n const split = request.splitPrompt;\n let instructions: string;\n let runInput: string;\n\n if (split && this.cacheConfig.enabled !== false) {\n instructions = split.system.join(\"\\n\\n---\\n\\n\");\n runInput = split.user;\n } else {\n instructions = request.prompt;\n runInput = request.prompt;\n }\n\n const agents = request.options.agents ?? request.agents;\n const libTools = await this.resolveLibraryTools(request.options.libraryTools);\n const agent = this.createAgent(Agent, instructions, request.options.readonly, agents, libTools);\n const runOpts = this.buildRunOptions(request.memoryRef?.id);\n const result = await this.runWithProgress(agent, runInput, runOpts, request.options.onProgress);\n\n this.lastResponseId = result.lastResponseId ?? null;\n this.lastAgent = agent;\n this.lastMemoryRef = this.lastResponseId ? {\n id: this.lastResponseId,\n provider: \"openai-responses\",\n compat: \"openai-agents-sdk@0.10\",\n created_at: new Date().toISOString(),\n parent_run_id: request.memoryRef?.id,\n } : null;\n\n return this.extractOutput(result);\n }\n\n getLastMemoryRef(): MemoryRef | null {\n return this.lastMemoryRef;\n }\n\n isCompatible(compat: string): boolean {\n return compat.startsWith(\"openai-agents-sdk@\");\n }\n\n // -------------------------------------------------------------------------\n // Test support\n // -------------------------------------------------------------------------\n\n /**\n * Inject custom Agent constructor and run function for testing.\n * Bypasses the dynamic import of @openai/agents.\n */\n static withRunFn(\n AgentClass: AgentConstructor,\n runFn: RunFn,\n config?: OpenAIAgentsSdkAdapterConfig,\n streamRunFn?: StreamRunFn,\n ): OpenAIAgentsSdkAdapter {\n const adapter = new OpenAIAgentsSdkAdapter(config);\n adapter.AgentClass = AgentClass;\n adapter.runFn = runFn;\n adapter.streamRunFn = streamRunFn ?? null;\n return adapter;\n }\n}\n\n// ---------------------------------------------------------------------------\n// Progress event mapping\n// ---------------------------------------------------------------------------\n\nfunction emitProgressFromOpenAIEvent(\n event: RunStreamEvent,\n onProgress: (event: AgentProgressEvent) => void,\n): void {\n switch (event.type) {\n case \"tool_called\":\n if (event.item?.toolName) {\n onProgress({ type: \"tool_use\", tool_name: event.item.toolName });\n }\n break;\n case \"tool_output\":\n onProgress({ type: \"tool_result\" });\n break;\n case \"reasoning_item_created\":\n onProgress({ type: \"text\", message: \"Reasoning...\" });\n break;\n case \"handoff_occurred\":\n if (event.item?.agent?.name) {\n onProgress({ type: \"status\", message: `Handoff to ${event.item.agent.name}` });\n }\n break;\n default:\n break;\n }\n}\n"],"mappings":";;;;;AAoGA,SAAS,qBACP,YACW;AACX,SAAO;AAAA,IACL;AAAA,MACE,MAAM;AAAA,MACN,SAAS,OAAO,EAAE,MAAM,MAA0B;AAChD,cAAM,WAAW,OAAO,UAAU,WAC9B,QACA,KAAK,UAAU,KAAK;AAExB,cAAM,UAAU,WAAW,UAAU,EAAE,SAAS,SAAS,CAAC;AAC1D,cAAM,WAAW,QAAQ,OAAO,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,WAAW,OAAO;AAExE,eAAO;AAAA,UACL,YAAY,EAAE,QAAQ;AAAA,UACtB,mBAAmB,SAAS,SAAS;AAAA,QACvC;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AA2BO,IAAM,yBAAN,MAAM,wBAA6C;AAAA,EAChD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,iBAAgC;AAAA,EAChC,YAAkC;AAAA,EAClC,gBAAkC;AAAA,EAElC,aAAsC;AAAA,EACtC,QAAsB;AAAA,EACtB,cAAkC;AAAA,EAE1C,YAAY,SAAuC,CAAC,GAAG;AACrD,SAAK,QAAQ,OAAO;AACpB,SAAK,WAAW,OAAO;AACvB,SAAK,iBAAiB,OAAO;AAC7B,SAAK,QAAQ,OAAO;AACpB,SAAK,YAAY,OAAO,aAAa;AACrC,SAAK,SAAS,OAAO;AACrB,SAAK,cAAc,OAAO,eAAe,EAAE,SAAS,KAAK;AAAA,EAC3D;AAAA;AAAA;AAAA;AAAA,EAMA,MAAc,aAAwF;AACpG,QAAI,KAAK,cAAc,KAAK,OAAO;AACjC,aAAO,EAAE,OAAO,KAAK,YAAY,KAAK,KAAK,OAAO,WAAW,KAAK,eAAe,OAAU;AAAA,IAC7F;AAEA,UAAM,MAAO,MAAM,OAAO,gBAAgB;AAI1C,SAAK,aAAa,IAAI;AACtB,SAAK,QAAQ,IAAI;AACjB,WAAO,EAAE,OAAO,KAAK,YAAY,KAAK,KAAK,MAAM;AAAA,EACnD;AAAA,EAEQ,YACN,OACA,cACA,WACA,QACA,YACe;AACf,UAAM,OAAqB;AAAA,MACzB,MAAM,KAAK;AAAA,MACX;AAAA,IACF;AAEA,QAAI,KAAK,MAAO,MAAK,QAAQ,KAAK;AAClC,UAAM,cAAc;AAAA,MAClB,GAAI,KAAK,SAAS,CAAC;AAAA,MACnB,GAAI,cAAc,CAAC;AAAA,IACrB;AACA,QAAI,YAAY,SAAS,EAAG,MAAK,QAAQ;AAEzC,QAAI,KAAK,gBAAgB;AACvB,WAAK,kBAAkB,qBAAqB,KAAK,cAAc;AAAA,IACjE;AAIA,QAAI,UAAU,OAAO,SAAS,GAAG;AAC/B,WAAK,WAAW,OAAO,IAAI,CAAC,MAAM;AAChC,cAAM,UAAwB,EAAE,MAAM,EAAE,MAAM,cAAc,EAAE,OAAO;AACrE,YAAI,EAAE,MAAO,SAAQ,QAAQ,EAAE;AAC/B,YAAI,EAAE,MAAO,SAAQ,QAAQ,EAAE;AAC/B,eAAO,IAAI,MAAM,OAAO;AAAA,MAC1B,CAAC;AAAA,IACH;AAEA,WAAO,IAAI,MAAM,IAAI;AAAA,EACvB;AAAA,EAEQ,gBAAgB,oBAAyC;AAC/D,UAAM,OAAmB,CAAC;AAE1B,QAAI,KAAK,aAAa,OAAW,MAAK,WAAW,KAAK;AACtD,QAAI,KAAK,OAAQ,MAAK,SAAS,KAAK;AACpC,QAAI,mBAAoB,MAAK,qBAAqB;AAElD,WAAO;AAAA,EACT;AAAA,EAEQ,cAAc,QAA2B;AAC/C,QAAI,OAAO,OAAO,gBAAgB,UAAU;AAC1C,aAAO,OAAO;AAAA,IAChB;AAEA,QAAI,OAAO,gBAAgB,UAAa,OAAO,gBAAgB,MAAM;AACnE,aAAO,KAAK,UAAU,OAAO,aAAa,MAAM,CAAC;AAAA,IACnD;AAEA,QAAI,OAAO,UAAU;AACnB,YAAM,YAAsB,CAAC;AAC7B,iBAAW,QAAQ,OAAO,UAAU;AAClC,YAAI,KAAK,SAAS,yBAAyB,KAAK,SAAS,QAAQ;AAC/D,gBAAM,UAAU,KAAK;AACrB,cAAI,SAAS,SAAS;AACpB,kBAAM,UAAU,QAAQ;AACxB,gBAAI,MAAM,QAAQ,OAAO,GAAG;AAC1B,yBAAW,QAAQ,SAAS;AAC1B,oBAAI,OAAO,SAAS,YAAY,SAAS,QAAQ,UAAU,MAAM;AAC/D,4BAAU,KAAM,KAA0B,IAAI;AAAA,gBAChD;AAAA,cACF;AAAA,YACF,WAAW,OAAO,YAAY,UAAU;AACtC,wBAAU,KAAK,OAAO;AAAA,YACxB;AAAA,UACF;AAAA,QACF;AAAA,MACF;AACA,UAAI,UAAU,SAAS,EAAG,QAAO,UAAU,KAAK,IAAI;AAAA,IACtD;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,MAAc,gBACZ,OACA,OACA,SACA,YACoB;AACpB,UAAM,EAAE,KAAK,UAAU,IAAI,MAAM,KAAK,WAAW;AAEjD,QAAI,CAAC,cAAc,CAAC,WAAW;AAC7B,aAAO,IAAI,OAAO,OAAO,OAAO;AAAA,IAClC;AAEA,UAAM,eAAe,MAAM,UAAU,OAAO,OAAO,OAAO;AAC1D,qBAAiB,SAAS,aAAa,aAAa,GAAG;AACrD,kCAA4B,OAAO,UAAU;AAAA,IAC/C;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAMA,MAAc,oBACZ,cACoB;AACpB,QAAI,CAAC,gBAAgB,aAAa,OAAO,EAAE,WAAW,EAAG,QAAO,CAAC;AACjE,QAAI;AACF,aAAO,MAAM,yBAAyB,YAAY;AAAA,IACpD,QAAQ;AACN,aAAO,CAAC;AAAA,IACV;AAAA,EACF;AAAA,EAEA,MAAM,KACJ,QACA,SACiB;AACjB,SAAK,iBAAiB;AACtB,SAAK,YAAY;AACjB,SAAK,gBAAgB;AAErB,UAAM,EAAE,MAAM,IAAI,MAAM,KAAK,WAAW;AACxC,UAAM,QAAQ,QAAQ;AACtB,QAAI;AACJ,QAAI;AAEJ,QAAI,SAAS,KAAK,YAAY,YAAY,OAAO;AAC/C,qBAAe,MAAM,OAAO,KAAK,aAAa;AAC9C,iBAAW,MAAM;AAAA,IACnB,OAAO;AACL,qBAAe;AACf,iBAAW;AAAA,IACb;AAEA,UAAM,WAAW,MAAM,KAAK,oBAAoB,QAAQ,YAAY;AACpE,UAAM,QAAQ,KAAK,YAAY,OAAO,cAAc,QAAQ,UAAU,QAAQ,QAAQ,QAAQ;AAC9F,UAAM,UAAU,KAAK,gBAAgB;AACrC,UAAM,SAAS,MAAM,KAAK,gBAAgB,OAAO,UAAU,SAAS,QAAQ,UAAU;AAEtF,SAAK,iBAAiB,OAAO,kBAAkB;AAC/C,SAAK,YAAY;AACjB,SAAK,gBAAgB,KAAK,iBAAiB;AAAA,MACzC,IAAI,KAAK;AAAA,MACT,UAAU;AAAA,MACV,QAAQ;AAAA,MACR,aAAY,oBAAI,KAAK,GAAE,YAAY;AAAA,IACrC,IAAI;AAEJ,WAAO,KAAK,cAAc,MAAM;AAAA,EAClC;AAAA,EAEA,MAAM,SAAS,SAAkC;AAC/C,QAAI,CAAC,KAAK,gBAAgB;AACxB,YAAM,IAAI,MAAM,0DAAqD;AAAA,IACvE;AAEA,UAAM,EAAE,IAAI,IAAI,MAAM,KAAK,WAAW;AACtC,UAAM,QAAQ,KAAK;AACnB,UAAM,UAAU,KAAK,gBAAgB,KAAK,cAAc;AAExD,UAAM,SAAS,MAAM,IAAI,OAAO,SAAS,OAAO;AAEhD,SAAK,iBAAiB,OAAO,kBAAkB,KAAK;AAEpD,WAAO,KAAK,cAAc,MAAM;AAAA,EAClC;AAAA,EAEA,MAAM,cAAc,SAAiD;AACnE,SAAK,iBAAiB;AACtB,SAAK,YAAY;AACjB,SAAK,gBAAgB;AAErB,UAAM,EAAE,MAAM,IAAI,MAAM,KAAK,WAAW;AACxC,UAAM,QAAQ,QAAQ;AACtB,QAAI;AACJ,QAAI;AAEJ,QAAI,SAAS,KAAK,YAAY,YAAY,OAAO;AAC/C,qBAAe,MAAM,OAAO,KAAK,aAAa;AAC9C,iBAAW,MAAM;AAAA,IACnB,OAAO;AACL,qBAAe,QAAQ;AACvB,iBAAW,QAAQ;AAAA,IACrB;AAEA,UAAM,SAAS,QAAQ,QAAQ,UAAU,QAAQ;AACjD,UAAM,WAAW,MAAM,KAAK,oBAAoB,QAAQ,QAAQ,YAAY;AAC5E,UAAM,QAAQ,KAAK,YAAY,OAAO,cAAc,QAAQ,QAAQ,UAAU,QAAQ,QAAQ;AAC9F,UAAM,UAAU,KAAK,gBAAgB,QAAQ,WAAW,EAAE;AAC1D,UAAM,SAAS,MAAM,KAAK,gBAAgB,OAAO,UAAU,SAAS,QAAQ,QAAQ,UAAU;AAE9F,SAAK,iBAAiB,OAAO,kBAAkB;AAC/C,SAAK,YAAY;AACjB,SAAK,gBAAgB,KAAK,iBAAiB;AAAA,MACzC,IAAI,KAAK;AAAA,MACT,UAAU;AAAA,MACV,QAAQ;AAAA,MACR,aAAY,oBAAI,KAAK,GAAE,YAAY;AAAA,MACnC,eAAe,QAAQ,WAAW;AAAA,IACpC,IAAI;AAEJ,WAAO,KAAK,cAAc,MAAM;AAAA,EAClC;AAAA,EAEA,mBAAqC;AACnC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,aAAa,QAAyB;AACpC,WAAO,OAAO,WAAW,oBAAoB;AAAA,EAC/C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,OAAO,UACL,YACA,OACA,QACA,aACwB;AACxB,UAAM,UAAU,IAAI,wBAAuB,MAAM;AACjD,YAAQ,aAAa;AACrB,YAAQ,QAAQ;AAChB,YAAQ,cAAc,eAAe;AACrC,WAAO;AAAA,EACT;AACF;AAMA,SAAS,4BACP,OACA,YACM;AACN,UAAQ,MAAM,MAAM;AAAA,IAClB,KAAK;AACH,UAAI,MAAM,MAAM,UAAU;AACxB,mBAAW,EAAE,MAAM,YAAY,WAAW,MAAM,KAAK,SAAS,CAAC;AAAA,MACjE;AACA;AAAA,IACF,KAAK;AACH,iBAAW,EAAE,MAAM,cAAc,CAAC;AAClC;AAAA,IACF,KAAK;AACH,iBAAW,EAAE,MAAM,QAAQ,SAAS,eAAe,CAAC;AACpD;AAAA,IACF,KAAK;AACH,UAAI,MAAM,MAAM,OAAO,MAAM;AAC3B,mBAAW,EAAE,MAAM,UAAU,SAAS,cAAc,MAAM,KAAK,MAAM,IAAI,GAAG,CAAC;AAAA,MAC/E;AACA;AAAA,IACF;AACE;AAAA,EACJ;AACF;","names":[]}
|
|
1
|
+
{"version":3,"sources":["../../src/adapters/openai-agents-sdk.ts"],"sourcesContent":["/**\n * OpenAI Agents SDK Adapter — implements SdkAdapter for @openai/agents\n *\n * Uses the `run()` function (or `Runner`) from the OpenAI Agents SDK to execute\n * an Agent with instructions derived from the contract prompt.\n *\n * Supports:\n * - send() — create a fresh Agent + run() and return finalOutput\n * - followUp() — resume the same conversation via previousResponseId\n * - sendExecution() — rich path using full contract context\n *\n * The SDK's `run()` returns a RunResult with `finalOutput` (the model's final\n * text output) and `lastResponseId` for continuation.\n *\n * GuardrailHooks are mapped to the SDK's InputGuardrail 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 { buildOpenAIFunctionTools } from \"../lib/library-tool-sdk.js\";\n\n// ---------------------------------------------------------------------------\n// Duck-typed SDK types (avoid hard compile-time dependency on @openai/agents)\n// ---------------------------------------------------------------------------\n\ntype RunResult = {\n finalOutput?: string | unknown;\n lastResponseId?: string;\n newItems?: Array<{\n type: string;\n rawItem?: { type?: string; content?: unknown };\n [key: string]: unknown;\n }>;\n state?: unknown;\n usage?: {\n input_tokens?: number;\n output_tokens?: number;\n total_tokens?: number;\n };\n};\n\ntype AgentOptions = {\n name: string;\n model?: string;\n instructions: string | ((ctx: unknown) => string);\n tools?: unknown[];\n inputGuardrails?: unknown[];\n outputType?: unknown;\n [key: string]: unknown;\n};\n\ntype AgentInstance = AgentOptions & { [key: string]: unknown };\n\ntype RunOptions = {\n maxTurns?: number | null;\n signal?: AbortSignal;\n previousResponseId?: string;\n stream?: boolean;\n context?: unknown;\n [key: string]: unknown;\n};\n\ntype AgentConstructor = new (options: AgentOptions) => AgentInstance;\n\ntype RunFn = (\n agent: AgentInstance,\n input: string | unknown[],\n options?: RunOptions,\n) => Promise<RunResult>;\n\ntype StreamedRunResult = RunResult & {\n streamEvents(): AsyncIterable<RunStreamEvent>;\n};\n\ntype RunStreamEvent = {\n type: string;\n name?: string;\n item?: {\n type: string;\n toolName?: string;\n toolInput?: unknown;\n agent?: { name?: string };\n [key: string]: unknown;\n };\n [key: string]: unknown;\n};\n\ntype StreamRunFn = (\n agent: AgentInstance,\n input: string | unknown[],\n options?: RunOptions,\n) => Promise<StreamedRunResult>;\n\n// ---------------------------------------------------------------------------\n// Guardrail bridge\n// ---------------------------------------------------------------------------\n\nfunction buildInputGuardrails(\n guardrails: GuardrailHooks,\n): unknown[] {\n return [\n {\n name: \"contract-runtime-guardrail\",\n execute: async ({ input }: { input: unknown }) => {\n const inputStr = typeof input === \"string\"\n ? input\n : JSON.stringify(input);\n\n const results = guardrails.runChecks({ command: inputStr });\n const blocking = results.filter((r) => !r.passed && r.action === \"block\");\n\n return {\n outputInfo: { results },\n tripwireTriggered: blocking.length > 0,\n };\n },\n },\n ];\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 OpenAIAgentsSdkAdapterConfig {\n /** Model identifier (e.g. \"gpt-4.1\", \"gpt-5.5\"). Uses SDK default if omitted. */\n model?: string;\n /** Maximum conversation turns per run. Defaults to 10 (SDK default). */\n maxTurns?: number;\n /** Runtime guardrail hooks enforced via InputGuardrail. */\n guardrailHooks?: GuardrailHooks;\n /** Additional tools to pass to the Agent. */\n tools?: unknown[];\n /** Agent name prefix. Defaults to \"contract-agent\". */\n agentName?: string;\n /** AbortSignal for cancellation. */\n signal?: AbortSignal;\n /** Prompt caching configuration. Enabled by default. */\n cacheConfig?: CacheConfig;\n}\n\n// ---------------------------------------------------------------------------\n// Adapter\n// ---------------------------------------------------------------------------\n\nexport class OpenAIAgentsSdkAdapter implements SdkAdapter {\n private model: string | undefined;\n private maxTurns: number | undefined;\n private guardrailHooks: GuardrailHooks | undefined;\n private tools: unknown[] | undefined;\n private agentName: string;\n private signal: AbortSignal | undefined;\n private cacheConfig: CacheConfig;\n private lastResponseId: string | null = null;\n private lastAgent: AgentInstance | null = null;\n private lastMemoryRef: MemoryRef | null = null;\n private lastTokenUsage: TokenUsage | null = null;\n\n private AgentClass: AgentConstructor | null = null;\n private runFn: RunFn | null = null;\n private streamRunFn: StreamRunFn | null = null;\n\n constructor(config: OpenAIAgentsSdkAdapterConfig = {}) {\n this.model = config.model;\n this.maxTurns = config.maxTurns;\n this.guardrailHooks = config.guardrailHooks;\n this.tools = config.tools;\n this.agentName = config.agentName ?? \"contract-agent\";\n this.signal = config.signal;\n this.cacheConfig = config.cacheConfig ?? { enabled: true };\n }\n\n // -------------------------------------------------------------------------\n // Internal helpers\n // -------------------------------------------------------------------------\n\n private async resolveSdk(): Promise<{ Agent: AgentConstructor; run: RunFn; streamRun?: StreamRunFn }> {\n if (this.AgentClass && this.runFn) {\n return { Agent: this.AgentClass, run: this.runFn, streamRun: this.streamRunFn ?? undefined };\n }\n\n const sdk = (await import(\"@openai/agents\")) as unknown as {\n Agent: AgentConstructor;\n run: RunFn;\n };\n this.AgentClass = sdk.Agent;\n this.runFn = sdk.run;\n return { Agent: this.AgentClass, run: this.runFn };\n }\n\n private createAgent(\n Agent: AgentConstructor,\n instructions: string,\n _readonly: boolean,\n agents?: CandidateAgent[],\n extraTools?: unknown[],\n ): AgentInstance {\n const opts: AgentOptions = {\n name: this.agentName,\n instructions,\n };\n\n if (this.model) opts.model = this.model;\n const mergedTools = [\n ...(this.tools ?? []),\n ...(extraTools ?? []),\n ];\n if (mergedTools.length > 0) opts.tools = mergedTools;\n\n if (this.guardrailHooks) {\n opts.inputGuardrails = buildInputGuardrails(this.guardrailHooks);\n }\n\n // Register candidate sub-agents as handoffs so the main agent can delegate\n // to them (model B, LLM-internal routing). Each becomes its own Agent.\n if (agents && agents.length > 0) {\n opts.handoffs = agents.map((a) => {\n const subOpts: AgentOptions = { name: a.name, instructions: a.prompt };\n if (a.model) subOpts.model = a.model;\n if (a.tools) subOpts.tools = a.tools;\n return new Agent(subOpts);\n });\n }\n\n return new Agent(opts);\n }\n\n private buildRunOptions(previousResponseId?: string): RunOptions {\n const opts: RunOptions = {};\n\n if (this.maxTurns !== undefined) opts.maxTurns = this.maxTurns;\n if (this.signal) opts.signal = this.signal;\n if (previousResponseId) opts.previousResponseId = previousResponseId;\n\n return opts;\n }\n\n private extractOutput(result: RunResult): string {\n if (typeof result.finalOutput === \"string\") {\n return result.finalOutput;\n }\n\n if (result.finalOutput !== undefined && result.finalOutput !== null) {\n return JSON.stringify(result.finalOutput, null, 2);\n }\n\n if (result.newItems) {\n const textParts: string[] = [];\n for (const item of result.newItems) {\n if (item.type === \"message_output_item\" || item.type === \"text\") {\n const rawItem = item.rawItem as Record<string, unknown> | undefined;\n if (rawItem?.content) {\n const content = rawItem.content;\n if (Array.isArray(content)) {\n for (const part of content) {\n if (typeof part === \"object\" && part !== null && \"text\" in part) {\n textParts.push((part as { text: string }).text);\n }\n }\n } else if (typeof content === \"string\") {\n textParts.push(content);\n }\n }\n }\n }\n if (textParts.length > 0) return textParts.join(\"\\n\");\n }\n\n return \"\";\n }\n\n private async runWithProgress(\n agent: AgentInstance,\n input: string,\n runOpts: RunOptions,\n onProgress?: (event: AgentProgressEvent) => void,\n observer?: ObserverEmitFn,\n parentSpanId?: string,\n ): Promise<RunResult> {\n const { run, streamRun } = await this.resolveSdk();\n\n if (!onProgress && !observer) {\n if (!streamRun) return run(agent, input, runOpts);\n const streamResult = await streamRun(agent, input, runOpts);\n for await (const _event of streamResult.streamEvents()) {\n // drain stream without processing\n }\n return streamResult;\n }\n\n if (!streamRun) {\n return run(agent, input, runOpts);\n }\n\n const streamResult = await streamRun(agent, input, runOpts);\n\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 event of streamResult.streamEvents()) {\n if (onProgress) emitProgressFromOpenAIEvent(event, onProgress);\n\n switch (event.type) {\n case \"reasoning_item_created\": {\n closePendingToolSpans();\n closeCurrentTurn();\n turnNumber++;\n toolCallsInTurn = 0;\n currentTurnStart = Date.now();\n currentTurnSpanId = emitLlmTurnOpen(observer, parentSpanId, turnNumber, this.model);\n break;\n }\n case \"tool_called\": {\n if (!currentTurnSpanId) {\n turnNumber++;\n toolCallsInTurn = 0;\n currentTurnStart = Date.now();\n currentTurnSpanId = emitLlmTurnOpen(observer, parentSpanId, turnNumber, this.model);\n }\n toolCallsInTurn++;\n const toolName = event.item?.toolName ?? \"unknown\";\n const summary = truncateInputSummary(event.item?.toolInput);\n const toolSpanId = emitToolExecOpen(observer, currentTurnSpanId, toolName, summary, turnNumber);\n if (toolSpanId) {\n openToolSpans.push({ spanId: toolSpanId, toolName, startMs: Date.now() });\n }\n break;\n }\n case \"tool_output\": {\n if (openToolSpans.length > 0) {\n const ts = openToolSpans.shift()!;\n emitToolExecClose(observer, ts.spanId, ts.toolName, Date.now() - ts.startMs);\n }\n break;\n }\n case \"handoff_occurred\": {\n closePendingToolSpans();\n closeCurrentTurn();\n break;\n }\n default:\n break;\n }\n }\n\n closePendingToolSpans();\n closeCurrentTurn();\n\n return streamResult;\n }\n\n // -------------------------------------------------------------------------\n // SdkAdapter interface\n // -------------------------------------------------------------------------\n\n private async resolveLibraryTools(\n libraryTools?: LibraryToolRegistry,\n ): Promise<unknown[]> {\n if (!libraryTools || libraryTools.getAll().length === 0) return [];\n try {\n return await buildOpenAIFunctionTools(libraryTools);\n } catch {\n return [];\n }\n }\n\n async send(\n prompt: string,\n options: AdapterSendOptions,\n ): Promise<string> {\n this.lastResponseId = null;\n this.lastAgent = null;\n this.lastMemoryRef = null;\n this.lastTokenUsage = null;\n\n const { Agent } = await this.resolveSdk();\n const split = options.splitPrompt;\n let instructions: string;\n let runInput: string;\n\n if (split && this.cacheConfig.enabled !== false) {\n instructions = split.system.join(\"\\n\\n---\\n\\n\");\n runInput = split.user;\n } else {\n instructions = prompt;\n runInput = prompt;\n }\n\n const libTools = await this.resolveLibraryTools(options.libraryTools);\n const agent = this.createAgent(Agent, instructions, options.readonly, options.agents, libTools);\n const runOpts = this.buildRunOptions();\n const result = await this.runWithProgress(agent, runInput, runOpts, options.onProgress, options.observer, options.parentSpanId);\n\n this.lastResponseId = result.lastResponseId ?? null;\n this.lastAgent = agent;\n this.lastTokenUsage = this.extractTokenUsage(result);\n this.lastMemoryRef = this.lastResponseId ? {\n id: this.lastResponseId,\n provider: \"openai-responses\",\n compat: \"openai-agents-sdk@0.10\",\n created_at: new Date().toISOString(),\n } : null;\n\n return this.extractOutput(result);\n }\n\n async followUp(message: string): Promise<string> {\n if (!this.lastResponseId) {\n throw new Error(\"followUp() called before send() — no active session\");\n }\n\n const { run } = await this.resolveSdk();\n const agent = this.lastAgent!;\n const runOpts = this.buildRunOptions(this.lastResponseId);\n\n const result = await run(agent, message, runOpts);\n\n this.lastResponseId = result.lastResponseId ?? this.lastResponseId;\n\n return this.extractOutput(result);\n }\n\n async sendExecution(request: AgentExecutionRequest): Promise<string> {\n this.lastResponseId = null;\n this.lastAgent = null;\n this.lastMemoryRef = null;\n this.lastTokenUsage = null;\n\n const { Agent } = await this.resolveSdk();\n const split = request.splitPrompt;\n let instructions: string;\n let runInput: string;\n\n if (split && this.cacheConfig.enabled !== false) {\n instructions = split.system.join(\"\\n\\n---\\n\\n\");\n runInput = split.user;\n } else {\n instructions = request.prompt;\n runInput = request.prompt;\n }\n\n const agents = request.options.agents ?? request.agents;\n const libTools = await this.resolveLibraryTools(request.options.libraryTools);\n const agent = this.createAgent(Agent, instructions, request.options.readonly, agents, libTools);\n const runOpts = this.buildRunOptions(request.memoryRef?.id);\n const result = await this.runWithProgress(agent, runInput, runOpts, request.options.onProgress, request.options.observer, request.options.parentSpanId);\n\n this.lastResponseId = result.lastResponseId ?? null;\n this.lastAgent = agent;\n this.lastTokenUsage = this.extractTokenUsage(result);\n this.lastMemoryRef = this.lastResponseId ? {\n id: this.lastResponseId,\n provider: \"openai-responses\",\n compat: \"openai-agents-sdk@0.10\",\n created_at: new Date().toISOString(),\n parent_run_id: request.memoryRef?.id,\n } : null;\n\n return this.extractOutput(result);\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(\"openai-agents-sdk@\");\n }\n\n private extractTokenUsage(result: RunResult): TokenUsage | null {\n const usage = result.usage;\n if (!usage) return null;\n if (typeof usage.input_tokens !== \"number\" && typeof usage.output_tokens !== \"number\") return null;\n const inputTokens = usage.input_tokens ?? 0;\n const outputTokens = usage.output_tokens ?? 0;\n return {\n inputTokens,\n outputTokens,\n totalTokens: usage.total_tokens ?? (inputTokens + outputTokens),\n };\n }\n\n // -------------------------------------------------------------------------\n // Test support\n // -------------------------------------------------------------------------\n\n /**\n * Inject custom Agent constructor and run function for testing.\n * Bypasses the dynamic import of @openai/agents.\n */\n static withRunFn(\n AgentClass: AgentConstructor,\n runFn: RunFn,\n config?: OpenAIAgentsSdkAdapterConfig,\n streamRunFn?: StreamRunFn,\n ): OpenAIAgentsSdkAdapter {\n const adapter = new OpenAIAgentsSdkAdapter(config);\n adapter.AgentClass = AgentClass;\n adapter.runFn = runFn;\n adapter.streamRunFn = streamRunFn ?? null;\n return adapter;\n }\n}\n\n// ---------------------------------------------------------------------------\n// Progress event mapping\n// ---------------------------------------------------------------------------\n\nfunction emitProgressFromOpenAIEvent(\n event: RunStreamEvent,\n onProgress: (event: AgentProgressEvent) => void,\n): void {\n switch (event.type) {\n case \"tool_called\":\n if (event.item?.toolName) {\n onProgress({ type: \"tool_use\", tool_name: event.item.toolName });\n }\n break;\n case \"tool_output\":\n onProgress({ type: \"tool_result\" });\n break;\n case \"reasoning_item_created\":\n onProgress({ type: \"text\", message: \"Reasoning...\" });\n break;\n case \"handoff_occurred\":\n if (event.item?.agent?.name) {\n onProgress({ type: \"status\", message: `Handoff to ${event.item.agent.name}` });\n }\n break;\n default:\n break;\n }\n}\n"],"mappings":"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","names":["streamResult"]}
|
|
@@ -1,5 +1,17 @@
|
|
|
1
1
|
// src/lib/observability-bridge.ts
|
|
2
2
|
import { generateId } from "@aaac/observability";
|
|
3
|
+
var OBSERVABILITY_ENV_VARS = {
|
|
4
|
+
sessionId: "AAAC_SESSION_ID",
|
|
5
|
+
traceId: "AAAC_TRACE_ID",
|
|
6
|
+
runId: "AAAC_RUN_ID"
|
|
7
|
+
};
|
|
8
|
+
function buildObservabilityEnv(ids, baseEnv = process.env) {
|
|
9
|
+
const env = { ...baseEnv };
|
|
10
|
+
if (ids.sessionId) env[OBSERVABILITY_ENV_VARS.sessionId] = ids.sessionId;
|
|
11
|
+
if (ids.traceId) env[OBSERVABILITY_ENV_VARS.traceId] = ids.traceId;
|
|
12
|
+
if (ids.runId) env[OBSERVABILITY_ENV_VARS.runId] = ids.runId;
|
|
13
|
+
return env;
|
|
14
|
+
}
|
|
3
15
|
function createExecutionEnvelope(params = {}) {
|
|
4
16
|
const envelope = {
|
|
5
17
|
run_id: generateId(),
|
|
@@ -282,7 +294,96 @@ function emitToolchainClose(observer, spanId, toolchainId, operation, durationMs
|
|
|
282
294
|
});
|
|
283
295
|
}
|
|
284
296
|
|
|
297
|
+
// src/lib/library-tool-sdk.ts
|
|
298
|
+
function buildSdkFunctionTools(registry) {
|
|
299
|
+
return registry.getAll().map((def) => ({
|
|
300
|
+
name: def.toolId,
|
|
301
|
+
description: def.description,
|
|
302
|
+
inputSchema: def.inputSchema ?? { type: "object", properties: {} },
|
|
303
|
+
handler: async (args) => {
|
|
304
|
+
const result = await registry.execute(def.toolId, args);
|
|
305
|
+
return typeof result === "string" ? result : JSON.stringify(result);
|
|
306
|
+
}
|
|
307
|
+
}));
|
|
308
|
+
}
|
|
309
|
+
async function buildClaudeMcpServer(registry) {
|
|
310
|
+
const tools = buildSdkFunctionTools(registry);
|
|
311
|
+
if (tools.length === 0) return void 0;
|
|
312
|
+
const sdk = await import("@anthropic-ai/claude-agent-sdk");
|
|
313
|
+
const toolFn = sdk.tool;
|
|
314
|
+
const createServer = sdk.createSdkMcpServer;
|
|
315
|
+
if (!toolFn || !createServer) return void 0;
|
|
316
|
+
const { z } = await import("zod");
|
|
317
|
+
const { jsonSchemaToZod } = await import("./schema-converter-LACA7P4O.js");
|
|
318
|
+
const sdkTools = tools.map(
|
|
319
|
+
(t) => toolFn({
|
|
320
|
+
name: t.name,
|
|
321
|
+
description: t.description,
|
|
322
|
+
inputSchema: jsonSchemaToZod(t.inputSchema),
|
|
323
|
+
execute: async (args) => {
|
|
324
|
+
return t.handler(
|
|
325
|
+
args ?? {}
|
|
326
|
+
);
|
|
327
|
+
}
|
|
328
|
+
})
|
|
329
|
+
);
|
|
330
|
+
return createServer(sdkTools);
|
|
331
|
+
}
|
|
332
|
+
async function buildOpenAIFunctionTools(registry) {
|
|
333
|
+
const tools = buildSdkFunctionTools(registry);
|
|
334
|
+
if (tools.length === 0) return [];
|
|
335
|
+
try {
|
|
336
|
+
const sdk = await import("@openai/agents");
|
|
337
|
+
const toolFn = sdk.tool;
|
|
338
|
+
if (toolFn) {
|
|
339
|
+
const { jsonSchemaToZod } = await import("./schema-converter-LACA7P4O.js");
|
|
340
|
+
return tools.map(
|
|
341
|
+
(t) => toolFn({
|
|
342
|
+
name: t.name,
|
|
343
|
+
description: t.description,
|
|
344
|
+
parameters: jsonSchemaToZod(t.inputSchema),
|
|
345
|
+
execute: async (_ctx, args) => {
|
|
346
|
+
return t.handler(
|
|
347
|
+
args ?? {}
|
|
348
|
+
);
|
|
349
|
+
}
|
|
350
|
+
})
|
|
351
|
+
);
|
|
352
|
+
}
|
|
353
|
+
} catch {
|
|
354
|
+
}
|
|
355
|
+
return tools.map((t) => ({
|
|
356
|
+
type: "function",
|
|
357
|
+
function: {
|
|
358
|
+
name: t.name,
|
|
359
|
+
description: t.description,
|
|
360
|
+
parameters: t.inputSchema
|
|
361
|
+
},
|
|
362
|
+
execute: async (args) => {
|
|
363
|
+
return t.handler(
|
|
364
|
+
args ?? {}
|
|
365
|
+
);
|
|
366
|
+
}
|
|
367
|
+
}));
|
|
368
|
+
}
|
|
369
|
+
async function buildAdkFunctionTools(registry) {
|
|
370
|
+
const tools = buildSdkFunctionTools(registry);
|
|
371
|
+
if (tools.length === 0) return [];
|
|
372
|
+
return tools.map((t) => ({
|
|
373
|
+
name: t.name,
|
|
374
|
+
description: t.description,
|
|
375
|
+
inputSchema: t.inputSchema,
|
|
376
|
+
execute: async (args) => {
|
|
377
|
+
return t.handler(
|
|
378
|
+
args ?? {}
|
|
379
|
+
);
|
|
380
|
+
}
|
|
381
|
+
}));
|
|
382
|
+
}
|
|
383
|
+
|
|
285
384
|
export {
|
|
385
|
+
OBSERVABILITY_ENV_VARS,
|
|
386
|
+
buildObservabilityEnv,
|
|
286
387
|
createExecutionEnvelope,
|
|
287
388
|
emitSessionOpen,
|
|
288
389
|
emitSessionClose,
|
|
@@ -296,6 +397,10 @@ export {
|
|
|
296
397
|
emitToolExecOpen,
|
|
297
398
|
emitToolExecClose,
|
|
298
399
|
emitToolchainOpen,
|
|
299
|
-
emitToolchainClose
|
|
400
|
+
emitToolchainClose,
|
|
401
|
+
buildSdkFunctionTools,
|
|
402
|
+
buildClaudeMcpServer,
|
|
403
|
+
buildOpenAIFunctionTools,
|
|
404
|
+
buildAdkFunctionTools
|
|
300
405
|
};
|
|
301
|
-
//# sourceMappingURL=chunk-
|
|
406
|
+
//# sourceMappingURL=chunk-LWMRO7RR.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/lib/observability-bridge.ts","../src/lib/library-tool-sdk.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// ── Observability env propagation (git-hook correlation, #115) ─────────────────\n\n/** Observability correlation ids propagated to spawned subprocesses. */\nexport interface ObservabilityIds {\n /** Agent-axis session id (= the session/run envelope run_id). */\n sessionId?: string;\n /** Distributed trace id, when available. */\n traceId?: string;\n /** Execution run id (ExecutionEnvelope.run_id). */\n runId?: string;\n}\n\n/** Environment variable names read by `.cursor/hooks/observ-record.sh`. */\nexport const OBSERVABILITY_ENV_VARS = {\n sessionId: \"AAAC_SESSION_ID\",\n traceId: \"AAAC_TRACE_ID\",\n runId: \"AAAC_RUN_ID\",\n} as const;\n\n/**\n * Build a subprocess environment that propagates the active observability\n * correlation ids as AAAC_SESSION_ID / AAAC_TRACE_ID / AAAC_RUN_ID.\n *\n * When @aaac/runtime spawns `git` (directly via a toolchain check, or\n * indirectly through an agent shell), the git `post-commit` hook runs\n * `.cursor/hooks/observ-record.sh`, whose highest-priority session_id source is\n * `$AAAC_SESSION_ID` (#115). Propagating these ids lets the promotion.commit /\n * promotion.file events emitted by the hook correlate to the originating agent\n * session.\n *\n * Returns a shallow clone of {@link baseEnv}; only ids that are defined and\n * non-empty are set, so the child never inherits empty/stale values.\n */\nexport function buildObservabilityEnv(\n ids: ObservabilityIds,\n baseEnv: NodeJS.ProcessEnv = process.env,\n): NodeJS.ProcessEnv {\n const env: NodeJS.ProcessEnv = { ...baseEnv };\n if (ids.sessionId) env[OBSERVABILITY_ENV_VARS.sessionId] = ids.sessionId;\n if (ids.traceId) env[OBSERVABILITY_ENV_VARS.traceId] = ids.traceId;\n if (ids.runId) env[OBSERVABILITY_ENV_VARS.runId] = ids.runId;\n return env;\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","/**\n * Library Tool → SDK Function Tool conversion.\n *\n * Converts LibraryToolDefinition entries into SDK-native function tools\n * that each adapter can register with its respective LLM SDK.\n *\n * Each adapter receives tools in its native format:\n * - Claude Agent SDK: MCP tool via createSdkMcpServer + tool()\n * - OpenAI Agents SDK: function tool object\n * - Google ADK: FunctionDeclaration tool\n */\n\nimport type { LibraryToolRegistry } from \"./library-tool-binding.js\";\n\n/**\n * Adapter-agnostic function tool descriptor. Adapters convert this\n * into their SDK-specific tool format.\n */\nexport interface SdkFunctionTool {\n name: string;\n description: string;\n inputSchema: Record<string, unknown>;\n handler: (args: Record<string, unknown>) => Promise<string>;\n}\n\n/**\n * Build adapter-agnostic function tool descriptors from a LibraryToolRegistry.\n * Each tool's handler calls registry.execute() and serialises the result.\n */\nexport function buildSdkFunctionTools(\n registry: LibraryToolRegistry,\n): SdkFunctionTool[] {\n return registry.getAll().map((def) => ({\n name: def.toolId,\n description: def.description,\n inputSchema: def.inputSchema ?? { type: \"object\", properties: {} },\n handler: async (args: Record<string, unknown>): Promise<string> => {\n const result = await registry.execute(def.toolId, args);\n return typeof result === \"string\" ? result : JSON.stringify(result);\n },\n }));\n}\n\n// ---------------------------------------------------------------------------\n// Claude Agent SDK — MCP server wrapping\n// ---------------------------------------------------------------------------\n\n/**\n * Build Claude MCP server tools from a LibraryToolRegistry.\n *\n * Dynamically imports `tool` and `createSdkMcpServer` from the\n * Claude Agent SDK. Returns an MCP server instance to be passed\n * to query() via options.mcpServers.\n *\n * Returns undefined if no tools or if SDK functions are unavailable.\n */\nexport async function buildClaudeMcpServer(\n registry: LibraryToolRegistry,\n): Promise<unknown | undefined> {\n const tools = buildSdkFunctionTools(registry);\n if (tools.length === 0) return undefined;\n\n const sdk = (await import(\"@anthropic-ai/claude-agent-sdk\")) as Record<\n string,\n unknown\n >;\n const toolFn = sdk.tool as\n | ((def: Record<string, unknown>) => unknown)\n | undefined;\n const createServer = sdk.createSdkMcpServer as\n | ((tools: unknown[]) => unknown)\n | undefined;\n\n if (!toolFn || !createServer) return undefined;\n\n const { z } = await import(\"zod\");\n const { jsonSchemaToZod } = await import(\"./schema-converter.js\");\n\n const sdkTools = tools.map((t) =>\n toolFn({\n name: t.name,\n description: t.description,\n inputSchema: jsonSchemaToZod(t.inputSchema),\n execute: async (args: unknown) => {\n return t.handler(\n (args ?? {}) as Record<string, unknown>,\n );\n },\n }),\n );\n\n return createServer(sdkTools);\n}\n\n// ---------------------------------------------------------------------------\n// OpenAI Agents SDK — function tool objects\n// ---------------------------------------------------------------------------\n\n/**\n * Build OpenAI Agents SDK function tool objects from a LibraryToolRegistry.\n *\n * Dynamically imports `tool` from @openai/agents if available.\n * Falls back to a raw function-tool shape that the SDK also accepts.\n */\nexport async function buildOpenAIFunctionTools(\n registry: LibraryToolRegistry,\n): Promise<unknown[]> {\n const tools = buildSdkFunctionTools(registry);\n if (tools.length === 0) return [];\n\n try {\n const sdk = (await import(\"@openai/agents\")) as Record<string, unknown>;\n const toolFn = sdk.tool as\n | ((def: Record<string, unknown>) => unknown)\n | undefined;\n\n if (toolFn) {\n const { jsonSchemaToZod } = await import(\"./schema-converter.js\");\n return tools.map((t) =>\n toolFn({\n name: t.name,\n description: t.description,\n parameters: jsonSchemaToZod(t.inputSchema),\n execute: async (_ctx: unknown, args: unknown) => {\n return t.handler(\n (args ?? {}) as Record<string, unknown>,\n );\n },\n }),\n );\n }\n } catch {\n // SDK not available; fall through to raw format\n }\n\n return tools.map((t) => ({\n type: \"function\" as const,\n function: {\n name: t.name,\n description: t.description,\n parameters: t.inputSchema,\n },\n execute: async (args: unknown) => {\n return t.handler(\n (args ?? {}) as Record<string, unknown>,\n );\n },\n }));\n}\n\n// ---------------------------------------------------------------------------\n// Google ADK — function tool objects\n// ---------------------------------------------------------------------------\n\n/**\n * Build Google ADK function tool objects from a LibraryToolRegistry.\n *\n * ADK's LlmAgent accepts tools as objects with a FunctionDeclaration shape\n * or as callable tool instances. We produce lightweight callable wrappers.\n */\nexport async function buildAdkFunctionTools(\n registry: LibraryToolRegistry,\n): Promise<unknown[]> {\n const tools = buildSdkFunctionTools(registry);\n if (tools.length === 0) return [];\n\n return tools.map((t) => ({\n name: t.name,\n description: t.description,\n inputSchema: t.inputSchema,\n execute: async (args: unknown) => {\n return t.handler(\n (args ?? {}) as Record<string, unknown>,\n );\n },\n }));\n}\n"],"mappings":";AAkBA,SAAS,kBAAkB;AA+BpB,IAAM,yBAAyB;AAAA,EACpC,WAAW;AAAA,EACX,SAAS;AAAA,EACT,OAAO;AACT;AAgBO,SAAS,sBACd,KACA,UAA6B,QAAQ,KAClB;AACnB,QAAM,MAAyB,EAAE,GAAG,QAAQ;AAC5C,MAAI,IAAI,UAAW,KAAI,uBAAuB,SAAS,IAAI,IAAI;AAC/D,MAAI,IAAI,QAAS,KAAI,uBAAuB,OAAO,IAAI,IAAI;AAC3D,MAAI,IAAI,MAAO,KAAI,uBAAuB,KAAK,IAAI,IAAI;AACvD,SAAO;AACT;AAoCO,SAAS,wBAAwB,SAAyB,CAAC,GAAsB;AACtF,QAAM,WAA8B;AAAA,IAClC,QAAQ,WAAW;AAAA,IACnB,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,EACpC;AACA,MAAI,OAAO,gBAAgB,OAAW,UAAS,gBAAgB,OAAO;AACtE,MAAI,OAAO,gBAAgB,OAAW,UAAS,eAAe,OAAO;AACrE,MAAI,OAAO,cAAc,OAAW,UAAS,aAAa,OAAO;AACjE,MAAI,OAAO,YAAY,OAAW,UAAS,WAAW,OAAO;AAC7D,MAAI,OAAO,oBAAoB,OAAW,UAAS,mBAAmB,OAAO;AAC7E,MAAI,OAAO,YAAY,OAAW,UAAS,UAAU,OAAO;AAC5D,MAAI,OAAO,UAAU,OAAW,UAAS,QAAQ,OAAO;AACxD,MAAI,OAAO,mBAAmB,OAAW,UAAS,mBAAmB,OAAO;AAC5E,SAAO;AACT;AAKA,SAAS,MAAM,MAAwE;AACrF,QAAM,MAAiC,CAAC;AACxC,aAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,IAAI,GAAG;AACzC,QAAI,MAAM,UAAa,MAAM,GAAI,KAAI,CAAC,IAAI;AAAA,EAC5C;AACA,SAAO;AACT;AAGA,SAAS,WAAW,MAA0D;AAC5E,QAAM,MAAiC,CAAC;AACxC,QAAM,KAAK,KAAK;AAChB,MAAI,MAAM,OAAO,OAAO,UAAU;AAChC,UAAM,IAAI;AACV,QAAI,OAAO,EAAE,iBAAiB,SAAU,KAAI,mBAAmB,IAAI,EAAE;AACrE,QAAI,OAAO,EAAE,kBAAkB,SAAU,KAAI,oBAAoB,IAAI,EAAE;AACvE,QAAI,OAAO,EAAE,iBAAiB,SAAU,KAAI,mBAAmB,IAAI,EAAE;AACrE,QAAI,OAAO,EAAE,4BAA4B,SAAU,KAAI,wBAAwB,IAAI,EAAE;AACrF,QAAI,OAAO,EAAE,gCAAgC,SAAU,KAAI,4BAA4B,IAAI,EAAE;AAAA,EAC/F;AACA,MAAI,OAAO,KAAK,aAAa,SAAU,KAAI,UAAU,IAAI,KAAK;AAC9D,SAAO;AACT;AAeO,SAAS,gBACd,UACA,UACA,YACoB;AACpB,MAAI,CAAC,SAAU,QAAO;AAEtB,QAAM,SAAS,SAAS;AACxB,WAAS;AAAA,IACP,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,WAAW;AAAA,IACX;AAAA,IACA,cAAc,SAAS;AAAA,IACvB,YAAY,MAAM;AAAA,MAChB,MAAM;AAAA,MACN,oBAAoB,SAAS;AAAA,MAC7B,gBAAgB,SAAS;AAAA,MACzB,eAAe;AAAA,MACf,sBAAsB,SAAS;AAAA,MAC/B,eAAe,SAAS;AAAA,MACxB,SAAS,SAAS;AAAA,MAClB,kBAAkB,SAAS;AAAA,IAC7B,CAAC;AAAA,EACH,CAAC;AACD,SAAO;AACT;AAUO,SAAS,iBACd,UACA,QACA,UACA,YACA,QACA,cACM;AACN,MAAI,CAAC,SAAU;AAEf,QAAM,YACJ,SAAS,qBAAqB,WAAW,SAAS,kBAAkB,IAAI,CAAC;AAE3E,WAAS;AAAA,IACP,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,WAAW;AAAA,IACX;AAAA,IACA,YAAY;AAAA,MACV,GAAG,MAAM;AAAA,QACP,MAAM;AAAA,QACN,oBAAoB,SAAS;AAAA,QAC7B,6BAA6B;AAAA,QAC7B,gBAAgB;AAAA,QAChB,eAAe;AAAA,MACjB,CAAC;AAAA,MACD,GAAG;AAAA,IACL;AAAA,EACF,CAAC;AACH;AAeO,SAAS,iBACd,UACA,UACA,cACA,QACA,WACoB;AACpB,MAAI,CAAC,SAAU,QAAO;AAEtB,QAAM,SAAS,SAAS;AACxB,WAAS;AAAA,IACP,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,WAAW;AAAA,IACX;AAAA,IACA;AAAA,IACA,YAAY,MAAM;AAAA,MAChB,MAAM;AAAA,MACN,cAAc;AAAA,MACd,cAAc;AAAA,MACd,WAAW;AAAA,MACX,gBAAgB,SAAS;AAAA,MACzB,uBAAuB,SAAS;AAAA,MAChC,eAAe,SAAS;AAAA,MACxB,SAAS,SAAS;AAAA,MAClB,sBAAsB,SAAS;AAAA,MAC/B,oBAAoB,SAAS;AAAA,MAC7B,kBAAkB,SAAS;AAAA,IAC7B,CAAC;AAAA,EACH,CAAC;AACD,SAAO;AACT;AAWO,SAAS,kBACd,UACA,QACA,UACA,YACA,QACA,WACA,cACM;AACN,MAAI,CAAC,SAAU;AAEf,QAAM,YACJ,SAAS,qBAAqB,WAAW,SAAS,kBAAkB,IAAI,CAAC;AAE3E,WAAS;AAAA,IACP,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,WAAW;AAAA,IACX;AAAA,IACA,YAAY;AAAA,MACV,GAAG,MAAM;AAAA,QACP,MAAM;AAAA,QACN,cAAc;AAAA,QACd,gBAAgB;AAAA,QAChB,qBAAqB;AAAA,QACrB,eAAe;AAAA,MACjB,CAAC;AAAA,MACD,GAAG;AAAA,IACL;AAAA,EACF,CAAC;AACH;AAUO,SAAS,kBACd,UACA,cACA,gBACA,QACA,iBACA,eACoB;AACpB,MAAI,CAAC,SAAU,QAAO;AAEtB,QAAM,SAAS,WAAW;AAC1B,WAAS;AAAA,IACP,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,WAAW;AAAA,IACX;AAAA,IACA;AAAA,IACA,YAAY,MAAM;AAAA,MAChB,MAAM;AAAA,MACN,iBAAiB;AAAA,MACjB,oBAAoB;AAAA,MACpB,sBAAsB;AAAA,MACtB,2BAA2B;AAAA,IAC7B,CAAC;AAAA,EACH,CAAC;AACD,SAAO;AACT;AAKO,SAAS,mBACd,UACA,QACA,gBACA,iBACA,SACA,YACA,kBACM;AACN,MAAI,CAAC,SAAU;AAEf,WAAS;AAAA,IACP,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,WAAW;AAAA,IACX;AAAA,IACA,YAAY,MAAM;AAAA,MAChB,MAAM;AAAA,MACN,iBAAiB;AAAA,MACjB,sBAAsB;AAAA,MACtB,oBAAoB;AAAA,MACpB,wBAAwB;AAAA,MACxB,8BAA8B;AAAA,IAChC,CAAC;AAAA,EACH,CAAC;AACH;AAKO,SAAS,oBACd,UACA,cACA,gBACA,iBACA,iBACM;AACN,MAAI,CAAC,SAAU;AAEf,QAAM,SAAS,WAAW;AAC1B,WAAS;AAAA,IACP,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,WAAW;AAAA,IACX;AAAA,IACA;AAAA,IACA,YAAY,MAAM;AAAA,MAChB,MAAM;AAAA,MACN,iBAAiB;AAAA,MACjB,6BAA6B;AAAA,MAC7B,6BAA6B;AAAA,IAC/B,CAAC;AAAA,EACH,CAAC;AACH;AAkBO,SAAS,gBACd,UACA,cACA,YACA,OACA,WACoB;AACpB,MAAI,CAAC,SAAU,QAAO;AAEtB,QAAM,SAAS,WAAW;AAC1B,WAAS;AAAA,IACP,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,WAAW;AAAA,IACX;AAAA,IACA;AAAA,IACA,YAAY,MAAM;AAAA,MAChB,MAAM;AAAA,MACN,mBAAmB;AAAA,MACnB,aAAa;AAAA,MACb,mBAAmB,WAAW;AAAA,MAC9B,wBAAwB,WAAW;AAAA,IACrC,CAAC;AAAA,EACH,CAAC;AACD,SAAO;AACT;AAKO,SAAS,iBACd,UACA,QACA,YACA,YACAA,aAMM;AACN,MAAI,CAAC,SAAU;AAEf,WAAS;AAAA,IACP,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,WAAW;AAAA,IACX;AAAA,IACA,YAAY,MAAM;AAAA,MAChB,MAAM;AAAA,MACN,mBAAmB;AAAA,MACnB,mBAAmB;AAAA,MACnB,oBAAoBA,aAAY;AAAA,MAChC,qBAAqBA,aAAY;AAAA,MACjC,wBAAwBA,aAAY;AAAA,MACpC,wBAAwBA,aAAY;AAAA,IACtC,CAAC;AAAA,EACH,CAAC;AACH;AAUO,SAAS,iBACd,UACA,cACA,UACA,cACA,YACoB;AACpB,MAAI,CAAC,SAAU,QAAO;AAEtB,QAAM,SAAS,WAAW;AAC1B,WAAS;AAAA,IACP,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,WAAW;AAAA,IACX;AAAA,IACA;AAAA,IACA,YAAY,MAAM;AAAA,MAChB,MAAM;AAAA,MACN,aAAa;AAAA,MACb,sBAAsB;AAAA,MACtB,mBAAmB;AAAA,IACrB,CAAC;AAAA,EACH,CAAC;AACD,SAAO;AACT;AAKO,SAAS,kBACd,UACA,QACA,UACA,YACM;AACN,MAAI,CAAC,SAAU;AAEf,WAAS;AAAA,IACP,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,WAAW;AAAA,IACX;AAAA,IACA,YAAY,MAAM;AAAA,MAChB,MAAM;AAAA,MACN,aAAa;AAAA,MACb,oBAAoB;AAAA,IACtB,CAAC;AAAA,EACH,CAAC;AACH;AAUO,SAAS,kBACd,UACA,cACA,aACA,WACA,aACA,aACoB;AACpB,MAAI,CAAC,SAAU,QAAO;AAEtB,QAAM,SAAS,WAAW;AAC1B,WAAS;AAAA,IACP,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,WAAW;AAAA,IACX;AAAA,IACA;AAAA,IACA,YAAY,MAAM;AAAA,MAChB,MAAM;AAAA,MACN,gBAAgB;AAAA,MAChB,uBAAuB;AAAA,MACvB,0BAA0B,YAAY,KAAK,GAAG;AAAA,MAC9C,sBAAsB;AAAA,IACxB,CAAC;AAAA,EACH,CAAC;AACD,SAAO;AACT;AAKO,SAAS,mBACd,UACA,QACA,aACA,WACA,YACA,QACA,cACM;AACN,MAAI,CAAC,SAAU;AAEf,WAAS;AAAA,IACP,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,WAAW;AAAA,IACX;AAAA,IACA,YAAY,MAAM;AAAA,MAChB,MAAM;AAAA,MACN,gBAAgB;AAAA,MAChB,uBAAuB;AAAA,MACvB,oBAAoB;AAAA,MACpB,yBAAyB;AAAA,MACzB,GAAI,eAAe,EAAE,mBAAmB,aAAa,IAAI,CAAC;AAAA,IAC5D,CAAC;AAAA,EACH,CAAC;AACH;;;AC5kBO,SAAS,sBACd,UACmB;AACnB,SAAO,SAAS,OAAO,EAAE,IAAI,CAAC,SAAS;AAAA,IACrC,MAAM,IAAI;AAAA,IACV,aAAa,IAAI;AAAA,IACjB,aAAa,IAAI,eAAe,EAAE,MAAM,UAAU,YAAY,CAAC,EAAE;AAAA,IACjE,SAAS,OAAO,SAAmD;AACjE,YAAM,SAAS,MAAM,SAAS,QAAQ,IAAI,QAAQ,IAAI;AACtD,aAAO,OAAO,WAAW,WAAW,SAAS,KAAK,UAAU,MAAM;AAAA,IACpE;AAAA,EACF,EAAE;AACJ;AAeA,eAAsB,qBACpB,UAC8B;AAC9B,QAAM,QAAQ,sBAAsB,QAAQ;AAC5C,MAAI,MAAM,WAAW,EAAG,QAAO;AAE/B,QAAM,MAAO,MAAM,OAAO,gCAAgC;AAI1D,QAAM,SAAS,IAAI;AAGnB,QAAM,eAAe,IAAI;AAIzB,MAAI,CAAC,UAAU,CAAC,aAAc,QAAO;AAErC,QAAM,EAAE,EAAE,IAAI,MAAM,OAAO,KAAK;AAChC,QAAM,EAAE,gBAAgB,IAAI,MAAM,OAAO,gCAAuB;AAEhE,QAAM,WAAW,MAAM;AAAA,IAAI,CAAC,MAC1B,OAAO;AAAA,MACL,MAAM,EAAE;AAAA,MACR,aAAa,EAAE;AAAA,MACf,aAAa,gBAAgB,EAAE,WAAW;AAAA,MAC1C,SAAS,OAAO,SAAkB;AAChC,eAAO,EAAE;AAAA,UACN,QAAQ,CAAC;AAAA,QACZ;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACH;AAEA,SAAO,aAAa,QAAQ;AAC9B;AAYA,eAAsB,yBACpB,UACoB;AACpB,QAAM,QAAQ,sBAAsB,QAAQ;AAC5C,MAAI,MAAM,WAAW,EAAG,QAAO,CAAC;AAEhC,MAAI;AACF,UAAM,MAAO,MAAM,OAAO,gBAAgB;AAC1C,UAAM,SAAS,IAAI;AAInB,QAAI,QAAQ;AACV,YAAM,EAAE,gBAAgB,IAAI,MAAM,OAAO,gCAAuB;AAChE,aAAO,MAAM;AAAA,QAAI,CAAC,MAChB,OAAO;AAAA,UACL,MAAM,EAAE;AAAA,UACR,aAAa,EAAE;AAAA,UACf,YAAY,gBAAgB,EAAE,WAAW;AAAA,UACzC,SAAS,OAAO,MAAe,SAAkB;AAC/C,mBAAO,EAAE;AAAA,cACN,QAAQ,CAAC;AAAA,YACZ;AAAA,UACF;AAAA,QACF,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF,QAAQ;AAAA,EAER;AAEA,SAAO,MAAM,IAAI,CAAC,OAAO;AAAA,IACvB,MAAM;AAAA,IACN,UAAU;AAAA,MACR,MAAM,EAAE;AAAA,MACR,aAAa,EAAE;AAAA,MACf,YAAY,EAAE;AAAA,IAChB;AAAA,IACA,SAAS,OAAO,SAAkB;AAChC,aAAO,EAAE;AAAA,QACN,QAAQ,CAAC;AAAA,MACZ;AAAA,IACF;AAAA,EACF,EAAE;AACJ;AAYA,eAAsB,sBACpB,UACoB;AACpB,QAAM,QAAQ,sBAAsB,QAAQ;AAC5C,MAAI,MAAM,WAAW,EAAG,QAAO,CAAC;AAEhC,SAAO,MAAM,IAAI,CAAC,OAAO;AAAA,IACvB,MAAM,EAAE;AAAA,IACR,aAAa,EAAE;AAAA,IACf,aAAa,EAAE;AAAA,IACf,SAAS,OAAO,SAAkB;AAChC,aAAO,EAAE;AAAA,QACN,QAAQ,CAAC;AAAA,MACZ;AAAA,IACF;AAAA,EACF,EAAE;AACJ;","names":["tokenAttrs"]}
|
package/dist/index.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
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-
|
|
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
|
|
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-CVh7Luc_.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 OBSERVABILITY_ENV_VARS, _ as ObservabilityIds, $ as ReceiveSpec, a0 as ResolvedModel, a1 as RetryDecision, a2 as SdkAdapterFactory, a3 as SplitPrompt, a4 as TaskRunOptions, T as TokenUsage, a5 as ToolchainCheckResult, a6 as ToolchainManifest, a7 as ToolchainManifestSchema, a8 as WorkflowContractLike, a9 as WorkflowInvocation, aa as WorkflowRunOptions, ab as WorkflowStep, ac as buildCandidateAgents, ad as buildGateEvaluationPrompt, ae as buildObservabilityEnv, af as buildPerAgentGuardrails, ag as buildRetryFollowUp, ah as buildSdkFunctionTools, ai as buildSplitTaskPrompt, aj as buildTaskPrompt, ak as createExecutionEnvelope, al as createGuardrailHooks, am as createGuardrailHooksForAgent, an as createGuardrailHooksFromRules, ao as createLibraryToolRegistry, ap as createModelResolver, aq as createRegistryFromSdkTools, ar as deriveToolchainsForAgents, as as emitIterationClose, at as emitIterationMetric, au as emitIterationOpen, av as emitLlmTurnClose, aw as emitLlmTurnOpen, ax as emitSessionClose, ay as emitSessionOpen, az as emitSubagentClose, aA as emitSubagentOpen, aB as emitToolExecClose, aC as emitToolExecOpen, aD as emitToolchainClose, aE as emitToolchainOpen, aF as extractStructuredResult, aG as getBlockingViolations, aH as getEffectiveGuardrailIds, aI as getGuardrailRulesForAgent, aJ as getWarnings, aK as guardrailContextToRuleData, aL as hasBlockingViolation, aM as parseGateEvaluationResponse, aN as renderAgentSystemPrompt, aO as runTask, aP as runToolchainChecks, aQ as runWorkflow, aR as zodSchemaToPromptDescription, aS as zodSchemaToYamlExample } from './task-runner-CVh7Luc_.js';
|
|
3
3
|
import { z } from 'zod';
|
|
4
4
|
import { OperationIR, ComponentIR } from '@aaac/contracts';
|
|
5
5
|
import { ResolvedConfig } from './generator/index.js';
|
package/dist/index.js
CHANGED
|
@@ -9,6 +9,9 @@ import {
|
|
|
9
9
|
pluginRegistry
|
|
10
10
|
} from "./chunk-GZCEEIXQ.js";
|
|
11
11
|
import {
|
|
12
|
+
OBSERVABILITY_ENV_VARS,
|
|
13
|
+
buildObservabilityEnv,
|
|
14
|
+
buildSdkFunctionTools,
|
|
12
15
|
createExecutionEnvelope,
|
|
13
16
|
emitIterationClose,
|
|
14
17
|
emitIterationMetric,
|
|
@@ -23,10 +26,7 @@ import {
|
|
|
23
26
|
emitToolExecOpen,
|
|
24
27
|
emitToolchainClose,
|
|
25
28
|
emitToolchainOpen
|
|
26
|
-
} from "./chunk-
|
|
27
|
-
import {
|
|
28
|
-
buildSdkFunctionTools
|
|
29
|
-
} from "./chunk-LONLL3K2.js";
|
|
29
|
+
} from "./chunk-LWMRO7RR.js";
|
|
30
30
|
import {
|
|
31
31
|
buildGuardrailContext,
|
|
32
32
|
loadProjectConfig
|
|
@@ -1082,11 +1082,13 @@ async function tryManifestFastPath(toolchainId, cwd) {
|
|
|
1082
1082
|
return null;
|
|
1083
1083
|
}
|
|
1084
1084
|
}
|
|
1085
|
-
async function executeCheck(command, cwd) {
|
|
1085
|
+
async function executeCheck(command, cwd, observabilityIds) {
|
|
1086
|
+
const env = observabilityIds ? buildObservabilityEnv(observabilityIds) : void 0;
|
|
1086
1087
|
try {
|
|
1087
1088
|
const { stdout, stderr } = await execFileAsync("sh", ["-c", command], {
|
|
1088
1089
|
cwd,
|
|
1089
|
-
timeout: SUBPROCESS_TIMEOUT_MS
|
|
1090
|
+
timeout: SUBPROCESS_TIMEOUT_MS,
|
|
1091
|
+
...env ? { env } : {}
|
|
1090
1092
|
});
|
|
1091
1093
|
return { exitCode: 0, stdout, stderr };
|
|
1092
1094
|
} catch (err) {
|
|
@@ -1112,7 +1114,8 @@ async function runToolchainChecks(options) {
|
|
|
1112
1114
|
defaultAction,
|
|
1113
1115
|
observer,
|
|
1114
1116
|
parentSpanId,
|
|
1115
|
-
componentId
|
|
1117
|
+
componentId,
|
|
1118
|
+
observabilityIds
|
|
1116
1119
|
} = options;
|
|
1117
1120
|
const cwd = workingDir ?? process.cwd();
|
|
1118
1121
|
const contracts = await parseToolchainFile(toolchainsPath);
|
|
@@ -1139,7 +1142,7 @@ async function runToolchainChecks(options) {
|
|
|
1139
1142
|
result = fastResult;
|
|
1140
1143
|
} else {
|
|
1141
1144
|
try {
|
|
1142
|
-
const { exitCode, stderr } = await executeCheck(command, cwd);
|
|
1145
|
+
const { exitCode, stderr } = await executeCheck(command, cwd, observabilityIds);
|
|
1143
1146
|
const durationMs = Math.round(performance.now() - start);
|
|
1144
1147
|
result = {
|
|
1145
1148
|
toolchainId,
|
|
@@ -1639,7 +1642,13 @@ ${JSON.stringify(data, null, 2)}`;
|
|
|
1639
1642
|
await runToolchainChecks({
|
|
1640
1643
|
...options.toolchain,
|
|
1641
1644
|
observer: options.observer,
|
|
1642
|
-
parentSpanId: sessionSpanId
|
|
1645
|
+
parentSpanId: sessionSpanId,
|
|
1646
|
+
// Propagate session correlation to any git spawned by a check (#115):
|
|
1647
|
+
// the session id is the agent.session run_id (== sessionSpanId).
|
|
1648
|
+
observabilityIds: {
|
|
1649
|
+
sessionId: sessionSpanId ?? sessionEnvelope.run_id,
|
|
1650
|
+
runId: sessionEnvelope.run_id
|
|
1651
|
+
}
|
|
1643
1652
|
});
|
|
1644
1653
|
} catch {
|
|
1645
1654
|
}
|
|
@@ -3677,6 +3686,7 @@ export {
|
|
|
3677
3686
|
DslValidationError,
|
|
3678
3687
|
FileMemoryStore,
|
|
3679
3688
|
InMemoryStore,
|
|
3689
|
+
OBSERVABILITY_ENV_VARS,
|
|
3680
3690
|
PROJECT_CONFIG_FILENAME,
|
|
3681
3691
|
PluginRegistry,
|
|
3682
3692
|
ToolchainManifestSchema,
|
|
@@ -3685,6 +3695,7 @@ export {
|
|
|
3685
3695
|
buildGateEvaluationPrompt,
|
|
3686
3696
|
buildGuardrailRulesFromDsl,
|
|
3687
3697
|
buildNavigationContext,
|
|
3698
|
+
buildObservabilityEnv,
|
|
3688
3699
|
buildPerAgentGuardrails,
|
|
3689
3700
|
buildRegistriesFromDsl,
|
|
3690
3701
|
buildRetryFollowUp,
|