@remnic/core 9.69.56 → 9.69.58

package/dist/extraction-judge-training.d.ts

@@ -1,29 +1,3 @@
-import { JudgeVerdictKind } from './extraction-judge.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 './local-llm-BkkEK9rn.js';
-import './model-registry.js';
-import './fallback-llm.js';
-import './fallback-llm-codex-subscription.js';
-import './cli-fallback.js';
-import './resolve-provider-secret.js';
-
 /**
  * Extraction Judge Training Data Shim (issue #562, PR 4).
  *
@@ -45,13 +19,13 @@ import './resolve-provider-secret.js';
  * home directory rather than the shared memory directory so it is never
  * committed, sync'd, or bundled into exports.
  */
-
+import type { JudgeVerdictKind } from "./extraction-judge.js";
 /**
  * Persisted training row. Intentionally minimal: just the signal needed
  * to train a judge replacement policy. Schema version is tagged so future
  * readers can migrate older rows.
  */
-interface JudgeTrainingPair {
+export interface JudgeTrainingPair {
     version: 1;
     ts: string;
     candidateText: string;
@@ -70,7 +44,7 @@ interface JudgeTrainingPair {
      */
     groundTruthLabel?: JudgeVerdictKind;
 }
-interface JudgeTrainingOptions {
+export interface JudgeTrainingOptions {
     enabled: boolean;
     /**
      * Override for the output directory. Defaults to
@@ -78,20 +52,20 @@ interface JudgeTrainingOptions {
      */
     directory?: string;
 }
-declare function resolveTrainingDir(options: JudgeTrainingOptions): string;
-declare function trainingFilePathFor(directory: string, iso: string): string;
+export declare function resolveTrainingDir(options: JudgeTrainingOptions): string;
+export declare function trainingFilePathFor(directory: string, iso: string): string;
 /**
  * Append a single training row. Fails open — write errors are logged at
  * debug level and swallowed, same policy as the telemetry emitter.
  * No-op when `options.enabled` is false.
  */
-declare function recordJudgeTrainingPair(row: JudgeTrainingPair, options: JudgeTrainingOptions): Promise<void>;
+export declare function recordJudgeTrainingPair(row: JudgeTrainingPair, options: JudgeTrainingOptions): Promise<void>;
 /**
  * Read all training rows from the configured directory. Returns an empty
  * array when the directory is missing. Malformed lines are skipped and
  * counted in the returned `malformed` tally.
  */
-declare function readJudgeTrainingPairs(options: Pick<JudgeTrainingOptions, "directory">): Promise<{
+export declare function readJudgeTrainingPairs(options: Pick<JudgeTrainingOptions, "directory">): Promise<{
     rows: JudgeTrainingPair[];
     malformed: number;
 }>;
@@ -100,6 +74,5 @@ declare function readJudgeTrainingPairs(options: Pick<JudgeTrainingOptions, "dir
  * unknown `verdictKind` string is treated as malformed (strict training
  * signal — we do not want to admit unlabelled gibberish into a trainer).
  */
-declare function isValidTrainingPair(value: unknown): value is JudgeTrainingPair;
-
-export { type JudgeTrainingOptions, type JudgeTrainingPair, isValidTrainingPair, readJudgeTrainingPairs, recordJudgeTrainingPair, resolveTrainingDir, trainingFilePathFor };
+export declare function isValidTrainingPair(value: unknown): value is JudgeTrainingPair;
+//# sourceMappingURL=extraction-judge-training.d.ts.map

package/dist/extraction-judge-training.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction-judge-training.d.ts","sourceRoot":"","sources":["../src/extraction-judge-training.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,CAAC,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,WAAW,EAAE,gBAAgB,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAsBD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAOxE;AAcD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1E;AAOD;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,iBAAiB,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBlH;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,IAAI,CAAC,oBAAoB,EAAE,WAAW,CAAC,GAC/C,OAAO,CAAC;IAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAuE3D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CA4B9E"}

package/dist/extraction-judge.d.ts

@@ -1,28 +1,3 @@
-import { a2 as ImportanceLevel, P as PluginConfig } from './types-Du6VdoAg.js';
-import { L as LocalLlmClient } from './local-llm-BkkEK9rn.js';
-import { FallbackLlmClient } from './fallback-llm.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 './model-registry.js';
-import './fallback-llm-codex-subscription.js';
-import './cli-fallback.js';
-import './resolve-provider-secret.js';
-
 /**
  * Extraction Judge — LLM-as-judge fact-worthiness gate (issue #376).
  *
@@ -37,8 +12,10 @@ import './resolve-provider-secret.js';
  *   - Content-hash caching avoids redundant LLM calls.
  *   - Performance budget: <= 1.5s per batch.
  */
-
-interface JudgeCandidate {
+import type { PluginConfig, ImportanceLevel } from "./types.js";
+import type { LocalLlmClient } from "./local-llm.js";
+import { type FallbackLlmClient } from "./fallback-llm.js";
+export interface JudgeCandidate {
     text: string;
     category: string;
     confidence: number;
@@ -58,7 +35,7 @@ interface JudgeCandidate {
  * defer-capable prompt, buffer re-routing, telemetry, and GRPO data
  * collection are landing in PRs 2, 3, and 4 respectively.
  */
-type JudgeVerdictKind = "accept" | "reject" | "defer";
+export type JudgeVerdictKind = "accept" | "reject" | "defer";
 /**
  * Judge verdict shape.
  *
@@ -69,7 +46,7 @@ type JudgeVerdictKind = "accept" | "reject" | "defer";
  * gracefully fall back to the boolean when `kind` is missing, and ignore
  * unknown future `kind` values rather than crashing.
  */
-interface JudgeVerdict {
+export interface JudgeVerdict {
     /**
      * True iff the fact should be persisted. For `"defer"` verdicts this is
      * `false` — a deferred fact is not (yet) persisted, so callers that only
@@ -95,13 +72,13 @@ interface JudgeVerdict {
  *   future cache entry loaded by an older build), fall back to `durable`
  *   so we never crash on unknown strings.
  */
-declare function getVerdictKind(verdict: JudgeVerdict): JudgeVerdictKind;
+export declare function getVerdictKind(verdict: JudgeVerdict): JudgeVerdictKind;
 /**
  * Type guard: returns `true` only for verdicts that should be persisted.
  * Treats both `"reject"` and `"defer"` as "not durable" — defer means the
  * caller should re-evaluate later, not write now.
  */
-declare function isDurableVerdict(verdict: JudgeVerdict): boolean;
+export declare function isDurableVerdict(verdict: JudgeVerdict): boolean;
 /**
  * Validate a cache entry loaded from persistence / another process.
  *
@@ -116,7 +93,7 @@ declare function isDurableVerdict(verdict: JudgeVerdict): boolean;
  * drops unknown `kind` strings before validation so a newer build's
  * cache entry still loads instead of being rejected.
  */
-declare function isValidCachedVerdict(value: unknown): value is JudgeVerdict;
+export declare function isValidCachedVerdict(value: unknown): value is JudgeVerdict;
 /**
  * Forward-compatible cache-entry loader.
  *
@@ -126,8 +103,8 @@ declare function isValidCachedVerdict(value: unknown): value is JudgeVerdict;
  * Returns the sanitised verdict, or `null` when the entry is structurally
  * unusable.
  */
-declare function normalizeCachedVerdict(value: unknown): JudgeVerdict | null;
-interface JudgeBatchResult {
+export declare function normalizeCachedVerdict(value: unknown): JudgeVerdict | null;
+export interface JudgeBatchResult {
     verdicts: Map<number, JudgeVerdict>;
     /** Number of verdicts served from cache. */
     cached: number;
@@ -156,7 +133,7 @@ interface JudgeBatchResult {
  * directly to filesystem I/O. One event is emitted for every resolved
  * verdict, including auto-approved and cache-hit paths.
  */
-interface JudgeVerdictObservation {
+export interface JudgeVerdictObservation {
     verdict: JudgeVerdict;
     /** The original `JudgeCandidate` passed in (same reference). */
     candidate: JudgeCandidate;
@@ -175,12 +152,12 @@ interface JudgeVerdictObservation {
      */
     elapsedMs: number;
 }
-declare const JUDGE_SYSTEM_PROMPT = "You are a memory curator evaluating whether extracted facts are **durable** \u2014 worth storing for long-term recall across sessions.\n\nA fact is **durable** if it will still be useful 30+ days from now and is relevant across multiple sessions, not just the current task.\n\nReturn one of three verdicts per candidate:\n\nACCEPT \u2014 the fact is durable, persist it:\n- Personal preferences, identities, or relationships\n- Decisions with rationale that affect future work\n- Corrections to previously held beliefs\n- Principles, rules, or constraints the user wants respected\n- Stable facts about projects, tools, or workflows\n- Commitments, deadlines, or obligations\n\nREJECT \u2014 the fact is not durable, drop it:\n- Transient task details (\"currently debugging line 42\")\n- Ephemeral state (\"the build is running now\")\n- Routine operations (\"ran npm install\")\n- Conversational filler or acknowledgements\n- Information that will be stale within hours\n- Step-by-step instructions for a one-time task\n\nDEFER \u2014 the fact MIGHT be durable but needs more context to decide. The candidate will be re-evaluated on a later extraction pass with fresh context; if it cannot be resolved within a small number of re-evaluations it will be rejected.\n- Ambiguous referents (\"he said they'd follow up on it\")\n- Partial or in-progress statements that might become durable once completed\n- Future-tense commitments whose subject or timeline is unclear\n- Facts whose durability hinges on context not present in the candidate text\n\nDo NOT use defer as a soft reject. Reject facts you are confident are transient. Only defer when another turn of context would genuinely change the verdict.\n\nReturn a JSON array of objects with these fields:\n- index: number (the candidate index)\n- kind: string \u2014 one of \"accept\", \"reject\", \"defer\"\n- reason: string (brief explanation, under 80 characters)\n\nYou may also include durable (boolean) for backwards compatibility: true for accept, false for reject or defer. If kind is omitted, durable determines the verdict.\n\nRules:\n1. Return exactly one verdict per input candidate, matched by index.\n2. When in doubt between accept and reject, lean toward accept \u2014 false negatives (losing a useful fact) are worse than false positives (keeping a marginal one).\n3. Use defer only when another turn of context would genuinely change the verdict.\n4. Output valid JSON only. No markdown fences, no commentary.\n5. Output language: write facts, profile updates, entity names and aliases, tags, questions, and any rewritten or merged memory content in the source language of the conversation or input memories. Never translate into English or another language unless the user explicitly asked for a translation.\n\nExample output:\n[{\"index\": 0, \"kind\": \"accept\", \"durable\": true, \"reason\": \"Stable personal preference\"}, {\"index\": 1, \"kind\": \"reject\", \"durable\": false, \"reason\": \"Ephemeral build status\"}, {\"index\": 2, \"kind\": \"defer\", \"durable\": false, \"reason\": \"Ambiguous pronoun\"}]";
+export declare const JUDGE_SYSTEM_PROMPT = "You are a memory curator evaluating whether extracted facts are **durable** \u2014 worth storing for long-term recall across sessions.\n\nA fact is **durable** if it will still be useful 30+ days from now and is relevant across multiple sessions, not just the current task.\n\nReturn one of three verdicts per candidate:\n\nACCEPT \u2014 the fact is durable, persist it:\n- Personal preferences, identities, or relationships\n- Decisions with rationale that affect future work\n- Corrections to previously held beliefs\n- Principles, rules, or constraints the user wants respected\n- Stable facts about projects, tools, or workflows\n- Commitments, deadlines, or obligations\n\nREJECT \u2014 the fact is not durable, drop it:\n- Transient task details (\"currently debugging line 42\")\n- Ephemeral state (\"the build is running now\")\n- Routine operations (\"ran npm install\")\n- Conversational filler or acknowledgements\n- Information that will be stale within hours\n- Step-by-step instructions for a one-time task\n\nDEFER \u2014 the fact MIGHT be durable but needs more context to decide. The candidate will be re-evaluated on a later extraction pass with fresh context; if it cannot be resolved within a small number of re-evaluations it will be rejected.\n- Ambiguous referents (\"he said they'd follow up on it\")\n- Partial or in-progress statements that might become durable once completed\n- Future-tense commitments whose subject or timeline is unclear\n- Facts whose durability hinges on context not present in the candidate text\n\nDo NOT use defer as a soft reject. Reject facts you are confident are transient. Only defer when another turn of context would genuinely change the verdict.\n\nReturn a JSON array of objects with these fields:\n- index: number (the candidate index)\n- kind: string \u2014 one of \"accept\", \"reject\", \"defer\"\n- reason: string (brief explanation, under 80 characters)\n\nYou may also include durable (boolean) for backwards compatibility: true for accept, false for reject or defer. If kind is omitted, durable determines the verdict.\n\nRules:\n1. Return exactly one verdict per input candidate, matched by index.\n2. When in doubt between accept and reject, lean toward accept \u2014 false negatives (losing a useful fact) are worse than false positives (keeping a marginal one).\n3. Use defer only when another turn of context would genuinely change the verdict.\n4. Output valid JSON only. No markdown fences, no commentary.\n5. Output language: write facts, profile updates, entity names and aliases, tags, questions, and any rewritten or merged memory content in the source language of the conversation or input memories. Never translate into English or another language unless the user explicitly asked for a translation.\n\nExample output:\n[{\"index\": 0, \"kind\": \"accept\", \"durable\": true, \"reason\": \"Stable personal preference\"}, {\"index\": 1, \"kind\": \"reject\", \"durable\": false, \"reason\": \"Ephemeral build status\"}, {\"index\": 2, \"kind\": \"defer\", \"durable\": false, \"reason\": \"Ambiguous pronoun\"}]";
 /**
  * Deterministic gate for extracted `procedure` memories: ≥2 steps with non-empty
  * intents and explicit trigger wording in title and/or steps.
  */
-declare function validateProcedureExtraction(input: {
+export declare function validateProcedureExtraction(input: {
     content: string;
     procedureSteps?: unknown;
 }): JudgeVerdict;
@@ -192,18 +169,17 @@ declare function validateProcedureExtraction(input: {
  * checked against an in-memory content-hash cache, and sent to the LLM
  * for verdict.
  */
-declare function judgeFactDurability(candidates: JudgeCandidate[], config: PluginConfig, localLlm: LocalLlmClient | null, fallbackLlm: FallbackLlmClient | null, cache?: Map<string, JudgeVerdict>, deferCounts?: Map<string, number>, onVerdict?: (observation: JudgeVerdictObservation) => void): Promise<JudgeBatchResult>;
+export declare function judgeFactDurability(candidates: JudgeCandidate[], config: PluginConfig, localLlm: LocalLlmClient | null, fallbackLlm: FallbackLlmClient | null, cache?: Map<string, JudgeVerdict>, deferCounts?: Map<string, number>, onVerdict?: (observation: JudgeVerdictObservation) => void): Promise<JudgeBatchResult>;
 /** Clear the in-memory default verdict cache. Primarily for tests. */
-declare function clearVerdictCache(): void;
+export declare function clearVerdictCache(): void;
 /** Return the current default verdict cache size. Primarily for tests. */
-declare function verdictCacheSize(): number;
+export declare function verdictCacheSize(): number;
 /** Create a new per-instance verdict cache. Orchestrators should hold one. */
-declare function createVerdictCache(): Map<string, JudgeVerdict>;
+export declare function createVerdictCache(): Map<string, JudgeVerdict>;
 /**
  * Create a new per-instance defer-counter map. Orchestrators should hold one
  * alongside their verdict cache so defer counts survive across extraction
  * passes within a single orchestrator but do not leak across orchestrators.
  */
-declare function createDeferCountMap(): Map<string, number>;
-
-export { JUDGE_SYSTEM_PROMPT, type JudgeBatchResult, type JudgeCandidate, type JudgeVerdict, type JudgeVerdictKind, type JudgeVerdictObservation, clearVerdictCache, createDeferCountMap, createVerdictCache, getVerdictKind, isDurableVerdict, isValidCachedVerdict, judgeFactDurability, normalizeCachedVerdict, validateProcedureExtraction, verdictCacheSize };
+export declare function createDeferCountMap(): Map<string, number>;
+//# sourceMappingURL=extraction-judge.d.ts.map

package/dist/extraction-judge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction-judge.d.ts","sourceRoot":"","sources":["../src/extraction-judge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,KAAK,iBAAiB,EAA2B,MAAM,mBAAmB,CAAC;AASpF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,4DAA4D;IAC5D,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE7D;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;OAKG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,gBAAgB,CAMtE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAE/D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAW1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAgB1E;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACpC,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,YAAY,CAAC;IACtB,gEAAgE;IAChE,SAAS,EAAE,cAAc,CAAC;IAC1B,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,MAAM,EAAE,cAAc,GAAG,OAAO,GAAG,KAAK,GAAG,kBAAkB,GAAG,WAAW,CAAC;IAC5E;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,eAAO,MAAM,mBAAmB,0hGA6CgO,CAAC;AAqEjQ;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,GAAG,YAAY,CAUf;AAMD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,cAAc,EAAE,EAC5B,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,cAAc,GAAG,IAAI,EAC/B,WAAW,EAAE,iBAAiB,GAAG,IAAI,EACrC,KAAK,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EACjC,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,SAAS,CAAC,EAAE,CAAC,WAAW,EAAE,uBAAuB,KAAK,IAAI,GACzD,OAAO,CAAC,gBAAgB,CAAC,CA8Q3B;AA0LD,sEAAsE;AACtE,wBAAgB,iBAAiB,IAAI,IAAI,CAGxC;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,IAAI,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAEzD"}

package/dist/extraction-liveness.d.ts

@@ -1,18 +1,161 @@
-import './operator-doctor-types.js';
-export { l as ExtractionBufferSnapshot, aJ as ExtractionBufferSource, dg as ExtractionLivenessConfig, y as ExtractionLivenessStatus, dh as ExtractionLivenessWarnThrottle, di as ExtractionRootStats, dj as ExtractionWatermarkOrStorage, dk as ExtractionWatermarkRead, dl as coerceExtractionWatermark, dm as computeExtractionLivenessStatus, dn as evaluateExtractionLiveness, dp as formatAgeMs, dq as gatherExtractionLivenessStatus, dr as parseExtractionLivenessConfig, ds as renderExtractionLivenessStats, dt as resolveExtractionLivenessConfig, aL as summarizeExtractionLiveness } from './types-Du6VdoAg.js';
-import './message-parts/index.js';
-import './bounded-jsonl-state.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 type { OperatorDoctorCheck } from "./operator-doctor-types.js";
+import type { PluginConfig } from "./types.js";
+export interface ExtractionLivenessConfig {
+    /** Master gate. When false, liveness is never reported degraded. Default true. */
+    enabled: boolean;
+    /**
+     * How stale the last-successful-extraction watermark may get (ms) before a
+     * non-empty buffer flags the pipeline degraded. Default 24h.
+     */
+    staleWindowMs: number;
+}
+/**
+ * A read-only snapshot of buffered, not-yet-extracted work. Structurally
+ * satisfied by `SmartBuffer.getBufferSnapshot()` so callers can pass the live
+ * buffer without this module depending on the buffer implementation.
+ */
+export interface ExtractionBufferSnapshot {
+    bufferedSessionCount: number;
+    pendingTurnCount: number;
+    oldestTurnTimestamp: string | null;
+    /**
+     * Set by the liveness reader (never by `SmartBuffer`) when the buffer exists
+     * but its snapshot read threw. An unreadable buffer is a pipeline fault, not
+     * an empty queue (§22): it degrades the pipeline with a distinct reason
+     * instead of masquerading as a zero-backlog (healthy) snapshot.
+     */
+    readFailed?: boolean;
+    /** Read-failure detail, surfaced in the degraded reason when `readFailed`. */
+    readError?: string;
+}
+export interface ExtractionBufferSource {
+    getBufferSnapshot(): Promise<ExtractionBufferSnapshot>;
+}
+export interface ExtractionRootStats {
+    extractionCount?: number;
+    lastConsolidationAt?: string | null;
+}
+export interface ExtractionWatermarkRead {
+    lastExtractionAt: string | null;
+    readFailed: boolean;
+    readError?: string;
+    pending?: boolean;
+    rootStats?: ExtractionRootStats;
+}
+export type ExtractionWatermarkOrStorage = ExtractionWatermarkRead | {
+    readMetadata(): Promise<{
+        lastExtractionAt?: string | null;
+    } | null>;
+} | {
+    loadMeta(): Promise<{
+        lastExtractionAt?: string | null;
+    }>;
+};
+export declare function coerceExtractionWatermark(watermark: ExtractionWatermarkOrStorage): Promise<ExtractionWatermarkRead>;
+/**
+ * The daemon-scoped liveness payload surfaced on `/health.extraction` and in
+ * doctor/stats details. Its watermark is the maximum successful extraction
+ * across every distinct namespace store, matching the daemon-wide buffer scope.
+ */
+export interface ExtractionLivenessStatus {
+    lastExtractionAt: string | null;
+    bufferedSessionCount: number;
+    pendingTurnCount: number;
+    oldestBufferedTurnAgeMs: number | null;
+    degraded: boolean;
+    degradedReason: string | null;
+    watermarkPending?: boolean;
+    watermarkScope: "aggregate";
+}
+interface ExtractionLivenessOrchestratorLike {
+    config: Pick<PluginConfig, "extractionLiveness">;
+    buffer?: ExtractionBufferSource;
+}
+/**
+ * Parse the `extractionLiveness` config block. Follows the nested-block shape
+ * validation used elsewhere in `config.ts` and coerces string booleans (§24:
+ * CLI/JSON deliver `"false"`/`"0"` as strings, which must read as falsy).
+ */
+export declare function parseExtractionLivenessConfig(cfg: Record<string, unknown>): ExtractionLivenessConfig;
+/** Compact human-readable duration ("3d", "5h", "12m", "45s") for logs and CLI output. */
+export declare function formatAgeMs(ms: number): string;
+/**
+ * Pure liveness verdict. Degraded when the feature is enabled AND any of: the
+ * last-extraction watermark could not be READ (a storage fault, §22), the buffer
+ * read failed (a pipeline fault, §22), or the buffer is non-empty and the
+ * watermark is absent or stale. Each cause yields a DISTINCT reason so an
+ * operator can tell a meta-read failure from a buffer-read failure from a
+ * pipeline that has genuinely never extracted.
+ *
+ * Staleness uses a half-open freshness window (§23): an extraction is fresh
+ * while its age is in `[0, staleWindowMs)`, so an age of EXACTLY `staleWindowMs`
+ * is stale (the upper bound on "fresh" is exclusive). A null/unparsable watermark
+ * means "never succeeded" and is treated as stale — as is a FUTURE watermark (a
+ * clock-skewed or corrupt timestamp ahead of now must not read as a fresh
+ * extraction and hide a real backlog stall).
+ */
+export declare function evaluateExtractionLiveness(input: {
+    config: ExtractionLivenessConfig;
+    lastExtractionAt: string | null;
+    snapshot: ExtractionBufferSnapshot;
+    nowMs: number;
+    metaReadFailed?: boolean;
+    metaReadError?: string;
+    watermarkPending?: boolean;
+}): ExtractionLivenessStatus;
+/**
+ * Gather the liveness status from an aggregate watermark read and an optional
+ * buffer. A read failure on either side is surfaced as a degraded status with a
+ * distinct reason rather than swallowed into a healthy-looking verdict.
+ */
+export declare function gatherExtractionLivenessStatus(input: {
+    config: ExtractionLivenessConfig;
+    watermark: ExtractionWatermarkOrStorage;
+    buffer: ExtractionBufferSource | undefined;
+    nowMs: number;
+}): Promise<ExtractionLivenessStatus>;
+/**
+ * Aggregated-WARN throttle (issue #2151): emit at most ONE warning per
+ * staleness window while degraded — not one line per failed extraction attempt.
+ * State is instance-scoped (held by the owning service), never a module global
+ * (§5), so multiple service instances throttle independently.
+ */
+export declare class ExtractionLivenessWarnThrottle {
+    private lastWarnAtMs;
+    /** Warn if degraded and outside the throttle window; returns whether a WARN was emitted. */
+    maybeWarn(status: ExtractionLivenessStatus, staleWindowMs: number, nowMs: number): boolean;
+}
+/**
+ * Normalize the `extractionLiveness` block at the read boundary. `parseConfig`
+ * always populates it, but a host adapter, an older persisted config, or a
+ * hand-built `PluginConfig` can hand us an absent, partial, or loosely-typed
+ * block - and every liveness surface (/health, doctor, stats) must degrade to
+ * the documented default (enabled, 24h window) rather than throw. Both fields
+ * are coerced with the same rules as `parseExtractionLivenessConfig` (§24:
+ * `"false"`/`"0"` read as falsy; a numeric string like `"5000"` parses), except a
+ * present but non-integer or non-positive `staleWindowMs` falls back to the
+ * default here rather than throwing.
+ */
+export declare function resolveExtractionLivenessConfig(block: {
+    enabled?: unknown;
+    staleWindowMs?: unknown;
+} | undefined): ExtractionLivenessConfig;
+/**
+ * Compute the daemon-wide liveness status for the authenticated `/health`
+ * payload and emit the throttled aggregate warning.
+ */
+export declare function computeExtractionLivenessStatus(orchestrator: ExtractionLivenessOrchestratorLike, watermark: ExtractionWatermarkOrStorage, throttle?: ExtractionLivenessWarnThrottle, nowMs?: number): Promise<ExtractionLivenessStatus>;
+/**
+ * `remnic doctor` check for extraction-pipeline liveness. Status `warn` when
+ * degraded (with a remediation hint), `ok` otherwise.
+ */
+export declare function summarizeExtractionLiveness(config: Pick<PluginConfig, "extractionLiveness">, watermark: ExtractionWatermarkOrStorage, buffer?: ExtractionBufferSource, nowMs?: number): Promise<OperatorDoctorCheck>;
+/**
+ * Lines for `remnic stats`: the aggregate extraction watermark, root metadata
+ * counters, buffer backlog, and liveness verdict. Root counter failures render
+ * those counters unavailable; the injected aggregate read alone determines
+ * watermark liveness so stats cannot diverge from health and doctor.
+ */
+export declare function renderExtractionLivenessStats(orchestrator: ExtractionLivenessOrchestratorLike, watermark: ExtractionWatermarkRead, nowMs?: number): Promise<string[]>;
+export {};
+//# sourceMappingURL=extraction-liveness.d.ts.map

package/dist/extraction-liveness.d.ts.map

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

package/dist/extraction-normalization.d.ts

@@ -1,26 +1,7 @@
-import { ax as ExtractedFact } 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';
-
-declare function isPlainRecord(value: unknown): value is Record<string, unknown>;
-declare function containsExtractionPlaceholder(value: unknown): boolean;
-declare function extractionText(value: unknown): string | undefined;
-declare function extractionAttributes(value: unknown): Record<string, string> | undefined;
-declare function extractionCueAnchors(value: unknown): NonNullable<ExtractedFact["cueAnchors"]> | undefined;
-
-export { containsExtractionPlaceholder, extractionAttributes, extractionCueAnchors, extractionText, isPlainRecord };
+import type { ExtractedFact } from "./types.js";
+export declare function isPlainRecord(value: unknown): value is Record<string, unknown>;
+export declare function containsExtractionPlaceholder(value: unknown): boolean;
+export declare function extractionText(value: unknown): string | undefined;
+export declare function extractionAttributes(value: unknown): Record<string, string> | undefined;
+export declare function extractionCueAnchors(value: unknown): NonNullable<ExtractedFact["cueAnchors"]> | undefined;
+//# sourceMappingURL=extraction-normalization.d.ts.map

package/dist/extraction-normalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction-normalization.d.ts","sourceRoot":"","sources":["../src/extraction-normalization.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE9E;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAIrE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAIjE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAWvF;AAID,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,GAAG,SAAS,CAkCzG"}

package/dist/extraction-prompt.d.ts

@@ -1,22 +1,3 @@
-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';
-
 /**
  * Extraction prompt construction (issue #1995 sibling extraction).
  *
@@ -25,17 +6,17 @@ import './types-continuity.js';
  * so `extraction.ts` holds the pipeline and one module owns the text every
  * extraction path — local LLM, direct client, gateway fallback — sends.
  */
-
-declare const EXTRACTION_RESPONSE_SHAPE = "{\n  \"facts\": [{\n    \"category\": \"<category>\",\n    \"content\": \"<source-grounded statement>\",\n    \"confidence\": 0.0,\n    \"tags\": [\"<tag>\"],\n    \"entityRef\": \"<optional normalized-name>\",\n    \"cueAnchors\": [{\"type\": \"<anchor-type>\", \"value\": \"<entity-or-topic plus key aspect>\"}],\n    \"promptedByQuestion\": \"<optional source-grounded question>\",\n    \"quote\": \"<optional exact contiguous source span>\",\n    \"scope\": \"<optional project-or-global>\",\n    \"subject\": \"<optional user-or-agent>\",\n    \"structuredAttributes\": {\"<key>\": \"<value>\"},\n    \"procedureSteps\": [{\"order\": 1, \"intent\": \"<step>\"}, {\"order\": 2, \"intent\": \"<step>\"}],\n    \"reasoningTrace\": {\n      \"steps\": [{\"order\": 1, \"description\": \"<step>\"}, {\"order\": 2, \"description\": \"<step>\"}],\n      \"finalAnswer\": \"<answer>\",\n      \"observedOutcome\": \"<optional outcome>\"\n    },\n    \"eventTime\": \"<optional source temporal expression>\"\n  }],\n  \"entities\": [{\n    \"name\": \"<normalized-name>\",\n    \"type\": \"<entity-type>\",\n    \"facts\": [\"<source-grounded statement>\"],\n    \"promptedByQuestion\": \"<optional source-grounded question>\",\n    \"structuredSections\": [{\"key\": \"<section-key>\", \"title\": \"<section-title>\", \"facts\": [\"<source-grounded statement>\"]}]\n  }],\n  \"profileUpdates\": [\"<source-grounded profile update>\"],\n  \"questions\": [{\"question\": \"<source-grounded unresolved question>\", \"context\": \"<source-grounded context>\", \"priority\": 0.0}],\n  \"identityReflection\": \"<conversation-grounded agent reflection>\",\n  \"episodeTitle\": \"<six-to-eight word conversation segment title>\",\n  \"relationships\": [{\"source\": \"<normalized-name>\", \"target\": \"<normalized-name>\", \"label\": \"<source-grounded relationship>\"}]\n}";
-declare function extractionResponseShape(spanMode?: "off" | "shadow" | "on"): string;
-declare const EXTRACTION_RESPONSE_PLACEHOLDERS: Record<string, true>;
-declare const CUE_ANCHOR_PROMPT_INSTRUCTION = "- For each fact, emit at most 3 \"cueAnchors\".\n- Each cue anchor value must be a source-grounded search hook of at most 120 characters, in the form \"<main entity or topic> <key aspect>\".\n- Set each cue anchor type to entity, file, tool, outcome, constraint, or date.\n- Omit cue anchors when the conversation does not support a useful search hook.\n- Example: \"Alice booked Bistro Max for Mike's surprise party\" can use {\"type\":\"entity\",\"value\":\"Mike surprise party\"} and {\"type\":\"entity\",\"value\":\"Alice restaurant booking\"}.";
+import type { PluginConfig } from "./types.js";
+export declare const EXTRACTION_RESPONSE_SHAPE = "{\n  \"facts\": [{\n    \"category\": \"<category>\",\n    \"content\": \"<source-grounded statement>\",\n    \"confidence\": 0.0,\n    \"tags\": [\"<tag>\"],\n    \"entityRef\": \"<optional normalized-name>\",\n    \"cueAnchors\": [{\"type\": \"<anchor-type>\", \"value\": \"<entity-or-topic plus key aspect>\"}],\n    \"promptedByQuestion\": \"<optional source-grounded question>\",\n    \"quote\": \"<optional exact contiguous source span>\",\n    \"scope\": \"<optional project-or-global>\",\n    \"subject\": \"<optional user-or-agent>\",\n    \"structuredAttributes\": {\"<key>\": \"<value>\"},\n    \"procedureSteps\": [{\"order\": 1, \"intent\": \"<step>\"}, {\"order\": 2, \"intent\": \"<step>\"}],\n    \"reasoningTrace\": {\n      \"steps\": [{\"order\": 1, \"description\": \"<step>\"}, {\"order\": 2, \"description\": \"<step>\"}],\n      \"finalAnswer\": \"<answer>\",\n      \"observedOutcome\": \"<optional outcome>\"\n    },\n    \"eventTime\": \"<optional source temporal expression>\"\n  }],\n  \"entities\": [{\n    \"name\": \"<normalized-name>\",\n    \"type\": \"<entity-type>\",\n    \"facts\": [\"<source-grounded statement>\"],\n    \"promptedByQuestion\": \"<optional source-grounded question>\",\n    \"structuredSections\": [{\"key\": \"<section-key>\", \"title\": \"<section-title>\", \"facts\": [\"<source-grounded statement>\"]}]\n  }],\n  \"profileUpdates\": [\"<source-grounded profile update>\"],\n  \"questions\": [{\"question\": \"<source-grounded unresolved question>\", \"context\": \"<source-grounded context>\", \"priority\": 0.0}],\n  \"identityReflection\": \"<conversation-grounded agent reflection>\",\n  \"episodeTitle\": \"<six-to-eight word conversation segment title>\",\n  \"relationships\": [{\"source\": \"<normalized-name>\", \"target\": \"<normalized-name>\", \"label\": \"<source-grounded relationship>\"}]\n}";
+export declare function extractionResponseShape(spanMode?: "off" | "shadow" | "on"): string;
+export declare const EXTRACTION_RESPONSE_PLACEHOLDERS: Record<string, true>;
+export declare const CUE_ANCHOR_PROMPT_INSTRUCTION = "- For each fact, emit at most 3 \"cueAnchors\".\n- Each cue anchor value must be a source-grounded search hook of at most 120 characters, in the form \"<main entity or topic> <key aspect>\".\n- Set each cue anchor type to entity, file, tool, outcome, constraint, or date.\n- Omit cue anchors when the conversation does not support a useful search hook.\n- Example: \"Alice booked Bistro Max for Mike's surprise party\" can use {\"type\":\"entity\",\"value\":\"Mike surprise party\"} and {\"type\":\"entity\",\"value\":\"Alice restaurant booking\"}.";
 /**
  * Output-language policy (issue #2190). Every prompt that produces memory
  * content embeds this verbatim so non-English conversations are not silently
  * translated to English — translated memories fail later lexical recall.
  */
-declare const OUTPUT_LANGUAGE_POLICY = "Output language: write facts, profile updates, entity names and aliases, tags, questions, and any rewritten or merged memory content in the source language of the conversation or input memories. Never translate into English or another language unless the user explicitly asked for a translation.";
+export declare const OUTPUT_LANGUAGE_POLICY = "Output language: write facts, profile updates, entity names and aliases, tags, questions, and any rewritten or merged memory content in the source language of the conversation or input memories. Never translate into English or another language unless the user explicitly asked for a translation.";
 /**
  * Bi-temporal event-time extraction instruction (#1578 PR2). Emitted on
  * every extraction entry path when `temporal.biTemporal` is on so the LLM
@@ -44,7 +25,7 @@ declare const OUTPUT_LANGUAGE_POLICY = "Output language: write facts, profile up
  * wall-clock — so replay/import of old transcripts anchors correctly.
  * Returns an empty string when the gate is off (byte-identical prompt).
  */
-declare function eventTimePromptInstruction(config: PluginConfig): string;
+export declare function eventTimePromptInstruction(config: PluginConfig): string;
 /**
  * Span-mode extraction instructions (issue #2333 Phase B). Empty when the
  * mode is off (byte-identical prompt). The offset convention mirrors the
@@ -52,26 +33,25 @@ declare function eventTimePromptInstruction(config: PluginConfig): string;
  * message's own text (after the `[role] ` tag), [charStart, charEnd)
  * end-exclusive.
  */
-declare function spanModePromptSection(spanMode: "off" | "shadow" | "on"): string;
+export declare function spanModePromptSection(spanMode: "off" | "shadow" | "on"): string;
 /**
  * Build extraction instructions shared between local and cloud LLM.
  *
  * `ambientCapture` marks input from an always-on recorder, which may carry
  * speech the user never authored (issue #2294).
  */
-declare function buildExtractionInstructions(config: PluginConfig, existingEntities?: string[], ambientCapture?: boolean): string;
-declare const CONSOLIDATION_RESPONSE_SCHEMA = "{\n  \"items\": [\n    {\n      \"existingId\": \"id\",\n      \"action\": \"ADD\",\n      \"mergeWith\": \"optional-existing-id\",\n      \"updatedContent\": \"optional replacement content\",\n      \"reason\": \"brief reason for this action\"\n    }\n  ],\n  \"profileUpdates\": [\"optional profile update\"],\n  \"entityUpdates\": [{\"name\": \"person-jane-doe\", \"type\": \"person\", \"facts\": [\"Now leads the backend team\", \"Recently migrated the user service to TypeScript\"]}]\n}";
-declare const PROFILE_CONSOLIDATION_RESPONSE_SCHEMA = "{\n  \"consolidatedProfile\": \"# Behavioral Profile\\n\\n... (complete markdown)\",\n  \"removedCount\": 42,\n  \"summary\": \"brief summary of what was consolidated\"\n}";
+export declare function buildExtractionInstructions(config: PluginConfig, existingEntities?: string[], ambientCapture?: boolean): string;
+export declare const CONSOLIDATION_RESPONSE_SCHEMA = "{\n  \"items\": [\n    {\n      \"existingId\": \"id\",\n      \"action\": \"ADD\",\n      \"mergeWith\": \"optional-existing-id\",\n      \"updatedContent\": \"optional replacement content\",\n      \"reason\": \"brief reason for this action\"\n    }\n  ],\n  \"profileUpdates\": [\"optional profile update\"],\n  \"entityUpdates\": [{\"name\": \"person-jane-doe\", \"type\": \"person\", \"facts\": [\"Now leads the backend team\", \"Recently migrated the user service to TypeScript\"]}]\n}";
+export declare const PROFILE_CONSOLIDATION_RESPONSE_SCHEMA = "{\n  \"consolidatedProfile\": \"# Behavioral Profile\\n\\n... (complete markdown)\",\n  \"removedCount\": 42,\n  \"summary\": \"brief summary of what was consolidated\"\n}";
 /**
  * System prompt shared by every consolidation path (gateway, direct client,
  * local LLM). Owns the causal-rule clause and the output-language policy so
  * the three paths cannot drift (issue #2190).
  */
-declare function buildConsolidationSystemPrompt(config: PluginConfig): string;
+export declare function buildConsolidationSystemPrompt(config: PluginConfig): string;
 /**
  * System prompt shared by every profile-consolidation path (gateway, direct
  * client, local LLM). Owns the output-language policy (issue #2190).
  */
-declare function buildProfileConsolidationSystemPrompt(targetLines: number): string;
-
-export { CONSOLIDATION_RESPONSE_SCHEMA, CUE_ANCHOR_PROMPT_INSTRUCTION, EXTRACTION_RESPONSE_PLACEHOLDERS, EXTRACTION_RESPONSE_SHAPE, OUTPUT_LANGUAGE_POLICY, PROFILE_CONSOLIDATION_RESPONSE_SCHEMA, buildConsolidationSystemPrompt, buildExtractionInstructions, buildProfileConsolidationSystemPrompt, eventTimePromptInstruction, extractionResponseShape, spanModePromptSection };
+export declare function buildProfileConsolidationSystemPrompt(targetLines: number): string;
+//# sourceMappingURL=extraction-prompt.d.ts.map

package/dist/extraction-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction-prompt.d.ts","sourceRoot":"","sources":["../src/extraction-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,eAAO,MAAM,yBAAyB,60DAiCpC,CAAC;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,GAAE,KAAK,GAAG,QAAQ,GAAG,IAAY,GAAG,MAAM,CAOzF;AACD,eAAO,MAAM,gCAAgC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAM,CAAC;AAMzE,eAAO,MAAM,6BAA6B,yiBAIuI,CAAC;AAElL;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,4SAA4S,CAAC;AAEhV;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAIvE;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,IAAI,GAAG,MAAM,CAe/E;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,YAAY,EACpB,gBAAgB,CAAC,EAAE,MAAM,EAAE,EAC3B,cAAc,UAAQ,GACrB,MAAM,CAgGR;AAED,eAAO,MAAM,6BAA6B,gfAYxC,CAAC;AAEH,eAAO,MAAM,qCAAqC,gLAIhD,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAe3E;AAED;;;GAGG;AACH,wBAAgB,qCAAqC,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAajF"}

package/dist/extraction-redaction-rules.d.ts

@@ -2,12 +2,12 @@
  * Directory (relative to a namespace storage dir) where redaction rules live.
  * Kept in sync with `registerRedactionRuleFn` in correction-access-wiring.ts.
  */
-declare const REDACTION_RULES_SUBDIR: string;
+export declare const REDACTION_RULES_SUBDIR: string;
 /**
  * A compiled redaction rule. `pattern` is the original (validated) pattern;
  * `matcher` returns true when content should be withheld.
  */
-interface CompiledRedactionRule {
+export interface CompiledRedactionRule {
     pattern: string;
     matcher: (content: string) => boolean;
 }
@@ -17,17 +17,16 @@ interface CompiledRedactionRule {
  * anchored to search (global flag off — we only need a boolean). Compilation
  * failures fall back to literal substring so a bad pattern never throws here.
  */
-declare function compileRedactionPattern(pattern: string): CompiledRedactionRule;
+export declare function compileRedactionPattern(pattern: string): CompiledRedactionRule;
 /**
  * Load + compile every redaction rule persisted under a namespace's storage
  * dir. Returns an empty array when the directory is absent or unreadable
  * (fail-open — a missing or corrupt rules dir must never block extraction).
  */
-declare function loadRedactionRules(stateDir: string): Promise<CompiledRedactionRule[]>;
+export declare function loadRedactionRules(stateDir: string): Promise<CompiledRedactionRule[]>;
 /**
  * Test content against a set of compiled rules. Returns true if ANY rule
  * matches (the content should be withheld). An empty rule set never matches.
  */
-declare function contentMatchesRedactionRules(content: string, rules: readonly CompiledRedactionRule[]): boolean;
-
-export { type CompiledRedactionRule, REDACTION_RULES_SUBDIR, compileRedactionPattern, contentMatchesRedactionRules, loadRedactionRules };
+export declare function contentMatchesRedactionRules(content: string, rules: readonly CompiledRedactionRule[]): boolean;
+//# sourceMappingURL=extraction-redaction-rules.d.ts.map

package/dist/extraction-redaction-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction-redaction-rules.d.ts","sourceRoot":"","sources":["../src/extraction-redaction-rules.ts"],"names":[],"mappings":"AA2BA;;;GAGG;AACH,eAAO,MAAM,sBAAsB,QAAuD,CAAC;AAK3F;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;CACvC;AA0ED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAsB9E;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAmC3F;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,qBAAqB,EAAE,GACtC,OAAO,CAWT"}