@stratta/mcp 0.13.1 → 0.15.0

package/dist/tools/catalog.gen.js

@@ -252,6 +252,136 @@ export const CATALOG = [
             "siteId": "Site id returned by scan_site."
         }
     },
+    {
+        "name": "list_sites",
+        "title": "Site sheets",
+        "description": "List the site sheets of the organization, most recently touched first, each with the dossier it belongs to, the municipality and canton, the search radius and the status of its current scan. Call it when the user names a site or an address rather than a dossier, or to find the siteId of a sheet opened from the app; a dossier row from list_dossiers also carries its siteId.",
+        "annotations": {
+            "readOnlyHint": true,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "limit": "How many sites to return, 1 to 200. Default 50; truncated says when more exist."
+        }
+    },
+    {
+        "name": "get_site",
+        "title": "Read a site sheet",
+        "description": "Read a site sheet as the app shows it: every fact with its stable key, its status (established, indicative, absent, uncovered), its source with the date the data was current, the official notice and attribution when the source carries one, and the scan with each source and whether it answered. get_site_context is the summary shaped for an answer; call this when you need to quote a source line, cite a fact key in save_finding, or tell the user which source failed. Facts are registers, never a geotechnical study.",
+        "annotations": {
+            "readOnlyHint": true,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "siteId": "Site id from scan_site, list_sites or a dossier row."
+        }
+    },
+    {
+        "name": "get_site_section",
+        "title": "Read the section",
+        "description": "Read the geological section drawn on a site sheet: the axis from A to B, the corridor width, the measured terrain line, the modelled bedrock top, the geology bands sampled along the axis, and the boreholes inside the corridor with their logged strata, projected on the axis. Call it when the question is about what lies along a line rather than at a point. Without an axis drawn in the app, it says so and returns no lines. Nothing is interpolated between boreholes.",
+        "annotations": {
+            "readOnlyHint": true,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "siteId": "Site id from scan_site, list_sites or a dossier row.",
+            "maxPoints": "How many points of the terrain and bedrock lines to return, evenly spaced, 2 to 200. Default 60."
+        }
+    },
+    {
+        "name": "list_site_overlays",
+        "title": "Map areas around a site",
+        "description": "List the areas the site map draws around the point: polluted sites, natural hazard zones and water protection sectors read from the canton, each with whether it covers the site point or how many metres away it stops, its area and its layer. Coordinates are left out unless asked for. Call it after get_site_context when a constraint is near and the user asks how near; the sheet answers at the point, this answers in the radius.",
+        "annotations": {
+            "readOnlyHint": true,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "siteId": "Site id from scan_site, list_sites or a dossier row.",
+            "includeGeometry": "Return the polygon rings in LV95 as well. Default false: rings run to hundreds of points."
+        }
+    },
+    {
+        "name": "get_groundwater_contours",
+        "title": "Piezometric contours",
+        "description": "Read the cantonal piezometric contours the scan stored around a site: for each contour the aquifer name, the water table elevation in metres above sea level and the source layer. Cantons that publish none return an empty list and say whether the reading happened. A contour is the canton's interpretation of an aquifer, not a measurement at the site: prefer a water table logged in a nearby borehole (get_boreholes) when one exists, and quote a contour with its name.",
+        "annotations": {
+            "readOnlyHint": true,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "siteId": "Site id from scan_site, list_sites or a dossier row.",
+            "includeGeometry": "Return the contour vertices in LV95 as well. Default false."
+        }
+    },
+    {
+        "name": "list_site_photos",
+        "title": "Site photos",
+        "description": "List the photos the engineer uploaded on a site sheet: name, position in LV95 when the photo carries one (from its EXIF data or placed by hand), shooting direction, the instant the camera recorded, and the note written on it. No image is returned and no link: the photo is looked at in the app. Call it to know what was observed on site and when, before writing an observation.",
+        "annotations": {
+            "readOnlyHint": true,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "siteId": "Site id from scan_site, list_sites or a dossier row."
+        }
+    },
+    {
+        "name": "list_site_neighbours",
+        "title": "Neighbouring projects",
+        "description": "List the other site sheets of the organization within a radius of this one, nearest first, with the distance, the geological unit their own scan established and whether it is the same as here, and the dossier that carries them with its counts of open and decided questions. This is what the public registers cannot say: the office already worked three hundred metres away. Nothing is interpolated: these are links to dossiers to reload, not values.",
+        "annotations": {
+            "readOnlyHint": true,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "siteId": "Site id from scan_site, list_sites or a dossier row.",
+            "radius": "How far to look, in metres, 50 to 5000. Default 500. At most twelve neighbours are returned."
+        }
+    },
     {
         "name": "list_dossiers",
         "title": "Project dossiers",
@@ -517,6 +647,253 @@ export const CATALOG = [
             "templateId": "The template, from list_templates."
         }
     },
+    {
+        "name": "list_questions",
+        "title": "Questions of a dossier",
+        "description": "List the questions of one dossier, one page at a time, with what the dossier page shows and load_dossier leaves out: status, assignee, due date, author, dates, the options with their ids and the title of the decision when there is one. Filter by status to read only what is still open. Use load_dossier to resume a project; use this to work through the questions one by one, then get_question on the one that matters. When nextCursor is present, call again with it as cursor.",
+        "annotations": {
+            "readOnlyHint": true,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "dossierId": "Dossier id from list_dossiers, open_dossier or load_dossier.",
+            "status": "open, decided or closed. Omit for all.",
+            "limit": "Questions per page, 1 to 200. Default 50.",
+            "cursor": "The nextCursor of the previous page."
+        }
+    },
+    {
+        "name": "get_question",
+        "title": "Read a question",
+        "description": "Read one question in full: its wording, status, assignee and due date, its options with their ids and descriptions, its decision, its evidence with every citation field (norm, section path, page, edition, attachment and page) and the option each piece argues for, and the comments left on the question and on those entries, each with its author. Evidence comes one page at a time; when nextCursor is present, call again with it as cursor. Call it before adding to a question, so nothing already filed is filed twice.",
+        "annotations": {
+            "readOnlyHint": true,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "questionId": "Question id from list_questions, load_dossier or open_question.",
+            "limit": "Evidence entries per page, 1 to 200. Default 50.",
+            "cursor": "The nextCursor of the previous page."
+        }
+    },
+    {
+        "name": "get_dossier_activity",
+        "title": "Dossier history",
+        "description": "Read the history of a dossier, most recent first: who did what and when, from the app or from an agent, each line with the question or the entry it concerns. Call it when the user asks what changed since they last looked, or who took a decision. One page at a time; when nextCursor is present, call again with it as cursor. Lines are written in French at the time of the act, as the app shows them.",
+        "annotations": {
+            "readOnlyHint": true,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "dossierId": "Dossier id from list_dossiers, open_dossier or load_dossier.",
+            "limit": "Lines per page, 1 to 200. Default 50.",
+            "cursor": "The nextCursor of the previous page."
+        }
+    },
+    {
+        "name": "list_exports",
+        "title": "Dossier exports",
+        "description": "List the verification notes and journals exported from a dossier, most recent first, each with its kind, its SHA-256 hash, its size, the trusted timestamp when one was obtained, the methodology version in force and who exported it. The file itself is downloaded from the dossier page; this tells the user whether a note exists and lets them check a hash they were sent.",
+        "annotations": {
+            "readOnlyHint": true,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "dossierId": "Dossier id from list_dossiers, open_dossier or load_dossier."
+        }
+    },
+    {
+        "name": "update_question",
+        "title": "Edit a question",
+        "description": "Reword a question, rewrite what is at stake, assign it to a member of the organization by e-mail address, or set its due date. Pass only the fields to change; pass null to clear the assignee or the due date. Status changes go through record_decision and resolve_question, not here. Only when the user asked for the change.",
+        "annotations": {
+            "readOnlyHint": false,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "questionId": "Question id from list_questions, load_dossier or open_question.",
+            "title": "The new wording, in one line, phrased as a question.",
+            "body": "What is at stake and why it is not settled, in two or three sentences.",
+            "assigneeEmail": "E-mail address of the member to assign the question to. null removes the assignee.",
+            "dueAt": "Due date as an ISO day, e.g. \"2026-10-15\". null removes it."
+        }
+    },
+    {
+        "name": "add_option",
+        "title": "Add an option",
+        "description": "Add one way of settling a question, when a new variant comes up after the question was opened: \"keep the pile and test it\", \"redistribute on P37 and P39\". Idempotent on the name: the same words return the option already listed. Ten options per question at most. Returns optionId and created; the option is retained later by record_decision or update_option.",
+        "annotations": {
+            "readOnlyHint": false,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "questionId": "Question id from list_questions, load_dossier or open_question.",
+            "name": "The option in a few words, as it will be listed.",
+            "description": "What the option implies, in one or two sentences, when the name is not enough."
+        }
+    },
+    {
+        "name": "update_option",
+        "title": "Edit an option",
+        "description": "Rename or describe an option of a question, or mark it as the one retained. Retaining one option releases the others: a choice has one answer. Retaining here does not settle the question; call record_decision for that, which names the retained option itself. Pass only the fields to change. Only when the user asked for it.",
+        "annotations": {
+            "readOnlyHint": false,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "optionId": "Option id from get_question, list_questions or load_dossier.",
+            "name": "The new name of the option.",
+            "description": "The new description.",
+            "retained": "true to mark this option as retained (the others are released), false to release it."
+        }
+    },
+    {
+        "name": "delete_option",
+        "title": "Remove an option",
+        "description": "Remove an option from a question. The evidence filed under it stays on the question, unfiled from the option. Irreversible: the user is asked to confirm through the client before anything is removed, unless confirmed is true because they already did in the conversation. Only when the user asked for it.",
+        "annotations": {
+            "readOnlyHint": false,
+            "destructiveHint": true,
+            "idempotentHint": false,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "optionId": "Option id from get_question, list_questions or load_dossier.",
+            "confirmed": "true when the user already confirmed the removal in the conversation. Otherwise the user is asked through the client first."
+        }
+    },
+    {
+        "name": "delete_question",
+        "title": "Delete a question",
+        "description": "Delete a question from a dossier. Its evidence stays in the dossier, unfiled; its options, its comments and its decision entry go with it. Irreversible: the user is asked to confirm through the client before anything is deleted, unless confirmed is true because they already did in the conversation. A question that stopped mattering is closed with resolve_question, not deleted; delete only a question opened by mistake, and only when the user says so.",
+        "annotations": {
+            "readOnlyHint": false,
+            "destructiveHint": true,
+            "idempotentHint": false,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "questionId": "Question id from list_questions, load_dossier or open_question.",
+            "confirmed": "true when the user already confirmed the deletion in the conversation. Otherwise the user is asked through the client first."
+        }
+    },
+    {
+        "name": "add_comment",
+        "title": "Leave a comment",
+        "description": "Leave a remark on a dossier, on one of its questions or on one entry: a doubt about a value, a note for a colleague, the reason a piece of evidence was set aside. A comment is signed by the connected user and is not evidence: what the norm says goes through save_finding. A signed-off dossier still takes comments. Write it in the user's own words, only when they asked to leave one.",
+        "annotations": {
+            "readOnlyHint": false,
+            "destructiveHint": false,
+            "idempotentHint": false,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "dossierId": "Dossier id from list_dossiers, open_dossier or load_dossier.",
+            "body": "The comment, one to a few sentences.",
+            "questionId": "The question the comment is about, when it is about one.",
+            "entryId": "The entry the comment is about, when it is about one."
+        }
+    },
+    {
+        "name": "update_entry",
+        "title": "Correct an entry",
+        "description": "Correct a piece of evidence or a decision in place: its wording, its value, its confidence, or the citation (norm, section path, page, edition) when the wrong clause was cited. Pass only the fields to change; pass page null to clear it. The kind and the question do not change here (attach_entry moves an entry). Only when the user asked for the correction; never rewrite what a colleague wrote without saying so.",
+        "annotations": {
+            "readOnlyHint": false,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "entryId": "Entry id from get_question or load_dossier.",
+            "title": "The fact in one line, as an engineer would write it in a report.",
+            "detail": "The reasoning in one or two sentences.",
+            "value": "The retained value with its unit, e.g. \"30 deg\".",
+            "confidence": "established, judgement or to_confirm.",
+            "normCode": "Norm the entry comes from, e.g. \"SIA 267\".",
+            "sectionPath": "Exact section path, e.g. \"9.5.2.1\".",
+            "page": "Page in the norm. null clears it.",
+            "normEdition": "The edition cited, e.g. \"2013\"."
+        }
+    },
+    {
+        "name": "attach_entry",
+        "title": "File an entry under a question",
+        "description": "File a piece of evidence under a question, and optionally under one of its options, or take it out with questionId null. This is how the unclassified evidence of load_dossier gets sorted: read it, find the question it answers, file it. A decision cannot be moved: it belongs to its question. Filing where it already is changes nothing.",
+        "annotations": {
+            "readOnlyHint": false,
+            "destructiveHint": false,
+            "idempotentHint": true,
+            "openWorldHint": false
+        },
+        "transports": [
+            "stdio",
+            "remote"
+        ],
+        "params": {
+            "entryId": "Entry id from get_question or load_dossier.",
+            "questionId": "The question to file the entry under, or null to leave it unfiled.",
+            "optionId": "The option of that question the entry argues for, or null for none."
+        }
+    },
     {
         "name": "ingest_status",
         "title": "Check ingestion status",
@@ -704,7 +1081,7 @@ export const CATALOG = [
     {
         "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.",
+        "description": "Delete a document of your own organization with all its sections, figures, tables, formulas and cross-references. Irreversible; use it before re-ingesting a norm. The user is asked to confirm through the client before anything is deleted, unless confirmed is true because they already did in the conversation. Reserved to owners and administrators.",
         "annotations": {
             "readOnlyHint": false,
             "destructiveHint": true,
@@ -716,7 +1093,8 @@ export const CATALOG = [
             "remote"
         ],
         "params": {
-            "documentId": "Document id from ingest_create_document."
+            "documentId": "Document id from ingest_create_document.",
+            "confirmed": "true when the user already confirmed the deletion in the conversation. Otherwise the user is asked through the client first."
         }
     }
 ];

package/dist/tools/dossier.d.ts

@@ -82,6 +82,81 @@ export declare const applyTemplate: import("./define.js").ToolDef<{
     dossierId: z.ZodString;
     templateId: z.ZodString;
 }>;
+export declare const listQuestions: import("./define.js").ToolDef<{
+    dossierId: z.ZodString;
+    status: z.ZodOptional<z.ZodEnum<{
+        open: "open";
+        decided: "decided";
+        closed: "closed";
+    }>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+}>;
+export declare const getQuestion: import("./define.js").ToolDef<{
+    questionId: z.ZodString;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+}>;
+export declare const getDossierActivity: import("./define.js").ToolDef<{
+    dossierId: z.ZodString;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+}>;
+export declare const listExports: import("./define.js").ToolDef<{
+    dossierId: z.ZodString;
+}>;
+export declare const updateQuestion: import("./define.js").ToolDef<{
+    questionId: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    body: z.ZodOptional<z.ZodString>;
+    assigneeEmail: z.ZodOptional<z.ZodNullable<z.ZodEmail>>;
+    dueAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}>;
+export declare const addOption: import("./define.js").ToolDef<{
+    questionId: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}>;
+export declare const updateOption: import("./define.js").ToolDef<{
+    optionId: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    retained: z.ZodOptional<z.ZodBoolean>;
+}>;
+export declare const deleteOption: import("./define.js").ToolDef<{
+    optionId: z.ZodString;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+}>;
+export declare const deleteQuestion: import("./define.js").ToolDef<{
+    questionId: z.ZodString;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+}>;
+export declare const addComment: import("./define.js").ToolDef<{
+    dossierId: z.ZodString;
+    body: z.ZodString;
+    questionId: z.ZodOptional<z.ZodString>;
+    entryId: z.ZodOptional<z.ZodString>;
+}>;
+export declare const updateEntry: import("./define.js").ToolDef<{
+    entryId: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    detail: z.ZodOptional<z.ZodString>;
+    value: z.ZodOptional<z.ZodString>;
+    confidence: z.ZodOptional<z.ZodEnum<{
+        established: "established";
+        judgement: "judgement";
+        to_confirm: "to_confirm";
+    }>>;
+    normCode: z.ZodOptional<z.ZodString>;
+    sectionPath: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    normEdition: z.ZodOptional<z.ZodString>;
+}>;
+export declare const attachEntry: import("./define.js").ToolDef<{
+    entryId: z.ZodString;
+    questionId: z.ZodNullable<z.ZodString>;
+    optionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}>;
 export declare const dossierTools: (import("./define.js").ToolDef<{}> | import("./define.js").ToolDef<{
     name: z.ZodString;
     reference: z.ZodOptional<z.ZodString>;
@@ -152,4 +227,65 @@ export declare const dossierTools: (import("./define.js").ToolDef<{}> | import("
 }> | import("./define.js").ToolDef<{
     dossierId: z.ZodString;
     templateId: z.ZodString;
+}> | import("./define.js").ToolDef<{
+    dossierId: z.ZodString;
+    status: z.ZodOptional<z.ZodEnum<{
+        open: "open";
+        decided: "decided";
+        closed: "closed";
+    }>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+}> | import("./define.js").ToolDef<{
+    questionId: z.ZodString;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+}> | import("./define.js").ToolDef<{
+    dossierId: z.ZodString;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+}> | import("./define.js").ToolDef<{
+    questionId: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    body: z.ZodOptional<z.ZodString>;
+    assigneeEmail: z.ZodOptional<z.ZodNullable<z.ZodEmail>>;
+    dueAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}> | import("./define.js").ToolDef<{
+    questionId: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}> | import("./define.js").ToolDef<{
+    optionId: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    retained: z.ZodOptional<z.ZodBoolean>;
+}> | import("./define.js").ToolDef<{
+    optionId: z.ZodString;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+}> | import("./define.js").ToolDef<{
+    questionId: z.ZodString;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+}> | import("./define.js").ToolDef<{
+    dossierId: z.ZodString;
+    body: z.ZodString;
+    questionId: z.ZodOptional<z.ZodString>;
+    entryId: z.ZodOptional<z.ZodString>;
+}> | import("./define.js").ToolDef<{
+    entryId: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    detail: z.ZodOptional<z.ZodString>;
+    value: z.ZodOptional<z.ZodString>;
+    confidence: z.ZodOptional<z.ZodEnum<{
+        established: "established";
+        judgement: "judgement";
+        to_confirm: "to_confirm";
+    }>>;
+    normCode: z.ZodOptional<z.ZodString>;
+    sectionPath: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    normEdition: z.ZodOptional<z.ZodString>;
+}> | import("./define.js").ToolDef<{
+    entryId: z.ZodString;
+    questionId: z.ZodNullable<z.ZodString>;
+    optionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }>)[];