@iwsdk/cli 0.5.3 → 1.0.0-rc.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.
Files changed (39) hide show
  1. package/README.md +62 -1
  2. package/bin/iwsdk.js +1 -1
  3. package/dist/browser-lease.d.ts +14 -0
  4. package/dist/browser-lease.d.ts.map +1 -0
  5. package/dist/cli-types.d.ts +1 -1
  6. package/dist/cli-types.d.ts.map +1 -1
  7. package/dist/cli.js +2811 -485
  8. package/dist/cli.js.map +1 -1
  9. package/dist/commands/browser.d.ts +14 -0
  10. package/dist/commands/browser.d.ts.map +1 -0
  11. package/dist/commands/dev.d.ts +6 -2
  12. package/dist/commands/dev.d.ts.map +1 -1
  13. package/dist/commands/runtime.d.ts.map +1 -1
  14. package/dist/commands/status.d.ts.map +1 -1
  15. package/dist/contract.js +481 -30
  16. package/dist/contract.js.map +1 -1
  17. package/dist/help.d.ts +1 -0
  18. package/dist/help.d.ts.map +1 -1
  19. package/dist/index.d.ts.map +1 -1
  20. package/dist/index.js +2813 -487
  21. package/dist/index.js.map +1 -1
  22. package/dist/mcp-stdio.d.ts.map +1 -1
  23. package/dist/runtime-contract.d.ts +70 -1
  24. package/dist/runtime-contract.d.ts.map +1 -1
  25. package/dist/runtime-files.d.ts +19 -0
  26. package/dist/runtime-files.d.ts.map +1 -0
  27. package/dist/runtime-files.js +318 -0
  28. package/dist/runtime-files.js.map +1 -0
  29. package/dist/runtime-owner.d.ts +50 -0
  30. package/dist/runtime-owner.d.ts.map +1 -0
  31. package/dist/runtime-owner.js +539 -0
  32. package/dist/runtime-owner.js.map +1 -0
  33. package/dist/runtime-state.d.ts +20 -18
  34. package/dist/runtime-state.d.ts.map +1 -1
  35. package/dist/runtime-transport.d.ts.map +1 -1
  36. package/dist/screenshot-output.d.ts +13 -0
  37. package/dist/screenshot-output.d.ts.map +1 -0
  38. package/guidance/AGENTS.md +96 -37
  39. package/package.json +16 -2
@@ -0,0 +1,14 @@
1
+ /**
2
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
3
+ *
4
+ * This source code is licensed under the MIT license found in the
5
+ * LICENSE file in the root directory of this source tree.
6
+ */
7
+ import type { CliOptions, CliSuccess, ResolvedCliIo } from '../cli-types.js';
8
+ export declare function selectManagedBrowserPage(browser: any, managedOrigin: string, expectedTargetId: string): Promise<{
9
+ context: any;
10
+ page: any;
11
+ }>;
12
+ export declare function protectManagedOwnership(browser: any, context: any, page: any, cdp: any): void;
13
+ export declare function handleBrowserRun(scriptArgument: string | undefined, options: CliOptions, io: ResolvedCliIo): Promise<CliSuccess<unknown>>;
14
+ //# sourceMappingURL=browser.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/commands/browser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AA2B7E,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,GAAG,EACZ,aAAa,EAAE,MAAM,EACrB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC;IAAE,OAAO,EAAE,GAAG,CAAC;IAAC,IAAI,EAAE,GAAG,CAAA;CAAE,CAAC,CA2CtC;AAiED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE,GAAG,EACZ,IAAI,EAAE,GAAG,EACT,GAAG,EAAE,GAAG,GACP,IAAI,CA4BN;AAuBD,wBAAsB,gBAAgB,CACpC,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,OAAO,EAAE,UAAU,EACnB,EAAE,EAAE,aAAa,GAChB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAkP9B"}
@@ -8,9 +8,11 @@ import type { CliFailure, CliOptions, CliSuccess, ResolvedCliIo } from '../cli-t
8
8
  import { type RuntimeSession } from '../runtime-contract.js';
9
9
  export type DevAiMode = 'agent' | 'collaborate';
10
10
  export interface ResolvedDevSessionOptions {
11
+ allowBrowserAutomation: boolean;
11
12
  aiMode?: DevAiMode;
12
13
  headless: boolean;
13
14
  open: boolean;
15
+ nativeXRControl: boolean;
14
16
  screenshotWidth?: number;
15
17
  screenshotHeight?: number;
16
18
  }
@@ -27,14 +29,16 @@ export interface ProcessExitResult {
27
29
  export declare function isAbnormalChildExit(exit: ProcessExitResult): boolean;
28
30
  /** Human-readable reason for an abnormal child exit (code vs. signal). */
29
31
  export declare function describeChildExit(exit: ProcessExitResult): string;
32
+ /** Names the port a fail-closed startup could not bind, from its launch log. */
33
+ export declare function describeStartupExit(logPath: string | null): Promise<string>;
30
34
  /** Parse and validate launch-time choices owned by the dev command. */
31
35
  export declare function resolveDevSessionOptions(options: CliOptions): ResolvedDevSessionOptions;
32
36
  /** Build the child environment without retaining stale session overrides. */
33
37
  export declare function buildDevRuntimeEnvironment(options: CliOptions, baseEnvironment?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
34
38
  export declare function shouldOpenExternalBrowser(openRequested: boolean, session: Pick<RuntimeSession, 'browser'>): boolean;
35
- export declare function handleDevUp(options: CliOptions, io: ResolvedCliIo): Promise<CliSuccess<unknown> | CliFailure | null>;
39
+ export declare function handleDevUp(options: CliOptions, io: ResolvedCliIo): Promise<CliSuccess<unknown> | CliFailure | number | null>;
36
40
  export declare function handleDevDown(options: CliOptions, io: ResolvedCliIo): Promise<CliSuccess<unknown>>;
37
- export declare function handleDevRestart(options: CliOptions, io: ResolvedCliIo): Promise<CliSuccess<unknown> | CliFailure | null>;
41
+ export declare function handleDevRestart(options: CliOptions, io: ResolvedCliIo): Promise<CliSuccess<unknown> | CliFailure | number | null>;
38
42
  export declare function handleDevLogs(options: CliOptions, io: ResolvedCliIo): Promise<CliSuccess<unknown>>;
39
43
  export declare function handleDevOpen(options: CliOptions, io: ResolvedCliIo): Promise<CliSuccess<unknown>>;
40
44
  export declare function handleDevStatus(options: CliOptions, io: ResolvedCliIo): Promise<CliSuccess<unknown>>;
@@ -1 +1 @@
1
- {"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,aAAa,EACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAOL,KAAK,cAAc,EACpB,MAAM,wBAAwB,CAAC;AAuBhC,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,aAAa,CAAC;AAEhD,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAUD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAEpE;AAED,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAQjE;AA+LD,uEAAuE;AACvE,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,UAAU,GAClB,yBAAyB,CAsC3B;AAED,6EAA6E;AAC7E,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,UAAU,EACnB,eAAe,GAAE,MAAM,CAAC,UAAwB,GAC/C,MAAM,CAAC,UAAU,CAuBnB;AAED,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,OAAO,EACtB,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,GACvC,OAAO,CAET;AAmOD,wBAAsB,WAAW,CAC/B,OAAO,EAAE,UAAU,EACnB,EAAE,EAAE,aAAa,GAChB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,UAAU,GAAG,IAAI,CAAC,CAmMlD;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,UAAU,EACnB,EAAE,EAAE,aAAa,GAChB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAQ9B;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,UAAU,EACnB,EAAE,EAAE,aAAa,GAChB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,UAAU,GAAG,IAAI,CAAC,CAUlD;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,UAAU,EACnB,EAAE,EAAE,aAAa,GAChB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAyB9B;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,UAAU,EACnB,EAAE,EAAE,aAAa,GAChB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CA+B9B;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,UAAU,EACnB,EAAE,EAAE,aAAa,GAChB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAE9B"}
1
+ {"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,aAAa,EACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EASL,KAAK,cAAc,EACpB,MAAM,wBAAwB,CAAC;AA6BhC,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,aAAa,CAAC;AAEhD,MAAM,WAAW,yBAAyB;IACxC,sBAAsB,EAAE,OAAO,CAAC;IAChC,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAYD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAEpE;AAED,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAQjE;AAED,gFAAgF;AAChF,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,GAAG,IAAI,GACrB,OAAO,CAAC,MAAM,CAAC,CAMjB;AA+LD,uEAAuE;AACvE,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,UAAU,GAClB,yBAAyB,CAgD3B;AAED,6EAA6E;AAC7E,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,UAAU,EACnB,eAAe,GAAE,MAAM,CAAC,UAAwB,GAC/C,MAAM,CAAC,UAAU,CA6BnB;AAED,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,OAAO,EACtB,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,GACvC,OAAO,CAET;AAkdD,wBAAsB,WAAW,CAC/B,OAAO,EAAE,UAAU,EACnB,EAAE,EAAE,aAAa,GAChB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,UAAU,GAAG,MAAM,GAAG,IAAI,CAAC,CAwT3D;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,UAAU,EACnB,EAAE,EAAE,aAAa,GAChB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAQ9B;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,UAAU,EACnB,EAAE,EAAE,aAAa,GAChB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,UAAU,GAAG,MAAM,GAAG,IAAI,CAAC,CAU3D;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,UAAU,EACnB,EAAE,EAAE,aAAa,GAChB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAyB9B;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,UAAU,EACnB,EAAE,EAAE,aAAa,GAChB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CA+B9B;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,UAAU,EACnB,EAAE,EAAE,aAAa,GAChB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAE9B"}
@@ -1 +1 @@
1
- {"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/commands/runtime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EACZ,UAAU,EACV,aAAa,EACd,MAAM,iBAAiB,CAAC;AAiKzB,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,UAAU,EACnB,EAAE,EAAE,aAAa,GAChB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC,CA2G7C"}
1
+ {"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/commands/runtime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EACZ,UAAU,EACV,aAAa,EACd,MAAM,iBAAiB,CAAC;AAmKzB,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,UAAU,EACnB,EAAE,EAAE,aAAa,GAChB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC,CAsG7C"}
@@ -1 +1 @@
1
- {"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EACV,UAAU,EACV,aAAa,EACd,MAAM,iBAAiB,CAAC;AAQzB,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,MAAM,EACX,iBAAiB,EAAE,cAAc,GAAG,SAAS,GAC5C,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAcxB;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,UAAU,EACnB,EAAE,EAAE,aAAa,GAChB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAsB9B"}
1
+ {"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EACV,UAAU,EACV,aAAa,EACd,MAAM,iBAAiB,CAAC;AASzB,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,MAAM,EACX,iBAAiB,EAAE,cAAc,GAAG,SAAS,GAC5C,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAcxB;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,UAAU,EACnB,EAAE,EAAE,aAAa,GAChB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAuB9B"}