@aaac/runtime 0.1.28 → 0.1.30

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,4 +1,4 @@
1
- import { S as SdkAdapter, G as GuardrailHooks, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef, T as TokenUsage } from '../task-runner-D_hvuTLM.js';
1
+ import { S as SdkAdapter, G as GuardrailHooks, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef, T as TokenUsage } from '../task-runner-CeM6vETd.js';
2
2
  import 'zod';
3
3
  import '../context-DKkamYX_.js';
4
4
  import '@aaac/observability';
@@ -7,7 +7,7 @@ import {
7
7
  emitLlmTurnOpen,
8
8
  emitToolExecClose,
9
9
  emitToolExecOpen
10
- } from "../chunk-S7JQJAZS.js";
10
+ } from "../chunk-BU6FB3JB.js";
11
11
 
12
12
  // src/adapters/adk-sdk.ts
13
13
  function sanitizeAgentName(name) {
@@ -1,4 +1,4 @@
1
- import { S as SdkAdapter, G as GuardrailHooks, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef, T as TokenUsage } from '../task-runner-D_hvuTLM.js';
1
+ import { S as SdkAdapter, G as GuardrailHooks, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef, T as TokenUsage } from '../task-runner-CeM6vETd.js';
2
2
  import 'zod';
3
3
  import '../context-DKkamYX_.js';
4
4
  import '@aaac/observability';
@@ -4,7 +4,7 @@ import {
4
4
  emitLlmTurnOpen,
5
5
  emitToolExecClose,
6
6
  emitToolExecOpen
7
- } from "../chunk-S7JQJAZS.js";
7
+ } from "../chunk-BU6FB3JB.js";
8
8
 
9
9
  // src/adapters/claude-agent-sdk.ts
10
10
  function buildClaudeHooks(guardrails) {
@@ -1,4 +1,4 @@
1
- import { S as SdkAdapter, A as AdapterSendOptions, M as MemoryRef } from '../task-runner-D_hvuTLM.js';
1
+ import { S as SdkAdapter, A as AdapterSendOptions, M as MemoryRef } from '../task-runner-CeM6vETd.js';
2
2
  import 'zod';
3
3
  import '../context-DKkamYX_.js';
4
4
  import '@aaac/observability';
@@ -1,4 +1,4 @@
1
- import { S as SdkAdapter, G as GuardrailHooks, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef, T as TokenUsage } from '../task-runner-D_hvuTLM.js';
1
+ import { S as SdkAdapter, G as GuardrailHooks, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef, T as TokenUsage } from '../task-runner-CeM6vETd.js';
2
2
  import 'zod';
3
3
  import '../context-DKkamYX_.js';
4
4
  import '@aaac/observability';
@@ -4,7 +4,7 @@ import {
4
4
  emitLlmTurnOpen,
5
5
  emitToolExecClose,
6
6
  emitToolExecOpen
7
- } from "../chunk-S7JQJAZS.js";
7
+ } from "../chunk-BU6FB3JB.js";
8
8
 
9
9
  // src/adapters/openai-agents-sdk.ts
10
10
  function buildInputGuardrails(guardrails) {
@@ -324,19 +324,26 @@ async function buildClaudeMcpServer(registry) {
324
324
  if (!toolFn || !createServer) return void 0;
325
325
  const { z } = await import("zod");
326
326
  const { jsonSchemaToZod } = await import("./schema-converter-LACA7P4O.js");
327
- const sdkTools = tools.map(
328
- (t) => toolFn({
329
- name: t.name,
330
- description: t.description,
331
- inputSchema: jsonSchemaToZod(t.inputSchema),
332
- execute: async (args) => {
333
- return t.handler(
327
+ const sdkTools = tools.map((t) => {
328
+ const zodType = jsonSchemaToZod(t.inputSchema);
329
+ const shape = zodType instanceof z.ZodObject ? zodType.shape : {};
330
+ return toolFn(
331
+ t.name,
332
+ t.description,
333
+ shape,
334
+ async (args) => {
335
+ const text = await t.handler(
334
336
  args ?? {}
335
337
  );
338
+ return { content: [{ type: "text", text }] };
336
339
  }
337
- })
338
- );
339
- return createServer(sdkTools);
340
+ );
341
+ });
342
+ return createServer({
343
+ name: "aaac-library-tools",
344
+ version: "1.0.0",
345
+ tools: sdkTools
346
+ });
340
347
  }
341
348
  async function buildOpenAIFunctionTools(registry) {
342
349
  const tools = buildSdkFunctionTools(registry);
@@ -412,4 +419,4 @@ export {
412
419
  buildOpenAIFunctionTools,
413
420
  buildAdkFunctionTools
414
421
  };
415
- //# sourceMappingURL=chunk-S7JQJAZS.js.map
422
+ //# sourceMappingURL=chunk-BU6FB3JB.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/lib/observability-bridge.ts","../src/lib/library-tool-sdk.ts"],"sourcesContent":["/**\n * observability-bridge.ts\n *\n * Bridge between @aaac/runtime execution and @aaac/observability agent-axis spans.\n *\n * Responsibilities:\n * - Generate ExecutionEnvelope (run_id = UUIDv7) for every task/workflow execution\n * - Emit agent.session (open/close) for runWorkflow() — root run span\n * - Emit agent.subagent (open/close) for runTask() — handoff/task span\n * - Emit toolchain.execution (open/close) for toolchain tool invocations\n * - Observer is OPTIONAL — all emit* functions are no-ops when observer is undefined\n *\n * No circular dependency: @aaac/observability does NOT import @aaac/runtime.\n * Types (ExecutionEnvelope, EmitInput) are consumed from @aaac/observability.\n *\n * event-catalog.md §1.5, §2.2 / OBSERVABILITY_TASKS.md Phase 1 / architecture.md §6, §7\n */\n\nimport { generateId } from \"@aaac/observability\";\nimport type { ExecutionEnvelope, EmitInput, AttrValue } from \"@aaac/observability\";\n\n// ── Re-exports ────────────────────────────────────────────────────────────────\n\nexport type { ExecutionEnvelope } from \"@aaac/observability\";\n\n// ── TokenUsage ────────────────────────────────────────────────────────────────\n\n/** Token usage metrics returned by LLM adapters after a query/session. */\nexport interface TokenUsage {\n inputTokens: number;\n outputTokens: number;\n totalTokens?: number;\n cacheReadTokens?: number;\n cacheCreationTokens?: number;\n}\n\n// ── Observability env propagation (git-hook correlation, #115) ─────────────────\n\n/** Observability correlation ids propagated to spawned subprocesses. */\nexport interface ObservabilityIds {\n /** Agent-axis session id (= the session/run envelope run_id). */\n sessionId?: string;\n /** Distributed trace id, when available. */\n traceId?: string;\n /** Execution run id (ExecutionEnvelope.run_id). */\n runId?: string;\n}\n\n/** Environment variable names read by `.cursor/hooks/observ-record.sh`. */\nexport const OBSERVABILITY_ENV_VARS = {\n sessionId: \"AAAC_SESSION_ID\",\n traceId: \"AAAC_TRACE_ID\",\n runId: \"AAAC_RUN_ID\",\n} as const;\n\n/**\n * Build a subprocess environment that propagates the active observability\n * correlation ids as AAAC_SESSION_ID / AAAC_TRACE_ID / AAAC_RUN_ID.\n *\n * When @aaac/runtime spawns `git` (directly via a toolchain check, or\n * indirectly through an agent shell), the git `post-commit` hook runs\n * `.cursor/hooks/observ-record.sh`, whose highest-priority session_id source is\n * `$AAAC_SESSION_ID` (#115). Propagating these ids lets the promotion.commit /\n * promotion.file events emitted by the hook correlate to the originating agent\n * session.\n *\n * Returns a shallow clone of {@link baseEnv}; only ids that are defined and\n * non-empty are set, so the child never inherits empty/stale values.\n */\nexport function buildObservabilityEnv(\n ids: ObservabilityIds,\n baseEnv: NodeJS.ProcessEnv = process.env,\n): NodeJS.ProcessEnv {\n const env: NodeJS.ProcessEnv = { ...baseEnv };\n if (ids.sessionId) env[OBSERVABILITY_ENV_VARS.sessionId] = ids.sessionId;\n if (ids.traceId) env[OBSERVABILITY_ENV_VARS.traceId] = ids.traceId;\n if (ids.runId) env[OBSERVABILITY_ENV_VARS.runId] = ids.runId;\n return env;\n}\n\n// ── ObserverEmitFn ────────────────────────────────────────────────────────────\n\n/**\n * Minimal observer emit signature — structurally matches EventCollector.emit().\n * Pass `collector.emit.bind(collector)` to wire up the full observability pipeline.\n * When undefined, all emission is a no-op.\n */\nexport type ObserverEmitFn = (event: EmitInput) => void;\n\n// ── Envelope creation ─────────────────────────────────────────────────────────\n\nexport interface EnvelopeParams {\n /** run_id of the parent execution (populated by workflow-runner for task spans). */\n parentRunId?: string;\n /** Component / agent identifier from the agent-contracts definition. */\n componentId?: string;\n /** Agent that issued this execution (handoff source). */\n fromAgent?: string;\n /** Agent that receives this execution (handoff target). */\n toAgent?: string;\n /** agent-contracts schema version. */\n contractVersion?: string;\n /** LLM adapter identifier (e.g. 'claude-agent-sdk'). */\n adapter?: string;\n /** LLM model identifier (e.g. 'claude-opus-4-5'). */\n model?: string;\n /** Task instance identifier within the run. */\n taskInstanceId?: string;\n}\n\n/**\n * Create an ExecutionEnvelope with a fresh UUIDv7 run_id and current timestamp.\n * Only defined fields are included — undefined values are omitted.\n */\nexport function createExecutionEnvelope(params: EnvelopeParams = {}): ExecutionEnvelope {\n const envelope: ExecutionEnvelope = {\n run_id: generateId(),\n timestamp: new Date().toISOString(),\n };\n if (params.parentRunId !== undefined) envelope.parent_run_id = params.parentRunId;\n if (params.componentId !== undefined) envelope.component_id = params.componentId;\n if (params.fromAgent !== undefined) envelope.from_agent = params.fromAgent;\n if (params.toAgent !== undefined) envelope.to_agent = params.toAgent;\n if (params.contractVersion !== undefined) envelope.contract_version = params.contractVersion;\n if (params.adapter !== undefined) envelope.adapter = params.adapter;\n if (params.model !== undefined) envelope.model = params.model;\n if (params.taskInstanceId !== undefined) envelope.task_instance_id = params.taskInstanceId;\n return envelope;\n}\n\n// ── attribute builder helpers ─────────────────────────────────────────────────\n\n/** Build attribute record; omits keys with undefined/empty-string values. */\nfunction attrs(base: Record<string, AttrValue | undefined>): Record<string, AttrValue> {\n const out: Record<string, AttrValue> = {};\n for (const [k, v] of Object.entries(base)) {\n if (v !== undefined && v !== \"\") out[k] = v;\n }\n return out;\n}\n\n/** 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/** 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 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 \"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 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 \"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 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 \"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 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 \"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"]}
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/** 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 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 \"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 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 \"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 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 \"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 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 \"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 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":";AAkBA,SAAS,kBAAkB;AA+BpB,IAAM,yBAAyB;AAAA,EACpC,WAAW;AAAA,EACX,SAAS;AAAA,EACT,OAAO;AACT;AAgBO,SAAS,sBACd,KACA,UAA6B,QAAQ,KAClB;AACnB,QAAM,MAAyB,EAAE,GAAG,QAAQ;AAC5C,MAAI,IAAI,UAAW,KAAI,uBAAuB,SAAS,IAAI,IAAI;AAC/D,MAAI,IAAI,QAAS,KAAI,uBAAuB,OAAO,IAAI,IAAI;AAC3D,MAAI,IAAI,MAAO,KAAI,uBAAuB,KAAK,IAAI,IAAI;AACvD,SAAO;AACT;AAoCO,SAAS,wBAAwB,SAAyB,CAAC,GAAsB;AACtF,QAAM,WAA8B;AAAA,IAClC,QAAQ,WAAW;AAAA,IACnB,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,EACpC;AACA,MAAI,OAAO,gBAAgB,OAAW,UAAS,gBAAgB,OAAO;AACtE,MAAI,OAAO,gBAAgB,OAAW,UAAS,eAAe,OAAO;AACrE,MAAI,OAAO,cAAc,OAAW,UAAS,aAAa,OAAO;AACjE,MAAI,OAAO,YAAY,OAAW,UAAS,WAAW,OAAO;AAC7D,MAAI,OAAO,oBAAoB,OAAW,UAAS,mBAAmB,OAAO;AAC7E,MAAI,OAAO,YAAY,OAAW,UAAS,UAAU,OAAO;AAC5D,MAAI,OAAO,UAAU,OAAW,UAAS,QAAQ,OAAO;AACxD,MAAI,OAAO,mBAAmB,OAAW,UAAS,mBAAmB,OAAO;AAC5E,SAAO;AACT;AAKA,SAAS,MAAM,MAAwE;AACrF,QAAM,MAAiC,CAAC;AACxC,aAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,IAAI,GAAG;AACzC,QAAI,MAAM,UAAa,MAAM,GAAI,KAAI,CAAC,IAAI;AAAA,EAC5C;AACA,SAAO;AACT;AAGA,SAAS,sBAAsB,UAA6B,cAA+B;AACzF,SAAO,SAAS,iBAAiB,gBAAgB,SAAS;AAC5D;AAGA,SAAS,WAAW,MAA0D;AAC5E,QAAM,MAAiC,CAAC;AACxC,QAAM,KAAK,KAAK;AAChB,MAAI,MAAM,OAAO,OAAO,UAAU;AAChC,UAAM,IAAI;AACV,QAAI,OAAO,EAAE,iBAAiB,SAAU,KAAI,mBAAmB,IAAI,EAAE;AACrE,QAAI,OAAO,EAAE,kBAAkB,SAAU,KAAI,oBAAoB,IAAI,EAAE;AACvE,QAAI,OAAO,EAAE,iBAAiB,SAAU,KAAI,mBAAmB,IAAI,EAAE;AACrE,QAAI,OAAO,EAAE,4BAA4B,SAAU,KAAI,wBAAwB,IAAI,EAAE;AACrF,QAAI,OAAO,EAAE,gCAAgC,SAAU,KAAI,4BAA4B,IAAI,EAAE;AAAA,EAC/F;AACA,MAAI,OAAO,KAAK,aAAa,SAAU,KAAI,UAAU,IAAI,KAAK;AAC9D,SAAO;AACT;AAeO,SAAS,gBACd,UACA,UACA,YACoB;AACpB,MAAI,CAAC,SAAU,QAAO;AAEtB,QAAM,SAAS,SAAS;AACxB,WAAS;AAAA,IACP,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,WAAW;AAAA,IACX;AAAA,IACA,cAAc,SAAS;AAAA,IACvB,YAAY,MAAM;AAAA,MAChB,MAAM;AAAA,MACN,oBAAoB,SAAS;AAAA,MAC7B,gBAAgB,SAAS;AAAA,MACzB,eAAe;AAAA,MACf,sBAAsB,SAAS;AAAA,MAC/B,eAAe,SAAS;AAAA,MACxB,SAAS,SAAS;AAAA,MAClB,kBAAkB,SAAS;AAAA,IAC7B,CAAC;AAAA,EACH,CAAC;AACD,SAAO;AACT;AAUO,SAAS,iBACd,UACA,QACA,UACA,YACA,QACA,cACM;AACN,MAAI,CAAC,SAAU;AAEf,QAAM,YACJ,SAAS,qBAAqB,WAAW,SAAS,kBAAkB,IAAI,CAAC;AAE3E,WAAS;AAAA,IACP,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,WAAW;AAAA,IACX;AAAA,IACA,YAAY;AAAA,MACV,GAAG,MAAM;AAAA,QACP,MAAM;AAAA,QACN,oBAAoB,SAAS;AAAA,QAC7B,6BAA6B;AAAA,QAC7B,gBAAgB;AAAA,QAChB,eAAe;AAAA,MACjB,CAAC;AAAA,MACD,GAAG;AAAA,IACL;AAAA,EACF,CAAC;AACH;AAeO,SAAS,iBACd,UACA,UACA,cACA,QACA,WACA,WACoB;AACpB,MAAI,CAAC,SAAU,QAAO;AAEtB,QAAM,SAAS,SAAS;AACxB,WAAS;AAAA,IACP,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,WAAW;AAAA,IACX;AAAA,IACA;AAAA,IACA,YAAY,MAAM;AAAA,MAChB,MAAM;AAAA,MACN,oBAAoB,aAAa,sBAAsB,UAAU,YAAY;AAAA,MAC7E,cAAc;AAAA,MACd,cAAc;AAAA,MACd,WAAW;AAAA,MACX,gBAAgB,SAAS;AAAA,MACzB,uBAAuB,SAAS;AAAA,MAChC,eAAe,SAAS;AAAA,MACxB,SAAS,SAAS;AAAA,MAClB,sBAAsB,SAAS;AAAA,MAC/B,oBAAoB,SAAS;AAAA,MAC7B,kBAAkB,SAAS;AAAA,IAC7B,CAAC;AAAA,EACH,CAAC;AACD,SAAO;AACT;AAWO,SAAS,kBACd,UACA,QACA,UACA,YACA,QACA,WACA,cACA,WACM;AACN,MAAI,CAAC,SAAU;AAEf,QAAM,YACJ,SAAS,qBAAqB,WAAW,SAAS,kBAAkB,IAAI,CAAC;AAE3E,WAAS;AAAA,IACP,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,WAAW;AAAA,IACX;AAAA,IACA,YAAY;AAAA,MACV,GAAG,MAAM;AAAA,QACP,MAAM;AAAA,QACN,oBAAoB,aAAa,sBAAsB,QAAQ;AAAA,QAC/D,cAAc;AAAA,QACd,gBAAgB;AAAA,QAChB,qBAAqB;AAAA,QACrB,eAAe;AAAA,MACjB,CAAC;AAAA,MACD,GAAG;AAAA,IACL;AAAA,EACF,CAAC;AACH;AAUO,SAAS,kBACd,UACA,cACA,gBACA,QACA,iBACA,eACoB;AACpB,MAAI,CAAC,SAAU,QAAO;AAEtB,QAAM,SAAS,WAAW;AAC1B,WAAS;AAAA,IACP,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,WAAW;AAAA,IACX;AAAA,IACA;AAAA,IACA,YAAY,MAAM;AAAA,MAChB,MAAM;AAAA,MACN,iBAAiB;AAAA,MACjB,oBAAoB;AAAA,MACpB,sBAAsB;AAAA,MACtB,2BAA2B;AAAA,IAC7B,CAAC;AAAA,EACH,CAAC;AACD,SAAO;AACT;AAKO,SAAS,mBACd,UACA,QACA,gBACA,iBACA,SACA,YACA,kBACM;AACN,MAAI,CAAC,SAAU;AAEf,WAAS;AAAA,IACP,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,WAAW;AAAA,IACX;AAAA,IACA,YAAY,MAAM;AAAA,MAChB,MAAM;AAAA,MACN,iBAAiB;AAAA,MACjB,sBAAsB;AAAA,MACtB,oBAAoB;AAAA,MACpB,wBAAwB;AAAA,MACxB,8BAA8B;AAAA,IAChC,CAAC;AAAA,EACH,CAAC;AACH;AAKO,SAAS,oBACd,UACA,cACA,gBACA,iBACA,iBACM;AACN,MAAI,CAAC,SAAU;AAEf,QAAM,SAAS,WAAW;AAC1B,WAAS;AAAA,IACP,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,WAAW;AAAA,IACX;AAAA,IACA;AAAA,IACA,YAAY,MAAM;AAAA,MAChB,MAAM;AAAA,MACN,iBAAiB;AAAA,MACjB,6BAA6B;AAAA,MAC7B,6BAA6B;AAAA,IAC/B,CAAC;AAAA,EACH,CAAC;AACH;AAwBO,SAAS,gBACd,UACA,cACA,YACA,OACA,WACA,WACoB;AACpB,MAAI,CAAC,SAAU,QAAO;AAEtB,QAAM,SAAS,WAAW;AAC1B,WAAS;AAAA,IACP,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,WAAW;AAAA,IACX;AAAA,IACA;AAAA,IACA,YAAY,MAAM;AAAA,MAChB,MAAM;AAAA,MACN,oBAAoB;AAAA,MACpB,mBAAmB;AAAA,MACnB,aAAa;AAAA,MACb,mBAAmB,WAAW;AAAA,MAC9B,wBAAwB,WAAW;AAAA,IACrC,CAAC;AAAA,EACH,CAAC;AACD,SAAO;AACT;AAKO,SAAS,iBACd,UACA,QACA,YACA,YACAA,aAMA,WACM;AACN,MAAI,CAAC,SAAU;AAEf,WAAS;AAAA,IACP,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,WAAW;AAAA,IACX;AAAA,IACA,YAAY,MAAM;AAAA,MAChB,MAAM;AAAA,MACN,oBAAoB;AAAA,MACpB,mBAAmB;AAAA,MACnB,mBAAmB;AAAA,MACnB,oBAAoBA,aAAY;AAAA,MAChC,qBAAqBA,aAAY;AAAA,MACjC,wBAAwBA,aAAY;AAAA,MACpC,wBAAwBA,aAAY;AAAA,IACtC,CAAC;AAAA,EACH,CAAC;AACH;AAUO,SAAS,iBACd,UACA,cACA,UACA,cACA,YACA,WACoB;AACpB,MAAI,CAAC,SAAU,QAAO;AAEtB,QAAM,SAAS,WAAW;AAC1B,WAAS;AAAA,IACP,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,WAAW;AAAA,IACX;AAAA,IACA;AAAA,IACA,YAAY,MAAM;AAAA,MAChB,MAAM;AAAA,MACN,oBAAoB;AAAA,MACpB,aAAa;AAAA,MACb,sBAAsB;AAAA,MACtB,mBAAmB;AAAA,IACrB,CAAC;AAAA,EACH,CAAC;AACD,SAAO;AACT;AAKO,SAAS,kBACd,UACA,QACA,UACA,YACA,WACM;AACN,MAAI,CAAC,SAAU;AAEf,WAAS;AAAA,IACP,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,WAAW;AAAA,IACX;AAAA,IACA,YAAY,MAAM;AAAA,MAChB,MAAM;AAAA,MACN,oBAAoB;AAAA,MACpB,aAAa;AAAA,MACb,oBAAoB;AAAA,IACtB,CAAC;AAAA,EACH,CAAC;AACH;AAUO,SAAS,kBACd,UACA,cACA,aACA,WACA,aACA,aACoB;AACpB,MAAI,CAAC,SAAU,QAAO;AAEtB,QAAM,SAAS,WAAW;AAC1B,WAAS;AAAA,IACP,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,WAAW;AAAA,IACX;AAAA,IACA;AAAA,IACA,YAAY,MAAM;AAAA,MAChB,MAAM;AAAA,MACN,gBAAgB;AAAA,MAChB,uBAAuB;AAAA,MACvB,0BAA0B,YAAY,KAAK,GAAG;AAAA,MAC9C,sBAAsB;AAAA,IACxB,CAAC;AAAA,EACH,CAAC;AACD,SAAO;AACT;AAKO,SAAS,mBACd,UACA,QACA,aACA,WACA,YACA,QACA,cACM;AACN,MAAI,CAAC,SAAU;AAEf,WAAS;AAAA,IACP,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,WAAW;AAAA,IACX;AAAA,IACA,YAAY,MAAM;AAAA,MAChB,MAAM;AAAA,MACN,gBAAgB;AAAA,MAChB,uBAAuB;AAAA,MACvB,oBAAoB;AAAA,MACpB,yBAAyB;AAAA,MACzB,GAAI,eAAe,EAAE,mBAAmB,aAAa,IAAI,CAAC;AAAA,IAC5D,CAAC;AAAA,EACH,CAAC;AACH;;;ACnmBO,SAAS,sBACd,UACmB;AACnB,SAAO,SAAS,OAAO,EAAE,IAAI,CAAC,SAAS;AAAA,IACrC,MAAM,IAAI;AAAA,IACV,aAAa,IAAI;AAAA,IACjB,aAAa,IAAI,eAAe,EAAE,MAAM,UAAU,YAAY,CAAC,EAAE;AAAA,IACjE,SAAS,OAAO,SAAmD;AACjE,YAAM,SAAS,MAAM,SAAS,QAAQ,IAAI,QAAQ,IAAI;AACtD,aAAO,OAAO,WAAW,WAAW,SAAS,KAAK,UAAU,MAAM;AAAA,IACpE;AAAA,EACF,EAAE;AACJ;AAeA,eAAsB,qBACpB,UAC8B;AAC9B,QAAM,QAAQ,sBAAsB,QAAQ;AAC5C,MAAI,MAAM,WAAW,EAAG,QAAO;AAE/B,QAAM,MAAO,MAAM,OAAO,gCAAgC;AAc1D,QAAM,SAAS,IAAI;AACnB,QAAM,eAAe,IAAI;AAQzB,MAAI,CAAC,UAAU,CAAC,aAAc,QAAO;AAErC,QAAM,EAAE,EAAE,IAAI,MAAM,OAAO,KAAK;AAChC,QAAM,EAAE,gBAAgB,IAAI,MAAM,OAAO,gCAAuB;AAEhE,QAAM,WAAW,MAAM,IAAI,CAAC,MAAM;AAChC,UAAM,UAAU,gBAAgB,EAAE,WAAW;AAC7C,UAAM,QACJ,mBAAmB,EAAE,YAChB,QAAQ,QACT,CAAC;AAEP,WAAO;AAAA,MACL,EAAE;AAAA,MACF,EAAE;AAAA,MACF;AAAA,MACA,OAAO,SAAS;AACd,cAAM,OAAO,MAAM,EAAE;AAAA,UAClB,QAAQ,CAAC;AAAA,QACZ;AACA,eAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAAQ,KAAK,CAAC,EAAE;AAAA,MAC7C;AAAA,IACF;AAAA,EACF,CAAC;AAED,SAAO,aAAa;AAAA,IAClB,MAAM;AAAA,IACN,SAAS;AAAA,IACT,OAAO;AAAA,EACT,CAAC;AACH;AAYA,eAAsB,yBACpB,UACoB;AACpB,QAAM,QAAQ,sBAAsB,QAAQ;AAC5C,MAAI,MAAM,WAAW,EAAG,QAAO,CAAC;AAEhC,MAAI;AACF,UAAM,MAAO,MAAM,OAAO,gBAAgB;AAC1C,UAAM,SAAS,IAAI;AAInB,QAAI,QAAQ;AACV,YAAM,EAAE,gBAAgB,IAAI,MAAM,OAAO,gCAAuB;AAChE,aAAO,MAAM;AAAA,QAAI,CAAC,MAChB,OAAO;AAAA,UACL,MAAM,EAAE;AAAA,UACR,aAAa,EAAE;AAAA,UACf,YAAY,gBAAgB,EAAE,WAAW;AAAA,UACzC,SAAS,OAAO,MAAe,SAAkB;AAC/C,mBAAO,EAAE;AAAA,cACN,QAAQ,CAAC;AAAA,YACZ;AAAA,UACF;AAAA,QACF,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF,QAAQ;AAAA,EAER;AAEA,SAAO,MAAM,IAAI,CAAC,OAAO;AAAA,IACvB,MAAM;AAAA,IACN,UAAU;AAAA,MACR,MAAM,EAAE;AAAA,MACR,aAAa,EAAE;AAAA,MACf,YAAY,EAAE;AAAA,IAChB;AAAA,IACA,SAAS,OAAO,SAAkB;AAChC,aAAO,EAAE;AAAA,QACN,QAAQ,CAAC;AAAA,MACZ;AAAA,IACF;AAAA,EACF,EAAE;AACJ;AAYA,eAAsB,sBACpB,UACoB;AACpB,QAAM,QAAQ,sBAAsB,QAAQ;AAC5C,MAAI,MAAM,WAAW,EAAG,QAAO,CAAC;AAEhC,SAAO,MAAM,IAAI,CAAC,OAAO;AAAA,IACvB,MAAM,EAAE;AAAA,IACR,aAAa,EAAE;AAAA,IACf,aAAa,EAAE;AAAA,IACf,SAAS,OAAO,SAAkB;AAChC,aAAO,EAAE;AAAA,QACN,QAAQ,CAAC;AAAA,MACZ;AAAA,IACF;AAAA,EACF,EAAE;AACJ;","names":["tokenAttrs"]}
package/dist/index.d.ts CHANGED
@@ -1,5 +1,5 @@
1
- import { O as ObserverEmitFn, b as TaskContext, c as TaskOutcome, d as AgentContractLike, e as TaskContractLike, P as PromptBuilderOptions, W as WorkflowResult, S as SdkAdapter, f as WorkflowRegistries, H as HandoffInput, g as StepCompleteEvent, h as StepResult, D as DelegateStep, i as GuardrailRuleData, j as MemoryStore, M as MemoryRef, k as SdkFunctionTool, G as GuardrailHooks, R as ResolvedComponent, l as ArtifactBindingConfig, m as RunToolchainChecksOptions, n as TaskRunResult, L as LibraryToolRegistry, o as ResolvedToolchain, p as LibraryToolDefinition, q as HookResponse, r as GuardrailCheckResult } from './task-runner-D_hvuTLM.js';
2
- export { s as AdapterOrFactory, A as AdapterSendOptions, a as AgentExecutionRequest, t as AgentProgressEvent, B as BoundResolveOptions, u as BoundResolver, C as CacheConfig, v as CandidateAgent, w as ConvergenceEnvelope, x as ConvergenceEnvelopePayload, E as EnvelopeParams, y as EvaluateStep, z as GateStep, F as GuardrailCheckFunctions, I as GuardrailRule, J as HookContext, K as InMemoryStore, N as InnerSpanOptions, Q as ModelAwareSdkAdapterFactory, U as ModelClass, V as ModelMappingConfig, X as ModelResolver, Y as ModelResolverOptions, Z as OBSERVABILITY_ENV_VARS, _ as ObservabilityIds, $ as ReceiveSpec, a0 as ResolvedModel, a1 as RetryDecision, a2 as SdkAdapterFactory, a3 as SplitPrompt, a4 as TaskRunOptions, T as TokenUsage, a5 as ToolchainCheckResult, a6 as ToolchainManifest, a7 as ToolchainManifestSchema, a8 as WorkflowContractLike, a9 as WorkflowInvocation, aa as WorkflowRunOptions, ab as WorkflowStep, ac as buildCandidateAgents, ad as buildGateEvaluationPrompt, ae as buildObservabilityEnv, af as buildPerAgentGuardrails, ag as buildRetryFollowUp, ah as buildSdkFunctionTools, ai as buildSplitTaskPrompt, aj as buildTaskPrompt, ak as createExecutionEnvelope, al as createGuardrailHooks, am as createGuardrailHooksForAgent, an as createGuardrailHooksFromRules, ao as createLibraryToolRegistry, ap as createModelResolver, aq as createRegistryFromSdkTools, ar as deriveToolchainsForAgents, as as emitIterationClose, at as emitIterationMetric, au as emitIterationOpen, av as emitLlmTurnClose, aw as emitLlmTurnOpen, ax as emitSessionClose, ay as emitSessionOpen, az as emitSubagentClose, aA as emitSubagentOpen, aB as emitToolExecClose, aC as emitToolExecOpen, aD as emitToolchainClose, aE as emitToolchainOpen, aF as extractStructuredResult, aG as getBlockingViolations, aH as getEffectiveGuardrailIds, aI as getGuardrailRulesForAgent, aJ as getWarnings, aK as guardrailContextToRuleData, aL as hasBlockingViolation, aM as isNavigationIndex, aN as parseGateEvaluationResponse, aO as renderAgentSystemPrompt, aP as renderNavigationIndexPrompt, aQ as runTask, aR as runToolchainChecks, aS as runWorkflow, aT as zodSchemaToPromptDescription, aU as zodSchemaToYamlExample } from './task-runner-D_hvuTLM.js';
1
+ import { O as ObserverEmitFn, b as TaskContext, c as TaskOutcome, d as AgentContractLike, e as TaskContractLike, P as PromptBuilderOptions, W as WorkflowResult, S as SdkAdapter, f as WorkflowRegistries, H as HandoffInput, g as StepCompleteEvent, h as StepResult, D as DelegateStep, i as GuardrailRuleData, j as MemoryStore, M as MemoryRef, k as SdkFunctionTool, G as GuardrailHooks, R as ResolvedComponent, l as ArtifactBindingConfig, m as RunToolchainChecksOptions, n as ModelMappingConfig, o as TaskRunResult, L as LibraryToolRegistry, p as ResolvedToolchain, q as LibraryToolDefinition, r as HookResponse, s as GuardrailCheckResult } from './task-runner-CeM6vETd.js';
2
+ export { t as AdapterOrFactory, A as AdapterSendOptions, a as AgentExecutionRequest, u as AgentProgressEvent, B as BoundResolveOptions, v as BoundResolver, C as CacheConfig, w as CandidateAgent, x as ConvergenceEnvelope, y as ConvergenceEnvelopePayload, E as EnvelopeParams, z as EvaluateStep, F as GateStep, I as GuardrailCheckFunctions, J as GuardrailRule, K as HookContext, N as InMemoryStore, Q as InnerSpanOptions, U as ModelAwareSdkAdapterFactory, V as ModelClass, X as ModelResolver, Y as ModelResolverOptions, Z as OBSERVABILITY_ENV_VARS, _ as ObservabilityIds, $ as ReceiveSpec, a0 as ResolvedModel, a1 as RetryDecision, a2 as SdkAdapterFactory, a3 as SplitPrompt, a4 as TaskRunOptions, T as TokenUsage, a5 as ToolchainCheckResult, a6 as ToolchainManifest, a7 as ToolchainManifestSchema, a8 as WorkflowContractLike, a9 as WorkflowInvocation, aa as WorkflowRunOptions, ab as WorkflowStep, ac as buildCandidateAgents, ad as buildGateEvaluationPrompt, ae as buildObservabilityEnv, af as buildPerAgentGuardrails, ag as buildRetryFollowUp, ah as buildSdkFunctionTools, ai as buildSplitTaskPrompt, aj as buildTaskPrompt, ak as collectAnalyzerToolIds, al as createExecutionEnvelope, am as createGuardrailHooks, an as createGuardrailHooksForAgent, ao as createGuardrailHooksFromRules, ap as createLibraryToolRegistry, aq as createModelResolver, ar as createRegistryFromSdkTools, as as deriveToolchainsForAgents, at as emitIterationClose, au as emitIterationMetric, av as emitIterationOpen, aw as emitLlmTurnClose, ax as emitLlmTurnOpen, ay as emitSessionClose, az as emitSessionOpen, aA as emitSubagentClose, aB as emitSubagentOpen, aC as emitToolExecClose, aD as emitToolExecOpen, aE as emitToolchainClose, aF as emitToolchainOpen, aG as extractStructuredResult, aH as getBlockingViolations, aI as getEffectiveGuardrailIds, aJ as getGuardrailRulesForAgent, aK as getWarnings, aL as guardrailContextToRuleData, aM as hasBlockingViolation, aN as isNavigationIndex, aO as parseGateEvaluationResponse, aP as renderAgentSystemPrompt, aQ as renderAnalyzerExplorationMandatePrompt, aR as renderNavigationIndexPrompt, aS as runTask, aT as runToolchainChecks, aU as runWorkflow, aV as shouldInjectAnalyzerExplorationMandate, aW as zodSchemaToPromptDescription, aX as zodSchemaToYamlExample } from './task-runner-CeM6vETd.js';
3
3
  import { z } from 'zod';
4
4
  import { OperationIR, ComponentIR } from '@aaac/contracts';
5
5
  import { ResolvedConfig } from './generator/index.js';
@@ -510,6 +510,8 @@ interface ExecuteOptions {
510
510
  * Only consumed by executeWorkflow (toolchain checks are a run-level concern).
511
511
  */
512
512
  toolchain?: RunToolchainChecksOptions;
513
+ /** Per-class adapter/model mapping from project.yaml (used by executeWorkflow). */
514
+ modelMapping?: ModelMappingConfig;
513
515
  }
514
516
  interface TaskHookContext {
515
517
  adapter: SdkAdapter;
@@ -863,4 +865,4 @@ declare function executePrompt(message: string, ir: ComponentIR, binding: Runtim
863
865
  /** Package version string. */
864
866
  declare const version: string;
865
867
 
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 };
868
+ 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, ModelMappingConfig, 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 };
package/dist/index.js CHANGED
@@ -26,7 +26,7 @@ import {
26
26
  emitToolExecOpen,
27
27
  emitToolchainClose,
28
28
  emitToolchainOpen
29
- } from "./chunk-S7JQJAZS.js";
29
+ } from "./chunk-BU6FB3JB.js";
30
30
  import {
31
31
  buildGuardrailContext,
32
32
  loadProjectConfig
@@ -618,9 +618,39 @@ Artifacts: ${ids.length}`
618
618
  }
619
619
  return sections.join("\n\n");
620
620
  }
621
+ function collectAnalyzerToolIds(registry) {
622
+ if (!registry) return [];
623
+ return registry.getAll().map((def) => def.toolId).filter((id) => id.startsWith("analyzer."));
624
+ }
625
+ function shouldInjectAnalyzerExplorationMandate(context) {
626
+ return isNavigationIndex(context.variables?.navigationIndex);
627
+ }
628
+ function renderAnalyzerExplorationMandatePrompt(toolIds) {
629
+ const tools = toolIds.length > 0 ? toolIds.map((id) => `- \`${id}\``).join("\n") : "- `analyzer.generateContextPack`\n- `analyzer.analyzeImpact`\n- `analyzer.buildCallGraph`";
630
+ return [
631
+ "## Codebase Exploration Protocol (Level 1)",
632
+ "",
633
+ "A Project Navigation Index is provided in the user prompt. When you need to",
634
+ "investigate the codebase (locate affected files, trace dependencies, or scope",
635
+ "changes), you MUST use the analyzer MCP tools **before** ad-hoc Read/Grep/Glob:",
636
+ "",
637
+ "1. Use the navigation index to pick candidate artifacts and path patterns.",
638
+ "2. Call `analyzer.generateContextPack` with your `changed[]` paths and a token budget.",
639
+ "3. Call `analyzer.analyzeImpact` with the same `changed[]` paths.",
640
+ "4. Use Read/Grep/Glob only for gaps the analyzer output did not cover.",
641
+ "",
642
+ "Available analyzer tools:",
643
+ tools
644
+ ].join("\n");
645
+ }
621
646
  function buildSplitTaskPrompt(agent, task, context, options) {
622
647
  const system = [];
623
648
  system.push(renderAgentSystemPrompt(agent));
649
+ if (options?.analyzerExploration?.toolIds.length && shouldInjectAnalyzerExplorationMandate(context)) {
650
+ system.push(
651
+ renderAnalyzerExplorationMandatePrompt(options.analyzerExploration.toolIds)
652
+ );
653
+ }
624
654
  system.push(`## Task: ${task.id}
625
655
 
626
656
  ${task.description}`);
@@ -893,15 +923,22 @@ async function runTask(adapter, taskId, context, options) {
893
923
  taskInstanceId: taskId,
894
924
  componentId: agentContract.id,
895
925
  fromAgent: agentContract.id,
896
- parentRunId: options?.parentSpanId
926
+ parentRunId: options?.parentSpanId,
897
927
  // correlates to agent.session run_id
928
+ adapter: options?.envelopeAdapter,
929
+ model: options?.envelopeModel
898
930
  });
899
931
  const modifiedContext = await pluginRegistry.runBeforeTask(taskId, context);
900
932
  if (modifiedContext === null) {
901
933
  return { outcome: { status: "error", message: `Task "${taskId}" skipped by plugin` }, follow_ups_used: 0, retries_used: 0 };
902
934
  }
903
935
  const enrichedContext = pluginRegistry.applyContextEnhancers(taskId, modifiedContext);
904
- const promptOpts = { handoffSchemas: schemas, retry: options?.retry };
936
+ const analyzerToolIds = collectAnalyzerToolIds(options?.libraryTools);
937
+ const promptOpts = {
938
+ handoffSchemas: schemas,
939
+ retry: options?.retry,
940
+ ...analyzerToolIds.length > 0 && shouldInjectAnalyzerExplorationMandate(enrichedContext) ? { analyzerExploration: { toolIds: analyzerToolIds } } : {}
941
+ };
905
942
  const builderArgs = { agent: agentContract, task, context: enrichedContext, options: promptOpts };
906
943
  let prompt;
907
944
  let splitPrompt;
@@ -1266,7 +1303,8 @@ function resolveInvocation(invocation) {
1266
1303
  progressOutput: invocation.progressOutput,
1267
1304
  observer: invocation.observer,
1268
1305
  toolchain: invocation.toolchain,
1269
- libraryTools: invocation.libraryTools
1306
+ libraryTools: invocation.libraryTools,
1307
+ resolveModelMeta: invocation.resolveModelMeta
1270
1308
  }
1271
1309
  };
1272
1310
  }
@@ -1314,7 +1352,12 @@ async function runWorkflow(adapterOrFactory, workflowIdOrInvocation, optionsOrRe
1314
1352
  };
1315
1353
  }
1316
1354
  await pluginRegistry.runBeforeWorkflow(workflowId, options.user_request);
1317
- const sessionEnvelope = createExecutionEnvelope({ componentId: workflowId });
1355
+ const sessionMeta = options.resolveModelMeta?.(void 0);
1356
+ const sessionEnvelope = createExecutionEnvelope({
1357
+ componentId: workflowId,
1358
+ adapter: sessionMeta?.adapter,
1359
+ model: sessionMeta?.model
1360
+ });
1318
1361
  const sessionSpanId = emitSessionOpen(options.observer, sessionEnvelope, workflowId);
1319
1362
  const workflowStart = Date.now();
1320
1363
  let wfResult;
@@ -1378,7 +1421,7 @@ async function runWorkflow(adapterOrFactory, workflowIdOrInvocation, optionsOrRe
1378
1421
  const evaluateExecCount = /* @__PURE__ */ new Map();
1379
1422
  const iterationSpanIds = /* @__PURE__ */ new Map();
1380
1423
  const loopInjectedVars = {};
1381
- async function executeStep(i, stepAdapter) {
1424
+ async function executeStep(i, stepAdapter, envelopeMeta) {
1382
1425
  const step = workflow.steps[i];
1383
1426
  const stepStart = Date.now();
1384
1427
  if (step.type === "gate") {
@@ -1415,7 +1458,9 @@ async function runWorkflow(adapterOrFactory, workflowIdOrInvocation, optionsOrRe
1415
1458
  observer: options.observer,
1416
1459
  parentSpanId: iterationSpanId ?? sessionSpanId,
1417
1460
  sessionId: sessionSpanId ?? sessionEnvelope.run_id,
1418
- libraryTools: options.libraryTools
1461
+ libraryTools: options.libraryTools,
1462
+ envelopeAdapter: envelopeMeta?.adapter,
1463
+ envelopeModel: envelopeMeta?.model
1419
1464
  });
1420
1465
  return {
1421
1466
  step_index: i,
@@ -1478,7 +1523,9 @@ async function runWorkflow(adapterOrFactory, workflowIdOrInvocation, optionsOrRe
1478
1523
  observer: options.observer,
1479
1524
  parentSpanId: sessionSpanId,
1480
1525
  sessionId: sessionSpanId ?? sessionEnvelope.run_id,
1481
- libraryTools: options.libraryTools
1526
+ libraryTools: options.libraryTools,
1527
+ envelopeAdapter: envelopeMeta?.adapter,
1528
+ envelopeModel: envelopeMeta?.model
1482
1529
  });
1483
1530
  return {
1484
1531
  step_index: i,
@@ -1521,7 +1568,8 @@ async function runWorkflow(adapterOrFactory, workflowIdOrInvocation, optionsOrRe
1521
1568
  } else {
1522
1569
  stepAdapter = primaryAdapter;
1523
1570
  }
1524
- return executeStep(i, stepAdapter);
1571
+ const envelopeMeta = options.resolveModelMeta?.(modelClass);
1572
+ return executeStep(i, stepAdapter, envelopeMeta);
1525
1573
  }));
1526
1574
  for (let b = 0; b < ready.length; b++) {
1527
1575
  const i = ready[b];
@@ -2009,6 +2057,8 @@ function buildWorkflowStep(step) {
2009
2057
  max_retries: step.max_retries ?? 0,
2010
2058
  max_follow_ups: step.max_follow_ups,
2011
2059
  depends_on: step.depends_on,
2060
+ instruction: step.instruction,
2061
+ receives: step.receives,
2012
2062
  retry: step.retry
2013
2063
  };
2014
2064
  }
@@ -3086,6 +3136,8 @@ async function executeTask(taskId, options) {
3086
3136
  progressOutput: progressSink,
3087
3137
  observer: options.observer,
3088
3138
  libraryTools: analyzerTools,
3139
+ envelopeAdapter: options.adapter,
3140
+ envelopeModel: options.model,
3089
3141
  ...execCtx.registries
3090
3142
  });
3091
3143
  if (options.hooks?.afterTask) {
@@ -3123,6 +3175,11 @@ async function executeWorkflow(workflowId, options) {
3123
3175
  if (options.hooks?.beforeWorkflow) {
3124
3176
  await options.hooks.beforeWorkflow({ adapter, registries: execCtx.registries, workflowId });
3125
3177
  }
3178
+ const modelResolver = createModelResolver({
3179
+ modelMapping: options.modelMapping,
3180
+ fallbackAdapter: options.adapter,
3181
+ fallbackModel: options.model
3182
+ });
3126
3183
  const invocation = {
3127
3184
  workflow: workflowId,
3128
3185
  user_request: options.request,
@@ -3131,6 +3188,7 @@ async function executeWorkflow(workflowId, options) {
3131
3188
  observer: options.observer,
3132
3189
  toolchain: options.toolchain,
3133
3190
  libraryTools: analyzerTools,
3191
+ resolveModelMeta: (modelClass) => modelResolver.resolve(modelClass),
3134
3192
  runtime: {
3135
3193
  maxFollowUps: options.maxFollowUps ?? 2,
3136
3194
  maxRetries: options.maxRetries ?? 0
@@ -3359,6 +3417,7 @@ async function createProjectRuntime(options) {
3359
3417
  artifactBinding: config.artifactsPath ? { source: config.artifactsPath } : void 0,
3360
3418
  maxFollowUps: config.recovery.max_follow_ups,
3361
3419
  maxRetries: config.recovery.max_retries,
3420
+ modelMapping: config.model_mapping,
3362
3421
  observer,
3363
3422
  // Toolchain.execution observation: only when BOTH in-process observability
3364
3423
  // is wired AND project.yaml declares `toolchains`. Observation is non-
@@ -3796,6 +3855,7 @@ export {
3796
3855
  buildSdkFunctionTools,
3797
3856
  buildSplitTaskPrompt,
3798
3857
  buildTaskPrompt,
3858
+ collectAnalyzerToolIds,
3799
3859
  createAdapter,
3800
3860
  createAnalyzerBridge,
3801
3861
  createComponentScope,
@@ -3855,12 +3915,14 @@ export {
3855
3915
  parseRouterResponse,
3856
3916
  pluginRegistry,
3857
3917
  renderAgentSystemPrompt,
3918
+ renderAnalyzerExplorationMandatePrompt,
3858
3919
  renderContextPackPrompt,
3859
3920
  renderNavigationIndexPrompt,
3860
3921
  resolveArtifacts,
3861
3922
  runTask,
3862
3923
  runToolchainChecks,
3863
3924
  runWorkflow,
3925
+ shouldInjectAnalyzerExplorationMandate,
3864
3926
  version,
3865
3927
  zodSchemaToPromptDescription,
3866
3928
  zodSchemaToYamlExample