@axonity-ai/mcp 0.25.0 → 0.27.0

package/dist/tools/extras.js

@@ -1,31 +1,66 @@
 /**
- * Secondary MCP tools: the agent-scoped persona create/read (personas
- * themselves are a full generic entity — see index.ts — but creation and the
- * by-agent read have no equivalent generic route), connectors (a tool
- * subtype), attaching memory to a target, and a few standalone one-offs.
+ * Secondary MCP tools: an agent's persona, connectors (a tool subtype),
+ * attaching memory to a target, and a few standalone one-offs.
  *
  * These use routes with shapes that don't fit the generic entity registrar:
- * a persona is created only through its agent, connectors are a tool with
+ * the persona is a field of its agent, connectors are a tool with
  * `type: "connector"` and MUST NOT carry real credentials, and attach/detach
  * is a path-only link.
  */
 import { z } from "zod";
 import { assertPlaceholderCredentials } from "./credentials.js";
 import { detachResult, guard, jsonResult } from "./result.js";
+/**
+ * The persona is the agent's `persona` field (axonity-flow#2176): the
+ * character text every prompt of the agent opens with, published with the
+ * agent. The persona entity, its own id, versions, drafts and approvals are
+ * gone, and so are the persona routes the tools called (21 persona operations
+ * left the API; 19 of them had a tool here).
+ *
+ * These two tools stay as the migration path: an agent that knows them lands
+ * on the field instead of on a 404 it would read as "no such id". Everything
+ * else about a persona is the agent's: its history is the agent's versions,
+ * it goes live with `request_publish_agent`.
+ */
 export function registerPersonaTools(server, client) {
-    server.tool("read_agent_persona", "Read an agent's persona (voice/character). A persona is 1:1 with an agent — " +
-        "there is no standalone persona list.", { agentId: z.string().describe("The agent's id.") }, async ({ agentId }) => guard(async () => jsonResult(await client.get(`/api/v1/agents/${agentId}/persona`))));
-    server.tool("create_agent_persona", "Create an agent's persona. Pass name, characterText and optional status.", {
+    server.tool("read_agent_persona", "Read an agent's persona: the character text every prompt of this agent " +
+        "opens with. It is the agent's `persona` field (also in `read_agent`), " +
+        "returned here with the agent's `version`, which `create_agent_persona` " +
+        "and `update_agent` take as `expectedVersion`. `persona` is null or `\"\"` " +
+        "when the agent has none (null: never set; `\"\"`: removed). Replaces " +
+        "`read_persona`, `read_persona_published`, `read_persona_version`, " +
+        "`list_persona_versions`, `list_deleted_persona_versions`, " +
+        "`list_personas` and `list_deleted_personas`: a persona has no id, " +
+        "versions or list of its own any more.", { agentId: z.string().describe("The agent's id.") }, async ({ agentId }) => guard(async () => {
+        const agent = (await client.get(`/api/v1/agents/${agentId}`));
+        return jsonResult({
+            agentId,
+            persona: agent.persona ?? null,
+            version: agent.version,
+        });
+    }));
+    server.tool("create_agent_persona", "Set an agent's persona: who the agent is, in its own words — the " +
+        "character text every prompt of this agent opens with. It writes the " +
+        "agent's `persona` field on its draft (the same as `update_agent` with " +
+        "`{ persona }`) and goes live with the agent (`request_publish_agent`). " +
+        "Setting it again replaces it. Read the agent first (`read_agent` or " +
+        "`read_agent_persona`) for `expectedVersion`; on a 409, re-read and retry. " +
+        "There is no separate name or status: a persona is only its text. To " +
+        "remove it, send `\"\"`; on update_agent `null` changes nothing. Replaces " +
+        "`update_persona`, `delete_persona`, `restore_persona`, " +
+        "`discard_persona_draft`, `create_persona_major_version`, " +
+        "`ensure_persona_major_version`, `name_persona_major_version`, " +
+        "`delete_persona_version`, `restore_persona_version`, " +
+        "`restore_deleted_persona_version` and `request_publish_persona`: the " +
+        "persona's history is the agent's versions, and it goes live with " +
+        "`request_publish_agent`.", {
         agentId: z.string().describe("The agent's id."),
-        fields: z
-            .record(z.unknown())
-            .describe('Persona fields, e.g. { "name": "…", "characterText": "…" }.'),
-    }, async ({ agentId, fields }) => guard(async () => jsonResult(await client.post(`/api/v1/agents/${agentId}/persona`, fields))));
-    // Reading/updating a persona by its OWN id (list_personas, read_persona,
-    // update_persona, delete_persona, restore_persona, …) is generated generically
-    // from the "persona" EntityDef in index.ts — identical PUT semantics to what
-    // used to be hand-written here. Only the agent-scoped create/read above are
-    // bespoke, because personas have no standalone create route.
+        expectedVersion: z
+            .number()
+            .int()
+            .describe("The agent's current `version`, from read_agent or read_agent_persona."),
+        persona: z.string().describe("The character text, as the agent should read it."),
+    }, async ({ agentId, expectedVersion, persona }) => guard(async () => jsonResult(await client.put(`/api/v1/agents/${agentId}`, { expectedVersion, persona }))));
 }
 /**
  * The shape `implementation` must have for a connector to run.
@@ -56,6 +91,11 @@ const CONNECTOR_SHAPE = "\n\nSHAPE OF `implementation` — `headers` and `queryP
  * file of the run, not parsed. Without this sentence the only mappings an agent
  * knew were the parsing ones.
  *
+ * `sha256` in the reference (axonity-flow#2299): the hash stored with the
+ * bytes, settled from storage where a reference enters a run, so a workflow
+ * can recognise a file it already processed. Which value counts is said here
+ * because a caller-written hash would silently skip a new document.
+ *
  * Kept short on purpose: the platform's live contract
  * (`get_entity_authoring_contract`, axonity-flow#2103) is the authority, and
  * this is guidance until every deploy serves it.
@@ -68,8 +108,20 @@ const CONNECTOR_EFFECT_AND_FILE = "\n\nDECLARE WHAT IT DOES — `implementation.
     "\n\nAN ANSWER THAT IS A FILE — `implementation.responseMapping: " +
     '{ "type": "file", "filename": "{{filename}}" }`. The bytes are kept as a ' +
     "file of the run and the connector returns its reference, `{ fileId, " +
-    "filename, contentType, sizeBytes }` — the shape an upload has, so Digitize " +
-    "documents reads it and a sub-workflow's file parameter takes it. " +
+    "filename, contentType, sizeBytes, sha256 }` — the shape an upload has, so " +
+    "Digitize documents reads it and a sub-workflow's file parameter takes it. " +
+    "`sha256` is the hex SHA-256 of the bytes, computed once when the file was " +
+    "stored; the same bytes have the same value under any name, so compare it " +
+    "to recognise a file that was already processed. Only a reference in a " +
+    "declared file parameter (`file`, or a list of `file`) is checked against " +
+    "storage: where one enters a run (a manual, API or MCP start, a " +
+    "sub-workflow call) its fields are settled from storage. A reference to a " +
+    "file the run may not read keeps what the caller wrote and carries no " +
+    "`sha256` — at a webhook, cron or conditional start, each of them. A " +
+    "reference anywhere else (an `object` field, an undeclared key) is not " +
+    "checked and keeps any `sha256` the caller wrote. Digitize documents " +
+    "always answers the stored `sha256` per file it read. So compare only the " +
+    "value on a declared file parameter or on Digitize's entry. " +
     "`filename` is optional and may use the inputs (`{{name}}`); without it the " +
     "far end's `Content-Disposition` name is used, else `document`. A file " +
     "answer takes no `responseTransform`. Outside a run (e.g. " +

package/dist/tools/extras.js.map

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

package/dist/tools/register.d.ts

@@ -54,6 +54,14 @@ export interface EntityDef {
     updateMethod: "PUT" | "PATCH";
     /** One-line human description of the entity, for the tool docs. */
     label: string;
+    /**
+     * The field names `create_<entity>`'s `fields` example shows. Default
+     * `["name", "description"]`. Set it where the create body lacks one of
+     * those — the agent body is strict, and an example key it does not know is a
+     * 422 for whoever copies it. A test holds every example to the create
+     * body's schema.
+     */
+    createExample?: string[];
     /**
      * Optional pre-write check on the caller's fields, applied to `create_*` and
      * `update_*`. Throws to reject. Used to run the connector credential guard on
@@ -62,7 +70,7 @@ export interface EntityDef {
     guardFields?: (fields: Record<string, unknown>) => void;
     /**
      * Whether `request_publish_<entity>` is generated. Default true, and true for
-     * every current entity: all ten (flow included) are valid `entityType`s for a
+     * every current entity (flow included): each is a valid `entityType` for a
      * publish approval on the backend (`ApprovalEntityType`). Set false only for a
      * future entity that genuinely cannot be publish-approved.
      */
@@ -73,7 +81,10 @@ export interface EntityDef {
      * rather than shipping `list_policys`.
      */
     plural?: string;
-    /** Whether `create_<entity>` is generated. Default true. False for `persona`, whose create is agent-scoped (`create_agent_persona`). */
+    /**
+     * Whether `create_<entity>` is generated. Default true. False for an entity
+     * created only through a parent, which then needs its own create tool.
+     */
     creatable?: boolean;
     /**
      * Whether `read_<entity>` is generated. Default true, and true for every
@@ -88,7 +99,7 @@ export interface EntityDef {
      * an entity with no lifecycle routes. The two spellings are a real backend
      * inconsistency, not a typo: `expectedVersion` (workflow, agent, tool,
      * prompt_snippet, flow) vs `expected_version` (skill, policy, reference_doc,
-     * output_schema, persona).
+     * output_schema).
      */
     deleteVersionParam?: "expectedVersion" | "expected_version";
     /**

package/dist/tools/register.js

@@ -103,7 +103,9 @@ export function registerEntityTools(server, client, def) {
             fields: z
                 .record(z.unknown())
                 .describe(`The ${singular}'s fields as a JSON object (camelCase keys), e.g. ` +
-                `{ "name": "…", "description": "…" }.`),
+                `{ ${(def.createExample ?? ["name", "description"])
+                    .map((k) => `"${k}": "…"`)
+                    .join(", ")} }.`),
         }, async ({ fields }) => guard(async () => {
             guardFields?.(fields);
             return jsonResult(await client.post(basePath, fields));

package/dist/tools/register.js.map

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

package/dist/tools/runs.js

@@ -51,8 +51,9 @@ export function registerRunTools(server, client) {
         "triggerId that does not exist is a 422 listing the ones that do, never a " +
         "quiet fallback to a different start. " +
         "\n\nA run may PARK on a step that asks a question instead of finishing. " +
-        "read_run_waiting_on says what it is parked on; answer_run_question and " +
-        "send_run_message are how it moves again. " +
+        "list_todo_steps lists the step it waits on (each item carries its runId " +
+        "and stepId); answer_run_question and send_run_message are how it moves " +
+        "again. " +
         "\n\nA chat with the Dashboard Analyst is not a workflow run: start one " +
         "with start_conversation.", {
         workflowId: z.string().describe("The workflow's id."),
@@ -91,7 +92,8 @@ export function registerRunTools(server, client) {
         return jsonResult({ deleted: true, runId });
     }));
     server.tool("list_runs", "List workflow runs across the tenant, newest first. Archived runs are " +
-        "excluded unless includeArchived is true. To list runs of ONE workflow, " +
+        "excluded unless includeArchived is true, and the platform's own work " +
+        "(labelled `isPlatform`) unless includePlatform is true. To list runs of ONE workflow, " +
         "use list_workflow_runs instead — this route has no workflow filter." +
         "\n\nTHE RESPONSE IS ONE PAGE, NOT THE FULL LIST: " +
         "{ items, nextCursor, pageSize, hasMore }. Default page size is 20, max " +
@@ -104,8 +106,10 @@ export function registerRunTools(server, client) {
         "is a cursor and not an offset: an offset window under that rate skips " +
         "and repeats rows between pages. Never build a cursor — echo back the " +
         "one you were given. " +
-        "\n\nUnlike list_workflow_runs, this route does list per-item FOR EACH " +
-        "runs alongside their launches. " +
+        "\n\nLike list_workflow_runs, the per-item runs of a FOR EACH are NOT here: " +
+        "a launch over 4,415 items is ONE row. The item results live inside their " +
+        "launch — list_run_items for the rows, read_run_for_each_progress for the " +
+        "counts. " +
         "\n\nCONVERSATIONS ARE NOT HERE. A chat about a dashboard with the " +
         "Dashboard Analyst is a run of kind `conversation`; this tool asks the " +
         "route for workflow runs only. list_conversations lists the chats — " +
@@ -118,6 +122,12 @@ export function registerRunTools(server, client) {
         createdAfter: z.string().optional().describe("ISO date lower bound."),
         createdBefore: z.string().optional().describe("ISO date upper bound."),
         includeArchived: z.boolean().optional().describe("Defaults to false."),
+        includePlatform: z
+            .boolean()
+            .optional()
+            .describe("Also the platform's own work (Maintain knowledge, Learn from a run), " +
+            "each row labelled `isPlatform`. Defaults to false: left out, those " +
+            "runs are not in the list."),
         limit: z
             .number()
             .int()
@@ -129,11 +139,12 @@ export function registerRunTools(server, client) {
             .optional()
             .describe("Opaque continuation cursor from the previous response's nextCursor. " +
             "Omit for the first page. Do not parse or construct one."),
-    }, async ({ status, createdAfter, createdBefore, includeArchived, limit, cursor }) => guard(async () => jsonResult(await client.get("/api/v1/runs", {
+    }, async ({ status, createdAfter, createdBefore, includeArchived, includePlatform, limit, cursor }) => guard(async () => jsonResult(await client.get("/api/v1/runs", {
         status,
         created_after: createdAfter,
         created_before: createdBefore,
         include_archived: includeArchived,
+        include_platform: includePlatform,
         limit,
         cursor,
     }))));
@@ -226,9 +237,34 @@ export function registerRunTools(server, client) {
     }, async ({ runId, includeSnapshot }) => guard(async () => jsonResult(await client.get(`/api/v1/runs/${runId}`, {
         includeSnapshot: includeSnapshot === true,
     }))));
-    server.tool("list_todo_steps", "The steps across the TENANT that are waiting on a human — every parked " +
-        "run, whatever it is parked on. This is the list you read to answer 'is " +
-        "anything stuck on me?' without knowing which run to look at. " +
+    server.tool("list_todo_steps", "The steps across the TENANT that are waiting on a person — one item per " +
+        "step. This is the list you read to answer 'is anything stuck on me?' " +
+        "without knowing which run to look at. " +
+        "\n\nWHAT IS AN ITEM: a step of a run that is `waiting` or " +
+        "`input_required`, not archived and not a conversation, that waits for " +
+        "one of four things (`todoType`): `ask_user` — an agent asked a question " +
+        "that is not answered; `plan_approval` — a plan waits for a decision; " +
+        "`manual_step` or `decision` — the step type says a person does it. NOT " +
+        "items: a debug pause (`phase_control`) or any other step without one of " +
+        "those reasons, and a question already answered whose run has not " +
+        "resumed yet (the answer is on its way). A conversation waits for its " +
+        "person in the chat, not here. " +
+        "\n\nWHOSE IT IS: each item belongs to one agent or to none (`agentId`). " +
+        "A question or a plan belongs to the agent that asked (the agent of the " +
+        "step's latest orchestrator call; with none on record, the workflow's " +
+        "owner). A manual step or a decision belongs to the workflow's owner " +
+        "(none when the workflow has no live owner or is deleted). None for the " +
+        "budget question the platform itself asked under the old budget rule " +
+        "(marked `budget_pause` in the question's state), and for every step of " +
+        "a run the run history hides (a hidden platform workflow). Pass " +
+        "`agentId` for that agent's items only — the items its \"Needs you\" " +
+        "counts; an agent of another workspace has none. Without it the list " +
+        "shows every item, those on no agent included. " +
+        "\n\nEach item also carries `askedAt` (when the agent asked; null for an " +
+        "item that is not a question) and `groupKey`: equal for literally equal " +
+        "questions — same workflow, same step, question text equal character " +
+        "for character — so they can be shown once. Each is still answered on " +
+        "its own run. Null for an item without a question. " +
         "\n\nTHE RESPONSE IS ONE PAGE, NOT THE FULL LIST: " +
         "{ items, nextCursor, pageSize, hasMore }. While hasMore is true you have " +
         "NOT seen every waiting step — pass the response's nextCursor back as " +
@@ -237,9 +273,13 @@ export function registerRunTools(server, client) {
         "one run can carry several waiting steps, so `items` may be LONGER than " +
         "pageSize. That is not a bug and not an overflow — pageSize bounds what " +
         "was read, not what came back. A fan-out can park thousands of items on " +
-        "one manual step at once, which is why this list is paged at all. " +
-        "\n\nread_run_waiting_on answers the same question for a run you already " +
-        "have in your hand.", {
+        "one manual step at once, which is why this list is paged at all. Without " +
+        "agentId a run read may hold no item, so a page can also be shorter than " +
+        "pageSize, even empty, while hasMore is true; with agentId only the runs " +
+        "holding an item of that agent are walked. " +
+        "\n\nread_run_waiting_on is a different read: the pending wake-tasks of " +
+        "one run you already have (a timer; an answer, a chat message or a " +
+        "callback's result on its way). An open question has no wake-task.", {
         limit: z
             .number()
             .int()
@@ -250,7 +290,12 @@ export function registerRunTools(server, client) {
             .optional()
             .describe("Opaque continuation cursor from the previous response's nextCursor. " +
             "Omit for the first page. Do not parse or construct one."),
-    }, async ({ limit, cursor }) => guard(async () => jsonResult(await client.get("/api/v1/runs/todo", { limit, cursor }))));
+        agentId: z
+            .string()
+            .optional()
+            .describe("An agent's id (a UUID): only the items that belong to that agent. " +
+            "Omit for every item in the tenant."),
+    }, async ({ limit, cursor, agentId }) => guard(async () => jsonResult(await client.get("/api/v1/runs/todo", { limit, cursor, agentId }))));
     server.tool("list_run_session_memory", "List the files an agent wrote to SESSION MEMORY during a run — title, " +
         "kind, tags, size and timestamp for each. Bodies are not included; fetch " +
         "one with read_run_session_memory_file. " +
@@ -362,11 +407,21 @@ export function registerRunTools(server, client) {
     // ---- Why a run is parked, and what it did ------------------------------
     server.tool("read_run_waiting_on", "Why a run is PARKED. A run in `waiting` or `input_required` is not stuck " +
         "and not slow — it is holding for something, and this lists every pending " +
-        "wake-task targeting it: a question asked of a person, a timer, a callback " +
-        "that has not arrived. Read this before concluding a test run failed. " +
+        "wake-task targeting it: a timer, or an answer, a chat message or a " +
+        "callback's result on its way (a callback row appears only once the work " +
+        "behind it has finished). Read this before concluding a test run failed. " +
+        "\n\nA step that waits on a PERSON — an open question, a plan, a manual or " +
+        "a decision step — has NO wake-task and is not here: a question's wake-task " +
+        "is planted only once someone answers it. Those steps are on " +
+        "list_todo_steps (with their runId and stepId), and in read_run as a step " +
+        "whose status is `waiting_for_input` and whose `waitReason` says why. " +
+        "\n\nA run waiting on a FOR EACH batch, or on a callback whose work is " +
+        "still running, has no wake-task here either: the batch waits as a marker " +
+        "on its step (watch it with read_run_for_each_progress), and the running " +
+        "work is a task in list_run_tasks. " +
         "\n\nAn EMPTY list is a real answer, not an error: the run may have every " +
-        "wake already resolved and be about to resume. " +
-        "\n\nWhen the answer is a question, answer_run_question is what unparks it.", {
+        "wake already resolved and be about to resume, or it waits on something " +
+        "with no wake-task — a person, a FOR EACH batch, a callback still running.", {
         runId: z.string().describe("The run's id."),
         limit: z.number().int().optional().describe("How many to return. Default 50."),
     }, async ({ runId, limit }) => guard(async () => jsonResult(await client.get(`/api/v1/runs/${runId}/waiting-on`, { limit }))));
@@ -419,13 +474,13 @@ export function registerRunTools(server, client) {
     server.tool("answer_run_question", "Answer an `ask_user` step a run is parked on, so the run resumes. This is " +
         "what makes \"start a run and see what it does\" finishable: without it a " +
         "workflow that asks anything waits forever and a test never returns a " +
-        "verdict. Find the parked step with read_run_waiting_on or read_run. " +
+        "verdict. Find the parked step with list_todo_steps or read_run. " +
         "\n\nThe answer is recorded as the ANSWER A PERSON WOULD HAVE GIVEN and " +
         "the run proceeds on it. On a run a human is depending on, that is their " +
         "decision to make, not yours — answer your own test runs, and ask before " +
         "answering someone else's. Returns the run's updated detail.", {
         runId: z.string().describe("The run's id."),
-        stepId: z.string().describe("The suspended step's id, from read_run_waiting_on."),
+        stepId: z.string().describe("The suspended step's id, from list_todo_steps or read_run."),
         answer: z.string().describe("The answer text the step is waiting for."),
     }, async ({ runId, stepId, answer }) => guard(async () => jsonResult(await client.post(`/api/v1/runs/${runId}/steps/${stepId}/answer`, { answer }))));
     server.tool("complete_run_step", "Complete a MANUAL or DECISION step a run is parked on, so the run " +
@@ -440,12 +495,12 @@ export function registerRunTools(server, client) {
         "it. Only do this when a person has told you the work is done, or on a " +
         "test run of your own where nothing real depended on the step. Never to " +
         "get a stuck run moving. " +
-        "\n\nFind the parked step with read_run_waiting_on. Returns the run's " +
+        "\n\nFind the parked step with list_todo_steps or read_run. Returns the run's " +
         "updated detail. Deciding a PLAN APPROVAL is a different thing again and " +
         "is deliberately not available here — that step exists to get a human's " +
         "review, and an agent approving it would often be approving its own plan.", {
         runId: z.string().describe("The run's id."),
-        stepId: z.string().describe("The parked step's id, from read_run_waiting_on."),
+        stepId: z.string().describe("The parked step's id, from list_todo_steps or read_run."),
         selectedBranch: z
             .string()
             .optional()
@@ -486,11 +541,13 @@ export function registerRunTools(server, client) {
     // A chat about a dashboard is a run of kind `conversation` with no workflow;
     // list_runs asks for kind=workflow only. Two backend routes list these chats
     // and neither does everything, so list_conversations picks one per call:
-    //   - GET /conversations?dashboardId= — one dashboard; no other filter.
+    //   - GET /conversations?dashboardId= — one dashboard, with status,
+    //     createdAfter/createdBefore and q (axonity-flow#2331); no archive filter.
     //   - GET /runs?kind=conversation — every dashboard the person can see, with
-    //     status, created_after/created_before and include_archived in the query.
-    // No route combines a dashboard with those filters, so asking for both is a
-    // local refusal rather than a quiet drop of one of them. Both routes return
+    //     status, created_after/created_before and include_archived; no text filter.
+    // What one route has and the other has not (includeArchived with a
+    // dashboard, q without one) is a local refusal rather than a quiet drop.
+    // Both routes return
     // only the token holder's own dashboard chats; the Builder chat never
     // appears (test/denyList.ts says why it stays out).
     server.tool("list_conversations", "List conversations with the Dashboard Analyst, newest first. Use it to " +
@@ -500,21 +557,22 @@ export function registerRunTools(server, client) {
         "\n\nTWO WAYS TO ASK, because the backend has two lists and neither " +
         "does both: " +
         "\n- With `dashboardId`: the chats about that one dashboard — the history " +
-        "its chat window shows. No other filter applies here; archived chats are " +
-        "left out. " +
+        "its chat window shows — filtered by `status`, `createdAfter`/`createdBefore` " +
+        "and `q` (text in the opening question) before the page is cut " +
+        "(axonity-flow#2331). Archived chats are left out. A value this list " +
+        "cannot read is a 422 with the reason. " +
         "\n- Without `dashboardId`: the chats about EVERY dashboard the person can " +
         "still see, filtered by `status`, `createdAfter`/`createdBefore` and " +
         "`includeArchived` in the database before the page is cut — so \"which " +
         "chats failed last week?\" is one page, not a walk. " +
-        "\nPassing `dashboardId` together with status, a date or includeArchived " +
-        "is refused here rather than half-applied: no backend route filters a " +
-        "dashboard's chats that way. Filter without the dashboard and keep the " +
-        "rows whose `dashboardId` matches, walking every page. " +
-        "\n\nWHAT CANNOT BE FILTERED AT ALL: who opened the chat, and the text of " +
-        "the question. Both lists return only the chats opened by the person " +
-        "this connector's token belongs to (who minted it) — a colleague's chat " +
-        "in the app is never listed. To find a question, read `question` on " +
-        "every row across all pages. " +
+        "\nWhat one list has and the other has not is refused here rather than " +
+        "half-applied: `includeArchived` with `dashboardId`, and `q` without it. " +
+        "The two lists read a bare `createdBefore` date differently; see that " +
+        "argument. " +
+        "\n\nWHAT CANNOT BE FILTERED AT ALL: who opened the chat. Both lists " +
+        "return only the chats opened by the person this connector's token " +
+        "belongs to (who minted it) — a colleague's chat in the app is never " +
+        "listed. " +
         "\n\nEach row: `id` (the run id), `question` (the opening question, null " +
         "when the chat was opened without one), `dashboardId`, `status`, " +
         "`createdAt`/`startedAt`/`completedAt`, `createdByName`. The tile a " +
@@ -533,7 +591,7 @@ export function registerRunTools(server, client) {
             .min(1)
             .optional()
             .describe("Only the chats about this dashboard, from list_dashboards. Cannot be " +
-            "combined with status, createdAfter, createdBefore or includeArchived."),
+            "combined with includeArchived."),
         status: z
             .string()
             .optional()
@@ -541,25 +599,36 @@ export function registerRunTools(server, client) {
             "A conversation's own statuses: `idle` = answered, waiting for the " +
             "next question (NOT `completed`: an answered chat never reaches it); " +
             "`running` = the analyst is working on a turn; `failed`; " +
-            "`completed` only once a chat was ended. An unknown status is not " +
-            "refused — it just matches nothing, so an empty page may mean a " +
-            "misspelt status. Without dashboardId only. Omit for all."),
+            "`completed` only once a chat was ended. Without dashboardId an " +
+            "unknown status is not refused — it just matches nothing, so an " +
+            "empty page may mean a misspelt status; with dashboardId it is a " +
+            "422. Omit for all."),
         createdAfter: z
             .string()
             .optional()
             .describe("ISO date or datetime lower bound on when the chat started (a bare " +
             "date is midnight at its start, so that day is included), e.g. " +
-            '"2026-11-01". Without dashboardId only. A value the backend cannot ' +
+            '"2026-11-01". Without dashboardId, a value the backend cannot ' +
             "parse is IGNORED, not refused — the list then comes back unfiltered " +
-            "by it, so send a plain ISO date."),
+            "by it, so send a plain ISO date. With dashboardId it is a 422, and " +
+            "a date-time without an offset is read as UTC."),
         createdBefore: z
             .string()
             .optional()
-            .describe("ISO date or datetime upper bound, inclusive of that MOMENT. A bare " +
+            .describe("ISO date or datetime upper bound, inclusive of that MOMENT. The two " +
+            "lists read a bare date differently. Without dashboardId a bare " +
             'date means midnight at its start, so "2026-11-03" EXCLUDES the ' +
             'chats of 3 November itself: for "up to and including 3 November" ' +
-            'send "2026-11-04" or "2026-11-03T23:59:59". Without dashboardId ' +
-            "only. Same caution: an unparseable value is silently ignored."),
+            'send "2026-11-04" or "2026-11-03T23:59:59"; an unparseable value is ' +
+            "silently ignored. With dashboardId a bare date means the END of that " +
+            "day, so createdAfter = createdBefore = one date is that day's chats; " +
+            "an unparseable value is a 422. A date-time is exact on both."),
+        q: z
+            .string()
+            .optional()
+            .describe("With dashboardId only: the chats whose opening question contains this " +
+            "text, ignoring case and the spaces around it. Taken literally: % and " +
+            "_ match themselves."),
         includeArchived: z
             .boolean()
             .optional()
@@ -575,25 +644,30 @@ export function registerRunTools(server, client) {
             .optional()
             .describe("Opaque continuation cursor from the previous response's nextCursor. " +
             "Omit for the first page. Do not parse or construct one."),
-    }, async ({ dashboardId, status, createdAfter, createdBefore, includeArchived, limit, cursor }) => guard(async () => {
+    }, async ({ dashboardId, status, createdAfter, createdBefore, q, includeArchived, limit, cursor }) => guard(async () => {
         // The page envelope is forwarded WHOLE on both routes, as list_runs
         // does (#37).
         if (dashboardId !== undefined) {
-            const unsupported = Object.entries({
+            if (includeArchived !== undefined) {
+                throw new Error("list_conversations: includeArchived cannot be combined with " +
+                    "dashboardId — the backend's per-dashboard list leaves archived " +
+                    "chats out and has no such filter. Leave dashboardId out to " +
+                    "include them, and keep the rows whose dashboardId matches.");
+            }
+            return jsonResult(await client.get("/api/v1/conversations", {
+                dashboardId,
                 status,
                 createdAfter,
                 createdBefore,
-                includeArchived,
-            })
-                .filter(([, value]) => value !== undefined)
-                .map(([name]) => name);
-            if (unsupported.length > 0) {
-                throw new Error(`list_conversations: ${unsupported.join(", ")} cannot be combined ` +
-                    "with dashboardId — the backend's per-dashboard list has no such " +
-                    "filter. Leave dashboardId out to filter across every dashboard, " +
-                    "and keep the rows whose dashboardId matches.");
-            }
-            return jsonResult(await client.get("/api/v1/conversations", { dashboardId, limit, cursor }));
+                q,
+                limit,
+                cursor,
+            }));
+        }
+        if (q !== undefined) {
+            throw new Error("list_conversations: `q` needs dashboardId — only the per-dashboard " +
+                "list filters on the question's text. Without a dashboard, read " +
+                "`question` on every row across all pages.");
         }
         return jsonResult(await client.get("/api/v1/runs", {
             kind: "conversation",