@minicor/mcp-server 2.0.0

package/README.md

@@ -0,0 +1,169 @@
+# Minicor MCP Server
+
+> Formerly known as Laminar
+
+Desktop and browser RPA automation, workflow management, and AI-powered debugging for the Minicor platform -- all from **Cursor** or **Claude Code**.
+
+## Install
+
+```bash
+npm install -g @minicor/mcp-server
+minicor-mcp-setup
+```
+
+This opens a browser where you can **sign in** or **create an account**, set up workspaces, and optionally configure advanced services (Elasticsearch, CRON). Tokens are stored at `~/.minicor/tokens.json` and auto-refresh.
+
+For headless environments:
+
+```bash
+minicor-mcp-setup --cli
+```
+
+Restart Cursor to activate.
+
+## How It Works
+
+The setup writes this to `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "minicor": {
+      "command": "node",
+      "args": ["/path/to/dist/index.js"]
+    }
+  }
+}
+```
+
+No API keys needed -- authentication is handled by your stored session token.
+
+### Claude Code
+
+```bash
+claude mcp add minicor node /absolute/path/to/mcp/dist/index.js
+```
+
+## Features
+
+- **Workspaces** -- list, inspect, manage workspace members
+- **Workflows** -- create, update, clone, delete, restore workflows
+- **Flows (Steps)** -- read/write individual steps, view version history, bulk update
+- **Executions** -- list, search, filter by date/status, inspect full payloads, view per-step results
+- **Execute** -- trigger workflows synchronously or async, poll for status
+- **Configuration Stores** -- manage key-value configs used by `{{config.xxx}}` references
+- **Issues** -- create and manage workspace issues
+- **Desktop RPA** -- connect to a VM, take screenshots, inspect UI, run scripts, build RPA workflows iteratively
+- **Browser RPA** -- session-based browser automation with natural-language actions
+- **RPA Debugging** -- before/after screenshots, batch testing, state reset, execution diagnosis
+- **Log Search** _(advanced)_ -- full-text Elasticsearch search across execution logs
+- **Incident Investigation** -- correlate failures across workflows with timeline analysis
+- **CRON Management** _(advanced)_ -- scheduled job management
+- **Workflow File Sync** -- pull/push workflows to local files for git version control
+
+## Desktop RPA
+
+Connect to a VM running the Laminar Desktop Service (LDS) and iteratively build RPA workflows.
+
+### Setup LDS on a VM
+
+Use the `get_lds_setup_guide` tool for step-by-step instructions, or:
+
+1. Install LDS on the target Windows VM
+2. Start it on port 1016
+3. Expose via Cloudflare Tunnel: `cloudflared tunnel --url http://localhost:1016`
+4. In Cursor: `vm_connect` with the tunnel URL
+
+### RPA Tools
+
+| Tool | Description |
+|---|---|
+| `vm_connect` | Connect to LDS via Cloudflare Tunnel URL |
+| `vm_screenshot` | Capture VM desktop screenshot |
+| `vm_inspect_ui` | Inspect UI elements (accessibility tree, element at point, etc.) |
+| `vm_execute_script` | Run Python script on the VM |
+| `create_rpa_flow` | Save validated Python script as an RPA step (auto-wraps in correct format) |
+| `vm_read_clipboard` | Read clipboard text after copy operations |
+| `vm_screenshot_region` | Crop and zoom a specific screen region |
+| `debug_rpa_step` | Run script with before/after screenshots |
+| `vm_reset_state` | Smart Launch -- reset app to known state |
+| `batch_test_rpa` | Run workflow with multiple test inputs |
+| `get_lds_setup_guide` | Full LDS installation walkthrough |
+
+## Browser RPA
+
+Session-based browser automation for web applications.
+
+| Tool | Description |
+|---|---|
+| `browser_connect` | Connect to browser RPA service |
+| `browser_create_session` | Start a new browser session |
+| `browser_act` | Natural-language browser actions |
+| `browser_extract` | Extract data from the current page |
+| `browser_screenshot` | Screenshot the browser |
+| `browser_close_session` | Clean up session |
+| `create_browser_rpa_flow` | Save browser action as a workflow step |
+
+## Workflow Tools
+
+| Tool | Description |
+|---|---|
+| `preview_flow_changes` | Diff current vs proposed code before pushing |
+| `get_workflow_overview` | Full workflow snapshot with code + executions |
+| `test_workflow_step` | Run up to / from / only a specific step |
+| `diagnose_execution` | Find failures with RPA-specific error analysis |
+| `compare_flow_versions` | Diff between two step versions |
+
+## Advanced Setup
+
+Elasticsearch (log search) and CRON (scheduling) are configured during `minicor-mcp-setup` under Advanced Settings, or via `~/.minicor/config.json`:
+
+```json
+{
+  "elasticsearch": {
+    "endpoint": "https://your-es-cluster.cloud.io",
+    "apiKey": "your-es-api-key"
+  },
+  "cron": {
+    "apiKey": "your-cron-api-key"
+  }
+}
+```
+
+## Auth
+
+Authentication uses stored session tokens only. No API keys.
+
+- **Sign in / sign up**: `minicor-mcp-setup` (browser) or `minicor-mcp-setup --cli`
+- **Token storage**: `~/.minicor/tokens.json` (falls back to `~/.laminar/tokens.json` for existing users)
+- **Auto-refresh**: tokens refresh automatically before expiry
+- **Region**: US (default) or Canada, selected during setup
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+npm run dev        # watch mode
+npm run test:watch # test watch mode
+```
+
+### Project Structure
+
+```
+src/
+  index.ts          -- server orchestrator (auth, init, registration)
+  helpers.ts        -- shared response helpers (ok, text, safe, buildRpaProgram)
+  state.ts          -- session state (VM + browser connections)
+  paths.ts          -- token/config path resolution with ~/.minicor/ + ~/.laminar/ fallback
+  types.ts          -- shared ToolDeps interface
+  setup.ts          -- interactive setup (browser + CLI modes)
+  tools/            -- tool modules (each exports register())
+  prompts/          -- prompt modules (each exports register())
+  __tests__/        -- vitest unit tests
+```
+
+## License
+
+MIT

package/dist/__tests__/diff.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=diff.test.d.ts.map

package/dist/__tests__/diff.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/diff.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/diff.test.js

@@ -0,0 +1,23 @@
+import { describe, it, expect } from "vitest";
+import { computeDiff } from "../diff.js";
+describe("computeDiff", () => {
+    it("shows no changes for identical strings", () => {
+        const diff = computeDiff("hello\nworld", "hello\nworld", "A", "B");
+        expect(diff).not.toContain("+");
+        expect(diff).not.toContain("-");
+    });
+    it("shows additions", () => {
+        const diff = computeDiff("line1", "line1\nline2", "A", "B");
+        expect(diff).toContain("+ line2");
+    });
+    it("shows removals", () => {
+        const diff = computeDiff("line1\nline2", "line1", "A", "B");
+        expect(diff).toContain("- line2");
+    });
+    it("uses provided labels", () => {
+        const diff = computeDiff("a", "b", "Old", "New");
+        expect(diff).toContain("Old");
+        expect(diff).toContain("New");
+    });
+});
+//# sourceMappingURL=diff.test.js.map

package/dist/__tests__/diff.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.test.js","sourceRoot":"","sources":["../../src/__tests__/diff.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,IAAI,GAAG,WAAW,CAAC,cAAc,EAAE,cAAc,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QACnE,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iBAAiB,EAAE,GAAG,EAAE;QACzB,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAC5D,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gBAAgB,EAAE,GAAG,EAAE;QACxB,MAAM,IAAI,GAAG,WAAW,CAAC,cAAc,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAC5D,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QACjD,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/helpers.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=helpers.test.d.ts.map

package/dist/__tests__/helpers.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/helpers.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/helpers.test.js

@@ -0,0 +1,70 @@
+import { describe, it, expect } from "vitest";
+import { json, ok, text, safe, buildRpaProgram } from "../helpers.js";
+describe("json", () => {
+    it("serializes objects with 2-space indent", () => {
+        expect(json({ a: 1 })).toBe('{\n  "a": 1\n}');
+    });
+    it("handles null", () => {
+        expect(json(null)).toBe("null");
+    });
+});
+describe("ok", () => {
+    it("wraps data in MCP text content", () => {
+        const result = ok({ foo: "bar" });
+        expect(result.content).toHaveLength(1);
+        expect(result.content[0].type).toBe("text");
+        expect(JSON.parse(result.content[0].text)).toEqual({ foo: "bar" });
+    });
+});
+describe("text", () => {
+    it("wraps a string in MCP text content", () => {
+        const result = text("hello");
+        expect(result.content).toHaveLength(1);
+        expect(result.content[0].type).toBe("text");
+        expect(result.content[0].text).toBe("hello");
+    });
+});
+describe("safe", () => {
+    it("returns ok() on success", async () => {
+        const result = await safe(async () => ({ x: 1 }));
+        expect(JSON.parse(result.content[0].text)).toEqual({ x: 1 });
+    });
+    it("returns text() with error message on failure", async () => {
+        const result = await safe(async () => {
+            throw new Error("boom");
+        });
+        expect(result.content[0].text).toBe("Error: boom");
+    });
+});
+describe("buildRpaProgram", () => {
+    it("generates cloudflare_tunnel pattern with lam.httpRequest", () => {
+        const program = buildRpaProgram('print("hello")', "cloudflare_tunnel", "test-step", "Test Step", "A test step");
+        expect(program).toContain("lam.httpRequest");
+        expect(program).toContain("{{config.laminar_desktop_service_url}}/execute");
+        expect(program).toContain("{{config.laminar_desktop_service_api_key}}");
+        expect(program).toContain("{{config.laminar_desktop_service_id}}");
+        expect(program).toContain('"flowId": "test-step"');
+        expect(program).toContain('print("hello")');
+        expect(program).toMatch(/^\(data\) =>/);
+    });
+    it("generates channel pattern with lam.rpa", () => {
+        const program = buildRpaProgram('print("hello")', "channel", "test-step", "Test Step", "A test step");
+        expect(program).toContain("lam.rpa");
+        expect(program).toContain("{{config.channelId}}");
+        expect(program).not.toContain("lam.httpRequest");
+        expect(program).toMatch(/^\(data\) =>/);
+    });
+    it("escapes backticks and dollar signs in python script", () => {
+        const program = buildRpaProgram('f"value is ${x}" + `tick`', "cloudflare_tunnel", "id", "name", "desc");
+        expect(program).toContain("\\`");
+        expect(program).toContain("\\$");
+        // The escaped form \${x} should be present, not raw ${x}
+        expect(program).toContain("\\${x}");
+    });
+    it("escapes double quotes in step name and description", () => {
+        const program = buildRpaProgram("pass", "cloudflare_tunnel", "id", 'Step "with" quotes', 'Desc "here"');
+        expect(program).toContain('Step \\"with\\" quotes');
+        expect(program).toContain('Desc \\"here\\"');
+    });
+});
+//# sourceMappingURL=helpers.test.js.map

package/dist/__tests__/helpers.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.test.js","sourceRoot":"","sources":["../../src/__tests__/helpers.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/inspect-scripts.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=inspect-scripts.test.d.ts.map

package/dist/__tests__/inspect-scripts.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-scripts.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/inspect-scripts.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/inspect-scripts.test.js

@@ -0,0 +1,66 @@
+import { describe, it, expect } from "vitest";
+import { generateInspectScript } from "../inspect-scripts.js";
+describe("generateInspectScript", () => {
+    describe("uiautomation (auto)", () => {
+        it("generates window_list script", () => {
+            const script = generateInspectScript({ mode: "window_list" });
+            expect(script).toContain("import json, uiautomation as auto");
+            expect(script).toContain("GetRootControl");
+            expect(script).toContain("print(json.dumps");
+        });
+        it("generates screen_info script", () => {
+            const script = generateInspectScript({ mode: "screen_info" });
+            expect(script).toContain("GetSystemMetrics");
+            expect(script).toContain("screenWidth");
+        });
+        it("generates element_at_point script with coordinates", () => {
+            const script = generateInspectScript({
+                mode: "element_at_point",
+                x: 100,
+                y: 200,
+            });
+            expect(script).toContain("x, y = 100, 200");
+            expect(script).toContain("ControlFromPoint");
+        });
+        it("generates element_tree script with depth", () => {
+            const script = generateInspectScript({
+                mode: "element_tree",
+                depth: 5,
+            });
+            expect(script).toContain("MAX_DEPTH = 5");
+            expect(script).toContain("build_tree");
+        });
+        it("generates element_tree script with window title", () => {
+            const script = generateInspectScript({
+                mode: "element_tree",
+                windowTitle: "Open Dental",
+            });
+            expect(script).toContain('"Open Dental"');
+            expect(script).toContain("WindowControl");
+        });
+        it("generates focused_element script", () => {
+            const script = generateInspectScript({ mode: "focused_element" });
+            expect(script).toContain("GetFocusedControl");
+        });
+    });
+    describe("pywinauto", () => {
+        it("generates window_list script", () => {
+            const script = generateInspectScript({
+                mode: "window_list",
+                framework: "pywinauto",
+            });
+            expect(script).toContain("from pywinauto import Desktop");
+            expect(script).toContain('backend="uia"');
+        });
+    });
+    describe("jab", () => {
+        it("generates window_list script", () => {
+            const script = generateInspectScript({
+                mode: "window_list",
+                framework: "jab",
+            });
+            expect(script).toContain("JavaAccessBridgeWrapper");
+        });
+    });
+});
+//# sourceMappingURL=inspect-scripts.test.js.map

package/dist/__tests__/inspect-scripts.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-scripts.test.js","sourceRoot":"","sources":["../../src/__tests__/inspect-scripts.test.ts"],"names":[],"mappings":"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"}

package/dist/browser-client.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Stateless HTTP client for Browser RPA sessions.
+ *
+ * Matches the session-based API pattern from Sully QA workspace:
+ *   POST /sessions           → create session
+ *   POST /sessions/:id/act   → send action
+ *   POST /sessions/:id/extract → extract data
+ *   GET  /sessions/:id/screenshot → screenshot
+ *   DELETE /sessions/:id     → close session
+ */
+export interface BrowserAuth {
+    bearerToken: string;
+}
+export interface BrowserSessionResponse {
+    sessionId: string;
+    [key: string]: unknown;
+}
+export interface BrowserActResponse {
+    success?: boolean;
+    result?: unknown;
+    [key: string]: unknown;
+}
+export interface BrowserExtractResponse {
+    success?: boolean;
+    data?: unknown;
+    [key: string]: unknown;
+}
+export interface BrowserScreenshotResponse {
+    image?: string;
+    screenshot?: string;
+    [key: string]: unknown;
+}
+export declare function createSession(baseUrl: string, auth: BrowserAuth, opts?: {
+    slackChannelId?: string;
+}): Promise<BrowserSessionResponse>;
+export declare function act(baseUrl: string, sessionId: string, message: string, auth: BrowserAuth): Promise<BrowserActResponse>;
+export declare function extract(baseUrl: string, sessionId: string, instructions: string, auth: BrowserAuth): Promise<BrowserExtractResponse>;
+export declare function screenshot(baseUrl: string, sessionId: string, auth: BrowserAuth): Promise<BrowserScreenshotResponse>;
+export declare function closeSession(baseUrl: string, sessionId: string, auth: BrowserAuth): Promise<{
+    closed: boolean;
+}>;
+//# sourceMappingURL=browser-client.d.ts.map

package/dist/browser-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-client.d.ts","sourceRoot":"","sources":["../src/browser-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAwBD,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,WAAW,EACjB,IAAI,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GACjC,OAAO,CAAC,sBAAsB,CAAC,CAOjC;AAED,wBAAsB,GAAG,CACvB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,kBAAkB,CAAC,CAO7B;AAED,wBAAsB,OAAO,CAC3B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,sBAAsB,CAAC,CAOjC;AAED,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,yBAAyB,CAAC,CAKpC;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CAO9B"}

package/dist/browser-client.js

@@ -0,0 +1,66 @@
+/**
+ * Stateless HTTP client for Browser RPA sessions.
+ *
+ * Matches the session-based API pattern from Sully QA workspace:
+ *   POST /sessions           → create session
+ *   POST /sessions/:id/act   → send action
+ *   POST /sessions/:id/extract → extract data
+ *   GET  /sessions/:id/screenshot → screenshot
+ *   DELETE /sessions/:id     → close session
+ */
+function normalizeUrl(base) {
+    return base.replace(/\/+$/, "");
+}
+function authHeaders(auth) {
+    return {
+        "Authorization": `Bearer ${auth.bearerToken}`,
+        "Content-Type": "application/json",
+    };
+}
+async function request(url, init) {
+    const res = await fetch(url, init);
+    if (!res.ok) {
+        const body = await res.text().catch(() => "");
+        throw new Error(`Browser RPA ${init?.method ?? "GET"} ${url} returned ${res.status}: ${body}`);
+    }
+    return res.json();
+}
+export async function createSession(baseUrl, auth, opts) {
+    const url = `${normalizeUrl(baseUrl)}/sessions`;
+    return request(url, {
+        method: "POST",
+        headers: authHeaders(auth),
+        body: JSON.stringify(opts?.slackChannelId ? { slackChannelId: opts.slackChannelId } : {}),
+    });
+}
+export async function act(baseUrl, sessionId, message, auth) {
+    const url = `${normalizeUrl(baseUrl)}/sessions/${sessionId}/act`;
+    return request(url, {
+        method: "POST",
+        headers: authHeaders(auth),
+        body: JSON.stringify({ message }),
+    });
+}
+export async function extract(baseUrl, sessionId, instructions, auth) {
+    const url = `${normalizeUrl(baseUrl)}/sessions/${sessionId}/extract`;
+    return request(url, {
+        method: "POST",
+        headers: authHeaders(auth),
+        body: JSON.stringify({ instructions }),
+    });
+}
+export async function screenshot(baseUrl, sessionId, auth) {
+    const url = `${normalizeUrl(baseUrl)}/sessions/${sessionId}/screenshot`;
+    return request(url, {
+        headers: { "Authorization": `Bearer ${auth.bearerToken}` },
+    });
+}
+export async function closeSession(baseUrl, sessionId, auth) {
+    const url = `${normalizeUrl(baseUrl)}/sessions/${sessionId}`;
+    await request(url, {
+        method: "DELETE",
+        headers: { "Authorization": `Bearer ${auth.bearerToken}` },
+    });
+    return { closed: true };
+}
+//# sourceMappingURL=browser-client.js.map

package/dist/browser-client.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * Laminar CLI — manage workflows from the terminal or CI/CD pipelines.
+ *
+ * Usage:
+ *   laminar init   --workspace <id> [--output <dir>]
+ *   laminar pull   [--all | --workflow <id> --output <dir>]
+ *   laminar push   [--changed | --workflow <dir>]
+ *   laminar diff   [--all | --workflow <dir>]
+ *
+ * Auth: Set LAMINAR_API_KEY env var, or run `laminar-mcp-setup` first.
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;GAUG"}