@uns-kit/assistant-workflow 3.0.1 → 3.0.3

package/dist/execution-budget.js

@@ -0,0 +1,65 @@
+export const ASSISTANT_WORKFLOW_EXECUTION_BUDGET_LIMITS = Object.freeze({
+    maxPlanningSteps: 32,
+    maxToolCalls: 16,
+    maxProviderCalls: 8,
+    maxDurationMs: 300_000,
+    maxEvidenceBytes: 1_000_000,
+});
+export function assertAssistantWorkflowExecutionBudget(budget) {
+    assertBudgetValue("maxPlanningSteps", budget.maxPlanningSteps, 1, ASSISTANT_WORKFLOW_EXECUTION_BUDGET_LIMITS.maxPlanningSteps);
+    assertBudgetValue("maxToolCalls", budget.maxToolCalls, 0, ASSISTANT_WORKFLOW_EXECUTION_BUDGET_LIMITS.maxToolCalls);
+    assertBudgetValue("maxProviderCalls", budget.maxProviderCalls, 0, ASSISTANT_WORKFLOW_EXECUTION_BUDGET_LIMITS.maxProviderCalls);
+    assertBudgetValue("maxDurationMs", budget.maxDurationMs, 1, ASSISTANT_WORKFLOW_EXECUTION_BUDGET_LIMITS.maxDurationMs);
+    assertBudgetValue("maxEvidenceBytes", budget.maxEvidenceBytes, 0, ASSISTANT_WORKFLOW_EXECUTION_BUDGET_LIMITS.maxEvidenceBytes);
+}
+export function buildAssistantWorkflowExecutionBudgetAssessment(budget, usage = {}) {
+    assertAssistantWorkflowExecutionBudget(budget);
+    const normalizedUsage = {
+        planningStepCount: normalizeUsageValue(usage.planningStepCount),
+        toolCallCount: normalizeUsageValue(usage.toolCallCount),
+        providerCallCount: normalizeUsageValue(usage.providerCallCount),
+        elapsedMs: normalizeUsageValue(usage.elapsedMs),
+        evidenceBytes: normalizeUsageValue(usage.evidenceBytes),
+    };
+    const violations = [
+        buildViolation("planning_steps_exceeded", normalizedUsage.planningStepCount, budget.maxPlanningSteps),
+        buildViolation("tool_calls_exceeded", normalizedUsage.toolCallCount, budget.maxToolCalls),
+        buildViolation("provider_calls_exceeded", normalizedUsage.providerCallCount, budget.maxProviderCalls),
+        buildViolation("duration_exceeded", normalizedUsage.elapsedMs, budget.maxDurationMs),
+        buildViolation("evidence_bytes_exceeded", normalizedUsage.evidenceBytes, budget.maxEvidenceBytes),
+    ].filter((violation) => violation !== null);
+    return {
+        status: violations.length > 0 ? "blocked" : "within-budget",
+        budget: { ...budget },
+        usage: normalizedUsage,
+        violations,
+    };
+}
+export function buildAssistantWorkflowExecutionBudgetTracePayload(assessment) {
+    return {
+        status: assessment.status,
+        budget: assessment.budget,
+        usage: assessment.usage,
+        violations: assessment.violations.map((violation) => ({ ...violation })),
+    };
+}
+export function formatAssistantWorkflowExecutionBudgetViolation(violation) {
+    return `execution budget exceeded: ${violation.code} (${violation.actual} > ${violation.limit})`;
+}
+function assertBudgetValue(field, value, minimum, maximum) {
+    if (!Number.isInteger(value) || value < minimum || value > maximum) {
+        throw new Error(`Assistant workflow execution budget ${field} must be an integer between ${minimum} and ${maximum}.`);
+    }
+}
+function normalizeUsageValue(value) {
+    if (value === undefined)
+        return 0;
+    if (!Number.isFinite(value) || value < 0) {
+        throw new Error("Assistant workflow execution budget usage values must be finite non-negative numbers.");
+    }
+    return Math.floor(value);
+}
+function buildViolation(code, actual, limit) {
+    return actual > limit ? { code, actual, limit } : null;
+}
+//# sourceMappingURL=execution-budget.js.map

package/dist/execution-budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-budget.js","sourceRoot":"","sources":["../src/execution-budget.ts"],"names":[],"mappings":"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","sourcesContent":["export const ASSISTANT_WORKFLOW_EXECUTION_BUDGET_LIMITS = Object.freeze({\n  maxPlanningSteps: 32,\n  maxToolCalls: 16,\n  maxProviderCalls: 8,\n  maxDurationMs: 300_000,\n  maxEvidenceBytes: 1_000_000,\n});\n\nexport type AssistantWorkflowExecutionBudget = {\n  maxPlanningSteps: number;\n  maxToolCalls: number;\n  maxProviderCalls: number;\n  maxDurationMs: number;\n  maxEvidenceBytes: number;\n};\n\nexport type AssistantWorkflowExecutionBudgetUsage = {\n  planningStepCount: number;\n  toolCallCount: number;\n  providerCallCount: number;\n  elapsedMs: number;\n  evidenceBytes: number;\n};\n\nexport type AssistantWorkflowExecutionBudgetViolationCode =\n  | \"planning_steps_exceeded\"\n  | \"tool_calls_exceeded\"\n  | \"provider_calls_exceeded\"\n  | \"duration_exceeded\"\n  | \"evidence_bytes_exceeded\";\n\nexport type AssistantWorkflowExecutionBudgetViolation = {\n  code: AssistantWorkflowExecutionBudgetViolationCode;\n  actual: number;\n  limit: number;\n};\n\nexport type AssistantWorkflowExecutionBudgetAssessment = {\n  status: \"within-budget\" | \"blocked\";\n  budget: AssistantWorkflowExecutionBudget;\n  usage: AssistantWorkflowExecutionBudgetUsage;\n  violations: AssistantWorkflowExecutionBudgetViolation[];\n};\n\nexport function assertAssistantWorkflowExecutionBudget(\n  budget: AssistantWorkflowExecutionBudget,\n): void {\n  assertBudgetValue(\"maxPlanningSteps\", budget.maxPlanningSteps, 1, ASSISTANT_WORKFLOW_EXECUTION_BUDGET_LIMITS.maxPlanningSteps);\n  assertBudgetValue(\"maxToolCalls\", budget.maxToolCalls, 0, ASSISTANT_WORKFLOW_EXECUTION_BUDGET_LIMITS.maxToolCalls);\n  assertBudgetValue(\"maxProviderCalls\", budget.maxProviderCalls, 0, ASSISTANT_WORKFLOW_EXECUTION_BUDGET_LIMITS.maxProviderCalls);\n  assertBudgetValue(\"maxDurationMs\", budget.maxDurationMs, 1, ASSISTANT_WORKFLOW_EXECUTION_BUDGET_LIMITS.maxDurationMs);\n  assertBudgetValue(\"maxEvidenceBytes\", budget.maxEvidenceBytes, 0, ASSISTANT_WORKFLOW_EXECUTION_BUDGET_LIMITS.maxEvidenceBytes);\n}\n\nexport function buildAssistantWorkflowExecutionBudgetAssessment(\n  budget: AssistantWorkflowExecutionBudget,\n  usage: Partial<AssistantWorkflowExecutionBudgetUsage> = {},\n): AssistantWorkflowExecutionBudgetAssessment {\n  assertAssistantWorkflowExecutionBudget(budget);\n  const normalizedUsage: AssistantWorkflowExecutionBudgetUsage = {\n    planningStepCount: normalizeUsageValue(usage.planningStepCount),\n    toolCallCount: normalizeUsageValue(usage.toolCallCount),\n    providerCallCount: normalizeUsageValue(usage.providerCallCount),\n    elapsedMs: normalizeUsageValue(usage.elapsedMs),\n    evidenceBytes: normalizeUsageValue(usage.evidenceBytes),\n  };\n  const violations = [\n    buildViolation(\"planning_steps_exceeded\", normalizedUsage.planningStepCount, budget.maxPlanningSteps),\n    buildViolation(\"tool_calls_exceeded\", normalizedUsage.toolCallCount, budget.maxToolCalls),\n    buildViolation(\"provider_calls_exceeded\", normalizedUsage.providerCallCount, budget.maxProviderCalls),\n    buildViolation(\"duration_exceeded\", normalizedUsage.elapsedMs, budget.maxDurationMs),\n    buildViolation(\"evidence_bytes_exceeded\", normalizedUsage.evidenceBytes, budget.maxEvidenceBytes),\n  ].filter((violation): violation is AssistantWorkflowExecutionBudgetViolation => violation !== null);\n\n  return {\n    status: violations.length > 0 ? \"blocked\" : \"within-budget\",\n    budget: { ...budget },\n    usage: normalizedUsage,\n    violations,\n  };\n}\n\nexport function buildAssistantWorkflowExecutionBudgetTracePayload(\n  assessment: AssistantWorkflowExecutionBudgetAssessment,\n): Record<string, unknown> {\n  return {\n    status: assessment.status,\n    budget: assessment.budget,\n    usage: assessment.usage,\n    violations: assessment.violations.map((violation) => ({ ...violation })),\n  };\n}\n\nexport function formatAssistantWorkflowExecutionBudgetViolation(\n  violation: AssistantWorkflowExecutionBudgetViolation,\n): string {\n  return `execution budget exceeded: ${violation.code} (${violation.actual} > ${violation.limit})`;\n}\n\nfunction assertBudgetValue(\n  field: keyof AssistantWorkflowExecutionBudget,\n  value: number,\n  minimum: number,\n  maximum: number,\n): void {\n  if (!Number.isInteger(value) || value < minimum || value > maximum) {\n    throw new Error(\n      `Assistant workflow execution budget ${field} must be an integer between ${minimum} and ${maximum}.`,\n    );\n  }\n}\n\nfunction normalizeUsageValue(value: number | undefined): number {\n  if (value === undefined) return 0;\n  if (!Number.isFinite(value) || value < 0) {\n    throw new Error(\"Assistant workflow execution budget usage values must be finite non-negative numbers.\");\n  }\n  return Math.floor(value);\n}\n\nfunction buildViolation(\n  code: AssistantWorkflowExecutionBudgetViolationCode,\n  actual: number,\n  limit: number,\n): AssistantWorkflowExecutionBudgetViolation | null {\n  return actual > limit ? { code, actual, limit } : null;\n}\n"]}

package/dist/execution-plan.d.ts

@@ -1,11 +1,16 @@
 import type { AssistantWorkflowDecision } from "./decision.js";
 import { type AssistantWorkflowDefinition, type AssistantWorkflowPlanningStepKind, type AssistantWorkflowToolContextRequirement } from "./definition.js";
+import { type AssistantWorkflowExecutionBudget, type AssistantWorkflowExecutionBudgetAssessment } from "./execution-budget.js";
+import { type AssistantWorkflowExecutionPolicy } from "./execution-policy.js";
 export type AssistantWorkflowExecutionPlanStatus = "ready" | "needs-clarification" | "blocked" | "partial";
 export type AssistantWorkflowExecutionStepStatus = "ready" | "blocked" | "optional-skipped" | "partial";
 export type AssistantWorkflowExecutionStep = {
     id: string;
     kind: AssistantWorkflowPlanningStepKind;
     optional: boolean;
+    dependsOnStepIds: string[];
+    missingDependencyStepIds: string[];
+    outOfOrderDependencyStepIds: string[];
     status: AssistantWorkflowExecutionStepStatus;
     toolNames: string[];
     requiredToolNames: string[];
@@ -34,6 +39,9 @@ export type AssistantWorkflowExecutionPlan = {
     blockingReasons: string[];
     warnings: string[];
     executionHints: AssistantWorkflowDecision["plan"]["executionHints"];
+    executionBudget?: AssistantWorkflowExecutionBudget | null;
+    budgetAssessment?: AssistantWorkflowExecutionBudgetAssessment | null;
+    executionPolicy?: AssistantWorkflowExecutionPolicy;
 };
 export type AssistantWorkflowExecutionPlanOptions = {
     availableContext?: readonly AssistantWorkflowToolContextRequirement[] | null;

package/dist/execution-plan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execution-plan.d.ts","sourceRoot":"","sources":["../src/execution-plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EACL,KAAK,2BAA2B,EAChC,KAAK,iCAAiC,EACtC,KAAK,uCAAuC,EAC7C,MAAM,iBAAiB,CAAC;AAMzB,MAAM,MAAM,oCAAoC,GAC5C,OAAO,GACP,qBAAqB,GACrB,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,MAAM,oCAAoC,GAC5C,OAAO,GACP,SAAS,GACT,kBAAkB,GAClB,SAAS,CAAC;AAEd,MAAM,MAAM,8BAA8B,GAAG;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,iCAAiC,CAAC;IACxC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,oCAAoC,CAAC;IAC7C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,eAAe,EAAE,uCAAuC,EAAE,CAAC;IAC3D,0BAA0B,EAAE,uCAAuC,EAAE,CAAC;IACtE,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,oCAAoC,CAAC;IAC7C,KAAK,EAAE,8BAA8B,EAAE,CAAC;IACxC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,eAAe,EAAE,uCAAuC,EAAE,CAAC;IAC3D,0BAA0B,EAAE,uCAAuC,EAAE,CAAC;IACtE,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,EAAE,yBAAyB,CAAC,MAAM,CAAC,CAAC,gBAAgB,CAAC,CAAC;CACrE,CAAC;AAEF,MAAM,MAAM,qCAAqC,GAAG;IAClD,gBAAgB,CAAC,EAAE,SAAS,uCAAuC,EAAE,GAAG,IAAI,CAAC;CAC9E,CAAC;AAEF,wBAAgB,mCAAmC,CACjD,QAAQ,EAAE,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACrE,QAAQ,EAAE,yBAAyB,EACnC,OAAO,GAAE,qCAA0C,GAClD,8BAA8B,CAqHhC;AAED,wBAAgB,+CAA+C,CAC7D,IAAI,EAAE,8BAA8B,GACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkBzB"}
+{"version":3,"file":"execution-plan.d.ts","sourceRoot":"","sources":["../src/execution-plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EACL,KAAK,2BAA2B,EAChC,KAAK,iCAAiC,EACtC,KAAK,uCAAuC,EAC7C,MAAM,iBAAiB,CAAC;AAKzB,OAAO,EAIL,KAAK,gCAAgC,EACrC,KAAK,0CAA0C,EAChD,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,KAAK,gCAAgC,EACtC,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,oCAAoC,GAC5C,OAAO,GACP,qBAAqB,GACrB,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,MAAM,oCAAoC,GAC5C,OAAO,GACP,SAAS,GACT,kBAAkB,GAClB,SAAS,CAAC;AAEd,MAAM,MAAM,8BAA8B,GAAG;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,iCAAiC,CAAC;IACxC,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,wBAAwB,EAAE,MAAM,EAAE,CAAC;IACnC,2BAA2B,EAAE,MAAM,EAAE,CAAC;IACtC,MAAM,EAAE,oCAAoC,CAAC;IAC7C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,eAAe,EAAE,uCAAuC,EAAE,CAAC;IAC3D,0BAA0B,EAAE,uCAAuC,EAAE,CAAC;IACtE,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,oCAAoC,CAAC;IAC7C,KAAK,EAAE,8BAA8B,EAAE,CAAC;IACxC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,eAAe,EAAE,uCAAuC,EAAE,CAAC;IAC3D,0BAA0B,EAAE,uCAAuC,EAAE,CAAC;IACtE,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,EAAE,yBAAyB,CAAC,MAAM,CAAC,CAAC,gBAAgB,CAAC,CAAC;IACpE,eAAe,CAAC,EAAE,gCAAgC,GAAG,IAAI,CAAC;IAC1D,gBAAgB,CAAC,EAAE,0CAA0C,GAAG,IAAI,CAAC;IACrE,eAAe,CAAC,EAAE,gCAAgC,CAAC;CACpD,CAAC;AAEF,MAAM,MAAM,qCAAqC,GAAG;IAClD,gBAAgB,CAAC,EAAE,SAAS,uCAAuC,EAAE,GAAG,IAAI,CAAC;CAC9E,CAAC;AAEF,wBAAgB,mCAAmC,CACjD,QAAQ,EAAE,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACrE,QAAQ,EAAE,yBAAyB,EACnC,OAAO,GAAE,qCAA0C,GAClD,8BAA8B,CAkJhC;AAaD,wBAAgB,+CAA+C,CAC7D,IAAI,EAAE,8BAA8B,GACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuBzB"}

package/dist/execution-plan.js

@@ -1,7 +1,13 @@
 import { resolveAssistantWorkflowTools, } from "./tool-bindings.js";
+import { buildAssistantWorkflowExecutionBudgetAssessment, buildAssistantWorkflowExecutionBudgetTracePayload, formatAssistantWorkflowExecutionBudgetViolation, } from "./execution-budget.js";
+import { resolveAssistantWorkflowExecutionPolicy, } from "./execution-policy.js";
 export function buildAssistantWorkflowExecutionPlan(workflow, decision, options = {}) {
     const availableContext = options.availableContext ? new Set(options.availableContext) : null;
+    const selectedStepIds = new Set(decision.plan.steps.map((step) => step.id));
+    const seenStepIds = new Set();
     const steps = decision.plan.steps.map((step) => {
+        const missingDependencyStepIds = step.dependsOnStepIds.filter((stepId) => !selectedStepIds.has(stepId));
+        const outOfOrderDependencyStepIds = step.dependsOnStepIds.filter((stepId) => selectedStepIds.has(stepId) && !seenStepIds.has(stepId));
         const requiredToolNames = uniqueStrings(step.requiredToolHints);
         const optionalToolNames = uniqueStrings(step.toolHints).filter((tool) => !requiredToolNames.includes(tool));
         const toolNames = uniqueStrings([...requiredToolNames, ...optionalToolNames]);
@@ -15,17 +21,20 @@ export function buildAssistantWorkflowExecutionPlan(workflow, decision, options
         const contextBlockingReasons = step.optional
             ? []
             : buildContextBlockingReasons(step.id, requiredContextGaps);
+        const dependencyReasons = buildDependencyReasons(step.id, missingDependencyStepIds, outOfOrderDependencyStepIds);
         const blockingReasons = step.optional
             ? []
             : [
                 ...buildToolBlockingReasons(step.id, requiredNonReady),
                 ...contextBlockingReasons,
+                ...dependencyReasons,
             ];
         const warnings = [
             ...buildToolWarnings(step.id, step.optional ? requiredNonReady : []),
             ...buildToolWarnings(step.id, optionalNonReady),
             ...buildContextWarnings(step.id, step.optional ? requiredContextGaps : []),
             ...buildContextWarnings(step.id, optionalContextGaps),
+            ...(step.optional ? dependencyReasons : []),
         ];
         const status = step.optional && (requiredNonReady.length > 0 || requiredContextGaps.length > 0)
             ? "optional-skipped"
@@ -35,10 +44,13 @@ export function buildAssistantWorkflowExecutionPlan(workflow, decision, options
                     ? "partial"
                     : "ready";
         const allContextGaps = [...requiredContextGaps, ...optionalContextGaps];
-        return {
+        const result = {
             id: step.id,
             kind: step.kind,
             optional: step.optional,
+            dependsOnStepIds: [...step.dependsOnStepIds],
+            missingDependencyStepIds,
+            outOfOrderDependencyStepIds,
             status,
             toolNames,
             requiredToolNames,
@@ -53,9 +65,18 @@ export function buildAssistantWorkflowExecutionPlan(workflow, decision, options
             blockingReasons,
             warnings,
         };
+        seenStepIds.add(step.id);
+        return result;
     });
     const requiredResolution = resolveAssistantWorkflowTools(workflow, decision.requiredToolHints);
     const requiredContextGaps = getContextGaps(requiredResolution.resolutions, availableContext);
+    const executionPolicy = resolveAssistantWorkflowExecutionPolicy(workflow.executionPolicy);
+    const budgetAssessment = workflow.executionBudget
+        ? buildAssistantWorkflowExecutionBudgetAssessment(workflow.executionBudget, {
+            planningStepCount: steps.length,
+            toolCallCount: getMaximumPlannedToolCalls(workflow, steps, executionPolicy),
+        })
+        : null;
     const blockingReasons = [
         ...decision.clarificationPolicy.blockingRuleIds.map((ruleId) => `clarification required: ${ruleId}`),
         ...decision.plan.missingPlanningSteps.map((stepId) => `missing planning step: ${stepId}`),
@@ -63,6 +84,7 @@ export function buildAssistantWorkflowExecutionPlan(workflow, decision, options
         ...buildToolBlockingReasons("workflow", requiredResolution.resolutions.filter((resolution) => resolution.status !== "ready")),
         ...buildContextBlockingReasons("workflow", requiredContextGaps),
         ...steps.flatMap((step) => step.blockingReasons),
+        ...(budgetAssessment?.violations.map(formatAssistantWorkflowExecutionBudgetViolation) ?? []),
     ];
     const warnings = uniqueStrings([
         ...decision.missingToolHints.map((toolName) => `optional tool is unavailable: ${toolName}`),
@@ -110,8 +132,17 @@ export function buildAssistantWorkflowExecutionPlan(workflow, decision, options
         blockingReasons: uniqueStrings(blockingReasons),
         warnings,
         executionHints: decision.plan.executionHints,
+        executionBudget: workflow.executionBudget ? { ...workflow.executionBudget } : null,
+        budgetAssessment,
+        executionPolicy,
     };
 }
+function buildDependencyReasons(stepId, missingDependencyStepIds, outOfOrderDependencyStepIds) {
+    return [
+        ...missingDependencyStepIds.map((dependencyId) => `${stepId} missing dependency step: ${dependencyId}`),
+        ...outOfOrderDependencyStepIds.map((dependencyId) => `${stepId} dependency must run first: ${dependencyId}`),
+    ];
+}
 export function buildAssistantWorkflowExecutionPlanTracePayload(plan) {
     return {
         intent: plan.intent,
@@ -129,8 +160,23 @@ export function buildAssistantWorkflowExecutionPlanTracePayload(plan) {
         blockingReasons: plan.blockingReasons,
         warnings: plan.warnings,
         executionHints: plan.executionHints,
+        executionBudget: plan.executionBudget ?? null,
+        budgetAssessment: plan.budgetAssessment
+            ? buildAssistantWorkflowExecutionBudgetTracePayload(plan.budgetAssessment)
+            : null,
+        executionPolicy: plan.executionPolicy ?? resolveAssistantWorkflowExecutionPolicy(),
     };
 }
+function getMaximumPlannedToolCalls(workflow, steps, policy) {
+    const capabilities = new Map((workflow.tools ?? []).map((tool) => [tool.name, tool]));
+    return steps
+        .filter((step) => step.status !== "blocked" && step.status !== "optional-skipped")
+        .flatMap((step) => step.readyToolNames)
+        .reduce((count, toolName) => {
+        const retryClass = capabilities.get(toolName)?.retryClass;
+        return count + (retryClass === "never" ? 1 : policy.maxAttemptsPerTool);
+    }, 0);
+}
 function buildToolBlockingReasons(stepId, resolutions) {
     return resolutions.map((resolution) => `${stepId} required tool ${resolution.toolName} is ${resolution.status}`);
 }

package/dist/execution-plan.js.map

@@ -1 +1 @@
-{"version":3,"file":"execution-plan.js","sourceRoot":"","sources":["../src/execution-plan.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AssistantWorkflowDecision } from \"./decision.js\";\nimport {\n  type AssistantWorkflowDefinition,\n  type AssistantWorkflowPlanningStepKind,\n  type AssistantWorkflowToolContextRequirement,\n} from \"./definition.js\";\nimport {\n  resolveAssistantWorkflowTools,\n  type AssistantWorkflowToolResolution,\n} from \"./tool-bindings.js\";\n\nexport type AssistantWorkflowExecutionPlanStatus =\n  | \"ready\"\n  | \"needs-clarification\"\n  | \"blocked\"\n  | \"partial\";\n\nexport type AssistantWorkflowExecutionStepStatus =\n  | \"ready\"\n  | \"blocked\"\n  | \"optional-skipped\"\n  | \"partial\";\n\nexport type AssistantWorkflowExecutionStep = {\n  id: string;\n  kind: AssistantWorkflowPlanningStepKind;\n  optional: boolean;\n  status: AssistantWorkflowExecutionStepStatus;\n  toolNames: string[];\n  requiredToolNames: string[];\n  readyToolNames: string[];\n  missingCapabilityNames: string[];\n  missingBindingNames: string[];\n  providerMismatchNames: string[];\n  requiredContext: AssistantWorkflowToolContextRequirement[];\n  missingContextRequirements: AssistantWorkflowToolContextRequirement[];\n  blockingReasons: string[];\n  warnings: string[];\n};\n\nexport type AssistantWorkflowExecutionPlan = {\n  intent: string | null;\n  status: AssistantWorkflowExecutionPlanStatus;\n  steps: AssistantWorkflowExecutionStep[];\n  readyToolNames: string[];\n  requiredReadyToolNames: string[];\n  missingCapabilityNames: string[];\n  missingBindingNames: string[];\n  providerMismatchNames: string[];\n  requiredContext: AssistantWorkflowToolContextRequirement[];\n  missingContextRequirements: AssistantWorkflowToolContextRequirement[];\n  missingPlanningSteps: string[];\n  clarificationRuleIds: string[];\n  blockingReasons: string[];\n  warnings: string[];\n  executionHints: AssistantWorkflowDecision[\"plan\"][\"executionHints\"];\n};\n\nexport type AssistantWorkflowExecutionPlanOptions = {\n  availableContext?: readonly AssistantWorkflowToolContextRequirement[] | null;\n};\n\nexport function buildAssistantWorkflowExecutionPlan(\n  workflow: AssistantWorkflowDefinition<string, string, string, string>,\n  decision: AssistantWorkflowDecision,\n  options: AssistantWorkflowExecutionPlanOptions = {},\n): AssistantWorkflowExecutionPlan {\n  const availableContext = options.availableContext ? new Set(options.availableContext) : null;\n  const steps = decision.plan.steps.map((step) => {\n    const requiredToolNames = uniqueStrings(step.requiredToolHints);\n    const optionalToolNames = uniqueStrings(step.toolHints).filter((tool) => !requiredToolNames.includes(tool));\n    const toolNames = uniqueStrings([...requiredToolNames, ...optionalToolNames]);\n    const requiredResolution = resolveAssistantWorkflowTools(workflow, requiredToolNames);\n    const optionalResolution = resolveAssistantWorkflowTools(workflow, optionalToolNames);\n    const allResolutions = [...requiredResolution.resolutions, ...optionalResolution.resolutions];\n    const requiredNonReady = requiredResolution.resolutions.filter((resolution) => resolution.status !== \"ready\");\n    const optionalNonReady = optionalResolution.resolutions.filter((resolution) => resolution.status !== \"ready\");\n    const requiredContextGaps = getContextGaps(requiredResolution.resolutions, availableContext);\n    const optionalContextGaps = getContextGaps(optionalResolution.resolutions, availableContext);\n    const contextBlockingReasons = step.optional\n      ? []\n      : buildContextBlockingReasons(step.id, requiredContextGaps);\n    const blockingReasons = step.optional\n      ? []\n      : [\n          ...buildToolBlockingReasons(step.id, requiredNonReady),\n          ...contextBlockingReasons,\n        ];\n    const warnings = [\n      ...buildToolWarnings(step.id, step.optional ? requiredNonReady : []),\n      ...buildToolWarnings(step.id, optionalNonReady),\n      ...buildContextWarnings(step.id, step.optional ? requiredContextGaps : []),\n      ...buildContextWarnings(step.id, optionalContextGaps),\n    ];\n    const status: AssistantWorkflowExecutionStepStatus =\n      step.optional && (requiredNonReady.length > 0 || requiredContextGaps.length > 0)\n        ? \"optional-skipped\"\n        : blockingReasons.length > 0\n        ? \"blocked\"\n        : optionalNonReady.length > 0 || optionalContextGaps.length > 0\n        ? \"partial\"\n        : \"ready\";\n    const allContextGaps = [...requiredContextGaps, ...optionalContextGaps];\n\n    return {\n      id: step.id,\n      kind: step.kind,\n      optional: step.optional,\n      status,\n      toolNames,\n      requiredToolNames,\n      readyToolNames: uniqueStrings(allResolutions\n        .filter((resolution) => resolution.status === \"ready\" && getMissingContextRequirements(resolution, availableContext).length === 0)\n        .map((resolution) => resolution.toolName)),\n      missingCapabilityNames: getResolutionNames(allResolutions, \"missing-capability\"),\n      missingBindingNames: getResolutionNames(allResolutions, \"missing-binding\"),\n      providerMismatchNames: getResolutionNames(allResolutions, \"provider-mismatch\"),\n      requiredContext: uniqueContextRequirements(allResolutions.flatMap((resolution) => resolution.capability?.requiredContext ?? [])),\n      missingContextRequirements: uniqueContextRequirements(allContextGaps.flatMap((gap) => gap.missingContextRequirements)),\n      blockingReasons,\n      warnings,\n    };\n  });\n\n  const requiredResolution = resolveAssistantWorkflowTools(workflow, decision.requiredToolHints);\n  const requiredContextGaps = getContextGaps(requiredResolution.resolutions, availableContext);\n  const blockingReasons = [\n    ...decision.clarificationPolicy.blockingRuleIds.map((ruleId) => `clarification required: ${ruleId}`),\n    ...decision.plan.missingPlanningSteps.map((stepId) => `missing planning step: ${stepId}`),\n    ...decision.missingRequiredToolHints.map((toolName) => `required tool is unavailable: ${toolName}`),\n    ...buildToolBlockingReasons(\"workflow\", requiredResolution.resolutions.filter((resolution) => resolution.status !== \"ready\")),\n    ...buildContextBlockingReasons(\"workflow\", requiredContextGaps),\n    ...steps.flatMap((step) => step.blockingReasons),\n  ];\n  const warnings = uniqueStrings([\n    ...decision.missingToolHints.map((toolName) => `optional tool is unavailable: ${toolName}`),\n    ...steps.flatMap((step) => step.warnings),\n  ]);\n  const allStepTools = steps.flatMap((step) => step.toolNames);\n  const allResolution = resolveAssistantWorkflowTools(workflow, allStepTools);\n  const allContextGaps = getContextGaps(allResolution.resolutions, availableContext);\n  const status: AssistantWorkflowExecutionPlanStatus =\n    decision.clarificationPolicy.needsClarification\n      ? \"needs-clarification\"\n      : blockingReasons.length > 0\n      ? \"blocked\"\n      : warnings.length > 0 || steps.some((step) => step.status === \"partial\" || step.status === \"optional-skipped\")\n      ? \"partial\"\n      : \"ready\";\n\n  return {\n    intent: decision.intent,\n    status,\n    steps,\n    readyToolNames: uniqueStrings(allResolution.resolutions\n      .filter((resolution) => resolution.status === \"ready\" && getMissingContextRequirements(resolution, availableContext).length === 0)\n      .map((resolution) => resolution.toolName)),\n    requiredReadyToolNames: uniqueStrings(requiredResolution.resolutions\n      .filter((resolution) => resolution.status === \"ready\" && getMissingContextRequirements(resolution, availableContext).length === 0)\n      .map((resolution) => resolution.toolName)),\n    missingCapabilityNames: uniqueStrings([\n      ...allResolution.missingCapabilityNames,\n      ...requiredResolution.missingCapabilityNames,\n    ]),\n    missingBindingNames: uniqueStrings([\n      ...allResolution.missingBindingNames,\n      ...requiredResolution.missingBindingNames,\n    ]),\n    providerMismatchNames: uniqueStrings([\n      ...allResolution.providerMismatchNames,\n      ...requiredResolution.providerMismatchNames,\n    ]),\n    requiredContext: uniqueContextRequirements(allResolution.resolutions.flatMap((resolution) => resolution.capability?.requiredContext ?? [])),\n    missingContextRequirements: uniqueContextRequirements([\n      ...allContextGaps.flatMap((gap) => gap.missingContextRequirements),\n      ...requiredContextGaps.flatMap((gap) => gap.missingContextRequirements),\n    ]),\n    missingPlanningSteps: [...decision.plan.missingPlanningSteps],\n    clarificationRuleIds: [...decision.clarificationPolicy.blockingRuleIds],\n    blockingReasons: uniqueStrings(blockingReasons),\n    warnings,\n    executionHints: decision.plan.executionHints,\n  };\n}\n\nexport function buildAssistantWorkflowExecutionPlanTracePayload(\n  plan: AssistantWorkflowExecutionPlan,\n): Record<string, unknown> {\n  return {\n    intent: plan.intent,\n    status: plan.status,\n    steps: plan.steps,\n    readyToolNames: plan.readyToolNames,\n    requiredReadyToolNames: plan.requiredReadyToolNames,\n    missingCapabilityNames: plan.missingCapabilityNames,\n    missingBindingNames: plan.missingBindingNames,\n    providerMismatchNames: plan.providerMismatchNames,\n    requiredContext: plan.requiredContext,\n    missingContextRequirements: plan.missingContextRequirements,\n    missingPlanningSteps: plan.missingPlanningSteps,\n    clarificationRuleIds: plan.clarificationRuleIds,\n    blockingReasons: plan.blockingReasons,\n    warnings: plan.warnings,\n    executionHints: plan.executionHints,\n  };\n}\n\nfunction buildToolBlockingReasons(stepId: string, resolutions: readonly AssistantWorkflowToolResolution[]): string[] {\n  return resolutions.map((resolution) => `${stepId} required tool ${resolution.toolName} is ${resolution.status}`);\n}\n\nfunction buildToolWarnings(stepId: string, resolutions: readonly AssistantWorkflowToolResolution[]): string[] {\n  return resolutions.map((resolution) => `${stepId} optional tool ${resolution.toolName} is ${resolution.status}`);\n}\n\ntype ToolContextGap = {\n  toolName: string;\n  missingContextRequirements: AssistantWorkflowToolContextRequirement[];\n};\n\nfunction getContextGaps(\n  resolutions: readonly AssistantWorkflowToolResolution[],\n  availableContext: ReadonlySet<AssistantWorkflowToolContextRequirement> | null,\n): ToolContextGap[] {\n  return resolutions\n    .map((resolution) => ({\n      toolName: resolution.toolName,\n      missingContextRequirements: getMissingContextRequirements(resolution, availableContext),\n    }))\n    .filter((gap) => gap.missingContextRequirements.length > 0);\n}\n\nfunction getMissingContextRequirements(\n  resolution: AssistantWorkflowToolResolution,\n  availableContext: ReadonlySet<AssistantWorkflowToolContextRequirement> | null,\n): AssistantWorkflowToolContextRequirement[] {\n  if (!availableContext || resolution.status !== \"ready\") return [];\n  return uniqueContextRequirements(resolution.capability?.requiredContext ?? [])\n    .filter((requirement) => !availableContext.has(requirement));\n}\n\nfunction buildContextBlockingReasons(stepId: string, gaps: readonly ToolContextGap[]): string[] {\n  return gaps.map((gap) =>\n    `${stepId} required tool ${gap.toolName} missing context: ${gap.missingContextRequirements.join(\", \")}`,\n  );\n}\n\nfunction buildContextWarnings(stepId: string, gaps: readonly ToolContextGap[]): string[] {\n  return gaps.map((gap) =>\n    `${stepId} optional tool ${gap.toolName} missing context: ${gap.missingContextRequirements.join(\", \")}`,\n  );\n}\n\nfunction getResolutionNames(\n  resolutions: readonly AssistantWorkflowToolResolution[],\n  status: AssistantWorkflowToolResolution[\"status\"],\n): string[] {\n  return uniqueStrings(\n    resolutions\n      .filter((resolution) => resolution.status === status)\n      .map((resolution) => resolution.toolName),\n  );\n}\n\nfunction uniqueStrings(values: readonly string[]): string[] {\n  const out: string[] = [];\n  const seen = new Set<string>();\n  for (const value of values) {\n    if (seen.has(value)) continue;\n    seen.add(value);\n    out.push(value);\n  }\n  return out;\n}\n\nfunction uniqueContextRequirements(\n  values: readonly AssistantWorkflowToolContextRequirement[],\n): AssistantWorkflowToolContextRequirement[] {\n  const out: AssistantWorkflowToolContextRequirement[] = [];\n  const seen = new Set<AssistantWorkflowToolContextRequirement>();\n  for (const value of values) {\n    if (seen.has(value)) continue;\n    seen.add(value);\n    out.push(value);\n  }\n  return out;\n}\n"]}
+{"version":3,"file":"execution-plan.js","sourceRoot":"","sources":["../src/execution-plan.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,6BAA6B,GAE9B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,+CAA+C,EAC/C,iDAAiD,EACjD,+CAA+C,GAGhD,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,uCAAuC,GAExC,MAAM,uBAAuB,CAAC;AA2D/B,MAAM,UAAU,mCAAmC,CACjD,QAAqE,EACrE,QAAmC,EACnC,UAAiD,EAAE;IAEnD,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7F,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5E,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC7C,MAAM,wBAAwB,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QACxG,MAAM,2BAA2B,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAC9D,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CACpE,CAAC;QACF,MAAM,iBAAiB,GAAG,aAAa,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAChE,MAAM,iBAAiB,GAAG,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5G,MAAM,SAAS,GAAG,aAAa,CAAC,CAAC,GAAG,iBAAiB,EAAE,GAAG,iBAAiB,CAAC,CAAC,CAAC;QAC9E,MAAM,kBAAkB,GAAG,6BAA6B,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;QACtF,MAAM,kBAAkB,GAAG,6BAA6B,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;QACtF,MAAM,cAAc,GAAG,CAAC,GAAG,kBAAkB,CAAC,WAAW,EAAE,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;QAC9F,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC;QAC9G,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC;QAC9G,MAAM,mBAAmB,GAAG,cAAc,CAAC,kBAAkB,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;QAC7F,MAAM,mBAAmB,GAAG,cAAc,CAAC,kBAAkB,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;QAC7F,MAAM,sBAAsB,GAAG,IAAI,CAAC,QAAQ;YAC1C,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,2BAA2B,CAAC,IAAI,CAAC,EAAE,EAAE,mBAAmB,CAAC,CAAC;QAC9D,MAAM,iBAAiB,GAAG,sBAAsB,CAC9C,IAAI,CAAC,EAAE,EACP,wBAAwB,EACxB,2BAA2B,CAC5B,CAAC;QACF,MAAM,eAAe,GAAG,IAAI,CAAC,QAAQ;YACnC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE,GAAG,wBAAwB,CAAC,IAAI,CAAC,EAAE,EAAE,gBAAgB,CAAC;gBACtD,GAAG,sBAAsB;gBACzB,GAAG,iBAAiB;aACrB,CAAC;QACN,MAAM,QAAQ,GAAG;YACf,GAAG,iBAAiB,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;YACpE,GAAG,iBAAiB,CAAC,IAAI,CAAC,EAAE,EAAE,gBAAgB,CAAC;YAC/C,GAAG,oBAAoB,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1E,GAAG,oBAAoB,CAAC,IAAI,CAAC,EAAE,EAAE,mBAAmB,CAAC;YACrD,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5C,CAAC;QACF,MAAM,MAAM,GACV,IAAI,CAAC,QAAQ,IAAI,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,IAAI,mBAAmB,CAAC,MAAM,GAAG,CAAC,CAAC;YAC9E,CAAC,CAAC,kBAAkB;YACpB,CAAC,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC;gBAC5B,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,IAAI,mBAAmB,CAAC,MAAM,GAAG,CAAC;oBAC/D,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC,OAAO,CAAC;QACd,MAAM,cAAc,GAAG,CAAC,GAAG,mBAAmB,EAAE,GAAG,mBAAmB,CAAC,CAAC;QAExE,MAAM,MAAM,GAAmC;YAC7C,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,gBAAgB,EAAE,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC;YAC5C,wBAAwB;YACxB,2BAA2B;YAC3B,MAAM;YACN,SAAS;YACT,iBAAiB;YACjB,cAAc,EAAE,aAAa,CAAC,cAAc;iBACzC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,KAAK,OAAO,IAAI,6BAA6B,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;iBACjI,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YAC5C,sBAAsB,EAAE,kBAAkB,CAAC,cAAc,EAAE,oBAAoB,CAAC;YAChF,mBAAmB,EAAE,kBAAkB,CAAC,cAAc,EAAE,iBAAiB,CAAC;YAC1E,qBAAqB,EAAE,kBAAkB,CAAC,cAAc,EAAE,mBAAmB,CAAC;YAC9E,eAAe,EAAE,yBAAyB,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,UAAU,EAAE,eAAe,IAAI,EAAE,CAAC,CAAC;YAChI,0BAA0B,EAAE,yBAAyB,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;YACtH,eAAe;YACf,QAAQ;SACT,CAAC;QACF,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzB,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,MAAM,kBAAkB,GAAG,6BAA6B,CAAC,QAAQ,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IAC/F,MAAM,mBAAmB,GAAG,cAAc,CAAC,kBAAkB,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;IAC7F,MAAM,eAAe,GAAG,uCAAuC,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IAC1F,MAAM,gBAAgB,GAAG,QAAQ,CAAC,eAAe;QAC/C,CAAC,CAAC,+CAA+C,CAAC,QAAQ,CAAC,eAAe,EAAE;YACxE,iBAAiB,EAAE,KAAK,CAAC,MAAM;YAC/B,aAAa,EAAE,0BAA0B,CAAC,QAAQ,EAAE,KAAK,EAAE,eAAe,CAAC;SAC5E,CAAC;QACJ,CAAC,CAAC,IAAI,CAAC;IACT,MAAM,eAAe,GAAG;QACtB,GAAG,QAAQ,CAAC,mBAAmB,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,2BAA2B,MAAM,EAAE,CAAC;QACpG,GAAG,QAAQ,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,0BAA0B,MAAM,EAAE,CAAC;QACzF,GAAG,QAAQ,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,iCAAiC,QAAQ,EAAE,CAAC;QACnG,GAAG,wBAAwB,CAAC,UAAU,EAAE,kBAAkB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC;QAC7H,GAAG,2BAA2B,CAAC,UAAU,EAAE,mBAAmB,CAAC;QAC/D,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC;QAChD,GAAG,CAAC,gBAAgB,EAAE,UAAU,CAAC,GAAG,CAAC,+CAA+C,CAAC,IAAI,EAAE,CAAC;KAC7F,CAAC;IACF,MAAM,QAAQ,GAAG,aAAa,CAAC;QAC7B,GAAG,QAAQ,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,iCAAiC,QAAQ,EAAE,CAAC;QAC3F,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC;KAC1C,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7D,MAAM,aAAa,GAAG,6BAA6B,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAC5E,MAAM,cAAc,GAAG,cAAc,CAAC,aAAa,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;IACnF,MAAM,MAAM,GACV,QAAQ,CAAC,mBAAmB,CAAC,kBAAkB;QAC7C,CAAC,CAAC,qBAAqB;QACvB,CAAC,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC;YAC5B,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,kBAAkB,CAAC;gBAC9G,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,OAAO,CAAC;IAEd,OAAO;QACL,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,MAAM;QACN,KAAK;QACL,cAAc,EAAE,aAAa,CAAC,aAAa,CAAC,WAAW;aACpD,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,KAAK,OAAO,IAAI,6BAA6B,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;aACjI,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC5C,sBAAsB,EAAE,aAAa,CAAC,kBAAkB,CAAC,WAAW;aACjE,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,KAAK,OAAO,IAAI,6BAA6B,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;aACjI,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC5C,sBAAsB,EAAE,aAAa,CAAC;YACpC,GAAG,aAAa,CAAC,sBAAsB;YACvC,GAAG,kBAAkB,CAAC,sBAAsB;SAC7C,CAAC;QACF,mBAAmB,EAAE,aAAa,CAAC;YACjC,GAAG,aAAa,CAAC,mBAAmB;YACpC,GAAG,kBAAkB,CAAC,mBAAmB;SAC1C,CAAC;QACF,qBAAqB,EAAE,aAAa,CAAC;YACnC,GAAG,aAAa,CAAC,qBAAqB;YACtC,GAAG,kBAAkB,CAAC,qBAAqB;SAC5C,CAAC;QACF,eAAe,EAAE,yBAAyB,CAAC,aAAa,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,UAAU,EAAE,eAAe,IAAI,EAAE,CAAC,CAAC;QAC3I,0BAA0B,EAAE,yBAAyB,CAAC;YACpD,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,0BAA0B,CAAC;YAClE,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,0BAA0B,CAAC;SACxE,CAAC;QACF,oBAAoB,EAAE,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,oBAAoB,CAAC;QAC7D,oBAAoB,EAAE,CAAC,GAAG,QAAQ,CAAC,mBAAmB,CAAC,eAAe,CAAC;QACvE,eAAe,EAAE,aAAa,CAAC,eAAe,CAAC;QAC/C,QAAQ;QACR,cAAc,EAAE,QAAQ,CAAC,IAAI,CAAC,cAAc;QAC5C,eAAe,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,IAAI;QAClF,gBAAgB;QAChB,eAAe;KAChB,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAC7B,MAAc,EACd,wBAA2C,EAC3C,2BAA8C;IAE9C,OAAO;QACL,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,GAAG,MAAM,6BAA6B,YAAY,EAAE,CAAC;QACvG,GAAG,2BAA2B,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,GAAG,MAAM,+BAA+B,YAAY,EAAE,CAAC;KAC7G,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,+CAA+C,CAC7D,IAAoC;IAEpC,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;QACnD,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;QACnD,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;QAC7C,qBAAqB,EAAE,IAAI,CAAC,qBAAqB;QACjD,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,0BAA0B,EAAE,IAAI,CAAC,0BAA0B;QAC3D,oBAAoB,EAAE,IAAI,CAAC,oBAAoB;QAC/C,oBAAoB,EAAE,IAAI,CAAC,oBAAoB;QAC/C,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,IAAI;QAC7C,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACrC,CAAC,CAAC,iDAAiD,CAAC,IAAI,CAAC,gBAAgB,CAAC;YAC1E,CAAC,CAAC,IAAI;QACR,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,uCAAuC,EAAE;KACnF,CAAC;AACJ,CAAC;AAED,SAAS,0BAA0B,CACjC,QAAqE,EACrE,KAAgD,EAChD,MAAwC;IAExC,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAU,CAAC,CAAC,CAAC;IAC/F,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,kBAAkB,CAAC;SACjF,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC;SACtC,MAAM,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;QAC1B,MAAM,UAAU,GAAG,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;QAC1D,OAAO,KAAK,GAAG,CAAC,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAC1E,CAAC,EAAE,CAAC,CAAC,CAAC;AACV,CAAC;AAED,SAAS,wBAAwB,CAAC,MAAc,EAAE,WAAuD;IACvG,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,GAAG,MAAM,kBAAkB,UAAU,CAAC,QAAQ,OAAO,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;AACnH,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAc,EAAE,WAAuD;IAChG,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,GAAG,MAAM,kBAAkB,UAAU,CAAC,QAAQ,OAAO,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;AACnH,CAAC;AAOD,SAAS,cAAc,CACrB,WAAuD,EACvD,gBAA6E;IAE7E,OAAO,WAAW;SACf,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACpB,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,0BAA0B,EAAE,6BAA6B,CAAC,UAAU,EAAE,gBAAgB,CAAC;KACxF,CAAC,CAAC;SACF,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,0BAA0B,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,6BAA6B,CACpC,UAA2C,EAC3C,gBAA6E;IAE7E,IAAI,CAAC,gBAAgB,IAAI,UAAU,CAAC,MAAM,KAAK,OAAO;QAAE,OAAO,EAAE,CAAC;IAClE,OAAO,yBAAyB,CAAC,UAAU,CAAC,UAAU,EAAE,eAAe,IAAI,EAAE,CAAC;SAC3E,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,2BAA2B,CAAC,MAAc,EAAE,IAA+B;IAClF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CACtB,GAAG,MAAM,kBAAkB,GAAG,CAAC,QAAQ,qBAAqB,GAAG,CAAC,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACxG,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAc,EAAE,IAA+B;IAC3E,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CACtB,GAAG,MAAM,kBAAkB,GAAG,CAAC,QAAQ,qBAAqB,GAAG,CAAC,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACxG,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CACzB,WAAuD,EACvD,MAAiD;IAEjD,OAAO,aAAa,CAClB,WAAW;SACR,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,KAAK,MAAM,CAAC;SACpD,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAC5C,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,MAAyB;IAC9C,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAS;QAC9B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,yBAAyB,CAChC,MAA0D;IAE1D,MAAM,GAAG,GAA8C,EAAE,CAAC;IAC1D,MAAM,IAAI,GAAG,IAAI,GAAG,EAA2C,CAAC;IAChE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAS;QAC9B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC","sourcesContent":["import type { AssistantWorkflowDecision } from \"./decision.js\";\nimport {\n  type AssistantWorkflowDefinition,\n  type AssistantWorkflowPlanningStepKind,\n  type AssistantWorkflowToolContextRequirement,\n} from \"./definition.js\";\nimport {\n  resolveAssistantWorkflowTools,\n  type AssistantWorkflowToolResolution,\n} from \"./tool-bindings.js\";\nimport {\n  buildAssistantWorkflowExecutionBudgetAssessment,\n  buildAssistantWorkflowExecutionBudgetTracePayload,\n  formatAssistantWorkflowExecutionBudgetViolation,\n  type AssistantWorkflowExecutionBudget,\n  type AssistantWorkflowExecutionBudgetAssessment,\n} from \"./execution-budget.js\";\nimport {\n  resolveAssistantWorkflowExecutionPolicy,\n  type AssistantWorkflowExecutionPolicy,\n} from \"./execution-policy.js\";\n\nexport type AssistantWorkflowExecutionPlanStatus =\n  | \"ready\"\n  | \"needs-clarification\"\n  | \"blocked\"\n  | \"partial\";\n\nexport type AssistantWorkflowExecutionStepStatus =\n  | \"ready\"\n  | \"blocked\"\n  | \"optional-skipped\"\n  | \"partial\";\n\nexport type AssistantWorkflowExecutionStep = {\n  id: string;\n  kind: AssistantWorkflowPlanningStepKind;\n  optional: boolean;\n  dependsOnStepIds: string[];\n  missingDependencyStepIds: string[];\n  outOfOrderDependencyStepIds: string[];\n  status: AssistantWorkflowExecutionStepStatus;\n  toolNames: string[];\n  requiredToolNames: string[];\n  readyToolNames: string[];\n  missingCapabilityNames: string[];\n  missingBindingNames: string[];\n  providerMismatchNames: string[];\n  requiredContext: AssistantWorkflowToolContextRequirement[];\n  missingContextRequirements: AssistantWorkflowToolContextRequirement[];\n  blockingReasons: string[];\n  warnings: string[];\n};\n\nexport type AssistantWorkflowExecutionPlan = {\n  intent: string | null;\n  status: AssistantWorkflowExecutionPlanStatus;\n  steps: AssistantWorkflowExecutionStep[];\n  readyToolNames: string[];\n  requiredReadyToolNames: string[];\n  missingCapabilityNames: string[];\n  missingBindingNames: string[];\n  providerMismatchNames: string[];\n  requiredContext: AssistantWorkflowToolContextRequirement[];\n  missingContextRequirements: AssistantWorkflowToolContextRequirement[];\n  missingPlanningSteps: string[];\n  clarificationRuleIds: string[];\n  blockingReasons: string[];\n  warnings: string[];\n  executionHints: AssistantWorkflowDecision[\"plan\"][\"executionHints\"];\n  executionBudget?: AssistantWorkflowExecutionBudget | null;\n  budgetAssessment?: AssistantWorkflowExecutionBudgetAssessment | null;\n  executionPolicy?: AssistantWorkflowExecutionPolicy;\n};\n\nexport type AssistantWorkflowExecutionPlanOptions = {\n  availableContext?: readonly AssistantWorkflowToolContextRequirement[] | null;\n};\n\nexport function buildAssistantWorkflowExecutionPlan(\n  workflow: AssistantWorkflowDefinition<string, string, string, string>,\n  decision: AssistantWorkflowDecision,\n  options: AssistantWorkflowExecutionPlanOptions = {},\n): AssistantWorkflowExecutionPlan {\n  const availableContext = options.availableContext ? new Set(options.availableContext) : null;\n  const selectedStepIds = new Set(decision.plan.steps.map((step) => step.id));\n  const seenStepIds = new Set<string>();\n  const steps = decision.plan.steps.map((step) => {\n    const missingDependencyStepIds = step.dependsOnStepIds.filter((stepId) => !selectedStepIds.has(stepId));\n    const outOfOrderDependencyStepIds = step.dependsOnStepIds.filter(\n      (stepId) => selectedStepIds.has(stepId) && !seenStepIds.has(stepId),\n    );\n    const requiredToolNames = uniqueStrings(step.requiredToolHints);\n    const optionalToolNames = uniqueStrings(step.toolHints).filter((tool) => !requiredToolNames.includes(tool));\n    const toolNames = uniqueStrings([...requiredToolNames, ...optionalToolNames]);\n    const requiredResolution = resolveAssistantWorkflowTools(workflow, requiredToolNames);\n    const optionalResolution = resolveAssistantWorkflowTools(workflow, optionalToolNames);\n    const allResolutions = [...requiredResolution.resolutions, ...optionalResolution.resolutions];\n    const requiredNonReady = requiredResolution.resolutions.filter((resolution) => resolution.status !== \"ready\");\n    const optionalNonReady = optionalResolution.resolutions.filter((resolution) => resolution.status !== \"ready\");\n    const requiredContextGaps = getContextGaps(requiredResolution.resolutions, availableContext);\n    const optionalContextGaps = getContextGaps(optionalResolution.resolutions, availableContext);\n    const contextBlockingReasons = step.optional\n      ? []\n      : buildContextBlockingReasons(step.id, requiredContextGaps);\n    const dependencyReasons = buildDependencyReasons(\n      step.id,\n      missingDependencyStepIds,\n      outOfOrderDependencyStepIds,\n    );\n    const blockingReasons = step.optional\n      ? []\n      : [\n          ...buildToolBlockingReasons(step.id, requiredNonReady),\n          ...contextBlockingReasons,\n          ...dependencyReasons,\n        ];\n    const warnings = [\n      ...buildToolWarnings(step.id, step.optional ? requiredNonReady : []),\n      ...buildToolWarnings(step.id, optionalNonReady),\n      ...buildContextWarnings(step.id, step.optional ? requiredContextGaps : []),\n      ...buildContextWarnings(step.id, optionalContextGaps),\n      ...(step.optional ? dependencyReasons : []),\n    ];\n    const status: AssistantWorkflowExecutionStepStatus =\n      step.optional && (requiredNonReady.length > 0 || requiredContextGaps.length > 0)\n        ? \"optional-skipped\"\n        : blockingReasons.length > 0\n        ? \"blocked\"\n        : optionalNonReady.length > 0 || optionalContextGaps.length > 0\n        ? \"partial\"\n        : \"ready\";\n    const allContextGaps = [...requiredContextGaps, ...optionalContextGaps];\n\n    const result: AssistantWorkflowExecutionStep = {\n      id: step.id,\n      kind: step.kind,\n      optional: step.optional,\n      dependsOnStepIds: [...step.dependsOnStepIds],\n      missingDependencyStepIds,\n      outOfOrderDependencyStepIds,\n      status,\n      toolNames,\n      requiredToolNames,\n      readyToolNames: uniqueStrings(allResolutions\n        .filter((resolution) => resolution.status === \"ready\" && getMissingContextRequirements(resolution, availableContext).length === 0)\n        .map((resolution) => resolution.toolName)),\n      missingCapabilityNames: getResolutionNames(allResolutions, \"missing-capability\"),\n      missingBindingNames: getResolutionNames(allResolutions, \"missing-binding\"),\n      providerMismatchNames: getResolutionNames(allResolutions, \"provider-mismatch\"),\n      requiredContext: uniqueContextRequirements(allResolutions.flatMap((resolution) => resolution.capability?.requiredContext ?? [])),\n      missingContextRequirements: uniqueContextRequirements(allContextGaps.flatMap((gap) => gap.missingContextRequirements)),\n      blockingReasons,\n      warnings,\n    };\n    seenStepIds.add(step.id);\n    return result;\n  });\n\n  const requiredResolution = resolveAssistantWorkflowTools(workflow, decision.requiredToolHints);\n  const requiredContextGaps = getContextGaps(requiredResolution.resolutions, availableContext);\n  const executionPolicy = resolveAssistantWorkflowExecutionPolicy(workflow.executionPolicy);\n  const budgetAssessment = workflow.executionBudget\n    ? buildAssistantWorkflowExecutionBudgetAssessment(workflow.executionBudget, {\n        planningStepCount: steps.length,\n        toolCallCount: getMaximumPlannedToolCalls(workflow, steps, executionPolicy),\n      })\n    : null;\n  const blockingReasons = [\n    ...decision.clarificationPolicy.blockingRuleIds.map((ruleId) => `clarification required: ${ruleId}`),\n    ...decision.plan.missingPlanningSteps.map((stepId) => `missing planning step: ${stepId}`),\n    ...decision.missingRequiredToolHints.map((toolName) => `required tool is unavailable: ${toolName}`),\n    ...buildToolBlockingReasons(\"workflow\", requiredResolution.resolutions.filter((resolution) => resolution.status !== \"ready\")),\n    ...buildContextBlockingReasons(\"workflow\", requiredContextGaps),\n    ...steps.flatMap((step) => step.blockingReasons),\n    ...(budgetAssessment?.violations.map(formatAssistantWorkflowExecutionBudgetViolation) ?? []),\n  ];\n  const warnings = uniqueStrings([\n    ...decision.missingToolHints.map((toolName) => `optional tool is unavailable: ${toolName}`),\n    ...steps.flatMap((step) => step.warnings),\n  ]);\n  const allStepTools = steps.flatMap((step) => step.toolNames);\n  const allResolution = resolveAssistantWorkflowTools(workflow, allStepTools);\n  const allContextGaps = getContextGaps(allResolution.resolutions, availableContext);\n  const status: AssistantWorkflowExecutionPlanStatus =\n    decision.clarificationPolicy.needsClarification\n      ? \"needs-clarification\"\n      : blockingReasons.length > 0\n      ? \"blocked\"\n      : warnings.length > 0 || steps.some((step) => step.status === \"partial\" || step.status === \"optional-skipped\")\n      ? \"partial\"\n      : \"ready\";\n\n  return {\n    intent: decision.intent,\n    status,\n    steps,\n    readyToolNames: uniqueStrings(allResolution.resolutions\n      .filter((resolution) => resolution.status === \"ready\" && getMissingContextRequirements(resolution, availableContext).length === 0)\n      .map((resolution) => resolution.toolName)),\n    requiredReadyToolNames: uniqueStrings(requiredResolution.resolutions\n      .filter((resolution) => resolution.status === \"ready\" && getMissingContextRequirements(resolution, availableContext).length === 0)\n      .map((resolution) => resolution.toolName)),\n    missingCapabilityNames: uniqueStrings([\n      ...allResolution.missingCapabilityNames,\n      ...requiredResolution.missingCapabilityNames,\n    ]),\n    missingBindingNames: uniqueStrings([\n      ...allResolution.missingBindingNames,\n      ...requiredResolution.missingBindingNames,\n    ]),\n    providerMismatchNames: uniqueStrings([\n      ...allResolution.providerMismatchNames,\n      ...requiredResolution.providerMismatchNames,\n    ]),\n    requiredContext: uniqueContextRequirements(allResolution.resolutions.flatMap((resolution) => resolution.capability?.requiredContext ?? [])),\n    missingContextRequirements: uniqueContextRequirements([\n      ...allContextGaps.flatMap((gap) => gap.missingContextRequirements),\n      ...requiredContextGaps.flatMap((gap) => gap.missingContextRequirements),\n    ]),\n    missingPlanningSteps: [...decision.plan.missingPlanningSteps],\n    clarificationRuleIds: [...decision.clarificationPolicy.blockingRuleIds],\n    blockingReasons: uniqueStrings(blockingReasons),\n    warnings,\n    executionHints: decision.plan.executionHints,\n    executionBudget: workflow.executionBudget ? { ...workflow.executionBudget } : null,\n    budgetAssessment,\n    executionPolicy,\n  };\n}\n\nfunction buildDependencyReasons(\n  stepId: string,\n  missingDependencyStepIds: readonly string[],\n  outOfOrderDependencyStepIds: readonly string[],\n): string[] {\n  return [\n    ...missingDependencyStepIds.map((dependencyId) => `${stepId} missing dependency step: ${dependencyId}`),\n    ...outOfOrderDependencyStepIds.map((dependencyId) => `${stepId} dependency must run first: ${dependencyId}`),\n  ];\n}\n\nexport function buildAssistantWorkflowExecutionPlanTracePayload(\n  plan: AssistantWorkflowExecutionPlan,\n): Record<string, unknown> {\n  return {\n    intent: plan.intent,\n    status: plan.status,\n    steps: plan.steps,\n    readyToolNames: plan.readyToolNames,\n    requiredReadyToolNames: plan.requiredReadyToolNames,\n    missingCapabilityNames: plan.missingCapabilityNames,\n    missingBindingNames: plan.missingBindingNames,\n    providerMismatchNames: plan.providerMismatchNames,\n    requiredContext: plan.requiredContext,\n    missingContextRequirements: plan.missingContextRequirements,\n    missingPlanningSteps: plan.missingPlanningSteps,\n    clarificationRuleIds: plan.clarificationRuleIds,\n    blockingReasons: plan.blockingReasons,\n    warnings: plan.warnings,\n    executionHints: plan.executionHints,\n    executionBudget: plan.executionBudget ?? null,\n    budgetAssessment: plan.budgetAssessment\n      ? buildAssistantWorkflowExecutionBudgetTracePayload(plan.budgetAssessment)\n      : null,\n    executionPolicy: plan.executionPolicy ?? resolveAssistantWorkflowExecutionPolicy(),\n  };\n}\n\nfunction getMaximumPlannedToolCalls(\n  workflow: AssistantWorkflowDefinition<string, string, string, string>,\n  steps: readonly AssistantWorkflowExecutionStep[],\n  policy: AssistantWorkflowExecutionPolicy,\n): number {\n  const capabilities = new Map((workflow.tools ?? []).map((tool) => [tool.name, tool] as const));\n  return steps\n    .filter((step) => step.status !== \"blocked\" && step.status !== \"optional-skipped\")\n    .flatMap((step) => step.readyToolNames)\n    .reduce((count, toolName) => {\n      const retryClass = capabilities.get(toolName)?.retryClass;\n      return count + (retryClass === \"never\" ? 1 : policy.maxAttemptsPerTool);\n    }, 0);\n}\n\nfunction buildToolBlockingReasons(stepId: string, resolutions: readonly AssistantWorkflowToolResolution[]): string[] {\n  return resolutions.map((resolution) => `${stepId} required tool ${resolution.toolName} is ${resolution.status}`);\n}\n\nfunction buildToolWarnings(stepId: string, resolutions: readonly AssistantWorkflowToolResolution[]): string[] {\n  return resolutions.map((resolution) => `${stepId} optional tool ${resolution.toolName} is ${resolution.status}`);\n}\n\ntype ToolContextGap = {\n  toolName: string;\n  missingContextRequirements: AssistantWorkflowToolContextRequirement[];\n};\n\nfunction getContextGaps(\n  resolutions: readonly AssistantWorkflowToolResolution[],\n  availableContext: ReadonlySet<AssistantWorkflowToolContextRequirement> | null,\n): ToolContextGap[] {\n  return resolutions\n    .map((resolution) => ({\n      toolName: resolution.toolName,\n      missingContextRequirements: getMissingContextRequirements(resolution, availableContext),\n    }))\n    .filter((gap) => gap.missingContextRequirements.length > 0);\n}\n\nfunction getMissingContextRequirements(\n  resolution: AssistantWorkflowToolResolution,\n  availableContext: ReadonlySet<AssistantWorkflowToolContextRequirement> | null,\n): AssistantWorkflowToolContextRequirement[] {\n  if (!availableContext || resolution.status !== \"ready\") return [];\n  return uniqueContextRequirements(resolution.capability?.requiredContext ?? [])\n    .filter((requirement) => !availableContext.has(requirement));\n}\n\nfunction buildContextBlockingReasons(stepId: string, gaps: readonly ToolContextGap[]): string[] {\n  return gaps.map((gap) =>\n    `${stepId} required tool ${gap.toolName} missing context: ${gap.missingContextRequirements.join(\", \")}`,\n  );\n}\n\nfunction buildContextWarnings(stepId: string, gaps: readonly ToolContextGap[]): string[] {\n  return gaps.map((gap) =>\n    `${stepId} optional tool ${gap.toolName} missing context: ${gap.missingContextRequirements.join(\", \")}`,\n  );\n}\n\nfunction getResolutionNames(\n  resolutions: readonly AssistantWorkflowToolResolution[],\n  status: AssistantWorkflowToolResolution[\"status\"],\n): string[] {\n  return uniqueStrings(\n    resolutions\n      .filter((resolution) => resolution.status === status)\n      .map((resolution) => resolution.toolName),\n  );\n}\n\nfunction uniqueStrings(values: readonly string[]): string[] {\n  const out: string[] = [];\n  const seen = new Set<string>();\n  for (const value of values) {\n    if (seen.has(value)) continue;\n    seen.add(value);\n    out.push(value);\n  }\n  return out;\n}\n\nfunction uniqueContextRequirements(\n  values: readonly AssistantWorkflowToolContextRequirement[],\n): AssistantWorkflowToolContextRequirement[] {\n  const out: AssistantWorkflowToolContextRequirement[] = [];\n  const seen = new Set<AssistantWorkflowToolContextRequirement>();\n  for (const value of values) {\n    if (seen.has(value)) continue;\n    seen.add(value);\n    out.push(value);\n  }\n  return out;\n}\n"]}

package/dist/execution-policy.d.ts

@@ -0,0 +1,9 @@
+export type AssistantWorkflowExecutionFailureMode = "fail-fast" | "continue-independent";
+export type AssistantWorkflowExecutionPolicy = {
+    failureMode: AssistantWorkflowExecutionFailureMode;
+    maxAttemptsPerTool: 1 | 2 | 3;
+};
+export declare const DEFAULT_ASSISTANT_WORKFLOW_EXECUTION_POLICY: AssistantWorkflowExecutionPolicy;
+export declare function assertAssistantWorkflowExecutionPolicy(policy: AssistantWorkflowExecutionPolicy): void;
+export declare function resolveAssistantWorkflowExecutionPolicy(policy?: AssistantWorkflowExecutionPolicy | null): AssistantWorkflowExecutionPolicy;
+//# sourceMappingURL=execution-policy.d.ts.map

package/dist/execution-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-policy.d.ts","sourceRoot":"","sources":["../src/execution-policy.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qCAAqC,GAC7C,WAAW,GACX,sBAAsB,CAAC;AAE3B,MAAM,MAAM,gCAAgC,GAAG;IAC7C,WAAW,EAAE,qCAAqC,CAAC;IACnD,kBAAkB,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CAC/B,CAAC;AAEF,eAAO,MAAM,2CAA2C,EAAE,gCAItD,CAAC;AAEL,wBAAgB,sCAAsC,CACpD,MAAM,EAAE,gCAAgC,GACvC,IAAI,CAWN;AAED,wBAAgB,uCAAuC,CACrD,MAAM,CAAC,EAAE,gCAAgC,GAAG,IAAI,GAC/C,gCAAgC,CAIlC"}

package/dist/execution-policy.js

@@ -0,0 +1,21 @@
+export const DEFAULT_ASSISTANT_WORKFLOW_EXECUTION_POLICY = Object.freeze({
+    failureMode: "fail-fast",
+    maxAttemptsPerTool: 1,
+});
+export function assertAssistantWorkflowExecutionPolicy(policy) {
+    if (policy.failureMode !== "fail-fast" && policy.failureMode !== "continue-independent") {
+        throw new Error("Assistant workflow execution policy failureMode is invalid.");
+    }
+    if (policy.maxAttemptsPerTool !== 1 &&
+        policy.maxAttemptsPerTool !== 2 &&
+        policy.maxAttemptsPerTool !== 3) {
+        throw new Error("Assistant workflow execution policy maxAttemptsPerTool must be 1, 2, or 3.");
+    }
+}
+export function resolveAssistantWorkflowExecutionPolicy(policy) {
+    if (!policy)
+        return { ...DEFAULT_ASSISTANT_WORKFLOW_EXECUTION_POLICY };
+    assertAssistantWorkflowExecutionPolicy(policy);
+    return { ...policy };
+}
+//# sourceMappingURL=execution-policy.js.map

package/dist/execution-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-policy.js","sourceRoot":"","sources":["../src/execution-policy.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,2CAA2C,GACtD,MAAM,CAAC,MAAM,CAAC;IACZ,WAAW,EAAE,WAAW;IACxB,kBAAkB,EAAE,CAAC;CACtB,CAAC,CAAC;AAEL,MAAM,UAAU,sCAAsC,CACpD,MAAwC;IAExC,IAAI,MAAM,CAAC,WAAW,KAAK,WAAW,IAAI,MAAM,CAAC,WAAW,KAAK,sBAAsB,EAAE,CAAC;QACxF,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IACD,IACE,MAAM,CAAC,kBAAkB,KAAK,CAAC;QAC/B,MAAM,CAAC,kBAAkB,KAAK,CAAC;QAC/B,MAAM,CAAC,kBAAkB,KAAK,CAAC,EAC/B,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAC;IAChG,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uCAAuC,CACrD,MAAgD;IAEhD,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,GAAG,2CAA2C,EAAE,CAAC;IACvE,sCAAsC,CAAC,MAAM,CAAC,CAAC;IAC/C,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC;AACvB,CAAC","sourcesContent":["export type AssistantWorkflowExecutionFailureMode =\n  | \"fail-fast\"\n  | \"continue-independent\";\n\nexport type AssistantWorkflowExecutionPolicy = {\n  failureMode: AssistantWorkflowExecutionFailureMode;\n  maxAttemptsPerTool: 1 | 2 | 3;\n};\n\nexport const DEFAULT_ASSISTANT_WORKFLOW_EXECUTION_POLICY: AssistantWorkflowExecutionPolicy =\n  Object.freeze({\n    failureMode: \"fail-fast\",\n    maxAttemptsPerTool: 1,\n  });\n\nexport function assertAssistantWorkflowExecutionPolicy(\n  policy: AssistantWorkflowExecutionPolicy,\n): void {\n  if (policy.failureMode !== \"fail-fast\" && policy.failureMode !== \"continue-independent\") {\n    throw new Error(\"Assistant workflow execution policy failureMode is invalid.\");\n  }\n  if (\n    policy.maxAttemptsPerTool !== 1 &&\n    policy.maxAttemptsPerTool !== 2 &&\n    policy.maxAttemptsPerTool !== 3\n  ) {\n    throw new Error(\"Assistant workflow execution policy maxAttemptsPerTool must be 1, 2, or 3.\");\n  }\n}\n\nexport function resolveAssistantWorkflowExecutionPolicy(\n  policy?: AssistantWorkflowExecutionPolicy | null,\n): AssistantWorkflowExecutionPolicy {\n  if (!policy) return { ...DEFAULT_ASSISTANT_WORKFLOW_EXECUTION_POLICY };\n  assertAssistantWorkflowExecutionPolicy(policy);\n  return { ...policy };\n}\n"]}

package/dist/index.d.ts

@@ -35,6 +35,8 @@ export * from "./eval-result.js";
 export * from "./eval-runner.js";
 export * from "./eval-suite.js";
 export * from "./execution-plan.js";
+export * from "./execution-budget.js";
+export * from "./execution-policy.js";
 export * from "./hosted-tool-policy.js";
 export * from "./memory-policy.js";
 export * from "./memory-updates.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kCAAkC,CAAC;AACjD,cAAc,wCAAwC,CAAC;AACvD,cAAc,0CAA0C,CAAC;AACzD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oCAAoC,CAAC;AACnD,cAAc,mCAAmC,CAAC;AAClD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wCAAwC,CAAC;AACvD,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kCAAkC,CAAC;AACjD,cAAc,wCAAwC,CAAC;AACvD,cAAc,0CAA0C,CAAC;AACzD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oCAAoC,CAAC;AACnD,cAAc,mCAAmC,CAAC;AAClD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wCAAwC,CAAC;AACvD,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -35,6 +35,8 @@ export * from "./eval-result.js";
 export * from "./eval-runner.js";
 export * from "./eval-suite.js";
 export * from "./execution-plan.js";
+export * from "./execution-budget.js";
+export * from "./execution-policy.js";
 export * from "./hosted-tool-policy.js";
 export * from "./memory-policy.js";
 export * from "./memory-updates.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kCAAkC,CAAC;AACjD,cAAc,wCAAwC,CAAC;AACvD,cAAc,0CAA0C,CAAC;AACzD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oCAAoC,CAAC;AACnD,cAAc,mCAAmC,CAAC;AAClD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wCAAwC,CAAC;AACvD,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC","sourcesContent":["export * from \"./clarification-policy.js\";\nexport * from \"./decision.js\";\nexport * from \"./definition.js\";\nexport * from \"./definition-catalog.js\";\nexport * from \"./definition-catalog-replay.js\";\nexport * from \"./definition-diagnostics.js\";\nexport * from \"./definition-diff.js\";\nexport * from \"./definition-json.js\";\nexport * from \"./definition-manifest.js\";\nexport * from \"./definition-package.js\";\nexport * from \"./definition-package-executor.js\";\nexport * from \"./definition-package-execution-json.js\";\nexport * from \"./definition-package-execution-replay.js\";\nexport * from \"./definition-package-loader.js\";\nexport * from \"./definition-package-resolver.js\";\nexport * from \"./definition-package-review.js\";\nexport * from \"./definition-package-replay.js\";\nexport * from \"./definition-package-run.js\";\nexport * from \"./definition-package-run-report.js\";\nexport * from \"./definition-package-selection.js\";\nexport * from \"./definition-package-smoke.js\";\nexport * from \"./definition-tuning.js\";\nexport * from \"./definition-tuning-approval.js\";\nexport * from \"./definition-tuning-json.js\";\nexport * from \"./definition-tuning-promotion.js\";\nexport * from \"./definition-tuning-replay.js\";\nexport * from \"./definition-tuning-review.js\";\nexport * from \"./definition-tuning-review-artifact.js\";\nexport * from \"./definition-tuning-source-patch.js\";\nexport * from \"./direct-route-invocation.js\";\nexport * from \"./direct-route-policy.js\";\nexport * from \"./eval-case.js\";\nexport * from \"./eval-replay.js\";\nexport * from \"./eval-result.js\";\nexport * from \"./eval-runner.js\";\nexport * from \"./eval-suite.js\";\nexport * from \"./execution-plan.js\";\nexport * from \"./hosted-tool-policy.js\";\nexport * from \"./memory-policy.js\";\nexport * from \"./memory-updates.js\";\nexport * from \"./outcome.js\";\nexport * from \"./outcome-trace.js\";\nexport * from \"./policy-resolution.js\";\nexport * from \"./planner-compiler.js\";\nexport * from \"./planning.js\";\nexport * from \"./run.js\";\nexport * from \"./run-parity.js\";\nexport * from \"./run-evaluation.js\";\nexport * from \"./run-report.js\";\nexport * from \"./run-report-batch.js\";\nexport * from \"./run-report-json.js\";\nexport * from \"./tool-invocations.js\";\nexport * from \"./tool-handoffs.js\";\nexport * from \"./tool-provider-executors.js\";\nexport * from \"./tool-result-cache.js\";\nexport * from \"./tool-runtime.js\";\nexport * from \"./tool-selection-evaluation.js\";\nexport * from \"./tool-selection-json.js\";\nexport * from \"./tool-selection-policy.js\";\nexport * from \"./tool-selection-rules.js\";\nexport * from \"./tool-selection-replay.js\";\nexport * from \"./tool-selection-trace-export.js\";\nexport * from \"./tool-results.js\";\nexport * from \"./trace-events.js\";\nexport * from \"./trace-payload.js\";\nexport * from \"./trace-stages.js\";\nexport * from \"./trace-report.js\";\nexport * from \"./trace-replay.js\";\nexport * from \"./tool-bindings.js\";\nexport * from \"./tool-capabilities.js\";\nexport * from \"./tool-executor.js\";\nexport * from \"./tool-evidence.js\";\nexport * from \"./tool-fixtures.js\";\nexport * from \"./value-readers.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kCAAkC,CAAC;AACjD,cAAc,wCAAwC,CAAC;AACvD,cAAc,0CAA0C,CAAC;AACzD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oCAAoC,CAAC;AACnD,cAAc,mCAAmC,CAAC;AAClD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wCAAwC,CAAC;AACvD,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC","sourcesContent":["export * from \"./clarification-policy.js\";\nexport * from \"./decision.js\";\nexport * from \"./definition.js\";\nexport * from \"./definition-catalog.js\";\nexport * from \"./definition-catalog-replay.js\";\nexport * from \"./definition-diagnostics.js\";\nexport * from \"./definition-diff.js\";\nexport * from \"./definition-json.js\";\nexport * from \"./definition-manifest.js\";\nexport * from \"./definition-package.js\";\nexport * from \"./definition-package-executor.js\";\nexport * from \"./definition-package-execution-json.js\";\nexport * from \"./definition-package-execution-replay.js\";\nexport * from \"./definition-package-loader.js\";\nexport * from \"./definition-package-resolver.js\";\nexport * from \"./definition-package-review.js\";\nexport * from \"./definition-package-replay.js\";\nexport * from \"./definition-package-run.js\";\nexport * from \"./definition-package-run-report.js\";\nexport * from \"./definition-package-selection.js\";\nexport * from \"./definition-package-smoke.js\";\nexport * from \"./definition-tuning.js\";\nexport * from \"./definition-tuning-approval.js\";\nexport * from \"./definition-tuning-json.js\";\nexport * from \"./definition-tuning-promotion.js\";\nexport * from \"./definition-tuning-replay.js\";\nexport * from \"./definition-tuning-review.js\";\nexport * from \"./definition-tuning-review-artifact.js\";\nexport * from \"./definition-tuning-source-patch.js\";\nexport * from \"./direct-route-invocation.js\";\nexport * from \"./direct-route-policy.js\";\nexport * from \"./eval-case.js\";\nexport * from \"./eval-replay.js\";\nexport * from \"./eval-result.js\";\nexport * from \"./eval-runner.js\";\nexport * from \"./eval-suite.js\";\nexport * from \"./execution-plan.js\";\nexport * from \"./execution-budget.js\";\nexport * from \"./execution-policy.js\";\nexport * from \"./hosted-tool-policy.js\";\nexport * from \"./memory-policy.js\";\nexport * from \"./memory-updates.js\";\nexport * from \"./outcome.js\";\nexport * from \"./outcome-trace.js\";\nexport * from \"./policy-resolution.js\";\nexport * from \"./planner-compiler.js\";\nexport * from \"./planning.js\";\nexport * from \"./run.js\";\nexport * from \"./run-parity.js\";\nexport * from \"./run-evaluation.js\";\nexport * from \"./run-report.js\";\nexport * from \"./run-report-batch.js\";\nexport * from \"./run-report-json.js\";\nexport * from \"./tool-invocations.js\";\nexport * from \"./tool-handoffs.js\";\nexport * from \"./tool-provider-executors.js\";\nexport * from \"./tool-result-cache.js\";\nexport * from \"./tool-runtime.js\";\nexport * from \"./tool-selection-evaluation.js\";\nexport * from \"./tool-selection-json.js\";\nexport * from \"./tool-selection-policy.js\";\nexport * from \"./tool-selection-rules.js\";\nexport * from \"./tool-selection-replay.js\";\nexport * from \"./tool-selection-trace-export.js\";\nexport * from \"./tool-results.js\";\nexport * from \"./trace-events.js\";\nexport * from \"./trace-payload.js\";\nexport * from \"./trace-stages.js\";\nexport * from \"./trace-report.js\";\nexport * from \"./trace-replay.js\";\nexport * from \"./tool-bindings.js\";\nexport * from \"./tool-capabilities.js\";\nexport * from \"./tool-executor.js\";\nexport * from \"./tool-evidence.js\";\nexport * from \"./tool-fixtures.js\";\nexport * from \"./value-readers.js\";\n"]}

package/dist/planning.d.ts

@@ -3,6 +3,7 @@ export type AssistantWorkflowPlanStepTrace = {
     id: string;
     kind: AssistantWorkflowPlanningStepKind;
     optional: boolean;
+    dependsOnStepIds: string[];
     toolHints: string[];
     requiredToolHints: string[];
 };

package/dist/planning.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"planning.d.ts","sourceRoot":"","sources":["../src/planning.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,2BAA2B,EAEhC,KAAK,uCAAuC,EAC5C,KAAK,iCAAiC,EACvC,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,8BAA8B,GAAG;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,iCAAiC,CAAC;IACxC,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,mCAAmC,GAAG;IAChD,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,8BAA8B,EAAE,CAAC;IACxC,4BAA4B,EAAE,MAAM,EAAE,CAAC;IACvC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,wBAAwB,EAAE,MAAM,EAAE,CAAC;IACnC,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,cAAc,EAAE,mCAAmC,CAAC;CACrD,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IACzC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACrE,MAAM,EAAE,OAAO,GACd,uCAAuC,GAAG,IAAI,CAIhD;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACrE,QAAQ,EAAE,OAAO,EACjB,kBAAkB,GAAE,SAAS,MAAM,EAAO,EAC1C,OAAO,GAAE,4BAAiC,GACzC,qBAAqB,CAkEvB"}
+{"version":3,"file":"planning.d.ts","sourceRoot":"","sources":["../src/planning.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,2BAA2B,EAEhC,KAAK,uCAAuC,EAC5C,KAAK,iCAAiC,EACvC,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,8BAA8B,GAAG;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,iCAAiC,CAAC;IACxC,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,mCAAmC,GAAG;IAChD,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,8BAA8B,EAAE,CAAC;IACxC,4BAA4B,EAAE,MAAM,EAAE,CAAC;IACvC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,wBAAwB,EAAE,MAAM,EAAE,CAAC;IACnC,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,cAAc,EAAE,mCAAmC,CAAC;CACrD,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IACzC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACrE,MAAM,EAAE,OAAO,GACd,uCAAuC,GAAG,IAAI,CAIhD;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACrE,QAAQ,EAAE,OAAO,EACjB,kBAAkB,GAAE,SAAS,MAAM,EAAO,EAC1C,OAAO,GAAE,4BAAiC,GACzC,qBAAqB,CAmEvB"}

package/dist/planning.js

@@ -48,6 +48,7 @@ export function buildAssistantWorkflowPlan(workflow, intentId, availableToolName
             id: step.id,
             kind: step.kind,
             optional: step.optional === true,
+            dependsOnStepIds: uniqueStrings(step.dependsOn ?? []),
             toolHints: filterToolNames(step.toolHints ?? [], availableSet),
             requiredToolHints: filterToolNames(step.requiredToolHints ?? [], availableSet),
         })),

package/dist/planning.js.map

@@ -1 +1 @@
-{"version":3,"file":"planning.js","sourceRoot":"","sources":["../src/planning.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  findAssistantWorkflowIntent,\n  normalizeAssistantWorkflowId,\n  type AssistantWorkflowDefinition,\n  type AssistantWorkflowPlanningStepProfile,\n  type AssistantWorkflowPlanningStepDefinition,\n  type AssistantWorkflowPlanningStepKind,\n} from \"./definition.js\";\n\nexport type AssistantWorkflowPlanStepTrace = {\n  id: string;\n  kind: AssistantWorkflowPlanningStepKind;\n  optional: boolean;\n  toolHints: string[];\n  requiredToolHints: string[];\n};\n\nexport type AssistantWorkflowPlanExecutionHints = {\n  needsClarification: boolean;\n  needsSynthesis: boolean;\n  producesArtifact: boolean;\n  mayGenerate: boolean;\n};\n\nexport type AssistantWorkflowPlan = {\n  stepIds: string[];\n  steps: AssistantWorkflowPlanStepTrace[];\n  activePlanningStepProfileIds: string[];\n  profileStepIds: string[];\n  toolHints: string[];\n  requiredToolHints: string[];\n  missingToolHints: string[];\n  missingRequiredToolHints: string[];\n  missingPlanningSteps: string[];\n  executionHints: AssistantWorkflowPlanExecutionHints;\n};\n\nexport type AssistantWorkflowPlanContext = {\n  subintent?: string | null;\n  presentation?: string | null;\n  timeWindowHint?: string | null;\n  toolsToExpose?: readonly string[] | null;\n  confidence?: number | null;\n};\n\nexport function findAssistantWorkflowPlanningStep(\n  workflow: AssistantWorkflowDefinition<string, string, string, string>,\n  stepId: unknown,\n): AssistantWorkflowPlanningStepDefinition | null {\n  const normalized = normalizeAssistantWorkflowId(stepId);\n  if (!normalized) return null;\n  return (workflow.planningSteps ?? []).find((step) => step.id === normalized) ?? null;\n}\n\nexport function buildAssistantWorkflowPlan(\n  workflow: AssistantWorkflowDefinition<string, string, string, string>,\n  intentId: unknown,\n  availableToolNames: readonly string[] = [],\n  context: AssistantWorkflowPlanContext = {},\n): AssistantWorkflowPlan {\n  const intent = findAssistantWorkflowIntent(workflow, intentId);\n  const stepsById = new Map((workflow.planningSteps ?? []).map((step) => [step.id, step] as const));\n  const availableSet = new Set(availableToolNames);\n  const steps: AssistantWorkflowPlanningStepDefinition[] = [];\n  const missingPlanningSteps: string[] = [];\n  const activePlanningStepProfileIds: string[] = [];\n  const profileStepIds: string[] = [];\n  const seen = new Set<string>();\n  const baseStepIds = [...(intent?.planningSteps ?? [])];\n  const conditionalStepIds = collectProfilePlanningStepIds(\n    intent?.planningStepProfiles ?? [],\n    context,\n    activePlanningStepProfileIds,\n  );\n  const orderedStepIds = insertConditionalStepsBeforeSynthesis(baseStepIds, conditionalStepIds, stepsById);\n\n  for (const rawStepId of orderedStepIds) {\n    const stepId = normalizeAssistantWorkflowId(rawStepId);\n    if (!stepId || seen.has(stepId)) continue;\n    seen.add(stepId);\n    const step = stepsById.get(stepId);\n    if (step) {\n      steps.push(step);\n      if (!profileStepIds.includes(stepId) && activePlanningStepProfileIds.length > 0) {\n        const fromProfile = (intent?.planningStepProfiles ?? [])\n          .filter((profile) => activePlanningStepProfileIds.includes(profile.id))\n          .some((profile) => profile.planningSteps.includes(stepId));\n        if (fromProfile && !baseStepIds.includes(stepId)) {\n          profileStepIds.push(stepId);\n        }\n      }\n    } else {\n      missingPlanningSteps.push(stepId);\n    }\n  }\n\n  const rawToolHints = uniqueStrings(steps.flatMap((step) => step.toolHints ?? []));\n  const rawRequiredToolHints = uniqueStrings(steps.flatMap((step) => step.requiredToolHints ?? []));\n  const toolHints = filterToolNames(rawToolHints, availableSet);\n  const requiredToolHints = filterToolNames(rawRequiredToolHints, availableSet);\n\n  return {\n    stepIds: steps.map((step) => step.id),\n    steps: steps.map((step) => ({\n      id: step.id,\n      kind: step.kind,\n      optional: step.optional === true,\n      toolHints: filterToolNames(step.toolHints ?? [], availableSet),\n      requiredToolHints: filterToolNames(step.requiredToolHints ?? [], availableSet),\n    })),\n    activePlanningStepProfileIds,\n    profileStepIds,\n    toolHints,\n    requiredToolHints,\n    missingToolHints: availableSet.size === 0 ? [] : rawToolHints.filter((tool) => !availableSet.has(tool)),\n    missingRequiredToolHints:\n      availableSet.size === 0 ? [] : rawRequiredToolHints.filter((tool) => !availableSet.has(tool)),\n    missingPlanningSteps,\n    executionHints: {\n      needsClarification: steps.some((step) => step.kind === \"ask_clarification\"),\n      needsSynthesis: steps.some((step) => step.kind === \"synthesize\"),\n      producesArtifact: steps.some((step) => step.kind === \"build_artifact\" || step.kind === \"generate\"),\n      mayGenerate: steps.some((step) => step.kind === \"generate\"),\n    },\n  };\n}\n\nfunction insertConditionalStepsBeforeSynthesis(\n  baseStepIds: readonly string[],\n  conditionalStepIds: readonly string[],\n  stepsById: ReadonlyMap<string, AssistantWorkflowPlanningStepDefinition>,\n): string[] {\n  if (!conditionalStepIds.length) return [...baseStepIds];\n  const insertIndex = baseStepIds.findIndex((rawStepId) => {\n    const stepId = normalizeAssistantWorkflowId(rawStepId);\n    const kind = stepId ? stepsById.get(stepId)?.kind : null;\n    return kind === \"build_artifact\" || kind === \"generate\" || kind === \"synthesize\";\n  });\n  if (insertIndex < 0) return [...baseStepIds, ...conditionalStepIds];\n  return [\n    ...baseStepIds.slice(0, insertIndex),\n    ...conditionalStepIds,\n    ...baseStepIds.slice(insertIndex),\n  ];\n}\n\nfunction collectProfilePlanningStepIds(\n  profiles: readonly AssistantWorkflowPlanningStepProfile[],\n  context: AssistantWorkflowPlanContext,\n  activeProfileIds: string[],\n): string[] {\n  const out: string[] = [];\n  for (const profile of profiles) {\n    if (!matchesPlanningStepProfile(profile, context)) continue;\n    activeProfileIds.push(profile.id);\n    out.push(...profile.planningSteps);\n  }\n  return out;\n}\n\nfunction matchesPlanningStepProfile(\n  profile: AssistantWorkflowPlanningStepProfile,\n  context: AssistantWorkflowPlanContext,\n): boolean {\n  const condition = profile.condition;\n  if (!condition) return true;\n  if (condition.subintent !== undefined && normalizeAssistantWorkflowId(context.subintent) !== condition.subintent) {\n    return false;\n  }\n  if (condition.presentation !== undefined && normalizeAssistantWorkflowId(context.presentation) !== condition.presentation) {\n    return false;\n  }\n  if (condition.timeWindowHint !== undefined && normalizeAssistantWorkflowId(context.timeWindowHint) !== condition.timeWindowHint) {\n    return false;\n  }\n  if (condition.minConfidence !== undefined) {\n    if (typeof context.confidence !== \"number\" || context.confidence < condition.minConfidence) return false;\n  }\n  if (condition.maxConfidence !== undefined) {\n    if (typeof context.confidence !== \"number\" || context.confidence > condition.maxConfidence) return false;\n  }\n  const requiredTools = condition.requiredTools ?? [];\n  if (requiredTools.length > 0) {\n    const tools = new Set(uniqueStrings(context.toolsToExpose ?? []));\n    if (!requiredTools.every((tool) => tools.has(tool))) return false;\n  }\n  return true;\n}\n\nfunction filterToolNames(rawTools: readonly string[], availableSet: ReadonlySet<string>): string[] {\n  if (availableSet.size === 0) return uniqueStrings(rawTools);\n  return uniqueStrings(rawTools).filter((tool) => availableSet.has(tool));\n}\n\nfunction uniqueStrings(values: readonly string[]): string[] {\n  const out: string[] = [];\n  const seen = new Set<string>();\n  for (const value of values) {\n    const normalized = normalizeAssistantWorkflowId(value);\n    if (!normalized || seen.has(normalized)) continue;\n    seen.add(normalized);\n    out.push(normalized);\n  }\n  return out;\n}\n"]}
+{"version":3,"file":"planning.js","sourceRoot":"","sources":["../src/planning.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  findAssistantWorkflowIntent,\n  normalizeAssistantWorkflowId,\n  type AssistantWorkflowDefinition,\n  type AssistantWorkflowPlanningStepProfile,\n  type AssistantWorkflowPlanningStepDefinition,\n  type AssistantWorkflowPlanningStepKind,\n} from \"./definition.js\";\n\nexport type AssistantWorkflowPlanStepTrace = {\n  id: string;\n  kind: AssistantWorkflowPlanningStepKind;\n  optional: boolean;\n  dependsOnStepIds: string[];\n  toolHints: string[];\n  requiredToolHints: string[];\n};\n\nexport type AssistantWorkflowPlanExecutionHints = {\n  needsClarification: boolean;\n  needsSynthesis: boolean;\n  producesArtifact: boolean;\n  mayGenerate: boolean;\n};\n\nexport type AssistantWorkflowPlan = {\n  stepIds: string[];\n  steps: AssistantWorkflowPlanStepTrace[];\n  activePlanningStepProfileIds: string[];\n  profileStepIds: string[];\n  toolHints: string[];\n  requiredToolHints: string[];\n  missingToolHints: string[];\n  missingRequiredToolHints: string[];\n  missingPlanningSteps: string[];\n  executionHints: AssistantWorkflowPlanExecutionHints;\n};\n\nexport type AssistantWorkflowPlanContext = {\n  subintent?: string | null;\n  presentation?: string | null;\n  timeWindowHint?: string | null;\n  toolsToExpose?: readonly string[] | null;\n  confidence?: number | null;\n};\n\nexport function findAssistantWorkflowPlanningStep(\n  workflow: AssistantWorkflowDefinition<string, string, string, string>,\n  stepId: unknown,\n): AssistantWorkflowPlanningStepDefinition | null {\n  const normalized = normalizeAssistantWorkflowId(stepId);\n  if (!normalized) return null;\n  return (workflow.planningSteps ?? []).find((step) => step.id === normalized) ?? null;\n}\n\nexport function buildAssistantWorkflowPlan(\n  workflow: AssistantWorkflowDefinition<string, string, string, string>,\n  intentId: unknown,\n  availableToolNames: readonly string[] = [],\n  context: AssistantWorkflowPlanContext = {},\n): AssistantWorkflowPlan {\n  const intent = findAssistantWorkflowIntent(workflow, intentId);\n  const stepsById = new Map((workflow.planningSteps ?? []).map((step) => [step.id, step] as const));\n  const availableSet = new Set(availableToolNames);\n  const steps: AssistantWorkflowPlanningStepDefinition[] = [];\n  const missingPlanningSteps: string[] = [];\n  const activePlanningStepProfileIds: string[] = [];\n  const profileStepIds: string[] = [];\n  const seen = new Set<string>();\n  const baseStepIds = [...(intent?.planningSteps ?? [])];\n  const conditionalStepIds = collectProfilePlanningStepIds(\n    intent?.planningStepProfiles ?? [],\n    context,\n    activePlanningStepProfileIds,\n  );\n  const orderedStepIds = insertConditionalStepsBeforeSynthesis(baseStepIds, conditionalStepIds, stepsById);\n\n  for (const rawStepId of orderedStepIds) {\n    const stepId = normalizeAssistantWorkflowId(rawStepId);\n    if (!stepId || seen.has(stepId)) continue;\n    seen.add(stepId);\n    const step = stepsById.get(stepId);\n    if (step) {\n      steps.push(step);\n      if (!profileStepIds.includes(stepId) && activePlanningStepProfileIds.length > 0) {\n        const fromProfile = (intent?.planningStepProfiles ?? [])\n          .filter((profile) => activePlanningStepProfileIds.includes(profile.id))\n          .some((profile) => profile.planningSteps.includes(stepId));\n        if (fromProfile && !baseStepIds.includes(stepId)) {\n          profileStepIds.push(stepId);\n        }\n      }\n    } else {\n      missingPlanningSteps.push(stepId);\n    }\n  }\n\n  const rawToolHints = uniqueStrings(steps.flatMap((step) => step.toolHints ?? []));\n  const rawRequiredToolHints = uniqueStrings(steps.flatMap((step) => step.requiredToolHints ?? []));\n  const toolHints = filterToolNames(rawToolHints, availableSet);\n  const requiredToolHints = filterToolNames(rawRequiredToolHints, availableSet);\n\n  return {\n    stepIds: steps.map((step) => step.id),\n    steps: steps.map((step) => ({\n      id: step.id,\n      kind: step.kind,\n      optional: step.optional === true,\n      dependsOnStepIds: uniqueStrings(step.dependsOn ?? []),\n      toolHints: filterToolNames(step.toolHints ?? [], availableSet),\n      requiredToolHints: filterToolNames(step.requiredToolHints ?? [], availableSet),\n    })),\n    activePlanningStepProfileIds,\n    profileStepIds,\n    toolHints,\n    requiredToolHints,\n    missingToolHints: availableSet.size === 0 ? [] : rawToolHints.filter((tool) => !availableSet.has(tool)),\n    missingRequiredToolHints:\n      availableSet.size === 0 ? [] : rawRequiredToolHints.filter((tool) => !availableSet.has(tool)),\n    missingPlanningSteps,\n    executionHints: {\n      needsClarification: steps.some((step) => step.kind === \"ask_clarification\"),\n      needsSynthesis: steps.some((step) => step.kind === \"synthesize\"),\n      producesArtifact: steps.some((step) => step.kind === \"build_artifact\" || step.kind === \"generate\"),\n      mayGenerate: steps.some((step) => step.kind === \"generate\"),\n    },\n  };\n}\n\nfunction insertConditionalStepsBeforeSynthesis(\n  baseStepIds: readonly string[],\n  conditionalStepIds: readonly string[],\n  stepsById: ReadonlyMap<string, AssistantWorkflowPlanningStepDefinition>,\n): string[] {\n  if (!conditionalStepIds.length) return [...baseStepIds];\n  const insertIndex = baseStepIds.findIndex((rawStepId) => {\n    const stepId = normalizeAssistantWorkflowId(rawStepId);\n    const kind = stepId ? stepsById.get(stepId)?.kind : null;\n    return kind === \"build_artifact\" || kind === \"generate\" || kind === \"synthesize\";\n  });\n  if (insertIndex < 0) return [...baseStepIds, ...conditionalStepIds];\n  return [\n    ...baseStepIds.slice(0, insertIndex),\n    ...conditionalStepIds,\n    ...baseStepIds.slice(insertIndex),\n  ];\n}\n\nfunction collectProfilePlanningStepIds(\n  profiles: readonly AssistantWorkflowPlanningStepProfile[],\n  context: AssistantWorkflowPlanContext,\n  activeProfileIds: string[],\n): string[] {\n  const out: string[] = [];\n  for (const profile of profiles) {\n    if (!matchesPlanningStepProfile(profile, context)) continue;\n    activeProfileIds.push(profile.id);\n    out.push(...profile.planningSteps);\n  }\n  return out;\n}\n\nfunction matchesPlanningStepProfile(\n  profile: AssistantWorkflowPlanningStepProfile,\n  context: AssistantWorkflowPlanContext,\n): boolean {\n  const condition = profile.condition;\n  if (!condition) return true;\n  if (condition.subintent !== undefined && normalizeAssistantWorkflowId(context.subintent) !== condition.subintent) {\n    return false;\n  }\n  if (condition.presentation !== undefined && normalizeAssistantWorkflowId(context.presentation) !== condition.presentation) {\n    return false;\n  }\n  if (condition.timeWindowHint !== undefined && normalizeAssistantWorkflowId(context.timeWindowHint) !== condition.timeWindowHint) {\n    return false;\n  }\n  if (condition.minConfidence !== undefined) {\n    if (typeof context.confidence !== \"number\" || context.confidence < condition.minConfidence) return false;\n  }\n  if (condition.maxConfidence !== undefined) {\n    if (typeof context.confidence !== \"number\" || context.confidence > condition.maxConfidence) return false;\n  }\n  const requiredTools = condition.requiredTools ?? [];\n  if (requiredTools.length > 0) {\n    const tools = new Set(uniqueStrings(context.toolsToExpose ?? []));\n    if (!requiredTools.every((tool) => tools.has(tool))) return false;\n  }\n  return true;\n}\n\nfunction filterToolNames(rawTools: readonly string[], availableSet: ReadonlySet<string>): string[] {\n  if (availableSet.size === 0) return uniqueStrings(rawTools);\n  return uniqueStrings(rawTools).filter((tool) => availableSet.has(tool));\n}\n\nfunction uniqueStrings(values: readonly string[]): string[] {\n  const out: string[] = [];\n  const seen = new Set<string>();\n  for (const value of values) {\n    const normalized = normalizeAssistantWorkflowId(value);\n    if (!normalized || seen.has(normalized)) continue;\n    seen.add(normalized);\n    out.push(normalized);\n  }\n  return out;\n}\n"]}

package/dist/tool-executor.d.ts

@@ -1,11 +1,14 @@
 import type { AssistantWorkflowToolBindingDefinition, AssistantWorkflowToolCapabilityDefinition, AssistantWorkflowToolProvider } from "./definition.js";
 import type { AssistantWorkflowToolInvocation, AssistantWorkflowToolInvocationQueue } from "./tool-invocations.js";
+import { type AssistantWorkflowExecutionBudget, type AssistantWorkflowExecutionBudgetAssessment } from "./execution-budget.js";
 export type { AssistantWorkflowToolInvocation, AssistantWorkflowToolInvocationQueue, } from "./tool-invocations.js";
 import { type AssistantWorkflowToolResult, type AssistantWorkflowToolResultSummary } from "./tool-results.js";
 export type AssistantWorkflowToolExecutorContext = {
     invocationIndex: number;
     queueStatus: AssistantWorkflowToolInvocationQueue["status"];
     args: AssistantWorkflowToolInvocationArgs;
+    attempt?: number;
+    maxAttempts?: number;
 };
 export type AssistantWorkflowToolInvocationArgs = Readonly<Record<string, unknown>>;
 export type AssistantWorkflowToolInvocationArgsById = Readonly<Record<string, AssistantWorkflowToolInvocationArgs>>;
@@ -38,6 +41,8 @@ export type AssistantWorkflowToolExecutionEvent = {
     durationMs: number | null;
     errorMessage: string | null;
     retryable: boolean | null;
+    attempt?: number;
+    maxAttempts?: number;
 };
 export type AssistantWorkflowToolExecutionOptions = {
     continueOnError?: boolean;
@@ -45,11 +50,13 @@ export type AssistantWorkflowToolExecutionOptions = {
     now?: () => number;
     argsByInvocationId?: AssistantWorkflowToolInvocationArgsById;
     onEvent?: (event: AssistantWorkflowToolExecutionEvent) => void;
+    executionBudget?: AssistantWorkflowExecutionBudget;
 };
 export type AssistantWorkflowToolExecutionReport = {
     queue: AssistantWorkflowToolInvocationQueue;
     results: AssistantWorkflowToolResult[];
     summary: AssistantWorkflowToolResultSummary;
+    budgetAssessment?: AssistantWorkflowExecutionBudgetAssessment | null;
 };
 /**
  * Adapts provider-specific integrations to the generic invocation executor.