pi-crew 0.2.3 → 0.2.5

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 (348) hide show
  1. package/AGENTS.md +57 -32
  2. package/CHANGELOG.md +466 -448
  3. package/LICENSE +21 -21
  4. package/NOTICE.md +16 -16
  5. package/README.md +323 -323
  6. package/docs/FEATURE_INTAKE.md +126 -0
  7. package/docs/HARNESS.md +86 -0
  8. package/docs/HARNESS_BACKLOG.md +41 -0
  9. package/docs/TEST_MATRIX.md +49 -0
  10. package/docs/actions-reference.md +595 -595
  11. package/docs/architecture.md +180 -180
  12. package/docs/code-review-2026-05-11.md +592 -592
  13. package/docs/commands-reference.md +347 -347
  14. package/docs/comparison-pi-subagents-vs-pi-crew.md +303 -0
  15. package/docs/decisions/0001-durable-state.md +41 -0
  16. package/docs/decisions/0002-child-process-for-async.md +42 -0
  17. package/docs/decisions/0003-depth-guard.md +36 -0
  18. package/docs/decisions/0004-execfile-over-exec.md +34 -0
  19. package/docs/decisions/0005-no-parameter-properties.md +49 -0
  20. package/docs/decisions/0006-publish-bundled-esm.md +63 -0
  21. package/docs/decisions/0007-active-run-binary-index.md +54 -0
  22. package/docs/decisions/0008-child-pi-warm-pool.md +61 -0
  23. package/docs/decisions/README.md +23 -0
  24. package/docs/followup-review-round4-2026-05-13.md +107 -0
  25. package/docs/implementation-plan-top3.md +333 -0
  26. package/docs/live-mailbox-runtime.md +36 -36
  27. package/docs/next-upgrade-roadmap.md +808 -808
  28. package/docs/oh-my-pi-research.md +509 -0
  29. package/docs/perf/baseline-2026-05.md +113 -0
  30. package/docs/perf/final-report-2026-05.md +206 -0
  31. package/docs/perf/sprint-1-report.md +71 -0
  32. package/docs/perf/sprint-2-report.md +81 -0
  33. package/docs/perf/sprint-2.5-report.md +53 -0
  34. package/docs/perf/sprint-3-report.md +36 -0
  35. package/docs/perf/sprint-4-report.md +47 -0
  36. package/docs/perf/sprint-5-report.md +51 -0
  37. package/docs/perf/sprint-6-report.md +94 -0
  38. package/docs/perf/sprint-7-report.md +74 -0
  39. package/docs/perf/upgrade-plan-2026-05.md +147 -0
  40. package/docs/pi-subagents3-deep-analysis.md +508 -0
  41. package/docs/product/README.md +31 -0
  42. package/docs/product/platform.md +27 -0
  43. package/docs/product/runtime-safety.md +37 -0
  44. package/docs/product/team-run.md +39 -0
  45. package/docs/product/team-tool.md +37 -0
  46. package/docs/publishing.md +65 -65
  47. package/docs/resource-formats.md +134 -134
  48. package/docs/runtime-analysis-child-vs-live.md +171 -0
  49. package/docs/runtime-flow.md +148 -148
  50. package/docs/runtime-migration-in-process-analysis.md +250 -0
  51. package/docs/stories/README.md +30 -0
  52. package/docs/stories/backlog.md +36 -0
  53. package/docs/templates/decision.md +27 -0
  54. package/docs/templates/story.md +44 -0
  55. package/docs/templates/validation-report.md +32 -0
  56. package/docs/usage.md +238 -238
  57. package/index.ts +7 -6
  58. package/install.mjs +65 -65
  59. package/package.json +107 -100
  60. package/schema.json +222 -222
  61. package/skills/child-pi-spawning/SKILL.md +213 -0
  62. package/skills/context-artifact-hygiene/SKILL.md +32 -0
  63. package/skills/event-log-tracing/SKILL.md +299 -0
  64. package/skills/git-master/SKILL.md +225 -24
  65. package/skills/live-agent-lifecycle/SKILL.md +192 -0
  66. package/skills/mailbox-interactive/SKILL.md +300 -19
  67. package/skills/model-routing-context/SKILL.md +94 -0
  68. package/skills/multi-perspective-review/SKILL.md +88 -0
  69. package/skills/read-only-explorer/SKILL.md +250 -26
  70. package/skills/safe-bash/SKILL.md +307 -21
  71. package/skills/verification-before-done/SKILL.md +11 -2
  72. package/skills/widget-rendering/SKILL.md +258 -0
  73. package/skills/workspace-isolation/SKILL.md +202 -0
  74. package/skills/worktree-isolation/SKILL.md +202 -18
  75. package/src/adapters/claude-adapter.ts +25 -25
  76. package/src/adapters/codex-adapter.ts +21 -21
  77. package/src/adapters/cursor-adapter.ts +17 -17
  78. package/src/adapters/export-util.ts +137 -137
  79. package/src/adapters/index.ts +15 -15
  80. package/src/adapters/registry.ts +18 -18
  81. package/src/adapters/types.ts +23 -23
  82. package/src/agents/agent-config.ts +38 -38
  83. package/src/agents/agent-serializer.ts +38 -38
  84. package/src/agents/discover-agents.ts +121 -118
  85. package/src/config/config.ts +740 -858
  86. package/src/config/defaults.ts +96 -96
  87. package/src/config/drift-detector.ts +211 -211
  88. package/src/config/markers.ts +327 -327
  89. package/src/config/resilient-parser.ts +109 -108
  90. package/src/config/suggestions.ts +74 -74
  91. package/src/config/types.ts +199 -0
  92. package/src/extension/async-notifier.ts +123 -89
  93. package/src/extension/autonomous-policy.ts +169 -169
  94. package/src/extension/cross-extension-rpc.ts +104 -104
  95. package/src/extension/help.ts +47 -47
  96. package/src/extension/import-index.ts +69 -69
  97. package/src/extension/management.ts +395 -382
  98. package/src/extension/notification-router.ts +116 -116
  99. package/src/extension/notification-sink.ts +51 -51
  100. package/src/extension/project-init.ts +168 -168
  101. package/src/extension/register.ts +859 -668
  102. package/src/extension/registration/artifact-cleanup.ts +15 -15
  103. package/src/extension/registration/command-utils.ts +54 -54
  104. package/src/extension/registration/commands.ts +559 -452
  105. package/src/extension/registration/compaction-guard.ts +125 -125
  106. package/src/extension/registration/subagent-helpers.ts +102 -102
  107. package/src/extension/registration/subagent-tools.ts +220 -159
  108. package/src/extension/registration/team-tool.ts +159 -99
  109. package/src/extension/registration/viewers.ts +29 -0
  110. package/src/extension/result-watcher.ts +128 -128
  111. package/src/extension/run-bundle-schema.ts +89 -89
  112. package/src/extension/run-export.ts +73 -73
  113. package/src/extension/run-import.ts +84 -84
  114. package/src/extension/run-index.ts +94 -94
  115. package/src/extension/run-maintenance.ts +142 -142
  116. package/src/extension/session-summary.ts +8 -8
  117. package/src/extension/team-manager-command.ts +96 -96
  118. package/src/extension/team-recommendation.ts +188 -188
  119. package/src/extension/team-tool/api.ts +5 -2
  120. package/src/extension/team-tool/cancel.ts +224 -209
  121. package/src/extension/team-tool/config-patch.ts +36 -36
  122. package/src/extension/team-tool/context.ts +60 -60
  123. package/src/extension/team-tool/doctor.ts +242 -242
  124. package/src/extension/team-tool/handle-settings.ts +421 -195
  125. package/src/extension/team-tool/inspect.ts +41 -41
  126. package/src/extension/team-tool/lifecycle-actions.ts +139 -139
  127. package/src/extension/team-tool/parallel-dispatch.ts +156 -156
  128. package/src/extension/team-tool/plan.ts +19 -19
  129. package/src/extension/team-tool/respond.ts +112 -111
  130. package/src/extension/team-tool/run.ts +246 -229
  131. package/src/extension/team-tool/status.ts +110 -110
  132. package/src/extension/team-tool-types.ts +13 -13
  133. package/src/extension/team-tool.ts +344 -344
  134. package/src/extension/tool-result.ts +16 -16
  135. package/src/extension/validate-resources.ts +77 -77
  136. package/src/hooks/registry.ts +61 -61
  137. package/src/hooks/types.ts +40 -40
  138. package/src/i18n.ts +184 -184
  139. package/src/observability/correlation.ts +35 -35
  140. package/src/observability/event-to-metric.ts +68 -68
  141. package/src/observability/exporters/adapter.ts +30 -30
  142. package/src/observability/exporters/otlp-exporter.ts +106 -92
  143. package/src/observability/exporters/prometheus-exporter.ts +54 -54
  144. package/src/observability/metric-registry.ts +87 -87
  145. package/src/observability/metric-retention.ts +54 -54
  146. package/src/observability/metric-sink.ts +81 -56
  147. package/src/observability/metrics-primitives.ts +167 -167
  148. package/src/prompt/prompt-runtime.ts +72 -72
  149. package/src/runtime/adaptive-plan.ts +338 -0
  150. package/src/runtime/agent-control.ts +169 -169
  151. package/src/runtime/agent-memory.ts +72 -72
  152. package/src/runtime/agent-observability.ts +114 -114
  153. package/src/runtime/async-marker.ts +26 -26
  154. package/src/runtime/async-runner.ts +153 -153
  155. package/src/runtime/attention-events.ts +28 -28
  156. package/src/runtime/auto-resume.ts +100 -100
  157. package/src/runtime/background-runner.ts +122 -89
  158. package/src/runtime/cancellation.ts +61 -61
  159. package/src/runtime/capability-inventory.ts +116 -116
  160. package/src/runtime/child-pi-pool.ts +68 -0
  161. package/src/runtime/child-pi.ts +541 -461
  162. package/src/runtime/code-summary.ts +247 -247
  163. package/src/runtime/compaction-summary.ts +271 -271
  164. package/src/runtime/concurrency.ts +58 -58
  165. package/src/runtime/crash-recovery.ts +317 -301
  166. package/src/runtime/crew-agent-records.ts +379 -281
  167. package/src/runtime/crew-agent-runtime.ts +60 -60
  168. package/src/runtime/cross-extension-rpc.ts +72 -0
  169. package/src/runtime/custom-tools/irc-tool.ts +201 -201
  170. package/src/runtime/custom-tools/submit-result-tool.ts +90 -90
  171. package/src/runtime/deadletter.ts +47 -47
  172. package/src/runtime/delivery-coordinator.ts +176 -176
  173. package/src/runtime/delta-conflict.ts +360 -360
  174. package/src/runtime/diagnostic-export.ts +102 -102
  175. package/src/runtime/direct-run.ts +35 -35
  176. package/src/runtime/effectiveness.ts +82 -81
  177. package/src/runtime/errors/crew-errors.ts +166 -0
  178. package/src/runtime/event-stream-bridge.ts +92 -92
  179. package/src/runtime/foreground-control.ts +82 -82
  180. package/src/runtime/green-contract.ts +46 -46
  181. package/src/runtime/group-join.ts +234 -106
  182. package/src/runtime/heartbeat-watcher.ts +145 -124
  183. package/src/runtime/iteration-hooks.ts +267 -267
  184. package/src/runtime/live-agent-control.ts +88 -88
  185. package/src/runtime/live-agent-manager.ts +377 -179
  186. package/src/runtime/live-control-realtime.ts +36 -36
  187. package/src/runtime/live-session-runtime.ts +676 -600
  188. package/src/runtime/loop-gates.ts +129 -129
  189. package/src/runtime/manifest-cache.ts +263 -263
  190. package/src/runtime/mcp-proxy.ts +113 -113
  191. package/src/runtime/metric-parser.ts +40 -40
  192. package/src/runtime/model-fallback.ts +282 -274
  193. package/src/runtime/model-resolver.ts +118 -0
  194. package/src/runtime/output-validator.ts +187 -187
  195. package/src/runtime/overflow-recovery.ts +175 -175
  196. package/src/runtime/parallel-research.ts +44 -44
  197. package/src/runtime/parallel-utils.ts +156 -156
  198. package/src/runtime/parent-guard.ts +80 -80
  199. package/src/runtime/phase-progress.ts +217 -217
  200. package/src/runtime/pi-args.ts +165 -165
  201. package/src/runtime/pi-json-output.ts +111 -111
  202. package/src/runtime/pi-spawn.ts +167 -167
  203. package/src/runtime/policy-engine.ts +79 -79
  204. package/src/runtime/post-checks.ts +125 -125
  205. package/src/runtime/post-exit-stdio-guard.ts +86 -86
  206. package/src/runtime/process-status.ts +97 -73
  207. package/src/runtime/progress-event-coalescer.ts +43 -43
  208. package/src/runtime/recovery-recipes.ts +74 -74
  209. package/src/runtime/retry-executor.ts +81 -81
  210. package/src/runtime/role-permission.ts +39 -39
  211. package/src/runtime/run-tracker.ts +99 -0
  212. package/src/runtime/runtime-policy.ts +21 -0
  213. package/src/runtime/runtime-resolver.ts +94 -91
  214. package/src/runtime/scheduler.ts +294 -0
  215. package/src/runtime/semaphore.ts +131 -131
  216. package/src/runtime/sensitive-paths.ts +92 -92
  217. package/src/runtime/session-usage.ts +79 -79
  218. package/src/runtime/settings-store.ts +103 -0
  219. package/src/runtime/sidechain-output.ts +29 -29
  220. package/src/runtime/skill-instructions.ts +222 -222
  221. package/src/runtime/stale-reconciler.ts +198 -189
  222. package/src/runtime/streaming-output.ts +47 -0
  223. package/src/runtime/subagent-manager.ts +404 -400
  224. package/src/runtime/subprocess-tool-registry.ts +67 -67
  225. package/src/runtime/task-display.ts +38 -38
  226. package/src/runtime/task-graph-scheduler.ts +122 -122
  227. package/src/runtime/task-graph.ts +207 -207
  228. package/src/runtime/task-output-context.ts +177 -177
  229. package/src/runtime/task-packet.ts +93 -93
  230. package/src/runtime/task-quality.ts +207 -207
  231. package/src/runtime/task-runner/capabilities.ts +78 -78
  232. package/src/runtime/task-runner/live-executor.ts +131 -113
  233. package/src/runtime/task-runner/progress.ts +119 -119
  234. package/src/runtime/task-runner/prompt-builder.ts +139 -139
  235. package/src/runtime/task-runner/prompt-pipeline.ts +64 -64
  236. package/src/runtime/task-runner/result-utils.ts +14 -14
  237. package/src/runtime/task-runner/run-projection.ts +103 -103
  238. package/src/runtime/task-runner/state-helpers.ts +22 -22
  239. package/src/runtime/task-runner.ts +469 -459
  240. package/src/runtime/team-runner.ts +693 -945
  241. package/src/runtime/usage-tracker.ts +71 -0
  242. package/src/runtime/worker-heartbeat.ts +21 -21
  243. package/src/runtime/worker-startup.ts +57 -57
  244. package/src/runtime/workflow-state.ts +187 -187
  245. package/src/runtime/yield-handler.ts +190 -190
  246. package/src/schema/config-schema.ts +172 -168
  247. package/src/schema/team-tool-schema.ts +126 -126
  248. package/src/schema/validation-types.ts +151 -148
  249. package/src/skills/discover-skills.ts +67 -67
  250. package/src/skills/skill-templates.ts +374 -374
  251. package/src/state/active-run-registry.ts +227 -191
  252. package/src/state/artifact-store.ts +130 -129
  253. package/src/state/atomic-write.ts +262 -195
  254. package/src/state/blob-store.ts +116 -116
  255. package/src/state/contracts.ts +111 -111
  256. package/src/state/event-log-rotation.ts +161 -158
  257. package/src/state/event-log.ts +383 -303
  258. package/src/state/event-reconstructor.ts +217 -217
  259. package/src/state/jsonl-writer.ts +82 -82
  260. package/src/state/locks.ts +146 -146
  261. package/src/state/mailbox.ts +446 -405
  262. package/src/state/state-store.ts +364 -351
  263. package/src/state/task-claims.ts +44 -44
  264. package/src/state/types.ts +285 -285
  265. package/src/state/usage.ts +29 -29
  266. package/src/subagents/async-entry.ts +1 -1
  267. package/src/subagents/index.ts +3 -3
  268. package/src/subagents/live/control.ts +1 -1
  269. package/src/subagents/live/manager.ts +1 -1
  270. package/src/subagents/live/realtime.ts +1 -1
  271. package/src/subagents/live/session-runtime.ts +1 -1
  272. package/src/subagents/manager.ts +1 -1
  273. package/src/subagents/spawn.ts +1 -1
  274. package/src/teams/discover-teams.ts +116 -116
  275. package/src/teams/team-config.ts +27 -27
  276. package/src/teams/team-serializer.ts +38 -38
  277. package/src/types/diff.d.ts +18 -18
  278. package/src/ui/agent-management-overlay.ts +144 -144
  279. package/src/ui/crew-widget.ts +487 -370
  280. package/src/ui/dashboard-panes/agents-pane.ts +109 -28
  281. package/src/ui/dashboard-panes/cancellation-pane.ts +42 -42
  282. package/src/ui/dashboard-panes/capability-pane.ts +59 -59
  283. package/src/ui/dashboard-panes/health-pane.ts +30 -30
  284. package/src/ui/dashboard-panes/mailbox-pane.ts +35 -35
  285. package/src/ui/dashboard-panes/progress-pane.ts +30 -30
  286. package/src/ui/dashboard-panes/transcript-pane.ts +10 -10
  287. package/src/ui/heartbeat-aggregator.ts +63 -63
  288. package/src/ui/keybinding-map.ts +97 -94
  289. package/src/ui/live-conversation-overlay.ts +152 -0
  290. package/src/ui/live-run-sidebar.ts +180 -180
  291. package/src/ui/mascot.ts +442 -442
  292. package/src/ui/overlays/agent-picker-overlay.ts +57 -57
  293. package/src/ui/overlays/confirm-overlay.ts +58 -58
  294. package/src/ui/overlays/mailbox-compose-overlay.ts +144 -144
  295. package/src/ui/overlays/mailbox-compose-preview.ts +63 -63
  296. package/src/ui/overlays/mailbox-detail-overlay.ts +122 -122
  297. package/src/ui/pi-ui-compat.ts +57 -57
  298. package/src/ui/powerbar-publisher.ts +221 -197
  299. package/src/ui/render-scheduler.ts +216 -143
  300. package/src/ui/run-action-dispatcher.ts +118 -118
  301. package/src/ui/run-dashboard.ts +526 -464
  302. package/src/ui/run-event-bus.ts +208 -208
  303. package/src/ui/run-snapshot-cache.ts +826 -777
  304. package/src/ui/settings-overlay.ts +721 -0
  305. package/src/ui/snapshot-types.ts +86 -70
  306. package/src/ui/theme-adapter.ts +190 -190
  307. package/src/ui/tool-progress-formatter.ts +89 -0
  308. package/src/ui/transcript-cache.ts +94 -94
  309. package/src/ui/transcript-viewer.ts +335 -335
  310. package/src/utils/conflict-detect.ts +662 -0
  311. package/src/utils/file-coalescer.ts +86 -86
  312. package/src/utils/frontmatter.ts +68 -68
  313. package/src/utils/fs-watch.ts +88 -31
  314. package/src/utils/gh-protocol.ts +479 -0
  315. package/src/utils/ids.ts +17 -17
  316. package/src/utils/incremental-reader.ts +104 -104
  317. package/src/utils/internal-error.ts +6 -6
  318. package/src/utils/names.ts +27 -27
  319. package/src/utils/paths.ts +102 -63
  320. package/src/utils/redaction.ts +44 -44
  321. package/src/utils/safe-paths.ts +47 -47
  322. package/src/utils/scan-cache.ts +136 -136
  323. package/src/utils/sse-parser.ts +134 -134
  324. package/src/utils/task-name-generator.ts +337 -337
  325. package/src/utils/timings.ts +33 -33
  326. package/src/utils/visual.ts +243 -198
  327. package/src/workflows/discover-workflows.ts +139 -139
  328. package/src/workflows/validate-workflow.ts +40 -40
  329. package/src/workflows/workflow-config.ts +26 -26
  330. package/src/workflows/workflow-serializer.ts +32 -32
  331. package/src/worktree/branch-freshness.ts +45 -45
  332. package/src/worktree/cleanup.ts +75 -75
  333. package/src/worktree/worktree-manager.ts +188 -188
  334. package/teams/default.team.md +12 -12
  335. package/teams/fast-fix.team.md +11 -11
  336. package/teams/implementation.team.md +18 -18
  337. package/teams/parallel-research.team.md +14 -14
  338. package/teams/research.team.md +11 -11
  339. package/teams/review.team.md +12 -12
  340. package/tsconfig.json +19 -19
  341. package/workflows/default.workflow.md +30 -30
  342. package/workflows/fast-fix.workflow.md +23 -23
  343. package/workflows/implementation.workflow.md +43 -43
  344. package/workflows/parallel-research.workflow.md +46 -46
  345. package/workflows/research.workflow.md +22 -22
  346. package/workflows/review.workflow.md +30 -30
  347. package/skills/task-packet/SKILL.md +0 -28
  348. package/skills/verify-evidence/SKILL.md +0 -27
@@ -1,168 +1,172 @@
1
- import { Type } from "typebox";
2
- export { validateWithSeverity, type ValidationSeverity, type ValidationMode, type ValidationFinding, type ValidationOutcome } from "./validation-types.ts";
3
-
4
- export const PiTeamsAutonomyProfileSchema = Type.Union([
5
- Type.Literal("manual"),
6
- Type.Literal("suggested"),
7
- Type.Literal("assisted"),
8
- Type.Literal("aggressive"),
9
- ]);
10
-
11
- export const PiTeamsAutonomousConfigSchema = Type.Object({
12
- profile: Type.Optional(PiTeamsAutonomyProfileSchema),
13
- enabled: Type.Optional(Type.Boolean()),
14
- injectPolicy: Type.Optional(Type.Boolean()),
15
- preferAsyncForLongTasks: Type.Optional(Type.Boolean()),
16
- allowWorktreeSuggestion: Type.Optional(Type.Boolean()),
17
- magicKeywords: Type.Optional(Type.Record(Type.String({ minLength: 1 }), Type.Array(Type.String({ minLength: 1 })))),
18
- }, { additionalProperties: false });
19
-
20
- export const PiTeamsLimitsConfigSchema = Type.Object({
21
- maxConcurrentWorkers: Type.Optional(Type.Integer({ minimum: 1 })),
22
- allowUnboundedConcurrency: Type.Optional(Type.Boolean()),
23
- maxTaskDepth: Type.Optional(Type.Integer({ minimum: 1 })),
24
- maxChildrenPerTask: Type.Optional(Type.Integer({ minimum: 1 })),
25
- maxRunMinutes: Type.Optional(Type.Integer({ minimum: 1 })),
26
- maxRetriesPerTask: Type.Optional(Type.Integer({ minimum: 1 })),
27
- maxTasksPerRun: Type.Optional(Type.Integer({ minimum: 1 })),
28
- heartbeatStaleMs: Type.Optional(Type.Integer({ minimum: 1 })),
29
- }, { additionalProperties: false });
30
-
31
- export const PiTeamsRuntimeConfigSchema = Type.Object({
32
- mode: Type.Optional(Type.Union([Type.Literal("auto"), Type.Literal("scaffold"), Type.Literal("child-process"), Type.Literal("live-session")])),
33
- preferLiveSession: Type.Optional(Type.Boolean()),
34
- allowChildProcessFallback: Type.Optional(Type.Boolean()),
35
- maxTurns: Type.Optional(Type.Integer({ minimum: 1 })),
36
- graceTurns: Type.Optional(Type.Integer({ minimum: 1 })),
37
- inheritContext: Type.Optional(Type.Boolean()),
38
- promptMode: Type.Optional(Type.Union([Type.Literal("replace"), Type.Literal("append")])),
39
- groupJoin: Type.Optional(Type.Union([Type.Literal("off"), Type.Literal("group"), Type.Literal("smart")])),
40
- groupJoinAckTimeoutMs: Type.Optional(Type.Integer({ minimum: 1 })),
41
- requirePlanApproval: Type.Optional(Type.Boolean()),
42
- completionMutationGuard: Type.Optional(Type.Union([Type.Literal("off"), Type.Literal("warn"), Type.Literal("fail")])),
43
- effectivenessGuard: Type.Optional(Type.Union([Type.Literal("off"), Type.Literal("warn"), Type.Literal("block"), Type.Literal("fail")])),
44
- }, { additionalProperties: false });
45
-
46
- export const PiTeamsControlConfigSchema = Type.Object({
47
- enabled: Type.Optional(Type.Boolean()),
48
- needsAttentionAfterMs: Type.Optional(Type.Integer({ minimum: 1 })),
49
- }, { additionalProperties: false });
50
-
51
- export const PiTeamsWorktreeConfigSchema = Type.Object({
52
- setupHook: Type.Optional(Type.String({ minLength: 1 })),
53
- setupHookTimeoutMs: Type.Optional(Type.Integer({ minimum: 1 })),
54
- linkNodeModules: Type.Optional(Type.Boolean()),
55
- }, { additionalProperties: false });
56
-
57
- export const AgentOverrideSchema = Type.Object({
58
- disabled: Type.Optional(Type.Boolean()),
59
- model: Type.Optional(Type.Union([Type.String({ minLength: 1 }), Type.Literal(false)])),
60
- fallbackModels: Type.Optional(Type.Union([Type.Array(Type.String({ minLength: 1 })), Type.Literal(false)])),
61
- thinking: Type.Optional(Type.Union([Type.String({ minLength: 1 }), Type.Literal(false)])),
62
- tools: Type.Optional(Type.Union([Type.Array(Type.String({ minLength: 1 })), Type.Literal(false)])),
63
- skills: Type.Optional(Type.Union([Type.Array(Type.String({ minLength: 1 })), Type.Literal(false)])),
64
- }, { additionalProperties: false });
65
-
66
- export const PiTeamsAgentsConfigSchema = Type.Object({
67
- disableBuiltins: Type.Optional(Type.Boolean()),
68
- overrides: Type.Optional(Type.Record(Type.String({ minLength: 1 }), AgentOverrideSchema)),
69
- }, { additionalProperties: false });
70
-
71
- export const PiTeamsToolsConfigSchema = Type.Object({
72
- enableClaudeStyleAliases: Type.Optional(Type.Boolean()),
73
- enableSteer: Type.Optional(Type.Boolean()),
74
- terminateOnForeground: Type.Optional(Type.Boolean()),
75
- }, { additionalProperties: false });
76
-
77
- export const PiTeamsTelemetryConfigSchema = Type.Object({
78
- enabled: Type.Optional(Type.Boolean()),
79
- }, { additionalProperties: false });
80
-
81
- export const PiTeamsPolicyConfigSchema = Type.Object({
82
- requireIntentForDestructiveActions: Type.Optional(Type.Boolean()),
83
- disabledCapabilities: Type.Optional(Type.Array(Type.String())),
84
- }, { additionalProperties: false });
85
-
86
- export const PiTeamsNotificationsConfigSchema = Type.Object({
87
- enabled: Type.Optional(Type.Boolean()),
88
- severityFilter: Type.Optional(Type.Array(Type.Union([Type.Literal("info"), Type.Literal("warning"), Type.Literal("error"), Type.Literal("critical")]))),
89
- dedupWindowMs: Type.Optional(Type.Integer({ minimum: 1000 })),
90
- batchWindowMs: Type.Optional(Type.Integer({ minimum: 0 })),
91
- quietHours: Type.Optional(Type.String({ pattern: "^\\d{2}:\\d{2}-\\d{2}:\\d{2}$" })),
92
- sinkRetentionDays: Type.Optional(Type.Integer({ minimum: 1, maximum: 90 })),
93
- }, { additionalProperties: false });
94
-
95
- export const PiTeamsObservabilityConfigSchema = Type.Object({
96
- enabled: Type.Optional(Type.Boolean()),
97
- pollIntervalMs: Type.Optional(Type.Integer({ minimum: 1000, maximum: 60000 })),
98
- metricRetentionDays: Type.Optional(Type.Integer({ minimum: 1, maximum: 365 })),
99
- }, { additionalProperties: false });
100
-
101
- export const PiTeamsReliabilityConfigSchema = Type.Object({
102
- autoRetry: Type.Optional(Type.Boolean()),
103
- retryPolicy: Type.Optional(Type.Object({
104
- maxAttempts: Type.Optional(Type.Integer({ minimum: 1, maximum: 10 })),
105
- backoffMs: Type.Optional(Type.Integer({ minimum: 100, maximum: 60000 })),
106
- jitterRatio: Type.Optional(Type.Number({ minimum: 0, maximum: 1 })),
107
- exponentialFactor: Type.Optional(Type.Number({ minimum: 1, maximum: 5 })),
108
- retryableErrors: Type.Optional(Type.Array(Type.String({ minLength: 1 }))),
109
- }, { additionalProperties: false })),
110
- autoRecover: Type.Optional(Type.Boolean()),
111
- deadletterThreshold: Type.Optional(Type.Integer({ minimum: 1 })),
112
- }, { additionalProperties: false });
113
-
114
- export const PiTeamsOtlpConfigSchema = Type.Object({
115
- enabled: Type.Optional(Type.Boolean()),
116
- endpoint: Type.Optional(Type.String({ minLength: 1 })),
117
- headers: Type.Optional(Type.Record(Type.String({ minLength: 1 }), Type.String())),
118
- intervalMs: Type.Optional(Type.Integer({ minimum: 5000 })),
119
- }, { additionalProperties: false });
120
-
121
- export const PiTeamsUiConfigSchema = Type.Object({
122
- widgetPlacement: Type.Optional(Type.Union([Type.Literal("aboveEditor"), Type.Literal("belowEditor")])),
123
- widgetMaxLines: Type.Optional(Type.Integer({ minimum: 1, maximum: 50 })),
124
- powerbar: Type.Optional(Type.Boolean()),
125
- dashboardPlacement: Type.Optional(Type.Union([Type.Literal("center"), Type.Literal("right")])),
126
- dashboardWidth: Type.Optional(Type.Integer({ minimum: 32, maximum: 120 })),
127
- dashboardLiveRefreshMs: Type.Optional(Type.Integer({ minimum: 250, maximum: 60000 })),
128
- autoOpenDashboard: Type.Optional(Type.Boolean()),
129
- autoOpenDashboardForForegroundRuns: Type.Optional(Type.Boolean()),
130
- showModel: Type.Optional(Type.Boolean()),
131
- showTokens: Type.Optional(Type.Boolean()),
132
- showTools: Type.Optional(Type.Boolean()),
133
- transcriptTailBytes: Type.Optional(Type.Integer({ minimum: 1024, maximum: 50 * 1024 * 1024 })),
134
- mascotStyle: Type.Optional(Type.Union([Type.Literal("cat"), Type.Literal("armin")])),
135
- mascotEffect: Type.Optional(Type.Union([Type.Literal("random"), Type.Literal("none"), Type.Literal("typewriter"), Type.Literal("scanline"), Type.Literal("rain"), Type.Literal("fade"), Type.Literal("crt"), Type.Literal("glitch"), Type.Literal("dissolve")])),
136
- }, { additionalProperties: false });
137
-
138
- export const PiTeamsConfigSchema = Type.Object({
139
- asyncByDefault: Type.Optional(Type.Boolean()),
140
- executeWorkers: Type.Optional(Type.Boolean()),
141
- notifierIntervalMs: Type.Optional(Type.Number({ minimum: 1000 })),
142
- requireCleanWorktreeLeader: Type.Optional(Type.Boolean()),
143
- ignoreMethod: Type.Optional(Type.Union([Type.Literal("gitignore"), Type.Literal("exclude")])),
144
- autonomous: Type.Optional(PiTeamsAutonomousConfigSchema),
145
- limits: Type.Optional(PiTeamsLimitsConfigSchema),
146
- runtime: Type.Optional(PiTeamsRuntimeConfigSchema),
147
- control: Type.Optional(PiTeamsControlConfigSchema),
148
- worktree: Type.Optional(PiTeamsWorktreeConfigSchema),
149
- agents: Type.Optional(PiTeamsAgentsConfigSchema),
150
- tools: Type.Optional(PiTeamsToolsConfigSchema),
151
- telemetry: Type.Optional(PiTeamsTelemetryConfigSchema),
152
- policy: Type.Optional(PiTeamsPolicyConfigSchema),
153
- notifications: Type.Optional(PiTeamsNotificationsConfigSchema),
154
- observability: Type.Optional(PiTeamsObservabilityConfigSchema),
155
- reliability: Type.Optional(PiTeamsReliabilityConfigSchema),
156
- otlp: Type.Optional(PiTeamsOtlpConfigSchema),
157
- ui: Type.Optional(PiTeamsUiConfigSchema),
158
- }, { additionalProperties: false });
159
-
160
- import { validateWithSeverity as _validateWithSeverity, type ValidationMode, type ValidationOutcome } from "./validation-types.ts";
161
-
162
- /**
163
- * Convenience wrapper — validate a raw config value with severity-tagged findings.
164
- * Delegates to `validateWithSeverity` from validation-types.ts.
165
- */
166
- export function validateConfig(raw: unknown, mode?: ValidationMode): ValidationOutcome {
167
- return _validateWithSeverity(raw, mode);
168
- }
1
+ import { Type } from "@sinclair/typebox";
2
+ export { validateWithSeverity, type ValidationSeverity, type ValidationMode, type ValidationFinding, type ValidationOutcome } from "./validation-types.ts";
3
+
4
+ export const PiTeamsAutonomyProfileSchema = Type.Union([
5
+ Type.Literal("manual"),
6
+ Type.Literal("suggested"),
7
+ Type.Literal("assisted"),
8
+ Type.Literal("aggressive"),
9
+ ]);
10
+
11
+ export const PiTeamsAutonomousConfigSchema = Type.Object({
12
+ profile: Type.Optional(PiTeamsAutonomyProfileSchema),
13
+ enabled: Type.Optional(Type.Boolean()),
14
+ injectPolicy: Type.Optional(Type.Boolean()),
15
+ preferAsyncForLongTasks: Type.Optional(Type.Boolean()),
16
+ allowWorktreeSuggestion: Type.Optional(Type.Boolean()),
17
+ magicKeywords: Type.Optional(Type.Record(Type.String({ minLength: 1 }), Type.Array(Type.String({ minLength: 1 })))),
18
+ }, { additionalProperties: false });
19
+
20
+ export const PiTeamsLimitsConfigSchema = Type.Object({
21
+ maxConcurrentWorkers: Type.Optional(Type.Integer({ minimum: 1 })),
22
+ allowUnboundedConcurrency: Type.Optional(Type.Boolean()),
23
+ maxTaskDepth: Type.Optional(Type.Integer({ minimum: 1 })),
24
+ maxChildrenPerTask: Type.Optional(Type.Integer({ minimum: 1 })),
25
+ maxRunMinutes: Type.Optional(Type.Integer({ minimum: 1 })),
26
+ maxRetriesPerTask: Type.Optional(Type.Integer({ minimum: 1 })),
27
+ maxTasksPerRun: Type.Optional(Type.Integer({ minimum: 1 })),
28
+ heartbeatStaleMs: Type.Optional(Type.Integer({ minimum: 1 })),
29
+ }, { additionalProperties: false });
30
+
31
+ export const PiTeamsRuntimeConfigSchema = Type.Object({
32
+ mode: Type.Optional(Type.Union([Type.Literal("auto"), Type.Literal("scaffold"), Type.Literal("child-process"), Type.Literal("live-session")])),
33
+ preferLiveSession: Type.Optional(Type.Boolean()),
34
+ allowChildProcessFallback: Type.Optional(Type.Boolean()),
35
+ maxTurns: Type.Optional(Type.Integer({ minimum: 1 })),
36
+ graceTurns: Type.Optional(Type.Integer({ minimum: 1 })),
37
+ inheritContext: Type.Optional(Type.Boolean()),
38
+ promptMode: Type.Optional(Type.Union([Type.Literal("replace"), Type.Literal("append")])),
39
+ groupJoin: Type.Optional(Type.Union([Type.Literal("off"), Type.Literal("group"), Type.Literal("smart")])),
40
+ groupJoinAckTimeoutMs: Type.Optional(Type.Integer({ minimum: 1 })),
41
+ requirePlanApproval: Type.Optional(Type.Boolean()),
42
+ completionMutationGuard: Type.Optional(Type.Union([Type.Literal("off"), Type.Literal("warn"), Type.Literal("fail")])),
43
+ effectivenessGuard: Type.Optional(Type.Union([Type.Literal("off"), Type.Literal("warn"), Type.Literal("block"), Type.Literal("fail")])),
44
+ isolationPolicy: Type.Optional(Type.Object({
45
+ isolatedRoles: Type.Optional(Type.Array(Type.String({ minLength: 1 }))),
46
+ defaultRuntime: Type.Optional(Type.Union([Type.Literal("live-session"), Type.Literal("child-process")])),
47
+ }, { additionalProperties: false })),
48
+ }, { additionalProperties: false });
49
+
50
+ export const PiTeamsControlConfigSchema = Type.Object({
51
+ enabled: Type.Optional(Type.Boolean()),
52
+ needsAttentionAfterMs: Type.Optional(Type.Integer({ minimum: 1 })),
53
+ }, { additionalProperties: false });
54
+
55
+ export const PiTeamsWorktreeConfigSchema = Type.Object({
56
+ setupHook: Type.Optional(Type.String({ minLength: 1 })),
57
+ setupHookTimeoutMs: Type.Optional(Type.Integer({ minimum: 1 })),
58
+ linkNodeModules: Type.Optional(Type.Boolean()),
59
+ }, { additionalProperties: false });
60
+
61
+ export const AgentOverrideSchema = Type.Object({
62
+ disabled: Type.Optional(Type.Boolean()),
63
+ model: Type.Optional(Type.Union([Type.String({ minLength: 1 }), Type.Literal(false)])),
64
+ fallbackModels: Type.Optional(Type.Union([Type.Array(Type.String({ minLength: 1 })), Type.Literal(false)])),
65
+ thinking: Type.Optional(Type.Union([Type.String({ minLength: 1 }), Type.Literal(false)])),
66
+ tools: Type.Optional(Type.Union([Type.Array(Type.String({ minLength: 1 })), Type.Literal(false)])),
67
+ skills: Type.Optional(Type.Union([Type.Array(Type.String({ minLength: 1 })), Type.Literal(false)])),
68
+ }, { additionalProperties: false });
69
+
70
+ export const PiTeamsAgentsConfigSchema = Type.Object({
71
+ disableBuiltins: Type.Optional(Type.Boolean()),
72
+ overrides: Type.Optional(Type.Record(Type.String({ minLength: 1 }), AgentOverrideSchema)),
73
+ }, { additionalProperties: false });
74
+
75
+ export const PiTeamsToolsConfigSchema = Type.Object({
76
+ enableClaudeStyleAliases: Type.Optional(Type.Boolean()),
77
+ enableSteer: Type.Optional(Type.Boolean()),
78
+ terminateOnForeground: Type.Optional(Type.Boolean()),
79
+ }, { additionalProperties: false });
80
+
81
+ export const PiTeamsTelemetryConfigSchema = Type.Object({
82
+ enabled: Type.Optional(Type.Boolean()),
83
+ }, { additionalProperties: false });
84
+
85
+ export const PiTeamsPolicyConfigSchema = Type.Object({
86
+ requireIntentForDestructiveActions: Type.Optional(Type.Boolean()),
87
+ disabledCapabilities: Type.Optional(Type.Array(Type.String())),
88
+ }, { additionalProperties: false });
89
+
90
+ export const PiTeamsNotificationsConfigSchema = Type.Object({
91
+ enabled: Type.Optional(Type.Boolean()),
92
+ severityFilter: Type.Optional(Type.Array(Type.Union([Type.Literal("info"), Type.Literal("warning"), Type.Literal("error"), Type.Literal("critical")]))),
93
+ dedupWindowMs: Type.Optional(Type.Integer({ minimum: 1000 })),
94
+ batchWindowMs: Type.Optional(Type.Integer({ minimum: 0 })),
95
+ quietHours: Type.Optional(Type.String({ pattern: "^\\d{2}:\\d{2}-\\d{2}:\\d{2}$" })),
96
+ sinkRetentionDays: Type.Optional(Type.Integer({ minimum: 1, maximum: 90 })),
97
+ }, { additionalProperties: false });
98
+
99
+ export const PiTeamsObservabilityConfigSchema = Type.Object({
100
+ enabled: Type.Optional(Type.Boolean()),
101
+ pollIntervalMs: Type.Optional(Type.Integer({ minimum: 1000, maximum: 60000 })),
102
+ metricRetentionDays: Type.Optional(Type.Integer({ minimum: 1, maximum: 365 })),
103
+ }, { additionalProperties: false });
104
+
105
+ export const PiTeamsReliabilityConfigSchema = Type.Object({
106
+ autoRetry: Type.Optional(Type.Boolean()),
107
+ retryPolicy: Type.Optional(Type.Object({
108
+ maxAttempts: Type.Optional(Type.Integer({ minimum: 1, maximum: 10 })),
109
+ backoffMs: Type.Optional(Type.Integer({ minimum: 100, maximum: 60000 })),
110
+ jitterRatio: Type.Optional(Type.Number({ minimum: 0, maximum: 1 })),
111
+ exponentialFactor: Type.Optional(Type.Number({ minimum: 1, maximum: 5 })),
112
+ retryableErrors: Type.Optional(Type.Array(Type.String({ minLength: 1 }))),
113
+ }, { additionalProperties: false })),
114
+ autoRecover: Type.Optional(Type.Boolean()),
115
+ deadletterThreshold: Type.Optional(Type.Integer({ minimum: 1 })),
116
+ }, { additionalProperties: false });
117
+
118
+ export const PiTeamsOtlpConfigSchema = Type.Object({
119
+ enabled: Type.Optional(Type.Boolean()),
120
+ endpoint: Type.Optional(Type.String({ minLength: 1 })),
121
+ headers: Type.Optional(Type.Record(Type.String({ minLength: 1 }), Type.String())),
122
+ intervalMs: Type.Optional(Type.Integer({ minimum: 5000 })),
123
+ }, { additionalProperties: false });
124
+
125
+ export const PiTeamsUiConfigSchema = Type.Object({
126
+ widgetPlacement: Type.Optional(Type.Union([Type.Literal("aboveEditor"), Type.Literal("belowEditor")])),
127
+ widgetMaxLines: Type.Optional(Type.Integer({ minimum: 1, maximum: 50 })),
128
+ powerbar: Type.Optional(Type.Boolean()),
129
+ dashboardPlacement: Type.Optional(Type.Union([Type.Literal("center"), Type.Literal("right")])),
130
+ dashboardWidth: Type.Optional(Type.Integer({ minimum: 32, maximum: 120 })),
131
+ dashboardLiveRefreshMs: Type.Optional(Type.Integer({ minimum: 250, maximum: 60000 })),
132
+ autoOpenDashboard: Type.Optional(Type.Boolean()),
133
+ autoOpenDashboardForForegroundRuns: Type.Optional(Type.Boolean()),
134
+ showModel: Type.Optional(Type.Boolean()),
135
+ showTokens: Type.Optional(Type.Boolean()),
136
+ showTools: Type.Optional(Type.Boolean()),
137
+ transcriptTailBytes: Type.Optional(Type.Integer({ minimum: 1024, maximum: 50 * 1024 * 1024 })),
138
+ mascotStyle: Type.Optional(Type.Union([Type.Literal("cat"), Type.Literal("armin")])),
139
+ mascotEffect: Type.Optional(Type.Union([Type.Literal("random"), Type.Literal("none"), Type.Literal("typewriter"), Type.Literal("scanline"), Type.Literal("rain"), Type.Literal("fade"), Type.Literal("crt"), Type.Literal("glitch"), Type.Literal("dissolve")])),
140
+ }, { additionalProperties: false });
141
+
142
+ export const PiTeamsConfigSchema = Type.Object({
143
+ asyncByDefault: Type.Optional(Type.Boolean()),
144
+ executeWorkers: Type.Optional(Type.Boolean()),
145
+ notifierIntervalMs: Type.Optional(Type.Number({ minimum: 1000 })),
146
+ requireCleanWorktreeLeader: Type.Optional(Type.Boolean()),
147
+ ignoreMethod: Type.Optional(Type.Union([Type.Literal("gitignore"), Type.Literal("exclude")])),
148
+ autonomous: Type.Optional(PiTeamsAutonomousConfigSchema),
149
+ limits: Type.Optional(PiTeamsLimitsConfigSchema),
150
+ runtime: Type.Optional(PiTeamsRuntimeConfigSchema),
151
+ control: Type.Optional(PiTeamsControlConfigSchema),
152
+ worktree: Type.Optional(PiTeamsWorktreeConfigSchema),
153
+ agents: Type.Optional(PiTeamsAgentsConfigSchema),
154
+ tools: Type.Optional(PiTeamsToolsConfigSchema),
155
+ telemetry: Type.Optional(PiTeamsTelemetryConfigSchema),
156
+ policy: Type.Optional(PiTeamsPolicyConfigSchema),
157
+ notifications: Type.Optional(PiTeamsNotificationsConfigSchema),
158
+ observability: Type.Optional(PiTeamsObservabilityConfigSchema),
159
+ reliability: Type.Optional(PiTeamsReliabilityConfigSchema),
160
+ otlp: Type.Optional(PiTeamsOtlpConfigSchema),
161
+ ui: Type.Optional(PiTeamsUiConfigSchema),
162
+ }, { additionalProperties: false });
163
+
164
+ import { validateWithSeverity as _validateWithSeverity, type ValidationMode, type ValidationOutcome } from "./validation-types.ts";
165
+
166
+ /**
167
+ * Convenience wrapper — validate a raw config value with severity-tagged findings.
168
+ * Delegates to `validateWithSeverity` from validation-types.ts.
169
+ */
170
+ export function validateConfig(raw: unknown, mode?: ValidationMode): ValidationOutcome {
171
+ return _validateWithSeverity(raw, mode);
172
+ }
@@ -1,126 +1,126 @@
1
- import { Type } from "typebox";
2
-
3
- const SkillOverride = Type.Unsafe({
4
- description: "Skill name(s) to add to role/default skills, an array of skill names, or false to disable all injected skills for this run.",
5
- anyOf: [
6
- { type: "string", maxLength: 2048 },
7
- { type: "array", maxItems: 32, items: { type: "string", maxLength: 80 } },
8
- { type: "boolean" },
9
- ],
10
- });
11
-
12
- const FreeformConfig = Type.Unsafe({
13
- description: "Resource config for management actions.",
14
- type: "object",
15
- additionalProperties: true,
16
- });
17
-
18
- export const TeamToolParams = Type.Object({
19
- action: Type.Optional(Type.Union([
20
- Type.Literal("run"),
21
- Type.Literal("parallel"),
22
- Type.Literal("plan"),
23
- Type.Literal("status"),
24
- Type.Literal("list"),
25
- Type.Literal("get"),
26
- Type.Literal("cancel"),
27
- Type.Literal("retry"),
28
- Type.Literal("resume"),
29
- Type.Literal("respond"),
30
- Type.Literal("create"),
31
- Type.Literal("update"),
32
- Type.Literal("delete"),
33
- Type.Literal("doctor"),
34
- Type.Literal("cleanup"),
35
- Type.Literal("events"),
36
- Type.Literal("artifacts"),
37
- Type.Literal("worktrees"),
38
- Type.Literal("forget"),
39
- Type.Literal("summary"),
40
- Type.Literal("prune"),
41
- Type.Literal("export"),
42
- Type.Literal("import"),
43
- Type.Literal("imports"),
44
- Type.Literal("help"),
45
- Type.Literal("validate"),
46
- Type.Literal("config"),
47
- Type.Literal("init"),
48
- Type.Literal("recommend"),
49
- Type.Literal("autonomy"),
50
- Type.Literal("api"),
51
- Type.Literal("settings"),
52
- ], { description: "Team action. Defaults to 'list' when omitted." })),
53
- resource: Type.Optional(Type.Union([
54
- Type.Literal("agent"),
55
- Type.Literal("team"),
56
- Type.Literal("workflow"),
57
- ], { description: "Resource kind for get/create/update/delete/list. Defaults to all for list." })),
58
- team: Type.Optional(Type.String({ description: "Team name, e.g. default or implementation." })),
59
- workflow: Type.Optional(Type.String({ description: "Workflow name, e.g. default or review." })),
60
- role: Type.Optional(Type.String({ description: "Role name to run directly within a team." })),
61
- agent: Type.Optional(Type.String({ description: "Agent name to inspect or run directly." })),
62
- goal: Type.Optional(Type.String({ description: "High-level objective for a team run." })),
63
- task: Type.Optional(Type.String({ description: "Concrete task text for direct role/agent execution." })),
64
- runId: Type.Optional(Type.String({ description: "Run ID for status, cancel, or resume." })),
65
- taskId: Type.Optional(Type.String({ description: "Task ID for respond action." })),
66
- message: Type.Optional(Type.String({ description: "Message for respond action." })),
67
- async: Type.Optional(Type.Boolean({ description: "Run in background when execution support is enabled." })),
68
- workspaceMode: Type.Optional(Type.Union([
69
- Type.Literal("single"),
70
- Type.Literal("worktree"),
71
- ], { description: "Workspace isolation mode. Worktree mode is planned after MVP." })),
72
- context: Type.Optional(Type.Union([
73
- Type.Literal("fresh"),
74
- Type.Literal("fork"),
75
- ], { description: "Child context mode for workers." })),
76
- cwd: Type.Optional(Type.String({ description: "Working directory override." })),
77
- model: Type.Optional(Type.String({ description: "Model override for direct runs." })),
78
- skill: Type.Optional(SkillOverride),
79
- scope: Type.Optional(Type.Union([
80
- Type.Literal("user"),
81
- Type.Literal("project"),
82
- Type.Literal("both"),
83
- ], { description: "Resource scope for discovery or management." })),
84
- config: Type.Optional(FreeformConfig),
85
- dryRun: Type.Optional(Type.Boolean({ description: "Preview a management mutation without writing files." })),
86
- confirm: Type.Optional(Type.Boolean({ description: "Required for destructive management actions." })),
87
- force: Type.Optional(Type.Boolean({ description: "Override reference checks for destructive management actions." })),
88
- keep: Type.Optional(Type.Integer({ minimum: 0, description: "Number of finished runs to keep for prune." })),
89
- updateReferences: Type.Optional(Type.Boolean({ description: "When renaming agents or workflows, update team references in the same project/user scope." })),
90
- replyTo: Type.Optional(Type.String({ description: "ID of the original mailbox message this is a reply to." })),
91
- replyFrom: Type.Optional(Type.String({ description: "Task ID sending the reply." })),
92
- replyDeadline: Type.Optional(Type.Integer({ description: "Ms epoch deadline for a reply." })),
93
- });
94
-
95
- export interface TeamToolParamsValue {
96
- action?: "run" | "parallel" | "plan" | "status" | "list" | "get" | "cancel" | "retry" | "resume" | "respond" | "create" | "update" | "delete" | "doctor" | "cleanup" | "events" | "artifacts" | "worktrees" | "forget" | "summary" | "prune" | "export" | "import" | "imports" | "help" | "validate" | "config" | "init" | "recommend" | "autonomy" | "api" | "settings";
97
- resource?: "agent" | "team" | "workflow";
98
- team?: string;
99
- workflow?: string;
100
- role?: string;
101
- agent?: string;
102
- goal?: string;
103
- task?: string;
104
- runId?: string;
105
- taskId?: string;
106
- message?: string;
107
- async?: boolean;
108
- workspaceMode?: "single" | "worktree";
109
- context?: "fresh" | "fork";
110
- cwd?: string;
111
- model?: string;
112
- skill?: string | string[] | boolean;
113
- scope?: "user" | "project" | "both";
114
- config?: Record<string, unknown>;
115
- dryRun?: boolean;
116
- confirm?: boolean;
117
- force?: boolean;
118
- keep?: number;
119
- updateReferences?: boolean;
120
- /** ID of the original mailbox message this is a reply to. */
121
- replyTo?: string;
122
- /** Task ID sending the reply. */
123
- replyFrom?: string;
124
- /** Ms epoch deadline for a reply. */
125
- replyDeadline?: number;
126
- }
1
+ import { Type } from "@sinclair/typebox";
2
+
3
+ const SkillOverride = Type.Unsafe({
4
+ description: "Skill name(s) to add to role/default skills, an array of skill names, or false to disable all injected skills for this run.",
5
+ anyOf: [
6
+ { type: "string", maxLength: 2048 },
7
+ { type: "array", maxItems: 32, items: { type: "string", maxLength: 80 } },
8
+ { type: "boolean" },
9
+ ],
10
+ });
11
+
12
+ const FreeformConfig = Type.Unsafe({
13
+ description: "Resource config for management actions.",
14
+ type: "object",
15
+ additionalProperties: true,
16
+ });
17
+
18
+ export const TeamToolParams = Type.Object({
19
+ action: Type.Optional(Type.Union([
20
+ Type.Literal("run"),
21
+ Type.Literal("parallel"),
22
+ Type.Literal("plan"),
23
+ Type.Literal("status"),
24
+ Type.Literal("list"),
25
+ Type.Literal("get"),
26
+ Type.Literal("cancel"),
27
+ Type.Literal("retry"),
28
+ Type.Literal("resume"),
29
+ Type.Literal("respond"),
30
+ Type.Literal("create"),
31
+ Type.Literal("update"),
32
+ Type.Literal("delete"),
33
+ Type.Literal("doctor"),
34
+ Type.Literal("cleanup"),
35
+ Type.Literal("events"),
36
+ Type.Literal("artifacts"),
37
+ Type.Literal("worktrees"),
38
+ Type.Literal("forget"),
39
+ Type.Literal("summary"),
40
+ Type.Literal("prune"),
41
+ Type.Literal("export"),
42
+ Type.Literal("import"),
43
+ Type.Literal("imports"),
44
+ Type.Literal("help"),
45
+ Type.Literal("validate"),
46
+ Type.Literal("config"),
47
+ Type.Literal("init"),
48
+ Type.Literal("recommend"),
49
+ Type.Literal("autonomy"),
50
+ Type.Literal("api"),
51
+ Type.Literal("settings"),
52
+ ], { description: "Team action. Defaults to 'list' when omitted." })),
53
+ resource: Type.Optional(Type.Union([
54
+ Type.Literal("agent"),
55
+ Type.Literal("team"),
56
+ Type.Literal("workflow"),
57
+ ], { description: "Resource kind for get/create/update/delete/list. Defaults to all for list." })),
58
+ team: Type.Optional(Type.String({ description: "Team name, e.g. default or implementation." })),
59
+ workflow: Type.Optional(Type.String({ description: "Workflow name, e.g. default or review." })),
60
+ role: Type.Optional(Type.String({ description: "Role name to run directly within a team." })),
61
+ agent: Type.Optional(Type.String({ description: "Agent name to inspect or run directly." })),
62
+ goal: Type.Optional(Type.String({ description: "High-level objective for a team run." })),
63
+ task: Type.Optional(Type.String({ description: "Concrete task text for direct role/agent execution." })),
64
+ runId: Type.Optional(Type.String({ description: "Run ID for status, cancel, or resume." })),
65
+ taskId: Type.Optional(Type.String({ description: "Task ID for respond action." })),
66
+ message: Type.Optional(Type.String({ description: "Message for respond action." })),
67
+ async: Type.Optional(Type.Boolean({ description: "Run in background when execution support is enabled." })),
68
+ workspaceMode: Type.Optional(Type.Union([
69
+ Type.Literal("single"),
70
+ Type.Literal("worktree"),
71
+ ], { description: "Workspace isolation mode. Worktree mode is planned after MVP." })),
72
+ context: Type.Optional(Type.Union([
73
+ Type.Literal("fresh"),
74
+ Type.Literal("fork"),
75
+ ], { description: "Child context mode for workers." })),
76
+ cwd: Type.Optional(Type.String({ description: "Working directory override." })),
77
+ model: Type.Optional(Type.String({ description: "Model override for direct runs." })),
78
+ skill: Type.Optional(SkillOverride),
79
+ scope: Type.Optional(Type.Union([
80
+ Type.Literal("user"),
81
+ Type.Literal("project"),
82
+ Type.Literal("both"),
83
+ ], { description: "Resource scope for discovery or management." })),
84
+ config: Type.Optional(FreeformConfig),
85
+ dryRun: Type.Optional(Type.Boolean({ description: "Preview a management mutation without writing files." })),
86
+ confirm: Type.Optional(Type.Boolean({ description: "Required for destructive management actions." })),
87
+ force: Type.Optional(Type.Boolean({ description: "Override reference checks for destructive management actions." })),
88
+ keep: Type.Optional(Type.Integer({ minimum: 0, description: "Number of finished runs to keep for prune." })),
89
+ updateReferences: Type.Optional(Type.Boolean({ description: "When renaming agents or workflows, update team references in the same project/user scope." })),
90
+ replyTo: Type.Optional(Type.String({ description: "ID of the original mailbox message this is a reply to." })),
91
+ replyFrom: Type.Optional(Type.String({ description: "Task ID sending the reply." })),
92
+ replyDeadline: Type.Optional(Type.Integer({ description: "Ms epoch deadline for a reply." })),
93
+ });
94
+
95
+ export interface TeamToolParamsValue {
96
+ action?: "run" | "parallel" | "plan" | "status" | "list" | "get" | "cancel" | "retry" | "resume" | "respond" | "create" | "update" | "delete" | "doctor" | "cleanup" | "events" | "artifacts" | "worktrees" | "forget" | "summary" | "prune" | "export" | "import" | "imports" | "help" | "validate" | "config" | "init" | "recommend" | "autonomy" | "api" | "settings";
97
+ resource?: "agent" | "team" | "workflow";
98
+ team?: string;
99
+ workflow?: string;
100
+ role?: string;
101
+ agent?: string;
102
+ goal?: string;
103
+ task?: string;
104
+ runId?: string;
105
+ taskId?: string;
106
+ message?: string;
107
+ async?: boolean;
108
+ workspaceMode?: "single" | "worktree";
109
+ context?: "fresh" | "fork";
110
+ cwd?: string;
111
+ model?: string;
112
+ skill?: string | string[] | boolean;
113
+ scope?: "user" | "project" | "both";
114
+ config?: Record<string, unknown>;
115
+ dryRun?: boolean;
116
+ confirm?: boolean;
117
+ force?: boolean;
118
+ keep?: number;
119
+ updateReferences?: boolean;
120
+ /** ID of the original mailbox message this is a reply to. */
121
+ replyTo?: string;
122
+ /** Task ID sending the reply. */
123
+ replyFrom?: string;
124
+ /** Ms epoch deadline for a reply. */
125
+ replyDeadline?: number;
126
+ }