@aaac/runtime 0.1.41 → 0.1.42

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,12 +1,12 @@
1
1
  import {
2
2
  buildNavigationContext,
3
3
  renderNavigationIndexPrompt
4
- } from "../../chunk-WFIXO3GQ.js";
4
+ } from "../../chunk-IGSKPSU3.js";
5
5
  import {
6
6
  createGuardrailHooksFromRules,
7
7
  matchGlob
8
8
  } from "../../chunk-EH5VFZYJ.js";
9
- import "../../chunk-GNMSH3VC.js";
9
+ import "../../chunk-KXGUWBGK.js";
10
10
  import "../../chunk-ET6TGQRT.js";
11
11
 
12
12
  // src/lib/claude-native/hook-protocol.ts
@@ -108,8 +108,8 @@ declare function buildObservabilityEnv(ids: ObservabilityIds, baseEnv?: NodeJS.P
108
108
  type ObserverEmitFn = (event: EmitInput) => void;
109
109
  /**
110
110
  * Serialize writes through a shared in-process observer.
111
- * feature-implement runs run-tests and evaluate-implementation in parallel; without
112
- * this, concurrent emit() calls can hit SQLITE_BUSY on the shared SqliteSink.
111
+ * Concurrent workflow steps that emit in parallel can hit SQLITE_BUSY on the
112
+ * shared SqliteSink without this guard.
113
113
  */
114
114
  declare function serializeObserverEmit(emit: ObserverEmitFn): ObserverEmitFn;
115
115
  interface EnvelopeParams {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aaac/runtime",
3
- "version": "0.1.41",
3
+ "version": "0.1.42",
4
4
  "description": "Runtime SDK for the AaaC toolchain",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/lib/observability-bridge.ts"],"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 * feature-implement runs run-tests and evaluate-implementation in parallel; without\n * this, concurrent emit() calls can hit SQLITE_BUSY on the shared SqliteSink.\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"]}