chat: rename the pi chat transport + model list to chat (Stage 4b/1)

Pure rename, no behavior change. Moves the misnamed "pi" chat harness into the
chat namespace:

- api/pi/{websocket,session-manager,types,logger,list-models} → api/chat/
- merge api/pi/rest.ts into api/chat/chat.ts (/pi/models → /chat/models,
  /pi/stt → /chat/stt); drop the piRestRouter mount
- PiEvent → ChatEvent, piWebsocket → chatWebsocket, listPiModels → listChatModels
- WS route /api/pi/chat/ws → /api/chat/ws, provider tag 'pi' → 'chat'
- frontend: useChat/useAudioRecording URLs, usePiModels→useModels /
  useVisiblePiModels→useVisibleModels / useEnabledPiModels→useEnabledModels,
  'PI_MODELS' query key → 'CHAT_MODELS', attachments provider 'pi-mono' → 'chat'

The /pi-mono provider/harness settings router is renamed separately (next commit).
Note: the WS route change requires the mobile app to point at /api/chat/ws.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

src/servers/api/chat-types.ts

@@ -1,8 +1,8 @@
 /**
- * @deprecated Legacy chat types - Use types from ./pi/types.ts instead
+ * @deprecated Legacy chat types - Use types from ./chat/types.ts instead
  * 
  * This file is kept for backward compatibility with existing code.
- * New code should import from ./pi/types.ts
+ * New code should import from ./chat/types.ts
  */
 
 // Re-export new Pi types for compatibility
@@ -13,8 +13,8 @@ export type {
   MessageCost,
   SessionMeta,
   ModelInfo,
-  PiEvent,
-} from './pi/types';
+  ChatEvent,
+} from './chat/types';
 
 // Legacy types (kept for compatibility)
 export type ImageData = { mediaType: string; data: string };

src/servers/api/chat/chat.ts

@@ -1,5 +1,6 @@
 import type { Context } from 'hono';
 import { createRouter } from '../../create-router';
+import { getUserSettings } from 'officerdb';
 import {
   getClaudeSessionsCwd,
   listClaudePwds,
@@ -8,6 +9,10 @@ import {
   deleteClaudeSession,
   renameClaudeSession,
 } from './claude-sessions';
+import { listChatModels } from './list-models';
+import { logger } from './logger';
+import { readSttConfig } from '../server-settings/stt';
+import { transcribeAudio } from '../stt/transcribe';
 
 export const chatRouter = createRouter();
 
@@ -52,3 +57,41 @@ chatRouter.patch('/sessions/:id/title', async (ctx) => {
   if (!ok) return ctx.text('Not found', 404);
   return ctx.json({ ok: true });
 });
+
+// GET /chat/models — Claude tiers only (the runner is the `claude` CLI).
+chatRouter.get('/models', async (ctx: Context) => {
+  try {
+    const models = await listChatModels();
+    const providerNames: Record<string, string> = { 'claude-code': 'Claude Code' };
+    return ctx.json({ models, providerNames, hostHome: process.env.HOME ?? '' });
+  } catch (err) {
+    logger.error('Failed to list models', { error: String(err) });
+    return ctx.json({ models: [], providerNames: {} });
+  }
+});
+
+// POST /chat/stt — proxy an audio clip to the configured Whisper server.
+chatRouter.post('/stt', async (ctx: Context) => {
+  const sttConfig = await readSttConfig();
+  if (!sttConfig?.url) {
+    return ctx.json({ error: 'Whisper not configured — set it up in Settings → Speech to Text' }, 400);
+  }
+
+  const user = ctx.get('user');
+  const body = await ctx.req.parseBody();
+  const file = body['file'];
+  if (!file || !(file instanceof File)) {
+    return ctx.json({ error: 'file is required' }, 400);
+  }
+
+  const settings = (await getUserSettings(user.id)) as { languages?: { spoken?: string[] } };
+  const spokenLanguages = settings.languages?.spoken ?? [];
+
+  try {
+    const result = await transcribeAudio({ file, whisperUrl: sttConfig.url, spokenLanguages });
+    return ctx.json(result);
+  } catch (err) {
+    logger.error('STT proxy failed', { error: String(err) });
+    return ctx.json({ error: err instanceof Error ? err.message : 'Failed to reach Whisper server' }, 502);
+  }
+});

src/servers/api/chat/list-models.ts

@@ -11,6 +11,6 @@ export function invalidateModelCache(): void {
   // No-op: the Claude model list is static. Kept for call-site compatibility.
 }
 
-export async function listPiModels(): Promise<ModelInfo[]> {
+export async function listChatModels(): Promise<ModelInfo[]> {
   return [...CLAUDE_CODE_MODELS];
 }

src/servers/api/chat/types.ts

@@ -120,7 +120,7 @@ export type ServerMessage =
       type: 'stopped';
     };
 
-export type PiEvent =
+export type ChatEvent =
   | { type: 'text'; text: string }
   | { type: 'delta'; text: string }
   | {

src/servers/api/chat/websocket.ts

@@ -1,9 +1,9 @@
 import type { ServerWebSocket } from 'bun';
 import { randomUUID } from 'crypto';
-import type { ClientMessage, ServerMessage, Message, PiEvent } from './types';
+import type { ClientMessage, ServerMessage, Message, ChatEvent } from './types';
 import { sessionManager } from './session-manager';
 import { sendClaudeCodeStreaming } from '@@/channels/send-claude-code';
-import { ensureClaudeSessionsCwd } from '../chat/claude-sessions';
+import { ensureClaudeSessionsCwd } from './claude-sessions';
 import * as sidecar from '@@/sidecar-registry';
 import { join } from 'path';
 import { getHomeDirForRole } from '../../../servers/data-path';
@@ -113,7 +113,7 @@ export function close(ws: ServerWebSocket<WSData>): void {
 }
 
 function createEventHandler(sessionId: string, model: string, cwd: string) {
-  return async (event: PiEvent): Promise<void> => {
+  return async (event: ChatEvent): Promise<void> => {
     const session = sessionManager.getSession(sessionId);
     if (!session) return;
 
@@ -441,7 +441,7 @@ async function handleStop(ws: ServerWebSocket<WSData>): Promise<void> {
   sendToClient(ws, { type: 'stopped' });
 }
 
-export const piWebsocket = {
+export const chatWebsocket = {
   open,
   message,
   close,

src/servers/api/pi/rest.ts

@@ -1,51 +0,0 @@
-import type { Context } from 'hono';
-import { createRouter } from '../../create-router';
-import { readSttConfig } from '../server-settings/stt';
-import { listPiModels } from './list-models';
-import { logger } from './logger';
-import { transcribeAudio } from '../stt/transcribe';
-import { getUserSettings } from 'officerdb';
-
-export const piRestRouter = createRouter();
-
-/**
- * GET /api/pi/models — Claude tiers only.
- */
-piRestRouter.get('/pi/models', async (ctx: Context) => {
-  try {
-    const models = await listPiModels();
-    const providerNames: Record<string, string> = { 'claude-code': 'Claude Code' };
-    return ctx.json({ models, providerNames, hostHome: process.env.HOME ?? '' });
-  } catch (err) {
-    logger.error('Failed to list models', { error: String(err) });
-    return ctx.json({ models: [], providerNames: {} });
-  }
-});
-
-/**
- * POST /api/pi/stt
- */
-piRestRouter.post('/pi/stt', async (ctx: Context) => {
-  const sttConfig = await readSttConfig();
-  if (!sttConfig?.url) {
-    return ctx.json({ error: 'Whisper not configured — set it up in Settings → Speech to Text' }, 400);
-  }
-
-  const user = ctx.get('user');
-  const body = await ctx.req.parseBody();
-  const file = body['file'];
-  if (!file || !(file instanceof File)) {
-    return ctx.json({ error: 'file is required' }, 400);
-  }
-
-  const settings = (await getUserSettings(user.id)) as { languages?: { spoken?: string[] } };
-  const spokenLanguages = settings.languages?.spoken ?? [];
-
-  try {
-    const result = await transcribeAudio({ file, whisperUrl: sttConfig.url, spokenLanguages });
-    return ctx.json(result);
-  } catch (err) {
-    logger.error('STT proxy failed', { error: String(err) });
-    return ctx.json({ error: err instanceof Error ? err.message : 'Failed to reach Whisper server' }, 502);
-  }
-});

src/servers/api/server-settings/pi-mono.ts

@@ -1,8 +1,8 @@
 import { join } from 'node:path';
 import { createRouter } from '../../create-router';
 import { PI_CONFIG_DIR } from '../../data-path';
-import { invalidateModelCache } from '../pi/list-models';
-import { logger } from '../pi/logger';
+import { invalidateModelCache } from '../chat/list-models';
+import { logger } from '../chat/logger';
 import { readConfigValue, writeConfigValue } from 'officerdb';
 
 export const piMonoRouter = createRouter();

src/servers/api/tasks/pipeline-executor.ts

@@ -6,10 +6,10 @@ import { tmpdir } from 'node:os';
 import { getUserSettings } from 'officerdb';
 import { getTaskByDirName } from './task-files';
 import { getHomeDirForRole, getHomeDir } from '../../data-path';
-import { resolveBaseCwd } from '../pi/websocket';
+import { resolveBaseCwd } from '../chat/websocket';
 import { SANDBOX_HOME } from '../../sidecar/sandbox';
 import { sendClaudeCodeStreaming } from '../../channels/send-claude-code';
-import type { PiEvent, MessageCost } from '../pi/types';
+import type { ChatEvent, MessageCost } from '../chat/types';
 import * as jobManager from './pipeline-job-manager';
 
 const DEFAULT_MODEL = 'claude-code';
@@ -117,7 +117,7 @@ async function runAgenticStep({ userId, email, username, role, taskDirName, prom
       fn();
     };
 
-    const onEvent = (event: PiEvent) => {
+    const onEvent = (event: ChatEvent) => {
       if (abortSignal.aborted) return;
       lastActivity = Date.now();
 

src/servers/channels/discord/handler.ts

@@ -3,11 +3,11 @@ import { findUserByIntegrationConfig, readConfigValue } from 'officerdb';
 import { sendAndAwait, getSessionModel, setSessionModel } from '../send-and-await';
 import { consumePairingCode } from '../pairing';
 import { chunkMessage } from './chunker';
-import { listPiModels } from '@@/api/pi/list-models';
+import { listChatModels } from '@@/api/chat/list-models';
 import { enqueueJob } from '../../queue/init';
 import { readJob } from '@@/queue/storage';
 import { openUserEmailDb } from '@@/api/email/email-db';
-import type { ModelInfo } from '@@/api/pi/types';
+import type { ModelInfo } from '@@/api/chat/types';
 import { toShellUsername } from '@@/data-path';
 
 const PAIRING_CODE_PATTERN = /^[A-Z0-9]{6}$/;
@@ -19,7 +19,7 @@ type AccessPolicy = { allowedModels: string[] };
 const ACCESS_POLICY_KEY = 'pi-access-policy';
 
 async function getVisibleModels(): Promise<ModelInfo[]> {
-  const allModels = await listPiModels();
+  const allModels = await listChatModels();
   const policy = await readConfigValue<AccessPolicy>(ACCESS_POLICY_KEY, { allowedModels: [] });
   const allowed = policy.allowedModels;
 

src/servers/channels/send-and-await.ts

@@ -1,6 +1,6 @@
-import type { MessageCost } from '@@/api/pi/types';
+import type { MessageCost } from '@@/api/chat/types';
 import { getUserSettings } from 'officerdb';
-import { logger } from '@@/api/pi/logger';
+import { logger } from '@@/api/chat/logger';
 import { sendClaudeCode, clearClaudeCodeSession } from './send-claude-code';
 
 const DEFAULT_MODEL = 'claude-code';

src/servers/channels/send-claude-code.ts

@@ -1,5 +1,5 @@
-import { logger } from '@@/api/pi/logger';
-import type { MessageCost, PiEvent } from '@@/api/pi/types';
+import { logger } from '@@/api/chat/logger';
+import type { MessageCost, ChatEvent } from '@@/api/chat/types';
 import * as sidecar from '@@/sidecar-registry';
 
 type ClaudeCodeParams = {
@@ -40,7 +40,7 @@ type ClaudeCodeStreamingParams = {
   model?: string;
   role?: string;
   resumeSessionId?: string;
-  onEvent: (event: PiEvent) => void;
+  onEvent: (event: ChatEvent) => void;
 };
 
 type ClaudeCodeStreamingHandle = {

src/servers/channels/telegram/handler.ts

@@ -4,11 +4,11 @@ import { sendAndAwait, getSessionModel, setSessionModel } from '../send-and-awai
 import { consumePairingCode } from '../pairing';
 import { chunkMessage } from './chunker';
 import { getTelegramBot } from './bot';
-import { listPiModels } from '@@/api/pi/list-models';
+import { listChatModels } from '@@/api/chat/list-models';
 import { enqueueJob } from '../../queue/init';
 import { readJob } from '@@/queue/storage';
 import { openUserEmailDb } from '@@/api/email/email-db';
-import type { ModelInfo } from '@@/api/pi/types';
+import type { ModelInfo } from '@@/api/chat/types';
 import { toShellUsername } from '@@/data-path';
 
 const PAIRING_CODE_PATTERN = /^[A-Z0-9]{6}$/;
@@ -20,7 +20,7 @@ type AccessPolicy = { allowedModels: string[] };
 const ACCESS_POLICY_KEY = 'pi-access-policy';
 
 async function getVisibleModels(): Promise<ModelInfo[]> {
-  const allModels = await listPiModels();
+  const allModels = await listChatModels();
   const policy = await readConfigValue<AccessPolicy>(ACCESS_POLICY_KEY, { allowedModels: [] });
   const allowed = policy.allowedModels;
 

src/servers/channels/whatsapp/handler.ts

@@ -3,11 +3,11 @@ import { findUserByIntegrationConfig, readConfigValue } from 'officerdb';
 import { sendAndAwait, getSessionModel, setSessionModel } from '../send-and-await';
 import { consumePairingCode } from '../pairing';
 import { getWhatsAppClient } from './bot';
-import { listPiModels } from '@@/api/pi/list-models';
+import { listChatModels } from '@@/api/chat/list-models';
 import { enqueueJob } from '../../queue/init';
 import { readJob } from '@@/queue/storage';
 import { openUserEmailDb } from '@@/api/email/email-db';
-import type { ModelInfo } from '@@/api/pi/types';
+import type { ModelInfo } from '@@/api/chat/types';
 import { toShellUsername } from '@@/data-path';
 
 const PAIRING_CODE_PATTERN = /^[A-Z0-9]{6}$/;
@@ -24,7 +24,7 @@ function extractPhone(waId: string): string {
 }
 
 async function getVisibleModels(): Promise<ModelInfo[]> {
-  const allModels = await listPiModels();
+  const allModels = await listChatModels();
   const policy = await readConfigValue<AccessPolicy>(ACCESS_POLICY_KEY, { allowedModels: [] });
   const allowed = policy.allowedModels;
 

src/servers/hono.ts

@@ -19,7 +19,6 @@ import { settingsRouter } from './api/settings/settings';
 import { dashboardsRouter } from './api/dashboards';
 import { taskLogsRouter } from './api/task-logs/task-logs';
 import { router as fileBrowserRouter } from './api/file-browser/router';
-import { piRestRouter } from './api/pi/rest';
 import { devServerRouter, devServerProxyRouter } from './api/dev-server/router';
 import { dockRouter } from './api/dock/dock';
 import { integrationsRouter, googleCallbackHandler } from './api/integrations/integrations';
@@ -107,7 +106,6 @@ protectedRouter.route('/pipeline-jobs', pipelineJobsRouter);
 protectedRouter.route('/jobs', pipelineJobsRouter); // unified jobs API (script + pipeline); /pipeline-jobs kept for the existing UI
 desktopRouter.use(superAdminMiddleware);
 protectedRouter.route('/desktop', desktopRouter);
-protectedRouter.route('/', piRestRouter);
 
 honoServer.route('/api', protectedRouter);
 

src/servers/sidecar-registry.ts

@@ -14,7 +14,7 @@ import type {
   VncSessionInfo,
 } from './sidecar/protocol';
 import type { SidecarRegistration } from './sidecar/registration-protocol';
-import type { PiEvent } from './api/pi/types';
+import type { ChatEvent } from './api/chat/types';
 
 // ── Types ──
 
@@ -339,7 +339,7 @@ export function clearClaudeSession(sessionKey: string, email?: string): void {
   }
 }
 
-export function onClaudeEvent(handler: (sessionKey: string, event: PiEvent) => void): () => void {
+export function onClaudeEvent(handler: (sessionKey: string, event: ChatEvent) => void): () => void {
   return on('claude:event', (msg) => {
     if (msg.type === 'claude:event') {
       handler(

src/servers/sidecar/claude/claude-manager.ts

@@ -1,6 +1,6 @@
 import { join } from 'node:path';
 import type { Subprocess } from 'bun';
-import type { PiEvent } from '../../api/pi/types';
+import type { ChatEvent } from '../../api/chat/types';
 import type { ClaudeSpawnParams, ClaudeSpawnStreamingParams, ClaudeCodeResult } from '../protocol';
 import { buildSandboxPrefix, buildRunuserSuffix, SANDBOX_HOME } from '../sandbox';
 import { setClaudeSession, clearClaudeSession, getClaudeSession } from './state';
@@ -145,7 +145,7 @@ export async function spawnClaude(params: ClaudeSpawnParams): Promise<ClaudeCode
 
 export async function spawnClaudeStreaming(
   params: ClaudeSpawnStreamingParams,
-  onEvent: (event: PiEvent) => void,
+  onEvent: (event: ChatEvent) => void,
 ): Promise<void> {
   const { prompt, sessionKey, email } = params;
 

src/servers/sidecar/claude/stream-parser.test.ts

@@ -1,10 +1,10 @@
 import { describe, test, expect } from 'bun:test';
 import { processLine, createParseState, parseStream } from './stream-parser';
-import type { PiEvent } from '../../api/pi/types';
+import type { ChatEvent } from '../../api/chat/types';
 import type { StreamParserCallbacks, ParseState } from './stream-parser';
 
-function makeCallbacks(): { events: PiEvent[]; sessionIds: string[]; callbacks: StreamParserCallbacks } {
-  const events: PiEvent[] = [];
+function makeCallbacks(): { events: ChatEvent[]; sessionIds: string[]; callbacks: StreamParserCallbacks } {
+  const events: ChatEvent[] = [];
   const sessionIds: string[] = [];
   return {
     events,

src/servers/sidecar/claude/stream-parser.ts

@@ -6,12 +6,12 @@
  * system init, and result messages.
  */
 
-import type { PiEvent, MessageCost } from '../../api/pi/types';
+import type { ChatEvent, MessageCost } from '../../api/chat/types';
 
 type SessionCallback = (sessionId: string) => void;
 
 type StreamParserCallbacks = {
-  onEvent: (event: PiEvent) => void;
+  onEvent: (event: ChatEvent) => void;
   onSessionId: SessionCallback;
 };
 
@@ -20,14 +20,14 @@ type ParseState = {
   gotResult: boolean;
 };
 
-function flushTextBuffer(state: ParseState, onEvent: (event: PiEvent) => void): void {
+function flushTextBuffer(state: ParseState, onEvent: (event: ChatEvent) => void): void {
   if (state.textBuffer) {
     onEvent({ type: 'text', text: state.textBuffer });
     state.textBuffer = '';
   }
 }
 
-function handleStreamEvent(msg: Record<string, unknown>, state: ParseState, onEvent: (event: PiEvent) => void): void {
+function handleStreamEvent(msg: Record<string, unknown>, state: ParseState, onEvent: (event: ChatEvent) => void): void {
   const event = msg.event as Record<string, unknown> | undefined;
   if (event?.type === 'content_block_delta') {
     const delta = event.delta as Record<string, unknown> | undefined;
@@ -38,7 +38,7 @@ function handleStreamEvent(msg: Record<string, unknown>, state: ParseState, onEv
   }
 }
 
-function handleAssistant(msg: Record<string, unknown>, state: ParseState, onEvent: (event: PiEvent) => void): void {
+function handleAssistant(msg: Record<string, unknown>, state: ParseState, onEvent: (event: ChatEvent) => void): void {
   const message = msg.message as Record<string, unknown> | undefined;
   const content = message?.content as Array<Record<string, unknown>> | undefined;
   if (!Array.isArray(content)) return;
@@ -59,7 +59,7 @@ function handleAssistant(msg: Record<string, unknown>, state: ParseState, onEven
   }
 }
 
-function handleUser(msg: Record<string, unknown>, onEvent: (event: PiEvent) => void): void {
+function handleUser(msg: Record<string, unknown>, onEvent: (event: ChatEvent) => void): void {
   const message = msg.message as Record<string, unknown> | undefined;
   const content = message?.content as Array<Record<string, unknown>> | undefined;
   if (!Array.isArray(content)) return;

src/servers/sidecar/claude/user-instance.ts

@@ -172,7 +172,7 @@ async function handleCommand(cmd: SidecarCommand, reply: ReplyFn) {
     case 'claude:spawn-streaming': {
       reply({ type: 'claude:spawned', id: cmd.id, sessionKey: cmd.params.sessionKey });
 
-      const onEvent = (event: import('../../api/pi/types').PiEvent) => {
+      const onEvent = (event: import('../../api/chat/types').ChatEvent) => {
         connection.send({ type: 'claude:event', sessionKey: cmd.params.sessionKey, event });
       };
 

src/servers/sidecar/protocol.ts

@@ -1,4 +1,4 @@
-import type { MessageCost, PiEvent } from '../api/pi/types';
+import type { MessageCost, ChatEvent } from '../api/chat/types';
 
 // ── Envelope ──
 
@@ -29,7 +29,7 @@ export type SidecarEvent =
   | { type: 'proxy:secret'; id: string; secret: string }
   // Claude Code
   | { type: 'claude:spawned'; id: string; sessionKey: string }
-  | { type: 'claude:event'; sessionKey: string; event: PiEvent }
+  | { type: 'claude:event'; sessionKey: string; event: ChatEvent }
   | { type: 'claude:result'; id: string; result: ClaudeCodeResult }
   | { type: 'claude:error'; id: string; error: string }
   | { type: 'claude:killed'; id: string }