agentp 0.11.11 → 0.12.0

package/README.md

@@ -231,21 +231,28 @@ Non-text Telegram updates (photos, stickers, etc.) are silently ignored.
 ### Slash commands
 
 | Command | Action |
-|---|---|
+|---|---|---|
 | `/help [topic]` | Show general help or help for a topic (`servers`, `sessions`, `agents`, `models`, `allow`, `think`, `record`, `queue`) |
 | `/servers` | List all ocmux-served projects (▶ active, 🔌 disconnected, 💀 dead) |
-| `/servers switch <name> [--force]` | Switch active server; matches by full path, basename, or substring; `--force` takes over from another chat |
+| `/server <name>` | Switch active server; matches by full path, basename, or substring |
+| `/server --force <name>` | Take over a server from another chat |
 | `/resurrect [path]` | Restart a crashed server from its `.ocmux.json`; accepts optional directory path |
+| `/sessions` | List sessions (numbered, newest first) |
+| `/session <name-or-number>` | Switch to a session by name or position |
+| `/session new [name]` | Create a new session |
+| `/session rename <name>` | Rename the active session |
+| `/agents` | List available agents/models |
+| `/agent <name>` | Switch the active agent for subsequent messages (synced to server via API) |
+| `/models` | List providers and models (▶ marks current) |
+| `/model <providerID/modelID>` | Switch session model |
 | `/allow` | Approve a permission request once |
 | `/reject` | Deny a permission request |
 | `/always` | Approve and remember for the session |
 | `/answer <number>` | Respond to a question asked by the AI (structured multiple-choice) |
 | `/markdown` | Send the original markdown of the last response as a `.md` file; reply to a message to get that specific response |
-| `/agents list` | List available agents/models |
-| `/agents switch <name>` | Switch the active agent for subsequent messages (synced to server via API) |
 | `/shutdown [force\|clear]` | (requires `--dev`) Stop tgagentp; `clear` also wipes saved connections |
 
-> **Note on model/agent switching:** Changing the model in the OpenCode TUI's prompt dropdown is a **local UI action** — it only takes effect server-side after a message is sent *through the TUI*. If you change the model in the TUI and then send a prompt via `agentp` or Telegram, the old model will still be used. Use `/agents switch <name>` from Telegram (or `tgagentp`) to change models — this explicitly calls the API and syncs correctly.
+> **Note on model/agent switching:** Changing the model in the OpenCode TUI's prompt dropdown is a **local UI action** — it only takes effect server-side after a message is sent *through the TUI*. If you change the model in the TUI and then send a prompt via `agentp` or Telegram, the old model will still be used. Use `/agent <name>` or `/model <providerID/modelID>` from Telegram (or `tgagentp`) to change models — this explicitly calls the API and syncs correctly.
 
 #### TUI Command Passthrough
 
@@ -255,7 +262,7 @@ Messages starting with `//` are forwarded to the OpenCode TUI as raw keystrokes
 
 ### Chat-server ownership
 
-Each server can be owned by at most one chat at a time. New chats start disconnected. Use `/servers switch <name>` to connect; `--force` takes over and notifies the previous owner. Connections are persisted to `/tmp/tgagentp-connections.json` and restored automatically on restart (server URL is re-discovered from `.ocmux.json`).
+Each server can be owned by at most one chat at a time. New chats start disconnected. Use `/server <name>` to connect; `--force` takes over and notifies the previous owner. Connections are persisted to `/tmp/tgagentp-connections.json` and restored automatically on restart (server URL is re-discovered from `.ocmux.json`).
 
 ### Per-server state
 
@@ -287,7 +294,7 @@ tgagentp starts a tiny HTTP server on `127.0.0.1` that accepts `POST /send` requ
 - Port is written to `/tmp/tgagentp-port` for agentp discovery.
 - Authentication reuses `OPENCODE_SERVER_PASSWORD`.
 - Messages for the owning chat's active server are delivered immediately.
-- Messages for non-active servers are queued per-server with debounced notifications (configurable via `TGAGENTP_DEBOUNCE_MS`); delivered on `/servers switch`.
+- Messages for non-active servers are queued per-server with debounced notifications (configurable via `TGAGENTP_DEBOUNCE_MS`); delivered on `/server <name>`.
 - Server health detection pre-sends: if a server is unreachable, messages are auto-queued and delivered when it comes back. `/flush` clears all queues.
 - When [/record](#tgagentp) is active, the gateway response includes the recorded conversation buffer. `agentp --qa` prepends this buffer (with rulers) to its stdout so the full Telegram context is available to OpenCode. Use `agentp --qa --flush` to flush the buffer without prepending.
 

package/bin/tgagentp

@@ -264,46 +264,80 @@ async function cmdHelp(token, chatId, args, chatState) {
     const topic = args[0].toLowerCase();
     if (topic === 'servers') {
       await sendLongMessage(token, chatState,
-        '`/servers` ─ list all opencode servers (ocmux sessions)\n' +
-        '`/servers switch <name>` ─ switch target server\n' +
-        '`/force-switch <name>` ─ take over a server from another chat\n\n' +
-        'Name matching: case-insensitive first, then case-sensitive. ' +
-        '`<name>` can be a full path or basename of the project directory.');
+        '`/servers` ─ list running servers\n' +
+        '  • Shows alive and dead servers\n' +
+        '  • Your server marked with ▶\n\n' +
+        '`/server <name>` ─ switch to a server by directory path or basename\n' +
+        '`/server --force <name>` ─ take over a server from another chat');
+      return;
+    }
+    if (topic === 'agents') {
+      await sendLongMessage(token, chatState,
+        '`/agents` ─ list primary agents\n' +
+        '  • Current agent marked with ▶\n' +
+        '  • Shows model and description\n\n' +
+        '`/agent <name>` ─ switch to an agent');
+      return;
+    }
+    if (topic === 'sessions') {
+      await sendLongMessage(token, chatState,
+        '`/sessions` ─ list sessions\n' +
+        '  • Primary-agent sessions shown by default (includes subagent sessions to maintain context)\n' +
+        '  • Active session marked with ▶\n' +
+        '  • Grouped by recency: Today, this week, older months\n\n' +
+        '`/session <name-or-number>` ─ switch to a session by name or position\n' +
+        '`/session new [name]` ─ create a new session\n' +
+        '`/session rename <name>` ─ rename the active session');
       return;
     }
     if (topic === 'sessions') {
       await sendLongMessage(token, chatState,
         '`/sessions` ─ list active sessions (numbered, newest first, max 50)\n' +
-        '`/sessions switch <number-or-name>` ─ send messages to a specific session\n' +
-        '`/sessions new [name]` ─ create a new session\n' +
-        '`/sessions rename <name>` ─ rename the active session\n\n' +
+        '`/session <name-or-number>` ─ switch to a session by name or position\n' +
+        '`/session new [name]` ─ create a new session\n' +
+        '`/session rename <name>` ─ rename the active session\n\n' +
         'Switch by number (from the list) or by case-insensitive partial name match.\n' +
         'Use `/sessions` to find session numbers.');
       return;
     }
-    if (topic === 'shutdown') {
+    if (topic === 'servers') {
       await sendLongMessage(token, chatState,
-        '`/shutdown` ─ stop tgagentp process\n' +
-        '`/shutdown force` ─ force shutdown even if busy (in-flight work will be lost)\n\n' +
-        'Only available when tgagentp is started with `--dev` flag.\n' +
-        'Useful when running tgagentp in a restart loop:\n' +
-        '`while true; do tgagentp --dev; done`');
+        '`/servers` ─ list running servers\n' +
+        '  • Shows alive and dead servers\n' +
+        '  • Your server marked with ▶\n\n' +
+        '`/server <name>` ─ switch to a server by directory path or basename\n' +
+        '`/server --force <name>` ─ take over a server from another chat');
+      return;
+    }
+    if (topic === 'server') {
+      await sendLongMessage(token, chatState,
+        '`/server <name>` ─ switch to a server by directory path or basename.\n' +
+        '`/server --force <name>` ─ take over a server from another chat.\n\n' +
+        'Matches by full directory path, basename, or case-insensitive substring.\n' +
+        'Use `/servers` to see available servers.');
       return;
     }
     if (topic === 'agents') {
       await sendLongMessage(token, chatState,
         '`/agents` ─ list primary agents (with ▶ marker for the active one).\n' +
-        '`/agents switch <name>` ─ switch the active agent. Subsequent messages will use this agent.\n\n' +
-        'Agent switching requires an active session (`/sessions switch` or `/sessions new`).');
+        '`/agent <name>` ─ switch the active agent. Subsequent messages will use this agent.\n\n' +
+        'Agent switching requires an active session (`/session <name>` or `/session new`).');
+      return;
+    }
+    if (topic === 'agent') {
+      await sendLongMessage(token, chatState,
+        '`/agent <name>` ─ switch the active agent.\n\n' +
+        'Matches by exact name first, then case-insensitive substring.\n' +
+        'The agent is synced to the server session via API.\n' +
+        'Use `/agents` to list available agents.');
       return;
     }
     if (topic === 'session') {
       await sendLongMessage(token, chatState,
-        '`/session` is an alias for `/sessions`.\n\n' +
-        '`/sessions` ─ list active sessions\n' +
-        '`/sessions switch <number-or-name>` ─ switch to a session\n' +
-        '`/sessions new [name]` ─ create a new session\n' +
-        '`/sessions rename <name>` ─ rename the active session');
+        '`/session <name-or-number>` ─ switch to a session by name or position\n' +
+        '`/session new [name]` ─ create a new session\n' +
+        '`/session rename <name>` ─ rename the active session\n\n' +
+        'Use `/sessions` to list available sessions with numbers.');
       return;
     }
     if (topic === 'models') {
@@ -390,7 +424,7 @@ async function cmdHelp(token, chatId, args, chatState) {
     if (topic === 'disconnect') {
       await sendLongMessage(token, chatState,
         '`/disconnect` ─ disconnect this chat from its server\n\n' +
-        'Clears the server connection for this chat. Use `/servers switch <name>` to reconnect.');
+        'Clears the server connection for this chat. Use `/server <name>` to reconnect.');
       return;
     }
     if (topic === 'status') {
@@ -453,7 +487,7 @@ async function cmdHelp(token, chatId, args, chatState) {
       return;
     }
     await sendLongMessage(token, chatState,
-      'Unknown topic. Try `/help servers`, `/help sessions`, `/help agents`, `/help models`, `/help allow`, `/help think`, `/help record`, `/help queue`, `/help flush`, `/help note`, `/help comment`, `/help disconnect`, `/help serve`, `/help new`, `/help markdown`, or just `/help`.');
+      'Unknown topic. Try `/help servers`, `/help server`, `/help sessions`, `/help session`, `/help agents`, `/help agent`, `/help models`, `/help model`, `/help allow`, `/help think`, `/help record`, `/help queue`, `/help flush`, `/help note`, `/help comment`, `/help disconnect`, `/help serve`, `/help new`, `/help markdown`, or just `/help`.');
     return;
   }
   await sendLongMessage(token, chatState,
@@ -462,16 +496,16 @@ async function cmdHelp(token, chatId, args, chatState) {
     '`/status` ─ show current server and session\n' +
     '`/cancel` ─ cancel the running prompt\n' +
     '`/servers` ─ list running opencode servers\n' +
-    '`/servers switch <name>` ─ switch to a different server\n' +
-    '`/force-switch <name>` ─ take over a server from another chat\n' +
-    '`/sessions` ─ list/create/switch/rename sessions\n' +
-    '`/sessions switch <number-or-name>` ─ switch to a session\n' +
-    '`/sessions new [name]` ─ create a new session\n' +
-    '`/sessions rename <name>` ─ rename the active session\n' +
-    '`/session` ─ alias for `/sessions`\n' +
+    '`/server <name>` ─ switch to a different server\n' +
+    '`/server --force <name>` ─ take over a server from another chat\n' +
+    '`/sessions` ─ list sessions\n' +
+    '`/session <name-or-number>` ─ switch to a session\n' +
+    '`/session new [name]` ─ create a new session\n' +
+    '`/session rename <name>` ─ rename the active session\n' +
     '`/agents` ─ list available agents\n' +
-    '`/agents switch <name>` ─ switch active agent\n' +
+    '`/agent <name>` ─ switch active agent\n' +
     '`/models` ─ list providers and models\n' +
+    '`/model <provider/model>` ─ switch session model\n' +
     '`/think` ─ toggle thinking message forwarding\n' +
     '`/record` ─ record Telegram conversation for agentp context\n' +
     '`/queue <message>` ─ queue a message when server is busy\n' +
@@ -489,90 +523,18 @@ async function cmdHelp(token, chatId, args, chatState) {
     'Everything else is forwarded to the active server as `[Telegram] <text>`.');
 }
 
-async function cmdForceSwitch(token, chatId, args, chatState, setServerForChat, setActiveSessionForChat) {
-  return cmdServers(token, chatId, ['switch', '--force', ...args], chatState, setServerForChat, setActiveSessionForChat);
-}
-
 async function cmdServers(token, chatId, args, chatState, setServerForChat, setActiveSessionForChat) {
-  const isForce = args.length > 0 && args[0].toLowerCase() === 'force-switch';
-  if (args.length > 0 && (args[0].toLowerCase() === 'switch' || isForce)) {
-    const forceIdx = args.indexOf('--force');
-    const force = forceIdx !== -1 || isForce;
-    const switchArgs = args.slice(1).filter(a => a !== '--force');
-    if (switchArgs.length < 1) {
-      await sendLongMessage(token, chatState,
-        'Usage: `/servers switch <name>`\n' +
-        'To force-switch (take over a server from another chat), use `/force-switch <name>`.\n' +
-        '`<name>` can be a full directory path or a basename.');
-      return;
-    }
-    const name = switchArgs.join(' ');
-    const servers = listServers();
-    if (servers.length === 0) {
-      await sendLongMessage(token, chatState, 'No servers running.');
-      return;
-    }
-
-    // Phase 1: case-insensitive exact match on dir or basename
-    let matches = servers.filter(s => s.dir.toLowerCase() === name.toLowerCase());
-    if (matches.length === 0) {
-      matches = servers.filter(s => path.basename(s.dir).toLowerCase() === name.toLowerCase());
-    }
-    // Fallback: case-insensitive substring match
-    if (matches.length === 0) {
-      const lowerName = name.toLowerCase();
-      matches = servers.filter(s => s.dir.toLowerCase().includes(lowerName) || path.basename(s.dir).toLowerCase().includes(lowerName));
-    }
-
-    if (matches.length === 1) {
-      // Phase 1 found a single match — use it directly
-    } else if (matches.length === 0) {
-      await sendLongMessage(token, chatState, `No server found matching "${name}".`);
-      return;
-    } else {
-      // Phase 2: case-sensitive exact match to disambiguate
-      let exact = servers.filter(s => s.dir === name);
-      if (exact.length === 0) {
-        exact = servers.filter(s => path.basename(s.dir) === name);
-      }
-      if (exact.length === 1) {
-        matches = exact;
-      } else {
-        const list = matches.map(s => `  ${s.url} → ${s.dir}`).join('\n');
-        await sendLongMessage(token, chatState,
-          `Multiple matches for "${name}":\n${list}\n\nPlease be more specific.`);
-        return;
-      }
-    }
-    const target = matches[0];
-    const existing = serverOwners[target.url];
-    if (existing && existing.chatId !== chatState.chatId && !force) {
-      await sendLongMessage(token, chatState,
-        `⚠️ Server \`${target.url}\` is already connected to another chat.\n\n` +
-        `Use \`/servers force-switch ${name}\` to take over (the other chat will be disconnected).`);
-      return;
+  // Backward compatibility: redirect old subcommands to singular commands
+  if (args.length > 0) {
+    const sub = args[0].toLowerCase();
+    if (sub === 'switch') {
+      const rest = args.slice(1).filter(a => a !== '--force');
+      const force = args.includes('--force');
+      return cmdServer(token, chatId, force ? ['--force', ...rest] : rest, chatState, setServerForChat, setActiveSessionForChat);
     }
-    if (existing && existing.chatId === chatState.chatId) {
-      // Already connected — re-run setup to refresh state
-    }
-    if (force && existing && existing.chatId !== chatState.chatId) {
-      // Reset the old owner's server and notify them
-      const oldState = getChatState(existing.chatId, existing.threadId);
-      oldState.serverBase = null;
-      sendLongMessage(token, oldState,
-        `⚠️ Server \`${target.url}\` has been taken over by another chat.\n\n` +
-        `Use \`/servers\` to see available servers and reconnect.`).catch(() => {});
-    }
-    const pending = await setServerForChat(chatState, target.url);
-    activateServer(target.dir, target.index, target.url);
-    let msg = `Switched to server: ${target.url} → ${target.dir}`;
-    if (pending && pending.trim()) {
-      await sendLongMessage(token, chatState, msg);
-      await sendLongMessage(token, chatState, pending.trim());
-    } else {
-      await sendLongMessage(token, chatState, msg);
+    if (sub === 'force-switch') {
+      return cmdServer(token, chatId, ['--force', ...args.slice(1)], chatState, setServerForChat, setActiveSessionForChat);
     }
-    return;
   }
 
   // Default: list servers (alive + dead)
@@ -650,106 +612,19 @@ async function discoverActiveSession(server) {
 
 async function cmdSessions(token, chatId, args, chatState, setServerForChat, setActiveSessionForChat) {
   const server = chatState.serverBase;
+  // Backward compatibility: redirect old subcommands to singular commands
   if (args.length > 0) {
     const sub = args[0].toLowerCase();
-
-    if (sub === 'new') {
-      const title = args.slice(1).join(' ') || undefined;
-      try {
-        const session = await createSession(server, title);
-        const name = session.title || session.slug || session.id;
-        setActiveSessionForChat(chatState, session.id, name);
-        selectSession(server, session.id);
-        await sendLongMessage(token, chatState,
-          `Created session: \`${name}\`\nIt is now the active session.`);
-      } catch (err) {
-        await sendLongMessage(token, chatState, `Error creating session: ${err.message}`);
-      }
-      return;
+    if (sub === 'switch' || sub === 'new' || sub === 'rename') {
+      return cmdSession(token, chatId, args, chatState, setServerForChat, setActiveSessionForChat);
     }
-
-    if (sub === 'rename') {
-      if (args.length < 2) {
-        await sendLongMessage(token, chatState, 'Usage: `/sessions rename <name>`');
-        return;
-      }
-      const st = getState(server);
-      if (!st.activeSessionId) {
-        await sendLongMessage(token, chatState, 'No active session. Use `/sessions switch` or `/sessions new` first.');
-        return;
-      }
-      const newTitle = args.slice(1).join(' ');
-      try {
-        const session = await updateSession(server, st.activeSessionId, newTitle);
-        const name = session.title || session.slug || session.id;
-        await sendLongMessage(token, chatState,
-          `Renamed session to: \`${name}\``);
-      } catch (err) {
-        await sendLongMessage(token, chatState, `Error renaming session: ${err.message}`);
-      }
-      return;
-    }
-
-    if (sub === 'switch') {
-      if (args.length < 2) {
-        await sendLongMessage(token, chatState,
-          'Usage: `/sessions switch <number-or-name>`\n' +
-          'Use `/sessions` to see numbered list. You can switch by number or by name (case-insensitive partial match).');
-        return;
-      }
-      const query = args.slice(1).join(' ');
-      try {
-        const projectDir = serverDir(server);
-        const sessions = await listSessions(server, projectDir);
-        const activeId = getState(server).activeSessionId;
-        const filtered = sessions.filter(s =>
-          (s.agent || s.directory || s.id === activeId) && (!projectDir || s.directory === projectDir));
-        const sorted = sortedSessions(filtered, 50);
-
-        // Try by position number first
-        const num = parseInt(query, 10);
-        if (/^\d+$/.test(query) && num >= 1 && num <= sorted.length) {
-          const target = sorted[num - 1];
-          setActiveSessionForChat(chatState, target.id, sessionName(target));
-          selectSession(server, target.id);
-          await sendLongMessage(token, chatState,
-            `Switched to session #${num}: \`${sessionName(target)}\`\nSubsequent messages will be sent to this session.`);
-          return;
-        }
-
-        // Try by name (case-insensitive partial match)
-        const q = query.toLowerCase();
-        const matches = sorted.filter(s => sessionName(s).toLowerCase().includes(q));
-        if (matches.length === 0) {
-          await sendLongMessage(token, chatState,
-            `No session matching "${query}". Use /sessions to list active sessions.`);
-          return;
-        }
-        if (matches.length > 1) {
-          const list = matches.map(s => `  \`${sessionName(s)}\``).join('\n');
-          await sendLongMessage(token, chatState,
-            `Multiple matches for "${query}":\n${list}\n\nPlease be more specific or use a number.`);
-          return;
-        }
-        const target = matches[0];
-        setActiveSessionForChat(chatState, target.id);
-        selectSession(server, target.id);
-        await sendLongMessage(token, chatState,
-          `Switched to session: \`${sessionName(target)}\`\nSubsequent messages will be sent to this session.`);
-      } catch (err) {
-        await sendLongMessage(token, chatState, `Error switching session: ${err.message}`);
-      }
-      return;
-    }
-
-    // Unknown subcommand
     await sendLongMessage(token, chatState,
       `Unknown subcommand: /sessions ${sub}\n\n` +
       'Usage:\n' +
       '  `/sessions` ─ list sessions\n' +
-      '  `/sessions switch <number-or-name>` ─ switch to a session\n' +
-      '  `/sessions new [name]` ─ create a new session\n' +
-      '  `/sessions rename <name>` ─ rename the active session');
+      '  `/session <name-or-number>` ─ switch to a session\n' +
+      '  `/session new [name]` ─ create a new session\n' +
+      '  `/session rename <name>` ─ rename the active session');
     return;
   }
 
@@ -823,48 +698,9 @@ async function cmdSessions(token, chatId, args, chatState, setServerForChat, set
 
 async function cmdAgents(token, chatId, args, chatState, setServerForChat, setActiveSessionForChat) {
   const server = chatState.serverBase;
+  // Backward compatibility: redirect /agents switch to /agent
   if (args.length > 0 && args[0].toLowerCase() === 'switch') {
-    if (args.length < 2) {
-      await sendLongMessage(token, chatState,
-        'Usage: `/agents switch <name>`\n' +
-        'Use `/agents` to list available agents.');
-      return;
-    }
-    const name = args.slice(1).join(' ');
-    try {
-      const agents = await listAgents(server);
-      if (!agents || agents.length === 0) {
-        await sendLongMessage(token, chatState, 'No agents available.');
-        return;
-      }
-      let matches = agents.filter(a => a.name === name);
-      if (matches.length === 0) {
-        matches = agents.filter(a => a.name.toLowerCase().includes(name.toLowerCase()));
-      }
-      if (matches.length === 0) {
-        await sendLongMessage(token, chatState, `No agent matching "${name}".`);
-        return;
-      }
-      if (matches.length > 1) {
-        const list = matches.map(a => `  \`${a.name}\``).join('\n');
-        await sendLongMessage(token, chatState,
-          `Multiple matches for "${name}":\n${list}\n\nPlease be more specific.`);
-        return;
-      }
-      const target = matches[0];
-      getState(server).activeAgentName = target.name;
-      const st = getState(server);
-      if (st.activeSessionId) {
-        updateSession(server, st.activeSessionId, undefined, target.name);
-        selectSession(server, st.activeSessionId);
-      }
-      const model = target.model ? ` ─ \`${target.model.providerID}/${target.model.modelID}\`` : '';
-      await sendLongMessage(token, chatState,
-        `Switched to agent: **${target.name}**${model}\nSubsequent messages will use this agent.`);
-    } catch (err) {
-      await sendLongMessage(token, chatState, `Error switching agent: ${err.message}`);
-    }
-    return;
+    return cmdAgent(token, chatId, args.slice(1), chatState, setServerForChat, setActiveSessionForChat);
   }
 
   try {
@@ -1638,7 +1474,7 @@ async function cmdServe(token, chatId, args, chatState, setServerForChat, setAct
     } else {
       await sendLongMessage(token, chatState,
         `⚠️ Server already exists for \`${relPath}\`.\n` +
-        'Use `/servers switch <name>` to connect to it.');
+        'Use `/server <name>` to connect to it.');
     }
     return;
   }
@@ -1836,6 +1672,210 @@ async function cmdModel(token, chatId, args, chatState, setServerForChat, setAct
   }
 }
 
+async function cmdServer(token, chatId, args, chatState, setServerForChat, setActiveSessionForChat) {
+  if (args.length === 0) {
+    await sendLongMessage(token, chatState,
+      'Usage: `/server <name>`\n' +
+      'To force-switch (take over a server from another chat), use `/server --force <name>`.\n' +
+      '`<name>` can be a full directory path or a basename.\n' +
+      'Use `/servers` to list available servers.');
+    return;
+  }
+  const forceIdx = args.indexOf('--force');
+  const force = forceIdx !== -1;
+  const nameArgs = args.filter((a, i) => a !== '--force');
+  if (nameArgs.length === 0) {
+    await sendLongMessage(token, chatState,
+      'Usage: `/server <name>`\n' +
+      'To force-switch, use `/server --force <name>`.');
+    return;
+  }
+  const name = nameArgs.join(' ');
+  const servers = listServers();
+  if (servers.length === 0) {
+    await sendLongMessage(token, chatState, 'No servers running.');
+    return;
+  }
+  let matches = servers.filter(s => s.dir.toLowerCase() === name.toLowerCase());
+  if (matches.length === 0) {
+    matches = servers.filter(s => path.basename(s.dir).toLowerCase() === name.toLowerCase());
+  }
+  if (matches.length === 0) {
+    const lowerName = name.toLowerCase();
+    matches = servers.filter(s => s.dir.toLowerCase().includes(lowerName) || path.basename(s.dir).toLowerCase().includes(lowerName));
+  }
+  if (matches.length === 0) {
+    await sendLongMessage(token, chatState, `No server found matching "${name}".`);
+    return;
+  }
+  if (matches.length > 1) {
+    let exact = servers.filter(s => s.dir === name);
+    if (exact.length === 0) exact = servers.filter(s => path.basename(s.dir) === name);
+    if (exact.length === 1) {
+      matches = exact;
+    } else {
+      const list = matches.map(s => `  ${s.url} → ${s.dir}`).join('\n');
+      await sendLongMessage(token, chatState,
+        `Multiple matches for "${name}":\n${list}\n\nPlease be more specific.`);
+      return;
+    }
+  }
+  const target = matches[0];
+  const existing = serverOwners[target.url];
+  if (existing && existing.chatId !== chatState.chatId && !force) {
+    await sendLongMessage(token, chatState,
+      `⚠️ Server \`${target.url}\` is already connected to another chat.\n\n` +
+      `Use \`/server --force ${name}\` to take over (the other chat will be disconnected).`);
+    return;
+  }
+  if (force && existing && existing.chatId !== chatState.chatId) {
+    const oldState = getChatState(existing.chatId, existing.threadId);
+    oldState.serverBase = null;
+    sendLongMessage(token, oldState,
+      `⚠️ Server \`${target.url}\` has been taken over by another chat.\n\n` +
+      `Use \`/servers\` to see available servers and reconnect.`).catch(() => {});
+  }
+  const pending = await setServerForChat(chatState, target.url);
+  activateServer(target.dir, target.index, target.url);
+  let msg = `Switched to server: ${target.url} → ${target.dir}`;
+  if (pending && pending.trim()) {
+    await sendLongMessage(token, chatState, msg);
+    await sendLongMessage(token, chatState, pending.trim());
+  } else {
+    await sendLongMessage(token, chatState, msg);
+  }
+}
+
+async function cmdSession(token, chatId, args, chatState, setServerForChat, setActiveSessionForChat) {
+  const server = chatState.serverBase;
+  if (args.length === 0) {
+    await sendLongMessage(token, chatState,
+      '`/session <name-or-number>` ─ switch to a session\n' +
+      '`/session new [name]` ─ create a new session\n' +
+      '`/session rename <name>` ─ rename the active session\n' +
+      'Use `/sessions` to list available sessions.');
+    return;
+  }
+  const sub = args[0].toLowerCase();
+  if (sub === 'new') {
+    const title = args.slice(1).join(' ') || undefined;
+    try {
+      const session = await createSession(server, title);
+      const name = session.title || session.slug || session.id;
+      setActiveSessionForChat(chatState, session.id, name);
+      selectSession(server, session.id);
+      await sendLongMessage(token, chatState,
+        `Created session: \`${name}\`\nIt is now the active session.`);
+    } catch (err) {
+      await sendLongMessage(token, chatState, `Error creating session: ${err.message}`);
+    }
+    return;
+  }
+  if (sub === 'rename') {
+    if (args.length < 2) {
+      await sendLongMessage(token, chatState, 'Usage: `/session rename <name>`');
+      return;
+    }
+    const st = getState(server);
+    if (!st.activeSessionId) {
+      await sendLongMessage(token, chatState, 'No active session. Use `/session <name>` to select one first.');
+      return;
+    }
+    const newTitle = args.slice(1).join(' ');
+    try {
+      const session = await updateSession(server, st.activeSessionId, newTitle);
+      const name = session.title || session.slug || session.id;
+      await sendLongMessage(token, chatState, `Renamed session to: \`${name}\``);
+    } catch (err) {
+      await sendLongMessage(token, chatState, `Error renaming session: ${err.message}`);
+    }
+    return;
+  }
+  // Switch to session by name or number
+  const query = args.join(' ');
+  try {
+    const projectDir = serverDir(server);
+    const sessions = await listSessions(server, projectDir);
+    const activeId = getState(server).activeSessionId;
+    const filtered = sessions.filter(s =>
+      (s.agent || s.directory || s.id === activeId) && (!projectDir || s.directory === projectDir));
+    const sorted = sortedSessions(filtered, 50);
+    const num = parseInt(query, 10);
+    if (/^\d+$/.test(query) && num >= 1 && num <= sorted.length) {
+      const target = sorted[num - 1];
+      setActiveSessionForChat(chatState, target.id, sessionName(target));
+      selectSession(server, target.id);
+      await sendLongMessage(token, chatState,
+        `Switched to session #${num}: \`${sessionName(target)}\`\nSubsequent messages will be sent to this session.`);
+      return;
+    }
+    const q = query.toLowerCase();
+    const matches = sorted.filter(s => sessionName(s).toLowerCase().includes(q));
+    if (matches.length === 0) {
+      await sendLongMessage(token, chatState,
+        `No session matching "${query}". Use /sessions to list active sessions.`);
+      return;
+    }
+    if (matches.length > 1) {
+      const list = matches.map(s => `  \`${sessionName(s)}\``).join('\n');
+      await sendLongMessage(token, chatState,
+        `Multiple matches for "${query}":\n${list}\n\nPlease be more specific or use a number.`);
+      return;
+    }
+    const target = matches[0];
+    setActiveSessionForChat(chatState, target.id);
+    selectSession(server, target.id);
+    await sendLongMessage(token, chatState,
+      `Switched to session: \`${sessionName(target)}\`\nSubsequent messages will be sent to this session.`);
+  } catch (err) {
+    await sendLongMessage(token, chatState, `Error switching session: ${err.message}`);
+  }
+}
+
+async function cmdAgent(token, chatId, args, chatState, setServerForChat, setActiveSessionForChat) {
+  const server = chatState.serverBase;
+  if (args.length === 0) {
+    await sendLongMessage(token, chatState,
+      'Usage: `/agent <name>`\n' +
+      'Use `/agents` to list available agents.');
+    return;
+  }
+  const name = args.join(' ');
+  try {
+    const agents = await listAgents(server);
+    if (!agents || agents.length === 0) {
+      await sendLongMessage(token, chatState, 'No agents available.');
+      return;
+    }
+    let matches = agents.filter(a => a.name === name);
+    if (matches.length === 0) {
+      matches = agents.filter(a => a.name.toLowerCase().includes(name.toLowerCase()));
+    }
+    if (matches.length === 0) {
+      await sendLongMessage(token, chatState, `No agent matching "${name}".`);
+      return;
+    }
+    if (matches.length > 1) {
+      const list = matches.map(a => `  \`${a.name}\``).join('\n');
+      await sendLongMessage(token, chatState,
+        `Multiple matches for "${name}":\n${list}\n\nPlease be more specific.`);
+      return;
+    }
+    const target = matches[0];
+    getState(server).activeAgentName = target.name;
+    const st = getState(server);
+    if (st.activeSessionId) {
+      updateSession(server, st.activeSessionId, undefined, target.name);
+      selectSession(server, st.activeSessionId);
+    }
+    const model = target.model ? ` ─ \`${target.model.providerID}/${target.model.modelID}\`` : '';
+    await sendLongMessage(token, chatState,
+      `Switched to agent: **${target.name}**${model}\nSubsequent messages will use this agent.`);
+  } catch (err) {
+    await sendLongMessage(token, chatState, `Error switching agent: ${err.message}`);
+  }
+}
+
 async function cmdMarkdown(token, chatId, args, chatState, setServerForChat, setActiveSessionForChat, replyTo, replyToMsgId) {
   let entry = null;
   if (replyToMsgId) {
@@ -1859,10 +1899,11 @@ async function cmdMarkdown(token, chatId, args, chatState, setServerForChat, set
 const COMMANDS = {
   'help': cmdHelp,
   'servers': cmdServers,
-  'force-switch': cmdForceSwitch,
+  'server': cmdServer,
   'sessions': cmdSessions,
-  'session': cmdSessions,
+  'session': cmdSession,
   'agents': cmdAgents,
+  'agent': cmdAgent,
   'models': cmdModels,
   'model': cmdModel,
   'think': cmdThink,
@@ -2338,7 +2379,7 @@ async function main() {
           ? `⚠️ Server \`${url}\` is unreachable. The message has been requeued and will be sent when the server is available again.\n\n` +
             `**Options:**\n` +
             `• Restart it: \`/resurrect\`\n` +
-            `• Switch to another server: \`/servers switch <name>\`\n` +
+            `• Switch to another server: \`/server <name>\`\n` +
             `• Flush the queue: \`/flush\``
           : `Error: ${err.message}`;
         try { await sendLongMessage(token, chatState, msg, replyTo, threadId); } catch (_) {}
@@ -2576,7 +2617,7 @@ async function main() {
             await sendLongMessage(token, cs,
               '🔄 Bot started. Previously connected to `' + dir + '`.\n' +
               '⚠️ The server at `' + state.url + '` is not reachable.\n' +
-              'Use `/resurrect` to restart it, or `/servers switch <name>` to connect elsewhere.');
+              'Use `/resurrect` to restart it, or `/server <name>` to connect elsewhere.');
           } catch (_) {}
         }
       }
@@ -2725,7 +2766,7 @@ async function main() {
               `Your file upload has been queued (#${qlen}). It will be sent when the server becomes available.\n\n` +
               `**Options:**\n` +
               `• Restart it: \`/resurrect\`\n` +
-              `• Switch to another server: \`/servers switch <name>\`\n` +
+              `• Switch to another server: \`/server <name>\`\n` +
               `• Flush the queue: \`/flush\``);
             continue;
           }
@@ -2875,11 +2916,11 @@ async function main() {
         const cmdArgs = parts.slice(1);
         const handler = cmds[cmd];
         if (handler) {
-          // Disconnected guard: only /help, /servers, /force-switch, /start, /comment, /shutdown, /serve, /new, and /resurrect work without a server
-          if (!cs.serverBase && cmd !== 'help' && cmd !== 'servers' && cmd !== 'force-switch' && cmd !== 'start' && cmd !== 'comment' && cmd !== 'shutdown' && cmd !== 'serve' && cmd !== 'new' && cmd !== 'resurrect') {
+          // Disconnected guard: /help, /servers, /server, /start, /comment, /shutdown, /serve, /new, and /resurrect work without a server
+          if (!cs.serverBase && cmd !== 'help' && cmd !== 'servers' && cmd !== 'server' && cmd !== 'start' && cmd !== 'comment' && cmd !== 'shutdown' && cmd !== 'serve' && cmd !== 'new' && cmd !== 'resurrect') {
             await sendLongMessage(token, cs,
               '🔌 Not connected to any server.\n\n' +
-              'Use `/servers` to see available servers and `/servers switch <name>` to connect.');
+              'Use `/servers` to see available servers and `/server <name>` to connect.');
             continue;
           }
           try {
@@ -2891,7 +2932,7 @@ async function main() {
           }
         } else {
           await sendLongMessage(token, cs,
-            `Unknown command: /${cmd}\n\nAvailable commands: /help, /status, /servers, /sessions, /agents, /models, /model, /think, /record, /queue, /flush, /note, /comment, /disconnect, /serve, /new, /markdown`);
+            `Unknown command: /${cmd}\n\nAvailable commands: /help, /status, /servers, /server, /sessions, /session, /agents, /agent, /models, /model, /think, /record, /queue, /flush, /note, /comment, /disconnect, /serve, /new, /markdown`);
         }
         continue;
       }
@@ -2900,7 +2941,7 @@ async function main() {
       if (!cs.serverBase) {
         await sendLongMessage(token, cs,
           '🔌 Not connected to any server.\n\n' +
-          'Use `/servers` to see available servers and `/servers switch <name>` to connect.');
+          'Use `/servers` to see available servers and `/server <name>` to connect.');
         continue;
       }
 
@@ -2927,7 +2968,7 @@ async function main() {
         const suggestions = [];
         suggestions.push(`• Restart it: \`/resurrect\``);
         if (servers.length > 0) {
-          suggestions.push(`• Switch to another server: \`/servers switch <name>\``);
+          suggestions.push(`• Switch to another server: \`/server <name>\``);
         }
         suggestions.push(`• Flush the queue: \`/flush\``);
         await sendLongMessage(token, cs,

package/lib/ocmux.js

@@ -233,13 +233,29 @@ function resurrectServer(dir, printLogs) {
       const actualName = windowNameByIndex(winIdx);
       if (actualName !== dir) {
         const found = windowByDir(dir);
-        if (found != null) winIdx = found;
+        if (found == null) {
+          // No window exists for this directory — old server is already dead, skip kill
+          winIdx = null;
+        } else {
+          winIdx = found;
+        }
       }
       if (winIdx != null) {
         _tmux(['select-window', '-t', `${SESSION}:${winIdx}`]);
         _tmux(['send-keys', '-t', `${SESSION}:${winIdx}.0`, 'C-c']);
         sleep(0.3);
-        _tmux(['kill-window', '-t', `${SESSION}:${winIdx}`]);
+        const killR = _tmux(['kill-window', '-t', `${SESSION}:${winIdx}`]);
+        if (killR.status !== 0) {
+          throw new Error(`Failed to kill old tmux window ${winIdx}: ${killR.stderr || 'unknown error'}`);
+        }
+        // Wait for window to actually disappear (up to 2s)
+        for (let i = 0; i < 10; i++) {
+          if (windowByDir(dir) == null) break;
+          sleep(0.2);
+        }
+        if (windowByDir(dir) != null) {
+          throw new Error(`Old tmux window for ${dir} still exists after kill`);
+        }
       }
     }
   }
@@ -260,11 +276,14 @@ function startServer(dir, printLogs) {
   ensureSession();
   const lf = logfileFor(dir);
 
-  const rc = _tmux(['new-window', '-d', '-t', SESSION, '-n', dir, '-c', dir]);
-  if (rc.status !== 0) throw new Error(`failed to create tmux window for ${dir}`);
-
-  const winIdx = windowByDir(dir);
-  if (winIdx == null) throw new Error('window was not created properly');
+  // Create a new tmux window and capture its index directly from the -P output
+  const newWinR = _tmux(['new-window', '-d', '-P', '-F', '#{window_index}', '-t', SESSION, '-n', dir, '-c', dir]);
+  if (newWinR.status !== 0) throw new Error(`failed to create tmux window for ${dir}`);
+  let winIdx = parseInt(newWinR.stdout.trim(), 10);
+  if (isNaN(winIdx)) {
+    winIdx = windowByDir(dir);
+    if (winIdx == null) throw new Error('could not determine new window index');
+  }
 
   pinWindowName(winIdx);
 
@@ -283,8 +302,7 @@ function startServer(dir, printLogs) {
   }
 
   if (!url) {
-    const wi = windowByDir(dir);
-    if (wi != null) _tmux(['kill-window', '-t', `${SESSION}:${wi}`]);
+    _tmux(['kill-window', '-t', `${SESSION}:${winIdx}`]);
     throw new Error('opencode server did not start within 10 seconds');
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentp",
-  "version": "0.11.11",
+  "version": "0.12.0",
   "description": "Pipe prompts into a running OpenCode TUI session and stream the final answer",
   "bin": {
     "agentp": "bin/agentp",