@axonity-ai/mcp 0.1.0 → 0.2.2

package/dist/tools/extras.js

@@ -1,20 +1,17 @@
 /**
- * Secondary MCP tools (epic #652 C5): personas (agent-scoped), connectors
- * (a tool subtype), and attaching memory to a target.
+ * 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.
  *
  * These use routes with shapes that don't fit the generic entity registrar:
- * personas are 1:1 with an agent (no standalone list), connectors are a tool
- * with `type: "connector"` and MUST NOT carry real credentials, and attach is a
- * path-only link.
+ * a persona is created only through 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 { guard, jsonResult } from "./result.js";
-/** A value is a safe placeholder if it's empty or a `{{ … }}` template. */
-function isPlaceholder(value) {
-    if (value === "" || value === null || value === undefined)
-        return true;
-    return typeof value === "string" && /^\s*\{\{.*\}\}\s*$/.test(value);
-}
 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`))));
@@ -24,34 +21,20 @@ export function registerPersonaTools(server, client) {
             .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))));
-    server.tool("update_persona", "Update a persona by its id (read the agent's persona first for its version).", {
-        personaId: z.string().describe("The persona's id."),
-        expectedVersion: z
-            .number()
-            .int()
-            .describe("The version you last read — 409 if stale."),
-        fields: z.record(z.unknown()).describe("The fields to change (camelCase)."),
-    }, async ({ personaId, expectedVersion, fields }) => guard(async () => jsonResult(await client.put(`/api/v1/personas/${personaId}`, {
-        expectedVersion,
-        ...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.
 }
 export function registerConnectorTools(server, client) {
-    const authGuard = (fields) => {
-        const authConfig = fields.authConfig;
-        if (authConfig && !Object.values(authConfig).every(isPlaceholder)) {
-            throw new Error("authConfig must contain only placeholders (empty or {{ … }}). Never put " +
-                "real credentials in a connector — a human fills secrets in the Axonity " +
-                "tool editor.");
-        }
-    };
     server.tool("create_connector", "Create a connector draft (a tool of type 'connector'). Do NOT put real " +
         "credentials in authConfig — use placeholders; a human fills secrets in Axonity.", {
         fields: z
             .record(z.unknown())
             .describe("Connector fields (name, description, implementation, authConfig)."),
     }, async ({ fields }) => guard(async () => {
-        authGuard(fields);
+        assertPlaceholderCredentials(fields);
         return jsonResult(await client.post("/api/v1/tools", { type: "connector", ...fields }));
     }));
     server.tool("update_connector", "Update a connector draft (a tool of type 'connector'). Read it first for its " +
@@ -60,7 +43,7 @@ export function registerConnectorTools(server, client) {
         expectedVersion: z.number().int().describe("Version last read — 409 if stale."),
         fields: z.record(z.unknown()).describe("Fields to change (camelCase)."),
     }, async ({ id, expectedVersion, fields }) => guard(async () => {
-        authGuard(fields);
+        assertPlaceholderCredentials(fields);
         return jsonResult(await client.put(`/api/v1/tools/${id}`, {
             expectedVersion,
             type: "connector",
@@ -69,13 +52,47 @@ export function registerConnectorTools(server, client) {
     }));
 }
 export function registerAttachTools(server, client) {
-    const attach = (name, description, path, firstArg, secondArg) => server.tool(name, description, {
-        [firstArg]: z.string(),
-        [secondArg]: z.string(),
-    }, async (args) => guard(async () => jsonResult(await client.post(path(args[firstArg], args[secondArg])))));
-    attach("attach_skill_to_agent", "Scope a skill to an agent so the agent uses it.", (agentId, skillId) => `/api/v1/agents/${agentId}/skills-v2/${skillId}`, "agentId", "skillId");
-    attach("attach_skill_to_workflow", "Scope a skill to a workflow.", (workflowId, skillId) => `/api/v1/workflows/${workflowId}/skills-v2/${skillId}`, "workflowId", "skillId");
-    attach("attach_policy_to_agent", "Scope a policy to an agent.", (agentId, policyId) => `/api/v1/agents/${agentId}/policies/${policyId}`, "agentId", "policyId");
-    attach("attach_reference_to_agent", "Scope a reference doc to an agent.", (agentId, refId) => `/api/v1/agents/${agentId}/reference-docs/${refId}`, "agentId", "refId");
+    /**
+     * Attach and detach are the same path with POST vs DELETE, so both verbs are
+     * generated from one definition — that is what keeps them from drifting apart
+     * again (only attach existed before, so nothing could be unwired).
+     */
+    const link = (subject, target, path, firstArg, secondArg) => {
+        const shape = { [firstArg]: z.string(), [secondArg]: z.string() };
+        server.tool(`attach_${subject}_to_${target}`, `Scope a ${subject.replace("_", " ")} to a ${target} so the ${target} uses it.`, shape, async (args) => guard(async () => jsonResult(await client.post(path(args[firstArg], args[secondArg])))));
+        server.tool(`detach_${subject}_from_${target}`, `Unscope a ${subject.replace("_", " ")} from a ${target}. This only ` +
+            `removes the link — the ${subject.replace("_", " ")} itself is not deleted ` +
+            `and stays available to attach elsewhere.`, shape, async (args) => guard(async () => {
+            await client.del(path(args[firstArg], args[secondArg]));
+            return jsonResult({
+                detached: true,
+                [firstArg]: args[firstArg],
+                [secondArg]: args[secondArg],
+            });
+        }));
+    };
+    link("skill", "agent", (agentId, skillId) => `/api/v1/agents/${agentId}/skills-v2/${skillId}`, "agentId", "skillId");
+    link("skill", "workflow", (workflowId, skillId) => `/api/v1/workflows/${workflowId}/skills-v2/${skillId}`, "workflowId", "skillId");
+    link("policy", "agent", (agentId, policyId) => `/api/v1/agents/${agentId}/policies/${policyId}`, "agentId", "policyId");
+    // Reference docs attach to agents only — there is no workflow-scoped
+    // reference-doc route on the backend, so no `*_to_workflow` pair here.
+    link("reference", "agent", (agentId, refId) => `/api/v1/agents/${agentId}/reference-docs/${refId}`, "agentId", "refId");
+}
+/**
+ * Small standalone tools that don't fit any of the other groupings: the
+ * system-tools catalog (read-only — there is no grant/revoke route; enabling
+ * one for an agent means writing `systemToolIds` via `update_agent`), and
+ * cloning a flow/prompt-snippet into a tenant-owned copy.
+ */
+export function registerCatalogTools(server, client) {
+    server.tool("list_system_tools", "List the tenant's system-tool catalog (id, label, description, category). " +
+        "There is no grant/revoke tool — enable one for an agent by adding its id " +
+        "to `systemToolIds` via update_agent.", {}, async () => guard(async () => jsonResult(await client.get("/api/v1/system-tools"))));
+    server.tool("clone_flow", "Fork a flow into a new, independent, tenant-owned copy — including a " +
+        "framework-provided one. Prefer this over editing a framework flow " +
+        "directly: it is visible and NOT actually protected from update_flow/ " +
+        "delete_flow (a backend gap, despite what its docstrings claim), so " +
+        "editing one in place risks changing something other tenants share.", { flowId: z.string().describe("The flow's id.") }, async ({ flowId }) => guard(async () => jsonResult(await client.post(`/api/v1/flows/${flowId}/clone`))));
+    server.tool("clone_prompt_snippet", "Duplicate a prompt snippet into a new, independent copy.", { snippetId: z.string().describe("The prompt snippet's id.") }, async ({ snippetId }) => guard(async () => jsonResult(await client.post(`/api/v1/prompt-snippets/${snippetId}/clone`))));
 }
 //# sourceMappingURL=extras.js.map

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

@@ -1,19 +1,25 @@
 /**
- * Registers the read/draft/update MCP tools for one Axonity entity type.
+ * Registers the read/draft/update/lifecycle MCP tools for one Axonity entity type.
  *
- * Every entity (workflow, agent, tool) gets the same verbs the internal
- * Builder team has, minus direct publish:
- *   list_<entity>   — GET  /api/v1/<entity>s
- *   read_<entity>   — GET  /api/v1/<entity>s/{id}
- *   create_<entity> — POST /api/v1/<entity>s              (a new draft)
- *   update_<entity> — PUT|PATCH /api/v1/<entity>s/{id}    (read-then-write)
+ * Every entity gets the same verbs the internal Builder team has, minus direct
+ * publish:
+ *   list_<plural>     — GET    <basePath>
+ *   read_<entity>     — GET    <basePath>/{id}
+ *   create_<entity>   — POST   <basePath>              (a new draft)
+ *   update_<entity>   — PUT|PATCH <basePath>/{id}       (read-then-write)
+ *   delete_<entity>   — DELETE <basePath>/{id}          (soft-delete, recoverable)
+ *   restore_<entity>  — POST   <basePath>/{id}/restore  (undo a delete)
+ *   list_deleted_<plural> — restore candidates
+ *   discard_<entity>_draft — reset the draft to the last published state
  *
  * The connector stays thin: entity fields pass through as JSON and the backend
- * validates them (422 surfaces the field detail). Updates carry `expectedVersion`
- * so a stale write 409s rather than clobbering — the agent re-reads and retries.
+ * validates them (a structured error names the offending field — see errors.ts).
+ * Updates carry `expectedVersion` in the body so a stale write 409s rather than
+ * clobbering. Deletes carry it as a QUERY param instead, and the key's spelling
+ * is not uniform across entities (`deleteVersionParam` on `EntityDef` says which).
  *
  * `request_publish_*` never publishes — it creates a pending approval a human
- * decides in Axonity (epic #652 C3).
+ * decides in Axonity.
  */
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { AxonityClient } from "../client.js";
@@ -26,5 +32,48 @@ export interface EntityDef {
     updateMethod: "PUT" | "PATCH";
     /** One-line human description of the entity, for the tool docs. */
     label: 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
+     * plain tool writes, which would otherwise bypass it.
+     */
+    guardFields?: (fields: Record<string, unknown>) => void;
+    /**
+     * Whether this entity can be published. Default true. `flow` has no publish
+     * route and is not a valid `entityType` for a publish approval, so generating
+     * this tool is suppressed there.
+     */
+    publishable?: boolean;
+    /**
+     * The plural noun for `list_<plural>` / `list_deleted_<plural>`. Defaults to
+     * `${singular}s`, which is wrong for at least "policy" — set it explicitly
+     * 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`). */
+    creatable?: boolean;
+    /** Whether `read_<entity>` is generated. Default true. False for `prompt_snippet`, which has no single-read route. */
+    readable?: boolean;
+    /**
+     * The query-string key DELETE expects for the optimistic lock. Its presence
+     * is what turns on `delete_/restore_/list_deleted_/discard_*` — omit it for
+     * 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).
+     */
+    deleteVersionParam?: "expectedVersion" | "expected_version";
+    /**
+     * Whether `discard_<entity>_draft` is generated. Default true when the
+     * entity is deletable. False for `flow` and `prompt_snippet`, neither of
+     * which has a discard-draft route.
+     */
+    hasDiscardDraft?: boolean;
+    /**
+     * How to list soft-deleted rows. `"collection"` (default) is `GET
+     * <basePath>/deleted`, used by every entity except `prompt_snippet`, which
+     * instead takes `?deleted=true` on the main list route (`"query"`).
+     */
+    deletedListPath?: "collection" | "query";
 }
 export declare function registerEntityTools(server: McpServer, client: AxonityClient, def: EntityDef): void;

package/dist/tools/register.js

@@ -1,35 +1,56 @@
 /**
- * Registers the read/draft/update MCP tools for one Axonity entity type.
+ * Registers the read/draft/update/lifecycle MCP tools for one Axonity entity type.
  *
- * Every entity (workflow, agent, tool) gets the same verbs the internal
- * Builder team has, minus direct publish:
- *   list_<entity>   — GET  /api/v1/<entity>s
- *   read_<entity>   — GET  /api/v1/<entity>s/{id}
- *   create_<entity> — POST /api/v1/<entity>s              (a new draft)
- *   update_<entity> — PUT|PATCH /api/v1/<entity>s/{id}    (read-then-write)
+ * Every entity gets the same verbs the internal Builder team has, minus direct
+ * publish:
+ *   list_<plural>     — GET    <basePath>
+ *   read_<entity>     — GET    <basePath>/{id}
+ *   create_<entity>   — POST   <basePath>              (a new draft)
+ *   update_<entity>   — PUT|PATCH <basePath>/{id}       (read-then-write)
+ *   delete_<entity>   — DELETE <basePath>/{id}          (soft-delete, recoverable)
+ *   restore_<entity>  — POST   <basePath>/{id}/restore  (undo a delete)
+ *   list_deleted_<plural> — restore candidates
+ *   discard_<entity>_draft — reset the draft to the last published state
  *
  * The connector stays thin: entity fields pass through as JSON and the backend
- * validates them (422 surfaces the field detail). Updates carry `expectedVersion`
- * so a stale write 409s rather than clobbering — the agent re-reads and retries.
+ * validates them (a structured error names the offending field — see errors.ts).
+ * Updates carry `expectedVersion` in the body so a stale write 409s rather than
+ * clobbering. Deletes carry it as a QUERY param instead, and the key's spelling
+ * is not uniform across entities (`deleteVersionParam` on `EntityDef` says which).
  *
  * `request_publish_*` never publishes — it creates a pending approval a human
- * decides in Axonity (epic #652 C3).
+ * decides in Axonity.
  */
 import { z } from "zod";
 import { guard, jsonResult } from "./result.js";
+/** A required literal — an agent cannot satisfy it by filling in a default. */
+const CONFIRM = z
+    .literal(true)
+    .describe("Must be true. Acknowledges you understand this is destructive.");
 export function registerEntityTools(server, client, def) {
-    const { singular, basePath, updateMethod, label } = def;
-    server.tool(`list_${singular}s`, `List all ${label} in your Axonity tenant (id, name, status, version).`, {}, async () => guard(async () => jsonResult(await client.get(basePath))));
-    server.tool(`read_${singular}`, `Read one ${singular} by id, including its current draft and version. ` +
-        `Read before you update — you need the current version.`, { id: z.string().describe(`The ${singular}'s id.`) }, async ({ id }) => guard(async () => jsonResult(await client.get(`${basePath}/${id}`))));
-    server.tool(`create_${singular}`, `Create a new ${singular} draft. Pass the entity's fields (camelCase) in ` +
-        `\`fields\`; the backend validates them. Returns the created ${singular} ` +
-        `with its id and version.`, {
-        fields: z
-            .record(z.unknown())
-            .describe(`The ${singular}'s fields as a JSON object (camelCase keys), e.g. ` +
-            `{ "name": "…", "description": "…" }.`),
-    }, async ({ fields }) => guard(async () => jsonResult(await client.post(basePath, fields))));
+    const { singular, basePath, updateMethod, label, guardFields } = def;
+    const plural = def.plural ?? `${singular}s`;
+    const publishable = def.publishable !== false;
+    const creatable = def.creatable !== false;
+    const readable = def.readable !== false;
+    server.tool(`list_${plural}`, `List all ${label} in your Axonity tenant (id, name, status, version).`, {}, async () => guard(async () => jsonResult(await client.get(basePath))));
+    if (readable) {
+        server.tool(`read_${singular}`, `Read one ${singular} by id, including its current draft and version. ` +
+            `Read before you update — you need the current version.`, { id: z.string().describe(`The ${singular}'s id.`) }, async ({ id }) => guard(async () => jsonResult(await client.get(`${basePath}/${id}`))));
+    }
+    if (creatable) {
+        server.tool(`create_${singular}`, `Create a new ${singular} draft. Pass the entity's fields (camelCase) in ` +
+            `\`fields\`; the backend validates them. Returns the created ${singular} ` +
+            `with its id and version.`, {
+            fields: z
+                .record(z.unknown())
+                .describe(`The ${singular}'s fields as a JSON object (camelCase keys), e.g. ` +
+                `{ "name": "…", "description": "…" }.`),
+        }, async ({ fields }) => guard(async () => {
+            guardFields?.(fields);
+            return jsonResult(await client.post(basePath, fields));
+        }));
+    }
     server.tool(`update_${singular}`, `Update a ${singular} draft. Read it first to get \`expectedVersion\`; on a ` +
         `409 conflict, read again and retry. Pass only the fields you are ` +
         `changing (camelCase) in \`fields\`.`, {
@@ -42,6 +63,7 @@ export function registerEntityTools(server, client, def) {
             .record(z.unknown())
             .describe(`The fields to change, as a JSON object (camelCase keys).`),
     }, async ({ id, expectedVersion, fields }) => guard(async () => {
+        guardFields?.(fields);
         const body = { expectedVersion, ...fields };
         const path = `${basePath}/${id}`;
         const data = updateMethod === "PUT"
@@ -49,6 +71,39 @@ export function registerEntityTools(server, client, def) {
             : await client.patch(path, body);
         return jsonResult(data);
     }));
+    if (def.deleteVersionParam) {
+        const deleteVersionParam = def.deleteVersionParam;
+        const hasDiscardDraft = def.hasDiscardDraft !== false;
+        server.tool(`delete_${singular}`, `Delete a ${singular}. Destructive, but RECOVERABLE — it is soft-deleted ` +
+            `and can be brought back with restore_${singular} (it will not appear in ` +
+            `list_${plural} until then). Read it first for its version. A 409 here ` +
+            `may be a stale version (re-read and retry) or a reference conflict ` +
+            `(something published still uses it — re-reading will not help; the ` +
+            `error tells you which).`, {
+            id: z.string().describe(`The ${singular}'s id.`),
+            expectedVersion: z
+                .number()
+                .int()
+                .describe("The version you last read — rejected with 409 if stale."),
+            confirm: CONFIRM,
+        }, async ({ id, expectedVersion }) => guard(async () => {
+            await client.del(`${basePath}/${id}`, { [deleteVersionParam]: expectedVersion });
+            return jsonResult({ deleted: true, id });
+        }));
+        server.tool(`restore_${singular}`, `Undo delete_${singular} — bring a soft-deleted ${singular} back. Takes no ` +
+            `version check (a restore must never lose to a stale-version guard). Can ` +
+            `409 if a live ${singular} now holds a name/slot this one also claims.`, { id: z.string().describe(`The ${singular}'s id.`) }, async ({ id }) => guard(async () => jsonResult(await client.post(`${basePath}/${id}/restore`))));
+        server.tool(`list_deleted_${plural}`, `List soft-deleted ${label} — the restore candidates for restore_${singular}.`, {}, async () => guard(async () => jsonResult(def.deletedListPath === "query"
+            ? await client.get(basePath, { deleted: true })
+            : await client.get(`${basePath}/deleted`))));
+        if (hasDiscardDraft) {
+            server.tool(`discard_${singular}_draft`, `Discard uncommitted draft edits on a ${singular}, resetting it to its ` +
+                `last published state. Fails if it has never been published — there is ` +
+                `no published state to fall back to.`, { id: z.string().describe(`The ${singular}'s id.`) }, async ({ id }) => guard(async () => jsonResult(await client.post(`${basePath}/${id}/discard-draft`))));
+        }
+    }
+    if (!publishable)
+        return;
     server.tool(`request_publish_${singular}`, `Request that a ${singular} be published. This does NOT publish it — it ` +
         `creates a pending approval a human approves in Axonity. Returns the ` +
         `pending approval (with its readiness).`, {

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.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Run observability — how an agent evaluates what it built.
+ *
+ * There is no "findings" endpoint and no evaluator entity. Evaluation means
+ * reading runs: the run detail carries `validatorVerdicts` and
+ * `agentInvocations`, and the trace carries the step-by-step tool calls. Those
+ * are the evidence an agent reasons over.
+ *
+ * Runs are also the only thing in the product with a real archive state —
+ * entities have soft-delete, runs have archive/unarchive.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AxonityClient } from "../client.js";
+export declare function registerRunTools(server: McpServer, client: AxonityClient): void;

package/dist/tools/runs.js

@@ -0,0 +1,73 @@
+/**
+ * Run observability — how an agent evaluates what it built.
+ *
+ * There is no "findings" endpoint and no evaluator entity. Evaluation means
+ * reading runs: the run detail carries `validatorVerdicts` and
+ * `agentInvocations`, and the trace carries the step-by-step tool calls. Those
+ * are the evidence an agent reasons over.
+ *
+ * Runs are also the only thing in the product with a real archive state —
+ * entities have soft-delete, runs have archive/unarchive.
+ */
+import { z } from "zod";
+import { guard, jsonResult } from "./result.js";
+const CONFIRM = z
+    .literal(true)
+    .describe("Must be true. Destructive and irreversible — ask your human first.");
+export function registerRunTools(server, client) {
+    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, " +
+        "use list_workflow_runs instead — this route has no workflow filter.", {
+        status: z
+            .string()
+            .optional()
+            .describe('Comma-separated statuses, e.g. "running,failed". Omit for all.'),
+        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."),
+        limit: z.number().int().optional().describe("Default 50, capped at 200."),
+        offset: z.number().int().optional().describe("Default 0."),
+    }, async ({ status, createdAfter, createdBefore, includeArchived, limit, offset }) => guard(async () => jsonResult(await client.get("/api/v1/runs", {
+        status,
+        created_after: createdAfter,
+        created_before: createdBefore,
+        include_archived: includeArchived,
+        limit,
+        offset,
+    }))));
+    server.tool("list_workflow_runs", "List the runs of one workflow. Note this route takes archivedOnly (show " +
+        "ONLY archived runs), which is not the same as list_runs' includeArchived.", {
+        workflowId: z.string().describe("The workflow's id."),
+        archivedOnly: z
+            .boolean()
+            .optional()
+            .describe("True to list only archived runs. Defaults to false."),
+    }, async ({ workflowId, archivedOnly }) => guard(async () => jsonResult(await client.get(`/api/v1/workflows/${workflowId}/runs`, {
+        archived_only: archivedOnly,
+    }))));
+    server.tool("read_run", "Read one run in full: status, per-step state, the workflow snapshot it " +
+        "ran against, trigger input, agent invocations, and validator verdicts. " +
+        "The verdicts are the closest thing to evaluator findings — there is no " +
+        "separate findings endpoint.", { runId: z.string().describe("The run's id.") }, async ({ runId }) => guard(async () => jsonResult(await client.get(`/api/v1/runs/${runId}`))));
+    server.tool("read_run_trace", "Read a run's chronological tool-call trace — each entry has the step, the " +
+        "tool, its arguments, its output, and any error. This is what you read to " +
+        "work out WHY a run behaved as it did.", { runId: z.string().describe("The run's id.") }, async ({ runId }) => guard(async () => jsonResult(await client.get(`/api/v1/runs/${runId}/trace`))));
+    server.tool("read_run_cost", "Read a run's token and cost breakdown, per agent and model.", { runId: z.string().describe("The run's id.") }, async ({ runId }) => guard(async () => jsonResult(await client.get(`/api/v1/runs/${runId}/cost`))));
+    server.tool("read_runs_summary", "Counts of runs by state across the tenant (running, waiting, completed, " +
+        "failed, expired, total).", {}, async () => guard(async () => jsonResult(await client.get("/api/v1/runs/summary"))));
+    server.tool("archive_run", "Archive a run — hides it from the default run list without deleting it. " +
+        "Reversible with unarchive_run.", { runId: z.string().describe("The run's id.") }, async ({ runId }) => guard(async () => jsonResult(await client.post(`/api/v1/runs/${runId}/archive`))));
+    server.tool("unarchive_run", "Restore an archived run to the default run list.", { runId: z.string().describe("The run's id.") }, async ({ runId }) => guard(async () => jsonResult(await client.post(`/api/v1/runs/${runId}/unarchive`))));
+    server.tool("bulk_archive_runs", "Archive up to 500 runs at once. Reversible — archived runs can be " +
+        "unarchived individually. Returns counts of succeeded and failed.", {
+        runIds: z.array(z.string()).min(1).max(500).describe("The run ids to archive."),
+    }, async ({ runIds }) => guard(async () => jsonResult(await client.post("/api/v1/runs/bulk/archive", { runIds }))));
+    server.tool("bulk_delete_runs", "Delete up to 500 runs at once. IRREVERSIBLE — unlike archiving, deleted " +
+        "runs do not come back, and their traces and cost history go with them. " +
+        "Prefer bulk_archive_runs unless a human has explicitly asked for deletion. " +
+        "Returns counts of succeeded and failed; a partial failure is possible.", {
+        runIds: z.array(z.string()).min(1).max(500).describe("The run ids to delete."),
+        confirm: CONFIRM,
+    }, async ({ runIds }) => guard(async () => jsonResult(await client.post("/api/v1/runs/bulk/delete", { runIds }))));
+}
+//# sourceMappingURL=runs.js.map

package/dist/tools/runs.js.map

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

package/dist/tools/triggers.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Trigger management — what makes a published workflow actually run.
+ *
+ * Three trigger kinds, all member-accessible despite living in `*_admin.py` on
+ * the backend. Note the asymmetry the routes impose: creating and listing are
+ * workflow-scoped, while rotate/update/delete address the trigger directly.
+ *
+ * Trigger deletes are HARD deletes — the row is removed, not soft-deleted, and
+ * there is no restore. Hence the `confirm` guard on each.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AxonityClient } from "../client.js";
+export declare function registerTriggerTools(server: McpServer, client: AxonityClient): void;