agent-relay-server 0.4.39 → 0.6.0

package/src/security.ts

@@ -95,7 +95,8 @@ export function requiredScopeFor(method: string, pathname: string): string | nul
   if (pathname === "/api/stats") return "stats:read";
   if (pathname === "/api/health") return "health:read";
   if (pathname === "/api/events") return "events:read";
-  if (pathname === "/api/channels") return "channels:read";
+  if (pathname === "/api/connectors" || pathname.startsWith("/api/connectors/")) return method === "GET" ? "connectors:read" : "system:write";
+  if (pathname.startsWith("/api/channels") || pathname.startsWith("/api/channel-bindings")) return method === "GET" ? "channels:read" : "channels:write";
   if (pathname === "/api/integrations" || pathname.startsWith("/api/integrations/")) return method === "GET" ? "integrations:read" : "integrations:write";
   if (pathname.startsWith("/api/agents")) return method === "GET" ? "agents:read" : "agents:write";
   if (pathname.startsWith("/api/activity")) return method === "GET" ? "activity:read" : "activity:write";

package/src/sse.ts

@@ -1,4 +1,4 @@
-import { getAgent } from "./db";
+import { getAgent, getOrchestrator } from "./db";
 import type { Message, Task } from "./types";
 
 interface Connection {
@@ -122,6 +122,12 @@ export function emitTaskChanged(task: Task, eventType = "task.updated") {
   }
 }
 
+export function emitChannelActivity(activity: Record<string, unknown>) {
+  for (const conn of connections.values()) {
+    send(conn, "channel.activity", activity);
+  }
+}
+
 export function getConnectionCount(): number {
   return connections.size;
 }
@@ -135,3 +141,17 @@ function targetMatchesAgent(target: string, agentId: string): boolean {
   if (target.startsWith("label:") && agent.label === target.slice(6)) return true;
   return false;
 }
+
+export function emitOrchestratorStatus(orchestratorId: string) {
+  const orch = getOrchestrator(orchestratorId);
+  const data = orch ?? { id: orchestratorId, status: "offline" };
+  for (const conn of connections.values()) {
+    send(conn, "orchestrator.status", data);
+  }
+}
+
+export function emitOrchestratorRemoved(orchestratorId: string) {
+  for (const conn of connections.values()) {
+    send(conn, "orchestrator.removed", { id: orchestratorId });
+  }
+}

package/src/types.ts

@@ -1,6 +1,9 @@
+export type AgentKind = "provider" | "channel" | "orchestrator" | "system" | "user";
+
 export interface AgentCard {
   id: string;
   name: string;
+  kind: AgentKind;
   label?: string; // human-friendly alias; acts as a fan-out target ("label:foo")
   tags: string[];
   machine?: string;
@@ -15,13 +18,19 @@ export interface AgentCard {
   createdAt: number;
 }
 
-export type MessageType = "message" | "system";
+export type MessageKind =
+  | "chat"
+  | "channel.event"
+  | "task"
+  | "pair"
+  | "control"
+  | "system";
 
 export interface Message {
   id: number;
   from: string;
   to: string; // agent-id | "tag:<name>" | "broadcast" | "cap:<name>"
-  type: MessageType;
+  kind: MessageKind;
   channel?: string;
   subject?: string;
   body: string;
@@ -32,6 +41,7 @@ export interface Message {
   claimedAt?: number;
   claimExpiresAt?: number;
   idempotencyKey?: string;
+  payload: Record<string, unknown>;
   meta?: Record<string, unknown>;
   readBy: string[];
   createdAt: number;
@@ -40,16 +50,71 @@ export interface Message {
 export interface SendMessageInput {
   from: string;
   to: string;
-  type?: MessageType;
+  kind?: MessageKind;
   channel?: string;
   subject?: string;
   body: string;
   replyTo?: number;
   claimable?: boolean;
   idempotencyKey?: string;
+  payload?: Record<string, unknown>;
   meta?: Record<string, unknown>;
 }
 
+export type ConnectorKind = "channel" | "event" | "provider" | "orchestrator";
+export type ConnectorAction = "install" | "uninstall" | "enable" | "disable" | "start" | "stop" | "restart" | "status" | "doctor";
+
+export interface ConnectorManifest {
+  schema: "agent-relay.connector.v1";
+  id: string;
+  kind: ConnectorKind;
+  packageName?: string;
+  binary: string;
+  displayName: string;
+  description?: string;
+  version: string;
+  capabilities: string[];
+  commands: Partial<Record<ConnectorAction, string[]>>;
+  configSchema?: Record<string, unknown>;
+}
+
+interface ConnectorRuntime {
+  installed: boolean;
+  enabled?: boolean;
+  running?: boolean;
+  status?: "ok" | "warn" | "error" | "unknown";
+  detail?: string;
+  updatedAt?: string;
+  raw?: unknown;
+}
+
+export interface ConnectorSummary {
+  id: string;
+  kind: ConnectorKind;
+  displayName: string;
+  description?: string;
+  version: string;
+  packageName?: string;
+  binary: string;
+  capabilities: string[];
+  registryPath: string;
+  manifest: ConnectorManifest;
+  config?: Record<string, unknown>;
+  state?: Record<string, unknown>;
+  runtime: ConnectorRuntime;
+}
+
+export interface ConnectorActionResult {
+  connectorId: string;
+  action: ConnectorAction;
+  command?: string[];
+  ok: boolean;
+  exitCode?: number | null;
+  stdout?: string;
+  stderr?: string;
+  parsed?: unknown;
+}
+
 export type PairStatus = "pending" | "active" | "ended" | "rejected" | "expired";
 
 export interface PairSession {
@@ -99,6 +164,7 @@ export interface PollQuery {
 export interface RegisterAgentInput {
   id: string;
   name: string;
+  kind?: AgentKind;
   label?: string | null;
   tags?: string[];
   machine?: string;
@@ -203,16 +269,39 @@ export interface IntegrationSummary {
 
 export type ChannelDirection = "inbound" | "outbound" | "bidirectional";
 
+export type ChannelRouteTarget =
+  | { type: "agent"; id: string }
+  | { type: "label"; id: string }
+  | { type: "tag"; id: string }
+  | { type: "capability"; id: string }
+  | { type: "broadcast" }
+  | { type: "orchestrator"; id: string };
+
+export type ChannelBindingMode = "exclusive" | "claimable" | "broadcast";
+
+export interface ChannelBinding {
+  id: string;
+  channelId: string;
+  conversationId?: string;
+  target: ChannelRouteTarget;
+  mode: ChannelBindingMode;
+  priority: number;
+  createdAt: number;
+  updatedAt: number;
+}
+
 export interface ChannelSummary {
   id: string;
   name: string;
   type: string;
   transport: string;
   agentId: string;
+  accountId: string;
   status: AgentCard["status"];
   ready: boolean;
   direction: ChannelDirection;
   target?: string;
+  binding?: ChannelBinding;
   topicChannels: string[];
   capabilities: string[];
   tags: string[];
@@ -291,6 +380,66 @@ export interface ActivityEventInput {
   metadata?: Record<string, unknown>;
 }
 
+// --- Orchestrators ---
+
+export type OrchestratorStatus = "online" | "offline";
+export type SpawnProvider = "claude" | "codex";
+export type SpawnApprovalMode = "open" | "guarded" | "read-only";
+
+export interface Orchestrator {
+  id: string;
+  hostname: string;
+  status: OrchestratorStatus;
+  agentId: string; // relay agent id for messaging
+  providers: SpawnProvider[];
+  baseDir: string;
+  envKeys: string[]; // names only, never values
+  meta: Record<string, unknown>;
+  managedAgents: ManagedAgent[];
+  lastSeen: number;
+  createdAt: number;
+}
+
+export interface ManagedAgent {
+  agentId: string;
+  provider: SpawnProvider;
+  tmuxSession: string;
+  cwd: string;
+  label?: string;
+  approvalMode: SpawnApprovalMode;
+  pid?: number;
+  startedAt: number;
+}
+
+export interface RegisterOrchestratorInput {
+  id: string;
+  hostname: string;
+  providers: SpawnProvider[];
+  baseDir: string;
+  envKeys?: string[];
+  meta?: Record<string, unknown>;
+}
+
+export interface OrchestratorSpawnInput {
+  provider: SpawnProvider;
+  cwd?: string;
+  label?: string;
+  approvalMode?: SpawnApprovalMode;
+  prompt?: string;
+  env?: Record<string, string>;
+}
+
+export interface OrchestratorSpawnResult {
+  orchestratorId: string;
+  provider: SpawnProvider;
+  tmuxSession: string;
+  cwd: string;
+  label?: string;
+  approvalMode: SpawnApprovalMode;
+  pid?: number;
+  startedAt: number;
+}
+
 export interface HealthCheck {
   name: string;
   status: "ok" | "warn" | "error";