paseo-terminal-integration 0.2.0 → 0.3.0

package/README.md

@@ -6,27 +6,26 @@ Two-way bridge between agent chats and Paseo terminals.
 (`bash`, `sh`, `shell`, `console`, `zsh`, `fish`, `python`, `js`/`node`) get a **Run in terminal**
 card under the reply:
 
-- **Run in side terminal** runs the block in the workspace terminal "Agent commands" and shows it in
-  the side panel; **Run silently** runs it without showing anything.
-- With **Send to agent** checked (the default), the command, exit code, and output go to the agent
-  as a new message when the block finishes. If the agent is busy, delivery waits until its turn
-  ends instead of interrupting it. Unchecked, **Send output** sends it later.
+- **Run** runs the block in the workspace terminal "Agent commands", a regular Paseo terminal tab.
+- **Run in background** runs it as a hidden process in the agent's working directory: no terminal
+  tab, and the card keeps the last 5,000 lines instead of what fits on a terminal screen. Nothing
+  can be typed into it: stdin is empty, so password and confirmation prompts fail instead of
+  waiting. Background runs do not wait for the terminal.
+- With **Send output to agent** checked (the default), the command, exit code, and output go to
+  the agent as a new message when the block finishes. If the agent is busy, delivery waits until
+  its turn ends instead of interrupting it. Unchecked, **Send output** sends it later.
 - **Stop** sends Ctrl-C; **Send output so far** reports a still-running command.
 
-**Terminal panel.** The side panel (Explorer) shows "Agent commands" as a full terminal: the same
-xterm.js renderer and live stream as Paseo's terminal tabs, with colors, the cursor, full-screen
-programs, and keyboard input. Click it and type to answer `sudo` passwords, `y/n` questions, or
-npm's "Press ENTER" without leaving the chat. Ctrl-C copies while text is selected and otherwise
-goes to the shell; Ctrl-Shift-C and Ctrl-Shift-V always copy and paste. Web links open in the
-browser when clicked. The card's **Terminal** button opens the panel without running anything. On
-phones the panel is a plain-text copy with an input line and Enter, Ctrl-C, Ctrl-D, and Tab keys,
-in a tab that opens only when you ask. **Settings → Plugins → Terminal integration** switches the
-panel to a workspace tab and sets the checkbox's default.
-
-Paseo gives every workspace terminal its own tab, so "Agent commands" also appears in the tab bar
-(in the background). Closing that tab ends the terminal; the next run starts a new one. Runs in
-one workspace are queued so a command never types into another one's stdin. Each block runs as a
-script in the agent's working directory, so `cd` and `export` do not persist between runs.
+**Terminal beside the chat.** "Agent commands" opens as a background tab. Drag the tab onto the
+right or bottom edge of the chat to split the workspace; it stays there while the terminal is open,
+so you can watch runs and type answers to `sudo` passwords or `y/n` questions next to the
+conversation. From the keyboard, split the pane and move the tab into it with the shortcuts in
+**Settings → Shortcuts → Tabs & panes**. Closing the tab ends the terminal; the next run starts a
+new one in a new tab.
+
+Terminal runs in one workspace are queued so a command never types into another one's stdin.
+Each block runs as a script in the agent's working directory, so `cd` and `export` do not persist
+between runs. **Settings → Plugins → Terminal integration** sets the checkbox's default.
 
 **Terminal → agent.** In the composer's attachment menu, **Terminal output** attaches the latest
 lines of any terminal on the daemon. Type part of a name or path to filter, and a number to choose
@@ -39,10 +38,10 @@ Requires Paseo 0.10.1 or later and a macOS or Linux daemon host with `bash` (plu
 
 ```bash
 paseo plugin install npm:paseo-terminal-integration
+# or from GitHub
+paseo plugin install github:keefeere/paseo-terminal-integration
 ```
 
-Install from npm: GitHub installs skip npm dependencies, which the terminal panel needs.
-
 Plugins are trusted, unsandboxed code: this one types commands into terminals on the daemon host.
 Nothing runs until you press a button or submit `/run`.
 
@@ -53,17 +52,13 @@ Nothing runs until you press a button or submit `/run`.
 | `/run <command>`                                | Run a shell command and send its output to the agent        |
 | `/blocks`                                       | Add a run card for the latest reply (e.g. older chats)      |
 | ⌘K / Ctrl+K → "Terminal: add run buttons to …"  | Same as `/blocks`                                           |
-| ⌘K / Ctrl+K → "Terminal: show … in the side panel" | Open the terminal panel in the Explorer                  |
 
 ## Limitations
 
-- Output is read from the terminal screen, so very long lines arrive wrapped and only the last
+- Terminal output is read from the screen, so very long lines arrive wrapped and only the last
   3,000 rows are visible. The agent receives at most 300 lines or 24,000 characters.
 - Run state lives in the plugin process; reloading the plugin forgets it (the cards stay).
-- The live panel opens its own connection to the daemon on the plugin host, using the address in
-  `$PASEO_HOME/paseo.pid` and the local credential, as the `paseo` CLI does. A daemon listening on
-  a Unix socket gets the plain-text panel instead.
-- Opening or resizing the panel resizes the PTY to fit it, as focusing a terminal tab does.
+- Plugins cannot split panes or move tabs, so placing the terminal beside the chat is up to you.
 - A command that has not started within 20 seconds fails, for example when something else is
   running in "Agent commands".
 
@@ -77,6 +72,14 @@ paseo plugin reload terminal-integration
 paseo plugin logs terminal-integration
 ```
 
+To release, bump the version and push the tag; GitHub Actions publishes it to npm through trusted
+publishing, and Paseo Cafe picks up the new version from there:
+
+```bash
+npm version patch   # or minor; commits and tags vX.Y.Z
+git push --follow-tags
+```
+
 ## License
 
 MIT

package/client/run-card.tsx

@@ -1,4 +1,4 @@
-import { useAgent, useRpc, useSettings, type PluginTimelineItemProps } from "@getpaseo/plugin/client";
+import { useRpc, useSettings, type PluginTimelineItemProps } from "@getpaseo/plugin/client";
 import { copyText, Icon, useToast } from "@getpaseo/plugin/client/react-native";
 import { useQuery, useQueryClient } from "@tanstack/react-query";
 import { useMemo, useState } from "react";
@@ -11,10 +11,10 @@ import {
   startRun,
   TERMINAL_NAME,
   type RunCardData,
+  type RunMode,
   type RunSnapshot,
 } from "../shared/contracts";
 import { preferences } from "../shared/settings";
-import { openTerminalPanel } from "./panel-opener";
 
 type Theme = PluginTimelineItemProps["theme"];
 type Styles = ReturnType<typeof createStyles>;
@@ -44,24 +44,15 @@ export function RunCard({ item, agentId, theme, layout }: PluginTimelineItemProp
   const cancel = useRpc(cancelRun);
   const send = useRpc(sendRunOutput);
 
-  const workspaceId = useAgent(agentId, (agent) => agent.workspaceId);
   const settings = useSettings(preferences);
-  const saved = settings.status === "ready" ? settings.values : null;
-  const panelLocation = saved?.panelLocation ?? "explorer";
   const [sendChoice, setSendChoice] = useState<boolean | null>(null);
-  const sendToAgent = sendChoice ?? saved?.sendToAgent ?? true;
-  const runVisibleLabel =
-    layout.compact || panelLocation === "workspace" ? "Run in terminal tab" : "Run in side terminal";
+  const sendToAgent =
+    sendChoice ?? (settings.status === "ready" ? settings.values.sendToAgent : true);
 
-  function showTerminal() {
-    if (!workspaceId) return;
-    openTerminalPanel(workspaceId, panelLocation, { compact: layout.compact, explicit: true });
-  }
-  function runBlock(key: string, block: RunCardData["blocks"][number], visible: boolean) {
-    return act(key, async () => {
-      await start({ agentId, key, lang: block.lang, code: block.code, send: sendToAgent });
-      if (visible) showTerminal();
-    });
+  function runBlock(key: string, block: RunCardData["blocks"][number], mode: RunMode) {
+    return act(key, () =>
+      start({ agentId, key, lang: block.lang, code: block.code, send: sendToAgent, mode }),
+    );
   }
 
   const queryKey = useMemo(() => ["terminal-run-status", cardId], [cardId]);
@@ -99,19 +90,10 @@ export function RunCard({ item, agentId, theme, layout }: PluginTimelineItemProp
         <Checkbox
           styles={styles}
           theme={theme}
-          label="Send to agent"
+          label="Send output to agent"
           checked={sendToAgent}
           onChange={setSendChoice}
         />
-        {workspaceId ? (
-          <ActionButton
-            styles={styles}
-            theme={theme}
-            icon="PanelRight"
-            label="Terminal"
-            onPress={showTerminal}
-          />
-        ) : null}
       </View>
       {blocks.map((block, index) => {
         const key = keys[index];
@@ -154,19 +136,19 @@ export function RunCard({ item, agentId, theme, layout }: PluginTimelineItemProp
                   <ActionButton
                     styles={styles}
                     theme={theme}
-                    icon="PanelRight"
-                    label={runVisibleLabel}
+                    icon="Play"
+                    label="Run"
                     tone="primary"
                     disabled={busy || active}
-                    onPress={() => runBlock(key, block, true)}
+                    onPress={() => runBlock(key, block, "terminal")}
                   />
                   <ActionButton
                     styles={styles}
                     theme={theme}
-                    icon="Play"
-                    label="Run silently"
+                    icon="EyeOff"
+                    label="Run in background"
                     disabled={busy || active}
-                    onPress={() => runBlock(key, block, false)}
+                    onPress={() => runBlock(key, block, "background")}
                   />
                   {run && !run.sent && !active ? (
                     <ActionButton
@@ -205,7 +187,9 @@ function RunStatus({ run, styles }: { run: RunSnapshot; styles: Styles }) {
   const parts: string[] = [];
   let tone: TextStyle = styles.muted;
   if (run.status === "queued") parts.push("Queued, waiting for the terminal");
-  if (run.status === "running") parts.push(`Running · ${elapsed(run)}`);
+  if (run.status === "running") {
+    parts.push(`${run.mode === "background" ? "Running in background" : "Running"} · ${elapsed(run)}`);
+  }
   if (run.status === "done") {
     parts.push(`${run.exitCode === 0 ? "✓" : "✗"} exit ${run.exitCode}`);
     tone = run.exitCode === 0 ? styles.success : styles.danger;

package/client/settings-screen.tsx

@@ -3,16 +3,11 @@ import {
   SettingsCard,
   SettingsRow,
   SettingsSection,
-  SettingsSelect,
   SettingsSwitch,
 } from "@getpaseo/plugin/client/ui";
 import { Text } from "react-native";
-import { preferences, type PanelLocation } from "../shared/settings";
-
-const panelLocationChoices: { label: string; value: PanelLocation }[] = [
-  { label: "Side panel (Explorer)", value: "explorer" },
-  { label: "Workspace tab", value: "workspace" },
-];
+import { TERMINAL_NAME } from "../shared/contracts";
+import { preferences } from "../shared/settings";
 
 export function SettingsScreen({ theme }: PluginSurfaceProps) {
   const settings = useSettings(preferences);
@@ -27,25 +22,17 @@ export function SettingsScreen({ theme }: PluginSurfaceProps) {
   return (
     <SettingsSection title="Run cards">
       <SettingsCard>
-        <SettingsSelect
-          label="Show the terminal in"
-          hint={`Used by "Run in side terminal", the Terminal button, and /run. Phones always use a tab and never switch to it automatically.`}
-          value={values.panelLocation}
-          options={panelLocationChoices}
-          disabled={settings.saving}
-          error={settings.saveError}
-          onValueChange={(panelLocation) => void settings.save({ ...values, panelLocation }, revision)}
-        />
         <SettingsSwitch
           label="Send output to the agent by default"
-          hint={`Initial state of the "Send to agent" checkbox on each run card.`}
+          hint={`Initial state of the "Send output to agent" checkbox on each run card.`}
           value={values.sendToAgent}
           disabled={settings.saving}
+          error={settings.saveError}
           onValueChange={(sendToAgent) => void settings.save({ ...values, sendToAgent }, revision)}
         />
         <SettingsRow
-          label="What the panel shows"
-          hint={`The live "Agent commands" terminal with colors and keyboard input, for prompts such as sudo passwords, y/n questions, or 2FA codes. Ctrl-C copies while text is selected; Ctrl-Shift-C and Ctrl-Shift-V copy and paste. Phones show a plain-text copy with an input line.`}
+          label="Where the terminal appears"
+          hint={`Commands run in the "${TERMINAL_NAME}" terminal tab. To keep it beside the chat, drag the tab onto the right or bottom edge of the chat; it stays there while the terminal is open.`}
         />
       </SettingsCard>
     </SettingsSection>

package/index.client.tsx

@@ -1,22 +1,18 @@
+import type { PluginCleanup } from "@getpaseo/plugin";
 import type { PluginClientContext } from "@getpaseo/plugin/client";
-import { setPanelOpener } from "./client/panel-opener";
 import { RunCard } from "./client/run-card";
 import { SettingsScreen } from "./client/settings-screen";
-import { TerminalPanel } from "./client/terminal-panel";
 import {
   RUN_CARD_KIND,
   RUN_CARD_VERSION,
   runAdhoc,
   runCardSchema,
   scanBlocks,
-  TERMINAL_NAME,
   terminalOutputSource,
 } from "./shared/contracts";
-import { TERMINAL_PANEL_ID } from "./shared/settings";
-
-export default function contribute(client: PluginClientContext) {
-  setPanelOpener((id, options) => client.openPanel(id, options));
 
+// A function declaration: the host reads the default export before the module body has run.
+export default function contribute(client: PluginClientContext): PluginCleanup {
   client.addTimelineRenderer({
     kind: RUN_CARD_KIND,
     version: RUN_CARD_VERSION,
@@ -24,15 +20,6 @@ export default function contribute(client: PluginClientContext) {
     Component: RunCard,
   });
 
-  client.addWorkspacePanel({
-    id: TERMINAL_PANEL_ID,
-    title: TERMINAL_NAME,
-    icon: "SquareTerminal",
-    context: "workspace",
-    locations: ["explorer", "workspace"],
-    Component: TerminalPanel,
-  });
-
   client.addSettingsScreen({
     id: "preferences",
     title: "Terminal integration",
@@ -47,14 +34,9 @@ export default function contribute(client: PluginClientContext) {
     description: "Run a shell command in the workspace terminal and send its output to the agent",
     argumentHint: "<command>",
     context: "agent",
-    async onSubmit({ args, agent, rpc, openPanel }) {
+    async onSubmit({ args, agent, rpc }) {
       if (!args) throw new Error("Usage: /run <command>");
-      const { panelLocation } = await rpc(runAdhoc, { agentId: agent.id, command: args });
-      try {
-        openPanel(TERMINAL_PANEL_ID, { location: panelLocation });
-      } catch {
-        // Compact layouts have no Explorer; the card's Terminal button still opens a tab.
-      }
+      await rpc(runAdhoc, { agentId: agent.id, command: args });
     },
   });
 
@@ -80,20 +62,5 @@ export default function contribute(client: PluginClientContext) {
     onSelect: ({ agent, rpc }) => addRunButtons(agent.id, rpc),
   });
 
-  client.addCommandCenterItem({
-    id: "open-terminal-panel",
-    title: `Terminal: show "${TERMINAL_NAME}" in the side panel`,
-    icon: "PanelRight",
-    keywords: ["terminal", "explorer", "sidebar", "agent commands"],
-    context: "workspace",
-    onSelect({ openPanel }) {
-      try {
-        openPanel(TERMINAL_PANEL_ID, { location: "explorer" });
-      } catch {
-        openPanel(TERMINAL_PANEL_ID, { location: "workspace" });
-      }
-    },
-  });
-
-  return () => setPanelOpener(null);
+  return () => {};
 }

package/index.server.ts

@@ -2,14 +2,9 @@ import type { PluginServerContext } from "@getpaseo/plugin/server";
 import { searchTerminals } from "./server/attachments";
 import { appendCardForTurn, appendRunCard, scanLatestReply } from "./server/cards";
 import { cleanupScripts, TerminalRunner } from "./server/runner";
-import { TerminalStreams } from "./server/streams";
 import { preferences } from "./shared/settings";
 import {
   cancelRun,
-  closeTerminalView,
-  openTerminalView,
-  readTerminalView,
-  resizeTerminalView,
   runAdhoc,
   runKey,
   runStatus,
@@ -20,9 +15,8 @@ import {
 } from "./shared/contracts";
 
 export default function contribute(server: PluginServerContext) {
-  const settings = server.registerSettings(preferences);
+  server.registerSettings(preferences);
   let runner: TerminalRunner | null = null;
-  const streams = new TerminalStreams();
   const runnerFor = (paseo: ConstructorParameters<typeof TerminalRunner>[0]) =>
     (runner ??= new TerminalRunner(paseo));
 
@@ -37,9 +31,14 @@ export default function contribute(server: PluginServerContext) {
     const block = { lang: "bash", code: command };
     const cardId = await appendRunCard(paseo, agentId, [block]);
     if (!cardId) throw new Error("Command is too long");
-    await runnerFor(paseo).start({ agentId, key: runKey(cardId, 0), ...block, send: true });
-    const saved = await settings.read();
-    return { cardId, panelLocation: saved.status === "ready" ? saved.values.panelLocation : "explorer" };
+    await runnerFor(paseo).start({
+      agentId,
+      key: runKey(cardId, 0),
+      ...block,
+      send: true,
+      mode: "terminal",
+    });
+    return { cardId };
   });
 
   server.handle(scanBlocks, async ({ agentId }, { paseo }) => ({
@@ -48,14 +47,8 @@ export default function contribute(server: PluginServerContext) {
 
   server.handle(searchTerminalOutput, searchTerminals);
 
-  server.handle(openTerminalView, (input) => streams.open(input));
-  server.handle(readTerminalView, (input) => streams.read(input));
-  server.handle(resizeTerminalView, (input) => streams.resize(input));
-  server.handle(closeTerminalView, (input) => streams.close(input));
-
   return async () => {
     runner?.stop();
-    await streams.stop();
     await cleanupScripts();
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paseo-terminal-integration",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "files": [
     "paseo-plugin.json",
     "index.client.tsx",
@@ -38,11 +38,5 @@
     "paseo-plugin",
     "terminal",
     "agents"
-  ],
-  "dependencies": {
-    "@getpaseo/client": "0.10.1",
-    "@xterm/addon-fit": "^0.11.0",
-    "@xterm/addon-web-links": "^0.12.0",
-    "@xterm/xterm": "^6.0.0"
-  }
+  ]
 }