@vielzeug/codex 1.0.2

package/dist/data.js

@@ -0,0 +1,91 @@
+import { readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { CodexError } from './errors.js';
+import { SCHEMA_VERSION } from './types.js';
+const DEFAULT_DATA_FILE = resolve(dirname(fileURLToPath(import.meta.url)), '../data/vielzeug-data.json');
+const REGEN_CMD = 'pnpm --dir packages/codex run prepare:data';
+/** Array-typed BundledPackage fields that every real generated entry always populates. */
+const PACKAGE_ARRAY_FIELDS = ['availableDocPages', 'examples', 'exports', 'keywords', 'related'];
+/** Plain-object-typed BundledPackage fields that every real generated entry always populates. */
+const PACKAGE_OBJECT_FIELDS = ['docs', 'typeSignatures'];
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * `validateBundledData` is public API (see usage.md "load data from a custom snapshot file") and
+ * therefore reachable with arbitrary, possibly malformed JSON — not just the package's own
+ * generated output. Checking only `slug`/`name` let a structurally-wrong `docs`/`examples`/etc.
+ * field pass validation and then throw an unclear `TypeError` deep inside a tool's `run()` instead
+ * of a clear `CodexError` here, at load time.
+ */
+export function validateBundledData(raw) {
+    const r = raw;
+    if (typeof raw !== 'object' ||
+        raw === null ||
+        r['schemaVersion'] !== SCHEMA_VERSION ||
+        typeof r['version'] !== 'string' ||
+        !Array.isArray(r['packages']) ||
+        !Array.isArray(r['refineComponents'])) {
+        throw new CodexError(`Bundled data is malformed or uses an outdated schema (expected v${SCHEMA_VERSION}). Regenerate with ${REGEN_CMD}.`);
+    }
+    for (const entry of r['packages']) {
+        const p = entry;
+        if (typeof p['slug'] !== 'string' || p['slug'].length === 0 || typeof p['name'] !== 'string') {
+            throw new CodexError(`Bundled data has a malformed package entry (missing slug or name). Regenerate with ${REGEN_CMD}.`);
+        }
+        for (const field of PACKAGE_ARRAY_FIELDS) {
+            if (!Array.isArray(p[field])) {
+                throw new CodexError(`Bundled data has a malformed package entry ("${p['slug']}"."${field}" must be an array). Regenerate with ${REGEN_CMD}.`);
+            }
+        }
+        for (const field of PACKAGE_OBJECT_FIELDS) {
+            if (!isPlainObject(p[field])) {
+                throw new CodexError(`Bundled data has a malformed package entry ("${p['slug']}"."${field}" must be an object). Regenerate with ${REGEN_CMD}.`);
+            }
+        }
+    }
+    return raw;
+}
+export function loadData(dataFile) {
+    const file = dataFile ?? DEFAULT_DATA_FILE;
+    let raw;
+    try {
+        raw = readFileSync(file, 'utf8');
+    }
+    catch (error) {
+        const code = error instanceof Error ? error.code : undefined;
+        if (code === 'ENOENT') {
+            throw new CodexError(`Bundled MCP data not found at ${file}. In the monorepo run ${REGEN_CMD}; for standalone installs, reinstall @vielzeug/codex to restore packaged data.`, { cause: error });
+        }
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new CodexError(`Failed to read bundled MCP data at ${file}: ${detail}.`, { cause: error });
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        throw new CodexError(`Bundled MCP data at ${file} is malformed JSON. Regenerate with ${REGEN_CMD}.`, {
+            cause: error,
+        });
+    }
+    return validateBundledData(parsed);
+}
+/** Projects a BundledPackage to its lightweight PackageMeta shape (strips heavy content fields). */
+export function packageMeta(pkg) {
+    return {
+        availableDocPages: pkg.availableDocPages,
+        category: pkg.category,
+        description: pkg.description,
+        exampleIds: pkg.examples.map((e) => e.id),
+        exports: pkg.exports,
+        hasSource: pkg.apiSource !== null,
+        keywords: pkg.keywords,
+        name: pkg.name,
+        related: pkg.related,
+        slug: pkg.slug,
+        version: pkg.version,
+    };
+}
+//# sourceMappingURL=data.js.map

package/dist/data.js.map

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

package/dist/errors.js

@@ -0,0 +1,26 @@
+/** Base class for all codex errors. Use `instanceof CodexError` to catch any codex-originated error. */
+export class CodexError extends Error {
+    constructor(message, opts) {
+        super(message, opts);
+        this.name = new.target.name;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+    static is(err) {
+        return err instanceof CodexError;
+    }
+}
+/**
+ * Thrown by tool `run()` implementations for any expected failure (bad argument, unknown
+ * slug/tag, missing bundled data). `registerTools()` catches this exclusively — via
+ * `instanceof CodexError`, not a `ToolError`-specific check — and turns it into a structured
+ * `{ code, message }` MCP error result. Anything else that throws is a real bug and is left to
+ * propagate as a protocol-level error instead of being silently swallowed.
+ */
+export class ToolError extends CodexError {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC,YAAY,OAAe,EAAE,IAAmB;QAC9C,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAC5B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,CAAC,EAAE,CAAC,GAAY;QACpB,OAAO,GAAG,YAAY,UAAU,CAAC;IACnC,CAAC;CACF;AASD;;;;;;GAMG;AACH,MAAM,OAAO,SAAU,SAAQ,UAAU;IAC9B,IAAI,CAAgB;IAE7B,YAAY,IAAmB,EAAE,OAAe;QAC9C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/frontmatter.js

@@ -0,0 +1,72 @@
+/**
+ * Minimal YAML frontmatter parser.
+ * Supported formats: inline arrays [a,b,c], block sequences (- item),
+ * quoted strings, values containing colons, and CRLF line endings.
+ */
+const MAX_FRONTMATTER_INPUT = 102_400; // 100 KB — frontmatter is always tiny; guard against crafted large inputs
+export function parseFrontmatter(markdown) {
+    const match = /^---\r?\n([\s\S]*?)\r?\n---/.exec(markdown.slice(0, MAX_FRONTMATTER_INPUT));
+    if (!match?.[1])
+        return {};
+    const lines = match[1].split(/\r?\n/);
+    const result = {};
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        // Skip empty lines and comments
+        if (!line || line.trimStart().startsWith('#')) {
+            i++;
+            continue;
+        }
+        const colonIdx = line.indexOf(':');
+        if (colonIdx < 1) {
+            i++;
+            continue;
+        }
+        const key = line.slice(0, colonIdx).trim();
+        if (key === '__proto__' || key === 'constructor' || key === 'prototype') {
+            i++;
+            continue;
+        }
+        const rest = line.slice(colonIdx + 1).trim();
+        // Inline array: keywords: [mcp, ai-agent, claude]
+        if (rest.startsWith('[') && rest.endsWith(']')) {
+            result[key] = rest
+                .slice(1, -1)
+                .split(',')
+                .map((s) => s.trim().replace(/^['"`]|['"`]$/g, ''))
+                .filter(Boolean);
+            i++;
+            continue;
+        }
+        // Empty value → look ahead for block sequence items (- item)
+        if (rest === '') {
+            i++;
+            const items = [];
+            while (i < lines.length) {
+                const next = lines[i];
+                if (!next?.trim())
+                    break;
+                const trimmed = next.trim();
+                if (trimmed.startsWith('- ')) {
+                    items.push(trimmed
+                        .slice(2)
+                        .replace(/^['"`]|['"`]$/g, '')
+                        .trim());
+                    i++;
+                }
+                else {
+                    break;
+                }
+            }
+            if (items.length > 0)
+                result[key] = items;
+            continue;
+        }
+        // Regular string — strip surrounding quotes
+        result[key] = rest.replace(/^['"`]|['"`]$/g, '');
+        i++;
+    }
+    return result;
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/frontmatter.js.map

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

package/dist/generator.js

@@ -0,0 +1,176 @@
+import { createHash } from 'node:crypto';
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+// NOTE: These imports intentionally use .ts extensions (unlike other src/ files).
+// This file is loaded transitively by scripts/generate-bundled-data.ts under Node's
+// --experimental-strip-types, which resolves literal import specifiers — .ts is required
+// to locate the source files at runtime. tsc rewrites these to .js in dist/ via
+// rewriteRelativeImportExtensions in tsconfig.json.
+import { parseFrontmatter } from "./frontmatter.js";
+import { DOC_PAGES, SCHEMA_VERSION, } from "./types.js";
+// Resolves to dist/ in the compiled build, src/ when loaded directly under --experimental-strip-types.
+const __dirname = dirname(fileURLToPath(import.meta.url));
+// ---------------------------------------------------------------------------
+// File helpers
+// ---------------------------------------------------------------------------
+function readJson(filePath) {
+    return JSON.parse(readFileSync(filePath, 'utf8'));
+}
+function readTextIfExists(filePath) {
+    return filePath && existsSync(filePath) ? readFileSync(filePath, 'utf8') : null;
+}
+function resolveDocsFile(repoRoot, slug, page) {
+    const candidates = [
+        resolve(repoRoot, `docs/${slug}/${page}.md`),
+        ...(page === 'index' ? [resolve(repoRoot, `packages/${slug}/README.md`)] : []),
+    ];
+    return candidates.find((c) => existsSync(c)) ?? null;
+}
+// ---------------------------------------------------------------------------
+// Sigil CEM declarations
+// ---------------------------------------------------------------------------
+function readSigilDeclarations(repoRoot) {
+    const manifestPath = resolve(repoRoot, 'packages/sigil/dist/custom-elements.json');
+    if (!existsSync(manifestPath))
+        return [];
+    const manifest = readJson(manifestPath);
+    const modules = Array.isArray(manifest['modules']) ? manifest['modules'] : [];
+    return modules.flatMap((mod) => Array.isArray(mod['declarations']) ? mod['declarations'] : []);
+}
+// ---------------------------------------------------------------------------
+// Incremental hashing
+// ---------------------------------------------------------------------------
+function hashPackageFiles(repoRoot, folder, slug) {
+    const paths = [
+        resolve(repoRoot, folder, 'package.json'),
+        resolve(repoRoot, folder, 'src/index.ts'),
+        resolve(repoRoot, folder, 'README.md'),
+        ...DOC_PAGES.flatMap((page) => {
+            const f = resolveDocsFile(repoRoot, slug, page);
+            return f ? [f] : [];
+        }),
+        // Include CEM manifest so a sigil-only component change invalidates the cache
+        ...(slug === 'sigil' ? [resolve(repoRoot, 'packages/sigil/dist/custom-elements.json')] : []),
+    ];
+    const hash = createHash('sha256');
+    for (const p of paths) {
+        if (existsSync(p)) {
+            hash.update(p);
+            hash.update(readFileSync(p));
+        }
+    }
+    return hash.digest('hex');
+}
+function toStringArray(value, key) {
+    if (Array.isArray(value)) {
+        // parseFrontmatter always returns string[], but guard defensively for future callers.
+        const nonStrings = value.filter((v) => typeof v !== 'string');
+        if (nonStrings.length > 0) {
+            process.stderr.write(`codex generator warning: frontmatter field "${key ?? 'unknown'}" contains non-string items (${nonStrings.map(String).join(', ')}) — coercing to string.\n`);
+        }
+        return value.map(String);
+    }
+    return value ? [String(value)] : [];
+}
+function processPackage(repoRoot, project, sigilComponents) {
+    const slug = project.projectFolder.replace('packages/', '');
+    const pkgJson = readJson(resolve(repoRoot, project.projectFolder, 'package.json'));
+    const apiSource = readTextIfExists(resolve(repoRoot, project.projectFolder, 'src/index.ts'));
+    const indexContent = readTextIfExists(resolveDocsFile(repoRoot, slug, 'index')) ?? '';
+    const frontmatter = parseFrontmatter(indexContent);
+    const docs = {};
+    for (const page of DOC_PAGES) {
+        const content = readTextIfExists(resolveDocsFile(repoRoot, slug, page));
+        if (typeof content === 'string' && content.length > 0) {
+            docs[page] = content;
+        }
+    }
+    const availableDocPages = DOC_PAGES.filter((page) => docs[page] !== undefined);
+    return {
+        apiSource: typeof apiSource === 'string' && apiSource.length > 0 ? apiSource : null,
+        availableDocPages,
+        category: typeof frontmatter['category'] === 'string' ? frontmatter['category'] : '',
+        components: slug === 'sigil' ? sigilComponents : [],
+        description: typeof frontmatter['description'] === 'string' && frontmatter['description'].length > 0
+            ? frontmatter['description']
+            : typeof pkgJson['description'] === 'string'
+                ? pkgJson['description']
+                : '',
+        docs,
+        exports: toStringArray(frontmatter['exports'], 'exports'),
+        keywords: toStringArray(frontmatter['keywords'], 'keywords'),
+        name: String(project.packageName),
+        related: toStringArray(frontmatter['related'], 'related'),
+        slug,
+        version: typeof pkgJson['version'] === 'string' ? pkgJson['version'] : '0.0.0',
+    };
+}
+export function generateBundledData(options = {}) {
+    const packageRoot = resolve(__dirname, '..');
+    const repoRoot = options.repoRoot ?? resolve(packageRoot, '../..');
+    const incremental = options.incremental ?? false;
+    const existingDataFile = resolve(packageRoot, 'data/vielzeug-data.json');
+    const mcpPackageJson = readJson(resolve(packageRoot, 'package.json'));
+    const rushJson = readJson(resolve(repoRoot, 'rush.json'));
+    const sigilComponents = readSigilDeclarations(repoRoot);
+    // Load incremental cache
+    let hashCache = {};
+    let existingPackages = new Map();
+    if (incremental) {
+        const cacheFile = resolve(packageRoot, 'data/.cache.json');
+        if (existsSync(existingDataFile) && existsSync(cacheFile)) {
+            try {
+                hashCache = JSON.parse(readFileSync(cacheFile, 'utf8'));
+                const existingRaw = JSON.parse(readFileSync(existingDataFile, 'utf8'));
+                if (existingRaw['schemaVersion'] !== SCHEMA_VERSION) {
+                    process.stderr.write(`codex: schema version mismatch (found ${String(existingRaw['schemaVersion'])}, expected ${SCHEMA_VERSION}) — discarding cache.\n`);
+                    hashCache = {};
+                }
+                else {
+                    const existing = existingRaw;
+                    existingPackages = new Map(existing.packages.map((p) => [p.slug, p]));
+                }
+            }
+            catch (err) {
+                process.stderr.write(`codex: incremental cache read failed, falling back to full regeneration: ${err instanceof Error ? err.message : String(err)}\n`);
+                hashCache = {};
+                existingPackages = new Map();
+            }
+        }
+    }
+    let cacheHits = 0;
+    const newHashes = {};
+    const packages = rushJson.projects
+        .map((project) => {
+        const slug = project.projectFolder.replace('packages/', '');
+        if (incremental) {
+            const currentHash = hashPackageFiles(repoRoot, project.projectFolder, slug);
+            newHashes[slug] = currentHash;
+            if (hashCache[slug] === currentHash) {
+                const cached = existingPackages.get(slug);
+                if (cached) {
+                    cacheHits++;
+                    // Always refresh sigil components — they come from dist/, not source files
+                    if (slug === 'sigil')
+                        return { ...cached, components: sigilComponents };
+                    return cached;
+                }
+            }
+        }
+        return processPackage(repoRoot, project, sigilComponents);
+    })
+        .sort((a, b) => a.slug.localeCompare(b.slug));
+    if (incremental && cacheHits > 0) {
+        process.stderr.write(`Incremental: reused ${cacheHits}/${packages.length} packages from cache.\n`);
+    }
+    return {
+        data: {
+            packages,
+            schemaVersion: SCHEMA_VERSION,
+            version: typeof mcpPackageJson['version'] === 'string' ? mcpPackageJson['version'] : '0.0.0',
+        },
+        ...(incremental && { hashes: newHashes }),
+    };
+}
+//# sourceMappingURL=generator.js.map

package/dist/generator.js.map

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

package/dist/http.js

@@ -0,0 +1,108 @@
+import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { createServer as createHttpServer } from 'node:http';
+import { log } from './_log.js';
+function setCorsHeaders(res) {
+    res.setHeader('access-control-allow-headers', 'content-type, mcp-session-id');
+    res.setHeader('access-control-allow-methods', 'GET, POST, DELETE, OPTIONS');
+    res.setHeader('access-control-allow-origin', '*');
+}
+function handleError(err, res, req) {
+    const message = err instanceof Error ? err.message : String(err);
+    if (res.headersSent) {
+        const ctx = req ? ` [${req.method} ${req.url}]` : '';
+        log(`MCP HTTP error (mid-stream${ctx}): ${message}`);
+        if (!res.writableEnded)
+            res.end();
+        return;
+    }
+    res.statusCode = 500;
+    res.setHeader('content-type', 'application/json; charset=utf-8');
+    res.end(JSON.stringify({ error: message }));
+}
+/**
+ * Builds the HTTP request handler as a pure function — testable without binding a port.
+ * Exported for use in integration tests.
+ */
+export function createRequestHandler(streamableTransport, sseSessions, createSseServer, version) {
+    return (req, res) => {
+        setCorsHeaders(res);
+        const url = req.url ?? '/';
+        if (req.method === 'OPTIONS') {
+            res.statusCode = 204;
+            res.end();
+            return;
+        }
+        if (req.method === 'GET' && url === '/health') {
+            res.statusCode = 200;
+            res.setHeader('content-type', 'application/json; charset=utf-8');
+            res.end(JSON.stringify({ status: 'ok', ...(version !== undefined && { version }) }));
+            return;
+        }
+        // Legacy SSE: open a new SSE stream (each connection gets its own Server instance).
+        if (req.method === 'GET' && url === '/sse') {
+            const transport = new SSEServerTransport('/message', res);
+            const sseServer = createSseServer();
+            const cleanup = () => {
+                sseSessions.delete(transport.sessionId);
+            };
+            sseSessions.set(transport.sessionId, transport);
+            transport.onclose = cleanup;
+            void sseServer.connect(transport);
+            return;
+        }
+        // Legacy SSE: receive a client message.
+        if (req.method === 'POST' && url.startsWith('/message')) {
+            const sessionId = new URL(url, 'http://localhost').searchParams.get('sessionId') ?? '';
+            const session = sseSessions.get(sessionId);
+            if (!session) {
+                res.statusCode = 404;
+                res.end(JSON.stringify({ error: 'Session not found' }));
+                return;
+            }
+            void session.handlePostMessage(req, res).catch((err) => handleError(err, res, req));
+            return;
+        }
+        // Streamable HTTP (spec-compliant clients).
+        void streamableTransport.handleRequest(req, res).catch((err) => handleError(err, res, req));
+    };
+}
+export async function startHttpServer(mcpServer, port, createSseServer, version) {
+    // Legacy SSE sessions keyed by sessionId (for older MCP clients like Windsurf).
+    const sseSessions = new Map();
+    // Streamable HTTP transport (spec-compliant, newer clients).
+    const streamableTransport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
+    await mcpServer.connect(streamableTransport);
+    const httpServer = createHttpServer(createRequestHandler(streamableTransport, sseSessions, createSseServer, version));
+    await new Promise((resolve, reject) => {
+        const onError = (err) => reject(err);
+        httpServer.once('error', onError);
+        httpServer.listen(port, () => {
+            httpServer.off('error', onError);
+            log(`codex MCP server listening on http://localhost:${port}/`);
+            log(`  SSE (legacy):       GET  http://localhost:${port}/sse`);
+            log(`  Streamable HTTP:    POST http://localhost:${port}/`);
+            resolve();
+        });
+    });
+    let disposed = false;
+    const handle = {
+        dispose() {
+            if (disposed)
+                return Promise.resolve();
+            disposed = true;
+            return new Promise((resolve) => {
+                httpServer.closeAllConnections?.();
+                httpServer.close(() => resolve());
+            });
+        },
+        get disposed() {
+            return disposed;
+        },
+        [Symbol.asyncDispose]() {
+            return this.dispose();
+        },
+    };
+    return handle;
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/index.js

@@ -0,0 +1,6 @@
+export { loadData, packageMeta, validateBundledData } from './data.js';
+export { CodexError, ToolError } from './errors.js';
+export { createRequestHandler, startHttpServer } from './http.js';
+export { createServer, createServerFromDisk } from './server.js';
+export { SCHEMA_VERSION, } from './types.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,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAsB,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAGlE,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAcL,cAAc,GACf,MAAM,YAAY,CAAC"}