@axonity-ai/mcp 0.1.0 → 0.3.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,75 @@ 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, 
+    /**
+     * The read-back tool for this link, when one exists. A 200 here does not
+     * prove the link resolved, so the description points at the tool that does —
+     * agent-scoped links have one, `skill → workflow` has no list route.
+     */
+    readBack) => {
+        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.` +
+            (readBack
+                ? ` Verify it landed with \`${readBack}\` before request_publish_${target} — ` +
+                    `the link lives outside the entity body, so re-reading the ${target} will ` +
+                    `not show 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.` +
+            (readBack ? ` Confirm what is left with \`${readBack}\`.` : ""), 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", "list_agent_skills");
+    // No read-back for the workflow-scoped variant: the backend has no
+    // GET /workflows/{id}/skills-v2, so there is nothing to point at.
+    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", "list_agent_policies");
+    // 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", "list_agent_reference_docs");
+    /**
+     * The read side of the links above. `attach_*`/`detach_*` write a link but
+     * return nothing you can list later, so these are how an agent verifies a
+     * link landed — and how it reads a source agent's wiring to reproduce it as
+     * new. All three are plain GETs, safe for read-only tokens.
+     */
+    const listLinks = (subject, plural, path) => {
+        server.tool(`list_agent_${plural}`, `List the ${subject} currently scoped to an agent — the read-back for ` +
+            `attach_${subject}_to_agent. Use it to confirm a link took, or to read a ` +
+            `source agent's wiring before recreating it. Read-only.`, { agentId: z.string().describe("The agent's id.") }, async ({ agentId }) => guard(async () => jsonResult(await client.get(path(agentId)))));
+    };
+    listLinks("skill", "skills", (id) => `/api/v1/agents/${id}/skills-v2`);
+    listLinks("policy", "policies", (id) => `/api/v1/agents/${id}/policies`);
+    listLinks("reference_doc", "reference_docs", (id) => `/api/v1/agents/${id}/reference-docs`);
+}
+/**
+ * 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":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,UAAU,oBAAoB,CAClC,MAAiB,EACjB,MAAqB;IAErB,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,8EAA8E;QAC5E,sCAAsC,EACxC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,EACnD,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CACpB,KAAK,CAAC,KAAK,IAAI,EAAE,CACf,UAAU,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,kBAAkB,OAAO,UAAU,CAAC,CAAC,CAClE,CACJ,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB,0EAA0E,EAC1E;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAC/C,MAAM,EAAE,CAAC;aACN,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;aACnB,QAAQ,CAAC,6DAA6D,CAAC;KAC3E,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAC5B,KAAK,CAAC,KAAK,IAAI,EAAE,CACf,UAAU,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,kBAAkB,OAAO,UAAU,EAAE,MAAM,CAAC,CAAC,CAC3E,CACJ,CAAC;IAEF,yEAAyE;IACzE,+EAA+E;IAC/E,6EAA6E;IAC7E,4EAA4E;IAC5E,6DAA6D;AAC/D,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,MAAiB,EACjB,MAAqB;IAErB,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,yEAAyE;QACvE,iFAAiF,EACnF;QACE,MAAM,EAAE,CAAC;aACN,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;aACnB,QAAQ,CAAC,mEAAmE,CAAC;KACjF,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CACnB,KAAK,CAAC,KAAK,IAAI,EAAE;QACf,4BAA4B,CAAC,MAAM,CAAC,CAAC;QACrC,OAAO,UAAU,CACf,MAAM,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,MAAM,EAAE,CAAC,CACrE,CAAC;IACJ,CAAC,CAAC,CACL,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,+EAA+E;QAC7E,gDAAgD,EAClD;QACE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;QACnD,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;QAC/E,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC;KACxE,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,eAAe,EAAE,MAAM,EAAE,EAAE,EAAE,CACxC,KAAK,CAAC,KAAK,IAAI,EAAE;QACf,4BAA4B,CAAC,MAAM,CAAC,CAAC;QACrC,OAAO,UAAU,CACf,MAAM,MAAM,CAAC,GAAG,CAAC,iBAAiB,EAAE,EAAE,EAAE;YACtC,eAAe;YACf,IAAI,EAAE,WAAW;YACjB,GAAG,MAAM;SACV,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CACL,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAAiB,EACjB,MAAqB;IAErB;;;;OAIG;IACH,MAAM,IAAI,GAAG,CACX,OAAe,EACf,MAAc,EACd,IAAsC,EACtC,QAAgB,EAChB,SAAiB;IACjB;;;;OAIG;IACH,QAAiB,EACjB,EAAE;QACF,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QAElE,MAAM,CAAC,IAAI,CACT,UAAU,OAAO,OAAO,MAAM,EAAE,EAChC,WAAW,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,SAAS,MAAM,WAAW,MAAM,WAAW;YAC7E,CAAC,QAAQ;gBACP,CAAC,CAAC,4BAA4B,QAAQ,6BAA6B,MAAM,KAAK;oBAC5E,6DAA6D,MAAM,QAAQ;oBAC3E,cAAc;gBAChB,CAAC,CAAC,EAAE,CAAC,EACT,KAAK,EACL,KAAK,EAAE,IAA4B,EAAE,EAAE,CACrC,KAAK,CAAC,KAAK,IAAI,EAAE,CACf,UAAU,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CACrE,CACJ,CAAC;QAEF,MAAM,CAAC,IAAI,CACT,UAAU,OAAO,SAAS,MAAM,EAAE,EAClC,aAAa,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,WAAW,MAAM,cAAc;YACnE,0BAA0B,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,yBAAyB;YAC5E,0CAA0C;YAC1C,CAAC,QAAQ,CAAC,CAAC,CAAC,gCAAgC,QAAQ,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EACjE,KAAK,EACL,KAAK,EAAE,IAA4B,EAAE,EAAE,CACrC,KAAK,CAAC,KAAK,IAAI,EAAE;YACf,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YACxD,OAAO,UAAU,CAAC;gBAChB,QAAQ,EAAE,IAAI;gBACd,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC;gBAC1B,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC;aAC7B,CAAC,CAAC;QACL,CAAC,CAAC,CACL,CAAC;IACJ,CAAC,CAAC;IAEF,IAAI,CACF,OAAO,EACP,OAAO,EACP,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,kBAAkB,OAAO,cAAc,OAAO,EAAE,EACtE,SAAS,EACT,SAAS,EACT,mBAAmB,CACpB,CAAC;IACF,mEAAmE;IACnE,kEAAkE;IAClE,IAAI,CACF,OAAO,EACP,UAAU,EACV,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC,qBAAqB,UAAU,cAAc,OAAO,EAAE,EAC/E,YAAY,EACZ,SAAS,CACV,CAAC;IACF,IAAI,CACF,QAAQ,EACR,OAAO,EACP,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,CAAC,kBAAkB,OAAO,aAAa,QAAQ,EAAE,EACvE,SAAS,EACT,UAAU,EACV,qBAAqB,CACtB,CAAC;IACF,qEAAqE;IACrE,uEAAuE;IACvE,IAAI,CACF,WAAW,EACX,OAAO,EACP,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,kBAAkB,OAAO,mBAAmB,KAAK,EAAE,EACvE,SAAS,EACT,OAAO,EACP,2BAA2B,CAC5B,CAAC;IAEF;;;;;OAKG;IACH,MAAM,SAAS,GAAG,CAChB,OAAe,EACf,MAAc,EACd,IAAiC,EACjC,EAAE;QACF,MAAM,CAAC,IAAI,CACT,cAAc,MAAM,EAAE,EACtB,YAAY,OAAO,oDAAoD;YACrE,UAAU,OAAO,yDAAyD;YAC1E,wDAAwD,EAC1D,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,EACnD,KAAK,EAAE,EAAE,OAAO,EAAuB,EAAE,EAAE,CACzC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CACjE,CAAC;IACJ,CAAC,CAAC;IAEF,SAAS,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAC;IACvE,SAAS,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,kBAAkB,EAAE,WAAW,CAAC,CAAC;IACzE,SAAS,CACP,eAAe,EACf,gBAAgB,EAChB,CAAC,EAAE,EAAE,EAAE,CAAC,kBAAkB,EAAE,iBAAiB,CAC9C,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,MAAqB;IAC3E,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,4EAA4E;QAC1E,2EAA2E;QAC3E,sCAAsC,EACxC,EAAE,EACF,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,CAAC,CACpF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,YAAY,EACZ,uEAAuE;QACrE,oEAAoE;QACpE,uEAAuE;QACvE,qEAAqE;QACrE,oEAAoE,EACtE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,EACjD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CACnB,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,iBAAiB,MAAM,QAAQ,CAAC,CAAC,CAAC,CACpF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB,0DAA0D,EAC1D,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC,EAAE,EAC9D,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CACtB,KAAK,CAAC,KAAK,IAAI,EAAE,CACf,UAAU,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,2BAA2B,SAAS,QAAQ,CAAC,CAAC,CAC5E,CACJ,CAAC;AACJ,CAAC"}

package/dist/tools/promptPlacement.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Prompt-element placement — where a prompt snippet actually takes effect.
+ *
+ * A snippet (the `prompt_snippet` entity) is a LIBRARY item: creating it does
+ * nothing on its own. It only shapes a run once it is PLACED into a flow step's
+ * prompt stack — in the `system` or `user` channel, at a chosen order — or made
+ * a tenant-wide "wildcard" that sits at the top of every step's stack.
+ *
+ * These tools wrap the placement routes in the backend's `prompt_snippets.py`.
+ * The snippet CRUD itself is the generic `*_prompt_snippet` entity family; this
+ * module is only the linking layer that the generic registrar can't express.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AxonityClient } from "../client.js";
+export declare function registerPromptPlacementTools(server: McpServer, client: AxonityClient): void;

package/dist/tools/promptPlacement.js

@@ -0,0 +1,99 @@
+/**
+ * Prompt-element placement — where a prompt snippet actually takes effect.
+ *
+ * A snippet (the `prompt_snippet` entity) is a LIBRARY item: creating it does
+ * nothing on its own. It only shapes a run once it is PLACED into a flow step's
+ * prompt stack — in the `system` or `user` channel, at a chosen order — or made
+ * a tenant-wide "wildcard" that sits at the top of every step's stack.
+ *
+ * These tools wrap the placement routes in the backend's `prompt_snippets.py`.
+ * The snippet CRUD itself is the generic `*_prompt_snippet` entity family; this
+ * module is only the linking layer that the generic registrar can't express.
+ */
+import { z } from "zod";
+import { guard, jsonResult } from "./result.js";
+/** The two prompt channels a snippet can be placed in. */
+const TARGET = z
+    .enum(["system", "user"])
+    .describe("Which prompt channel to place the snippet in: 'system' (instructions the " +
+    "model is steered by) or 'user' (content presented as the user turn).");
+export function registerPromptPlacementTools(server, client) {
+    server.tool("list_flow_step_prompts", "List the prompt snippets attached to a flow step — its `system` and `user` " +
+        "prompt stacks, each entry with its link id and display order. This is how " +
+        "you see a step's current prompt composition before changing it. Excludes " +
+        "wildcard snippets (see list_wildcard_prompts). Read-only.", { flowStepId: z.string().describe("The flow step's id.") }, async ({ flowStepId }) => guard(async () => jsonResult(await client.get(`/api/v1/flow-steps/${flowStepId}/prompts`))));
+    server.tool("attach_prompt_snippet_to_flow_step", "Place a library prompt snippet into a flow step's prompt stack. Choose the " +
+        "channel (`target`: system/user) and its order in that channel. This is " +
+        "what makes a snippet actually shape the step's prompt — creating the " +
+        "snippet alone does nothing. Returns the created link (with its linkId) so " +
+        "you can reorder or detach it later.", {
+        flowStepId: z.string().describe("The flow step's id."),
+        snippetId: z.string().describe("The prompt snippet's id (a UUID)."),
+        target: TARGET,
+        displayOrder: z
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .describe("Position within the chosen channel (0 = first). Defaults to 0."),
+    }, async ({ flowStepId, snippetId, target, displayOrder }) => guard(async () => jsonResult(await client.post(`/api/v1/flow-steps/${flowStepId}/prompts`, {
+        snippetId,
+        target,
+        ...(displayOrder === undefined ? {} : { displayOrder }),
+    }))));
+    server.tool("update_flow_step_prompt", "Change an existing flow-step prompt attachment: move it between the system " +
+        "and user channel, and/or change its display order. Identify it by its " +
+        "linkId (from list_flow_step_prompts or the attach response), NOT the " +
+        "snippet id. Send only what you are changing.", {
+        linkId: z.string().describe("The attachment's link id (not the snippet id)."),
+        target: z
+            .enum(["system", "user"])
+            .optional()
+            .describe("New channel. Omit to leave it unchanged."),
+        displayOrder: z
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .describe("New position in its channel. Omit to leave it unchanged."),
+    }, async ({ linkId, target, displayOrder }) => guard(async () => {
+        const body = {};
+        if (target !== undefined)
+            body.target = target;
+        if (displayOrder !== undefined)
+            body.displayOrder = displayOrder;
+        return jsonResult(await client.patch(`/api/v1/flow-step-prompts/${linkId}`, body));
+    }));
+    server.tool("reorder_flow_step_prompts", "Set the full ordering of a flow step's prompt snippets in one call. Pass the " +
+        "snippet ids in the order you want them; the backend replaces the step's " +
+        "ordering with this list. Read the step first (list_flow_step_prompts) so " +
+        "you include every snippet — omitting one is a reorder, not a safe no-op.", {
+        flowStepId: z.string().describe("The flow step's id."),
+        snippetIds: z
+            .array(z.string())
+            .min(1)
+            .max(512)
+            .describe("Snippet ids (UUIDs) in the desired order."),
+    }, async ({ flowStepId, snippetIds }) => guard(async () => jsonResult(await client.put(`/api/v1/flow-steps/${flowStepId}/prompts/order`, {
+        snippetIds,
+    }))));
+    server.tool("detach_prompt_snippet_from_flow_step", "Remove a prompt snippet from a flow step's stack. This only unlinks it — the " +
+        "snippet itself is not deleted and stays available to place elsewhere. " +
+        "Identify the link by its linkId (from list_flow_step_prompts).", { linkId: z.string().describe("The attachment's link id (not the snippet id).") }, async ({ linkId }) => guard(async () => {
+        await client.del(`/api/v1/flow-step-prompts/${linkId}`);
+        return jsonResult({ detached: true, linkId });
+    }));
+    server.tool("read_workflow_prompt_stacks", "Resolve a workflow to its flow steps and each step's prompt stack in one " +
+        "read: per step you get its flowStepId, name, and its system/user prompt " +
+        "snippets (with link ids and order). This is how you discover the " +
+        "flowStepIds you need before placing prompts, and how you see a workflow's " +
+        "whole prompt composition. Read-only.", { workflowId: z.string().describe("The workflow's id.") }, async ({ workflowId }) => guard(async () => jsonResult(await client.get(`/api/v1/workflows/${workflowId}/prompt-stacks`))));
+    server.tool("read_flow_prompt_stacks", "The flow-scoped counterpart of read_workflow_prompt_stacks: resolve a flow " +
+        "to its steps and their system/user prompt stacks (flowStepId, link ids, " +
+        "order). Read-only.", { flowId: z.string().describe("The flow's id.") }, async ({ flowId }) => guard(async () => jsonResult(await client.get(`/api/v1/flows/${flowId}/prompt-stacks`))));
+    server.tool("list_wildcard_prompts", "List the tenant's wildcard prompt snippets — those that apply to EVERY flow " +
+        "step (they sit at the top of each step's prompt stack). Use this for " +
+        "cross-cutting instructions that should hold everywhere, rather than " +
+        "attaching the same snippet to every step by hand. Read-only.", {}, async () => guard(async () => jsonResult(await client.get("/api/v1/wildcard-prompts"))));
+}
+//# sourceMappingURL=promptPlacement.js.map

package/dist/tools/promptPlacement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptPlacement.js","sourceRoot":"","sources":["../../src/tools/promptPlacement.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,56 @@ 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 `request_publish_<entity>` is generated. Default true, and true for
+     * every current entity: all ten (flow included) are valid `entityType`s for a
+     * publish approval on the backend (`ApprovalEntityType`). Set false only for a
+     * future entity that genuinely cannot be publish-approved.
+     */
+    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, and true for every
+     * current entity — `prompt_snippet` does have a single-read route
+     * (`GET /api/v1/prompt-snippets/{id}`). Kept as an escape hatch for a future
+     * entity with 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, and true for every current entity — both `flow` and
+     * `prompt_snippet` have a discard-draft route
+     * (`POST .../{id}/discard-draft`). Escape hatch for a future entity lacking one.
+     */
+    hasDiscardDraft?: boolean;
+    /**
+     * How to list soft-deleted rows. `"collection"` (default) is `GET
+     * <basePath>/deleted` and is what every current entity uses, `prompt_snippet`
+     * included (`GET /api/v1/prompt-snippets/deleted`). `"query"` (`?deleted=true`
+     * on the main list) is retained for a future entity that needs it.
+     */
+    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;