openwriter 0.8.3 → 0.8.6

package/dist/plugins/publish/dist/helpers.js

@@ -5,18 +5,32 @@ import markdownItSub from 'markdown-it-sub';
 import markdownItSup from 'markdown-it-sup';
 import { readFileSync, existsSync } from 'fs';
 import { join, extname } from 'path';
-// Lazy-load server modules at runtime (same process, resolved from monorepo root)
-const baseDir = new URL('../../../packages/openwriter/dist/server/', import.meta.url).href;
+// Lazy-load server modules at runtime
+// npm package: dist/plugins/publish/dist/helpers.js → ../../../server/
+// Monorepo:    plugins/publish/dist/helpers.js → ../../../packages/openwriter/dist/server/
+const npmBase = new URL('../../../server/', import.meta.url).href;
+const monoBase = new URL('../../../packages/openwriter/dist/server/', import.meta.url).href;
 let _cached = null;
+async function tryImport(base) {
+    const [markdown, state, helpers, connections] = await Promise.all([
+        import(base + 'markdown.js'),
+        import(base + 'state.js'),
+        import(base + 'helpers.js'),
+        import(base + 'connections.js'),
+    ]);
+    return { markdown, state, helpers, connections };
+}
 export async function getServerModules() {
     if (_cached)
         return _cached;
-    const [markdown, state, helpers, connections] = await Promise.all([
-        import(baseDir + 'markdown.js'),
-        import(baseDir + 'state.js'),
-        import(baseDir + 'helpers.js'),
-        import(baseDir + 'connections.js'),
-    ]);
+    // Try npm package layout first, fall back to monorepo layout
+    let markdown, state, helpers, connections;
+    try {
+        ({ markdown, state, helpers, connections } = await tryImport(npmBase));
+    }
+    catch {
+        ({ markdown, state, helpers, connections } = await tryImport(monoBase));
+    }
     _cached = {
         tiptapToMarkdown: markdown.tiptapToMarkdown,
         getDocument: state.getDocument,

package/dist/server/documents.js

@@ -438,7 +438,7 @@ export function createDocument(title, content, path) {
         }
     }
     else {
-        newDoc = { type: 'doc', content: [{ type: 'paragraph', content: [] }] };
+        newDoc = { type: 'doc', content: [{ type: 'paragraph', attrs: { id: generateNodeId() }, content: [] }] };
     }
     const metadata = { title: docTitle, docId: generateNodeId() };
     setActiveDocument(newDoc, docTitle, filePath, isTemp, undefined, metadata);
@@ -489,7 +489,7 @@ export function createDocumentFile(title, path, extraMeta) {
         }
         filename = filePath.split(/[/\\]/).pop();
     }
-    const newDoc = { type: 'doc', content: [{ type: 'paragraph', content: [] }] };
+    const newDoc = { type: 'doc', content: [{ type: 'paragraph', attrs: { id: generateNodeId() }, content: [] }] };
     const metadata = { title: docTitle, docId: generateNodeId(), agentCreated: true, ...extraMeta };
     const markdown = tiptapToMarkdown(newDoc, docTitle, metadata);
     ensureDataDir();

package/dist/server/install-skill.js

@@ -8,34 +8,44 @@ const __dirname = path.dirname(__filename);
 function log(msg) {
     console.error(msg);
 }
-function isGloballyInstalled() {
+function getGlobalVersion() {
     try {
-        const result = execSync('openwriter --version', {
+        return execSync('openwriter --version', {
             stdio: ['pipe', 'pipe', 'pipe'],
             timeout: 10000,
-        });
-        return true;
+        }).toString().trim();
     }
     catch {
-        return false;
+        return null;
     }
 }
-function installGlobally() {
-    log('\n② Installing openwriter globally...');
+function getLatestVersion() {
+    try {
+        return execSync('npm view openwriter version', {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 15000,
+        }).toString().trim();
+    }
+    catch {
+        return null;
+    }
+}
+function installOrUpdateGlobally() {
+    log('\n② Installing/updating openwriter globally...');
     // Try without sudo first (works on Windows, nvm, Homebrew, volta, etc.)
     try {
-        execSync('npm install -g openwriter', { stdio: 'inherit', timeout: 120000 });
+        execSync('npm install -g openwriter@latest', { stdio: 'inherit', timeout: 120000 });
         log('  ✓ Installed globally');
         return true;
     }
     catch {
         // Likely permission error on macOS/Linux system Node
     }
-    // Try with sudo on non-Windows
-    if (process.platform !== 'win32') {
+    // Try with sudo on non-Windows (only if we have a TTY for password prompt)
+    if (process.platform !== 'win32' && process.stdin.isTTY) {
         log('  Retrying with sudo...');
         try {
-            execSync('sudo npm install -g openwriter', { stdio: 'inherit', timeout: 120000 });
+            execSync('sudo npm install -g openwriter@latest', { stdio: 'inherit', timeout: 120000 });
             log('  ✓ Installed globally (sudo)');
             return true;
         }
@@ -43,8 +53,7 @@ function installGlobally() {
             // sudo failed too
         }
     }
-    log('  ✗ Could not install globally. Run manually:');
-    log('    npm install -g openwriter');
+    log('  ✗ Could not install globally (permissions)');
     return false;
 }
 function isMcpConfigured() {
@@ -59,11 +68,16 @@ function isMcpConfigured() {
         return false;
     }
 }
-function configureMcp() {
+function configureMcp(useNpx) {
     log('\n③ Configuring MCP server for Claude Code...');
+    const mcpCommand = useNpx ? 'npx' : 'openwriter';
+    const mcpArgs = useNpx ? ['-y', 'openwriter', '--no-open'] : ['--no-open'];
     // Try using claude CLI
+    const cliArgs = useNpx
+        ? 'claude mcp add -s user openwriter -- npx -y openwriter --no-open'
+        : 'claude mcp add -s user openwriter -- openwriter --no-open';
     try {
-        execSync('claude mcp add -s user openwriter -- openwriter --no-open', {
+        execSync(cliArgs, {
             stdio: 'inherit',
             timeout: 15000,
         });
@@ -86,7 +100,7 @@ function configureMcp() {
         // Add openwriter as first entry (Claude Code loads sequentially)
         const existing = config.mcpServers;
         config.mcpServers = {
-            openwriter: { command: 'openwriter', args: ['--no-open'] },
+            openwriter: { command: mcpCommand, args: mcpArgs },
             ...existing,
         };
         fs.writeFileSync(claudeJson, JSON.stringify(config, null, 2), 'utf-8');
@@ -122,22 +136,29 @@ export function installSkill() {
         }
         log(`  ✓ Skill docs copied to ${docsTarget}`);
     }
-    // Step 2: Global install (skip if already installed)
-    const alreadyInstalled = isGloballyInstalled();
-    if (alreadyInstalled) {
-        log('\n② openwriter already installed globally — skipping');
+    // Step 2: Global install or update
+    let useNpx = false;
+    const currentVersion = getGlobalVersion();
+    const latestVersion = getLatestVersion();
+    if (currentVersion && latestVersion && currentVersion === latestVersion) {
+        log(`\n② openwriter v${currentVersion} is up to date — skipping`);
     }
     else {
-        if (!installGlobally()) {
-            process.exit(1);
+        if (currentVersion && latestVersion) {
+            log(`\n② Updating openwriter: v${currentVersion} → v${latestVersion}`);
+        }
+        if (!installOrUpdateGlobally()) {
+            // Global install/update failed (permissions) — fall back to npx
+            log('  → Will use npx fallback for MCP server (no global install needed)');
+            useNpx = true;
         }
     }
-    // Step 3: Configure MCP server (skip if already configured)
-    if (isMcpConfigured()) {
+    // Step 3: Configure MCP server
+    if (isMcpConfigured() && !useNpx) {
         log('\n③ MCP server already configured — skipping');
     }
     else {
-        configureMcp();
+        configureMcp(useNpx);
     }
     // Done
     log('\n✓ OpenWriter is ready!');

package/dist/server/mcp.js

@@ -271,13 +271,13 @@ export const TOOL_REGISTRY = [
     },
     {
         name: 'create_document',
-        description: 'Create a new empty document and switch to it. Always provide a title. Saves the current document first. By default shows a sidebar spinner that persists until populate_document is called — set empty=true to skip the spinner and switch immediately (use for template docs like tweets/articles that don\'t need agent content). If workspace is provided, the doc is automatically added to it (workspace is created if it doesn\'t exist). If container is also provided, the doc is placed inside that container (created if it doesn\'t exist). Use content_type to create typed documents (tweet, article, linkedin, etc.) with the correct metadata pre-set.',
+        description: 'Create a new document. Always provide a title. By default shows a sidebar spinner — call populate_document next to deliver content and clear it. This two-step flow is REQUIRED for all content documents: create_document → populate_document. Do NOT use empty=true to skip this — empty=true is ONLY for content_type template docs (tweets, articles) that start blank and get metadata via set_metadata. If workspace is provided, the doc is automatically added to it (workspace is created if it doesn\'t exist). If container is also provided, the doc is placed inside that container (created if it doesn\'t exist).',
         schema: {
             title: z.string().optional().describe('Title for the new document. Defaults to "Untitled".'),
             path: z.string().optional().describe('Absolute file path to create the document at (e.g. "C:/projects/doc.md"). If omitted, creates in ~/.openwriter/.'),
             workspace: z.string().optional().describe('Workspace title to add this doc to. Creates the workspace if it doesn\'t exist.'),
             container: z.string().optional().describe('Container name within the workspace (e.g. "Chapters", "Notes", "References"). Creates the container if it doesn\'t exist. Requires workspace.'),
-            empty: z.boolean().optional().describe('If true, skip the writing spinner and switch to the doc immediately. No need to call populate_document. Use for template docs (tweets, articles) that start empty.'),
+            empty: z.boolean().optional().describe('ONLY for content_type template docs (tweets, articles) that start blank. Skips the spinner and switches immediately. Do NOT set this for content documents — use the two-step flow (create_document → populate_document) instead.'),
             content_type: z.string().optional().describe('Content type: tweet, reply, quote, article, linkedin, newsletter, or blog. Sets metadata so the doc is recognized as that type. For reply/quote, use set_metadata after creation to set the target tweet URL.'),
         },
         handler: async ({ title, path, workspace, container, empty, content_type }) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openwriter",
-  "version": "0.8.3",
+  "version": "0.8.6",
   "description": "The open-source writing surface for AI agents. Markdown-native editor with pending change review — your agent writes, you accept or reject.",
   "type": "module",
   "license": "MIT",