@uns-kit/assistant-workflow 2.0.72

package/dist/direct-route-invocation.d.ts

@@ -0,0 +1,132 @@
+import { type AssistantWorkflowDirectRouteRuntimeDecision, type AssistantWorkflowDirectRouteRuntimeDecisionScope } from "./direct-route-policy.js";
+import { type AssistantWorkflowDefinition, type AssistantWorkflowDirectRouteDefinition } from "./definition.js";
+export type AssistantWorkflowDirectRouteInvocationStatus = "ready" | "disabled" | "missing-route";
+export type AssistantWorkflowDirectRouteStrategyInvocation = {
+    id: string;
+    requiredToolHints: string[];
+};
+export type AssistantWorkflowDirectRouteInvocation = {
+    workflowId: string;
+    workflowVersion: number;
+    intentId: string | null;
+    routeId: string;
+    status: AssistantWorkflowDirectRouteInvocationStatus;
+    enabled: boolean;
+    reason: AssistantWorkflowDirectRouteRuntimeDecision["reason"];
+    policyRouteIds: string[];
+    effect: AssistantWorkflowDirectRouteDefinition["effect"] | null;
+    outcomeRoute: string | null;
+    requiredToolHints: string[];
+    strategyIds: string[];
+    strategies: AssistantWorkflowDirectRouteStrategyInvocation[];
+};
+export type AssistantWorkflowDirectRouteExecutionDecisionReason = "ready" | "invocation_not_ready" | "route_mismatch" | "intent_mismatch";
+export type AssistantWorkflowDirectRouteExecutionDecision = {
+    execute: boolean;
+    reason: AssistantWorkflowDirectRouteExecutionDecisionReason;
+    routeId: string;
+    expectedRouteId: string | null;
+    intentId: string | null;
+    observedIntentId: string | null;
+    invocationStatus: AssistantWorkflowDirectRouteInvocationStatus;
+    enabled: boolean;
+};
+export type AssistantWorkflowDirectRouteStrategyDecisionReason = "ready" | "route_not_executable" | "strategy_missing" | "strategy_not_declared";
+export type AssistantWorkflowDirectRouteStrategyDecision = {
+    execute: boolean;
+    reason: AssistantWorkflowDirectRouteStrategyDecisionReason;
+    routeId: string;
+    strategyId: string | null;
+    declaredStrategyIds: string[];
+    routeExecutionReason: AssistantWorkflowDirectRouteExecutionDecisionReason;
+    invocationStatus: AssistantWorkflowDirectRouteInvocationStatus;
+    enabled: boolean;
+};
+export type AssistantWorkflowDirectRouteToolDecisionReason = "ready" | "route_not_executable" | "strategy_not_executable" | "tool_missing" | "tool_not_allowed";
+export type AssistantWorkflowDirectRouteToolDecision = {
+    execute: boolean;
+    reason: AssistantWorkflowDirectRouteToolDecisionReason;
+    routeId: string;
+    strategyId: string | null;
+    toolName: string | null;
+    allowedToolHints: string[];
+    routeRequiredToolHints: string[];
+    strategyRequiredToolHints: string[];
+    routeExecutionReason: AssistantWorkflowDirectRouteExecutionDecisionReason;
+    strategyReason: AssistantWorkflowDirectRouteStrategyDecisionReason | null;
+    invocationStatus: AssistantWorkflowDirectRouteInvocationStatus;
+    enabled: boolean;
+};
+/**
+ * The complete workflow authorization result for a concrete direct-route
+ * handler. Route planners remain domain-specific, while this contract keeps
+ * route, strategy, and tool authorization together at the execution boundary.
+ */
+export type AssistantWorkflowDirectRouteHandlerDecision = {
+    execute: boolean;
+    reason: "ready" | "route_not_executable" | "strategy_not_executable" | "tool_not_executable";
+    routeExecution: AssistantWorkflowDirectRouteExecutionDecision;
+    strategyDecision: AssistantWorkflowDirectRouteStrategyDecision | null;
+    toolDecision: AssistantWorkflowDirectRouteToolDecision | null;
+};
+/**
+ * Authorization result for a direct-route strategy that needs several tools.
+ * Every listed tool must be declared by the selected route/strategy before a
+ * controller-local handler can begin executing its domain-specific plan.
+ */
+export type AssistantWorkflowDirectRouteHandlerPlanDecision = {
+    execute: boolean;
+    reason: "ready" | "route_not_executable" | "strategy_not_executable" | "tool_not_executable";
+    routeExecution: AssistantWorkflowDirectRouteExecutionDecision;
+    strategyDecision: AssistantWorkflowDirectRouteStrategyDecision | null;
+    toolDecisions: AssistantWorkflowDirectRouteToolDecision[];
+};
+export type AssistantWorkflowDirectRouteInvocationInput = {
+    workflow: AssistantWorkflowDefinition<string, string, string, string>;
+    routeId: unknown;
+    runtimeEnabled: boolean;
+    intentId?: unknown;
+    policyScope?: AssistantWorkflowDirectRouteRuntimeDecisionScope;
+};
+export declare function buildAssistantWorkflowDirectRouteInvocation(input: AssistantWorkflowDirectRouteInvocationInput): AssistantWorkflowDirectRouteInvocation;
+export declare function buildAssistantWorkflowDirectRouteInvocationTracePayload(invocation: AssistantWorkflowDirectRouteInvocation): Record<string, unknown>;
+export declare function buildAssistantWorkflowDirectRouteInvocationPolicyTracePayload(invocation: AssistantWorkflowDirectRouteInvocation): Record<string, unknown>;
+export declare function buildAssistantWorkflowDirectRouteExecutionDecision(input: {
+    invocation: AssistantWorkflowDirectRouteInvocation;
+    expectedRouteId?: unknown;
+    observedIntentId?: unknown;
+    requireIntentMatch?: boolean;
+}): AssistantWorkflowDirectRouteExecutionDecision;
+export declare function buildAssistantWorkflowDirectRouteExecutionDecisionTracePayload(decision: AssistantWorkflowDirectRouteExecutionDecision): Record<string, unknown>;
+export declare function buildAssistantWorkflowDirectRouteStrategyDecision(input: {
+    invocation: AssistantWorkflowDirectRouteInvocation;
+    strategyId?: unknown;
+    routeExecution?: AssistantWorkflowDirectRouteExecutionDecision;
+}): AssistantWorkflowDirectRouteStrategyDecision;
+export declare function buildAssistantWorkflowDirectRouteStrategyDecisionTracePayload(decision: AssistantWorkflowDirectRouteStrategyDecision): Record<string, unknown>;
+export declare function buildAssistantWorkflowDirectRouteToolDecision(input: {
+    invocation: AssistantWorkflowDirectRouteInvocation;
+    toolName?: unknown;
+    routeExecution?: AssistantWorkflowDirectRouteExecutionDecision;
+    strategyDecision?: AssistantWorkflowDirectRouteStrategyDecision | null;
+}): AssistantWorkflowDirectRouteToolDecision;
+export declare function buildAssistantWorkflowDirectRouteHandlerDecision(input: {
+    invocation: AssistantWorkflowDirectRouteInvocation;
+    expectedRouteId: unknown;
+    observedIntentId?: unknown;
+    requireIntentMatch?: boolean;
+    strategyId?: unknown;
+    toolName?: unknown;
+}): AssistantWorkflowDirectRouteHandlerDecision;
+export declare function buildAssistantWorkflowDirectRouteHandlerPlanDecision(input: {
+    invocation: AssistantWorkflowDirectRouteInvocation;
+    expectedRouteId: unknown;
+    observedIntentId?: unknown;
+    requireIntentMatch?: boolean;
+    strategyId?: unknown;
+    toolNames?: readonly unknown[];
+}): AssistantWorkflowDirectRouteHandlerPlanDecision;
+export declare function buildAssistantWorkflowDirectRouteHandlerDecisionTracePayload(decision: AssistantWorkflowDirectRouteHandlerDecision): Record<string, unknown>;
+export declare function buildAssistantWorkflowDirectRouteHandlerPlanDecisionTracePayload(decision: AssistantWorkflowDirectRouteHandlerPlanDecision): Record<string, unknown>;
+export declare function buildAssistantWorkflowDirectRouteToolDecisionTracePayload(decision: AssistantWorkflowDirectRouteToolDecision): Record<string, unknown>;
+//# sourceMappingURL=direct-route-invocation.d.ts.map

package/dist/direct-route-invocation.d.ts.map

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

package/dist/direct-route-invocation.js

@@ -0,0 +1,325 @@
+import { buildAssistantWorkflowDirectRouteRuntimeDecision, } from "./direct-route-policy.js";
+import { normalizeAssistantWorkflowId, } from "./definition.js";
+export function buildAssistantWorkflowDirectRouteInvocation(input) {
+    const routeId = normalizeAssistantWorkflowId(input.routeId) ?? "";
+    const route = findDirectRoute(input.workflow, routeId);
+    const decision = buildAssistantWorkflowDirectRouteRuntimeDecision({
+        workflow: input.workflow,
+        routeId,
+        runtimeEnabled: input.runtimeEnabled,
+        ...(input.intentId !== undefined ? { intentId: input.intentId } : {}),
+        ...(input.policyScope ? { policyScope: input.policyScope } : {}),
+    });
+    const status = !route ? "missing-route" : decision.enabled ? "ready" : "disabled";
+    return {
+        workflowId: input.workflow.id,
+        workflowVersion: input.workflow.version,
+        intentId: decision.intentId,
+        routeId,
+        status,
+        enabled: decision.enabled,
+        reason: decision.reason,
+        policyRouteIds: [...decision.policyRouteIds],
+        effect: route?.effect ?? null,
+        outcomeRoute: route?.outcomeRoute ?? null,
+        requiredToolHints: [...(route?.requiredToolHints ?? [])],
+        strategyIds: (route?.strategies ?? []).map((strategy) => strategy.id),
+        strategies: (route?.strategies ?? []).map((strategy) => ({
+            id: strategy.id,
+            requiredToolHints: [...(strategy.requiredToolHints ?? [])],
+        })),
+    };
+}
+export function buildAssistantWorkflowDirectRouteInvocationTracePayload(invocation) {
+    return {
+        workflowId: invocation.workflowId,
+        workflowVersion: invocation.workflowVersion,
+        intent: invocation.intentId,
+        route: invocation.routeId,
+        status: invocation.status,
+        enabled: invocation.enabled,
+        reason: invocation.reason,
+        policyRouteIds: invocation.policyRouteIds,
+        effect: invocation.effect,
+        outcomeRoute: invocation.outcomeRoute,
+        requiredToolHints: invocation.requiredToolHints,
+        strategyIds: invocation.strategyIds,
+        strategies: invocation.strategies,
+    };
+}
+export function buildAssistantWorkflowDirectRouteInvocationPolicyTracePayload(invocation) {
+    return {
+        intent: invocation.intentId,
+        route: invocation.routeId,
+        enabled: invocation.enabled,
+        reason: invocation.reason,
+        policyRouteIds: [...invocation.policyRouteIds],
+    };
+}
+export function buildAssistantWorkflowDirectRouteExecutionDecision(input) {
+    const expectedRouteId = normalizeAssistantWorkflowId(input.expectedRouteId) ?? null;
+    const observedIntentId = normalizeAssistantWorkflowId(input.observedIntentId) ?? null;
+    const requireIntentMatch = input.requireIntentMatch ?? input.invocation.intentId !== null;
+    const base = {
+        routeId: input.invocation.routeId,
+        expectedRouteId,
+        intentId: input.invocation.intentId,
+        observedIntentId,
+        invocationStatus: input.invocation.status,
+        enabled: input.invocation.enabled,
+    };
+    if (input.invocation.status !== "ready" || !input.invocation.enabled) {
+        return { ...base, execute: false, reason: "invocation_not_ready" };
+    }
+    if (expectedRouteId && input.invocation.routeId !== expectedRouteId) {
+        return { ...base, execute: false, reason: "route_mismatch" };
+    }
+    if (requireIntentMatch && input.invocation.intentId !== null && observedIntentId !== input.invocation.intentId) {
+        return { ...base, execute: false, reason: "intent_mismatch" };
+    }
+    return { ...base, execute: true, reason: "ready" };
+}
+export function buildAssistantWorkflowDirectRouteExecutionDecisionTracePayload(decision) {
+    return {
+        execute: decision.execute,
+        reason: decision.reason,
+        route: decision.routeId,
+        expectedRoute: decision.expectedRouteId,
+        intent: decision.intentId,
+        observedIntent: decision.observedIntentId,
+        invocationStatus: decision.invocationStatus,
+        enabled: decision.enabled,
+    };
+}
+export function buildAssistantWorkflowDirectRouteStrategyDecision(input) {
+    const strategyId = normalizeAssistantWorkflowId(input.strategyId) ?? null;
+    const routeExecution = input.routeExecution ?? buildAssistantWorkflowDirectRouteExecutionDecision({
+        invocation: input.invocation,
+    });
+    const base = {
+        routeId: input.invocation.routeId,
+        strategyId,
+        declaredStrategyIds: [...input.invocation.strategyIds],
+        routeExecutionReason: routeExecution.reason,
+        invocationStatus: input.invocation.status,
+        enabled: input.invocation.enabled,
+    };
+    if (!routeExecution.execute) {
+        return { ...base, execute: false, reason: "route_not_executable" };
+    }
+    if (!strategyId) {
+        return { ...base, execute: false, reason: "strategy_missing" };
+    }
+    if (!input.invocation.strategyIds.includes(strategyId)) {
+        return { ...base, execute: false, reason: "strategy_not_declared" };
+    }
+    return { ...base, execute: true, reason: "ready" };
+}
+export function buildAssistantWorkflowDirectRouteStrategyDecisionTracePayload(decision) {
+    return {
+        execute: decision.execute,
+        reason: decision.reason,
+        route: decision.routeId,
+        strategy: decision.strategyId,
+        declaredStrategies: decision.declaredStrategyIds,
+        routeExecutionReason: decision.routeExecutionReason,
+        invocationStatus: decision.invocationStatus,
+        enabled: decision.enabled,
+    };
+}
+export function buildAssistantWorkflowDirectRouteToolDecision(input) {
+    const toolName = normalizeAssistantWorkflowId(input.toolName) ?? null;
+    const routeExecution = input.routeExecution ?? buildAssistantWorkflowDirectRouteExecutionDecision({
+        invocation: input.invocation,
+    });
+    const strategyDecision = input.strategyDecision ?? null;
+    const strategy = strategyDecision?.strategyId
+        ? findInvocationStrategy(input.invocation, strategyDecision.strategyId)
+        : null;
+    const strategyRequiredToolHints = strategy?.requiredToolHints ?? [];
+    const routeRequiredToolHints = [...input.invocation.requiredToolHints];
+    const allowedToolHints = normalizeToolHints(strategyRequiredToolHints.length > 0 ? strategyRequiredToolHints : routeRequiredToolHints);
+    const base = {
+        routeId: input.invocation.routeId,
+        strategyId: strategyDecision?.strategyId ?? null,
+        toolName,
+        allowedToolHints,
+        routeRequiredToolHints,
+        strategyRequiredToolHints,
+        routeExecutionReason: routeExecution.reason,
+        strategyReason: strategyDecision?.reason ?? null,
+        invocationStatus: input.invocation.status,
+        enabled: input.invocation.enabled,
+    };
+    if (!routeExecution.execute) {
+        return { ...base, execute: false, reason: "route_not_executable" };
+    }
+    if (strategyDecision && !strategyDecision.execute) {
+        return { ...base, execute: false, reason: "strategy_not_executable" };
+    }
+    if (!toolName) {
+        return { ...base, execute: false, reason: "tool_missing" };
+    }
+    if (!allowedToolHints.includes(toolName)) {
+        return { ...base, execute: false, reason: "tool_not_allowed" };
+    }
+    return { ...base, execute: true, reason: "ready" };
+}
+export function buildAssistantWorkflowDirectRouteHandlerDecision(input) {
+    const routeExecution = buildAssistantWorkflowDirectRouteExecutionDecision({
+        invocation: input.invocation,
+        expectedRouteId: input.expectedRouteId,
+        ...(input.observedIntentId !== undefined ? { observedIntentId: input.observedIntentId } : {}),
+        ...(input.requireIntentMatch !== undefined ? { requireIntentMatch: input.requireIntentMatch } : {}),
+    });
+    if (!routeExecution.execute) {
+        return {
+            execute: false,
+            reason: "route_not_executable",
+            routeExecution,
+            strategyDecision: null,
+            toolDecision: null,
+        };
+    }
+    const strategyDecision = input.strategyId === undefined
+        ? null
+        : buildAssistantWorkflowDirectRouteStrategyDecision({
+            invocation: input.invocation,
+            strategyId: input.strategyId,
+            routeExecution,
+        });
+    if (strategyDecision && !strategyDecision.execute) {
+        return {
+            execute: false,
+            reason: "strategy_not_executable",
+            routeExecution,
+            strategyDecision,
+            toolDecision: null,
+        };
+    }
+    const toolDecision = input.toolName === undefined
+        ? null
+        : buildAssistantWorkflowDirectRouteToolDecision({
+            invocation: input.invocation,
+            toolName: input.toolName,
+            routeExecution,
+            ...(strategyDecision ? { strategyDecision } : {}),
+        });
+    if (toolDecision && !toolDecision.execute) {
+        return {
+            execute: false,
+            reason: "tool_not_executable",
+            routeExecution,
+            strategyDecision,
+            toolDecision,
+        };
+    }
+    return {
+        execute: true,
+        reason: "ready",
+        routeExecution,
+        strategyDecision,
+        toolDecision,
+    };
+}
+export function buildAssistantWorkflowDirectRouteHandlerPlanDecision(input) {
+    const handler = buildAssistantWorkflowDirectRouteHandlerDecision({
+        invocation: input.invocation,
+        expectedRouteId: input.expectedRouteId,
+        ...(input.observedIntentId !== undefined ? { observedIntentId: input.observedIntentId } : {}),
+        ...(input.requireIntentMatch !== undefined ? { requireIntentMatch: input.requireIntentMatch } : {}),
+        ...(input.strategyId !== undefined ? { strategyId: input.strategyId } : {}),
+    });
+    if (!handler.execute) {
+        return {
+            execute: false,
+            reason: handler.reason,
+            routeExecution: handler.routeExecution,
+            strategyDecision: handler.strategyDecision,
+            toolDecisions: [],
+        };
+    }
+    const toolDecisions = (input.toolNames ?? []).map((toolName) => buildAssistantWorkflowDirectRouteToolDecision({
+        invocation: input.invocation,
+        toolName,
+        routeExecution: handler.routeExecution,
+        ...(handler.strategyDecision ? { strategyDecision: handler.strategyDecision } : {}),
+    }));
+    if (toolDecisions.some((decision) => !decision.execute)) {
+        return {
+            execute: false,
+            reason: "tool_not_executable",
+            routeExecution: handler.routeExecution,
+            strategyDecision: handler.strategyDecision,
+            toolDecisions,
+        };
+    }
+    return {
+        execute: true,
+        reason: "ready",
+        routeExecution: handler.routeExecution,
+        strategyDecision: handler.strategyDecision,
+        toolDecisions,
+    };
+}
+export function buildAssistantWorkflowDirectRouteHandlerDecisionTracePayload(decision) {
+    return {
+        execute: decision.execute,
+        reason: decision.reason,
+        routeExecution: buildAssistantWorkflowDirectRouteExecutionDecisionTracePayload(decision.routeExecution),
+        strategyDecision: decision.strategyDecision
+            ? buildAssistantWorkflowDirectRouteStrategyDecisionTracePayload(decision.strategyDecision)
+            : null,
+        toolDecision: decision.toolDecision
+            ? buildAssistantWorkflowDirectRouteToolDecisionTracePayload(decision.toolDecision)
+            : null,
+    };
+}
+export function buildAssistantWorkflowDirectRouteHandlerPlanDecisionTracePayload(decision) {
+    return {
+        execute: decision.execute,
+        reason: decision.reason,
+        routeExecution: buildAssistantWorkflowDirectRouteExecutionDecisionTracePayload(decision.routeExecution),
+        strategyDecision: decision.strategyDecision
+            ? buildAssistantWorkflowDirectRouteStrategyDecisionTracePayload(decision.strategyDecision)
+            : null,
+        toolDecisions: decision.toolDecisions.map(buildAssistantWorkflowDirectRouteToolDecisionTracePayload),
+    };
+}
+export function buildAssistantWorkflowDirectRouteToolDecisionTracePayload(decision) {
+    return {
+        execute: decision.execute,
+        reason: decision.reason,
+        route: decision.routeId,
+        strategy: decision.strategyId,
+        tool: decision.toolName,
+        allowedTools: decision.allowedToolHints,
+        routeRequiredTools: decision.routeRequiredToolHints,
+        strategyRequiredTools: decision.strategyRequiredToolHints,
+        routeExecutionReason: decision.routeExecutionReason,
+        strategyReason: decision.strategyReason,
+        invocationStatus: decision.invocationStatus,
+        enabled: decision.enabled,
+    };
+}
+function findDirectRoute(workflow, routeId) {
+    if (!routeId)
+        return null;
+    return workflow.directRoutes?.find((route) => route.id === routeId) ?? null;
+}
+function findInvocationStrategy(invocation, strategyId) {
+    return (invocation.strategies ?? []).find((strategy) => strategy.id === strategyId) ?? null;
+}
+function normalizeToolHints(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=direct-route-invocation.js.map

package/dist/direct-route-invocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-route-invocation.js","sourceRoot":"","sources":["../src/direct-route-invocation.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  buildAssistantWorkflowDirectRouteRuntimeDecision,\n  type AssistantWorkflowDirectRouteRuntimeDecision,\n  type AssistantWorkflowDirectRouteRuntimeDecisionScope,\n} from \"./direct-route-policy.js\";\nimport {\n  normalizeAssistantWorkflowId,\n  type AssistantWorkflowDefinition,\n  type AssistantWorkflowDirectRouteDefinition,\n} from \"./definition.js\";\n\nexport type AssistantWorkflowDirectRouteInvocationStatus =\n  | \"ready\"\n  | \"disabled\"\n  | \"missing-route\";\n\nexport type AssistantWorkflowDirectRouteStrategyInvocation = {\n  id: string;\n  requiredToolHints: string[];\n};\n\nexport type AssistantWorkflowDirectRouteInvocation = {\n  workflowId: string;\n  workflowVersion: number;\n  intentId: string | null;\n  routeId: string;\n  status: AssistantWorkflowDirectRouteInvocationStatus;\n  enabled: boolean;\n  reason: AssistantWorkflowDirectRouteRuntimeDecision[\"reason\"];\n  policyRouteIds: string[];\n  effect: AssistantWorkflowDirectRouteDefinition[\"effect\"] | null;\n  outcomeRoute: string | null;\n  requiredToolHints: string[];\n  strategyIds: string[];\n  strategies: AssistantWorkflowDirectRouteStrategyInvocation[];\n};\n\nexport type AssistantWorkflowDirectRouteExecutionDecisionReason =\n  | \"ready\"\n  | \"invocation_not_ready\"\n  | \"route_mismatch\"\n  | \"intent_mismatch\";\n\nexport type AssistantWorkflowDirectRouteExecutionDecision = {\n  execute: boolean;\n  reason: AssistantWorkflowDirectRouteExecutionDecisionReason;\n  routeId: string;\n  expectedRouteId: string | null;\n  intentId: string | null;\n  observedIntentId: string | null;\n  invocationStatus: AssistantWorkflowDirectRouteInvocationStatus;\n  enabled: boolean;\n};\n\nexport type AssistantWorkflowDirectRouteStrategyDecisionReason =\n  | \"ready\"\n  | \"route_not_executable\"\n  | \"strategy_missing\"\n  | \"strategy_not_declared\";\n\nexport type AssistantWorkflowDirectRouteStrategyDecision = {\n  execute: boolean;\n  reason: AssistantWorkflowDirectRouteStrategyDecisionReason;\n  routeId: string;\n  strategyId: string | null;\n  declaredStrategyIds: string[];\n  routeExecutionReason: AssistantWorkflowDirectRouteExecutionDecisionReason;\n  invocationStatus: AssistantWorkflowDirectRouteInvocationStatus;\n  enabled: boolean;\n};\n\nexport type AssistantWorkflowDirectRouteToolDecisionReason =\n  | \"ready\"\n  | \"route_not_executable\"\n  | \"strategy_not_executable\"\n  | \"tool_missing\"\n  | \"tool_not_allowed\";\n\nexport type AssistantWorkflowDirectRouteToolDecision = {\n  execute: boolean;\n  reason: AssistantWorkflowDirectRouteToolDecisionReason;\n  routeId: string;\n  strategyId: string | null;\n  toolName: string | null;\n  allowedToolHints: string[];\n  routeRequiredToolHints: string[];\n  strategyRequiredToolHints: string[];\n  routeExecutionReason: AssistantWorkflowDirectRouteExecutionDecisionReason;\n  strategyReason: AssistantWorkflowDirectRouteStrategyDecisionReason | null;\n  invocationStatus: AssistantWorkflowDirectRouteInvocationStatus;\n  enabled: boolean;\n};\n\n/**\n * The complete workflow authorization result for a concrete direct-route\n * handler. Route planners remain domain-specific, while this contract keeps\n * route, strategy, and tool authorization together at the execution boundary.\n */\nexport type AssistantWorkflowDirectRouteHandlerDecision = {\n  execute: boolean;\n  reason:\n    | \"ready\"\n    | \"route_not_executable\"\n    | \"strategy_not_executable\"\n    | \"tool_not_executable\";\n  routeExecution: AssistantWorkflowDirectRouteExecutionDecision;\n  strategyDecision: AssistantWorkflowDirectRouteStrategyDecision | null;\n  toolDecision: AssistantWorkflowDirectRouteToolDecision | null;\n};\n\n/**\n * Authorization result for a direct-route strategy that needs several tools.\n * Every listed tool must be declared by the selected route/strategy before a\n * controller-local handler can begin executing its domain-specific plan.\n */\nexport type AssistantWorkflowDirectRouteHandlerPlanDecision = {\n  execute: boolean;\n  reason:\n    | \"ready\"\n    | \"route_not_executable\"\n    | \"strategy_not_executable\"\n    | \"tool_not_executable\";\n  routeExecution: AssistantWorkflowDirectRouteExecutionDecision;\n  strategyDecision: AssistantWorkflowDirectRouteStrategyDecision | null;\n  toolDecisions: AssistantWorkflowDirectRouteToolDecision[];\n};\n\nexport type AssistantWorkflowDirectRouteInvocationInput = {\n  workflow: AssistantWorkflowDefinition<string, string, string, string>;\n  routeId: unknown;\n  runtimeEnabled: boolean;\n  intentId?: unknown;\n  policyScope?: AssistantWorkflowDirectRouteRuntimeDecisionScope;\n};\n\nexport function buildAssistantWorkflowDirectRouteInvocation(\n  input: AssistantWorkflowDirectRouteInvocationInput,\n): AssistantWorkflowDirectRouteInvocation {\n  const routeId = normalizeAssistantWorkflowId(input.routeId) ?? \"\";\n  const route = findDirectRoute(input.workflow, routeId);\n  const decision = buildAssistantWorkflowDirectRouteRuntimeDecision({\n    workflow: input.workflow,\n    routeId,\n    runtimeEnabled: input.runtimeEnabled,\n    ...(input.intentId !== undefined ? { intentId: input.intentId } : {}),\n    ...(input.policyScope ? { policyScope: input.policyScope } : {}),\n  });\n  const status: AssistantWorkflowDirectRouteInvocationStatus =\n    !route ? \"missing-route\" : decision.enabled ? \"ready\" : \"disabled\";\n\n  return {\n    workflowId: input.workflow.id,\n    workflowVersion: input.workflow.version,\n    intentId: decision.intentId,\n    routeId,\n    status,\n    enabled: decision.enabled,\n    reason: decision.reason,\n    policyRouteIds: [...decision.policyRouteIds],\n    effect: route?.effect ?? null,\n    outcomeRoute: route?.outcomeRoute ?? null,\n    requiredToolHints: [...(route?.requiredToolHints ?? [])],\n    strategyIds: (route?.strategies ?? []).map((strategy) => strategy.id),\n    strategies: (route?.strategies ?? []).map((strategy) => ({\n      id: strategy.id,\n      requiredToolHints: [...(strategy.requiredToolHints ?? [])],\n    })),\n  };\n}\n\nexport function buildAssistantWorkflowDirectRouteInvocationTracePayload(\n  invocation: AssistantWorkflowDirectRouteInvocation,\n): Record<string, unknown> {\n  return {\n    workflowId: invocation.workflowId,\n    workflowVersion: invocation.workflowVersion,\n    intent: invocation.intentId,\n    route: invocation.routeId,\n    status: invocation.status,\n    enabled: invocation.enabled,\n    reason: invocation.reason,\n    policyRouteIds: invocation.policyRouteIds,\n    effect: invocation.effect,\n    outcomeRoute: invocation.outcomeRoute,\n    requiredToolHints: invocation.requiredToolHints,\n    strategyIds: invocation.strategyIds,\n    strategies: invocation.strategies,\n  };\n}\n\nexport function buildAssistantWorkflowDirectRouteInvocationPolicyTracePayload(\n  invocation: AssistantWorkflowDirectRouteInvocation,\n): Record<string, unknown> {\n  return {\n    intent: invocation.intentId,\n    route: invocation.routeId,\n    enabled: invocation.enabled,\n    reason: invocation.reason,\n    policyRouteIds: [...invocation.policyRouteIds],\n  };\n}\n\nexport function buildAssistantWorkflowDirectRouteExecutionDecision(input: {\n  invocation: AssistantWorkflowDirectRouteInvocation;\n  expectedRouteId?: unknown;\n  observedIntentId?: unknown;\n  requireIntentMatch?: boolean;\n}): AssistantWorkflowDirectRouteExecutionDecision {\n  const expectedRouteId = normalizeAssistantWorkflowId(input.expectedRouteId) ?? null;\n  const observedIntentId = normalizeAssistantWorkflowId(input.observedIntentId) ?? null;\n  const requireIntentMatch = input.requireIntentMatch ?? input.invocation.intentId !== null;\n  const base = {\n    routeId: input.invocation.routeId,\n    expectedRouteId,\n    intentId: input.invocation.intentId,\n    observedIntentId,\n    invocationStatus: input.invocation.status,\n    enabled: input.invocation.enabled,\n  };\n\n  if (input.invocation.status !== \"ready\" || !input.invocation.enabled) {\n    return { ...base, execute: false, reason: \"invocation_not_ready\" };\n  }\n  if (expectedRouteId && input.invocation.routeId !== expectedRouteId) {\n    return { ...base, execute: false, reason: \"route_mismatch\" };\n  }\n  if (requireIntentMatch && input.invocation.intentId !== null && observedIntentId !== input.invocation.intentId) {\n    return { ...base, execute: false, reason: \"intent_mismatch\" };\n  }\n  return { ...base, execute: true, reason: \"ready\" };\n}\n\nexport function buildAssistantWorkflowDirectRouteExecutionDecisionTracePayload(\n  decision: AssistantWorkflowDirectRouteExecutionDecision,\n): Record<string, unknown> {\n  return {\n    execute: decision.execute,\n    reason: decision.reason,\n    route: decision.routeId,\n    expectedRoute: decision.expectedRouteId,\n    intent: decision.intentId,\n    observedIntent: decision.observedIntentId,\n    invocationStatus: decision.invocationStatus,\n    enabled: decision.enabled,\n  };\n}\n\nexport function buildAssistantWorkflowDirectRouteStrategyDecision(input: {\n  invocation: AssistantWorkflowDirectRouteInvocation;\n  strategyId?: unknown;\n  routeExecution?: AssistantWorkflowDirectRouteExecutionDecision;\n}): AssistantWorkflowDirectRouteStrategyDecision {\n  const strategyId = normalizeAssistantWorkflowId(input.strategyId) ?? null;\n  const routeExecution = input.routeExecution ?? buildAssistantWorkflowDirectRouteExecutionDecision({\n    invocation: input.invocation,\n  });\n  const base = {\n    routeId: input.invocation.routeId,\n    strategyId,\n    declaredStrategyIds: [...input.invocation.strategyIds],\n    routeExecutionReason: routeExecution.reason,\n    invocationStatus: input.invocation.status,\n    enabled: input.invocation.enabled,\n  };\n\n  if (!routeExecution.execute) {\n    return { ...base, execute: false, reason: \"route_not_executable\" };\n  }\n  if (!strategyId) {\n    return { ...base, execute: false, reason: \"strategy_missing\" };\n  }\n  if (!input.invocation.strategyIds.includes(strategyId)) {\n    return { ...base, execute: false, reason: \"strategy_not_declared\" };\n  }\n  return { ...base, execute: true, reason: \"ready\" };\n}\n\nexport function buildAssistantWorkflowDirectRouteStrategyDecisionTracePayload(\n  decision: AssistantWorkflowDirectRouteStrategyDecision,\n): Record<string, unknown> {\n  return {\n    execute: decision.execute,\n    reason: decision.reason,\n    route: decision.routeId,\n    strategy: decision.strategyId,\n    declaredStrategies: decision.declaredStrategyIds,\n    routeExecutionReason: decision.routeExecutionReason,\n    invocationStatus: decision.invocationStatus,\n    enabled: decision.enabled,\n  };\n}\n\nexport function buildAssistantWorkflowDirectRouteToolDecision(input: {\n  invocation: AssistantWorkflowDirectRouteInvocation;\n  toolName?: unknown;\n  routeExecution?: AssistantWorkflowDirectRouteExecutionDecision;\n  strategyDecision?: AssistantWorkflowDirectRouteStrategyDecision | null;\n}): AssistantWorkflowDirectRouteToolDecision {\n  const toolName = normalizeAssistantWorkflowId(input.toolName) ?? null;\n  const routeExecution = input.routeExecution ?? buildAssistantWorkflowDirectRouteExecutionDecision({\n    invocation: input.invocation,\n  });\n  const strategyDecision = input.strategyDecision ?? null;\n  const strategy = strategyDecision?.strategyId\n    ? findInvocationStrategy(input.invocation, strategyDecision.strategyId)\n    : null;\n  const strategyRequiredToolHints = strategy?.requiredToolHints ?? [];\n  const routeRequiredToolHints = [...input.invocation.requiredToolHints];\n  const allowedToolHints = normalizeToolHints(\n    strategyRequiredToolHints.length > 0 ? strategyRequiredToolHints : routeRequiredToolHints,\n  );\n  const base = {\n    routeId: input.invocation.routeId,\n    strategyId: strategyDecision?.strategyId ?? null,\n    toolName,\n    allowedToolHints,\n    routeRequiredToolHints,\n    strategyRequiredToolHints,\n    routeExecutionReason: routeExecution.reason,\n    strategyReason: strategyDecision?.reason ?? null,\n    invocationStatus: input.invocation.status,\n    enabled: input.invocation.enabled,\n  };\n\n  if (!routeExecution.execute) {\n    return { ...base, execute: false, reason: \"route_not_executable\" };\n  }\n  if (strategyDecision && !strategyDecision.execute) {\n    return { ...base, execute: false, reason: \"strategy_not_executable\" };\n  }\n  if (!toolName) {\n    return { ...base, execute: false, reason: \"tool_missing\" };\n  }\n  if (!allowedToolHints.includes(toolName)) {\n    return { ...base, execute: false, reason: \"tool_not_allowed\" };\n  }\n  return { ...base, execute: true, reason: \"ready\" };\n}\n\nexport function buildAssistantWorkflowDirectRouteHandlerDecision(input: {\n  invocation: AssistantWorkflowDirectRouteInvocation;\n  expectedRouteId: unknown;\n  observedIntentId?: unknown;\n  requireIntentMatch?: boolean;\n  strategyId?: unknown;\n  toolName?: unknown;\n}): AssistantWorkflowDirectRouteHandlerDecision {\n  const routeExecution = buildAssistantWorkflowDirectRouteExecutionDecision({\n    invocation: input.invocation,\n    expectedRouteId: input.expectedRouteId,\n    ...(input.observedIntentId !== undefined ? { observedIntentId: input.observedIntentId } : {}),\n    ...(input.requireIntentMatch !== undefined ? { requireIntentMatch: input.requireIntentMatch } : {}),\n  });\n  if (!routeExecution.execute) {\n    return {\n      execute: false,\n      reason: \"route_not_executable\",\n      routeExecution,\n      strategyDecision: null,\n      toolDecision: null,\n    };\n  }\n\n  const strategyDecision = input.strategyId === undefined\n    ? null\n    : buildAssistantWorkflowDirectRouteStrategyDecision({\n      invocation: input.invocation,\n      strategyId: input.strategyId,\n      routeExecution,\n    });\n  if (strategyDecision && !strategyDecision.execute) {\n    return {\n      execute: false,\n      reason: \"strategy_not_executable\",\n      routeExecution,\n      strategyDecision,\n      toolDecision: null,\n    };\n  }\n\n  const toolDecision = input.toolName === undefined\n    ? null\n    : buildAssistantWorkflowDirectRouteToolDecision({\n      invocation: input.invocation,\n      toolName: input.toolName,\n      routeExecution,\n      ...(strategyDecision ? { strategyDecision } : {}),\n    });\n  if (toolDecision && !toolDecision.execute) {\n    return {\n      execute: false,\n      reason: \"tool_not_executable\",\n      routeExecution,\n      strategyDecision,\n      toolDecision,\n    };\n  }\n\n  return {\n    execute: true,\n    reason: \"ready\",\n    routeExecution,\n    strategyDecision,\n    toolDecision,\n  };\n}\n\nexport function buildAssistantWorkflowDirectRouteHandlerPlanDecision(input: {\n  invocation: AssistantWorkflowDirectRouteInvocation;\n  expectedRouteId: unknown;\n  observedIntentId?: unknown;\n  requireIntentMatch?: boolean;\n  strategyId?: unknown;\n  toolNames?: readonly unknown[];\n}): AssistantWorkflowDirectRouteHandlerPlanDecision {\n  const handler = buildAssistantWorkflowDirectRouteHandlerDecision({\n    invocation: input.invocation,\n    expectedRouteId: input.expectedRouteId,\n    ...(input.observedIntentId !== undefined ? { observedIntentId: input.observedIntentId } : {}),\n    ...(input.requireIntentMatch !== undefined ? { requireIntentMatch: input.requireIntentMatch } : {}),\n    ...(input.strategyId !== undefined ? { strategyId: input.strategyId } : {}),\n  });\n  if (!handler.execute) {\n    return {\n      execute: false,\n      reason: handler.reason,\n      routeExecution: handler.routeExecution,\n      strategyDecision: handler.strategyDecision,\n      toolDecisions: [],\n    };\n  }\n\n  const toolDecisions = (input.toolNames ?? []).map((toolName) =>\n    buildAssistantWorkflowDirectRouteToolDecision({\n      invocation: input.invocation,\n      toolName,\n      routeExecution: handler.routeExecution,\n      ...(handler.strategyDecision ? { strategyDecision: handler.strategyDecision } : {}),\n    })\n  );\n  if (toolDecisions.some((decision) => !decision.execute)) {\n    return {\n      execute: false,\n      reason: \"tool_not_executable\",\n      routeExecution: handler.routeExecution,\n      strategyDecision: handler.strategyDecision,\n      toolDecisions,\n    };\n  }\n\n  return {\n    execute: true,\n    reason: \"ready\",\n    routeExecution: handler.routeExecution,\n    strategyDecision: handler.strategyDecision,\n    toolDecisions,\n  };\n}\n\nexport function buildAssistantWorkflowDirectRouteHandlerDecisionTracePayload(\n  decision: AssistantWorkflowDirectRouteHandlerDecision,\n): Record<string, unknown> {\n  return {\n    execute: decision.execute,\n    reason: decision.reason,\n    routeExecution: buildAssistantWorkflowDirectRouteExecutionDecisionTracePayload(decision.routeExecution),\n    strategyDecision: decision.strategyDecision\n      ? buildAssistantWorkflowDirectRouteStrategyDecisionTracePayload(decision.strategyDecision)\n      : null,\n    toolDecision: decision.toolDecision\n      ? buildAssistantWorkflowDirectRouteToolDecisionTracePayload(decision.toolDecision)\n      : null,\n  };\n}\n\nexport function buildAssistantWorkflowDirectRouteHandlerPlanDecisionTracePayload(\n  decision: AssistantWorkflowDirectRouteHandlerPlanDecision,\n): Record<string, unknown> {\n  return {\n    execute: decision.execute,\n    reason: decision.reason,\n    routeExecution: buildAssistantWorkflowDirectRouteExecutionDecisionTracePayload(decision.routeExecution),\n    strategyDecision: decision.strategyDecision\n      ? buildAssistantWorkflowDirectRouteStrategyDecisionTracePayload(decision.strategyDecision)\n      : null,\n    toolDecisions: decision.toolDecisions.map(buildAssistantWorkflowDirectRouteToolDecisionTracePayload),\n  };\n}\n\nexport function buildAssistantWorkflowDirectRouteToolDecisionTracePayload(\n  decision: AssistantWorkflowDirectRouteToolDecision,\n): Record<string, unknown> {\n  return {\n    execute: decision.execute,\n    reason: decision.reason,\n    route: decision.routeId,\n    strategy: decision.strategyId,\n    tool: decision.toolName,\n    allowedTools: decision.allowedToolHints,\n    routeRequiredTools: decision.routeRequiredToolHints,\n    strategyRequiredTools: decision.strategyRequiredToolHints,\n    routeExecutionReason: decision.routeExecutionReason,\n    strategyReason: decision.strategyReason,\n    invocationStatus: decision.invocationStatus,\n    enabled: decision.enabled,\n  };\n}\n\nfunction findDirectRoute(\n  workflow: AssistantWorkflowDefinition<string, string, string, string>,\n  routeId: string,\n): AssistantWorkflowDirectRouteDefinition | null {\n  if (!routeId) return null;\n  return workflow.directRoutes?.find((route) => route.id === routeId) ?? null;\n}\n\nfunction findInvocationStrategy(\n  invocation: AssistantWorkflowDirectRouteInvocation,\n  strategyId: string,\n): AssistantWorkflowDirectRouteStrategyInvocation | null {\n  return (invocation.strategies ?? []).find((strategy) => strategy.id === strategyId) ?? null;\n}\n\nfunction normalizeToolHints(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/direct-route-policy.d.ts

@@ -0,0 +1,25 @@
+import { type AssistantWorkflowDefinition, type AssistantWorkflowDirectRouteDefinition } from "./definition.js";
+export type AssistantWorkflowDirectRoutePolicy = {
+    intentId: string | null;
+    routeIds: string[];
+    routes: AssistantWorkflowDirectRouteDefinition[];
+    missingRouteIds: string[];
+};
+export type AssistantWorkflowDirectRouteRuntimeDecision = {
+    intentId: string | null;
+    routeId: string;
+    enabled: boolean;
+    reason: "enabled" | "runtime_disabled" | "intent_not_found" | "route_not_declared";
+    policyRouteIds: string[];
+};
+export type AssistantWorkflowDirectRouteRuntimeDecisionScope = "intent" | "catalog";
+export declare function buildAssistantWorkflowDirectRoutePolicy(workflow: AssistantWorkflowDefinition<string, string, string, string>, intentId: unknown): AssistantWorkflowDirectRoutePolicy;
+export declare function buildAssistantWorkflowDirectRouteRuntimeDecision(input: {
+    workflow: AssistantWorkflowDefinition<string, string, string, string>;
+    intentId?: unknown;
+    routeId: unknown;
+    runtimeEnabled: boolean;
+    policyScope?: AssistantWorkflowDirectRouteRuntimeDecisionScope;
+}): AssistantWorkflowDirectRouteRuntimeDecision;
+export declare function buildAssistantWorkflowDirectRouteRuntimeDecisionTracePayload(decision: AssistantWorkflowDirectRouteRuntimeDecision): Record<string, unknown>;
+//# sourceMappingURL=direct-route-policy.d.ts.map

package/dist/direct-route-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-route-policy.d.ts","sourceRoot":"","sources":["../src/direct-route-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,2BAA2B,EAChC,KAAK,sCAAsC,EAC5C,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,kCAAkC,GAAG;IAC/C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,sCAAsC,EAAE,CAAC;IACjD,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,2CAA2C,GAAG;IACxD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,kBAAkB,GAAG,kBAAkB,GAAG,oBAAoB,CAAC;IACnF,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,gDAAgD,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEpF,wBAAgB,uCAAuC,CACrD,QAAQ,EAAE,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACrE,QAAQ,EAAE,OAAO,GAChB,kCAAkC,CAiBpC;AAED,wBAAgB,gDAAgD,CAAC,KAAK,EAAE;IACtE,QAAQ,EAAE,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,gDAAgD,CAAC;CAChE,GAAG,2CAA2C,CAiE9C;AAED,wBAAgB,4DAA4D,CAC1E,QAAQ,EAAE,2CAA2C,GACpD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB"}