@pi-unipi/unipi 3.0.0-alpha.2 → 3.0.0-alpha.21
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 +292 -0
- package/README.md +8 -11
- package/docs/prefix-cache-architecture.md +14 -0
- package/package.json +22 -24
- package/packages/ask-user/README.md +55 -107
- package/packages/ask-user/ask-ui.ts +306 -732
- package/packages/ask-user/clipboard.ts +50 -0
- package/packages/ask-user/config.ts +74 -78
- package/packages/ask-user/package.json +2 -2
- package/packages/ask-user/questions.ts +151 -0
- package/packages/ask-user/skills/ask-user/SKILL.md +59 -133
- package/packages/ask-user/tools.ts +198 -432
- package/packages/autocomplete/package.json +1 -1
- package/packages/autocomplete/src/constants.ts +38 -43
- package/packages/autocomplete/src/sorting.ts +8 -0
- package/packages/background-tasks/package.json +2 -2
- package/packages/background-tasks/src/config.ts +0 -73
- package/packages/background-tasks/src/index.ts +20 -16
- package/packages/background-tasks/src/registry.ts +1 -171
- package/packages/background-tasks/src/types.ts +0 -32
- package/packages/btw/README.md +13 -56
- package/packages/btw/extensions/btw.ts +403 -1796
- package/packages/btw/package.json +5 -2
- package/packages/btw/skills/btw/SKILL.md +7 -143
- package/packages/compactor/README.md +56 -287
- package/packages/compactor/package.json +5 -9
- package/packages/compactor/skills/compactor/SKILL.md +13 -20
- package/packages/compactor/src/card.ts +90 -0
- package/packages/compactor/src/commands/index.ts +73 -130
- package/packages/compactor/src/compaction/compact-args.ts +5 -3
- package/packages/compactor/src/compaction/filter-noise.ts +1 -1
- package/packages/compactor/src/compaction/hooks.ts +487 -311
- package/packages/compactor/src/compaction/source.ts +178 -0
- package/packages/compactor/src/compaction/summarize.ts +586 -52
- package/packages/compactor/src/config/manager.ts +130 -127
- package/packages/compactor/src/config/schema.ts +32 -48
- package/packages/compactor/src/index.ts +40 -431
- package/packages/compactor/src/info-screen.ts +44 -190
- package/packages/compactor/src/session/recall-blocks.ts +1 -1
- package/packages/compactor/src/stats.ts +76 -0
- package/packages/compactor/src/tools/context-budget.ts +17 -34
- package/packages/compactor/src/tools/ctx-doctor.ts +45 -36
- package/packages/compactor/src/tools/register.ts +29 -269
- package/packages/compactor/src/types.ts +47 -186
- package/packages/core/README.md +25 -0
- package/packages/core/child-agent.ts +1 -0
- package/packages/core/command-echo.ts +63 -0
- package/packages/core/compaction-context.ts +41 -0
- package/packages/core/constants.ts +8 -38
- package/packages/core/events.ts +0 -53
- package/packages/core/fusion-status.ts +4 -0
- package/packages/core/global.d.ts +10 -0
- package/packages/core/harness-messages.ts +392 -0
- package/packages/core/index.ts +14 -0
- package/packages/core/kanboard-status.ts +49 -0
- package/packages/core/long-horizon-owner-status.ts +46 -0
- package/packages/core/model-cache.ts +81 -7
- package/packages/core/package.json +6 -3
- package/packages/core/src/attach/detect.ts +163 -0
- package/packages/core/src/child-agent/child-args.ts +31 -0
- package/packages/core/src/child-agent/delivery.ts +41 -0
- package/packages/core/src/child-agent/index.ts +5 -0
- package/packages/core/src/child-agent/readers.ts +203 -0
- package/packages/core/src/child-agent/runtime.ts +584 -0
- package/packages/core/src/evidence.ts +78 -0
- package/packages/core/src/hints/browser.ts +278 -0
- package/packages/core/src/hints/crab-data.ts +19 -0
- package/packages/core/src/hints/index.ts +865 -0
- package/packages/core/src/hints/lines.ts +607 -0
- package/packages/core/src/hints/store.ts +120 -0
- package/packages/core/src/jev/chatter.ts +24 -0
- package/packages/core/src/jev/settings.ts +177 -14
- package/packages/core/src/package-colors.ts +2 -0
- package/packages/core/src/settings/catalog.ts +39 -15
- package/packages/core/src/settings/engine.ts +48 -2
- package/packages/core/src/settings/hub.ts +83 -20
- package/packages/core/src/settings/open.ts +49 -0
- package/packages/core/src/settings/schema.ts +27 -7
- package/packages/core/src/tui/hub-kit.ts +18 -5
- package/packages/core/src/tui/kit.ts +198 -0
- package/packages/core/src/tui/progress.ts +73 -0
- package/packages/core/src/turn/arbiter.ts +290 -0
- package/packages/footer/README.md +4 -6
- package/packages/footer/package.json +3 -3
- package/packages/footer/src/glance-editor.ts +19 -11
- package/packages/footer/src/help.ts +1 -1
- package/packages/footer/src/index.ts +36 -3
- package/packages/footer/src/presets.ts +3 -4
- package/packages/footer/src/rendering/icons.ts +0 -20
- package/packages/footer/src/segments/compactor.ts +52 -142
- package/packages/footer/src/segments/status-ext.ts +0 -1
- package/packages/fusion/README.md +14 -4
- package/packages/fusion/package.json +4 -3
- package/packages/fusion/src/child-args.ts +1 -0
- package/packages/fusion/src/index.ts +161 -8
- package/packages/fusion/src/pi-settings.ts +57 -0
- package/packages/fusion/src/picker.ts +186 -51
- package/packages/fusion/src/preset.ts +56 -2
- package/packages/fusion/src/prompts.ts +1 -1
- package/packages/fusion/src/sidekick-runtime.ts +1 -420
- package/packages/fusion/src/tools.ts +107 -128
- package/packages/fusion/src/transcript.ts +27 -85
- package/packages/info-screen/package.json +2 -2
- package/packages/input-shortcuts/README.md +18 -30
- package/packages/input-shortcuts/package.json +2 -2
- package/packages/input-shortcuts/src/burst.ts +88 -0
- package/packages/input-shortcuts/src/chord-overlay.ts +20 -70
- package/packages/input-shortcuts/src/cleared-input.ts +97 -0
- package/packages/input-shortcuts/src/index.ts +99 -193
- package/packages/input-shortcuts/src/last-response.ts +40 -0
- package/packages/input-shortcuts/src/registers.ts +8 -23
- package/packages/input-shortcuts/src/types.ts +4 -16
- package/packages/input-shortcuts/src/undo-redo.ts +59 -47
- package/packages/kanboard/README.md +51 -47
- package/packages/kanboard/index.ts +293 -55
- package/packages/kanboard/package.json +8 -8
- package/packages/kanboard/skills/kanboard/SKILL.md +61 -27
- package/packages/kanboard/src/badges.ts +93 -0
- package/packages/kanboard/src/bin.ts +4 -2
- package/packages/kanboard/src/commands.ts +218 -84
- package/packages/kanboard/src/debug.ts +20 -0
- package/packages/kanboard/src/guard.ts +267 -109
- package/packages/kanboard/src/monitor.ts +330 -0
- package/packages/kanboard/src/notice-buffer.ts +74 -0
- package/packages/kanboard/src/progress.ts +27 -0
- package/packages/kanboard/src/reminders.ts +234 -0
- package/packages/kanboard/src/settings.ts +69 -15
- package/packages/kanboard/src/shapes.ts +5 -0
- package/packages/long-horizon/index.ts +190 -13
- package/packages/long-horizon/package.json +3 -3
- package/packages/long-horizon/src/commands.ts +103 -7
- package/packages/long-horizon/src/compaction-brief.ts +35 -0
- package/packages/long-horizon/src/engine/continuation.ts +84 -15
- package/packages/long-horizon/src/engine/goal-state.ts +64 -13
- package/packages/long-horizon/src/engine/nudge-stash.ts +71 -0
- package/packages/long-horizon/src/engine/ralph.ts +3 -2
- package/packages/long-horizon/src/engine/runaway.ts +68 -11
- package/packages/long-horizon/src/engine/verifier.ts +19 -0
- package/packages/long-horizon/src/gate.ts +37 -12
- package/packages/long-horizon/src/judge/resolve.ts +1 -0
- package/packages/long-horizon/src/owner.ts +35 -2
- package/packages/long-horizon/src/progress.ts +87 -0
- package/packages/long-horizon/src/prompts/goal.ts +1 -1
- package/packages/long-horizon/src/runtime.ts +172 -18
- package/packages/long-horizon/src/settings.ts +54 -39
- package/packages/long-horizon/src/tools/goal.ts +6 -0
- package/packages/long-horizon/src/tools/graph.ts +1 -1
- package/packages/long-horizon/src/tools/swarm.ts +3 -3
- package/packages/mcp/package.json +2 -2
- package/packages/memory/commands.ts +7 -2
- package/packages/memory/index.ts +210 -32
- package/packages/memory/package.json +3 -3
- package/packages/memory/save-session.ts +264 -0
- package/packages/memory/settings.ts +17 -0
- package/packages/memory/tools.ts +253 -203
- package/packages/notify/package.json +2 -2
- package/packages/skill-registry/README.md +53 -16
- package/packages/skill-registry/index.ts +230 -0
- package/packages/skill-registry/package.json +19 -8
- package/packages/skill-registry/src/editor.ts +206 -0
- package/packages/skill-registry/src/judge.ts +289 -0
- package/packages/skill-registry/src/registry.ts +87 -0
- package/packages/skill-registry/src/settings.ts +259 -0
- package/packages/skill-registry/src/vault.ts +80 -0
- package/packages/subagents/README.md +39 -119
- package/packages/subagents/package.json +6 -13
- package/packages/subagents/skills/subagents/SKILL.md +18 -42
- package/packages/subagents/src/agents.ts +213 -0
- package/packages/subagents/src/cards.ts +182 -0
- package/packages/subagents/src/index.ts +609 -1084
- package/packages/subagents/src/manager.ts +429 -0
- package/packages/subagents/src/profiles.ts +130 -0
- package/packages/subagents/src/transcript.ts +154 -0
- package/packages/subagents/src/ui.ts +389 -0
- package/packages/unipi/bundled.js +39756 -45569
- package/packages/unipi/index.ts +55 -10
- package/packages/updater/package.json +2 -2
- package/packages/utility/README.md +76 -69
- package/packages/utility/package.json +2 -2
- package/packages/utility/skills/image/SKILL.md +37 -0
- package/packages/utility/skills/utility/SKILL.md +17 -60
- package/packages/utility/src/answer/extract.ts +128 -0
- package/packages/utility/src/answer/index.ts +213 -0
- package/packages/utility/src/answer/reply.ts +133 -0
- package/packages/utility/src/answer/web.ts +167 -0
- package/packages/utility/src/attach/index.ts +205 -0
- package/packages/utility/src/commands.ts +38 -142
- package/packages/utility/src/diagnostics/engine.ts +50 -5
- package/packages/utility/src/image/index.ts +33 -0
- package/packages/utility/src/image/models.ts +221 -0
- package/packages/{image/src → utility/src/image}/recognize.ts +2 -2
- package/packages/utility/src/image/settings.ts +178 -0
- package/packages/{image/src/image-source.ts → utility/src/image/source.ts} +1 -1
- package/packages/utility/src/image/tools.ts +168 -0
- package/packages/utility/src/image/transports.ts +186 -0
- package/packages/utility/src/index.ts +68 -389
- package/packages/utility/src/lifecycle/cleanup.ts +116 -311
- package/packages/utility/src/rename/gate.ts +102 -0
- package/packages/utility/src/rename/index.ts +191 -0
- package/packages/utility/src/rename/session.ts +170 -0
- package/packages/utility/src/render/delegated.ts +285 -0
- package/packages/utility/src/render/harness.ts +683 -0
- package/packages/utility/src/render/parse.ts +156 -0
- package/packages/utility/src/render/pi-settings.ts +38 -0
- package/packages/utility/src/render/reply-bg.ts +307 -0
- package/packages/utility/src/render/simple.ts +724 -0
- package/packages/utility/src/render/spacing.ts +235 -0
- package/packages/utility/src/render/styled.ts +251 -0
- package/packages/utility/src/render/tools.ts +353 -0
- package/packages/utility/src/settings.ts +166 -233
- package/packages/utility/src/types.ts +1 -222
- package/packages/watchdog/index.ts +17 -6
- package/packages/watchdog/package.json +3 -3
- package/packages/watchdog/src/config.ts +3 -2
- package/packages/web-api/package.json +2 -2
- package/packages/workflow/README.md +3 -0
- package/packages/workflow/index.ts +0 -2
- package/packages/workflow/package.json +2 -2
- package/packages/workflow/src/permission/decide.ts +6 -4
- package/packages/workflow/src/permission/index.ts +17 -7
- package/packages/workflow/src/permission/settings.ts +39 -4
- package/packages/workflow/src/plan/index.ts +19 -4
- package/packages/background-tasks/extensions/delegate-child.ts +0 -1
- package/packages/background-tasks/src/context-parent-snapshot.ts +0 -142
- package/packages/background-tasks/src/context-token-budget.ts +0 -903
- package/packages/background-tasks/src/context-visible-conversation-v2.ts +0 -551
- package/packages/background-tasks/src/delegate/artifacts.ts +0 -487
- package/packages/background-tasks/src/delegate/budget.ts +0 -415
- package/packages/background-tasks/src/delegate/hook-contract-evidence.json +0 -18
- package/packages/background-tasks/src/delegate/hook-contract.ts +0 -154
- package/packages/background-tasks/src/delegate/launch.ts +0 -484
- package/packages/background-tasks/src/delegate/result-package.ts +0 -459
- package/packages/background-tasks/src/delegate/runner.ts +0 -430
- package/packages/background-tasks/src/delegate/seed.ts +0 -423
- package/packages/background-tasks/src/delegate/types.ts +0 -323
- package/packages/background-tasks/src/delegate-child-extension.ts +0 -978
- package/packages/background-tasks/src/delegate-extension.ts +0 -654
- package/packages/background-tasks/src/fixtures/delegate-context-incident.json +0 -17
- package/packages/compactor/skills/compactor-detail/SKILL.md +0 -116
- package/packages/compactor/skills/compactor-doctor/SKILL.md +0 -71
- package/packages/compactor/skills/compactor-stats/SKILL.md +0 -51
- package/packages/compactor/src/compaction/build-sections.ts +0 -76
- package/packages/compactor/src/compaction/extract/goals.ts +0 -36
- package/packages/compactor/src/compaction/extract/preferences.ts +0 -40
- package/packages/compactor/src/compaction/format.ts +0 -53
- package/packages/compactor/src/compaction/merge.ts +0 -143
- package/packages/compactor/src/config/presets.ts +0 -160
- package/packages/compactor/src/executor/executor.ts +0 -233
- package/packages/compactor/src/executor/runtime.ts +0 -115
- package/packages/compactor/src/security/evaluator.ts +0 -89
- package/packages/compactor/src/security/policy.ts +0 -96
- package/packages/compactor/src/security/scanner.ts +0 -65
- package/packages/compactor/src/session/auto-inject.ts +0 -60
- package/packages/compactor/src/session/db.ts +0 -325
- package/packages/compactor/src/session/extract.ts +0 -144
- package/packages/compactor/src/session/resume-inject.ts +0 -64
- package/packages/compactor/src/session/snapshot.ts +0 -327
- package/packages/compactor/src/tools/ctx-batch-execute.ts +0 -41
- package/packages/compactor/src/tools/ctx-execute-file.ts +0 -23
- package/packages/compactor/src/tools/ctx-execute.ts +0 -23
- package/packages/compactor/src/tools/ctx-stats.ts +0 -96
- package/packages/image/README.md +0 -99
- package/packages/image/package.json +0 -61
- package/packages/image/skills/image/SKILL.md +0 -76
- package/packages/image/src/generate.ts +0 -256
- package/packages/image/src/index.ts +0 -135
- package/packages/image/src/models.ts +0 -519
- package/packages/image/src/openai-images-api.ts +0 -282
- package/packages/image/src/register-providers.ts +0 -209
- package/packages/image/src/settings.ts +0 -173
- package/packages/image/src/tools.ts +0 -326
- package/packages/input-shortcuts/src/clipboard.ts +0 -119
- package/packages/kanboard/src/runner.ts +0 -817
- package/packages/skill-registry/skills/auto/SKILL.md +0 -465
- package/packages/skill-registry/skills/brainstorm/SKILL.md +0 -219
- package/packages/skill-registry/skills/chore-create/SKILL.md +0 -315
- package/packages/skill-registry/skills/chore-execute/SKILL.md +0 -314
- package/packages/skill-registry/skills/consolidate/SKILL.md +0 -142
- package/packages/skill-registry/skills/consultant/SKILL.md +0 -97
- package/packages/skill-registry/skills/debug/SKILL.md +0 -228
- package/packages/skill-registry/skills/document/SKILL.md +0 -120
- package/packages/skill-registry/skills/fix/SKILL.md +0 -212
- package/packages/skill-registry/skills/gather-context/SKILL.md +0 -145
- package/packages/skill-registry/skills/plan/SKILL.md +0 -231
- package/packages/skill-registry/skills/quick-fix/SKILL.md +0 -135
- package/packages/skill-registry/skills/quick-work/SKILL.md +0 -110
- package/packages/skill-registry/skills/research/SKILL.md +0 -251
- package/packages/skill-registry/skills/review-work/SKILL.md +0 -187
- package/packages/skill-registry/skills/scan-issues/SKILL.md +0 -195
- package/packages/skill-registry/skills/work/SKILL.md +0 -218
- package/packages/skill-registry/skills/worktree-create/SKILL.md +0 -69
- package/packages/skill-registry/skills/worktree-list/SKILL.md +0 -78
- package/packages/skill-registry/skills/worktree-merge/SKILL.md +0 -89
- package/packages/subagents/agents/delegate.md +0 -14
- package/packages/subagents/agents/oracle.md +0 -78
- package/packages/subagents/agents/researcher.md +0 -52
- package/packages/subagents/agents/reviewer.md +0 -80
- package/packages/subagents/agents/scout.md +0 -50
- package/packages/subagents/agents/worker.md +0 -59
- package/packages/subagents/prompts/council.md +0 -48
- package/packages/subagents/prompts/gather-context-and-clarify.md +0 -13
- package/packages/subagents/prompts/parallel-cleanup.md +0 -59
- package/packages/subagents/prompts/parallel-research.md +0 -50
- package/packages/subagents/prompts/parallel-review.md +0 -54
- package/packages/subagents/prompts/review-loop.md +0 -43
- package/packages/subagents/skills/council-mode/SKILL.md +0 -230
- package/packages/subagents/skills/subagents/references/constraints-and-recipes.md +0 -259
- package/packages/subagents/skills/subagents/references/execution-controls.md +0 -454
- package/packages/subagents/skills/subagents/references/management-authoring-rpc.md +0 -161
- package/packages/subagents/skills/subagents/references/multi-lane-orchestration.md +0 -39
- package/packages/subagents/skills/subagents/references/prompting-and-roles.md +0 -267
- package/packages/subagents/src/acceptance.ts +0 -331
- package/packages/subagents/src/agent-manager.ts +0 -405
- package/packages/subagents/src/agent-memory.ts +0 -300
- package/packages/subagents/src/agent-overrides.ts +0 -183
- package/packages/subagents/src/agent-runner.ts +0 -271
- package/packages/subagents/src/async-runner.ts +0 -422
- package/packages/subagents/src/authority-policy.ts +0 -47
- package/packages/subagents/src/budgets.ts +0 -285
- package/packages/subagents/src/child-safety.ts +0 -140
- package/packages/subagents/src/config.ts +0 -249
- package/packages/subagents/src/conversation-viewer.ts +0 -281
- package/packages/subagents/src/core-compat.ts +0 -94
- package/packages/subagents/src/custom-agents.ts +0 -343
- package/packages/subagents/src/file-system-retry.ts +0 -50
- package/packages/subagents/src/fleet-data.ts +0 -105
- package/packages/subagents/src/fleet-view.ts +0 -322
- package/packages/subagents/src/foreground-detach.ts +0 -59
- package/packages/subagents/src/fork-context.ts +0 -285
- package/packages/subagents/src/global.d.ts +0 -7
- package/packages/subagents/src/guide.ts +0 -129
- package/packages/subagents/src/mission-state.ts +0 -133
- package/packages/subagents/src/mission-store.ts +0 -436
- package/packages/subagents/src/output-limits.ts +0 -142
- package/packages/subagents/src/parity-types.ts +0 -315
- package/packages/subagents/src/pi-args.ts +0 -167
- package/packages/subagents/src/result-files.ts +0 -232
- package/packages/subagents/src/result-watcher.ts +0 -221
- package/packages/subagents/src/retained-children.ts +0 -176
- package/packages/subagents/src/run-fanout-budget.ts +0 -356
- package/packages/subagents/src/scheduled-runs.ts +0 -349
- package/packages/subagents/src/schemas.ts +0 -263
- package/packages/subagents/src/slash-commands.ts +0 -80
- package/packages/subagents/src/supervisor-channel.ts +0 -249
- package/packages/subagents/src/tool-handler.ts +0 -1144
- package/packages/subagents/src/types.ts +0 -238
- package/packages/subagents/src/widget.ts +0 -457
- package/packages/subagents/src/workflow-script.ts +0 -737
- package/packages/subagents/src/workflow-worker.ts +0 -384
- package/packages/subagents/src/worktree.ts +0 -614
- package/packages/utility/src/analytics/collector.ts +0 -293
- package/packages/utility/src/info-screen.ts +0 -80
- package/packages/utility/src/lifecycle/process.ts +0 -162
- package/packages/utility/src/prefix-cache.ts +0 -263
- package/packages/utility/src/skill-discovery.ts +0 -542
- package/packages/utility/src/tools/env.ts +0 -113
- package/packages/utility/src/tui/name-badge-state.ts +0 -315
- package/packages/utility/src/tui/name-badge.ts +0 -109
- /package/packages/{subagents/src → core/src/child-agent}/pi-spawn.ts +0 -0
|
@@ -1,263 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @pi-unipi/subagents — Tool parameter schemas (pi-subagents parity)
|
|
3
|
-
*
|
|
4
|
-
* Ported from nicobailon/pi-subagents src/extension/schemas.ts. Parameter
|
|
5
|
-
* names follow the reference (they are arguments, not tool names — no
|
|
6
|
-
* convention clash); our legacy spawn_helper params (type/prompt/description/
|
|
7
|
-
* run_in_background/max_turns) remain accepted as aliases.
|
|
8
|
-
*/
|
|
9
|
-
|
|
10
|
-
import { Type } from "typebox";
|
|
11
|
-
|
|
12
|
-
const TurnBudgetOverride = Type.Object(
|
|
13
|
-
{
|
|
14
|
-
maxTurns: Type.Integer({ minimum: 1 }),
|
|
15
|
-
graceTurns: Type.Optional(Type.Integer({ minimum: 0 })),
|
|
16
|
-
},
|
|
17
|
-
{
|
|
18
|
-
additionalProperties: false,
|
|
19
|
-
description:
|
|
20
|
-
"Optional assistant-turn budget. At maxTurns the child is asked to wrap up; after graceTurns (default 1) additional assistant turns it is aborted and partial output is returned.",
|
|
21
|
-
},
|
|
22
|
-
);
|
|
23
|
-
|
|
24
|
-
const ToolBudgetBlock = Type.Unsafe({
|
|
25
|
-
anyOf: [
|
|
26
|
-
{ type: "array", minItems: 1, items: { type: "string", minLength: 1 } },
|
|
27
|
-
{ type: "string", enum: ["*"] },
|
|
28
|
-
],
|
|
29
|
-
});
|
|
30
|
-
|
|
31
|
-
const ToolBudgetOverride = Type.Object(
|
|
32
|
-
{
|
|
33
|
-
soft: Type.Optional(Type.Integer({ minimum: 1 })),
|
|
34
|
-
hard: Type.Integer({ minimum: 1 }),
|
|
35
|
-
block: Type.Optional(ToolBudgetBlock),
|
|
36
|
-
},
|
|
37
|
-
{
|
|
38
|
-
additionalProperties: false,
|
|
39
|
-
description:
|
|
40
|
-
"Optional child tool-call budget. soft nudges the child to finalize; after hard, block tools (default read/grep/find/ls, or '*' for all tools) are blocked so the child can finalize. Final assistant text is never blocked.",
|
|
41
|
-
},
|
|
42
|
-
);
|
|
43
|
-
|
|
44
|
-
const UsageBudgetLimitOverride = Type.Object(
|
|
45
|
-
{
|
|
46
|
-
soft: Type.Optional(Type.Number({ exclusiveMinimum: 0 })),
|
|
47
|
-
hard: Type.Number({ exclusiveMinimum: 0 }),
|
|
48
|
-
},
|
|
49
|
-
{ additionalProperties: false },
|
|
50
|
-
);
|
|
51
|
-
|
|
52
|
-
const UsageBudgetOverride = Type.Object(
|
|
53
|
-
{
|
|
54
|
-
tokens: Type.Optional(UsageBudgetLimitOverride),
|
|
55
|
-
costUsd: Type.Optional(UsageBudgetLimitOverride),
|
|
56
|
-
},
|
|
57
|
-
{
|
|
58
|
-
additionalProperties: false,
|
|
59
|
-
description:
|
|
60
|
-
"Optional root-only reported-usage budget. Soft limits are status-only. Hard limits prevent later child launches after usage is reconciled; running children are not stopped.",
|
|
61
|
-
},
|
|
62
|
-
);
|
|
63
|
-
|
|
64
|
-
const MaxOutputOverride = Type.Object(
|
|
65
|
-
{
|
|
66
|
-
bytes: Type.Optional(Type.Integer({ minimum: 1 })),
|
|
67
|
-
lines: Type.Optional(Type.Integer({ minimum: 1 })),
|
|
68
|
-
},
|
|
69
|
-
{ additionalProperties: false, description: "Final output truncation limits. Defaults: 200KB / 5000 lines." },
|
|
70
|
-
);
|
|
71
|
-
|
|
72
|
-
/**
|
|
73
|
-
* spawn_helper parameter surface. Legacy fields (type, prompt, description,
|
|
74
|
-
* run_in_background, max_turns) are the unipi convention and stay primary;
|
|
75
|
-
* reference fields (agent, task, action, workflowScript, budgets, ...) join
|
|
76
|
-
* them. Execution paths map: agent→type, task→prompt, async→run_in_background.
|
|
77
|
-
*/
|
|
78
|
-
export const SpawnHelperParams = Type.Object({
|
|
79
|
-
// ---- unipi legacy (preserved) ----
|
|
80
|
-
type: Type.Optional(
|
|
81
|
-
Type.String({ description: "Agent type (alias of agent). Enabled builtin or custom type." }),
|
|
82
|
-
),
|
|
83
|
-
prompt: Type.Optional(
|
|
84
|
-
Type.String({ description: "The task for the agent to perform (alias of task)." }),
|
|
85
|
-
),
|
|
86
|
-
description: Type.Optional(
|
|
87
|
-
Type.String({ description: "A short (3-5 word) description of the task." }),
|
|
88
|
-
),
|
|
89
|
-
run_in_background: Type.Optional(
|
|
90
|
-
Type.Boolean({ description: "Run in background (alias of async). Returns helper ID immediately." }),
|
|
91
|
-
),
|
|
92
|
-
max_turns: Type.Optional(
|
|
93
|
-
Type.Number({ minimum: 1, description: "Max agentic turns before stopping." }),
|
|
94
|
-
),
|
|
95
|
-
|
|
96
|
-
// ---- reference surface ----
|
|
97
|
-
agent: Type.Optional(
|
|
98
|
-
Type.String({ description: "Agent for one-child execution, or target for management actions." }),
|
|
99
|
-
),
|
|
100
|
-
task: Type.Optional(
|
|
101
|
-
Type.String({
|
|
102
|
-
description: "Optional one-child task. Requires agent; cannot combine with action or workflowScript.",
|
|
103
|
-
}),
|
|
104
|
-
),
|
|
105
|
-
action: Type.Optional(
|
|
106
|
-
Type.String({
|
|
107
|
-
minLength: 1,
|
|
108
|
-
description:
|
|
109
|
-
"Optional management/control action (list, get, status, steer, stop, doctor, ...). Omit for execution.",
|
|
110
|
-
}),
|
|
111
|
-
),
|
|
112
|
-
id: Type.Optional(Type.String({ description: "Run id/prefix for status, interrupt, steer." })),
|
|
113
|
-
runId: Type.Optional(Type.String({ description: "Target run ID. Prefer id." })),
|
|
114
|
-
dir: Type.Optional(Type.String({ description: "Async run directory for status/stop/resume/steer." })),
|
|
115
|
-
index: Type.Optional(
|
|
116
|
-
Type.Integer({ minimum: 0, description: "Zero-based child index for actions targeting a specific child." }),
|
|
117
|
-
),
|
|
118
|
-
view: Type.Optional(
|
|
119
|
-
Type.String({
|
|
120
|
-
enum: ["fleet", "transcript"],
|
|
121
|
-
description: "Optional status view: fleet surface or transcript tail.",
|
|
122
|
-
}),
|
|
123
|
-
),
|
|
124
|
-
lines: Type.Optional(
|
|
125
|
-
Type.Integer({ minimum: 1, maximum: 500, description: "Max transcript lines for status view=transcript. Default 80." }),
|
|
126
|
-
),
|
|
127
|
-
topic: Type.Optional(Type.String({ description: "Guide topic for action=guide." })),
|
|
128
|
-
message: Type.Optional(
|
|
129
|
-
Type.String({ description: "Follow-up message for resume, live guidance for steer." }),
|
|
130
|
-
),
|
|
131
|
-
mode: Type.Optional(
|
|
132
|
-
Type.String({
|
|
133
|
-
enum: ["steer", "follow_up", "auto"],
|
|
134
|
-
description: "Delivery mode for action=steer.",
|
|
135
|
-
}),
|
|
136
|
-
),
|
|
137
|
-
additional: Type.Optional(
|
|
138
|
-
Type.Integer({
|
|
139
|
-
minimum: 1,
|
|
140
|
-
description: "Positive launches to add with action=grant-spawn-budget.",
|
|
141
|
-
}),
|
|
142
|
-
),
|
|
143
|
-
missionId: Type.Optional(Type.String({ description: "Mission id." })),
|
|
144
|
-
mission: Type.Optional(
|
|
145
|
-
Type.Unsafe({
|
|
146
|
-
anyOf: [{ type: "object", additionalProperties: true }, { type: "boolean", enum: [false] }],
|
|
147
|
-
description: "Mission object, or false for no mission.",
|
|
148
|
-
}),
|
|
149
|
-
),
|
|
150
|
-
config: Type.Optional(
|
|
151
|
-
Type.Unsafe({
|
|
152
|
-
anyOf: [{ type: "object", additionalProperties: true }, { type: "string" }],
|
|
153
|
-
description: "Agent config for create/update. Object or JSON string.",
|
|
154
|
-
}),
|
|
155
|
-
),
|
|
156
|
-
workflowScript: Type.Optional(
|
|
157
|
-
Type.String({
|
|
158
|
-
minLength: 1,
|
|
159
|
-
description:
|
|
160
|
-
"Trusted inline JavaScript statement body. Use await runs.run(key, {agent, task}) for one child, runs.all([...]) for parallel fanout, await runs.steer(key, message, opts) to steer. Plain helper functions or explicit Promise chains only; nested async helpers are rejected. Explicit return for output. async:true for background (default), async:false only when the parent must block.",
|
|
161
|
-
}),
|
|
162
|
-
),
|
|
163
|
-
chatProgress: Type.Optional(
|
|
164
|
-
Type.String({
|
|
165
|
-
enum: ["auto", "off", "live-card"],
|
|
166
|
-
description: "WorkflowScript chat progress projection.",
|
|
167
|
-
}),
|
|
168
|
-
),
|
|
169
|
-
isolation: Type.Optional(
|
|
170
|
-
Type.String({ enum: ["none", "worktree"], description: "Workflow child isolation." }),
|
|
171
|
-
),
|
|
172
|
-
worktree: Type.Optional(
|
|
173
|
-
Type.Boolean({ description: "Managed child isolation via separate git worktrees." }),
|
|
174
|
-
),
|
|
175
|
-
context: Type.Optional(
|
|
176
|
-
Type.String({
|
|
177
|
-
enum: ["fresh", "fork", "profile"],
|
|
178
|
-
description:
|
|
179
|
-
"'fresh' or 'fork' to branch from parent session, or 'profile' for the agent's declared defaultContext.",
|
|
180
|
-
}),
|
|
181
|
-
),
|
|
182
|
-
async: Type.Optional(
|
|
183
|
-
Type.Boolean({ description: "Run in background. Set false only when the parent must block." }),
|
|
184
|
-
),
|
|
185
|
-
timeoutMs: Type.Optional(
|
|
186
|
-
Type.Integer({ minimum: 1, description: "Run-level max runtime ms. Alias maxRuntimeMs." }),
|
|
187
|
-
),
|
|
188
|
-
maxRuntimeMs: Type.Optional(Type.Integer({ minimum: 1, description: "Alias timeoutMs." })),
|
|
189
|
-
toolTimeoutMs: Type.Optional(
|
|
190
|
-
Type.Integer({ minimum: 1, description: "Optional hard per-tool-call timeout in ms." }),
|
|
191
|
-
),
|
|
192
|
-
turnBudget: Type.Optional(TurnBudgetOverride),
|
|
193
|
-
toolBudget: Type.Optional(ToolBudgetOverride),
|
|
194
|
-
usageBudget: Type.Optional(UsageBudgetOverride),
|
|
195
|
-
agentScope: Type.Optional(
|
|
196
|
-
Type.String({
|
|
197
|
-
description: "Agent discovery scope: 'user', 'project', or 'both' (default both; project wins collisions).",
|
|
198
|
-
}),
|
|
199
|
-
),
|
|
200
|
-
cwd: Type.Optional(Type.String({ description: "Execution cwd override." })),
|
|
201
|
-
artifacts: Type.Optional(Type.Boolean({ description: "Write debug artifacts. Default true." })),
|
|
202
|
-
includeProgress: Type.Optional(
|
|
203
|
-
Type.Boolean({ description: "Include full progress in result. Default false." }),
|
|
204
|
-
),
|
|
205
|
-
sessionDir: Type.Optional(Type.String({ description: "Directory for child session logs." })),
|
|
206
|
-
output: Type.Optional(
|
|
207
|
-
Type.Unsafe({
|
|
208
|
-
anyOf: [{ type: "string" }, { type: "boolean" }],
|
|
209
|
-
description: "Default child output file (string), or false to disable.",
|
|
210
|
-
}),
|
|
211
|
-
),
|
|
212
|
-
outputMode: Type.Optional(
|
|
213
|
-
Type.String({
|
|
214
|
-
enum: ["inline", "file-only"],
|
|
215
|
-
description: "Return saved output inline (default) or only a concise file reference.",
|
|
216
|
-
}),
|
|
217
|
-
),
|
|
218
|
-
model: Type.Optional(
|
|
219
|
-
Type.String({
|
|
220
|
-
description: 'Model override. "provider/modelId" or fuzzy name. Omit to inherit parent model.',
|
|
221
|
-
}),
|
|
222
|
-
),
|
|
223
|
-
thinking: Type.Optional(
|
|
224
|
-
Type.String({
|
|
225
|
-
description: "Thinking level: off, minimal, low, medium, high, xhigh. Omit to inherit parent.",
|
|
226
|
-
}),
|
|
227
|
-
),
|
|
228
|
-
maxOutput: Type.Optional(MaxOutputOverride),
|
|
229
|
-
});
|
|
230
|
-
|
|
231
|
-
/** get_helper_result parameter surface (parity with subagent_wait). */
|
|
232
|
-
export const GetHelperResultParams = Type.Object({
|
|
233
|
-
id: Type.Optional(
|
|
234
|
-
Type.String({
|
|
235
|
-
description:
|
|
236
|
-
"Helper/async run id (or prefix) to wait for. Omit to wait across every active run started in this session.",
|
|
237
|
-
}),
|
|
238
|
-
),
|
|
239
|
-
nonBlocking: Type.Optional(
|
|
240
|
-
Type.Boolean({
|
|
241
|
-
description:
|
|
242
|
-
"When true, resolve id to one exact run, persist a wake subscription, and return immediately. The originating session is woken on completion/failure/attention. Requires id; cannot combine with all.",
|
|
243
|
-
}),
|
|
244
|
-
),
|
|
245
|
-
all: Type.Optional(
|
|
246
|
-
Type.Boolean({
|
|
247
|
-
description:
|
|
248
|
-
"Wait for ALL active runs to finish. Default false: return when the first run finishes.",
|
|
249
|
-
}),
|
|
250
|
-
),
|
|
251
|
-
timeoutMs: Type.Optional(
|
|
252
|
-
Type.Integer({
|
|
253
|
-
minimum: 1,
|
|
254
|
-
description: "Give up waiting after this many milliseconds (runs keep going). Default 1800000.",
|
|
255
|
-
}),
|
|
256
|
-
),
|
|
257
|
-
stopOnAttention: Type.Optional(
|
|
258
|
-
Type.Boolean({
|
|
259
|
-
description:
|
|
260
|
-
"Blocking waits stop when a run needs attention by default. Set false to wait through idle or long-thinking attention.",
|
|
261
|
-
}),
|
|
262
|
-
),
|
|
263
|
-
});
|
|
@@ -1,80 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @pi-unipi/subagents — /unipi:* slash commands (Phase 7)
|
|
3
|
-
*
|
|
4
|
-
* subagents-fleet: open the fleet inspector surface.
|
|
5
|
-
* subagents-doctor: run the doctor report.
|
|
6
|
-
* subagents-guide: print a guide topic.
|
|
7
|
-
*/
|
|
8
|
-
|
|
9
|
-
import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
10
|
-
import type { AgentManager } from "./agent-manager.js";
|
|
11
|
-
import { listAsyncRunSummaries } from "./fleet-data.js";
|
|
12
|
-
import { buildGuideText } from "./guide.js";
|
|
13
|
-
|
|
14
|
-
export interface SlashDeps {
|
|
15
|
-
manager: AgentManager;
|
|
16
|
-
config: { maxConcurrent: number; enabled: boolean; types: Record<string, { enabled?: boolean }> };
|
|
17
|
-
asyncDirRoot: string;
|
|
18
|
-
/** Current session id — scopes the fleet list to this session's own runs. */
|
|
19
|
-
sessionId?: string;
|
|
20
|
-
retainedDir?: string;
|
|
21
|
-
}
|
|
22
|
-
|
|
23
|
-
export function registerSlashCommands(pi: ExtensionAPI, getCtx: () => ExtensionContext | undefined, deps: SlashDeps): void {
|
|
24
|
-
const send = (markdown: string): void => {
|
|
25
|
-
pi.sendMessage(
|
|
26
|
-
{ customType: "unipi-response", content: markdown, display: true },
|
|
27
|
-
{ deliverAs: "followUp" },
|
|
28
|
-
);
|
|
29
|
-
};
|
|
30
|
-
|
|
31
|
-
pi.registerCommand("unipi:subagents-fleet", {
|
|
32
|
-
description: "Show active subagent fleet (in-process + process runs)",
|
|
33
|
-
handler: async (_args, _ctx) => {
|
|
34
|
-
const inProcess = deps.manager.listAgents().filter((a) => a.status === "running" || a.status === "queued");
|
|
35
|
-
const asyncRuns = listAsyncRunSummaries(
|
|
36
|
-
deps.asyncDirRoot,
|
|
37
|
-
deps.sessionId ? { sessionId: deps.sessionId } : {},
|
|
38
|
-
).filter((r) => r.state === "running" || r.state === "queued" || r.state === "pending");
|
|
39
|
-
const lines: string[] = ["Active subagent fleet:", ""];
|
|
40
|
-
if (inProcess.length === 0 && asyncRuns.length === 0) {
|
|
41
|
-
lines.push(" (no active work — use spawn_helper to delegate)");
|
|
42
|
-
} else {
|
|
43
|
-
if (inProcess.length > 0) {
|
|
44
|
-
lines.push(`In-process (${inProcess.length}):`);
|
|
45
|
-
for (const record of inProcess) {
|
|
46
|
-
lines.push(` - ${record.id} [${record.type}] ${record.status}: ${record.description}`);
|
|
47
|
-
}
|
|
48
|
-
}
|
|
49
|
-
if (asyncRuns.length > 0) {
|
|
50
|
-
lines.push(`Process runs (${asyncRuns.length}):`);
|
|
51
|
-
for (const run of asyncRuns) {
|
|
52
|
-
lines.push(` - ${run.runId} [${run.agent}] ${run.state}`);
|
|
53
|
-
}
|
|
54
|
-
}
|
|
55
|
-
lines.push("", "FleetView panel: ↓ to inspect · enter opens transcripts.");
|
|
56
|
-
}
|
|
57
|
-
send(lines.join("\n"));
|
|
58
|
-
},
|
|
59
|
-
});
|
|
60
|
-
|
|
61
|
-
pi.registerCommand("unipi:subagents-doctor", {
|
|
62
|
-
description: "Subagents configuration and capacity diagnosis",
|
|
63
|
-
handler: async () => {
|
|
64
|
-
send(
|
|
65
|
-
"Run the full report via spawn_helper({ action: \"doctor\" }). Quick check:\n" +
|
|
66
|
-
`- extension enabled: ${deps.config.enabled}\n` +
|
|
67
|
-
`- known agent types: ${deps.manager.getKnownTypes().length}\n` +
|
|
68
|
-
`- max concurrent: ${deps.config.maxConcurrent}`,
|
|
69
|
-
);
|
|
70
|
-
},
|
|
71
|
-
});
|
|
72
|
-
|
|
73
|
-
pi.registerCommand("unipi:subagents-guide", {
|
|
74
|
-
description: "Subagents guide (topic argument optional)",
|
|
75
|
-
handler: async (args, _ctx) => {
|
|
76
|
-
const topic = args?.trim() || "overview";
|
|
77
|
-
send(buildGuideText(topic));
|
|
78
|
-
},
|
|
79
|
-
});
|
|
80
|
-
}
|
|
@@ -1,249 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @pi-unipi/subagents — Native supervisor channel
|
|
3
|
-
*
|
|
4
|
-
* Ported from pi-subagents src/intercom/native-supervisor-channel.ts (core).
|
|
5
|
-
* File-based channel: children write request JSON into a per-run channel dir;
|
|
6
|
-
* the parent polls, surfaces decisions via followUp messages, and writes
|
|
7
|
-
* reply JSON back. Children discover the channel through env vars set at
|
|
8
|
-
* launch (UNIPI_SUBAGENT_SUPERVISOR_CHANNEL_DIR etc.) — NO external
|
|
9
|
-
* pi-intercom dependency.
|
|
10
|
-
*/
|
|
11
|
-
|
|
12
|
-
import * as fs from "node:fs";
|
|
13
|
-
import * as path from "node:path";
|
|
14
|
-
import { randomUUID } from "node:crypto";
|
|
15
|
-
|
|
16
|
-
export const SUPERVISOR_TOOL_NAME = "contact_supervisor";
|
|
17
|
-
export const PARENT_SUPERVISOR_TOOL_NAME = "subagent_supervisor";
|
|
18
|
-
|
|
19
|
-
const MAX_MESSAGE_BYTES = 64 * 1024;
|
|
20
|
-
const DEFAULT_ASK_TIMEOUT_MS = 10 * 60 * 1000;
|
|
21
|
-
const CHANNEL_POLL_MS = 500;
|
|
22
|
-
|
|
23
|
-
export type SupervisorReason = "need_decision" | "interview_request" | "progress_update";
|
|
24
|
-
|
|
25
|
-
export interface SupervisorRequest {
|
|
26
|
-
type: "subagent.supervisor.request";
|
|
27
|
-
id: string;
|
|
28
|
-
createdAt: number;
|
|
29
|
-
expiresAt?: number;
|
|
30
|
-
reason: SupervisorReason;
|
|
31
|
-
message: string;
|
|
32
|
-
expectsReply: boolean;
|
|
33
|
-
runId: string;
|
|
34
|
-
agent: string;
|
|
35
|
-
}
|
|
36
|
-
|
|
37
|
-
export interface SupervisorReply {
|
|
38
|
-
type: "subagent.supervisor.reply";
|
|
39
|
-
requestId: string;
|
|
40
|
-
createdAt: number;
|
|
41
|
-
message: string;
|
|
42
|
-
}
|
|
43
|
-
|
|
44
|
-
// ============================================================================
|
|
45
|
-
// Env contract (child side)
|
|
46
|
-
// ============================================================================
|
|
47
|
-
|
|
48
|
-
export const SUPERVISOR_CHANNEL_DIR_ENV = "UNIPI_SUBAGENT_SUPERVISOR_CHANNEL_DIR";
|
|
49
|
-
export const SUPERVISOR_RUN_ID_ENV = "UNIPI_SUBAGENT_RUN_ID";
|
|
50
|
-
export const SUPERVISOR_AGENT_ENV = "UNIPI_SUBAGENT_CHILD_AGENT";
|
|
51
|
-
export const SUPERVISOR_PARENT_SESSION_ENV = "UNIPI_SUBAGENT_PARENT_SESSION";
|
|
52
|
-
|
|
53
|
-
/** Child-side metadata read from env. All fields required to activate. */
|
|
54
|
-
export function readChildSupervisorMetadata(env: NodeJS.ProcessEnv = process.env): {
|
|
55
|
-
channelDir: string;
|
|
56
|
-
runId: string;
|
|
57
|
-
agent: string;
|
|
58
|
-
parentSessionId: string;
|
|
59
|
-
} | undefined {
|
|
60
|
-
const channelDir = env[SUPERVISOR_CHANNEL_DIR_ENV]?.trim();
|
|
61
|
-
const runId = env[SUPERVISOR_RUN_ID_ENV]?.trim();
|
|
62
|
-
const agent = env[SUPERVISOR_AGENT_ENV]?.trim();
|
|
63
|
-
const parentSessionId = env[SUPERVISOR_PARENT_SESSION_ENV]?.trim();
|
|
64
|
-
if (!channelDir || !runId || !agent || !parentSessionId) return undefined;
|
|
65
|
-
return { channelDir, runId, agent, parentSessionId };
|
|
66
|
-
}
|
|
67
|
-
|
|
68
|
-
function safeSegment(value: string): string {
|
|
69
|
-
return value.trim().replace(/[^A-Za-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "") || "unknown";
|
|
70
|
-
}
|
|
71
|
-
|
|
72
|
-
/** Channel dir under our temp root: supervisor-channels/<runId>-<agent>/. */
|
|
73
|
-
export function resolveSupervisorChannelDir(root: string, runId: string, agent: string): string {
|
|
74
|
-
return path.join(root, `${safeSegment(runId)}-${safeSegment(agent)}`);
|
|
75
|
-
}
|
|
76
|
-
|
|
77
|
-
export function ensureSupervisorChannelDir(channelDir: string): void {
|
|
78
|
-
fs.mkdirSync(path.join(channelDir, "requests"), { recursive: true, mode: 0o700 });
|
|
79
|
-
fs.mkdirSync(path.join(channelDir, "replies"), { recursive: true, mode: 0o700 });
|
|
80
|
-
}
|
|
81
|
-
|
|
82
|
-
function requestsDir(channelDir: string): string {
|
|
83
|
-
return path.join(channelDir, "requests");
|
|
84
|
-
}
|
|
85
|
-
function repliesDir(channelDir: string): string {
|
|
86
|
-
return path.join(channelDir, "replies");
|
|
87
|
-
}
|
|
88
|
-
|
|
89
|
-
function validateMessage(message: string | undefined): string {
|
|
90
|
-
if (!message || !message.trim()) throw new Error("supervisor message must be a non-empty string.");
|
|
91
|
-
if (Buffer.byteLength(message, "utf8") > MAX_MESSAGE_BYTES) {
|
|
92
|
-
throw new Error(`supervisor message exceeds ${MAX_MESSAGE_BYTES} bytes.`);
|
|
93
|
-
}
|
|
94
|
-
return message;
|
|
95
|
-
}
|
|
96
|
-
|
|
97
|
-
// ============================================================================
|
|
98
|
-
// Child side: contact_supervisor
|
|
99
|
-
// ============================================================================
|
|
100
|
-
|
|
101
|
-
/**
|
|
102
|
-
* Write a supervisor request and (optionally) block until a reply lands.
|
|
103
|
-
* Returns the reply text for asks; undefined for progress updates.
|
|
104
|
-
*/
|
|
105
|
-
export function childContactSupervisor(
|
|
106
|
-
params: { reason: SupervisorReason; message?: string; timeoutMs?: number },
|
|
107
|
-
metadata = readChildSupervisorMetadata(),
|
|
108
|
-
now = Date.now(),
|
|
109
|
-
): { replied: boolean; reply?: string } {
|
|
110
|
-
if (!metadata) {
|
|
111
|
-
throw new Error("contact_supervisor is unavailable: no supervisor channel in this environment.");
|
|
112
|
-
}
|
|
113
|
-
const message = validateMessage(params.message);
|
|
114
|
-
ensureSupervisorChannelDir(metadata.channelDir);
|
|
115
|
-
|
|
116
|
-
const request: SupervisorRequest = {
|
|
117
|
-
type: "subagent.supervisor.request",
|
|
118
|
-
id: randomUUID(),
|
|
119
|
-
createdAt: now,
|
|
120
|
-
reason: params.reason,
|
|
121
|
-
message,
|
|
122
|
-
expectsReply: params.reason !== "progress_update",
|
|
123
|
-
runId: metadata.runId,
|
|
124
|
-
agent: metadata.agent,
|
|
125
|
-
...(params.reason !== "progress_update"
|
|
126
|
-
? { expiresAt: now + (params.timeoutMs ?? DEFAULT_ASK_TIMEOUT_MS) }
|
|
127
|
-
: {}),
|
|
128
|
-
};
|
|
129
|
-
fs.writeFileSync(
|
|
130
|
-
path.join(requestsDir(metadata.channelDir), `${request.id}.json`),
|
|
131
|
-
JSON.stringify(request),
|
|
132
|
-
{ mode: 0o600 },
|
|
133
|
-
);
|
|
134
|
-
|
|
135
|
-
if (!request.expectsReply) return { replied: false };
|
|
136
|
-
|
|
137
|
-
// Block on the reply file. In production children run as separate processes
|
|
138
|
-
// (Atomics.wait parks without burning CPU); when Atomics is unavailable
|
|
139
|
-
// (e.g. same-process tests), fall back to a busy poll.
|
|
140
|
-
const replyFile = path.join(repliesDir(metadata.channelDir), `${request.id}.json`);
|
|
141
|
-
const deadline = request.expiresAt ?? now + DEFAULT_ASK_TIMEOUT_MS;
|
|
142
|
-
const waitBuffer = typeof SharedArrayBuffer !== "undefined" ? new Int32Array(new SharedArrayBuffer(4)) : undefined;
|
|
143
|
-
for (;;) {
|
|
144
|
-
try {
|
|
145
|
-
const reply = JSON.parse(fs.readFileSync(replyFile, "utf8")) as SupervisorReply;
|
|
146
|
-
if (reply.requestId === request.id) return { replied: true, reply: reply.message };
|
|
147
|
-
} catch {
|
|
148
|
-
// Not there yet.
|
|
149
|
-
}
|
|
150
|
-
if (Date.now() > deadline) {
|
|
151
|
-
return { replied: false, reply: undefined };
|
|
152
|
-
}
|
|
153
|
-
if (waitBuffer) {
|
|
154
|
-
try {
|
|
155
|
-
Atomics.wait(waitBuffer, 0, 0, CHANNEL_POLL_MS);
|
|
156
|
-
} catch {
|
|
157
|
-
// Busy fallback below.
|
|
158
|
-
}
|
|
159
|
-
}
|
|
160
|
-
}
|
|
161
|
-
}
|
|
162
|
-
|
|
163
|
-
// ============================================================================
|
|
164
|
-
// Parent side: poll pending requests, deliver, reply
|
|
165
|
-
// ============================================================================
|
|
166
|
-
|
|
167
|
-
export interface PendingSupervisorRequest extends SupervisorRequest {
|
|
168
|
-
channelDir: string;
|
|
169
|
-
}
|
|
170
|
-
|
|
171
|
-
/** List open requests across all channel dirs under the root. */
|
|
172
|
-
export function listPendingSupervisorRequests(root: string): PendingSupervisorRequest[] {
|
|
173
|
-
let entries: fs.Dirent[];
|
|
174
|
-
try {
|
|
175
|
-
entries = fs.readdirSync(root, { withFileTypes: true });
|
|
176
|
-
} catch {
|
|
177
|
-
return [];
|
|
178
|
-
}
|
|
179
|
-
const pending: PendingSupervisorRequest[] = [];
|
|
180
|
-
const now = Date.now();
|
|
181
|
-
for (const entry of entries) {
|
|
182
|
-
if (!entry.isDirectory()) continue;
|
|
183
|
-
const channelDir = path.join(root, entry.name);
|
|
184
|
-
let files: string[];
|
|
185
|
-
try {
|
|
186
|
-
files = fs.readdirSync(requestsDir(channelDir));
|
|
187
|
-
} catch {
|
|
188
|
-
continue;
|
|
189
|
-
}
|
|
190
|
-
for (const file of files) {
|
|
191
|
-
if (!file.endsWith(".json")) continue;
|
|
192
|
-
try {
|
|
193
|
-
const request = JSON.parse(fs.readFileSync(path.join(requestsDir(channelDir), file), "utf8")) as SupervisorRequest;
|
|
194
|
-
if (request.type !== "subagent.supervisor.request") continue;
|
|
195
|
-
if (request.expiresAt !== undefined && request.expiresAt < now) {
|
|
196
|
-
// Expired: clean up so it never re-surfaces.
|
|
197
|
-
fs.rmSync(path.join(requestsDir(channelDir), file), { force: true });
|
|
198
|
-
continue;
|
|
199
|
-
}
|
|
200
|
-
pending.push({ ...request, channelDir });
|
|
201
|
-
} catch {
|
|
202
|
-
// corrupt → skip
|
|
203
|
-
}
|
|
204
|
-
}
|
|
205
|
-
}
|
|
206
|
-
return pending.sort((left, right) => left.createdAt - right.createdAt);
|
|
207
|
-
}
|
|
208
|
-
|
|
209
|
-
/** Reply to a request (removes it from pending). */
|
|
210
|
-
export function replyToSupervisorRequest(root: string, requestId: string, message: string): boolean {
|
|
211
|
-
const validMessage = validateMessage(message);
|
|
212
|
-
for (const pending of listPendingSupervisorRequests(root)) {
|
|
213
|
-
if (pending.id !== requestId) continue;
|
|
214
|
-
const reply: SupervisorReply = {
|
|
215
|
-
type: "subagent.supervisor.reply",
|
|
216
|
-
requestId,
|
|
217
|
-
createdAt: Date.now(),
|
|
218
|
-
message: validMessage,
|
|
219
|
-
};
|
|
220
|
-
fs.writeFileSync(path.join(repliesDir(pending.channelDir), `${requestId}.json`), JSON.stringify(reply), { mode: 0o600 });
|
|
221
|
-
try {
|
|
222
|
-
fs.rmSync(path.join(requestsDir(pending.channelDir), `${requestId}.json`), { force: true });
|
|
223
|
-
} catch { /* best effort */ }
|
|
224
|
-
return true;
|
|
225
|
-
}
|
|
226
|
-
return false;
|
|
227
|
-
}
|
|
228
|
-
|
|
229
|
-
/** Create the parent-side poller that delivers requests as notifications. */
|
|
230
|
-
export function createSupervisorPoller(
|
|
231
|
-
root: string,
|
|
232
|
-
opts: {
|
|
233
|
-
pollMs?: number;
|
|
234
|
-
notify: (request: PendingSupervisorRequest) => void;
|
|
235
|
-
},
|
|
236
|
-
): { stop(): void } {
|
|
237
|
-
let timer: ReturnType<typeof setInterval> | undefined;
|
|
238
|
-
timer = setInterval(() => {
|
|
239
|
-
for (const request of listPendingSupervisorRequests(root)) {
|
|
240
|
-
opts.notify(request);
|
|
241
|
-
}
|
|
242
|
-
}, opts.pollMs ?? CHANNEL_POLL_MS);
|
|
243
|
-
timer.unref?.();
|
|
244
|
-
return {
|
|
245
|
-
stop(): void {
|
|
246
|
-
if (timer) clearInterval(timer);
|
|
247
|
-
},
|
|
248
|
-
};
|
|
249
|
-
}
|