@axonity-ai/mcp 0.1.0 → 0.2.2

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,93 @@
+/**
+ * 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(`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;

package/dist/tools/workflowMutations.js

@@ -5,41 +5,113 @@
  * 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 { z } from "zod";
 import { AxonityApiError } from "../errors.js";
+import { guard, jsonResult } from "./result.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 function toMutationBody(mutation, index) {
+    const { type, payload, ...rest } = mutation;
+    if (typeof type !== "string" || type.length === 0) {
+        throw new Error(`mutations[${index}] is missing a \`type\` (e.g. "add_step", "add_edge").`);
+    }
+    if (payload !== undefined) {
+        if (typeof payload !== "object" || payload === null || Array.isArray(payload)) {
+            throw new Error(`mutations[${index}].payload must be a JSON object.`);
+        }
+        return { type, payload: payload };
+    }
+    return { type, payload: rest };
+}
+/** Compose the error for a mutation that failed part-way through a sequence. */
+function sequenceError(index, total, type, version, cause) {
+    const reason = cause instanceof AxonityApiError || cause instanceof Error
+        ? cause.message
+        : String(cause);
+    const applied = index;
+    const summary = JSON.stringify({ appliedCount: applied, failedIndex: index, failedType: type, currentVersion: version }, null, 2);
+    return new Error(`Mutation ${index + 1} of ${total} (\`${type}\`) failed: ${reason}\n\n` +
+        `${applied} of ${total} mutations were already applied and were NOT rolled back — ` +
+        `this sequence is not a transaction. Do not retry the whole list: re-read the ` +
+        `workflow, confirm which edits landed, and resume from index ${index}.\n\n` +
+        summary);
+}
 export function registerWorkflowMutations(server, client) {
     server.tool("apply_workflow_mutations", "Apply structural mutation commands to a workflow draft (add/remove steps, " +
         "connect edges, set conditions). Read the workflow first for its version. " +
-        "Returns the new authoritative document + version. On a 409 conflict, " +
-        "re-read and retry.", {
+        "Commands are applied IN ORDER, one backend call each, with the version " +
+        "threaded automatically — pass the version you read, not one per command. " +
+        "Returns the new authoritative document, version, and validation state. " +
+        "Not transactional: if command N fails, commands before it stay applied and " +
+        "the error reports how many landed. On a 409 conflict, re-read and retry. " +
+        'Each command is `{ "type": "add_step", "payload": { … } }`; the flat form ' +
+        '`{ "type": "add_step", … }` is accepted too. Valid types: update_workflow, ' +
+        "add_trigger, update_trigger, remove_trigger, update_trigger_operator, " +
+        "group_triggers, ungroup_triggers, move_trigger, add_step, add_loop, " +
+        "update_step, remove_step, move_step, add_edge, update_edge, remove_edge, " +
+        "convert_to_loop, setup_loop_decision, advanced_edit.", {
         id: z.string().describe("The workflow's id."),
         expectedVersion: z
             .number()
             .int()
-            .describe("The version you last read — rejected with 409 if stale."),
+            .describe("The version you last read. Only the FIRST command uses it; later " +
+            "commands use the version returned by the previous one."),
         mutations: z
             .array(z.record(z.unknown()))
-            .describe("A list of mutation commands, each a JSON object with a command name " +
-            "and its arguments (camelCase)."),
-    }, async ({ id, expectedVersion, mutations }) => {
-        try {
-            const data = await client.post(`/api/v1/workflows/${id}/mutations`, {
-                expectedVersion,
-                mutations,
-            });
-            return {
-                content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
-            };
-        }
-        catch (err) {
-            const message = err instanceof AxonityApiError
-                ? err.message
-                : err instanceof Error
-                    ? err.message
-                    : String(err);
-            return { content: [{ type: "text", text: message }], isError: true };
+            .min(1)
+            .describe("Mutation commands to apply in order, each a JSON object with a " +
+            "`type` and its arguments (camelCase), either nested under " +
+            "`payload` or inline."),
+    }, async ({ id, expectedVersion, mutations }) => guard(async () => {
+        // Reject the whole batch on a malformed command before applying any of
+        // it — a shape error is the agent's mistake, not a partial failure.
+        const bodies = mutations.map((m, i) => toMutationBody(m, i));
+        let version = expectedVersion;
+        let last;
+        for (const [index, body] of bodies.entries()) {
+            try {
+                last = await client.post(`/api/v1/workflows/${id}/mutations`, { type: body.type, payload: body.payload, expectedVersion: version });
+            }
+            catch (cause) {
+                throw sequenceError(index, bodies.length, body.type, version, cause);
+            }
+            version = last.version;
         }
-    });
+        return jsonResult({ ...last, appliedCount: bodies.length });
+    }));
+    server.tool("replace_workflow_document", "Replace the ENTIRE workflow document in one atomic call. Read the workflow first to " +
+        "get the current version, then call this again only after rereading on a stale " +
+        "`409`.\n" +
+        "Unlike `apply_workflow_mutations`, this is a single PUT request and treats the " +
+        "payload as the complete editable document.", {
+        id: z.string().describe("The workflow's id."),
+        expectedVersion: z
+            .number()
+            .int()
+            .describe("The version you read before replacing the document."),
+        document: z
+            .record(z.unknown())
+            .describe("The complete workflow document object to persist."),
+    }, async ({ id, expectedVersion, document }) => guard(async () => jsonResult(await client.put(`/api/v1/workflows/${id}`, {
+        expectedVersion,
+        document,
+    }))));
 }
 //# sourceMappingURL=workflowMutations.js.map

package/dist/tools/workflowMutations.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflowMutations.js","sourceRoot":"","sources":["../../src/tools/workflowMutations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,UAAU,yBAAyB,CACvC,MAAiB,EACjB,MAAqB;IAErB,MAAM,CAAC,IAAI,CACT,0BAA0B,EAC1B,4EAA4E;QAC1E,2EAA2E;QAC3E,uEAAuE;QACvE,oBAAoB,EACtB;QACE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;QAC7C,eAAe,EAAE,CAAC;aACf,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,CAAC,yDAAyD,CAAC;QACtE,SAAS,EAAE,CAAC;aACT,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;aAC5B,QAAQ,CACP,sEAAsE;YACpE,gCAAgC,CACnC;KACJ,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,eAAe,EAAE,SAAS,EAAE,EAAE,EAAE;QAC3C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,qBAAqB,EAAE,YAAY,EAAE;gBAClE,eAAe;gBACf,SAAS;aACV,CAAC,CAAC;YACH,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC1E,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GACX,GAAG,YAAY,eAAe;gBAC5B,CAAC,CAAC,GAAG,CAAC,OAAO;gBACb,CAAC,CAAC,GAAG,YAAY,KAAK;oBACpB,CAAC,CAAC,GAAG,CAAC,OAAO;oBACb,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACpB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAChF,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"workflowMutations.js","sourceRoot":"","sources":["../../src/tools/workflowMutations.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axonity-ai/mcp",
-  "version": "0.1.0",
+  "version": "0.2.2",
   "description": "Model Context Protocol server for Axonity Flow — lets an external agent (e.g. Claude Code) read, draft, and update workflows, agents and tools in an Axonity tenant.",
   "license": "MIT",
   "repository": {