agent-relay 2.2.24 → 2.3.1

package/packages/sdk-ts/dist/client.js

@@ -0,0 +1,360 @@
+import { once } from "node:events";
+import { spawn } from "node:child_process";
+import { createInterface } from "node:readline";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { PROTOCOL_VERSION, } from "./protocol.js";
+export class AgentRelayProtocolError extends Error {
+    code;
+    retryable;
+    data;
+    constructor(payload) {
+        super(payload.message);
+        this.name = "AgentRelayProtocolError";
+        this.code = payload.code;
+        this.retryable = payload.retryable;
+        this.data = payload.data;
+    }
+}
+export class AgentRelayProcessError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "AgentRelayProcessError";
+    }
+}
+export class AgentRelayClient {
+    options;
+    child;
+    stdoutRl;
+    stderrRl;
+    requestSeq = 0;
+    pending = new Map();
+    startingPromise;
+    eventListeners = new Set();
+    stderrListeners = new Set();
+    exitPromise;
+    constructor(options = {}) {
+        this.options = {
+            binaryPath: options.binaryPath ?? resolveDefaultBinaryPath(),
+            binaryArgs: options.binaryArgs ?? [],
+            brokerName: options.brokerName ?? "broker",
+            channels: options.channels ?? ["general"],
+            cwd: options.cwd ?? process.cwd(),
+            env: options.env ?? process.env,
+            requestTimeoutMs: options.requestTimeoutMs ?? 10_000,
+            shutdownTimeoutMs: options.shutdownTimeoutMs ?? 3_000,
+            clientName: options.clientName ?? "@agent-relay/sdk-ts",
+            clientVersion: options.clientVersion ?? "0.1.0",
+        };
+    }
+    static async start(options = {}) {
+        const client = new AgentRelayClient(options);
+        await client.start();
+        return client;
+    }
+    onEvent(listener) {
+        this.eventListeners.add(listener);
+        return () => {
+            this.eventListeners.delete(listener);
+        };
+    }
+    onBrokerStderr(listener) {
+        this.stderrListeners.add(listener);
+        return () => {
+            this.stderrListeners.delete(listener);
+        };
+    }
+    async start() {
+        if (this.child) {
+            return;
+        }
+        if (this.startingPromise) {
+            return this.startingPromise;
+        }
+        this.startingPromise = this.startInternal();
+        try {
+            await this.startingPromise;
+        }
+        finally {
+            this.startingPromise = undefined;
+        }
+    }
+    async spawnPty(input) {
+        await this.start();
+        const agent = {
+            name: input.name,
+            runtime: "pty",
+            cli: input.cli,
+            args: input.args ?? [],
+            channels: input.channels ?? [],
+        };
+        const result = await this.requestOk("spawn_agent", {
+            agent,
+        });
+        return result;
+    }
+    async spawnHeadlessClaude(input) {
+        await this.start();
+        const agent = {
+            name: input.name,
+            runtime: "headless_claude",
+            args: input.args ?? [],
+            channels: input.channels ?? [],
+        };
+        const result = await this.requestOk("spawn_agent", {
+            agent,
+        });
+        return result;
+    }
+    async release(name) {
+        await this.start();
+        return this.requestOk("release_agent", { name });
+    }
+    async sendMessage(input) {
+        await this.start();
+        try {
+            return await this.requestOk("send_message", {
+                to: input.to,
+                text: input.text,
+                from: input.from,
+                thread_id: input.threadId,
+                priority: input.priority,
+            });
+        }
+        catch (error) {
+            if (error instanceof AgentRelayProtocolError && error.code === "unsupported_operation") {
+                return { event_id: "unsupported_operation", targets: [] };
+            }
+            throw error;
+        }
+    }
+    async listAgents() {
+        await this.start();
+        const result = await this.requestOk("list_agents", {});
+        return result.agents;
+    }
+    async getStatus() {
+        await this.start();
+        return this.requestOk("get_status", {});
+    }
+    async shutdown() {
+        if (!this.child) {
+            return;
+        }
+        try {
+            await this.requestOk("shutdown", {});
+        }
+        catch {
+            // Continue shutdown path if broker is already unhealthy.
+        }
+        const child = this.child;
+        const wait = this.exitPromise ?? Promise.resolve();
+        const timeout = setTimeout(() => {
+            if (!child.killed) {
+                child.kill("SIGTERM");
+            }
+        }, this.options.shutdownTimeoutMs);
+        try {
+            await wait;
+        }
+        finally {
+            clearTimeout(timeout);
+            if (this.child) {
+                this.child.kill("SIGKILL");
+            }
+        }
+    }
+    async waitForExit() {
+        if (!this.child) {
+            return;
+        }
+        await this.exitPromise;
+    }
+    async startInternal() {
+        const resolvedBinary = expandTilde(this.options.binaryPath);
+        if (isExplicitPath(this.options.binaryPath) && !fs.existsSync(resolvedBinary)) {
+            throw new AgentRelayProcessError(`broker binary not found: ${this.options.binaryPath}`);
+        }
+        const args = [
+            ...this.options.binaryArgs,
+            "init",
+            "--name",
+            this.options.brokerName,
+            "--channels",
+            this.options.channels.join(","),
+        ];
+        // Ensure the SDK bin directory (containing agent-relay + relay_send) is on
+        // PATH so spawned workers can find relay_send without any user setup.
+        const env = { ...this.options.env };
+        if (isExplicitPath(this.options.binaryPath)) {
+            const binDir = path.dirname(path.resolve(resolvedBinary));
+            const currentPath = env.PATH ?? env.Path ?? "";
+            if (!currentPath.split(path.delimiter).includes(binDir)) {
+                env.PATH = `${binDir}${path.delimiter}${currentPath}`;
+            }
+        }
+        const child = spawn(resolvedBinary, args, {
+            cwd: this.options.cwd,
+            env,
+            stdio: "pipe",
+        });
+        this.child = child;
+        this.stdoutRl = createInterface({ input: child.stdout, crlfDelay: Infinity });
+        this.stderrRl = createInterface({ input: child.stderr, crlfDelay: Infinity });
+        this.stdoutRl.on("line", (line) => {
+            this.handleStdoutLine(line);
+        });
+        this.stderrRl.on("line", (line) => {
+            for (const listener of this.stderrListeners) {
+                listener(line);
+            }
+        });
+        this.exitPromise = new Promise((resolve) => {
+            child.once("exit", (code, signal) => {
+                const error = new AgentRelayProcessError(`broker exited (code=${code ?? "null"}, signal=${signal ?? "null"})`);
+                this.failAllPending(error);
+                this.disposeProcessHandles();
+                resolve();
+            });
+            child.once("error", (error) => {
+                this.failAllPending(error);
+                this.disposeProcessHandles();
+                resolve();
+            });
+        });
+        await this.requestHello();
+    }
+    disposeProcessHandles() {
+        this.stdoutRl?.close();
+        this.stderrRl?.close();
+        this.stdoutRl = undefined;
+        this.stderrRl = undefined;
+        this.child = undefined;
+        this.exitPromise = undefined;
+    }
+    failAllPending(error) {
+        for (const pending of this.pending.values()) {
+            clearTimeout(pending.timeout);
+            pending.reject(error);
+        }
+        this.pending.clear();
+    }
+    handleStdoutLine(line) {
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            // Non-protocol output should not crash the SDK.
+            return;
+        }
+        if (!parsed || typeof parsed !== "object") {
+            return;
+        }
+        if (parsed.v !== PROTOCOL_VERSION || typeof parsed.type !== "string") {
+            return;
+        }
+        const envelope = {
+            v: parsed.v,
+            type: parsed.type,
+            request_id: parsed.request_id,
+            payload: parsed.payload,
+        };
+        if (envelope.type === "event") {
+            const payload = envelope.payload;
+            for (const listener of this.eventListeners) {
+                listener(payload);
+            }
+            return;
+        }
+        if (!envelope.request_id) {
+            return;
+        }
+        const pending = this.pending.get(envelope.request_id);
+        if (!pending) {
+            return;
+        }
+        if (envelope.type === "error") {
+            clearTimeout(pending.timeout);
+            this.pending.delete(envelope.request_id);
+            pending.reject(new AgentRelayProtocolError(envelope.payload));
+            return;
+        }
+        if (envelope.type !== pending.expectedType) {
+            clearTimeout(pending.timeout);
+            this.pending.delete(envelope.request_id);
+            pending.reject(new AgentRelayProcessError(`unexpected response type '${envelope.type}' for request '${envelope.request_id}' (expected '${pending.expectedType}')`));
+            return;
+        }
+        clearTimeout(pending.timeout);
+        this.pending.delete(envelope.request_id);
+        pending.resolve(envelope);
+    }
+    async requestHello() {
+        const payload = {
+            client_name: this.options.clientName,
+            client_version: this.options.clientVersion,
+        };
+        const frame = await this.sendRequest("hello", payload, "hello_ack");
+        return frame.payload;
+    }
+    async requestOk(type, payload) {
+        const frame = await this.sendRequest(type, payload, "ok");
+        const result = frame.payload;
+        return result.result;
+    }
+    async sendRequest(type, payload, expectedType) {
+        if (!this.child) {
+            throw new AgentRelayProcessError("broker is not running");
+        }
+        const request_id = `req_${++this.requestSeq}`;
+        const message = {
+            v: PROTOCOL_VERSION,
+            type,
+            request_id,
+            payload,
+        };
+        const responsePromise = new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                this.pending.delete(request_id);
+                reject(new AgentRelayProcessError(`request timed out after ${this.options.requestTimeoutMs}ms (type='${type}', request_id='${request_id}')`));
+            }, this.options.requestTimeoutMs);
+            this.pending.set(request_id, {
+                expectedType,
+                resolve,
+                reject,
+                timeout,
+            });
+        });
+        const line = `${JSON.stringify(message)}\n`;
+        if (!this.child.stdin.write(line)) {
+            await once(this.child.stdin, "drain");
+        }
+        return responsePromise;
+    }
+}
+function expandTilde(p) {
+    if (p === "~" || p.startsWith("~/") || p.startsWith("~\\")) {
+        const home = os.homedir();
+        return path.join(home, p.slice(2));
+    }
+    return p;
+}
+function isExplicitPath(binaryPath) {
+    return (binaryPath.includes("/") ||
+        binaryPath.includes("\\") ||
+        binaryPath.startsWith(".") ||
+        binaryPath.startsWith("~"));
+}
+function resolveDefaultBinaryPath() {
+    const exe = process.platform === "win32" ? "agent-relay.exe" : "agent-relay";
+    const moduleDir = path.dirname(fileURLToPath(import.meta.url));
+    const bundled = path.resolve(moduleDir, "..", "bin", exe);
+    if (fs.existsSync(bundled)) {
+        return bundled;
+    }
+    return "agent-relay";
+}
+//# sourceMappingURL=client.js.map

package/packages/sdk-ts/dist/client.js.map

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

package/packages/sdk-ts/dist/consensus-helpers.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Consensus types and pure helper functions.
+ *
+ * This module has ZERO Node.js dependencies — safe for browser use.
+ * The ConsensusEngine class (which needs node:crypto and node:events)
+ * lives in consensus.ts.
+ */
+export type ConsensusType = "majority" | "supermajority" | "unanimous" | "weighted" | "quorum";
+export type VoteValue = "approve" | "reject" | "abstain";
+export type ProposalStatus = "pending" | "approved" | "rejected" | "expired" | "cancelled";
+export interface AgentWeight {
+    agent: string;
+    weight: number;
+    role?: string;
+}
+export interface Vote {
+    agent: string;
+    value: VoteValue;
+    weight: number;
+    reason?: string;
+    timestamp: number;
+}
+export interface Proposal {
+    id: string;
+    title: string;
+    description: string;
+    proposer: string;
+    consensusType: ConsensusType;
+    participants: string[];
+    quorum?: number;
+    threshold?: number;
+    weights?: AgentWeight[];
+    createdAt: number;
+    expiresAt: number;
+    status: ProposalStatus;
+    votes: Vote[];
+    result?: ConsensusResult;
+    metadata?: Record<string, unknown>;
+    thread?: string;
+}
+export interface ConsensusResult {
+    decision: "approved" | "rejected" | "no_consensus";
+    approveWeight: number;
+    rejectWeight: number;
+    abstainWeight: number;
+    participation: number;
+    quorumMet: boolean;
+    resolvedAt: number;
+    nonVoters: string[];
+}
+export interface ConsensusConfig {
+    /** Default proposal timeout in ms (default: 5 min) */
+    defaultTimeoutMs: number;
+    defaultConsensusType: ConsensusType;
+    /** Supermajority threshold (0–1, default 0.67) */
+    defaultThreshold: number;
+    allowVoteChange: boolean;
+    /** Auto-resolve when outcome is mathematically certain */
+    autoResolve: boolean;
+    /** Max resolved/expired/cancelled proposals to retain. Oldest are evicted
+     *  when this limit is exceeded. 0 = unlimited. Default: 100. */
+    maxRetainedProposals: number;
+}
+export interface ConsensusEvents {
+    "proposal:created": (proposal: Proposal) => void;
+    "proposal:voted": (proposal: Proposal, vote: Vote) => void;
+    "proposal:resolved": (proposal: Proposal, result: ConsensusResult) => void;
+    "proposal:expired": (proposal: Proposal) => void;
+    "proposal:cancelled": (proposal: Proposal) => void;
+}
+export interface ParsedProposalCommand {
+    title: string;
+    description: string;
+    participants: string[];
+    consensusType: ConsensusType;
+    timeoutMs?: number;
+    quorum?: number;
+    threshold?: number;
+}
+export declare function formatProposalMessage(proposal: Proposal): string;
+export declare function formatResultMessage(proposal: Proposal, result: ConsensusResult): string;
+export declare function parseVoteCommand(message: string): {
+    proposalId: string;
+    value: VoteValue;
+    reason?: string;
+} | null;
+export declare function isConsensusCommand(message: string): boolean;
+/**
+ * Parse a PROPOSE command from a relay message.
+ *
+ * Format:
+ * ```
+ * PROPOSE: Title of the proposal
+ * TYPE: majority|supermajority|unanimous|weighted|quorum
+ * PARTICIPANTS: Agent1, Agent2, Agent3
+ * DESCRIPTION: Detailed description
+ * TIMEOUT: 3600000 (optional, ms)
+ * QUORUM: 3 (optional)
+ * THRESHOLD: 0.67 (optional)
+ * ```
+ */
+export declare function parseProposalCommand(message: string): ParsedProposalCommand | null;
+//# sourceMappingURL=consensus-helpers.d.ts.map

package/packages/sdk-ts/dist/consensus-helpers.d.ts.map

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

package/packages/sdk-ts/dist/consensus-helpers.js

@@ -0,0 +1,147 @@
+/**
+ * Consensus types and pure helper functions.
+ *
+ * This module has ZERO Node.js dependencies — safe for browser use.
+ * The ConsensusEngine class (which needs node:crypto and node:events)
+ * lives in consensus.ts.
+ */
+// ── Pure helper functions (no Node.js deps) ──────────────────────────────────
+export function formatProposalMessage(proposal) {
+    return [
+        `PROPOSAL: ${proposal.title}`,
+        `ID: ${proposal.id}`,
+        `From: ${proposal.proposer}`,
+        `Type: ${proposal.consensusType}`,
+        `Expires: ${new Date(proposal.expiresAt).toISOString()}`,
+        "",
+        proposal.description,
+        "",
+        `Participants: ${proposal.participants.join(", ")}`,
+        "",
+        "Reply with: VOTE <proposal-id> <approve|reject|abstain> [reason]",
+    ].join("\n");
+}
+export function formatResultMessage(proposal, result) {
+    const lines = [
+        `CONSENSUS RESULT: ${proposal.title}`,
+        `Decision: ${result.decision.toUpperCase()}`,
+        `Participation: ${(result.participation * 100).toFixed(1)}%`,
+        "",
+        `Approve: ${result.approveWeight} | Reject: ${result.rejectWeight} | Abstain: ${result.abstainWeight}`,
+    ];
+    if (result.nonVoters.length > 0) {
+        lines.push(`Non-voters: ${result.nonVoters.join(", ")}`);
+    }
+    return lines.join("\n");
+}
+export function parseVoteCommand(message) {
+    const trimmed = message.trim();
+    if (!trimmed.toUpperCase().startsWith("VOTE "))
+        return null;
+    // Split into at most 4 parts: "VOTE", proposalId, value, reason...
+    const parts = trimmed.split(/\s+/);
+    if (parts.length < 3)
+        return null;
+    const proposalId = parts[1];
+    const rawValue = parts[2].toLowerCase();
+    if (rawValue !== "approve" && rawValue !== "reject" && rawValue !== "abstain") {
+        return null;
+    }
+    const reason = parts.length > 3 ? parts.slice(3).join(" ") : undefined;
+    return { proposalId, value: rawValue, reason };
+}
+export function isConsensusCommand(message) {
+    const trimmed = message.trim();
+    return trimmed.startsWith("PROPOSE:") || trimmed.toUpperCase().startsWith("VOTE ");
+}
+/**
+ * Parse a PROPOSE command from a relay message.
+ *
+ * Format:
+ * ```
+ * PROPOSE: Title of the proposal
+ * TYPE: majority|supermajority|unanimous|weighted|quorum
+ * PARTICIPANTS: Agent1, Agent2, Agent3
+ * DESCRIPTION: Detailed description
+ * TIMEOUT: 3600000 (optional, ms)
+ * QUORUM: 3 (optional)
+ * THRESHOLD: 0.67 (optional)
+ * ```
+ */
+export function parseProposalCommand(message) {
+    if (!message.trim().startsWith("PROPOSE:"))
+        return null;
+    const lines = message.split("\n").map((l) => l.trim());
+    let title;
+    let description;
+    let participants;
+    let consensusType = "majority";
+    let timeoutMs;
+    let quorum;
+    let threshold;
+    let inDescription = false;
+    const descriptionLines = [];
+    for (const line of lines) {
+        if (line.startsWith("PROPOSE:")) {
+            title = line.substring("PROPOSE:".length).trim();
+            inDescription = false;
+        }
+        else if (line.startsWith("TYPE:")) {
+            const type = line.substring("TYPE:".length).trim().toLowerCase();
+            if (["majority", "supermajority", "unanimous", "weighted", "quorum"].includes(type)) {
+                consensusType = type;
+            }
+            inDescription = false;
+        }
+        else if (line.startsWith("PARTICIPANTS:")) {
+            const str = line.substring("PARTICIPANTS:".length).trim();
+            participants = str
+                .split(",")
+                .map((p) => p.trim())
+                .filter((p) => p.length > 0);
+            inDescription = false;
+        }
+        else if (line.startsWith("DESCRIPTION:")) {
+            description = line.substring("DESCRIPTION:".length).trim();
+            inDescription = true;
+        }
+        else if (line.startsWith("TIMEOUT:")) {
+            const val = parseInt(line.substring("TIMEOUT:".length).trim(), 10);
+            if (!isNaN(val) && val > 0)
+                timeoutMs = val;
+            inDescription = false;
+        }
+        else if (line.startsWith("QUORUM:")) {
+            const val = parseInt(line.substring("QUORUM:".length).trim(), 10);
+            if (!isNaN(val) && val > 0)
+                quorum = val;
+            inDescription = false;
+        }
+        else if (line.startsWith("THRESHOLD:")) {
+            const val = parseFloat(line.substring("THRESHOLD:".length).trim());
+            if (!isNaN(val) && val > 0 && val <= 1)
+                threshold = val;
+            inDescription = false;
+        }
+        else if (inDescription && line.length > 0) {
+            descriptionLines.push(line);
+        }
+    }
+    if (descriptionLines.length > 0 && description) {
+        description = description + "\n" + descriptionLines.join("\n");
+    }
+    if (!title || !participants || participants.length === 0)
+        return null;
+    if (!description)
+        description = title;
+    return {
+        title,
+        description,
+        participants,
+        consensusType,
+        timeoutMs,
+        quorum,
+        threshold,
+    };
+}
+//# sourceMappingURL=consensus-helpers.js.map

package/packages/sdk-ts/dist/consensus-helpers.js.map

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