@playcraft/cli 0.1.24 → 0.1.25
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 +38 -3
- package/dist/agent/local-backend.js +1 -1
- package/dist/auth/account-activation.js +157 -0
- package/dist/auth/messages.js +30 -0
- package/dist/cli-root-help.js +2 -0
- package/dist/commands/build.js +9 -4
- package/dist/commands/create.js +26 -33
- package/dist/commands/image.js +2 -6
- package/dist/commands/login.js +84 -42
- package/dist/commands/platform-skills.generated.js +19 -0
- package/dist/commands/playable.js +53 -0
- package/dist/commands/skills.js +2 -0
- package/dist/commands/tools-3d.js +11 -0
- package/dist/commands/tools-batch.js +87 -0
- package/dist/commands/tools-generation.js +8 -4
- package/dist/commands/tools.js +2 -0
- package/dist/commands/video.js +111 -0
- package/dist/commands/workspace-runtime.js +54 -0
- package/dist/config.js +59 -4
- package/dist/index.js +34 -3
- package/dist/project-skills/builtin-import.js +225 -0
- package/dist/project-skills/commands.js +77 -0
- package/dist/project-skills/lifecycle.js +28 -0
- package/dist/project-skills/local-run.js +112 -0
- package/dist/project-skills/local-store.js +221 -0
- package/dist/project-skills/messages.js +80 -0
- package/dist/project-skills/reconcile.js +62 -0
- package/dist/project-skills/remote-cache.js +51 -0
- package/dist/project-skills/validation.js +19 -0
- package/dist/recording/messages.js +40 -0
- package/dist/recording/project-digest.js +85 -0
- package/dist/recording/recorder.js +293 -0
- package/dist/recording/scenario.js +50 -0
- package/dist/remix/clone.js +2 -0
- package/dist/remix/init-template.js +2 -0
- package/dist/remix/pull.js +2 -0
- package/dist/remix/push.js +21 -1
- package/dist/utils/agent-api-client.js +185 -30
- package/dist/utils/environment-endpoints.js +17 -0
- package/dist/utils/playcraft-http-client.js +6 -4
- package/dist/utils/tool-operation-journal.js +124 -0
- package/dist/utils/video-evidence-git.js +81 -0
- package/dist/video-replication/client.js +222 -0
- package/dist/video-replication/comparison-evidence.js +149 -0
- package/dist/video-replication/comparison-files.js +57 -0
- package/dist/video-replication/comparison-log.js +72 -0
- package/dist/video-replication/comparison-messages.js +104 -0
- package/dist/video-replication/comparison-output.js +63 -0
- package/dist/video-replication/comparison-preflight.js +66 -0
- package/dist/video-replication/comparison.js +216 -0
- package/dist/video-replication/evidence.js +165 -0
- package/dist/video-replication/media.js +111 -0
- package/dist/video-replication/messages.js +89 -0
- package/dist/workspace-runtime/codex/app-server.js +627 -0
- package/dist/workspace-runtime/codex/config-toml.js +109 -0
- package/dist/workspace-runtime/codex/jsonrpc-stdio.js +123 -0
- package/dist/workspace-runtime/codex/launcher-client.js +163 -0
- package/dist/workspace-runtime/codex/loopback.js +143 -0
- package/dist/workspace-runtime/codex/model-broker.js +239 -0
- package/dist/workspace-runtime/codex/native-adapter.js +9 -0
- package/dist/workspace-runtime/main.js +10 -0
- package/dist/workspace-runtime/persistence/journal.js +355 -0
- package/dist/workspace-runtime/persistence/native-subagents.js +162 -0
- package/dist/workspace-runtime/persistence/sqlite-client.js +77 -0
- package/dist/workspace-runtime/persistence/sqlite-worker.js +1057 -0
- package/dist/workspace-runtime/previews/publish.js +259 -0
- package/dist/workspace-runtime/previews/single-file.js +43 -0
- package/dist/workspace-runtime/processes/managed-writes.js +69 -0
- package/dist/workspace-runtime/production/contracts.js +17 -0
- package/dist/workspace-runtime/production/controller.js +207 -0
- package/dist/workspace-runtime/production/dependencies.js +60 -0
- package/dist/workspace-runtime/production/native.js +90 -0
- package/dist/workspace-runtime/production/processes.js +86 -0
- package/dist/workspace-runtime/production/save-command.js +24 -0
- package/dist/workspace-runtime/production/source-copy.js +91 -0
- package/dist/workspace-runtime/production/stages.js +202 -0
- package/dist/workspace-runtime/production/storage.js +32 -0
- package/dist/workspace-runtime/serve.js +202 -0
- package/dist/workspace-runtime/server/auth.js +21 -0
- package/dist/workspace-runtime/server/connectivity.js +201 -0
- package/dist/workspace-runtime/server/desktop-host.js +429 -0
- package/dist/workspace-runtime/server/desktop-preview-config.js +81 -0
- package/dist/workspace-runtime/server/desktop-preview-service.js +157 -0
- package/dist/workspace-runtime/server/desktop-preview-static.js +53 -0
- package/dist/workspace-runtime/server/desktop-preview.js +189 -0
- package/dist/workspace-runtime/server/dispatch.js +876 -0
- package/dist/workspace-runtime/server/endpoints.js +19 -0
- package/dist/workspace-runtime/server/execution-group.js +85 -0
- package/dist/workspace-runtime/server/http.js +976 -0
- package/dist/workspace-runtime/server/lock.js +53 -0
- package/dist/workspace-runtime/server/rfb-watch-gate.js +168 -0
- package/dist/workspace-runtime/server/terminal-host.js +294 -0
- package/dist/workspace-runtime/server/types.js +1 -0
- package/dist/workspace-runtime/workspaces/artifact-events.js +55 -0
- package/dist/workspace-runtime/workspaces/artifact-files.js +195 -0
- package/dist/workspace-runtime/workspaces/artifact-receipts.js +89 -0
- package/dist/workspace-runtime/workspaces/artifacts.js +260 -0
- package/dist/workspace-runtime/workspaces/attachments.js +175 -0
- package/dist/workspace-runtime/workspaces/batch-commit.js +142 -0
- package/dist/workspace-runtime/workspaces/cli-context.js +23 -0
- package/dist/workspace-runtime/workspaces/cli-credentials.js +111 -0
- package/dist/workspace-runtime/workspaces/context-error.js +2 -0
- package/dist/workspace-runtime/workspaces/dependencies.js +264 -0
- package/dist/workspace-runtime/workspaces/developer-command.js +64 -0
- package/dist/workspace-runtime/workspaces/directories.js +113 -0
- package/dist/workspace-runtime/workspaces/directory-access.js +29 -0
- package/dist/workspace-runtime/workspaces/directory-maintenance.js +111 -0
- package/dist/workspace-runtime/workspaces/directory-stats.js +49 -0
- package/dist/workspace-runtime/workspaces/disk-snapshot.js +31 -0
- package/dist/workspace-runtime/workspaces/empty-template.js +40 -0
- package/dist/workspace-runtime/workspaces/files.js +120 -0
- package/dist/workspace-runtime/workspaces/git-credential-broker.js +312 -0
- package/dist/workspace-runtime/workspaces/git-credential-helper.js +68 -0
- package/dist/workspace-runtime/workspaces/git-direct-store.js +155 -0
- package/dist/workspace-runtime/workspaces/git.js +471 -0
- package/dist/workspace-runtime/workspaces/json5-edit.js +170 -0
- package/dist/workspace-runtime/workspaces/parameters.js +272 -0
- package/dist/workspace-runtime/workspaces/prepare.js +264 -0
- package/dist/workspace-runtime/workspaces/registry.js +200 -0
- package/dist/workspace-runtime/workspaces/revisions.js +31 -0
- package/dist/workspace-runtime/workspaces/skill-artifact-loader.js +91 -0
- package/dist/workspace-runtime/workspaces/skills.js +189 -0
- package/dist/workspace-runtime/workspaces/video-attachments.js +49 -0
- package/package.json +14 -5
- package/project-template/.claude/skills/playcraft-image-generation/SKILL.md +23 -61
- package/project-template/.claude/skills/playcraft-replica-validation/SKILL.md +25 -0
- package/project-template/.claude/skills/playcraft-replica-validation/references/contracts.md +79 -0
- package/project-template/.claude/skills/playcraft-video-understanding/SKILL.md +29 -0
- package/project-template/.claude/skills/playcraft-video-understanding/references/contracts.md +37 -0
- package/project-template-v2/.claude/agents/artist.md +82 -0
- package/project-template-v2/.claude/agents/developer.md +153 -0
- package/project-template-v2/.claude/agents/game-designer.md +264 -0
- package/project-template-v2/.claude/agents/refs/artist-art-style-catalog.md +533 -0
- package/project-template-v2/.claude/agents/refs/artist-color-audio-recipes.md +153 -0
- package/project-template-v2/.claude/agents/refs/artist-dimension-axis.md +27 -0
- package/project-template-v2/.claude/agents/refs/artist-master-composite-recipes.md +208 -0
- package/project-template-v2/.claude/agents/refs/atom-skill-library.md +81 -0
- package/project-template-v2/.claude/agents/refs/developer-impl-cookbook.md +432 -0
- package/project-template-v2/.claude/agents/refs/framework-5-component-filter.md +252 -0
- package/project-template-v2/.claude/agents/refs/framework-game-feel-juice.md +266 -0
- package/project-template-v2/.claude/agents/refs/framework-mda.md +147 -0
- package/project-template-v2/.claude/agents/refs/game-designer-gameplay-sufficiency.md +123 -0
- package/project-template-v2/.claude/agents/refs/ta-3d-flip-recipe.md +88 -0
- package/project-template-v2/.claude/agents/refs/ta-atlas-deliverable-standard.md +67 -0
- package/project-template-v2/.claude/agents/refs/ta-batch-pipeline-recipes.md +120 -0
- package/project-template-v2/.claude/agents/refs/ta-image-generation-detail.md +300 -0
- package/project-template-v2/.claude/agents/refs/ta-image-ops-reference.md +495 -0
- package/project-template-v2/.claude/agents/refs/ta-pipeline-cookbook.md +1141 -0
- package/project-template-v2/.claude/agents/refs/ta-tools-reference.md +111 -0
- package/project-template-v2/.claude/agents/refs/ta-vfx-preset-catalog.md +365 -0
- package/project-template-v2/.claude/agents/refs/threejs-cannon-pitfalls.md +412 -0
- package/project-template-v2/.claude/agents/reviewer.md +75 -0
- package/project-template-v2/.claude/agents/technical-artist.md +86 -0
- package/project-template-v2/.claude/hooks/snapshot-milestone.mjs +243 -0
- package/project-template-v2/.claude/hooks/user-prompt.mjs +133 -0
- package/project-template-v2/.claude/settings.json +33 -0
- package/project-template-v2/.claude/skills/brainstorming/SKILL.md +161 -0
- package/project-template-v2/.claude/skills/brainstorming/scripts/frame-template.html +270 -0
- package/project-template-v2/.claude/skills/brainstorming/scripts/helper.js +177 -0
- package/project-template-v2/.claude/skills/brainstorming/scripts/server.cjs +354 -0
- package/project-template-v2/.claude/skills/brainstorming/scripts/start-server.sh +148 -0
- package/project-template-v2/.claude/skills/brainstorming/scripts/stop-server.sh +56 -0
- package/project-template-v2/.claude/skills/brainstorming/scripts/wait-for-selection.sh +62 -0
- package/project-template-v2/.claude/skills/brainstorming/spec-document-reviewer-prompt.md +49 -0
- package/project-template-v2/.claude/skills/brainstorming/visual-companion.md +309 -0
- package/project-template-v2/.claude/skills/playcraft-ad-psychology/SKILL.md +182 -0
- package/project-template-v2/.claude/skills/playcraft-art-style-guide/SKILL.md +123 -0
- package/project-template-v2/.claude/skills/playcraft-asset-state-sheet/SKILL.md +205 -0
- package/project-template-v2/.claude/skills/playcraft-audio-generation/SKILL.md +280 -0
- package/project-template-v2/.claude/skills/playcraft-batch-pipeline/SKILL.md +184 -0
- package/project-template-v2/.claude/skills/playcraft-build-optimizer/SKILL.md +306 -0
- package/project-template-v2/.claude/skills/playcraft-image-generation/SKILL.md +298 -0
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/build-sprite-sheet.template.mjs +123 -0
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/compare-style.template.mjs +254 -0
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +324 -0
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +97 -0
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-edit-variants.template.mjs +118 -0
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +137 -0
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +397 -0
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/validate-sprite-sheet.template.mjs +296 -0
- package/project-template-v2/.claude/skills/playcraft-image-ops/SKILL.md +122 -0
- package/project-template-v2/.claude/skills/playcraft-image-processing/SKILL.md +219 -0
- package/project-template-v2/.claude/skills/playcraft-masking/SKILL.md +373 -0
- package/project-template-v2/.claude/skills/playcraft-playable-optimization/SKILL.md +161 -0
- package/project-template-v2/.claude/skills/playcraft-research/SKILL.md +215 -0
- package/project-template-v2/.claude/skills/playcraft-skill-recommender/SKILL.md +382 -0
- package/project-template-v2/.claude/skills/playcraft-sprite-generation/SKILL.md +423 -0
- package/project-template-v2/.claude/skills/playcraft-sprite-remix/SKILL.md +158 -0
- package/project-template-v2/.claude/skills/playcraft-sprite-sheet/SKILL.md +100 -0
- package/project-template-v2/.claude/skills/playcraft-storyboard/SKILL.md +167 -0
- package/project-template-v2/.claude/skills/playcraft-style-qa/SKILL.md +270 -0
- package/project-template-v2/.claude/skills/playcraft-text-rendering/SKILL.md +236 -0
- package/project-template-v2/.claude/skills/playcraft-vfx-animation/SKILL.md +130 -0
- package/project-template-v2/.claude/skills/playwright-cli/SKILL.md +390 -0
- package/project-template-v2/.claude/skills/playwright-cli/references/element-attributes.md +23 -0
- package/project-template-v2/.claude/skills/playwright-cli/references/playwright-tests.md +39 -0
- package/project-template-v2/.claude/skills/playwright-cli/references/request-mocking.md +87 -0
- package/project-template-v2/.claude/skills/playwright-cli/references/running-code.md +240 -0
- package/project-template-v2/.claude/skills/playwright-cli/references/session-management.md +226 -0
- package/project-template-v2/.claude/skills/playwright-cli/references/spec-driven-testing.md +308 -0
- package/project-template-v2/.claude/skills/playwright-cli/references/storage-state.md +275 -0
- package/project-template-v2/.claude/skills/playwright-cli/references/test-generation.md +134 -0
- package/project-template-v2/.claude/skills/playwright-cli/references/tracing.md +142 -0
- package/project-template-v2/.claude/skills/playwright-cli/references/video-recording.md +153 -0
- package/project-template-v2/.claude/skills/session-analyzer/SKILL.md +386 -0
- package/project-template-v2/.claude/skills/session-analyzer/scripts/execution-breakdown.mjs +182 -0
- package/project-template-v2/.claude/skills/session-analyzer/scripts/find-turns.mjs +72 -0
- package/project-template-v2/.claude/skills/session-analyzer/scripts/heavy-output.mjs +121 -0
- package/project-template-v2/.claude/skills/session-analyzer/scripts/resolve-session.mjs +102 -0
- package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-stats.mjs +127 -0
- package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-tool-timeline.mjs +106 -0
- package/project-template-v2/.claude/skills/session-analyzer/scripts/time-gaps.mjs +128 -0
- package/project-template-v2/.claude/skills/session-analyzer/scripts/turn-timeline.mjs +67 -0
- package/project-template-v2/.claude/snapshot.mjs +263 -0
- package/project-template-v2/.playcraft/skills.lock.json +152 -0
- package/project-template-v2/CLAUDE.md +146 -0
- package/project-template-v2/assets/audio/bgm/.gitkeep +0 -0
- package/project-template-v2/assets/audio/sfx/.gitkeep +0 -0
- package/project-template-v2/assets/bundles/.gitkeep +0 -0
- package/project-template-v2/assets/images/bg/.gitkeep +0 -0
- package/project-template-v2/assets/images/reference/.gitkeep +0 -0
- package/project-template-v2/assets/images/storyboard/.gitkeep +0 -0
- package/project-template-v2/assets/images/tiles/.gitkeep +0 -0
- package/project-template-v2/assets/images/ui/.gitkeep +0 -0
- package/project-template-v2/assets/images/vfx/.gitkeep +0 -0
- package/project-template-v2/assets/models/.gitkeep +0 -0
- package/project-template-v2/docs/harness/iteration-1/context-flow.md +254 -0
- package/project-template-v2/docs/harness/iteration-1/generate-flow.md +91 -0
- package/project-template-v2/docs/harness/iteration-1/ideate-flow.md +214 -0
- package/project-template-v2/docs/harness/iteration-1/optimize-flow.md +75 -0
- package/project-template-v2/docs/harness/iteration-1/wrapup-flow.md +63 -0
- package/project-template-v2/docs/harness/iteration-2/context-flow.md +223 -0
- package/project-template-v2/docs/harness/iteration-2/generate-flow.md +129 -0
- package/project-template-v2/docs/harness/iteration-2/ideate-flow.md +267 -0
- package/project-template-v2/docs/harness/iteration-2/optimize-flow.md +164 -0
- package/project-template-v2/docs/harness/iteration-2/wrapup-flow.md +115 -0
- package/project-template-v2/docs/harness/orchestrator-flow.md +364 -0
- package/project-template-v2/docs/project-state.json +60 -0
- package/project-template-v2/docs/project-state.md +72 -0
- package/project-template-v2/docs/standards/README.md +225 -0
- package/project-template-v2/docs/standards/agent-behavior-standards.md +174 -0
- package/project-template-v2/docs/standards/artifacts/design-brief.md +19 -0
- package/project-template-v2/docs/standards/artifacts/design.md +22 -0
- package/project-template-v2/docs/standards/artifacts/game-code.md +41 -0
- package/project-template-v2/docs/standards/artifacts/todo-list.md +41 -0
- package/project-template-v2/docs/standards/iter1-agent-behavior-standards.md +343 -0
- package/project-template-v2/game/index.ts +18 -0
- package/project-template-v2/globals.d.ts +51 -0
- package/project-template-v2/index.css +34 -0
- package/project-template-v2/index.html +18 -0
- package/project-template-v2/main.ts +9 -0
- package/project-template-v2/package.json +46 -0
- package/project-template-v2/skills/_shared/scripts/dispatch-clear.mjs +31 -0
- package/project-template-v2/skills/_shared/scripts/dispatch-set.mjs +86 -0
- package/project-template-v2/skills/_shared/scripts/dod-check.mjs +153 -0
- package/project-template-v2/skills/_shared/scripts/handoff-append.mjs +70 -0
- package/project-template-v2/skills/_shared/scripts/lib/validator-artifacts.mjs +91 -0
- package/project-template-v2/skills/_shared/scripts/pipeline/dod-config.mjs +131 -0
- package/project-template-v2/skills/_shared/scripts/pipeline/index.mjs +80 -0
- package/project-template-v2/skills/_shared/scripts/pipeline/iteration-1-core.mjs +90 -0
- package/project-template-v2/skills/_shared/scripts/pipeline/iteration-2-wrap.mjs +93 -0
- package/project-template-v2/skills/_shared/scripts/pipeline/iteration-3-visual.mjs +23 -0
- package/project-template-v2/skills/_shared/scripts/render-project-state.mjs +230 -0
- package/project-template-v2/skills/_shared/scripts/state-advance-stage.mjs +58 -0
- package/project-template-v2/skills/_shared/scripts/state-get.mjs +339 -0
- package/project-template-v2/skills/_shared/scripts/state-handoff.mjs +39 -0
- package/project-template-v2/skills/_shared/scripts/state-set.mjs +94 -0
- package/project-template-v2/skills/_shared/scripts/state-store.mjs +783 -0
- package/project-template-v2/skills/_shared/scripts/todo-add.mjs +88 -0
- package/project-template-v2/skills/_shared/scripts/todo-get.mjs +130 -0
- package/project-template-v2/skills/_shared/scripts/todo-remove.mjs +33 -0
- package/project-template-v2/skills/_shared/scripts/todo-set.mjs +47 -0
- package/project-template-v2/skills/_shared/scripts/verify-asset-code-sync.mjs +268 -0
- package/project-template-v2/skills/_shared/scripts/verify-env.mjs +285 -0
- package/project-template-v2/skills/_shared/scripts/verify-placeholders.mjs +161 -0
- package/project-template-v2/skills/playable-autoplay/SKILL.md +176 -0
- package/project-template-v2/skills/playable-autoplay/agents/openai.yaml +4 -0
- package/project-template-v2/skills/playable-debug/SKILL.md +116 -0
- package/project-template-v2/skills/playable-debug/agents/openai.yaml +4 -0
- package/project-template-v2/skills/playable-debug/references/debug-config.md +40 -0
- package/project-template-v2/skills/playable-record/SKILL.md +140 -0
- package/project-template-v2/skills/playable-record/scripts/lib/dev-server.mjs +104 -0
- package/project-template-v2/skills/playable-record/scripts/lib/record-audio-bridge.js +141 -0
- package/project-template-v2/skills/playable-record/scripts/record-playable.mjs +425 -0
- package/project-template-v2/skills/playable-record/scripts/verify-contract.mjs +261 -0
- package/project-template-v2/skills/playable-record/scripts/verify-firstwin.mjs +398 -0
- package/project-template-v2/skills/playable-record/scripts/verify-fusion.mjs +322 -0
- package/project-template-v2/skills/playable-record/scripts/verify-lifecycle.mjs +105 -0
- package/project-template-v2/skills/playable-record/scripts/verify-vlm-video.mjs +230 -0
- package/project-template-v2/skills/playable-validate/SKILL.md +61 -0
- package/project-template-v2/skills/playable-validate/validation-rules.md +14 -0
- package/project-template-v2/skills/playable-verify-ui/SKILL.md +63 -0
- package/project-template-v2/skills/playable-verify-ui/scripts/lib/__init__.py +1 -0
- package/project-template-v2/skills/playable-verify-ui/scripts/lib/config_expr.js +218 -0
- package/project-template-v2/skills/playable-verify-ui/scripts/lib/node_utils.js +51 -0
- package/project-template-v2/skills/playable-verify-ui/scripts/lib/profile_loader.py +59 -0
- package/project-template-v2/skills/playable-verify-ui/scripts/lib/report.py +106 -0
- package/project-template-v2/skills/playable-verify-ui/scripts/lib/runtime_contract.js +116 -0
- package/project-template-v2/skills/playable-verify-ui/scripts/verify_fetch_antipatterns.py +59 -0
- package/project-template-v2/skills/playable-verify-ui/scripts/verify_hardcoded_layout.js +64 -0
- package/project-template-v2/skills/playable-verify-ui/scripts/verify_runtime_contract.js +58 -0
- package/project-template-v2/skills/playable-verify-ui/scripts/verify_text_overlap.py +333 -0
- package/project-template-v2/ta-workspace/scripts/.gitkeep +0 -0
- package/project-template-v2/tsconfig.json +20 -0
- package/project-template-v2/vite.config.ts +27 -0
- package/project-templates/batch-locks/phaser.yaml +922 -0
- package/project-templates/batch-locks/threejs.yaml +978 -0
- package/project-templates/empty/AGENTS.md +25 -0
- package/project-templates/empty/gitignore +33 -0
- package/project-templates/phaser/.claude/skills/playcraft-image-generation/SKILL.md +23 -61
- package/project-templates/threejs/.claude/skills/playcraft-image-generation/SKILL.md +23 -61
|
@@ -0,0 +1,239 @@
|
|
|
1
|
+
import { createHash, randomBytes, timingSafeEqual } from 'node:crypto';
|
|
2
|
+
import { createServer } from 'node:http';
|
|
3
|
+
import { Readable } from 'node:stream';
|
|
4
|
+
import { pipeline } from 'node:stream/promises';
|
|
5
|
+
import { basename, dirname } from 'node:path';
|
|
6
|
+
import { z } from 'zod';
|
|
7
|
+
import { workspaceContextFromRoot } from '../workspaces/registry.js';
|
|
8
|
+
import { PLATFORM_ROUTES, modelResponsesPath, platformEndpoint } from '@playcraft/common/cloud-workspace/runtime';
|
|
9
|
+
const credentialSchema = z.object({
|
|
10
|
+
token: z.string().min(1), expiresAt: z.string().datetime(),
|
|
11
|
+
configId: z.string().uuid(), model: z.string().min(1).max(128),
|
|
12
|
+
claims: z.object({
|
|
13
|
+
environment: z.string(), userId: z.string(), workspaceId: z.string(), runtimeId: z.string(),
|
|
14
|
+
generation: z.number().int(), runtimeEpoch: z.number().int(),
|
|
15
|
+
}),
|
|
16
|
+
});
|
|
17
|
+
/** Keeps renewable execution credentials in control memory, outside Codex and project files. */
|
|
18
|
+
export class WorkspaceModelBroker {
|
|
19
|
+
state;
|
|
20
|
+
server;
|
|
21
|
+
baseUrl = '';
|
|
22
|
+
entries = new Map();
|
|
23
|
+
routes = new Map();
|
|
24
|
+
pending = new Map();
|
|
25
|
+
requests = new Set();
|
|
26
|
+
sessionRequests = new Map();
|
|
27
|
+
constructor(state) {
|
|
28
|
+
this.state = state;
|
|
29
|
+
}
|
|
30
|
+
async start() {
|
|
31
|
+
if (this.server)
|
|
32
|
+
return;
|
|
33
|
+
const server = createServer({ maxHeaderSize: 8192 }, (request, response) => {
|
|
34
|
+
void this.forward(request, response);
|
|
35
|
+
});
|
|
36
|
+
await new Promise((resolve, reject) => {
|
|
37
|
+
server.once('error', reject);
|
|
38
|
+
server.listen(0, '127.0.0.1', resolve);
|
|
39
|
+
});
|
|
40
|
+
this.server = server;
|
|
41
|
+
const address = server.address();
|
|
42
|
+
if (!address || typeof address === 'string')
|
|
43
|
+
throw new Error('model_broker_unavailable');
|
|
44
|
+
this.baseUrl = `http://127.0.0.1:${address.port}`;
|
|
45
|
+
}
|
|
46
|
+
async threadConfig(cwd, modelConfigId, sessionId) {
|
|
47
|
+
const { activate, ...settings } = await this.prepareThreadConfig(cwd, modelConfigId, sessionId);
|
|
48
|
+
activate();
|
|
49
|
+
return settings;
|
|
50
|
+
}
|
|
51
|
+
async prepareThreadConfig(cwd, modelConfigId, sessionId) {
|
|
52
|
+
if (!this.server)
|
|
53
|
+
throw new Error('workspace_not_registered');
|
|
54
|
+
const { workspaceId } = await workspaceContextFromRoot(this.state, cwd);
|
|
55
|
+
if (modelConfigId !== undefined && !z.string().uuid().safeParse(modelConfigId).success)
|
|
56
|
+
throw new Error('model_config_denied');
|
|
57
|
+
const routeKey = sessionId ? `${workspaceId}/${createHash('sha256').update(sessionId).digest('hex').slice(0, 32)}` : workspaceId;
|
|
58
|
+
let route = this.routes.get(routeKey);
|
|
59
|
+
const selected = modelConfigId ?? (route?.epoch === this.state.runtimeEpoch ? route.selected?.entry.modelConfigId : undefined);
|
|
60
|
+
const cacheKey = `${workspaceId}:${selected ?? 'default'}`;
|
|
61
|
+
let entry = this.entries.get(cacheKey) ?? [...this.entries.values()].find(item => item.workspaceId === workspaceId && item.epoch === this.state.runtimeEpoch && item.modelConfigId === selected);
|
|
62
|
+
if (!entry || entry.epoch !== this.state.runtimeEpoch) {
|
|
63
|
+
entry = { workspaceId, epoch: this.state.runtimeEpoch, cacheKey, modelConfigId: selected };
|
|
64
|
+
this.entries.set(cacheKey, entry);
|
|
65
|
+
}
|
|
66
|
+
// Resolve current model metadata and permission at every native turn boundary.
|
|
67
|
+
const credential = await this.credential(entry, true);
|
|
68
|
+
if (!route || route.epoch !== this.state.runtimeEpoch) {
|
|
69
|
+
route = { workspaceId, epoch: this.state.runtimeEpoch, capability: randomBytes(32).toString('base64url') };
|
|
70
|
+
this.routes.set(routeKey, route);
|
|
71
|
+
}
|
|
72
|
+
// Each session pins its prepared model; shared credential renewal cannot change an active turn.
|
|
73
|
+
return {
|
|
74
|
+
activate: () => {
|
|
75
|
+
if (!this.valid(entry) || this.routes.get(routeKey) !== route)
|
|
76
|
+
throw new Error('model_access_denied');
|
|
77
|
+
route.selected = { entry, model: credential.model };
|
|
78
|
+
},
|
|
79
|
+
model: credential.model,
|
|
80
|
+
modelConfigId: credential.configId,
|
|
81
|
+
modelProvider: 'playcraft_workspace',
|
|
82
|
+
config: {
|
|
83
|
+
'model_providers.playcraft_workspace': {
|
|
84
|
+
name: 'PlayCraft Workspace', base_url: `${this.baseUrl}/${routeKey}`,
|
|
85
|
+
wire_api: 'responses', requires_openai_auth: false,
|
|
86
|
+
http_headers: { Authorization: `Bearer ${route.capability}` },
|
|
87
|
+
},
|
|
88
|
+
},
|
|
89
|
+
};
|
|
90
|
+
}
|
|
91
|
+
valid(entry) {
|
|
92
|
+
return Boolean(this.server && !this.state.journal.destroyed()
|
|
93
|
+
&& this.state.runtimeEpoch === entry.epoch && this.state.journal.getWorkspace(entry.workspaceId)
|
|
94
|
+
&& this.entries.get(entry.cacheKey) === entry);
|
|
95
|
+
}
|
|
96
|
+
async credential(entry, refresh = false) {
|
|
97
|
+
if (!this.valid(entry))
|
|
98
|
+
throw new Error('model_access_denied');
|
|
99
|
+
if (!refresh && entry.credential && Date.parse(entry.credential.expiresAt) > Date.now() + 60_000)
|
|
100
|
+
return entry.credential;
|
|
101
|
+
let pending = this.pending.get(entry);
|
|
102
|
+
if (!pending) {
|
|
103
|
+
pending = this.renew(entry).finally(() => this.pending.delete(entry));
|
|
104
|
+
this.pending.set(entry, pending);
|
|
105
|
+
}
|
|
106
|
+
return pending;
|
|
107
|
+
}
|
|
108
|
+
async renew(entry) {
|
|
109
|
+
const config = this.state.config;
|
|
110
|
+
const endpoint = platformEndpoint(config.publicBaseUrl, PLATFORM_ROUTES.modelCredentials);
|
|
111
|
+
const response = await fetch(endpoint, {
|
|
112
|
+
method: 'POST', redirect: 'error', signal: AbortSignal.timeout(10_000),
|
|
113
|
+
headers: { authorization: `Bearer ${config.controlToken}`, 'content-type': 'application/json', 'playcraft-env': config.environment },
|
|
114
|
+
body: JSON.stringify({ runtimeId: config.runtimeId, generation: config.generation,
|
|
115
|
+
runtimeEpoch: entry.epoch, workspaceId: entry.workspaceId,
|
|
116
|
+
...(entry.modelConfigId ? { modelConfigId: entry.modelConfigId } : {}) }),
|
|
117
|
+
});
|
|
118
|
+
if (!response.ok) {
|
|
119
|
+
const error = await response.json().catch(() => ({}));
|
|
120
|
+
throw new Error(['model_config_required', 'model_config_denied'].includes(error.reason ?? '') ? error.reason : 'model_credential_unavailable');
|
|
121
|
+
}
|
|
122
|
+
const credential = credentialSchema.parse(await response.json());
|
|
123
|
+
const claims = credential.claims;
|
|
124
|
+
if (!this.valid(entry) || claims.workspaceId !== entry.workspaceId || claims.runtimeId !== config.runtimeId
|
|
125
|
+
|| claims.userId !== config.userId || claims.environment !== config.environment
|
|
126
|
+
|| claims.generation !== config.generation || claims.runtimeEpoch !== entry.epoch
|
|
127
|
+
|| (entry.modelConfigId !== undefined && credential.configId !== entry.modelConfigId)
|
|
128
|
+
|| Date.parse(credential.expiresAt) <= Date.now() + 1000)
|
|
129
|
+
throw new Error('model_credential_scope_mismatch');
|
|
130
|
+
entry.modelConfigId = credential.configId;
|
|
131
|
+
entry.credential = credential;
|
|
132
|
+
return credential;
|
|
133
|
+
}
|
|
134
|
+
async forward(request, response) {
|
|
135
|
+
const abort = new AbortController();
|
|
136
|
+
this.requests.add(abort);
|
|
137
|
+
let activeRoute;
|
|
138
|
+
const cancel = () => abort.abort();
|
|
139
|
+
response.once('close', cancel);
|
|
140
|
+
try {
|
|
141
|
+
const match = /^\/([0-9a-f-]{36}(?:\/[0-9a-f]{32})?)\/responses$/.exec(request.url ?? '');
|
|
142
|
+
const route = match ? this.routes.get(match[1]) : undefined;
|
|
143
|
+
const selected = route?.selected;
|
|
144
|
+
const entry = selected?.entry;
|
|
145
|
+
const presented = Buffer.from(request.headers.authorization ?? '');
|
|
146
|
+
const expected = Buffer.from(route ? `Bearer ${route.capability}` : '');
|
|
147
|
+
if (request.method !== 'POST' || !entry || !expected.length || presented.length !== expected.length
|
|
148
|
+
|| !timingSafeEqual(presented, expected) || !this.valid(entry)) {
|
|
149
|
+
response.writeHead(403);
|
|
150
|
+
response.end();
|
|
151
|
+
return;
|
|
152
|
+
}
|
|
153
|
+
activeRoute = route;
|
|
154
|
+
const active = this.sessionRequests.get(route) ?? new Set();
|
|
155
|
+
active.add(abort);
|
|
156
|
+
this.sessionRequests.set(route, active);
|
|
157
|
+
const credential = await this.credential(entry);
|
|
158
|
+
const chunks = [];
|
|
159
|
+
let size = 0;
|
|
160
|
+
for await (const chunk of request) {
|
|
161
|
+
size += chunk.length;
|
|
162
|
+
if (size > 16 * 1024 * 1024) {
|
|
163
|
+
response.writeHead(413);
|
|
164
|
+
response.end();
|
|
165
|
+
return;
|
|
166
|
+
}
|
|
167
|
+
chunks.push(Buffer.from(chunk));
|
|
168
|
+
}
|
|
169
|
+
if (!this.valid(entry))
|
|
170
|
+
throw new Error('model_access_denied');
|
|
171
|
+
const body = JSON.parse(Buffer.concat(chunks).toString('utf8'));
|
|
172
|
+
if (!body || typeof body !== 'object' || Array.isArray(body)) {
|
|
173
|
+
response.writeHead(400);
|
|
174
|
+
response.end();
|
|
175
|
+
return;
|
|
176
|
+
}
|
|
177
|
+
// The browser selects a configuration, never an arbitrary billable upstream model.
|
|
178
|
+
body.model = selected.model;
|
|
179
|
+
const expires = setTimeout(cancel, Math.max(0, Date.parse(credential.expiresAt) - Date.now()));
|
|
180
|
+
try {
|
|
181
|
+
const upstream = await fetch(platformEndpoint(this.state.config.publicBaseUrl, modelResponsesPath(credential.configId)), {
|
|
182
|
+
method: 'POST', redirect: 'error', signal: abort.signal,
|
|
183
|
+
headers: { authorization: `Bearer ${credential.token}`, 'content-type': 'application/json' },
|
|
184
|
+
body: JSON.stringify(body),
|
|
185
|
+
});
|
|
186
|
+
if (upstream.status === 401 || upstream.status === 403)
|
|
187
|
+
entry.credential = undefined;
|
|
188
|
+
response.writeHead(upstream.status, {
|
|
189
|
+
'content-type': upstream.headers.get('content-type') ?? 'application/json', 'cache-control': 'no-store',
|
|
190
|
+
});
|
|
191
|
+
if (upstream.body)
|
|
192
|
+
await pipeline(Readable.fromWeb(upstream.body), response);
|
|
193
|
+
else
|
|
194
|
+
response.end();
|
|
195
|
+
}
|
|
196
|
+
finally {
|
|
197
|
+
clearTimeout(expires);
|
|
198
|
+
}
|
|
199
|
+
}
|
|
200
|
+
catch {
|
|
201
|
+
if (!response.headersSent) {
|
|
202
|
+
response.writeHead(503, { 'content-type': 'application/json', 'cache-control': 'no-store' });
|
|
203
|
+
response.end(JSON.stringify({ error: { message: 'model_credential_unavailable', type: 'server_error' } }));
|
|
204
|
+
}
|
|
205
|
+
else
|
|
206
|
+
response.destroy();
|
|
207
|
+
}
|
|
208
|
+
finally {
|
|
209
|
+
response.off('close', cancel);
|
|
210
|
+
this.requests.delete(abort);
|
|
211
|
+
if (activeRoute) {
|
|
212
|
+
const active = this.sessionRequests.get(activeRoute);
|
|
213
|
+
active?.delete(abort);
|
|
214
|
+
if (!active?.size)
|
|
215
|
+
this.sessionRequests.delete(activeRoute);
|
|
216
|
+
}
|
|
217
|
+
}
|
|
218
|
+
}
|
|
219
|
+
cancelSession(cwd, sessionId) {
|
|
220
|
+
const routeKey = `${/^(basic|remix-)/.test(basename(cwd)) ? basename(dirname(cwd)) : basename(cwd)}/${createHash('sha256').update(sessionId).digest('hex').slice(0, 32)}`;
|
|
221
|
+
const route = this.routes.get(routeKey);
|
|
222
|
+
if (route)
|
|
223
|
+
for (const request of this.sessionRequests.get(route) ?? [])
|
|
224
|
+
request.abort();
|
|
225
|
+
}
|
|
226
|
+
async close() {
|
|
227
|
+
const server = this.server;
|
|
228
|
+
this.server = undefined;
|
|
229
|
+
this.entries.clear();
|
|
230
|
+
this.routes.clear();
|
|
231
|
+
this.sessionRequests.clear();
|
|
232
|
+
for (const request of this.requests)
|
|
233
|
+
request.abort();
|
|
234
|
+
if (server) {
|
|
235
|
+
server.closeAllConnections();
|
|
236
|
+
await new Promise(resolve => server.close(() => resolve()));
|
|
237
|
+
}
|
|
238
|
+
}
|
|
239
|
+
}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
/** Failure before a native request was sent; safe to report as failed instead of uncertain. */
|
|
2
|
+
export class NativePreparationError extends Error {
|
|
3
|
+
}
|
|
4
|
+
export function nativeEvent(type, payload) {
|
|
5
|
+
return { type, payload, occurredAt: new Date().toISOString() };
|
|
6
|
+
}
|
|
7
|
+
export function collectedEvent(kind, method, params) {
|
|
8
|
+
return { kind, method, params, occurredAt: new Date().toISOString() };
|
|
9
|
+
}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import { runWorkspaceRuntimeServe } from '../commands/workspace-runtime.js';
|
|
2
|
+
const flag = process.argv.indexOf('--config');
|
|
3
|
+
const configPath = flag >= 0 ? process.argv[flag + 1] : undefined;
|
|
4
|
+
if (!configPath) {
|
|
5
|
+
console.error('workspace-runtime: missing --config');
|
|
6
|
+
process.exitCode = 2;
|
|
7
|
+
}
|
|
8
|
+
else {
|
|
9
|
+
await runWorkspaceRuntimeServe(configPath);
|
|
10
|
+
}
|
|
@@ -0,0 +1,355 @@
|
|
|
1
|
+
import { copyFile, mkdir, readFile, writeFile } from 'node:fs/promises';
|
|
2
|
+
import { existsSync } from 'node:fs';
|
|
3
|
+
import { dirname, join } from 'node:path';
|
|
4
|
+
import { workspaceRegistrationSchema, operationRecordSchema, pendingSourceEventSchema, replayPinResultSchema, retainedRangeHasGap, sourceAckSchema, sourceEventKey, sourceEventReceiptSchema, terminalRecordSchema, } from '@playcraft/common/cloud-workspace/runtime';
|
|
5
|
+
import { SqliteWorkerClient } from './sqlite-client.js';
|
|
6
|
+
export const RUNTIME_STATE_FILE = 'runtime-state.sqlite';
|
|
7
|
+
export const LEGACY_JOURNAL_FILE = 'journal.json';
|
|
8
|
+
export const LEGACY_JOURNAL_SENTINEL = 'PLAYCRAFT_RUNTIME_STATE_SQLITE\n';
|
|
9
|
+
export class RuntimeJournal {
|
|
10
|
+
filePath;
|
|
11
|
+
legacyPath;
|
|
12
|
+
client;
|
|
13
|
+
listeners = new Set();
|
|
14
|
+
maintenance;
|
|
15
|
+
engineInfo;
|
|
16
|
+
epochs = [];
|
|
17
|
+
readToken = '';
|
|
18
|
+
inboxPending = 0;
|
|
19
|
+
locks = new Map();
|
|
20
|
+
snapshot = emptySnapshot();
|
|
21
|
+
constructor(stateDir) {
|
|
22
|
+
this.filePath = join(stateDir, RUNTIME_STATE_FILE);
|
|
23
|
+
this.legacyPath = join(stateDir, LEGACY_JOURNAL_FILE);
|
|
24
|
+
}
|
|
25
|
+
async exclusive(key, action) {
|
|
26
|
+
const previous = this.locks.get(key) ?? Promise.resolve();
|
|
27
|
+
let release;
|
|
28
|
+
const current = new Promise((resolve) => {
|
|
29
|
+
release = resolve;
|
|
30
|
+
});
|
|
31
|
+
this.locks.set(key, current);
|
|
32
|
+
await previous;
|
|
33
|
+
try {
|
|
34
|
+
return await action();
|
|
35
|
+
}
|
|
36
|
+
finally {
|
|
37
|
+
release();
|
|
38
|
+
if (this.locks.get(key) === current)
|
|
39
|
+
this.locks.delete(key);
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
async load() {
|
|
43
|
+
await mkdir(dirname(this.filePath), { recursive: true, mode: 0o700 });
|
|
44
|
+
const legacy = await readLegacy(this.legacyPath, this.filePath);
|
|
45
|
+
const started = await SqliteWorkerClient.open(this.filePath, legacy?.value ?? null);
|
|
46
|
+
this.client = started.client;
|
|
47
|
+
this.apply(started.opened);
|
|
48
|
+
if (legacy?.readable)
|
|
49
|
+
await writeFile(this.legacyPath, LEGACY_JOURNAL_SENTINEL, { mode: 0o600 });
|
|
50
|
+
this.maintenance = setInterval(() => {
|
|
51
|
+
void this.client?.request('maintain').catch(() => undefined);
|
|
52
|
+
}, 30_000);
|
|
53
|
+
this.maintenance.unref?.();
|
|
54
|
+
}
|
|
55
|
+
async close() {
|
|
56
|
+
if (this.maintenance)
|
|
57
|
+
clearInterval(this.maintenance);
|
|
58
|
+
await this.client?.close();
|
|
59
|
+
this.client = undefined;
|
|
60
|
+
}
|
|
61
|
+
engine() {
|
|
62
|
+
if (!this.engineInfo)
|
|
63
|
+
throw new Error('sqlite_engine_unavailable');
|
|
64
|
+
return this.engineInfo;
|
|
65
|
+
}
|
|
66
|
+
sourceReadToken() {
|
|
67
|
+
return this.readToken;
|
|
68
|
+
}
|
|
69
|
+
pendingInbox() {
|
|
70
|
+
return this.inboxPending;
|
|
71
|
+
}
|
|
72
|
+
epochsSnapshot() {
|
|
73
|
+
return this.epochs.map((epoch) => ({ ...epoch }));
|
|
74
|
+
}
|
|
75
|
+
onSourceEvent(listener) {
|
|
76
|
+
this.listeners.add(listener);
|
|
77
|
+
return () => this.listeners.delete(listener);
|
|
78
|
+
}
|
|
79
|
+
getWorkspace(workspaceId) {
|
|
80
|
+
return this.snapshot.workspaces[workspaceId];
|
|
81
|
+
}
|
|
82
|
+
async putWorkspace(binding) {
|
|
83
|
+
const parsed = workspaceRegistrationSchema.parse(binding);
|
|
84
|
+
await this.run('upsertRecord', { bucket: 'workspaces', key: parsed.workspaceId, body: parsed });
|
|
85
|
+
}
|
|
86
|
+
async forgetWorkspaces() {
|
|
87
|
+
await this.run('forgetWorkspaces', {});
|
|
88
|
+
}
|
|
89
|
+
findSessionCreation(sessionId) {
|
|
90
|
+
return Object.values(this.snapshot.operations).find((item) => item.kind === 'session.create' && item.sessionId === sessionId);
|
|
91
|
+
}
|
|
92
|
+
findTerminalCreation(terminalId) {
|
|
93
|
+
return Object.values(this.snapshot.operations).find((item) => item.kind === 'terminal.create' && item.terminalId === terminalId);
|
|
94
|
+
}
|
|
95
|
+
getOperation(scopeKey) {
|
|
96
|
+
return this.snapshot.operations[scopeKey];
|
|
97
|
+
}
|
|
98
|
+
getOperationById(operationId) {
|
|
99
|
+
return Object.values(this.snapshot.operations).find((operation) => operation.operationId === operationId);
|
|
100
|
+
}
|
|
101
|
+
listOperations() {
|
|
102
|
+
return Object.entries(this.snapshot.operations).map(([scopeKey, operation]) => ({ scopeKey, operation }));
|
|
103
|
+
}
|
|
104
|
+
getReceipt(key) {
|
|
105
|
+
return this.snapshot.receipts[key];
|
|
106
|
+
}
|
|
107
|
+
getSession(sessionId) {
|
|
108
|
+
return this.snapshot.sessions[sessionId];
|
|
109
|
+
}
|
|
110
|
+
listSessions() {
|
|
111
|
+
return Object.values(this.snapshot.sessions);
|
|
112
|
+
}
|
|
113
|
+
getTerminal(terminalId) {
|
|
114
|
+
return this.snapshot.terminals[terminalId];
|
|
115
|
+
}
|
|
116
|
+
listTerminals(workspaceId) {
|
|
117
|
+
return Object.values(this.snapshot.terminals).filter((item) => !workspaceId || item.workspaceId === workspaceId);
|
|
118
|
+
}
|
|
119
|
+
listManagedWrites(workspaceId) {
|
|
120
|
+
return Object.values(this.snapshot.managedWrites).filter((item) => !workspaceId || item.workspaceId === workspaceId);
|
|
121
|
+
}
|
|
122
|
+
getManagedWrite(writeId) {
|
|
123
|
+
return this.snapshot.managedWrites[writeId];
|
|
124
|
+
}
|
|
125
|
+
async putManagedWrite(record) {
|
|
126
|
+
await this.run('upsertRecord', { bucket: 'managed_writes', key: record.writeId, body: record });
|
|
127
|
+
}
|
|
128
|
+
getWorkspaceDependencies(workspaceId) {
|
|
129
|
+
return this.snapshot.workspaceDependencies[workspaceId];
|
|
130
|
+
}
|
|
131
|
+
listWorkspaceDependencies() {
|
|
132
|
+
return Object.values(this.snapshot.workspaceDependencies);
|
|
133
|
+
}
|
|
134
|
+
async putWorkspaceDependencies(record) {
|
|
135
|
+
await this.run('upsertRecord', {
|
|
136
|
+
bucket: 'workspace_dependencies',
|
|
137
|
+
key: record.workspaceId,
|
|
138
|
+
body: record,
|
|
139
|
+
});
|
|
140
|
+
}
|
|
141
|
+
fileRevisions(workspaceId) {
|
|
142
|
+
return { ...(workspaceId ? this.snapshot.workspaceFileRevisions[workspaceId] ?? {} : this.snapshot.fileRevisions) };
|
|
143
|
+
}
|
|
144
|
+
fileRevision(path, workspaceId) {
|
|
145
|
+
return this.fileRevisions(workspaceId)[path]?.revision ?? 0;
|
|
146
|
+
}
|
|
147
|
+
destroyed() {
|
|
148
|
+
return this.snapshot.destroyed;
|
|
149
|
+
}
|
|
150
|
+
lastSourceSequence() {
|
|
151
|
+
return this.snapshot.lastSourceSequence;
|
|
152
|
+
}
|
|
153
|
+
acceptedLeaseFence() {
|
|
154
|
+
return this.snapshot.acceptedLeaseFence;
|
|
155
|
+
}
|
|
156
|
+
storedRuntimeEpoch() {
|
|
157
|
+
return this.snapshot.runtimeEpoch;
|
|
158
|
+
}
|
|
159
|
+
executionGroup() {
|
|
160
|
+
return { ...this.snapshot.executionGroup };
|
|
161
|
+
}
|
|
162
|
+
getApproval(sessionId, approvalId) {
|
|
163
|
+
return this.snapshot.approvals[`${sessionId}:${approvalId}`];
|
|
164
|
+
}
|
|
165
|
+
listApprovals() {
|
|
166
|
+
return Object.values(this.snapshot.approvals);
|
|
167
|
+
}
|
|
168
|
+
async putApproval(approval) {
|
|
169
|
+
await this.run('upsertRecord', { bucket: 'approvals', key: `${approval.sessionId}:${approval.approvalId}`, body: approval });
|
|
170
|
+
}
|
|
171
|
+
async noteExecutionGroup(group) {
|
|
172
|
+
await this.run('noteExecutionGroup', { group });
|
|
173
|
+
}
|
|
174
|
+
async writeExecutionEpoch(input) {
|
|
175
|
+
await this.run('writeExecutionEpoch', input);
|
|
176
|
+
}
|
|
177
|
+
async setExecutionStopConfirmed(stopConfirmed) {
|
|
178
|
+
await this.run('setStopConfirmed', { stopConfirmed });
|
|
179
|
+
}
|
|
180
|
+
async bindRuntime(input) {
|
|
181
|
+
await this.run('bindRuntime', input);
|
|
182
|
+
}
|
|
183
|
+
listEvents(afterSequence = 0) {
|
|
184
|
+
return Object.values(this.snapshot.events)
|
|
185
|
+
.filter((event) => event.source.sourceSequence > afterSequence)
|
|
186
|
+
.sort((left, right) => left.source.sourceSequence - right.source.sourceSequence || left.source.runtimeEpoch - right.source.runtimeEpoch);
|
|
187
|
+
}
|
|
188
|
+
readSourcePage(input) {
|
|
189
|
+
const epoch = this.epochs.find((item) => item.runtime_id === input.runtimeId && item.generation === input.generation && item.runtime_epoch === input.runtimeEpoch);
|
|
190
|
+
const retainedFrom = epoch?.retained_from ?? 1;
|
|
191
|
+
const highWater = epoch?.local_durable_through ?? 0;
|
|
192
|
+
const coveredThrough = input.after;
|
|
193
|
+
if (retainedRangeHasGap(retainedFrom, coveredThrough)) {
|
|
194
|
+
return { ok: false, code: 'source_gap', retainedFrom, highWater, coveredThrough, ...identity(input) };
|
|
195
|
+
}
|
|
196
|
+
const matched = Object.values(this.snapshot.events)
|
|
197
|
+
.filter((event) => event.source.runtimeId === input.runtimeId &&
|
|
198
|
+
event.source.generation === input.generation &&
|
|
199
|
+
event.source.runtimeEpoch === input.runtimeEpoch &&
|
|
200
|
+
event.source.sourceSequence > input.after)
|
|
201
|
+
.sort((left, right) => left.source.sourceSequence - right.source.sourceSequence);
|
|
202
|
+
const first = matched[0];
|
|
203
|
+
if (first && first.source.sourceSequence > input.after + 1) {
|
|
204
|
+
return { ok: false, code: 'source_gap', retainedFrom, highWater, coveredThrough, ...identity(input) };
|
|
205
|
+
}
|
|
206
|
+
const events = matched.slice(0, input.limit ?? 100);
|
|
207
|
+
const nextAfter = events.at(-1)?.source.sourceSequence ?? input.after;
|
|
208
|
+
return { ok: true, events, retainedFrom, highWater, nextAfter, ...identity(input) };
|
|
209
|
+
}
|
|
210
|
+
async allocateSourceEvent(input) {
|
|
211
|
+
const result = await this.run('allocateEvent', input);
|
|
212
|
+
const event = result.committedEvents?.[0];
|
|
213
|
+
if (!event)
|
|
214
|
+
throw new Error('source_event_missing');
|
|
215
|
+
return event;
|
|
216
|
+
}
|
|
217
|
+
async commitSourceIdentity(event) {
|
|
218
|
+
await this.run('commitIdentity', { event: pendingSourceEventSchema.parse(event) });
|
|
219
|
+
}
|
|
220
|
+
async ingestNative(input) {
|
|
221
|
+
const result = await this.run('ingest', input);
|
|
222
|
+
return result.committedEvents ?? [];
|
|
223
|
+
}
|
|
224
|
+
async bindTurn(input) {
|
|
225
|
+
const result = await this.run('bindTurn', input);
|
|
226
|
+
return result.committedEvents ?? [];
|
|
227
|
+
}
|
|
228
|
+
async acknowledgeSource(ack) {
|
|
229
|
+
await this.run('ack', sourceAckSchema.parse(ack));
|
|
230
|
+
}
|
|
231
|
+
async createReplayPin(input) {
|
|
232
|
+
const result = await this.run('createPin', { identity: input, ttlMs: input.ttlMs });
|
|
233
|
+
return replayPinResultSchema.parse(result.pin);
|
|
234
|
+
}
|
|
235
|
+
async deleteReplayPin(pinId) {
|
|
236
|
+
await this.run('deletePin', { pinId });
|
|
237
|
+
}
|
|
238
|
+
async reclaimSourceEvents(minRetainMs = 0) {
|
|
239
|
+
await this.run('reclaim', { minRetainMs });
|
|
240
|
+
}
|
|
241
|
+
async putOperation(scopeKey, operation) {
|
|
242
|
+
const parsed = operationRecordSchema.parse(operation);
|
|
243
|
+
await this.run('putOperation', { scopeKey, operation: parsed });
|
|
244
|
+
return this.snapshot.operations[scopeKey] ?? parsed;
|
|
245
|
+
}
|
|
246
|
+
async putSession(binding) {
|
|
247
|
+
await this.run('upsertRecord', { bucket: 'sessions', key: binding.sessionId, body: binding });
|
|
248
|
+
}
|
|
249
|
+
async putTerminal(record) {
|
|
250
|
+
const parsed = terminalRecordSchema.parse(record);
|
|
251
|
+
await this.run('upsertRecord', { bucket: 'terminals', key: parsed.terminalId, body: parsed });
|
|
252
|
+
return parsed;
|
|
253
|
+
}
|
|
254
|
+
async putFileRevision(path, record, workspaceId) {
|
|
255
|
+
if (workspaceId) {
|
|
256
|
+
await this.run('upsertRecord', { bucket: `workspace_files:${workspaceId}`, key: path, body: record });
|
|
257
|
+
return;
|
|
258
|
+
}
|
|
259
|
+
await this.run('upsertRecord', { bucket: 'file_revisions', key: path, body: record });
|
|
260
|
+
}
|
|
261
|
+
async markDestroyed() {
|
|
262
|
+
await this.run('setDestroyed', {});
|
|
263
|
+
}
|
|
264
|
+
async replaceSessions(sessions) {
|
|
265
|
+
await this.run('replaceBucket', {
|
|
266
|
+
bucket: 'sessions',
|
|
267
|
+
entries: sessions.map((session) => ({ key: session.sessionId, body: session })),
|
|
268
|
+
});
|
|
269
|
+
}
|
|
270
|
+
async setAcceptedLeaseFence(value) {
|
|
271
|
+
await this.run('setAcceptedFence', { value });
|
|
272
|
+
}
|
|
273
|
+
async putReceipt(receipt, sourceSequence) {
|
|
274
|
+
const parsed = sourceEventReceiptSchema.parse(receipt);
|
|
275
|
+
await this.run('upsertRecord', { bucket: 'receipts', key: sourceEventKey(parsed.source), body: parsed });
|
|
276
|
+
void sourceSequence;
|
|
277
|
+
}
|
|
278
|
+
async appendEvent(event) {
|
|
279
|
+
const parsed = pendingSourceEventSchema.parse(event);
|
|
280
|
+
await this.commitSourceIdentity(parsed);
|
|
281
|
+
return this.snapshot.events[sourceEventKey(parsed.source)] ?? parsed;
|
|
282
|
+
}
|
|
283
|
+
async run(type, payload) {
|
|
284
|
+
if (!this.client)
|
|
285
|
+
throw new Error('sqlite_not_open');
|
|
286
|
+
const result = await this.client.request(type, payload);
|
|
287
|
+
this.apply(result);
|
|
288
|
+
for (const event of result.committedEvents ?? []) {
|
|
289
|
+
for (const listener of this.listeners)
|
|
290
|
+
listener(event);
|
|
291
|
+
}
|
|
292
|
+
return result;
|
|
293
|
+
}
|
|
294
|
+
apply(dump) {
|
|
295
|
+
const group = dump.snapshot.executionGroup;
|
|
296
|
+
this.snapshot = {
|
|
297
|
+
...emptySnapshot(),
|
|
298
|
+
...dump.snapshot,
|
|
299
|
+
executionGroup: {
|
|
300
|
+
stopConfirmed: group?.stopConfirmed === true,
|
|
301
|
+
replaced: group?.replaced === true,
|
|
302
|
+
pid: group?.pid,
|
|
303
|
+
startedAt: group?.startedAt,
|
|
304
|
+
previousPid: group?.previousPid,
|
|
305
|
+
},
|
|
306
|
+
};
|
|
307
|
+
this.epochs = dump.epochs ?? [];
|
|
308
|
+
this.readToken = dump.sourceReadToken ?? this.readToken;
|
|
309
|
+
this.inboxPending = dump.pendingInbox ?? 0;
|
|
310
|
+
if (dump.engine)
|
|
311
|
+
this.engineInfo = dump.engine;
|
|
312
|
+
}
|
|
313
|
+
}
|
|
314
|
+
async function readLegacy(legacyPath, sqlitePath) {
|
|
315
|
+
if (!existsSync(legacyPath))
|
|
316
|
+
return null;
|
|
317
|
+
const text = await readFile(legacyPath, 'utf8');
|
|
318
|
+
if (text.startsWith(LEGACY_JOURNAL_SENTINEL.trim())) {
|
|
319
|
+
if (!existsSync(sqlitePath))
|
|
320
|
+
throw new Error('runtime_state_missing');
|
|
321
|
+
return null;
|
|
322
|
+
}
|
|
323
|
+
let value;
|
|
324
|
+
try {
|
|
325
|
+
value = JSON.parse(text);
|
|
326
|
+
}
|
|
327
|
+
catch {
|
|
328
|
+
throw new Error('legacy_journal_unreadable');
|
|
329
|
+
}
|
|
330
|
+
if (!existsSync(`${legacyPath}.bak`))
|
|
331
|
+
await copyFile(legacyPath, `${legacyPath}.bak`);
|
|
332
|
+
return { value, readable: true };
|
|
333
|
+
}
|
|
334
|
+
function identity(input) {
|
|
335
|
+
return { runtimeId: input.runtimeId, generation: input.generation, runtimeEpoch: input.runtimeEpoch };
|
|
336
|
+
}
|
|
337
|
+
function emptySnapshot() {
|
|
338
|
+
return {
|
|
339
|
+
workspaces: {},
|
|
340
|
+
workspaceFileRevisions: {},
|
|
341
|
+
operations: {},
|
|
342
|
+
receipts: {},
|
|
343
|
+
events: {},
|
|
344
|
+
sessions: {},
|
|
345
|
+
terminals: {},
|
|
346
|
+
fileRevisions: {},
|
|
347
|
+
approvals: {},
|
|
348
|
+
managedWrites: {},
|
|
349
|
+
workspaceDependencies: {},
|
|
350
|
+
executionGroup: { stopConfirmed: false, replaced: false },
|
|
351
|
+
lastSourceSequence: 0,
|
|
352
|
+
acceptedLeaseFence: 0,
|
|
353
|
+
destroyed: false,
|
|
354
|
+
};
|
|
355
|
+
}
|