@omercnet/paseo-agent-crew 0.2.3

package/CHANGELOG.md

@@ -0,0 +1,48 @@
+# Changelog
+
+## Unreleased
+
+### Migration
+
+- migrate the plugin to the Paseo 0.8 runtime-entry layout
+- move client modules under `client/` and shared code under `shared/`
+- switch to first-class `parentAgentId` handling with bounded cycles
+- add an explicit pending-permission modal with Allow and Deny actions
+- pin Paseo plugin packages to `0.8.0-beta.1`
+
+## [0.2.3](https://github.com/omercnet/paseo-plugins/compare/agent-crew-v0.2.2...agent-crew-v0.2.3) (2026-09-10)
+
+
+### Bug Fixes
+
+* upgrade plugins to Paseo 0.8.0 ([c6b4e40](https://github.com/omercnet/paseo-plugins/commit/c6b4e4081fc9527de0ca6183a3903ff5ec4f93c4))
+* upgrade plugins to Paseo 0.8.0 ([d7ad454](https://github.com/omercnet/paseo-plugins/commit/d7ad4540d2e1875bdf4a4d21f76ded25cac2f3dc))
+
+## [0.2.2](https://github.com/omercnet/paseo-agent-crew/compare/v0.2.1...v0.2.2) (2026-09-08)
+
+
+### Bug Fixes
+
+* derive client API types from host SDK ([#7](https://github.com/omercnet/paseo-agent-crew/issues/7)) ([ffdfacf](https://github.com/omercnet/paseo-agent-crew/commit/ffdfacf9e4f0bd43f84e973176b2b2ffd7fe6350))
+
+## [0.2.1](https://github.com/omercnet/paseo-agent-crew/compare/v0.2.0...v0.2.1) (2026-09-08)
+
+
+### Bug Fixes
+
+* clean up Paseo 0.8 migration ([#5](https://github.com/omercnet/paseo-agent-crew/issues/5)) ([02912fb](https://github.com/omercnet/paseo-agent-crew/commit/02912fbb73956420ae8315bceea7025e71dd7a71))
+
+## [0.2.0](https://github.com/omercnet/paseo-agent-crew/compare/v0.1.0...v0.2.0) (2026-09-08)
+
+
+### Features
+
+* migrate agent crew to paseo 0.8 ([#3](https://github.com/omercnet/paseo-agent-crew/issues/3)) ([3014f1c](https://github.com/omercnet/paseo-agent-crew/commit/3014f1c2f1afb8187cb2ac0e86f2b442bb805911))
+
+## 0.1.0 (2026-09-02)
+
+### Features
+
+- add the workspace-wide Agent Crew Explorer panel
+- organize managed agents into collapsible cross-workspace delegation trees
+- add status filters, search, navigation, and guarded agent controls

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Omer Cohen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,131 @@
+# Agent Crew
+
+See and control every managed Paseo agent working in a workspace. Agent Crew adds a
+workspace-context Explorer panel plus an `Open Agent Crew` Command Center item.
+
+It answers "which crews are active here, and which agent needs me now?" while preserving managed
+parent-child relationships across workspace boundaries.
+
+## Screenshots
+
+Names, workspaces, and task details in these screenshots are synthetic. The rendered page was
+rewritten before capture so no private project or session identifiers are published.
+
+### Crew overview
+
+![Agent Crew descendant tree and status filters](docs/images/agent-crew-overview.png)
+
+### Safe action confirmation
+
+![Agent Crew nudge confirmation](docs/images/agent-crew-action.png)
+
+## What it shows
+
+- Every non-archived managed agent in the current workspace, organized into orchestration trees.
+- Managed descendants remain in their crew when they run in another workspace.
+- Out-of-workspace ancestors required to explain a local agent appear as dimmed, open-only context;
+  unrelated foreign branches are pruned.
+- Independent agents appear as top-level rows, while collapsible tree rails and descendant counts
+  distinguish delegated crews.
+- Provider and model, workspace, last error, state, and activity age for each visible agent.
+- Counts and filters for Needs input, Failed, Working, Ready, Idle, and Closed.
+- Text search over title, agent ID, provider, model, working directory, workspace, and labels.
+- Live agent and workspace subscriptions, debounced by 500 ms, plus a 30-second backstop refresh.
+- Direct navigation to a selected agent when the host provides agent navigation.
+- Explicit Allow and Deny controls for visible pending permission requests.
+
+## Controls
+
+Each row exposes the operations available through the public Paseo SDK:
+
+- **Open** navigates to the selected agent.
+- **Expand or collapse** shows or hides a managed branch without changing agent state.
+- **Nudge** sends a follow-up to an idle or waiting agent.
+- **Interrupt and redirect** sends a new direction to a running agent. Paseo stops the active turn
+  before starting that direction, and the confirmation dialog says so explicitly.
+- **Detach** removes a managed child branch from its parent while allowing it to continue
+  independently. Root agents and context-only ancestors do not expose this action.
+- **Archive** stops and removes the selected agent. Same-workspace descendants may be archived with
+  it; cross-workspace descendants may detach and continue. The confirmation dialog describes that
+  behavior before the action runs.
+- **Permission allow / deny** opens one explicit request modal for the selected pending request and
+  answers it with `request.id`; no automatic approval policy runs.
+
+Every mutating control uses a confirmation dialog. Successful actions show a toast; SDK errors are
+shown without hiding the failure.
+
+## How it reads state
+
+`usePaseo().agents.list()` and `usePaseo().workspaces.list()` page the selected daemon directory at
+200 entries per page, up to 10 pages. Parent relationships come from the first-class
+`parentAgentId` field when the public 0.8 SDK exposes it, with a legacy label fallback for older
+snapshots. The workspace crew contains local agents, their managed descendants, and only the foreign
+ancestor paths needed to explain local membership. Archived agents are omitted, malformed parent
+cycles are bounded, and siblings are ordered by actionable state, creation time, then ID.
+
+State precedence is:
+
+1. Failed
+2. Needs input
+3. Working
+4. Ready
+5. Closed
+6. Idle
+
+Failed takes precedence over pending permission state so an errored agent is never presented as an
+agent that can resume normally.
+
+## Limits
+
+Agent Crew intentionally stays inside the public Paseo plugin SDK.
+
+- It shows managed Paseo agents only. Native provider subagents are not exposed by the public plugin
+  SDK.
+- Workspace-less top-level agents are outside every workspace crew; workspace-less descendants of
+  visible members remain in that crew.
+- It does not add heartbeat controls, private cancellation calls, or direct daemon API access.
+- Sending to a running agent interrupts its active turn; there is no separate non-interrupting send
+  operation.
+- If the daemon contains more than 2,000 agents, the panel warns that its directory snapshot may
+  omit agents in this workspace or their descendants.
+
+## Install
+
+Paseo plugins are trusted, unsandboxed code. Review the source before installing it.
+
+From GitHub:
+
+```bash
+paseo plugin add omercnet/paseo-plugins:agent-crew
+```
+
+From a local checkout on the Paseo daemon host:
+
+```bash
+git clone https://github.com/omercnet/paseo-plugins.git
+cd paseo-plugins/agent-crew
+bun install --frozen-lockfile
+paseo plugin install "$PWD"
+```
+
+Open a workspace, choose **New tab** in Explorer, then select **Agent Crew**. The **Open Agent Crew**
+Command Center action opens it directly.
+
+## Develop
+
+```bash
+bun install
+bun run check
+bun test
+bun run test:coverage
+bun run typecheck
+paseo plugin install /absolute/path/to/paseo-agent-crew
+paseo plugin reload agent-crew
+```
+
+The manifest requires Paseo `^0.8.0`, which accepts Paseo 0.8.x including compatible prereleases.
+The project pins `@getpaseo/cli`, `@getpaseo/client`, `@getpaseo/plugin`, and
+`@getpaseo/protocol` to stable `0.8.0`. React 19.1 and React Native 0.81 match the host.
+
+Release Please maintains versions, changelog entries, component tags, and GitHub releases from
+Conventional Commits in the monorepo.