agent-relay-server 0.5.0 → 0.6.1

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,56 @@ 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 ChannelTargetHealth {
+  status: "ok" | "warning" | "error";
+  detail: string;
+  target: ChannelRouteTarget;
+  matches: Array<{
+    id: string;
+    name: string;
+    status: AgentCard["status"];
+    ready: boolean;
+    lastSeen: number;
+    label?: string;
+    tags: string[];
+    capabilities: string[];
+  }>;
+}
+
 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;
+  targetHealth?: ChannelTargetHealth;
   topicChannels: string[];
   capabilities: string[];
   tags: string[];