@agent-relay/factory 0.0.0 → 0.1.2

package/dist/fleet/ensure-relay-broker.d.ts

@@ -0,0 +1,24 @@
+import type { Logger } from '../ports/system.js';
+import type { HarnessDriverClientLike } from './internal-fleet-client.js';
+export interface EnsureRelayBrokerOptions {
+    cwd?: string;
+    connectionPath?: string;
+    autoStart?: boolean;
+    workspaceKey?: string;
+    logger?: Logger;
+    connect?: (options: {
+        cwd?: string;
+        connectionPath?: string;
+    }) => HarnessDriverClientLike;
+    spawn?: (options: {
+        cwd?: string;
+        workspaceKey?: string;
+    }) => Promise<HarnessDriverClientLike>;
+    env?: NodeJS.ProcessEnv;
+}
+export interface RelayBrokerHandle {
+    client: HarnessDriverClientLike;
+    started: boolean;
+}
+export declare function ensureRelayBroker(options?: EnsureRelayBrokerOptions): Promise<RelayBrokerHandle>;
+//# sourceMappingURL=ensure-relay-broker.d.ts.map

package/dist/fleet/ensure-relay-broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-relay-broker.d.ts","sourceRoot":"","sources":["../../src/fleet/ensure-relay-broker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AAEtE,MAAM,WAAW,wBAAwB;IACvC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,cAAc,CAAC,EAAE,MAAM,CAAA;IAGvB,SAAS,CAAC,EAAE,OAAO,CAAA;IAInB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,uBAAuB,CAAA;IACzF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAA;IAC9F,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,uBAAuB,CAAA;IAI/B,OAAO,EAAE,OAAO,CAAA;CACjB;AASD,wBAAsB,iBAAiB,CAAC,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA0C1G"}

package/dist/fleet/ensure-relay-broker.js

@@ -0,0 +1,56 @@
+import { HarnessDriverClient } from '@agent-relay/harness-driver';
+// Resolve the relay broker for the internal fleet backend: reuse the broker that
+// is already running for this workspace (the operator's Pear broker) and only
+// start a fresh one when none is reachable. We connect first and spawn on
+// failure — we NEVER kill an existing broker (that is what made `agent-relay up`
+// dangerous). With no running broker, `HarnessDriverClient.connect` throws and we
+// fall through to spawning one whose broker writes connection.json under
+// `{cwd}/.agentworkforce/relay/`.
+export async function ensureRelayBroker(options = {}) {
+    const connect = options.connect ?? ((opts) => HarnessDriverClient.connect(opts));
+    const spawn = options.spawn ?? ((opts) => HarnessDriverClient.spawn(opts));
+    const env = options.env ?? process.env;
+    try {
+        const client = connect({ cwd: options.cwd, connectionPath: options.connectionPath });
+        options.logger?.info?.('[factory] reusing the relay broker that is already running');
+        return { client, started: false };
+    }
+    catch (error) {
+        if (options.autoStart === false) {
+            throw error;
+        }
+        // Spawn a broker. It must JOIN the existing workspace, not create a new one:
+        // a keyless `init` tries to create a workspace and collides ("failed to
+        // initialize relaycast session: insert into workspaces"). The workspace key
+        // (rk_live_…) makes the broker join. Pear injects it at spawn; standalone the
+        // operator supplies it via RELAY_WORKSPACE_KEY.
+        const workspaceKey = nonEmpty(options.workspaceKey)
+            ?? nonEmpty(env.RELAY_WORKSPACE_KEY)
+            ?? nonEmpty(env.AGENT_RELAY_WORKSPACE_KEY)
+            ?? nonEmpty(env.RELAY_API_KEY);
+        options.logger?.info?.('[factory] no relay broker running; starting one', {
+            reason: error instanceof Error ? error.message : String(error),
+            joiningWorkspace: Boolean(workspaceKey),
+        });
+        try {
+            const client = await spawn({ cwd: options.cwd, workspaceKey });
+            return { client, started: true };
+        }
+        catch (spawnError) {
+            if (!workspaceKey) {
+                throw new Error('Failed to start a relay broker and no workspace key was available to join the existing workspace. ' +
+                    'Set RELAY_WORKSPACE_KEY (your rk_live_… workspace key) so the broker can JOIN your workspace, ' +
+                    'or start a broker first. ' +
+                    `Underlying error: ${spawnError instanceof Error ? spawnError.message : String(spawnError)}`, { cause: spawnError });
+            }
+            throw spawnError;
+        }
+    }
+}
+const nonEmpty = (value) => {
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+};
+//# sourceMappingURL=ensure-relay-broker.js.map

package/dist/fleet/ensure-relay-broker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-relay-broker.js","sourceRoot":"","sources":["../../src/fleet/ensure-relay-broker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AA8BjE,iFAAiF;AACjF,8EAA8E;AAC9E,0EAA0E;AAC1E,iFAAiF;AACjF,kFAAkF;AAClF,yEAAyE;AACzE,kCAAkC;AAClC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,UAAoC,EAAE;IAC5E,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;IAChF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;IAC1E,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAA;IAEtC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,OAAO,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAA;QACpF,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,4DAA4D,CAAC,CAAA;QACpF,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,OAAO,CAAC,SAAS,KAAK,KAAK,EAAE,CAAC;YAChC,MAAM,KAAK,CAAA;QACb,CAAC;QACD,6EAA6E;QAC7E,wEAAwE;QACxE,4EAA4E;QAC5E,8EAA8E;QAC9E,gDAAgD;QAChD,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC;eAC9C,QAAQ,CAAC,GAAG,CAAC,mBAAmB,CAAC;eACjC,QAAQ,CAAC,GAAG,CAAC,yBAAyB,CAAC;eACvC,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;QAChC,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,iDAAiD,EAAE;YACxE,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;YAC9D,gBAAgB,EAAE,OAAO,CAAC,YAAY,CAAC;SACxC,CAAC,CAAA;QACF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,YAAY,EAAE,CAAC,CAAA;YAC9D,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;QAClC,CAAC;QAAC,OAAO,UAAU,EAAE,CAAC;YACpB,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,MAAM,IAAI,KAAK,CACb,oGAAoG;oBACpG,gGAAgG;oBAChG,2BAA2B;oBAC3B,qBAAqB,UAAU,YAAY,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,EAC5F,EAAE,KAAK,EAAE,UAAU,EAAE,CACtB,CAAA;YACH,CAAC;YACD,MAAM,UAAU,CAAA;QAClB,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,QAAQ,GAAG,CAAC,KAAyB,EAAsB,EAAE;IACjE,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAA;IAC/C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAC5B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;AACjD,CAAC,CAAA"}

package/dist/fleet/internal-fleet-client.d.ts

@@ -0,0 +1,90 @@
+import type { BrokerEvent, ListAgent, SendMessageInput, SpawnPtyInput } from '@agent-relay/harness-driver';
+import type { AgentMessage, AgentPidResolution, Capability, FleetClient, RosterEntry, SendInput, SpawnInput, SpawnResult } from '../ports/fleet.js';
+import type { Logger } from '../ports/system.js';
+type SpawnedHandleLike = {
+    name: string;
+    sessionId?: string;
+    session_ref?: string;
+    sessionRef?: string;
+    pid?: number;
+};
+type HarnessEventListener = (event: BrokerEvent) => void;
+type DriverAgentLike = {
+    name: string;
+    sessionId?: string;
+    pid?: number;
+};
+type DriverDeliveryEventLike = BrokerEvent;
+export type AgentRelayMcpCommand = {
+    command: string;
+    args: string[];
+};
+export interface HarnessDriverClientLike {
+    readonly brokerPid?: number;
+    spawnPty(input: SpawnPtyInput): Promise<SpawnedHandleLike>;
+    release(name: string, reason?: string): Promise<{
+        name: string;
+    }>;
+    listAgents(): Promise<Array<Pick<ListAgent, 'name'> & {
+        pid?: number;
+    }>>;
+    sendMessage(input: SendMessageInput): Promise<{
+        event_id: string;
+        targets?: string[];
+    }>;
+    sendInput(name: string, data: string): Promise<unknown>;
+    connectEvents?(sinceSeq?: number): void;
+    disconnect?(): void;
+    shutdown?(): Promise<void> | void;
+    onEvent?(listener: HarnessEventListener): () => void;
+    addListener?(event: 'agentExited', listener: (agent: DriverAgentLike) => void): () => void;
+    addListener?(event: 'deliveryUpdate', listener: (event: DriverDeliveryEventLike) => void): () => void;
+}
+export interface InternalFleetClientOptions {
+    client?: HarnessDriverClientLike;
+    ownsBroker?: boolean;
+    cwd?: string;
+    connectionPath?: string;
+    resumeCapability?: Capability;
+    logger?: Logger;
+    resolveAgentRelayMcpCommand?: () => AgentRelayMcpCommand | undefined;
+}
+type AgentExitListener = (name: string, reason?: string) => void;
+type DeliveryFailedListener = (info: {
+    to: string;
+    msgId?: string;
+    reason?: string;
+}) => void;
+type AgentMessageListener = (message: AgentMessage) => void;
+export declare const capabilityCli: Record<Capability, string>;
+export declare class InternalFleetClient implements FleetClient {
+    #private;
+    constructor(options?: InternalFleetClientOptions);
+    spawn(input: SpawnInput): Promise<SpawnResult>;
+    resume(input: {
+        name?: string;
+        sessionRef: string;
+        node?: 'self' | string;
+        capability?: Capability;
+    }): Promise<SpawnResult>;
+    release(name: string, reason?: string): Promise<void>;
+    roster(): Promise<RosterEntry>;
+    protectedPids(): Promise<number[]>;
+    resolveAgentPid(name: string): Promise<AgentPidResolution>;
+    sendMessage(input: SendInput): Promise<void>;
+    waitForInjected(input: SendInput, opts?: {
+        timeoutMs?: number;
+    }): Promise<{
+        eventId: string;
+        targets: string[];
+    }>;
+    sendInput(name: string, data: string): Promise<void>;
+    onDeliveryFailed(listener: DeliveryFailedListener): () => void;
+    onAgentMessage(listener: AgentMessageListener): () => void;
+    onAgentExit(listener: AgentExitListener): () => void;
+    dispose(): Promise<void>;
+}
+export declare function resolveAgentRelayMcpCommand(): AgentRelayMcpCommand | undefined;
+export declare function buildRelayMcpHarnessConfig(input: SpawnPtyInput, command: AgentRelayMcpCommand): NonNullable<SpawnPtyInput['harnessConfig']>;
+export {};
+//# sourceMappingURL=internal-fleet-client.d.ts.map

package/dist/fleet/internal-fleet-client.d.ts.map

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