rivet-design 0.5.7 → 0.5.8

package/dist/types/agent-protocol.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * WebSocket message types for communication between Rivet CLI and hosted Agent SDK server
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=agent-protocol.js.map

package/dist/types/agent-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-protocol.js","sourceRoot":"","sources":["../../src/types/agent-protocol.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/types/agent-tools.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Tool definitions for Agent SDK MCP server
+ * Tools proxy execution from hosted server to local CLI
+ */
+import { ComponentNode } from './change-types';
+/**
+ * Tool names that the Agent SDK can invoke
+ */
+export type AgentTool = 'search_components' | 'read_file' | 'write_file' | 'glob_files' | 'git_status' | 'git_diff';
+/**
+ * Parameters for each tool type
+ */
+export type ToolParams = {
+    search_components: {
+        className?: string;
+        id?: string;
+        tagName?: string;
+        textContent?: string;
+        componentTree?: ComponentNode[];
+    };
+    read_file: {
+        filePath: string;
+    };
+    write_file: {
+        filePath: string;
+        search: string;
+        replacement: string;
+        changes: string;
+    };
+    glob_files: {
+        pattern: string;
+    };
+    git_status: Record<string, never>;
+    git_diff: {
+        filePath?: string;
+    };
+};
+/**
+ * Generic tool result wrapper
+ */
+export type ToolResult = {
+    success: boolean;
+    data?: any;
+    error?: string;
+};
+/**
+ * Specific result types for each tool
+ */
+export type SearchComponentsResult = {
+    matches: Array<{
+        filePath: string;
+        depth?: number;
+    }>;
+};
+export type ReadFileResult = {
+    content: string;
+    filePath: string;
+};
+export type WriteFileResult = {
+    filePath: string;
+    originalCode: string;
+    modifiedCode: string;
+    changes: string;
+    modificationsApplied: number;
+};
+export type GlobFilesResult = {
+    files: string[];
+};
+export type GitStatusResult = {
+    staged: string[];
+    unstaged: string[];
+    untracked: string[];
+};
+export type GitDiffResult = {
+    diff: string;
+    filePath?: string;
+};
+//# sourceMappingURL=agent-tools.d.ts.map

package/dist/types/agent-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tools.d.ts","sourceRoot":"","sources":["../../src/types/agent-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,mBAAmB,GACnB,WAAW,GACX,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,iBAAiB,EAAE;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,aAAa,EAAE,CAAC;KACjC,CAAC;IACF,SAAS,EAAE;QACT,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,UAAU,EAAE;QACV,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,UAAU,EAAE;QACV,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAClC,QAAQ,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,KAAK,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC"}

package/dist/types/agent-tools.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Tool definitions for Agent SDK MCP server
+ * Tools proxy execution from hosted server to local CLI
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=agent-tools.js.map

package/dist/types/agent-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tools.js","sourceRoot":"","sources":["../../src/types/agent-tools.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/types/types.d.ts

@@ -0,0 +1,15 @@
+export type CreatePreviewRequest = {
+    repoUrl: string;
+    repoFullName: string;
+    branch: string;
+};
+export type CreatePreviewResponse = {
+    projectId: string;
+    previewUrl: string;
+    status: string;
+};
+export type ApiError = {
+    error: string;
+    details?: string;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types/types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC"}

package/dist/types/types.js

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

package/dist/types/types.js.map

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

package/dist/utils/skillWriter.d.ts

@@ -1,14 +1,17 @@
-export declare const SKILL_VERSION = 2;
+import { CURSOR_RULES_FILENAME } from './skills/cursor-rules';
+export declare const SKILL_DIR: string;
 export declare const SKILL_PATH: string;
-export declare const SKILL_VERSION_MARKER = "[//]: # (rivet-skill-version: 2)";
-export declare const SKILL_CONTENT = "[//]: # (rivet-skill-version: 2)\n# Rivet Visual Editor\n\nUse these tools to make visual changes to a running web app and apply them to source code.\n\n## Starting a session\n\n1. Call `detect_project` \u2014 returns `detectedPort` (the actual running port, may differ from `defaultPort`) and `portActive`\n2. If `portActive` is false, start the dev server in the background:\n   ```bash\n   cd {projectPath} && {packageManager} run {devCommand} &\n   ```\n   Then call `detect_project` again until `portActive` is true\n3. Call `open_visual_editor({ port: detectedPort })` \u2014 always pass `detectedPort`, never assume the default\n4. Tell the user: \"Rivet is open \u2014 make your visual changes and click 'Send to Claude Code' when ready.\"\n\n## Editing loop\n\n1. Call `watch_for_changes({ sessionId })` \u2014 blocks until the user clicks \"Send to Claude Code\" (up to 60s by default)\n2. If it times out (`hasChanges: false`), call it again to keep waiting\n3. When `hasChanges: true`, apply the changes to the source files listed in `sourceFiles`\n4. Hot reload happens automatically after file changes\n5. Tell the user what you changed, then loop back to step 1\n\n## Ending a session\n\nWhen the user says they're done, call `close_visual_editor({ sessionId })`.\n\n## Rules\n\n- **Always call `detect_project` first** \u2014 never assume the dev server is running\n- **Never auto-commit** after applying visual changes \u2014 let the user decide\n- Use `watch_for_changes` for interactive sessions, not `get_pending_changes`\n- `get_pending_changes` is a non-blocking immediate check \u2014 only use it to poll without blocking\n- The dev server stays running after `close_visual_editor`\n";
+export { CURSOR_RULES_FILENAME };
 /**
  * Write the companion Claude skill file.
- * Idempotent — skips if the current version is already installed.
+ * Idempotent — skips if the installed version is current or newer.
+ * Returns true if the file is current or was successfully written.
  */
+export declare function writeSkillFileIfNeeded(): boolean;
 /**
- * Returns true if the skill file is current or was successfully written,
- * false if the write failed.
+ * Write a Cursor rules file to {projectPath}/.cursor/rules/rivet.mdc.
+ * Idempotent — skips if the installed version is current or newer.
+ * Returns true if the file is current or was successfully written.
  */
-export declare function writeSkillFileIfNeeded(): boolean;
+export declare function writeCursorRulesIfNeeded(projectPath: string): boolean;
 //# sourceMappingURL=skillWriter.d.ts.map

package/dist/utils/skillWriter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skillWriter.d.ts","sourceRoot":"","sources":["../../src/utils/skillWriter.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,UAAU,QAAwD,CAAC;AAChF,eAAO,MAAM,oBAAoB,qCAAoD,CAAC;AAEtF,eAAO,MAAM,aAAa,+qDAmCzB,CAAC;AAEF;;;GAGG;AACH;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAqBhD"}
+{"version":3,"file":"skillWriter.d.ts","sourceRoot":"","sources":["../../src/utils/skillWriter.ts"],"names":[],"mappings":"AAUA,OAAO,EAGL,qBAAqB,EACtB,MAAM,uBAAuB,CAAC;AAK/B,eAAO,MAAM,SAAS,QAA2C,CAAC;AAClE,eAAO,MAAM,UAAU,QAA8C,CAAC;AAEtE,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAOjC;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CA2BhD;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAyBrE"}

package/dist/utils/skillWriter.js

@@ -3,74 +3,45 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SKILL_CONTENT = exports.SKILL_VERSION_MARKER = exports.SKILL_PATH = exports.SKILL_VERSION = void 0;
+exports.CURSOR_RULES_FILENAME = exports.SKILL_PATH = exports.SKILL_DIR = void 0;
 exports.writeSkillFileIfNeeded = writeSkillFileIfNeeded;
+exports.writeCursorRulesIfNeeded = writeCursorRulesIfNeeded;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const os_1 = __importDefault(require("os"));
 const logger_1 = require("./logger");
+const claude_skill_1 = require("./skills/claude-skill");
+const cursor_rules_1 = require("./skills/cursor-rules");
+Object.defineProperty(exports, "CURSOR_RULES_FILENAME", { enumerable: true, get: function () { return cursor_rules_1.CURSOR_RULES_FILENAME; } });
 const log = (0, logger_1.createLogger)('SkillWriter');
-// Skill file version — increment when content changes
-exports.SKILL_VERSION = 2;
-exports.SKILL_PATH = path_1.default.join(os_1.default.homedir(), '.claude', 'skills', 'rivet');
-exports.SKILL_VERSION_MARKER = `[//]: # (rivet-skill-version: ${exports.SKILL_VERSION})`;
-exports.SKILL_CONTENT = `${exports.SKILL_VERSION_MARKER}
-# Rivet Visual Editor
-
-Use these tools to make visual changes to a running web app and apply them to source code.
-
-## Starting a session
-
-1. Call \`detect_project\` — returns \`detectedPort\` (the actual running port, may differ from \`defaultPort\`) and \`portActive\`
-2. If \`portActive\` is false, start the dev server in the background:
-   \`\`\`bash
-   cd {projectPath} && {packageManager} run {devCommand} &
-   \`\`\`
-   Then call \`detect_project\` again until \`portActive\` is true
-3. Call \`open_visual_editor({ port: detectedPort })\` — always pass \`detectedPort\`, never assume the default
-4. Tell the user: "Rivet is open — make your visual changes and click 'Send to Claude Code' when ready."
-
-## Editing loop
-
-1. Call \`watch_for_changes({ sessionId })\` — blocks until the user clicks "Send to Claude Code" (up to 60s by default)
-2. If it times out (\`hasChanges: false\`), call it again to keep waiting
-3. When \`hasChanges: true\`, apply the changes to the source files listed in \`sourceFiles\`
-4. Hot reload happens automatically after file changes
-5. Tell the user what you changed, then loop back to step 1
-
-## Ending a session
-
-When the user says they're done, call \`close_visual_editor({ sessionId })\`.
-
-## Rules
-
-- **Always call \`detect_project\` first** — never assume the dev server is running
-- **Never auto-commit** after applying visual changes — let the user decide
-- Use \`watch_for_changes\` for interactive sessions, not \`get_pending_changes\`
-- \`get_pending_changes\` is a non-blocking immediate check — only use it to poll without blocking
-- The dev server stays running after \`close_visual_editor\`
-`;
+const SKILLS_BASE = path_1.default.join(os_1.default.homedir(), '.claude', 'skills');
+exports.SKILL_DIR = path_1.default.join(SKILLS_BASE, claude_skill_1.CLAUDE_SKILL_DIR);
+exports.SKILL_PATH = path_1.default.join(exports.SKILL_DIR, claude_skill_1.CLAUDE_SKILL_FILENAME);
+function getInstalledVersion(content, pattern) {
+    const match = content.match(pattern);
+    return match ? parseInt(match[1], 10) : 0;
+}
 /**
  * Write the companion Claude skill file.
- * Idempotent — skips if the current version is already installed.
- */
-/**
- * Returns true if the skill file is current or was successfully written,
- * false if the write failed.
+ * Idempotent — skips if the installed version is current or newer.
+ * Returns true if the file is current or was successfully written.
  */
 function writeSkillFileIfNeeded() {
     try {
-        const skillDir = path_1.default.dirname(exports.SKILL_PATH);
-        if (!fs_1.default.existsSync(skillDir)) {
-            fs_1.default.mkdirSync(skillDir, { recursive: true });
+        // If the old flat file exists at SKILL_DIR, remove it — we need a directory there now
+        if (fs_1.default.existsSync(exports.SKILL_DIR) && fs_1.default.statSync(exports.SKILL_DIR).isFile()) {
+            fs_1.default.unlinkSync(exports.SKILL_DIR);
+        }
+        if (!fs_1.default.existsSync(exports.SKILL_DIR)) {
+            fs_1.default.mkdirSync(exports.SKILL_DIR, { recursive: true });
         }
         if (fs_1.default.existsSync(exports.SKILL_PATH)) {
             const existing = fs_1.default.readFileSync(exports.SKILL_PATH, 'utf8');
-            if (existing.includes(exports.SKILL_VERSION_MARKER)) {
-                return true; // Already up to date
-            }
+            const installed = getInstalledVersion(existing, /rivet-skill-version:\s*(\d+)/);
+            if (installed >= claude_skill_1.CLAUDE_SKILL_VERSION)
+                return true;
         }
-        fs_1.default.writeFileSync(exports.SKILL_PATH, exports.SKILL_CONTENT, 'utf8');
+        fs_1.default.writeFileSync(exports.SKILL_PATH, claude_skill_1.CLAUDE_SKILL_CONTENT, 'utf8');
         log.info('Wrote Rivet Claude skill file');
         return true;
     }
@@ -79,4 +50,31 @@ function writeSkillFileIfNeeded() {
         return false;
     }
 }
+/**
+ * Write a Cursor rules file to {projectPath}/.cursor/rules/rivet.mdc.
+ * Idempotent — skips if the installed version is current or newer.
+ * Returns true if the file is current or was successfully written.
+ */
+function writeCursorRulesIfNeeded(projectPath) {
+    try {
+        const rulesDir = path_1.default.join(projectPath, '.cursor', 'rules');
+        const rulesPath = path_1.default.join(rulesDir, cursor_rules_1.CURSOR_RULES_FILENAME);
+        if (fs_1.default.existsSync(rulesPath)) {
+            const existing = fs_1.default.readFileSync(rulesPath, 'utf8');
+            const installed = getInstalledVersion(existing, /rivet-rules-version:\s*(\d+)/);
+            if (installed >= cursor_rules_1.CURSOR_RULES_VERSION)
+                return true;
+        }
+        if (!fs_1.default.existsSync(rulesDir)) {
+            fs_1.default.mkdirSync(rulesDir, { recursive: true });
+        }
+        fs_1.default.writeFileSync(rulesPath, cursor_rules_1.CURSOR_RULES_CONTENT, 'utf8');
+        log.info('Wrote Rivet Cursor rules file');
+        return true;
+    }
+    catch (error) {
+        log.debug('Could not write Cursor rules file:', error);
+        return false;
+    }
+}
 //# sourceMappingURL=skillWriter.js.map

package/dist/utils/skillWriter.js.map

@@ -1 +1 @@
-{"version":3,"file":"skillWriter.js","sourceRoot":"","sources":["../../src/utils/skillWriter.ts"],"names":[],"mappings":";;;;;;AAyDA,wDAqBC;AA9ED,4CAAoB;AACpB,gDAAwB;AACxB,4CAAoB;AACpB,qCAAwC;AAExC,MAAM,GAAG,GAAG,IAAA,qBAAY,EAAC,aAAa,CAAC,CAAC;AAExC,sDAAsD;AACzC,QAAA,aAAa,GAAG,CAAC,CAAC;AAClB,QAAA,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,YAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AACnE,QAAA,oBAAoB,GAAG,iCAAiC,qBAAa,GAAG,CAAC;AAEzE,QAAA,aAAa,GAAG,GAAG,4BAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCnD,CAAC;AAEF;;;GAGG;AACH;;;GAGG;AACH,SAAgB,sBAAsB;IACpC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,cAAI,CAAC,OAAO,CAAC,kBAAU,CAAC,CAAC;QAC1C,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,YAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,YAAE,CAAC,UAAU,CAAC,kBAAU,CAAC,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAG,YAAE,CAAC,YAAY,CAAC,kBAAU,EAAE,MAAM,CAAC,CAAC;YACrD,IAAI,QAAQ,CAAC,QAAQ,CAAC,4BAAoB,CAAC,EAAE,CAAC;gBAC5C,OAAO,IAAI,CAAC,CAAC,qBAAqB;YACpC,CAAC;QACH,CAAC;QAED,YAAE,CAAC,aAAa,CAAC,kBAAU,EAAE,qBAAa,EAAE,MAAM,CAAC,CAAC;QACpD,GAAG,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}
+{"version":3,"file":"skillWriter.js","sourceRoot":"","sources":["../../src/utils/skillWriter.ts"],"names":[],"mappings":"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"}

package/dist/utils/skills/claude-skill.d.ts

@@ -0,0 +1,6 @@
+export declare const CLAUDE_SKILL_VERSION = 4;
+export declare const CLAUDE_SKILL_VERSION_MARKER = "[//]: # (rivet-skill-version: 4)";
+export declare const CLAUDE_SKILL_DIR = "rivet";
+export declare const CLAUDE_SKILL_FILENAME = "SKILL.md";
+export declare const CLAUDE_SKILL_CONTENT = "---\nname: rivet\ndescription: Open the Rivet visual editor to make visual or UI changes to a running web app. Invoke when the user says \"open rivet\", \"use rivet\", \"/rivet\", or wants to visually edit their app.\n---\n\n[//]: # (rivet-skill-version: 4)\n# Rivet Visual Editor\n\nUse these tools to make visual changes to a running web app and apply them to source code.\n\n## Starting a session\n\n1. Call `detect_project` \u2014 returns `detectedPort` (the actual running port, may differ from `defaultPort`) and `portActive`\n2. If `portActive` is false, start the dev server in the background:\n   ```bash\n   cd {projectPath} && {packageManager} run {devCommand} &\n   ```\n   Then call `detect_project` again until `portActive` is true\n3. Call `open_visual_editor({ port: detectedPort })` \u2014 always pass `detectedPort`, never assume the default\n4. Tell the user: \"Rivet is open \u2014 make your visual changes and click 'Send to Claude Code' when ready.\"\n\n## Editing loop\n\n1. Call `watch_for_changes({ sessionId })` \u2014 blocks until the user clicks \"Send to Claude Code\" (up to 60s by default)\n2. If it times out (`hasChanges: false`), call it again to keep waiting\n3. When `hasChanges: true`, apply the changes to the source files listed in `sourceFiles`\n4. Hot reload happens automatically after file changes\n5. Tell the user what you changed, then loop back to step 1\n\n## Ending a session\n\nWhen the user says they're done, call `close_visual_editor({ sessionId })`.\n\n## Rules\n\n- **Always call `detect_project` first** \u2014 never assume the dev server is running\n- **Never auto-commit** after applying visual changes \u2014 let the user decide\n- Use `watch_for_changes` for interactive sessions, not `get_pending_changes`\n- `get_pending_changes` is a non-blocking immediate check \u2014 only use it to poll without blocking\n- The dev server stays running after `close_visual_editor`\n";
+//# sourceMappingURL=claude-skill.d.ts.map

package/dist/utils/skills/claude-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-skill.d.ts","sourceRoot":"","sources":["../../../src/utils/skills/claude-skill.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,2BAA2B,qCAA2D,CAAC;AAEpG,eAAO,MAAM,gBAAgB,UAAU,CAAC;AACxC,eAAO,MAAM,qBAAqB,aAAa,CAAC;AAEhD,eAAO,MAAM,oBAAoB,g5DAwChC,CAAC"}

package/dist/utils/skills/claude-skill.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLAUDE_SKILL_CONTENT = exports.CLAUDE_SKILL_FILENAME = exports.CLAUDE_SKILL_DIR = exports.CLAUDE_SKILL_VERSION_MARKER = exports.CLAUDE_SKILL_VERSION = void 0;
+exports.CLAUDE_SKILL_VERSION = 4;
+exports.CLAUDE_SKILL_VERSION_MARKER = `[//]: # (rivet-skill-version: ${exports.CLAUDE_SKILL_VERSION})`;
+exports.CLAUDE_SKILL_DIR = 'rivet';
+exports.CLAUDE_SKILL_FILENAME = 'SKILL.md';
+exports.CLAUDE_SKILL_CONTENT = `---
+name: rivet
+description: Open the Rivet visual editor to make visual or UI changes to a running web app. Invoke when the user says "open rivet", "use rivet", "/rivet", or wants to visually edit their app.
+---
+
+${exports.CLAUDE_SKILL_VERSION_MARKER}
+# Rivet Visual Editor
+
+Use these tools to make visual changes to a running web app and apply them to source code.
+
+## Starting a session
+
+1. Call \`detect_project\` — returns \`detectedPort\` (the actual running port, may differ from \`defaultPort\`) and \`portActive\`
+2. If \`portActive\` is false, start the dev server in the background:
+   \`\`\`bash
+   cd {projectPath} && {packageManager} run {devCommand} &
+   \`\`\`
+   Then call \`detect_project\` again until \`portActive\` is true
+3. Call \`open_visual_editor({ port: detectedPort })\` — always pass \`detectedPort\`, never assume the default
+4. Tell the user: "Rivet is open — make your visual changes and click 'Send to Claude Code' when ready."
+
+## Editing loop
+
+1. Call \`watch_for_changes({ sessionId })\` — blocks until the user clicks "Send to Claude Code" (up to 60s by default)
+2. If it times out (\`hasChanges: false\`), call it again to keep waiting
+3. When \`hasChanges: true\`, apply the changes to the source files listed in \`sourceFiles\`
+4. Hot reload happens automatically after file changes
+5. Tell the user what you changed, then loop back to step 1
+
+## Ending a session
+
+When the user says they're done, call \`close_visual_editor({ sessionId })\`.
+
+## Rules
+
+- **Always call \`detect_project\` first** — never assume the dev server is running
+- **Never auto-commit** after applying visual changes — let the user decide
+- Use \`watch_for_changes\` for interactive sessions, not \`get_pending_changes\`
+- \`get_pending_changes\` is a non-blocking immediate check — only use it to poll without blocking
+- The dev server stays running after \`close_visual_editor\`
+`;
+//# sourceMappingURL=claude-skill.js.map

package/dist/utils/skills/claude-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-skill.js","sourceRoot":"","sources":["../../../src/utils/skills/claude-skill.ts"],"names":[],"mappings":";;;AAAa,QAAA,oBAAoB,GAAG,CAAC,CAAC;AACzB,QAAA,2BAA2B,GAAG,iCAAiC,4BAAoB,GAAG,CAAC;AAEvF,QAAA,gBAAgB,GAAG,OAAO,CAAC;AAC3B,QAAA,qBAAqB,GAAG,UAAU,CAAC;AAEnC,QAAA,oBAAoB,GAAG;;;;;EAKlC,mCAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmC5B,CAAC"}

package/dist/utils/skills/cursor-rules.d.ts

@@ -0,0 +1,5 @@
+export declare const CURSOR_RULES_VERSION = 3;
+export declare const CURSOR_RULES_FILENAME = "rivet.mdc";
+export declare const CURSOR_RULES_VERSION_MARKER = "rivet-rules-version: 3";
+export declare const CURSOR_RULES_CONTENT = "---\ndescription: Rivet visual editor \u2014 apply when the user says \"open rivet\", \"open the visual editor\", or wants to make visual/UI changes to their web app\nalwaysApply: false\n---\n<!-- rivet-rules-version: 3 -->\n# Rivet Visual Editor\n\nUse these tools to make visual changes to a running web app and apply them to source code.\n\n> Tip: type `@rivet.mdc` in chat to invoke this rule manually.\n\n## Starting a session\n\n1. Call `detect_project` \u2014 returns `detectedPort` (the actual running port, may differ from `defaultPort`) and `portActive`\n2. If `portActive` is false, start the dev server in the background:\n   ```bash\n   cd {projectPath} && {packageManager} run {devCommand} &\n   ```\n   Then call `detect_project` again until `portActive` is true\n3. Call `open_visual_editor({ port: detectedPort })` \u2014 always pass `detectedPort`, never assume the default\n4. Tell the user: \"Rivet is open \u2014 make your visual changes and click 'Send to Cursor' when ready.\"\n\n## Editing loop\n\n1. Call `watch_for_changes({ sessionId })` \u2014 blocks until the user clicks \"Send to Cursor\" (up to 60s by default)\n2. If it times out (`hasChanges: false`), call it again to keep waiting\n3. When `hasChanges: true`, apply the changes to the source files listed in `sourceFiles`\n4. Hot reload happens automatically after file changes\n5. Tell the user what you changed, then loop back to step 1\n\n## Ending a session\n\nWhen the user says they're done, call `close_visual_editor({ sessionId })`.\n\n## Rules\n\n- **Always call `detect_project` first** \u2014 never assume the dev server is running\n- **Never auto-commit** after applying visual changes \u2014 let the user decide\n- Use `watch_for_changes` for interactive sessions, not `get_pending_changes`\n- `get_pending_changes` is a non-blocking immediate check \u2014 only use it to poll without blocking\n- The dev server stays running after `close_visual_editor`\n";
+//# sourceMappingURL=cursor-rules.d.ts.map

package/dist/utils/skills/cursor-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-rules.d.ts","sourceRoot":"","sources":["../../../src/utils/skills/cursor-rules.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,qBAAqB,cAAc,CAAC;AACjD,eAAO,MAAM,2BAA2B,2BAAiD,CAAC;AAE1F,eAAO,MAAM,oBAAoB,s6DAyChC,CAAC"}

package/dist/utils/skills/cursor-rules.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CURSOR_RULES_CONTENT = exports.CURSOR_RULES_VERSION_MARKER = exports.CURSOR_RULES_FILENAME = exports.CURSOR_RULES_VERSION = void 0;
+exports.CURSOR_RULES_VERSION = 3;
+exports.CURSOR_RULES_FILENAME = 'rivet.mdc';
+exports.CURSOR_RULES_VERSION_MARKER = `rivet-rules-version: ${exports.CURSOR_RULES_VERSION}`;
+exports.CURSOR_RULES_CONTENT = `---
+description: Rivet visual editor — apply when the user says "open rivet", "open the visual editor", or wants to make visual/UI changes to their web app
+alwaysApply: false
+---
+<!-- ${exports.CURSOR_RULES_VERSION_MARKER} -->
+# Rivet Visual Editor
+
+Use these tools to make visual changes to a running web app and apply them to source code.
+
+> Tip: type \`@rivet.mdc\` in chat to invoke this rule manually.
+
+## Starting a session
+
+1. Call \`detect_project\` — returns \`detectedPort\` (the actual running port, may differ from \`defaultPort\`) and \`portActive\`
+2. If \`portActive\` is false, start the dev server in the background:
+   \`\`\`bash
+   cd {projectPath} && {packageManager} run {devCommand} &
+   \`\`\`
+   Then call \`detect_project\` again until \`portActive\` is true
+3. Call \`open_visual_editor({ port: detectedPort })\` — always pass \`detectedPort\`, never assume the default
+4. Tell the user: "Rivet is open — make your visual changes and click 'Send to Cursor' when ready."
+
+## Editing loop
+
+1. Call \`watch_for_changes({ sessionId })\` — blocks until the user clicks "Send to Cursor" (up to 60s by default)
+2. If it times out (\`hasChanges: false\`), call it again to keep waiting
+3. When \`hasChanges: true\`, apply the changes to the source files listed in \`sourceFiles\`
+4. Hot reload happens automatically after file changes
+5. Tell the user what you changed, then loop back to step 1
+
+## Ending a session
+
+When the user says they're done, call \`close_visual_editor({ sessionId })\`.
+
+## Rules
+
+- **Always call \`detect_project\` first** — never assume the dev server is running
+- **Never auto-commit** after applying visual changes — let the user decide
+- Use \`watch_for_changes\` for interactive sessions, not \`get_pending_changes\`
+- \`get_pending_changes\` is a non-blocking immediate check — only use it to poll without blocking
+- The dev server stays running after \`close_visual_editor\`
+`;
+//# sourceMappingURL=cursor-rules.js.map

package/dist/utils/skills/cursor-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-rules.js","sourceRoot":"","sources":["../../../src/utils/skills/cursor-rules.ts"],"names":[],"mappings":";;;AAAa,QAAA,oBAAoB,GAAG,CAAC,CAAC;AACzB,QAAA,qBAAqB,GAAG,WAAW,CAAC;AACpC,QAAA,2BAA2B,GAAG,wBAAwB,4BAAoB,EAAE,CAAC;AAE7E,QAAA,oBAAoB,GAAG;;;;OAI7B,mCAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCjC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rivet-design",
-  "version": "0.5.7",
+  "version": "0.5.8",
   "description": "Local visual web development tool with AI-powered code modification",
   "main": "dist/index.js",
   "workspaces": [