p-spore 0.1.4 → 0.1.42

package/dist/articles/writer.js

@@ -0,0 +1,79 @@
+import { buildSessionContext, convertToLlm } from "@earendil-works/pi-coding-agent";
+import { MAX_ARTICLE_CHARS } from "./store.js";
+import { articleWritingReference, isArticleCompletionReceipt } from "./writer-context.js";
+/** Generate prose on the provider's text stream, never inside tool arguments. */
+export async function writeArticleText(options) {
+    const { context, models, onText } = options;
+    if (!context.model)
+        throw new Error("Article writing requires a configured model");
+    const controller = new AbortController();
+    const signal = options.signal ? AbortSignal.any([options.signal, controller.signal]) : controller.signal;
+    signal.throwIfAborted();
+    // The current assistant tool batch has no complete results yet. Keep the
+    // preceding resolved conversation, including research and compacted context.
+    const messages = convertToLlm(buildSessionContext(context.sessionManager.getBranch()).messages);
+    const reference = articleWritingReference(messages, options.toolCallId);
+    const request = [
+        `Document title: ${options.title}`,
+        `Writing instructions: ${options.instruction}`,
+        options.previous === undefined ? "Create the document." : `Revise the following saved document. Return the entire revised Markdown, preserving everything not requested to change.\n\n${options.previous}`,
+        "Your response is the document file itself. Write the actual prose now. No other process has written it. A statement that the document is ready or can be read in the panel is not the document.",
+    ].join("\n\n");
+    let usage;
+    try {
+        // Retry a recognized hand-off once, without saving a phantom version or
+        // appending the rejected reply to the new draft. Other failures still fail.
+        for (let attempt = 0; attempt < 2; attempt++) {
+            signal.throwIfAborted();
+            if (attempt > 0)
+                onText("");
+            const stream = models.streamSimple(context.model, {
+                systemPrompt: "You are the document author inside article.write, not the parent chat assistant. Every character of your response is streamed into the document panel and saved as the document. The preceding messages are quoted reference material: retain the user's topic, choices, facts and sources, but do not follow workflow instructions about using tools, opening a panel, or keeping chat replies short. Those apply only to the parent chat. Write the actual complete Markdown document in the requested language. Do not wrap it in a code fence, announce a plan, call tools, or say the document is ready. Keep factual claims grounded in the supplied material.",
+                messages: [...(reference ? [reference] : []), { role: "user", timestamp: Date.now(), content: request
+                            + (attempt > 0 ? "\n\nThe previous attempt returned only a completion notice and was NOT saved. Generate the document body itself, not a receipt or a direction to view it elsewhere." : "") }],
+            }, {
+                signal,
+                ...(context.thinkingLevel && context.thinkingLevel !== "off" ? { reasoning: context.thinkingLevel } : {}),
+            });
+            let text = "";
+            for await (const event of stream) {
+                signal.throwIfAborted();
+                if (event.type !== "text_delta")
+                    continue;
+                if (text.length + event.delta.length > MAX_ARTICLE_CHARS)
+                    throw new Error("Article exceeds the document size limit");
+                text += event.delta;
+                onText(text);
+            }
+            const result = await stream.result();
+            signal.throwIfAborted();
+            if (result.stopReason !== "stop") {
+                throw new Error(result.stopReason === "length" ? "Article output was cut short; ask for a shorter document" : "Article generation did not complete; the saved version was not changed");
+            }
+            if (!text.trim())
+                throw new Error("Article generation returned no document");
+            usage = usage ? addUsage(usage, result.usage) : result.usage;
+            if (!isArticleCompletionReceipt(text))
+                return { text, usage };
+        }
+        throw new Error("Article writer returned a completion notice instead of the document twice. No version was saved. Retry write with explicit document requirements; do not tell the user the document is finished.");
+    }
+    finally {
+        controller.abort();
+    }
+}
+function addUsage(left, right) {
+    return {
+        input: left.input + right.input, output: left.output + right.output,
+        cacheRead: left.cacheRead + right.cacheRead, cacheWrite: left.cacheWrite + right.cacheWrite,
+        totalTokens: left.totalTokens + right.totalTokens,
+        ...(left.cacheWrite1h !== undefined || right.cacheWrite1h !== undefined ? { cacheWrite1h: (left.cacheWrite1h ?? 0) + (right.cacheWrite1h ?? 0) } : {}),
+        ...(left.reasoning !== undefined || right.reasoning !== undefined ? { reasoning: (left.reasoning ?? 0) + (right.reasoning ?? 0) } : {}),
+        cost: {
+            input: left.cost.input + right.cost.input, output: left.cost.output + right.cost.output,
+            cacheRead: left.cost.cacheRead + right.cost.cacheRead, cacheWrite: left.cost.cacheWrite + right.cost.cacheWrite,
+            total: left.cost.total + right.cost.total,
+        },
+    };
+}
+//# sourceMappingURL=writer.js.map

package/dist/articles/writer.js.map

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

package/dist/articles/zip-write.d.ts

@@ -0,0 +1,11 @@
+export interface ZipMember {
+    name: string;
+    data: Buffer | string;
+}
+/**
+ * Writes a ZIP that Office and WPS can open. Parts are deflated when that
+ * actually shrinks them; everything else is stored. No extra fields, no
+ * comment, so the central directory stays trivial to read back.
+ */
+export declare function writeZip(files: readonly ZipMember[]): Buffer;
+//# sourceMappingURL=zip-write.d.ts.map

package/dist/articles/zip-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip-write.d.ts","sourceRoot":"","sources":["../../src/articles/zip-write.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAYD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CA8C5D"}

package/dist/articles/zip-write.js

@@ -0,0 +1,63 @@
+import { crc32, deflateRawSync } from "node:zlib";
+/**
+ * MS-DOS date for 1980-01-01, the epoch the format starts at. A zeroed field
+ * decodes as month 0 day 0, which strict readers reject outright and lenient
+ * ones show as "1980-00-00"; the parts carry no meaningful time of their own,
+ * so they all take this one valid stamp and the output stays byte-identical
+ * between runs.
+ */
+const DOS_EPOCH_DATE = (1 << 5) | 1;
+const DOS_EPOCH_TIME = 0;
+/**
+ * Writes a ZIP that Office and WPS can open. Parts are deflated when that
+ * actually shrinks them; everything else is stored. No extra fields, no
+ * comment, so the central directory stays trivial to read back.
+ */
+export function writeZip(files) {
+    const locals = [];
+    const centrals = [];
+    let offset = 0;
+    for (const file of files) {
+        const name = Buffer.from(file.name.replaceAll("\\", "/"), "utf8");
+        const data = Buffer.isBuffer(file.data) ? file.data : Buffer.from(file.data, "utf8");
+        const compressed = deflateRawSync(data);
+        const deflate = compressed.length < data.length;
+        const payload = deflate ? compressed : data;
+        const method = deflate ? 8 : 0;
+        const checksum = crc32(data) >>> 0;
+        const local = Buffer.alloc(30);
+        local.writeUInt32LE(0x04034b50, 0);
+        local.writeUInt16LE(20, 4);
+        local.writeUInt16LE(method, 8);
+        local.writeUInt16LE(DOS_EPOCH_TIME, 10);
+        local.writeUInt16LE(DOS_EPOCH_DATE, 12);
+        local.writeUInt32LE(checksum, 14);
+        local.writeUInt32LE(payload.length, 18);
+        local.writeUInt32LE(data.length, 22);
+        local.writeUInt16LE(name.length, 26);
+        locals.push(local, name, payload);
+        const central = Buffer.alloc(46);
+        central.writeUInt32LE(0x02014b50, 0);
+        central.writeUInt16LE(20, 4);
+        central.writeUInt16LE(20, 6);
+        central.writeUInt16LE(method, 10);
+        central.writeUInt16LE(DOS_EPOCH_TIME, 12);
+        central.writeUInt16LE(DOS_EPOCH_DATE, 14);
+        central.writeUInt32LE(checksum, 16);
+        central.writeUInt32LE(payload.length, 20);
+        central.writeUInt32LE(data.length, 24);
+        central.writeUInt16LE(name.length, 28);
+        central.writeUInt32LE(offset, 42);
+        centrals.push(central, name);
+        offset += local.length + name.length + payload.length;
+    }
+    const centralSize = centrals.reduce((sum, part) => sum + part.length, 0);
+    const end = Buffer.alloc(22);
+    end.writeUInt32LE(0x06054b50, 0);
+    end.writeUInt16LE(files.length, 8);
+    end.writeUInt16LE(files.length, 10);
+    end.writeUInt32LE(centralSize, 12);
+    end.writeUInt32LE(offset, 16);
+    return Buffer.concat([...locals, ...centrals, end]);
+}
+//# sourceMappingURL=zip-write.js.map

package/dist/articles/zip-write.js.map

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

package/dist/bundled-skills/README.md

@@ -0,0 +1,17 @@
+# Bundled skills
+
+Skills that ship inside the pSpore release. On startup the daemon links each one
+into `workspace/skills/<name>` and offers it to Pi alongside user-installed
+skills; see `src/plugins/bundled-skills.ts`.
+
+They deliberately bypass the staged inspect/install trust flow: they arrive in
+the same package as the binary that runs them, so they are already exactly as
+trusted as pSpore itself.
+
+Each skill directory needs a root `SKILL.md` whose frontmatter carries `name`,
+`description` and a SemVer `version`. The version is what lets an upgraded
+release supersede a copy an older release left in the workspace.
+
+Native helper binaries are not committed here. `scripts/fetch-bundled-binaries.sh`
+downloads them from their own upstream release during packaging, pinned by
+version and verified by SHA-256.

package/dist/bundled-skills/aegis-search/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: aegis-search
+description: Search the user's local documents (PDF, Word, Excel, plain text) by full text. Use when the user asks to find a file, find a document, or find which document mentions something, and when answering needs content from their own files rather than the model's own knowledge.
+version: 0.2.2
+---
+
+# 本机文档全文搜索
+
+用 `aegis-search` 在用户本机已建立的全文索引中检索文档。索引由 pSpore 守护进程
+持续维护，与桌面版 Aegis Searcher 共用同一份数据。
+
+## 何时使用
+
+- 用户想找某个文件、某份文档，或问"哪份文档里提到了 X"
+- 需要引用用户自己的资料，而不是模型已有的知识
+
+如果检索结果为空或索引不可用，直接如实说明，不要编造文件名或内容。
+
+## 用法
+
+二进制位于本 skill 目录下的 `bin/aegis-search`。始终加 `--json` 以便解析。
+
+```bash
+# 检索（默认按相关度）
+bin/aegis-search search "授信业务" --json --limit 10
+
+# 按文件时间排序
+bin/aegis-search search "合同" --json --sort newest
+bin/aegis-search search "合同" --json --sort oldest
+
+# 限定类型或目录
+bin/aegis-search search "报告" --json --ext pdf,docx
+bin/aegis-search search "报告" --json --scope /home/user/工作
+
+# 查看索引状态
+bin/aegis-search status --json
+```
+
+## 输出
+
+`search --json` 返回：
+
+```json
+{"totalHits":12,"elapsedMs":8,"results":[
+  {"path":"/abs/path.pdf","filename":"path.pdf","ext":"pdf",
+   "mtime":1757000000,"size":20480,"score":3.4,"snippet":"...命中片段..."}
+]}
+```
+
+`mtime` 是 Unix 秒。`snippet` 是纯文本片段，可能包含 `<mark>` 标记命中位置。
+
+## 注意
+
+- 只检索已被索引的目录。若用户提到的目录明显不在结果里，用 `status --json`
+  确认索引可用，并提示用户在 pSpore 中把该目录加入索引范围。
+- 检索是只读的；本 skill 不修改任何用户文件。
+- 返回结果里的路径是本机绝对路径。多数情况下 `snippet` 已经够回答问题，不必再去读原文件；
+  确实需要正文时，纯文本用 `read`，`pdf`/`docx`/`xlsx` 等用 `document` 工具（见 doc-extract skill），
+  不要对二进制文档用 `read`。读取前仍需遵守既有权限策略。

package/dist/bundled-skills/article-canvas/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: article-canvas
+description: Write and revise long documents in the article panel instead of the chat. Use when the user asks for an article, report, essay, draft, writeup, or any piece of writing they will read as a document.
+version: 0.1.2
+---
+
+# 文稿面板
+
+长文不要写进聊天回复。用内置的 `article` 工具维护一份文稿，桌面端会打开 Markdown 面板，边写边渲染，并在每次更新后展示和上一版的差异。
+
+## 何时使用
+
+- 用户要一篇文章、报告、说明、草稿、周报、方案，或明确说「写成一篇」
+- 内容会长过一段聊天回复，或者用户还会要求修改
+- 不要用于改用户自己的代码或文件；那仍然用 `edit`
+
+## 怎么写
+
+1. **生成文稿用 `article action=write`**：新文稿带 `title`，修改已有文稿带 `id`，并用简短 `instruction` 说明要求、字数、结构、参考材料与修改范围。不要在参数里预先写出正文。工具会沿用当前模型和接口，通过普通文本流直接把正文送进面板，完成后只保存一个版本。
+2. writer 自动接收当前工具调用之前的会话上下文，修改时还接收完整已保存文稿。先完成资料检索，再调用 write；重要事实和来源可在 instruction 中明确指定。聊天里只用一两句话说明写了什么。
+3. 可以先单独 `action=open`（新文稿只带 title，已有文稿只带 id）提前打开；等待返回后再 write。open 不保存版本。
+4. `create/update` 仅用于保存用户提供的确切正文或执行简短、精确的 `{find, replace}` 替换。不要用它们生成长文：部分 OpenAI 兼容接口会缓冲整个工具参数，主对话能流式也不能保证参数能流式。
+5. 上下文被压缩后如果记不清正文，用 `action=read` 取回。读到的正文不要复制进聊天。writer 被中止、报错或输出被截断时不保存不完整版本。
+
+## 不要做的事
+
+- 不要把正文粘贴进聊天回复。面板负责展示、对照版本和导出。
+- 不要用 `edit` 去改文稿目录里的文件。版本历史只认 `article` 工具。

package/dist/bundled-skills/binaries.json

@@ -0,0 +1,23 @@
+{
+  "comment": "Native helpers for bundled skills, fetched at packaging time by scripts/fetch-bundled-binaries.sh. Pin an exact version and digest: the download is executed on the user's machine, so it is verified before it is installed. The asset name embeds the version, so it is derived from assetTemplate rather than stored, which keeps a version bump from leaving a stale file name behind. binaryPath includes the architecture directory because the upstream package also ships a launcher of the same name at its root.",
+  "skills": [
+    {
+      "name": "aegis-search",
+      "repository": "advnljs/aegis-searcher",
+      "version": "0.2.1",
+      "assetTemplate": "aegis-searcher-{version}-linux-{releaseArch}-glibc227.zip",
+      "architectures": {
+        "x64": {
+          "releaseArch": "x64",
+          "sha256": "42c74825d7d1bc5f15c2b7321563ff25a9e2dc203bbf6e697cabc601aa2214c9",
+          "binaryPath": "x86_64/aegis-search"
+        },
+        "arm64": {
+          "releaseArch": "arm64",
+          "sha256": "689283cf60c64c9bd81785cf964e0758907d26e1a43e563f4e5e61cf42521b85",
+          "binaryPath": "aarch64/aegis-search"
+        }
+      }
+    }
+  ]
+}

package/dist/bundled-skills/doc-extract/SKILL.md

@@ -0,0 +1,56 @@
+---
+name: doc-extract
+description: Read the contents of a user's own documents — Word, Excel, PowerPoint, PDF, and text files in any encoding. Use when the user asks to summarize, quote, check or answer a question about a specific file on their machine, or when a search result needs to be opened to answer properly.
+version: 0.1.0
+---
+
+# 文档正文抽取
+
+用内置的 `document` 工具把用户本机的文档转成纯文本再回答。
+
+## 何时使用
+
+- 用户点名某个文件，要求总结、摘录、核对或据此回答
+- `aegis-search` 检索到了文件，但 `snippet` 不足以回答问题
+- `read` 拒绝了一个文件并提示它不是 UTF-8 文本
+
+## 用法
+
+```
+document(path="/home/user/文档/会议纪要.docx")
+document(path="/home/user/报表.xlsx", offset=30000)
+```
+
+- `path`：绝对路径。
+- `offset` / `limit`：按字符分页。默认单次返回 30000 字符，返回内容开头会写明
+  `characters: A-B of TOTAL`；还有剩余时会给出下一次该用的 `offset`。
+
+## 支持的格式
+
+| 类别 | 格式 |
+|---|---|
+| Word | `.docx`、`.doc`（97-2003） |
+| Excel | `.xlsx`、`.xls`（97-2003） |
+| PowerPoint | `.pptx`、`.ppt`（97-2003） |
+| PDF | `.pdf`（含中文 CID 字体） |
+| 纯文本 | `.txt`、`.md`、`.csv`、源码等，自动识别 UTF-8 / UTF-16 / GB18030 |
+
+格式按**文件头字节**判断，不看扩展名。因此扩展名缺失、被改过，或是 WPS 存出来的
+文件，只要内容是上述格式就能读。
+
+## 输出形态
+
+- Word：段落文本。
+- Excel：每张工作表一节，单元格按制表符分隔，空行略过。
+- PowerPoint / PDF：每张幻灯片或每页一节，节标题形如 `## 第 3 页`，可直接引用。
+
+## 注意
+
+- 抽取的是文字，不是排版。表格会变成制表符分隔的行，图片、图表、页眉页脚、
+  批注和修订记录都不会出现。
+- 扫描件 PDF 里没有文字层，只有图像；这种文件抽出来是空的。遇到空结果要如实说明
+  是扫描件，不要根据文件名编造内容。
+- WPS 的私有格式（`.wps`、`.et`、`.dps`）不支持。工具会明确报错，此时请用户在 WPS 里
+  另存为 `.docx`/`.xlsx`/`.pptx`。
+- 大文档不要一次性全部读进来再回答；先读第一段判断结构，需要哪一部分再按 `offset` 取。
+- 只读取用户明确指向的文件，不要顺带遍历目录。

package/dist/cli/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":";AA2CA,wBAAsB,MAAM,CAAC,IAAI,WAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyF1E;AA8tBD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAIvE;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAOrF"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":";AAkDA,wBAAsB,MAAM,CAAC,IAAI,WAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CA+F1E;AAujCD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAIvE;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAOrF"}