agent-relay 7.1.1 → 8.0.0

package/README.md

@@ -1,135 +1,42 @@
-<img src="./readme-banner.png" alt="Agent Relay">
-<a href="https://www.npmjs.com/package/@agent-relay/sdk"><img alt="npm" src="https://img.shields.io/npm/v/@agent-relay/sdk"></a>
-<a href="https://github.com/AgentWorkforce/relay/actions/workflows/test.yml"><img alt="Tests" src="https://img.shields.io/github/actions/workflow/status/AgentWorkforce/relay/test.yml?branch=main&label=tests"></a>
-<a href="./LICENSE"><img alt="License" src="https://img.shields.io/badge/license-Apache--2.0-blue.svg"></a>
-<br/><br/>
-Real-time communication between coding harnesses. Let Claude send messages to codex and stop babysitting your agents.
+# agent-relay
 
-## What you can build with it today
+A thin operator console for a local agent workforce: stand up the broker, staff it with off-the-shelf agent CLIs, and watch/steer them from the terminal. Each command is a shallow wrapper over a backing package (`@agent-relay/sdk`, `@agent-relay/harness-driver`, `@agent-relay/cloud`).
 
-- **Claude orchestrates, Codex implements.** <br/>Spawn a Claude lead that hands work to Codex workers, reads their progress live, and steers mid-task when one goes off the rails.
-- **Adversarial review loops.** <br/>Run an implementer alongside one or two critics. They iterate until the critic ratifies — no human in the loop.
-- **Walk-away autonomy.** <br/>Kick off a multi-step job, close the laptop. Agents keep talking, finishing, and verifying each other's work.
-
-## Get started
-
-1. Install the agent-relay CLI:
-
-   ```bash
-   curl -fsSL https://raw.githubusercontent.com/AgentWorkforce/relay/main/install.sh | bash
-   ```
-
-2. Install the orchestration skill:
-
-   ```bash
-   npx skills add https://github.com/agentworkforce/skills --skill orchestrating-agent-relay
-   ```
-
-3. Tell your agent to use it:
-
-   ```
-   use the orchestrating-agent-relay skill to spawn a claude and codex agent and [YOUR_TASK]
-   ```
-
-## Why not subagents?
-
-Subagents are the right tool when work is a single well-scoped one-shot. Agent Relay's advantages compound when work is multi-step, multi-role, long-running, or needs independent verification.
-
-- **Mix models and harnesses.** Codex implements, Claude reviews, Gemini verifies — each model used for what it's best at, not whatever the parent harness happens to be.
-- **Live steering.** The orchestrator reads logs and DMs as workers run and can redirect mid-turn instead of waiting for a final report.
-- **Review as a conversation.** The reviewer and implementer talk while the code is being written, not after the fact.
-- **Swarm patterns out of the box.** Review/fix loops, adversarial debate pairs, fan-out → pipeline → gather, lead + workers.
-- **Audit trail outside the agent.** Every DM and channel message shows up in the [Agent Relay Observer](https://agentrelay.com/observer) — full visibility without trusting the parent agent's self-report.
-
-## SDK
-
-Spawn and control agents programmatically.
-
-**TypeScript / Node.js**
+## Install
 
 ```bash
-npm install @agent-relay/sdk
-# or
-bun add @agent-relay/sdk
+npm install -g agent-relay
 ```
 
-**Python**
+## Common commands
 
 ```bash
-pip install agent-relay-sdk
-```
-
-See the [Python SDK](./packages/sdk-py) for Python usage and adapters.
-
-### Quick example
+agent-relay status                 # workspace + cloud login + local broker
+agent-relay mcp                    # MCP stdio server
 
-```typescript
-import { AgentRelay, Models } from '@agent-relay/sdk';
-
-const relay = new AgentRelay();
-
-relay.onMessageReceived = (msg) => {
-  console.log(`[${msg.from} → ${msg.to}]: ${msg.text}`);
-};
-
-const channels = ['tic-tac-toe'];
-
-const x = await relay.claude.spawn({
-  name: 'PlayerX',
-  model: Models.Claude.SONNET,
-  channels,
-  task: 'Play tic-tac-toe as X against PlayerO. You go first.',
-});
-
-const o = await relay.codex.spawn({
-  name: 'PlayerO',
-  model: Models.Codex.GPT_5_3_CODEX_SPARK,
-  channels,
-  task: 'Play tic-tac-toe as O against PlayerX.',
-});
-
-await Promise.all([relay.waitForAgentReady('PlayerX'), relay.waitForAgentReady('PlayerO')]);
-
-relay.system().sendMessage({ to: 'PlayerX', text: 'Start.' });
-
-await AgentRelay.waitForAny([x, o], 5 * 60 * 1000);
-await relay.shutdown();
+agent-relay message post --channel general --text "hello"
+agent-relay workspace list
 ```
 
-More:
+## Local broker
 
-- [Introduction](https://agentrelay.com/docs/introduction)
-- [TypeScript SDK README](https://agentrelay.com/docs/typescript-sdk)
-- [Python SDK README](https://agentrelay.com/docs/python-sdk)
-
-## Supported agents and runtimes
-
-First-class support for terminal-native agents:
-
-- Claude Code
-- Codex CLI
-- Gemini CLI
-- OpenCode
-
-The broader SDK and workflow surface also includes additional integrations in the codebase. See the package docs for details.
-
-## Development
+The `local` command group manages the broker on your machine and the agents it runs:
 
 ```bash
-npm install
-npm run build
-npm test
+agent-relay local up
+agent-relay local status
+agent-relay local down
+
+agent-relay local agent new claude          # spawn + attach
+agent-relay local agent list
+agent-relay local agent attach <name> --mode view
+agent-relay local agent release <name>
 ```
 
-References:
-
-- [CHANGELOG.md](./CHANGELOG.md)
-- [GitHub Issues](https://github.com/AgentWorkforce/relay/issues)
-
-## License
-
-Apache-2.0 — Copyright 2026 Agent Workforce Incorporated
+Hosted equivalents live under `agent-relay cloud …`.
 
----
+## Packages
 
-**Links:** [Website](https://agentrelay.com) · [Documentation](https://agentrelay.com/docs) · [Docs (Markdown)](https://agentrelay.com/docs/markdown) · [Discord](https://discord.gg/6E6CTxM8um)
+- `@agent-relay/sdk`: messaging, delivery contracts, and actions.
+- `@agent-relay/harness-driver`: optional managed harness runtime.
+- `agent-relay`: CLI and MCP entry point.

package/dist/cli/agent-relay-mcp.d.ts

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { RelayCast, WsClient } from '@relaycast/sdk';
+import type { ActionAuditEvent, AgentRelayActions } from '@agent-relay/sdk/actions';
+export declare const AGENT_RELAY_MCP_VERSION: string;
+type AgentType = 'agent' | 'human';
+type RelayCastLike = Pick<RelayCast, 'agents'>;
+export interface AgentRelayMcpServerOptions {
+    workspaceKey?: string;
+    /** @deprecated Use workspaceKey. */
+    apiKey?: string;
+    baseUrl?: string;
+    agentToken?: string;
+    agentName?: string;
+    agentType?: AgentType;
+    strictAgentName?: boolean;
+    telemetryTransport?: 'stdio' | 'http';
+    skipBootstrap?: boolean;
+    actions?: AgentRelayActions;
+    onActionAuditEvent?: (event: ActionAuditEvent) => Promise<void> | void;
+}
+interface RegisteredAgent {
+    agentName: string;
+    agentToken: string;
+}
+interface SessionState {
+    workspaceKey: string | null;
+    agentToken: string | null;
+    agentName: string | null;
+    agents: Map<string, RegisteredAgent>;
+    wsBridge: RealtimeResourceBridge | null;
+    subscriptions: SubscriptionManager | null;
+    wsInitAttempted: boolean;
+}
+type RegistrationSession = Pick<SessionState, 'workspaceKey' | 'agentToken' | 'agentName'> & {
+    agents?: Map<string, RegisteredAgent>;
+};
+type SessionSetter = (partial: Partial<SessionState>) => void;
+type RegisterAgentWithRebindArgs = {
+    session: RegistrationSession;
+    setSession: SessionSetter;
+    getRelay: () => RelayCastLike;
+    name: string;
+    type?: AgentType;
+    persona?: string;
+    metadata?: Record<string, unknown>;
+    strictAgentName?: boolean;
+    preferredAgentName?: string | null;
+    forcedAgentType?: AgentType;
+};
+export declare function normalizeBaseUrl(baseUrl?: string): string;
+export declare function envFlagEnabled(value: string | undefined): boolean;
+export declare function normalizeAgentType(value: string | undefined): AgentType | undefined;
+export declare function registerAgentWithRebind({ session, setSession, getRelay, name, type, persona, metadata, strictAgentName, preferredAgentName, forcedAgentType, }: RegisterAgentWithRebindArgs): Promise<Record<string, unknown>>;
+declare class SubscriptionManager {
+    private readonly subscriptions;
+    subscribe(uri: string): void;
+    unsubscribe(uri: string): void;
+    getMatchingSubscriptions(uris: string[]): string[];
+    getAll(): string[];
+    clear(): void;
+}
+declare class RealtimeResourceBridge {
+    private readonly wsClient;
+    private readonly subscriptions;
+    private readonly notifyCallback;
+    private unsubscribeFn;
+    constructor(wsClient: WsClient, subscriptions: SubscriptionManager, notifyCallback: (uri: string) => void);
+    start(): void;
+    stop(): void;
+}
+export declare function createAgentRelayMcpServer(options: AgentRelayMcpServerOptions): McpServer;
+export declare function resolveStdioBootstrapOptions(options: AgentRelayMcpServerOptions): Promise<AgentRelayMcpServerOptions>;
+export declare function startAgentRelayMcpStdio(options: AgentRelayMcpServerOptions): Promise<void>;
+export declare function optionsFromEnv(): AgentRelayMcpServerOptions;
+export {};
+//# sourceMappingURL=agent-relay-mcp.d.ts.map

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

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