@esso0428/pi-subagents 0.17.6 → 0.17.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.
- package/CHANGELOG.md +9 -0
- package/CONTRIBUTING.md +4 -0
- package/dist/abortable.d.ts +13 -0
- package/dist/abortable.d.ts.map +1 -0
- package/dist/abortable.js +43 -0
- package/dist/abortable.js.map +1 -0
- package/dist/agent-color.d.ts +36 -0
- package/dist/agent-color.d.ts.map +1 -0
- package/dist/agent-color.js +124 -0
- package/dist/agent-color.js.map +1 -0
- package/dist/agent-file-toggle.d.ts +126 -0
- package/dist/agent-file-toggle.d.ts.map +1 -0
- package/dist/agent-file-toggle.js +259 -0
- package/dist/agent-file-toggle.js.map +1 -0
- package/dist/agent-history.d.ts +4 -0
- package/dist/agent-history.d.ts.map +1 -1
- package/dist/agent-history.js +47 -1
- package/dist/agent-history.js.map +1 -1
- package/dist/agent-manager.d.ts +370 -56
- package/dist/agent-manager.d.ts.map +1 -1
- package/dist/agent-manager.js +1123 -409
- package/dist/agent-manager.js.map +1 -1
- package/dist/agent-runner.d.ts +100 -10
- package/dist/agent-runner.d.ts.map +1 -1
- package/dist/agent-runner.js +166 -21
- package/dist/agent-runner.js.map +1 -1
- package/dist/agent-types.d.ts +57 -5
- package/dist/agent-types.d.ts.map +1 -1
- package/dist/agent-types.js +164 -32
- package/dist/agent-types.js.map +1 -1
- package/dist/child-context.d.ts +3 -0
- package/dist/child-context.d.ts.map +1 -0
- package/dist/child-context.js +13 -0
- package/dist/child-context.js.map +1 -0
- package/dist/cross-extension-rpc.d.ts +23 -3
- package/dist/cross-extension-rpc.d.ts.map +1 -1
- package/dist/cross-extension-rpc.js +79 -17
- package/dist/cross-extension-rpc.js.map +1 -1
- package/dist/custom-agents.d.ts +38 -1
- package/dist/custom-agents.d.ts.map +1 -1
- package/dist/custom-agents.js +164 -12
- package/dist/custom-agents.js.map +1 -1
- package/dist/index.d.ts +34 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1908 -495
- package/dist/index.js.map +1 -1
- package/dist/invocation-config.d.ts +87 -2
- package/dist/invocation-config.d.ts.map +1 -1
- package/dist/invocation-config.js +71 -3
- package/dist/invocation-config.js.map +1 -1
- package/dist/mention-clone.d.ts +88 -0
- package/dist/mention-clone.d.ts.map +1 -0
- package/dist/mention-clone.js +154 -0
- package/dist/mention-clone.js.map +1 -0
- package/dist/mention.d.ts +82 -0
- package/dist/mention.d.ts.map +1 -0
- package/dist/mention.js +132 -0
- package/dist/mention.js.map +1 -0
- package/dist/model-resolver.d.ts +17 -0
- package/dist/model-resolver.d.ts.map +1 -1
- package/dist/model-resolver.js +15 -0
- package/dist/model-resolver.js.map +1 -1
- package/dist/model-scope.d.ts +50 -0
- package/dist/model-scope.d.ts.map +1 -0
- package/dist/model-scope.js +49 -0
- package/dist/model-scope.js.map +1 -0
- package/dist/nested-tools.d.ts +57 -0
- package/dist/nested-tools.d.ts.map +1 -0
- package/dist/nested-tools.js +301 -0
- package/dist/nested-tools.js.map +1 -0
- package/dist/output-file.d.ts +22 -3
- package/dist/output-file.d.ts.map +1 -1
- package/dist/output-file.js +58 -7
- package/dist/output-file.js.map +1 -1
- package/dist/prompts.d.ts +23 -0
- package/dist/prompts.d.ts.map +1 -1
- package/dist/prompts.js +20 -2
- package/dist/prompts.js.map +1 -1
- package/dist/schedule.d.ts.map +1 -1
- package/dist/schedule.js +36 -15
- package/dist/schedule.js.map +1 -1
- package/dist/settings.d.ts +228 -2
- package/dist/settings.d.ts.map +1 -1
- package/dist/settings.js +94 -0
- package/dist/settings.js.map +1 -1
- package/dist/status-note.d.ts +49 -1
- package/dist/status-note.d.ts.map +1 -1
- package/dist/status-note.js +62 -1
- package/dist/status-note.js.map +1 -1
- package/dist/structured-output.d.ts +62 -0
- package/dist/structured-output.d.ts.map +1 -0
- package/dist/structured-output.js +113 -0
- package/dist/structured-output.js.map +1 -0
- package/dist/types.d.ts +176 -10
- package/dist/types.d.ts.map +1 -1
- package/dist/ui/agent-mention.d.ts +83 -0
- package/dist/ui/agent-mention.d.ts.map +1 -0
- package/dist/ui/agent-mention.js +188 -0
- package/dist/ui/agent-mention.js.map +1 -0
- package/dist/ui/agent-widget.d.ts +96 -75
- package/dist/ui/agent-widget.d.ts.map +1 -1
- package/dist/ui/agent-widget.js +397 -420
- package/dist/ui/agent-widget.js.map +1 -1
- package/dist/ui/conversation-blocks.d.ts.map +1 -1
- package/dist/ui/conversation-blocks.js +6 -0
- package/dist/ui/conversation-blocks.js.map +1 -1
- package/dist/ui/conversation-timeline.d.ts +10 -2
- package/dist/ui/conversation-timeline.d.ts.map +1 -1
- package/dist/ui/conversation-timeline.js +130 -23
- package/dist/ui/conversation-timeline.js.map +1 -1
- package/dist/ui/conversation-viewer.d.ts +15 -5
- package/dist/ui/conversation-viewer.d.ts.map +1 -1
- package/dist/ui/conversation-viewer.js +202 -50
- package/dist/ui/conversation-viewer.js.map +1 -1
- package/dist/ui/fleet-list.d.ts +198 -0
- package/dist/ui/fleet-list.d.ts.map +1 -0
- package/dist/ui/fleet-list.js +487 -0
- package/dist/ui/fleet-list.js.map +1 -0
- package/dist/ui/schedule-menu.d.ts.map +1 -1
- package/dist/ui/schedule-menu.js +6 -7
- package/dist/ui/schedule-menu.js.map +1 -1
- package/dist/ui/select-item.d.ts +28 -0
- package/dist/ui/select-item.d.ts.map +1 -0
- package/dist/ui/select-item.js +35 -0
- package/dist/ui/select-item.js.map +1 -0
- package/dist/ui/workflow-card.d.ts +176 -0
- package/dist/ui/workflow-card.d.ts.map +1 -0
- package/dist/ui/workflow-card.js +333 -0
- package/dist/ui/workflow-card.js.map +1 -0
- package/dist/ui/workflow-dialog.d.ts +306 -0
- package/dist/ui/workflow-dialog.d.ts.map +1 -0
- package/dist/ui/workflow-dialog.js +844 -0
- package/dist/ui/workflow-dialog.js.map +1 -0
- package/dist/ui/workflow-menu.d.ts +61 -0
- package/dist/ui/workflow-menu.d.ts.map +1 -0
- package/dist/ui/workflow-menu.js +148 -0
- package/dist/ui/workflow-menu.js.map +1 -0
- package/dist/usage.d.ts +86 -1
- package/dist/usage.d.ts.map +1 -1
- package/dist/usage.js +72 -1
- package/dist/usage.js.map +1 -1
- package/dist/workflow/collisions.d.ts +96 -0
- package/dist/workflow/collisions.d.ts.map +1 -0
- package/dist/workflow/collisions.js +89 -0
- package/dist/workflow/collisions.js.map +1 -0
- package/dist/workflow/entry.d.ts +33 -0
- package/dist/workflow/entry.d.ts.map +1 -0
- package/dist/workflow/entry.js +30 -0
- package/dist/workflow/entry.js.map +1 -0
- package/dist/workflow/host.d.ts +63 -0
- package/dist/workflow/host.d.ts.map +1 -0
- package/dist/workflow/host.js +363 -0
- package/dist/workflow/host.js.map +1 -0
- package/dist/workflow/journal.d.ts +98 -0
- package/dist/workflow/journal.d.ts.map +1 -0
- package/dist/workflow/journal.js +121 -0
- package/dist/workflow/journal.js.map +1 -0
- package/dist/workflow/json-schema.d.ts +52 -0
- package/dist/workflow/json-schema.d.ts.map +1 -0
- package/dist/workflow/json-schema.js +112 -0
- package/dist/workflow/json-schema.js.map +1 -0
- package/dist/workflow/meta.d.ts +68 -0
- package/dist/workflow/meta.d.ts.map +1 -0
- package/dist/workflow/meta.js +318 -0
- package/dist/workflow/meta.js.map +1 -0
- package/dist/workflow/progress.d.ts +225 -0
- package/dist/workflow/progress.d.ts.map +1 -0
- package/dist/workflow/progress.js +362 -0
- package/dist/workflow/progress.js.map +1 -0
- package/dist/workflow/runtime.d.ts +335 -0
- package/dist/workflow/runtime.d.ts.map +1 -0
- package/dist/workflow/runtime.js +831 -0
- package/dist/workflow/runtime.js.map +1 -0
- package/dist/workflow/saved.d.ts +91 -0
- package/dist/workflow/saved.d.ts.map +1 -0
- package/dist/workflow/saved.js +204 -0
- package/dist/workflow/saved.js.map +1 -0
- package/dist/workflow/task.d.ts +137 -0
- package/dist/workflow/task.d.ts.map +1 -0
- package/dist/workflow/task.js +208 -0
- package/dist/workflow/task.js.map +1 -0
- package/dist/workflow/tool-description.d.ts +39 -0
- package/dist/workflow/tool-description.d.ts.map +1 -0
- package/dist/workflow/tool-description.js +200 -0
- package/dist/workflow/tool-description.js.map +1 -0
- package/dist/workflow/worker-source.d.ts +48 -0
- package/dist/workflow/worker-source.d.ts.map +1 -0
- package/dist/workflow/worker-source.js +779 -0
- package/dist/workflow/worker-source.js.map +1 -0
- package/dist/worktree.d.ts +10 -3
- package/dist/worktree.d.ts.map +1 -1
- package/dist/worktree.js +58 -54
- package/dist/worktree.js.map +1 -1
- package/dist/xml.d.ts +11 -0
- package/dist/xml.d.ts.map +1 -0
- package/dist/xml.js +13 -0
- package/dist/xml.js.map +1 -0
- package/docs/rpc.md +183 -0
- package/docs/superpowers/plans/2026-09-30-upstream-event-workflow-partial-history.md +195 -0
- package/docs/superpowers/specs/2026-09-30-upstream-event-workflow-partial-history-design.md +49 -0
- package/docs/workflows.md +437 -0
- package/examples/agent-tool-description.md +7 -7
- package/examples/workflows/compose.js +51 -0
- package/examples/workflows/fan-out-audit.js +47 -0
- package/examples/workflows/gated-fix.js +60 -0
- package/examples/workflows/lib/count-child.js +27 -0
- package/examples/workflows/review-panel.js +63 -0
- package/examples/workflows/structured-findings.js +78 -0
- package/package.json +1 -1
- package/src/abortable.ts +43 -0
- package/src/agent-color.ts +161 -0
- package/src/agent-file-toggle.ts +269 -0
- package/src/agent-history.ts +54 -2
- package/src/agent-manager.ts +1263 -402
- package/src/agent-runner.ts +251 -27
- package/src/agent-types.ts +188 -32
- package/src/child-context.ts +15 -0
- package/src/cross-extension-rpc.ts +96 -20
- package/src/custom-agents.ts +170 -13
- package/src/index.ts +2024 -537
- package/src/invocation-config.ts +118 -3
- package/src/mention-clone.ts +196 -0
- package/src/mention.ts +141 -0
- package/src/model-resolver.ts +18 -0
- package/src/model-scope.ts +70 -0
- package/src/nested-tools.ts +424 -0
- package/src/output-file.ts +61 -6
- package/src/prompts.ts +45 -2
- package/src/schedule.ts +35 -14
- package/src/settings.ts +312 -2
- package/src/status-note.ts +66 -1
- package/src/structured-output.ts +130 -0
- package/src/types.ts +177 -10
- package/src/ui/agent-mention.ts +216 -0
- package/src/ui/agent-widget.ts +389 -441
- package/src/ui/conversation-blocks.ts +6 -0
- package/src/ui/conversation-timeline.ts +139 -25
- package/src/ui/conversation-viewer.ts +212 -48
- package/src/ui/fleet-list.ts +558 -0
- package/src/ui/schedule-menu.ts +9 -8
- package/src/ui/select-item.ts +45 -0
- package/src/ui/workflow-card.ts +470 -0
- package/src/ui/workflow-dialog.ts +1115 -0
- package/src/ui/workflow-menu.ts +193 -0
- package/src/usage.ts +109 -2
- package/src/workflow/collisions.ts +123 -0
- package/src/workflow/entry.ts +47 -0
- package/src/workflow/host.ts +403 -0
- package/src/workflow/journal.ts +164 -0
- package/src/workflow/json-schema.ts +128 -0
- package/src/workflow/meta.ts +325 -0
- package/src/workflow/progress.ts +550 -0
- package/src/workflow/runtime.ts +1219 -0
- package/src/workflow/saved.ts +217 -0
- package/src/workflow/task.ts +302 -0
- package/src/workflow/tool-description.ts +200 -0
- package/src/workflow/worker-source.ts +781 -0
- package/src/worktree.ts +69 -55
- package/src/xml.ts +13 -0
- package/vitest.config.ts +0 -18
|
@@ -0,0 +1,259 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* agent-file-toggle.ts — Pure helpers for the `/agents` file-editing operations:
|
|
3
|
+
* locating an agent's .md file, toggling its `enabled:` frontmatter flag, and
|
|
4
|
+
* serializing an AgentConfig back to frontmatter for eject.
|
|
5
|
+
*
|
|
6
|
+
* These live outside src/index.ts so they can be tested directly: the `/agents`
|
|
7
|
+
* command handler is an ~890-line closure reached only through `registerCommand`,
|
|
8
|
+
* which every test mocks.
|
|
9
|
+
*
|
|
10
|
+
* The read side of this data (src/custom-agents.ts) parses frontmatter with a
|
|
11
|
+
* real YAML parser, so it honors `enabled: false` at any position in the block.
|
|
12
|
+
* This module must agree with it, and splits the work accordingly:
|
|
13
|
+
*
|
|
14
|
+
* - Deciding whether a file is disabled is a *read*, so it calls that same parser
|
|
15
|
+
* (`isDisabledContent`) instead of mirroring it. A mirror has to be right about
|
|
16
|
+
* YAML's boolean spellings and about pi's fence scan, and a regex was wrong
|
|
17
|
+
* about both.
|
|
18
|
+
* - *Editing* cannot go through the parser, because re-serializing a parsed
|
|
19
|
+
* document would reformat a file the README tells users to hand-author —
|
|
20
|
+
* discarding their comments, key order, and quoting. So the edits are line-wise
|
|
21
|
+
* and preserve everything they don't touch.
|
|
22
|
+
*
|
|
23
|
+
* That leaves removal best-effort: it recognizes a lowercase bare `false`, and
|
|
24
|
+
* reports `changed: false` for the spellings it cannot rewrite, so the caller
|
|
25
|
+
* refuses honestly rather than announcing a change it did not make.
|
|
26
|
+
*/
|
|
27
|
+
import { existsSync } from "node:fs";
|
|
28
|
+
import { join, sep } from "node:path";
|
|
29
|
+
import { getAgentDir } from "@earendil-works/pi-coding-agent";
|
|
30
|
+
import { parseAgentFrontmatter } from "./custom-agents.js";
|
|
31
|
+
export const projectAgentsDir = (cwd = process.cwd()) => join(cwd, ".pi", "agents");
|
|
32
|
+
export const workspaceAgentsDir = (cwd = process.cwd()) => join(cwd, ".agents", "agents");
|
|
33
|
+
export const personalAgentsDir = () => join(getAgentDir(), "agents");
|
|
34
|
+
/**
|
|
35
|
+
* Find the file path of a custom agent by name, in discovery-precedence order
|
|
36
|
+
* (project, workspace, then global). Mirrors the load-side precedence in
|
|
37
|
+
* src/custom-agents.ts — if the two drift, `/agents` edits a file the loader
|
|
38
|
+
* isn't reading.
|
|
39
|
+
*/
|
|
40
|
+
export function findAgentFile(name, cwd = process.cwd()) {
|
|
41
|
+
const projectPath = join(projectAgentsDir(cwd), `${name}.md`);
|
|
42
|
+
if (existsSync(projectPath))
|
|
43
|
+
return { path: projectPath, location: "project" };
|
|
44
|
+
const workspacePath = join(workspaceAgentsDir(cwd), `${name}.md`);
|
|
45
|
+
if (existsSync(workspacePath))
|
|
46
|
+
return { path: workspacePath, location: "workspace" };
|
|
47
|
+
const personalPath = join(personalAgentsDir(), `${name}.md`);
|
|
48
|
+
if (existsSync(personalPath))
|
|
49
|
+
return { path: personalPath, location: "personal" };
|
|
50
|
+
return undefined;
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
* Find the file behind a *loaded* agent, preferring the path the loader
|
|
54
|
+
* actually read (`AgentConfig.sourcePath`) over the `<type>.md` guess.
|
|
55
|
+
*
|
|
56
|
+
* An agent's type comes from its frontmatter `name:` now, so the two can
|
|
57
|
+
* disagree: `reviewer.md` declaring `name: code-reviewer` is loaded as
|
|
58
|
+
* `code-reviewer`, and probing for `code-reviewer.md` finds nothing. That is
|
|
59
|
+
* not a harmless miss — `/agents → Disable` would then take the no-file branch
|
|
60
|
+
* and write a NEW `code-reviewer.md` stub, which loses to `reviewer.md` on
|
|
61
|
+
* load, leaving the agent enabled while reporting success.
|
|
62
|
+
*
|
|
63
|
+
* The probe stays as the fallback: a built-in that was never ejected has no
|
|
64
|
+
* `sourcePath`, and a path can go stale between a load and this call.
|
|
65
|
+
*/
|
|
66
|
+
export function locateAgentFile(name, sourcePath, cwd = process.cwd()) {
|
|
67
|
+
if (sourcePath && existsSync(sourcePath)) {
|
|
68
|
+
return { path: sourcePath, location: classifyAgentDir(sourcePath, cwd) };
|
|
69
|
+
}
|
|
70
|
+
return findAgentFile(name, cwd);
|
|
71
|
+
}
|
|
72
|
+
/**
|
|
73
|
+
* Which discovery location a loaded agent's file came from. Only ever names
|
|
74
|
+
* a directory in a confirmation prompt, so an unrecognized parent — which
|
|
75
|
+
* loadCustomAgents cannot currently produce — reports as personal rather than
|
|
76
|
+
* widening the type for a case that has no better answer.
|
|
77
|
+
*/
|
|
78
|
+
function classifyAgentDir(path, cwd) {
|
|
79
|
+
if (path.startsWith(projectAgentsDir(cwd) + sep))
|
|
80
|
+
return "project";
|
|
81
|
+
if (path.startsWith(workspaceAgentsDir(cwd) + sep))
|
|
82
|
+
return "workspace";
|
|
83
|
+
return "personal";
|
|
84
|
+
}
|
|
85
|
+
/** A line that sets `enabled: false`, ignoring trailing whitespace / CR. */
|
|
86
|
+
const ENABLED_FALSE = /^enabled:[ \t]*false[ \t]*$/;
|
|
87
|
+
/** An opening or closing `---` fence line. */
|
|
88
|
+
const FENCE = /^---[ \t]*$/;
|
|
89
|
+
/**
|
|
90
|
+
* Split a file into its frontmatter lines and everything else, agreeing with
|
|
91
|
+
* what `parseAgentFrontmatter` (the load side) considers a frontmatter block —
|
|
92
|
+
* including its BOM normalisation, which is why the fence test looks past one.
|
|
93
|
+
* The BOM itself stays in `lines[0]`: it belongs to the file's encoding, not to
|
|
94
|
+
* the block, and an edit must not strip it from the user's file.
|
|
95
|
+
*
|
|
96
|
+
* Lines keep their terminators, so an edit preserves the file's existing line
|
|
97
|
+
* endings instead of rewriting CRLF to LF. Returns undefined when there is no
|
|
98
|
+
* usable block.
|
|
99
|
+
*/
|
|
100
|
+
function splitFrontmatter(content) {
|
|
101
|
+
const lines = content.split(/(?<=\n)/);
|
|
102
|
+
if (lines.length === 0)
|
|
103
|
+
return undefined;
|
|
104
|
+
// The BOM stays where it is — it belongs to the file, not the block — so the
|
|
105
|
+
// fence test looks past it and every index below is unaffected.
|
|
106
|
+
const bom = content.startsWith("\uFEFF");
|
|
107
|
+
const first = (bom ? lines[0].slice(1) : lines[0]).replace(/\r?\n$/, "");
|
|
108
|
+
if (!FENCE.test(first))
|
|
109
|
+
return undefined;
|
|
110
|
+
const closeIdx = lines.findIndex((l, i) => i > 0 && FENCE.test(l.replace(/\r?\n$/, "")));
|
|
111
|
+
if (closeIdx === -1)
|
|
112
|
+
return undefined;
|
|
113
|
+
return { lines, openIdx: 0, closeIdx, eol: lines[0].endsWith("\r\n") ? "\r\n" : "\n" };
|
|
114
|
+
}
|
|
115
|
+
/**
|
|
116
|
+
* Does the loader consider this file disabled?
|
|
117
|
+
*
|
|
118
|
+
* Detection is a READ operation, so it asks the same parser the loader uses
|
|
119
|
+
* rather than mirroring it with a regex — that mirror has to be right about
|
|
120
|
+
* YAML's boolean spellings (`False`, `FALSE`, a trailing `# comment`, a quoted
|
|
121
|
+
* key) *and* about pi's fence scan, which closes the block on any line starting
|
|
122
|
+
* `---` and so ends it early on `----`. A throw means the file is already
|
|
123
|
+
* unparseable, which is what the loader sees too: it skips the agent, so there
|
|
124
|
+
* is no "disabled" state to report.
|
|
125
|
+
*/
|
|
126
|
+
export function isDisabledContent(content) {
|
|
127
|
+
try {
|
|
128
|
+
return parseAgentFrontmatter(content).frontmatter.enabled === false;
|
|
129
|
+
}
|
|
130
|
+
catch {
|
|
131
|
+
return false;
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
/**
|
|
135
|
+
* Add `enabled: false` to a file's frontmatter.
|
|
136
|
+
*
|
|
137
|
+
* `outcome` distinguishes a real edit from a no-op so the caller can report
|
|
138
|
+
* honestly instead of unconditionally claiming success.
|
|
139
|
+
*/
|
|
140
|
+
export function disableInContent(content) {
|
|
141
|
+
const block = splitFrontmatter(content);
|
|
142
|
+
if (!block)
|
|
143
|
+
return { content, outcome: "no-frontmatter" };
|
|
144
|
+
if (isDisabledContent(content))
|
|
145
|
+
return { content, outcome: "already-disabled" };
|
|
146
|
+
const lines = [...block.lines];
|
|
147
|
+
lines.splice(1, 0, `enabled: false${block.eol}`);
|
|
148
|
+
return { content: lines.join(""), outcome: "disabled" };
|
|
149
|
+
}
|
|
150
|
+
/**
|
|
151
|
+
* Remove `enabled: false` from a file's frontmatter, wherever it appears in the
|
|
152
|
+
* block — the loader honors the key at any position, so the two must agree or a
|
|
153
|
+
* hand-authored agent can be disabled and never re-enabled.
|
|
154
|
+
*
|
|
155
|
+
* `changed` is false when the key wasn't found, so the caller can avoid
|
|
156
|
+
* reporting "Enabled <name>" for a write that did nothing.
|
|
157
|
+
*/
|
|
158
|
+
export function enableInContent(content) {
|
|
159
|
+
const block = splitFrontmatter(content);
|
|
160
|
+
if (!block)
|
|
161
|
+
return { content, changed: false };
|
|
162
|
+
const kept = block.lines.filter((l, i) => !(i > 0 && i < block.closeIdx && ENABLED_FALSE.test(l.replace(/\r?\n$/, ""))));
|
|
163
|
+
if (kept.length === block.lines.length)
|
|
164
|
+
return { content, changed: false };
|
|
165
|
+
return { content: kept.join(""), changed: true };
|
|
166
|
+
}
|
|
167
|
+
/** Is this the empty stub `/agents` writes when disabling a built-in default? */
|
|
168
|
+
export function isEmptyStub(content) {
|
|
169
|
+
return content.replace(/\r\n/g, "\n").trim() === "---\n---";
|
|
170
|
+
}
|
|
171
|
+
/**
|
|
172
|
+
* Build the .md file the create wizard writes.
|
|
173
|
+
*
|
|
174
|
+
* `description` and `model` come straight from a free-text prompt, so they are
|
|
175
|
+
* quoted rather than interpolated — `serializeAgentFile` above quotes the
|
|
176
|
+
* description for the same reason. An unquoted YAML scalar mishandles ordinary
|
|
177
|
+
* input in two ways, and both are silent: a colon ("Scout: find things") makes
|
|
178
|
+
* the file unparseable, and since #212 an unparseable agent file is *skipped*,
|
|
179
|
+
* so the wizard reports success for an agent that does not exist; a `#`
|
|
180
|
+
* ("audit #security") opens a comment and truncates the value. `model` can
|
|
181
|
+
* carry a colon too — pi accepts a `provider/model:thinking` suffix.
|
|
182
|
+
*
|
|
183
|
+
* `tools` and `thinking` are not quoted: both are chosen from fixed menus, and
|
|
184
|
+
* `tools` is a CSV that must stay a bare scalar for the loader's parser.
|
|
185
|
+
*/
|
|
186
|
+
export function buildNewAgentFile(input) {
|
|
187
|
+
const modelLine = input.model ? `\nmodel: ${JSON.stringify(input.model)}` : "";
|
|
188
|
+
const thinkingLine = input.thinking ? `\nthinking: ${input.thinking}` : "";
|
|
189
|
+
return `---
|
|
190
|
+
description: ${JSON.stringify(input.description)}
|
|
191
|
+
tools: ${input.tools}${modelLine}${thinkingLine}
|
|
192
|
+
prompt_mode: replace
|
|
193
|
+
---
|
|
194
|
+
|
|
195
|
+
${input.systemPrompt}
|
|
196
|
+
`;
|
|
197
|
+
}
|
|
198
|
+
/** Render a built-in tool list as a `tools:` frontmatter value. */
|
|
199
|
+
function formatToolsField(tools) {
|
|
200
|
+
if (tools === undefined)
|
|
201
|
+
return "all";
|
|
202
|
+
if (tools.length === 0)
|
|
203
|
+
return "none";
|
|
204
|
+
return tools.join(", ");
|
|
205
|
+
}
|
|
206
|
+
/** Serialize an AgentConfig to a full .md file (frontmatter + system prompt) for eject. */
|
|
207
|
+
export function serializeAgentFile(cfg) {
|
|
208
|
+
const fmFields = [];
|
|
209
|
+
fmFields.push(`description: ${JSON.stringify(cfg.description)}`);
|
|
210
|
+
if (cfg.displayName)
|
|
211
|
+
fmFields.push(`display_name: ${cfg.displayName}`);
|
|
212
|
+
if (cfg.color)
|
|
213
|
+
fmFields.push(`color: ${JSON.stringify(cfg.color)}`);
|
|
214
|
+
// Absent means "all built-ins"; an EMPTY list means explicitly zero. Writing
|
|
215
|
+
// `all` for both would hand a deliberately tool-less agent the whole toolbox
|
|
216
|
+
// the first time it is ejected.
|
|
217
|
+
fmFields.push(`tools: ${formatToolsField(cfg.builtinToolNames)}`);
|
|
218
|
+
if (cfg.model)
|
|
219
|
+
fmFields.push(`model: ${cfg.model}`);
|
|
220
|
+
if (cfg.thinking)
|
|
221
|
+
fmFields.push(`thinking: ${cfg.thinking}`);
|
|
222
|
+
if (cfg.maxTurns)
|
|
223
|
+
fmFields.push(`max_turns: ${cfg.maxTurns}`);
|
|
224
|
+
if (cfg.allowedSubagents !== undefined) {
|
|
225
|
+
fmFields.push(`allowed_subagents: ${cfg.allowedSubagents === "all" ? "all" : cfg.allowedSubagents.join(", ")}`);
|
|
226
|
+
}
|
|
227
|
+
fmFields.push(`prompt_mode: ${cfg.promptMode}`);
|
|
228
|
+
if (cfg.extensions === false)
|
|
229
|
+
fmFields.push("extensions: false");
|
|
230
|
+
else if (Array.isArray(cfg.extensions))
|
|
231
|
+
fmFields.push(`extensions: ${cfg.extensions.join(", ")}`);
|
|
232
|
+
if (cfg.excludeExtensions?.length)
|
|
233
|
+
fmFields.push(`exclude_extensions: ${cfg.excludeExtensions.join(", ")}`);
|
|
234
|
+
if (cfg.skills === false)
|
|
235
|
+
fmFields.push("skills: false");
|
|
236
|
+
else if (Array.isArray(cfg.skills))
|
|
237
|
+
fmFields.push(`skills: ${cfg.skills.join(", ")}`);
|
|
238
|
+
if (cfg.disallowedTools?.length)
|
|
239
|
+
fmFields.push(`disallowed_tools: ${cfg.disallowedTools.join(", ")}`);
|
|
240
|
+
if (cfg.inheritContext)
|
|
241
|
+
fmFields.push("inherit_context: true");
|
|
242
|
+
// Both cases, not just `true`: with `backgroundByDefault` on, omitting the
|
|
243
|
+
// field means background, so `false` is the only way to pin an agent file to
|
|
244
|
+
// foreground and is no longer interchangeable with absence. No caller can
|
|
245
|
+
// reach it yet — Eject only handles built-in defaults, which omit the field —
|
|
246
|
+
// so this keeps the writer symmetric with the loader, nothing more.
|
|
247
|
+
if (cfg.runInBackground !== undefined)
|
|
248
|
+
fmFields.push(`run_in_background: ${cfg.runInBackground}`);
|
|
249
|
+
if (cfg.outputTranscript === false)
|
|
250
|
+
fmFields.push("output_transcript: false");
|
|
251
|
+
if (cfg.isolated)
|
|
252
|
+
fmFields.push("isolated: true");
|
|
253
|
+
if (cfg.memory)
|
|
254
|
+
fmFields.push(`memory: ${cfg.memory}`);
|
|
255
|
+
if (cfg.isolation)
|
|
256
|
+
fmFields.push(`isolation: ${cfg.isolation}`);
|
|
257
|
+
return `---\n${fmFields.join("\n")}\n---\n\n${cfg.systemPrompt}\n`;
|
|
258
|
+
}
|
|
259
|
+
//# sourceMappingURL=agent-file-toggle.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"agent-file-toggle.js","sourceRoot":"","sources":["../src/agent-file-toggle.ts"],"names":[],"mappings":"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"}
|
package/dist/agent-history.d.ts
CHANGED
|
@@ -12,6 +12,10 @@ export declare function ensureSubagentsGitignore(cwd: string): string;
|
|
|
12
12
|
export declare function createAgentHistoryPath(cwd: string, agentId: string): string;
|
|
13
13
|
/** Return the project-relative path stored in the parent session record. */
|
|
14
14
|
export declare function agentHistoryLocator(cwd: string, historyPath: string): string;
|
|
15
|
+
/** Write the first user prompt without involving the optional `.output` file. */
|
|
16
|
+
export declare function writeAgentHistoryInitialEntry(path: string, agentId: string, prompt: string, cwd: string): void;
|
|
17
|
+
/** Stream every new session message to the mandatory durable history file. */
|
|
18
|
+
export declare function streamAgentHistory(session: AgentSession, path: string, agentId: string, cwd: string, startIndex?: number): () => void;
|
|
15
19
|
/** Resolve only paths in this package's project-local transcript namespace. */
|
|
16
20
|
export declare function resolveAgentHistoryPath(cwd: string, locator: string): string | undefined;
|
|
17
21
|
/** Return true only when a valid project-local transcript file exists. */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agent-history.d.ts","sourceRoot":"","sources":["../src/agent-history.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAI/D,OAAO,KAAK,EAAE,YAAY,
|
|
1
|
+
{"version":3,"file":"agent-history.d.ts","sourceRoot":"","sources":["../src/agent-history.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAI/D,OAAO,KAAK,EAAE,YAAY,EAAqB,MAAM,iCAAiC,CAAC;AAMvF;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAe5D;AAED,uDAAuD;AACvD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAM3E;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAE5E;AAaD,iFAAiF;AACjF,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAG9G;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,UAAU,SAAI,GACb,MAAM,IAAI,CA0BZ;AAED,+EAA+E;AAC/E,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWxF;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAIjF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,CAAC,UAAU,CAAC,GAAG,SAAS,CA2BnG;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA+BvF"}
|
package/dist/agent-history.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/** Durable, project-local transcript storage for subagents. */
|
|
2
|
-
import { appendFileSync, existsSync, mkdirSync, readFileSync } from "node:fs";
|
|
2
|
+
import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
|
|
3
3
|
import { isAbsolute, join, relative, resolve, sep } from "node:path";
|
|
4
4
|
const SUBAGENTS_DIR = ".pi-subagents";
|
|
5
5
|
const TRANSCRIPTS_DIR = "agent-transcripts";
|
|
@@ -40,6 +40,52 @@ export function createAgentHistoryPath(cwd, agentId) {
|
|
|
40
40
|
export function agentHistoryLocator(cwd, historyPath) {
|
|
41
41
|
return relative(cwd, historyPath).split(sep).join("/");
|
|
42
42
|
}
|
|
43
|
+
function historyEntry(agentId, message, cwd) {
|
|
44
|
+
return JSON.stringify({
|
|
45
|
+
isSidechain: true,
|
|
46
|
+
agentId,
|
|
47
|
+
type: message.role === "assistant" ? "assistant" : message.role === "user" ? "user" : "toolResult",
|
|
48
|
+
message,
|
|
49
|
+
timestamp: new Date().toISOString(),
|
|
50
|
+
cwd,
|
|
51
|
+
}) + "\n";
|
|
52
|
+
}
|
|
53
|
+
/** Write the first user prompt without involving the optional `.output` file. */
|
|
54
|
+
export function writeAgentHistoryInitialEntry(path, agentId, prompt, cwd) {
|
|
55
|
+
if (existsSync(path))
|
|
56
|
+
return;
|
|
57
|
+
writeFileSync(path, historyEntry(agentId, { role: "user", content: prompt }, cwd), "utf8");
|
|
58
|
+
}
|
|
59
|
+
/** Stream every new session message to the mandatory durable history file. */
|
|
60
|
+
export function streamAgentHistory(session, path, agentId, cwd, startIndex = 1) {
|
|
61
|
+
let writtenCount = startIndex;
|
|
62
|
+
const messages = () => Array.isArray(session.messages) ? session.messages : [];
|
|
63
|
+
const flush = () => {
|
|
64
|
+
const currentMessages = messages();
|
|
65
|
+
while (writtenCount < currentMessages.length) {
|
|
66
|
+
try {
|
|
67
|
+
appendFileSync(path, historyEntry(agentId, currentMessages[writtenCount], cwd), "utf8");
|
|
68
|
+
}
|
|
69
|
+
catch {
|
|
70
|
+
// A read-only project must not turn a model event into a failed run.
|
|
71
|
+
}
|
|
72
|
+
writtenCount++;
|
|
73
|
+
}
|
|
74
|
+
};
|
|
75
|
+
const unsubscribe = typeof session.subscribe === "function"
|
|
76
|
+
? session.subscribe((event) => {
|
|
77
|
+
if (event.type === "turn_end" || event.type === "compaction_start")
|
|
78
|
+
flush();
|
|
79
|
+
if (event.type === "compaction_end" && !event.aborted && event.result) {
|
|
80
|
+
queueMicrotask(() => { writtenCount = messages().length; });
|
|
81
|
+
}
|
|
82
|
+
})
|
|
83
|
+
: () => { };
|
|
84
|
+
return () => {
|
|
85
|
+
flush();
|
|
86
|
+
unsubscribe();
|
|
87
|
+
};
|
|
88
|
+
}
|
|
43
89
|
/** Resolve only paths in this package's project-local transcript namespace. */
|
|
44
90
|
export function resolveAgentHistoryPath(cwd, locator) {
|
|
45
91
|
// Locators are persisted data, not arbitrary paths. Reject traversal syntax
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agent-history.js","sourceRoot":"","sources":["../src/agent-history.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAE/D,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;
|
|
1
|
+
{"version":3,"file":"agent-history.js","sourceRoot":"","sources":["../src/agent-history.ts"],"names":[],"mappings":"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"}
|