@uns-kit/assistant-workflow 2.0.72

package/dist/outcome.d.ts

@@ -0,0 +1,97 @@
+export type AssistantWorkflowOutcome = AssistantWorkflowNotHandledOutcome | AssistantWorkflowFinalTextOutcome | AssistantWorkflowClarificationOutcome | AssistantWorkflowStructuredArtifactOutcome | AssistantWorkflowUnavailableOutcome | AssistantWorkflowDirectRouteOutcome | AssistantWorkflowDegradedOutcome;
+export type AssistantWorkflowOutcomeKind = AssistantWorkflowOutcome["kind"];
+export type AssistantWorkflowOutcomeDelivery = "stream" | "return";
+export type AssistantWorkflowNotHandledOutcome = {
+    kind: "not_handled";
+    reason?: string;
+};
+export type AssistantWorkflowFinalTextOutcome = {
+    kind: "final_text";
+    content: string;
+    delivery?: AssistantWorkflowOutcomeDelivery;
+};
+export type AssistantWorkflowClarificationOutcome = {
+    kind: "clarification";
+    content: string;
+    ruleId?: string;
+};
+export type AssistantWorkflowStructuredArtifactOutcome = {
+    kind: "structured_artifact";
+    artifactKind: string;
+    payload: unknown;
+    content?: string;
+};
+/**
+ * A requested structured artifact cannot be produced from the available
+ * runtime evidence. The reason is application-defined but must come from a
+ * typed execution result, never inferred from final-answer prose.
+ */
+export type AssistantWorkflowUnavailableOutcome = {
+    kind: "unavailable";
+    artifactKind: string;
+    reason: string;
+    content?: string;
+};
+export type AssistantWorkflowDirectRouteOutcome = {
+    kind: "direct_route";
+    route: string;
+    content?: string;
+    payload?: unknown;
+    artifactKind?: string;
+    reason?: string;
+    delivery?: AssistantWorkflowOutcomeDelivery;
+};
+export type AssistantWorkflowDirectRouteOutcomeOptions = {
+    content?: string;
+    payload?: unknown;
+    artifactKind?: string;
+    reason?: string;
+    delivery?: AssistantWorkflowOutcomeDelivery;
+};
+export type AssistantWorkflowDirectRouteOutcomeRouteSource = {
+    outcomeRoute?: string | null;
+    routeId?: string | null;
+};
+export type AssistantWorkflowDirectRouteInvocationOutcomeOptions = AssistantWorkflowDirectRouteOutcomeOptions & {
+    fallbackRoute?: string | null;
+};
+export type AssistantWorkflowDirectRouteInvocationNotHandledOptions = {
+    reason?: string;
+    fallbackRoute?: string | null;
+};
+export type AssistantWorkflowDegradedOutcome = {
+    kind: "degraded";
+    content: string;
+    reason: string;
+};
+export type AssistantWorkflowOutcomeSummary = {
+    kind: AssistantWorkflowOutcomeKind;
+    handled: boolean;
+    contentChars: number;
+    reason: string | null;
+    delivery: AssistantWorkflowOutcomeDelivery | null;
+    artifactKind: string | null;
+    route: string | null;
+};
+export type AssistantWorkflowOutcomeTraceEventPayloadInput = {
+    outcome: AssistantWorkflowOutcome;
+    source?: string;
+    layer?: string;
+    skipEvent?: string | null;
+    metadata?: Record<string, unknown>;
+};
+export declare function assistantWorkflowNotHandled(reason?: string): AssistantWorkflowNotHandledOutcome;
+export declare function assistantWorkflowFinalText(content: string, delivery?: AssistantWorkflowOutcomeDelivery): AssistantWorkflowFinalTextOutcome;
+export declare function assistantWorkflowClarification(content: string, ruleId?: string): AssistantWorkflowClarificationOutcome;
+export declare function assistantWorkflowStructuredArtifact(artifactKind: string, payload: unknown, content?: string): AssistantWorkflowStructuredArtifactOutcome;
+export declare function assistantWorkflowUnavailable(artifactKind: string, reason: string, content?: string): AssistantWorkflowUnavailableOutcome;
+export declare function assistantWorkflowDirectRoute(route: string, options?: AssistantWorkflowDirectRouteOutcomeOptions): AssistantWorkflowDirectRouteOutcome;
+export declare function getAssistantWorkflowDirectRouteOutcomeRoute(source: AssistantWorkflowDirectRouteOutcomeRouteSource | null | undefined, fallbackRoute?: string | null): string;
+export declare function assistantWorkflowDirectRouteFromInvocation(source: AssistantWorkflowDirectRouteOutcomeRouteSource | null | undefined, options?: AssistantWorkflowDirectRouteInvocationOutcomeOptions): AssistantWorkflowDirectRouteOutcome;
+export declare function assistantWorkflowDirectRouteNotHandledFromInvocation(source: AssistantWorkflowDirectRouteOutcomeRouteSource | null | undefined, options?: AssistantWorkflowDirectRouteInvocationNotHandledOptions): AssistantWorkflowNotHandledOutcome;
+export declare function assistantWorkflowDegraded(content: string, reason: string): AssistantWorkflowDegradedOutcome;
+export declare function isAssistantWorkflowHandledOutcome(outcome: AssistantWorkflowOutcome | null | undefined): boolean;
+export declare function summarizeAssistantWorkflowOutcome(outcome: AssistantWorkflowOutcome): AssistantWorkflowOutcomeSummary;
+export declare function buildAssistantWorkflowOutcomeTracePayload(outcome: AssistantWorkflowOutcome): Record<string, unknown>;
+export declare function buildAssistantWorkflowOutcomeTraceEventPayload(input: AssistantWorkflowOutcomeTraceEventPayloadInput): Record<string, unknown>;
+//# sourceMappingURL=outcome.d.ts.map

package/dist/outcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outcome.d.ts","sourceRoot":"","sources":["../src/outcome.ts"],"names":[],"mappings":"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"}

package/dist/outcome.js

@@ -0,0 +1,160 @@
+export function assistantWorkflowNotHandled(reason) {
+    const normalizedReason = normalizeOptionalString(reason);
+    return normalizedReason ? { kind: "not_handled", reason: normalizedReason } : { kind: "not_handled" };
+}
+export function assistantWorkflowFinalText(content, delivery) {
+    return {
+        kind: "final_text",
+        content,
+        ...(delivery ? { delivery } : {}),
+    };
+}
+export function assistantWorkflowClarification(content, ruleId) {
+    const normalizedRuleId = normalizeOptionalString(ruleId);
+    return {
+        kind: "clarification",
+        content,
+        ...(normalizedRuleId ? { ruleId: normalizedRuleId } : {}),
+    };
+}
+export function assistantWorkflowStructuredArtifact(artifactKind, payload, content) {
+    const normalizedArtifactKind = normalizeRequiredString(artifactKind, "artifactKind");
+    const normalizedContent = normalizeOptionalString(content);
+    return {
+        kind: "structured_artifact",
+        artifactKind: normalizedArtifactKind,
+        payload,
+        ...(normalizedContent ? { content: normalizedContent } : {}),
+    };
+}
+export function assistantWorkflowUnavailable(artifactKind, reason, content) {
+    const normalizedArtifactKind = normalizeRequiredString(artifactKind, "artifactKind");
+    const normalizedReason = normalizeRequiredString(reason, "reason");
+    const normalizedContent = normalizeOptionalString(content);
+    return {
+        kind: "unavailable",
+        artifactKind: normalizedArtifactKind,
+        reason: normalizedReason,
+        ...(normalizedContent ? { content: normalizedContent } : {}),
+    };
+}
+export function assistantWorkflowDirectRoute(route, options = {}) {
+    const normalizedRoute = normalizeRequiredString(route, "route");
+    const normalizedContent = normalizeOptionalString(options.content);
+    const normalizedArtifactKind = normalizeOptionalString(options.artifactKind);
+    const normalizedReason = normalizeOptionalString(options.reason);
+    return {
+        kind: "direct_route",
+        route: normalizedRoute,
+        ...(normalizedContent ? { content: normalizedContent } : {}),
+        ...(options.payload !== undefined ? { payload: options.payload } : {}),
+        ...(normalizedArtifactKind ? { artifactKind: normalizedArtifactKind } : {}),
+        ...(normalizedReason ? { reason: normalizedReason } : {}),
+        ...(options.delivery ? { delivery: options.delivery } : {}),
+    };
+}
+export function getAssistantWorkflowDirectRouteOutcomeRoute(source, fallbackRoute) {
+    const route = normalizeOptionalString(source?.outcomeRoute) ??
+        normalizeOptionalString(source?.routeId) ??
+        normalizeOptionalString(fallbackRoute);
+    if (!route) {
+        throw new Error("Assistant workflow direct route outcome route is required.");
+    }
+    return route;
+}
+export function assistantWorkflowDirectRouteFromInvocation(source, options = {}) {
+    const { fallbackRoute, ...outcomeOptions } = options;
+    return assistantWorkflowDirectRoute(getAssistantWorkflowDirectRouteOutcomeRoute(source, fallbackRoute), outcomeOptions);
+}
+export function assistantWorkflowDirectRouteNotHandledFromInvocation(source, options = {}) {
+    const reason = normalizeOptionalString(options.reason);
+    if (reason)
+        return assistantWorkflowNotHandled(reason);
+    const route = getAssistantWorkflowDirectRouteOutcomeRoute(source, options.fallbackRoute);
+    return assistantWorkflowNotHandled(`${route}:not_handled`);
+}
+export function assistantWorkflowDegraded(content, reason) {
+    return {
+        kind: "degraded",
+        content,
+        reason: normalizeRequiredString(reason, "reason"),
+    };
+}
+export function isAssistantWorkflowHandledOutcome(outcome) {
+    return outcome !== null && outcome !== undefined && outcome.kind !== "not_handled";
+}
+export function summarizeAssistantWorkflowOutcome(outcome) {
+    return {
+        kind: outcome.kind,
+        handled: outcome.kind !== "not_handled",
+        contentChars: getOutcomeContent(outcome).length,
+        reason: getOutcomeReason(outcome),
+        delivery: outcome.kind === "final_text" || outcome.kind === "direct_route"
+            ? outcome.delivery ?? null
+            : null,
+        artifactKind: outcome.kind === "structured_artifact" || outcome.kind === "unavailable"
+            ? outcome.artifactKind
+            : outcome.kind === "direct_route"
+                ? outcome.artifactKind ?? null
+                : null,
+        route: outcome.kind === "direct_route" ? outcome.route : null,
+    };
+}
+export function buildAssistantWorkflowOutcomeTracePayload(outcome) {
+    return summarizeAssistantWorkflowOutcome(outcome);
+}
+export function buildAssistantWorkflowOutcomeTraceEventPayload(input) {
+    return {
+        ...(input.source !== undefined ? { source: input.source } : {}),
+        ...(input.layer !== undefined ? { layer: input.layer } : {}),
+        ...(input.skipEvent !== undefined ? { skipEvent: input.skipEvent } : {}),
+        ...(input.metadata ?? {}),
+        ...buildAssistantWorkflowOutcomeTracePayload(input.outcome),
+    };
+}
+function getOutcomeContent(outcome) {
+    switch (outcome.kind) {
+        case "final_text":
+        case "clarification":
+        case "degraded":
+            return outcome.content;
+        case "structured_artifact":
+        case "unavailable":
+            return outcome.content ?? "";
+        case "direct_route":
+            return outcome.content ?? "";
+        case "not_handled":
+            return "";
+    }
+}
+function getOutcomeReason(outcome) {
+    switch (outcome.kind) {
+        case "not_handled":
+            return outcome.reason ?? null;
+        case "clarification":
+            return outcome.ruleId ?? null;
+        case "degraded":
+            return outcome.reason;
+        case "unavailable":
+            return outcome.reason;
+        case "direct_route":
+            return outcome.reason ?? null;
+        case "final_text":
+        case "structured_artifact":
+            return null;
+    }
+}
+function normalizeOptionalString(value) {
+    if (value === undefined || value === null)
+        return null;
+    const trimmed = value.trim();
+    return trimmed.length ? trimmed : null;
+}
+function normalizeRequiredString(value, fieldName) {
+    const trimmed = value.trim();
+    if (!trimmed.length) {
+        throw new Error(`Assistant workflow outcome ${fieldName} is required.`);
+    }
+    return trimmed;
+}
+//# sourceMappingURL=outcome.js.map

package/dist/outcome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outcome.js","sourceRoot":"","sources":["../src/outcome.ts"],"names":[],"mappings":"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","sourcesContent":["export type AssistantWorkflowOutcome =\n  | AssistantWorkflowNotHandledOutcome\n  | AssistantWorkflowFinalTextOutcome\n  | AssistantWorkflowClarificationOutcome\n  | AssistantWorkflowStructuredArtifactOutcome\n  | AssistantWorkflowUnavailableOutcome\n  | AssistantWorkflowDirectRouteOutcome\n  | AssistantWorkflowDegradedOutcome;\n\nexport type AssistantWorkflowOutcomeKind = AssistantWorkflowOutcome[\"kind\"];\n\nexport type AssistantWorkflowOutcomeDelivery = \"stream\" | \"return\";\n\nexport type AssistantWorkflowNotHandledOutcome = {\n  kind: \"not_handled\";\n  reason?: string;\n};\n\nexport type AssistantWorkflowFinalTextOutcome = {\n  kind: \"final_text\";\n  content: string;\n  delivery?: AssistantWorkflowOutcomeDelivery;\n};\n\nexport type AssistantWorkflowClarificationOutcome = {\n  kind: \"clarification\";\n  content: string;\n  ruleId?: string;\n};\n\nexport type AssistantWorkflowStructuredArtifactOutcome = {\n  kind: \"structured_artifact\";\n  artifactKind: string;\n  payload: unknown;\n  content?: string;\n};\n\n/**\n * A requested structured artifact cannot be produced from the available\n * runtime evidence. The reason is application-defined but must come from a\n * typed execution result, never inferred from final-answer prose.\n */\nexport type AssistantWorkflowUnavailableOutcome = {\n  kind: \"unavailable\";\n  artifactKind: string;\n  reason: string;\n  content?: string;\n};\n\nexport type AssistantWorkflowDirectRouteOutcome = {\n  kind: \"direct_route\";\n  route: string;\n  content?: string;\n  payload?: unknown;\n  artifactKind?: string;\n  reason?: string;\n  delivery?: AssistantWorkflowOutcomeDelivery;\n};\n\nexport type AssistantWorkflowDirectRouteOutcomeOptions = {\n  content?: string;\n  payload?: unknown;\n  artifactKind?: string;\n  reason?: string;\n  delivery?: AssistantWorkflowOutcomeDelivery;\n};\n\nexport type AssistantWorkflowDirectRouteOutcomeRouteSource = {\n  outcomeRoute?: string | null;\n  routeId?: string | null;\n};\n\nexport type AssistantWorkflowDirectRouteInvocationOutcomeOptions =\n  AssistantWorkflowDirectRouteOutcomeOptions & {\n    fallbackRoute?: string | null;\n  };\n\nexport type AssistantWorkflowDirectRouteInvocationNotHandledOptions = {\n  reason?: string;\n  fallbackRoute?: string | null;\n};\n\nexport type AssistantWorkflowDegradedOutcome = {\n  kind: \"degraded\";\n  content: string;\n  reason: string;\n};\n\nexport type AssistantWorkflowOutcomeSummary = {\n  kind: AssistantWorkflowOutcomeKind;\n  handled: boolean;\n  contentChars: number;\n  reason: string | null;\n  delivery: AssistantWorkflowOutcomeDelivery | null;\n  artifactKind: string | null;\n  route: string | null;\n};\n\nexport type AssistantWorkflowOutcomeTraceEventPayloadInput = {\n  outcome: AssistantWorkflowOutcome;\n  source?: string;\n  layer?: string;\n  skipEvent?: string | null;\n  metadata?: Record<string, unknown>;\n};\n\nexport function assistantWorkflowNotHandled(reason?: string): AssistantWorkflowNotHandledOutcome {\n  const normalizedReason = normalizeOptionalString(reason);\n  return normalizedReason ? { kind: \"not_handled\", reason: normalizedReason } : { kind: \"not_handled\" };\n}\n\nexport function assistantWorkflowFinalText(\n  content: string,\n  delivery?: AssistantWorkflowOutcomeDelivery,\n): AssistantWorkflowFinalTextOutcome {\n  return {\n    kind: \"final_text\",\n    content,\n    ...(delivery ? { delivery } : {}),\n  };\n}\n\nexport function assistantWorkflowClarification(\n  content: string,\n  ruleId?: string,\n): AssistantWorkflowClarificationOutcome {\n  const normalizedRuleId = normalizeOptionalString(ruleId);\n  return {\n    kind: \"clarification\",\n    content,\n    ...(normalizedRuleId ? { ruleId: normalizedRuleId } : {}),\n  };\n}\n\nexport function assistantWorkflowStructuredArtifact(\n  artifactKind: string,\n  payload: unknown,\n  content?: string,\n): AssistantWorkflowStructuredArtifactOutcome {\n  const normalizedArtifactKind = normalizeRequiredString(artifactKind, \"artifactKind\");\n  const normalizedContent = normalizeOptionalString(content);\n  return {\n    kind: \"structured_artifact\",\n    artifactKind: normalizedArtifactKind,\n    payload,\n    ...(normalizedContent ? { content: normalizedContent } : {}),\n  };\n}\n\nexport function assistantWorkflowUnavailable(\n  artifactKind: string,\n  reason: string,\n  content?: string,\n): AssistantWorkflowUnavailableOutcome {\n  const normalizedArtifactKind = normalizeRequiredString(artifactKind, \"artifactKind\");\n  const normalizedReason = normalizeRequiredString(reason, \"reason\");\n  const normalizedContent = normalizeOptionalString(content);\n  return {\n    kind: \"unavailable\",\n    artifactKind: normalizedArtifactKind,\n    reason: normalizedReason,\n    ...(normalizedContent ? { content: normalizedContent } : {}),\n  };\n}\n\nexport function assistantWorkflowDirectRoute(\n  route: string,\n  options: AssistantWorkflowDirectRouteOutcomeOptions = {},\n): AssistantWorkflowDirectRouteOutcome {\n  const normalizedRoute = normalizeRequiredString(route, \"route\");\n  const normalizedContent = normalizeOptionalString(options.content);\n  const normalizedArtifactKind = normalizeOptionalString(options.artifactKind);\n  const normalizedReason = normalizeOptionalString(options.reason);\n  return {\n    kind: \"direct_route\",\n    route: normalizedRoute,\n    ...(normalizedContent ? { content: normalizedContent } : {}),\n    ...(options.payload !== undefined ? { payload: options.payload } : {}),\n    ...(normalizedArtifactKind ? { artifactKind: normalizedArtifactKind } : {}),\n    ...(normalizedReason ? { reason: normalizedReason } : {}),\n    ...(options.delivery ? { delivery: options.delivery } : {}),\n  };\n}\n\nexport function getAssistantWorkflowDirectRouteOutcomeRoute(\n  source: AssistantWorkflowDirectRouteOutcomeRouteSource | null | undefined,\n  fallbackRoute?: string | null,\n): string {\n  const route =\n    normalizeOptionalString(source?.outcomeRoute) ??\n    normalizeOptionalString(source?.routeId) ??\n    normalizeOptionalString(fallbackRoute);\n  if (!route) {\n    throw new Error(\"Assistant workflow direct route outcome route is required.\");\n  }\n  return route;\n}\n\nexport function assistantWorkflowDirectRouteFromInvocation(\n  source: AssistantWorkflowDirectRouteOutcomeRouteSource | null | undefined,\n  options: AssistantWorkflowDirectRouteInvocationOutcomeOptions = {},\n): AssistantWorkflowDirectRouteOutcome {\n  const { fallbackRoute, ...outcomeOptions } = options;\n  return assistantWorkflowDirectRoute(\n    getAssistantWorkflowDirectRouteOutcomeRoute(source, fallbackRoute),\n    outcomeOptions,\n  );\n}\n\nexport function assistantWorkflowDirectRouteNotHandledFromInvocation(\n  source: AssistantWorkflowDirectRouteOutcomeRouteSource | null | undefined,\n  options: AssistantWorkflowDirectRouteInvocationNotHandledOptions = {},\n): AssistantWorkflowNotHandledOutcome {\n  const reason = normalizeOptionalString(options.reason);\n  if (reason) return assistantWorkflowNotHandled(reason);\n  const route = getAssistantWorkflowDirectRouteOutcomeRoute(source, options.fallbackRoute);\n  return assistantWorkflowNotHandled(`${route}:not_handled`);\n}\n\nexport function assistantWorkflowDegraded(content: string, reason: string): AssistantWorkflowDegradedOutcome {\n  return {\n    kind: \"degraded\",\n    content,\n    reason: normalizeRequiredString(reason, \"reason\"),\n  };\n}\n\nexport function isAssistantWorkflowHandledOutcome(outcome: AssistantWorkflowOutcome | null | undefined): boolean {\n  return outcome !== null && outcome !== undefined && outcome.kind !== \"not_handled\";\n}\n\nexport function summarizeAssistantWorkflowOutcome(\n  outcome: AssistantWorkflowOutcome,\n): AssistantWorkflowOutcomeSummary {\n  return {\n    kind: outcome.kind,\n    handled: outcome.kind !== \"not_handled\",\n    contentChars: getOutcomeContent(outcome).length,\n    reason: getOutcomeReason(outcome),\n    delivery: outcome.kind === \"final_text\" || outcome.kind === \"direct_route\"\n      ? outcome.delivery ?? null\n      : null,\n    artifactKind: outcome.kind === \"structured_artifact\" || outcome.kind === \"unavailable\"\n      ? outcome.artifactKind\n      : outcome.kind === \"direct_route\"\n        ? outcome.artifactKind ?? null\n        : null,\n    route: outcome.kind === \"direct_route\" ? outcome.route : null,\n  };\n}\n\nexport function buildAssistantWorkflowOutcomeTracePayload(\n  outcome: AssistantWorkflowOutcome,\n): Record<string, unknown> {\n  return summarizeAssistantWorkflowOutcome(outcome);\n}\n\nexport function buildAssistantWorkflowOutcomeTraceEventPayload(\n  input: AssistantWorkflowOutcomeTraceEventPayloadInput,\n): Record<string, unknown> {\n  return {\n    ...(input.source !== undefined ? { source: input.source } : {}),\n    ...(input.layer !== undefined ? { layer: input.layer } : {}),\n    ...(input.skipEvent !== undefined ? { skipEvent: input.skipEvent } : {}),\n    ...(input.metadata ?? {}),\n    ...buildAssistantWorkflowOutcomeTracePayload(input.outcome),\n  };\n}\n\nfunction getOutcomeContent(outcome: AssistantWorkflowOutcome): string {\n  switch (outcome.kind) {\n    case \"final_text\":\n    case \"clarification\":\n    case \"degraded\":\n      return outcome.content;\n    case \"structured_artifact\":\n    case \"unavailable\":\n      return outcome.content ?? \"\";\n    case \"direct_route\":\n      return outcome.content ?? \"\";\n    case \"not_handled\":\n      return \"\";\n  }\n}\n\nfunction getOutcomeReason(outcome: AssistantWorkflowOutcome): string | null {\n  switch (outcome.kind) {\n    case \"not_handled\":\n      return outcome.reason ?? null;\n    case \"clarification\":\n      return outcome.ruleId ?? null;\n    case \"degraded\":\n      return outcome.reason;\n    case \"unavailable\":\n      return outcome.reason;\n    case \"direct_route\":\n      return outcome.reason ?? null;\n    case \"final_text\":\n    case \"structured_artifact\":\n      return null;\n  }\n}\n\nfunction normalizeOptionalString(value: string | null | undefined): string | null {\n  if (value === undefined || value === null) return null;\n  const trimmed = value.trim();\n  return trimmed.length ? trimmed : null;\n}\n\nfunction normalizeRequiredString(value: string, fieldName: string): string {\n  const trimmed = value.trim();\n  if (!trimmed.length) {\n    throw new Error(`Assistant workflow outcome ${fieldName} is required.`);\n  }\n  return trimmed;\n}\n"]}

package/dist/planner-compiler.d.ts

@@ -0,0 +1,14 @@
+import { type AssistantWorkflowDefinition, type AssistantWorkflowPromptFacts } from "./definition.js";
+export type AssistantWorkflowPlannerPromptFacts = AssistantWorkflowPromptFacts & {
+    intentInstructions: string;
+};
+export type AssistantWorkflowPlannerCompilation<TIntent extends string = string, TSubintent extends string = string, TPresentation extends string = string, TDerivedTransform extends string = string> = {
+    intentValues: readonly TIntent[];
+    subintentValues: readonly TSubintent[];
+    presentationValues: readonly TPresentation[];
+    derivedTransformValues: readonly TDerivedTransform[];
+    promptFacts: AssistantWorkflowPlannerPromptFacts;
+};
+export declare function compileAssistantWorkflowForPlanner<TIntent extends string, TSubintent extends string, TPresentation extends string, TDerivedTransform extends string>(workflow: AssistantWorkflowDefinition<TIntent, TSubintent, TPresentation, TDerivedTransform>): AssistantWorkflowPlannerCompilation<TIntent, TSubintent, TPresentation, TDerivedTransform>;
+export declare function formatAssistantWorkflowIntentInstructions(workflow: AssistantWorkflowDefinition<string, string, string, string>): string;
+//# sourceMappingURL=planner-compiler.d.ts.map

package/dist/planner-compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner-compiler.d.ts","sourceRoot":"","sources":["../src/planner-compiler.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EAClC,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,mCAAmC,GAAG,4BAA4B,GAAG;IAC/E,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,mCAAmC,CAC7C,OAAO,SAAS,MAAM,GAAG,MAAM,EAC/B,UAAU,SAAS,MAAM,GAAG,MAAM,EAClC,aAAa,SAAS,MAAM,GAAG,MAAM,EACrC,iBAAiB,SAAS,MAAM,GAAG,MAAM,IACvC;IACF,YAAY,EAAE,SAAS,OAAO,EAAE,CAAC;IACjC,eAAe,EAAE,SAAS,UAAU,EAAE,CAAC;IACvC,kBAAkB,EAAE,SAAS,aAAa,EAAE,CAAC;IAC7C,sBAAsB,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACrD,WAAW,EAAE,mCAAmC,CAAC;CAClD,CAAC;AAEF,wBAAgB,kCAAkC,CAChD,OAAO,SAAS,MAAM,EACtB,UAAU,SAAS,MAAM,EACzB,aAAa,SAAS,MAAM,EAC5B,iBAAiB,SAAS,MAAM,EAEhC,QAAQ,EAAE,2BAA2B,CAAC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,CAAC,GAC3F,mCAAmC,CAAC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,CAAC,CAW5F;AAED,wBAAgB,yCAAyC,CACvD,QAAQ,EAAE,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GACpE,MAAM,CAWR"}

package/dist/planner-compiler.js

@@ -0,0 +1,26 @@
+import { buildAssistantWorkflowPromptFacts, getAssistantWorkflowDerivedTransformIds, getAssistantWorkflowIntentIds, getAssistantWorkflowPresentationIds, getAssistantWorkflowSubintentIds, } from "./definition.js";
+export function compileAssistantWorkflowForPlanner(workflow) {
+    return {
+        intentValues: getAssistantWorkflowIntentIds(workflow),
+        subintentValues: getAssistantWorkflowSubintentIds(workflow),
+        presentationValues: getAssistantWorkflowPresentationIds(workflow),
+        derivedTransformValues: getAssistantWorkflowDerivedTransformIds(workflow),
+        promptFacts: {
+            ...buildAssistantWorkflowPromptFacts(workflow),
+            intentInstructions: formatAssistantWorkflowIntentInstructions(workflow),
+        },
+    };
+}
+export function formatAssistantWorkflowIntentInstructions(workflow) {
+    return workflow.intents
+        .map((intent) => {
+        const parts = [
+            `${intent.id} = ${intent.description.trim()}`,
+            ...(intent.plannerInstructions ?? []).map((instruction) => instruction.trim()).filter(Boolean),
+        ];
+        return parts.join(" ");
+    })
+        .filter((entry) => entry.trim().length > 0)
+        .join(" ");
+}
+//# sourceMappingURL=planner-compiler.js.map

package/dist/planner-compiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner-compiler.js","sourceRoot":"","sources":["../src/planner-compiler.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iCAAiC,EACjC,uCAAuC,EACvC,6BAA6B,EAC7B,mCAAmC,EACnC,gCAAgC,GAGjC,MAAM,iBAAiB,CAAC;AAmBzB,MAAM,UAAU,kCAAkC,CAMhD,QAA4F;IAE5F,OAAO;QACL,YAAY,EAAE,6BAA6B,CAAC,QAAQ,CAAC;QACrD,eAAe,EAAE,gCAAgC,CAAC,QAAQ,CAAC;QAC3D,kBAAkB,EAAE,mCAAmC,CAAC,QAAQ,CAAC;QACjE,sBAAsB,EAAE,uCAAuC,CAAC,QAAQ,CAAC;QACzE,WAAW,EAAE;YACX,GAAG,iCAAiC,CAAC,QAAQ,CAAC;YAC9C,kBAAkB,EAAE,yCAAyC,CAAC,QAAQ,CAAC;SACxE;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yCAAyC,CACvD,QAAqE;IAErE,OAAO,QAAQ,CAAC,OAAO;SACpB,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACd,MAAM,KAAK,GAAG;YACZ,GAAG,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE;YAC7C,GAAG,CAAC,MAAM,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;SAC/F,CAAC;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;SAC1C,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC","sourcesContent":["import {\n  buildAssistantWorkflowPromptFacts,\n  getAssistantWorkflowDerivedTransformIds,\n  getAssistantWorkflowIntentIds,\n  getAssistantWorkflowPresentationIds,\n  getAssistantWorkflowSubintentIds,\n  type AssistantWorkflowDefinition,\n  type AssistantWorkflowPromptFacts,\n} from \"./definition.js\";\n\nexport type AssistantWorkflowPlannerPromptFacts = AssistantWorkflowPromptFacts & {\n  intentInstructions: string;\n};\n\nexport type AssistantWorkflowPlannerCompilation<\n  TIntent extends string = string,\n  TSubintent extends string = string,\n  TPresentation extends string = string,\n  TDerivedTransform extends string = string,\n> = {\n  intentValues: readonly TIntent[];\n  subintentValues: readonly TSubintent[];\n  presentationValues: readonly TPresentation[];\n  derivedTransformValues: readonly TDerivedTransform[];\n  promptFacts: AssistantWorkflowPlannerPromptFacts;\n};\n\nexport function compileAssistantWorkflowForPlanner<\n  TIntent extends string,\n  TSubintent extends string,\n  TPresentation extends string,\n  TDerivedTransform extends string,\n>(\n  workflow: AssistantWorkflowDefinition<TIntent, TSubintent, TPresentation, TDerivedTransform>,\n): AssistantWorkflowPlannerCompilation<TIntent, TSubintent, TPresentation, TDerivedTransform> {\n  return {\n    intentValues: getAssistantWorkflowIntentIds(workflow),\n    subintentValues: getAssistantWorkflowSubintentIds(workflow),\n    presentationValues: getAssistantWorkflowPresentationIds(workflow),\n    derivedTransformValues: getAssistantWorkflowDerivedTransformIds(workflow),\n    promptFacts: {\n      ...buildAssistantWorkflowPromptFacts(workflow),\n      intentInstructions: formatAssistantWorkflowIntentInstructions(workflow),\n    },\n  };\n}\n\nexport function formatAssistantWorkflowIntentInstructions(\n  workflow: AssistantWorkflowDefinition<string, string, string, string>,\n): string {\n  return workflow.intents\n    .map((intent) => {\n      const parts = [\n        `${intent.id} = ${intent.description.trim()}`,\n        ...(intent.plannerInstructions ?? []).map((instruction) => instruction.trim()).filter(Boolean),\n      ];\n      return parts.join(\" \");\n    })\n    .filter((entry) => entry.trim().length > 0)\n    .join(\" \");\n}\n"]}

package/dist/planning.d.ts

@@ -0,0 +1,36 @@
+import { type AssistantWorkflowDefinition, type AssistantWorkflowPlanningStepDefinition, type AssistantWorkflowPlanningStepKind } from "./definition.js";
+export type AssistantWorkflowPlanStepTrace = {
+    id: string;
+    kind: AssistantWorkflowPlanningStepKind;
+    optional: boolean;
+    toolHints: string[];
+    requiredToolHints: string[];
+};
+export type AssistantWorkflowPlanExecutionHints = {
+    needsClarification: boolean;
+    needsSynthesis: boolean;
+    producesArtifact: boolean;
+    mayGenerate: boolean;
+};
+export type AssistantWorkflowPlan = {
+    stepIds: string[];
+    steps: AssistantWorkflowPlanStepTrace[];
+    activePlanningStepProfileIds: string[];
+    profileStepIds: string[];
+    toolHints: string[];
+    requiredToolHints: string[];
+    missingToolHints: string[];
+    missingRequiredToolHints: string[];
+    missingPlanningSteps: string[];
+    executionHints: AssistantWorkflowPlanExecutionHints;
+};
+export type AssistantWorkflowPlanContext = {
+    subintent?: string | null;
+    presentation?: string | null;
+    timeWindowHint?: string | null;
+    toolsToExpose?: readonly string[] | null;
+    confidence?: number | null;
+};
+export declare function findAssistantWorkflowPlanningStep(workflow: AssistantWorkflowDefinition<string, string, string, string>, stepId: unknown): AssistantWorkflowPlanningStepDefinition | null;
+export declare function buildAssistantWorkflowPlan(workflow: AssistantWorkflowDefinition<string, string, string, string>, intentId: unknown, availableToolNames?: readonly string[], context?: AssistantWorkflowPlanContext): AssistantWorkflowPlan;
+//# sourceMappingURL=planning.d.ts.map

package/dist/planning.d.ts.map

@@ -0,0 +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"}

package/dist/planning.js

@@ -0,0 +1,141 @@
+import { findAssistantWorkflowIntent, normalizeAssistantWorkflowId, } from "./definition.js";
+export function findAssistantWorkflowPlanningStep(workflow, stepId) {
+    const normalized = normalizeAssistantWorkflowId(stepId);
+    if (!normalized)
+        return null;
+    return (workflow.planningSteps ?? []).find((step) => step.id === normalized) ?? null;
+}
+export function buildAssistantWorkflowPlan(workflow, intentId, availableToolNames = [], context = {}) {
+    const intent = findAssistantWorkflowIntent(workflow, intentId);
+    const stepsById = new Map((workflow.planningSteps ?? []).map((step) => [step.id, step]));
+    const availableSet = new Set(availableToolNames);
+    const steps = [];
+    const missingPlanningSteps = [];
+    const activePlanningStepProfileIds = [];
+    const profileStepIds = [];
+    const seen = new Set();
+    const baseStepIds = [...(intent?.planningSteps ?? [])];
+    const conditionalStepIds = collectProfilePlanningStepIds(intent?.planningStepProfiles ?? [], context, activePlanningStepProfileIds);
+    const orderedStepIds = insertConditionalStepsBeforeSynthesis(baseStepIds, conditionalStepIds, stepsById);
+    for (const rawStepId of orderedStepIds) {
+        const stepId = normalizeAssistantWorkflowId(rawStepId);
+        if (!stepId || seen.has(stepId))
+            continue;
+        seen.add(stepId);
+        const step = stepsById.get(stepId);
+        if (step) {
+            steps.push(step);
+            if (!profileStepIds.includes(stepId) && activePlanningStepProfileIds.length > 0) {
+                const fromProfile = (intent?.planningStepProfiles ?? [])
+                    .filter((profile) => activePlanningStepProfileIds.includes(profile.id))
+                    .some((profile) => profile.planningSteps.includes(stepId));
+                if (fromProfile && !baseStepIds.includes(stepId)) {
+                    profileStepIds.push(stepId);
+                }
+            }
+        }
+        else {
+            missingPlanningSteps.push(stepId);
+        }
+    }
+    const rawToolHints = uniqueStrings(steps.flatMap((step) => step.toolHints ?? []));
+    const rawRequiredToolHints = uniqueStrings(steps.flatMap((step) => step.requiredToolHints ?? []));
+    const toolHints = filterToolNames(rawToolHints, availableSet);
+    const requiredToolHints = filterToolNames(rawRequiredToolHints, availableSet);
+    return {
+        stepIds: steps.map((step) => step.id),
+        steps: steps.map((step) => ({
+            id: step.id,
+            kind: step.kind,
+            optional: step.optional === true,
+            toolHints: filterToolNames(step.toolHints ?? [], availableSet),
+            requiredToolHints: filterToolNames(step.requiredToolHints ?? [], availableSet),
+        })),
+        activePlanningStepProfileIds,
+        profileStepIds,
+        toolHints,
+        requiredToolHints,
+        missingToolHints: availableSet.size === 0 ? [] : rawToolHints.filter((tool) => !availableSet.has(tool)),
+        missingRequiredToolHints: availableSet.size === 0 ? [] : rawRequiredToolHints.filter((tool) => !availableSet.has(tool)),
+        missingPlanningSteps,
+        executionHints: {
+            needsClarification: steps.some((step) => step.kind === "ask_clarification"),
+            needsSynthesis: steps.some((step) => step.kind === "synthesize"),
+            producesArtifact: steps.some((step) => step.kind === "build_artifact" || step.kind === "generate"),
+            mayGenerate: steps.some((step) => step.kind === "generate"),
+        },
+    };
+}
+function insertConditionalStepsBeforeSynthesis(baseStepIds, conditionalStepIds, stepsById) {
+    if (!conditionalStepIds.length)
+        return [...baseStepIds];
+    const insertIndex = baseStepIds.findIndex((rawStepId) => {
+        const stepId = normalizeAssistantWorkflowId(rawStepId);
+        const kind = stepId ? stepsById.get(stepId)?.kind : null;
+        return kind === "build_artifact" || kind === "generate" || kind === "synthesize";
+    });
+    if (insertIndex < 0)
+        return [...baseStepIds, ...conditionalStepIds];
+    return [
+        ...baseStepIds.slice(0, insertIndex),
+        ...conditionalStepIds,
+        ...baseStepIds.slice(insertIndex),
+    ];
+}
+function collectProfilePlanningStepIds(profiles, context, activeProfileIds) {
+    const out = [];
+    for (const profile of profiles) {
+        if (!matchesPlanningStepProfile(profile, context))
+            continue;
+        activeProfileIds.push(profile.id);
+        out.push(...profile.planningSteps);
+    }
+    return out;
+}
+function matchesPlanningStepProfile(profile, context) {
+    const condition = profile.condition;
+    if (!condition)
+        return true;
+    if (condition.subintent !== undefined && normalizeAssistantWorkflowId(context.subintent) !== condition.subintent) {
+        return false;
+    }
+    if (condition.presentation !== undefined && normalizeAssistantWorkflowId(context.presentation) !== condition.presentation) {
+        return false;
+    }
+    if (condition.timeWindowHint !== undefined && normalizeAssistantWorkflowId(context.timeWindowHint) !== condition.timeWindowHint) {
+        return false;
+    }
+    if (condition.minConfidence !== undefined) {
+        if (typeof context.confidence !== "number" || context.confidence < condition.minConfidence)
+            return false;
+    }
+    if (condition.maxConfidence !== undefined) {
+        if (typeof context.confidence !== "number" || context.confidence > condition.maxConfidence)
+            return false;
+    }
+    const requiredTools = condition.requiredTools ?? [];
+    if (requiredTools.length > 0) {
+        const tools = new Set(uniqueStrings(context.toolsToExpose ?? []));
+        if (!requiredTools.every((tool) => tools.has(tool)))
+            return false;
+    }
+    return true;
+}
+function filterToolNames(rawTools, availableSet) {
+    if (availableSet.size === 0)
+        return uniqueStrings(rawTools);
+    return uniqueStrings(rawTools).filter((tool) => availableSet.has(tool));
+}
+function uniqueStrings(values) {
+    const out = [];
+    const seen = new Set();
+    for (const value of values) {
+        const normalized = normalizeAssistantWorkflowId(value);
+        if (!normalized || seen.has(normalized))
+            continue;
+        seen.add(normalized);
+        out.push(normalized);
+    }
+    return out;
+}
+//# sourceMappingURL=planning.js.map

package/dist/planning.js.map

@@ -0,0 +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"]}

package/dist/policy-resolution.d.ts

@@ -0,0 +1,10 @@
+export type AssistantWorkflowPolicyValueSource = "default" | "config" | "db_override";
+export type AssistantWorkflowPolicyValuePresence<TPolicy> = (value: TPolicy | null | undefined) => boolean;
+export declare function normalizeAssistantWorkflowPolicyString(value: unknown): string | null;
+export declare function normalizeAssistantWorkflowPolicyBaseUrl(value: unknown): string | null;
+export declare function hasAssistantWorkflowBooleanPolicyValue(value: unknown): boolean;
+export declare function hasAssistantWorkflowStringPolicyValue(value: unknown): boolean;
+export declare function getAssistantWorkflowPolicyValueSource<TPolicy>(configOverride: TPolicy | null | undefined, runtimeOverride: TPolicy | null | undefined, hasValue: AssistantWorkflowPolicyValuePresence<TPolicy>): AssistantWorkflowPolicyValueSource;
+export declare function hasAssistantWorkflowPolicyOverride<TPolicy>(override: TPolicy | null | undefined, hasValueChecks: readonly AssistantWorkflowPolicyValuePresence<TPolicy>[]): boolean;
+export declare function resolveAssistantWorkflowPolicyValue<TPolicy, TValue>(defaults: TPolicy, override: TPolicy | null | undefined, readValue: (value: TPolicy) => TValue, hasValue: AssistantWorkflowPolicyValuePresence<TPolicy>): TValue;
+//# sourceMappingURL=policy-resolution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"policy-resolution.d.ts","sourceRoot":"","sources":["../src/policy-resolution.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kCAAkC,GAAG,SAAS,GAAG,QAAQ,GAAG,aAAa,CAAC;AAEtF,MAAM,MAAM,oCAAoC,CAAC,OAAO,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,KAAK,OAAO,CAAC;AAE3G,wBAAgB,sCAAsC,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAIpF;AAED,wBAAgB,uCAAuC,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAGrF;AAED,wBAAgB,sCAAsC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE9E;AAED,wBAAgB,qCAAqC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE7E;AAED,wBAAgB,qCAAqC,CAAC,OAAO,EAC3D,cAAc,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,EAC1C,eAAe,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,EAC3C,QAAQ,EAAE,oCAAoC,CAAC,OAAO,CAAC,GACtD,kCAAkC,CAIpC;AAED,wBAAgB,kCAAkC,CAAC,OAAO,EACxD,QAAQ,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,EACpC,cAAc,EAAE,SAAS,oCAAoC,CAAC,OAAO,CAAC,EAAE,GACvE,OAAO,CAET;AAED,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,MAAM,EACjE,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,EACpC,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,EACrC,QAAQ,EAAE,oCAAoC,CAAC,OAAO,CAAC,GACtD,MAAM,CAER"}

package/dist/policy-resolution.js

@@ -0,0 +1,30 @@
+export function normalizeAssistantWorkflowPolicyString(value) {
+    if (typeof value !== "string")
+        return null;
+    const trimmed = value.trim();
+    return trimmed.length ? trimmed : null;
+}
+export function normalizeAssistantWorkflowPolicyBaseUrl(value) {
+    const trimmed = normalizeAssistantWorkflowPolicyString(value);
+    return trimmed === null ? null : trimmed.replace(/\/+$/, "");
+}
+export function hasAssistantWorkflowBooleanPolicyValue(value) {
+    return typeof value === "boolean";
+}
+export function hasAssistantWorkflowStringPolicyValue(value) {
+    return normalizeAssistantWorkflowPolicyString(value) !== null;
+}
+export function getAssistantWorkflowPolicyValueSource(configOverride, runtimeOverride, hasValue) {
+    if (hasValue(runtimeOverride))
+        return "db_override";
+    if (hasValue(configOverride))
+        return "config";
+    return "default";
+}
+export function hasAssistantWorkflowPolicyOverride(override, hasValueChecks) {
+    return Boolean(override && hasValueChecks.some((hasValue) => hasValue(override)));
+}
+export function resolveAssistantWorkflowPolicyValue(defaults, override, readValue, hasValue) {
+    return hasValue(override) ? readValue(override) : readValue(defaults);
+}
+//# sourceMappingURL=policy-resolution.js.map

package/dist/policy-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy-resolution.js","sourceRoot":"","sources":["../src/policy-resolution.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,sCAAsC,CAAC,KAAc;IACnE,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,uCAAuC,CAAC,KAAc;IACpE,MAAM,OAAO,GAAG,sCAAsC,CAAC,KAAK,CAAC,CAAC;IAC9D,OAAO,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,sCAAsC,CAAC,KAAc;IACnE,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,qCAAqC,CAAC,KAAc;IAClE,OAAO,sCAAsC,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,qCAAqC,CACnD,cAA0C,EAC1C,eAA2C,EAC3C,QAAuD;IAEvD,IAAI,QAAQ,CAAC,eAAe,CAAC;QAAE,OAAO,aAAa,CAAC;IACpD,IAAI,QAAQ,CAAC,cAAc,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC9C,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,QAAoC,EACpC,cAAwE;IAExE,OAAO,OAAO,CAAC,QAAQ,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,mCAAmC,CACjD,QAAiB,EACjB,QAAoC,EACpC,SAAqC,EACrC,QAAuD;IAEvD,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,QAAmB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;AACnF,CAAC","sourcesContent":["export type AssistantWorkflowPolicyValueSource = \"default\" | \"config\" | \"db_override\";\n\nexport type AssistantWorkflowPolicyValuePresence<TPolicy> = (value: TPolicy | null | undefined) => boolean;\n\nexport function normalizeAssistantWorkflowPolicyString(value: unknown): string | null {\n  if (typeof value !== \"string\") return null;\n  const trimmed = value.trim();\n  return trimmed.length ? trimmed : null;\n}\n\nexport function normalizeAssistantWorkflowPolicyBaseUrl(value: unknown): string | null {\n  const trimmed = normalizeAssistantWorkflowPolicyString(value);\n  return trimmed === null ? null : trimmed.replace(/\\/+$/, \"\");\n}\n\nexport function hasAssistantWorkflowBooleanPolicyValue(value: unknown): boolean {\n  return typeof value === \"boolean\";\n}\n\nexport function hasAssistantWorkflowStringPolicyValue(value: unknown): boolean {\n  return normalizeAssistantWorkflowPolicyString(value) !== null;\n}\n\nexport function getAssistantWorkflowPolicyValueSource<TPolicy>(\n  configOverride: TPolicy | null | undefined,\n  runtimeOverride: TPolicy | null | undefined,\n  hasValue: AssistantWorkflowPolicyValuePresence<TPolicy>,\n): AssistantWorkflowPolicyValueSource {\n  if (hasValue(runtimeOverride)) return \"db_override\";\n  if (hasValue(configOverride)) return \"config\";\n  return \"default\";\n}\n\nexport function hasAssistantWorkflowPolicyOverride<TPolicy>(\n  override: TPolicy | null | undefined,\n  hasValueChecks: readonly AssistantWorkflowPolicyValuePresence<TPolicy>[],\n): boolean {\n  return Boolean(override && hasValueChecks.some((hasValue) => hasValue(override)));\n}\n\nexport function resolveAssistantWorkflowPolicyValue<TPolicy, TValue>(\n  defaults: TPolicy,\n  override: TPolicy | null | undefined,\n  readValue: (value: TPolicy) => TValue,\n  hasValue: AssistantWorkflowPolicyValuePresence<TPolicy>,\n): TValue {\n  return hasValue(override) ? readValue(override as TPolicy) : readValue(defaults);\n}\n"]}