@writepanda/mcp 1.220.0 → 1.222.0

package/bin/appConnection.mjs

@@ -144,21 +144,30 @@ export async function connectInApp({
 	busyWaitMs = 20_000,
 	probe = probeHealth,
 	readFiles = fileCredentials,
+	excludePort = null,
 } = {}) {
 	const attempts = [];
 	const candidates = [];
 	const fromEnv = envCredentials(env);
-	if (fromEnv) candidates.push(fromEnv);
+	if (fromEnv && fromEnv.port !== excludePort) candidates.push(fromEnv);
 	let fileError = null;
 	try {
 		const fromFiles = await readFiles(dir);
-		if (!fromEnv || fromFiles.port !== fromEnv.port || fromFiles.token !== fromEnv.token) {
+		if (
+			fromFiles.port !== excludePort &&
+			(!fromEnv || fromFiles.port !== fromEnv.port || fromFiles.token !== fromEnv.token)
+		) {
 			candidates.push(fromFiles);
 		}
 	} catch (err) {
 		fileError = err?.message ?? String(err);
 	}
 	if (candidates.length === 0) {
+		if (excludePort !== null) {
+			throw unavailable(
+				`nothing is listening on 127.0.0.1:${excludePort} any more and PandaStudio hasn't advertised another address (${fileError ?? `${dir} still names that port`}).`,
+			);
+		}
 		throw unavailable(
 			`PandaStudio didn't pass its automation address to the tools and ${fileError ?? "the token/port files are missing"}.`,
 		);
@@ -175,6 +184,37 @@ export async function connectInApp({
 	throw unavailable(`PandaStudio's automation server didn't answer. ${attempts.join("; ")}.`);
 }
 
+/** A socket error meaning nothing accepted the connection: the request never
+ *  reached the app, so resending it can't run a command twice. */
+export function isConnectionRefused(err) {
+	const code = err?.code ?? err?.cause?.code;
+	return code === "ECONNREFUSED" || code === "EADDRNOTAVAIL";
+}
+
+/**
+ * Send `call(creds)`. When the connection is REFUSED, the port we hold is
+ * stale: the app restarted its automation server on another port (a fallback
+ * from a busy preferred port, a Settings change, a relaunch) after the
+ * credentials were captured, e.g. in the environment of a long-lived agent
+ * process. Re-resolve once with `reresolve(staleCreds)` (which re-reads the
+ * token/port files) and resend to the new address. Only a refused connection
+ * is retried; any other failure may have reached the app.
+ *
+ * Returns { creds, res } with the credentials that worked. If re-resolving
+ * fails, its error (which says why) is thrown; if it yields the same address,
+ * the original error is.
+ */
+export async function callWithReconnect(creds, call, reresolve) {
+	try {
+		return { creds, res: await call(creds) };
+	} catch (err) {
+		if (!isConnectionRefused(err)) throw err;
+		const fresh = await reresolve(creds);
+		if (!fresh || (fresh.port === creds.port && fresh.token === creds.token)) throw err;
+		return { creds: fresh, res: await call(fresh) };
+	}
+}
+
 /**
  * Environment for LAUNCHING the desktop app. This server runs as Electron in
  * node mode (ELECTRON_RUN_AS_NODE=1), and a child inherits that: spawning

package/bin/server.mjs

@@ -38,6 +38,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 import {
 	appLaunchEnv,
+	callWithReconnect,
 	cleanFileValue,
 	configDir,
 	connectInApp,
@@ -116,7 +117,13 @@ async function autoLaunchAndWait(timeoutSec = 60) {
 	try {
 		// appLaunchEnv drops ELECTRON_RUN_AS_NODE: inherited, it made the
 		// "launch" start a Node REPL that exits instead of PandaStudio.
-		const child = spawn(bin, [], { detached: true, stdio: "ignore", env: appLaunchEnv() });
+		// windowsHide: false: this is the desktop app, whose window must show.
+		const child = spawn(bin, [], {
+			detached: true,
+			stdio: "ignore",
+			env: appLaunchEnv(),
+			windowsHide: false,
+		});
 		child.unref();
 	} catch (err) {
 		throw new Error(`failed to launch PandaStudio (${bin}): ${err?.message ?? err}`);
@@ -180,9 +187,16 @@ async function callPandastudio(command, args = {}) {
 	let creds = IN_APP ? await connectInApp() : await autoLaunchAndWait();
 	let res;
 	try {
-		res = await postCall(creds, command, args);
+		// A refused connection means the address went stale between the
+		// health probe and the call (the app moved its automation server):
+		// re-read where it is now and resend once.
+		({ creds, res } = await callWithReconnect(
+			creds,
+			(c) => postCall(c, command, args),
+			(stale) => (IN_APP ? connectInApp({ excludePort: stale.port }) : autoLaunchAndWait()),
+		));
 	} catch (err) {
-		if (!IN_APP) throw err;
+		if (!IN_APP || err?.inAppUnavailable) throw err;
 		throw new Error(
 			`${IN_APP_UNAVAILABLE}: the call to 127.0.0.1:${creds.port} failed (${err?.code ?? err?.message ?? err}).`,
 		);
@@ -924,7 +938,7 @@ const TOOLS = [
 	{
 		name: "connector_list",
 		description:
-			"List MCP connectors and their state. If the one needed isn't connected, tell the user its howToConnect line; you cannot connect connectors. status \"connected, last check failed\" (connected:false, lastCheck with reason, host and fix) means PandaStudio's own last use of it failed. auth \"api-key\" + needsKey: the user must paste a key in Settings (never ask for it in chat).",
+			'List MCP connectors and their state. If the one needed isn\'t connected, tell the user its howToConnect line; you cannot connect connectors. status "connected, last check failed" (connected:false, lastCheck with reason, host and fix) means PandaStudio\'s own last use of it failed. auth "api-key" + needsKey: the user must paste a key in Settings (never ask for it in chat).',
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -3034,7 +3048,7 @@ const TOOLS = [
 				fontFamily: {
 					type: "string",
 					description:
-						"text font, default Inter. A family asset_list_fonts returns; an unknown one fails with the families that work.",
+						'text font, default Inter. Any font that renders: bundled, imported, or installed, including a weight written into the name ("Montserrat ExtraBold") or a PostScript name ("Montserrat-ExtraBold"). A font that draws differently (variable font, nearest weight, unreadable file) passes with a warning; only a name nothing on this computer provides fails, with the families that work.',
 				},
 				arrowDirection: {
 					type: "string",
@@ -3332,7 +3346,7 @@ const TOOLS = [
 	{
 		name: "project_update_region",
 		description:
-			"Patch a region; unspecified fields are kept. Patchable: zoom (depth, focusX, focusY, focusMode static|auto), trim / speed (startMs, endMs, speed, rampIn, rampOut, preservePitch, freezeMs, reverse, reverseAudio), fx (atMs, durationMs, opacity, blendMode, speed, zIndex), annotation (zIndex), overlay (x, y, width, height in canvas %, layer, opacity, blendMode, muted, volume, loop, motionBlur, zIndex), adjustment (startMs, endMs, blendMode), motion (motionBlur), clip-transform (startMs, endMs, preset, transitionMs, easing, bezier), background-effect (as project_add_background_effect), audio-overlay (startMs, endMs, sourceStartMs, volume 0-2, fadeIn, fadeOut).",
+			"Patch a region; unspecified fields are kept. Patchable: zoom (depth, focusX, focusY, focusMode static|auto), trim / speed (startMs, endMs, speed, rampIn, rampOut, preservePitch, freezeMs, reverse, reverseAudio), fx (startMs, endMs, opacity, blendMode, speed, zIndex), annotation (startMs, endMs, text = the words shown (content / textContent also work), x, y, width, height, the style fields below, zIndex), overlay (x, y, width, height in canvas %, layer, opacity, blendMode, muted, volume, loop, motionBlur, zIndex), adjustment (startMs, endMs, blendMode), motion (motionBlur), clip-transform (startMs, endMs, preset, transitionMs, easing, bezier), background-effect (as project_add_background_effect), audio-overlay (startMs, endMs, sourceStartMs, volume 0-2, fadeIn, fadeOut). A key the region type doesn't have is not applied: the result lists it in ignoredKeys with a warning, and the call fails when nothing in the patch applies.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -3344,7 +3358,7 @@ const TOOLS = [
 				patch: {
 					type: "object",
 					description:
-						"e.g. { depth: 4 }. Annotation: fontSize, fontFamily (a family asset_list_fonts returns; an unknown one fails with the families that work), textColor (alias color), backgroundColor, fontWeight, fontStyle, textDecoration, textAlign, flat or nested under style/styles; merges into canonical style, preserving other fields. Flat wins over styles, then style. null clears a value. zIndex (overlay / annotation / fx): stack order, higher on top; overlays, annotations and front motion elements share one stack at group base + zIndex (B-roll 0, overlays 1000, annotations 2000, motion elements 3000).",
+						'e.g. { depth: 4 }. Annotation: fontSize, fontFamily (any bundled, imported or installed font, including weight-named families like "Montserrat ExtraBold" and PostScript names; only a name nothing here provides fails), textColor (alias color), backgroundColor, fontWeight, fontStyle, textDecoration, textAlign, flat or nested under style/styles; merges into canonical style, preserving other fields. Flat wins over styles, then style. null clears a value. zIndex (overlay / annotation / fx): stack order, higher on top; overlays, annotations and front motion elements share one stack at group base + zIndex (B-roll 0, overlays 1000, annotations 2000, motion elements 3000).',
 				},
 				expectedRevision: { type: "number" },
 			},
@@ -5689,7 +5703,7 @@ const TOOLS = [
 	{
 		name: "asset_list_fonts",
 		description:
-			"Font families text can use: bundled, scriptFallbacks (Noto, used per character for Indic/Arabic/Hebrew/Thai text), custom (the user's imported fonts; prefer one covering the video's language), system with includeSystem. Pass one to caption_set_style fontFamily.",
+			"Font families text can use (a missing one: asset_import_font): bundled, scriptFallbacks (Noto, used per character for Indic/Arabic/Hebrew/Thai text), custom (the user's imported fonts; prefer one covering the video's language), system with includeSystem. Pass one to caption_set_style fontFamily.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -5698,6 +5712,23 @@ const TOOLS = [
 		},
 		command: "asset.list-fonts",
 	},
+	{
+		name: "asset_import_font",
+		description:
+			'Import a font like the font picker does, so captions, annotations and motion elements can use it: a local file (path: .ttf/.otf/.woff/.woff2, 30 MB max) or a Google Fonts family (google: "Montserrat", downloaded now). Only fonts the user owns or openly licensed ones. Returns { family } to pass as fontFamily; an already imported family is reused.',
+		inputSchema: {
+			type: "object",
+			properties: {
+				path: { type: "string", description: "Absolute font file path. Give path or google." },
+				google: { type: "string", description: "Google Fonts family name. Give path or google." },
+				family: {
+					type: "string",
+					description: "path only: name to register it under (default: the font's own family).",
+				},
+			},
+		},
+		command: "asset.import-font",
+	},
 
 	// ── project-aware LLM ──────────────────────────────────────────
 	{

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@writepanda/mcp",
-	"version": "1.220.0",
+	"version": "1.222.0",
 	"description": "Model Context Protocol server for PandaStudio. Exposes the desktop video editor's automation surface to Cursor, Continue, Cline, Claude Desktop, and any MCP-compliant client.",
 	"keywords": [
 		"pandastudio",