@agent-relay/factory 0.1.16 → 0.1.18

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

@@ -1,4 +1,5 @@
 import type { AgentMessage, Capability, FleetClient, RosterEntry, SendInput, SpawnInput, SpawnResult } from '../ports/index.js';
+import type { RelayMessaging } from '@agent-relay/sdk';
 type AgentExitListener = (name: string, reason?: string) => void;
 type DeliveryFailedListener = (info: {
     to: string;
@@ -6,80 +7,68 @@ type DeliveryFailedListener = (info: {
     reason?: string;
 }) => void;
 type AgentMessageListener = (message: AgentMessage) => void;
-type RelayFleetEventListener = (event: RelayFleetEvent) => void;
-export type RelayFleetEvent = Record<string, unknown> & {
-    type?: string;
-};
-type RelayFetchLike = (url: string, init?: {
-    method?: string;
-    headers?: Record<string, string>;
-    body?: string;
-}) => Promise<{
-    ok: boolean;
-    status: number;
-    statusText: string;
-    json(): Promise<unknown>;
-    text(): Promise<string>;
-}>;
-export type RelayInvocationStatus = 'pending' | 'dispatched' | 'invoked' | 'completed' | 'failed' | 'denied' | string;
-export interface RelayActionAck {
-    invocationId: string;
-    actionName: string;
-    status?: RelayInvocationStatus;
-    dispatchedNodeId?: string | null;
-    input?: Record<string, unknown>;
+export interface TrackedAgent {
+    invocationId?: string;
+    node?: string;
+    spawnedAtMs: number;
+    nodeOfflineSinceMs?: number;
 }
-export interface RelayActionInvocation extends RelayActionAck {
-    output?: unknown;
-    error?: string | null;
-    completedAt?: string | null;
+export interface RelayClientLike {
+    messaging: RelayMessaging;
 }
-export interface RelayFleetNode {
-    name: string;
-    status?: 'online' | 'offline' | 'unknown' | string;
-    live?: boolean;
-    capabilities?: Array<string | {
-        name?: string;
-    }>;
-}
-export interface RelayFleetAgent {
-    name: string;
-}
-export interface RelayFleetTransport {
-    invokeAction(actionName: string, input: Record<string, unknown>, opts: {
-        invocationId: string;
-    }): Promise<RelayActionAck>;
-    getInvocation(actionName: string, invocationId: string): Promise<RelayActionInvocation>;
-    listAgents(): Promise<RelayFleetAgent[]>;
-    listNodes(): Promise<RelayFleetNode[]>;
-    sendMessage(input: SendInput): Promise<{
-        eventId?: string;
-        targets?: string[];
-    }>;
-    waitForDelivery?(eventId: string, opts?: {
-        timeoutMs?: number;
-    }): Promise<{
-        eventId: string;
-        targets: string[];
-    }>;
-    onEvent?(listener: RelayFleetEventListener): () => void;
-    dispose?(): Promise<void> | void;
+export interface RelayClientFactoryOptions {
+    workspaceKey?: string;
+    agentToken?: string;
+    baseUrl?: string;
 }
 export interface RelayFleetClientOptions {
-    transport?: RelayFleetTransport;
-    baseUrl?: string;
+    /** Agent-scoped messaging surface. When provided, identity bootstrap is skipped. */
+    messaging?: RelayMessaging;
     workspaceKey?: string;
     agentToken?: string;
-    spawnActionName?: string;
-    releaseActionName?: string;
-    completionTimeoutMs?: number;
+    /** Workspace agent identity the factory registers/rotates for itself. */
+    agentName?: string;
+    /** Engine base URL override. Absent means the SDK default (cast.agentrelay.com). */
+    baseUrl?: string;
+    /** Timeout for a spawn/release invocation to reach a terminal ack status. */
+    spawnAckTimeoutMs?: number;
     pollIntervalMs?: number;
-    fetch?: RelayFetchLike;
+    /** Queue TTL passed to placement when no eligible node is currently live. */
+    placementTtlMs?: number;
+    createRelay?: (options: RelayClientFactoryOptions) => RelayClientLike;
+    /**
+     * Credential environment. Providing one makes resolution hermetic: only the
+     * given env is consulted, never the on-disk cloud workspace store.
+     */
+    env?: NodeJS.ProcessEnv;
+    /** Cadence of the roster-reconciliation exit watcher. */
+    exitWatchIntervalMs?: number;
+    /** How long a tracked agent's node must be dead before synthesizing an exit. */
+    nodeOfflineGraceMs?: number;
+    /** How long a freshly spawned agent may be absent from the roster before it counts as exited. */
+    registrationGraceMs?: number;
+    now?: () => number;
     sleep?: (ms: number) => Promise<void>;
+    log?: (message: string) => void;
 }
 export declare class RelayFleetClient implements FleetClient {
     #private;
     constructor(options?: RelayFleetClientOptions);
+    /** Agents spawned through this client that have not exited or been released. */
+    trackedAgents(): ReadonlyMap<string, TrackedAgent>;
+    /** Re-adopt agents recorded in the in-flight registry after a restart. */
+    hydrateTracked(agents: Array<{
+        name: string;
+        invocationId?: string;
+        node?: string;
+    }>): void;
+    /**
+     * Reconcile tracked agents against the engine roster, synthesizing exits for
+     * agents that went offline (or whose node died) without a push signal. The
+     * exit watcher runs this on an interval; callers may invoke it directly for
+     * a deterministic sweep (startup recovery, tests).
+     */
+    reconcileTrackedAgents(): Promise<void>;
     spawn(input: SpawnInput): Promise<SpawnResult>;
     resume(input: {
         name?: string;
@@ -90,7 +79,7 @@ export declare class RelayFleetClient implements FleetClient {
     release(name: string, reason?: string): Promise<void>;
     roster(): Promise<RosterEntry>;
     sendMessage(input: SendInput): Promise<void>;
-    waitForInjected(input: SendInput, opts?: {
+    waitForInjected(input: SendInput, _opts?: {
         timeoutMs?: number;
     }): Promise<{
         eventId: string;

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

@@ -1 +1 @@
-{"version":3,"file":"relay-fleet-client.d.ts","sourceRoot":"","sources":["../../src/fleet/relay-fleet-client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAEtH,KAAK,iBAAiB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;AAChE,KAAK,sBAAsB,GAAG,CAAC,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,CAAA;AAC7F,KAAK,oBAAoB,GAAG,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAA;AAC3D,KAAK,uBAAuB,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAA;AAE/D,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AACzE,KAAK,cAAc,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IACzC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,KAAK,OAAO,CAAC;IACZ,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;IACxB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;CACxB,CAAC,CAAA;AASF,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAA;AAErH,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,qBAAqB,CAAA;IAC9B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC;AAED,MAAM,WAAW,qBAAsB,SAAQ,cAAc;IAC3D,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAA;IAClD,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACjD;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IACzH,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAA;IACvF,UAAU,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAAA;IACxC,SAAS,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAA;IACtC,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAA;IAChF,eAAe,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAA;IACjH,OAAO,CAAC,CAAC,QAAQ,EAAE,uBAAuB,GAAG,MAAM,IAAI,CAAA;IACvD,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CACjC;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,mBAAmB,CAAA;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,KAAK,CAAC,EAAE,cAAc,CAAA;IACtB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACtC;AAQD,qBAAa,gBAAiB,YAAW,WAAW;;gBAmBtC,OAAO,GAAE,uBAA4B;IAe3C,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IAQ9C,MAAM,CAAC,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAc3H,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUrD,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC;IAiB9B,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAWvH,gBAAgB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,IAAI;IAQ9D,cAAc,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI;IAQ1D,WAAW,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,IAAI;IAQ9C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAuE/B"}
+{"version":3,"file":"relay-fleet-client.d.ts","sourceRoot":"","sources":["../../src/fleet/relay-fleet-client.ts"],"names":[],"mappings":"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"}