npm - openwriter - Versions diffs - 0.39.0 → 0.40.1 - Mend

openwriter 0.39.0 → 0.40.1

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 (64) hide show

package/dist/client/assets/index-DiJrXBgV.css +1 -0
package/dist/client/assets/{index-DKnYQz7a.js → index-Dxbv2n2m.js} +53 -53
package/dist/client/index.html +2 -2
package/dist/server/connection-routes.js +66 -0
package/dist/server/tiptap-draftjs.js +296 -0
package/package.json +1 -1
package/dist/client/assets/index-D57aFMR_.css +0 -1
package/dist/plugins/authors-voice/dist/index.d.ts +0 -48
package/dist/plugins/authors-voice/dist/index.js +0 -235
package/dist/plugins/authors-voice/package.json +0 -24
package/dist/plugins/authors-voice/skill/LICENSE +0 -21
package/dist/plugins/authors-voice/skill/README.md +0 -126
package/dist/plugins/authors-voice/skill/SKILL.md +0 -151
package/dist/plugins/authors-voice/skill/catalog/ai-tells.md +0 -144
package/dist/plugins/authors-voice/skill/catalog/anchor-prompt.md +0 -189
package/dist/plugins/authors-voice/skill/catalog/author-hints.md +0 -119
package/dist/plugins/authors-voice/skill/catalog/fingerprints.md +0 -175
package/dist/plugins/authors-voice/skill/catalog/hurdle.md +0 -76
package/dist/plugins/authors-voice/skill/catalog/post-write-audit.md +0 -105
package/dist/plugins/authors-voice/skill/docs/analysis.md +0 -31
package/dist/plugins/authors-voice/skill/docs/anchor-iteration.md +0 -176
package/dist/plugins/authors-voice/skill/docs/api/import.md +0 -78
package/dist/plugins/authors-voice/skill/docs/api/protocol.md +0 -140
package/dist/plugins/authors-voice/skill/docs/api/setup.md +0 -37
package/dist/plugins/authors-voice/skill/docs/api/tools.md +0 -102
package/dist/plugins/authors-voice/skill/docs/api/troubleshooting.md +0 -7
package/dist/plugins/authors-voice/skill/docs/apply-protocol-deep.md +0 -191
package/dist/plugins/authors-voice/skill/docs/context-hygiene.md +0 -33
package/dist/plugins/authors-voice/skill/docs/setup.md +0 -74
package/dist/plugins/authors-voice/skill/docs/tiers.md +0 -13
package/dist/plugins/authors-voice/skill/package.json +0 -35
package/dist/plugins/authors-voice/skill/prompts/skeleton.md +0 -29
package/dist/plugins/authors-voice/skill/voice/README.md +0 -51
package/dist/plugins/authors-voice/skill/voice/corpus/.gitkeep +0 -0
package/dist/plugins/github/dist/blog-tools.d.ts +0 -65
package/dist/plugins/github/dist/blog-tools.js +0 -1189
package/dist/plugins/github/dist/git-sync.d.ts +0 -46
package/dist/plugins/github/dist/git-sync.js +0 -335
package/dist/plugins/github/dist/helpers.d.ts +0 -127
package/dist/plugins/github/dist/helpers.js +0 -67
package/dist/plugins/github/dist/index.d.ts +0 -12
package/dist/plugins/github/dist/index.js +0 -112
package/dist/plugins/github/package.json +0 -24
package/dist/plugins/image-gen/dist/index.d.ts +0 -35
package/dist/plugins/image-gen/dist/index.js +0 -149
package/dist/plugins/image-gen/package.json +0 -26
package/dist/plugins/publish/dist/helpers.d.ts +0 -66
package/dist/plugins/publish/dist/helpers.js +0 -199
package/dist/plugins/publish/dist/index.d.ts +0 -3
package/dist/plugins/publish/dist/index.js +0 -1156
package/dist/plugins/publish/dist/newsletter-tools.d.ts +0 -2
package/dist/plugins/publish/dist/newsletter-tools.js +0 -394
package/dist/plugins/publish/package.json +0 -31
package/dist/plugins/x-api/dist/index.d.ts +0 -27
package/dist/plugins/x-api/dist/index.js +0 -240
package/dist/plugins/x-api/package.json +0 -27
package/dist/server/blog-routes.js +0 -160
package/dist/server/git-sync.js +0 -273
package/dist/server/marks.js +0 -182
package/dist/server/sync-routes.js +0 -75
package/skill/docs/enrichment.md +0 -180
package/skill/docs/footnotes.md +0 -178
package/skill/docs/setup.md +0 -62
package/skill/docs/welcome.md +0 -21

package/dist/client/index.html CHANGED Viewed

@@ -10,8 +10,8 @@
     <!-- Fonts are self-hosted (bundled via @fontsource, imported in main.tsx →
          themes/vendored-fonts.css). No external font CDN: a local-first editor
          must work offline and behind content blockers. -->
-    <script type="module" crossorigin src="/assets/index-DKnYQz7a.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-D57aFMR_.css">
+    <script type="module" crossorigin src="/assets/index-Dxbv2n2m.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-DiJrXBgV.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/server/connection-routes.js CHANGED Viewed

@@ -3,7 +3,12 @@
  * Local app no longer stores connections.
  */
 import { Router } from 'express';
+import { readFileSync, existsSync } from 'fs';
+import { join, extname } from 'path';
 import { platformFetch, isAuthenticated } from './connections.js';
+import { getDocument, getTitle, getMetadata } from './state.js';
+import { getDataDir } from './helpers.js';
+import { tiptapToDraftjs } from './tiptap-draftjs.js';
 export function createConnectionRouter() {
     const router = Router();
     // Unified connections list (OAuth + newsletter domains)
@@ -376,5 +381,66 @@ export function createConnectionRouter() {
             res.status(500).json({ success: false, error: err.message });
         }
     });
+    // POST /api/x/post-article — publish the active doc as a native X Article.
+    // Platform connection first (managed path), then fall through to the x-api
+    // plugin (direct OAuth1). Mirrors the /api/x/post routing. The article body
+    // is read from the active server doc and converted to X content_state here;
+    // the cover image (articleContext.coverImage) is uploaded via the platform.
+    router.post('/api/x/post-article', async (req, res, next) => {
+        const conn = await getFirstXConnection();
+        if (!conn) {
+            next();
+            return;
+        } // No platform connection → direct plugin path
+        try {
+            const title = (getTitle() || '').trim();
+            if (!title || title === 'Untitled') {
+                res.status(400).json({ success: false, error: 'Article needs a title before posting.' });
+                return;
+            }
+            const contentState = tiptapToDraftjs(getDocument());
+            if (!contentState.blocks.some((b) => (b.text || '').trim().length > 0)) {
+                res.status(400).json({ success: false, error: 'Article body is empty.' });
+                return;
+            }
+            // Optional cover — upload through the platform, attach by media id.
+            let coverMediaId;
+            const coverSrc = getMetadata()?.articleContext?.coverImage;
+            if (coverSrc && typeof coverSrc === 'string' && /^\/_images\/[^/\\]+$/.test(coverSrc)) {
+                const filename = coverSrc.replace('/_images/', '');
+                const filePath = join(getDataDir(), '_images', filename);
+                if (existsSync(filePath)) {
+                    const ext = extname(filename).toLowerCase();
+                    const mimeMap = {
+                        '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg',
+                        '.png': 'image/png', '.webp': 'image/webp',
+                        '.gif': 'image/gif', '.bmp': 'image/bmp',
+                    };
+                    const uploadRes = await platformFetch(`/connections/${conn.id}/upload-media`, {
+                        method: 'POST',
+                        body: JSON.stringify({ media_base64: readFileSync(filePath).toString('base64'), media_type: mimeMap[ext] || 'image/jpeg' }),
+                    });
+                    if (uploadRes.ok) {
+                        const data = await uploadRes.json();
+                        if (data.mediaId)
+                            coverMediaId = data.mediaId;
+                    }
+                }
+            }
+            const upstream = await platformFetch(`/connections/${conn.id}/post-article`, {
+                method: 'POST',
+                body: JSON.stringify({ title, content_state: contentState, cover_media_id: coverMediaId }),
+            });
+            const data = await upstream.json();
+            if (!upstream.ok || !data.success) {
+                res.status(upstream.status || 500).json({ success: false, error: data.error || 'Article publish failed' });
+                return;
+            }
+            res.json({ success: true, articleId: data.articleId, postId: data.postId, articleUrl: data.post_url });
+        }
+        catch (err) {
+            res.status(500).json({ success: false, error: err.message });
+        }
+    });
     return router;
 }

package/dist/server/tiptap-draftjs.js ADDED Viewed

@@ -0,0 +1,296 @@
+/**
+ * TipTap / ProseMirror JSON  ->  X Articles DraftJS `content_state`.
+ *
+ * X's `POST /2/articles/draft` takes the article body as a DraftJS raw content
+ * state, in X's snake_case field naming:
+ *
+ *   {
+ *     blocks: [
+ *       { key, text, type, depth?, inline_style_ranges?, entity_ranges? }
+ *     ],
+ *     entities: [ { key, value: { type, mutability, data } } ]
+ *   }
+ *
+ * (Minimal valid body: `{"blocks":[{"text":"hi","type":"unstyled"}],"entities":[]}`.)
+ *
+ * This is the SINGLE shared converter imported by both posting paths — the
+ * direct plugin (plugins/x-api) and the managed plugin (plugins/publish) — so
+ * the OpenWriter-doc → X conversion lives in exactly one place. It is a pure
+ * function with no runtime deps, which keeps it trivially unit-testable and
+ * importable from either plugin's compiled context.
+ *
+ * v1 fidelity:
+ *   - blocks:  heading (h1–h6), paragraph, bullet/ordered/task lists (nested
+ *              via `depth`), blockquote, code-block.
+ *   - inline:  bold, italic, underline, strikethrough, inline code, links.
+ *   - tables:  degrade to pipe-joined text rows (no DraftJS table primitive).
+ *   - cover:   handled out of band via `cover_media` on the draft call — NOT
+ *              here. Body images degrade to their alt text (an inline-image
+ *              atomic-block shape isn't confirmed against X's schema yet).
+ *   - rules:   horizontalRule degrades to a blank separator block.
+ *   - marks X's DraftJS editor doesn't model (highlight, sub/superscript)
+ *     drop to plain text — the text always survives.
+ */
+/** TipTap mark type -> X DraftJS inline style. X's article schema accepts only
+ *  [bold, italic, strikethrough] (lowercase). Marks absent here (underline,
+ *  inline code, highlight, sub/superscript) drop silently — the underlying text
+ *  is unaffected. Verified against X's live validation. */
+const MARK_STYLE = {
+    bold: 'bold',
+    italic: 'italic',
+    strike: 'strikethrough',
+};
+const HEADER_TYPE = ['', 'header-one', 'header-two', 'header-three', 'header-four', 'header-five', 'header-six'];
+/** Accumulates blocks + entities and hands out unique keys. */
+class BuildContext {
+    blocks = [];
+    entities = [];
+    blockN = 0;
+    entityN = 0;
+    nextBlockKey() {
+        return 'b' + (this.blockN++).toString(36);
+    }
+    addEntity(type, mutability, data) {
+        const n = this.entityN++;
+        // entities[].key is a string; the returned integer is what entity_ranges use.
+        this.entities.push({ key: String(n), value: { type, mutability, data } });
+        return n;
+    }
+    pushText(text, type, depth = 0) {
+        const block = { key: this.nextBlockKey(), text, type };
+        if (depth)
+            block.depth = depth;
+        this.blocks.push(block);
+    }
+    pushInline(inline, type, depth = 0) {
+        const block = { key: this.nextBlockKey(), text: inline.text, type };
+        if (depth)
+            block.depth = depth;
+        if (inline.styles.length)
+            block.inline_style_ranges = mergeStyleRanges(inline.styles);
+        if (inline.entityRanges.length)
+            block.entity_ranges = inline.entityRanges;
+        this.blocks.push(block);
+    }
+}
+/** Convert a TipTap document (`{ type: 'doc', content: [...] }`) to X's DraftJS
+ *  content_state. Always returns at least one block — an empty doc yields a
+ *  single empty unstyled block, since X rejects a draft with no blocks. */
+export function tiptapToDraftjs(doc) {
+    const ctx = new BuildContext();
+    walkBlocks(doc?.content || [], 0, ctx);
+    if (ctx.blocks.length === 0)
+        ctx.pushText('', 'unstyled');
+    return { blocks: ctx.blocks, entities: ctx.entities };
+}
+function walkBlocks(nodes, depth, ctx) {
+    for (const node of nodes || []) {
+        switch (node?.type) {
+            case 'heading': {
+                const level = Math.min(Math.max(Number(node.attrs?.level) || 1, 1), 6);
+                ctx.pushInline(buildInline(node.content, ctx), HEADER_TYPE[level], depth);
+                break;
+            }
+            case 'paragraph':
+                ctx.pushInline(buildInline(node.content, ctx), 'unstyled', depth);
+                break;
+            case 'bulletList':
+                walkList(node.content, 'unordered-list-item', depth, ctx);
+                break;
+            case 'orderedList':
+                walkList(node.content, 'ordered-list-item', depth, ctx);
+                break;
+            case 'taskList':
+                walkTaskList(node.content, depth, ctx);
+                break;
+            case 'blockquote':
+                walkBlockquote(node.content, depth, ctx);
+                break;
+            case 'codeBlock': {
+                // DraftJS models a code block as one code-block per line; this is the
+                // faithful raw shape and round-trips cleanly in X's editor.
+                const lines = plainText(node.content).split('\n');
+                for (const line of lines)
+                    ctx.pushText(line, 'code-block', depth);
+                break;
+            }
+            case 'horizontalRule':
+                // No confirmed DraftJS divider primitive in X's article schema — emit a
+                // blank separator block rather than risk a rejected payload.
+                ctx.pushText('', 'unstyled', depth);
+                break;
+            case 'image':
+                // Inline body images need an uploaded media_id + an atomic-block entity
+                // shape not yet confirmed against X's schema. Preserve the alt text so
+                // context isn't silently lost; the hero/cover image is handled by
+                // cover_media on the draft call, not here.
+                if (node.attrs?.alt)
+                    ctx.pushText(String(node.attrs.alt), 'unstyled', depth);
+                break;
+            case 'table':
+                walkTable(node, depth, ctx);
+                break;
+            case 'footnoteSection':
+                walkFootnoteSection(node.content, depth, ctx);
+                break;
+            default:
+                // Unknown container — descend so nested content isn't dropped.
+                if (node?.content)
+                    walkBlocks(node.content, depth, ctx);
+        }
+    }
+}
+/** Walk a bullet/ordered list. Each listItem's first paragraph becomes one
+ *  list-item block; nested lists recurse at depth+1 (DraftJS list nesting). */
+function walkList(items, blockType, depth, ctx) {
+    for (const item of items || []) {
+        for (const child of item.content || []) {
+            if (child.type === 'bulletList')
+                walkList(child.content, 'unordered-list-item', depth + 1, ctx);
+            else if (child.type === 'orderedList')
+                walkList(child.content, 'ordered-list-item', depth + 1, ctx);
+            else if (child.type === 'paragraph')
+                ctx.pushInline(buildInline(child.content, ctx), blockType, depth);
+            else
+                walkBlocks([child], depth, ctx);
+        }
+    }
+}
+/** X's DraftJS has no task-list type; degrade each task item to a bullet with a
+ *  leading checkbox glyph (☑ / ☐) so the checked state survives visually. */
+function walkTaskList(items, depth, ctx) {
+    for (const item of items || []) {
+        const prefix = item.attrs?.checked ? '☑ ' : '☐ ';
+        let prefixed = false;
+        for (const child of item.content || []) {
+            if (child.type === 'taskList')
+                walkTaskList(child.content, depth + 1, ctx);
+            else if (child.type === 'paragraph') {
+                const inline = buildInline(child.content, ctx);
+                if (!prefixed) {
+                    shiftRanges(inline, prefix.length);
+                    inline.text = prefix + inline.text;
+                    prefixed = true;
+                }
+                ctx.pushInline(inline, 'unordered-list-item', depth);
+            }
+            else
+                walkBlocks([child], depth, ctx);
+        }
+    }
+}
+/** Each paragraph inside a blockquote becomes its own `blockquote` block. */
+function walkBlockquote(nodes, depth, ctx) {
+    for (const child of nodes || []) {
+        if (child.type === 'paragraph')
+            ctx.pushInline(buildInline(child.content, ctx), 'blockquote', depth);
+        else
+            walkBlocks([child], depth, ctx);
+    }
+}
+/** Degrade a table to one unstyled text block per row, cells pipe-joined. No
+ *  data is lost; the grid structure flattens to readable text. */
+function walkTable(node, depth, ctx) {
+    for (const row of node.content || []) {
+        const cells = (row.content || []).map((cell) => (cell.content || []).map((p) => plainInline(p.content)).join(' ').trim());
+        ctx.pushText(cells.join(' | '), 'unstyled', depth);
+    }
+}
+/** Footnote definitions render as plain blocks, first paragraph prefixed with
+ *  its label, so the reference text isn't orphaned. */
+function walkFootnoteSection(definitions, depth, ctx) {
+    for (const def of definitions || []) {
+        if (def.type !== 'footnoteDefinition')
+            continue;
+        const label = def.attrs?.label || '';
+        const paragraphs = (def.content || []).filter((c) => c.type === 'paragraph');
+        paragraphs.forEach((p, i) => {
+            const inline = buildInline(p.content, ctx);
+            if (i === 0) {
+                const prefix = `[${label}] `;
+                shiftRanges(inline, prefix.length);
+                inline.text = prefix + inline.text;
+            }
+            ctx.pushInline(inline, 'unstyled', depth);
+        });
+    }
+}
+/** Walk a node's inline content into { text, inline-style ranges, entity ranges },
+ *  registering link entities into the build context as it goes. */
+function buildInline(nodes, ctx) {
+    let text = '';
+    const styles = [];
+    const entityRanges = [];
+    for (const node of nodes || []) {
+        if (node.type === 'hardBreak') {
+            text += '\n';
+            continue;
+        }
+        if (node.type === 'footnoteReference') {
+            text += `[${node.attrs?.label || ''}]`;
+            continue;
+        }
+        if (node.type !== 'text') {
+            if (node.text)
+                text += node.text;
+            continue;
+        }
+        const piece = node.text || '';
+        const offset = text.length;
+        text += piece;
+        const length = piece.length;
+        if (length === 0)
+            continue;
+        for (const mark of node.marks || []) {
+            const style = MARK_STYLE[mark.type];
+            if (style)
+                styles.push({ offset, length, style });
+            if (mark.type === 'link') {
+                const href = mark.attrs?.href || '';
+                if (href) {
+                    const key = ctx.addEntity('link', 'mutable', { url: href });
+                    entityRanges.push({ offset, length, key });
+                }
+            }
+        }
+    }
+    return { text, styles, entityRanges };
+}
+/** Shift every range offset right by `n` (used when a text prefix — checkbox
+ *  glyph, footnote label — is prepended after inline ranges were computed). */
+function shiftRanges(inline, n) {
+    for (const s of inline.styles)
+        s.offset += n;
+    for (const e of inline.entityRanges)
+        e.offset += n;
+}
+/** Merge adjacent ranges with the same style (`...a..**b**..` split across
+ *  text nodes) into one, keeping the output minimal and stable. */
+function mergeStyleRanges(ranges) {
+    const sorted = [...ranges].sort((a, b) => a.style.localeCompare(b.style) || a.offset - b.offset);
+    const out = [];
+    for (const r of sorted) {
+        const last = out[out.length - 1];
+        if (last && last.style === r.style && last.offset + last.length === r.offset) {
+            last.length += r.length;
+        }
+        else {
+            out.push({ ...r });
+        }
+    }
+    return out;
+}
+/** Plain text of a node's inline content, marks ignored. */
+function plainInline(nodes) {
+    if (!nodes)
+        return '';
+    return nodes
+        .map((n) => (n.type === 'hardBreak' ? '\n' : n.text || ''))
+        .join('');
+}
+/** Plain text of block content (e.g. a code block's lines). */
+function plainText(nodes) {
+    if (!nodes)
+        return '';
+    return nodes.map((n) => n.text || '').join('');
+}

package/package.json CHANGED Viewed

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