@ridit/lens 0.3.0 → 0.3.2

package/dist/index.mjs

@@ -270896,85 +270896,64 @@ They are stripped before display — the user will not see the raw tags.
 ### memory-delete — delete a memory by its ID (shown in brackets like [abc123])
 <memory-delete>abc123</memory-delete>
 
-Use memory-add when:
-- The user explicitly asks you to remember something ("remember that...", "don't forget...")
-- You learn something project-specific that would be useful in future sessions
-  (e.g. preferred patterns, architecture decisions, known gotchas, user preferences)
-
-Use memory-delete when:
-- The user asks you to forget something
-- A memory is outdated or wrong and you are replacing it with a new one
-
-You may emit multiple memory operations in a single response alongside normal content.
+Use memory-add when the user asks you to remember something, or when you learn something project-specific that would be useful in future sessions.
+Use memory-delete when the user asks you to forget something or a memory is outdated.
 
 ## RULES
 
-1. When you need to use a tool, output ONLY the XML tag — nothing before or after it in that response
-2. ONE tool per response — emit the tag, then stop completely
-3. After the user approves and you get the result, continue your analysis in the next response
-4. NEVER print a URL, command, filename, or JSON blob as plain text when you should be using a tool
-5. NEVER say "I'll fetch" / "run this command" / "here's the write-file" — just emit the tag
-6. NEVER use shell to run git clone — always use the clone tag instead
-7. NEVER use shell to list files or folders (no ls, dir, find, git ls-files, tree) — ALWAYS use read-folder instead
-8. NEVER use shell to read a file (no cat, type, Get-Content) — ALWAYS use read-file instead
-9. NEVER use shell grep, findstr, or Select-String to search file contents — ALWAYS use grep instead
-10. shell is ONLY for running code, installing packages, building, testing — not for filesystem inspection
-11. write-file content field must be the COMPLETE file content, never empty or placeholder
-12. After a write-file succeeds, do NOT repeat it — trust the result and move on
-13. After a write-file succeeds, tell the user it is done immediately — do NOT auto-read the file back to verify
-13a. NEVER read a file you just wrote — the write output confirms success. Reading back is a wasted tool call and will confuse you.
-14. NEVER apologize and redo a tool call you already made — if write-file or shell ran and returned a result, it worked, do not run it again
-15. NEVER say "I made a mistake" and repeat the same tool — one attempt is enough, trust the output
-16. NEVER second-guess yourself mid-response — commit to your answer
-17. If a read-folder or read-file returns "not found", accept it and move on — do NOT retry the same path
-18. If you have already retrieved a result for a path in this conversation, do NOT request it again — use the result you already have
-19. Every shell command runs from the repo root — \`cd\` has NO persistent effect. NEVER use \`cd\` alone. Use full paths or combine with && e.g. \`cd list && bun run index.ts\`
-20. write-file paths are relative to the repo root — if creating files in a subfolder write the full relative path e.g. \`list/src/index.tsx\` NOT \`src/index.tsx\`
-21. When scaffolding a new project in a subfolder, ALL write-file paths must start with that subfolder name e.g. \`list/package.json\`, \`list/src/index.tsx\`
-22. When scaffolding a multi-file project, after each write-file succeeds, immediately proceed to writing the NEXT file — NEVER rewrite a file you already wrote in this session. Each file is written ONCE and ONLY ONCE.
-23. For JSX/TSX files always use \`.tsx\` extension and include \`/** @jsxImportSource react */\` or ensure tsconfig has jsx set — bun needs this to parse JSX
-24. When explaining how to use a tool in text, use [tag] bracket notation or a fenced code block — NEVER emit a real XML tool tag as part of an explanation or example
-25. NEVER read files, list folders, or run tools that were not asked for in the current user message
-26. NEVER use markdown formatting in plain text responses — no **bold**, no *italics*, no # headings, no bullet points with -, *, or +, no numbered lists, no backtick inline code. Write in plain prose. Only use fenced \`\`\` code blocks when showing actual code.
-27. When the user asks you to CREATE a new file (e.g. "write a README", "create a config", "add a license", "this codebase doesn't have X"), write it IMMEDIATELY — do NOT read first, even if a stub exists.
-28. When a tool result is returned, your response must be directly based on that result — never invent or hallucinate content unrelated to the tool output.
-29. When scaffolding multiple files, emit ONE write-file tag per response — wait for each result before emitting the next. Never chain multiple write-file tags in a single response when file content is complex (more than 20 lines).
-
-## SCAFFOLDING — CHAINING WRITE-FILE CALLS
-
-When creating multiple files (e.g. scaffolding a project or creating 10 files), emit ALL of them
-in a single response by chaining the tags back-to-back with no text between them:
-
-<write-file>
-{"path": "test/file1.txt", "content": "File 1 content"}
-</write-file>
-<write-file>
-{"path": "test/file2.txt", "content": "File 2 content"}
-</write-file>
-<write-file>
-{"path": "test/file3.txt", "content": "File 3 content"}
-</write-file>
+1. ONE tool per response — emit the XML tag, then stop. Never chain tools in one response except when scaffolding (see below).
+2. NEVER call a tool more than once for the same path in a session. If write-file or shell returned a result, it succeeded. Move on immediately.
+3. NEVER write the same file twice in one session. One write per file, period. If you already wrote it, it is done.
+4. shell is ONLY for running code, installing packages, building, and testing. NEVER use shell to inspect the filesystem or read files — use read-file, read-folder, or grep instead.
+5. write-file content must be the COMPLETE file content, never a placeholder or partial.
+6. NEVER read a file you just wrote. The write output confirms success.
+7. NEVER apologize and redo a tool call — one attempt is enough, trust the output.
+8. NEVER use shell to run git clone — use the clone tag instead.
+9. When the user asks you to CREATE a new file, write it immediately — do NOT read first.
+10. When the user asks you to MODIFY or FIX an existing file, read it first, then write the complete updated version ONCE.
+11. When fixing multiple files, use read-files to read ALL of them first, then write each one ONCE sequentially — never rewrite a file already written this session.
+12. If a read-folder or read-file returns not found, accept it and move on — do NOT retry the same path.
+13. Every shell command runs from the repo root — cd has no persistent effect. Use full paths or combine with && e.g. cd myapp && bun run index.ts
+14. write-file paths are relative to the repo root — use full relative paths e.g. myapp/src/index.tsx not src/index.tsx
+15. When explaining how to use a tool in text, use [tag] bracket notation — NEVER emit a real XML tool tag as part of an explanation.
+16. NEVER use markdown formatting in plain text responses — no bold, no headings, no bullet points. Only use fenced code blocks when showing actual code.
+17. When scaffolding multiple files, emit ONE write-file tag per response and wait for the result before writing the next file.
+
+## ADDON FORMAT
+
+All addons use defineTool from @ridit/lens-sdk. The ONLY correct format is:
+
+\`\`\`js
+const { defineTool } = require("@ridit/lens-sdk");
+const { execSync } = require("child_process");
+
+defineTool({
+  name: "tool-name",
+  description: "what it does",
+  safe: false,
+  permissionLabel: "label shown to user",
+  systemPromptEntry: () => "<tool-name>{}</tool-name> — description",
+  parseInput: (body) => JSON.parse(body.trim() || "{}"),
+  summariseInput: (input) => "summary",
+  execute: async (input, ctx) => {
+    // ctx.repoPath is the current repo path
+    // use execSync from child_process for shell commands, NOT ctx.tools.shell
+    return { kind: "text", value: "result" };
+  },
+});
+\`\`\`
 
-The system processes each tag sequentially and automatically continues to the next one.
-Do NOT wait for a user message between files — emit all tags at once.
+NEVER use module.exports, registerTool, ctx.tools.shell, or any other format. See addons/run-tests.js for a full working example.
 
-## WHEN TO READ BEFORE WRITING
+## SCAFFOLDING
 
-Only read a file before writing if ALL of these are true:
-- The file already exists AND has content you need to preserve
-- The user explicitly asked you to modify, edit, or update it (not create it)
-- You do not already have the file content in this conversation
+When creating multiple files, emit ONE write-file per response and wait for each result:
 
-Never read before writing when:
-- The user asked you to create, write, or add a new file
-- The file is empty, missing, or a stub
-- You already read it earlier in this conversation
+<write-file>
+{"path": "myapp/package.json", "content": "..."}
+</write-file>
 
-When modifying an existing file:
-1. Use read-file on the exact file first
-2. Preserve ALL existing content — do not remove anything that was not part of the request
-3. Your write-file must contain EVERYTHING the original had, PLUS your additions
-4. NEVER produce a file shorter than the original unless explicitly asked to delete things
+Wait for result, then emit the next file. Never chain write-file tags when content is complex.
 
 ## CODEBASE
 
@@ -270984,59 +270963,59 @@ ${memorySummary}`;
 }
 var BUILTIN_TOOLS_SECTION = `## TOOLS
 
-You have exactly thirteen tools. To use a tool you MUST wrap it in the exact XML tags shown below — no other format will work.
+You have exactly fourteen tools. Use ONLY the XML tags shown below.
 
 ### 1. fetch — load a URL
 <fetch>https://example.com</fetch>
 
-### 2. shell — run a terminal command
+### 2. shell — run a terminal command (NOT for filesystem inspection)
 <shell>node -v</shell>
 
-### 3. read-file — read a file from the repo
+### 3. read-file — read a single file from the repo
 <read-file>src/foo.ts</read-file>
 
-### 4. read-folder — list contents of a folder (files + subfolders, one level deep)
+### 4. read-files — read multiple files at once
+<read-files>
+["src/foo.ts", "src/bar.ts"]
+</read-files>
+
+### 5. read-folder — list contents of a folder (one level deep)
 <read-folder>src/components</read-folder>
 
-### 5. grep — search for a pattern across files in the repo (cross-platform, no shell needed)
+### 6. grep — search for a pattern across files
 <grep>
 {"pattern": "ChatRunner", "glob": "src/**/*.tsx"}
 </grep>
 
-### 6. write-file — create or overwrite a file
+### 7. write-file — create or overwrite a file (COMPLETE content only)
 <write-file>
 {"path": "data/output.csv", "content": "col1,col2\\nval1,val2"}
 </write-file>
 
-### 7. delete-file — permanently delete a single file
+### 8. delete-file — permanently delete a single file
 <delete-file>src/old-component.tsx</delete-file>
 
-### 8. delete-folder — permanently delete a folder and all its contents
+### 9. delete-folder — permanently delete a folder and all its contents
 <delete-folder>src/legacy</delete-folder>
 
-### 9. open-url — open a URL in the user's default browser
+### 10. open-url — open a URL in the user's default browser
 <open-url>https://github.com/owner/repo</open-url>
 
-### 10. generate-pdf — generate a PDF file from markdown-style content
+### 11. generate-pdf — generate a PDF from markdown-style content
 <generate-pdf>
-{"path": "output/report.pdf", "content": "# Title\\n\\nSome body text.\\n\\n## Section\\n\\nMore content."}
+{"path": "output/report.pdf", "content": "# Title\\n\\nBody text."}
 </generate-pdf>
 
-### 11. search — search the internet for anything you are unsure about
-<search>how to use React useEffect cleanup function</search>
+### 12. search — search the internet
+<search>how to use React useEffect cleanup</search>
 
-### 12. clone — clone a GitHub repo so you can explore and discuss it
+### 13. clone — clone a GitHub repo
 <clone>https://github.com/owner/repo</clone>
 
-### 13. changes — propose code edits (shown as a diff for user approval)
+### 14. changes — propose code edits shown as a diff for user approval
 <changes>
 {"summary": "what changed and why", "patches": [{"path": "src/foo.ts", "content": "COMPLETE file content", "isNew": false}]}
 </changes>
-
-### 14. read-files — read multiple files from the repo at once
-<read-files>
-["src/foo.ts", "src/bar.ts"]
-</read-files>
 `;
 // src/prompts/fewshot.ts
 var FEW_SHOT_MESSAGES = [
@@ -271046,7 +271025,7 @@ var FEW_SHOT_MESSAGES = [
   },
   {
     role: "assistant",
-    content: '<write-file>\n{"path": "README.md", "content": "# Project\\n\\nA brief description of what this project does.\\n\\n## Getting Started\\n\\n```bash\\nbun install\\nbun run dev\\n```"}\n</write-file>'
+    content: '<write-file>\n{"path": "README.md", "content": "# Project\\n\\nA brief description.\\n\\n## Getting Started\\n\\n```bash\\nbun install\\nbun run dev\\n```"}\n</write-file>'
   },
   {
     role: "user",
@@ -271062,259 +271041,184 @@ Please continue your response based on this output.`
   },
   {
     role: "user",
-    content: "add more information to the README"
+    content: "fix the bug in addons/clean-cache.js"
   },
   {
     role: "assistant",
-    content: "<read-file>README.md</read-file>"
+    content: "<read-file>addons/clean-cache.js</read-file>"
   },
   {
     role: "user",
-    content: `Here is the output from read-file of README.md:
-
-File: README.md (10 lines)
+    content: `Here is the output from read-file of addons/clean-cache.js:
 
-# Project
+File: addons/clean-cache.js (42 lines)
 
-A brief description.
-
-## Getting Started
-
-\`\`\`bash
-bun install
-\`\`\`
+const { defineTool } = require("@ridit/lens-sdk");
+defineTool({ name: "clean-cache", execute: async (_, ctx) => { const { shell } = ctx.tools; await shell("rm -rf node_modules"); } });
 
 Please continue your response based on this output.`
   },
   {
     role: "assistant",
-    content: '<write-file>\n{"path": "README.md", "content": "# Project\\n\\nA brief description.\\n\\n## Getting Started\\n\\n```bash\\nbun install\\nbun run dev\\n```\\n\\n## Features\\n\\n- Feature one\\n- Feature two\\n\\n## Contributing\\n\\nPull requests welcome."}\n</write-file>'
+    content: `<write-file>
+{"path": "addons/clean-cache.js", "content": "const { defineTool } = require(\\"@ridit/lens-sdk\\");\\nconst { execSync } = require(\\"child_process\\");\\n\\ndefineTool({\\n  name: \\"clean-cache\\",\\n  description: \\"Clean node_modules and bun cache\\",\\n  safe: false,\\n  permissionLabel: \\"Clean cache\\",\\n  systemPromptEntry: () => \\"<clean-cache>{}</clean-cache> — clean node_modules and bun cache\\",\\n  parseInput: () => ({}),\\n  summariseInput: () => \\"clean cache\\",\\n  execute: async (_, ctx) => {\\n    try {\\n      execSync(\\"rm -rf node_modules\\", { cwd: ctx.repoPath, stdio: \\"pipe\\" });\\n      return { kind: \\"text\\", value: \\"Cache cleaned!\\" };\\n    } catch (err) {\\n      return { kind: \\"error\\", value: err.message };\\n    }\\n  },\\n});"}
+</write-file>`
   },
   {
     role: "user",
-    content: `Here is the output from write-file to README.md:
+    content: `Here is the output from write-file to addons/clean-cache.js:
 
-Written: /repo/README.md (20 lines, 280 bytes)
+Written: /repo/addons/clean-cache.js (20 lines, 480 bytes)
 
 Please continue your response based on this output.`
   },
   {
     role: "assistant",
-    content: "Done — README.md updated with more detail."
+    content: "Done — clean-cache.js fixed. Now uses execSync instead of ctx.tools.shell."
   },
   {
     role: "user",
-    content: "update LENS.md"
+    content: "add a logout button to src/components/Header.tsx"
   },
   {
     role: "assistant",
-    content: "<read-file>LENS.md</read-file>"
+    content: "<read-file>src/components/Header.tsx</read-file>"
   },
   {
     role: "user",
-    content: `Here is the output from read-file of LENS.md:
-
-File: LENS.md (33 lines)
-
-# Lens Analysis
-
-## Overview
-A CLI tool for codebase analysis.
+    content: `Here is the output from read-file of src/components/Header.tsx:
 
-## Important Folders
-- src/components
-- src/utils
+File: src/components/Header.tsx (42 lines)
 
-## Suggestions
-- Add tests
+import React from 'react';
+// ... existing content ...
 
 Please continue your response based on this output.`
   },
   {
     role: "assistant",
-    content: `<write-file>
-{"path": "LENS.md", "content": "# Lens Analysis\\n\\n## Overview\\nA CLI tool for AI-powered codebase analysis, built with React and Ink.\\n\\n## Important Folders\\n- src/components — UI components rendered in the terminal\\n- src/utils — tools, chat, memory, and registry utilities\\n\\n## Suggestions\\n- Add tests\\n- Add more providers\\n- Improve error handling"}
-</write-file>`
+    content: `<changes>
+{"summary": "Add logout button to Header — preserves all existing content", "patches": [{"path": "src/components/Header.tsx", "content": "// complete file with logout button added", "isNew": false}]}
+</changes>`
   },
   {
     role: "user",
-    content: `Here is the output from write-file to LENS.md:
+    content: `Here is the output from changes:
 
-Written: /repo/LENS.md (15 lines, 420 bytes)
+Changes applied.
 
 Please continue your response based on this output.`
   },
   {
     role: "assistant",
-    content: "Done — LENS.md updated."
+    content: "Done — logout button added to Header.tsx."
   },
   {
     role: "user",
-    content: "write a contributing guide"
+    content: "fix addons/a.js, addons/b.js and addons/c.js"
   },
   {
     role: "assistant",
-    content: `<write-file>
-{"path": "CONTRIBUTING.md", "content": "# Contributing\\n\\nPull requests welcome. Please open an issue first to discuss major changes."}
-</write-file>`
+    content: `<read-files>
+["addons/a.js", "addons/b.js", "addons/c.js"]
+</read-files>`
   },
   {
     role: "user",
-    content: `Here is the output from write-file to CONTRIBUTING.md:
+    content: `Here is the output from read-files:
 
-Written: /repo/CONTRIBUTING.md (4 lines, 96 bytes)
+=== addons/a.js ===
+module.exports = { name: 'a', run: async () => {} }
 
-Please continue your response based on this output.`
-  },
-  {
-    role: "assistant",
-    content: "Done — CONTRIBUTING.md has been written."
-  },
-  {
-    role: "user",
-    content: "scaffold a new project called myapp with package.json and src/index.tsx"
-  },
-  {
-    role: "assistant",
-    content: `<write-file>
-{"path": "myapp/package.json", "content": "{\\n  \\"name\\": \\"myapp\\",\\n  \\"version\\": \\"1.0.0\\",\\n  \\"scripts\\": { \\"dev\\": \\"bun run src/index.tsx\\" },\\n  \\"dependencies\\": { \\"react\\": \\"^18.2.0\\", \\"ink\\": \\"^4.4.1\\" },\\n  \\"devDependencies\\": { \\"@types/react\\": \\"^18.2.0\\" }\\n}"}
-</write-file>`
-  },
-  {
-    role: "user",
-    content: `Here is the output from write-file to myapp/package.json:
+=== addons/b.js ===
+module.exports = { name: 'b', run: async () => {} }
 
-Written: /repo/myapp/package.json (10 lines, 220 bytes)
+=== addons/c.js ===
+module.exports = { name: 'c', run: async () => {} }
 
 Please continue your response based on this output.`
   },
   {
     role: "assistant",
     content: `<write-file>
-{"path": "myapp/src/index.tsx", "content": "/** @jsxImportSource react */\\nimport React from 'react';\\nimport { render, Text } from 'ink';\\n\\nfunction App() {\\n  return <Text>Hello from myapp!</Text>;\\n}\\n\\nrender(<App />);"}
+{"path": "addons/a.js", "content": "const { defineTool } = require(\\"@ridit/lens-sdk\\");\\n\\ndefineTool({\\n  name: \\"a\\",\\n  description: \\"Does A\\",\\n  safe: true,\\n  permissionLabel: \\"Run A\\",\\n  systemPromptEntry: () => \\"<a>{}</a> — run A\\",\\n  parseInput: () => ({}),\\n  summariseInput: () => \\"a\\",\\n  execute: async (_, ctx) => ({ kind: \\"text\\", value: \\"A done!\\" }),\\n});"}
 </write-file>`
   },
   {
     role: "user",
-    content: `Here is the output from write-file to myapp/src/index.tsx:
-
-Written: /repo/myapp/src/index.tsx (9 lines, 210 bytes)
-
-Please continue your response based on this output.`
-  },
-  {
-    role: "assistant",
-    content: "Done — scaffolded myapp/package.json and myapp/src/index.tsx. Run `cd myapp && bun install` to get started."
-  },
-  {
-    role: "user",
-    content: "delete src/old-component.tsx"
-  },
-  {
-    role: "assistant",
-    content: "<delete-file>src/old-component.tsx</delete-file>"
-  },
-  {
-    role: "user",
-    content: `Here is the output from delete-file of src/old-component.tsx:
+    content: `Here is the output from write-file to addons/a.js:
 
-Deleted: /repo/src/old-component.tsx
+Written: /repo/addons/a.js (12 lines, 280 bytes)
 
 Please continue your response based on this output.`
   },
   {
     role: "assistant",
-    content: "Done — src/old-component.tsx has been deleted."
-  },
-  {
-    role: "user",
-    content: "delete the legacy folder"
-  },
-  {
-    role: "assistant",
-    content: "<delete-folder>src/legacy</delete-folder>"
+    content: `<write-file>
+{"path": "addons/b.js", "content": "const { defineTool } = require(\\"@ridit/lens-sdk\\");\\n\\ndefineTool({\\n  name: \\"b\\",\\n  description: \\"Does B\\",\\n  safe: true,\\n  permissionLabel: \\"Run B\\",\\n  systemPromptEntry: () => \\"<b>{}</b> — run B\\",\\n  parseInput: () => ({}),\\n  summariseInput: () => \\"b\\",\\n  execute: async (_, ctx) => ({ kind: \\"text\\", value: \\"B done!\\" }),\\n});"}
+</write-file>`
   },
   {
     role: "user",
-    content: `Here is the output from delete-folder of src/legacy:
+    content: `Here is the output from write-file to addons/b.js:
 
-Deleted folder: /repo/src/legacy
+Written: /repo/addons/b.js (12 lines, 280 bytes)
 
 Please continue your response based on this output.`
   },
   {
     role: "assistant",
-    content: "Done — src/legacy and all its contents have been deleted."
-  },
-  {
-    role: "user",
-    content: "open https://github.com/microsoft/typescript"
-  },
-  {
-    role: "assistant",
-    content: "<open-url>https://github.com/microsoft/typescript</open-url>"
+    content: `<write-file>
+{"path": "addons/c.js", "content": "const { defineTool } = require(\\"@ridit/lens-sdk\\");\\n\\ndefineTool({\\n  name: \\"c\\",\\n  description: \\"Does C\\",\\n  safe: true,\\n  permissionLabel: \\"Run C\\",\\n  systemPromptEntry: () => \\"<c>{}</c> — run C\\",\\n  parseInput: () => ({}),\\n  summariseInput: () => \\"c\\",\\n  execute: async (_, ctx) => ({ kind: \\"text\\", value: \\"C done!\\" }),\\n});"}
+</write-file>`
   },
   {
     role: "user",
-    content: `Here is the output from open-url https://github.com/microsoft/typescript:
+    content: `Here is the output from write-file to addons/c.js:
 
-Opened: https://github.com/microsoft/typescript
+Written: /repo/addons/c.js (12 lines, 280 bytes)
 
 Please continue your response based on this output.`
   },
   {
     role: "assistant",
-    content: "Opened the TypeScript GitHub page in your browser."
+    content: "Done — fixed all three addons. Each now uses defineTool from @ridit/lens-sdk correctly."
   },
   {
     role: "user",
-    content: "generate a PDF report about the project and save it to docs/report.pdf"
+    content: "scaffold a new project called myapp with package.json and src/index.tsx"
   },
   {
     role: "assistant",
-    content: `<generate-pdf>
-{"path": "docs/report.pdf", "content": "# Project Report\\n\\n## Overview\\n\\nThis document summarizes the project.\\n\\n## Details\\n\\nMore content here."}
-</generate-pdf>`
+    content: `<write-file>
+{"path": "myapp/package.json", "content": "{\\n  \\"name\\": \\"myapp\\",\\n  \\"version\\": \\"1.0.0\\",\\n  \\"scripts\\": { \\"dev\\": \\"bun run src/index.tsx\\" },\\n  \\"dependencies\\": { \\"react\\": \\"^18.2.0\\", \\"ink\\": \\"^4.4.1\\" }\\n}"}
+</write-file>`
   },
   {
     role: "user",
-    content: `Here is the output from generate-pdf to docs/report.pdf:
+    content: `Here is the output from write-file to myapp/package.json:
 
-PDF generated: /repo/docs/report.pdf
+Written: /repo/myapp/package.json (8 lines, 180 bytes)
 
 Please continue your response based on this output.`
   },
   {
     role: "assistant",
-    content: "Done — docs/report.pdf has been generated."
-  },
-  {
-    role: "user",
-    content: 'grep -R "ChatRunner" -n src'
-  },
-  {
-    role: "assistant",
-    content: `<grep>
-{"pattern": "ChatRunner", "glob": "src/**/*"}
-</grep>`
+    content: `<write-file>
+{"path": "myapp/src/index.tsx", "content": "/** @jsxImportSource react */\\nimport React from 'react';\\nimport { render, Text } from 'ink';\\n\\nfunction App() {\\n  return <Text>Hello from myapp!</Text>;\\n}\\n\\nrender(<App />);"}
+</write-file>`
   },
   {
     role: "user",
-    content: `Here is the output from grep for "ChatRunner":
-
-grep /ChatRunner/ src/**/* — 3 match(es) in 2 file(s)
-
-src/index.tsx
-  12: import { ChatRunner } from "./components/chat/ChatRunner";
+    content: `Here is the output from write-file to myapp/src/index.tsx:
 
-src/components/chat/ChatRunner.tsx
-  1: export const ChatRunner = ...
+Written: /repo/myapp/src/index.tsx (9 lines, 210 bytes)
 
 Please continue your response based on this output.`
   },
   {
     role: "assistant",
-    content: "ChatRunner is defined in src/components/chat/ChatRunner.tsx and imported in src/index.tsx."
+    content: "Done — scaffolded myapp/package.json and myapp/src/index.tsx. Run cd myapp && bun install to get started."
   },
   {
     role: "user",
@@ -271342,197 +271246,6 @@ Please continue your response based on this output.`
     role: "assistant",
     content: "useInput is used in src/components/chat/ChatRunner.tsx — imported on line 5 and called on line 210."
   },
-  {
-    role: "user",
-    content: "show me how to use the read-file tool"
-  },
-  {
-    role: "assistant",
-    content: "To read a file, emit the tag alone in your response — nothing else on that turn:\n\n```text\n[read-file]src/components/Header.tsx[/read-file]\n```\n\nThe result comes back as the next user message and you can then analyze it."
-  },
-  {
-    role: "user",
-    content: "show me an example of the shell tool"
-  },
-  {
-    role: "assistant",
-    content: "To run a shell command, emit only the tag:\n\n```text\n[shell]node -v[/shell]\n```\n\nThe stdout/stderr is returned and you can read it in the next turn."
-  },
-  {
-    role: "user",
-    content: "read src folder"
-  },
-  {
-    role: "assistant",
-    content: "<read-folder>src</read-folder>"
-  },
-  {
-    role: "user",
-    content: `Here is the output from read-folder of src:
-
-Folder: src (4 entries)
-
-Files:
-  index.ts
-  App.tsx
-
-Subfolders:
-  components/
-  utils/
-
-Please continue your response based on this output.`
-  },
-  {
-    role: "assistant",
-    content: "The src folder contains index.ts, App.tsx, plus subfolders components/ and utils/."
-  },
-  {
-    role: "user",
-    content: "what files are in src/components?"
-  },
-  {
-    role: "assistant",
-    content: "<read-folder>src/components</read-folder>"
-  },
-  {
-    role: "user",
-    content: `Here is the output from read-folder of src/components:
-
-Folder: src/components (5 entries)
-
-Files:
-  Header.tsx
-  Footer.tsx
-  Button.tsx
-
-Subfolders:
-  ui/
-  forms/
-
-Please continue your response based on this output.`
-  },
-  {
-    role: "assistant",
-    content: "src/components has 3 files — Header.tsx, Footer.tsx, Button.tsx — plus two subfolders: ui/ and forms/."
-  },
-  {
-    role: "user",
-    content: "show me the project structure"
-  },
-  {
-    role: "assistant",
-    content: "<read-folder>.</read-folder>"
-  },
-  {
-    role: "user",
-    content: `Here is the output from read-folder of .:
-
-Folder: . (5 entries)
-
-Files:
-  package.json
-  tsconfig.json
-  README.md
-
-Subfolders:
-  src/
-  node_modules/
-
-Please continue your response based on this output.`
-  },
-  {
-    role: "assistant",
-    content: "The project root has package.json, tsconfig.json, README.md and the src/ folder for source code."
-  },
-  {
-    role: "user",
-    content: "fetch https://api.github.com/repos/microsoft/typescript"
-  },
-  {
-    role: "assistant",
-    content: "<fetch>https://api.github.com/repos/microsoft/typescript</fetch>"
-  },
-  {
-    role: "user",
-    content: `Here is the output from fetch of https://api.github.com/repos/microsoft/typescript:
-
-{"name":"TypeScript","stargazers_count":100000}
-
-Please continue your response based on this output.`
-  },
-  {
-    role: "assistant",
-    content: "Found 1 object with fields: name, stargazers_count. Writing to ts-info.json now."
-  },
-  {
-    role: "user",
-    content: "ok go ahead"
-  },
-  {
-    role: "assistant",
-    content: `<write-file>
-{"path": "ts-info.json", "content": "{"name":"TypeScript","stars":100000}"}
-</write-file>`
-  },
-  {
-    role: "user",
-    content: `Here is the output from write-file to ts-info.json:
-
-Written: /repo/ts-info.json (1 lines, 44 bytes)
-
-Please continue your response based on this output.`
-  },
-  {
-    role: "assistant",
-    content: "Done — ts-info.json has been saved."
-  },
-  {
-    role: "user",
-    content: "write it to a file called hello.py"
-  },
-  {
-    role: "assistant",
-    content: `<write-file>
-{"path": "hello.py", "content": "# hello.py\\nprint('hello')"}
-</write-file>`
-  },
-  {
-    role: "user",
-    content: `Here is the output from write-file to hello.py:
-
-Written: /repo/hello.py (2 lines, 32 bytes)
-
-Please continue your response based on this output.`
-  },
-  {
-    role: "assistant",
-    content: "Done — hello.py has been written."
-  },
-  {
-    role: "user",
-    content: "add a logout button to src/components/Header.tsx"
-  },
-  {
-    role: "assistant",
-    content: "<read-file>src/components/Header.tsx</read-file>"
-  },
-  {
-    role: "user",
-    content: `Here is the output from read-file of src/components/Header.tsx:
-
-File: src/components/Header.tsx (42 lines)
-
-import React from 'react';
-// ... full file content ...
-
-Please continue your response based on this output.`
-  },
-  {
-    role: "assistant",
-    content: `<changes>
-{"summary": "Add logout button to Header — preserves all existing nav items and imports", "patches": [{"path": "src/components/Header.tsx", "content": "// complete file with logout button added", "isNew": false}]}
-</changes>`
-  },
   {
     role: "user",
     content: "what node version am I on"
@@ -271551,63 +271264,39 @@ Please continue your response based on this output.`
   },
   {
     role: "assistant",
-    content: "You're running Node.js v20.11.0."
+    content: "You're on Node.js v20.11.0."
   },
   {
     role: "user",
-    content: "clone https://github.com/facebook/react"
-  },
-  {
-    role: "assistant",
-    content: "<clone>https://github.com/facebook/react</clone>"
-  },
-  {
-    role: "user",
-    content: "Cloned react to /tmp/react — 2847 files available. You can now read files from this repo using read-file with paths relative to /tmp/react."
+    content: "remember that we always use bun in this project"
   },
   {
     role: "assistant",
-    content: "Cloned! The React repo has 2847 files. I can read source files, explain how it works, or suggest improvements — just ask."
+    content: `<memory-add>Project uses bun as the package manager and runtime, not npm or node</memory-add>
+
+Got it — I'll always use bun for this project.`
   },
   {
     role: "user",
-    content: "what does the ?? operator do in typescript"
+    content: "add a new addon that prints hello world"
   },
   {
     role: "assistant",
-    content: "<search>nullish coalescing operator ?? TypeScript</search>"
+    content: `<write-file>
+{"path": "addons/hello-world.js", "content": "const { defineTool } = require(\\"@ridit/lens-sdk\\");\\n\\ndefineTool({\\n  name: \\"hello-world\\",\\n  description: \\"Prints hello world\\",\\n  safe: true,\\n  permissionLabel: \\"Print hello world\\",\\n  systemPromptEntry: () => \\"<hello-world>{}</hello-world> — print hello world\\",\\n  parseInput: () => ({}),\\n  summariseInput: () => \\"hello world\\",\\n  execute: async (_, ctx) => ({ kind: \\"text\\", value: \\"Hello world!\\" }),\\n});"}
+</write-file>`
   },
   {
     role: "user",
-    content: `Here is the output from web search for "nullish coalescing operator ?? TypeScript":
+    content: `Here is the output from write-file to addons/hello-world.js:
 
-Answer: The ?? operator returns the right-hand side when the left-hand side is null or undefined.
+Written: /repo/addons/hello-world.js (14 lines, 320 bytes)
 
 Please continue your response based on this output.`
   },
   {
     role: "assistant",
-    content: "The ?? operator is the nullish coalescing operator. It returns the right side only when the left side is null or undefined."
-  },
-  {
-    role: "user",
-    content: "remember that we always use bun in this project"
-  },
-  {
-    role: "assistant",
-    content: `<memory-add>Project uses bun as the package manager and runtime, not npm or node</memory-add>
-
-Got it — I'll always use bun for this project.`
-  },
-  {
-    role: "user",
-    content: "forget the bun preference"
-  },
-  {
-    role: "assistant",
-    content: `<memory-delete>MEMORY_ID</memory-delete>
-
-Done — removed that memory.`
+    content: "Done — addons/hello-world.js created using defineTool from @ridit/lens-sdk."
   }
 ];
 // src/utils/chat.ts
@@ -276213,12 +275902,10 @@ ${missing.map((f) => `  ${f}`).join(`
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsx_dev_runtime25.jsxDEV(Text, {
             color: "gray",
-            dimColor: true,
             children: cwd2
           }, undefined, false, undefined, this),
           files.length > 0 && /* @__PURE__ */ jsx_dev_runtime25.jsxDEV(Text, {
             color: CYAN,
-            dimColor: true,
             children: [
               files.length,
               " file",
@@ -276235,7 +275922,6 @@ ${missing.map((f) => `  ${f}`).join(`
           children: [
             /* @__PURE__ */ jsx_dev_runtime25.jsxDEV(Text, {
               color: "gray",
-              dimColor: true,
               children: "  ·"
             }, undefined, false, undefined, this),
             /* @__PURE__ */ jsx_dev_runtime25.jsxDEV(Text, {
@@ -276247,7 +275933,6 @@ ${missing.map((f) => `  ${f}`).join(`
       }, undefined, false, undefined, this),
       /* @__PURE__ */ jsx_dev_runtime25.jsxDEV(Text, {
         color: "gray",
-        dimColor: true,
         children: div
       }, undefined, false, undefined, this),
       phase.type === "checking" && /* @__PURE__ */ jsx_dev_runtime25.jsxDEV(Box_default, {
@@ -276260,7 +275945,6 @@ ${missing.map((f) => `  ${f}`).join(`
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsx_dev_runtime25.jsxDEV(Text, {
             color: "gray",
-            dimColor: true,
             children: "checking changes…"
           }, undefined, false, undefined, this)
         ]
@@ -276275,7 +275959,6 @@ ${missing.map((f) => `  ${f}`).join(`
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsx_dev_runtime25.jsxDEV(Text, {
             color: "gray",
-            dimColor: true,
             children: phase.files.length > 0 ? `staging ${phase.files.length} file${phase.files.length !== 1 ? "s" : ""}…` : "staging all changes…"
           }, undefined, false, undefined, this)
         ]
@@ -276323,12 +276006,10 @@ ${missing.map((f) => `  ${f}`).join(`
             children: [
               /* @__PURE__ */ jsx_dev_runtime25.jsxDEV(Text, {
                 color: "gray",
-                dimColor: true,
                 children: "you have unstaged changes. try:"
               }, undefined, false, undefined, this),
               phase.files.length > 0 ? /* @__PURE__ */ jsx_dev_runtime25.jsxDEV(Text, {
                 color: "gray",
-                dimColor: true,
                 children: [
                   "  ",
                   /* @__PURE__ */ jsx_dev_runtime25.jsxDEV(Text, {
@@ -276343,7 +276024,6 @@ ${missing.map((f) => `  ${f}`).join(`
                 ]
               }, undefined, true, undefined, this) : /* @__PURE__ */ jsx_dev_runtime25.jsxDEV(Text, {
                 color: "gray",
-                dimColor: true,
                 children: [
                   "  ",
                   /* @__PURE__ */ jsx_dev_runtime25.jsxDEV(Text, {
@@ -276409,7 +276089,6 @@ ${missing.map((f) => `  ${f}`).join(`
             children: [
               /* @__PURE__ */ jsx_dev_runtime25.jsxDEV(Text, {
                 color: "yellow",
-                dimColor: true,
                 children: [
                   "⚡ large diff — consider splitting into",
                   " ",
@@ -276419,7 +276098,6 @@ ${missing.map((f) => `  ${f}`).join(`
               }, undefined, true, undefined, this),
               phase.splitGroups.map((g, i) => /* @__PURE__ */ jsx_dev_runtime25.jsxDEV(Text, {
                 color: "gray",
-                dimColor: true,
                 children: [
                   "  · ",
                   g
@@ -276429,7 +276107,6 @@ ${missing.map((f) => `  ${f}`).join(`
           }, undefined, true, undefined, this),
           /* @__PURE__ */ jsx_dev_runtime25.jsxDEV(Text, {
             color: "gray",
-            dimColor: true,
             children: div
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsx_dev_runtime25.jsxDEV(Box_default, {
@@ -276446,7 +276123,6 @@ ${missing.map((f) => `  ${f}`).join(`
               }, undefined, false, undefined, this),
               /* @__PURE__ */ jsx_dev_runtime25.jsxDEV(Text, {
                 color: "gray",
-                dimColor: true,
                 children: "n/esc cancel"
               }, undefined, false, undefined, this)
             ]
@@ -276481,7 +276157,6 @@ ${missing.map((f) => `  ${f}`).join(`
               }, undefined, false, undefined, this),
               /* @__PURE__ */ jsx_dev_runtime25.jsxDEV(Text, {
                 color: "gray",
-                dimColor: true,
                 children: "enter confirm · esc back"
               }, undefined, false, undefined, this)
             ]
@@ -276498,7 +276173,6 @@ ${missing.map((f) => `  ${f}`).join(`
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsx_dev_runtime25.jsxDEV(Text, {
             color: "gray",
-            dimColor: true,
             children: "committing…"
           }, undefined, false, undefined, this)
         ]
@@ -276536,7 +276210,6 @@ ${missing.map((f) => `  ${f}`).join(`
               }, undefined, false, undefined, this),
               /* @__PURE__ */ jsx_dev_runtime25.jsxDEV(Text, {
                 color: "gray",
-                dimColor: true,
                 children: "pushing…"
               }, undefined, false, undefined, this)
             ]
@@ -276570,7 +276243,6 @@ ${missing.map((f) => `  ${f}`).join(`
           phase.message.split(`
 `).slice(2).filter(Boolean).map((line, i) => /* @__PURE__ */ jsx_dev_runtime25.jsxDEV(Text, {
             color: "gray",
-            dimColor: true,
             children: line
           }, i, false, undefined, this)),
           phase.pushed && /* @__PURE__ */ jsx_dev_runtime25.jsxDEV(Box_default, {
@@ -276583,14 +276255,12 @@ ${missing.map((f) => `  ${f}`).join(`
               }, undefined, false, undefined, this),
               /* @__PURE__ */ jsx_dev_runtime25.jsxDEV(Text, {
                 color: "gray",
-                dimColor: true,
                 children: "pushed to remote"
               }, undefined, false, undefined, this)
             ]
           }, undefined, true, undefined, this),
           /* @__PURE__ */ jsx_dev_runtime25.jsxDEV(Text, {
             color: "gray",
-            dimColor: true,
             children: "press any key to exit"
           }, undefined, false, undefined, this)
         ]
@@ -276618,7 +276288,6 @@ ${missing.map((f) => `  ${f}`).join(`
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsx_dev_runtime25.jsxDEV(Text, {
             color: "gray",
-            dimColor: true,
             children: "(preview only — not committed)"
           }, undefined, false, undefined, this)
         ]
@@ -276645,7 +276314,6 @@ ${missing.map((f) => `  ${f}`).join(`
           phase.message.split(`
 `).slice(1).map((line, i) => /* @__PURE__ */ jsx_dev_runtime25.jsxDEV(Text, {
             color: "gray",
-            dimColor: true,
             children: line
           }, i, false, undefined, this))
         ]
@@ -277257,6 +276925,7 @@ var convertImageTool = {
   }
 };
 // src/utils/tools/builtins.ts
+var cleanBody = (body) => body.trim().replace(/\\/g, "/");
 var fetchTool = {
   name: "fetch",
   description: "load a URL",
@@ -277299,7 +276968,7 @@ var readFileTool = {
   permissionLabel: "read",
   systemPromptEntry: (i) => `### ${i}. read-file — read a file from the repo
 <read-file>src/foo.ts</read-file>`,
-  parseInput: (body) => body || null,
+  parseInput: (body) => cleanBody(body) || null,
   summariseInput: (p) => p,
   execute: (filePath, ctx) => ({
     kind: "text",
@@ -277313,7 +276982,7 @@ var readFolderTool = {
   permissionLabel: "folder",
   systemPromptEntry: (i) => `### ${i}. read-folder — list contents of a folder (files + subfolders, one level deep)
 <read-folder>src/components</read-folder>`,
-  parseInput: (body) => body || null,
+  parseInput: (body) => cleanBody(body) || null,
   summariseInput: (p) => p,
   execute: (folderPath, ctx) => ({
     kind: "text",
@@ -277331,7 +277000,7 @@ var grepTool = {
 </grep>`,
   parseInput: (body) => {
     try {
-      const parsed = JSON.parse(body);
+      const parsed = JSON.parse(cleanBody(body));
       return { pattern: parsed.pattern, glob: parsed.glob ?? "**/*" };
     } catch {
       return { pattern: body, glob: "**/*" };
@@ -277357,7 +277026,7 @@ var writeFileTool = {
       const parsed = JSON.parse(body);
       if (!parsed.path)
         return null;
-      return parsed;
+      return { ...parsed, path: parsed.path.replace(/\\/g, "/") };
     } catch {
       return null;
     }
@@ -277375,7 +277044,7 @@ var deleteFileTool = {
   permissionLabel: "delete",
   systemPromptEntry: (i) => `### ${i}. delete-file — permanently delete a single file
 <delete-file>src/old-component.tsx</delete-file>`,
-  parseInput: (body) => body || null,
+  parseInput: (body) => cleanBody(body) || null,
   summariseInput: (p) => p,
   execute: (filePath, ctx) => ({
     kind: "text",
@@ -277389,7 +277058,7 @@ var deleteFolderTool = {
   permissionLabel: "delete folder",
   systemPromptEntry: (i) => `### ${i}. delete-folder — permanently delete a folder and all its contents
 <delete-folder>src/legacy</delete-folder>`,
-  parseInput: (body) => body || null,
+  parseInput: (body) => cleanBody(body) || null,
   summariseInput: (p) => p,
   execute: (folderPath, ctx) => ({
     kind: "text",
@@ -277418,7 +277087,7 @@ var generatePdfTool = {
 </generate-pdf>`,
   parseInput: (body) => {
     try {
-      const parsed = JSON.parse(body);
+      const parsed = JSON.parse(cleanBody(body));
       return {
         filePath: parsed.path ?? parsed.filePath ?? "output.pdf",
         content: parsed.content ?? ""
@@ -277479,7 +277148,7 @@ var changesTool = {
 </changes>`,
   parseInput: (body) => {
     try {
-      return JSON.parse(body);
+      return JSON.parse(cleanBody(body));
     } catch {
       return null;
     }
@@ -277501,7 +277170,7 @@ var readFilesTool = {
 </read-files>`,
   parseInput: (body) => {
     try {
-      const parsed = JSON.parse(body);
+      const parsed = JSON.parse(cleanBody(body));
       if (!Array.isArray(parsed) || parsed.length === 0)
         return null;
       return { paths: parsed };
@@ -277543,6 +277212,7 @@ function registerBuiltins() {
 import path26 from "path";
 import os9 from "os";
 import { existsSync as existsSync20, readdirSync as readdirSync5 } from "fs";
+import { pathToFileURL } from "url";
 var ADDONS_DIR = path26.join(os9.homedir(), ".lens", "addons");
 async function loadAddons() {
   if (!existsSync20(ADDONS_DIR)) {
@@ -277554,9 +277224,10 @@ async function loadAddons() {
     if (!file)
       return;
     const fullPath = path26.join(ADDONS_DIR, file);
+    const fileUrl = pathToFileURL(fullPath).href;
     const isLast = i === files.length - 1;
     try {
-      await import(fullPath);
+      await import(fileUrl);
       console.log(`[addons] loaded: ${file}${isLast ? `
 ` : ""}`);
     } catch (err) {