@aaac/runtime 0.1.25 → 0.1.26
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/adapters/adk-sdk.d.ts +1 -1
- package/dist/adapters/adk-sdk.js +1 -1
- package/dist/adapters/claude-agent-sdk.d.ts +1 -1
- package/dist/adapters/claude-agent-sdk.js +1 -1
- package/dist/adapters/mock.d.ts +1 -1
- package/dist/adapters/openai-agents-sdk.d.ts +1 -1
- package/dist/adapters/openai-agents-sdk.js +1 -1
- package/dist/{chunk-3EWHYMKL.js → chunk-LWMRO7RR.js} +15 -1
- package/dist/chunk-LWMRO7RR.js.map +1 -0
- package/dist/index.d.ts +2 -2
- package/dist/index.js +19 -6
- package/dist/index.js.map +1 -1
- package/dist/{task-runner-Bl3SZfft.d.ts → task-runner-CVh7Luc_.d.ts} +38 -1
- package/package.json +1 -1
- package/dist/chunk-3EWHYMKL.js.map +0 -1
|
@@ -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-
|
|
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-CVh7Luc_.js';
|
|
2
2
|
import 'zod';
|
|
3
3
|
import '../context-DKkamYX_.js';
|
|
4
4
|
import '@aaac/observability';
|
package/dist/adapters/adk-sdk.js
CHANGED
|
@@ -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-
|
|
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-CVh7Luc_.js';
|
|
2
2
|
import 'zod';
|
|
3
3
|
import '../context-DKkamYX_.js';
|
|
4
4
|
import '@aaac/observability';
|
package/dist/adapters/mock.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { S as SdkAdapter, A as AdapterSendOptions, M as MemoryRef } from '../task-runner-
|
|
1
|
+
import { S as SdkAdapter, A as AdapterSendOptions, M as MemoryRef } from '../task-runner-CVh7Luc_.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-
|
|
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-CVh7Luc_.js';
|
|
2
2
|
import 'zod';
|
|
3
3
|
import '../context-DKkamYX_.js';
|
|
4
4
|
import '@aaac/observability';
|
|
@@ -1,5 +1,17 @@
|
|
|
1
1
|
// src/lib/observability-bridge.ts
|
|
2
2
|
import { generateId } from "@aaac/observability";
|
|
3
|
+
var OBSERVABILITY_ENV_VARS = {
|
|
4
|
+
sessionId: "AAAC_SESSION_ID",
|
|
5
|
+
traceId: "AAAC_TRACE_ID",
|
|
6
|
+
runId: "AAAC_RUN_ID"
|
|
7
|
+
};
|
|
8
|
+
function buildObservabilityEnv(ids, baseEnv = process.env) {
|
|
9
|
+
const env = { ...baseEnv };
|
|
10
|
+
if (ids.sessionId) env[OBSERVABILITY_ENV_VARS.sessionId] = ids.sessionId;
|
|
11
|
+
if (ids.traceId) env[OBSERVABILITY_ENV_VARS.traceId] = ids.traceId;
|
|
12
|
+
if (ids.runId) env[OBSERVABILITY_ENV_VARS.runId] = ids.runId;
|
|
13
|
+
return env;
|
|
14
|
+
}
|
|
3
15
|
function createExecutionEnvelope(params = {}) {
|
|
4
16
|
const envelope = {
|
|
5
17
|
run_id: generateId(),
|
|
@@ -370,6 +382,8 @@ async function buildAdkFunctionTools(registry) {
|
|
|
370
382
|
}
|
|
371
383
|
|
|
372
384
|
export {
|
|
385
|
+
OBSERVABILITY_ENV_VARS,
|
|
386
|
+
buildObservabilityEnv,
|
|
373
387
|
createExecutionEnvelope,
|
|
374
388
|
emitSessionOpen,
|
|
375
389
|
emitSessionClose,
|
|
@@ -389,4 +403,4 @@ export {
|
|
|
389
403
|
buildOpenAIFunctionTools,
|
|
390
404
|
buildAdkFunctionTools
|
|
391
405
|
};
|
|
392
|
-
//# sourceMappingURL=chunk-
|
|
406
|
+
//# sourceMappingURL=chunk-LWMRO7RR.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/lib/observability-bridge.ts","../src/lib/library-tool-sdk.ts"],"sourcesContent":["/**\n * observability-bridge.ts\n *\n * Bridge between @aaac/runtime execution and @aaac/observability agent-axis spans.\n *\n * Responsibilities:\n * - Generate ExecutionEnvelope (run_id = UUIDv7) for every task/workflow execution\n * - Emit agent.session (open/close) for runWorkflow() — root run span\n * - Emit agent.subagent (open/close) for runTask() — handoff/task span\n * - Emit toolchain.execution (open/close) for toolchain tool invocations\n * - Observer is OPTIONAL — all emit* functions are no-ops when observer is undefined\n *\n * No circular dependency: @aaac/observability does NOT import @aaac/runtime.\n * Types (ExecutionEnvelope, EmitInput) are consumed from @aaac/observability.\n *\n * event-catalog.md §1.5, §2.2 / OBSERVABILITY_TASKS.md Phase 1 / architecture.md §6, §7\n */\n\nimport { generateId } from \"@aaac/observability\";\nimport type { ExecutionEnvelope, EmitInput, AttrValue } from \"@aaac/observability\";\n\n// ── Re-exports ────────────────────────────────────────────────────────────────\n\nexport type { ExecutionEnvelope } from \"@aaac/observability\";\n\n// ── TokenUsage ────────────────────────────────────────────────────────────────\n\n/** Token usage metrics returned by LLM adapters after a query/session. */\nexport interface TokenUsage {\n inputTokens: number;\n outputTokens: number;\n totalTokens?: number;\n cacheReadTokens?: number;\n cacheCreationTokens?: number;\n}\n\n// ── 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/** Extract numeric token_usage fields into flat attributes. */\nfunction tokenAttrs(meta: Record<string, unknown>): Record<string, AttrValue> {\n const out: Record<string, AttrValue> = {};\n const tu = meta.token_usage;\n if (tu && typeof tu === \"object\") {\n const t = tu as Record<string, unknown>;\n if (typeof t.input_tokens === \"number\") out[\"token_usage.input\"] = t.input_tokens;\n if (typeof t.output_tokens === \"number\") out[\"token_usage.output\"] = t.output_tokens;\n if (typeof t.total_tokens === \"number\") out[\"token_usage.total\"] = t.total_tokens;\n if (typeof t.cache_read_input_tokens === \"number\") out[\"token_usage.cache_read\"] = t.cache_read_input_tokens;\n if (typeof t.cache_creation_input_tokens === \"number\") out[\"token_usage.cache_creation\"] = t.cache_creation_input_tokens;\n }\n if (typeof meta.cost_usd === \"number\") out[\"cost_usd\"] = meta.cost_usd;\n return out;\n}\n\n// ── agent.session ─────────────────────────────────────────────────────────────\n\n/**\n * Emit an agent.session open span (root workflow/session execution).\n *\n * Uses envelope.run_id as the spanId so that child agent.subagent spans can\n * reference it as parentSpanId for hierarchical correlation.\n *\n * Returns the spanId emitted (= envelope.run_id).\n * Returns undefined when observer is undefined (no-op).\n *\n * event-catalog.md §2.2 — required: agent.session_id; axis: agent\n */\nexport function emitSessionOpen(\n observer: ObserverEmitFn | undefined,\n envelope: ExecutionEnvelope,\n workflowId: string,\n): string | undefined {\n if (!observer) return undefined;\n\n const spanId = envelope.run_id;\n observer({\n source: \"aaac-runtime\",\n eventType: \"agent.session\",\n lifecycle: \"open\",\n spanId,\n parentSpanId: envelope.parent_run_id,\n attributes: attrs({\n axis: \"agent\",\n \"agent.session_id\": envelope.run_id,\n \"agent.run_id\": envelope.run_id,\n \"workflow.id\": workflowId,\n \"agent.component_id\": envelope.component_id,\n \"agent.model\": envelope.model,\n adapter: envelope.adapter,\n contract_version: envelope.contract_version,\n }),\n });\n return spanId;\n}\n\n/**\n * Emit an agent.session close span.\n *\n * `errorMessage` is set on the exception path (workflow body threw) so the\n * failure cause is recorded alongside the run status. Omitted on the normal path.\n *\n * event-catalog.md §2.2 — optional: agent.session.duration_ms, agent.status, agent.error\n */\nexport function emitSessionClose(\n observer: ObserverEmitFn | undefined,\n spanId: string,\n envelope: ExecutionEnvelope,\n durationMs: number,\n status: string,\n errorMessage?: string,\n): void {\n if (!observer) return;\n\n const metaAttrs: Record<string, AttrValue> =\n envelope.execution_metadata ? tokenAttrs(envelope.execution_metadata) : {};\n\n observer({\n source: \"aaac-runtime\",\n eventType: \"agent.session\",\n lifecycle: \"close\",\n spanId,\n attributes: {\n ...attrs({\n axis: \"agent\",\n \"agent.session_id\": envelope.run_id,\n \"agent.session.duration_ms\": durationMs,\n \"agent.status\": status,\n \"agent.error\": errorMessage,\n }),\n ...metaAttrs,\n },\n });\n}\n\n// ── agent.subagent ────────────────────────────────────────────────────────────\n\n/**\n * Emit an agent.subagent open span (task/handoff execution).\n *\n * Uses envelope.run_id as the spanId and parentSpanId for hierarchical correlation\n * (typically the session span's run_id).\n *\n * Returns the spanId emitted (= envelope.run_id).\n * Returns undefined when observer is undefined (no-op).\n *\n * event-catalog.md §2.2 — required: agent.role; axis: agent\n */\nexport function emitSubagentOpen(\n observer: ObserverEmitFn | undefined,\n envelope: ExecutionEnvelope,\n parentSpanId: string | undefined,\n taskId: string,\n agentRole: string,\n): string | undefined {\n if (!observer) return undefined;\n\n const spanId = envelope.run_id;\n observer({\n source: \"aaac-runtime\",\n eventType: \"agent.subagent\",\n lifecycle: \"open\",\n spanId,\n parentSpanId,\n attributes: attrs({\n axis: \"agent\",\n \"agent.role\": agentRole,\n \"agent.kind\": \"task\",\n \"task.id\": taskId,\n \"agent.run_id\": envelope.run_id,\n \"agent.parent_run_id\": envelope.parent_run_id,\n \"agent.model\": envelope.model,\n adapter: envelope.adapter,\n \"agent.component_id\": envelope.component_id,\n \"agent.from_agent\": envelope.from_agent,\n \"agent.to_agent\": envelope.to_agent,\n }),\n });\n return spanId;\n}\n\n/**\n * Emit an agent.subagent close span.\n *\n * `errorMessage` records the failure cause on `agent.error` (parity with\n * emitSessionClose); it is omitted from the attributes when undefined.\n *\n * event-catalog.md §2.2 — optional: agent.duration_ms, agent.status, agent.error,\n * token_usage, cost_usd\n */\nexport function emitSubagentClose(\n observer: ObserverEmitFn | undefined,\n spanId: string,\n envelope: ExecutionEnvelope,\n durationMs: number,\n status: string,\n agentRole: string,\n errorMessage?: string,\n): void {\n if (!observer) return;\n\n const metaAttrs: Record<string, AttrValue> =\n envelope.execution_metadata ? tokenAttrs(envelope.execution_metadata) : {};\n\n observer({\n source: \"aaac-runtime\",\n eventType: \"agent.subagent\",\n lifecycle: \"close\",\n spanId,\n attributes: {\n ...attrs({\n axis: \"agent\",\n \"agent.role\": agentRole,\n \"agent.status\": status,\n \"agent.duration_ms\": durationMs,\n \"agent.error\": errorMessage,\n }),\n ...metaAttrs,\n },\n });\n}\n\n// ── evaluate.iteration ────────────────────────────────────────────────────────\n\n/**\n * Emit an evaluate.iteration open span (one closed-loop iteration).\n *\n * Returns the spanId emitted (= generated UUIDv7).\n * Returns undefined when observer is undefined (no-op).\n */\nexport function emitIterationOpen(\n observer: ObserverEmitFn | undefined,\n parentSpanId: string | undefined,\n evaluateTaskId: string,\n loopTo: string,\n iterationNumber: number,\n maxIterations: number,\n): string | undefined {\n if (!observer) return undefined;\n\n const spanId = generateId();\n observer({\n source: \"aaac-runtime\",\n eventType: \"evaluate.iteration\",\n lifecycle: \"open\",\n spanId,\n parentSpanId,\n attributes: attrs({\n axis: \"agent\",\n \"evaluate.task\": evaluateTaskId,\n \"evaluate.loop_to\": loopTo,\n \"evaluate.iteration\": iterationNumber,\n \"evaluate.max_iterations\": maxIterations,\n }),\n });\n return spanId;\n}\n\n/**\n * Emit an evaluate.iteration close span.\n */\nexport function emitIterationClose(\n observer: ObserverEmitFn | undefined,\n spanId: string,\n evaluateTaskId: string,\n iterationNumber: number,\n verdict: string,\n durationMs: number,\n feedbackInjected: boolean,\n): void {\n if (!observer) return;\n\n observer({\n source: \"aaac-runtime\",\n eventType: \"evaluate.iteration\",\n lifecycle: \"close\",\n spanId,\n attributes: attrs({\n axis: \"agent\",\n \"evaluate.task\": evaluateTaskId,\n \"evaluate.iteration\": iterationNumber,\n \"evaluate.verdict\": verdict,\n \"evaluate.duration_ms\": durationMs,\n \"evaluate.feedback_injected\": feedbackInjected,\n }),\n });\n}\n\n/**\n * Emit an evaluate.metric instant event when an evaluate step terminates.\n */\nexport function emitIterationMetric(\n observer: ObserverEmitFn | undefined,\n parentSpanId: string | undefined,\n evaluateTaskId: string,\n totalIterations: number,\n terminalOutcome: string,\n): void {\n if (!observer) return;\n\n const spanId = generateId();\n observer({\n source: \"aaac-runtime\",\n eventType: \"evaluate.metric\",\n lifecycle: \"instant\",\n spanId,\n parentSpanId,\n attributes: attrs({\n axis: \"agent\",\n \"evaluate.task\": evaluateTaskId,\n \"evaluate.total_iterations\": totalIterations,\n \"evaluate.terminal_outcome\": terminalOutcome,\n }),\n });\n}\n\n// ── InnerSpanOptions (for adapter plumbing) ──────────────────────────────────\n\n/** Options forwarded from task-runner to adapters for inner turn-level spans. */\nexport interface InnerSpanOptions {\n observer?: ObserverEmitFn;\n parentSpanId?: string;\n}\n\n// ── agent.llm_turn ───────────────────────────────────────────────────────────\n\n/**\n * Emit an agent.llm_turn open span when a new LLM turn begins.\n *\n * Returns the spanId emitted (= generated UUIDv7).\n * Returns undefined when observer is undefined (no-op).\n */\nexport function emitLlmTurnOpen(\n observer: ObserverEmitFn | undefined,\n parentSpanId: string | undefined,\n turnNumber: number,\n model?: string,\n llmParams?: { temperature?: number; reasoningEffort?: string },\n): string | undefined {\n if (!observer) return undefined;\n\n const spanId = generateId();\n observer({\n source: \"aaac-runtime\",\n eventType: \"agent.llm_turn\",\n lifecycle: \"open\",\n spanId,\n parentSpanId,\n attributes: attrs({\n axis: \"agent\",\n \"llm.turn_number\": turnNumber,\n \"llm.model\": model,\n \"llm.temperature\": llmParams?.temperature,\n \"llm.reasoning_effort\": llmParams?.reasoningEffort,\n }),\n });\n return spanId;\n}\n\n/**\n * Emit an agent.llm_turn close span.\n */\nexport function emitLlmTurnClose(\n observer: ObserverEmitFn | undefined,\n spanId: string,\n turnNumber: number,\n durationMs: number,\n tokenAttrs?: {\n inputTokens?: number;\n outputTokens?: number;\n cacheHitTokens?: number;\n toolCallsCount?: number;\n },\n): void {\n if (!observer) return;\n\n observer({\n source: \"aaac-runtime\",\n eventType: \"agent.llm_turn\",\n lifecycle: \"close\",\n spanId,\n attributes: attrs({\n axis: \"agent\",\n \"llm.turn_number\": turnNumber,\n \"llm.duration_ms\": durationMs,\n \"llm.input_tokens\": tokenAttrs?.inputTokens,\n \"llm.output_tokens\": tokenAttrs?.outputTokens,\n \"llm.cache_hit_tokens\": tokenAttrs?.cacheHitTokens,\n \"llm.tool_calls_count\": tokenAttrs?.toolCallsCount,\n }),\n });\n}\n\n// ── agent.tool_exec ──────────────────────────────────────────────────────────\n\n/**\n * Emit an agent.tool_exec open span when a tool execution begins.\n *\n * Returns the spanId emitted (= generated UUIDv7).\n * Returns undefined when observer is undefined (no-op).\n */\nexport function emitToolExecOpen(\n observer: ObserverEmitFn | undefined,\n parentSpanId: string | undefined,\n toolName: string,\n inputSummary: string,\n turnNumber: number,\n): string | undefined {\n if (!observer) return undefined;\n\n const spanId = generateId();\n observer({\n source: \"aaac-runtime\",\n eventType: \"agent.tool_exec\",\n lifecycle: \"open\",\n spanId,\n parentSpanId,\n attributes: attrs({\n axis: \"agent\",\n \"tool.name\": toolName,\n \"tool.input_summary\": inputSummary,\n \"llm.turn_number\": turnNumber,\n }),\n });\n return spanId;\n}\n\n/**\n * Emit an agent.tool_exec close span.\n */\nexport function emitToolExecClose(\n observer: ObserverEmitFn | undefined,\n spanId: string,\n toolName: string,\n durationMs: number,\n): void {\n if (!observer) return;\n\n observer({\n source: \"aaac-runtime\",\n eventType: \"agent.tool_exec\",\n lifecycle: \"close\",\n spanId,\n attributes: attrs({\n axis: \"agent\",\n \"tool.name\": toolName,\n \"tool.duration_ms\": durationMs,\n }),\n });\n}\n\n// ── toolchain.execution ──────────────────────────────────────────────────────\n\n/**\n * Emit a toolchain.execution open span when a toolchain tool is invoked.\n *\n * Returns the spanId emitted (= generated UUIDv7).\n * Returns undefined when observer is undefined (no-op).\n */\nexport function emitToolchainOpen(\n observer: ObserverEmitFn | undefined,\n parentSpanId: string | undefined,\n toolchainId: string,\n operation: string,\n artifactIds: string[],\n componentId?: string,\n): string | undefined {\n if (!observer) return undefined;\n\n const spanId = generateId();\n observer({\n source: \"aaac-runtime\",\n eventType: \"toolchain.execution\",\n lifecycle: \"open\",\n spanId,\n parentSpanId,\n attributes: attrs({\n axis: \"toolchain\",\n \"toolchain.id\": toolchainId,\n \"toolchain.operation\": operation,\n \"toolchain.artifact_ids\": artifactIds.join(\",\"),\n \"agent.component_id\": componentId,\n }),\n });\n return spanId;\n}\n\n/**\n * Emit a toolchain.execution close span.\n */\nexport function emitToolchainClose(\n observer: ObserverEmitFn | undefined,\n spanId: string,\n toolchainId: string,\n operation: string,\n durationMs: number,\n status: \"success\" | \"failure\",\n errorMessage?: string,\n): void {\n if (!observer) return;\n\n observer({\n source: \"aaac-runtime\",\n eventType: \"toolchain.execution\",\n lifecycle: \"close\",\n spanId,\n attributes: attrs({\n axis: \"toolchain\",\n \"toolchain.id\": toolchainId,\n \"toolchain.operation\": operation,\n \"toolchain.status\": status,\n \"toolchain.duration_ms\": durationMs,\n ...(errorMessage ? { \"toolchain.error\": errorMessage } : {}),\n }),\n });\n}\n","/**\n * Library Tool → SDK Function Tool conversion.\n *\n * Converts LibraryToolDefinition entries into SDK-native function tools\n * that each adapter can register with its respective LLM SDK.\n *\n * Each adapter receives tools in its native format:\n * - Claude Agent SDK: MCP tool via createSdkMcpServer + tool()\n * - OpenAI Agents SDK: function tool object\n * - Google ADK: FunctionDeclaration tool\n */\n\nimport type { LibraryToolRegistry } from \"./library-tool-binding.js\";\n\n/**\n * Adapter-agnostic function tool descriptor. Adapters convert this\n * into their SDK-specific tool format.\n */\nexport interface SdkFunctionTool {\n name: string;\n description: string;\n inputSchema: Record<string, unknown>;\n handler: (args: Record<string, unknown>) => Promise<string>;\n}\n\n/**\n * Build adapter-agnostic function tool descriptors from a LibraryToolRegistry.\n * Each tool's handler calls registry.execute() and serialises the result.\n */\nexport function buildSdkFunctionTools(\n registry: LibraryToolRegistry,\n): SdkFunctionTool[] {\n return registry.getAll().map((def) => ({\n name: def.toolId,\n description: def.description,\n inputSchema: def.inputSchema ?? { type: \"object\", properties: {} },\n handler: async (args: Record<string, unknown>): Promise<string> => {\n const result = await registry.execute(def.toolId, args);\n return typeof result === \"string\" ? result : JSON.stringify(result);\n },\n }));\n}\n\n// ---------------------------------------------------------------------------\n// Claude Agent SDK — MCP server wrapping\n// ---------------------------------------------------------------------------\n\n/**\n * Build Claude MCP server tools from a LibraryToolRegistry.\n *\n * Dynamically imports `tool` and `createSdkMcpServer` from the\n * Claude Agent SDK. Returns an MCP server instance to be passed\n * to query() via options.mcpServers.\n *\n * Returns undefined if no tools or if SDK functions are unavailable.\n */\nexport async function buildClaudeMcpServer(\n registry: LibraryToolRegistry,\n): Promise<unknown | undefined> {\n const tools = buildSdkFunctionTools(registry);\n if (tools.length === 0) return undefined;\n\n const sdk = (await import(\"@anthropic-ai/claude-agent-sdk\")) as Record<\n string,\n unknown\n >;\n const toolFn = sdk.tool as\n | ((def: Record<string, unknown>) => unknown)\n | undefined;\n const createServer = sdk.createSdkMcpServer as\n | ((tools: unknown[]) => unknown)\n | undefined;\n\n if (!toolFn || !createServer) return undefined;\n\n const { z } = await import(\"zod\");\n const { jsonSchemaToZod } = await import(\"./schema-converter.js\");\n\n const sdkTools = tools.map((t) =>\n toolFn({\n name: t.name,\n description: t.description,\n inputSchema: jsonSchemaToZod(t.inputSchema),\n execute: async (args: unknown) => {\n return t.handler(\n (args ?? {}) as Record<string, unknown>,\n );\n },\n }),\n );\n\n return createServer(sdkTools);\n}\n\n// ---------------------------------------------------------------------------\n// OpenAI Agents SDK — function tool objects\n// ---------------------------------------------------------------------------\n\n/**\n * Build OpenAI Agents SDK function tool objects from a LibraryToolRegistry.\n *\n * Dynamically imports `tool` from @openai/agents if available.\n * Falls back to a raw function-tool shape that the SDK also accepts.\n */\nexport async function buildOpenAIFunctionTools(\n registry: LibraryToolRegistry,\n): Promise<unknown[]> {\n const tools = buildSdkFunctionTools(registry);\n if (tools.length === 0) return [];\n\n try {\n const sdk = (await import(\"@openai/agents\")) as Record<string, unknown>;\n const toolFn = sdk.tool as\n | ((def: Record<string, unknown>) => unknown)\n | undefined;\n\n if (toolFn) {\n const { jsonSchemaToZod } = await import(\"./schema-converter.js\");\n return tools.map((t) =>\n toolFn({\n name: t.name,\n description: t.description,\n parameters: jsonSchemaToZod(t.inputSchema),\n execute: async (_ctx: unknown, args: unknown) => {\n return t.handler(\n (args ?? {}) as Record<string, unknown>,\n );\n },\n }),\n );\n }\n } catch {\n // SDK not available; fall through to raw format\n }\n\n return tools.map((t) => ({\n type: \"function\" as const,\n function: {\n name: t.name,\n description: t.description,\n parameters: t.inputSchema,\n },\n execute: async (args: unknown) => {\n return t.handler(\n (args ?? {}) as Record<string, unknown>,\n );\n },\n }));\n}\n\n// ---------------------------------------------------------------------------\n// Google ADK — function tool objects\n// ---------------------------------------------------------------------------\n\n/**\n * Build Google ADK function tool objects from a LibraryToolRegistry.\n *\n * ADK's LlmAgent accepts tools as objects with a FunctionDeclaration shape\n * or as callable tool instances. We produce lightweight callable wrappers.\n */\nexport async function buildAdkFunctionTools(\n registry: LibraryToolRegistry,\n): Promise<unknown[]> {\n const tools = buildSdkFunctionTools(registry);\n if (tools.length === 0) return [];\n\n return tools.map((t) => ({\n name: t.name,\n description: t.description,\n inputSchema: t.inputSchema,\n execute: async (args: unknown) => {\n return t.handler(\n (args ?? {}) as Record<string, unknown>,\n );\n },\n }));\n}\n"],"mappings":"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","names":["tokenAttrs"]}
|
package/dist/index.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { O as ObserverEmitFn, b as TaskContext, c as TaskOutcome, d as AgentContractLike, e as TaskContractLike, P as PromptBuilderOptions, W as WorkflowResult, S as SdkAdapter, f as WorkflowRegistries, H as HandoffInput, g as StepCompleteEvent, h as StepResult, D as DelegateStep, i as GuardrailRuleData, j as MemoryStore, M as MemoryRef, 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-
|
|
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
|
|
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-CVh7Luc_.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 parseGateEvaluationResponse, aN as renderAgentSystemPrompt, aO as runTask, aP as runToolchainChecks, aQ as runWorkflow, aR as zodSchemaToPromptDescription, aS as zodSchemaToYamlExample } from './task-runner-CVh7Luc_.js';
|
|
3
3
|
import { z } from 'zod';
|
|
4
4
|
import { OperationIR, ComponentIR } from '@aaac/contracts';
|
|
5
5
|
import { ResolvedConfig } from './generator/index.js';
|
package/dist/index.js
CHANGED
|
@@ -9,6 +9,8 @@ import {
|
|
|
9
9
|
pluginRegistry
|
|
10
10
|
} from "./chunk-GZCEEIXQ.js";
|
|
11
11
|
import {
|
|
12
|
+
OBSERVABILITY_ENV_VARS,
|
|
13
|
+
buildObservabilityEnv,
|
|
12
14
|
buildSdkFunctionTools,
|
|
13
15
|
createExecutionEnvelope,
|
|
14
16
|
emitIterationClose,
|
|
@@ -24,7 +26,7 @@ import {
|
|
|
24
26
|
emitToolExecOpen,
|
|
25
27
|
emitToolchainClose,
|
|
26
28
|
emitToolchainOpen
|
|
27
|
-
} from "./chunk-
|
|
29
|
+
} from "./chunk-LWMRO7RR.js";
|
|
28
30
|
import {
|
|
29
31
|
buildGuardrailContext,
|
|
30
32
|
loadProjectConfig
|
|
@@ -1080,11 +1082,13 @@ async function tryManifestFastPath(toolchainId, cwd) {
|
|
|
1080
1082
|
return null;
|
|
1081
1083
|
}
|
|
1082
1084
|
}
|
|
1083
|
-
async function executeCheck(command, cwd) {
|
|
1085
|
+
async function executeCheck(command, cwd, observabilityIds) {
|
|
1086
|
+
const env = observabilityIds ? buildObservabilityEnv(observabilityIds) : void 0;
|
|
1084
1087
|
try {
|
|
1085
1088
|
const { stdout, stderr } = await execFileAsync("sh", ["-c", command], {
|
|
1086
1089
|
cwd,
|
|
1087
|
-
timeout: SUBPROCESS_TIMEOUT_MS
|
|
1090
|
+
timeout: SUBPROCESS_TIMEOUT_MS,
|
|
1091
|
+
...env ? { env } : {}
|
|
1088
1092
|
});
|
|
1089
1093
|
return { exitCode: 0, stdout, stderr };
|
|
1090
1094
|
} catch (err) {
|
|
@@ -1110,7 +1114,8 @@ async function runToolchainChecks(options) {
|
|
|
1110
1114
|
defaultAction,
|
|
1111
1115
|
observer,
|
|
1112
1116
|
parentSpanId,
|
|
1113
|
-
componentId
|
|
1117
|
+
componentId,
|
|
1118
|
+
observabilityIds
|
|
1114
1119
|
} = options;
|
|
1115
1120
|
const cwd = workingDir ?? process.cwd();
|
|
1116
1121
|
const contracts = await parseToolchainFile(toolchainsPath);
|
|
@@ -1137,7 +1142,7 @@ async function runToolchainChecks(options) {
|
|
|
1137
1142
|
result = fastResult;
|
|
1138
1143
|
} else {
|
|
1139
1144
|
try {
|
|
1140
|
-
const { exitCode, stderr } = await executeCheck(command, cwd);
|
|
1145
|
+
const { exitCode, stderr } = await executeCheck(command, cwd, observabilityIds);
|
|
1141
1146
|
const durationMs = Math.round(performance.now() - start);
|
|
1142
1147
|
result = {
|
|
1143
1148
|
toolchainId,
|
|
@@ -1637,7 +1642,13 @@ ${JSON.stringify(data, null, 2)}`;
|
|
|
1637
1642
|
await runToolchainChecks({
|
|
1638
1643
|
...options.toolchain,
|
|
1639
1644
|
observer: options.observer,
|
|
1640
|
-
parentSpanId: sessionSpanId
|
|
1645
|
+
parentSpanId: sessionSpanId,
|
|
1646
|
+
// Propagate session correlation to any git spawned by a check (#115):
|
|
1647
|
+
// the session id is the agent.session run_id (== sessionSpanId).
|
|
1648
|
+
observabilityIds: {
|
|
1649
|
+
sessionId: sessionSpanId ?? sessionEnvelope.run_id,
|
|
1650
|
+
runId: sessionEnvelope.run_id
|
|
1651
|
+
}
|
|
1641
1652
|
});
|
|
1642
1653
|
} catch {
|
|
1643
1654
|
}
|
|
@@ -3675,6 +3686,7 @@ export {
|
|
|
3675
3686
|
DslValidationError,
|
|
3676
3687
|
FileMemoryStore,
|
|
3677
3688
|
InMemoryStore,
|
|
3689
|
+
OBSERVABILITY_ENV_VARS,
|
|
3678
3690
|
PROJECT_CONFIG_FILENAME,
|
|
3679
3691
|
PluginRegistry,
|
|
3680
3692
|
ToolchainManifestSchema,
|
|
@@ -3683,6 +3695,7 @@ export {
|
|
|
3683
3695
|
buildGateEvaluationPrompt,
|
|
3684
3696
|
buildGuardrailRulesFromDsl,
|
|
3685
3697
|
buildNavigationContext,
|
|
3698
|
+
buildObservabilityEnv,
|
|
3686
3699
|
buildPerAgentGuardrails,
|
|
3687
3700
|
buildRegistriesFromDsl,
|
|
3688
3701
|
buildRetryFollowUp,
|