@spark-apps/quickpeek 1.1.2 → 1.2.0

package/mcp.mjs

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+
+// QuickPeek MCP server — demo-video generation over stdio.
+//
+// .mjs, not .js: this package is CommonJS (the CLI bundle is CJS), so a
+// plain .js here would be parsed as CommonJS and its imports would fail.
+//
+// A thin bootstrap: transport wiring, the protocol-stdout proxy, and
+// dispatch. Tool schemas and handlers live in src/mcp/ (bundled by tsup
+// into dist/mcp-tools.mjs), calling the command functions directly rather
+// than shelling out to the `qp` CLI.
+//
+// Deliberately NO delete tools: outputs are new files and the server never
+// removes anything a user recorded.
+
+import { readFileSync } from 'node:fs';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { TOOL_HANDLERS, TOOLS } from './dist/mcp-tools.mjs';
+
+const pkg = JSON.parse(readFileSync(new URL('./package.json', import.meta.url), 'utf8'));
+
+// Captured once, before anything ever patches process.stdout.write
+// (withSilencedStdout in dist/mcp-tools.mjs mutates it during tool calls).
+const REAL_STDOUT_WRITE = process.stdout.write.bind(process.stdout);
+
+// The transport resolves `.write` dynamically off whatever stdout object it
+// is handed — the SAME property withSilencedStdout mutates. Recording a
+// demo takes minutes and prints throughout, so a silenced call would
+// otherwise swallow or misdirect unrelated protocol responses. This proxy
+// always uses the pristine write captured above.
+const protocolStdout = new Proxy(process.stdout, {
+  get(target, prop, receiver) {
+    if (prop === 'write') return REAL_STDOUT_WRITE;
+    const value = Reflect.get(target, prop, receiver);
+    return typeof value === 'function' ? value.bind(target) : value;
+  },
+});
+
+const server = new Server(
+  { name: 'quickpeek', version: pkg.version },
+  { capabilities: { tools: {} } }
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+
+function toErrorResult(e) {
+  return {
+    content: [{ type: 'text', text: e?.message ?? String(e) }],
+    isError: true,
+  };
+}
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+  const handler = TOOL_HANDLERS[name];
+  if (!handler) return toErrorResult(new Error(`Unknown tool: ${name}`));
+  try {
+    return await handler(args ?? {});
+  } catch (e) {
+    // Never crash the server on a tool failure — surface it as a tool error.
+    return toErrorResult(e);
+  }
+});
+
+async function main() {
+  const transport = new StdioServerTransport(process.stdin, protocolStdout);
+  await server.connect(transport);
+}
+
+main().catch((e) => {
+  console.error(`quickpeek-mcp failed to start: ${e?.message ?? e}`);
+  process.exit(1);
+});

package/package.json

@@ -1,64 +1,80 @@
-{
-  "name": "@spark-apps/quickpeek",
-  "version": "1.1.2",
-  "description": "Auto-generate demo videos for your web app with AI",
-  "main": "dist/qp.js",
-  "bin": {
-    "quickpeek": "dist/qp.js",
-    "qp": "dist/qp.js"
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "scripts": {
-    "dev": "npx tsx src/qp.ts",
-    "build": "tsup",
-    "build:tsc": "tsc --noEmit",
-    "lint": "biome check src",
-    "lint:fix": "biome check --write src",
-    "format": "biome format --write src",
-    "test": "vitest run",
-    "clean": "rm -rf dist",
-    "publish:cli": "npm publish --access public"
-  },
-  "keywords": [
-    "demo",
-    "video",
-    "screen-recording",
-    "playwright",
-    "ai",
-    "tts",
-    "voiceover",
-    "automation",
-    "cli",
-    "documentation"
-  ],
-  "license": "MIT",
-  "dependencies": {
-    "chalk": "^5.6.2",
-    "dotenv": "^17.3.1",
-    "figlet": "^1.11.0",
-    "gradient-string": "^3.0.0",
-    "msedge-tts": "^2.0.4",
-    "ora": "^9.3.0",
-    "playwright": "^1.58.2"
-  },
-  "devDependencies": {
-    "@biomejs/biome": "^2.4.8",
-    "@types/node": "^20.19.37",
-    "tsup": "^8.5.1",
-    "tsx": "^4.21.0",
-    "typescript": "^5.9.3",
-    "vitest": "^4.1.0"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "pnpm": {
-    "onlyBuiltDependencies": [
-      "esbuild",
-      "msedge-tts"
-    ]
-  }
-}
+{
+  "name": "@spark-apps/quickpeek",
+  "version": "1.2.0",
+  "description": "Auto-generate demo videos for your web app with AI",
+  "main": "dist/qp.js",
+  "bin": {
+    "quickpeek": "dist/qp.js",
+    "qp": "dist/qp.js",
+    "quickpeek-mcp": "./mcp.mjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./web": {
+      "types": "./dist/web.d.mts",
+      "import": "./dist/web.mjs",
+      "default": "./dist/web.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "mcp.mjs"
+  ],
+  "scripts": {
+    "dev": "npx tsx src/qp.ts",
+    "build": "tsup",
+    "build:tsc": "tsc --noEmit",
+    "lint": "biome check src",
+    "lint:fix": "biome check --write src",
+    "format": "biome format --write src",
+    "test": "vitest run",
+    "clean": "rm -rf dist",
+    "publish:cli": "npm publish --access public"
+  },
+  "keywords": [
+    "demo",
+    "video",
+    "screen-recording",
+    "playwright",
+    "ai",
+    "tts",
+    "voiceover",
+    "automation",
+    "cli",
+    "documentation"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@spark-apps/video-kit": "^0.1.0",
+    "chalk": "^5.6.2",
+    "dotenv": "^17.3.1",
+    "figlet": "^1.11.0",
+    "gradient-string": "^3.0.0",
+    "msedge-tts": "^2.0.4",
+    "ora": "^9.3.0",
+    "playwright": "1.62.1"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.8",
+    "@types/node": "^20.19.37",
+    "tsup": "^8.5.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "esbuild",
+      "msedge-tts"
+    ]
+  }
+}