@tenphi/akno-core 0.12.0 → 0.13.1

package/dist/write/retain-clock-repair.js

@@ -0,0 +1,175 @@
+import { z } from 'zod';
+import { hasUnretractedClauseEnd } from "../memory/clause-ending.js";
+// Each branch fits the existing 400-unit sentence cap without truncation or borrowed allowance.
+// eslint-disable-next-line no-control-regex -- Keep CR/LF/NUL visible to validation.
+const completeSentence = /^[^\r\n\u0000]*[.!]$/u;
+// Keep Unicode content mandatory locally; the provider rejects property escapes and lookaround.
+const sentence = (max) => z
+    .string()
+    .min(1)
+    .max(max)
+    .regex(completeSentence)
+    .refine((value) => /[\p{L}\p{N}]/u.test(value));
+export const clockRepairFields = {
+    proposition_and_nontemporal_scope: sentence(220),
+    source_clock_anchor_and_unknown_date: sentence(110),
+    unresolved_calendar_period: sentence(68),
+};
+export const excludedClockRepairFields = {
+    proposition_and_nontemporal_scope: sentence(195),
+    source_clock_anchor_and_unknown_date: sentence(90),
+    excluded_reference_clocks: sentence(60),
+    unresolved_calendar_period: sentence(52),
+};
+const fields = Object.keys(excludedClockRepairFields);
+export function clockRepairText(value) {
+    return fields.flatMap((key) => (value[key] === undefined ? [] : [value[key]])).join(' ');
+}
+export function normalizeClockRepairTransaction(value) {
+    if (!value || typeof value !== 'object' || !('repairs' in value) || !Array.isArray(value.repairs))
+        return value;
+    return {
+        ...value,
+        repairs: value.repairs.map((entry) => {
+            if (!entry || typeof entry !== 'object')
+                return entry;
+            const record = { ...entry };
+            for (const key of fields)
+                if (typeof record[key] === 'string')
+                    record[key] = record[key].replace(/^[ \t]+|[ \t]+$/gu, '').replace(/[ \t]+/gu, ' ');
+            return record;
+        }),
+    };
+}
+export function clockRepairLanguageProse(value) {
+    value = normalizeClockRepairTransaction(value);
+    if (!value || typeof value !== 'object' || !('repairs' in value) || !Array.isArray(value.repairs))
+        return [];
+    return value.repairs.flatMap((entry) => {
+        if (!entry || typeof entry !== 'object')
+            return [];
+        const record = entry;
+        return Object.keys(clockRepairFields).every((key) => typeof record[key] === 'string') &&
+            (record.excluded_reference_clocks === undefined || typeof record.excluded_reference_clocks === 'string')
+            ? [clockRepairText(record)]
+            : [];
+    });
+}
+/** Only a complete same-span source definition activates the narrow text repair. A draft, sibling
+ * or interpretation cannot supply one missing clock dimension. Unfamiliar syntax uses full repair. */
+export function sourceClockRepairWitness(frame) {
+    const definitions = [];
+    for (const period of ['day', 'week', 'month', 'year'])
+        for (const [deictic, direction] of [
+            ['next', 'after'],
+            ['last', 'before'],
+        ]) {
+            const label = `${deictic}[ \\t]+${period}`;
+            definitions.push({
+                pattern: new RegExp(String.raw `^[ \t]*(?<unknown>(?:The[ \t]+)?original[ \t]+record['’]s[ \t]+date[ \t]+is[ \t]+unknown)\.[ \t]+(?<anchor>(?:“${label}”|"${label}"|${label})[ \t]+means[ \t]+the[ \t]+${period}[ \t]+${direction}[ \t]+this[ \t]+record)(?<excluded>,[ \t]+not[ \t]+${direction}[ \t]+processing)?\.[ \t]+(?<unresolved>The[ \t]+calendar[ \t]+${period}[ \t]+cannot[ \t]+be[ \t]+established)`, 'dgiu'),
+                clock: { deictic, period, direction },
+            });
+        }
+    for (const period of ['месяц', 'год'])
+        for (const [deictic, direction] of [
+            ['следующий', 'после'],
+            ['прошлый', 'до'],
+        ]) {
+            const label = `${deictic}[ \\t]+${period}`;
+            definitions.push({
+                pattern: new RegExp(String.raw `^[ \t]*(?<unknown>Дата[ \t]+первоначальной[ \t]+записи[ \t]+неизвестна)\.[ \t]+(?<anchor>(?:«${label}»|“${label}”|"${label}"|${label})[ \t]+означает[ \t]+${period}[ \t]+${direction}[ \t]+этой[ \t]+записи)(?<excluded>,[ \t]+а[ \t]+не[ \t]+${direction}[ \t]+обработки)?\.[ \t]+(?<unresolved>Какой[ \t]+это[ \t]+календарный[ \t]+${period},[ \t]+установить[ \t]+невозможно)`, 'dgiu'),
+                clock: {
+                    deictic: deictic === 'следующий' ? 'next' : 'last',
+                    period: period === 'месяц' ? 'month' : 'year',
+                    direction: direction === 'после' ? 'after' : 'before',
+                },
+            });
+        }
+    const witnesses = frame.flatMap((span, frame_index) => definitions.flatMap(({ pattern, clock }) => [...span.quote.matchAll(pattern)].flatMap((match) => {
+        if (!hasUnretractedClauseEnd(span.quote, match.index + match[0].length))
+            return [];
+        // These coordinates certify a complete source definition, not a safe-looking substring.
+        // Unmatched framing, retraction or another clock would change which dimensions are owed.
+        if (match.index !== 0 || !/^[ \t]*[.!]?[ \t]*$/u.test(span.quote.slice(match[0].length)))
+            return [];
+        const dimensions = Object.entries(match.indices.groups).flatMap(([dimension, range]) => range
+            ? [{ dimension, start: range[0], end: range[1], exact_excerpt: span.quote.slice(...range) }]
+            : []);
+        return [
+            {
+                frame_index,
+                clock,
+                item_id: span.item_id ?? null,
+                with_exclusion: Boolean(match.groups.excluded),
+                dimensions,
+            },
+        ];
+    })));
+    // Duplicate proof spans may carry the same definition; distinct definitions are ambiguous.
+    const distinct = new Map(witnesses.map((witness) => [
+        JSON.stringify([
+            witness.item_id,
+            witness.dimensions.map(({ dimension, exact_excerpt }) => [dimension, exact_excerpt]),
+        ]),
+        witness,
+    ]));
+    return distinct.size === 1 ? [...distinct.values()][0] : null;
+}
+/** The same source-defined period must explicitly exclude processing as its reference.
+ * This is a readability floor; the original source verifier still owns temporal entailment. */
+export function hasReadableProcessingClockExclusion(text, witness) {
+    if (!witness.with_exclusion)
+        return false;
+    const { deictic, period, direction } = witness.clock;
+    const englishLabel = String.raw `${deictic}[ \t]+${period}`;
+    const russianPeriod = {
+        day: { nominative: 'день', genitive: 'дня' },
+        week: { nominative: 'неделя', genitive: 'недели' },
+        month: { nominative: 'месяц', genitive: 'месяца' },
+        year: { nominative: 'год', genitive: 'года' },
+    }[period];
+    const russianAdjective = period === 'week'
+        ? {
+            nominative: deictic === 'next' ? 'следующая' : 'прошлая',
+            genitive: deictic === 'next' ? 'следующей' : 'прошлой',
+        }
+        : {
+            nominative: deictic === 'next' ? 'следующий' : 'прошлый',
+            genitive: deictic === 'next' ? 'следующего' : 'прошлого',
+        };
+    const russianLabel = String.raw `${russianAdjective.nominative}[ \t]+${russianPeriod.nominative}`;
+    const russianGenitive = String.raw `${russianAdjective.genitive}[ \t]+${russianPeriod.genitive}`;
+    const isolatedLabel = new RegExp(String.raw `^(?:${englishLabel}|${russianLabel}|${russianGenitive})$`, 'iu');
+    const unquoted = text.replace(/`[^`]*`|«[^»]*»|“[^”]*”|"[^"\n]*"|‘[^’]*’|(?<![\p{L}\p{N}])'[^'\n]*'(?![\p{L}\p{N}])/gu, (quote) => (isolatedLabel.test(quote.slice(1, -1)) ? quote.slice(1, -1) : '⟦quotation⟧'));
+    const sourceRecord = String.raw `(?:the[ \t]+)?(?:(?:original|undated|source)[ \t]+){0,2}(?:record|note)`;
+    const processing = String.raw `(?:the[ \t]+)?(?:time[ \t]+of[ \t]+processing|processing(?:[ \t]+time)?)`;
+    const patterns = [
+        String.raw `processing[ \t]+time[ \t]+is[ \t]+not[ \t]+the[ \t]+(?:reference|origin|reference[ \t]+point)[ \t]+for[ \t]+${englishLabel}`,
+        String.raw `${englishLabel}[ \t]+is[ \t]+not[ \t]+(?:counted|measured|reckoned)[ \t]+from[ \t]+${processing}`,
+        String.raw `${englishLabel}[ \t]+means[ \t]+the[ \t]+${period}[ \t]+${direction}[ \t]+${sourceRecord},[ \t]+not[ \t]+(?:${direction}[ \t]+)?${processing}`,
+        String.raw `${englishLabel}[ \t]+(?:refers[ \t]+to|is[ \t]+(?:counted|measured|reckoned)[ \t]+from)[ \t]+${sourceRecord},[ \t]+not[ \t]+${processing}`,
+        String.raw `${russianLabel}[ \t]+не[ \t]+отсчитывается[ \t]+от[ \t]+(?:времени[ \t]+)?обработки`,
+        String.raw `время[ \t]+обработки[ \t]+не[ \t]+зада[её]т[ \t]+отсч[её]т[ \t]+для[ \t]+${russianGenitive}`,
+        String.raw `${russianLabel}[ \t]+отсчитывается[ \t]+от[ \t]+(?:времени[ \t]+)?(?:(?:исходной|первоначальной|недатированной)[ \t]+){0,2}записи,[ \t]+а[ \t]+не[ \t]+от[ \t]+(?:времени[ \t]+)?обработки`,
+    ];
+    return patterns.some((body) => {
+        const pattern = new RegExp(String.raw `(?:^|[.;!])[ \t]*${body}`, 'giu');
+        return [...unquoted.matchAll(pattern)].some((match) => hasUnretractedClauseEnd(unquoted, match.index + match[0].length));
+    });
+}
+export const CLOCK_TEXT_REPAIR_CONTRACT = `For repair_contract.mode clock_text_only or clock_text_only_with_exclusion,
+return only candidate_index and its required complete final-prose sentences. Preserve the actual proposition,
+all named actors and separate nontemporal limits in proposition_and_nontemporal_scope. Explicitly state the
+source-relative period/direction and unknown original source date in source_clock_anchor_and_unknown_date.
+State that the calendar period cannot be established in unresolved_calendar_period. Only the exclusion arm
+has excluded_reference_clocks: preserve the exact source-witnessed excluded processing clock; invent none.
+Name clock_witness.clock's same deictic period in a closed reference exclusion, for example
+"Processing time is not the reference for next month." A bare processing mention or chronology is not
+a clock reference. Do not use an unresolved "the clock" pronoun in this field.
+clock_witness lists exact candidate-owned source coordinates, not generated interpretation. Use the complete
+original source too. Maximum UTF-16 lengths with exclusion are 195/90/60/52, with three joining spaces;
+without exclusion they are 220/110/68, with two spaces. Every sentence must end in its own period or
+exclamation mark, with no CR/LF/NUL, headings, examples or fragments. The model supplies every semantic byte;
+all nontext fields are cloned unchanged. Omit the repair if these bounds cannot preserve the source. Full
+local cleaning, language checking, original repair obligations and semantic verification still follow.`;
+//# sourceMappingURL=retain-clock-repair.js.map

package/dist/write/retain-clock-repair.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retain-clock-repair.js","sourceRoot":"","sources":["../../src/write/retain-clock-repair.ts"],"names":[],"mappings":"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"}

package/dist/write/retain.d.ts

@@ -1,19 +1,23 @@
-import { type ProvidedRetainCandidate, type RetainHoldReason, type RetainModelCallReceipt, type RetainSourceItem } from '@tenphi/akno-protocol';
+import { type ProvidedRetainCandidate, type RetainHoldReason, type RetainModelCallReceipt, type RetainSourceItem, type DegradedReason } from '@tenphi/akno-protocol';
 import { z } from 'zod';
 import { type ModelClient, type ModelOutcome } from '../models/client.ts';
 import type { FolderCatalogEntry } from '../kb/folders.ts';
+/**
+ * Retention extracts a complete semantic representation, not a flat fact. The same result is
+ * consumed by keyed `retain` and unkeyed `remember`; keeping the interpretation here prevents
+ * the two public operations from gradually learning different meanings for the same source.
+ */
+export declare const RETAIN_PROMPT_VERSION = "retain-extraction-language-v57";
+export declare const RETAIN_VERIFIER_VERSION = "retain-verifier-language-v41";
 /** All fields are required or nullable so constrained-decoding endpoints can keep strict mode. */
 export declare const RETAIN_SCHEMA: z.ZodObject<{
     candidates: z.ZodArray<z.ZodObject<{
-        text: z.ZodString;
-        subject: z.ZodString;
-        page: z.ZodNullable<z.ZodString>;
         kind: z.ZodEnum<{
-            question: "question";
             claim: "claim";
+            question: "question";
+            plan: "plan";
             decision: "decision";
             preference: "preference";
-            plan: "plan";
             event: "event";
         }>;
         attribution: z.ZodObject<{
@@ -43,13 +47,13 @@ export declare const RETAIN_SCHEMA: z.ZodObject<{
                 counterfactual: "counterfactual";
             }>;
             disposition: z.ZodEnum<{
+                completed: "completed";
+                rejected: "rejected";
                 active: "active";
                 proposed: "proposed";
                 accepted: "accepted";
-                rejected: "rejected";
                 resolved: "resolved";
                 cancelled: "cancelled";
-                completed: "completed";
                 superseded: "superseded";
             }>;
         }, z.core.$strip>;
@@ -103,10 +107,10 @@ export declare const RETAIN_SCHEMA: z.ZodObject<{
                 due: "due";
             }>;
             status: z.ZodEnum<{
+                tentative: "tentative";
                 scheduled: "scheduled";
                 actual: "actual";
                 planned: "planned";
-                tentative: "tentative";
             }>;
             timezone: z.ZodNullable<z.ZodString>;
             mentioned_at: z.ZodNullable<z.ZodString>;
@@ -130,6 +134,9 @@ export declare const RETAIN_SCHEMA: z.ZodObject<{
                 until: z.ZodNullable<z.ZodString>;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
+        text: z.ZodString;
+        subject: z.ZodString;
+        page: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>>;
     events: z.ZodArray<z.ZodObject<{
         date: z.ZodString;
@@ -144,6 +151,7 @@ export type RetainCandidate = ProvidedRetainCandidate & {
     evidence?: string;
 };
 export interface RetainHeldCandidate {
+    hold_stage?: 'validation' | 'verification';
     candidate_id: string;
     reason_code: RetainHoldReason;
     reason: string;
@@ -160,9 +168,10 @@ export interface RetainResult {
         reason_code: RetainHoldReason;
         reason: string;
     } | null;
-    degradedReason: 'no_derive_model' | 'derive_failed' | 'retain_verification_failed' | null;
+    degradedReason: DegradedReason | null;
     modelUsage: {
         extraction: RetainModelCallReceipt | null;
+        repair?: RetainModelCallReceipt;
         verification: RetainModelCallReceipt | null;
     };
 }
@@ -175,6 +184,8 @@ export interface CandidateCleaningOptions {
     revision?: string;
     mentionedAt?: string;
     timezone?: string;
+    /** Internal automatic-extraction checks do not reinterpret exact caller-provided text. */
+    generated?: true;
 }
 export declare function runRetain(text: string, model: ModelClient, options?: {
     mission?: string;

package/dist/write/retain.d.ts.map

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