@timurproko/a1 0.2.7-dev.1249 → 0.2.7-dev.1252
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/README.md +11 -36
- package/bin/cli.js +2 -17
- package/bin/ui.js +7 -48
- package/dist/app/session-shell/exit-notice.d.ts +2 -2
- package/dist/app/session-shell/exit-notice.js +10 -10
- package/dist/app/session-shell/prompt-submission.d.ts +2 -4
- package/dist/app/session-shell/prompt-submission.js +3 -23
- package/dist/app/session-shell/response-copy-transport.js +1 -2
- package/dist/app/session-shell/session-lifecycle.d.ts +1 -2
- package/dist/app/session-shell/session-lifecycle.js +2 -4
- package/dist/app/session-shell/session-shell-root.d.ts +0 -31
- package/dist/app/session-shell/session-shell-root.js +3 -4
- package/dist/app/session-shell/session-shell.js +6 -47
- package/dist/app/session-shell/session-viewport-controller.js +3 -6
- package/dist/app/session-shell/shell-host.js +2 -18
- package/dist/app/session-shell/transcript-document.d.ts +1 -2
- package/dist/app/session-shell/transcript-document.js +3 -28
- package/dist/app/session-shell/workflow-output.js +1 -1
- package/dist/app/session-shell/workflow-router.d.ts +1 -3
- package/dist/app/session-shell/workflow-router.js +1 -4
- package/dist/cli/dispatch.d.ts +1 -11
- package/dist/cli/dispatch.js +5 -92
- package/dist/cli/session-context.js +5 -7
- package/dist/cli/uninstall.d.ts +1 -5
- package/dist/cli/uninstall.js +6 -35
- package/dist/cli/version-stats.js +4 -7
- package/dist/composition/owned-settings.d.ts +0 -1
- package/dist/composition/owned-settings.js +0 -1
- package/dist/composition/owned-ui.d.ts +2 -24
- package/dist/composition/owned-ui.js +11 -87
- package/dist/composition/release-update-observation.d.ts +4 -4
- package/dist/composition/release-update-observation.js +17 -47
- package/dist/composition/session-backend.d.ts +0 -1
- package/dist/composition/session-runtime-registry.d.ts +3 -3
- package/dist/composition/settings-route-host.d.ts +0 -7
- package/dist/composition/settings-route-host.js +4 -10
- package/dist/composition/startup-route.d.ts +0 -1
- package/dist/composition/startup-route.js +0 -1
- package/dist/contracts/owned-ui/index.d.ts +1 -1
- package/dist/contracts/owned-ui/model.d.ts +0 -3
- package/dist/contracts/owned-ui/session-workflows.d.ts +1 -4
- package/dist/features/launch/development-launch.js +0 -1
- package/dist/features/launch/index.d.ts +1 -1
- package/dist/features/launch/intent.d.ts +1 -3
- package/dist/features/launch/intent.js +2 -4
- package/dist/features/launch/session-context.d.ts +2 -2
- package/dist/features/owned-ui/reference-screen-app.d.ts +0 -2
- package/dist/features/owned-ui/reference-screen-app.js +2 -9
- package/dist/features/owned-ui/settings-app.d.ts +0 -6
- package/dist/features/owned-ui/settings-app.js +5 -36
- package/dist/foundation/launch-context/index.d.ts +0 -12
- package/dist/foundation/launch-context/index.js +0 -26
- package/dist/foundation/lifecycle/claim-gate.d.ts +8 -0
- package/dist/foundation/lifecycle/claim-gate.js +37 -0
- package/dist/foundation/lifecycle/index.d.ts +5 -9
- package/dist/foundation/lifecycle/index.js +3 -4
- package/dist/foundation/lifecycle/model.d.ts +2 -59
- package/dist/foundation/lifecycle/model.js +0 -35
- package/dist/foundation/lifecycle/paths.d.ts +0 -24
- package/dist/foundation/lifecycle/paths.js +0 -40
- package/dist/foundation/lifecycle/process-liveness.d.ts +8 -0
- package/dist/foundation/lifecycle/process-liveness.js +18 -0
- package/dist/foundation/lifecycle/session-claim-lock.d.ts +1 -1
- package/dist/foundation/lifecycle/session-claim-lock.js +2 -2
- package/dist/foundation/lifecycle/session-repository-context.d.ts +6 -6
- package/dist/foundation/lifecycle/session-repository-context.js +2 -3
- package/dist/foundation/release/automatic-update.d.ts +1 -3
- package/dist/foundation/release/automatic-update.js +9 -30
- package/dist/foundation/release/bootstrap.d.ts +2 -25
- package/dist/foundation/release/bootstrap.js +33 -344
- package/dist/foundation/release/cohort-state.d.ts +21 -46
- package/dist/foundation/release/cohort-state.js +30 -62
- package/dist/foundation/release/dependency-certification.d.ts +1 -1
- package/dist/foundation/release/index.d.ts +10 -17
- package/dist/foundation/release/index.js +7 -11
- package/dist/foundation/release/latest-release.d.ts +1 -2
- package/dist/foundation/release/latest-release.js +1 -2
- package/dist/foundation/release/process-liveness.d.ts +2 -0
- package/dist/foundation/release/process-liveness.js +12 -0
- package/dist/foundation/release/release-gc.d.ts +12 -9
- package/dist/foundation/release/release-gc.js +34 -98
- package/dist/foundation/release/release-store.d.ts +2 -2
- package/dist/foundation/release/release-store.js +2 -2
- package/dist/foundation/release/restart-certification.js +1 -1
- package/dist/foundation/release/update-activation.d.ts +2 -9
- package/dist/foundation/release/update-activation.js +28 -43
- package/dist/foundation/release/update-execution-lease.js +1 -1
- package/dist/foundation/release/update-launch.d.ts +0 -2
- package/dist/foundation/release/update-launch.js +0 -7
- package/dist/foundation/release/update-recovery.js +1 -1
- package/dist/foundation/release/update-transaction.d.ts +1 -1
- package/dist/foundation/release/update-transaction.js +5 -2
- package/dist/foundation/release/update.d.ts +2 -10
- package/dist/foundation/release/update.js +23 -200
- package/dist/foundation/session-writer-lock/index.d.ts +14 -6
- package/dist/foundation/session-writer-lock/index.js +48 -103
- package/dist/foundation/startup/startup-runtime.d.ts +1 -1
- package/dist/foundation/terminal-cleanup/exit-notice.d.ts +6 -0
- package/dist/foundation/terminal-cleanup/exit-notice.js +36 -0
- package/dist/foundation/terminal-cleanup/index.d.ts +2 -1
- package/dist/foundation/terminal-cleanup/index.js +2 -1
- package/dist/foundation/terminal-cleanup/terminal-reset.d.ts +0 -5
- package/dist/foundation/terminal-cleanup/terminal-reset.js +0 -5
- package/dist/integrations/pi/components/index.d.ts +1 -1
- package/dist/integrations/pi/components/index.js +1 -1
- package/dist/integrations/pi/components/shell-editor-autocomplete.js +1 -4
- package/dist/integrations/pi/components/shell-footer-status.d.ts +1 -1
- package/dist/integrations/pi/components/shell-footer-status.js +2 -2
- package/dist/integrations/pi/components/shell-hotkey-sections.js +1 -1
- package/dist/integrations/pi/components/shell-presenters-info.d.ts +2 -5
- package/dist/integrations/pi/components/shell-presenters-info.js +4 -18
- package/dist/integrations/pi/components/shell-presenters-transcript.d.ts +1 -1
- package/dist/integrations/pi/components/shell-presenters-transcript.js +1 -1
- package/dist/integrations/pi/components/shell-shared-facade.d.ts +0 -2
- package/dist/integrations/pi/components/submitted-prompt-adapter.d.ts +2 -5
- package/dist/integrations/pi/components/submitted-prompt-adapter.js +2 -16
- package/dist/integrations/pi/components/upstream/components/session-footer.d.ts +1 -2
- package/dist/integrations/pi/components/upstream/components/session-footer.js +6 -8
- package/dist/integrations/pi/engine/adapter.d.ts +0 -1
- package/dist/integrations/pi/engine/adapter.js +1 -16
- package/dist/integrations/pi/engine/diagnostics-state.d.ts +0 -1
- package/dist/integrations/pi/engine/diagnostics-state.js +0 -14
- package/dist/integrations/pi/engine/prompt-suggestions.d.ts +0 -1
- package/dist/integrations/pi/engine/prompt-suggestions.js +0 -40
- package/dist/integrations/pi/engine/session-runtime.js +0 -2
- package/dist/integrations/pi/engine/workflow-runner.js +1 -1
- package/dist/integrations/pi/tui-runtime/adapter.d.ts +2 -2
- package/dist/integrations/pi/tui-runtime/adapter.js +2 -2
- package/dist/product-identity.d.ts +4 -6
- package/dist/product-identity.js +6 -11
- package/dist/product-identity.json +1 -40
- package/dist/runtime-payload-inventory.json +0 -3
- package/dist/ui/components/index.d.ts +2 -2
- package/dist/ui/components/index.js +1 -1
- package/dist/ui/components/submitted-prompt.d.ts +3 -13
- package/dist/ui/components/submitted-prompt.js +8 -41
- package/dist/ui/components/transcript-viewport.d.ts +1 -3
- package/dist/ui/components/transcript-viewport.js +1 -4
- package/dist/ui/settings/declarations.d.ts +3 -97
- package/dist/ui/settings/declarations.js +3 -78
- package/dist/ui/settings/migrations.js +18 -2
- package/docs/architecture/boundaries.md +22 -39
- package/docs/architecture/code-documentation.md +2 -2
- package/docs/architecture/internal-naming.md +9 -17
- package/docs/architecture/project-structure.md +9 -14
- package/docs/architecture/resource-and-data-policy.md +16 -31
- package/docs/architecture/toolchain.md +14 -19
- package/docs/architecture/ui-reference-provenance.md +2 -2
- package/docs/ci-release-runbook.md +5 -5
- package/docs/features/launch-profiles.md +11 -17
- package/docs/features/prompt-history.md +10 -11
- package/docs/local-worktree-cleanup.md +28 -1
- package/docs/manual-owned-ui-checkpoint.md +0 -1
- package/docs/validation.md +5 -11
- package/docs/worktree-link-recovery.md +6 -6
- package/package.json +7 -19
- package/bin/guardian.js +0 -42
- package/bin/supervisor.js +0 -7
- package/bin/tab-launch-context.d.ts +0 -27
- package/bin/tab-launch-context.js +0 -94
- package/dist/app/session-shell/resident-tab-coordinator.d.ts +0 -38
- package/dist/app/session-shell/resident-tab-coordinator.js +0 -77
- package/dist/cli/tabs-request.d.ts +0 -7
- package/dist/cli/tabs-request.js +0 -1
- package/dist/cli/tabs.d.ts +0 -14
- package/dist/cli/tabs.js +0 -151
- package/dist/composition/resident-tab-bridge.d.ts +0 -41
- package/dist/composition/resident-tab-bridge.js +0 -209
- package/dist/composition/utility-tab.d.ts +0 -28
- package/dist/composition/utility-tab.js +0 -244
- package/dist/features/owned-ui/plus-menu-dialog.d.ts +0 -28
- package/dist/features/owned-ui/plus-menu-dialog.js +0 -89
- package/dist/features/resident-tab/auto-name.d.ts +0 -11
- package/dist/features/resident-tab/auto-name.js +0 -44
- package/dist/features/resident-tab/index.d.ts +0 -5
- package/dist/features/resident-tab/index.js +0 -7
- package/dist/features/resident-tab/shortcut-bindings-file.d.ts +0 -8
- package/dist/features/resident-tab/shortcut-bindings-file.js +0 -40
- package/dist/features/resident-tab/shortcut-declarations.d.ts +0 -13
- package/dist/features/resident-tab/shortcut-declarations.js +0 -26
- package/dist/features/resident-tab/shortcut-projection.d.ts +0 -29
- package/dist/features/resident-tab/shortcut-projection.js +0 -64
- package/dist/features/resident-tab/status-deriver.d.ts +0 -10
- package/dist/features/resident-tab/status-deriver.js +0 -12
- package/dist/foundation/launch-guardian/exit-watcher.d.ts +0 -14
- package/dist/foundation/launch-guardian/exit-watcher.js +0 -103
- package/dist/foundation/launch-guardian/index.d.ts +0 -2
- package/dist/foundation/launch-guardian/index.js +0 -1
- package/dist/foundation/launch-guardian/main.d.ts +0 -39
- package/dist/foundation/launch-guardian/main.js +0 -232
- package/dist/foundation/lifecycle/commands.d.ts +0 -40
- package/dist/foundation/lifecycle/commands.js +0 -1
- package/dist/foundation/lifecycle/launch-instance.d.ts +0 -46
- package/dist/foundation/lifecycle/launch-instance.js +0 -134
- package/dist/foundation/lifecycle/native-claim-gate.d.ts +0 -5
- package/dist/foundation/lifecycle/native-claim-gate.js +0 -41
- package/dist/foundation/lifecycle/supervisor-startup.d.ts +0 -30
- package/dist/foundation/lifecycle/supervisor-startup.js +0 -106
- package/dist/foundation/process-containment/addon-containment.d.ts +0 -20
- package/dist/foundation/process-containment/addon-containment.js +0 -139
- package/dist/foundation/process-containment/addon-process-inspector.d.ts +0 -11
- package/dist/foundation/process-containment/addon-process-inspector.js +0 -36
- package/dist/foundation/process-containment/addon.d.ts +0 -47
- package/dist/foundation/process-containment/addon.js +0 -57
- package/dist/foundation/process-containment/artifact.d.ts +0 -1
- package/dist/foundation/process-containment/artifact.js +0 -35
- package/dist/foundation/process-containment/contracts.d.ts +0 -33
- package/dist/foundation/process-containment/contracts.js +0 -35
- package/dist/foundation/process-containment/index.d.ts +0 -9
- package/dist/foundation/process-containment/index.js +0 -7
- package/dist/foundation/process-containment/linux-process-inspector.d.ts +0 -7
- package/dist/foundation/process-containment/linux-process-inspector.js +0 -27
- package/dist/foundation/process-containment/native-process-inspector.d.ts +0 -4
- package/dist/foundation/process-containment/native-process-inspector.js +0 -21
- package/dist/foundation/protocol/client.d.ts +0 -18
- package/dist/foundation/protocol/client.js +0 -130
- package/dist/foundation/protocol/index.d.ts +0 -3
- package/dist/foundation/protocol/index.js +0 -2
- package/dist/foundation/protocol/messages.d.ts +0 -90
- package/dist/foundation/protocol/messages.js +0 -100
- package/dist/foundation/release/cohort-selection.d.ts +0 -33
- package/dist/foundation/release/cohort-selection.js +0 -67
- package/dist/foundation/release/endpoint-lock.d.ts +0 -2
- package/dist/foundation/release/endpoint-lock.js +0 -37
- package/dist/foundation/release/endpoint-recovery.d.ts +0 -10
- package/dist/foundation/release/endpoint-recovery.js +0 -45
- package/dist/foundation/release/endpoints.d.ts +0 -32
- package/dist/foundation/release/endpoints.js +0 -152
- package/dist/foundation/release/prepared-update-activation.d.ts +0 -3
- package/dist/foundation/release/prepared-update-activation.js +0 -27
- package/dist/foundation/release/process-cleanup.d.ts +0 -14
- package/dist/foundation/release/process-cleanup.js +0 -76
- package/dist/foundation/release/supervisor-identity.d.ts +0 -15
- package/dist/foundation/release/supervisor-identity.js +0 -63
- package/dist/foundation/resident-tabs/boot-identity.d.ts +0 -6
- package/dist/foundation/resident-tabs/boot-identity.js +0 -16
- package/dist/foundation/resident-tabs/bounded-host-command.d.ts +0 -20
- package/dist/foundation/resident-tabs/bounded-host-command.js +0 -62
- package/dist/foundation/resident-tabs/bridge-client.d.ts +0 -73
- package/dist/foundation/resident-tabs/bridge-client.js +0 -327
- package/dist/foundation/resident-tabs/continuity.d.ts +0 -12
- package/dist/foundation/resident-tabs/continuity.js +0 -63
- package/dist/foundation/resident-tabs/doctor.d.ts +0 -28
- package/dist/foundation/resident-tabs/doctor.js +0 -166
- package/dist/foundation/resident-tabs/draft-checkpoint.d.ts +0 -27
- package/dist/foundation/resident-tabs/draft-checkpoint.js +0 -145
- package/dist/foundation/resident-tabs/ensure-terminal-host.d.ts +0 -36
- package/dist/foundation/resident-tabs/ensure-terminal-host.js +0 -151
- package/dist/foundation/resident-tabs/fault-injection.d.ts +0 -8
- package/dist/foundation/resident-tabs/fault-injection.js +0 -26
- package/dist/foundation/resident-tabs/fixture-control.d.ts +0 -7
- package/dist/foundation/resident-tabs/fixture-control.js +0 -35
- package/dist/foundation/resident-tabs/host-entry.d.ts +0 -1
- package/dist/foundation/resident-tabs/host-entry.js +0 -17
- package/dist/foundation/resident-tabs/index.d.ts +0 -15
- package/dist/foundation/resident-tabs/index.js +0 -10
- package/dist/foundation/resident-tabs/maintenance.d.ts +0 -39
- package/dist/foundation/resident-tabs/maintenance.js +0 -75
- package/dist/foundation/resident-tabs/progress-observation-schema.d.ts +0 -34
- package/dist/foundation/resident-tabs/progress-observation-schema.js +0 -1
- package/dist/foundation/resident-tabs/progress-observation.d.ts +0 -4
- package/dist/foundation/resident-tabs/progress-observation.js +0 -150
- package/dist/foundation/resident-tabs/prompt-journal.d.ts +0 -63
- package/dist/foundation/resident-tabs/prompt-journal.js +0 -213
- package/dist/foundation/resident-tabs/protocol.d.ts +0 -12
- package/dist/foundation/resident-tabs/protocol.js +0 -195
- package/dist/foundation/resident-tabs/recovery.d.ts +0 -26
- package/dist/foundation/resident-tabs/recovery.js +0 -205
- package/dist/foundation/resident-tabs/release-holds.d.ts +0 -28
- package/dist/foundation/resident-tabs/release-holds.js +0 -78
- package/dist/foundation/resident-tabs/routes.d.ts +0 -5
- package/dist/foundation/resident-tabs/routes.js +0 -5
- package/dist/foundation/resident-tabs/routing.d.ts +0 -11
- package/dist/foundation/resident-tabs/routing.js +0 -10
- package/dist/foundation/resident-tabs/runtime-control.d.ts +0 -38
- package/dist/foundation/resident-tabs/runtime-control.js +0 -74
- package/dist/foundation/resident-tabs/session-sync.d.ts +0 -14
- package/dist/foundation/resident-tabs/session-sync.js +0 -37
- package/dist/foundation/resident-tabs/settings.d.ts +0 -16
- package/dist/foundation/resident-tabs/settings.js +0 -60
- package/dist/foundation/resident-tabs/terminal-host-artifact.d.ts +0 -14
- package/dist/foundation/resident-tabs/terminal-host-artifact.js +0 -78
- package/dist/foundation/resident-tabs/zip-archive.d.ts +0 -9
- package/dist/foundation/resident-tabs/zip-archive.js +0 -56
- package/dist/foundation/storage/control-store.d.ts +0 -20
- package/dist/foundation/storage/control-store.js +0 -331
- package/dist/foundation/storage/index.d.ts +0 -1
- package/dist/foundation/storage/index.js +0 -1
- package/dist/foundation/supervision/index.d.ts +0 -3
- package/dist/foundation/supervision/index.js +0 -3
- package/dist/foundation/supervision/main.d.ts +0 -1
- package/dist/foundation/supervision/main.js +0 -86
- package/dist/foundation/supervision/paths.d.ts +0 -1
- package/dist/foundation/supervision/paths.js +0 -1
- package/dist/foundation/supervision/server.d.ts +0 -46
- package/dist/foundation/supervision/server.js +0 -611
- package/dist/integrations/pi/engine/offline-settings-port.d.ts +0 -23
- package/dist/integrations/pi/engine/offline-settings-port.js +0 -54
- package/dist/native/darwin-arm64/manifest.json +0 -23
- package/dist/native/darwin-arm64/process-guardian.node +0 -0
- package/dist/native/darwin-arm64/terminal-host-THIRD-PARTY-NOTICES.txt +0 -10500
- package/dist/native/darwin-arm64/terminal-host.manifest.json +0 -46
- package/dist/native/darwin-arm64/terminal-host.node +0 -0
- package/dist/native/darwin-x64/manifest.json +0 -23
- package/dist/native/darwin-x64/process-guardian.node +0 -0
- package/dist/native/darwin-x64/terminal-host-THIRD-PARTY-NOTICES.txt +0 -10737
- package/dist/native/darwin-x64/terminal-host.manifest.json +0 -46
- package/dist/native/darwin-x64/terminal-host.node +0 -0
- package/dist/native/linux-x64/manifest.json +0 -23
- package/dist/native/linux-x64/process-guardian.node +0 -0
- package/dist/native/linux-x64/terminal-host-THIRD-PARTY-NOTICES.txt +0 -11226
- package/dist/native/linux-x64/terminal-host.manifest.json +0 -46
- package/dist/native/linux-x64/terminal-host.node +0 -0
- package/dist/native/win32-x64/manifest.json +0 -23
- package/dist/native/win32-x64/process-guardian.node +0 -0
- package/dist/native/win32-x64/terminal-host-THIRD-PARTY-NOTICES.txt +0 -10757
- package/dist/native/win32-x64/terminal-host.manifest.json +0 -46
- package/dist/native/win32-x64/terminal-host.node +0 -0
- package/docs/architecture/evidence/resident-tabs/linux-x64.md +0 -37
- package/docs/architecture/evidence/resident-tabs/macos-arm64.md +0 -36
- package/docs/architecture/evidence/resident-tabs/macos-x64.md +0 -35
- package/docs/architecture/evidence/resident-tabs/windows-x64.md +0 -36
- package/docs/architecture/evidence/terminal-host-spike/manual-one-pane-terminal-host.md +0 -70
- package/docs/architecture/evidence/terminal-host-spike/manual-two-by-two-basic-terminal-host.md +0 -32
- package/docs/architecture/evidence/terminal-host-spike/milestone-baseline.json +0 -115
- package/docs/architecture/evidence/terminal-host-spike/owned-ui-foundation-prerequisite.json +0 -48
- package/docs/architecture/evidence/terminal-host-spike/terminal-host-provenance.json +0 -125
- package/docs/architecture/evidence/terminal-host-spike/terminal-host-task-5-1.json +0 -56
- package/docs/architecture/evidence/terminal-host-spike/terminal-host-task-5-3.json +0 -174
- package/docs/architecture/evidence/terminal-host-spike/terminal-spike-acceptance-record.json +0 -18
- package/docs/architecture/native-fixture-isolation.md +0 -23
- package/docs/architecture/process-guardian-provenance.md +0 -36
- package/docs/architecture/resident-tabs-requirements.md +0 -18
- package/docs/architecture/resident-tabs.md +0 -668
- package/docs/architecture/terminal-host-proof-gate.md +0 -34
- package/docs/architecture/terminal-host-provenance.md +0 -81
- package/docs/architecture/terminal-host-spike-evidence.md +0 -39
- package/docs/launch-recovery.md +0 -23
- package/docs/manual-launch-instance-acceptance.md +0 -43
- package/docs/manual-resident-tabs-acceptance.md +0 -51
|
@@ -1,205 +0,0 @@
|
|
|
1
|
-
import { readFile, readdir, stat } from "node:fs/promises";
|
|
2
|
-
import { dirname, join, resolve } from "node:path";
|
|
3
|
-
import { DraftCheckpointer } from "./draft-checkpoint.js";
|
|
4
|
-
import { ResidentTabFaultInjection } from "./fault-injection.js";
|
|
5
|
-
import { PromptJournal } from "./prompt-journal.js";
|
|
6
|
-
import { SettledTurnSynchronizer, synchronizeSessionFile } from "./session-sync.js";
|
|
7
|
-
export class ResidentTabRecovery {
|
|
8
|
-
#journal;
|
|
9
|
-
#draft;
|
|
10
|
-
#synchronizer;
|
|
11
|
-
#faults;
|
|
12
|
-
#onDegraded;
|
|
13
|
-
#active = [];
|
|
14
|
-
#recovered = { prompts: [], draft: null };
|
|
15
|
-
constructor(dataDir, options = {}) {
|
|
16
|
-
const faults = options.faults ?? new ResidentTabFaultInjection();
|
|
17
|
-
this.#faults = faults;
|
|
18
|
-
this.#onDegraded = options.onDegraded ?? (() => { });
|
|
19
|
-
this.#journal = new PromptJournal(join(dataDir, "journal.jsonl"), { faults });
|
|
20
|
-
this.#draft = new DraftCheckpointer(join(dataDir, "draft.json"), { faults, onDegraded: this.#onDegraded });
|
|
21
|
-
this.#synchronizer = new SettledTurnSynchronizer(this.#journal, faults);
|
|
22
|
-
}
|
|
23
|
-
get recovered() { return this.#recovered; }
|
|
24
|
-
async initialize(currentSessionFile = null, currentSessionId = null) {
|
|
25
|
-
await this.#journal.initialize();
|
|
26
|
-
await adoptHistoricalJournals(dirname(dirname(this.#journal.path)), this.#journal, currentSessionFile, currentSessionId);
|
|
27
|
-
const records = await this.#journal.read();
|
|
28
|
-
const sessionFiles = new Set(records.flatMap(record => record.type === "submitted" && record.sessionFile !== null ? [record.sessionFile] : []));
|
|
29
|
-
if (currentSessionFile !== null)
|
|
30
|
-
sessionFiles.add(currentSessionFile);
|
|
31
|
-
const sessionEntries = (await Promise.all([...sessionFiles].map(readSessionJournal))).flat();
|
|
32
|
-
const [pending, draft] = await Promise.all([
|
|
33
|
-
this.#journal.pending(sessionEntries),
|
|
34
|
-
this.#draft.restore(),
|
|
35
|
-
]);
|
|
36
|
-
this.#recovered = { prompts: pending.map(value => value.submitted), draft: draft?.text ?? null };
|
|
37
|
-
return this.#recovered;
|
|
38
|
-
}
|
|
39
|
-
async admit(input, timeoutMs = 2_000) {
|
|
40
|
-
const fileExisted = input.sessionFile === null ? false : await stat(input.sessionFile).then(() => true, error => {
|
|
41
|
-
if (error.code === "ENOENT")
|
|
42
|
-
return false;
|
|
43
|
-
throw error;
|
|
44
|
-
});
|
|
45
|
-
let timer;
|
|
46
|
-
try {
|
|
47
|
-
return await Promise.race([
|
|
48
|
-
this.#journal.submit({ ...input, fileExisted }),
|
|
49
|
-
new Promise((_, reject) => {
|
|
50
|
-
timer = setTimeout(() => reject(new Error("resident prompt journal admission timed out")), timeoutMs);
|
|
51
|
-
timer.unref();
|
|
52
|
-
}),
|
|
53
|
-
]);
|
|
54
|
-
}
|
|
55
|
-
finally {
|
|
56
|
-
if (timer !== undefined)
|
|
57
|
-
clearTimeout(timer);
|
|
58
|
-
}
|
|
59
|
-
}
|
|
60
|
-
dispatched() { this.#faults.at("journal-after-dispatch"); }
|
|
61
|
-
async correlated(submissionId, entryId) {
|
|
62
|
-
await this.#journal.correlate(submissionId, entryId);
|
|
63
|
-
this.#active.push({ id: submissionId, entryId });
|
|
64
|
-
}
|
|
65
|
-
checkpoint(text) { this.#draft.change(text); }
|
|
66
|
-
async settled(sessionFile) {
|
|
67
|
-
const active = this.#active.splice(0);
|
|
68
|
-
if (active.length === 0 || sessionFile === null)
|
|
69
|
-
return;
|
|
70
|
-
await this.#synchronizer.settleMany(sessionFile, active);
|
|
71
|
-
for (const entry of active)
|
|
72
|
-
await this.#journal.retire(entry.id);
|
|
73
|
-
await this.#journal.compactIfRetired();
|
|
74
|
-
}
|
|
75
|
-
async gracefulStop(sessionFile) {
|
|
76
|
-
await this.#draft.flush();
|
|
77
|
-
if (sessionFile !== null)
|
|
78
|
-
await synchronizeSessionFile(sessionFile);
|
|
79
|
-
await this.#synchronizer.flush();
|
|
80
|
-
}
|
|
81
|
-
}
|
|
82
|
-
const MAX_SESSION_RECONCILE_BYTES = 64 * 1024 * 1024;
|
|
83
|
-
const MAX_ADOPTION_AGE_MS = 7 * 24 * 60 * 60 * 1_000;
|
|
84
|
-
async function adoptHistoricalJournals(profileTabsRoot, target, currentSessionFile, currentSessionId) {
|
|
85
|
-
if (currentSessionFile === null && currentSessionId === null)
|
|
86
|
-
return;
|
|
87
|
-
const history = join(profileTabsRoot, "registry-history");
|
|
88
|
-
const names = await readdir(history).catch(() => []);
|
|
89
|
-
for (const name of names.filter(value => /^tabset-.+\.json$/.test(value)).sort().reverse()) {
|
|
90
|
-
const path = join(history, name);
|
|
91
|
-
const metadata = await stat(path).catch(() => null);
|
|
92
|
-
if (metadata === null || Date.now() - metadata.mtimeMs > MAX_ADOPTION_AGE_MS)
|
|
93
|
-
continue;
|
|
94
|
-
let document;
|
|
95
|
-
try {
|
|
96
|
-
document = JSON.parse(await readFile(path, "utf8"));
|
|
97
|
-
}
|
|
98
|
-
catch {
|
|
99
|
-
continue;
|
|
100
|
-
}
|
|
101
|
-
const tabs = typeof document === "object" && document !== null && Array.isArray(document.tabs)
|
|
102
|
-
? document.tabs : [];
|
|
103
|
-
for (const value of tabs) {
|
|
104
|
-
if (typeof value !== "object" || value === null)
|
|
105
|
-
continue;
|
|
106
|
-
const tab = value;
|
|
107
|
-
if (typeof tab.tabId !== "string")
|
|
108
|
-
continue;
|
|
109
|
-
const fileMatches = currentSessionFile !== null && typeof tab.sessionFile === "string"
|
|
110
|
-
&& resolve(tab.sessionFile) === resolve(currentSessionFile);
|
|
111
|
-
const sourcePath = join(profileTabsRoot, tab.tabId, "journal.jsonl");
|
|
112
|
-
if (resolve(sourcePath) === resolve(target.path))
|
|
113
|
-
continue;
|
|
114
|
-
if (!await stat(sourcePath).then(() => true, () => false))
|
|
115
|
-
continue;
|
|
116
|
-
const source = new PromptJournal(sourcePath);
|
|
117
|
-
await source.initialize();
|
|
118
|
-
const records = await source.read();
|
|
119
|
-
const submitted = records.filter((record) => record.type === "submitted");
|
|
120
|
-
const idMatches = currentSessionId !== null && submitted.some(record => record.sessionId === currentSessionId);
|
|
121
|
-
if (!fileMatches && !idMatches)
|
|
122
|
-
continue;
|
|
123
|
-
const pending = await source.pending(currentSessionFile === null ? [] : await readSessionJournal(currentSessionFile));
|
|
124
|
-
for (const entry of pending) {
|
|
125
|
-
await target.adopt(entry.submitted);
|
|
126
|
-
await source.retire(entry.submitted.id);
|
|
127
|
-
}
|
|
128
|
-
}
|
|
129
|
-
}
|
|
130
|
-
}
|
|
131
|
-
/** Reconcile only durable user/assistant ancestry; a torn final JSONL record is not authority. */
|
|
132
|
-
export async function readSessionJournal(path) {
|
|
133
|
-
let text;
|
|
134
|
-
try {
|
|
135
|
-
const metadata = await stat(path);
|
|
136
|
-
if (metadata.size > MAX_SESSION_RECONCILE_BYTES)
|
|
137
|
-
throw new Error("resident session exceeds the recovery scan limit");
|
|
138
|
-
text = await readFile(path, "utf8");
|
|
139
|
-
}
|
|
140
|
-
catch (error) {
|
|
141
|
-
if (error.code === "ENOENT")
|
|
142
|
-
return [];
|
|
143
|
-
throw error;
|
|
144
|
-
}
|
|
145
|
-
const raw = [];
|
|
146
|
-
const lines = text.split("\n");
|
|
147
|
-
for (let index = 0; index < lines.length; index += 1) {
|
|
148
|
-
const line = lines[index];
|
|
149
|
-
if (line.length === 0)
|
|
150
|
-
continue;
|
|
151
|
-
let value;
|
|
152
|
-
try {
|
|
153
|
-
value = JSON.parse(line);
|
|
154
|
-
}
|
|
155
|
-
catch (error) {
|
|
156
|
-
if (index === lines.length - 1 && !text.endsWith("\n"))
|
|
157
|
-
break;
|
|
158
|
-
throw error;
|
|
159
|
-
}
|
|
160
|
-
if (typeof value !== "object" || value === null)
|
|
161
|
-
continue;
|
|
162
|
-
const record = value;
|
|
163
|
-
const message = typeof record.message === "object" && record.message !== null
|
|
164
|
-
? record.message
|
|
165
|
-
: null;
|
|
166
|
-
if (record.type !== "message" || typeof record.id !== "string" || message === null
|
|
167
|
-
|| typeof message.role !== "string")
|
|
168
|
-
continue;
|
|
169
|
-
const content = message.content;
|
|
170
|
-
const promptText = typeof content === "string" ? content : Array.isArray(content)
|
|
171
|
-
? content.flatMap(part => typeof part === "object" && part !== null
|
|
172
|
-
&& part.type === "text"
|
|
173
|
-
&& typeof part.text === "string"
|
|
174
|
-
? [part.text] : []).join("")
|
|
175
|
-
: "";
|
|
176
|
-
raw.push({
|
|
177
|
-
id: record.id,
|
|
178
|
-
parentId: typeof record.parentId === "string" ? record.parentId : null,
|
|
179
|
-
role: message.role,
|
|
180
|
-
text: promptText,
|
|
181
|
-
});
|
|
182
|
-
}
|
|
183
|
-
const byId = new Map(raw.map(record => [record.id, record]));
|
|
184
|
-
const settled = new Set();
|
|
185
|
-
for (const record of raw) {
|
|
186
|
-
if (record.role !== "assistant")
|
|
187
|
-
continue;
|
|
188
|
-
let parent = record.parentId;
|
|
189
|
-
const visited = new Set();
|
|
190
|
-
while (parent !== null && !visited.has(parent)) {
|
|
191
|
-
visited.add(parent);
|
|
192
|
-
const ancestor = byId.get(parent);
|
|
193
|
-
if (ancestor === undefined)
|
|
194
|
-
break;
|
|
195
|
-
if (ancestor.role === "user") {
|
|
196
|
-
settled.add(ancestor.id);
|
|
197
|
-
break;
|
|
198
|
-
}
|
|
199
|
-
parent = ancestor.parentId;
|
|
200
|
-
}
|
|
201
|
-
}
|
|
202
|
-
return raw
|
|
203
|
-
.filter(record => record.role === "user")
|
|
204
|
-
.map(record => ({ entryId: record.id, text: record.text, settled: settled.has(record.id) }));
|
|
205
|
-
}
|
|
@@ -1,28 +0,0 @@
|
|
|
1
|
-
import { type TerminalHostCommand } from "./ensure-terminal-host.js";
|
|
2
|
-
export interface ResidentReleaseHoldReport {
|
|
3
|
-
/** False when any resident record or identity could not be verified; callers then keep every release. */
|
|
4
|
-
readonly complete: boolean;
|
|
5
|
-
readonly releaseRoots: readonly string[];
|
|
6
|
-
readonly uncertain: readonly string[];
|
|
7
|
-
}
|
|
8
|
-
export interface ResidentReleaseHoldOptions {
|
|
9
|
-
readonly dataDir: string;
|
|
10
|
-
/** Installed release roots whose terminal host may answer, in preference order. */
|
|
11
|
-
readonly releaseRoots: readonly string[];
|
|
12
|
-
readonly platform?: NodeJS.Platform;
|
|
13
|
-
readonly architecture?: string;
|
|
14
|
-
readonly timeoutMs?: number;
|
|
15
|
-
readonly verify?: (addon: string, platform: NodeJS.Platform, architecture: string) => Promise<unknown>;
|
|
16
|
-
readonly run?: (command: TerminalHostCommand, arguments_: readonly string[], timeoutMs: number) => Promise<{
|
|
17
|
-
readonly code: number;
|
|
18
|
-
readonly stdout: string;
|
|
19
|
-
}>;
|
|
20
|
-
}
|
|
21
|
-
/**
|
|
22
|
-
* Reports the releases that live resident processes run from, read-only. The verified terminal
|
|
23
|
-
* host inspects its own records, so pid reuse and identity formats are judged exactly as the
|
|
24
|
-
* server judges them. No records means nothing to hold; any doubt yields an incomplete report.
|
|
25
|
-
*/
|
|
26
|
-
export declare function readResidentReleaseHolds(options: ResidentReleaseHoldOptions): Promise<ResidentReleaseHoldReport>;
|
|
27
|
-
/** The largest release-hold report accepted from the terminal host. */
|
|
28
|
-
export declare const MAX_RELEASE_HOLD_REPORT_BYTES: number;
|
|
@@ -1,78 +0,0 @@
|
|
|
1
|
-
import { readdir } from "node:fs/promises";
|
|
2
|
-
import { resolve } from "node:path";
|
|
3
|
-
import { PRODUCT_IDENTITY } from "../../product-identity.js";
|
|
4
|
-
import { runBoundedHostCommand } from "./bounded-host-command.js";
|
|
5
|
-
import { resolveTerminalHostEntryPath, resolveTerminalHostPath } from "./ensure-terminal-host.js";
|
|
6
|
-
import { verifyTerminalHostArtifact } from "./terminal-host-artifact.js";
|
|
7
|
-
const COMPLETE_EMPTY = Object.freeze({ complete: true, releaseRoots: Object.freeze([]), uncertain: Object.freeze([]) });
|
|
8
|
-
/**
|
|
9
|
-
* Reports the releases that live resident processes run from, read-only. The verified terminal
|
|
10
|
-
* host inspects its own records, so pid reuse and identity formats are judged exactly as the
|
|
11
|
-
* server judges them. No records means nothing to hold; any doubt yields an incomplete report.
|
|
12
|
-
*/
|
|
13
|
-
export async function readResidentReleaseHolds(options) {
|
|
14
|
-
if (!await hasResidentRecords(options.dataDir))
|
|
15
|
-
return COMPLETE_EMPTY;
|
|
16
|
-
const platform = options.platform ?? process.platform;
|
|
17
|
-
const architecture = options.architecture ?? process.arch;
|
|
18
|
-
const verify = options.verify ?? verifyTerminalHostArtifact;
|
|
19
|
-
let command;
|
|
20
|
-
for (const root of options.releaseRoots) {
|
|
21
|
-
const candidate = resolveTerminalHostPath(root, {}, platform, architecture);
|
|
22
|
-
try {
|
|
23
|
-
await verify(candidate, platform, architecture);
|
|
24
|
-
command = { executable: process.execPath, entry: resolveTerminalHostEntryPath(root) };
|
|
25
|
-
break;
|
|
26
|
-
}
|
|
27
|
-
catch {
|
|
28
|
-
// Rationale: an older release may predate the packaged host; another retained release may still carry it.
|
|
29
|
-
}
|
|
30
|
-
}
|
|
31
|
-
if (!command)
|
|
32
|
-
return incomplete("no verified terminal host is installed to inspect resident records");
|
|
33
|
-
try {
|
|
34
|
-
const result = await (options.run ?? runHost)(command, ["release-holds", "--data-dir", options.dataDir], options.timeoutMs ?? 5_000);
|
|
35
|
-
const report = JSON.parse(result.stdout.trim().split(/\r?\n/u).at(-1) ?? "");
|
|
36
|
-
if (result.code !== 0 || report.schema !== "a1-resident-release-holds-v1" || typeof report.complete !== "boolean"
|
|
37
|
-
|| !isStringArray(report.releaseRoots) || !isStringArray(report.uncertain)) {
|
|
38
|
-
return incomplete("terminal host returned no valid release-hold report");
|
|
39
|
-
}
|
|
40
|
-
return { complete: report.complete, releaseRoots: report.releaseRoots, uncertain: report.uncertain };
|
|
41
|
-
}
|
|
42
|
-
catch {
|
|
43
|
-
return incomplete("terminal host release-hold inspection failed");
|
|
44
|
-
}
|
|
45
|
-
}
|
|
46
|
-
async function hasResidentRecords(dataDir) {
|
|
47
|
-
for (const directory of ["tabs", "resident-workspaces"]) {
|
|
48
|
-
try {
|
|
49
|
-
// Invariant: native inspection, not a following stat, judges unknown or linked entries.
|
|
50
|
-
if ((await readdir(resolve(dataDir, directory))).length > 0)
|
|
51
|
-
return true;
|
|
52
|
-
}
|
|
53
|
-
catch (error) {
|
|
54
|
-
if (!(error instanceof Error && "code" in error && error.code === "ENOENT"))
|
|
55
|
-
return true;
|
|
56
|
-
}
|
|
57
|
-
}
|
|
58
|
-
return false;
|
|
59
|
-
}
|
|
60
|
-
function incomplete(reason) {
|
|
61
|
-
return { complete: false, releaseRoots: [], uncertain: [reason] };
|
|
62
|
-
}
|
|
63
|
-
function isStringArray(value) {
|
|
64
|
-
return Array.isArray(value) && value.every(item => typeof item === "string");
|
|
65
|
-
}
|
|
66
|
-
/** The largest release-hold report accepted from the terminal host. */
|
|
67
|
-
export const MAX_RELEASE_HOLD_REPORT_BYTES = 1024 * 1024;
|
|
68
|
-
async function runHost(command, arguments_, timeoutMs) {
|
|
69
|
-
const environment = { ...process.env };
|
|
70
|
-
delete environment[PRODUCT_IDENTITY.environment.developmentInstanceId];
|
|
71
|
-
delete environment[PRODUCT_IDENTITY.environment.terminalHostPath];
|
|
72
|
-
return await runBoundedHostCommand(command, arguments_, {
|
|
73
|
-
environment,
|
|
74
|
-
maxStdoutBytes: MAX_RELEASE_HOLD_REPORT_BYTES,
|
|
75
|
-
timeoutMs,
|
|
76
|
-
label: "terminal host release-hold inspection",
|
|
77
|
-
});
|
|
78
|
-
}
|
|
@@ -1,5 +0,0 @@
|
|
|
1
|
-
/** The owned screens the server opens in a utility tab; each names its tab id stem, `<route>-…`. */
|
|
2
|
-
export type ResidentTabRoute = "settings" | "changelog";
|
|
3
|
-
export declare const RESIDENT_TAB_ROUTES: readonly ResidentTabRoute[];
|
|
4
|
-
/** The utility route whose screen is the resident tab `tabId`, or `null` for an Agent tab. */
|
|
5
|
-
export declare function residentUtilityRoute(tabId: string): ResidentTabRoute | null;
|
|
@@ -1,5 +0,0 @@
|
|
|
1
|
-
export const RESIDENT_TAB_ROUTES = ["settings", "changelog"];
|
|
2
|
-
/** The utility route whose screen is the resident tab `tabId`, or `null` for an Agent tab. */
|
|
3
|
-
export function residentUtilityRoute(tabId) {
|
|
4
|
-
return RESIDENT_TAB_ROUTES.find(route => tabId.startsWith(`${route}-`)) ?? null;
|
|
5
|
-
}
|
|
@@ -1,11 +0,0 @@
|
|
|
1
|
-
import type { EnsureTerminalHostResult } from "./ensure-terminal-host.js";
|
|
2
|
-
export interface ResidentHostSelectionOptions {
|
|
3
|
-
readonly profileId: "a1" | "pi";
|
|
4
|
-
readonly currentLaunchContract: boolean;
|
|
5
|
-
readonly solo: boolean;
|
|
6
|
-
/** Both standard input and standard output are terminals the attach client can own. */
|
|
7
|
-
readonly interactive: boolean;
|
|
8
|
-
readonly ensureHost: () => Promise<EnsureTerminalHostResult>;
|
|
9
|
-
}
|
|
10
|
-
/** Invariant: comparison, solo, and superseded launches stay outside resident discovery and startup. */
|
|
11
|
-
export declare function selectResidentHost(options: ResidentHostSelectionOptions): Promise<EnsureTerminalHostResult | null>;
|
|
@@ -1,10 +0,0 @@
|
|
|
1
|
-
/** Invariant: comparison, solo, and superseded launches stay outside resident discovery and startup. */
|
|
2
|
-
export async function selectResidentHost(options) {
|
|
3
|
-
if (options.profileId !== "a1" || options.solo || !options.currentLaunchContract)
|
|
4
|
-
return null;
|
|
5
|
-
// Platform: the attach client reads the outer terminal's size and owns its raw input, so piped
|
|
6
|
-
// or redirected launches run the direct UI, which already serves non-terminal streams.
|
|
7
|
-
if (!options.interactive)
|
|
8
|
-
return { status: "fallback", reason: "no interactive terminal" };
|
|
9
|
-
return await options.ensureHost();
|
|
10
|
-
}
|
|
@@ -1,38 +0,0 @@
|
|
|
1
|
-
import { type MaintenanceOptions, type MaintenanceReport } from "./maintenance.js";
|
|
2
|
-
/** Mandatory native control semantics; optional methods never establish source authority. */
|
|
3
|
-
export declare const RUNTIME_CONTROL_API = "resident-control-v1";
|
|
4
|
-
export declare const RUNTIME_CONTROL_CORE: readonly ["attach", "tab.list", "tab.view", "input", "resize", "detach", "controller-boundary"];
|
|
5
|
-
export interface RuntimeControlIdentity {
|
|
6
|
-
readonly releaseId: string;
|
|
7
|
-
readonly scope: string;
|
|
8
|
-
readonly epoch: number;
|
|
9
|
-
readonly bootId: string;
|
|
10
|
-
readonly osSessionId: string;
|
|
11
|
-
}
|
|
12
|
-
export interface RuntimeControlDescription extends RuntimeControlIdentity {
|
|
13
|
-
readonly api: typeof RUNTIME_CONTROL_API;
|
|
14
|
-
readonly generation: 1;
|
|
15
|
-
readonly core: readonly string[];
|
|
16
|
-
readonly frameLimit: number;
|
|
17
|
-
readonly inputLimit: number;
|
|
18
|
-
readonly retryInput: false;
|
|
19
|
-
}
|
|
20
|
-
export type RuntimeControlVerdict = {
|
|
21
|
-
readonly status: "compatible";
|
|
22
|
-
readonly contract: RuntimeControlDescription;
|
|
23
|
-
} | {
|
|
24
|
-
readonly status: "blocked";
|
|
25
|
-
readonly reason: "unavailable" | "invalid-contract" | "unsupported-api" | "source-mismatch" | "stale-epoch" | "missing-core";
|
|
26
|
-
};
|
|
27
|
-
/**
|
|
28
|
-
* Validates an authenticated source's descriptor against separately verified source custody.
|
|
29
|
-
* This is not an activation verdict: the caller must also reconcile every live tab and fence
|
|
30
|
-
* changes to that topology before committing a client selection.
|
|
31
|
-
*/
|
|
32
|
-
export declare function assessRuntimeControl(value: unknown, expected: RuntimeControlIdentity): RuntimeControlVerdict;
|
|
33
|
-
export interface ReadRuntimeControlOptions extends Omit<MaintenanceOptions, "action" | "tabId"> {
|
|
34
|
-
readonly expected: RuntimeControlIdentity;
|
|
35
|
-
readonly maintain?: (options: MaintenanceOptions) => Promise<MaintenanceReport>;
|
|
36
|
-
}
|
|
37
|
-
/** A bounded read-only authenticated exchange; it never starts a host or substitutes a release. */
|
|
38
|
-
export declare function readRuntimeControl(options: ReadRuntimeControlOptions): Promise<RuntimeControlVerdict>;
|
|
@@ -1,74 +0,0 @@
|
|
|
1
|
-
import { sameBootIdentity } from "./boot-identity.js";
|
|
2
|
-
import { runTerminalHostMaintenance } from "./maintenance.js";
|
|
3
|
-
/** Mandatory native control semantics; optional methods never establish source authority. */
|
|
4
|
-
export const RUNTIME_CONTROL_API = "resident-control-v1";
|
|
5
|
-
export const RUNTIME_CONTROL_CORE = Object.freeze([
|
|
6
|
-
"attach", "tab.list", "tab.view", "input", "resize", "detach", "controller-boundary",
|
|
7
|
-
]);
|
|
8
|
-
/**
|
|
9
|
-
* Validates an authenticated source's descriptor against separately verified source custody.
|
|
10
|
-
* This is not an activation verdict: the caller must also reconcile every live tab and fence
|
|
11
|
-
* changes to that topology before committing a client selection.
|
|
12
|
-
*/
|
|
13
|
-
export function assessRuntimeControl(value, expected) {
|
|
14
|
-
if (!isRecord(value))
|
|
15
|
-
return blocked("invalid-contract");
|
|
16
|
-
if (value.api !== RUNTIME_CONTROL_API || value.generation !== 1)
|
|
17
|
-
return blocked("unsupported-api");
|
|
18
|
-
if (!identityValid(value) || !identityValid(expected)
|
|
19
|
-
|| !boundedStrings(value.core) || typeof value.retryInput !== "boolean"
|
|
20
|
-
|| !positiveInteger(value.frameLimit, 2 * 1024 * 1024)
|
|
21
|
-
|| !positiveInteger(value.inputLimit, 1024 * 1024) || value.inputLimit > value.frameLimit) {
|
|
22
|
-
return blocked("invalid-contract");
|
|
23
|
-
}
|
|
24
|
-
if (value.releaseId !== expected.releaseId || value.scope !== expected.scope
|
|
25
|
-
|| !sameBootIdentity(value.bootId, expected.bootId) || value.osSessionId !== expected.osSessionId)
|
|
26
|
-
return blocked("source-mismatch");
|
|
27
|
-
if (value.epoch !== expected.epoch)
|
|
28
|
-
return blocked("stale-epoch");
|
|
29
|
-
const core = value.core;
|
|
30
|
-
if (value.retryInput || RUNTIME_CONTROL_CORE.some(method => !core.includes(method)))
|
|
31
|
-
return blocked("missing-core");
|
|
32
|
-
// Security: retain only allowlisted metadata, never arbitrary optional source data.
|
|
33
|
-
return { status: "compatible", contract: Object.freeze({
|
|
34
|
-
api: RUNTIME_CONTROL_API, generation: 1, releaseId: value.releaseId, scope: value.scope,
|
|
35
|
-
epoch: value.epoch, bootId: value.bootId, osSessionId: value.osSessionId,
|
|
36
|
-
core: Object.freeze([...value.core]), frameLimit: value.frameLimit, inputLimit: value.inputLimit,
|
|
37
|
-
retryInput: false,
|
|
38
|
-
}) };
|
|
39
|
-
}
|
|
40
|
-
/** A bounded read-only authenticated exchange; it never starts a host or substitutes a release. */
|
|
41
|
-
export async function readRuntimeControl(options) {
|
|
42
|
-
const { expected, maintain = runTerminalHostMaintenance, ...maintenance } = options;
|
|
43
|
-
try {
|
|
44
|
-
const report = await maintain({ ...maintenance, action: "runtime-control" });
|
|
45
|
-
if (report.schema !== "a1-tabs-maintenance-v1" || report.exitCode !== 0
|
|
46
|
-
|| report.host !== "running" || report.command !== "runtime-control")
|
|
47
|
-
return blocked("unavailable");
|
|
48
|
-
return assessRuntimeControl(report.result, expected);
|
|
49
|
-
}
|
|
50
|
-
catch {
|
|
51
|
-
return blocked("unavailable");
|
|
52
|
-
}
|
|
53
|
-
}
|
|
54
|
-
function blocked(reason) {
|
|
55
|
-
return { status: "blocked", reason };
|
|
56
|
-
}
|
|
57
|
-
function isRecord(value) {
|
|
58
|
-
return value !== null && typeof value === "object" && !Array.isArray(value);
|
|
59
|
-
}
|
|
60
|
-
function positiveInteger(value, maximum = Number.MAX_SAFE_INTEGER) {
|
|
61
|
-
return typeof value === "number" && Number.isSafeInteger(value) && value > 0 && value <= maximum;
|
|
62
|
-
}
|
|
63
|
-
function boundedStrings(value) {
|
|
64
|
-
return Array.isArray(value) && value.length <= 64 && new Set(value).size === value.length
|
|
65
|
-
&& value.every(entry => typeof entry === "string" && entry.length > 0 && entry.length <= 64);
|
|
66
|
-
}
|
|
67
|
-
function identityValid(value) {
|
|
68
|
-
const record = value;
|
|
69
|
-
return typeof record.releaseId === "string" && /^[a-f0-9]{64}$/u.test(record.releaseId)
|
|
70
|
-
&& typeof record.scope === "string" && /^[a-f0-9]{20}$/u.test(record.scope)
|
|
71
|
-
&& positiveInteger(record.epoch)
|
|
72
|
-
&& [record.bootId, record.osSessionId].every(entry => typeof entry === "string" && entry.length > 0
|
|
73
|
-
&& entry.length <= 256 && !/[\x00-\x1f\x7f]/u.test(entry));
|
|
74
|
-
}
|
|
@@ -1,14 +0,0 @@
|
|
|
1
|
-
import type { PromptJournal } from "./prompt-journal.js";
|
|
2
|
-
import { ResidentTabFaultInjection } from "./fault-injection.js";
|
|
3
|
-
export declare function synchronizeSessionFile(path: string, faults?: ResidentTabFaultInjection): Promise<void>;
|
|
4
|
-
/** Serializes settled-turn sync and journal ordering off the input path. */
|
|
5
|
-
export declare class SettledTurnSynchronizer {
|
|
6
|
-
#private;
|
|
7
|
-
constructor(journal: PromptJournal, faults?: ResidentTabFaultInjection);
|
|
8
|
-
settle(sessionFile: string, submissionId: string, entryId: string): Promise<void>;
|
|
9
|
-
settleMany(sessionFile: string, entries: readonly {
|
|
10
|
-
readonly id: string;
|
|
11
|
-
readonly entryId: string;
|
|
12
|
-
}[]): Promise<void>;
|
|
13
|
-
flush(): Promise<void>;
|
|
14
|
-
}
|
|
@@ -1,37 +0,0 @@
|
|
|
1
|
-
import { open } from "node:fs/promises";
|
|
2
|
-
import { ResidentTabFaultInjection } from "./fault-injection.js";
|
|
3
|
-
export async function synchronizeSessionFile(path, faults = new ResidentTabFaultInjection()) {
|
|
4
|
-
const handle = await open(path, "r+");
|
|
5
|
-
try {
|
|
6
|
-
faults.at("session-before-sync");
|
|
7
|
-
await handle.sync();
|
|
8
|
-
faults.at("session-after-sync");
|
|
9
|
-
}
|
|
10
|
-
finally {
|
|
11
|
-
await handle.close();
|
|
12
|
-
}
|
|
13
|
-
}
|
|
14
|
-
/** Serializes settled-turn sync and journal ordering off the input path. */
|
|
15
|
-
export class SettledTurnSynchronizer {
|
|
16
|
-
#journal;
|
|
17
|
-
#faults;
|
|
18
|
-
#queue = Promise.resolve();
|
|
19
|
-
constructor(journal, faults = new ResidentTabFaultInjection()) {
|
|
20
|
-
this.#journal = journal;
|
|
21
|
-
this.#faults = faults;
|
|
22
|
-
}
|
|
23
|
-
settle(sessionFile, submissionId, entryId) {
|
|
24
|
-
return this.settleMany(sessionFile, [{ id: submissionId, entryId }]);
|
|
25
|
-
}
|
|
26
|
-
settleMany(sessionFile, entries) {
|
|
27
|
-
const operation = this.#queue.then(async () => {
|
|
28
|
-
await synchronizeSessionFile(sessionFile, this.#faults);
|
|
29
|
-
this.#faults.at("journal-after-settle-sync");
|
|
30
|
-
for (const entry of entries)
|
|
31
|
-
await this.#journal.settle(entry.id, entry.entryId);
|
|
32
|
-
});
|
|
33
|
-
this.#queue = operation.catch(() => undefined);
|
|
34
|
-
return operation;
|
|
35
|
-
}
|
|
36
|
-
flush() { return this.#queue; }
|
|
37
|
-
}
|
|
@@ -1,16 +0,0 @@
|
|
|
1
|
-
import { OWNED_SETTING_DECLARATIONS } from "../../ui/settings/index.js";
|
|
2
|
-
export declare const RESIDENT_TABS_MAX_CONCURRENT_STARTS = 2;
|
|
3
|
-
export declare const RESIDENT_TABS_MAX_CONCURRENT_STARTS_CAP = 8;
|
|
4
|
-
export declare const RESIDENT_TABS_PREWARM_COUNT = 1;
|
|
5
|
-
export declare const RESIDENT_TABS_PREWARM_CAP = 1;
|
|
6
|
-
type ResidentAccentColor = (typeof OWNED_SETTING_DECLARATIONS.accentColor.allowedValues)[number];
|
|
7
|
-
export interface ResidentTabLaunchSettings {
|
|
8
|
-
readonly accentColor: ResidentAccentColor;
|
|
9
|
-
readonly tabsAutoName: boolean;
|
|
10
|
-
readonly maxConcurrentStarts: number;
|
|
11
|
-
readonly prewarmCount: number;
|
|
12
|
-
readonly unresponsiveRestartSeconds: number;
|
|
13
|
-
}
|
|
14
|
-
/** Read only resident-launch values before any UI or extension module is loaded. */
|
|
15
|
-
export declare function readResidentTabLaunchSettings(profileDir: string, namespace?: string, legacyConfigDir?: string, profileId?: string): Promise<ResidentTabLaunchSettings>;
|
|
16
|
-
export {};
|
|
@@ -1,60 +0,0 @@
|
|
|
1
|
-
import { readFile } from "node:fs/promises";
|
|
2
|
-
import { resolve } from "node:path";
|
|
3
|
-
import { OWNED_SETTING_DECLARATIONS, OWNED_UI_SETTINGS_MIGRATIONS, OWNED_UI_SETTINGS_VERSION, normalizeOwnedUiSettingsValues, parseOwnedUiSettingsDocument, readProfileSettingsNamespace, repairProfileSettingsDocument, resolveOwnedUiSettings, settingValue, } from "../../ui/settings/index.js";
|
|
4
|
-
const MAX_SETTINGS_BYTES = 256 * 1024;
|
|
5
|
-
export const RESIDENT_TABS_MAX_CONCURRENT_STARTS = 2;
|
|
6
|
-
export const RESIDENT_TABS_MAX_CONCURRENT_STARTS_CAP = 8;
|
|
7
|
-
export const RESIDENT_TABS_PREWARM_COUNT = 1;
|
|
8
|
-
export const RESIDENT_TABS_PREWARM_CAP = 1;
|
|
9
|
-
const DEFAULTS = Object.freeze({
|
|
10
|
-
accentColor: "blue",
|
|
11
|
-
tabsAutoName: true,
|
|
12
|
-
maxConcurrentStarts: RESIDENT_TABS_MAX_CONCURRENT_STARTS,
|
|
13
|
-
prewarmCount: RESIDENT_TABS_PREWARM_COUNT,
|
|
14
|
-
unresponsiveRestartSeconds: 120,
|
|
15
|
-
});
|
|
16
|
-
/** Read only resident-launch values before any UI or extension module is loaded. */
|
|
17
|
-
export async function readResidentTabLaunchSettings(profileDir, namespace = "a1", legacyConfigDir, profileId = namespace) {
|
|
18
|
-
const sharedFile = resolve(profileDir, "settings.json");
|
|
19
|
-
try {
|
|
20
|
-
repairProfileSettingsDocument(sharedFile);
|
|
21
|
-
}
|
|
22
|
-
catch {
|
|
23
|
-
// Compatibility: recovery is opportunistic; resident launch falls back when bytes stay invalid.
|
|
24
|
-
}
|
|
25
|
-
const shared = readProfileSettingsNamespace(sharedFile, namespace);
|
|
26
|
-
if (shared.status === "invalid")
|
|
27
|
-
return DEFAULTS;
|
|
28
|
-
if (shared.status === "available") {
|
|
29
|
-
const compatibility = normalizeOwnedUiSettingsValues(shared.value);
|
|
30
|
-
return compatibility.values === null
|
|
31
|
-
? DEFAULTS
|
|
32
|
-
: resolveLaunchValues({ version: OWNED_UI_SETTINGS_VERSION, values: compatibility.values }, []);
|
|
33
|
-
}
|
|
34
|
-
const file = resolve(legacyConfigDir ?? profileDir, "settings", `${profileId}.json`);
|
|
35
|
-
try {
|
|
36
|
-
const raw = await readFile(file, "utf8");
|
|
37
|
-
if (Buffer.byteLength(raw, "utf8") > MAX_SETTINGS_BYTES)
|
|
38
|
-
return DEFAULTS;
|
|
39
|
-
const document = parseOwnedUiSettingsDocument(raw);
|
|
40
|
-
return document === null ? DEFAULTS : resolveLaunchValues(document, OWNED_UI_SETTINGS_MIGRATIONS);
|
|
41
|
-
}
|
|
42
|
-
catch {
|
|
43
|
-
return DEFAULTS;
|
|
44
|
-
}
|
|
45
|
-
}
|
|
46
|
-
function resolveLaunchValues(document, migrations) {
|
|
47
|
-
const resolution = resolveOwnedUiSettings({
|
|
48
|
-
declarations: [OWNED_SETTING_DECLARATIONS.accentColor, OWNED_SETTING_DECLARATIONS.tabsAutoName],
|
|
49
|
-
migrations,
|
|
50
|
-
document,
|
|
51
|
-
currentVersion: OWNED_UI_SETTINGS_VERSION,
|
|
52
|
-
});
|
|
53
|
-
return {
|
|
54
|
-
accentColor: settingValue(resolution, "accentColor"),
|
|
55
|
-
tabsAutoName: settingValue(resolution, "tabsAutoName") === true,
|
|
56
|
-
maxConcurrentStarts: RESIDENT_TABS_MAX_CONCURRENT_STARTS,
|
|
57
|
-
prewarmCount: RESIDENT_TABS_PREWARM_COUNT,
|
|
58
|
-
unresponsiveRestartSeconds: DEFAULTS.unresponsiveRestartSeconds,
|
|
59
|
-
};
|
|
60
|
-
}
|
|
@@ -1,14 +0,0 @@
|
|
|
1
|
-
export declare const TERMINAL_HOST_MANIFEST_FILENAME = "terminal-host.manifest.json";
|
|
2
|
-
export type TerminalHostArtifactErrorCode = "TERMINAL_HOST_ARTIFACT_MISSING" | "TERMINAL_HOST_ARTIFACT_TAMPERED" | "TERMINAL_HOST_ARTIFACT_INCOMPATIBLE" | "TERMINAL_HOST_ARTIFACT_UNSUPPORTED";
|
|
3
|
-
export declare class TerminalHostArtifactError extends Error {
|
|
4
|
-
readonly code: TerminalHostArtifactErrorCode;
|
|
5
|
-
readonly manifestPath: string;
|
|
6
|
-
constructor(code: TerminalHostArtifactErrorCode, manifestPath: string, message: string);
|
|
7
|
-
}
|
|
8
|
-
export interface VerifiedTerminalHostArtifact {
|
|
9
|
-
readonly addon: string;
|
|
10
|
-
readonly entry: string;
|
|
11
|
-
readonly generation: 1;
|
|
12
|
-
}
|
|
13
|
-
/** Verifies every runtime file certified by the terminal-host v2 manifest before Node loads it. */
|
|
14
|
-
export declare function verifyTerminalHostArtifact(addonPath: string, platform?: NodeJS.Platform, architecture?: string): Promise<VerifiedTerminalHostArtifact>;
|