patchfeld 0.2.0__tar.gz → 0.2.2__tar.gz

{patchfeld-0.2.0 → patchfeld-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: patchfeld
-Version: 0.2.0
+Version: 0.2.2
 Summary: A Textual TUI for managing multiple Claude Code agent sessions
 Project-URL: Homepage, https://github.com/jimmymills/patchfeld
 Project-URL: Repository, https://github.com/jimmymills/patchfeld
@@ -39,6 +39,8 @@ Description-Content-Type: text/markdown
 orchestrator-managed workspace — and lets the agent reshape the UI to fit
 the work.**
 
+**[patchfeld.com](https://patchfeld.com)** · [PyPI](https://pypi.org/project/patchfeld/) · [GitHub](https://github.com/jimmymills/patchfeld)
+
 ![patchfeld — orchestrator chat on the left, agent table and activity feed on the right](https://raw.githubusercontent.com/jimmymills/patchfeld/main/docs/images/screenshot.png)
 
 ## The pitch
@@ -48,7 +50,7 @@ one's writing tests, one's doing a security pass. They live in three
 terminal tabs with three scrollbacks, and you're the one mentally juggling
 which is waiting on what.
 
-**Patchfeld is the room you wish you had.** One TUI. One top-level Claude —
+**Patchfeld is a studio for orchestrating agents.** One TUI. One top-level Claude —
 the *orchestrator* — runs the show. You tell it what you want done in
 plain English; it spawns the right children with the right tool
 allowlists, watches their progress, and pulls them onscreen when they
@@ -118,7 +120,7 @@ the ideas.
   the actual `claude` CLI, or your shell, in any panel. Mode-C custom
   widgets let the orchestrator ship Python at runtime when the curated
   widget library isn't enough.
-- **Approve tool calls without leaving the room.** When a child wants
+- **Approve tool calls without leaving the workspace.** When a child wants
   to use a tool that isn't auto-approved, a modal pops in patchfeld with
   the tool name and full arguments. Approve once, deny once, always
   allow this tool for any agent named X (persisted to disk), or always

{patchfeld-0.2.0 → patchfeld-0.2.2}/README.md

@@ -4,6 +4,8 @@
 orchestrator-managed workspace — and lets the agent reshape the UI to fit
 the work.**
 
+**[patchfeld.com](https://patchfeld.com)** · [PyPI](https://pypi.org/project/patchfeld/) · [GitHub](https://github.com/jimmymills/patchfeld)
+
 ![patchfeld — orchestrator chat on the left, agent table and activity feed on the right](https://raw.githubusercontent.com/jimmymills/patchfeld/main/docs/images/screenshot.png)
 
 ## The pitch
@@ -13,7 +15,7 @@ one's writing tests, one's doing a security pass. They live in three
 terminal tabs with three scrollbacks, and you're the one mentally juggling
 which is waiting on what.
 
-**Patchfeld is the room you wish you had.** One TUI. One top-level Claude —
+**Patchfeld is a studio for orchestrating agents.** One TUI. One top-level Claude —
 the *orchestrator* — runs the show. You tell it what you want done in
 plain English; it spawns the right children with the right tool
 allowlists, watches their progress, and pulls them onscreen when they
@@ -83,7 +85,7 @@ the ideas.
   the actual `claude` CLI, or your shell, in any panel. Mode-C custom
   widgets let the orchestrator ship Python at runtime when the curated
   widget library isn't enough.
-- **Approve tool calls without leaving the room.** When a child wants
+- **Approve tool calls without leaving the workspace.** When a child wants
   to use a tool that isn't auto-approved, a modal pops in patchfeld with
   the tool name and full arguments. Approve once, deny once, always
   allow this tool for any agent named X (persisted to disk), or always

{patchfeld-0.2.0 → patchfeld-0.2.2}/patchfeld/agents/session.py

@@ -50,6 +50,13 @@ class AgentSession:
         self._send_lock = asyncio.Lock()
         self._pre_wait_state: AgentState | None = None
         self._pre_perm_state: AgentState | None = None
+        # Tasks created by queue_send() that are still pending or in-flight.
+        # Tracked so interrupt() can cancel them before they call
+        # adapter.query — otherwise a DirectMessageToAgent queued behind
+        # the active stream (e.g. an orchestrator's send_to_agent payload)
+        # would wake up the moment the SDK signals end-of-stream and run
+        # the queued prompt against the now-interrupted session.
+        self._queued_send_tasks: list[asyncio.Task] = []
 
     @property
     def session_id(self) -> str | None:
@@ -79,14 +86,37 @@ class AgentSession:
         in the same task will correctly block until the send completes —
         without it, wait_idle could return before the send task acquires the
         send lock.
+
+        The task is also tracked so `interrupt()` can cancel it if the user
+        interrupts before it has issued its query.
         """
         self._idle_event.clear()
-        return asyncio.create_task(self.send(prompt))
+        task = asyncio.create_task(self.send(prompt))
+        # Drop completed tasks before appending so the list doesn't grow.
+        self._queued_send_tasks = [
+            t for t in self._queued_send_tasks if not t.done()
+        ]
+        self._queued_send_tasks.append(task)
+        task.add_done_callback(self._queued_send_tasks.remove)
+        return task
 
     async def wait_idle(self) -> None:
         await self._idle_event.wait()
 
     async def interrupt(self) -> None:
+        # Cancel any send tasks that are still queued (blocked behind the
+        # active stream) BEFORE signalling the SDK. Otherwise the SDK's
+        # end-of-stream wakes them up and they post their prompt against
+        # the now-interrupted session — which is how an orchestrator's
+        # `send_to_agent` payload was landing on the child agent after
+        # the user pressed ctrl+c.
+        pending = [t for t in self._queued_send_tasks if not t.done()]
+        for task in pending:
+            task.cancel()
+        # Wait for cancellations to propagate so the lock is released
+        # before the SDK starts winding down the stream.
+        if pending:
+            await asyncio.gather(*pending, return_exceptions=True)
         await self._adapter.interrupt()
 
     async def stop(self) -> None:

{patchfeld-0.2.0 → patchfeld-0.2.2}/patchfeld/widgets/agent_transcript.py

@@ -1,4 +1,5 @@
 from textual.app import ComposeResult
+from textual.binding import Binding
 from textual.containers import Vertical
 from textual.widgets import Input
 
@@ -23,6 +24,14 @@ class AgentTranscript(Vertical):
     }
     """
 
+    # priority=True so the binding fires even when the Input child has
+    # focus — without it, ctrl+c is consumed by Textual's default driver
+    # handling (which would quit the app). Mirrors OrchestratorChat so
+    # both chat panels respond to ctrl+c the same way.
+    BINDINGS = [
+        Binding("ctrl+c", "interrupt", "interrupt agent", priority=True),
+    ]
+
     def __init__(
         self,
         *,
@@ -73,6 +82,32 @@ class AgentTranscript(Vertical):
             bus.publish(DirectMessageToAgent(agent_id=self._agent_id, text=text))
         event.input.value = ""
 
+    async def action_interrupt(self) -> None:
+        manager = getattr(self.app, "manager", None)
+        if manager is None:
+            return
+        # Stale-panel guard: if no live session matches this panel's
+        # agent_id, manager.interrupt would silently no-op. Surface that
+        # to the user instead — otherwise ctrl+c looks broken when in
+        # fact the panel is bound to an agent that no longer exists
+        # (e.g. opened from a stale agents.json entry).
+        if manager.get_session(self._agent_id) is None:
+            try:
+                self.app.notify(
+                    f"no active agent “{self._agent_id}” — panel may be stale",
+                    severity="warning", timeout=5,
+                )
+            except Exception:
+                pass
+            return
+        await manager.interrupt(self._agent_id)
+        try:
+            self.app.notify(
+                f"interrupted {self._agent_id}", timeout=3,
+            )
+        except Exception:
+            pass
+
     def rendered_text(self) -> str:
         """Test helper — delegates to the inner RichTranscript."""
         return self.query_one(RichTranscript).rendered_text()

{patchfeld-0.2.0 → patchfeld-0.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "patchfeld"
-version = "0.2.0"
+version = "0.2.2"
 description = "A Textual TUI for managing multiple Claude Code agent sessions"
 readme = "README.md"
 requires-python = ">=3.11"

patchfeld-0.2.2/website/README.md

@@ -0,0 +1,126 @@
+# patchfeld website
+
+Marketing site for [patchfeld](../README.md), hosted at
+[patchfeld.com](https://patchfeld.com).
+
+Astro + Tailwind, static-first, single landing page. No backend.
+
+## Stack
+
+- [Astro 5](https://astro.build) — static site generator with component islands
+- [Tailwind CSS 4](https://tailwindcss.com) — via the official Vite plugin
+- TypeScript (strict)
+- No animation library — plain CSS + a tiny `IntersectionObserver` for fade-in
+
+Astro was chosen because the site is content-first and ships almost zero
+JavaScript by default; the only client-side JS is the copy-to-clipboard
+button and the install-tab switcher (a few dozen lines, inlined per
+component). If we ever need MDX or a docs subsite, Astro accommodates
+both without a rewrite.
+
+## Prerequisites
+
+- Node.js 20.x or 22.x (24.x works in dev — official Astro support is 22 LTS)
+- npm 10+
+
+## Local development
+
+```bash
+cd website
+npm install
+npm run dev
+```
+
+The dev server runs on <http://localhost:4321>.
+
+## Build
+
+```bash
+cd website
+npm run build      # outputs to website/dist/
+npm run preview    # serves the built site
+```
+
+The build is fully static: `dist/` contains HTML, CSS, optimized images,
+and a small bit of JS for the interactive bits.
+
+## Project layout
+
+```
+website/
+  package.json
+  astro.config.mjs
+  tsconfig.json
+  src/
+    pages/
+      index.astro              # the whole site is one page for v1
+    layouts/
+      Base.astro                # html shell, fonts, meta, reveal observer
+    components/
+      Nav.astro
+      Hero.astro
+      Features.astro
+      Screenshot.astro
+      Examples.astro
+      Widgets.astro
+      Install.astro
+      Footer.astro
+    styles/
+      global.css                # Tailwind import + design tokens + base
+    assets/
+      screenshot.png            # copied from ../docs/images/screenshot.png
+  public/
+    favicon.svg
+```
+
+## Updating the screenshot
+
+If the screenshot in the project root (`../docs/images/screenshot.png`)
+is regenerated, copy it back over:
+
+```bash
+cp ../docs/images/screenshot.png src/assets/screenshot.png
+```
+
+`src/assets/` is processed by Astro's image pipeline (compression,
+responsive sizing, lazy loading), which is why we import it via
+`astro:assets` in `Screenshot.astro`.
+
+## Deploying
+
+The site is static — any host that serves `dist/` works.
+
+### Cloudflare Pages (recommended)
+
+1. Create a new Pages project pointed at this repo.
+2. Set the **build command** to `npm run build`.
+3. Set the **build output directory** to `dist`.
+4. Set the **root directory** to `website`.
+5. Add the custom domain `patchfeld.com` once DNS is set up.
+
+Cloudflare Pages auto-deploys on push and handles HTTPS for free.
+
+### Alternatives
+
+- **Vercel:** import the repo, set the root directory to `website`, framework
+  preset "Astro". Vercel auto-detects build command + output.
+- **Netlify:** set base directory `website`, build command `npm run build`,
+  publish directory `website/dist`.
+- **GitHub Pages:** publish `dist/` from a workflow. There's no built-in
+  Astro action; use [`actions/deploy-pages`](https://github.com/actions/deploy-pages)
+  with `actions/upload-pages-artifact` pointed at `website/dist`.
+
+## Updating copy
+
+The site's copy is consistent with the project README's voice: direct,
+technical, slightly playful. When you add or rewrite a section, read the
+project root README first and match its register. Don't slip into
+generic SaaS phrasing.
+
+GitHub URL: the repo is `jimmymills/patchfeld`. The old `patchbai` URL
+still redirects via GitHub's rename redirect, but everything in the site
+points at the canonical name.
+
+## License
+
+MIT — same as the project itself.