Interface IPackAgent

src/runtime/adapters/types.ts:125–161

  rootDir: string;
  provider: string;
  modelId: string;
  baseUrl?: string;
  apiProtocol?: "openai-responses" | "openai-completions";
  reasoning?: boolean;
  requestHeadersProvider?: RequestHeadersProvider;
  hostRequestHeadersEnabled?: boolean;
  lifecycleHandler: LifecycleHandler;
}

/**
 * PackAgent interface – platform-agnostic agent layer.
 * Each adapter calls these methods; the agent handles session state internally.
 */
export interface IPackAgent {
  /** Handle an incoming message with streaming events */
  handleMessage(
    adapter: RuntimePlatform,
    channelId: string,
    text: string,
    onEvent: (event: AgentEvent) => void,
    attachments?: ChannelAttachment[],
  ): Promise<HandleResult>;

  /** Handle a built-in bot command */
  handleCommand(command: BotCommand, channelId: string): Promise<CommandResult>;

  /** Abort the current run for a channel */
  abort(channelId: string): void;

  /** Check if a channel is currently running */
  isRunning(channelId: string): boolean;

  /** Dispose the session for a channel */
  dispose(channelId: string): void;

  /** Reserved: list all sessions */
  listSessions(): SessionInfo[];

  /** Reserved: restore a historical session */
  restoreSession(sessionId: string): Promise<void>;