@monnet/mcp 0.4.1 → 0.7.0

package/dist/rendering/plan.js

@@ -0,0 +1,85 @@
+/**
+ * Plan rendering — the one place that knows the shape of a motion's plan.
+ *
+ * A plan is a tree (V2) : each item is either a step (one assignee, a
+ * step_type) or a group holding children, run in parallel or in sequence.
+ * Older motions still hold the flat V1 shape (`assignees[]`, `approval`), so
+ * both are read here and rendered the same way — a reader that walked only the
+ * top level printed `undefined` for a group and never showed the steps inside
+ * it, which is exactly the state the people on those steps needed to see.
+ *
+ * Numbering is hierarchical and 1-based (`1.`, `1.1.`, `1.2.`) because it is
+ * also the address a client passes back to `approve` / `reject`.
+ */
+const STATUS_ICONS = {
+    pending: "⏳",
+    in_progress: "🔄",
+    done: "✅",
+    skipped: "⏭️",
+};
+export function isGroup(item) {
+    return item.kind === "group" || Array.isArray(item.children);
+}
+/** True when the plan uses the tree shape — one `kind` is enough to tell. */
+export function isTreePlan(plan) {
+    return (Array.isArray(plan) &&
+        plan.some((item) => item && typeof item === "object" && "kind" in item));
+}
+/** The single assignee of a step, reading both shapes. */
+function assigneeOf(step) {
+    if (step.assignee)
+        return step.assignee;
+    return (step.assignees || []).find((a) => a) || null;
+}
+/** Non-task types worth naming; `approval` keeps its lock, as it always had. */
+function typeSuffix(step) {
+    const type = step.step_type || (step.approval ? "approval" : "task");
+    if (type === "approval")
+        return " 🔒";
+    return type === "task" ? "" : ` [${type}]`;
+}
+function renderStep(step, label, indent, nameMap) {
+    const icon = STATUS_ICONS[step.status] || "⏳";
+    const assignee = assigneeOf(step);
+    const assigneeStr = assignee ? `  → ${nameMap.get(assignee) || assignee}` : "";
+    const due = step.due_date ? `  (due ${step.due_date})` : "";
+    return `${indent}${label}. ${icon}  ${step.content}${assigneeStr}${typeSuffix(step)}${due}`;
+}
+/**
+ * One line per item, children indented under their group. `prefix` carries the
+ * parent's number so a child reads `1.2.`; `depth` only drives indentation.
+ */
+export function renderPlanItems(items, nameMap, prefix = "", depth = 0) {
+    const indent = "  ".repeat(depth + 1);
+    const lines = [];
+    items.forEach((item, i) => {
+        const label = `${prefix}${i + 1}`;
+        if (isGroup(item)) {
+            lines.push(`${indent}${label}. 📂  ${item.title}  (${item.execution})`);
+            lines.push(...renderPlanItems(item.children || [], nameMap, `${label}.`, depth + 1));
+        }
+        else {
+            lines.push(renderStep(item, label, indent, nameMap));
+        }
+    });
+    return lines;
+}
+/**
+ * The reverse of the numbering above : turn the label a client read in
+ * `get_motion` ("1.2") into the 0-based index path the API addresses a step
+ * with ([0, 1]). Kept beside the renderer on purpose — the label format and
+ * its parser are one convention, and they drift apart the moment they live in
+ * two files.
+ */
+export function parsePlanPath(label) {
+    const trimmed = label.trim().replace(/\.$/, "");
+    if (!/^\d+(\.\d+)*$/.test(trimmed)) {
+        throw new Error(`Invalid step path "${label}". Use the number shown in get_motion, e.g. "2" for a top-level step or "1.2" for the second step of the first group.`);
+    }
+    const path = trimmed.split(".").map((part) => Number(part) - 1);
+    if (path.some((index) => index < 0)) {
+        throw new Error(`Invalid step path "${label}". Step numbers start at 1.`);
+    }
+    return path;
+}
+//# sourceMappingURL=plan.js.map

package/dist/rendering/plan.js.map

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

package/dist/tool-result.d.ts

@@ -0,0 +1,20 @@
+/**
+ * What a tool handler may hand back.
+ *
+ * It was `string` until a tool had to return an image: a screenshot attached to
+ * a motion is the one thing whose description is worth less than the thing
+ * itself. Every other handler keeps returning a plain string and is untouched —
+ * `toContentBlocks` is what makes both shapes reach the client the same way.
+ */
+export type ToolTextBlock = {
+    type: "text";
+    text: string;
+};
+export type ToolImageBlock = {
+    type: "image";
+    data: string;
+    mimeType: string;
+};
+export type ToolContent = ToolTextBlock | ToolImageBlock;
+export type ToolResult = string | ToolContent[];
+export declare function toContentBlocks(result: ToolResult): ToolContent[];

package/dist/tool-result.js

@@ -0,0 +1,12 @@
+/**
+ * What a tool handler may hand back.
+ *
+ * It was `string` until a tool had to return an image: a screenshot attached to
+ * a motion is the one thing whose description is worth less than the thing
+ * itself. Every other handler keeps returning a plain string and is untouched —
+ * `toContentBlocks` is what makes both shapes reach the client the same way.
+ */
+export function toContentBlocks(result) {
+    return typeof result === "string" ? [{ type: "text", text: result }] : result;
+}
+//# sourceMappingURL=tool-result.js.map

package/dist/tool-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result.js","sourceRoot":"","sources":["../src/tool-result.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,MAAM,UAAU,eAAe,CAAC,MAAkB;IAChD,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AAChF,CAAC"}

package/dist/tools/approve.d.ts

@@ -13,10 +13,9 @@ export declare const APPROVE_TOOL_DEFINITION: {
                 type: string;
                 description: string;
             };
-            step_index: {
+            step_path: {
                 type: string;
                 description: string;
-                minimum: number;
             };
         };
         required: string[];

package/dist/tools/approve.js

@@ -1,22 +1,22 @@
 import { z } from "zod";
 import { apiFetch, resolveWorkspaceId } from "../client.js";
+import { parsePlanPath } from "../rendering/plan.js";
 const ApproveArgs = z.object({
     workspace_slug: z.string().min(1),
     motion_short_id: z.string().min(1),
-    step_index: z.number().int().min(0),
+    step_path: z.string().min(1),
 });
 export async function handleApprove(args) {
-    const { workspace_slug, motion_short_id, step_index } = ApproveArgs.parse(args);
+    const { workspace_slug, motion_short_id, step_path } = ApproveArgs.parse(args);
     const wsId = await resolveWorkspaceId(workspace_slug);
-    const result = await apiFetch(`/workspaces/${wsId}/motions/${encodeURIComponent(motion_short_id)}/plan/steps/${step_index}/approve`, { method: "POST" });
-    return result.ok
-        ? `Step ${step_index} approved. Plan now has ${result.plan.length} step(s).`
-        : "Approval failed.";
+    const path = parsePlanPath(step_path);
+    const result = await apiFetch(`/workspaces/${wsId}/motions/${encodeURIComponent(motion_short_id)}/plan/approve`, { method: "POST", body: JSON.stringify({ path }) });
+    return result.ok ? `Step ${step_path} approved.` : "Approval failed.";
 }
 export const APPROVE_TOOL_DEFINITION = {
     name: "approve",
     description: "Approve a plan step on a motion. Requires editor role on the motion. " +
-        "Use get_motion first to see the plan and identify the step_index (0-based).",
+        "Use get_motion first to see the plan and read the step's number.",
     inputSchema: {
         type: "object",
         properties: {
@@ -28,13 +28,12 @@ export const APPROVE_TOOL_DEFINITION = {
                 type: "string",
                 description: "The first 8 characters of the motion UUID.",
             },
-            step_index: {
-                type: "integer",
-                description: "0-based index of the plan step to approve.",
-                minimum: 0,
+            step_path: {
+                type: "string",
+                description: "The step's number as get_motion prints it: \"2\" for a top-level step, \"1.2\" for the second step inside the first group.",
             },
         },
-        required: ["workspace_slug", "motion_short_id", "step_index"],
+        required: ["workspace_slug", "motion_short_id", "step_path"],
     },
 };
 //# sourceMappingURL=approve.js.map

package/dist/tools/approve.js.map

@@ -1 +1 @@
-{"version":3,"file":"approve.js","sourceRoot":"","sources":["../../src/tools/approve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAE5D,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAClC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACpC,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAa;IAC/C,MAAM,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChF,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,cAAc,CAAC,CAAC;IAEtD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAC3B,eAAe,IAAI,YAAY,kBAAkB,CAAC,eAAe,CAAC,eAAe,UAAU,UAAU,EACrG,EAAE,MAAM,EAAE,MAAM,EAAE,CACnB,CAAC;IAEF,OAAO,MAAM,CAAC,EAAE;QACd,CAAC,CAAC,QAAQ,UAAU,2BAA2B,MAAM,CAAC,IAAI,CAAC,MAAM,WAAW;QAC5E,CAAC,CAAC,kBAAkB,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,SAAS;IACf,WAAW,EACT,uEAAuE;QACvE,6EAA6E;IAC/E,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,cAAc,EAAE;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qBAAqB;aACnC;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4CAA4C;aAC1D;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,4CAA4C;gBACzD,OAAO,EAAE,CAAC;aACX;SACF;QACD,QAAQ,EAAE,CAAC,gBAAgB,EAAE,iBAAiB,EAAE,YAAY,CAAC;KAC9D;CACF,CAAC"}
+{"version":3,"file":"approve.js","sourceRoot":"","sources":["../../src/tools/approve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAClC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC7B,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAa;IAC/C,MAAM,EAAE,cAAc,EAAE,eAAe,EAAE,SAAS,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/E,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,cAAc,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IAEtC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAC3B,eAAe,IAAI,YAAY,kBAAkB,CAAC,eAAe,CAAC,eAAe,EACjF,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CACnD,CAAC;IAEF,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,SAAS,YAAY,CAAC,CAAC,CAAC,kBAAkB,CAAC;AACxE,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,SAAS;IACf,WAAW,EACT,uEAAuE;QACvE,kEAAkE;IACpE,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,cAAc,EAAE;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qBAAqB;aACnC;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4CAA4C;aAC1D;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,4HAA4H;aAC/H;SACF;QACD,QAAQ,EAAE,CAAC,gBAAgB,EAAE,iBAAiB,EAAE,WAAW,CAAC;KAC7D;CACF,CAAC"}

package/dist/tools/{create-motion.d.ts → create-thread.d.ts}

@@ -1,5 +1,5 @@
-export declare function handleCreateMotion(args: unknown): Promise<string>;
-export declare const CREATE_MOTION_TOOL_DEFINITION: {
+export declare function handleCreateThread(args: unknown): Promise<string>;
+export declare const CREATE_THREAD_TOOL_DEFINITION: {
     name: string;
     description: string;
     inputSchema: {

package/dist/tools/create-thread.js

@@ -0,0 +1,45 @@
+import { z } from "zod";
+import { apiFetch, resolveWorkspaceId } from "../client.js";
+const CreateThreadArgs = z.object({
+    workspace_slug: z.string().min(1),
+    // Trim first: a whitespace-only prompt passes min(1) but opens a thread with
+    // no opening message, and the background run then wakes on nothing.
+    prompt: z.string().trim().min(1).max(10000),
+});
+export async function handleCreateThread(args) {
+    const { workspace_slug, prompt } = CreateThreadArgs.parse(args);
+    const wsId = await resolveWorkspaceId(workspace_slug);
+    const motion = await apiFetch(`/workspaces/${wsId}/motions/generate`, {
+        method: "POST",
+        body: JSON.stringify({ prompt }),
+    });
+    return JSON.stringify({
+        id: motion.id,
+        short_id: motion.id.slice(0, 8),
+        summary: motion.summary,
+        status: motion.status,
+        url: `https://app.monnet.ai/${workspace_slug}/motions/${motion.id.slice(0, 8)}`,
+        note: "This is a thread, not a motion yet: Monnet is opening the conversation " +
+            "in the background and writes a doc only if the idea earns one. Call " +
+            "get_motion with the returned short_id to read what it has made of it.",
+    }, null, 2);
+}
+export const CREATE_THREAD_TOOL_DEFINITION = {
+    name: "create_thread",
+    description: "Open a new thread in a Monnet workspace from a free-form prompt. A thread is a pre-motion conversation: Monnet picks it up in the background and shapes the idea with the author, and it becomes a motion — a doc, a plan, people to coordinate — only when it earns one. Returns the thread's id and URL immediately; call `get_motion` with the returned short_id to read where it got to.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            workspace_slug: {
+                type: "string",
+                description: "The workspace slug (e.g. 'monnet-team-410b').",
+            },
+            prompt: {
+                type: "string",
+                description: "What the thread is about, in the user's own words plus any relevant context. Substance matters — Monnet reads it as the opening message of the conversation.",
+            },
+        },
+        required: ["workspace_slug", "prompt"],
+    },
+};
+//# sourceMappingURL=create-thread.js.map

package/dist/tools/create-thread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-thread.js","sourceRoot":"","sources":["../../src/tools/create-thread.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAE5D,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,6EAA6E;IAC7E,oEAAoE;IACpE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;CAC5C,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAa;IACpD,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChE,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,cAAc,CAAC,CAAC;IAEtD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAI1B,eAAe,IAAI,mBAAmB,EAAE;QACzC,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;KACjC,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC,SAAS,CACnB;QACE,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QAC/B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,GAAG,EAAE,yBAAyB,cAAc,YAAY,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;QAC/E,IAAI,EACF,yEAAyE;YACzE,sEAAsE;YACtE,uEAAuE;KAC1E,EACD,IAAI,EACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,IAAI,EAAE,eAAe;IACrB,WAAW,EACT,8XAA8X;IAChY,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,cAAc,EAAE;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+CAA+C;aAC7D;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8JAA8J;aAC5K;SACF;QACD,QAAQ,EAAE,CAAC,gBAAgB,EAAE,QAAQ,CAAC;KACvC;CACF,CAAC"}

package/dist/tools/get-inbox.d.ts

@@ -5,6 +5,15 @@ export declare const GET_INBOX_TOOL_DEFINITION: {
     inputSchema: {
         type: "object";
         properties: {
+            workspace_slug: {
+                type: string;
+                description: string;
+            };
+            tag: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
             page: {
                 type: string;
                 description: string;

package/dist/tools/get-inbox.js

@@ -1,25 +1,36 @@
 import { z } from "zod";
-import { apiFetch } from "../client.js";
+import { apiFetch, resolveWorkspaceId } from "../client.js";
 import { renderInbox } from "../rendering/inbox.js";
 const GetInboxArgs = z.object({
+    workspace_slug: z.string().min(1).optional(),
+    tag: z.enum(["priority", "active"]).optional(),
     page: z.number().int().min(1).optional(),
     limit: z.number().int().min(1).max(50).optional(),
 });
 export async function handleGetInbox(args) {
-    const parsed = GetInboxArgs.parse(args);
-    const page = parsed.page ?? 1;
-    const limit = parsed.limit ?? 10;
+    const { workspace_slug, tag, page: rawPage, limit } = GetInboxArgs.parse(args);
+    const page = rawPage ?? 1;
     const params = new URLSearchParams({
         page: String(page),
-        limit: String(limit),
+        // `pageSize`, camelCase, because that is the query parameter the route
+        // declares — `limit` was silently ignored and every call came back with
+        // the default page size.
+        pageSize: String(limit ?? 10),
     });
-    const data = await apiFetch(`/motions/for-you?${params.toString()}`);
+    if (tag)
+        params.set("tag", tag);
+    // The route scopes by workspace id, not by slug. Resolving here is also what
+    // turns an unknown slug into a clear 404 about the slug, instead of a feed
+    // that quietly spans every workspace.
+    if (workspace_slug)
+        params.set("workspace_id", await resolveWorkspaceId(workspace_slug));
+    const data = await apiFetch(`/motions/inbox?${params.toString()}`);
     return renderInbox({
-        total: data.total,
         page,
-        motions: data.motions.map((m) => ({
+        counts: data.counts ?? {},
+        motions: (data.motions ?? []).map((m) => ({
             short_id: m.id.slice(0, 8),
-            summary: m.summary,
+            summary: m.summary || m.prompt,
             status: m.status,
             priority: m.priority,
             workspace: m.workspace_name,
@@ -27,25 +38,36 @@ export async function handleGetInbox(args) {
             last_activity: m.last_activity_summary,
             last_activity_at: m.last_activity_at,
             is_unread: m.is_unread,
+            tag: m.tag,
         })),
     });
 }
 export const GET_INBOX_TOOL_DEFINITION = {
     name: "get_inbox",
-    description: "Fetch the user's 'For You' feed — motions across all their workspaces that need attention " +
-        "(pending approvals, unread activity, assigned steps). Use this when the user asks " +
-        "'what's on my plate', 'what needs my attention', or similar.",
+    description: "Fetch the user's inbox — the motions they follow, in two buckets: 'priority' is what is waiting on them " +
+        "(an open motion with a step assigned to them, not yet dismissed), 'active' is everything else they follow. " +
+        "Spans every workspace unless one is named. Use this when the user asks 'what's on my plate', " +
+        "'what needs my attention', or similar.",
     inputSchema: {
         type: "object",
         properties: {
+            workspace_slug: {
+                type: "string",
+                description: "Limit the inbox to one workspace (e.g. 'monnet-team-410b'). Omit for every workspace the user belongs to.",
+            },
+            tag: {
+                type: "string",
+                enum: ["priority", "active"],
+                description: "Return only one bucket, which is also how you page through it. Omit for the first page of both.",
+            },
             page: {
                 type: "integer",
-                description: "Page number (1-based). Default: 1.",
+                description: "Page number (1-based). Default: 1. Only meaningful together with `tag`.",
                 minimum: 1,
             },
             limit: {
                 type: "integer",
-                description: "Number of motions per page (1-50). Default: 10.",
+                description: "Motions per bucket (1-50). Default: 10.",
                 minimum: 1,
                 maximum: 50,
             },

package/dist/tools/get-inbox.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-inbox.js","sourceRoot":"","sources":["../../src/tools/get-inbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACxC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;CAClD,CAAC,CAAC;AAmBH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAa;IAChD,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IAEjC,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QACjC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;KACrB,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAiB,oBAAoB,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAErF,OAAO,WAAW,CAAC;QACjB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI;QACJ,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAChC,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;YAC1B,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,SAAS,EAAE,CAAC,CAAC,cAAc;YAC3B,cAAc,EAAE,CAAC,CAAC,cAAc;YAChC,aAAa,EAAE,CAAC,CAAC,qBAAqB;YACtC,gBAAgB,EAAE,CAAC,CAAC,gBAAgB;YACpC,SAAS,EAAE,CAAC,CAAC,SAAS;SACvB,CAAC,CAAC;KACJ,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,IAAI,EAAE,WAAW;IACjB,WAAW,EACT,4FAA4F;QAC5F,oFAAoF;QACpF,8DAA8D;IAChE,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,oCAAoC;gBACjD,OAAO,EAAE,CAAC;aACX;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,iDAAiD;gBAC9D,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,EAAE;aACZ;SACF;QACD,QAAQ,EAAE,EAAE;KACb;CACF,CAAC"}
+{"version":3,"file":"get-inbox.js","sourceRoot":"","sources":["../../src/tools/get-inbox.ts"],"names":[],"mappings":"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"}

package/dist/tools/get-motion.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { apiFetch, resolveWorkspaceId } from "../client.js";
+import { fetchMotionDetail, motionFiles } from "../motion-detail.js";
 import { renderMotionDetail } from "../rendering/motion.js";
 const GetMotionArgs = z.object({
     workspace_slug: z.string().min(1),
@@ -7,9 +7,8 @@ const GetMotionArgs = z.object({
 });
 export async function handleGetMotion(args) {
     const { workspace_slug, motion_short_id } = GetMotionArgs.parse(args);
-    const wsId = await resolveWorkspaceId(workspace_slug);
-    const detail = await apiFetch(`/workspaces/${wsId}/motions/${encodeURIComponent(motion_short_id)}/detail`);
-    const { motion, workspace_name, members, motion_members, messages } = detail;
+    const fetched = await fetchMotionDetail(workspace_slug, motion_short_id);
+    const { motion, workspace_name, members, motion_members, messages } = fetched.detail;
     return renderMotionDetail({
         id: motion.id,
         summary: motion.summary,
@@ -23,13 +22,14 @@ export async function handleGetMotion(args) {
         workspace: workspace_name,
         members: members.map((m) => ({ user_id: m.user_id, name: m.name, role: m.role, function: m.function })),
         motion_members: motion_members.map((mm) => ({ user_id: mm.user_id, role: mm.role })),
+        files: motionFiles(fetched),
         messages: messages || [],
     });
 }
 export const GET_MOTION_TOOL_DEFINITION = {
     name: "get_motion",
     description: "Read a Monnet motion's full details — summary, body, status, priority, plan steps with assignees, member roles, " +
-        "and threaded comments (each comment shows a short id usable as parent_id in the comment tool to reply in its thread). " +
+        "threaded comments (each comment shows a short id usable as parent_id in the comment tool to reply in its thread), and the files attached to it, each with the id read_motion_file takes. " +
         "Call this when the user references a specific motion by its short id or URL.",
     inputSchema: {
         type: "object",

package/dist/tools/get-motion.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-motion.js","sourceRoot":"","sources":["../../src/tools/get-motion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACnC,CAAC,CAAC;AA4BH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAa;IACjD,MAAM,EAAE,cAAc,EAAE,eAAe,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEtE,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,cAAc,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAC3B,eAAe,IAAI,YAAY,kBAAkB,CAAC,eAAe,CAAC,SAAS,CAC5E,CAAC;IAEF,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAE7E,OAAO,kBAAkB,CAAC;QACxB,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAW;QACxB,MAAM,EAAE,MAAM,CAAC,WAAW;QAC1B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,SAAS,EAAE,cAAc;QACzB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC5G,cAAc,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QACpF,QAAQ,EAAE,QAAQ,IAAI,EAAE;KACzB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,kHAAkH;QAClH,wHAAwH;QACxH,8EAA8E;IAChF,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,cAAc,EAAE;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,iHAAiH;aACpH;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uEAAuE;aACrF;SACF;QACD,QAAQ,EAAE,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;KAChD;CACF,CAAC"}
+{"version":3,"file":"get-motion.js","sourceRoot":"","sources":["../../src/tools/get-motion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACnC,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAa;IACjD,MAAM,EAAE,cAAc,EAAE,eAAe,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEtE,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;IACzE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAErF,OAAO,kBAAkB,CAAC;QACxB,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAW;QACxB,MAAM,EAAE,MAAM,CAAC,WAAW;QAC1B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,SAAS,EAAE,cAAc;QACzB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC5G,cAAc,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QACpF,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC;QAC3B,QAAQ,EAAE,QAAQ,IAAI,EAAE;KACzB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,kHAAkH;QAClH,2LAA2L;QAC3L,8EAA8E;IAChF,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,cAAc,EAAE;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,iHAAiH;aACpH;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uEAAuE;aACrF;SACF;QACD,QAAQ,EAAE,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;KAChD;CACF,CAAC"}

package/dist/tools/list-workspaces.js

@@ -13,7 +13,7 @@ export async function handleListWorkspaces() {
 export const LIST_WORKSPACES_TOOL_DEFINITION = {
     name: "list_workspaces",
     description: "List all Monnet workspaces you are a member of. Returns the workspace name and slug " +
-        "needed by other tools (get_motion, list_motions, create_motion, etc.). " +
+        "needed by other tools (get_motion, list_motions, create_thread, etc.). " +
         "Call this first if you don't know the workspace slug.",
     inputSchema: {
         type: "object",

package/dist/tools/read-motion-file.d.ts

@@ -0,0 +1,28 @@
+import type { ToolResult } from "../tool-result.js";
+export declare function handleReadMotionFile(args: unknown): Promise<ToolResult>;
+export declare const READ_MOTION_FILE_TOOL_DEFINITION: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            workspace_slug: {
+                type: string;
+                description: string;
+            };
+            motion_short_id: {
+                type: string;
+                description: string;
+            };
+            file_id: {
+                type: string;
+                description: string;
+            };
+            filename: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};

package/dist/tools/read-motion-file.js

@@ -0,0 +1,131 @@
+import { z } from "zod";
+import { apiFetch, MonnetApiError } from "../client.js";
+import { fetchMotionDetail, motionFiles } from "../motion-detail.js";
+import { humanSize } from "../rendering/motion.js";
+const ReadMotionFileArgs = z.object({
+    workspace_slug: z.string().min(1),
+    motion_short_id: z.string().min(1),
+    file_id: z.string().min(1).optional(),
+    filename: z.string().min(1).optional(),
+});
+export async function handleReadMotionFile(args) {
+    const { workspace_slug, motion_short_id, file_id, filename } = ReadMotionFileArgs.parse(args);
+    if (!file_id && !filename) {
+        return "Pass either file_id or filename. Both are listed under FILES in get_motion.";
+    }
+    const fetched = await fetchMotionDetail(workspace_slug, motion_short_id);
+    const files = motionFiles(fetched);
+    const target = resolve(files, file_id, filename);
+    // A string is the explanation of why no single file was meant; it is the
+    // tool's whole answer.
+    if (typeof target === "string")
+        return target;
+    const path = `/workspaces/${fetched.workspaceId}/motions/${fetched.detail.motion.id}/files/${target.id}/content`;
+    let content;
+    try {
+        content = await apiFetch(path);
+    }
+    catch (err) {
+        // A 404 here is ambiguous in a way the generic message gets wrong: the
+        // file was listed a moment ago, so either it has just been deleted or the
+        // backend predates this route — this client and the API are versioned and
+        // deployed apart. Either way "check the workspace slug" is bad advice.
+        if (err instanceof MonnetApiError && err.status === 404) {
+            return (`${target.filename} could not be read: it was just deleted, or this Monnet backend ` +
+                `does not support reading file contents yet. Open it at ${target.url}`);
+        }
+        throw err;
+    }
+    return render(content, target);
+}
+/**
+ * The one file the caller meant, or an explanation of why that is unclear.
+ *
+ * Nothing makes a motion's filenames unique — the upload path does not
+ * deduplicate them the way the workspace one does — so two attachments really
+ * can share a name. Picking the first, which is what the in-app agent does,
+ * means silently reading the wrong document; naming the ids instead hands the
+ * caller the way out, which is the reason `file_id` is accepted at all.
+ *
+ * Returns the message rather than throwing: nothing here crosses a module or
+ * an async boundary, so an exception would only be a longer way to return.
+ */
+function resolve(files, fileId, filename) {
+    if (!files.length)
+        return "This motion has no files attached.";
+    return fileId ? byId(files, fileId) : byName(files, filename);
+}
+function byId(files, fileId) {
+    return (files.find((f) => f.id === fileId) ??
+        `No file with id ${fileId} on this motion. Attached: ${listOf(files)}`);
+}
+function byName(files, filename) {
+    // Exact first: two files differing only in case are two files, and folding
+    // them together would report an ambiguity that does not exist. The
+    // case-insensitive pass is the fallback, for a name retyped from memory.
+    const exact = files.filter((f) => f.filename === filename);
+    const wanted = filename.toLowerCase();
+    const matches = exact.length ? exact : files.filter((f) => f.filename.toLowerCase() === wanted);
+    if (matches.length === 1)
+        return matches[0];
+    if (!matches.length) {
+        return `No file named "${filename}" on this motion. Attached: ${listOf(files)}`;
+    }
+    return (`${matches.length} files on this motion are named "${filename}". ` +
+        `Call again with one of these file_id values: ${matches.map((f) => f.id).join(", ")}`);
+}
+function listOf(files) {
+    return files.map((f) => f.filename).join(", ");
+}
+function render(content, file) {
+    const size = humanSize(content.size_bytes);
+    switch (content.kind) {
+        case "text":
+            return content.text?.trim() ? content.text : `${content.filename} is empty.`;
+        case "image":
+            // No data means the image is past the size the backend will inline. Its
+            // URL still opens for anyone on the motion, so say so rather than fail.
+            if (!content.data || !content.media_type) {
+                return `${content.filename} is a ${size} image — too large to return inline. Open it at ${file.url}`;
+            }
+            return [
+                { type: "text", text: `${content.filename} (${size})` },
+                { type: "image", data: content.data, mimeType: content.media_type },
+            ];
+        case "document":
+            return (`${content.filename} is a PDF (${size}). Monnet extracts text from Word, Excel and PowerPoint ` +
+                `files, but not from PDFs, so its contents cannot be read here. Open it at ${file.url}`);
+        default:
+            return `${content.text ?? `${content.filename} cannot be read as text.`} Open it at ${file.url}`;
+    }
+}
+export const READ_MOTION_FILE_TOOL_DEFINITION = {
+    name: "read_motion_file",
+    description: "Read a file attached to a motion. Text, markdown, CSV, JSON and source files come back as their contents; " +
+        "Word, Excel and PowerPoint documents come back as their extracted text; images come back as the image itself. " +
+        "A PDF cannot be read this way — you get its URL to open instead. " +
+        "Call get_motion first: it lists every attachment with the id and the filename this tool takes.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            workspace_slug: {
+                type: "string",
+                description: "The workspace slug from the motion URL (e.g. 'monnet-team-410b').",
+            },
+            motion_short_id: {
+                type: "string",
+                description: "The first 8 characters of the motion UUID, visible in the motion URL.",
+            },
+            file_id: {
+                type: "string",
+                description: "The file's id, from the FILES section of get_motion. Prefer it over filename — two attachments on one motion may share a name.",
+            },
+            filename: {
+                type: "string",
+                description: "The file's name, exactly as get_motion lists it. Used only when file_id is not given.",
+            },
+        },
+        required: ["workspace_slug", "motion_short_id"],
+    },
+};
+//# sourceMappingURL=read-motion-file.js.map

package/dist/tools/read-motion-file.js.map

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

package/dist/tools/reject.d.ts

@@ -13,10 +13,9 @@ export declare const REJECT_TOOL_DEFINITION: {
                 type: string;
                 description: string;
             };
-            step_index: {
+            step_path: {
                 type: string;
                 description: string;
-                minimum: number;
             };
             reason: {
                 type: string;