bloby-bot 0.32.0 → 0.32.1

package/supervisor/harnesses/codex.ts

@@ -0,0 +1,73 @@
+/**
+ * Codex (OpenAI app-server) harness — STUB for Phase 1.
+ *
+ * Phase 1 introduces the harness split with zero behavior change for Claude
+ * users. Codex routing is wired up but every method emits a clear "not
+ * implemented yet" error so we can spot any accidental route during testing.
+ *
+ * Phase 2 will spawn `codex app-server` over stdio JSON-RPC, manage threads,
+ * and translate item/turn notifications into the shared `bot:*` event vocab.
+ */
+
+import { log } from '../../shared/logger.js';
+import type { OnAgentMessage, RecentMessage, AgentAttachment } from './types.js';
+import type { SavedFile } from '../file-saver.js';
+
+const NOT_READY = 'OpenAI/Codex harness is not implemented yet. Switch the provider back to Anthropic, or wait for Phase 2 of the harness work.';
+
+function emitNotReady(conversationId: string, onMessage: OnAgentMessage): void {
+  log.warn(`[codex-harness] ${NOT_READY}`);
+  onMessage('bot:error', { conversationId, error: NOT_READY });
+  onMessage('bot:done', { conversationId, usedFileTools: false });
+}
+
+export async function startConversation(
+  conversationId: string,
+  _model: string,
+  onMessage: OnAgentMessage,
+  _names?: { botName: string; humanName: string },
+  _recentMessages?: RecentMessage[],
+): Promise<boolean> {
+  emitNotReady(conversationId, onMessage);
+  return false;
+}
+
+export function pushMessage(
+  conversationId: string,
+  _content: string,
+  _attachments?: AgentAttachment[],
+  _savedFiles?: SavedFile[],
+): boolean {
+  log.warn(`[codex-harness] pushMessage(${conversationId}) — ${NOT_READY}`);
+  return false;
+}
+
+export function hasConversation(_conversationId: string): boolean {
+  return false;
+}
+
+export function endConversation(_conversationId: string): void { /* no-op */ }
+export function endAllConversations(): void { /* no-op */ }
+export function isConversationBusy(_conversationId: string): boolean { return false; }
+export async function stopSubAgentTask(_conversationId: string, _taskId: string): Promise<void> { /* no-op */ }
+export async function warmUpForLiveConversation(
+  _model: string,
+  _names?: { botName: string; humanName: string },
+): Promise<void> { /* no-op */ }
+
+export async function startBlobyAgentQuery(
+  conversationId: string,
+  _prompt: string,
+  _model: string,
+  onMessage: OnAgentMessage,
+  _attachments?: AgentAttachment[],
+  _savedFiles?: SavedFile[],
+  _names?: { botName: string; humanName: string },
+  _recentMessages?: RecentMessage[],
+  _supportPrompt?: string,
+  _maxTurns?: number,
+): Promise<void> {
+  emitNotReady(conversationId, onMessage);
+}
+
+export function stopBlobyAgentQuery(_conversationId: string): void { /* no-op */ }

package/supervisor/harnesses/types.ts

@@ -0,0 +1,81 @@
+/**
+ * Harness — provider-agnostic agent runtime contract.
+ *
+ * Each AI provider that ships an "agent" experience (Claude Agent SDK,
+ * Codex app-server, …) implements this interface. The dispatcher in
+ * `supervisor/bloby-agent.ts` selects which one to use based on
+ * `cfg.ai.provider` so the rest of the supervisor never needs to care.
+ *
+ * The two execution shapes mirror what the supervisor already needs:
+ *   • startConversation / pushMessage / endConversation — long-lived chat
+ *     with streaming events. Used by the dashboard and admin WhatsApp.
+ *   • startBlobyAgentQuery / stopBlobyAgentQuery — one-shot request/response
+ *     used by customer WhatsApp and the scheduler.
+ *
+ * Event names emitted via the `onMessage` callback are the same vocabulary
+ * `supervisor/index.ts` and `channels/manager.ts` already consume — every
+ * harness translates its native events into this set:
+ *   bot:typing, bot:token, bot:tool, bot:response, bot:turn-complete,
+ *   bot:done, bot:error, bot:task-created, bot:task-progress, bot:task-done,
+ *   bot:conversation-ended.
+ */
+
+import type { SavedFile } from '../file-saver.js';
+
+export interface RecentMessage {
+  role: 'user' | 'assistant';
+  content: string;
+}
+
+export interface AgentAttachment {
+  type: 'image' | 'file';
+  name: string;
+  mediaType: string;
+  data: string; // base64
+}
+
+export type OnAgentMessage = (type: string, data: any) => void;
+
+export interface Harness {
+  /* ── Live conversation API ── */
+  startConversation(
+    conversationId: string,
+    model: string,
+    onMessage: OnAgentMessage,
+    names?: { botName: string; humanName: string },
+    recentMessages?: RecentMessage[],
+  ): Promise<boolean>;
+
+  pushMessage(
+    conversationId: string,
+    content: string,
+    attachments?: AgentAttachment[],
+    savedFiles?: SavedFile[],
+  ): boolean;
+
+  hasConversation(conversationId: string): boolean;
+  endConversation(conversationId: string): void;
+  endAllConversations(): void;
+  isConversationBusy(conversationId: string): boolean;
+  stopSubAgentTask(conversationId: string, taskId: string): Promise<void>;
+  warmUpForLiveConversation(
+    model: string,
+    names?: { botName: string; humanName: string },
+  ): Promise<void>;
+
+  /* ── One-shot API (request/response) ── */
+  startBlobyAgentQuery(
+    conversationId: string,
+    prompt: string,
+    model: string,
+    onMessage: OnAgentMessage,
+    attachments?: AgentAttachment[],
+    savedFiles?: SavedFile[],
+    names?: { botName: string; humanName: string },
+    recentMessages?: RecentMessage[],
+    supportPrompt?: string,
+    maxTurns?: number,
+  ): Promise<void>;
+
+  stopBlobyAgentQuery(conversationId: string): void;
+}