pcode 0.1.2__tar.gz → 0.1.4__tar.gz

{pcode-0.1.2 → pcode-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: pcode
-Version: 0.1.2
+Version: 0.1.4
 Summary: Terminal-native AI coding agent with background jobs, parallel worktrees, forkable sessions, and multi-model support
 Project-URL: Homepage, https://github.com/cruxwell/pcode
 Project-URL: Documentation, https://cruxwell.github.io/pcode/
@@ -16,18 +16,17 @@ Classifier: Intended Audience :: Developers
 Classifier: Operating System :: MacOS
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Topic :: Software Development
-Requires-Python: >=3.11
+Requires-Python: >=3.14
 Requires-Dist: filelock<5,>=4
 Requires-Dist: genai-prices<0.2,>=0.1.7
 Requires-Dist: httpx2<3,>=2.13.1
 Requires-Dist: prompt-toolkit==3.0.53
 Requires-Dist: psutil<8,>=6
-Requires-Dist: pydantic-ai-harness[codemode,coder,exa,playwright]<0.55,>=0.54.0
-Requires-Dist: pydantic-ai-slim[anthropic,bedrock,duckduckgo,google,groq,mcp,openai,web-fetch,xai]<3,>=2.54.0
+Requires-Dist: pydantic-ai-harness[codemode,coder,exa,playwright]<0.56,>=0.55.0
+Requires-Dist: pydantic-ai-slim[anthropic,bedrock,duckduckgo,google,groq,mcp,openai,web-fetch,xai]<3,>=2.55.0
 Requires-Dist: rich<16,>=15
 Requires-Dist: websockets<17,>=15.0.1
 Requires-Dist: yappi<2,>=1.7.6
@@ -35,9 +34,9 @@ Provides-Extra: claude
 Requires-Dist: claude-agent-sdk<0.3,>=0.2.164; extra == 'claude'
 Description-Content-Type: text/markdown
 
-<img width="1392" height="1522" alt="pcode in a dark terminal" src="docs/assets/screenshots/pcode-dark.png" />
+<img width="1392" height="1522" alt="pcode in a dark terminal" src="docs/assets/screenshots/tabs-dark.png" />
 
-<img width="1392" height="1522" alt="pcode in a light terminal" src="docs/assets/screenshots/pcode-light.png" />
+<img width="1392" height="1522" alt="pcode in a light terminal" src="docs/assets/screenshots/tabs-light.png" />
 
 # pcode
 
@@ -77,7 +76,7 @@ brew install cruxwell/pcode/pcode
 Or from [PyPI](https://pypi.org/project/pcode/) with [uv](https://docs.astral.sh/uv/):
 
 ```sh
-uv tool install 'pcode[claude]'
+uv tool install --python 3.14 'pcode[claude]'
 ```
 
 `brew install --HEAD` tracks `master` instead of the latest release.

{pcode-0.1.2 → pcode-0.1.4}/README.md

@@ -1,6 +1,6 @@
-<img width="1392" height="1522" alt="pcode in a dark terminal" src="docs/assets/screenshots/pcode-dark.png" />
+<img width="1392" height="1522" alt="pcode in a dark terminal" src="docs/assets/screenshots/tabs-dark.png" />
 
-<img width="1392" height="1522" alt="pcode in a light terminal" src="docs/assets/screenshots/pcode-light.png" />
+<img width="1392" height="1522" alt="pcode in a light terminal" src="docs/assets/screenshots/tabs-light.png" />
 
 # pcode
 
@@ -40,7 +40,7 @@ brew install cruxwell/pcode/pcode
 Or from [PyPI](https://pypi.org/project/pcode/) with [uv](https://docs.astral.sh/uv/):
 
 ```sh
-uv tool install 'pcode[claude]'
+uv tool install --python 3.14 'pcode[claude]'
 ```
 
 `brew install --HEAD` tracks `master` instead of the latest release.

{pcode-0.1.2 → pcode-0.1.4}/pyproject.toml

@@ -14,12 +14,11 @@ classifiers = [
     "Operating System :: MacOS",
     "Operating System :: POSIX :: Linux",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.11",
-    "Programming Language :: Python :: 3.12",
-    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
     "Topic :: Software Development",
 ]
-requires-python = ">=3.11"
+requires-python = ">=3.14"
 dependencies = [
     "filelock>=4,<5",
     "genai-prices>=0.1.7,<0.2",
@@ -34,11 +33,11 @@ dependencies = [
     # itself is downloaded on first use, not at install.
     # Harness ships from the pydantic-ai repo with every Pydantic AI release and
     # pins pydantic-ai-slim to the same minor; bump both together.
-    "pydantic-ai-harness[exa,coder,codemode,playwright]>=0.54.0,<0.55",
+    "pydantic-ai-harness[exa,coder,codemode,playwright]>=0.55.0,<0.56",
     # duckduckgo and web-fetch back the bundled web_research extension when no
     # provider-native search or Exa key is available.
     # google covers both google and google-cloud providers; bedrock pulls boto3.
-    "pydantic-ai-slim[anthropic,bedrock,duckduckgo,google,groq,mcp,openai,web-fetch,xai]>=2.54.0,<3",
+    "pydantic-ai-slim[anthropic,bedrock,duckduckgo,google,groq,mcp,openai,web-fetch,xai]>=2.55.0,<3",
     "rich>=15,<16",
     # FastMCP 4.x OAuth callback server selects Uvicorn's websockets-sansio protocol.
     # Capped below 17 by google-genai (still <17 as of 2.29), not by pcode.

{pcode-0.1.2 → pcode-0.1.4}/src/pcode/agent.py

@@ -32,6 +32,7 @@ from pydantic_ai_harness.subagents import ModelOption, SubAgent
 from pydantic_ai_harness.tool_output_limits import ToolOutputLimits
 
 from pcode import remote_profile
+from pcode.background_delegation import BackgroundDelegation
 from pcode.cache_settings import ProviderCacheSettings, model_settings
 from pcode.cache_warnings import CacheBustReporting
 from pcode.claude_sdk import ClaudeWorkspace
@@ -359,8 +360,10 @@ def create_coder(
     """
     workspace = workspace.resolve()
     _ensure_bundled_rg()
-    # Delegation is pcode's own `WorkspaceSubAgents`, added below.
-    coder = Coder(sub_agents=False)
+    # Delegation is pcode's own `WorkspaceSubAgents`, added below. Caching is
+    # `ProviderCacheSettings`' per-provider choice: Coder's default `cache=True`
+    # would also reach Meridian and OpenAI's explicit-breakpoint models.
+    coder = Coder(sub_agents=False, caching=False)
     output_limits = create_tool_output_limits()
     # Keep Coder's tool selection, including its persistent shell (as a
     # `JobShell`). File display and repository discovery remain local adapters;
@@ -402,6 +405,8 @@ def create_coder(
     capabilities.append(
         _delegation(workspace, worker, subagents, extensions, output_limits, cache_notices)
     )
+    # Steering mid-delegation reaches the parent; the child keeps working.
+    capabilities.append(BackgroundDelegation())
     # Summarize evidence before discarding it; pcode owns compaction.
     return CombinedCapability([c for c in capabilities if not isinstance(c, ClearToolResults)])
 

{pcode-0.1.2 → pcode-0.1.4}/src/pcode/anthropic_oauth.py

@@ -403,7 +403,7 @@ async def _receive_code(port: int, state: str, timeout: float) -> str:
                 + body
             )
             await writer.drain()
-        except (OSError, asyncio.TimeoutError, UnicodeError):
+        except OSError, asyncio.TimeoutError, UnicodeError:
             code = ""
         finally:
             writer.close()

{pcode-0.1.2 → pcode-0.1.4}/src/pcode/app.py

@@ -24,8 +24,13 @@ from pcode.cli import ask, restore_stdin
 from pcode.commands import Command, CommandRegistry
 from pcode.completion import SHELLS as COMPLETION_SHELLS
 from pcode.completion import complete_with
+from pcode.config import (
+    IMMEDIATE_SETTINGS,
+    config_argument_descriptions,
+    config_arguments,
+    configure,
+)
 from pcode.config import USAGE as CONFIG_USAGE
-from pcode.config import config_argument_descriptions, config_arguments, configure
 from pcode.controller import (
     MODEL_COMMANDS,
     TERMINAL_COMMANDS,
@@ -234,6 +239,7 @@ class PreviewApp:
         self.reviewed_checkpoint = None
         self.links_requested = False
         self.copy_requested = False
+        self.config_requested = False
         # Unsaved conversations have no journal to re-read, so keep their changes.
         self.edits: list[EditCompleted] = []
         self.session_requested = False
@@ -260,7 +266,7 @@ class PreviewApp:
             ),
             Command(
                 "/config",
-                "Inspect or edit saved defaults: diff / get KEY / set KEY VALUE / unset KEY",
+                "Browse saved settings, or use list / diff / get KEY / set KEY VALUE / unset KEY",
                 self.config,
                 free_arguments=True,
                 argument_provider=config_arguments,
@@ -310,7 +316,7 @@ class PreviewApp:
             ),
             Command(
                 "/copy",
-                "Copy the last response, or a quote or code block from it",
+                "Choose a response to copy, or a quote or code block from it",
                 self.copy,
                 group="Inspect",
             ),
@@ -727,7 +733,29 @@ class PreviewApp:
         return bindings.complete(argument) if bindings is not None else ()
 
     def config(self, argument: str) -> None:
-        args = shlex.split(argument)
+        if not argument.strip():
+            self.config_requested = True
+            return
+        self.transcript.note(self.apply_config(shlex.split(argument)))
+
+    async def browse_config(self, output: TerminalOutput, session) -> None:
+        from pcode.config_ui import ConfigBrowser
+
+        self.config_requested = False
+        try:
+            async with self.popup(output, session) as modal_input:
+                browser = ConfigBrowser(
+                    save=self.apply_config,
+                    input=modal_input,
+                    output=session.app.output,
+                    style=session.app.style,
+                )
+                await browser.run()
+        except (ValueError, OSError) as error:
+            self.transcript.warning(f"Could not open configuration: {error}")
+
+    def apply_config(self, args: list[str]) -> str:
+        """One write and immediate-layout path for commands and the browser."""
         try:
             result = configure(args)
         except OSError as error:
@@ -751,25 +779,9 @@ class PreviewApp:
         if self.transcript.output is not None:
             self.transcript.output.app.invalidate()
         edits = args[1:] if args[:1] == ["project"] else args
-        if (
-            len(edits) >= 2
-            and edits[0] in ("set", "unset")
-            and edits[1]
-            in (
-                "attach_tasks",
-                "tasks_max_height",
-                "tasks_min_rows",
-                "tasks_min_columns",
-                "task_style",
-                "tool_glyphs",
-                "tool_max_lines",
-                "tool_linger_seconds",
-                "show_hints",
-                "live_edits",
-            )
-        ):
+        if len(edits) >= 2 and edits[0] in ("set", "unset") and edits[1] in IMMEDIATE_SETTINGS:
             result = result.replace("Applies on next launch.", "Layout settings apply immediately.")
-        self.transcript.note(result)
+        return result
 
     def set_show_tasks(self, shown: bool) -> None:
         self.activity.show_tasks = shown
@@ -825,7 +837,8 @@ class PreviewApp:
         if self.transcript.output is not None:
             self.transcript.output.app.invalidate()
         self.transcript.flash(
-            f"Show edits: {'on' if shown else 'off'}. Usage: /show-edits [on|off]"
+            f"Show edits: {'on' if shown else 'off'}. Usage: /show-edits [on|off] "
+            f"({self.shortcut('v')})"
         )
 
     def group_tools(self, argument: str) -> None:
@@ -836,7 +849,8 @@ class PreviewApp:
         if self.transcript.output is not None:
             self.transcript.output.app.invalidate()
         self.transcript.flash(
-            f"Group tools: {'on' if grouped else 'off'}. Usage: /group-tools [on|off]"
+            f"Group tools: {'on' if grouped else 'off'}. Usage: /group-tools [on|off] "
+            f"({self.shortcut(']')})"
         )
 
     def set_thinking_mode(self, mode: str) -> None:
@@ -924,7 +938,7 @@ class PreviewApp:
     def persist_defaults(self, **updates: str) -> None:
         try:
             save_preferences(**updates)
-        except (OSError, ValueError):
+        except OSError, ValueError:
             self.transcript.warning("Could not save defaults; this selection applies only here.")
 
     def forget_defaults(self, *keys: str) -> None:
@@ -932,7 +946,7 @@ class PreviewApp:
 
         try:
             update_preferences({}, remove=keys)
-        except (OSError, ValueError):
+        except OSError, ValueError:
             self.transcript.warning("Could not update defaults; this change applies only here.")
 
     @asynccontextmanager
@@ -1056,21 +1070,20 @@ class PreviewApp:
 
     async def choose_copy(self, output: TerminalOutput, session) -> None:
         from pcode.clipboard import copy as copy_to_clipboard
-        from pcode.copy_ui import last_response, snippet_dialog, snippets
-        from pcode.session_ui import literal
+        from pcode.copy_ui import answers, copy_dialog, snippets
 
         self.copy_requested = False
         tree = getattr(self.runtime, "tree", None)
-        # Redacted like /tree's copy: what leaves pcode never carries a secret.
-        choices = snippets(literal(last_response(tree))) if tree is not None else []
-        if not choices:
+        history = answers(tree) if tree is not None else []
+        if not history:
             self.transcript.note("No response to copy yet.")
             return
+        choices = snippets(history[0].text)
         choice = choices[0]
-        if len(choices) > 1:
+        if len(history) > 1 or len(choices) > 1:
             async with self.popup(output, session) as modal_input:
-                dialog = snippet_dialog(
-                    choices,
+                dialog = copy_dialog(
+                    history,
                     input=modal_input,
                     output=session.app.output,
                     style=session.app.style,
@@ -1941,7 +1954,7 @@ class PreviewApp:
                     timeout=1,
                 )
             self.branch = plain(result.stdout.strip(), limit=None) if result.returncode == 0 else ""
-        except (OSError, subprocess.TimeoutExpired):
+        except OSError, subprocess.TimeoutExpired:
             self.branch = ""
         return self.branch != previous
 
@@ -2063,6 +2076,8 @@ class PreviewApp:
         self._command_popup_generation = tag
         try:
             self.handle(text)
+            if self.config_requested:
+                await self.browse_config(output, session)
             if self.worker_view_requested:
                 await self.read_workers(output, session)
             if self.tree_requested:
@@ -2168,6 +2183,7 @@ class PreviewApp:
                 self.activity.busy = False
             else:
                 session.app.create_background_task(refresh_metadata())
+                session.app.create_background_task(controller.warn_outdated())
                 controller.start_mcp_defaults()
             finally:
                 self._startup_pending = False
@@ -2251,7 +2267,7 @@ class PreviewApp:
                 self.transcript.note(f"Cleared {prompts} queued message(s).")
             self.activity.busy = False
 
-        def submit(text):
+        def submit(text, *, mode_override: str | None = None):
             text = text.strip()
             ready = early is None and getattr(self.controller, "ready", None)
             if (early is not None or (ready and not ready.is_set())) and text in {"/quit", "/exit"}:
@@ -2273,7 +2289,7 @@ class PreviewApp:
                 mode = "shell"
             elif text:
                 # One send consumes a Ctrl+S pick; the saved default returns.
-                mode = self.next_send_mode
+                mode = mode_override or self.next_send_mode
                 self.send_mode_once = None
             else:
                 return
@@ -2290,6 +2306,7 @@ class PreviewApp:
             transcript=self.transcript,
             workspace=lambda: self.workspace,
             on_submit=submit,
+            on_interrupt_submit=lambda text: submit(text, mode_override="interrupt"),
             on_command=submit,
             on_cancel=cancel,
             on_tasks=self.set_show_tasks,
@@ -2319,7 +2336,7 @@ class PreviewApp:
         )
         try:
             terminal = session.app.output.fileno()
-        except (NotImplementedError, OSError, ValueError):
+        except NotImplementedError, OSError, ValueError:
             terminal = None
         if terminal is not None:
             mode = load_preferences().get("terminal_progress", "auto")

{pcode-0.1.2 → pcode-0.1.4}/src/pcode/appearance.py

@@ -88,7 +88,7 @@ def _gnome_read() -> str | None:
             text=True,
             timeout=2,
         )
-    except (OSError, subprocess.SubprocessError):
+    except OSError, subprocess.SubprocessError:
         return None
     if result.returncode != 0:
         return None
@@ -102,7 +102,7 @@ def desktop_reader():
     try:
         if sys.platform == "darwin":
             return _macos_reader()
-    except (OSError, AttributeError, ValueError):
+    except OSError, AttributeError, ValueError:
         return None
     if sys.platform.startswith("linux") and shutil.which("gsettings"):
         if os.environ.get("DISPLAY") or os.environ.get("WAYLAND_DISPLAY"):

{pcode-0.1.2 → pcode-0.1.4}/src/pcode/aside_ui.py

@@ -33,7 +33,7 @@ from rich.theme import Theme
 
 from pcode.aside import Aside, Asides, Bridge
 from pcode.clipboard import copy as copy_to_clipboard
-from pcode.copy_ui import Snippet, SnippetPicker, snippets
+from pcode.copy_ui import Answer, CopyPicker, Snippet, snippets
 from pcode.frame import Frame
 from pcode.links import Link, extract_links, open_link, remember_link
 from pcode.links_ui import LinkPicker
@@ -113,7 +113,7 @@ class AsideBrowser:
     returning a `Bridge` from `run`; `check_bridge(thread)` raises `ValueError`
     when it cannot yet.
 
-    Prefix `y` copies the newest answer and prefix `o` opens a link from the
+    Prefix `y` chooses an answer to copy and prefix `o` opens a link from the
     thread, with the same pickers as `/copy` and `/links`, over the viewer.
     The editor takes each action as a slash command too: see `commands`.
 
@@ -169,7 +169,7 @@ class AsideBrowser:
         self._ids: list[str] = []
         self.notice = ""
         # The copy or link picker over the viewer, while one is open.
-        self.picker: SnippetPicker | LinkPicker | None = None
+        self.picker: CopyPicker | LinkPicker | None = None
         self.list = TextArea(read_only=True, wrap_lines=False, scrollbar=True)
         self.list.window.cursorline = Always()
         self.detail = RichPane(theme=rich_theme, color_system=color_system)
@@ -305,7 +305,7 @@ class AsideBrowser:
         )
         picker = Frame(
             DynamicContainer(lambda: self.picker.container if self.picker else HSplit([])),
-            title=lambda: "Links" if isinstance(self.picker, LinkPicker) else "Copy",
+            title=lambda: self.picker.title if isinstance(self.picker, CopyPicker) else "Links",
         )
         overlaid = FloatContainer(
             root_container,
@@ -386,16 +386,8 @@ class AsideBrowser:
 
     def help(self) -> list[tuple[str, str]]:
         """Describe the active picker, editor, or reader, including its current focus."""
-        if isinstance(self.picker, LinkPicker):
-            return self.picker.help()
         if self.picker is not None:
-            return [
-                ("↑/↓", "Select snippet"),
-                ("PgUp/PgDn", "Page"),
-                ("Ctrl+U/D", "Half page"),
-                ("Enter", "Copy selected snippet"),
-                ("Esc/Ctrl+C", "Cancel"),
-            ]
+            return self.picker.help()
         interrupt = ("Ctrl+C", "Stop running answers" if self.asides.running else "Close")
         if self.editing():
             prompting = self.input.prompting
@@ -444,7 +436,7 @@ class AsideBrowser:
             self.finish(Bridge(self.selected, kind, focus))
 
         commands = [
-            PopupCommand("/copy", "Copy the newest answer", lambda _: self.copy(self.app.output)),
+            PopupCommand("/copy", "Choose an answer to copy", lambda _: self.copy(self.app.output)),
             PopupCommand("/links", "Open a link from this thread", lambda _: self.choose_link()),
         ]
         if self.check_bridge is not None:
@@ -550,28 +542,27 @@ class AsideBrowser:
         self.refresh()
 
     def copy(self, output=None) -> None:
-        """Copy the thread's newest answer, even while it is still arriving.
-
-        As `/copy` does: the redacted text the pane shows, and an answer
-        holding quotes or code blocks opens a picker to copy just one.
-        """
-        answered = [literal(aside.answer) for aside in self.current()]
-        answered = [answer for answer in answered if answer]
+        """Choose an answer from this thread, newest first, including partial text."""
+        answered = [
+            Answer(aside.question, aside.answer)
+            for aside in reversed(self.current())
+            if aside.answer.strip()
+        ]
+        answered = [answer for answer in answered if answer.text.strip()]
         if not answered:
             self.notice = "No answer to copy"
             return
-        choices = snippets(answered[-1])
-        if len(choices) > 1:
+        if len(answered) > 1 or len(snippets(answered[0].text)) > 1:
             self.open_picker(
-                lambda close: SnippetPicker(
-                    choices,
+                lambda close: CopyPicker(
+                    answered,
                     on_pick=lambda snippet: self.copy_snippet(close, snippet, output),
                     on_cancel=close,
                     shortcuts=self.prefix_keys,
                 )
             )
             return
-        self.copy_text("answer", answered[-1], output)
+        self.copy_text("answer", answered[0].text, output)
 
     def copy_snippet(self, close, snippet: Snippet, output=None) -> None:
         close()
@@ -631,7 +622,7 @@ class AsideBrowser:
             self.app.layout.focus(previous)
 
         self.picker = build(close)
-        # A link picker opens in its search line, so typing filters at once.
+        # Searchable pickers open in their search line, so typing filters at once.
         focus_overlay(self.app, getattr(self.picker, "query", None) or self.picker.list)
 
     def details(self, thread: list[Aside]) -> tuple[list, int]:

{pcode-0.1.2 → pcode-0.1.4}/src/pcode/auth.py

@@ -56,7 +56,7 @@ def oauth_user_agent() -> str:
                 timeout=VERSION_TIMEOUT_SECONDS,
                 check=True,
             )
-        except (OSError, subprocess.SubprocessError):
+        except OSError, subprocess.SubprocessError:
             pass
         else:
             local = _parse_version(result.stdout)