p-spore 0.1.3 → 0.1.42

package/dist/plugins/workspace-skills.js

@@ -0,0 +1,309 @@
+import { lstat, readdir, readFile, realpath, stat } from "node:fs/promises";
+import { basename, dirname, extname, join } from "node:path";
+import { parseFrontmatter } from "@earendil-works/pi-coding-agent";
+import { BUNDLED_MARKER } from "./bundled-skills.js";
+const SKILL_FILE = "SKILL.md";
+/** How far below a top-level entry `SKILL.md` is looked for, matching real-world nesting like `suite/tool/SKILL.md`. */
+const MAX_DEPTH = 3;
+const MAX_SKILLS = 128;
+const MAX_SKILL_BYTES = 256 * 1024;
+/** Pi warns above this; the whole catalog sits in every system prompt, so it is a hard cap here. */
+const MAX_DESCRIPTION_CHARS = 1_024;
+/** A description guessed from the body only has to say what the skill is for. */
+const MAX_DERIVED_DESCRIPTION_CHARS = 280;
+export async function scanWorkspaceSkills(root, options = {}) {
+    const managed = options.managedNames ?? new Set();
+    const reserved = options.reservedNames ?? new Map();
+    const entries = await listDirectory(root);
+    if (!entries)
+        return { skills: [], catalog: [] };
+    const candidates = [];
+    const catalog = [];
+    const visited = new Set();
+    for (const name of entries) {
+        if (name.startsWith(".") || name === "node_modules" || managed.has(name))
+            continue;
+        const path = join(root, name);
+        const kind = await entryKind(path);
+        if (kind === "broken") {
+            if (await lstat(path).then((stats) => stats.isSymbolicLink(), () => false)) {
+                catalog.push(skipped(name, path, "symbolic link target does not exist"));
+            }
+        }
+        else if (kind === "file") {
+            if (extname(name).toLowerCase() === ".md")
+                candidates.push({ file: path, fallbackName: basename(name, extname(name)), rootFile: true });
+        }
+        else if (kind === "directory") {
+            const real = await realpath(path).catch(() => path);
+            if (visited.has(real))
+                continue;
+            visited.add(real);
+            // A materialized copy an older release left behind belongs to pSpore, not the user.
+            if (await isFile(join(path, BUNDLED_MARKER)))
+                continue;
+            const found = await findSkillFiles(path, 0, visited);
+            if (found.length === 0) {
+                catalog.push(skipped(name, join(path, SKILL_FILE), await missingEntryPointMessage(path)));
+                continue;
+            }
+            for (const file of found)
+                candidates.push({ file, fallbackName: basename(dirname(file)), rootFile: false });
+        }
+    }
+    const skills = [];
+    const owners = new Map();
+    for (const candidate of candidates) {
+        if (skills.length >= MAX_SKILLS) {
+            catalog.push(skipped(candidate.fallbackName, candidate.file, `more than ${MAX_SKILLS} workspace skills; the rest are not loaded`));
+            continue;
+        }
+        const resolved = await resolveCandidate(candidate);
+        if (!resolved)
+            continue;
+        if (resolved.kind === "skipped") {
+            catalog.push(resolved.entry);
+            continue;
+        }
+        const { skill, notes } = resolved;
+        const reservedBy = reserved.get(skill.name);
+        const takenBy = owners.get(skill.name);
+        if (reservedBy || takenBy) {
+            catalog.push({
+                name: skill.name,
+                source: "workspace",
+                status: "shadowed",
+                path: skill.filePath,
+                description: skill.description,
+                message: reservedBy
+                    ? `the ${reservedBy} skill named ${skill.name} takes precedence; rename this one to load it`
+                    : `${takenBy} already uses the name ${skill.name}; rename this one to load it`,
+            });
+            continue;
+        }
+        owners.set(skill.name, skill.filePath);
+        skills.push(skill);
+        catalog.push({
+            name: skill.name,
+            source: "workspace",
+            status: "active",
+            path: skill.filePath,
+            description: skill.description,
+            ...(notes.length > 0 ? { message: notes.join("; ") } : {}),
+        });
+    }
+    catalog.sort((left, right) => left.name.localeCompare(right.name) || left.path.localeCompare(right.path));
+    return { skills, catalog };
+}
+async function resolveCandidate(candidate) {
+    const { file, fallbackName } = candidate;
+    // A stray root-level file that cannot be read as a skill is simply not one.
+    const unreadable = (message) => candidate.rootFile ? undefined : { kind: "skipped", entry: skipped(fallbackName, file, message) };
+    const size = await stat(file).then((stats) => stats.size, () => -1);
+    if (size < 0)
+        return unreadable("cannot be read");
+    if (size > MAX_SKILL_BYTES)
+        return unreadable(`is larger than ${MAX_SKILL_BYTES / 1024} KiB`);
+    let source;
+    try {
+        source = new TextDecoder("utf-8", { fatal: true }).decode(await readFile(file)).replace(/^/, "");
+    }
+    catch (error) {
+        return unreadable(error instanceof TypeError ? "is not UTF-8 text; save it as UTF-8" : "cannot be read");
+    }
+    const notes = [];
+    const { frontmatter, body, lenient } = readFrontmatter(source);
+    if (candidate.rootFile && typeof frontmatter["description"] !== "string")
+        return undefined;
+    if (lenient)
+        notes.push("frontmatter is not valid YAML, so it was read line by line");
+    const declaredName = typeof frontmatter["name"] === "string" ? frontmatter["name"].trim() : "";
+    const name = declaredName || fallbackName;
+    let description = typeof frontmatter["description"] === "string" ? collapse(frontmatter["description"]) : "";
+    if (!description) {
+        description = deriveSkillDescription(body);
+        if (!description) {
+            return {
+                kind: "skipped",
+                entry: skipped(name, file, "has no description in its frontmatter and no text to describe it with"),
+            };
+        }
+        notes.push("no description in the frontmatter, so its opening text is used");
+    }
+    if (description.length > MAX_DESCRIPTION_CHARS) {
+        description = `${description.slice(0, MAX_DESCRIPTION_CHARS - 1)}…`;
+        notes.push(`description shortened to ${MAX_DESCRIPTION_CHARS} characters`);
+    }
+    const invocation = frontmatter["disable-model-invocation"];
+    return {
+        kind: "skill",
+        skill: {
+            name,
+            description,
+            filePath: file,
+            baseDir: dirname(file),
+            disableModelInvocation: invocation === true || invocation === "true",
+        },
+        notes,
+    };
+}
+/**
+ * Pi's YAML reading first, so everything Pi accepts means the same here; a
+ * line-by-line `key: value` read when YAML rejects it, which recovers the
+ * common unquoted-colon mistake without guessing at anything more structured.
+ */
+function readFrontmatter(source) {
+    try {
+        const parsed = parseFrontmatter(source);
+        const frontmatter = isRecord(parsed.frontmatter) ? parsed.frontmatter : {};
+        return { frontmatter, body: parsed.body, lenient: false };
+    }
+    catch {
+        const normalized = source.replace(/\r\n?/g, "\n");
+        const end = normalized.indexOf("\n---", 3);
+        const block = normalized.slice(4, end);
+        const frontmatter = {};
+        for (const line of block.split("\n")) {
+            const match = /^([A-Za-z][\w-]*)\s*:\s*(.*)$/.exec(line);
+            if (!match?.[1])
+                continue;
+            let value = (match[2] ?? "").trim();
+            const quote = value[0];
+            if (value.length >= 2 && (quote === '"' || quote === "'") && value.endsWith(quote))
+                value = value.slice(1, -1);
+            if (value)
+                frontmatter[match[1]] = value;
+        }
+        return { frontmatter, body: normalized.slice(end + 4).trim(), lenient: true };
+    }
+}
+/**
+ * What a skill without a declared description is for, taken from its opening:
+ * the first heading and the first paragraph after it. Code, tables, quotes of
+ * markup and further headings are not descriptions and are passed over.
+ */
+export function deriveSkillDescription(body) {
+    let heading = "";
+    let text = "";
+    let lines = 0;
+    let fenced = false;
+    for (const raw of body.replace(/\r\n?/g, "\n").split("\n")) {
+        const line = raw.trim();
+        if (/^(```|~~~)/.test(line)) {
+            fenced = !fenced;
+            if (lines > 0)
+                break;
+            continue;
+        }
+        if (fenced)
+            continue;
+        if (!line) {
+            if (lines > 0)
+                break;
+            continue;
+        }
+        const headingMatch = /^#{1,6}\s+(.*)$/.exec(line);
+        if (headingMatch) {
+            if (lines > 0)
+                break;
+            if (!heading)
+                heading = plain(headingMatch[1] ?? "");
+            continue;
+        }
+        if (line.startsWith("|") || line.startsWith("<") || /^[-*_]{3,}$/.test(line)) {
+            if (lines > 0)
+                break;
+            continue;
+        }
+        const listItem = /^(?:[-*+]|\d+[.)])\s+/.test(line);
+        const content = plain(line.replace(/^(?:>\s*|[-*+]\s+|\d+[.)]\s+)/, ""));
+        if (!content)
+            continue;
+        text = lines === 0 ? content : joinLines(text, content, listItem);
+        lines += 1;
+    }
+    text = collapse(text);
+    const combined = heading && text ? `${heading} — ${text}` : heading || text;
+    return combined.length <= MAX_DERIVED_DESCRIPTION_CHARS
+        ? combined
+        : `${combined.slice(0, MAX_DERIVED_DESCRIPTION_CHARS - 1)}…`;
+}
+async function findSkillFiles(directory, depth, visited) {
+    const entries = await listDirectory(directory);
+    if (!entries)
+        return [];
+    if (entries.includes(SKILL_FILE) && (await isFile(join(directory, SKILL_FILE))))
+        return [join(directory, SKILL_FILE)];
+    if (depth >= MAX_DEPTH)
+        return [];
+    const found = [];
+    for (const name of entries) {
+        if (name.startsWith(".") || name === "node_modules")
+            continue;
+        const path = join(directory, name);
+        if ((await entryKind(path)) !== "directory")
+            continue;
+        const real = await realpath(path).catch(() => path);
+        if (visited.has(real))
+            continue;
+        visited.add(real);
+        found.push(...(await findSkillFiles(path, depth + 1, visited)));
+    }
+    return found;
+}
+/** Explains a skill directory without an entry point, naming what it does hold. */
+async function missingEntryPointMessage(directory) {
+    const entries = (await listDirectory(directory)) ?? [];
+    const nearMiss = entries.find((name) => name.toLowerCase() === "skill.md");
+    if (nearMiss)
+        return `${nearMiss} must be named exactly ${SKILL_FILE}`;
+    const markdown = entries.filter((name) => extname(name).toLowerCase() === ".md");
+    if (markdown.length === 0)
+        return `no ${SKILL_FILE} found`;
+    const shown = markdown.slice(0, 3).join(", ");
+    return `no ${SKILL_FILE} found (has ${shown}${markdown.length > 3 ? ", …" : ""}); add a ${SKILL_FILE} that describes the skill and points to the others`;
+}
+async function listDirectory(path) {
+    try {
+        return (await readdir(path)).sort();
+    }
+    catch {
+        return undefined;
+    }
+}
+async function entryKind(path) {
+    try {
+        const stats = await stat(path);
+        return stats.isDirectory() ? "directory" : stats.isFile() ? "file" : "other";
+    }
+    catch {
+        return "broken";
+    }
+}
+async function isFile(path) {
+    return stat(path).then((stats) => stats.isFile(), () => false);
+}
+function skipped(name, path, message) {
+    return { name, source: "workspace", status: "skipped", path, message };
+}
+const CJK = /[⺀-鿿豈-﫿＀-￯　-〿]/;
+/**
+ * Rejoins a wrapped paragraph: Chinese and Japanese text wraps without a space,
+ * and list items keep a separator so they do not run together.
+ */
+function joinLines(previous, next, listItem) {
+    const cjk = CJK.test(previous.slice(-1)) || CJK.test(next.slice(0, 1));
+    if (listItem)
+        return `${previous}${cjk ? "；" : "; "}${next}`;
+    return `${previous}${cjk ? "" : " "}${next}`;
+}
+function plain(value) {
+    return value.replace(/\*\*|__|`/g, "").trim();
+}
+function collapse(value) {
+    return value.replace(/\s+/g, " ").trim();
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=workspace-skills.js.map

package/dist/plugins/workspace-skills.js.map

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

package/dist/policy/policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/policy/policy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAErE,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,UAAU,GACV,WAAW,GACX,cAAc,GACd,gBAAgB,GAChB,aAAa,GACb,iBAAiB,GACjB,iBAAiB,GACjB,oBAAoB,GACpB,eAAe,GACf,gBAAgB,GAChB,aAAa,GACb,eAAe,GACf,aAAa,GACb,cAAc,GACd,sBAAsB,CAAC;AAE3B,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IACnC,UAAU,EAAE,UAAU,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAoBD,qBAAa,YAAY;;IAMvB,OAAO;WAOM,MAAM,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;IAIlE,QAAQ,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CA8I7E;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAc3D"}
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/policy/policy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAErE,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,UAAU,GACV,WAAW,GACX,cAAc,GACd,gBAAgB,GAChB,aAAa,GACb,iBAAiB,GACjB,iBAAiB,GACjB,oBAAoB,GACpB,eAAe,GACf,gBAAgB,GAChB,aAAa,GACb,eAAe,GACf,aAAa,GACb,cAAc,GACd,sBAAsB,CAAC;AAE3B,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IACnC,UAAU,EAAE,UAAU,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAoBD,qBAAa,YAAY;;IAMvB,OAAO;WAOM,MAAM,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;IAIlE,QAAQ,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAiK7E;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAiB3D"}

package/dist/policy/policy.js

@@ -1,5 +1,5 @@
 import { realpath, stat } from "node:fs/promises";
-import { basename, dirname, isAbsolute, relative, resolve, sep } from "node:path";
+import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 const MUTATING_CAPABILITIES = new Set([
     "fs.write",
     "fs.delete",
@@ -61,7 +61,8 @@ export class PolicyEngine {
         const input = request.input;
         switch (request.toolName) {
             case "read":
-            case "search": {
+            case "search":
+            case "document": {
                 const path = stringInput(input, "path") ?? this.#workspaceRoot;
                 const canonicalTarget = await canonicalizePotentialPath(path, this.#cwd);
                 return {
@@ -71,6 +72,16 @@ export class PolicyEngine {
                     riskReasons: this.#pathRisks(canonicalTarget, true),
                 };
             }
+            case "article":
+                return {
+                    capability: "fs.write",
+                    canonicalTarget: join(this.#workspaceRoot, "articles"),
+                    summary: `maintain article ${stringInput(input, "title") ?? stringInput(input, "id") ?? "document"}`,
+                    // The tool never takes a path. It can only write snapshots inside the
+                    // article directory, so the default ask_risky mode does not prompt
+                    // on every revision of a draft.
+                    riskReasons: [],
+                };
             case "edit":
             case "memory_append":
             case "memory_curate": {
@@ -80,7 +91,15 @@ export class PolicyEngine {
                     capability: request.toolName.startsWith("memory_") ? "memory.write" : "fs.write",
                     canonicalTarget,
                     summary: `${request.toolName} ${canonicalTarget}`,
-                    riskReasons: this.#pathRisks(canonicalTarget, false),
+                    riskReasons: [
+                        ...this.#pathRisks(canonicalTarget, false),
+                        // Workspace skills load into every new session without an install
+                        // step, so a model writing one would be granting itself standing
+                        // instructions; the user decides that, not the model.
+                        ...(isWithin(join(this.#workspaceRoot, "skills"), canonicalTarget)
+                            ? ["changes skill instructions that new sessions load automatically"]
+                            : []),
+                    ],
                 };
             }
             case "shell": {
@@ -171,12 +190,15 @@ export class PolicyEngine {
 export function classifyShellRisk(command) {
     const risks = [];
     const normalized = command.replace(/\s+/g, " ").trim().toLowerCase();
+    // /dev/null is a conventional output sink, not a device mutation. Remove only
+    // exact redirections to it before evaluating writes to every other /dev target.
+    const deviceRiskInput = normalized.replace(/(^|[\s;&|])\d*>{1,2}\s*\/dev\/null\b/g, "$1");
     if (/(^|[;&|]\s*|\s)(sudo|doas|su)(\s|$)/.test(normalized))
         risks.push("privilege escalation command");
     if (/\brm\s+[^\n]*(?:-[a-z]*r[a-z]*f|-[a-z]*f[a-z]*r|--recursive)/.test(normalized)) {
         risks.push("recursive or forced deletion");
     }
-    if (/\b(mkfs|fdisk|parted|dd)\b|>\s*\/dev\//.test(normalized))
+    if (/\b(mkfs|fdisk|parted|dd)\b|>\s*\/dev\//.test(deviceRiskInput))
         risks.push("disk or device mutation");
     if (/\b(systemctl|service|mount|umount|shutdown|reboot)\b/.test(normalized))
         risks.push("system service or host state mutation");

package/dist/policy/policy.js.map

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

package/dist/protocol/client.d.ts

@@ -5,6 +5,7 @@ export interface ProtocolClientOptions {
     capabilities?: string[];
     cursors?: Record<string, number>;
     maxFrameBytes?: number;
+    maxServerMessageBytes?: number;
     idFactory?: () => string;
 }
 export declare class ProtocolClient {

package/dist/protocol/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/protocol/client.ts"],"names":[],"mappings":"AAGA,OAAO,EAML,KAAK,aAAa,EAGlB,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;CAC1B;AAOD,qBAAa,cAAc;;gBAYb,OAAO,EAAE,qBAAqB;IAM1C,IAAI,KAAK,IAAI,gBAAgB,GAAG,SAAS,CAExC;IAED,IAAI,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEpC;IAEK,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAmC1C,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI;IAK/D,mBAAmB,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,GAAG,MAAM,IAAI;IAKhF,OAAO,CAAC,CAAC,GAAG,OAAO,EACvB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAO,GAC3E,OAAO,CAAC,CAAC,CAAC;IA2BP,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAqF7B"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/protocol/client.ts"],"names":[],"mappings":"AAGA,OAAO,EAML,KAAK,aAAa,EAGlB,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC;AAOrB,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;CAC1B;AAOD,qBAAa,cAAc;;gBAeb,OAAO,EAAE,qBAAqB;IAU1C,IAAI,KAAK,IAAI,gBAAgB,GAAG,SAAS,CAExC;IAED,IAAI,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEpC;IAEK,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAuC1C,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI;IAK/D,mBAAmB,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,GAAG,MAAM,IAAI;IAKhF,OAAO,CAAC,CAAC,GAAG,OAAO,EACvB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAO,GAC3E,OAAO,CAAC,CAAC,CAAC;IA2BP,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CA+F7B"}

package/dist/protocol/client.js

@@ -1,20 +1,28 @@
 import { randomUUID } from "node:crypto";
 import { createConnection } from "node:net";
 import { DEFAULT_MAX_FRAME_BYTES, encodeFrame, PROTOCOL_VERSION, } from "./schema.js";
+import { DEFAULT_MAX_SERVER_MESSAGE_BYTES, ServerFrameDecoder, SERVER_FRAME_CHUNKS_CAPABILITY, } from "./server-frame-codec.js";
 export class ProtocolClient {
     #options;
     #idFactory;
+    #decoder;
     #listeners = new Set();
     #connectionListeners = new Set();
     #pendingCommands = new Map();
     #socket;
     #pending = Buffer.alloc(0);
+    /** Offset into `#pending` already scanned for a frame delimiter. */
+    #scanned = 0;
     #helloWaiter;
     #hello;
     #lastSeq;
     constructor(options) {
         this.#options = options;
         this.#idFactory = options.idFactory ?? randomUUID;
+        this.#decoder = new ServerFrameDecoder({
+            maxFrameBytes: options.maxFrameBytes ?? DEFAULT_MAX_FRAME_BYTES,
+            maxMessageBytes: options.maxServerMessageBytes ?? DEFAULT_MAX_SERVER_MESSAGE_BYTES,
+        });
         this.#lastSeq = { ...(options.cursors ?? {}) };
     }
     get hello() {
@@ -29,6 +37,8 @@ export class ProtocolClient {
         const socket = createConnection(this.#options.socketPath);
         this.#socket = socket;
         this.#pending = Buffer.alloc(0);
+        this.#scanned = 0;
+        this.#decoder.reset();
         socket.setNoDelay(true);
         socket.on("data", (chunk) => this.#receive(chunk));
         socket.on("error", (error) => this.#disconnect(error));
@@ -44,13 +54,15 @@ export class ProtocolClient {
             };
             this.#resolveHello = resolve;
         });
+        const capabilities = new Set(this.#options.capabilities ?? []);
+        capabilities.add(SERVER_FRAME_CHUNKS_CAPABILITY);
         const frame = {
             v: PROTOCOL_VERSION,
             kind: "hello",
             id: this.#idFactory(),
             clientId: this.#options.clientId,
             supportedVersions: [PROTOCOL_VERSION],
-            capabilities: [...(this.#options.capabilities ?? [])],
+            capabilities: [...capabilities],
             cursors: this.cursors,
         };
         socket.write(encodeFrame(frame));
@@ -104,46 +116,50 @@ export class ProtocolClient {
     #receive(chunk) {
         this.#pending = Buffer.concat([this.#pending, chunk]);
         const maxFrameBytes = this.#options.maxFrameBytes ?? DEFAULT_MAX_FRAME_BYTES;
-        if (this.#pending.byteLength > maxFrameBytes * 2) {
-            this.#socket?.destroy(new Error("Server exceeded protocol buffer limit"));
-            return;
-        }
         for (;;) {
-            const delimiter = this.#pending.indexOf(0x0a);
-            if (delimiter < 0)
+            // A megabyte-sized chunk frame arrives as many small reads. Scanning only
+            // the newly arrived bytes keeps that linear instead of quadratic, which
+            // matters on the streaming traffic of a long run.
+            const delimiter = this.#pending.indexOf(0x0a, this.#scanned);
+            if (delimiter < 0) {
+                this.#scanned = this.#pending.byteLength;
                 break;
+            }
             const line = this.#pending.subarray(0, delimiter);
             this.#pending = this.#pending.subarray(delimiter + 1);
+            this.#scanned = 0;
             if (line.byteLength > maxFrameBytes) {
                 this.#socket?.destroy(new Error("Server frame exceeded protocol limit"));
                 return;
             }
-            this.#handleServerFrame(line);
-        }
-    }
-    #handleServerFrame(line) {
-        let frame;
-        try {
-            frame = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(line));
-        }
-        catch {
-            this.#socket?.destroy(new Error("Server sent invalid protocol JSON"));
-            return;
+            try {
+                const frame = this.#decoder.decode(line);
+                if (frame)
+                    this.#handleServerFrame(frame);
+            }
+            catch (error) {
+                this.#socket?.destroy(toError(error));
+                return;
+            }
         }
-        if (frame.v !== PROTOCOL_VERSION) {
-            this.#socket?.destroy(new Error("Server protocol version is unsupported"));
-            return;
+        if (this.#pending.byteLength > maxFrameBytes) {
+            this.#socket?.destroy(new Error("Server frame exceeded protocol limit"));
         }
+    }
+    #handleServerFrame(frame) {
         if (frame.kind === "hello_ack") {
             if (this.#hello) {
                 this.#socket?.destroy(new Error("Server sent duplicate hello acknowledgement"));
                 return;
             }
-            this.#hello = structuredClone(frame);
+            // The frame was just decoded from the wire and is referenced nowhere else,
+            // so the handshake hands it over as-is. Cloning a whole kernel snapshot
+            // twice per connect is pure cost on exactly the path a reconnect retries.
+            this.#hello = frame;
             const resolve = this.#resolveHello;
             this.#resolveHello = undefined;
             this.#helloWaiter = undefined;
-            resolve?.(this.hello);
+            resolve?.(frame);
             for (const listener of this.#connectionListeners)
                 listener(true);
             return;
@@ -152,8 +168,11 @@ export class ProtocolClient {
             const previous = this.#lastSeq[frame.streamId] ?? 0;
             if (frame.seq > previous)
                 this.#lastSeq[frame.streamId] = frame.seq;
+            // A single subscriber cannot observe another's mutations, and the client
+            // keeps no reference to the event, so only a shared fan-out needs copies.
+            const shared = this.#listeners.size > 1;
             for (const listener of this.#listeners)
-                listener(structuredClone(frame));
+                listener(shared ? structuredClone(frame) : frame);
             return;
         }
         if (frame.kind === "response") {
@@ -173,6 +192,9 @@ export class ProtocolClient {
         const wasConnected = this.#socket !== undefined || this.#hello !== undefined;
         this.#socket = undefined;
         this.#hello = undefined;
+        this.#pending = Buffer.alloc(0);
+        this.#scanned = 0;
+        this.#decoder.reset();
         this.#resolveHello = undefined;
         this.#helloWaiter?.reject(error);
         this.#helloWaiter = undefined;
@@ -185,4 +207,7 @@ export class ProtocolClient {
         }
     }
 }
+function toError(error) {
+    return error instanceof Error ? error : new Error(String(error));
+}
 //# sourceMappingURL=client.js.map