@marinoscar/kvox-eval 0.0.0-bootstrap → 0.1.0-next.0

package/dist/fixtures/load.js

@@ -0,0 +1,137 @@
+"use strict";
+// Loading the golden set (issue #362): every `*.json` in a directory, parsed
+// through `goldenFixtureSchema`, sorted by id. A malformed file throws with its
+// name — a fixture that does not parse is never silently skipped.
+//
+// #580: the set ships inside `@marinoscar/kvox-eval` (`fixtures/kg-golden/`),
+// resolved against the package root, so the same path works from `dist/` and
+// from `src/` under ts-jest.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KgEvalLoadError = exports.GOLDEN_MEETINGS_DIR = exports.GOLDEN_SET_DIR = void 0;
+exports.listFixtureFiles = listFixtureFiles;
+exports.loadFixtureFile = loadFixtureFile;
+exports.loadGoldenSet = loadGoldenSet;
+exports.selectFixtures = selectFixtures;
+exports.loadGoldenMeetings = loadGoldenMeetings;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const fixture_schema_js_1 = require("./fixture-schema.js");
+/** `src/fixtures` and `dist/fixtures` both sit two levels below the package root. */
+const PACKAGE_ROOT = (0, path_1.resolve)(__dirname, '..', '..');
+/**
+ * The committed, synthetic golden set's directory (`fixtures/kg-golden/` of the package).
+ *
+ * @stability experimental
+ */
+exports.GOLDEN_SET_DIR = (0, path_1.join)(PACKAGE_ROOT, 'fixtures', 'kg-golden');
+/**
+ * The committed, synthetic meetings (`fixtures/kg-golden/meetings/`).
+ *
+ * @stability experimental
+ */
+exports.GOLDEN_MEETINGS_DIR = (0, path_1.join)(exports.GOLDEN_SET_DIR, 'meetings');
+/**
+ * A golden set (or a selection of it) that cannot be loaded: a file that is not
+ * JSON or does not match its schema, a duplicate id, an unknown id. The CLIs map
+ * it to exit code 2.
+ *
+ * @stability experimental
+ */
+class KgEvalLoadError extends Error {
+}
+exports.KgEvalLoadError = KgEvalLoadError;
+/**
+ * Every `*.json` file of a directory, sorted by name.
+ *
+ * @param dir - the directory.
+ * @returns absolute paths.
+ * @stability experimental
+ */
+function listFixtureFiles(dir) {
+    return (0, fs_1.readdirSync)(dir)
+        .filter((f) => f.endsWith('.json'))
+        .sort()
+        .map((f) => (0, path_1.join)(dir, f));
+}
+/**
+ * One fixture file, parsed and validated.
+ *
+ * @param file - the file.
+ * @returns the fixture.
+ * @throws {@link KgEvalLoadError} when it is not JSON or does not match `goldenFixtureSchema`.
+ * @stability experimental
+ */
+function loadFixtureFile(file) {
+    let raw;
+    try {
+        raw = JSON.parse((0, fs_1.readFileSync)(file, 'utf8'));
+    }
+    catch (err) {
+        throw new KgEvalLoadError(`${file}: not valid JSON (${err.message})`);
+    }
+    const parsed = fixture_schema_js_1.goldenFixtureSchema.safeParse(raw);
+    if (!parsed.success) {
+        const issues = parsed.error.issues
+            .slice(0, 5)
+            .map((i) => `${i.path.join('.')}: ${i.message}`)
+            .join('; ');
+        throw new KgEvalLoadError(`${file}: does not match goldenFixtureSchema — ${issues}`);
+    }
+    return parsed.data;
+}
+/**
+ * Every fixture of a directory, sorted by id (numerically: m2 before m10).
+ *
+ * @param dir - the directory; default the committed {@link GOLDEN_MEETINGS_DIR}.
+ * @returns the fixtures.
+ * @throws {@link KgEvalLoadError} on a malformed file or a duplicate id.
+ * @stability experimental
+ */
+function loadGoldenSet(dir = exports.GOLDEN_MEETINGS_DIR) {
+    const fixtures = listFixtureFiles(dir).map(loadFixtureFile);
+    const seen = new Set();
+    for (const f of fixtures) {
+        if (seen.has(f.id))
+            throw new KgEvalLoadError(`${dir}: fixture id ${f.id} appears twice`);
+        seen.add(f.id);
+    }
+    return fixtures.sort((a, b) => a.id.localeCompare(b.id, 'en', { numeric: true }));
+}
+/**
+ * `--only m01,m07` / `--tag promotion`: both narrow; neither given keeps all.
+ *
+ * @param fixtures - the loaded set.
+ * @param only - fixture ids to keep, or `null`.
+ * @param tag - a tag every kept fixture carries, or `null`.
+ * @returns the selection, in set order.
+ * @throws {@link KgEvalLoadError} when `only` names an id the set does not have.
+ * @stability experimental
+ */
+function selectFixtures(fixtures, only, tag) {
+    let out = fixtures;
+    if (only && only.length > 0) {
+        const unknown = only.filter((id) => !fixtures.some((f) => f.id === id));
+        if (unknown.length > 0)
+            throw new KgEvalLoadError(`unknown fixture id(s): ${unknown.join(', ')}`);
+        out = out.filter((f) => only.includes(f.id));
+    }
+    if (tag)
+        out = out.filter((f) => f.tags.includes(tag));
+    return out;
+}
+/**
+ * The committed golden meetings, optionally narrowed to some ids.
+ *
+ * @example
+ * ```ts
+ * const [m01, m07] = loadGoldenMeetings(['m01', 'm07']);
+ * ```
+ *
+ * @param ids - fixture ids to keep (in set order); omitted or empty keeps all.
+ * @returns the fixtures.
+ * @throws {@link KgEvalLoadError} on a malformed file or an unknown id.
+ * @stability experimental
+ */
+function loadGoldenMeetings(ids) {
+    return selectFixtures(loadGoldenSet(exports.GOLDEN_MEETINGS_DIR), ids && ids.length > 0 ? [...ids] : null, null);
+}

package/dist/fixtures/questions.d.ts

@@ -0,0 +1,15 @@
+import { type AskEvalQuestion } from '../ask/index.js';
+/**
+ * The committed Ask question file (`fixtures/kg-golden/ask-questions.json`).
+ *
+ * @stability experimental
+ */
+export declare const ASK_QUESTIONS_PATH: string;
+/**
+ * The committed Ask questions, parsed and validated.
+ *
+ * @returns every question, in file order.
+ * @throws `AskEvalQuestionLoadError` when the file is not valid JSON or does not match the schema.
+ * @stability experimental
+ */
+export declare function loadGoldenAskQuestions(): AskEvalQuestion[];

package/dist/fixtures/questions.js

@@ -0,0 +1,26 @@
+"use strict";
+// The Ask golden question file (issue #382), shipped beside the meetings it is
+// asked about. The schema and the parser are the `ask` slice's; this is only
+// where the committed file is.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ASK_QUESTIONS_PATH = void 0;
+exports.loadGoldenAskQuestions = loadGoldenAskQuestions;
+const path_1 = require("path");
+const index_js_1 = require("../ask/index.js");
+const load_js_1 = require("./load.js");
+/**
+ * The committed Ask question file (`fixtures/kg-golden/ask-questions.json`).
+ *
+ * @stability experimental
+ */
+exports.ASK_QUESTIONS_PATH = (0, path_1.join)(load_js_1.GOLDEN_SET_DIR, 'ask-questions.json');
+/**
+ * The committed Ask questions, parsed and validated.
+ *
+ * @returns every question, in file order.
+ * @throws `AskEvalQuestionLoadError` when the file is not valid JSON or does not match the schema.
+ * @stability experimental
+ */
+function loadGoldenAskQuestions() {
+    return (0, index_js_1.loadAskEvalQuestions)(exports.ASK_QUESTIONS_PATH);
+}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `@marinoscar/kvox-eval`: the KVox knowledge-graph and Ask evaluation.
+ *
+ * @remarks
+ * Written only against the model port (`KvoxAiPort` of `@marinoscar/kvox-api/ports`,
+ * bound with `createKvoxAi` of `@marinoscar/kvox-ai`), so the web edition and KVox
+ * Desktop measure the same prompts, schemas and validators the product ships.
+ * Slices: `kg` (prediction schema, scorer, report, the gold and live runners,
+ * `runKgEval`), `ask` (the Ask question schema, scorer and report), `live` (the key
+ * from the environment and the live port over the provider adapters),
+ * `real-data` (the guard that keeps real meetings out of the repository) and `cli`
+ * (`kvox-eval`). The golden set is the `@marinoscar/kvox-eval/fixtures` entry.
+ *
+ * @packageDocumentation
+ */
+export * from './ask/index.js';
+export * from './cli/index.js';
+export * from './kg/index.js';
+export * from './live/index.js';
+export * from './real-data/index.js';

package/dist/index.js

@@ -0,0 +1,36 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * `@marinoscar/kvox-eval`: the KVox knowledge-graph and Ask evaluation.
+ *
+ * @remarks
+ * Written only against the model port (`KvoxAiPort` of `@marinoscar/kvox-api/ports`,
+ * bound with `createKvoxAi` of `@marinoscar/kvox-ai`), so the web edition and KVox
+ * Desktop measure the same prompts, schemas and validators the product ships.
+ * Slices: `kg` (prediction schema, scorer, report, the gold and live runners,
+ * `runKgEval`), `ask` (the Ask question schema, scorer and report), `live` (the key
+ * from the environment and the live port over the provider adapters),
+ * `real-data` (the guard that keeps real meetings out of the repository) and `cli`
+ * (`kvox-eval`). The golden set is the `@marinoscar/kvox-eval/fixtures` entry.
+ *
+ * @packageDocumentation
+ */
+__exportStar(require("./ask/index.js"), exports);
+__exportStar(require("./cli/index.js"), exports);
+__exportStar(require("./kg/index.js"), exports);
+__exportStar(require("./live/index.js"), exports);
+__exportStar(require("./real-data/index.js"), exports);

package/dist/kg/gold-runner.d.ts

@@ -0,0 +1,13 @@
+import type { GoldenFixture } from '../fixtures/index.js';
+import type { KgEvalPrediction } from './prediction-schema.js';
+/**
+ * The prediction synthesised from a fixture's own labels (`--predictions gold`): the
+ * harness's self-test, which must score 1.000 everywhere. Resolutions come from
+ * `existingId` (a prechecked link), so auto-link precision is exercised too.
+ *
+ * @param fixture - the fixture.
+ * @returns its gold prediction.
+ *
+ * @stability experimental
+ */
+export declare function goldPrediction(fixture: GoldenFixture): KgEvalPrediction;

package/dist/kg/gold-runner.js

@@ -0,0 +1,57 @@
+"use strict";
+// `--predictions gold`: predictions synthesised from the labels themselves.
+// The harness's self-test — scoring it must print 1.000 everywhere, so any
+// other number is a bug in the scorer or an inconsistent fixture, never in a
+// model. Resolutions come from `existingId` (a prechecked link) so auto-link
+// precision is exercised too.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.goldPrediction = goldPrediction;
+const toPredicted = (ev) => ev.map((e) => ({ source: e.source, segmentId: e.source === 'segment' ? e.segmentId : null, quote: e.quote }));
+/**
+ * The prediction synthesised from a fixture's own labels (`--predictions gold`): the
+ * harness's self-test, which must score 1.000 everywhere. Resolutions come from
+ * `existingId` (a prechecked link), so auto-link precision is exercised too.
+ *
+ * @param fixture - the fixture.
+ * @returns its gold prediction.
+ *
+ * @stability experimental
+ */
+function goldPrediction(fixture) {
+    return {
+        fixtureId: fixture.id,
+        model: null,
+        entities: fixture.labels.entities.map((e) => ({
+            ref: e.key,
+            type: e.type,
+            label: e.label,
+            aliases: [...e.aliases],
+            resolution: e.existingId
+                ? { outcome: 'linked', entityId: e.existingId, score: 1, prechecked: true }
+                : { outcome: 'new', entityId: null, score: null, prechecked: false },
+            evidence: toPredicted(e.evidence),
+        })),
+        relations: fixture.labels.relations.map((r) => ({
+            type: r.type,
+            from: r.from,
+            to: r.to,
+            validFrom: r.validFrom,
+            validTo: r.validTo,
+            precision: r.precision,
+            evidence: toPredicted(r.evidence),
+        })),
+        items: fixture.labels.items.map((i) => ({
+            kind: i.kind,
+            subject: i.subject,
+            owner: i.owner,
+            counterparty: i.counterparty,
+            title: i.title,
+            statement: i.statement,
+            occurredAt: i.occurredAt,
+            dueAt: i.dueAt,
+            sensitivity: i.sensitivity,
+            evidence: toPredicted(i.evidence),
+        })),
+        stats: { uncited: 0, invalid: 0 },
+    };
+}

package/dist/kg/index.d.ts

@@ -0,0 +1,17 @@
+export { goldPrediction } from './gold-runner.js';
+export { emptyPrediction, kgEvalPredictionSchema, predictedEntitySchema, predictedEvidenceSchema, predictedItemSchema, predictedRelationSchema, predictedResolutionSchema, } from './prediction-schema.js';
+export type { KgEvalPrediction, KgEvalPredictionInput, PredictedEntity, PredictedEvidence, PredictedItem, PredictedRelation, } from './prediction-schema.js';
+export { loadPredictionFile } from './predictions.js';
+export { buildReport, formatReport, kgEvalReportSchema } from './report.js';
+export type { KgEvalReport } from './report.js';
+export { KgEvalTargetsError, KgEvalUsageError, runKgEval } from './run-kg-eval.js';
+export type { RunKgEvalOptions } from './run-kg-eval.js';
+export { findKgEvalRunner, KG_EVAL_RUNNER_ALIASES, KG_EVAL_RUNNERS } from './runner.js';
+export type { KgEvalRunner, KgEvalRunnerDeps, KgEvalRunnerFactory, KgEvalRunOptions } from './runner.js';
+export { autoLinkPrecision, BASE_REPORT_TYPES, commitmentRecall, ENTITY_MATCH_JACCARD, ENTITY_REPORT_TYPES, entityCoverage, f1Of, ITEM_REPORT_TYPES, ITEM_STATEMENT_F1, matchEntities, precisionOf, ratio, recallOf, scoreFixture, scoreRun, temporalEqual, } from './scorer.js';
+export type { Counts, FixtureScore, RunScore } from './scorer.js';
+export { KG_EVAL_TARGETS } from './targets.js';
+export type { KgEvalTargetKey } from './targets.js';
+export { collapseWhitespace, jaccard, normalizeName, quoteFoundIn, tokenF1, tokenSet } from './text.js';
+export { EVAL_CONTEXT_WINDOW_TOKENS, EVAL_MAX_OUTPUT_TOKENS, EVAL_TIMEOUT_MS, EVAL_USER_ID, createExtractRunner, fixtureToInput, runExtraction, } from './runners/extract-runner.js';
+export { createExtractResolveRunner, trigramSimilarity } from './runners/extract-resolve-runner.js';

package/dist/kg/index.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trigramSimilarity = exports.createExtractResolveRunner = exports.runExtraction = exports.fixtureToInput = exports.createExtractRunner = exports.EVAL_USER_ID = exports.EVAL_TIMEOUT_MS = exports.EVAL_MAX_OUTPUT_TOKENS = exports.EVAL_CONTEXT_WINDOW_TOKENS = exports.tokenSet = exports.tokenF1 = exports.quoteFoundIn = exports.normalizeName = exports.jaccard = exports.collapseWhitespace = exports.KG_EVAL_TARGETS = exports.temporalEqual = exports.scoreRun = exports.scoreFixture = exports.recallOf = exports.ratio = exports.precisionOf = exports.matchEntities = exports.ITEM_STATEMENT_F1 = exports.ITEM_REPORT_TYPES = exports.f1Of = exports.entityCoverage = exports.ENTITY_REPORT_TYPES = exports.ENTITY_MATCH_JACCARD = exports.commitmentRecall = exports.BASE_REPORT_TYPES = exports.autoLinkPrecision = exports.KG_EVAL_RUNNERS = exports.KG_EVAL_RUNNER_ALIASES = exports.findKgEvalRunner = exports.runKgEval = exports.KgEvalUsageError = exports.KgEvalTargetsError = exports.kgEvalReportSchema = exports.formatReport = exports.buildReport = exports.loadPredictionFile = exports.predictedResolutionSchema = exports.predictedRelationSchema = exports.predictedItemSchema = exports.predictedEvidenceSchema = exports.predictedEntitySchema = exports.kgEvalPredictionSchema = exports.emptyPrediction = exports.goldPrediction = void 0;
+// The kg slice's public surface (re-exported by the package root).
+var gold_runner_js_1 = require("./gold-runner.js");
+Object.defineProperty(exports, "goldPrediction", { enumerable: true, get: function () { return gold_runner_js_1.goldPrediction; } });
+var prediction_schema_js_1 = require("./prediction-schema.js");
+Object.defineProperty(exports, "emptyPrediction", { enumerable: true, get: function () { return prediction_schema_js_1.emptyPrediction; } });
+Object.defineProperty(exports, "kgEvalPredictionSchema", { enumerable: true, get: function () { return prediction_schema_js_1.kgEvalPredictionSchema; } });
+Object.defineProperty(exports, "predictedEntitySchema", { enumerable: true, get: function () { return prediction_schema_js_1.predictedEntitySchema; } });
+Object.defineProperty(exports, "predictedEvidenceSchema", { enumerable: true, get: function () { return prediction_schema_js_1.predictedEvidenceSchema; } });
+Object.defineProperty(exports, "predictedItemSchema", { enumerable: true, get: function () { return prediction_schema_js_1.predictedItemSchema; } });
+Object.defineProperty(exports, "predictedRelationSchema", { enumerable: true, get: function () { return prediction_schema_js_1.predictedRelationSchema; } });
+Object.defineProperty(exports, "predictedResolutionSchema", { enumerable: true, get: function () { return prediction_schema_js_1.predictedResolutionSchema; } });
+var predictions_js_1 = require("./predictions.js");
+Object.defineProperty(exports, "loadPredictionFile", { enumerable: true, get: function () { return predictions_js_1.loadPredictionFile; } });
+var report_js_1 = require("./report.js");
+Object.defineProperty(exports, "buildReport", { enumerable: true, get: function () { return report_js_1.buildReport; } });
+Object.defineProperty(exports, "formatReport", { enumerable: true, get: function () { return report_js_1.formatReport; } });
+Object.defineProperty(exports, "kgEvalReportSchema", { enumerable: true, get: function () { return report_js_1.kgEvalReportSchema; } });
+var run_kg_eval_js_1 = require("./run-kg-eval.js");
+Object.defineProperty(exports, "KgEvalTargetsError", { enumerable: true, get: function () { return run_kg_eval_js_1.KgEvalTargetsError; } });
+Object.defineProperty(exports, "KgEvalUsageError", { enumerable: true, get: function () { return run_kg_eval_js_1.KgEvalUsageError; } });
+Object.defineProperty(exports, "runKgEval", { enumerable: true, get: function () { return run_kg_eval_js_1.runKgEval; } });
+var runner_js_1 = require("./runner.js");
+Object.defineProperty(exports, "findKgEvalRunner", { enumerable: true, get: function () { return runner_js_1.findKgEvalRunner; } });
+Object.defineProperty(exports, "KG_EVAL_RUNNER_ALIASES", { enumerable: true, get: function () { return runner_js_1.KG_EVAL_RUNNER_ALIASES; } });
+Object.defineProperty(exports, "KG_EVAL_RUNNERS", { enumerable: true, get: function () { return runner_js_1.KG_EVAL_RUNNERS; } });
+var scorer_js_1 = require("./scorer.js");
+Object.defineProperty(exports, "autoLinkPrecision", { enumerable: true, get: function () { return scorer_js_1.autoLinkPrecision; } });
+Object.defineProperty(exports, "BASE_REPORT_TYPES", { enumerable: true, get: function () { return scorer_js_1.BASE_REPORT_TYPES; } });
+Object.defineProperty(exports, "commitmentRecall", { enumerable: true, get: function () { return scorer_js_1.commitmentRecall; } });
+Object.defineProperty(exports, "ENTITY_MATCH_JACCARD", { enumerable: true, get: function () { return scorer_js_1.ENTITY_MATCH_JACCARD; } });
+Object.defineProperty(exports, "ENTITY_REPORT_TYPES", { enumerable: true, get: function () { return scorer_js_1.ENTITY_REPORT_TYPES; } });
+Object.defineProperty(exports, "entityCoverage", { enumerable: true, get: function () { return scorer_js_1.entityCoverage; } });
+Object.defineProperty(exports, "f1Of", { enumerable: true, get: function () { return scorer_js_1.f1Of; } });
+Object.defineProperty(exports, "ITEM_REPORT_TYPES", { enumerable: true, get: function () { return scorer_js_1.ITEM_REPORT_TYPES; } });
+Object.defineProperty(exports, "ITEM_STATEMENT_F1", { enumerable: true, get: function () { return scorer_js_1.ITEM_STATEMENT_F1; } });
+Object.defineProperty(exports, "matchEntities", { enumerable: true, get: function () { return scorer_js_1.matchEntities; } });
+Object.defineProperty(exports, "precisionOf", { enumerable: true, get: function () { return scorer_js_1.precisionOf; } });
+Object.defineProperty(exports, "ratio", { enumerable: true, get: function () { return scorer_js_1.ratio; } });
+Object.defineProperty(exports, "recallOf", { enumerable: true, get: function () { return scorer_js_1.recallOf; } });
+Object.defineProperty(exports, "scoreFixture", { enumerable: true, get: function () { return scorer_js_1.scoreFixture; } });
+Object.defineProperty(exports, "scoreRun", { enumerable: true, get: function () { return scorer_js_1.scoreRun; } });
+Object.defineProperty(exports, "temporalEqual", { enumerable: true, get: function () { return scorer_js_1.temporalEqual; } });
+var targets_js_1 = require("./targets.js");
+Object.defineProperty(exports, "KG_EVAL_TARGETS", { enumerable: true, get: function () { return targets_js_1.KG_EVAL_TARGETS; } });
+var text_js_1 = require("./text.js");
+Object.defineProperty(exports, "collapseWhitespace", { enumerable: true, get: function () { return text_js_1.collapseWhitespace; } });
+Object.defineProperty(exports, "jaccard", { enumerable: true, get: function () { return text_js_1.jaccard; } });
+Object.defineProperty(exports, "normalizeName", { enumerable: true, get: function () { return text_js_1.normalizeName; } });
+Object.defineProperty(exports, "quoteFoundIn", { enumerable: true, get: function () { return text_js_1.quoteFoundIn; } });
+Object.defineProperty(exports, "tokenF1", { enumerable: true, get: function () { return text_js_1.tokenF1; } });
+Object.defineProperty(exports, "tokenSet", { enumerable: true, get: function () { return text_js_1.tokenSet; } });
+var extract_runner_js_1 = require("./runners/extract-runner.js");
+Object.defineProperty(exports, "EVAL_CONTEXT_WINDOW_TOKENS", { enumerable: true, get: function () { return extract_runner_js_1.EVAL_CONTEXT_WINDOW_TOKENS; } });
+Object.defineProperty(exports, "EVAL_MAX_OUTPUT_TOKENS", { enumerable: true, get: function () { return extract_runner_js_1.EVAL_MAX_OUTPUT_TOKENS; } });
+Object.defineProperty(exports, "EVAL_TIMEOUT_MS", { enumerable: true, get: function () { return extract_runner_js_1.EVAL_TIMEOUT_MS; } });
+Object.defineProperty(exports, "EVAL_USER_ID", { enumerable: true, get: function () { return extract_runner_js_1.EVAL_USER_ID; } });
+Object.defineProperty(exports, "createExtractRunner", { enumerable: true, get: function () { return extract_runner_js_1.createExtractRunner; } });
+Object.defineProperty(exports, "fixtureToInput", { enumerable: true, get: function () { return extract_runner_js_1.fixtureToInput; } });
+Object.defineProperty(exports, "runExtraction", { enumerable: true, get: function () { return extract_runner_js_1.runExtraction; } });
+var extract_resolve_runner_js_1 = require("./runners/extract-resolve-runner.js");
+Object.defineProperty(exports, "createExtractResolveRunner", { enumerable: true, get: function () { return extract_resolve_runner_js_1.createExtractResolveRunner; } });
+Object.defineProperty(exports, "trigramSimilarity", { enumerable: true, get: function () { return extract_resolve_runner_js_1.trigramSimilarity; } });

package/dist/kg/internals.d.ts

@@ -0,0 +1,7 @@
+import { internals as extractionInternals } from '@marinoscar/kvox-api/graph-extraction/testing';
+export declare const EXTRACTION_SCHEMA_NAME: string, addDeterministicRows: typeof extractionInternals.addDeterministicRows, assembleExtractionPrompt: typeof extractionInternals.assembleExtractionPrompt, bandFor: typeof extractionInternals.bandFor, buildExtractionContext: typeof extractionInternals.buildExtractionContext, buildExtractionOutputSchema: typeof extractionInternals.buildExtractionOutputSchema, candidateEdge: typeof extractionInternals.candidateEdge, decide: typeof extractionInternals.decide, entityView: typeof extractionInternals.entityView, existingId: typeof extractionInternals.existingId, extractionRowCaps: typeof extractionInternals.extractionRowCaps, isExclusiveTemporal: typeof extractionInternals.isExclusiveTemporal, normalizeForMatch: typeof extractionInternals.normalizeForMatch, placeholderId: typeof extractionInternals.placeholderId, proposedRelationRange: typeof extractionInternals.proposedRelationRange, rankCandidates: typeof extractionInternals.rankCandidates, relationKnown: typeof extractionInternals.relationKnown, resolveEndpoint: typeof extractionInternals.resolveEndpoint, ruleForEffectiveRelation: typeof extractionInternals.ruleForEffectiveRelation, scoreCandidate: typeof extractionInternals.scoreCandidate, validateExtraction: typeof extractionInternals.validateExtraction;
+export type EvidenceDraft = extractionInternals.EvidenceDraft;
+export type ExtractionInput = extractionInternals.ExtractionInput;
+export type KnownEntityRow = extractionInternals.KnownEntityRow;
+export type ProposalEntityView = extractionInternals.ProposalEntityView;
+export type ProposedRow = extractionInternals.ProposedRow;

package/dist/kg/internals.js

@@ -0,0 +1,17 @@
+"use strict";
+// =============================================================================
+// The slices' internals the kg evaluation runs (issue #580; #496 before it)
+// =============================================================================
+//
+// `@marinoscar/kvox-api/graph/testing` and `/graph-extraction/testing` expose the
+// functions the slices keep internal (the extraction prompt and schema builders,
+// the resolution scorer, the temporal engine's helpers) in an `internals`
+// namespace tagged `@internal`: no stability promise. This file is the ONE place
+// the package spells that out, so the runners name a function from here and
+// never from the package's internal paths. NOT EXPORTED from the package: a host
+// that needs these names reads them from kvox-api itself.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateExtraction = exports.scoreCandidate = exports.ruleForEffectiveRelation = exports.resolveEndpoint = exports.relationKnown = exports.rankCandidates = exports.proposedRelationRange = exports.placeholderId = exports.normalizeForMatch = exports.isExclusiveTemporal = exports.extractionRowCaps = exports.existingId = exports.entityView = exports.decide = exports.candidateEdge = exports.buildExtractionOutputSchema = exports.buildExtractionContext = exports.bandFor = exports.assembleExtractionPrompt = exports.addDeterministicRows = exports.EXTRACTION_SCHEMA_NAME = void 0;
+const testing_1 = require("@marinoscar/kvox-api/graph-extraction/testing");
+exports.EXTRACTION_SCHEMA_NAME = testing_1.internals.EXTRACTION_SCHEMA_NAME, exports.addDeterministicRows = testing_1.internals.addDeterministicRows, exports.assembleExtractionPrompt = testing_1.internals.assembleExtractionPrompt, exports.bandFor = testing_1.internals.bandFor, exports.buildExtractionContext = testing_1.internals.buildExtractionContext, exports.buildExtractionOutputSchema = testing_1.internals.buildExtractionOutputSchema, exports.candidateEdge = testing_1.internals.candidateEdge, exports.decide = testing_1.internals.decide, exports.entityView = testing_1.internals.entityView, exports.existingId = testing_1.internals.existingId, exports.extractionRowCaps = testing_1.internals.extractionRowCaps, exports.isExclusiveTemporal = testing_1.internals.isExclusiveTemporal, exports.normalizeForMatch = testing_1.internals.normalizeForMatch, exports.placeholderId = testing_1.internals.placeholderId, exports.proposedRelationRange = testing_1.internals.proposedRelationRange, exports.rankCandidates = testing_1.internals.rankCandidates, exports.relationKnown = testing_1.internals.relationKnown, exports.resolveEndpoint = testing_1.internals.resolveEndpoint, exports.ruleForEffectiveRelation = testing_1.internals.ruleForEffectiveRelation, exports.scoreCandidate = testing_1.internals.scoreCandidate, exports.validateExtraction = testing_1.internals.validateExtraction;