@x12i/sdk 0.4.0 → 1.1.0

package/dist/mcp.js

@@ -0,0 +1,168 @@
+import { AGENT_INSTRUCTION } from "./init.js";
+export const MCP_PROTOCOL_VERSIONS = ["2025-11-25", "2025-06-18", "2025-03-26", "2024-11-05"];
+const str = (description) => ({ type: "string", description });
+const object = (properties, required) => ({ type: "object", properties, required, additionalProperties: false });
+const agent = { type: "string", enum: ["cursor", "claude-code", "codex", "other"], description: "Code agent that used the package" };
+const outcome = { type: "string", enum: ["succeeded", "partial", "failed", "not-used"], description: "What happened when the package was tried" };
+const notes = {
+    worked: str("What worked"),
+    failed: str("What did not work"),
+    needed: str("What was needed"),
+    improve: str("What should improve"),
+};
+export const MCP_TOOLS = [
+    {
+        name: "x12i_search",
+        description: "Find the @x12i packages most relevant to a task. Results include why each package matched, its maturity, rating, use cases, tags, tiers, lifecycle, install command, license, vulnerabilities, and public example. A confirmed superseded package points at its canonical successor.",
+        inputSchema: object({ task: str("What the agent is trying to do") }, ["task"]),
+        annotations: { readOnlyHint: true },
+        run: (client, args) => client.search(String(args.task ?? "")),
+    },
+    {
+        name: "x12i_catalog",
+        description: "List every x12i package this catalog counts, including unscoped packages the org owns. Newest update is first. Each package includes family, familyTitle, license, vulnerabilities, and maturityLabel, which states the 0 to 100 maturity score and its band. Pass the returned cursor for the next page.",
+        inputSchema: object({ cursor: str("Cursor returned by the previous page"), limit: { type: "integer", description: "Page size, up to 2000" } }, []),
+        annotations: { readOnlyHint: true },
+        run: (client, args) => client.catalog(typeof args.cursor === "string" ? args.cursor : undefined, typeof args.limit === "number" ? args.limit : 50),
+    },
+    {
+        name: "x12i_package",
+        description: "Read one package. Returns the cached record, then fetches the current README and metadata when the catalog knows the package was published after that cache.",
+        inputSchema: object({ name: str("Package name, for example @x12i/sdk") }, ["name"]),
+        annotations: { readOnlyHint: true },
+        run: (client, args) => client.package(String(args.name ?? "")),
+    },
+    {
+        name: "x12i_readme",
+        description: "Read one package README. Returns the cached text first. When the catalog knows a newer publish exists, fetches that README and returns it too.",
+        inputSchema: object({ name: str("Package name") }, ["name"]),
+        annotations: { readOnlyHint: true },
+        run: (client, args) => client.readme(String(args.name ?? "")),
+    },
+    {
+        name: "x12i_reviews",
+        description: "Read recent signed reviews for one package so you can see how it went for other agents.",
+        inputSchema: object({ name: str("Package name") }, ["name"]),
+        annotations: { readOnlyHint: true },
+        run: (client, args) => client.reviews(String(args.name ?? "")),
+    },
+    {
+        name: "x12i_report",
+        description: "Report SDK usage without a star rating: version, outcome, and what worked, failed, was needed, or should improve.",
+        inputSchema: object({
+            package: str("Package that was used"),
+            packageVersion: str("Version that was used"),
+            agent,
+            outcome,
+            ...notes,
+        }, ["package", "packageVersion", "agent", "outcome"]),
+        run: (client, args) => client.report(args),
+    },
+    {
+        name: "x12i_review",
+        description: "File a 1 to 5 rating after trying a package. Include the version and what worked, failed, was needed, or should improve.",
+        inputSchema: object({
+            package: str("Package that was tried"),
+            packageVersion: str("Version that was tried"),
+            agent,
+            outcome,
+            rating: { type: "integer", minimum: 1, description: "Stars from 1 to 5" },
+            ...notes,
+        }, ["package", "packageVersion", "agent", "outcome", "rating"]),
+        run: (client, args) => client.review(args),
+    },
+    {
+        name: "x12i_status",
+        description: "Show this SDK version, whether this install is enrolled, and whether the catalog service is reachable.",
+        inputSchema: object({}, []),
+        annotations: { readOnlyHint: true },
+        run: (client) => client.status(),
+    },
+];
+const rpcError = (id, code, message) => ({ jsonrpc: "2.0", id, error: { code, message } });
+export async function handleMcpMessage(message, client, server = { name: "x12i", version: "0.1.0" }) {
+    const rpc = message;
+    if (!rpc || typeof rpc !== "object" || Array.isArray(rpc) || rpc.jsonrpc !== "2.0" || typeof rpc.method !== "string")
+        return rpcError(null, -32600, "Invalid Request");
+    if (rpc.id === undefined)
+        return undefined;
+    const id = rpc.id ?? null;
+    const params = (rpc.params ?? {});
+    try {
+        switch (rpc.method) {
+            case "initialize": {
+                const requested = params.protocolVersion;
+                const version = MCP_PROTOCOL_VERSIONS.includes(requested) ? requested : MCP_PROTOCOL_VERSIONS[0];
+                return {
+                    jsonrpc: "2.0",
+                    id,
+                    result: {
+                        protocolVersion: version,
+                        capabilities: { tools: { listChanged: false } },
+                        serverInfo: server,
+                        instructions: AGENT_INSTRUCTION,
+                    },
+                };
+            }
+            case "ping":
+                return { jsonrpc: "2.0", id, result: {} };
+            case "tools/list":
+                return { jsonrpc: "2.0", id, result: { tools: MCP_TOOLS.map(({ run: _run, ...tool }) => tool) } };
+            case "tools/call": {
+                if (!client)
+                    return rpcError(id, -32603, "MCP client is not configured");
+                const tool = MCP_TOOLS.find((item) => item.name === params.name);
+                if (!tool)
+                    return rpcError(id, -32602, "Unknown tool");
+                const args = (params.arguments ?? {});
+                if (!args || typeof args !== "object" || Array.isArray(args))
+                    return rpcError(id, -32602, "arguments must be an object");
+                try {
+                    const value = await tool.run(client, args);
+                    return { jsonrpc: "2.0", id, result: { content: [{ type: "text", text: JSON.stringify(value) }], structuredContent: value, isError: false } };
+                }
+                catch (error) {
+                    const messageText = error instanceof Error ? error.message : String(error);
+                    return { jsonrpc: "2.0", id, result: { content: [{ type: "text", text: messageText }], isError: true } };
+                }
+            }
+            default:
+                return rpcError(id, -32601, "Method not found");
+        }
+    }
+    catch (error) {
+        return rpcError(id, -32603, error instanceof Error ? error.message : "Internal error");
+    }
+}
+export async function handleMcpFrame(client, line) {
+    if (!line.trim())
+        return undefined;
+    let message;
+    try {
+        message = JSON.parse(line);
+    }
+    catch {
+        return JSON.stringify(rpcError(null, -32700, "Parse error"));
+    }
+    if (Array.isArray(message))
+        return JSON.stringify(rpcError(null, -32600, "Batching is not supported"));
+    const response = await handleMcpMessage(message, client);
+    return response ? JSON.stringify(response) : undefined;
+}
+export async function serveMcp(client) {
+    const decoder = new TextDecoder();
+    let buffer = "";
+    for await (const chunk of process.stdin) {
+        buffer += typeof chunk === "string" ? chunk : decoder.decode(chunk, { stream: true });
+        let newline = buffer.indexOf("\n");
+        while (newline >= 0) {
+            const line = buffer.slice(0, newline);
+            buffer = buffer.slice(newline + 1);
+            const response = await handleMcpFrame(client, line);
+            if (response)
+                process.stdout.write(`${response}\n`);
+            newline = buffer.indexOf("\n");
+        }
+    }
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

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

package/dist/protocol.d.ts

@@ -0,0 +1,38 @@
+export declare const AGENTS: readonly ["cursor", "claude-code", "codex", "other"];
+export declare const OUTCOMES: readonly ["succeeded", "partial", "failed", "not-used"];
+export type AgentName = (typeof AGENTS)[number];
+export type Outcome = (typeof OUTCOMES)[number];
+export type KeyMaterial = {
+    publicKey: string;
+    privateKey: string;
+    fingerprint: string;
+};
+export type UsageFields = {
+    package: string;
+    packageVersion: string;
+    agent: AgentName;
+    outcome: Outcome;
+    worked: string;
+    failed: string;
+    needed: string;
+    improve: string;
+};
+export declare function b64u(bytes: Uint8Array): string;
+export declare function fromB64u(value: string): Uint8Array;
+export declare function sha256(bytes: Uint8Array): Promise<Uint8Array>;
+export declare function sha256Hex(value: string): Promise<string>;
+export declare function leadingZeroBits(digest: Uint8Array): number;
+export declare function constantEqual(left: string, right: string): boolean;
+export declare function createKeyPair(): Promise<KeyMaterial>;
+export declare function fingerprintOf(publicKey: string): Promise<string>;
+export declare function sign(privateKey: string, message: string): Promise<string>;
+export declare function verifySignature(publicKey: string, message: string, signature: string): Promise<boolean>;
+export declare function canonicalRequest(method: string, path: string, timestamp: string, nonce: string, body: string): Promise<string>;
+export declare function randomNonce(): string;
+/** Leading-zero bits required for a new install. The first few from a network are free. */
+export declare function workBits(enrollmentsToday: number): number;
+export declare function networkKey(ip: string | null): string;
+export declare function solveWork(challenge: string, bits: number): Promise<string>;
+export declare function checkWork(challenge: string, bits: number, work: string): Promise<boolean>;
+export declare function usageFields(input: Record<string, unknown>): UsageFields;
+export declare function reviewRating(value: unknown): number;

package/dist/protocol.js

@@ -0,0 +1,168 @@
+const textEncoder = new TextEncoder();
+export const AGENTS = ["cursor", "claude-code", "codex", "other"];
+export const OUTCOMES = ["succeeded", "partial", "failed", "not-used"];
+const PACKAGE_NAME = /^(?:@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/;
+const SECRET = /-----BEGIN |sk-[A-Za-z0-9]{16,}|api[_-]?key\s*[:=]/i;
+export function b64u(bytes) {
+    let binary = "";
+    for (const byte of bytes)
+        binary += String.fromCharCode(byte);
+    return btoa(binary).replaceAll("+", "-").replaceAll("/", "_").replaceAll("=", "");
+}
+export function fromB64u(value) {
+    const padded = value.replaceAll("-", "+").replaceAll("_", "/") + "=".repeat((4 - (value.length % 4)) % 4);
+    const binary = atob(padded);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++)
+        bytes[i] = binary.charCodeAt(i);
+    return bytes;
+}
+export async function sha256(bytes) {
+    return new Uint8Array(await crypto.subtle.digest("SHA-256", bytes));
+}
+export async function sha256Hex(value) {
+    const digest = await sha256(textEncoder.encode(value));
+    return [...digest].map((byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+export function leadingZeroBits(digest) {
+    let bits = 0;
+    for (const byte of digest) {
+        if (byte === 0) {
+            bits += 8;
+            continue;
+        }
+        for (let mask = 128; mask > 0; mask >>= 1) {
+            if ((byte & mask) !== 0)
+                return bits;
+            bits += 1;
+        }
+    }
+    return bits;
+}
+export function constantEqual(left, right) {
+    const a = textEncoder.encode(left);
+    const b = textEncoder.encode(right);
+    if (a.length !== b.length)
+        return false;
+    let diff = 0;
+    for (let i = 0; i < a.length; i++)
+        diff |= a[i] ^ b[i];
+    return diff === 0;
+}
+export async function createKeyPair() {
+    const pair = await crypto.subtle.generateKey({ name: "Ed25519" }, true, ["sign", "verify"]);
+    const publicKey = b64u(new Uint8Array(await crypto.subtle.exportKey("raw", pair.publicKey)));
+    const privateKey = b64u(new Uint8Array(await crypto.subtle.exportKey("pkcs8", pair.privateKey)));
+    return { publicKey, privateKey, fingerprint: await fingerprintOf(publicKey) };
+}
+export async function fingerprintOf(publicKey) {
+    const raw = fromB64u(publicKey);
+    if (raw.length !== 32)
+        throw new Error("Ed25519 public key must be 32 bytes");
+    const digest = await sha256(raw);
+    return [...digest].map((byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+export async function sign(privateKey, message) {
+    const key = await crypto.subtle.importKey("pkcs8", fromB64u(privateKey), { name: "Ed25519" }, false, ["sign"]);
+    const signature = await crypto.subtle.sign("Ed25519", key, textEncoder.encode(message));
+    return b64u(new Uint8Array(signature));
+}
+export async function verifySignature(publicKey, message, signature) {
+    try {
+        const key = await crypto.subtle.importKey("raw", fromB64u(publicKey), { name: "Ed25519" }, false, ["verify"]);
+        return await crypto.subtle.verify("Ed25519", key, fromB64u(signature), textEncoder.encode(message));
+    }
+    catch {
+        return false;
+    }
+}
+export async function canonicalRequest(method, path, timestamp, nonce, body) {
+    return ["X12I-SDK-v1", method.toUpperCase(), path, timestamp, nonce, await sha256Hex(body)].join("\n");
+}
+export function randomNonce() {
+    const bytes = new Uint8Array(16);
+    crypto.getRandomValues(bytes);
+    return b64u(bytes);
+}
+/** Leading-zero bits required for a new install. The first few from a network are free. */
+export function workBits(enrollmentsToday) {
+    if (enrollmentsToday <= 3)
+        return 0;
+    return Math.min(16, 8 + Math.floor(Math.log2(enrollmentsToday)));
+}
+export function networkKey(ip) {
+    if (!ip)
+        return "unknown";
+    const first = ip.split(",")[0]?.trim() ?? "";
+    if (/^\d{1,3}(\.\d{1,3}){3}$/.test(first))
+        return `v4:${first.split(".").slice(0, 3).join(".")}`;
+    if (first.startsWith("::ffff:"))
+        return networkKey(first.slice(7));
+    if (first.includes(":")) {
+        const groups = first.split("::")[0]?.split(":").filter(Boolean) ?? [];
+        return `v6:${groups.slice(0, 3).join(":")}`;
+    }
+    return "unknown";
+}
+export async function solveWork(challenge, bits) {
+    if (bits <= 0)
+        return "";
+    for (let counter = 0; counter < 5_000_000; counter++) {
+        const work = String(counter);
+        const digest = await sha256(textEncoder.encode(`${challenge}:${work}`));
+        if (leadingZeroBits(digest) >= bits)
+            return work;
+    }
+    throw new Error("Proof of work exceeded the search limit");
+}
+export async function checkWork(challenge, bits, work) {
+    if (bits <= 0)
+        return work === "";
+    if (!/^\d{1,12}$/.test(work) || bits > 24)
+        return false;
+    const digest = await sha256(textEncoder.encode(`${challenge}:${work}`));
+    return leadingZeroBits(digest) >= bits;
+}
+function note(value, field) {
+    if (value == null || value === "")
+        return "";
+    if (typeof value !== "string")
+        throw new Error(`${field} must be text`);
+    const text = value.trim();
+    if (text.length > 1000)
+        throw new Error(`${field} is longer than 1000 characters`);
+    if (SECRET.test(text))
+        throw new Error(`${field} looks like a secret; remove it before sending`);
+    return text;
+}
+export function usageFields(input) {
+    const packageName = input.package;
+    if (typeof packageName !== "string" || !PACKAGE_NAME.test(packageName))
+        throw new Error("package name is invalid");
+    const packageVersion = input.packageVersion;
+    if (typeof packageVersion !== "string" || packageVersion.trim().length === 0 || packageVersion.length > 64) {
+        throw new Error("packageVersion is required");
+    }
+    const agent = input.agent;
+    if (typeof agent !== "string" || !AGENTS.includes(agent))
+        throw new Error("agent must be cursor, claude-code, codex, or other");
+    const outcome = input.outcome;
+    if (typeof outcome !== "string" || !OUTCOMES.includes(outcome))
+        throw new Error("outcome is invalid");
+    return {
+        package: packageName,
+        packageVersion: packageVersion.trim(),
+        agent: agent,
+        outcome: outcome,
+        worked: note(input.worked, "worked"),
+        failed: note(input.failed, "failed"),
+        needed: note(input.needed, "needed"),
+        improve: note(input.improve, "improve"),
+    };
+}
+export function reviewRating(value) {
+    if (typeof value !== "number" || !Number.isInteger(value) || value < 1 || value > 5)
+        throw new Error("rating must be an integer from 1 to 5");
+    return value;
+}
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

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

package/dist/rank.d.ts

@@ -0,0 +1,19 @@
+export type CatalogDocument = {
+    name: string;
+    description?: string;
+    keywords?: string[];
+    headings?: string[];
+    readme?: string;
+    maturity?: number;
+    rating?: number | null;
+};
+export type RankedPackage = {
+    name: string;
+    score: number;
+    confidence: "high" | "low";
+    matched: string[];
+    reasons: string[];
+};
+export declare function tokenize(text: string): string[];
+/** Explainable ranking. No model. A task with no overlapping terms comes back at low confidence. */
+export declare function rankPackages(task: string, entries: CatalogDocument[], limit?: number): RankedPackage[];

package/dist/rank.js

@@ -0,0 +1,82 @@
+import { bandFor } from "./maturity.js";
+const STOP = new Set(["the", "a", "an", "to", "for", "of", "and", "or", "in", "on", "with", "using", "use", "via", "from", "that", "this", "is", "be", "it", "as", "at", "by"]);
+export function tokenize(text) {
+    return text
+        .toLowerCase()
+        .split(/[^a-z0-9@/+.-]+/)
+        .map((token) => token.replace(/^[.@/+-]+|[.@/+-]+$/g, ""))
+        .filter((token) => token.length > 1 && !STOP.has(token));
+}
+function unique(tokens) {
+    return [...new Set(tokens)];
+}
+function nameTokens(name) {
+    return unique(tokenize(name.replaceAll(/[@/]/g, " "))).filter((token) => token !== "x12i");
+}
+function hits(term, tokens) {
+    return tokens.some((token) => token === term || (term.length >= 4 && token.length >= 4 && (token.startsWith(term) || term.startsWith(token))));
+}
+/** Explainable ranking. No model. A task with no overlapping terms comes back at low confidence. */
+export function rankPackages(task, entries, limit = 5) {
+    const terms = unique(tokenize(task));
+    const scored = entries.map((entry) => {
+        const name = nameTokens(entry.name);
+        const keywords = unique((entry.keywords ?? []).flatMap((keyword) => tokenize(keyword)));
+        const description = unique(tokenize(entry.description ?? ""));
+        const headings = unique((entry.headings ?? []).flatMap((heading) => tokenize(heading)));
+        const readme = unique(tokenize((entry.readme ?? "").slice(0, 2000)));
+        const matched = [];
+        const reasons = [];
+        let score = 0;
+        for (const term of terms) {
+            let termScore = 0;
+            if (hits(term, name)) {
+                termScore += 8;
+                reasons.push(`name matches ${term}`);
+            }
+            if (hits(term, keywords)) {
+                termScore += 6;
+                reasons.push(`keyword matches ${term}`);
+            }
+            if (hits(term, description)) {
+                termScore += 3;
+                reasons.push(`description matches ${term}`);
+            }
+            if (hits(term, headings)) {
+                termScore += 3;
+                reasons.push(`heading matches ${term}`);
+            }
+            if (hits(term, readme)) {
+                termScore += 1;
+                reasons.push(`readme matches ${term}`);
+            }
+            if (termScore > 0) {
+                matched.push(term);
+                score += termScore;
+            }
+        }
+        const maturity = entry.maturity ?? 0;
+        const ratingBoost = entry.rating == null ? 0 : (entry.rating - 3) * 0.5;
+        score += (maturity / 100) * 2 + ratingBoost;
+        if (maturity > 0)
+            reasons.push(`maturity ${Math.round(maturity)} of 100, ${bandFor(maturity)}`);
+        if (entry.rating != null)
+            reasons.push(`rating ${entry.rating}`);
+        return {
+            name: entry.name,
+            score: Math.round(score * 1000) / 1000,
+            confidence: matched.length > 0 ? "high" : "low",
+            matched,
+            reasons,
+        };
+    });
+    const matchedAny = scored.some((item) => item.confidence === "high");
+    const chosen = (matchedAny ? scored.filter((item) => item.confidence === "high") : scored)
+        .sort((a, b) => b.score - a.score || a.name.localeCompare(b.name))
+        .slice(0, limit);
+    if (!matchedAny) {
+        return chosen.map((item) => ({ ...item, reasons: ["no catalog terms matched", ...item.reasons.filter((reason) => reason.startsWith("maturity") || reason.startsWith("rating"))] }));
+    }
+    return chosen;
+}
+//# sourceMappingURL=rank.js.map

package/dist/rank.js.map

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

package/dist/runner.d.ts

@@ -0,0 +1,22 @@
+import type { X12iAdmin } from "./admin.js";
+export type CommandResult = {
+    code: number;
+    stdout: string;
+    stderr: string;
+};
+export type CommandRunner = (command: string, args: string[], cwd: string) => Promise<CommandResult>;
+export declare function npmRunner(): CommandRunner;
+export declare function validateUsageDirectory(directory: string, run: CommandRunner, install: boolean): Promise<{
+    packageName: string;
+    packageVersion: string;
+    status: "passed" | "failed";
+    scope: string;
+    hashes: Record<string, string>;
+    results: Array<{
+        packageName: string;
+        status: string;
+        output: string;
+    }>;
+    environment: Record<string, unknown>;
+}>;
+export declare function runValidationRunner(admin: X12iAdmin, directory?: string, run?: CommandRunner): Promise<unknown>;

package/dist/runner.js

@@ -0,0 +1,99 @@
+import { createHash } from "node:crypto";
+import { spawn } from "node:child_process";
+import { readFile, readdir } from "node:fs/promises";
+import { join } from "node:path";
+export function npmRunner() {
+    return (command, args, cwd) => new Promise((resolve, reject) => {
+        const child = spawn(command, args, { cwd, shell: process.platform === "win32" });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (chunk) => { stdout += String(chunk); });
+        child.stderr.on("data", (chunk) => { stderr += String(chunk); });
+        child.on("error", reject);
+        child.on("close", (code) => resolve({ code: code ?? 1, stdout: stdout.slice(-4000), stderr: stderr.slice(-4000) }));
+    });
+}
+export async function validateUsageDirectory(directory, run, install) {
+    const usage = JSON.parse(await readFile(join(directory, "usage.json"), "utf8"));
+    if (install) {
+        const installed = await run("npm", ["ci", "--ignore-scripts", "--no-audit", "--no-fund"], directory);
+        if (installed.code !== 0) {
+            return failed(usage, installed.stderr || installed.stdout, {});
+        }
+    }
+    const files = await sourceFiles(directory);
+    const hashes = Object.fromEntries(await Promise.all(Object.entries(files).map(async ([path, body]) => [path, createHash("sha256").update(body).digest("hex")])));
+    const results = [];
+    const primary = await run("node", [usage.example.entrypoint ?? "src/index.mjs"], directory);
+    results.push({ packageName: usage.package, status: primary.code === 0 ? "passed" : "failed", output: primary.code === 0 ? primary.stdout : primary.stderr });
+    for (const [name, extra] of Object.entries(usage.additionalExamples ?? {})) {
+        const ran = await run("node", [extra.entrypoint], directory);
+        results.push({ packageName: name, status: ran.code === 0 ? "passed" : "failed", output: ran.code === 0 ? ran.stdout : ran.stderr });
+    }
+    const status = results.every((item) => item.status === "passed") ? "passed" : "failed";
+    return {
+        packageName: usage.package,
+        packageVersion: usage.packageVersion,
+        status,
+        scope: "fixture",
+        hashes,
+        results,
+        environment: { node: process.version, runner: "x12i-sdk admin runner", scope: "fixture", liveIntegration: false },
+    };
+}
+function failed(usage, output, hashes) {
+    return {
+        packageName: usage.package,
+        packageVersion: usage.packageVersion,
+        status: "failed",
+        scope: "fixture",
+        hashes,
+        results: [{ packageName: usage.package, status: "failed", output }],
+        environment: { node: process.version, scope: "fixture", liveIntegration: false },
+    };
+}
+async function sourceFiles(directory) {
+    const files = {};
+    files["package.json"] = await readFile(join(directory, "package.json"), "utf8");
+    const src = join(directory, "src");
+    for (const name of await readdir(src)) {
+        if (name.endsWith(".mjs") || name.endsWith(".js") || name.endsWith(".json"))
+            files[`src/${name}`] = await readFile(join(src, name), "utf8");
+    }
+    return files;
+}
+export async function runValidationRunner(admin, directory, run = npmRunner()) {
+    if (!directory)
+        return { status: "idle", note: "Pass a usage directory to validate. The runner does not publish." };
+    const minted = await admin.mint(["examples:prepare", "examples:validate"], "runner");
+    const scoped = admin.withToken(minted.token);
+    const result = await validateUsageDirectory(directory, run, true);
+    const files = await sourceFiles(directory);
+    const usage = JSON.parse(await readFile(join(directory, "usage.json"), "utf8"));
+    const draft = await scoped.prepareDraft({
+        packageName: result.packageName,
+        version: result.packageVersion,
+        scenario: usage.example?.command ?? "Run the package consumer and check its printed result.",
+        entrypoint: "src/index.mjs",
+        command: usage.example?.command ?? "node src/index.mjs",
+        files,
+    });
+    const versions = new Map([[result.packageName, result.packageVersion]]);
+    for (const [name, extra] of Object.entries(usage.additionalExamples ?? {}))
+        versions.set(name, extra.packageVersion ?? result.packageVersion);
+    const validations = [];
+    for (const item of result.results) {
+        validations.push(await scoped.recordValidation({
+            draftId: draft.draftId,
+            packageName: item.packageName,
+            packageVersion: versions.get(item.packageName) ?? result.packageVersion,
+            status: item.status === "passed" ? "passed" : "failed",
+            scope: "fixture",
+            hashes: result.hashes,
+            environment: result.environment,
+            output: item.output,
+        }));
+    }
+    return { ...result, draft, validations };
+}
+//# sourceMappingURL=runner.js.map