@aaac/runtime 0.1.40 → 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.
- package/dist/adapters/adk-sdk.d.ts +1 -1
- package/dist/adapters/adk-sdk.js +2 -2
- package/dist/adapters/claude-agent-sdk.d.ts +1 -1
- package/dist/adapters/claude-agent-sdk.js +2 -2
- 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 +2 -2
- package/dist/{chunk-WFIXO3GQ.js → chunk-IGSKPSU3.js} +2 -2
- package/dist/{chunk-GNMSH3VC.js → chunk-KXGUWBGK.js} +1 -1
- package/dist/chunk-KXGUWBGK.js.map +1 -0
- package/dist/{chunk-4MFHJYYK.js → chunk-NSYQZX6R.js} +2 -2
- package/dist/index.d.ts +22 -3
- package/dist/index.js +55 -6
- package/dist/index.js.map +1 -1
- package/dist/lib/claude-native/index.js +2 -2
- package/dist/{task-runner-CWb9fVlc.d.ts → task-runner-D7ZxILN4.d.ts} +2 -2
- package/package.json +2 -2
- package/dist/chunk-GNMSH3VC.js.map +0 -1
- /package/dist/{chunk-WFIXO3GQ.js.map → chunk-IGSKPSU3.js.map} +0 -0
- /package/dist/{chunk-4MFHJYYK.js.map → chunk-NSYQZX6R.js.map} +0 -0
|
@@ -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-
|
|
1
|
+
import { S as SdkAdapter, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef, T as TokenUsage } from '../task-runner-D7ZxILN4.js';
|
|
2
2
|
import { G as GuardrailHooks } from '../guardrail-hooks-slK-z0Dz.js';
|
|
3
3
|
import 'zod';
|
|
4
4
|
import '../context-DKkamYX_.js';
|
package/dist/adapters/adk-sdk.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import {
|
|
2
2
|
buildAdkFunctionTools
|
|
3
|
-
} from "../chunk-
|
|
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-
|
|
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-
|
|
1
|
+
import { S as SdkAdapter, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef, T as TokenUsage } from '../task-runner-D7ZxILN4.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-
|
|
5
|
+
} from "../chunk-NSYQZX6R.js";
|
|
6
6
|
import {
|
|
7
7
|
emitLlmTurnClose,
|
|
8
8
|
emitLlmTurnOpen,
|
|
9
9
|
emitToolExecClose,
|
|
10
10
|
emitToolExecOpen
|
|
11
|
-
} from "../chunk-
|
|
11
|
+
} from "../chunk-KXGUWBGK.js";
|
|
12
12
|
|
|
13
13
|
// src/adapters/claude-agent-sdk.ts
|
|
14
14
|
function buildClaudeHooks(guardrails) {
|
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-D7ZxILN4.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-
|
|
1
|
+
import { S as SdkAdapter, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef, T as TokenUsage } from '../task-runner-D7ZxILN4.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-
|
|
3
|
+
} from "../chunk-NSYQZX6R.js";
|
|
4
4
|
import {
|
|
5
5
|
emitLlmTurnClose,
|
|
6
6
|
emitLlmTurnOpen,
|
|
7
7
|
emitToolExecClose,
|
|
8
8
|
emitToolExecOpen
|
|
9
|
-
} from "../chunk-
|
|
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-
|
|
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-
|
|
1647
|
+
//# sourceMappingURL=chunk-IGSKPSU3.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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-D7ZxILN4.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-D7ZxILN4.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.
|
|
@@ -922,4 +941,4 @@ declare function executePrompt(message: string, ir: ComponentIR, binding: Runtim
|
|
|
922
941
|
/** Package version string. */
|
|
923
942
|
declare const version: string;
|
|
924
943
|
|
|
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 };
|
|
944
|
+
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-
|
|
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-
|
|
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-
|
|
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,9 +379,18 @@ 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
|
|
352
|
-
|
|
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("");
|
|
353
394
|
};
|
|
354
395
|
var extractPath = extractPath2, projectHandoffs = projectHandoffs2, contextFor = contextFor2;
|
|
355
396
|
const stepId = (i) => {
|
|
@@ -357,9 +398,13 @@ async function runWorkflow(adapterOrFactory, workflowIdOrInvocation, optionsOrRe
|
|
|
357
398
|
if (s.type === "delegate" || s.type === "evaluate") return s.task;
|
|
358
399
|
return `gate:${s.gate_kind}`;
|
|
359
400
|
};
|
|
401
|
+
const workflowInputOutput = buildWorkflowInputOutput(
|
|
402
|
+
options.user_request,
|
|
403
|
+
invocationHandoff
|
|
404
|
+
);
|
|
360
405
|
const depsByIndex = workflow.steps.map((step, i) => {
|
|
361
406
|
if (step.depends_on !== void 0) {
|
|
362
|
-
return step.depends_on.map((dep) => {
|
|
407
|
+
return step.depends_on.filter((dep) => dep !== WORKFLOW_INPUT_STEP_ID).map((dep) => {
|
|
363
408
|
const idx = workflow.steps.findIndex((s, j) => j < i && stepId(j) === dep);
|
|
364
409
|
if (idx === -1) {
|
|
365
410
|
throw new Error(`depends_on "${dep}" in step ${i} (${stepId(i)}) not found among preceding steps`);
|
|
@@ -2624,6 +2669,7 @@ export {
|
|
|
2624
2669
|
PROJECT_CONFIG_FILENAME,
|
|
2625
2670
|
PluginRegistry,
|
|
2626
2671
|
ToolchainManifestSchema,
|
|
2672
|
+
WORKFLOW_INPUT_STEP_ID,
|
|
2627
2673
|
WorkflowBuilder,
|
|
2628
2674
|
buildCandidateAgents,
|
|
2629
2675
|
buildGateEvaluationPrompt,
|
|
@@ -2636,6 +2682,7 @@ export {
|
|
|
2636
2682
|
buildSdkFunctionTools,
|
|
2637
2683
|
buildSplitTaskPrompt,
|
|
2638
2684
|
buildTaskPrompt,
|
|
2685
|
+
buildWorkflowInputOutput,
|
|
2639
2686
|
checkClaude,
|
|
2640
2687
|
collectAnalyzerToolIds,
|
|
2641
2688
|
createAdapter,
|
|
@@ -2677,6 +2724,7 @@ export {
|
|
|
2677
2724
|
executeWorkflow,
|
|
2678
2725
|
extractStructuredResult,
|
|
2679
2726
|
findProjectConfig,
|
|
2727
|
+
formatWorkflowInputContext,
|
|
2680
2728
|
getBlockingViolations,
|
|
2681
2729
|
getEffectiveGuardrailIds,
|
|
2682
2730
|
getGuardrailRulesForAgent,
|
|
@@ -2708,6 +2756,7 @@ export {
|
|
|
2708
2756
|
runWorkflow,
|
|
2709
2757
|
serializeObserverEmit,
|
|
2710
2758
|
shouldInjectAnalyzerExplorationMandate,
|
|
2759
|
+
stepDependsOnWorkflowInput,
|
|
2711
2760
|
syncClaude,
|
|
2712
2761
|
version,
|
|
2713
2762
|
zodSchemaToPromptDescription,
|