@pegma/knowledge-base-application 0.0.0-stage → 0.1.0

package/dist/retrieval.js

@@ -0,0 +1,541 @@
+import { hasPermission } from "@pegma/authorization-core";
+import { knowledgePermissions, } from "@pegma/knowledge-base-contracts";
+import { KnowledgeBaseNotFoundError } from "./errors.js";
+import { normalizeQuery, scoreConfirmedArticle } from "./lexical.js";
+import { createPublicationChecker, } from "./publication.js";
+import { createKnowledgeRepository } from "./repository.js";
+import { createRetrievalReadBudget, RetrievalBudgetError, } from "./retrieval-budget.js";
+import { resolveRetrievalLimits } from "./retrieval-limits.js";
+import { requireRetrievalHint, retrievalRecords, } from "./retrieval-records.js";
+import { createRetrievalRepository } from "./retrieval-repository.js";
+import { canonicalJson, fingerprint, requireGeneration, requireIdentifier, snapshotData, } from "./storage-helpers.js";
+function ordinal(left, right) {
+    return left === right ? 0 : left < right ? -1 : 1;
+}
+function inputSnapshot(input, fields) {
+    const value = snapshotData(input);
+    if (value === null ||
+        typeof value !== "object" ||
+        Array.isArray(value) ||
+        Object.keys(value).some((key) => !fields.includes(key)))
+        throw new TypeError("Retrieval input contains unsupported fields");
+    return value;
+}
+function applicabilitySnapshot(value) {
+    const applicability = inputSnapshot(value, [
+        "productId",
+        "productVersion",
+        "buildId",
+        "locale",
+    ]);
+    requireIdentifier(applicability.productId, "applicability.productId");
+    requireIdentifier(applicability.productVersion, "applicability.productVersion");
+    if (Object.hasOwn(applicability, "buildId"))
+        requireIdentifier(applicability.buildId, "applicability.buildId");
+    if (Object.hasOwn(applicability, "locale"))
+        requireIdentifier(applicability.locale, "applicability.locale");
+    return applicability;
+}
+function requestedLimit(limit, maximum) {
+    if (limit === undefined)
+        return maximum;
+    if (!Number.isSafeInteger(limit) || limit < 1 || limit > maximum) {
+        throw new TypeError("Requested retrieval limit exceeds its ceiling");
+    }
+    return limit;
+}
+function allows(use, access) {
+    return (use.enabled &&
+        (use.audience.kind === "anonymous" ||
+            hasPermission(access, use.audience.permission)));
+}
+function mayRead(access, purpose) {
+    return (hasPermission(access, knowledgePermissions.articleRead) &&
+        (purpose === "portal" ||
+            hasPermission(access, knowledgePermissions.botRead)));
+}
+function noPortalResult() {
+    return { outcome: "no_result", articles: [] };
+}
+function noCollections() {
+    return { outcome: "no_result", collections: [] };
+}
+function noSources() {
+    return {
+        outcome: "no_result",
+        sources: [],
+        serializedSources: "",
+        sourceTokens: 0,
+    };
+}
+function referenceOf(checked) {
+    const binding = checked.binding;
+    return {
+        articleId: binding.articleId,
+        collectionId: binding.collectionId,
+        collectionPolicyVersion: binding.collectionPolicyVersion,
+        articleRevision: binding.revision,
+        contentHash: binding.contentHash,
+        applicationGeneration: binding.articleGeneration,
+        governanceGeneration: binding.governanceGeneration,
+        validationGeneration: binding.validationGeneration,
+    };
+}
+function validateReference(reference) {
+    inputSnapshot(reference, [
+        "articleId",
+        "collectionId",
+        "collectionPolicyVersion",
+        "articleRevision",
+        "contentHash",
+        "applicationGeneration",
+        "governanceGeneration",
+        "validationGeneration",
+    ]);
+    requireIdentifier(reference.articleId, "articleId");
+    requireIdentifier(reference.collectionId, "collectionId");
+    if (!/^[a-f0-9]{64}$/u.test(reference.contentHash))
+        throw new TypeError("Invalid source content hash");
+    for (const value of [
+        reference.collectionPolicyVersion,
+        reference.articleRevision,
+        reference.applicationGeneration,
+        reference.governanceGeneration,
+        reference.validationGeneration,
+    ])
+        requireGeneration(value, 1);
+}
+function sourceOf(checked) {
+    const article = checked.article;
+    return snapshotData({
+        reference: referenceOf(checked),
+        citation: {
+            label: article.title,
+            ...(checked.portalBrowseable
+                ? {
+                    portalArticle: {
+                        articleId: article.articleId,
+                        revision: article.revision,
+                    },
+                }
+                : {}),
+        },
+        title: article.title,
+        summary: article.summary,
+        content: article.content,
+        applicability: article.applicability,
+    });
+}
+function portalArticleOf(checked) {
+    const article = checked.article;
+    return snapshotData({
+        articleId: article.articleId,
+        collectionId: article.collectionId,
+        revision: article.revision,
+        kind: article.kind,
+        title: article.title,
+        summary: article.summary,
+        snippet: article.summary,
+        tags: article.tags,
+        applicability: article.applicability,
+        contentHash: article.contentHash,
+    });
+}
+/** Every call constructs a fresh request-scoped read budget and checker. */
+export function createRetrievalServices(input) {
+    const limits = resolveRetrievalLimits(input.options?.limits);
+    const candidateAdapter = input.options?.candidateAdapter;
+    const tokenCounter = input.options?.tokenCounter;
+    function requestScope() {
+        const budget = createRetrievalReadBudget(input.store, {
+            maxPhysicalReads: limits.maxRequestPhysicalGets,
+            maxIndexReads: limits.maxIndexKeyReads,
+            maxPostingEntries: limits.maxPostingEntries,
+            maxCandidateHeads: limits.maxHeadProbes,
+            maxConfirmations: limits.maxConfirmations,
+            indexCollectionName: retrievalRecords.name,
+        });
+        const repository = createKnowledgeRepository(budget.store, input.services.limits);
+        const index = createRetrievalRepository(budget.store, limits);
+        const checker = createPublicationChecker(repository, input.services);
+        async function authorizeCollection(access, collectionId, purpose) {
+            if (!mayRead(access, purpose))
+                return null;
+            const loaded = await repository.readCollectionVersioned(collectionId);
+            if (loaded === null)
+                return null;
+            const collection = loaded.value.collection;
+            if (!allows(collection.policy[purpose], access))
+                return null;
+            if ([collection.policy.portal, collection.policy.bot].some((use) => use.enabled && use.audience.kind === "anonymous")) {
+                const approval = collection.publicApproval;
+                if (approval === undefined ||
+                    approval.collectionId !== collection.id ||
+                    approval.policyVersion !== collection.policy.version ||
+                    approval.policyHash !== (await fingerprint(collection.policy)))
+                    return null;
+            }
+            return {
+                scope: {
+                    collectionId,
+                    policyVersion: collection.policy.version,
+                    use: purpose,
+                },
+                governanceGeneration: loaded.value.generation,
+                label: collection.name,
+            };
+        }
+        async function queryHints(scopes, terms) {
+            const candidates = new Map();
+            const add = (hint, scope, term) => {
+                requireRetrievalHint(hint);
+                if (hint.collectionId !== scope.collectionId ||
+                    hint.policyVersion !== scope.policyVersion ||
+                    hint.use !== scope.use)
+                    return;
+                const candidate = candidates.get(hint.articleId) ?? {
+                    articleId: hint.articleId,
+                    firstSeen: candidates.size,
+                    terms: new Set(),
+                    hints: new Map(),
+                };
+                candidate.terms.add(term);
+                candidate.hints.set(canonicalJson(hint), hint);
+                candidates.set(candidate.articleId, candidate);
+            };
+            for (const authorized of scopes) {
+                const scope = authorized.scope;
+                if (candidateAdapter === undefined) {
+                    for (const term of terms) {
+                        const pages = await index.readPostingPages(scope, term);
+                        for (const page of pages) {
+                            budget.indexEntries(page.entries.length);
+                            for (const hint of page.entries)
+                                add(hint, scope, term);
+                        }
+                    }
+                    continue;
+                }
+                if (typeof candidateAdapter.search !== "function")
+                    throw new RetrievalBudgetError();
+                let cursor;
+                const seen = new Set();
+                for (;;) {
+                    const allowance = budget.remainingCandidateWork();
+                    // Every external page consumes at least one page/read allowance.
+                    // Do not dispatch work that cannot fit, even with an empty response.
+                    if (allowance.pagesRead < 1 ||
+                        allowance.keyedReads < 1 ||
+                        allowance.physicalRows < 1)
+                        throw new RetrievalBudgetError();
+                    const page = snapshotData(await candidateAdapter.search({
+                        scope: snapshotData(scope),
+                        terms: snapshotData(terms),
+                        ...(cursor === undefined ? {} : { cursor }),
+                        budget: allowance,
+                    }));
+                    inputSnapshot(page, ["hints", "nextCursor", "work"]);
+                    if (!Array.isArray(page.hints))
+                        throw new RetrievalBudgetError();
+                    const work = inputSnapshot(page.work, [
+                        "keyedReads",
+                        "physicalRows",
+                        "postingEntries",
+                        "pagesRead",
+                    ]);
+                    for (const key of [
+                        "keyedReads",
+                        "physicalRows",
+                        "postingEntries",
+                        "pagesRead",
+                    ]) {
+                        if (!Number.isSafeInteger(work[key]) ||
+                            work[key] < 0 ||
+                            work[key] > allowance[key])
+                            throw new RetrievalBudgetError();
+                    }
+                    if (work.pagesRead < 1 ||
+                        work.postingEntries < page.hints.length ||
+                        (page.hints.length > 0 && work.physicalRows < 1))
+                        throw new RetrievalBudgetError();
+                    budget.accountExternal(work);
+                    for (const hint of page.hints)
+                        add(hint, scope, "adapter");
+                    if (page.nextCursor === null)
+                        break;
+                    requireIdentifier(page.nextCursor, "candidate cursor");
+                    if (seen.has(page.nextCursor))
+                        throw new RetrievalBudgetError();
+                    seen.add(page.nextCursor);
+                    cursor = page.nextCursor;
+                }
+            }
+            if (candidates.size > limits.maxHeadProbes)
+                throw new RetrievalBudgetError();
+            const current = [];
+            for (const candidate of candidates.values()) {
+                budget.candidateHead();
+                const generation = await repository.readResourceGeneration("article", candidate.articleId);
+                // Draft work can advance this head without changing its publication.
+                // Only the current checker establishes authority; hints identify it.
+                if (generation !== null)
+                    current.push(candidate);
+            }
+            return current.sort((left, right) => candidateAdapter === undefined
+                ? right.terms.size - left.terms.size ||
+                    ordinal(left.articleId, right.articleId)
+                : left.firstSeen - right.firstSeen);
+        }
+        async function search(access, collectionIds, terms, applicability, purpose, resultLimit) {
+            if (!mayRead(access, purpose) || terms.length === 0)
+                return [];
+            const scopes = [];
+            // Check every requested collection before any derived index lookup.
+            for (const collectionId of collectionIds) {
+                const authorized = await authorizeCollection(access, collectionId, purpose);
+                if (authorized === null)
+                    return [];
+                scopes.push(authorized);
+            }
+            const candidates = await queryHints(scopes, terms);
+            const confirmed = [];
+            // Adapter order is a relevance hint for bounded preselection only.
+            // Every candidate still needs current publication confirmation.
+            for (const candidate of candidates.slice(0, limits.maxConfirmations)) {
+                budget.confirmation();
+                let checked;
+                try {
+                    checked = await checker.check({
+                        articleId: candidate.articleId,
+                        purpose,
+                        access,
+                        applicability,
+                    });
+                }
+                catch (error) {
+                    if (error instanceof KnowledgeBaseNotFoundError)
+                        continue;
+                    throw error;
+                }
+                if (![...candidate.hints.values()].some((hint) => hint.articleId === checked.article.articleId &&
+                    hint.collectionId === checked.article.collectionId &&
+                    hint.policyVersion === checked.binding.collectionPolicyVersion &&
+                    hint.articleRevision === checked.article.revision &&
+                    hint.contentHash === checked.article.contentHash))
+                    continue;
+                const score = scoreConfirmedArticle(checked.article, terms);
+                // An adapter may match approved body text or synonyms rather than the
+                // title/summary/tags used by the default lexical index.
+                if (score > 0 || candidateAdapter !== undefined)
+                    confirmed.push({ checked, score, firstSeen: candidate.firstSeen });
+            }
+            confirmed.sort((left, right) => right.score - left.score ||
+                (candidateAdapter === undefined
+                    ? ordinal(left.checked.article.articleId, right.checked.article.articleId)
+                    : left.firstSeen - right.firstSeen));
+            return confirmed.slice(0, resultLimit).map(({ checked }) => checked);
+        }
+        async function sourceResult(checked, fitWholeArticles = false) {
+            if (checked.length === 0 || typeof tokenCounter?.count !== "function")
+                return noSources();
+            for (let count = checked.length; count > 0; count -= 1) {
+                const selected = checked.slice(0, count);
+                const sources = selected.map(sourceOf);
+                const serializedSources = canonicalJson(sources);
+                if (new TextEncoder().encode(serializedSources).byteLength <=
+                    limits.maxContentBytes) {
+                    let sourceTokens;
+                    try {
+                        sourceTokens = tokenCounter.count(serializedSources);
+                    }
+                    catch {
+                        return noSources();
+                    }
+                    if (!Number.isSafeInteger(sourceTokens) || sourceTokens <= 0)
+                        return noSources();
+                    if (sourceTokens <= limits.maxSourceTokens) {
+                        for (const source of selected)
+                            await checker.recheck(source);
+                        return {
+                            outcome: "results",
+                            sources,
+                            serializedSources,
+                            sourceTokens,
+                        };
+                    }
+                }
+                // Select only complete top-ranked articles; an exact citation list
+                // instead remains all-or-nothing during reconfirmation.
+                if (!fitWholeArticles)
+                    return noSources();
+            }
+            return noSources();
+        }
+        return {
+            budget,
+            repository,
+            index,
+            checker,
+            authorizeCollection,
+            search,
+            sourceResult,
+        };
+    }
+    function queryTerms(query) {
+        if (typeof query !== "string" || query.length > limits.maxQueryCharacters) {
+            throw new TypeError("Query exceeds its configured character bound");
+        }
+        const terms = normalizeQuery(query);
+        if (terms.length > limits.maxQueryTerms)
+            throw new TypeError("Query exceeds its configured term bound");
+        return terms;
+    }
+    return {
+        async listPortalCollections(access, request) {
+            const caller = snapshotData(access);
+            const query = inputSnapshot(request, ["limit"]);
+            const limit = requestedLimit(query.limit, limits.maxDirectoryCollections);
+            if (!mayRead(caller, "portal"))
+                return noCollections();
+            try {
+                const scope = requestScope();
+                const ids = await scope.index.readDirectory();
+                if (ids.length > limits.maxDirectoryCollections)
+                    return noCollections();
+                const authorized = [];
+                for (const id of ids) {
+                    requireIdentifier(id, "collectionId");
+                    const collection = await scope.authorizeCollection(caller, id, "portal");
+                    if (collection !== null)
+                        authorized.push(collection);
+                }
+                const selected = authorized
+                    .sort((left, right) => ordinal(left.scope.collectionId, right.scope.collectionId))
+                    .slice(0, limit);
+                for (const collection of selected) {
+                    if ((await scope.repository.readResourceGeneration("collection", collection.scope.collectionId)) !== collection.governanceGeneration) {
+                        return noCollections();
+                    }
+                }
+                return selected.length === 0
+                    ? noCollections()
+                    : {
+                        outcome: "results",
+                        collections: selected.map((collection) => ({
+                            collectionId: collection.scope.collectionId,
+                            label: collection.label,
+                        })),
+                    };
+            }
+            catch {
+                return noCollections();
+            }
+        },
+        async searchPublishedArticles(access, request) {
+            const caller = snapshotData(access);
+            const query = inputSnapshot(request, [
+                "collectionId",
+                "query",
+                "applicability",
+                "limit",
+            ]);
+            requireIdentifier(query.collectionId, "collectionId");
+            const terms = queryTerms(query.query);
+            const applicability = applicabilitySnapshot(query.applicability);
+            const limit = requestedLimit(query.limit, limits.maxResults);
+            try {
+                const scope = requestScope();
+                const checked = await scope.search(caller, [query.collectionId], terms, applicability, "portal", limit);
+                const articles = checked.map(portalArticleOf);
+                if (articles.length === 0 ||
+                    new TextEncoder().encode(canonicalJson(articles)).byteLength >
+                        limits.maxContentBytes)
+                    return noPortalResult();
+                for (const article of checked)
+                    await scope.checker.recheck(article);
+                return { outcome: "results", articles };
+            }
+            catch {
+                return noPortalResult();
+            }
+        },
+        async retrieveAnswerSources(effectiveCustomerAccess, request) {
+            const caller = snapshotData(effectiveCustomerAccess);
+            const query = inputSnapshot(request, [
+                "collectionIds",
+                "query",
+                "applicability",
+                "limit",
+            ]);
+            if (!Array.isArray(query.collectionIds) ||
+                query.collectionIds.length === 0 ||
+                query.collectionIds.length > limits.maxBotCollections) {
+                throw new TypeError("Bot retrieval exceeds its collection bound");
+            }
+            for (const id of query.collectionIds)
+                requireIdentifier(id, "collectionId");
+            if (new Set(query.collectionIds).size !== query.collectionIds.length)
+                throw new TypeError("Collection ids must be unique");
+            const terms = queryTerms(query.query);
+            const applicability = applicabilitySnapshot(query.applicability);
+            const limit = requestedLimit(query.limit, limits.maxResults);
+            if (typeof tokenCounter?.count !== "function")
+                return noSources();
+            try {
+                const scope = requestScope();
+                return await scope.sourceResult(await scope.search(caller, query.collectionIds, terms, applicability, "bot", limit), true);
+            }
+            catch {
+                return noSources();
+            }
+        },
+        async confirmAnswerSources(effectiveCustomerAccess, request) {
+            const caller = snapshotData(effectiveCustomerAccess);
+            const query = inputSnapshot(request, ["references", "applicability"]);
+            const applicability = applicabilitySnapshot(query.applicability);
+            if (!Array.isArray(query.references) ||
+                query.references.length === 0 ||
+                query.references.length > limits.maxResults) {
+                throw new TypeError("Citation references exceed their result bound");
+            }
+            for (const reference of query.references)
+                validateReference(reference);
+            if (new Set(query.references.map((reference) => reference.articleId))
+                .size !== query.references.length ||
+                new Set(query.references.map((reference) => reference.collectionId))
+                    .size > limits.maxBotCollections)
+                throw new TypeError("Citation references must have unique articles and bounded collections");
+            if (typeof tokenCounter?.count !== "function" || !mayRead(caller, "bot"))
+                return noSources();
+            try {
+                const scope = requestScope();
+                for (const collectionId of new Set(query.references.map((reference) => reference.collectionId))) {
+                    if ((await scope.authorizeCollection(caller, collectionId, "bot")) ===
+                        null)
+                        return noSources();
+                }
+                const checked = [];
+                for (const reference of query.references) {
+                    scope.budget.candidateHead();
+                    if ((await scope.repository.readResourceGeneration("article", reference.articleId)) !== reference.applicationGeneration)
+                        return noSources();
+                    scope.budget.confirmation();
+                    const confirmed = await scope.checker.check({
+                        articleId: reference.articleId,
+                        purpose: "bot",
+                        access: caller,
+                        applicability,
+                    });
+                    if (canonicalJson(referenceOf(confirmed)) !== canonicalJson(reference))
+                        return noSources();
+                    checked.push(confirmed);
+                }
+                return await scope.sourceResult(checked);
+            }
+            catch {
+                return noSources();
+            }
+        },
+    };
+}
+//# sourceMappingURL=retrieval.js.map

package/dist/retrieval.js.map

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

package/dist/storage-helpers.d.ts

@@ -0,0 +1,23 @@
+import type { StoredRecord } from "@pegma/storage-core";
+export declare class RepositoryConflictError extends Error {
+    readonly name = "RepositoryConflictError";
+    constructor();
+}
+export declare class RepositoryCapacityError extends Error {
+    readonly budget: string;
+    readonly name = "RepositoryCapacityError";
+    constructor(budget: string);
+}
+export declare class RepositoryIntegrityError extends Error {
+    readonly name = "RepositoryIntegrityError";
+    constructor();
+}
+/** Snapshots data properties only; no getters, sparse arrays, or JSON coercion. */
+export declare function canonicalJson(value: unknown): string;
+export declare function snapshotData<T>(value: T): T;
+export declare function fingerprint(value: unknown): Promise<string>;
+export declare const commandFingerprint: typeof fingerprint;
+export declare function requireIdentifier(value: string, field?: string): void;
+export declare function requireGeneration(value: number, minimum?: number): void;
+export declare function encodedBytes(record: StoredRecord): number;
+//# sourceMappingURL=storage-helpers.d.ts.map

package/dist/storage-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-helpers.d.ts","sourceRoot":"","sources":["../src/storage-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,SAAkB,IAAI,6BAA6B;IACnD,cAEC;CACF;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IAEpC,QAAQ,CAAC,MAAM,EAAE,MAAM;IADnC,SAAkB,IAAI,6BAA6B;IACnD,YAAqB,MAAM,EAAE,MAAM,EAElC;CACF;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,SAAkB,IAAI,8BAA8B;IACpD,cAEC;CACF;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAqFpD;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAE3C;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAMjE;AAED,eAAO,MAAM,kBAAkB,oBAAc,CAAC;AAE9C,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAe,GAAG,IAAI,CAoB3E;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,SAAI,GAAG,IAAI,CAIlE;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAEzD"}