@aaac/runtime 0.1.18 → 0.1.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,4 +1,4 @@
1
- import { S as SdkAdapter, G as GuardrailHooks, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef } from '../task-runner-DUyztyo3.js';
1
+ import { S as SdkAdapter, G as GuardrailHooks, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef } from '../task-runner-DV49qwpk.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 } from '../task-runner-DUyztyo3.js';
1
+ import { S as SdkAdapter, G as GuardrailHooks, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef } from '../task-runner-DV49qwpk.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, A as AdapterSendOptions, M as MemoryRef } from '../task-runner-DUyztyo3.js';
1
+ import { S as SdkAdapter, A as AdapterSendOptions, M as MemoryRef } from '../task-runner-DV49qwpk.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 } from '../task-runner-DUyztyo3.js';
1
+ import { S as SdkAdapter, G as GuardrailHooks, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef } from '../task-runner-DV49qwpk.js';
2
2
  import 'zod';
3
3
  import '../context-DKkamYX_.js';
4
4
  import '@aaac/observability';
@@ -96,7 +96,11 @@ var BindingsSchema = z.object({
96
96
  hooks: z.array(z.string()).optional(),
97
97
  observability: z.object({
98
98
  event_mapping: z.string().optional(),
99
- recorder: z.string().optional()
99
+ recorder: z.string().optional(),
100
+ /** Toggle in-process agent-axis recording. Defaults to ON when this binding exists. */
101
+ enabled: z.boolean().optional(),
102
+ /** Override the SQLite DB path for in-process recording (default: DEFAULT_DB_PATH). */
103
+ db_path: z.string().optional()
100
104
  }).optional()
101
105
  }).optional();
102
106
  var CliSectionSchema = z.object({
@@ -217,7 +221,9 @@ function buildResolvedConfig(config, configDir, governance) {
217
221
  hookBindingPaths: (governance?.hookBindings ?? []).map((b) => resolve(configDir, b)),
218
222
  observability: governance?.observability ? {
219
223
  eventMappingPath: governance.observability.event_mapping ? resolve(configDir, governance.observability.event_mapping) : void 0,
220
- recorder: governance.observability.recorder
224
+ recorder: governance.observability.recorder,
225
+ enabled: governance.observability.enabled,
226
+ dbPath: governance.observability.db_path ? resolve(configDir, governance.observability.db_path) : void 0
221
227
  } : void 0,
222
228
  templatesDir: config.templates_dir ? resolve(configDir, config.templates_dir) : void 0,
223
229
  pluginPaths: config.plugins,
@@ -286,4 +292,4 @@ export {
286
292
  ProjectConfigSchema,
287
293
  loadProjectConfig
288
294
  };
289
- //# sourceMappingURL=chunk-E2UR4TNM.js.map
295
+ //# sourceMappingURL=chunk-RL4TCIDU.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/generator/context.ts","../src/generator/config.ts"],"sourcesContent":["/**\n * Build the guardrail context from resolved DSL + binding data.\n *\n * (The DSL→TypeScript codegen context builder, `buildContractContext`, was\n * removed alongside the runtime `generate()` codegen path.)\n */\n\nexport interface GuardrailCheckEntry {\n guardrail_id: string;\n description: string;\n severity: string;\n action: string;\n matcher_type: string;\n pattern: string;\n message: string;\n file_glob?: string;\n exclude_glob?: string;\n}\n\nexport interface GuardrailContext {\n commandChecks: GuardrailCheckEntry[];\n fileChecks: GuardrailCheckEntry[];\n contentChecks: GuardrailCheckEntry[];\n allChecks: GuardrailCheckEntry[];\n hasGuardrails: boolean;\n}\n\n/**\n * Build guardrail context from DSL guardrails, binding guardrail_impl, and active policy.\n * Mirrors the agent-contracts resolveChecks pattern.\n */\nexport function buildGuardrailContext(\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n dsl: any,\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n binding: any,\n policyName?: string,\n): GuardrailContext {\n const empty: GuardrailContext = {\n commandChecks: [],\n fileChecks: [],\n contentChecks: [],\n allChecks: [],\n hasGuardrails: false,\n };\n\n if (!binding?.guardrail_impl) return empty;\n\n const guardrails = dsl.guardrails ?? {};\n const policies = dsl.guardrail_policies ?? {};\n const policy = policyName ? policies[policyName] : undefined;\n\n const allChecks: GuardrailCheckEntry[] = [];\n\n for (const [guardrailId, impl] of Object.entries(\n binding.guardrail_impl as Record<string, { checks: Array<Record<string, unknown>> }>,\n )) {\n const guardrail = guardrails[guardrailId] as Record<string, unknown> | undefined;\n const description = (guardrail?.description as string) ?? guardrailId;\n\n const policyRule = policy?.rules?.find(\n (r: Record<string, unknown>) => r.guardrail === guardrailId,\n );\n const severity = (policyRule?.severity as string) ?? \"warning\";\n const action = (policyRule?.action as string) ?? \"warn\";\n\n for (const check of impl.checks) {\n const matcher = check.matcher as Record<string, unknown> | undefined;\n if (!matcher) continue;\n\n allChecks.push({\n guardrail_id: guardrailId,\n description,\n severity,\n action,\n matcher_type: matcher.type as string,\n pattern: matcher.pattern as string,\n message: (check.message as string) ?? description,\n file_glob: matcher.file_glob as string | undefined,\n exclude_glob: matcher.exclude_glob as string | undefined,\n });\n }\n }\n\n return {\n commandChecks: allChecks.filter((c) => c.matcher_type === \"command_regex\"),\n fileChecks: allChecks.filter((c) => c.matcher_type === \"file_glob\"),\n contentChecks: allChecks.filter((c) => c.matcher_type === \"content_regex\"),\n allChecks,\n hasGuardrails: allChecks.length > 0,\n };\n}\n","/**\n * Generator configuration — loads and validates agents.conf.yaml\n */\n\nimport { readFile } from \"node:fs/promises\";\nimport { resolve, dirname } from \"node:path\";\nimport { z } from \"zod\";\nimport YAML from \"yaml\";\n\nexport const DEFAULT_CONFIG_PATH = \"./agents.conf.yaml\";\n\nconst RecoverySchema = z.object({\n max_follow_ups: z.number().int().min(0).default(2),\n max_retries: z.number().int().min(0).default(0),\n}).default(() => ({ max_follow_ups: 2, max_retries: 0 }));\n\nconst ModelClassEntrySchema = z.object({\n adapter: z.string(),\n model: z.string().optional(),\n});\n\nconst ModelMappingSchema = z.object({\n fast: ModelClassEntrySchema.optional(),\n standard: ModelClassEntrySchema.optional(),\n thinking: ModelClassEntrySchema.optional(),\n}).default({});\n\nconst ProgressLogSchema = z.object({\n destination: z.enum([\"stderr\", \"file\", \"both\", \"none\"]).default(\"stderr\"),\n file: z.string().optional(),\n naming: z.enum([\"single\", \"per-invocation\", \"daily\"]).default(\"single\"),\n}).default(() => ({ destination: \"stderr\" as const, naming: \"single\" as const }))\n .refine(\n (val) => {\n if ((val.destination === \"file\" || val.destination === \"both\") && !val.file) return false;\n return true;\n },\n { message: \"logging.progress_log.file is required when destination is 'file' or 'both'\" },\n );\n\nconst LoggingSchema = z.object({\n progress_log: ProgressLogSchema,\n}).default(() => ({ progress_log: { destination: \"stderr\" as const, naming: \"single\" as const } }));\n\nexport const RuntimeConfigSchema = z.object({\n dsl: z.string().default(\"./agent-contracts.yaml\"),\n generated_dir: z.string().default(\"./agent/generated\"),\n bindings: z.array(z.string()).default([]),\n active_guardrail_policy: z.string().optional(),\n templates_dir: z.string().optional(),\n plugins: z.array(z.string()).default([]),\n recovery: RecoverySchema,\n model_mapping: ModelMappingSchema,\n logging: LoggingSchema,\n});\n\nexport type RuntimeConfig = z.infer<typeof RuntimeConfigSchema>;\n\n/**\n * Unified project bindings object.\n * - guardrail: guardrail_impl matcher files → machine enforcement (BoundResolver)\n * - hooks: git hook bindings → governance materialize (#68; declarative for now)\n * - observability: event-mapping file + external recorder CLI\n */\nconst BindingsSchema = z.object({\n guardrail: z.array(z.string()).optional(),\n hooks: z.array(z.string()).optional(),\n observability: z.object({\n event_mapping: z.string().optional(),\n recorder: z.string().optional(),\n /** Toggle in-process agent-axis recording. Defaults to ON when this binding exists. */\n enabled: z.boolean().optional(),\n /** Override the SQLite DB path for in-process recording (default: DEFAULT_DB_PATH). */\n db_path: z.string().optional(),\n }).optional(),\n}).optional();\n\nconst CliSectionSchema = z.object({\n agents: z.string().optional(),\n dsl: z.string().optional(),\n generated_dir: z.string().optional(),\n plugins: z.array(z.string()).optional(),\n bindings: BindingsSchema,\n}).strict();\n\nexport const ComponentOverrideSchema = z.object({\n agents: z.string().optional(),\n dsl: z.string().optional(),\n component_contract: z.string().optional(),\n generated_dir: z.string().optional(),\n bindings: BindingsSchema,\n plugins: z.array(z.string()).optional(),\n model_mapping: ModelMappingSchema.optional(),\n recovery: RecoverySchema.optional(),\n templates_dir: z.string().optional(),\n}).strict();\n\nexport type ComponentOverride = z.infer<typeof ComponentOverrideSchema>;\n\nconst EnvironmentsSchema = z.object({\n git: z.object({\n hooks: z.array(z.string()).optional(),\n }).optional(),\n cursor: z.object({\n hooks_json: z.string().optional(),\n }).optional(),\n ci: z.object({\n provider: z.string().optional(),\n }).optional(),\n}).optional();\n\nexport const ProjectConfigSchema = z.object({\n schema: z.string().optional(),\n agents: z.string().optional(),\n dsl: z.string().optional(),\n generated_dir: z.string().optional(),\n bindings: BindingsSchema,\n active_guardrail_policy: z.string().optional(),\n templates_dir: z.string().optional(),\n plugins: z.array(z.string()).optional(),\n recovery: RecoverySchema,\n model_mapping: ModelMappingSchema,\n logging: LoggingSchema,\n artifacts: z.string().optional(),\n toolchains: z.string().optional(),\n components: z.record(z.string(), ComponentOverrideSchema).optional(),\n environments: EnvironmentsSchema,\n cli: z.record(z.string(), CliSectionSchema).optional(),\n});\n\nexport type ProjectConfig = z.infer<typeof ProjectConfigSchema>;\n\nexport interface ResolvedProgressLog {\n destination: \"stderr\" | \"file\" | \"both\" | \"none\";\n file: string | undefined;\n naming: \"single\" | \"per-invocation\" | \"daily\";\n}\n\nexport interface ResolvedEnvironments {\n git?: { hooks: string[] };\n cursor?: { hooks_json: string };\n ci?: { provider: string };\n}\n\nexport interface ResolvedObservability {\n eventMappingPath?: string;\n recorder?: string;\n /** Whether in-process agent-axis recording is enabled (default true when binding present). */\n enabled?: boolean;\n /** Resolved override for the SQLite DB path (undefined → DEFAULT_DB_PATH). */\n dbPath?: string;\n}\n\nexport interface ResolvedConfig extends RuntimeConfig {\n configDir: string;\n dslPath: string;\n generatedDir: string;\n /** Resolved guardrail_impl matcher files (machine enforcement). */\n bindingPaths: string[];\n /** Resolved git-hook binding files (governance materialize, #68). */\n hookBindingPaths: string[];\n /** Observability event mapping + recorder, if configured. */\n observability?: ResolvedObservability;\n templatesDir: string | undefined;\n pluginPaths: string[];\n resolvedLogging: { progressLog: ResolvedProgressLog };\n artifactsPath?: string;\n toolchainsPath?: string;\n environments?: ResolvedEnvironments;\n componentOverrides?: Record<string, ComponentOverride>;\n}\n\ninterface GovernanceFields {\n artifacts?: string;\n toolchains?: string;\n environments?: z.infer<typeof EnvironmentsSchema>;\n componentOverrides?: Record<string, ComponentOverride>;\n hookBindings?: string[];\n observability?: { event_mapping?: string; recorder?: string; enabled?: boolean; db_path?: string };\n}\n\n/** Internal runtime base assembled from a project manifest before RuntimeConfigSchema validation. */\ninterface RuntimeConfigInput {\n dsl?: string;\n generated_dir?: string;\n bindings: string[];\n active_guardrail_policy?: string;\n templates_dir?: string;\n plugins?: string[];\n recovery: z.infer<typeof RecoverySchema>;\n model_mapping: z.infer<typeof ModelMappingSchema>;\n logging: z.infer<typeof LoggingSchema>;\n}\n\ntype ConfigOverride = ComponentOverride | z.infer<typeof CliSectionSchema>;\n\nfunction resolveConfigFilePath(configPath: string): string {\n return resolve(configPath);\n}\n\nfunction mergeBindingsUnion(root: string[] | undefined, override: string[] | undefined): string[] {\n const base = root ?? [];\n const extra = override ?? [];\n const seen = new Set(base);\n const result = [...base];\n for (const binding of extra) {\n if (!seen.has(binding)) {\n result.push(binding);\n seen.add(binding);\n }\n }\n return result;\n}\n\nfunction mergeConfigWithOverride(\n base: RuntimeConfigInput,\n override: ConfigOverride,\n): RuntimeConfigInput {\n const merged: RuntimeConfigInput = { ...base };\n\n const overrideDsl = override.agents ?? override.dsl;\n if (overrideDsl !== undefined) merged.dsl = overrideDsl;\n if (override.generated_dir !== undefined) merged.generated_dir = override.generated_dir;\n if (override.bindings?.guardrail !== undefined) {\n merged.bindings = mergeBindingsUnion(base.bindings, override.bindings.guardrail);\n }\n if (override.plugins !== undefined) merged.plugins = override.plugins;\n\n if (\"templates_dir\" in override && override.templates_dir !== undefined) {\n merged.templates_dir = override.templates_dir;\n }\n\n if (\"model_mapping\" in override && override.model_mapping) {\n merged.model_mapping = {\n ...base.model_mapping,\n ...(override.model_mapping.fast ? { fast: override.model_mapping.fast } : {}),\n ...(override.model_mapping.standard ? { standard: override.model_mapping.standard } : {}),\n ...(override.model_mapping.thinking ? { thinking: override.model_mapping.thinking } : {}),\n };\n }\n\n if (\"recovery\" in override && override.recovery) {\n merged.recovery = {\n ...base.recovery,\n ...override.recovery,\n };\n }\n\n return merged;\n}\n\nfunction resolveEnvironments(\n environments: z.infer<typeof EnvironmentsSchema>,\n configDir: string,\n): ResolvedEnvironments | undefined {\n if (!environments) return undefined;\n\n const resolved: ResolvedEnvironments = {};\n\n if (environments.git?.hooks) {\n resolved.git = { hooks: environments.git.hooks };\n }\n\n if (environments.cursor?.hooks_json) {\n resolved.cursor = {\n hooks_json: resolve(configDir, environments.cursor.hooks_json),\n };\n }\n\n if (environments.ci?.provider) {\n resolved.ci = { provider: environments.ci.provider };\n }\n\n return Object.keys(resolved).length > 0 ? resolved : undefined;\n}\n\nfunction buildResolvedConfig(\n config: RuntimeConfig,\n configDir: string,\n governance?: GovernanceFields,\n): ResolvedConfig {\n const pl = config.logging.progress_log;\n\n return {\n ...config,\n configDir,\n dslPath: resolve(configDir, config.dsl),\n generatedDir: resolve(configDir, config.generated_dir),\n bindingPaths: config.bindings.map((b) => resolve(configDir, b)),\n hookBindingPaths: (governance?.hookBindings ?? []).map((b) => resolve(configDir, b)),\n observability: governance?.observability\n ? {\n eventMappingPath: governance.observability.event_mapping\n ? resolve(configDir, governance.observability.event_mapping)\n : undefined,\n recorder: governance.observability.recorder,\n enabled: governance.observability.enabled,\n dbPath: governance.observability.db_path\n ? resolve(configDir, governance.observability.db_path)\n : undefined,\n }\n : undefined,\n templatesDir: config.templates_dir\n ? resolve(configDir, config.templates_dir)\n : undefined,\n pluginPaths: config.plugins,\n resolvedLogging: {\n progressLog: {\n destination: pl.destination,\n file: pl.file ? resolve(configDir, pl.file) : undefined,\n naming: pl.naming,\n },\n },\n artifactsPath: governance?.artifacts\n ? resolve(configDir, governance.artifacts)\n : undefined,\n toolchainsPath: governance?.toolchains\n ? resolve(configDir, governance.toolchains)\n : undefined,\n environments: resolveEnvironments(governance?.environments, configDir),\n componentOverrides: governance?.componentOverrides,\n };\n}\n\n/** Assemble the internal runtime base from a parsed project manifest (agents wins over dsl alias). */\nfunction projectToRuntimeBase(projectConfig: ProjectConfig): RuntimeConfigInput {\n return {\n dsl: projectConfig.agents ?? projectConfig.dsl,\n generated_dir: projectConfig.generated_dir,\n bindings: projectConfig.bindings?.guardrail ?? [],\n active_guardrail_policy: projectConfig.active_guardrail_policy,\n templates_dir: projectConfig.templates_dir,\n plugins: projectConfig.plugins,\n recovery: projectConfig.recovery,\n model_mapping: projectConfig.model_mapping,\n logging: projectConfig.logging,\n };\n}\n\nfunction resolveOverride(\n projectConfig: ProjectConfig,\n target?: string,\n): ConfigOverride | undefined {\n if (!target) return undefined;\n\n if (projectConfig.components?.[target]) {\n return projectConfig.components[target];\n }\n\n if (projectConfig.cli?.[target]) {\n return projectConfig.cli[target];\n }\n\n return undefined;\n}\n\nexport async function loadProjectConfig(\n configPath: string,\n target?: string,\n): Promise<ResolvedConfig> {\n const absPath = resolveConfigFilePath(configPath);\n const raw = await readFile(absPath, \"utf8\");\n const parsed = YAML.parse(raw);\n const projectConfig = ProjectConfigSchema.parse(parsed);\n\n let base = projectToRuntimeBase(projectConfig);\n const override = resolveOverride(projectConfig, target);\n\n if (override) {\n base = mergeConfigWithOverride(base, override);\n }\n\n const config = RuntimeConfigSchema.parse(base);\n const configDir = dirname(absPath);\n\n return buildResolvedConfig(config, configDir, {\n artifacts: projectConfig.artifacts,\n toolchains: projectConfig.toolchains,\n environments: projectConfig.environments,\n componentOverrides: projectConfig.components,\n hookBindings: projectConfig.bindings?.hooks,\n observability: projectConfig.bindings?.observability,\n });\n}\n"],"mappings":"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","names":[]}
@@ -60,6 +60,8 @@ declare const ComponentOverrideSchema: z.ZodObject<{
60
60
  observability: z.ZodOptional<z.ZodObject<{
61
61
  event_mapping: z.ZodOptional<z.ZodString>;
62
62
  recorder: z.ZodOptional<z.ZodString>;
63
+ enabled: z.ZodOptional<z.ZodBoolean>;
64
+ db_path: z.ZodOptional<z.ZodString>;
63
65
  }, z.core.$strip>>;
64
66
  }, z.core.$strip>>;
65
67
  plugins: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -95,6 +97,8 @@ declare const ProjectConfigSchema: z.ZodObject<{
95
97
  observability: z.ZodOptional<z.ZodObject<{
96
98
  event_mapping: z.ZodOptional<z.ZodString>;
97
99
  recorder: z.ZodOptional<z.ZodString>;
100
+ enabled: z.ZodOptional<z.ZodBoolean>;
101
+ db_path: z.ZodOptional<z.ZodString>;
98
102
  }, z.core.$strip>>;
99
103
  }, z.core.$strip>>;
100
104
  active_guardrail_policy: z.ZodOptional<z.ZodString>;
@@ -147,6 +151,8 @@ declare const ProjectConfigSchema: z.ZodObject<{
147
151
  observability: z.ZodOptional<z.ZodObject<{
148
152
  event_mapping: z.ZodOptional<z.ZodString>;
149
153
  recorder: z.ZodOptional<z.ZodString>;
154
+ enabled: z.ZodOptional<z.ZodBoolean>;
155
+ db_path: z.ZodOptional<z.ZodString>;
150
156
  }, z.core.$strip>>;
151
157
  }, z.core.$strip>>;
152
158
  plugins: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -192,6 +198,8 @@ declare const ProjectConfigSchema: z.ZodObject<{
192
198
  observability: z.ZodOptional<z.ZodObject<{
193
199
  event_mapping: z.ZodOptional<z.ZodString>;
194
200
  recorder: z.ZodOptional<z.ZodString>;
201
+ enabled: z.ZodOptional<z.ZodBoolean>;
202
+ db_path: z.ZodOptional<z.ZodString>;
195
203
  }, z.core.$strip>>;
196
204
  }, z.core.$strip>>;
197
205
  }, z.core.$strict>>>;
@@ -216,6 +224,10 @@ interface ResolvedEnvironments {
216
224
  interface ResolvedObservability {
217
225
  eventMappingPath?: string;
218
226
  recorder?: string;
227
+ /** Whether in-process agent-axis recording is enabled (default true when binding present). */
228
+ enabled?: boolean;
229
+ /** Resolved override for the SQLite DB path (undefined → DEFAULT_DB_PATH). */
230
+ dbPath?: string;
219
231
  }
220
232
  interface ResolvedConfig extends RuntimeConfig {
221
233
  configDir: string;
@@ -4,7 +4,7 @@ import {
4
4
  ProjectConfigSchema,
5
5
  buildGuardrailContext,
6
6
  loadProjectConfig
7
- } from "../chunk-E2UR4TNM.js";
7
+ } from "../chunk-RL4TCIDU.js";
8
8
  export {
9
9
  ComponentOverrideSchema,
10
10
  DEFAULT_CONFIG_PATH,
package/dist/index.d.ts CHANGED
@@ -1,5 +1,5 @@
1
- import { O as ObserverEmitFn, T as TaskContext, b as TaskOutcome, c as AgentContractLike, d as TaskContractLike, P as PromptBuilderOptions, W as WorkflowResult, S as SdkAdapter, e as WorkflowRegistries, H as HandoffInput, f as StepCompleteEvent, g as StepResult, D as DelegateStep, h as GuardrailRuleData, i as MemoryStore, M as MemoryRef, L as LibraryToolRegistry, G as GuardrailHooks, R as ResolvedComponent, j as ArtifactBindingConfig, k as TaskRunResult, l as ResolvedToolchain, m as LibraryToolDefinition, n as HookResponse, o as GuardrailCheckResult } from './task-runner-DUyztyo3.js';
2
- export { p as AdapterOrFactory, A as AdapterSendOptions, a as AgentExecutionRequest, q as AgentProgressEvent, B as BoundResolveOptions, r as BoundResolver, C as CacheConfig, s as CandidateAgent, t as ConvergenceEnvelope, u as ConvergenceEnvelopePayload, E as EnvelopeParams, v as EvaluateStep, w as GateStep, x as GuardrailCheckFunctions, y as GuardrailRule, z as HookContext, I as InMemoryStore, F as ModelAwareSdkAdapterFactory, J as ModelClass, K as ModelMappingConfig, N as ModelResolver, Q as ModelResolverOptions, U as ReceiveSpec, V as ResolvedModel, X as RetryDecision, Y as SdkAdapterFactory, Z as SplitPrompt, _ as TaskRunOptions, $ as WorkflowContractLike, a0 as WorkflowInvocation, a1 as WorkflowRunOptions, a2 as WorkflowStep, a3 as buildCandidateAgents, a4 as buildGateEvaluationPrompt, a5 as buildPerAgentGuardrails, a6 as buildRetryFollowUp, a7 as buildSplitTaskPrompt, a8 as buildTaskPrompt, a9 as createExecutionEnvelope, aa as createGuardrailHooks, ab as createGuardrailHooksForAgent, ac as createGuardrailHooksFromRules, ad as createLibraryToolRegistry, ae as createModelResolver, af as deriveToolchainsForAgents, ag as emitIterationClose, ah as emitIterationMetric, ai as emitIterationOpen, aj as emitSessionClose, ak as emitSessionOpen, al as emitSubagentClose, am as emitSubagentOpen, an as emitToolchainClose, ao as emitToolchainOpen, ap as extractStructuredResult, aq as getBlockingViolations, ar as getEffectiveGuardrailIds, as as getGuardrailRulesForAgent, at as getWarnings, au as guardrailContextToRuleData, av as hasBlockingViolation, aw as parseGateEvaluationResponse, ax as renderAgentSystemPrompt, ay as runTask, az as runWorkflow, aA as zodSchemaToPromptDescription, aB as zodSchemaToYamlExample } from './task-runner-DUyztyo3.js';
1
+ import { O as ObserverEmitFn, T as TaskContext, b as TaskOutcome, c as AgentContractLike, d as TaskContractLike, P as PromptBuilderOptions, W as WorkflowResult, S as SdkAdapter, e as WorkflowRegistries, H as HandoffInput, f as StepCompleteEvent, g as StepResult, D as DelegateStep, h as GuardrailRuleData, i as MemoryStore, M as MemoryRef, L as LibraryToolRegistry, G as GuardrailHooks, R as ResolvedComponent, j as ArtifactBindingConfig, k as RunToolchainChecksOptions, l as TaskRunResult, m as ResolvedToolchain, n as LibraryToolDefinition, o as HookResponse, p as GuardrailCheckResult } from './task-runner-DV49qwpk.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, x as GateStep, y as GuardrailCheckFunctions, z as GuardrailRule, F as HookContext, I as InMemoryStore, J as ModelAwareSdkAdapterFactory, K as ModelClass, N as ModelMappingConfig, Q as ModelResolver, U as ModelResolverOptions, V as ReceiveSpec, X as ResolvedModel, Y as RetryDecision, Z as SdkAdapterFactory, _ as SplitPrompt, $ as TaskRunOptions, a0 as ToolchainCheckResult, a1 as ToolchainManifest, a2 as ToolchainManifestSchema, a3 as WorkflowContractLike, a4 as WorkflowInvocation, a5 as WorkflowRunOptions, a6 as WorkflowStep, a7 as buildCandidateAgents, a8 as buildGateEvaluationPrompt, a9 as buildPerAgentGuardrails, aa as buildRetryFollowUp, ab as buildSplitTaskPrompt, ac as buildTaskPrompt, ad as createExecutionEnvelope, ae as createGuardrailHooks, af as createGuardrailHooksForAgent, ag as createGuardrailHooksFromRules, ah as createLibraryToolRegistry, ai as createModelResolver, aj as deriveToolchainsForAgents, ak as emitIterationClose, al as emitIterationMetric, am as emitIterationOpen, an as emitSessionClose, ao as emitSessionOpen, ap as emitSubagentClose, aq as emitSubagentOpen, ar as emitToolchainClose, as as emitToolchainOpen, at as extractStructuredResult, au as getBlockingViolations, av as getEffectiveGuardrailIds, aw as getGuardrailRulesForAgent, ax as getWarnings, ay as guardrailContextToRuleData, az as hasBlockingViolation, aA as parseGateEvaluationResponse, aB as renderAgentSystemPrompt, aC as runTask, aD as runToolchainChecks, aE as runWorkflow, aF as zodSchemaToPromptDescription, aG as zodSchemaToYamlExample } from './task-runner-DV49qwpk.js';
3
3
  import { z } from 'zod';
4
4
  import { OperationIR, ComponentIR } from '@aaac/contracts';
5
5
  import { ResolvedConfig } from './generator/index.js';
@@ -442,6 +442,22 @@ interface ExecuteOptions {
442
442
  artifactBinding?: ArtifactBindingConfig;
443
443
  /** Path substitutions for artifact binding. */
444
444
  paths?: Record<string, string>;
445
+ /**
446
+ * Observer emit function for agent-axis spans (agent.session / agent.subagent /
447
+ * toolchain.execution / evaluate.*). When undefined, all emission is a no-op.
448
+ * Auto-wired from project.yaml `bindings.observability` by createProjectRuntime —
449
+ * callers do NOT hand-write this.
450
+ */
451
+ observer?: ObserverEmitFn;
452
+ /**
453
+ * Optional toolchain-check observation config. When set together with `observer`,
454
+ * the workflow runner runs these checks once post-run and emits one
455
+ * toolchain.execution span per check (OBSERVATION ONLY — never changes the
456
+ * workflow outcome). Auto-wired from project.yaml `toolchains` + `bindings.observability`
457
+ * by createProjectRuntime; `observer`/`parentSpanId` are injected by runWorkflow.
458
+ * Only consumed by executeWorkflow (toolchain checks are a run-level concern).
459
+ */
460
+ toolchain?: RunToolchainChecksOptions;
445
461
  }
446
462
  interface TaskHookContext {
447
463
  adapter: SdkAdapter;
@@ -787,59 +803,6 @@ declare function parseRouterResponse(response: string, validNames: string[]): {
787
803
  */
788
804
  declare function executePrompt(message: string, ir: ComponentIR, binding: RuntimeBinding, ctx: AaacInvocationContext, opts: PromptExecuteOptions): Promise<PromptResult>;
789
805
 
790
- /**
791
- * Toolchain Checker — runs check commands defined in toolchain-contracts
792
- * and returns structured pass/fail results.
793
- *
794
- * Each toolchain may declare a `checks` map (checkType → shell command).
795
- * This module iterates all checks, executes them via subprocess, and
796
- * returns a ToolchainCheckResult[].
797
- *
798
- * For "drift" check types, a manifest-based fast path is available:
799
- * if a .toolchain-manifest.json exists and the toolchain_id matches,
800
- * the command execution can be skipped when the source hash is current.
801
- */
802
-
803
- declare const ToolchainManifestSchema: z.ZodObject<{
804
- schema: z.ZodString;
805
- toolchain_id: z.ZodString;
806
- generated_at: z.ZodString;
807
- source_hash: z.ZodString;
808
- output_hash: z.ZodString;
809
- source_globs: z.ZodOptional<z.ZodArray<z.ZodString>>;
810
- output_globs: z.ZodOptional<z.ZodArray<z.ZodString>>;
811
- files: z.ZodOptional<z.ZodArray<z.ZodObject<{
812
- path: z.ZodString;
813
- hash: z.ZodString;
814
- }, z.core.$strip>>>;
815
- }, z.core.$strip>;
816
- type ToolchainManifest = z.infer<typeof ToolchainManifestSchema>;
817
- interface ToolchainCheckResult {
818
- toolchainId: string;
819
- checkType: string;
820
- status: "pass" | "fail" | "skip" | "error";
821
- action: "block" | "warn" | "shadow";
822
- message?: string;
823
- durationMs?: number;
824
- }
825
- interface RunToolchainChecksOptions {
826
- /** Absolute path to toolchain-contracts YAML */
827
- toolchainsPath: string;
828
- /** Absolute path to artifact-contracts YAML (optional, for manifest fast path) */
829
- artifactsPath?: string;
830
- /** Working directory for subprocess execution */
831
- cwd?: string;
832
- /** Filter: only run these check types */
833
- checkTypes?: string[];
834
- /** Filter: only run checks for these toolchain IDs */
835
- toolchainFilter?: string[];
836
- /** Policy-resolved action per check type. Key = check type, value = action. Special key "_default" for fallback. */
837
- checkTypeActions?: Record<string, "block" | "warn" | "shadow">;
838
- /** Default action when no policy match */
839
- defaultAction?: "block" | "warn" | "shadow";
840
- }
841
- declare function runToolchainChecks(options: RunToolchainChecksOptions): Promise<ToolchainCheckResult[]>;
842
-
843
806
  /**
844
807
  * @aaac/runtime — public API
845
808
  *
@@ -848,4 +811,4 @@ declare function runToolchainChecks(options: RunToolchainChecksOptions): Promise
848
811
  /** Package version string. */
849
812
  declare const version: string;
850
813
 
851
- export { type AaacInvocationContext, type AaacObserver, type AaacPolicy, type AaacRuntime, AgentContractLike, AgentLogWriter, type AgentLogWriterOptions, type AgentPlugin, ArtifactBindingConfig, type ArtifactResolveOptions, type ArtifactResolveResult, type ComponentScope, type CreateAdapterOptions, type CreateComponentScopeOptions, type CreateProjectRuntimeOptions, DelegateStep, type DslContext, DslValidationError, type EvaluateGuardrailOptions, type EvaluateGuardrailResult, type ExecuteOptions, type ExecuteTaskOptions, type ExecuteWorkflowOptions, FileMemoryStore, type GuardStatusOptions, type GuardStatusResult, GuardrailCheckResult, GuardrailHooks, type GuardrailListEntry, type GuardrailResult, GuardrailRuleData, HandoffInput, HookResponse, LibraryToolDefinition, LibraryToolRegistry, type ListGuardrailsOptions, type ListGuardrailsResult, type LoadDslOptions, MemoryRef, MemoryStore, type MemoryStoreEntry, type NavigationContext, type NavigationContextOptions, ObserverEmitFn, type OperationHandler, type OperationMemoryRefConfig, type OperationToolDef, PROJECT_CONFIG_FILENAME, type PermissionMode, type PluginLoadResult, PluginRegistry, type ProcessEditOptions, type ProcessTaskOptions, type ProcessWorkflowOptions, type ProgressSink, type ProgressSinkOptions, type ProjectRuntime, type PromptBuilderArgs, PromptBuilderOptions, type PromptExecuteOptions, type PromptResult, type RequiredEntities, type ResolvedAdapterSelection, ResolvedComponent, ResolvedToolchain, type RunLogEvent, type RunToolchainChecksOptions, type Runtime, type RuntimeBinding, type RuntimeConfig, SdkAdapter, type SdkFunctionTool, StepCompleteEvent, StepResult, TaskContext, TaskContractLike, type TaskHookContext, TaskOutcome, TaskRunResult, type ToolchainCheckResult, type ToolchainManifest, ToolchainManifestSchema, WorkflowBuilder, type WorkflowHookContext, WorkflowRegistries, WorkflowResult, buildGuardrailRulesFromDsl, buildNavigationContext, buildRegistriesFromDsl, buildSdkFunctionTools, createAdapter, createComponentScope, createProgressSink, createProjectRuntime, createRuntime, createRuntimeBinding, emitProcessEdit, emitProcessTaskClose, emitProcessTaskOpen, emitProcessWorkflowClose, emitProcessWorkflowOpen, evaluateGuardrail, executePrompt, executeTask, executeWorkflow, findProjectConfig, guardStatus, jsonSchemaToZod, listGuardrails, loadDslContext, loadPlugins, loadPluginsFromDirectory, loadPluginsFromPaths, operationsToTools, parseRouterResponse, pluginRegistry, resolveArtifacts, runToolchainChecks, version };
814
+ export { type AaacInvocationContext, type AaacObserver, type AaacPolicy, type AaacRuntime, AgentContractLike, AgentLogWriter, type AgentLogWriterOptions, type AgentPlugin, ArtifactBindingConfig, type ArtifactResolveOptions, type ArtifactResolveResult, type ComponentScope, type CreateAdapterOptions, type CreateComponentScopeOptions, type CreateProjectRuntimeOptions, DelegateStep, type DslContext, DslValidationError, type EvaluateGuardrailOptions, type EvaluateGuardrailResult, type ExecuteOptions, type ExecuteTaskOptions, type ExecuteWorkflowOptions, FileMemoryStore, type GuardStatusOptions, type GuardStatusResult, GuardrailCheckResult, GuardrailHooks, type GuardrailListEntry, type GuardrailResult, GuardrailRuleData, HandoffInput, HookResponse, LibraryToolDefinition, LibraryToolRegistry, type ListGuardrailsOptions, type ListGuardrailsResult, type LoadDslOptions, MemoryRef, MemoryStore, type MemoryStoreEntry, type NavigationContext, type NavigationContextOptions, ObserverEmitFn, type OperationHandler, type OperationMemoryRefConfig, type OperationToolDef, PROJECT_CONFIG_FILENAME, type PermissionMode, type PluginLoadResult, PluginRegistry, type ProcessEditOptions, type ProcessTaskOptions, type ProcessWorkflowOptions, type ProgressSink, type ProgressSinkOptions, type ProjectRuntime, type PromptBuilderArgs, PromptBuilderOptions, type PromptExecuteOptions, type PromptResult, type RequiredEntities, type ResolvedAdapterSelection, ResolvedComponent, ResolvedToolchain, type RunLogEvent, RunToolchainChecksOptions, type Runtime, type RuntimeBinding, type RuntimeConfig, SdkAdapter, type SdkFunctionTool, StepCompleteEvent, StepResult, TaskContext, TaskContractLike, type TaskHookContext, TaskOutcome, TaskRunResult, WorkflowBuilder, type WorkflowHookContext, WorkflowRegistries, WorkflowResult, buildGuardrailRulesFromDsl, buildNavigationContext, buildRegistriesFromDsl, buildSdkFunctionTools, createAdapter, createComponentScope, createProgressSink, createProjectRuntime, createRuntime, createRuntimeBinding, emitProcessEdit, emitProcessTaskClose, emitProcessTaskOpen, emitProcessWorkflowClose, emitProcessWorkflowOpen, evaluateGuardrail, executePrompt, executeTask, executeWorkflow, findProjectConfig, guardStatus, jsonSchemaToZod, listGuardrails, loadDslContext, loadPlugins, loadPluginsFromDirectory, loadPluginsFromPaths, operationsToTools, parseRouterResponse, pluginRegistry, resolveArtifacts, version };