@voila.dev/cliche 0.1.0

package/dist/capture.js

@@ -0,0 +1,115 @@
+var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
+    if (value !== null && value !== void 0) {
+        if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
+        var dispose, inner;
+        if (async) {
+            if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
+            dispose = value[Symbol.asyncDispose];
+        }
+        if (dispose === void 0) {
+            if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
+            dispose = value[Symbol.dispose];
+            if (async) inner = dispose;
+        }
+        if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
+        env.stack.push({ value: value, dispose: dispose, async: async });
+    }
+    else if (async) {
+        env.stack.push({ async: true });
+    }
+    return value;
+};
+var __disposeResources = (this && this.__disposeResources) || (function (SuppressedError) {
+    return function (env) {
+        function fail(e) {
+            env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
+            env.hasError = true;
+        }
+        var r, s = 0;
+        function next() {
+            while (r = env.stack.pop()) {
+                try {
+                    if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
+                    if (r.dispose) {
+                        var result = r.dispose.call(r.value);
+                        if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });
+                    }
+                    else s |= 1;
+                }
+                catch (e) {
+                    fail(e);
+                }
+            }
+            if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
+            if (env.hasError) throw env.error;
+        }
+        return next();
+    };
+})(typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+});
+const WAIT_FOR_TIMEOUT_MILLISECONDS = 15_000;
+const WAIT_FOR_POLL_MILLISECONDS = 250;
+// Bun.WebView rejects viewport dimensions above 16384 pixels.
+const MAXIMUM_VIEWPORT_HEIGHT = 16_384;
+function sleep(milliseconds) {
+    return new Promise((resolve) => setTimeout(resolve, milliseconds));
+}
+async function waitForSelector(view, selector) {
+    const deadline = Date.now() + WAIT_FOR_TIMEOUT_MILLISECONDS;
+    const probe = `!!document.querySelector(${JSON.stringify(selector)})`;
+    while (!(await view.evaluate(probe))) {
+        if (Date.now() > deadline) {
+            throw new Error(`Timed out after ${WAIT_FOR_TIMEOUT_MILLISECONDS}ms waiting for ${selector}`);
+        }
+        await sleep(WAIT_FOR_POLL_MILLISECONDS);
+    }
+}
+/** Screenshot a page with Bun.WebView and write it to `options.out` as PNG. */
+export async function capture(options) {
+    const env_1 = { stack: [], error: void 0, hasError: false };
+    try {
+        const viewport = options.viewport ?? { width: 1440, height: 900 };
+        const view = __addDisposableResource(env_1, new Bun.WebView(viewport), true);
+        const localStorageEntries = Object.entries(options.localStorage ?? {});
+        if (localStorageEntries.length > 0) {
+            // localStorage is origin-scoped, so land on the origin (any page, a login
+            // redirect is fine) to seed the entries before loading the target.
+            await view.navigate(new URL(options.url).origin);
+            for (const [key, value] of localStorageEntries) {
+                await view.evaluate(`localStorage.setItem(${JSON.stringify(key)}, ${JSON.stringify(value)})`);
+            }
+        }
+        await view.navigate(options.url);
+        if (options.waitFor !== undefined) {
+            await waitForSelector(view, options.waitFor);
+        }
+        // A fixed delay for fonts, images and entrance animations: dev servers keep
+        // an HMR socket open, so there is no network-idle moment to wait for.
+        await sleep(options.settleMilliseconds ?? 1500);
+        if (options.fullPage === true) {
+            const pageHeight = await view.evaluate("Math.max(document.documentElement.scrollHeight, document.body.scrollHeight)");
+            if (pageHeight > viewport.height) {
+                await view.resize(viewport.width, Math.min(pageHeight, MAXIMUM_VIEWPORT_HEIGHT));
+                await sleep(400);
+            }
+        }
+        if (options.scrollTo !== undefined) {
+            await view.scrollTo(options.scrollTo);
+            await sleep(300);
+        }
+        await Bun.write(options.out, await view.screenshot());
+    }
+    catch (e_1) {
+        env_1.error = e_1;
+        env_1.hasError = true;
+    }
+    finally {
+        const result_1 = __disposeResources(env_1);
+        if (result_1)
+            await result_1;
+    }
+}
+//# sourceMappingURL=capture.js.map

package/dist/capture.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,107 @@
+#!/usr/bin/env bun
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { capture } from "./capture.js";
+import { runMcpServer } from "./mcp.js";
+import { parseCommand } from "./options.js";
+import { setup } from "./setup.js";
+import { installSkill } from "./skill.js";
+import { upload } from "./upload.js";
+const HELP = `cliche — take a cliché of any page and get a shareable URL.
+
+Usage:
+  cliche <url> <out.png> [options]        Screenshot a page.
+  cliche <url> <out.png> --upload         …and upload it, printing its URL.
+  cliche upload [--prefix pr-123] <files> Upload images, printing their URLs.
+  cliche mcp                              Serve the tools over MCP (stdio).
+  cliche setup [--bucket name]            Create an R2 bucket via wrangler and
+                                          write the S3 config to .env.
+  cliche album [--port 4949]              Browse the bucket as a photo album.
+  cliche skill                            Install the PR-screenshots skill into
+                                          .claude/skills/ (Claude Code).
+
+Capture options:
+  --viewport <WxH>            Viewport, default 1440x900 (390x844 for mobile).
+  --wait-for <css>            Wait for a selector before shooting (15s max).
+  --scroll-to <css>           Scroll a selector into view before shooting.
+  --settle <ms>               Let the page settle after load, default 1500.
+  --full-page                 Grow the viewport to the full page height.
+  --local-storage key=value   Seed localStorage on the target origin
+                              (repeatable; e.g. a session token).
+
+Upload options:
+  --prefix <name>             Object key prefix, e.g. pr-123.
+  --markdown                  Print ![caption](url) lines instead of URLs.
+
+Upload configuration (standard Bun.S3Client environment variables):
+  S3_BUCKET, S3_ENDPOINT, S3_ACCESS_KEY_ID, S3_SECRET_ACCESS_KEY (or AWS_*)
+  CLICHE_PUBLIC_URL           Public base URL of the bucket (custom domain).
+
+URLs go to stdout, progress to stderr. Ouistiti !`;
+function printUploads(uploaded, markdown) {
+    console.log(uploaded.map((entry) => (markdown ? entry.markdown : entry.url)).join("\n"));
+}
+async function main() {
+    const command = parseCommand(Bun.argv.slice(2));
+    switch (command.kind) {
+        case "help":
+            console.log(HELP);
+            return;
+        case "mcp":
+            await runMcpServer();
+            return;
+        case "skill": {
+            const target = await installSkill();
+            console.error(`Installed the PR-screenshots skill at ${target}`);
+            return;
+        }
+        case "setup":
+            await setup(command.bucket);
+            return;
+        case "album": {
+            if (command.port !== undefined)
+                process.env.PORT = String(command.port);
+            // Dynamic with a computed specifier so tsc ships it untouched: the album
+            // is TS + HTML imports that Bun resolves at runtime from the package.
+            const albumEntry = "../apps/album/src/index.ts";
+            await import(__rewriteRelativeImportExtension(albumEntry));
+            const url = `http://localhost:${process.env.PORT ?? 4949}`;
+            const opener = process.platform === "darwin" ? "open" : "xdg-open";
+            Bun.spawn([opener, url], { stdout: "ignore", stderr: "ignore" });
+            // Keep the process alive for the server.
+            await new Promise(() => { });
+            return;
+        }
+        case "upload": {
+            const uploaded = await upload({
+                files: command.files,
+                ...(command.prefix === undefined ? {} : { prefix: command.prefix }),
+            });
+            printUploads(uploaded, command.markdown);
+            return;
+        }
+        case "capture": {
+            await capture(command.capture);
+            console.error(`Captured ${command.capture.url} -> ${command.capture.out}`);
+            if (command.upload) {
+                const uploaded = await upload({
+                    files: [command.capture.out],
+                    ...(command.prefix === undefined ? {} : { prefix: command.prefix }),
+                });
+                printUploads(uploaded, command.markdown);
+            }
+            return;
+        }
+    }
+}
+main().catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { capture } from "./capture.ts";
+export type { CaptureOptions, Viewport } from "./capture.ts";
+export { upload } from "./upload.ts";
+export type { ObjectWriter, UploadedFile, UploadOptions } from "./upload.ts";
+export { captionOf, objectKeyOf, slugOf } from "./keys.ts";
+export { handleMessage, runMcpServer } from "./mcp.ts";
+export type { McpDependencies } from "./mcp.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACvD,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { capture } from "./capture.js";
+export { upload } from "./upload.js";
+export { captionOf, objectKeyOf, slugOf } from "./keys.js";
+export { handleMessage, runMcpServer } from "./mcp.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/dist/keys.d.ts

@@ -0,0 +1,10 @@
+/** S3 object keys only tolerate a narrow character set. */
+export declare function slugOf(rawPrefix: string): string;
+/** The image's caption in the generated markdown. */
+export declare function captionOf(file: string): string;
+/**
+ * `<prefix>/<yyyy-mm-dd>-<basename>-<content-hash>.<ext>`: the hash makes
+ * re-uploads cache-safe, the date keeps the bucket browsable.
+ */
+export declare function objectKeyOf(prefix: string, file: string, bytes: Uint8Array, date: string): string;
+//# sourceMappingURL=keys.d.ts.map

package/dist/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"AAEA,2DAA2D;AAC3D,wBAAgB,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,qDAAqD;AACrD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAMD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGjG"}

package/dist/keys.js

@@ -0,0 +1,21 @@
+import { basename, extname } from "node:path";
+/** S3 object keys only tolerate a narrow character set. */
+export function slugOf(rawPrefix) {
+    return rawPrefix.replace(/[^a-zA-Z0-9_-]/g, "-");
+}
+/** The image's caption in the generated markdown. */
+export function captionOf(file) {
+    return basename(file, extname(file)).replace(/[-_]+/g, " ");
+}
+function contentHash(bytes) {
+    return new Bun.CryptoHasher("sha256").update(bytes).digest("hex").slice(0, 8);
+}
+/**
+ * `<prefix>/<yyyy-mm-dd>-<basename>-<content-hash>.<ext>`: the hash makes
+ * re-uploads cache-safe, the date keeps the bucket browsable.
+ */
+export function objectKeyOf(prefix, file, bytes, date) {
+    const extension = extname(file);
+    return `${slugOf(prefix)}/${date}-${basename(file, extension)}-${contentHash(bytes)}${extension.toLowerCase()}`;
+}
+//# sourceMappingURL=keys.js.map

package/dist/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE9C,2DAA2D;AAC3D,MAAM,UAAU,MAAM,CAAC,SAAiB;IACtC,OAAO,SAAS,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;AACnD,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,WAAW,CAAC,KAAiB;IACpC,OAAO,IAAI,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAChF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,IAAY,EAAE,KAAiB,EAAE,IAAY;IACvF,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC;AAClH,CAAC"}

package/dist/mcp.d.ts

@@ -0,0 +1,19 @@
+import { type CaptureOptions } from "./capture.ts";
+import { type UploadedFile, type UploadOptions } from "./upload.ts";
+interface JsonRpcMessage {
+    readonly jsonrpc: "2.0";
+    readonly id?: number | string;
+    readonly method?: string;
+    readonly params?: Record<string, unknown>;
+}
+/** The implementations, injectable for tests. */
+export interface McpDependencies {
+    readonly capture: (options: CaptureOptions) => Promise<void>;
+    readonly upload: (options: UploadOptions) => Promise<Array<UploadedFile>>;
+}
+/** Handle one JSON-RPC message; null means nothing to send back. */
+export declare function handleMessage(message: JsonRpcMessage, dependencies: McpDependencies): Promise<Record<string, unknown> | null>;
+/** Serve MCP over stdio until stdin closes. */
+export declare function runMcpServer(): Promise<void>;
+export {};
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoC,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAErF,OAAO,EAAkC,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAUpG,UAAU,cAAc;IACtB,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;CAC3E;AAqID,oEAAoE;AACpE,wBAAsB,aAAa,CACjC,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,eAAe,GAC5B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAsCzC;AAED,+CAA+C;AAC/C,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAgBlD"}

package/dist/mcp.js

@@ -0,0 +1,193 @@
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { capture as captureImplementation } from "./capture.js";
+import { parseLocalStorage, parseViewport } from "./options.js";
+import { upload as uploadImplementation } from "./upload.js";
+/**
+ * A hand-rolled MCP server: the stdio transport is newline-delimited JSON-RPC
+ * 2.0, and this server only needs initialize + tools, so the protocol fits in
+ * this file and the package stays zero-dependency.
+ */
+const PROTOCOL_VERSION = "2025-06-18";
+const TOOLS = [
+    {
+        name: "screenshot",
+        description: "Screenshot a web page locally with Bun.WebView (no browser install). Optionally upload it to the configured S3-compatible bucket and return its public URL.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                url: { type: "string", description: "The page to screenshot." },
+                out: {
+                    type: "string",
+                    description: "Where to write the PNG. Defaults to a temporary file.",
+                },
+                viewport: {
+                    type: "string",
+                    description: "Viewport as <width>x<height>. Defaults to 1440x900 (use 390x844 for mobile).",
+                },
+                wait_for: {
+                    type: "string",
+                    description: "CSS selector to wait for before shooting (15s timeout).",
+                },
+                scroll_to: {
+                    type: "string",
+                    description: "CSS selector scrolled into view before shooting.",
+                },
+                settle_ms: {
+                    type: "number",
+                    description: "Milliseconds to let the page settle after load. Defaults to 1500.",
+                },
+                full_page: {
+                    type: "boolean",
+                    description: "Grow the viewport to the full page height before shooting.",
+                },
+                local_storage: {
+                    type: "object",
+                    additionalProperties: { type: "string" },
+                    description: "Entries seeded into the target origin's localStorage before the page loads (e.g. a session token for authenticated screens).",
+                },
+                upload: {
+                    type: "boolean",
+                    description: "Upload the shot and return its public URL.",
+                },
+                prefix: {
+                    type: "string",
+                    description: "Object key prefix for the upload, e.g. pr-123.",
+                },
+                markdown: {
+                    type: "boolean",
+                    description: "Return a ![caption](url) markdown line instead of the bare URL.",
+                },
+            },
+            required: ["url"],
+        },
+    },
+    {
+        name: "upload",
+        description: "Upload local images to the configured S3-compatible bucket and return their public URLs (content-hashed keys, safe to re-upload).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                files: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Paths of the images to upload.",
+                },
+                prefix: {
+                    type: "string",
+                    description: "Object key prefix, e.g. pr-123.",
+                },
+                markdown: {
+                    type: "boolean",
+                    description: "Return ![caption](url) markdown lines instead of the bare URLs.",
+                },
+            },
+            required: ["files"],
+        },
+    },
+];
+function textResult(text, isError = false) {
+    return { content: [{ type: "text", text }], ...(isError ? { isError: true } : {}) };
+}
+function renderUploads(uploaded, markdown) {
+    return uploaded.map((entry) => (markdown ? entry.markdown : entry.url)).join("\n");
+}
+function temporaryOut() {
+    return join(tmpdir(), `cliche-${Date.now().toString(36)}.png`);
+}
+async function callTool(name, input, dependencies) {
+    if (name === "screenshot") {
+        const out = typeof input.out === "string" ? input.out : temporaryOut();
+        await dependencies.capture({
+            url: String(input.url),
+            out,
+            ...(typeof input.viewport === "string" ? { viewport: parseViewport(input.viewport) } : {}),
+            ...(typeof input.wait_for === "string" ? { waitFor: input.wait_for } : {}),
+            ...(typeof input.scroll_to === "string" ? { scrollTo: input.scroll_to } : {}),
+            ...(typeof input.settle_ms === "number" ? { settleMilliseconds: input.settle_ms } : {}),
+            ...(input.full_page === true ? { fullPage: true } : {}),
+            ...(input.local_storage !== undefined && typeof input.local_storage === "object"
+                ? { localStorage: input.local_storage }
+                : {}),
+        });
+        if (input.upload !== true) {
+            return textResult(`Captured ${String(input.url)} -> ${out}`);
+        }
+        const uploaded = await dependencies.upload({
+            files: [out],
+            ...(typeof input.prefix === "string" ? { prefix: input.prefix } : {}),
+        });
+        return textResult(renderUploads(uploaded, input.markdown === true));
+    }
+    if (name === "upload") {
+        const uploaded = await dependencies.upload({
+            files: input.files ?? [],
+            ...(typeof input.prefix === "string" ? { prefix: input.prefix } : {}),
+        });
+        return textResult(renderUploads(uploaded, input.markdown === true));
+    }
+    return textResult(`Unknown tool: ${name}`, true);
+}
+/** Handle one JSON-RPC message; null means nothing to send back. */
+export async function handleMessage(message, dependencies) {
+    // Notifications carry no id and expect no response.
+    if (message.id === undefined)
+        return null;
+    const reply = (result) => ({
+        jsonrpc: "2.0",
+        id: message.id,
+        result,
+    });
+    switch (message.method) {
+        case "initialize":
+            return reply({
+                protocolVersion: typeof message.params?.protocolVersion === "string"
+                    ? message.params.protocolVersion
+                    : PROTOCOL_VERSION,
+                capabilities: { tools: {} },
+                serverInfo: { name: "cliche", version: "0.1.0" },
+            });
+        case "ping":
+            return reply({});
+        case "tools/list":
+            return reply({ tools: TOOLS });
+        case "tools/call": {
+            const name = String(message.params?.name);
+            const input = (message.params?.arguments ?? {});
+            try {
+                return reply(await callTool(name, input, dependencies));
+            }
+            catch (error) {
+                return reply(textResult(error instanceof Error ? error.message : String(error), true));
+            }
+        }
+        default:
+            return {
+                jsonrpc: "2.0",
+                id: message.id,
+                error: { code: -32601, message: `Method not found: ${message.method}` },
+            };
+    }
+}
+/** Serve MCP over stdio until stdin closes. */
+export async function runMcpServer() {
+    const dependencies = {
+        capture: captureImplementation,
+        upload: uploadImplementation,
+    };
+    for await (const line of console) {
+        if (line.trim() === "")
+            continue;
+        let message;
+        try {
+            message = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        const response = await handleMessage(message, dependencies);
+        if (response !== null)
+            console.log(JSON.stringify(response));
+    }
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

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

package/dist/options.d.ts

@@ -0,0 +1,38 @@
+import type { CaptureOptions, Viewport } from "./capture.ts";
+export interface CaptureCommand {
+    readonly kind: "capture";
+    readonly capture: CaptureOptions;
+    /** Upload the shot right after capturing it. */
+    readonly upload: boolean;
+    readonly prefix: string | undefined;
+    /** Print `![caption](url)` lines instead of the bare URLs. */
+    readonly markdown: boolean;
+}
+export interface UploadCommand {
+    readonly kind: "upload";
+    readonly files: ReadonlyArray<string>;
+    readonly prefix: string | undefined;
+    readonly markdown: boolean;
+}
+export interface McpCommand {
+    readonly kind: "mcp";
+}
+export interface SkillCommand {
+    readonly kind: "skill";
+}
+export interface SetupCommand {
+    readonly kind: "setup";
+    readonly bucket: string;
+}
+export interface AlbumCommand {
+    readonly kind: "album";
+    readonly port: number | undefined;
+}
+export interface HelpCommand {
+    readonly kind: "help";
+}
+export type Command = CaptureCommand | UploadCommand | McpCommand | SkillCommand | SetupCommand | AlbumCommand | HelpCommand;
+export declare function parseViewport(value: string): Viewport;
+export declare function parseLocalStorage(entries: ReadonlyArray<string>): Record<string, string>;
+export declare function parseCommand(argv: ReadonlyArray<string>): Command;
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,OAAO,GACf,cAAc,GACd,aAAa,GACb,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,WAAW,CAAC;AAEhB,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAMrD;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUxF;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAqEjE"}