@gravity-platform/miro-bridge 0.1.1

package/dist/MiroBridge/service/normalise.js

@@ -0,0 +1,52 @@
+"use strict";
+// Normalises common LLM parameter mistakes before they reach handlers.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normaliseParams = normaliseParams;
+// Extract item/widget ID from a full Miro URL, or return the value as-is.
+function extractMiroId(value) {
+    if (!value.includes("miro.com"))
+        return value;
+    const widgetMatch = value.match(/[?&](?:moveToWidget|focusWidget)=([^&]+)/);
+    if (widgetMatch)
+        return widgetMatch[1];
+    const boardMatch = value.match(/\/board\/([^/?]+)/);
+    if (boardMatch)
+        return boardMatch[1];
+    return value;
+}
+// Canonical param names — maps known wrong casings to correct ones.
+const ALIASES = {
+    parentID: "parentId",
+    ParentId: "parentId",
+    parent_id: "parentId",
+    startItemID: "startItemId",
+    endItemID: "endItemId",
+    itemID: "itemId",
+    fillcolor: "fillColor",
+    FillColor: "fillColor",
+    fontSize: "fontSize",
+    fontsize: "fontSize",
+    duedate: "dueDate",
+    DueDate: "dueDate",
+};
+// Fields whose values should be extracted as Miro IDs.
+const ID_FIELDS = new Set(["id", "parentId", "itemId", "startItemId", "endItemId"]);
+function normaliseParams(params) {
+    const result = {};
+    for (const [key, value] of Object.entries(params)) {
+        const normKey = ALIASES[key] ?? key;
+        let normValue = value;
+        // Extract IDs from URLs
+        if (ID_FIELDS.has(normKey) && typeof value === "string") {
+            normValue = extractMiroId(value);
+        }
+        // Coerce string booleans
+        if (value === "true")
+            normValue = true;
+        else if (value === "false")
+            normValue = false;
+        result[normKey] = normValue;
+    }
+    return result;
+}
+//# sourceMappingURL=normalise.js.map

package/dist/MiroBridge/service/normalise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalise.js","sourceRoot":"","sources":["../../../src/MiroBridge/service/normalise.ts"],"names":[],"mappings":";AAAA,uEAAuE;;AA+BvE,0CAqBC;AAlDD,0EAA0E;AAC1E,SAAS,aAAa,CAAC,KAAa;IAClC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9C,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC5E,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACpD,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;IACrC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,oEAAoE;AACpE,MAAM,OAAO,GAA2B;IACtC,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,UAAU;IACrB,WAAW,EAAE,aAAa;IAC1B,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;CACnB,CAAC;AAEF,uDAAuD;AACvD,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC;AAEpF,SAAgB,eAAe,CAAC,MAA2B;IACzD,MAAM,MAAM,GAAwB,EAAE,CAAC;IAEvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;QAEpC,IAAI,SAAS,GAAG,KAAK,CAAC;QAEtB,wBAAwB;QACxB,IAAI,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACxD,SAAS,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QAED,yBAAyB;QACzB,IAAI,KAAK,KAAK,MAAM;YAAE,SAAS,GAAG,IAAI,CAAC;aAClC,IAAI,KAAK,KAAK,OAAO;YAAE,SAAS,GAAG,KAAK,CAAC;QAE9C,MAAM,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/MiroBridge/util/types.d.ts

@@ -0,0 +1,78 @@
+export interface MiroBridgeConfig {
+    defaultX?: number;
+    defaultY?: number;
+}
+export type MiroColor = "yellow" | "orange" | "red" | "pink" | "violet" | "blue" | "cyan" | "green" | "light_green" | "gray" | "black" | "white";
+export type MiroShapeType = "rectangle" | "circle" | "triangle" | "rhombus" | "parallelogram" | "star" | "arrow" | "cross" | "flow_chart_process" | "flow_chart_decision" | "flow_chart_terminator" | "flow_chart_database" | "flow_chart_document" | "flow_chart_predefined_process";
+export type DiagramNodeShape = "process" | "decision" | "terminator" | "database" | "parallelogram" | "default";
+export interface DiagramNode {
+    id: string;
+    label: string;
+    shape: DiagramNodeShape;
+}
+export interface DiagramEdge {
+    from: string;
+    to: string;
+    label?: string;
+}
+export interface PositionedNode extends DiagramNode {
+    x: number;
+    y: number;
+}
+export interface DiagramLayout {
+    nodes: PositionedNode[];
+    bounds: {
+        width: number;
+        height: number;
+    };
+    edges: DiagramEdge[];
+}
+export interface AppCardField {
+    value?: string;
+    fillColor?: string;
+    textColor?: string;
+    iconUrl?: string;
+    iconShape?: "round" | "square";
+    tooltip?: string;
+}
+export interface BoardItem {
+    id: string;
+    type: string;
+    content?: string;
+    x?: number;
+    y?: number;
+    width?: number;
+    height?: number;
+    parentId?: string;
+    style?: Record<string, any>;
+}
+export interface BoardConnector {
+    id: string;
+    startItemId: string;
+    endItemId: string;
+    caption?: string;
+}
+export interface BoardTag {
+    id: string;
+    title: string;
+    color?: string;
+    itemIds: string[];
+}
+export interface BoardState {
+    items: BoardItem[];
+    connectors: BoardConnector[];
+    tags: BoardTag[];
+    version: number;
+    updatedAt: string;
+}
+export interface MiroToolResult {
+    requestId: string;
+    result?: any;
+    error?: string;
+}
+export interface MiroBridgeOutput {
+    __outputs: {
+        boardState: BoardState;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/MiroBridge/util/types.d.ts.map

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

package/dist/MiroBridge/util/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/MiroBridge/util/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/MiroBridge/util/types.ts"],"names":[],"mappings":""}

package/dist/credentials/index.d.ts

@@ -0,0 +1,23 @@
+export declare const MiroCredential: {
+    name: string;
+    displayName: string;
+    description: string;
+    properties: ({
+        name: string;
+        displayName: string;
+        type: "string";
+        required: boolean;
+        secret: boolean;
+        description: string;
+        placeholder: string;
+    } | {
+        name: string;
+        displayName: string;
+        type: "string";
+        required: boolean;
+        description: string;
+        placeholder: string;
+        secret?: undefined;
+    })[];
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/credentials/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/credentials/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;CAuB1B,CAAC"}

package/dist/credentials/index.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MiroCredential = void 0;
+exports.MiroCredential = {
+    name: "miroCredential",
+    displayName: "Miro",
+    description: "Credentials for Miro REST API",
+    properties: [
+        {
+            name: "accessToken",
+            displayName: "Access Token",
+            type: "string",
+            required: true,
+            secret: true,
+            description: "Miro OAuth access token",
+            placeholder: "eyJtaXJvLm9yaWdpbiI6...",
+        },
+        {
+            name: "boardId",
+            displayName: "Board ID",
+            type: "string",
+            required: true,
+            description: "The Miro board ID (from the board URL)",
+            placeholder: "uXjVIxxxxxx=",
+        },
+    ],
+};
+//# sourceMappingURL=index.js.map

package/dist/credentials/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/credentials/index.ts"],"names":[],"mappings":";;;AAAa,QAAA,cAAc,GAAG;IAC5B,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,MAAM;IACnB,WAAW,EAAE,+BAA+B;IAC5C,UAAU,EAAE;QACV;YACE,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,cAAc;YAC3B,IAAI,EAAE,QAAiB;YACvB,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,yBAAyB;YACtC,WAAW,EAAE,yBAAyB;SACvC;QACD;YACE,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,UAAU;YACvB,IAAI,EAAE,QAAiB;YACvB,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,wCAAwC;YACrD,WAAW,EAAE,cAAc;SAC5B;KACF;CACF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+declare const plugin: import("@gravity-platform/plugin-base").GravityPlugin;
+export default plugin;
+//# 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":"AAGA,QAAA,MAAM,MAAM,uDAeV,CAAC;AAEH,eAAe,MAAM,CAAC"}

package/dist/index.js

@@ -0,0 +1,55 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const plugin_base_1 = require("@gravity-platform/plugin-base");
+const package_json_1 = __importDefault(require("../package.json"));
+const plugin = (0, plugin_base_1.createPlugin)({
+    name: package_json_1.default.name,
+    version: package_json_1.default.version,
+    description: package_json_1.default.description,
+    async setup(api) {
+        const { initializePlatformFromAPI } = await Promise.resolve().then(() => __importStar(require("@gravity-platform/plugin-base")));
+        initializePlatformFromAPI(api);
+        const { MiroBridgeNode } = await Promise.resolve().then(() => __importStar(require("./MiroBridge/node")));
+        api.registerNode(MiroBridgeNode);
+        const { MiroCredential } = await Promise.resolve().then(() => __importStar(require("./credentials")));
+        api.registerCredential(MiroCredential);
+    },
+});
+exports.default = plugin;
+//# 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,+DAAoF;AACpF,mEAA0C;AAE1C,MAAM,MAAM,GAAG,IAAA,0BAAY,EAAC;IAC1B,IAAI,EAAE,sBAAW,CAAC,IAAI;IACtB,OAAO,EAAE,sBAAW,CAAC,OAAO;IAC5B,WAAW,EAAE,sBAAW,CAAC,WAAW;IAEpC,KAAK,CAAC,KAAK,CAAC,GAAqB;QAC/B,MAAM,EAAE,yBAAyB,EAAE,GAAG,wDAAa,+BAA+B,GAAC,CAAC;QACpF,yBAAyB,CAAC,GAAG,CAAC,CAAC;QAE/B,MAAM,EAAE,cAAc,EAAE,GAAG,wDAAa,mBAAmB,GAAC,CAAC;QAC7D,GAAG,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;QAEjC,MAAM,EAAE,cAAc,EAAE,GAAG,wDAAa,eAAe,GAAC,CAAC;QACzD,GAAG,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC;IACzC,CAAC;CACF,CAAC,CAAC;AAEH,kBAAe,MAAM,CAAC"}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@gravity-platform/miro-bridge",
+  "version": "0.1.1",
+  "description": "MiroBridge node: LLM-driven Miro board manipulation via MCP tools. Dispatches commands to the MiroBridge browser component running in the Miro iframe; results return via USER_ACTION sendUserAction.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@gravity-platform/plugin-base": "*"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}