@cleocode/core 2026.3.74 → 2026.4.0

package/src/signaldock/signaldock-transport.ts

@@ -1,194 +0,0 @@
-/**
- * SignalDock HTTP transport — provider-neutral agent messaging via SignalDock REST API.
- *
- * This transport enables CLEO agents to communicate through SignalDock's
- * infrastructure regardless of which AI coding tool hosts them.
- *
- * IMPORTANT: This is a TypeScript HTTP client. No SignalDock source code
- * has been copied. All interactions use the public REST API.
- *
- * @task T5671
- */
-
-import type { AgentRegistration, AgentTransport, MessageResult } from './transport.js';
-import type {
-  Agent,
-  AgentClass,
-  ApiResponse,
-  Conversation,
-  ConversationVisibility,
-  Message,
-  NewAgent,
-  NewConversation,
-  NewMessage,
-  PrivacyTier,
-} from './types.js';
-
-/** Configuration for SignalDockTransport. */
-export interface SignalDockTransportConfig {
-  /** Base URL of the SignalDock API server. */
-  endpoint: string;
-  /** Prefix for agent names (e.g., "cleo-" -> "cleo-orchestrator"). */
-  agentPrefix: string;
-  /** Default privacy tier for registered agents. */
-  privacyTier: PrivacyTier;
-}
-
-/**
- * SignalDock HTTP transport implementation.
- *
- * Communicates with a SignalDock server via its REST API to provide
- * provider-neutral inter-agent messaging with delivery guarantees.
- */
-export class SignalDockTransport implements AgentTransport {
-  readonly name = 'signaldock';
-  private readonly config: SignalDockTransportConfig;
-
-  constructor(config: SignalDockTransportConfig) {
-    this.config = config;
-  }
-
-  async register(
-    name: string,
-    agentClass: AgentClass,
-    privacyTier: PrivacyTier,
-  ): Promise<AgentRegistration> {
-    const prefixedName = `${this.config.agentPrefix}${name}`;
-    const body: NewAgent = {
-      name: prefixedName,
-      agentClass,
-      privacyTier,
-    };
-
-    const response = await this.request<Agent>('POST', '/agents', body);
-
-    return {
-      agentId: response.id,
-      name: response.name,
-      agentClass: response.agentClass,
-      privacyTier: response.privacyTier,
-    };
-  }
-
-  async deregister(agentId: string): Promise<void> {
-    await this.request<void>('DELETE', `/agents/${encodeURIComponent(agentId)}`);
-  }
-
-  async send(
-    fromAgentId: string,
-    toAgentId: string,
-    content: string,
-    conversationId?: string,
-  ): Promise<MessageResult> {
-    let convId = conversationId;
-
-    if (!convId) {
-      const conversation = await this.createConversation([fromAgentId, toAgentId], 'private');
-      convId = conversation.id;
-    }
-
-    const body: NewMessage = {
-      conversationId: convId,
-      fromAgentId,
-      toAgentId,
-      content,
-      contentType: 'text',
-    };
-
-    const message = await this.request<Message>('POST', '/messages', body, fromAgentId);
-
-    return {
-      messageId: message.id,
-      conversationId: message.conversationId,
-      status: message.status === 'delivered' ? 'delivered' : 'pending',
-    };
-  }
-
-  async poll(agentId: string, since?: string): Promise<Message[]> {
-    const path = since
-      ? `/messages/poll/new?since=${encodeURIComponent(since)}`
-      : '/messages/poll/new';
-    const messages = await this.request<Message[]>('GET', path, undefined, agentId);
-    return messages;
-  }
-
-  async heartbeat(agentId: string): Promise<void> {
-    await this.request<void>(
-      'POST',
-      `/agents/${encodeURIComponent(agentId)}/heartbeat`,
-      undefined,
-      agentId,
-    );
-  }
-
-  async createConversation(
-    participants: string[],
-    visibility: ConversationVisibility = 'private',
-  ): Promise<Conversation> {
-    const body: NewConversation = {
-      participants: [...participants].sort(),
-      visibility,
-    };
-
-    return this.request<Conversation>('POST', '/conversations', body);
-  }
-
-  async getAgent(agentId: string): Promise<Agent | null> {
-    try {
-      return await this.request<Agent>('GET', `/agents/${encodeURIComponent(agentId)}`);
-    } catch {
-      return null;
-    }
-  }
-
-  /**
-   * Make an HTTP request to the SignalDock API.
-   */
-  private async request<T>(
-    method: string,
-    path: string,
-    body?: unknown,
-    agentId?: string,
-  ): Promise<T> {
-    const url = `${this.config.endpoint}${path}`;
-    const headers: Record<string, string> = {
-      'Content-Type': 'application/json',
-      Accept: 'application/json',
-    };
-
-    if (agentId) {
-      headers['X-Agent-Id'] = agentId;
-    }
-
-    const init: RequestInit = {
-      method,
-      headers,
-    };
-
-    if (body !== undefined) {
-      init.body = JSON.stringify(body);
-    }
-
-    const response = await fetch(url, init);
-
-    if (!response.ok) {
-      const text = await response.text().catch(() => '');
-      throw new Error(
-        `SignalDock API error: ${method} ${path} returned ${response.status}: ${text}`,
-      );
-    }
-
-    // DELETE may return no content
-    if (response.status === 204) {
-      return undefined as T;
-    }
-
-    const envelope = (await response.json()) as ApiResponse<T>;
-
-    if (!envelope.success && envelope.error) {
-      throw new Error(`SignalDock error [${envelope.error.code}]: ${envelope.error.message}`);
-    }
-
-    return envelope.data as T;
-  }
-}

package/src/signaldock/transport.ts

@@ -1,78 +0,0 @@
-/**
- * AgentTransport interface — provider-neutral abstraction for inter-agent communication.
- *
- * This interface enables CLEO's multi-tier orchestration to work with any
- * agent messaging backend: SignalDock (provider-neutral), Claude Code SDK
- * (provider-specific), or future Conduit implementations.
- *
- * @task T5671
- */
-
-import type {
-  Agent,
-  AgentClass,
-  Conversation,
-  ConversationVisibility,
-  Message,
-  PrivacyTier,
-} from './types.js';
-
-/** Result of agent registration. */
-export interface AgentRegistration {
-  agentId: string;
-  name: string;
-  agentClass: AgentClass;
-  privacyTier: PrivacyTier;
-}
-
-/** Result of sending a message. */
-export interface MessageResult {
-  messageId: string;
-  conversationId: string;
-  status: 'pending' | 'delivered';
-}
-
-/**
- * Provider-neutral interface for inter-agent communication.
- *
- * Implementations:
- * - SignalDockTransport: HTTP client for SignalDock REST API (provider-neutral)
- * - ClaudeCodeTransport: Wrapper around Claude Code SDK SendMessage (provider-specific)
- */
-export interface AgentTransport {
-  /** Transport name for logging and diagnostics. */
-  readonly name: string;
-
-  /** Register an agent with the transport layer. */
-  register(
-    name: string,
-    agentClass: AgentClass,
-    privacyTier: PrivacyTier,
-  ): Promise<AgentRegistration>;
-
-  /** Deregister an agent from the transport layer. */
-  deregister(agentId: string): Promise<void>;
-
-  /** Send a message to another agent. */
-  send(
-    fromAgentId: string,
-    toAgentId: string,
-    content: string,
-    conversationId?: string,
-  ): Promise<MessageResult>;
-
-  /** Poll for new messages addressed to this agent. */
-  poll(agentId: string, since?: string): Promise<Message[]>;
-
-  /** Send a heartbeat to keep the agent connection alive. */
-  heartbeat(agentId: string): Promise<void>;
-
-  /** Create a conversation between agents. */
-  createConversation(
-    participants: string[],
-    visibility?: ConversationVisibility,
-  ): Promise<Conversation>;
-
-  /** Get agent info by ID. */
-  getAgent(agentId: string): Promise<Agent | null>;
-}

package/src/signaldock/types.ts

@@ -1,100 +0,0 @@
-/**
- * TypeScript types for SignalDock protocol integration.
- * These mirror the public API surface of SignalDock-core.
- *
- * IMPORTANT: These types are derived from SignalDock's public REST API.
- * No proprietary source code has been copied.
- *
- * @task T5671
- */
-
-/** Functional classification of an agent. */
-export type AgentClass = 'personal_assistant' | 'code_dev' | 'research' | 'utility_bot' | 'custom';
-
-/** Visibility tier controlling agent discoverability. */
-export type PrivacyTier = 'public' | 'discoverable' | 'private';
-
-/** Current online status of an agent. */
-export type AgentStatus = 'online' | 'offline' | 'busy';
-
-/** Delivery status of a message. */
-export type MessageStatus = 'pending' | 'delivered' | 'read';
-
-/** Content type for message payloads. */
-export type ContentType = 'text';
-
-/** Visibility setting for a conversation. */
-export type ConversationVisibility = 'private' | 'public' | 'shared';
-
-/** A registered agent. */
-export interface Agent {
-  id: string;
-  name: string;
-  agentClass: AgentClass;
-  privacyTier: PrivacyTier;
-  status: AgentStatus;
-  createdAt: string;
-  updatedAt: string;
-}
-
-/** Payload for registering a new agent. */
-export interface NewAgent {
-  name: string;
-  agentClass: AgentClass;
-  privacyTier: PrivacyTier;
-}
-
-/** A message exchanged between two agents. */
-export interface Message {
-  id: string;
-  conversationId: string;
-  fromAgentId: string;
-  toAgentId: string;
-  content: string;
-  contentType: ContentType;
-  status: MessageStatus;
-  createdAt: string;
-  deliveredAt?: string;
-  readAt?: string;
-}
-
-/** Payload for creating a new message. */
-export interface NewMessage {
-  conversationId: string;
-  fromAgentId: string;
-  toAgentId: string;
-  content: string;
-  contentType: ContentType;
-}
-
-/** A conversation between agents. */
-export interface Conversation {
-  id: string;
-  participants: string[];
-  visibility: ConversationVisibility;
-  messageCount: number;
-  lastMessageAt?: string;
-  createdAt: string;
-  updatedAt: string;
-}
-
-/** Payload for creating a new conversation. */
-export interface NewConversation {
-  participants: string[];
-  visibility: ConversationVisibility;
-}
-
-/** Standard API response envelope. */
-export interface ApiResponse<T> {
-  success: boolean;
-  data?: T;
-  error?: {
-    code: string;
-    message: string;
-  };
-  meta?: {
-    page?: number;
-    pageSize?: number;
-    total?: number;
-  };
-}