paseo-terminal-integration 0.2.0 → 0.4.0

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,11 @@ 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/sdk-compat.ts

@@ -0,0 +1,34 @@
+// COMPAT(inlineCodeBlockActions): copies of the inline code-action SDK types until a published
+// @getpaseo/plugin exports them; remove after 2027-04-01.
+import type { ComponentType } from "react";
+import type { PluginCleanup } from "@getpaseo/plugin";
+import type { PluginClientContext, PluginSurfaceProps } from "@getpaseo/plugin/client";
+
+type HostNavigation = NonNullable<PluginSurfaceProps["navigation"]>;
+
+export interface PluginCodeBlockActionsProps extends Omit<PluginSurfaceProps, "navigation"> {
+  readonly navigation?: HostNavigation & {
+    readonly openTerminal?: (input: {
+      readonly workspaceId: string;
+      readonly terminalId: string;
+      readonly serverId?: string;
+    }) => void;
+  };
+  agentId: string;
+  messageId: string;
+  blockIndex: number;
+  code: string;
+  language: string;
+  phase: "streaming" | "complete";
+}
+
+export interface PluginCodeBlockActionsContribution {
+  id: string;
+  languages: readonly string[];
+  Component: ComponentType<PluginCodeBlockActionsProps>;
+}
+
+/** Older clients lack addCodeBlockActions; check for it before calling. */
+export type InlineActionsClient = PluginClientContext & {
+  addCodeBlockActions?: (contribution: PluginCodeBlockActionsContribution) => PluginCleanup;
+};

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);
@@ -25,27 +20,19 @@ export function SettingsScreen({ theme }: PluginSurfaceProps) {
   const { values, revision } = settings;
 
   return (
-    <SettingsSection title="Run cards">
+    <SettingsSection title="Code block actions">
       <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 code block.`}
           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. Choose Main panel or On the side in Settings → Layout → Open location → Terminals. Manually moved tabs keep their location.`}
         />
       </SettingsCard>
     </SettingsSection>

package/index.client.tsx

@@ -1,99 +1,35 @@
-import type { PluginClientContext } from "@getpaseo/plugin/client";
-import { setPanelOpener } from "./client/panel-opener";
-import { RunCard } from "./client/run-card";
+import { z } from "zod";
+import { contributeLegacy } from "./client/legacy";
+import type { PluginCleanup } from "@getpaseo/plugin";
+import type { InlineActionsClient } from "./client/sdk-compat";
+import { CodeBlockActions } from "./client/code-block-actions";
 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));
-
-  client.addTimelineRenderer({
-    kind: RUN_CARD_KIND,
-    version: RUN_CARD_VERSION,
-    schema: runCardSchema,
-    Component: RunCard,
-  });
-
-  client.addWorkspacePanel({
-    id: TERMINAL_PANEL_ID,
-    title: TERMINAL_NAME,
-    icon: "SquareTerminal",
-    context: "workspace",
-    locations: ["explorer", "workspace"],
-    Component: TerminalPanel,
-  });
-
+import { RUNNABLE_LANGUAGES } from "./shared/code-blocks";
+import { terminalOutputSource } from "./shared/contracts";
+
+export default function contribute(client: InlineActionsClient): PluginCleanup {
+  if (typeof client.addCodeBlockActions === "function") {
+    client.addCodeBlockActions({
+      id: "run",
+      languages: RUNNABLE_LANGUAGES,
+      Component: CodeBlockActions,
+    });
+    // COMPAT(legacyRunCards): added in the inline-actions fork, remove after 2027-04-01.
+    client.addTimelineRenderer({
+      kind: "terminal-run-card",
+      version: 1,
+      schema: z.unknown(),
+      Component: () => null,
+    });
+  } else {
+    contributeLegacy(client);
+  }
   client.addSettingsScreen({
     id: "preferences",
     title: "Terminal integration",
     icon: "SquareTerminal",
     Component: SettingsScreen,
   });
-
   client.addAttachmentSource(terminalOutputSource);
-
-  client.addSlashCommand({
-    name: "run",
-    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 }) {
-      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.
-      }
-    },
-  });
-
-  async function addRunButtons(agentId: string, rpc: PluginClientContext["rpc"]) {
-    const { count } = await rpc(scanBlocks, { agentId });
-    if (count === 0) throw new Error("The latest reply has no runnable code blocks");
-  }
-
-  client.addSlashCommand({
-    name: "blocks",
-    description: "Add terminal run buttons for code blocks in the agent's latest reply",
-    argumentHint: "",
-    context: "agent",
-    onSubmit: ({ agent, rpc }) => addRunButtons(agent.id, rpc),
-  });
-
-  client.addCommandCenterItem({
-    id: "scan-latest-reply",
-    title: "Terminal: add run buttons to the latest reply",
-    icon: "SquareTerminal",
-    keywords: ["run", "code block", "terminal", "execute"],
-    context: "agent",
-    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,10 @@ 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 {
+  enableLegacyCards,
   cancelRun,
-  closeTerminalView,
-  openTerminalView,
-  readTerminalView,
-  resizeTerminalView,
   runAdhoc,
   runKey,
   runStatus,
@@ -20,13 +16,20 @@ 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));
 
-  server.on("agent.turn_ended", (event, { paseo }) => appendCardForTurn(paseo, event));
+  // COMPAT(legacyRunCards): only old clients opt into scanning; remove after 2027-04-01.
+  let legacyCardsRequested = false;
+  server.handle(enableLegacyCards, async () => {
+    legacyCardsRequested = true;
+    return { enabled: true };
+  });
+  server.on("agent.turn_ended", (event, { paseo }) => {
+    if (legacyCardsRequested) return appendCardForTurn(paseo, event);
+  });
 
   server.handle(startRun, (input, { paseo }) => runnerFor(paseo).start(input));
   server.handle(runStatus, ({ keys }, { paseo }) => ({ runs: runnerFor(paseo).status(keys) }));
@@ -37,9 +40,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 +56,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,48 +1,49 @@
 {
   "name": "paseo-terminal-integration",
-  "version": "0.2.0",
+  "version": "0.4.0",
+  "description": "Run agent code blocks in a Paseo terminal and send the output back to the agent; attach terminal output to prompts",
+  "keywords": [
+    "agents",
+    "paseo",
+    "paseo-plugin",
+    "terminal"
+  ],
+  "homepage": "https://github.com/keefeere/paseo-terminal-integration#readme",
+  "bugs": {
+    "url": "https://github.com/keefeere/paseo-terminal-integration/issues"
+  },
+  "license": "MIT",
+  "author": "Chechulin Serhii",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/keefeere/paseo-terminal-integration.git"
+  },
   "files": [
     "paseo-plugin.json",
     "index.client.tsx",
     "index.server.ts",
     "client/",
     "server/",
-    "shared/"
+    "shared/",
+    "!**/*.test.ts"
   ],
   "scripts": {
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "oxlint",
+    "format": "oxfmt ."
   },
   "devDependencies": {
-    "@getpaseo/plugin": "0.10.1",
+    "@getpaseo/plugin": "0.10.2",
     "@tanstack/react-query": "^5.90.11",
     "@types/node": "^26.6.2",
     "@types/react": "~19.2.0",
+    "oxfmt": "0.46.0",
+    "oxlint": "1.61.0",
     "react": "19.1.0",
     "react-native": "0.81.5",
     "typescript": "^5.9.3",
-    "zod": "^4.4.3"
-  },
-  "description": "Run agent code blocks in a Paseo terminal and send the output back to the agent; attach terminal output to prompts",
-  "license": "MIT",
-  "author": "Chechulin Serhii",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/keefeere/paseo-terminal-integration.git"
-  },
-  "homepage": "https://github.com/keefeere/paseo-terminal-integration#readme",
-  "bugs": {
-    "url": "https://github.com/keefeere/paseo-terminal-integration/issues"
-  },
-  "keywords": [
-    "paseo",
-    "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"
+    "vitest": "^4.1.7",
+    "zod": "4.4.3"
   }
 }

package/server/attachments.ts

@@ -32,7 +32,9 @@ export async function searchTerminals(
 
   const items = await Promise.all(
     matches.map(async (entry) => {
-      const capture = await paseo.terminals.ref(entry).capture({ start: -lineCount, stripAnsi: true });
+      const capture = await paseo.terminals
+        .ref(entry)
+        .capture({ start: -lineCount, stripAnsi: true });
       const lines = trimBlankEdges(withoutRunMarkers(capture.lines));
       const name = entry.name || "Terminal";
       const workspace = workspaceNames.get(entry.workspaceId);