@masons/agent-network 0.5.27 → 0.5.29

package/dist/broker-client/broker-client.d.ts

@@ -0,0 +1,64 @@
+import { EventEmitter } from "node:events";
+import { type InitializeResponseBody } from "../broker/version-handshake.js";
+export interface BrokerClientDiscoverOptions {
+    accountId: string;
+    runtimeToken: string;
+    userDataDir?: string;
+    env?: Record<string, string>;
+    timeoutMs?: number;
+    brokerEntry?: string;
+    nodeBinary?: string;
+}
+export interface BrokerClientConnectOptions {
+    pluginPid: number;
+    clientKind: string;
+    clientVersion: string;
+}
+export interface RegisterEndpointArgs {
+    agentId: string;
+    kind: string;
+    sessionName?: string;
+    workspace?: string;
+    trackingRef?: string;
+    taskHint?: string;
+}
+export interface RegisterEndpointOutcome {
+    endpoint_id: string;
+}
+export interface BrokerInboundMessage {
+    from: string;
+    content: string;
+    contentType: string;
+    metadata?: Record<string, unknown>;
+}
+type Events = {
+    message_received: (msg: BrokerInboundMessage) => void;
+    disconnected: () => void;
+    error: (err: Error) => void;
+};
+export declare class BrokerClient extends EventEmitter {
+    private readonly handle;
+    private ws;
+    private pluginPid;
+    private _sessionId;
+    private constructor();
+    static discover(opts: BrokerClientDiscoverOptions): Promise<BrokerClient>;
+    get spawnedNew(): boolean;
+    get ipcUrl(): string;
+    get sessionId(): string | null;
+    connect(opts: BrokerClientConnectOptions): Promise<InitializeResponseBody>;
+    registerEndpoint(args: RegisterEndpointArgs): Promise<RegisterEndpointOutcome>;
+    send(endpointId: string, to: string, content: string, contentType?: string, metadata?: Record<string, unknown>): Promise<{
+        messageId: string;
+        status: string;
+    }>;
+    close(endpointId?: string): Promise<void>;
+    on<K extends keyof Events>(event: K, listener: Events[K]): this;
+    on(event: string | symbol, listener: (...args: unknown[]) => void): this;
+    emit<K extends keyof Events>(event: K, ...args: Parameters<Events[K]>): boolean;
+    emit(event: string | symbol, ...args: unknown[]): boolean;
+    private httpJson;
+    private handleFrame;
+}
+export {};
+//# sourceMappingURL=broker-client.d.ts.map

package/dist/broker-client/broker-client.d.ts.map

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

package/dist/broker-client/broker-client.js

@@ -0,0 +1,164 @@
+import { EventEmitter } from "node:events";
+import WebSocket from "ws";
+import { resolveBrokerPaths } from "../broker/paths.js";
+import { IPC_PROTOCOL_VERSION, } from "../broker/version-handshake.js";
+import { discoverBroker } from "./lazy-spawn.js";
+export class BrokerClient extends EventEmitter {
+    handle;
+    ws = null;
+    pluginPid = null;
+    _sessionId = null;
+    constructor(handle) {
+        super();
+        this.handle = handle;
+    }
+    static async discover(opts) {
+        const paths = resolveBrokerPaths(opts.accountId, opts.runtimeToken, {
+            userDataDir: opts.userDataDir,
+        });
+        const handle = await discoverBroker({
+            discoveryFile: paths.discoveryFile,
+            timeoutMs: opts.timeoutMs,
+            brokerEntry: opts.brokerEntry,
+            nodeBinary: opts.nodeBinary,
+            env: {
+                MASONS_BROKER_ACCOUNT_ID: opts.accountId,
+                ...(opts.userDataDir
+                    ? { MASONS_BROKER_USER_DATA: opts.userDataDir }
+                    : {}),
+                ...(opts.env ?? {}),
+            },
+        });
+        return new BrokerClient(handle);
+    }
+    get spawnedNew() {
+        return this.handle.spawned;
+    }
+    get ipcUrl() {
+        return this.handle.record.ipcUrl;
+    }
+    get sessionId() {
+        return this._sessionId;
+    }
+    async connect(opts) {
+        if (this.ws) {
+            throw new Error("BrokerClient already connected");
+        }
+        this.pluginPid = opts.pluginPid;
+        const initRes = await this.httpJson("POST", "/v1/initialize", {
+            client_protocol_version: IPC_PROTOCOL_VERSION,
+            client_kind: opts.clientKind,
+            client_version: opts.clientVersion,
+            capabilities: { endpoint_metadata_v1: true },
+        });
+        this._sessionId = initRes.session_id;
+        const wsUrl = `${this.handle.record.ipcUrl.replace(/^http/, "ws")}/v1/stream`;
+        const ws = new WebSocket(wsUrl, {
+            headers: {
+                Authorization: `Bearer ${this.handle.record.bearerToken}`,
+                "x-plugin-pid": String(opts.pluginPid),
+            },
+        });
+        this.ws = ws;
+        await new Promise((resolve, reject) => {
+            const onOpen = () => {
+                ws.off("error", onError);
+                resolve();
+            };
+            const onError = (err) => {
+                ws.off("open", onOpen);
+                reject(err);
+            };
+            ws.once("open", onOpen);
+            ws.once("error", onError);
+        });
+        ws.on("message", (data) => this.handleFrame(data.toString()));
+        ws.on("close", () => {
+            this.ws = null;
+            this.emit("disconnected");
+        });
+        ws.on("error", (err) => this.emit("error", err));
+        return initRes;
+    }
+    async registerEndpoint(args) {
+        if (this.pluginPid === null) {
+            throw new Error("BrokerClient.connect must be called before registerEndpoint");
+        }
+        return this.httpJson("POST", "/v1/endpoint/register", {
+            agent_id: args.agentId,
+            plugin_pid: this.pluginPid,
+            kind: args.kind,
+            session_name: args.sessionName,
+            workspace: args.workspace,
+            tracking_ref: args.trackingRef,
+            task_hint: args.taskHint,
+        });
+    }
+    async send(endpointId, to, content, contentType = "text", metadata) {
+        return this.httpJson("POST", "/v1/send", {
+            endpoint_id: endpointId,
+            to,
+            content,
+            contentType,
+            metadata,
+        });
+    }
+    async close(endpointId) {
+        if (endpointId) {
+            try {
+                await this.httpJson("DELETE", `/v1/endpoint/${encodeURIComponent(endpointId)}`);
+            }
+            catch {
+            }
+        }
+        if (this.ws &&
+            (this.ws.readyState === WebSocket.OPEN ||
+                this.ws.readyState === WebSocket.CONNECTING)) {
+            this.ws.close(1000, "client_close");
+        }
+        this.ws = null;
+    }
+    on(event, listener) {
+        return super.on(event, listener);
+    }
+    emit(event, ...args) {
+        return super.emit(event, ...args);
+    }
+    async httpJson(method, path, body) {
+        const res = await fetch(`${this.handle.record.ipcUrl}${path}`, {
+            method,
+            headers: {
+                Authorization: `Bearer ${this.handle.record.bearerToken}`,
+                ...(body ? { "Content-Type": "application/json" } : {}),
+            },
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!res.ok) {
+            const errText = await res.text().catch(() => "");
+            throw new Error(`broker ${method} ${path} failed: ${res.status} ${errText}`);
+        }
+        return (await res.json());
+    }
+    handleFrame(raw) {
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            this.emit("error", new Error("BrokerClient received non-JSON frame"));
+            return;
+        }
+        if (!parsed || typeof parsed !== "object" || !("event" in parsed))
+            return;
+        const event = parsed.event;
+        if (event === "message_received") {
+            const msg = parsed;
+            this.emit("message_received", {
+                from: msg.from,
+                content: msg.content,
+                contentType: msg.contentType,
+                metadata: msg.metadata,
+            });
+        }
+    }
+}

package/dist/broker-client/lazy-spawn.d.ts

@@ -0,0 +1,18 @@
+import { type DiscoveryRecord } from "../broker/discovery-file.js";
+export interface LazySpawnOptions {
+    brokerEntry?: string;
+    env?: Record<string, string>;
+    nodeBinary?: string;
+}
+export interface DiscoverOptions extends LazySpawnOptions {
+    discoveryFile: string;
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+    forceSpawn?: boolean;
+}
+export interface DiscoveryHandle {
+    record: DiscoveryRecord;
+    spawned: boolean;
+}
+export declare function discoverBroker(opts: DiscoverOptions): Promise<DiscoveryHandle>;
+//# sourceMappingURL=lazy-spawn.d.ts.map

package/dist/broker-client/lazy-spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy-spawn.d.ts","sourceRoot":"","sources":["../../src/broker-client/lazy-spawn.ts"],"names":[],"mappings":"AA0CA,OAAO,EACL,KAAK,eAAe,EAErB,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,gBAAgB;IAE/B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IAEvD,aAAa,EAAE,MAAM,CAAC;IAEtB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,eAAe,CAAC;IAExB,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD,wBAAsB,cAAc,CAClC,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,eAAe,CAAC,CA8B1B"}

package/dist/broker-client/lazy-spawn.js

@@ -0,0 +1,61 @@
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { readDiscoveryFile, } from "../broker/discovery-file.js";
+const DEFAULT_POLL_INTERVAL_MS = 100;
+const DEFAULT_DISCOVER_TIMEOUT_MS = 5_000;
+const DEFAULT_HEALTH_TIMEOUT_MS = 2_000;
+export async function discoverBroker(opts) {
+    const deadline = Date.now() + (opts.timeoutMs ?? DEFAULT_DISCOVER_TIMEOUT_MS);
+    const poll = opts.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    if (!opts.forceSpawn) {
+        const existing = readDiscoveryFile(opts.discoveryFile);
+        if (existing &&
+            (await probeHealth(existing.ipcUrl, existing.bearerToken))) {
+            return { record: existing, spawned: false };
+        }
+    }
+    spawnDaemon(opts);
+    while (Date.now() < deadline) {
+        const rec = readDiscoveryFile(opts.discoveryFile);
+        if (rec && (await probeHealth(rec.ipcUrl, rec.bearerToken))) {
+            return { record: rec, spawned: true };
+        }
+        await sleep(poll);
+    }
+    throw new Error(`broker did not become healthy within ${opts.timeoutMs ?? DEFAULT_DISCOVER_TIMEOUT_MS}ms; ` +
+        `check ${opts.discoveryFile} and the daemon log`);
+}
+function spawnDaemon(opts) {
+    const entry = opts.brokerEntry ?? resolveDefaultBrokerEntry();
+    const child = spawn(opts.nodeBinary ?? process.execPath, [entry], {
+        detached: true,
+        stdio: "ignore",
+        windowsHide: true,
+        env: { ...process.env, ...(opts.env ?? {}) },
+    });
+    child.unref();
+}
+function resolveDefaultBrokerEntry() {
+    const self = fileURLToPath(import.meta.url);
+    return self.replace(/broker-client\/lazy-spawn\.(c?js|ts)$/, "broker/entry.$1");
+}
+async function probeHealth(ipcUrl, bearerToken) {
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), DEFAULT_HEALTH_TIMEOUT_MS);
+    try {
+        const res = await fetch(`${ipcUrl}/health`, {
+            headers: { Authorization: `Bearer ${bearerToken}` },
+            signal: ctrl.signal,
+        });
+        return res.ok;
+    }
+    catch {
+        return false;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}

package/dist/runtime-endpoint-client.d.ts

@@ -9,7 +9,7 @@ export interface WorkspaceMetadata {
 }
 export type ShareWithPeerField = "workspace" | "tracking_ref" | "runtime_session_id" | "fingerprint" | (string & {});
 export interface RegisterRuntimeEndpointParams {
-    as: string;
+    as?: string;
     runtime_kind: RuntimeKind;
     runtime_session_id?: string;
     endpoint_nonce: string;
@@ -51,7 +51,7 @@ export type HeartbeatRuntimeEndpointResponse = Record<string, unknown>;
 export type UnregisterRuntimeEndpointResponse = Record<string, unknown>;
 export declare function registerRuntimeEndpoint(cfg: PlatformClientConfig, runtimeKey: string, params: RegisterRuntimeEndpointParams): Promise<RegisterRuntimeEndpointResponse>;
 export declare function heartbeatRuntimeEndpoint(cfg: PlatformClientConfig, runtimeKey: string, endpointId: string): Promise<HeartbeatRuntimeEndpointResponse>;
-export declare function unregisterRuntimeEndpoint(cfg: PlatformClientConfig, runtimeKey: string, endpointId: string, asNodeId: string): Promise<UnregisterRuntimeEndpointResponse>;
+export declare function unregisterRuntimeEndpoint(cfg: PlatformClientConfig, runtimeKey: string, endpointId: string, asNodeId?: string): Promise<UnregisterRuntimeEndpointResponse>;
 export declare function listOwnedRuntimeEndpoints(cfg: PlatformClientConfig, runtimeKey: string, asNodeId: string): Promise<ListOwnedRuntimeEndpointsResponse>;
 export declare function getOwnedRuntimeEndpoint(cfg: PlatformClientConfig, runtimeKey: string, endpointId: string, asNodeId: string): Promise<OwnedRuntimeEndpointView>;
 //# sourceMappingURL=runtime-endpoint-client.d.ts.map

package/dist/runtime-endpoint-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-endpoint-client.d.ts","sourceRoot":"","sources":["../src/runtime-endpoint-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime-endpoint-client.d.ts","sourceRoot":"","sources":["../src/runtime-endpoint-client.ts"],"names":[],"mappings":"AAuBA,OAAO,EACL,gBAAgB,EAChB,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAM9B,OAAO,EAAE,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,CAAC;AAmBvD,MAAM,MAAM,WAAW,GACnB,aAAa,GACb,UAAU,GACV,OAAO,GACP,UAAU,GACV,QAAQ,GACR,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAalB,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAeD,MAAM,MAAM,kBAAkB,GAC1B,WAAW,GACX,cAAc,GACd,oBAAoB,GACpB,aAAa,GACb,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAUlB,MAAM,WAAW,6BAA6B;IAQ5C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,WAAW,CAAC;IAO1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,cAAc,EAAE,MAAM,CAAC;IAEvB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAE9B,YAAY,CAAC,EAAE,MAAM,CAAC;IAKtB,eAAe,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACxC;AAcD,MAAM,WAAW,+BAA+B;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB,EAAE,MAAM,CAAC;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;CACvB;AAeD,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IAKpB,OAAO,EAAE,MAAM,CAAC;IAUhB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,WAAW,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAQ5B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IAYtB,WAAW,CAAC,EAAE;QACZ,uBAAuB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAClD,CAAC;IACF,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IAOpB,OAAO,EAAE,OAAO,CAAC;CAClB;AASD,MAAM,WAAW,iCAAiC;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,wBAAwB,EAAE,CAAC;CACnC;AAUD,MAAM,MAAM,gCAAgC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAQvE,MAAM,MAAM,iCAAiC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA4DxE,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,oBAAoB,EACzB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,6BAA6B,GACpC,OAAO,CAAC,+BAA+B,CAAC,CAQ1C;AAiBD,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,oBAAoB,EACzB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,gCAAgC,CAAC,CAY3C;AAcD,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,oBAAoB,EACzB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,iCAAiC,CAAC,CAc5C;AAgBD,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,oBAAoB,EACzB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,iCAAiC,CAAC,CAO5C;AAWD,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,oBAAoB,EACzB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,wBAAwB,CAAC,CAUnC"}

package/dist/runtime-endpoint-client.js

@@ -41,8 +41,10 @@ export async function heartbeatRuntimeEndpoint(cfg, runtimeKey, endpointId) {
         {});
 }
 export async function unregisterRuntimeEndpoint(cfg, runtimeKey, endpointId, asNodeId) {
-    const query = new URLSearchParams({ as: asNodeId }).toString();
-    const res = await fetch(`${baseUrl(cfg)}/runtime-endpoints/${encodeURIComponent(endpointId)}?${query}`, {
+    const query = asNodeId
+        ? `?${new URLSearchParams({ as: asNodeId }).toString()}`
+        : "";
+    const res = await fetch(`${baseUrl(cfg)}/runtime-endpoints/${encodeURIComponent(endpointId)}${query}`, {
         method: "DELETE",
         headers: authHeaders(runtimeKey),
     });

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAqEA,UAAU,WAAW;IACnB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,CACP,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,OAAO,CAAC,WAAW,CAAC,CAAC;CAC3B;AAED,UAAU,WAAW;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,KAAK,WAAW,GAAG,CAAC,GAAG,EAAE,WAAW,KAAK,cAAc,GAAG,IAAI,GAAG,SAAS,CAAC;AAE3E,UAAU,OAAO;IACf,YAAY,CACV,IAAI,EAAE,cAAc,GAAG,WAAW,EAClC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,IAAI,CAAC;CACT;AAmCD,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C;AAqRD,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CA80BhD"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAqEA,UAAU,WAAW;IACnB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,CACP,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,OAAO,CAAC,WAAW,CAAC,CAAC;CAC3B;AAED,UAAU,WAAW;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,KAAK,WAAW,GAAG,CAAC,GAAG,EAAE,WAAW,KAAK,cAAc,GAAG,IAAI,GAAG,SAAS,CAAC;AAE3E,UAAU,OAAO;IACf,YAAY,CACV,IAAI,EAAE,cAAc,GAAG,WAAW,EAClC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,IAAI,CAAC;CACT;AAoDD,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C;AAqRD,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAuzBhD"}

package/dist/tools.js

@@ -9,16 +9,13 @@ import { sentMessageBuffer } from "./sent-message-buffer.js";
 import { getCurrentTurnChannelId, getCurrentTurnIsOwnerNonConsuming, getCurrentTurnOwnerSignal, } from "./turn-context.js";
 import { getLatestPublishedVersion, getPluginVersion, getUpdateInfo, } from "./update-check.js";
 const PROFILE_FIELDS = new Set(["name", "scope", "about", "audience"]);
-const UPGRADE_CMD = "openclaw plugins update agent-network";
 const GATEWAY_RESTART_CMD = "openclaw gateway restart";
-function reinstallCmd(version) {
+function upgradeCmd(version) {
     return `openclaw plugins install @masons/agent-network@${version} --force`;
 }
 const SEMVER_RE = /^\d+\.\d+\.\d+$/;
-let upgradeAttemptedVersion = null;
 export function _resetToolsForTesting() {
     updateNoticeShown = false;
-    upgradeAttemptedVersion = null;
     _resetChannelSetupForTesting();
 }
 function textResult(text) {
@@ -598,7 +595,7 @@ export function registerTools(api) {
     });
     api.registerTool({
         name: "masons_upgrade",
-        description: "Check for and install plugin updates via `openclaw plugins update`. Do not use ClawHub (it distributes skills, not plugins).",
+        description: "Check for and install plugin updates. Emits an `openclaw plugins install ...@<version> --force` command pinned to the live npm `latest` value — the command carries full advance-to-latest semantics on its own, independent of OpenClaw's plugin-manager version-resolution path. Do not use ClawHub (it distributes skills, not plugins).",
         parameters: Type.Object({}),
         execute: async () => {
             const pendingNotes = ownerNotesQueue.size();
@@ -612,37 +609,21 @@ export function registerTools(api) {
                 return textResult("Could not check for updates (network issue). Try again later.");
             }
             if (latestVersion === currentVersion) {
-                upgradeAttemptedVersion = null;
                 return textResult(`You're on the latest version (v${currentVersion}). No update needed.`);
             }
             if (!SEMVER_RE.test(latestVersion)) {
                 return textResult(`Registry returned an unexpected version format: "${latestVersion}". Try again later.`);
             }
-            const useFallback = upgradeAttemptedVersion === latestVersion;
-            if (useFallback) {
-                upgradeAttemptedVersion = null;
-                const fallbackCmd = reinstallCmd(latestVersion);
-                return textResult([
-                    `Update to v${latestVersion} — reinstall through OpenClaw (the normal update command may not have detected the new version).`,
-                    "",
-                    "Run this command using the exec tool:",
-                    fallbackCmd,
-                    "",
-                    `Then restart the gateway using the gateway tool.`,
-                    `If you cannot run commands, tell the user to run in Terminal:`,
-                    `${fallbackCmd} && ${GATEWAY_RESTART_CMD}`,
-                ].join("\n"));
-            }
-            upgradeAttemptedVersion = latestVersion;
+            const cmd = upgradeCmd(latestVersion);
             return textResult([
                 `Update available: v${currentVersion} → v${latestVersion}`,
                 "",
                 "Run this command using the exec tool:",
-                UPGRADE_CMD,
+                cmd,
                 "",
                 "Then restart the gateway using the gateway tool.",
                 "If you cannot run commands, tell the user to run in Terminal:",
-                `${UPGRADE_CMD} && ${GATEWAY_RESTART_CMD}`,
+                `${cmd} && ${GATEWAY_RESTART_CMD}`,
             ].join("\n"));
         },
     });

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const PLUGIN_VERSION = "0.5.27";
+export declare const PLUGIN_VERSION = "0.5.29";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1 +1 @@
-export const PLUGIN_VERSION = "0.5.27";
+export const PLUGIN_VERSION = "0.5.29";

package/package.json

@@ -1,16 +1,18 @@
 {
   "name": "@masons/agent-network",
-  "version": "0.5.27",
-  "description": "MASONS plugin for OpenClaw — connect your agent to the agent network",
+  "version": "0.5.29",
+  "description": "MASONS Agent Network — connects agent runtimes to the Agent Network over MSTP. Ships an OpenClaw channel plugin (root export) and subpath exports consumed by the Claude Code plugin today (planned: Codex and future hosts).",
   "license": "MIT",
   "author": "MASONS.ai <hello@masons.ai> (https://masons.ai)",
   "homepage": "https://masons.ai",
   "keywords": [
     "mstp",
-    "openclaw",
+    "agent-network",
     "agent",
     "agent-to-agent",
-    "masons"
+    "masons",
+    "openclaw",
+    "claude-code"
   ],
   "engines": {
     "node": ">=20.10"
@@ -63,12 +65,21 @@
     "./handoff": {
       "types": "./dist/handoff.d.ts",
       "default": "./dist/handoff.js"
+    },
+    "./broker": {
+      "types": "./dist/broker/entry.d.ts",
+      "default": "./dist/broker/entry.js"
+    },
+    "./broker/client": {
+      "types": "./dist/broker-client/broker-client.d.ts",
+      "default": "./dist/broker-client/broker-client.js"
     }
   },
   "dependencies": {
     "@clack/prompts": "^1.2.0",
     "@sinclair/typebox": "^0.34",
     "debug": "^4.4.3",
+    "env-paths": "^3.0.0",
     "ws": "8.18.3"
   },
   "devDependencies": {
@@ -81,7 +92,7 @@
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
-    "test": "tsc -p test/tsconfig.json && node --test --loader ts-node/esm test/**/*.test.ts",
+    "test": "tsc -p test/tsconfig.json && node --test --loader ts-node/esm 'test/**/*.test.ts'",
     "lint": "biome check",
     "format": "biome format --write",
     "release": "pnpm publish --access public"