Skip to content

Soul-driven AI agent with permission-hardened tools, token budgets, and multi-channel access. Runs 24/7 from CLI, Telegram or More.

2.2 KB
Raw Blame
import type { ChannelType, ChannelMessage } from '../types/channel.js';

export type PermissionMode = 'allow-all' | 'ask-me';

/** A tappable button that runs a slash command as if the user had typed it (ADR-023). */
export interface ChannelAction {
  label: string;
  command: string;
}

export interface Channel {
  readonly type: ChannelType;
  start(): Promise<void>;
  stop(): Promise<void>;
  send(content: string, targetId?: string, elapsedMs?: number): Promise<void>;
  sendFile(filePath: string, targetId?: string): Promise<void>;
  /** Text with rows of tappable actions; channels without buttons leave this undefined and callers fall back to send(). */
  sendWithActions?(content: string, rows: ChannelAction[][], targetId?: string): Promise<void>;
  stream(content: AsyncIterable<string>, targetId?: string): Promise<string>;
  typing(targetId?: string): Promise<void>;
  askToContinue(question: string, targetId?: string): Promise<boolean>;
  askPermissionMode?(): Promise<PermissionMode>;
  isReady(): boolean;
  onMessage(handler: (msg: ChannelMessage) => void): void;
  /**
   * No chat of its own (e.g. the desktop voice channel): broadcasts skip it
   * and it's never picked for notifications. Its own send() forwards to the
   * owner's chats, so including it in a broadcast would loop.
   */
  readonly noBroadcast?: boolean;
}

export abstract class BaseChannel implements Channel {
  abstract readonly type: ChannelType;
  protected messageHandler?: (msg: ChannelMessage) => void;
  protected ready = false;

  abstract start(): Promise<void>;
  abstract stop(): Promise<void>;
  abstract send(content: string, targetId?: string, elapsedMs?: number): Promise<void>;
  abstract sendFile(filePath: string, targetId?: string): Promise<void>;
  abstract stream(content: AsyncIterable<string>, targetId?: string): Promise<string>;
  abstract typing(targetId?: string): Promise<void>;
  abstract askToContinue(question: string, targetId?: string): Promise<boolean>;

  isReady(): boolean {
    return this.ready;
  }

  onMessage(handler: (msg: ChannelMessage) => void): void {
    this.messageHandler = handler;
  }

  protected emit(message: ChannelMessage): void {
    this.messageHandler?.(message);
  }
}