agent-relay-server 0.4.16 → 0.4.17

package/src/types.ts

@@ -8,6 +8,8 @@ export interface AgentCard {
   capabilities: string[];
   ready: boolean;
   status: "online" | "idle" | "busy" | "offline";
+  instanceId?: string;
+  epoch: number;
   meta?: Record<string, unknown>;
   lastSeen: number;
   createdAt: number;
@@ -28,6 +30,8 @@ export interface Message {
   claimable?: boolean;
   claimedBy?: string;
   claimedAt?: number;
+  claimExpiresAt?: number;
+  idempotencyKey?: string;
   meta?: Record<string, unknown>;
   readBy: string[];
   createdAt: number;
@@ -42,9 +46,47 @@ export interface SendMessageInput {
   body: string;
   replyTo?: number;
   claimable?: boolean;
+  idempotencyKey?: string;
   meta?: Record<string, unknown>;
 }
 
+export type PairStatus = "pending" | "active" | "ended" | "rejected" | "expired";
+
+export interface PairSession {
+  id: string;
+  requesterId: string;
+  targetId: string;
+  status: PairStatus;
+  objective?: string;
+  createdAt: number;
+  updatedAt: number;
+  expiresAt: number;
+  acceptedAt?: number;
+  endedAt?: number;
+  endedBy?: string;
+  lastMessageAt?: number;
+  meta: Record<string, unknown>;
+}
+
+export interface CreatePairInput {
+  from: string;
+  target: string;
+  objective?: string;
+  ttlMs?: number;
+  meta?: Record<string, unknown>;
+}
+
+export interface PairActionInput {
+  agentId: string;
+  reason?: string;
+}
+
+export interface PairMessageInput {
+  from: string;
+  body: string;
+  subject?: string;
+}
+
 export interface PollQuery {
   for: string; // agent-id
   since?: number; // unix ms (createdAt cursor)
@@ -64,9 +106,15 @@ export interface RegisterAgentInput {
   capabilities?: string[];
   ready?: boolean;
   status?: AgentCard["status"];
+  instanceId?: string;
   meta?: Record<string, unknown>;
 }
 
+export interface AgentSessionGuard {
+  instanceId?: string;
+  epoch?: number;
+}
+
 export type TaskSeverity = "info" | "warning" | "critical";
 export type TaskStatus =
   | "open"
@@ -91,6 +139,7 @@ export interface Task {
   occurrenceCount: number;
   claimedBy?: string;
   claimedAt?: number;
+  claimExpiresAt?: number;
   messageId?: number;
   result?: string;
   metadata: Record<string, unknown>;
@@ -128,7 +177,23 @@ export interface IntegrationEventInput {
 export interface TaskStatusInput {
   status: TaskStatus;
   agentId?: string;
+  instanceId?: string;
+  epoch?: number;
   result?: string;
   body?: string;
   metadata?: Record<string, unknown>;
 }
+
+export interface HealthCheck {
+  name: string;
+  status: "ok" | "warn" | "error";
+  detail?: string;
+  count?: number;
+}
+
+export interface HealthReport {
+  status: "ok" | "degraded" | "error";
+  version: string;
+  generatedAt: number;
+  checks: HealthCheck[];
+}