@aaac/runtime 0.1.41 → 0.1.43

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, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef, T as TokenUsage } from '../task-runner-CWb9fVlc.js';
1
+ import { S as SdkAdapter, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef, T as TokenUsage } from '../task-runner-Sez_CXcD.js';
2
2
  import { G as GuardrailHooks } from '../guardrail-hooks-slK-z0Dz.js';
3
3
  import 'zod';
4
4
  import '../context-DKkamYX_.js';
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  buildAdkFunctionTools
3
- } from "../chunk-4MFHJYYK.js";
3
+ } from "../chunk-NSYQZX6R.js";
4
4
  import {
5
5
  getBlockingViolations
6
6
  } from "../chunk-EH5VFZYJ.js";
@@ -9,7 +9,7 @@ import {
9
9
  emitLlmTurnOpen,
10
10
  emitToolExecClose,
11
11
  emitToolExecOpen
12
- } from "../chunk-GNMSH3VC.js";
12
+ } from "../chunk-KXGUWBGK.js";
13
13
 
14
14
  // src/adapters/adk-sdk.ts
15
15
  function sanitizeAgentName(name) {
@@ -1,4 +1,4 @@
1
- import { S as SdkAdapter, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef, T as TokenUsage } from '../task-runner-CWb9fVlc.js';
1
+ import { S as SdkAdapter, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef, T as TokenUsage } from '../task-runner-Sez_CXcD.js';
2
2
  import { G as GuardrailHooks } from '../guardrail-hooks-slK-z0Dz.js';
3
3
  import 'zod';
4
4
  import '../context-DKkamYX_.js';
@@ -2,13 +2,13 @@ import {
2
2
  ContextPackAdoptionTracker,
3
3
  ToolExecSpanRegistry,
4
4
  buildClaudeMcpServer
5
- } from "../chunk-4MFHJYYK.js";
5
+ } from "../chunk-NSYQZX6R.js";
6
6
  import {
7
7
  emitLlmTurnClose,
8
8
  emitLlmTurnOpen,
9
9
  emitToolExecClose,
10
10
  emitToolExecOpen
11
- } from "../chunk-GNMSH3VC.js";
11
+ } from "../chunk-KXGUWBGK.js";
12
12
 
13
13
  // src/adapters/claude-agent-sdk.ts
14
14
  function buildClaudeHooks(guardrails) {
@@ -1,4 +1,4 @@
1
- import { S as SdkAdapter, A as AdapterSendOptions, M as MemoryRef } from '../task-runner-CWb9fVlc.js';
1
+ import { S as SdkAdapter, A as AdapterSendOptions, M as MemoryRef } from '../task-runner-Sez_CXcD.js';
2
2
  import 'zod';
3
3
  import '../context-DKkamYX_.js';
4
4
  import '../guardrail-hooks-slK-z0Dz.js';
@@ -1,4 +1,4 @@
1
- import { S as SdkAdapter, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef, T as TokenUsage } from '../task-runner-CWb9fVlc.js';
1
+ import { S as SdkAdapter, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef, T as TokenUsage } from '../task-runner-Sez_CXcD.js';
2
2
  import { G as GuardrailHooks } from '../guardrail-hooks-slK-z0Dz.js';
3
3
  import 'zod';
4
4
  import '../context-DKkamYX_.js';
@@ -1,12 +1,12 @@
1
1
  import {
2
2
  buildOpenAIFunctionTools
3
- } from "../chunk-4MFHJYYK.js";
3
+ } from "../chunk-NSYQZX6R.js";
4
4
  import {
5
5
  emitLlmTurnClose,
6
6
  emitLlmTurnOpen,
7
7
  emitToolExecClose,
8
8
  emitToolExecOpen
9
- } from "../chunk-GNMSH3VC.js";
9
+ } from "../chunk-KXGUWBGK.js";
10
10
 
11
11
  // src/adapters/openai-agents-sdk.ts
12
12
  function buildInputGuardrails(guardrails) {
@@ -5,7 +5,7 @@ import {
5
5
  createExecutionEnvelope,
6
6
  emitSubagentClose,
7
7
  emitSubagentOpen
8
- } from "./chunk-GNMSH3VC.js";
8
+ } from "./chunk-KXGUWBGK.js";
9
9
  import {
10
10
  jsonSchemaToZod
11
11
  } from "./chunk-ET6TGQRT.js";
@@ -1644,4 +1644,4 @@ export {
1644
1644
  loadDslContext,
1645
1645
  buildNavigationContext
1646
1646
  };
1647
- //# sourceMappingURL=chunk-WFIXO3GQ.js.map
1647
+ //# sourceMappingURL=chunk-IGSKPSU3.js.map
@@ -367,4 +367,4 @@ export {
367
367
  emitToolchainOpen,
368
368
  emitToolchainClose
369
369
  };
370
- //# sourceMappingURL=chunk-GNMSH3VC.js.map
370
+ //# sourceMappingURL=chunk-KXGUWBGK.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/lib/observability-bridge.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, CanonicalLink } 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/**\n * Serialize writes through a shared in-process observer.\n * Concurrent workflow steps that emit in parallel can hit SQLITE_BUSY on the\n * shared SqliteSink without this guard.\n */\nexport function serializeObserverEmit(emit: ObserverEmitFn): ObserverEmitFn {\n let queue: EmitInput[] = [];\n let draining = false;\n\n function drain(): void {\n if (draining) return;\n draining = true;\n try {\n while (queue.length > 0) {\n const next = queue.shift()!;\n emit(next);\n }\n } finally {\n draining = false;\n if (queue.length > 0) {\n drain();\n }\n }\n }\n\n return (event: EmitInput) => {\n queue.push(event);\n drain();\n };\n}\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/** Optional emit-time attributes and links for agent.tool_exec spans (#151). */\nexport interface ToolExecOpenOptions {\n sessionId?: string;\n extraAttributes?: Record<string, AttrValue>;\n links?: CanonicalLink[];\n}\n\nexport interface ToolExecCloseOptions {\n sessionId?: string;\n extraAttributes?: Record<string, AttrValue>;\n outputSummary?: string;\n}\n\nfunction resolveToolExecOpenOptions(\n sessionIdOrOptions?: string | ToolExecOpenOptions,\n): ToolExecOpenOptions {\n if (typeof sessionIdOrOptions === \"string\") {\n return { sessionId: sessionIdOrOptions };\n }\n return sessionIdOrOptions ?? {};\n}\n\nfunction resolveToolExecCloseOptions(\n sessionIdOrOptions?: string | ToolExecCloseOptions,\n): ToolExecCloseOptions {\n if (typeof sessionIdOrOptions === \"string\") {\n return { sessionId: sessionIdOrOptions };\n }\n return sessionIdOrOptions ?? {};\n}\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 sessionIdOrOptions?: string | ToolExecOpenOptions,\n): string | undefined {\n if (!observer) return undefined;\n\n const opts = resolveToolExecOpenOptions(sessionIdOrOptions);\n const spanId = generateId();\n observer({\n source: \"aaac-runtime\",\n eventType: \"agent.tool_exec\",\n lifecycle: \"open\",\n spanId,\n parentSpanId,\n links: opts.links,\n attributes: {\n ...attrs({\n axis: \"agent\",\n \"agent.session_id\": opts.sessionId,\n \"tool.name\": toolName,\n \"tool.input_summary\": inputSummary,\n \"llm.turn_number\": turnNumber,\n }),\n ...(opts.extraAttributes ?? {}),\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 sessionIdOrOptions?: string | ToolExecCloseOptions,\n): void {\n if (!observer) return;\n\n const opts = resolveToolExecCloseOptions(sessionIdOrOptions);\n observer({\n source: \"aaac-runtime\",\n eventType: \"agent.tool_exec\",\n lifecycle: \"close\",\n spanId,\n attributes: {\n ...attrs({\n axis: \"agent\",\n \"agent.session_id\": opts.sessionId,\n \"tool.name\": toolName,\n \"tool.duration_ms\": durationMs,\n \"tool.output_summary\": opts.outputSummary,\n }),\n ...(opts.extraAttributes ?? {}),\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"],"mappings":"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","names":["tokenAttrs"]}
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  emitToolExecClose
3
- } from "./chunk-GNMSH3VC.js";
3
+ } from "./chunk-KXGUWBGK.js";
4
4
 
5
5
  // src/lib/context-pack-adoption.ts
6
6
  import { generateId } from "@aaac/observability";
@@ -351,4 +351,4 @@ export {
351
351
  buildOpenAIFunctionTools,
352
352
  buildAdkFunctionTools
353
353
  };
354
- //# sourceMappingURL=chunk-4MFHJYYK.js.map
354
+ //# sourceMappingURL=chunk-NSYQZX6R.js.map
package/dist/index.d.ts CHANGED
@@ -1,5 +1,5 @@
1
- import { b as SdkFunctionTool, O as ObserverEmitFn, c as TaskContext, d as TaskOutcome, e as AgentContractLike, f as TaskContractLike, P as PromptBuilderOptions, W as WorkflowResult, S as SdkAdapter, g as WorkflowRegistries, H as HandoffInput, h as StepCompleteEvent, i as StepResult, D as DelegateStep, j as MemoryStore, M as MemoryRef, R as ResolvedComponent, k as ArtifactBindingConfig, l as RunToolchainChecksOptions, m as ModelMappingConfig, n as TaskRunResult, L as LibraryToolRegistry, o as ResolvedToolchain, p as LibraryToolDefinition } from './task-runner-CWb9fVlc.js';
2
- export { q as AdapterOrFactory, A as AdapterSendOptions, a as AgentExecutionRequest, r as AgentProgressEvent, B as BoundResolveOptions, s as BoundResolver, C as CacheConfig, t as CandidateAgent, u as ConvergenceEnvelope, v as ConvergenceEnvelopePayload, E as EnvelopeParams, w as EvaluateStep, G as GateStep, I as InMemoryStore, x as InnerSpanOptions, y as ModelAwareSdkAdapterFactory, z as ModelClass, F as ModelResolver, J as ModelResolverOptions, K as OBSERVABILITY_ENV_VARS, N as ObservabilityIds, Q as ReceiveSpec, U as ResolvedModel, V as RetryDecision, X as SdkAdapterFactory, Y as SplitPrompt, Z as TaskRunOptions, T as TokenUsage, _ as ToolchainCheckResult, $ as ToolchainManifest, a0 as ToolchainManifestSchema, a1 as WorkflowContractLike, a2 as WorkflowInvocation, a3 as WorkflowRunOptions, a4 as WorkflowStep, a5 as buildCandidateAgents, a6 as buildGateEvaluationPrompt, a7 as buildObservabilityEnv, a8 as buildPerAgentGuardrails, a9 as buildRetryFollowUp, aa as buildSdkFunctionTools, ab as buildSplitTaskPrompt, ac as buildTaskPrompt, ad as collectAnalyzerToolIds, ae as createExecutionEnvelope, af as createLibraryToolRegistry, ag as createModelResolver, ah as createRegistryFromSdkTools, ai as deriveToolchainsForAgents, aj as emitIterationClose, ak as emitIterationMetric, al as emitIterationOpen, am as emitLlmTurnClose, an as emitLlmTurnOpen, ao as emitSessionClose, ap as emitSessionOpen, aq as emitSubagentClose, ar as emitSubagentOpen, as as emitToolExecClose, at as emitToolExecOpen, au as emitToolchainClose, av as emitToolchainOpen, aw as extractStructuredResult, ax as getEffectiveGuardrailIds, ay as getGuardrailRulesForAgent, az as guardrailContextToRuleData, aA as isNavigationIndex, aB as parseGateEvaluationResponse, aC as renderAgentSystemPrompt, aD as renderAnalyzerExplorationMandatePrompt, aE as renderNavigationIndexPrompt, aF as runTask, aG as runToolchainChecks, aH as runWorkflow, aI as serializeObserverEmit, aJ as shouldInjectAnalyzerExplorationMandate, aK as zodSchemaToPromptDescription, aL as zodSchemaToYamlExample } from './task-runner-CWb9fVlc.js';
1
+ import { b as SdkFunctionTool, O as ObserverEmitFn, c as TaskContext, d as TaskOutcome, e as AgentContractLike, f as TaskContractLike, P as PromptBuilderOptions, W as WorkflowResult, S as SdkAdapter, g as WorkflowRegistries, H as HandoffInput, h as StepCompleteEvent, i as StepResult, D as DelegateStep, j as MemoryStore, M as MemoryRef, R as ResolvedComponent, k as ArtifactBindingConfig, l as RunToolchainChecksOptions, m as ModelMappingConfig, n as TaskRunResult, L as LibraryToolRegistry, o as ResolvedToolchain, p as LibraryToolDefinition } from './task-runner-Sez_CXcD.js';
2
+ export { q as AdapterOrFactory, A as AdapterSendOptions, a as AgentExecutionRequest, r as AgentProgressEvent, B as BoundResolveOptions, s as BoundResolver, C as CacheConfig, t as CandidateAgent, u as ConvergenceEnvelope, v as ConvergenceEnvelopePayload, E as EnvelopeParams, w as EvaluateStep, G as GateStep, I as InMemoryStore, x as InnerSpanOptions, y as ModelAwareSdkAdapterFactory, z as ModelClass, F as ModelResolver, J as ModelResolverOptions, K as OBSERVABILITY_ENV_VARS, N as ObservabilityIds, Q as ReceiveSpec, U as ResolvedModel, V as RetryDecision, X as SdkAdapterFactory, Y as SplitPrompt, Z as TaskRunOptions, T as TokenUsage, _ as ToolchainCheckResult, $ as ToolchainManifest, a0 as ToolchainManifestSchema, a1 as WorkflowContractLike, a2 as WorkflowInvocation, a3 as WorkflowRunOptions, a4 as WorkflowStep, a5 as buildCandidateAgents, a6 as buildGateEvaluationPrompt, a7 as buildObservabilityEnv, a8 as buildPerAgentGuardrails, a9 as buildRetryFollowUp, aa as buildSdkFunctionTools, ab as buildSplitTaskPrompt, ac as buildTaskPrompt, ad as collectAnalyzerToolIds, ae as createExecutionEnvelope, af as createLibraryToolRegistry, ag as createModelResolver, ah as createRegistryFromSdkTools, ai as deriveToolchainsForAgents, aj as emitIterationClose, ak as emitIterationMetric, al as emitIterationOpen, am as emitLlmTurnClose, an as emitLlmTurnOpen, ao as emitSessionClose, ap as emitSessionOpen, aq as emitSubagentClose, ar as emitSubagentOpen, as as emitToolExecClose, at as emitToolExecOpen, au as emitToolchainClose, av as emitToolchainOpen, aw as extractStructuredResult, ax as getEffectiveGuardrailIds, ay as getGuardrailRulesForAgent, az as guardrailContextToRuleData, aA as isNavigationIndex, aB as parseGateEvaluationResponse, aC as renderAgentSystemPrompt, aD as renderAnalyzerExplorationMandatePrompt, aE as renderNavigationIndexPrompt, aF as runTask, aG as runToolchainChecks, aH as runWorkflow, aI as serializeObserverEmit, aJ as shouldInjectAnalyzerExplorationMandate, aK as zodSchemaToPromptDescription, aL as zodSchemaToYamlExample } from './task-runner-Sez_CXcD.js';
3
3
  import { a as GuardrailRuleData, G as GuardrailHooks, H as HookResponse, b as GuardrailCheckResult } from './guardrail-hooks-slK-z0Dz.js';
4
4
  export { c as GuardrailCheckFunctions, d as GuardrailRule, e as HookContext, f as createGuardrailHooks, g as createGuardrailHooksForAgent, h as createGuardrailHooksFromRules, i as getBlockingViolations, j as getWarnings, k as hasBlockingViolation } from './guardrail-hooks-slK-z0Dz.js';
5
5
  import { z } from 'zod';
@@ -104,6 +104,25 @@ declare function isContextPack(value: unknown): value is ContextPack;
104
104
  */
105
105
  declare function renderContextPackPrompt(pack: ContextPack): string;
106
106
 
107
+ /**
108
+ * Virtual workflow entry step — materializes WorkflowInvocation input as a
109
+ * DAG-addressable output so downstream steps can use depends_on / receives.
110
+ */
111
+ /** Step id referenced in workflow DSL depends_on / receives.from. */
112
+ declare const WORKFLOW_INPUT_STEP_ID = "workflow-input";
113
+ interface WorkflowInputHandoff {
114
+ readonly type: string;
115
+ readonly version?: number;
116
+ readonly payload: unknown;
117
+ }
118
+ interface WorkflowInputOutput {
119
+ readonly user_request: string;
120
+ readonly handoff?: WorkflowInputHandoff;
121
+ }
122
+ declare function buildWorkflowInputOutput(userRequest: string, handoff?: WorkflowInputHandoff): WorkflowInputOutput;
123
+ declare function stepDependsOnWorkflowInput(dependsOn: readonly string[] | undefined): boolean;
124
+ declare function formatWorkflowInputContext(output: WorkflowInputOutput): string;
125
+
107
126
  /**
108
127
  * Process axis emit helpers for runtime integration.
109
128
  * These wrap @aaac/observability's EventCollector for structured process axis events.
@@ -534,8 +553,13 @@ interface ExecuteOptions {
534
553
  * Only consumed by executeWorkflow (toolchain checks are a run-level concern).
535
554
  */
536
555
  toolchain?: RunToolchainChecksOptions;
537
- /** Per-class adapter/model mapping from project.yaml (used by executeWorkflow). */
556
+ /** Per-class adapter/model mapping from project.yaml (used by executeWorkflow / executeTask). */
538
557
  modelMapping?: ModelMappingConfig;
558
+ /**
559
+ * When true, `adapter` is used for all model classes; only the model name
560
+ * varies per class (CLI `--adapter mock` override).
561
+ */
562
+ pinAdapter?: boolean;
539
563
  }
540
564
  interface TaskHookContext {
541
565
  adapter: SdkAdapter;
@@ -922,4 +946,4 @@ declare function executePrompt(message: string, ir: ComponentIR, binding: Runtim
922
946
  /** Package version string. */
923
947
  declare const version: string;
924
948
 
925
- 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 CheckResult as ClaudeCheckResult, type ClaudeConfig, type FileAction as ClaudeFileAction, type SyncOptions as ClaudeSyncOptions, type SyncResult as ClaudeSyncResult, 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, 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, buildRegistriesFromDsl, checkClaude, createAdapter, createAnalyzerBridge, createComponentScope, createProgressSink, createProjectRuntime, createRuntime, createRuntimeBinding, emitProcessEdit, emitProcessTaskClose, emitProcessTaskOpen, emitProcessWorkflowClose, emitProcessWorkflowOpen, evaluateGuardrail, executePrompt, executeTask, executeWorkflow, findProjectConfig, guardStatus, isContextPack, isFileEditTool, jsonSchemaToZod, listGuardrails, loadDslContext, loadPlugins, loadPluginsFromDirectory, loadPluginsFromPaths, operationsToTools, parseClaudeConfig, parseRouterResponse, pluginRegistry, renderContextPackPrompt, resolveArtifacts, syncClaude, version };
949
+ 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 CheckResult as ClaudeCheckResult, type ClaudeConfig, type FileAction as ClaudeFileAction, type SyncOptions as ClaudeSyncOptions, type SyncResult as ClaudeSyncResult, 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, 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, WORKFLOW_INPUT_STEP_ID, WorkflowBuilder, type WorkflowHookContext, type WorkflowInputHandoff, type WorkflowInputOutput, WorkflowRegistries, WorkflowResult, buildGuardrailRulesFromDsl, buildRegistriesFromDsl, buildWorkflowInputOutput, checkClaude, createAdapter, createAnalyzerBridge, createComponentScope, createProgressSink, createProjectRuntime, createRuntime, createRuntimeBinding, emitProcessEdit, emitProcessTaskClose, emitProcessTaskOpen, emitProcessWorkflowClose, emitProcessWorkflowOpen, evaluateGuardrail, executePrompt, executeTask, executeWorkflow, findProjectConfig, formatWorkflowInputContext, guardStatus, isContextPack, isFileEditTool, jsonSchemaToZod, listGuardrails, loadDslContext, loadPlugins, loadPluginsFromDirectory, loadPluginsFromPaths, operationsToTools, parseClaudeConfig, parseRouterResponse, pluginRegistry, renderContextPackPrompt, resolveArtifacts, stepDependsOnWorkflowInput, syncClaude, version };
package/dist/index.js CHANGED
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  buildSdkFunctionTools
3
- } from "./chunk-4MFHJYYK.js";
3
+ } from "./chunk-NSYQZX6R.js";
4
4
  import {
5
5
  buildGuardrailContext,
6
6
  loadProjectConfig
@@ -35,7 +35,7 @@ import {
35
35
  shouldInjectAnalyzerExplorationMandate,
36
36
  zodSchemaToPromptDescription,
37
37
  zodSchemaToYamlExample
38
- } from "./chunk-WFIXO3GQ.js";
38
+ } from "./chunk-IGSKPSU3.js";
39
39
  import {
40
40
  PluginRegistry,
41
41
  createGuardrailHooks,
@@ -64,7 +64,7 @@ import {
64
64
  emitToolchainClose,
65
65
  emitToolchainOpen,
66
66
  serializeObserverEmit
67
- } from "./chunk-GNMSH3VC.js";
67
+ } from "./chunk-KXGUWBGK.js";
68
68
  import {
69
69
  jsonSchemaToZod
70
70
  } from "./chunk-ET6TGQRT.js";
@@ -219,6 +219,30 @@ async function runToolchainChecks(options) {
219
219
  return results;
220
220
  }
221
221
 
222
+ // src/lib/workflow-input.ts
223
+ var WORKFLOW_INPUT_STEP_ID = "workflow-input";
224
+ function buildWorkflowInputOutput(userRequest, handoff) {
225
+ return {
226
+ user_request: userRequest,
227
+ ...handoff ? {
228
+ handoff: {
229
+ type: handoff.type,
230
+ ...handoff.version !== void 0 ? { version: handoff.version } : {},
231
+ payload: handoff.payload
232
+ }
233
+ } : {}
234
+ };
235
+ }
236
+ function stepDependsOnWorkflowInput(dependsOn) {
237
+ return dependsOn?.includes(WORKFLOW_INPUT_STEP_ID) ?? false;
238
+ }
239
+ function formatWorkflowInputContext(output) {
240
+ return `
241
+
242
+ --- Step: ${WORKFLOW_INPUT_STEP_ID} ---
243
+ ${JSON.stringify(output, null, 2)}`;
244
+ }
245
+
222
246
  // src/lib/workflow-runner.ts
223
247
  function isAdapterFactory(v) {
224
248
  return typeof v === "function" && !("send" in v);
@@ -335,6 +359,14 @@ async function runWorkflow(adapterOrFactory, workflowIdOrInvocation, optionsOrRe
335
359
  const projected = {};
336
360
  for (const [alias, spec] of Object.entries(step.receives)) {
337
361
  const fromTaskId = spec.from ?? alias;
362
+ if (fromTaskId === WORKFLOW_INPUT_STEP_ID) {
363
+ if (spec.path) {
364
+ projected[alias] = extractPath2(workflowInputOutput, spec.path);
365
+ } else {
366
+ projected[alias] = workflowInputOutput;
367
+ }
368
+ continue;
369
+ }
338
370
  const depIdx = workflow.steps.findIndex((s, j) => j < stepIndex && stepId(j) === fromTaskId);
339
371
  if (depIdx === -1) continue;
340
372
  const output = stepOutputs[depIdx];
@@ -347,19 +379,39 @@ async function runWorkflow(adapterOrFactory, workflowIdOrInvocation, optionsOrRe
347
379
  }
348
380
  return Object.keys(projected).length > 0 ? projected : void 0;
349
381
  }, contextFor2 = function(stepIndex) {
382
+ const step = workflow.steps[stepIndex];
383
+ const parts = [];
384
+ if (stepDependsOnWorkflowInput(step.depends_on)) {
385
+ parts.push(formatWorkflowInputContext(workflowInputOutput));
386
+ }
350
387
  const deps = depsByIndex[stepIndex];
351
- if (deps.length === 0) return "";
352
- return deps.filter((d) => completed.has(d)).map((d) => stepContexts[d]).filter(Boolean).join("");
388
+ if (deps.length > 0) {
389
+ parts.push(
390
+ ...deps.filter((d) => completed.has(d)).map((d) => stepContexts[d]).filter(Boolean)
391
+ );
392
+ }
393
+ return parts.join("");
394
+ }, stepModelFields2 = function(modelClass, envelopeMeta) {
395
+ if (!modelClass && !envelopeMeta) return {};
396
+ return {
397
+ ...modelClass ? { model_class: modelClass } : {},
398
+ ...envelopeMeta?.adapter ? { adapter: envelopeMeta.adapter } : {},
399
+ ...envelopeMeta?.model ? { model: envelopeMeta.model } : {}
400
+ };
353
401
  };
354
- var extractPath = extractPath2, projectHandoffs = projectHandoffs2, contextFor = contextFor2;
402
+ var extractPath = extractPath2, projectHandoffs = projectHandoffs2, contextFor = contextFor2, stepModelFields = stepModelFields2;
355
403
  const stepId = (i) => {
356
404
  const s = workflow.steps[i];
357
405
  if (s.type === "delegate" || s.type === "evaluate") return s.task;
358
406
  return `gate:${s.gate_kind}`;
359
407
  };
408
+ const workflowInputOutput = buildWorkflowInputOutput(
409
+ options.user_request,
410
+ invocationHandoff
411
+ );
360
412
  const depsByIndex = workflow.steps.map((step, i) => {
361
413
  if (step.depends_on !== void 0) {
362
- return step.depends_on.map((dep) => {
414
+ return step.depends_on.filter((dep) => dep !== WORKFLOW_INPUT_STEP_ID).map((dep) => {
363
415
  const idx = workflow.steps.findIndex((s, j) => j < i && stepId(j) === dep);
364
416
  if (idx === -1) {
365
417
  throw new Error(`depends_on "${dep}" in step ${i} (${stepId(i)}) not found among preceding steps`);
@@ -377,7 +429,7 @@ async function runWorkflow(adapterOrFactory, workflowIdOrInvocation, optionsOrRe
377
429
  const evaluateExecCount = /* @__PURE__ */ new Map();
378
430
  const iterationSpanIds = /* @__PURE__ */ new Map();
379
431
  const loopInjectedVars = {};
380
- async function executeStep(i, stepAdapter, envelopeMeta) {
432
+ async function executeStep(i, stepAdapter, envelopeMeta, modelClass) {
381
433
  const step = workflow.steps[i];
382
434
  const stepStart = Date.now();
383
435
  if (step.type === "gate") {
@@ -425,7 +477,8 @@ async function runWorkflow(adapterOrFactory, workflowIdOrInvocation, optionsOrRe
425
477
  follow_ups_used: taskResult2.follow_ups_used,
426
478
  retries_used: taskResult2.retries_used,
427
479
  elapsed_ms: Date.now() - stepStart,
428
- tokenUsage: taskResult2.tokenUsage
480
+ tokenUsage: taskResult2.tokenUsage,
481
+ ...stepModelFields2(modelClass, envelopeMeta)
429
482
  };
430
483
  }
431
484
  const delegateStep = step;
@@ -445,7 +498,8 @@ async function runWorkflow(adapterOrFactory, workflowIdOrInvocation, optionsOrRe
445
498
  outcome: { status: "skipped" },
446
499
  follow_ups_used: 0,
447
500
  retries_used: 0,
448
- elapsed_ms: Date.now() - stepStart
501
+ elapsed_ms: Date.now() - stepStart,
502
+ ...stepModelFields2(modelClass, envelopeMeta)
449
503
  };
450
504
  }
451
505
  }
@@ -490,7 +544,8 @@ async function runWorkflow(adapterOrFactory, workflowIdOrInvocation, optionsOrRe
490
544
  follow_ups_used: taskResult.follow_ups_used,
491
545
  retries_used: taskResult.retries_used,
492
546
  elapsed_ms: Date.now() - stepStart,
493
- tokenUsage: taskResult.tokenUsage
547
+ tokenUsage: taskResult.tokenUsage,
548
+ ...stepModelFields2(modelClass, envelopeMeta)
494
549
  };
495
550
  }
496
551
  while (completed.size < workflow.steps.length) {
@@ -525,7 +580,7 @@ async function runWorkflow(adapterOrFactory, workflowIdOrInvocation, optionsOrRe
525
580
  stepAdapter = primaryAdapter;
526
581
  }
527
582
  const envelopeMeta = options.resolveModelMeta?.(modelClass);
528
- return executeStep(i, stepAdapter, envelopeMeta);
583
+ return executeStep(i, stepAdapter, envelopeMeta, modelClass);
529
584
  }));
530
585
  for (let b = 0; b < ready.length; b++) {
531
586
  const i = ready[b];
@@ -1272,21 +1327,26 @@ function createModelResolver(options) {
1272
1327
  return {
1273
1328
  resolve(modelClass) {
1274
1329
  const fallback = {
1275
- adapter: options.fallbackAdapter,
1330
+ adapter: options.pinnedAdapter ?? options.fallbackAdapter,
1276
1331
  model: options.fallbackModel
1277
1332
  };
1278
1333
  if (!modelClass) return fallback;
1279
1334
  const classEnv = env[CLASS_ENV_KEYS[modelClass]];
1280
1335
  if (classEnv) {
1281
- return parseEnvValue(classEnv, options.fallbackAdapter);
1336
+ const parsed = parseEnvValue(classEnv, options.fallbackAdapter);
1337
+ return options.pinnedAdapter ? { adapter: options.pinnedAdapter, model: parsed.model } : parsed;
1282
1338
  }
1283
1339
  const catchAllEnv = env[ENV_PREFIX];
1284
1340
  if (catchAllEnv) {
1285
- return parseEnvValue(catchAllEnv, options.fallbackAdapter);
1341
+ const parsed = parseEnvValue(catchAllEnv, options.fallbackAdapter);
1342
+ return options.pinnedAdapter ? { adapter: options.pinnedAdapter, model: parsed.model } : parsed;
1286
1343
  }
1287
1344
  const entry = options.modelMapping?.[modelClass];
1288
1345
  if (entry) {
1289
- return { adapter: entry.adapter, model: entry.model };
1346
+ return {
1347
+ adapter: options.pinnedAdapter ?? entry.adapter,
1348
+ model: entry.model
1349
+ };
1290
1350
  }
1291
1351
  return fallback;
1292
1352
  }
@@ -1642,6 +1702,62 @@ Install it with: npm install ${pkg2}`
1642
1702
 
1643
1703
  // src/lib/execute.ts
1644
1704
  import { resolve as resolve3 } from "path";
1705
+
1706
+ // src/lib/model-aware-adapter.ts
1707
+ function cacheKey(resolved) {
1708
+ return `${resolved.adapter}:${resolved.model ?? ""}`;
1709
+ }
1710
+ async function createModelAwareAdapterSetup(options) {
1711
+ const modelResolver = createModelResolver({
1712
+ modelMapping: options.modelMapping,
1713
+ fallbackAdapter: options.fallbackAdapter,
1714
+ fallbackModel: options.fallbackModel,
1715
+ pinnedAdapter: options.pinAdapter ? options.fallbackAdapter : void 0
1716
+ });
1717
+ const cache = /* @__PURE__ */ new Map();
1718
+ const inflight = /* @__PURE__ */ new Map();
1719
+ async function ensureAdapter(modelClass) {
1720
+ const resolved = modelResolver.resolve(modelClass);
1721
+ const key = cacheKey(resolved);
1722
+ const hit = cache.get(key);
1723
+ if (hit) return hit;
1724
+ let pending = inflight.get(key);
1725
+ if (!pending) {
1726
+ pending = createAdapter(resolved.adapter, {
1727
+ model: resolved.model,
1728
+ ...options.adapterOptions
1729
+ });
1730
+ inflight.set(key, pending);
1731
+ }
1732
+ try {
1733
+ const adapter = await pending;
1734
+ cache.set(key, adapter);
1735
+ return adapter;
1736
+ } finally {
1737
+ inflight.delete(key);
1738
+ }
1739
+ }
1740
+ const defaultAdapter = await ensureAdapter("standard");
1741
+ const factory = (modelClass) => {
1742
+ const effectiveClass = modelClass ?? "standard";
1743
+ const resolved = modelResolver.resolve(effectiveClass);
1744
+ const key = cacheKey(resolved);
1745
+ const hit = cache.get(key);
1746
+ if (hit) return hit;
1747
+ if (effectiveClass === "standard") {
1748
+ return defaultAdapter;
1749
+ }
1750
+ return ensureAdapter(effectiveClass);
1751
+ };
1752
+ return {
1753
+ factory,
1754
+ defaultAdapter,
1755
+ modelResolver,
1756
+ resolveAdapter: ensureAdapter
1757
+ };
1758
+ }
1759
+
1760
+ // src/lib/execute.ts
1645
1761
  async function resolveExecutionContext(options, requiredEntities) {
1646
1762
  const useBoundResolver = options.resolvedComponent || options.bindingPaths && options.bindingPaths.length > 0 || options.artifactBinding;
1647
1763
  if (useBoundResolver) {
@@ -1730,13 +1846,20 @@ async function buildNavigationContextSafely(execCtx) {
1730
1846
  }
1731
1847
  async function executeTask(taskId, options) {
1732
1848
  const execCtx = await resolveExecutionContext(options, { tasks: [taskId] });
1733
- const targetAgentId = execCtx.registries.taskRegistry?.[taskId]?.target_agent;
1849
+ const taskDef = execCtx.registries.taskRegistry?.[taskId];
1850
+ const targetAgentId = taskDef?.target_agent;
1851
+ const modelClass = taskDef?.model_class;
1734
1852
  const adapterOptions = { ...options.adapterOptions };
1735
1853
  injectGuardrailHooks(adapterOptions, execCtx, targetAgentId);
1736
- const adapter = await createAdapter(options.adapter, {
1737
- model: options.model,
1738
- ...adapterOptions
1854
+ const { resolveAdapter: resolveTaskAdapter, modelResolver } = await createModelAwareAdapterSetup({
1855
+ fallbackAdapter: options.adapter,
1856
+ fallbackModel: options.model,
1857
+ modelMapping: options.modelMapping,
1858
+ adapterOptions,
1859
+ pinAdapter: options.pinAdapter
1739
1860
  });
1861
+ const resolved = modelResolver.resolve(modelClass);
1862
+ const adapter = await resolveTaskAdapter(modelClass);
1740
1863
  const progressSink = createProgressSink(
1741
1864
  options.logFile ? { stderr: true, file: resolve3(options.logFile), naming: "single" } : { stderr: true }
1742
1865
  );
@@ -1759,8 +1882,8 @@ async function executeTask(taskId, options) {
1759
1882
  progressOutput: progressSink,
1760
1883
  observer: options.observer,
1761
1884
  libraryTools: analyzerTools,
1762
- envelopeAdapter: options.adapter,
1763
- envelopeModel: options.model,
1885
+ envelopeAdapter: resolved.adapter,
1886
+ envelopeModel: resolved.model,
1764
1887
  ...execCtx.registries
1765
1888
  });
1766
1889
  if (options.hooks?.afterTask) {
@@ -1775,9 +1898,12 @@ async function executeWorkflow(workflowId, options) {
1775
1898
  const execCtx = await resolveExecutionContext(options, { workflows: [workflowId] });
1776
1899
  const adapterOptions = { ...options.adapterOptions };
1777
1900
  injectGuardrailHooks(adapterOptions, execCtx);
1778
- const adapter = await createAdapter(options.adapter, {
1779
- model: options.model,
1780
- ...adapterOptions
1901
+ const { factory: adapterOrFactory, defaultAdapter: adapter, modelResolver } = await createModelAwareAdapterSetup({
1902
+ fallbackAdapter: options.adapter,
1903
+ fallbackModel: options.model,
1904
+ modelMapping: options.modelMapping,
1905
+ adapterOptions,
1906
+ pinAdapter: options.pinAdapter
1781
1907
  });
1782
1908
  const progressSink = createProgressSink(
1783
1909
  options.logFile ? { stderr: true, file: resolve3(options.logFile), naming: "single" } : { stderr: true }
@@ -1798,11 +1924,6 @@ async function executeWorkflow(workflowId, options) {
1798
1924
  if (options.hooks?.beforeWorkflow) {
1799
1925
  await options.hooks.beforeWorkflow({ adapter, registries: execCtx.registries, workflowId });
1800
1926
  }
1801
- const modelResolver = createModelResolver({
1802
- modelMapping: options.modelMapping,
1803
- fallbackAdapter: options.adapter,
1804
- fallbackModel: options.model
1805
- });
1806
1927
  const invocation = {
1807
1928
  workflow: workflowId,
1808
1929
  user_request: options.request,
@@ -1823,7 +1944,7 @@ async function executeWorkflow(workflowId, options) {
1823
1944
  },
1824
1945
  context: workflowContext
1825
1946
  };
1826
- const result = await runWorkflow(adapter, invocation, execCtx.registries);
1947
+ const result = await runWorkflow(adapterOrFactory, invocation, execCtx.registries);
1827
1948
  if (options.hooks?.afterWorkflow) {
1828
1949
  await options.hooks.afterWorkflow(result);
1829
1950
  }
@@ -2036,9 +2157,11 @@ async function createProjectRuntime(options) {
2036
2157
  }
2037
2158
  function sharedExecuteOptions() {
2038
2159
  const { adapter, model } = resolveAdapter2();
2160
+ const explicitAdapter = options.adapter ?? env.AGENT_RUNTIME_ADAPTER;
2039
2161
  return {
2040
2162
  adapter,
2041
2163
  model,
2164
+ pinAdapter: Boolean(explicitAdapter),
2042
2165
  dsl: options.embeddedDsl,
2043
2166
  projectDslPath,
2044
2167
  bindingPaths: config.bindingPaths,
@@ -2624,6 +2747,7 @@ export {
2624
2747
  PROJECT_CONFIG_FILENAME,
2625
2748
  PluginRegistry,
2626
2749
  ToolchainManifestSchema,
2750
+ WORKFLOW_INPUT_STEP_ID,
2627
2751
  WorkflowBuilder,
2628
2752
  buildCandidateAgents,
2629
2753
  buildGateEvaluationPrompt,
@@ -2636,6 +2760,7 @@ export {
2636
2760
  buildSdkFunctionTools,
2637
2761
  buildSplitTaskPrompt,
2638
2762
  buildTaskPrompt,
2763
+ buildWorkflowInputOutput,
2639
2764
  checkClaude,
2640
2765
  collectAnalyzerToolIds,
2641
2766
  createAdapter,
@@ -2677,6 +2802,7 @@ export {
2677
2802
  executeWorkflow,
2678
2803
  extractStructuredResult,
2679
2804
  findProjectConfig,
2805
+ formatWorkflowInputContext,
2680
2806
  getBlockingViolations,
2681
2807
  getEffectiveGuardrailIds,
2682
2808
  getGuardrailRulesForAgent,
@@ -2708,6 +2834,7 @@ export {
2708
2834
  runWorkflow,
2709
2835
  serializeObserverEmit,
2710
2836
  shouldInjectAnalyzerExplorationMandate,
2837
+ stepDependsOnWorkflowInput,
2711
2838
  syncClaude,
2712
2839
  version,
2713
2840
  zodSchemaToPromptDescription,