playcanvas-agent-bridge-cli 0.2.2 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +93 -7
- package/README.zh-CN.md +89 -6
- package/dist/cli.js +257 -22
- package/dist/config.js +6 -2
- package/dist/daemon/server.js +50 -15
- package/dist/daemon/target-registry.js +19 -1
- package/dist/frontend/server.js +191 -0
- package/dist/frontend/store.js +369 -0
- package/dist/snippets.js +77 -0
- package/extension/isolated.js +126 -30
- package/extension/main.js +257 -29
- package/extension/manifest.json +16 -6
- package/extension/popup.html +42 -1
- package/extension/popup.js +93 -7
- package/package.json +4 -1
- package/skills/claude/playcanvas-agent-bridge-cli/SKILL.md +20 -2
- package/skills/codex/playcanvas-agent-bridge-cli/SKILL.md +40 -5
- package/skills/codex/playcanvas-agent-bridge-cli/agents/openai.yaml +2 -2
- package/skills/cursor/playcanvas-agent-bridge-cli.mdc +18 -5
- package/skills/windsurf/playcanvas-agent-bridge-cli.md +17 -4
package/dist/cli.js
CHANGED
|
@@ -3,11 +3,12 @@ import { spawn } from "node:child_process";
|
|
|
3
3
|
import { realpathSync } from "node:fs";
|
|
4
4
|
import { readFile, writeFile, mkdir } from "node:fs/promises";
|
|
5
5
|
import { homedir } from "node:os";
|
|
6
|
-
import { basename, dirname, extname, join } from "node:path";
|
|
6
|
+
import { basename, dirname, extname, isAbsolute, join, resolve } from "node:path";
|
|
7
7
|
import { fileURLToPath } from "node:url";
|
|
8
|
-
import { CONFIG_DIR, DEFAULT_HOST, DEFAULT_PORT, EXTENSION_INSTALL_DIR, VERSION, copyDir, findPackageRoot, readOrCreateSession, readSessionIfExists, } from "./config.js";
|
|
8
|
+
import { CONFIG_DIR, DEFAULT_FRONTEND_PORT, DEFAULT_HOST, DEFAULT_PORT, EXTENSION_INSTALL_DIR, VERSION, copyDir, findPackageRoot, readOrCreateSession, readSessionIfExists, } from "./config.js";
|
|
9
9
|
import { createDaemonServer } from "./daemon/server.js";
|
|
10
|
-
import {
|
|
10
|
+
import { FrontendError, getFrontendStatus, installFrontend, listFrontends, removeFrontend, useFrontend, } from "./frontend/store.js";
|
|
11
|
+
import { assetDeleteSnippet, assetFolderEnsureSnippet, assetCreateManySnippet, assetGetSnippet, assetInstantiateTemplateSnippet, assetListSnippet, entityAddComponentsSnippet, entityAddComponentSnippet, entityAddScriptSnippet, entityCreateManySnippet, entityCreateSnippet, entityDeleteSnippet, entityDuplicateSnippet, entityGetSnippet, entityListSnippet, entityPatchManySnippet, entityPatchSnippet, entityReparentSnippet, entityRemoveComponentsSnippet, entityRemoveComponentSnippet, entitySetMaterialSnippet, materialCreateSnippet, materialPatchSnippet, sceneSettingsGetSnippet, sceneSettingsPatchSnippet, scriptCreateSnippet, scriptParseSnippet, scriptSetTextSnippet, scriptUpsertSnippet, storeDownloadSnippet, storeGetSnippet, storeSearchSnippet, templateCreateSnippet, } from "./snippets.js";
|
|
11
12
|
import { fail, ok } from "./shared/protocol.js";
|
|
12
13
|
function parseArgs(argv) {
|
|
13
14
|
const parsed = { _: [], flags: {} };
|
|
@@ -210,6 +211,46 @@ function objectJson(value, label) {
|
|
|
210
211
|
}
|
|
211
212
|
return value;
|
|
212
213
|
}
|
|
214
|
+
function uploadSpecFromJson(value, label) {
|
|
215
|
+
const data = objectJson(value, label);
|
|
216
|
+
const file = typeof data.file === "string" ? data.file : "";
|
|
217
|
+
if (!file) {
|
|
218
|
+
throw new Error(`${label}.file is required.`);
|
|
219
|
+
}
|
|
220
|
+
return {
|
|
221
|
+
key: typeof data.key === "string" ? data.key : undefined,
|
|
222
|
+
file,
|
|
223
|
+
name: typeof data.name === "string" ? data.name : undefined,
|
|
224
|
+
filename: typeof data.filename === "string" ? data.filename : undefined,
|
|
225
|
+
type: typeof data.type === "string" ? data.type : undefined,
|
|
226
|
+
mime: typeof data.mime === "string" ? data.mime : undefined,
|
|
227
|
+
folder: typeof data.folder === "string" ? data.folder : undefined,
|
|
228
|
+
folderId: typeof data.folderId === "string" || typeof data.folderId === "number"
|
|
229
|
+
? String(data.folderId)
|
|
230
|
+
: undefined,
|
|
231
|
+
preload: typeof data.preload === "boolean" ? data.preload : undefined,
|
|
232
|
+
};
|
|
233
|
+
}
|
|
234
|
+
function resolveManifestFile(manifestPath, file) {
|
|
235
|
+
return isAbsolute(file) ? file : resolve(dirname(manifestPath), file);
|
|
236
|
+
}
|
|
237
|
+
async function uploadAsset(args, spec) {
|
|
238
|
+
const fileBuffer = await readFile(spec.file);
|
|
239
|
+
const type = spec.type || inferAssetType(spec.file);
|
|
240
|
+
if (!type)
|
|
241
|
+
return fail("INVALID_REQUEST", `asset upload requires --type for ${spec.file}.`);
|
|
242
|
+
const filename = spec.filename || basename(spec.file);
|
|
243
|
+
return rpcCall(args, "bridge:uploadAsset", {
|
|
244
|
+
base64: fileBuffer.toString("base64"),
|
|
245
|
+
mime: spec.mime || inferMime(spec.file),
|
|
246
|
+
name: spec.name || nameFromFile(spec.file),
|
|
247
|
+
filename,
|
|
248
|
+
type,
|
|
249
|
+
folder: spec.folder || null,
|
|
250
|
+
folderId: spec.folderId || null,
|
|
251
|
+
preload: spec.preload !== false,
|
|
252
|
+
}, 120000);
|
|
253
|
+
}
|
|
213
254
|
async function doctor() {
|
|
214
255
|
const session = await readSessionIfExists();
|
|
215
256
|
const checks = [];
|
|
@@ -241,6 +282,19 @@ async function doctor() {
|
|
|
241
282
|
});
|
|
242
283
|
nextActions.push("Run pcbridge daemon start in a terminal.");
|
|
243
284
|
}
|
|
285
|
+
const frontend = await getFrontendStatus();
|
|
286
|
+
checks.push({
|
|
287
|
+
name: "frontend",
|
|
288
|
+
ok: frontend.ready,
|
|
289
|
+
activeRelease: frontend.activeRelease,
|
|
290
|
+
installedCount: frontend.installed.length,
|
|
291
|
+
message: frontend.ready
|
|
292
|
+
? `Frontend ${frontend.activeRelease} is ready.`
|
|
293
|
+
: "No active custom Editor frontend is installed.",
|
|
294
|
+
});
|
|
295
|
+
if (!frontend.ready) {
|
|
296
|
+
nextActions.push("Run pcbridge frontend install latest.");
|
|
297
|
+
}
|
|
244
298
|
const extensionExists = Boolean(session) && (await pathExists(EXTENSION_INSTALL_DIR));
|
|
245
299
|
let generatedExtensionVersion = null;
|
|
246
300
|
if (extensionExists) {
|
|
@@ -283,11 +337,11 @@ async function doctor() {
|
|
|
283
337
|
versions: connectedVersions,
|
|
284
338
|
expectedVersion: VERSION,
|
|
285
339
|
message: mismatched.length
|
|
286
|
-
? "One or more connected
|
|
340
|
+
? "One or more connected PlayCanvas tabs are using an older extension version."
|
|
287
341
|
: "Connected extension versions match the package version.",
|
|
288
342
|
});
|
|
289
343
|
if (mismatched.length) {
|
|
290
|
-
nextActions.push("Reload the unpacked extension and refresh the PlayCanvas Editor tab.");
|
|
344
|
+
nextActions.push("Reload the unpacked extension and refresh the PlayCanvas Editor or Launch tab.");
|
|
291
345
|
}
|
|
292
346
|
}
|
|
293
347
|
}
|
|
@@ -340,6 +394,7 @@ async function daemon(args) {
|
|
|
340
394
|
host: DEFAULT_HOST,
|
|
341
395
|
port: session.port || DEFAULT_PORT,
|
|
342
396
|
extensionPath: EXTENSION_INSTALL_DIR,
|
|
397
|
+
frontend: await server.frontend.status(),
|
|
343
398
|
}));
|
|
344
399
|
}
|
|
345
400
|
else if (subcommand === "status") {
|
|
@@ -356,6 +411,70 @@ async function daemon(args) {
|
|
|
356
411
|
process.exitCode = 1;
|
|
357
412
|
}
|
|
358
413
|
}
|
|
414
|
+
async function handleFrontend(args) {
|
|
415
|
+
const subcommand = args._[1] || "status";
|
|
416
|
+
try {
|
|
417
|
+
if (subcommand === "install" || subcommand === "update") {
|
|
418
|
+
const requestedRelease = subcommand === "update" ? "latest" : args._[2] || "latest";
|
|
419
|
+
const installed = await installFrontend(requestedRelease, {
|
|
420
|
+
activate: !flagBool(args, "no-activate"),
|
|
421
|
+
});
|
|
422
|
+
const status = await getFrontendStatus();
|
|
423
|
+
return ok({
|
|
424
|
+
release: installed.manifest.release,
|
|
425
|
+
editorVersion: installed.manifest.editorVersion,
|
|
426
|
+
sourceCommit: installed.manifest.sourceCommit,
|
|
427
|
+
path: installed.path,
|
|
428
|
+
alreadyInstalled: installed.alreadyInstalled,
|
|
429
|
+
active: status.activeRelease === installed.manifest.release,
|
|
430
|
+
nextActions: [
|
|
431
|
+
"Run pcbridge daemon start if it is not already running.",
|
|
432
|
+
"Use the extension popup on a playcanvas.com Editor tab to select the custom frontend.",
|
|
433
|
+
],
|
|
434
|
+
});
|
|
435
|
+
}
|
|
436
|
+
if (subcommand === "list") {
|
|
437
|
+
return ok(await listFrontends());
|
|
438
|
+
}
|
|
439
|
+
if (subcommand === "status") {
|
|
440
|
+
try {
|
|
441
|
+
return await fetchDaemon("/frontend/status");
|
|
442
|
+
}
|
|
443
|
+
catch {
|
|
444
|
+
return ok({
|
|
445
|
+
...(await getFrontendStatus()),
|
|
446
|
+
server: {
|
|
447
|
+
host: DEFAULT_HOST,
|
|
448
|
+
port: DEFAULT_FRONTEND_PORT,
|
|
449
|
+
listening: false,
|
|
450
|
+
error: "Daemon is not reachable.",
|
|
451
|
+
},
|
|
452
|
+
});
|
|
453
|
+
}
|
|
454
|
+
}
|
|
455
|
+
if (subcommand === "use") {
|
|
456
|
+
const release = args._[2];
|
|
457
|
+
if (!release) {
|
|
458
|
+
return fail("INVALID_REQUEST", "frontend use requires a release name.");
|
|
459
|
+
}
|
|
460
|
+
return ok(await useFrontend(release));
|
|
461
|
+
}
|
|
462
|
+
if (subcommand === "remove") {
|
|
463
|
+
const release = args._[2];
|
|
464
|
+
if (!release) {
|
|
465
|
+
return fail("INVALID_REQUEST", "frontend remove requires a release name.");
|
|
466
|
+
}
|
|
467
|
+
return ok(await removeFrontend(release));
|
|
468
|
+
}
|
|
469
|
+
return fail("UNKNOWN_COMMAND", `Unknown frontend command: ${subcommand}`);
|
|
470
|
+
}
|
|
471
|
+
catch (error) {
|
|
472
|
+
if (error instanceof FrontendError) {
|
|
473
|
+
return fail(error.code, error.message);
|
|
474
|
+
}
|
|
475
|
+
throw error;
|
|
476
|
+
}
|
|
477
|
+
}
|
|
359
478
|
async function installExtension(args) {
|
|
360
479
|
const session = await readOrCreateSession();
|
|
361
480
|
const root = await findPackageRoot();
|
|
@@ -379,7 +498,7 @@ async function installExtension(args) {
|
|
|
379
498
|
"Enable Developer Mode in Chrome.",
|
|
380
499
|
"Click Load unpacked.",
|
|
381
500
|
`Select ${EXTENSION_INSTALL_DIR}.`,
|
|
382
|
-
"Open or refresh a PlayCanvas Editor tab, then run pcbridge daemon start.",
|
|
501
|
+
"Open or refresh a PlayCanvas Editor or Launch tab, then run pcbridge daemon start.",
|
|
383
502
|
],
|
|
384
503
|
});
|
|
385
504
|
}
|
|
@@ -652,21 +771,63 @@ async function handleAsset(args) {
|
|
|
652
771
|
const file = flagString(args, "file");
|
|
653
772
|
if (!file)
|
|
654
773
|
return fail("INVALID_REQUEST", "asset upload requires --file.");
|
|
655
|
-
|
|
656
|
-
|
|
657
|
-
|
|
658
|
-
|
|
659
|
-
|
|
660
|
-
|
|
661
|
-
|
|
662
|
-
|
|
663
|
-
name: flagString(args, "name") || nameFromFile(file),
|
|
664
|
-
filename,
|
|
665
|
-
type,
|
|
666
|
-
folder: flagString(args, "folder") || null,
|
|
667
|
-
folderId: flagString(args, "folder-id") || null,
|
|
774
|
+
return uploadAsset(args, {
|
|
775
|
+
file,
|
|
776
|
+
type: flagString(args, "type"),
|
|
777
|
+
mime: flagString(args, "mime"),
|
|
778
|
+
name: flagString(args, "name"),
|
|
779
|
+
filename: flagString(args, "filename"),
|
|
780
|
+
folder: flagString(args, "folder"),
|
|
781
|
+
folderId: flagString(args, "folder-id"),
|
|
668
782
|
preload: !flagBool(args, "no-preload"),
|
|
669
|
-
}
|
|
783
|
+
});
|
|
784
|
+
}
|
|
785
|
+
if (subcommand === "upload-many") {
|
|
786
|
+
const manifestPath = flagString(args, "json");
|
|
787
|
+
if (!manifestPath)
|
|
788
|
+
return fail("INVALID_REQUEST", "asset upload-many requires --json <file>.");
|
|
789
|
+
const manifest = JSON.parse(await readFile(manifestPath, "utf8"));
|
|
790
|
+
const rawItems = Array.isArray(manifest)
|
|
791
|
+
? manifest
|
|
792
|
+
: objectJson(manifest, "asset upload-many manifest").assets;
|
|
793
|
+
const items = Array.isArray(rawItems) ? rawItems : [];
|
|
794
|
+
if (!items.length) {
|
|
795
|
+
return fail("INVALID_REQUEST", "asset upload-many manifest must contain a non-empty assets array.");
|
|
796
|
+
}
|
|
797
|
+
const uploads = [];
|
|
798
|
+
const errors = [];
|
|
799
|
+
for (let index = 0; index < items.length; index += 1) {
|
|
800
|
+
const spec = uploadSpecFromJson(items[index], `assets[${index}]`);
|
|
801
|
+
spec.file = resolveManifestFile(manifestPath, spec.file);
|
|
802
|
+
const result = await uploadAsset(args, spec);
|
|
803
|
+
uploads.push({
|
|
804
|
+
index,
|
|
805
|
+
key: spec.key || null,
|
|
806
|
+
file: spec.file,
|
|
807
|
+
name: spec.name || nameFromFile(spec.file),
|
|
808
|
+
result: result,
|
|
809
|
+
});
|
|
810
|
+
if (!result.ok) {
|
|
811
|
+
errors.push({
|
|
812
|
+
index,
|
|
813
|
+
file: spec.file,
|
|
814
|
+
error: result.error,
|
|
815
|
+
});
|
|
816
|
+
}
|
|
817
|
+
}
|
|
818
|
+
if (errors.length) {
|
|
819
|
+
return fail("UPLOAD_MANY_FAILED", `${errors.length} of ${items.length} uploads failed.`, {
|
|
820
|
+
affected: items.length - errors.length,
|
|
821
|
+
failed: errors.length,
|
|
822
|
+
}, { uploads, errors });
|
|
823
|
+
}
|
|
824
|
+
return ok({
|
|
825
|
+
affected: uploads.length,
|
|
826
|
+
uploads,
|
|
827
|
+
}, {
|
|
828
|
+
affected: uploads.length,
|
|
829
|
+
failed: 0,
|
|
830
|
+
});
|
|
670
831
|
}
|
|
671
832
|
if (subcommand === "delete") {
|
|
672
833
|
const ids = flagList(args, "id");
|
|
@@ -749,6 +910,21 @@ async function handleTemplate(args) {
|
|
|
749
910
|
}
|
|
750
911
|
async function handleScript(args) {
|
|
751
912
|
const subcommand = args._[1];
|
|
913
|
+
if (subcommand === "upsert") {
|
|
914
|
+
const filename = flagString(args, "filename") || (flagString(args, "file") ? basename(flagString(args, "file") || "") : undefined);
|
|
915
|
+
const file = flagString(args, "file");
|
|
916
|
+
if (!filename || !file) {
|
|
917
|
+
return fail("INVALID_REQUEST", "script upsert requires --filename and --file.");
|
|
918
|
+
}
|
|
919
|
+
return rpcEval(args, scriptUpsertSnippet(), {
|
|
920
|
+
filename,
|
|
921
|
+
text: await readFile(file, "utf8"),
|
|
922
|
+
folder: flagString(args, "folder") || null,
|
|
923
|
+
folderId: flagString(args, "folder-id") || null,
|
|
924
|
+
preload: !flagBool(args, "no-preload"),
|
|
925
|
+
parse: flagBool(args, "parse"),
|
|
926
|
+
}, 60000);
|
|
927
|
+
}
|
|
752
928
|
if (subcommand === "create") {
|
|
753
929
|
const filename = flagString(args, "filename") || (flagString(args, "file") ? basename(flagString(args, "file") || "") : undefined);
|
|
754
930
|
const file = flagString(args, "file");
|
|
@@ -873,10 +1049,26 @@ async function handleViewport(args) {
|
|
|
873
1049
|
}
|
|
874
1050
|
return raw;
|
|
875
1051
|
}
|
|
1052
|
+
async function handleLogs(args) {
|
|
1053
|
+
const subcommand = args._[1] || "get";
|
|
1054
|
+
if (subcommand === "get" || subcommand === "list") {
|
|
1055
|
+
return listEnvelope(await rpcCall(args, "bridge:getLogs", {
|
|
1056
|
+
level: flagString(args, "level") || null,
|
|
1057
|
+
limit: Number(flagString(args, "limit", "100")),
|
|
1058
|
+
offset: flagString(args, "offset") === undefined ? null : Number(flagString(args, "offset")),
|
|
1059
|
+
since: flagString(args, "since") || null,
|
|
1060
|
+
}));
|
|
1061
|
+
}
|
|
1062
|
+
if (subcommand === "clear") {
|
|
1063
|
+
return rpcCall(args, "bridge:clearLogs");
|
|
1064
|
+
}
|
|
1065
|
+
return fail("UNKNOWN_COMMAND", `Unknown logs command: ${subcommand}`);
|
|
1066
|
+
}
|
|
876
1067
|
function help(group = "overview") {
|
|
877
1068
|
const groups = {
|
|
878
1069
|
overview: [
|
|
879
1070
|
"pcbridge help core",
|
|
1071
|
+
"pcbridge help frontend",
|
|
880
1072
|
"pcbridge help entity",
|
|
881
1073
|
"pcbridge help asset",
|
|
882
1074
|
"pcbridge help material",
|
|
@@ -885,6 +1077,8 @@ function help(group = "overview") {
|
|
|
885
1077
|
"pcbridge help scene",
|
|
886
1078
|
"pcbridge help store",
|
|
887
1079
|
"pcbridge help viewport",
|
|
1080
|
+
"pcbridge help launch",
|
|
1081
|
+
"pcbridge help logs",
|
|
888
1082
|
"pcbridge help eval",
|
|
889
1083
|
],
|
|
890
1084
|
core: [
|
|
@@ -896,6 +1090,15 @@ function help(group = "overview") {
|
|
|
896
1090
|
"pcbridge targets",
|
|
897
1091
|
"pcbridge version",
|
|
898
1092
|
],
|
|
1093
|
+
frontend: [
|
|
1094
|
+
"pcbridge frontend install [latest|playcanvas-editor-v<version>-r<revision>] [--no-activate]",
|
|
1095
|
+
"pcbridge frontend update",
|
|
1096
|
+
"pcbridge frontend status",
|
|
1097
|
+
"pcbridge frontend list",
|
|
1098
|
+
"pcbridge frontend use playcanvas-editor-v<version>-r<revision>",
|
|
1099
|
+
"pcbridge frontend remove playcanvas-editor-v<version>-r<revision>",
|
|
1100
|
+
"The active frontend is served from http://localhost:3487 while the daemon is running.",
|
|
1101
|
+
],
|
|
899
1102
|
entity: [
|
|
900
1103
|
"pcbridge entity list --target current --limit 50 [--name Player] [--component render] [--tag enemy] [--full]",
|
|
901
1104
|
"pcbridge entity get --target current --id <resource_id> [--full]",
|
|
@@ -918,6 +1121,7 @@ function help(group = "overview") {
|
|
|
918
1121
|
"pcbridge asset create --target current --json ./assets.json",
|
|
919
1122
|
"pcbridge asset folder ensure --target current --path \"AI Agent Bridge/Task/Textures\"",
|
|
920
1123
|
"pcbridge asset upload --target current --file ./texture.png --folder \"AI Agent Bridge/Task/Textures\"",
|
|
1124
|
+
"pcbridge asset upload-many --target current --json ./upload-manifest.json",
|
|
921
1125
|
"pcbridge asset instantiate --target current --id <template_asset_id>",
|
|
922
1126
|
"pcbridge asset delete --target current --id <asset_id>",
|
|
923
1127
|
],
|
|
@@ -932,6 +1136,7 @@ function help(group = "overview") {
|
|
|
932
1136
|
"pcbridge template instantiate --target current --id <template_asset_id>",
|
|
933
1137
|
],
|
|
934
1138
|
script: [
|
|
1139
|
+
"pcbridge script upsert --target current --filename controller.js --file ./controller.js --folder \"AI Agent Bridge/Task/Scripts\" [--parse]",
|
|
935
1140
|
"pcbridge script create --target current --filename controller.js --file ./controller.js",
|
|
936
1141
|
"pcbridge script set-text --target current --asset-id <asset_id> --file ./controller.js",
|
|
937
1142
|
"pcbridge script parse --target current --asset-id <asset_id>",
|
|
@@ -948,12 +1153,35 @@ function help(group = "overview") {
|
|
|
948
1153
|
],
|
|
949
1154
|
viewport: [
|
|
950
1155
|
"pcbridge viewport capture --target current --out ./tmp/viewport.png [--format png|webp]",
|
|
1156
|
+
"pcbridge viewport capture --target launch:<sceneId> --out ./tmp/launch.png [--format png|webp]",
|
|
951
1157
|
"pcbridge viewport focus --target current --id <resource_id> [--view perspective|top|bottom|front|back|left|right]",
|
|
952
1158
|
],
|
|
1159
|
+
launch: [
|
|
1160
|
+
"pcbridge targets",
|
|
1161
|
+
"pcbridge eval --target launch:<sceneId> --code \"return { href: location.href, hasPc: !!pc, canvasCount: document.querySelectorAll('canvas').length }\"",
|
|
1162
|
+
"pcbridge viewport capture --target launch:<sceneId> --out ./tmp/launch.png [--format png|webp]",
|
|
1163
|
+
"pcbridge logs get --target launch:<sceneId> [--limit 100] [--level error|warn|info|debug] [--since <seq>]",
|
|
1164
|
+
"pcbridge logs clear --target launch:<sceneId>",
|
|
1165
|
+
"Use --target tab:<id> when multiple Launch tabs are open for the same scene.",
|
|
1166
|
+
],
|
|
1167
|
+
logs: [
|
|
1168
|
+
"pcbridge logs get --target current [--limit 100] [--level error|warn|info|debug] [--since <seq>]",
|
|
1169
|
+
"pcbridge logs get --target launch:<sceneId> [--limit 100] [--level error|warn|info|debug] [--since <seq>]",
|
|
1170
|
+
"pcbridge logs clear --target current",
|
|
1171
|
+
"pcbridge logs clear --target launch:<sceneId>",
|
|
1172
|
+
],
|
|
1173
|
+
log: [
|
|
1174
|
+
"pcbridge logs get --target current [--limit 100] [--level error|warn|info|debug] [--since <seq>]",
|
|
1175
|
+
"pcbridge logs get --target launch:<sceneId> [--limit 100] [--level error|warn|info|debug] [--since <seq>]",
|
|
1176
|
+
"pcbridge logs clear --target current",
|
|
1177
|
+
"pcbridge logs clear --target launch:<sceneId>",
|
|
1178
|
+
],
|
|
953
1179
|
eval: [
|
|
954
|
-
"Use eval for custom Editor/Engine workflows, large multi-step scene edits, exploratory API inspection, and operations not yet structured.",
|
|
1180
|
+
"Use eval for custom Editor/Engine workflows, PlayCanvas Launch debugging, large multi-step scene edits, exploratory API inspection, and operations not yet structured.",
|
|
955
1181
|
"pcbridge eval --target current --code \"return { href: location.href, hasEditor: !!editor }\"",
|
|
1182
|
+
"pcbridge eval --target launch:<sceneId> --code \"return { href: location.href, hasPc: !!pc, canvasCount: document.querySelectorAll('canvas').length }\"",
|
|
956
1183
|
"pcbridge eval --target current --file ./task.js",
|
|
1184
|
+
"pcbridge eval --target current --file ./task.js --args-json ./task-args.json",
|
|
957
1185
|
"pcbridge eval --target current --stdin",
|
|
958
1186
|
],
|
|
959
1187
|
};
|
|
@@ -992,11 +1220,15 @@ async function main() {
|
|
|
992
1220
|
else if (command === "install-skill") {
|
|
993
1221
|
print(await installSkill(args));
|
|
994
1222
|
}
|
|
1223
|
+
else if (command === "frontend") {
|
|
1224
|
+
print(await handleFrontend(args));
|
|
1225
|
+
}
|
|
995
1226
|
else if (command === "targets") {
|
|
996
1227
|
print(await fetchDaemon("/targets"));
|
|
997
1228
|
}
|
|
998
1229
|
else if (command === "eval") {
|
|
999
|
-
|
|
1230
|
+
const commandArgs = await readJsonFlag(args, "args-json");
|
|
1231
|
+
print(await rpcEval(args, await readCode(args), objectJson(commandArgs, "eval args")));
|
|
1000
1232
|
}
|
|
1001
1233
|
else if (command === "entity") {
|
|
1002
1234
|
print(await handleEntity(args));
|
|
@@ -1022,6 +1254,9 @@ async function main() {
|
|
|
1022
1254
|
else if (command === "viewport") {
|
|
1023
1255
|
print(await handleViewport(args));
|
|
1024
1256
|
}
|
|
1257
|
+
else if (command === "logs" || command === "log") {
|
|
1258
|
+
print(await handleLogs(args));
|
|
1259
|
+
}
|
|
1025
1260
|
else if (command === "version" || command === "--version" || command === "-v") {
|
|
1026
1261
|
print(ok({ version: VERSION }));
|
|
1027
1262
|
}
|
package/dist/config.js
CHANGED
|
@@ -4,10 +4,14 @@ import { existsSync } from "node:fs";
|
|
|
4
4
|
import { homedir } from "node:os";
|
|
5
5
|
import { dirname, join, resolve } from "node:path";
|
|
6
6
|
import { fileURLToPath } from "node:url";
|
|
7
|
-
export const VERSION = "0.
|
|
7
|
+
export const VERSION = "0.3.0";
|
|
8
8
|
export const DEFAULT_HOST = "127.0.0.1";
|
|
9
9
|
export const DEFAULT_PORT = 17329;
|
|
10
|
-
export const
|
|
10
|
+
export const DEFAULT_FRONTEND_PORT = 3487;
|
|
11
|
+
export const DEFAULT_FRONTEND_REPOSITORY = "Q-My99/playcanvas-editor";
|
|
12
|
+
export const CONFIG_DIR = process.env.PCBRIDGE_CONFIG_DIR
|
|
13
|
+
? resolve(process.env.PCBRIDGE_CONFIG_DIR)
|
|
14
|
+
: join(homedir(), ".pcbridge");
|
|
11
15
|
export const SESSION_FILE = join(CONFIG_DIR, "session.json");
|
|
12
16
|
export const EXTENSION_INSTALL_DIR = join(CONFIG_DIR, "extension");
|
|
13
17
|
export async function readOrCreateSession() {
|
package/dist/daemon/server.js
CHANGED
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
import http from "node:http";
|
|
2
2
|
import { randomUUID } from "node:crypto";
|
|
3
3
|
import { WebSocketServer } from "ws";
|
|
4
|
-
import { DEFAULT_HOST, DEFAULT_PORT, VERSION } from "../config.js";
|
|
4
|
+
import { CONFIG_DIR, DEFAULT_FRONTEND_PORT, DEFAULT_HOST, DEFAULT_PORT, VERSION, } from "../config.js";
|
|
5
|
+
import { createFrontendServer, } from "../frontend/server.js";
|
|
5
6
|
import { TargetRegistry } from "./target-registry.js";
|
|
6
7
|
import { fail, normalizeError, ok, } from "../shared/protocol.js";
|
|
7
8
|
function readBody(req) {
|
|
@@ -38,10 +39,17 @@ function isJsonObject(value) {
|
|
|
38
39
|
}
|
|
39
40
|
export function createDaemonServer(options) {
|
|
40
41
|
const host = options.host || DEFAULT_HOST;
|
|
41
|
-
const port = Number(options.port
|
|
42
|
+
const port = Number(options.port ?? DEFAULT_PORT);
|
|
43
|
+
let actualPort = port;
|
|
42
44
|
const registry = new TargetRegistry();
|
|
43
45
|
const pending = new Map();
|
|
44
46
|
const log = options.log || (() => undefined);
|
|
47
|
+
const frontend = createFrontendServer({
|
|
48
|
+
host,
|
|
49
|
+
port: options.frontendPort ?? DEFAULT_FRONTEND_PORT,
|
|
50
|
+
rootDir: options.frontendRootDir || CONFIG_DIR,
|
|
51
|
+
log,
|
|
52
|
+
});
|
|
45
53
|
function requireToken(req) {
|
|
46
54
|
return req.headers["x-pcbridge-token"] === options.token;
|
|
47
55
|
}
|
|
@@ -94,14 +102,24 @@ export function createDaemonServer(options) {
|
|
|
94
102
|
writeJson(res, 403, fail("BAD_TOKEN", "Invalid pcbridge token."));
|
|
95
103
|
return;
|
|
96
104
|
}
|
|
105
|
+
const frontendStatus = await frontend.status();
|
|
97
106
|
writeJson(res, 200, ok({
|
|
98
107
|
version: VERSION,
|
|
99
108
|
host,
|
|
100
|
-
port,
|
|
109
|
+
port: actualPort,
|
|
101
110
|
targetCount: registry.list().filter((target) => target.connected).length,
|
|
111
|
+
frontend: frontendStatus,
|
|
102
112
|
}));
|
|
103
113
|
return;
|
|
104
114
|
}
|
|
115
|
+
if (url.pathname === "/frontend/status" && req.method === "GET") {
|
|
116
|
+
if (!requireToken(req)) {
|
|
117
|
+
writeJson(res, 403, fail("BAD_TOKEN", "Invalid pcbridge token."));
|
|
118
|
+
return;
|
|
119
|
+
}
|
|
120
|
+
writeJson(res, 200, ok(await frontend.status()));
|
|
121
|
+
return;
|
|
122
|
+
}
|
|
105
123
|
if (url.pathname === "/targets" && req.method === "GET") {
|
|
106
124
|
if (!requireToken(req)) {
|
|
107
125
|
writeJson(res, 403, fail("BAD_TOKEN", "Invalid pcbridge token."));
|
|
@@ -149,7 +167,7 @@ export function createDaemonServer(options) {
|
|
|
149
167
|
const message = JSON.parse(raw.toString());
|
|
150
168
|
if (message.type === "target:update" && message.target?.clientId) {
|
|
151
169
|
const info = registry.upsert(message.target, ws);
|
|
152
|
-
log(`target ${info.id} ready=${info.ready} url=${info.url}`);
|
|
170
|
+
log(`target ${info.id} kind=${info.kind || "unknown"} ready=${info.ready} url=${info.url}`);
|
|
153
171
|
return;
|
|
154
172
|
}
|
|
155
173
|
if (message.type === "response" && message.id) {
|
|
@@ -187,18 +205,35 @@ export function createDaemonServer(options) {
|
|
|
187
205
|
});
|
|
188
206
|
return {
|
|
189
207
|
host,
|
|
190
|
-
port
|
|
208
|
+
get port() {
|
|
209
|
+
return actualPort;
|
|
210
|
+
},
|
|
191
211
|
registry,
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
server.
|
|
196
|
-
|
|
212
|
+
frontend,
|
|
213
|
+
listen: async () => {
|
|
214
|
+
await new Promise((resolveListen, reject) => {
|
|
215
|
+
server.once("error", reject);
|
|
216
|
+
server.listen(port, host, () => {
|
|
217
|
+
server.off("error", reject);
|
|
218
|
+
const address = server.address();
|
|
219
|
+
if (address && typeof address !== "string")
|
|
220
|
+
actualPort = address.port;
|
|
221
|
+
resolveListen();
|
|
222
|
+
});
|
|
223
|
+
});
|
|
224
|
+
try {
|
|
225
|
+
await frontend.listen();
|
|
226
|
+
}
|
|
227
|
+
catch (error) {
|
|
228
|
+
log(`frontend server unavailable: ${String(error)}`);
|
|
229
|
+
}
|
|
230
|
+
},
|
|
231
|
+
close: async () => {
|
|
232
|
+
await frontend.close();
|
|
233
|
+
await new Promise((resolveClose) => {
|
|
234
|
+
wss.close();
|
|
235
|
+
server.close(() => resolveClose());
|
|
197
236
|
});
|
|
198
|
-
}
|
|
199
|
-
close: () => new Promise((resolve) => {
|
|
200
|
-
wss.close();
|
|
201
|
-
server.close(() => resolve());
|
|
202
|
-
}),
|
|
237
|
+
},
|
|
203
238
|
};
|
|
204
239
|
}
|
|
@@ -10,12 +10,17 @@ export class TargetRegistry {
|
|
|
10
10
|
clientId: info.clientId,
|
|
11
11
|
tabId: info.tabId,
|
|
12
12
|
windowId: info.windowId,
|
|
13
|
+
kind: info.kind || existing?.kind || "unknown",
|
|
13
14
|
url: info.url || existing?.url || "",
|
|
14
15
|
title: info.title || existing?.title,
|
|
15
16
|
projectId: info.projectId || existing?.projectId,
|
|
16
17
|
sceneId: info.sceneId || existing?.sceneId,
|
|
17
18
|
branchId: info.branchId || existing?.branchId,
|
|
18
19
|
extensionVersion: info.extensionVersion || existing?.extensionVersion,
|
|
20
|
+
hasEditor: info.hasEditor ?? existing?.hasEditor,
|
|
21
|
+
hasPc: info.hasPc ?? existing?.hasPc,
|
|
22
|
+
hasRuntimeApp: info.hasRuntimeApp ?? existing?.hasRuntimeApp,
|
|
23
|
+
canvasCount: info.canvasCount ?? existing?.canvasCount,
|
|
19
24
|
ready: Boolean(info.ready),
|
|
20
25
|
connected: true,
|
|
21
26
|
lastSeen: now,
|
|
@@ -48,7 +53,7 @@ export class TargetRegistry {
|
|
|
48
53
|
return {
|
|
49
54
|
ok: false,
|
|
50
55
|
code: "NO_READY_TARGET",
|
|
51
|
-
message: "No ready PlayCanvas
|
|
56
|
+
message: "No ready PlayCanvas target is connected.",
|
|
52
57
|
candidates: this.list(),
|
|
53
58
|
};
|
|
54
59
|
}
|
|
@@ -93,6 +98,19 @@ export class TargetRegistry {
|
|
|
93
98
|
};
|
|
94
99
|
}
|
|
95
100
|
}
|
|
101
|
+
if ((kind === "editor" || kind === "launch") && value) {
|
|
102
|
+
const matches = targets.filter((target) => target.info.kind === kind && target.info.sceneId === value);
|
|
103
|
+
if (matches.length === 1)
|
|
104
|
+
return { ok: true, target: matches[0] };
|
|
105
|
+
if (matches.length > 1) {
|
|
106
|
+
return {
|
|
107
|
+
ok: false,
|
|
108
|
+
code: "AMBIGUOUS_TARGET",
|
|
109
|
+
message: `${selector} matches multiple connected targets.`,
|
|
110
|
+
candidates: matches.map((target) => target.info),
|
|
111
|
+
};
|
|
112
|
+
}
|
|
113
|
+
}
|
|
96
114
|
return {
|
|
97
115
|
ok: false,
|
|
98
116
|
code: "TARGET_NOT_FOUND",
|