@ladbabynpm/picc-subagents 0.1.0 → 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ladbaby
+
+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

@@ -3,7 +3,7 @@
 [![npm downloads](https://img.shields.io/npm/dt/@ladbabynpm/picc-subagents.svg)](https://www.npmjs.com/package/@ladbabynpm/picc-subagents)
 
 Fork of [`@tintinweb/pi-subagents`](https://github.com/tintinweb/pi-subagents), adding
-`PI_SUBAGENT_MODEL` / `CLAUDE_CODE_SUBAGENT_MODEL` env-var model selection, removing `get_subagent_result` and `steer_subagent` tools.
+`PICC_SUBAGENTS_MODEL` / `CLAUDE_CODE_SUBAGENT_MODEL` env-var model selection, removing `get_subagent_result` and `steer_subagent` tools.
 To switch back to upstream, run `pi install npm:@tintinweb/pi-subagents`.
 
 Part of [picc](https://github.com/Ladbaby/picc), a pi agent setup mirroring Claude Code's harness.
@@ -348,13 +348,13 @@ src/
   prompts.ts          # Config-driven system prompt builder
   context.ts          # Parent conversation context for inherit_context
   env.ts              # Environment detection (git, platform)
-  subagent-env.ts     # PI_SUBAGENT_MODEL / CLAUDE_CODE_SUBAGENT_MODEL overrides (fork)
+  subagent-env.ts     # PICC_SUBAGENTS_MODEL / CLAUDE_CODE_SUBAGENT_MODEL overrides (fork)
   ui/
     agent-widget.ts       # Persistent widget: spinners, activity, status icons, theming
     conversation-viewer.ts # Live conversation overlay for viewing agent sessions
 ```
 
-## Fork notes (PI_SUBAGENT_MODEL / CLAUDE_CODE_SUBAGENT_MODEL)
+## Fork notes (PICC_SUBAGENTS_MODEL / CLAUDE_CODE_SUBAGENT_MODEL)
 
 This fork adds support for picking the **default subagent model from an environment
 variable**, mirroring claude-code's
@@ -362,8 +362,8 @@ variable**, mirroring claude-code's
 
 | Variable | Precedence | Notes |
 |---|---|---|
-| `PI_SUBAGENT_MODEL` | 1 (highest) | Fork-specific. |
-| `CLAUDE_CODE_SUBAGENT_MODEL` | 2 | claude-code-compatible; ignored when `PI_SUBAGENT_MODEL` is set. |
+| `PICC_SUBAGENTS_MODEL` | 1 (highest) | Fork-specific. |
+| `CLAUDE_CODE_SUBAGENT_MODEL` | 2 | claude-code-compatible; ignored when `PICC_SUBAGENTS_MODEL` is set. |
 | _unset_ | — | Falls back to existing precedence: caller `Agent({model})` > frontmatter `model:` > inherit parent. |
 
 The chosen model **overrides everything** — frontmatter pins and `Agent` `model:` parameters —
@@ -374,6 +374,6 @@ rather than silently falling back; whitespace-only values are treated as unset.
 `Agent` calls; cross-extension RPC callers pick up the same vars in their own process.
 
 ```bash
-export PI_SUBAGENT_MODEL=haiku                                  # always run subagents on haiku
+export PICC_SUBAGENTS_MODEL=haiku                                  # always run subagents on haiku
 export CLAUDE_CODE_SUBAGENT_MODEL=anthropic/claude-haiku-4-5    # claude-code-compatible
 ```

package/package.json

@@ -1,69 +1,69 @@
-{
-	"name": "@ladbabynpm/picc-subagents",
-	"version": "0.1.0",
-	"description": "Claude Code style Agent tool for pi agent. Fork of tintinweb/pi-subagents, better aligned with the harness of Claude Code.",
-	"author": "ladbabynpm",
-	"license": "MIT",
-	"repository": {
-		"type": "git",
-		"url": "https://github.com/ladbaby/picc-subagents.git"
-	},
-	"homepage": "https://github.com/ladbaby/picc-subagents#readme",
-	"bugs": {
-		"url": "https://github.com/ladbaby/picc-subagents/issues"
-	},
-	"keywords": [
-		"pi-package",
-		"pi",
-		"pi-extension",
-		"subagent",
-		"agent",
-		"autonomous"
-	],
-	"files": [
-		"src/",
-		"package.json",
-		"tsconfig.json",
-		"README.md",
-		"LICENSE",
-		"CHANGELOG.md",
-		"biome.json"
-	],
-	"peerDependencies": {
-		"@earendil-works/pi-ai": ">=0.80.0",
-		"@earendil-works/pi-coding-agent": ">=0.80.0",
-		"@earendil-works/pi-tui": ">=0.80.0"
-	},
-	"dependencies": {
-		"@sinclair/typebox": "^0.34.49",
-		"croner": "^10.0.1",
-		"nanoid": "^5.0.0"
-	},
-	"publishConfig": {
-		"access": "public"
-	},
-	"scripts": {
-		"build": "tsc",
-		"prepublishOnly": "npm run lint && npm run typecheck && npm run test && npm run build",
-		"test": "vitest run",
-		"test:watch": "vitest",
-		"test:e2e": "vitest run e2e --reporter=verbose",
-		"typecheck": "tsc --noEmit",
-		"lint": "biome check src/ test/",
-		"lint:fix": "biome check --fix src/ test/"
-	},
-	"devDependencies": {
-		"@biomejs/biome": "^2.4.14",
-		"@earendil-works/pi-ai": "^0.80.6",
-		"@earendil-works/pi-coding-agent": "^0.80.6",
-		"@earendil-works/pi-tui": "^0.80.6",
-		"@types/node": "^25.5.0",
-		"typescript": "^6.0.0",
-		"vitest": "^4.0.18"
-	},
-	"pi": {
-		"extensions": [
-			"./src/index.ts"
-		]
-	}
-}
+{
+	"name": "@ladbabynpm/picc-subagents",
+	"version": "0.1.2",
+	"description": "Claude Code style Agent tool for pi agent. Fork of tintinweb/pi-subagents, better aligned with the harness of Claude Code.",
+	"author": "ladbabynpm",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/ladbaby/picc-subagents.git"
+	},
+	"homepage": "https://github.com/ladbaby/picc-subagents#readme",
+	"bugs": {
+		"url": "https://github.com/ladbaby/picc-subagents/issues"
+	},
+	"keywords": [
+		"pi-package",
+		"pi",
+		"pi-extension",
+		"subagent",
+		"agent",
+		"autonomous"
+	],
+	"files": [
+		"src/",
+		"package.json",
+		"tsconfig.json",
+		"README.md",
+		"LICENSE",
+		"CHANGELOG.md",
+		"biome.json"
+	],
+	"peerDependencies": {
+		"@earendil-works/pi-ai": ">=0.80.0",
+		"@earendil-works/pi-coding-agent": ">=0.80.0",
+		"@earendil-works/pi-tui": ">=0.80.0",
+		"@sinclair/typebox": "*"
+	},
+	"dependencies": {
+		"croner": "^10.0.1",
+		"nanoid": "^5.0.0"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"scripts": {
+		"build": "tsc",
+		"prepublishOnly": "npm run lint && npm run typecheck && npm run test && npm run build",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"test:e2e": "vitest run e2e --reporter=verbose",
+		"typecheck": "tsc --noEmit",
+		"lint": "biome check src/ test/",
+		"lint:fix": "biome check --fix src/ test/"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^2.4.14",
+		"@earendil-works/pi-ai": "^0.80.6",
+		"@earendil-works/pi-coding-agent": "^0.80.6",
+		"@earendil-works/pi-tui": "^0.80.6",
+		"@types/node": "^25.5.0",
+		"typescript": "^6.0.0",
+		"vitest": "^4.0.18"
+	},
+	"pi": {
+		"extensions": [
+			"./src/index.ts"
+		]
+	}
+}

package/src/index.ts

@@ -1011,7 +1011,7 @@ Terse command-style prompts produce shallow, generic work.
 
       // Resolve model from agent config first; tool-call params only fill gaps.
       let model = ctx.model;
-      // Env-var override: PI_SUBAGENT_MODEL (fork) takes precedence over
+      // Env-var override: PICC_SUBAGENTS_MODEL (fork) takes precedence over
       // CLAUDE_CODE_SUBAGENT_MODEL (claude-code-compatible). When set, this is
       // authoritative — it overrides frontmatter `model:` pins and caller
       // `model:` params. Mirrors the `CLAUDE_CODE_SUBAGENT_MODEL` hook in

package/src/subagent-env.ts

@@ -7,12 +7,12 @@
  *   - `model:` parameters supplied to the `Agent` tool by the orchestrator
  *   - the parent thread's model (i.e. "inherit")
  *
- * Precedence: PI_SUBAGENT_MODEL (fork-specific) > CLAUDE_CODE_SUBAGENT_MODEL
+ * Precedence: PICC_SUBAGENTS_MODEL (fork-specific) > CLAUDE_CODE_SUBAGENT_MODEL
  * (claude-code-compatible) > undefined (caller falls through to existing
  * resolution in `agent-runner.ts` / `index.ts`).
  */
 
-export const PI_SUBAGENT_MODEL_ENV = "PI_SUBAGENT_MODEL";
+export const PICC_SUBAGENTS_MODEL_ENV = "PICC_SUBAGENTS_MODEL";
 export const CLAUDE_CODE_SUBAGENT_MODEL_ENV = "CLAUDE_CODE_SUBAGENT_MODEL";
 
 /**
@@ -27,7 +27,7 @@ export const CLAUDE_CODE_SUBAGENT_MODEL_ENV = "CLAUDE_CODE_SUBAGENT_MODEL";
  * @returns The env-var value, or `undefined` when neither is set.
  */
 export function pickSubagentEnvModel(): string | undefined {
-  const pi = process.env[PI_SUBAGENT_MODEL_ENV];
+  const pi = process.env[PICC_SUBAGENTS_MODEL_ENV];
   if (pi && pi.trim().length > 0) return pi.trim();
 
   const claude = process.env[CLAUDE_CODE_SUBAGENT_MODEL_ENV];
@@ -37,7 +37,7 @@ export function pickSubagentEnvModel(): string | undefined {
 }
 
 /**
- * Whether the resolved model came from an env var (PI_SUBAGENT_MODEL or
+ * Whether the resolved model came from an env var (PICC_SUBAGENTS_MODEL or
  * CLAUDE_CODE_SUBAGENT_MODEL). Useful for display-labeling and for skipping
  * scope-validation against the user's `enabledModels` allowlist, since the
  * user explicitly asked for this model via environment.
@@ -47,6 +47,6 @@ export function pickSubagentEnvModel(): string | undefined {
  */
 export function isEnvSourcedModel(rawInput: string | undefined): boolean {
   if (!rawInput) return false;
-  return rawInput === process.env[PI_SUBAGENT_MODEL_ENV]?.trim()
+  return rawInput === process.env[PICC_SUBAGENTS_MODEL_ENV]?.trim()
     || rawInput === process.env[CLAUDE_CODE_SUBAGENT_MODEL_ENV]?.trim();
 }