@axonity-ai/mcp 0.17.1 → 0.19.0

package/README.md

@@ -55,8 +55,9 @@ was kept here. A conformance test asserts their absence.
 
 ### The generic entity family
 
-Twelve entities — **workflow, agent, tool, skill, policy, reference_doc,
-persona, output_schema, prompt_snippet, flow, data_table, measure** — share one shape,
+Thirteen entities — **workflow, agent, tool, skill, policy, reference_doc,
+persona, output_schema, prompt_snippet, flow, data_table, measure,
+application** — share one shape,
 though not every entity gets every verb (see the per-entity notes below for the
 exceptions):
 
@@ -73,8 +74,9 @@ exceptions):
 | `request_publish_<entity>` | Ask for a draft to be published — creates a pending approval; never publishes. |
 
 Exceptions: `persona` has no `create_persona` (create only via
-`create_agent_persona`). And `list_data_tables` answers **one page**, not the
-whole library — see Tables below.
+`create_agent_persona`). And `list_data_tables` (like `list_measures` and
+`list_applications`) answers **one page**, not the whole library — see Tables
+below.
 
 Three more entities use the same verbs **without** the draft ones —
 **data_source, table_relationship, dashboard**. None is versioned: a change is
@@ -91,7 +93,8 @@ backend applies it before the rows come back:
 `list_prompt_snippets({ deleted? })`,
 `list_data_tables({ name?, status?, isDynamic? })`,
 `list_data_sources({ enabled? })`,
-`list_table_relationships({ tableId? })`.
+`list_table_relationships({ tableId? })`,
+`list_applications({ name? })`.
 
 That table is **generated** from the pinned schema's own query parameters
 (`npm run generate:filters` → `src/generated/listFilters.ts`), not hand-listed.
@@ -129,7 +132,8 @@ Plus:
 
 ### Version history, rollback, and version-level delete
 
-For the eleven versioned entities (including `flow` and `data_table`):
+For the versioned entities (including `flow`, `data_table`, `measure` and
+`application`):
 
 | Tool | What it does |
 |------|--------------|
@@ -255,10 +259,11 @@ across these routes — the tool parameter names say which.
     would yield), `toolId` (whether a row exists) and `isLive` (whether a run
     can reach it) separately — an author who ticked "may add rows" and has not
     published has granted nothing yet.
-- **The semantic model** (`data_source`, `data_table` with provenance,
-  `table_relationship`, `measure`, concepts, `dashboard`): a workspace
-  connects a warehouse such as BigQuery, dynamic tables are filled from it on
-  a schedule, measures define the numbers over those tables, concepts say
+- **The semantic model** (`data_source`, `query`, `data_table`,
+  `table_relationship`, `measure`, concepts and their links, `dashboard`): a
+  workspace connects a warehouse such as BigQuery, named queries read it,
+  dynamic tables are filled by those queries on a schedule, measures define
+  the numbers over those tables, concepts say
   what each word and number means, and dashboards show the measures. Read
   `axonity_semantic_conventions` before building one — the platform serves
   those rules.
@@ -273,12 +278,24 @@ across these routes — the tool parameter names say which.
     `query_data_source` runs read-only SQL with capped rows (`truncated` says
     when rows were left out); a 422 is the query being refused, a 502 is the
     warehouse.
-  - **There is no sync object.** A dynamic table carries its own
-    `provenance` — `{ sourceId, sql, grain, keyColumns, mode, cron, timezone,
-    enabled }` — on `create_data_table` / `update_data_table`, so a changed
-    query is published like a changed column. `refresh_data_table` fills it
-    now instead of at its next turn (it does not wait for the result; read
-    the table's `fill` afterwards).
+  - **A query is its own versioned entity** (`query`): the generic family
+    plus the version tools, `request_publish_query`, `test_query` (run it
+    once with values; it suggests the `returns`), `read_query_usage` (the
+    read tool its publication mints, and which agents hold it) and
+    `list_query_live_versions`. It carries the SQL, the source, the grain,
+    its typed `parameters` and its described `returns`.
+  - **There is no sync object, and no `provenance`.** A table says what fills
+    it in `filledBy` — `author`, `workflow` or `query` — and a query-filled
+    table names its query in `fillingQueryId` and when it runs in `rhythm`
+    (`{ cron, timezone, keyColumns, mode, enabled }`). Only a table filled by
+    a query or a workflow is dynamic, and only a dynamic table can be read by
+    a measure. `refresh_data_table` fills it now instead of at its next turn
+    (it does not wait for the result; read the table's `fill` afterwards).
+  - **Concept links**: a concept's `refersTo` points at one thing;
+    `link_concept`, `unlink_concept` and `list_concept_links` hang the same
+    word on every column, table, measure, value or query that means it. The
+    links are rows of the `concept_links` table and go live when that table
+    is published.
   - **A measure is its own versioned entity**: the generic family plus the
     version tools, `request_publish_measure`, and `list_measure_live_versions`.
     It names the concept it means in `concept`, and the questions it answers
@@ -317,6 +334,42 @@ across these routes — the tool parameter names say which.
     tile). Plus `duplicate_dashboard`.
   - A reference doc has no `semanticKind` any more; the platform refuses it
     and the other retired fields and says where each one went.
+- **Applications** (`application`): a program an agent operates through an
+  executor — a Windows program (`win32`) or a website (`web`) — with its
+  `limits`, what the agent may never do in it (processes, windows, keys,
+  buttons, folders, domains, secrets by name). The generic family and the
+  version tools, and `request_publish_application`: an executor receives only
+  the published limits, so only a human makes them live.
+  - **Executors**: `set_application_executors` / `read_application_executors`
+    choose the machines an application runs on (the whole set at once);
+    `list_executors`, `read_executor`, `read_executor_applications` and
+    `list_executor_commands` only read. Registering or revoking an executor
+    is a human's job — it mints a token, and no tool here ever returns one.
+  - **What it has learned**: `list_application_knowledge` (elements,
+    instructions, lessons, one page at a time) and
+    `list_application_knowledge_versions`; `forget_application_knowledge`,
+    `restore_application_knowledge` and `write_application_knowledge` to
+    correct it. Linking executors and changing knowledge are reserved for a
+    workspace administrator on the platform, and a service token always
+    counts as a member, so today those answer with a refusal that says so.
+- **Who may read what** (labels, audiences, roles): every policy, skill,
+  reference doc and table carries a label — `level` (public, internal,
+  confidential) and `audienceIds`, whom it is meant for. `list_audiences` /
+  `read_audience` give the ids to put there, `list_roles` / `read_role` say
+  what each role reads and maintains, and `read_member_roles` which roles a
+  colleague holds. Leave the label out and it gets the default (internal, for
+  Staff); `level: null` makes a thing readable by nobody. Narrowing a label is
+  always allowed; widening it is a colleague's act, and the refusal says so.
+  An agent's `clearance` is set by an administrator; a workflow's by its
+  author, through the publish approval. Managing audiences and roles is not
+  here yet.
+- **The knowledge graph** (Cortex), read with the token's own clearance:
+  `search_knowledge_graph`, `list_knowledge_topics`, `list_topic_facts`,
+  `read_fact` (passages, sources, certainty, validity, which run taught it),
+  `read_source`, `list_knowledge_tree`, `list_related_topics` and
+  `list_archived_facts`. Looking only: confirming, correcting, archiving or
+  relabelling a fact ends with a person. With the module off, every call says
+  so in plain words.
 - `list_deleted_prompt_snippets` calls `/api/v1/prompt-snippets/deleted`; the
   backend returns it as `{ items: [... ] }`, and the tool forwards that response
   unchanged.

package/dist/errors.js

@@ -167,21 +167,51 @@ export class AuthError extends AxonityApiError {
  * cannot…" here sends it and its human to the token settings for something no
  * token setting fixes (#78).
  */
-const ADMIN_ONLY_SENTENCE = /only administrators/i;
+const ADMIN_ONLY_SENTENCE = /only (administrators|an administrator)\b/i;
+/**
+ * The platform's sentence when a whole MODULE is off in the workspace
+ * ("Cortex is switched off in this workspace…"). Not the token's fault and not
+ * the call's: the advice is the opposite of the scope advice, so it gets its
+ * own words (axonity-mcp#88).
+ */
+const MODULE_OFF_SENTENCE = /is switched off in this workspace/i;
+/**
+ * The platform's refusal to WIDEN a label — make knowledge readable for more
+ * people. Widening is publishing, and only a colleague who maintains the
+ * audiences may do it; a token never can, whatever its scopes (axonity-mcp#88).
+ */
+const WIDENING_SENTENCE = /widen(ing)? a label/i;
+/** The 403 explanation for a refusal whose body says why. */
+function forbiddenExplanation(said) {
+    if (MODULE_OFF_SENTENCE.test(said)) {
+        return ("Forbidden (403): MODULE SWITCHED OFF. This part of Axonity is switched " +
+            "off in this workspace, so nothing in it can be read or changed — this " +
+            "is not a mistake in your call and not a limit of your token. Tell your " +
+            "human: a platform administrator can switch it on.");
+    }
+    if (WIDENING_SENTENCE.test(said)) {
+        return ("Forbidden (403): WIDENING A LABEL. Making something readable for more " +
+            "people (a lower level, or an audience added) is publishing it, and only " +
+            "a colleague who maintains those audiences may do that — never an agent " +
+            "or a token. Narrowing is always allowed. Keep the label as it is, or ask " +
+            "a colleague to widen it in Axonity.");
+    }
+    if (ADMIN_ONLY_SENTENCE.test(said)) {
+        return ("Forbidden (403): ADMINISTRATOR ONLY. This action is reserved for a " +
+            "workspace administrator, and a service token always counts as a " +
+            "member — so no token can do it, whatever its scopes. This is not a " +
+            "mistake in your call and retrying will not help. Tell your human: " +
+            "an administrator can do it in Axonity.");
+    }
+    return ("Forbidden (403): this service token is not allowed to perform that action. " +
+        "A read-only token cannot create, update, delete, or request-publish, and no " +
+        "token may publish directly — use request_publish_* and let a human approve.");
+}
 /** 403 — the token lacks the scope for this action (e.g. read-only on a write). */
 export class ForbiddenError extends AxonityApiError {
     constructor(body) {
         const env = asEnvelope(body);
-        const adminOnly = ADMIN_ONLY_SENTENCE.test(describeBody(body) ?? "");
-        super(withDetail(adminOnly
-            ? "Forbidden (403): ADMINISTRATOR ONLY. This action is reserved for a " +
-                "workspace administrator, and a service token always counts as a " +
-                "member — so no token can do it, whatever its scopes. This is not a " +
-                "mistake in your call and retrying will not help. Tell your human: " +
-                "an administrator can do it in Axonity."
-            : "Forbidden (403): this service token is not allowed to perform that action. " +
-                "A read-only token cannot create, update, delete, or request-publish, and no " +
-                "token may publish directly — use request_publish_* and let a human approve.", body), 403, body, env?.code ?? "forbidden", env?.retryable ?? false);
+        super(withDetail(forbiddenExplanation(describeBody(body) ?? ""), body), 403, body, env?.code ?? "forbidden", env?.retryable ?? false);
         this.name = "ForbiddenError";
     }
 }

package/dist/errors.js.map

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

package/dist/generated/listFilters.js

@@ -91,7 +91,13 @@ export const LIST_FILTERS = {
             arg: "isDynamic",
             query: "is_dynamic",
             type: "boolean",
-            description: "true: only tables a workflow may change. false: only reference data the author maintains. Omit for both.",
+            description: "true: only tables whose rows change without an author typing them. false: only reference data the author maintains. Omit for both. Derived from filledBy, which is the more precise question.",
+        },
+        {
+            arg: "filledBy",
+            query: "filled_by",
+            type: "string",
+            description: "Only tables filled this way: author, workflow or query. A value outside the three is refused rather than silently ignored.",
         },
     ],
     "data_source": [
@@ -118,5 +124,21 @@ export const LIST_FILTERS = {
             description: "Only the measures that read this table — what a table page shows.",
         },
     ],
+    "application": [
+        {
+            arg: "name",
+            query: "name",
+            type: "string",
+            description: "Only the application with exactly this name.",
+        },
+    ],
+    "query": [
+        {
+            arg: "dataSourceId",
+            query: "dataSourceId",
+            type: "string",
+            description: "Only the queries that read this source.",
+        },
+    ],
 };
 //# sourceMappingURL=listFilters.js.map

package/dist/generated/listFilters.js.map

@@ -1 +1 @@
-{"version":3,"file":"listFilters.js","sourceRoot":"","sources":["../../src/generated/listFilters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,MAAM,CAAC,MAAM,YAAY,GAAiC;IACxD,UAAU,EAAE;QACV;YACE,GAAG,EAAE,SAAS;YACd,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,sGAAsG;SACzG;QACD;YACE,GAAG,EAAE,cAAc;YACnB,KAAK,EAAE,eAAe;YACtB,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,kFAAkF;SACrF;KACF;IACD,OAAO,EAAE;QACP;YACE,GAAG,EAAE,eAAe;YACpB,KAAK,EAAE,eAAe;YACtB,IAAI,EAAE,SAAS;YACf,WAAW,EACT,uNAAuN;SAC1N;KACF;IACD,QAAQ,EAAE;QACR;YACE,GAAG,EAAE,OAAO;YACZ,KAAK,EAAE,OAAO;YACd,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,0PAA0P;SAC7P;QACD;YACE,GAAG,EAAE,SAAS;YACd,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,uGAAuG;SAC1G;KACF;IACD,eAAe,EAAE;QACf;YACE,GAAG,EAAE,OAAO;YACZ,KAAK,EAAE,OAAO;YACd,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,0PAA0P;SAC7P;QACD;YACE,GAAG,EAAE,SAAS;YACd,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,uGAAuG;SAC1G;KACF;IACD,gBAAgB,EAAE;QAChB;YACE,GAAG,EAAE,SAAS;YACd,KAAK,EAAE,SAAS;YAChB,IAAI,EAAE,SAAS;YACf,WAAW,EACT,oKAAoK;SACvK;KACF;IACD,YAAY,EAAE;QACZ;YACE,GAAG,EAAE,MAAM;YACX,KAAK,EAAE,MAAM;YACb,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,gOAAgO;SACnO;QACD;YACE,GAAG,EAAE,QAAQ;YACb,KAAK,EAAE,QAAQ;YACf,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,2JAA2J;SAC9J;QACD;YACE,GAAG,EAAE,WAAW;YAChB,KAAK,EAAE,YAAY;YACnB,IAAI,EAAE,SAAS;YACf,WAAW,EACT,0GAA0G;SAC7G;KACF;IACD,aAAa,EAAE;QACb;YACE,GAAG,EAAE,SAAS;YACd,KAAK,EAAE,SAAS;YAChB,IAAI,EAAE,SAAS;YACf,WAAW,EACT,4FAA4F;SAC/F;KACF;IACD,oBAAoB,EAAE;QACpB;YACE,GAAG,EAAE,SAAS;YACd,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,0IAA0I;SAC7I;KACF;IACD,SAAS,EAAE;QACT;YACE,GAAG,EAAE,SAAS;YACd,KAAK,EAAE,SAAS;YAChB,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,mEAAmE;SACtE;KACF;CACF,CAAC"}
+{"version":3,"file":"listFilters.js","sourceRoot":"","sources":["../../src/generated/listFilters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,MAAM,CAAC,MAAM,YAAY,GAAiC;IACxD,UAAU,EAAE;QACV;YACE,GAAG,EAAE,SAAS;YACd,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,sGAAsG;SACzG;QACD;YACE,GAAG,EAAE,cAAc;YACnB,KAAK,EAAE,eAAe;YACtB,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,kFAAkF;SACrF;KACF;IACD,OAAO,EAAE;QACP;YACE,GAAG,EAAE,eAAe;YACpB,KAAK,EAAE,eAAe;YACtB,IAAI,EAAE,SAAS;YACf,WAAW,EACT,uNAAuN;SAC1N;KACF;IACD,QAAQ,EAAE;QACR;YACE,GAAG,EAAE,OAAO;YACZ,KAAK,EAAE,OAAO;YACd,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,0PAA0P;SAC7P;QACD;YACE,GAAG,EAAE,SAAS;YACd,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,uGAAuG;SAC1G;KACF;IACD,eAAe,EAAE;QACf;YACE,GAAG,EAAE,OAAO;YACZ,KAAK,EAAE,OAAO;YACd,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,0PAA0P;SAC7P;QACD;YACE,GAAG,EAAE,SAAS;YACd,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,uGAAuG;SAC1G;KACF;IACD,gBAAgB,EAAE;QAChB;YACE,GAAG,EAAE,SAAS;YACd,KAAK,EAAE,SAAS;YAChB,IAAI,EAAE,SAAS;YACf,WAAW,EACT,oKAAoK;SACvK;KACF;IACD,YAAY,EAAE;QACZ;YACE,GAAG,EAAE,MAAM;YACX,KAAK,EAAE,MAAM;YACb,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,gOAAgO;SACnO;QACD;YACE,GAAG,EAAE,QAAQ;YACb,KAAK,EAAE,QAAQ;YACf,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,2JAA2J;SAC9J;QACD;YACE,GAAG,EAAE,WAAW;YAChB,KAAK,EAAE,YAAY;YACnB,IAAI,EAAE,SAAS;YACf,WAAW,EACT,+LAA+L;SAClM;QACD;YACE,GAAG,EAAE,UAAU;YACf,KAAK,EAAE,WAAW;YAClB,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,4HAA4H;SAC/H;KACF;IACD,aAAa,EAAE;QACb;YACE,GAAG,EAAE,SAAS;YACd,KAAK,EAAE,SAAS;YAChB,IAAI,EAAE,SAAS;YACf,WAAW,EACT,4FAA4F;SAC/F;KACF;IACD,oBAAoB,EAAE;QACpB;YACE,GAAG,EAAE,SAAS;YACd,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,0IAA0I;SAC7I;KACF;IACD,SAAS,EAAE;QACT;YACE,GAAG,EAAE,SAAS;YACd,KAAK,EAAE,SAAS;YAChB,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,mEAAmE;SACtE;KACF;IACD,aAAa,EAAE;QACb;YACE,GAAG,EAAE,MAAM;YACX,KAAK,EAAE,MAAM;YACb,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,8CAA8C;SACjD;KACF;IACD,OAAO,EAAE;QACP;YACE,GAAG,EAAE,cAAc;YACnB,KAAK,EAAE,cAAc;YACrB,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,yCAAyC;SAC5C;KACF;CACF,CAAC"}

package/dist/index.js

@@ -28,12 +28,16 @@ import { registerDataTableTools } from "./tools/dataTables.js";
 import { assertFormulaShape, registerMeasureFormulaTools } from "./tools/measureFormula.js";
 import { assertPlaceholderCredentials } from "./tools/credentials.js";
 import { registerAttachTools, registerCatalogTools, registerConnectorTools, registerDependencyTools, registerPersonaTools, } from "./tools/extras.js";
+import { registerApplicationTools } from "./tools/applications.js";
+import { registerAccessTools } from "./tools/access.js";
 import { registerAuthoringSpecTools } from "./tools/authoringSpec.js";
 import { registerCompanyTools } from "./tools/company.js";
 import { registerComponentTools } from "./tools/components.js";
 import { registerConceptTools } from "./tools/concepts.js";
+import { registerKnowledgeGraphTools } from "./tools/knowledgeGraph.js";
 import { registerOperationsTools } from "./tools/operations.js";
 import { registerPromptPlacementTools } from "./tools/promptPlacement.js";
+import { registerQueryTools } from "./tools/queries.js";
 import { LIST_FILTERS } from "./generated/listFilters.js";
 import { registerEntityTools } from "./tools/register.js";
 import { registerRunTools } from "./tools/runs.js";
@@ -44,22 +48,32 @@ import { registerTriggerTools } from "./tools/triggers.js";
 import { registerApprovalTools, registerExecutionTools, registerValidationTools, } from "./tools/validation.js";
 import { registerVersionTools } from "./tools/versions.js";
 import { registerWorkflowMutations } from "./tools/workflowMutations.js";
-const PROVENANCE_NOTE = "WHERE THE ROWS COME FROM — `provenance`, for a dynamic table filled from " +
-    "a warehouse. It replaces the old data-source sync: there is no separate " +
-    "sync object any more, so create_data_source_sync / run_data_source_sync " +
-    "do not exist. `provenance` is " +
-    "`{ sourceId, sql, grain, keyColumns?, mode?, cron, timezone?, enabled? }`: " +
-    "`sourceId` the data source; `sql` the query whose RESULT fills the table " +
-    "(try it first with query_data_source); `grain` what ONE ROW of that " +
-    "result is, as a sentence (\"one row per month per country\") — " +
-    "mandatory, it decides what the table can be asked for ever after; " +
-    "`keyColumns` which columns identify a row for `mode: \"upsert\"` (the " +
-    "default — `append` takes no key); `cron` when it runs, read in " +
-    "`timezone` (default UTC); `enabled: false` pauses it. A table with " +
-    "provenance has no other filler — a workflow may not also write its " +
-    "rows. It is part of the table's design, so a changed query is published " +
-    "through request_publish_data_table like a changed column. To fill it " +
-    "now rather than at its next turn: refresh_data_table. " +
+/**
+ * What fills a table (axonity-flow#2013). The inline `provenance` bag is gone:
+ * its SQL, source and grain moved to a named query, and what stays on the
+ * table is which filler it has and when it runs.
+ */
+const FILL_NOTE = "WHAT FILLS IT — `filledBy`, one word: `author` (the default: reference " +
+    "data its author maintains), `workflow` (a workflow writes the rows, " +
+    "limited to `allowedOperations`) or `query` (a named query fetches them). " +
+    "A table has ONE filler. `isDynamic` is no longer sent: it follows from " +
+    "`filledBy` — a table filled by a query or a workflow is dynamic, and " +
+    "ONLY A DYNAMIC TABLE CAN BE READ BY A MEASURE. Never set `filledBy: " +
+    "\"workflow\"` on a table no workflow fills just to make a measure read " +
+    "it; give it a query. " +
+    "\n\nFILLED BY A QUERY: `fillingQueryId` is the query (create_query, " +
+    "list_queries) — required with `filledBy: \"query\"`, refused otherwise, " +
+    "and one query fills one table. The query carries the SQL, the source " +
+    "and the grain. `rhythm` says when and how it fills: " +
+    "`{ cron, timezone?, keyColumns?, mode?, enabled? }` — `cron` when it " +
+    "runs, read in `timezone` (default UTC; an empty cron never runs by " +
+    "itself); `mode` `upsert` (the default: replaces the rows that match " +
+    "`keyColumns` and adds the rest) or `append` (takes no key); `enabled: " +
+    "false` pauses it and keeps its rows. Leave `rhythm` out and the table " +
+    "fills only when asked: refresh_data_table. The fill runs the query as " +
+    "it stands. " +
+    "\n\n`provenance` and `clearProvenance` no longer exist and are refused " +
+    "— the query took their place. " +
     "\n\nMEASURES ARE NOT ON THE TABLE. A measure is its own entity " +
     "(create_measure); a table carries only its `timeAxis` " +
     "(`{ column, grain }`), which every measure over it reads.";
@@ -96,8 +110,8 @@ const MEASURE_NOTE = "READ get_measure_formula_spec FIRST; never write a functio
     "as text or as the stored tree. Four kinds, one grammar: " +
     "\n- a BASE aggregates one COLUMN of one table: " +
     "`sum(orders.amount) where orders.channel = 'd2c'`. It reads a column, " +
-    "never a calculation per row — a value per row belongs in the table's " +
-    "source query (`provenance.sql`), as a column of its own; " +
+    "never a calculation per row — a value per row belongs in the query " +
+    "that fills the table, as a column of its own; " +
     "\n- a DERIVED measure computes with other measures by name: " +
     "`[revenue_d2c] + [revenue_retail]`, `divide([cm1], [net_revenue])`, " +
     "`divide([revenue_d2c], [net_revenue] ignore orders.channel)` for a share " +
@@ -125,6 +139,94 @@ const MEASURE_NOTE = "READ get_measure_formula_spec FIRST; never write a functio
     "refused with `legacy_field`. " +
     "\n\nIt is a DRAFT until published: request_publish_measure. Only a " +
     "published measure gives a certified number.";
+/**
+ * What an application is made of (axonity-flow#1901). The limits are the point:
+ * an executor enforces them on every command, so a wrong key is a limit nobody
+ * enforces — the platform refuses unknown keys, and this says which exist.
+ */
+const APPLICATION_NOTE = "Fields: `name` (unique in the workspace), `technology` (`win32` for a " +
+    "Windows desktop program, `web` for a site in a browser), `description` " +
+    "and `limits` — what an agent may NEVER do in it, enforced by the executor " +
+    "on the machine. `limits` keys stay snake_case, the way the executor reads " +
+    "them, and an unknown key is refused: `processes` (executables it may " +
+    "touch, `app.exe`), `windows` (window classes it may act in), " +
+    "`never_keys` (key combinations it may never send, `ctrl+a`), " +
+    "`never_buttons` (button captions it may never press), `folders` (folders " +
+    "it stays inside), `domains` (web domains it stays inside, " +
+    "`nl.wikipedia.org`), `secrets` (workspace secrets it may type, BY NAME — " +
+    "never a value), `home` (a website's start address) and `readers` (per " +
+    "control class, how a screen reader reads it). " +
+    "\n\nAn executor receives only the PUBLISHED limits, never a draft: " +
+    "request_publish_application, then a human approves. Which machines run it " +
+    "is set_application_executors.";
+/**
+ * Who may read a piece of knowledge (axonity-mcp#88, S2; axonity-flow#1918).
+ * The four knowledge kinds carry a label; the backend already took the fields,
+ * and nothing told an agent they exist or that `null` means "nobody".
+ */
+const LABEL_NOTE = "WHO MAY READ IT — the label. `level` is how sensitive it is (public, " +
+    "internal or confidential); `audienceIds` is whom it is meant for, as ids " +
+    "from list_audiences — never guess one and never match on a name. Leave " +
+    "both out and it gets the workspace default: internal, for Staff. " +
+    "Sending `level: null` means NO label: nobody can read it — no colleague, " +
+    "no agent — until a colleague who maintains its audience labels it. You " +
+    "can only give a label you can read yourself.";
+const LABEL_UPDATE_NOTE = "CHANGING WHO MAY READ IT. Narrowing is always allowed: a higher " +
+    "`level`, or an audience taken away. WIDENING — a lower level, or an " +
+    "audience added — makes it readable for more people, which is publishing " +
+    "it, and only a colleague who maintains those audiences may do that. A " +
+    "token never can: the refusal says so, and the way forward is to ask a " +
+    "colleague in Axonity, not to try another route. `audienceIds` replaces " +
+    "the whole set — send the ones it keeps too. `level: null` removes the " +
+    "label, which leaves it readable by nobody.";
+/** What an agent or a process may read (axonity-mcp#88, S2). */
+const CLEARANCE_SHAPE = "`clearance` is `{ maxLevel, audienceIds }`: up to which level it reads " +
+    "(public, internal or confidential; null reads nothing) and for which " +
+    "audiences (ids from list_audiences).";
+const AGENT_CLEARANCE_NOTE = "WHAT THE AGENT MAY READ. " +
+    CLEARANCE_SHAPE +
+    " Only an ADMINISTRATOR sets it, so a token sending it is refused: leave " +
+    "it out and the agent gets the workspace default, internal for Staff. " +
+    "Inside a workflow the agent never reads more than the workflow's own " +
+    "clearance.";
+const WORKFLOW_CLEARANCE_NOTE = "WHAT THE PROCESS MAY READ. " +
+    CLEARANCE_SHAPE +
+    " Set it to the audiences of whoever the process serves. A new workflow " +
+    "starts with the workspace default (internal, for Staff); change it with " +
+    "update_workflow({ fields: { clearance } }). It takes effect through the " +
+    "publish approval like the rest of the workflow, and no agent in the " +
+    "process ever reads more than this.";
+/**
+ * What a query is made of (axonity-flow#2010, S1). A query is a named, typed
+ * read of one source: it answers an agent's question once published, and it
+ * fills a table. The SQL, source and grain that used to sit in a table's
+ * `provenance` live here now.
+ */
+const QUERY_NOTE = "A QUERY is a named, typed read of one data source. Published, it does " +
+    "two things: it becomes a read tool an agent can be given (its " +
+    "`description` is what that agent reads), and it can fill a table " +
+    "(`filledBy: \"query\"`, `fillingQueryId` on the table). " +
+    "\n\nFields: `name` (unique in the workspace; the tool carries it), " +
+    "`description` (what it answers), `dataSourceId` (required — " +
+    "list_data_sources), `sql` (read-only, in the warehouse's own dialect, " +
+    "with each input written `:name`; read_data_source_schema spells the " +
+    "tables), `grain` (what ONE ROW is, as a sentence — \"one row per month " +
+    "per country\"), `questions` (how somebody would ask for this, at most " +
+    "20), `parameters` and `returns`. " +
+    "\n\n`parameters` (at most 20): `[{ name, label?, kind, description?, " +
+    "required?, default?, choiceOptions? }]`. `kind` is text, number, date, " +
+    "datetime, time, yes-no or choice — one value, never a list or an " +
+    "object. A value is BOUND, never written into the statement. An optional " +
+    "one with no value binds NULL, which is what `(:land is null or l = " +
+    ":land)` is written for. " +
+    "\n\n`returns`: `[{ name, label?, kind, description, concept? }]`, one " +
+    "per column the statement hands back, named exactly as it returns it. " +
+    "`kind` adds object and list to the parameter kinds. Every column needs " +
+    "a `description` before the query can be published. " +
+    "\n\nThe statement can carry its own figures: a query with no table " +
+    "behind it (a `select … union all select …` of plan values) is a query " +
+    "like any other. Try it with test_query before you ask for publication; " +
+    "its answer suggests `returns` from what came back.";
 /**
  * The entities the connector covers. Core entities (C4), memory entities (C5)
  * — skills, policies, reference docs — which have the same draft→publish
@@ -138,6 +240,8 @@ const ENTITIES = [
         updateMethod: "PATCH",
         label: "workflows (business processes)",
         deleteVersionParam: "expectedVersion",
+        createNote: WORKFLOW_CLEARANCE_NOTE,
+        updateWarning: WORKFLOW_CLEARANCE_NOTE,
     },
     {
         singular: "agent",
@@ -145,6 +249,8 @@ const ENTITIES = [
         updateMethod: "PUT",
         label: "agents",
         deleteVersionParam: "expectedVersion",
+        createNote: AGENT_CLEARANCE_NOTE,
+        updateWarning: AGENT_CLEARANCE_NOTE,
     },
     {
         singular: "tool",
@@ -162,6 +268,8 @@ const ENTITIES = [
         updateMethod: "PUT",
         label: "skills (reusable know-how for agents)",
         deleteVersionParam: "expected_version",
+        createNote: LABEL_NOTE,
+        updateWarning: LABEL_UPDATE_NOTE,
     },
     {
         singular: "policy",
@@ -170,6 +278,8 @@ const ENTITIES = [
         label: "policies (rules and guardrails for agents)",
         plural: "policies",
         deleteVersionParam: "expected_version",
+        createNote: LABEL_NOTE,
+        updateWarning: LABEL_UPDATE_NOTE,
     },
     {
         singular: "reference_doc",
@@ -177,6 +287,8 @@ const ENTITIES = [
         updateMethod: "PUT",
         label: "reference docs (background knowledge for agents)",
         deleteVersionParam: "expected_version",
+        createNote: LABEL_NOTE,
+        updateWarning: LABEL_UPDATE_NOTE,
     },
     {
         singular: "output_schema",
@@ -226,20 +338,24 @@ const ENTITIES = [
         label: "tables (authored reference data agents and decisions read)",
         deleteVersionParam: "expected_version",
         listPaging: { defaultPageSize: 20, maxPageSize: 200 },
-        createNote: `${PROVENANCE_NOTE}\n\n${DATE_TABLE_NOTE}`,
+        createNote: `${FILL_NOTE}\n\n${DATE_TABLE_NOTE}\n\n${LABEL_NOTE}`,
         deleteNote: BREAKS_MEASURE_NOTE,
         publishNote: BREAKS_MEASURE_NOTE,
-        updateWarning: PROVENANCE_NOTE +
+        updateWarning: FILL_NOTE +
+            " On an update: `clearFillingQuery: true` takes the query away and " +
+            "leaves the rows that are there; `rhythm` is replaced whole when sent; " +
+            "`clearRhythm: true` takes it away (the table then fills only when " +
+            "asked), which is not the same as pausing it. " +
             "\n\n" +
             DATE_TABLE_NOTE +
-            " Sending `provenance` replaces it whole; `clearProvenance: true` " +
-            "takes the source away and leaves the rows that are there. " +
             "\n\n`rows` AND `columns` ARE WHOLE-COLLECTION FIELDS: sending either " +
             "REPLACES it entirely. Passing one row in `rows` does not append it — it " +
             "deletes every other row in the table. To change content, use " +
             "add_data_table_row / update_data_table_row / delete_data_table_row, " +
             "which address a single row and cannot destroy the rest. Use `rows` here " +
-            "only when you genuinely mean to replace the whole content.",
+            "only when you genuinely mean to replace the whole content." +
+            "\n\n" +
+            LABEL_UPDATE_NOTE,
     },
     {
         // A measure was a field on a table; the semantic model (axonity-flow#1881
@@ -273,6 +389,60 @@ const ENTITIES = [
             "the tables it reads follow from its formula. Sending `definition` " +
             "replaces it whole, so send the `expression` with it.",
     },
+    {
+        // A named read of one source (axonity-flow#2010, S1), with routes in the
+        // same order and spelling as a measure's — so the whole family comes from
+        // the registrars. Running it once, and who holds its tool, are in
+        // tools/queries.ts.
+        singular: "query",
+        basePath: "/api/v1/queries",
+        updateMethod: "PUT",
+        plural: "queries",
+        label: "queries (named, typed reads of a data source that answer an agent and fill tables)",
+        deleteVersionParam: "expectedVersion",
+        listPaging: { defaultPageSize: 20, maxPageSize: 200 },
+        createNote: QUERY_NOTE,
+        deleteNote: "A query that fills a table, or whose tool an agent holds, is used: " +
+            "read_query_usage says who holds its tool, and list_data_tables " +
+            "({ filledBy: \"query\" }) which tables it fills.",
+        publishNote: "Refused while read_query's `publishBlockers` is not empty — each one " +
+            "names what is missing (a grain, a column without a description, a " +
+            "parameter the statement does not use). Publishing makes its read tool " +
+            "live for every agent that holds it.",
+        updateWarning: QUERY_NOTE +
+            " On an update, `parameters`, `returns` and `questions` are replaced " +
+            "WHOLE when sent: read first and send the complete list, each item " +
+            "with its `id` so it stays the same item.",
+    },
+    {
+        // A program an agent operates through an executor (axonity-flow#1901),
+        // with routes in the same order and spelling as a table's — so the whole
+        // family comes from the registrars. What is not generic (the executors it
+        // runs on, what it has learned) is in tools/applications.ts.
+        singular: "application",
+        basePath: "/api/v1/applications",
+        updateMethod: "PUT",
+        label: "applications (programs an agent operates through an executor, with their limits)",
+        deleteVersionParam: "expected_version",
+        listPaging: { defaultPageSize: 20, maxPageSize: 200 },
+        createNote: APPLICATION_NOTE,
+        updateWarning: APPLICATION_NOTE +
+            " `limits` is replaced WHOLE when sent: read the application first and " +
+            "send the complete object, or a limit you left out is gone.",
+        publishNote: "The limits are what an executor on a customer's machine is allowed to " +
+            "do, which is why only a human makes them live. Until the approval is " +
+            "decided, the executors keep the limits published before. " +
+            "\n\nPublishing is also what rebuilds the application's act/observe " +
+            "tools from the published version. To publish again WITHOUT a change — " +
+            "an application already live, no draft, the request refused as " +
+            "`already_live` — call ensure_application_major_version first: it opens " +
+            "a draft of the current content, and this request then goes through. " +
+            "Never edit a field just to make a draft. A platform release rebuilds " +
+            "these tools by itself on start, so a new tool shape after a deploy " +
+            "needs no publish. To take a workflow live with the application its " +
+            "agents operate, request this alongside request_publish_release: a " +
+            "release does not carry the application yet.",
+    },
     // The three below arrived with axonity-flow#1849 (axonity-mcp#78). None is
     // versioned or publish-approved: a change is live the moment it is saved, so
     // there is no draft to discard and no request_publish_*. Each lists one page
@@ -296,9 +466,9 @@ const ENTITIES = [
             "(maxBytesBilled, maxSeconds, allowedDatasets, forbiddenDatasets, " +
             "personalColumns, dateFilters); all are empty by default. " +
             "\n\nThen test_data_source to see whether it answers. A table is " +
-            "filled from this source through its own `provenance.sourceId` " +
-            "(create_data_table) — not through a sync, and not through a " +
-            "reference doc.",
+            "filled from this source by a query that reads it (create_query, " +
+            "then `filledBy: \"query\"` and `fillingQueryId` on the table) — not " +
+            "through a sync, and not through a reference doc.",
         updateWarning: "NO DRAFT: this changes the live source, which every table it fills and every query " +
             "uses at once. `config` and `policy` are replaced WHOLE when sent — " +
             "read first and send the complete block.",
@@ -376,6 +546,12 @@ const VERSIONED = [
         publishedPath: "versions",
     },
     { singular: "measure", basePath: "/api/v1/measures", publishedPath: "versions" },
+    { singular: "query", basePath: "/api/v1/queries", publishedPath: "versions" },
+    {
+        singular: "application",
+        basePath: "/api/v1/applications",
+        publishedPath: "versions",
+    },
 ];
 export function registerAll(server, client) {
     registerConventions(server, client);
@@ -415,7 +591,11 @@ export function registerAll(server, client) {
     registerMeasureFormulaTools(server, client);
     registerDashboardTools(server, client);
     registerConceptTools(server, client);
+    registerQueryTools(server, client);
     registerComponentTools(server, client);
+    registerApplicationTools(server, client);
+    registerAccessTools(server, client);
+    registerKnowledgeGraphTools(server, client);
 }
 export function buildServer(client) {
     const server = new McpServer({ name: "axonity", version: "0.1.0" });