@clipkit/mcp-server 1.0.0

package/dist/embedded-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedded-docs.js","sourceRoot":"","sources":["../src/embedded-docs.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,6DAA6D;AAC7D,sEAAsE;AAEtE,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAy8BxB,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAowE1B,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiTvB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# 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":""}

package/dist/index.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+// CLI entry for @clipkit/mcp-server.
+//
+// Starts an MCP server over stdio. The agent process (Claude Desktop,
+// Cursor, etc.) spawns this binary, communicates via JSON-RPC on
+// stdin/stdout, and we never write to stdout ourselves — diagnostic
+// output goes to stderr.
+//
+// This is the stdio bin. Importing the package (`@clipkit/mcp-server`) resolves
+// to the library entry (lib.ts) — the building blocks for hosting the server
+// behind an HTTP route — WITHOUT this stdio bootstrap.
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { InMemoryProjectStore } from './project-store.js';
+import { registerTools } from './tools.js';
+import { registerResources } from './resources.js';
+import { SERVER_INFO, SERVER_CAPABILITIES, SERVER_INSTRUCTIONS } from './server-config.js';
+async function main() {
+    const server = new McpServer(SERVER_INFO, {
+        capabilities: SERVER_CAPABILITIES,
+        instructions: SERVER_INSTRUCTIONS,
+    });
+    // Local stdio: one in-memory project per process. project_id is optional and
+    // defaults to this single "current" project. (A hosted, sessionless server
+    // injects a Supabase-backed store and requires explicit project_ids instead.)
+    const store = new InMemoryProjectStore();
+    registerTools(server, store);
+    registerResources(server);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write('[clipkit-mcp] ready (tools + resources)\n');
+}
+main().catch((err) => {
+    process.stderr.write(`[clipkit-mcp] fatal: ${err instanceof Error ? err.stack ?? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,qCAAqC;AACrC,EAAE;AACF,sEAAsE;AACtE,iEAAiE;AACjE,oEAAoE;AACpE,yBAAyB;AACzB,EAAE;AACF,gFAAgF;AAChF,6EAA6E;AAC7E,uDAAuD;AAEvD,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE3F,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,WAAW,EAAE;QACxC,YAAY,EAAE,mBAAmB;QACjC,YAAY,EAAE,mBAAmB;KAClC,CAAC,CAAC;IAEH,6EAA6E;IAC7E,2EAA2E;IAC3E,8EAA8E;IAC9E,MAAM,KAAK,GAAG,IAAI,oBAAoB,EAAE,CAAC;IACzC,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC7B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE1B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;AACpE,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,wBAAwB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAC1F,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/lib.d.ts

@@ -0,0 +1,7 @@
+export { registerTools } from './tools.js';
+export { registerResources } from './resources.js';
+export { SERVER_INFO, SERVER_CAPABILITIES, SERVER_INSTRUCTIONS } from './server-config.js';
+export { type ProjectStore, type OpenProject, openProject, InMemoryProjectStore, } from './project-store.js';
+export { blankSource, cloneSource, locateElement, type ElementLocation } from './state.js';
+export { SOURCE_SCHEMA_JSON, elementSchemaJson } from './schema-json.js';
+//# sourceMappingURL=lib.d.ts.map

package/dist/lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC3F,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,WAAW,EACX,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/lib.js

@@ -0,0 +1,23 @@
+// Library entry for @clipkit/mcp-server.
+//
+// Importing the package (`@clipkit/mcp-server`) gives these building blocks for
+// HOSTING the server — e.g. behind a stateless HTTP route — WITHOUT the stdio
+// bootstrap that runs on import of index.ts. The stdio CLI remains the package
+// `bin` and the `./stdio` subpath export.
+//
+// A host wires it up the same way index.ts does, but with its own transport and
+// (typically) a non-in-memory ProjectStore:
+//
+//   const server = new McpServer(SERVER_INFO, {
+//     capabilities: SERVER_CAPABILITIES,
+//     instructions: SERVER_INSTRUCTIONS,
+//   });
+//   registerTools(server, store);   // store implements ProjectStore
+//   registerResources(server);
+export { registerTools } from './tools.js';
+export { registerResources } from './resources.js';
+export { SERVER_INFO, SERVER_CAPABILITIES, SERVER_INSTRUCTIONS } from './server-config.js';
+export { openProject, InMemoryProjectStore, } from './project-store.js';
+export { blankSource, cloneSource, locateElement } from './state.js';
+export { SOURCE_SCHEMA_JSON, elementSchemaJson } from './schema-json.js';
+//# sourceMappingURL=lib.js.map

package/dist/lib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.js","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,gFAAgF;AAChF,8EAA8E;AAC9E,+EAA+E;AAC/E,0CAA0C;AAC1C,EAAE;AACF,gFAAgF;AAChF,4CAA4C;AAC5C,EAAE;AACF,gDAAgD;AAChD,yCAAyC;AACzC,yCAAyC;AACzC,QAAQ;AACR,qEAAqE;AACrE,+BAA+B;AAE/B,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC3F,OAAO,EAGL,WAAW,EACX,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAwB,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/project-store.d.ts

@@ -0,0 +1,62 @@
+import type { Source } from '@clipkit/protocol';
+export interface ProjectStore {
+    /**
+     * Create or replace a project's source.
+     *  - `id` given   → replace that project's source.
+     *  - `id` omitted → create a new project. Single-tenant stores MAY reuse a
+     *    "current" slot; multi-tenant stores mint a fresh id.
+     * Returns the project's id.
+     */
+    put(id: string | undefined, source: Source): Promise<string>;
+    /** Load a project's source by id, or null if it is absent/expired. */
+    get(id: string): Promise<Source | null>;
+    /**
+     * The id a tool should act on when the caller omitted project_id.
+     * Single-tenant in-memory → the current project; multi-tenant → null
+     * (callers must pass an explicit project_id).
+     */
+    currentId(): Promise<string | null>;
+    /**
+     * Optional. If this store's rows ARE the editor's source of truth (a hosted DB
+     * store), return the editor URL for an existing project id, so open_in_editor /
+     * create_promo can link straight to it — no snapshot copy. Return null when the
+     * store can't surface a link itself (the in-memory stdio store), in which case
+     * the caller persists a share via the API instead.
+     */
+    editorUrl?(projectId: string): Promise<string | null>;
+}
+/** A loaded project plus a save() already bound to its id. */
+export interface OpenProject {
+    id: string;
+    source: Source;
+    save: (next: Source) => Promise<void>;
+}
+/**
+ * Resolve project_id (or the store's current project), load it, and hand back a
+ * bound save(). Returns an error string for the tool to surface if there is no
+ * such project — this is the single place the "missing/expired id" guidance
+ * lives, so every tool reports it consistently.
+ */
+export declare function openProject(store: ProjectStore, projectId: string | undefined): Promise<{
+    ok: true;
+    project: OpenProject;
+} | {
+    ok: false;
+    error: string;
+}>;
+/**
+ * In-memory store: one process, projects held in a Map. The default for local
+ * stdio. Seeds a blank "current" project so a fresh session can get_project /
+ * edit immediately and project_id stays optional locally.
+ */
+export declare class InMemoryProjectStore implements ProjectStore {
+    private projects;
+    private current;
+    private seq;
+    constructor(seedBlank?: boolean);
+    put(id: string | undefined, source: Source): Promise<string>;
+    get(id: string): Promise<Source | null>;
+    currentId(): Promise<string | null>;
+    private mint;
+}
+//# sourceMappingURL=project-store.d.ts.map

package/dist/project-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-store.d.ts","sourceRoot":"","sources":["../src/project-store.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGhD,MAAM,WAAW,YAAY;IAC3B;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE7D,sEAAsE;IACtE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAExC;;;;OAIG;IACH,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAEpC;;;;;;OAMG;IACH,SAAS,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACvD;AAED,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CA2B5E;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,GAAG,CAAK;gBAEJ,SAAS,UAAO;IAQtB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ5D,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKvC,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIzC,OAAO,CAAC,IAAI;CAIb"}

package/dist/project-store.js

@@ -0,0 +1,89 @@
+// ProjectStore — the persistence seam for MCP project state.
+//
+// Tools don't hold a Source; they ask the store to load/save one by id. That
+// indirection is what lets the same tool code run two very different ways:
+//
+//   • local stdio — one in-memory project per process (InMemoryProjectStore).
+//     project_id is optional and defaults to the single "current" project, so
+//     the local UX is unchanged: create_project / set_project then edit.
+//
+//   • hosted HTTP — many concurrent projects in a shared DB, the server fully
+//     SESSIONLESS. Each tool call carries an explicit project_id; the Supabase
+//     adapter (in apps/web) returns null from currentId(), so a missing id is a
+//     clear error rather than a cross-tenant guess.
+//
+// Going sessionless (no Mcp-Session-Id) and keying on a client-supplied
+// project_id is both the most portable choice across MCP clients (Codex,
+// Gemini CLI, Cursor, Cline, …) and the direction the spec is moving — the
+// 2026-07-28 release candidate drops protocol sessions entirely so "any MCP
+// request can land on any server instance" without a shared session store.
+import { blankSource, cloneSource } from './state.js';
+/**
+ * Resolve project_id (or the store's current project), load it, and hand back a
+ * bound save(). Returns an error string for the tool to surface if there is no
+ * such project — this is the single place the "missing/expired id" guidance
+ * lives, so every tool reports it consistently.
+ */
+export async function openProject(store, projectId) {
+    const id = projectId ?? (await store.currentId());
+    if (!id) {
+        return {
+            ok: false,
+            error: 'No active project. Create one with create_project or set_project, then pass the ' +
+                'returned project_id to subsequent tools.',
+        };
+    }
+    const source = await store.get(id);
+    if (!source) {
+        return {
+            ok: false,
+            error: `No project "${id}" (it may have expired). Pass a valid project_id, or create a new project.`,
+        };
+    }
+    return {
+        ok: true,
+        project: {
+            id,
+            source,
+            save: async (next) => {
+                await store.put(id, next);
+            },
+        },
+    };
+}
+/**
+ * In-memory store: one process, projects held in a Map. The default for local
+ * stdio. Seeds a blank "current" project so a fresh session can get_project /
+ * edit immediately and project_id stays optional locally.
+ */
+export class InMemoryProjectStore {
+    projects = new Map();
+    current = null;
+    seq = 0;
+    constructor(seedBlank = true) {
+        if (seedBlank) {
+            const id = this.mint();
+            this.projects.set(id, blankSource());
+            this.current = id;
+        }
+    }
+    async put(id, source) {
+        const pid = id ?? this.current ?? this.mint();
+        // Store an isolated copy so the caller's object can't mutate saved state.
+        this.projects.set(pid, cloneSource(source));
+        this.current = pid;
+        return pid;
+    }
+    async get(id) {
+        const src = this.projects.get(id);
+        return src ? cloneSource(src) : null;
+    }
+    async currentId() {
+        return this.current;
+    }
+    mint() {
+        this.seq += 1;
+        return `proj_${this.seq}`;
+    }
+}
+//# sourceMappingURL=project-store.js.map

package/dist/project-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-store.js","sourceRoot":"","sources":["../src/project-store.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,EAAE;AACF,6EAA6E;AAC7E,2EAA2E;AAC3E,EAAE;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,yEAAyE;AACzE,EAAE;AACF,8EAA8E;AAC9E,+EAA+E;AAC/E,gFAAgF;AAChF,oDAAoD;AACpD,EAAE;AACF,wEAAwE;AACxE,yEAAyE;AACzE,2EAA2E;AAC3E,4EAA4E;AAC5E,2EAA2E;AAG3E,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAuCtD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAmB,EACnB,SAA6B;IAE7B,MAAM,EAAE,GAAG,SAAS,IAAI,CAAC,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IAClD,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EACH,kFAAkF;gBAClF,0CAA0C;SAC7C,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,eAAe,EAAE,4EAA4E;SACrG,CAAC;IACJ,CAAC;IACD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,OAAO,EAAE;YACP,EAAE;YACF,MAAM;YACN,IAAI,EAAE,KAAK,EAAE,IAAY,EAAE,EAAE;gBAC3B,MAAM,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAC5B,CAAC;SACF;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,oBAAoB;IACvB,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IACrC,OAAO,GAAkB,IAAI,CAAC;IAC9B,GAAG,GAAG,CAAC,CAAC;IAEhB,YAAY,SAAS,GAAG,IAAI;QAC1B,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;YACrC,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAsB,EAAE,MAAc;QAC9C,MAAM,GAAG,GAAG,EAAE,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QAC9C,0EAA0E;QAC1E,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC;QACnB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClC,OAAO,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAEO,IAAI;QACV,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QACd,OAAO,QAAQ,IAAI,CAAC,GAAG,EAAE,CAAC;IAC5B,CAAC;CACF"}

package/dist/resources.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerResources(server: McpServer): void;
+//# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAuDzE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsCzD"}

package/dist/resources.js

@@ -0,0 +1,76 @@
+// MCP resources exposed by the Clipkit server.
+//
+// These are read-only docs the client can list and fetch on demand. They
+// give an AI agent (Claude Desktop, Cursor in MCP mode, etc.) the same
+// authoring context a human would get by browsing the repo:
+//
+//   clipkit://docs/agents.md     — AGENTS.md (authoring guide)
+//   clipkit://docs/protocol.md   — PROTOCOL.md (CKP/1.0 spec)
+//   clipkit://docs/brand.md      — BRAND.md (brand reference)
+//
+// Contents are embedded at build time (see scripts/embed-docs.mjs) so
+// the server is self-contained — no FS access required at runtime.
+import { AGENTS_MD, PROTOCOL_MD, BRAND_MD } from './embedded-docs.js';
+import { SOURCE_SCHEMA_JSON } from './schema-json.js';
+const DOCS = [
+    {
+        name: 'clipkit-agents',
+        uri: 'clipkit://docs/agents.md',
+        title: 'Clipkit — Authoring guide (AGENTS.md)',
+        description: 'AI authoring reference for Clipkit videos. Schema cheat sheet, ' +
+            'pattern catalog (HeaderBar / StatBlock / BarChartRow / RankedList / ' +
+            'PieCard), recipe gallery pointing at the working example videos, ' +
+            'and authoring guidance (pacing, count-ups, staggers). Read this ' +
+            'before composing a video.',
+        content: AGENTS_MD,
+    },
+    {
+        name: 'clipkit-protocol',
+        uri: 'clipkit://docs/protocol.md',
+        title: 'Clipkit Protocol v1.0 (PROTOCOL.md)',
+        description: 'Normative specification for the Clipkit Protocol (CKP/1.0). RFC ' +
+            '2119 voice — defines Source structure, every element type, the ' +
+            'animation model, easing functions, conformance levels (validate / ' +
+            'render / export), versioning, and the extension namespace. Source ' +
+            'of truth for implementers.',
+        content: PROTOCOL_MD,
+    },
+    {
+        name: 'clipkit-brand',
+        uri: 'clipkit://docs/brand.md',
+        title: 'Clipkit Brand reference (BRAND.md)',
+        description: 'Brand identity: dark surface system (#0A0A0A), two accents only ' +
+            '(red #EF4444 + yellow #FFB800), Geist + Geist Mono typography, the ' +
+            'three-bar logo construction, voice & tone (direct / concrete / ' +
+            'honest / no hype). Use when producing Clipkit-branded assets.',
+        content: BRAND_MD,
+    },
+];
+export function registerResources(server) {
+    for (const doc of DOCS) {
+        server.registerResource(doc.name, doc.uri, {
+            title: doc.title,
+            description: doc.description,
+            mimeType: 'text/markdown',
+        }, async (uri) => ({
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: 'text/markdown',
+                    text: doc.content,
+                },
+            ],
+        }));
+    }
+    server.registerResource('clipkit-schema', 'clipkit://schema/source.json', {
+        title: 'Clipkit Source — JSON Schema',
+        description: 'Machine-readable JSON Schema for a Clipkit Source, generated from the protocol Zod source ' +
+            'of truth. The EXACT shape for set_project / add_element — every field, every element type, ' +
+            'with types and enums. Read it to author correct JSON instead of guessing field names. ' +
+            '(Agents that cannot read resources: use the get_schema tool instead.)',
+        mimeType: 'application/json',
+    }, async (uri) => ({
+        contents: [{ uri: uri.href, mimeType: 'application/json', text: SOURCE_SCHEMA_JSON }],
+    }));
+}
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,EAAE;AACF,yEAAyE;AACzE,uEAAuE;AACvE,4DAA4D;AAC5D,EAAE;AACF,+DAA+D;AAC/D,8DAA8D;AAC9D,8DAA8D;AAC9D,EAAE;AACF,sEAAsE;AACtE,mEAAmE;AAGnE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAetD,MAAM,IAAI,GAAkB;IAC1B;QACE,IAAI,EAAE,gBAAgB;QACtB,GAAG,EAAE,0BAA0B;QAC/B,KAAK,EAAE,uCAAuC;QAC9C,WAAW,EACT,iEAAiE;YACjE,sEAAsE;YACtE,mEAAmE;YACnE,kEAAkE;YAClE,2BAA2B;QAC7B,OAAO,EAAE,SAAS;KACnB;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,GAAG,EAAE,4BAA4B;QACjC,KAAK,EAAE,qCAAqC;QAC5C,WAAW,EACT,kEAAkE;YAClE,iEAAiE;YACjE,oEAAoE;YACpE,oEAAoE;YACpE,4BAA4B;QAC9B,OAAO,EAAE,WAAW;KACrB;IACD;QACE,IAAI,EAAE,eAAe;QACrB,GAAG,EAAE,yBAAyB;QAC9B,KAAK,EAAE,oCAAoC;QAC3C,WAAW,EACT,kEAAkE;YAClE,qEAAqE;YACrE,iEAAiE;YACjE,+DAA+D;QACjE,OAAO,EAAE,QAAQ;KAClB;CACF,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,CAAC,gBAAgB,CACrB,GAAG,CAAC,IAAI,EACR,GAAG,CAAC,GAAG,EACP;YACE,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,QAAQ,EAAE,eAAe;SAC1B,EACD,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;YACd,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,GAAG,CAAC,IAAI;oBACb,QAAQ,EAAE,eAAe;oBACzB,IAAI,EAAE,GAAG,CAAC,OAAO;iBAClB;aACF;SACF,CAAC,CACH,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,gBAAgB,CACrB,gBAAgB,EAChB,8BAA8B,EAC9B;QACE,KAAK,EAAE,8BAA8B;QACrC,WAAW,EACT,4FAA4F;YAC5F,6FAA6F;YAC7F,wFAAwF;YACxF,uEAAuE;QACzE,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QACd,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;KACtF,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/schema-json.d.ts

@@ -0,0 +1,3 @@
+export declare const SOURCE_SCHEMA_JSON: string;
+export declare function elementSchemaJson(type: string): string | null;
+//# sourceMappingURL=schema-json.d.ts.map

package/dist/schema-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-json.d.ts","sourceRoot":"","sources":["../src/schema-json.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,kBAAkB,QAE9B,CAAC;AAkBF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE7D"}

package/dist/schema-json.js

@@ -0,0 +1,29 @@
+// JSON Schema for the Clipkit Source, generated from the protocol's Zod source
+// of truth (same as `clipkit schema`). Exposed to agents via the get_schema TOOL
+// — MCP *resources* aren't model-readable in clients like Claude Desktop (they're
+// user-attached), so a tool is the only reliable way to hand the agent the schema.
+//
+// Both the full Source schema and per-element-type schemas are precomputed once.
+import { sourceSchema, elementSchema } from '@clipkit/protocol';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+// Compact (no indentation): at this nesting depth ~60% of a pretty-printed schema is
+// leading whitespace, and the agent parses compact JSON fine. The human-facing
+// `clipkit schema` CLI can pretty-print separately if a person needs to read it.
+export const SOURCE_SCHEMA_JSON = JSON.stringify(zodToJsonSchema(sourceSchema, { name: 'ClipkitSource', $refStrategy: 'relative' }));
+// Per-type element schemas (much smaller than the full Source), keyed by type.
+const ELEMENT_SCHEMAS = {};
+{
+    const union = elementSchema;
+    const opts = union._def?.options ?? union.options ?? [];
+    for (const opt of opts) {
+        const shape = opt.shape;
+        const typeLit = shape?.type?._def?.value ?? shape?.type?.value;
+        if (typeof typeLit === 'string') {
+            ELEMENT_SCHEMAS[typeLit] = JSON.stringify(zodToJsonSchema(opt, { name: `${typeLit}Element`, $refStrategy: 'relative' }));
+        }
+    }
+}
+export function elementSchemaJson(type) {
+    return ELEMENT_SCHEMAS[type] ?? null;
+}
+//# sourceMappingURL=schema-json.js.map

package/dist/schema-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-json.js","sourceRoot":"","sources":["../src/schema-json.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,iFAAiF;AACjF,kFAAkF;AAClF,mFAAmF;AACnF,EAAE;AACF,iFAAiF;AAEjF,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,qFAAqF;AACrF,+EAA+E;AAC/E,iFAAiF;AACjF,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,SAAS,CAC9C,eAAe,CAAC,YAA0B,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC,CACjG,CAAC;AAEF,+EAA+E;AAC/E,MAAM,eAAe,GAA2B,EAAE,CAAC;AACnD,CAAC;IACC,MAAM,KAAK,GAAG,aAAwE,CAAC;IACvF,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,OAAO,IAAI,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;IACxD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,GAAI,GAAmF,CAAC,KAAK,CAAC;QACzG,MAAM,OAAO,GAAG,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,IAAI,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC;QAC/D,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,eAAe,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CACvC,eAAe,CAAC,GAAiB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC,CAC5F,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AACvC,CAAC"}

package/dist/server-config.d.ts

@@ -0,0 +1,10 @@
+export declare const SERVER_INFO: {
+    name: string;
+    version: string;
+};
+export declare const SERVER_CAPABILITIES: {
+    tools: {};
+    resources: {};
+};
+export declare const SERVER_INSTRUCTIONS: string;
+//# sourceMappingURL=server-config.d.ts.map

package/dist/server-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.d.ts","sourceRoot":"","sources":["../src/server-config.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,WAAW;;;CAAwC,CAAC;AAEjE,eAAO,MAAM,mBAAmB;;;CAA+B,CAAC;AAEhE,eAAO,MAAM,mBAAmB,QA0BiE,CAAC"}

package/dist/server-config.js

@@ -0,0 +1,33 @@
+// Shared server identity, capabilities, and agent instructions — used by BOTH
+// entry points (the stdio bin in index.ts and a hosted HTTP route) so a remote
+// server guides agents identically to the local one. Kept separate from
+// index.ts so the library entry can import these without the stdio bootstrap.
+export const SERVER_INFO = { name: 'clipkit', version: '0.0.0' };
+export const SERVER_CAPABILITIES = { tools: {}, resources: {} };
+export const SERVER_INSTRUCTIONS = 'Clipkit MCP — author Clipkit Protocol videos via tools, and read the canonical ' +
+    'authoring docs as resources. ' +
+    'BEFORE composing, call read_docs for the authoring guide (read_docs topic:"protocol" for ' +
+    'field semantics, topic:"brand" for brand-correct visuals). For exact field names + types ' +
+    'call get_schema (optionally with an element_type). These are TOOLS, not resources, so you ' +
+    'can read them directly. ' +
+    'TWO WAYS TO BUILD — pick by the brief, do NOT default to one: ' +
+    '(A) AUTHOR IT YOURSELF — write a full source JSON and call set_project. This is the full ' +
+    'creative canvas: every element type (text, image, video, shape, audio, group, caption, ' +
+    'particles) plus effects, 3D camera, lighting, gradients, keyframe animation, and ' +
+    'expressions. Use this for anything specific, original, or not a stock promo — most briefs. ' +
+    '(B) create_promo — a FAST path that assembles a conventional promo/intro/product/data ' +
+    'video from prebuilt scenes (it handles camera/glass/lighting/motion/layout). Good when a ' +
+    'template fits; it is ONE option, not the default. Mix scene types and fit the structure to ' +
+    'the content — do NOT reflexively make a glass-orb hero + CTA. ' +
+    'TWEAK an existing project with add_element / edit_element / delete_element. ' +
+    'SEE YOUR WORK — you cannot otherwise see the video: call preview_still for a frame, and ' +
+    'validate_project / describe_project for a structural read-back with render-time warnings. ' +
+    'The loop is edit → preview_still → fix. ' +
+    'CAPTIONS: transcribe_to_captions turns a media url (or local file) into a timed caption. ' +
+    'DELIVER: open_in_editor returns a free editor link; load_project re-imports a shared ' +
+    'project by id/URL; render_video renders a finished MP4 in the cloud (paid; needs ' +
+    'CLIPKIT_API_KEY). ' +
+    'PROJECT IDS: create_project / set_project / create_promo / load_project return a ' +
+    'project_id; pass it to subsequent tools (get_project / edit_element / preview_still / ' +
+    'validate_project / render_video / …). When working on a single local project you may omit it.';
+//# sourceMappingURL=server-config.js.map

package/dist/server-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.js","sourceRoot":"","sources":["../src/server-config.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,+EAA+E;AAC/E,wEAAwE;AACxE,8EAA8E;AAE9E,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAEjE,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;AAEhE,MAAM,CAAC,MAAM,mBAAmB,GAC9B,iFAAiF;IACjF,+BAA+B;IAC/B,2FAA2F;IAC3F,2FAA2F;IAC3F,4FAA4F;IAC5F,0BAA0B;IAC1B,gEAAgE;IAChE,2FAA2F;IAC3F,yFAAyF;IACzF,mFAAmF;IACnF,6FAA6F;IAC7F,wFAAwF;IACxF,2FAA2F;IAC3F,6FAA6F;IAC7F,gEAAgE;IAChE,8EAA8E;IAC9E,0FAA0F;IAC1F,4FAA4F;IAC5F,0CAA0C;IAC1C,2FAA2F;IAC3F,uFAAuF;IACvF,mFAAmF;IACnF,oBAAoB;IACpB,mFAAmF;IACnF,wFAAwF;IACxF,+FAA+F,CAAC"}

package/dist/state.d.ts

@@ -0,0 +1,20 @@
+import type { Source } from '@clipkit/protocol';
+/** A fresh, empty project. */
+export declare function blankSource(): Source;
+/** Deep-clone a Source so a tool can mutate a trial copy before validating. */
+export declare function cloneSource(source: Source): Source;
+export interface ElementLocation {
+    /** The matched element, as a mutable record. */
+    element: Record<string, unknown>;
+    /** The array that holds it — top-level, a group's `elements`, or a mask's. */
+    container: unknown[];
+    /** Its index within `container`. */
+    index: number;
+}
+/**
+ * Find an element by id ANYWHERE in the tree — top-level, nested `group`
+ * children, or `group.mask` children — returning the array that holds it and
+ * the index, so callers can edit or splice it in place. Returns null if absent.
+ */
+export declare function locateElement(elements: unknown[], id: string): ElementLocation | null;
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,8BAA8B;AAC9B,wBAAgB,WAAW,IAAI,MAAM,CASpC;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,8EAA8E;IAC9E,SAAS,EAAE,OAAO,EAAE,CAAC;IACrB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAiBrF"}

package/dist/state.js

@@ -0,0 +1,49 @@
+// Source-manipulation helpers shared by the MCP tools.
+//
+// A "project" is just a Clipkit `Source`. Tools never own a Source directly;
+// they go through a ProjectStore (see project-store.ts) so the same tool code
+// works two ways: a single in-memory project over local stdio, or many
+// concurrent projects in a shared DB behind a hosted, sessionless HTTP server.
+/** A fresh, empty project. */
+export function blankSource() {
+    return {
+        output_format: 'mp4',
+        width: 1920,
+        height: 1080,
+        duration: 10,
+        frame_rate: 30,
+        elements: [],
+    };
+}
+/** Deep-clone a Source so a tool can mutate a trial copy before validating. */
+export function cloneSource(source) {
+    return JSON.parse(JSON.stringify(source));
+}
+/**
+ * Find an element by id ANYWHERE in the tree — top-level, nested `group`
+ * children, or `group.mask` children — returning the array that holds it and
+ * the index, so callers can edit or splice it in place. Returns null if absent.
+ */
+export function locateElement(elements, id) {
+    for (let i = 0; i < elements.length; i++) {
+        const el = elements[i];
+        if (!el || typeof el !== 'object')
+            continue;
+        const rec = el;
+        if (rec.id === id)
+            return { element: rec, container: elements, index: i };
+        if (Array.isArray(rec.elements)) {
+            const hit = locateElement(rec.elements, id);
+            if (hit)
+                return hit;
+        }
+        const mask = rec.mask;
+        if (mask && Array.isArray(mask.elements)) {
+            const hit = locateElement(mask.elements, id);
+            if (hit)
+                return hit;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,uEAAuE;AACvE,+EAA+E;AAI/E,8BAA8B;AAC9B,MAAM,UAAU,WAAW;IACzB,OAAO;QACL,aAAa,EAAE,KAAK;QACpB,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,IAAI;QACZ,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;KACb,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAW,CAAC;AACtD,CAAC;AAWD;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,QAAmB,EAAE,EAAU;IAC3D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,CAAC,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ;YAAE,SAAS;QAC5C,MAAM,GAAG,GAAG,EAA6B,CAAC;QAC1C,IAAI,GAAG,CAAC,EAAE,KAAK,EAAE;YAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QAC1E,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC5C,IAAI,GAAG;gBAAE,OAAO,GAAG,CAAC;QACtB,CAAC;QACD,MAAM,IAAI,GAAG,GAAG,CAAC,IAA0C,CAAC;QAC5D,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzC,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC7C,IAAI,GAAG;gBAAE,OAAO,GAAG,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,15 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type ProjectStore } from './project-store.js';
+/**
+ * Register the Clipkit tools on `server`.
+ *
+ * `options.localTranscription` (default true) gates `transcribe_to_captions`,
+ * which runs Whisper in a child process and needs ffmpeg + a writable FS. Hosts
+ * that can't provide those — the hosted /mcp route on serverless — pass `false`
+ * so the tool isn't advertised where it would always fail. (A hosted STT path,
+ * via render-service or a hosted endpoint, is a TODO — figure out later.)
+ */
+export declare function registerTools(server: McpServer, store: ProjectStore, options?: {
+    localTranscription?: boolean;
+}): void;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkBzE,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAqSpE;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,YAAY,EACnB,OAAO,GAAE;IAAE,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC7C,IAAI,CA09BN"}