mirror of
https://github.com/penpot/penpot.git
synced 2026-10-03 17:26:16 +00:00
8efbd9b5d3
* 🎉 Add multi-file session routing to the MCP server Session routing: - Track each user's Penpot connections by session ID. - Dispatch explicit sessions directly; otherwise discover the sole session. - Return a retryable error when discovery fails or is incomplete. Plugin and tools: - Initialize connections with a fresh session ID and file metadata. - Share the optional sessionId schema and place it last in tool inputs. Validation: - 84 tests, server type checking, and MCP formatting checks pass. - Disable test logging to avoid the logging worker shutdown hang. AI-assisted-by: gpt-6 * 🎉 Support independent MCP connections - Require explicit connection intent for each integrated workspace. - Derive short session IDs from the Penpot app instance and file. - Show and copy session IDs in the MCP menu and standalone plugin UI. - Stop stale callbacks and reconnect attempts after disconnect. Validate with frontend and plugin tests, type checking, live multi-tab checks, and standalone UI checks with a simulated connection. Server tests pass with --test-force-exit; the normal runner can hang on shutdown. AI-assisted-by: gpt-6 * 📚 Document multi-file MCP sessions - Explain independent connections, session selection, and copying IDs. - Describe session ID lifetimes for integrated and standalone plugins. - Correct browser focus, connection, and recovery guidance. Validate with the documentation site build and diff checks. AI-assisted-by: gpt-6 * ✨ Change behavior on session ID duplication * ✨ Open MCP toolbar menu on hover and match menu style --------- Co-authored-by: alonso.torres <alonso.torres@kaleidos.net> Co-authored-by: elhombretecla <delacruzgarciajuan@gmail.com>
23 lines
756 B
TypeScript
23 lines
756 B
TypeScript
import type { WebSocket } from "ws";
|
|
import type { PenpotSession } from "@penpot/mcp-common";
|
|
|
|
/**
|
|
* Observable liveness state of a plugin connection.
|
|
*/
|
|
export interface PluginLivenessState {
|
|
/** timestamp of the last plugin message, in ms since epoch. */
|
|
lastHeartbeat: number;
|
|
/** whether the plugin reported a browser freeze. */
|
|
frozen: boolean;
|
|
}
|
|
|
|
/** One local Penpot WebSocket connection and its session metadata. */
|
|
export interface PenpotConnection extends PluginLivenessState {
|
|
readonly socket: WebSocket;
|
|
readonly userToken: string | null;
|
|
readonly session: PenpotSession;
|
|
readonly pingInterval: NodeJS.Timeout;
|
|
/** whether initialization and dispatch subscriptions have completed. */
|
|
ready: boolean;
|
|
}
|