@agent-relay/sdk 10.0.0 → 10.1.0

package/dist/messaging/index.d.ts

@@ -1,4 +1,5 @@
 export * from './types.js';
 export * from './normalize.js';
 export { RelayPlacementError, RelaycastMessagingClient, type RelaycastMessagingOptions, } from './relaycast.js';
+export * from './thin-client.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/messaging/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/messaging/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,KAAK,yBAAyB,GAC/B,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/messaging/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,KAAK,yBAAyB,GAC/B,MAAM,gBAAgB,CAAC;AACxB,cAAc,kBAAkB,CAAC"}

package/dist/messaging/index.js

@@ -1,4 +1,5 @@
 export * from './types.js';
 export * from './normalize.js';
 export { RelayPlacementError, RelaycastMessagingClient, } from './relaycast.js';
+export * from './thin-client.js';
 //# sourceMappingURL=index.js.map

package/dist/messaging/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/messaging/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EACL,mBAAmB,EACnB,wBAAwB,GAEzB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/messaging/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EACL,mBAAmB,EACnB,wBAAwB,GAEzB,MAAM,gBAAgB,CAAC;AACxB,cAAc,kBAAkB,CAAC"}

package/dist/messaging/thin-client.d.ts

@@ -0,0 +1,194 @@
+/**
+ * Thin Relaycast client factories.
+ *
+ * These factories give SDK consumers (the CLI MCP server in particular)
+ * typed access to the hosted Relaycast engine without importing
+ * `@relaycast/sdk` directly. Unlike {@link RelaycastMessagingClient}, the
+ * thin clients are raw pass-throughs: requests and responses cross the wire
+ * untouched, so payloads serialized back to callers (for example MCP tool
+ * results) keep the exact upstream shape, and upstream errors propagate
+ * unchanged for detectors like `isInvalidAgentTokenError`.
+ *
+ * Telemetry context (`originActor`, `agentRelayDistinctId`) is resolved from
+ * explicit options first and the standard Agent Relay environment variables
+ * second, matching every other Relaycast client built by this package.
+ */
+import { type RelaycastTelemetryOptions } from '../relaycast-telemetry.js';
+import type { RelayCreateChannelInput, RelayListAgentsOptions, RelayListChannelsOptions, RelayMessageListOptions, RelayMessageMode, RelayRegisterAgentInput } from './types.js';
+export type { RelaycastTelemetryOptions } from '../relaycast-telemetry.js';
+/** Version of the underlying `@relaycast/sdk` engine client. */
+export declare const RELAYCAST_SDK_VERSION: string;
+/** Raw registration payload returned by `agents.registerOrRotate`. */
+export interface RelayRawAgentRegistration {
+    /** Agent token (`at_live_...`) minted or rotated for this identity. */
+    token: string;
+    /** Canonical agent name the workspace bound the registration to. */
+    name?: string;
+    [key: string]: unknown;
+}
+/** Input for `agents.spawn` — ask the relay to launch a provider-backed worker. */
+export interface RelaySpawnAgentInput {
+    name: string;
+    /** AI CLI to launch (for example `claude` or `codex`). */
+    cli?: string;
+    /** Task instructions handed to the spawned worker. */
+    task?: string;
+    /** Channel the worker should join. */
+    channel?: string;
+    persona?: string;
+    /**
+     * Free-form spawn metadata forwarded to the broker (for example `{ model }`,
+     * which the broker extracts to pass `--model` to the launched CLI).
+     */
+    metadata?: Record<string, unknown>;
+}
+/** Input for `agents.release`. */
+export interface RelayReleaseAgentInput {
+    name: string;
+    reason?: string;
+    /** Permanently delete the agent instead of just releasing it. */
+    deleteAgent?: boolean;
+}
+/** Raw payload returned by `agents.release`. */
+export interface RelayRawReleasedAgent {
+    name: string;
+    released: boolean;
+    deleted: boolean;
+    reason: string | null;
+    [key: string]: unknown;
+}
+/** Raw group DM conversation returned by `dms.createGroup`. */
+export interface RelayRawGroupConversation {
+    id: string;
+    [key: string]: unknown;
+}
+/**
+ * Workspace-key scoped operations: identity registration plus worker
+ * lifecycle. Responses are raw upstream payloads.
+ */
+export interface RelayWorkspaceThinClient {
+    readonly agents: {
+        list(options?: RelayListAgentsOptions): Promise<unknown[]>;
+        /** Register an agent, rotating its token when the name already exists. */
+        registerOrRotate(input: RelayRegisterAgentInput): Promise<RelayRawAgentRegistration>;
+        /** Ask the relay to spawn a provider-backed worker. */
+        spawn(input: RelaySpawnAgentInput): Promise<Record<string, unknown>>;
+        /** Release (or delete) a spawned worker. */
+        release(input: RelayReleaseAgentInput): Promise<RelayRawReleasedAgent>;
+    };
+}
+/**
+ * Agent-token scoped operations: messaging, channels, reactions, inbox, and
+ * the relay action surface. Responses are raw upstream payloads.
+ */
+export interface RelayAgentThinClient {
+    send(channel: string, text: string, options?: {
+        attachments?: string[];
+        mode?: RelayMessageMode;
+    }): Promise<unknown>;
+    messages(channel: string, options?: RelayMessageListOptions): Promise<unknown[]>;
+    reply(messageId: string, text: string): Promise<unknown>;
+    thread(messageId: string, options?: {
+        limit?: number;
+    }): Promise<unknown>;
+    dm(to: string, text: string, options?: {
+        mode?: RelayMessageMode;
+        attachments?: string[];
+    }): Promise<unknown>;
+    readonly dms: {
+        conversations(): Promise<unknown[]>;
+        messages(conversationId: string, options?: RelayMessageListOptions): Promise<unknown[]>;
+        createGroup(input: {
+            participants: string[];
+            name?: string;
+        }): Promise<RelayRawGroupConversation>;
+        sendMessage(conversationId: string, text: string, options?: {
+            attachments?: string[];
+            mode?: RelayMessageMode;
+        }): Promise<unknown>;
+    };
+    readonly channels: {
+        create(input: RelayCreateChannelInput): Promise<unknown>;
+        list(options?: RelayListChannelsOptions): Promise<unknown[]>;
+        join(name: string): Promise<unknown>;
+        leave(name: string): Promise<unknown>;
+        invite(channel: string, agent: string): Promise<unknown>;
+        setTopic(name: string, topic: string): Promise<unknown>;
+        archive(name: string): Promise<unknown>;
+    };
+    react(messageId: string, emoji: string): Promise<unknown>;
+    unreact(messageId: string, emoji: string): Promise<unknown>;
+    search(query: string, options?: {
+        channel?: string;
+        from?: string;
+        limit?: number;
+    }): Promise<unknown[]>;
+    inbox(options?: {
+        limit?: number;
+    }): Promise<unknown>;
+    markRead(messageId: string): Promise<unknown>;
+    readers(messageId: string): Promise<unknown[]>;
+    /** Relay action surface; absent on backends without action support. */
+    readonly actions?: {
+        invoke(name: string, input?: Record<string, unknown>): Promise<unknown>;
+    };
+}
+/**
+ * Agent-token scoped realtime event stream. Events arrive as raw upstream
+ * payloads with dotted `type` fields (for example `message.created`).
+ */
+export interface RelayRealtimeThinClient {
+    connect(): void;
+    disconnect(): void;
+    /** Subscribe to an event type (`'*'` for all); returns an unsubscribe function. */
+    on(event: string, handler: (event: unknown) => void): () => void;
+}
+export interface RelayWorkspaceClientOptions extends RelaycastTelemetryOptions {
+    /** Workspace key (`rk_live_...`). */
+    workspaceKey: string;
+    baseUrl?: string;
+}
+export interface RelayAgentClientOptions extends RelaycastTelemetryOptions {
+    /** Agent token (`at_live_...`). */
+    agentToken: string;
+    baseUrl?: string;
+    /**
+     * Presence heartbeat interval forwarded to the underlying client.
+     * Disabled by default so request-scoped clients spawn no background timers.
+     */
+    autoHeartbeatMs?: number | false;
+}
+export interface RelayRealtimeClientOptions extends RelaycastTelemetryOptions {
+    /** Agent token (`at_live_...`). */
+    agentToken: string;
+    baseUrl?: string;
+}
+export interface RelayCreateWorkspaceOptions extends Pick<RelaycastTelemetryOptions, 'agentRelayDistinctId'> {
+    baseUrl?: string;
+}
+/**
+ * Create a workspace-key scoped thin client.
+ * @param options - Workspace key, optional base URL, and telemetry overrides
+ * @returns Raw pass-through client for workspace-scoped operations
+ */
+export declare function createWorkspaceClient(options: RelayWorkspaceClientOptions): RelayWorkspaceThinClient;
+/**
+ * Create an agent-token scoped thin client.
+ * @param options - Agent token, optional base URL, heartbeat, and telemetry overrides
+ * @returns Raw pass-through client for agent-scoped operations
+ */
+export declare function createAgentClient(options: RelayAgentClientOptions): RelayAgentThinClient;
+/**
+ * Create an agent-token scoped realtime event client.
+ * @param options - Agent token, optional base URL, and telemetry overrides
+ * @returns Realtime client streaming raw workspace events
+ */
+export declare function createRealtimeClient(options: RelayRealtimeClientOptions): RelayRealtimeThinClient;
+/**
+ * Create a new Relaycast workspace.
+ * @param name - Human-readable workspace name
+ * @param options - Optional base URL and telemetry overrides
+ * @returns Raw workspace payload, including the workspace key
+ */
+export declare function createWorkspace(name: string, options?: RelayCreateWorkspaceOptions): Promise<Record<string, unknown>>;
+//# sourceMappingURL=thin-client.d.ts.map

package/dist/messaging/thin-client.d.ts.map

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

package/dist/messaging/thin-client.js

@@ -0,0 +1,78 @@
+/**
+ * Thin Relaycast client factories.
+ *
+ * These factories give SDK consumers (the CLI MCP server in particular)
+ * typed access to the hosted Relaycast engine without importing
+ * `@relaycast/sdk` directly. Unlike {@link RelaycastMessagingClient}, the
+ * thin clients are raw pass-throughs: requests and responses cross the wire
+ * untouched, so payloads serialized back to callers (for example MCP tool
+ * results) keep the exact upstream shape, and upstream errors propagate
+ * unchanged for detectors like `isInvalidAgentTokenError`.
+ *
+ * Telemetry context (`originActor`, `agentRelayDistinctId`) is resolved from
+ * explicit options first and the standard Agent Relay environment variables
+ * second, matching every other Relaycast client built by this package.
+ */
+import { RelayCast, SDK_VERSION, WsClient } from '@relaycast/sdk';
+import { relaycastTelemetryOptions, relaycastWorkspaceTelemetryOptions, } from '../relaycast-telemetry.js';
+/** Version of the underlying `@relaycast/sdk` engine client. */
+export const RELAYCAST_SDK_VERSION = SDK_VERSION;
+function clientConfig(apiKey, options) {
+    return {
+        apiKey,
+        ...(options.baseUrl === undefined ? {} : { baseUrl: options.baseUrl }),
+        ...relaycastTelemetryOptions({
+            originActor: options.originActor,
+            agentRelayDistinctId: options.agentRelayDistinctId,
+        }),
+    };
+}
+/**
+ * Create a workspace-key scoped thin client.
+ * @param options - Workspace key, optional base URL, and telemetry overrides
+ * @returns Raw pass-through client for workspace-scoped operations
+ */
+export function createWorkspaceClient(options) {
+    // The raw client is returned as-is; the thin interface narrows the surface
+    // to the workspace operations this package supports.
+    return new RelayCast(clientConfig(options.workspaceKey, options));
+}
+/**
+ * Create an agent-token scoped thin client.
+ * @param options - Agent token, optional base URL, heartbeat, and telemetry overrides
+ * @returns Raw pass-through client for agent-scoped operations
+ */
+export function createAgentClient(options) {
+    const relay = new RelayCast(clientConfig(options.agentToken, options));
+    return relay.as(options.agentToken, {
+        autoHeartbeatMs: options.autoHeartbeatMs ?? false,
+    });
+}
+/**
+ * Create an agent-token scoped realtime event client.
+ * @param options - Agent token, optional base URL, and telemetry overrides
+ * @returns Realtime client streaming raw workspace events
+ */
+export function createRealtimeClient(options) {
+    return new WsClient({
+        token: options.agentToken,
+        ...(options.baseUrl === undefined ? {} : { baseUrl: options.baseUrl }),
+        ...relaycastTelemetryOptions({
+            originActor: options.originActor,
+            agentRelayDistinctId: options.agentRelayDistinctId,
+        }),
+    });
+}
+/**
+ * Create a new Relaycast workspace.
+ * @param name - Human-readable workspace name
+ * @param options - Optional base URL and telemetry overrides
+ * @returns Raw workspace payload, including the workspace key
+ */
+export async function createWorkspace(name, options = {}) {
+    return (await RelayCast.createWorkspace(name, {
+        ...(options.baseUrl === undefined ? {} : { baseUrl: options.baseUrl }),
+        ...relaycastWorkspaceTelemetryOptions({ agentRelayDistinctId: options.agentRelayDistinctId }),
+    }));
+}
+//# sourceMappingURL=thin-client.js.map

package/dist/messaging/thin-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thin-client.js","sourceRoot":"","sources":["../../src/messaging/thin-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAElE,OAAO,EACL,yBAAyB,EACzB,kCAAkC,GAEnC,MAAM,2BAA2B,CAAC;AAYnC,gEAAgE;AAChE,MAAM,CAAC,MAAM,qBAAqB,GAAW,WAAW,CAAC;AA0JzD,SAAS,YAAY,CACnB,MAAc,EACd,OAAyD;IAEzD,OAAO;QACL,MAAM;QACN,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;QACtE,GAAG,yBAAyB,CAAC;YAC3B,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;SACnD,CAAC;KACH,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAoC;IACxE,2EAA2E;IAC3E,qDAAqD;IACrD,OAAO,IAAI,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,CAAwC,CAAC;AAC3G,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAgC;IAChE,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IACvE,OAAO,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE;QAClC,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,KAAK;KAClD,CAAoC,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAmC;IACtE,OAAO,IAAI,QAAQ,CAAC;QAClB,KAAK,EAAE,OAAO,CAAC,UAAU;QACzB,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;QACtE,GAAG,yBAAyB,CAAC;YAC3B,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;SACnD,CAAC;KACH,CAAuC,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAY,EACZ,UAAuC,EAAE;IAEzC,OAAO,CAAC,MAAM,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE;QAC5C,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;QACtE,GAAG,kCAAkC,CAAC,EAAE,oBAAoB,EAAE,OAAO,CAAC,oBAAoB,EAAE,CAAC;KAC9F,CAAC,CAA4B,CAAC;AACjC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/sdk",
-  "version": "10.0.0",
+  "version": "10.1.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -51,7 +51,7 @@
     "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && npx tsc -p tsconfig.build.json",
     "build:full": "npm run build",
     "check": "tsc -p tsconfig.json --noEmit",
-    "test": "vitest run src/__tests__/agent-relay.test.ts src/__tests__/facade.test.ts src/__tests__/listeners.test.ts src/__tests__/integrations.test.ts src/__tests__/messaging.test.ts src/__tests__/delivery-actions.test.ts src/__tests__/relaycast-errors.test.ts src/__tests__/register-action-relay.test.ts src/__tests__/typed-action-handle.test.ts src/__tests__/webhooks.test.ts",
+    "test": "vitest run src/__tests__/agent-relay.test.ts src/__tests__/facade.test.ts src/__tests__/listeners.test.ts src/__tests__/integrations.test.ts src/__tests__/messaging.test.ts src/__tests__/delivery-actions.test.ts src/__tests__/relaycast-errors.test.ts src/__tests__/register-action-relay.test.ts src/__tests__/thin-client.test.ts src/__tests__/typed-action-handle.test.ts src/__tests__/webhooks.test.ts",
     "test:types": "vitest run --typecheck.only --typecheck.tsconfig tsconfig.typetest.json",
     "prepack": "npm run build"
   },