@linwheel/mcp-server 0.1.0 → 0.2.1

package/README.md

@@ -80,7 +80,14 @@ If it works, you're in.
 
 ## 🛠️ Tools
 
-22 tools across 5 categories. Claude picks the right one — just describe what you want.
+24 tools across 6 categories. Claude picks the right one — just describe what you want.
+
+### Onboarding
+
+| Tool | What it does |
+|------|-------------|
+| `linwheel_onboard` | Guided setup — walks you from zero to your first scheduled post (start here) |
+| `linwheel_voice_extract` | Build a clean voice profile from samples — rejects off-voice / AI-slop outliers |
 
 ### Content Creation
 
@@ -212,6 +219,29 @@ The MCP server is a thin client. All heavy lifting (LLM calls, image generation,
 
 ---
 
+## 🚢 Releasing (maintainers)
+
+The package publishes to npm via **trusted publishing (OIDC)** — there is **no `NPM_TOKEN`**. The workflow (`.github/workflows/publish-mcp.yml`) mints a short-lived token from the GitHub id-token at publish time, and provenance is attached automatically. The trusted publisher is configured on npmjs.com (package → Settings → Trusted Publisher → GitHub Actions → `Peleke/linwheel` → `publish-mcp.yml` → environment `npm`).
+
+To cut a release:
+
+1. Bump the version in **`mcp/package.json`**, then sync the lockfile and the server version string:
+   ```bash
+   cd mcp
+   # edit package.json version, then:
+   npm install --package-lock-only        # sync mcp/package-lock.json
+   # also bump the version in src/index.ts (McpServer { version })
+   ```
+2. Merge the bump to `main` (via PR).
+3. **Publish by pushing a tag** that points at the merged commit:
+   ```bash
+   git tag mcp-v<version> origin/main && git push origin mcp-v<version>
+   ```
+
+> ⚠️ **Publish only via a `mcp-v*` tag — not `workflow_dispatch`.** The `npm` GitHub Environment has a deployment-branch rule that permits **tags matching `mcp-v*`** only. A manual `workflow_dispatch` from `main` is rejected with *"Branch 'main' is not allowed to deploy to npm due to environment protection rules."* If you re-run after a workflow fix, move the tag to the fixed commit first (`git tag -d`, delete the remote tag, re-tag `origin/main`, push) so GitHub reads the corrected workflow from the tag's commit.
+
+---
+
 <div align="center">
 
 Built with [Model Context Protocol](https://modelcontextprotocol.io) · Powered by [Claude](https://claude.ai)

package/dist/credentials.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Local credential storage for the device-login flow.
+ *
+ * After the user approves a device authorization in the browser, the MCP client
+ * captures the minted key and writes it to ~/.linwheel/credentials.json. On the
+ * next startup, the server reads it as a fallback when LINWHEEL_API_KEY is unset
+ * — the same pattern as `vercel login` (~/.vercel).
+ */
+export interface LinWheelCredentials {
+    apiKey: string;
+    signingSecret?: string | null;
+}
+export declare function credentialsPath(): string;
+export declare function readCredentials(): Promise<LinWheelCredentials | null>;
+export declare function writeCredentials(creds: LinWheelCredentials): Promise<string>;

package/dist/credentials.js

@@ -0,0 +1,28 @@
+import { promises as fs } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+const DIR = join(homedir(), ".linwheel");
+const FILE = join(DIR, "credentials.json");
+export function credentialsPath() {
+    return FILE;
+}
+export async function readCredentials() {
+    try {
+        const raw = await fs.readFile(FILE, "utf8");
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed.apiKey === "string" && parsed.apiKey.length > 0) {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function writeCredentials(creds) {
+    // 0700 dir / 0600 file — the key is a secret; keep it owner-only.
+    await fs.mkdir(DIR, { recursive: true, mode: 0o700 });
+    await fs.writeFile(FILE, JSON.stringify(creds, null, 2) + "\n", { mode: 0o600 });
+    return FILE;
+}
+//# sourceMappingURL=credentials.js.map

package/dist/credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../src/credentials.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAgB5B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,CAAC,CAAC;AACzC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;AAE3C,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAwB,CAAC;QACtD,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5E,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAA0B;IAC/D,kEAAkE;IAClE,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACtD,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACjF,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/device-login.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Device-login client — the MCP side of the `vercel login`-style flow.
+ *
+ * `start` kicks off a device authorization and returns a URL for the user to
+ * approve in the browser; `poll` checks whether they've approved yet and, once
+ * they have, returns the minted key (once).
+ */
+export interface DeviceStart {
+    deviceCode: string;
+    userCode: string;
+    verificationUri: string;
+    verificationUriComplete: string;
+    interval: number;
+    expiresIn: number;
+}
+export type DevicePoll = {
+    status: "pending";
+} | {
+    status: "denied";
+} | {
+    status: "expired";
+} | {
+    status: "approved";
+    apiKey: string;
+    signingSecret: string | null;
+};
+export declare function startDeviceLogin(baseUrl: string): Promise<DeviceStart>;
+export declare function pollDeviceLogin(baseUrl: string, deviceCode: string): Promise<DevicePoll>;

package/dist/device-login.js

@@ -0,0 +1,30 @@
+/**
+ * Device-login client — the MCP side of the `vercel login`-style flow.
+ *
+ * `start` kicks off a device authorization and returns a URL for the user to
+ * approve in the browser; `poll` checks whether they've approved yet and, once
+ * they have, returns the minted key (once).
+ */
+export async function startDeviceLogin(baseUrl) {
+    const res = await fetch(`${baseUrl.replace(/\/$/, "")}/api/auth/device/start`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: "{}",
+    });
+    if (!res.ok) {
+        throw new Error(`Could not start LinWheel login (HTTP ${res.status}).`);
+    }
+    return (await res.json());
+}
+export async function pollDeviceLogin(baseUrl, deviceCode) {
+    const res = await fetch(`${baseUrl.replace(/\/$/, "")}/api/auth/device/poll`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ deviceCode }),
+    });
+    if (!res.ok) {
+        throw new Error(`Could not check LinWheel login status (HTTP ${res.status}).`);
+    }
+    return (await res.json());
+}
+//# sourceMappingURL=device-login.js.map

package/dist/device-login.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-login.js","sourceRoot":"","sources":["../src/device-login.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiBH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAe;IACpD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,wBAAwB,EAAE;QAC7E,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI;KACX,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,wCAAwC,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAgB,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAe,EACf,UAAkB;IAElB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,uBAAuB,EAAE;QAC5E,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,CAAC;KACrC,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,+CAA+C,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAe,CAAC;AAC1C,CAAC"}

package/dist/index.js

@@ -3,75 +3,96 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { LinWheelClient } from "./client.js";
 import { registerAllTools } from "./tools/index.js";
+import { z } from "zod";
+import { readCredentials, writeCredentials } from "./credentials.js";
+import { startDeviceLogin, pollDeviceLogin } from "./device-login.js";
 const BASE_URL = process.env.LINWHEEL_BASE_URL ?? "https://www.linwheel.io";
-const API_KEY = process.env.LINWHEEL_API_KEY;
-const server = new McpServer({ name: "linwheel", version: "0.1.0" }, { capabilities: { tools: {} } });
+// Key resolution: LINWHEEL_API_KEY env var first, then the saved credentials
+// file written by the device-login flow (~/.linwheel/credentials.json).
+const stored = process.env.LINWHEEL_API_KEY ? null : await readCredentials();
+const API_KEY = process.env.LINWHEEL_API_KEY ?? stored?.apiKey;
+const SIGNING_SECRET = process.env.LINWHEEL_SIGNING_SECRET ?? stored?.signingSecret ?? undefined;
+const server = new McpServer({ name: "linwheel", version: "0.2.1" }, { capabilities: { tools: {} } });
 if (API_KEY) {
     const client = new LinWheelClient({
         baseUrl: BASE_URL,
         apiKey: API_KEY,
-        signingSecret: process.env.LINWHEEL_SIGNING_SECRET,
+        signingSecret: SIGNING_SECRET,
         timeoutMs: parseInt(process.env.LINWHEEL_TIMEOUT_MS ?? "60000", 10),
     });
     registerAllTools(server, client);
 }
 else {
-    // No API key — register setup tool only
-    server.tool("linwheel_setup", "Get started with LinWheel. Returns step-by-step instructions to create an account and configure your API key. Call this first.", {}, async () => {
-        const configExample = JSON.stringify({
-            mcpServers: {
-                linwheel: {
-                    command: "npx",
-                    args: ["-y", "@linwheel/mcp-server"],
-                    env: {
-                        LINWHEEL_API_KEY: "lw_sk_paste_your_key_here",
+    // No key configured — expose the guided device login. Call once to get an
+    // approval URL, then again with the deviceCode to capture and save the key.
+    server.tool("linwheel_setup", "Connect LinWheel by logging in from the browser — no manual key copying. Call with no arguments to get an approval URL; after you approve in the browser, call it again with the deviceCode it gave you to finish. Your key is saved to ~/.linwheel/credentials.json automatically; then restart your MCP client to load the tools.", {
+        deviceCode: z
+            .string()
+            .optional()
+            .describe("The deviceCode returned by the first call. Pass it after approving in the browser to finish login."),
+    }, async ({ deviceCode }) => {
+        if (!deviceCode) {
+            const start = await startDeviceLogin(BASE_URL);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: [
+                            "# Connect LinWheel",
+                            "",
+                            "1. Open this URL and approve the device:",
+                            `   ${start.verificationUriComplete}`,
+                            `   (verification code: ${start.userCode})`,
+                            "",
+                            "2. After approving in the browser, call `linwheel_setup` again with:",
+                            `   deviceCode: "${start.deviceCode}"`,
+                            "",
+                            "I'll capture your key and save it automatically. The code expires in ~10 minutes.",
+                        ].join("\n"),
                     },
-                },
-            },
-        }, null, 2);
+                ],
+            };
+        }
+        const poll = await pollDeviceLogin(BASE_URL, deviceCode);
+        if (poll.status === "approved") {
+            const path = await writeCredentials({
+                apiKey: poll.apiKey,
+                signingSecret: poll.signingSecret,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: [
+                            "✅ Connected to LinWheel.",
+                            "",
+                            `Saved your key to ${path}.`,
+                            "Restart your MCP client (or Claude Code) to load the LinWheel tools, then run `linwheel_onboard` to get started.",
+                        ].join("\n"),
+                    },
+                ],
+            };
+        }
+        if (poll.status === "pending") {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Still waiting for approval. Approve in the browser, then call `linwheel_setup` again with the same deviceCode.",
+                    },
+                ],
+            };
+        }
         return {
             content: [
                 {
                     type: "text",
-                    text: [
-                        "# LinWheel Setup",
-                        "",
-                        "No API key configured. Follow these steps:",
-                        "",
-                        "## 1. Create an account",
-                        `Sign up at: ${BASE_URL}/login`,
-                        "",
-                        "## 2. Generate an API key",
-                        `Go to: ${BASE_URL}/settings`,
-                        'Click "Generate API Key" and copy the key (starts with lw_sk_).',
-                        "The key is shown only once — save it somewhere safe.",
-                        "",
-                        "## 3. Add to your MCP config",
-                        "",
-                        "**Claude Code** — run this in your terminal:",
-                        "```",
-                        'claude mcp add linwheel -- npx -y @linwheel/mcp-server',
-                        "```",
-                        "Then set the env var in your `.mcp.json`:",
-                        "",
-                        "```json",
-                        configExample,
-                        "```",
-                        "",
-                        "## 4. Restart Claude Code",
-                        "After updating config, restart Claude Code to load LinWheel tools.",
-                        "",
-                        "## 5. Verify",
-                        'Ask Claude: "List my LinWheel posts" — if it works, you\'re all set.',
-                        "",
-                        `Dashboard: ${BASE_URL}/dashboard`,
-                        `Docs: https://github.com/Peleke/linwheel/tree/main/mcp#readme`,
-                    ].join("\n"),
+                    text: `Login ${poll.status}. Start over: call \`linwheel_setup\` with no arguments.`,
                 },
             ],
         };
     });
-    console.error("LinWheel MCP: No LINWHEEL_API_KEY set. Only linwheel_setup tool available.");
+    console.error("LinWheel MCP: No key configured. Run the linwheel_setup tool to log in.");
 }
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGpD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,yBAAyB,CAAC;AAC5E,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;AAE7C,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,EACtC,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;AAEF,IAAI,OAAO,EAAE,CAAC;IACZ,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;QAChC,OAAO,EAAE,QAAQ;QACjB,MAAM,EAAE,OAAO;QACf,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB;QAClD,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,OAAO,EAAE,EAAE,CAAC;KACpE,CAAC,CAAC;IAEH,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACnC,CAAC;KAAM,CAAC;IACN,wCAAwC;IACxC,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,gIAAgI,EAChI,EAAE,EACF,KAAK,IAAI,EAAE;QACT,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,CAClC;YACE,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,OAAO,EAAE,KAAK;oBACd,IAAI,EAAE,CAAC,IAAI,EAAE,sBAAsB,CAAC;oBACpC,GAAG,EAAE;wBACH,gBAAgB,EAAE,2BAA2B;qBAC9C;iBACF;aACF;SACF,EACD,IAAI,EACJ,CAAC,CACF,CAAC;QAEF,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;wBACJ,kBAAkB;wBAClB,EAAE;wBACF,4CAA4C;wBAC5C,EAAE;wBACF,yBAAyB;wBACzB,eAAe,QAAQ,QAAQ;wBAC/B,EAAE;wBACF,2BAA2B;wBAC3B,UAAU,QAAQ,WAAW;wBAC7B,iEAAiE;wBACjE,sDAAsD;wBACtD,EAAE;wBACF,8BAA8B;wBAC9B,EAAE;wBACF,8CAA8C;wBAC9C,KAAK;wBACL,wDAAwD;wBACxD,KAAK;wBACL,2CAA2C;wBAC3C,EAAE;wBACF,SAAS;wBACT,aAAa;wBACb,KAAK;wBACL,EAAE;wBACF,2BAA2B;wBAC3B,oEAAoE;wBACpE,EAAE;wBACF,cAAc;wBACd,sEAAsE;wBACtE,EAAE;wBACF,cAAc,QAAQ,YAAY;wBAClC,+DAA+D;qBAChE,CAAC,IAAI,CAAC,IAAI,CAAC;iBACb;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,OAAO,CAAC,KAAK,CACX,4EAA4E,CAC7E,CAAC;AACJ,CAAC;AAED,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAEhC,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/carousels-scheduled.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { LinWheelClient } from "../client.js";
+export declare function register(server: McpServer, client: LinWheelClient): void;

package/dist/tools/carousels-scheduled.js

@@ -0,0 +1,9 @@
+export function register(server, client) {
+    server.tool("linwheel_carousels_scheduled", "List all scheduled carousels as calendar items. Returns both post carousels and article carousels with status='scheduled', including parent content references, caption, pageCount, scheduledAt, and autoPublish. Use to see what carousels are queued for publication. ~500 tokens.", {}, async () => {
+        const result = await client.get("/api/agent/carousels/scheduled");
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=carousels-scheduled.js.map

package/dist/tools/carousels-scheduled.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"carousels-scheduled.js","sourceRoot":"","sources":["../../src/tools/carousels-scheduled.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,QAAQ,CAAC,MAAiB,EAAE,MAAsB;IAChE,MAAM,CAAC,IAAI,CACT,8BAA8B,EAC9B,sRAAsR,EACtR,EAAE,EACF,KAAK,IAAI,EAAE;QACT,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;QAClE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/index.js

@@ -14,8 +14,15 @@ import * as postCarousel from "./post-carousel.js";
 import * as postCarouselCompanion from "./post-carousel-companion.js";
 import * as postCarouselStatus from "./post-carousel-status.js";
 import * as postCarouselSchedule from "./post-carousel-schedule.js";
+import * as postCarouselCompile from "./post-carousel-compile.js";
+import * as postCarouselRegenerate from "./post-carousel-regenerate.js";
+import * as postCarouselDelete from "./post-carousel-delete.js";
+import * as postCarouselCaption from "./post-carousel-caption.js";
+import * as carouselsScheduled from "./carousels-scheduled.js";
 import * as postComment from "./post-comment.js";
 import * as voiceProfiles from "./voice-profiles.js";
+import * as voiceExtract from "./voice-extract.js";
+import * as onboard from "./onboard.js";
 import * as brandStyles from "./brand-styles.js";
 const ALL_TOOLS = [
     analyze,
@@ -34,8 +41,15 @@ const ALL_TOOLS = [
     postCarouselCompanion,
     postCarouselStatus,
     postCarouselSchedule,
+    postCarouselCompile,
+    postCarouselRegenerate,
+    postCarouselDelete,
+    postCarouselCaption,
+    carouselsScheduled,
     postComment,
     voiceProfiles,
+    voiceExtract,
+    onboard,
     brandStyles,
 ];
 export function registerAllTools(server, client) {

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,OAAO,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,qBAAqB,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,kBAAkB,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,oBAAoB,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,aAAa,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AAEjD,MAAM,SAAS,GAAG;IAChB,OAAO;IACP,OAAO;IACP,MAAM;IACN,KAAK;IACL,KAAK;IACL,MAAM;IACN,SAAS;IACT,OAAO;IACP,UAAU;IACV,WAAW;IACX,YAAY;IACZ,SAAS;IACT,YAAY;IACZ,qBAAqB;IACrB,kBAAkB;IAClB,oBAAoB;IACpB,WAAW;IACX,aAAa;IACb,WAAW;CACZ,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,MAAsB;IACxE,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,CAAC;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,OAAO,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,qBAAqB,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,kBAAkB,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,oBAAoB,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,mBAAmB,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,sBAAsB,MAAM,+BAA+B,CAAC;AACxE,OAAO,KAAK,kBAAkB,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,mBAAmB,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,kBAAkB,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,aAAa,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AAEjD,MAAM,SAAS,GAAG;IAChB,OAAO;IACP,OAAO;IACP,MAAM;IACN,KAAK;IACL,KAAK;IACL,MAAM;IACN,SAAS;IACT,OAAO;IACP,UAAU;IACV,WAAW;IACX,YAAY;IACZ,SAAS;IACT,YAAY;IACZ,qBAAqB;IACrB,kBAAkB;IAClB,oBAAoB;IACpB,mBAAmB;IACnB,sBAAsB;IACtB,kBAAkB;IAClB,mBAAmB;IACnB,kBAAkB;IAClB,WAAW;IACX,aAAa;IACb,YAAY;IACZ,OAAO;IACP,WAAW;CACZ,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,MAAsB;IACxE,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,CAAC;AACH,CAAC"}

package/dist/tools/onboard.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { LinWheelClient } from "../client.js";
+export declare function register(server: McpServer, client: LinWheelClient): void;

package/dist/tools/onboard.js

@@ -0,0 +1,25 @@
+import { z } from "zod";
+export function register(server, client) {
+    server.tool("linwheel_onboard", 'Guided onboarding — walks you from zero to your first scheduled LinkedIn post. Call it with no arguments (or step="status") to see exactly where you are and what to do next: it derives your progress from live data (voice profile, drafts, scheduled posts), explains WHY each step matters, and hands back the precise next tool to call. It performs the voice-profile step directly — call with step="voice" and 3+ of your own writing samples to build and activate a voice profile (off-voice/AI-slop samples are dropped automatically). If you are new to LinWheel, start here.', {
+        step: z
+            .enum(["status", "voice", "compose", "schedule", "done"])
+            .optional()
+            .describe('Which step to run. Default "status" reports your current state and the recommended next action. "voice" builds a voice profile from `samples`.'),
+        samples: z
+            .array(z.string())
+            .optional()
+            .describe('For step="voice": 3+ of your own writing samples (posts, articles) to extract a voice profile from.'),
+        voiceName: z
+            .string()
+            .optional()
+            .describe('For step="voice": an optional name for the created profile.'),
+    }, async (args) => {
+        const result = await client.post("/api/agent/onboard", args);
+        return {
+            content: [
+                { type: "text", text: JSON.stringify(result, null, 2) },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=onboard.js.map

package/dist/tools/onboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboard.js","sourceRoot":"","sources":["../../src/tools/onboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,QAAQ,CAAC,MAAiB,EAAE,MAAsB;IAChE,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,4jBAA4jB,EAC5jB;QACE,IAAI,EAAE,CAAC;aACJ,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;aACxD,QAAQ,EAAE;aACV,QAAQ,CACP,gJAAgJ,CACjJ;QACH,OAAO,EAAE,CAAC;aACP,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,EAAE;aACV,QAAQ,CACP,qGAAqG,CACtG;QACH,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,6DAA6D,CAAC;KAC3E,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC;QAC7D,OAAO;YACL,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;aACjE;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/post-carousel-caption.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { LinWheelClient } from "../client.js";
+export declare function register(server: McpServer, client: LinWheelClient): void;

package/dist/tools/post-carousel-caption.js

@@ -0,0 +1,13 @@
+import { z } from "zod";
+export function register(server, client) {
+    server.tool("linwheel_post_carousel_caption", "Update the companion caption text for a post's carousel without regenerating slides. Use this to edit the LinkedIn caption that accompanies the carousel PDF. Returns the updated caption and carouselId. ~100 tokens.", {
+        postId: z.string().describe("The post ID whose carousel caption to update"),
+        caption: z.string().describe("The new caption text for the carousel"),
+    }, async ({ postId, caption }) => {
+        const result = await client.put(`/api/agent/posts/${postId}/carousel`, { caption });
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=post-carousel-caption.js.map

package/dist/tools/post-carousel-caption.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-carousel-caption.js","sourceRoot":"","sources":["../../src/tools/post-carousel-caption.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,UAAU,QAAQ,CAAC,MAAiB,EAAE,MAAsB;IAChE,MAAM,CAAC,IAAI,CACT,gCAAgC,EAChC,wNAAwN,EACxN;QACE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;QAC3E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;KACtE,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;QAC5B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAC7B,oBAAoB,MAAM,WAAW,EACrC,EAAE,OAAO,EAAE,CACZ,CAAC;QACF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/post-carousel-compile.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { LinWheelClient } from "../client.js";
+export declare function register(server: McpServer, client: LinWheelClient): void;

package/dist/tools/post-carousel-compile.js

@@ -0,0 +1,12 @@
+import { z } from "zod";
+export function register(server, client) {
+    server.tool("linwheel_post_carousel_compile", "Compile carousel slides into a PDF document. Use this when a carousel has slides but no PDF (carouselUrl is null) — typically for carousels created before automatic PDF compilation was added. Returns carouselId, carouselUrl, and pageCount. ~150 tokens. Call linwheel_post_carousel_status first to check if compilation is needed.", {
+        postId: z.string().describe("The post ID whose carousel to compile"),
+    }, async ({ postId }) => {
+        const result = await client.post(`/api/agent/posts/${postId}/carousel/compile`, {});
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=post-carousel-compile.js.map

package/dist/tools/post-carousel-compile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-carousel-compile.js","sourceRoot":"","sources":["../../src/tools/post-carousel-compile.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,UAAU,QAAQ,CAAC,MAAiB,EAAE,MAAsB;IAChE,MAAM,CAAC,IAAI,CACT,gCAAgC,EAChC,0UAA0U,EAC1U;QACE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;KACrE,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAC9B,oBAAoB,MAAM,mBAAmB,EAC7C,EAAE,CACH,CAAC;QACF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/post-carousel-delete.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { LinWheelClient } from "../client.js";
+export declare function register(server: McpServer, client: LinWheelClient): void;

package/dist/tools/post-carousel-delete.js

@@ -0,0 +1,12 @@
+import { z } from "zod";
+export function register(server, client) {
+    server.tool("linwheel_post_carousel_delete", "Delete a carousel from a post entirely. Use this to remove an incorrectly generated or unwanted carousel. Cannot delete published carousels. Returns success confirmation. ~100 tokens.", {
+        postId: z.string().describe("The post ID whose carousel to delete"),
+    }, async ({ postId }) => {
+        const result = await client.delete(`/api/agent/posts/${postId}/carousel`);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=post-carousel-delete.js.map

package/dist/tools/post-carousel-delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-carousel-delete.js","sourceRoot":"","sources":["../../src/tools/post-carousel-delete.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,UAAU,QAAQ,CAAC,MAAiB,EAAE,MAAsB;IAChE,MAAM,CAAC,IAAI,CACT,+BAA+B,EAC/B,yLAAyL,EACzL;QACE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;KACpE,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAChC,oBAAoB,MAAM,WAAW,CACtC,CAAC;QACF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/post-carousel-regenerate.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { LinWheelClient } from "../client.js";
+export declare function register(server: McpServer, client: LinWheelClient): void;

package/dist/tools/post-carousel-regenerate.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+export function register(server, client) {
+    server.tool("linwheel_post_carousel_regenerate", "Regenerate a single slide in an existing carousel. Use this to fix a typo or rephrase one slide without regenerating the entire carousel. Specify the 0-based slideIndex and the new headlineText. Returns the updated slide. ~200 tokens.", {
+        postId: z.string().describe("The post ID whose carousel slide to regenerate"),
+        slideIndex: z
+            .number()
+            .int()
+            .min(0)
+            .describe("0-based index of the slide to regenerate"),
+        headlineText: z
+            .string()
+            .describe("New headline text for the slide"),
+        caption: z
+            .string()
+            .optional()
+            .describe("New caption for the slide (omit to keep current)"),
+    }, async ({ postId, slideIndex, headlineText, caption }) => {
+        const body = { slideIndex, headlineText };
+        if (caption !== undefined)
+            body.caption = caption;
+        const result = await client.patch(`/api/agent/posts/${postId}/carousel`, body);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=post-carousel-regenerate.js.map

package/dist/tools/post-carousel-regenerate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-carousel-regenerate.js","sourceRoot":"","sources":["../../src/tools/post-carousel-regenerate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,UAAU,QAAQ,CAAC,MAAiB,EAAE,MAAsB;IAChE,MAAM,CAAC,IAAI,CACT,mCAAmC,EACnC,4OAA4O,EAC5O;QACE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;QAC7E,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CAAC,0CAA0C,CAAC;QACvD,YAAY,EAAE,CAAC;aACZ,MAAM,EAAE;aACR,QAAQ,CAAC,iCAAiC,CAAC;QAC9C,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,kDAAkD,CAAC;KAChE,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,EAAE;QACtD,MAAM,IAAI,GAA4B,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC;QACnE,IAAI,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAElD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAC/B,oBAAoB,MAAM,WAAW,EACrC,IAAI,CACL,CAAC;QACF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/voice-extract.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { LinWheelClient } from "../client.js";
+export declare function register(server: McpServer, client: LinWheelClient): void;

package/dist/tools/voice-extract.js

@@ -0,0 +1,41 @@
+import { z } from "zod";
+export function register(server, client) {
+    server.tool("linwheel_voice_extract", "Extract a clean voice profile from writing samples — or re-extract from an existing profile to de-poison it. Runs a validation pass that judges each sample against the dominant voice and REJECTS off-voice outliers (generic/AI-slop/boilerplate, or a different register) so they don't poison few-shot style matching, then synthesizes concrete style notes from the samples that survive. By default it's a dry run that returns per-sample keep/reject verdicts with reasons; set save=true to persist the curated profile. With fromProfileId + updateInPlace=true it cleans an existing profile in place.", {
+        samples: z
+            .array(z.string())
+            .optional()
+            .describe("Raw candidate writing samples to extract a voice from."),
+        fromProfileId: z
+            .string()
+            .optional()
+            .describe("Re-extract from an existing profile's samples (de-poison). Provide this or samples (or both)."),
+        save: z
+            .boolean()
+            .optional()
+            .describe("Persist the curated profile. Default false — a dry run returns verdicts without saving."),
+        updateInPlace: z
+            .boolean()
+            .optional()
+            .describe("With fromProfileId + save: update that profile in place instead of creating a new one."),
+        name: z
+            .string()
+            .optional()
+            .describe("Name for the saved profile (defaults to the suggested name)."),
+        activate: z
+            .boolean()
+            .optional()
+            .describe("Set the profile as active when saving."),
+        minKeep: z
+            .number()
+            .optional()
+            .describe("Minimum samples to keep (default 2); guards against over-aggressive rejection producing a too-thin profile."),
+    }, async (args) => {
+        const result = await client.post("/api/agent/voice-profiles/extract", args);
+        return {
+            content: [
+                { type: "text", text: JSON.stringify(result, null, 2) },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=voice-extract.js.map

package/dist/tools/voice-extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-extract.js","sourceRoot":"","sources":["../../src/tools/voice-extract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,QAAQ,CAAC,MAAiB,EAAE,MAAsB;IAChE,MAAM,CAAC,IAAI,CACT,wBAAwB,EACxB,olBAAolB,EACplB;QACE,OAAO,EAAE,CAAC;aACP,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,EAAE;aACV,QAAQ,CAAC,wDAAwD,CAAC;QACrE,aAAa,EAAE,CAAC;aACb,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,+FAA+F,CAChG;QACH,IAAI,EAAE,CAAC;aACJ,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CACP,yFAAyF,CAC1F;QACH,aAAa,EAAE,CAAC;aACb,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CACP,wFAAwF,CACzF;QACH,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,8DAA8D,CAAC;QAC3E,QAAQ,EAAE,CAAC;aACR,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CAAC,wCAAwC,CAAC;QACrD,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,6GAA6G,CAC9G;KACJ,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAC9B,mCAAmC,EACnC,IAAI,CACL,CAAC;QACF,OAAO;YACL,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;aACjE;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linwheel/mcp-server",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "MCP server for LinWheel — AI-powered LinkedIn content engine. Draft, schedule, and publish posts from Claude Code.",
   "type": "module",
   "bin": {
@@ -21,6 +21,7 @@
     "zod": "^3.24.0"
   },
   "devDependencies": {
+    "@types/node": "^25.5.0",
     "tsx": "^4.19.0",
     "typescript": "^5.9.3",
     "vitest": "^3.2.1"