@stratta/mcp 0.5.0 → 0.7.1

package/dist/tools/get-figure.js

@@ -1,50 +0,0 @@
-import { api } from '../client.js';
-import { requireApiKey } from '../auth.js';
-export const getFigureTool = {
-    name: 'get_figure',
-    description: 'Retrieve a figure (image) referenced in a section. Returns the image inline (base64) so you can see and reason about it, plus a public `url` for full-size viewing. Use the `id` returned by get_section in its `figures` array.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            norm: { type: 'string', description: 'Norm code, e.g. "SIA 261".' },
-            figureId: {
-                type: 'string',
-                description: 'Figure ID from get_section response (figures[].id).',
-            },
-        },
-        required: ['norm', 'figureId'],
-        additionalProperties: false,
-    },
-};
-export async function handleGetFigure(client, args) {
-    const apiKey = requireApiKey();
-    const meta = (await client.action(api._mcp.getFigureMeta, {
-        apiKey,
-        code: args.norm,
-        figureId: args.figureId,
-    }));
-    if (!meta) {
-        return { error: `Figure not found.` };
-    }
-    const url = (await client.action(api._mcp.getStorageUrl, {
-        apiKey,
-        code: args.norm,
-        figureId: args.figureId,
-    }));
-    if (!url) {
-        return { error: 'Figure storage is unavailable.' };
-    }
-    const response = await fetch(url);
-    if (!response.ok) {
-        return { error: `Failed to download figure: HTTP ${response.status}` };
-    }
-    const buffer = await response.arrayBuffer();
-    const base64 = Buffer.from(buffer).toString('base64');
-    const mimeType = response.headers.get('content-type') ?? 'image/png';
-    return {
-        caption: meta.caption,
-        figureNumber: meta.figureNumber,
-        url,
-        image: { base64, mimeType },
-    };
-}

package/dist/tools/get-methodology.d.ts

@@ -1,18 +0,0 @@
-import type { ConvexHttpClient } from 'convex/browser';
-export declare const getMethodologyTool: {
-    readonly name: "get_methodology";
-    readonly description: "MANDATORY FIRST CALL when answering any technical question about Swiss civil engineering norms via Stratta. Returns the canonical persona, navigation workflow, meta-routing hints (which SIA norms cover which topics), tree-navigation rules (where to look for formulas vs coefficients vs definitions), citation format and answer rules. Adopt these rules verbatim for the rest of the consultation. If you skip this call you WILL produce lower-quality answers (wrong citation format, missing cross-norm dependencies, hallucinated values).";
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly norm: {
-                readonly type: "string";
-                readonly description: "Optional: norm code the user is asking about, if already known. Used to scope methodology hints (currently informational only).";
-            };
-        };
-        readonly additionalProperties: false;
-    };
-};
-export declare function handleGetMethodology(client: ConvexHttpClient, args: {
-    norm?: string;
-}): Promise<unknown>;

package/dist/tools/get-methodology.js

@@ -1,21 +0,0 @@
-import { api } from '../client.js';
-export const getMethodologyTool = {
-    name: 'get_methodology',
-    description: "MANDATORY FIRST CALL when answering any technical question about Swiss civil engineering norms via Stratta. Returns the canonical persona, navigation workflow, meta-routing hints (which SIA norms cover which topics), tree-navigation rules (where to look for formulas vs coefficients vs definitions), citation format and answer rules. Adopt these rules verbatim for the rest of the consultation. If you skip this call you WILL produce lower-quality answers (wrong citation format, missing cross-norm dependencies, hallucinated values).",
-    inputSchema: {
-        type: 'object',
-        properties: {
-            norm: {
-                type: 'string',
-                description: "Optional: norm code the user is asking about, if already known. Used to scope methodology hints (currently informational only).",
-            },
-        },
-        additionalProperties: false,
-    },
-};
-export async function handleGetMethodology(client, args) {
-    const result = await client.query(api._mcp.getMethodology, {
-        norm: args.norm,
-    });
-    return result;
-}

package/dist/tools/get-section.d.ts

@@ -1,24 +0,0 @@
-import type { ConvexHttpClient } from 'convex/browser';
-export declare const getSectionTool: {
-    readonly name: "get_section";
-    readonly description: "Fetch the full enriched content of a section: markdown text with formulas in LaTeX and tables inline, pageStart/pageEnd, figures (call get_figure for the image), attached tables/formulas, and cross-references to other norms. ALL technical claims in your answer MUST be backed by a [<norm> <path>, p. <pageStart>] citation pointing to a section you actually fetched via get_section — never cite from memory. When a section's crossRefs list non-empty targets, follow them with another get_section call if the answer depends on them.";
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly norm: {
-                readonly type: "string";
-                readonly description: "Norm code, e.g. \"SIA 261\".";
-            };
-            readonly path: {
-                readonly type: "string";
-                readonly description: "Section path as it appears in the document, e.g. \"4.2.1\" or \"Annexe A\".";
-            };
-        };
-        readonly required: readonly ["norm", "path"];
-        readonly additionalProperties: false;
-    };
-};
-export declare function handleGetSection(client: ConvexHttpClient, args: {
-    norm: string;
-    path: string;
-}): Promise<unknown>;

package/dist/tools/get-section.js

@@ -1,34 +0,0 @@
-import { api } from '../client.js';
-import { requireApiKey } from '../auth.js';
-export const getSectionTool = {
-    name: 'get_section',
-    description: "Fetch the full enriched content of a section: markdown text with formulas in LaTeX and tables inline, pageStart/pageEnd, figures (call get_figure for the image), attached tables/formulas, and cross-references to other norms. ALL technical claims in your answer MUST be backed by a [<norm> <path>, p. <pageStart>] citation pointing to a section you actually fetched via get_section — never cite from memory. When a section's crossRefs list non-empty targets, follow them with another get_section call if the answer depends on them.",
-    inputSchema: {
-        type: 'object',
-        properties: {
-            norm: {
-                type: 'string',
-                description: 'Norm code, e.g. "SIA 261".',
-            },
-            path: {
-                type: 'string',
-                description: 'Section path as it appears in the document, e.g. "4.2.1" or "Annexe A".',
-            },
-        },
-        required: ['norm', 'path'],
-        additionalProperties: false,
-    },
-};
-export async function handleGetSection(client, args) {
-    const result = await client.action(api._mcp.getSection, {
-        apiKey: requireApiKey(),
-        code: args.norm,
-        path: args.path,
-    });
-    if (result === null) {
-        return {
-            error: `Section "${args.path}" not found in norm "${args.norm}".`,
-        };
-    }
-    return { norm: args.norm, section: result };
-}

package/dist/tools/get-subtree.d.ts

@@ -1,29 +0,0 @@
-import type { ConvexHttpClient } from 'convex/browser';
-export declare const getSubtreeTool: {
-    readonly name: "get_subtree";
-    readonly description: "Drill down into a specific chapter or section. Returns the subtree rooted at `path` with optional depth limit (relative to the root). Use this after get_toc to explore one chapter in detail without fetching the entire TOC. Each node has nodeId, path, title, summary, depth, pageStart, pageEnd, and recursive children.";
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly norm: {
-                readonly type: "string";
-                readonly description: "Norm code, e.g. \"SIA 261-1\".";
-            };
-            readonly path: {
-                readonly type: "string";
-                readonly description: "Section path to root the subtree at, e.g. \"14\" or \"14.2\".";
-            };
-            readonly maxDepth: {
-                readonly type: "number";
-                readonly description: "Max nesting depth relative to the root. Default: unlimited. depth=1 returns the root + direct children only.";
-            };
-        };
-        readonly required: readonly ["norm", "path"];
-        readonly additionalProperties: false;
-    };
-};
-export declare function handleGetSubtree(client: ConvexHttpClient, args: {
-    norm: string;
-    path: string;
-    maxDepth?: number;
-}): Promise<unknown>;

package/dist/tools/get-subtree.js

@@ -1,39 +0,0 @@
-import { api } from '../client.js';
-import { requireApiKey } from '../auth.js';
-export const getSubtreeTool = {
-    name: 'get_subtree',
-    description: 'Drill down into a specific chapter or section. Returns the subtree rooted at `path` with optional depth limit (relative to the root). Use this after get_toc to explore one chapter in detail without fetching the entire TOC. Each node has nodeId, path, title, summary, depth, pageStart, pageEnd, and recursive children.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            norm: {
-                type: 'string',
-                description: 'Norm code, e.g. "SIA 261-1".',
-            },
-            path: {
-                type: 'string',
-                description: 'Section path to root the subtree at, e.g. "14" or "14.2".',
-            },
-            maxDepth: {
-                type: 'number',
-                description: 'Max nesting depth relative to the root. Default: unlimited. depth=1 returns the root + direct children only.',
-            },
-        },
-        required: ['norm', 'path'],
-        additionalProperties: false,
-    },
-};
-export async function handleGetSubtree(client, args) {
-    const result = await client.action(api._mcp.getSubtree, {
-        apiKey: requireApiKey(),
-        code: args.norm,
-        path: args.path,
-        maxDepth: args.maxDepth,
-    });
-    if (result === null) {
-        return {
-            error: `Section "${args.path}" not found in norm "${args.norm}".`,
-        };
-    }
-    return { norm: args.norm, root: args.path, tree: result };
-}

package/dist/tools/get-toc.d.ts

@@ -1,24 +0,0 @@
-import type { ConvexHttpClient } from 'convex/browser';
-export declare const getTocTool: {
-    readonly name: "get_toc";
-    readonly description: "Get the high-level table of contents for a norm. By default returns only top-level chapters (depth=1) to stay light. Call get_subtree on a specific chapter's path to drill into sections + subsections. Increase maxDepth if you need a wider overview (cost: response size grows fast). Each node has nodeId, path, title, summary, pageStart, pageEnd, depth, and children (empty at the maxDepth boundary).";
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly norm: {
-                readonly type: "string";
-                readonly description: "Norm code, e.g. \"SIA 261\", \"SIA 263\", \"EN 1992-1-1\".";
-            };
-            readonly maxDepth: {
-                readonly type: "number";
-                readonly description: "Maximum nesting depth to include. Defaults to 1 (chapters only). depth=2 includes sections X.Y. depth=3 includes sub-subsections X.Y.Z (may exceed response size limit on large norms).";
-            };
-        };
-        readonly required: readonly ["norm"];
-        readonly additionalProperties: false;
-    };
-};
-export declare function handleGetToc(client: ConvexHttpClient, args: {
-    norm: string;
-    maxDepth?: number;
-}): Promise<unknown>;

package/dist/tools/get-toc.js

@@ -1,32 +0,0 @@
-import { api } from '../client.js';
-import { requireApiKey } from '../auth.js';
-export const getTocTool = {
-    name: 'get_toc',
-    description: "Get the high-level table of contents for a norm. By default returns only top-level chapters (depth=1) to stay light. Call get_subtree on a specific chapter's path to drill into sections + subsections. Increase maxDepth if you need a wider overview (cost: response size grows fast). Each node has nodeId, path, title, summary, pageStart, pageEnd, depth, and children (empty at the maxDepth boundary).",
-    inputSchema: {
-        type: 'object',
-        properties: {
-            norm: {
-                type: 'string',
-                description: 'Norm code, e.g. "SIA 261", "SIA 263", "EN 1992-1-1".',
-            },
-            maxDepth: {
-                type: 'number',
-                description: 'Maximum nesting depth to include. Defaults to 1 (chapters only). depth=2 includes sections X.Y. depth=3 includes sub-subsections X.Y.Z (may exceed response size limit on large norms).',
-            },
-        },
-        required: ['norm'],
-        additionalProperties: false,
-    },
-};
-export async function handleGetToc(client, args) {
-    const result = await client.action(api._mcp.getDocumentToc, {
-        apiKey: requireApiKey(),
-        code: args.norm,
-        maxDepth: args.maxDepth,
-    });
-    if (result === null) {
-        return { error: `Norm "${args.norm}" not found or not published.` };
-    }
-    return { norm: args.norm, maxDepth: args.maxDepth ?? 1, tree: result };
-}

package/dist/tools/list-norms.d.ts

@@ -1,11 +0,0 @@
-import type { ConvexHttpClient } from 'convex/browser';
-export declare const listNormsTool: {
-    readonly name: "list_norms";
-    readonly description: "List all engineering norms (SIA, Eurocodes, etc.) currently available in Stratta. Returns code, year, title, and language for each. Workflow: call get_methodology FIRST (persona + rules), then list_norms to know what is queryable, then meta-route the user's question to the relevant norms before drilling in.";
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {};
-        readonly additionalProperties: false;
-    };
-};
-export declare function handleListNorms(client: ConvexHttpClient): Promise<unknown>;

package/dist/tools/list-norms.js

@@ -1,17 +0,0 @@
-import { api } from '../client.js';
-import { requireApiKey } from '../auth.js';
-export const listNormsTool = {
-    name: 'list_norms',
-    description: "List all engineering norms (SIA, Eurocodes, etc.) currently available in Stratta. Returns code, year, title, and language for each. Workflow: call get_methodology FIRST (persona + rules), then list_norms to know what is queryable, then meta-route the user's question to the relevant norms before drilling in.",
-    inputSchema: {
-        type: 'object',
-        properties: {},
-        additionalProperties: false,
-    },
-};
-export async function handleListNorms(client) {
-    const result = await client.action(api._mcp.listPublishedNorms, {
-        apiKey: requireApiKey(),
-    });
-    return { norms: result };
-}

package/dist/tools/search-in-norm.d.ts

@@ -1,29 +0,0 @@
-import type { ConvexHttpClient } from 'convex/browser';
-export declare const searchInNormTool: {
-    readonly name: "search_in_norm";
-    readonly description: "Search for sections within a norm by keyword (case-insensitive). Returns up to `limit` matches with path, title, and a snippet of matching content. Use this when you do not yet know which section to read — e.g. \"charges variables\" or \"béton armé\".";
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly norm: {
-                readonly type: "string";
-                readonly description: "Norm code, e.g. \"SIA 261\".";
-            };
-            readonly keyword: {
-                readonly type: "string";
-                readonly description: "Search term. Searches both section titles and content.";
-            };
-            readonly limit: {
-                readonly type: "number";
-                readonly description: "Max results to return (default 20).";
-            };
-        };
-        readonly required: readonly ["norm", "keyword"];
-        readonly additionalProperties: false;
-    };
-};
-export declare function handleSearchInNorm(client: ConvexHttpClient, args: {
-    norm: string;
-    keyword: string;
-    limit?: number;
-}): Promise<unknown>;

package/dist/tools/search-in-norm.js

@@ -1,31 +0,0 @@
-import { api } from '../client.js';
-import { requireApiKey } from '../auth.js';
-export const searchInNormTool = {
-    name: 'search_in_norm',
-    description: 'Search for sections within a norm by keyword (case-insensitive). Returns up to `limit` matches with path, title, and a snippet of matching content. Use this when you do not yet know which section to read — e.g. "charges variables" or "béton armé".',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            norm: { type: 'string', description: 'Norm code, e.g. "SIA 261".' },
-            keyword: {
-                type: 'string',
-                description: 'Search term. Searches both section titles and content.',
-            },
-            limit: {
-                type: 'number',
-                description: 'Max results to return (default 20).',
-            },
-        },
-        required: ['norm', 'keyword'],
-        additionalProperties: false,
-    },
-};
-export async function handleSearchInNorm(client, args) {
-    const result = await client.action(api._mcp.searchInNorm, {
-        apiKey: requireApiKey(),
-        code: args.norm,
-        keyword: args.keyword,
-        limit: args.limit,
-    });
-    return { norm: args.norm, keyword: args.keyword, hits: result };
-}