@cuna_labs/cli 0.1.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/LICENSE +201 -0
- package/NOTICE +9 -0
- package/README.md +169 -0
- package/THIRD_PARTY_NOTICES.md +29 -0
- package/dist/api/capability-evidence.d.ts +19 -0
- package/dist/api/capability-evidence.d.ts.map +1 -0
- package/dist/api/capability-evidence.js +38 -0
- package/dist/api/capability-evidence.js.map +1 -0
- package/dist/api/client.d.ts +167 -0
- package/dist/api/client.d.ts.map +1 -0
- package/dist/api/client.js +937 -0
- package/dist/api/client.js.map +1 -0
- package/dist/api/contracts.d.ts +345 -0
- package/dist/api/contracts.d.ts.map +1 -0
- package/dist/api/contracts.js +976 -0
- package/dist/api/contracts.js.map +1 -0
- package/dist/api/execution-workspaces.d.ts +17 -0
- package/dist/api/execution-workspaces.d.ts.map +1 -0
- package/dist/api/execution-workspaces.js +46 -0
- package/dist/api/execution-workspaces.js.map +1 -0
- package/dist/api/http.d.ts +76 -0
- package/dist/api/http.d.ts.map +1 -0
- package/dist/api/http.js +838 -0
- package/dist/api/http.js.map +1 -0
- package/dist/api/managed-executions.d.ts +37 -0
- package/dist/api/managed-executions.d.ts.map +1 -0
- package/dist/api/managed-executions.js +80 -0
- package/dist/api/managed-executions.js.map +1 -0
- package/dist/api/observer-v2-schema.d.ts +206 -0
- package/dist/api/observer-v2-schema.d.ts.map +1 -0
- package/dist/api/observer-v2-schema.js +264 -0
- package/dist/api/observer-v2-schema.js.map +1 -0
- package/dist/api/observer-v2.d.ts +33 -0
- package/dist/api/observer-v2.d.ts.map +1 -0
- package/dist/api/observer-v2.js +60 -0
- package/dist/api/observer-v2.js.map +1 -0
- package/dist/api/owner-observe-grants-v2-schema.d.ts +678 -0
- package/dist/api/owner-observe-grants-v2-schema.d.ts.map +1 -0
- package/dist/api/owner-observe-grants-v2-schema.js +887 -0
- package/dist/api/owner-observe-grants-v2-schema.js.map +1 -0
- package/dist/api/owner-observe-grants-v2.d.ts +268 -0
- package/dist/api/owner-observe-grants-v2.d.ts.map +1 -0
- package/dist/api/owner-observe-grants-v2.js +604 -0
- package/dist/api/owner-observe-grants-v2.js.map +1 -0
- package/dist/api/provider-v2-schema.d.ts +293 -0
- package/dist/api/provider-v2-schema.d.ts.map +1 -0
- package/dist/api/provider-v2-schema.js +381 -0
- package/dist/api/provider-v2-schema.js.map +1 -0
- package/dist/api/provider-v2.d.ts +55 -0
- package/dist/api/provider-v2.d.ts.map +1 -0
- package/dist/api/provider-v2.js +54 -0
- package/dist/api/provider-v2.js.map +1 -0
- package/dist/api/remote-workspace.d.ts +29 -0
- package/dist/api/remote-workspace.d.ts.map +1 -0
- package/dist/api/remote-workspace.js +62 -0
- package/dist/api/remote-workspace.js.map +1 -0
- package/dist/api/supervisor-live-update.d.ts +248 -0
- package/dist/api/supervisor-live-update.d.ts.map +1 -0
- package/dist/api/supervisor-live-update.js +434 -0
- package/dist/api/supervisor-live-update.js.map +1 -0
- package/dist/api/terminal-reason.d.ts +5 -0
- package/dist/api/terminal-reason.d.ts.map +1 -0
- package/dist/api/terminal-reason.js +12 -0
- package/dist/api/terminal-reason.js.map +1 -0
- package/dist/auth/browser-handoff.d.ts +59 -0
- package/dist/auth/browser-handoff.d.ts.map +1 -0
- package/dist/auth/browser-handoff.js +33 -0
- package/dist/auth/browser-handoff.js.map +1 -0
- package/dist/auth/browser.d.ts +11 -0
- package/dist/auth/browser.d.ts.map +1 -0
- package/dist/auth/browser.js +47 -0
- package/dist/auth/browser.js.map +1 -0
- package/dist/auth/human-client.d.ts +39 -0
- package/dist/auth/human-client.d.ts.map +1 -0
- package/dist/auth/human-client.js +66 -0
- package/dist/auth/human-client.js.map +1 -0
- package/dist/auth/human-contracts.d.ts +52 -0
- package/dist/auth/human-contracts.d.ts.map +1 -0
- package/dist/auth/human-contracts.js +229 -0
- package/dist/auth/human-contracts.js.map +1 -0
- package/dist/auth/human-session.d.ts +48 -0
- package/dist/auth/human-session.d.ts.map +1 -0
- package/dist/auth/human-session.js +902 -0
- package/dist/auth/human-session.js.map +1 -0
- package/dist/auth/onboarding-state.d.ts +31 -0
- package/dist/auth/onboarding-state.d.ts.map +1 -0
- package/dist/auth/onboarding-state.js +52 -0
- package/dist/auth/onboarding-state.js.map +1 -0
- package/dist/auth/pkce.d.ts +15 -0
- package/dist/auth/pkce.d.ts.map +1 -0
- package/dist/auth/pkce.js +19 -0
- package/dist/auth/pkce.js.map +1 -0
- package/dist/bin/cuna.d.ts +3 -0
- package/dist/bin/cuna.d.ts.map +1 -0
- package/dist/bin/cuna.js +4 -0
- package/dist/bin/cuna.js.map +1 -0
- package/dist/build-identity.d.ts +20 -0
- package/dist/build-identity.d.ts.map +1 -0
- package/dist/build-identity.js +77 -0
- package/dist/build-identity.js.map +1 -0
- package/dist/cli/command-help.d.ts +9 -0
- package/dist/cli/command-help.d.ts.map +1 -0
- package/dist/cli/command-help.js +324 -0
- package/dist/cli/command-help.js.map +1 -0
- package/dist/cli/help.d.ts +40 -0
- package/dist/cli/help.d.ts.map +1 -0
- package/dist/cli/help.js +256 -0
- package/dist/cli/help.js.map +1 -0
- package/dist/cli/output.d.ts +28 -0
- package/dist/cli/output.d.ts.map +1 -0
- package/dist/cli/output.js +95 -0
- package/dist/cli/output.js.map +1 -0
- package/dist/cli/parser.d.ts +65 -0
- package/dist/cli/parser.d.ts.map +1 -0
- package/dist/cli/parser.js +294 -0
- package/dist/cli/parser.js.map +1 -0
- package/dist/cli/process-entrypoint.d.ts +18 -0
- package/dist/cli/process-entrypoint.d.ts.map +1 -0
- package/dist/cli/process-entrypoint.js +26 -0
- package/dist/cli/process-entrypoint.js.map +1 -0
- package/dist/cli/run.d.ts +114 -0
- package/dist/cli/run.d.ts.map +1 -0
- package/dist/cli/run.js +1969 -0
- package/dist/cli/run.js.map +1 -0
- package/dist/commands/commands.d.ts +74 -0
- package/dist/commands/commands.d.ts.map +1 -0
- package/dist/commands/commands.js +2814 -0
- package/dist/commands/commands.js.map +1 -0
- package/dist/config/config.d.ts +86 -0
- package/dist/config/config.d.ts.map +1 -0
- package/dist/config/config.js +323 -0
- package/dist/config/config.js.map +1 -0
- package/dist/config/infra-contract-witness.d.ts +29 -0
- package/dist/config/infra-contract-witness.d.ts.map +1 -0
- package/dist/config/infra-contract-witness.js +30 -0
- package/dist/config/infra-contract-witness.js.map +1 -0
- package/dist/core/browser-url.d.ts +2 -0
- package/dist/core/browser-url.d.ts.map +1 -0
- package/dist/core/browser-url.js +20 -0
- package/dist/core/browser-url.js.map +1 -0
- package/dist/core/deployed-wire-compatibility.d.ts +15 -0
- package/dist/core/deployed-wire-compatibility.d.ts.map +1 -0
- package/dist/core/deployed-wire-compatibility.js +15 -0
- package/dist/core/deployed-wire-compatibility.js.map +1 -0
- package/dist/core/errors.d.ts +59 -0
- package/dist/core/errors.d.ts.map +1 -0
- package/dist/core/errors.js +82 -0
- package/dist/core/errors.js.map +1 -0
- package/dist/core/exit-codes.d.ts +68 -0
- package/dist/core/exit-codes.d.ts.map +1 -0
- package/dist/core/exit-codes.js +84 -0
- package/dist/core/exit-codes.js.map +1 -0
- package/dist/core/instant.d.ts +60 -0
- package/dist/core/instant.d.ts.map +1 -0
- package/dist/core/instant.js +90 -0
- package/dist/core/instant.js.map +1 -0
- package/dist/core/namespace.d.ts +171 -0
- package/dist/core/namespace.d.ts.map +1 -0
- package/dist/core/namespace.js +227 -0
- package/dist/core/namespace.js.map +1 -0
- package/dist/core/observation-budget.d.ts +185 -0
- package/dist/core/observation-budget.d.ts.map +1 -0
- package/dist/core/observation-budget.js +209 -0
- package/dist/core/observation-budget.js.map +1 -0
- package/dist/core/product-web.d.ts +81 -0
- package/dist/core/product-web.d.ts.map +1 -0
- package/dist/core/product-web.js +87 -0
- package/dist/core/product-web.js.map +1 -0
- package/dist/core/validation.d.ts +90 -0
- package/dist/core/validation.d.ts.map +1 -0
- package/dist/core/validation.js +199 -0
- package/dist/core/validation.js.map +1 -0
- package/dist/credentials/contracts.d.ts +82 -0
- package/dist/credentials/contracts.d.ts.map +1 -0
- package/dist/credentials/contracts.js +2 -0
- package/dist/credentials/contracts.js.map +1 -0
- package/dist/credentials/errors.d.ts +19 -0
- package/dist/credentials/errors.d.ts.map +1 -0
- package/dist/credentials/errors.js +16 -0
- package/dist/credentials/errors.js.map +1 -0
- package/dist/credentials/index.d.ts +6 -0
- package/dist/credentials/index.d.ts.map +1 -0
- package/dist/credentials/index.js +6 -0
- package/dist/credentials/index.js.map +1 -0
- package/dist/credentials/local-session.d.ts +101 -0
- package/dist/credentials/local-session.d.ts.map +1 -0
- package/dist/credentials/local-session.js +839 -0
- package/dist/credentials/local-session.js.map +1 -0
- package/dist/credentials/secret-material.d.ts +17 -0
- package/dist/credentials/secret-material.d.ts.map +1 -0
- package/dist/credentials/secret-material.js +49 -0
- package/dist/credentials/secret-material.js.map +1 -0
- package/dist/credentials/vault.d.ts +41 -0
- package/dist/credentials/vault.d.ts.map +1 -0
- package/dist/credentials/vault.js +719 -0
- package/dist/credentials/vault.js.map +1 -0
- package/dist/daemon/endpoint.d.ts +29 -0
- package/dist/daemon/endpoint.d.ts.map +1 -0
- package/dist/daemon/endpoint.js +66 -0
- package/dist/daemon/endpoint.js.map +1 -0
- package/dist/daemon/journal.d.ts +62 -0
- package/dist/daemon/journal.d.ts.map +1 -0
- package/dist/daemon/journal.js +299 -0
- package/dist/daemon/journal.js.map +1 -0
- package/dist/daemon/lease.d.ts +25 -0
- package/dist/daemon/lease.d.ts.map +1 -0
- package/dist/daemon/lease.js +94 -0
- package/dist/daemon/lease.js.map +1 -0
- package/dist/daemon/lifecycle.d.ts +14 -0
- package/dist/daemon/lifecycle.d.ts.map +1 -0
- package/dist/daemon/lifecycle.js +29 -0
- package/dist/daemon/lifecycle.js.map +1 -0
- package/dist/daemon/protocol.d.ts +65 -0
- package/dist/daemon/protocol.d.ts.map +1 -0
- package/dist/daemon/protocol.js +194 -0
- package/dist/daemon/protocol.js.map +1 -0
- package/dist/daemon/supervisor.d.ts +29 -0
- package/dist/daemon/supervisor.d.ts.map +1 -0
- package/dist/daemon/supervisor.js +87 -0
- package/dist/daemon/supervisor.js.map +1 -0
- package/dist/daemon/views.d.ts +31 -0
- package/dist/daemon/views.d.ts.map +1 -0
- package/dist/daemon/views.js +86 -0
- package/dist/daemon/views.js.map +1 -0
- package/dist/index.d.ts +38 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +38 -0
- package/dist/index.js.map +1 -0
- package/dist/journey/api-effects.d.ts +59 -0
- package/dist/journey/api-effects.d.ts.map +1 -0
- package/dist/journey/api-effects.js +386 -0
- package/dist/journey/api-effects.js.map +1 -0
- package/dist/journey/derived-identity.d.ts +91 -0
- package/dist/journey/derived-identity.d.ts.map +1 -0
- package/dist/journey/derived-identity.js +123 -0
- package/dist/journey/derived-identity.js.map +1 -0
- package/dist/journey/index.d.ts +6 -0
- package/dist/journey/index.d.ts.map +1 -0
- package/dist/journey/index.js +6 -0
- package/dist/journey/index.js.map +1 -0
- package/dist/journey/intent.d.ts +36 -0
- package/dist/journey/intent.d.ts.map +1 -0
- package/dist/journey/intent.js +191 -0
- package/dist/journey/intent.js.map +1 -0
- package/dist/journey/orchestrator.d.ts +140 -0
- package/dist/journey/orchestrator.d.ts.map +1 -0
- package/dist/journey/orchestrator.js +415 -0
- package/dist/journey/orchestrator.js.map +1 -0
- package/dist/journey/provider-launch-intent.d.ts +12 -0
- package/dist/journey/provider-launch-intent.d.ts.map +1 -0
- package/dist/journey/provider-launch-intent.js +40 -0
- package/dist/journey/provider-launch-intent.js.map +1 -0
- package/dist/journey/remote-workspace.d.ts +34 -0
- package/dist/journey/remote-workspace.d.ts.map +1 -0
- package/dist/journey/remote-workspace.js +91 -0
- package/dist/journey/remote-workspace.js.map +1 -0
- package/dist/journey/root-entry.d.ts +56 -0
- package/dist/journey/root-entry.d.ts.map +1 -0
- package/dist/journey/root-entry.js +19 -0
- package/dist/journey/root-entry.js.map +1 -0
- package/dist/journey/selection.d.ts +165 -0
- package/dist/journey/selection.d.ts.map +1 -0
- package/dist/journey/selection.js +565 -0
- package/dist/journey/selection.js.map +1 -0
- package/dist/journey/session-failure.d.ts +4 -0
- package/dist/journey/session-failure.d.ts.map +1 -0
- package/dist/journey/session-failure.js +28 -0
- package/dist/journey/session-failure.js.map +1 -0
- package/dist/journey/workspace-effects.d.ts +30 -0
- package/dist/journey/workspace-effects.d.ts.map +1 -0
- package/dist/journey/workspace-effects.js +348 -0
- package/dist/journey/workspace-effects.js.map +1 -0
- package/dist/local-actions/broker.d.ts +32 -0
- package/dist/local-actions/broker.d.ts.map +1 -0
- package/dist/local-actions/broker.js +400 -0
- package/dist/local-actions/broker.js.map +1 -0
- package/dist/local-actions/browser-action.d.ts +78 -0
- package/dist/local-actions/browser-action.d.ts.map +1 -0
- package/dist/local-actions/browser-action.js +307 -0
- package/dist/local-actions/browser-action.js.map +1 -0
- package/dist/local-actions/callback-relay.d.ts +45 -0
- package/dist/local-actions/callback-relay.d.ts.map +1 -0
- package/dist/local-actions/callback-relay.js +265 -0
- package/dist/local-actions/callback-relay.js.map +1 -0
- package/dist/local-actions/clipboard.d.ts +3 -0
- package/dist/local-actions/clipboard.d.ts.map +1 -0
- package/dist/local-actions/clipboard.js +18 -0
- package/dist/local-actions/clipboard.js.map +1 -0
- package/dist/local-actions/contracts.d.ts +63 -0
- package/dist/local-actions/contracts.d.ts.map +1 -0
- package/dist/local-actions/contracts.js +18 -0
- package/dist/local-actions/contracts.js.map +1 -0
- package/dist/local-actions/desktop-presentation.d.ts +141 -0
- package/dist/local-actions/desktop-presentation.d.ts.map +1 -0
- package/dist/local-actions/desktop-presentation.js +253 -0
- package/dist/local-actions/desktop-presentation.js.map +1 -0
- package/dist/local-actions/device-selection.d.ts +43 -0
- package/dist/local-actions/device-selection.d.ts.map +1 -0
- package/dist/local-actions/device-selection.js +154 -0
- package/dist/local-actions/device-selection.js.map +1 -0
- package/dist/local-actions/executor.d.ts +49 -0
- package/dist/local-actions/executor.d.ts.map +1 -0
- package/dist/local-actions/executor.js +329 -0
- package/dist/local-actions/executor.js.map +1 -0
- package/dist/local-actions/file-transfers.d.ts +141 -0
- package/dist/local-actions/file-transfers.d.ts.map +1 -0
- package/dist/local-actions/file-transfers.js +446 -0
- package/dist/local-actions/file-transfers.js.map +1 -0
- package/dist/local-actions/foreground-notifications.d.ts +45 -0
- package/dist/local-actions/foreground-notifications.d.ts.map +1 -0
- package/dist/local-actions/foreground-notifications.js +163 -0
- package/dist/local-actions/foreground-notifications.js.map +1 -0
- package/dist/local-actions/git-signing.d.ts +39 -0
- package/dist/local-actions/git-signing.d.ts.map +1 -0
- package/dist/local-actions/git-signing.js +135 -0
- package/dist/local-actions/git-signing.js.map +1 -0
- package/dist/local-actions/index.d.ts +19 -0
- package/dist/local-actions/index.d.ts.map +1 -0
- package/dist/local-actions/index.js +19 -0
- package/dist/local-actions/index.js.map +1 -0
- package/dist/local-actions/local-service-actions.d.ts +87 -0
- package/dist/local-actions/local-service-actions.d.ts.map +1 -0
- package/dist/local-actions/local-service-actions.js +347 -0
- package/dist/local-actions/local-service-actions.js.map +1 -0
- package/dist/local-actions/loopback.d.ts +5 -0
- package/dist/local-actions/loopback.d.ts.map +1 -0
- package/dist/local-actions/loopback.js +15 -0
- package/dist/local-actions/loopback.js.map +1 -0
- package/dist/local-actions/policy-store.d.ts +7 -0
- package/dist/local-actions/policy-store.d.ts.map +1 -0
- package/dist/local-actions/policy-store.js +70 -0
- package/dist/local-actions/policy-store.js.map +1 -0
- package/dist/local-actions/policy.d.ts +21 -0
- package/dist/local-actions/policy.d.ts.map +1 -0
- package/dist/local-actions/policy.js +43 -0
- package/dist/local-actions/policy.js.map +1 -0
- package/dist/local-actions/private-port-forward.d.ts +36 -0
- package/dist/local-actions/private-port-forward.d.ts.map +1 -0
- package/dist/local-actions/private-port-forward.js +154 -0
- package/dist/local-actions/private-port-forward.js.map +1 -0
- package/dist/local-actions/provider-mcp-config.d.ts +101 -0
- package/dist/local-actions/provider-mcp-config.d.ts.map +1 -0
- package/dist/local-actions/provider-mcp-config.js +166 -0
- package/dist/local-actions/provider-mcp-config.js.map +1 -0
- package/dist/local-actions/providers.d.ts +12 -0
- package/dist/local-actions/providers.d.ts.map +1 -0
- package/dist/local-actions/providers.js +42 -0
- package/dist/local-actions/providers.js.map +1 -0
- package/dist/local-actions/schemas.d.ts +4 -0
- package/dist/local-actions/schemas.d.ts.map +1 -0
- package/dist/local-actions/schemas.js +314 -0
- package/dist/local-actions/schemas.js.map +1 -0
- package/dist/local-actions/sensitive-consent.d.ts +32 -0
- package/dist/local-actions/sensitive-consent.d.ts.map +1 -0
- package/dist/local-actions/sensitive-consent.js +47 -0
- package/dist/local-actions/sensitive-consent.js.map +1 -0
- package/dist/machines/command-launch.d.ts +17 -0
- package/dist/machines/command-launch.d.ts.map +1 -0
- package/dist/machines/command-launch.js +52 -0
- package/dist/machines/command-launch.js.map +1 -0
- package/dist/machines/execution-receipt.d.ts +18 -0
- package/dist/machines/execution-receipt.d.ts.map +1 -0
- package/dist/machines/execution-receipt.js +87 -0
- package/dist/machines/execution-receipt.js.map +1 -0
- package/dist/machines/executions-screen.d.ts +6 -0
- package/dist/machines/executions-screen.d.ts.map +1 -0
- package/dist/machines/executions-screen.js +410 -0
- package/dist/machines/executions-screen.js.map +1 -0
- package/dist/machines/explorer.d.ts +75 -0
- package/dist/machines/explorer.d.ts.map +1 -0
- package/dist/machines/explorer.js +1726 -0
- package/dist/machines/explorer.js.map +1 -0
- package/dist/machines/live-supervisor-update.d.ts +325 -0
- package/dist/machines/live-supervisor-update.d.ts.map +1 -0
- package/dist/machines/live-supervisor-update.js +513 -0
- package/dist/machines/live-supervisor-update.js.map +1 -0
- package/dist/machines/machine-first.d.ts +123 -0
- package/dist/machines/machine-first.d.ts.map +1 -0
- package/dist/machines/machine-first.js +119 -0
- package/dist/machines/machine-first.js.map +1 -0
- package/dist/machines/opencode-supervisor.d.ts +51 -0
- package/dist/machines/opencode-supervisor.d.ts.map +1 -0
- package/dist/machines/opencode-supervisor.js +124 -0
- package/dist/machines/opencode-supervisor.js.map +1 -0
- package/dist/machines/pagination.d.ts +4 -0
- package/dist/machines/pagination.d.ts.map +1 -0
- package/dist/machines/pagination.js +7 -0
- package/dist/machines/pagination.js.map +1 -0
- package/dist/machines/provider-availability.d.ts +42 -0
- package/dist/machines/provider-availability.d.ts.map +1 -0
- package/dist/machines/provider-availability.js +82 -0
- package/dist/machines/provider-availability.js.map +1 -0
- package/dist/machines/provider-screen.d.ts +12 -0
- package/dist/machines/provider-screen.d.ts.map +1 -0
- package/dist/machines/provider-screen.js +129 -0
- package/dist/machines/provider-screen.js.map +1 -0
- package/dist/machines/session-actionability.d.ts +86 -0
- package/dist/machines/session-actionability.d.ts.map +1 -0
- package/dist/machines/session-actionability.js +125 -0
- package/dist/machines/session-actionability.js.map +1 -0
- package/dist/machines/session-visibility.d.ts +139 -0
- package/dist/machines/session-visibility.d.ts.map +1 -0
- package/dist/machines/session-visibility.js +109 -0
- package/dist/machines/session-visibility.js.map +1 -0
- package/dist/platform/adapter.d.ts +62 -0
- package/dist/platform/adapter.d.ts.map +1 -0
- package/dist/platform/adapter.js +240 -0
- package/dist/platform/adapter.js.map +1 -0
- package/dist/platform/support.d.ts +12 -0
- package/dist/platform/support.d.ts.map +1 -0
- package/dist/platform/support.js +25 -0
- package/dist/platform/support.js.map +1 -0
- package/dist/pty/contracts.d.ts +45 -0
- package/dist/pty/contracts.d.ts.map +1 -0
- package/dist/pty/contracts.js +2 -0
- package/dist/pty/contracts.js.map +1 -0
- package/dist/pty/evidence-gate.d.ts +14 -0
- package/dist/pty/evidence-gate.d.ts.map +1 -0
- package/dist/pty/evidence-gate.js +35 -0
- package/dist/pty/evidence-gate.js.map +1 -0
- package/dist/pty/index.d.ts +5 -0
- package/dist/pty/index.d.ts.map +1 -0
- package/dist/pty/index.js +5 -0
- package/dist/pty/index.js.map +1 -0
- package/dist/pty/node-host-terminal.d.ts +14 -0
- package/dist/pty/node-host-terminal.d.ts.map +1 -0
- package/dist/pty/node-host-terminal.js +173 -0
- package/dist/pty/node-host-terminal.js.map +1 -0
- package/dist/pty/node-process.d.ts +26 -0
- package/dist/pty/node-process.d.ts.map +1 -0
- package/dist/pty/node-process.js +102 -0
- package/dist/pty/node-process.js.map +1 -0
- package/dist/runtime/api-terminal-control-plane.d.ts +7 -0
- package/dist/runtime/api-terminal-control-plane.d.ts.map +1 -0
- package/dist/runtime/api-terminal-control-plane.js +95 -0
- package/dist/runtime/api-terminal-control-plane.js.map +1 -0
- package/dist/runtime/backoff.d.ts +17 -0
- package/dist/runtime/backoff.d.ts.map +1 -0
- package/dist/runtime/backoff.js +61 -0
- package/dist/runtime/backoff.js.map +1 -0
- package/dist/runtime/boundary.d.ts +171 -0
- package/dist/runtime/boundary.d.ts.map +1 -0
- package/dist/runtime/boundary.js +1858 -0
- package/dist/runtime/boundary.js.map +1 -0
- package/dist/runtime/capability-gate.d.ts +25 -0
- package/dist/runtime/capability-gate.d.ts.map +1 -0
- package/dist/runtime/capability-gate.js +77 -0
- package/dist/runtime/capability-gate.js.map +1 -0
- package/dist/runtime/contracts.d.ts +25 -0
- package/dist/runtime/contracts.d.ts.map +1 -0
- package/dist/runtime/contracts.js +66 -0
- package/dist/runtime/contracts.js.map +1 -0
- package/dist/runtime/errors.d.ts +20 -0
- package/dist/runtime/errors.d.ts.map +1 -0
- package/dist/runtime/errors.js +22 -0
- package/dist/runtime/errors.js.map +1 -0
- package/dist/runtime/index.d.ts +9 -0
- package/dist/runtime/index.d.ts.map +1 -0
- package/dist/runtime/index.js +9 -0
- package/dist/runtime/index.js.map +1 -0
- package/dist/runtime/node-foreground-session.d.ts +50 -0
- package/dist/runtime/node-foreground-session.d.ts.map +1 -0
- package/dist/runtime/node-foreground-session.js +431 -0
- package/dist/runtime/node-foreground-session.js.map +1 -0
- package/dist/runtime/node-websocket-connector.d.ts +6 -0
- package/dist/runtime/node-websocket-connector.d.ts.map +1 -0
- package/dist/runtime/node-websocket-connector.js +344 -0
- package/dist/runtime/node-websocket-connector.js.map +1 -0
- package/dist/runtime/observer-screen.d.ts +6 -0
- package/dist/runtime/observer-screen.d.ts.map +1 -0
- package/dist/runtime/observer-screen.js +144 -0
- package/dist/runtime/observer-screen.js.map +1 -0
- package/dist/runtime/owner-grant-operations.d.ts +136 -0
- package/dist/runtime/owner-grant-operations.d.ts.map +1 -0
- package/dist/runtime/owner-grant-operations.js +216 -0
- package/dist/runtime/owner-grant-operations.js.map +1 -0
- package/dist/runtime/owner-grants-screen.d.ts +40 -0
- package/dist/runtime/owner-grants-screen.d.ts.map +1 -0
- package/dist/runtime/owner-grants-screen.js +987 -0
- package/dist/runtime/owner-grants-screen.js.map +1 -0
- package/dist/runtime/terminal-transport.d.ts +85 -0
- package/dist/runtime/terminal-transport.d.ts.map +1 -0
- package/dist/runtime/terminal-transport.js +152 -0
- package/dist/runtime/terminal-transport.js.map +1 -0
- package/dist/sync/continuous-sync-supervisor.d.ts +107 -0
- package/dist/sync/continuous-sync-supervisor.d.ts.map +1 -0
- package/dist/sync/continuous-sync-supervisor.js +1117 -0
- package/dist/sync/continuous-sync-supervisor.js.map +1 -0
- package/dist/sync/index.d.ts +9 -0
- package/dist/sync/index.d.ts.map +1 -0
- package/dist/sync/index.js +9 -0
- package/dist/sync/index.js.map +1 -0
- package/dist/sync/journal.d.ts +57 -0
- package/dist/sync/journal.d.ts.map +1 -0
- package/dist/sync/journal.js +685 -0
- package/dist/sync/journal.js.map +1 -0
- package/dist/sync/revisions.d.ts +118 -0
- package/dist/sync/revisions.d.ts.map +1 -0
- package/dist/sync/revisions.js +364 -0
- package/dist/sync/revisions.js.map +1 -0
- package/dist/sync/supervisor.d.ts +107 -0
- package/dist/sync/supervisor.d.ts.map +1 -0
- package/dist/sync/supervisor.js +246 -0
- package/dist/sync/supervisor.js.map +1 -0
- package/dist/sync/workspace-sync-client.d.ts +18 -0
- package/dist/sync/workspace-sync-client.d.ts.map +1 -0
- package/dist/sync/workspace-sync-client.js +150 -0
- package/dist/sync/workspace-sync-client.js.map +1 -0
- package/dist/sync/workspace-sync-coordinator.d.ts +76 -0
- package/dist/sync/workspace-sync-coordinator.d.ts.map +1 -0
- package/dist/sync/workspace-sync-coordinator.js +621 -0
- package/dist/sync/workspace-sync-coordinator.js.map +1 -0
- package/dist/sync/workspace-sync-product-service.d.ts +79 -0
- package/dist/sync/workspace-sync-product-service.d.ts.map +1 -0
- package/dist/sync/workspace-sync-product-service.js +398 -0
- package/dist/sync/workspace-sync-product-service.js.map +1 -0
- package/dist/sync/workspace-sync-protocol.d.ts +145 -0
- package/dist/sync/workspace-sync-protocol.d.ts.map +1 -0
- package/dist/sync/workspace-sync-protocol.js +347 -0
- package/dist/sync/workspace-sync-protocol.js.map +1 -0
- package/dist/terminal/appbar.d.ts +40 -0
- package/dist/terminal/appbar.d.ts.map +1 -0
- package/dist/terminal/appbar.js +55 -0
- package/dist/terminal/appbar.js.map +1 -0
- package/dist/terminal/cell-width.d.ts +3 -0
- package/dist/terminal/cell-width.d.ts.map +1 -0
- package/dist/terminal/cell-width.js +53 -0
- package/dist/terminal/cell-width.js.map +1 -0
- package/dist/terminal/codec.d.ts +107 -0
- package/dist/terminal/codec.d.ts.map +1 -0
- package/dist/terminal/codec.js +538 -0
- package/dist/terminal/codec.js.map +1 -0
- package/dist/terminal/foreground.d.ts +135 -0
- package/dist/terminal/foreground.d.ts.map +1 -0
- package/dist/terminal/foreground.js +2097 -0
- package/dist/terminal/foreground.js.map +1 -0
- package/dist/terminal/generated/terminal-wire-v1.d.ts +26 -0
- package/dist/terminal/generated/terminal-wire-v1.d.ts.map +1 -0
- package/dist/terminal/generated/terminal-wire-v1.js +27 -0
- package/dist/terminal/generated/terminal-wire-v1.js.map +1 -0
- package/dist/terminal/mode.d.ts +33 -0
- package/dist/terminal/mode.d.ts.map +1 -0
- package/dist/terminal/mode.js +99 -0
- package/dist/terminal/mode.js.map +1 -0
- package/dist/terminal/passthrough.d.ts +47 -0
- package/dist/terminal/passthrough.d.ts.map +1 -0
- package/dist/terminal/passthrough.js +666 -0
- package/dist/terminal/passthrough.js.map +1 -0
- package/dist/terminal/resume.d.ts +58 -0
- package/dist/terminal/resume.d.ts.map +1 -0
- package/dist/terminal/resume.js +185 -0
- package/dist/terminal/resume.js.map +1 -0
- package/dist/terminal/viewport.d.ts +93 -0
- package/dist/terminal/viewport.d.ts.map +1 -0
- package/dist/terminal/viewport.js +266 -0
- package/dist/terminal/viewport.js.map +1 -0
- package/dist/terminal/workbench.d.ts +32 -0
- package/dist/terminal/workbench.d.ts.map +1 -0
- package/dist/terminal/workbench.js +316 -0
- package/dist/terminal/workbench.js.map +1 -0
- package/dist/terminal/xterm-vte.d.ts +49 -0
- package/dist/terminal/xterm-vte.d.ts.map +1 -0
- package/dist/terminal/xterm-vte.js +602 -0
- package/dist/terminal/xterm-vte.js.map +1 -0
- package/dist/version.d.ts +3 -0
- package/dist/version.d.ts.map +1 -0
- package/dist/version.js +3 -0
- package/dist/version.js.map +1 -0
- package/dist/workspace/binding-path.d.ts +17 -0
- package/dist/workspace/binding-path.d.ts.map +1 -0
- package/dist/workspace/binding-path.js +91 -0
- package/dist/workspace/binding-path.js.map +1 -0
- package/dist/workspace/binding-store.d.ts +107 -0
- package/dist/workspace/binding-store.d.ts.map +1 -0
- package/dist/workspace/binding-store.js +783 -0
- package/dist/workspace/binding-store.js.map +1 -0
- package/dist/workspace/binding.d.ts +35 -0
- package/dist/workspace/binding.d.ts.map +1 -0
- package/dist/workspace/binding.js +70 -0
- package/dist/workspace/binding.js.map +1 -0
- package/dist/workspace/errors.d.ts +4 -0
- package/dist/workspace/errors.d.ts.map +1 -0
- package/dist/workspace/errors.js +19 -0
- package/dist/workspace/errors.js.map +1 -0
- package/dist/workspace/exclusion.d.ts +21 -0
- package/dist/workspace/exclusion.d.ts.map +1 -0
- package/dist/workspace/exclusion.js +243 -0
- package/dist/workspace/exclusion.js.map +1 -0
- package/dist/workspace/index.d.ts +8 -0
- package/dist/workspace/index.d.ts.map +1 -0
- package/dist/workspace/index.js +8 -0
- package/dist/workspace/index.js.map +1 -0
- package/dist/workspace/lifecycle.d.ts +56 -0
- package/dist/workspace/lifecycle.d.ts.map +1 -0
- package/dist/workspace/lifecycle.js +94 -0
- package/dist/workspace/lifecycle.js.map +1 -0
- package/dist/workspace/manifest.d.ts +47 -0
- package/dist/workspace/manifest.d.ts.map +1 -0
- package/dist/workspace/manifest.js +243 -0
- package/dist/workspace/manifest.js.map +1 -0
- package/dist/workspace/paths.d.ts +14 -0
- package/dist/workspace/paths.d.ts.map +1 -0
- package/dist/workspace/paths.js +67 -0
- package/dist/workspace/paths.js.map +1 -0
- package/dist/workspace/schema.d.ts +15 -0
- package/dist/workspace/schema.d.ts.map +1 -0
- package/dist/workspace/schema.js +33 -0
- package/dist/workspace/schema.js.map +1 -0
- package/dist/workspace/selection-screen.d.ts +4 -0
- package/dist/workspace/selection-screen.d.ts.map +1 -0
- package/dist/workspace/selection-screen.js +216 -0
- package/dist/workspace/selection-screen.js.map +1 -0
- package/dist/workspace/selection-service.d.ts +16 -0
- package/dist/workspace/selection-service.d.ts.map +1 -0
- package/dist/workspace/selection-service.js +65 -0
- package/dist/workspace/selection-service.js.map +1 -0
- package/node_modules/@xterm/headless/README.md +31 -0
- package/node_modules/@xterm/headless/lib-headless/xterm-headless.js +2 -0
- package/node_modules/@xterm/headless/lib-headless/xterm-headless.js.map +1 -0
- package/node_modules/@xterm/headless/lib-headless/xterm-headless.mjs +46 -0
- package/node_modules/@xterm/headless/lib-headless/xterm-headless.mjs.map +7 -0
- package/node_modules/@xterm/headless/package.json +29 -0
- package/node_modules/@xterm/headless/typings/xterm-headless.d.ts +1385 -0
- package/package.json +75 -0
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
export class LeaseError extends Error {
|
|
2
|
+
code;
|
|
3
|
+
constructor(code, message) {
|
|
4
|
+
super(message);
|
|
5
|
+
this.name = "LeaseError";
|
|
6
|
+
this.code = code;
|
|
7
|
+
}
|
|
8
|
+
}
|
|
9
|
+
export class FencedLeaseStore {
|
|
10
|
+
#clock;
|
|
11
|
+
#records = new Map();
|
|
12
|
+
#lastGeneration = new Map();
|
|
13
|
+
constructor(clock = Date.now) {
|
|
14
|
+
this.#clock = clock;
|
|
15
|
+
}
|
|
16
|
+
acquire(resourceId, ownerId, ttlMs) {
|
|
17
|
+
assertIdentifier(resourceId, "resourceId");
|
|
18
|
+
assertIdentifier(ownerId, "ownerId");
|
|
19
|
+
assertTtl(ttlMs);
|
|
20
|
+
const now = this.#clock();
|
|
21
|
+
const current = this.#records.get(resourceId);
|
|
22
|
+
if (current !== undefined && !current.released && current.expiresAt > now) {
|
|
23
|
+
if (current.ownerId === ownerId)
|
|
24
|
+
return snapshot(resourceId, current, now);
|
|
25
|
+
throw new LeaseError("lease_conflict", "Another writer holds the active lease.");
|
|
26
|
+
}
|
|
27
|
+
const generation = (this.#lastGeneration.get(resourceId) ?? 0) + 1;
|
|
28
|
+
const next = { ownerId, generation, acquiredAt: now, expiresAt: now + ttlMs, released: false };
|
|
29
|
+
this.#records.set(resourceId, next);
|
|
30
|
+
this.#lastGeneration.set(resourceId, generation);
|
|
31
|
+
return snapshot(resourceId, next, now);
|
|
32
|
+
}
|
|
33
|
+
renew(token, ttlMs) {
|
|
34
|
+
assertTtl(ttlMs);
|
|
35
|
+
const current = this.#assertCurrent(token);
|
|
36
|
+
const now = this.#clock();
|
|
37
|
+
if (current.expiresAt <= now) {
|
|
38
|
+
throw new LeaseError("lease_expired", "The writer lease has expired and must be reacquired.");
|
|
39
|
+
}
|
|
40
|
+
current.expiresAt = now + ttlMs;
|
|
41
|
+
return snapshot(token.resourceId, current, now);
|
|
42
|
+
}
|
|
43
|
+
release(token) {
|
|
44
|
+
const current = this.#assertCurrent(token);
|
|
45
|
+
const now = this.#clock();
|
|
46
|
+
if (current.expiresAt <= now) {
|
|
47
|
+
throw new LeaseError("lease_expired", "The writer lease expired before release.");
|
|
48
|
+
}
|
|
49
|
+
current.released = true;
|
|
50
|
+
return snapshot(token.resourceId, current, now);
|
|
51
|
+
}
|
|
52
|
+
assertWriter(token) {
|
|
53
|
+
const current = this.#assertCurrent(token);
|
|
54
|
+
if (current.expiresAt <= this.#clock()) {
|
|
55
|
+
throw new LeaseError("lease_expired", "The writer lease is no longer active.");
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
inspect(resourceId) {
|
|
59
|
+
const record = this.#records.get(resourceId);
|
|
60
|
+
return record === undefined ? undefined : snapshot(resourceId, record, this.#clock());
|
|
61
|
+
}
|
|
62
|
+
#assertCurrent(token) {
|
|
63
|
+
const current = this.#records.get(token.resourceId);
|
|
64
|
+
if (current === undefined ||
|
|
65
|
+
current.released ||
|
|
66
|
+
current.ownerId !== token.ownerId ||
|
|
67
|
+
current.generation !== token.generation) {
|
|
68
|
+
throw new LeaseError("stale_fence", "The writer fence is stale or no longer owns the resource.");
|
|
69
|
+
}
|
|
70
|
+
return current;
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
function snapshot(resourceId, record, now) {
|
|
74
|
+
const state = record.released ? "released" : record.expiresAt <= now ? "expired" : "active";
|
|
75
|
+
return Object.freeze({
|
|
76
|
+
resourceId,
|
|
77
|
+
ownerId: record.ownerId,
|
|
78
|
+
generation: record.generation,
|
|
79
|
+
state,
|
|
80
|
+
acquiredAt: record.acquiredAt,
|
|
81
|
+
expiresAt: record.expiresAt,
|
|
82
|
+
});
|
|
83
|
+
}
|
|
84
|
+
function assertIdentifier(value, name) {
|
|
85
|
+
if (value.length === 0 || value.length > 256 || value.includes("\0")) {
|
|
86
|
+
throw new LeaseError("invalid_lease", `${name} is invalid.`);
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
function assertTtl(ttlMs) {
|
|
90
|
+
if (!Number.isSafeInteger(ttlMs) || ttlMs < 100 || ttlMs > 5 * 60_000) {
|
|
91
|
+
throw new LeaseError("invalid_lease", "The lease TTL is outside the supported bounds.");
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
//# sourceMappingURL=lease.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"lease.js","sourceRoot":"","sources":["../../src/daemon/lease.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
export type DaemonLifecycleState = "absent" | "starting" | "ready" | "quiescing" | "degraded" | "reconciling" | "recovery_required" | "stopped";
|
|
2
|
+
export interface DaemonLifecycleSnapshot {
|
|
3
|
+
readonly state: DaemonLifecycleState;
|
|
4
|
+
readonly revision: number;
|
|
5
|
+
readonly observedAt: number;
|
|
6
|
+
readonly reason: string;
|
|
7
|
+
}
|
|
8
|
+
export declare class DaemonLifecycle {
|
|
9
|
+
#private;
|
|
10
|
+
constructor(now: number);
|
|
11
|
+
snapshot(): DaemonLifecycleSnapshot;
|
|
12
|
+
transition(state: DaemonLifecycleState, reason: string, now: number): DaemonLifecycleSnapshot;
|
|
13
|
+
}
|
|
14
|
+
//# sourceMappingURL=lifecycle.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/daemon/lifecycle.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAC5B,QAAQ,GACR,UAAU,GACV,OAAO,GACP,WAAW,GACX,UAAU,GACV,aAAa,GACb,mBAAmB,GACnB,SAAS,CAAC;AAad,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,eAAe;;gBAGd,GAAG,EAAE,MAAM;IAIvB,QAAQ,IAAI,uBAAuB;IAInC,UAAU,CAAC,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,uBAAuB;CAQ9F"}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
const TRANSITIONS = Object.freeze({
|
|
2
|
+
absent: new Set(["starting"]),
|
|
3
|
+
starting: new Set(["ready", "recovery_required", "stopped"]),
|
|
4
|
+
ready: new Set(["quiescing", "degraded"]),
|
|
5
|
+
quiescing: new Set(["ready", "stopped", "recovery_required"]),
|
|
6
|
+
degraded: new Set(["reconciling", "quiescing", "recovery_required"]),
|
|
7
|
+
reconciling: new Set(["ready", "recovery_required", "quiescing"]),
|
|
8
|
+
recovery_required: new Set(["ready", "stopped"]),
|
|
9
|
+
stopped: new Set(["starting"]),
|
|
10
|
+
});
|
|
11
|
+
export class DaemonLifecycle {
|
|
12
|
+
#snapshot;
|
|
13
|
+
constructor(now) {
|
|
14
|
+
this.#snapshot = Object.freeze({ state: "absent", revision: 0, observedAt: now, reason: "not_started" });
|
|
15
|
+
}
|
|
16
|
+
snapshot() {
|
|
17
|
+
return this.#snapshot;
|
|
18
|
+
}
|
|
19
|
+
transition(state, reason, now) {
|
|
20
|
+
if (!TRANSITIONS[this.#snapshot.state].has(state)) {
|
|
21
|
+
throw new Error(`Illegal daemon lifecycle transition: ${this.#snapshot.state} -> ${state}`);
|
|
22
|
+
}
|
|
23
|
+
if (reason.length === 0 || reason.length > 128)
|
|
24
|
+
throw new Error("A bounded safe daemon lifecycle reason is required.");
|
|
25
|
+
this.#snapshot = Object.freeze({ state, revision: this.#snapshot.revision + 1, observedAt: now, reason });
|
|
26
|
+
return this.#snapshot;
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
//# sourceMappingURL=lifecycle.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/daemon/lifecycle.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,GAA8E,MAAM,CAAC,MAAM,CAAC;IAC3G,MAAM,EAAE,IAAI,GAAG,CAAuB,CAAC,UAAU,CAAC,CAAC;IACnD,QAAQ,EAAE,IAAI,GAAG,CAAuB,CAAC,OAAO,EAAE,mBAAmB,EAAE,SAAS,CAAC,CAAC;IAClF,KAAK,EAAE,IAAI,GAAG,CAAuB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IAC/D,SAAS,EAAE,IAAI,GAAG,CAAuB,CAAC,OAAO,EAAE,SAAS,EAAE,mBAAmB,CAAC,CAAC;IACnF,QAAQ,EAAE,IAAI,GAAG,CAAuB,CAAC,aAAa,EAAE,WAAW,EAAE,mBAAmB,CAAC,CAAC;IAC1F,WAAW,EAAE,IAAI,GAAG,CAAuB,CAAC,OAAO,EAAE,mBAAmB,EAAE,WAAW,CAAC,CAAC;IACvF,iBAAiB,EAAE,IAAI,GAAG,CAAuB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACtE,OAAO,EAAE,IAAI,GAAG,CAAuB,CAAC,UAAU,CAAC,CAAC;CACrD,CAAC,CAAC;AASH,MAAM,OAAO,eAAe;IAC1B,SAAS,CAA0B;IAEnC,YAAY,GAAW;QACrB,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;IAC3G,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,UAAU,CAAC,KAA2B,EAAE,MAAc,EAAE,GAAW;QACjE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,CAAC,SAAS,CAAC,KAAK,OAAO,KAAK,EAAE,CAAC,CAAC;QAC9F,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACvH,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,GAAG,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;QAC1G,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;CACF"}
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
export declare const DAEMON_PROTOCOL: "cuna.daemon.v1";
|
|
2
|
+
export declare const DAEMON_PROTOCOL_VERSION: 1;
|
|
3
|
+
export declare const MAX_IPC_FRAME_BYTES: number;
|
|
4
|
+
export declare const MAX_IPC_BUFFER_BYTES: number;
|
|
5
|
+
export declare const MAX_IPC_QUEUED_FRAMES = 64;
|
|
6
|
+
export declare const IPC_FRAME_TYPES: Readonly<{
|
|
7
|
+
readonly hello: 1;
|
|
8
|
+
readonly welcome: 2;
|
|
9
|
+
readonly request: 3;
|
|
10
|
+
readonly response: 4;
|
|
11
|
+
readonly event: 5;
|
|
12
|
+
readonly cancel: 6;
|
|
13
|
+
readonly heartbeat: 7;
|
|
14
|
+
readonly error: 8;
|
|
15
|
+
}>;
|
|
16
|
+
export type IpcFrameType = keyof typeof IPC_FRAME_TYPES;
|
|
17
|
+
export type IpcProtocolErrorCode = "invalid_magic" | "unsupported_version" | "oversize_frame" | "buffer_limit" | "queue_limit" | "unknown_critical_frame" | "malformed_frame" | "invalid_message";
|
|
18
|
+
export declare class IpcProtocolError extends Error {
|
|
19
|
+
readonly code: IpcProtocolErrorCode;
|
|
20
|
+
constructor(code: IpcProtocolErrorCode, message: string);
|
|
21
|
+
}
|
|
22
|
+
export interface IpcFrame {
|
|
23
|
+
readonly type: IpcFrameType;
|
|
24
|
+
readonly critical: boolean;
|
|
25
|
+
readonly payload: Uint8Array;
|
|
26
|
+
}
|
|
27
|
+
export interface DecodedIpcFrame extends IpcFrame {
|
|
28
|
+
readonly wireVersion: typeof DAEMON_PROTOCOL_VERSION;
|
|
29
|
+
}
|
|
30
|
+
export interface IpcHello {
|
|
31
|
+
readonly kind: "hello";
|
|
32
|
+
readonly minimumVersion: number;
|
|
33
|
+
readonly maximumVersion: number;
|
|
34
|
+
readonly clientInstanceId: string;
|
|
35
|
+
}
|
|
36
|
+
export interface IpcWelcome {
|
|
37
|
+
readonly kind: "welcome";
|
|
38
|
+
readonly selectedVersion: typeof DAEMON_PROTOCOL_VERSION;
|
|
39
|
+
readonly daemonInstanceId: string;
|
|
40
|
+
}
|
|
41
|
+
export interface IpcRequest {
|
|
42
|
+
readonly kind: "request";
|
|
43
|
+
readonly requestId: string;
|
|
44
|
+
readonly operation: "lease.acquire" | "lease.renew" | "lease.release" | "intent.record" | "intent.reconcile" | "view.open" | "view.select" | "view.close" | "supervisor.inspect";
|
|
45
|
+
readonly body: Readonly<Record<string, unknown>>;
|
|
46
|
+
}
|
|
47
|
+
export interface IpcResponse {
|
|
48
|
+
readonly kind: "response";
|
|
49
|
+
readonly requestId: string;
|
|
50
|
+
readonly outcome: "accepted" | "rejected" | "unknown" | "reconciling";
|
|
51
|
+
readonly body?: Readonly<Record<string, unknown>>;
|
|
52
|
+
readonly reason?: string;
|
|
53
|
+
}
|
|
54
|
+
export type IpcMessage = IpcHello | IpcWelcome | IpcRequest | IpcResponse;
|
|
55
|
+
export declare function encodeIpcFrame(frame: IpcFrame): Uint8Array;
|
|
56
|
+
export declare function encodeIpcMessage(message: IpcMessage): Uint8Array;
|
|
57
|
+
export declare function decodeIpcFrame(bytes: Uint8Array): DecodedIpcFrame | undefined;
|
|
58
|
+
export declare function decodeIpcMessage(frame: DecodedIpcFrame): IpcMessage;
|
|
59
|
+
export declare function negotiateDaemonProtocol(minimumVersion: number, maximumVersion: number): typeof DAEMON_PROTOCOL_VERSION;
|
|
60
|
+
export declare class IpcFrameDecoder {
|
|
61
|
+
#private;
|
|
62
|
+
push(chunk: Uint8Array): readonly DecodedIpcFrame[];
|
|
63
|
+
get bufferedBytes(): number;
|
|
64
|
+
}
|
|
65
|
+
//# sourceMappingURL=protocol.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/daemon/protocol.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,194 @@
|
|
|
1
|
+
import { TextDecoder, TextEncoder } from "node:util";
|
|
2
|
+
export const DAEMON_PROTOCOL = "cuna.daemon.v1";
|
|
3
|
+
export const DAEMON_PROTOCOL_VERSION = 1;
|
|
4
|
+
export const MAX_IPC_FRAME_BYTES = 1024 * 1024;
|
|
5
|
+
export const MAX_IPC_BUFFER_BYTES = MAX_IPC_FRAME_BYTES * 2;
|
|
6
|
+
export const MAX_IPC_QUEUED_FRAMES = 64;
|
|
7
|
+
const HEADER_BYTES = 12;
|
|
8
|
+
const MAGIC = Uint8Array.of(0x52, 0x49, 0x50, 0x43); // RIPC
|
|
9
|
+
const CRITICAL_FLAG = 0x01;
|
|
10
|
+
export const IPC_FRAME_TYPES = Object.freeze({
|
|
11
|
+
hello: 1,
|
|
12
|
+
welcome: 2,
|
|
13
|
+
request: 3,
|
|
14
|
+
response: 4,
|
|
15
|
+
event: 5,
|
|
16
|
+
cancel: 6,
|
|
17
|
+
heartbeat: 7,
|
|
18
|
+
error: 8,
|
|
19
|
+
});
|
|
20
|
+
const TYPE_NAMES = new Map(Object.entries(IPC_FRAME_TYPES).map(([name, code]) => [code, name]));
|
|
21
|
+
export class IpcProtocolError extends Error {
|
|
22
|
+
code;
|
|
23
|
+
constructor(code, message) {
|
|
24
|
+
super(message);
|
|
25
|
+
this.name = "IpcProtocolError";
|
|
26
|
+
this.code = code;
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
const encoder = new TextEncoder();
|
|
30
|
+
const decoder = new TextDecoder("utf-8", { fatal: true });
|
|
31
|
+
function frameTypeCode(type) {
|
|
32
|
+
return IPC_FRAME_TYPES[type];
|
|
33
|
+
}
|
|
34
|
+
export function encodeIpcFrame(frame) {
|
|
35
|
+
if (frame.payload.byteLength > MAX_IPC_FRAME_BYTES) {
|
|
36
|
+
throw new IpcProtocolError("oversize_frame", "The IPC payload exceeds the protocol limit.");
|
|
37
|
+
}
|
|
38
|
+
const bytes = new Uint8Array(HEADER_BYTES + frame.payload.byteLength);
|
|
39
|
+
bytes.set(MAGIC, 0);
|
|
40
|
+
const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
|
|
41
|
+
view.setUint8(4, DAEMON_PROTOCOL_VERSION);
|
|
42
|
+
view.setUint8(5, frame.critical ? CRITICAL_FLAG : 0);
|
|
43
|
+
view.setUint16(6, frameTypeCode(frame.type), false);
|
|
44
|
+
view.setUint32(8, frame.payload.byteLength, false);
|
|
45
|
+
bytes.set(frame.payload, HEADER_BYTES);
|
|
46
|
+
return bytes;
|
|
47
|
+
}
|
|
48
|
+
export function encodeIpcMessage(message) {
|
|
49
|
+
const type = message.kind;
|
|
50
|
+
return encodeIpcFrame({ type, critical: true, payload: encoder.encode(JSON.stringify(message)) });
|
|
51
|
+
}
|
|
52
|
+
function hasMagic(bytes) {
|
|
53
|
+
return MAGIC.every((value, index) => bytes[index] === value);
|
|
54
|
+
}
|
|
55
|
+
function parseHeader(bytes) {
|
|
56
|
+
if (bytes.byteLength < HEADER_BYTES) {
|
|
57
|
+
throw new IpcProtocolError("malformed_frame", "The IPC frame header is incomplete.");
|
|
58
|
+
}
|
|
59
|
+
if (!hasMagic(bytes)) {
|
|
60
|
+
throw new IpcProtocolError("invalid_magic", "The IPC frame magic is invalid.");
|
|
61
|
+
}
|
|
62
|
+
const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
|
|
63
|
+
if (view.getUint8(4) !== DAEMON_PROTOCOL_VERSION) {
|
|
64
|
+
throw new IpcProtocolError("unsupported_version", "The IPC wire version is unsupported.");
|
|
65
|
+
}
|
|
66
|
+
const flags = view.getUint8(5);
|
|
67
|
+
if ((flags & ~CRITICAL_FLAG) !== 0) {
|
|
68
|
+
throw new IpcProtocolError("malformed_frame", "The IPC frame contains unsupported flags.");
|
|
69
|
+
}
|
|
70
|
+
const length = view.getUint32(8, false);
|
|
71
|
+
if (length > MAX_IPC_FRAME_BYTES) {
|
|
72
|
+
throw new IpcProtocolError("oversize_frame", "The IPC payload exceeds the protocol limit.");
|
|
73
|
+
}
|
|
74
|
+
return { typeCode: view.getUint16(6, false), critical: (flags & CRITICAL_FLAG) !== 0, length };
|
|
75
|
+
}
|
|
76
|
+
export function decodeIpcFrame(bytes) {
|
|
77
|
+
const header = parseHeader(bytes);
|
|
78
|
+
if (bytes.byteLength !== HEADER_BYTES + header.length) {
|
|
79
|
+
throw new IpcProtocolError("malformed_frame", "The IPC frame length does not match its payload.");
|
|
80
|
+
}
|
|
81
|
+
const type = TYPE_NAMES.get(header.typeCode);
|
|
82
|
+
if (type === undefined) {
|
|
83
|
+
if (header.critical) {
|
|
84
|
+
throw new IpcProtocolError("unknown_critical_frame", "The IPC frame type is unknown and critical.");
|
|
85
|
+
}
|
|
86
|
+
return undefined;
|
|
87
|
+
}
|
|
88
|
+
return {
|
|
89
|
+
type,
|
|
90
|
+
critical: header.critical,
|
|
91
|
+
payload: bytes.slice(HEADER_BYTES),
|
|
92
|
+
wireVersion: DAEMON_PROTOCOL_VERSION,
|
|
93
|
+
};
|
|
94
|
+
}
|
|
95
|
+
function isRecord(value) {
|
|
96
|
+
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
97
|
+
}
|
|
98
|
+
function isSafeIdentifier(value) {
|
|
99
|
+
return typeof value === "string" && value.length >= 1 && value.length <= 128 && /^[A-Za-z0-9._:-]+$/u.test(value);
|
|
100
|
+
}
|
|
101
|
+
export function decodeIpcMessage(frame) {
|
|
102
|
+
let value;
|
|
103
|
+
try {
|
|
104
|
+
value = JSON.parse(decoder.decode(frame.payload));
|
|
105
|
+
}
|
|
106
|
+
catch {
|
|
107
|
+
throw new IpcProtocolError("invalid_message", "The IPC message is not valid UTF-8 JSON.");
|
|
108
|
+
}
|
|
109
|
+
if (!isRecord(value) || value.kind !== frame.type) {
|
|
110
|
+
throw new IpcProtocolError("invalid_message", "The IPC message kind does not match its frame type.");
|
|
111
|
+
}
|
|
112
|
+
switch (value.kind) {
|
|
113
|
+
case "hello":
|
|
114
|
+
if (!Number.isSafeInteger(value.minimumVersion) ||
|
|
115
|
+
!Number.isSafeInteger(value.maximumVersion) ||
|
|
116
|
+
!isSafeIdentifier(value.clientInstanceId)) {
|
|
117
|
+
throw new IpcProtocolError("invalid_message", "The IPC hello message is malformed.");
|
|
118
|
+
}
|
|
119
|
+
return value;
|
|
120
|
+
case "welcome":
|
|
121
|
+
if (value.selectedVersion !== DAEMON_PROTOCOL_VERSION || !isSafeIdentifier(value.daemonInstanceId)) {
|
|
122
|
+
throw new IpcProtocolError("invalid_message", "The IPC welcome message is malformed.");
|
|
123
|
+
}
|
|
124
|
+
return value;
|
|
125
|
+
case "request":
|
|
126
|
+
if (!isSafeIdentifier(value.requestId) || typeof value.operation !== "string" || !isRecord(value.body)) {
|
|
127
|
+
throw new IpcProtocolError("invalid_message", "The IPC request is malformed.");
|
|
128
|
+
}
|
|
129
|
+
if (!REQUEST_OPERATIONS.has(value.operation)) {
|
|
130
|
+
throw new IpcProtocolError("invalid_message", "The IPC request operation is not allowlisted.");
|
|
131
|
+
}
|
|
132
|
+
return value;
|
|
133
|
+
case "response":
|
|
134
|
+
if (!isSafeIdentifier(value.requestId) || !RESPONSE_OUTCOMES.has(String(value.outcome))) {
|
|
135
|
+
throw new IpcProtocolError("invalid_message", "The IPC response is malformed.");
|
|
136
|
+
}
|
|
137
|
+
return value;
|
|
138
|
+
default:
|
|
139
|
+
throw new IpcProtocolError("invalid_message", "This IPC message has no structured decoder.");
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
const REQUEST_OPERATIONS = new Set([
|
|
143
|
+
"lease.acquire",
|
|
144
|
+
"lease.renew",
|
|
145
|
+
"lease.release",
|
|
146
|
+
"intent.record",
|
|
147
|
+
"intent.reconcile",
|
|
148
|
+
"view.open",
|
|
149
|
+
"view.select",
|
|
150
|
+
"view.close",
|
|
151
|
+
"supervisor.inspect",
|
|
152
|
+
]);
|
|
153
|
+
const RESPONSE_OUTCOMES = new Set(["accepted", "rejected", "unknown", "reconciling"]);
|
|
154
|
+
export function negotiateDaemonProtocol(minimumVersion, maximumVersion) {
|
|
155
|
+
if (!Number.isSafeInteger(minimumVersion) ||
|
|
156
|
+
!Number.isSafeInteger(maximumVersion) ||
|
|
157
|
+
minimumVersion > maximumVersion ||
|
|
158
|
+
minimumVersion > DAEMON_PROTOCOL_VERSION ||
|
|
159
|
+
maximumVersion < DAEMON_PROTOCOL_VERSION) {
|
|
160
|
+
throw new IpcProtocolError("unsupported_version", "No compatible daemon IPC protocol version exists.");
|
|
161
|
+
}
|
|
162
|
+
return DAEMON_PROTOCOL_VERSION;
|
|
163
|
+
}
|
|
164
|
+
export class IpcFrameDecoder {
|
|
165
|
+
#buffer = new Uint8Array(0);
|
|
166
|
+
push(chunk) {
|
|
167
|
+
if (chunk.byteLength + this.#buffer.byteLength > MAX_IPC_BUFFER_BYTES) {
|
|
168
|
+
throw new IpcProtocolError("buffer_limit", "The IPC receive buffer limit was exceeded.");
|
|
169
|
+
}
|
|
170
|
+
const joined = new Uint8Array(this.#buffer.byteLength + chunk.byteLength);
|
|
171
|
+
joined.set(this.#buffer, 0);
|
|
172
|
+
joined.set(chunk, this.#buffer.byteLength);
|
|
173
|
+
this.#buffer = joined;
|
|
174
|
+
const frames = [];
|
|
175
|
+
while (this.#buffer.byteLength >= HEADER_BYTES) {
|
|
176
|
+
const header = parseHeader(this.#buffer);
|
|
177
|
+
const frameLength = HEADER_BYTES + header.length;
|
|
178
|
+
if (this.#buffer.byteLength < frameLength)
|
|
179
|
+
break;
|
|
180
|
+
const decoded = decodeIpcFrame(this.#buffer.slice(0, frameLength));
|
|
181
|
+
this.#buffer = this.#buffer.slice(frameLength);
|
|
182
|
+
if (decoded !== undefined)
|
|
183
|
+
frames.push(decoded);
|
|
184
|
+
if (frames.length > MAX_IPC_QUEUED_FRAMES) {
|
|
185
|
+
throw new IpcProtocolError("queue_limit", "Too many IPC frames were decoded in one batch.");
|
|
186
|
+
}
|
|
187
|
+
}
|
|
188
|
+
return frames;
|
|
189
|
+
}
|
|
190
|
+
get bufferedBytes() {
|
|
191
|
+
return this.#buffer.byteLength;
|
|
192
|
+
}
|
|
193
|
+
}
|
|
194
|
+
//# sourceMappingURL=protocol.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/daemon/protocol.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
export type SupervisedProcessState = "starting" | "ready" | "running" | "terminating" | "exited" | "failed" | "terminated";
|
|
2
|
+
export interface ProcessIdentity {
|
|
3
|
+
readonly agentSessionId: string;
|
|
4
|
+
readonly processEpoch: string;
|
|
5
|
+
}
|
|
6
|
+
export interface ProcessSnapshot extends ProcessIdentity {
|
|
7
|
+
readonly state: SupervisedProcessState;
|
|
8
|
+
readonly operatingSystemPid?: number;
|
|
9
|
+
readonly startedAt: number;
|
|
10
|
+
readonly updatedAt: number;
|
|
11
|
+
readonly exitCode?: number;
|
|
12
|
+
readonly failureReason?: string;
|
|
13
|
+
}
|
|
14
|
+
export declare class SupervisorError extends Error {
|
|
15
|
+
readonly code: "duplicate_process" | "unknown_process" | "invalid_transition" | "identity_mismatch";
|
|
16
|
+
constructor(code: SupervisorError["code"], message: string);
|
|
17
|
+
}
|
|
18
|
+
export declare class ProcessSupervisorModel {
|
|
19
|
+
#private;
|
|
20
|
+
register(identity: ProcessIdentity, now: number, operatingSystemPid?: number): ProcessSnapshot;
|
|
21
|
+
transition(identity: ProcessIdentity, nextState: SupervisedProcessState, now: number, details?: {
|
|
22
|
+
readonly exitCode?: number;
|
|
23
|
+
readonly failureReason?: string;
|
|
24
|
+
}): ProcessSnapshot;
|
|
25
|
+
require(identity: ProcessIdentity): ProcessSnapshot;
|
|
26
|
+
list(): readonly ProcessSnapshot[];
|
|
27
|
+
}
|
|
28
|
+
export declare function isTerminal(state: SupervisedProcessState): boolean;
|
|
29
|
+
//# sourceMappingURL=supervisor.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"supervisor.d.ts","sourceRoot":"","sources":["../../src/daemon/supervisor.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAC9B,UAAU,GACV,OAAO,GACP,SAAS,GACT,aAAa,GACb,QAAQ,GACR,QAAQ,GACR,YAAY,CAAC;AAEjB,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAC;IACvC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,GAAG,iBAAiB,GAAG,oBAAoB,GAAG,mBAAmB,CAAC;gBAExF,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM;CAK3D;AAYD,qBAAa,sBAAsB;;IAGjC,QAAQ,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,MAAM,GAAG,eAAe;IAiB9F,UAAU,CACR,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,sBAAsB,EACjC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAO,GAC5E,eAAe;IAuBlB,OAAO,CAAC,QAAQ,EAAE,eAAe,GAAG,eAAe;IAUnD,IAAI,IAAI,SAAS,eAAe,EAAE;CAGnC;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAEjE"}
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
export class SupervisorError extends Error {
|
|
2
|
+
code;
|
|
3
|
+
constructor(code, message) {
|
|
4
|
+
super(message);
|
|
5
|
+
this.name = "SupervisorError";
|
|
6
|
+
this.code = code;
|
|
7
|
+
}
|
|
8
|
+
}
|
|
9
|
+
const TRANSITIONS = Object.freeze({
|
|
10
|
+
starting: new Set(["ready", "failed", "terminating"]),
|
|
11
|
+
ready: new Set(["running", "terminating", "exited", "failed"]),
|
|
12
|
+
running: new Set(["terminating", "exited", "failed"]),
|
|
13
|
+
terminating: new Set(["terminated", "failed"]),
|
|
14
|
+
exited: new Set(),
|
|
15
|
+
failed: new Set(),
|
|
16
|
+
terminated: new Set(),
|
|
17
|
+
});
|
|
18
|
+
export class ProcessSupervisorModel {
|
|
19
|
+
#processes = new Map();
|
|
20
|
+
register(identity, now, operatingSystemPid) {
|
|
21
|
+
assertIdentity(identity);
|
|
22
|
+
const current = this.#processes.get(identity.agentSessionId);
|
|
23
|
+
if (current !== undefined && !isTerminal(current.state)) {
|
|
24
|
+
throw new SupervisorError("duplicate_process", "An active process already exists for this AgentSession.");
|
|
25
|
+
}
|
|
26
|
+
const next = freezeSnapshot({
|
|
27
|
+
...identity,
|
|
28
|
+
state: "starting",
|
|
29
|
+
...(operatingSystemPid === undefined ? {} : { operatingSystemPid }),
|
|
30
|
+
startedAt: now,
|
|
31
|
+
updatedAt: now,
|
|
32
|
+
});
|
|
33
|
+
this.#processes.set(identity.agentSessionId, next);
|
|
34
|
+
return next;
|
|
35
|
+
}
|
|
36
|
+
transition(identity, nextState, now, details = {}) {
|
|
37
|
+
const current = this.require(identity);
|
|
38
|
+
if (current.state === nextState)
|
|
39
|
+
return current;
|
|
40
|
+
if (!TRANSITIONS[current.state].has(nextState)) {
|
|
41
|
+
throw new SupervisorError("invalid_transition", `Process cannot transition from ${current.state} to ${nextState}.`);
|
|
42
|
+
}
|
|
43
|
+
if ((nextState === "exited" || nextState === "terminated") && details.failureReason !== undefined) {
|
|
44
|
+
throw new SupervisorError("invalid_transition", "A successful terminal state cannot carry a failure reason.");
|
|
45
|
+
}
|
|
46
|
+
if (nextState === "failed" && (details.failureReason === undefined || details.failureReason.length === 0)) {
|
|
47
|
+
throw new SupervisorError("invalid_transition", "A failed process requires a safe reason class.");
|
|
48
|
+
}
|
|
49
|
+
const next = freezeSnapshot({
|
|
50
|
+
...current,
|
|
51
|
+
state: nextState,
|
|
52
|
+
updatedAt: now,
|
|
53
|
+
...(details.exitCode === undefined ? {} : { exitCode: details.exitCode }),
|
|
54
|
+
...(details.failureReason === undefined ? {} : { failureReason: details.failureReason }),
|
|
55
|
+
});
|
|
56
|
+
this.#processes.set(identity.agentSessionId, next);
|
|
57
|
+
return next;
|
|
58
|
+
}
|
|
59
|
+
require(identity) {
|
|
60
|
+
const current = this.#processes.get(identity.agentSessionId);
|
|
61
|
+
if (current === undefined)
|
|
62
|
+
throw new SupervisorError("unknown_process", "The AgentSession process is not supervised.");
|
|
63
|
+
// A PID may be reused. Epoch equality, not PID equality, proves continuity.
|
|
64
|
+
if (current.processEpoch !== identity.processEpoch) {
|
|
65
|
+
throw new SupervisorError("identity_mismatch", "The process epoch does not match the supervised generation.");
|
|
66
|
+
}
|
|
67
|
+
return current;
|
|
68
|
+
}
|
|
69
|
+
list() {
|
|
70
|
+
return Object.freeze([...this.#processes.values()]);
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
export function isTerminal(state) {
|
|
74
|
+
return state === "exited" || state === "failed" || state === "terminated";
|
|
75
|
+
}
|
|
76
|
+
function assertIdentity(identity) {
|
|
77
|
+
if (identity.agentSessionId.length === 0 ||
|
|
78
|
+
identity.agentSessionId.length > 256 ||
|
|
79
|
+
identity.processEpoch.length === 0 ||
|
|
80
|
+
identity.processEpoch.length > 256) {
|
|
81
|
+
throw new SupervisorError("identity_mismatch", "The process identity is invalid.");
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
function freezeSnapshot(snapshot) {
|
|
85
|
+
return Object.freeze(snapshot);
|
|
86
|
+
}
|
|
87
|
+
//# sourceMappingURL=supervisor.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"supervisor.js","sourceRoot":"","sources":["../../src/daemon/supervisor.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
export interface SessionBinding {
|
|
2
|
+
readonly userId: string;
|
|
3
|
+
readonly machineId: string;
|
|
4
|
+
readonly agentSessionId: string;
|
|
5
|
+
readonly processEpoch: string;
|
|
6
|
+
readonly fencingGeneration: number;
|
|
7
|
+
}
|
|
8
|
+
export type LocalViewState = "active" | "navigation" | "detached";
|
|
9
|
+
export interface LocalClientView {
|
|
10
|
+
readonly viewId: string;
|
|
11
|
+
readonly binding: SessionBinding;
|
|
12
|
+
readonly state: LocalViewState;
|
|
13
|
+
readonly columns: number;
|
|
14
|
+
readonly rows: number;
|
|
15
|
+
}
|
|
16
|
+
export declare class ViewIsolationError extends Error {
|
|
17
|
+
readonly code: "duplicate_view" | "unknown_view" | "stale_fence" | "navigation_active" | "invalid_view";
|
|
18
|
+
constructor(code: ViewIsolationError["code"], message: string);
|
|
19
|
+
}
|
|
20
|
+
export declare class LocalClientViewRegistry {
|
|
21
|
+
#private;
|
|
22
|
+
open(input: LocalClientView): LocalClientView;
|
|
23
|
+
enterNavigation(viewId: string): LocalClientView;
|
|
24
|
+
leaveNavigation(viewId: string): LocalClientView;
|
|
25
|
+
resize(viewId: string, columns: number, rows: number): LocalClientView;
|
|
26
|
+
detach(viewId: string): LocalClientView;
|
|
27
|
+
routeInput(viewId: string, presentedFence: number): SessionBinding;
|
|
28
|
+
require(viewId: string): LocalClientView;
|
|
29
|
+
list(): readonly LocalClientView[];
|
|
30
|
+
}
|
|
31
|
+
//# sourceMappingURL=views.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"views.d.ts","sourceRoot":"","sources":["../../src/daemon/views.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,CAAC;AAElE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,cAAc,GAAG,aAAa,GAAG,mBAAmB,GAAG,cAAc,CAAC;gBAE5F,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM;CAK9D;AAED,qBAAa,uBAAuB;;IAGlC,IAAI,CAAC,KAAK,EAAE,eAAe,GAAG,eAAe;IAQ7C,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe;IAIhD,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe;IAIhD,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe;IAKtE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe;IAIvC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,cAAc;IAYlE,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe;IAMxC,IAAI,IAAI,SAAS,eAAe,EAAE;CAWnC"}
|