@aaac/runtime 0.1.31 → 0.1.32

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,6 @@
1
1
  import { z } from 'zod';
2
2
  import { G as GuardrailContext } from './context-DKkamYX_.js';
3
- import { EmitInput, ExecutionEnvelope } from '@aaac/observability';
3
+ import { EmitInput, ExecutionEnvelope, AttrValue, CanonicalLink } from '@aaac/observability';
4
4
 
5
5
  /**
6
6
  * MemoryRef — opaque typed reference for resumable agent context.
@@ -43,177 +43,6 @@ declare class InMemoryStore implements MemoryStore {
43
43
  delete(ref: MemoryRef): Promise<void>;
44
44
  }
45
45
 
46
- /**
47
- * Library Tool → SDK Function Tool conversion.
48
- *
49
- * Converts LibraryToolDefinition entries into SDK-native function tools
50
- * that each adapter can register with its respective LLM SDK.
51
- *
52
- * Each adapter receives tools in its native format:
53
- * - Claude Agent SDK: MCP tool via createSdkMcpServer + tool()
54
- * - OpenAI Agents SDK: function tool object
55
- * - Google ADK: FunctionDeclaration tool
56
- */
57
-
58
- /**
59
- * Adapter-agnostic function tool descriptor. Adapters convert this
60
- * into their SDK-specific tool format.
61
- */
62
- interface SdkFunctionTool {
63
- name: string;
64
- description: string;
65
- inputSchema: Record<string, unknown>;
66
- handler: (args: Record<string, unknown>) => Promise<string>;
67
- }
68
- /**
69
- * Build adapter-agnostic function tool descriptors from a LibraryToolRegistry.
70
- * Each tool's handler calls registry.execute() and serialises the result.
71
- */
72
- declare function buildSdkFunctionTools(registry: LibraryToolRegistry): SdkFunctionTool[];
73
-
74
- interface LibraryToolDefinition {
75
- toolId: string;
76
- description: string;
77
- module: string;
78
- exportName: string;
79
- inputSchema?: Record<string, unknown>;
80
- outputSchema?: Record<string, unknown>;
81
- }
82
- interface LibraryToolRegistry {
83
- register(def: LibraryToolDefinition): void;
84
- get(toolId: string): LibraryToolDefinition | undefined;
85
- getAll(): LibraryToolDefinition[];
86
- execute(toolId: string, input: unknown): Promise<unknown>;
87
- }
88
- declare function createLibraryToolRegistry(): LibraryToolRegistry;
89
- /**
90
- * Create a LibraryToolRegistry backed by pre-built SdkFunctionTool handlers.
91
- * Unlike createLibraryToolRegistry (which resolves tools via dynamic import),
92
- * this variant delegates execute() directly to the tool's in-process handler.
93
- */
94
- declare function createRegistryFromSdkTools(tools: SdkFunctionTool[]): LibraryToolRegistry;
95
-
96
- /**
97
- * SDK Guardrail Hook Bridge — generic adapter from guardrail check functions
98
- * + plugin guardrails to SDK-compatible hook responses.
99
- *
100
- * Embedded guardrail rules are converted via createGuardrailHooksFromRules(),
101
- * which delegates to createGuardrailHooks(). All hook logic lives here.
102
- */
103
- interface GuardrailCheckResult {
104
- guardrail_id: string;
105
- passed: boolean;
106
- action: "block" | "warn" | "shadow" | "info";
107
- message: string;
108
- }
109
- interface HookResponse {
110
- permission?: "deny";
111
- user_message?: string;
112
- agent_message?: string;
113
- additionalContext?: string;
114
- }
115
- interface GuardrailRule {
116
- guardrail_id: string;
117
- pattern: string;
118
- action: "block" | "warn" | "shadow" | "info";
119
- message: string;
120
- file_glob?: string;
121
- exclude_glob?: string;
122
- }
123
- interface GuardrailRuleData {
124
- commandRules: GuardrailRule[];
125
- fileRules: GuardrailRule[];
126
- contentRules: GuardrailRule[];
127
- }
128
- interface GuardrailCheckFunctions {
129
- checkCommand: (command: string) => GuardrailCheckResult[];
130
- checkFilePath: (filePath: string) => GuardrailCheckResult[];
131
- checkContent: (filePath: string, content: string) => GuardrailCheckResult[];
132
- }
133
- interface HookContext {
134
- /** Agent id for per-agent guardrail filtering. */
135
- agentId?: string;
136
- command?: string;
137
- filePath?: string;
138
- content?: string;
139
- }
140
- interface GuardrailHooks {
141
- beforeShellExecution: (input: {
142
- command?: string;
143
- }) => HookResponse;
144
- preToolUse: (input: {
145
- tool_name?: string;
146
- tool_input?: {
147
- file_path?: string;
148
- path?: string;
149
- };
150
- }) => HookResponse;
151
- afterFileEdit: (input: {
152
- file_path?: string;
153
- content?: string;
154
- }) => HookResponse;
155
- runChecks: (ctx: HookContext) => GuardrailCheckResult[];
156
- }
157
- declare function getBlockingViolations(results: GuardrailCheckResult[]): GuardrailCheckResult[];
158
- declare function getWarnings(results: GuardrailCheckResult[]): GuardrailCheckResult[];
159
- declare function hasBlockingViolation(results: GuardrailCheckResult[]): boolean;
160
- /**
161
- * Create SDK hook functions from generated guardrail check functions.
162
- *
163
- * Merges DSL-generated checks with plugin-registered guardrails and
164
- * returns hook functions in the format expected by the Claude SDK,
165
- * plus a generic runChecks() for programmatic use.
166
- */
167
- declare function createGuardrailHooks(checks: GuardrailCheckFunctions): GuardrailHooks;
168
- /**
169
- * Create SDK hook functions from embedded guardrail rule data.
170
- */
171
- /**
172
- * Create SDK hooks scoped to a single agent from a per-agent guardrail map.
173
- * Returns empty-passing hooks when the agent has no rules in the map.
174
- */
175
- declare function createGuardrailHooksForAgent(agentId: string, perAgent: Map<string, GuardrailRuleData>): GuardrailHooks;
176
- declare function createGuardrailHooksFromRules(rules: GuardrailRuleData): GuardrailHooks;
177
-
178
- /**
179
- * ModelResolver — resolves a model_class to a concrete adapter + model pair.
180
- *
181
- * Resolution priority (highest wins):
182
- * 1. AGENT_RUNTIME_MODEL_{FAST|STANDARD|THINKING} env var
183
- * 2. AGENT_RUNTIME_MODEL env var (catch-all fallback)
184
- * 3. agents.conf.yaml model_mapping.<class>
185
- * 4. CLI --adapter + adapter default model
186
- */
187
- type ModelClass = "fast" | "standard" | "thinking";
188
- interface ResolvedModel {
189
- adapter: string;
190
- model?: string;
191
- }
192
- interface ModelResolver {
193
- resolve(modelClass: ModelClass | undefined): ResolvedModel;
194
- }
195
- interface ModelMappingConfig {
196
- fast?: {
197
- adapter: string;
198
- model?: string;
199
- };
200
- standard?: {
201
- adapter: string;
202
- model?: string;
203
- };
204
- thinking?: {
205
- adapter: string;
206
- model?: string;
207
- };
208
- }
209
- interface ModelResolverOptions {
210
- modelMapping?: ModelMappingConfig;
211
- fallbackAdapter: string;
212
- fallbackModel?: string;
213
- env?: Record<string, string | undefined>;
214
- }
215
- declare function createModelResolver(options: ModelResolverOptions): ModelResolver;
216
-
217
46
  /**
218
47
  * observability-bridge.ts
219
48
  *
@@ -387,17 +216,28 @@ declare function emitLlmTurnClose(observer: ObserverEmitFn | undefined, spanId:
387
216
  cacheHitTokens?: number;
388
217
  toolCallsCount?: number;
389
218
  }, sessionId?: string): void;
219
+ /** Optional emit-time attributes and links for agent.tool_exec spans (#151). */
220
+ interface ToolExecOpenOptions {
221
+ sessionId?: string;
222
+ extraAttributes?: Record<string, AttrValue>;
223
+ links?: CanonicalLink[];
224
+ }
225
+ interface ToolExecCloseOptions {
226
+ sessionId?: string;
227
+ extraAttributes?: Record<string, AttrValue>;
228
+ outputSummary?: string;
229
+ }
390
230
  /**
391
231
  * Emit an agent.tool_exec open span when a tool execution begins.
392
232
  *
393
233
  * Returns the spanId emitted (= generated UUIDv7).
394
234
  * Returns undefined when observer is undefined (no-op).
395
235
  */
396
- declare function emitToolExecOpen(observer: ObserverEmitFn | undefined, parentSpanId: string | undefined, toolName: string, inputSummary: string, turnNumber: number, sessionId?: string): string | undefined;
236
+ declare function emitToolExecOpen(observer: ObserverEmitFn | undefined, parentSpanId: string | undefined, toolName: string, inputSummary: string, turnNumber: number, sessionIdOrOptions?: string | ToolExecOpenOptions): string | undefined;
397
237
  /**
398
238
  * Emit an agent.tool_exec close span.
399
239
  */
400
- declare function emitToolExecClose(observer: ObserverEmitFn | undefined, spanId: string, toolName: string, durationMs: number, sessionId?: string): void;
240
+ declare function emitToolExecClose(observer: ObserverEmitFn | undefined, spanId: string, toolName: string, durationMs: number, sessionIdOrOptions?: string | ToolExecCloseOptions): void;
401
241
  /**
402
242
  * Emit a toolchain.execution open span when a toolchain tool is invoked.
403
243
  *
@@ -410,6 +250,177 @@ declare function emitToolchainOpen(observer: ObserverEmitFn | undefined, parentS
410
250
  */
411
251
  declare function emitToolchainClose(observer: ObserverEmitFn | undefined, spanId: string, toolchainId: string, operation: string, durationMs: number, status: "success" | "failure", errorMessage?: string): void;
412
252
 
253
+ /**
254
+ * Library Tool → SDK Function Tool conversion.
255
+ *
256
+ * Converts LibraryToolDefinition entries into SDK-native function tools
257
+ * that each adapter can register with its respective LLM SDK.
258
+ *
259
+ * Each adapter receives tools in its native format:
260
+ * - Claude Agent SDK: MCP tool via createSdkMcpServer + tool()
261
+ * - OpenAI Agents SDK: function tool object
262
+ * - Google ADK: FunctionDeclaration tool
263
+ */
264
+
265
+ /**
266
+ * Adapter-agnostic function tool descriptor. Adapters convert this
267
+ * into their SDK-specific tool format.
268
+ */
269
+ interface SdkFunctionTool {
270
+ name: string;
271
+ description: string;
272
+ inputSchema: Record<string, unknown>;
273
+ handler: (args: Record<string, unknown>) => Promise<string>;
274
+ }
275
+ /**
276
+ * Build adapter-agnostic function tool descriptors from a LibraryToolRegistry.
277
+ * Each tool's handler calls registry.execute() and serialises the result.
278
+ */
279
+ declare function buildSdkFunctionTools(registry: LibraryToolRegistry): SdkFunctionTool[];
280
+
281
+ interface LibraryToolDefinition {
282
+ toolId: string;
283
+ description: string;
284
+ module: string;
285
+ exportName: string;
286
+ inputSchema?: Record<string, unknown>;
287
+ outputSchema?: Record<string, unknown>;
288
+ }
289
+ interface LibraryToolRegistry {
290
+ register(def: LibraryToolDefinition): void;
291
+ get(toolId: string): LibraryToolDefinition | undefined;
292
+ getAll(): LibraryToolDefinition[];
293
+ execute(toolId: string, input: unknown): Promise<unknown>;
294
+ }
295
+ declare function createLibraryToolRegistry(): LibraryToolRegistry;
296
+ /**
297
+ * Create a LibraryToolRegistry backed by pre-built SdkFunctionTool handlers.
298
+ * Unlike createLibraryToolRegistry (which resolves tools via dynamic import),
299
+ * this variant delegates execute() directly to the tool's in-process handler.
300
+ */
301
+ declare function createRegistryFromSdkTools(tools: SdkFunctionTool[]): LibraryToolRegistry;
302
+
303
+ /**
304
+ * SDK Guardrail Hook Bridge — generic adapter from guardrail check functions
305
+ * + plugin guardrails to SDK-compatible hook responses.
306
+ *
307
+ * Embedded guardrail rules are converted via createGuardrailHooksFromRules(),
308
+ * which delegates to createGuardrailHooks(). All hook logic lives here.
309
+ */
310
+ interface GuardrailCheckResult {
311
+ guardrail_id: string;
312
+ passed: boolean;
313
+ action: "block" | "warn" | "shadow" | "info";
314
+ message: string;
315
+ }
316
+ interface HookResponse {
317
+ permission?: "deny";
318
+ user_message?: string;
319
+ agent_message?: string;
320
+ additionalContext?: string;
321
+ }
322
+ interface GuardrailRule {
323
+ guardrail_id: string;
324
+ pattern: string;
325
+ action: "block" | "warn" | "shadow" | "info";
326
+ message: string;
327
+ file_glob?: string;
328
+ exclude_glob?: string;
329
+ }
330
+ interface GuardrailRuleData {
331
+ commandRules: GuardrailRule[];
332
+ fileRules: GuardrailRule[];
333
+ contentRules: GuardrailRule[];
334
+ }
335
+ interface GuardrailCheckFunctions {
336
+ checkCommand: (command: string) => GuardrailCheckResult[];
337
+ checkFilePath: (filePath: string) => GuardrailCheckResult[];
338
+ checkContent: (filePath: string, content: string) => GuardrailCheckResult[];
339
+ }
340
+ interface HookContext {
341
+ /** Agent id for per-agent guardrail filtering. */
342
+ agentId?: string;
343
+ command?: string;
344
+ filePath?: string;
345
+ content?: string;
346
+ }
347
+ interface GuardrailHooks {
348
+ beforeShellExecution: (input: {
349
+ command?: string;
350
+ }) => HookResponse;
351
+ preToolUse: (input: {
352
+ tool_name?: string;
353
+ tool_input?: {
354
+ file_path?: string;
355
+ path?: string;
356
+ };
357
+ }) => HookResponse;
358
+ afterFileEdit: (input: {
359
+ file_path?: string;
360
+ content?: string;
361
+ }) => HookResponse;
362
+ runChecks: (ctx: HookContext) => GuardrailCheckResult[];
363
+ }
364
+ declare function getBlockingViolations(results: GuardrailCheckResult[]): GuardrailCheckResult[];
365
+ declare function getWarnings(results: GuardrailCheckResult[]): GuardrailCheckResult[];
366
+ declare function hasBlockingViolation(results: GuardrailCheckResult[]): boolean;
367
+ /**
368
+ * Create SDK hook functions from generated guardrail check functions.
369
+ *
370
+ * Merges DSL-generated checks with plugin-registered guardrails and
371
+ * returns hook functions in the format expected by the Claude SDK,
372
+ * plus a generic runChecks() for programmatic use.
373
+ */
374
+ declare function createGuardrailHooks(checks: GuardrailCheckFunctions): GuardrailHooks;
375
+ /**
376
+ * Create SDK hook functions from embedded guardrail rule data.
377
+ */
378
+ /**
379
+ * Create SDK hooks scoped to a single agent from a per-agent guardrail map.
380
+ * Returns empty-passing hooks when the agent has no rules in the map.
381
+ */
382
+ declare function createGuardrailHooksForAgent(agentId: string, perAgent: Map<string, GuardrailRuleData>): GuardrailHooks;
383
+ declare function createGuardrailHooksFromRules(rules: GuardrailRuleData): GuardrailHooks;
384
+
385
+ /**
386
+ * ModelResolver — resolves a model_class to a concrete adapter + model pair.
387
+ *
388
+ * Resolution priority (highest wins):
389
+ * 1. AGENT_RUNTIME_MODEL_{FAST|STANDARD|THINKING} env var
390
+ * 2. AGENT_RUNTIME_MODEL env var (catch-all fallback)
391
+ * 3. agents.conf.yaml model_mapping.<class>
392
+ * 4. CLI --adapter + adapter default model
393
+ */
394
+ type ModelClass = "fast" | "standard" | "thinking";
395
+ interface ResolvedModel {
396
+ adapter: string;
397
+ model?: string;
398
+ }
399
+ interface ModelResolver {
400
+ resolve(modelClass: ModelClass | undefined): ResolvedModel;
401
+ }
402
+ interface ModelMappingConfig {
403
+ fast?: {
404
+ adapter: string;
405
+ model?: string;
406
+ };
407
+ standard?: {
408
+ adapter: string;
409
+ model?: string;
410
+ };
411
+ thinking?: {
412
+ adapter: string;
413
+ model?: string;
414
+ };
415
+ }
416
+ interface ModelResolverOptions {
417
+ modelMapping?: ModelMappingConfig;
418
+ fallbackAdapter: string;
419
+ fallbackModel?: string;
420
+ env?: Record<string, string | undefined>;
421
+ }
422
+ declare function createModelResolver(options: ModelResolverOptions): ModelResolver;
423
+
413
424
  /**
414
425
  * Toolchain Checker — runs check commands defined in toolchain-contracts
415
426
  * and returns structured pass/fail results.
@@ -1248,4 +1259,4 @@ declare function runTask(adapter: SdkAdapter, taskId: string, context: TaskConte
1248
1259
  libraryTools?: LibraryToolRegistry;
1249
1260
  }): Promise<TaskRunResult>;
1250
1261
 
1251
- export { type ReceiveSpec as $, type AdapterSendOptions as A, type BoundResolveOptions as B, type CacheConfig as C, type DelegateStep as D, type EnvelopeParams as E, type GateStep as F, type GuardrailHooks as G, type HandoffInput as H, type GuardrailCheckFunctions as I, type GuardrailRule as J, type HookContext as K, type LibraryToolRegistry as L, type MemoryRef as M, InMemoryStore as N, type ObserverEmitFn as O, type PromptBuilderOptions as P, type InnerSpanOptions as Q, type ResolvedComponent as R, type SdkAdapter as S, type TokenUsage as T, type ModelAwareSdkAdapterFactory as U, type ModelClass as V, type WorkflowResult as W, type ModelResolver as X, type ModelResolverOptions as Y, OBSERVABILITY_ENV_VARS as Z, type ObservabilityIds as _, type AgentExecutionRequest as a, type ResolvedModel as a0, type RetryDecision as a1, type SdkAdapterFactory as a2, type SplitPrompt as a3, type TaskRunOptions as a4, type ToolchainCheckResult as a5, type ToolchainManifest as a6, ToolchainManifestSchema as a7, type WorkflowContractLike as a8, type WorkflowInvocation as a9, emitSubagentClose as aA, emitSubagentOpen as aB, emitToolExecClose as aC, emitToolExecOpen as aD, emitToolchainClose as aE, emitToolchainOpen as aF, extractStructuredResult as aG, getBlockingViolations as aH, getEffectiveGuardrailIds as aI, getGuardrailRulesForAgent as aJ, getWarnings as aK, guardrailContextToRuleData as aL, hasBlockingViolation as aM, isNavigationIndex as aN, parseGateEvaluationResponse as aO, renderAgentSystemPrompt as aP, renderAnalyzerExplorationMandatePrompt as aQ, renderNavigationIndexPrompt as aR, runTask as aS, runToolchainChecks as aT, runWorkflow as aU, shouldInjectAnalyzerExplorationMandate as aV, zodSchemaToPromptDescription as aW, zodSchemaToYamlExample as aX, type WorkflowRunOptions as aa, type WorkflowStep as ab, buildCandidateAgents as ac, buildGateEvaluationPrompt as ad, buildObservabilityEnv as ae, buildPerAgentGuardrails as af, buildRetryFollowUp as ag, buildSdkFunctionTools as ah, buildSplitTaskPrompt as ai, buildTaskPrompt as aj, collectAnalyzerToolIds as ak, createExecutionEnvelope as al, createGuardrailHooks as am, createGuardrailHooksForAgent as an, createGuardrailHooksFromRules as ao, createLibraryToolRegistry as ap, createModelResolver as aq, createRegistryFromSdkTools as ar, deriveToolchainsForAgents as as, emitIterationClose as at, emitIterationMetric as au, emitIterationOpen as av, emitLlmTurnClose as aw, emitLlmTurnOpen as ax, emitSessionClose as ay, emitSessionOpen as az, type TaskContext as b, type TaskOutcome as c, type AgentContractLike as d, type TaskContractLike as e, type WorkflowRegistries as f, type StepCompleteEvent as g, type StepResult as h, type GuardrailRuleData as i, type MemoryStore as j, type SdkFunctionTool as k, type ArtifactBindingConfig as l, type RunToolchainChecksOptions as m, type ModelMappingConfig as n, type TaskRunResult as o, type ResolvedToolchain as p, type LibraryToolDefinition as q, type HookResponse as r, type GuardrailCheckResult as s, type AdapterOrFactory as t, type AgentProgressEvent as u, BoundResolver as v, type CandidateAgent as w, type ConvergenceEnvelope as x, type ConvergenceEnvelopePayload as y, type EvaluateStep as z };
1262
+ export { type ReceiveSpec as $, type AdapterSendOptions as A, type BoundResolveOptions as B, type CacheConfig as C, type DelegateStep as D, type EnvelopeParams as E, type GateStep as F, type GuardrailHooks as G, type HandoffInput as H, type GuardrailCheckFunctions as I, type GuardrailRule as J, type HookContext as K, type LibraryToolRegistry as L, type MemoryRef as M, InMemoryStore as N, type ObserverEmitFn as O, type PromptBuilderOptions as P, type InnerSpanOptions as Q, type ResolvedComponent as R, type SdkAdapter as S, type TokenUsage as T, type ModelAwareSdkAdapterFactory as U, type ModelClass as V, type WorkflowResult as W, type ModelResolver as X, type ModelResolverOptions as Y, OBSERVABILITY_ENV_VARS as Z, type ObservabilityIds as _, type AgentExecutionRequest as a, type ResolvedModel as a0, type RetryDecision as a1, type SdkAdapterFactory as a2, type SplitPrompt as a3, type TaskRunOptions as a4, type ToolchainCheckResult as a5, type ToolchainManifest as a6, ToolchainManifestSchema as a7, type WorkflowContractLike as a8, type WorkflowInvocation as a9, emitSubagentClose as aA, emitSubagentOpen as aB, emitToolExecClose as aC, emitToolExecOpen as aD, emitToolchainClose as aE, emitToolchainOpen as aF, extractStructuredResult as aG, getBlockingViolations as aH, getEffectiveGuardrailIds as aI, getGuardrailRulesForAgent as aJ, getWarnings as aK, guardrailContextToRuleData as aL, hasBlockingViolation as aM, isNavigationIndex as aN, parseGateEvaluationResponse as aO, renderAgentSystemPrompt as aP, renderAnalyzerExplorationMandatePrompt as aQ, renderNavigationIndexPrompt as aR, runTask as aS, runToolchainChecks as aT, runWorkflow as aU, shouldInjectAnalyzerExplorationMandate as aV, zodSchemaToPromptDescription as aW, zodSchemaToYamlExample as aX, type WorkflowRunOptions as aa, type WorkflowStep as ab, buildCandidateAgents as ac, buildGateEvaluationPrompt as ad, buildObservabilityEnv as ae, buildPerAgentGuardrails as af, buildRetryFollowUp as ag, buildSdkFunctionTools as ah, buildSplitTaskPrompt as ai, buildTaskPrompt as aj, collectAnalyzerToolIds as ak, createExecutionEnvelope as al, createGuardrailHooks as am, createGuardrailHooksForAgent as an, createGuardrailHooksFromRules as ao, createLibraryToolRegistry as ap, createModelResolver as aq, createRegistryFromSdkTools as ar, deriveToolchainsForAgents as as, emitIterationClose as at, emitIterationMetric as au, emitIterationOpen as av, emitLlmTurnClose as aw, emitLlmTurnOpen as ax, emitSessionClose as ay, emitSessionOpen as az, type SdkFunctionTool as b, type TaskContext as c, type TaskOutcome as d, type AgentContractLike as e, type TaskContractLike as f, type WorkflowRegistries as g, type StepCompleteEvent as h, type StepResult as i, type GuardrailRuleData as j, type MemoryStore as k, type ArtifactBindingConfig as l, type RunToolchainChecksOptions as m, type ModelMappingConfig as n, type TaskRunResult as o, type ResolvedToolchain as p, type LibraryToolDefinition as q, type HookResponse as r, type GuardrailCheckResult as s, type AdapterOrFactory as t, type AgentProgressEvent as u, BoundResolver as v, type CandidateAgent as w, type ConvergenceEnvelope as x, type ConvergenceEnvelopePayload as y, type EvaluateStep as z };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aaac/runtime",
3
- "version": "0.1.31",
3
+ "version": "0.1.32",
4
4
  "description": "Runtime SDK for the AaaC toolchain",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -1 +0,0 @@
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/** Resolve agent.session_id for Agent-axis child spans. */\nfunction resolveAgentSessionId(envelope: ExecutionEnvelope, parentSpanId?: string): string {\n return envelope.parent_run_id ?? parentSpanId ?? envelope.run_id;\n}\n\n/**\n * Extract token usage fields into OTel GenAI semantic conventions attributes.\n *\n * Standard keys (#125 §6):\n * gen_ai.usage.input_tokens — OTel GenAI: total input tokens for the operation\n * gen_ai.usage.output_tokens — OTel GenAI: total output tokens for the operation\n * gen_ai.usage.total_tokens — non-standard extension (no OTel equivalent)\n * gen_ai.usage.cache_read_input_tokens — Anthropic-specific extension\n * gen_ai.usage.cache_creation_input_tokens — Anthropic-specific extension\n * cost_usd — OTel GenAI に標準キーが存在しないためカスタム属性のまま据え置き\n */\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[\"gen_ai.usage.input_tokens\"] = t.input_tokens;\n if (typeof t.output_tokens === \"number\") out[\"gen_ai.usage.output_tokens\"] = t.output_tokens;\n if (typeof t.total_tokens === \"number\") out[\"gen_ai.usage.total_tokens\"] = t.total_tokens;\n if (typeof t.cache_read_input_tokens === \"number\") out[\"gen_ai.usage.cache_read_input_tokens\"] = t.cache_read_input_tokens;\n if (typeof t.cache_creation_input_tokens === \"number\") out[\"gen_ai.usage.cache_creation_input_tokens\"] = 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 \"component.id\": envelope.component_id,\n \"gen_ai.request.model\": envelope.model,\n \"gen_ai.system\": 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 sessionId?: 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.session_id\": sessionId ?? resolveAgentSessionId(envelope, parentSpanId),\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 \"gen_ai.request.model\": envelope.model,\n \"gen_ai.system\": envelope.adapter,\n \"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 sessionId?: 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.session_id\": sessionId ?? resolveAgentSessionId(envelope),\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 * Agent-axis session id (= the enclosing agent.session run_id). Threaded so\n * inner agent.llm_turn / agent.tool_exec spans carry a non-NULL session_id and\n * join the cross-axis correlation rules (#143 / #140).\n */\n sessionId?: 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 sessionId?: 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 \"agent.session_id\": sessionId,\n \"llm.turn_number\": turnNumber,\n \"gen_ai.request.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 sessionId?: string,\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 \"agent.session_id\": sessionId,\n \"llm.turn_number\": turnNumber,\n \"llm.duration_ms\": durationMs,\n \"gen_ai.usage.input_tokens\": tokenAttrs?.inputTokens,\n \"gen_ai.usage.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 sessionId?: string,\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 \"agent.session_id\": sessionId,\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 sessionId?: string,\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 \"agent.session_id\": sessionId,\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 \"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 type McpToolFn = (\n name: string,\n description: string,\n inputSchema: Record<string, unknown>,\n handler: (\n args: Record<string, unknown>,\n extra: unknown,\n ) => Promise<{ content: Array<{ type: string; text: string }> }>,\n ) => unknown;\n\n const toolFn = sdk.tool as McpToolFn | undefined;\n const createServer = sdk.createSdkMcpServer as\n | ((options: {\n name: string;\n version?: string;\n tools?: unknown[];\n }) => 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 const zodType = jsonSchemaToZod(t.inputSchema);\n const shape =\n zodType instanceof z.ZodObject\n ? (zodType.shape as Record<string, unknown>)\n : {};\n\n return toolFn(\n t.name,\n t.description,\n shape,\n async (args) => {\n const text = await t.handler(\n (args ?? {}) as Record<string, unknown>,\n );\n return { content: [{ type: \"text\", text }] };\n },\n );\n });\n\n return createServer({\n name: \"aaac-library-tools\",\n version: \"1.0.0\",\n tools: sdkTools,\n });\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"]}