@peerllm/client-core 0.1.0

package/dist/brokers/accounts/PeerLlmAccountBroker.d.ts

@@ -0,0 +1,20 @@
+import type { AccountKey, MintedKey } from "../../models/brokers/accounts/AccountKey.js";
+import type { AccountSession } from "../../models/brokers/accounts/AccountSession.js";
+import type { TokenBalance } from "../../models/brokers/accounts/TokenBalance.js";
+import type { AccountBroker } from "./AccountBroker.js";
+export declare class PeerLlmAccountBroker implements AccountBroker {
+    protected readonly accountUrl: string;
+    protected readonly userAgent: string;
+    protected readonly fetchResource: typeof fetch;
+    constructor(accountUrl: string, userAgent?: string, fetchResource?: typeof fetch);
+    postLogin(email: string, password: string): Promise<AccountSession>;
+    postRefresh(refreshToken: string): Promise<AccountSession>;
+    postLogout(accessToken: string, refreshToken: string): Promise<void>;
+    postApiKey(accessToken: string, keyName: string): Promise<MintedKey>;
+    getApiKeys(accessToken: string): Promise<readonly AccountKey[]>;
+    deleteApiKey(accessToken: string, id: string): Promise<void>;
+    getBalance(accessToken: string): Promise<TokenBalance>;
+    protected bearing(accessToken: string, more?: Readonly<Record<string, string>>): Record<string, string>;
+    protected send(route: string, init: RequestInit): Promise<string>;
+}
+//# sourceMappingURL=PeerLlmAccountBroker.d.ts.map

package/dist/brokers/accounts/PeerLlmAccountBroker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PeerLlmAccountBroker.d.ts","sourceRoot":"","sources":["../../../src/brokers/accounts/PeerLlmAccountBroker.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,6CAA6C,CAAC;AACzF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AACtF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+CAA+C,CAAC;AAClF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIxD,qBAAa,oBAAqB,YAAW,aAAa;IACxD,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IACtC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IACrC,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,KAAK,CAAC;gBAG7C,UAAU,EAAE,MAAM,EAClB,SAAS,SAAyC,EAClD,aAAa,GAAE,OAAO,KAAsD;IAOjE,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAUnE,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAU1D,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpE,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAYpE,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC;IAS/D,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5D,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAiBnE,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;cAM3F,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;CAUxE"}

package/dist/brokers/accounts/PeerLlmAccountBroker.js

@@ -0,0 +1,109 @@
+import { HttpResponseException } from "@hassanhabib/standard-agents";
+import { CLIENT_VERSION } from "../../shared/client-version.js";
+// The PeerLLM account API. A parse and nothing else: what a status means, what to do about it and
+// what to keep are all decided above this line.
+export class PeerLlmAccountBroker {
+    accountUrl;
+    userAgent;
+    fetchResource;
+    constructor(accountUrl, userAgent = `peerllm-client-cli/${CLIENT_VERSION}`, fetchResource = (input, init) => globalThis.fetch(input, init)) {
+        this.accountUrl = accountUrl.endsWith("/") ? accountUrl : `${accountUrl}/`;
+        this.userAgent = userAgent;
+        this.fetchResource = fetchResource;
+    }
+    async postLogin(email, password) {
+        const answered = await this.send("auth/login", {
+            method: "POST",
+            headers: { "content-type": "application/json", "User-Agent": this.userAgent },
+            body: JSON.stringify({ email, password }),
+        });
+        return readSession(JSON.parse(answered));
+    }
+    async postRefresh(refreshToken) {
+        const answered = await this.send("auth/refresh", {
+            method: "POST",
+            headers: { "content-type": "application/json", "User-Agent": this.userAgent },
+            body: JSON.stringify({ refreshToken }),
+        });
+        return readSession(JSON.parse(answered));
+    }
+    async postLogout(accessToken, refreshToken) {
+        await this.send("auth/logout", {
+            method: "POST",
+            headers: this.bearing(accessToken, { "content-type": "application/json" }),
+            body: JSON.stringify({ refreshToken }),
+        });
+    }
+    async postApiKey(accessToken, keyName) {
+        const answered = await this.send("api/api-keys", {
+            method: "POST",
+            headers: this.bearing(accessToken, { "content-type": "application/json" }),
+            body: JSON.stringify({ keyName }),
+        });
+        const minted = JSON.parse(answered);
+        return { id: minted.id ?? "", name: minted.name ?? "", key: minted.plainTextKey ?? "" };
+    }
+    async getApiKeys(accessToken) {
+        const answered = await this.send("api/api-keys", {
+            method: "GET",
+            headers: this.bearing(accessToken),
+        });
+        return JSON.parse(answered).map(readKey);
+    }
+    async deleteApiKey(accessToken, id) {
+        await this.send(`api/api-keys/${encodeURIComponent(id)}`, {
+            method: "DELETE",
+            headers: this.bearing(accessToken),
+        });
+    }
+    async getBalance(accessToken) {
+        const answered = await this.send("api/tokens/balance", {
+            method: "GET",
+            headers: this.bearing(accessToken),
+        });
+        const balance = JSON.parse(answered);
+        return {
+            availableTokens: balance.availableTokens ?? 0,
+            usedTokens: balance.usedTokens ?? 0,
+            totalPurchasedTokens: balance.totalPurchasedTokens ?? 0,
+        };
+    }
+    // The token a password bought, on every route that takes one. Written once, because a header
+    // spelled out at each call site is a header one call site eventually spells differently.
+    bearing(accessToken, more = {}) {
+        return { ...more, Authorization: `Bearer ${accessToken}`, "User-Agent": this.userAgent };
+    }
+    // Every route through one place, so the header and the failure shape cannot come to mean one
+    // thing on one route and something else on the next.
+    async send(route, init) {
+        const response = await this.fetchResource(`${this.accountUrl}${route}`, init);
+        const body = await response.text();
+        if (!response.ok) {
+            throw new HttpResponseException(response.status, body);
+        }
+        return body;
+    }
+}
+// The fields named, rather than the body handed on. A caller that received whatever the service
+// sent would be a caller coupled to every field the service ever adds.
+function readSession(answered) {
+    return {
+        accessToken: answered.accessToken ?? "",
+        refreshToken: answered.refreshToken ?? "",
+        userId: answered.userId ?? "",
+    };
+}
+// The service's names on the left, this client's on the right. `createdDate` and `lastUsedAt` are
+// the orchestrator's spelling; a client that carried them through would be spreading one service's
+// naming through every tier above it.
+function readKey(listed) {
+    return {
+        id: listed.id ?? "",
+        name: listed.name ?? "",
+        keyPreview: listed.keyPreview ?? "",
+        createdOn: listed.createdDate ?? "",
+        lastUsedOn: listed.lastUsedAt ?? null,
+        state: listed.state ?? "",
+    };
+}
+//# sourceMappingURL=PeerLlmAccountBroker.js.map

package/dist/brokers/accounts/PeerLlmAccountBroker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PeerLlmAccountBroker.js","sourceRoot":"","sources":["../../../src/brokers/accounts/PeerLlmAccountBroker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAMhE,kGAAkG;AAClG,gDAAgD;AAChD,MAAM,OAAO,oBAAoB;IACZ,UAAU,CAAS;IACnB,SAAS,CAAS;IAClB,aAAa,CAAe;IAE/C,YACE,UAAkB,EAClB,SAAS,GAAG,sBAAsB,cAAc,EAAE,EAClD,gBAA8B,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC;QAE5E,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,GAAG,CAAC;QAC3E,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;IAEM,KAAK,CAAC,SAAS,CAAC,KAAa,EAAE,QAAgB;QACpD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE;YAC7C,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,YAAY,EAAE,IAAI,CAAC,SAAS,EAAE;YAC7E,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;SAC1C,CAAC,CAAC;QAEH,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAA4B,CAAC,CAAC;IACtE,CAAC;IAEM,KAAK,CAAC,WAAW,CAAC,YAAoB;QAC3C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE;YAC/C,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,YAAY,EAAE,IAAI,CAAC,SAAS,EAAE;YAC7E,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;SACvC,CAAC,CAAC;QAEH,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAA4B,CAAC,CAAC;IACtE,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,WAAmB,EAAE,YAAoB;QAC/D,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE;YAC7B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC;YAC1E,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;SACvC,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,WAAmB,EAAE,OAAe;QAC1D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE;YAC/C,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC;YAC1E,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;SAClC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAA0D,CAAC;QAE7F,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC;IAC1F,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,WAAmB;QACzC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE;YAC/C,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;SACnC,CAAC,CAAC;QAEH,OAAQ,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAmC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC9E,CAAC;IAEM,KAAK,CAAC,YAAY,CAAC,WAAmB,EAAE,EAAU;QACvD,MAAM,IAAI,CAAC,IAAI,CAAC,gBAAgB,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE;YACxD,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;SACnC,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,WAAmB;QACzC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE;YACrD,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;SACnC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAA0B,CAAC;QAE9D,OAAO;YACL,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,CAAC;YAC7C,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,CAAC;YACnC,oBAAoB,EAAE,OAAO,CAAC,oBAAoB,IAAI,CAAC;SACxD,CAAC;IACJ,CAAC;IAEH,6FAA6F;IAC3F,yFAAyF;IAC/E,OAAO,CAAC,WAAmB,EAAE,OAAyC,EAAE;QAChF,OAAO,EAAE,GAAG,IAAI,EAAE,aAAa,EAAE,UAAU,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;IAC3F,CAAC;IAED,6FAA6F;IAC7F,qDAAqD;IAC3C,KAAK,CAAC,IAAI,CAAC,KAAa,EAAE,IAAiB;QACnD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,UAAU,GAAG,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC;QAC9E,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEnC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,qBAAqB,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACzD,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,gGAAgG;AAChG,uEAAuE;AACvE,SAAS,WAAW,CAAC,QAAiC;IACpD,OAAO;QACL,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,EAAE;QACvC,YAAY,EAAE,QAAQ,CAAC,YAAY,IAAI,EAAE;QACzC,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,EAAE;KAC9B,CAAC;AACJ,CAAC;AAWD,kGAAkG;AAClG,mGAAmG;AACnG,sCAAsC;AACtC,SAAS,OAAO,CAAC,MAA0B;IACzC,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE;QACvB,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,EAAE;QACnC,SAAS,EAAE,MAAM,CAAC,WAAW,IAAI,EAAE;QACnC,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,IAAI;QACrC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;KAC1B,CAAC;AACJ,CAAC"}

package/dist/brokers/brains/BrainBroker.d.ts

@@ -0,0 +1,5 @@
+import type { GeneratorBrokerV1 } from "@hassanhabib/standard-agents";
+export interface BrainBroker extends GeneratorBrokerV1 {
+    getModels(): Promise<readonly string[]>;
+}
+//# sourceMappingURL=BrainBroker.d.ts.map

package/dist/brokers/brains/BrainBroker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrainBroker.d.ts","sourceRoot":"","sources":["../../../src/brokers/brains/BrainBroker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAKtE,MAAM,WAAW,WAAY,SAAQ,iBAAiB;IACpD,SAAS,IAAI,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;CACzC"}

package/dist/brokers/brains/BrainBroker.js

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

package/dist/brokers/brains/BrainBroker.js.map

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

package/dist/brokers/brains/PeerLlmBrainBroker.d.ts

@@ -0,0 +1,7 @@
+import { HttpGeneratorBrokerV1 } from "@hassanhabib/standard-agents";
+import type { BrainBroker } from "./BrainBroker.js";
+export declare class PeerLlmBrainBroker extends HttpGeneratorBrokerV1 implements BrainBroker {
+    constructor(apiUrl: string, apiKey: string, model: string, userAgent?: string, fetchResource?: typeof fetch);
+    getModels(): Promise<readonly string[]>;
+}
+//# sourceMappingURL=PeerLlmBrainBroker.d.ts.map

package/dist/brokers/brains/PeerLlmBrainBroker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PeerLlmBrainBroker.d.ts","sourceRoot":"","sources":["../../../src/brokers/brains/PeerLlmBrainBroker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAyB,MAAM,8BAA8B,CAAC;AAG5F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAYpD,qBAAa,kBAAmB,SAAQ,qBAAsB,YAAW,WAAW;gBAEhF,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,SAAS,SAAyC,EAClD,aAAa,GAAE,OAAO,KAAsD;IAQjE,SAAS,IAAI,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC;CAiBrD"}

package/dist/brokers/brains/PeerLlmBrainBroker.js

@@ -0,0 +1,38 @@
+import { HttpGeneratorBrokerV1, HttpResponseException } from "@hassanhabib/standard-agents";
+import { CLIENT_VERSION } from "../../shared/client-version.js";
+// The PeerLLM network brain (SPEC.md 4.1): the V1 native protocol against the orchestrator's /v1
+// root, and the models route beside it.
+//
+// The wire shaping and the event-stream reading are the framework broker's, inherited rather than
+// copied. A second copy of the parser is the drift the SPEC names when it says the reader must
+// never be driven only by a stub that encodes its author's assumptions; what this class adds is
+// the service it speaks to, not a second opinion about what the bytes mean.
+//
+// A parse and nothing else: no schema salvage, no first-call choice, no `peerllm_tools` decision,
+// no write to run diagnostics.
+export class PeerLlmBrainBroker extends HttpGeneratorBrokerV1 {
+    constructor(apiUrl, apiKey, model, userAgent = `peerllm-client-cli/${CLIENT_VERSION}`, fetchResource = (input, init) => globalThis.fetch(input, init)) {
+        super(apiUrl, apiKey, model, userAgent, fetchResource);
+    }
+    // GET /v1/models. The ids only: what a model costs and how long its context runs are the
+    // orchestrator's to say on the route that says it, and a broker that guessed here would be
+    // deciding rather than parsing.
+    async getModels() {
+        const response = await this.fetchResource(`${this.apiUrl}models`, {
+            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 readModelIds(JSON.parse(body));
+    }
+}
+function readModelIds(models) {
+    return (models.data ?? []).map((model) => model.id ?? "");
+}
+//# sourceMappingURL=PeerLlmBrainBroker.js.map

package/dist/brokers/brains/PeerLlmBrainBroker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PeerLlmBrainBroker.js","sourceRoot":"","sources":["../../../src/brokers/brains/PeerLlmBrainBroker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAE5F,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGhE,iGAAiG;AACjG,wCAAwC;AACxC,EAAE;AACF,kGAAkG;AAClG,+FAA+F;AAC/F,gGAAgG;AAChG,4EAA4E;AAC5E,EAAE;AACF,kGAAkG;AAClG,+BAA+B;AAC/B,MAAM,OAAO,kBAAmB,SAAQ,qBAAqB;IAC3D,YACE,MAAc,EACd,MAAc,EACd,KAAa,EACb,SAAS,GAAG,sBAAsB,cAAc,EAAE,EAClD,gBAA8B,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC;QAE5E,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;IACzD,CAAC;IAED,yFAAyF;IACzF,2FAA2F;IAC3F,gCAAgC;IACzB,KAAK,CAAC,SAAS;QACpB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,MAAM,QAAQ,EAAE;YAChE,MAAM,EAAE,KAAK;YACb,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;gBACtC,YAAY,EAAE,IAAI,CAAC,SAAS;aAC7B;SACF,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEnC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,qBAAqB,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACzD,CAAC;QAED,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAmB,CAAC,CAAC;IAC1D,CAAC;CACF;AAMD,SAAS,YAAY,CAAC,MAAsB;IAC1C,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5D,CAAC"}

package/dist/brokers/configs/ConfigBroker.d.ts

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

package/dist/brokers/configs/ConfigBroker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigBroker.d.ts","sourceRoot":"","sources":["../../../src/brokers/configs/ConfigBroker.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,YAAY;IAC3B,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAI5C,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAG5D,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE1C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC"}

package/dist/brokers/configs/ConfigBroker.js

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

package/dist/brokers/configs/ConfigBroker.js.map

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

package/dist/brokers/configs/FileConfigBroker.d.ts

@@ -0,0 +1,9 @@
+import type { ConfigBroker } from "./ConfigBroker.js";
+export declare class FileConfigBroker implements ConfigBroker {
+    selectConfig(path: string): Promise<string>;
+    upsertConfig(path: string, document: string): Promise<void>;
+    insertLock(path: string, holder: string): Promise<void>;
+    selectLock(path: string): Promise<string>;
+    deleteLock(path: string): Promise<void>;
+}
+//# sourceMappingURL=FileConfigBroker.d.ts.map

package/dist/brokers/configs/FileConfigBroker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileConfigBroker.d.ts","sourceRoot":"","sources":["../../../src/brokers/configs/FileConfigBroker.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAWtD,qBAAa,gBAAiB,YAAW,YAAY;IACtC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3C,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO3D,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBvD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIzC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGrD"}

package/dist/brokers/configs/FileConfigBroker.js

@@ -0,0 +1,41 @@
+import { mkdir, open, readFile, rename, unlink, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+// The configuration documents on disk. A broker forwards and does not decide: what a document
+// means, when a lock may be taken from its holder and what to do about a document that is not
+// there all belong upstream.
+//
+// The mode is set on the way in rather than after, so the window in which a secret-bearing
+// document is world-readable never opens. Windows ignores the mode; the two apps that share these
+// files still agree about the shape of them.
+const OWNER_ONLY = 0o600;
+export class FileConfigBroker {
+    async selectConfig(path) {
+        return await readFile(path, "utf8");
+    }
+    async upsertConfig(path, document) {
+        const temporaryPath = `${path}.${process.pid}.tmp`;
+        await writeFile(temporaryPath, document, { encoding: "utf8", mode: OWNER_ONLY });
+        await rename(temporaryPath, path);
+    }
+    async insertLock(path, holder) {
+        // The folder before the lock. Only `peerllm init` makes the configuration folder, and the lock
+        // is the first file any write touches, so on a machine nobody has run init on the failure lands
+        // on a lock file the person never asked about and never hears of again. The document is written
+        // beside the lock, so making the folder here is enough for both.
+        await mkdir(dirname(path), { recursive: true });
+        const handle = await open(path, "wx", OWNER_ONLY);
+        try {
+            await handle.writeFile(holder, "utf8");
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    async selectLock(path) {
+        return await readFile(path, "utf8");
+    }
+    async deleteLock(path) {
+        await unlink(path);
+    }
+}
+//# sourceMappingURL=FileConfigBroker.js.map

package/dist/brokers/configs/FileConfigBroker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileConfigBroker.js","sourceRoot":"","sources":["../../../src/brokers/configs/FileConfigBroker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,8FAA8F;AAC9F,8FAA8F;AAC9F,6BAA6B;AAC7B,EAAE;AACF,2FAA2F;AAC3F,kGAAkG;AAClG,6CAA6C;AAC7C,MAAM,UAAU,GAAG,KAAK,CAAC;AAEzB,MAAM,OAAO,gBAAgB;IACpB,KAAK,CAAC,YAAY,CAAC,IAAY;QACpC,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAEM,KAAK,CAAC,YAAY,CAAC,IAAY,EAAE,QAAgB;QACtD,MAAM,aAAa,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC;QAEnD,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,CAAC;IACpC,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,MAAc;QAClD,+FAA+F;QAC/F,gGAAgG;QAChG,gGAAgG;QAChG,iEAAiE;QACjE,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QAElD,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,CAAC,IAAY;QAClC,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,IAAY;QAClC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;CACF"}

package/dist/brokers/generators/ScriptedGeneratorBroker.d.ts

@@ -0,0 +1,9 @@
+import type { GeneratorBroker } from "@hassanhabib/standard-agents";
+export declare class ScriptedGeneratorBroker implements GeneratorBroker {
+    readonly honorsRequest = true;
+    private readonly replies;
+    private index;
+    constructor(replies: readonly string[]);
+    generate(_systemPrompt: string, _userPrompt: string): Promise<string>;
+}
+//# sourceMappingURL=ScriptedGeneratorBroker.d.ts.map

package/dist/brokers/generators/ScriptedGeneratorBroker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScriptedGeneratorBroker.d.ts","sourceRoot":"","sources":["../../../src/brokers/generators/ScriptedGeneratorBroker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAKpE,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,SAAgB,aAAa,QAAQ;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,KAAK,CAAK;gBAEC,OAAO,EAAE,SAAS,MAAM,EAAE;IAIhC,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAMnF"}

package/dist/brokers/generators/ScriptedGeneratorBroker.js

@@ -0,0 +1,17 @@
+// The in-process scripted Brain (PLAN.md Sprint 1): the replies in order, repeating the last
+// when exhausted, exactly as the conformance runner scripts one. What a headless run answers
+// against before a network profile exists, and what CI drives the entry point with.
+export class ScriptedGeneratorBroker {
+    honorsRequest = true;
+    replies;
+    index = 0;
+    constructor(replies) {
+        this.replies = replies;
+    }
+    async generate(_systemPrompt, _userPrompt) {
+        const reply = this.replies[Math.min(this.index, this.replies.length - 1)] ?? "";
+        this.index += 1;
+        return reply;
+    }
+}
+//# sourceMappingURL=ScriptedGeneratorBroker.js.map

package/dist/brokers/generators/ScriptedGeneratorBroker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScriptedGeneratorBroker.js","sourceRoot":"","sources":["../../../src/brokers/generators/ScriptedGeneratorBroker.ts"],"names":[],"mappings":"AAEA,6FAA6F;AAC7F,6FAA6F;AAC7F,oFAAoF;AACpF,MAAM,OAAO,uBAAuB;IAClB,aAAa,GAAG,IAAI,CAAC;IACpB,OAAO,CAAoB;IACpC,KAAK,GAAG,CAAC,CAAC;IAElB,YAAmB,OAA0B;QAC3C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAEM,KAAK,CAAC,QAAQ,CAAC,aAAqB,EAAE,WAAmB;QAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAChF,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;QAEhB,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/brokers/mcps/ChildProcessMcpChannel.d.ts

@@ -0,0 +1,18 @@
+import type { McpChannel } from "./McpChannel.js";
+export declare class ChildProcessMcpChannel implements McpChannel {
+    private readonly child;
+    private readonly lines;
+    private waiting;
+    private ended;
+    private buffered;
+    constructor(argv: readonly string[], cwd: string, environment?: Readonly<Record<string, string>>);
+    send(line: string): Promise<void>;
+    next(signal?: AbortSignal): Promise<string | null>;
+    close(): Promise<void>;
+    private take;
+    private stop;
+    private release;
+    private takeHold;
+    private deliver;
+}
+//# sourceMappingURL=ChildProcessMcpChannel.d.ts.map

package/dist/brokers/mcps/ChildProcessMcpChannel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChildProcessMcpChannel.d.ts","sourceRoot":"","sources":["../../../src/brokers/mcps/ChildProcessMcpChannel.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAiBlD,qBAAa,sBAAuB,YAAW,UAAU;IACvD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,OAAO,CAAgD;IAC/D,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAM;gBAEH,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IAqB9F,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA4BlD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAUnC,OAAO,CAAC,IAAI;IAmBZ,OAAO,CAAC,IAAI;IAOZ,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,OAAO;CAWhB"}

package/dist/brokers/mcps/ChildProcessMcpChannel.js

@@ -0,0 +1,126 @@
+import spawn from "cross-spawn";
+// A Model Context Protocol server as a child process.
+//
+// Argv only, never a shell string: a shell string is a sentence somebody else's quoting rules
+// parse, and the difference between an argument and a command is one character in a configuration
+// file the user pasted from a README.
+//
+// Started through cross-spawn rather than the platform's own spawn, because the servers people
+// actually run are not programs. `npx some-server` is a script: a shell script on Unix, a batch
+// shim on Windows, and Windows will not start a batch shim without a command interpreter in front
+// of it. Writing that interpreter line by hand is where the quoting rules above turn into a
+// vulnerability, so the argv goes to a library that has already solved it and the rule holds: what
+// this class hands over is still a list of arguments, never a sentence.
+//
+// Its standard error is left alone rather than read. Servers log there, and a client that mixed it
+// into the protocol stream would be parsing somebody's warning as an answer.
+export class ChildProcessMcpChannel {
+    child;
+    lines = [];
+    waiting = null;
+    ended = false;
+    buffered = "";
+    constructor(argv, cwd, environment = {}) {
+        const [command, ...rest] = argv;
+        this.child = spawn(command ?? "", rest, {
+            cwd,
+            shell: false,
+            env: { ...process.env, ...environment },
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        this.child.stdout.setEncoding("utf8");
+        this.child.stdout.on("data", (chunk) => this.take(chunk));
+        this.child.once("close", () => this.stop());
+        this.child.once("error", () => this.stop());
+        // A started server is not a reason for this process to stay open. A child and its three pipes
+        // are four handles Node will wait on, so a run that printed its answer a minute ago would still
+        // be sitting there, and the person would reach for Ctrl+C to end something that had finished.
+        this.release();
+    }
+    async send(line) {
+        await new Promise((resolve) => {
+            this.child.stdin.write(`${line}\n`, () => resolve());
+        });
+    }
+    async next(signal) {
+        const already = this.lines.shift();
+        if (already !== undefined) {
+            return already;
+        }
+        if (this.ended) {
+            return null;
+        }
+        // Held for exactly as long as somebody is waiting for an answer. Letting go is right while the
+        // server is idle and wrong while a call is in flight: an agent that exited here would end
+        // mid-call and say nothing about it, which is worse than the hang it fixes.
+        this.takeHold();
+        return await new Promise((resolve) => {
+            this.waiting = (line) => {
+                this.release();
+                resolve(line);
+            };
+            // Stop reaches a call in flight rather than waiting for the turn to end, which is the whole
+            // point of handing the signal down this far.
+            signal?.addEventListener("abort", () => this.deliver(null), { once: true });
+        });
+    }
+    async close() {
+        this.child.stdin.end();
+        this.child.kill();
+        this.stop();
+        await Promise.resolve();
+    }
+    // Whole lines only. A chunk is whatever the pipe happened to hand over, and half a JSON-RPC
+    // message parses as nothing.
+    take(chunk) {
+        this.buffered += chunk;
+        for (;;) {
+            const at = this.buffered.indexOf("\n");
+            if (at === -1) {
+                return;
+            }
+            const line = this.buffered.slice(0, at).trimEnd();
+            this.buffered = this.buffered.slice(at + 1);
+            if (line.length > 0 && !this.deliver(line)) {
+                this.lines.push(line);
+            }
+        }
+    }
+    stop() {
+        this.ended = true;
+        this.deliver(null);
+    }
+    // Let go of the loop. The child keeps running and the pipes keep working; what changes is only
+    // whether Node considers this process to still have something to do.
+    release() {
+        this.child.unref();
+        for (const pipe of [this.child.stdin, this.child.stdout, this.child.stderr]) {
+            letGo(pipe);
+        }
+    }
+    // Take hold of it again, for as long as an answer is owed.
+    takeHold() {
+        this.child.ref();
+        takeHoldOf(this.child.stdout);
+    }
+    deliver(line) {
+        if (this.waiting === null) {
+            return false;
+        }
+        const resolve = this.waiting;
+        this.waiting = null;
+        resolve(line);
+        return true;
+    }
+}
+// A pipe's stdio stream is a socket, and a socket can be let go of. It is typed as a plain stream
+// though, because a child's stdio is not always a pipe, so the handle is asked for rather than
+// assumed: a stream that has none is a stream that was never holding the loop open.
+function letGo(stream) {
+    stream?.unref?.();
+}
+// The answer comes down standard output, so that is the one pipe worth holding the loop for.
+function takeHoldOf(stream) {
+    stream?.ref?.();
+}
+//# sourceMappingURL=ChildProcessMcpChannel.js.map

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

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

package/dist/brokers/mcps/CompositeMcpBroker.d.ts

@@ -0,0 +1,8 @@
+import type { McpBroker, McpTool } from "@hassanhabib/standard-agents";
+export declare class CompositeMcpBroker implements McpBroker {
+    private readonly brokers;
+    constructor(brokers: ReadonlyMap<string, McpBroker>);
+    listTools(): Promise<readonly McpTool[]>;
+    call(name: string, argumentsJson: string, signal?: AbortSignal): Promise<string>;
+}
+//# sourceMappingURL=CompositeMcpBroker.d.ts.map

package/dist/brokers/mcps/CompositeMcpBroker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompositeMcpBroker.d.ts","sourceRoot":"","sources":["../../../src/brokers/mcps/CompositeMcpBroker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAUvE,qBAAa,kBAAmB,YAAW,SAAS;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;gBAEtC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC;IAI7C,SAAS,IAAI,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC;IAcxC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;CAW9F"}

package/dist/brokers/mcps/CompositeMcpBroker.js

@@ -0,0 +1,41 @@
+// Every server a machine was told about, as one catalogue (PLAN.md 2.8).
+//
+// The engine asks one broker what tools exist and hands one broker a call. A machine with three
+// servers has three brokers, and deciding which of them a call belongs to is this line's job:
+// the name carries the server it came from, so a call goes back to the server that offered it.
+//
+// A server that cannot be reached takes its own tools out of the catalogue and leaves the rest
+// alone. One broken server should cost the model that server's tools, not all of them.
+export class CompositeMcpBroker {
+    brokers;
+    constructor(brokers) {
+        this.brokers = brokers;
+    }
+    async listTools() {
+        const tools = [];
+        for (const broker of this.brokers.values()) {
+            try {
+                tools.push(...(await broker.listTools()));
+            }
+            catch {
+                continue;
+            }
+        }
+        return tools;
+    }
+    async call(name, argumentsJson, signal) {
+        const broker = this.brokers.get(serverOf(name));
+        // A name nothing offered. The model made it up, or a server went away between the listing and
+        // the call, and either way saying so is better than calling something else.
+        if (broker === undefined) {
+            return `[external '${name}' not configured]`;
+        }
+        return await broker.call(name, argumentsJson, signal);
+    }
+}
+// The part before the separator the stdio broker put there when it listed the tool.
+function serverOf(name) {
+    const at = name.indexOf("__");
+    return at === -1 ? name : name.slice(0, at);
+}
+//# sourceMappingURL=CompositeMcpBroker.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CompositeMcpBroker.js","sourceRoot":"","sources":["../../../src/brokers/mcps/CompositeMcpBroker.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,EAAE;AACF,gGAAgG;AAChG,8FAA8F;AAC9F,+FAA+F;AAC/F,EAAE;AACF,+FAA+F;AAC/F,uFAAuF;AACvF,MAAM,OAAO,kBAAkB;IACZ,OAAO,CAAiC;IAEzD,YAAmB,OAAuC;QACxD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAEM,KAAK,CAAC,SAAS;QACpB,MAAM,KAAK,GAAc,EAAE,CAAC;QAE5B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,IAAI,CAAC;gBACH,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;YAC5C,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,aAAqB,EAAE,MAAoB;QACzE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAEhD,8FAA8F;QAC9F,4EAA4E;QAC5E,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,cAAc,IAAI,mBAAmB,CAAC;QAC/C,CAAC;QAED,OAAO,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;IACxD,CAAC;CACF;AAED,oFAAoF;AACpF,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC9C,CAAC"}

package/dist/brokers/mcps/McpChannel.d.ts

@@ -0,0 +1,6 @@
+export interface McpChannel {
+    send(line: string): Promise<void>;
+    next(signal?: AbortSignal): Promise<string | null>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=McpChannel.d.ts.map

package/dist/brokers/mcps/McpChannel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpChannel.d.ts","sourceRoot":"","sources":["../../../src/brokers/mcps/McpChannel.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,UAAU;IAEzB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAIlC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAEnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/dist/brokers/mcps/McpChannel.js

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

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

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

package/dist/brokers/mcps/StdioMcpBroker.d.ts

@@ -0,0 +1,16 @@
+import type { McpBroker, McpTool } from "@hassanhabib/standard-agents";
+import type { McpChannel } from "./McpChannel.js";
+export declare const MCP_PROTOCOL_VERSION = "2024-11-05";
+export declare class StdioMcpBroker implements McpBroker {
+    private readonly channel;
+    private readonly name;
+    private nextId;
+    private handshake;
+    constructor(channel: McpChannel, name: string);
+    listTools(): Promise<readonly McpTool[]>;
+    call(name: string, argumentsJson: string, signal?: AbortSignal): Promise<string>;
+    private initialize;
+    private shakeHands;
+    private request;
+}
+//# sourceMappingURL=StdioMcpBroker.d.ts.map

package/dist/brokers/mcps/StdioMcpBroker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StdioMcpBroker.d.ts","sourceRoot":"","sources":["../../../src/brokers/mcps/StdioMcpBroker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAGvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAWlD,eAAO,MAAM,oBAAoB,eAAe,CAAC;AAEjD,qBAAa,cAAe,YAAW,SAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,SAAS,CAA8B;gBAE5B,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM;IAKvC,SAAS,IAAI,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC;IAexC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;YAc/E,UAAU;YAMV,UAAU;YAYV,OAAO;CA+BtB"}