@kushalkhemka/opensec-pi-subagents 0.19.5 → 0.19.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/CHANGELOG.md +11 -0
  2. package/LICENSE +6 -0
  3. package/README.md +78 -19
  4. package/package.json +2 -2
package/CHANGELOG.md CHANGED
@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [0.19.7] - 2026-10-03
11
+
12
+ ### Changed
13
+ - Docs: corrected README facts (Pi compatibility verified on Pi 0.87.1 and 1.0.0). No code changes.
14
+ - License: the package is now proprietary (`UNLICENSED`); LICENSE keeps the upstream MIT notice for the included `@tintinweb/pi-subagents` code.
15
+
16
+ ## [0.19.6] - 2026-10-03
17
+
18
+ ### Changed
19
+ - Docs: README restyle (logo, install for Node and Bun). No code changes.
20
+
10
21
  ## [0.19.5] - 2026-10-03
11
22
 
12
23
  ### Fixed
package/LICENSE CHANGED
@@ -1,3 +1,9 @@
1
+ Copyright (c) 2026 OpenSec. All rights reserved.
2
+ This software is proprietary. No permission is granted to redistribute it.
3
+
4
+ This package includes software from @tintinweb/pi-subagents (https://github.com/tintinweb/pi-subagents)
5
+ under the following licence, whose terms still apply to that software:
6
+
1
7
  MIT License
2
8
 
3
9
  Copyright (c) 2026 tintinweb
package/README.md CHANGED
@@ -1,8 +1,42 @@
1
- # Subagents for Pi
1
+ <p align="center">
2
+ <img src="https://pi-bolt.opensec.in/plugins/opensec-pi-subagents.svg" width="96" height="96" alt="Subagents for Pi logo">
3
+ </p>
2
4
 
3
- Run specialized Pi agents in separate sessions while the main agent continues working. This maintained fork of `@tintinweb/pi-subagents` adds parent model and thinking-level inheritance and cached agent discovery.
5
+ <h1 align="center">Subagents for Pi</h1>
4
6
 
5
- ## What it offers
7
+ <p align="center">Run specialized Pi agents in separate sessions, inheriting the parent's model and thinking level, with cached agent discovery.</p>
8
+
9
+ <p align="center">
10
+ <img alt="Pi extension" src="https://img.shields.io/badge/Pi-extension-2A78D6?style=flat-square">
11
+ <img alt="Node build: latest" src="https://img.shields.io/badge/node-latest-4C96EA?style=flat-square&logo=nodedotjs&logoColor=white">
12
+ <img alt="Bun build: @bun" src="https://img.shields.io/badge/bun-%40bun-F7C04A?style=flat-square&logo=bun&logoColor=black">
13
+ <img alt="License: proprietary" src="https://img.shields.io/badge/license-proprietary-555?style=flat-square">
14
+ </p>
15
+
16
+ ## Install
17
+
18
+ | Runtime | Command |
19
+ |---|---|
20
+ | **Pi on Node** (`latest`) | `pi install npm:@kushalkhemka/opensec-pi-subagents` |
21
+ | **pi-bolt / Pi on Bun** (`bun`) | `pi install npm:@kushalkhemka/opensec-pi-subagents@bun` |
22
+
23
+ > Pick the one that matches the Pi you run: `pi-bolt` (or Pi started with Bun) → `@bun`; Pi on Node → the plain name.
24
+ > The builds are maintained per runtime and can differ in details (the Bun README lists what differs). These are private packages: log in to npm with an account that can read
25
+ > `@kushalkhemka` first (`npm login`), or put a read token in `~/.npmrc`.
26
+
27
+ Restart Pi or run `/reload` after installing. Update with `pi update --extensions`; remove with
28
+ `pi remove npm:@kushalkhemka/opensec-pi-subagents`.
29
+
30
+ ### Requirements
31
+
32
+ - Pi: this Node build loads and runs a real turn on Pi 0.87.1 and Pi 1.0.0 (both on Node). The peer-dependency
33
+ range is `>=0.84.0`; earlier versions were not re-tested.
34
+ - Install only one Subagents package at a time: the public and private packages expose the same tools.
35
+
36
+ ## Features
37
+
38
+ This maintained fork of `@tintinweb/pi-subagents` runs specialized Pi agents in separate sessions while the main agent
39
+ continues working, and adds parent model and thinking-level inheritance and cached agent discovery.
6
40
 
7
41
  - Background agents by default, with optional foreground runs, steering, result retrieval, and session resume.
8
42
  - Built-in `Explore` and `Plan` agents for read-only work, plus a general-purpose agent and custom agent definitions.
@@ -10,31 +44,56 @@ Run specialized Pi agents in separate sessions while the main agent continues wo
10
44
  - An `/agents` UI for live conversations, settings, workflows, and scheduled jobs.
11
45
  - Optional nested delegation, persistent memory, skill preloading, and Git worktree isolation.
12
46
 
13
- ## Install
47
+ ## Usage
14
48
 
15
- Requires Pi 0.84.0 or newer and npm access to this private package:
49
+ Ask Pi to delegate work, for example: “Use an Explore agent to find the authentication code, then report the relevant
50
+ files.” Pi can call the `Agent` tool like this:
16
51
 
17
- ```bash
18
- npm login
19
- pi install npm:@kushalkhemka/opensec-pi-subagents
52
+ ```text
53
+ Agent({ subagent_type: "Explore", prompt: "Find authentication code", description: "Find auth files" })
20
54
  ```
21
55
 
22
- Restart Pi or run `/reload`. Install only one Subagents package at a time; the public and private packages expose the same tools.
56
+ ### Tools
23
57
 
24
- ## Use
58
+ | Tool | What it does |
59
+ |---|---|
60
+ | `Agent` | Starts an agent. A background run returns an ID and notifies the main session when it finishes; set `run_in_background: false` when the next step must wait for its result. Also accepts session-scoped cron, interval, and one-shot schedules. |
61
+ | `get_subagent_result` | Returns the full result of an agent. |
62
+ | `steer_subagent` | Redirects a running agent. |
63
+ | `SubagentWorkflow` | Runs repeatable multi-agent work (`agent()`, `parallel()`, `pipeline()`). |
25
64
 
26
- Ask Pi to delegate work, for example: “Use an Explore agent to find the authentication code, then report the relevant files.” Pi can call the `Agent` tool like this:
65
+ ### Commands
27
66
 
28
- ```text
29
- Agent({ subagent_type: "Explore", prompt: "Find authentication code", description: "Find auth files" })
30
- ```
67
+ | Command | What it does |
68
+ |---|---|
69
+ | `/agents` | Inspect and manage agents: live conversations, settings, workflows, and scheduled jobs (`/agents → Scheduled jobs`). |
70
+ | `@<agent> <message>` | With agent mentions enabled, sends a message to that agent, e.g. `@explore check the RPC path`. A finished agent can be resumed. |
71
+
72
+ ### Custom agents
73
+
74
+ Put custom definitions in `.pi/agents/<name>.md` or the global Pi agents directory. Agents inherit the current parent's
75
+ model and thinking level unless their definition or call overrides them.
76
+
77
+ ## Configuration
78
+
79
+ | Setting | Default | Meaning |
80
+ |---|---|---|
81
+ | Background concurrency (`/agents → Settings`) | `10` | How many background agents run at once. |
82
+
83
+ ## Notes
84
+
85
+ - Schedules: interval schedules must be at least `1m` (stored shorter intervals are raised to one minute); intervals and
86
+ relative delays are capped at `3650d`.
87
+ - Worktree isolation is optional and commits an isolated agent's changes to its branch on completion.
88
+ - Review `/agents → Settings` before enabling delegation or isolation for write-capable agents.
31
89
 
32
- `Agent` returns an ID for a background run and notifies the main session when it finishes. Use `get_subagent_result` for the full result or `steer_subagent` to redirect a running agent. Set `run_in_background: false` when the next step must wait for its result.
90
+ ## Security
33
91
 
34
- Open `/agents` to inspect and manage agents. With agent mentions enabled, `@explore check the RPC path` sends a message to that agent; a finished agent can be resumed. Put custom definitions in `.pi/agents/<name>.md` or the global Pi agents directory. Agents inherit the current parent's model and thinking level unless their definition or call overrides them.
92
+ Workflow scripts run in a vm that is a determinism and accident boundary, not a defence against a deliberately hostile
93
+ script; see [`docs/workflows.md`](docs/workflows.md).
35
94
 
36
- For repeatable multi-agent work, ask Pi to use `SubagentWorkflow`. The `Agent` tool also accepts session-scoped cron, interval, and one-shot schedules; manage them through `/agents → Scheduled jobs`.
95
+ ## License
37
96
 
38
- Background concurrency defaults to 10. Worktree isolation is optional and commits an isolated agent's changes to its branch on completion. Review `/agents → Settings` before enabling delegation or isolation for write-capable agents.
97
+ Proprietary. © 2026 OpenSec. All rights reserved. Includes `@tintinweb/pi-subagents` (MIT); see LICENSE.
39
98
 
40
- MIT License. Based on `@tintinweb/pi-subagents` by tintinweb.
99
+ Based on `@tintinweb/pi-subagents` by tintinweb.
package/package.json CHANGED
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "name": "@kushalkhemka/opensec-pi-subagents",
3
- "version": "0.19.5",
3
+ "version": "0.19.7",
4
4
  "description": "Fork of @tintinweb/pi-subagents with parent model/thinking inheritance and cached agent discovery.",
5
5
  "author": "tintinweb",
6
6
  "contributors": [
7
7
  "kushalkhemka"
8
8
  ],
9
- "license": "MIT",
9
+ "license": "UNLICENSED",
10
10
  "repository": {
11
11
  "type": "git",
12
12
  "url": "git+https://github.com/opensec-git/opensec-pi-subagents.git"