@pi-unipi/unipi 3.0.0-alpha.2 → 3.0.0-alpha.21
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +292 -0
- package/README.md +8 -11
- package/docs/prefix-cache-architecture.md +14 -0
- package/package.json +22 -24
- package/packages/ask-user/README.md +55 -107
- package/packages/ask-user/ask-ui.ts +306 -732
- package/packages/ask-user/clipboard.ts +50 -0
- package/packages/ask-user/config.ts +74 -78
- package/packages/ask-user/package.json +2 -2
- package/packages/ask-user/questions.ts +151 -0
- package/packages/ask-user/skills/ask-user/SKILL.md +59 -133
- package/packages/ask-user/tools.ts +198 -432
- package/packages/autocomplete/package.json +1 -1
- package/packages/autocomplete/src/constants.ts +38 -43
- package/packages/autocomplete/src/sorting.ts +8 -0
- package/packages/background-tasks/package.json +2 -2
- package/packages/background-tasks/src/config.ts +0 -73
- package/packages/background-tasks/src/index.ts +20 -16
- package/packages/background-tasks/src/registry.ts +1 -171
- package/packages/background-tasks/src/types.ts +0 -32
- package/packages/btw/README.md +13 -56
- package/packages/btw/extensions/btw.ts +403 -1796
- package/packages/btw/package.json +5 -2
- package/packages/btw/skills/btw/SKILL.md +7 -143
- package/packages/compactor/README.md +56 -287
- package/packages/compactor/package.json +5 -9
- package/packages/compactor/skills/compactor/SKILL.md +13 -20
- package/packages/compactor/src/card.ts +90 -0
- package/packages/compactor/src/commands/index.ts +73 -130
- package/packages/compactor/src/compaction/compact-args.ts +5 -3
- package/packages/compactor/src/compaction/filter-noise.ts +1 -1
- package/packages/compactor/src/compaction/hooks.ts +487 -311
- package/packages/compactor/src/compaction/source.ts +178 -0
- package/packages/compactor/src/compaction/summarize.ts +586 -52
- package/packages/compactor/src/config/manager.ts +130 -127
- package/packages/compactor/src/config/schema.ts +32 -48
- package/packages/compactor/src/index.ts +40 -431
- package/packages/compactor/src/info-screen.ts +44 -190
- package/packages/compactor/src/session/recall-blocks.ts +1 -1
- package/packages/compactor/src/stats.ts +76 -0
- package/packages/compactor/src/tools/context-budget.ts +17 -34
- package/packages/compactor/src/tools/ctx-doctor.ts +45 -36
- package/packages/compactor/src/tools/register.ts +29 -269
- package/packages/compactor/src/types.ts +47 -186
- package/packages/core/README.md +25 -0
- package/packages/core/child-agent.ts +1 -0
- package/packages/core/command-echo.ts +63 -0
- package/packages/core/compaction-context.ts +41 -0
- package/packages/core/constants.ts +8 -38
- package/packages/core/events.ts +0 -53
- package/packages/core/fusion-status.ts +4 -0
- package/packages/core/global.d.ts +10 -0
- package/packages/core/harness-messages.ts +392 -0
- package/packages/core/index.ts +14 -0
- package/packages/core/kanboard-status.ts +49 -0
- package/packages/core/long-horizon-owner-status.ts +46 -0
- package/packages/core/model-cache.ts +81 -7
- package/packages/core/package.json +6 -3
- package/packages/core/src/attach/detect.ts +163 -0
- package/packages/core/src/child-agent/child-args.ts +31 -0
- package/packages/core/src/child-agent/delivery.ts +41 -0
- package/packages/core/src/child-agent/index.ts +5 -0
- package/packages/core/src/child-agent/readers.ts +203 -0
- package/packages/core/src/child-agent/runtime.ts +584 -0
- package/packages/core/src/evidence.ts +78 -0
- package/packages/core/src/hints/browser.ts +278 -0
- package/packages/core/src/hints/crab-data.ts +19 -0
- package/packages/core/src/hints/index.ts +865 -0
- package/packages/core/src/hints/lines.ts +607 -0
- package/packages/core/src/hints/store.ts +120 -0
- package/packages/core/src/jev/chatter.ts +24 -0
- package/packages/core/src/jev/settings.ts +177 -14
- package/packages/core/src/package-colors.ts +2 -0
- package/packages/core/src/settings/catalog.ts +39 -15
- package/packages/core/src/settings/engine.ts +48 -2
- package/packages/core/src/settings/hub.ts +83 -20
- package/packages/core/src/settings/open.ts +49 -0
- package/packages/core/src/settings/schema.ts +27 -7
- package/packages/core/src/tui/hub-kit.ts +18 -5
- package/packages/core/src/tui/kit.ts +198 -0
- package/packages/core/src/tui/progress.ts +73 -0
- package/packages/core/src/turn/arbiter.ts +290 -0
- package/packages/footer/README.md +4 -6
- package/packages/footer/package.json +3 -3
- package/packages/footer/src/glance-editor.ts +19 -11
- package/packages/footer/src/help.ts +1 -1
- package/packages/footer/src/index.ts +36 -3
- package/packages/footer/src/presets.ts +3 -4
- package/packages/footer/src/rendering/icons.ts +0 -20
- package/packages/footer/src/segments/compactor.ts +52 -142
- package/packages/footer/src/segments/status-ext.ts +0 -1
- package/packages/fusion/README.md +14 -4
- package/packages/fusion/package.json +4 -3
- package/packages/fusion/src/child-args.ts +1 -0
- package/packages/fusion/src/index.ts +161 -8
- package/packages/fusion/src/pi-settings.ts +57 -0
- package/packages/fusion/src/picker.ts +186 -51
- package/packages/fusion/src/preset.ts +56 -2
- package/packages/fusion/src/prompts.ts +1 -1
- package/packages/fusion/src/sidekick-runtime.ts +1 -420
- package/packages/fusion/src/tools.ts +107 -128
- package/packages/fusion/src/transcript.ts +27 -85
- package/packages/info-screen/package.json +2 -2
- package/packages/input-shortcuts/README.md +18 -30
- package/packages/input-shortcuts/package.json +2 -2
- package/packages/input-shortcuts/src/burst.ts +88 -0
- package/packages/input-shortcuts/src/chord-overlay.ts +20 -70
- package/packages/input-shortcuts/src/cleared-input.ts +97 -0
- package/packages/input-shortcuts/src/index.ts +99 -193
- package/packages/input-shortcuts/src/last-response.ts +40 -0
- package/packages/input-shortcuts/src/registers.ts +8 -23
- package/packages/input-shortcuts/src/types.ts +4 -16
- package/packages/input-shortcuts/src/undo-redo.ts +59 -47
- package/packages/kanboard/README.md +51 -47
- package/packages/kanboard/index.ts +293 -55
- package/packages/kanboard/package.json +8 -8
- package/packages/kanboard/skills/kanboard/SKILL.md +61 -27
- package/packages/kanboard/src/badges.ts +93 -0
- package/packages/kanboard/src/bin.ts +4 -2
- package/packages/kanboard/src/commands.ts +218 -84
- package/packages/kanboard/src/debug.ts +20 -0
- package/packages/kanboard/src/guard.ts +267 -109
- package/packages/kanboard/src/monitor.ts +330 -0
- package/packages/kanboard/src/notice-buffer.ts +74 -0
- package/packages/kanboard/src/progress.ts +27 -0
- package/packages/kanboard/src/reminders.ts +234 -0
- package/packages/kanboard/src/settings.ts +69 -15
- package/packages/kanboard/src/shapes.ts +5 -0
- package/packages/long-horizon/index.ts +190 -13
- package/packages/long-horizon/package.json +3 -3
- package/packages/long-horizon/src/commands.ts +103 -7
- package/packages/long-horizon/src/compaction-brief.ts +35 -0
- package/packages/long-horizon/src/engine/continuation.ts +84 -15
- package/packages/long-horizon/src/engine/goal-state.ts +64 -13
- package/packages/long-horizon/src/engine/nudge-stash.ts +71 -0
- package/packages/long-horizon/src/engine/ralph.ts +3 -2
- package/packages/long-horizon/src/engine/runaway.ts +68 -11
- package/packages/long-horizon/src/engine/verifier.ts +19 -0
- package/packages/long-horizon/src/gate.ts +37 -12
- package/packages/long-horizon/src/judge/resolve.ts +1 -0
- package/packages/long-horizon/src/owner.ts +35 -2
- package/packages/long-horizon/src/progress.ts +87 -0
- package/packages/long-horizon/src/prompts/goal.ts +1 -1
- package/packages/long-horizon/src/runtime.ts +172 -18
- package/packages/long-horizon/src/settings.ts +54 -39
- package/packages/long-horizon/src/tools/goal.ts +6 -0
- package/packages/long-horizon/src/tools/graph.ts +1 -1
- package/packages/long-horizon/src/tools/swarm.ts +3 -3
- package/packages/mcp/package.json +2 -2
- package/packages/memory/commands.ts +7 -2
- package/packages/memory/index.ts +210 -32
- package/packages/memory/package.json +3 -3
- package/packages/memory/save-session.ts +264 -0
- package/packages/memory/settings.ts +17 -0
- package/packages/memory/tools.ts +253 -203
- package/packages/notify/package.json +2 -2
- package/packages/skill-registry/README.md +53 -16
- package/packages/skill-registry/index.ts +230 -0
- package/packages/skill-registry/package.json +19 -8
- package/packages/skill-registry/src/editor.ts +206 -0
- package/packages/skill-registry/src/judge.ts +289 -0
- package/packages/skill-registry/src/registry.ts +87 -0
- package/packages/skill-registry/src/settings.ts +259 -0
- package/packages/skill-registry/src/vault.ts +80 -0
- package/packages/subagents/README.md +39 -119
- package/packages/subagents/package.json +6 -13
- package/packages/subagents/skills/subagents/SKILL.md +18 -42
- package/packages/subagents/src/agents.ts +213 -0
- package/packages/subagents/src/cards.ts +182 -0
- package/packages/subagents/src/index.ts +609 -1084
- package/packages/subagents/src/manager.ts +429 -0
- package/packages/subagents/src/profiles.ts +130 -0
- package/packages/subagents/src/transcript.ts +154 -0
- package/packages/subagents/src/ui.ts +389 -0
- package/packages/unipi/bundled.js +39756 -45569
- package/packages/unipi/index.ts +55 -10
- package/packages/updater/package.json +2 -2
- package/packages/utility/README.md +76 -69
- package/packages/utility/package.json +2 -2
- package/packages/utility/skills/image/SKILL.md +37 -0
- package/packages/utility/skills/utility/SKILL.md +17 -60
- package/packages/utility/src/answer/extract.ts +128 -0
- package/packages/utility/src/answer/index.ts +213 -0
- package/packages/utility/src/answer/reply.ts +133 -0
- package/packages/utility/src/answer/web.ts +167 -0
- package/packages/utility/src/attach/index.ts +205 -0
- package/packages/utility/src/commands.ts +38 -142
- package/packages/utility/src/diagnostics/engine.ts +50 -5
- package/packages/utility/src/image/index.ts +33 -0
- package/packages/utility/src/image/models.ts +221 -0
- package/packages/{image/src → utility/src/image}/recognize.ts +2 -2
- package/packages/utility/src/image/settings.ts +178 -0
- package/packages/{image/src/image-source.ts → utility/src/image/source.ts} +1 -1
- package/packages/utility/src/image/tools.ts +168 -0
- package/packages/utility/src/image/transports.ts +186 -0
- package/packages/utility/src/index.ts +68 -389
- package/packages/utility/src/lifecycle/cleanup.ts +116 -311
- package/packages/utility/src/rename/gate.ts +102 -0
- package/packages/utility/src/rename/index.ts +191 -0
- package/packages/utility/src/rename/session.ts +170 -0
- package/packages/utility/src/render/delegated.ts +285 -0
- package/packages/utility/src/render/harness.ts +683 -0
- package/packages/utility/src/render/parse.ts +156 -0
- package/packages/utility/src/render/pi-settings.ts +38 -0
- package/packages/utility/src/render/reply-bg.ts +307 -0
- package/packages/utility/src/render/simple.ts +724 -0
- package/packages/utility/src/render/spacing.ts +235 -0
- package/packages/utility/src/render/styled.ts +251 -0
- package/packages/utility/src/render/tools.ts +353 -0
- package/packages/utility/src/settings.ts +166 -233
- package/packages/utility/src/types.ts +1 -222
- package/packages/watchdog/index.ts +17 -6
- package/packages/watchdog/package.json +3 -3
- package/packages/watchdog/src/config.ts +3 -2
- package/packages/web-api/package.json +2 -2
- package/packages/workflow/README.md +3 -0
- package/packages/workflow/index.ts +0 -2
- package/packages/workflow/package.json +2 -2
- package/packages/workflow/src/permission/decide.ts +6 -4
- package/packages/workflow/src/permission/index.ts +17 -7
- package/packages/workflow/src/permission/settings.ts +39 -4
- package/packages/workflow/src/plan/index.ts +19 -4
- package/packages/background-tasks/extensions/delegate-child.ts +0 -1
- package/packages/background-tasks/src/context-parent-snapshot.ts +0 -142
- package/packages/background-tasks/src/context-token-budget.ts +0 -903
- package/packages/background-tasks/src/context-visible-conversation-v2.ts +0 -551
- package/packages/background-tasks/src/delegate/artifacts.ts +0 -487
- package/packages/background-tasks/src/delegate/budget.ts +0 -415
- package/packages/background-tasks/src/delegate/hook-contract-evidence.json +0 -18
- package/packages/background-tasks/src/delegate/hook-contract.ts +0 -154
- package/packages/background-tasks/src/delegate/launch.ts +0 -484
- package/packages/background-tasks/src/delegate/result-package.ts +0 -459
- package/packages/background-tasks/src/delegate/runner.ts +0 -430
- package/packages/background-tasks/src/delegate/seed.ts +0 -423
- package/packages/background-tasks/src/delegate/types.ts +0 -323
- package/packages/background-tasks/src/delegate-child-extension.ts +0 -978
- package/packages/background-tasks/src/delegate-extension.ts +0 -654
- package/packages/background-tasks/src/fixtures/delegate-context-incident.json +0 -17
- package/packages/compactor/skills/compactor-detail/SKILL.md +0 -116
- package/packages/compactor/skills/compactor-doctor/SKILL.md +0 -71
- package/packages/compactor/skills/compactor-stats/SKILL.md +0 -51
- package/packages/compactor/src/compaction/build-sections.ts +0 -76
- package/packages/compactor/src/compaction/extract/goals.ts +0 -36
- package/packages/compactor/src/compaction/extract/preferences.ts +0 -40
- package/packages/compactor/src/compaction/format.ts +0 -53
- package/packages/compactor/src/compaction/merge.ts +0 -143
- package/packages/compactor/src/config/presets.ts +0 -160
- package/packages/compactor/src/executor/executor.ts +0 -233
- package/packages/compactor/src/executor/runtime.ts +0 -115
- package/packages/compactor/src/security/evaluator.ts +0 -89
- package/packages/compactor/src/security/policy.ts +0 -96
- package/packages/compactor/src/security/scanner.ts +0 -65
- package/packages/compactor/src/session/auto-inject.ts +0 -60
- package/packages/compactor/src/session/db.ts +0 -325
- package/packages/compactor/src/session/extract.ts +0 -144
- package/packages/compactor/src/session/resume-inject.ts +0 -64
- package/packages/compactor/src/session/snapshot.ts +0 -327
- package/packages/compactor/src/tools/ctx-batch-execute.ts +0 -41
- package/packages/compactor/src/tools/ctx-execute-file.ts +0 -23
- package/packages/compactor/src/tools/ctx-execute.ts +0 -23
- package/packages/compactor/src/tools/ctx-stats.ts +0 -96
- package/packages/image/README.md +0 -99
- package/packages/image/package.json +0 -61
- package/packages/image/skills/image/SKILL.md +0 -76
- package/packages/image/src/generate.ts +0 -256
- package/packages/image/src/index.ts +0 -135
- package/packages/image/src/models.ts +0 -519
- package/packages/image/src/openai-images-api.ts +0 -282
- package/packages/image/src/register-providers.ts +0 -209
- package/packages/image/src/settings.ts +0 -173
- package/packages/image/src/tools.ts +0 -326
- package/packages/input-shortcuts/src/clipboard.ts +0 -119
- package/packages/kanboard/src/runner.ts +0 -817
- package/packages/skill-registry/skills/auto/SKILL.md +0 -465
- package/packages/skill-registry/skills/brainstorm/SKILL.md +0 -219
- package/packages/skill-registry/skills/chore-create/SKILL.md +0 -315
- package/packages/skill-registry/skills/chore-execute/SKILL.md +0 -314
- package/packages/skill-registry/skills/consolidate/SKILL.md +0 -142
- package/packages/skill-registry/skills/consultant/SKILL.md +0 -97
- package/packages/skill-registry/skills/debug/SKILL.md +0 -228
- package/packages/skill-registry/skills/document/SKILL.md +0 -120
- package/packages/skill-registry/skills/fix/SKILL.md +0 -212
- package/packages/skill-registry/skills/gather-context/SKILL.md +0 -145
- package/packages/skill-registry/skills/plan/SKILL.md +0 -231
- package/packages/skill-registry/skills/quick-fix/SKILL.md +0 -135
- package/packages/skill-registry/skills/quick-work/SKILL.md +0 -110
- package/packages/skill-registry/skills/research/SKILL.md +0 -251
- package/packages/skill-registry/skills/review-work/SKILL.md +0 -187
- package/packages/skill-registry/skills/scan-issues/SKILL.md +0 -195
- package/packages/skill-registry/skills/work/SKILL.md +0 -218
- package/packages/skill-registry/skills/worktree-create/SKILL.md +0 -69
- package/packages/skill-registry/skills/worktree-list/SKILL.md +0 -78
- package/packages/skill-registry/skills/worktree-merge/SKILL.md +0 -89
- package/packages/subagents/agents/delegate.md +0 -14
- package/packages/subagents/agents/oracle.md +0 -78
- package/packages/subagents/agents/researcher.md +0 -52
- package/packages/subagents/agents/reviewer.md +0 -80
- package/packages/subagents/agents/scout.md +0 -50
- package/packages/subagents/agents/worker.md +0 -59
- package/packages/subagents/prompts/council.md +0 -48
- package/packages/subagents/prompts/gather-context-and-clarify.md +0 -13
- package/packages/subagents/prompts/parallel-cleanup.md +0 -59
- package/packages/subagents/prompts/parallel-research.md +0 -50
- package/packages/subagents/prompts/parallel-review.md +0 -54
- package/packages/subagents/prompts/review-loop.md +0 -43
- package/packages/subagents/skills/council-mode/SKILL.md +0 -230
- package/packages/subagents/skills/subagents/references/constraints-and-recipes.md +0 -259
- package/packages/subagents/skills/subagents/references/execution-controls.md +0 -454
- package/packages/subagents/skills/subagents/references/management-authoring-rpc.md +0 -161
- package/packages/subagents/skills/subagents/references/multi-lane-orchestration.md +0 -39
- package/packages/subagents/skills/subagents/references/prompting-and-roles.md +0 -267
- package/packages/subagents/src/acceptance.ts +0 -331
- package/packages/subagents/src/agent-manager.ts +0 -405
- package/packages/subagents/src/agent-memory.ts +0 -300
- package/packages/subagents/src/agent-overrides.ts +0 -183
- package/packages/subagents/src/agent-runner.ts +0 -271
- package/packages/subagents/src/async-runner.ts +0 -422
- package/packages/subagents/src/authority-policy.ts +0 -47
- package/packages/subagents/src/budgets.ts +0 -285
- package/packages/subagents/src/child-safety.ts +0 -140
- package/packages/subagents/src/config.ts +0 -249
- package/packages/subagents/src/conversation-viewer.ts +0 -281
- package/packages/subagents/src/core-compat.ts +0 -94
- package/packages/subagents/src/custom-agents.ts +0 -343
- package/packages/subagents/src/file-system-retry.ts +0 -50
- package/packages/subagents/src/fleet-data.ts +0 -105
- package/packages/subagents/src/fleet-view.ts +0 -322
- package/packages/subagents/src/foreground-detach.ts +0 -59
- package/packages/subagents/src/fork-context.ts +0 -285
- package/packages/subagents/src/global.d.ts +0 -7
- package/packages/subagents/src/guide.ts +0 -129
- package/packages/subagents/src/mission-state.ts +0 -133
- package/packages/subagents/src/mission-store.ts +0 -436
- package/packages/subagents/src/output-limits.ts +0 -142
- package/packages/subagents/src/parity-types.ts +0 -315
- package/packages/subagents/src/pi-args.ts +0 -167
- package/packages/subagents/src/result-files.ts +0 -232
- package/packages/subagents/src/result-watcher.ts +0 -221
- package/packages/subagents/src/retained-children.ts +0 -176
- package/packages/subagents/src/run-fanout-budget.ts +0 -356
- package/packages/subagents/src/scheduled-runs.ts +0 -349
- package/packages/subagents/src/schemas.ts +0 -263
- package/packages/subagents/src/slash-commands.ts +0 -80
- package/packages/subagents/src/supervisor-channel.ts +0 -249
- package/packages/subagents/src/tool-handler.ts +0 -1144
- package/packages/subagents/src/types.ts +0 -238
- package/packages/subagents/src/widget.ts +0 -457
- package/packages/subagents/src/workflow-script.ts +0 -737
- package/packages/subagents/src/workflow-worker.ts +0 -384
- package/packages/subagents/src/worktree.ts +0 -614
- package/packages/utility/src/analytics/collector.ts +0 -293
- package/packages/utility/src/info-screen.ts +0 -80
- package/packages/utility/src/lifecycle/process.ts +0 -162
- package/packages/utility/src/prefix-cache.ts +0 -263
- package/packages/utility/src/skill-discovery.ts +0 -542
- package/packages/utility/src/tools/env.ts +0 -113
- package/packages/utility/src/tui/name-badge-state.ts +0 -315
- package/packages/utility/src/tui/name-badge.ts +0 -109
- /package/packages/{subagents/src → core/src/child-agent}/pi-spawn.ts +0 -0
|
@@ -1,356 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @pi-unipi/subagents — Run fan-out budget (maxSubagentSpawnsPerRun)
|
|
3
|
-
*
|
|
4
|
-
* Ported from pi-subagents src/runs/shared/run-fanout-budget.ts. Durable,
|
|
5
|
-
* file-backed claim directory per top-level run tree; claims are never
|
|
6
|
-
* refunded; groups admit atomically under an admission lock (stale-lock
|
|
7
|
-
* reclaim via pid check). Layout under OUR temp root
|
|
8
|
-
* (unipi-subagents-<scope>/run-fanout-budgets).
|
|
9
|
-
*/
|
|
10
|
-
|
|
11
|
-
import { randomUUID } from "node:crypto";
|
|
12
|
-
import * as fs from "node:fs";
|
|
13
|
-
import * as path from "node:path";
|
|
14
|
-
import {
|
|
15
|
-
DEFAULT_FILE_SYSTEM_RETRY_DELAYS_MS,
|
|
16
|
-
waitForFileSystemRetry,
|
|
17
|
-
} from "./file-system-retry.js";
|
|
18
|
-
import { TEMP_ROOT_DIR } from "./parity-types.js";
|
|
19
|
-
|
|
20
|
-
const RUN_FANOUT_ROOT = path.join(TEMP_ROOT_DIR, "run-fanout-budgets");
|
|
21
|
-
|
|
22
|
-
export interface RunFanoutBudgetDescriptor {
|
|
23
|
-
version: 1;
|
|
24
|
-
rootRunId: string;
|
|
25
|
-
directory: string;
|
|
26
|
-
limit: number;
|
|
27
|
-
parentPath?: string;
|
|
28
|
-
}
|
|
29
|
-
|
|
30
|
-
export interface RunFanoutBudgetSnapshot {
|
|
31
|
-
used: number;
|
|
32
|
-
limit: number;
|
|
33
|
-
remaining: number;
|
|
34
|
-
}
|
|
35
|
-
|
|
36
|
-
export interface RunFanoutRejection extends RunFanoutBudgetSnapshot {
|
|
37
|
-
code: "RUN_FANOUT_LIMIT";
|
|
38
|
-
path: string;
|
|
39
|
-
requested: number;
|
|
40
|
-
}
|
|
41
|
-
|
|
42
|
-
export class RunFanoutLimitError extends Error {
|
|
43
|
-
readonly rejection: RunFanoutRejection;
|
|
44
|
-
readonly snapshot: RunFanoutBudgetSnapshot;
|
|
45
|
-
|
|
46
|
-
constructor(rejection: RunFanoutRejection) {
|
|
47
|
-
super(formatRunFanoutRejection(rejection));
|
|
48
|
-
this.name = "RunFanoutLimitError";
|
|
49
|
-
this.rejection = rejection;
|
|
50
|
-
this.snapshot = { used: rejection.used, limit: rejection.limit, remaining: rejection.remaining };
|
|
51
|
-
}
|
|
52
|
-
}
|
|
53
|
-
|
|
54
|
-
interface ManifestV1 {
|
|
55
|
-
version: 1;
|
|
56
|
-
rootRunId: string;
|
|
57
|
-
limit: number;
|
|
58
|
-
createdAt: number;
|
|
59
|
-
}
|
|
60
|
-
|
|
61
|
-
interface ClaimV1 {
|
|
62
|
-
version: 1;
|
|
63
|
-
claimId: string;
|
|
64
|
-
path: string;
|
|
65
|
-
claimedAt: number;
|
|
66
|
-
}
|
|
67
|
-
|
|
68
|
-
function safeRootRunId(rootRunId: string): string {
|
|
69
|
-
return rootRunId.replace(/[^A-Za-z0-9._-]/g, "_").slice(0, 120) || randomUUID();
|
|
70
|
-
}
|
|
71
|
-
|
|
72
|
-
function parseManifest(value: unknown): ManifestV1 | undefined {
|
|
73
|
-
if (!value || typeof value !== "object" || Array.isArray(value)) return undefined;
|
|
74
|
-
const manifest = value as Partial<ManifestV1>;
|
|
75
|
-
if (
|
|
76
|
-
manifest.version !== 1 ||
|
|
77
|
-
typeof manifest.rootRunId !== "string" ||
|
|
78
|
-
!manifest.rootRunId ||
|
|
79
|
-
!Number.isInteger(manifest.limit) ||
|
|
80
|
-
(manifest.limit ?? 0) <= 0 ||
|
|
81
|
-
typeof manifest.createdAt !== "number" ||
|
|
82
|
-
!Number.isFinite(manifest.createdAt)
|
|
83
|
-
) {
|
|
84
|
-
return undefined;
|
|
85
|
-
}
|
|
86
|
-
return manifest as ManifestV1;
|
|
87
|
-
}
|
|
88
|
-
|
|
89
|
-
function readManifest(directory: string): ManifestV1 {
|
|
90
|
-
let parsed: unknown;
|
|
91
|
-
try {
|
|
92
|
-
parsed = JSON.parse(fs.readFileSync(path.join(directory, "manifest.json"), "utf-8"));
|
|
93
|
-
} catch (error) {
|
|
94
|
-
throw new Error(
|
|
95
|
-
`Run fan-out budget manifest is unreadable at '${directory}': ${error instanceof Error ? error.message : String(error)}`,
|
|
96
|
-
);
|
|
97
|
-
}
|
|
98
|
-
const manifest = parseManifest(parsed);
|
|
99
|
-
if (!manifest) throw new Error(`Run fan-out budget manifest is invalid at '${directory}'.`);
|
|
100
|
-
return manifest;
|
|
101
|
-
}
|
|
102
|
-
|
|
103
|
-
function validateDirectory(directory: string): string {
|
|
104
|
-
let realDirectory: string;
|
|
105
|
-
let realRoot: string;
|
|
106
|
-
try {
|
|
107
|
-
realDirectory = fs.realpathSync(path.resolve(directory));
|
|
108
|
-
realRoot = fs.realpathSync(path.resolve(RUN_FANOUT_ROOT));
|
|
109
|
-
} catch (error) {
|
|
110
|
-
throw new Error(
|
|
111
|
-
`Run fan-out budget directory is unavailable: ${error instanceof Error ? error.message : String(error)}`,
|
|
112
|
-
);
|
|
113
|
-
}
|
|
114
|
-
if (realDirectory !== realRoot && !realDirectory.startsWith(`${realRoot}${path.sep}`)) {
|
|
115
|
-
throw new Error("Run fan-out budget directory resolves outside the managed budget root.");
|
|
116
|
-
}
|
|
117
|
-
return realDirectory;
|
|
118
|
-
}
|
|
119
|
-
|
|
120
|
-
export function createRunFanoutBudget(rootRunId: string, limit: number): RunFanoutBudgetDescriptor {
|
|
121
|
-
if (!Number.isInteger(limit) || limit <= 0) throw new Error("Run fan-out limit must be a positive integer.");
|
|
122
|
-
fs.mkdirSync(RUN_FANOUT_ROOT, { recursive: true, mode: 0o700 });
|
|
123
|
-
let directory: string;
|
|
124
|
-
do {
|
|
125
|
-
directory = path.join(RUN_FANOUT_ROOT, `${safeRootRunId(rootRunId)}-${randomUUID()}`);
|
|
126
|
-
} while (fs.existsSync(directory));
|
|
127
|
-
fs.mkdirSync(path.join(directory, "claims"), { recursive: true, mode: 0o700 });
|
|
128
|
-
const manifest: ManifestV1 = { version: 1, rootRunId, limit, createdAt: Date.now() };
|
|
129
|
-
fs.writeFileSync(path.join(directory, "manifest.json"), `${JSON.stringify(manifest)}\n`, { mode: 0o600, flag: "wx" });
|
|
130
|
-
return { version: 1, rootRunId, directory, limit };
|
|
131
|
-
}
|
|
132
|
-
|
|
133
|
-
export function validateRunFanoutBudgetDescriptor(value: unknown): RunFanoutBudgetDescriptor {
|
|
134
|
-
if (!value || typeof value !== "object" || Array.isArray(value)) {
|
|
135
|
-
throw new Error("Run fan-out budget descriptor is missing or invalid.");
|
|
136
|
-
}
|
|
137
|
-
const descriptor = value as Partial<RunFanoutBudgetDescriptor>;
|
|
138
|
-
if (
|
|
139
|
-
descriptor.version !== 1 ||
|
|
140
|
-
typeof descriptor.rootRunId !== "string" ||
|
|
141
|
-
!descriptor.rootRunId ||
|
|
142
|
-
typeof descriptor.directory !== "string" ||
|
|
143
|
-
!descriptor.directory ||
|
|
144
|
-
!Number.isInteger(descriptor.limit) ||
|
|
145
|
-
(descriptor.limit ?? 0) <= 0 ||
|
|
146
|
-
(descriptor.parentPath !== undefined && typeof descriptor.parentPath !== "string")
|
|
147
|
-
) {
|
|
148
|
-
throw new Error("Run fan-out budget descriptor is invalid.");
|
|
149
|
-
}
|
|
150
|
-
const directory = validateDirectory(descriptor.directory);
|
|
151
|
-
const manifest = readManifest(directory);
|
|
152
|
-
if (manifest.rootRunId !== descriptor.rootRunId || manifest.limit !== descriptor.limit) {
|
|
153
|
-
throw new Error("Run fan-out budget descriptor does not match its manifest.");
|
|
154
|
-
}
|
|
155
|
-
return {
|
|
156
|
-
version: 1,
|
|
157
|
-
rootRunId: descriptor.rootRunId,
|
|
158
|
-
directory,
|
|
159
|
-
limit: descriptor.limit,
|
|
160
|
-
...(descriptor.parentPath ? { parentPath: descriptor.parentPath } : {}),
|
|
161
|
-
};
|
|
162
|
-
}
|
|
163
|
-
|
|
164
|
-
export function writeRunFanoutBudgetDescriptor(asyncDir: string, descriptor: RunFanoutBudgetDescriptor): void {
|
|
165
|
-
const valid = validateRunFanoutBudgetDescriptor(descriptor);
|
|
166
|
-
fs.mkdirSync(asyncDir, { recursive: true });
|
|
167
|
-
fs.writeFileSync(path.join(asyncDir, "run-fanout-budget.json"), `${JSON.stringify(valid)}\n`, { mode: 0o600 });
|
|
168
|
-
}
|
|
169
|
-
|
|
170
|
-
export function readRunFanoutBudgetDescriptor(asyncDir: string | undefined): RunFanoutBudgetDescriptor | undefined {
|
|
171
|
-
if (!asyncDir) return undefined;
|
|
172
|
-
const descriptorPath = path.join(asyncDir, "run-fanout-budget.json");
|
|
173
|
-
if (!fs.existsSync(descriptorPath)) return undefined;
|
|
174
|
-
try {
|
|
175
|
-
return validateRunFanoutBudgetDescriptor(JSON.parse(fs.readFileSync(descriptorPath, "utf-8")));
|
|
176
|
-
} catch (error) {
|
|
177
|
-
throw new Error(
|
|
178
|
-
`Invalid persisted run fan-out budget '${descriptorPath}': ${error instanceof Error ? error.message : String(error)}`,
|
|
179
|
-
);
|
|
180
|
-
}
|
|
181
|
-
}
|
|
182
|
-
|
|
183
|
-
interface AdmissionLockOwner {
|
|
184
|
-
pid: number;
|
|
185
|
-
token: string;
|
|
186
|
-
}
|
|
187
|
-
|
|
188
|
-
const ADMISSION_LOCK_STALE_MS = 60_000;
|
|
189
|
-
|
|
190
|
-
function readAdmissionLockOwner(lockPath: string): AdmissionLockOwner | undefined {
|
|
191
|
-
try {
|
|
192
|
-
const owner = JSON.parse(fs.readFileSync(path.join(lockPath, "owner.json"), "utf-8")) as Partial<AdmissionLockOwner>;
|
|
193
|
-
if (Number.isSafeInteger(owner.pid) && (owner.pid ?? 0) > 0 && typeof owner.token === "string" && owner.token) {
|
|
194
|
-
return owner as AdmissionLockOwner;
|
|
195
|
-
}
|
|
196
|
-
} catch {
|
|
197
|
-
// unreadable = treat as absent
|
|
198
|
-
}
|
|
199
|
-
return undefined;
|
|
200
|
-
}
|
|
201
|
-
|
|
202
|
-
function admissionLockIsStale(lockPath: string): boolean {
|
|
203
|
-
const owner = readAdmissionLockOwner(lockPath);
|
|
204
|
-
if (owner) {
|
|
205
|
-
try {
|
|
206
|
-
process.kill(owner.pid, 0);
|
|
207
|
-
return false;
|
|
208
|
-
} catch (error) {
|
|
209
|
-
return (error as NodeJS.ErrnoException).code !== "EPERM";
|
|
210
|
-
}
|
|
211
|
-
}
|
|
212
|
-
try {
|
|
213
|
-
return Date.now() - fs.statSync(lockPath).mtimeMs > ADMISSION_LOCK_STALE_MS;
|
|
214
|
-
} catch (error) {
|
|
215
|
-
if ((error as NodeJS.ErrnoException).code === "ENOENT") return false;
|
|
216
|
-
throw error;
|
|
217
|
-
}
|
|
218
|
-
}
|
|
219
|
-
|
|
220
|
-
function withAdmissionLock<T>(directory: string, operation: () => T): T {
|
|
221
|
-
const lockPath = path.join(directory, "admission.lock");
|
|
222
|
-
const owner: AdmissionLockOwner = { pid: process.pid, token: randomUUID() };
|
|
223
|
-
for (let attempt = 0; ; attempt++) {
|
|
224
|
-
try {
|
|
225
|
-
fs.mkdirSync(lockPath, { mode: 0o700 });
|
|
226
|
-
try {
|
|
227
|
-
fs.writeFileSync(path.join(lockPath, "owner.json"), JSON.stringify(owner), { mode: 0o600 });
|
|
228
|
-
} catch (error) {
|
|
229
|
-
fs.rmSync(lockPath, { recursive: true, force: true });
|
|
230
|
-
throw error;
|
|
231
|
-
}
|
|
232
|
-
break;
|
|
233
|
-
} catch (error) {
|
|
234
|
-
if ((error as NodeJS.ErrnoException).code !== "EEXIST") throw error;
|
|
235
|
-
if (admissionLockIsStale(lockPath)) {
|
|
236
|
-
const stalePath = path.join(directory, `admission.stale-${randomUUID()}`);
|
|
237
|
-
try {
|
|
238
|
-
fs.renameSync(lockPath, stalePath);
|
|
239
|
-
fs.rmSync(stalePath, { recursive: true, force: true });
|
|
240
|
-
continue;
|
|
241
|
-
} catch (reclaimError) {
|
|
242
|
-
if ((reclaimError as NodeJS.ErrnoException).code !== "ENOENT") throw reclaimError;
|
|
243
|
-
}
|
|
244
|
-
}
|
|
245
|
-
const delay = DEFAULT_FILE_SYSTEM_RETRY_DELAYS_MS[attempt];
|
|
246
|
-
if (delay === undefined) {
|
|
247
|
-
throw new Error(`Timed out acquiring run fan-out admission lock at '${directory}'.`);
|
|
248
|
-
}
|
|
249
|
-
waitForFileSystemRetry(delay);
|
|
250
|
-
}
|
|
251
|
-
}
|
|
252
|
-
try {
|
|
253
|
-
return operation();
|
|
254
|
-
} finally {
|
|
255
|
-
if (readAdmissionLockOwner(lockPath)?.token === owner.token) {
|
|
256
|
-
fs.rmSync(lockPath, { recursive: true, force: true });
|
|
257
|
-
}
|
|
258
|
-
}
|
|
259
|
-
}
|
|
260
|
-
|
|
261
|
-
function claimCount(directory: string): number {
|
|
262
|
-
const claimsDir = path.join(directory, "claims");
|
|
263
|
-
let entries: fs.Dirent[];
|
|
264
|
-
try {
|
|
265
|
-
entries = fs.readdirSync(claimsDir, { withFileTypes: true });
|
|
266
|
-
} catch (error) {
|
|
267
|
-
throw new Error(
|
|
268
|
-
`Run fan-out claims directory is unreadable at '${claimsDir}': ${error instanceof Error ? error.message : String(error)}`,
|
|
269
|
-
);
|
|
270
|
-
}
|
|
271
|
-
return entries.filter((entry) => /^\d{6}\.json$/.test(entry.name)).length;
|
|
272
|
-
}
|
|
273
|
-
|
|
274
|
-
export function getRunFanoutBudgetSnapshot(descriptor: RunFanoutBudgetDescriptor): RunFanoutBudgetSnapshot {
|
|
275
|
-
const valid = validateRunFanoutBudgetDescriptor(descriptor);
|
|
276
|
-
const used = claimCount(valid.directory);
|
|
277
|
-
return { used, limit: valid.limit, remaining: Math.max(0, valid.limit - used) };
|
|
278
|
-
}
|
|
279
|
-
|
|
280
|
-
function qualifyRunFanoutPaths(descriptor: RunFanoutBudgetDescriptor, paths: string[]): string[] {
|
|
281
|
-
const prefix = descriptor.parentPath?.trim();
|
|
282
|
-
return paths.map((item) => (prefix ? `${prefix}/${item}` : item));
|
|
283
|
-
}
|
|
284
|
-
|
|
285
|
-
function commitRunFanoutBatch<T>(
|
|
286
|
-
descriptor: RunFanoutBudgetDescriptor,
|
|
287
|
-
paths: string[],
|
|
288
|
-
commit: (snapshot: RunFanoutBudgetSnapshot) => T,
|
|
289
|
-
): T {
|
|
290
|
-
const valid = validateRunFanoutBudgetDescriptor(descriptor);
|
|
291
|
-
if (paths.length === 0) return commit(getRunFanoutBudgetSnapshot(valid));
|
|
292
|
-
const qualified = qualifyRunFanoutPaths(valid, paths);
|
|
293
|
-
return withAdmissionLock(valid.directory, () => {
|
|
294
|
-
const before = getRunFanoutBudgetSnapshot(valid);
|
|
295
|
-
if (qualified.length > before.remaining) {
|
|
296
|
-
throw new RunFanoutLimitError({
|
|
297
|
-
code: "RUN_FANOUT_LIMIT",
|
|
298
|
-
path: qualified[before.remaining] ?? qualified[0]!,
|
|
299
|
-
requested: qualified.length,
|
|
300
|
-
...before,
|
|
301
|
-
});
|
|
302
|
-
}
|
|
303
|
-
const created: string[] = [];
|
|
304
|
-
try {
|
|
305
|
-
for (const claimPath of qualified) {
|
|
306
|
-
for (let slot = 0; slot < valid.limit; slot++) {
|
|
307
|
-
const slotPath = path.join(valid.directory, "claims", `${String(slot).padStart(6, "0")}.json`);
|
|
308
|
-
try {
|
|
309
|
-
const fd = fs.openSync(slotPath, "wx", 0o600);
|
|
310
|
-
created.push(slotPath);
|
|
311
|
-
try {
|
|
312
|
-
const claim: ClaimV1 = { version: 1, claimId: randomUUID(), path: claimPath, claimedAt: Date.now() };
|
|
313
|
-
fs.writeFileSync(fd, `${JSON.stringify(claim)}\n`, "utf-8");
|
|
314
|
-
} finally {
|
|
315
|
-
fs.closeSync(fd);
|
|
316
|
-
}
|
|
317
|
-
break;
|
|
318
|
-
} catch (error) {
|
|
319
|
-
if ((error as NodeJS.ErrnoException).code === "EEXIST") continue;
|
|
320
|
-
throw error;
|
|
321
|
-
}
|
|
322
|
-
}
|
|
323
|
-
}
|
|
324
|
-
return commit(getRunFanoutBudgetSnapshot(valid));
|
|
325
|
-
} catch (error) {
|
|
326
|
-
for (const slotPath of created) {
|
|
327
|
-
try {
|
|
328
|
-
fs.unlinkSync(slotPath);
|
|
329
|
-
} catch {
|
|
330
|
-
// best-effort rollback
|
|
331
|
-
}
|
|
332
|
-
}
|
|
333
|
-
throw error;
|
|
334
|
-
}
|
|
335
|
-
});
|
|
336
|
-
}
|
|
337
|
-
|
|
338
|
-
export function claimRunFanoutBatch(descriptor: RunFanoutBudgetDescriptor, paths: string[]): RunFanoutBudgetSnapshot {
|
|
339
|
-
return commitRunFanoutBatch(descriptor, paths, (snapshot) => snapshot);
|
|
340
|
-
}
|
|
341
|
-
|
|
342
|
-
export function claimRunFanoutBatchWithCommit<T>(
|
|
343
|
-
descriptor: RunFanoutBudgetDescriptor,
|
|
344
|
-
paths: string[],
|
|
345
|
-
commit: () => T,
|
|
346
|
-
): T {
|
|
347
|
-
return commitRunFanoutBatch(descriptor, paths, commit);
|
|
348
|
-
}
|
|
349
|
-
|
|
350
|
-
export function formatRunFanoutBudget(snapshot: RunFanoutBudgetSnapshot): string {
|
|
351
|
-
return `Run fan-out: ${snapshot.used}/${snapshot.limit} used, ${snapshot.remaining} remaining`;
|
|
352
|
-
}
|
|
353
|
-
|
|
354
|
-
function formatRunFanoutRejection(rejection: RunFanoutRejection): string {
|
|
355
|
-
return `Run fan-out limit reached at ${rejection.path} (${rejection.used}/${rejection.limit} used; ${rejection.requested} requested, ${rejection.remaining} remaining). No children from this admission group were started. Start a new top-level run or raise the maxSubagentSpawnsPerRun config.`;
|
|
356
|
-
}
|
|
@@ -1,349 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @pi-unipi/subagents — Durable scheduled runs
|
|
3
|
-
*
|
|
4
|
-
* Ported from pi-subagents src/runs/background/scheduled-runs.ts (core).
|
|
5
|
-
* Schedules persist per project under OUR layout:
|
|
6
|
-
* ~/.unipi/schedules/<project-hash>/<id>.json. One-shot (+delay or ISO with
|
|
7
|
-
* timezone) and fixed-interval (30m/6h/2d/2w) triggers; overlap policy skip;
|
|
8
|
-
* catchUp none|latest; pause/resume/run/delete; run history receipts.
|
|
9
|
-
*/
|
|
10
|
-
|
|
11
|
-
import * as fs from "node:fs";
|
|
12
|
-
import * as path from "node:path";
|
|
13
|
-
import { createHash, randomUUID } from "node:crypto";
|
|
14
|
-
import { homedir } from "node:os";
|
|
15
|
-
import { stateDir } from "@pi-unipi/core";
|
|
16
|
-
|
|
17
|
-
export type ScheduleTrigger =
|
|
18
|
-
| { kind: "once"; at: string; atMs: number }
|
|
19
|
-
| { kind: "interval"; every: string; everyMs: number; anchorAt: string; nextRunAt: string };
|
|
20
|
-
|
|
21
|
-
export interface ScheduleRecord {
|
|
22
|
-
schemaVersion: 1;
|
|
23
|
-
id: string;
|
|
24
|
-
name: string;
|
|
25
|
-
cwd: string;
|
|
26
|
-
trigger: ScheduleTrigger;
|
|
27
|
-
/** Launch parameters captured for the run (agent + task). */
|
|
28
|
-
agent: string;
|
|
29
|
-
task: string;
|
|
30
|
-
overlap: "skip";
|
|
31
|
-
catchUp: "none" | "latest";
|
|
32
|
-
timeoutMs?: number;
|
|
33
|
-
paused: boolean;
|
|
34
|
-
createdAt: string;
|
|
35
|
-
updatedAt: string;
|
|
36
|
-
activeRunId?: string;
|
|
37
|
-
lastRunId?: string;
|
|
38
|
-
}
|
|
39
|
-
|
|
40
|
-
export interface ScheduleRunRecord {
|
|
41
|
-
schemaVersion: 1;
|
|
42
|
-
id: string;
|
|
43
|
-
scheduleId: string;
|
|
44
|
-
plannedAt: string;
|
|
45
|
-
dueReason: "timer" | "run-due" | "manual";
|
|
46
|
-
state: "pending" | "running" | "completed" | "failed" | "skipped";
|
|
47
|
-
startedAt?: string;
|
|
48
|
-
completedAt?: string;
|
|
49
|
-
asyncRunId?: string;
|
|
50
|
-
error?: string;
|
|
51
|
-
}
|
|
52
|
-
|
|
53
|
-
// ============================================================================
|
|
54
|
-
// Parsing (reference semantics)
|
|
55
|
-
// ============================================================================
|
|
56
|
-
|
|
57
|
-
export function parseScheduledRunTime(at: string, now = Date.now()): number {
|
|
58
|
-
const trimmed = at.trim();
|
|
59
|
-
const relative = trimmed.match(/^\+(\d+)(s|m|h|d)$/);
|
|
60
|
-
if (relative) {
|
|
61
|
-
const amount = Number(relative[1]);
|
|
62
|
-
if (!Number.isSafeInteger(amount) || amount < 1) {
|
|
63
|
-
throw new Error(`Invalid at value "${at}". Relative delays must be positive, such as "+10m".`);
|
|
64
|
-
}
|
|
65
|
-
const unitMs = { s: 1_000, m: 60_000, h: 3_600_000, d: 86_400_000 }[relative[2] as "s" | "m" | "h" | "d"];
|
|
66
|
-
const result = now + amount * unitMs;
|
|
67
|
-
if (!Number.isSafeInteger(result)) throw new Error(`Invalid at value "${at}". Relative delay is too large.`);
|
|
68
|
-
return result;
|
|
69
|
-
}
|
|
70
|
-
const iso = trimmed.match(/^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2})(?::(\d{2})(?:\.\d{1,3})?)?(Z|[+-]\d{2}:\d{2})$/);
|
|
71
|
-
if (!iso) throw new Error(`Invalid at value "${at}". Use a one-shot delay such as "+10m" or an ISO timestamp with timezone.`);
|
|
72
|
-
const year = Number(iso[1]);
|
|
73
|
-
const month = Number(iso[2]);
|
|
74
|
-
const day = Number(iso[3]);
|
|
75
|
-
const hour = Number(iso[4]);
|
|
76
|
-
const minute = Number(iso[5]);
|
|
77
|
-
const second = iso[6] === undefined ? 0 : Number(iso[6]);
|
|
78
|
-
const zone = iso[7]!;
|
|
79
|
-
const offsetHour = zone === "Z" ? 0 : Number(zone.slice(1, 3));
|
|
80
|
-
const offsetMinute = zone === "Z" ? 0 : Number(zone.slice(4, 6));
|
|
81
|
-
const daysInMonth = month >= 1 && month <= 12 ? new Date(Date.UTC(year, month, 0)).getUTCDate() : 0;
|
|
82
|
-
const parsed = Date.parse(trimmed);
|
|
83
|
-
if (
|
|
84
|
-
month < 1 || month > 12 || day < 1 || day > daysInMonth || hour > 23 || minute > 59 ||
|
|
85
|
-
second > 59 || offsetHour > 23 || offsetMinute > 59 || !Number.isFinite(parsed)
|
|
86
|
-
) {
|
|
87
|
-
throw new Error(`Invalid at value "${at}". Use a valid ISO timestamp.`);
|
|
88
|
-
}
|
|
89
|
-
if (parsed <= now) throw new Error(`Scheduled time ${new Date(parsed).toISOString()} is in the past.`);
|
|
90
|
-
return parsed;
|
|
91
|
-
}
|
|
92
|
-
|
|
93
|
-
export function parseScheduleInterval(every: string): number {
|
|
94
|
-
const match = every.trim().match(/^(\d+)(m|h|d|w)$/);
|
|
95
|
-
if (!match) {
|
|
96
|
-
throw new Error(`Invalid every value "${every}". This first recurring slice supports fixed intervals such as "30m", "6h", "2d", or "2w".`);
|
|
97
|
-
}
|
|
98
|
-
const amount = Number(match[1]);
|
|
99
|
-
if (!Number.isSafeInteger(amount) || amount < 1) throw new Error(`Invalid every value "${every}". Interval must be positive.`);
|
|
100
|
-
const unitMs = { m: 60_000, h: 3_600_000, d: 86_400_000, w: 604_800_000 }[match[2] as "m" | "h" | "d" | "w"];
|
|
101
|
-
const result = amount * unitMs;
|
|
102
|
-
if (!Number.isSafeInteger(result)) throw new Error(`Invalid every value "${every}". Interval is too large.`);
|
|
103
|
-
return result;
|
|
104
|
-
}
|
|
105
|
-
|
|
106
|
-
// ============================================================================
|
|
107
|
-
// Store — OUR layout: ~/.unipi/schedules/<project-hash>/
|
|
108
|
-
// ============================================================================
|
|
109
|
-
|
|
110
|
-
export function scheduleStorePath(projectRoot: string, storeRoot?: string): string {
|
|
111
|
-
const resolved = path.resolve(projectRoot);
|
|
112
|
-
// Default: durable per-workspace state, collision-safe by marker uuid.
|
|
113
|
-
if (!storeRoot) return path.join(stateDir("subagents", "state", resolved), "schedules");
|
|
114
|
-
const projectKey = createHash("sha256").update(resolved).digest("hex").slice(0, 20);
|
|
115
|
-
return path.join(storeRoot.startsWith("~/") ? path.join(homedir(), storeRoot.slice(2)) : storeRoot, projectKey);
|
|
116
|
-
}
|
|
117
|
-
|
|
118
|
-
function writeAtomic(filePath: string, value: unknown): void {
|
|
119
|
-
fs.mkdirSync(path.dirname(filePath), { recursive: true, mode: 0o700 });
|
|
120
|
-
const tmp = `${filePath}.tmp-${process.pid}`;
|
|
121
|
-
fs.writeFileSync(tmp, `${JSON.stringify(value, null, 2)}\n`, { mode: 0o600 });
|
|
122
|
-
fs.renameSync(tmp, filePath);
|
|
123
|
-
}
|
|
124
|
-
|
|
125
|
-
export class ScheduledRunManager {
|
|
126
|
-
private timer: ReturnType<typeof setInterval> | undefined;
|
|
127
|
-
|
|
128
|
-
constructor(
|
|
129
|
-
private projectRoot: string,
|
|
130
|
-
private opts: {
|
|
131
|
-
storeRoot?: string;
|
|
132
|
-
maxPending?: number;
|
|
133
|
-
/** Launch a due schedule. Returns the async run id. */
|
|
134
|
-
launch: (record: ScheduleRecord, dueReason: ScheduleRunRecord["dueReason"]) => Promise<string>;
|
|
135
|
-
pollIntervalMs?: number;
|
|
136
|
-
},
|
|
137
|
-
) {}
|
|
138
|
-
|
|
139
|
-
get storeDir(): string {
|
|
140
|
-
return scheduleStorePath(this.projectRoot, this.opts.storeRoot);
|
|
141
|
-
}
|
|
142
|
-
|
|
143
|
-
private recordPath(id: string): string {
|
|
144
|
-
return path.join(this.storeDir, `${id}.json`);
|
|
145
|
-
}
|
|
146
|
-
|
|
147
|
-
private historyPath(id: string): string {
|
|
148
|
-
return path.join(this.storeDir, `${id}.runs.json`);
|
|
149
|
-
}
|
|
150
|
-
|
|
151
|
-
create(input: {
|
|
152
|
-
name: string;
|
|
153
|
-
agent: string;
|
|
154
|
-
task: string;
|
|
155
|
-
at?: string;
|
|
156
|
-
every?: string;
|
|
157
|
-
catchUp?: "none" | "latest";
|
|
158
|
-
timeoutMs?: number;
|
|
159
|
-
}, now = Date.now()): ScheduleRecord {
|
|
160
|
-
if (!input.name?.trim()) throw new Error("schedule name must be a non-empty string.");
|
|
161
|
-
if (!input.agent?.trim()) throw new Error("schedule requires an agent.");
|
|
162
|
-
if (!input.task?.trim()) throw new Error("schedule requires a task.");
|
|
163
|
-
let trigger: ScheduleTrigger;
|
|
164
|
-
if (input.at !== undefined && input.every !== undefined) {
|
|
165
|
-
throw new Error("Use either 'at' (one-shot) or 'every' (recurring), not both.");
|
|
166
|
-
}
|
|
167
|
-
if (input.at !== undefined) {
|
|
168
|
-
const atMs = parseScheduledRunTime(input.at, now);
|
|
169
|
-
trigger = { kind: "once", at: input.at.trim(), atMs };
|
|
170
|
-
} else if (input.every !== undefined) {
|
|
171
|
-
const everyMs = parseScheduleInterval(input.every);
|
|
172
|
-
trigger = {
|
|
173
|
-
kind: "interval",
|
|
174
|
-
every: input.every.trim(),
|
|
175
|
-
everyMs,
|
|
176
|
-
anchorAt: new Date(now).toISOString(),
|
|
177
|
-
nextRunAt: new Date(now + everyMs).toISOString(),
|
|
178
|
-
};
|
|
179
|
-
} else {
|
|
180
|
-
throw new Error("schedule requires 'at' (one-shot) or 'every' (recurring).");
|
|
181
|
-
}
|
|
182
|
-
|
|
183
|
-
// maxPending cap
|
|
184
|
-
const existing = this.list();
|
|
185
|
-
const maxPending = this.opts.maxPending ?? 20;
|
|
186
|
-
if (existing.filter((r) => !r.paused && r.trigger.kind === "interval").length >= maxPending) {
|
|
187
|
-
throw new Error(`Pending schedule cap reached (${maxPending}). Delete or pause schedules first.`);
|
|
188
|
-
}
|
|
189
|
-
|
|
190
|
-
const record: ScheduleRecord = {
|
|
191
|
-
schemaVersion: 1,
|
|
192
|
-
id: randomUUID(),
|
|
193
|
-
name: input.name.trim(),
|
|
194
|
-
cwd: path.resolve(this.projectRoot),
|
|
195
|
-
trigger,
|
|
196
|
-
agent: input.agent.trim(),
|
|
197
|
-
task: input.task.trim(),
|
|
198
|
-
overlap: "skip",
|
|
199
|
-
catchUp: input.catchUp ?? "latest",
|
|
200
|
-
...(input.timeoutMs !== undefined ? { timeoutMs: input.timeoutMs } : {}),
|
|
201
|
-
paused: false,
|
|
202
|
-
createdAt: new Date(now).toISOString(),
|
|
203
|
-
updatedAt: new Date(now).toISOString(),
|
|
204
|
-
};
|
|
205
|
-
writeAtomic(this.recordPath(record.id), record);
|
|
206
|
-
return record;
|
|
207
|
-
}
|
|
208
|
-
|
|
209
|
-
list(): ScheduleRecord[] {
|
|
210
|
-
let entries: fs.Dirent[];
|
|
211
|
-
try {
|
|
212
|
-
entries = fs.readdirSync(this.storeDir, { withFileTypes: true });
|
|
213
|
-
} catch {
|
|
214
|
-
return [];
|
|
215
|
-
}
|
|
216
|
-
const records: ScheduleRecord[] = [];
|
|
217
|
-
for (const entry of entries) {
|
|
218
|
-
if (!entry.isFile() || !entry.name.endsWith(".json") || entry.name.endsWith(".runs.json")) continue;
|
|
219
|
-
try {
|
|
220
|
-
records.push(JSON.parse(fs.readFileSync(path.join(this.storeDir, entry.name), "utf8")) as ScheduleRecord);
|
|
221
|
-
} catch {
|
|
222
|
-
// Skip corrupt records.
|
|
223
|
-
}
|
|
224
|
-
}
|
|
225
|
-
return records.sort((left, right) => left.createdAt.localeCompare(right.createdAt));
|
|
226
|
-
}
|
|
227
|
-
|
|
228
|
-
show(idOrPrefix: string): ScheduleRecord | undefined {
|
|
229
|
-
return this.list().find((r) => r.id.startsWith(idOrPrefix));
|
|
230
|
-
}
|
|
231
|
-
|
|
232
|
-
private save(record: ScheduleRecord): void {
|
|
233
|
-
writeAtomic(this.recordPath(record.id), record);
|
|
234
|
-
}
|
|
235
|
-
|
|
236
|
-
setPaused(idOrPrefix: string, paused: boolean): ScheduleRecord {
|
|
237
|
-
const record = this.show(idOrPrefix);
|
|
238
|
-
if (!record) throw new Error(`No schedule matches "${idOrPrefix}".`);
|
|
239
|
-
record.paused = paused;
|
|
240
|
-
record.updatedAt = new Date().toISOString();
|
|
241
|
-
this.save(record);
|
|
242
|
-
return record;
|
|
243
|
-
}
|
|
244
|
-
|
|
245
|
-
delete(idOrPrefix: string): boolean {
|
|
246
|
-
const record = this.show(idOrPrefix);
|
|
247
|
-
if (!record) return false;
|
|
248
|
-
fs.rmSync(this.recordPath(record.id), { force: true });
|
|
249
|
-
fs.rmSync(this.historyPath(record.id), { force: true });
|
|
250
|
-
return true;
|
|
251
|
-
}
|
|
252
|
-
|
|
253
|
-
/** Run a schedule immediately (manual trigger). */
|
|
254
|
-
async runNow(idOrPrefix: string): Promise<ScheduleRunRecord> {
|
|
255
|
-
const record = this.show(idOrPrefix);
|
|
256
|
-
if (!record) throw new Error(`No schedule matches "${idOrPrefix}".`);
|
|
257
|
-
return this.execute(record, "manual");
|
|
258
|
-
}
|
|
259
|
-
|
|
260
|
-
private async execute(record: ScheduleRecord, dueReason: ScheduleRunRecord["dueReason"]): Promise<ScheduleRunRecord> {
|
|
261
|
-
// Overlap policy: skip when a run is already active.
|
|
262
|
-
if (record.activeRunId) {
|
|
263
|
-
return {
|
|
264
|
-
schemaVersion: 1,
|
|
265
|
-
id: randomUUID(),
|
|
266
|
-
scheduleId: record.id,
|
|
267
|
-
plannedAt: new Date().toISOString(),
|
|
268
|
-
dueReason,
|
|
269
|
-
state: "skipped",
|
|
270
|
-
error: "overlap: previous run still active",
|
|
271
|
-
};
|
|
272
|
-
}
|
|
273
|
-
|
|
274
|
-
const runRecord: ScheduleRunRecord = {
|
|
275
|
-
schemaVersion: 1,
|
|
276
|
-
id: randomUUID(),
|
|
277
|
-
scheduleId: record.id,
|
|
278
|
-
plannedAt: new Date().toISOString(),
|
|
279
|
-
dueReason,
|
|
280
|
-
state: "running",
|
|
281
|
-
startedAt: new Date().toISOString(),
|
|
282
|
-
};
|
|
283
|
-
|
|
284
|
-
try {
|
|
285
|
-
const asyncRunId = await this.opts.launch(record, dueReason);
|
|
286
|
-
runRecord.asyncRunId = asyncRunId;
|
|
287
|
-
runRecord.state = "completed";
|
|
288
|
-
} catch (error) {
|
|
289
|
-
runRecord.state = "failed";
|
|
290
|
-
runRecord.error = error instanceof Error ? error.message : String(error);
|
|
291
|
-
}
|
|
292
|
-
runRecord.completedAt = new Date().toISOString();
|
|
293
|
-
|
|
294
|
-
// Update the schedule + append history.
|
|
295
|
-
record.lastRunId = runRecord.id;
|
|
296
|
-
record.activeRunId = undefined;
|
|
297
|
-
record.updatedAt = new Date().toISOString();
|
|
298
|
-
if (record.trigger.kind === "interval") {
|
|
299
|
-
record.trigger.nextRunAt = new Date(Date.now() + record.trigger.everyMs).toISOString();
|
|
300
|
-
}
|
|
301
|
-
this.save(record);
|
|
302
|
-
|
|
303
|
-
const history = this.readHistory(record.id);
|
|
304
|
-
history.push(runRecord);
|
|
305
|
-
writeAtomic(this.historyPath(record.id), history);
|
|
306
|
-
return runRecord;
|
|
307
|
-
}
|
|
308
|
-
|
|
309
|
-
readHistory(idOrPrefix: string): ScheduleRunRecord[] {
|
|
310
|
-
const record = this.show(idOrPrefix);
|
|
311
|
-
if (!record) return [];
|
|
312
|
-
try {
|
|
313
|
-
const parsed = JSON.parse(fs.readFileSync(this.historyPath(record.id), "utf8")) as ScheduleRunRecord[];
|
|
314
|
-
return Array.isArray(parsed) ? parsed : [];
|
|
315
|
-
} catch {
|
|
316
|
-
return [];
|
|
317
|
-
}
|
|
318
|
-
}
|
|
319
|
-
|
|
320
|
-
/** Tick: launch all due schedules. Called by the poll timer. */
|
|
321
|
-
async runDue(): Promise<ScheduleRunRecord[]> {
|
|
322
|
-
const results: ScheduleRunRecord[] = [];
|
|
323
|
-
const now = Date.now();
|
|
324
|
-
for (const record of this.list()) {
|
|
325
|
-
if (record.paused) continue;
|
|
326
|
-
let due = false;
|
|
327
|
-
if (record.trigger.kind === "once") {
|
|
328
|
-
due = record.trigger.atMs <= now;
|
|
329
|
-
} else {
|
|
330
|
-
due = Date.parse(record.trigger.nextRunAt) <= now;
|
|
331
|
-
}
|
|
332
|
-
if (due) results.push(await this.execute(record, "timer"));
|
|
333
|
-
}
|
|
334
|
-
return results;
|
|
335
|
-
}
|
|
336
|
-
|
|
337
|
-
startPolling(): void {
|
|
338
|
-
if (this.timer) return;
|
|
339
|
-
this.timer = setInterval(() => {
|
|
340
|
-
void this.runDue().catch(() => {});
|
|
341
|
-
}, this.opts.pollIntervalMs ?? 60_000);
|
|
342
|
-
this.timer.unref?.();
|
|
343
|
-
}
|
|
344
|
-
|
|
345
|
-
stopPolling(): void {
|
|
346
|
-
if (this.timer) clearInterval(this.timer);
|
|
347
|
-
this.timer = undefined;
|
|
348
|
-
}
|
|
349
|
-
}
|