mcprigor 1.0.0-rc.1

package/dist/extension-host.js

@@ -0,0 +1,52 @@
+import { resolve } from "node:path";
+import { Worker } from "node:worker_threads";
+export async function inspectExtension(modulePath, options = {}) {
+    const absolute = resolve(options.cwd ?? process.cwd(), modulePath);
+    const value = await workerCall(absolute, { kind: "inspect" }, options);
+    if (value.manifest)
+        validateManifest(value.manifest, options.permissions ?? []);
+    return { modulePath: absolute, ...value };
+}
+export async function callIsolatedFunction(modulePath, name, args, options = {}) {
+    const descriptor = await inspectExtension(modulePath, options);
+    if (!descriptor.functions.includes(name))
+        throw new Error(`MCP-EXT-102 Extension does not declare function “${name}”`);
+    return workerCall(descriptor.modulePath, { kind: "function", name, args }, options);
+}
+export async function callIsolatedProvider(modulePath, config, context, options = {}) {
+    const descriptor = await inspectExtension(modulePath, options);
+    if (!descriptor.provider)
+        throw new Error("MCP-EXT-103 Extension does not declare a data provider");
+    const value = await workerCall(descriptor.modulePath, { kind: "provider", config, context }, options);
+    if (!Array.isArray(value))
+        throw new Error("MCP-EXT-104 Provider result must be an array");
+    return value;
+}
+function validateManifest(manifest, granted) {
+    if (manifest.schemaVersion !== 1 || !manifest.name || !manifest.version)
+        throw new Error("MCP-EXT-100 Invalid extension manifest");
+    const denied = (manifest.permissions ?? []).filter((permission) => !granted.includes(permission));
+    if (denied.length)
+        throw new Error(`MCP-EXT-101 Extension “${manifest.name}” requires permissions not granted: ${denied.join(", ")}`);
+}
+function workerCall(modulePath, payload, options) {
+    return new Promise((resolvePromise, reject) => {
+        const built = new URL("./extension-worker.js", import.meta.url);
+        const source = new URL("./extension-worker.ts", import.meta.url);
+        const worker = new Worker(import.meta.url.endsWith(".ts") ? source : built, { execArgv: import.meta.url.endsWith(".ts") ? ["--import", "tsx"] : [], workerData: { modulePath, ...payload }, resourceLimits: { maxOldGenerationSizeMb: options.maxOldGenerationSizeMb ?? 64 } });
+        const timeout = setTimeout(() => { void worker.terminate(); reject(new Error(`MCP-EXT-105 Isolated extension exceeded ${options.timeoutMs ?? 5000}ms`)); }, options.timeoutMs ?? 5000);
+        worker.once("message", (message) => { clearTimeout(timeout); void worker.terminate(); if (message.ok) {
+            try {
+                JSON.stringify(message.value);
+                resolvePromise(message.value);
+            }
+            catch {
+                reject(new Error("MCP-EXT-106 Extension returned a non-JSON value"));
+            }
+        }
+        else
+            reject(new Error(`MCP-EXT-107 ${message.error?.message ?? "Extension failed"}`)); });
+        worker.once("error", (error) => { clearTimeout(timeout); reject(new Error(`MCP-EXT-108 Worker failed: ${error.message}`)); });
+    });
+}
+//# sourceMappingURL=extension-host.js.map

package/dist/extension-host.js.map

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

package/dist/extension-sdk.d.ts

@@ -0,0 +1,22 @@
+export type ExtensionPermission = "environment" | "filesystem-read" | "network";
+export interface ExtensionManifest {
+    schemaVersion: 1;
+    name: string;
+    version: string;
+    permissions?: ExtensionPermission[];
+    functions?: string[];
+    provider?: boolean;
+}
+export interface ExtensionFunctionContext {
+    signal?: AbortSignal;
+}
+export type ExtensionFunction = (args: Record<string, unknown>, context?: ExtensionFunctionContext) => unknown | Promise<unknown>;
+export interface ExtensionDataProvider {
+    load(config: Record<string, unknown>, context: {
+        cwd: string;
+        maxRows: number;
+    }): Promise<Record<string, unknown>[]>;
+}
+export declare function defineExtension<T extends Record<string, unknown>>(extension: T): T;
+export declare function defineManifest(manifest: ExtensionManifest): ExtensionManifest;
+//# sourceMappingURL=extension-sdk.d.ts.map

package/dist/extension-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-sdk.d.ts","sourceRoot":"","sources":["../src/extension-sdk.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG,iBAAiB,GAAG,SAAS,CAAC;AAChF,MAAM,WAAW,iBAAiB;IAAG,aAAa,EAAE,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE;AACrK,MAAM,WAAW,wBAAwB;IAAG,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE;AAClE,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,wBAAwB,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAClI,MAAM,WAAW,qBAAqB;IAAG,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAA;CAAE;AAC/J,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC,GAAG,CAAC,CAAsB;AACzG,wBAAgB,cAAc,CAAC,QAAQ,EAAE,iBAAiB,GAAG,iBAAiB,CAAqB"}

package/dist/extension-sdk.js

@@ -0,0 +1,3 @@
+export function defineExtension(extension) { return extension; }
+export function defineManifest(manifest) { return manifest; }
+//# sourceMappingURL=extension-sdk.js.map

package/dist/extension-sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-sdk.js","sourceRoot":"","sources":["../src/extension-sdk.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,eAAe,CAAoC,SAAY,IAAO,OAAO,SAAS,CAAC,CAAC,CAAC;AACzG,MAAM,UAAU,cAAc,CAAC,QAA2B,IAAuB,OAAO,QAAQ,CAAC,CAAC,CAAC"}

package/dist/extension-worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=extension-worker.d.ts.map

package/dist/extension-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-worker.d.ts","sourceRoot":"","sources":["../src/extension-worker.ts"],"names":[],"mappings":""}

package/dist/extension-worker.js

@@ -0,0 +1,27 @@
+import { parentPort, workerData } from "node:worker_threads";
+import { pathToFileURL } from "node:url";
+const input = workerData;
+try {
+    const imported = await import(pathToFileURL(input.modulePath).href);
+    const manifest = imported.manifest ?? imported.default?.manifest;
+    if (input.kind === "inspect") {
+        const functions = manifest?.functions ?? Object.entries(imported).filter(([name, value]) => name !== "manifest" && typeof value === "function").map(([name]) => name);
+        parentPort.postMessage({ ok: true, value: { manifest, functions, provider: Boolean(manifest?.provider || imported.provider?.load || imported.default?.load) } });
+    }
+    else if (input.kind === "function") {
+        const fn = imported[input.name] ?? imported.default?.functions?.[input.name];
+        if (typeof fn !== "function")
+            throw new Error(`Function “${input.name}” is not exported`);
+        parentPort.postMessage({ ok: true, value: await fn(input.args ?? {}) });
+    }
+    else {
+        const provider = imported.provider ?? imported.default;
+        if (!provider?.load)
+            throw new Error("Extension does not export a provider with load()");
+        parentPort.postMessage({ ok: true, value: await provider.load(input.config ?? {}, input.context ?? { cwd: ".", maxRows: 1000 }) });
+    }
+}
+catch (error) {
+    parentPort.postMessage({ ok: false, error: { name: error instanceof Error ? error.name : "Error", message: error instanceof Error ? error.message : String(error), stack: error instanceof Error ? error.stack : undefined } });
+}
+//# sourceMappingURL=extension-worker.js.map

package/dist/extension-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-worker.js","sourceRoot":"","sources":["../src/extension-worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,MAAM,KAAK,GAAG,UAAmB,CAAC;AAClC,IAAI,CAAC;IACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAwB,CAAC;IAC3F,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IACjE,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,QAAQ,EAAE,SAAS,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,UAAU,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;QACtK,UAAW,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,IAAI,QAAQ,CAAC,QAAQ,EAAE,IAAI,IAAI,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IACpK,CAAC;SAAM,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACrC,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAK,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC,KAAK,CAAC,IAAK,CAAC,CAAC;QAC/E,IAAI,OAAO,EAAE,KAAK,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,aAAa,KAAK,CAAC,IAAI,mBAAmB,CAAC,CAAC;QAC1F,UAAW,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;SAAM,CAAC;QACN,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,OAAO,CAAC;QACvD,IAAI,CAAC,QAAQ,EAAE,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACzF,UAAW,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IACtI,CAAC;AACH,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,UAAW,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;AACnO,CAAC"}

package/dist/extensions.d.ts

@@ -0,0 +1,15 @@
+import type { ExtensionPermission } from "./extension-sdk.js";
+export type UtilityFunction = (args: Record<string, unknown>) => unknown | Promise<unknown>;
+export interface FunctionRegistryOptions {
+    modules?: string[];
+    allowCustomCode?: boolean;
+    timeoutMs?: number;
+    cwd?: string;
+    permissions?: ExtensionPermission[];
+    unsafeLegacy?: boolean;
+    allowlist?: string[];
+}
+export declare function createFunctionRegistry(options?: FunctionRegistryOptions): Promise<Map<string, UtilityFunction>>;
+export declare function callUtility(registry: Map<string, UtilityFunction>, name: string, args: Record<string, unknown>, timeoutMs?: number): Promise<unknown>;
+export declare function builtinNames(): string[];
+//# sourceMappingURL=extensions.d.ts.map

package/dist/extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../src/extensions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAkB5F,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACpC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,wBAAsB,sBAAsB,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAgBzH;AAED,wBAAsB,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,SAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAUzJ;AAED,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAAyC"}

package/dist/extensions.js

@@ -0,0 +1,60 @@
+import { pathToFileURL } from "node:url";
+import { createHash } from "node:crypto";
+import { callIsolatedFunction, inspectExtension } from "./extension-host.js";
+const builtins = {
+    lowercase: ({ value }) => String(value).toLowerCase(),
+    uppercase: ({ value }) => String(value).toUpperCase(),
+    trim: ({ value }) => String(value).trim(),
+    join: ({ values, separator = "" }) => (Array.isArray(values) ? values : []).join(String(separator)),
+    replace: ({ value, find, replacement = "" }) => String(value).split(String(find)).join(String(replacement)),
+    length: ({ value }) => typeof value === "string" || Array.isArray(value) ? value.length : value && typeof value === "object" ? Object.keys(value).length : 0,
+    number: ({ value }) => { const result = Number(value); if (!Number.isFinite(result))
+        throw new Error(`cannot convert ${String(value)} to a number`); return result; },
+    text: ({ value }) => typeof value === "string" ? value : JSON.stringify(value),
+    json: ({ value }) => typeof value === "string" ? JSON.parse(value) : value,
+    round: ({ value, digits = 0 }) => { const scale = 10 ** Number(digits); return Math.round(Number(value) * scale) / scale; },
+    urlEncode: ({ value }) => encodeURIComponent(String(value)),
+    base64: ({ value }) => Buffer.from(String(value)).toString("base64"),
+    hash: ({ value, algorithm = "sha256" }) => createHash(String(algorithm)).update(String(value)).digest("hex"),
+};
+export async function createFunctionRegistry(options = {}) {
+    const functions = new Map(Object.entries(builtins));
+    const modules = options.modules ?? [];
+    if (modules.length && !options.allowCustomCode)
+        throw new Error("MCP-EXT-001 Custom functions are configured but not enabled. Add --allow-custom-code after reviewing them.");
+    for (const modulePath of modules) {
+        if (options.allowlist && !options.allowlist.includes(modulePath))
+            throw new Error(`MCP-EXT-109 Extension “${modulePath}” is not in the reviewed allowlist`);
+        if (options.unsafeLegacy) {
+            const url = modulePath.startsWith("file:") ? modulePath : pathToFileURL(`${options.cwd ?? process.cwd()}/${modulePath}`.replace(/\/+/g, "/")).href;
+            const imported = await import(url);
+            for (const [name, value] of Object.entries(imported))
+                if (typeof value === "function")
+                    functions.set(name, value);
+            continue;
+        }
+        const descriptor = await inspectExtension(modulePath, { cwd: options.cwd, timeoutMs: options.timeoutMs, permissions: options.permissions });
+        for (const name of descriptor.functions)
+            functions.set(name, (args) => callIsolatedFunction(modulePath, name, args, { cwd: options.cwd, timeoutMs: options.timeoutMs, permissions: options.permissions }));
+    }
+    return functions;
+}
+export async function callUtility(registry, name, args, timeoutMs = 5000) {
+    const fn = registry.get(name);
+    if (!fn)
+        throw new Error(`MCP-EXT-002 Unknown utility function “${name}”`);
+    return Promise.race([
+        Promise.resolve(fn(args)),
+        new Promise((_, reject) => setTimeout(() => reject(new Error(`MCP-EXT-003 Function “${name}” exceeded ${timeoutMs}ms`)), timeoutMs)),
+    ]).then((value) => {
+        try {
+            JSON.stringify(value);
+        }
+        catch {
+            throw new Error(`MCP-EXT-004 Function “${name}” returned a value that cannot be saved as JSON`);
+        }
+        return value;
+    });
+}
+export function builtinNames() { return Object.keys(builtins).sort(); }
+//# sourceMappingURL=extensions.js.map

package/dist/extensions.js.map

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

package/dist/imports.d.ts

@@ -0,0 +1,7 @@
+export interface ImportGraph {
+    source: string;
+    importedFiles: string[];
+}
+/** Resolve flow-library imports and inline declarations without executing imported tests. */
+export declare function resolveFlowImports(source: string, entryFile: string, stack?: string[]): Promise<ImportGraph>;
+//# sourceMappingURL=imports.d.ts.map

package/dist/imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imports.d.ts","sourceRoot":"","sources":["../src/imports.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,EAAE,CAAA;CAAE;AAExE,6FAA6F;AAC7F,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAiBtH"}

package/dist/imports.js

@@ -0,0 +1,41 @@
+import { readFile, realpath } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+/** Resolve flow-library imports and inline declarations without executing imported tests. */
+export async function resolveFlowImports(source, entryFile, stack = []) {
+    const canonical = await realpath(entryFile).catch(() => resolve(entryFile));
+    if (stack.includes(canonical))
+        throw new Error(`MCPLANG301 Import cycle: ${[...stack, canonical].join(" → ")}`);
+    const expression = /^Import flows from\s+["']([^"']+)["']\s*$/gim;
+    const importedFiles = [];
+    const chunks = [];
+    let match;
+    while ((match = expression.exec(source))) {
+        const imported = await realpath(resolve(dirname(canonical), match[1])).catch(() => resolve(dirname(canonical), match[1]));
+        let importedSource;
+        try {
+            importedSource = await readFile(imported, "utf8");
+        }
+        catch {
+            throw new Error(`MCPLANG302 Cannot import flow library ${match[1]} from ${entryFile}`);
+        }
+        const graph = await resolveFlowImports(importedSource, imported, [...stack, canonical]);
+        importedFiles.push(imported, ...graph.importedFiles);
+        chunks.push(flowDeclarationsOnly(graph.source));
+    }
+    return { source: `${chunks.join("\n")}\n${source.replace(expression, "")}`, importedFiles: [...new Set(importedFiles)] };
+}
+function flowDeclarationsOnly(source) {
+    const lines = source.replaceAll("\r\n", "\n").split("\n");
+    const output = [];
+    for (let index = 0; index < lines.length;) {
+        if (/^Flow:/i.test(lines[index].trim()) && !/^\s/.test(lines[index])) {
+            output.push(lines[index++]);
+            while (index < lines.length && (!lines[index].trim() || /^\s/.test(lines[index])))
+                output.push(lines[index++]);
+        }
+        else
+            index++;
+    }
+    return output.join("\n");
+}
+//# sourceMappingURL=imports.js.map

package/dist/imports.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+export { assertError, assertResponse } from "./assertions.js";
+export { authorTest, createReadlinePromptAdapter, flattenResponse, renderAuthoredTest, ScriptedPromptAdapter, type AuthoredTest, type PromptAdapter } from "./author.js";
+export { canonicalize, canonicalJson, fingerprint } from "./canonical.js";
+export { checkContract, compareContracts, contractMarkdown, contractReport, readContract, updateContract, type ContractChange, type ContractDiff, type DriftSeverity } from "./contract.js";
+export { discoverTarget, generateSuite, writeGeneratedSuite, writeLock } from "./discovery.js";
+export { clearDataCache, loadData, type DataProvider, type DataRow, type DataSet } from "./data.js";
+export { builtinNames, callUtility, createFunctionRegistry, type UtilityFunction } from "./extensions.js";
+export { resolveFlowImports, type ImportGraph } from "./imports.js";
+export { LanguageDiagnostic, lexLanguage, validateLanguageDocument, type LanguageDocument, type LanguageNode, type SourceSpan } from "./language.js";
+export { loadSuite, validateSuite } from "./loader.js";
+export { readPath, replaceVariables } from "./path.js";
+export { runParity, parityReport, parityMarkdown, type ParityResult, type ParityTargets, type ParityTestRow } from "./parity.js";
+export { compileQaLanguage } from "./qa-language.js";
+export { compileAdvancedQaLanguage, type QaCompileOptions } from "./qa-advanced.js";
+export { loadTestFile } from "./qa-loader.js";
+export { terminalReport, writeHtmlReport, writeJsonReport, writeJunitReport } from "./reporters.js";
+export { starterTemplate, writeStarter } from "./starter.js";
+export { replayReport, replayTrace, type ReplayOptions, type ReplayResult } from "./replay.js";
+export { SnapshotStore, normalizeSnapshot, renderSemanticDiff, semanticDiff, type SemanticChange, type SnapshotFile, type SnapshotOptions } from "./snapshots.js";
+export { readState, targetFingerprint, writeState, type PersistedState } from "./state.js";
+export { compareEvidence, showEvidence, TraceRecorder, traceSession, writeEvidenceBundle, type EvidenceManifest, type NormalizedTraceEvent, type TraceEvent } from "./trace.js";
+export { runSuite, type RunOptions } from "./runner.js";
+export { createSession, installSignalCleanup, shutdownSessions } from "./session.js";
+export { RigorError, FAILURE_CODES, classifyFailure, formatFailure, sanitizeTerminal, type FailureCategory, type FailureInfo } from "./errors.js";
+export { defineExtension, defineManifest, type ExtensionDataProvider, type ExtensionFunction, type ExtensionManifest, type ExtensionPermission } from "./extension-sdk.js";
+export { callIsolatedFunction, callIsolatedProvider, inspectExtension, type ExtensionDescriptor, type ExtensionHostOptions } from "./extension-host.js";
+export { startWorkspace, type WorkspaceOptions } from "./workspace.js";
+export type * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,28 @@
+export { assertError, assertResponse } from "./assertions.js";
+export { authorTest, createReadlinePromptAdapter, flattenResponse, renderAuthoredTest, ScriptedPromptAdapter } from "./author.js";
+export { canonicalize, canonicalJson, fingerprint } from "./canonical.js";
+export { checkContract, compareContracts, contractMarkdown, contractReport, readContract, updateContract } from "./contract.js";
+export { discoverTarget, generateSuite, writeGeneratedSuite, writeLock } from "./discovery.js";
+export { clearDataCache, loadData } from "./data.js";
+export { builtinNames, callUtility, createFunctionRegistry } from "./extensions.js";
+export { resolveFlowImports } from "./imports.js";
+export { LanguageDiagnostic, lexLanguage, validateLanguageDocument } from "./language.js";
+export { loadSuite, validateSuite } from "./loader.js";
+export { readPath, replaceVariables } from "./path.js";
+export { runParity, parityReport, parityMarkdown } from "./parity.js";
+export { compileQaLanguage } from "./qa-language.js";
+export { compileAdvancedQaLanguage } from "./qa-advanced.js";
+export { loadTestFile } from "./qa-loader.js";
+export { terminalReport, writeHtmlReport, writeJsonReport, writeJunitReport } from "./reporters.js";
+export { starterTemplate, writeStarter } from "./starter.js";
+export { replayReport, replayTrace } from "./replay.js";
+export { SnapshotStore, normalizeSnapshot, renderSemanticDiff, semanticDiff } from "./snapshots.js";
+export { readState, targetFingerprint, writeState } from "./state.js";
+export { compareEvidence, showEvidence, TraceRecorder, traceSession, writeEvidenceBundle } from "./trace.js";
+export { runSuite } from "./runner.js";
+export { createSession, installSignalCleanup, shutdownSessions } from "./session.js";
+export { RigorError, FAILURE_CODES, classifyFailure, formatFailure, sanitizeTerminal } from "./errors.js";
+export { defineExtension, defineManifest } from "./extension-sdk.js";
+export { callIsolatedFunction, callIsolatedProvider, inspectExtension } from "./extension-host.js";
+export { startWorkspace } from "./workspace.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,2BAA2B,EAAE,eAAe,EAAE,kBAAkB,EAAE,qBAAqB,EAAyC,MAAM,aAAa,CAAC;AACzK,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,EAA8D,MAAM,eAAe,CAAC;AAC5L,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC/F,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAiD,MAAM,WAAW,CAAC;AACpG,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,sBAAsB,EAAwB,MAAM,iBAAiB,CAAC;AAC1G,OAAO,EAAE,kBAAkB,EAAoB,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,wBAAwB,EAA6D,MAAM,eAAe,CAAC;AACrJ,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,EAA6D,MAAM,aAAa,CAAC;AACjI,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAyB,MAAM,kBAAkB,CAAC;AACpF,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACpG,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,WAAW,EAAyC,MAAM,aAAa,CAAC;AAC/F,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,YAAY,EAAgE,MAAM,gBAAgB,CAAC;AAClK,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,UAAU,EAAuB,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,mBAAmB,EAAqE,MAAM,YAAY,CAAC;AAChL,OAAO,EAAE,QAAQ,EAAmB,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,EAAE,gBAAgB,EAA0C,MAAM,aAAa,CAAC;AAClJ,OAAO,EAAE,eAAe,EAAE,cAAc,EAAwG,MAAM,oBAAoB,CAAC;AAC3K,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,gBAAgB,EAAuD,MAAM,qBAAqB,CAAC;AACxJ,OAAO,EAAE,cAAc,EAAyB,MAAM,gBAAgB,CAAC"}

package/dist/language.d.ts

@@ -0,0 +1,34 @@
+export interface SourcePosition {
+    line: number;
+    column: number;
+    offset: number;
+}
+export interface SourceSpan {
+    file: string;
+    start: SourcePosition;
+    end: SourcePosition;
+}
+export type LanguageNodeKind = "version" | "suite" | "server" | "import" | "flow" | "data" | "test" | "statement" | "blank" | "comment";
+export interface LanguageNode {
+    kind: LanguageNodeKind;
+    text: string;
+    indent: number;
+    span: SourceSpan;
+}
+export interface LanguageDocument {
+    version: 1;
+    file: string;
+    source: string;
+    nodes: LanguageNode[];
+}
+export declare class LanguageDiagnostic extends Error {
+    readonly code: string;
+    readonly span: SourceSpan;
+    readonly reason: string;
+    readonly hint?: string | undefined;
+    constructor(code: string, span: SourceSpan, reason: string, hint?: string | undefined, source?: string);
+}
+/** Formal line lexer for MCP Test 1. It owns whitespace, spans, and declaration classification. */
+export declare function lexLanguage(source: string, file?: string): LanguageDocument;
+export declare function validateLanguageDocument(document: LanguageDocument): void;
+//# sourceMappingURL=language.d.ts.map

package/dist/language.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language.d.ts","sourceRoot":"","sources":["../src/language.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAChF,MAAM,WAAW,UAAU;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,cAAc,CAAC;IAAC,GAAG,EAAE,cAAc,CAAA;CAAE;AACxF,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;AACxI,MAAM,WAAW,YAAY;IAAG,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE;AACxG,MAAM,WAAW,gBAAgB;IAAG,OAAO,EAAE,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,EAAE,CAAA;CAAE;AAErG,qBAAa,kBAAmB,SAAQ,KAAK;aACf,IAAI,EAAE,MAAM;aAAkB,IAAI,EAAE,UAAU;aAAkB,MAAM,EAAE,MAAM;aAAkB,IAAI,CAAC,EAAE,MAAM;gBAA7G,IAAI,EAAE,MAAM,EAAkB,IAAI,EAAE,UAAU,EAAkB,MAAM,EAAE,MAAM,EAAkB,IAAI,CAAC,EAAE,MAAM,YAAA,EAAE,MAAM,CAAC,EAAE,MAAM;CAM3J;AAED,mGAAmG;AACnG,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,SAAc,GAAG,gBAAgB,CAqBhF;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAoBzE"}

package/dist/language.js

@@ -0,0 +1,102 @@
+export class LanguageDiagnostic extends Error {
+    code;
+    span;
+    reason;
+    hint;
+    constructor(code, span, reason, hint, source) {
+        const line = source?.split(/\r?\n/)[span.start.line - 1] ?? "";
+        const caret = `${" ".repeat(Math.max(0, span.start.column - 1))}${"^".repeat(Math.max(1, span.end.column - span.start.column))}`;
+        super(`${code} ${span.file}:${span.start.line}:${span.start.column}\n\n${line}\n${caret}\n\n${reason}${hint ? `\nTry: ${hint}` : ""}`);
+        this.code = code;
+        this.span = span;
+        this.reason = reason;
+        this.hint = hint;
+        this.name = "LanguageDiagnostic";
+    }
+}
+/** Formal line lexer for MCP Test 1. It owns whitespace, spans, and declaration classification. */
+export function lexLanguage(source, file = "test.mcpr") {
+    const normalized = source.replaceAll("\r\n", "\n");
+    const lines = normalized.split("\n");
+    const nodes = [];
+    let offset = 0;
+    let version = 1;
+    for (let index = 0; index < lines.length; index++) {
+        const raw = lines[index];
+        if (raw.includes("\t"))
+            throw diagnostic("MCPLANG101", file, normalized, index + 1, raw.indexOf("\t") + 1, "Tabs are not allowed because their visual width is ambiguous.", "replace the tab with two spaces");
+        const indent = raw.match(/^ */)[0].length;
+        if (indent % 2 !== 0)
+            throw diagnostic("MCPLANG102", file, normalized, index + 1, 1, "Indentation must use multiples of two spaces.", "use 0, 2, 4, or 6 leading spaces");
+        const text = raw.trim();
+        const kind = classify(text);
+        if (/^MCP Test\s+/i.test(text)) {
+            if (text !== "MCP Test 1")
+                throw diagnostic("MCPLANG103", file, normalized, index + 1, indent + 1, `Unsupported language header “${text}”.`, "MCP Test 1");
+            version = 1;
+        }
+        nodes.push({ kind, text, indent, span: span(file, index + 1, indent + 1, Math.max(indent + 2, raw.length + 1), offset + indent, offset + raw.length) });
+        offset += raw.length + 1;
+    }
+    return { version, file, source: normalized, nodes };
+}
+export function validateLanguageDocument(document) {
+    const names = new Map();
+    const flowNames = new Map();
+    let currentTest = false;
+    let hasAction = false;
+    for (const node of document.nodes) {
+        if (node.kind === "test") {
+            if (currentTest && !hasAction)
+                throw new LanguageDiagnostic("MCPLANG202", node.span, "The previous test has no action.", "add Call tool, Read resource, Get prompt, or Send", document.source);
+            currentTest = true;
+            hasAction = false;
+            const name = quotedName(node.text);
+            if (name)
+                duplicate(names, name, node, document, "test");
+        }
+        if (node.kind === "flow") {
+            const name = quotedName(node.text);
+            if (name)
+                duplicate(flowNames, name, node, document, "flow");
+        }
+        if (/^(Call|When I call|Read|When I read|Get|When I get|Send|When I send|Use flow|For each row|Subscribe to|Unsubscribe from|Wait for notification|Set log level|List all|List tasks|Cancel task)\b/i.test(node.text))
+            hasAction = true;
+        if (/^(Expect|Then|Save|Remember|Export|Wait up to)\b/i.test(node.text) && !hasAction)
+            throw new LanguageDiagnostic("MCPLANG203", node.span, `“${node.text}” needs an action before it.`, "add Call tool, Read resource, Get prompt, or Send above it", document.source);
+    }
+    if (currentTest && !hasAction) {
+        const node = [...document.nodes].reverse().find((item) => item.kind === "test");
+        throw new LanguageDiagnostic("MCPLANG202", node.span, "This test has no action.", "add Call tool, Read resource, Get prompt, or Send", document.source);
+    }
+}
+function classify(text) {
+    if (!text)
+        return "blank";
+    if (text.startsWith("#"))
+        return "comment";
+    if (/^MCP Test\s+/i.test(text))
+        return "version";
+    if (/^Suite:/i.test(text))
+        return "suite";
+    if (/^(Server:|MCP URL:|Connect to:|Compare target\s+|Parity target\s+|Target options for\s+|Server options:)/i.test(text))
+        return "server";
+    if (/^Import flows from\s+/i.test(text))
+        return "import";
+    if (/^Flow:/i.test(text))
+        return "flow";
+    if (/^Data source:/i.test(text))
+        return "data";
+    if (/^(Test|Scenario):/i.test(text))
+        return "test";
+    return "statement";
+}
+function quotedName(text) { return text.match(/^[^:]+:\s*["']([^"']+)["']/)?.[1]; }
+function duplicate(map, name, node, document, kind) {
+    if (map.has(name))
+        throw new LanguageDiagnostic("MCPLANG201", node.span, `Duplicate ${kind} name “${name}”.`, `rename one ${kind}; names must be unique`, document.source);
+    map.set(name, node);
+}
+function diagnostic(code, file, source, line, column, reason, hint) { return new LanguageDiagnostic(code, span(file, line, column, column + 1, 0, 0), reason, hint, source); }
+function span(file, line, start, end, startOffset, endOffset) { return { file, start: { line, column: start, offset: startOffset }, end: { line, column: end, offset: endOffset } }; }
+//# sourceMappingURL=language.js.map

package/dist/language.js.map

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

package/dist/loader.d.ts

@@ -0,0 +1,4 @@
+import type { Suite } from "./types.js";
+export declare function loadSuite(file: string): Promise<Suite>;
+export declare function validateSuite(value: unknown): asserts value is Suite;
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAMxC,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAmB5D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAUpE"}

package/dist/loader.js

@@ -0,0 +1,51 @@
+import { readFile } from "node:fs/promises";
+import { extname } from "node:path";
+import AjvModule from "ajv";
+const Ajv = AjvModule;
+import YAML from "yaml";
+import { suiteSchema } from "./schema.js";
+const MAX_SUITE_BYTES = 1024 * 1024;
+const ajv = new Ajv({ allErrors: true, strict: false });
+const validate = ajv.compile(suiteSchema);
+export async function loadSuite(file) {
+    const source = await readFile(file, "utf8");
+    if (Buffer.byteLength(source) > MAX_SUITE_BYTES)
+        throw new Error("MCP-CONFIG-002 Suite exceeds the 1 MiB limit");
+    const extension = extname(file).toLowerCase();
+    let value;
+    try {
+        if (extension === ".json")
+            value = JSON.parse(source);
+        else {
+            const document = YAML.parseDocument(source, { uniqueKeys: true });
+            if (document.errors.length)
+                throw document.errors[0];
+            value = document.toJS({ maxAliasCount: 0 });
+        }
+    }
+    catch (error) {
+        throw new Error(`MCP-CONFIG-001 Unable to parse ${file}: ${messageOf(error)}`);
+    }
+    validateSuite(value);
+    return value;
+}
+export function validateSuite(value) {
+    if (!validate(value)) {
+        const detail = (validate.errors ?? []).map(formatError).join("; ");
+        throw new Error(`MCP-CONFIG-003 Invalid suite: ${detail}`);
+    }
+    const names = new Set();
+    for (const test of value.tests) {
+        if (names.has(test.name))
+            throw new Error(`MCP-CONFIG-004 Duplicate test name: ${test.name}`);
+        names.add(test.name);
+    }
+}
+function formatError(error) {
+    const path = error.instancePath || "$";
+    return `${path} ${error.message ?? "is invalid"}`;
+}
+function messageOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

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