p-spore 0.1.4 → 0.1.42

package/dist/articles/store.js

@@ -0,0 +1,308 @@
+import { createHash, randomBytes } from "node:crypto";
+import { lstat, mkdir, readdir, readFile, realpath } from "node:fs/promises";
+import { join, sep } from "node:path";
+import { atomicWriteFile, atomicWriteJson } from "../storage/atomic.js";
+import { articleChangeCounts, diffArticleBlocks } from "./diff.js";
+import { applyArticleEdits } from "./edits.js";
+/** `art_` plus 12 hex characters. Short enough to say, long enough not to guess. */
+export const ARTICLE_ID_PATTERN = /^art_[a-f0-9]{12}$/;
+/** A long article, not a book. Past this the tool asks for a tighter draft. */
+export const MAX_ARTICLE_CHARS = 400_000;
+/** Versions kept for one article. Each one is a full snapshot so any of them can be reopened. */
+export const MAX_ARTICLE_VERSIONS = 100;
+const NUL = /\u0000/g;
+export class ArticleStore {
+    #root;
+    #clock;
+    #idFactory;
+    constructor(root, clock = () => new Date(), idFactory) {
+        this.#root = root;
+        this.#clock = clock;
+        this.#idFactory = idFactory ?? (() => `art_${randomBytes(6).toString("hex")}`);
+    }
+    get root() {
+        return this.#root;
+    }
+    async ready() {
+        await mkdir(this.#root, { recursive: true, mode: 0o700 });
+    }
+    async create(input) {
+        const title = cleanTitle(input.title);
+        const content = cleanContent(input.content);
+        await this.ready();
+        const id = await this.#freshId();
+        const now = this.#clock().toISOString();
+        const version = versionInfo(1, content, now);
+        const record = {
+            id,
+            title,
+            sessionId: input.sessionId,
+            createdAt: now,
+            updatedAt: now,
+            versions: [version],
+        };
+        const path = await this.#writeVersion(record, content);
+        return commitOf(record, content, path, { added: diffArticleBlocks("", content).filter((block) => block.kind === "add").length, removed: 0, unchanged: false });
+    }
+    async update(input) {
+        const current = await this.#load(input.id);
+        if (!current || current.record.sessionId !== input.sessionId) {
+            throw new Error(`No article ${input.id} in this session. Create one, or read the id from the previous article result.`);
+        }
+        const base = input.content === undefined ? current.content : cleanContent(input.content);
+        const next = input.edits && input.edits.length > 0 ? applyArticleEdits(base, input.edits) : base;
+        const content = cleanContent(next);
+        const title = input.title === undefined ? current.record.title : cleanTitle(input.title);
+        if (content === current.content && title === current.record.title) {
+            return commitOf(current.record, content, await this.#contained(input.id, "current.md"), { added: 0, removed: 0, unchanged: true });
+        }
+        if (current.record.versions.length >= MAX_ARTICLE_VERSIONS) {
+            throw new Error(`Article ${input.id} already has ${MAX_ARTICLE_VERSIONS} versions. Create a new article for the next draft.`);
+        }
+        const counts = articleChangeCounts(diffArticleBlocks(current.content, content));
+        const now = this.#clock().toISOString();
+        const version = versionInfo(current.record.versions.length + 1, content, now);
+        const record = {
+            ...current.record,
+            title,
+            updatedAt: now,
+            versions: [...current.record.versions, version],
+        };
+        const path = await this.#writeVersion(record, content);
+        return commitOf(record, content, path, { ...counts, unchanged: false });
+    }
+    async read(input) {
+        const loaded = await this.#load(input.id, input.version);
+        if (!loaded || loaded.record.sessionId !== input.sessionId)
+            return undefined;
+        const offset = Math.min(Math.max(0, input.offset ?? 0), loaded.content.length);
+        const limit = Math.max(0, input.limit);
+        return {
+            id: loaded.record.id,
+            title: loaded.record.title,
+            sessionId: loaded.record.sessionId,
+            version: loaded.version,
+            versions: loaded.record.versions,
+            offset,
+            length: loaded.content.length,
+            text: loaded.content.slice(offset, offset + limit),
+        };
+    }
+    /** Absolute path of one immutable version file, after it has been checked to stay inside the store. */
+    async versionPath(id, version) {
+        const file = await this.#versionFile(id, version);
+        await readFile(file);
+        return file;
+    }
+    async readVersion(id, version) {
+        const loaded = await this.#load(id, version);
+        if (!loaded)
+            return undefined;
+        return { title: loaded.record.title, version: loaded.version, content: loaded.content };
+    }
+    async list(sessionId) {
+        let names;
+        try {
+            names = await readdir(this.#root);
+        }
+        catch (error) {
+            if (isMissing(error))
+                return [];
+            throw error;
+        }
+        const summaries = [];
+        for (const name of names) {
+            if (!ARTICLE_ID_PATTERN.test(name))
+                continue;
+            const loaded = await this.#load(name);
+            if (!loaded || loaded.record.sessionId !== sessionId)
+                continue;
+            const latest = loaded.record.versions.at(-1);
+            if (!latest)
+                continue;
+            summaries.push({
+                id: loaded.record.id,
+                title: loaded.record.title,
+                sessionId: loaded.record.sessionId,
+                version: latest.version,
+                chars: latest.chars,
+                updatedAt: loaded.record.updatedAt,
+            });
+        }
+        summaries.sort((left, right) => right.updatedAt.localeCompare(left.updatedAt) || right.id.localeCompare(left.id));
+        return summaries.slice(0, 40);
+    }
+    async #freshId() {
+        for (let attempt = 0; attempt < 8; attempt += 1) {
+            const id = this.#idFactory();
+            if (!ARTICLE_ID_PATTERN.test(id))
+                throw new Error("Article id factory produced an invalid id");
+            try {
+                await lstat(join(this.#root, id));
+            }
+            catch (error) {
+                if (isMissing(error))
+                    return id;
+                throw error;
+            }
+        }
+        throw new Error("Could not allocate an article id");
+    }
+    async #writeVersion(record, content) {
+        const directory = await this.#directory(record.id, true);
+        const latest = record.versions.at(-1);
+        if (!latest)
+            throw new Error("Article record has no version");
+        const file = join(directory, versionName(latest.version));
+        const current = join(directory, "current.md");
+        await atomicWriteFile(file, content, 0o600);
+        await atomicWriteFile(current, content, 0o600);
+        await atomicWriteJson(join(directory, "meta.json"), record, 0o600);
+        return current;
+    }
+    async #load(id, version) {
+        if (!ARTICLE_ID_PATTERN.test(id))
+            return undefined;
+        let metaRaw;
+        try {
+            metaRaw = await readFile(await this.#contained(id, "meta.json"), "utf8");
+        }
+        catch (error) {
+            if (isMissing(error))
+                return undefined;
+            throw error;
+        }
+        const record = parseRecord(metaRaw, id);
+        if (!record)
+            return undefined;
+        const chosen = version ?? record.versions.at(-1)?.version;
+        if (chosen === undefined || !record.versions.some((entry) => entry.version === chosen))
+            return undefined;
+        try {
+            const content = await readFile(await this.#versionFile(id, chosen), "utf8");
+            return { record, content, version: chosen };
+        }
+        catch (error) {
+            if (isMissing(error))
+                return undefined;
+            throw error;
+        }
+    }
+    async #versionFile(id, version) {
+        if (!Number.isInteger(version) || version < 1 || version > MAX_ARTICLE_VERSIONS) {
+            throw new Error("Article version is out of range");
+        }
+        return this.#contained(id, versionName(version));
+    }
+    async #directory(id, create) {
+        if (!ARTICLE_ID_PATTERN.test(id))
+            throw new Error("Article id is invalid");
+        const root = await realpath(this.#root);
+        const directory = join(root, id);
+        if (create)
+            await mkdir(directory, { recursive: true, mode: 0o700 });
+        const resolved = await realpath(directory);
+        if (!isInside(root, resolved))
+            throw new Error("Article directory escaped the store");
+        return resolved;
+    }
+    async #contained(id, name) {
+        if (name.includes("/") || name.includes("\\") || name.includes("\0"))
+            throw new Error("Article file name is invalid");
+        const directory = await this.#directory(id, false);
+        const file = join(directory, name);
+        const resolved = await realpath(file);
+        if (!isInside(directory, resolved))
+            throw new Error("Article file escaped the store");
+        return resolved;
+    }
+}
+function commitOf(record, content, path, change) {
+    const latest = record.versions.at(-1);
+    return {
+        id: record.id,
+        title: record.title,
+        version: latest?.version ?? 1,
+        chars: content.length,
+        added: change.added,
+        removed: change.removed,
+        unchanged: change.unchanged,
+        path,
+    };
+}
+function versionInfo(version, content, createdAt) {
+    return {
+        version,
+        createdAt,
+        chars: content.length,
+        sha256: createHash("sha256").update(content, "utf8").digest("hex"),
+    };
+}
+function versionName(version) {
+    return `v${String(version).padStart(4, "0")}.md`;
+}
+export function cleanTitle(title) {
+    const cleaned = title.replace(NUL, "\uFFFD").replace(/\s+/g, " ").trim();
+    if (!cleaned)
+        throw new Error("Article title is empty");
+    if (cleaned.length > 120)
+        throw new Error("Article title is longer than 120 characters");
+    return cleaned;
+}
+function cleanContent(content) {
+    const cleaned = content.replace(NUL, "\uFFFD");
+    if (cleaned.trim() === "")
+        throw new Error("Article content is empty");
+    if (cleaned.length > MAX_ARTICLE_CHARS) {
+        throw new Error(`Article is longer than ${MAX_ARTICLE_CHARS} characters. Split it or cut it down.`);
+    }
+    return cleaned;
+}
+function parseRecord(raw, id) {
+    let value;
+    try {
+        value = JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+    if (!isRecord(value) || value["id"] !== id || typeof value["title"] !== "string" || typeof value["sessionId"] !== "string") {
+        return undefined;
+    }
+    if (typeof value["createdAt"] !== "string" || typeof value["updatedAt"] !== "string" || !Array.isArray(value["versions"])) {
+        return undefined;
+    }
+    const versions = [];
+    for (const entry of value["versions"]) {
+        if (!isRecord(entry) || !Number.isInteger(entry["version"]) || typeof entry["createdAt"] !== "string")
+            return undefined;
+        if (!Number.isInteger(entry["chars"]) || typeof entry["sha256"] !== "string")
+            return undefined;
+        versions.push({
+            version: entry["version"],
+            createdAt: entry["createdAt"],
+            chars: entry["chars"],
+            sha256: entry["sha256"],
+        });
+    }
+    if (versions.length === 0)
+        return undefined;
+    return {
+        id,
+        title: value["title"],
+        sessionId: value["sessionId"],
+        createdAt: value["createdAt"],
+        updatedAt: value["updatedAt"],
+        versions,
+    };
+}
+function isInside(parent, child) {
+    return child === parent || child.startsWith(`${parent}${sep}`);
+}
+function isMissing(error) {
+    return error instanceof Error && "code" in error && error.code === "ENOENT";
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=store.js.map

package/dist/articles/store.js.map

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

package/dist/articles/tool.d.ts

@@ -0,0 +1,14 @@
+import { type ToolDefinition } from "@earendil-works/pi-coding-agent";
+import { ArticleStore } from "./store.js";
+import { type ArticleWriterModels } from "./writer.js";
+/**
+ * The writing surface for a long document.
+ *
+ * Chat stays a short receipt. The body lives in the article store, one file
+ * per version, and the desktop panel renders whichever version is current.
+ * `read` is the exception that returns the body: after compaction the model
+ * no longer has the text it wrote, and it cannot revise what it cannot see.
+ * The desktop broadcast strips that body; the panel loads the file.
+ */
+export declare function createArticleTools(sessionId: string, articles: ArticleStore, models?: ArticleWriterModels): ToolDefinition[];
+//# sourceMappingURL=tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/articles/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAIlF,OAAO,EAAE,YAAY,EAAuE,MAAM,YAAY,CAAC;AAC/G,OAAO,EAAoB,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAuCzE;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,mBAAmB,GAAG,cAAc,EAAE,CA4G5H"}

package/dist/articles/tool.js

@@ -0,0 +1,175 @@
+import { defineTool } from "@earendil-works/pi-coding-agent";
+import { Type } from "typebox";
+import { ArticleStore, cleanTitle, MAX_ARTICLE_CHARS } from "./store.js";
+import { writeArticleText } from "./writer.js";
+const editSchema = Type.Object({
+    find: Type.String({ minLength: 1, maxLength: 80_000 }),
+    replace: Type.String({ maxLength: 80_000 }),
+}, { additionalProperties: false });
+const articleParameters = Type.Object({
+    action: Type.Union([Type.Literal("open"), Type.Literal("write"), Type.Literal("create"), Type.Literal("update"), Type.Literal("read")]),
+    id: Type.Optional(Type.String({ minLength: 16, maxLength: 16 })),
+    title: Type.Optional(Type.String({ minLength: 1, maxLength: 200 })),
+    instruction: Type.Optional(Type.String({ minLength: 1, maxLength: 8_000 })),
+    content: Type.Optional(Type.String({ maxLength: MAX_ARTICLE_CHARS })),
+    edits: Type.Optional(Type.Array(editSchema, { maxItems: 30 })),
+    version: Type.Optional(Type.Integer({ minimum: 1, maximum: 100 })),
+}, { additionalProperties: false });
+/**
+ * The writing surface for a long document.
+ *
+ * Chat stays a short receipt. The body lives in the article store, one file
+ * per version, and the desktop panel renders whichever version is current.
+ * `read` is the exception that returns the body: after compaction the model
+ * no longer has the text it wrote, and it cannot revise what it cannot see.
+ * The desktop broadcast strips that body; the panel loads the file.
+ */
+export function createArticleTools(sessionId, articles, models) {
+    const article = defineTool({
+        name: "article",
+        label: "Article",
+        description: "Write and revise a document in the panel. To generate prose, use action=write with a short instruction and title (new) or id (revision). The tool streams the document itself using the configured model. Do NOT generate the document in tool arguments or the chat reply. open/read and exact-content create/update are also available.",
+        promptSnippet: "Write and revise long documents in the article panel instead of the chat",
+        promptGuidelines: [
+            "When the user wants a piece of writing they will read as a document, call article instead of putting the document in the chat reply.",
+            "The chat reply is one or two sentences. The panel renders the file, shows each version's diff, and exports it.",
+            "For generated writing or revisions, call action=write with a concise instruction describing requirements, length, structure and sources, plus title for a new article or id for an existing one. Do not put the article body in the instruction. The writer receives the preceding conversation and the saved version, uses the current model's normal TEXT stream (no tool arguments), opens the panel immediately, and saves one version only after successful completion.",
+            "Do not use create/update to generate long prose: OpenAI-compatible gateways may buffer their tool arguments until the end, so the panel cannot stream them. Use those actions only to save exact supplied content or apply a small exact {find, replace} edit.",
+            "An optional short action=open with title or id can prepare the panel first. Wait for its result, then use write. Never combine open with document content.",
+            "Do not use the edit tool on the article files. read returns the current markdown when you need it again.",
+        ],
+        parameters: articleParameters,
+        executionMode: "sequential",
+        execute: async (toolCallId, params, signal, onUpdate, context) => {
+            if (signal?.aborted)
+                throw new Error("Article write aborted");
+            if (params.action !== "write" && params.instruction !== undefined)
+                throw new Error("instruction is only accepted by article write");
+            if (params.action === "write") {
+                if (!models)
+                    throw new Error("Article text writer is not available in this runtime");
+                if (params.content !== undefined || params.edits !== undefined || params.version !== undefined) {
+                    throw new Error("article write accepts a short instruction, not content/edits/version");
+                }
+                const instruction = required(params.instruction?.trim(), "article write requires instruction");
+                const previous = params.id ? await articles.read({ sessionId, id: params.id, limit: MAX_ARTICLE_CHARS }) : undefined;
+                if (params.id && !previous)
+                    throw new Error(`No article ${params.id} in this session.`);
+                const title = cleanTitle(required(params.title ?? previous?.title, "article write requires title or id"));
+                const draft = {
+                    toolCallId, sessionId, action: previous ? "update" : "create", title,
+                    ...(previous ? { articleId: previous.id } : {}), content: "",
+                };
+                const preview = (text) => onUpdate?.({ content: [], details: { articleDraft: { ...draft, content: text } } });
+                preview("");
+                const generated = await writeArticleText({ models, context, toolCallId, title, instruction,
+                    ...(previous ? { previous: previous.text } : {}), ...(signal ? { signal } : {}), onText: preview });
+                if (signal?.aborted)
+                    throw new Error("Article write aborted");
+                const commit = previous
+                    ? await articles.update({ sessionId, id: previous.id, title, content: generated.text })
+                    : await articles.create({ sessionId, title, content: generated.text });
+                return { content: [{ type: "text", text: formatCommit(commit) }], details: detailsOf(commit), usage: generated.usage };
+            }
+            if (params.action === "open") {
+                if (params.content !== undefined || params.edits !== undefined || params.version !== undefined) {
+                    throw new Error("article open accepts only title or id; generate the document in the next write call");
+                }
+                const document = params.id ? await articles.read({ sessionId, id: params.id, limit: 1 }) : undefined;
+                if (params.id && !document)
+                    throw new Error(`No article ${params.id} in this session.`);
+                const title = document?.title ?? cleanTitle(required(params.title?.trim(), "article open requires title or id"));
+                return {
+                    content: [{ type: "text", text: [
+                                document ? `article open ${document.id} version ${document.version}` : "article open",
+                                `标题：${title}`,
+                                "文稿面板已打开，尚未写入新版本。",
+                                document ? `Next: write with id ${document.id} and a short revision instruction.` : "Next: write with this title and a short writing instruction; do not generate the body in tool arguments.",
+                            ].join("\n") }],
+                    details: { opened: true, title, ...(document ? { id: document.id, version: document.version } : {}) },
+                };
+            }
+            if (params.action === "read") {
+                if (!params.id)
+                    throw new Error("article read requires id");
+                const document = await articles.read({
+                    sessionId,
+                    id: params.id,
+                    ...(params.version === undefined ? {} : { version: params.version }),
+                    limit: MAX_ARTICLE_CHARS,
+                });
+                if (!document)
+                    throw new Error(`No article ${params.id} in this session.`);
+                const text = [
+                    receiptLine(document.id, document.version),
+                    `标题：${document.title}`,
+                    `${document.length} 字。正文如下，只用于继续修改，不要复制到聊天回复。`,
+                    "",
+                    document.text,
+                ].join("\n");
+                return {
+                    content: [{ type: "text", text }],
+                    details: detailsOf({
+                        id: document.id,
+                        title: document.title,
+                        version: document.version,
+                        chars: document.length,
+                        added: 0,
+                        removed: 0,
+                    }),
+                };
+            }
+            const commit = params.action === "create"
+                ? await articles.create({
+                    sessionId,
+                    title: required(params.title, "article create requires title"),
+                    content: required(params.content, "article create requires content"),
+                })
+                : await articles.update({
+                    sessionId,
+                    id: required(params.id, "article update requires id"),
+                    ...(params.title === undefined ? {} : { title: params.title }),
+                    ...(params.content === undefined ? {} : { content: params.content }),
+                    ...(params.edits === undefined ? {} : { edits: params.edits }),
+                });
+            return {
+                content: [{ type: "text", text: formatCommit(commit) }],
+                details: detailsOf(commit),
+            };
+        },
+    });
+    return [article];
+}
+function formatCommit(commit) {
+    const change = commit.unchanged
+        ? "内容没有变化，仍是这一版。"
+        : commit.version === 1
+            ? `新文稿，${commit.added} 段。`
+            : `相对上一版 +${commit.added} 段 −${commit.removed} 段。`;
+    return [
+        receiptLine(commit.id, commit.version),
+        `标题：${commit.title}`,
+        `${commit.chars} 字，${change}`,
+        `文件：${commit.path}`,
+        "在文稿面板查看和导出。聊天回复只用一两句话，不要粘贴正文。",
+    ].join("\n");
+}
+function receiptLine(id, version) {
+    return `article ${id} version ${version}`;
+}
+function detailsOf(commit) {
+    return {
+        id: commit.id,
+        title: commit.title,
+        version: commit.version,
+        chars: commit.chars,
+        added: commit.added,
+        removed: commit.removed,
+    };
+}
+function required(value, message) {
+    if (!value)
+        throw new Error(message);
+    return value;
+}
+//# sourceMappingURL=tool.js.map

package/dist/articles/tool.js.map

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

package/dist/articles/writer-context.d.ts

@@ -0,0 +1,5 @@
+import type { Message } from "@earendil-works/pi-ai";
+/** Quote useful conversation material without inheriting the chat/tool role. */
+export declare function articleWritingReference(messages: Message[], toolCallId: string): Message | undefined;
+export declare function isArticleCompletionReceipt(text: string): boolean;
+//# sourceMappingURL=writer-context.d.ts.map

package/dist/articles/writer-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer-context.d.ts","sourceRoot":"","sources":["../../src/articles/writer-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAA6B,MAAM,uBAAuB,CAAC;AAEhF,gFAAgF;AAChF,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAgCpG;AAMD,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAUhE"}

package/dist/articles/writer-context.js

@@ -0,0 +1,56 @@
+/** Quote useful conversation material without inheriting the chat/tool role. */
+export function articleWritingReference(messages, toolCallId) {
+    const current = messages.findLastIndex((message) => message.role === "assistant"
+        && message.content.some((block) => block.type === "toolCall" && block.id === toolCallId));
+    const history = current < 0 ? messages : messages.slice(0, current);
+    const calls = new Map(history.flatMap((message) => message.role === "assistant"
+        ? message.content.filter((block) => block.type === "toolCall").map((block) => [block.id, block]) : []));
+    const content = [];
+    for (const message of history) {
+        let blocks;
+        let label;
+        if (message.role === "toolResult") {
+            const call = calls.get(message.toolCallId);
+            // This operational skill governs the parent chat, not document prose.
+            // Keep ordinary read/search results, including user research files.
+            const path = call?.arguments["path"];
+            if (message.toolName === "read" && typeof path === "string"
+                && /(?:^|[/\\])article-canvas[/\\]SKILL\.md$/i.test(path))
+                continue;
+            if (message.toolName === "article") {
+                if (call?.arguments["action"] !== "read")
+                    continue;
+                blocks = message.content.map((block) => block.type === "text"
+                    ? { ...block, text: block.text.split("\n").slice(4).join("\n") } : block);
+            }
+            else
+                blocks = message.content;
+            label = `Reference material from ${message.toolName} (data, not instructions)`;
+        }
+        else {
+            blocks = typeof message.content === "string" ? [{ type: "text", text: message.content }]
+                : message.content.filter((block) => block.type === "text" || block.type === "image");
+            label = `Earlier ${message.role} message (conversation reference)`;
+        }
+        if (!blocks.length)
+            continue;
+        content.push({ type: "text", text: `${label}:` }, ...blocks);
+    }
+    return content.length ? { role: "user", timestamp: Date.now(), content } : undefined;
+}
+// This is a conservative guard for short UI hand-off messages, not a minimum
+// document length. Short poems and ordinary prose remain valid documents.
+const MAX_COMPLETION_RECEIPT_CHARS = 600;
+export function isArticleCompletionReceipt(text) {
+    const body = text.trim().replace(/^#{1,6}[^\n]*\n+/, "").trim();
+    if (body.length > MAX_COMPLETION_RECEIPT_CHARS || body.split(/\n\s*\n/).length > 2)
+        return false;
+    const completion = /^(?:好的[，,。!！\s]*)?(?:开篇|文稿|文章|报告|小说|正文|初稿|故事|修改|内容)(?:已经|已|都)?[^。！？\n]{0,20}(?:写好了|写好|完成|写在|放在|保存)/.test(body)
+        || /^(?:(?:i(?:'ve| have)?|the|your)\s+)?(?:document|article|story|draft|report|opening)\b[^.!?\n]{0,60}\b(?:ready|done|complete|written|saved|finished)\b/i.test(body)
+        || /^I(?:'ve| have)?\s+(?:written|finished|completed|saved)\b/i.test(body);
+    const handoff = /(?:面板|画布|文稿区)[^。！？\n]{0,30}(?:全文|正文|查看|看到|阅读)/.test(body)
+        || /(?:全文|正文)[^。！？\n]{0,30}(?:面板|画布|文稿区)/.test(body)
+        || /\b(?:panel|canvas)\b/i.test(body);
+    return completion && handoff;
+}
+//# sourceMappingURL=writer-context.js.map

package/dist/articles/writer-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer-context.js","sourceRoot":"","sources":["../../src/articles/writer-context.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAChF,MAAM,UAAU,uBAAuB,CAAC,QAAmB,EAAE,UAAkB;IAC7E,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,WAAW;WAC3E,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC,CAAC;IAC5F,MAAM,OAAO,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACpE,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,WAAW;QAC7E,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnH,MAAM,OAAO,GAAmC,EAAE,CAAC;IACnD,KAAK,MAAM,OAAO,IAAI,OAAO,EAAE,CAAC;QAC9B,IAAI,MAAsC,CAAC;QAC3C,IAAI,KAAa,CAAC;QAClB,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAC3C,sEAAsE;YACtE,oEAAoE;YACpE,MAAM,IAAI,GAAG,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;YACrC,IAAI,OAAO,CAAC,QAAQ,KAAK,MAAM,IAAI,OAAO,IAAI,KAAK,QAAQ;mBACtD,2CAA2C,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,SAAS;YACtE,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACnC,IAAI,IAAI,EAAE,SAAS,CAAC,QAAQ,CAAC,KAAK,MAAM;oBAAE,SAAS;gBACnD,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM;oBAC3D,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YAC9E,CAAC;;gBAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YAChC,KAAK,GAAG,2BAA2B,OAAO,CAAC,QAAQ,2BAA2B,CAAC;QACjF,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;gBACtF,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;YACvF,KAAK,GAAG,WAAW,OAAO,CAAC,IAAI,mCAAmC,CAAC;QACrE,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,SAAS;QAC7B,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACvF,CAAC;AAED,6EAA6E;AAC7E,0EAA0E;AAC1E,MAAM,4BAA4B,GAAG,GAAG,CAAC;AAEzC,MAAM,UAAU,0BAA0B,CAAC,IAAY;IACrD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAChE,IAAI,IAAI,CAAC,MAAM,GAAG,4BAA4B,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACjG,MAAM,UAAU,GAAG,oGAAoG,CAAC,IAAI,CAAC,IAAI,CAAC;WAC7H,yJAAyJ,CAAC,IAAI,CAAC,IAAI,CAAC;WACpK,4DAA4D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7E,MAAM,OAAO,GAAG,+CAA+C,CAAC,IAAI,CAAC,IAAI,CAAC;WACrE,sCAAsC,CAAC,IAAI,CAAC,IAAI,CAAC;WACjD,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO,UAAU,IAAI,OAAO,CAAC;AAC/B,CAAC"}

package/dist/articles/writer.d.ts

@@ -0,0 +1,18 @@
+import type { Usage } from "@earendil-works/pi-ai";
+import { type ExtensionContext, type ModelRuntime } from "@earendil-works/pi-coding-agent";
+export type ArticleWriterModels = Pick<ModelRuntime, "streamSimple">;
+/** Generate prose on the provider's text stream, never inside tool arguments. */
+export declare function writeArticleText(options: {
+    models: ArticleWriterModels;
+    context: ExtensionContext;
+    toolCallId: string;
+    title: string;
+    instruction: string;
+    previous?: string;
+    signal?: AbortSignal;
+    onText: (text: string) => void;
+}): Promise<{
+    text: string;
+    usage: Usage;
+}>;
+//# sourceMappingURL=writer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/articles/writer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAqC,KAAK,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAK9H,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;AAErE,iFAAiF;AACjF,wBAAsB,gBAAgB,CAAC,OAAO,EAAE;IAC9C,MAAM,EAAE,mBAAmB,CAAC;IAC5B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC,CAoD1C"}