@axonity-ai/mcp 0.15.0 → 0.17.0

package/dist/tools/dataSources.js

@@ -1,20 +1,28 @@
 /**
- * Warehouses, the syncs that copy from them, and the numbers read off the
- * tables they fill (axonity-mcp#78, the connector half of axonity-flow#1849).
+ * Warehouses, and the numbers read off the tables they fill (axonity-mcp#78,
+ * the connector half of axonity-flow#1849; reshaped by the semantic model,
+ * axonity-mcp#81 / axonity-flow#1881).
  *
  * The plain entity verbs — list/read/create/update/delete/restore for a data
  * source, a table relationship and a dashboard — come from `registerEntityTools`
  * (see `ENTITIES` in index.ts). What is here is everything that does not fit
- * that shape: asking a warehouse something, the syncs that belong to ONE source,
- * the measures a dashboard reads, and duplicating a dashboard.
+ * that shape: asking a warehouse something, reading the numbers a dashboard
+ * shows, and duplicating a dashboard.
  *
- * **Most writes here are administrator-only on the backend**, and a service
- * token always resolves as a member. So against today's platform those calls
- * answer 403, and `ForbiddenError` says why in words rather than as a generic
- * "not allowed" — the tool descriptions say it up front as well, so an agent
- * does not spend three calls discovering it. Whether that is the right line is
- * the platform's decision, not this connector's: the tools exist so that the
- * moment the backend lets a token through, they work.
+ * **There are no sync tools any more.** A sync was a separate object beside
+ * the table it filled; the semantic model made it the table's own
+ * `provenance` (source, query, grain, key, mode, schedule), so a changed query
+ * goes through the same approval as a changed column. Filling a table is now
+ * `create_data_table` / `update_data_table` with `provenance`, and running it
+ * early is `refresh_data_table` (tools/dataTables.ts). A measure is no longer
+ * a field on a table either: it is its own versioned entity (`create_measure`
+ * and the rest of the generic family).
+ *
+ * **Who may write.** These routes were administrator-only when they arrived,
+ * and a service token always resolves as a member, so every write answered
+ * 403. The platform lifted that (axonity-flow#1855): a data source is created
+ * like any other object now. `ForbiddenError` still says "administrator only"
+ * in words when some other route answers that way.
  *
  * **Nothing here holds a credential.** A data source points at a secret by
  * `secretId`; the key itself is put in the vault by a human (secret writes are
@@ -24,14 +32,7 @@ import { z } from "zod";
 import { guard, jsonResult } from "./result.js";
 const SOURCES = "/api/v1/data-sources";
 const MEASURES = "/api/v1/measures";
-/** The sentence every admin-only tool here carries, so it is said once. */
-export const ADMIN_ONLY = "\n\nADMINISTRATOR ONLY. The backend lets only a workspace administrator do " +
-    "this, and a service token always counts as a member — so a 403 \"Only " +
-    "administrators can perform this action\" means exactly that, not a broken " +
-    "call and not a missing scope. Do not retry: tell your human, who can do it " +
-    "in Axonity.";
 const SOURCE_ID = z.string().describe("The data source's id.");
-const SYNC_ID = z.string().describe("The sync's id (from list_data_source_syncs).");
 export function registerDataSourceTools(server, client) {
     server.tool("list_data_source_drivers", "Which warehouses can be connected, and what each one needs. Read-only. " +
         "\n\nREAD THIS BEFORE create_data_source. Each driver lists its " +
@@ -44,23 +45,26 @@ export function registerDataSourceTools(server, client) {
         "where it is false, use `policy.maxSeconds` instead. `credentialKinds` " +
         "says which kind of secret the source's `secretId` must point at.", {}, async () => guard(async () => jsonResult(await client.get(`${SOURCES}/drivers`))));
     server.tool("test_data_source", "Ask the warehouse the cheapest question there is, and report what it " +
-        "said. Use it right after create_data_source, and whenever a sync or " +
-        "query fails for a reason that sounds like the connection. " +
+        "said. Use it right after create_data_source, and whenever a table's " +
+        "fill or a query fails for a reason that sounds like the connection. " +
         "\n\nA FAILURE IS AN ANSWER, NOT AN ERROR: the response is " +
         "`{ ok, message, checkedAt }`, and `ok: false` with a message is the " +
         "warehouse telling you what is wrong (missing credential, wrong project, " +
-        "no access). Read `message` — the call itself succeeded." +
-        ADMIN_ONLY, { id: SOURCE_ID }, async ({ id }) => guard(async () => jsonResult(await client.post(`${SOURCES}/${id}/test`))));
+        "no access). Read `message` — the call itself succeeded.", { id: SOURCE_ID }, async ({ id }) => guard(async () => jsonResult(await client.post(`${SOURCES}/${id}/test`))));
     server.tool("read_data_source_schema", "Which tables and columns the warehouse holds. Read-only, and free: it " +
         "reads the warehouse's own catalogue, not the data. " +
         "\n\nEach table's `name` is `container.table` — what you write in a " +
         "query. `containerWord` is what this warehouse calls the container " +
         "(\"dataset\" on BigQuery, \"schema\" on PostgreSQL). Column types are " +
         "the warehouse's own names, passed through. Read this before writing a " +
-        "query or a sync, rather than guessing table names.", { id: SOURCE_ID }, async ({ id }) => guard(async () => jsonResult(await client.get(`${SOURCES}/${id}/schema`))));
+        "query or a table's provenance, rather than guessing table names. " +
+        "On a source restricted to `policy.allowedDatasets` it reads those " +
+        "datasets one by one, so it answers even when the key may not list " +
+        "the whole project.", { id: SOURCE_ID }, async ({ id }) => guard(async () => jsonResult(await client.get(`${SOURCES}/${id}/schema`))));
     server.tool("query_data_source", "Run a READ-ONLY SQL query against the warehouse and get the rows back. " +
-        "For looking — checking what a table holds, trying the query a sync " +
-        "will run. To fill a table regularly, use create_data_source_sync. " +
+        "For looking — checking what a warehouse table holds, trying the " +
+        "query a table's provenance will run. To fill a table regularly, give " +
+        "it a `provenance` (create_data_table / update_data_table). " +
         "\n\nTHE ROWS ARE CAPPED. `truncated: true` means rows were left out: " +
         "`rowCount` is what came back, `totalRows` is what matched. Never report " +
         "a count or a total off a truncated answer — aggregate in the SQL " +
@@ -70,8 +74,7 @@ export function registerDataSourceTools(server, client) {
         "uses `*` where personal columns are configured, would scan more than " +
         "the source allows) — the reason says what to change. A 502 is the " +
         "WAREHOUSE refusing or not answering — the query may be fine; do not " +
-        "rewrite it, check test_data_source." +
-        ADMIN_ONLY, {
+        "rewrite it, check test_data_source.", {
         id: SOURCE_ID,
         sql: z
             .string()
@@ -83,118 +86,67 @@ export function registerDataSourceTools(server, client) {
             .int()
             .optional()
             .describe("How many rows you want back. Clamped by the platform — a bigger " +
-            "answer belongs in a sync, not in a response."),
+            "answer belongs in a table with provenance, not in a response."),
     }, async ({ id, sql, maxRows }) => guard(async () => jsonResult(await client.post(`${SOURCES}/${id}/query`, {
         sql,
         ...(maxRows !== undefined ? { maxRows } : {}),
     }))));
-    server.tool("list_data_source_syncs", "The syncs of ONE data source: the queries that keep tables filled from " +
-        "that warehouse, on a schedule. Read-only. " +
-        "\n\nEach sync says when it runs next (`nextFireAt`), when it last ran " +
-        "(`lastRunAt`), how many rows the table held afterwards " +
-        "(`lastRowCount`), and — when the last attempt wrote nothing — why " +
-        "(`lastError`). A `lastError` here is the first thing to read when a " +
-        "dashboard number looks stale.", { id: SOURCE_ID }, async ({ id }) => guard(async () => jsonResult(await client.get(`${SOURCES}/${id}/syncs`))));
-    server.tool("create_data_source_sync", "Set up a query that fills a table from this warehouse on a schedule. " +
-        "\n\nThe table must be a DYNAMIC table (create_data_table with " +
-        "`isDynamic: true`). Its rows then come from here, not from authoring. " +
-        "Try the SQL with query_data_source first: what one row of its result " +
-        "means decides what the table can be asked afterwards. " +
-        "\n\nThe response says when it will first run (`nextFireAt`). To run " +
-        "it now, follow with run_data_source_sync." +
-        ADMIN_ONLY, {
-        id: SOURCE_ID,
-        name: z.string().describe("What the sync is called."),
-        description: z.string().optional().describe("What it fills, and why."),
-        tableId: z
-            .string()
-            .describe("The dynamic table the result lands in (a data_table id)."),
-        sql: z
-            .string()
-            .describe("The query whose RESULT is copied into the table. Read-only, in the " +
-            "warehouse's own dialect."),
-        mode: z
-            .enum(["append", "upsert"])
-            .optional()
-            .describe("`upsert` (default) replaces rows whose key columns match and adds " +
-            "the rest. `append` adds everything that came back, every run — " +
-            "only right when each run returns NEW rows."),
-        keyColumns: z
-            .array(z.string())
-            .optional()
-            .describe("Which columns identify a row, for `upsert`. Without them an upsert " +
-            "has nothing to match on."),
-        cronExpr: z
-            .string()
-            .describe('When it runs, as a five-field cron expression, e.g. "0 6 * * *".'),
-        timezone: z
-            .string()
-            .optional()
-            .describe('The time zone the cron expression is read in. Defaults to "UTC".'),
-        enabled: z
-            .boolean()
-            .optional()
-            .describe("Whether it runs on its schedule. Defaults to true."),
-    }, async ({ id, ...fields }) => guard(async () => jsonResult(await client.post(`${SOURCES}/${id}/syncs`, fields))));
-    server.tool("run_data_source_sync", "Bring a sync's next run forward to now. " +
-        "\n\nTHIS DOES NOT WAIT FOR THE RESULT. The query can take tens of " +
-        "seconds, so the platform accepts the request and its scheduler runs " +
-        "it. The response is the sync with its new `nextFireAt`. To see how it " +
-        "went, read list_data_source_syncs again after a moment: `lastRunAt`, " +
-        "`lastRowCount` and `lastError` describe the run." +
-        ADMIN_ONLY, { id: SOURCE_ID, syncId: SYNC_ID }, async ({ id, syncId }) => guard(async () => jsonResult(await client.post(`${SOURCES}/${id}/syncs/${syncId}/run`))));
-    server.tool("delete_data_source_sync", "Stop a sync. The rows it already wrote STAY in the table; it simply " +
-        "stops refreshing them. Recoverable with restore_data_source_sync." +
-        ADMIN_ONLY, {
-        id: SOURCE_ID,
-        syncId: SYNC_ID,
-        confirm: z
-            .literal(true)
-            .describe("Must be true. Acknowledges the table stops being refreshed."),
-    }, async ({ id, syncId }) => guard(async () => jsonResult(await client.del(`${SOURCES}/${id}/syncs/${syncId}`))));
-    server.tool("restore_data_source_sync", "Bring a stopped sync back. It comes back SWITCHED OFF on purpose — a " +
-        "sync is usually stopped because it did the wrong thing — so switching " +
-        "it on again is a separate, deliberate step in Axonity." +
-        ADMIN_ONLY, { id: SOURCE_ID, syncId: SYNC_ID }, async ({ id, syncId }) => guard(async () => jsonResult(await client.post(`${SOURCES}/${id}/syncs/${syncId}/restore`))));
 }
 /** The period names a measure question accepts. Mirrors `PeriodPreset`. */
 const PERIODS = "today, this_week, last_week, this_month, last_month, this_quarter, " +
     "year_to_date, last_30_days, last_12_months, all_time";
 export function registerMeasureTools(server, client) {
-    server.tool("read_measure_design", "What can be asked of one dynamic table: its published measures, its " +
-        "columns and its time axis. Read-only. " +
-        "\n\nRead this before query_measures or before putting a tile on a " +
-        "dashboard — a tile names a measure by the id or name this returns. " +
-        "Measures themselves are DEFINED on the table (update_data_table) and " +
-        "go live when the table is published; this only reads them.", {
+    server.tool("read_measure_design", "What a number over one dynamic table may ask for: its columns and its " +
+        "time axis. Read-only. " +
+        "\n\nTHE MEASURES ARE NOT HERE. A measure belongs to the model, not " +
+        "to one table: list_measures({ tableId }) answers which measures read " +
+        "this table, and create_measure defines one. Read this for the column " +
+        "names a measure's formula, `splitBy` or `filters` may use — or " +
+        "get_measure_formula_spec({ includeWorkspace: true }) for every " +
+        "table's columns at once.", {
         tableId: z.string().describe("The dynamic table's id."),
         useDraft: z
             .boolean()
             .optional()
             .describe("Read the table's working design instead of its published one — to " +
-            "preview a measure before publishing. Defaults to false."),
+            "preview a change before it is published. Defaults to false."),
     }, async ({ tableId, useDraft }) => guard(async () => jsonResult(await client.get(`${MEASURES}/tables/${tableId}`, { useDraft }))));
     server.tool("query_measures", "Compute measures: up to 40 questions in one call, each answered on its " +
         "own. Read-only. This is where a dashboard's numbers come from. " +
         "\n\nEach question is " +
-        "`{ key, tableId, measure, period?, start?, end?, compare?, grain?, " +
+        "`{ key, measure, tableId?, period?, start?, end?, compare?, grain?, " +
         "splitBy?, filters?, limit?, useDraft? }`. `key` is your own label and " +
-        "comes back on the answer. `period` is one of: " +
+        "comes back on the answer. `measure` is the measure's NAME — its " +
+        "handle, unique in the workspace (list_measures); `tableId` is " +
+        "optional and no longer what finds it. `period` is one of: " +
         PERIODS +
         " (default this_month) — or set it to null and send `start`/`end` " +
         "(YYYY-MM-DD) for a custom range. `compare` is none, previous_period or " +
         "previous_year. `grain` (none, auto, day, week, month, quarter, year) " +
         "draws a series. `splitBy` names a column to group by; `limit` (1-50) " +
         "keeps the largest groups. " +
+        "\n\nA MEASURE OVER OTHER MEASURES is computed per group: each of " +
+        "its parts is aggregated on its own table, and the formula is applied " +
+        "to the results. Its TOTAL is computed again over the whole period, " +
+        "never added up from the groups — the total of a margin % is total " +
+        "margin over total revenue, not the average of the monthly " +
+        "percentages. Report the total you are given; do not sum the series. " +
+        "read_measure shows which parts a number is made of. " +
         "\n\nONE BAD QUESTION DOES NOT FAIL THE CALL: every answer carries " +
         "`ok`, and `ok: false` comes with an `error` of its own. Check each one. " +
         "\n\n`freshAsOf` says how old the newest row behind the number is; " +
-        "`certified: false` means it was computed from a draft. Say so when you " +
+        "`certified: false` means it was computed from a draft; `tables` names " +
+        "every table the number came from. Say so when you " +
         "report a number that is either stale or uncertified.", {
         queries: z
             .array(z.record(z.unknown()))
             .describe("The questions, 1 to 40, in the shape described above."),
     }, async ({ queries }) => guard(async () => jsonResult(await client.post(`${MEASURES}/query`, { queries }))));
+    server.tool("list_measure_live_versions", "Which major versions of one measure are PUBLISHED right now, as a list " +
+        "of numbers. Read-only. An empty list means it has never been " +
+        "published, so every number it gives is a draft preview " +
+        "(`certified: false` on query_measures) — request_publish_measure is " +
+        "what changes that.", { id: z.string().describe("The measure's id.") }, async ({ id }) => guard(async () => jsonResult(await client.get(`${MEASURES}/${id}/live-versions`))));
     server.tool("list_measure_rows", "The first rows of a published dynamic table in an order — what a list " +
         "tile shows (\"the ten biggest orders this month\"). Read-only. " +
         "\n\n`matched` in the answer is how many rows matched before the limit, " +

package/dist/tools/dataSources.js.map

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

package/dist/tools/dataTables.js

@@ -159,6 +159,17 @@ export function registerDataTableTools(server, client) {
     // The page envelope is forwarded WHOLE — unwrapping to `items` would
     // rebuild the silent truncation this tool exists to avoid.
     jsonResult(await client.get(`${BASE}/${tableId}/rows`, { q, limit, cursor }))));
+    server.tool("refresh_data_table", "Fill a table from its source NOW instead of at its next scheduled time. " +
+        "Replaces run_data_source_sync: a table's fill is its own `provenance` " +
+        "now, not a separate sync. " +
+        "\n\nTHIS DOES NOT WAIT FOR THE RESULT. The query can take tens of " +
+        "seconds, so the platform brings the table's next fill forward and its " +
+        "scheduler runs it. The response is the table, with `fill.nextAt` set " +
+        "to now. To see how it went, read_data_table again after a moment: " +
+        "`fill.lastAt`, `fill.lastRowCount` and `fill.lastError` describe the " +
+        "run. " +
+        "\n\nRefused with a 422 when the table has no `provenance` — its rows " +
+        "come from a workflow or an author, and there is nothing to run.", { id: z.string().describe("The table's id.") }, async ({ id }) => guard(async () => jsonResult(await client.post(`${BASE}/${id}/refresh`))));
     server.tool("list_data_table_tools", "Which tools this table yields, and which of them a RUN can actually " +
         "reach. Read-only. " +
         "\n\nA published table mints its own CRUD tools, so giving an agent " +

package/dist/tools/dataTables.js.map

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

package/dist/tools/measureFormula.d.ts

@@ -0,0 +1,46 @@
+/**
+ * A measure is one formula (axonity-mcp#83, the connector half of phase 1 of
+ * axonity-flow#1908).
+ *
+ * A measure used to be one aggregation over one table, or a division of two
+ * parts. It is now ONE expression over the model — `[net_revenue] -
+ * [variable_costs]`, `divide([cm1], [net_revenue])` — stored as a tree of ids
+ * and shown as text of names, the two one-to-one.
+ *
+ * **The words of the formula are not here.** They come from
+ * `GET /measures/formula-spec`, which the platform generates from the module
+ * that also parses — the same list its editor shows. A copy in this connector
+ * would be a second list, and two lists drift: the reason
+ * `get_workflow_authoring_spec` exists. `get_measure_formula_spec` forwards it
+ * untouched.
+ *
+ * **Checking is the platform's too.** `validate_measure` forwards to
+ * `POST /measures/validate`, the route the editor calls while somebody types,
+ * so an agent and a person can never disagree about whether a formula is
+ * acceptable. `read_measure` asks that same route to write the stored tree back
+ * as text, rather than this connector unparsing it.
+ *
+ * The one rule held HERE is the shape of a write: a measure is written as
+ * `definition.expression`, and the fields from before the formula are refused
+ * with `legacy_field`. The platform still accepts them while its own form is
+ * replaced; an agent has no such form to keep working, and a measure written
+ * the old way today is one that has to be migrated again.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AxonityClient } from "../client.js";
+/** The language: every word, operator, grain, limit, code and recipe. */
+export declare const FORMULA_SPEC_ROUTE = "/api/v1/measures/formula-spec";
+/** The vocabulary of THIS workspace: its measures, tables, columns, calendars. */
+export declare const FORMULA_SYMBOLS_ROUTE = "/api/v1/measures/formula-symbols";
+/** Check a formula without saving it. */
+export declare const VALIDATE_ROUTE = "/api/v1/measures/validate";
+/**
+ * Refuse a measure write in the shape from before the formula.
+ *
+ * Throws with `legacy_field` — the platform's own code for it, so an agent
+ * that repairs on codes reads the same word from either side. A `definition`
+ * without `expression` is refused too: the platform would quietly store it as
+ * a `sum`, which is a definition nobody wrote.
+ */
+export declare function assertFormulaShape(fields: Record<string, unknown>): void;
+export declare function registerMeasureFormulaTools(server: McpServer, client: AxonityClient): void;

package/dist/tools/measureFormula.js

@@ -0,0 +1,239 @@
+/**
+ * A measure is one formula (axonity-mcp#83, the connector half of phase 1 of
+ * axonity-flow#1908).
+ *
+ * A measure used to be one aggregation over one table, or a division of two
+ * parts. It is now ONE expression over the model — `[net_revenue] -
+ * [variable_costs]`, `divide([cm1], [net_revenue])` — stored as a tree of ids
+ * and shown as text of names, the two one-to-one.
+ *
+ * **The words of the formula are not here.** They come from
+ * `GET /measures/formula-spec`, which the platform generates from the module
+ * that also parses — the same list its editor shows. A copy in this connector
+ * would be a second list, and two lists drift: the reason
+ * `get_workflow_authoring_spec` exists. `get_measure_formula_spec` forwards it
+ * untouched.
+ *
+ * **Checking is the platform's too.** `validate_measure` forwards to
+ * `POST /measures/validate`, the route the editor calls while somebody types,
+ * so an agent and a person can never disagree about whether a formula is
+ * acceptable. `read_measure` asks that same route to write the stored tree back
+ * as text, rather than this connector unparsing it.
+ *
+ * The one rule held HERE is the shape of a write: a measure is written as
+ * `definition.expression`, and the fields from before the formula are refused
+ * with `legacy_field`. The platform still accepts them while its own form is
+ * replaced; an agent has no such form to keep working, and a measure written
+ * the old way today is one that has to be migrated again.
+ */
+import { z } from "zod";
+import { guard, jsonResult } from "./result.js";
+const MEASURES = "/api/v1/measures";
+/** The language: every word, operator, grain, limit, code and recipe. */
+export const FORMULA_SPEC_ROUTE = `${MEASURES}/formula-spec`;
+/** The vocabulary of THIS workspace: its measures, tables, columns, calendars. */
+export const FORMULA_SYMBOLS_ROUTE = `${MEASURES}/formula-symbols`;
+/** Check a formula without saving it. */
+export const VALIDATE_ROUTE = `${MEASURES}/validate`;
+/** Top-level fields from before the formula: the measure's "home table". */
+const LEGACY_TOP = ["tableId", "clearTable"];
+/** Fields inside `definition` that the formula replaces. */
+const LEGACY_DEFINITION = ["aggregation", "column", "numerator", "denominator"];
+/** Present in the sense that matters: sent, and not a null that clears nothing. */
+function isSent(value) {
+    return value !== undefined && value !== null && value !== false;
+}
+/**
+ * Refuse a measure write in the shape from before the formula.
+ *
+ * Throws with `legacy_field` — the platform's own code for it, so an agent
+ * that repairs on codes reads the same word from either side. A `definition`
+ * without `expression` is refused too: the platform would quietly store it as
+ * a `sum`, which is a definition nobody wrote.
+ */
+export function assertFormulaShape(fields) {
+    const found = LEGACY_TOP.filter((key) => isSent(fields[key]));
+    const definition = fields.definition;
+    if (definition !== undefined && definition !== null) {
+        if (typeof definition !== "object" || Array.isArray(definition)) {
+            throw new Error("`definition` must be an object with an `expression`.");
+        }
+        const def = definition;
+        found.push(...LEGACY_DEFINITION.filter((key) => isSent(def[key])).map((key) => `definition.${key}`));
+        if (found.length === 0 && !isSent(def.expression)) {
+            throw new Error("legacy_field: `definition` has no `expression`. A measure is one " +
+                "formula — send it as `definition.expression`, e.g. " +
+                '"sum(orders.amount)" or "[net_revenue] - [variable_costs]". ' +
+                "Read get_measure_formula_spec for the words, and check it with " +
+                "validate_measure first.");
+        }
+    }
+    if (found.length === 0)
+        return;
+    throw new Error(`legacy_field: ${found.map((f) => `\`${f}\``).join(", ")} ` +
+        `${found.length === 1 ? "is" : "are"} the shape from before the formula. ` +
+        "A measure is one `definition.expression` now, and the tables it reads " +
+        "follow from it: `sum(orders.amount)` instead of `tableId` + " +
+        "`aggregation` + `column`, `divide(sum(a.x), sum(b.y))` instead of a " +
+        "`numerator` and a `denominator`, `… where table.column = 'value'` " +
+        "for a condition on one part. Remove these fields and write the " +
+        "formula — validate_measure checks it before you save.");
+}
+/**
+ * The stored tree, written back as text with its leaves, by the platform.
+ *
+ * Best effort, and said so: a read must not fail because the explanation
+ * could not be produced. When it cannot, the measure comes back as stored with
+ * a sentence saying why its formula text is missing.
+ */
+async function explainFormula(client, measure, useDraftChain) {
+    const expression = measure.definition?.expression;
+    if (expression === undefined || expression === null) {
+        return {
+            formula: null,
+            formulaNote: "This measure has no formula yet — it is still in the shape from " +
+                "before the formula. Write one with update_measure " +
+                "(`definition.expression`).",
+        };
+    }
+    try {
+        const checked = (await client.post(VALIDATE_ROUTE, {
+            expression,
+            measureId: typeof measure.id === "string" ? measure.id : undefined,
+            quantity: measure.definition?.quantity ?? undefined,
+            format: measure.definition?.format ?? undefined,
+            useDraftChain,
+        }));
+        return {
+            formula: {
+                text: checked.formula,
+                tree: expression,
+                leaves: checked.leaves ?? [],
+                quantity: checked.quantity ?? null,
+                problems: checked.problems ?? [],
+                chain: useDraftChain ? "drafts" : "published",
+            },
+        };
+    }
+    catch (err) {
+        return {
+            formula: { text: null, tree: expression },
+            formulaNote: "The formula text and its leaves could not be read from this deploy " +
+                `(\`POST ${VALIDATE_ROUTE}\`: ${err instanceof Error ? err.message : String(err)}). ` +
+                "The stored tree is above.",
+        };
+    }
+}
+export function registerMeasureFormulaTools(server, client) {
+    server.tool("get_measure_formula_spec", "The ONLY valid list of words for a measure's formula — read it BEFORE " +
+        "create_measure or update_measure, and never write a function, " +
+        "operator or grain from memory. Read-only. " +
+        "\n\nServed by the platform from the code that parses a formula, so it " +
+        "is the same list its formula editor shows: per word its signature, " +
+        "what it returns, its quantity rule and an example; the operators, " +
+        "grains and limits; every refusal `code` with `when` and `fix`; " +
+        "`recipes` for the numbers a management team asks for (a sum over two " +
+        "facts, a margin %, a share of the total); and `buildOrder`. A word " +
+        "with `available: false` is coming and is refused by name " +
+        "(`not_yet_supported`) — do not use it. " +
+        "\n\n`includeWorkspace: true` adds THIS workspace's vocabulary as " +
+        "`workspace`: its measures (name, label, quantity, status), its tables " +
+        "and columns, and which dimensions each table reaches — the names a " +
+        "formula may use. The answer is then `{ spec, workspace }`; without " +
+        "it, the spec itself.", {
+        includeWorkspace: z
+            .boolean()
+            .optional()
+            .describe("Also return this workspace's measures, tables, columns and " +
+            "reachable dimensions. Defaults to false."),
+        useDraftChain: z
+            .boolean()
+            .optional()
+            .describe("With includeWorkspace: include tables and measures that were never " +
+            "published. Defaults to false — a published number reads " +
+            "published definitions."),
+    }, async ({ includeWorkspace, useDraftChain }) => guard(async () => {
+        const spec = await client.get(FORMULA_SPEC_ROUTE);
+        if (!includeWorkspace)
+            return jsonResult(spec);
+        const workspace = await client.get(FORMULA_SYMBOLS_ROUTE, {
+            useDraftChain: useDraftChain ?? false,
+        });
+        return jsonResult({ spec, workspace });
+    }));
+    server.tool("validate_measure", "Check a measure's formula WITHOUT saving it — call it before every " +
+        "create_measure and update_measure. Read-only. The same check the " +
+        "platform's editor runs while somebody types. " +
+        "\n\nAnswers `{ ok, formula, expression, quantity, leaves, problems }`: " +
+        "`formula` is the one spelling of it (names resolved, the brackets " +
+        "that apply shown); `expression` the tree that would be stored; " +
+        "`quantity` what the number counts, derived; `leaves` every " +
+        "aggregation it folds down to — table, aggregation, column, the " +
+        "conditions and ignored dimensions on that part, and the measures " +
+        "walked to reach it. " +
+        "\n\nEach problem has a `code`, a `message` and `where` (an `offset` " +
+        "in the text, or a `path` in the tree). `severity: error` blocks " +
+        "saving; a warning does not. Repair on the code — " +
+        "get_measure_formula_spec lists every one with its `fix` — before you " +
+        "ask a person: `parse_error` (the message says what was expected " +
+        "where), `unknown_measure` / `unknown_table` / `unknown_column` " +
+        "(similar names are suggested), `ambiguous_column` (write " +
+        "table.column), `column_kind`, `arity`, `cycle` (the chain is in the " +
+        "message), `too_complex` (give a part its own name), " +
+        "`quantity_mismatch` (adding euros to dogs, or a format that does not " +
+        "fit), `unreachable_dimension` (declare the relationship, or write " +
+        "`ignore` to mean the total on purpose), `not_yet_supported`. " +
+        "`quantity_generic` is a warning: the migration left the placeholder " +
+        "quantity — say what the number counts.", {
+        expression: z
+            .union([z.string(), z.record(z.unknown())])
+            .describe("The formula, as text (`divide([cm1], [net_revenue])`) or as the " +
+            "stored tree."),
+        measureId: z
+            .string()
+            .optional()
+            .describe("The measure being edited, when there is one — it is what makes a " +
+            "reference back to itself a `cycle`."),
+        quantity: z
+            .string()
+            .optional()
+            .describe("What the number counts, when you have said (EUR, customers, " +
+            "orders). Required on save for a single aggregation."),
+        format: z
+            .record(z.unknown())
+            .optional()
+            .describe("How it will be shown, as on the measure's `definition.format` — " +
+            "checked against what the number counts."),
+        useDraftChain: z
+            .boolean()
+            .optional()
+            .describe("Read the DRAFTS of the measures underneath instead of their " +
+            "published versions. Defaults to false, because a published " +
+            "number reads published definitions."),
+    }, async (body) => guard(async () => jsonResult(await client.post(VALIDATE_ROUTE, body))));
+    server.tool("read_measure", "Read one measure by id, including its current draft and version. Read " +
+        "before you update — you need the current version. " +
+        "\n\nIts formula comes back twice, from the platform: `formula.text` " +
+        "with names, as you would write it, and `formula.tree`, the stored " +
+        "form with ids. Beside them `formula.leaves` — the aggregations it " +
+        "folds down to, each on its own table — `formula.quantity`, and " +
+        "`formula.problems`: a measure that rests on a column or measure that " +
+        "has since gone says so here. `readsTables` follows from the leaves; " +
+        "there is no home table.", {
+        id: z.string().describe("The measure's id."),
+        useDraftChain: z
+            .boolean()
+            .optional()
+            .describe("Resolve the measures it rests on from their drafts instead of " +
+            "their published versions. Defaults to false; set it for a " +
+            "measure whose parts were never published, or their names " +
+            "cannot be shown."),
+    }, async ({ id, useDraftChain }) => guard(async () => {
+        const measure = (await client.get(`${MEASURES}/${id}`));
+        return jsonResult({
+            ...measure,
+            ...(await explainFormula(client, measure, useDraftChain ?? false)),
+        });
+    }));
+}
+//# sourceMappingURL=measureFormula.js.map

package/dist/tools/measureFormula.js.map

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