@aaac/runtime 0.1.14 → 0.1.16

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-BPk-PcZA.js';
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';
2
2
  import 'zod';
3
3
  import '../context-DKkamYX_.js';
4
4
  import '@aaac/observability';
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  getBlockingViolations
3
- } from "../chunk-MGRZBGQL.js";
3
+ } from "../chunk-GZCEEIXQ.js";
4
4
  import {
5
5
  buildAdkFunctionTools
6
6
  } from "../chunk-LONLL3K2.js";
@@ -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-BPk-PcZA.js';
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';
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-BPk-PcZA.js';
1
+ import { S as SdkAdapter, A as AdapterSendOptions, M as MemoryRef } from '../task-runner-DUyztyo3.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-BPk-PcZA.js';
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';
2
2
  import 'zod';
3
3
  import '../context-DKkamYX_.js';
4
4
  import '@aaac/observability';
@@ -240,17 +240,23 @@ function createGuardrailHooksForAgent(agentId, perAgent) {
240
240
  }
241
241
  };
242
242
  }
243
+ function compileGuardrailPattern(pattern) {
244
+ if (pattern.startsWith("(?i)")) {
245
+ return new RegExp(pattern.slice(4), "i");
246
+ }
247
+ return new RegExp(pattern);
248
+ }
243
249
  function createGuardrailHooksFromRules(rules) {
244
250
  const commandChecks = rules.commandRules.map((rule) => ({
245
251
  guardrail_id: rule.guardrail_id,
246
- pattern: new RegExp(rule.pattern),
252
+ pattern: compileGuardrailPattern(rule.pattern),
247
253
  action: rule.action,
248
254
  message: rule.message
249
255
  }));
250
256
  const fileChecks = rules.fileRules;
251
257
  const contentChecks = rules.contentRules.map((rule) => ({
252
258
  guardrail_id: rule.guardrail_id,
253
- pattern: new RegExp(rule.pattern),
259
+ pattern: compileGuardrailPattern(rule.pattern),
254
260
  action: rule.action,
255
261
  message: rule.message,
256
262
  file_glob: rule.file_glob,
@@ -318,4 +324,4 @@ export {
318
324
  createGuardrailHooksForAgent,
319
325
  createGuardrailHooksFromRules
320
326
  };
321
- //# sourceMappingURL=chunk-MGRZBGQL.js.map
327
+ //# sourceMappingURL=chunk-GZCEEIXQ.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/lib/plugin.ts","../src/lib/guardrail-hooks.ts"],"sourcesContent":["/**\n * Plugin Interface — extension points for user code injection\n */\n\nimport type { TaskContext, TaskOutcome, AgentContractLike, TaskContractLike, PromptBuilderOptions } from \"./task-runner.js\";\nimport type { WorkflowResult } from \"./workflow-runner.js\";\n\nexport interface GuardrailResult {\n matched: boolean;\n guardrail_id: string;\n severity: \"critical\" | \"mandatory\" | \"warning\" | \"info\";\n action: \"block\" | \"warn\" | \"shadow\" | \"info\";\n message: string;\n}\n\nexport interface PromptBuilderArgs {\n agent: AgentContractLike;\n task: TaskContractLike;\n context: TaskContext;\n options?: PromptBuilderOptions;\n}\n\nexport interface AgentPlugin {\n readonly id: string;\n beforeTask?(taskId: string, context: TaskContext): Promise<TaskContext | null>;\n afterTask?(taskId: string, outcome: TaskOutcome): Promise<TaskOutcome>;\n /**\n * Enrich the structured TaskContext before prompt generation.\n * Unlike beforeTask (which can skip a task by returning null),\n * this hook is purely for context augmentation.\n */\n contextEnhancer?(taskId: string, context: TaskContext): TaskContext;\n /**\n * Lightweight prompt post-processor. Applied after the prompt is built.\n * Use for appending instructions or modifying sections.\n */\n promptEnhancer?(taskId: string, prompt: string, context: TaskContext): string;\n /**\n * Full prompt builder override. If provided and returns a non-null string,\n * replaces the default buildTaskPrompt output entirely.\n * Receives the agent/task contracts and context so the plugin can build\n * a completely custom prompt.\n */\n promptBuilder?(args: PromptBuilderArgs): string | null;\n customGuardrails?: {\n evaluateCommand?(command: string): GuardrailResult[];\n evaluateFilePath?(filePath: string): GuardrailResult[];\n evaluateFileContent?(filePath: string, content: string): GuardrailResult[];\n };\n beforeWorkflow?(workflowId: string, userRequest: string): Promise<void>;\n afterWorkflow?(workflowId: string, result: WorkflowResult): Promise<void>;\n}\n\nexport class PluginRegistry {\n private plugins: AgentPlugin[] = [];\n\n register(plugin: AgentPlugin): void {\n if (this.plugins.some((p) => p.id === plugin.id)) {\n throw new Error(`Plugin \"${plugin.id}\" is already registered`);\n }\n this.plugins.push(plugin);\n }\n\n getAll(): readonly AgentPlugin[] {\n return this.plugins;\n }\n\n async runBeforeTask(taskId: string, context: TaskContext): Promise<TaskContext | null> {\n let ctx: TaskContext | null = context;\n for (const plugin of this.plugins) {\n if (!plugin.beforeTask || ctx === null) continue;\n ctx = await plugin.beforeTask(taskId, ctx);\n }\n return ctx;\n }\n\n async runAfterTask(taskId: string, outcome: TaskOutcome): Promise<TaskOutcome> {\n let result = outcome;\n for (const plugin of this.plugins) {\n if (!plugin.afterTask) continue;\n result = await plugin.afterTask(taskId, result);\n }\n return result;\n }\n\n applyContextEnhancers(taskId: string, context: TaskContext): TaskContext {\n let ctx = context;\n for (const plugin of this.plugins) {\n if (!plugin.contextEnhancer) continue;\n ctx = plugin.contextEnhancer(taskId, ctx);\n }\n return ctx;\n }\n\n /**\n * Try plugin promptBuilder hooks. Returns custom prompt if any plugin provides one,\n * or null to use the default buildTaskPrompt.\n */\n applyPromptBuilder(args: PromptBuilderArgs): string | null {\n for (const plugin of this.plugins) {\n if (!plugin.promptBuilder) continue;\n const result = plugin.promptBuilder(args);\n if (result !== null) return result;\n }\n return null;\n }\n\n applyPromptEnhancers(taskId: string, prompt: string, context: TaskContext): string {\n let enhanced = prompt;\n for (const plugin of this.plugins) {\n if (!plugin.promptEnhancer) continue;\n enhanced = plugin.promptEnhancer(taskId, enhanced, context);\n }\n return enhanced;\n }\n\n evaluateCommandGuardrails(command: string): GuardrailResult[] {\n const results: GuardrailResult[] = [];\n for (const plugin of this.plugins) {\n if (!plugin.customGuardrails?.evaluateCommand) continue;\n results.push(...plugin.customGuardrails.evaluateCommand(command));\n }\n return results;\n }\n\n evaluateFilePathGuardrails(filePath: string): GuardrailResult[] {\n const results: GuardrailResult[] = [];\n for (const plugin of this.plugins) {\n if (!plugin.customGuardrails?.evaluateFilePath) continue;\n results.push(...plugin.customGuardrails.evaluateFilePath(filePath));\n }\n return results;\n }\n\n evaluateFileContentGuardrails(filePath: string, content: string): GuardrailResult[] {\n const results: GuardrailResult[] = [];\n for (const plugin of this.plugins) {\n if (!plugin.customGuardrails?.evaluateFileContent) continue;\n results.push(...plugin.customGuardrails.evaluateFileContent(filePath, content));\n }\n return results;\n }\n\n async runBeforeWorkflow(workflowId: string, userRequest: string): Promise<void> {\n for (const plugin of this.plugins) {\n if (!plugin.beforeWorkflow) continue;\n await plugin.beforeWorkflow(workflowId, userRequest);\n }\n }\n\n async runAfterWorkflow(workflowId: string, result: WorkflowResult): Promise<void> {\n for (const plugin of this.plugins) {\n if (!plugin.afterWorkflow) continue;\n await plugin.afterWorkflow(workflowId, result);\n }\n }\n}\n\nexport const pluginRegistry = new PluginRegistry();\n","/**\n * SDK Guardrail Hook Bridge — generic adapter from guardrail check functions\n * + plugin guardrails to SDK-compatible hook responses.\n *\n * Embedded guardrail rules are converted via createGuardrailHooksFromRules(),\n * which delegates to createGuardrailHooks(). All hook logic lives here.\n */\n\nimport { pluginRegistry } from \"./plugin.js\";\n\nexport interface GuardrailCheckResult {\n guardrail_id: string;\n passed: boolean;\n action: \"block\" | \"warn\" | \"shadow\" | \"info\";\n message: string;\n}\n\nexport interface HookResponse {\n permission?: \"deny\";\n user_message?: string;\n agent_message?: string;\n additionalContext?: string;\n}\n\nexport interface GuardrailRule {\n guardrail_id: string;\n pattern: string;\n action: \"block\" | \"warn\" | \"shadow\" | \"info\";\n message: string;\n file_glob?: string;\n exclude_glob?: string;\n}\n\nexport interface GuardrailRuleData {\n commandRules: GuardrailRule[];\n fileRules: GuardrailRule[];\n contentRules: GuardrailRule[];\n}\n\nexport interface GuardrailCheckFunctions {\n checkCommand: (command: string) => GuardrailCheckResult[];\n checkFilePath: (filePath: string) => GuardrailCheckResult[];\n checkContent: (filePath: string, content: string) => GuardrailCheckResult[];\n}\n\nfunction globFragmentToRegex(fragment: string): string {\n let out = \"\";\n for (const ch of fragment) {\n if (ch === \"*\") out += \"[^/]*\";\n else if (ch === \"?\") out += \"[^/]\";\n else if (\".+^$|()[]\\\\\".includes(ch)) out += \"\\\\\" + ch;\n else out += ch;\n }\n return out;\n}\n\nexport function matchGlob(pattern: string, path: string): boolean {\n let regex = \"\";\n let i = 0;\n while (i < pattern.length) {\n if (pattern[i] === \"*\" && pattern[i + 1] === \"*\" && pattern[i + 2] === \"/\") {\n regex += \"(?:.+/)?\";\n i += 3;\n } else if (pattern[i] === \"*\" && pattern[i + 1] === \"*\") {\n regex += \".*\";\n i += 2;\n } else if (pattern[i] === \"*\") {\n regex += \"[^/]*\";\n i += 1;\n } else if (pattern[i] === \"?\") {\n regex += \"[^/]\";\n i += 1;\n } else if (pattern[i] === \"{\") {\n const end = pattern.indexOf(\"}\", i);\n if (end !== -1) {\n const alts = pattern.slice(i + 1, end).split(\",\").map(globFragmentToRegex);\n regex += \"(?:\" + alts.join(\"|\") + \")\";\n i = end + 1;\n } else {\n regex += \"\\\\{\";\n i += 1;\n }\n } else if (\".+^$|()[]\\\\\".includes(pattern[i])) {\n regex += \"\\\\\" + pattern[i];\n i += 1;\n } else {\n regex += pattern[i];\n i += 1;\n }\n }\n return new RegExp(\"^\" + regex + \"$\").test(path);\n}\n\nexport interface HookContext {\n /** Agent id for per-agent guardrail filtering. */\n agentId?: string;\n command?: string;\n filePath?: string;\n content?: string;\n}\n\nexport interface GuardrailHooks {\n beforeShellExecution: (input: { command?: string }) => HookResponse;\n preToolUse: (input: {\n tool_name?: string;\n tool_input?: { file_path?: string; path?: string };\n }) => HookResponse;\n afterFileEdit: (input: { file_path?: string; content?: string }) => HookResponse;\n runChecks: (ctx: HookContext) => GuardrailCheckResult[];\n}\n\nexport function getBlockingViolations(results: GuardrailCheckResult[]): GuardrailCheckResult[] {\n return results.filter((r) => !r.passed && r.action === \"block\");\n}\n\nexport function getWarnings(results: GuardrailCheckResult[]): GuardrailCheckResult[] {\n return results.filter((r) => !r.passed && r.action === \"warn\");\n}\n\nexport function hasBlockingViolation(results: GuardrailCheckResult[]): boolean {\n return results.some((r) => !r.passed && r.action === \"block\");\n}\n\nfunction pluginResultToCheckResult(r: {\n matched: boolean;\n guardrail_id: string;\n action: string;\n message: string;\n}): GuardrailCheckResult {\n return {\n guardrail_id: r.guardrail_id,\n passed: !r.matched,\n action: r.action as GuardrailCheckResult[\"action\"],\n message: r.matched ? r.message : \"\",\n };\n}\n\n/**\n * Create SDK hook functions from generated guardrail check functions.\n *\n * Merges DSL-generated checks with plugin-registered guardrails and\n * returns hook functions in the format expected by the Claude SDK,\n * plus a generic runChecks() for programmatic use.\n */\nexport function createGuardrailHooks(checks: GuardrailCheckFunctions): GuardrailHooks {\n function runChecks(ctx: HookContext): GuardrailCheckResult[] {\n const results: GuardrailCheckResult[] = [];\n\n if (ctx.command) {\n results.push(...checks.checkCommand(ctx.command));\n results.push(\n ...pluginRegistry.evaluateCommandGuardrails(ctx.command).map(pluginResultToCheckResult),\n );\n }\n\n if (ctx.filePath) {\n results.push(...checks.checkFilePath(ctx.filePath));\n results.push(\n ...pluginRegistry.evaluateFilePathGuardrails(ctx.filePath).map(pluginResultToCheckResult),\n );\n }\n\n if (ctx.filePath && ctx.content) {\n results.push(...checks.checkContent(ctx.filePath, ctx.content));\n results.push(\n ...pluginRegistry\n .evaluateFileContentGuardrails(ctx.filePath, ctx.content)\n .map(pluginResultToCheckResult),\n );\n }\n\n return results;\n }\n\n function beforeShellExecution(input: { command?: string }): HookResponse {\n const command = input.command ?? \"\";\n if (!command) return {};\n\n const results = runChecks({ command });\n const blocks = getBlockingViolations(results);\n const warns = getWarnings(results);\n\n if (blocks.length > 0) {\n const msg = blocks.map((r) => `[${r.guardrail_id}] ${r.message}`).join(\"\\n\");\n return { permission: \"deny\", user_message: msg, agent_message: msg };\n }\n\n if (warns.length > 0) {\n return {\n additionalContext: warns.map((r) => `[${r.guardrail_id}] ${r.message}`).join(\"\\n\"),\n };\n }\n\n return {};\n }\n\n function preToolUse(input: {\n tool_name?: string;\n tool_input?: { file_path?: string; path?: string };\n }): HookResponse {\n const filePath = input.tool_input?.file_path ?? input.tool_input?.path ?? \"\";\n if (!filePath) return {};\n\n const results = runChecks({ filePath });\n const blocks = getBlockingViolations(results);\n\n if (blocks.length > 0) {\n const msg = blocks.map((r) => `[${r.guardrail_id}] ${r.message}`).join(\"\\n\");\n return { permission: \"deny\", user_message: msg, agent_message: msg };\n }\n\n return {};\n }\n\n function afterFileEdit(input: { file_path?: string; content?: string }): HookResponse {\n const filePath = input.file_path ?? \"\";\n const content = input.content ?? \"\";\n if (!filePath) return {};\n\n const results = runChecks({ filePath, content });\n const blocks = getBlockingViolations(results);\n\n if (blocks.length > 0) {\n const msg = blocks.map((r) => `[${r.guardrail_id}] ${r.message}`).join(\"\\n\");\n return { permission: \"deny\", user_message: msg, agent_message: msg };\n }\n\n return {};\n }\n\n return { beforeShellExecution, preToolUse, afterFileEdit, runChecks };\n}\n\n/**\n * Create SDK hook functions from embedded guardrail rule data.\n */\n/**\n * Create SDK hooks scoped to a single agent from a per-agent guardrail map.\n * Returns empty-passing hooks when the agent has no rules in the map.\n */\nexport function createGuardrailHooksForAgent(\n agentId: string,\n perAgent: Map<string, GuardrailRuleData>,\n): GuardrailHooks {\n const rules = perAgent.get(agentId);\n if (!rules) {\n return createGuardrailHooks({\n checkCommand: () => [],\n checkFilePath: () => [],\n checkContent: () => [],\n });\n }\n const hooks = createGuardrailHooksFromRules(rules);\n const baseRunChecks = hooks.runChecks;\n return {\n ...hooks,\n runChecks(ctx: HookContext) {\n return baseRunChecks({ ...ctx, agentId });\n },\n };\n}\n\nexport function createGuardrailHooksFromRules(rules: GuardrailRuleData): GuardrailHooks {\n const commandChecks = rules.commandRules.map((rule) => ({\n guardrail_id: rule.guardrail_id,\n pattern: new RegExp(rule.pattern),\n action: rule.action,\n message: rule.message,\n }));\n\n const fileChecks = rules.fileRules;\n\n const contentChecks = rules.contentRules.map((rule) => ({\n guardrail_id: rule.guardrail_id,\n pattern: new RegExp(rule.pattern),\n action: rule.action,\n message: rule.message,\n file_glob: rule.file_glob,\n exclude_glob: rule.exclude_glob,\n }));\n\n return createGuardrailHooks({\n checkCommand(command: string): GuardrailCheckResult[] {\n const results: GuardrailCheckResult[] = [];\n for (const check of commandChecks) {\n const passed = !check.pattern.test(command);\n results.push({\n guardrail_id: check.guardrail_id,\n passed,\n action: check.action,\n message: passed ? \"\" : check.message,\n });\n }\n return results;\n },\n\n checkFilePath(filePath: string): GuardrailCheckResult[] {\n const results: GuardrailCheckResult[] = [];\n for (const check of fileChecks) {\n if (check.exclude_glob && matchGlob(check.exclude_glob, filePath)) {\n continue;\n }\n const matched = matchGlob(check.pattern, filePath);\n results.push({\n guardrail_id: check.guardrail_id,\n passed: !matched,\n action: check.action,\n message: matched ? check.message : \"\",\n });\n }\n return results;\n },\n\n checkContent(filePath: string, content: string): GuardrailCheckResult[] {\n const results: GuardrailCheckResult[] = [];\n for (const check of contentChecks) {\n if (check.file_glob && !matchGlob(check.file_glob, filePath)) {\n continue;\n }\n if (check.exclude_glob && matchGlob(check.exclude_glob, filePath)) {\n continue;\n }\n const matched = check.pattern.test(content);\n results.push({\n guardrail_id: check.guardrail_id,\n passed: !matched,\n action: check.action,\n message: matched ? check.message : \"\",\n });\n }\n return results;\n },\n });\n}\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../src/lib/plugin.ts","../src/lib/guardrail-hooks.ts"],"sourcesContent":["/**\n * Plugin Interface — extension points for user code injection\n */\n\nimport type { TaskContext, TaskOutcome, AgentContractLike, TaskContractLike, PromptBuilderOptions } from \"./task-runner.js\";\nimport type { WorkflowResult } from \"./workflow-runner.js\";\n\nexport interface GuardrailResult {\n matched: boolean;\n guardrail_id: string;\n severity: \"critical\" | \"mandatory\" | \"warning\" | \"info\";\n action: \"block\" | \"warn\" | \"shadow\" | \"info\";\n message: string;\n}\n\nexport interface PromptBuilderArgs {\n agent: AgentContractLike;\n task: TaskContractLike;\n context: TaskContext;\n options?: PromptBuilderOptions;\n}\n\nexport interface AgentPlugin {\n readonly id: string;\n beforeTask?(taskId: string, context: TaskContext): Promise<TaskContext | null>;\n afterTask?(taskId: string, outcome: TaskOutcome): Promise<TaskOutcome>;\n /**\n * Enrich the structured TaskContext before prompt generation.\n * Unlike beforeTask (which can skip a task by returning null),\n * this hook is purely for context augmentation.\n */\n contextEnhancer?(taskId: string, context: TaskContext): TaskContext;\n /**\n * Lightweight prompt post-processor. Applied after the prompt is built.\n * Use for appending instructions or modifying sections.\n */\n promptEnhancer?(taskId: string, prompt: string, context: TaskContext): string;\n /**\n * Full prompt builder override. If provided and returns a non-null string,\n * replaces the default buildTaskPrompt output entirely.\n * Receives the agent/task contracts and context so the plugin can build\n * a completely custom prompt.\n */\n promptBuilder?(args: PromptBuilderArgs): string | null;\n customGuardrails?: {\n evaluateCommand?(command: string): GuardrailResult[];\n evaluateFilePath?(filePath: string): GuardrailResult[];\n evaluateFileContent?(filePath: string, content: string): GuardrailResult[];\n };\n beforeWorkflow?(workflowId: string, userRequest: string): Promise<void>;\n afterWorkflow?(workflowId: string, result: WorkflowResult): Promise<void>;\n}\n\nexport class PluginRegistry {\n private plugins: AgentPlugin[] = [];\n\n register(plugin: AgentPlugin): void {\n if (this.plugins.some((p) => p.id === plugin.id)) {\n throw new Error(`Plugin \"${plugin.id}\" is already registered`);\n }\n this.plugins.push(plugin);\n }\n\n getAll(): readonly AgentPlugin[] {\n return this.plugins;\n }\n\n async runBeforeTask(taskId: string, context: TaskContext): Promise<TaskContext | null> {\n let ctx: TaskContext | null = context;\n for (const plugin of this.plugins) {\n if (!plugin.beforeTask || ctx === null) continue;\n ctx = await plugin.beforeTask(taskId, ctx);\n }\n return ctx;\n }\n\n async runAfterTask(taskId: string, outcome: TaskOutcome): Promise<TaskOutcome> {\n let result = outcome;\n for (const plugin of this.plugins) {\n if (!plugin.afterTask) continue;\n result = await plugin.afterTask(taskId, result);\n }\n return result;\n }\n\n applyContextEnhancers(taskId: string, context: TaskContext): TaskContext {\n let ctx = context;\n for (const plugin of this.plugins) {\n if (!plugin.contextEnhancer) continue;\n ctx = plugin.contextEnhancer(taskId, ctx);\n }\n return ctx;\n }\n\n /**\n * Try plugin promptBuilder hooks. Returns custom prompt if any plugin provides one,\n * or null to use the default buildTaskPrompt.\n */\n applyPromptBuilder(args: PromptBuilderArgs): string | null {\n for (const plugin of this.plugins) {\n if (!plugin.promptBuilder) continue;\n const result = plugin.promptBuilder(args);\n if (result !== null) return result;\n }\n return null;\n }\n\n applyPromptEnhancers(taskId: string, prompt: string, context: TaskContext): string {\n let enhanced = prompt;\n for (const plugin of this.plugins) {\n if (!plugin.promptEnhancer) continue;\n enhanced = plugin.promptEnhancer(taskId, enhanced, context);\n }\n return enhanced;\n }\n\n evaluateCommandGuardrails(command: string): GuardrailResult[] {\n const results: GuardrailResult[] = [];\n for (const plugin of this.plugins) {\n if (!plugin.customGuardrails?.evaluateCommand) continue;\n results.push(...plugin.customGuardrails.evaluateCommand(command));\n }\n return results;\n }\n\n evaluateFilePathGuardrails(filePath: string): GuardrailResult[] {\n const results: GuardrailResult[] = [];\n for (const plugin of this.plugins) {\n if (!plugin.customGuardrails?.evaluateFilePath) continue;\n results.push(...plugin.customGuardrails.evaluateFilePath(filePath));\n }\n return results;\n }\n\n evaluateFileContentGuardrails(filePath: string, content: string): GuardrailResult[] {\n const results: GuardrailResult[] = [];\n for (const plugin of this.plugins) {\n if (!plugin.customGuardrails?.evaluateFileContent) continue;\n results.push(...plugin.customGuardrails.evaluateFileContent(filePath, content));\n }\n return results;\n }\n\n async runBeforeWorkflow(workflowId: string, userRequest: string): Promise<void> {\n for (const plugin of this.plugins) {\n if (!plugin.beforeWorkflow) continue;\n await plugin.beforeWorkflow(workflowId, userRequest);\n }\n }\n\n async runAfterWorkflow(workflowId: string, result: WorkflowResult): Promise<void> {\n for (const plugin of this.plugins) {\n if (!plugin.afterWorkflow) continue;\n await plugin.afterWorkflow(workflowId, result);\n }\n }\n}\n\nexport const pluginRegistry = new PluginRegistry();\n","/**\n * SDK Guardrail Hook Bridge — generic adapter from guardrail check functions\n * + plugin guardrails to SDK-compatible hook responses.\n *\n * Embedded guardrail rules are converted via createGuardrailHooksFromRules(),\n * which delegates to createGuardrailHooks(). All hook logic lives here.\n */\n\nimport { pluginRegistry } from \"./plugin.js\";\n\nexport interface GuardrailCheckResult {\n guardrail_id: string;\n passed: boolean;\n action: \"block\" | \"warn\" | \"shadow\" | \"info\";\n message: string;\n}\n\nexport interface HookResponse {\n permission?: \"deny\";\n user_message?: string;\n agent_message?: string;\n additionalContext?: string;\n}\n\nexport interface GuardrailRule {\n guardrail_id: string;\n pattern: string;\n action: \"block\" | \"warn\" | \"shadow\" | \"info\";\n message: string;\n file_glob?: string;\n exclude_glob?: string;\n}\n\nexport interface GuardrailRuleData {\n commandRules: GuardrailRule[];\n fileRules: GuardrailRule[];\n contentRules: GuardrailRule[];\n}\n\nexport interface GuardrailCheckFunctions {\n checkCommand: (command: string) => GuardrailCheckResult[];\n checkFilePath: (filePath: string) => GuardrailCheckResult[];\n checkContent: (filePath: string, content: string) => GuardrailCheckResult[];\n}\n\nfunction globFragmentToRegex(fragment: string): string {\n let out = \"\";\n for (const ch of fragment) {\n if (ch === \"*\") out += \"[^/]*\";\n else if (ch === \"?\") out += \"[^/]\";\n else if (\".+^$|()[]\\\\\".includes(ch)) out += \"\\\\\" + ch;\n else out += ch;\n }\n return out;\n}\n\nexport function matchGlob(pattern: string, path: string): boolean {\n let regex = \"\";\n let i = 0;\n while (i < pattern.length) {\n if (pattern[i] === \"*\" && pattern[i + 1] === \"*\" && pattern[i + 2] === \"/\") {\n regex += \"(?:.+/)?\";\n i += 3;\n } else if (pattern[i] === \"*\" && pattern[i + 1] === \"*\") {\n regex += \".*\";\n i += 2;\n } else if (pattern[i] === \"*\") {\n regex += \"[^/]*\";\n i += 1;\n } else if (pattern[i] === \"?\") {\n regex += \"[^/]\";\n i += 1;\n } else if (pattern[i] === \"{\") {\n const end = pattern.indexOf(\"}\", i);\n if (end !== -1) {\n const alts = pattern.slice(i + 1, end).split(\",\").map(globFragmentToRegex);\n regex += \"(?:\" + alts.join(\"|\") + \")\";\n i = end + 1;\n } else {\n regex += \"\\\\{\";\n i += 1;\n }\n } else if (\".+^$|()[]\\\\\".includes(pattern[i])) {\n regex += \"\\\\\" + pattern[i];\n i += 1;\n } else {\n regex += pattern[i];\n i += 1;\n }\n }\n return new RegExp(\"^\" + regex + \"$\").test(path);\n}\n\nexport interface HookContext {\n /** Agent id for per-agent guardrail filtering. */\n agentId?: string;\n command?: string;\n filePath?: string;\n content?: string;\n}\n\nexport interface GuardrailHooks {\n beforeShellExecution: (input: { command?: string }) => HookResponse;\n preToolUse: (input: {\n tool_name?: string;\n tool_input?: { file_path?: string; path?: string };\n }) => HookResponse;\n afterFileEdit: (input: { file_path?: string; content?: string }) => HookResponse;\n runChecks: (ctx: HookContext) => GuardrailCheckResult[];\n}\n\nexport function getBlockingViolations(results: GuardrailCheckResult[]): GuardrailCheckResult[] {\n return results.filter((r) => !r.passed && r.action === \"block\");\n}\n\nexport function getWarnings(results: GuardrailCheckResult[]): GuardrailCheckResult[] {\n return results.filter((r) => !r.passed && r.action === \"warn\");\n}\n\nexport function hasBlockingViolation(results: GuardrailCheckResult[]): boolean {\n return results.some((r) => !r.passed && r.action === \"block\");\n}\n\nfunction pluginResultToCheckResult(r: {\n matched: boolean;\n guardrail_id: string;\n action: string;\n message: string;\n}): GuardrailCheckResult {\n return {\n guardrail_id: r.guardrail_id,\n passed: !r.matched,\n action: r.action as GuardrailCheckResult[\"action\"],\n message: r.matched ? r.message : \"\",\n };\n}\n\n/**\n * Create SDK hook functions from generated guardrail check functions.\n *\n * Merges DSL-generated checks with plugin-registered guardrails and\n * returns hook functions in the format expected by the Claude SDK,\n * plus a generic runChecks() for programmatic use.\n */\nexport function createGuardrailHooks(checks: GuardrailCheckFunctions): GuardrailHooks {\n function runChecks(ctx: HookContext): GuardrailCheckResult[] {\n const results: GuardrailCheckResult[] = [];\n\n if (ctx.command) {\n results.push(...checks.checkCommand(ctx.command));\n results.push(\n ...pluginRegistry.evaluateCommandGuardrails(ctx.command).map(pluginResultToCheckResult),\n );\n }\n\n if (ctx.filePath) {\n results.push(...checks.checkFilePath(ctx.filePath));\n results.push(\n ...pluginRegistry.evaluateFilePathGuardrails(ctx.filePath).map(pluginResultToCheckResult),\n );\n }\n\n if (ctx.filePath && ctx.content) {\n results.push(...checks.checkContent(ctx.filePath, ctx.content));\n results.push(\n ...pluginRegistry\n .evaluateFileContentGuardrails(ctx.filePath, ctx.content)\n .map(pluginResultToCheckResult),\n );\n }\n\n return results;\n }\n\n function beforeShellExecution(input: { command?: string }): HookResponse {\n const command = input.command ?? \"\";\n if (!command) return {};\n\n const results = runChecks({ command });\n const blocks = getBlockingViolations(results);\n const warns = getWarnings(results);\n\n if (blocks.length > 0) {\n const msg = blocks.map((r) => `[${r.guardrail_id}] ${r.message}`).join(\"\\n\");\n return { permission: \"deny\", user_message: msg, agent_message: msg };\n }\n\n if (warns.length > 0) {\n return {\n additionalContext: warns.map((r) => `[${r.guardrail_id}] ${r.message}`).join(\"\\n\"),\n };\n }\n\n return {};\n }\n\n function preToolUse(input: {\n tool_name?: string;\n tool_input?: { file_path?: string; path?: string };\n }): HookResponse {\n const filePath = input.tool_input?.file_path ?? input.tool_input?.path ?? \"\";\n if (!filePath) return {};\n\n const results = runChecks({ filePath });\n const blocks = getBlockingViolations(results);\n\n if (blocks.length > 0) {\n const msg = blocks.map((r) => `[${r.guardrail_id}] ${r.message}`).join(\"\\n\");\n return { permission: \"deny\", user_message: msg, agent_message: msg };\n }\n\n return {};\n }\n\n function afterFileEdit(input: { file_path?: string; content?: string }): HookResponse {\n const filePath = input.file_path ?? \"\";\n const content = input.content ?? \"\";\n if (!filePath) return {};\n\n const results = runChecks({ filePath, content });\n const blocks = getBlockingViolations(results);\n\n if (blocks.length > 0) {\n const msg = blocks.map((r) => `[${r.guardrail_id}] ${r.message}`).join(\"\\n\");\n return { permission: \"deny\", user_message: msg, agent_message: msg };\n }\n\n return {};\n }\n\n return { beforeShellExecution, preToolUse, afterFileEdit, runChecks };\n}\n\n/**\n * Create SDK hook functions from embedded guardrail rule data.\n */\n/**\n * Create SDK hooks scoped to a single agent from a per-agent guardrail map.\n * Returns empty-passing hooks when the agent has no rules in the map.\n */\nexport function createGuardrailHooksForAgent(\n agentId: string,\n perAgent: Map<string, GuardrailRuleData>,\n): GuardrailHooks {\n const rules = perAgent.get(agentId);\n if (!rules) {\n return createGuardrailHooks({\n checkCommand: () => [],\n checkFilePath: () => [],\n checkContent: () => [],\n });\n }\n const hooks = createGuardrailHooksFromRules(rules);\n const baseRunChecks = hooks.runChecks;\n return {\n ...hooks,\n runChecks(ctx: HookContext) {\n return baseRunChecks({ ...ctx, agentId });\n },\n };\n}\n\n/** Compile a guardrail regex pattern, supporting inline `(?i)` case-insensitivity prefix. */\nexport function compileGuardrailPattern(pattern: string): RegExp {\n if (pattern.startsWith(\"(?i)\")) {\n return new RegExp(pattern.slice(4), \"i\");\n }\n return new RegExp(pattern);\n}\n\nexport function createGuardrailHooksFromRules(rules: GuardrailRuleData): GuardrailHooks {\n const commandChecks = rules.commandRules.map((rule) => ({\n guardrail_id: rule.guardrail_id,\n pattern: compileGuardrailPattern(rule.pattern),\n action: rule.action,\n message: rule.message,\n }));\n\n const fileChecks = rules.fileRules;\n\n const contentChecks = rules.contentRules.map((rule) => ({\n guardrail_id: rule.guardrail_id,\n pattern: compileGuardrailPattern(rule.pattern),\n action: rule.action,\n message: rule.message,\n file_glob: rule.file_glob,\n exclude_glob: rule.exclude_glob,\n }));\n\n return createGuardrailHooks({\n checkCommand(command: string): GuardrailCheckResult[] {\n const results: GuardrailCheckResult[] = [];\n for (const check of commandChecks) {\n const passed = !check.pattern.test(command);\n results.push({\n guardrail_id: check.guardrail_id,\n passed,\n action: check.action,\n message: passed ? \"\" : check.message,\n });\n }\n return results;\n },\n\n checkFilePath(filePath: string): GuardrailCheckResult[] {\n const results: GuardrailCheckResult[] = [];\n for (const check of fileChecks) {\n if (check.exclude_glob && matchGlob(check.exclude_glob, filePath)) {\n continue;\n }\n const matched = matchGlob(check.pattern, filePath);\n results.push({\n guardrail_id: check.guardrail_id,\n passed: !matched,\n action: check.action,\n message: matched ? check.message : \"\",\n });\n }\n return results;\n },\n\n checkContent(filePath: string, content: string): GuardrailCheckResult[] {\n const results: GuardrailCheckResult[] = [];\n for (const check of contentChecks) {\n if (check.file_glob && !matchGlob(check.file_glob, filePath)) {\n continue;\n }\n if (check.exclude_glob && matchGlob(check.exclude_glob, filePath)) {\n continue;\n }\n const matched = check.pattern.test(content);\n results.push({\n guardrail_id: check.guardrail_id,\n passed: !matched,\n action: check.action,\n message: matched ? check.message : \"\",\n });\n }\n return results;\n },\n });\n}\n"],"mappings":"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","names":[]}
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-BPk-PcZA.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 emitSessionClose, ah as emitSessionOpen, ai as emitSubagentClose, aj as emitSubagentOpen, ak as emitToolchainClose, al as emitToolchainOpen, am as extractStructuredResult, an as getBlockingViolations, ao as getEffectiveGuardrailIds, ap as getGuardrailRulesForAgent, aq as getWarnings, ar as guardrailContextToRuleData, as as hasBlockingViolation, at as parseGateEvaluationResponse, au as renderAgentSystemPrompt, av as runTask, aw as runWorkflow, ax as zodSchemaToPromptDescription, ay as zodSchemaToYamlExample } from './task-runner-BPk-PcZA.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 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';
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
@@ -7,7 +7,7 @@ import {
7
7
  getWarnings,
8
8
  hasBlockingViolation,
9
9
  pluginRegistry
10
- } from "./chunk-MGRZBGQL.js";
10
+ } from "./chunk-GZCEEIXQ.js";
11
11
  import {
12
12
  buildSdkFunctionTools
13
13
  } from "./chunk-LONLL3K2.js";
@@ -214,6 +214,59 @@ function emitSubagentClose(observer, spanId, envelope, durationMs, status, agent
214
214
  }
215
215
  });
216
216
  }
217
+ function emitIterationOpen(observer, parentSpanId, evaluateTaskId, loopTo, iterationNumber, maxIterations) {
218
+ if (!observer) return void 0;
219
+ const spanId = generateId();
220
+ observer({
221
+ source: "aaac-runtime",
222
+ eventType: "evaluate.iteration",
223
+ lifecycle: "open",
224
+ spanId,
225
+ parentSpanId,
226
+ attributes: attrs({
227
+ axis: "agent",
228
+ "evaluate.task": evaluateTaskId,
229
+ "evaluate.loop_to": loopTo,
230
+ "evaluate.iteration": iterationNumber,
231
+ "evaluate.max_iterations": maxIterations
232
+ })
233
+ });
234
+ return spanId;
235
+ }
236
+ function emitIterationClose(observer, spanId, evaluateTaskId, iterationNumber, verdict, durationMs, feedbackInjected) {
237
+ if (!observer) return;
238
+ observer({
239
+ source: "aaac-runtime",
240
+ eventType: "evaluate.iteration",
241
+ lifecycle: "close",
242
+ spanId,
243
+ attributes: attrs({
244
+ axis: "agent",
245
+ "evaluate.task": evaluateTaskId,
246
+ "evaluate.iteration": iterationNumber,
247
+ "evaluate.verdict": verdict,
248
+ "evaluate.duration_ms": durationMs,
249
+ "evaluate.feedback_injected": feedbackInjected
250
+ })
251
+ });
252
+ }
253
+ function emitIterationMetric(observer, parentSpanId, evaluateTaskId, totalIterations, terminalOutcome) {
254
+ if (!observer) return;
255
+ const spanId = generateId();
256
+ observer({
257
+ source: "aaac-runtime",
258
+ eventType: "evaluate.metric",
259
+ lifecycle: "instant",
260
+ spanId,
261
+ parentSpanId,
262
+ attributes: attrs({
263
+ axis: "agent",
264
+ "evaluate.task": evaluateTaskId,
265
+ "evaluate.total_iterations": totalIterations,
266
+ "evaluate.terminal_outcome": terminalOutcome
267
+ })
268
+ });
269
+ }
217
270
  function emitToolchainOpen(observer, parentSpanId, toolchainId, operation, artifactIds, componentId) {
218
271
  if (!observer) return void 0;
219
272
  const spanId = generateId();
@@ -975,6 +1028,7 @@ async function runWorkflow(adapterOrFactory, workflowIdOrInvocation, optionsOrRe
975
1028
  const stepOutputs = new Array(workflow.steps.length).fill(void 0);
976
1029
  let abortResult;
977
1030
  const evaluateExecCount = /* @__PURE__ */ new Map();
1031
+ const iterationSpanIds = /* @__PURE__ */ new Map();
978
1032
  const loopInjectedVars = {};
979
1033
  function extractPath(obj, path) {
980
1034
  const cleanPath = path.startsWith("$.") ? path.slice(2) : path;
@@ -1016,6 +1070,18 @@ async function runWorkflow(adapterOrFactory, workflowIdOrInvocation, optionsOrRe
1016
1070
  }
1017
1071
  if (step.type === "evaluate") {
1018
1072
  const evaluateStep = step;
1073
+ const iterationNumber = (evaluateExecCount.get(i) ?? 0) + 1;
1074
+ const iterationSpanId = emitIterationOpen(
1075
+ options.observer,
1076
+ sessionSpanId,
1077
+ evaluateStep.task,
1078
+ evaluateStep.loop_to,
1079
+ iterationNumber,
1080
+ evaluateStep.max_iterations
1081
+ );
1082
+ if (iterationSpanId) {
1083
+ iterationSpanIds.set(i, iterationSpanId);
1084
+ }
1019
1085
  const effectiveVariables = mergeVariables(options.variables, loopInjectedVars);
1020
1086
  const context2 = {
1021
1087
  user_request: evaluateStep.description ?? options.user_request,
@@ -1031,7 +1097,7 @@ async function runWorkflow(adapterOrFactory, workflowIdOrInvocation, optionsOrRe
1031
1097
  handoffSchemas: registries?.handoffSchemas,
1032
1098
  progressOutput: options.progressOutput,
1033
1099
  observer: options.observer,
1034
- parentSpanId: sessionSpanId
1100
+ parentSpanId: iterationSpanId ?? sessionSpanId
1035
1101
  });
1036
1102
  return {
1037
1103
  step_index: i,
@@ -1147,7 +1213,29 @@ async function runWorkflow(adapterOrFactory, workflowIdOrInvocation, optionsOrRe
1147
1213
  const data = result.outcome.status === "success" ? result.outcome.data : void 0;
1148
1214
  const verdict = typeof data?.verdict === "string" ? data.verdict : "fail";
1149
1215
  const execCount = (evaluateExecCount.get(i) ?? 0) + 1;
1216
+ const currentIterationSpanId = iterationSpanIds.get(i);
1217
+ if (currentIterationSpanId) {
1218
+ const willLoopBack = verdict !== "pass" && execCount < evaluateStep.max_iterations;
1219
+ const feedbackInjected = willLoopBack && !!evaluateStep.inject_as;
1220
+ emitIterationClose(
1221
+ options.observer,
1222
+ currentIterationSpanId,
1223
+ evaluateStep.task,
1224
+ execCount,
1225
+ verdict,
1226
+ result.elapsed_ms,
1227
+ feedbackInjected
1228
+ );
1229
+ iterationSpanIds.delete(i);
1230
+ }
1150
1231
  if (verdict === "pass") {
1232
+ emitIterationMetric(
1233
+ options.observer,
1234
+ sessionSpanId,
1235
+ evaluateStep.task,
1236
+ execCount,
1237
+ "pass"
1238
+ );
1151
1239
  stepResults[i] = result;
1152
1240
  completed.add(i);
1153
1241
  emitStepEvent(options, workflow.id, i, step, result);
@@ -1186,7 +1274,15 @@ ${JSON.stringify(data, null, 2)}`;
1186
1274
  evaluateExecCount.set(i, execCount);
1187
1275
  stepResults[i] = result;
1188
1276
  completed.add(i);
1189
- switch (evaluateStep.on_exhausted ?? "escalate") {
1277
+ const exhaustedPolicy = evaluateStep.on_exhausted ?? "escalate";
1278
+ emitIterationMetric(
1279
+ options.observer,
1280
+ sessionSpanId,
1281
+ evaluateStep.task,
1282
+ execCount,
1283
+ `exhausted-${exhaustedPolicy}`
1284
+ );
1285
+ switch (exhaustedPolicy) {
1190
1286
  case "abort":
1191
1287
  abortResult = {
1192
1288
  workflow_id: workflow.id,
@@ -3094,6 +3190,9 @@ export {
3094
3190
  createRuntime,
3095
3191
  createRuntimeBinding,
3096
3192
  deriveToolchainsForAgents,
3193
+ emitIterationClose,
3194
+ emitIterationMetric,
3195
+ emitIterationOpen,
3097
3196
  emitProcessEdit,
3098
3197
  emitProcessTaskClose,
3099
3198
  emitProcessTaskOpen,