harnery 0.36.0 → 0.38.0
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/dist/commander.d.ts +9 -0
- package/dist/commander.d.ts.map +1 -1
- package/dist/commander.js +10 -1
- package/dist/commands/admission.d.ts +21 -0
- package/dist/commands/admission.d.ts.map +1 -0
- package/dist/commands/admission.js +565 -0
- package/dist/commands/agents.d.ts +7 -0
- package/dist/commands/agents.d.ts.map +1 -1
- package/dist/commands/agents.js +148 -47
- package/dist/commands/artifacts.d.ts.map +1 -1
- package/dist/commands/artifacts.js +73 -2
- package/dist/commands/browse-ai.d.ts +2 -2
- package/dist/commands/browse-ai.d.ts.map +1 -1
- package/dist/commands/browse-ai.js +6 -4
- package/dist/commands/browse.d.ts.map +1 -1
- package/dist/commands/browse.js +360 -21
- package/dist/commands/diagnostics.d.ts +4 -0
- package/dist/commands/diagnostics.d.ts.map +1 -0
- package/dist/commands/diagnostics.js +229 -0
- package/dist/commands/fetch.js +1 -0
- package/dist/commands/files.d.ts +12 -0
- package/dist/commands/files.d.ts.map +1 -1
- package/dist/commands/files.js +54 -1
- package/dist/commands/governor.d.ts.map +1 -1
- package/dist/commands/governor.js +4 -0
- package/dist/commands/ledger-v3.d.ts.map +1 -1
- package/dist/commands/ledger-v3.js +71 -2
- package/dist/commands/qa-record.d.ts +144 -0
- package/dist/commands/qa-record.d.ts.map +1 -0
- package/dist/commands/qa-record.js +0 -0
- package/dist/commands/qa-run.d.ts +8 -0
- package/dist/commands/qa-run.d.ts.map +1 -0
- package/dist/commands/qa-run.js +396 -0
- package/dist/commands/qa-status.d.ts +71 -0
- package/dist/commands/qa-status.d.ts.map +1 -0
- package/dist/commands/qa-status.js +490 -0
- package/dist/commands/qa-verify.d.ts +40 -0
- package/dist/commands/qa-verify.d.ts.map +1 -0
- package/dist/commands/qa-verify.js +180 -0
- package/dist/commands/resources.d.ts +4 -0
- package/dist/commands/resources.d.ts.map +1 -0
- package/dist/commands/resources.js +29 -0
- package/dist/commands/review-pack.d.ts +4 -0
- package/dist/commands/review-pack.d.ts.map +1 -0
- package/dist/commands/review-pack.js +1001 -0
- package/dist/commands/supervisor.d.ts +4 -0
- package/dist/commands/supervisor.d.ts.map +1 -0
- package/dist/commands/supervisor.js +101 -0
- package/dist/commands/web.d.ts.map +1 -1
- package/dist/commands/web.js +17 -0
- package/dist/commands/workflow.d.ts.map +1 -1
- package/dist/commands/workflow.js +4 -0
- package/dist/core/agents/cli.js +7 -3
- package/dist/core/agents/health.d.ts +17 -0
- package/dist/core/agents/health.d.ts.map +1 -0
- package/dist/core/agents/health.js +109 -0
- package/dist/core/agents/mailbox.d.ts +92 -0
- package/dist/core/agents/mailbox.d.ts.map +1 -0
- package/dist/core/agents/mailbox.js +325 -0
- package/dist/core/agents/qa-signal.d.ts +111 -0
- package/dist/core/agents/qa-signal.d.ts.map +1 -0
- package/dist/core/agents/qa-signal.js +231 -0
- package/dist/core/agents/reconcile-coordination-v3.d.ts +44 -0
- package/dist/core/agents/reconcile-coordination-v3.d.ts.map +1 -0
- package/dist/core/agents/reconcile-coordination-v3.js +58 -0
- package/dist/core/agents/render/prompt-context.d.ts +5 -0
- package/dist/core/agents/render/prompt-context.d.ts.map +1 -1
- package/dist/core/agents/render/prompt-context.js +34 -13
- package/dist/core/agents/render/session-context.d.ts +8 -0
- package/dist/core/agents/render/session-context.d.ts.map +1 -1
- package/dist/core/agents/render/session-context.js +34 -3
- package/dist/core/agents/rules/commit-conflict.d.ts.map +1 -1
- package/dist/core/agents/rules/commit-conflict.js +50 -1
- package/dist/core/agents/rules/stop-hook.d.ts.map +1 -1
- package/dist/core/agents/rules/stop-hook.js +6 -10
- package/dist/core/agents/session-finalizer-v3.js +4 -1
- package/dist/core/agents/session-name-display.d.ts +20 -5
- package/dist/core/agents/session-name-display.d.ts.map +1 -1
- package/dist/core/agents/session-name-display.js +67 -7
- package/dist/core/agents/state/heartbeat-reader.d.ts +7 -0
- package/dist/core/agents/state/heartbeat-reader.d.ts.map +1 -1
- package/dist/core/agents/state/heartbeat-writer.d.ts +11 -0
- package/dist/core/agents/state/heartbeat-writer.d.ts.map +1 -1
- package/dist/core/agents/state/heartbeat-writer.js +17 -0
- package/dist/core/agents/state/live-coordination-view.d.ts.map +1 -1
- package/dist/core/agents/state/live-coordination-view.js +1 -0
- package/dist/core/agents/state/live-coordination-writer.js +5 -0
- package/dist/core/artifacts/constants.d.ts +1 -1
- package/dist/core/artifacts/constants.js +1 -1
- package/dist/core/artifacts/index.d.ts +82 -6
- package/dist/core/artifacts/index.d.ts.map +1 -1
- package/dist/core/artifacts/index.js +410 -15
- package/dist/core/config.d.ts +20 -0
- package/dist/core/config.d.ts.map +1 -1
- package/dist/core/config.js +59 -0
- package/dist/core/diagnostics/advice.d.ts +9 -0
- package/dist/core/diagnostics/advice.d.ts.map +1 -0
- package/dist/core/diagnostics/advice.js +112 -0
- package/dist/core/diagnostics/bundle.d.ts +51 -0
- package/dist/core/diagnostics/bundle.d.ts.map +1 -0
- package/dist/core/diagnostics/bundle.js +968 -0
- package/dist/core/diagnostics/comparison.d.ts +5 -0
- package/dist/core/diagnostics/comparison.d.ts.map +1 -0
- package/dist/core/diagnostics/comparison.js +444 -0
- package/dist/core/diagnostics/contract.d.ts +245 -0
- package/dist/core/diagnostics/contract.d.ts.map +1 -0
- package/dist/core/diagnostics/contract.js +18 -0
- package/dist/core/diagnostics/identity.d.ts +3 -0
- package/dist/core/diagnostics/identity.d.ts.map +1 -0
- package/dist/core/diagnostics/identity.js +10 -0
- package/dist/core/diagnostics/index.d.ts +8 -0
- package/dist/core/diagnostics/index.d.ts.map +1 -0
- package/dist/core/diagnostics/index.js +7 -0
- package/dist/core/diagnostics/replay.d.ts +8 -0
- package/dist/core/diagnostics/replay.d.ts.map +1 -0
- package/dist/core/diagnostics/replay.js +213 -0
- package/dist/core/diagnostics/sanitize.d.ts +9 -0
- package/dist/core/diagnostics/sanitize.d.ts.map +1 -0
- package/dist/core/diagnostics/sanitize.js +84 -0
- package/dist/core/events/legacy-storage/compression.d.ts +13 -0
- package/dist/core/events/legacy-storage/compression.d.ts.map +1 -0
- package/dist/core/events/legacy-storage/compression.js +107 -0
- package/dist/core/events/legacy-storage/index.d.ts +1 -0
- package/dist/core/events/legacy-storage/index.d.ts.map +1 -1
- package/dist/core/events/legacy-storage/index.js +1 -0
- package/dist/core/events/v3/archive-retention.d.ts +33 -0
- package/dist/core/events/v3/archive-retention.d.ts.map +1 -0
- package/dist/core/events/v3/archive-retention.js +195 -0
- package/dist/core/events/v3/bootstrap.d.ts.map +1 -1
- package/dist/core/events/v3/bootstrap.js +10 -0
- package/dist/core/events/v3/capabilities.d.ts +1 -1
- package/dist/core/events/v3/capabilities.d.ts.map +1 -1
- package/dist/core/events/v3/capabilities.js +1 -0
- package/dist/core/events/v3/coordination-view.d.ts +3 -0
- package/dist/core/events/v3/coordination-view.d.ts.map +1 -1
- package/dist/core/events/v3/coordination-view.js +69 -8
- package/dist/core/events/v3/index.d.ts +1 -0
- package/dist/core/events/v3/index.d.ts.map +1 -1
- package/dist/core/events/v3/index.js +1 -0
- package/dist/core/events/v3/live-routing.d.ts.map +1 -1
- package/dist/core/events/v3/live-routing.js +1 -0
- package/dist/core/events/v3/producers/hook-base.d.ts +1 -1
- package/dist/core/events/v3/producers/hook-base.d.ts.map +1 -1
- package/dist/core/events/v3/producers/hook-base.js +13 -2
- package/dist/core/events/v3/producers/intake.d.ts.map +1 -1
- package/dist/core/events/v3/producers/intake.js +10 -2
- package/dist/core/events/v3/producers/recorder.d.ts +39 -0
- package/dist/core/events/v3/producers/recorder.d.ts.map +1 -1
- package/dist/core/events/v3/producers/recorder.js +350 -17
- package/dist/core/hooks/adapter/output.d.ts +8 -0
- package/dist/core/hooks/adapter/output.d.ts.map +1 -1
- package/dist/core/hooks/adapter/output.js +11 -1
- package/dist/core/hooks/cli.js +303 -219
- package/dist/core/hooks/health.d.ts +59 -0
- package/dist/core/hooks/health.d.ts.map +1 -0
- package/dist/core/hooks/health.js +84 -0
- package/dist/core/hooks/resolve/transcript.d.ts.map +1 -1
- package/dist/core/hooks/resolve/transcript.js +10 -3
- package/dist/core/hooks/session-name-presence.d.ts.map +1 -1
- package/dist/core/hooks/session-name-presence.js +4 -1
- package/dist/core/qa-artifacts.d.ts +20 -0
- package/dist/core/qa-artifacts.d.ts.map +1 -0
- package/dist/core/qa-artifacts.js +110 -0
- package/dist/core/resources/contract.d.ts +96 -0
- package/dist/core/resources/contract.d.ts.map +1 -0
- package/dist/core/resources/contract.js +2 -0
- package/dist/core/resources/index.d.ts +6 -0
- package/dist/core/resources/index.d.ts.map +1 -0
- package/dist/core/resources/index.js +5 -0
- package/dist/core/resources/sampler.d.ts +34 -0
- package/dist/core/resources/sampler.d.ts.map +1 -0
- package/dist/core/resources/sampler.js +458 -0
- package/dist/core/resources/service-status.d.ts +3 -0
- package/dist/core/resources/service-status.d.ts.map +1 -0
- package/dist/core/resources/service-status.js +48 -0
- package/dist/core/resources/service.d.ts +26 -0
- package/dist/core/resources/service.d.ts.map +1 -0
- package/dist/core/resources/service.js +292 -0
- package/dist/core/resources/storage.d.ts +13 -0
- package/dist/core/resources/storage.d.ts.map +1 -0
- package/dist/core/resources/storage.js +30 -0
- package/dist/core/storage/atomic-json.d.ts +3 -0
- package/dist/core/storage/atomic-json.d.ts.map +1 -0
- package/dist/core/storage/atomic-json.js +15 -0
- package/dist/core/storage/builtins.d.ts.map +1 -1
- package/dist/core/storage/builtins.js +45 -6
- package/dist/core/storage/logger.d.ts +2 -0
- package/dist/core/storage/logger.d.ts.map +1 -1
- package/dist/core/storage/logger.js +2 -0
- package/dist/core/storage/query.d.ts +14 -0
- package/dist/core/storage/query.d.ts.map +1 -1
- package/dist/core/storage/query.js +51 -0
- package/dist/core/supervisor/activity.d.ts +4 -0
- package/dist/core/supervisor/activity.d.ts.map +1 -0
- package/dist/core/supervisor/activity.js +141 -0
- package/dist/core/supervisor/contract.d.ts +268 -0
- package/dist/core/supervisor/contract.d.ts.map +1 -0
- package/dist/core/supervisor/contract.js +35 -0
- package/dist/core/supervisor/explanations.d.ts +4 -0
- package/dist/core/supervisor/explanations.d.ts.map +1 -0
- package/dist/core/supervisor/explanations.js +71 -0
- package/dist/core/supervisor/findings.d.ts +20 -0
- package/dist/core/supervisor/findings.d.ts.map +1 -0
- package/dist/core/supervisor/findings.js +399 -0
- package/dist/core/supervisor/history.d.ts +9 -0
- package/dist/core/supervisor/history.d.ts.map +1 -0
- package/dist/core/supervisor/history.js +46 -0
- package/dist/core/supervisor/hook-health-alerts.d.ts +14 -0
- package/dist/core/supervisor/hook-health-alerts.d.ts.map +1 -0
- package/dist/core/supervisor/hook-health-alerts.js +70 -0
- package/dist/core/supervisor/hook-health-storage.d.ts +5 -0
- package/dist/core/supervisor/hook-health-storage.d.ts.map +1 -0
- package/dist/core/supervisor/hook-health-storage.js +24 -0
- package/dist/core/supervisor/hook-health.d.ts +72 -0
- package/dist/core/supervisor/hook-health.d.ts.map +1 -0
- package/dist/core/supervisor/hook-health.js +203 -0
- package/dist/core/supervisor/hooks.d.ts +10 -0
- package/dist/core/supervisor/hooks.d.ts.map +1 -0
- package/dist/core/supervisor/hooks.js +28 -0
- package/dist/core/supervisor/index.d.ts +15 -0
- package/dist/core/supervisor/index.d.ts.map +1 -0
- package/dist/core/supervisor/index.js +14 -0
- package/dist/core/supervisor/log-feed.d.ts +9 -0
- package/dist/core/supervisor/log-feed.d.ts.map +1 -0
- package/dist/core/supervisor/log-feed.js +103 -0
- package/dist/core/supervisor/service.d.ts +29 -0
- package/dist/core/supervisor/service.d.ts.map +1 -0
- package/dist/core/supervisor/service.js +450 -0
- package/dist/core/supervisor/services.d.ts +11 -0
- package/dist/core/supervisor/services.d.ts.map +1 -0
- package/dist/core/supervisor/services.js +155 -0
- package/dist/core/supervisor/status.d.ts +3 -0
- package/dist/core/supervisor/status.d.ts.map +1 -0
- package/dist/core/supervisor/status.js +48 -0
- package/dist/core/supervisor/storage.d.ts +30 -0
- package/dist/core/supervisor/storage.d.ts.map +1 -0
- package/dist/core/supervisor/storage.js +73 -0
- package/dist/core/supervisor/timeline.d.ts +3 -0
- package/dist/core/supervisor/timeline.d.ts.map +1 -0
- package/dist/core/supervisor/timeline.js +87 -0
- package/dist/core/workflow/admission.d.ts +23 -0
- package/dist/core/workflow/admission.d.ts.map +1 -0
- package/dist/core/workflow/admission.js +136 -0
- package/dist/core/workflow/engine.d.ts.map +1 -1
- package/dist/core/workflow/engine.js +77 -2
- package/dist/core/workflow/index.d.ts +3 -2
- package/dist/core/workflow/index.d.ts.map +1 -1
- package/dist/core/workflow/index.js +2 -1
- package/dist/core/workflow/proof.d.ts +2 -1
- package/dist/core/workflow/proof.d.ts.map +1 -1
- package/dist/core/workflow/proof.js +39 -1
- package/dist/core/workflow/run-state.d.ts +3 -2
- package/dist/core/workflow/run-state.d.ts.map +1 -1
- package/dist/core/workflow/run-state.js +8 -1
- package/dist/core/workflow/types.d.ts +33 -1
- package/dist/core/workflow/types.d.ts.map +1 -1
- package/dist/core/workflow/types.js +2 -1
- package/dist/lib/admission.d.ts +71 -0
- package/dist/lib/admission.d.ts.map +1 -0
- package/dist/lib/admission.js +264 -0
- package/dist/lib/agent-browser/client.d.ts +1 -1
- package/dist/lib/agent-browser/client.d.ts.map +1 -1
- package/dist/lib/agent-browser/client.js +1 -5
- package/dist/lib/browser/capture-fidelity.d.ts +39 -0
- package/dist/lib/browser/capture-fidelity.d.ts.map +1 -0
- package/dist/lib/browser/capture-fidelity.js +84 -0
- package/dist/lib/browser/client.d.ts +46 -1
- package/dist/lib/browser/client.d.ts.map +1 -1
- package/dist/lib/browser/client.js +168 -9
- package/dist/lib/browser/critique.d.ts +38 -1
- package/dist/lib/browser/critique.d.ts.map +1 -1
- package/dist/lib/browser/critique.js +34 -6
- package/dist/lib/browser/index.d.ts +5 -1
- package/dist/lib/browser/index.d.ts.map +1 -1
- package/dist/lib/browser/index.js +4 -0
- package/dist/lib/browser/page-review-judge.d.ts +64 -0
- package/dist/lib/browser/page-review-judge.d.ts.map +1 -0
- package/dist/lib/browser/page-review-judge.js +270 -0
- package/dist/lib/browser/page-review-pack.d.ts +613 -0
- package/dist/lib/browser/page-review-pack.d.ts.map +1 -0
- package/dist/lib/browser/page-review-pack.js +1751 -0
- package/dist/lib/browser/qa-run-contracts.d.ts +377 -0
- package/dist/lib/browser/qa-run-contracts.d.ts.map +1 -0
- package/dist/lib/browser/qa-run-contracts.js +361 -0
- package/dist/lib/browser/qa-run.d.ts +141 -0
- package/dist/lib/browser/qa-run.d.ts.map +1 -0
- package/dist/lib/browser/qa-run.js +1283 -0
- package/dist/lib/browser/request-diagnostics.d.ts +13 -0
- package/dist/lib/browser/request-diagnostics.d.ts.map +1 -0
- package/dist/lib/browser/request-diagnostics.js +18 -0
- package/dist/lib/browser/tiling.d.ts +19 -0
- package/dist/lib/browser/tiling.d.ts.map +1 -1
- package/dist/lib/browser/tiling.js +28 -0
- package/dist/lib/cookies/client.d.ts +9 -0
- package/dist/lib/cookies/client.d.ts.map +1 -1
- package/dist/lib/cookies/client.js +197 -44
- package/dist/lib/cookies/extra.d.ts +18 -0
- package/dist/lib/cookies/extra.d.ts.map +1 -0
- package/dist/lib/cookies/extra.js +14 -0
- package/dist/lib/cookies/index.d.ts +2 -1
- package/dist/lib/cookies/index.d.ts.map +1 -1
- package/dist/lib/cookies/index.js +2 -1
- package/dist/lib/coord-root-id.d.ts +9 -0
- package/dist/lib/coord-root-id.d.ts.map +1 -0
- package/dist/lib/coord-root-id.js +17 -0
- package/dist/lib/durable-job.d.ts +124 -0
- package/dist/lib/durable-job.d.ts.map +1 -0
- package/dist/lib/durable-job.js +296 -0
- package/dist/lib/http/client.d.ts +7 -1
- package/dist/lib/http/client.d.ts.map +1 -1
- package/dist/lib/http/client.js +2 -0
- package/dist/lib/instructions/apply.d.ts +3 -1
- package/dist/lib/instructions/apply.d.ts.map +1 -1
- package/dist/lib/instructions/apply.js +74 -3
- package/dist/lib/instructions/templates.d.ts.map +1 -1
- package/dist/lib/instructions/templates.js +11 -2
- package/package.json +19 -2
- package/src/commander.ts +75 -1
- package/src/commands/admission.ts +699 -0
- package/src/commands/agents.ts +189 -50
- package/src/commands/artifacts.ts +132 -18
- package/src/commands/browse-ai.ts +10 -5
- package/src/commands/browse.ts +496 -20
- package/src/commands/diagnostics.ts +271 -0
- package/src/commands/fetch.ts +1 -0
- package/src/commands/files.ts +102 -2
- package/src/commands/governor.ts +8 -0
- package/src/commands/ledger-v3.ts +82 -0
- package/src/commands/qa-record.ts +682 -0
- package/src/commands/qa-run.ts +503 -0
- package/src/commands/qa-status.ts +608 -0
- package/src/commands/qa-verify.ts +238 -0
- package/src/commands/resources.ts +38 -0
- package/src/commands/review-pack.ts +1281 -0
- package/src/commands/supervisor.ts +141 -0
- package/src/commands/web.ts +19 -0
- package/src/commands/workflow.ts +8 -0
- package/src/core/agents/cli.ts +7 -3
- package/src/core/agents/health.ts +142 -0
- package/src/core/agents/mailbox.ts +373 -0
- package/src/core/agents/qa-signal.ts +261 -0
- package/src/core/agents/reconcile-coordination-v3.ts +77 -0
- package/src/core/agents/render/prompt-context.ts +42 -12
- package/src/core/agents/render/session-context.ts +37 -3
- package/src/core/agents/rules/commit-conflict.ts +58 -1
- package/src/core/agents/rules/stop-hook.ts +6 -12
- package/src/core/agents/session-finalizer-v3.ts +4 -1
- package/src/core/agents/session-name-display.ts +78 -7
- package/src/core/agents/state/heartbeat-reader.ts +7 -0
- package/src/core/agents/state/heartbeat-writer.ts +23 -0
- package/src/core/agents/state/live-coordination-view.ts +1 -0
- package/src/core/agents/state/live-coordination-writer.ts +5 -0
- package/src/core/artifacts/constants.ts +1 -1
- package/src/core/artifacts/index.ts +565 -30
- package/src/core/config.ts +134 -2
- package/src/core/diagnostics/advice.ts +147 -0
- package/src/core/diagnostics/bundle.ts +1250 -0
- package/src/core/diagnostics/comparison.ts +565 -0
- package/src/core/diagnostics/contract.ts +311 -0
- package/src/core/diagnostics/identity.ts +11 -0
- package/src/core/diagnostics/index.ts +7 -0
- package/src/core/diagnostics/replay.ts +314 -0
- package/src/core/diagnostics/sanitize.ts +97 -0
- package/src/core/events/legacy-storage/compression.ts +130 -0
- package/src/core/events/legacy-storage/index.ts +1 -0
- package/src/core/events/v3/archive-retention.ts +251 -0
- package/src/core/events/v3/bootstrap.ts +10 -0
- package/src/core/events/v3/capabilities.ts +2 -0
- package/src/core/events/v3/coordination-view.ts +100 -11
- package/src/core/events/v3/index.ts +9 -0
- package/src/core/events/v3/live-routing.ts +1 -0
- package/src/core/events/v3/producers/hook-base.ts +14 -2
- package/src/core/events/v3/producers/intake.ts +10 -2
- package/src/core/events/v3/producers/recorder.ts +420 -17
- package/src/core/hooks/adapter/output.ts +12 -1
- package/src/core/hooks/cli.ts +332 -247
- package/src/core/hooks/health.ts +146 -0
- package/src/core/hooks/resolve/transcript.ts +10 -3
- package/src/core/hooks/session-name-presence.ts +6 -1
- package/src/core/qa-artifacts.ts +126 -0
- package/src/core/resources/contract.ts +105 -0
- package/src/core/resources/index.ts +5 -0
- package/src/core/resources/sampler.ts +590 -0
- package/src/core/resources/service-status.ts +62 -0
- package/src/core/resources/service.ts +337 -0
- package/src/core/resources/storage.ts +44 -0
- package/src/core/storage/atomic-json.ts +15 -0
- package/src/core/storage/builtins.ts +62 -6
- package/src/core/storage/logger.ts +2 -0
- package/src/core/storage/query.ts +58 -0
- package/src/core/supervisor/activity.ts +193 -0
- package/src/core/supervisor/contract.ts +312 -0
- package/src/core/supervisor/explanations.ts +104 -0
- package/src/core/supervisor/findings.ts +788 -0
- package/src/core/supervisor/history.ts +61 -0
- package/src/core/supervisor/hook-health-alerts.ts +108 -0
- package/src/core/supervisor/hook-health-storage.ts +25 -0
- package/src/core/supervisor/hook-health.ts +301 -0
- package/src/core/supervisor/hooks.ts +35 -0
- package/src/core/supervisor/index.ts +14 -0
- package/src/core/supervisor/log-feed.ts +131 -0
- package/src/core/supervisor/service.ts +511 -0
- package/src/core/supervisor/services.ts +203 -0
- package/src/core/supervisor/status.ts +59 -0
- package/src/core/supervisor/storage.ts +126 -0
- package/src/core/supervisor/timeline.ts +133 -0
- package/src/core/workflow/admission.ts +215 -0
- package/src/core/workflow/engine.ts +93 -1
- package/src/core/workflow/index.ts +10 -0
- package/src/core/workflow/proof.ts +54 -1
- package/src/core/workflow/run-state.ts +13 -1
- package/src/core/workflow/types.ts +39 -1
- package/src/lib/admission.ts +347 -0
- package/src/lib/agent-browser/client.ts +2 -10
- package/src/lib/browser/capture-fidelity.ts +98 -0
- package/src/lib/browser/client.ts +212 -10
- package/src/lib/browser/critique.ts +62 -7
- package/src/lib/browser/index.ts +65 -0
- package/src/lib/browser/page-review-judge.ts +360 -0
- package/src/lib/browser/page-review-pack.ts +2384 -0
- package/src/lib/browser/qa-run-contracts.ts +743 -0
- package/src/lib/browser/qa-run.ts +1462 -0
- package/src/lib/browser/request-diagnostics.ts +27 -0
- package/src/lib/browser/tiling.ts +32 -0
- package/src/lib/cookies/client.ts +228 -42
- package/src/lib/cookies/extra.ts +28 -0
- package/src/lib/cookies/index.ts +2 -0
- package/src/lib/coord-root-id.ts +23 -0
- package/src/lib/durable-job.ts +407 -0
- package/src/lib/http/client.ts +13 -1
- package/src/lib/instructions/apply.ts +81 -2
- package/src/lib/instructions/templates.ts +11 -2
|
@@ -0,0 +1,458 @@
|
|
|
1
|
+
import { spawnSync } from "node:child_process";
|
|
2
|
+
import { existsSync, readdirSync, readFileSync, readlinkSync } from "node:fs";
|
|
3
|
+
import { cpus, loadavg, platform, release } from "node:os";
|
|
4
|
+
import { basename, join } from "node:path";
|
|
5
|
+
import { performance } from "node:perf_hooks";
|
|
6
|
+
import { readLiveCoordinationRows } from "../agents/state/live-coordination-view.js";
|
|
7
|
+
import { parsePidmapRow } from "../agents/state/pidmap.js";
|
|
8
|
+
import { checkPidToken } from "../agents/state/proc-start.js";
|
|
9
|
+
import { RESOURCE_SNAPSHOT_SCHEMA_VERSION, } from "./contract.js";
|
|
10
|
+
const DEFAULT_CLOCK_TICKS = 100;
|
|
11
|
+
const DEFAULT_PAGE_SIZE = 4_096;
|
|
12
|
+
const DEFAULT_UNATTRIBUTED_CPU_FLOOR = 0.5;
|
|
13
|
+
const DEFAULT_UNATTRIBUTED_RSS_FLOOR = 64 * 1_024 * 1_024;
|
|
14
|
+
const DEFAULT_MAX_PROCESSES = 500;
|
|
15
|
+
const MAX_COMMAND_CHARS = 240;
|
|
16
|
+
let cachedClockTicks;
|
|
17
|
+
let cachedPageSize;
|
|
18
|
+
export function sampleResources(coordRoot, previous, options = {}) {
|
|
19
|
+
const started = performance.now();
|
|
20
|
+
const cpuBefore = process.cpuUsage();
|
|
21
|
+
const nowMs = options.nowMs ?? Date.now();
|
|
22
|
+
const currentPlatform = platform();
|
|
23
|
+
if (currentPlatform !== "linux") {
|
|
24
|
+
return {
|
|
25
|
+
snapshot: unsupportedSnapshot(currentPlatform, nowMs, started, cpuBefore),
|
|
26
|
+
};
|
|
27
|
+
}
|
|
28
|
+
const procRoot = options.procRoot ?? "/proc";
|
|
29
|
+
if (!existsSync(join(procRoot, "stat"))) {
|
|
30
|
+
return {
|
|
31
|
+
snapshot: unsupportedSnapshot(currentPlatform, nowMs, started, cpuBefore, "procfs_unavailable"),
|
|
32
|
+
};
|
|
33
|
+
}
|
|
34
|
+
const clockTicks = options.clockTicks ?? systemClockTicks();
|
|
35
|
+
const pageSize = options.pageSize ?? systemPageSize();
|
|
36
|
+
const uptimeSeconds = parseUptime(readFileSync(join(procRoot, "uptime"), "utf8"));
|
|
37
|
+
const cpu = parseLinuxCpu(readFileSync(join(procRoot, "stat"), "utf8"));
|
|
38
|
+
const memory = parseMeminfo(readFileSync(join(procRoot, "meminfo"), "utf8"));
|
|
39
|
+
const readings = readLinuxProcesses(procRoot, clockTicks, pageSize, uptimeSeconds);
|
|
40
|
+
const liveSessionOwners = uniqueLiveCodexSessionOwners(options.sessionOwners ??
|
|
41
|
+
readLiveCoordinationRows(coordRoot).map((row) => ({
|
|
42
|
+
nativeSessionId: row.native_session_id ?? "",
|
|
43
|
+
instanceId: row.instance_id,
|
|
44
|
+
platform: row.platform ?? "",
|
|
45
|
+
kind: row.kind ?? "",
|
|
46
|
+
})));
|
|
47
|
+
const ownership = readOwnershipAnchors(coordRoot, procRoot, readings, options.services ?? [], liveSessionOwners, previous?.process_owners);
|
|
48
|
+
const anchors = ownership.anchors;
|
|
49
|
+
const byPid = new Map(readings.map((reading) => [reading.pid, reading]));
|
|
50
|
+
const processTicks = new Map();
|
|
51
|
+
const intervalMs = previous ? Math.max(0, nowMs - previous.sampled_at_ms) : null;
|
|
52
|
+
const totalTickDelta = previous ? Math.max(0, cpu.total - previous.cpu_total_ticks) : 0;
|
|
53
|
+
const logicalCpus = Math.max(1, cpus().length);
|
|
54
|
+
const processes = readings.map((reading) => {
|
|
55
|
+
const identity = `${reading.pid}:${reading.startTicks}`;
|
|
56
|
+
processTicks.set(identity, reading.ticks);
|
|
57
|
+
const priorTicks = previous?.process_ticks.get(identity);
|
|
58
|
+
const processDelta = priorTicks === undefined ? undefined : Math.max(0, reading.ticks - priorTicks);
|
|
59
|
+
const cpuPercent = processDelta === undefined || totalTickDelta <= 0
|
|
60
|
+
? null
|
|
61
|
+
: round1((processDelta / totalTickDelta) * logicalCpus * 100);
|
|
62
|
+
const ownership = resolveOwnership(reading.pid, byPid, anchors);
|
|
63
|
+
return {
|
|
64
|
+
pid: reading.pid,
|
|
65
|
+
ppid: reading.ppid,
|
|
66
|
+
start_id: identity,
|
|
67
|
+
state: reading.state,
|
|
68
|
+
name: reading.name,
|
|
69
|
+
command: reading.command,
|
|
70
|
+
cpu_percent: cpuPercent,
|
|
71
|
+
rss_bytes: reading.rssBytes,
|
|
72
|
+
age_seconds: round1(reading.ageSeconds),
|
|
73
|
+
owner_kind: ownership?.kind ?? "unattributed",
|
|
74
|
+
owner_id: ownership?.id ?? null,
|
|
75
|
+
owner_root_pid: ownership?.rootPid ?? null,
|
|
76
|
+
...(ownership ? { owner_source: ownership.source } : {}),
|
|
77
|
+
};
|
|
78
|
+
});
|
|
79
|
+
const visible = processes
|
|
80
|
+
.filter((row) => row.owner_kind !== "unattributed" ||
|
|
81
|
+
(row.cpu_percent ?? 0) >=
|
|
82
|
+
(options.unattributedCpuFloor ?? DEFAULT_UNATTRIBUTED_CPU_FLOOR) ||
|
|
83
|
+
row.rss_bytes >= (options.unattributedRssFloor ?? DEFAULT_UNATTRIBUTED_RSS_FLOOR))
|
|
84
|
+
.sort(processSort)
|
|
85
|
+
.slice(0, options.maxProcesses ?? DEFAULT_MAX_PROCESSES);
|
|
86
|
+
const groups = aggregateGroups(visible);
|
|
87
|
+
const cpuPercent = previous && totalTickDelta > 0
|
|
88
|
+
? round1(((totalTickDelta - Math.max(0, cpu.idle - previous.cpu_idle_ticks)) / totalTickDelta) *
|
|
89
|
+
100)
|
|
90
|
+
: null;
|
|
91
|
+
const memoryTotal = memory.MemTotal ?? null;
|
|
92
|
+
const memoryAvailable = memory.MemAvailable ?? memory.MemFree ?? null;
|
|
93
|
+
const memoryUsed = memoryTotal !== null && memoryAvailable !== null
|
|
94
|
+
? Math.max(0, memoryTotal - memoryAvailable)
|
|
95
|
+
: null;
|
|
96
|
+
const swapTotal = memory.SwapTotal ?? null;
|
|
97
|
+
const swapFree = memory.SwapFree ?? null;
|
|
98
|
+
const swapUsed = swapTotal !== null && swapFree !== null ? Math.max(0, swapTotal - swapFree) : null;
|
|
99
|
+
const collectorCpu = process.cpuUsage(cpuBefore);
|
|
100
|
+
const snapshot = {
|
|
101
|
+
schema_version: RESOURCE_SNAPSHOT_SCHEMA_VERSION,
|
|
102
|
+
sampled_at: new Date(nowMs).toISOString(),
|
|
103
|
+
interval_ms: intervalMs,
|
|
104
|
+
sample_duration_ms: round1(performance.now() - started),
|
|
105
|
+
collector_cpu_ms: round1((collectorCpu.user + collectorCpu.system) / 1_000),
|
|
106
|
+
platform: currentPlatform,
|
|
107
|
+
namespace: /microsoft|wsl/i.test(release()) ? "wsl" : "host",
|
|
108
|
+
support: { state: "supported", sampler: "procfs" },
|
|
109
|
+
machine: {
|
|
110
|
+
cpu_percent: cpuPercent,
|
|
111
|
+
cpu_logical_count: logicalCpus,
|
|
112
|
+
load_average: loadavg(),
|
|
113
|
+
memory_total_bytes: memoryTotal,
|
|
114
|
+
memory_available_bytes: memoryAvailable,
|
|
115
|
+
memory_used_bytes: memoryUsed,
|
|
116
|
+
memory_percent: memoryUsed !== null && memoryTotal ? round1((memoryUsed / memoryTotal) * 100) : null,
|
|
117
|
+
swap_total_bytes: swapTotal,
|
|
118
|
+
swap_used_bytes: swapUsed,
|
|
119
|
+
process_count: readings.length,
|
|
120
|
+
},
|
|
121
|
+
groups,
|
|
122
|
+
processes: visible,
|
|
123
|
+
visible_process_count: visible.length,
|
|
124
|
+
omitted_process_count: Math.max(0, readings.length - visible.length),
|
|
125
|
+
unattributed_process_count: visible.filter((row) => row.owner_kind === "unattributed").length,
|
|
126
|
+
};
|
|
127
|
+
return {
|
|
128
|
+
snapshot,
|
|
129
|
+
state: {
|
|
130
|
+
sampled_at_ms: nowMs,
|
|
131
|
+
cpu_total_ticks: cpu.total,
|
|
132
|
+
cpu_idle_ticks: cpu.idle,
|
|
133
|
+
process_ticks: processTicks,
|
|
134
|
+
process_owners: ownership.processOwners,
|
|
135
|
+
},
|
|
136
|
+
};
|
|
137
|
+
}
|
|
138
|
+
export function parseLinuxProcessStat(line) {
|
|
139
|
+
const open = line.indexOf("(");
|
|
140
|
+
const close = line.lastIndexOf(")");
|
|
141
|
+
if (open <= 0 || close <= open)
|
|
142
|
+
return null;
|
|
143
|
+
const pid = Number(line.slice(0, open).trim());
|
|
144
|
+
const fields = line
|
|
145
|
+
.slice(close + 1)
|
|
146
|
+
.trim()
|
|
147
|
+
.split(/\s+/);
|
|
148
|
+
const state = fields[0] ?? "?";
|
|
149
|
+
const ppid = Number(fields[1]);
|
|
150
|
+
const userTicks = Number(fields[11]);
|
|
151
|
+
const systemTicks = Number(fields[12]);
|
|
152
|
+
const startTicks = Number(fields[19]);
|
|
153
|
+
const rssPages = Number(fields[21]);
|
|
154
|
+
if (![pid, ppid, userTicks, systemTicks, startTicks, rssPages].every(Number.isFinite))
|
|
155
|
+
return null;
|
|
156
|
+
return {
|
|
157
|
+
pid,
|
|
158
|
+
name: line.slice(open + 1, close),
|
|
159
|
+
state,
|
|
160
|
+
ppid,
|
|
161
|
+
ticks: userTicks + systemTicks,
|
|
162
|
+
startTicks,
|
|
163
|
+
rssPages: Math.max(0, rssPages),
|
|
164
|
+
};
|
|
165
|
+
}
|
|
166
|
+
export function redactCommand(args) {
|
|
167
|
+
const secretName = /(?:^|[-_])(token|secret|password|passwd|api[-_]?key|authorization)(?:$|[-_])/i;
|
|
168
|
+
const output = [];
|
|
169
|
+
let redactNext = false;
|
|
170
|
+
for (const raw of args) {
|
|
171
|
+
let value = raw;
|
|
172
|
+
if (redactNext) {
|
|
173
|
+
output.push("<redacted>");
|
|
174
|
+
redactNext = false;
|
|
175
|
+
continue;
|
|
176
|
+
}
|
|
177
|
+
const equals = value.indexOf("=");
|
|
178
|
+
if (equals > 0 && secretName.test(value.slice(0, equals))) {
|
|
179
|
+
value = `${value.slice(0, equals + 1)}<redacted>`;
|
|
180
|
+
}
|
|
181
|
+
else if (secretName.test(value.replace(/^--?/, ""))) {
|
|
182
|
+
redactNext = true;
|
|
183
|
+
}
|
|
184
|
+
value = value.replace(/(https?:\/\/)[^:@\s/]+:[^@\s/]+@/gi, "$1<redacted>@");
|
|
185
|
+
output.push(value.replace(/[\r\n\t]+/g, " "));
|
|
186
|
+
}
|
|
187
|
+
const joined = output.join(" ").trim();
|
|
188
|
+
return joined.length <= MAX_COMMAND_CHARS ? joined : `${joined.slice(0, MAX_COMMAND_CHARS - 1)}…`;
|
|
189
|
+
}
|
|
190
|
+
function readLinuxProcesses(procRoot, clockTicks, pageSize, uptimeSeconds) {
|
|
191
|
+
const rows = [];
|
|
192
|
+
for (const entry of readdirSync(procRoot, { withFileTypes: true })) {
|
|
193
|
+
if (!entry.isDirectory() || !/^\d+$/.test(entry.name))
|
|
194
|
+
continue;
|
|
195
|
+
const pidRoot = join(procRoot, entry.name);
|
|
196
|
+
try {
|
|
197
|
+
const parsed = parseLinuxProcessStat(readFileSync(join(pidRoot, "stat"), "utf8"));
|
|
198
|
+
if (!parsed)
|
|
199
|
+
continue;
|
|
200
|
+
const args = readFileSync(join(pidRoot, "cmdline"), "utf8").split("\0").filter(Boolean);
|
|
201
|
+
let name = parsed.name;
|
|
202
|
+
try {
|
|
203
|
+
name = basename(readlinkSync(join(pidRoot, "exe"))) || name;
|
|
204
|
+
}
|
|
205
|
+
catch {
|
|
206
|
+
// Kernel threads and racing processes may have no readable executable.
|
|
207
|
+
}
|
|
208
|
+
rows.push({
|
|
209
|
+
pid: parsed.pid,
|
|
210
|
+
ppid: parsed.ppid,
|
|
211
|
+
state: parsed.state,
|
|
212
|
+
name,
|
|
213
|
+
command: redactCommand(args.length > 0 ? args : [parsed.name]),
|
|
214
|
+
ticks: parsed.ticks,
|
|
215
|
+
startTicks: parsed.startTicks,
|
|
216
|
+
rssBytes: parsed.rssPages * pageSize,
|
|
217
|
+
ageSeconds: Math.max(0, uptimeSeconds - parsed.startTicks / clockTicks),
|
|
218
|
+
});
|
|
219
|
+
}
|
|
220
|
+
catch {
|
|
221
|
+
// Process exits and permission boundaries are normal during a table scan.
|
|
222
|
+
}
|
|
223
|
+
}
|
|
224
|
+
return rows;
|
|
225
|
+
}
|
|
226
|
+
function readOwnershipAnchors(coordRoot, procRoot, readings, services, liveSessionOwners, previousOwners) {
|
|
227
|
+
const byPid = new Set(readings.map((row) => row.pid));
|
|
228
|
+
const directory = join(coordRoot, ".harnery", "pid-map");
|
|
229
|
+
const anchors = new Map();
|
|
230
|
+
if (existsSync(directory)) {
|
|
231
|
+
for (const entry of readdirSync(directory)) {
|
|
232
|
+
if (!/^\d+$/.test(entry))
|
|
233
|
+
continue;
|
|
234
|
+
const pid = Number(entry);
|
|
235
|
+
if (!byPid.has(pid))
|
|
236
|
+
continue;
|
|
237
|
+
try {
|
|
238
|
+
const row = parsePidmapRow(readFileSync(join(directory, entry), "utf8"));
|
|
239
|
+
if (!row.instanceId || checkPidToken(pid, row.startToken) === "mismatch")
|
|
240
|
+
continue;
|
|
241
|
+
anchors.set(pid, { kind: "agent", id: row.instanceId, source: "pid-map" });
|
|
242
|
+
}
|
|
243
|
+
catch {
|
|
244
|
+
// An unreadable or racing row cannot prove ownership.
|
|
245
|
+
}
|
|
246
|
+
}
|
|
247
|
+
}
|
|
248
|
+
const processOwners = readBridgeProcessOwners(procRoot, readings, liveSessionOwners, previousOwners);
|
|
249
|
+
const byReadingPid = new Map(readings.map((row) => [row.pid, row]));
|
|
250
|
+
for (const reading of readings) {
|
|
251
|
+
const identity = `${reading.pid}:${reading.startTicks}`;
|
|
252
|
+
const owner = processOwners.get(identity);
|
|
253
|
+
if (!owner || anchors.has(reading.pid))
|
|
254
|
+
continue;
|
|
255
|
+
const parent = byReadingPid.get(reading.ppid);
|
|
256
|
+
const parentOwner = parent
|
|
257
|
+
? processOwners.get(`${parent.pid}:${parent.startTicks}`)
|
|
258
|
+
: undefined;
|
|
259
|
+
if (parentOwner?.instance_id === owner.instance_id)
|
|
260
|
+
continue;
|
|
261
|
+
anchors.set(reading.pid, {
|
|
262
|
+
kind: "agent",
|
|
263
|
+
id: owner.instance_id,
|
|
264
|
+
source: "session-environment",
|
|
265
|
+
});
|
|
266
|
+
}
|
|
267
|
+
for (const service of services) {
|
|
268
|
+
if (byPid.has(service.pid) && service.id.trim()) {
|
|
269
|
+
anchors.set(service.pid, { kind: "service", id: service.id.trim(), source: "service" });
|
|
270
|
+
}
|
|
271
|
+
}
|
|
272
|
+
return { anchors, processOwners };
|
|
273
|
+
}
|
|
274
|
+
function uniqueLiveCodexSessionOwners(rows) {
|
|
275
|
+
const candidates = new Map();
|
|
276
|
+
for (const row of rows) {
|
|
277
|
+
const sessionId = row.nativeSessionId.trim();
|
|
278
|
+
const instanceId = row.instanceId.trim();
|
|
279
|
+
if (row.platform !== "codex" || row.kind !== "session" || !sessionId || !instanceId)
|
|
280
|
+
continue;
|
|
281
|
+
const owners = candidates.get(sessionId) ?? new Set();
|
|
282
|
+
owners.add(instanceId);
|
|
283
|
+
candidates.set(sessionId, owners);
|
|
284
|
+
}
|
|
285
|
+
const result = new Map();
|
|
286
|
+
for (const [sessionId, owners] of candidates) {
|
|
287
|
+
if (owners.size === 1)
|
|
288
|
+
result.set(sessionId, [...owners][0]);
|
|
289
|
+
}
|
|
290
|
+
return result;
|
|
291
|
+
}
|
|
292
|
+
function readBridgeProcessOwners(procRoot, readings, liveSessionOwners, previousOwners) {
|
|
293
|
+
const result = new Map();
|
|
294
|
+
if (liveSessionOwners.size === 0)
|
|
295
|
+
return result;
|
|
296
|
+
for (const reading of readings) {
|
|
297
|
+
const identity = `${reading.pid}:${reading.startTicks}`;
|
|
298
|
+
const previous = previousOwners?.get(identity);
|
|
299
|
+
if (previous && liveSessionOwners.get(previous.session_id) === previous.instance_id) {
|
|
300
|
+
result.set(identity, previous);
|
|
301
|
+
continue;
|
|
302
|
+
}
|
|
303
|
+
const sessionId = readCodexWslBridgeSessionId(procRoot, reading.pid);
|
|
304
|
+
if (!sessionId)
|
|
305
|
+
continue;
|
|
306
|
+
const instanceId = liveSessionOwners.get(sessionId);
|
|
307
|
+
if (instanceId)
|
|
308
|
+
result.set(identity, { session_id: sessionId, instance_id: instanceId });
|
|
309
|
+
}
|
|
310
|
+
return result;
|
|
311
|
+
}
|
|
312
|
+
function readCodexWslBridgeSessionId(procRoot, pid) {
|
|
313
|
+
try {
|
|
314
|
+
const entries = readFileSync(join(procRoot, String(pid), "environ"), "utf8").split("\0");
|
|
315
|
+
let bridge;
|
|
316
|
+
let platform;
|
|
317
|
+
let coordinationSessionId;
|
|
318
|
+
let codexThreadId;
|
|
319
|
+
for (const entry of entries) {
|
|
320
|
+
if (entry.startsWith("HARNERY_AGENT_COORD_BRIDGE=")) {
|
|
321
|
+
bridge = entry.slice("HARNERY_AGENT_COORD_BRIDGE=".length);
|
|
322
|
+
}
|
|
323
|
+
else if (entry.startsWith("HARNERY_AGENT_COORD_PLATFORM=")) {
|
|
324
|
+
platform = entry.slice("HARNERY_AGENT_COORD_PLATFORM=".length);
|
|
325
|
+
}
|
|
326
|
+
else if (entry.startsWith("HARNERY_AGENT_COORD_SESSION_ID=")) {
|
|
327
|
+
coordinationSessionId = entry.slice("HARNERY_AGENT_COORD_SESSION_ID=".length);
|
|
328
|
+
}
|
|
329
|
+
else if (entry.startsWith("CODEX_THREAD_ID=")) {
|
|
330
|
+
codexThreadId = entry.slice("CODEX_THREAD_ID=".length);
|
|
331
|
+
}
|
|
332
|
+
}
|
|
333
|
+
if (bridge === "codex-wsl" &&
|
|
334
|
+
platform === "codex" &&
|
|
335
|
+
coordinationSessionId &&
|
|
336
|
+
coordinationSessionId === codexThreadId) {
|
|
337
|
+
return coordinationSessionId;
|
|
338
|
+
}
|
|
339
|
+
}
|
|
340
|
+
catch {
|
|
341
|
+
// An unreadable or racing environment cannot prove ownership.
|
|
342
|
+
}
|
|
343
|
+
return undefined;
|
|
344
|
+
}
|
|
345
|
+
function resolveOwnership(pid, byPid, anchors) {
|
|
346
|
+
const seen = new Set();
|
|
347
|
+
let cursor = pid;
|
|
348
|
+
for (let hops = 0; hops < 64 && cursor > 0 && !seen.has(cursor); hops++) {
|
|
349
|
+
seen.add(cursor);
|
|
350
|
+
const owner = anchors.get(cursor);
|
|
351
|
+
if (owner)
|
|
352
|
+
return { ...owner, rootPid: cursor };
|
|
353
|
+
cursor = byPid.get(cursor)?.ppid ?? 0;
|
|
354
|
+
}
|
|
355
|
+
return undefined;
|
|
356
|
+
}
|
|
357
|
+
function aggregateGroups(processes) {
|
|
358
|
+
const groups = new Map();
|
|
359
|
+
for (const row of processes) {
|
|
360
|
+
const id = row.owner_id ?? "unattributed";
|
|
361
|
+
const key = `${row.owner_kind}:${id}`;
|
|
362
|
+
const group = groups.get(key) ?? {
|
|
363
|
+
kind: row.owner_kind,
|
|
364
|
+
id,
|
|
365
|
+
process_count: 0,
|
|
366
|
+
cpu_percent: null,
|
|
367
|
+
rss_bytes: 0,
|
|
368
|
+
root_pids: [],
|
|
369
|
+
};
|
|
370
|
+
group.process_count += 1;
|
|
371
|
+
group.rss_bytes += row.rss_bytes;
|
|
372
|
+
if (row.cpu_percent !== null)
|
|
373
|
+
group.cpu_percent = round1((group.cpu_percent ?? 0) + row.cpu_percent);
|
|
374
|
+
if (row.owner_root_pid !== null && !group.root_pids.includes(row.owner_root_pid)) {
|
|
375
|
+
group.root_pids.push(row.owner_root_pid);
|
|
376
|
+
}
|
|
377
|
+
groups.set(key, group);
|
|
378
|
+
}
|
|
379
|
+
return [...groups.values()].sort((left, right) => (right.cpu_percent ?? -1) - (left.cpu_percent ?? -1) ||
|
|
380
|
+
right.rss_bytes - left.rss_bytes ||
|
|
381
|
+
left.id.localeCompare(right.id));
|
|
382
|
+
}
|
|
383
|
+
function processSort(left, right) {
|
|
384
|
+
return ((right.cpu_percent ?? -1) - (left.cpu_percent ?? -1) ||
|
|
385
|
+
right.rss_bytes - left.rss_bytes ||
|
|
386
|
+
left.pid - right.pid);
|
|
387
|
+
}
|
|
388
|
+
function parseLinuxCpu(content) {
|
|
389
|
+
const fields = content.split("\n")[0]?.trim().split(/\s+/).slice(1).map(Number) ?? [];
|
|
390
|
+
if (fields.length < 4 || fields.some((value) => !Number.isFinite(value))) {
|
|
391
|
+
throw new Error("procfs_cpu_invalid");
|
|
392
|
+
}
|
|
393
|
+
return {
|
|
394
|
+
total: fields.reduce((sum, value) => sum + value, 0),
|
|
395
|
+
idle: (fields[3] ?? 0) + (fields[4] ?? 0),
|
|
396
|
+
};
|
|
397
|
+
}
|
|
398
|
+
function parseMeminfo(content) {
|
|
399
|
+
const result = {};
|
|
400
|
+
for (const line of content.split("\n")) {
|
|
401
|
+
const match = /^([A-Za-z_()]+):\s+(\d+)\s+kB$/.exec(line.trim());
|
|
402
|
+
if (match)
|
|
403
|
+
result[match[1]] = Number(match[2]) * 1_024;
|
|
404
|
+
}
|
|
405
|
+
return result;
|
|
406
|
+
}
|
|
407
|
+
function parseUptime(content) {
|
|
408
|
+
const value = Number(content.trim().split(/\s+/, 1)[0]);
|
|
409
|
+
if (!Number.isFinite(value) || value < 0)
|
|
410
|
+
throw new Error("procfs_uptime_invalid");
|
|
411
|
+
return value;
|
|
412
|
+
}
|
|
413
|
+
function systemClockTicks() {
|
|
414
|
+
cachedClockTicks ??= positiveGetconf("CLK_TCK", DEFAULT_CLOCK_TICKS);
|
|
415
|
+
return cachedClockTicks;
|
|
416
|
+
}
|
|
417
|
+
function systemPageSize() {
|
|
418
|
+
cachedPageSize ??= positiveGetconf("PAGESIZE", DEFAULT_PAGE_SIZE);
|
|
419
|
+
return cachedPageSize;
|
|
420
|
+
}
|
|
421
|
+
function positiveGetconf(key, fallback) {
|
|
422
|
+
const result = spawnSync("getconf", [key], { encoding: "utf8", timeout: 1_000 });
|
|
423
|
+
const value = result.status === 0 ? Number(result.stdout.trim()) : Number.NaN;
|
|
424
|
+
return Number.isFinite(value) && value > 0 ? value : fallback;
|
|
425
|
+
}
|
|
426
|
+
function unsupportedSnapshot(currentPlatform, nowMs, started, cpuBefore, reason = "platform_unsupported") {
|
|
427
|
+
const collectorCpu = process.cpuUsage(cpuBefore);
|
|
428
|
+
return {
|
|
429
|
+
schema_version: RESOURCE_SNAPSHOT_SCHEMA_VERSION,
|
|
430
|
+
sampled_at: new Date(nowMs).toISOString(),
|
|
431
|
+
interval_ms: null,
|
|
432
|
+
sample_duration_ms: round1(performance.now() - started),
|
|
433
|
+
collector_cpu_ms: round1((collectorCpu.user + collectorCpu.system) / 1_000),
|
|
434
|
+
platform: currentPlatform,
|
|
435
|
+
namespace: "unknown",
|
|
436
|
+
support: { state: "unsupported", sampler: "unsupported", reason },
|
|
437
|
+
machine: {
|
|
438
|
+
cpu_percent: null,
|
|
439
|
+
cpu_logical_count: cpus().length,
|
|
440
|
+
load_average: null,
|
|
441
|
+
memory_total_bytes: null,
|
|
442
|
+
memory_available_bytes: null,
|
|
443
|
+
memory_used_bytes: null,
|
|
444
|
+
memory_percent: null,
|
|
445
|
+
swap_total_bytes: null,
|
|
446
|
+
swap_used_bytes: null,
|
|
447
|
+
process_count: 0,
|
|
448
|
+
},
|
|
449
|
+
groups: [],
|
|
450
|
+
processes: [],
|
|
451
|
+
visible_process_count: 0,
|
|
452
|
+
omitted_process_count: 0,
|
|
453
|
+
unattributed_process_count: 0,
|
|
454
|
+
};
|
|
455
|
+
}
|
|
456
|
+
function round1(value) {
|
|
457
|
+
return Math.round(value * 10) / 10;
|
|
458
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"service-status.d.ts","sourceRoot":"","sources":["../../../src/core/resources/service-status.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,qBAAqB,EAE3B,MAAM,eAAe,CAAC;AAKvB,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,KAAK,SAAa,GACjB,qBAAqB,CA0BvB"}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
import { hostname } from "node:os";
|
|
2
|
+
import { checkPidToken } from "../agents/state/proc-start.js";
|
|
3
|
+
import { RESOURCE_SERVICE_STATUS_SCHEMA_VERSION, } from "./contract.js";
|
|
4
|
+
import { readResourceServiceRecord, resourcePaths } from "./storage.js";
|
|
5
|
+
const STALE_HEARTBEAT_MS = 15_000;
|
|
6
|
+
export function readResourceServiceStatus(coordRoot, nowMs = Date.now()) {
|
|
7
|
+
const paths = resourcePaths(coordRoot);
|
|
8
|
+
const record = readResourceServiceRecord(coordRoot);
|
|
9
|
+
if (!validRecord(record)) {
|
|
10
|
+
return {
|
|
11
|
+
running: false,
|
|
12
|
+
stale: false,
|
|
13
|
+
status_path: paths.service,
|
|
14
|
+
snapshot_path: paths.snapshot,
|
|
15
|
+
};
|
|
16
|
+
}
|
|
17
|
+
const heartbeatAt = Date.parse(record.heartbeat_at);
|
|
18
|
+
const stale = !Number.isFinite(heartbeatAt) || nowMs - heartbeatAt > STALE_HEARTBEAT_MS;
|
|
19
|
+
const local = record.host === hostname();
|
|
20
|
+
const running = local &&
|
|
21
|
+
!stale &&
|
|
22
|
+
(record.state === "starting" || record.state === "running" || record.state === "stopping") &&
|
|
23
|
+
pidStillMatches(record.pid, record.start_token);
|
|
24
|
+
return {
|
|
25
|
+
running,
|
|
26
|
+
stale,
|
|
27
|
+
record,
|
|
28
|
+
status_path: paths.service,
|
|
29
|
+
snapshot_path: paths.snapshot,
|
|
30
|
+
};
|
|
31
|
+
}
|
|
32
|
+
function validRecord(value) {
|
|
33
|
+
return (value?.schema_version === RESOURCE_SERVICE_STATUS_SCHEMA_VERSION &&
|
|
34
|
+
Number.isInteger(value.pid) &&
|
|
35
|
+
value.pid > 0 &&
|
|
36
|
+
typeof value.host === "string" &&
|
|
37
|
+
typeof value.heartbeat_at === "string");
|
|
38
|
+
}
|
|
39
|
+
function pidStillMatches(pid, startToken) {
|
|
40
|
+
try {
|
|
41
|
+
process.kill(pid, 0);
|
|
42
|
+
}
|
|
43
|
+
catch (error) {
|
|
44
|
+
if (error.code !== "EPERM")
|
|
45
|
+
return false;
|
|
46
|
+
}
|
|
47
|
+
return checkPidToken(pid, startToken) !== "mismatch";
|
|
48
|
+
}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import { type ResourceServiceStatus, type ResourceServiceStatusRecord } from "./contract.js";
|
|
2
|
+
import { sampleResources } from "./sampler.js";
|
|
3
|
+
export declare const RESOURCE_SERVICE_DEFAULT_INTERVAL_MS = 2000;
|
|
4
|
+
export interface RunResourceServiceInput {
|
|
5
|
+
coordRoot: string;
|
|
6
|
+
intervalMs?: number;
|
|
7
|
+
maxSamples?: number;
|
|
8
|
+
now?: () => Date;
|
|
9
|
+
sample?: typeof sampleResources;
|
|
10
|
+
wait?: (milliseconds: number) => Promise<void>;
|
|
11
|
+
}
|
|
12
|
+
export type EnsureResourceServiceResult = {
|
|
13
|
+
state: "running" | "started";
|
|
14
|
+
status: ResourceServiceStatus;
|
|
15
|
+
} | {
|
|
16
|
+
state: "unsupported" | "unavailable";
|
|
17
|
+
status: ResourceServiceStatus;
|
|
18
|
+
error: string;
|
|
19
|
+
};
|
|
20
|
+
export declare function spawnResourceService(coordRootRaw: string, options?: {
|
|
21
|
+
intervalMs?: number;
|
|
22
|
+
}): Promise<ResourceServiceStatus>;
|
|
23
|
+
export declare function ensureResourceServiceRunning(coordRoot: string): Promise<EnsureResourceServiceResult>;
|
|
24
|
+
export declare function requestResourceServiceStop(coordRootRaw: string): ResourceServiceStatus;
|
|
25
|
+
export declare function runResourceService(input: RunResourceServiceInput): Promise<ResourceServiceStatusRecord>;
|
|
26
|
+
//# sourceMappingURL=service.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/core/resources/service.ts"],"names":[],"mappings":"AAgBA,OAAO,EAGL,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EACjC,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAI/C,eAAO,MAAM,oCAAoC,OAAQ,CAAC;AAY1D,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,eAAe,CAAC;IAChC,IAAI,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED,MAAM,MAAM,2BAA2B,GACnC;IAAE,KAAK,EAAE,SAAS,GAAG,SAAS,CAAC;IAAC,MAAM,EAAE,qBAAqB,CAAA;CAAE,GAC/D;IAAE,KAAK,EAAE,aAAa,GAAG,aAAa,CAAC;IAAC,MAAM,EAAE,qBAAqB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3F,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACpC,OAAO,CAAC,qBAAqB,CAAC,CAwChC;AAED,wBAAsB,4BAA4B,CAChD,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,2BAA2B,CAAC,CAoBtC;AAED,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,qBAAqB,CAiBtF;AAED,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,2BAA2B,CAAC,CAwFtC"}
|