@creatorem/mcp-server 0.1.0

package/dist/src/rpc-server.js

@@ -0,0 +1,189 @@
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+export class RpcServer {
+    #serverName;
+    #serverVersion;
+    #tools;
+    #callTool;
+    #defaultProtocolVersion;
+    #buffer = Buffer.alloc(0);
+    #started = false;
+    constructor(options) {
+        this.#serverName = options.serverName;
+        this.#serverVersion = options.serverVersion;
+        this.#tools = options.tools;
+        this.#callTool = options.callTool;
+        this.#defaultProtocolVersion = options.defaultProtocolVersion ?? '2025-03-26';
+    }
+    start() {
+        if (this.#started) {
+            return;
+        }
+        this.#started = true;
+        process.stdin.on('data', (chunk) => {
+            this.#onData(chunk);
+        });
+        process.stdin.on('error', (error) => {
+            this.#log(`stdin error: ${error instanceof Error ? error.message : String(error)}`);
+        });
+        process.stdin.resume();
+    }
+    #onData(chunk) {
+        const data = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        this.#buffer = Buffer.concat([this.#buffer, data]);
+        while (true) {
+            const headerEnd = this.#buffer.indexOf('\r\n\r\n');
+            if (headerEnd === -1) {
+                return;
+            }
+            const headerBlock = this.#buffer.subarray(0, headerEnd).toString('utf8');
+            const contentLength = this.#readContentLength(headerBlock);
+            if (contentLength === null) {
+                this.#log(`invalid message headers: ${headerBlock}`);
+                this.#buffer = this.#buffer.subarray(headerEnd + 4);
+                continue;
+            }
+            const bodyStart = headerEnd + 4;
+            const bodyEnd = bodyStart + contentLength;
+            if (this.#buffer.length < bodyEnd) {
+                return;
+            }
+            const body = this.#buffer.subarray(bodyStart, bodyEnd).toString('utf8');
+            this.#buffer = this.#buffer.subarray(bodyEnd);
+            let parsed;
+            try {
+                parsed = JSON.parse(body);
+            }
+            catch {
+                this.#sendError(null, -32700, 'Parse error');
+                continue;
+            }
+            void this.#handleMessage(parsed);
+        }
+    }
+    #readContentLength(headers) {
+        const lines = headers.split('\r\n');
+        for (const line of lines) {
+            const match = /^content-length\s*:\s*(\d+)$/i.exec(line.trim());
+            if (!match || !match[1]) {
+                continue;
+            }
+            const parsed = Number.parseInt(match[1], 10);
+            return Number.isFinite(parsed) ? parsed : null;
+        }
+        return null;
+    }
+    async #handleMessage(raw) {
+        if (!isRecord(raw) || raw.jsonrpc !== '2.0' || typeof raw.method !== 'string') {
+            this.#sendError(null, -32600, 'Invalid Request');
+            return;
+        }
+        const request = raw;
+        const id = request.id ?? null;
+        const isNotification = request.id === undefined;
+        switch (request.method) {
+            case 'initialize': {
+                if (isNotification) {
+                    return;
+                }
+                const protocolVersion = this.#extractProtocolVersion(request.params);
+                this.#sendResult(id, {
+                    protocolVersion,
+                    capabilities: {
+                        tools: {
+                            listChanged: false,
+                        },
+                    },
+                    serverInfo: {
+                        name: this.#serverName,
+                        version: this.#serverVersion,
+                    },
+                });
+                return;
+            }
+            case 'notifications/initialized':
+                return;
+            case 'tools/list': {
+                if (isNotification) {
+                    return;
+                }
+                this.#sendResult(id, {
+                    tools: this.#tools,
+                });
+                return;
+            }
+            case 'tools/call': {
+                if (isNotification) {
+                    return;
+                }
+                if (!isRecord(request.params)) {
+                    this.#sendError(id, -32602, 'Invalid params: expected object');
+                    return;
+                }
+                const name = request.params.name;
+                const args = request.params.arguments;
+                if (typeof name !== 'string' || name.trim().length === 0) {
+                    this.#sendError(id, -32602, 'Invalid params: "name" must be a non-empty string');
+                    return;
+                }
+                const result = await this.#callTool(name, args);
+                this.#sendResult(id, result);
+                return;
+            }
+            case 'ping': {
+                if (isNotification) {
+                    return;
+                }
+                this.#sendResult(id, {});
+                return;
+            }
+            case 'shutdown': {
+                if (isNotification) {
+                    return;
+                }
+                this.#sendResult(id, {});
+                return;
+            }
+            default:
+                if (!isNotification) {
+                    this.#sendError(id, -32601, `Method not found: ${request.method}`);
+                }
+        }
+    }
+    #extractProtocolVersion(params) {
+        if (isRecord(params) && typeof params.protocolVersion === 'string') {
+            return params.protocolVersion;
+        }
+        return this.#defaultProtocolVersion;
+    }
+    #sendResult(id, result) {
+        const payload = {
+            jsonrpc: '2.0',
+            id,
+            result,
+        };
+        this.#write(payload);
+    }
+    #sendError(id, code, message, data) {
+        const payload = {
+            jsonrpc: '2.0',
+            id,
+            error: {
+                code,
+                message,
+                ...(data === undefined ? {} : { data }),
+            },
+        };
+        this.#write(payload);
+    }
+    #write(payload) {
+        const body = JSON.stringify(payload);
+        const header = `Content-Length: ${Buffer.byteLength(body, 'utf8')}\r\n\r\n`;
+        process.stdout.write(header + body);
+    }
+    #log(message) {
+        process.stderr.write(`[mcp-server] ${message}\n`);
+    }
+}
+//# sourceMappingURL=rpc-server.js.map

package/dist/src/rpc-server.js.map

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

package/dist/src/tools.d.ts

@@ -0,0 +1,8 @@
+import { DocsClient } from './docs-client.js';
+import type { ToolDefinition, ToolResult } from './types.js';
+type ToolHandler = (args: unknown) => Promise<ToolResult>;
+export declare const TOOL_DEFINITIONS: ToolDefinition[];
+export declare function createToolHandlers(client: DocsClient): Record<string, ToolHandler>;
+export declare function callTool(handlers: Record<string, ToolHandler>, name: string, args: unknown): Promise<ToolResult>;
+export {};
+//# sourceMappingURL=tools.d.ts.map

package/dist/src/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,KAAK,EAA6B,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExF,KAAK,WAAW,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAkI1D,eAAO,MAAM,gBAAgB,EAAE,cAAc,EAoD5C,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CA2GlF;AAED,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,uBAWhG"}

package/dist/src/tools.js

@@ -0,0 +1,268 @@
+import { searchCapabilities } from './capability-search.js';
+import { NotFoundError, UpstreamUnavailableError, ValidationError } from './errors.js';
+import { normalizeDocsUrl } from './url-utils.js';
+const MAX_LIMIT = 100;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function asObject(value) {
+    if (!isRecord(value)) {
+        return {};
+    }
+    return value;
+}
+function readOptionalString(record, key) {
+    const value = record[key];
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (typeof value !== 'string') {
+        throw new ValidationError(`"${key}" must be a string.`);
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function readRequiredString(record, key) {
+    const value = readOptionalString(record, key);
+    if (!value) {
+        throw new ValidationError(`"${key}" is required.`);
+    }
+    return value;
+}
+function readOptionalStringArray(record, key) {
+    const value = record[key];
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (!Array.isArray(value) || value.some((item) => typeof item !== 'string')) {
+        throw new ValidationError(`"${key}" must be an array of strings.`);
+    }
+    return value.map((item) => item.trim()).filter(Boolean);
+}
+function readOptionalInt(record, key, fallback) {
+    const value = record[key];
+    if (value === undefined || value === null) {
+        return fallback;
+    }
+    if (typeof value !== 'number' || !Number.isInteger(value)) {
+        throw new ValidationError(`"${key}" must be an integer.`);
+    }
+    return Math.min(Math.max(1, value), MAX_LIMIT);
+}
+function capabilitySummary(capability) {
+    return {
+        id: capability.id,
+        title: capability.title,
+        description: capability.description,
+        pageUrl: capability.pageUrl,
+        llmUrl: capability.llmUrl,
+        tags: capability.tags ?? [],
+        aliases: capability.aliases ?? [],
+        status: capability.status,
+    };
+}
+function textResult(data) {
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(data, null, 2),
+            },
+        ],
+        structuredContent: data,
+    };
+}
+function errorResult(code, message, details) {
+    const payload = {
+        ok: false,
+        error: {
+            code,
+            message,
+            ...(details ? { details } : {}),
+        },
+    };
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(payload, null, 2),
+            },
+        ],
+        structuredContent: payload,
+        isError: true,
+    };
+}
+function mapToolError(error) {
+    if (error instanceof ValidationError) {
+        return errorResult('INVALID_INPUT', error.message);
+    }
+    if (error instanceof NotFoundError) {
+        return errorResult('NOT_FOUND', error.message);
+    }
+    if (error instanceof UpstreamUnavailableError) {
+        const details = error.status ? { status: error.status } : undefined;
+        return errorResult('UPSTREAM_UNAVAILABLE', error.message, details);
+    }
+    const message = error instanceof Error ? error.message : 'Unknown tool error';
+    return errorResult('UNKNOWN_ERROR', message);
+}
+export const TOOL_DEFINITIONS = [
+    {
+        name: 'creatorem.list_capabilities',
+        description: 'List Creatorem documentation capabilities from mcp-index.json.',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                query: { type: 'string', description: 'Optional free-text query for ranking/filtering.' },
+                tags: { type: 'array', items: { type: 'string' }, description: 'Optional tags filter (any match).' },
+                status: { type: 'string', description: 'Optional status filter.' },
+                limit: { type: 'integer', minimum: 1, maximum: MAX_LIMIT, description: 'Max rows to return.' },
+            },
+        },
+    },
+    {
+        name: 'creatorem.get_capability',
+        description: 'Get a single capability by ID with related page metadata.',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            required: ['capabilityId'],
+            properties: {
+                capabilityId: { type: 'string', description: 'Capability identifier from mcp-index.json.' },
+            },
+        },
+    },
+    {
+        name: 'creatorem.get_page_content',
+        description: 'Fetch LLM-ready page content for a given /docs URL.',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            required: ['pageUrl'],
+            properties: {
+                pageUrl: { type: 'string', description: 'Docs page URL such as /docs/web/features/settings.' },
+            },
+        },
+    },
+    {
+        name: 'creatorem.search_capabilities',
+        description: 'Search capabilities by ID/title/description/tags/aliases with scoring.',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            required: ['query'],
+            properties: {
+                query: { type: 'string', description: 'Search query.' },
+                limit: { type: 'integer', minimum: 1, maximum: MAX_LIMIT, description: 'Max rows to return.' },
+            },
+        },
+    },
+];
+export function createToolHandlers(client) {
+    return {
+        'creatorem.list_capabilities': async (args) => {
+            const input = asObject(args);
+            const query = readOptionalString(input, 'query');
+            const tags = readOptionalStringArray(input, 'tags')?.map((item) => item.toLowerCase());
+            const status = readOptionalString(input, 'status')?.toLowerCase();
+            const limit = readOptionalInt(input, 'limit', 50);
+            const index = await client.getIndex();
+            let capabilities = [...index.capabilities];
+            if (tags && tags.length > 0) {
+                capabilities = capabilities.filter((capability) => {
+                    const capabilityTags = (capability.tags ?? []).map((tag) => tag.toLowerCase());
+                    return tags.some((tag) => capabilityTags.includes(tag));
+                });
+            }
+            if (status) {
+                capabilities = capabilities.filter((capability) => capability.status && capability.status.toLowerCase() === status);
+            }
+            if (query) {
+                const ranked = searchCapabilities(capabilities, query).slice(0, limit);
+                return textResult({
+                    ok: true,
+                    query,
+                    total: capabilities.length,
+                    count: ranked.length,
+                    generatedAt: index.generatedAt,
+                    capabilities: ranked.map((entry) => ({
+                        ...capabilitySummary(entry.capability),
+                        score: entry.score,
+                    })),
+                });
+            }
+            const rows = capabilities
+                .sort((left, right) => left.id.localeCompare(right.id))
+                .slice(0, limit)
+                .map(capabilitySummary);
+            return textResult({
+                ok: true,
+                total: capabilities.length,
+                count: rows.length,
+                generatedAt: index.generatedAt,
+                capabilities: rows,
+            });
+        },
+        'creatorem.get_capability': async (args) => {
+            const input = asObject(args);
+            const capabilityId = readRequiredString(input, 'capabilityId');
+            const capability = await client.getCapability(capabilityId);
+            const index = await client.getIndex();
+            const relatedPages = index.pages.filter((page) => capability.relatedPageUrls.includes(page.pageUrl));
+            return textResult({
+                ok: true,
+                capability,
+                relatedPages,
+            });
+        },
+        'creatorem.get_page_content': async (args) => {
+            const input = asObject(args);
+            const pageUrl = normalizeDocsUrl(readRequiredString(input, 'pageUrl'));
+            const payload = await client.getLlmByDocsUrl(pageUrl);
+            return textResult({
+                ok: true,
+                pageUrl,
+                llmUrl: payload.llmUrl,
+                page: payload.page
+                    ? {
+                        title: payload.page.title,
+                        description: payload.page.description,
+                        sourcePath: payload.page.sourcePath,
+                        capability: payload.page.capability,
+                    }
+                    : undefined,
+                content: payload.text,
+            });
+        },
+        'creatorem.search_capabilities': async (args) => {
+            const input = asObject(args);
+            const query = readRequiredString(input, 'query');
+            const limit = readOptionalInt(input, 'limit', 10);
+            const index = await client.getIndex();
+            const matches = searchCapabilities(index.capabilities, query).slice(0, limit);
+            return textResult({
+                ok: true,
+                query,
+                count: matches.length,
+                capabilities: matches.map((entry) => ({
+                    ...capabilitySummary(entry.capability),
+                    score: entry.score,
+                })),
+            });
+        },
+    };
+}
+export async function callTool(handlers, name, args) {
+    const handler = handlers[name];
+    if (!handler) {
+        return errorResult('NOT_FOUND', `Tool not found: ${name}`);
+    }
+    try {
+        return await handler(args);
+    }
+    catch (error) {
+        return mapToolError(error);
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/src/tools.js.map

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

package/dist/src/types.d.ts

@@ -0,0 +1,53 @@
+export type JsonObject = Record<string, unknown>;
+export type McpCapability = {
+    id: string;
+    title: string;
+    description?: string;
+    pageUrl: string;
+    llmUrl: string;
+    sourcePath: string;
+    relatedPageUrls: string[];
+    entrypoints: string[];
+    inputs: string[];
+    outputs: string[];
+    constraints: string[];
+    sideEffects: string[];
+    aliases?: string[];
+    tags?: string[];
+    status?: string;
+};
+export type McpPage = {
+    title: string;
+    description?: string;
+    pageUrl: string;
+    llmUrl: string;
+    sourcePath: string;
+    capability: string;
+};
+export type McpIndex = {
+    version: number;
+    generatedAt: string;
+    scope: string[];
+    capabilities: McpCapability[];
+    pages: McpPage[];
+};
+export type McpTextContent = {
+    type: 'text';
+    text: string;
+};
+export type ToolResult = {
+    content: McpTextContent[];
+    structuredContent?: JsonObject;
+    isError?: boolean;
+};
+export type ToolDefinition = {
+    name: string;
+    description: string;
+    inputSchema: JsonObject;
+};
+export type ServerConfig = {
+    baseUrl: string;
+    timeoutMs: number;
+    cacheTtlMs: number;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD,MAAM,MAAM,aAAa,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,EAAE,aAAa,EAAE,CAAC;IAC9B,KAAK,EAAE,OAAO,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACrB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,iBAAiB,CAAC,EAAE,UAAU,CAAC;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACtB,CAAC"}

package/dist/src/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

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

package/dist/src/url-utils.d.ts

@@ -0,0 +1,3 @@
+export declare function normalizeDocsUrl(input: string): string;
+export declare function toLlmUrlFromDocs(docsUrl: string): string;
+//# sourceMappingURL=url-utils.d.ts.map

package/dist/src/url-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-utils.d.ts","sourceRoot":"","sources":["../../src/url-utils.ts"],"names":[],"mappings":"AAEA,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,UAuB7C;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,UAQ/C"}

package/dist/src/url-utils.js

@@ -0,0 +1,31 @@
+import { ValidationError } from './errors.js';
+export function normalizeDocsUrl(input) {
+    const raw = input.trim();
+    if (raw.length === 0) {
+        throw new ValidationError('"pageUrl" cannot be empty.');
+    }
+    let pathname = raw;
+    if (/^https?:\/\//i.test(raw)) {
+        let parsed;
+        try {
+            parsed = new URL(raw);
+        }
+        catch {
+            throw new ValidationError('"pageUrl" must be a valid /docs URL or absolute HTTP(S) URL.');
+        }
+        pathname = parsed.pathname;
+    }
+    if (!pathname.startsWith('/docs')) {
+        throw new ValidationError('"pageUrl" must start with "/docs".');
+    }
+    const normalized = pathname.replace(/\/$/, '');
+    return normalized === '' ? '/docs' : normalized;
+}
+export function toLlmUrlFromDocs(docsUrl) {
+    const normalizedDocsUrl = normalizeDocsUrl(docsUrl);
+    if (normalizedDocsUrl === '/docs') {
+        return '/llms.mdx';
+    }
+    return `/llms.mdx${normalizedDocsUrl.slice('/docs'.length)}`;
+}
+//# sourceMappingURL=url-utils.js.map

package/dist/src/url-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-utils.js","sourceRoot":"","sources":["../../src/url-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC1C,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACzB,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,eAAe,CAAC,4BAA4B,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,QAAQ,GAAG,GAAG,CAAC;IACnB,IAAI,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,IAAI,MAAW,CAAC;QAChB,IAAI,CAAC;YACD,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACL,MAAM,IAAI,eAAe,CAAC,8DAA8D,CAAC,CAAC;QAC9F,CAAC;QACD,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC/B,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,eAAe,CAAC,oCAAoC,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC/C,OAAO,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC5C,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAEpD,IAAI,iBAAiB,KAAK,OAAO,EAAE,CAAC;QAChC,OAAO,WAAW,CAAC;IACvB,CAAC;IAED,OAAO,YAAY,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;AACjE,CAAC"}

package/dist/tests/capability-search.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=capability-search.test.d.ts.map

package/dist/tests/capability-search.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-search.test.d.ts","sourceRoot":"","sources":["../../tests/capability-search.test.ts"],"names":[],"mappings":""}

package/dist/tests/capability-search.test.js

@@ -0,0 +1,40 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { scoreCapabilityForQuery, searchCapabilities } from '../src/capability-search.js';
+const capability = {
+    id: 'settings_api',
+    title: 'Settings API',
+    description: 'Read and update user or organization settings',
+    pageUrl: '/docs/web/features/settings',
+    llmUrl: '/llms.mdx/web/features/settings',
+    sourcePath: 'web/features/settings/index.mdx',
+    relatedPageUrls: [],
+    entrypoints: ['kit/settings'],
+    inputs: ['setting_keys'],
+    outputs: ['setting_values'],
+    constraints: ['requires auth'],
+    sideEffects: ['updates db'],
+    aliases: ['settings', 'user_settings'],
+    tags: ['settings', 'config'],
+    status: 'stable',
+};
+test('exact id match scores higher than generic match', () => {
+    const exactScore = scoreCapabilityForQuery(capability, 'settings_api');
+    const genericScore = scoreCapabilityForQuery(capability, 'settings');
+    assert.ok(exactScore > genericScore);
+});
+test('searchCapabilities returns sorted matches with positive scores', () => {
+    const other = {
+        ...capability,
+        id: 'billing',
+        title: 'Billing',
+        description: 'Billing plans and subscriptions',
+        aliases: ['payments'],
+        tags: ['billing'],
+    };
+    const results = searchCapabilities([other, capability], 'settings');
+    assert.equal(results.length, 1);
+    assert.equal(results[0]?.capability.id, 'settings_api');
+    assert.ok(results[0]?.score && results[0].score > 0);
+});
+//# sourceMappingURL=capability-search.test.js.map

package/dist/tests/capability-search.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-search.test.js","sourceRoot":"","sources":["../../tests/capability-search.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAG1F,MAAM,UAAU,GAAkB;IAC9B,EAAE,EAAE,cAAc;IAClB,KAAK,EAAE,cAAc;IACrB,WAAW,EAAE,+CAA+C;IAC5D,OAAO,EAAE,6BAA6B;IACtC,MAAM,EAAE,iCAAiC;IACzC,UAAU,EAAE,iCAAiC;IAC7C,eAAe,EAAE,EAAE;IACnB,WAAW,EAAE,CAAC,cAAc,CAAC;IAC7B,MAAM,EAAE,CAAC,cAAc,CAAC;IACxB,OAAO,EAAE,CAAC,gBAAgB,CAAC;IAC3B,WAAW,EAAE,CAAC,eAAe,CAAC;IAC9B,WAAW,EAAE,CAAC,YAAY,CAAC;IAC3B,OAAO,EAAE,CAAC,UAAU,EAAE,eAAe,CAAC;IACtC,IAAI,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;IAC5B,MAAM,EAAE,QAAQ;CACnB,CAAC;AAEF,IAAI,CAAC,iDAAiD,EAAE,GAAG,EAAE;IACzD,MAAM,UAAU,GAAG,uBAAuB,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IACvE,MAAM,YAAY,GAAG,uBAAuB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAErE,MAAM,CAAC,EAAE,CAAC,UAAU,GAAG,YAAY,CAAC,CAAC;AACzC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,gEAAgE,EAAE,GAAG,EAAE;IACxE,MAAM,KAAK,GAAkB;QACzB,GAAG,UAAU;QACb,EAAE,EAAE,SAAS;QACb,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,iCAAiC;QAC9C,OAAO,EAAE,CAAC,UAAU,CAAC;QACrB,IAAI,EAAE,CAAC,SAAS,CAAC;KACpB,CAAC;IAEF,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,UAAU,CAAC,CAAC;IAEpE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAChC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC;IACxD,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;AACzD,CAAC,CAAC,CAAC"}