@agent-relay/sdk 7.1.0 → 8.0.1

package/dist/facade.js

@@ -0,0 +1,280 @@
+import { actionSchemaToJsonSchema, } from './actions/index.js';
+/** Resolve an agent reference to its bare name (sigils such as `@`/`#` stripped). */
+export function resolveAgentName(ref) {
+    if (typeof ref === 'string')
+        return stripSigil(ref);
+    const value = ref.handle ?? ref.name ?? ref.id;
+    if (!value) {
+        throw new Error('Unable to resolve agent name: reference has no name, handle, or id.');
+    }
+    return stripSigil(value);
+}
+/** Resolve an agent reference to its auth token, when one is available (for acting-as sends). */
+export function resolveAgentToken(ref) {
+    return ref && typeof ref !== 'string' ? ref.token : undefined;
+}
+function stripSigil(value) {
+    return value.startsWith('@') || value.startsWith('#') ? value.slice(1) : value;
+}
+function isChannelTarget(to) {
+    return to.startsWith('#');
+}
+function deliveryToMode(delivery) {
+    if (!delivery)
+        return undefined;
+    // `immediate` / `next-tool-call` interrupt the running agent; the rest queue.
+    return delivery === 'immediate' || delivery === 'next-tool-call' ? 'steer' : 'wait';
+}
+function buildText(text, mentions) {
+    let body = text ?? '';
+    if (mentions?.length) {
+        const handles = mentions.map((mention) => `@${resolveAgentName(mention)}`);
+        const missing = handles.filter((handle) => !body.includes(handle));
+        if (missing.length) {
+            body = body ? `${missing.join(' ')} ${body}` : missing.join(' ');
+        }
+    }
+    return body;
+}
+/** Resolve a `thread`/`messageId` reference to a parent message id. */
+function resolveMessageId(ref) {
+    if (!ref) {
+        throw new Error('reply requires a `messageId` or `thread`.');
+    }
+    if (typeof ref === 'string')
+        return ref;
+    const value = ref.id ?? ref.threadId;
+    if (!value) {
+        throw new Error('Unable to resolve a message id from the provided thread reference.');
+    }
+    return value;
+}
+export function createEnrichedMessages(base, resolveFrom) {
+    const enriched = Object.create(base);
+    enriched.send = async (input) => {
+        if ('channel' in input && input.channel) {
+            return base.send(input);
+        }
+        const sendInput = input;
+        const messages = resolveFrom(sendInput.from);
+        const text = buildText(sendInput.text ?? sendInput.msg, sendInput.mentions);
+        if (Array.isArray(sendInput.to)) {
+            return messages.groupDirect({
+                participants: sendInput.to.map(resolveAgentName),
+                text,
+                attachments: sendInput.attachments,
+                mode: sendInput.mode,
+                idempotencyKey: sendInput.idempotencyKey,
+            });
+        }
+        if (isChannelTarget(sendInput.to)) {
+            return messages.send({
+                channel: stripSigil(sendInput.to),
+                text,
+                blocks: sendInput.blocks,
+                attachments: sendInput.attachments,
+                mode: sendInput.mode,
+                idempotencyKey: sendInput.idempotencyKey,
+            });
+        }
+        return messages.direct({
+            to: resolveAgentName(sendInput.to),
+            text,
+            attachments: sendInput.attachments,
+            mode: sendInput.mode,
+            idempotencyKey: sendInput.idempotencyKey,
+        });
+    };
+    enriched.reply = async (input) => {
+        const messages = resolveFrom(input.from);
+        return messages.reply({
+            messageId: resolveMessageId(input.messageId ?? input.thread),
+            text: input.text,
+            blocks: input.blocks,
+            idempotencyKey: input.idempotencyKey,
+        });
+    };
+    enriched.react = (async (arg1, arg2) => {
+        if (typeof arg1 === 'string') {
+            return base.react(arg1, arg2);
+        }
+        const messageId = typeof arg1.message === 'string' ? arg1.message : arg1.message.id;
+        const messages = resolveFrom(arg1.agent);
+        return messages.react(messageId, arg1.emoji);
+    });
+    enriched.dm = async (input) => {
+        const messages = resolveFrom(input.from);
+        return messages.direct({
+            to: resolveAgentName(input.to),
+            text: input.text ?? input.msg ?? '',
+            attachments: input.attachments,
+            mode: input.mode,
+            idempotencyKey: input.idempotencyKey,
+        });
+    };
+    return enriched;
+}
+export function createWorkspaceFacade(messaging, deps) {
+    const register = async (agents) => {
+        if (!deps) {
+            throw new Error('register() is only available on the workspace client.');
+        }
+        const list = Array.isArray(agents) ? agents : [agents];
+        const inputs = list.map((agent) => typeof agent === 'string'
+            ? { name: stripSigil(agent) }
+            : {
+                name: resolveAgentName(agent),
+                type: agent.type,
+                persona: agent.persona,
+                metadata: agent.metadata,
+            });
+        // Fail fast on in-batch duplicates so a batch can't partially register
+        // before the relay rejects a later duplicate name.
+        const seen = new Set();
+        for (const { name } of inputs) {
+            if (seen.has(name)) {
+                throw new Error(`Duplicate agent name in register(): "${name}".`);
+            }
+            seen.add(name);
+        }
+        const clients = [];
+        for (const input of inputs) {
+            clients.push(deps.buildAgentClient(await messaging.agents.register(input)));
+        }
+        return Array.isArray(agents) ? clients : clients[0];
+    };
+    return {
+        info: () => messaging.workspace.info(),
+        register: register,
+        reconnect: async ({ apiToken }) => {
+            if (!deps) {
+                throw new Error('reconnect() is only available on the workspace client.');
+            }
+            return deps.reconnectAgent(apiToken);
+        },
+    };
+}
+export function registerFacadeAction(actions, def, wiring) {
+    const allowed = def.availableTo?.map(resolveAgentName);
+    const policy = allowed || def.policy
+        ? async (input, ctx) => {
+            if (allowed && !allowed.includes(ctx.caller.name)) {
+                return {
+                    allowed: false,
+                    reason: `${ctx.caller.name} is not permitted to call ${def.name}.`,
+                };
+            }
+            return def.policy ? def.policy(input, ctx) : { allowed: true };
+        }
+        : undefined;
+    const localHandle = actions.register({
+        name: def.name,
+        description: def.description,
+        input: def.input,
+        inputSchema: def.inputSchema,
+        output: def.output,
+        outputSchema: def.outputSchema,
+        visibility: def.visibility,
+        policy,
+        handler: (input, ctx) => def.handler({ input, agent: ctx.caller, ctx }),
+    });
+    const relayUnsubscribe = wireRelayAction(actions, def, wiring, allowed);
+    if (!relayUnsubscribe) {
+        return localHandle;
+    }
+    return {
+        unregister: () => {
+            relayUnsubscribe();
+            localHandle.unregister();
+        },
+    };
+}
+/**
+ * Register the action descriptor on the relay and subscribe the handler agent
+ * to its `action.invoked` events. Returns an unsubscribe callback, or
+ * `undefined` when no agent-scoped relay connection is available (in which case
+ * the action stays purely in-process, matching legacy behavior).
+ */
+function wireRelayAction(actions, def, wiring, allowed) {
+    const commands = wiring?.messaging.commands;
+    if (!wiring || !commands?.agentScoped?.() || !commands.available?.()) {
+        return undefined;
+    }
+    const handlerAgent = wiring.handlerAgent;
+    if (!handlerAgent) {
+        return undefined;
+    }
+    // Register the descriptor on the relay (fire-and-forget; failures are logged
+    // but do not break local registration).
+    void commands
+        .register({
+        command: def.name,
+        description: def.description ?? def.name,
+        handlerAgent,
+        inputSchema: actionSchemaToJsonSchema(def.inputSchema ?? def.input),
+        outputSchema: actionSchemaToJsonSchema(def.outputSchema ?? def.output),
+        ...(allowed ? { availableTo: allowed } : {}),
+    })
+        .catch((error) => {
+        console.error(`[agent-relay] failed to register action descriptor "${def.name}":`, error);
+    });
+    // Subscribe to invocations routed to this handler agent, then open the event
+    // stream — `events.on(...)` only registers the handler; the socket is opened
+    // by `events.connect()`. Without this the handler never sees `action.invoked`.
+    const unsubscribe = wiring.messaging.events.on('actionInvoked', async (event) => {
+        if (event.actionName !== def.name) {
+            return;
+        }
+        await handleActionInvoked(actions, commands, def.name, event);
+    });
+    try {
+        wiring.messaging.events.connect();
+    }
+    catch (error) {
+        console.error(`[agent-relay] failed to open the event stream for action "${def.name}":`, error);
+    }
+    return unsubscribe;
+}
+async function handleActionInvoked(actions, commands, actionName, event) {
+    let input = {};
+    try {
+        const invocation = await commands.getInvocation(actionName, event.invocationId);
+        input = invocation.input ?? {};
+    }
+    catch (error) {
+        console.error(`[agent-relay] failed to load invocation "${event.invocationId}":`, error);
+    }
+    const result = await actions.invoke({
+        name: actionName,
+        input,
+        caller: { name: event.callerName, type: 'agent' },
+    });
+    try {
+        await commands.completeInvocation(actionName, event.invocationId, result.ok
+            ? { output: toOutputRecord(result.output) }
+            : { error: result.error?.message ?? 'handler failed' });
+    }
+    catch (error) {
+        console.error(`[agent-relay] failed to complete invocation "${event.invocationId}":`, error);
+    }
+}
+/** Coerce a handler return value into the `output` object the relay accepts. */
+function toOutputRecord(output) {
+    if (output !== null && typeof output === 'object' && !Array.isArray(output)) {
+        return output;
+    }
+    return { value: output };
+}
+export function createNotifyHandler(messages, target, options) {
+    return async () => {
+        const subject = options.subject ? `@${resolveAgentName(options.subject)}` : undefined;
+        const label = options.type ?? options.action ?? 'notification';
+        const text = options.text ?? [`[${label}]`, subject].filter(Boolean).join(' ');
+        await messages.dm({
+            to: resolveAgentName(target),
+            text,
+            mode: deliveryToMode(options.delivery),
+        });
+    };
+}
+//# sourceMappingURL=facade.js.map

package/dist/facade.js.map

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

package/dist/index.d.ts

@@ -1,26 +1,10 @@
-export * from './protocol.js';
-export * from './types.js';
-export { BrokerTransport, type BrokerTransportOptions, AgentRelayProtocolError, PtyInputStream, type PtyInputStreamOptions, type PtyInputWriteResult, } from './transport.js';
-export { AgentRelayClient, type AgentRelayBrokerInitArgs, type BrokerExitInfo, type AgentRelayClientOptions, type AgentRelaySpawnOptions, type SetInboundDeliveryModeResult, type SessionInfo, type WorkerStreamSubscriptionOptions, } from './client.js';
-export { EventBus, type EventHandler, type EventMap } from './event-bus.js';
-export type { AfterAgentReleaseContext, AfterAgentSpawnContext, AgentRelayEvents, BeforeAgentReleaseContext, BeforeAgentSpawnContext, BeforeAgentSpawnHandler, SpawnPatch, AgentExitRequestedPayload, AgentIdlePayload, ChannelSubscriptionPayload, WorkerOutputPayload, } from './lifecycle-hooks.js';
-export * from './models.js';
-export { RelayCast, RelayError, AgentClient } from '@relaycast/sdk';
-export type { RelayCastOptions, ClientOptions } from '@relaycast/sdk';
-export * from './pty.js';
-export * from './relay.js';
-export * from './logs.js';
-export * from './broker-logs.js';
-export * from './consensus.js';
-export * from './shadow.js';
-export * from './relay-adapter.js';
-export * from './workflows/index.js';
-export * from './spawn-from-env.js';
-export * from './cli-registry.js';
-export * from './cli-resolver.js';
-export * from './personas.js';
-export * as github from './github.js';
-export { createGitHubStep, GitHubClient } from './github.js';
-export * as slack from './slack.js';
-export { createSlackStep, SlackClient } from './slack.js';
+export * from './agent-relay.js';
+export * from './facade.js';
+export * from './listeners.js';
+export * from './capabilities.js';
+export * from './messaging/index.js';
+export * from './delivery/index.js';
+export * from './actions/index.js';
+export * from './session/index.js';
+export { INVALID_AGENT_TOKEN_CODE, INVALID_AGENT_TOKEN_MESSAGE, agentTokenRecoveryMessage, isInvalidAgentTokenError, isInvalidAgentTokenToolResult, } from './relaycast-errors.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,eAAe,EACf,KAAK,sBAAsB,EAC3B,uBAAuB,EACvB,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,GACzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,gBAAgB,EAChB,KAAK,wBAAwB,EAC7B,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,4BAA4B,EACjC,KAAK,WAAW,EAChB,KAAK,+BAA+B,GACrC,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC5E,YAAY,EACV,wBAAwB,EACxB,sBAAsB,EACtB,gBAAgB,EAChB,yBAAyB,EACzB,uBAAuB,EACvB,uBAAuB,EACvB,UAAU,EACV,yBAAyB,EACzB,gBAAgB,EAChB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACpE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACtE,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -1,24 +1,10 @@
-export * from './protocol.js';
-export * from './types.js';
-export { BrokerTransport, AgentRelayProtocolError, PtyInputStream, } from './transport.js';
-export { AgentRelayClient, } from './client.js';
-export { EventBus } from './event-bus.js';
-export * from './models.js';
-export { RelayCast, RelayError, AgentClient } from '@relaycast/sdk';
-export * from './pty.js';
-export * from './relay.js';
-export * from './logs.js';
-export * from './broker-logs.js';
-export * from './consensus.js';
-export * from './shadow.js';
-export * from './relay-adapter.js';
-export * from './workflows/index.js';
-export * from './spawn-from-env.js';
-export * from './cli-registry.js';
-export * from './cli-resolver.js';
-export * from './personas.js';
-export * as github from './github.js';
-export { createGitHubStep, GitHubClient } from './github.js';
-export * as slack from './slack.js';
-export { createSlackStep, SlackClient } from './slack.js';
+export * from './agent-relay.js';
+export * from './facade.js';
+export * from './listeners.js';
+export * from './capabilities.js';
+export * from './messaging/index.js';
+export * from './delivery/index.js';
+export * from './actions/index.js';
+export * from './session/index.js';
+export { INVALID_AGENT_TOKEN_CODE, INVALID_AGENT_TOKEN_MESSAGE, agentTokenRecoveryMessage, isInvalidAgentTokenError, isInvalidAgentTokenToolResult, } from './relaycast-errors.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,eAAe,EAEf,uBAAuB,EACvB,cAAc,GAGf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,gBAAgB,GAQjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAoC,MAAM,gBAAgB,CAAC;AAc5E,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEpE,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,uBAAuB,CAAC"}

package/dist/listeners.d.ts

@@ -0,0 +1,162 @@
+import type { ActionListenerEvent } from './actions/index.js';
+import { type AgentLike } from './facade.js';
+import type { RelayMessage, RelayMessageChannelRef, RelayMessageCreatedEvent, RelayMessageReadEvent, RelayMessageSender, RelayMessageTarget, RelayMessagingEvent, RelayMessagingEventsSurface, RelayReactionEvent } from './messaging/index.js';
+import type { AgentSessionEvent, AgentSessionStatus } from './session/index.js';
+/** A session event tagged with the id of the agent that produced it. */
+export interface SessionListenerEnvelope {
+    agentId: string;
+    event: AgentSessionEvent;
+}
+/** Wiring handed to a predicate when `relay.on(...)` subscribes it. */
+export interface ListenerContext {
+    events: RelayMessagingEventsSurface;
+    onActionEvent(handler: (event: ActionListenerEvent) => void): () => void;
+    onSessionEvent(handler: (envelope: SessionListenerEnvelope) => void): () => void;
+}
+export type ListenerHandler<TEvent = unknown> = (event: TEvent) => void | Promise<void>;
+export interface ListenerPredicate<TEvent = unknown> {
+    subscribe(context: ListenerContext, handler: ListenerHandler<TEvent>): () => void;
+}
+export declare class MessageCreatedPredicate implements ListenerPredicate<RelayMessageCreatedEvent> {
+    private channel?;
+    private mentioned?;
+    in(channel: string): this;
+    mentions(agent: AgentLike): this;
+    subscribe(context: ListenerContext, handler: ListenerHandler<RelayMessageCreatedEvent>): () => void;
+}
+export declare class MessageReadPredicate implements ListenerPredicate<RelayMessageReadEvent> {
+    subscribe(context: ListenerContext, handler: ListenerHandler<RelayMessageReadEvent>): () => void;
+}
+export declare class MessageReactedPredicate implements ListenerPredicate<RelayReactionEvent> {
+    subscribe(context: ListenerContext, handler: ListenerHandler<RelayReactionEvent>): () => void;
+}
+export interface MessageEventBuilders {
+    created(): MessageCreatedPredicate;
+    read(): MessageReadPredicate;
+    reacted(): MessageReactedPredicate;
+}
+export interface EnrichedEvents extends RelayMessagingEventsSurface {
+    message: MessageEventBuilders;
+}
+export declare function createEnrichedEvents(base: RelayMessagingEventsSurface): EnrichedEvents;
+export declare class ActionPredicate implements ListenerPredicate<ActionListenerEvent> {
+    private readonly action;
+    private caller?;
+    private phase;
+    constructor(action: string);
+    calledBy(agent: AgentLike): this;
+    completed(): this;
+    failed(): this;
+    denied(): this;
+    subscribe(context: ListenerContext, handler: ListenerHandler<ActionListenerEvent>): () => void;
+}
+export declare class StatusPredicate implements ListenerPredicate<AgentSessionEvent> {
+    private readonly agentId;
+    private readonly status;
+    constructor(agentId: string, status: AgentSessionStatus);
+    subscribe(context: ListenerContext, handler: ListenerHandler<AgentSessionEvent>): () => void;
+}
+type ToolCalledEvent = Extract<AgentSessionEvent, {
+    type: 'tool.called';
+}>;
+export declare class ToolCalledPredicate implements ListenerPredicate<ToolCalledEvent> {
+    private readonly agentId;
+    private readonly tool;
+    private filter?;
+    constructor(agentId: string, tool: string);
+    where(filter: (event: ToolCalledEvent) => boolean): this;
+    subscribe(context: ListenerContext, handler: ListenerHandler<ToolCalledEvent>): () => void;
+}
+export interface AgentStatusBuilders {
+    becomes(status: AgentSessionStatus): StatusPredicate;
+}
+export interface AgentToolBuilders {
+    called(tool: string): ToolCalledPredicate;
+}
+/**
+ * A live handle for an agent that carries its identity plus predicate builders
+ * used with `relay.on(...)`. Returned by harness `create(...)` and `relay.agent(...)`.
+ */
+export interface RelayAgentHandle {
+    id: string;
+    name: string;
+    handle: string;
+    token?: string;
+    status: AgentStatusBuilders;
+    tools: AgentToolBuilders;
+}
+export interface AgentHandleInput {
+    id: string;
+    name: string;
+    handle?: string;
+    token?: string;
+}
+/** Flat, ergonomic view of a message event's participants and location. */
+export interface RelayEventEnvelope {
+    from?: RelayMessageSender;
+    to?: RelayMessageTarget;
+    channel?: RelayMessageChannelRef;
+    parent?: string;
+}
+export interface RelayMessageEvent {
+    type: 'message.created' | 'message.updated' | 'thread.reply' | 'dm.received' | 'group_dm.received';
+    message: RelayMessage;
+    envelope: RelayEventEnvelope;
+}
+export interface RelayMessageReadEventPublic {
+    type: 'message.read';
+    messageId: string;
+    agentName: string;
+    readAt?: string;
+}
+export interface RelayMessageReactedEvent {
+    type: 'message.reacted';
+    messageId: string;
+    emoji: string;
+    agentName: string;
+    action: 'added' | 'removed';
+}
+export interface RelayActionEvent {
+    type: 'action.invoked' | 'action.completed' | 'action.failed' | 'action.denied';
+    action: string;
+    agent: ActionListenerEvent['caller'];
+    input?: unknown;
+    output?: unknown;
+    error?: string;
+    reason?: string;
+    at: string;
+}
+export interface RelayAgentStatusEvent {
+    type: 'agent.status.changed' | 'agent.status.idle' | 'agent.status.active' | 'agent.status.blocked' | 'agent.status.waiting' | 'agent.status.offline';
+    agentId: string;
+    status?: AgentSessionStatus;
+    reason?: string;
+}
+export interface RelaySessionEvent {
+    type: string;
+    agentId: string;
+    event: AgentSessionEvent;
+}
+/** The discriminated event object delivered to every `addListener` handler. */
+export type RelayEvent = RelayMessageEvent | RelayMessageReadEventPublic | RelayMessageReactedEvent | RelayActionEvent | RelayAgentStatusEvent | RelaySessionEvent;
+/** Map a raw messaging event to its public form, or `undefined` if not surfaced. */
+export declare function toPublicMessagingEvent(raw: RelayMessagingEvent): RelayEvent | undefined;
+/** Match a selector (`'*'`, `'message.*'`, or an exact dotted name) against an event type. */
+export declare function matchesSelector(selector: string, type: string): boolean;
+export interface ActionEventSource {
+    onEvent?(handler: (event: ActionListenerEvent) => void): () => void;
+}
+export interface ListenerHub {
+    readonly events: EnrichedEvents;
+    on<TEvent>(predicate: ListenerPredicate<TEvent>, handler: ListenerHandler<TEvent>): () => void;
+    /** Subscribe by dotted event name, `'*'`/prefix wildcard, or a predicate. */
+    addListener(selector: string | ListenerPredicate, handler: ListenerHandler<RelayEvent>): () => void;
+    action(name: string): ActionPredicate;
+    agent(input: AgentHandleInput): RelayAgentHandle;
+    /** Feed a harness session event into the hub so agent predicates can fire. */
+    emitSessionEvent(agentId: string, event: AgentSessionEvent): void;
+}
+export declare function createListenerHub(baseEvents: RelayMessagingEventsSurface, actions: ActionEventSource): ListenerHub;
+export declare function createAgentHandle(input: AgentHandleInput): RelayAgentHandle;
+export {};
+//# sourceMappingURL=listeners.d.ts.map

package/dist/listeners.d.ts.map

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