@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.
@@ -1,6 +1,10 @@
1
1
  import {
2
- buildOpenAIFunctionTools
3
- } from "../chunk-LONLL3K2.js";
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 || !streamRun) {
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":"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","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-3HT5BILT.js.map
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":"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","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-Bl3SZfft.js';
2
- export { s as AdapterOrFactory, A as AdapterSendOptions, a as AgentExecutionRequest, t as AgentProgressEvent, B as BoundResolveOptions, u as BoundResolver, C as CacheConfig, v as CandidateAgent, w as ConvergenceEnvelope, x as ConvergenceEnvelopePayload, E as EnvelopeParams, y as EvaluateStep, z as GateStep, F as GuardrailCheckFunctions, I as GuardrailRule, J as HookContext, K as InMemoryStore, N as InnerSpanOptions, Q as ModelAwareSdkAdapterFactory, U as ModelClass, V as ModelMappingConfig, X as ModelResolver, Y as ModelResolverOptions, Z as ReceiveSpec, _ as ResolvedModel, $ as RetryDecision, a0 as SdkAdapterFactory, a1 as SplitPrompt, a2 as TaskRunOptions, T as TokenUsage, a3 as ToolchainCheckResult, a4 as ToolchainManifest, a5 as ToolchainManifestSchema, a6 as WorkflowContractLike, a7 as WorkflowInvocation, a8 as WorkflowRunOptions, a9 as WorkflowStep, aa as buildCandidateAgents, ab as buildGateEvaluationPrompt, ac as buildPerAgentGuardrails, ad as buildRetryFollowUp, ae as buildSdkFunctionTools, af as buildSplitTaskPrompt, ag as buildTaskPrompt, ah as createExecutionEnvelope, ai as createGuardrailHooks, aj as createGuardrailHooksForAgent, ak as createGuardrailHooksFromRules, al as createLibraryToolRegistry, am as createModelResolver, an as createRegistryFromSdkTools, ao as deriveToolchainsForAgents, ap as emitIterationClose, aq as emitIterationMetric, ar as emitIterationOpen, as as emitLlmTurnClose, at as emitLlmTurnOpen, au as emitSessionClose, av as emitSessionOpen, aw as emitSubagentClose, ax as emitSubagentOpen, ay as emitToolExecClose, az as emitToolExecOpen, aA as emitToolchainClose, aB as emitToolchainOpen, aC as extractStructuredResult, aD as getBlockingViolations, aE as getEffectiveGuardrailIds, aF as getGuardrailRulesForAgent, aG as getWarnings, aH as guardrailContextToRuleData, aI as hasBlockingViolation, aJ as parseGateEvaluationResponse, aK as renderAgentSystemPrompt, aL as runTask, aM as runToolchainChecks, aN as runWorkflow, aO as zodSchemaToPromptDescription, aP as zodSchemaToYamlExample } from './task-runner-Bl3SZfft.js';
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-3HT5BILT.js";
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,