open-multi-agent-kit 0.80.7 → 0.90.0

package/dist/core/context-budget-v2-tiers.js

@@ -0,0 +1,68 @@
+import { ALL_TIERS_V2 } from "./context-budget-v2-types.js";
+export function computeTierDemand(plannedItems) {
+    const demand = new Map();
+    for (const tier of ALL_TIERS_V2) {
+        demand.set(tier, { demand: 0, hard: 0 });
+    }
+    for (const planned of plannedItems) {
+        const entry = demand.get(planned.item.tier) ?? { demand: 0, hard: 0 };
+        demand.set(planned.item.tier, {
+            demand: entry.demand + planned.fullTokens,
+            hard: entry.hard + (planned.isHard ? planned.fullTokens : 0),
+        });
+    }
+    return demand;
+}
+export function allocateTiers(available, policy, demand) {
+    const out = new Map();
+    const floors = {};
+    const ceilings = {};
+    const wants = {};
+    for (const tier of ALL_TIERS_V2) {
+        const floor = Math.max(0, Math.floor(policy[tier].floorPct * available));
+        const ceiling = Math.max(floor, Math.floor(policy[tier].ceilingPct * available));
+        const entry = demand.get(tier) ?? { demand: 0, hard: 0 };
+        const want = Math.max(entry.demand, entry.hard);
+        floors[tier] = floor;
+        ceilings[tier] = ceiling;
+        wants[tier] = want;
+        out.set(tier, { floor, ceiling, allocated: Math.min(want, Math.max(ceiling, entry.hard)) });
+    }
+    let totalAllocated = 0;
+    for (const tier of ALL_TIERS_V2) {
+        totalAllocated += out.get(tier)?.allocated ?? 0;
+    }
+    let residual = available - totalAllocated;
+    if (residual <= 0) {
+        return out;
+    }
+    const shortfalls = collectShortfalls(out, wants);
+    const totalGap = shortfalls.reduce((sum, shortfall) => sum + shortfall.gap, 0);
+    if (totalGap <= 0) {
+        return out;
+    }
+    for (const { tier, gap } of shortfalls) {
+        const share = Math.min(gap, Math.floor((residual * gap) / totalGap));
+        if (share <= 0)
+            continue;
+        const entry = out.get(tier);
+        if (!entry)
+            continue;
+        out.set(tier, { ...entry, allocated: entry.allocated + share });
+        residual -= share;
+    }
+    return out;
+}
+function collectShortfalls(allocations, wants) {
+    const shortfalls = [];
+    for (const tier of ALL_TIERS_V2) {
+        const entry = allocations.get(tier);
+        if (!entry)
+            continue;
+        const gap = Math.min(Math.max(0, wants[tier] - entry.allocated), Math.max(0, entry.ceiling - entry.allocated));
+        if (gap > 0)
+            shortfalls.push({ tier, gap });
+    }
+    return shortfalls;
+}
+//# sourceMappingURL=context-budget-v2-tiers.js.map

package/dist/core/context-budget-v2-tiers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-budget-v2-tiers.js","sourceRoot":"","sources":["../../src/core/context-budget-v2-tiers.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ContextBudgetTierV2 } from \"./context-budget-headroom.ts\";\nimport type { PlannedItemV2 } from \"./context-budget-v2-scoring.ts\";\nimport { ALL_TIERS_V2, type TierBudgetPolicyV2 } from \"./context-budget-v2-types.ts\";\n\nexport interface RawTierDemand {\n\treadonly demand: number;\n\treadonly hard: number;\n}\n\nexport interface RawTierAllocation {\n\treadonly floor: number;\n\treadonly ceiling: number;\n\treadonly allocated: number;\n}\n\nexport function computeTierDemand(plannedItems: readonly PlannedItemV2[]): Map<ContextBudgetTierV2, RawTierDemand> {\n\tconst demand = new Map<ContextBudgetTierV2, RawTierDemand>();\n\tfor (const tier of ALL_TIERS_V2) {\n\t\tdemand.set(tier, { demand: 0, hard: 0 });\n\t}\n\tfor (const planned of plannedItems) {\n\t\tconst entry = demand.get(planned.item.tier) ?? { demand: 0, hard: 0 };\n\t\tdemand.set(planned.item.tier, {\n\t\t\tdemand: entry.demand + planned.fullTokens,\n\t\t\thard: entry.hard + (planned.isHard ? planned.fullTokens : 0),\n\t\t});\n\t}\n\treturn demand;\n}\n\nexport function allocateTiers(\n\tavailable: number,\n\tpolicy: Readonly<Record<ContextBudgetTierV2, TierBudgetPolicyV2>>,\n\tdemand: Map<ContextBudgetTierV2, RawTierDemand>,\n): Map<ContextBudgetTierV2, RawTierAllocation> {\n\tconst out = new Map<ContextBudgetTierV2, RawTierAllocation>();\n\tconst floors = {} as Record<ContextBudgetTierV2, number>;\n\tconst ceilings = {} as Record<ContextBudgetTierV2, number>;\n\tconst wants = {} as Record<ContextBudgetTierV2, number>;\n\n\tfor (const tier of ALL_TIERS_V2) {\n\t\tconst floor = Math.max(0, Math.floor(policy[tier].floorPct * available));\n\t\tconst ceiling = Math.max(floor, Math.floor(policy[tier].ceilingPct * available));\n\t\tconst entry = demand.get(tier) ?? { demand: 0, hard: 0 };\n\t\tconst want = Math.max(entry.demand, entry.hard);\n\t\tfloors[tier] = floor;\n\t\tceilings[tier] = ceiling;\n\t\twants[tier] = want;\n\t\tout.set(tier, { floor, ceiling, allocated: Math.min(want, Math.max(ceiling, entry.hard)) });\n\t}\n\n\tlet totalAllocated = 0;\n\tfor (const tier of ALL_TIERS_V2) {\n\t\ttotalAllocated += out.get(tier)?.allocated ?? 0;\n\t}\n\tlet residual = available - totalAllocated;\n\tif (residual <= 0) {\n\t\treturn out;\n\t}\n\n\tconst shortfalls = collectShortfalls(out, wants);\n\tconst totalGap = shortfalls.reduce((sum, shortfall) => sum + shortfall.gap, 0);\n\tif (totalGap <= 0) {\n\t\treturn out;\n\t}\n\tfor (const { tier, gap } of shortfalls) {\n\t\tconst share = Math.min(gap, Math.floor((residual * gap) / totalGap));\n\t\tif (share <= 0) continue;\n\t\tconst entry = out.get(tier);\n\t\tif (!entry) continue;\n\t\tout.set(tier, { ...entry, allocated: entry.allocated + share });\n\t\tresidual -= share;\n\t}\n\treturn out;\n}\n\nfunction collectShortfalls(\n\tallocations: ReadonlyMap<ContextBudgetTierV2, RawTierAllocation>,\n\twants: Record<ContextBudgetTierV2, number>,\n): { tier: ContextBudgetTierV2; gap: number }[] {\n\tconst shortfalls: { tier: ContextBudgetTierV2; gap: number }[] = [];\n\tfor (const tier of ALL_TIERS_V2) {\n\t\tconst entry = allocations.get(tier);\n\t\tif (!entry) continue;\n\t\tconst gap = Math.min(Math.max(0, wants[tier] - entry.allocated), Math.max(0, entry.ceiling - entry.allocated));\n\t\tif (gap > 0) shortfalls.push({ tier, gap });\n\t}\n\treturn shortfalls;\n}\n"]}

package/dist/core/context-budget-v2-types.d.ts

@@ -0,0 +1,92 @@
+import type { ContextBudgetItemV2, ContextBudgetTierV2, ContextRepresentationCandidateV2, ContextRepresentationKindV2, ContextSourceRefV2, HeadroomQualityPolicyV2 } from "./context-budget-headroom.ts";
+import type { TokenCounterAdapter } from "./context-budget-token-counter.ts";
+import type { TokenOptimizerRuntimeStatus } from "./token-optimizer.ts";
+export declare const CONTEXT_BUDGET_POLICY_VERSION_V2 = "context-budget-v2";
+export interface TierBudgetPolicyV2 {
+    readonly floorPct: number;
+    readonly ceilingPct: number;
+}
+export declare const DEFAULT_TIER_POLICY_V2: Readonly<Record<ContextBudgetTierV2, TierBudgetPolicyV2>>;
+export declare const ALL_TIERS_V2: readonly ContextBudgetTierV2[];
+export interface PromptContextBudgetInputV2 {
+    readonly maxTokens: number;
+    readonly responseReserveTokens?: number;
+    readonly safetyMarginTokens?: number;
+    readonly modelId?: string;
+    readonly policyVersion?: string;
+    readonly promptHash?: string;
+    readonly query?: string;
+    readonly items: readonly ContextBudgetItemV2[];
+    readonly tokenCounter?: TokenCounterAdapter;
+    readonly tierPolicy?: Partial<Record<ContextBudgetTierV2, TierBudgetPolicyV2>>;
+    readonly qualityPolicy?: HeadroomQualityPolicyV2;
+}
+export interface SelectedRepresentationV2 {
+    readonly itemId: string;
+    readonly kind: ContextRepresentationKindV2;
+    readonly text: string;
+    readonly estimatedTokens: number;
+    readonly fidelity: ContextRepresentationCandidateV2["fidelity"];
+    readonly sourceRef?: ContextSourceRefV2;
+    readonly summaryHash?: string;
+    readonly compressorId?: string;
+}
+export interface TierBudgetAllocationV2 {
+    readonly tier: ContextBudgetTierV2;
+    readonly floorTokens: number;
+    readonly ceilingTokens: number;
+    readonly allocatedTokens: number;
+    readonly usedTokens: number;
+    readonly hardTokens: number;
+}
+export type QualityDiagnosticReasonV2 = "omitted_high_priority" | "retrieval_miss_risk" | "restore_on_demand_hint" | "hard_pin_over_capacity" | "coverage_gap" | "tier_ceiling_exceeded" | "invalid_budget";
+export interface QualityDiagnosticV2 {
+    readonly reason: QualityDiagnosticReasonV2;
+    readonly itemId?: string;
+    readonly detail: string;
+}
+export interface ContextBudgetObservabilityCountsV2 {
+    readonly selected: number;
+    readonly omitted: number;
+    readonly pointer: number;
+    readonly compressed: number;
+    readonly full: number;
+    readonly retrievalFallback: number;
+}
+export interface ContextBudgetObservabilityTokensV2 {
+    readonly available: number;
+    readonly used: number;
+    readonly raw: number;
+    readonly omitted: number;
+    readonly tokenSavings: number;
+}
+export interface PromptContextBudgetObservabilityV2 {
+    readonly counts: ContextBudgetObservabilityCountsV2;
+    readonly diagnosticReasons: readonly QualityDiagnosticReasonV2[];
+    readonly tokens: ContextBudgetObservabilityTokensV2;
+    readonly planHash: string;
+    readonly tokenOptimizer: TokenOptimizerRuntimeStatus;
+}
+export interface PromptContextBudgetPlanV2 {
+    readonly policyVersion: string;
+    readonly promptHash?: string;
+    readonly planHash: string;
+    readonly maxTokens: number;
+    readonly responseReserveTokens: number;
+    readonly safetyMarginTokens: number;
+    readonly availableTokens: number;
+    readonly usedTokens: number;
+    readonly omittedTokens: number;
+    readonly rawTokens: number;
+    readonly tokenSavingsRatio: number;
+    readonly emergency: boolean;
+    readonly omittedHighPriority: boolean;
+    readonly tierAllocations: readonly TierBudgetAllocationV2[];
+    readonly selectedRepresentations: readonly SelectedRepresentationV2[];
+    readonly includedItemIds: readonly string[];
+    readonly omittedItemIds: readonly string[];
+    readonly diagnostics: readonly QualityDiagnosticV2[];
+    readonly retrievalFallbacks: readonly ContextSourceRefV2[];
+    readonly observability: PromptContextBudgetObservabilityV2;
+}
+//# sourceMappingURL=context-budget-v2-types.d.ts.map

package/dist/core/context-budget-v2-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-budget-v2-types.d.ts","sourceRoot":"","sources":["../../src/core/context-budget-v2-types.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n\tContextBudgetItemV2,\n\tContextBudgetTierV2,\n\tContextRepresentationCandidateV2,\n\tContextRepresentationKindV2,\n\tContextSourceRefV2,\n\tHeadroomQualityPolicyV2,\n} from \"./context-budget-headroom.ts\";\nimport type { TokenCounterAdapter } from \"./context-budget-token-counter.ts\";\nimport type { TokenOptimizerRuntimeStatus } from \"./token-optimizer.ts\";\n\nexport const CONTEXT_BUDGET_POLICY_VERSION_V2 = \"context-budget-v2\";\n\nexport interface TierBudgetPolicyV2 {\n\treadonly floorPct: number;\n\treadonly ceilingPct: number;\n}\n\nexport const DEFAULT_TIER_POLICY_V2: Readonly<Record<ContextBudgetTierV2, TierBudgetPolicyV2>> = {\n\tsystem: { floorPct: 0.25, ceilingPct: 0.45 },\n\t\"active-goal\": { floorPct: 0.1, ceilingPct: 0.25 },\n\t\"current-files\": { floorPct: 0.08, ceilingPct: 0.2 },\n\ttools: { floorPct: 0.04, ceilingPct: 0.12 },\n\tskills: { floorPct: 0.03, ceilingPct: 0.12 },\n\tmcp: { floorPct: 0.02, ceilingPct: 0.08 },\n\thistory: { floorPct: 0.1, ceilingPct: 0.3 },\n\tevidence: { floorPct: 0.08, ceilingPct: 0.25 },\n\tscratch: { floorPct: 0, ceilingPct: 0.05 },\n};\n\nexport const ALL_TIERS_V2: readonly ContextBudgetTierV2[] = [\n\t\"system\",\n\t\"active-goal\",\n\t\"current-files\",\n\t\"tools\",\n\t\"skills\",\n\t\"mcp\",\n\t\"history\",\n\t\"evidence\",\n\t\"scratch\",\n];\n\nexport interface PromptContextBudgetInputV2 {\n\treadonly maxTokens: number;\n\treadonly responseReserveTokens?: number;\n\treadonly safetyMarginTokens?: number;\n\treadonly modelId?: string;\n\treadonly policyVersion?: string;\n\treadonly promptHash?: string;\n\treadonly query?: string;\n\treadonly items: readonly ContextBudgetItemV2[];\n\treadonly tokenCounter?: TokenCounterAdapter;\n\treadonly tierPolicy?: Partial<Record<ContextBudgetTierV2, TierBudgetPolicyV2>>;\n\treadonly qualityPolicy?: HeadroomQualityPolicyV2;\n}\n\nexport interface SelectedRepresentationV2 {\n\treadonly itemId: string;\n\treadonly kind: ContextRepresentationKindV2;\n\treadonly text: string;\n\treadonly estimatedTokens: number;\n\treadonly fidelity: ContextRepresentationCandidateV2[\"fidelity\"];\n\treadonly sourceRef?: ContextSourceRefV2;\n\treadonly summaryHash?: string;\n\treadonly compressorId?: string;\n}\n\nexport interface TierBudgetAllocationV2 {\n\treadonly tier: ContextBudgetTierV2;\n\treadonly floorTokens: number;\n\treadonly ceilingTokens: number;\n\treadonly allocatedTokens: number;\n\treadonly usedTokens: number;\n\treadonly hardTokens: number;\n}\n\nexport type QualityDiagnosticReasonV2 =\n\t| \"omitted_high_priority\"\n\t| \"retrieval_miss_risk\"\n\t| \"restore_on_demand_hint\"\n\t| \"hard_pin_over_capacity\"\n\t| \"coverage_gap\"\n\t| \"tier_ceiling_exceeded\"\n\t| \"invalid_budget\";\n\nexport interface QualityDiagnosticV2 {\n\treadonly reason: QualityDiagnosticReasonV2;\n\treadonly itemId?: string;\n\treadonly detail: string;\n}\n\nexport interface ContextBudgetObservabilityCountsV2 {\n\treadonly selected: number;\n\treadonly omitted: number;\n\treadonly pointer: number;\n\treadonly compressed: number;\n\treadonly full: number;\n\treadonly retrievalFallback: number;\n}\n\nexport interface ContextBudgetObservabilityTokensV2 {\n\treadonly available: number;\n\treadonly used: number;\n\treadonly raw: number;\n\treadonly omitted: number;\n\treadonly tokenSavings: number;\n}\n\nexport interface PromptContextBudgetObservabilityV2 {\n\treadonly counts: ContextBudgetObservabilityCountsV2;\n\treadonly diagnosticReasons: readonly QualityDiagnosticReasonV2[];\n\treadonly tokens: ContextBudgetObservabilityTokensV2;\n\treadonly planHash: string;\n\treadonly tokenOptimizer: TokenOptimizerRuntimeStatus;\n}\n\nexport interface PromptContextBudgetPlanV2 {\n\treadonly policyVersion: string;\n\treadonly promptHash?: string;\n\treadonly planHash: string;\n\treadonly maxTokens: number;\n\treadonly responseReserveTokens: number;\n\treadonly safetyMarginTokens: number;\n\treadonly availableTokens: number;\n\treadonly usedTokens: number;\n\treadonly omittedTokens: number;\n\treadonly rawTokens: number;\n\treadonly tokenSavingsRatio: number;\n\treadonly emergency: boolean;\n\treadonly omittedHighPriority: boolean;\n\treadonly tierAllocations: readonly TierBudgetAllocationV2[];\n\treadonly selectedRepresentations: readonly SelectedRepresentationV2[];\n\treadonly includedItemIds: readonly string[];\n\treadonly omittedItemIds: readonly string[];\n\treadonly diagnostics: readonly QualityDiagnosticV2[];\n\treadonly retrievalFallbacks: readonly ContextSourceRefV2[];\n\treadonly observability: PromptContextBudgetObservabilityV2;\n}\n"]}

package/dist/core/context-budget-v2-types.js

@@ -0,0 +1,24 @@
+export const CONTEXT_BUDGET_POLICY_VERSION_V2 = "context-budget-v2";
+export const DEFAULT_TIER_POLICY_V2 = {
+    system: { floorPct: 0.25, ceilingPct: 0.45 },
+    "active-goal": { floorPct: 0.1, ceilingPct: 0.25 },
+    "current-files": { floorPct: 0.08, ceilingPct: 0.2 },
+    tools: { floorPct: 0.04, ceilingPct: 0.12 },
+    skills: { floorPct: 0.03, ceilingPct: 0.12 },
+    mcp: { floorPct: 0.02, ceilingPct: 0.08 },
+    history: { floorPct: 0.1, ceilingPct: 0.3 },
+    evidence: { floorPct: 0.08, ceilingPct: 0.25 },
+    scratch: { floorPct: 0, ceilingPct: 0.05 },
+};
+export const ALL_TIERS_V2 = [
+    "system",
+    "active-goal",
+    "current-files",
+    "tools",
+    "skills",
+    "mcp",
+    "history",
+    "evidence",
+    "scratch",
+];
+//# sourceMappingURL=context-budget-v2-types.js.map

package/dist/core/context-budget-v2-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-budget-v2-types.js","sourceRoot":"","sources":["../../src/core/context-budget-v2-types.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,gCAAgC,GAAG,mBAAmB,CAAC;AAOpE,MAAM,CAAC,MAAM,sBAAsB,GAA8D;IAChG,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;IAC5C,aAAa,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE;IAClD,eAAe,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE;IACpD,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;IAC3C,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;IAC5C,GAAG,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;IACzC,OAAO,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE;IAC3C,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;IAC9C,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE;CAC1C,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAmC;IAC3D,QAAQ;IACR,aAAa;IACb,eAAe;IACf,OAAO;IACP,QAAQ;IACR,KAAK;IACL,SAAS;IACT,UAAU;IACV,SAAS;CACT,CAAC","sourcesContent":["import type {\n\tContextBudgetItemV2,\n\tContextBudgetTierV2,\n\tContextRepresentationCandidateV2,\n\tContextRepresentationKindV2,\n\tContextSourceRefV2,\n\tHeadroomQualityPolicyV2,\n} from \"./context-budget-headroom.ts\";\nimport type { TokenCounterAdapter } from \"./context-budget-token-counter.ts\";\nimport type { TokenOptimizerRuntimeStatus } from \"./token-optimizer.ts\";\n\nexport const CONTEXT_BUDGET_POLICY_VERSION_V2 = \"context-budget-v2\";\n\nexport interface TierBudgetPolicyV2 {\n\treadonly floorPct: number;\n\treadonly ceilingPct: number;\n}\n\nexport const DEFAULT_TIER_POLICY_V2: Readonly<Record<ContextBudgetTierV2, TierBudgetPolicyV2>> = {\n\tsystem: { floorPct: 0.25, ceilingPct: 0.45 },\n\t\"active-goal\": { floorPct: 0.1, ceilingPct: 0.25 },\n\t\"current-files\": { floorPct: 0.08, ceilingPct: 0.2 },\n\ttools: { floorPct: 0.04, ceilingPct: 0.12 },\n\tskills: { floorPct: 0.03, ceilingPct: 0.12 },\n\tmcp: { floorPct: 0.02, ceilingPct: 0.08 },\n\thistory: { floorPct: 0.1, ceilingPct: 0.3 },\n\tevidence: { floorPct: 0.08, ceilingPct: 0.25 },\n\tscratch: { floorPct: 0, ceilingPct: 0.05 },\n};\n\nexport const ALL_TIERS_V2: readonly ContextBudgetTierV2[] = [\n\t\"system\",\n\t\"active-goal\",\n\t\"current-files\",\n\t\"tools\",\n\t\"skills\",\n\t\"mcp\",\n\t\"history\",\n\t\"evidence\",\n\t\"scratch\",\n];\n\nexport interface PromptContextBudgetInputV2 {\n\treadonly maxTokens: number;\n\treadonly responseReserveTokens?: number;\n\treadonly safetyMarginTokens?: number;\n\treadonly modelId?: string;\n\treadonly policyVersion?: string;\n\treadonly promptHash?: string;\n\treadonly query?: string;\n\treadonly items: readonly ContextBudgetItemV2[];\n\treadonly tokenCounter?: TokenCounterAdapter;\n\treadonly tierPolicy?: Partial<Record<ContextBudgetTierV2, TierBudgetPolicyV2>>;\n\treadonly qualityPolicy?: HeadroomQualityPolicyV2;\n}\n\nexport interface SelectedRepresentationV2 {\n\treadonly itemId: string;\n\treadonly kind: ContextRepresentationKindV2;\n\treadonly text: string;\n\treadonly estimatedTokens: number;\n\treadonly fidelity: ContextRepresentationCandidateV2[\"fidelity\"];\n\treadonly sourceRef?: ContextSourceRefV2;\n\treadonly summaryHash?: string;\n\treadonly compressorId?: string;\n}\n\nexport interface TierBudgetAllocationV2 {\n\treadonly tier: ContextBudgetTierV2;\n\treadonly floorTokens: number;\n\treadonly ceilingTokens: number;\n\treadonly allocatedTokens: number;\n\treadonly usedTokens: number;\n\treadonly hardTokens: number;\n}\n\nexport type QualityDiagnosticReasonV2 =\n\t| \"omitted_high_priority\"\n\t| \"retrieval_miss_risk\"\n\t| \"restore_on_demand_hint\"\n\t| \"hard_pin_over_capacity\"\n\t| \"coverage_gap\"\n\t| \"tier_ceiling_exceeded\"\n\t| \"invalid_budget\";\n\nexport interface QualityDiagnosticV2 {\n\treadonly reason: QualityDiagnosticReasonV2;\n\treadonly itemId?: string;\n\treadonly detail: string;\n}\n\nexport interface ContextBudgetObservabilityCountsV2 {\n\treadonly selected: number;\n\treadonly omitted: number;\n\treadonly pointer: number;\n\treadonly compressed: number;\n\treadonly full: number;\n\treadonly retrievalFallback: number;\n}\n\nexport interface ContextBudgetObservabilityTokensV2 {\n\treadonly available: number;\n\treadonly used: number;\n\treadonly raw: number;\n\treadonly omitted: number;\n\treadonly tokenSavings: number;\n}\n\nexport interface PromptContextBudgetObservabilityV2 {\n\treadonly counts: ContextBudgetObservabilityCountsV2;\n\treadonly diagnosticReasons: readonly QualityDiagnosticReasonV2[];\n\treadonly tokens: ContextBudgetObservabilityTokensV2;\n\treadonly planHash: string;\n\treadonly tokenOptimizer: TokenOptimizerRuntimeStatus;\n}\n\nexport interface PromptContextBudgetPlanV2 {\n\treadonly policyVersion: string;\n\treadonly promptHash?: string;\n\treadonly planHash: string;\n\treadonly maxTokens: number;\n\treadonly responseReserveTokens: number;\n\treadonly safetyMarginTokens: number;\n\treadonly availableTokens: number;\n\treadonly usedTokens: number;\n\treadonly omittedTokens: number;\n\treadonly rawTokens: number;\n\treadonly tokenSavingsRatio: number;\n\treadonly emergency: boolean;\n\treadonly omittedHighPriority: boolean;\n\treadonly tierAllocations: readonly TierBudgetAllocationV2[];\n\treadonly selectedRepresentations: readonly SelectedRepresentationV2[];\n\treadonly includedItemIds: readonly string[];\n\treadonly omittedItemIds: readonly string[];\n\treadonly diagnostics: readonly QualityDiagnosticV2[];\n\treadonly retrievalFallbacks: readonly ContextSourceRefV2[];\n\treadonly observability: PromptContextBudgetObservabilityV2;\n}\n"]}

package/dist/core/defaults.d.ts

@@ -1,3 +1,3 @@
-import type { ThinkingLevel } from "@earendil-works/omk-agent-core";
+import type { ThinkingLevel } from "omk-agent-core";
 export declare const DEFAULT_THINKING_LEVEL: ThinkingLevel;
 //# sourceMappingURL=defaults.d.ts.map

package/dist/core/defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/core/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAEpE,eAAO,MAAM,sBAAsB,EAAE,aAAwB,CAAC","sourcesContent":["import type { ThinkingLevel } from \"@earendil-works/omk-agent-core\";\n\nexport const DEFAULT_THINKING_LEVEL: ThinkingLevel = \"medium\";\n"]}
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/core/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,eAAO,MAAM,sBAAsB,EAAE,aAAwB,CAAC","sourcesContent":["import type { ThinkingLevel } from \"omk-agent-core\";\n\nexport const DEFAULT_THINKING_LEVEL: ThinkingLevel = \"medium\";\n"]}

package/dist/core/defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/core/defaults.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,sBAAsB,GAAkB,QAAQ,CAAC","sourcesContent":["import type { ThinkingLevel } from \"@earendil-works/omk-agent-core\";\n\nexport const DEFAULT_THINKING_LEVEL: ThinkingLevel = \"medium\";\n"]}
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/core/defaults.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,sBAAsB,GAAkB,QAAQ,CAAC","sourcesContent":["import type { ThinkingLevel } from \"omk-agent-core\";\n\nexport const DEFAULT_THINKING_LEVEL: ThinkingLevel = \"medium\";\n"]}

package/dist/core/diagnostics.d.ts

@@ -5,6 +5,12 @@ export interface ResourceCollision {
     loserPath: string;
     winnerSource?: string;
     loserSource?: string;
+    winnerScope?: "user" | "project" | "temporary";
+    loserScope?: "user" | "project" | "temporary";
+    winnerOrigin?: "package" | "top-level";
+    loserOrigin?: "package" | "top-level";
+    resolutionReason?: string;
+    resolutionAction?: string;
 }
 export interface ResourceDiagnostic {
     type: "warning" | "error" | "collision";

package/dist/core/diagnostics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/core/diagnostics.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IACjC,YAAY,EAAE,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC9B","sourcesContent":["export interface ResourceCollision {\n\tresourceType: \"extension\" | \"skill\" | \"prompt\" | \"theme\";\n\tname: string; // skill name, command/tool/flag name, prompt name, theme name\n\twinnerPath: string;\n\tloserPath: string;\n\twinnerSource?: string; // e.g., \"npm:foo\", \"git:...\", \"local\"\n\tloserSource?: string;\n}\n\nexport interface ResourceDiagnostic {\n\ttype: \"warning\" | \"error\" | \"collision\";\n\tmessage: string;\n\tpath?: string;\n\tcollision?: ResourceCollision;\n}\n"]}
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/core/diagnostics.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IACjC,YAAY,EAAE,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC;IAC/C,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC;IAC9C,YAAY,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC;IACvC,WAAW,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC9B","sourcesContent":["export interface ResourceCollision {\n\tresourceType: \"extension\" | \"skill\" | \"prompt\" | \"theme\";\n\tname: string; // skill name, command/tool/flag name, prompt name, theme name\n\twinnerPath: string;\n\tloserPath: string;\n\twinnerSource?: string; // e.g., \"npm:foo\", \"git:...\", \"local\"\n\tloserSource?: string;\n\twinnerScope?: \"user\" | \"project\" | \"temporary\";\n\tloserScope?: \"user\" | \"project\" | \"temporary\";\n\twinnerOrigin?: \"package\" | \"top-level\";\n\tloserOrigin?: \"package\" | \"top-level\";\n\tresolutionReason?: string;\n\tresolutionAction?: string;\n}\n\nexport interface ResourceDiagnostic {\n\ttype: \"warning\" | \"error\" | \"collision\";\n\tmessage: string;\n\tpath?: string;\n\tcollision?: ResourceCollision;\n}\n"]}

package/dist/core/diagnostics.js.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/core/diagnostics.ts"],"names":[],"mappings":"","sourcesContent":["export interface ResourceCollision {\n\tresourceType: \"extension\" | \"skill\" | \"prompt\" | \"theme\";\n\tname: string; // skill name, command/tool/flag name, prompt name, theme name\n\twinnerPath: string;\n\tloserPath: string;\n\twinnerSource?: string; // e.g., \"npm:foo\", \"git:...\", \"local\"\n\tloserSource?: string;\n}\n\nexport interface ResourceDiagnostic {\n\ttype: \"warning\" | \"error\" | \"collision\";\n\tmessage: string;\n\tpath?: string;\n\tcollision?: ResourceCollision;\n}\n"]}
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/core/diagnostics.ts"],"names":[],"mappings":"","sourcesContent":["export interface ResourceCollision {\n\tresourceType: \"extension\" | \"skill\" | \"prompt\" | \"theme\";\n\tname: string; // skill name, command/tool/flag name, prompt name, theme name\n\twinnerPath: string;\n\tloserPath: string;\n\twinnerSource?: string; // e.g., \"npm:foo\", \"git:...\", \"local\"\n\tloserSource?: string;\n\twinnerScope?: \"user\" | \"project\" | \"temporary\";\n\tloserScope?: \"user\" | \"project\" | \"temporary\";\n\twinnerOrigin?: \"package\" | \"top-level\";\n\tloserOrigin?: \"package\" | \"top-level\";\n\tresolutionReason?: string;\n\tresolutionAction?: string;\n}\n\nexport interface ResourceDiagnostic {\n\ttype: \"warning\" | \"error\" | \"collision\";\n\tmessage: string;\n\tpath?: string;\n\tcollision?: ResourceCollision;\n}\n"]}

package/dist/core/domain-confidence.d.ts

@@ -0,0 +1,9 @@
+import type { DomainProfile, DomainScore, RouteResult } from "./domain-types.ts";
+/** Score at/above which a domain is treated as a confident match. */
+export declare const STRONG_THRESHOLD = 8;
+/** Minimum non-zero score to avoid falling back to "general". */
+export declare const WEAK_THRESHOLD = 4;
+/** If the runner-up is within this margin of the leader (and leader < STRONG), flag ambiguous. */
+export declare const AMBIGUITY_MARGIN = 2;
+export declare function selectRoute(scores: readonly DomainScore[], registry: Readonly<Record<string, DomainProfile>>, fallbackDomainId?: string): RouteResult;
+//# sourceMappingURL=domain-confidence.d.ts.map

package/dist/core/domain-confidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-confidence.d.ts","sourceRoot":"","sources":["../../src/core/domain-confidence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAmB,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAElG,qEAAqE;AACrE,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC,iEAAiE;AACjE,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,kGAAkG;AAClG,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAUlC,wBAAgB,WAAW,CAC1B,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,EACjD,gBAAgB,SAAY,GAC1B,WAAW,CA0Bb","sourcesContent":["import type { DomainProfile, DomainScore, RouteConfidence, RouteResult } from \"./domain-types.ts\";\n\n/** Score at/above which a domain is treated as a confident match. */\nexport const STRONG_THRESHOLD = 8;\n/** Minimum non-zero score to avoid falling back to \"general\". */\nexport const WEAK_THRESHOLD = 4;\n/** If the runner-up is within this margin of the leader (and leader < STRONG), flag ambiguous. */\nexport const AMBIGUITY_MARGIN = 2;\n\nfunction fallbackProfile(registry: Readonly<Record<string, DomainProfile>>, fallbackDomainId: string): DomainProfile {\n\tconst fallback = registry[fallbackDomainId];\n\tif (fallback) return fallback;\n\tconst firstProfile = Object.values(registry)[0];\n\tif (firstProfile) return firstProfile;\n\tthrow new Error(\"domain registry must contain at least one profile\");\n}\n\nexport function selectRoute(\n\tscores: readonly DomainScore[],\n\tregistry: Readonly<Record<string, DomainProfile>>,\n\tfallbackDomainId = \"general\",\n): RouteResult {\n\tconst fallback = fallbackProfile(registry, fallbackDomainId);\n\tif (scores.length === 0 || scores[0].score < WEAK_THRESHOLD) {\n\t\treturn {\n\t\t\tprimary: fallback,\n\t\t\tscores,\n\t\t\tconfidence: \"fallback\",\n\t\t\treason:\n\t\t\t\tscores.length === 0\n\t\t\t\t\t? \"no domain signals detected\"\n\t\t\t\t\t: `best signal (${scores[0].label}=${scores[0].score}) below weak threshold (${WEAK_THRESHOLD})`,\n\t\t\tambiguous: false,\n\t\t};\n\t}\n\n\tconst leader = scores[0];\n\tconst runner = scores[1];\n\tconst ambiguous =\n\t\trunner !== undefined && leader.score < STRONG_THRESHOLD && leader.score - runner.score <= AMBIGUITY_MARGIN;\n\tconst confidence: RouteConfidence = leader.score >= STRONG_THRESHOLD ? \"confident\" : \"tentative\";\n\tconst primary = registry[leader.id] ?? fallback;\n\tconst reason = ambiguous\n\t\t? `ambiguous: ${leader.label}(${leader.score}) vs ${runner.label}(${runner.score})`\n\t\t: `${leader.label} selected (${leader.score})`;\n\n\treturn { primary, scores, confidence, reason, ambiguous };\n}\n"]}

package/dist/core/domain-confidence.js

@@ -0,0 +1,39 @@
+/** Score at/above which a domain is treated as a confident match. */
+export const STRONG_THRESHOLD = 8;
+/** Minimum non-zero score to avoid falling back to "general". */
+export const WEAK_THRESHOLD = 4;
+/** If the runner-up is within this margin of the leader (and leader < STRONG), flag ambiguous. */
+export const AMBIGUITY_MARGIN = 2;
+function fallbackProfile(registry, fallbackDomainId) {
+    const fallback = registry[fallbackDomainId];
+    if (fallback)
+        return fallback;
+    const firstProfile = Object.values(registry)[0];
+    if (firstProfile)
+        return firstProfile;
+    throw new Error("domain registry must contain at least one profile");
+}
+export function selectRoute(scores, registry, fallbackDomainId = "general") {
+    const fallback = fallbackProfile(registry, fallbackDomainId);
+    if (scores.length === 0 || scores[0].score < WEAK_THRESHOLD) {
+        return {
+            primary: fallback,
+            scores,
+            confidence: "fallback",
+            reason: scores.length === 0
+                ? "no domain signals detected"
+                : `best signal (${scores[0].label}=${scores[0].score}) below weak threshold (${WEAK_THRESHOLD})`,
+            ambiguous: false,
+        };
+    }
+    const leader = scores[0];
+    const runner = scores[1];
+    const ambiguous = runner !== undefined && leader.score < STRONG_THRESHOLD && leader.score - runner.score <= AMBIGUITY_MARGIN;
+    const confidence = leader.score >= STRONG_THRESHOLD ? "confident" : "tentative";
+    const primary = registry[leader.id] ?? fallback;
+    const reason = ambiguous
+        ? `ambiguous: ${leader.label}(${leader.score}) vs ${runner.label}(${runner.score})`
+        : `${leader.label} selected (${leader.score})`;
+    return { primary, scores, confidence, reason, ambiguous };
+}
+//# sourceMappingURL=domain-confidence.js.map

package/dist/core/domain-confidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-confidence.js","sourceRoot":"","sources":["../../src/core/domain-confidence.ts"],"names":[],"mappings":"AAEA,qEAAqE;AACrE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAClC,iEAAiE;AACjE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAChC,kGAAkG;AAClG,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAElC,SAAS,eAAe,CAAC,QAAiD,EAAE,gBAAwB,EAAiB;IACpH,MAAM,QAAQ,GAAG,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAC5C,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,IAAI,YAAY;QAAE,OAAO,YAAY,CAAC;IACtC,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;AAAA,CACrE;AAED,MAAM,UAAU,WAAW,CAC1B,MAA8B,EAC9B,QAAiD,EACjD,gBAAgB,GAAG,SAAS,EACd;IACd,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;IAC7D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,cAAc,EAAE,CAAC;QAC7D,OAAO;YACN,OAAO,EAAE,QAAQ;YACjB,MAAM;YACN,UAAU,EAAE,UAAU;YACtB,MAAM,EACL,MAAM,CAAC,MAAM,KAAK,CAAC;gBAClB,CAAC,CAAC,4BAA4B;gBAC9B,CAAC,CAAC,gBAAgB,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,2BAA2B,cAAc,GAAG;YAClG,SAAS,EAAE,KAAK;SAChB,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,SAAS,GACd,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,GAAG,gBAAgB,IAAI,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,gBAAgB,CAAC;IAC5G,MAAM,UAAU,GAAoB,MAAM,CAAC,KAAK,IAAI,gBAAgB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC;IACjG,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,QAAQ,CAAC;IAChD,MAAM,MAAM,GAAG,SAAS;QACvB,CAAC,CAAC,cAAc,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,QAAQ,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,GAAG;QACnF,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,cAAc,MAAM,CAAC,KAAK,GAAG,CAAC;IAEhD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAAA,CAC1D","sourcesContent":["import type { DomainProfile, DomainScore, RouteConfidence, RouteResult } from \"./domain-types.ts\";\n\n/** Score at/above which a domain is treated as a confident match. */\nexport const STRONG_THRESHOLD = 8;\n/** Minimum non-zero score to avoid falling back to \"general\". */\nexport const WEAK_THRESHOLD = 4;\n/** If the runner-up is within this margin of the leader (and leader < STRONG), flag ambiguous. */\nexport const AMBIGUITY_MARGIN = 2;\n\nfunction fallbackProfile(registry: Readonly<Record<string, DomainProfile>>, fallbackDomainId: string): DomainProfile {\n\tconst fallback = registry[fallbackDomainId];\n\tif (fallback) return fallback;\n\tconst firstProfile = Object.values(registry)[0];\n\tif (firstProfile) return firstProfile;\n\tthrow new Error(\"domain registry must contain at least one profile\");\n}\n\nexport function selectRoute(\n\tscores: readonly DomainScore[],\n\tregistry: Readonly<Record<string, DomainProfile>>,\n\tfallbackDomainId = \"general\",\n): RouteResult {\n\tconst fallback = fallbackProfile(registry, fallbackDomainId);\n\tif (scores.length === 0 || scores[0].score < WEAK_THRESHOLD) {\n\t\treturn {\n\t\t\tprimary: fallback,\n\t\t\tscores,\n\t\t\tconfidence: \"fallback\",\n\t\t\treason:\n\t\t\t\tscores.length === 0\n\t\t\t\t\t? \"no domain signals detected\"\n\t\t\t\t\t: `best signal (${scores[0].label}=${scores[0].score}) below weak threshold (${WEAK_THRESHOLD})`,\n\t\t\tambiguous: false,\n\t\t};\n\t}\n\n\tconst leader = scores[0];\n\tconst runner = scores[1];\n\tconst ambiguous =\n\t\trunner !== undefined && leader.score < STRONG_THRESHOLD && leader.score - runner.score <= AMBIGUITY_MARGIN;\n\tconst confidence: RouteConfidence = leader.score >= STRONG_THRESHOLD ? \"confident\" : \"tentative\";\n\tconst primary = registry[leader.id] ?? fallback;\n\tconst reason = ambiguous\n\t\t? `ambiguous: ${leader.label}(${leader.score}) vs ${runner.label}(${runner.score})`\n\t\t: `${leader.label} selected (${leader.score})`;\n\n\treturn { primary, scores, confidence, reason, ambiguous };\n}\n"]}

package/dist/core/domain-dispatch.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Opt-in domain dispatch orchestration.
+ *
+ * Callers can invoke it to route an initial prompt, compose a role/domain
+ * loadout, apply it to the current runtime inventory, and receive an access
+ * policy suitable for existing AgentSession enforcement.
+ */
+import type { ToolDefinition } from "./extensions/types.ts";
+import type { LoadoutAccessPolicy } from "./loadout-access-policy.ts";
+import { type CompositionTrace, type ScopeHints } from "./loadout-compose.ts";
+import { type LoadoutRuntimeSession } from "./loadout-runtime.ts";
+import type { LoadoutAuthority, LoadoutProfile, LoadoutRole } from "./loadouts.ts";
+import type { ResourceLoader } from "./resource-loader.ts";
+export interface DomainDispatchInput {
+    readonly role: LoadoutRole;
+    readonly initialPrompt: string;
+    readonly session: LoadoutRuntimeSession;
+    readonly resourceLoader: ResourceLoader;
+    readonly cwd: string;
+    readonly agentDir: string;
+    readonly grantAuthority?: LoadoutAuthority;
+    readonly scopeHints?: ScopeHints;
+    readonly env?: NodeJS.ProcessEnv | Readonly<Record<string, string | undefined>>;
+    readonly roleProfileOverride?: LoadoutProfile;
+    readonly blockedPaths?: readonly string[];
+}
+export interface DomainDispatchResult {
+    readonly loadoutAccessPolicy: LoadoutAccessPolicy | undefined;
+    readonly domainUsed: string | undefined;
+    readonly fallback: boolean;
+    readonly warnings: readonly string[];
+    readonly trace: CompositionTrace | undefined;
+}
+export interface DomainDispatchRuntimeSessionOptions {
+    readonly baseToolNames: readonly string[];
+    readonly resourceLoader: ResourceLoader;
+    readonly customTools?: readonly ToolDefinition[];
+    readonly allowedToolNames?: readonly string[];
+    readonly excludedToolNames?: readonly string[];
+}
+export declare function createDomainDispatchRuntimeSession(options: DomainDispatchRuntimeSessionOptions): LoadoutRuntimeSession;
+export declare function isDomainRoutingEnabled(env?: NodeJS.ProcessEnv | Readonly<Record<string, string | undefined>>): boolean;
+export declare function tryDomainDispatch(input: DomainDispatchInput): DomainDispatchResult;
+//# sourceMappingURL=domain-dispatch.d.ts.map

package/dist/core/domain-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-dispatch.d.ts","sourceRoot":"","sources":["../../src/core/domain-dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAkB,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAEN,KAAK,gBAAgB,EAErB,KAAK,UAAU,EACf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAyB,KAAK,qBAAqB,EAA4B,MAAM,sBAAsB,CAAC;AACnH,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACnF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,CAAC,EAAE,gBAAgB,CAAC;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAChF,QAAQ,CAAC,mBAAmB,CAAC,EAAE,cAAc,CAAC;IAC9C,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAC9D,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,CAAC;CAC7C;AAED,MAAM,WAAW,mCAAmC;IACnD,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACjD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/C;AAED,wBAAgB,kCAAkC,CACjD,OAAO,EAAE,mCAAmC,GAC1C,qBAAqB,CA0BvB;AAED,wBAAgB,sBAAsB,CACrC,GAAG,GAAE,MAAM,CAAC,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAe,GACjF,OAAO,CAET;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,GAAG,oBAAoB,CAyClF","sourcesContent":["/**\n * Opt-in domain dispatch orchestration.\n *\n * Callers can invoke it to route an initial prompt, compose a role/domain\n * loadout, apply it to the current runtime inventory, and receive an access\n * policy suitable for existing AgentSession enforcement.\n */\n\nimport { routeDomain } from \"./domain-router.ts\";\nimport type { RegisteredTool, ToolDefinition } from \"./extensions/types.ts\";\nimport type { LoadoutAccessPolicy } from \"./loadout-access-policy.ts\";\nimport {\n\ttype ComposeLoadoutOptions,\n\ttype CompositionTrace,\n\tcomposeLoadout,\n\ttype ScopeHints,\n} from \"./loadout-compose.ts\";\nimport { createLoadoutPolicyFromRuntimeState, validatePolicyIntegrity } from \"./loadout-policy-bridge.ts\";\nimport { applyLoadoutToRuntime, type LoadoutRuntimeSession, type LoadoutRuntimeState } from \"./loadout-runtime.ts\";\nimport type { LoadoutAuthority, LoadoutProfile, LoadoutRole } from \"./loadouts.ts\";\nimport type { ResourceLoader } from \"./resource-loader.ts\";\n\nexport interface DomainDispatchInput {\n\treadonly role: LoadoutRole;\n\treadonly initialPrompt: string;\n\treadonly session: LoadoutRuntimeSession;\n\treadonly resourceLoader: ResourceLoader;\n\treadonly cwd: string;\n\treadonly agentDir: string;\n\treadonly grantAuthority?: LoadoutAuthority;\n\treadonly scopeHints?: ScopeHints;\n\treadonly env?: NodeJS.ProcessEnv | Readonly<Record<string, string | undefined>>;\n\treadonly roleProfileOverride?: LoadoutProfile;\n\treadonly blockedPaths?: readonly string[];\n}\n\nexport interface DomainDispatchResult {\n\treadonly loadoutAccessPolicy: LoadoutAccessPolicy | undefined;\n\treadonly domainUsed: string | undefined;\n\treadonly fallback: boolean;\n\treadonly warnings: readonly string[];\n\treadonly trace: CompositionTrace | undefined;\n}\n\nexport interface DomainDispatchRuntimeSessionOptions {\n\treadonly baseToolNames: readonly string[];\n\treadonly resourceLoader: ResourceLoader;\n\treadonly customTools?: readonly ToolDefinition[];\n\treadonly allowedToolNames?: readonly string[];\n\treadonly excludedToolNames?: readonly string[];\n}\n\nexport function createDomainDispatchRuntimeSession(\n\toptions: DomainDispatchRuntimeSessionOptions,\n): LoadoutRuntimeSession {\n\tconst allowedToolNameSet = options.allowedToolNames ? new Set(options.allowedToolNames) : undefined;\n\tconst excludedToolNameSet = options.excludedToolNames ? new Set(options.excludedToolNames) : undefined;\n\tconst isAllowedTool = (name: string): boolean =>\n\t\t(!allowedToolNameSet || allowedToolNameSet.has(name)) && !excludedToolNameSet?.has(name);\n\n\tconst base = new Map<string, ToolDefinition>();\n\tfor (const name of uniqueSorted(options.baseToolNames).filter(isAllowedTool)) {\n\t\tbase.set(name, { name } as unknown as ToolDefinition);\n\t}\n\n\tconst extensionToolsByName = new Map<string, RegisteredTool>();\n\tfor (const extension of options.resourceLoader.getExtensions().extensions) {\n\t\tfor (const tool of extension.tools.values()) {\n\t\t\tconst name = tool.definition.name;\n\t\t\tif (isAllowedTool(name) && !extensionToolsByName.has(name)) {\n\t\t\t\textensionToolsByName.set(name, tool);\n\t\t\t}\n\t\t}\n\t}\n\n\treturn {\n\t\t_baseToolDefinitions: base,\n\t\t_extensionRunner: { getAllRegisteredTools: () => [...extensionToolsByName.values()] },\n\t\t_customTools: [...(options.customTools ?? [])].filter((tool) => isAllowedTool(tool.name)),\n\t};\n}\n\nexport function isDomainRoutingEnabled(\n\tenv: NodeJS.ProcessEnv | Readonly<Record<string, string | undefined>> = process.env,\n): boolean {\n\treturn env.OMK_DOMAIN_ROUTING === \"1\";\n}\n\nexport function tryDomainDispatch(input: DomainDispatchInput): DomainDispatchResult {\n\tif (!isDomainRoutingEnabled(input.env)) {\n\t\treturn noPolicy(false, [], undefined, undefined);\n\t}\n\n\tlet domainUsed: string | undefined;\n\tlet trace: CompositionTrace | undefined;\n\ttry {\n\t\tconst route = routeDomain({ task: input.initialPrompt });\n\t\tdomainUsed = route.primary.id;\n\t\tconst composeOptions: ComposeLoadoutOptions = {\n\t\t\tgrantAuthority: input.grantAuthority,\n\t\t\tscopeHints: input.scopeHints,\n\t\t\troleProfileOverride: input.roleProfileOverride,\n\t\t};\n\t\tconst profile = composeLoadout(input.role, route.primary, composeOptions);\n\t\ttrace = profile.composition;\n\t\tconst state = applyLoadoutToRuntime(input.session, input.resourceLoader, input.cwd, input.agentDir, {\n\t\t\tprofile,\n\t\t\trole: input.role,\n\t\t\tgrantAuthority: input.grantAuthority,\n\t\t\tassignedReadPaths: input.scopeHints?.readScope,\n\t\t\tassignedWritePaths: input.scopeHints?.writeScope,\n\t\t});\n\t\tconst policy = createPolicyOrThrow(state, profile.commands, input.cwd, input.blockedPaths);\n\t\tconst integrity = validatePolicyIntegrity(policy, state);\n\t\treturn {\n\t\t\tloadoutAccessPolicy: policy,\n\t\t\tdomainUsed,\n\t\t\tfallback: route.confidence === \"fallback\",\n\t\t\twarnings: uniqueSorted([\n\t\t\t\t...routeWarnings(route),\n\t\t\t\t...profile.composition.warnings,\n\t\t\t\t...state.warnings,\n\t\t\t\t...integrity.warnings,\n\t\t\t]),\n\t\t\ttrace,\n\t\t};\n\t} catch (error) {\n\t\treturn noPolicy(true, [errorMessage(error)], domainUsed, trace);\n\t}\n}\n\nfunction createPolicyOrThrow(\n\tstate: LoadoutRuntimeState,\n\tcommands: LoadoutProfile[\"commands\"],\n\tcwd: string,\n\tblockedPaths: readonly string[] | undefined,\n): LoadoutAccessPolicy {\n\treturn createLoadoutPolicyFromRuntimeState(state, {\n\t\tcwd,\n\t\tblockedPaths,\n\t\tcommands,\n\t});\n}\n\nfunction noPolicy(\n\tfallback: boolean,\n\twarnings: readonly string[],\n\tdomainUsed: string | undefined,\n\ttrace: CompositionTrace | undefined,\n): DomainDispatchResult {\n\treturn {\n\t\tloadoutAccessPolicy: undefined,\n\t\tdomainUsed,\n\t\tfallback,\n\t\twarnings: uniqueSorted(warnings),\n\t\ttrace,\n\t};\n}\n\nfunction routeWarnings(route: ReturnType<typeof routeDomain>): string[] {\n\tconst warnings: string[] = [];\n\tif (route.ambiguous) warnings.push(route.reason);\n\tif (route.confidence === \"fallback\") warnings.push(route.reason);\n\treturn warnings;\n}\n\nfunction errorMessage(error: unknown): string {\n\tif (error instanceof Error) return error.message;\n\treturn String(error);\n}\n\nfunction uniqueSorted(values: readonly string[]): string[] {\n\treturn [...new Set(values.map((value) => value.trim()).filter((value) => value !== \"\"))].sort((a, b) => {\n\t\tif (a < b) return -1;\n\t\tif (a > b) return 1;\n\t\treturn 0;\n\t});\n}\n"]}

package/dist/core/domain-dispatch.js

@@ -0,0 +1,118 @@
+/**
+ * Opt-in domain dispatch orchestration.
+ *
+ * Callers can invoke it to route an initial prompt, compose a role/domain
+ * loadout, apply it to the current runtime inventory, and receive an access
+ * policy suitable for existing AgentSession enforcement.
+ */
+import { routeDomain } from "./domain-router.js";
+import { composeLoadout, } from "./loadout-compose.js";
+import { createLoadoutPolicyFromRuntimeState, validatePolicyIntegrity } from "./loadout-policy-bridge.js";
+import { applyLoadoutToRuntime } from "./loadout-runtime.js";
+export function createDomainDispatchRuntimeSession(options) {
+    const allowedToolNameSet = options.allowedToolNames ? new Set(options.allowedToolNames) : undefined;
+    const excludedToolNameSet = options.excludedToolNames ? new Set(options.excludedToolNames) : undefined;
+    const isAllowedTool = (name) => (!allowedToolNameSet || allowedToolNameSet.has(name)) && !excludedToolNameSet?.has(name);
+    const base = new Map();
+    for (const name of uniqueSorted(options.baseToolNames).filter(isAllowedTool)) {
+        base.set(name, { name });
+    }
+    const extensionToolsByName = new Map();
+    for (const extension of options.resourceLoader.getExtensions().extensions) {
+        for (const tool of extension.tools.values()) {
+            const name = tool.definition.name;
+            if (isAllowedTool(name) && !extensionToolsByName.has(name)) {
+                extensionToolsByName.set(name, tool);
+            }
+        }
+    }
+    return {
+        _baseToolDefinitions: base,
+        _extensionRunner: { getAllRegisteredTools: () => [...extensionToolsByName.values()] },
+        _customTools: [...(options.customTools ?? [])].filter((tool) => isAllowedTool(tool.name)),
+    };
+}
+export function isDomainRoutingEnabled(env = process.env) {
+    return env.OMK_DOMAIN_ROUTING === "1";
+}
+export function tryDomainDispatch(input) {
+    if (!isDomainRoutingEnabled(input.env)) {
+        return noPolicy(false, [], undefined, undefined);
+    }
+    let domainUsed;
+    let trace;
+    try {
+        const route = routeDomain({ task: input.initialPrompt });
+        domainUsed = route.primary.id;
+        const composeOptions = {
+            grantAuthority: input.grantAuthority,
+            scopeHints: input.scopeHints,
+            roleProfileOverride: input.roleProfileOverride,
+        };
+        const profile = composeLoadout(input.role, route.primary, composeOptions);
+        trace = profile.composition;
+        const state = applyLoadoutToRuntime(input.session, input.resourceLoader, input.cwd, input.agentDir, {
+            profile,
+            role: input.role,
+            grantAuthority: input.grantAuthority,
+            assignedReadPaths: input.scopeHints?.readScope,
+            assignedWritePaths: input.scopeHints?.writeScope,
+        });
+        const policy = createPolicyOrThrow(state, profile.commands, input.cwd, input.blockedPaths);
+        const integrity = validatePolicyIntegrity(policy, state);
+        return {
+            loadoutAccessPolicy: policy,
+            domainUsed,
+            fallback: route.confidence === "fallback",
+            warnings: uniqueSorted([
+                ...routeWarnings(route),
+                ...profile.composition.warnings,
+                ...state.warnings,
+                ...integrity.warnings,
+            ]),
+            trace,
+        };
+    }
+    catch (error) {
+        return noPolicy(true, [errorMessage(error)], domainUsed, trace);
+    }
+}
+function createPolicyOrThrow(state, commands, cwd, blockedPaths) {
+    return createLoadoutPolicyFromRuntimeState(state, {
+        cwd,
+        blockedPaths,
+        commands,
+    });
+}
+function noPolicy(fallback, warnings, domainUsed, trace) {
+    return {
+        loadoutAccessPolicy: undefined,
+        domainUsed,
+        fallback,
+        warnings: uniqueSorted(warnings),
+        trace,
+    };
+}
+function routeWarnings(route) {
+    const warnings = [];
+    if (route.ambiguous)
+        warnings.push(route.reason);
+    if (route.confidence === "fallback")
+        warnings.push(route.reason);
+    return warnings;
+}
+function errorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}
+function uniqueSorted(values) {
+    return [...new Set(values.map((value) => value.trim()).filter((value) => value !== ""))].sort((a, b) => {
+        if (a < b)
+            return -1;
+        if (a > b)
+            return 1;
+        return 0;
+    });
+}
+//# sourceMappingURL=domain-dispatch.js.map

package/dist/core/domain-dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-dispatch.js","sourceRoot":"","sources":["../../src/core/domain-dispatch.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Opt-in domain dispatch orchestration.\n *\n * Callers can invoke it to route an initial prompt, compose a role/domain\n * loadout, apply it to the current runtime inventory, and receive an access\n * policy suitable for existing AgentSession enforcement.\n */\n\nimport { routeDomain } from \"./domain-router.ts\";\nimport type { RegisteredTool, ToolDefinition } from \"./extensions/types.ts\";\nimport type { LoadoutAccessPolicy } from \"./loadout-access-policy.ts\";\nimport {\n\ttype ComposeLoadoutOptions,\n\ttype CompositionTrace,\n\tcomposeLoadout,\n\ttype ScopeHints,\n} from \"./loadout-compose.ts\";\nimport { createLoadoutPolicyFromRuntimeState, validatePolicyIntegrity } from \"./loadout-policy-bridge.ts\";\nimport { applyLoadoutToRuntime, type LoadoutRuntimeSession, type LoadoutRuntimeState } from \"./loadout-runtime.ts\";\nimport type { LoadoutAuthority, LoadoutProfile, LoadoutRole } from \"./loadouts.ts\";\nimport type { ResourceLoader } from \"./resource-loader.ts\";\n\nexport interface DomainDispatchInput {\n\treadonly role: LoadoutRole;\n\treadonly initialPrompt: string;\n\treadonly session: LoadoutRuntimeSession;\n\treadonly resourceLoader: ResourceLoader;\n\treadonly cwd: string;\n\treadonly agentDir: string;\n\treadonly grantAuthority?: LoadoutAuthority;\n\treadonly scopeHints?: ScopeHints;\n\treadonly env?: NodeJS.ProcessEnv | Readonly<Record<string, string | undefined>>;\n\treadonly roleProfileOverride?: LoadoutProfile;\n\treadonly blockedPaths?: readonly string[];\n}\n\nexport interface DomainDispatchResult {\n\treadonly loadoutAccessPolicy: LoadoutAccessPolicy | undefined;\n\treadonly domainUsed: string | undefined;\n\treadonly fallback: boolean;\n\treadonly warnings: readonly string[];\n\treadonly trace: CompositionTrace | undefined;\n}\n\nexport interface DomainDispatchRuntimeSessionOptions {\n\treadonly baseToolNames: readonly string[];\n\treadonly resourceLoader: ResourceLoader;\n\treadonly customTools?: readonly ToolDefinition[];\n\treadonly allowedToolNames?: readonly string[];\n\treadonly excludedToolNames?: readonly string[];\n}\n\nexport function createDomainDispatchRuntimeSession(\n\toptions: DomainDispatchRuntimeSessionOptions,\n): LoadoutRuntimeSession {\n\tconst allowedToolNameSet = options.allowedToolNames ? new Set(options.allowedToolNames) : undefined;\n\tconst excludedToolNameSet = options.excludedToolNames ? new Set(options.excludedToolNames) : undefined;\n\tconst isAllowedTool = (name: string): boolean =>\n\t\t(!allowedToolNameSet || allowedToolNameSet.has(name)) && !excludedToolNameSet?.has(name);\n\n\tconst base = new Map<string, ToolDefinition>();\n\tfor (const name of uniqueSorted(options.baseToolNames).filter(isAllowedTool)) {\n\t\tbase.set(name, { name } as unknown as ToolDefinition);\n\t}\n\n\tconst extensionToolsByName = new Map<string, RegisteredTool>();\n\tfor (const extension of options.resourceLoader.getExtensions().extensions) {\n\t\tfor (const tool of extension.tools.values()) {\n\t\t\tconst name = tool.definition.name;\n\t\t\tif (isAllowedTool(name) && !extensionToolsByName.has(name)) {\n\t\t\t\textensionToolsByName.set(name, tool);\n\t\t\t}\n\t\t}\n\t}\n\n\treturn {\n\t\t_baseToolDefinitions: base,\n\t\t_extensionRunner: { getAllRegisteredTools: () => [...extensionToolsByName.values()] },\n\t\t_customTools: [...(options.customTools ?? [])].filter((tool) => isAllowedTool(tool.name)),\n\t};\n}\n\nexport function isDomainRoutingEnabled(\n\tenv: NodeJS.ProcessEnv | Readonly<Record<string, string | undefined>> = process.env,\n): boolean {\n\treturn env.OMK_DOMAIN_ROUTING === \"1\";\n}\n\nexport function tryDomainDispatch(input: DomainDispatchInput): DomainDispatchResult {\n\tif (!isDomainRoutingEnabled(input.env)) {\n\t\treturn noPolicy(false, [], undefined, undefined);\n\t}\n\n\tlet domainUsed: string | undefined;\n\tlet trace: CompositionTrace | undefined;\n\ttry {\n\t\tconst route = routeDomain({ task: input.initialPrompt });\n\t\tdomainUsed = route.primary.id;\n\t\tconst composeOptions: ComposeLoadoutOptions = {\n\t\t\tgrantAuthority: input.grantAuthority,\n\t\t\tscopeHints: input.scopeHints,\n\t\t\troleProfileOverride: input.roleProfileOverride,\n\t\t};\n\t\tconst profile = composeLoadout(input.role, route.primary, composeOptions);\n\t\ttrace = profile.composition;\n\t\tconst state = applyLoadoutToRuntime(input.session, input.resourceLoader, input.cwd, input.agentDir, {\n\t\t\tprofile,\n\t\t\trole: input.role,\n\t\t\tgrantAuthority: input.grantAuthority,\n\t\t\tassignedReadPaths: input.scopeHints?.readScope,\n\t\t\tassignedWritePaths: input.scopeHints?.writeScope,\n\t\t});\n\t\tconst policy = createPolicyOrThrow(state, profile.commands, input.cwd, input.blockedPaths);\n\t\tconst integrity = validatePolicyIntegrity(policy, state);\n\t\treturn {\n\t\t\tloadoutAccessPolicy: policy,\n\t\t\tdomainUsed,\n\t\t\tfallback: route.confidence === \"fallback\",\n\t\t\twarnings: uniqueSorted([\n\t\t\t\t...routeWarnings(route),\n\t\t\t\t...profile.composition.warnings,\n\t\t\t\t...state.warnings,\n\t\t\t\t...integrity.warnings,\n\t\t\t]),\n\t\t\ttrace,\n\t\t};\n\t} catch (error) {\n\t\treturn noPolicy(true, [errorMessage(error)], domainUsed, trace);\n\t}\n}\n\nfunction createPolicyOrThrow(\n\tstate: LoadoutRuntimeState,\n\tcommands: LoadoutProfile[\"commands\"],\n\tcwd: string,\n\tblockedPaths: readonly string[] | undefined,\n): LoadoutAccessPolicy {\n\treturn createLoadoutPolicyFromRuntimeState(state, {\n\t\tcwd,\n\t\tblockedPaths,\n\t\tcommands,\n\t});\n}\n\nfunction noPolicy(\n\tfallback: boolean,\n\twarnings: readonly string[],\n\tdomainUsed: string | undefined,\n\ttrace: CompositionTrace | undefined,\n): DomainDispatchResult {\n\treturn {\n\t\tloadoutAccessPolicy: undefined,\n\t\tdomainUsed,\n\t\tfallback,\n\t\twarnings: uniqueSorted(warnings),\n\t\ttrace,\n\t};\n}\n\nfunction routeWarnings(route: ReturnType<typeof routeDomain>): string[] {\n\tconst warnings: string[] = [];\n\tif (route.ambiguous) warnings.push(route.reason);\n\tif (route.confidence === \"fallback\") warnings.push(route.reason);\n\treturn warnings;\n}\n\nfunction errorMessage(error: unknown): string {\n\tif (error instanceof Error) return error.message;\n\treturn String(error);\n}\n\nfunction uniqueSorted(values: readonly string[]): string[] {\n\treturn [...new Set(values.map((value) => value.trim()).filter((value) => value !== \"\"))].sort((a, b) => {\n\t\tif (a < b) return -1;\n\t\tif (a > b) return 1;\n\t\treturn 0;\n\t});\n}\n"]}