@peerllm/client-core 0.1.0

package/dist/brokers/mcps/StdioMcpBroker.js

@@ -0,0 +1,117 @@
+import { CLIENT_VERSION } from "../../shared/client-version.js";
+// A Model Context Protocol server over stdio (SPEC.md 4.8 External, PLAN.md 2.8).
+//
+// Newline-delimited JSON-RPC and nothing else. The protocol lives here and the pipe lives in the
+// channel, so this can be driven by a script in a test and by a child process in a run, and neither
+// of them has an opinion about the other.
+//
+// One handshake per broker, done once and remembered. A server that was initialised twice would
+// answer the second one and forget the first, and every tool this client had listed would stop
+// being callable.
+export const MCP_PROTOCOL_VERSION = "2024-11-05";
+export class StdioMcpBroker {
+    channel;
+    name;
+    nextId = 1;
+    handshake = null;
+    constructor(channel, name) {
+        this.channel = channel;
+        this.name = name;
+    }
+    async listTools() {
+        await this.initialize();
+        const answered = await this.request("tools/list", {});
+        const tools = answered.tools ?? [];
+        return tools.map((tool) => ({
+            // Prefixed with the server's name, because two servers may both offer `search` and a model
+            // asked to call one of them has to be able to say which.
+            name: `${this.name}__${tool.name ?? ""}`,
+            description: tool.description ?? "",
+            inputSchemaJson: JSON.stringify(tool.inputSchema ?? { type: "object", properties: {} }),
+        }));
+    }
+    async call(name, argumentsJson, signal) {
+        await this.initialize();
+        const answered = await this.request("tools/call", { name: withoutPrefix(name, this.name), arguments: readArguments(argumentsJson) }, signal);
+        return readContent(answered);
+    }
+    // Done once, whoever asks first. Both public routines need it and neither should have to know
+    // whether the other went first.
+    async initialize() {
+        this.handshake ??= this.shakeHands();
+        await this.handshake;
+    }
+    async shakeHands() {
+        await this.request("initialize", {
+            protocolVersion: MCP_PROTOCOL_VERSION,
+            capabilities: {},
+            clientInfo: { name: "peerllm-client-cli", version: CLIENT_VERSION },
+        });
+        // A notification, so no id and no answer to wait for. Waiting for one would hang against every
+        // server that follows the protocol.
+        await this.channel.send(JSON.stringify({ jsonrpc: "2.0", method: "notifications/initialized" }));
+    }
+    async request(method, parameters, signal) {
+        const id = this.nextId;
+        this.nextId += 1;
+        await this.channel.send(JSON.stringify({ jsonrpc: "2.0", id, method, params: parameters }));
+        for (;;) {
+            const line = await this.channel.next(signal);
+            // The server stopped writing. Every request still waiting would wait forever, so this is the
+            // answer rather than the absence of one.
+            if (line === null) {
+                throw new Error(`the '${this.name}' server stopped answering during ${method}`);
+            }
+            const message = parse(line);
+            // Notifications and answers to other requests go past. A server may say anything it likes
+            // between the question and the answer, and a client that read the first line as its own would
+            // be reading somebody else's post.
+            if (message === null || message.id !== id) {
+                continue;
+            }
+            if (message.error !== undefined) {
+                throw new Error(`the '${this.name}' server refused ${method}: ${message.error.message ?? "no reason given"}`);
+            }
+            return message.result;
+        }
+    }
+}
+// A line that is not JSON is a line a server wrote for a human. Servers log to stdout more often
+// than anybody would like, and a client that threw on the first one would be a client that works
+// against almost nothing.
+function parse(line) {
+    if (line === null) {
+        return null;
+    }
+    try {
+        return JSON.parse(line);
+    }
+    catch {
+        return null;
+    }
+}
+// The text of the answer, joined. A tool that answered with an image has nothing a text protocol can
+// carry, and saying so is better than handing the model an empty string it will read as success.
+function readContent(answered) {
+    const said = (answered.content ?? [])
+        .filter((part) => part.type === "text")
+        .map((part) => part.text ?? "")
+        .join("\n");
+    if (said.length > 0) {
+        return said;
+    }
+    return (answered.content ?? []).length > 0 ? "[the server answered with something that is not text]" : "";
+}
+function withoutPrefix(name, server) {
+    return name.startsWith(`${server}__`) ? name.slice(server.length + 2) : name;
+}
+// A model that sent nothing sent an empty object, not a parse error.
+function readArguments(argumentsJson) {
+    try {
+        return argumentsJson.trim().length === 0 ? {} : JSON.parse(argumentsJson);
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=StdioMcpBroker.js.map

package/dist/brokers/mcps/StdioMcpBroker.js.map

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

package/dist/brokers/processes/NodeProcessBroker.d.ts

@@ -0,0 +1,6 @@
+import type { ProcessBroker, ProcessOutcome, SpawnRequest } from "./ProcessBroker.js";
+export declare class NodeProcessBroker implements ProcessBroker {
+    spawn(request: SpawnRequest, signal?: AbortSignal): Promise<ProcessOutcome>;
+    killTree(processId: number): Promise<void>;
+}
+//# sourceMappingURL=NodeProcessBroker.d.ts.map

package/dist/brokers/processes/NodeProcessBroker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeProcessBroker.d.ts","sourceRoot":"","sources":["../../../src/brokers/processes/NodeProcessBroker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAQtF,qBAAa,iBAAkB,YAAW,aAAa;IACxC,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IA2C3E,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAexD"}

package/dist/brokers/processes/NodeProcessBroker.js

@@ -0,0 +1,57 @@
+import { spawn } from "node:child_process";
+// Child processes through Node's own spawn. A broker forwards: what may be run, how long is long
+// enough and how much output is too much all belong above this line.
+//
+// `shell` is never set. A shell string is a sentence somebody else's quoting rules parse, and a
+// model that writes `rm -rf $(cat x)` would have it obeyed; argv is a list where the first item is
+// a program and the rest are arguments to it, and nothing in the list can become a second command.
+export class NodeProcessBroker {
+    async spawn(request, signal) {
+        const [command = "", ...rest] = request.argv;
+        return await new Promise((resolve, reject) => {
+            const child = spawn(command, rest, {
+                cwd: request.cwd,
+                shell: false,
+                windowsHide: true,
+                ...(signal === undefined ? {} : { signal }),
+            });
+            let stdout = "";
+            let stderr = "";
+            let timedOut = false;
+            const timer = setTimeout(() => {
+                timedOut = true;
+                void this.killTree(child.pid ?? 0);
+            }, request.timeoutMilliseconds);
+            child.stdout?.on("data", (chunk) => {
+                stdout += chunk.toString("utf8");
+            });
+            child.stderr?.on("data", (chunk) => {
+                stderr += chunk.toString("utf8");
+            });
+            child.on("error", (error) => {
+                clearTimeout(timer);
+                reject(error);
+            });
+            child.on("close", (exitCode) => {
+                clearTimeout(timer);
+                resolve({ exitCode, stdout, stderr, timedOut });
+            });
+        });
+    }
+    // Windows has no process groups the way POSIX does, so the tree is walked by the tool the
+    // platform ships for it. Elsewhere the child leads its own group and one signal reaches all of
+    // it.
+    async killTree(processId) {
+        if (processId === 0) {
+            return;
+        }
+        if (process.platform === "win32") {
+            await new Promise((resolve) => {
+                spawn("taskkill", ["/pid", String(processId), "/T", "/F"], { windowsHide: true }).on("close", () => resolve());
+            });
+            return;
+        }
+        process.kill(processId, "SIGKILL");
+    }
+}
+//# sourceMappingURL=NodeProcessBroker.js.map

package/dist/brokers/processes/NodeProcessBroker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeProcessBroker.js","sourceRoot":"","sources":["../../../src/brokers/processes/NodeProcessBroker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAI3C,iGAAiG;AACjG,qEAAqE;AACrE,EAAE;AACF,gGAAgG;AAChG,mGAAmG;AACnG,mGAAmG;AACnG,MAAM,OAAO,iBAAiB;IACrB,KAAK,CAAC,KAAK,CAAC,OAAqB,EAAE,MAAoB;QAC5D,MAAM,CAAC,OAAO,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;QAE7C,OAAO,MAAM,IAAI,OAAO,CAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3D,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;gBACjC,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,KAAK,EAAE,KAAK;gBACZ,WAAW,EAAE,IAAI;gBACjB,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;aAC5C,CAAC,CAAC;YAEH,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,IAAI,QAAQ,GAAG,KAAK,CAAC;YAErB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,QAAQ,GAAG,IAAI,CAAC;gBAChB,KAAK,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;YACrC,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;YAEhC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;gBACzC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACnC,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;gBACzC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACnC,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE;gBACjC,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,QAAuB,EAAE,EAAE;gBAC5C,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;YAClD,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,0FAA0F;IAC1F,+FAA+F;IAC/F,MAAM;IACC,KAAK,CAAC,QAAQ,CAAC,SAAiB;QACrC,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QAED,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACjC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAClC,KAAK,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YACjH,CAAC,CAAC,CAAC;YAEH,OAAO;QACT,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/brokers/processes/ProcessBroker.d.ts

@@ -0,0 +1,16 @@
+export interface SpawnRequest {
+    readonly argv: readonly string[];
+    readonly cwd: string;
+    readonly timeoutMilliseconds: number;
+}
+export interface ProcessOutcome {
+    readonly exitCode: number | null;
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly timedOut: boolean;
+}
+export interface ProcessBroker {
+    spawn(request: SpawnRequest, signal?: AbortSignal): Promise<ProcessOutcome>;
+    killTree(processId: number): Promise<void>;
+}
+//# sourceMappingURL=ProcessBroker.d.ts.map

package/dist/brokers/processes/ProcessBroker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProcessBroker.d.ts","sourceRoot":"","sources":["../../../src/brokers/processes/ProcessBroker.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAE7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAI5E,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C"}

package/dist/brokers/processes/ProcessBroker.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ProcessBroker.js.map

package/dist/brokers/processes/ProcessBroker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProcessBroker.js","sourceRoot":"","sources":["../../../src/brokers/processes/ProcessBroker.ts"],"names":[],"mappings":""}

package/dist/brokers/registries/PeerLlmSkillRegistryBroker.d.ts

@@ -0,0 +1,13 @@
+import type { RegistrySkill, RetrievedSkill } from "../../models/brokers/registries/RegistrySkill.js";
+import type { SkillRegistryBroker } from "./SkillRegistryBroker.js";
+export declare class PeerLlmSkillRegistryBroker implements SkillRegistryBroker {
+    private readonly registryUrl;
+    private readonly apiKey;
+    private readonly userAgent;
+    private readonly fetchResource;
+    constructor(registryUrl: string, apiKey: string, userAgent?: string, fetchResource?: typeof fetch);
+    getSkills(query: string): Promise<readonly RegistrySkill[]>;
+    getSkill(id: string): Promise<RetrievedSkill>;
+    private send;
+}
+//# sourceMappingURL=PeerLlmSkillRegistryBroker.d.ts.map

package/dist/brokers/registries/PeerLlmSkillRegistryBroker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PeerLlmSkillRegistryBroker.d.ts","sourceRoot":"","sources":["../../../src/brokers/registries/PeerLlmSkillRegistryBroker.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAa,MAAM,kDAAkD,CAAC;AACjH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAWpE,qBAAa,0BAA2B,YAAW,mBAAmB;IACpE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;gBAG3C,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,SAAS,SAAyC,EAClD,aAAa,GAAE,OAAO,KAAsD;IAUjE,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC;IAS3D,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;YAO5C,IAAI;CAcnB"}

package/dist/brokers/registries/PeerLlmSkillRegistryBroker.js

@@ -0,0 +1,63 @@
+import { HttpResponseException } from "@hassanhabib/standard-agents";
+import { CLIENT_VERSION } from "../../shared/client-version.js";
+// The PeerLLM skills registry at `skills.peerllm.com` (PLAN.md 2.8).
+//
+// The same API key the brain takes. One account, one key, three services that answer to it: the
+// orchestrator's `/v1` for thinking, its `/auth` and `/api` for the account, and this for skills. A
+// client that asked for a fourth secret would be asking the user to keep track of something the
+// service does not need them to.
+//
+// A parse and nothing else. Which skills are worth having, what a version means and where a skill
+// goes on disk are all decided above this line.
+export class PeerLlmSkillRegistryBroker {
+    registryUrl;
+    apiKey;
+    userAgent;
+    fetchResource;
+    constructor(registryUrl, apiKey, userAgent = `peerllm-client-cli/${CLIENT_VERSION}`, fetchResource = (input, init) => globalThis.fetch(input, init)) {
+        this.registryUrl = registryUrl.endsWith("/") ? registryUrl : `${registryUrl}/`;
+        this.apiKey = apiKey;
+        this.userAgent = userAgent;
+        this.fetchResource = fetchResource;
+    }
+    // What the registry will show this key. Public skills, plus the account's own private ones,
+    // which is the registry's rule rather than this client's.
+    async getSkills(query) {
+        const asked = query.trim().length > 0 ? `?q=${encodeURIComponent(query.trim())}` : "";
+        const answered = await this.send(`skills${asked}`);
+        return (JSON.parse(answered).skills ?? []).map(readSkill);
+    }
+    // One skill, whole. `@N` pins a version and a bare id takes the latest, which is the registry's
+    // own path syntax rather than a parameter this client invented.
+    async getSkill(id) {
+        const answered = await this.send(`skills/id/${encodeURIComponent(id)}`);
+        const retrieved = JSON.parse(answered);
+        return { ...readSkill(retrieved), files: (retrieved.files ?? []).map(readFile) };
+    }
+    async send(route) {
+        const response = await this.fetchResource(`${this.registryUrl}${route}`, {
+            method: "GET",
+            headers: { Authorization: `Bearer ${this.apiKey}`, "User-Agent": this.userAgent },
+        });
+        const body = await response.text();
+        if (!response.ok) {
+            throw new HttpResponseException(response.status, body);
+        }
+        return body;
+    }
+}
+// The registry's names on the left, this client's on the right. `skill_id` is the stable one and
+// the only thing worth keeping: a name is unique only within an owner and a rename still reroutes.
+function readSkill(listed) {
+    return {
+        id: listed.skill_id ?? "",
+        owner: listed.owner ?? "",
+        name: listed.name ?? "",
+        version: listed.version ?? 0,
+        description: listed.description ?? "",
+    };
+}
+function readFile(file) {
+    return { path: file.path ?? "", content: file.content ?? "" };
+}
+//# sourceMappingURL=PeerLlmSkillRegistryBroker.js.map

package/dist/brokers/registries/PeerLlmSkillRegistryBroker.js.map

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

package/dist/brokers/registries/SkillRegistryBroker.d.ts

@@ -0,0 +1,6 @@
+import type { RegistrySkill, RetrievedSkill } from "../../models/brokers/registries/RegistrySkill.js";
+export interface SkillRegistryBroker {
+    getSkills(query: string): Promise<readonly RegistrySkill[]>;
+    getSkill(id: string): Promise<RetrievedSkill>;
+}
+//# sourceMappingURL=SkillRegistryBroker.d.ts.map

package/dist/brokers/registries/SkillRegistryBroker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillRegistryBroker.d.ts","sourceRoot":"","sources":["../../../src/brokers/registries/SkillRegistryBroker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kDAAkD,CAAC;AAMtG,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAAC;IAC5D,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC/C"}

package/dist/brokers/registries/SkillRegistryBroker.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SkillRegistryBroker.js.map

package/dist/brokers/registries/SkillRegistryBroker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillRegistryBroker.js","sourceRoot":"","sources":["../../../src/brokers/registries/SkillRegistryBroker.ts"],"names":[],"mappings":""}

package/dist/brokers/secrets/FileSecretBroker.d.ts

@@ -0,0 +1,12 @@
+import type { SecretBroker } from "./SecretBroker.js";
+export declare class FileSecretBroker implements SecretBroker {
+    private readonly storePath;
+    private readonly lockPath;
+    constructor(storePath: string, lockPath: string);
+    selectStore(): Promise<string>;
+    upsertStore(document: string): Promise<void>;
+    insertLock(holder: string): Promise<void>;
+    selectLock(): Promise<string>;
+    deleteLock(): Promise<void>;
+}
+//# sourceMappingURL=FileSecretBroker.d.ts.map

package/dist/brokers/secrets/FileSecretBroker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSecretBroker.d.ts","sourceRoot":"","sources":["../../../src/brokers/secrets/FileSecretBroker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAWtD,qBAAa,gBAAiB,YAAW,YAAY;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEf,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAKzC,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAM9B,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5C,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUzC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAI7B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAGzC"}

package/dist/brokers/secrets/FileSecretBroker.js

@@ -0,0 +1,43 @@
+import { open, readFile, rename, unlink, writeFile } from "node:fs/promises";
+// `client-secrets.json` at owner-only, in the shipped host's blob shape (SPEC.md 14.4), and the
+// `.lock.secrets` sibling beside it.
+//
+// The same file, the same broker and the same format for the terminal and the desktop, so a key
+// written by either is read by the other. No keyring, no native module and no second format: the
+// day one app cannot read what the other wrote is the day the user signs in twice and stops
+// believing either of them.
+const OWNER_ONLY = 0o600;
+export class FileSecretBroker {
+    storePath;
+    lockPath;
+    constructor(storePath, lockPath) {
+        this.storePath = storePath;
+        this.lockPath = lockPath;
+    }
+    async selectStore() {
+        return await readFile(this.storePath, "utf8");
+    }
+    // The mode is set on the way in rather than after, so the window in which a key is
+    // world-readable never opens.
+    async upsertStore(document) {
+        const temporaryPath = `${this.storePath}.${process.pid}.tmp`;
+        await writeFile(temporaryPath, document, { encoding: "utf8", mode: OWNER_ONLY });
+        await rename(temporaryPath, this.storePath);
+    }
+    async insertLock(holder) {
+        const handle = await open(this.lockPath, "wx", OWNER_ONLY);
+        try {
+            await handle.writeFile(holder, "utf8");
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    async selectLock() {
+        return await readFile(this.lockPath, "utf8");
+    }
+    async deleteLock() {
+        await unlink(this.lockPath);
+    }
+}
+//# sourceMappingURL=FileSecretBroker.js.map

package/dist/brokers/secrets/FileSecretBroker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSecretBroker.js","sourceRoot":"","sources":["../../../src/brokers/secrets/FileSecretBroker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAI7E,gGAAgG;AAChG,qCAAqC;AACrC,EAAE;AACF,gGAAgG;AAChG,iGAAiG;AACjG,4FAA4F;AAC5F,4BAA4B;AAC5B,MAAM,UAAU,GAAG,KAAK,CAAC;AAEzB,MAAM,OAAO,gBAAgB;IACV,SAAS,CAAS;IAClB,QAAQ,CAAS;IAElC,YAAmB,SAAiB,EAAE,QAAgB;QACpD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAEM,KAAK,CAAC,WAAW;QACtB,OAAO,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IAED,mFAAmF;IACnF,8BAA8B;IACvB,KAAK,CAAC,WAAW,CAAC,QAAgB;QACvC,MAAM,aAAa,GAAG,GAAG,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC;QAE7D,MAAM,SAAS,CAAC,aAAa,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QACjF,MAAM,MAAM,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9C,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,MAAc;QACpC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QAE3D,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACzC,CAAC;gBAAS,CAAC;YACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,UAAU;QACrB,OAAO,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;IAEM,KAAK,CAAC,UAAU;QACrB,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;CACF"}

package/dist/brokers/secrets/SecretBroker.d.ts

@@ -0,0 +1,8 @@
+export interface SecretBroker {
+    selectStore(): Promise<string>;
+    upsertStore(document: string): Promise<void>;
+    insertLock(holder: string): Promise<void>;
+    selectLock(): Promise<string>;
+    deleteLock(): Promise<void>;
+}
+//# sourceMappingURL=SecretBroker.d.ts.map

package/dist/brokers/secrets/SecretBroker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SecretBroker.d.ts","sourceRoot":"","sources":["../../../src/brokers/secrets/SecretBroker.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,YAAY;IAC3B,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAG/B,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAG7C,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B"}

package/dist/brokers/secrets/SecretBroker.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SecretBroker.js.map

package/dist/brokers/secrets/SecretBroker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SecretBroker.js","sourceRoot":"","sources":["../../../src/brokers/secrets/SecretBroker.ts"],"names":[],"mappings":""}

package/dist/brokers/skills/CompositeSkillBroker.d.ts

@@ -0,0 +1,7 @@
+import type { Skill, SkillBroker } from "@hassanhabib/standard-agents";
+export declare class CompositeSkillBroker implements SkillBroker {
+    private readonly brokers;
+    constructor(...brokers: readonly SkillBroker[]);
+    selectSkills(): Promise<readonly Skill[]>;
+}
+//# sourceMappingURL=CompositeSkillBroker.d.ts.map

package/dist/brokers/skills/CompositeSkillBroker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompositeSkillBroker.d.ts","sourceRoot":"","sources":["../../../src/brokers/skills/CompositeSkillBroker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAUvE,qBAAa,oBAAqB,YAAW,WAAW;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;gBAE9B,GAAG,OAAO,EAAE,SAAS,WAAW,EAAE;IAIxC,YAAY,IAAI,OAAO,CAAC,SAAS,KAAK,EAAE,CAAC;CASvD"}

package/dist/brokers/skills/CompositeSkillBroker.js

@@ -0,0 +1,22 @@
+// Two folders, one catalogue (PLAN.md 2.8).
+//
+// The built-in skill is what this client is; an installed one is what a user added. They live in
+// different folders because one ships in the package and the other is written at runtime, and a
+// composition that could only read one of them would make installing a skill pointless.
+//
+// Order is kept: the built-in one comes first, because it is the one that says how to use a tool at
+// all, and an installed skill that contradicts it should read as the later voice.
+export class CompositeSkillBroker {
+    brokers;
+    constructor(...brokers) {
+        this.brokers = brokers;
+    }
+    async selectSkills() {
+        const skills = [];
+        for (const broker of this.brokers) {
+            skills.push(...(await broker.selectSkills()));
+        }
+        return skills;
+    }
+}
+//# sourceMappingURL=CompositeSkillBroker.js.map

package/dist/brokers/skills/CompositeSkillBroker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompositeSkillBroker.js","sourceRoot":"","sources":["../../../src/brokers/skills/CompositeSkillBroker.ts"],"names":[],"mappings":"AAEA,4CAA4C;AAC5C,EAAE;AACF,iGAAiG;AACjG,gGAAgG;AAChG,wFAAwF;AACxF,EAAE;AACF,oGAAoG;AACpG,kFAAkF;AAClF,MAAM,OAAO,oBAAoB;IACd,OAAO,CAAyB;IAEjD,YAAmB,GAAG,OAA+B;QACnD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAEM,KAAK,CAAC,YAAY;QACvB,MAAM,MAAM,GAAY,EAAE,CAAC;QAE3B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;QAChD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/exposers/tools/CreateNewFileTool.d.ts

@@ -0,0 +1,4 @@
+import type { Tool } from "@hassanhabib/standard-agents";
+import type { WorkspaceFileProcessingService } from "../../services/processings/workspaceFiles/WorkspaceFileProcessingService.js";
+export declare function createCreateNewFileTool(workspaceFileProcessingService: WorkspaceFileProcessingService): Tool;
+//# sourceMappingURL=CreateNewFileTool.d.ts.map

package/dist/exposers/tools/CreateNewFileTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateNewFileTool.d.ts","sourceRoot":"","sources":["../../../src/exposers/tools/CreateNewFileTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAGzD,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,6EAA6E,CAAC;AAGlI,wBAAgB,uBAAuB,CAAC,8BAA8B,EAAE,8BAA8B,GAAG,IAAI,CAoB5G"}

package/dist/exposers/tools/CreateNewFileTool.js

@@ -0,0 +1,39 @@
+import { answerOrRaise, readArgumentsOrRefuse, scopeOrNothing } from "./Refusals.js";
+// create_new_file (SPEC.md 6.3): a file the workspace does not have yet.
+export function createCreateNewFileTool(workspaceFileProcessingService) {
+    return {
+        name: "create_new_file",
+        description: CREATE_DESCRIPTION,
+        parameters: CREATE_PARAMETERS,
+        risk: "Sensitive",
+        narrationStarting: "Creating a file",
+        scopeOf: (input) => scopeOrNothing(input)?.path ?? "",
+        execute: async (input) => {
+            try {
+                const asked = readArguments(input);
+                await workspaceFileProcessingService.createFile(asked.path, asked.content);
+                return `created ${asked.path}`;
+            }
+            catch (error) {
+                // A refusal is an observation the model can act on, not a fault that ends the run.
+                return answerOrRaise(error);
+            }
+        },
+    };
+}
+function readArguments(input) {
+    const asked = readArgumentsOrRefuse(input, "create_new_file");
+    return { path: asked.path ?? "", content: asked.content ?? "" };
+}
+const CREATE_DESCRIPTION = "Create a file that does not exist yet, with the content you give. A path that is already there " +
+    "is refused rather than overwritten, so use single_find_and_replace to change an existing file. " +
+    "Write the content out in full: a placeholder such as '...' or 'existing code' is refused.";
+const CREATE_PARAMETERS = JSON.stringify({
+    type: "object",
+    properties: {
+        path: { type: "string", description: "The file to create." },
+        content: { type: "string", description: "Everything the file should hold." },
+    },
+    required: ["path", "content"],
+});
+//# sourceMappingURL=CreateNewFileTool.js.map

package/dist/exposers/tools/CreateNewFileTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateNewFileTool.js","sourceRoot":"","sources":["../../../src/exposers/tools/CreateNewFileTool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGrF,yEAAyE;AACzE,MAAM,UAAU,uBAAuB,CAAC,8BAA8D;IACpG,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,kBAAkB;QAC/B,UAAU,EAAE,iBAAiB;QAC7B,IAAI,EAAE,WAAW;QACjB,iBAAiB,EAAE,iBAAiB;QACpC,OAAO,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,cAAc,CAA2B,KAAK,CAAC,EAAE,IAAI,IAAI,EAAE;QAC/F,OAAO,EAAE,KAAK,EAAE,KAAa,EAAmB,EAAE;YAChD,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;gBACnC,MAAM,8BAA8B,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;gBAE3E,OAAO,WAAW,KAAK,CAAC,IAAI,EAAE,CAAC;YACjC,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,mFAAmF;gBACnF,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAOD,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,KAAK,GAAG,qBAAqB,CAA2B,KAAK,EAAE,iBAAiB,CAAC,CAAC;IAExF,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;AAClE,CAAC;AAED,MAAM,kBAAkB,GACtB,iGAAiG;IACjG,iGAAiG;IACjG,2FAA2F,CAAC;AAE9F,MAAM,iBAAiB,GAAG,IAAI,CAAC,SAAS,CAAC;IACvC,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE;QAC5D,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;KAC7E;IACD,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;CAC9B,CAAC,CAAC"}

package/dist/exposers/tools/DeletePathTool.d.ts

@@ -0,0 +1,4 @@
+import type { Tool } from "@hassanhabib/standard-agents";
+import type { WorkspaceFileProcessingService } from "../../services/processings/workspaceFiles/WorkspaceFileProcessingService.js";
+export declare function createDeletePathTool(workspaceFileProcessingService: WorkspaceFileProcessingService): Tool;
+//# sourceMappingURL=DeletePathTool.d.ts.map

package/dist/exposers/tools/DeletePathTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeletePathTool.d.ts","sourceRoot":"","sources":["../../../src/exposers/tools/DeletePathTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAIzD,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,6EAA6E,CAAC;AAOlI,wBAAgB,oBAAoB,CAAC,8BAA8B,EAAE,8BAA8B,GAAG,IAAI,CAqBzG"}

package/dist/exposers/tools/DeletePathTool.js

@@ -0,0 +1,43 @@
+import { answerOrRaise, readArgumentsOrRefuse, scopeOrNothing } from "./Refusals.js";
+// delete_path (SPEC.md 6.3): one file taken out of the workspace.
+//
+// The narrowest of the four writing tools, on purpose. A directory is refused by the foundation, a
+// file this run has not read is refused by the processing, and what was there is kept either way,
+// because this is the one act where the thing itself is what goes.
+export function createDeletePathTool(workspaceFileProcessingService) {
+    return {
+        name: "delete_path",
+        description: DELETE_DESCRIPTION,
+        parameters: DELETE_PARAMETERS,
+        risk: "Sensitive",
+        narrationStarting: "Deleting a file",
+        scopeOf: (input) => scopeOrNothing(input)?.path ?? "",
+        execute: async (input) => {
+            try {
+                const asked = readArguments(input);
+                await workspaceFileProcessingService.deletePath(asked.path);
+                return `deleted ${asked.path}`;
+            }
+            catch (error) {
+                // A refusal is an observation the model can act on, not a fault. It asked to delete
+                // something it had not read; the next turn can read it.
+                return answerOrRaise(error);
+            }
+        },
+    };
+}
+function readArguments(input) {
+    const asked = readArgumentsOrRefuse(input, "delete_path");
+    return { path: asked.path ?? "" };
+}
+const DELETE_DESCRIPTION = "Delete one file that already exists. Read it first: a file this run has not read is a file you " +
+    "are guessing about, and a delete cannot be taken back by reading again. Directories are refused, " +
+    "one file at a time. What the file was is kept, so the whole run can be put back afterwards.";
+const DELETE_PARAMETERS = JSON.stringify({
+    type: "object",
+    properties: {
+        path: { type: "string", description: "The file to delete. It must already exist and this run must have read it." },
+    },
+    required: ["path"],
+});
+//# sourceMappingURL=DeletePathTool.js.map

package/dist/exposers/tools/DeletePathTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeletePathTool.js","sourceRoot":"","sources":["../../../src/exposers/tools/DeletePathTool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAIrF,kEAAkE;AAClE,EAAE;AACF,mGAAmG;AACnG,kGAAkG;AAClG,mEAAmE;AACnE,MAAM,UAAU,oBAAoB,CAAC,8BAA8D;IACjG,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,kBAAkB;QAC/B,UAAU,EAAE,iBAAiB;QAC7B,IAAI,EAAE,WAAW;QACjB,iBAAiB,EAAE,iBAAiB;QACpC,OAAO,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,cAAc,CAA2B,KAAK,CAAC,EAAE,IAAI,IAAI,EAAE;QAC/F,OAAO,EAAE,KAAK,EAAE,KAAa,EAAmB,EAAE;YAChD,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;gBACnC,MAAM,8BAA8B,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAE5D,OAAO,WAAW,KAAK,CAAC,IAAI,EAAE,CAAC;YACjC,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,oFAAoF;gBACpF,wDAAwD;gBACxD,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAMD,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,KAAK,GAAG,qBAAqB,CAA2B,KAAK,EAAE,aAAa,CAAC,CAAC;IAEpF,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,kBAAkB,GACtB,iGAAiG;IACjG,mGAAmG;IACnG,6FAA6F,CAAC;AAEhG,MAAM,iBAAiB,GAAG,IAAI,CAAC,SAAS,CAAC;IACvC,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2EAA2E,EAAE;KACnH;IACD,QAAQ,EAAE,CAAC,MAAM,CAAC;CACnB,CAAC,CAAC"}

package/dist/exposers/tools/GitTools.d.ts

@@ -0,0 +1,5 @@
+import type { Tool } from "@hassanhabib/standard-agents";
+import type { ProcessProcessingService } from "../../services/processings/processes/ProcessProcessingService.js";
+export declare function createGitTools(processProcessingService: ProcessProcessingService, workspaceRoot: string): readonly Tool[];
+export declare const GIT_TOOL_NAMES: string[];
+//# sourceMappingURL=GitTools.d.ts.map

package/dist/exposers/tools/GitTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitTools.d.ts","sourceRoot":"","sources":["../../../src/exposers/tools/GitTools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAEzD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kEAAkE,CAAC;AAmCjH,wBAAgB,cAAc,CAC5B,wBAAwB,EAAE,wBAAwB,EAClD,aAAa,EAAE,MAAM,GACpB,SAAS,IAAI,EAAE,CAmBjB;AAED,eAAO,MAAM,cAAc,UAAmC,CAAC"}