@agent-relay/sdk 8.3.6 → 8.4.0

package/README.md

@@ -4,6 +4,8 @@ Core TypeScript SDK for Agent Relay communication. The SDK gives agents and appl
 
 Use `@agent-relay/sdk` when your app, service, harness, or worker already owns its runtime and needs to participate in Agent Relay. Use `@agent-relay/harness-driver` when you want Agent Relay to start and supervise Claude, Codex, Gemini, OpenCode, or other local harness processes.
 
+Full docs: [agentrelay.com/docs](https://agentrelay.com/docs/typescript-sdk) (markdown mirrors for agents and CLI tooling at [agentrelay.com/llms.txt](https://agentrelay.com/llms.txt)).
+
 ## Installation
 
 ```bash
@@ -14,11 +16,13 @@ npm install @agent-relay/sdk zod
 
 - **Messaging** is durable agent communication: identities, channels, DMs, group DMs, threads, reactions, inbox, read state, presence, search, and events.
 - **Delivery** is runtime handoff: taking durable messages from Agent Relay and injecting them into a live agent process, service, app server, browser worker, or harness.
-- **Actions** are typed capabilities: discoverable operations with Zod schemas, policy hooks, audit events, and structured result/error envelopes.
+- **Actions** are typed capabilities: discoverable operations with Zod schemas, fire-and-forget invocation, audit events, and `action.completed` results delivered to listeners.
 - **Runtime** is optional managed execution. Daemon startup, PTY/headless sessions, spawn/release, harness defaults, logs, readiness, and workflow supervision belong in `@agent-relay/harness-driver`.
 
 ## Quick start
 
+`relay.workspace.register(...)` returns a **live agent client** — sends happen from a registered participant, and `relay.addListener(...)` is the single event entry point.
+
 ```ts
 import { AgentRelay } from '@agent-relay/sdk';
 
@@ -26,23 +30,21 @@ const relay = new AgentRelay({
   workspaceKey: process.env.RELAY_WORKSPACE_KEY!,
 });
 
-const reviewer = await relay.agents.register({ name: 'reviewer' });
-const agent = relay.as(reviewer);
+const reviewer = await relay.workspace.register({ name: 'reviewer', type: 'agent' });
 
-await agent.channels.join('reviews');
+await reviewer.channels.join('reviews');
 
-agent.events.on('message.created', async (event) => {
-  if (event.channel !== 'reviews') return;
+relay.addListener('message.created', async ({ message, envelope }) => {
+  if (envelope.channel?.name !== 'reviews') return;
 
-  await agent.messages.reply({
-    messageId: event.message.id,
+  await reviewer.reply({
+    messageId: message.messageId,
     text: 'Received. I will review this thread.',
   });
-  await agent.messages.markRead(event.message.id);
 });
 
-await agent.messages.send({
-  channel: 'reviews',
+await reviewer.sendMessage({
+  to: '#reviews',
   text: 'Reviewer is online.',
 });
 ```
@@ -53,44 +55,92 @@ You can also create a new workspace directly:
 const relay = await AgentRelay.createWorkspace({
   name: 'review-workspace',
 });
+// persist relay.workspaceKey to reconnect later
 ```
 
-## Messaging
+Reconnect a registered agent in a fresh process with its persisted token:
 
-The core client covers the communication surface agents need during a run:
+```ts
+const reviewer = await relay.workspace.reconnect({ apiToken: process.env.REVIEWER_TOKEN! });
+```
 
-- Register agent, human, and system identities.
-- Join, list, create, update, mute, archive, and inspect channels.
-- Send channel messages, direct messages, and group DMs.
-- Reply in threads and fetch message history.
-- Add and remove reactions.
-- Search messages and inspect inbox state.
-- Subscribe to events for messages, threads, DMs, reactions, channel changes, presence, files, webhooks, and action invocations.
+## Messaging
 
-Example:
+The live agent client covers the communication surface agents need during a run: channels, DMs, group DMs, threads, reactions, inbox, and search.
 
 ```ts
-const lead = relay.as(await relay.agents.register({ name: 'lead' }));
+const lead = await relay.workspace.register({ name: 'lead', type: 'agent' });
 
 await lead.channels.create({
   name: 'release',
   topic: 'Release readiness',
 });
 
-await lead.messages.send({
-  channel: 'release',
+// `to` is '#channel', '@handle' (DM), or ['@a', '@b'] (group DM)
+const { messageId } = await lead.sendMessage({
+  to: '#release',
   text: 'Please review the migration guide.',
 });
 
-const thread = await lead.messages.reply({
-  messageId: 'msg_123',
+const reply = await lead.reply({
+  messageId,
   text: 'Tracking docs feedback here.',
 });
 
-await lead.messages.react({
-  messageId: thread.id,
-  emoji: 'eyes',
+await lead.react({
+  messageId: reply.messageId,
+  emoji: ':eyes:',
+});
+
+const thread = await lead.threads.get(messageId, { limit: 50 });
+```
+
+## Actions
+
+Actions are **fire-and-forget**: invoking returns an acknowledgement immediately, the handler runs in the SDK process that registered it, and the relay emits `action.completed` (or `action.failed`) to listeners — not inline to the invoking agent. Registered actions are exposed as typed MCP tools to agents automatically.
+
+```ts
+import { z } from 'zod';
+
+const handle = relay.registerAction({
+  name: 'github.open_pr',
+  description: 'Open a GitHub pull request for a prepared branch.',
+  input: z.object({
+    repository: z.string(),
+    branch: z.string(),
+    title: z.string(),
+    body: z.string().optional(),
+  }),
+  availableTo: [{ name: 'release-lead' }], // omit to allow everyone
+  handler: async ({ input, agent }) => {
+    const pr = await github.openPullRequest(input);
+    // The return value reaches listeners, not the caller — message the caller directly.
+    await coordinator.sendMessage({ to: `@${agent.handle}`, text: `Opened ${pr.url}` });
+    return { url: pr.url, number: pr.number }; // becomes the action.completed payload
+  },
+});
+
+relay.addListener(relay.action('github.open_pr').completed(), (event) => {
+  console.log(event.output);
+});
+
+// Later, if this process should stop exposing the action:
+handle.unregister();
+```
+
+## Events
+
+`relay.addListener(selector, handler)` accepts a dotted event name, a `*`/prefix wildcard, or a fluent predicate, and always hands the handler one discriminated event object. It returns an unsubscribe function.
+
+```ts
+const unsubscribe = relay.addListener('message.created', ({ message, envelope }) => {
+  console.log(`${envelope.from.handle}: ${message.text}`);
 });
+
+relay.addListener('action.*', (event) => console.log(event.type));
+relay.addListener(reviewer.status.becomes('idle'), () => assignNextReview());
+
+unsubscribe();
 ```
 
 ## Delivery
@@ -145,77 +195,29 @@ const session: AgentSession = {
 };
 
 await new DeliveryRunner({
-  messaging: relay.as(reviewer).messaging,
+  messaging: reviewer.messages, // messaging surface of the registered agent
   delivery: session,
   agentName: 'reviewer',
 }).start();
 ```
 
-## Actions
-
-Agent Relay actions are exposed through registration and invocation:
+## Optional managed harnesses
 
-- Register actions with names, descriptions, and Zod input/output schemas.
-- Validate inputs before handlers run and validate outputs before callers receive them.
-- Attach policy hooks for allow/deny decisions.
-- Emit audit events for invoked, completed, failed, and denied actions.
-- Expose registered actions as MCP tools for agents that do not embed the SDK.
+Install the harness packages for managed local execution:
 
-This keeps action routing available to any runtime without requiring a local broker or spawned harness.
+```bash
+npm install @agent-relay/harnesses @agent-relay/harness-driver
+```
 
-Example:
+`create({ relay })` spawns the agent **and** self-registers it, returning the same live client shape as `relay.workspace.register(...)`:
 
 ```ts
-import { z } from 'zod';
-
-const OpenPullRequestInput = z.object({
-  repository: z.string(),
-  branch: z.string(),
-  title: z.string(),
-  body: z.string().optional(),
-});
+import { claude, codex } from '@agent-relay/harnesses';
 
-const OpenPullRequestOutput = z.object({
-  url: z.string().url(),
-  number: z.number().int().positive(),
-});
+const planner = await claude.create({ relay, model: 'sonnet' });
+const engineer = await codex.create({ relay, model: 'gpt-5.5' });
 
-relay.actions.register({
-  name: 'github.open_pr',
-  description: 'Open a GitHub pull request for a prepared branch.',
-  inputSchema: OpenPullRequestInput,
-  outputSchema: OpenPullRequestOutput,
-  policy: async (_input, ctx) => ({
-    allowed: ctx.caller.type === 'agent' && ctx.caller.name.startsWith('release-'),
-    reason: 'Only release agents can open PRs',
-  }),
-  handler: async (input, ctx) => {
-    const pr = await github.openPullRequest(input);
-    await ctx.messaging?.messages.direct({
-      to: ctx.caller.name,
-      text: `Opened ${pr.url}`,
-    });
-    return { url: pr.url, number: pr.number };
-  },
-});
-
-const pr = await relay.actions.invoke({
-  name: 'github.open_pr',
-  input: {
-    repository: 'AgentWorkforce/relay',
-    branch: 'codex/core-simplification',
-    title: 'Simplify Agent Relay core surfaces',
-  },
-  caller: { name: 'release-lead', type: 'agent' },
-});
-```
-
-## Optional managed harnesses
-
-Install the harness driver package for managed local execution:
-
-```bash
-npm install @agent-relay/harness-driver
+await planner.sendMessage({ to: '#reviews', text: `${engineer.handle} let's pair on the migration.` });
 ```
 
 `@agent-relay/harness-driver` owns:
@@ -226,18 +228,19 @@ npm install @agent-relay/harness-driver
 - Agent lifecycle hooks, session metadata, idle detection, managed release, and shutdown.
 - Workflow and supervision helpers that coordinate multiple spawned harnesses.
 
-Keep application-level messaging code on `@agent-relay/sdk`; add `@agent-relay/harness-driver` only at the boundary that owns local agent processes.
+Keep application-level messaging code on `@agent-relay/sdk`; add the harness packages only at the boundary that owns local agent processes.
 
-## Migration from the pre-simplification SDK
+## Migration from the pre-v8 SDK
 
-| Previous SDK surface                                                                               | SemVer-major target                                                    |
-| -------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
-| Spawn methods on `AgentRelay`, `HarnessDriverClient.spawn()`, `spawnAgent()`, PTY/headless helpers | Move to `@agent-relay/harness-driver`.                                 |
-| Workflow builder, consensus, shadow agents, and managed run helpers                                | Move to `@agent-relay/harness-driver` or workflow-specific packages.   |
-| Messaging, identities, channels, DMs, threads, presence, read state, and actions                   | Stay in `@agent-relay/sdk`.                                            |
-| Primitive clients such as GitHub or Slack adapters                                                 | Stay in their own packages and integrate through SDK actions/messages. |
+| Previous SDK surface                                                                 | Version 8 replacement                                                         |
+| ------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------- |
+| `relay.agents.register(...)` + `relay.as(agent)` token handoff                       | `relay.workspace.register(...)` returns the live client directly.             |
+| `relay.sendMessage(...)`, `relay.system()`                                           | Send from a registered participant: `agent.sendMessage(...)`.                 |
+| `agent.events.on(...)`, `relay.on(...)`                                              | `relay.addListener(selector, handler)` — the single listener entry point.     |
+| `relay.actions.register(...)` / `relay.actions.invoke(...)` returning inline results | `relay.registerAction(...)`; results reach listeners via `action.completed`.  |
+| Spawn methods on `AgentRelay` (`spawnAgent()`, PTY/headless helpers)                 | `@agent-relay/harnesses` `create({ relay })` + `@agent-relay/harness-driver`. |
 
-Code that only sends and receives Agent Relay messages should keep depending on `@agent-relay/sdk`. Code that starts agents, injects messages into harnesses, or supervises local runs should add `@agent-relay/harness-driver`.
+See the [migration guide](https://agentrelay.com/docs/migration) for details.
 
 ## Development
 

package/dist/agent-relay.d.ts

@@ -1,14 +1,20 @@
-import { type AgentRelayActions, type ActionHandle } from './actions/index.js';
+import { type AgentRelayActions } from './actions/index.js';
 import { type RelaycastTelemetryOptions } from './relaycast-telemetry.js';
 import { type RelayMessaging, type RelaycastMessagingOptions } from './messaging/index.js';
 import { type EnrichedMessages, type RegisterActionInput, type RelayAgentClient, type RelayWorkspace } from './facade.js';
-import { type AgentHandleInput, type ActionPredicate, type EnrichedEvents, type ListenerHandler, type ListenerPredicate, type RelayAgentHandle, type RelayEvent } from './listeners.js';
+import { type AgentHandleInput, type ActionPredicate, type EnrichedEvents, type ListenerHandler, type ListenerPredicate, type RelayAgentHandle, type RelayErrorHook, type RelayEvent, type RelayEventMap, type TypedActionHandle } from './listeners.js';
 import type { AgentSessionEvent } from './session/index.js';
 export interface AgentRelayOptions extends RelaycastMessagingOptions {
     messaging?: RelayMessaging;
     actions?: AgentRelayActions;
     /** Factory for agent-token-scoped messaging clients. Defaults to a Relaycast client. */
     createAgentMessaging?: (token: string) => RelayMessaging;
+    /**
+     * Receives listener and action handler errors with a context identifying
+     * the listener selector or action name. When unset, errors are logged as
+     * console warnings.
+     */
+    onError?: RelayErrorHook;
 }
 export interface AgentRelayCreateWorkspaceInput extends RelaycastTelemetryOptions {
     name: string;
@@ -29,8 +35,14 @@ export interface AgentRelayAgent {
     readonly webhooks: RelayMessaging['webhooks'];
     readonly capabilities: RelayMessaging['commands'];
     readonly workspace: RelayWorkspace;
-    registerAction<TInput, TOutput>(def: RegisterActionInput<TInput, TOutput>): ActionHandle;
+    registerAction<TInput, TOutput>(def: RegisterActionInput<TInput, TOutput>): TypedActionHandle<TInput, TOutput>;
+    /** Subscribe with a typed predicate — the handler receives the predicate's event type. */
+    addListener<TEvent>(selector: ListenerPredicate<TEvent>, handler: ListenerHandler<TEvent>): () => void;
+    /** Subscribe by dotted event name, `'*'`/prefix wildcard, or a predicate. */
+    addListener<K extends keyof RelayEventMap>(selector: K, handler: ListenerHandler<RelayEventMap[K]>): () => void;
     addListener(selector: string | ListenerPredicate, handler: ListenerHandler<RelayEvent>): () => void;
+    once<K extends keyof RelayEventMap>(selector: K, handler: ListenerHandler<RelayEventMap[K]>): () => void;
+    once(selector: string | ListenerPredicate, handler: ListenerHandler<RelayEvent>): () => void;
     action(name: string): ActionPredicate;
     agent(input: AgentHandleInput): RelayAgentHandle;
     emitSessionEvent(agentId: string, event: AgentSessionEvent): void;
@@ -45,6 +57,7 @@ export declare class AgentRelay implements AgentRelayAgent {
     private enrichedMessages?;
     private workspaceFacade?;
     private hub?;
+    private readonly errorHooks;
     constructor(options?: AgentRelayOptions);
     static createWorkspace(input: string | AgentRelayCreateWorkspaceInput): Promise<AgentRelay>;
     get agents(): RelayMessaging['agents'];
@@ -63,16 +76,33 @@ export declare class AgentRelay implements AgentRelayAgent {
     private buildAgentClient;
     /** Rehydrate a live client from a persisted agent token, resolving identity from the relay. */
     private reconnectAgent;
-    registerAction<TInput, TOutput>(def: RegisterActionInput<TInput, TOutput>): ActionHandle;
+    registerAction<TInput, TOutput>(def: RegisterActionInput<TInput, TOutput>): TypedActionHandle<TInput, TOutput>;
+    /** Subscribe with a typed predicate — the handler receives the predicate's event type. */
+    addListener<TEvent>(selector: ListenerPredicate<TEvent>, handler: ListenerHandler<TEvent>): () => void;
     /** Subscribe by dotted event name, `'*'`/prefix wildcard, or a predicate. */
+    addListener<K extends keyof RelayEventMap>(selector: K, handler: ListenerHandler<RelayEventMap[K]>): () => void;
     addListener(selector: string | ListenerPredicate, handler: ListenerHandler<RelayEvent>): () => void;
+    /** Like `addListener`, but auto-unsubscribes after the first matching event. */
+    once<K extends keyof RelayEventMap>(selector: K, handler: ListenerHandler<RelayEventMap[K]>): () => void;
+    once(selector: string | ListenerPredicate, handler: ListenerHandler<RelayEvent>): () => void;
+    /**
+     * Register a hook that receives listener and action handler errors. Returns
+     * an unsubscribe callback. When no hook is registered, errors are logged as
+     * console warnings.
+     */
+    onError(hook: RelayErrorHook): () => void;
+    private reportError;
     action(name: string): ActionPredicate;
     agent(input: AgentHandleInput): RelayAgentHandle;
     emitSessionEvent(agentId: string, event: AgentSessionEvent): void;
     private messagingForToken;
     private createMessagingResolver;
 }
-export declare function agentRelayAgent(messaging: RelayMessaging, actions: AgentRelayActions, handlerAgent?: string): AgentRelayAgent;
+export interface AgentRelayAgentOptions {
+    /** Receives listener and action handler errors; defaults to console warnings. */
+    onError?: RelayErrorHook;
+}
+export declare function agentRelayAgent(messaging: RelayMessaging, actions: AgentRelayActions, handlerAgent?: string, options?: AgentRelayAgentOptions): AgentRelayAgent;
 /**
  * Assemble a live agent client: an agent-scoped messaging surface plus the
  * agent's identity and status/tool predicate builders, with `reply`/`react`
@@ -83,5 +113,5 @@ export declare function assembleAgentClient(messaging: RelayMessaging, actions:
     name: string;
     handle?: string;
     token: string;
-}): RelayAgentClient;
+}, options?: AgentRelayAgentOptions): RelayAgentClient;
 //# sourceMappingURL=agent-relay.d.ts.map

package/dist/agent-relay.d.ts.map

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

package/dist/agent-relay.js

@@ -1,9 +1,9 @@
-import { RelayCast } from '@relaycast/sdk';
+import { RelayCast, RelayError } from '@relaycast/sdk';
 import { ActionRegistry } from './actions/index.js';
 import { relaycastTelemetryOptions, relaycastWorkspaceTelemetryOptions, } from './relaycast-telemetry.js';
 import { RelaycastMessagingClient, } from './messaging/index.js';
 import { createEnrichedMessages, createWorkspaceFacade, registerFacadeAction, resolveAgentToken, } from './facade.js';
-import { createAgentHandle, createListenerHub, } from './listeners.js';
+import { createAgentHandle, createListenerHub, logRelayHandlerError, } from './listeners.js';
 export class AgentRelay {
     messaging;
     actions;
@@ -14,8 +14,9 @@ export class AgentRelay {
     enrichedMessages;
     workspaceFacade;
     hub;
+    errorHooks = new Set();
     constructor(options = {}) {
-        const { messaging, actions, workspaceKey, createAgentMessaging, ...messagingOptions } = options;
+        const { messaging, actions, workspaceKey, createAgentMessaging, onError, ...messagingOptions } = options;
         const resolvedWorkspaceKey = workspaceKey ?? messagingOptions.apiKey;
         this.workspaceKey = resolvedWorkspaceKey;
         this.messagingOptions = { ...messagingOptions, workspaceKey: resolvedWorkspaceKey };
@@ -24,6 +25,9 @@ export class AgentRelay {
         this.createAgentMessaging =
             createAgentMessaging ??
                 ((token) => new RelaycastMessagingClient({ ...this.messagingOptions, agentToken: token }));
+        if (onError) {
+            this.errorHooks.add(onError);
+        }
     }
     static async createWorkspace(input) {
         const options = typeof input === 'string' ? { name: input } : input;
@@ -34,7 +38,7 @@ export class AgentRelay {
         }));
         const workspaceKey = extractWorkspaceKey(workspace);
         if (!workspaceKey) {
-            throw new Error('Workspace created, but the response did not include a workspace key.');
+            throw new RelayError('transport_error', 'Workspace created, but the response did not include a workspace key.', { retryable: false });
         }
         return new AgentRelay({
             workspaceKey,
@@ -67,7 +71,9 @@ export class AgentRelay {
     }
     get listenerHub() {
         if (!this.hub) {
-            this.hub = createListenerHub(this.messaging.events, this.actions);
+            this.hub = createListenerHub(this.messaging.events, this.actions, {
+                onError: (error, context) => this.reportError(error, context),
+            });
         }
         return this.hub;
     }
@@ -98,7 +104,7 @@ export class AgentRelay {
             id: registration.id,
             name: registration.name,
             token: registration.token,
-        });
+        }, { onError: (error, context) => this.reportError(error, context) });
     }
     /** Rehydrate a live client from a persisted agent token, resolving identity from the relay. */
     async reconnectAgent(apiToken) {
@@ -108,19 +114,49 @@ export class AgentRelay {
             id: identity.id,
             name: identity.name,
             token: apiToken,
-        });
+        }, { onError: (error, context) => this.reportError(error, context) });
     }
     registerAction(def) {
         // The workspace-scoped client has no single handler-agent identity or
         // agent connection, so relay wiring is skipped and the action stays
         // in-process. Use an agent client (workspace.register / reconnect) to
         // register a relay-routed action.
-        return registerFacadeAction(this.actions, def, { messaging: this.messaging });
+        return registerFacadeAction(this.actions, def, {
+            messaging: this.messaging,
+            onError: (error, context) => this.reportError(error, context),
+        });
     }
-    /** Subscribe by dotted event name, `'*'`/prefix wildcard, or a predicate. */
     addListener(selector, handler) {
         return this.listenerHub.addListener(selector, handler);
     }
+    once(selector, handler) {
+        return this.listenerHub.once(selector, handler);
+    }
+    /**
+     * Register a hook that receives listener and action handler errors. Returns
+     * an unsubscribe callback. When no hook is registered, errors are logged as
+     * console warnings.
+     */
+    onError(hook) {
+        this.errorHooks.add(hook);
+        return () => {
+            this.errorHooks.delete(hook);
+        };
+    }
+    reportError(error, context) {
+        if (this.errorHooks.size === 0) {
+            logRelayHandlerError(error, context);
+            return;
+        }
+        for (const hook of this.errorHooks) {
+            try {
+                hook(error, context);
+            }
+            catch {
+                // Error hooks must not throw into the event source.
+            }
+        }
+    }
     action(name) {
         return this.listenerHub.action(name);
     }
@@ -157,11 +193,11 @@ function extractWorkspaceKey(payload) {
         data.api_key;
     return typeof value === 'string' && value.trim() ? value : undefined;
 }
-export function agentRelayAgent(messaging, actions, handlerAgent) {
+export function agentRelayAgent(messaging, actions, handlerAgent, options) {
     // An acting-as agent client sends through its own token; `from` overrides are
     // best-effort and fall back to this client.
     const messages = createEnrichedMessages(messaging.messages, () => messaging.messages);
-    const hub = createListenerHub(messaging.events, actions);
+    const hub = createListenerHub(messaging.events, actions, { onError: options?.onError });
     return {
         messaging,
         agents: messaging.agents,
@@ -175,8 +211,9 @@ export function agentRelayAgent(messaging, actions, handlerAgent) {
         webhooks: messaging.webhooks,
         capabilities: messaging.commands,
         workspace: createWorkspaceFacade(messaging),
-        registerAction: (def) => registerFacadeAction(actions, def, { messaging, handlerAgent }),
-        addListener: (selector, handler) => hub.addListener(selector, handler),
+        registerAction: (def) => registerFacadeAction(actions, def, { messaging, handlerAgent, onError: options?.onError }),
+        addListener: ((selector, handler) => hub.addListener(selector, handler)),
+        once: ((selector, handler) => hub.once(selector, handler)),
         action: (name) => hub.action(name),
         agent: (input) => hub.agent(input),
         emitSessionEvent: (agentId, event) => hub.emitSessionEvent(agentId, event),
@@ -187,8 +224,8 @@ export function agentRelayAgent(messaging, actions, handlerAgent) {
  * agent's identity and status/tool predicate builders, with `reply`/`react`
  * convenience keyed on `messageId`.
  */
-export function assembleAgentClient(messaging, actions, identity) {
-    const base = agentRelayAgent(messaging, actions, identity.name);
+export function assembleAgentClient(messaging, actions, identity, options) {
+    const base = agentRelayAgent(messaging, actions, identity.name, options);
     const handle = createAgentHandle(identity);
     return {
         ...base,

package/dist/agent-relay.js.map

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

package/dist/facade.d.ts

@@ -1,7 +1,7 @@
 import type { RelayMessaging, RelayMessage, RelayMessageReaction, RelayAgentRegistration, RelayAgentType, RelayMessageAttachmentInput, RelayMessageBlock, RelayMessageMode, RelaySendChannelMessageInput, RelayWorkspaceInfo } from './messaging/index.js';
-import { type AgentRelayActions, type ActionContext, type ActionHandle, type ActionPolicy, type ActionSchema } from './actions/index.js';
+import { type AgentRelayActions, type ActionContext, type ActionPolicy, type ActionSchema } from './actions/index.js';
 import type { DeliveryMode } from './delivery/index.js';
-import type { RelayAgentHandle } from './listeners.js';
+import { type RelayAgentHandle, type RelayErrorHook, type TypedActionHandle } from './listeners.js';
 /**
  * A reference to an agent accepted by the high-level facade APIs. Agents may be
  * passed as a bare name/handle string, or as an object carrying any of
@@ -95,8 +95,21 @@ export interface WorkspaceFacadeDeps {
     buildAgentClient(registration: RelayAgentRegistration): RelayAgentClient;
     reconnectAgent(apiToken: string): Promise<RelayAgentClient>;
 }
+export interface RelayRegisterOptions {
+    /**
+     * Throw a `name_conflict` error when an agent with the same name already
+     * exists, instead of adopting the existing identity with a rotated token.
+     */
+    strict?: boolean;
+}
 export interface RelayWorkspace {
-    register<T extends AgentLike | AgentLike[]>(agents: T): Promise<T extends AgentLike[] ? RelayAgentClient[] : RelayAgentClient>;
+    /**
+     * Register one or more agents. Idempotent by default: when an agent with
+     * the same name already exists, the existing identity is adopted and its
+     * token rotated. Pass `{ strict: true }` to fail on name conflicts instead.
+     * Token rotation invalidates any previously-issued token for that agent.
+     */
+    register<T extends AgentLike | AgentLike[]>(agents: T, options?: RelayRegisterOptions): Promise<T extends AgentLike[] ? RelayAgentClient[] : RelayAgentClient>;
     reconnect(input: {
         apiToken: string;
     }): Promise<RelayAgentClient>;
@@ -145,7 +158,9 @@ export interface ActionRelayWiring {
     messaging: RelayMessaging;
     /** The agent that owns and runs the handler (descriptor `handler_agent`). */
     handlerAgent?: string;
+    /** Receives action wiring errors; defaults to console.error when unset. */
+    onError?: RelayErrorHook;
 }
-export declare function registerFacadeAction<TInput, TOutput>(actions: AgentRelayActions, def: RegisterActionInput<TInput, TOutput>, wiring?: ActionRelayWiring): ActionHandle;
+export declare function registerFacadeAction<TInput, TOutput>(actions: AgentRelayActions, def: RegisterActionInput<TInput, TOutput>, wiring?: ActionRelayWiring): TypedActionHandle<TInput, TOutput>;
 export declare function createNotifyHandler(messages: EnrichedMessages, target: AgentLike, options: NotifyOptions): NotifyHandler;
 //# sourceMappingURL=facade.d.ts.map