@playcraft/cli 0.1.38-beta → 0.1.39-prod
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 +3 -58
- package/dist/agent/local-backend.js +1 -1
- package/dist/cli-root-help.js +0 -2
- package/dist/commands/build-all.js +19 -5
- package/dist/commands/build.js +28 -15
- package/dist/commands/create.js +33 -26
- package/dist/commands/image.js +6 -2
- package/dist/commands/login.js +42 -84
- package/dist/commands/skills.js +0 -4
- package/dist/commands/tools-3d.js +0 -11
- package/dist/commands/tools-generation.js +126 -68
- package/dist/commands/tools-image-context.js +23 -0
- package/dist/commands/tools.js +2 -2
- package/dist/config.js +4 -59
- package/dist/index.js +3 -40
- package/dist/remix/clone.js +0 -2
- package/dist/remix/init-template.js +0 -2
- package/dist/remix/pull.js +0 -2
- package/dist/remix/push.js +1 -21
- package/dist/utils/agent-api-client.js +30 -185
- package/dist/utils/image-asset-context.js +106 -0
- package/dist/utils/playcraft-http-client.js +4 -6
- package/package.json +3 -13
- package/project-template/.claude/agents/refs/ta-image-generation-detail.md +67 -123
- package/project-template/.claude/skills/playcraft-image-generation/SKILL.md +135 -63
- package/project-template/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
- package/project-template/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
- package/project-template/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
- package/project-template/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
- package/project-templates/phaser/.claude/agents/refs/ta-image-generation-detail.md +59 -59
- package/project-templates/phaser/.claude/skills/playcraft-image-generation/SKILL.md +135 -63
- package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
- package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
- package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
- package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
- package/project-templates/threejs/.claude/agents/refs/ta-image-generation-detail.md +59 -59
- package/project-templates/threejs/.claude/skills/playcraft-image-generation/SKILL.md +135 -63
- package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
- package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
- package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
- package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
- package/SKILLS_REGISTRY.md +0 -149
- package/dist/auth/account-activation.js +0 -157
- package/dist/auth/messages.js +0 -30
- package/dist/commands/build-temp.js +0 -26
- package/dist/commands/platform-skills.generated.js +0 -19
- package/dist/commands/playable.js +0 -53
- package/dist/commands/tools-batch.js +0 -87
- package/dist/commands/video.js +0 -111
- package/dist/commands/workspace-runtime.js +0 -54
- package/dist/commands/workspace.js +0 -35
- package/dist/project-skills/builtin-import.js +0 -225
- package/dist/project-skills/commands.js +0 -77
- package/dist/project-skills/lifecycle.js +0 -28
- package/dist/project-skills/local-run.js +0 -112
- package/dist/project-skills/local-store.js +0 -221
- package/dist/project-skills/messages.js +0 -80
- package/dist/project-skills/reconcile.js +0 -62
- package/dist/project-skills/remote-cache.js +0 -51
- package/dist/project-skills/validation.js +0 -19
- package/dist/recording/messages.js +0 -40
- package/dist/recording/project-digest.js +0 -85
- package/dist/recording/recorder.js +0 -293
- package/dist/recording/scenario.js +0 -50
- package/dist/skill-registry/client.js +0 -345
- package/dist/skill-registry/commands.js +0 -180
- package/dist/skill-registry/evaluation-client.js +0 -156
- package/dist/skill-registry/evaluation-commands.js +0 -174
- package/dist/skill-registry/messages.js +0 -177
- package/dist/skill-registry/package.js +0 -275
- package/dist/skill-registry/platform-package.js +0 -100
- package/dist/utils/environment-endpoints.js +0 -17
- package/dist/utils/tool-operation-journal.js +0 -124
- package/dist/utils/video-evidence-git.js +0 -81
- package/dist/video-replication/client.js +0 -222
- package/dist/video-replication/comparison-evidence.js +0 -149
- package/dist/video-replication/comparison-files.js +0 -57
- package/dist/video-replication/comparison-log.js +0 -72
- package/dist/video-replication/comparison-messages.js +0 -104
- package/dist/video-replication/comparison-output.js +0 -63
- package/dist/video-replication/comparison-preflight.js +0 -66
- package/dist/video-replication/comparison.js +0 -216
- package/dist/video-replication/evidence.js +0 -165
- package/dist/video-replication/media.js +0 -111
- package/dist/video-replication/messages.js +0 -89
- package/dist/workspace/messages.js +0 -35
- package/dist/workspace/transfer-client.js +0 -174
- package/dist/workspace-runtime/codex/app-server.js +0 -1040
- package/dist/workspace-runtime/codex/compact.js +0 -46
- package/dist/workspace-runtime/codex/config-toml.js +0 -107
- package/dist/workspace-runtime/codex/jsonrpc-stdio.js +0 -145
- package/dist/workspace-runtime/codex/launcher-client.js +0 -177
- package/dist/workspace-runtime/codex/loopback.js +0 -146
- package/dist/workspace-runtime/codex/mcp-config.js +0 -39
- package/dist/workspace-runtime/codex/model-broker.js +0 -263
- package/dist/workspace-runtime/codex/native-adapter.js +0 -9
- package/dist/workspace-runtime/codex/permissions.js +0 -70
- package/dist/workspace-runtime/codex/thread-image.js +0 -38
- package/dist/workspace-runtime/codex/ui-instructions.js +0 -4
- package/dist/workspace-runtime/codex/ui-tools.js +0 -183
- package/dist/workspace-runtime/codex/work-mode.js +0 -15
- package/dist/workspace-runtime/main.js +0 -10
- package/dist/workspace-runtime/persistence/journal.js +0 -365
- package/dist/workspace-runtime/persistence/native-subagents.js +0 -162
- package/dist/workspace-runtime/persistence/sqlite-client.js +0 -77
- package/dist/workspace-runtime/persistence/sqlite-worker.js +0 -1161
- package/dist/workspace-runtime/persistence/stopped-execution.js +0 -77
- package/dist/workspace-runtime/previews/output.js +0 -36
- package/dist/workspace-runtime/previews/publish.js +0 -262
- package/dist/workspace-runtime/previews/single-file.js +0 -43
- package/dist/workspace-runtime/processes/managed-writes.js +0 -69
- package/dist/workspace-runtime/production/content-changes.js +0 -36
- package/dist/workspace-runtime/production/contracts.js +0 -19
- package/dist/workspace-runtime/production/controller.js +0 -218
- package/dist/workspace-runtime/production/dependencies.js +0 -60
- package/dist/workspace-runtime/production/native.js +0 -212
- package/dist/workspace-runtime/production/processes.js +0 -102
- package/dist/workspace-runtime/production/save-command.js +0 -35
- package/dist/workspace-runtime/production/source-archive.js +0 -137
- package/dist/workspace-runtime/production/source-copy.js +0 -91
- package/dist/workspace-runtime/production/stages.js +0 -334
- package/dist/workspace-runtime/production/storage.js +0 -75
- package/dist/workspace-runtime/serve.js +0 -214
- package/dist/workspace-runtime/server/auth.js +0 -21
- package/dist/workspace-runtime/server/connectivity.js +0 -201
- package/dist/workspace-runtime/server/desktop-host.js +0 -429
- package/dist/workspace-runtime/server/desktop-preview-config.js +0 -81
- package/dist/workspace-runtime/server/desktop-preview-service.js +0 -157
- package/dist/workspace-runtime/server/desktop-preview-static.js +0 -53
- package/dist/workspace-runtime/server/desktop-preview.js +0 -189
- package/dist/workspace-runtime/server/dispatch.js +0 -1217
- package/dist/workspace-runtime/server/endpoints.js +0 -21
- package/dist/workspace-runtime/server/execution-group.js +0 -90
- package/dist/workspace-runtime/server/http.js +0 -1243
- package/dist/workspace-runtime/server/lock.js +0 -53
- package/dist/workspace-runtime/server/rfb-watch-gate.js +0 -168
- package/dist/workspace-runtime/server/source-uploader.js +0 -138
- package/dist/workspace-runtime/server/terminal-host.js +0 -366
- package/dist/workspace-runtime/server/types.js +0 -1
- package/dist/workspace-runtime/server/workspace-transfer.js +0 -99
- package/dist/workspace-runtime/workspaces/archive.js +0 -207
- package/dist/workspace-runtime/workspaces/artifact-events.js +0 -55
- package/dist/workspace-runtime/workspaces/artifact-files.js +0 -197
- package/dist/workspace-runtime/workspaces/artifact-receipts.js +0 -89
- package/dist/workspace-runtime/workspaces/artifacts.js +0 -282
- package/dist/workspace-runtime/workspaces/attachment-content.js +0 -123
- package/dist/workspace-runtime/workspaces/attachments.js +0 -185
- package/dist/workspace-runtime/workspaces/batch-commit.js +0 -142
- package/dist/workspace-runtime/workspaces/cli-context.js +0 -23
- package/dist/workspace-runtime/workspaces/cli-credentials.js +0 -111
- package/dist/workspace-runtime/workspaces/composer-context.js +0 -147
- package/dist/workspace-runtime/workspaces/context-error.js +0 -2
- package/dist/workspace-runtime/workspaces/dependencies.js +0 -264
- package/dist/workspace-runtime/workspaces/developer-command.js +0 -64
- package/dist/workspace-runtime/workspaces/directories.js +0 -133
- package/dist/workspace-runtime/workspaces/directory-access.js +0 -37
- package/dist/workspace-runtime/workspaces/directory-attachments.js +0 -245
- package/dist/workspace-runtime/workspaces/directory-maintenance.js +0 -111
- package/dist/workspace-runtime/workspaces/directory-stats.js +0 -49
- package/dist/workspace-runtime/workspaces/disk-snapshot.js +0 -31
- package/dist/workspace-runtime/workspaces/empty-template.js +0 -42
- package/dist/workspace-runtime/workspaces/files-search.js +0 -116
- package/dist/workspace-runtime/workspaces/files.js +0 -120
- package/dist/workspace-runtime/workspaces/git-credential-broker.js +0 -312
- package/dist/workspace-runtime/workspaces/git-credential-helper.js +0 -68
- package/dist/workspace-runtime/workspaces/git-direct-store.js +0 -155
- package/dist/workspace-runtime/workspaces/git.js +0 -670
- package/dist/workspace-runtime/workspaces/instructions.js +0 -56
- package/dist/workspace-runtime/workspaces/json5-edit.js +0 -170
- package/dist/workspace-runtime/workspaces/library-attachments.js +0 -268
- package/dist/workspace-runtime/workspaces/optional-platform-skills.js +0 -14
- package/dist/workspace-runtime/workspaces/parameters.js +0 -272
- package/dist/workspace-runtime/workspaces/prepare.js +0 -278
- package/dist/workspace-runtime/workspaces/registry.js +0 -251
- package/dist/workspace-runtime/workspaces/remix-references.js +0 -301
- package/dist/workspace-runtime/workspaces/revisions.js +0 -31
- package/dist/workspace-runtime/workspaces/session-image.js +0 -104
- package/dist/workspace-runtime/workspaces/shared-git.js +0 -40
- package/dist/workspace-runtime/workspaces/skill-artifact-loader.js +0 -95
- package/dist/workspace-runtime/workspaces/skills.js +0 -191
- package/dist/workspace-runtime/workspaces/transfer.js +0 -288
- package/dist/workspace-runtime/workspaces/turn-changes.js +0 -75
- package/dist/workspace-runtime/workspaces/video-attachments.js +0 -49
- package/project-template/.claude/skills/playcraft-replica-validation/SKILL.md +0 -25
- package/project-template/.claude/skills/playcraft-replica-validation/references/contracts.md +0 -79
- package/project-template/.claude/skills/playcraft-video-understanding/SKILL.md +0 -29
- package/project-template/.claude/skills/playcraft-video-understanding/references/contracts.md +0 -37
- package/project-template-v2/.claude/agents/artist.md +0 -82
- package/project-template-v2/.claude/agents/developer.md +0 -153
- package/project-template-v2/.claude/agents/game-designer.md +0 -264
- package/project-template-v2/.claude/agents/refs/artist-art-style-catalog.md +0 -533
- package/project-template-v2/.claude/agents/refs/artist-color-audio-recipes.md +0 -153
- package/project-template-v2/.claude/agents/refs/artist-dimension-axis.md +0 -27
- package/project-template-v2/.claude/agents/refs/artist-master-composite-recipes.md +0 -208
- package/project-template-v2/.claude/agents/refs/atom-skill-library.md +0 -81
- package/project-template-v2/.claude/agents/refs/developer-impl-cookbook.md +0 -432
- package/project-template-v2/.claude/agents/refs/framework-5-component-filter.md +0 -252
- package/project-template-v2/.claude/agents/refs/framework-game-feel-juice.md +0 -266
- package/project-template-v2/.claude/agents/refs/framework-mda.md +0 -147
- package/project-template-v2/.claude/agents/refs/game-designer-gameplay-sufficiency.md +0 -123
- package/project-template-v2/.claude/agents/refs/ta-3d-flip-recipe.md +0 -88
- package/project-template-v2/.claude/agents/refs/ta-atlas-deliverable-standard.md +0 -67
- package/project-template-v2/.claude/agents/refs/ta-batch-pipeline-recipes.md +0 -120
- package/project-template-v2/.claude/agents/refs/ta-image-generation-detail.md +0 -300
- package/project-template-v2/.claude/agents/refs/ta-image-ops-reference.md +0 -495
- package/project-template-v2/.claude/agents/refs/ta-pipeline-cookbook.md +0 -1141
- package/project-template-v2/.claude/agents/refs/ta-tools-reference.md +0 -111
- package/project-template-v2/.claude/agents/refs/ta-vfx-preset-catalog.md +0 -365
- package/project-template-v2/.claude/agents/refs/threejs-cannon-pitfalls.md +0 -412
- package/project-template-v2/.claude/agents/reviewer.md +0 -75
- package/project-template-v2/.claude/agents/technical-artist.md +0 -86
- package/project-template-v2/.claude/hooks/snapshot-milestone.mjs +0 -243
- package/project-template-v2/.claude/hooks/user-prompt.mjs +0 -133
- package/project-template-v2/.claude/settings.json +0 -33
- package/project-template-v2/.claude/skills/brainstorming/SKILL.md +0 -161
- package/project-template-v2/.claude/skills/brainstorming/scripts/frame-template.html +0 -270
- package/project-template-v2/.claude/skills/brainstorming/scripts/helper.js +0 -177
- package/project-template-v2/.claude/skills/brainstorming/scripts/server.cjs +0 -354
- package/project-template-v2/.claude/skills/brainstorming/scripts/start-server.sh +0 -148
- package/project-template-v2/.claude/skills/brainstorming/scripts/stop-server.sh +0 -56
- package/project-template-v2/.claude/skills/brainstorming/scripts/wait-for-selection.sh +0 -62
- package/project-template-v2/.claude/skills/brainstorming/spec-document-reviewer-prompt.md +0 -49
- package/project-template-v2/.claude/skills/brainstorming/visual-companion.md +0 -309
- package/project-template-v2/.claude/skills/playcraft-ad-psychology/SKILL.md +0 -182
- package/project-template-v2/.claude/skills/playcraft-art-style-guide/SKILL.md +0 -123
- package/project-template-v2/.claude/skills/playcraft-asset-state-sheet/SKILL.md +0 -205
- package/project-template-v2/.claude/skills/playcraft-audio-generation/SKILL.md +0 -280
- package/project-template-v2/.claude/skills/playcraft-batch-pipeline/SKILL.md +0 -184
- package/project-template-v2/.claude/skills/playcraft-build-optimizer/SKILL.md +0 -306
- package/project-template-v2/.claude/skills/playcraft-image-generation/SKILL.md +0 -298
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/build-sprite-sheet.template.mjs +0 -123
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/compare-style.template.mjs +0 -254
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +0 -324
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +0 -97
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-edit-variants.template.mjs +0 -118
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +0 -137
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +0 -397
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/validate-sprite-sheet.template.mjs +0 -296
- package/project-template-v2/.claude/skills/playcraft-image-ops/SKILL.md +0 -122
- package/project-template-v2/.claude/skills/playcraft-image-processing/SKILL.md +0 -219
- package/project-template-v2/.claude/skills/playcraft-masking/SKILL.md +0 -373
- package/project-template-v2/.claude/skills/playcraft-playable-optimization/SKILL.md +0 -161
- package/project-template-v2/.claude/skills/playcraft-research/SKILL.md +0 -215
- package/project-template-v2/.claude/skills/playcraft-skill-recommender/SKILL.md +0 -382
- package/project-template-v2/.claude/skills/playcraft-sprite-generation/SKILL.md +0 -423
- package/project-template-v2/.claude/skills/playcraft-sprite-remix/SKILL.md +0 -158
- package/project-template-v2/.claude/skills/playcraft-sprite-sheet/SKILL.md +0 -100
- package/project-template-v2/.claude/skills/playcraft-storyboard/SKILL.md +0 -167
- package/project-template-v2/.claude/skills/playcraft-style-qa/SKILL.md +0 -270
- package/project-template-v2/.claude/skills/playcraft-text-rendering/SKILL.md +0 -236
- package/project-template-v2/.claude/skills/playcraft-vfx-animation/SKILL.md +0 -130
- package/project-template-v2/.claude/skills/playwright-cli/SKILL.md +0 -390
- package/project-template-v2/.claude/skills/playwright-cli/references/element-attributes.md +0 -23
- package/project-template-v2/.claude/skills/playwright-cli/references/playwright-tests.md +0 -39
- package/project-template-v2/.claude/skills/playwright-cli/references/request-mocking.md +0 -87
- package/project-template-v2/.claude/skills/playwright-cli/references/running-code.md +0 -240
- package/project-template-v2/.claude/skills/playwright-cli/references/session-management.md +0 -226
- package/project-template-v2/.claude/skills/playwright-cli/references/spec-driven-testing.md +0 -308
- package/project-template-v2/.claude/skills/playwright-cli/references/storage-state.md +0 -275
- package/project-template-v2/.claude/skills/playwright-cli/references/test-generation.md +0 -134
- package/project-template-v2/.claude/skills/playwright-cli/references/tracing.md +0 -142
- package/project-template-v2/.claude/skills/playwright-cli/references/video-recording.md +0 -153
- package/project-template-v2/.claude/skills/session-analyzer/SKILL.md +0 -386
- package/project-template-v2/.claude/skills/session-analyzer/scripts/execution-breakdown.mjs +0 -182
- package/project-template-v2/.claude/skills/session-analyzer/scripts/find-turns.mjs +0 -72
- package/project-template-v2/.claude/skills/session-analyzer/scripts/heavy-output.mjs +0 -121
- package/project-template-v2/.claude/skills/session-analyzer/scripts/resolve-session.mjs +0 -102
- package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-stats.mjs +0 -127
- package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-tool-timeline.mjs +0 -106
- package/project-template-v2/.claude/skills/session-analyzer/scripts/time-gaps.mjs +0 -128
- package/project-template-v2/.claude/skills/session-analyzer/scripts/turn-timeline.mjs +0 -67
- package/project-template-v2/.claude/snapshot.mjs +0 -263
- package/project-template-v2/.playcraft/skills.lock.json +0 -152
- package/project-template-v2/CLAUDE.md +0 -146
- 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 +0 -254
- package/project-template-v2/docs/harness/iteration-1/generate-flow.md +0 -91
- package/project-template-v2/docs/harness/iteration-1/ideate-flow.md +0 -214
- package/project-template-v2/docs/harness/iteration-1/optimize-flow.md +0 -75
- package/project-template-v2/docs/harness/iteration-1/wrapup-flow.md +0 -63
- package/project-template-v2/docs/harness/iteration-2/context-flow.md +0 -223
- package/project-template-v2/docs/harness/iteration-2/generate-flow.md +0 -129
- package/project-template-v2/docs/harness/iteration-2/ideate-flow.md +0 -267
- package/project-template-v2/docs/harness/iteration-2/optimize-flow.md +0 -164
- package/project-template-v2/docs/harness/iteration-2/wrapup-flow.md +0 -115
- package/project-template-v2/docs/harness/orchestrator-flow.md +0 -364
- package/project-template-v2/docs/project-state.json +0 -60
- package/project-template-v2/docs/project-state.md +0 -72
- package/project-template-v2/docs/standards/README.md +0 -225
- package/project-template-v2/docs/standards/agent-behavior-standards.md +0 -174
- package/project-template-v2/docs/standards/artifacts/design-brief.md +0 -19
- package/project-template-v2/docs/standards/artifacts/design.md +0 -22
- package/project-template-v2/docs/standards/artifacts/game-code.md +0 -41
- package/project-template-v2/docs/standards/artifacts/todo-list.md +0 -41
- package/project-template-v2/docs/standards/iter1-agent-behavior-standards.md +0 -343
- package/project-template-v2/game/index.ts +0 -18
- package/project-template-v2/globals.d.ts +0 -51
- package/project-template-v2/index.css +0 -34
- package/project-template-v2/index.html +0 -18
- package/project-template-v2/main.ts +0 -9
- package/project-template-v2/package.json +0 -46
- package/project-template-v2/skills/_shared/scripts/dispatch-clear.mjs +0 -31
- package/project-template-v2/skills/_shared/scripts/dispatch-set.mjs +0 -86
- package/project-template-v2/skills/_shared/scripts/dod-check.mjs +0 -153
- package/project-template-v2/skills/_shared/scripts/handoff-append.mjs +0 -70
- package/project-template-v2/skills/_shared/scripts/lib/validator-artifacts.mjs +0 -91
- package/project-template-v2/skills/_shared/scripts/pipeline/dod-config.mjs +0 -131
- package/project-template-v2/skills/_shared/scripts/pipeline/index.mjs +0 -80
- package/project-template-v2/skills/_shared/scripts/pipeline/iteration-1-core.mjs +0 -90
- package/project-template-v2/skills/_shared/scripts/pipeline/iteration-2-wrap.mjs +0 -93
- package/project-template-v2/skills/_shared/scripts/pipeline/iteration-3-visual.mjs +0 -23
- package/project-template-v2/skills/_shared/scripts/render-project-state.mjs +0 -230
- package/project-template-v2/skills/_shared/scripts/state-advance-stage.mjs +0 -58
- package/project-template-v2/skills/_shared/scripts/state-get.mjs +0 -339
- package/project-template-v2/skills/_shared/scripts/state-handoff.mjs +0 -39
- package/project-template-v2/skills/_shared/scripts/state-set.mjs +0 -94
- package/project-template-v2/skills/_shared/scripts/state-store.mjs +0 -783
- package/project-template-v2/skills/_shared/scripts/todo-add.mjs +0 -88
- package/project-template-v2/skills/_shared/scripts/todo-get.mjs +0 -130
- package/project-template-v2/skills/_shared/scripts/todo-remove.mjs +0 -33
- package/project-template-v2/skills/_shared/scripts/todo-set.mjs +0 -47
- package/project-template-v2/skills/_shared/scripts/verify-asset-code-sync.mjs +0 -268
- package/project-template-v2/skills/_shared/scripts/verify-env.mjs +0 -285
- package/project-template-v2/skills/_shared/scripts/verify-placeholders.mjs +0 -161
- package/project-template-v2/skills/playable-autoplay/SKILL.md +0 -176
- package/project-template-v2/skills/playable-autoplay/agents/openai.yaml +0 -4
- package/project-template-v2/skills/playable-debug/SKILL.md +0 -116
- package/project-template-v2/skills/playable-debug/agents/openai.yaml +0 -4
- package/project-template-v2/skills/playable-debug/references/debug-config.md +0 -40
- package/project-template-v2/skills/playable-record/SKILL.md +0 -140
- package/project-template-v2/skills/playable-record/scripts/lib/dev-server.mjs +0 -104
- package/project-template-v2/skills/playable-record/scripts/lib/record-audio-bridge.js +0 -141
- package/project-template-v2/skills/playable-record/scripts/record-playable.mjs +0 -425
- package/project-template-v2/skills/playable-record/scripts/verify-contract.mjs +0 -261
- package/project-template-v2/skills/playable-record/scripts/verify-firstwin.mjs +0 -398
- package/project-template-v2/skills/playable-record/scripts/verify-fusion.mjs +0 -322
- package/project-template-v2/skills/playable-record/scripts/verify-lifecycle.mjs +0 -105
- package/project-template-v2/skills/playable-record/scripts/verify-vlm-video.mjs +0 -230
- package/project-template-v2/skills/playable-validate/SKILL.md +0 -61
- package/project-template-v2/skills/playable-validate/validation-rules.md +0 -14
- package/project-template-v2/skills/playable-verify-ui/SKILL.md +0 -63
- package/project-template-v2/skills/playable-verify-ui/scripts/lib/__init__.py +0 -1
- package/project-template-v2/skills/playable-verify-ui/scripts/lib/config_expr.js +0 -218
- package/project-template-v2/skills/playable-verify-ui/scripts/lib/node_utils.js +0 -51
- package/project-template-v2/skills/playable-verify-ui/scripts/lib/profile_loader.py +0 -59
- package/project-template-v2/skills/playable-verify-ui/scripts/lib/report.py +0 -106
- package/project-template-v2/skills/playable-verify-ui/scripts/lib/runtime_contract.js +0 -116
- package/project-template-v2/skills/playable-verify-ui/scripts/verify_fetch_antipatterns.py +0 -59
- package/project-template-v2/skills/playable-verify-ui/scripts/verify_hardcoded_layout.js +0 -64
- package/project-template-v2/skills/playable-verify-ui/scripts/verify_runtime_contract.js +0 -58
- package/project-template-v2/skills/playable-verify-ui/scripts/verify_text_overlap.py +0 -333
- package/project-template-v2/ta-workspace/scripts/.gitkeep +0 -0
- package/project-template-v2/tsconfig.json +0 -20
- package/project-template-v2/vite.config.ts +0 -27
- package/project-templates/batch-locks/phaser.yaml +0 -922
- package/project-templates/batch-locks/threejs.yaml +0 -978
- package/project-templates/empty/AGENTS.md +0 -41
- package/project-templates/empty/gitignore +0 -33
package/dist/commands/tools.js
CHANGED
|
@@ -1,16 +1,16 @@
|
|
|
1
1
|
import { registerGenerationCommands } from './tools-generation.js';
|
|
2
|
-
import { registerBatchCommands } from './tools-batch.js';
|
|
3
2
|
import { registerProjectCommands } from './tools-project.js';
|
|
4
3
|
import { register3DCommands } from './tools-3d.js';
|
|
5
4
|
import { registerDetectCommand } from './tools-detect.js';
|
|
6
5
|
import { registerVideoReviewCommand } from './tools-video-review.js';
|
|
6
|
+
import { registerImageContextCommand } from './tools-image-context.js';
|
|
7
7
|
export function registerToolsCommands(program) {
|
|
8
8
|
const tools = program
|
|
9
9
|
.command('tools')
|
|
10
10
|
.description('后端 /api/agent/tools;运行 playcraft login 后即可直接使用,也支持 .playcraft.json 或 PLAYCRAFT_SANDBOX_TOKEN 环境变量');
|
|
11
11
|
registerGenerationCommands(tools);
|
|
12
|
+
registerImageContextCommand(tools);
|
|
12
13
|
registerProjectCommands(tools);
|
|
13
|
-
registerBatchCommands(tools);
|
|
14
14
|
register3DCommands(tools);
|
|
15
15
|
registerDetectCommand(tools);
|
|
16
16
|
registerVideoReviewCommand(tools);
|
package/dist/config.js
CHANGED
|
@@ -2,8 +2,7 @@ import { cosmiconfig } from 'cosmiconfig';
|
|
|
2
2
|
import { z } from 'zod';
|
|
3
3
|
import path from 'path';
|
|
4
4
|
import { homedir } from 'os';
|
|
5
|
-
import {
|
|
6
|
-
import { randomUUID } from 'node:crypto';
|
|
5
|
+
import { mkdirSync, writeFileSync, readFileSync } from 'fs';
|
|
7
6
|
import 'dotenv/config';
|
|
8
7
|
export const ConfigSchema = z.object({
|
|
9
8
|
projectId: z.string().optional(),
|
|
@@ -19,33 +18,6 @@ const explorer = cosmiconfig('playcraft', {
|
|
|
19
18
|
});
|
|
20
19
|
const GLOBAL_CONFIG_DIR = path.join(homedir(), '.playcraft');
|
|
21
20
|
const GLOBAL_CONFIG_FILE = path.join(GLOBAL_CONFIG_DIR, 'config.json');
|
|
22
|
-
export function normalizeEnvironmentBaseUrl(raw) {
|
|
23
|
-
try {
|
|
24
|
-
const url = new URL(raw);
|
|
25
|
-
if (!['http:', 'https:'].includes(url.protocol) || url.username || url.password)
|
|
26
|
-
return undefined;
|
|
27
|
-
url.hash = '';
|
|
28
|
-
url.search = '';
|
|
29
|
-
url.pathname = url.pathname.replace(/\/+$/, '').replace(/\/api$/, '');
|
|
30
|
-
return url.toString().replace(/\/+$/, '');
|
|
31
|
-
}
|
|
32
|
-
catch {
|
|
33
|
-
return undefined;
|
|
34
|
-
}
|
|
35
|
-
}
|
|
36
|
-
export function readEnvironmentProfile(config, baseUrl) {
|
|
37
|
-
const key = normalizeEnvironmentBaseUrl(baseUrl);
|
|
38
|
-
const profiles = config.environmentProfiles;
|
|
39
|
-
if (!key || !profiles || typeof profiles !== 'object' || Array.isArray(profiles))
|
|
40
|
-
return undefined;
|
|
41
|
-
const profile = profiles[key];
|
|
42
|
-
if (!profile || typeof profile !== 'object' || Array.isArray(profile))
|
|
43
|
-
return undefined;
|
|
44
|
-
const value = profile;
|
|
45
|
-
if (typeof value.token !== 'string' || !value.token || normalizeEnvironmentBaseUrl(value.backendUrl) !== key)
|
|
46
|
-
return undefined;
|
|
47
|
-
return value;
|
|
48
|
-
}
|
|
49
21
|
export function loadGlobalConfig() {
|
|
50
22
|
try {
|
|
51
23
|
const content = readFileSync(GLOBAL_CONFIG_FILE, 'utf-8');
|
|
@@ -56,8 +28,7 @@ export function loadGlobalConfig() {
|
|
|
56
28
|
}
|
|
57
29
|
}
|
|
58
30
|
export function saveGlobalConfig(partial) {
|
|
59
|
-
mkdirSync(GLOBAL_CONFIG_DIR, { recursive: true
|
|
60
|
-
chmodSync(GLOBAL_CONFIG_DIR, 0o700);
|
|
31
|
+
mkdirSync(GLOBAL_CONFIG_DIR, { recursive: true });
|
|
61
32
|
let existing = {};
|
|
62
33
|
try {
|
|
63
34
|
existing = JSON.parse(readFileSync(GLOBAL_CONFIG_FILE, 'utf-8'));
|
|
@@ -66,25 +37,7 @@ export function saveGlobalConfig(partial) {
|
|
|
66
37
|
// ignore
|
|
67
38
|
}
|
|
68
39
|
const merged = { ...existing, ...partial };
|
|
69
|
-
|
|
70
|
-
try {
|
|
71
|
-
writeFileSync(temporary, JSON.stringify(merged, null, 2), { encoding: 'utf-8', flag: 'wx', mode: 0o600 });
|
|
72
|
-
renameSync(temporary, GLOBAL_CONFIG_FILE);
|
|
73
|
-
}
|
|
74
|
-
finally {
|
|
75
|
-
rmSync(temporary, { force: true });
|
|
76
|
-
}
|
|
77
|
-
}
|
|
78
|
-
export function saveEnvironmentProfile(baseUrl, profile) {
|
|
79
|
-
const key = normalizeEnvironmentBaseUrl(baseUrl);
|
|
80
|
-
if (!key)
|
|
81
|
-
throw new Error('Invalid environment address');
|
|
82
|
-
const current = loadGlobalConfig();
|
|
83
|
-
const profiles = current.environmentProfiles && typeof current.environmentProfiles === 'object'
|
|
84
|
-
&& !Array.isArray(current.environmentProfiles) ? current.environmentProfiles : {};
|
|
85
|
-
saveGlobalConfig({ environmentProfiles: { ...profiles,
|
|
86
|
-
[key]: { ...profile, backendUrl: key, updatedAt: new Date().toISOString() } },
|
|
87
|
-
token: profile.token, url: key, backendUrl: key });
|
|
40
|
+
writeFileSync(GLOBAL_CONFIG_FILE, JSON.stringify(merged, null, 2), 'utf-8');
|
|
88
41
|
}
|
|
89
42
|
export async function loadConfig(cliOptions) {
|
|
90
43
|
const result = await explorer.search(cliOptions.dir || process.cwd());
|
|
@@ -93,20 +46,12 @@ export async function loadConfig(cliOptions) {
|
|
|
93
46
|
? (fileConfig.agent || {})
|
|
94
47
|
: fileConfig;
|
|
95
48
|
const globalConfig = loadGlobalConfig();
|
|
96
|
-
const explicitTarget = cliOptions.url || process.env.PLAYCRAFT_URL || agentConfig.url;
|
|
97
|
-
const targetUrl = explicitTarget || globalConfig.url;
|
|
98
|
-
const profile = typeof targetUrl === 'string' ? readEnvironmentProfile(globalConfig, targetUrl) : undefined;
|
|
99
|
-
const legacyTarget = typeof globalConfig.backendUrl === 'string' ? globalConfig.backendUrl
|
|
100
|
-
: typeof globalConfig.url === 'string' ? globalConfig.url : undefined;
|
|
101
|
-
const legacyToken = !explicitTarget || (legacyTarget && normalizeEnvironmentBaseUrl(String(targetUrl)) === normalizeEnvironmentBaseUrl(legacyTarget))
|
|
102
|
-
? globalConfig.token : undefined;
|
|
103
49
|
const config = ConfigSchema.parse({
|
|
104
50
|
...globalConfig,
|
|
105
51
|
...agentConfig,
|
|
106
52
|
...cliOptions,
|
|
107
53
|
projectId: cliOptions.projectId || process.env.PLAYCRAFT_PROJECT_ID || agentConfig.projectId || globalConfig.projectId,
|
|
108
|
-
|
|
109
|
-
token: cliOptions.token || process.env.PLAYCRAFT_TOKEN || agentConfig.token || profile?.token || legacyToken,
|
|
54
|
+
token: cliOptions.token || process.env.PLAYCRAFT_TOKEN || agentConfig.token || globalConfig.token,
|
|
110
55
|
port: cliOptions.port || (process.env.PLAYCRAFT_PORT ? parseInt(process.env.PLAYCRAFT_PORT) : undefined) || agentConfig.port || globalConfig.port,
|
|
111
56
|
mode: cliOptions.mode || process.env.PLAYCRAFT_MODE || agentConfig.mode || globalConfig.mode,
|
|
112
57
|
skillsDir: cliOptions.skillsDir || process.env.AGENT_SKILLS_DIR || agentConfig.skillsDir || globalConfig.skillsDir,
|
package/dist/index.js
CHANGED
|
@@ -1,6 +1,5 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import { Command
|
|
3
|
-
import { accountActivationMessage } from './auth/messages.js';
|
|
2
|
+
import { Command } from 'commander';
|
|
4
3
|
import { readFileSync } from 'fs';
|
|
5
4
|
import { fileURLToPath } from 'url';
|
|
6
5
|
import { dirname, join } from 'path';
|
|
@@ -28,28 +27,16 @@ import { registerLevelsCommands } from './commands/levels.js';
|
|
|
28
27
|
import { registerPatternsCommands } from './commands/patterns.js';
|
|
29
28
|
import { registerPradCommands } from './commands/prad.js';
|
|
30
29
|
import { register3DCommands } from './commands/3d.js';
|
|
31
|
-
import { registerWorkspaceRuntimeCommands } from './commands/workspace-runtime.js';
|
|
32
|
-
import { registerWorkspaceCommands } from './commands/workspace.js';
|
|
33
|
-
import { registerVideoCommands } from './commands/video.js';
|
|
34
|
-
import { registerPlayableCommands } from './commands/playable.js';
|
|
35
|
-
import { videoMessage } from './video-replication/messages.js';
|
|
36
30
|
import { CLI_ROOT_DESCRIPTION, getCliTopicsHelpText, registerRootProgramHelp, } from './cli-root-help.js';
|
|
37
31
|
const __filename = fileURLToPath(import.meta.url);
|
|
38
32
|
const __dirname = dirname(__filename);
|
|
39
33
|
const packageJson = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));
|
|
40
34
|
const program = new Command();
|
|
41
|
-
const structuredVideoTopic = ['video', 'playable'].includes(process.argv[2] ?? '');
|
|
42
|
-
const registryTopic = process.argv[2] === 'skills' && process.argv[3] === 'registry';
|
|
43
|
-
if (structuredVideoTopic)
|
|
44
|
-
program.exitOverride();
|
|
45
35
|
program.name('playcraft').description(CLI_ROOT_DESCRIPTION).version(packageJson.version);
|
|
46
|
-
// Registry upload commands use --version for the skill, after the command name.
|
|
47
|
-
if (registryTopic)
|
|
48
|
-
program.enablePositionalOptions();
|
|
49
36
|
registerRootProgramHelp(program);
|
|
50
37
|
// 版本检查(非阻塞,后台执行)
|
|
51
38
|
// 只在非 upgrade 命令时检查,避免重复提示
|
|
52
|
-
if (!
|
|
39
|
+
if (!process.argv.includes('upgrade')) {
|
|
53
40
|
checkForUpdates(packageJson);
|
|
54
41
|
}
|
|
55
42
|
// create 命令
|
|
@@ -78,8 +65,6 @@ program
|
|
|
78
65
|
.command('login')
|
|
79
66
|
.description('登录 PlayCraft 账号并获取 CLI token')
|
|
80
67
|
.option('--url <url>', 'Portal / API 基址(默认 https://playcraft.aix.intlgame.com,可用环境变量 PLAYCRAFT_URL 覆盖)')
|
|
81
|
-
.option('--activate', accountActivationMessage('activateOption'))
|
|
82
|
-
.option('--token <token>', accountActivationMessage('tokenOption'))
|
|
83
68
|
.action(async (options) => {
|
|
84
69
|
const { loginCommand } = await import('./commands/login.js');
|
|
85
70
|
await loginCommand(options);
|
|
@@ -383,26 +368,4 @@ registerPatternsCommands(program);
|
|
|
383
368
|
registerPradCommands(program);
|
|
384
369
|
// 3D model utilities (playcraft 3d <command>)
|
|
385
370
|
register3DCommands(program);
|
|
386
|
-
|
|
387
|
-
registerWorkspaceCommands(program);
|
|
388
|
-
registerVideoCommands(program);
|
|
389
|
-
registerPlayableCommands(program);
|
|
390
|
-
if (structuredVideoTopic) {
|
|
391
|
-
try {
|
|
392
|
-
await program.parseAsync(process.argv);
|
|
393
|
-
}
|
|
394
|
-
catch (error) {
|
|
395
|
-
if (!(error instanceof CommanderError))
|
|
396
|
-
throw error;
|
|
397
|
-
if (error.exitCode === 0)
|
|
398
|
-
process.exitCode = 0;
|
|
399
|
-
else {
|
|
400
|
-
const command = [process.argv[2], process.argv[3]?.startsWith('-') ? undefined : process.argv[3]].filter(Boolean).join(' ');
|
|
401
|
-
process.stdout.write(`${JSON.stringify({ schemaVersion: 'playcraft.video-cli.v1', command, state: 'failed', ok: false,
|
|
402
|
-
error: { code: 'invalidArguments', message: videoMessage('invalidArguments') } })}\n`);
|
|
403
|
-
process.exitCode = 64;
|
|
404
|
-
}
|
|
405
|
-
}
|
|
406
|
-
}
|
|
407
|
-
else
|
|
408
|
-
program.parse(process.argv);
|
|
371
|
+
program.parse(process.argv);
|
package/dist/remix/clone.js
CHANGED
|
@@ -1,4 +1,3 @@
|
|
|
1
|
-
import { prepareLocalSkillLifecycle } from '../project-skills/lifecycle.js';
|
|
2
1
|
import { spawnSync } from 'node:child_process';
|
|
3
2
|
import { mkdirSync, writeFileSync, readFileSync, existsSync } from 'node:fs';
|
|
4
3
|
import path from 'node:path';
|
|
@@ -152,7 +151,6 @@ export async function remixClone(options) {
|
|
|
152
151
|
};
|
|
153
152
|
writePlaycraftMeta(targetDir, meta);
|
|
154
153
|
configureRepoCredentialHelper(targetDir);
|
|
155
|
-
await prepareLocalSkillLifecycle(targetDir, 'checkout');
|
|
156
154
|
let projectType;
|
|
157
155
|
try {
|
|
158
156
|
const project = await client.get(`/projects/${encodeURIComponent(projectId)}`);
|
|
@@ -1,4 +1,3 @@
|
|
|
1
|
-
import { prepareLocalSkillLifecycle } from '../project-skills/lifecycle.js';
|
|
2
1
|
import * as path from 'node:path';
|
|
3
2
|
import { applyEnginePackToProject, bakeFullTemplate, KNOWN_ADAPTERS, readAdapterFromAtomTree, readEngineMarker, resolveCliPackageRoot, } from '../scaffold/compose.js';
|
|
4
3
|
import { autoLinkSkillsFromAtomTree } from '../commands/skills.js';
|
|
@@ -69,7 +68,6 @@ export async function initTemplateCommand(opts) {
|
|
|
69
68
|
console.log(` ⚠ auto-link skipped: ${err.message}`);
|
|
70
69
|
}
|
|
71
70
|
}
|
|
72
|
-
await prepareLocalSkillLifecycle(projectDir, 'create');
|
|
73
71
|
console.log('\n下一步:');
|
|
74
72
|
console.log(' npm install');
|
|
75
73
|
console.log(' 阅读 .claude/skills/<atom>/SKILL.md(已自动 link)并填 logs/developer-log.md § Skill Preflight');
|
package/dist/remix/pull.js
CHANGED
|
@@ -1,4 +1,3 @@
|
|
|
1
|
-
import { prepareLocalSkillLifecycle } from '../project-skills/lifecycle.js';
|
|
2
1
|
import { spawnSync } from 'node:child_process';
|
|
3
2
|
import { existsSync } from 'node:fs';
|
|
4
3
|
import path from 'node:path';
|
|
@@ -45,7 +44,6 @@ export async function remixPull(options = {}) {
|
|
|
45
44
|
const detail = [result.stderr, result.stdout].filter(Boolean).join('\n').trim();
|
|
46
45
|
throw new Error(detail || `git pull 失败(exit ${result.status})`);
|
|
47
46
|
}
|
|
48
|
-
await prepareLocalSkillLifecycle(repoDir, 'checkout');
|
|
49
47
|
if (options.json) {
|
|
50
48
|
console.log(JSON.stringify({
|
|
51
49
|
schemaVersion: '1.0',
|
package/dist/remix/push.js
CHANGED
|
@@ -1,6 +1,3 @@
|
|
|
1
|
-
import { prepareLocalSkillLifecycle } from '../project-skills/lifecycle.js';
|
|
2
|
-
import { reconcileLocalProjectSkills } from '../project-skills/reconcile.js';
|
|
3
|
-
import { projectSkillsMessage as skillMessage } from '../project-skills/messages.js';
|
|
4
1
|
import { spawnSync } from 'node:child_process';
|
|
5
2
|
import { existsSync } from 'node:fs';
|
|
6
3
|
import path from 'node:path';
|
|
@@ -44,7 +41,6 @@ export async function remixPush(options = {}) {
|
|
|
44
41
|
process.stderr.write(`[push] ${meta.cloneUrl}\n`);
|
|
45
42
|
process.stderr.write(`[push] branch=${meta.branch} dir=${repoDir}\n`);
|
|
46
43
|
}
|
|
47
|
-
const skills = await prepareLocalSkillLifecycle(repoDir, 'push');
|
|
48
44
|
const result = runAuthenticatedGit(['push', ...effectiveArgs], {
|
|
49
45
|
cwd: repoDir,
|
|
50
46
|
token: client.token,
|
|
@@ -54,24 +50,10 @@ export async function remixPush(options = {}) {
|
|
|
54
50
|
const detail = [result.stderr, result.stdout].filter(Boolean).join('\n').trim();
|
|
55
51
|
throw new Error(detail || `git push 失败(exit ${result.status})`);
|
|
56
52
|
}
|
|
57
|
-
let skillIndex;
|
|
58
|
-
let skillIndexFailed = false;
|
|
59
|
-
if (skills.managed) {
|
|
60
|
-
try {
|
|
61
|
-
skillIndex = await reconcileLocalProjectSkills(repoDir, { url: options.url, token: options.token });
|
|
62
|
-
}
|
|
63
|
-
catch (error) {
|
|
64
|
-
skillIndexFailed = true;
|
|
65
|
-
skillIndex = { indexed: false, message: skillMessage('pushIndexFailed'), detail: error instanceof Error ? error.message : String(error) };
|
|
66
|
-
process.exitCode = 1;
|
|
67
|
-
}
|
|
68
|
-
if (!options.json)
|
|
69
|
-
process.stderr.write(`${JSON.stringify(skillIndex)}\n`);
|
|
70
|
-
}
|
|
71
53
|
if (options.json) {
|
|
72
54
|
console.log(JSON.stringify({
|
|
73
55
|
schemaVersion: '1.0',
|
|
74
|
-
ok:
|
|
56
|
+
ok: true,
|
|
75
57
|
command: 'remix.push',
|
|
76
58
|
requestId: client.requestId,
|
|
77
59
|
data: {
|
|
@@ -80,8 +62,6 @@ export async function remixPush(options = {}) {
|
|
|
80
62
|
cloneUrl: meta.cloneUrl,
|
|
81
63
|
dir: repoDir,
|
|
82
64
|
gitArgs: effectiveArgs,
|
|
83
|
-
gitPushed: true,
|
|
84
|
-
skills: skillIndex,
|
|
85
65
|
},
|
|
86
66
|
}));
|
|
87
67
|
return;
|
|
@@ -1,12 +1,8 @@
|
|
|
1
1
|
import { readFileSync, existsSync } from 'fs';
|
|
2
|
-
import {
|
|
2
|
+
import { join } from 'path';
|
|
3
3
|
import { homedir } from 'os';
|
|
4
4
|
import { loadGlobalConfig } from '../config.js';
|
|
5
5
|
import { DEFAULT_PLAYCRAFT_CLOUD_BASE } from '../commands/login.js';
|
|
6
|
-
import { AGENT_TOOL_OPERATION_PROTOCOL, AGENT_TOOL_OPERATION_HEADERS, AGENT_TOOL_OPERATION_CAPABILITIES_PATH, } from '@playcraft/common/agent-tools';
|
|
7
|
-
import { beginToolOperation } from './tool-operation-journal.js';
|
|
8
|
-
import { businessEndpoint } from './environment-endpoints.js';
|
|
9
|
-
import { AccountActivationError, parseErrorPayload, pendingAccountActivationError, } from '../auth/account-activation.js';
|
|
10
6
|
/**
|
|
11
7
|
* 判断 token 是否为用户 PAT(Personal Access Token)。
|
|
12
8
|
* PAT 以 "playcraft_pat_" 开头;沙箱 JWT 为三段式 base64。
|
|
@@ -19,8 +15,8 @@ function isPatToken(token) {
|
|
|
19
15
|
* or from the CLI after `playcraft login`.
|
|
20
16
|
*
|
|
21
17
|
* 凭证解析优先级:
|
|
22
|
-
* API URL : PLAYCRAFT_API_URL →
|
|
23
|
-
* Token : PLAYCRAFT_SANDBOX_TOKEN →
|
|
18
|
+
* API URL : PLAYCRAFT_API_URL → .playcraft.json → ~/.playcraft/config.json → DEFAULT_PLAYCRAFT_CLOUD_BASE
|
|
19
|
+
* Token : PLAYCRAFT_SANDBOX_TOKEN → .playcraft.json token → ~/.playcraft/config.json token (PAT)
|
|
24
20
|
*
|
|
25
21
|
* 鉴权 header 自动选择:
|
|
26
22
|
* - 沙箱 JWT (非 PAT) → X-Sandbox-Token: <token>(后端 @SandboxToken 路由的沙箱分支)
|
|
@@ -29,7 +25,7 @@ function isPatToken(token) {
|
|
|
29
25
|
export class AgentApiClient {
|
|
30
26
|
apiUrl;
|
|
31
27
|
token;
|
|
32
|
-
|
|
28
|
+
isPat;
|
|
33
29
|
playcraftEnv;
|
|
34
30
|
constructor() {
|
|
35
31
|
const localConfig = AgentApiClient.loadLocalConfig();
|
|
@@ -40,7 +36,7 @@ export class AgentApiClient {
|
|
|
40
36
|
globalConfig.backendUrl ||
|
|
41
37
|
globalConfig.url ||
|
|
42
38
|
DEFAULT_PLAYCRAFT_CLOUD_BASE).replace(/\/+$/, '');
|
|
43
|
-
// Token: 环境变量 →
|
|
39
|
+
// Token: 沙箱 token 环境变量 → 本地 .playcraft.json → 全局 login 配置(PAT)
|
|
44
40
|
const token = process.env.PLAYCRAFT_SANDBOX_TOKEN ||
|
|
45
41
|
localConfig.token ||
|
|
46
42
|
globalConfig.token ||
|
|
@@ -51,147 +47,43 @@ export class AgentApiClient {
|
|
|
51
47
|
}
|
|
52
48
|
this.apiUrl = apiUrl;
|
|
53
49
|
this.token = token;
|
|
54
|
-
this.
|
|
55
|
-
this.playcraftEnv = (process.env.PLAYCRAFT_ENV ||
|
|
50
|
+
this.isPat = isPatToken(token);
|
|
51
|
+
this.playcraftEnv = (process.env.PLAYCRAFT_ENV ||
|
|
52
|
+
localConfig.env ||
|
|
53
|
+
'').trim();
|
|
56
54
|
}
|
|
57
55
|
/** 根据 token 类型构造鉴权 headers */
|
|
58
56
|
authHeaders() {
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
try {
|
|
63
|
-
token = JSON.parse(readFileSync(this.credentialFile, 'utf8')).token || token;
|
|
64
|
-
}
|
|
65
|
-
catch { /* Keep the last credential if a local file is temporarily unavailable. */ }
|
|
66
|
-
}
|
|
67
|
-
const headers = isPatToken(token)
|
|
68
|
-
? { Authorization: `Bearer ${token}` }
|
|
69
|
-
: { 'X-Sandbox-Token': token };
|
|
57
|
+
const headers = this.isPat
|
|
58
|
+
? { Authorization: `Bearer ${this.token}` }
|
|
59
|
+
: { 'X-Sandbox-Token': this.token };
|
|
70
60
|
if (this.playcraftEnv) {
|
|
71
61
|
headers['playcraft-env'] = this.playcraftEnv;
|
|
72
62
|
}
|
|
73
63
|
return headers;
|
|
74
64
|
}
|
|
75
|
-
/**
|
|
65
|
+
/** Absolute pathname under /api/agent/tools (path may omit leading slash). */
|
|
76
66
|
toolsRequestUrl(path) {
|
|
77
67
|
const p = path.startsWith('/') ? path : `/${path}`;
|
|
78
|
-
return
|
|
68
|
+
return new URL(`/api/agent/tools${p}`, this.apiUrl);
|
|
79
69
|
}
|
|
80
|
-
async post(path, body
|
|
81
|
-
const url = this.toolsRequestUrl(path);
|
|
82
|
-
const
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
70
|
+
async post(path, body) {
|
|
71
|
+
const url = this.toolsRequestUrl(path).href;
|
|
72
|
+
const res = await fetch(url, {
|
|
73
|
+
method: 'POST',
|
|
74
|
+
headers: {
|
|
75
|
+
'Content-Type': 'application/json',
|
|
76
|
+
...this.authHeaders(),
|
|
77
|
+
},
|
|
78
|
+
body: JSON.stringify(body),
|
|
88
79
|
});
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
try {
|
|
93
|
-
try {
|
|
94
|
-
await options?.onPrepared?.({ requestId: operation.requestId, file: operation.file });
|
|
95
|
-
}
|
|
96
|
-
catch {
|
|
97
|
-
operation.reject();
|
|
98
|
-
throw new ToolRequestError('Tool request preparation failed; no operation was sent');
|
|
99
|
-
}
|
|
100
|
-
const capabilityResponse = await fetch(this.toolsRequestUrl(AGENT_TOOL_OPERATION_CAPABILITIES_PATH), {
|
|
101
|
-
headers: this.authHeaders(),
|
|
102
|
-
redirect: 'error',
|
|
103
|
-
signal: options?.signal
|
|
104
|
-
? AbortSignal.any([options.signal, AbortSignal.timeout(30_000)])
|
|
105
|
-
: AbortSignal.timeout(30_000),
|
|
106
|
-
});
|
|
107
|
-
if (!capabilityResponse.ok) {
|
|
108
|
-
if (capabilityResponse.status === 403) {
|
|
109
|
-
const pending = pendingAccountActivationError(403, parseErrorPayload(await capabilityResponse.clone().text().catch(() => '')));
|
|
110
|
-
if (pending) {
|
|
111
|
-
if (operation.createdNew && !operation.settledOnly)
|
|
112
|
-
operation.reject();
|
|
113
|
-
throw pending;
|
|
114
|
-
}
|
|
115
|
-
}
|
|
116
|
-
await capabilityResponse.body?.cancel();
|
|
117
|
-
throw new ToolRequestError(`Business tool protocol unavailable (${capabilityResponse.status}); no operation was sent`);
|
|
118
|
-
}
|
|
119
|
-
const capabilities = (await capabilityResponse.json());
|
|
120
|
-
if (capabilities.protocol !== AGENT_TOOL_OPERATION_PROTOCOL ||
|
|
121
|
-
capabilities.settledOnly !== true)
|
|
122
|
-
throw new ToolRequestError('Business tool protocol is incompatible; no operation was sent');
|
|
123
|
-
const res = await fetch(url, {
|
|
124
|
-
method: 'POST',
|
|
125
|
-
redirect: 'error',
|
|
126
|
-
signal: options?.signal
|
|
127
|
-
? AbortSignal.any([options.signal, AbortSignal.timeout(30 * 60_000)])
|
|
128
|
-
: AbortSignal.timeout(30 * 60_000),
|
|
129
|
-
headers: {
|
|
130
|
-
'Content-Type': 'application/json',
|
|
131
|
-
...this.authHeaders(),
|
|
132
|
-
[AGENT_TOOL_OPERATION_HEADERS.protocol]: AGENT_TOOL_OPERATION_PROTOCOL,
|
|
133
|
-
[AGENT_TOOL_OPERATION_HEADERS.requestId]: operation.requestId,
|
|
134
|
-
...(operation.settledOnly ? { [AGENT_TOOL_OPERATION_HEADERS.settledOnly]: 'true' } : {}),
|
|
135
|
-
},
|
|
136
|
-
body: serializedBody,
|
|
137
|
-
});
|
|
138
|
-
if (res.headers.get(AGENT_TOOL_OPERATION_HEADERS.protocol) !== AGENT_TOOL_OPERATION_PROTOCOL ||
|
|
139
|
-
res.headers.get(AGENT_TOOL_OPERATION_HEADERS.requestId) !== operation.requestId) {
|
|
140
|
-
if (res.status === 403) {
|
|
141
|
-
const pending = pendingAccountActivationError(403, parseErrorPayload(await res.clone().text().catch(() => '')));
|
|
142
|
-
if (pending) {
|
|
143
|
-
if (operation.createdNew && !operation.settledOnly)
|
|
144
|
-
operation.reject();
|
|
145
|
-
throw pending;
|
|
146
|
-
}
|
|
147
|
-
}
|
|
148
|
-
await res.body?.cancel();
|
|
149
|
-
// Possibly an instance that ignores identities: a rerun may only read the receipt.
|
|
150
|
-
operation.requireReceipt();
|
|
151
|
-
throw new Error('Business did not acknowledge a durable receipt; outcome remains unconfirmed');
|
|
152
|
-
}
|
|
153
|
-
if (!res.ok) {
|
|
154
|
-
const text = await res.text().catch(() => res.statusText);
|
|
155
|
-
const pending = pendingAccountActivationError(res.status, parseErrorPayload(text));
|
|
156
|
-
if (pending)
|
|
157
|
-
throw pending;
|
|
158
|
-
const code = errorCode(text);
|
|
159
|
-
if (res.status === 409 && code === 'business_operation_in_progress')
|
|
160
|
-
throw new ToolRequestError(`API 409: ${text}\nTool request ${operation.requestId} is still running. Rerun the ` +
|
|
161
|
-
'same command later to get its result.');
|
|
162
|
-
if (res.status === 409 && code === 'business_operation_requires_reconciliation')
|
|
163
|
-
throw new ToolRequestError(recoverId !== undefined
|
|
164
|
-
? // A receipt query never runs the request, even for a tool that can be safely redone.
|
|
165
|
-
`API 409: ${text}\nTool request ${operation.requestId} has no settled result yet. ` +
|
|
166
|
-
'Rerun the same command without PLAYCRAFT_TOOL_REQUEST_ID: a tool that can be ' +
|
|
167
|
-
'safely redone continues this request; any other tool then needs reconciliation.'
|
|
168
|
-
: `API 409: ${text}\nTool request ${operation.requestId} needs reconciliation: its ` +
|
|
169
|
-
'outcome is unknown, and rerunning the same command will not run it again. Only ' +
|
|
170
|
-
'after confirming it had no effect, rerun with PLAYCRAFT_TOOL_NEW_REQUEST=1 to ' +
|
|
171
|
-
'start a new operation.');
|
|
172
|
-
if (res.status >= 400 && res.status < 500) {
|
|
173
|
-
// The request itself was refused and not carried out: a rerun is a new operation.
|
|
174
|
-
operation.reject();
|
|
175
|
-
throw new ToolRequestError(`API ${res.status}: ${text}`);
|
|
176
|
-
}
|
|
177
|
-
throw new Error(`API ${res.status}: ${text}`);
|
|
178
|
-
}
|
|
179
|
-
const result = (await res.json());
|
|
180
|
-
operation.complete();
|
|
181
|
-
return result;
|
|
182
|
-
}
|
|
183
|
-
catch (error) {
|
|
184
|
-
if (error instanceof ToolRequestError || error instanceof AccountActivationError)
|
|
185
|
-
throw error;
|
|
186
|
-
throw new Error(`${error instanceof Error ? error.message : String(error)}\n${operation.settledOnly
|
|
187
|
-
? `Tool request ${operation.requestId}; record: ${operation.file}. Its settled result is not available yet.`
|
|
188
|
-
: unknownOutcome}`);
|
|
189
|
-
}
|
|
190
|
-
finally {
|
|
191
|
-
operation.release();
|
|
80
|
+
if (!res.ok) {
|
|
81
|
+
const text = await res.text().catch(() => res.statusText);
|
|
82
|
+
throw new Error(`API ${res.status}: ${text}`);
|
|
192
83
|
}
|
|
84
|
+
return res.json();
|
|
193
85
|
}
|
|
194
|
-
async get(path, params
|
|
86
|
+
async get(path, params) {
|
|
195
87
|
const url = this.toolsRequestUrl(path);
|
|
196
88
|
if (params) {
|
|
197
89
|
for (const [k, v] of Object.entries(params)) {
|
|
@@ -201,62 +93,27 @@ export class AgentApiClient {
|
|
|
201
93
|
}
|
|
202
94
|
const res = await fetch(url, {
|
|
203
95
|
headers: this.authHeaders(),
|
|
204
|
-
redirect: 'error',
|
|
205
|
-
signal: options?.signal ?? AbortSignal.timeout(30_000),
|
|
206
96
|
});
|
|
207
97
|
if (!res.ok) {
|
|
208
98
|
const text = await res.text().catch(() => res.statusText);
|
|
209
|
-
const pending = pendingAccountActivationError(res.status, parseErrorPayload(text));
|
|
210
|
-
if (pending)
|
|
211
|
-
throw pending;
|
|
212
99
|
throw new Error(`API ${res.status}: ${text}`);
|
|
213
100
|
}
|
|
214
101
|
return res.json();
|
|
215
102
|
}
|
|
216
|
-
/** Stream only to the authenticated, same-service video upload endpoint. */
|
|
217
|
-
async putVideoMedia(path, body, headers, signal) {
|
|
218
|
-
if (!/^\/video-media\/[a-f0-9-]{36}\/content\?/.test(path))
|
|
219
|
-
throw new Error('invalid_video_upload_target');
|
|
220
|
-
const url = this.toolsRequestUrl(path);
|
|
221
|
-
const keys = [...url.searchParams.keys()].sort();
|
|
222
|
-
if (keys.join(',') !== 'expires,signature,workspaceId')
|
|
223
|
-
throw new Error('invalid_video_upload_target');
|
|
224
|
-
const allowed = new Set(['content-type', 'content-md5', 'content-length']);
|
|
225
|
-
if (Object.keys(headers).some(key => !allowed.has(key.toLowerCase())))
|
|
226
|
-
throw new Error('invalid_video_upload_headers');
|
|
227
|
-
const response = await fetch(url, {
|
|
228
|
-
method: 'PUT', redirect: 'error', signal,
|
|
229
|
-
headers: { ...headers, ...this.authHeaders() },
|
|
230
|
-
body: body,
|
|
231
|
-
duplex: 'half',
|
|
232
|
-
});
|
|
233
|
-
if (!response.ok) {
|
|
234
|
-
await response.body?.cancel();
|
|
235
|
-
throw new Error(`video_upload_failed:${response.status}`);
|
|
236
|
-
}
|
|
237
|
-
await response.body?.cancel();
|
|
238
|
-
}
|
|
239
103
|
/**
|
|
240
104
|
* 按顺序搜索本地 .playcraft.json 文件(沙箱内或项目目录)。
|
|
241
105
|
* 与全局 login 配置(~/.playcraft/config.json)不同,前者专用于沙箱 token。
|
|
242
106
|
*/
|
|
243
107
|
static loadLocalConfig() {
|
|
244
|
-
const ancestors = [];
|
|
245
|
-
for (let directory = process.cwd();; directory = dirname(directory)) {
|
|
246
|
-
ancestors.push(join(directory, '.playcraft.json'));
|
|
247
|
-
if (dirname(directory) === directory)
|
|
248
|
-
break;
|
|
249
|
-
}
|
|
250
108
|
const searchPaths = [
|
|
251
|
-
process.
|
|
252
|
-
...ancestors,
|
|
109
|
+
join(process.cwd(), '.playcraft.json'),
|
|
253
110
|
'/project/.playcraft.json',
|
|
254
111
|
join(homedir(), '.playcraft.json'),
|
|
255
112
|
];
|
|
256
113
|
for (const p of searchPaths) {
|
|
257
114
|
if (existsSync(p)) {
|
|
258
115
|
try {
|
|
259
|
-
return
|
|
116
|
+
return JSON.parse(readFileSync(p, 'utf-8'));
|
|
260
117
|
}
|
|
261
118
|
catch {
|
|
262
119
|
continue;
|
|
@@ -266,15 +123,3 @@ export class AgentApiClient {
|
|
|
266
123
|
return { apiUrl: '', token: '' };
|
|
267
124
|
}
|
|
268
125
|
}
|
|
269
|
-
/** A failure whose meaning is settled; no recovery hint applies. */
|
|
270
|
-
class ToolRequestError extends Error {
|
|
271
|
-
}
|
|
272
|
-
function errorCode(text) {
|
|
273
|
-
try {
|
|
274
|
-
const message = JSON.parse(text).message;
|
|
275
|
-
return typeof message === 'string' ? message : undefined;
|
|
276
|
-
}
|
|
277
|
-
catch {
|
|
278
|
-
return undefined;
|
|
279
|
-
}
|
|
280
|
-
}
|