@pegma/knowledge-base-mcp 0.0.0-stage → 0.1.1

package/dist/schemas.js

@@ -0,0 +1,416 @@
+import { articleKinds } from "@pegma/knowledge-base-contracts";
+import { knowledgeLimits } from "@pegma/knowledge-base-core";
+import { z } from "zod";
+import { KnowledgeAgentBoundaryError } from "./errors.js";
+import { defaultKnowledgeAgentLimits, minimumKnowledgeAgentResponseBytes, } from "./types.js";
+const boundedText = (maximum) => z
+    .string()
+    .min(1)
+    .max(maximum)
+    .regex(/^[^\s\u0000-\u001f\u007f](?:[^\u0000-\u001f\u007f]*[^\s\u0000-\u001f\u007f])?$/u)
+    .regex(/^[^\ud800-\udfff]*$/u);
+const identifier = boundedText(knowledgeLimits.identifierCharacters);
+const generation = z.number().int().min(0).max(Number.MAX_SAFE_INTEGER);
+const positiveInteger = z.number().int().min(1).max(Number.MAX_SAFE_INTEGER);
+const hash = z.string().regex(/^[a-f0-9]{64}$/u);
+const kind = z.enum(articleKinds);
+const applicability = z
+    .object({
+    productId: identifier,
+    productVersion: identifier,
+    buildId: identifier.optional(),
+    locale: z.string().min(1).max(64).optional(),
+})
+    .strict();
+const content = z
+    .object({
+    format: z.enum(["markdown", "plain_text"]),
+    text: z.string().min(1).max(knowledgeLimits.contentBytes),
+})
+    .strict();
+const validationPolicy = z
+    .object({ id: identifier, version: positiveInteger })
+    .strict();
+const articleDraft = z
+    .object({
+    kind,
+    title: z.string().min(1).max(knowledgeLimits.titleCharacters),
+    summary: z.string().min(1).max(knowledgeLimits.summaryCharacters),
+    content,
+    tags: z
+        .array(z.string().min(1).max(knowledgeLimits.tagCharacters))
+        .max(knowledgeLimits.tags),
+    applicability,
+})
+    .strict();
+const evidenceSubmission = z
+    .object({
+    id: identifier,
+    articleId: identifier,
+    articleRevision: positiveInteger,
+    contentHash: hash,
+    validationPolicy,
+    checkId: identifier,
+    testKind: identifier,
+    applicability,
+    stagingBuildId: identifier,
+    steps: z
+        .array(z.string().min(1).max(knowledgeLimits.stepCharacters))
+        .min(1)
+        .max(knowledgeLimits.steps),
+    result: z.enum(["passed", "failed", "inconclusive"]),
+    executedAt: z.string().min(1).max(64),
+    runnerId: identifier,
+    artifacts: z
+        .array(z.object({ id: identifier, hash }).strict())
+        .max(knowledgeLimits.artifacts),
+})
+    .strict();
+const command = {
+    commandId: identifier,
+    correlationId: identifier,
+    expectedGeneration: generation,
+};
+/** Shared strict schemas; HTTP and MCP must use the same dispatcher. */
+export const knowledgeAgentInputSchemas = Object.freeze({
+    getDraft: z.object({ articleId: identifier }).strict(),
+    createDraft: z
+        .object({
+        ...command,
+        expectedGeneration: z.literal(0),
+        articleId: identifier,
+        collectionId: identifier,
+        draft: articleDraft,
+    })
+        .strict(),
+    updateDraft: z
+        .object({
+        ...command,
+        articleId: identifier,
+        collectionId: identifier,
+        draft: articleDraft,
+    })
+        .strict(),
+    getValidationRequirements: z
+        .object({ collectionId: identifier, kind })
+        .strict(),
+    submitEvidence: z
+        .object({
+        ...command,
+        articleId: identifier,
+        evidence: evidenceSubmission,
+        receipt: boundedText(8_192).refine((value) => new TextEncoder().encode(value).byteLength <= 8_192),
+    })
+        .strict(),
+});
+export const knowledgeAgentEnvelopeSchema = z.discriminatedUnion("operation", [
+    z
+        .object({
+        apiVersion: z.literal("1"),
+        operation: z.literal("getDraft"),
+        input: knowledgeAgentInputSchemas.getDraft,
+    })
+        .strict(),
+    z
+        .object({
+        apiVersion: z.literal("1"),
+        operation: z.literal("createDraft"),
+        input: knowledgeAgentInputSchemas.createDraft,
+    })
+        .strict(),
+    z
+        .object({
+        apiVersion: z.literal("1"),
+        operation: z.literal("updateDraft"),
+        input: knowledgeAgentInputSchemas.updateDraft,
+    })
+        .strict(),
+    z
+        .object({
+        apiVersion: z.literal("1"),
+        operation: z.literal("getValidationRequirements"),
+        input: knowledgeAgentInputSchemas.getValidationRequirements,
+    })
+        .strict(),
+    z
+        .object({
+        apiVersion: z.literal("1"),
+        operation: z.literal("submitEvidence"),
+        input: knowledgeAgentInputSchemas.submitEvidence,
+    })
+        .strict(),
+]);
+// Output schemas deliberately construct purpose-specific DTOs. Extra private
+// fields from an application wrapper never become transport response fields.
+const articleState = z.enum(["draft", "in-review", "published", "retired"]);
+const revision = articleDraft
+    .extend({
+    articleId: identifier,
+    number: positiveInteger,
+    collectionId: identifier,
+    validationPolicy: validationPolicy.strip(),
+    contentHash: hash,
+    createdBy: identifier,
+    createdAt: z.string().min(1).max(64),
+    content: content.strip(),
+    applicability: applicability.strip(),
+})
+    .strip();
+const acknowledgement = z
+    .object({
+    value: z
+        .object({
+        id: identifier,
+        generation: positiveInteger,
+        articleRevision: positiveInteger,
+        state: articleState,
+        contentHash: hash,
+    })
+        .strip(),
+    replayed: z.boolean(),
+})
+    .strip();
+export const knowledgeAgentResultSchemas = Object.freeze({
+    getDraft: z
+        .object({
+        articleId: identifier,
+        generation: positiveInteger,
+        state: articleState,
+        revision,
+        hasPendingReview: z.boolean(),
+        hasPublication: z.boolean(),
+        publicationHeld: z.boolean(),
+    })
+        .strip(),
+    createDraft: acknowledgement,
+    updateDraft: acknowledgement,
+    getValidationRequirements: z
+        .object({
+        collectionId: identifier,
+        governanceGeneration: positiveInteger,
+        validationPolicy: validationPolicy.strip(),
+        expectedStagingBuildId: identifier,
+        checks: z
+            .array(z
+            .object({
+            id: identifier,
+            testKind: identifier,
+            maxAgeMilliseconds: positiveInteger,
+        })
+            .strip())
+            .max(knowledgeLimits.requirements),
+    })
+        .strip(),
+    submitEvidence: acknowledgement,
+});
+export function resolveKnowledgeAgentLimits(requested = {}) {
+    if (requested === null ||
+        typeof requested !== "object" ||
+        ![Object.prototype, null].includes(Object.getPrototypeOf(requested))) {
+        throw new TypeError("Invalid knowledge agent limits");
+    }
+    const result = { ...defaultKnowledgeAgentLimits };
+    for (const key of Reflect.ownKeys(requested)) {
+        if (typeof key !== "string" || !Object.hasOwn(result, key)) {
+            throw new TypeError("Unknown knowledge agent limit");
+        }
+        const descriptor = Object.getOwnPropertyDescriptor(requested, key);
+        if (descriptor === undefined || !("value" in descriptor)) {
+            throw new TypeError("Invalid knowledge agent limit");
+        }
+        const value = descriptor.value;
+        const name = key;
+        if (typeof value !== "number" ||
+            !Number.isSafeInteger(value) ||
+            value <= 0 ||
+            value > defaultKnowledgeAgentLimits[name] ||
+            (name === "maxResponseBytes" &&
+                value < minimumKnowledgeAgentResponseBytes)) {
+            throw new TypeError("Knowledge agent limits may only reduce ceilings");
+        }
+        result[name] = value;
+    }
+    return Object.freeze(result);
+}
+/**
+ * Detach only plain JSON data properties, with work/encoded-byte accounting
+ * before Zod reads them. Accessors, sparse arrays, cycles, symbols, and custom
+ * prototypes are rejected without invoking JSON coercion or a getter.
+ */
+export function snapshotKnowledgeAgentJson(value, limits, maximumBytes = limits.maxRequestBytes) {
+    const ancestors = new Set();
+    let nodes = 0;
+    let bytes = 0;
+    const reserve = (count) => {
+        bytes += count;
+        if (bytes > maximumBytes)
+            throw new KnowledgeAgentBoundaryError("capacity");
+    };
+    const encodedText = (item) => {
+        if (item.length > maximumBytes)
+            throw new KnowledgeAgentBoundaryError("capacity");
+        const encoded = JSON.stringify(item);
+        if (encoded.length > maximumBytes)
+            throw new KnowledgeAgentBoundaryError("capacity");
+        reserve(new TextEncoder().encode(encoded).byteLength);
+    };
+    const visit = (item, depth) => {
+        nodes += 1;
+        if (nodes > limits.maxNodes || depth > limits.maxDepth)
+            throw new KnowledgeAgentBoundaryError("capacity");
+        if (item === null) {
+            reserve(4);
+            return item;
+        }
+        if (typeof item === "string") {
+            encodedText(item);
+            return item;
+        }
+        if (typeof item === "boolean") {
+            reserve(item ? 4 : 5);
+            return item;
+        }
+        if (typeof item === "number" && Number.isFinite(item)) {
+            reserve(String(item).length);
+            return item;
+        }
+        if (typeof item !== "object" || ancestors.has(item))
+            throw new KnowledgeAgentBoundaryError("invalid_request");
+        ancestors.add(item);
+        try {
+            if (Array.isArray(item)) {
+                if (item.length > limits.maxArrayLength)
+                    throw new KnowledgeAgentBoundaryError("capacity");
+                const keys = Reflect.ownKeys(item);
+                if (keys.length !== item.length + 1)
+                    throw new KnowledgeAgentBoundaryError("invalid_request");
+                reserve(2 + Math.max(0, item.length - 1));
+                const output = [];
+                for (let index = 0; index < item.length; index += 1) {
+                    const property = Object.getOwnPropertyDescriptor(item, String(index));
+                    if (property === undefined ||
+                        !("value" in property) ||
+                        !property.enumerable) {
+                        throw new KnowledgeAgentBoundaryError("invalid_request");
+                    }
+                    output.push(visit(property.value, depth + 1));
+                }
+                return Object.freeze(output);
+            }
+            if (![Object.prototype, null].includes(Object.getPrototypeOf(item)))
+                throw new KnowledgeAgentBoundaryError("invalid_request");
+            const keys = Reflect.ownKeys(item);
+            if (keys.length > limits.maxObjectKeys)
+                throw new KnowledgeAgentBoundaryError("capacity");
+            reserve(2 + Math.max(0, keys.length - 1));
+            const output = Object.create(null);
+            for (const key of keys) {
+                if (typeof key !== "string")
+                    throw new KnowledgeAgentBoundaryError("invalid_request");
+                const property = Object.getOwnPropertyDescriptor(item, key);
+                if (property === undefined ||
+                    !("value" in property) ||
+                    !property.enumerable) {
+                    throw new KnowledgeAgentBoundaryError("invalid_request");
+                }
+                encodedText(key);
+                reserve(1);
+                output[key] = visit(property.value, depth + 1);
+            }
+            return Object.freeze(output);
+        }
+        finally {
+            ancestors.delete(item);
+        }
+    };
+    return visit(value, 0);
+}
+/** Bound UTF-8 bytes and every structural ceiling before invoking JSON.parse. */
+export function parseKnowledgeAgentJson(source, requested) {
+    const limits = resolveKnowledgeAgentLimits(requested);
+    if (typeof source !== "string")
+        throw new KnowledgeAgentBoundaryError("invalid_request");
+    if (source.length > limits.maxRequestBytes ||
+        new TextEncoder().encode(source).byteLength > limits.maxRequestBytes) {
+        throw new KnowledgeAgentBoundaryError("capacity");
+    }
+    const frames = [];
+    const beginValue = () => {
+        const frame = frames.at(-1);
+        if (frame?.kind === "array" && frame.expectsValue) {
+            frame.entries += 1;
+            frame.expectsValue = false;
+            if (frame.entries > limits.maxArrayLength)
+                throw new KnowledgeAgentBoundaryError("capacity");
+        }
+    };
+    let nodes = 0;
+    let quoted = false;
+    let escaped = false;
+    let primitive = false;
+    for (const character of source) {
+        if (quoted) {
+            if (escaped)
+                escaped = false;
+            else if (character === "\\")
+                escaped = true;
+            else if (character === '"')
+                quoted = false;
+            continue;
+        }
+        if (character === '"') {
+            beginValue();
+            quoted = true;
+            primitive = false;
+            nodes += 1;
+        }
+        else if (character === "{" || character === "[") {
+            beginValue();
+            frames.push(character === "["
+                ? { kind: "array", entries: 0, expectsValue: true }
+                : { kind: "object", keys: 0 });
+            nodes += 1;
+            primitive = false;
+        }
+        else if (character === "}" || character === "]") {
+            frames.pop();
+            primitive = false;
+        }
+        else if (character === ",") {
+            const frame = frames.at(-1);
+            if (frame?.kind === "array")
+                frame.expectsValue = true;
+            primitive = false;
+        }
+        else if (character === ":") {
+            // For valid JSON, each structural colon belongs to exactly one object
+            // key. Counting physical keys also bounds duplicate-key parse work.
+            const frame = frames.at(-1);
+            if (frame?.kind === "object") {
+                frame.keys += 1;
+                if (frame.keys > limits.maxObjectKeys)
+                    throw new KnowledgeAgentBoundaryError("capacity");
+            }
+            primitive = false;
+        }
+        else if (/\s/u.test(character)) {
+            primitive = false;
+        }
+        else if (!primitive) {
+            beginValue();
+            primitive = true;
+            nodes += 1;
+        }
+        if (frames.length > limits.maxDepth || nodes > limits.maxNodes)
+            throw new KnowledgeAgentBoundaryError("capacity");
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(source);
+    }
+    catch {
+        throw new KnowledgeAgentBoundaryError("invalid_request");
+    }
+    return snapshotKnowledgeAgentJson(parsed, limits);
+}
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

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

package/dist/transport-common.d.ts

@@ -0,0 +1,57 @@
+import type { KnowledgeAgentIdentity, KnowledgeAgentLimits } from "./types.js";
+export type KnowledgeAgentTransport = "http" | "mcp";
+export interface KnowledgeAgentLimitDecision {
+    readonly allowed: boolean;
+    readonly retryAfterSeconds?: number;
+}
+/** Ports receive the original request; neither a cookie nor body is authority. */
+export interface KnowledgeAgentTransportOptions {
+    /** Canonical protected MCP resource, shared by both agent transports. */
+    readonly resource: string;
+    /** Host-owned Agent Access protected-resource metadata; never served here. */
+    readonly protectedResourceMetadataUrl: string;
+    /** Exact serialized origins. Originless native clients are also accepted. */
+    readonly allowedOrigins: readonly string[];
+    /**
+     * Authenticate the bearer credential, issuer, client, exact resource, expiry,
+     * revocation and current principal. Re-resolve authority on every request.
+     * Rejections are normalized: response bodies and host headers are discarded.
+     */
+    readonly authenticate: (request: Request) => KnowledgeAgentIdentity | Response | Promise<KnowledgeAgentIdentity | Response>;
+    /** Required host admission port, called before authentication or body reads. */
+    readonly limit: (request: Request, context: Readonly<{
+        transport: KnowledgeAgentTransport;
+    }>) => boolean | KnowledgeAgentLimitDecision | Promise<boolean | KnowledgeAgentLimitDecision>;
+    /** For synthetic loopback composition only; production endpoints use HTTPS. */
+    readonly allowInsecureLoopback?: boolean;
+}
+export interface KnowledgeAgentTransportConfiguration {
+    readonly transport: KnowledgeAgentTransport;
+    readonly endpointUrl: string;
+    readonly endpointOrigin: string;
+    readonly endpointPath: string;
+    readonly endpointHost: string;
+    readonly endpointProtocol: string;
+    readonly resource: string;
+    readonly protectedResourceMetadataUrl: string;
+    readonly allowedOrigins: readonly string[];
+    readonly authenticate: KnowledgeAgentTransportOptions["authenticate"];
+    readonly limit: KnowledgeAgentTransportOptions["limit"];
+}
+export type KnowledgeAgentTransportErrorCode = "invalid_request" | "invalid_token" | "forbidden" | "temporarily_unavailable" | "unavailable" | "capacity" | "method_not_allowed" | "unsupported_media_type";
+/** Validate and snapshot host configuration once, before accepting requests. */
+export declare function validateKnowledgeAgentTransportOptions(options: KnowledgeAgentTransportOptions, endpointUrl: string, transport: KnowledgeAgentTransport): KnowledgeAgentTransportConfiguration;
+/** A matching path is claimed so a hostile authority cannot bypass admission. */
+export declare function knowledgeAgentRequestMatches(request: Request, configuration: KnowledgeAgentTransportConfiguration): boolean;
+/** Replace implicit CORS and caching with this endpoint's explicit policy. */
+export declare function secureKnowledgeAgentResponse(response: Response, request: Request, configuration: KnowledgeAgentTransportConfiguration): Response;
+export declare function knowledgeAgentTransportError(code: KnowledgeAgentTransportErrorCode, request: Request, configuration: KnowledgeAgentTransportConfiguration, retryAfterSeconds?: number): Response;
+/** Shared HTTP/MCP admission. No untrusted body is read by this function. */
+export declare function authorizeKnowledgeAgentRequest(request: Request, configuration: KnowledgeAgentTransportConfiguration): Promise<KnowledgeAgentIdentity | Response>;
+/** Read actual bytes/chunks before decoding or parsing; never trust Length alone. */
+export declare function readKnowledgeAgentJsonRequest(request: Request, limits: KnowledgeAgentLimits): Promise<{
+    readonly value: unknown;
+} | Response>;
+/** Serialize only complete bounded messages; never truncate application results. */
+export declare function knowledgeAgentJsonResponse(value: unknown, status: number, maxBytes: number, request: Request, configuration: KnowledgeAgentTransportConfiguration): Response;
+//# sourceMappingURL=transport-common.d.ts.map

package/dist/transport-common.d.ts.map

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