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.
- package/AGENTS.md +57 -32
- package/CHANGELOG.md +466 -448
- package/LICENSE +21 -21
- package/NOTICE.md +16 -16
- package/README.md +323 -323
- package/docs/FEATURE_INTAKE.md +126 -0
- package/docs/HARNESS.md +86 -0
- package/docs/HARNESS_BACKLOG.md +41 -0
- package/docs/TEST_MATRIX.md +49 -0
- package/docs/actions-reference.md +595 -595
- package/docs/architecture.md +180 -180
- package/docs/code-review-2026-05-11.md +592 -592
- package/docs/commands-reference.md +347 -347
- package/docs/comparison-pi-subagents-vs-pi-crew.md +303 -0
- package/docs/decisions/0001-durable-state.md +41 -0
- package/docs/decisions/0002-child-process-for-async.md +42 -0
- package/docs/decisions/0003-depth-guard.md +36 -0
- package/docs/decisions/0004-execfile-over-exec.md +34 -0
- package/docs/decisions/0005-no-parameter-properties.md +49 -0
- package/docs/decisions/0006-publish-bundled-esm.md +63 -0
- package/docs/decisions/0007-active-run-binary-index.md +54 -0
- package/docs/decisions/0008-child-pi-warm-pool.md +61 -0
- package/docs/decisions/README.md +23 -0
- package/docs/followup-review-round4-2026-05-13.md +107 -0
- package/docs/implementation-plan-top3.md +333 -0
- package/docs/live-mailbox-runtime.md +36 -36
- package/docs/next-upgrade-roadmap.md +808 -808
- package/docs/oh-my-pi-research.md +509 -0
- package/docs/perf/baseline-2026-05.md +113 -0
- package/docs/perf/final-report-2026-05.md +206 -0
- package/docs/perf/sprint-1-report.md +71 -0
- package/docs/perf/sprint-2-report.md +81 -0
- package/docs/perf/sprint-2.5-report.md +53 -0
- package/docs/perf/sprint-3-report.md +36 -0
- package/docs/perf/sprint-4-report.md +47 -0
- package/docs/perf/sprint-5-report.md +51 -0
- package/docs/perf/sprint-6-report.md +94 -0
- package/docs/perf/sprint-7-report.md +74 -0
- package/docs/perf/upgrade-plan-2026-05.md +147 -0
- package/docs/pi-subagents3-deep-analysis.md +508 -0
- package/docs/product/README.md +31 -0
- package/docs/product/platform.md +27 -0
- package/docs/product/runtime-safety.md +37 -0
- package/docs/product/team-run.md +39 -0
- package/docs/product/team-tool.md +37 -0
- package/docs/publishing.md +65 -65
- package/docs/resource-formats.md +134 -134
- package/docs/runtime-analysis-child-vs-live.md +171 -0
- package/docs/runtime-flow.md +148 -148
- package/docs/runtime-migration-in-process-analysis.md +250 -0
- package/docs/stories/README.md +30 -0
- package/docs/stories/backlog.md +36 -0
- package/docs/templates/decision.md +27 -0
- package/docs/templates/story.md +44 -0
- package/docs/templates/validation-report.md +32 -0
- package/docs/usage.md +238 -238
- package/index.ts +7 -6
- package/install.mjs +65 -65
- package/package.json +107 -100
- package/schema.json +222 -222
- package/skills/child-pi-spawning/SKILL.md +213 -0
- package/skills/context-artifact-hygiene/SKILL.md +32 -0
- package/skills/event-log-tracing/SKILL.md +299 -0
- package/skills/git-master/SKILL.md +225 -24
- package/skills/live-agent-lifecycle/SKILL.md +192 -0
- package/skills/mailbox-interactive/SKILL.md +300 -19
- package/skills/model-routing-context/SKILL.md +94 -0
- package/skills/multi-perspective-review/SKILL.md +88 -0
- package/skills/read-only-explorer/SKILL.md +250 -26
- package/skills/safe-bash/SKILL.md +307 -21
- package/skills/verification-before-done/SKILL.md +11 -2
- package/skills/widget-rendering/SKILL.md +258 -0
- package/skills/workspace-isolation/SKILL.md +202 -0
- package/skills/worktree-isolation/SKILL.md +202 -18
- package/src/adapters/claude-adapter.ts +25 -25
- package/src/adapters/codex-adapter.ts +21 -21
- package/src/adapters/cursor-adapter.ts +17 -17
- package/src/adapters/export-util.ts +137 -137
- package/src/adapters/index.ts +15 -15
- package/src/adapters/registry.ts +18 -18
- package/src/adapters/types.ts +23 -23
- package/src/agents/agent-config.ts +38 -38
- package/src/agents/agent-serializer.ts +38 -38
- package/src/agents/discover-agents.ts +121 -118
- package/src/config/config.ts +740 -858
- package/src/config/defaults.ts +96 -96
- package/src/config/drift-detector.ts +211 -211
- package/src/config/markers.ts +327 -327
- package/src/config/resilient-parser.ts +109 -108
- package/src/config/suggestions.ts +74 -74
- package/src/config/types.ts +199 -0
- package/src/extension/async-notifier.ts +123 -89
- package/src/extension/autonomous-policy.ts +169 -169
- package/src/extension/cross-extension-rpc.ts +104 -104
- package/src/extension/help.ts +47 -47
- package/src/extension/import-index.ts +69 -69
- package/src/extension/management.ts +395 -382
- package/src/extension/notification-router.ts +116 -116
- package/src/extension/notification-sink.ts +51 -51
- package/src/extension/project-init.ts +168 -168
- package/src/extension/register.ts +859 -668
- package/src/extension/registration/artifact-cleanup.ts +15 -15
- package/src/extension/registration/command-utils.ts +54 -54
- package/src/extension/registration/commands.ts +559 -452
- package/src/extension/registration/compaction-guard.ts +125 -125
- package/src/extension/registration/subagent-helpers.ts +102 -102
- package/src/extension/registration/subagent-tools.ts +220 -159
- package/src/extension/registration/team-tool.ts +159 -99
- package/src/extension/registration/viewers.ts +29 -0
- package/src/extension/result-watcher.ts +128 -128
- package/src/extension/run-bundle-schema.ts +89 -89
- package/src/extension/run-export.ts +73 -73
- package/src/extension/run-import.ts +84 -84
- package/src/extension/run-index.ts +94 -94
- package/src/extension/run-maintenance.ts +142 -142
- package/src/extension/session-summary.ts +8 -8
- package/src/extension/team-manager-command.ts +96 -96
- package/src/extension/team-recommendation.ts +188 -188
- package/src/extension/team-tool/api.ts +5 -2
- package/src/extension/team-tool/cancel.ts +224 -209
- package/src/extension/team-tool/config-patch.ts +36 -36
- package/src/extension/team-tool/context.ts +60 -60
- package/src/extension/team-tool/doctor.ts +242 -242
- package/src/extension/team-tool/handle-settings.ts +421 -195
- package/src/extension/team-tool/inspect.ts +41 -41
- package/src/extension/team-tool/lifecycle-actions.ts +139 -139
- package/src/extension/team-tool/parallel-dispatch.ts +156 -156
- package/src/extension/team-tool/plan.ts +19 -19
- package/src/extension/team-tool/respond.ts +112 -111
- package/src/extension/team-tool/run.ts +246 -229
- package/src/extension/team-tool/status.ts +110 -110
- package/src/extension/team-tool-types.ts +13 -13
- package/src/extension/team-tool.ts +344 -344
- package/src/extension/tool-result.ts +16 -16
- package/src/extension/validate-resources.ts +77 -77
- package/src/hooks/registry.ts +61 -61
- package/src/hooks/types.ts +40 -40
- package/src/i18n.ts +184 -184
- package/src/observability/correlation.ts +35 -35
- package/src/observability/event-to-metric.ts +68 -68
- package/src/observability/exporters/adapter.ts +30 -30
- package/src/observability/exporters/otlp-exporter.ts +106 -92
- package/src/observability/exporters/prometheus-exporter.ts +54 -54
- package/src/observability/metric-registry.ts +87 -87
- package/src/observability/metric-retention.ts +54 -54
- package/src/observability/metric-sink.ts +81 -56
- package/src/observability/metrics-primitives.ts +167 -167
- package/src/prompt/prompt-runtime.ts +72 -72
- package/src/runtime/adaptive-plan.ts +338 -0
- package/src/runtime/agent-control.ts +169 -169
- package/src/runtime/agent-memory.ts +72 -72
- package/src/runtime/agent-observability.ts +114 -114
- package/src/runtime/async-marker.ts +26 -26
- package/src/runtime/async-runner.ts +153 -153
- package/src/runtime/attention-events.ts +28 -28
- package/src/runtime/auto-resume.ts +100 -100
- package/src/runtime/background-runner.ts +122 -89
- package/src/runtime/cancellation.ts +61 -61
- package/src/runtime/capability-inventory.ts +116 -116
- package/src/runtime/child-pi-pool.ts +68 -0
- package/src/runtime/child-pi.ts +541 -461
- package/src/runtime/code-summary.ts +247 -247
- package/src/runtime/compaction-summary.ts +271 -271
- package/src/runtime/concurrency.ts +58 -58
- package/src/runtime/crash-recovery.ts +317 -301
- package/src/runtime/crew-agent-records.ts +379 -281
- package/src/runtime/crew-agent-runtime.ts +60 -60
- package/src/runtime/cross-extension-rpc.ts +72 -0
- package/src/runtime/custom-tools/irc-tool.ts +201 -201
- package/src/runtime/custom-tools/submit-result-tool.ts +90 -90
- package/src/runtime/deadletter.ts +47 -47
- package/src/runtime/delivery-coordinator.ts +176 -176
- package/src/runtime/delta-conflict.ts +360 -360
- package/src/runtime/diagnostic-export.ts +102 -102
- package/src/runtime/direct-run.ts +35 -35
- package/src/runtime/effectiveness.ts +82 -81
- package/src/runtime/errors/crew-errors.ts +166 -0
- package/src/runtime/event-stream-bridge.ts +92 -92
- package/src/runtime/foreground-control.ts +82 -82
- package/src/runtime/green-contract.ts +46 -46
- package/src/runtime/group-join.ts +234 -106
- package/src/runtime/heartbeat-watcher.ts +145 -124
- package/src/runtime/iteration-hooks.ts +267 -267
- package/src/runtime/live-agent-control.ts +88 -88
- package/src/runtime/live-agent-manager.ts +377 -179
- package/src/runtime/live-control-realtime.ts +36 -36
- package/src/runtime/live-session-runtime.ts +676 -600
- package/src/runtime/loop-gates.ts +129 -129
- package/src/runtime/manifest-cache.ts +263 -263
- package/src/runtime/mcp-proxy.ts +113 -113
- package/src/runtime/metric-parser.ts +40 -40
- package/src/runtime/model-fallback.ts +282 -274
- package/src/runtime/model-resolver.ts +118 -0
- package/src/runtime/output-validator.ts +187 -187
- package/src/runtime/overflow-recovery.ts +175 -175
- package/src/runtime/parallel-research.ts +44 -44
- package/src/runtime/parallel-utils.ts +156 -156
- package/src/runtime/parent-guard.ts +80 -80
- package/src/runtime/phase-progress.ts +217 -217
- package/src/runtime/pi-args.ts +165 -165
- package/src/runtime/pi-json-output.ts +111 -111
- package/src/runtime/pi-spawn.ts +167 -167
- package/src/runtime/policy-engine.ts +79 -79
- package/src/runtime/post-checks.ts +125 -125
- package/src/runtime/post-exit-stdio-guard.ts +86 -86
- package/src/runtime/process-status.ts +97 -73
- package/src/runtime/progress-event-coalescer.ts +43 -43
- package/src/runtime/recovery-recipes.ts +74 -74
- package/src/runtime/retry-executor.ts +81 -81
- package/src/runtime/role-permission.ts +39 -39
- package/src/runtime/run-tracker.ts +99 -0
- package/src/runtime/runtime-policy.ts +21 -0
- package/src/runtime/runtime-resolver.ts +94 -91
- package/src/runtime/scheduler.ts +294 -0
- package/src/runtime/semaphore.ts +131 -131
- package/src/runtime/sensitive-paths.ts +92 -92
- package/src/runtime/session-usage.ts +79 -79
- package/src/runtime/settings-store.ts +103 -0
- package/src/runtime/sidechain-output.ts +29 -29
- package/src/runtime/skill-instructions.ts +222 -222
- package/src/runtime/stale-reconciler.ts +198 -189
- package/src/runtime/streaming-output.ts +47 -0
- package/src/runtime/subagent-manager.ts +404 -400
- package/src/runtime/subprocess-tool-registry.ts +67 -67
- package/src/runtime/task-display.ts +38 -38
- package/src/runtime/task-graph-scheduler.ts +122 -122
- package/src/runtime/task-graph.ts +207 -207
- package/src/runtime/task-output-context.ts +177 -177
- package/src/runtime/task-packet.ts +93 -93
- package/src/runtime/task-quality.ts +207 -207
- package/src/runtime/task-runner/capabilities.ts +78 -78
- package/src/runtime/task-runner/live-executor.ts +131 -113
- package/src/runtime/task-runner/progress.ts +119 -119
- package/src/runtime/task-runner/prompt-builder.ts +139 -139
- package/src/runtime/task-runner/prompt-pipeline.ts +64 -64
- package/src/runtime/task-runner/result-utils.ts +14 -14
- package/src/runtime/task-runner/run-projection.ts +103 -103
- package/src/runtime/task-runner/state-helpers.ts +22 -22
- package/src/runtime/task-runner.ts +469 -459
- package/src/runtime/team-runner.ts +693 -945
- package/src/runtime/usage-tracker.ts +71 -0
- package/src/runtime/worker-heartbeat.ts +21 -21
- package/src/runtime/worker-startup.ts +57 -57
- package/src/runtime/workflow-state.ts +187 -187
- package/src/runtime/yield-handler.ts +190 -190
- package/src/schema/config-schema.ts +172 -168
- package/src/schema/team-tool-schema.ts +126 -126
- package/src/schema/validation-types.ts +151 -148
- package/src/skills/discover-skills.ts +67 -67
- package/src/skills/skill-templates.ts +374 -374
- package/src/state/active-run-registry.ts +227 -191
- package/src/state/artifact-store.ts +130 -129
- package/src/state/atomic-write.ts +262 -195
- package/src/state/blob-store.ts +116 -116
- package/src/state/contracts.ts +111 -111
- package/src/state/event-log-rotation.ts +161 -158
- package/src/state/event-log.ts +383 -303
- package/src/state/event-reconstructor.ts +217 -217
- package/src/state/jsonl-writer.ts +82 -82
- package/src/state/locks.ts +146 -146
- package/src/state/mailbox.ts +446 -405
- package/src/state/state-store.ts +364 -351
- package/src/state/task-claims.ts +44 -44
- package/src/state/types.ts +285 -285
- package/src/state/usage.ts +29 -29
- package/src/subagents/async-entry.ts +1 -1
- package/src/subagents/index.ts +3 -3
- package/src/subagents/live/control.ts +1 -1
- package/src/subagents/live/manager.ts +1 -1
- package/src/subagents/live/realtime.ts +1 -1
- package/src/subagents/live/session-runtime.ts +1 -1
- package/src/subagents/manager.ts +1 -1
- package/src/subagents/spawn.ts +1 -1
- package/src/teams/discover-teams.ts +116 -116
- package/src/teams/team-config.ts +27 -27
- package/src/teams/team-serializer.ts +38 -38
- package/src/types/diff.d.ts +18 -18
- package/src/ui/agent-management-overlay.ts +144 -144
- package/src/ui/crew-widget.ts +487 -370
- package/src/ui/dashboard-panes/agents-pane.ts +109 -28
- package/src/ui/dashboard-panes/cancellation-pane.ts +42 -42
- package/src/ui/dashboard-panes/capability-pane.ts +59 -59
- package/src/ui/dashboard-panes/health-pane.ts +30 -30
- package/src/ui/dashboard-panes/mailbox-pane.ts +35 -35
- package/src/ui/dashboard-panes/progress-pane.ts +30 -30
- package/src/ui/dashboard-panes/transcript-pane.ts +10 -10
- package/src/ui/heartbeat-aggregator.ts +63 -63
- package/src/ui/keybinding-map.ts +97 -94
- package/src/ui/live-conversation-overlay.ts +152 -0
- package/src/ui/live-run-sidebar.ts +180 -180
- package/src/ui/mascot.ts +442 -442
- package/src/ui/overlays/agent-picker-overlay.ts +57 -57
- package/src/ui/overlays/confirm-overlay.ts +58 -58
- package/src/ui/overlays/mailbox-compose-overlay.ts +144 -144
- package/src/ui/overlays/mailbox-compose-preview.ts +63 -63
- package/src/ui/overlays/mailbox-detail-overlay.ts +122 -122
- package/src/ui/pi-ui-compat.ts +57 -57
- package/src/ui/powerbar-publisher.ts +221 -197
- package/src/ui/render-scheduler.ts +216 -143
- package/src/ui/run-action-dispatcher.ts +118 -118
- package/src/ui/run-dashboard.ts +526 -464
- package/src/ui/run-event-bus.ts +208 -208
- package/src/ui/run-snapshot-cache.ts +826 -777
- package/src/ui/settings-overlay.ts +721 -0
- package/src/ui/snapshot-types.ts +86 -70
- package/src/ui/theme-adapter.ts +190 -190
- package/src/ui/tool-progress-formatter.ts +89 -0
- package/src/ui/transcript-cache.ts +94 -94
- package/src/ui/transcript-viewer.ts +335 -335
- package/src/utils/conflict-detect.ts +662 -0
- package/src/utils/file-coalescer.ts +86 -86
- package/src/utils/frontmatter.ts +68 -68
- package/src/utils/fs-watch.ts +88 -31
- package/src/utils/gh-protocol.ts +479 -0
- package/src/utils/ids.ts +17 -17
- package/src/utils/incremental-reader.ts +104 -104
- package/src/utils/internal-error.ts +6 -6
- package/src/utils/names.ts +27 -27
- package/src/utils/paths.ts +102 -63
- package/src/utils/redaction.ts +44 -44
- package/src/utils/safe-paths.ts +47 -47
- package/src/utils/scan-cache.ts +136 -136
- package/src/utils/sse-parser.ts +134 -134
- package/src/utils/task-name-generator.ts +337 -337
- package/src/utils/timings.ts +33 -33
- package/src/utils/visual.ts +243 -198
- package/src/workflows/discover-workflows.ts +139 -139
- package/src/workflows/validate-workflow.ts +40 -40
- package/src/workflows/workflow-config.ts +26 -26
- package/src/workflows/workflow-serializer.ts +32 -32
- package/src/worktree/branch-freshness.ts +45 -45
- package/src/worktree/cleanup.ts +75 -75
- package/src/worktree/worktree-manager.ts +188 -188
- package/teams/default.team.md +12 -12
- package/teams/fast-fix.team.md +11 -11
- package/teams/implementation.team.md +18 -18
- package/teams/parallel-research.team.md +14 -14
- package/teams/research.team.md +11 -11
- package/teams/review.team.md +12 -12
- package/tsconfig.json +19 -19
- package/workflows/default.workflow.md +30 -30
- package/workflows/fast-fix.workflow.md +23 -23
- package/workflows/implementation.workflow.md +43 -43
- package/workflows/parallel-research.workflow.md +46 -46
- package/workflows/research.workflow.md +22 -22
- package/workflows/review.workflow.md +30 -30
- package/skills/task-packet/SKILL.md +0 -28
- 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
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
}, { additionalProperties: false });
|
|
80
|
-
|
|
81
|
-
export const
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
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
|
+
}
|