p-spore 0.1.4 → 0.1.43

package/dist/articles/plain.js

@@ -0,0 +1,69 @@
+/**
+ * Markdown to plain text for the `.txt` export.
+ *
+ * Markers (`#`, `**`, backticks, table pipes) are dropped. The words stay, in
+ * reading order, so the file is something a person can open without a renderer.
+ */
+import { parseMarkdown, } from "../ui/shared/markdown.js";
+export function markdownToPlainText(source) {
+    const normalized = source.replaceAll("\r\n", "\n").replaceAll("\r", "\n");
+    const blocks = parseMarkdown(normalized);
+    if (blocks.length === 0)
+        return normalized.trim();
+    return blocks.map((block) => blockToPlain(block).trimEnd()).filter((part) => part !== "").join("\n\n");
+}
+function blockToPlain(block) {
+    switch (block.kind) {
+        case "paragraph":
+            return inlineToPlain(block.inline);
+        case "heading":
+            return inlineToPlain(block.inline);
+        case "code":
+            return block.value;
+        case "quote":
+            return block.blocks.map((child) => blockToPlain(child)).filter(Boolean).join("\n");
+        case "list":
+            return block.items.map((item, index) => listItemToPlain(item.blocks, block.ordered, block.start + index, item.checked)).join("\n");
+        case "rule":
+            return "";
+        case "table": {
+            const rows = [block.head, ...block.rows];
+            return rows.map((row) => row.map((cell) => inlineToPlain(cell).replaceAll("\t", " ")).join("\t")).join("\n");
+        }
+    }
+}
+/** Two spaces per level, so a nested list reads as nested without any markers. */
+const LIST_INDENT = "  ";
+function listItemToPlain(blocks, ordered, number, checked) {
+    const head = blocks[0];
+    const lead = head?.kind === "paragraph" ? inlineToPlain(head.inline) : "";
+    const rest = blocks.slice(head?.kind === "paragraph" ? 1 : 0)
+        .map((block) => blockToPlain(block))
+        .filter(Boolean)
+        .map((text) => text.split("\n").map((line) => `${LIST_INDENT}${line}`).join("\n"))
+        .join("\n");
+    const mark = checked === undefined ? "" : checked ? "已完成 " : "未完成 ";
+    const prefix = ordered ? `${number}. ` : "• ";
+    return rest ? `${prefix}${mark}${lead}\n${rest}` : `${prefix}${mark}${lead}`;
+}
+function inlineToPlain(inline) {
+    return inline.map((part) => inlinePart(part)).join("");
+}
+function inlinePart(part) {
+    switch (part.kind) {
+        case "text":
+        case "code":
+            return part.value;
+        case "strong":
+        case "emphasis":
+        case "strike":
+            return inlineToPlain(part.children);
+        case "link": {
+            const label = inlineToPlain(part.children);
+            return label === part.href || label === "" ? part.href : `${label} (${part.href})`;
+        }
+        case "break":
+            return "\n";
+    }
+}
+//# sourceMappingURL=plain.js.map

package/dist/articles/plain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plain.js","sourceRoot":"","sources":["../../src/articles/plain.ts"],"names":[],"mappings":"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"}

package/dist/articles/preview.d.ts

@@ -0,0 +1,43 @@
+/**
+ * In-memory draft of an article the model is still streaming into a tool call.
+ *
+ * The arguments are not a file yet — the tool has not run — but the panel
+ * should already be rendering them. Only metadata is published; the text stays
+ * here and is read back in slices, the same way an oversized message is.
+ */
+export interface ArticleDraftEdit {
+    find: string;
+    replace: string;
+}
+export interface ArticleDraft {
+    toolCallId: string;
+    sessionId: string;
+    action: "create" | "update";
+    title?: string;
+    articleId?: string;
+    /** A full draft of the document, written from the top. */
+    content?: string;
+    /** Local changes to the saved version, each with its `find` written in full. */
+    edits?: readonly ArticleDraftEdit[];
+    /** The last edit's replacement is still arriving. */
+    editOpen?: boolean;
+}
+export declare const ARTICLE_PREVIEW_INTERVAL_MS = 120;
+export declare class ArticlePreviewBus {
+    #private;
+    private readonly publish;
+    private readonly clock;
+    constructor(publish?: (draft: ArticleDraft) => void, clock?: () => number);
+    /**
+     * Records the latest draft. Returns true when a preview is published now:
+     * the first time this call is seen, and at most once per interval after that.
+     * Identical repeats stay quiet so a token that did not extend the draft does
+     * not wake the panel. A suppressed change is published at the trailing edge,
+     * even when the provider pauses without sending another token.
+     */
+    note(draft: ArticleDraft, now: number): boolean;
+    get(toolCallId: string): ArticleDraft | undefined;
+    clear(toolCallId: string): void;
+    clearSession(sessionId: string): void;
+}
+//# sourceMappingURL=preview.d.ts.map

package/dist/articles/preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/articles/preview.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,KAAK,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACpC,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C,qBAAa,iBAAiB;;IAM1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,OAAO,GAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAe,EACjD,KAAK,GAAE,MAAM,MAAiB;IAGjD;;;;;;OAMG;IACH,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IA8B/C,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAKjD,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAO/B,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAKtC"}

package/dist/articles/preview.js

@@ -0,0 +1,90 @@
+/**
+ * In-memory draft of an article the model is still streaming into a tool call.
+ *
+ * The arguments are not a file yet — the tool has not run — but the panel
+ * should already be rendering them. Only metadata is published; the text stays
+ * here and is read back in slices, the same way an oversized message is.
+ */
+export const ARTICLE_PREVIEW_INTERVAL_MS = 120;
+export class ArticlePreviewBus {
+    publish;
+    clock;
+    #drafts = new Map();
+    #emittedAt = new Map();
+    #pending = new Map();
+    constructor(publish = () => { }, clock = Date.now) {
+        this.publish = publish;
+        this.clock = clock;
+    }
+    /**
+     * Records the latest draft. Returns true when a preview is published now:
+     * the first time this call is seen, and at most once per interval after that.
+     * Identical repeats stay quiet so a token that did not extend the draft does
+     * not wake the panel. A suppressed change is published at the trailing edge,
+     * even when the provider pauses without sending another token.
+     */
+    note(draft, now) {
+        const previous = this.#drafts.get(draft.toolCallId);
+        this.#drafts.set(draft.toolCallId, draft);
+        if (previous && sameDraft(previous, draft))
+            return false;
+        const last = this.#emittedAt.get(draft.toolCallId);
+        if (last !== undefined && now - last < ARTICLE_PREVIEW_INTERVAL_MS) {
+            // A gateway can deliver a burst and then go quiet. Flush its last draft
+            // without requiring another token to arrive and wake the panel.
+            if (!this.#pending.has(draft.toolCallId)) {
+                const timer = setTimeout(() => {
+                    this.#pending.delete(draft.toolCallId);
+                    const latest = this.#drafts.get(draft.toolCallId);
+                    if (latest)
+                        this.#publish(latest, this.clock());
+                }, ARTICLE_PREVIEW_INTERVAL_MS - (now - last));
+                timer.unref();
+                this.#pending.set(draft.toolCallId, timer);
+            }
+            return false;
+        }
+        this.#publish(draft, now);
+        return true;
+    }
+    #publish(draft, now) {
+        clearTimeout(this.#pending.get(draft.toolCallId));
+        this.#pending.delete(draft.toolCallId);
+        this.#emittedAt.set(draft.toolCallId, now);
+        this.publish(draft);
+    }
+    get(toolCallId) {
+        const draft = this.#drafts.get(toolCallId);
+        return draft ? { ...draft } : undefined;
+    }
+    clear(toolCallId) {
+        clearTimeout(this.#pending.get(toolCallId));
+        this.#pending.delete(toolCallId);
+        this.#drafts.delete(toolCallId);
+        this.#emittedAt.delete(toolCallId);
+    }
+    clearSession(sessionId) {
+        for (const draft of this.#drafts.values()) {
+            if (draft.sessionId === sessionId)
+                this.clear(draft.toolCallId);
+        }
+    }
+}
+/**
+ * Arguments only ever grow while they stream, so an edit that kept its lengths
+ * kept its text; comparing lengths spares re-reading every quoted passage on
+ * every token.
+ */
+function sameDraft(before, after) {
+    return before.action === after.action
+        && before.title === after.title
+        && before.articleId === after.articleId
+        && before.content === after.content
+        && before.editOpen === after.editOpen
+        && (before.edits?.length ?? -1) === (after.edits?.length ?? -1)
+        && (before.edits ?? []).every((edit, index) => {
+            const next = after.edits?.[index];
+            return next !== undefined && next.find.length === edit.find.length && next.replace.length === edit.replace.length;
+        });
+}
+//# sourceMappingURL=preview.js.map

package/dist/articles/preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.js","sourceRoot":"","sources":["../../src/articles/preview.ts"],"names":[],"mappings":"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"}

package/dist/articles/publish.d.ts

@@ -0,0 +1,10 @@
+/**
+ * What an `article` tool call is allowed to put on the protocol.
+ *
+ * The arguments and a `read` result carry the whole document. Publishing that
+ * would drop it into the activity card and, past 64 KiB, into the truncation
+ * path that exists for ordinary messages. The panel reads the file itself.
+ * The model still receives the untouched tool result from Pi.
+ */
+export declare function publishedArticleValue(toolName: string, value: unknown): unknown;
+//# sourceMappingURL=publish.d.ts.map

package/dist/articles/publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../src/articles/publish.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAI/E"}

package/dist/articles/publish.js

@@ -0,0 +1,54 @@
+/**
+ * What an `article` tool call is allowed to put on the protocol.
+ *
+ * The arguments and a `read` result carry the whole document. Publishing that
+ * would drop it into the activity card and, past 64 KiB, into the truncation
+ * path that exists for ordinary messages. The panel reads the file itself.
+ * The model still receives the untouched tool result from Pi.
+ */
+const ARTICLE_HEAD_LINES = 4;
+export function publishedArticleValue(toolName, value) {
+    if (toolName !== "article" || !isRecord(value))
+        return value;
+    if (Array.isArray(value["content"]))
+        return publishedResult(value);
+    return publishedInput(value);
+}
+function publishedInput(value) {
+    const next = { ...value };
+    if (typeof next["instruction"] === "string") {
+        next["instructionChars"] = next["instruction"].length;
+        delete next["instruction"];
+    }
+    if (typeof next["content"] === "string") {
+        next["contentChars"] = next["content"].length;
+        delete next["content"];
+    }
+    if (Array.isArray(next["edits"])) {
+        next["editCount"] = next["edits"].length;
+        delete next["edits"];
+    }
+    return next;
+}
+function publishedResult(value) {
+    const content = value["content"];
+    if (!Array.isArray(content))
+        return value;
+    const details = isRecord(value["details"]) ? { ...value["details"] } : undefined;
+    if (details)
+        delete details["articleDraft"];
+    return {
+        ...value,
+        ...(details ? { details } : {}),
+        content: content.map((block) => {
+            if (!isRecord(block) || typeof block["text"] !== "string")
+                return block;
+            const head = block["text"].split("\n").slice(0, ARTICLE_HEAD_LINES).join("\n");
+            return head === block["text"] ? block : { ...block, text: head };
+        }),
+    };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=publish.js.map

package/dist/articles/publish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.js","sourceRoot":"","sources":["../../src/articles/publish.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAE7B,MAAM,UAAU,qBAAqB,CAAC,QAAgB,EAAE,KAAc;IACpE,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAAE,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;IACnE,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,cAAc,CAAC,KAA8B;IACpD,MAAM,IAAI,GAA4B,EAAE,GAAG,KAAK,EAAE,CAAC;IACnD,IAAI,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC5C,IAAI,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC;QACtD,OAAO,IAAI,CAAC,aAAa,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,QAAQ,EAAE,CAAC;QACxC,IAAI,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;QAC9C,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC;IACzB,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QACjC,IAAI,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,eAAe,CAAC,KAA8B;IACrD,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;IACjC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACjF,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC,cAAc,CAAC,CAAC;IAC5C,OAAO;QACL,GAAG,KAAK;QACR,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,KAAc,EAAE,EAAE;YACtC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ;gBAAE,OAAO,KAAK,CAAC;YACxE,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/E,OAAO,IAAI,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACnE,CAAC,CAAC;KACH,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/articles/receipt.d.ts

@@ -0,0 +1,16 @@
+/** First line of every `article` tool result. The panel and the chat card both key off it. */
+export declare const ARTICLE_RECEIPT: RegExp;
+export interface ArticleReceipt {
+    id: string;
+    version: number;
+    title?: string;
+}
+export interface ArticleOpenReceipt {
+    title: string;
+    id?: string;
+    version?: number;
+}
+/** A preparation call opens the surface without pretending a version was saved. */
+export declare function parseArticleOpenReceipt(text: string): ArticleOpenReceipt | undefined;
+export declare function parseArticleReceipt(text: string): ArticleReceipt | undefined;
+//# sourceMappingURL=receipt.d.ts.map

package/dist/articles/receipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt.d.ts","sourceRoot":"","sources":["../../src/articles/receipt.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,eAAO,MAAM,eAAe,QAA+C,CAAC;AAE5E,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,mFAAmF;AACnF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAMpF;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAY5E"}

package/dist/articles/receipt.js

@@ -0,0 +1,27 @@
+/** First line of every `article` tool result. The panel and the chat card both key off it. */
+export const ARTICLE_RECEIPT = /^article (art_[a-f0-9]{12}) version (\d+)$/;
+/** A preparation call opens the surface without pretending a version was saved. */
+export function parseArticleOpenReceipt(text) {
+    const [head, titleLine] = text.split("\n");
+    const match = /^article open(?: (art_[a-f0-9]{12}) version ([1-9]\d*))?$/.exec(head?.trim() ?? "");
+    const title = titleLine?.startsWith("标题：") ? titleLine.slice("标题：".length).trim() : undefined;
+    if (!match || !title)
+        return undefined;
+    return { title, ...(match[1] ? { id: match[1], version: Number(match[2]) } : {}) };
+}
+export function parseArticleReceipt(text) {
+    const [head, titleLine] = text.split("\n");
+    const match = ARTICLE_RECEIPT.exec(head?.trim() ?? "");
+    if (!match)
+        return undefined;
+    const version = Number(match[2]);
+    if (!Number.isInteger(version) || version < 1)
+        return undefined;
+    const title = titleLine?.startsWith("标题：") ? titleLine.slice("标题：".length).trim() : undefined;
+    return {
+        id: match[1] ?? "",
+        version,
+        ...(title ? { title } : {}),
+    };
+}
+//# sourceMappingURL=receipt.js.map

package/dist/articles/receipt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt.js","sourceRoot":"","sources":["../../src/articles/receipt.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,MAAM,CAAC,MAAM,eAAe,GAAG,4CAA4C,CAAC;AAc5E,mFAAmF;AACnF,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,2DAA2D,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACnG,MAAM,KAAK,GAAG,SAAS,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9F,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IACvC,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAChE,MAAM,KAAK,GAAG,SAAS,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9F,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;QAClB,OAAO;QACP,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5B,CAAC;AACJ,CAAC"}

package/dist/articles/store.d.ts

@@ -0,0 +1,78 @@
+import { type ArticleEdit } from "./edits.js";
+export type { ArticleEdit } from "./edits.js";
+/** `art_` plus 12 hex characters. Short enough to say, long enough not to guess. */
+export declare const ARTICLE_ID_PATTERN: RegExp;
+/** A long article, not a book. Past this the tool asks for a tighter draft. */
+export declare const MAX_ARTICLE_CHARS = 400000;
+/** Versions kept for one article. Each one is a full snapshot so any of them can be reopened. */
+export declare const MAX_ARTICLE_VERSIONS = 100;
+export interface ArticleVersionInfo {
+    version: number;
+    createdAt: string;
+    chars: number;
+    sha256: string;
+}
+export interface ArticleSummary {
+    id: string;
+    title: string;
+    sessionId: string;
+    version: number;
+    chars: number;
+    updatedAt: string;
+}
+export interface ArticleCommit {
+    id: string;
+    title: string;
+    version: number;
+    chars: number;
+    added: number;
+    removed: number;
+    /** Unchanged content reuses the current version instead of appending an empty one. */
+    unchanged: boolean;
+    path: string;
+}
+export interface ArticleDocument {
+    id: string;
+    title: string;
+    sessionId: string;
+    version: number;
+    versions: readonly ArticleVersionInfo[];
+    offset: number;
+    length: number;
+    text: string;
+}
+export declare class ArticleStore {
+    #private;
+    constructor(root: string, clock?: () => Date, idFactory?: () => string);
+    get root(): string;
+    ready(): Promise<void>;
+    create(input: {
+        sessionId: string;
+        title: string;
+        content: string;
+    }): Promise<ArticleCommit>;
+    update(input: {
+        sessionId: string;
+        id: string;
+        title?: string;
+        content?: string;
+        edits?: readonly ArticleEdit[];
+    }): Promise<ArticleCommit>;
+    read(input: {
+        sessionId: string;
+        id: string;
+        version?: number;
+        offset?: number;
+        limit: number;
+    }): Promise<ArticleDocument | undefined>;
+    /** Absolute path of one immutable version file, after it has been checked to stay inside the store. */
+    versionPath(id: string, version: number): Promise<string>;
+    readVersion(id: string, version?: number): Promise<{
+        title: string;
+        version: number;
+        content: string;
+    } | undefined>;
+    list(sessionId: string): Promise<ArticleSummary[]>;
+}
+export declare function cleanTitle(title: string): string;
+//# sourceMappingURL=store.d.ts.map

package/dist/articles/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/articles/store.ts"],"names":[],"mappings":"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"}