Skip to content

Bump oliexe/bots to 0.3.1 - #2568

Merged
paseo-bot[bot] merged 1 commit into
mainfrom
bump/oliexe/bots-0.3.1
Nov 17, 2026
Merged

paseo-bot[bot] merged 1 commit into
mainfrom
bump/oliexe/bots-0.3.1

Conversation

@github-actions

Copy link
Copy Markdown
Contributor

oliexe/bots: 0.2.0 → 0.3.1

@oliexe, this update is ready for review. The published version stays unchanged until approval.

Artifact and validation details

Package: @oliexe/paseo-bots.

{
  "previous": {
    "kind": "npm",
    "package": "@oliexe/paseo-bots",
    "version": "0.2.0",
    "resolved": "https://registry.npmjs.org/@oliexe/paseo-bots/-/paseo-bots-0.2.0.tgz",
    "integrity": "sha512-ClK2r+tzpKSTOHwdyGR+0sXJlM/JFi+kepi6Vbmm9VyaUSdsFegIwXJSJevTaO2Btt9wR4PVN7QcJ+LR1ZcROg=="
  },
  "proposed": {
    "kind": "npm",
    "package": "@oliexe/paseo-bots",
    "version": "0.3.1",
    "resolved": "https://registry.npmjs.org/@oliexe/paseo-bots/-/paseo-bots-0.3.1.tgz",
    "integrity": "sha512-2V4eJ0sje2cJ8Bbog+5QBxikEb5P9nCUMD3RnrcrOq7SN3q3T+Y7T7T9Gu99aXlKE4maJS03850uM0wUDDw5Pg=="
  }
}

This version ships OVERVIEW.md, so the registry's copy is removed in this bump.
Inline validation passed: tests and artifact checks. Run node scripts/validate.ts --online --changed on the completed listing before merging. The default GITHUB_TOKEN does not trigger the PR validation workflow.

Artifact diff (truncated)
diff -ruN a/package/OVERVIEW.md b/package/OVERVIEW.md
--- a/package/OVERVIEW.md	1970-01-01 00:00:00.000000000 +0000
+++ b/package/OVERVIEW.md	1985-10-26 08:15:00.000000000 +0000
@@ -0,0 +1,28 @@
+Personal bots for Paseo. Each bot has its own standing instructions, provider and model, memory, routines, skills and tools, and chats in its own background workspace, separate from the coding sidebar. Existing chats remain available in Bots; older visible workspaces keep their original visibility. Start a bot blank, from a role such as Email triage or Researcher, or ask a bot to set one up for you.
+
+## What a bot has
+
+- Identity and soul: a name, an avatar, a voice and the standing instructions it follows in every chat.
+- Memory: a MEMORY.md the bot updates as it learns, topic files and a daily log of its chats. Settings show the 200-line/24 KB chat budget, protect edits against newer changes, and let you undo recorded changes.
+- Routines: prompts that run on a schedule, such as every weekday at 9:00, at a fixed interval, or when their webhook is called from this computer. Results can be collected in one chat. Inspect run history, run a routine now or stop an active run from settings, or ask the bot to do it.
+- Teams: bots grouped under a Chief of Staff who takes your requests and hands parts of the work to the others.
+- Skills and tools: one library of skills and MCP servers, switched on per bot. Skills can be imported from GitHub and MCP servers from Claude Code, Claude Desktop or Cursor. Send /learn after a task and the bot writes up what worked as a skill.
+- Connected apps: Gmail, Slack, Notion and other apps from Composio's catalog, with several named accounts per app and per-bot limits on which tools a bot may use.
+- Paseo tools: bots can start other agents, open workspaces and terminals, set up schedules and use the browser.
+- Interactive chat: editable drafts, confirmation cards, choices and forms return answers to the original chat. Completed tool steps collapse together, search results show source cards, and handoff cards show another bot's progress with a link to its conversation. Quote messages into a reply or save them for later.
+- Avatars: choose a built-in pixel, modern or orbital generator and customize its seed, palette and shape, use an image URL, or upload a picture on web clients. No image service or API key is needed.
+- Navigation: one Bots entry in Paseo's sidebar, with search and pinned bots inside the Bots list. Bot list options includes Manage routines. New bot contains defaults and preset management; Team map offers Team file import/export; Skills & Tools holds the shared library and apps.
+
+## Setup
+
+Requires Paseo 0.16.0 or later. Bots run on the agent providers already set up on the host, such as Claude Code or Codex. Scheduled routines run while the daemon is running, even when the app is closed, and support explicit time zones.
+
+For connected apps, open Skills & Tools in the Bots screen and sign in to Composio in your browser. Bots uses your personal Composio project and its app connections. Credentials stay on the Paseo host: bots reach Composio through a local relay that only allows the apps and tools you switched on for each bot.
+
+Remote MCP servers support browser OAuth sign-in, automatic token refresh and optional pre-registered client credentials. Choose OAuth in the server's Authentication setting, then Connect. Credentials stay on this host; Disconnect removes them and blocks the connection. A full callback URL can finish sign-in when the browser is on another device.
+
+## Data and permissions
+
+Bot settings, memory, logs, skills and MCP server definitions are stored on the Paseo host. A bot's instructions, memory, prompts and tool results go to the agent provider it runs on, and app tool calls go to Composio. A bot can create, edit and delete bots, teams, routines, skills and MCP servers once you apply the changes it proposes. Shell commands you have allowed for a bot run again in the same folder without asking.
+
+Built-in avatars are generated locally.
diff -ruN a/package/README.md b/package/README.md
--- a/package/README.md	1985-10-26 08:15:00.000000000 +0000
+++ b/package/README.md	1985-10-26 08:15:00.000000000 +0000
@@ -4,7 +4,7 @@
 
 # paseo-bots
 
-Personal bots for [Paseo](https://paseo.sh), like Grok Bot or Hermes Bots. Give each bot instructions, a model, memory, skills and tools, then chat with it in its own workspace or let it run routines.
+Personal bots for [Paseo](https://paseo.sh). Give each bot instructions, a model, memory, skills and tools, then chat with it in Bots or let it run routines. New chats use background workspaces to keep them separate from the coding sidebar. Bots runs in the standard Paseo app; no custom build or host patch is required.
 
 ## Core Features
 
@@ -12,15 +12,21 @@
 | --- | --- |
 | **Bots** | Instructions, provider and model, host, approval mode and an avatar. Start blank or from a role such as Email triage or Researcher, or ask a bot to set them up. |
 | **Memory** | Each bot keeps a `MEMORY.md` it updates as it learns, and a daily log of its chats. |
-| **Routines** | Runs on a schedule, such as every weekday at 9:00, or when its webhook is called. |
+| **Routines** | Cron schedules with time zones, fixed intervals, one-time runs and local webhooks. Manage run history, pause schedules and stop active runs. |
 | **Teams** | Put bots on a team with a Chief of Staff, who takes your requests and hands parts to the others. Each team gets a tab and a pixel-art logo. |
 | **Skills & Tools** | One library of skills and MCP servers, switched on per bot. Import skills from GitHub and MCP servers from Claude Code, Claude Desktop or Cursor. |
 | **Learning** | Send `/learn` after a task and the bot writes it up as a skill. |
-| **Connected apps** | 1,000+ apps such as Gmail, Slack and Notion through [Composio](https://composio.dev), with several named accounts per app. |
+| **Connected apps** | Apps such as Gmail, Slack and Notion from [Composio's](https://composio.dev) catalog, with several named accounts per app. |
 | **Paseo tools** | Bots can start other agents, open workspaces, set up schedules and use the browser. |
+| **Interactive chat** | Review editable drafts, answer forms, select options and confirm actions in the conversation. Completed tool steps collapse together; search results have source cards. |
+| **Conversations** | Threads beneath each bot, pinned chats, saved messages, search and device-local reply drafts. Handoff cards link to another bot's conversation. |
+| **Avatars** | Built-in pixel, modern and orbital generators with a seed, palette and shape, plus custom image uploads. No image service or API key is needed. |
+| **Quick access** | One Bots entry in Paseo's sidebar. Search and pin bots inside Bots, and manage routines from Bot list options. |
 
 ## Screenshots
 
+These screenshots show the earlier UI. The usage guide below describes the current controls and navigation.
+
 | | |
 | --- | --- |
 | **Bots** | **Bot settings** |
@@ -32,44 +38,107 @@
 
 ## Install
 
+Requires Paseo **0.16.0 or later** on the host and connected clients, with plugins enabled and an agent provider configured. Install a published release with:
+
 ```bash
 paseo plugin install npm:@oliexe/paseo-bots

-Or paste npm:@oliexe/paseo-bots into Settings → Plugins → Plugin source in Paseo. Requires Paseo 0.9.2 or later.
+Or paste npm:@oliexe/paseo-bots into Settings → Plugins → Plugin source in Paseo. To update an npm installation, run paseo plugin update paseo-bots.
+
+To run the current repository version, install a local checkout on the Paseo host:
+
+bash +git clone https://github.com/oliexe/paseo-bots.git +cd paseo-bots +npm ci +paseo plugin install "$PWD" +
+
+For an existing checkout, pull changes, run npm ci, then paseo plugin reload paseo-bots. Installations are per host; choose that host in Paseo when opening Bots.
+
+You can use Bots through Paseo's desktop, browser or mobile client, including when the Paseo host runs on another machine. Separately, a bot's Host setting can send its chats to another machine. That target does not receive this installation's memory, skills, connected apps or bot tools, so handoffs and /learn are unavailable there. File uploads also require the bot to run on the host selected for Bots; images and text attachments work with other targets. For all features on another machine, install Bots there and select that installation in Paseo.

Usage

Bots

  1. Open Bots in Paseo's sidebar and press New bot. Start blank, from a role, from one of your presets, or paste a bot or team file under Import.
    -2. Chat with it. Every chat is a thread in the bot's workspace; Open in Paseo in a chat's menu shows it in Paseo's own view.
    +2. Expand a bot to see its threads. Press + beside the bot or New chat beneath it to start a conversation. New chats use the bot's hidden background workspace; Open in Paseo in a chat's menu opens it in Paseo's workspace view.
  2. Open its settings with the panel button at the top right of a chat, or Open bot settings in the bot's menu. Identity holds the name, avatar and voice, Soul its standing instructions, Model the provider and model, and Permissions the approval mode.

Bots can do the setting up too. Ask one in a chat, for example "Create a research team of three bots with Scout as Chief of Staff", and it shows every change on one card; Apply changes makes them. A bot can create, edit and delete bots, teams, routines, library skills and MCP servers, and change what new bots start with. Each bot's earlier settings stay under History in its settings.

+Applying or dismissing a proposal notifies the chat that proposed it, so the bot can continue. Changes are confirmed only after saving succeeds; notifications wait while the bot is working or needs permission. If notification fails, Retry notification sends the saved decision without applying it again.
+
+Use Pin to top in a bot's menu for quick access. The same action on a chat puts it in the Pinned section. Find bots… filters the bot list; Bot list options controls archived bots and chat order. Threads stay nested beneath bots inside the single Bots sidebar entry. Existing conversations remain accessible, and older visible workspaces keep their original visibility. Command Center also offers Open Bots and New bot.
+
+The chat menu also offers Copy transcript, Copy path, Copy chat ID and Archive.
+
+### Drafts and sending
+
+Unsent replies and their attachments are saved on this device, separately for each host, bot and chat. They restore when you return to the conversation. Failed sends keep the reply available for retry. Queued messages are separate from saved drafts and last only for the current app session.
+
+Draft storage keeps up to 50 recent replies within a 2 MB budget. Large image attachments and older drafts may be omitted on reload; a single oversized reply may be shortened to fit.
+
+While a bot is working, sending follows Paseo's When the agent is working preference. Stop agent interrupts its current work and pauses queued replies while preserving the conversation. It cannot undo actions the bot already completed.
+
+On desktop and web, use + to add images or files, or drag them into the composer. Mobile clients offer Paste text. Use Find in chat in the chat header to search a conversation.
+

Memory

A bot updates its MEMORY.md when it learns something worth keeping, for example when you say "Remember that I prefer short answers". New chats start with it.

In the bot's settings, Memory shows MEMORY.md and its topic files, which you can edit, a Daily log of its chats, and Changes, where Undo puts a file back the way it was.

+The memory panel shows how much enters each chat: up to 200 lines or 24 KB of MEMORY.md. It warns when the end is left out; topic files remain available for the bot to read when needed. If a file changes while you are editing it, saving reports the conflict instead of overwriting the newer version.
+

Routines

  1. In the bot's settings, open Routines and press New routine.
  2. Give it a name and a prompt. The prompt is the first message of each run.
    -3. Pick when it repeats: a preset such as Weekdays 9:00 or your own cron expression, Once, or When its webhook is called.
    +3. Pick when it repeats: a preset such as Weekdays 9:00, your own cron expression, a Fixed interval of 5–1440 minutes, Once, or When its webhook is called.
  3. To collect results in one place, pick a chat under Post results to. Each run still gets its own chat.

Bots can propose routines too: ask in a chat, then press Create routine on the card. A webhook routine's URL is under Copy webhook URL in its menu; POST to it from this computer.

+For an overview across bots on the current host, open Bot list options beside the Bots list heading, then Manage routines. It includes search, pause/resume, manual runs and run history. Cron routines can use an explicit IANA time zone; otherwise they follow the host's time zone. Interval routines retain their cadence across restarts. Scheduled and manual triggers skip a routine while an earlier run is working or waiting for permission; webhooks allow up to three unfinished runs.
+
+Routines run on the host that stores the bot and are unavailable when that bot targets another host. The daemon must remain running, but an open Bots screen is not required. Unattended startup uses the installed paseo CLI, which must be available on the daemon's PATH.
+
+Ask a bot to list its routines and recent runs, run a routine now, or stop an active run. The list_routines, run_routine and cancel_routine_run tools operate on that bot's routines. Stopping a run keeps its conversation and history, leaves its schedule unchanged, and cannot undo actions already completed.
+
+You can also open Activity → Runs in a bot's routines and press Stop for an active run. The same control is available from the routines overview. If interruption fails, the run stays visible with Retry stop; a run that finishes during the request keeps its actual outcome.
+
+### Interactive chat
+
+Bots can show confirmation cards, single- or multiple-choice questions, forms and editable drafts with the show_card tool. Your answer returns to the original chat. Approving a draft sends its edited content back to the bot; it does not itself send an email or publish anything. Add to reply puts a draft in the composer and preserves text already there.
+
+Cards retain their answers across reloads and reject changed answers after submission. Failed deliveries can be retried with the same answer. Successful background tool calls are grouped into expandable steps; active calls, failures and cards that need an answer stay visible. Search and fetch results expose clickable sources.
+
+In Bots, recognized card answers appear as readable confirmations and labeled fields; Show original response reveals the full message sent to the bot. Some restored conversations may show the original response instead. User and assistant messages have Quote in reply and Save message actions. Open Saved messages from the chat header to return to the original message. Bookmarks sync with the host and stay out of bot and team exports.
+
+When one bot asks another for help, a handoff card shows the receiving bot's status and latest reply. Open conversation takes you to that bot's chat; Review request appears when it needs approval. Each bot retains its own tools and permissions.
+
+ask_bot sends a completion update back to the asking chat, including when wait: false is used or the 50-second wait expires. Set notify: false on a call to check the answer manually with check_chat. Updates include the delegated chat ID and a shortened answer. They wait while the asking chat is busy or awaiting approval; archived or deleted chats are not reactivated. Pending updates are saved on the host and retried after a connection failure or plugin reload. Paseo acknowledges bot messages before dispatch, so a daemon crash at that point can lose an update; check_chat remains available to retrieve the answer.
+
+For follow-up work, call ask_bot with the same target bot and the earlier chat_id. The worker keeps its conversation and context. Only the bot that started the delegation can continue it, and the worker must finish its current turn and any approval request first. The follow-up's completion returns to the chat that sent it; notify: false applies to that request too. Omit chat_id to start a separate task.
+
+### Avatars and defaults
+
+Open Identity → Picture, choose Pixel, Modern or Orbital, then adjust the palette, seed and shape. These built-in generators work without an image service or API key. Desktop and web clients can upload a picture; every client can use an image URL.
+
+In New bot, press Configure beside Defaults for new bots to set the provider, model and permissions inline. Manage under Your presets lets you delete saved presets without changing bots created from them. Shared apps, skills and MCP servers remain under Skills & Tools. Controls use Paseo's UI and appearance settings.
+

Teams

  1. Press Team map at the bottom of the bot list, then New team.
  2. Name the team, switch on its members, pick a Lead as its Chief of Staff, and add shared instructions for every member. The team gets a pixel-art logo; Reroll draws another, or use your own picture.
  3. Send your requests to the Chief of Staff. It hands parts of the work to its teammates.

-With teams, the Bots screen gets a tab for each team, and Other bots for bots without one (a menu on phones); + next to the tabs adds a team, and right-clicking a tab edits it. A team file carries your bots and their teams: find it in Settings → Plugins, under Bots in the paseo-bots menu.
+With teams, the Bots screen gets a tab for each team, and Other bots for bots without one (a menu on phones); + next to the tabs adds a team, and right-clicking a tab edits it. To import or export your bots and their teams together, open Team map, then Team file in its toolbar.
+
+Bot and team files can include memory and skills. Imported routines start paused, imported skills need review, and MCP credentials must be entered again. Chat history, saved-message bookmarks and device drafts are not included.

Whether a bot may ask others for help is set in its settings under Permissions → Contact other bots: Ask first, Allowed or Off.

@@ -82,28 +151,43 @@

Then give them to a bot in its settings: skills under Skills, MCP servers under Access.

+Remote HTTP and SSE servers also support OAuth under Authentication. Save the server, then press Connect to approve access in your browser. Tokens and client secrets stay on the host; the local proxy refreshes tokens for bots automatically. Client registration accepts a pre-registered client ID and optional secret when automatic registration is unavailable, and shows the redirect URI to register. From another device, use Signing in from another device? and paste the complete callback URL if the browser cannot reach the host's loopback address. Disconnect removes the saved credentials and blocks existing proxy connections. Start a new chat after changing a server from headers to OAuth; OAuth connections run on the host where this plugin is installed. In Paseo 0.16, exact Always allowed OAuth tool grants work with Claude; other providers keep their native approval rules. Legacy SSE requires a provider that supports it, such as Claude; use Streamable HTTP with Codex.
+

Learning

After a task, send /learn in the chat, or /learn <what to focus on>. The bot writes up what worked as a skill and shows it as a card; press Save skill to add it to Skills & Tools and turn it on for that bot.

Connected apps

-Connected apps run on your own Composio account.
+Connected apps use your personal Composio account and its existing app connections. Sign-in works from desktop and mobile, including when the Paseo host runs elsewhere.

-1. Create a project at platform.composio.dev and copy its API key (it starts with ak_).
-2. In Paseo, open Bots, then Skills & Tools at the bottom of the bot list.
-3. Next to Connected apps, press +, paste the key and press Connect.
+1. In Paseo, open Bots, then Skills & Tools at the bottom of the bot list.
+2. Open Connected apps and press Sign in to Composio.
+3. Approve the sign-in in your browser. Check that the approval code matches the one in Bots.
4. Find an app, press Connect and finish signing in in your browser.
5. Switch the app on for a bot under the bot's Access settings, or on the app's page.

+Existing project-key installations keep working. Signing in switches Bots to your personal Composio project; connections in the old project stay there. Signing out removes credentials from this host and leaves app connections in Composio.
+
To add a second account of an app, such as a work and a personal Gmail, open the app's page and press Connect next to Add another account. Bots pick an account by its name.

When a bot needs an app that isn't connected, its chat shows a card: press Sign in, finish on Composio's page, then Continue. Signing in from the card also switches the app on for that bot.

To limit what a bot does with an app, open the app under the bot's Access settings: allow all of its tools, only the read-only ones, or the ones you choose, and keep the bot to one account. The relay refuses anything else, and turns off Composio's remote workbench for bots with limits, since code there could run any app's tools.

-The key stays on the Paseo host and never reaches the agents: bots reach Composio through a local relay that only lets each bot use the apps you switched on for it.
+Your Composio credentials stay on the Paseo host and never reach the agents: bots reach Composio through a local relay that only lets each bot use the apps you switched on for it.

Paseo tools

Bots get Paseo's own tools, so you can ask one in a chat to start other agents, open workspaces and terminals, set up schedules or use the browser. A bot's Access settings show whether they're on, and Turn on there switches them on for every agent on the host.
+
+## Development
+
+bash +npm ci +npm test +npm run typecheck +paseo plugin reload paseo-bots +
+
+The reload command applies changes to a local checkout already installed on that host. paseo plugin ls shows its status; paseo plugin logs paseo-bots shows startup and runtime errors. Source changes do not require restarting the Paseo daemon.
diff -ruN a/package/client/AttachmentPill.tsx b/package/client/AttachmentPill.tsx
--- a/package/client/AttachmentPill.tsx 1985-10-26 08:15:00.000000000 +0000
+++ b/package/client/AttachmentPill.tsx 1985-10-26 08:15:00.000000000 +0000
@@ -1,5 +1,5 @@
import type { PluginTheme } from "@getpaseo/plugin";
-import { Icon, Modal, ScrollView } from "@getpaseo/plugin/client/react-native";
+import { Icon, Modal, ScrollView } from "@getpaseo/plugin/client/ui";
import { useState, type ReactNode } from "react";
import { ActivityIndicator, Image, Platform, Pressable, Text, View, useWindowDimensions } from "react-native";
import { getFileTypeLabel, type ComposerAttachment } from "../shared/attachments";
diff -ruN a/package/client/Avatar.tsx b/package/client/Avatar.tsx
--- a/package/client/Avatar.tsx 1985-10-26 08:15:00.000000000 +0000
+++ b/package/client/Avatar.tsx 1985-10-26 08:15:00.000000000 +0000
@@ -1,9 +1,11 @@
-import { createContext, useContext, useMemo, type ReactNode } from "react";
-import { Image, View } from "react-native";
+import { createContext, useContext, useMemo, useState, type ReactNode } from "react";
+import { Image, Platform, View } from "react-native";
import { pixelAvatar, SPRITE_SIZE } from "../shared/avatar";
+import { avatarStyle, smoothAvatar, type AvatarStyle } from "../shared/avatar-options";
import type { BotAvatar, BotGroup } from "../shared/bot";
import { teamLogoOf } from "../shared/groups";
import type { PixelRun } from "../shared/pixel";
+import { pixelSpriteDataUri } from "../shared/pixel-svg";
import { LOGO_SIZE, teamLogo } from "../shared/team-logo";

interface AvatarProps {
@@ -28,11 +30,23 @@
const themeDark = useContext(AvatarThemeContext);
const dark = darkProp ?? themeDark;
const palette = avatar.palette ?? null;

  • const sprite = useMemo(() => pixelAvatar(avatar.seed, palette, { dark }), [avatar.seed, palette, dark]);
  • const [failedImage, setFailedImage] = useState<string | null>(null);
    const radius = radiusFor(avatar.shape, size);
  • if (avatar.imageUrl) {
  • return <Image accessibilityIgnoresInvertColors source={{ uri: avatar.imageUrl }} style={{ width: size, height: size, borderRadius: radius }} />;
  • if (avatar.imageUrl && avatar.imageUrl !== failedImage) {
  • return <Image accessibilityIgnoresInvertColors source={{ uri: avatar.imageUrl }} onError={() => setFailedImage(avatar.imageUrl ?? null)} style={{ width: size, height: size, borderRadius: radius }} />;
    }
  • return ;
    +}

+function GeneratedAvatar({ seed, palette, style, dark, size, radius }: { seed: string; palette: number | null; style: AvatarStyle; dark: boolean; size: number; radius: number }) {

  • const sprite = useMemo(() => style === "pixel" ? pixelAvatar(seed, palette, { dark }) : null, [seed, palette, dark, style]);
  • const smooth = useMemo(() => style !== "pixel" ? smoothAvatar(seed, style, palette, dark) : null, [seed, palette, dark, style]);
  • if (smooth) return (
  • <View accessibilityElementsHidden importantForAccessibility="no-hide-descendants" style={{ width: size, height: size, borderRadius: radius, backgroundColor: smooth.background, overflow: "hidden" }}>
  •  {smooth.layers.map((layer, index) => <View key={index} style={{ position: "absolute", left: layer.x * size / 100, top: layer.y * size / 100, width: layer.width * size / 100, height: layer.height * size / 100, borderRadius: layer.radius * size / 100, backgroundColor: layer.color, opacity: layer.opacity ?? 1, transform: [{ rotate: `${layer.rotation ?? 0}deg` }] }} />)}
    
  • );
  • if (!sprite) return null;
    return ;
    }

@@ -55,9 +69,11 @@

  • sit inset in their frame except when small; inset false fills it (team logos).
    */
    export function PixelSprite({ sprite, size, radius = size / 2, grid = SPRITE_SIZE, inset = true }: { sprite: { background: string; rows: PixelRun[][] }; size: number; radius?: number; grid?: number; inset?: boolean }) {
  • const uri = useMemo(() => Platform.OS === "web" ? pixelSpriteDataUri(sprite, size, radius, grid, inset) : null, [sprite, size, radius, grid, inset]);
    // Small avatars (sidebar rows) use the full frame so each sprite pixel stays about one point.
    const inner = !inset || size <= 24 ? size : size * 0.82;
    const pixel = inner / grid;
  • if (uri) return <Image accessibilityElementsHidden importantForAccessibility="no-hide-descendants" accessibilityIgnoresInvertColors source={{ uri }} style={{ width: size, height: size, borderRadius: radius }} />;
    return (
    <View
    accessibilityElementsHidden
    diff -ruN a/package/client/BotDialogs.tsx b/package/client/BotDialogs.tsx
    --- a/package/client/BotDialogs.tsx 1985-10-26 08:15:00.000000000 +0000
    +++ b/package/client/BotDialogs.tsx 1985-10-26 08:15:00.000000000 +0000
    @@ -1,15 +1,16 @@
    import type { PluginTheme } from "@getpaseo/plugin";
    import { useRpc } from "@getpaseo/plugin/client";
    -import { Icon, Modal, TextInput, copyText, useToast } from "@getpaseo/plugin/client/react-native";
    -import { SettingsAction, SettingsCard, SettingsSection, SettingsSwitch } from "@getpaseo/plugin/client/ui";
    -import { useEffect, useState } from "react";
    +import { copyText, Icon, Modal, SettingsAction, SettingsCard, SettingsSection, SettingsSwitch, TextInput, useToast } from "@getpaseo/plugin/client/ui";
    +import { useEffect, useRef, useState } from "react";
    import { Pressable, Text, View } from "react-native";
    -import type { Bot, BotAvatar, Preset } from "../shared/bot";
    +import type { Bot, BotAvatar, BotDefaults, Preset } from "../shared/bot";
    import { exportBotRpc } from "../shared/rpc";
    import { BOT_TEMPLATES, type BotTemplate } from "../shared/templates";
    import { Avatar } from "./Avatar";
    +import { NewBotDefaults } from "./NewBotDefaults";
    +import type { LocalHost } from "./data";
    import { errorText, MONO_FONT, MONO_PROPS, nativeTokens, useHover } from "./native";
    -import { Button, FormTextArea, SheetActions } from "./panel/controls";
    +import { Button, FormTextArea, SectionLink, SheetActions } from "./panel/controls";
    import type { MenuEntry } from "./ui/Menu";
    import { code, codeLine, ui } from "./typography";

@@ -20,39 +21,61 @@
export function NewBotDialog({
colors,
presets,

  • defaults,
  • localHost,
  • onDefaultsChange,
  • onDeletePreset,
    onClose,
    onCreate,
    onImport,
    }: {
    colors: Colors;
    presets: readonly Preset[];
  • defaults: BotDefaults;
  • localHost: LocalHost;
  • onDefaultsChange(patch: Partial): void;
  • onDeletePreset(preset: Preset): Promise;
    onClose(): void;
  • onCreate(start?: { template?: BotTemplate; preset?: Preset }): void;
  • onCreate(start: { template?: BotTemplate; preset?: Preset } | undefined, defaults: BotDefaults): void;
    onImport(json: string): Promise;
    }) {
    const [json, setJson] = useState("");
    const [importing, setImporting] = useState(false);
  • const [editingDefaults, setEditingDefaults] = useState(false);
  • const [managingPresets, setManagingPresets] = useState(false);
  • const [pendingPreset, setPendingPreset] = useState<string | null>(null);
  • const [draftDefaults, setDraftDefaults] = useState(defaults);
  • const defaultsRef = useRef(defaults);
    const toast = useToast();
    return (
    <Modal title="New bot" open onOpenChange={(open) => !open && onClose()}>
    <Modal.Content>

  •        <StartRow colors={colors} label="Blank bot" hint="Set everything up yourself in the settings panel." onPress={() => onCreate()} />
    
  •        <StartRow colors={colors} label="Blank bot" hint="Set everything up yourself in the settings panel." onPress={() => onCreate(undefined, defaultsRef.current)} />
           {BOT_TEMPLATES.map((template) => (
    
  •          <StartRow key={template.id} colors={colors} label={template.title} hint={template.description} avatar={{ seed: template.avatarSeed }} onPress={() => onCreate({ template })} />
    
  •          <StartRow key={template.id} colors={colors} label={template.title} hint={template.description} avatar={{ seed: template.avatarSeed }} onPress={() => onCreate({ template }, defaultsRef.current)} />
           ))}
         </SettingsCard>
       </SettingsSection>
       {presets.length ? (
    
  •      <SettingsSection title="Your presets" info="Bots you saved as presets from their menu. Manage them in Settings, Plugins, paseo-bots.">
    
  •      <SettingsSection title="Your presets" info="Bots you saved as presets from their menu. Deleting a preset leaves bots made from it unchanged." trailing={<SectionLink colors={colors} label={managingPresets ? "Done" : "Manage"} icon={managingPresets ? "Check" : "Pencil"} onPress={() => setManagingPresets(!managingPresets)} />}>
           <SettingsCard>
             {presets.map((preset) => (
    
  •            <StartRow key={preset.id} colors={colors} label={preset.name} hint={preset.title || preset.description} avatar={preset.avatar} onPress={() => onCreate({ preset })} />
    
  •            managingPresets ? <SettingsAction key={preset.id} label={preset.name} hint={preset.title || preset.description} actionLabel={pendingPreset === preset.id ? "Deleting…" : "Delete"} disabled={pendingPreset !== null} onPress={() => {
    
  •              if (pendingPreset) return;
    
  •              setPendingPreset(preset.id);
    
  •              void onDeletePreset(preset).catch((error: unknown) => toast.error(errorText(error))).finally(() => setPendingPreset(null));
    
  •            }} /> : <StartRow key={preset.id} colors={colors} label={preset.name} hint={preset.title || preset.description} avatar={preset.avatar} onPress={() => onCreate({ preset }, defaultsRef.current)} />
             ))}
           </SettingsCard>
         </SettingsSection>
       ) : null}
    
  •    {editingDefaults ? <NewBotDefaults localHost={localHost} defaults={draftDefaults} trailing={<SectionLink colors={colors} label="Done" icon="Check" onPress={() => setEditingDefaults(false)} />} onChange={(patch) => {
    
  •      defaultsRef.current = { ...defaultsRef.current, ...patch };
    
  •      setDraftDefaults(defaultsRef.current);
    
  •      onDefaultsChange(patch);
    
  •    }} /> : <SettingsCard><SettingsAction label="Defaults for new bots" hint="Provider, model and permissions for new bots" actionLabel="Configure" onPress={() => setEditingDefaults(true)} /></SettingsCard>}
       <SettingsSection title="Import" info="Paste a bot or team file from paseo-bots. Routines arrive paused, skills need a review and secrets must be filled in again.">
         <FormTextArea
           colors={colors}
    

diff -ruN a/package/client/BotSidebar.tsx b/package/client/BotSidebar.tsx
--- a/package/client/BotSidebar.tsx 1985-10-26 08:15:00.000000000 +0000
+++ b/package/client/BotSidebar.tsx 1985-10-26 08:15:00.000000000 +0000
@@ -1,6 +1,6 @@
import type { PluginTheme } from "@getpaseo/plugin";
-import type { PaseoAgent } from "@getpaseo/client";
-import { Icon, ScrollView } from "@getpaseo/plugin/client/react-native";
+import type { PaseoAgent } from "./paseo";
+import { Icon, ScrollView } from "@getpaseo/plugin/client/ui";
import { memo, useEffect, useRef, useState, type ReactNode, type RefObject } from "react";
import { Animated, Easing, Platform, Pressable, Text, View, type LayoutRectangle } from "react-native";
import type { Bot, BotGroup, BotListUi } from "../shared/bot";
@@ -9,10 +9,11 @@
import { aggregateBuckets, BUCKET_LABELS, chatBucket, orderChats, SIDEBAR_GROUP_LIMIT, type ChatBucket } from "../shared/sidebar";
import { Avatar } from "./Avatar";
import { useBotChats, useBotHost, type LocalHost } from "./data";
-import { openLibrary } from "./navigation";
+import { useOpenLibrary } from "./navigation";
import { nativeTokens, useHover, type NativeTokens } from "./native";
import { Splash } from "./Splash";
import { ui } from "./typography";
+import { SearchField } from "./panel/controls";
import { contextMenuProps, measureAnchor } from "./ui/Menu";
import { tooltip } from "./ui/Tooltip";

@@ -27,6 +28,8 @@
chatId: string | null;
/** First message to send straight away when starting a new chat. */
prompt?: string;

  • /** Title for the chat that prompt starts; Paseo derives one from the prompt otherwise. */
  • title?: string;
    }

export type MenuSource = "kebab" | "context";
@@ -72,7 +75,13 @@
export function BotSidebar(props: BotSidebarProps) {
const { colors, bots, openTab, ui: listUi, hiddenArchivedCount, bottomInset, onNewBot, onShowArchived, onTeamMap, onEditTeam } = props;
const tokens = nativeTokens(colors);

  • const shown = openTab?.bots ?? bots;
  • const [query, setQuery] = useState("");
  • const terms = query.trim().toLocaleLowerCase().split(/\s+/).filter(Boolean);
  • const available = openTab?.bots ?? bots;
  • const shown = available.filter((bot) => {
  • const text = ${bot.name} ${bot.title} ${bot.description}.toLocaleLowerCase();
  • return terms.every((term) => text.includes(term));
  • });
    const pinnedIds = new Set(listUi.pinnedChats.map((pin) => pin.chatId));
    const listedBots = new Map(shown.map((bot) => [bot.id, bot]));
    const pins = listUi.pinnedChats.filter((pin) => listedBots.has(pin.botId));
    @@ -87,6 +96,7 @@
    }
    return (
    <View style={{ flex: 1, paddingBottom: bottomInset, backgroundColor: tokens.surfaceSidebar }}>
  •  {available.length || query ? <View style={{ paddingHorizontal: 8, paddingTop: 8, paddingBottom: 6 }}><SearchField colors={colors} value={query} onChangeText={setQuery} placeholder="Find bots…" /></View> : null}
     <ScrollView
       style={{ flex: 1 }}
       keyboardShouldPersistTaps="handled"
    

@@ -94,11 +104,11 @@
contentContainerStyle={{ paddingHorizontal: 8, paddingTop: 2, paddingBottom: 16 }}
>
{pins.length > 0 ? <PinnedSection {...props} pins={pins} botById={listedBots} tokens={tokens} /> : null}

  •    {shown.length > 0 || hiddenArchivedCount > 0 ? <SectionHeader colors={colors} onDisplayMenu={props.onDisplayMenu} /> : null}
    
  •    {available.length > 0 || hiddenArchivedCount > 0 ? <SectionHeader colors={colors} onDisplayMenu={props.onDisplayMenu} /> : null}
       {shown.map((bot) => (
         <BotGroup key={bot.id} {...props} tokens={tokens} bot={bot} lead={bot.id === leadId} pinnedIds={pinnedIds} />
       ))}
    
  •    {openTab?.group && shown.length === 0 ? (
    
  •    {terms.length > 0 && shown.length === 0 ? <EmptyState colors={colors} title="No matching bots" description="Search by name, role or description." action={{ icon: "X", label: "Clear search", onPress: () => setQuery("") }} /> : openTab?.group && shown.length === 0 ? (
         <EmptyState colors={colors} title="No bots on this team" description="Add bots to it in the team's settings." action={{ icon: "Pencil", label: "Edit team", onPress: () => onEditTeam(openTab.group!) }} />
       ) : bots.length === 0 ? (
         hiddenArchivedCount > 0 ? (
    

@@ -129,8 +139,8 @@
<Pressable
ref={ref}
accessibilityRole="button"

  •    accessibilityLabel="Display preferences"
    
  •    {...tooltip("Display preferences", "bottom")}
    
  •    accessibilityLabel="Bot list options"
    
  •    {...tooltip("Bot list options", "bottom")}
       onPress={() => void measureAnchor(ref).then((anchor) => anchor && onDisplayMenu(anchor))}
       {...hoverProps}
       style={{ width: 28, height: 28, alignItems: "center", justifyContent: "center", borderRadius: 6, backgroundColor: hovered ? colors.surface1 : "transparent" }}
    

@@ -142,6 +152,7 @@
}

function Footer({ colors, onNewBot, onTeamMap }: { colors: Colors; onNewBot(): void; onTeamMap(): void }) {

  • const openLibrary = useOpenLibrary();
    const { hovered, hoverProps } = useHover();
    return (
    <View style={{ flexDirection: "row", alignItems: "center", gap: 8, paddingHorizontal: 8, paddingVertical: 12, borderTopWidth: 1, borderTopColor: colors.border }}>
    diff -ruN a/package/client/BotsSurface.tsx b/package/client/BotsSurface.tsx
    --- a/package/client/BotsSurface.tsx 1985-10-26 08:15:00.000000000 +0000
    +++ b/package/client/BotsSurface.tsx 1985-10-26 08:15:00.000000000 +0000
    @@ -1,12 +1,11 @@
    import type { PluginTheme } from "@getpaseo/plugin";
    -import type { PaseoAgent } from "@getpaseo/client";
    -import type { PluginSurfaceProps } from "@getpaseo/plugin/client";
    +import type { PaseoAgent } from "./paseo";
    +import type { PluginScreenProps, PluginOpenScreenInput } from "@getpaseo/plugin/client";
    import { useRpc } from "@getpaseo/plugin/client";
    -import { copyText, useToast } from "@getpaseo/plugin/client/react-native";
    -import { SettingsAction, SettingsCard } from "@getpaseo/plugin/client/ui";
    +import { copyText, Icon, SettingsAction, SettingsCard, useToast } from "@getpaseo/plugin/client/ui";
    import { useQueryClient } from "@tanstack/react-query";
    import { useEffect, useRef, useState } from "react";
    -import { ActivityIndicator, BackHandler, type LayoutRectangle, Platform, Text, View } from "react-native";
    +import { ActivityIndicator, BackHandler, type LayoutRectangle, Platform, Pressable, Text, View } from "react-native";
    import { randomSeed } from "../shared/avatar";
    import { applyDefaults, DEFAULT_BOT_DEFAULTS, DEFAULT_BOT_LIST_UI, EMPTY_LIBRARY, newBotId, newGroupId, presetFromBot, pushHistory, type Bot, type BotGroup, type BotListUi, type Library } from "../shared/bot";
    import { saveTeam, tabOf, teamTabs, withoutBot } from "../shared/groups";
    @@ -23,23 +22,31 @@
    import { useBotHost, useChatInvalidation, useHostResolver, useProviders, type LocalHost } from "./data";
    import { takeIntent } from "./intent";
    import { LibraryView } from "./library/LibraryView";
    -import { onLibraryTarget, type LibraryTarget } from "./navigation";
    +import { LibraryNavigation, type LibraryTarget } from "./navigation";
    +import { chatScreen, chatSelectionKey, libraryScreen as libraryRoute, libraryTarget, startedChat, rememberStartedChat, claimAutomaticChat, retryAutomaticChat, parentScreen, teamMapScreen, type BotScreen } from "./screen-navigation";
    import { Splash } from "./Splash";
    import { TeamMap } from "./teams/TeamMap";
    import { TeamSheet } from "./teams/TeamSheet";
    +import { TeamFileDialog } from "./teams/TeamFileDialog";
    import { TeamTabsRow, TeamTabSwitcher } from "./teams/TeamTabs";
    import { ResizeHandle, SlideOver } from "./ui/Columns";
    -import { fitColumns } from "../shared/layout";
    +import { hasTouchScreen } from "./web";
    +import { fitColumns, isTouchLayout } from "../shared/layout";
    import { confirmDialog, errorText, nativeTokens } from "./native";
    import { measureAnchor, MenuProvider, useMenu } from "./ui/Menu";
    import { useTooltipTheme } from "./ui/Tooltip";
    import { homeIndicatorInset, useKeyboardHeight } from "./keyboard";
    import { newMessageId } from "./sent-attachments";
    -import { BotPanel, type SectionId } from "./panel/BotPanel";
    +import { BotPanel, botSectionTitle, type SectionId } from "./panel/BotPanel";
    import { useBotSettings } from "./useBotSettings";
    import { fullTimeline, useChat } from "./useChat";
    import { newUuid } from "../shared/uuid";
    import { ui, useTypeScale } from "./typography";
    +import { mergeBotEdit, type BotEdit } from "../shared/bot-edits";
    +import { useSurfaceVisibility } from "./useSurfaceVisibility";
    +import { useDraftStore } from "./chat/composer/drafts";
    +import { composerDraftKey } from "./chat/composer/logic";
    +import { beginDraftCreation } from "./chat/composer/draft-creation";

type Colors = PluginTheme["colors"];

@@ -50,7 +57,12 @@
/** Autosave delay after the last edit in the settings panel. */
const SAVE_DELAY_MS = 600;

-export function BotsSurface(props: PluginSurfaceProps) {
+interface BotsSurfaceProps extends PluginScreenProps {

  • screen?: BotScreen;
  • openScreen?(input: PluginOpenScreenInput): void;
    +}

+export function BotsSurface(props: BotsSurfaceProps) {
const { colors } = props.theme;
useTooltipTheme(colors);
return (
@@ -63,11 +75,12 @@
}

-function BotsSurfaceContent({ theme, layout, host, navigation }: PluginSurfaceProps) {
+function BotsSurfaceContent({ theme, layout, host, navigation, params, screen = "bots", openScreen }: BotsSurfaceProps) {
const { colors } = theme;
const { settings, latest, commit } = useBotSettings();
const toast = useToast();
const menu = useMenu();

  • const surfaceVisibility = useSurfaceVisibility();
    const queryClient = useQueryClient();
    const localHost: LocalHost = { id: host.id, label: host.label };
    const localProviders = useProviders(useBotHost(null, localHost));
    @@ -76,18 +89,35 @@
    const importBot = useRpc(importBotRpc);
    const importTeam = useRpc(importTeamRpc);
  • const [selection, setSelection] = useState<Selection | null>(null);
  • const [panel, setPanel] = useState<{ open: boolean; section: SectionId | null }>({ open: false, section: null });
  • const routed = layout.compact && !!openScreen;
  • const initialSelection = (): Selection | null => params.botId ? { botId: params.botId, chatId: params.chatId || startedChat(host.id, params.draftId), ...(params.prompt ? { prompt: params.prompt, title: params.chatTitle } : {}) } : null;
  • const initialPanel = () => ({ open: screen === "bot-settings" || screen === "bot-section" || (!layout.compact && params.panel === "open"), section: botSectionTitle(params.section) ? params.section as SectionId : null });
  • const [selection, setSelection] = useState<Selection | null>(initialSelection);
  • const selectionKey = chatSelectionKey(host.id, selection, params.draftId);
  • const selectionRef = useRef(selectionKey);
  • selectionRef.current = selectionKey;
  • const [panel, setPanel] = useState<{ open: boolean; section: SectionId | null }>(initialPanel);
    const [panelVersion, setPanelVersion] = useState(0);
    const [creating, setCreating] = useState(false);
    /** The team map replaces the chat pane while open. */
  • const [teamMap, setTeamMap] = useState(false);
  • const [teamMap, setTeamMap] = useState(screen === "bot-teams");
    const [editingTeam, setEditingTeam] = useState<BotGroup | "new" | null>(null);
  • const [teamFile, setTeamFile] = useState(false);
    /** Skills & Tools replaces the bot list and chat while open; target is its page (null: the list, on compact). */
  • const [libraryView, setLibraryView] = useState<{ target: LibraryTarget | null } | null>(null);
  • const [libraryView, setLibraryView] = useState<{ target: LibraryTarget | null } | null>(() => screen === "bot-library" || screen === "bot-library-item" ? { target: libraryTarget(params) } : null);
  • const routeKey = JSON.stringify([screen, params, layout.compact]);
  • const previousRoute = useRef(routeKey);
  • useEffect(() => {
  • if (previousRoute.current === routeKey) return;
  • previousRoute.current = routeKey;
  • setSelection(initialSelection());
  • setPanel(initialPanel());
  • setTeamMap(screen === "bot-teams");
  • setLibraryView(screen === "bot-library" || screen === "bot-library-item" ? { target: libraryTarget(params) } : null);
  • }, [routeKey]);
    const [renaming, setRenaming] = useState<Bot | null>(null);
    const [exporting, setExporting] = useState<Bot | null>(null);
  • const [drafts, setDrafts] = useState<Record<string, Bot>>({});
  • const [drafts, setDrafts] = useState<Record<string, BotEdit>>({});
    // List state (collapsed groups, pins, order, display options) applies at once and saves behind.
    const [uiOverride, setUiOverride] = useState<BotListUi | null>(null);
    const uiRef = useRef<BotListUi | null>(null);
    @@ -98,7 +128,7 @@
    const [surfaceWidth, setSurfaceWidth] = useState(0);
    /** Widths while a resize handle is being dragged; saved to the list UI on release. */
    const [dragWidths, setDragWidths] = useState<{ list?: number; panel?: number }>({});
  • // Re-renders the whole surface when Paseo's interface/content/code sizes change.
  • // Re-renders the whole surface when platform accessibility text scaling changes.
    const typeVersion = useTypeScale();
    useChatInvalidation();

@@ -118,24 +148,25 @@
const draft = pending[bot.id];
if (!draft) return bot;
history = pushHistory(history, bot);

  •    return draft;
    
  •    return { ...mergeBotEdit(bot, draft), updatedAt: new Date().toISOString() };
     });
     return { ...values, bots, history };
    
    });
    if (ok) {
  •  setDrafts((current) => {
    
  •    const next = { ...current };
    
  •    for (const [id, bot] of Object.entries(pending)) if (next[id] === bot) delete next[id];
    
  •    return next;
    
  •  });
    
  •  const next = { ...draftsRef.current };
    
  •  for (const [id, edit] of Object.entries(pending)) if (next[id] === edit) delete next[id];
    
  •  draftsRef.current = next;
    
  •  setDrafts(next);
    

    }
    };

    const patchBot = (botId: string, patch: Partial) => {

  • setDrafts((current) => {
  •  const base = current[botId] ?? (latest.current.status === "ready" ? latest.current.values.bots.find((bot) => bot.id === botId) : undefined);
    
  •  return base ? { ...current, [botId]: { ...base, ...patch, updatedAt: new Date().toISOString() } } : current;
    
  • });
  • const current = draftsRef.current;
  • const base = current[botId]?.base ?? (latest.current.status === "ready" ? latest.current.values.bots.find((bot) => bot.id === botId) : undefined);
  • if (!base) return;
  • const next = { ...current, [botId]: { base, patch: { ...current[botId]?.patch, ...patch, updatedAt: new Date().toISOString() } } };
  • draftsRef.current = next;
  • setDrafts(next);
    if (saveTimer.current) clearTimeout(saveTimer.current);
    saveTimer.current = setTimeout(() => void flush(), SAVE_DELAY_MS);
    };
    @@ -155,7 +186,12 @@

/** Applies a patch to the saved bot and to any unsaved draft of it, so autosave can't undo it. */
const updateBot = (botId: string, patch: Partial, recordHistory = false) => {

  • setDrafts((current) => (current[botId] ? { ...current, [botId]: { ...current[botId], ...patch } } : current));
  • const current = draftsRef.current;
  • if (current[botId]) {
  •  const next = { ...current, [botId]: { ...current[botId], patch: { ...current[botId].patch, ...patch } } };
    
  •  draftsRef.current = next;
    
  •  setDrafts(next);
    
  • }
    return commit((values) => {
    const previous = values.bots.find((entry) => entry.id === botId);
    if (!previous) return values;
    @@ -170,20 +206,15 @@
    /** Opens Skills & Tools. Unsaved bot edits are saved first so the library sees them. */
    const enterLibrary = (target: LibraryTarget | null) => {
    void flush();
  • if (routed) {
  •  const values = latest.current.status === "ready" ? latest.current.values : null;
    
  •  const title = target?.kind === "mcp" ? values?.library?.mcpServers.find((entry) => entry.id === target.id)?.name : undefined;
    
  •  openScreen!(libraryRoute(target, title));
    
  •  return;
    
  • }
    setLibraryView({ target });
    };
  • // A bot's settings and the bot list ask for Skills & Tools through the navigation store.
  • const enterLibraryRef = useRef(enterLibrary);
  • enterLibraryRef.current = enterLibrary;
  • useEffect(
  • () =>
  •  onLibraryTarget((target) => {
    
  •    enterLibraryRef.current(target);
    
  •  }),
    
  • [],
  • );
  • // One step back through the Bots screen, as Paseo's own screens go back: a settings page to
    // the settings list, then the settings, Skills & Tools (page, then list), and on phones the
    // team map or a chat back to the bot list. Android's Back and the phone swipes use it; with
    @@ -214,10 +245,10 @@
    const goBackRef = useRef(goBack);
    goBackRef.current = goBack;
    useEffect(() => {
  • if (Platform.OS !== "android") return;
  • if (Platform.OS !== "android" || routed) return;
    const subscription = BackHandler.addEventListener("hardwareBackPress", () => goBackRef.current());
    return () => subscription.remove();
  • }, []);
  • }, [routed]);

    // "New bot" from the Command Center opens a fresh Bots screen; only that one consumes it.
    useEffect(() => {
    @@ -235,7 +266,7 @@
    )}
    {settings.status === "invalid" ? (

  •        <SettingsAction label="Reset bots" hint="Replaces the unreadable bot list with an empty one." actionLabel="Reset" onPress={() => void settings.reset()} />
    
  •        <SettingsAction label="Reset bots" hint="Replaces the unreadable bot list with an empty one." actionLabel="Reset" onPress={() => void confirmDialog({ title: "Reset bot settings?", message: "This replaces all saved bot definitions, teams and preferences on this host with empty settings. Existing chats and memory files stay on the host.", confirmLabel: "Reset settings", destructive: true }).then((confirmed) => confirmed && settings.reset())} />
         </SettingsCard>
       ) : null}
     </View>
    

@@ -252,7 +283,7 @@
setDragWidths({});
updateUi((current) => ({ ...current, [key]: Math.round(width) }));
};

  • const allBots = settings.values.bots.map((bot) => drafts[bot.id] ?? bot);
  • const allBots = settings.values.bots.map((bot) => drafts[bot.id] ? mergeBotEdit(bot, drafts[bot.id]!) : bot);
    const library = settings.values.library ?? EMPTY_LIBRARY;
    const groups = settings.values.groups ?? [];
    const listed = allBots
    @@ -266,17 +297,28 @@
    // ------------------------------------------------------------ actions

    /** Opens a chat, showing its bot in the list: expanded, and its team's tab open. */

  • const select = (next: Selection) => {
  • setSelection(next);
  • setTeamMap(false);
  • const select = (next: Selection, nextPanel = panel) => {
  • const bot = allBots.find((entry) => entry.id === next.botId);
    const tab = openTab && tabOf(next.botId, groups) !== openTab.id ? tabOf(next.botId, groups) : null;
    if (tab || currentUi().collapsed.includes(next.botId)) {
    updateUi((current) => ({ ...current, tab: tab ?? current.tab, collapsed: current.collapsed.filter((id) => id !== next.botId) }));
    }
  • if (openScreen) {
  •  void flush();
    
  •  openScreen(chatScreen(next, bot?.name || "Chat", layout.compact ? undefined : nextPanel));
    
  •  return;
    
  • }
  • setSelection(next);
  • setTeamMap(false);
    };

const openPanel = (bot: Bot, section: SectionId | null) => {

  • if (selection?.botId !== bot.id) select({ botId: bot.id, chatId: null });
  • if (routed) {
  •  void flush();
    
  •  openScreen!({ screenId: section ? "bot-section" : "bot-settings", params: { botId: bot.id, section: section ?? "", title: section ? botSectionTitle(section)! : `${bot.name} settings` } });
    
  •  return;
    
  • }
  • if (selection?.botId !== bot.id) select({ botId: bot.id, chatId: null }, { open: true, section });
    setPanel({ open: true, section });
    };

@@ -284,8 +326,11 @@
const addBot = async (bot: Bot, section: SectionId = "identity") => {
const saved = await commit((values) => ({ ...values, bots: [...values.bots, bot] }));
if (saved) {

  •  select({ botId: bot.id, chatId: null });
    
  •  setPanel({ open: true, section });
    
  •  if (routed) openPanel(bot, section);
    
  •  else {
    
  •    select({ botId: bot.id, chatId: null }, { open: true, section });
    
  •    setPanel({ open: true, section });
    
  •  }
    
    }
    };

@@ -316,6 +361,7 @@
...values,
bots: values.bots.filter((entry) => entry.id !== bot.id),
history: values.history.filter((entry) => entry.botId !== bot.id),

  •  bookmarks: values.bookmarks?.filter((entry) => entry.botId !== bot.id),
     groups: withoutBot(values.groups ?? [], bot.id, new Date().toISOString()),
    
    }));
    if (!ok) return;
    @@ -468,7 +514,7 @@
    }
    try {
    await botHost.api.agents.ref(chat.id).archive();
  •        if (selection?.chatId === chat.id) setSelection({ botId: bot.id, chatId: null });
    
  •        if (selection?.chatId === chat.id && selectionRef.current === selectionKey) setSelection({ botId: bot.id, chatId: null });
           if (context.pinned) updateUi(unpin);
           await queryClient.invalidateQueries({ queryKey: ["paseo-bots", "chats", botHost.key, bot.id] });
         } catch (error) {
    

@@ -484,7 +530,7 @@
anchor,
align: "end",
width: 232,

  •  title: "Display",
    
  •  title: "Bots",
     entries: [
       {
         label: "Archived bots",
    

@@ -496,6 +542,7 @@
trailing: listUi.chatSort === "manual" ? "Manual" : "Last activity",
onSelect: () => updateUi((current) => ({ ...current, chatSort: current.chatSort === "manual" ? "activity" : "manual" })),
},

  •    ...(openScreen ? [{ kind: "separator" as const }, { label: "Manage routines", icon: "Clock", onSelect: () => openScreen({ screenId: "bot-routines" }) }] : []),
     ],
    
    });
    };
    @@ -515,7 +562,7 @@
    selection={selection}
    ui={listUi}
    localHost={localHost}
  •  touch={layout.compact || layout.platform !== "web"}
    
  •  touch={isTouchLayout(layout, hasTouchScreen())}
     splash={layout.compact}
     bottomInset={bottomInset}
     onToggle={(botId) =>
    

@@ -532,7 +579,7 @@
onChatMenu={openChatMenu}
onDisplayMenu={openDisplayMenu}
onEditTeam={setEditingTeam}

  •  onTeamMap={() => setTeamMap(true)}
    
  •  onTeamMap={() => routed ? openScreen!(teamMapScreen()) : setTeamMap(true)}
    
    />
    );

@@ -540,6 +587,36 @@
? { colors, tabs, openTab, onTab: (tab: string) => updateUi((current) => ({ ...current, tab })), onTeamMenu: openTeamMenu, onNewTeam: () => setEditingTeam("new" as const) }
: null;

  • const selectedChat = () => selectedBot && selection ? (
  • <SelectedChat
  •  key={`${selectedBot.hostId ?? host.id}:${selectedBot.id}:${selection.chatId ?? "new"}`}
    
  •  colors={colors}
    
  •  bot={selectedBot}
    
  •  library={library}
    
  •  selection={selection}
    
  •  selectionIdentity={selectionKey}
    
  •  localHost={localHost}
    
  •  panelOpen={panel.open}
    
  •  hostHeader={routed}
    
  •  layout={layout}
    
  •  keyboardOpen={keyboardHeight > 0}
    
  •  typeVersion={typeVersion}
    
  •  onBack={layout.compact && !routed ? () => setSelection(null) : undefined}
    
  •  onBotMenu={(anchor) => (anchor ? openBotMenu(selectedBot, anchor, "kebab") : openBotMenuFromPane(selectedBot))}
    
  •  onTogglePanel={() => routed ? openPanel(selectedBot, null) : setPanel({ open: !panel.open, section: panel.section })}
    
  •  onStarted={(chatId) => {
    
  •    rememberStartedChat(host.id, params.draftId, chatId);
    
  •    // Finish the originating draft without interrupting a different conversation.
    
  •    if (selectionRef.current !== selectionKey) return;
    
  •    const next = { botId: selectedBot.id, chatId };
    
  •    if (surfaceVisibility.isVisible()) select(next);
    
  •    else setSelection(next);
    
  •  }}
    
  •  onOpenChat={(chatId) => select({ botId: selectedBot.id, chatId })}
    
  •  onOpenBotChat={(botId, chatId) => select({ botId, chatId })}
    
  • />
  • ) : null;
  • const pane = teamMap ? (
    <TeamMap
    colors={colors}
    @@ -547,32 +624,20 @@
    bots={allBots}
    localHost={localHost}
    compact={layout.compact}
  •  hostHeader={routed}
     bottomInset={bottomInset}
     onBack={layout.compact ? () => setTeamMap(false) : undefined}
     onNewTeam={() => setEditingTeam("new")}
    
  •  onTeamFile={() => { void flush().then(() => setTeamFile(true)); }}
     onEditTeam={setEditingTeam}
     onOpenBot={(bot) => {
    
  •    select({ botId: bot.id, chatId: null });
    
  •    if (routed) return openPanel(bot, "overview");
    
  •    select({ botId: bot.id, chatId: null }, { open: true, section: "overview" });
       setPanel({ open: true, section: "overview" });
     }}
    
    />
    ) : selectedBot && selection ? (
  •  <SelectedChat
    
  •    key={`${selectedBot.id}:${selection.chatId ?? "new"}`}
    
  •    colors={colors}
    
  •    bot={selectedBot}
    
  •    library={library}
    
  •    selection={selection}
    
  •    localHost={localHost}
    
  •    panelOpen={panel.open}
    
  •    layout={layout}
    
  •    keyboardOpen={keyboardHeight > 0}
    
  •    typeVersion={typeVersion}
    
  •    onBack={layout.compact ? () => setSelection(null) : undefined}
    
  •    onBotMenu={(anchor) => (anchor ? openBotMenu(selectedBot, anchor, "kebab") : openBotMenuFromPane(selectedBot))}
    
  •    onTogglePanel={() => setPanel({ open: !panel.open, section: panel.section })}
    
  •    onStarted={(chatId) => setSelection({ botId: selectedBot.id, chatId })}
    
  •  />
    
  • selectedChat()
    ) : (

    );
    @@ -583,6 +648,7 @@
    key={${selectedBot.id}:${panelVersion}}

</details>

@github-actions github-actions Bot added the bump Pinned artifact update label Nov 17, 2026

@paseo-bot paseo-bot Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bots 0.3.1 is approved and merging, @oliexe. Nothing is needed from you.

The update ships its own OVERVIEW.md, so this PR removes the registry copy and the listing now shows yours. I made no other edits.

Advice for the next release: the old registry overview told readers that testing a stdio MCP server starts it as a process on the host with the daemon's environment, and that Import config reads the MCP lists from Claude Code, Claude Desktop and Cursor, which can contain secrets. Your overview does not say either. Adding two sentences under "Data and permissions" would keep that information on the listing page. Format notes: https://paseo.sh/docs/plugins/publishing#your-listing-page

Review data
  • Artifact: npm @oliexe/paseo-bots@0.3.1 (latest dist-tag). Downloaded tarball SHA-512 matches artifact.integrity and the npm registry value. No absolute or .. paths in the archive.
  • Compared against 0.2.0 file by file (about 90 files changed). Nothing was installed, built or run.
  • Install: npm-shrinkwrap.json fixes 471 packages, all from registry.npmjs.org with integrity. The only install-script package is dev-only fsevents. The package has no lifecycle scripts of its own, and the production dependencies are @getpaseo/client and @modelcontextprotocol/sdk.
  • Network: Composio (backend.composio.dev, dashboard.composio.dev) for connected apps. The new browser sign-in replaces the pasted project key and sends no redirects. GitHub (api.github.com, raw.githubusercontent.com) for skill import. MCP servers you configure. The OpenAI avatar generation and its key storage were removed.
  • New MCP OAuth (server/mcp-oauth*.ts): discovery and token requests use a pinned-DNS client that refuses private and reserved addresses (other than the MCP host you configured), requires HTTPS, S256 PKCE and a matching issuer, and does not follow redirects. Tokens are kept in mcp-oauth.json (mode 0600) in the plugin data folder. Agents get only a scoped local bearer token for a loopback proxy bound to 127.0.0.1, and the proxy checks that the bot still has access before forwarding. Tokens are removed when the server is removed or its URL or headers change.
  • Execution: execFile("paseo", ["daemon","status","--json","--home",…]) with a fixed argument list, used to reach the local daemon for scheduled routines. spawn for the stdio MCP test that you start, as in 0.2.0, now run in its own process group and killed on timeout. No eval or dynamic code.
  • Filesystem: writes and deletes stay in the plugin data folder (symlinks refused for reads and imports). The legacy .bots/<id> migration validates the bot ID first.
  • Listing: six PNG screenshots resolve with image/png. The manifest has a description. REVIEW.md blob 3c5e763.
  • Validation: node scripts/validate.ts --online --changed --base origin/main passed; the PR's Validate check passed on this head.
  • Not inspected: client UI components were skimmed for DOM injection (one innerHTML with fixed labels); the plugin was not run.

@paseo-bot
paseo-bot Bot merged commit 149ea8d into main Nov 17, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bump Pinned artifact update

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants