@astrale-os/cli 1.0.0-beta.32 → 1.0.0-beta.43
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +928 -0
- package/README.md +53 -43
- package/THIRD-PARTY-NOTICES.md +37 -1
- package/dist/astrale.js +349631 -83669
- package/dist/public/connect-core.js +16 -47
- package/dist/public/keys/index.js +1 -1
- package/dist/types/admin/contract.d.ts +11 -0
- package/dist/types/admin/graph/index.d.ts +1 -0
- package/dist/types/admin/graph/nodes.d.ts +12 -0
- package/dist/types/admin/instance/client.d.ts +2 -0
- package/dist/types/connection/lifetime.d.ts +1 -1
- package/dist/types/errors.d.ts +3 -0
- package/dist/types/lib/proc.d.ts +1 -0
- package/dist/types/lib/update.d.ts +15 -7
- package/package.json +8 -6
- package/studio/client/dist/assets/index-5C1uT6ML.css +2 -0
- package/studio/client/dist/assets/index-C4kNlvwF.js +80 -0
- package/studio/client/dist/assets/schema-studio-BR9d0faB.js +8 -0
- package/studio/client/dist/index.html +13 -2
- package/studio/package.json +2 -1
- package/studio/server/agent/ask.test.ts +7 -1
- package/studio/server/agent/bridge/grant.ts +15 -3
- package/studio/server/agent/prompts/system.test.ts +5 -0
- package/studio/server/agent/prompts/system.ts +19 -4
- package/studio/server/agent/routes.test.ts +39 -1
- package/studio/server/agent/routes.ts +3 -0
- package/studio/server/agent/run/coordinator.test.ts +7 -1
- package/studio/server/agent/run/preparation.ts +1 -0
- package/studio/server/agent/run/transcript.test.ts +47 -2
- package/studio/server/agent/run/transcript.ts +32 -3
- package/studio/server/api/documents.test.ts +31 -0
- package/studio/server/api/documents.ts +35 -1
- package/studio/server/api-agent-loadout.test.ts +7 -1
- package/studio/server/api.test.ts +7 -1
- package/studio/server/cache.ts +4 -4
- package/studio/server/detect.ts +9 -12
- package/studio/server/domain.test.ts +83 -3
- package/studio/server/domain.ts +205 -27
- package/studio/server/handoff/service.ts +1 -1
- package/studio/server/index.ts +5 -8
- package/studio/server/introspect/extractor.ts +111 -17
- package/studio/server/introspect/overlay-tsmorph.test.ts +9 -9
- package/studio/server/introspect/overlay.ts +1 -1
- package/studio/server/introspect/runtime.ts +9 -1
- package/studio/server/introspect/source-overlay/spans.ts +2 -5
- package/studio/server/lifecycle.ts +1 -1
- package/studio/server/state/baseline.test.ts +14 -0
- package/studio/server/state/baseline.ts +16 -2
- package/studio/server/watch.test.ts +2 -1
- package/studio/server/watch.ts +5 -2
- package/studio/server/workspace/create.ts +9 -8
- package/studio/server/workspace-state.ts +4 -6
- package/studio/server/workspace-watch.ts +33 -22
- package/studio/shared/contracts/agent.ts +3 -0
- package/viewer/dist/main.js +12 -12
- package/src/__tests__/fixtures/publication.ts +0 -20
- package/src/admin/.spec/api.d.ts +0 -3
- package/src/admin/.spec/architecture.md +0 -22
- package/src/admin/.spec/icon.svg +0 -3
- package/src/admin/.spec/layout.ts +0 -6
- package/src/admin/__tests__/fixture.ts +0 -25
- package/src/admin/catalog/.spec/api.d.ts +0 -63
- package/src/admin/catalog/.spec/architecture.md +0 -7
- package/src/admin/catalog/.spec/icon.svg +0 -3
- package/src/admin/catalog/.spec/layout.ts +0 -6
- package/src/admin/catalog/__tests__/client.test.ts +0 -245
- package/src/admin/catalog/client.ts +0 -195
- package/src/admin/catalog/index.ts +0 -13
- package/src/admin/catalog/model.ts +0 -41
- package/src/admin/catalog/tsconfig.json +0 -8
- package/src/admin/contract.ts +0 -47
- package/src/admin/graph/.spec/api.d.ts +0 -22
- package/src/admin/graph/.spec/architecture.md +0 -5
- package/src/admin/graph/.spec/icon.svg +0 -3
- package/src/admin/graph/.spec/layout.ts +0 -3
- package/src/admin/graph/index.ts +0 -6
- package/src/admin/graph/nodes.ts +0 -56
- package/src/admin/index.ts +0 -2
- package/src/admin/instance/.spec/api.d.ts +0 -62
- package/src/admin/instance/.spec/architecture.md +0 -10
- package/src/admin/instance/.spec/icon.svg +0 -3
- package/src/admin/instance/.spec/layout.ts +0 -6
- package/src/admin/instance/__tests__/client.test.ts +0 -273
- package/src/admin/instance/client.ts +0 -191
- package/src/admin/instance/index.ts +0 -15
- package/src/admin/instance/model.ts +0 -59
- package/src/admin/instance/tsconfig.json +0 -8
- package/src/commands/__tests__/admin-instance.test.ts +0 -91
- package/src/commands/__tests__/auth-login.test.ts +0 -231
- package/src/commands/__tests__/auth-token.test.ts +0 -223
- package/src/commands/__tests__/call-describe.test.ts +0 -80
- package/src/commands/__tests__/call.test.ts +0 -63
- package/src/commands/__tests__/domain-install-operation.test.ts +0 -145
- package/src/commands/__tests__/domain-install-owned.test.ts +0 -191
- package/src/commands/__tests__/domain-list.test.ts +0 -133
- package/src/commands/__tests__/domain-uninstall.test.ts +0 -53
- package/src/commands/__tests__/install-direct.test.ts +0 -128
- package/src/commands/__tests__/install-identity-override.test.ts +0 -76
- package/src/commands/__tests__/instance-bookmark.test.ts +0 -166
- package/src/commands/__tests__/instance-list-admin.test.ts +0 -26
- package/src/commands/__tests__/instance-list-rows.test.ts +0 -64
- package/src/commands/__tests__/instance-status.test.ts +0 -139
- package/src/commands/__tests__/instance-use.test.ts +0 -67
- package/src/commands/__tests__/introspect-parse.test.ts +0 -100
- package/src/commands/__tests__/logs.test.ts +0 -345
- package/src/commands/__tests__/read-commands.test.ts +0 -377
- package/src/commands/__tests__/setup-plan.test.ts +0 -61
- package/src/commands/__tests__/studio-descriptor.test.ts +0 -22
- package/src/commands/__tests__/token-ttl.test.ts +0 -66
- package/src/commands/__tests__/update.test.ts +0 -95
- package/src/commands/__tests__/view-build.test.ts +0 -58
- package/src/commands/__tests__/view.test.ts +0 -197
- package/src/commands/admin/status.ts +0 -61
- package/src/commands/admin/use.ts +0 -100
- package/src/commands/auth/login.ts +0 -82
- package/src/commands/auth/logout.ts +0 -53
- package/src/commands/auth/status.ts +0 -86
- package/src/commands/auth/token.ts +0 -174
- package/src/commands/browser.ts +0 -236
- package/src/commands/call-describe.ts +0 -123
- package/src/commands/call.ts +0 -230
- package/src/commands/domain/install.ts +0 -575
- package/src/commands/domain/list.ts +0 -155
- package/src/commands/domain/publish.ts +0 -136
- package/src/commands/domain/uninstall.ts +0 -128
- package/src/commands/get.ts +0 -69
- package/src/commands/identity/__tests__/register.test.ts +0 -93
- package/src/commands/identity/create.ts +0 -35
- package/src/commands/identity/delete.ts +0 -24
- package/src/commands/identity/export.ts +0 -46
- package/src/commands/identity/import.ts +0 -61
- package/src/commands/identity/list.ts +0 -56
- package/src/commands/identity/register.ts +0 -195
- package/src/commands/identity/sync.ts +0 -38
- package/src/commands/identity/unsync.ts +0 -34
- package/src/commands/identity/use.ts +0 -24
- package/src/commands/identity/whoami.ts +0 -34
- package/src/commands/idp/add.ts +0 -150
- package/src/commands/idp/list.ts +0 -57
- package/src/commands/idp/refresh.ts +0 -38
- package/src/commands/idp/remove.ts +0 -36
- package/src/commands/idp/show.ts +0 -29
- package/src/commands/instance/active.ts +0 -73
- package/src/commands/instance/bookmark.ts +0 -101
- package/src/commands/instance/create.ts +0 -61
- package/src/commands/instance/delete.ts +0 -69
- package/src/commands/instance/forget.ts +0 -26
- package/src/commands/instance/list.ts +0 -197
- package/src/commands/instance/status.ts +0 -92
- package/src/commands/instance/use.ts +0 -263
- package/src/commands/introspect.ts +0 -129
- package/src/commands/logs.ts +0 -371
- package/src/commands/mutate.ts +0 -122
- package/src/commands/query.ts +0 -142
- package/src/commands/session/analyze.ts +0 -72
- package/src/commands/session/list.ts +0 -36
- package/src/commands/setup.ts +0 -54
- package/src/commands/status.ts +0 -60
- package/src/commands/studio.ts +0 -434
- package/src/commands/token.ts +0 -121
- package/src/commands/ui/__tests__/commands.test.ts +0 -152
- package/src/commands/ui/add.ts +0 -51
- package/src/commands/ui/doctor.ts +0 -21
- package/src/commands/ui/init.ts +0 -38
- package/src/commands/ui/list.ts +0 -26
- package/src/commands/ui/preset-apply.ts +0 -19
- package/src/commands/ui/preset-list.ts +0 -12
- package/src/commands/ui/shared.ts +0 -25
- package/src/commands/update.ts +0 -356
- package/src/commands/use.ts +0 -86
- package/src/commands/view-serve.ts +0 -26
- package/src/commands/view.ts +0 -658
- package/src/connect-core.test.ts +0 -38
- package/src/connect-core.ts +0 -42
- package/src/connection/.spec/api.d.ts +0 -110
- package/src/connection/.spec/architecture.md +0 -58
- package/src/connection/.spec/capabilities/connection.ts +0 -13
- package/src/connection/.spec/examples/call.ts +0 -7
- package/src/connection/.spec/flows/command.ts +0 -20
- package/src/connection/.spec/flows/session.ts +0 -62
- package/src/connection/.spec/laws/connection.ts +0 -213
- package/src/connection/.spec/layout.ts +0 -22
- package/src/connection/__tests__/auth.test.ts +0 -129
- package/src/connection/__tests__/ca-fetch.test.ts +0 -60
- package/src/connection/__tests__/call.test.ts +0 -17
- package/src/connection/__tests__/credential.test.ts +0 -254
- package/src/connection/__tests__/errors.test.ts +0 -577
- package/src/connection/__tests__/exchange.test.ts +0 -404
- package/src/connection/__tests__/failure-fixtures.ts +0 -39
- package/src/connection/__tests__/failure-safety.test.ts +0 -75
- package/src/connection/__tests__/fixtures/localhost-cert.pem +0 -19
- package/src/connection/__tests__/fixtures/localhost-key.base64 +0 -1
- package/src/connection/__tests__/managed.test.ts +0 -39
- package/src/connection/__tests__/reasons.test.ts +0 -78
- package/src/connection/__tests__/self.test.ts +0 -71
- package/src/connection/__tests__/session.test.ts +0 -144
- package/src/connection/__tests__/target.test.ts +0 -95
- package/src/connection/auth.ts +0 -265
- package/src/connection/call.ts +0 -7
- package/src/connection/command.ts +0 -67
- package/src/connection/credential.ts +0 -138
- package/src/connection/errors.ts +0 -1
- package/src/connection/exchange.ts +0 -394
- package/src/connection/failure/classify.ts +0 -110
- package/src/connection/failure/index.ts +0 -18
- package/src/connection/failure/model.ts +0 -28
- package/src/connection/failure/render.ts +0 -116
- package/src/connection/index.ts +0 -8
- package/src/connection/lifetime.ts +0 -25
- package/src/connection/reasons.ts +0 -209
- package/src/connection/self.ts +0 -138
- package/src/connection/session.ts +0 -203
- package/src/connection/target.ts +0 -112
- package/src/connection/tsconfig.json +0 -6
- package/src/errors.ts +0 -66
- package/src/graph/.spec/api.d.ts +0 -41
- package/src/graph/.spec/laws/documents.ts +0 -24
- package/src/graph/.spec/laws/projection.ts +0 -13
- package/src/graph/.spec/layout.ts +0 -14
- package/src/graph/__tests__/mutation.test.ts +0 -51
- package/src/graph/__tests__/projection.test.ts +0 -22
- package/src/graph/__tests__/query.test.ts +0 -180
- package/src/graph/class.ts +0 -30
- package/src/graph/index.ts +0 -4
- package/src/graph/mutation.ts +0 -46
- package/src/graph/projection.ts +0 -21
- package/src/graph/query.ts +0 -95
- package/src/graph/tsconfig.json +0 -6
- package/src/identity/.history/ard/bootstrap-root-transfer.md +0 -57
- package/src/identity/.history/ard/domain-mediated-registration.md +0 -36
- package/src/identity/.spec/api.d.ts +0 -124
- package/src/identity/.spec/architecture.md +0 -33
- package/src/identity/.spec/capabilities/identity.ts +0 -7
- package/src/identity/.spec/flows/bootstrap-root.ts +0 -79
- package/src/identity/.spec/flows/domain-mediated-registration.ts +0 -51
- package/src/identity/.spec/flows/import.ts +0 -29
- package/src/identity/.spec/laws/identity.ts +0 -56
- package/src/identity/.spec/layout.ts +0 -13
- package/src/identity/__tests__/fixtures/registry-journey.ts +0 -65
- package/src/identity/__tests__/registration.test.ts +0 -64
- package/src/identity/__tests__/registry.test.ts +0 -74
- package/src/identity/__tests__/transfer.test.ts +0 -198
- package/src/identity/index.ts +0 -23
- package/src/identity/registration.ts +0 -72
- package/src/identity/registry.ts +0 -181
- package/src/identity/transfer.ts +0 -187
- package/src/identity/tsconfig.json +0 -6
- package/src/index.ts +0 -1
- package/src/keys/.spec/api.d.ts +0 -74
- package/src/keys/.spec/architecture.md +0 -13
- package/src/keys/.spec/laws/keys.ts +0 -43
- package/src/keys/.spec/layout.ts +0 -6
- package/src/keys/__tests__/algorithm.test.ts +0 -39
- package/src/keys/__tests__/keys.test.ts +0 -172
- package/src/keys/algorithm.ts +0 -33
- package/src/keys/credential.ts +0 -113
- package/src/keys/index.ts +0 -14
- package/src/keys/pair.ts +0 -219
- package/src/keys/tsconfig.json +0 -6
- package/src/lib/__tests__/admin-target.test.ts +0 -184
- package/src/lib/__tests__/binary.test.ts +0 -70
- package/src/lib/__tests__/browser-retention.test.ts +0 -212
- package/src/lib/__tests__/command-dx.test.ts +0 -102
- package/src/lib/__tests__/concurrency.test.ts +0 -62
- package/src/lib/__tests__/config.test.ts +0 -81
- package/src/lib/__tests__/design.test.ts +0 -99
- package/src/lib/__tests__/domain-publication.test.ts +0 -138
- package/src/lib/__tests__/format.test.ts +0 -22
- package/src/lib/__tests__/idp-session.driver.ts +0 -60
- package/src/lib/__tests__/idp-session.test.ts +0 -404
- package/src/lib/__tests__/idp.test.ts +0 -415
- package/src/lib/__tests__/instance-candidates.test.ts +0 -146
- package/src/lib/__tests__/instance-target.test.ts +0 -213
- package/src/lib/__tests__/instance.test.ts +0 -192
- package/src/lib/__tests__/local-status.test.ts +0 -202
- package/src/lib/__tests__/log-errors.test.ts +0 -64
- package/src/lib/__tests__/log.test.ts +0 -31
- package/src/lib/__tests__/meta.test.ts +0 -55
- package/src/lib/__tests__/output.test.ts +0 -162
- package/src/lib/__tests__/panel.test.ts +0 -40
- package/src/lib/__tests__/port.test.ts +0 -44
- package/src/lib/__tests__/prompt.test.ts +0 -25
- package/src/lib/__tests__/sdk-deps.test.ts +0 -68
- package/src/lib/__tests__/self.test.ts +0 -50
- package/src/lib/__tests__/skills.test.ts +0 -834
- package/src/lib/__tests__/studio-server-deps.test.ts +0 -111
- package/src/lib/__tests__/table.test.ts +0 -53
- package/src/lib/__tests__/update.test.ts +0 -511
- package/src/lib/__tests__/use-target.test.ts +0 -56
- package/src/lib/__tests__/validation.test.ts +0 -34
- package/src/lib/__tests__/view-assets.test.ts +0 -171
- package/src/lib/__tests__/view-external-open-intent.test.ts +0 -150
- package/src/lib/__tests__/view-external-open-origins.test.ts +0 -27
- package/src/lib/__tests__/view-open-intent.test.ts +0 -280
- package/src/lib/__tests__/view-port-allocation.test.ts +0 -82
- package/src/lib/__tests__/view-server.test.ts +0 -91
- package/src/lib/__tests__/view-session.test.ts +0 -100
- package/src/lib/__tests__/view-snapshot.test.ts +0 -77
- package/src/lib/admin-domain.ts +0 -43
- package/src/lib/admin-instance.ts +0 -56
- package/src/lib/admin-target.ts +0 -290
- package/src/lib/binary.ts +0 -127
- package/src/lib/browser-retention.ts +0 -210
- package/src/lib/browser.ts +0 -150
- package/src/lib/ca-fetch.ts +0 -133
- package/src/lib/command-dx.ts +0 -191
- package/src/lib/concurrency.ts +0 -31
- package/src/lib/config.ts +0 -57
- package/src/lib/credential-lifetime.ts +0 -24
- package/src/lib/domain-publication.ts +0 -104
- package/src/lib/failure-debug.ts +0 -26
- package/src/lib/format.ts +0 -4
- package/src/lib/idp-session.ts +0 -156
- package/src/lib/idp.ts +0 -926
- package/src/lib/instance-candidates.ts +0 -49
- package/src/lib/instance-target.ts +0 -197
- package/src/lib/instance.ts +0 -468
- package/src/lib/invocation.ts +0 -11
- package/src/lib/local-status.ts +0 -152
- package/src/lib/log.ts +0 -143
- package/src/lib/login-flow.ts +0 -201
- package/src/lib/meta.ts +0 -90
- package/src/lib/output.ts +0 -238
- package/src/lib/panel.ts +0 -61
- package/src/lib/port.ts +0 -41
- package/src/lib/proc.ts +0 -87
- package/src/lib/prompt.ts +0 -136
- package/src/lib/provision-instance.ts +0 -139
- package/src/lib/sdk-deps.ts +0 -104
- package/src/lib/self.ts +0 -22
- package/src/lib/skills/lock.ts +0 -117
- package/src/lib/skills/sync.ts +0 -878
- package/src/lib/skills.ts +0 -120
- package/src/lib/table.ts +0 -62
- package/src/lib/update.ts +0 -568
- package/src/lib/use-target.ts +0 -24
- package/src/lib/validation.ts +0 -59
- package/src/lib/view/assets.ts +0 -87
- package/src/lib/view/external-open-intent.ts +0 -41
- package/src/lib/view/external-open-origins.ts +0 -37
- package/src/lib/view/host-capabilities.ts +0 -17
- package/src/lib/view/open-intent.ts +0 -67
- package/src/lib/view/port-allocation.ts +0 -19
- package/src/lib/view/resolve.ts +0 -111
- package/src/lib/view/server.ts +0 -259
- package/src/lib/view/session.ts +0 -154
- package/src/lib/view/snapshot.ts +0 -101
- package/src/paths/.spec/api.d.ts +0 -13
- package/src/paths/.spec/architecture.md +0 -5
- package/src/paths/.spec/layout.ts +0 -3
- package/src/paths/index.ts +0 -13
- package/src/program/.spec/api.d.ts +0 -43
- package/src/program/.spec/architecture.md +0 -18
- package/src/program/.spec/laws/program.ts +0 -29
- package/src/program/.spec/layout.ts +0 -14
- package/src/program/__tests__/program.test.ts +0 -556
- package/src/program/argv.ts +0 -14
- package/src/program/build.ts +0 -205
- package/src/program/command.ts +0 -43
- package/src/program/index.ts +0 -3
- package/src/program/options.ts +0 -41
- package/src/program/registry.ts +0 -64
- package/src/program/tsconfig.json +0 -6
- package/src/setup/__tests__/instance-step.test.ts +0 -256
- package/src/setup/__tests__/util.test.ts +0 -29
- package/src/setup/engine.ts +0 -83
- package/src/setup/render.ts +0 -107
- package/src/setup/steps/admin.ts +0 -93
- package/src/setup/steps/agent-browser.ts +0 -81
- package/src/setup/steps/auth.ts +0 -54
- package/src/setup/steps/domain.ts +0 -68
- package/src/setup/steps/index.ts +0 -18
- package/src/setup/steps/instance.ts +0 -206
- package/src/setup/steps/skills-bridge.ts +0 -70
- package/src/setup/steps/skills.ts +0 -61
- package/src/setup/types.ts +0 -61
- package/src/setup/util.ts +0 -34
- package/src/state/.spec/api.d.ts +0 -152
- package/src/state/.spec/architecture.md +0 -45
- package/src/state/.spec/capabilities/state.ts +0 -7
- package/src/state/.spec/flows/identity-update.ts +0 -22
- package/src/state/.spec/laws/state.ts +0 -73
- package/src/state/.spec/layout.ts +0 -15
- package/src/state/__tests__/exchange-credentials.test.ts +0 -341
- package/src/state/__tests__/files.test.ts +0 -136
- package/src/state/__tests__/fixtures/identity-transition.ts +0 -37
- package/src/state/__tests__/fixtures/session-route-process.ts +0 -93
- package/src/state/__tests__/identities.test.ts +0 -142
- package/src/state/__tests__/paths.test.ts +0 -28
- package/src/state/__tests__/session-routes.test.ts +0 -138
- package/src/state/exchange-credentials.ts +0 -250
- package/src/state/files.ts +0 -170
- package/src/state/identities.ts +0 -229
- package/src/state/index.ts +0 -31
- package/src/state/paths.ts +0 -64
- package/src/state/session-routes.ts +0 -34
- package/src/state/tsconfig.json +0 -6
- package/src/telemetry/__tests__/analyze-log.test.ts +0 -38
- package/src/telemetry/__tests__/gate.test.ts +0 -63
- package/src/telemetry/__tests__/recorder.test.ts +0 -111
- package/src/telemetry/__tests__/redact.test.ts +0 -79
- package/src/telemetry/__tests__/retention.test.ts +0 -267
- package/src/telemetry/__tests__/session.test.ts +0 -166
- package/src/telemetry/__tests__/settings.test.ts +0 -102
- package/src/telemetry/__tests__/store-scan.test.ts +0 -128
- package/src/telemetry/__tests__/trigger.test.ts +0 -78
- package/src/telemetry/adapters/__tests__/claude-code.test.ts +0 -89
- package/src/telemetry/adapters/__tests__/codex.test.ts +0 -138
- package/src/telemetry/adapters/__tests__/index.test.ts +0 -88
- package/src/telemetry/adapters/claude-code.ts +0 -90
- package/src/telemetry/adapters/codex.ts +0 -160
- package/src/telemetry/adapters/index.ts +0 -45
- package/src/telemetry/adapters/types.ts +0 -21
- package/src/telemetry/analyze.ts +0 -249
- package/src/telemetry/gate.ts +0 -79
- package/src/telemetry/recorder.ts +0 -68
- package/src/telemetry/redact.ts +0 -53
- package/src/telemetry/retention.ts +0 -176
- package/src/telemetry/session.ts +0 -94
- package/src/telemetry/settings.ts +0 -79
- package/src/telemetry/store.ts +0 -174
- package/src/telemetry/trigger.ts +0 -107
- package/src/telemetry/types.ts +0 -64
- package/src/test-utils.ts +0 -18
- package/src/ui/.spec/api.d.ts +0 -14
- package/src/ui/.spec/architecture.md +0 -14
- package/src/ui/.spec/laws.ts +0 -50
- package/src/ui/.spec/layout.ts +0 -16
- package/src/ui/__tests__/ui.test.ts +0 -1742
- package/src/ui/index.ts +0 -13
- package/src/ui/lock.ts +0 -89
- package/src/ui/model.ts +0 -83
- package/src/ui/operations.ts +0 -1044
- package/src/ui/project.ts +0 -333
- package/src/ui/release.ts +0 -398
- package/src/ui/runner.ts +0 -18
- package/studio/client/dist/assets/index-BFVFs_8x.js +0 -81
- package/studio/client/dist/assets/index-DuB9iUdu.css +0 -2
- package/studio/client/dist/assets/schema-studio-DH6oEWME.js +0 -8
- package/studio/tsconfig.json +0 -24
- package/viewer/tsconfig.json +0 -13
package/src/connect-core.ts
DELETED
|
@@ -1,42 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Temporary compatibility surface for the observed `@astrale-os/connect-host`
|
|
3
|
-
* consumer. Keep this file as re-exports only: CLI state and connection owners
|
|
4
|
-
* remain authoritative, and no Kernel Client implementation type is exposed.
|
|
5
|
-
*/
|
|
6
|
-
|
|
7
|
-
export { getDefault, getIdentity, readIdentities } from './identity/registry'
|
|
8
|
-
export type { Identity, IdentityStore } from './identity/registry'
|
|
9
|
-
|
|
10
|
-
export { listIdentityKeys, signAs } from './keys/index'
|
|
11
|
-
|
|
12
|
-
export {
|
|
13
|
-
normalizeInstanceKernelUrl,
|
|
14
|
-
orgIdForAudience,
|
|
15
|
-
readInstances,
|
|
16
|
-
resetInstancesMemo,
|
|
17
|
-
resolveInstance,
|
|
18
|
-
} from './lib/instance'
|
|
19
|
-
export type { InstanceEntry, InstanceStore, ResolvedInstance } from './lib/instance'
|
|
20
|
-
|
|
21
|
-
export { resolveInstanceTarget } from './lib/instance-target'
|
|
22
|
-
export type { ResolvedInstanceTarget } from './lib/instance-target'
|
|
23
|
-
|
|
24
|
-
export { readConfig } from './lib/config'
|
|
25
|
-
export type { AstraleConfig } from './lib/config'
|
|
26
|
-
|
|
27
|
-
export {
|
|
28
|
-
IdpOrgMembershipError,
|
|
29
|
-
IdpRefreshTransientError,
|
|
30
|
-
resolveCredential,
|
|
31
|
-
} from './connection/auth'
|
|
32
|
-
|
|
33
|
-
export { loginViaIdp, resolveIdpName } from './lib/login-flow'
|
|
34
|
-
export type { DeviceVerification, LoginFlowOpts, LoginResult } from './lib/login-flow'
|
|
35
|
-
|
|
36
|
-
export { isSessionExpired, readIdpSession } from './lib/idp'
|
|
37
|
-
export type { IdpSession } from './lib/idp'
|
|
38
|
-
|
|
39
|
-
export { AuthError } from './errors'
|
|
40
|
-
export { fetchWithCaFile } from './lib/ca-fetch'
|
|
41
|
-
|
|
42
|
-
export { createPaths, paths } from './state/index'
|
|
@@ -1,110 +0,0 @@
|
|
|
1
|
-
import type { IssuerId } from '@astrale-os/sdk/auth'
|
|
2
|
-
import type { AuthApi } from '@astrale-os/sdk/auth'
|
|
3
|
-
import type { Call, GraphApi } from '@astrale-os/sdk/client'
|
|
4
|
-
import type { ClientSession } from '@astrale-os/sdk/client/session'
|
|
5
|
-
|
|
6
|
-
/** Existing CLI connection flags accepted by Kernel-touching commands. */
|
|
7
|
-
export interface ConnectionOptions {
|
|
8
|
-
readonly url?: string
|
|
9
|
-
readonly instance?: string
|
|
10
|
-
readonly timeout?: string
|
|
11
|
-
readonly as?: string
|
|
12
|
-
readonly creds?: string
|
|
13
|
-
/** Omit caller credentials even when local or bookmark defaults exist. */
|
|
14
|
-
readonly anonymous?: boolean
|
|
15
|
-
}
|
|
16
|
-
|
|
17
|
-
/** Existing Admin-target overrides accepted only by Admin Domain operations. */
|
|
18
|
-
export interface AdminConnectionOptions extends ConnectionOptions {
|
|
19
|
-
readonly admin?: string
|
|
20
|
-
readonly adminUrl?: string
|
|
21
|
-
readonly domainIssuer?: string
|
|
22
|
-
}
|
|
23
|
-
|
|
24
|
-
/** Exact source Kernel selected from flags and local CLI state. */
|
|
25
|
-
export interface ConnectionTarget {
|
|
26
|
-
readonly url: string
|
|
27
|
-
readonly issuer: IssuerId
|
|
28
|
-
/** Installed Domain issuer; presence activates standard token exchange. */
|
|
29
|
-
readonly domainIssuer?: IssuerId
|
|
30
|
-
readonly slug?: string
|
|
31
|
-
readonly defaultIdentity?: string
|
|
32
|
-
readonly caFile?: string
|
|
33
|
-
}
|
|
34
|
-
|
|
35
|
-
/** Stable local identity-registration key for the exact selected source Kernel. */
|
|
36
|
-
export function registrationKeyForTarget(target: ConnectionTarget): string
|
|
37
|
-
|
|
38
|
-
/** Narrow capabilities available during one scoped CLI connection. */
|
|
39
|
-
export interface ConnectionContext {
|
|
40
|
-
readonly session: ClientSession
|
|
41
|
-
readonly graph: GraphApi
|
|
42
|
-
readonly auth: AuthApi
|
|
43
|
-
readonly target: ConnectionTarget
|
|
44
|
-
}
|
|
45
|
-
|
|
46
|
-
/** Existing output and diagnostic flags shared by commands that open a Kernel connection. */
|
|
47
|
-
export interface KernelCommandOpts extends ConnectionOptions {
|
|
48
|
-
readonly raw?: boolean
|
|
49
|
-
readonly json?: boolean
|
|
50
|
-
readonly format?: 'yaml' | 'json'
|
|
51
|
-
readonly debug?: boolean
|
|
52
|
-
}
|
|
53
|
-
|
|
54
|
-
/** Detached metadata used only to improve an error after a caller-authored @self expansion. */
|
|
55
|
-
export interface SelfExpansionMeta {
|
|
56
|
-
readonly original: string
|
|
57
|
-
readonly expanded: string
|
|
58
|
-
readonly selfId: string
|
|
59
|
-
readonly slug?: string
|
|
60
|
-
}
|
|
61
|
-
|
|
62
|
-
/** Parse caller-authored path text and retain one portable input in the public Call shape. */
|
|
63
|
-
export function createPathCall(path: string, input: unknown): Call
|
|
64
|
-
|
|
65
|
-
/** Resolve one ordinary CLI target, run an action, and close every owned Client resource. */
|
|
66
|
-
export function withClientSession<Value>(
|
|
67
|
-
options: ConnectionOptions,
|
|
68
|
-
action: (context: ConnectionContext) => Promise<Value>,
|
|
69
|
-
): Promise<Value>
|
|
70
|
-
|
|
71
|
-
/** Resolve the configured Admin Domain target under the same scoped lifecycle. */
|
|
72
|
-
export function withAdminClientSession<Value>(
|
|
73
|
-
options: AdminConnectionOptions,
|
|
74
|
-
action: (context: ConnectionContext) => Promise<Value>,
|
|
75
|
-
): Promise<Value>
|
|
76
|
-
|
|
77
|
-
/** Expand @self through the effective principal returned by authenticated Identity.whoami. */
|
|
78
|
-
export function expandSelfInPath(
|
|
79
|
-
path: string,
|
|
80
|
-
context: ConnectionContext,
|
|
81
|
-
): Promise<{ readonly path: string; readonly meta?: SelfExpansionMeta }>
|
|
82
|
-
|
|
83
|
-
/** Expand @self once across one Call path and its CLI-authored string parameters. */
|
|
84
|
-
export function expandSelfInCall(
|
|
85
|
-
path: string,
|
|
86
|
-
parameters: Readonly<Record<string, unknown>>,
|
|
87
|
-
context: ConnectionContext,
|
|
88
|
-
): Promise<{
|
|
89
|
-
readonly path: string
|
|
90
|
-
readonly parameters: Readonly<Record<string, unknown>>
|
|
91
|
-
readonly meta?: SelfExpansionMeta
|
|
92
|
-
}>
|
|
93
|
-
|
|
94
|
-
/** Preserve stale-registration evidence while an expanded request is executed. */
|
|
95
|
-
export function withSelfHint<Value>(
|
|
96
|
-
action: () => Promise<Value>,
|
|
97
|
-
meta: SelfExpansionMeta | undefined,
|
|
98
|
-
): Promise<Value>
|
|
99
|
-
|
|
100
|
-
/** Run one command through the canonical progress, connection, presentation, and error boundary. */
|
|
101
|
-
export function runKernelCommand<Value>(input: {
|
|
102
|
-
readonly opts: KernelCommandOpts
|
|
103
|
-
readonly label: string
|
|
104
|
-
readonly fn: (context: ConnectionContext) => Promise<Value>
|
|
105
|
-
readonly format?: (
|
|
106
|
-
result: Value,
|
|
107
|
-
options: KernelCommandOpts,
|
|
108
|
-
machine: boolean,
|
|
109
|
-
) => void | Promise<void>
|
|
110
|
-
}): Promise<void>
|
|
@@ -1,58 +0,0 @@
|
|
|
1
|
-
# CLI connection architecture
|
|
2
|
-
|
|
3
|
-
The private `connection` module owns one scoped bridge from existing CLI flags and local identity
|
|
4
|
-
state to the public Kernel Client. It selects the exact source Kernel URL and issuer, either omits
|
|
5
|
-
credentials for an explicit anonymous selection or resolves fresh source-Kernel authority for each
|
|
6
|
-
Call, binds Graph and Auth helpers, and closes every owned Client resource when the command action
|
|
7
|
-
terminates.
|
|
8
|
-
|
|
9
|
-
When a target also names an exact Domain issuer, the connection owner performs the client-mediated
|
|
10
|
-
`whoami -> delegate(attenuation) -> issuer exchange` journey. The resulting Domain token crosses
|
|
11
|
-
into ClientSession as an opaque credential; connection does not authorize Domain operations.
|
|
12
|
-
|
|
13
|
-
```mermaid
|
|
14
|
-
flowchart LR
|
|
15
|
-
F[CLI flags and local state] --> T[Connection target]
|
|
16
|
-
T --> H[ClientSession]
|
|
17
|
-
C[CLI credential sources] --> R[SessionAuth]
|
|
18
|
-
R --> H
|
|
19
|
-
H --> G[GraphApi]
|
|
20
|
-
H --> A[AuthApi]
|
|
21
|
-
H --> X[Command action]
|
|
22
|
-
G --> X
|
|
23
|
-
A --> X
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
ClientSession owns source admission, Publication discovery, redirect witnessing, route caching, transport
|
|
27
|
-
selection, and the single safe stale-route recovery. The CLI does not reproduce those rules or
|
|
28
|
-
discover destination identity. `SessionAuth.resolve(call, signal)` returns source-Kernel authority and
|
|
29
|
-
ClientSession supplies an audience-free Delegate with omitted attenuation, preserving the exact
|
|
30
|
-
current Grant for routing. Connection itself persists no credential or route; the separate state
|
|
31
|
-
owner persists exchanged source credentials and the separate Kernel Client route artifact. A valid exchanged credential is selected by the
|
|
32
|
-
authenticated source issuer and subject before any live `whoami`; cache misses alone resolve the
|
|
33
|
-
registered Kernel User and perform delegation plus Domain exchange.
|
|
34
|
-
Exchange and destination-carrier authority cover the selected command timeout plus one bounded
|
|
35
|
-
receipt margin, never outlive the current source credential, and retain the existing one-minute
|
|
36
|
-
floor for short commands. A cached or freshly exchanged credential that cannot cover that lifetime
|
|
37
|
-
is refreshed or rejected before destination dispatch, so a long durable mutation does not first
|
|
38
|
-
discover expired callback authority after its provider effect commits.
|
|
39
|
-
|
|
40
|
-
Every ClientSession receives the CLI-owned `state/session-routes` representation capability. Kernel
|
|
41
|
-
Client still owns route keying, admission, expiry, and one safe stale/miss recovery; Connection does
|
|
42
|
-
not reproduce routing or add an Admin-only bypass.
|
|
43
|
-
|
|
44
|
-
`--anonymous` deliberately suppresses ambient and bookmark-default identities by omitting the
|
|
45
|
-
`SessionAuth` capability. It cannot be combined with `--as` or `--creds`; contradictory selections fail
|
|
46
|
-
before local identity state or a connection is opened. Public and optional callables can then
|
|
47
|
-
observe a genuinely anonymous caller, while required callables reject the request at the Kernel.
|
|
48
|
-
|
|
49
|
-
The target, timeout, and optional CA file are resolved before constructing the session. The CA file
|
|
50
|
-
customizes only the Fetch capability passed to Client. `withClientSession` and
|
|
51
|
-
`withAdminClientSession` are terminal lifecycle boundaries: success, failure, and cancellation all
|
|
52
|
-
close both the Client Session and its direct source-Auth client.
|
|
53
|
-
|
|
54
|
-
The command boundary projects typed Client failure identity, transport context, phase, and
|
|
55
|
-
invocation-only delivery evidence without inspecting a private cause message. Unknown native
|
|
56
|
-
failures become one honest unexpected diagnostic; their bounded cause graph is visible only under
|
|
57
|
-
explicit debug output. Every admitted Kernel reason remains available in machine output, while
|
|
58
|
-
human repair details require a bounded public Function issue or exact Query reason variant.
|
|
@@ -1,13 +0,0 @@
|
|
|
1
|
-
import { defineCapability } from '@astrale-os/spec/authoring'
|
|
2
|
-
|
|
3
|
-
export const CLI_CONNECTION = defineCapability({
|
|
4
|
-
id: 'CLI-CONNECTION',
|
|
5
|
-
statement:
|
|
6
|
-
'Selects one exact source Kernel and exposes scoped public Host, Graph, and Auth capabilities with terminal cleanup.',
|
|
7
|
-
})
|
|
8
|
-
|
|
9
|
-
export const CLI_AUTH = defineCapability({
|
|
10
|
-
id: 'CLI-AUTH',
|
|
11
|
-
statement:
|
|
12
|
-
'Pins the selected source issuer, explicitly admits either credential-less or target-bound authenticated sessions, and delegates remote destinations without forwarding a prior bearer.',
|
|
13
|
-
})
|
|
@@ -1,7 +0,0 @@
|
|
|
1
|
-
import { createPathCall, withClientSession } from '../api.js'
|
|
2
|
-
|
|
3
|
-
const result = await withClientSession({ instance: 'staging', as: 'alice' }, ({ session }) =>
|
|
4
|
-
session.call(createPathCall('/:notes.example.dev:function.search', { text: 'astrale' })),
|
|
5
|
-
)
|
|
6
|
-
|
|
7
|
-
console.log(result)
|
|
@@ -1,20 +0,0 @@
|
|
|
1
|
-
import type { ConnectionContext, KernelCommandOpts } from '../api.js'
|
|
2
|
-
|
|
3
|
-
declare const open: <Value>(
|
|
4
|
-
options: KernelCommandOpts,
|
|
5
|
-
action: (context: ConnectionContext) => Promise<Value>,
|
|
6
|
-
) => Promise<Value>
|
|
7
|
-
declare const present: <Value>(value: Value) => void | Promise<void>
|
|
8
|
-
declare const mapExpectedFailure: (error: unknown) => Promise<void>
|
|
9
|
-
|
|
10
|
-
/** One command owns progress and error presentation around one terminal ClientSession lifecycle. */
|
|
11
|
-
export async function runKernelCommand<Value>(
|
|
12
|
-
options: KernelCommandOpts,
|
|
13
|
-
action: (context: ConnectionContext) => Promise<Value>,
|
|
14
|
-
): Promise<void> {
|
|
15
|
-
try {
|
|
16
|
-
await present(await open(options, action))
|
|
17
|
-
} catch (error) {
|
|
18
|
-
await mapExpectedFailure(error)
|
|
19
|
-
}
|
|
20
|
-
}
|
|
@@ -1,62 +0,0 @@
|
|
|
1
|
-
import type { Call } from '@astrale-os/sdk/client'
|
|
2
|
-
import type { SessionAuth } from '@astrale-os/sdk/client/session'
|
|
3
|
-
|
|
4
|
-
import type { ConnectionContext, ConnectionOptions, ConnectionTarget } from '../api.js'
|
|
5
|
-
|
|
6
|
-
interface OwnedConnection {
|
|
7
|
-
readonly context: ConnectionContext
|
|
8
|
-
close(): void
|
|
9
|
-
}
|
|
10
|
-
|
|
11
|
-
declare const resolveTarget: (options: ConnectionOptions) => Promise<ConnectionTarget>
|
|
12
|
-
declare const resolveTimeoutMs: (input: string | undefined) => number
|
|
13
|
-
declare const createClientConnection: (
|
|
14
|
-
target: ConnectionTarget,
|
|
15
|
-
timeoutMs: number,
|
|
16
|
-
auth: SessionAuth | undefined,
|
|
17
|
-
) => OwnedConnection
|
|
18
|
-
declare const validateCredentialSelection: (options: ConnectionOptions) => void
|
|
19
|
-
declare const resolveSourceCredential: (
|
|
20
|
-
target: ConnectionTarget,
|
|
21
|
-
options: ConnectionOptions,
|
|
22
|
-
audience: string,
|
|
23
|
-
signal: AbortSignal,
|
|
24
|
-
) => Promise<string>
|
|
25
|
-
/** Bind source authority without learning or minting destination credentials. */
|
|
26
|
-
function createConnectionAuth(target: ConnectionTarget, options: ConnectionOptions): SessionAuth {
|
|
27
|
-
const ttlSeconds = Math.max(60, Math.ceil(resolveTimeoutMs(options.timeout) / 1_000) + 5)
|
|
28
|
-
return {
|
|
29
|
-
ttlSeconds,
|
|
30
|
-
async resolve(_call: Call, signal: AbortSignal) {
|
|
31
|
-
return {
|
|
32
|
-
credential: await resolveSourceCredential(target, options, target.issuer, signal),
|
|
33
|
-
}
|
|
34
|
-
},
|
|
35
|
-
}
|
|
36
|
-
}
|
|
37
|
-
|
|
38
|
-
/** Open one Client Session with a call-scoped source-authority resolver bound once. */
|
|
39
|
-
function openConnection(
|
|
40
|
-
target: ConnectionTarget,
|
|
41
|
-
timeoutMs: number,
|
|
42
|
-
options: ConnectionOptions,
|
|
43
|
-
): OwnedConnection {
|
|
44
|
-
const auth = options.anonymous === true ? undefined : createConnectionAuth(target, options)
|
|
45
|
-
return createClientConnection(target, timeoutMs, auth)
|
|
46
|
-
}
|
|
47
|
-
|
|
48
|
-
/** One terminal command-scoped connection lifecycle. */
|
|
49
|
-
export async function withClientSession<Value>(
|
|
50
|
-
options: ConnectionOptions,
|
|
51
|
-
action: (context: ConnectionContext) => Promise<Value>,
|
|
52
|
-
): Promise<Value> {
|
|
53
|
-
validateCredentialSelection(options)
|
|
54
|
-
const timeoutMs = resolveTimeoutMs(options.timeout)
|
|
55
|
-
const target = await resolveTarget(options)
|
|
56
|
-
const connection = openConnection(target, timeoutMs, options)
|
|
57
|
-
try {
|
|
58
|
-
return await action(connection.context)
|
|
59
|
-
} finally {
|
|
60
|
-
connection.close()
|
|
61
|
-
}
|
|
62
|
-
}
|
|
@@ -1,213 +0,0 @@
|
|
|
1
|
-
import { defineLaw } from '@astrale-os/spec/authoring'
|
|
2
|
-
|
|
3
|
-
export const CLI_CONNECTION_TARGET = defineLaw({
|
|
4
|
-
id: 'CLI-CONNECTION-TARGET',
|
|
5
|
-
statement:
|
|
6
|
-
'Explicit URL, explicit instance, active bookmark, managed lookup, and Admin target selection preserve the existing precedence while returning the exact invocation URL and issuer separately.',
|
|
7
|
-
tests: [
|
|
8
|
-
{
|
|
9
|
-
file: '__tests__/target.test.ts',
|
|
10
|
-
id: 'TEST-CLI-CONNECTION-SELECTS-EXACT-TARGET',
|
|
11
|
-
},
|
|
12
|
-
],
|
|
13
|
-
})
|
|
14
|
-
|
|
15
|
-
export const CLI_CONNECTION_DOMAIN_EXCHANGE = defineLaw({
|
|
16
|
-
id: 'CLI-CONNECTION-DOMAIN-EXCHANGE',
|
|
17
|
-
statement:
|
|
18
|
-
'A target with an explicit Domain issuer resolves the source credential, authenticates whoami at the exact Kernel, requests explicit self attenuation for that User and Domain audience, posts the resulting envelope to the discovered standard endpoint, and returns only a Domain token bound back to the same Kernel; there is no inferred issuer or legacy broker fallback.',
|
|
19
|
-
tests: [
|
|
20
|
-
{
|
|
21
|
-
file: '__tests__/exchange.test.ts',
|
|
22
|
-
id: 'TEST-CLI-EXCHANGE-WHOAMI-DELEGATE-EXCHANGE-CACHE',
|
|
23
|
-
},
|
|
24
|
-
{
|
|
25
|
-
file: '__tests__/exchange.test.ts',
|
|
26
|
-
id: 'TEST-CLI-EXCHANGE-NO-LEGACY-FALLBACK',
|
|
27
|
-
},
|
|
28
|
-
],
|
|
29
|
-
})
|
|
30
|
-
|
|
31
|
-
export const CLI_CONNECTION_HOP_CREDENTIAL = defineLaw({
|
|
32
|
-
id: 'CLI-CONNECTION-HOP-CREDENTIAL',
|
|
33
|
-
statement:
|
|
34
|
-
'A source hop resolves a fresh credential only when its session-pinned issuer equals the selected source issuer; a destination hop requires the same selected resolver and returns a fresh delegation for the witnessed Publication issuer, never the source credential, with its TTL bounded strictly inside any source JWT expiry.',
|
|
35
|
-
tests: [
|
|
36
|
-
{
|
|
37
|
-
file: '__tests__/credential.test.ts',
|
|
38
|
-
id: 'TEST-CLI-CONNECTION-RESOLVES-CREDENTIAL-PER-HOP',
|
|
39
|
-
},
|
|
40
|
-
{
|
|
41
|
-
file: '__tests__/credential.test.ts',
|
|
42
|
-
id: 'TEST-CLI-CONNECTION-DELEGATES-VIA-SOURCE-AUTH',
|
|
43
|
-
},
|
|
44
|
-
{
|
|
45
|
-
file: '__tests__/credential.test.ts',
|
|
46
|
-
id: 'TEST-CLI-CONNECTION-REJECTS-HOP-SOURCE-ISSUER-MISMATCH',
|
|
47
|
-
},
|
|
48
|
-
{
|
|
49
|
-
file: '__tests__/credential.test.ts',
|
|
50
|
-
id: 'TEST-CLI-CONNECTION-BOUNDS-DELEGATION-TO-SOURCE-EXPIRY',
|
|
51
|
-
},
|
|
52
|
-
],
|
|
53
|
-
})
|
|
54
|
-
|
|
55
|
-
export const CLI_CONNECTION_EXPLICIT_ANONYMOUS = defineLaw({
|
|
56
|
-
id: 'CLI-CONNECTION-EXPLICIT-ANONYMOUS',
|
|
57
|
-
statement:
|
|
58
|
-
'An explicit anonymous selection suppresses ambient, bookmark-default, and local credentials by omitting the Host credential capability; it is rejected before connection construction when combined with --as or --creds.',
|
|
59
|
-
tests: [
|
|
60
|
-
{
|
|
61
|
-
file: '__tests__/credential.test.ts',
|
|
62
|
-
id: 'TEST-CLI-CONNECTION-OMITS-EXPLICIT-ANONYMOUS-CREDENTIAL',
|
|
63
|
-
},
|
|
64
|
-
{
|
|
65
|
-
file: '__tests__/session.test.ts',
|
|
66
|
-
id: 'TEST-CLI-CONNECTION-REJECTS-ANONYMOUS-CREDENTIAL-CONFLICT',
|
|
67
|
-
},
|
|
68
|
-
],
|
|
69
|
-
})
|
|
70
|
-
|
|
71
|
-
export const CLI_CONNECTION_SOURCE_ISSUER = defineLaw({
|
|
72
|
-
id: 'CLI-CONNECTION-SOURCE-ISSUER',
|
|
73
|
-
statement:
|
|
74
|
-
'CLI constructs ClientSession once with sourceIssuer equal to the selected ConnectionTarget issuer independently from its invocation URL, so path-multiplexed Kernels do not substitute root Publication discovery; every credential hop repeats that pin.',
|
|
75
|
-
tests: [
|
|
76
|
-
{
|
|
77
|
-
file: '__tests__/session.test.ts',
|
|
78
|
-
id: 'TEST-CLI-CONNECTION-PINS-SOURCE-ISSUER',
|
|
79
|
-
},
|
|
80
|
-
],
|
|
81
|
-
})
|
|
82
|
-
|
|
83
|
-
export const CLI_CONNECTION_ISSUER_DISCOVERY = defineLaw({
|
|
84
|
-
id: 'CLI-CONNECTION-ISSUER-DISCOVERY',
|
|
85
|
-
statement:
|
|
86
|
-
'When invocation URL and issuer differ, liveness probes resolve OIDC metadata at the pinned issuer and reject metadata that declares any other issuer before fetching its keys.',
|
|
87
|
-
tests: [
|
|
88
|
-
{
|
|
89
|
-
file: '../lib/__tests__/meta.test.ts',
|
|
90
|
-
id: 'TEST-CLI-CONNECTION-PROBES-PINNED-ISSUER',
|
|
91
|
-
},
|
|
92
|
-
{
|
|
93
|
-
file: '../lib/__tests__/meta.test.ts',
|
|
94
|
-
id: 'TEST-CLI-CONNECTION-REJECTS-DISCOVERY-ISSUER-MISMATCH',
|
|
95
|
-
},
|
|
96
|
-
],
|
|
97
|
-
})
|
|
98
|
-
|
|
99
|
-
export const CLI_AUTH_REGISTRATION_TARGET = defineLaw({
|
|
100
|
-
id: 'CLI-AUTH-REGISTRATION-TARGET',
|
|
101
|
-
statement:
|
|
102
|
-
'Key identity registration lookup uses the same target key for bookmark, managed, Admin, and direct URL calls that identity registration stores.',
|
|
103
|
-
tests: [
|
|
104
|
-
{
|
|
105
|
-
file: '__tests__/auth.test.ts',
|
|
106
|
-
id: 'TEST-CLI-AUTH-USES-DIRECT-URL-REGISTRATION',
|
|
107
|
-
},
|
|
108
|
-
],
|
|
109
|
-
})
|
|
110
|
-
|
|
111
|
-
export const CLI_SELF_AUTHENTICATED_PRINCIPAL = defineLaw({
|
|
112
|
-
id: 'CLI-SELF-AUTHENTICATED-PRINCIPAL',
|
|
113
|
-
statement:
|
|
114
|
-
'@self resolves inside the command-owned Client Session from authenticated Identity.whoami on the selected target, so resolution and dispatch share one lifecycle and delegated carriers never use an unverified JWT subject or stale local registration.',
|
|
115
|
-
tests: [
|
|
116
|
-
{
|
|
117
|
-
file: '__tests__/self.test.ts',
|
|
118
|
-
id: 'TEST-CLI-SELF-USES-AUTHENTICATED-EFFECTIVE-PRINCIPAL',
|
|
119
|
-
},
|
|
120
|
-
],
|
|
121
|
-
})
|
|
122
|
-
|
|
123
|
-
export const CLI_CONNECTION_TERMINAL_CLOSE = defineLaw({
|
|
124
|
-
id: 'CLI-CONNECTION-TERMINAL-CLOSE',
|
|
125
|
-
statement:
|
|
126
|
-
'The Client Session and direct source-Auth client close exactly once after action success, failure, or cancellation.',
|
|
127
|
-
tests: [
|
|
128
|
-
{
|
|
129
|
-
file: '__tests__/session.test.ts',
|
|
130
|
-
id: 'TEST-CLI-CONNECTION-CLOSES-OWNED-CLIENTS',
|
|
131
|
-
},
|
|
132
|
-
],
|
|
133
|
-
})
|
|
134
|
-
|
|
135
|
-
export const CLI_CONNECTION_TIMEOUT = defineLaw({
|
|
136
|
-
id: 'CLI-CONNECTION-TIMEOUT',
|
|
137
|
-
statement:
|
|
138
|
-
'The CLI accepts only a positive integer timeout before constructing a Client Session, applies it to source-Auth and Session operations, and requires exchanged and destination-carrier authority to cover that timeout plus the bounded receipt margin before destination dispatch.',
|
|
139
|
-
tests: [
|
|
140
|
-
{
|
|
141
|
-
file: '__tests__/session.test.ts',
|
|
142
|
-
id: 'TEST-CLI-CONNECTION-REJECTS-INVALID-TIMEOUT-BEFORE-OPEN',
|
|
143
|
-
},
|
|
144
|
-
{
|
|
145
|
-
file: '__tests__/credential.test.ts',
|
|
146
|
-
id: 'TEST-CLI-CONNECTION-CARRIER-COVERS-COMMAND-TIMEOUT',
|
|
147
|
-
},
|
|
148
|
-
{
|
|
149
|
-
file: '__tests__/exchange.test.ts',
|
|
150
|
-
id: 'TEST-CLI-EXCHANGE-REJECTS-INSUFFICIENT-LIFETIME',
|
|
151
|
-
},
|
|
152
|
-
],
|
|
153
|
-
})
|
|
154
|
-
|
|
155
|
-
export const CLI_CONNECTION_CA_SCOPE = defineLaw({
|
|
156
|
-
id: 'CLI-CONNECTION-CA-SCOPE',
|
|
157
|
-
statement:
|
|
158
|
-
'A selected bookmark CA file changes only the Fetch capability owned by this connection and leaves non-HTTPS requests on the injected fallback Fetch.',
|
|
159
|
-
tests: [
|
|
160
|
-
{
|
|
161
|
-
file: '__tests__/ca-fetch.test.ts',
|
|
162
|
-
id: 'TEST-CLI-CONNECTION-SCOPES-CUSTOM-CA-TO-HTTPS-FETCH',
|
|
163
|
-
},
|
|
164
|
-
],
|
|
165
|
-
})
|
|
166
|
-
|
|
167
|
-
export const CLI_CONNECTION_CALL_SHAPE = defineLaw({
|
|
168
|
-
id: 'CLI-CONNECTION-CALL-SHAPE',
|
|
169
|
-
statement:
|
|
170
|
-
'Caller-authored path text and input enter Client as exactly one public Call; the CLI retains no optional callable hint, caller ETag, or second dispatch representation.',
|
|
171
|
-
tests: [
|
|
172
|
-
{
|
|
173
|
-
file: '__tests__/call.test.ts',
|
|
174
|
-
id: 'TEST-CLI-CONNECTION-CREATES-ONE-CANONICAL-CALL',
|
|
175
|
-
},
|
|
176
|
-
],
|
|
177
|
-
})
|
|
178
|
-
|
|
179
|
-
export const CLI_CONNECTION_PUBLIC_SEMANTIC_REASON = defineLaw({
|
|
180
|
-
id: 'CLI-CONNECTION-PUBLIC-SEMANTIC-REASON',
|
|
181
|
-
statement:
|
|
182
|
-
'Machine-mode Kernel command failures preserve the admitted ResponseError code and public semantic reason so scripts can distinguish conflicts such as revision guards and required data migrations without parsing prose.',
|
|
183
|
-
tests: [
|
|
184
|
-
{
|
|
185
|
-
file: '__tests__/errors.test.ts',
|
|
186
|
-
id: 'TEST-CLI-CONNECTION-PRESERVES-PUBLIC-SEMANTIC-REASON',
|
|
187
|
-
},
|
|
188
|
-
],
|
|
189
|
-
})
|
|
190
|
-
|
|
191
|
-
export const CLI_CONNECTION_TYPED_ERROR_PRESENTATION = defineLaw({
|
|
192
|
-
id: 'CLI-CONNECTION-TYPED-ERROR-PRESENTATION',
|
|
193
|
-
statement:
|
|
194
|
-
'The command boundary maps typed Client failure identity, transport context, phase, and invocation-only delivery evidence without parsing a private cause; acquisition never receives retry advice, unknown native failures have one non-blank unexpected diagnostic, and raw causes appear only under explicit debug output.',
|
|
195
|
-
tests: [
|
|
196
|
-
{
|
|
197
|
-
file: '__tests__/errors.test.ts',
|
|
198
|
-
id: 'TEST-CLI-CONNECTION-MAPS-TYPED-TRANSPORT',
|
|
199
|
-
},
|
|
200
|
-
{
|
|
201
|
-
file: '__tests__/errors.test.ts',
|
|
202
|
-
id: 'TEST-CLI-CONNECTION-PRESENTS-BOUNDED-REPAIRS',
|
|
203
|
-
},
|
|
204
|
-
{
|
|
205
|
-
file: '__tests__/reasons.test.ts',
|
|
206
|
-
id: 'TEST-CLI-CONNECTION-ADMITS-BOUNDED-REASONS',
|
|
207
|
-
},
|
|
208
|
-
{
|
|
209
|
-
file: '__tests__/failure-safety.test.ts',
|
|
210
|
-
id: 'TEST-CLI-CONNECTION-FAILURE-SAFETY',
|
|
211
|
-
},
|
|
212
|
-
],
|
|
213
|
-
})
|
|
@@ -1,22 +0,0 @@
|
|
|
1
|
-
import { defineLayout } from '@astrale-os/spec/authoring'
|
|
2
|
-
|
|
3
|
-
export default defineLayout({
|
|
4
|
-
entries: [
|
|
5
|
-
'__tests__/',
|
|
6
|
-
'auth.ts',
|
|
7
|
-
'call.ts',
|
|
8
|
-
'command.ts',
|
|
9
|
-
'credential.ts',
|
|
10
|
-
'errors.ts',
|
|
11
|
-
'failure/',
|
|
12
|
-
'exchange.ts',
|
|
13
|
-
'index.ts',
|
|
14
|
-
'lifetime.ts',
|
|
15
|
-
'reasons.ts',
|
|
16
|
-
'self.ts',
|
|
17
|
-
'session.ts',
|
|
18
|
-
'target.ts',
|
|
19
|
-
'tsconfig.json',
|
|
20
|
-
],
|
|
21
|
-
exact: true,
|
|
22
|
-
})
|
|
@@ -1,129 +0,0 @@
|
|
|
1
|
-
import { describe, expect, test } from 'bun:test'
|
|
2
|
-
|
|
3
|
-
import type { Identity } from '../../identity/index'
|
|
4
|
-
import type { AstraleConfig } from '../../lib/config'
|
|
5
|
-
|
|
6
|
-
import { IdpAudienceMismatchError } from '../../lib/idp'
|
|
7
|
-
import { IdpSessionNoRefreshTokenError } from '../../lib/idp-session'
|
|
8
|
-
import { classifyNoRefreshTokenError, resolveKeyIdentityAuthOptions } from '../auth'
|
|
9
|
-
|
|
10
|
-
const config: AstraleConfig = {
|
|
11
|
-
issuer: 'https://unregistered.invalid',
|
|
12
|
-
admin: {
|
|
13
|
-
name: 'admin',
|
|
14
|
-
url: 'https://admin.eu.astrale.ai/api',
|
|
15
|
-
kernelIssuer: 'https://admin.eu.astrale.ai/api',
|
|
16
|
-
},
|
|
17
|
-
telemetry: { enabled: true },
|
|
18
|
-
browser: {},
|
|
19
|
-
}
|
|
20
|
-
|
|
21
|
-
describe('resolveKeyIdentityAuthOptions', () => {
|
|
22
|
-
test('uses key identity issuer before global config issuer', () => {
|
|
23
|
-
const identity: Identity = {
|
|
24
|
-
subject: 'system',
|
|
25
|
-
source: 'key',
|
|
26
|
-
mode: 'local',
|
|
27
|
-
issuer: 'https://51-15-255-161.sslip.io',
|
|
28
|
-
createdAt: '2026-01-01T00:00:00.000Z',
|
|
29
|
-
}
|
|
30
|
-
|
|
31
|
-
expect(
|
|
32
|
-
resolveKeyIdentityAuthOptions(identity, config, 'https://51-15-255-161.sslip.io', 'scw-e2e'),
|
|
33
|
-
).toEqual({
|
|
34
|
-
issuer: 'https://51-15-255-161.sslip.io',
|
|
35
|
-
subject: undefined,
|
|
36
|
-
audience: 'https://51-15-255-161.sslip.io',
|
|
37
|
-
})
|
|
38
|
-
})
|
|
39
|
-
|
|
40
|
-
test('uses target audience as issuer for imported system bootstrap identities', () => {
|
|
41
|
-
const identity: Identity = {
|
|
42
|
-
subject: 'system',
|
|
43
|
-
source: 'key',
|
|
44
|
-
mode: 'local',
|
|
45
|
-
createdAt: '2026-01-01T00:00:00.000Z',
|
|
46
|
-
}
|
|
47
|
-
|
|
48
|
-
expect(
|
|
49
|
-
resolveKeyIdentityAuthOptions(identity, config, 'https://51-15-255-161.sslip.io', 'scw-e2e'),
|
|
50
|
-
).toEqual({
|
|
51
|
-
issuer: 'https://51-15-255-161.sslip.io',
|
|
52
|
-
subject: undefined,
|
|
53
|
-
audience: 'https://51-15-255-161.sslip.io',
|
|
54
|
-
})
|
|
55
|
-
})
|
|
56
|
-
|
|
57
|
-
test('registration issuer and subject still override identity issuer', () => {
|
|
58
|
-
const identity: Identity = {
|
|
59
|
-
subject: 'alice',
|
|
60
|
-
source: 'key',
|
|
61
|
-
mode: 'local',
|
|
62
|
-
issuer: 'https://identity.example.com',
|
|
63
|
-
createdAt: '2026-01-01T00:00:00.000Z',
|
|
64
|
-
registrations: {
|
|
65
|
-
prod: {
|
|
66
|
-
iss: 'https://prod.example.com/iss/thumbprint',
|
|
67
|
-
sub: 'node-1',
|
|
68
|
-
registeredAt: '2026-01-01T00:00:00.000Z',
|
|
69
|
-
},
|
|
70
|
-
},
|
|
71
|
-
}
|
|
72
|
-
|
|
73
|
-
expect(
|
|
74
|
-
resolveKeyIdentityAuthOptions(identity, config, 'https://prod.example.com', 'prod'),
|
|
75
|
-
).toEqual({
|
|
76
|
-
issuer: 'https://prod.example.com/iss/thumbprint',
|
|
77
|
-
subject: 'node-1',
|
|
78
|
-
audience: 'https://prod.example.com',
|
|
79
|
-
})
|
|
80
|
-
})
|
|
81
|
-
|
|
82
|
-
/** @evidence TEST-CLI-AUTH-USES-DIRECT-URL-REGISTRATION */
|
|
83
|
-
test('uses a registration stored for a direct URL target', () => {
|
|
84
|
-
const url = 'https://kernel.example/invoke'
|
|
85
|
-
const identity: Identity = {
|
|
86
|
-
subject: 'alice',
|
|
87
|
-
source: 'key',
|
|
88
|
-
mode: 'local',
|
|
89
|
-
createdAt: '2026-01-01T00:00:00.000Z',
|
|
90
|
-
registrations: {
|
|
91
|
-
[url]: {
|
|
92
|
-
iss: 'https://kernel.example/identity/alice',
|
|
93
|
-
sub: 'alice-node',
|
|
94
|
-
registeredAt: '2026-01-01T00:00:00.000Z',
|
|
95
|
-
},
|
|
96
|
-
},
|
|
97
|
-
}
|
|
98
|
-
|
|
99
|
-
expect(resolveKeyIdentityAuthOptions(identity, config, 'https://kernel.example', url)).toEqual({
|
|
100
|
-
issuer: 'https://kernel.example/identity/alice',
|
|
101
|
-
subject: 'alice-node',
|
|
102
|
-
audience: 'https://kernel.example',
|
|
103
|
-
})
|
|
104
|
-
})
|
|
105
|
-
})
|
|
106
|
-
|
|
107
|
-
describe('classifyNoRefreshTokenError', () => {
|
|
108
|
-
test('preserves expiry when the non-refreshable session already targets the required audience', () => {
|
|
109
|
-
const expired = new IdpSessionNoRefreshTokenError('alice')
|
|
110
|
-
|
|
111
|
-
expect(
|
|
112
|
-
classifyNoRefreshTokenError('https://kernel.example', 'https://kernel.example', expired),
|
|
113
|
-
).toBe(expired)
|
|
114
|
-
})
|
|
115
|
-
|
|
116
|
-
test('reports a real audience mismatch when the source audience differs', () => {
|
|
117
|
-
const result = classifyNoRefreshTokenError(
|
|
118
|
-
'https://child.example',
|
|
119
|
-
'https://manager.example',
|
|
120
|
-
new IdpSessionNoRefreshTokenError('alice'),
|
|
121
|
-
)
|
|
122
|
-
|
|
123
|
-
expect(result).toBeInstanceOf(IdpAudienceMismatchError)
|
|
124
|
-
expect(result).toMatchObject({
|
|
125
|
-
requested: 'https://child.example',
|
|
126
|
-
actual: 'https://manager.example',
|
|
127
|
-
})
|
|
128
|
-
})
|
|
129
|
-
})
|