@axonity-ai/mcp 0.1.0 → 0.3.2

package/dist/tools/runs.js

@@ -0,0 +1,103 @@
+/**
+ * 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("start_workflow_run", "Start a real run of a workflow — the way to TEST a workflow you just " +
+        "authored. This EXECUTES: it runs the PUBLISHED workflow against live " +
+        "infrastructure (models, connectors), so it can incur cost and cause real " +
+        "side effects. It does not run your unpublished draft. After starting, " +
+        "follow it with read_run / read_run_trace / read_run_cost. Optionally pass " +
+        "triggerInput to feed the workflow's trigger.", {
+        workflowId: z.string().describe("The workflow's id."),
+        triggerInput: z
+            .record(z.unknown())
+            .optional()
+            .describe("Input payload for the workflow's trigger. Omit for none."),
+        manualPhases: z
+            .boolean()
+            .optional()
+            .describe("Run with manual phase gating. Defaults to false."),
+    }, async ({ workflowId, triggerInput, manualPhases }) => guard(async () => jsonResult(await client.post(`/api/v1/workflows/${workflowId}/runs`, {
+        ...(triggerInput ? { triggerInput } : {}),
+        ...(manualPhases === undefined ? {} : { manualPhases }),
+    }))));
+    server.tool("cancel_run", "Cancel an in-flight run. Stops further steps; already-completed steps and " +
+        "their side effects are not undone.", { runId: z.string().describe("The run's id.") }, async ({ runId }) => guard(async () => jsonResult(await client.post(`/api/v1/runs/${runId}/cancel`))));
+    server.tool("delete_run", "Delete ONE run. IRREVERSIBLE — the run and its trace and cost history go " +
+        "with it. Prefer archive_run unless a human has asked for deletion. For " +
+        "many at once use bulk_delete_runs.", {
+        runId: z.string().describe("The run's id."),
+        confirm: CONFIRM,
+    }, async ({ runId }) => guard(async () => {
+        await client.del(`/api/v1/runs/${runId}`);
+        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, " +
+        "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;

package/dist/tools/triggers.js

@@ -0,0 +1,128 @@
+/**
+ * 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 { 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. Destructive and irreversible — ask your human first.");
+export function registerTriggerTools(server, client) {
+    // ---- Webhook triggers -------------------------------------------------
+    server.tool("list_webhook_triggers", "List a workflow's webhook triggers. Secrets are never returned — a " +
+        "trigger's token is shown only once, when it is created or rotated.", { workflowId: z.string().describe("The workflow's id.") }, async ({ workflowId }) => guard(async () => jsonResult(await client.get(`/api/v1/workflows/${workflowId}/webhook-triggers`))));
+    server.tool("create_webhook_trigger", "Create a webhook trigger on a workflow. Returns the trigger AND its " +
+        "plaintext token — shown ONCE and never retrievable again. Hand the token " +
+        "to your human immediately; do not store it in an entity field.", {
+        workflowId: z.string().describe("The workflow's id."),
+        triggerId: z
+            .string()
+            .describe("The id of the trigger node in the workflow document."),
+        expectedInputSchema: z
+            .record(z.unknown())
+            .optional()
+            .describe("JSON schema the incoming payload must match. Defaults to {}."),
+    }, async ({ workflowId, triggerId, expectedInputSchema }) => guard(async () => jsonResult(await client.post(`/api/v1/workflows/${workflowId}/webhook-triggers`, {
+        triggerId,
+        ...(expectedInputSchema ? { expectedInputSchema } : {}),
+    }))));
+    server.tool("rotate_webhook_trigger", "Rotate a webhook trigger's token. Returns the new plaintext token ONCE. " +
+        "The old token keeps working for a short grace period so callers can be " +
+        "migrated.", {
+        webhookId: z.string().describe("The webhook trigger's id."),
+        confirm: CONFIRM,
+    }, async ({ webhookId }) => guard(async () => jsonResult(await client.post(`/api/v1/webhook-triggers/${webhookId}/rotate`))));
+    server.tool("delete_webhook_trigger", "Delete a webhook trigger. HARD delete — the row is removed and cannot be " +
+        "restored, and any caller using its token starts failing immediately.", {
+        webhookId: z.string().describe("The webhook trigger's id."),
+        confirm: CONFIRM,
+    }, async ({ webhookId }) => guard(async () => {
+        await client.del(`/api/v1/webhook-triggers/${webhookId}`);
+        return jsonResult({ deleted: true, webhookId });
+    }));
+    // ---- Cron schedules ---------------------------------------------------
+    server.tool("list_cron_schedules", "List a workflow's cron schedules, with their next and last fire times.", { workflowId: z.string().describe("The workflow's id.") }, async ({ workflowId }) => guard(async () => jsonResult(await client.get(`/api/v1/workflows/${workflowId}/cron-schedules`))));
+    server.tool("create_cron_schedule", "Schedule a workflow to run on a cron expression.", {
+        workflowId: z.string().describe("The workflow's id."),
+        triggerId: z
+            .string()
+            .describe("The id of the trigger node in the workflow document."),
+        cronExpr: z
+            .string()
+            .describe('The cron expression, e.g. "0 9 * * 1-5" for weekdays at 09:00.'),
+        timezone: z
+            .string()
+            .optional()
+            .describe('IANA timezone, e.g. "Europe/Brussels". Defaults to UTC.'),
+        enabled: z.boolean().optional().describe("Defaults to true."),
+    }, async ({ workflowId, triggerId, cronExpr, timezone, enabled }) => guard(async () => jsonResult(await client.post(`/api/v1/workflows/${workflowId}/cron-schedules`, {
+        triggerId,
+        cronExpr,
+        ...(timezone ? { timezone } : {}),
+        ...(enabled === undefined ? {} : { enabled }),
+    }))));
+    server.tool("delete_cron_schedule", "Delete a cron schedule. HARD delete — the row is removed and cannot be " +
+        "restored. The workflow stops running on this schedule immediately.", {
+        scheduleId: z.string().describe("The cron schedule's id."),
+        confirm: CONFIRM,
+    }, async ({ scheduleId }) => guard(async () => {
+        await client.del(`/api/v1/cron-schedules/${scheduleId}`);
+        return jsonResult({ deleted: true, scheduleId });
+    }));
+    // ---- Conditional triggers ---------------------------------------------
+    server.tool("list_conditional_triggers", "List a workflow's conditional triggers — an agent evaluates a condition " +
+        "on an interval and starts the workflow when it holds.", { workflowId: z.string().describe("The workflow's id.") }, async ({ workflowId }) => guard(async () => jsonResult(await client.get(`/api/v1/workflows/${workflowId}/conditional-triggers`))));
+    server.tool("create_conditional_trigger", "Create a conditional trigger on a workflow: an agent checks `conditionText` " +
+        "every `repeatIntervalMinutes` and fires the workflow when it is met.", {
+        workflowId: z.string().describe("The workflow's id."),
+        triggerId: z
+            .string()
+            .describe("The id of the trigger node in the workflow document."),
+        agentId: z.string().describe("The agent that evaluates the condition."),
+        conditionText: z
+            .string()
+            .min(1)
+            .max(2000)
+            .describe("The condition, in plain language."),
+        repeatIntervalMinutes: z
+            .number()
+            .int()
+            .min(5)
+            .max(10080)
+            .describe("How often to re-check, in minutes (5 to 10080)."),
+        enabled: z.boolean().optional().describe("Defaults to true."),
+    }, async ({ workflowId, triggerId, agentId, conditionText, repeatIntervalMinutes, enabled }) => guard(async () => jsonResult(await client.post(`/api/v1/workflows/${workflowId}/conditional-triggers`, {
+        triggerId,
+        agentId,
+        conditionText,
+        repeatIntervalMinutes,
+        ...(enabled === undefined ? {} : { enabled }),
+    }))));
+    server.tool("update_conditional_trigger", "Change a conditional trigger's condition, interval, agent, or enabled flag. " +
+        "Send only what you are changing.", {
+        triggerId: z.string().describe("The conditional trigger's id."),
+        conditionText: z.string().min(1).max(2000).optional(),
+        repeatIntervalMinutes: z.number().int().min(5).max(10080).optional(),
+        agentId: z.string().optional(),
+        enabled: z.boolean().optional(),
+    }, async ({ triggerId, ...fields }) => guard(async () => {
+        const body = Object.fromEntries(Object.entries(fields).filter(([, v]) => v !== undefined));
+        return jsonResult(await client.patch(`/api/v1/conditional-triggers/${triggerId}`, body));
+    }));
+    server.tool("delete_conditional_trigger", "Delete a conditional trigger. HARD delete — the row is removed and cannot " +
+        "be restored.", {
+        triggerId: z.string().describe("The conditional trigger's id."),
+        confirm: CONFIRM,
+    }, async ({ triggerId }) => guard(async () => {
+        await client.del(`/api/v1/conditional-triggers/${triggerId}`);
+        return jsonResult({ deleted: true, triggerId });
+    }));
+}
+//# sourceMappingURL=triggers.js.map

package/dist/tools/triggers.js.map

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

package/dist/tools/validation.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Validation and inspection verbs — check work before requesting publish.
+ *
+ * All four routes are stateless: they take a document or a code fragment and
+ * return a verdict without touching stored state. That makes them safe to call
+ * as often as the agent likes, and they are the cheapest way to close the
+ * authoring loop (draft → validate → fix → request_publish).
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AxonityClient } from "../client.js";
+export declare function registerValidationTools(server: McpServer, client: AxonityClient): void;
+export declare function registerApprovalTools(server: McpServer, client: AxonityClient): void;
+export declare function registerExecutionTools(server: McpServer, client: AxonityClient): void;

package/dist/tools/validation.js

@@ -0,0 +1,116 @@
+/**
+ * Validation and inspection verbs — check work before requesting publish.
+ *
+ * All four routes are stateless: they take a document or a code fragment and
+ * return a verdict without touching stored state. That makes them safe to call
+ * as often as the agent likes, and they are the cheapest way to close the
+ * authoring loop (draft → validate → fix → request_publish).
+ */
+import { z } from "zod";
+import { guard, jsonResult } from "./result.js";
+export function registerValidationTools(server, client) {
+    server.tool("validate_workflow", "Check a workflow document for structural and schema problems. Returns " +
+        "`launchable` plus an `issues` list (each with code, message, severity, " +
+        "stepIds, edgeIds). STATELESS: it validates the document you pass, does " +
+        "not read or write the stored workflow, so read-only service tokens can call it. " +
+        "It does NOT verify that referenced agents or tools exist. Call it after " +
+        "apply_workflow_mutations " +
+        "and before request_publish_workflow.", {
+        document: z
+            .record(z.unknown())
+            .describe("The workflow document to validate (as returned by read_workflow)."),
+    }, async ({ document }) => guard(async () => jsonResult(await client.post("/api/v1/workflows/validate", { document }))));
+    server.tool("analyze_workflow_reachable_outputs", "List the outputs a given step can read — i.e. what upstream steps make " +
+        "available to it. Use it to bind a step's inputs to real upstream outputs " +
+        "instead of guessing field names. Stateless, and safe for read-only service tokens.", {
+        document: z.record(z.unknown()).describe("The workflow document."),
+        stepId: z.string().describe("The step whose reachable inputs you want."),
+    }, async ({ document, stepId }) => guard(async () => jsonResult(await client.post("/api/v1/workflows/reachable-outputs", { document, stepId }))));
+    server.tool("validate_tool_code", "Check Python tool code for syntax errors and banned patterns before " +
+        "saving it on a tool. Returns `valid` plus `errors` (line, column, " +
+        "message, severity, functionName). Stateless and safe for read-only service " +
+        "tokens.", {
+        imports: z
+            .string()
+            .optional()
+            .describe("The import block, as one string. Defaults to empty."),
+        functions: z
+            .array(z.object({
+            name: z.string().describe("Function name."),
+            code: z.string().describe("Full function source."),
+        }))
+            .describe("The functions to check (max 20)."),
+        classes: z
+            .array(z.object({
+            name: z.string().describe("Class name."),
+            code: z.string().describe("Full class source."),
+        }))
+            .optional()
+            .describe("Optional classes to check (max 20)."),
+    }, async ({ imports, functions, classes }) => guard(async () => jsonResult(await client.post("/api/v1/tools/validate-code", {
+        imports: imports ?? "",
+        functions,
+        ...(classes ? { classes } : {}),
+    }))));
+    server.tool("format_tool_code", "Format Python tool code with Black and return the formatted source. " +
+        "Stateless and safe for read-only service tokens — it does not save anything.", { code: z.string().describe("The Python source to format.") }, async ({ code }) => guard(async () => jsonResult(await client.post("/api/v1/tools/format-code", { code }))));
+}
+export function registerApprovalTools(server, client) {
+    server.tool("list_publish_approvals", "List this tenant's publish approvals and their status — how you find out " +
+        "whether a request_publish_* was approved or rejected. Optionally filter " +
+        "by status, and page through with limit/offset. Approving and rejecting " +
+        "are human-only actions in Axonity; no tool can do them.", {
+        status: z
+            .enum(["pending", "approved", "rejected"])
+            .optional()
+            .describe("Filter by status. Omit for all."),
+        limit: z.number().int().min(1).max(200).optional().describe("Default 50."),
+        offset: z.number().int().min(0).optional().describe("Default 0."),
+    }, async ({ status, limit, offset }) => guard(async () => jsonResult(await client.get("/api/v1/publish-approvals", { status, limit, offset }))));
+    server.tool("get_publish_approval", "Read one publish approval by id — lets you poll a specific request rather " +
+        "than re-fetching the whole list.", { approvalId: z.string().describe("The approval's id, from request_publish_* or list_publish_approvals.") }, async ({ approvalId }) => guard(async () => jsonResult(await client.get(`/api/v1/publish-approvals/${approvalId}`))));
+}
+export function registerExecutionTools(server, client) {
+    server.tool("execute_tool", "Run tool code directly, without saving it — the way to test a tool you're " +
+        "authoring before create_tool/update_tool. Returns stdout/stderr, the " +
+        "result, and a typed errorType (timeout/memory/import/runtime/validation) " +
+        "on failure. Pass toolId to run against an already-saved tool's context.", {
+        imports: z.string().optional().describe("The import block. Defaults to empty."),
+        functions: z
+            .array(z.object({ name: z.string(), code: z.string() }))
+            .describe("The functions to run (max 20)."),
+        classes: z
+            .array(z.object({ name: z.string(), code: z.string() }))
+            .optional()
+            .describe("Optional classes (max 20)."),
+        inputParams: z
+            .record(z.unknown())
+            .optional()
+            .describe("Parameters passed into the entry-point function."),
+        timeout: z.number().int().min(1).max(120).optional().describe("Seconds. Default 30."),
+        toolId: z.string().optional().describe("An existing tool id to run in context of."),
+    }, async ({ imports, functions, classes, inputParams, timeout, toolId }) => guard(async () => jsonResult(await client.post("/api/v1/tools/execute", {
+        imports: imports ?? "",
+        functions,
+        ...(classes ? { classes } : {}),
+        ...(inputParams ? { inputParams } : {}),
+        ...(timeout ? { timeout } : {}),
+        ...(toolId ? { toolId } : {}),
+    }))));
+    server.tool("execute_stored_connector", "Test-run an ALREADY-SAVED connector by its tool id — the backend loads its " +
+        "stored authConfig and decrypts the real secret server-side; nothing " +
+        "credential-shaped ever passes through this tool or through you. Takes " +
+        "only input parameters, nothing else — there is no way to point this at a " +
+        "URL or auth config of your choosing (that admin-only, body-supplied form " +
+        "exists on the backend precisely so a client like this one can never reach " +
+        "it, since it would otherwise let a caller exfiltrate a decrypted secret).", {
+        toolId: z.string().describe("The connector's tool id — must already be saved."),
+        inputParams: z
+            .record(z.unknown())
+            .optional()
+            .describe("Parameters for the connector call."),
+    }, async ({ toolId, inputParams }) => guard(async () => jsonResult(await client.post(`/api/v1/tools/${toolId}/execute-connector`, {
+        ...(inputParams ? { inputParams } : {}),
+    }))));
+}
+//# sourceMappingURL=validation.js.map

package/dist/tools/validation.js.map

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

package/dist/tools/versions.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Version history, rollback, and version-level delete/restore.
+ *
+ * Two different identifiers appear in these routes and confusing them silently
+ * 404s:
+ *   - `version`    — an INTEGER checkpoint number (1, 2, 3 …), used to read one.
+ *   - `versionId`  — the UUID of the version row, used to restore/delete it.
+ *
+ * There are also two unrelated things both called "restore" here:
+ *   - `restore_<entity>_version`         — roll the DRAFT back to an old,
+ *     still-live version. Takes `expectedVersion` in the body.
+ *   - `restore_deleted_<entity>_version` — undo a DELETED version row coming
+ *     back into history. No body — a restore must never lose to a stale-version
+ *     guard.
+ *
+ * The published snapshot also lives in two places depending on the entity
+ * family: `/{id}/published` for workflow/agent/tool/flow, `/{id}/versions/published`
+ * for the memory entities (including output_schema and prompt_snippet, which
+ * gained full versioning alongside them). `publishedPath` selects the right one.
+ *
+ * Only entities that actually expose `/versions*` get these verbs.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AxonityClient } from "../client.js";
+export interface VersionedEntity {
+    /** Tool noun, e.g. "workflow". */
+    singular: string;
+    /** REST collection path, e.g. "/api/v1/workflows". */
+    basePath: string;
+    /**
+     * Where the published snapshot lives.
+     * `"entity"` → `/{id}/published` (workflow, agent, tool)
+     * `"versions"` → `/{id}/versions/published` (skill, policy, reference_doc, persona)
+     */
+    publishedPath: "entity" | "versions";
+}
+export declare function registerVersionTools(server: McpServer, client: AxonityClient, { singular, basePath, publishedPath }: VersionedEntity): void;

package/dist/tools/versions.js

@@ -0,0 +1,104 @@
+/**
+ * Version history, rollback, and version-level delete/restore.
+ *
+ * Two different identifiers appear in these routes and confusing them silently
+ * 404s:
+ *   - `version`    — an INTEGER checkpoint number (1, 2, 3 …), used to read one.
+ *   - `versionId`  — the UUID of the version row, used to restore/delete it.
+ *
+ * There are also two unrelated things both called "restore" here:
+ *   - `restore_<entity>_version`         — roll the DRAFT back to an old,
+ *     still-live version. Takes `expectedVersion` in the body.
+ *   - `restore_deleted_<entity>_version` — undo a DELETED version row coming
+ *     back into history. No body — a restore must never lose to a stale-version
+ *     guard.
+ *
+ * The published snapshot also lives in two places depending on the entity
+ * family: `/{id}/published` for workflow/agent/tool/flow, `/{id}/versions/published`
+ * for the memory entities (including output_schema and prompt_snippet, which
+ * gained full versioning alongside them). `publishedPath` selects the right one.
+ *
+ * Only entities that actually expose `/versions*` get these verbs.
+ */
+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 registerVersionTools(server, client, { singular, basePath, publishedPath }) {
+    server.tool(`list_${singular}_versions`, `List a ${singular}'s version history — checkpoints (every save) and major ` +
+        `versions (named releases). Use this to find the versionId you need for ` +
+        `restore_${singular}_version.`, {
+        id: z.string().describe(`The ${singular}'s id.`),
+        type: z
+            .enum(["checkpoint", "major", "all"])
+            .optional()
+            .describe("Which kind to list. Defaults to all."),
+        limit: z.number().int().min(1).max(200).optional().describe("Default 50."),
+        offset: z.number().int().min(0).optional().describe("Default 0."),
+    }, async ({ id, type, limit, offset }) => guard(async () => jsonResult(await client.get(`${basePath}/${id}/versions`, { type, limit, offset }))));
+    server.tool(`read_${singular}_version`, `Read one historical version of a ${singular} by its CHECKPOINT NUMBER (an ` +
+        `integer like 3, from the \`version\` field in list_${singular}_versions) — ` +
+        `not by its versionId. Use it to diff two versions before rolling back.`, {
+        id: z.string().describe(`The ${singular}'s id.`),
+        version: z
+            .number()
+            .int()
+            .describe("The integer checkpoint number, e.g. 3."),
+    }, async ({ id, version }) => guard(async () => jsonResult(await client.get(`${basePath}/${id}/versions/${version}`))));
+    server.tool(`restore_${singular}_version`, `Roll a ${singular}'s DRAFT back to an earlier version. Takes the versionId ` +
+        `(a UUID from list_${singular}_versions), NOT the checkpoint number. The ` +
+        `current draft is snapshotted first, so this is itself undoable. It ` +
+        `changes only the draft — what is live stays live until a human approves a ` +
+        `new publish.`, {
+        id: z.string().describe(`The ${singular}'s id.`),
+        versionId: z.string().describe("The version row's UUID."),
+        expectedVersion: z
+            .number()
+            .int()
+            .describe("The draft version you last read — 409 if stale."),
+    }, async ({ id, versionId, expectedVersion }) => guard(async () => jsonResult(await client.post(`${basePath}/${id}/versions/${versionId}/restore`, {
+        expectedVersion,
+    }))));
+    server.tool(`delete_${singular}_version`, `Permanently remove one entry from a ${singular}'s version history. The ` +
+        `working draft and the currently published version are protected and ` +
+        `cannot be targeted this way. Recoverable with ` +
+        `restore_deleted_${singular}_version until it is purged for good.`, {
+        id: z.string().describe(`The ${singular}'s id.`),
+        versionId: z.string().describe("The version row's UUID (not the checkpoint number)."),
+        confirm: CONFIRM,
+    }, async ({ id, versionId }) => guard(async () => {
+        await client.del(`${basePath}/${id}/versions/${versionId}`);
+        return jsonResult({ deleted: true, id, versionId });
+    }));
+    server.tool(`list_deleted_${singular}_versions`, `List a ${singular}'s deleted version rows — restore candidates for ` +
+        `restore_deleted_${singular}_version. Deleted version numbers stay ` +
+        `reserved (not reused), so gaps in the numbering are expected, not corruption.`, { id: z.string().describe(`The ${singular}'s id.`) }, async ({ id }) => guard(async () => jsonResult(await client.get(`${basePath}/${id}/versions/deleted`))));
+    server.tool(`restore_deleted_${singular}_version`, `Undo delete_${singular}_version — bring a removed version row back into ` +
+        `history. This does NOT change the current draft (unlike ` +
+        `restore_${singular}_version); it only makes the row visible/restorable ` +
+        `again. Takes no version check.`, {
+        id: z.string().describe(`The ${singular}'s id.`),
+        versionId: z
+            .string()
+            .describe(`The version row's UUID, from list_deleted_${singular}_versions.`),
+    }, async ({ id, versionId }) => guard(async () => jsonResult(await client.post(`${basePath}/${id}/versions/${versionId}/restore-deleted`))));
+    server.tool(`name_${singular}_major_version`, `Give a ${singular}'s major version a name — label a release so it is easy to ` +
+        `find in history. Targets a MAJOR version by its integer number (from ` +
+        `list_${singular}_versions), not a checkpoint or a versionId. This only ` +
+        `renames; it does not create, publish, or roll anything back.`, {
+        id: z.string().describe(`The ${singular}'s id.`),
+        majorVersion: z
+            .number()
+            .int()
+            .describe("The major version's integer number, e.g. 2."),
+        name: z.string().min(1).max(255).describe("The new name for that major version."),
+    }, async ({ id, majorVersion, name }) => guard(async () => jsonResult(await client.patch(`${basePath}/${id}/versions/major/${majorVersion}`, { name }))));
+    server.tool(`read_${singular}_published`, `Read the LIVE published version of a ${singular} — what the runtime ` +
+        `actually uses, as opposed to the draft that read_${singular} returns. ` +
+        `Diff the two to see what a pending publish would change.`, { id: z.string().describe(`The ${singular}'s id.`) }, async ({ id }) => guard(async () => jsonResult(await client.get(publishedPath === "entity"
+        ? `${basePath}/${id}/published`
+        : `${basePath}/${id}/versions/published`))));
+}
+//# sourceMappingURL=versions.js.map

package/dist/tools/versions.js.map

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

package/dist/tools/workflowMutations.d.ts

@@ -5,7 +5,29 @@
  * backend-authoritative model the Studio uses), never by replacing the whole
  * document. The backend applies and validates the commands and returns the new
  * authoritative document + version.
+ *
+ * The backend route applies exactly ONE mutation per call — `POST
+ * /workflows/{id}/mutations` takes `{ type, payload, expectedVersion }` and there
+ * is no batch route. This tool keeps a batch-shaped signature (an agent thinks in
+ * whole edits, not round-trips) and sequences the calls itself, threading the
+ * version returned by call N into call N+1.
+ *
+ * Because the sequence is not a transaction, a failure at index k leaves the
+ * mutations before it applied. The error says how many landed and which one
+ * failed so the caller can re-read and resume rather than blindly retry — a
+ * retry from the top would re-apply the successful prefix.
  */
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { AxonityClient } from "../client.js";
+/**
+ * Split one command into the `{ type, payload }` pair the backend expects.
+ *
+ * Accepts both the explicit form (`{ type, payload: {...} }`) and the flat form
+ * (`{ type, ...args }`), because an agent writing these by hand produces either
+ * and the difference is not meaningful to it.
+ */
+export declare function toMutationBody(mutation: Record<string, unknown>, index: number): {
+    type: string;
+    payload: Record<string, unknown>;
+};
 export declare function registerWorkflowMutations(server: McpServer, client: AxonityClient): void;