@stratta/mcp 0.10.0 → 0.12.1

package/dist/tools/catalog.gen.js

@@ -0,0 +1,734 @@
+// Generated by scripts/build-mcp-catalog.mjs from convex/mcpCatalog.ts.
+// Do not edit: change the source and run the script.
+export const SERVER_INSTRUCTIONS = "Stratta serves the construction norms of the signed-in organization, and only those. Call `get_methodology` before the first technical question of a conversation: it carries the navigation order, the citation rules and the dossier policy. Never answer a technical question from memory; a norm absent from `list_norms` cannot be read.";
+export const CATALOG = [
+    {
+        "name": "get_methodology",
+        "title": "Working method",
+        "description": "Read the working contract this server expects an agent to follow: how to walk a norm from its table of contents down to a clause, how to cite what it reads, and when to record something in a project dossier. Call it once, before the first technical answer of a conversation, and follow it for the rest of the conversation.",
+        "annotations": {
+            "readOnlyHint": true,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {}
+    },
+    {
+        "name": "whoami",
+        "title": "Connected account",
+        "description": "Report which organization this connection reads from, the signed-in role, the plan name and how many norms are available. Use it to confirm the connection points at the intended workspace before starting, or when a norm the user expects is missing.",
+        "annotations": {
+            "readOnlyHint": true,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {}
+    },
+    {
+        "name": "list_norms",
+        "title": "Available norms",
+        "description": "List the norms published in the signed-in organization, with code, year, title, language and coverage (how much of the norm was ingested). This is the first call of any search: a norm absent from this list cannot be read and must not be answered from memory. A demo entry is fictional and never a technical reference; a sparse entry carries a notice to relay.",
+        "annotations": {
+            "readOnlyHint": true,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {}
+    },
+    {
+        "name": "get_toc",
+        "title": "Table of contents",
+        "description": "Return the table of contents of one norm as a tree of path, title, summary and page range. Pass maxDepth 1 for the chapter list, which is enough to choose where to descend; deeper levels return the whole outline and fill the context. Descend with get_subtree, read with get_section.",
+        "annotations": {
+            "readOnlyHint": true,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "code": "Norm code exactly as list_norms returns it, e.g. \"SIA 261\", \"SIA 267\", \"EN 1997-1\".",
+            "edition": "Edition of the norm when the organization holds several (\"2013\", \"2020\"). Default: the most recent published edition; list_norms names them.",
+            "maxDepth": "Nesting depth to include. 1 (default) returns chapters only; 2 adds X.Y sections. Large norms grow fast beyond 2."
+        }
+    },
+    {
+        "name": "get_subtree",
+        "title": "Section tree",
+        "description": "Return the section tree below one path, each node with its summary and page range. This is the step between the table of contents and reading: it shows what a chapter contains without loading its text. Use maxDepth to bound it; a tree larger than maxNodes loses its deepest levels and says so with truncated: true.",
+        "annotations": {
+            "readOnlyHint": true,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "code": "Norm code exactly as list_norms returns it, e.g. \"SIA 261\", \"SIA 267\", \"EN 1997-1\".",
+            "edition": "Edition of the norm when the organization holds several (\"2013\", \"2020\"). Default: the most recent published edition; list_norms names them.",
+            "path": "Path to root the subtree at, e.g. \"9\" or \"9.5\". A clause number below the last heading resolves to that heading.",
+            "maxDepth": "Depth relative to the root. 1 returns the root and its direct children; omit for the whole subtree.",
+            "maxNodes": "Cap on the nodes returned, 20 to 2000. Default 400."
+        }
+    },
+    {
+        "name": "get_section",
+        "title": "Section",
+        "description": "Return one section as a Markdown document: its text with the LaTeX formulas and tables where the norm prints them, its figures, the cross-references it carries and the sections below it, with the exact path and page range. This is what gets quoted: call it before stating any technical claim taken from a norm, and cite [CODE section path, p. N]. A clause number that is not a node (9.5.2.1) resolves to its nearest heading, whose text carries the clause. A long section comes in windows of maxChars; when truncated is true, call again with the offset given.",
+        "annotations": {
+            "readOnlyHint": true,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "code": "Norm code exactly as list_norms returns it, e.g. \"SIA 261\", \"SIA 267\", \"EN 1997-1\".",
+            "edition": "Edition of the norm when the organization holds several (\"2013\", \"2020\"). Default: the most recent published edition; list_norms names them.",
+            "path": "Section path as it appears in the table of contents, e.g. \"4.2.1\" or \"Annexe A\".",
+            "maxChars": "Characters of text per call, 500 to 40000. Default 12000, which fits any client. Raise it only when one section is needed whole.",
+            "offset": "Where to resume in the text, from the nextOffset of a truncated call."
+        }
+    },
+    {
+        "name": "search_in_norm",
+        "title": "Search a norm",
+        "description": "Full-text search inside one norm, ranked, a hit in a heading outranking a hit in the body. Use it when the table of contents suggests no obvious section. Matching is per term, not per substring, in the language of the norm: search \"charges\" in a French norm, not \"loads\"; accents and case do not matter. A clause number as keyword returns that clause. Returns paths, titles and snippets; read the promising ones with get_section.",
+        "annotations": {
+            "readOnlyHint": true,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "code": "Norm code exactly as list_norms returns it, e.g. \"SIA 261\", \"SIA 267\", \"EN 1997-1\".",
+            "edition": "Edition of the norm when the organization holds several (\"2013\", \"2020\"). Default: the most recent published edition; list_norms names them.",
+            "keyword": "Search terms in the language of the norm, accents optional. Several words find sections containing all of them; a clause number finds that clause.",
+            "limit": "Maximum number of hits, 1 to 50. Default 20."
+        }
+    },
+    {
+        "name": "search_corpus",
+        "title": "Search all norms",
+        "description": "Full-text search across every norm the organization can read, grouped by norm, heading hits from any norm ahead of body hits. Use it first when the question does not name its norm: it tells which norms speak of the subject before any table of contents is opened. Same matching as search_in_norm. Returns, per norm, its code and title and a few hits; continue with get_section on the paths that look relevant.",
+        "annotations": {
+            "readOnlyHint": true,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "keyword": "Search terms in the language of the norms, accents optional. Several words find sections containing all of them.",
+            "limit": "Maximum number of hits across all norms, 1 to 40. Default 20."
+        }
+    },
+    {
+        "name": "get_cross_refs",
+        "title": "Cross-references",
+        "description": "Return the references one section makes: to other clauses, annexes, figures and tables of the same norm, and to other norms. SIA norms deliberately spread the rule, the coefficient and the action across separate clauses and norms, so following a reference is often what separates a correct answer from an incomplete one. Each reference says whether it is resolvable in this corpus (listed first) and names the target section; read each relevant target with get_section.",
+        "annotations": {
+            "readOnlyHint": true,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "code": "Norm code exactly as list_norms returns it, e.g. \"SIA 261\", \"SIA 267\", \"EN 1997-1\".",
+            "edition": "Edition of the norm when the organization holds several (\"2013\", \"2020\"). Default: the most recent published edition; list_norms names them.",
+            "path": "Section path as it appears in the table of contents, e.g. \"4.2.1\" or \"Annexe A\"."
+        }
+    },
+    {
+        "name": "get_figure",
+        "title": "Figure",
+        "description": "Return one figure of a norm as an image: load diagrams, design charts, standard cross-sections. Call it when the figure carries the rule and describing it in words would lose the content. The figure identifier comes from the figures array of get_section.",
+        "annotations": {
+            "readOnlyHint": true,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "code": "Norm code exactly as list_norms returns it, e.g. \"SIA 261\", \"SIA 267\", \"EN 1997-1\".",
+            "edition": "Edition of the norm when the organization holds several (\"2013\", \"2020\"). Default: the most recent published edition; list_norms names them.",
+            "figureId": "Figure identifier from the figures array of get_section."
+        }
+    },
+    {
+        "name": "list_dossiers",
+        "title": "Project dossiers",
+        "description": "List the project dossiers of the organization, most recently touched first, with the count of entries and of open questions. Call it when the user names a project or asks what they were working on: a dossier that already exists is reloaded, never recreated.",
+        "annotations": {
+            "readOnlyHint": true,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {}
+    },
+    {
+        "name": "open_dossier",
+        "title": "Open a dossier",
+        "description": "Open a project dossier, or return the one that already carries that name: calling it twice with the same name never creates a duplicate. Open one when the user works on a named project and there is something worth keeping (a question to settle, a retained value, an assumption, a site observation); not for a passing lookup. Returns dossierId and created.",
+        "annotations": {
+            "readOnlyHint": false,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "name": "How the user refers to the project, in their own words: this is the name they will search for.",
+            "reference": "The office's own project number, if the user gave one."
+        }
+    },
+    {
+        "name": "open_question",
+        "title": "Open a question",
+        "description": "Open one question to settle in a dossier, before gathering evidence for it: \"can pile P38 be kept?\", \"which friction angle do we retain?\". A question is the unit of work; the evidence saved with save_finding and the eventual record_decision hang off it. One question per thing to settle, never a list of eight in one body. Idempotent on the title: the same wording returns the question already open. Name the options on the table when there are several. Returns questionId and created.",
+        "annotations": {
+            "readOnlyHint": false,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "dossierId": "Dossier id returned by open_dossier or list_dossiers.",
+            "title": "The question in one line, phrased as a question.",
+            "body": "What is at stake and why it is not settled, in two or three sentences. Not a list of sub-questions.",
+            "options": "The ways this could be settled, one short name each."
+        }
+    },
+    {
+        "name": "save_finding",
+        "title": "Record evidence",
+        "description": "Record one piece of evidence in a dossier, as you work rather than in a batch at the end. Kinds: reference (what a norm says; always give normCode, sectionPath and page, or it is not a reference), hypothesis (the value the engineer retains and why, value in value and reasoning in detail), observation (what the site, a borehole or a survey showed, with the date). One clause, one value or one fact per call, in one or two sentences. Pass questionId to file it under the question it serves; without it the entry waits unclassified. Set confidence whenever a value is at stake: established, judgement or to_confirm. Questions go through open_question and decisions through record_decision, not here.",
+        "annotations": {
+            "readOnlyHint": false,
+            "destructiveHint": false,
+            "idempotentHint": false,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "dossierId": "Dossier id returned by open_dossier or list_dossiers.",
+            "questionId": "The question this evidence serves, from open_question or load_dossier. Omit only when you do not know yet.",
+            "kind": "reference, hypothesis or observation: pick by what the entry is.",
+            "title": "The fact in one line, as an engineer would write it in a report. One clause, one value or one observation; not a theme.",
+            "detail": "The reasoning in one or two sentences: why this value, what it rests on, what disagreed. Expected for a hypothesis.",
+            "value": "The retained value with its unit, e.g. \"30 deg\", \"1.25 kN/m2\".",
+            "confidence": "established (computed or read directly), judgement (the engineer chose it), to_confirm (provisional, pending a test).",
+            "normCode": "Norm this comes from, e.g. \"SIA 267\".",
+            "sectionPath": "Exact section path, e.g. \"9.5.2.1\".",
+            "page": "Page in the norm, so a human can verify it in their PDF.",
+            "normEdition": "The edition cited, e.g. \"2013\" or \"2020 + rect. 2022\", when list_norms gives it.",
+            "attachmentId": "The project attachment the evidence comes from, when it is not a norm.",
+            "attachmentPage": "The page of that attachment."
+        }
+    },
+    {
+        "name": "record_decision",
+        "title": "Record a decision",
+        "description": "Settle a question with a decision the engineer has confirmed: what was decided, why, and the clause it rests on. Name the retained option when the question listed some; put the number in value and set confidence when the decision is a value. Only after the user confirmed the decision, never on your own reasoning. The question leaves the open items and keeps its evidence. Returns entryId.",
+        "annotations": {
+            "readOnlyHint": false,
+            "destructiveHint": false,
+            "idempotentHint": false,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "questionId": "Question id returned by open_question or load_dossier.",
+            "retainedOption": "The option that was retained, by the name it was given. An option not listed yet is created.",
+            "title": "The decision in one line, as it would be written in a report.",
+            "detail": "Why, in one or two sentences, and what it rests on.",
+            "value": "The decided value with its unit, when the decision is a value.",
+            "confidence": "established, judgement or to_confirm.",
+            "normCode": "Norm the decision rests on, e.g. \"SIA 267\".",
+            "sectionPath": "Exact section path, e.g. \"9.5.2.1\".",
+            "page": "Page in the norm.",
+            "normEdition": "The edition cited, when known.",
+            "confirmed": "true when the user has already confirmed this decision in the conversation. Otherwise the user is asked through the client before anything is written."
+        }
+    },
+    {
+        "name": "load_dossier",
+        "title": "Load a dossier",
+        "description": "Reload a dossier: its questions with their evidence, options and decisions, open questions first, then the evidence not yet filed under a question, then the comments a colleague left. Do this before answering whenever the user returns to a project already named, otherwise a decision already taken gets taken again. The name is enough; the id is optional.",
+        "annotations": {
+            "readOnlyHint": true,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "dossierId": "Dossier id, preferred when you have it.",
+            "name": "The project name as the user says it. Matched exactly; call list_dossiers first if unsure."
+        }
+    },
+    {
+        "name": "resolve_question",
+        "title": "Close a question",
+        "description": "Close a question that stopped mattering without a decision (the variant was abandoned, the request withdrawn), or reopen one with resolved false. The question stays in the dossier with its evidence. To settle a question with an answer, call record_decision instead. Only when the user says so.",
+        "annotations": {
+            "readOnlyHint": false,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "questionId": "Question id returned by open_question or load_dossier.",
+            "resolved": "Defaults to true (close). Pass false to reopen.",
+            "confirmed": "true when the user has already confirmed in the conversation that the question is settled. Otherwise the user is asked through the client first."
+        }
+    },
+    {
+        "name": "list_attachments",
+        "title": "Project attachments",
+        "description": "List the project attachments of one dossier: the site reports, borehole logs, meeting minutes and data sheets the engineer uploaded. Returns for each its id, name, type, page count and extraction status. Read one with read_attachment before answering on the project; a piece is evidence like a clause and is cited the same way.",
+        "annotations": {
+            "readOnlyHint": true,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "dossierId": "The dossier, from list_dossiers or open_dossier."
+        }
+    },
+    {
+        "name": "read_attachment",
+        "title": "Read an attachment",
+        "description": "Read the text of a project attachment as a Markdown document, page by page. from and to bound the pages, maxChars the characters; when truncated is true, call again with from set to nextPage. A scan without a text layer says so. Cite what you read as [name, p. N] and file it with save_finding using attachmentId and attachmentPage.",
+        "annotations": {
+            "readOnlyHint": true,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "attachmentId": "The attachment, from list_attachments or search_in_dossier.",
+            "from": "First page to read. Default 1.",
+            "to": "Last page to read. Default: the last page.",
+            "maxChars": "Characters of text per call, 500 to 40000. Default 12000."
+        }
+    },
+    {
+        "name": "search_in_dossier",
+        "title": "Search the attachments",
+        "description": "Full-text search over the attachments of one dossier, accents and case ignored, matching per term. Returns the attachment, the page and a snippet for each hit; read the page with read_attachment before quoting it.",
+        "annotations": {
+            "readOnlyHint": true,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "dossierId": "The dossier whose attachments to search.",
+            "keyword": "Search terms in the language of the documents.",
+            "limit": "Maximum number of hits, 1 to 30. Default 10."
+        }
+    },
+    {
+        "name": "add_attachment",
+        "title": "Add an attachment",
+        "description": "Upload a file from the user's machine to a dossier as a project attachment: PDF, DOCX, XLSX, PNG, JPEG, TXT, MD or CSV, 25 MB at most, 20 per dossier. Its text is extracted for read_attachment and search_in_dossier. Only upload a file the user named; never look for one.",
+        "annotations": {
+            "readOnlyHint": false,
+            "destructiveHint": false,
+            "idempotentHint": false,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio"
+        ],
+        "params": {
+            "dossierId": "The dossier to attach the file to.",
+            "filePath": "Absolute path of the file on the machine running this server."
+        }
+    },
+    {
+        "name": "list_templates",
+        "title": "Dossier templates",
+        "description": "List the checklists the organization wrote for its types of structure: each is a set of questions with the clauses they rest on. When a new project matches one, apply it with apply_template instead of opening the questions one by one.",
+        "annotations": {
+            "readOnlyHint": true,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {}
+    },
+    {
+        "name": "apply_template",
+        "title": "Apply a template",
+        "description": "Open the questions of a template in a dossier, with their options, and file every clause that resolves in the corpus as a reference under its question. A clause the organization cannot read is written into the question as something to establish. Applying twice opens nothing twice. Tell the user which questions were opened and which clauses are missing.",
+        "annotations": {
+            "readOnlyHint": false,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "dossierId": "The dossier to apply the template to.",
+            "templateId": "The template, from list_templates."
+        }
+    },
+    {
+        "name": "ingest_status",
+        "title": "Check ingestion status",
+        "description": "Check whether a norm (by code) already exists in the workspace, how many sections it has and its coverage score (how much of the norm actually made it in). Call it before creating a document, to avoid duplicates.",
+        "annotations": {
+            "readOnlyHint": true,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "code": "Norm code, e.g. \"SIA 261\"."
+        }
+    },
+    {
+        "name": "ingest_create_document",
+        "title": "Create norm document",
+        "description": "Create a draft norm document in the workspace. Returns the documentId every later ingest_* call needs. The organization must hold a licence for the norm it ingests.",
+        "annotations": {
+            "readOnlyHint": false,
+            "destructiveHint": false,
+            "idempotentHint": false,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "code": "Norm code as printed on the cover, e.g. \"SIA 118/262\".",
+            "year": "Edition year.",
+            "title": "Full title of the norm.",
+            "language": "fr, de, it or en.",
+            "totalPages": "Page count of the source PDF.",
+            "edition": "Edition label as printed on the cover (\"2013\", \"2020+C1\"). Default: the year. Lets several editions of one code coexist.",
+            "scope": "One sentence on what the norm covers, shown in the served methodology, e.g. \"Geotechnical design: foundations, piles, anchors, retaining structures\"."
+        }
+    },
+    {
+        "name": "ingest_create_sections",
+        "title": "Create sections",
+        "description": "Insert sections into a draft document, up to 200 per call. Parent links resolve through parentNodeId within the batch and the sections already inserted. Returns a map of nodeId to sectionId; use those ids to attach formulas, tables, figures and cross-references.",
+        "annotations": {
+            "readOnlyHint": false,
+            "destructiveHint": false,
+            "idempotentHint": false,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "documentId": "Document id from ingest_create_document.",
+            "sections": "The sections to insert, as the pre-pass produced them."
+        }
+    },
+    {
+        "name": "ingest_attach_formula",
+        "title": "Attach formula",
+        "description": "Attach a LaTeX formula to a section. Idempotent on the formula number: attaching the same number twice updates the formula instead of doubling it.",
+        "annotations": {
+            "readOnlyHint": false,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "sectionId": "Section id from ingest_create_sections.",
+            "latex": "The formula in LaTeX, without dollar signs.",
+            "description": "What the formula computes, in one sentence.",
+            "formulaNumber": "The number as printed, e.g. \"(9.12)\". Empty when the norm prints none."
+        }
+    },
+    {
+        "name": "ingest_attach_table",
+        "title": "Attach table",
+        "description": "Attach a structured table to a section: headers plus rows of cells. Idempotent on the table number.",
+        "annotations": {
+            "readOnlyHint": false,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "sectionId": "Section id from ingest_create_sections.",
+            "data": "An object with headers (string[]) and rows (string[][]).",
+            "caption": "The caption as printed.",
+            "tableNumber": "The number as printed, e.g. \"Tableau 3\"."
+        }
+    },
+    {
+        "name": "ingest_attach_cross_ref",
+        "title": "Attach cross-reference",
+        "description": "Attach a cross-reference from a section to another norm or clause. Idempotent on the target and the reference text.",
+        "annotations": {
+            "readOnlyHint": false,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "sourceSectionId": "Section id the reference is made from.",
+            "targetDocumentCode": "Code of the norm referred to, e.g. \"SIA 263\".",
+            "targetSectionPath": "Section path in the target norm, when the text names one.",
+            "refText": "The reference as written in the text.",
+            "refType": "explicit when the text names the norm, implicit otherwise."
+        }
+    },
+    {
+        "name": "ingest_upload_figure",
+        "title": "Upload figure",
+        "description": "Upload a figure image (base64) and attach it to a section in one call. PNG, JPEG or WebP, 8 MB at most.",
+        "annotations": {
+            "readOnlyHint": false,
+            "destructiveHint": false,
+            "idempotentHint": false,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "sectionId": "Section id from ingest_create_sections.",
+            "base64": "Base64-encoded image bytes; a data: prefix is tolerated.",
+            "mimeType": "image/png, image/jpeg or image/webp.",
+            "caption": "The caption as printed.",
+            "figureNumber": "The number as printed, e.g. \"Figure 12\"."
+        }
+    },
+    {
+        "name": "ingest_normalize_cross_refs",
+        "title": "Normalize cross-references",
+        "description": "Scan every section of a document and rebuild the cross-references to other norms found in its text. Idempotent; run it after the sections are in.",
+        "annotations": {
+            "readOnlyHint": false,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "documentId": "Document id from ingest_create_document."
+        }
+    },
+    {
+        "name": "ingest_publish",
+        "title": "Publish document",
+        "description": "Publish a draft document so the read tools can serve it. The server first scores how much of the norm was ingested (text per page, pages under a chapter, empty leaves, enrichment) and refuses below 30/100 with the reasons: fix the ingestion rather than retry. Pass force true only when the user confirms the document really is that short. Returns the score and its flags; show them to the user.",
+        "annotations": {
+            "readOnlyHint": false,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "documentId": "Document id from ingest_create_document.",
+            "force": "Publish even below the coverage floor. Only after the user confirmed the document is legitimately thin."
+        }
+    },
+    {
+        "name": "ingest_delete",
+        "title": "Delete document",
+        "description": "Delete a document with all its sections, figures, tables, formulas and cross-references. Irreversible; use it before re-ingesting a norm.",
+        "annotations": {
+            "readOnlyHint": false,
+            "destructiveHint": true,
+            "idempotentHint": false,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "documentId": "Document id from ingest_create_document."
+        }
+    }
+];
+export const PROMPTS = [
+    {
+        "name": "investigate-question",
+        "title": "Investigate a question in the norms",
+        "description": "Answer a technical question from the norms of this workspace, with a citation for every value, and file what is retained in the project dossier when there is one.",
+        "args": [
+            {
+                "name": "question",
+                "description": "The engineering question, as the user would ask a colleague.",
+                "required": true
+            },
+            {
+                "name": "project",
+                "description": "The project or dossier the question belongs to, if any.",
+                "required": false
+            }
+        ],
+        "text": "Investigate this question from the norms available in Stratta: {{question}}\n\nCall get_methodology first if it has not been called in this conversation. Use search_corpus when the norm is not obvious, then get_toc and get_subtree to find the clause, get_section to read it, and follow the references marked resolvable. Answer with a citation [CODE section path, p. N] for every value, show any calculation with its inputs, and say what the corpus does not cover.",
+        "optional": {
+            "project": "The question concerns the project \"{{project}}\": reload its dossier first (list_dossiers, then load_dossier), open a question for it if none fits, and file what is retained under that question."
+        }
+    },
+    {
+        "name": "resume-dossier",
+        "title": "Resume a project dossier",
+        "description": "Reload a project dossier, summarise its open questions and decisions, and ask what to work on next without re-deciding anything.",
+        "args": [
+            {
+                "name": "name",
+                "description": "The dossier name or reference as the user calls it.",
+                "required": true
+            }
+        ],
+        "text": "Resume the project dossier \"{{name}}\": call list_dossiers, then load_dossier on the matching one. Summarise the open questions first, then the decisions taken with the clauses they rest on, then the evidence not yet filed. Do not re-decide what is decided. Ask which open question to work on next."
+    },
+    {
+        "name": "check-value",
+        "title": "Check a value against the norms",
+        "description": "Find the clause that defines a value, read it, and say whether the value is right and under which conditions.",
+        "args": [
+            {
+                "name": "value",
+                "description": "The value and what it is, e.g. \"gamma_M = 1.35 for pile shaft friction\".",
+                "required": true
+            },
+            {
+                "name": "norm",
+                "description": "The norm code to check against, if known.",
+                "required": false
+            }
+        ],
+        "text": "Check this value against the norms available in Stratta: {{value}}\n\nFind the clause that defines it (search_corpus, or search_in_norm when the norm is known), read it with get_section, and answer whether the value is right, with the citation and the conditions the clause attaches. If the corpus does not define it, say so and name the norm where it is likely to be found.",
+        "optional": {
+            "norm": "Check against {{norm}} first."
+        }
+    }
+];
+export function catalogEntry(name) {
+    const entry = CATALOG.find((e) => e.name === name);
+    if (!entry)
+        throw new Error(`No catalogue entry for tool "${name}"`);
+    return entry;
+}
+/** Description of one parameter, as the catalogue words it. */
+export function param(tool, name) {
+    const text = catalogEntry(tool).params[name];
+    if (!text)
+        throw new Error(`No catalogue description for ${tool}.${name}`);
+    return text;
+}