open-multi-agent-kit 0.80.6 → 0.80.7

package/dist/core/compaction/pruner-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pruner-policy.d.ts","sourceRoot":"","sources":["../../../src/core/compaction/pruner-policy.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Pure policy helpers for external context pruning and session compaction.\n *\n * Agent-message pruning and session_before_compact compaction are separate\n * ownership lanes. The runtime may run one agent-message pruner and one\n * session compactor, but only one enabled owner may handle session_before_compact.\n */\n\nexport type ExternalPrunerMode = \"experimental\" | \"permanent\";\nexport type ExternalPrunerLicense = \"known\" | \"unknown\";\nexport type PrunerTrigger = \"agent-message\";\nexport type SessionCompactorTrigger = \"session_before_compact\";\nexport type NeverPruneTarget = \"entries\";\nexport type SessionCompactorPhase = \"Extract\" | \"Explore\" | \"Synthesize\" | \"Verify\";\nexport type CompactStackProfile = \"production\" | \"cost-experiment\" | \"long-context-precision\";\nexport type ExternalContextPackageRole =\n\t| \"agent-message-pruner\"\n\t| \"session-before-compact-compactor\"\n\t| \"orchestration-tool\"\n\t| \"continuation-helper\"\n\t| \"blocked\"\n\t| \"unsupported\";\n\nexport interface PrunerRecommendedDefaults {\n\ttrigger: PrunerTrigger;\n\tsoft: number;\n\thard: number;\n\tkeepRecentTokens: number;\n\trecoverOriginals: boolean;\n\tneverPrune: NeverPruneTarget[];\n}\n\nexport interface SessionCompactorRecommendedDefaults {\n\ttrigger: SessionCompactorTrigger;\n\towner: string;\n\tprofile: string;\n\tautoTrigger: boolean;\n\tminContextPercent: number;\n\tbackupEnabled: boolean;\n\tpinPaths: string[];\n\tpreserveToolPairs: boolean;\n\tphases: SessionCompactorPhase[];\n}\n\nexport interface CompactStackRecommendation {\n\tpreCompression: string[];\n\tagentMessagePruner?: string;\n\tsessionCompactor?: string;\n\torchestrationTools: string[];\n\tproviderPromptCache: boolean;\n}\n\nexport interface ExternalPrunerRegistration {\n\towner: string;\n\tenabled: boolean;\n\tlicense?: ExternalPrunerLicense;\n\tdefaults?: Partial<PrunerRecommendedDefaults>;\n}\n\nexport interface ExternalSessionCompactorRegistration {\n\towner: string;\n\tenabled: boolean;\n\tlicense?: ExternalPrunerLicense;\n\tproviderPricingInjected?: boolean;\n\tsessionDefaults?: Partial<SessionCompactorRecommendedDefaults>;\n}\n\nexport interface ExternalContextPackageRegistration\n\textends ExternalPrunerRegistration,\n\t\tExternalSessionCompactorRegistration {}\n\nexport interface ValidateExternalPrunerOptions {\n\tmode: ExternalPrunerMode;\n}\n\nexport interface ValidatedExternalPrunerOwner {\n\towner: string;\n\tmode: ExternalPrunerMode;\n\tdefaults: PrunerRecommendedDefaults;\n}\n\nexport interface ValidatedSessionCompactorOwner {\n\towner: string;\n\tmode: ExternalPrunerMode;\n\tdefaults: SessionCompactorRecommendedDefaults;\n}\n\nexport interface ValidatedCompactPackageStack {\n\tagentMessagePruner?: ValidatedExternalPrunerOwner;\n\tsessionCompactor?: ValidatedSessionCompactorOwner;\n\torchestrationTools: string[];\n\tcontinuationHelpers: string[];\n}\n\ninterface BuiltInPrunerPolicy {\n\tlicense: ExternalPrunerLicense;\n\tallowedModes: readonly ExternalPrunerMode[];\n\texperimentalOnly: boolean;\n}\n\ninterface ContextPackagePolicy {\n\trole: ExternalContextPackageRole;\n\tlicense: ExternalPrunerLicense;\n\tallowedModes: readonly ExternalPrunerMode[];\n\tblockedReason?: string;\n\trequiresProviderPricing?: boolean;\n\tsessionDefaults?: SessionCompactorRecommendedDefaults;\n}\n\nconst PINNED_SESSION_COMPACTOR_PATHS = [\"AGENTS.md\", \"OMK.md\", \".omk/state.json\"] as const;\nconst SESSION_COMPACTOR_PHASES = [\"Extract\", \"Explore\", \"Synthesize\", \"Verify\"] as const;\n\nconst BUILT_IN_PRUNER_POLICIES: Record<string, BuiltInPrunerPolicy> = {\n\t\"pi-context-prune\": {\n\t\tlicense: \"known\",\n\t\tallowedModes: [\"experimental\", \"permanent\"],\n\t\texperimentalOnly: false,\n\t},\n\t\"pi-ultra-compact\": {\n\t\tlicense: \"known\",\n\t\tallowedModes: [\"experimental\"],\n\t\texperimentalOnly: true,\n\t},\n\t\"pi-vcc\": {\n\t\tlicense: \"unknown\",\n\t\tallowedModes: [\"experimental\"],\n\t\texperimentalOnly: true,\n\t},\n};\n\nconst CONTEXT_PACKAGE_POLICIES: Record<string, ContextPackagePolicy> = {\n\t\"pi-context-prune\": {\n\t\trole: \"agent-message-pruner\",\n\t\tlicense: \"known\",\n\t\tallowedModes: [\"experimental\", \"permanent\"],\n\t},\n\t\"pi-smart-compact\": {\n\t\trole: \"session-before-compact-compactor\",\n\t\tlicense: \"known\",\n\t\tallowedModes: [\"experimental\", \"permanent\"],\n\t\tsessionDefaults: createSessionCompactorDefaults(\"pi-smart-compact\", \"balanced\", 72),\n\t},\n\t\"pi-better-compact\": {\n\t\trole: \"session-before-compact-compactor\",\n\t\tlicense: \"known\",\n\t\tallowedModes: [\"experimental\"],\n\t\trequiresProviderPricing: true,\n\t\tsessionDefaults: createSessionCompactorDefaults(\"pi-better-compact\", \"cost-benefit\", 70),\n\t},\n\t\"pi-ultra-compact\": {\n\t\trole: \"session-before-compact-compactor\",\n\t\tlicense: \"known\",\n\t\tallowedModes: [\"experimental\"],\n\t\tsessionDefaults: createSessionCompactorDefaults(\"pi-ultra-compact\", \"canary\", 90),\n\t},\n\t\"pi-omni-compact\": {\n\t\trole: \"session-before-compact-compactor\",\n\t\tlicense: \"known\",\n\t\tallowedModes: [\"experimental\"],\n\t\tsessionDefaults: createSessionCompactorDefaults(\"pi-omni-compact\", \"precision\", 82),\n\t},\n\t\"pi-context-tools\": {\n\t\trole: \"orchestration-tool\",\n\t\tlicense: \"known\",\n\t\tallowedModes: [\"experimental\", \"permanent\"],\n\t},\n\t\"pi-continue\": {\n\t\trole: \"continuation-helper\",\n\t\tlicense: \"known\",\n\t\tallowedModes: [\"experimental\", \"permanent\"],\n\t},\n\t\"@adamjen/pi-compact-fast\": {\n\t\trole: \"blocked\",\n\t\tlicense: \"known\",\n\t\tallowedModes: [],\n\t\tblockedReason: \"source-edited model id configuration is not accepted for OMK runtime ownership\",\n\t},\n\t\"@davehardy20/pi-compact-plus\": {\n\t\trole: \"blocked\",\n\t\tlicense: \"known\",\n\t\tallowedModes: [],\n\t\tblockedReason: \"synthetic user message reinjection violates OMK authority-boundary preservation\",\n\t},\n};\n\nconst RECOMMENDED_PRUNER_DEFAULTS: PrunerRecommendedDefaults = {\n\ttrigger: \"agent-message\",\n\tsoft: 0.7,\n\thard: 0.82,\n\tkeepRecentTokens: 24_000,\n\trecoverOriginals: true,\n\tneverPrune: [\"entries\"],\n};\n\nexport function getRecommendedPrunerDefaults(): PrunerRecommendedDefaults {\n\treturn {\n\t\t...RECOMMENDED_PRUNER_DEFAULTS,\n\t\tneverPrune: [...RECOMMENDED_PRUNER_DEFAULTS.neverPrune],\n\t};\n}\n\nexport function getRecommendedSessionCompactorDefaults(): SessionCompactorRecommendedDefaults {\n\treturn cloneSessionCompactorDefaults(createSessionCompactorDefaults(\"pi-smart-compact\", \"balanced\", 72));\n}\n\nexport function getRecommendedCompactStack(profile: CompactStackProfile): CompactStackRecommendation {\n\tif (profile === \"cost-experiment\") {\n\t\treturn {\n\t\t\tpreCompression: [\"LeanCTX\", \"Headroom\"],\n\t\t\tsessionCompactor: \"pi-better-compact\",\n\t\t\torchestrationTools: [],\n\t\t\tproviderPromptCache: true,\n\t\t};\n\t}\n\n\tif (profile === \"long-context-precision\") {\n\t\treturn {\n\t\t\tpreCompression: [\"LeanCTX\", \"Headroom\"],\n\t\t\tsessionCompactor: \"pi-omni-compact\",\n\t\t\torchestrationTools: [],\n\t\t\tproviderPromptCache: false,\n\t\t};\n\t}\n\n\treturn {\n\t\tpreCompression: [\"LeanCTX\", \"Headroom\"],\n\t\tagentMessagePruner: \"pi-context-prune\",\n\t\tsessionCompactor: \"pi-smart-compact\",\n\t\torchestrationTools: [\"pi-context-tools\"],\n\t\tproviderPromptCache: true,\n\t};\n}\n\nexport function registerExternalPrunerOwner(\n\tregistry: readonly ExternalPrunerRegistration[],\n\tregistration: ExternalPrunerRegistration,\n): ExternalPrunerRegistration[] {\n\treturn [...registry, cloneRegistration(registration)];\n}\n\nexport function validateSingleExternalPrunerOwner(\n\tregistry: readonly ExternalPrunerRegistration[],\n\toptions: ValidateExternalPrunerOptions,\n): ValidatedExternalPrunerOwner | undefined {\n\tconst enabledPruners = registry.filter((registration) => registration.enabled);\n\tif (enabledPruners.length === 0) {\n\t\treturn undefined;\n\t}\n\n\tif (enabledPruners.length > 1) {\n\t\tthrow new Error(\n\t\t\t`Multiple enabled external pruners are not allowed: ${enabledPruners.map((registration) => registration.owner).join(\", \")}`,\n\t\t);\n\t}\n\n\tconst registration = enabledPruners[0];\n\tconst builtInPolicy = BUILT_IN_PRUNER_POLICIES[registration.owner];\n\tconst license = registration.license ?? builtInPolicy?.license ?? \"unknown\";\n\n\tif (options.mode === \"permanent\" && license === \"unknown\") {\n\t\tthrow new Error(`${registration.owner} has unknown license and cannot be enabled in permanent mode`);\n\t}\n\n\tif (builtInPolicy && !builtInPolicy.allowedModes.includes(options.mode)) {\n\t\tconst reason = builtInPolicy.experimentalOnly ? \"experimental-only\" : `not enabled for ${options.mode}`;\n\t\tthrow new Error(`${registration.owner} is ${reason} and cannot be enabled in ${options.mode} mode`);\n\t}\n\n\treturn {\n\t\towner: registration.owner,\n\t\tmode: options.mode,\n\t\tdefaults: mergeRecommendedDefaults(registration.defaults),\n\t};\n}\n\nexport function validateSingleSessionCompactorOwner(\n\tregistry: readonly ExternalSessionCompactorRegistration[],\n\toptions: ValidateExternalPrunerOptions,\n): ValidatedSessionCompactorOwner | undefined {\n\tconst enabledCompactors = registry.filter((registration) => {\n\t\tif (!registration.enabled) return false;\n\t\tconst role = classifyContextPackageRole(registration.owner);\n\t\treturn role === \"session-before-compact-compactor\" || role === \"blocked\" || role === \"unsupported\";\n\t});\n\n\tfor (const registration of enabledCompactors) {\n\t\tconst policy = CONTEXT_PACKAGE_POLICIES[registration.owner];\n\t\tif (policy?.role === \"blocked\") {\n\t\t\tthrow new Error(`${registration.owner} is blocked: ${policy.blockedReason ?? \"not accepted\"}`);\n\t\t}\n\t}\n\n\tif (enabledCompactors.length === 0) {\n\t\treturn undefined;\n\t}\n\n\tif (enabledCompactors.length > 1) {\n\t\tthrow new Error(\n\t\t\t`Multiple enabled session_before_compact compactors are not allowed: ${enabledCompactors.map((registration) => registration.owner).join(\", \")}`,\n\t\t);\n\t}\n\n\treturn validateSessionCompactorRegistration(enabledCompactors[0], options);\n}\n\nexport function validateCompactPackageStack(\n\tregistry: readonly ExternalContextPackageRegistration[],\n\toptions: ValidateExternalPrunerOptions,\n): ValidatedCompactPackageStack {\n\tconst agentMessagePruners: ExternalPrunerRegistration[] = [];\n\tconst sessionCompactors: ExternalSessionCompactorRegistration[] = [];\n\tconst orchestrationTools: string[] = [];\n\tconst continuationHelpers: string[] = [];\n\n\tfor (const registration of registry) {\n\t\tif (!registration.enabled) continue;\n\t\tconst role = classifyContextPackageRole(registration.owner);\n\t\tif (role === \"agent-message-pruner\") {\n\t\t\tagentMessagePruners.push(registration);\n\t\t} else if (role === \"session-before-compact-compactor\" || role === \"blocked\" || role === \"unsupported\") {\n\t\t\tsessionCompactors.push(registration);\n\t\t} else if (role === \"orchestration-tool\") {\n\t\t\torchestrationTools.push(registration.owner);\n\t\t} else if (role === \"continuation-helper\") {\n\t\t\tcontinuationHelpers.push(registration.owner);\n\t\t}\n\t}\n\n\treturn {\n\t\tagentMessagePruner: validateSingleExternalPrunerOwner(agentMessagePruners, options),\n\t\tsessionCompactor: validateSingleSessionCompactorOwner(sessionCompactors, options),\n\t\torchestrationTools,\n\t\tcontinuationHelpers,\n\t};\n}\n\nexport function classifyContextPackageRole(owner: string): ExternalContextPackageRole {\n\treturn CONTEXT_PACKAGE_POLICIES[owner]?.role ?? \"unsupported\";\n}\n\nfunction validateSessionCompactorRegistration(\n\tregistration: ExternalSessionCompactorRegistration,\n\toptions: ValidateExternalPrunerOptions,\n): ValidatedSessionCompactorOwner {\n\tconst policy = CONTEXT_PACKAGE_POLICIES[registration.owner];\n\tconst license = registration.license ?? policy?.license ?? \"unknown\";\n\n\tif (options.mode === \"permanent\" && license === \"unknown\") {\n\t\tthrow new Error(`${registration.owner} has unknown license and cannot be enabled in permanent mode`);\n\t}\n\n\tif (policy && !policy.allowedModes.includes(options.mode)) {\n\t\tthrow new Error(`${registration.owner} is not enabled for ${options.mode} mode`);\n\t}\n\n\tif (policy?.requiresProviderPricing === true && registration.providerPricingInjected !== true) {\n\t\tthrow new Error(`${registration.owner} requires provider pricing before it can own session_before_compact`);\n\t}\n\n\treturn {\n\t\towner: registration.owner,\n\t\tmode: options.mode,\n\t\tdefaults: mergeSessionCompactorDefaults(\n\t\t\tpolicy?.sessionDefaults ?? createSessionCompactorDefaults(registration.owner, \"custom\", 72),\n\t\t\tregistration.sessionDefaults,\n\t\t),\n\t};\n}\n\nfunction createSessionCompactorDefaults(\n\towner: string,\n\tprofile: string,\n\tminContextPercent: number,\n): SessionCompactorRecommendedDefaults {\n\treturn {\n\t\ttrigger: \"session_before_compact\",\n\t\towner,\n\t\tprofile,\n\t\tautoTrigger: true,\n\t\tminContextPercent,\n\t\tbackupEnabled: true,\n\t\tpinPaths: [...PINNED_SESSION_COMPACTOR_PATHS],\n\t\tpreserveToolPairs: true,\n\t\tphases: [...SESSION_COMPACTOR_PHASES],\n\t};\n}\n\nfunction mergeRecommendedDefaults(\n\toverrides: Partial<PrunerRecommendedDefaults> | undefined,\n): PrunerRecommendedDefaults {\n\tconst defaults = getRecommendedPrunerDefaults();\n\tif (!overrides) {\n\t\treturn defaults;\n\t}\n\n\treturn {\n\t\t...defaults,\n\t\t...overrides,\n\t\tneverPrune: overrides.neverPrune ? [...overrides.neverPrune] : defaults.neverPrune,\n\t};\n}\n\nfunction mergeSessionCompactorDefaults(\n\tdefaults: SessionCompactorRecommendedDefaults,\n\toverrides: Partial<SessionCompactorRecommendedDefaults> | undefined,\n): SessionCompactorRecommendedDefaults {\n\tif (!overrides) return cloneSessionCompactorDefaults(defaults);\n\treturn {\n\t\t...defaults,\n\t\t...overrides,\n\t\tpinPaths: overrides.pinPaths ? [...overrides.pinPaths] : [...defaults.pinPaths],\n\t\tphases: overrides.phases ? [...overrides.phases] : [...defaults.phases],\n\t};\n}\n\nfunction cloneSessionCompactorDefaults(\n\tdefaults: SessionCompactorRecommendedDefaults,\n): SessionCompactorRecommendedDefaults {\n\treturn {\n\t\t...defaults,\n\t\tpinPaths: [...defaults.pinPaths],\n\t\tphases: [...defaults.phases],\n\t};\n}\n\nfunction cloneRegistration(registration: ExternalPrunerRegistration): ExternalPrunerRegistration {\n\treturn {\n\t\t...registration,\n\t\tdefaults: registration.defaults\n\t\t\t? {\n\t\t\t\t\t...registration.defaults,\n\t\t\t\t\tneverPrune: registration.defaults.neverPrune ? [...registration.defaults.neverPrune] : undefined,\n\t\t\t\t}\n\t\t\t: undefined,\n\t};\n}\n"]}

package/dist/core/compaction/pruner-policy.js

@@ -0,0 +1,273 @@
+/**
+ * Pure policy helpers for external context pruning and session compaction.
+ *
+ * Agent-message pruning and session_before_compact compaction are separate
+ * ownership lanes. The runtime may run one agent-message pruner and one
+ * session compactor, but only one enabled owner may handle session_before_compact.
+ */
+const PINNED_SESSION_COMPACTOR_PATHS = ["AGENTS.md", "OMK.md", ".omk/state.json"];
+const SESSION_COMPACTOR_PHASES = ["Extract", "Explore", "Synthesize", "Verify"];
+const BUILT_IN_PRUNER_POLICIES = {
+    "pi-context-prune": {
+        license: "known",
+        allowedModes: ["experimental", "permanent"],
+        experimentalOnly: false,
+    },
+    "pi-ultra-compact": {
+        license: "known",
+        allowedModes: ["experimental"],
+        experimentalOnly: true,
+    },
+    "pi-vcc": {
+        license: "unknown",
+        allowedModes: ["experimental"],
+        experimentalOnly: true,
+    },
+};
+const CONTEXT_PACKAGE_POLICIES = {
+    "pi-context-prune": {
+        role: "agent-message-pruner",
+        license: "known",
+        allowedModes: ["experimental", "permanent"],
+    },
+    "pi-smart-compact": {
+        role: "session-before-compact-compactor",
+        license: "known",
+        allowedModes: ["experimental", "permanent"],
+        sessionDefaults: createSessionCompactorDefaults("pi-smart-compact", "balanced", 72),
+    },
+    "pi-better-compact": {
+        role: "session-before-compact-compactor",
+        license: "known",
+        allowedModes: ["experimental"],
+        requiresProviderPricing: true,
+        sessionDefaults: createSessionCompactorDefaults("pi-better-compact", "cost-benefit", 70),
+    },
+    "pi-ultra-compact": {
+        role: "session-before-compact-compactor",
+        license: "known",
+        allowedModes: ["experimental"],
+        sessionDefaults: createSessionCompactorDefaults("pi-ultra-compact", "canary", 90),
+    },
+    "pi-omni-compact": {
+        role: "session-before-compact-compactor",
+        license: "known",
+        allowedModes: ["experimental"],
+        sessionDefaults: createSessionCompactorDefaults("pi-omni-compact", "precision", 82),
+    },
+    "pi-context-tools": {
+        role: "orchestration-tool",
+        license: "known",
+        allowedModes: ["experimental", "permanent"],
+    },
+    "pi-continue": {
+        role: "continuation-helper",
+        license: "known",
+        allowedModes: ["experimental", "permanent"],
+    },
+    "@adamjen/pi-compact-fast": {
+        role: "blocked",
+        license: "known",
+        allowedModes: [],
+        blockedReason: "source-edited model id configuration is not accepted for OMK runtime ownership",
+    },
+    "@davehardy20/pi-compact-plus": {
+        role: "blocked",
+        license: "known",
+        allowedModes: [],
+        blockedReason: "synthetic user message reinjection violates OMK authority-boundary preservation",
+    },
+};
+const RECOMMENDED_PRUNER_DEFAULTS = {
+    trigger: "agent-message",
+    soft: 0.7,
+    hard: 0.82,
+    keepRecentTokens: 24_000,
+    recoverOriginals: true,
+    neverPrune: ["entries"],
+};
+export function getRecommendedPrunerDefaults() {
+    return {
+        ...RECOMMENDED_PRUNER_DEFAULTS,
+        neverPrune: [...RECOMMENDED_PRUNER_DEFAULTS.neverPrune],
+    };
+}
+export function getRecommendedSessionCompactorDefaults() {
+    return cloneSessionCompactorDefaults(createSessionCompactorDefaults("pi-smart-compact", "balanced", 72));
+}
+export function getRecommendedCompactStack(profile) {
+    if (profile === "cost-experiment") {
+        return {
+            preCompression: ["LeanCTX", "Headroom"],
+            sessionCompactor: "pi-better-compact",
+            orchestrationTools: [],
+            providerPromptCache: true,
+        };
+    }
+    if (profile === "long-context-precision") {
+        return {
+            preCompression: ["LeanCTX", "Headroom"],
+            sessionCompactor: "pi-omni-compact",
+            orchestrationTools: [],
+            providerPromptCache: false,
+        };
+    }
+    return {
+        preCompression: ["LeanCTX", "Headroom"],
+        agentMessagePruner: "pi-context-prune",
+        sessionCompactor: "pi-smart-compact",
+        orchestrationTools: ["pi-context-tools"],
+        providerPromptCache: true,
+    };
+}
+export function registerExternalPrunerOwner(registry, registration) {
+    return [...registry, cloneRegistration(registration)];
+}
+export function validateSingleExternalPrunerOwner(registry, options) {
+    const enabledPruners = registry.filter((registration) => registration.enabled);
+    if (enabledPruners.length === 0) {
+        return undefined;
+    }
+    if (enabledPruners.length > 1) {
+        throw new Error(`Multiple enabled external pruners are not allowed: ${enabledPruners.map((registration) => registration.owner).join(", ")}`);
+    }
+    const registration = enabledPruners[0];
+    const builtInPolicy = BUILT_IN_PRUNER_POLICIES[registration.owner];
+    const license = registration.license ?? builtInPolicy?.license ?? "unknown";
+    if (options.mode === "permanent" && license === "unknown") {
+        throw new Error(`${registration.owner} has unknown license and cannot be enabled in permanent mode`);
+    }
+    if (builtInPolicy && !builtInPolicy.allowedModes.includes(options.mode)) {
+        const reason = builtInPolicy.experimentalOnly ? "experimental-only" : `not enabled for ${options.mode}`;
+        throw new Error(`${registration.owner} is ${reason} and cannot be enabled in ${options.mode} mode`);
+    }
+    return {
+        owner: registration.owner,
+        mode: options.mode,
+        defaults: mergeRecommendedDefaults(registration.defaults),
+    };
+}
+export function validateSingleSessionCompactorOwner(registry, options) {
+    const enabledCompactors = registry.filter((registration) => {
+        if (!registration.enabled)
+            return false;
+        const role = classifyContextPackageRole(registration.owner);
+        return role === "session-before-compact-compactor" || role === "blocked" || role === "unsupported";
+    });
+    for (const registration of enabledCompactors) {
+        const policy = CONTEXT_PACKAGE_POLICIES[registration.owner];
+        if (policy?.role === "blocked") {
+            throw new Error(`${registration.owner} is blocked: ${policy.blockedReason ?? "not accepted"}`);
+        }
+    }
+    if (enabledCompactors.length === 0) {
+        return undefined;
+    }
+    if (enabledCompactors.length > 1) {
+        throw new Error(`Multiple enabled session_before_compact compactors are not allowed: ${enabledCompactors.map((registration) => registration.owner).join(", ")}`);
+    }
+    return validateSessionCompactorRegistration(enabledCompactors[0], options);
+}
+export function validateCompactPackageStack(registry, options) {
+    const agentMessagePruners = [];
+    const sessionCompactors = [];
+    const orchestrationTools = [];
+    const continuationHelpers = [];
+    for (const registration of registry) {
+        if (!registration.enabled)
+            continue;
+        const role = classifyContextPackageRole(registration.owner);
+        if (role === "agent-message-pruner") {
+            agentMessagePruners.push(registration);
+        }
+        else if (role === "session-before-compact-compactor" || role === "blocked" || role === "unsupported") {
+            sessionCompactors.push(registration);
+        }
+        else if (role === "orchestration-tool") {
+            orchestrationTools.push(registration.owner);
+        }
+        else if (role === "continuation-helper") {
+            continuationHelpers.push(registration.owner);
+        }
+    }
+    return {
+        agentMessagePruner: validateSingleExternalPrunerOwner(agentMessagePruners, options),
+        sessionCompactor: validateSingleSessionCompactorOwner(sessionCompactors, options),
+        orchestrationTools,
+        continuationHelpers,
+    };
+}
+export function classifyContextPackageRole(owner) {
+    return CONTEXT_PACKAGE_POLICIES[owner]?.role ?? "unsupported";
+}
+function validateSessionCompactorRegistration(registration, options) {
+    const policy = CONTEXT_PACKAGE_POLICIES[registration.owner];
+    const license = registration.license ?? policy?.license ?? "unknown";
+    if (options.mode === "permanent" && license === "unknown") {
+        throw new Error(`${registration.owner} has unknown license and cannot be enabled in permanent mode`);
+    }
+    if (policy && !policy.allowedModes.includes(options.mode)) {
+        throw new Error(`${registration.owner} is not enabled for ${options.mode} mode`);
+    }
+    if (policy?.requiresProviderPricing === true && registration.providerPricingInjected !== true) {
+        throw new Error(`${registration.owner} requires provider pricing before it can own session_before_compact`);
+    }
+    return {
+        owner: registration.owner,
+        mode: options.mode,
+        defaults: mergeSessionCompactorDefaults(policy?.sessionDefaults ?? createSessionCompactorDefaults(registration.owner, "custom", 72), registration.sessionDefaults),
+    };
+}
+function createSessionCompactorDefaults(owner, profile, minContextPercent) {
+    return {
+        trigger: "session_before_compact",
+        owner,
+        profile,
+        autoTrigger: true,
+        minContextPercent,
+        backupEnabled: true,
+        pinPaths: [...PINNED_SESSION_COMPACTOR_PATHS],
+        preserveToolPairs: true,
+        phases: [...SESSION_COMPACTOR_PHASES],
+    };
+}
+function mergeRecommendedDefaults(overrides) {
+    const defaults = getRecommendedPrunerDefaults();
+    if (!overrides) {
+        return defaults;
+    }
+    return {
+        ...defaults,
+        ...overrides,
+        neverPrune: overrides.neverPrune ? [...overrides.neverPrune] : defaults.neverPrune,
+    };
+}
+function mergeSessionCompactorDefaults(defaults, overrides) {
+    if (!overrides)
+        return cloneSessionCompactorDefaults(defaults);
+    return {
+        ...defaults,
+        ...overrides,
+        pinPaths: overrides.pinPaths ? [...overrides.pinPaths] : [...defaults.pinPaths],
+        phases: overrides.phases ? [...overrides.phases] : [...defaults.phases],
+    };
+}
+function cloneSessionCompactorDefaults(defaults) {
+    return {
+        ...defaults,
+        pinPaths: [...defaults.pinPaths],
+        phases: [...defaults.phases],
+    };
+}
+function cloneRegistration(registration) {
+    return {
+        ...registration,
+        defaults: registration.defaults
+            ? {
+                ...registration.defaults,
+                neverPrune: registration.defaults.neverPrune ? [...registration.defaults.neverPrune] : undefined,
+            }
+            : undefined,
+    };
+}
+//# sourceMappingURL=pruner-policy.js.map

package/dist/core/compaction/pruner-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pruner-policy.js","sourceRoot":"","sources":["../../../src/core/compaction/pruner-policy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuGH,MAAM,8BAA8B,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,iBAAiB,CAAU,CAAC;AAC3F,MAAM,wBAAwB,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,CAAU,CAAC;AAEzF,MAAM,wBAAwB,GAAwC;IACrE,kBAAkB,EAAE;QACnB,OAAO,EAAE,OAAO;QAChB,YAAY,EAAE,CAAC,cAAc,EAAE,WAAW,CAAC;QAC3C,gBAAgB,EAAE,KAAK;KACvB;IACD,kBAAkB,EAAE;QACnB,OAAO,EAAE,OAAO;QAChB,YAAY,EAAE,CAAC,cAAc,CAAC;QAC9B,gBAAgB,EAAE,IAAI;KACtB;IACD,QAAQ,EAAE;QACT,OAAO,EAAE,SAAS;QAClB,YAAY,EAAE,CAAC,cAAc,CAAC;QAC9B,gBAAgB,EAAE,IAAI;KACtB;CACD,CAAC;AAEF,MAAM,wBAAwB,GAAyC;IACtE,kBAAkB,EAAE;QACnB,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,OAAO;QAChB,YAAY,EAAE,CAAC,cAAc,EAAE,WAAW,CAAC;KAC3C;IACD,kBAAkB,EAAE;QACnB,IAAI,EAAE,kCAAkC;QACxC,OAAO,EAAE,OAAO;QAChB,YAAY,EAAE,CAAC,cAAc,EAAE,WAAW,CAAC;QAC3C,eAAe,EAAE,8BAA8B,CAAC,kBAAkB,EAAE,UAAU,EAAE,EAAE,CAAC;KACnF;IACD,mBAAmB,EAAE;QACpB,IAAI,EAAE,kCAAkC;QACxC,OAAO,EAAE,OAAO;QAChB,YAAY,EAAE,CAAC,cAAc,CAAC;QAC9B,uBAAuB,EAAE,IAAI;QAC7B,eAAe,EAAE,8BAA8B,CAAC,mBAAmB,EAAE,cAAc,EAAE,EAAE,CAAC;KACxF;IACD,kBAAkB,EAAE;QACnB,IAAI,EAAE,kCAAkC;QACxC,OAAO,EAAE,OAAO;QAChB,YAAY,EAAE,CAAC,cAAc,CAAC;QAC9B,eAAe,EAAE,8BAA8B,CAAC,kBAAkB,EAAE,QAAQ,EAAE,EAAE,CAAC;KACjF;IACD,iBAAiB,EAAE;QAClB,IAAI,EAAE,kCAAkC;QACxC,OAAO,EAAE,OAAO;QAChB,YAAY,EAAE,CAAC,cAAc,CAAC;QAC9B,eAAe,EAAE,8BAA8B,CAAC,iBAAiB,EAAE,WAAW,EAAE,EAAE,CAAC;KACnF;IACD,kBAAkB,EAAE;QACnB,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,OAAO;QAChB,YAAY,EAAE,CAAC,cAAc,EAAE,WAAW,CAAC;KAC3C;IACD,aAAa,EAAE;QACd,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,OAAO;QAChB,YAAY,EAAE,CAAC,cAAc,EAAE,WAAW,CAAC;KAC3C;IACD,0BAA0B,EAAE;QAC3B,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,OAAO;QAChB,YAAY,EAAE,EAAE;QAChB,aAAa,EAAE,gFAAgF;KAC/F;IACD,8BAA8B,EAAE;QAC/B,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,OAAO;QAChB,YAAY,EAAE,EAAE;QAChB,aAAa,EAAE,iFAAiF;KAChG;CACD,CAAC;AAEF,MAAM,2BAA2B,GAA8B;IAC9D,OAAO,EAAE,eAAe;IACxB,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,IAAI;IACV,gBAAgB,EAAE,MAAM;IACxB,gBAAgB,EAAE,IAAI;IACtB,UAAU,EAAE,CAAC,SAAS,CAAC;CACvB,CAAC;AAEF,MAAM,UAAU,4BAA4B,GAA8B;IACzE,OAAO;QACN,GAAG,2BAA2B;QAC9B,UAAU,EAAE,CAAC,GAAG,2BAA2B,CAAC,UAAU,CAAC;KACvD,CAAC;AAAA,CACF;AAED,MAAM,UAAU,sCAAsC,GAAwC;IAC7F,OAAO,6BAA6B,CAAC,8BAA8B,CAAC,kBAAkB,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC;AAAA,CACzG;AAED,MAAM,UAAU,0BAA0B,CAAC,OAA4B,EAA8B;IACpG,IAAI,OAAO,KAAK,iBAAiB,EAAE,CAAC;QACnC,OAAO;YACN,cAAc,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC;YACvC,gBAAgB,EAAE,mBAAmB;YACrC,kBAAkB,EAAE,EAAE;YACtB,mBAAmB,EAAE,IAAI;SACzB,CAAC;IACH,CAAC;IAED,IAAI,OAAO,KAAK,wBAAwB,EAAE,CAAC;QAC1C,OAAO;YACN,cAAc,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC;YACvC,gBAAgB,EAAE,iBAAiB;YACnC,kBAAkB,EAAE,EAAE;YACtB,mBAAmB,EAAE,KAAK;SAC1B,CAAC;IACH,CAAC;IAED,OAAO;QACN,cAAc,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC;QACvC,kBAAkB,EAAE,kBAAkB;QACtC,gBAAgB,EAAE,kBAAkB;QACpC,kBAAkB,EAAE,CAAC,kBAAkB,CAAC;QACxC,mBAAmB,EAAE,IAAI;KACzB,CAAC;AAAA,CACF;AAED,MAAM,UAAU,2BAA2B,CAC1C,QAA+C,EAC/C,YAAwC,EACT;IAC/B,OAAO,CAAC,GAAG,QAAQ,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAC,CAAC;AAAA,CACtD;AAED,MAAM,UAAU,iCAAiC,CAChD,QAA+C,EAC/C,OAAsC,EACK;IAC3C,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IAC/E,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CACd,sDAAsD,cAAc,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC3H,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IACvC,MAAM,aAAa,GAAG,wBAAwB,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACnE,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,IAAI,aAAa,EAAE,OAAO,IAAI,SAAS,CAAC;IAE5E,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,GAAG,YAAY,CAAC,KAAK,8DAA8D,CAAC,CAAC;IACtG,CAAC;IAED,IAAI,aAAa,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACzE,MAAM,MAAM,GAAG,aAAa,CAAC,gBAAgB,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,mBAAmB,OAAO,CAAC,IAAI,EAAE,CAAC;QACxG,MAAM,IAAI,KAAK,CAAC,GAAG,YAAY,CAAC,KAAK,OAAO,MAAM,6BAA6B,OAAO,CAAC,IAAI,OAAO,CAAC,CAAC;IACrG,CAAC;IAED,OAAO;QACN,KAAK,EAAE,YAAY,CAAC,KAAK;QACzB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,wBAAwB,CAAC,YAAY,CAAC,QAAQ,CAAC;KACzD,CAAC;AAAA,CACF;AAED,MAAM,UAAU,mCAAmC,CAClD,QAAyD,EACzD,OAAsC,EACO;IAC7C,MAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC;QAC3D,IAAI,CAAC,YAAY,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QACxC,MAAM,IAAI,GAAG,0BAA0B,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAC5D,OAAO,IAAI,KAAK,kCAAkC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,aAAa,CAAC;IAAA,CACnG,CAAC,CAAC;IAEH,KAAK,MAAM,YAAY,IAAI,iBAAiB,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAG,wBAAwB,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAC5D,IAAI,MAAM,EAAE,IAAI,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,GAAG,YAAY,CAAC,KAAK,gBAAgB,MAAM,CAAC,aAAa,IAAI,cAAc,EAAE,CAAC,CAAC;QAChG,CAAC;IACF,CAAC;IAED,IAAI,iBAAiB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpC,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CACd,uEAAuE,iBAAiB,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC/I,CAAC;IACH,CAAC;IAED,OAAO,oCAAoC,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAAA,CAC3E;AAED,MAAM,UAAU,2BAA2B,CAC1C,QAAuD,EACvD,OAAsC,EACP;IAC/B,MAAM,mBAAmB,GAAiC,EAAE,CAAC;IAC7D,MAAM,iBAAiB,GAA2C,EAAE,CAAC;IACrE,MAAM,kBAAkB,GAAa,EAAE,CAAC;IACxC,MAAM,mBAAmB,GAAa,EAAE,CAAC;IAEzC,KAAK,MAAM,YAAY,IAAI,QAAQ,EAAE,CAAC;QACrC,IAAI,CAAC,YAAY,CAAC,OAAO;YAAE,SAAS;QACpC,MAAM,IAAI,GAAG,0BAA0B,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAC5D,IAAI,IAAI,KAAK,sBAAsB,EAAE,CAAC;YACrC,mBAAmB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACxC,CAAC;aAAM,IAAI,IAAI,KAAK,kCAAkC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;YACxG,iBAAiB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACtC,CAAC;aAAM,IAAI,IAAI,KAAK,oBAAoB,EAAE,CAAC;YAC1C,kBAAkB,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAC7C,CAAC;aAAM,IAAI,IAAI,KAAK,qBAAqB,EAAE,CAAC;YAC3C,mBAAmB,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAC9C,CAAC;IACF,CAAC;IAED,OAAO;QACN,kBAAkB,EAAE,iCAAiC,CAAC,mBAAmB,EAAE,OAAO,CAAC;QACnF,gBAAgB,EAAE,mCAAmC,CAAC,iBAAiB,EAAE,OAAO,CAAC;QACjF,kBAAkB;QAClB,mBAAmB;KACnB,CAAC;AAAA,CACF;AAED,MAAM,UAAU,0BAA0B,CAAC,KAAa,EAA8B;IACrF,OAAO,wBAAwB,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,aAAa,CAAC;AAAA,CAC9D;AAED,SAAS,oCAAoC,CAC5C,YAAkD,EAClD,OAAsC,EACL;IACjC,MAAM,MAAM,GAAG,wBAAwB,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAC5D,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,IAAI,MAAM,EAAE,OAAO,IAAI,SAAS,CAAC;IAErE,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,GAAG,YAAY,CAAC,KAAK,8DAA8D,CAAC,CAAC;IACtG,CAAC;IAED,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,GAAG,YAAY,CAAC,KAAK,uBAAuB,OAAO,CAAC,IAAI,OAAO,CAAC,CAAC;IAClF,CAAC;IAED,IAAI,MAAM,EAAE,uBAAuB,KAAK,IAAI,IAAI,YAAY,CAAC,uBAAuB,KAAK,IAAI,EAAE,CAAC;QAC/F,MAAM,IAAI,KAAK,CAAC,GAAG,YAAY,CAAC,KAAK,qEAAqE,CAAC,CAAC;IAC7G,CAAC;IAED,OAAO;QACN,KAAK,EAAE,YAAY,CAAC,KAAK;QACzB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,6BAA6B,CACtC,MAAM,EAAE,eAAe,IAAI,8BAA8B,CAAC,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,EAC3F,YAAY,CAAC,eAAe,CAC5B;KACD,CAAC;AAAA,CACF;AAED,SAAS,8BAA8B,CACtC,KAAa,EACb,OAAe,EACf,iBAAyB,EACa;IACtC,OAAO;QACN,OAAO,EAAE,wBAAwB;QACjC,KAAK;QACL,OAAO;QACP,WAAW,EAAE,IAAI;QACjB,iBAAiB;QACjB,aAAa,EAAE,IAAI;QACnB,QAAQ,EAAE,CAAC,GAAG,8BAA8B,CAAC;QAC7C,iBAAiB,EAAE,IAAI;QACvB,MAAM,EAAE,CAAC,GAAG,wBAAwB,CAAC;KACrC,CAAC;AAAA,CACF;AAED,SAAS,wBAAwB,CAChC,SAAyD,EAC7B;IAC5B,MAAM,QAAQ,GAAG,4BAA4B,EAAE,CAAC;IAChD,IAAI,CAAC,SAAS,EAAE,CAAC;QAChB,OAAO,QAAQ,CAAC;IACjB,CAAC;IAED,OAAO;QACN,GAAG,QAAQ;QACX,GAAG,SAAS;QACZ,UAAU,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU;KAClF,CAAC;AAAA,CACF;AAED,SAAS,6BAA6B,CACrC,QAA6C,EAC7C,SAAmE,EAC7B;IACtC,IAAI,CAAC,SAAS;QAAE,OAAO,6BAA6B,CAAC,QAAQ,CAAC,CAAC;IAC/D,OAAO;QACN,GAAG,QAAQ;QACX,GAAG,SAAS;QACZ,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC;QAC/E,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC;KACvE,CAAC;AAAA,CACF;AAED,SAAS,6BAA6B,CACrC,QAA6C,EACP;IACtC,OAAO;QACN,GAAG,QAAQ;QACX,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC;QAChC,MAAM,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC;KAC5B,CAAC;AAAA,CACF;AAED,SAAS,iBAAiB,CAAC,YAAwC,EAA8B;IAChG,OAAO;QACN,GAAG,YAAY;QACf,QAAQ,EAAE,YAAY,CAAC,QAAQ;YAC9B,CAAC,CAAC;gBACA,GAAG,YAAY,CAAC,QAAQ;gBACxB,UAAU,EAAE,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS;aAChG;YACF,CAAC,CAAC,SAAS;KACZ,CAAC;AAAA,CACF","sourcesContent":["/**\n * Pure policy helpers for external context pruning and session compaction.\n *\n * Agent-message pruning and session_before_compact compaction are separate\n * ownership lanes. The runtime may run one agent-message pruner and one\n * session compactor, but only one enabled owner may handle session_before_compact.\n */\n\nexport type ExternalPrunerMode = \"experimental\" | \"permanent\";\nexport type ExternalPrunerLicense = \"known\" | \"unknown\";\nexport type PrunerTrigger = \"agent-message\";\nexport type SessionCompactorTrigger = \"session_before_compact\";\nexport type NeverPruneTarget = \"entries\";\nexport type SessionCompactorPhase = \"Extract\" | \"Explore\" | \"Synthesize\" | \"Verify\";\nexport type CompactStackProfile = \"production\" | \"cost-experiment\" | \"long-context-precision\";\nexport type ExternalContextPackageRole =\n\t| \"agent-message-pruner\"\n\t| \"session-before-compact-compactor\"\n\t| \"orchestration-tool\"\n\t| \"continuation-helper\"\n\t| \"blocked\"\n\t| \"unsupported\";\n\nexport interface PrunerRecommendedDefaults {\n\ttrigger: PrunerTrigger;\n\tsoft: number;\n\thard: number;\n\tkeepRecentTokens: number;\n\trecoverOriginals: boolean;\n\tneverPrune: NeverPruneTarget[];\n}\n\nexport interface SessionCompactorRecommendedDefaults {\n\ttrigger: SessionCompactorTrigger;\n\towner: string;\n\tprofile: string;\n\tautoTrigger: boolean;\n\tminContextPercent: number;\n\tbackupEnabled: boolean;\n\tpinPaths: string[];\n\tpreserveToolPairs: boolean;\n\tphases: SessionCompactorPhase[];\n}\n\nexport interface CompactStackRecommendation {\n\tpreCompression: string[];\n\tagentMessagePruner?: string;\n\tsessionCompactor?: string;\n\torchestrationTools: string[];\n\tproviderPromptCache: boolean;\n}\n\nexport interface ExternalPrunerRegistration {\n\towner: string;\n\tenabled: boolean;\n\tlicense?: ExternalPrunerLicense;\n\tdefaults?: Partial<PrunerRecommendedDefaults>;\n}\n\nexport interface ExternalSessionCompactorRegistration {\n\towner: string;\n\tenabled: boolean;\n\tlicense?: ExternalPrunerLicense;\n\tproviderPricingInjected?: boolean;\n\tsessionDefaults?: Partial<SessionCompactorRecommendedDefaults>;\n}\n\nexport interface ExternalContextPackageRegistration\n\textends ExternalPrunerRegistration,\n\t\tExternalSessionCompactorRegistration {}\n\nexport interface ValidateExternalPrunerOptions {\n\tmode: ExternalPrunerMode;\n}\n\nexport interface ValidatedExternalPrunerOwner {\n\towner: string;\n\tmode: ExternalPrunerMode;\n\tdefaults: PrunerRecommendedDefaults;\n}\n\nexport interface ValidatedSessionCompactorOwner {\n\towner: string;\n\tmode: ExternalPrunerMode;\n\tdefaults: SessionCompactorRecommendedDefaults;\n}\n\nexport interface ValidatedCompactPackageStack {\n\tagentMessagePruner?: ValidatedExternalPrunerOwner;\n\tsessionCompactor?: ValidatedSessionCompactorOwner;\n\torchestrationTools: string[];\n\tcontinuationHelpers: string[];\n}\n\ninterface BuiltInPrunerPolicy {\n\tlicense: ExternalPrunerLicense;\n\tallowedModes: readonly ExternalPrunerMode[];\n\texperimentalOnly: boolean;\n}\n\ninterface ContextPackagePolicy {\n\trole: ExternalContextPackageRole;\n\tlicense: ExternalPrunerLicense;\n\tallowedModes: readonly ExternalPrunerMode[];\n\tblockedReason?: string;\n\trequiresProviderPricing?: boolean;\n\tsessionDefaults?: SessionCompactorRecommendedDefaults;\n}\n\nconst PINNED_SESSION_COMPACTOR_PATHS = [\"AGENTS.md\", \"OMK.md\", \".omk/state.json\"] as const;\nconst SESSION_COMPACTOR_PHASES = [\"Extract\", \"Explore\", \"Synthesize\", \"Verify\"] as const;\n\nconst BUILT_IN_PRUNER_POLICIES: Record<string, BuiltInPrunerPolicy> = {\n\t\"pi-context-prune\": {\n\t\tlicense: \"known\",\n\t\tallowedModes: [\"experimental\", \"permanent\"],\n\t\texperimentalOnly: false,\n\t},\n\t\"pi-ultra-compact\": {\n\t\tlicense: \"known\",\n\t\tallowedModes: [\"experimental\"],\n\t\texperimentalOnly: true,\n\t},\n\t\"pi-vcc\": {\n\t\tlicense: \"unknown\",\n\t\tallowedModes: [\"experimental\"],\n\t\texperimentalOnly: true,\n\t},\n};\n\nconst CONTEXT_PACKAGE_POLICIES: Record<string, ContextPackagePolicy> = {\n\t\"pi-context-prune\": {\n\t\trole: \"agent-message-pruner\",\n\t\tlicense: \"known\",\n\t\tallowedModes: [\"experimental\", \"permanent\"],\n\t},\n\t\"pi-smart-compact\": {\n\t\trole: \"session-before-compact-compactor\",\n\t\tlicense: \"known\",\n\t\tallowedModes: [\"experimental\", \"permanent\"],\n\t\tsessionDefaults: createSessionCompactorDefaults(\"pi-smart-compact\", \"balanced\", 72),\n\t},\n\t\"pi-better-compact\": {\n\t\trole: \"session-before-compact-compactor\",\n\t\tlicense: \"known\",\n\t\tallowedModes: [\"experimental\"],\n\t\trequiresProviderPricing: true,\n\t\tsessionDefaults: createSessionCompactorDefaults(\"pi-better-compact\", \"cost-benefit\", 70),\n\t},\n\t\"pi-ultra-compact\": {\n\t\trole: \"session-before-compact-compactor\",\n\t\tlicense: \"known\",\n\t\tallowedModes: [\"experimental\"],\n\t\tsessionDefaults: createSessionCompactorDefaults(\"pi-ultra-compact\", \"canary\", 90),\n\t},\n\t\"pi-omni-compact\": {\n\t\trole: \"session-before-compact-compactor\",\n\t\tlicense: \"known\",\n\t\tallowedModes: [\"experimental\"],\n\t\tsessionDefaults: createSessionCompactorDefaults(\"pi-omni-compact\", \"precision\", 82),\n\t},\n\t\"pi-context-tools\": {\n\t\trole: \"orchestration-tool\",\n\t\tlicense: \"known\",\n\t\tallowedModes: [\"experimental\", \"permanent\"],\n\t},\n\t\"pi-continue\": {\n\t\trole: \"continuation-helper\",\n\t\tlicense: \"known\",\n\t\tallowedModes: [\"experimental\", \"permanent\"],\n\t},\n\t\"@adamjen/pi-compact-fast\": {\n\t\trole: \"blocked\",\n\t\tlicense: \"known\",\n\t\tallowedModes: [],\n\t\tblockedReason: \"source-edited model id configuration is not accepted for OMK runtime ownership\",\n\t},\n\t\"@davehardy20/pi-compact-plus\": {\n\t\trole: \"blocked\",\n\t\tlicense: \"known\",\n\t\tallowedModes: [],\n\t\tblockedReason: \"synthetic user message reinjection violates OMK authority-boundary preservation\",\n\t},\n};\n\nconst RECOMMENDED_PRUNER_DEFAULTS: PrunerRecommendedDefaults = {\n\ttrigger: \"agent-message\",\n\tsoft: 0.7,\n\thard: 0.82,\n\tkeepRecentTokens: 24_000,\n\trecoverOriginals: true,\n\tneverPrune: [\"entries\"],\n};\n\nexport function getRecommendedPrunerDefaults(): PrunerRecommendedDefaults {\n\treturn {\n\t\t...RECOMMENDED_PRUNER_DEFAULTS,\n\t\tneverPrune: [...RECOMMENDED_PRUNER_DEFAULTS.neverPrune],\n\t};\n}\n\nexport function getRecommendedSessionCompactorDefaults(): SessionCompactorRecommendedDefaults {\n\treturn cloneSessionCompactorDefaults(createSessionCompactorDefaults(\"pi-smart-compact\", \"balanced\", 72));\n}\n\nexport function getRecommendedCompactStack(profile: CompactStackProfile): CompactStackRecommendation {\n\tif (profile === \"cost-experiment\") {\n\t\treturn {\n\t\t\tpreCompression: [\"LeanCTX\", \"Headroom\"],\n\t\t\tsessionCompactor: \"pi-better-compact\",\n\t\t\torchestrationTools: [],\n\t\t\tproviderPromptCache: true,\n\t\t};\n\t}\n\n\tif (profile === \"long-context-precision\") {\n\t\treturn {\n\t\t\tpreCompression: [\"LeanCTX\", \"Headroom\"],\n\t\t\tsessionCompactor: \"pi-omni-compact\",\n\t\t\torchestrationTools: [],\n\t\t\tproviderPromptCache: false,\n\t\t};\n\t}\n\n\treturn {\n\t\tpreCompression: [\"LeanCTX\", \"Headroom\"],\n\t\tagentMessagePruner: \"pi-context-prune\",\n\t\tsessionCompactor: \"pi-smart-compact\",\n\t\torchestrationTools: [\"pi-context-tools\"],\n\t\tproviderPromptCache: true,\n\t};\n}\n\nexport function registerExternalPrunerOwner(\n\tregistry: readonly ExternalPrunerRegistration[],\n\tregistration: ExternalPrunerRegistration,\n): ExternalPrunerRegistration[] {\n\treturn [...registry, cloneRegistration(registration)];\n}\n\nexport function validateSingleExternalPrunerOwner(\n\tregistry: readonly ExternalPrunerRegistration[],\n\toptions: ValidateExternalPrunerOptions,\n): ValidatedExternalPrunerOwner | undefined {\n\tconst enabledPruners = registry.filter((registration) => registration.enabled);\n\tif (enabledPruners.length === 0) {\n\t\treturn undefined;\n\t}\n\n\tif (enabledPruners.length > 1) {\n\t\tthrow new Error(\n\t\t\t`Multiple enabled external pruners are not allowed: ${enabledPruners.map((registration) => registration.owner).join(\", \")}`,\n\t\t);\n\t}\n\n\tconst registration = enabledPruners[0];\n\tconst builtInPolicy = BUILT_IN_PRUNER_POLICIES[registration.owner];\n\tconst license = registration.license ?? builtInPolicy?.license ?? \"unknown\";\n\n\tif (options.mode === \"permanent\" && license === \"unknown\") {\n\t\tthrow new Error(`${registration.owner} has unknown license and cannot be enabled in permanent mode`);\n\t}\n\n\tif (builtInPolicy && !builtInPolicy.allowedModes.includes(options.mode)) {\n\t\tconst reason = builtInPolicy.experimentalOnly ? \"experimental-only\" : `not enabled for ${options.mode}`;\n\t\tthrow new Error(`${registration.owner} is ${reason} and cannot be enabled in ${options.mode} mode`);\n\t}\n\n\treturn {\n\t\towner: registration.owner,\n\t\tmode: options.mode,\n\t\tdefaults: mergeRecommendedDefaults(registration.defaults),\n\t};\n}\n\nexport function validateSingleSessionCompactorOwner(\n\tregistry: readonly ExternalSessionCompactorRegistration[],\n\toptions: ValidateExternalPrunerOptions,\n): ValidatedSessionCompactorOwner | undefined {\n\tconst enabledCompactors = registry.filter((registration) => {\n\t\tif (!registration.enabled) return false;\n\t\tconst role = classifyContextPackageRole(registration.owner);\n\t\treturn role === \"session-before-compact-compactor\" || role === \"blocked\" || role === \"unsupported\";\n\t});\n\n\tfor (const registration of enabledCompactors) {\n\t\tconst policy = CONTEXT_PACKAGE_POLICIES[registration.owner];\n\t\tif (policy?.role === \"blocked\") {\n\t\t\tthrow new Error(`${registration.owner} is blocked: ${policy.blockedReason ?? \"not accepted\"}`);\n\t\t}\n\t}\n\n\tif (enabledCompactors.length === 0) {\n\t\treturn undefined;\n\t}\n\n\tif (enabledCompactors.length > 1) {\n\t\tthrow new Error(\n\t\t\t`Multiple enabled session_before_compact compactors are not allowed: ${enabledCompactors.map((registration) => registration.owner).join(\", \")}`,\n\t\t);\n\t}\n\n\treturn validateSessionCompactorRegistration(enabledCompactors[0], options);\n}\n\nexport function validateCompactPackageStack(\n\tregistry: readonly ExternalContextPackageRegistration[],\n\toptions: ValidateExternalPrunerOptions,\n): ValidatedCompactPackageStack {\n\tconst agentMessagePruners: ExternalPrunerRegistration[] = [];\n\tconst sessionCompactors: ExternalSessionCompactorRegistration[] = [];\n\tconst orchestrationTools: string[] = [];\n\tconst continuationHelpers: string[] = [];\n\n\tfor (const registration of registry) {\n\t\tif (!registration.enabled) continue;\n\t\tconst role = classifyContextPackageRole(registration.owner);\n\t\tif (role === \"agent-message-pruner\") {\n\t\t\tagentMessagePruners.push(registration);\n\t\t} else if (role === \"session-before-compact-compactor\" || role === \"blocked\" || role === \"unsupported\") {\n\t\t\tsessionCompactors.push(registration);\n\t\t} else if (role === \"orchestration-tool\") {\n\t\t\torchestrationTools.push(registration.owner);\n\t\t} else if (role === \"continuation-helper\") {\n\t\t\tcontinuationHelpers.push(registration.owner);\n\t\t}\n\t}\n\n\treturn {\n\t\tagentMessagePruner: validateSingleExternalPrunerOwner(agentMessagePruners, options),\n\t\tsessionCompactor: validateSingleSessionCompactorOwner(sessionCompactors, options),\n\t\torchestrationTools,\n\t\tcontinuationHelpers,\n\t};\n}\n\nexport function classifyContextPackageRole(owner: string): ExternalContextPackageRole {\n\treturn CONTEXT_PACKAGE_POLICIES[owner]?.role ?? \"unsupported\";\n}\n\nfunction validateSessionCompactorRegistration(\n\tregistration: ExternalSessionCompactorRegistration,\n\toptions: ValidateExternalPrunerOptions,\n): ValidatedSessionCompactorOwner {\n\tconst policy = CONTEXT_PACKAGE_POLICIES[registration.owner];\n\tconst license = registration.license ?? policy?.license ?? \"unknown\";\n\n\tif (options.mode === \"permanent\" && license === \"unknown\") {\n\t\tthrow new Error(`${registration.owner} has unknown license and cannot be enabled in permanent mode`);\n\t}\n\n\tif (policy && !policy.allowedModes.includes(options.mode)) {\n\t\tthrow new Error(`${registration.owner} is not enabled for ${options.mode} mode`);\n\t}\n\n\tif (policy?.requiresProviderPricing === true && registration.providerPricingInjected !== true) {\n\t\tthrow new Error(`${registration.owner} requires provider pricing before it can own session_before_compact`);\n\t}\n\n\treturn {\n\t\towner: registration.owner,\n\t\tmode: options.mode,\n\t\tdefaults: mergeSessionCompactorDefaults(\n\t\t\tpolicy?.sessionDefaults ?? createSessionCompactorDefaults(registration.owner, \"custom\", 72),\n\t\t\tregistration.sessionDefaults,\n\t\t),\n\t};\n}\n\nfunction createSessionCompactorDefaults(\n\towner: string,\n\tprofile: string,\n\tminContextPercent: number,\n): SessionCompactorRecommendedDefaults {\n\treturn {\n\t\ttrigger: \"session_before_compact\",\n\t\towner,\n\t\tprofile,\n\t\tautoTrigger: true,\n\t\tminContextPercent,\n\t\tbackupEnabled: true,\n\t\tpinPaths: [...PINNED_SESSION_COMPACTOR_PATHS],\n\t\tpreserveToolPairs: true,\n\t\tphases: [...SESSION_COMPACTOR_PHASES],\n\t};\n}\n\nfunction mergeRecommendedDefaults(\n\toverrides: Partial<PrunerRecommendedDefaults> | undefined,\n): PrunerRecommendedDefaults {\n\tconst defaults = getRecommendedPrunerDefaults();\n\tif (!overrides) {\n\t\treturn defaults;\n\t}\n\n\treturn {\n\t\t...defaults,\n\t\t...overrides,\n\t\tneverPrune: overrides.neverPrune ? [...overrides.neverPrune] : defaults.neverPrune,\n\t};\n}\n\nfunction mergeSessionCompactorDefaults(\n\tdefaults: SessionCompactorRecommendedDefaults,\n\toverrides: Partial<SessionCompactorRecommendedDefaults> | undefined,\n): SessionCompactorRecommendedDefaults {\n\tif (!overrides) return cloneSessionCompactorDefaults(defaults);\n\treturn {\n\t\t...defaults,\n\t\t...overrides,\n\t\tpinPaths: overrides.pinPaths ? [...overrides.pinPaths] : [...defaults.pinPaths],\n\t\tphases: overrides.phases ? [...overrides.phases] : [...defaults.phases],\n\t};\n}\n\nfunction cloneSessionCompactorDefaults(\n\tdefaults: SessionCompactorRecommendedDefaults,\n): SessionCompactorRecommendedDefaults {\n\treturn {\n\t\t...defaults,\n\t\tpinPaths: [...defaults.pinPaths],\n\t\tphases: [...defaults.phases],\n\t};\n}\n\nfunction cloneRegistration(registration: ExternalPrunerRegistration): ExternalPrunerRegistration {\n\treturn {\n\t\t...registration,\n\t\tdefaults: registration.defaults\n\t\t\t? {\n\t\t\t\t\t...registration.defaults,\n\t\t\t\t\tneverPrune: registration.defaults.neverPrune ? [...registration.defaults.neverPrune] : undefined,\n\t\t\t\t}\n\t\t\t: undefined,\n\t};\n}\n"]}

package/dist/core/context-graph-identity-resolution.d.ts

@@ -0,0 +1,114 @@
+export type Sha256 = string;
+export type WorkspaceId = string;
+export type RepositoryId = string;
+export type LogicalId = string;
+export type RevisionId = string;
+export type SourceKind = "compiler" | "test" | "git" | "tree_sitter" | "understand_anything" | "user" | "document" | "llm" | "heuristic";
+export interface IdentityKeyInput {
+    readonly workspaceId: WorkspaceId;
+    readonly repositoryId: RepositoryId;
+    readonly branch: string;
+    readonly classIri: string;
+    readonly sourceKind: SourceKind;
+    readonly identityNamespace: string;
+    readonly qualifiedName: string;
+    readonly normalizedSignature: string;
+    /** Retained for callers, but ignored for symbol identity when namespace/name/signature exist. */
+    readonly filePath?: string;
+}
+export interface RevisionKeyInput {
+    readonly logicalId: LogicalId;
+    readonly revisionSourceSha: string;
+    readonly structuralHash: Sha256;
+}
+export interface StructuralFingerprintMetrics {
+    readonly astNodeCount: number;
+    readonly exportedSymbolCount: number;
+    readonly importCount: number;
+    readonly relationCount: number;
+    readonly lineCount?: number;
+}
+export interface StructuralFingerprintInput {
+    readonly classIri: string;
+    readonly sourceKind: SourceKind;
+    readonly normalizedContent?: string;
+    readonly astTokens: readonly string[];
+    readonly publicApiTokens: readonly string[];
+    readonly relationTokens: readonly string[];
+    readonly importTokens?: readonly string[];
+    readonly exportTokens?: readonly string[];
+    readonly summaryTokens?: readonly string[];
+    readonly metrics: StructuralFingerprintMetrics;
+}
+export interface StructuralFingerprint {
+    readonly version: "omk.ontology.fingerprint.v1";
+    readonly extractor: "ua-tree-sitter-normalized-v1";
+    readonly classIri: string;
+    readonly sourceKind: SourceKind;
+    readonly strictContentHash?: Sha256;
+    readonly structuralHash: Sha256;
+    readonly publicApiHash: Sha256;
+    readonly relationShapeHash: Sha256;
+    readonly importHash?: Sha256;
+    readonly exportHash?: Sha256;
+    readonly textSummaryHash?: Sha256;
+    readonly metrics: StructuralFingerprintMetrics;
+}
+export interface IdentitySimilarityFeatures {
+    readonly strictContentEqual: boolean;
+    readonly structuralEqual: boolean;
+    readonly publicApiEqual: boolean;
+    readonly normalizedSignatureSimilarity: number;
+    readonly relationShapeSimilarity: number;
+    readonly nameSimilarity: number;
+    readonly pathSimilarity: number;
+    readonly parentScopeSimilarity: number;
+    readonly sizeSimilarity: number;
+    readonly gitRenameHint: boolean;
+}
+export interface IdentityDecisionThresholds {
+    readonly autoSameAs: number;
+    readonly possibleSameAs: number;
+}
+export interface IdentityResolutionCandidate {
+    readonly logicalId: LogicalId;
+    readonly score: number;
+}
+export interface IdentityAlias {
+    readonly fromLogicalId: LogicalId;
+    readonly toLogicalId: LogicalId;
+    readonly confidence: number;
+    readonly relation: "sameAs" | "renamedTo";
+}
+export interface IdentityResolutionInput {
+    readonly currentLogicalId: LogicalId;
+    readonly previousLogicalIds: readonly LogicalId[];
+    readonly aliases: readonly IdentityAlias[];
+    readonly candidates: readonly IdentityResolutionCandidate[];
+    readonly thresholds?: Partial<IdentityDecisionThresholds>;
+}
+export type IdentityResolutionDecision = {
+    readonly kind: "sameAs";
+    readonly reason: "exact" | "alias" | "merge";
+    readonly logicalId: LogicalId;
+    readonly confidence: number;
+} | {
+    readonly kind: "possibleSameAs";
+    readonly candidates: readonly IdentityResolutionCandidate[];
+    readonly confidence: number;
+} | {
+    readonly kind: "new";
+    readonly logicalId: LogicalId;
+    readonly confidence: 0;
+};
+export declare const IDENTITY_ALGORITHM_VERSION = "omk.ontology.identity.v1";
+export declare const FINGERPRINT_ALGORITHM_VERSION = "omk.ontology.fingerprint.v1";
+export declare const DEFAULT_IDENTITY_DECISION_THRESHOLDS: IdentityDecisionThresholds;
+export declare const canonicalText: (value: string) => string;
+export declare const makeLogicalId: (input: IdentityKeyInput) => string;
+export declare const makeRevisionId: (input: RevisionKeyInput) => string;
+export declare const buildStructuralFingerprint: (input: StructuralFingerprintInput) => StructuralFingerprint;
+export declare const calculateIdentitySimilarity: (features: IdentitySimilarityFeatures) => number;
+export declare const identitySimilarity: (features: IdentitySimilarityFeatures) => number;
+export declare const resolveIdentity: (input: IdentityResolutionInput) => IdentityResolutionDecision;
+//# sourceMappingURL=context-graph-identity-resolution.d.ts.map

package/dist/core/context-graph-identity-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-graph-identity-resolution.d.ts","sourceRoot":"","sources":["../../src/core/context-graph-identity-resolution.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\n\nexport type Sha256 = string;\nexport type WorkspaceId = string;\nexport type RepositoryId = string;\nexport type LogicalId = string;\nexport type RevisionId = string;\n\nexport type SourceKind =\n\t| \"compiler\"\n\t| \"test\"\n\t| \"git\"\n\t| \"tree_sitter\"\n\t| \"understand_anything\"\n\t| \"user\"\n\t| \"document\"\n\t| \"llm\"\n\t| \"heuristic\";\n\nexport interface IdentityKeyInput {\n\treadonly workspaceId: WorkspaceId;\n\treadonly repositoryId: RepositoryId;\n\treadonly branch: string;\n\treadonly classIri: string;\n\treadonly sourceKind: SourceKind;\n\treadonly identityNamespace: string;\n\treadonly qualifiedName: string;\n\treadonly normalizedSignature: string;\n\t/** Retained for callers, but ignored for symbol identity when namespace/name/signature exist. */\n\treadonly filePath?: string;\n}\n\nexport interface RevisionKeyInput {\n\treadonly logicalId: LogicalId;\n\treadonly revisionSourceSha: string;\n\treadonly structuralHash: Sha256;\n}\n\nexport interface StructuralFingerprintMetrics {\n\treadonly astNodeCount: number;\n\treadonly exportedSymbolCount: number;\n\treadonly importCount: number;\n\treadonly relationCount: number;\n\treadonly lineCount?: number;\n}\n\nexport interface StructuralFingerprintInput {\n\treadonly classIri: string;\n\treadonly sourceKind: SourceKind;\n\treadonly normalizedContent?: string;\n\treadonly astTokens: readonly string[];\n\treadonly publicApiTokens: readonly string[];\n\treadonly relationTokens: readonly string[];\n\treadonly importTokens?: readonly string[];\n\treadonly exportTokens?: readonly string[];\n\treadonly summaryTokens?: readonly string[];\n\treadonly metrics: StructuralFingerprintMetrics;\n}\n\nexport interface StructuralFingerprint {\n\treadonly version: \"omk.ontology.fingerprint.v1\";\n\treadonly extractor: \"ua-tree-sitter-normalized-v1\";\n\treadonly classIri: string;\n\treadonly sourceKind: SourceKind;\n\treadonly strictContentHash?: Sha256;\n\treadonly structuralHash: Sha256;\n\treadonly publicApiHash: Sha256;\n\treadonly relationShapeHash: Sha256;\n\treadonly importHash?: Sha256;\n\treadonly exportHash?: Sha256;\n\treadonly textSummaryHash?: Sha256;\n\treadonly metrics: StructuralFingerprintMetrics;\n}\n\nexport interface IdentitySimilarityFeatures {\n\treadonly strictContentEqual: boolean;\n\treadonly structuralEqual: boolean;\n\treadonly publicApiEqual: boolean;\n\treadonly normalizedSignatureSimilarity: number;\n\treadonly relationShapeSimilarity: number;\n\treadonly nameSimilarity: number;\n\treadonly pathSimilarity: number;\n\treadonly parentScopeSimilarity: number;\n\treadonly sizeSimilarity: number;\n\treadonly gitRenameHint: boolean;\n}\n\nexport interface IdentityDecisionThresholds {\n\treadonly autoSameAs: number;\n\treadonly possibleSameAs: number;\n}\n\nexport interface IdentityResolutionCandidate {\n\treadonly logicalId: LogicalId;\n\treadonly score: number;\n}\n\nexport interface IdentityAlias {\n\treadonly fromLogicalId: LogicalId;\n\treadonly toLogicalId: LogicalId;\n\treadonly confidence: number;\n\treadonly relation: \"sameAs\" | \"renamedTo\";\n}\n\nexport interface IdentityResolutionInput {\n\treadonly currentLogicalId: LogicalId;\n\treadonly previousLogicalIds: readonly LogicalId[];\n\treadonly aliases: readonly IdentityAlias[];\n\treadonly candidates: readonly IdentityResolutionCandidate[];\n\treadonly thresholds?: Partial<IdentityDecisionThresholds>;\n}\n\nexport type IdentityResolutionDecision =\n\t| {\n\t\t\treadonly kind: \"sameAs\";\n\t\t\treadonly reason: \"exact\" | \"alias\" | \"merge\";\n\t\t\treadonly logicalId: LogicalId;\n\t\t\treadonly confidence: number;\n\t  }\n\t| {\n\t\t\treadonly kind: \"possibleSameAs\";\n\t\t\treadonly candidates: readonly IdentityResolutionCandidate[];\n\t\t\treadonly confidence: number;\n\t  }\n\t| {\n\t\t\treadonly kind: \"new\";\n\t\t\treadonly logicalId: LogicalId;\n\t\t\treadonly confidence: 0;\n\t  };\n\nexport const IDENTITY_ALGORITHM_VERSION = \"omk.ontology.identity.v1\";\nexport const FINGERPRINT_ALGORITHM_VERSION = \"omk.ontology.fingerprint.v1\";\n\nexport const DEFAULT_IDENTITY_DECISION_THRESHOLDS: IdentityDecisionThresholds = {\n\tautoSameAs: 0.92,\n\tpossibleSameAs: 0.78,\n};\n\nexport const canonicalText = (value: string): string =>\n\tvalue.normalize(\"NFKC\").replace(/\\\\/g, \"/\").replace(/\\s+/g, \" \").replace(/^\\.\\//, \"\").trim();\n\nexport const makeLogicalId = (input: IdentityKeyInput): LogicalId => {\n\tconst tuple = [\n\t\t\"omk.logical.v1\",\n\t\tcanonicalText(input.workspaceId),\n\t\tcanonicalText(input.repositoryId),\n\t\tcanonicalText(input.branch),\n\t\tcanonicalText(input.classIri),\n\t\tcanonicalText(input.sourceKind),\n\t\tcanonicalText(input.identityNamespace),\n\t\tmakeQualifiedIdentityName(input),\n\t\tcanonicalText(input.normalizedSignature),\n\t];\n\n\treturn `log_${sha256Hex(tuple.join(\"\\0\"))}`;\n};\n\nexport const makeRevisionId = (input: RevisionKeyInput): RevisionId => {\n\tconst tuple = [\n\t\t\"omk.revision.v1\",\n\t\tcanonicalText(input.logicalId),\n\t\tcanonicalText(input.revisionSourceSha),\n\t\tcanonicalText(input.structuralHash),\n\t];\n\n\treturn `rev_${sha256Hex(tuple.join(\"\\0\"))}`;\n};\n\nexport const buildStructuralFingerprint = (input: StructuralFingerprintInput): StructuralFingerprint => {\n\tconst strictContentHash = input.normalizedContent\n\t\t? sha256Hex([\"omk.content.v1\", normalizeLf(input.normalizedContent)].join(\"\\0\"))\n\t\t: undefined;\n\n\treturn {\n\t\tversion: FINGERPRINT_ALGORITHM_VERSION,\n\t\textractor: \"ua-tree-sitter-normalized-v1\",\n\t\tclassIri: canonicalText(input.classIri),\n\t\tsourceKind: input.sourceKind,\n\t\tstrictContentHash,\n\t\tstructuralHash: hashTokens(\"omk.structure.v1\", [input.classIri, ...input.astTokens]),\n\t\tpublicApiHash: hashTokens(\"omk.public-api.v1\", [input.classIri, ...input.publicApiTokens]),\n\t\trelationShapeHash: hashTokens(\"omk.relation-shape.v1\", input.relationTokens),\n\t\timportHash: hashOptionalTokens(\"omk.imports.v1\", input.importTokens),\n\t\texportHash: hashOptionalTokens(\"omk.exports.v1\", input.exportTokens),\n\t\ttextSummaryHash: hashOptionalTokens(\"omk.summary.v1\", input.summaryTokens),\n\t\tmetrics: { ...input.metrics },\n\t};\n};\n\nexport const calculateIdentitySimilarity = (features: IdentitySimilarityFeatures): number => {\n\tif (features.strictContentEqual) return 1;\n\n\tconst score =\n\t\t(features.structuralEqual ? 0.35 : 0) +\n\t\t(features.publicApiEqual ? 0.18 : 0) +\n\t\t0.12 * clamp01(features.normalizedSignatureSimilarity) +\n\t\t0.1 * clamp01(features.relationShapeSimilarity) +\n\t\t0.1 * clamp01(features.nameSimilarity) +\n\t\t0.08 * clamp01(features.pathSimilarity) +\n\t\t0.05 * clamp01(features.parentScopeSimilarity) +\n\t\t0.02 * clamp01(features.sizeSimilarity) +\n\t\t(features.gitRenameHint ? 0.1 : 0);\n\n\treturn clamp01(score);\n};\n\nexport const identitySimilarity = calculateIdentitySimilarity;\n\nexport const resolveIdentity = (input: IdentityResolutionInput): IdentityResolutionDecision => {\n\tconst thresholds = { ...DEFAULT_IDENTITY_DECISION_THRESHOLDS, ...input.thresholds };\n\tconst exactMatch = sortLogicalIds(input.previousLogicalIds).find(\n\t\t(logicalId) => logicalId === input.currentLogicalId,\n\t);\n\tif (exactMatch) return { kind: \"sameAs\", reason: \"exact\", logicalId: exactMatch, confidence: 1 };\n\n\tconst acceptedAlias = sortAliases(input.aliases).find(\n\t\t(alias) => alias.toLogicalId === input.currentLogicalId && alias.confidence >= thresholds.autoSameAs,\n\t);\n\tif (acceptedAlias) {\n\t\treturn {\n\t\t\tkind: \"sameAs\",\n\t\t\treason: \"alias\",\n\t\t\tlogicalId: acceptedAlias.fromLogicalId,\n\t\t\tconfidence: clamp01(acceptedAlias.confidence),\n\t\t};\n\t}\n\n\tconst sortedCandidates = sortCandidates(input.candidates);\n\tconst best = sortedCandidates[0];\n\tif (!best) return { kind: \"new\", logicalId: input.currentLogicalId, confidence: 0 };\n\tif (best.score >= thresholds.autoSameAs) {\n\t\treturn { kind: \"sameAs\", reason: \"merge\", logicalId: best.logicalId, confidence: clamp01(best.score) };\n\t}\n\tif (best.score >= thresholds.possibleSameAs) {\n\t\treturn {\n\t\t\tkind: \"possibleSameAs\",\n\t\t\tcandidates: sortedCandidates.filter((candidate) => candidate.score >= thresholds.possibleSameAs),\n\t\t\tconfidence: clamp01(best.score),\n\t\t};\n\t}\n\treturn { kind: \"new\", logicalId: input.currentLogicalId, confidence: 0 };\n};\n\nconst makeQualifiedIdentityName = (input: IdentityKeyInput): string => {\n\tconst qualifiedName = canonicalText(input.qualifiedName);\n\tif (qualifiedName || isSymbolClass(input.classIri)) return qualifiedName;\n\treturn canonicalText(input.filePath ?? \"\");\n};\n\nconst isSymbolClass = (classIri: string): boolean => canonicalText(classIri).endsWith(\"Symbol\");\n\nconst sha256Hex = (value: string): Sha256 => createHash(\"sha256\").update(value, \"utf8\").digest(\"hex\");\n\nconst normalizeLf = (value: string): string => value.replace(/\\r\\n?/g, \"\\n\");\n\nconst hashTokens = (version: string, tokens: readonly string[]): Sha256 => {\n\tconst canonicalTokens = tokens\n\t\t.map(canonicalText)\n\t\t.filter((token) => token.length > 0)\n\t\t.sort();\n\treturn sha256Hex([version, ...canonicalTokens].join(\"\\0\"));\n};\n\nconst hashOptionalTokens = (version: string, tokens: readonly string[] | undefined): Sha256 | undefined => {\n\tif (!tokens || tokens.length === 0) return undefined;\n\treturn hashTokens(version, tokens);\n};\n\nconst clamp01 = (value: number): number => {\n\tif (Number.isNaN(value) || value <= 0) return 0;\n\tif (value >= 1) return 1;\n\treturn value;\n};\n\nconst sortLogicalIds = (logicalIds: readonly LogicalId[]): LogicalId[] =>\n\t[...logicalIds].sort((a, b) => a.localeCompare(b));\n\nconst sortAliases = (aliases: readonly IdentityAlias[]): IdentityAlias[] =>\n\t[...aliases].sort((a, b) => b.confidence - a.confidence || a.fromLogicalId.localeCompare(b.fromLogicalId));\n\nconst sortCandidates = (candidates: readonly IdentityResolutionCandidate[]): IdentityResolutionCandidate[] =>\n\t[...candidates].sort((a, b) => b.score - a.score || a.logicalId.localeCompare(b.logicalId));\n"]}

package/dist/core/context-graph-identity-resolution.js

@@ -0,0 +1,127 @@
+import { createHash } from "node:crypto";
+export const IDENTITY_ALGORITHM_VERSION = "omk.ontology.identity.v1";
+export const FINGERPRINT_ALGORITHM_VERSION = "omk.ontology.fingerprint.v1";
+export const DEFAULT_IDENTITY_DECISION_THRESHOLDS = {
+    autoSameAs: 0.92,
+    possibleSameAs: 0.78,
+};
+export const canonicalText = (value) => value.normalize("NFKC").replace(/\\/g, "/").replace(/\s+/g, " ").replace(/^\.\//, "").trim();
+export const makeLogicalId = (input) => {
+    const tuple = [
+        "omk.logical.v1",
+        canonicalText(input.workspaceId),
+        canonicalText(input.repositoryId),
+        canonicalText(input.branch),
+        canonicalText(input.classIri),
+        canonicalText(input.sourceKind),
+        canonicalText(input.identityNamespace),
+        makeQualifiedIdentityName(input),
+        canonicalText(input.normalizedSignature),
+    ];
+    return `log_${sha256Hex(tuple.join("\0"))}`;
+};
+export const makeRevisionId = (input) => {
+    const tuple = [
+        "omk.revision.v1",
+        canonicalText(input.logicalId),
+        canonicalText(input.revisionSourceSha),
+        canonicalText(input.structuralHash),
+    ];
+    return `rev_${sha256Hex(tuple.join("\0"))}`;
+};
+export const buildStructuralFingerprint = (input) => {
+    const strictContentHash = input.normalizedContent
+        ? sha256Hex(["omk.content.v1", normalizeLf(input.normalizedContent)].join("\0"))
+        : undefined;
+    return {
+        version: FINGERPRINT_ALGORITHM_VERSION,
+        extractor: "ua-tree-sitter-normalized-v1",
+        classIri: canonicalText(input.classIri),
+        sourceKind: input.sourceKind,
+        strictContentHash,
+        structuralHash: hashTokens("omk.structure.v1", [input.classIri, ...input.astTokens]),
+        publicApiHash: hashTokens("omk.public-api.v1", [input.classIri, ...input.publicApiTokens]),
+        relationShapeHash: hashTokens("omk.relation-shape.v1", input.relationTokens),
+        importHash: hashOptionalTokens("omk.imports.v1", input.importTokens),
+        exportHash: hashOptionalTokens("omk.exports.v1", input.exportTokens),
+        textSummaryHash: hashOptionalTokens("omk.summary.v1", input.summaryTokens),
+        metrics: { ...input.metrics },
+    };
+};
+export const calculateIdentitySimilarity = (features) => {
+    if (features.strictContentEqual)
+        return 1;
+    const score = (features.structuralEqual ? 0.35 : 0) +
+        (features.publicApiEqual ? 0.18 : 0) +
+        0.12 * clamp01(features.normalizedSignatureSimilarity) +
+        0.1 * clamp01(features.relationShapeSimilarity) +
+        0.1 * clamp01(features.nameSimilarity) +
+        0.08 * clamp01(features.pathSimilarity) +
+        0.05 * clamp01(features.parentScopeSimilarity) +
+        0.02 * clamp01(features.sizeSimilarity) +
+        (features.gitRenameHint ? 0.1 : 0);
+    return clamp01(score);
+};
+export const identitySimilarity = calculateIdentitySimilarity;
+export const resolveIdentity = (input) => {
+    const thresholds = { ...DEFAULT_IDENTITY_DECISION_THRESHOLDS, ...input.thresholds };
+    const exactMatch = sortLogicalIds(input.previousLogicalIds).find((logicalId) => logicalId === input.currentLogicalId);
+    if (exactMatch)
+        return { kind: "sameAs", reason: "exact", logicalId: exactMatch, confidence: 1 };
+    const acceptedAlias = sortAliases(input.aliases).find((alias) => alias.toLogicalId === input.currentLogicalId && alias.confidence >= thresholds.autoSameAs);
+    if (acceptedAlias) {
+        return {
+            kind: "sameAs",
+            reason: "alias",
+            logicalId: acceptedAlias.fromLogicalId,
+            confidence: clamp01(acceptedAlias.confidence),
+        };
+    }
+    const sortedCandidates = sortCandidates(input.candidates);
+    const best = sortedCandidates[0];
+    if (!best)
+        return { kind: "new", logicalId: input.currentLogicalId, confidence: 0 };
+    if (best.score >= thresholds.autoSameAs) {
+        return { kind: "sameAs", reason: "merge", logicalId: best.logicalId, confidence: clamp01(best.score) };
+    }
+    if (best.score >= thresholds.possibleSameAs) {
+        return {
+            kind: "possibleSameAs",
+            candidates: sortedCandidates.filter((candidate) => candidate.score >= thresholds.possibleSameAs),
+            confidence: clamp01(best.score),
+        };
+    }
+    return { kind: "new", logicalId: input.currentLogicalId, confidence: 0 };
+};
+const makeQualifiedIdentityName = (input) => {
+    const qualifiedName = canonicalText(input.qualifiedName);
+    if (qualifiedName || isSymbolClass(input.classIri))
+        return qualifiedName;
+    return canonicalText(input.filePath ?? "");
+};
+const isSymbolClass = (classIri) => canonicalText(classIri).endsWith("Symbol");
+const sha256Hex = (value) => createHash("sha256").update(value, "utf8").digest("hex");
+const normalizeLf = (value) => value.replace(/\r\n?/g, "\n");
+const hashTokens = (version, tokens) => {
+    const canonicalTokens = tokens
+        .map(canonicalText)
+        .filter((token) => token.length > 0)
+        .sort();
+    return sha256Hex([version, ...canonicalTokens].join("\0"));
+};
+const hashOptionalTokens = (version, tokens) => {
+    if (!tokens || tokens.length === 0)
+        return undefined;
+    return hashTokens(version, tokens);
+};
+const clamp01 = (value) => {
+    if (Number.isNaN(value) || value <= 0)
+        return 0;
+    if (value >= 1)
+        return 1;
+    return value;
+};
+const sortLogicalIds = (logicalIds) => [...logicalIds].sort((a, b) => a.localeCompare(b));
+const sortAliases = (aliases) => [...aliases].sort((a, b) => b.confidence - a.confidence || a.fromLogicalId.localeCompare(b.fromLogicalId));
+const sortCandidates = (candidates) => [...candidates].sort((a, b) => b.score - a.score || a.logicalId.localeCompare(b.logicalId));
+//# sourceMappingURL=context-graph-identity-resolution.js.map