@aaac/runtime 0.1.23 → 0.1.25
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-3EWHYMKL.js} +93 -2
- package/dist/chunk-3EWHYMKL.js.map +1 -0
- package/dist/index.d.ts +3 -31
- package/dist/index.js +50 -10
- package/dist/index.js.map +1 -1
- package/dist/{task-runner-DzLAb3UC.d.ts → task-runner-Bl3SZfft.d.ts} +46 -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-3EWHYMKL.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":"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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"]}
|
|
@@ -282,6 +282,93 @@ function emitToolchainClose(observer, spanId, toolchainId, operation, durationMs
|
|
|
282
282
|
});
|
|
283
283
|
}
|
|
284
284
|
|
|
285
|
+
// src/lib/library-tool-sdk.ts
|
|
286
|
+
function buildSdkFunctionTools(registry) {
|
|
287
|
+
return registry.getAll().map((def) => ({
|
|
288
|
+
name: def.toolId,
|
|
289
|
+
description: def.description,
|
|
290
|
+
inputSchema: def.inputSchema ?? { type: "object", properties: {} },
|
|
291
|
+
handler: async (args) => {
|
|
292
|
+
const result = await registry.execute(def.toolId, args);
|
|
293
|
+
return typeof result === "string" ? result : JSON.stringify(result);
|
|
294
|
+
}
|
|
295
|
+
}));
|
|
296
|
+
}
|
|
297
|
+
async function buildClaudeMcpServer(registry) {
|
|
298
|
+
const tools = buildSdkFunctionTools(registry);
|
|
299
|
+
if (tools.length === 0) return void 0;
|
|
300
|
+
const sdk = await import("@anthropic-ai/claude-agent-sdk");
|
|
301
|
+
const toolFn = sdk.tool;
|
|
302
|
+
const createServer = sdk.createSdkMcpServer;
|
|
303
|
+
if (!toolFn || !createServer) return void 0;
|
|
304
|
+
const { z } = await import("zod");
|
|
305
|
+
const { jsonSchemaToZod } = await import("./schema-converter-LACA7P4O.js");
|
|
306
|
+
const sdkTools = tools.map(
|
|
307
|
+
(t) => toolFn({
|
|
308
|
+
name: t.name,
|
|
309
|
+
description: t.description,
|
|
310
|
+
inputSchema: jsonSchemaToZod(t.inputSchema),
|
|
311
|
+
execute: async (args) => {
|
|
312
|
+
return t.handler(
|
|
313
|
+
args ?? {}
|
|
314
|
+
);
|
|
315
|
+
}
|
|
316
|
+
})
|
|
317
|
+
);
|
|
318
|
+
return createServer(sdkTools);
|
|
319
|
+
}
|
|
320
|
+
async function buildOpenAIFunctionTools(registry) {
|
|
321
|
+
const tools = buildSdkFunctionTools(registry);
|
|
322
|
+
if (tools.length === 0) return [];
|
|
323
|
+
try {
|
|
324
|
+
const sdk = await import("@openai/agents");
|
|
325
|
+
const toolFn = sdk.tool;
|
|
326
|
+
if (toolFn) {
|
|
327
|
+
const { jsonSchemaToZod } = await import("./schema-converter-LACA7P4O.js");
|
|
328
|
+
return tools.map(
|
|
329
|
+
(t) => toolFn({
|
|
330
|
+
name: t.name,
|
|
331
|
+
description: t.description,
|
|
332
|
+
parameters: jsonSchemaToZod(t.inputSchema),
|
|
333
|
+
execute: async (_ctx, args) => {
|
|
334
|
+
return t.handler(
|
|
335
|
+
args ?? {}
|
|
336
|
+
);
|
|
337
|
+
}
|
|
338
|
+
})
|
|
339
|
+
);
|
|
340
|
+
}
|
|
341
|
+
} catch {
|
|
342
|
+
}
|
|
343
|
+
return tools.map((t) => ({
|
|
344
|
+
type: "function",
|
|
345
|
+
function: {
|
|
346
|
+
name: t.name,
|
|
347
|
+
description: t.description,
|
|
348
|
+
parameters: t.inputSchema
|
|
349
|
+
},
|
|
350
|
+
execute: async (args) => {
|
|
351
|
+
return t.handler(
|
|
352
|
+
args ?? {}
|
|
353
|
+
);
|
|
354
|
+
}
|
|
355
|
+
}));
|
|
356
|
+
}
|
|
357
|
+
async function buildAdkFunctionTools(registry) {
|
|
358
|
+
const tools = buildSdkFunctionTools(registry);
|
|
359
|
+
if (tools.length === 0) return [];
|
|
360
|
+
return tools.map((t) => ({
|
|
361
|
+
name: t.name,
|
|
362
|
+
description: t.description,
|
|
363
|
+
inputSchema: t.inputSchema,
|
|
364
|
+
execute: async (args) => {
|
|
365
|
+
return t.handler(
|
|
366
|
+
args ?? {}
|
|
367
|
+
);
|
|
368
|
+
}
|
|
369
|
+
}));
|
|
370
|
+
}
|
|
371
|
+
|
|
285
372
|
export {
|
|
286
373
|
createExecutionEnvelope,
|
|
287
374
|
emitSessionOpen,
|
|
@@ -296,6 +383,10 @@ export {
|
|
|
296
383
|
emitToolExecOpen,
|
|
297
384
|
emitToolExecClose,
|
|
298
385
|
emitToolchainOpen,
|
|
299
|
-
emitToolchainClose
|
|
386
|
+
emitToolchainClose,
|
|
387
|
+
buildSdkFunctionTools,
|
|
388
|
+
buildClaudeMcpServer,
|
|
389
|
+
buildOpenAIFunctionTools,
|
|
390
|
+
buildAdkFunctionTools
|
|
300
391
|
};
|
|
301
|
-
//# sourceMappingURL=chunk-
|
|
392
|
+
//# sourceMappingURL=chunk-3EWHYMKL.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// ── 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,
|
|
2
|
-
export {
|
|
1
|
+
import { O as ObserverEmitFn, b as TaskContext, c as TaskOutcome, d as AgentContractLike, e as TaskContractLike, P as PromptBuilderOptions, W as WorkflowResult, S as SdkAdapter, f as WorkflowRegistries, H as HandoffInput, g as StepCompleteEvent, h as StepResult, D as DelegateStep, i as GuardrailRuleData, j as MemoryStore, M as MemoryRef, k as SdkFunctionTool, G as GuardrailHooks, R as ResolvedComponent, l as ArtifactBindingConfig, m as RunToolchainChecksOptions, n as TaskRunResult, L as LibraryToolRegistry, o as ResolvedToolchain, p as LibraryToolDefinition, q as HookResponse, r as GuardrailCheckResult } from './task-runner-Bl3SZfft.js';
|
|
2
|
+
export { s as AdapterOrFactory, A as AdapterSendOptions, a as AgentExecutionRequest, t as AgentProgressEvent, B as BoundResolveOptions, u as BoundResolver, C as CacheConfig, v as CandidateAgent, w as ConvergenceEnvelope, x as ConvergenceEnvelopePayload, E as EnvelopeParams, y as EvaluateStep, z as GateStep, F as GuardrailCheckFunctions, I as GuardrailRule, J as HookContext, K as InMemoryStore, N as InnerSpanOptions, Q as ModelAwareSdkAdapterFactory, U as ModelClass, V as ModelMappingConfig, X as ModelResolver, Y as ModelResolverOptions, Z as ReceiveSpec, _ as ResolvedModel, $ as RetryDecision, a0 as SdkAdapterFactory, a1 as SplitPrompt, a2 as TaskRunOptions, T as TokenUsage, a3 as ToolchainCheckResult, a4 as ToolchainManifest, a5 as ToolchainManifestSchema, a6 as WorkflowContractLike, a7 as WorkflowInvocation, a8 as WorkflowRunOptions, a9 as WorkflowStep, aa as buildCandidateAgents, ab as buildGateEvaluationPrompt, ac as buildPerAgentGuardrails, ad as buildRetryFollowUp, ae as buildSdkFunctionTools, af as buildSplitTaskPrompt, ag as buildTaskPrompt, ah as createExecutionEnvelope, ai as createGuardrailHooks, aj as createGuardrailHooksForAgent, ak as createGuardrailHooksFromRules, al as createLibraryToolRegistry, am as createModelResolver, an as createRegistryFromSdkTools, ao as deriveToolchainsForAgents, ap as emitIterationClose, aq as emitIterationMetric, ar as emitIterationOpen, as as emitLlmTurnClose, at as emitLlmTurnOpen, au as emitSessionClose, av as emitSessionOpen, aw as emitSubagentClose, ax as emitSubagentOpen, ay as emitToolExecClose, az as emitToolExecOpen, aA as emitToolchainClose, aB as emitToolchainOpen, aC as extractStructuredResult, aD as getBlockingViolations, aE as getEffectiveGuardrailIds, aF as getGuardrailRulesForAgent, aG as getWarnings, aH as guardrailContextToRuleData, aI as hasBlockingViolation, aJ as parseGateEvaluationResponse, aK as renderAgentSystemPrompt, aL as runTask, aM as runToolchainChecks, aN as runWorkflow, aO as zodSchemaToPromptDescription, aP as zodSchemaToYamlExample } from './task-runner-Bl3SZfft.js';
|
|
3
3
|
import { z } from 'zod';
|
|
4
4
|
import { OperationIR, ComponentIR } from '@aaac/contracts';
|
|
5
5
|
import { ResolvedConfig } from './generator/index.js';
|
|
@@ -355,34 +355,6 @@ declare class AgentLogWriter {
|
|
|
355
355
|
}>;
|
|
356
356
|
}
|
|
357
357
|
|
|
358
|
-
/**
|
|
359
|
-
* Library Tool → SDK Function Tool conversion.
|
|
360
|
-
*
|
|
361
|
-
* Converts LibraryToolDefinition entries into SDK-native function tools
|
|
362
|
-
* that each adapter can register with its respective LLM SDK.
|
|
363
|
-
*
|
|
364
|
-
* Each adapter receives tools in its native format:
|
|
365
|
-
* - Claude Agent SDK: MCP tool via createSdkMcpServer + tool()
|
|
366
|
-
* - OpenAI Agents SDK: function tool object
|
|
367
|
-
* - Google ADK: FunctionDeclaration tool
|
|
368
|
-
*/
|
|
369
|
-
|
|
370
|
-
/**
|
|
371
|
-
* Adapter-agnostic function tool descriptor. Adapters convert this
|
|
372
|
-
* into their SDK-specific tool format.
|
|
373
|
-
*/
|
|
374
|
-
interface SdkFunctionTool {
|
|
375
|
-
name: string;
|
|
376
|
-
description: string;
|
|
377
|
-
inputSchema: Record<string, unknown>;
|
|
378
|
-
handler: (args: Record<string, unknown>) => Promise<string>;
|
|
379
|
-
}
|
|
380
|
-
/**
|
|
381
|
-
* Build adapter-agnostic function tool descriptors from a LibraryToolRegistry.
|
|
382
|
-
* Each tool's handler calls registry.execute() and serialises the result.
|
|
383
|
-
*/
|
|
384
|
-
declare function buildSdkFunctionTools(registry: LibraryToolRegistry): SdkFunctionTool[];
|
|
385
|
-
|
|
386
358
|
/**
|
|
387
359
|
* Analyzer Bridge — integrates artifact-contracts-analyzer as a standard
|
|
388
360
|
* runtime tool provider.
|
|
@@ -891,4 +863,4 @@ declare function executePrompt(message: string, ir: ComponentIR, binding: Runtim
|
|
|
891
863
|
/** Package version string. */
|
|
892
864
|
declare const version: string;
|
|
893
865
|
|
|
894
|
-
export { type AaacInvocationContext, type AaacObserver, type AaacPolicy, type AaacRuntime, AgentContractLike, AgentLogWriter, type AgentLogWriterOptions, type AgentPlugin, type AnalyzeImpactInput, type AnalyzerBridge, type AnalyzerBridgeOptions, ArtifactBindingConfig, type ArtifactResolveOptions, type ArtifactResolveResult, type BuildCallGraphInput, type ComponentScope, type CreateAdapterOptions, type CreateComponentScopeOptions, type CreateProjectRuntimeOptions, DelegateStep, type DslContext, DslValidationError, type EvaluateGuardrailOptions, type EvaluateGuardrailResult, type ExecuteOptions, type ExecuteTaskOptions, type ExecuteWorkflowOptions, FileMemoryStore, type GenerateContextPackInput, type GuardStatusOptions, type GuardStatusResult, GuardrailCheckResult, GuardrailHooks, type GuardrailListEntry, type GuardrailResult, GuardrailRuleData, HandoffInput, HookResponse, LibraryToolDefinition, LibraryToolRegistry, type ListGuardrailsOptions, type ListGuardrailsResult, type LoadDslOptions, MemoryRef, MemoryStore, type MemoryStoreEntry, type NavigationContext, type NavigationContextOptions, ObserverEmitFn, type OperationHandler, type OperationMemoryRefConfig, type OperationToolDef, PROJECT_CONFIG_FILENAME, type PermissionMode, type PluginLoadResult, PluginRegistry, type ProcessEditOptions, type ProcessTaskOptions, type ProcessWorkflowOptions, type ProgressSink, type ProgressSinkOptions, type ProjectRuntime, type PromptBuilderArgs, PromptBuilderOptions, type PromptExecuteOptions, type PromptResult, type RequiredEntities, type ResolvedAdapterSelection, ResolvedComponent, ResolvedToolchain, type RunLogEvent, RunToolchainChecksOptions, type Runtime, type RuntimeBinding, type RuntimeConfig, SdkAdapter,
|
|
866
|
+
export { type AaacInvocationContext, type AaacObserver, type AaacPolicy, type AaacRuntime, AgentContractLike, AgentLogWriter, type AgentLogWriterOptions, type AgentPlugin, type AnalyzeImpactInput, type AnalyzerBridge, type AnalyzerBridgeOptions, ArtifactBindingConfig, type ArtifactResolveOptions, type ArtifactResolveResult, type BuildCallGraphInput, type ComponentScope, type CreateAdapterOptions, type CreateComponentScopeOptions, type CreateProjectRuntimeOptions, DelegateStep, type DslContext, DslValidationError, type EvaluateGuardrailOptions, type EvaluateGuardrailResult, type ExecuteOptions, type ExecuteTaskOptions, type ExecuteWorkflowOptions, FileMemoryStore, type GenerateContextPackInput, type GuardStatusOptions, type GuardStatusResult, GuardrailCheckResult, GuardrailHooks, type GuardrailListEntry, type GuardrailResult, GuardrailRuleData, HandoffInput, HookResponse, LibraryToolDefinition, LibraryToolRegistry, type ListGuardrailsOptions, type ListGuardrailsResult, type LoadDslOptions, MemoryRef, MemoryStore, type MemoryStoreEntry, type NavigationContext, type NavigationContextOptions, ObserverEmitFn, type OperationHandler, type OperationMemoryRefConfig, type OperationToolDef, PROJECT_CONFIG_FILENAME, type PermissionMode, type PluginLoadResult, PluginRegistry, type ProcessEditOptions, type ProcessTaskOptions, type ProcessWorkflowOptions, type ProgressSink, type ProgressSinkOptions, type ProjectRuntime, type PromptBuilderArgs, PromptBuilderOptions, type PromptExecuteOptions, type PromptResult, type RequiredEntities, type ResolvedAdapterSelection, ResolvedComponent, ResolvedToolchain, type RunLogEvent, RunToolchainChecksOptions, type Runtime, type RuntimeBinding, type RuntimeConfig, SdkAdapter, SdkFunctionTool, StepCompleteEvent, StepResult, TaskContext, TaskContractLike, type TaskHookContext, TaskOutcome, TaskRunResult, WorkflowBuilder, type WorkflowHookContext, WorkflowRegistries, WorkflowResult, buildGuardrailRulesFromDsl, buildNavigationContext, buildRegistriesFromDsl, createAdapter, createAnalyzerBridge, createComponentScope, createProgressSink, createProjectRuntime, createRuntime, createRuntimeBinding, emitProcessEdit, emitProcessTaskClose, emitProcessTaskOpen, emitProcessWorkflowClose, emitProcessWorkflowOpen, evaluateGuardrail, executePrompt, executeTask, executeWorkflow, findProjectConfig, guardStatus, isContextPack, jsonSchemaToZod, listGuardrails, loadDslContext, loadPlugins, loadPluginsFromDirectory, loadPluginsFromPaths, operationsToTools, parseRouterResponse, pluginRegistry, renderContextPackPrompt, resolveArtifacts, version };
|