npm - openwriter - Versions diffs - 0.21.0 → 0.22.0 - Mend

openwriter 0.21.0 → 0.22.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/dist/client/assets/index-DFbNF7q0.css +1 -0
package/dist/client/assets/{index-B1-K-j46.js → index-OAhOx_JE.js} +48 -48
package/dist/client/index.html +2 -2
package/dist/server/activity-log.js +147 -0
package/dist/server/index.js +8 -0
package/dist/server/mcp.js +24 -0
package/package.json +1 -1
package/dist/client/assets/index-0ttVnjRp.css +0 -1

package/dist/client/index.html CHANGED Viewed

@@ -10,8 +10,8 @@
     <link rel="preconnect" href="https://fonts.googleapis.com" />
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
     <link href="https://fonts.googleapis.com/css2?family=Charter:ital,wght@0,400;0,700;1,400&family=Crimson+Pro:ital,wght@0,300;0,400;0,600;0,700;1,400&family=DM+Sans:ital,wght@0,400;0,500;0,600;0,700;1,400&family=DM+Serif+Display&family=IBM+Plex+Mono:wght@400;500;600&family=IBM+Plex+Sans:wght@400;500;600&family=Inter:wght@400;500;600;700&family=Libre+Baskerville:ital,wght@0,400;0,700;1,400&family=Literata:ital,opsz,wght@0,7..72,400;0,7..72,600;0,7..72,700;1,7..72,400&family=Newsreader:ital,opsz,wght@0,6..72,400;0,6..72,600;1,6..72,400&family=Playfair+Display:wght@400;600;700;900&family=Source+Serif+4:ital,opsz,wght@0,8..60,400;0,8..60,600;0,8..60,700;1,8..60,400&family=Space+Grotesk:wght@400;500;600;700&family=Space+Mono:wght@400;700&display=swap" rel="stylesheet" />
-    <script type="module" crossorigin src="/assets/index-B1-K-j46.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-0ttVnjRp.css">
+    <script type="module" crossorigin src="/assets/index-OAhOx_JE.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-DFbNF7q0.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/server/activity-log.js ADDED Viewed

@@ -0,0 +1,147 @@
+/**
+ * Activity log — persistent record of agent-attributed actions.
+ *
+ * The right-rail Activity tab reads this log. Entries are appended on the
+ * happy path of agent broadcasts (writing-finished, enrichment, backlinks
+ * propagation, agent-attributed doc create/delete). Human edits do NOT
+ * record entries — they aren't surprising to the user, so they're noise.
+ *
+ * Disk: JSONL at `<profile-dir>/activity.log`. Append-only with rotation
+ * at 10 MB / 5 files. ~150 bytes per entry, so 10 MB ≈ 70k entries — years
+ * of heavy use before the first rotation.
+ *
+ * Memory: a ring buffer of the most recent MAX_BUFFER_ENTRIES used to
+ * answer "give me the last 500 for the new client" without ever touching
+ * disk on the hot path.
+ *
+ * adr: adr/right-rail.md
+ */
+import { existsSync, mkdirSync, statSync, renameSync, unlinkSync, appendFileSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { getDataDir } from './helpers.js';
+const MAX_BUFFER_ENTRIES = 500;
+const MAX_FILE_BYTES = 10 * 1024 * 1024;
+const KEEP_ROTATIONS = 5;
+let buffer = [];
+let bufferSeeded = false;
+function getLogPath() {
+    return join(getDataDir(), 'activity.log');
+}
+function ensureLogDir() {
+    const dir = getDataDir();
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+}
+function rotateIfNeeded() {
+    const path = getLogPath();
+    if (!existsSync(path))
+        return;
+    let size;
+    try {
+        size = statSync(path).size;
+    }
+    catch {
+        return;
+    }
+    if (size < MAX_FILE_BYTES)
+        return;
+    try {
+        for (let i = KEEP_ROTATIONS; i >= 1; i--) {
+            const oldPath = i === 1 ? path : `${path}.${i - 1}`;
+            const newPath = `${path}.${i}`;
+            if (existsSync(oldPath)) {
+                if (i === KEEP_ROTATIONS && existsSync(newPath)) {
+                    try {
+                        unlinkSync(newPath);
+                    }
+                    catch { /* best-effort */ }
+                }
+                try {
+                    renameSync(oldPath, newPath);
+                }
+                catch { /* best-effort */ }
+            }
+        }
+    }
+    catch { /* best-effort */ }
+}
+/**
+ * Read the tail of the on-disk log into the in-memory buffer the first
+ * time someone asks for it. Subsequent calls are pure memory.
+ *
+ * The file is small enough that a one-shot full read on first access is
+ * fine; if it ever stops being small the rotation logic above keeps it
+ * bounded.
+ */
+function seedBuffer() {
+    if (bufferSeeded)
+        return;
+    bufferSeeded = true;
+    try {
+        const path = getLogPath();
+        if (!existsSync(path)) {
+            buffer = [];
+            return;
+        }
+        const raw = readFileSync(path, 'utf-8');
+        const lines = raw.split('\n').filter((l) => l.length > 0);
+        // File is oldest-first; the buffer carries newest-first to match what
+        // the client expects (and what every push extends).
+        const parsed = [];
+        for (let i = lines.length - 1; i >= 0 && parsed.length < MAX_BUFFER_ENTRIES; i--) {
+            try {
+                const evt = JSON.parse(lines[i]);
+                if (evt && typeof evt.ts === 'number' && typeof evt.kind === 'string' && typeof evt.headline === 'string') {
+                    parsed.push(evt);
+                }
+            }
+            catch { /* skip malformed line */ }
+        }
+        buffer = parsed;
+    }
+    catch {
+        buffer = [];
+    }
+}
+/** Append an event. Records to memory + disk; returns the stamped event. */
+export function recordActivity(partial) {
+    seedBuffer();
+    const evt = {
+        ts: partial.ts ?? Date.now(),
+        kind: partial.kind,
+        headline: partial.headline,
+    };
+    if (partial.detail)
+        evt.detail = partial.detail;
+    if (partial.filename)
+        evt.filename = partial.filename;
+    if (partial.nodeId)
+        evt.nodeId = partial.nodeId;
+    buffer.unshift(evt);
+    if (buffer.length > MAX_BUFFER_ENTRIES)
+        buffer.length = MAX_BUFFER_ENTRIES;
+    try {
+        ensureLogDir();
+        rotateIfNeeded();
+        appendFileSync(getLogPath(), JSON.stringify(evt) + '\n');
+    }
+    catch { /* logging must never throw */ }
+    return evt;
+}
+/** Tail of the activity log, newest-first. Used to seed clients on connect. */
+export function loadActivityTail(limit = MAX_BUFFER_ENTRIES) {
+    seedBuffer();
+    return buffer.slice(0, Math.min(limit, buffer.length));
+}
+/**
+ * Drop the in-memory buffer and force the next read to re-seed from disk.
+ * Called on profile switch — without this, the new profile inherits the
+ * previous profile's activity entries because `seedBuffer()` short-circuits
+ * when `bufferSeeded === true`. Disk writes are always per-profile (via
+ * getDataDir), so only the memory side leaks; this resets that side.
+ * adr: adr/right-rail.md
+ */
+export function clearActivityBuffer() {
+    buffer = [];
+    bufferSeeded = false;
+}

package/dist/server/index.js CHANGED Viewed

@@ -38,8 +38,16 @@ import { addComment, getComments, resolveComments, unresolveComments, deleteComm
 import { initLogger, logger, generateRequestId, withRequestId } from './logger.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
+// Runtime port the HTTP server is actually listening on. Set inside
+// startHttpServer once the port is resolved; read by tools that need to
+// construct absolute URLs (e.g. get_doc_link). Defaults to 5050 if read
+// before the server has booted — matches the default option.
+let runtimePort = 5050;
+export function getRuntimePort() { return runtimePort; }
+export function getBaseUrl() { return `http://localhost:${runtimePort}`; }
 export async function startHttpServer(options = {}) {
     const port = options.port || 5050;
+    runtimePort = port;
     // Initialize structured logging first — every subsequent module call can
     // emit events from this point. Config file lives at ~/.openwriter/
     // log-config.json (missing = safe public defaults: error-only, no text).

package/dist/server/mcp.js CHANGED Viewed

@@ -1775,6 +1775,30 @@ export const TOOL_REGISTRY = [
                         }) }] };
         },
     },
+    {
+        name: 'get_doc_link',
+        description: 'Return a clickable deep-link URL for a doc (and optionally a specific paragraph). Use this whenever you cite a docId in a response — emit the link as `[open](url)` so the user can click straight to the doc instead of manually navigating. URL pattern: `http://localhost:<port>/d/{docId}` for doc-level, plus `#node={nodeId}` for paragraph-level. The server stitches the URL with the live port, so the agent never has to guess the hostname or port.',
+        schema: {
+            docId: z.string().describe('Target document docId (8-char hex from list_documents / read_pad).'),
+            nodeId: z.string().optional().describe('Optional 8-char hex nodeId for paragraph-level anchor (visible in `read_pad`\'s tagged-line output). When set, opening the link scrolls the editor to that block and briefly highlights it.'),
+        },
+        handler: async ({ docId, nodeId }) => {
+            if (!/^[a-f0-9]{8}$/.test(docId)) {
+                return { content: [{ type: 'text', text: `docId "${docId}" is not a valid 8-char hex. Use list_documents to find the right docId.` }] };
+            }
+            const filename = resolveDocId(docId);
+            if (!filename) {
+                return { content: [{ type: 'text', text: `docId "${docId}" not found. Use list_documents to find the right docId.` }] };
+            }
+            if (nodeId !== undefined && !/^[a-f0-9]{8}$/.test(nodeId)) {
+                return { content: [{ type: 'text', text: `nodeId "${nodeId}" is not a valid 8-char hex. Use read_pad to see paragraph nodeIds.` }] };
+            }
+            const { getBaseUrl } = await import('./index.js');
+            const base = getBaseUrl();
+            const url = nodeId ? `${base}/d/${docId}#node=${nodeId}` : `${base}/d/${docId}`;
+            return { content: [{ type: 'text', text: JSON.stringify({ url, docId, nodeId: nodeId ?? null }) }] };
+        },
+    },
     {
         name: 'search_docs',
         description: 'Full-text search across all documents. Returns ranked candidates with docId, title, match type, and snippet. Use this BEFORE link_to to find the right target — the agent\'s primary primitive for resolving concept references to their canonical docs.',

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "openwriter",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "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",