@crouton-kit/crouter 0.3.32 → 0.3.33
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +8 -0
- package/dist/build-root.js +1 -0
- package/dist/builtin-memory/crouter-development/marketplaces.md +2 -2
- package/dist/builtin-memory/crouter-development/personas/base-prompt.md +2 -2
- package/dist/builtin-memory/crouter-development/personas/orchestrator-prompt.md +5 -5
- package/dist/builtin-memory/crouter-development/personas.md +3 -4
- package/dist/builtin-memory/crouter-development/plugins.md +18 -18
- package/dist/builtin-memory/design.md +4 -1
- package/dist/builtin-memory/development.md +4 -1
- package/dist/builtin-memory/internal/INDEX.md +1 -1
- package/dist/builtin-memory/internal/nodes-and-canvas.md +6 -6
- package/dist/builtin-memory/internal/storage-tiers.md +5 -5
- package/dist/builtin-memory/planning.md +4 -1
- package/dist/builtin-memory/product.md +80 -0
- package/dist/builtin-memory/spec.md +4 -1
- package/dist/builtin-personas/advisor/PERSONA.md +10 -0
- package/dist/builtin-personas/design/PERSONA.md +2 -2
- package/dist/builtin-personas/design/orchestrator.md +3 -3
- package/dist/builtin-personas/developer/PERSONA.md +1 -1
- package/dist/builtin-personas/developer/orchestrator.md +2 -2
- package/dist/builtin-personas/explore/PERSONA.md +3 -3
- package/dist/builtin-personas/explore/orchestrator.md +4 -2
- package/dist/builtin-personas/general/PERSONA.md +1 -1
- package/dist/builtin-personas/general/orchestrator.md +1 -1
- package/dist/builtin-personas/orchestration-kernel.md +7 -14
- package/dist/builtin-personas/plan/PERSONA.md +1 -1
- package/dist/builtin-personas/plan/orchestrator.md +2 -2
- package/dist/builtin-personas/plan/reviewers/architecture-fit/PERSONA.md +1 -1
- package/dist/builtin-personas/plan/reviewers/code-smells/PERSONA.md +1 -1
- package/dist/builtin-personas/plan/reviewers/pattern-consistency/PERSONA.md +1 -1
- package/dist/builtin-personas/plan/reviewers/requirements-coverage/PERSONA.md +1 -1
- package/dist/builtin-personas/plan/reviewers/security/PERSONA.md +1 -1
- package/dist/builtin-personas/product/PERSONA.md +18 -0
- package/dist/builtin-personas/product/orchestrator.md +14 -0
- package/dist/builtin-personas/product/teardown/PERSONA.md +13 -0
- package/dist/builtin-personas/review/PERSONA.md +1 -1
- package/dist/builtin-personas/review/orchestrator.md +1 -1
- package/dist/builtin-personas/runtime-base.md +5 -0
- package/dist/builtin-personas/spec/PERSONA.md +1 -1
- package/dist/builtin-personas/spec/orchestrator.md +2 -2
- package/dist/builtin-personas/spec/requirements/PERSONA.md +1 -1
- package/dist/builtin-views/canvas/core.mjs +82 -1
- package/dist/builtin-views/canvas/tui.mjs +9 -5
- package/dist/builtin-views/canvas/web.jsx +3 -2
- package/dist/builtin-views/chat/core.mjs +725 -0
- package/dist/builtin-views/chat/text.mjs +101 -0
- package/dist/builtin-views/chat/tui.mjs +368 -0
- package/dist/builtin-views/chat/web.jsx +367 -0
- package/dist/builtin-views/prompt-review/core.mjs +863 -0
- package/dist/builtin-views/prompt-review/text.mjs +15 -0
- package/dist/builtin-views/prompt-review/tui.mjs +196 -0
- package/dist/builtin-views/prompt-review/web.jsx +484 -0
- package/dist/builtin-views/settings/core.mjs +397 -0
- package/dist/builtin-views/settings/text.mjs +40 -0
- package/dist/builtin-views/settings/tui.mjs +95 -0
- package/dist/builtin-views/settings/web.jsx +167 -0
- package/dist/cli.js +16 -3
- package/dist/clients/attach/__tests__/autocomplete-and-bash-mode.test.js +96 -0
- package/dist/clients/attach/__tests__/bash-bang-routing.test.js +58 -0
- package/dist/clients/attach/__tests__/bundle-pi-tui-dedup.test.d.ts +1 -0
- package/dist/clients/attach/__tests__/bundle-pi-tui-dedup.test.js +56 -0
- package/dist/clients/attach/__tests__/titled-editor.test.js +22 -1
- package/dist/clients/attach/attach-cmd.d.ts +18 -0
- package/dist/clients/attach/attach-cmd.js +1723 -795
- package/dist/clients/attach/canvas-panels.js +2 -2
- package/dist/clients/attach/chat-view.d.ts +10 -0
- package/dist/clients/attach/chat-view.js +23 -0
- package/dist/clients/attach/config-load.d.ts +8 -4
- package/dist/clients/attach/config-load.js +2 -0
- package/dist/clients/attach/extension-dialogs.d.ts +2 -3
- package/dist/clients/attach/extension-dialogs.js +7 -9
- package/dist/clients/attach/graph-overlay.js +3 -2
- package/dist/clients/attach/input-controller.d.ts +4 -3
- package/dist/clients/attach/input-controller.js +24 -3
- package/dist/clients/attach/slash-commands.d.ts +7 -7
- package/dist/clients/attach/slash-commands.js +38 -14
- package/dist/clients/attach/titled-editor.js +18 -14
- package/dist/clients/attach/view-socket.d.ts +2 -1
- package/dist/clients/attach/view-socket.js +27 -8
- package/dist/clients/web/__tests__/source-cache.test.d.ts +1 -0
- package/dist/clients/web/__tests__/source-cache.test.js +32 -0
- package/dist/clients/web/dev-server.js +1 -0
- package/dist/clients/web/events.js +9 -11
- package/dist/clients/web/server.d.ts +4 -3
- package/dist/clients/web/server.js +138 -31
- package/dist/clients/web/source-cache.d.ts +10 -0
- package/dist/clients/web/source-cache.js +57 -0
- package/dist/clients/web/web-cmd.js +28 -9
- package/dist/commands/__tests__/human.test.js +30 -28
- package/dist/commands/canvas-history/search.js +1 -1
- package/dist/commands/canvas-history.js +5 -8
- package/dist/commands/canvas-issue.d.ts +2 -0
- package/dist/commands/canvas-issue.js +148 -0
- package/dist/commands/canvas-prune.js +19 -0
- package/dist/commands/canvas-rebuild-index.d.ts +2 -0
- package/dist/commands/canvas-rebuild-index.js +57 -0
- package/dist/commands/canvas-snapshot.d.ts +2 -0
- package/dist/commands/canvas-snapshot.js +48 -0
- package/dist/commands/canvas-tmux-spread.d.ts +2 -0
- package/dist/commands/canvas-tmux-spread.js +188 -0
- package/dist/commands/canvas.d.ts +1 -0
- package/dist/commands/canvas.js +16 -1
- package/dist/commands/chord.js +143 -48
- package/dist/commands/daemon.js +3 -3
- package/dist/commands/human/prompts.d.ts +0 -1
- package/dist/commands/human/prompts.js +39 -54
- package/dist/commands/human/queue.d.ts +12 -1
- package/dist/commands/human/queue.js +468 -73
- package/dist/commands/human/shared.d.ts +3 -4
- package/dist/commands/human/shared.js +3 -3
- package/dist/commands/human.js +11 -10
- package/dist/commands/memory/find.js +3 -2
- package/dist/commands/memory/list.js +4 -3
- package/dist/commands/memory/read.js +3 -3
- package/dist/commands/memory/shared.d.ts +1 -4
- package/dist/commands/memory/shared.js +6 -9
- package/dist/commands/memory/write.js +3 -3
- package/dist/commands/memory.js +4 -7
- package/dist/commands/node-context.d.ts +2 -0
- package/dist/commands/node-context.js +172 -0
- package/dist/commands/node-snapshot.d.ts +2 -0
- package/dist/commands/node-snapshot.js +123 -0
- package/dist/commands/node.js +228 -52
- package/dist/commands/pkg/plugin-inspect.js +6 -6
- package/dist/commands/pkg/plugin-manage.js +1 -1
- package/dist/commands/pkg/plugin.js +2 -2
- package/dist/commands/pkg.js +2 -2
- package/dist/commands/push.d.ts +2 -0
- package/dist/commands/push.js +79 -11
- package/dist/commands/revive.js +74 -1
- package/dist/commands/search/answer.d.ts +1 -0
- package/dist/commands/search/answer.js +50 -0
- package/dist/commands/search/contents.d.ts +1 -0
- package/dist/commands/search/contents.js +96 -0
- package/dist/commands/search/exa.d.ts +53 -0
- package/dist/commands/search/exa.js +155 -0
- package/dist/commands/search/puremd.d.ts +11 -0
- package/dist/commands/search/puremd.js +53 -0
- package/dist/commands/search/web.d.ts +1 -0
- package/dist/commands/search/web.js +65 -0
- package/dist/commands/search.d.ts +2 -0
- package/dist/commands/search.js +24 -0
- package/dist/commands/sys/__tests__/sync-import.test.d.ts +1 -0
- package/dist/commands/sys/__tests__/sync-import.test.js +72 -0
- package/dist/commands/sys/config.js +59 -10
- package/dist/commands/sys/doctor.js +56 -4
- package/dist/commands/sys/prompt-review.d.ts +1 -0
- package/dist/commands/sys/prompt-review.js +178 -0
- package/dist/commands/sys/promptstudio.d.ts +2 -0
- package/dist/commands/sys/promptstudio.js +65 -0
- package/dist/commands/sys/settings.d.ts +2 -0
- package/dist/commands/sys/settings.js +16 -0
- package/dist/commands/sys/sync.js +311 -159
- package/dist/commands/sys/sysprompt.d.ts +1 -0
- package/dist/commands/sys/sysprompt.js +86 -0
- package/dist/commands/sys.js +9 -5
- package/dist/commands/view-new.js +2 -2
- package/dist/core/__tests__/artifact-paths.test.d.ts +1 -0
- package/dist/core/__tests__/artifact-paths.test.js +44 -0
- package/dist/core/__tests__/broker-preflight.test.d.ts +1 -0
- package/dist/core/__tests__/broker-preflight.test.js +85 -0
- package/dist/core/__tests__/broker-sdk-wiring.test.js +15 -0
- package/dist/core/__tests__/canvas.test.js +37 -1
- package/dist/core/__tests__/chat-view-reconnect.test.d.ts +1 -0
- package/dist/core/__tests__/chat-view-reconnect.test.js +70 -0
- package/dist/core/__tests__/child-death-wake.test.js +11 -2
- package/dist/core/__tests__/close.test.js +39 -1
- package/dist/core/__tests__/connection-reconnect-resume.test.d.ts +1 -0
- package/dist/core/__tests__/connection-reconnect-resume.test.js +37 -0
- package/dist/core/__tests__/context-intro.test.js +48 -14
- package/dist/core/__tests__/daemon-boot.test.js +182 -9
- package/dist/core/__tests__/editor-label.test.d.ts +1 -0
- package/dist/core/__tests__/editor-label.test.js +26 -0
- package/dist/core/__tests__/fault-marker.test.d.ts +1 -0
- package/dist/core/__tests__/fault-marker.test.js +112 -0
- package/dist/core/__tests__/fault-retry-rewind.test.d.ts +1 -0
- package/dist/core/__tests__/fault-retry-rewind.test.js +123 -0
- package/dist/core/__tests__/fixtures/fake-engine.d.ts +30 -4
- package/dist/core/__tests__/fixtures/fake-engine.js +156 -17
- package/dist/core/__tests__/fixtures/fake-pi-host.js +10 -1
- package/dist/core/__tests__/full/human-new-window-regression.test.js +1 -1
- package/dist/core/__tests__/helpers/harness.d.ts +1 -1
- package/dist/core/__tests__/helpers/harness.js +2 -2
- package/dist/core/__tests__/human-stranded-deliver.test.js +38 -1
- package/dist/core/__tests__/human-surface-target.test.js +1 -1
- package/dist/core/__tests__/kickoff.test.js +18 -19
- package/dist/core/__tests__/memory-resolver.test.js +12 -1
- package/dist/core/__tests__/migration.test.js +49 -14
- package/dist/core/__tests__/model-ladders.test.d.ts +1 -0
- package/dist/core/__tests__/model-ladders.test.js +160 -0
- package/dist/core/__tests__/node-env.test.d.ts +1 -0
- package/dist/core/__tests__/node-env.test.js +26 -0
- package/dist/core/__tests__/push-final-guard.test.js +7 -1
- package/dist/core/__tests__/relaunch-root.test.js +9 -9
- package/dist/core/__tests__/revive.test.js +36 -6
- package/dist/core/__tests__/spawn-root.test.js +24 -1
- package/dist/core/__tests__/stop-guard.test.js +10 -0
- package/dist/core/__tests__/stranded-relaunch.test.d.ts +1 -0
- package/dist/core/__tests__/stranded-relaunch.test.js +72 -0
- package/dist/core/__tests__/tmux-surface.test.js +5 -1
- package/dist/core/__tests__/unknown-path.test.js +19 -19
- package/dist/core/__tests__/yield-ensures-daemon.test.d.ts +1 -0
- package/dist/core/__tests__/yield-ensures-daemon.test.js +54 -0
- package/dist/core/artifact.d.ts +2 -33
- package/dist/core/artifact.js +27 -87
- package/dist/core/bootstrap.js +2 -0
- package/dist/core/canvas/browse/__tests__/model.test.js +35 -1
- package/dist/core/canvas/browse/app.js +87 -17
- package/dist/core/canvas/browse/model.d.ts +10 -1
- package/dist/core/canvas/browse/model.js +37 -1
- package/dist/core/canvas/browse/render.js +35 -33
- package/dist/core/canvas/canvas.d.ts +7 -0
- package/dist/core/canvas/canvas.js +54 -5
- package/dist/core/canvas/db.js +35 -8
- package/dist/core/canvas/labels.d.ts +6 -8
- package/dist/core/canvas/labels.js +8 -11
- package/dist/core/canvas/nav-model.d.ts +5 -4
- package/dist/core/canvas/nav-model.js +31 -17
- package/dist/core/canvas/paths.d.ts +18 -1
- package/dist/core/canvas/paths.js +31 -2
- package/dist/core/canvas/render.d.ts +25 -0
- package/dist/core/canvas/render.js +96 -13
- package/dist/core/canvas/status-glyph.d.ts +35 -0
- package/dist/core/canvas/status-glyph.js +104 -0
- package/dist/core/canvas/types.d.ts +2 -2
- package/dist/core/config.js +114 -16
- package/dist/core/fault-classifier.d.ts +41 -0
- package/dist/core/fault-classifier.js +110 -0
- package/dist/core/feed/inbox.d.ts +15 -0
- package/dist/core/feed/inbox.js +40 -14
- package/dist/core/frontmatter.d.ts +1 -11
- package/dist/core/frontmatter.js +1 -55
- package/dist/core/hearth/config.d.ts +2 -0
- package/dist/core/hearth/config.js +75 -0
- package/dist/core/hearth/guest-env.d.ts +2 -0
- package/dist/core/hearth/guest-env.js +11 -0
- package/dist/core/hearth/index.d.ts +5 -0
- package/dist/core/hearth/index.js +5 -0
- package/dist/core/hearth/provider.d.ts +21 -0
- package/dist/core/hearth/provider.js +10 -0
- package/dist/core/hearth/providers/blaxel-bootstrap.d.ts +10 -0
- package/dist/core/hearth/providers/blaxel-bootstrap.js +39 -0
- package/dist/core/hearth/providers/blaxel-home.d.ts +11 -0
- package/dist/core/hearth/providers/blaxel-home.js +126 -0
- package/dist/core/hearth/providers/blaxel.d.ts +26 -0
- package/dist/core/hearth/providers/blaxel.js +208 -0
- package/dist/core/hearth/providers/types.d.ts +72 -0
- package/dist/core/hearth/providers/types.js +1 -0
- package/dist/core/hearth/registry.d.ts +15 -0
- package/dist/core/hearth/registry.js +179 -0
- package/dist/core/hearth/types.d.ts +121 -0
- package/dist/core/hearth/types.js +1 -0
- package/dist/core/host-exports/__tests__/export-prunes-boot-skill.test.d.ts +1 -0
- package/dist/core/host-exports/__tests__/export-prunes-boot-skill.test.js +79 -0
- package/dist/core/{skill-sync → host-exports}/builtins.d.ts +21 -13
- package/dist/core/host-exports/builtins.js +68 -0
- package/dist/core/{skill-sync → host-exports}/export.d.ts +9 -6
- package/dist/core/{skill-sync → host-exports}/export.js +37 -14
- package/dist/core/io.js +1 -1
- package/dist/core/log.d.ts +9 -0
- package/dist/core/log.js +113 -0
- package/dist/core/memory-resolver.d.ts +8 -8
- package/dist/core/memory-resolver.js +15 -28
- package/dist/core/personas/index.d.ts +4 -4
- package/dist/core/personas/index.js +2 -2
- package/dist/core/personas/loader.d.ts +51 -0
- package/dist/core/personas/loader.js +54 -50
- package/dist/core/personas/resolve.d.ts +43 -27
- package/dist/core/personas/resolve.js +336 -94
- package/dist/core/runtime/auth-reload.d.ts +7 -0
- package/dist/core/runtime/auth-reload.js +69 -0
- package/dist/core/runtime/bearings.d.ts +35 -15
- package/dist/core/runtime/bearings.js +305 -44
- package/dist/core/runtime/branded-host.d.ts +4 -2
- package/dist/core/runtime/branded-host.js +66 -4
- package/dist/core/runtime/broker-protocol.d.ts +38 -3
- package/dist/core/runtime/broker.js +343 -18
- package/dist/core/runtime/close.js +37 -29
- package/dist/core/runtime/connectivity.d.ts +12 -0
- package/dist/core/runtime/connectivity.js +73 -0
- package/dist/core/runtime/fault-recovery-nudge.d.ts +2 -0
- package/dist/core/runtime/fault-recovery-nudge.js +2 -0
- package/dist/core/runtime/fault-recovery.d.ts +23 -0
- package/dist/core/runtime/fault-recovery.js +74 -0
- package/dist/core/runtime/fault.d.ts +25 -0
- package/dist/core/runtime/fault.js +176 -0
- package/dist/core/runtime/front-door.d.ts +1 -1
- package/dist/core/runtime/front-door.js +2 -2
- package/dist/core/runtime/host.d.ts +10 -0
- package/dist/core/runtime/host.js +71 -9
- package/dist/core/runtime/kickoff.js +31 -45
- package/dist/core/runtime/launch.d.ts +32 -18
- package/dist/core/runtime/launch.js +148 -43
- package/dist/core/runtime/model-swap.d.ts +18 -0
- package/dist/core/runtime/model-swap.js +95 -0
- package/dist/core/runtime/naming.d.ts +7 -0
- package/dist/core/runtime/naming.js +61 -9
- package/dist/core/runtime/nodes.js +6 -1
- package/dist/core/runtime/persona.js +16 -17
- package/dist/core/runtime/placement.d.ts +36 -31
- package/dist/core/runtime/placement.js +149 -64
- package/dist/core/runtime/promote.d.ts +2 -0
- package/dist/core/runtime/promote.js +23 -3
- package/dist/core/runtime/recycle.js +6 -4
- package/dist/core/runtime/reset.d.ts +5 -2
- package/dist/core/runtime/reset.js +2 -2
- package/dist/core/runtime/revive.d.ts +4 -0
- package/dist/core/runtime/revive.js +27 -9
- package/dist/core/runtime/roadmap.d.ts +1 -1
- package/dist/core/runtime/roadmap.js +1 -1
- package/dist/core/runtime/spawn.d.ts +2 -2
- package/dist/core/runtime/spawn.js +30 -6
- package/dist/core/runtime/stop-guard.js +6 -1
- package/dist/core/runtime/tmux-chrome.d.ts +1 -1
- package/dist/core/runtime/tmux-chrome.js +1 -1
- package/dist/core/runtime/tmux.d.ts +29 -6
- package/dist/core/runtime/tmux.js +134 -80
- package/dist/core/runtime/view-socket-client.d.ts +46 -0
- package/dist/core/runtime/view-socket-client.js +203 -0
- package/dist/core/substrate/index.d.ts +1 -1
- package/dist/core/substrate/index.js +1 -1
- package/dist/core/substrate/on-read.js +16 -4
- package/dist/core/substrate/render.d.ts +10 -13
- package/dist/core/substrate/render.js +56 -51
- package/dist/core/tui/host.js +83 -18
- package/dist/core/view/__tests__/transport-cache.test.d.ts +1 -0
- package/dist/core/view/__tests__/transport-cache.test.js +62 -0
- package/dist/core/view/contract.d.ts +20 -0
- package/dist/core/view/stream-local.d.ts +3 -0
- package/dist/core/view/stream-local.js +184 -0
- package/dist/core/view/transport-cache.d.ts +8 -0
- package/dist/core/view/transport-cache.js +38 -0
- package/dist/core/view/transport-local.js +4 -0
- package/dist/core/view/transport.d.ts +7 -1
- package/dist/daemon/crtrd.d.ts +3 -19
- package/dist/daemon/crtrd.js +139 -178
- package/dist/daemon/manage.d.ts +18 -1
- package/dist/daemon/manage.js +54 -9
- package/dist/hearth/wake-proxy/__tests__/anthropic-oauth.test.d.ts +1 -0
- package/dist/hearth/wake-proxy/__tests__/anthropic-oauth.test.js +289 -0
- package/dist/hearth/wake-proxy/__tests__/config-timeout.test.d.ts +1 -0
- package/dist/hearth/wake-proxy/__tests__/config-timeout.test.js +34 -0
- package/dist/hearth/wake-proxy/__tests__/guest-source.test.d.ts +1 -0
- package/dist/hearth/wake-proxy/__tests__/guest-source.test.js +203 -0
- package/dist/hearth/wake-proxy/__tests__/hardening.test.d.ts +1 -0
- package/dist/hearth/wake-proxy/__tests__/hardening.test.js +59 -0
- package/dist/hearth/wake-proxy/__tests__/hearth-status-route.test.d.ts +1 -0
- package/dist/hearth/wake-proxy/__tests__/hearth-status-route.test.js +372 -0
- package/dist/hearth/wake-proxy/__tests__/http-running-route-fast-path.test.d.ts +1 -0
- package/dist/hearth/wake-proxy/__tests__/http-running-route-fast-path.test.js +258 -0
- package/dist/hearth/wake-proxy/__tests__/model-auth-routes.test.d.ts +1 -0
- package/dist/hearth/wake-proxy/__tests__/model-auth-routes.test.js +437 -0
- package/dist/hearth/wake-proxy/__tests__/source-bridge-gate.test.d.ts +1 -0
- package/dist/hearth/wake-proxy/__tests__/source-bridge-gate.test.js +455 -0
- package/dist/hearth/wake-proxy/__tests__/static-asset-allowlist.test.d.ts +1 -0
- package/dist/hearth/wake-proxy/__tests__/static-asset-allowlist.test.js +15 -0
- package/dist/hearth/wake-proxy/__tests__/warm-path-concurrency.test.d.ts +1 -0
- package/dist/hearth/wake-proxy/__tests__/warm-path-concurrency.test.js +141 -0
- package/dist/hearth/wake-proxy/__tests__/ws-teardown-accounting.test.d.ts +1 -0
- package/dist/hearth/wake-proxy/__tests__/ws-teardown-accounting.test.js +143 -0
- package/dist/hearth/wake-proxy/anthropic-oauth.d.ts +58 -0
- package/dist/hearth/wake-proxy/anthropic-oauth.js +189 -0
- package/dist/hearth/wake-proxy/auth.d.ts +22 -0
- package/dist/hearth/wake-proxy/auth.js +128 -0
- package/dist/hearth/wake-proxy/config.d.ts +2 -0
- package/dist/hearth/wake-proxy/config.js +151 -0
- package/dist/hearth/wake-proxy/guest-source.d.ts +14 -0
- package/dist/hearth/wake-proxy/guest-source.js +130 -0
- package/dist/hearth/wake-proxy/hearth-status.d.ts +44 -0
- package/dist/hearth/wake-proxy/hearth-status.js +267 -0
- package/dist/hearth/wake-proxy/home.d.ts +67 -0
- package/dist/hearth/wake-proxy/home.js +297 -0
- package/dist/hearth/wake-proxy/main.d.ts +1 -0
- package/dist/hearth/wake-proxy/main.js +134 -0
- package/dist/hearth/wake-proxy/model-auth.d.ts +13 -0
- package/dist/hearth/wake-proxy/model-auth.js +345 -0
- package/dist/hearth/wake-proxy/proxy.d.ts +35 -0
- package/dist/hearth/wake-proxy/proxy.js +716 -0
- package/dist/hearth/wake-proxy/public-source-gate.d.ts +9 -0
- package/dist/hearth/wake-proxy/public-source-gate.js +409 -0
- package/dist/hearth/wake-proxy/redact.d.ts +1 -0
- package/dist/hearth/wake-proxy/redact.js +17 -0
- package/dist/hearth/wake-proxy/server.d.ts +11 -0
- package/dist/hearth/wake-proxy/server.js +142 -0
- package/dist/hearth/wake-proxy/state.d.ts +18 -0
- package/dist/hearth/wake-proxy/state.js +342 -0
- package/dist/hearth/wake-proxy/types.d.ts +76 -0
- package/dist/hearth/wake-proxy/types.js +1 -0
- package/dist/index.js +3 -2
- package/dist/pi-extensions/__tests__/canvas-context-intro.test.js +6 -5
- package/dist/pi-extensions/canvas-context-intro.js +7 -7
- package/dist/pi-extensions/canvas-doc-substrate.js +19 -22
- package/dist/pi-extensions/canvas-nav.js +15 -8
- package/dist/pi-extensions/canvas-stophook.d.ts +1 -1
- package/dist/pi-extensions/canvas-stophook.js +78 -11
- package/dist/types.d.ts +39 -20
- package/dist/types.js +38 -13
- package/dist/web/runtime.js +141 -42
- package/dist/web/transport-http.js +7 -5
- package/dist/web/transport-stream.d.ts +3 -0
- package/dist/web/transport-stream.js +204 -0
- package/dist/web-client/assets/fragment-mono-latin-400-normal-BYwT3kSJ.woff +0 -0
- package/dist/web-client/assets/fragment-mono-latin-400-normal-yxdJ5AmL.woff2 +0 -0
- package/dist/web-client/assets/fragment-mono-latin-ext-400-normal-BbKYyvR9.woff2 +0 -0
- package/dist/web-client/assets/fragment-mono-latin-ext-400-normal-CT4YFKeK.woff +0 -0
- package/dist/web-client/assets/fraunces-latin-ext-wght-normal-Ca2vKHc0.woff2 +0 -0
- package/dist/web-client/assets/fraunces-latin-wght-normal-ukD16Tqj.woff2 +0 -0
- package/dist/web-client/assets/fraunces-vietnamese-wght-normal-CnvboYUG.woff2 +0 -0
- package/dist/web-client/assets/index-BZUxTkv5.css +2 -0
- package/dist/web-client/assets/index-D36PNBj4.js +80 -0
- package/dist/web-client/assets/instrument-sans-latin-ext-wght-normal-B5bTHO_g.woff2 +0 -0
- package/dist/web-client/assets/instrument-sans-latin-wght-normal-BbzFLZTg.woff2 +0 -0
- package/dist/web-client/assets/martian-mono-cyrillic-wght-normal-B84CD5C_.woff2 +0 -0
- package/dist/web-client/assets/martian-mono-latin-ext-wght-normal-DlL6xMw5.woff2 +0 -0
- package/dist/web-client/assets/martian-mono-latin-wght-normal-5W32yIyr.woff2 +0 -0
- package/dist/web-client/index.html +3 -2
- package/package.json +32 -10
- package/dist/core/__tests__/error-stall-recycle.test.js +0 -141
- package/dist/core/skill-sync/__tests__/dry-run-wrote-count.test.js +0 -57
- package/dist/core/skill-sync/builtins.js +0 -112
- package/dist/core/skill-sync/claude-plugins.d.ts +0 -23
- package/dist/core/skill-sync/claude-plugins.js +0 -71
- package/dist/core/skill-sync/engine.d.ts +0 -42
- package/dist/core/skill-sync/engine.js +0 -633
- package/dist/core/skill-sync/manifest.d.ts +0 -64
- package/dist/core/skill-sync/manifest.js +0 -181
- package/dist/core/skill-sync/profile.d.ts +0 -76
- package/dist/core/skill-sync/profile.js +0 -173
- package/dist/core/skill-sync/snapshot.d.ts +0 -57
- package/dist/core/skill-sync/snapshot.js +0 -120
- package/dist/pi-extensions/canvas-commands.d.ts +0 -37
- package/dist/pi-extensions/canvas-commands.js +0 -113
- package/dist/pi-extensions/canvas-resume.d.ts +0 -21
- package/dist/pi-extensions/canvas-resume.js +0 -83
- package/dist/pi-extensions/canvas-view.d.ts +0 -21
- package/dist/pi-extensions/canvas-view.js +0 -76
- package/dist/web-client/assets/index-BUvQb4hR.css +0 -2
- package/dist/web-client/assets/index-ClLQXYAE.js +0 -10
- /package/dist/{core/__tests__/error-stall-recycle.test.d.ts → clients/attach/__tests__/autocomplete-and-bash-mode.test.d.ts} +0 -0
- /package/dist/{core/skill-sync/__tests__/dry-run-wrote-count.test.d.ts → clients/attach/__tests__/bash-bang-routing.test.d.ts} +0 -0
|
@@ -0,0 +1,372 @@
|
|
|
1
|
+
import assert from 'node:assert/strict';
|
|
2
|
+
import { createHash } from 'node:crypto';
|
|
3
|
+
import { mkdirSync, mkdtempSync, writeFileSync } from 'node:fs';
|
|
4
|
+
import { tmpdir } from 'node:os';
|
|
5
|
+
import { join } from 'node:path';
|
|
6
|
+
import { Readable } from 'node:stream';
|
|
7
|
+
import { test } from 'node:test';
|
|
8
|
+
import { routeRequest } from '../server.js';
|
|
9
|
+
const ownerToken = 'owner-secret-token';
|
|
10
|
+
const ownerTokenHash = createHash('sha256').update(ownerToken, 'utf8').digest('hex');
|
|
11
|
+
const publicOrigin = 'https://hearth.example';
|
|
12
|
+
function makeRuntime(tenantId, statePath) {
|
|
13
|
+
return {
|
|
14
|
+
proxy: {
|
|
15
|
+
host: '127.0.0.1',
|
|
16
|
+
port: 7878,
|
|
17
|
+
publicOrigin,
|
|
18
|
+
statePath,
|
|
19
|
+
m0RegistryPath: join(statePath, 'homes.json'),
|
|
20
|
+
ownerUserId: 'owner-user',
|
|
21
|
+
defaultTenantId: tenantId,
|
|
22
|
+
ownerTokenHash,
|
|
23
|
+
idlePauseMs: 60_000,
|
|
24
|
+
wakeTimeoutMs: 30_000,
|
|
25
|
+
readyTimeoutMs: 2_000,
|
|
26
|
+
cookieSecure: true,
|
|
27
|
+
seedHome: null,
|
|
28
|
+
},
|
|
29
|
+
m0: {
|
|
30
|
+
providerName: 'none',
|
|
31
|
+
registryPath: join(statePath, 'homes.json'),
|
|
32
|
+
guestUser: 'agent',
|
|
33
|
+
guestHome: '/home/agent',
|
|
34
|
+
guestCodePath: '/opt/crouter',
|
|
35
|
+
webPort: 7878,
|
|
36
|
+
nodeKind: 'general',
|
|
37
|
+
piPackages: [],
|
|
38
|
+
piAuthJson: null,
|
|
39
|
+
relayToken: null,
|
|
40
|
+
},
|
|
41
|
+
};
|
|
42
|
+
}
|
|
43
|
+
function writeState(statePath, tenantId) {
|
|
44
|
+
mkdirSync(join(statePath, '..'), { recursive: true });
|
|
45
|
+
writeFileSync(statePath, `${JSON.stringify({
|
|
46
|
+
version: 1,
|
|
47
|
+
owner: {
|
|
48
|
+
ownerUserId: 'owner-user',
|
|
49
|
+
defaultTenantId: tenantId,
|
|
50
|
+
tokenHash: ownerTokenHash,
|
|
51
|
+
createdAt: '2026-06-26T00:00:00.000Z',
|
|
52
|
+
},
|
|
53
|
+
tenants: {},
|
|
54
|
+
}, null, 2)}\n`, 'utf8');
|
|
55
|
+
}
|
|
56
|
+
function writeHome(registryPath, home) {
|
|
57
|
+
mkdirSync(join(registryPath, '..'), { recursive: true });
|
|
58
|
+
writeFileSync(registryPath, `${JSON.stringify({
|
|
59
|
+
[home.tenantId]: home,
|
|
60
|
+
}, null, 2)}\n`, 'utf8');
|
|
61
|
+
}
|
|
62
|
+
function makeRequest(method, url, headers = {}, body = '') {
|
|
63
|
+
const req = new Readable({ read() { } });
|
|
64
|
+
req.method = method;
|
|
65
|
+
req.url = url;
|
|
66
|
+
req.headers = headers;
|
|
67
|
+
process.nextTick(() => {
|
|
68
|
+
if (body !== '')
|
|
69
|
+
req.push(body);
|
|
70
|
+
req.push(null);
|
|
71
|
+
});
|
|
72
|
+
return req;
|
|
73
|
+
}
|
|
74
|
+
function makeResponse() {
|
|
75
|
+
return {
|
|
76
|
+
statusCode: 200,
|
|
77
|
+
headersSent: false,
|
|
78
|
+
headers: {},
|
|
79
|
+
body: '',
|
|
80
|
+
writeHead(statusCode, headers) {
|
|
81
|
+
this.statusCode = statusCode;
|
|
82
|
+
this.headers = { ...this.headers, ...headers };
|
|
83
|
+
this.headersSent = true;
|
|
84
|
+
return this;
|
|
85
|
+
},
|
|
86
|
+
setHeader(name, value) {
|
|
87
|
+
this.headers[name.toLowerCase()] = value;
|
|
88
|
+
},
|
|
89
|
+
end(chunk) {
|
|
90
|
+
if (chunk !== undefined)
|
|
91
|
+
this.body += Buffer.isBuffer(chunk) ? chunk.toString('utf8') : chunk;
|
|
92
|
+
this.headersSent = true;
|
|
93
|
+
return this;
|
|
94
|
+
},
|
|
95
|
+
destroy() {
|
|
96
|
+
this.headersSent = true;
|
|
97
|
+
},
|
|
98
|
+
};
|
|
99
|
+
}
|
|
100
|
+
function parseJsonBody(res) {
|
|
101
|
+
return JSON.parse(res.body);
|
|
102
|
+
}
|
|
103
|
+
test('status route returns 401 without owner auth', async () => {
|
|
104
|
+
const tenantId = 'tenant-status-unauthenticated';
|
|
105
|
+
const tempDir = mkdtempSync(join(tmpdir(), 'crouter-hearth-status-unauth-'));
|
|
106
|
+
const statePath = join(tempDir, 'state.json');
|
|
107
|
+
writeState(statePath, tenantId);
|
|
108
|
+
const runtime = makeRuntime(tenantId, statePath);
|
|
109
|
+
const res = makeResponse();
|
|
110
|
+
const handled = await routeRequest(makeRequest('GET', '/__hearth/status'), res, runtime, {});
|
|
111
|
+
assert.equal(handled, undefined);
|
|
112
|
+
assert.equal(res.statusCode, 401);
|
|
113
|
+
});
|
|
114
|
+
test('status route returns runtime stats when existing relay already serves', async () => {
|
|
115
|
+
const tenantId = 'tenant-status-runtime';
|
|
116
|
+
const tempDir = mkdtempSync(join(tmpdir(), 'crouter-hearth-status-runtime-'));
|
|
117
|
+
const statePath = join(tempDir, 'state.json');
|
|
118
|
+
const registryPath = join(tempDir, 'homes.json');
|
|
119
|
+
writeState(statePath, tenantId);
|
|
120
|
+
const runtime = makeRuntime(tenantId, statePath);
|
|
121
|
+
runtime.proxy.m0RegistryPath = registryPath;
|
|
122
|
+
runtime.m0.registryPath = registryPath;
|
|
123
|
+
const capturedAt = new Date().toISOString();
|
|
124
|
+
const fetchCalls = [];
|
|
125
|
+
writeHome(registryPath, {
|
|
126
|
+
tenantId,
|
|
127
|
+
providerName: 'none',
|
|
128
|
+
machineId: 'test-machine',
|
|
129
|
+
homeStorage: {
|
|
130
|
+
kind: 'volume',
|
|
131
|
+
durability: 'durable-volume',
|
|
132
|
+
longTermContract: true,
|
|
133
|
+
ownerMachineId: 'test-machine',
|
|
134
|
+
guestHome: '/home/agent',
|
|
135
|
+
volumeId: 'volume-123',
|
|
136
|
+
mountPath: '/home/agent',
|
|
137
|
+
},
|
|
138
|
+
state: 'running',
|
|
139
|
+
nodeId: 'test-node',
|
|
140
|
+
relayToken: 'relay-token',
|
|
141
|
+
webRoute: {
|
|
142
|
+
routeId: 'https://relay.example',
|
|
143
|
+
machineId: 'test-machine',
|
|
144
|
+
targetPort: 7878,
|
|
145
|
+
url: 'https://relay.example',
|
|
146
|
+
concreteUrl: 'https://relay.example',
|
|
147
|
+
concreteUrlSource: 'config',
|
|
148
|
+
createdAt: '2026-06-26T00:00:00.000Z',
|
|
149
|
+
raw: null,
|
|
150
|
+
},
|
|
151
|
+
createdAt: '2026-06-26T00:00:00.000Z',
|
|
152
|
+
updatedAt: '2026-06-26T00:00:00.000Z',
|
|
153
|
+
});
|
|
154
|
+
const res = makeResponse();
|
|
155
|
+
const handled = await routeRequest(makeRequest('GET', '/__hearth/status', { authorization: `Bearer ${ownerToken}` }), res, runtime, {
|
|
156
|
+
status: {
|
|
157
|
+
fetch: (async (url, init) => {
|
|
158
|
+
fetchCalls.push({ url: String(url), init: init ?? {} });
|
|
159
|
+
return {
|
|
160
|
+
ok: true,
|
|
161
|
+
status: 200,
|
|
162
|
+
statusText: 'OK',
|
|
163
|
+
async text() {
|
|
164
|
+
return JSON.stringify({
|
|
165
|
+
ok: true,
|
|
166
|
+
exitCode: 0,
|
|
167
|
+
stdout: JSON.stringify({
|
|
168
|
+
cpuPct: 17.5,
|
|
169
|
+
memoryUsedMB: 612,
|
|
170
|
+
memoryAvailableMB: 1436,
|
|
171
|
+
crtrRssKB: 45000,
|
|
172
|
+
piRssKB: 32000,
|
|
173
|
+
nodeRssKB: 12000,
|
|
174
|
+
totalRssKB: 89000,
|
|
175
|
+
capturedAt,
|
|
176
|
+
}),
|
|
177
|
+
stderr: '',
|
|
178
|
+
});
|
|
179
|
+
},
|
|
180
|
+
};
|
|
181
|
+
}),
|
|
182
|
+
},
|
|
183
|
+
});
|
|
184
|
+
assert.equal(handled, undefined);
|
|
185
|
+
assert.equal(res.statusCode, 200);
|
|
186
|
+
const body = parseJsonBody(res);
|
|
187
|
+
assert.equal(body.runtimeStats?.cpuPct, 17.5);
|
|
188
|
+
assert.equal(body.machineResources, null);
|
|
189
|
+
assert.equal(fetchCalls.length, 1);
|
|
190
|
+
assert.equal(fetchCalls[0]?.url, 'https://relay.example/__crtr/source');
|
|
191
|
+
assert.deepEqual(fetchCalls[0]?.init?.headers, {
|
|
192
|
+
authorization: 'Bearer relay-token',
|
|
193
|
+
'content-type': 'application/json',
|
|
194
|
+
});
|
|
195
|
+
});
|
|
196
|
+
test('status miss does not start wake/restore', async () => {
|
|
197
|
+
const tenantId = 'tenant-status-probe-fail';
|
|
198
|
+
const tempDir = mkdtempSync(join(tmpdir(), 'crouter-hearth-status-probe-fail-'));
|
|
199
|
+
const statePath = join(tempDir, 'state.json');
|
|
200
|
+
const registryPath = join(tempDir, 'homes.json');
|
|
201
|
+
writeState(statePath, tenantId);
|
|
202
|
+
const runtime = makeRuntime(tenantId, statePath);
|
|
203
|
+
runtime.proxy.m0RegistryPath = registryPath;
|
|
204
|
+
runtime.m0.registryPath = registryPath;
|
|
205
|
+
writeHome(registryPath, {
|
|
206
|
+
tenantId,
|
|
207
|
+
providerName: 'none',
|
|
208
|
+
machineId: 'test-machine',
|
|
209
|
+
homeStorage: {
|
|
210
|
+
kind: 'volume',
|
|
211
|
+
durability: 'durable-volume',
|
|
212
|
+
longTermContract: true,
|
|
213
|
+
ownerMachineId: 'test-machine',
|
|
214
|
+
guestHome: '/home/agent',
|
|
215
|
+
volumeId: 'volume-123',
|
|
216
|
+
mountPath: '/home/agent',
|
|
217
|
+
},
|
|
218
|
+
state: 'running',
|
|
219
|
+
nodeId: 'test-node',
|
|
220
|
+
relayToken: 'relay-token',
|
|
221
|
+
webRoute: {
|
|
222
|
+
routeId: 'https://relay.example',
|
|
223
|
+
machineId: 'test-machine',
|
|
224
|
+
targetPort: 7878,
|
|
225
|
+
url: 'https://relay.example',
|
|
226
|
+
concreteUrl: 'https://relay.example',
|
|
227
|
+
concreteUrlSource: 'config',
|
|
228
|
+
createdAt: '2026-06-26T00:00:00.000Z',
|
|
229
|
+
raw: null,
|
|
230
|
+
},
|
|
231
|
+
createdAt: '2026-06-26T00:00:00.000Z',
|
|
232
|
+
updatedAt: '2026-06-26T00:00:00.000Z',
|
|
233
|
+
});
|
|
234
|
+
let guestSourceCalls = 0;
|
|
235
|
+
const fetchCalls = [];
|
|
236
|
+
const res = makeResponse();
|
|
237
|
+
const handled = await routeRequest(makeRequest('GET', '/__hearth/status', { authorization: `Bearer ${ownerToken}` }), res, runtime, {
|
|
238
|
+
status: {
|
|
239
|
+
fetch: (async (url, init) => {
|
|
240
|
+
fetchCalls.push({ url: String(url), init: init ?? {} });
|
|
241
|
+
return {
|
|
242
|
+
ok: false,
|
|
243
|
+
status: 503,
|
|
244
|
+
statusText: 'Service Unavailable',
|
|
245
|
+
async text() {
|
|
246
|
+
return 'relay is down';
|
|
247
|
+
},
|
|
248
|
+
};
|
|
249
|
+
}),
|
|
250
|
+
guestSource: async () => {
|
|
251
|
+
guestSourceCalls += 1;
|
|
252
|
+
throw new Error('guestSource should not run on a status miss');
|
|
253
|
+
},
|
|
254
|
+
},
|
|
255
|
+
});
|
|
256
|
+
assert.equal(handled, undefined);
|
|
257
|
+
assert.equal(res.statusCode, 200);
|
|
258
|
+
const body = parseJsonBody(res);
|
|
259
|
+
assert.equal(body.runtimeStats, null);
|
|
260
|
+
assert.equal(fetchCalls.length, 1);
|
|
261
|
+
assert.equal(fetchCalls[0]?.url, 'https://relay.example/__crtr/source');
|
|
262
|
+
assert.equal(guestSourceCalls, 0);
|
|
263
|
+
});
|
|
264
|
+
test('status route returns null runtime stats when the probe output is invalid JSON', async () => {
|
|
265
|
+
const tenantId = 'tenant-status-parse-fail';
|
|
266
|
+
const tempDir = mkdtempSync(join(tmpdir(), 'crouter-hearth-status-parse-fail-'));
|
|
267
|
+
const statePath = join(tempDir, 'state.json');
|
|
268
|
+
const registryPath = join(tempDir, 'homes.json');
|
|
269
|
+
writeState(statePath, tenantId);
|
|
270
|
+
const runtime = makeRuntime(tenantId, statePath);
|
|
271
|
+
runtime.proxy.m0RegistryPath = registryPath;
|
|
272
|
+
runtime.m0.registryPath = registryPath;
|
|
273
|
+
writeHome(registryPath, {
|
|
274
|
+
tenantId,
|
|
275
|
+
providerName: 'none',
|
|
276
|
+
machineId: 'test-machine',
|
|
277
|
+
homeStorage: {
|
|
278
|
+
kind: 'volume',
|
|
279
|
+
durability: 'durable-volume',
|
|
280
|
+
longTermContract: true,
|
|
281
|
+
ownerMachineId: 'test-machine',
|
|
282
|
+
guestHome: '/home/agent',
|
|
283
|
+
volumeId: 'volume-123',
|
|
284
|
+
mountPath: '/home/agent',
|
|
285
|
+
},
|
|
286
|
+
state: 'running',
|
|
287
|
+
nodeId: 'test-node',
|
|
288
|
+
relayToken: 'relay-token',
|
|
289
|
+
webRoute: {
|
|
290
|
+
routeId: 'https://relay.example',
|
|
291
|
+
machineId: 'test-machine',
|
|
292
|
+
targetPort: 7878,
|
|
293
|
+
url: 'https://relay.example',
|
|
294
|
+
concreteUrl: 'https://relay.example',
|
|
295
|
+
concreteUrlSource: 'config',
|
|
296
|
+
createdAt: '2026-06-26T00:00:00.000Z',
|
|
297
|
+
raw: null,
|
|
298
|
+
},
|
|
299
|
+
createdAt: '2026-06-26T00:00:00.000Z',
|
|
300
|
+
updatedAt: '2026-06-26T00:00:00.000Z',
|
|
301
|
+
});
|
|
302
|
+
const res = makeResponse();
|
|
303
|
+
const handled = await routeRequest(makeRequest('GET', '/__hearth/status', { authorization: `Bearer ${ownerToken}` }), res, runtime, {
|
|
304
|
+
status: {
|
|
305
|
+
fetch: (async () => ({
|
|
306
|
+
ok: true,
|
|
307
|
+
status: 200,
|
|
308
|
+
statusText: 'OK',
|
|
309
|
+
async text() {
|
|
310
|
+
return 'not json';
|
|
311
|
+
},
|
|
312
|
+
})),
|
|
313
|
+
},
|
|
314
|
+
});
|
|
315
|
+
assert.equal(handled, undefined);
|
|
316
|
+
assert.equal(res.statusCode, 200);
|
|
317
|
+
const body = parseJsonBody(res);
|
|
318
|
+
assert.equal(body.runtimeStats, null);
|
|
319
|
+
});
|
|
320
|
+
test('status route returns machine resources from getMachine', async () => {
|
|
321
|
+
const tenantId = 'tenant-status-machine';
|
|
322
|
+
const tempDir = mkdtempSync(join(tmpdir(), 'crouter-hearth-status-machine-'));
|
|
323
|
+
const statePath = join(tempDir, 'state.json');
|
|
324
|
+
const registryPath = join(tempDir, 'homes.json');
|
|
325
|
+
writeState(statePath, tenantId);
|
|
326
|
+
writeFileSync(registryPath, `${JSON.stringify({
|
|
327
|
+
[tenantId]: {
|
|
328
|
+
tenantId,
|
|
329
|
+
providerName: 'none',
|
|
330
|
+
machineId: 'test-machine',
|
|
331
|
+
homeStorage: {
|
|
332
|
+
kind: 'volume',
|
|
333
|
+
durability: 'durable-volume',
|
|
334
|
+
longTermContract: true,
|
|
335
|
+
ownerMachineId: 'test-machine',
|
|
336
|
+
guestHome: '/home/agent',
|
|
337
|
+
volumeId: 'volume-123',
|
|
338
|
+
mountPath: '/home/agent',
|
|
339
|
+
},
|
|
340
|
+
state: 'running',
|
|
341
|
+
createdAt: '2026-06-26T00:00:00.000Z',
|
|
342
|
+
updatedAt: '2026-06-26T00:00:00.000Z',
|
|
343
|
+
},
|
|
344
|
+
}, null, 2)}\n`, 'utf8');
|
|
345
|
+
const runtime = makeRuntime(tenantId, statePath);
|
|
346
|
+
runtime.proxy.m0RegistryPath = registryPath;
|
|
347
|
+
runtime.m0.registryPath = registryPath;
|
|
348
|
+
const getMachine = async (machineId) => {
|
|
349
|
+
assert.equal(machineId, 'test-machine');
|
|
350
|
+
return {
|
|
351
|
+
providerName: 'none',
|
|
352
|
+
machineId: 'test-machine',
|
|
353
|
+
state: 'running',
|
|
354
|
+
raw: {
|
|
355
|
+
cpuCount: 2,
|
|
356
|
+
memoryMB: 2048,
|
|
357
|
+
status: 'running',
|
|
358
|
+
},
|
|
359
|
+
};
|
|
360
|
+
};
|
|
361
|
+
const res = makeResponse();
|
|
362
|
+
const handled = await routeRequest(makeRequest('GET', '/__hearth/status', { authorization: `Bearer ${ownerToken}` }), res, runtime, {
|
|
363
|
+
status: {
|
|
364
|
+
getMachine,
|
|
365
|
+
guestSource: async () => ({ ok: false, stdout: '', stderr: 'timeout' }),
|
|
366
|
+
},
|
|
367
|
+
});
|
|
368
|
+
assert.equal(handled, undefined);
|
|
369
|
+
assert.equal(res.statusCode, 200);
|
|
370
|
+
const body = parseJsonBody(res);
|
|
371
|
+
assert.deepEqual(body.machineResources, { cpuCount: 2, memoryMB: 2048 });
|
|
372
|
+
});
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,258 @@
|
|
|
1
|
+
import assert from 'node:assert/strict';
|
|
2
|
+
import { createHash } from 'node:crypto';
|
|
3
|
+
import { EventEmitter } from 'node:events';
|
|
4
|
+
import { mkdtempSync, writeFileSync } from 'node:fs';
|
|
5
|
+
import { tmpdir } from 'node:os';
|
|
6
|
+
import { join } from 'node:path';
|
|
7
|
+
import { test } from 'node:test';
|
|
8
|
+
import { configureWakeProxyRuntime, wakeProxyInternals } from '../home.js';
|
|
9
|
+
import { proxyHttpRequest } from '../proxy.js';
|
|
10
|
+
// Regression for the HTTP wake-path 502/asset-timeout (hearth-soak-4a0dc43-report.md §4): every HTTP
|
|
11
|
+
// forward routed through ensureAwake, so a single momentary slow `probeRelayServing` under guest
|
|
12
|
+
// load false-negatived and escalated the request into the 150s wakeHome/waitForRelayReady
|
|
13
|
+
// path (serial guest execs) — while the direct route was returning 200 in ~0.1s the whole
|
|
14
|
+
// time. The fix: a home crtr already records `running` with a route+token is forwarded DIRECTLY (the
|
|
15
|
+
// forward is the liveness check); ensureAwake/restore is reserved for missing/not-running state or a
|
|
16
|
+
// clear upstream failure. These tests fail on the pre-fix code that gated all HTTP through ensureAwake.
|
|
17
|
+
const tenantId = 'silas';
|
|
18
|
+
const machineId = 'igd2fkrn1y1ol3vw5i6mt';
|
|
19
|
+
const nodeId = 'mqt64sus-e71caa94';
|
|
20
|
+
const routeUrl = 'https://7878-igd2fkrn1y1ol3vw5i6mt.example.dev';
|
|
21
|
+
const ownerToken = 'owner-secret-token';
|
|
22
|
+
const now = '2026-06-25T00:00:00.000Z';
|
|
23
|
+
function makeHome(overrides = {}) {
|
|
24
|
+
return {
|
|
25
|
+
tenantId,
|
|
26
|
+
providerName: 'none',
|
|
27
|
+
machineId,
|
|
28
|
+
homeStorage: {
|
|
29
|
+
kind: 'volume',
|
|
30
|
+
durability: 'durable-volume',
|
|
31
|
+
longTermContract: true,
|
|
32
|
+
ownerMachineId: machineId,
|
|
33
|
+
guestHome: '/home/agent',
|
|
34
|
+
volumeId: '48b59d07-8cc9-46f9-bdfd-ac99a55dff40',
|
|
35
|
+
mountPath: '/home/agent',
|
|
36
|
+
},
|
|
37
|
+
state: 'running',
|
|
38
|
+
nodeId,
|
|
39
|
+
relayToken: 'relay-token',
|
|
40
|
+
webRoute: {
|
|
41
|
+
routeId: '7878-igd2fkrn1y1ol3vw5i6mt.example.dev',
|
|
42
|
+
machineId,
|
|
43
|
+
targetPort: 7878,
|
|
44
|
+
url: routeUrl,
|
|
45
|
+
concreteUrl: routeUrl,
|
|
46
|
+
concreteUrlSource: 'provider',
|
|
47
|
+
createdAt: now,
|
|
48
|
+
raw: null,
|
|
49
|
+
},
|
|
50
|
+
createdAt: now,
|
|
51
|
+
updatedAt: now,
|
|
52
|
+
...overrides,
|
|
53
|
+
};
|
|
54
|
+
}
|
|
55
|
+
function makeRuntime(registryPath, statePath) {
|
|
56
|
+
return {
|
|
57
|
+
proxy: {
|
|
58
|
+
host: '127.0.0.1',
|
|
59
|
+
port: 7878,
|
|
60
|
+
publicOrigin: 'https://hearth-wake-proxy.fly.dev',
|
|
61
|
+
statePath,
|
|
62
|
+
m0RegistryPath: registryPath,
|
|
63
|
+
ownerUserId: 'owner-user',
|
|
64
|
+
defaultTenantId: tenantId,
|
|
65
|
+
ownerTokenHash: createHash('sha256').update(ownerToken, 'utf8').digest('hex'),
|
|
66
|
+
idlePauseMs: 0,
|
|
67
|
+
wakeTimeoutMs: 30_000,
|
|
68
|
+
readyTimeoutMs: 2_000,
|
|
69
|
+
cookieSecure: true,
|
|
70
|
+
seedHome: null,
|
|
71
|
+
},
|
|
72
|
+
m0: {
|
|
73
|
+
providerName: 'none',
|
|
74
|
+
registryPath,
|
|
75
|
+
guestUser: 'agent',
|
|
76
|
+
guestHome: '/home/agent',
|
|
77
|
+
guestCodePath: '/opt/crouter',
|
|
78
|
+
webPort: 7878,
|
|
79
|
+
nodeKind: 'general',
|
|
80
|
+
piPackages: [],
|
|
81
|
+
piAuthJson: null,
|
|
82
|
+
relayToken: null,
|
|
83
|
+
},
|
|
84
|
+
};
|
|
85
|
+
}
|
|
86
|
+
function setup(home = makeHome()) {
|
|
87
|
+
const tempDir = mkdtempSync(join(tmpdir(), 'crouter-hearth-http-fast-'));
|
|
88
|
+
const registryPath = join(tempDir, 'homes.json');
|
|
89
|
+
const statePath = join(tempDir, 'state.json');
|
|
90
|
+
writeFileSync(registryPath, `${JSON.stringify({ [tenantId]: home }, null, 2)}\n`, 'utf8');
|
|
91
|
+
const runtime = makeRuntime(registryPath, statePath);
|
|
92
|
+
configureWakeProxyRuntime(runtime);
|
|
93
|
+
return runtime;
|
|
94
|
+
}
|
|
95
|
+
class FakeReq extends EventEmitter {
|
|
96
|
+
url;
|
|
97
|
+
method;
|
|
98
|
+
headers;
|
|
99
|
+
constructor(path, method = 'GET') {
|
|
100
|
+
super();
|
|
101
|
+
this.url = path;
|
|
102
|
+
this.method = method;
|
|
103
|
+
this.headers = { authorization: `Bearer ${ownerToken}`, host: 'hearth-wake-proxy.fly.dev' };
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
class FakeRes extends EventEmitter {
|
|
107
|
+
statusCode = 200;
|
|
108
|
+
statusMessage = '';
|
|
109
|
+
headersSent = false;
|
|
110
|
+
writableEnded = false;
|
|
111
|
+
headers = new Map();
|
|
112
|
+
chunks = [];
|
|
113
|
+
socket = { setNoDelay() { } };
|
|
114
|
+
setHeader(name, value) {
|
|
115
|
+
this.headers.set(name.toLowerCase(), value);
|
|
116
|
+
}
|
|
117
|
+
getHeader(name) {
|
|
118
|
+
return this.headers.get(name.toLowerCase());
|
|
119
|
+
}
|
|
120
|
+
hasHeader(name) {
|
|
121
|
+
return this.headers.has(name.toLowerCase());
|
|
122
|
+
}
|
|
123
|
+
writeHead(code, headers) {
|
|
124
|
+
this.statusCode = code;
|
|
125
|
+
this.headersSent = true;
|
|
126
|
+
if (headers)
|
|
127
|
+
for (const [k, v] of Object.entries(headers))
|
|
128
|
+
this.setHeader(k, v);
|
|
129
|
+
}
|
|
130
|
+
flushHeaders() {
|
|
131
|
+
this.headersSent = true;
|
|
132
|
+
}
|
|
133
|
+
write(chunk) {
|
|
134
|
+
this.headersSent = true;
|
|
135
|
+
this.chunks.push(Buffer.from(chunk));
|
|
136
|
+
return true;
|
|
137
|
+
}
|
|
138
|
+
end(chunk) {
|
|
139
|
+
this.headersSent = true;
|
|
140
|
+
if (chunk !== undefined)
|
|
141
|
+
this.chunks.push(Buffer.from(chunk));
|
|
142
|
+
this.writableEnded = true;
|
|
143
|
+
this.emit('finish');
|
|
144
|
+
}
|
|
145
|
+
destroy() {
|
|
146
|
+
this.writableEnded = true;
|
|
147
|
+
}
|
|
148
|
+
body() {
|
|
149
|
+
return Buffer.concat(this.chunks).toString('utf8');
|
|
150
|
+
}
|
|
151
|
+
}
|
|
152
|
+
function asReq(req) {
|
|
153
|
+
return req;
|
|
154
|
+
}
|
|
155
|
+
function asRes(res) {
|
|
156
|
+
return res;
|
|
157
|
+
}
|
|
158
|
+
function htmlResponse(text) {
|
|
159
|
+
return new Response(text, { status: 200, headers: { 'content-type': 'text/html; charset=utf-8' } });
|
|
160
|
+
}
|
|
161
|
+
function guardHeavyPath(t) {
|
|
162
|
+
const probe = t.mock.method(wakeProxyInternals, 'probeRelayServing', async () => {
|
|
163
|
+
throw new Error('probeRelayServing must not run on the running-route fast path');
|
|
164
|
+
});
|
|
165
|
+
const wake = t.mock.method(wakeProxyInternals, 'wakeHome', async () => {
|
|
166
|
+
throw new Error('wakeHome must not run on the running-route fast path');
|
|
167
|
+
});
|
|
168
|
+
return { probe, wake };
|
|
169
|
+
}
|
|
170
|
+
test('HTTP request against a known-running route forwards directly without the heavy wake/restore path', async (t) => {
|
|
171
|
+
const runtime = setup();
|
|
172
|
+
const { probe, wake } = guardHeavyPath(t);
|
|
173
|
+
const fetchMock = t.mock.method(globalThis, 'fetch', async () => htmlResponse('<html>chat</html>'));
|
|
174
|
+
const res = new FakeRes();
|
|
175
|
+
await proxyHttpRequest(asReq(new FakeReq('/views/chat')), asRes(res), runtime);
|
|
176
|
+
assert.equal(res.statusCode, 200);
|
|
177
|
+
assert.equal(res.body(), '<html>chat</html>');
|
|
178
|
+
assert.equal(fetchMock.mock.callCount(), 1);
|
|
179
|
+
// The forward went straight to the persisted route — never through ensureAwake's probe/wake.
|
|
180
|
+
assert.equal(probe.mock.callCount(), 0);
|
|
181
|
+
assert.equal(wake.mock.callCount(), 0);
|
|
182
|
+
});
|
|
183
|
+
test('concurrent asset/page requests forward in parallel without serializing behind a slow guest probe', async (t) => {
|
|
184
|
+
const runtime = setup();
|
|
185
|
+
const { probe, wake } = guardHeavyPath(t);
|
|
186
|
+
let inFlight = 0;
|
|
187
|
+
let maxInFlight = 0;
|
|
188
|
+
let release;
|
|
189
|
+
const gate = new Promise((resolve) => {
|
|
190
|
+
release = resolve;
|
|
191
|
+
});
|
|
192
|
+
const fetchMock = t.mock.method(globalThis, 'fetch', async () => {
|
|
193
|
+
inFlight += 1;
|
|
194
|
+
maxInFlight = Math.max(maxInFlight, inFlight);
|
|
195
|
+
await gate;
|
|
196
|
+
inFlight -= 1;
|
|
197
|
+
return htmlResponse('<html>asset</html>');
|
|
198
|
+
});
|
|
199
|
+
const paths = ['/views/chat', '/assets/index-a.css', '/assets/index-b.js', '/assets/index-c.js', '/favicon.svg'];
|
|
200
|
+
const responses = paths.map(() => new FakeRes());
|
|
201
|
+
const calls = paths.map((p, i) => proxyHttpRequest(asReq(new FakeReq(p)), asRes(responses[i]), runtime));
|
|
202
|
+
// Let all five enter forwardUpstream before any resolves; if they serialized behind a per-tenant
|
|
203
|
+
// wake lock/probe, only one would be in flight here.
|
|
204
|
+
await new Promise((resolve) => setTimeout(resolve, 20));
|
|
205
|
+
const concurrentBeforeRelease = maxInFlight;
|
|
206
|
+
release();
|
|
207
|
+
await Promise.all(calls);
|
|
208
|
+
assert.equal(concurrentBeforeRelease, paths.length);
|
|
209
|
+
assert.equal(fetchMock.mock.callCount(), paths.length);
|
|
210
|
+
for (const res of responses) {
|
|
211
|
+
assert.equal(res.statusCode, 200);
|
|
212
|
+
assert.equal(res.body(), '<html>asset</html>');
|
|
213
|
+
}
|
|
214
|
+
assert.equal(probe.mock.callCount(), 0);
|
|
215
|
+
assert.equal(wake.mock.callCount(), 0);
|
|
216
|
+
});
|
|
217
|
+
test('a clear upstream failure against the running route invalidates the verdict and wakes deliberately', async (t) => {
|
|
218
|
+
const runtime = setup();
|
|
219
|
+
// ensureAwake's deliberate wake path: the route IS serving (probe true), so it confirms via the
|
|
220
|
+
// cheap probe and never restores — the point is that the failed direct forward ESCALATED into
|
|
221
|
+
// ensureAwake rather than silently 502ing.
|
|
222
|
+
const probe = t.mock.method(wakeProxyInternals, 'probeRelayServing', async () => true);
|
|
223
|
+
const wake = t.mock.method(wakeProxyInternals, 'wakeHome', async () => {
|
|
224
|
+
throw new Error('wakeHome must not run when the relay is serving');
|
|
225
|
+
});
|
|
226
|
+
t.mock.method(wakeProxyInternals, 'touchTenantWake', async () => undefined);
|
|
227
|
+
let fetchCalls = 0;
|
|
228
|
+
const fetchMock = t.mock.method(globalThis, 'fetch', async () => {
|
|
229
|
+
fetchCalls += 1;
|
|
230
|
+
if (fetchCalls === 1)
|
|
231
|
+
throw new TypeError('fetch failed'); // connection refused against stale route
|
|
232
|
+
return htmlResponse('<html>recovered</html>');
|
|
233
|
+
});
|
|
234
|
+
const res = new FakeRes();
|
|
235
|
+
await proxyHttpRequest(asReq(new FakeReq('/views/chat')), asRes(res), runtime);
|
|
236
|
+
assert.equal(res.statusCode, 200);
|
|
237
|
+
assert.equal(res.body(), '<html>recovered</html>');
|
|
238
|
+
assert.equal(fetchMock.mock.callCount(), 2); // direct forward failed, deliberate wake forward succeeded
|
|
239
|
+
assert.equal(probe.mock.callCount(), 1); // entered ensureAwake exactly once
|
|
240
|
+
assert.equal(wake.mock.callCount(), 0);
|
|
241
|
+
});
|
|
242
|
+
test('not-running home skips the fast path and goes straight to the deliberate wake', async (t) => {
|
|
243
|
+
const runtime = setup(makeHome({ state: 'paused' }));
|
|
244
|
+
const probe = t.mock.method(wakeProxyInternals, 'probeRelayServing', async () => true);
|
|
245
|
+
const wake = t.mock.method(wakeProxyInternals, 'wakeHome', async () => {
|
|
246
|
+
throw new Error('wakeHome must not run when the relay is serving');
|
|
247
|
+
});
|
|
248
|
+
t.mock.method(wakeProxyInternals, 'touchTenantWake', async () => undefined);
|
|
249
|
+
const fetchMock = t.mock.method(globalThis, 'fetch', async () => htmlResponse('<html>woke</html>'));
|
|
250
|
+
const res = new FakeRes();
|
|
251
|
+
await proxyHttpRequest(asReq(new FakeReq('/views/chat')), asRes(res), runtime);
|
|
252
|
+
assert.equal(res.statusCode, 200);
|
|
253
|
+
assert.equal(res.body(), '<html>woke</html>');
|
|
254
|
+
// Paused home is not trusted directly — it must enter ensureAwake (probe runs) before forwarding.
|
|
255
|
+
assert.equal(probe.mock.callCount(), 1);
|
|
256
|
+
assert.equal(wake.mock.callCount(), 0);
|
|
257
|
+
assert.equal(fetchMock.mock.callCount(), 1);
|
|
258
|
+
});
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|