@vielzeug/codex 1.0.4 → 2.0.0

package/dist/snapshot.js

@@ -0,0 +1,233 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { CodexError } from './errors.js';
+import { DOC_PAGES, SNAPSHOT_SCHEMA_VERSION, } from './types.js';
+const DEFAULT_SNAPSHOT_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '../data');
+const DOC_PAGE_SET = new Set(DOC_PAGES);
+const SLUG_PATTERN = /^[a-z][a-z0-9-]*$/;
+const POINTER_DIRECTORY_PATTERN = /^snapshots\/[a-z0-9-]+$/;
+function fail(path, message) {
+    throw new CodexError(`Invalid snapshot at ${path}: ${message}`);
+}
+function record(value, path) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        fail(path, 'must be an object.');
+    return value;
+}
+function string(value, path) {
+    if (typeof value !== 'string')
+        fail(path, 'must be a string.');
+    return value;
+}
+function boolean(value, path) {
+    if (typeof value !== 'boolean')
+        fail(path, 'must be a boolean.');
+    return value;
+}
+function strings(value, path) {
+    if (!Array.isArray(value) || value.some((item) => typeof item !== 'string'))
+        fail(path, 'must be an array of strings.');
+    return value;
+}
+function json(path) {
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new CodexError(`Failed to read snapshot file ${path}: ${detail}`, { cause: error });
+    }
+}
+function equalStrings(left, right) {
+    return left.length === right.length && left.every((value, index) => value === right[index]);
+}
+function pageMap(value, path) {
+    const input = record(value, path);
+    const pages = {};
+    for (const [page, content] of Object.entries(input)) {
+        if (!DOC_PAGE_SET.has(page))
+            fail(`${path}.${page}`, `unknown page; expected one of ${DOC_PAGES.join(', ')}.`);
+        pages[page] = string(content, `${path}.${page}`);
+    }
+    return pages;
+}
+function examples(value, path) {
+    if (!Array.isArray(value))
+        fail(path, 'must be an array.');
+    const ids = new Set();
+    return value.map((item, index) => {
+        const entry = record(item, `${path}[${index}]`);
+        const id = string(entry.id, `${path}[${index}].id`);
+        if (ids.has(id))
+            fail(`${path}[${index}].id`, `duplicates ${id}.`);
+        ids.add(id);
+        return {
+            code: string(entry.code, `${path}[${index}].code`),
+            id,
+            name: string(entry.name, `${path}[${index}].name`),
+        };
+    });
+}
+export function parsePointer(value) {
+    const pointer = record(value, 'current.json');
+    const directory = string(pointer.directory, 'current.json.directory');
+    if (!POINTER_DIRECTORY_PATTERN.test(directory))
+        fail('current.json.directory', 'must reference one snapshot directory.');
+    return { directory };
+}
+export function parseManifest(value) {
+    const manifest = record(value, 'manifest.json');
+    if (manifest.schemaVersion !== SNAPSHOT_SCHEMA_VERSION)
+        fail('manifest.json.schemaVersion', `must equal ${SNAPSHOT_SCHEMA_VERSION}.`);
+    if (manifest.catalog !== 'catalog.json' ||
+        manifest.search !== 'search.json' ||
+        manifest.contentDirectory !== 'packages')
+        fail('manifest.json', 'has unsupported file layout.');
+    if (manifest.refine !== null && manifest.refine !== 'refine.json')
+        fail('manifest.json.refine', 'must be null or "refine.json".');
+    return {
+        catalog: 'catalog.json',
+        contentDirectory: 'packages',
+        refine: manifest.refine,
+        schemaVersion: SNAPSHOT_SCHEMA_VERSION,
+        search: 'search.json',
+        version: string(manifest.version, 'manifest.json.version'),
+    };
+}
+export function parseCatalog(value) {
+    const input = record(value, 'catalog.json');
+    if (!Array.isArray(input.packages))
+        fail('catalog.json.packages', 'must be an array.');
+    const slugs = new Set();
+    const packages = input.packages.map((item, index) => {
+        const path = `catalog.json.packages[${index}]`;
+        const entry = record(item, path);
+        const slug = string(entry.slug, `${path}.slug`);
+        if (!SLUG_PATTERN.test(slug))
+            fail(`${path}.slug`, 'must be a lowercase package slug.');
+        if (slugs.has(slug))
+            fail(`${path}.slug`, `duplicates ${slug}.`);
+        slugs.add(slug);
+        const pages = strings(entry.availableDocPages, `${path}.availableDocPages`);
+        if (pages.some((page) => !DOC_PAGE_SET.has(page)))
+            fail(`${path}.availableDocPages`, 'contains unknown page.');
+        return {
+            availableDocPages: pages,
+            category: string(entry.category, `${path}.category`),
+            description: string(entry.description, `${path}.description`),
+            exampleIds: strings(entry.exampleIds, `${path}.exampleIds`),
+            exports: strings(entry.exports, `${path}.exports`),
+            hasSource: boolean(entry.hasSource, `${path}.hasSource`),
+            keywords: strings(entry.keywords, `${path}.keywords`),
+            name: string(entry.name, `${path}.name`),
+            related: strings(entry.related, `${path}.related`),
+            slug,
+            version: string(entry.version, `${path}.version`),
+        };
+    });
+    return { packages, version: string(input.version, 'catalog.json.version') };
+}
+export function parseContent(value, slug) {
+    const path = `packages/${slug}.json`;
+    const input = record(value, path);
+    if (input.apiSource !== null && typeof input.apiSource !== 'string')
+        fail(`${path}.apiSource`, 'must be a string or null.');
+    const signatures = record(input.typeSignatures, `${path}.typeSignatures`);
+    for (const [name, text] of Object.entries(signatures))
+        string(text, `${path}.typeSignatures.${name}`);
+    return {
+        apiSource: input.apiSource,
+        docs: pageMap(input.docs, `${path}.docs`),
+        examples: examples(input.examples, `${path}.examples`),
+        typeSignatures: signatures,
+    };
+}
+export function parseSearch(value, catalog) {
+    if (!Array.isArray(value))
+        fail('search.json', 'must be an array.');
+    const catalogSlugs = new Set(catalog.packages.map((pkg) => pkg.slug));
+    const seen = new Set();
+    const records = value.map((item, index) => {
+        const path = `search.json[${index}]`;
+        const entry = record(item, path);
+        const slug = string(entry.slug, `${path}.slug`);
+        if (!catalogSlugs.has(slug))
+            fail(`${path}.slug`, 'does not exist in catalog.');
+        if (seen.has(slug))
+            fail(`${path}.slug`, `duplicates ${slug}.`);
+        seen.add(slug);
+        if (!Array.isArray(entry.examples))
+            fail(`${path}.examples`, 'must be an array.');
+        return {
+            category: string(entry.category, `${path}.category`),
+            description: string(entry.description, `${path}.description`),
+            docs: pageMap(entry.docs, `${path}.docs`),
+            examples: entry.examples.map((example, exampleIndex) => {
+                const value = record(example, `${path}.examples[${exampleIndex}]`);
+                return {
+                    id: string(value.id, `${path}.examples[${exampleIndex}].id`),
+                    text: string(value.text, `${path}.examples[${exampleIndex}].text`),
+                };
+            }),
+            exports: string(entry.exports, `${path}.exports`),
+            keywords: string(entry.keywords, `${path}.keywords`),
+            name: string(entry.name, `${path}.name`),
+            related: string(entry.related, `${path}.related`),
+            slug,
+            source: entry.source === null ? null : string(entry.source, `${path}.source`),
+        };
+    });
+    if (records.length !== catalog.packages.length)
+        fail('search.json', 'must have one record per catalog package.');
+    return records;
+}
+export function parseRefine(value) {
+    if (!Array.isArray(value))
+        fail('refine.json', 'must be an array.');
+    return value.map((item, index) => {
+        const declaration = record(item, `refine.json[${index}]`);
+        if (declaration.tagName !== undefined && typeof declaration.tagName !== 'string')
+            fail(`refine.json[${index}].tagName`, 'must be a string.');
+        return declaration;
+    });
+}
+function validateContent(meta, content) {
+    const pages = Object.keys(content.docs).sort();
+    const expectedPages = [...meta.availableDocPages].sort();
+    if (!equalStrings(pages, expectedPages))
+        fail(`packages/${meta.slug}.json.docs`, 'does not match catalog availableDocPages.');
+    const exampleIds = content.examples.map((example) => example.id).sort();
+    const expectedExampleIds = [...meta.exampleIds].sort();
+    if (!equalStrings(exampleIds, expectedExampleIds))
+        fail(`packages/${meta.slug}.json.examples`, 'does not match catalog exampleIds.');
+    if ((content.apiSource !== null) !== meta.hasSource)
+        fail(`packages/${meta.slug}.json.apiSource`, 'does not match catalog hasSource.');
+}
+export function loadSnapshotDirectory(directory, options = {}) {
+    const manifest = parseManifest(json(resolve(directory, 'manifest.json')));
+    const catalog = parseCatalog(json(resolve(directory, manifest.catalog)));
+    if (catalog.version !== manifest.version)
+        fail('catalog.json.version', 'does not match manifest version.');
+    const search = parseSearch(json(resolve(directory, manifest.search)), catalog);
+    const refineComponents = manifest.refine ? parseRefine(json(resolve(directory, manifest.refine))) : [];
+    const contentDirectory = resolve(directory, manifest.contentDirectory);
+    if (options.validateContents ?? false) {
+        for (const meta of catalog.packages)
+            validateContent(meta, parseContent(json(resolve(contentDirectory, `${meta.slug}.json`)), meta.slug));
+    }
+    return { catalog, contentDirectory, manifest, refineComponents, search };
+}
+export function loadSnapshot(snapshotRoot = DEFAULT_SNAPSHOT_ROOT, options = {}) {
+    if (!existsSync(snapshotRoot))
+        throw new CodexError(`Snapshot root not found: ${snapshotRoot}. Reinstall @vielzeug/codex or build it from source.`);
+    const pointerFile = resolve(snapshotRoot, 'current.json');
+    const directory = existsSync(pointerFile)
+        ? resolve(snapshotRoot, parsePointer(json(pointerFile)).directory)
+        : snapshotRoot;
+    return loadSnapshotDirectory(directory, options);
+}
+export function validateSnapshot(snapshotRoot = DEFAULT_SNAPSHOT_ROOT) {
+    loadSnapshot(snapshotRoot, { validateContents: true });
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/snapshot.js.map

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

package/dist/tools/index.js

@@ -1,61 +1,40 @@
 import { CallToolRequestSchema, ErrorCode, ListToolsRequestSchema, McpError } from '@modelcontextprotocol/sdk/types.js';
 import { log } from '../_log.js';
-import { ToolError } from '../errors.js';
+import { CatalogError } from '../catalog.js';
 import { packageTools } from './packages.js';
 import { refineTools } from './refine.js';
-export { buildToolContext } from './shared.js';
-// One flat list: generic package tools first, then refine's structured-metadata tools.
-// Deliberately no sandbox/ore/spell-specific tools — those used to hand-duplicate (and,
-// for sandbox, actively misrepresent) API surface already covered accurately by the
-// generic get-docs/get-source/get-type-signature tools above. See docs/sandbox/api.md,
-// docs/ore/api.md, docs/spell/api.md for that reference material instead.
-//
-// Exported (not just a local const) so scripts/generate-tool-docs.ts can render the
-// README tables straight from this registry instead of a hand-maintained copy.
 export const ALL_TOOLS = [...packageTools, ...refineTools];
-const TOOL_MAP = new Map(ALL_TOOLS.map((t) => [t.name, t]));
-const DEBUG = process.env['CODEX_DEBUG'] === '1';
-function debugArgs(args) {
-    const entries = Object.entries(args)
-        .map(([k, v]) => `${k}=${typeof v === 'string' ? JSON.stringify(v.length > 40 ? `${v.slice(0, 40)}…` : v) : String(v)}`)
-        .join(', ');
-    return entries ? `(${entries})` : '()';
+const byName = new Map(ALL_TOOLS.map((tool) => [tool.name, tool]));
+function content(value) {
+    return {
+        content: [{ text: typeof value === 'string' ? value : JSON.stringify(value, null, 2), type: 'text' }],
+    };
 }
-export function registerTools(server, context) {
+export function registerTools(server, catalog, debug = false) {
     server.setRequestHandler(ListToolsRequestSchema, () => ({
-        tools: ALL_TOOLS.map((tool) => ({ description: tool.description, inputSchema: tool.inputSchema, name: tool.name })),
+        tools: ALL_TOOLS.map(({ description, inputSchema, name }) => ({ description, inputSchema, name })),
     }));
     server.setRequestHandler(CallToolRequestSchema, (request) => {
-        const tool = TOOL_MAP.get(request.params.name);
-        if (!tool) {
-            if (DEBUG)
-                log(`[codex] tool not found: ${request.params.name}`);
+        const tool = byName.get(request.params.name);
+        if (!tool)
             throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${request.params.name}`);
-        }
-        const args = request.params.arguments ?? {};
-        if (DEBUG)
-            log(`[codex] → ${tool.name}${debugArgs(args)}`);
-        const t0 = DEBUG ? Date.now() : 0;
+        const started = Date.now();
         try {
-            const result = tool.run(args, context);
-            if (DEBUG)
-                log(`[codex] ✓ ${tool.name} (${Date.now() - t0}ms)`);
-            return result;
+            const result = tool.execute(request.params.arguments ?? {}, catalog);
+            if (debug)
+                log(`${tool.name} ${Date.now() - started}ms`);
+            return content(result);
         }
-        catch (err) {
-            // Every expected failure (bad arg, unknown slug/tag, missing bundled data) is a
-            // ToolError; anything else is a real bug and is left to propagate as a protocol error.
-            if (err instanceof ToolError) {
-                if (DEBUG)
-                    log(`[codex] ✗ ${tool.name} ${err.code}: ${err.message}`);
+        catch (error) {
+            if (error instanceof CatalogError) {
+                if (debug)
+                    log(`${tool.name} ${error.code}: ${error.message}`);
                 return {
-                    content: [{ text: JSON.stringify({ code: err.code, message: err.message }), type: 'text' }],
+                    content: [{ text: JSON.stringify({ code: error.code, message: error.message }), type: 'text' }],
                     isError: true,
                 };
             }
-            if (DEBUG)
-                log(`[codex] ✗ ${tool.name} threw: ${err instanceof Error ? err.message : String(err)}`);
-            throw err;
+            throw error;
         }
     });
 }

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAIxH,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,EAAE,YAAY,EAAgB,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,CAAC,MAAM,SAAS,GAA8B,CAAC,GAAG,YAAY,EAAE,GAAG,WAAW,CAAC,CAAC;AAEtF,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;AAEnE,SAAS,OAAO,CAAC,KAAc;IAC7B,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,CAAC;KAC/G,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,OAAgB,EAAE,KAAK,GAAG,KAAK;IAC3E,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,GAAG,EAAE,CAAC,CAAC;QACtD,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;KACnG,CAAC,CAAC,CAAC;IACJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,CAAC,OAAO,EAAE,EAAE;QAC1D,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAE7C,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,cAAc,EAAE,iBAAiB,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAEhG,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE3B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;YAErE,IAAI,KAAK;gBAAE,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,IAAI,CAAC,CAAC;YAEzD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;gBAClC,IAAI,KAAK;oBAAE,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBAE/D,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,CAAC;oBACxG,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/packages.js

@@ -1,196 +1,97 @@
-import { packageMeta } from '../data.js';
-import { ToolError } from '../errors.js';
-import { describeScoreTiers, scorePackage } from '../search.js';
 import { DOC_PAGES } from '../types.js';
 import { PACKAGE_SLUG_PROPERTY, parseArgs } from './schema.js';
-import { requirePackage, text } from './shared.js';
-// ---------------------------------------------------------------------------
-// list-packages
-// ---------------------------------------------------------------------------
-const listPackagesSchema = { properties: {}, type: 'object' };
-export const listPackagesTool = {
-    description: 'List all vielzeug packages with metadata (version, description, category, keywords, exports, availableDocPages, exampleIds, hasSource). Returns a JSON array of PackageMeta objects sorted by slug. Use this tool first to discover available packages, then call get-package for a single package, get-docs for docs, get-source for source, or get-example for a REPL example.',
-    inputSchema: listPackagesSchema,
-    name: 'list-packages',
-    run(_args, context) {
-        return text(JSON.stringify([...context.bySlug.values()].map(packageMeta), null, 2));
-    },
-};
-// ---------------------------------------------------------------------------
-// get-package
-// ---------------------------------------------------------------------------
-const getPackageSchema = {
+const empty = { properties: {}, type: 'object' };
+const slug = {
     properties: { packageSlug: PACKAGE_SLUG_PROPERTY },
     required: ['packageSlug'],
     type: 'object',
 };
-export const getPackageTool = {
-    description: 'Get metadata for a single vielzeug package by slug. Returns a PackageMeta object with version, description, category, keywords, exports, availableDocPages, exampleIds, and hasSource. Use list-packages first to discover available slugs.',
-    inputSchema: getPackageSchema,
-    name: 'get-package',
-    run(args, context) {
-        const { packageSlug } = parseArgs(getPackageSchema, args);
-        const pkg = requirePackage(context, packageSlug);
-        return text(JSON.stringify(packageMeta(pkg), null, 2));
-    },
-};
-// ---------------------------------------------------------------------------
-// get-docs
-// ---------------------------------------------------------------------------
-const getDocsSchema = {
+const docs = {
     properties: {
         packageSlug: PACKAGE_SLUG_PROPERTY,
-        page: { default: 'index', description: 'Doc page to read (defaults to "index")', enum: DOC_PAGES, type: 'string' },
-    },
-    required: ['packageSlug'],
-    type: 'object',
-};
-export const getDocsTool = {
-    description: 'Read a documentation page for a vielzeug package. Returns Markdown text. page defaults to "index" (overview + quick start). Use "api" for full API reference, "usage" for how-to guide, "examples" for recipe index. Check availableDocPages from list-packages before requesting a specific page.',
-    inputSchema: getDocsSchema,
-    name: 'get-docs',
-    run(args, context) {
-        const { packageSlug, page } = parseArgs(getDocsSchema, args);
-        const pkg = requirePackage(context, packageSlug);
-        const content = pkg.docs[page];
-        if (!content) {
-            throw new ToolError('NOT_FOUND', `No "${page}" page for "${packageSlug}". Available: ${pkg.availableDocPages.join(', ') || 'none'}.`);
-        }
-        return text(content);
-    },
-};
-// ---------------------------------------------------------------------------
-// get-source
-// ---------------------------------------------------------------------------
-const getSourceSchema = {
-    properties: { packageSlug: PACKAGE_SLUG_PROPERTY },
-    required: ['packageSlug'],
-    type: 'object',
-};
-export const getSourceTool = {
-    description: 'Read the full src/index.ts source of a vielzeug package. Returns TypeScript text with all exported function signatures, types, and JSDoc. Use this when you need exact type signatures or implementation details not covered by docs. Check hasSource from list-packages first — returns isError if no source is bundled.',
-    inputSchema: getSourceSchema,
-    name: 'get-source',
-    run(args, context) {
-        const { packageSlug } = parseArgs(getSourceSchema, args);
-        const pkg = requirePackage(context, packageSlug);
-        if (!pkg.apiSource)
-            throw new ToolError('UNAVAILABLE', `Package "${packageSlug}" has no src/index.ts source in bundled data.`);
-        return text(pkg.apiSource);
+        page: { default: 'index', description: 'Documentation page', enum: DOC_PAGES, type: 'string' },
     },
-};
-// ---------------------------------------------------------------------------
-// list-examples
-// ---------------------------------------------------------------------------
-const listExamplesSchema = {
-    properties: { packageSlug: PACKAGE_SLUG_PROPERTY },
     required: ['packageSlug'],
     type: 'object',
 };
-export const listExamplesTool = {
-    description: 'List runnable REPL code examples for a vielzeug package. Returns a JSON array of { id, name } (no code — use get-example for that). These are the same examples users can run interactively at vielzeug.dev/repl. Returns an empty array (not an error) for packages with no REPL examples (e.g. DOM-output packages like refine, prism, ore).',
-    inputSchema: listExamplesSchema,
-    name: 'list-examples',
-    run(args, context) {
-        const { packageSlug } = parseArgs(listExamplesSchema, args);
-        const pkg = requirePackage(context, packageSlug);
-        return text(JSON.stringify(pkg.examples.map(({ id, name }) => ({ id, name })), null, 2));
-    },
-};
-// ---------------------------------------------------------------------------
-// get-example
-// ---------------------------------------------------------------------------
-const getExampleSchema = {
+const example = {
     properties: {
-        exampleId: { description: 'Example id, e.g. "function-debounce"', maxLength: 100, minLength: 1, type: 'string' },
+        exampleId: { description: 'Example identifier', maxLength: 100, minLength: 1, type: 'string' },
         packageSlug: PACKAGE_SLUG_PROPERTY,
     },
     required: ['packageSlug', 'exampleId'],
     type: 'object',
 };
-export const getExampleTool = {
-    description: 'Read the full runnable source code of a single REPL example for a vielzeug package. Returns TypeScript text. Use list-examples first to discover valid exampleId values for a package.',
-    inputSchema: getExampleSchema,
-    name: 'get-example',
-    run(args, context) {
-        const { exampleId, packageSlug } = parseArgs(getExampleSchema, args);
-        const pkg = requirePackage(context, packageSlug);
-        const example = pkg.examples.find((e) => e.id === exampleId);
-        if (!example) {
-            const available = pkg.examples.map((e) => e.id).join(', ') || 'none';
-            throw new ToolError('NOT_FOUND', `No example "${exampleId}" for "${packageSlug}". Available: ${available}.`);
-        }
-        return text(example.code);
-    },
-};
-// ---------------------------------------------------------------------------
-// search-packages
-// ---------------------------------------------------------------------------
-const searchPackagesSchema = {
-    properties: { query: { description: 'Non-empty search term', maxLength: 500, minLength: 1, type: 'string' } },
+const query = {
+    properties: { query: { description: 'Non-empty search query', maxLength: 500, minLength: 1, type: 'string' } },
     required: ['query'],
     type: 'object',
 };
-export const searchPackagesTool = {
-    description: `Search vielzeug packages by keyword across name, description, category, keywords, exports, related, docs, REPL examples, and source. Supports multi-word queries (all words must match). Returns a JSON array of SearchHit objects sorted by score descending. score: ${describeScoreTiers()}. Returns empty array (not an error) when nothing matches. Prefer this over list-packages when you know what you are looking for.`,
-    inputSchema: searchPackagesSchema,
-    name: 'search-packages',
-    run(args, context) {
-        const { query } = parseArgs(searchPackagesSchema, args);
-        const results = context.normalisedPackages
-            .map((pkg) => scorePackage(pkg, query))
-            .filter((hit) => hit !== null)
-            .sort((a, b) => b.score - a.score || a.slug.localeCompare(b.slug));
-        return text(JSON.stringify(results, null, 2));
-    },
-};
-// ---------------------------------------------------------------------------
-// get-type-signature
-// ---------------------------------------------------------------------------
-const getTypeSignatureSchema = {
+const signature = {
     properties: {
         slug: PACKAGE_SLUG_PROPERTY,
-        symbol: {
-            description: 'Exported name to look up, e.g. "debounce" or "SearchOptions"',
-            maxLength: 200,
-            minLength: 1,
-            type: 'string',
-        },
+        symbol: { description: 'Exported symbol name', maxLength: 200, minLength: 1, type: 'string' },
     },
     required: ['slug', 'symbol'],
     type: 'object',
 };
-export const getTypeSignatureTool = {
-    description: "Look up the exported TypeScript declaration for a named symbol from a @vielzeug package's bundled src/index.ts (extracted and indexed at build time, not parsed per-request). Returns the raw declaration text — useful for verifying the exact signature of a function, type alias, interface, or constant without loading the full source. Returns isError when the package has no bundled source or the symbol is not found.",
-    inputSchema: getTypeSignatureSchema,
-    name: 'get-type-signature',
-    run(args, context) {
-        const { slug, symbol } = parseArgs(getTypeSignatureSchema, args);
-        const pkg = requirePackage(context, slug);
-        if (!pkg.apiSource)
-            throw new ToolError('UNAVAILABLE', `Package "${slug}" has no bundled source.`);
-        // `Object.hasOwn` guard (not just `pkg.typeSignatures[symbol]` + truthiness): `symbol` is
-        // arbitrary user input with no charset/enum restriction. Without this check, a symbol like
-        // "__proto__", "constructor", or "toString" would resolve through the prototype chain to a
-        // real (but never bundled) `Object.prototype` member — a truthy non-string value — bypassing
-        // the not-found check below and returning a malformed result instead of a clean NOT_FOUND.
-        if (!Object.hasOwn(pkg.typeSignatures, symbol)) {
-            throw new ToolError('NOT_FOUND', `"${symbol}" not found in ${slug}/src/index.ts.`);
-        }
-        const declaration = pkg.typeSignatures[symbol];
-        if (!declaration)
-            throw new ToolError('NOT_FOUND', `"${symbol}" not found in ${slug}/src/index.ts.`);
-        return text(declaration);
-    },
-};
 export const packageTools = [
-    listPackagesTool,
-    getPackageTool,
-    getDocsTool,
-    getSourceTool,
-    listExamplesTool,
-    getExampleTool,
-    searchPackagesTool,
-    getTypeSignatureTool,
+    {
+        description: 'List every Vielzeug package. Start here for package discovery.',
+        execute: (_args, catalog) => catalog.listPackages(),
+        inputSchema: empty,
+        name: 'list-packages',
+    },
+    {
+        description: 'Read metadata for one package.',
+        execute: (args, catalog) => catalog.getPackage(parseArgs(slug, args).packageSlug),
+        inputSchema: slug,
+        name: 'get-package',
+    },
+    {
+        description: 'Read one documentation page as Markdown.',
+        execute: (args, catalog) => {
+            const input = parseArgs(docs, args);
+            return catalog.getDocs(input.packageSlug, input.page);
+        },
+        inputSchema: docs,
+        name: 'get-docs',
+    },
+    {
+        description: 'Read bundled public source for one package.',
+        execute: (args, catalog) => catalog.getSource(parseArgs(slug, args).packageSlug),
+        inputSchema: slug,
+        name: 'get-source',
+    },
+    {
+        description: 'List runnable REPL examples for one package.',
+        execute: (args, catalog) => catalog.listExamples(parseArgs(slug, args).packageSlug),
+        inputSchema: slug,
+        name: 'list-examples',
+    },
+    {
+        description: 'Read one runnable REPL example.',
+        execute: (args, catalog) => {
+            const input = parseArgs(example, args);
+            return catalog.getExample(input.packageSlug, input.exampleId).code;
+        },
+        inputSchema: example,
+        name: 'get-example',
+    },
+    {
+        description: 'Search package metadata, docs, examples, and source. Results use deterministic slug order.',
+        execute: (args, catalog) => catalog.search(parseArgs(query, args).query),
+        inputSchema: query,
+        name: 'search-packages',
+    },
+    {
+        description: 'Read one exported TypeScript declaration.',
+        execute: (args, catalog) => {
+            const input = parseArgs(signature, args);
+            return catalog.getTypeSignature(input.slug, input.symbol);
+        },
+        inputSchema: signature,
+        name: 'get-type-signature',
+    },
 ];
 //# sourceMappingURL=packages.js.map