@peerllm/client-core 0.1.0

package/dist/services/processings/workspaceFiles/WorkspaceFileProcessingService.js

@@ -0,0 +1,493 @@
+import { createHash } from "node:crypto";
+import { AgentRun } from "@hassanhabib/standard-agents";
+import { WorkspaceFileValidationException } from "../../../models/foundations/workspaceFiles/exceptions/WorkspaceFileValidationException.js";
+import { matchesGlob } from "./Globs.js";
+import { isIgnored, readIgnoreRules } from "./IgnoreRules.js";
+import { healthy, innermostMessage, unwell } from "../../../models/processings/health/HealthCheck.js";
+import { createTryCatch } from "./WorkspaceFileProcessingService.Exceptions.js";
+import { validateAnchor, validateNewContent, validateAnchorFound, validateAnchorIsAlone, validateRange, validateReplacement, validateWasRead, validateWholeWasRead, } from "./WorkspaceFileProcessingService.Validations.js";
+// Higher order over the workspace's files (SPEC.md 6.1): the foundation says whether a file may
+// be read at all, and this says how much of it a turn is handed and remembers what the run has
+// seen.
+//
+// The cap is here rather than in the tool because every tool that returns file text needs the
+// same one, and a cap a tool applies is a cap the next tool forgets.
+export const MAXIMUM_PAGE_BYTES = 16_384;
+// Git's file first and the workspace's PeerLLM file second, because the last rule that matches
+// wins and the second file is the one a workspace writes for this agent alone.
+const IGNORE_FILES = [".gitignore", ".peerllmignore"];
+// What a search hands back at most. A bound the processing owns rather than the tool, because
+// every tool that searches needs the same one and a bound a tool applies is a bound the next tool
+// forgets.
+export const MAXIMUM_GLOB_MATCHES = 200;
+// What a search of the files themselves hands back at most. Smaller than the glob's bound because
+// every match carries lines of text with it, and a turn spent reading two hundred of them has
+// nothing left to think with.
+export const MAXIMUM_GREP_MATCHES = 100;
+export class WorkspaceFileProcessingService {
+    workspaceFileService;
+    loggingBroker;
+    workspaceRoot;
+    tryCatch;
+    // What each run has read, by run id. `applyWrite` reads this to refuse a whole-file write of
+    // something the run never looked at, or only looked at part of.
+    readSet = new Map();
+    // What this process has snapshotted, by run. The manifest on disk is the record that outlives the
+    // process; this is what keeps it from being re-read on every edit.
+    snapshots = new Map();
+    // What each run left behind, by path: the hash of what it wrote, or null for a file it removed.
+    // The undo reads it to tell whether anybody has touched the file since.
+    wrote = new Map();
+    // What each run changed, by run id, in the order it happened. Kept beside the reads and the
+    // snapshots because it is the same kind of thing: something true of one run that outlives no run.
+    changeSet = new Map();
+    // Told as it happens, for a door that wants to say what a turn did the moment it is done. The
+    // record is kept either way; this is only how somebody watching hears about it.
+    onChanged;
+    constructor(workspaceFileService, loggingBroker, workspaceRoot, onChanged) {
+        this.workspaceFileService = workspaceFileService;
+        this.loggingBroker = loggingBroker;
+        this.workspaceRoot = workspaceRoot;
+        this.onChanged = onChanged;
+        this.tryCatch = createTryCatch(this.loggingBroker);
+    }
+    // A window of a file, one-based and inclusive. offset 1 with no limit means the whole of it, up
+    // to the cap; a limit means that many lines.
+    retrieveFile(path, offset = 1, limit = 0) {
+        return this.tryCatch(async () => {
+            validateRange(offset, limit);
+            const content = await this.workspaceFileService.retrieveFile(path);
+            // Split on the newline alone, so a carriage return stays part of the line it came with. A
+            // file read and written back must be the file that was there, and normalising line endings
+            // on the way in is how an agent silently rewrites every line of a file it only meant to
+            // look at.
+            const lines = content.split("\n");
+            const totalLines = lines.length;
+            const firstLine = Math.min(offset, totalLines);
+            const requestedLast = limit > 0 ? Math.min(firstLine + limit - 1, totalLines) : totalLines;
+            const window = lines.slice(firstLine - 1, requestedLast);
+            const capped = capToBytes(window);
+            const lastLine = firstLine + capped.length - 1;
+            const text = capped.join("\n");
+            const truncated = lastLine < totalLines || firstLine > 1;
+            const alreadyRead = this.hasRead(path, firstLine, lastLine);
+            this.rememberRead(path, firstLine, lastLine);
+            if (truncated) {
+                await this.loggingBroker.logProcess("Direction", `read_file -> ${path} lines ${firstLine} to ${lastLine} of ${totalLines}`, true);
+            }
+            return { path, text, firstLine, lastLine, totalLines, truncated, alreadyRead };
+        });
+    }
+    // What a directory holds, as the workspace is willing to show it: the foundation lists it and
+    // the workspace's own ignore files narrow that, so a first look at a repository is its source
+    // and not a hundred thousand files somebody else's tool put there.
+    //
+    // The repository store is the foundation's refusal and is not repeated here, which is why no
+    // rule in an ignore file can un-hide it.
+    listDirectory(path) {
+        return this.tryCatch(async () => {
+            return await this.listing(path, await this.ignoreRules());
+        });
+    }
+    // Newest first and bounded, because a question about a repository is nearly always a question
+    // about what somebody changed recently, and a thousand paths answer nothing that the first two
+    // hundred did not.
+    glob(root, pattern) {
+        return this.tryCatch(async () => {
+            const found = [];
+            await this.collect(root, await this.ignoreRules(), found);
+            return found
+                .filter((entry) => matchesGlob(entry.relativePath, pattern))
+                .sort((left, right) => right.modifiedOn.getTime() - left.modifiedOn.getTime())
+                .slice(0, MAXIMUM_GLOB_MATCHES)
+                .map((entry) => entry.relativePath);
+        });
+    }
+    // Every line under a root that the expression matches, with the lines around it, bounded.
+    //
+    // The bound is counted over the whole search rather than per file, because a hundred matches in
+    // one file and a hundred across a hundred files cost a turn the same.
+    grep(root, expression, contextLines = 0) {
+        return this.tryCatch(async () => {
+            const pattern = new RegExp(expression);
+            const found = [];
+            await this.collect(root, await this.ignoreRules(), found);
+            const matches = [];
+            for (const entry of found) {
+                if (matches.length >= MAXIMUM_GREP_MATCHES) {
+                    break;
+                }
+                matches.push(...(await this.matchesIn(entry, pattern, contextLines)));
+            }
+            return matches.slice(0, MAXIMUM_GREP_MATCHES);
+        });
+    }
+    async matchesIn(entry, pattern, contextLines) {
+        const content = await this.readOrSkip(entry.path);
+        if (content === null) {
+            return [];
+        }
+        const lines = content.split("\n");
+        const matches = [];
+        for (const [index, line] of lines.entries()) {
+            if (!pattern.test(line)) {
+                continue;
+            }
+            matches.push({
+                relativePath: entry.relativePath,
+                lineNumber: index + 1,
+                line,
+                before: lines.slice(Math.max(index - contextLines, 0), index),
+                after: lines.slice(index + 1, index + 1 + contextLines),
+            });
+        }
+        return matches;
+    }
+    // A file the workspace will not show is not a failed search, it is a file the search does not
+    // read. Refusing a whole grep because one file in the tree is a private key or a compiled
+    // artefact would make the tool useless in any repository anybody actually has.
+    async readOrSkip(path) {
+        try {
+            return await this.workspaceFileService.retrieveFile(path);
+        }
+        catch (error) {
+            if (error instanceof WorkspaceFileValidationException) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    // One edit, by a verbatim anchor that occurs exactly once (SPEC.md 6.3).
+    //
+    // There is no count argument and there never will be. A model that says "replace both" is a model
+    // guessing about a file it read some turns ago, and the edit that destroys work is always the one
+    // that matched in a second place nobody looked at. Exactly one match, or nothing happens.
+    //
+    // The file is never split into lines and rejoined. It is one string with one region replaced, so
+    // whatever line endings it had it still has, and a file read and written back is the file that
+    // was there.
+    applyEdit(path, anchor, replacement) {
+        return this.tryCatch(async () => {
+            validateAnchor(anchor, path);
+            validateReplacement(replacement, path);
+            const content = await this.workspaceFileService.retrieveFile(path);
+            const first = content.indexOf(anchor);
+            validateAnchorFound(first, anchor, path);
+            validateAnchorIsAlone(content.indexOf(anchor, first + anchor.length), anchor, path);
+            // Kept before the write, not after: a snapshot taken afterwards is a snapshot of the edit.
+            await this.keepSnapshot(path, content);
+            const edited = `${content.slice(0, first)}${replacement}${content.slice(first + anchor.length)}`;
+            await this.workspaceFileService.modifyFile(path, edited);
+            await this.rememberWritten(path, edited);
+            this.forgetReads(path);
+            this.recordChange(path, "edited");
+            const line = content.slice(0, first).split("\n").length;
+            await this.loggingBroker.logProcess("Direction", `single_find_and_replace -> ${path} at line ${line}`, true);
+            return { path, line };
+        });
+    }
+    // A file the workspace does not have yet. The foundation refuses to overwrite and refuses a path
+    // shaped like a secret; what this adds is the same placeholder refusal an edit gets, because a
+    // file created full of "... existing code ..." is a file somebody has to write again.
+    createFile(path, content) {
+        return this.tryCatch(async () => {
+            validateNewContent(content, path);
+            await this.workspaceFileService.addFile(path, content);
+            this.recordChange(path, "created");
+            await this.loggingBroker.logProcess("Direction", `create_new_file -> ${path}`, true);
+        });
+    }
+    // A whole file, replaced (SPEC.md 6.3). `single_find_and_replace` changes a region a model
+    // can name; this replaces everything, which is the right shape for a file being rewritten and
+    // the wrong shape for a file being touched.
+    //
+    // The guards are what make the difference safe. A whole-file write is the one edit that can
+    // destroy work the model never saw, so it is only allowed to a run that has seen all of it.
+    applyWrite(path, content) {
+        return this.tryCatch(async () => {
+            validateNewContent(content, path);
+            const ranges = this.readRangesOf(path);
+            validateWasRead(ranges.length > 0, path);
+            const existing = await this.workspaceFileService.retrieveFile(path);
+            const totalLines = existing.split("\n").length;
+            validateWholeWasRead(ranges.some((range) => range.firstLine <= 1 && range.lastLine >= totalLines), path, totalLines);
+            // Kept before the write, not after: a snapshot taken afterwards is a snapshot of the write.
+            await this.keepSnapshot(path, existing);
+            await this.workspaceFileService.modifyFile(path, content);
+            await this.rememberWritten(path, content);
+            this.forgetReads(path);
+            this.recordChange(path, "rewritten");
+            await this.loggingBroker.logProcess("Direction", `write_file -> ${path}`, true);
+        });
+    }
+    // A file taken out of the workspace (SPEC.md 6.3).
+    //
+    // Kept before it goes, exactly as an edit is, because a delete is the change somebody most wants
+    // back and the only one where the file itself is the thing that is gone.
+    deletePath(path) {
+        return this.tryCatch(async () => {
+            // Deleting a file this run never looked at is a guess about what is in it. The same rule as a
+            // whole-file write, for the same reason, and here the guess cannot be taken back by reading
+            // again.
+            validateWasRead(this.readRangesOf(path).length > 0, path);
+            await this.keepSnapshot(path, await this.workspaceFileService.retrieveFile(path));
+            await this.workspaceFileService.removePath(path);
+            await this.rememberWritten(path, null);
+            this.forgetReads(path);
+            this.recordChange(path, "deleted");
+            await this.loggingBroker.logProcess("Direction", `delete_path -> ${path}`, true);
+        });
+    }
+    // What the file was, under a name derived from the run and the path, so two runs editing the same
+    // file do not overwrite each other's undo.
+    //
+    // The manifest is rewritten after each edit rather than at the end of the run. A run that is
+    // killed halfway has still changed files, and an undo that only exists for runs that finished
+    // tidily is an undo for the case nobody needs it in.
+    async keepSnapshot(path, content) {
+        const runId = runIdOf();
+        const key = snapshotKeyOf(runId, path);
+        await this.workspaceFileService.addSnapshot(key, content);
+        const kept = this.snapshots.get(runId) ?? new Map();
+        kept.set(path, key);
+        this.snapshots.set(runId, kept);
+        await this.writeManifest(runId);
+    }
+    // What the run left behind, so an undo can tell afterwards whether anybody has touched the file
+    // since. null is a file the run removed: what it left there was nothing, and a file that is back
+    // is a file somebody put back themselves.
+    //
+    // Written after the change rather than before it, which is the opposite of the snapshot and for
+    // the same reason: the snapshot is what was there, and this is what is there now.
+    async rememberWritten(path, content) {
+        const runId = runIdOf();
+        const wrote = this.wrote.get(runId) ?? new Map();
+        wrote.set(path, content === null ? null : digestOf(content));
+        this.wrote.set(runId, wrote);
+        await this.writeManifest(runId);
+    }
+    // Three things per file: where the snapshot went, and what the run left there. An entry written
+    // before this existed has two, and an undo reading one of those cannot tell whether anything has
+    // changed since, so it puts the file back the way it always did.
+    async writeManifest(runId) {
+        const kept = this.snapshots.get(runId) ?? new Map();
+        const wrote = this.wrote.get(runId) ?? new Map();
+        // Two elements when the run has not written yet, three once it has. The shapes mean different
+        // things and must not collapse into one: a missing third element is "nobody knows what the run
+        // left", and a third element of null is "the run left nothing there", which is a delete. A run
+        // killed between the snapshot and the write leaves the first, and its undo still works.
+        const entries = [...kept].map(([path, key]) => wrote.has(path) ? [path, key, wrote.get(path) ?? null] : [path, key]);
+        await this.workspaceFileService.addSnapshot(manifestKeyOf(runId), JSON.stringify(entries));
+    }
+    // Every file this run changed, as it was before the run touched it, and every one that is not
+    // put back because somebody has changed it since.
+    //
+    // An undo that overwrote a file a person edited after the run would be taking their work away
+    // while telling them it was putting work back, which is the worst thing a button called "put it
+    // back" could possibly do.
+    //
+    // The manifest is read from disk rather than from memory, because the run being undone is
+    // usually not this process: somebody types the undo after the thing that went wrong, in a new
+    // terminal.
+    restoreRun(runId) {
+        return this.tryCatch(async () => {
+            const manifest = await this.readManifest(runId);
+            const putBack = [];
+            const leftAlone = [];
+            for (const entry of manifest) {
+                const [path, key] = entry;
+                if (await this.changedSince(entry)) {
+                    leftAlone.push(path);
+                    continue;
+                }
+                await this.putBack(path, await this.workspaceFileService.retrieveSnapshot(key));
+                this.forgetReads(path);
+                putBack.push(path);
+            }
+            await this.loggingBroker.logProcess("Direction", `restore -> ${putBack.length} files from run ${runId}, ${leftAlone.length} left alone`, true);
+            return { putBack, leftAlone };
+        });
+    }
+    // Whether somebody has touched this file since the run left it.
+    //
+    // An entry with no record of what the run left cannot answer the question, and answers no: that
+    // is every manifest written before this existed, plus a run killed between the snapshot and the
+    // write. Those put the file back the way they always did, which is the behaviour people already
+    // have rather than a new refusal they did not ask for.
+    async changedSince(entry) {
+        const [path, , left] = entry;
+        if (entry.length < 3) {
+            return false;
+        }
+        try {
+            return digestOf(await this.workspaceFileService.retrieveFile(path)) !== left;
+        }
+        catch {
+            // The file is not there. That matches a run that removed it, and differs from a run that
+            // wrote one: either way the comparison is the same question, answered without the bytes.
+            return left !== null;
+        }
+    }
+    // Written back over the file, or written again when the file is gone. A run that deleted
+    // something has nothing left to modify, and an undo that could put back every change except the
+    // one that removed a file would be an undo for the case nobody needs it in.
+    async putBack(path, content) {
+        try {
+            await this.workspaceFileService.modifyFile(path, content);
+        }
+        catch (error) {
+            if (!(error instanceof WorkspaceFileValidationException)) {
+                throw error;
+            }
+            await this.workspaceFileService.addFile(path, content);
+        }
+    }
+    async readManifest(runId) {
+        try {
+            const document = await this.workspaceFileService.retrieveSnapshot(manifestKeyOf(runId));
+            return JSON.parse(document);
+        }
+        catch (error) {
+            // A run with no manifest kept nothing, which is what a run that only read files looks like.
+            // Not being able to put back something that never happened is not a failure, and reporting it
+            // as one would make every undo of a read-only run look like a broken undo.
+            if (error instanceof WorkspaceFileValidationException) {
+                return [];
+            }
+            throw error;
+        }
+    }
+    // Whether the directory this run was pointed at is one the agent can work in (PLAN.md 2.7).
+    verifyWorkspace() {
+        return this.tryCatch(async () => {
+            try {
+                const entries = await this.listDirectory(this.workspaceRoot);
+                // What the agent may see rather than what is there. A workspace whose every file is hidden by
+                // an ignore rule is a workspace a run will find empty, and saying so here is cheaper than
+                // finding out six turns in.
+                return healthy(CHECK_NAME, `${this.workspaceRoot}: ${entries.length} entr${entries.length === 1 ? "y" : "ies"} the agent may see`);
+            }
+            catch (error) {
+                return unwell(CHECK_NAME, `${this.workspaceRoot} could not be read: ${innermostMessage(error)}`);
+            }
+        });
+    }
+    // One directory, narrowed to what the workspace is willing to show. Both public routines read a
+    // listing the same way, so the rules cannot come to mean one thing to a listing and another to
+    // a search.
+    async listing(path, rules) {
+        const entries = await this.workspaceFileService.retrieveEntries(path);
+        return entries.filter((entry) => !isIgnored(entry.relativePath, entry.isDirectory, rules));
+    }
+    // A directory the rules hid is a directory the walk never opens, which is what keeps a search of
+    // a Node repository from reading a hundred thousand files nobody wrote.
+    async collect(path, rules, found) {
+        for (const entry of await this.listing(path, rules)) {
+            if (entry.isDirectory) {
+                await this.collect(entry.path, rules, found);
+                continue;
+            }
+            found.push(entry);
+        }
+    }
+    // Both ignore files, in the order that decides a tie: the last rule that matches wins, so the
+    // workspace's PeerLLM file can show something git hides without editing anything git reads.
+    //
+    // They are read from a listing rather than by asking for a file that may not be there, because
+    // absence is the ordinary case here and an exception is not how the ordinary case is said.
+    async ignoreRules() {
+        const rootEntries = await this.workspaceFileService.retrieveEntries(this.workspaceRoot);
+        const present = new Set(rootEntries.filter((entry) => !entry.isDirectory).map((entry) => entry.name));
+        const rules = [];
+        for (const name of IGNORE_FILES) {
+            if (!present.has(name)) {
+                continue;
+            }
+            rules.push(...readIgnoreRules(await this.workspaceFileService.retrieveFile(`${this.workspaceRoot}/${name}`)));
+        }
+        return rules;
+    }
+    // What this run has read of this file, as the ranges it asked for. Empty when the run has not
+    // read it, and empty outside a run, because a read that belongs to no run belongs to nobody.
+    // What this run has changed so far, oldest first. A run that changed nothing answers with
+    // nothing, which is the answer that matters most: it is how anybody finds out that a turn which
+    // said it edited a file did not.
+    changesOf(runId) {
+        return this.changeSet.get(runId) ?? [];
+    }
+    // Recorded by the routine that made the change, at the moment it succeeded, so the only way onto
+    // this list is to have actually changed the file. A record assembled from what the model said it
+    // did would be the model's account of itself, which is the thing in question.
+    recordChange(path, change) {
+        const runId = runIdOf();
+        const changed = this.changeSet.get(runId) ?? [];
+        changed.push({ path, change });
+        this.changeSet.set(runId, changed);
+        this.onChanged?.({ path, change });
+    }
+    readRangesOf(path) {
+        const runId = AgentRun.current()?.id ?? "";
+        return this.readSet.get(runId)?.get(path) ?? [];
+    }
+    // Whether this run has been handed exactly this window before. Exactly, rather than overlapping:
+    // a model widening its window is doing something new, and only a repeat of the same request is
+    // the loop worth naming.
+    hasRead(path, firstLine, lastLine) {
+        // Inside one already delivered, not merely equal to it: a model given lines 1 to 15 and then
+        // asking for 5 to 10 is asking for text it is holding, and varying the numbers is how a loop
+        // walks around a reminder that only matched exactly. Asking for lines it has not seen is
+        // progress and answers in full.
+        return this.readRangesOf(path).some((range) => range.firstLine <= firstLine && range.lastLine >= lastLine);
+    }
+    // What an edit changed, this run has not read. Forgetting is what keeps the reminder honest: the
+    // file on disk is no longer the file the model was handed, and telling it otherwise would be
+    // worse than saying nothing.
+    forgetReads(path) {
+        this.readSet.get(AgentRun.current()?.id ?? "")?.delete(path);
+    }
+    rememberRead(path, firstLine, lastLine) {
+        const runId = AgentRun.current()?.id;
+        // Outside a run there is nobody to remember for, and filing it under a shared empty key makes
+        // one caller's reads look like another's.
+        if (runId === undefined) {
+            return;
+        }
+        const byPath = this.readSet.get(runId) ?? new Map();
+        const ranges = byPath.get(path) ?? [];
+        ranges.push({ firstLine, lastLine });
+        byPath.set(path, ranges);
+        this.readSet.set(runId, byPath);
+    }
+}
+// Whole lines only. Half a line of code is worse than one line fewer, because the model cannot
+// tell which half it is missing.
+function capToBytes(lines) {
+    const kept = [];
+    let bytes = 0;
+    for (const line of lines) {
+        const cost = Buffer.byteLength(line, "utf8") + 1;
+        if (bytes + cost > MAXIMUM_PAGE_BYTES && kept.length > 0) {
+            break;
+        }
+        kept.push(line);
+        bytes += cost;
+    }
+    return kept;
+}
+function snapshotKeyOf(runId, path) {
+    return `${digestOf(runId)}-${digestOf(path)}`;
+}
+function manifestKeyOf(runId) {
+    return `${digestOf(runId)}.manifest.json`;
+}
+function digestOf(value) {
+    return createHash("sha256").update(value).digest("hex").slice(0, 16);
+}
+// A run that has no identity is still a run somebody can undo, so it gets a name rather than an
+// empty one.
+function runIdOf() {
+    return AgentRun.current()?.id ?? "detached";
+}
+// What this check is called on the report. One word, so the four of them line up.
+const CHECK_NAME = "workspace";
+//# sourceMappingURL=WorkspaceFileProcessingService.js.map

package/dist/services/processings/workspaceFiles/WorkspaceFileProcessingService.js.map

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

package/dist/shared/client-version.d.ts

@@ -0,0 +1,2 @@
+export declare const CLIENT_VERSION = "0.1.0-next.1";
+//# sourceMappingURL=client-version.d.ts.map

package/dist/shared/client-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-version.d.ts","sourceRoot":"","sources":["../../src/shared/client-version.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,cAAc,iBAAiB,CAAC"}

package/dist/shared/client-version.js

@@ -0,0 +1,5 @@
+// The client core's own version, sent as the client identity on every wire this package owns:
+// the account API, the brain, the skill registry and the MCP handshake. Kept in lockstep with
+// package.json by the smoke test, which fails when they differ.
+export const CLIENT_VERSION = "0.1.0-next.1";
+//# sourceMappingURL=client-version.js.map

package/dist/shared/client-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-version.js","sourceRoot":"","sources":["../../src/shared/client-version.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,8FAA8F;AAC9F,gEAAgE;AAChE,MAAM,CAAC,MAAM,cAAc,GAAG,cAAc,CAAC"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@peerllm/client-core",
+  "version": "0.1.0",
+  "description": "The PeerLLM client core: the coding composition, connections, sessions, the account, and the perimeter every PeerLLM client runs behind.",
+  "author": {
+    "name": "Hassan Habib",
+    "email": "hassan@bestbytes.ai",
+    "url": "https://peerllm.com"
+  },
+  "license": "UNLICENSED",
+  "private": false,
+  "homepage": "https://github.com/PeerLLM/PeerLLM.Experimental.Core.Clients",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PeerLLM/PeerLLM.Experimental.Core.Clients.git"
+  },
+  "bugs": {
+    "url": "https://github.com/PeerLLM/PeerLLM.Experimental.Core.Clients/issues"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist/",
+    "skills/",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\"",
+    "typecheck": "tsc --noEmit && tsc -p tsconfig.test.json",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "prepack": "npm run clean && npm run build"
+  },
+  "dependencies": {
+    "@hassanhabib/standard-agents": "^0.1.0",
+    "cross-spawn": "^7.0.6"
+  },
+  "devDependencies": {
+    "@types/cross-spawn": "^6.0.6",
+    "@types/node": "^20.14.0",
+    "@typescript-eslint/eslint-plugin": "^8.5.0",
+    "@typescript-eslint/parser": "^8.5.0",
+    "eslint": "^9.10.0",
+    "typescript": "^5.6.0",
+    "vitest": "^4.1.6"
+  }
+}

package/skills/native/coding-agent.md

@@ -0,0 +1,33 @@
+---
+name: coding-agent
+description: The PeerLLM coding agent's standing instructions.
+---
+You are the PeerLLM coding agent. You work inside the user's current directory, one prompt at a
+time, and you say what you are doing before you do it.
+
+You have tools. Call them: they are offered to you as functions with schemas, and calling one is
+how you read and change the workspace. Do not write out the name of a tool as text and do not
+describe the call you would like to make, because nothing is listening for that.
+
+Act on what you have. Read a file once. If you have already read it in this run, use what it said
+rather than reading it again, and if you have already searched for something, use what you found.
+Repeating a read costs the user a turn and tells you nothing new.
+
+When the task is to change something, change it. Read what you need, then call the tool that makes
+the change; a summary of the edit you intend is not an edit. An edit needs the passage to replace
+exactly as the file has it, so read before you write, and write once.
+
+Nobody approves an edit by replying to you. When a change needs permission, calling the tool is what
+asks for it, and the person answers there, not here. So do not describe an edit and wait: a
+described edit is not an edit, there is no queue it goes into, and there is nothing anybody can say
+back to you that will apply it. If you are about to write "let me know if you approve", call the
+tool instead and let them answer the question the tool asks.
+
+When you have what the user asked for, answer in plain prose with no prefix and no protocol marker
+of any kind. Use a tool when the task needs one and answer directly when it does not. Prefer
+looking to guessing: this workspace is in front of you, so a question about what a file says is a
+question you can answer by reading it rather than by inferring it from the name.
+
+When a tool is refused, held for approval, or not permitted, say so plainly and continue with what
+you can do instead. A refusal usually tells you what to do next: read again, or make the anchor
+unique. Never invent a tool result, and never dress a tool's raw output as the answer.