@remnic/core 9.69.56 → 9.69.57

package/dist/recall-state-view.d.ts

@@ -1,12 +1,12 @@
-type StateLabel = "current" | "historical" | "transition";
-interface StateViewChain {
+export type StateLabel = "current" | "historical" | "transition";
+export interface StateViewChain {
     predecessorId: string;
     successorId: string;
     supersededAt?: string;
     /** #2859 — namespace scope; a chain link never crosses namespaces. */
     namespace?: string;
 }
-interface StateViewResult {
+export interface StateViewResult {
     id?: string;
     docid?: string;
     status?: string;
@@ -22,21 +22,21 @@ interface StateViewResult {
     invalidAt?: string;
     stateLabel?: StateLabel;
 }
-declare const DEFAULT_RECALL_STATE_VIEWS = false;
-declare function parseRecallStateViews(raw: unknown): boolean;
-declare function isChangeOrientedQuery(query: string): boolean;
-declare function shouldWidenSuperseded(successorId: string | undefined, candidateIds: ReadonlySet<string>): boolean;
-declare function formatSupersededPrefix(date: string, successorId: string): string;
-declare function resultStateViewId(result: StateViewResult): string;
+export declare const DEFAULT_RECALL_STATE_VIEWS = false;
+export declare function parseRecallStateViews(raw: unknown): boolean;
+export declare function isChangeOrientedQuery(query: string): boolean;
+export declare function shouldWidenSuperseded(successorId: string | undefined, candidateIds: ReadonlySet<string>): boolean;
+export declare function formatSupersededPrefix(date: string, successorId: string): string;
+export declare function resultStateViewId(result: StateViewResult): string;
 /**
  * #2859 — namespace-qualified chain identity. Namespace fanout can surface
  * the same id from two namespaces; every successor/admission match runs on
  * `namespace\0id` keys so a row in one namespace can never anchor (or be
  * anchored by) an identically-named row in another.
  */
-declare function stateViewKey(namespace: string | undefined, id: string): string;
-declare function resultStateViewKey(result: StateViewResult): string;
-declare function annotateStateView<T extends StateViewResult>(results: T[], query: string, chains: readonly StateViewChain[], options?: {
+export declare function stateViewKey(namespace: string | undefined, id: string): string;
+export declare function resultStateViewKey(result: StateViewResult): string;
+export declare function annotateStateView<T extends StateViewResult>(results: T[], query: string, chains: readonly StateViewChain[], options?: {
     enabled?: boolean;
     asOfMs?: number;
     changeIntent?: boolean;
@@ -49,7 +49,7 @@ declare function annotateStateView<T extends StateViewResult>(results: T[], quer
  * order. ponytail: repeated full-pool passes are O(n²) on one long chain;
  * recall pools stay small, memoize per-key if pools ever grow.
  */
-declare function reconcileStateViewPairs<T extends StateViewResult>(results: readonly T[]): T[];
+export declare function reconcileStateViewPairs<T extends StateViewResult>(results: readonly T[]): T[];
 /**
  * #2928 — per-row packet root keys for the final output budget. Runs the
  * same namespace-qualified union-find as {@link capStateViewPackets}:
@@ -57,7 +57,7 @@ declare function reconcileStateViewPairs<T extends StateViewResult>(results: rea
  * budget that admits one row of the packet can admit them all or none.
  * Blank-key rows get unique per-index roots (distinct singletons).
  */
-declare function stateViewPacketKeys<T extends StateViewResult>(ordered: readonly T[]): string[];
+export declare function stateViewPacketKeys<T extends StateViewResult>(ordered: readonly T[]): string[];
 /**
  * #2859 — packet-counting cap. A predecessor/successor chain admitted
  * together is ONE complete evidence packet: it consumes a single slot of
@@ -66,6 +66,5 @@ declare function stateViewPacketKeys<T extends StateViewResult>(ordered: readonl
  * (MMR) order; packets are ordered by first appearance. Call
  * reconcileStateViewPairs first so orphans never consume a slot.
  */
-declare function capStateViewPackets<T extends StateViewResult>(ordered: readonly T[], limit: number): T[];
-
-export { DEFAULT_RECALL_STATE_VIEWS, type StateLabel, type StateViewChain, type StateViewResult, annotateStateView, capStateViewPackets, formatSupersededPrefix, isChangeOrientedQuery, parseRecallStateViews, reconcileStateViewPairs, resultStateViewId, resultStateViewKey, shouldWidenSuperseded, stateViewKey, stateViewPacketKeys };
+export declare function capStateViewPackets<T extends StateViewResult>(ordered: readonly T[], limit: number): T[];
+//# sourceMappingURL=recall-state-view.d.ts.map

package/dist/recall-state-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall-state-view.d.ts","sourceRoot":"","sources":["../src/recall-state-view.ts"],"names":[],"mappings":"AAoBA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,YAAY,GAAG,YAAY,CAAC;AAEjE,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,eAAO,MAAM,0BAA0B,QAAQ,CAAC;AAchD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAE3D;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAG5D;AAED,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,GAChC,OAAO,CAET;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEhF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAEjE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAGlE;AAyGD,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,eAAe,EACzD,OAAO,EAAE,CAAC,EAAE,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,SAAS,cAAc,EAAE,EACjC,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAO,GAC3E,CAAC,EAAE,CA2DL;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,eAAe,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE,CAkB7F;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,eAAe,EAC3D,OAAO,EAAE,SAAS,CAAC,EAAE,GACpB,MAAM,EAAE,CAqCV;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,eAAe,EAC3D,OAAO,EAAE,SAAS,CAAC,EAAE,EACrB,KAAK,EAAE,MAAM,GACZ,CAAC,EAAE,CAiBL"}

package/dist/recall-state.d.ts

@@ -1,27 +1,10 @@
-import { HeldFileLockOptions } from './utils/serialize-mutations.js';
-import { SearchDegradation } from './search/port.js';
-import { R as RecallPlanMode, I as IdentityInjectionMode, b as RecallTierExplain } from './types-Du6VdoAg.js';
-import { IncludedMemory } from './included-memories.js';
-export { coerceIncludedMemories } from './included-memories.js';
-import './message-parts/index.js';
-import './bounded-jsonl-state.js';
-import './operator-doctor-types.js';
-import './external-wiki-config.js';
-import './recall-state-view.js';
-import './contradiction-config.js';
-import './graph-path-scoring-config.js';
-import './background-generation-config.js';
-import './deep-recall-config.js';
-import './recall-navigation-config.js';
-import './recall-recognition-tier.js';
-import './causal-trajectory.js';
-import './objective-state.js';
-import './active-context-config.js';
-import './local-llm-config.js';
-import './semantic-merge-config.js';
-import './types-continuity.js';
-
-interface LastRecallBudgetSummary {
+import { type HeldFileLockOptions } from "./utils/serialize-mutations.js";
+import type { SearchDegradation } from "./search/port.js";
+import type { IdentityInjectionMode, RecallPlanMode, RecallTierExplain } from "./types.js";
+import { type IncludedMemory } from "./included-memories.js";
+export type { IncludedMemory } from "./included-memories.js";
+export { coerceIncludedMemories } from "./included-memories.js";
+export interface LastRecallBudgetSummary {
     requestedTopK?: number;
     appliedTopK: number;
     recallBudgetChars: number;
@@ -37,7 +20,7 @@ interface LastRecallBudgetSummary {
     includedMemoryNamespaces?: Array<string | undefined>;
     omittedMemoryIds?: string[];
 }
-interface LastRecallSnapshot {
+export interface LastRecallSnapshot {
     sessionKey: string;
     recordedAt: string;
     queryHash: string;
@@ -85,7 +68,7 @@ interface LastRecallSnapshot {
      */
     backendDegradations?: SearchDegradation[];
 }
-interface GraphRecallExpandedEntry {
+export interface GraphRecallExpandedEntry {
     path: string;
     score: number;
     namespace: string;
@@ -105,9 +88,9 @@ interface GraphRecallExpandedEntry {
     /** True when a graph path penalty was applied. */
     pathPenaltyApplied?: boolean;
 }
-declare function clampGraphRecallExpandedEntries(entries: unknown, maxEntries?: number): GraphRecallExpandedEntry[];
+export declare function clampGraphRecallExpandedEntries(entries: unknown, maxEntries?: number): GraphRecallExpandedEntry[];
 type StateFileWriter = (filePath: string, content: string) => Promise<void>;
-interface TierMigrationCycleSummary {
+export interface TierMigrationCycleSummary {
     trigger: "extraction" | "maintenance" | "manual";
     scanned: number;
     migrated: number;
@@ -118,7 +101,7 @@ interface TierMigrationCycleSummary {
     skipped?: string;
     errorCount?: number;
 }
-interface TierMigrationStatusSnapshot {
+export interface TierMigrationStatusSnapshot {
     updatedAt: string;
     lastCycle: TierMigrationCycleSummary | null;
     totals: {
@@ -137,7 +120,7 @@ interface TierMigrationStatusSnapshot {
  * data-safe cases apart from the one where an offline-sync snapshot would
  * silently omit recorded impressions (#2033).
  */
-interface DrainPendingImpressionsResult {
+export interface DrainPendingImpressionsResult {
     /** Pending spill rows were folded into the synced active file this call. */
     folded: boolean;
     /**
@@ -151,7 +134,7 @@ interface DrainPendingImpressionsResult {
      */
     pendingDeferred: boolean;
 }
-declare class LastRecallStore {
+export declare class LastRecallStore {
     private readonly statePath;
     private readonly impressionsPath;
     private readonly writeStateFile;
@@ -354,7 +337,7 @@ declare class LastRecallStore {
     }): Promise<void>;
     private flushState;
 }
-declare class TierMigrationStatusStore {
+export declare class TierMigrationStatusStore {
     private readonly statePath;
     private state;
     constructor(memoryDir: string);
@@ -374,7 +357,7 @@ declare class TierMigrationStatusStore {
  * snapshot), capped at `depth` per session and 50 sessions total (rule 27
  * slice/cap guards). Misses are acceptable and tagged at resolution time.
  */
-declare class RecallHandleHistoryStore {
+export declare class RecallHandleHistoryStore {
     private readonly statePath;
     private readonly writeStateFile;
     private state;
@@ -400,5 +383,4 @@ declare class RecallHandleHistoryStore {
     private capSessions;
     private flush;
 }
-
-export { type DrainPendingImpressionsResult, type GraphRecallExpandedEntry, IncludedMemory, type LastRecallBudgetSummary, type LastRecallSnapshot, LastRecallStore, RecallHandleHistoryStore, type TierMigrationCycleSummary, type TierMigrationStatusSnapshot, TierMigrationStatusStore, clampGraphRecallExpandedEntries };
+//# sourceMappingURL=recall-state.d.ts.map

package/dist/recall-state.d.ts.map

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

package/dist/recall-tag-filter.d.ts

@@ -1,27 +1,5 @@
-import { RecallFilterTrace } from './recall-xray.js';
-import './memory-provenance.js';
-import './types-Du6VdoAg.js';
-import './message-parts/index.js';
-import './bounded-jsonl-state.js';
-import './operator-doctor-types.js';
-import './external-wiki-config.js';
-import './recall-state-view.js';
-import './contradiction-config.js';
-import './graph-path-scoring-config.js';
-import './background-generation-config.js';
-import './deep-recall-config.js';
-import './recall-navigation-config.js';
-import './recall-recognition-tier.js';
-import './causal-trajectory.js';
-import './objective-state.js';
-import './active-context-config.js';
-import './local-llm-config.js';
-import './semantic-merge-config.js';
-import './types-continuity.js';
-import './user-model.js';
-import './recall-context-composition.js';
-
-type TagMatchMode = "any" | "all";
+import type { RecallFilterTrace } from "./recall-xray.js";
+export type TagMatchMode = "any" | "all";
 /**
  * Coerce a caller-supplied `tagMatch` value to the allowed enum.
  *
@@ -29,7 +7,7 @@ type TagMatchMode = "any" | "all";
  * - Valid string → narrowed `TagMatchMode`.
  * - Invalid string → throws (CLAUDE.md rule 51 — never silently default).
  */
-declare function parseTagMatch(value: unknown): TagMatchMode | undefined;
+export declare function parseTagMatch(value: unknown): TagMatchMode | undefined;
 /**
  * Coerce a caller-supplied `tags` value into a clean string[].
  *
@@ -37,12 +15,12 @@ declare function parseTagMatch(value: unknown): TagMatchMode | undefined;
  * `undefined` when no usable tags remain so downstream callers can treat
  * "no filter" and "empty filter" identically.
  */
-declare function normalizeTags(value: unknown): string[] | undefined;
-interface TagFilterInput {
+export declare function normalizeTags(value: unknown): string[] | undefined;
+export interface TagFilterInput {
     tags: string[] | undefined;
     tagMatch: TagMatchMode | undefined;
 }
-interface TagFilterDecision {
+export interface TagFilterDecision {
     /** Whether the candidate's tags satisfy the filter. */
     admitted: boolean;
 }
@@ -53,8 +31,8 @@ interface TagFilterDecision {
  * tags. `all` admits only when every filter tag is present on the result.
  * Returns `admitted: true` whenever no filter tags are configured.
  */
-declare function evaluateTagFilter(candidateTags: string[] | undefined, filter: TagFilterInput): TagFilterDecision;
-interface TaggedResult {
+export declare function evaluateTagFilter(candidateTags: string[] | undefined, filter: TagFilterInput): TagFilterDecision;
+export interface TaggedResult {
     tags: string[];
 }
 /**
@@ -68,9 +46,8 @@ interface TaggedResult {
  * `trace` is `null` when no filter tags were configured so callers can
  * skip emitting an empty trace entry.
  */
-declare function applyTagFilter<T extends TaggedResult>(results: T[], filter: TagFilterInput): {
+export declare function applyTagFilter<T extends TaggedResult>(results: T[], filter: TagFilterInput): {
     results: T[];
     trace: RecallFilterTrace | null;
 };
-
-export { type TagFilterDecision, type TagFilterInput, type TagMatchMode, type TaggedResult, applyTagFilter, evaluateTagFilter, normalizeTags, parseTagMatch };
+//# sourceMappingURL=recall-tag-filter.d.ts.map

package/dist/recall-tag-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall-tag-filter.d.ts","sourceRoot":"","sources":["../src/recall-tag-filter.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,KAAK,CAAC;AAIzC;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAetE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAalE;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC3B,QAAQ,EAAE,YAAY,GAAG,SAAS,CAAC;CACpC;AAED,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,MAAM,EAAE,GAAG,SAAS,EACnC,MAAM,EAAE,cAAc,GACrB,iBAAiB,CAkBnB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,YAAY,EACnD,OAAO,EAAE,CAAC,EAAE,EACZ,MAAM,EAAE,cAAc,GACrB;IAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAA;CAAE,CAmBnD"}

package/dist/recall-timings.d.ts

@@ -1,30 +1,12 @@
-import { P as PluginConfig } from './types-Du6VdoAg.js';
-import './message-parts/index.js';
-import './bounded-jsonl-state.js';
-import './operator-doctor-types.js';
-import './external-wiki-config.js';
-import './recall-state-view.js';
-import './contradiction-config.js';
-import './graph-path-scoring-config.js';
-import './background-generation-config.js';
-import './deep-recall-config.js';
-import './recall-navigation-config.js';
-import './recall-recognition-tier.js';
-import './causal-trajectory.js';
-import './objective-state.js';
-import './active-context-config.js';
-import './local-llm-config.js';
-import './semantic-merge-config.js';
-import './types-continuity.js';
-
-interface RecallTimingRecord {
+import type { PluginConfig } from "./types.js";
+export interface RecallTimingRecord {
     readonly timestamp: string;
     readonly namespace: string;
     readonly recallPlan: string;
     readonly queryPolicy: string;
     readonly timingsMs: Readonly<Record<string, number>>;
 }
-interface RecallTimingStatus {
+export interface RecallTimingStatus {
     readonly generatedAt: string;
     readonly processStartedAt: string;
     readonly capacity: number;
@@ -38,11 +20,10 @@ interface RecallTimingStatus {
  * wait. `queueWaitMs` 0/undefined/non-finite omits the phase so recall-timings
  * stays byte-identical to the uncontended pre-#1906 path.
  */
-declare function foldQueueWaitTiming(queueWaitMs?: number): Record<string, string>;
-declare function recordRecallTiming(config: PluginConfig, input: Record<string, unknown>): void;
-declare function resolveRecallTimingsOperatorPrincipal(config: PluginConfig, transportPrincipal?: string): string | undefined;
-declare function isRecallTimingsOperator(config: PluginConfig, authenticatedPrincipal?: string, transportPrincipal?: string): boolean;
-declare function getRecallTimings(config: PluginConfig): RecallTimingRecord[];
-declare function getRecallTimingStatus(config: PluginConfig): RecallTimingStatus;
-
-export { type RecallTimingRecord, type RecallTimingStatus, foldQueueWaitTiming, getRecallTimingStatus, getRecallTimings, isRecallTimingsOperator, recordRecallTiming, resolveRecallTimingsOperatorPrincipal };
+export declare function foldQueueWaitTiming(queueWaitMs?: number): Record<string, string>;
+export declare function recordRecallTiming(config: PluginConfig, input: Record<string, unknown>): void;
+export declare function resolveRecallTimingsOperatorPrincipal(config: PluginConfig, transportPrincipal?: string): string | undefined;
+export declare function isRecallTimingsOperator(config: PluginConfig, authenticatedPrincipal?: string, transportPrincipal?: string): boolean;
+export declare function getRecallTimings(config: PluginConfig): RecallTimingRecord[];
+export declare function getRecallTimingStatus(config: PluginConfig): RecallTimingStatus;
+//# sourceMappingURL=recall-timings.d.ts.map

package/dist/recall-timings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall-timings.d.ts","sourceRoot":"","sources":["../src/recall-timings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,kBAAkB,EAAE,CAAC;CACxC;AAwED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMhF;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI,CAKN;AAED,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,YAAY,EACpB,kBAAkB,CAAC,EAAE,MAAM,GAC1B,MAAM,GAAG,SAAS,CAIpB;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,YAAY,EACpB,sBAAsB,CAAC,EAAE,MAAM,EAC/B,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAUT;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,kBAAkB,EAAE,CAM3E;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,kBAAkB,CAU9E"}

package/dist/recall-tokenization.d.ts

@@ -1,10 +1,9 @@
-interface NormalizeRecallTokenOptions {
+export interface NormalizeRecallTokenOptions {
     minTokenLength?: number;
 }
-declare function isUnsegmentableRecallChar(char: string): boolean;
-declare function expandUnsegmentableRecallNGrams(segment: string): string[];
-declare function normalizeRecallTokenSet(value: string, extraStopWords?: string[], options?: NormalizeRecallTokenOptions): Set<string>;
-declare function normalizeRecallTokens(value: string, extraStopWords?: string[]): string[];
-declare function countRecallTokenOverlap(queryTokens: Set<string>, value: string | undefined, extraStopWords?: string[]): number;
-
-export { type NormalizeRecallTokenOptions, countRecallTokenOverlap, expandUnsegmentableRecallNGrams, isUnsegmentableRecallChar, normalizeRecallTokenSet, normalizeRecallTokens };
+export declare function isUnsegmentableRecallChar(char: string): boolean;
+export declare function expandUnsegmentableRecallNGrams(segment: string): string[];
+export declare function normalizeRecallTokenSet(value: string, extraStopWords?: string[], options?: NormalizeRecallTokenOptions): Set<string>;
+export declare function normalizeRecallTokens(value: string, extraStopWords?: string[]): string[];
+export declare function countRecallTokenOverlap(queryTokens: Set<string>, value: string | undefined, extraStopWords?: string[]): number;
+//# sourceMappingURL=recall-tokenization.d.ts.map

package/dist/recall-tokenization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall-tokenization.d.ts","sourceRoot":"","sources":["../src/recall-tokenization.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,2BAA2B;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAID,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAK/D;AAiBD,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAgBzE;AAkCD,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,cAAc,GAAE,MAAM,EAAO,EAC7B,OAAO,GAAE,2BAAgC,GACxC,GAAG,CAAC,MAAM,CAAC,CAoDb;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,GAAE,MAAM,EAAO,GAAG,MAAM,EAAE,CAE5F;AAED,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,EACxB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,cAAc,GAAE,MAAM,EAAO,GAC5B,MAAM,CAQR"}

package/dist/recall-why-cli.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Input validation for the `remnic why` command (issue #3033).
+ *
+ * Extracted from the CLI handlers so the validation paths are unit-testable
+ * without booting an orchestrator — the same split `recall-xray-cli.ts`
+ * uses. Every flag rejects a missing or unknown value with a listed-options
+ * error instead of silently defaulting (Review Prevention Checklist #1 /
+ * #39).
+ */
+import { type RecallWhyFormat } from "./recall-why-renderer.js";
+export interface ParsedWhyCliOptions {
+    format: RecallWhyFormat;
+    /** Memory id or substring to trace, or undefined when not specified. */
+    expect?: string;
+    /** Trimmed namespace, or undefined when not specified. */
+    namespace?: string;
+    /** Trimmed session key, or undefined when not specified. */
+    session?: string;
+    /** Trimmed, tilde-unexpanded output path, or undefined when stdout. */
+    outPath?: string;
+}
+export declare function parseWhyCliOptions(rawQuery: unknown, options: Record<string, unknown>): {
+    query: string;
+} & ParsedWhyCliOptions;
+//# sourceMappingURL=recall-why-cli.d.ts.map

package/dist/recall-why-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall-why-cli.d.ts","sourceRoot":"","sources":["../src/recall-why-cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEtF,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,eAAe,CAAC;IACxB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,mBAAmB,CAazC"}

package/dist/recall-why-cli.js

@@ -0,0 +1,9 @@
+import {
+  parseWhyCliOptions
+} from "./chunk-2KHIBLO5.js";
+import "./chunk-5HFVWYHL.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  parseWhyCliOptions
+};
+//# sourceMappingURL=recall-why-cli.js.map

package/dist/recall-why-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/recall-why-renderer.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Shared renderer for the recall-miss diagnosis (issue #3033).
+ *
+ * CLI, HTTP, and MCP all render the same {@link RecallWhyReport} through
+ * this module — never their own formatting (AGENTS.md rule 22, the same
+ * contract `recall-xray-renderer.ts` and `recall-explain-renderer.ts`
+ * hold).
+ */
+import type { RecallWhyReport } from "./recall-why.js";
+export type RecallWhyFormat = "json" | "markdown";
+export declare const RECALL_WHY_FORMATS: readonly RecallWhyFormat[];
+/**
+ * Validate and coerce a user-provided `--format` / `format` argument.
+ * Unknown values throw an error listing the valid options rather than
+ * silently defaulting (Review Prevention Checklist #1 / #39).
+ * `undefined` / `null` defaults to `"markdown"`.
+ */
+export declare function parseRecallWhyFormat(value: unknown): RecallWhyFormat;
+export declare function renderRecallWhy(report: RecallWhyReport, format: RecallWhyFormat): string;
+/** Deterministic JSON encoding of the report. */
+export declare function renderRecallWhyJson(report: RecallWhyReport): string;
+export declare function renderRecallWhyMarkdown(report: RecallWhyReport): string;
+/** One-line summary suited to a terminal or a chat reply. */
+export declare function summarizeRecallWhy(report: RecallWhyReport): string;
+//# sourceMappingURL=recall-why-renderer.d.ts.map

package/dist/recall-why-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall-why-renderer.d.ts","sourceRoot":"","sources":["../src/recall-why-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,UAAU,CAAC;AAElD,eAAO,MAAM,kBAAkB,EAAE,SAAS,eAAe,EAAkC,CAAC;AAE5F;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAQpE;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,eAAe,GAAG,MAAM,CAExF;AAED,iDAAiD;AACjD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAEnE;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CA2EvE;AAED,6DAA6D;AAC7D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAiBlE"}

package/dist/recall-why-renderer.js

@@ -0,0 +1,18 @@
+import {
+  RECALL_WHY_FORMATS,
+  parseRecallWhyFormat,
+  renderRecallWhy,
+  renderRecallWhyJson,
+  renderRecallWhyMarkdown,
+  summarizeRecallWhy
+} from "./chunk-5HFVWYHL.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  RECALL_WHY_FORMATS,
+  parseRecallWhyFormat,
+  renderRecallWhy,
+  renderRecallWhyJson,
+  renderRecallWhyMarkdown,
+  summarizeRecallWhy
+};
+//# sourceMappingURL=recall-why-renderer.js.map

package/dist/recall-why-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/recall-why-service.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Access-surface binding for the recall-miss diagnosis (issue #3033).
+ *
+ * `recall-why.ts` holds the stage logic and a port; this module binds that
+ * port to the live orchestrator. It lives beside `access-recall-surface.ts`
+ * rather than inside it because that file is at its file-size ratchet
+ * ceiling (AGENTS.md: extract the addition to a sibling module).
+ *
+ * Namespace scope is enforced BEFORE the recall fires and the expected-memory
+ * lookup is confined to namespaces the caller may read, so the diagnosis can
+ * never confirm the existence of a memory in a namespace the caller has no
+ * read access to. Read path and write path resolve through the same namespace
+ * layer (Review Prevention Checklist #30): the lookup consumes exactly the
+ * `recallNamespacesForPrincipal` set the recall itself is scoped by.
+ */
+import type { Orchestrator } from "./orchestrator.js";
+import { type RecallWhyReport } from "./recall-why.js";
+export interface RecallWhyRequest {
+    query: string;
+    /** Memory id or substring to trace through every stage. */
+    expect?: string;
+    sessionKey?: string;
+    namespace?: string;
+    authenticatedPrincipal?: string;
+    sourceConnector?: string;
+    abortSignal?: AbortSignal;
+}
+export interface RecallWhyResponse {
+    /** False when the namespace ACL denied the diagnosis. */
+    reportFound: boolean;
+    report?: RecallWhyReport;
+    /** One-line verdict, for agent callers that do not parse the full report. */
+    summary?: string;
+}
+export interface RecallWhyServiceDeps {
+    readonly orchestrator: Orchestrator;
+    /** The surface's shared namespace resolver. */
+    resolveNamespace(namespace?: string): string;
+}
+/**
+ * Run the recall-miss diagnosis for one request.
+ *
+ * Throws {@link RecallWhyInputError} for caller-input faults so surfaces can
+ * map them to a 400; backend faults are reported inside the report as
+ * `backend_unavailable` rather than thrown, because an outage is a diagnosis
+ * result, not a diagnosis failure.
+ */
+export declare function runRecallWhy(deps: RecallWhyServiceDeps, request: RecallWhyRequest): Promise<RecallWhyResponse>;
+//# sourceMappingURL=recall-why-service.d.ts.map

package/dist/recall-why-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall-why-service.d.ts","sourceRoot":"","sources":["../src/recall-why-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAKL,KAAK,eAAe,EACrB,MAAM,iBAAiB,CAAC;AAyBzB,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,+CAA+C;IAC/C,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9C;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAoFpH"}

package/dist/recall-why-service.js

@@ -0,0 +1,46 @@
+import {
+  runRecallWhy
+} from "./chunk-IRGQYQQ7.js";
+import "./chunk-5HFVWYHL.js";
+import "./chunk-TYP7GYRI.js";
+import "./chunk-U3NBO4IX.js";
+import "./chunk-52VL6LCY.js";
+import "./chunk-CSAKJVXW.js";
+import "./chunk-K2XUWZBM.js";
+import "./chunk-OD4FM2U7.js";
+import "./chunk-TBBDFYXW.js";
+import "./chunk-JV3C2MNQ.js";
+import "./chunk-PCEYGOSL.js";
+import "./chunk-SCU65EZI.js";
+import "./chunk-KG2OOAFF.js";
+import "./chunk-U2VDCFXW.js";
+import "./chunk-ZLQ37WJX.js";
+import "./chunk-IUM3VSHI.js";
+import "./chunk-C64XATK7.js";
+import "./chunk-42JKGUFJ.js";
+import "./chunk-PQVCH2AE.js";
+import "./chunk-353C5UNV.js";
+import "./chunk-AW4QUFQF.js";
+import "./chunk-DXODYQ7J.js";
+import "./chunk-42DJ235G.js";
+import "./chunk-CTVWELNK.js";
+import "./chunk-RGMVMVMF.js";
+import "./chunk-PWPIERBM.js";
+import "./chunk-JDSVLVCG.js";
+import "./chunk-5GKPFL3S.js";
+import "./chunk-JAKIDQB2.js";
+import "./chunk-P7FMDTKL.js";
+import "./chunk-MRV7VSQK.js";
+import "./chunk-PCXDUHQH.js";
+import "./chunk-VUFL7X3H.js";
+import "./chunk-JUOZ62Y7.js";
+import "./chunk-ZEFVK7XC.js";
+import "./chunk-P2QRMMVQ.js";
+import "./chunk-BTTPKDIL.js";
+import "./chunk-VS2IYZRU.js";
+import "./chunk-3WCASNQZ.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  runRecallWhy
+};
+//# sourceMappingURL=recall-why-service.js.map

package/dist/recall-why-service.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}