@vielzeug/codex 1.0.2

package/dist/llms.js

@@ -0,0 +1,162 @@
+// ---------------------------------------------------------------------------
+// Markup stripping
+// ---------------------------------------------------------------------------
+export function stripDocMarkup(md) {
+    return md
+        .replace(/^---\n[\s\S]*?\n---\n?/, '') // frontmatter
+        .replace(/<!--[\s\S]*?-->/g, '') // HTML comments
+        .replace(/<[^>]+>/g, '') // HTML tags
+        .replace(/^\[\[toc]]\s*$/gm, '') // VitePress TOC directive
+        .replace(/^:::[\s\S]*?:::\s*$/gm, (m) => m.replace(/^:::[^\n]*\n?|^:::\s*$/gm, '')) // containers
+        .replace(/\n{3,}/g, '\n\n') // normalise consecutive blank lines
+        .trim();
+}
+// ---------------------------------------------------------------------------
+// Category ordering
+// ---------------------------------------------------------------------------
+const CATEGORY_ORDER = [
+    'state',
+    'ui',
+    'ui-components',
+    'ui-primitives',
+    'ui-interaction',
+    'ui-performance',
+    'forms',
+    'data',
+    'http',
+    'websockets',
+    'events',
+    'workers',
+    'storage',
+    'auth',
+    'routing',
+    'i18n',
+    'di',
+    'validation',
+    'utilities',
+    'time',
+    'logging',
+    'ai-tooling',
+];
+function groupByCategory(packages) {
+    const map = new Map();
+    for (const pkg of packages) {
+        const cat = pkg.category || 'general';
+        if (!map.has(cat))
+            map.set(cat, []);
+        map.get(cat).push(pkg);
+    }
+    return map;
+}
+function sortedCategories(grouped) {
+    return [...grouped.keys()].sort((a, b) => {
+        const ai = CATEGORY_ORDER.indexOf(a);
+        const bi = CATEGORY_ORDER.indexOf(b);
+        if (ai !== -1 && bi !== -1)
+            return ai - bi;
+        if (ai !== -1)
+            return -1;
+        if (bi !== -1)
+            return 1;
+        return a.localeCompare(b);
+    });
+}
+// ---------------------------------------------------------------------------
+// llms.txt — summary file
+// ---------------------------------------------------------------------------
+function buildLlmsTxt(packages, version) {
+    const grouped = groupByCategory(packages);
+    const categories = sortedCategories(grouped);
+    const lines = [
+        '# Vielzeug',
+        '',
+        `> ${packages.length} focused TypeScript packages for state, UI, data, storage, routing, utilities, and AI tooling. Version: ${version}`,
+        '',
+        'Vielzeug is a monorepo of focused TypeScript packages — from low-level utilities to UI primitives,',
+        'routing, storage, validation, workers, and an MCP server for AI assistants. Packages are designed',
+        'to be independently consumable, ship ESM + CJS output, and target ES2022.',
+        '',
+        'Install any package independently: `pnpm add @vielzeug/<name>`',
+        '',
+        '**MCP (AI agents):** `npx -y @vielzeug/codex` runs the Vielzeug MCP server in standalone stdio mode',
+        'with bundled data — no monorepo checkout required. Use `npx -y @vielzeug/codex --port 3100`',
+        'for Streamable HTTP with package discovery, docs lookup, source inspection, and Sigil component metadata.',
+        '',
+        '## Packages',
+        '',
+    ];
+    for (const cat of categories) {
+        const pkgs = grouped.get(cat);
+        lines.push(`### ${cat}`);
+        lines.push('');
+        for (const pkg of pkgs) {
+            const pageLinks = pkg.availableDocPages
+                .filter((p) => p !== 'index')
+                .map((p) => `[${p}](/${pkg.slug}/${p})`)
+                .join(' · ');
+            let line = `- [${pkg.name}](/${pkg.slug}/): ${pkg.description}`;
+            if (pageLinks)
+                line += ` → ${pageLinks}`;
+            lines.push(line);
+        }
+        lines.push('');
+    }
+    return lines.join('\n').trimEnd() + '\n';
+}
+// ---------------------------------------------------------------------------
+// llms-full.txt — complete documentation
+// ---------------------------------------------------------------------------
+const PAGE_LABELS = {
+    api: 'API Reference',
+    examples: 'Examples',
+    index: 'Overview',
+    usage: 'Usage Guide',
+};
+const PAGE_ORDER = ['index', 'api', 'usage', 'examples'];
+function buildLlmsFullTxt(packages, version) {
+    const lines = [
+        '# Vielzeug — Full Documentation',
+        '',
+        `> Complete documentation for all ${packages.length} Vielzeug packages. Version: ${version}`,
+    ];
+    for (const pkg of packages) {
+        lines.push('');
+        lines.push('---');
+        lines.push('');
+        lines.push(`## ${pkg.name}`);
+        lines.push('');
+        lines.push(`**Category:** ${pkg.category || 'general'}`);
+        if (pkg.keywords.length > 0) {
+            lines.push(`**Keywords:** ${pkg.keywords.join(', ')}`);
+        }
+        if (pkg.exports.length > 0) {
+            const shown = pkg.exports.slice(0, 12);
+            const overflow = pkg.exports.length > 12 ? ` (+${pkg.exports.length - 12} more)` : '';
+            lines.push(`**Key exports:** ${shown.join(', ')}${overflow}`);
+        }
+        if (pkg.related.length > 0) {
+            lines.push(`**Related:** ${pkg.related.join(', ')}`);
+        }
+        lines.push('');
+        for (const page of PAGE_ORDER) {
+            const content = pkg.docs[page];
+            if (!content)
+                continue;
+            const stripped = stripDocMarkup(content);
+            if (!stripped)
+                continue;
+            lines.push(`### ${PAGE_LABELS[page]}`);
+            lines.push('');
+            lines.push(stripped);
+            lines.push('');
+        }
+    }
+    return lines.join('\n').trimEnd() + '\n';
+}
+export function generateLlmsTxt(data) {
+    return {
+        llmsFullTxt: buildLlmsFullTxt(data.packages, data.version),
+        llmsTxt: buildLlmsTxt(data.packages, data.version),
+    };
+}
+//# sourceMappingURL=llms.js.map

package/dist/llms.js.map

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

package/dist/port.js

@@ -0,0 +1,12 @@
+import { CodexError } from './errors.js';
+/** Parses and validates a --port CLI argument. Returns the port number or null if omitted. */
+export function resolvePort(raw) {
+    if (raw === undefined)
+        return null;
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isFinite(n) || n < 1 || n > 65535 || n !== Number(raw)) {
+        throw new CodexError(`Invalid --port value: "${raw}". Expected an integer between 1 and 65535.`);
+    }
+    return n;
+}
+//# sourceMappingURL=port.js.map

package/dist/port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.js","sourceRoot":"","sources":["../src/port.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,8FAA8F;AAC9F,MAAM,UAAU,WAAW,CAAC,GAAuB;IACjD,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAEnC,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAEnC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,UAAU,CAAC,0BAA0B,GAAG,6CAA6C,CAAC,CAAC;IACnG,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/resources.js

@@ -0,0 +1,4 @@
+export {};
+// Resources surface removed — all doc content and source is accessible via the
+// get-docs and get-source MCP tools, which provide better lookup DX and error messages.
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,wFAAwF"}

package/dist/search.js

@@ -0,0 +1,125 @@
+// ---------------------------------------------------------------------------
+// Normalisation
+// ---------------------------------------------------------------------------
+function normalise(s) {
+    return s.toLowerCase().replace(/-/g, ' ');
+}
+export function normalisePackage(pkg) {
+    const docs = {};
+    for (const page of pkg.availableDocPages) {
+        const content = pkg.docs[page];
+        if (typeof content === 'string')
+            docs[page] = normalise(content);
+    }
+    return {
+        availableDocPages: pkg.availableDocPages,
+        category: normalise(pkg.category),
+        description: normalise(pkg.description),
+        docs,
+        examples: pkg.examples.map((e) => ({ id: e.id, text: normalise(`${e.name} ${e.code}`) })),
+        exports: pkg.exports.map(normalise).join(' '),
+        keywords: pkg.keywords.map(normalise).join(' '),
+        name: pkg.name,
+        related: pkg.related.map(normalise).join(' '),
+        slug: pkg.slug,
+        source: pkg.apiSource ? normalise(pkg.apiSource) : null,
+    };
+}
+// ---------------------------------------------------------------------------
+// Scoring
+// ---------------------------------------------------------------------------
+/** Returns true if every term appears in the already-normalised haystack. */
+function allTermsMatch(haystack, terms) {
+    return terms.every((t) => haystack.includes(t));
+}
+/** Weighted scores — higher = stronger signal within tier. */
+const W = {
+    category: 3.5,
+    description: 3.1,
+    docs: 1.0,
+    examples: 0.95,
+    exports: 2.2,
+    keywords: 2.5,
+    name: 3.9,
+    related: 2.0,
+    source: 0.9,
+};
+/**
+ * Ordered highest-to-lowest for `describeScoreTiers()`. Single source of truth for the
+ * search-packages tool description's "score: name(3.9) > category(3.5) > ..." prose — the
+ * numbers used to be hand-typed into that description separately from `W`, so retuning a
+ * weight silently made the description lie about the actual scoring.
+ */
+const SCORE_TIERS = [
+    ['name', W.name],
+    ['category', W.category],
+    ['description', W.description],
+    ['keywords', W.keywords],
+    ['exports', W.exports],
+    ['related', W.related],
+    ['docs', W.docs],
+    ['examples', W.examples],
+    ['source', W.source],
+];
+export function describeScoreTiers() {
+    return SCORE_TIERS.map(([label, weight]) => `${label}(${weight})`).join(' > ');
+}
+/** Fields matched by simple substring inclusion, where the matchedIn category name equals the field name. */
+const SIMPLE_FIELDS = ['keywords', 'exports', 'related', 'source'];
+/** Score a pre-normalised package against a query. The query is normalised here; fields are pre-normalised. */
+export function scorePackage(pkg, query) {
+    const terms = normalise(query)
+        .split(/\s+/)
+        .filter((t) => t.length > 0);
+    if (terms.length === 0)
+        return null;
+    let score = 0;
+    const matched = new Set();
+    const matchedPages = [];
+    const matchedExamples = [];
+    if (allTermsMatch(normalise(pkg.name), terms)) {
+        score = Math.max(score, W.name);
+        matched.add('metadata');
+    }
+    if (allTermsMatch(pkg.category, terms)) {
+        score = Math.max(score, W.category);
+        matched.add('metadata');
+    }
+    if (allTermsMatch(pkg.description, terms)) {
+        score = Math.max(score, W.description);
+        matched.add('metadata');
+    }
+    for (const field of SIMPLE_FIELDS) {
+        const value = pkg[field];
+        if (value && allTermsMatch(value, terms)) {
+            score = Math.max(score, W[field]);
+            matched.add(field);
+        }
+    }
+    for (const page of pkg.availableDocPages) {
+        const content = pkg.docs[page];
+        if (typeof content === 'string' && allTermsMatch(content, terms)) {
+            score = Math.max(score, W.docs);
+            matched.add('docs');
+            matchedPages.push(page);
+        }
+    }
+    for (const example of pkg.examples) {
+        if (allTermsMatch(example.text, terms)) {
+            score = Math.max(score, W.examples);
+            matched.add('examples');
+            matchedExamples.push(example.id);
+        }
+    }
+    if (score === 0)
+        return null;
+    return {
+        ...(matchedExamples.length > 0 && { matchedExamples }),
+        matchedIn: [...matched],
+        ...(matchedPages.length > 0 && { matchedPages }),
+        name: pkg.name,
+        score,
+        slug: pkg.slug,
+    };
+}
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

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

package/dist/server.js

@@ -0,0 +1,13 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { loadData } from './data.js';
+import { buildToolContext, registerTools } from './tools/index.js';
+export function createServer(data) {
+    const server = new Server({ name: 'vielzeug', version: data.version }, { capabilities: { tools: {} } });
+    registerTools(server, buildToolContext(data));
+    return server;
+}
+/** Convenience factory: loads bundled data from disk and creates the MCP server in one call. */
+export function createServerFromDisk() {
+    return createServer(loadData());
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAInE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEnE,MAAM,UAAU,YAAY,CAAC,IAAiB;IAC5C,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAExG,aAAa,CAAC,MAAM,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;IAE9C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,oBAAoB;IAClC,OAAO,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC;AAClC,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,62 @@
+import { CallToolRequestSchema, ErrorCode, ListToolsRequestSchema, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { log } from '../_log.js';
+import { ToolError } from '../errors.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})` : '()';
+}
+export function registerTools(server, context) {
+    server.setRequestHandler(ListToolsRequestSchema, () => ({
+        tools: ALL_TOOLS.map((tool) => ({ description: tool.description, inputSchema: tool.inputSchema, name: tool.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}`);
+            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;
+        try {
+            const result = tool.run(args, context);
+            if (DEBUG)
+                log(`[codex] ✓ ${tool.name} (${Date.now() - t0}ms)`);
+            return 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}`);
+                return {
+                    content: [{ text: JSON.stringify({ code: err.code, message: err.message }), type: 'text' }],
+                    isError: true,
+                };
+            }
+            if (DEBUG)
+                log(`[codex] ✗ ${tool.name} threw: ${err instanceof Error ? err.message : String(err)}`);
+            throw err;
+        }
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

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

package/dist/tools/packages.js

@@ -0,0 +1,196 @@
+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 = {
+    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 = {
+    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);
+    },
+};
+// ---------------------------------------------------------------------------
+// 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 = {
+    properties: {
+        exampleId: { description: 'Example id, e.g. "function-debounce"', 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' } },
+    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 = {
+    properties: {
+        slug: PACKAGE_SLUG_PROPERTY,
+        symbol: {
+            description: 'Exported name to look up, e.g. "debounce" or "SearchOptions"',
+            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,
+];
+//# sourceMappingURL=packages.js.map

package/dist/tools/packages.js.map

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