@iwsdk/cli 1.1.0-rc.1 → 1.1.0-rc.2
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 +18 -0
- package/dist/browser-lease.d.ts.map +1 -1
- package/dist/cli.js +669 -127
- package/dist/cli.js.map +1 -1
- package/dist/commands/runtime.d.ts.map +1 -1
- package/dist/contract.js +596 -118
- package/dist/contract.js.map +1 -1
- package/dist/help.d.ts.map +1 -1
- package/dist/index.js +669 -127
- package/dist/index.js.map +1 -1
- package/dist/runtime-contract.d.ts +22 -1
- package/dist/runtime-contract.d.ts.map +1 -1
- package/dist/runtime-state.d.ts +8 -0
- package/dist/runtime-state.d.ts.map +1 -1
- package/dist/runtime-transport.d.ts.map +1 -1
- package/dist/version.d.ts +1 -1
- package/guidance/AGENTS.md +25 -12
- package/package.json +1 -1
|
@@ -9,7 +9,15 @@ export declare const DEFAULT_RUNTIME_COMMAND_TIMEOUT_MS = 30000;
|
|
|
9
9
|
export declare const UI_RENDER_PREVIEW_TIMEOUT_MS = 60000;
|
|
10
10
|
export declare const ASSET_RENDER_PREVIEW_TIMEOUT_MS = 120000;
|
|
11
11
|
export declare const BROWSER_RUNTIME_COMMAND_TIMEOUT_MS = 60000;
|
|
12
|
-
|
|
12
|
+
/**
|
|
13
|
+
* IWER resolves a running hand sequence at most 28 s after dispatch, with a
|
|
14
|
+
* partial result when it runs out of time. The default budget, less the
|
|
15
|
+
* relay's margin, would give up first.
|
|
16
|
+
*/
|
|
17
|
+
export declare const HAND_SEQUENCE_COMMAND_TIMEOUT_MS = 40000;
|
|
18
|
+
/** The longest `duration` (seconds) that extends a default command timeout. */
|
|
19
|
+
export declare const MAX_TIMED_COMMAND_DURATION_S = 3600;
|
|
20
|
+
export declare function getDefaultRuntimeCommandTimeoutMs(method: string, params?: unknown): number;
|
|
13
21
|
export type JsonSchema = {
|
|
14
22
|
type?: string;
|
|
15
23
|
description?: string;
|
|
@@ -69,6 +77,7 @@ export declare const IWSDK_RUNTIME_STATE_DIR = ".iwsdk/runtime";
|
|
|
69
77
|
export declare const IWSDK_RUNTIME_LOGS_DIR = ".iwsdk/runtime/logs";
|
|
70
78
|
export declare const IWSDK_RUNTIME_SESSION_PATH = ".iwsdk/runtime/session.json";
|
|
71
79
|
export declare const IWSDK_RUNTIME_LAUNCH_PATH = ".iwsdk/runtime/launch.json";
|
|
80
|
+
export declare const IWSDK_RUNTIME_COMMAND_CREDENTIAL_PATH = ".iwsdk/runtime/command-credential.json";
|
|
72
81
|
export declare const IWSDK_RUNTIME_STATE_SCHEMA_VERSION = 2;
|
|
73
82
|
export declare const IWSDK_RUNTIME_BROWSER_READY_SCHEMA_VERSION = 2;
|
|
74
83
|
export declare const INTERNAL_BROWSER_PROBE_METHOD = "__iwsdk_browser_probe";
|
|
@@ -130,6 +139,8 @@ export interface RuntimeBrowserState {
|
|
|
130
139
|
lastBridgeConnectedAt?: string;
|
|
131
140
|
lastCommandReadyAt?: string;
|
|
132
141
|
lastError?: RuntimeIssueInfo;
|
|
142
|
+
/** Dev-session tab mute state; it survives reloads and browser relaunches. */
|
|
143
|
+
audioMuted?: boolean;
|
|
133
144
|
}
|
|
134
145
|
export interface RuntimeBrowserProbeResult {
|
|
135
146
|
bridgeConnected: boolean;
|
|
@@ -158,6 +169,15 @@ export interface RuntimeSession {
|
|
|
158
169
|
registeredAt: string;
|
|
159
170
|
updatedAt: string;
|
|
160
171
|
}
|
|
172
|
+
/**
|
|
173
|
+
* Authorizes runtime commands on `/__iwer_mcp` for one dev-server session. It
|
|
174
|
+
* is kept out of session.json, so status output never carries it.
|
|
175
|
+
*/
|
|
176
|
+
export interface RuntimeCommandCredential {
|
|
177
|
+
schemaVersion: number;
|
|
178
|
+
sessionId: string;
|
|
179
|
+
commandToken: string;
|
|
180
|
+
}
|
|
161
181
|
export interface LaunchMetadata {
|
|
162
182
|
schemaVersion: number;
|
|
163
183
|
/** Unique owner token for compare-and-clear startup coordination. */
|
|
@@ -194,6 +214,7 @@ export declare function hasRuntimeBrowserCommandReadyContract(session: RuntimeBr
|
|
|
194
214
|
export declare function isRuntimeBrowserCommandReady(session: RuntimeBrowserStatusSession | null | undefined): boolean;
|
|
195
215
|
export declare const SUPPORTED_AI_TOOLS: AiTool[];
|
|
196
216
|
export declare const MCP_CONFIG_TARGETS: Record<AiTool, McpConfigTarget>;
|
|
217
|
+
export declare const XR_HAND_POSE_GLOSS: Readonly<Record<string, string>>;
|
|
197
218
|
export declare const SCENE_MCP_TOOL_NAMES: readonly ["scene_open", "scene_render_file", "scene_flatten_file", "scene_get_state", "scene_get_capabilities", "scene_screenshot", "scene_select", "scene_set_camera", "scene_set_preview_visibility", "scene_measure_image_regions"];
|
|
198
219
|
export declare const APP_RUNTIME_SCENE_MCP_TOOL_NAMES: readonly ["scene_get_render_stats", "scene_get_runtime_hierarchy", "scene_get_object_transform"];
|
|
199
220
|
export declare const RUNTIME_MCP_TOOLS: McpToolDefinition[];
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"runtime-contract.d.ts","sourceRoot":"","sources":["../src/runtime-contract.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AAE5E,eAAO,MAAM,kCAAkC,QAAS,CAAC;AACzD,eAAO,MAAM,4BAA4B,QAAS,CAAC;AACnD,eAAO,MAAM,+BAA+B,SAAU,CAAC;AACvD,eAAO,MAAM,kCAAkC,QAAS,CAAC;
|
|
1
|
+
{"version":3,"file":"runtime-contract.d.ts","sourceRoot":"","sources":["../src/runtime-contract.ts"],"names":[],"mappings":"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"}
|
package/dist/runtime-state.d.ts
CHANGED
|
@@ -28,6 +28,14 @@ export interface ResolveWorkspaceRootOptions {
|
|
|
28
28
|
}
|
|
29
29
|
export declare function getRuntimeSessionFilePath(workspaceRoot: string): string;
|
|
30
30
|
export declare function getRuntimeLaunchFilePath(workspaceRoot: string): string;
|
|
31
|
+
export declare function getRuntimeCommandCredentialFilePath(workspaceRoot: string): string;
|
|
32
|
+
/**
|
|
33
|
+
* Reads the command credential the dev server wrote for this session. A
|
|
34
|
+
* credential left by another session is never sent. Without one (an older dev
|
|
35
|
+
* server writes none), commands go out without a credential. The read is
|
|
36
|
+
* synchronous so a command starts connecting without an extra turn.
|
|
37
|
+
*/
|
|
38
|
+
export declare function getRuntimeCommandToken(session: Pick<RuntimeSession, 'sessionId' | 'workspaceRoot'>): string | undefined;
|
|
31
39
|
export declare function getRuntimeLogsDir(workspaceRoot: string): string;
|
|
32
40
|
export declare function ensureRuntimeLogsDir(workspaceRoot: string): Promise<string>;
|
|
33
41
|
export declare const isProcessAlive: typeof isRuntimeProcessAlive;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"runtime-state.d.ts","sourceRoot":"","sources":["../src/runtime-state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,
|
|
1
|
+
{"version":3,"file":"runtime-state.d.ts","sourceRoot":"","sources":["../src/runtime-state.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"runtime-transport.d.ts","sourceRoot":"","sources":["../src/runtime-transport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;
|
|
1
|
+
{"version":3,"file":"runtime-transport.d.ts","sourceRoot":"","sources":["../src/runtime-transport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAM/B,KAAK,mBAAmB,GAAG;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAGF,MAAM,WAAW,sBAAsB;IACrC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,mBAAmB,CAAC;CAC7B;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;CACxC;AAMD,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAGhC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,UAAU,CAAC,EAAE,iBAAiB,CAAC;QAC/B,OAAO,CAAC,EAAE,mBAAmB,CAAC;QAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC9B;CAQT;AAirBD,wBAAsB,kBAAkB,CAAC,EACvC,IAAI,EACJ,MAAM,EACN,MAAM,EACN,MAAM,EACN,SAA6D,EAC7D,cAAc,GACf,EAAE,yBAAyB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAuB7D"}
|
package/dist/version.d.ts
CHANGED
package/guidance/AGENTS.md
CHANGED
|
@@ -70,17 +70,18 @@ and subtle breakage. Exception: `import type { GLTF } from 'three/addons/...'`.
|
|
|
70
70
|
|
|
71
71
|
## Traps that produce silent failures
|
|
72
72
|
|
|
73
|
-
| Trap
|
|
74
|
-
|
|
|
75
|
-
| `locomotion: true` with no `LocomotionEnvironment` on a floor
|
|
76
|
-
| Scene origin left occupied
|
|
77
|
-
| Scene JSON with `imports`
|
|
78
|
-
| `entity.destroy()`
|
|
79
|
-
| `setValue` on a Vec2/Vec3/Vec4/Color field
|
|
80
|
-
| Environment component on a non-root entity
|
|
81
|
-
|
|
|
82
|
-
| `
|
|
83
|
-
|
|
|
73
|
+
| Trap | Symptom | Fix |
|
|
74
|
+
| -------------------------------------------------------------- | ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------- |
|
|
75
|
+
| `locomotion: true` with no `LocomotionEnvironment` on a floor | player falls through the world | add the component to a walkable surface |
|
|
76
|
+
| Scene origin left occupied | player spawns inside your geometry | the player origin is `0,0,0` unless the scene authors `player.transform` |
|
|
77
|
+
| Scene JSON with `imports` | authoring preview works, but editable open and runtime load are rejected | run `npx @iwsdk/cli scene flatten` once, then edit the flat output |
|
|
78
|
+
| `entity.destroy()` | GPU memory leaked | use `entity.dispose()` |
|
|
79
|
+
| `setValue` on a Vec2/Vec3/Vec4/Color field | throws in elics 3.4.x | use `entity.getVectorView(...)` |
|
|
80
|
+
| Environment component on a non-root entity | silently ignored | `DomeGradient`/`IBLGradient` go on the level root only |
|
|
81
|
+
| `DomeFade` with no `DomeGradient` on the level root | no fade; the floor keeps its hard edge | add a `DomeGradient` (render stats report the DomeFade `inactiveReason`) |
|
|
82
|
+
| `DomeTexture`/`IBLTexture` prop changed without `_needsUpdate` | change ignored | set `_needsUpdate` after writing; `DomeGradient`/`IBLGradient` apply edits without it |
|
|
83
|
+
| `ScreenSpace` given numbers | clamped with a console warning | it takes CSS strings: `'400px'`, `'25vw'` |
|
|
84
|
+
| `@iwsdk/reference` MCP tools in an old or `--no-install` app | queries report warmup required | run `npx @iwsdk/cli reference warmup`; fresh installed scaffolds do this during creation |
|
|
84
85
|
|
|
85
86
|
## Verify before you claim it works
|
|
86
87
|
|
|
@@ -113,10 +114,18 @@ interaction correctness.
|
|
|
113
114
|
|
|
114
115
|
For a physical headset smoke test, run `npx @iwsdk/cli dev status`, open a URL from
|
|
115
116
|
`data.runtimeUrls.network` on a headset connected to the same Wi-Fi network,
|
|
116
|
-
and accept the expected local certificate warning.
|
|
117
|
+
and accept the expected local certificate warning. To run or automate the app
|
|
118
|
+
on a Quest connected over USB, invoke `iwsdk-native-xr-test` instead. See
|
|
117
119
|
[Testing Your Experience](https://iwsdk.dev/guides/02-testing-experience.html)
|
|
118
120
|
for the complete workflow.
|
|
119
121
|
|
|
122
|
+
**Meta VR Glasses are not a Quest.** Their view is much narrower (37° left and
|
|
123
|
+
right, 25° up, 43° down) and their main input is gaze plus a pinch. Before
|
|
124
|
+
claiming an app works on the glasses, or when it uses gaze or eye tracking,
|
|
125
|
+
invoke `iwsdk-glasses-test`: it sets the `metaVRGlasses` emulator device, checks
|
|
126
|
+
that content fits that view, and drives gaze and pinch from the CLI. A Quest
|
|
127
|
+
screenshot or the editor view cannot show that fit.
|
|
128
|
+
|
|
120
129
|
## MCP and CLI are one surface, not two
|
|
121
130
|
|
|
122
131
|
Nearly every capability exists both ways — `scene_render_file` and
|
|
@@ -169,6 +178,10 @@ The selected playbook routes work to the narrowest owning specialist:
|
|
|
169
178
|
UI authoring, physics, depth occlusion, grab and ray interaction testing, ECS
|
|
170
179
|
frame-stepping, and debugging have their own project skills. Use them only when
|
|
171
180
|
the selected `iwsdk-dev` playbook calls for the matching specialty.
|
|
181
|
+
Two device-testing skills are invoked directly: `iwsdk-native-xr-test` whenever
|
|
182
|
+
the user wants to run, automate, or debug the app on a connected Quest, and
|
|
183
|
+
`iwsdk-glasses-test` whenever the user targets Meta VR Glasses or asks for gaze
|
|
184
|
+
input.
|
|
172
185
|
|
|
173
186
|
The failure worth guarding against is improvising a domain that already has a
|
|
174
187
|
skill because the naive approach looks tractable. Before hand-authoring scene
|