@revoengine/cli 1.0.38 → 2.0.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 (47) hide show
  1. package/CHANGELOG.md +33 -0
  2. package/README.md +22 -10
  3. package/dist/src/argument-contract.js +5 -5
  4. package/dist/src/automation-contract.generated.d.ts +6 -30
  5. package/dist/src/automation-contract.generated.js +6 -30
  6. package/dist/src/client.d.ts +2 -2
  7. package/dist/src/client.js +4 -14
  8. package/dist/src/commands/component.js +16 -0
  9. package/dist/src/commands/database-tables.js +1 -1
  10. package/dist/src/commands/emulate.js +67 -74
  11. package/dist/src/commands/terminal-browser-human-input.d.ts +28 -0
  12. package/dist/src/commands/terminal-browser-human-input.js +56 -7
  13. package/dist/src/commands/terminal-browser-live-protocol.d.ts +13 -1
  14. package/dist/src/commands/terminal-browser-live-protocol.js +20 -4
  15. package/dist/src/commands/terminal-browser-live-transport.d.ts +2 -0
  16. package/dist/src/commands/terminal-browser-live-transport.js +21 -4
  17. package/dist/src/commands/terminal-browser-live.d.ts +36 -1
  18. package/dist/src/commands/terminal-browser-live.js +435 -106
  19. package/dist/src/commands/terminal-browser-observation.d.ts +1 -1
  20. package/dist/src/commands/terminal-browser-observation.js +10 -1
  21. package/dist/src/commands/terminal-browser-page-input.d.ts +1 -0
  22. package/dist/src/commands/terminal-browser-page-input.js +20 -0
  23. package/dist/src/commands/terminal-browser-profile-sync.d.ts +5 -1
  24. package/dist/src/commands/terminal-browser-profile-sync.js +13 -2
  25. package/dist/src/commands/terminal-browser-profile-sync.protocol.d.ts +2 -0
  26. package/dist/src/commands/terminal-browser-recording.d.ts +6 -3
  27. package/dist/src/commands/terminal-browser-recording.js +45 -15
  28. package/dist/src/commands/terminal-browser.d.ts +17 -0
  29. package/dist/src/commands/terminal-browser.js +318 -111
  30. package/dist/src/commands/terminal-operational-log.js +2 -1
  31. package/dist/src/commands/terminal-output-buffer.d.ts +2 -0
  32. package/dist/src/commands/terminal-output-buffer.js +6 -0
  33. package/dist/src/commands/terminal-reconnect-grace.d.ts +1 -0
  34. package/dist/src/commands/terminal-reconnect-grace.js +1 -0
  35. package/dist/src/commands/terminal-sandbox.js +22 -6
  36. package/dist/src/commands/terminal.js +136 -40
  37. package/dist/src/endpoint-emulator.d.ts +16 -13
  38. package/dist/src/endpoint-emulator.js +26 -35
  39. package/dist/src/project.js +1 -0
  40. package/dist/src/request-contract.d.ts +2 -0
  41. package/dist/src/request-contract.js +11 -1
  42. package/dist/src/resource-syncs/database-table-sync.d.ts +2 -1
  43. package/dist/src/resource-syncs/database-table-sync.js +60 -23
  44. package/dist/src/sync-omit.js +1 -1
  45. package/dist/src/types.d.ts +0 -3
  46. package/dist/src/ui.js +2 -2
  47. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -1,5 +1,38 @@
1
1
  # Changelog
2
2
 
3
+ ## 2.0.0 — 2026-11-07
4
+
5
+ ### Upgrade requirements
6
+
7
+ - This major release removes `skipLibs`, `includeLibs` and `excludeLibs` from Endpoint and Job configuration. Remove these fields from current manifests before plan, push, deploy or local preview. Their presence is rejected even when set to `false` or an empty array.
8
+ - Review non-default library selections before removing them; verify the affected workflow on a test instance. Fields with similar names inside ordinary business payloads are unaffected.
9
+ - Use Platform 1.8.0 or later for the updated execution contract and VS Code extension 2.0.0 or later for the matching editor workflow. Update this compatibility set together.
10
+
11
+ ### Debugging and Live Preview
12
+
13
+ - Component debugging accepts `--call-strategy=caller|endpoints|jobs` or `callStrategy` in the debug configuration. Caller remains the default; explicit policies retain account-access and source-approval requirements.
14
+ - Browser Live Preview reports active sessions and tabs, supports pointer gestures and selected-text feedback, and preserves privacy and access-revocation controls.
15
+ - Local endpoint preview retains read-only defaults and redacted request diagnostics. Published endpoint execution uses the selected instance's saved code and execution policy.
16
+
17
+ ## 1.0.39 — 2026-11-06
18
+
19
+ ### Database Table audit
20
+
21
+ - Synchronize explicit root table audit settings through pull, plan, push and deploy. Verify the target setting before advancing its lock baseline.
22
+ - Manifests that omit audit preserve existing target settings. Partitions inherit the root setting and audit history stays on its instance.
23
+
24
+ ### Endpoint emulator
25
+
26
+ - Default to read-only Sandbox preview. Use `--mode=published --read-only=false` on a loopback listener to call the selected project's Run service. The execution mode replaces the previous `--service-account` option.
27
+ - Add `--skip-validate` to bypass low-code source analysis in local preview while retaining endpoint input validation and runtime checks.
28
+ - Include the execution path in completion and abort diagnostics. Close unsupported published SSE responses after reading their headers.
29
+
30
+ ### Terminal and Browser Live Preview
31
+
32
+ - Preserve Unicode when bounding browser results and allow private Unix worker sockets for macOS commands with Full Command Access and Local Networking.
33
+ - Keep reconnect backoff until execution resumes and a heartbeat is acknowledged. Record recognized close reasons and report recovery once.
34
+ - Reattach authorized viewers to surviving browser contexts. Keep live media independent of recording rotation, and retain old recording segments locally when upload authority expires.
35
+
3
36
  ## 1.0.38 — 2026-11-06
4
37
 
5
38
  - Use neutral endpoint-emulator examples in the CLI package documentation.
package/README.md CHANGED
@@ -10,9 +10,11 @@ The CLI has three main capabilities:
10
10
  2. **Project migration** — plan, run, and verify a direct migration between two saved projects with `--from` and `--to`.
11
11
  3. **Resource synchronization** — work with one supported resource family through its dedicated `pull`, `plan`, and `push` commands.
12
12
 
13
- ## Version 1.0.38
13
+ ## Version 2.0.0
14
14
 
15
- Run `revo emulate endpoints` to serve local endpoint code through the Revo sandbox. Save changes and send another request to test them without a deploy. Choose the host, port and an explicit execution mode. Service-account endpoints support local caller preview and published execution. The emulator activity feed shows request timing without exposing connection or route identifiers. See [the emulator quickstart](#develop-endpoints-without-deploying).
15
+ Use this release with Platform 1.8.0 or later and VS Code extension 2.0.0 or later. Update the compatible clients and backend together. Endpoint and Job configurations no longer accept `skipLibs`, `includeLibs` or `excludeLibs`, including `false` and empty arrays. Remove these fields from current manifests; review and test non-default selections first. Ordinary business payload fields are unaffected.
16
+
17
+ Debugger execution defaults to the caller and can explicitly select the global endpoint or job policy. Browser Live Preview supports pointer gestures, selected-text feedback and active-session status while retaining privacy controls. See the [2.0.0 changelog](CHANGELOG.md).
16
18
 
17
19
  Component creation and reviewed source saves can wait up to ten minutes, including cold Sandbox startup. This also extends Node fetch's response-header waiting limit. Upgrade the matching API/Sandbox services to receive the longer server-side validation budget. See the [1.0.35 changelog](CHANGELOG.md). Writes with `--omit` still require the matching API capability `atomicResourceUpdates`.
18
20
 
@@ -110,11 +112,15 @@ Runner credentials are stored in `runner.json` beside the CLI configuration. Eac
110
112
 
111
113
  Terminal connection and execution metadata is also written under the CLI configuration at `logs/terminal/<agentTerminalId>/debug.log`. Each line has `[ISO UTC timestamp][severity][assistantThreadId][assistantMessageId] event` followed by allowlisted metadata such as the execution ID, operation, sandbox, exit code, and reconnect delay. Commands, browser URLs, input, output, and credentials are excluded. On the first write after UTC midnight or after a restart, the completed day moves to `YYYY-MM-DD-debug.log.gz`; archives older than 30 days are removed. The log directory is private (`0700`) and files are `0600`. Runner/service stderr remains available for startup failures that occur before this operational log is ready.
112
114
 
115
+ Reconnect backoff resets after execution resume and an acknowledged heartbeat.
116
+ Short-lived handshakes remain visible in the operational log, with known server
117
+ close reasons. The terminal reports recovery once the connection is healthy.
118
+
113
119
  The Agent terminal has independent command and network grants. Grants are ceilings; each execution frame carries the requested sandbox and `networkAccess=none|local|full`, so a Full grant does not silently widen a workspace or local-only call. Workspace commands keep writes inside the registered workspace and a private temporary directory; a workspace shell with external networking uses `workspace-network`. An explicit `unrestricted` command requests host file access without adding network access. A localhost development server must request Local network access to bind its port. macOS uses Seatbelt for workspace isolation and host plus local-only network; Linux uses `bwrap` and fails closed for shell Local access because enforceable localhost-only isolation is unavailable there. Missing isolation support fails closed. The runner requires a complete `terminal_policy_v2` execution frame from Realtime, including requested command/network modes, grant revision and optional expiry. New runners advertise `terminal_policy_selective_v1`: an increased grant takes effect on subsequent calls without disconnecting; a reduced grant stops only commands and Browser sessions no longer covered by the current grant or an unexpired temporary scope. Temporary scope expiry stops affected work and closes Browser sessions using that scope. Workspace patches and stdin for a running process are supported. A personal API key is required.
114
120
 
115
121
  Browser actions use Playwright's full Chromium in its standard headless mode. The CLI's npm install downloads that browser into Playwright's per-user cache without requiring Python 3; a separate Chrome installation is not required. If npm scripts were disabled or the download was interrupted, reinstall the CLI with scripts enabled before using Browser. Linux hosts still need Playwright's system libraries; an administrator can install them with `npx playwright install-deps chromium`.
116
122
 
117
- On macOS, workspace commands may use Unix-domain sockets only inside their own private temporary directory. This lets build tools exchange worker messages without enabling IP networking or access to workspace, other-command or host-service sockets. Local development servers still need Local network access and must bind to localhost. Ordinary process deadlines cover the whole lifetime, not startup. The runner advertises `background_shell_v1`: `terminal.start` with `background=true` and `timeout_ms=null` keeps a dev server or watcher on the existing execution ID without the ordinary lifetime timer. Status, output, stdin, PTY and cancel remain available; hiding the terminal view does not stop the process. Scope expiry, revocation, runner stop and the two-minute (120-second) disconnect grace still apply. Reuse a healthy project server or check fresh HTTP readiness after starting it.
123
+ On macOS, network-isolated workspace commands and Full Command Access with Local Networking can use Unix-domain sockets inside a private temporary directory for each command. Build tools such as Nx can start workers while host-service sockets and external IP connections remain blocked. Full Command Access keeps the user's home directory. Local development servers need Local Networking and must bind to localhost. Ordinary process deadlines cover the whole lifetime, not startup. The runner advertises `background_shell_v1`: `terminal.start` with `background=true` and `timeout_ms=null` keeps a dev server or watcher on the existing execution ID without the ordinary lifetime timer. Status, output, stdin, PTY and cancel remain available; hiding the terminal view does not stop the process. Scope expiry, revocation, runner stop and the two-minute (120-second) disconnect grace still apply. Reuse a healthy project server or check fresh HTTP readiness after starting it.
118
124
 
119
125
  The terminal approval UI supports Allow once, Allow for 15 minutes, Allow for 1 hour, Allow for 8 hours, Allow for 24 hours and Allow for this thread. Whole-thread access requires this runner's `terminal_thread_scope_v1` capability. It covers only the requested Commands and Network levels, survives later messages and short reconnects, and carries no hourly deadline. Disconnect, thread deletion and a device grant revision change revoke it. Realtime rechecks the consent on heartbeat, including idle Browser contexts; scope revocation closes only the affected context. Process `background` mode and the one-hour Browser idle retention are independent of this approval duration.
120
126
 
@@ -611,7 +617,9 @@ Root-table columns can carry unique, non-empty Stable Keys in `definition[].meta
611
617
 
612
618
  Dedicated push allows reviewed key-matched changes to existing columns, including name, type, default, nullability, array, primary-key, unique, and index fields. These operations can scan, lock, rewrite, or validate live data. Exact-name matching remains a fallback for safe presentation changes and an ordinary nullable column addition; it never guesses a rename. A required, defaulted, indexed, unique, or primary-key addition needs a unique column Stable Key. Structural changes to an existing unkeyed column and unkeyed operational additions remain manual. Active Database Views block dependent column renames, removals, type changes, and array changes at plan time and again before the write.
613
619
 
614
- Database Table manifests own the complete non-reserved user metadata object. Push replaces target user metadata with the manifest's object, including deliberate key removals, while platform-reserved `__*` fields remain server-owned. Audit history and the source `audit` setting are target-local: updates preserve the target audit setting and new tables start with audit disabled.
620
+ Database Table manifests own the complete non-reserved user metadata object. Push replaces target user metadata with the manifest's object, including deliberate key removals, while platform-reserved `__*` fields remain server-owned.
621
+
622
+ Root table manifests can declare `"audit": true` or `"audit": false`. Pull records the source setting when available. Plan reports audit changes, and push and deploy verify the setting on the target before updating the lock. A manifest without `audit` preserves the setting on an existing table and creates a new root with audit disabled. Partitions inherit the root setting. Use `--omit=database-table:audit` to preserve existing destination values during synchronization. Audit history stays on its originating instance.
615
623
 
616
624
  Access control is also target-local. Pull records a root table's source `restricted` flag as `sourceRestricted` in the shared lock, outside its portable manifest and hash. New roots use that flag but copy no source ACL user or group IDs; existing target access is preserved on update, and partitions inherit the target parent's policy. Assign target principals separately. Dedicated push blocks creation when an older lock lacks the restriction snapshot; pull again to capture it. Orchestrated deployment permits that create and defaults an unknown restriction to false, so preserve the lock alongside manifests when source restriction matters.
617
625
 
@@ -644,7 +652,7 @@ Run from the initialized RevoEngine project, including monorepos with a configur
644
652
 
645
653
  ```bash
646
654
  revo pull --project demo-dev --resources component,endpoint --yes
647
- revo emulate endpoints --project demo-dev --port 4300 --read-only=true
655
+ revo emulate endpoints --project demo-dev --port 4300
648
656
  ```
649
657
 
650
658
  Use the name of your saved CLI project in place of `demo-dev`. For a loopback listener, connect through localhost using the selected port. This example assumes your workspace defines a `POST /v1/demo/items` endpoint.
@@ -660,22 +668,24 @@ The default listener is loopback only. Pass `--host` with an explicit bind addre
660
668
 
661
669
  From another device, use the machine's network IP and port `4310` as the client or frontend proxy target. Clients that can reach the port can invoke endpoints under the CLI project credentials. Use a trusted network. For browser traffic, use the frontend's development proxy and open the frontend using the same IP address as its proxy target.
662
670
 
663
- The terminal watches HTTP requests by default. It logs an ID and method when a request arrives, then the HTTP status and elapsed time.
671
+ The terminal watches HTTP requests by default. It logs an ID and method when a request arrives, then the HTTP status, elapsed time and execution path when selected.
664
672
 
665
673
  ```text
666
674
  [2026-11-05T10:15:00.000Z] #1 POST received
667
- [2026-11-05T10:15:00.084Z] #1 POST → 200 (84 ms)
675
+ [2026-11-05T10:15:00.084Z] #1 POST → 200 (84 ms) · Sandbox preview
668
676
  ```
669
677
 
670
678
  Use `--no-watch` to disable the feed. In `--json` mode, the startup event reports the port and whether the listener is loopback-only. Pass `--watch` to include request events. The feed omits request paths, query strings, headers and bodies. When started from VS Code, the same feed opens in **Output → RevoEngine Endpoint Emulator**.
671
679
 
672
680
  Save changes to `endpoint.json`, a component, or a JS/TS library. In local preview, the emulator reads the current files for each request and submits them to the project's sandbox debugger. A `latest` binding uses the working copy. A `pinned` binding requires matching local content. The emulator returns 404 for routes missing from the local workspace. A frontend dev proxy keeps browser requests on the frontend origin. For example, an Angular dev proxy can use a root-relative API base and forward selected API paths as received.
673
681
 
674
- Choose an execution mode each time you start. `--read-only=true` uses the sandbox's platform write restrictions. External HTTP calls can still have real effects. `--read-only=false` allows real writes on the selected instance, requires a component execution role, and does not roll back changes. Press Ctrl+C to stop. In VS Code, **RevoEngine → Emulators → Endpoints** provides **Host**, **Port** and the same two execution modes.
682
+ **Local changes** is the default (`--mode=local`). The sandbox uses the authenticated CLI identity and defaults to `--read-only=true`. External HTTP calls can still have real effects. Pass `--read-only=false` to allow real writes on the selected instance. Service-account endpoints can be previewed with an explicit `CALLER` identity. If a route requires the execution account or an inherited identity, select Published endpoints.
675
683
 
676
- For a manifest with `SERVICE_ACCOUNT`, select `--service-account=caller` to preview local code with the authenticated CLI user's permissions. Local preview requires a caller identity. Select `--service-account=published --read-only=false` on a loopback host to execute the active saved endpoint with its saved account in RevoEngine Run. Published execution requires an exact static route, verifies the Stable Key and account policy, and uses published code. Run admission and approval checks still apply. For a custom Run origin, configure `REVO_TRUSTED_SERVICE_ORIGINS` before starting the CLI.
684
+ **Published endpoints** (`--mode=published --read-only=false`) sends requests directly to the selected project's Run service. Run resolves the active route and applies its published execution policy, including any configured service account. Use a loopback host. Local manifests are only needed for Local changes. For a custom Run origin, configure `REVO_TRUSTED_SERVICE_ORIGINS` before starting the CLI.
677
685
 
678
- The emulator uses the authenticated CLI identity. Browser authorization headers and cookies are stripped. Local preview supports JSON bodies, flat query parameters, and ordinary HTTP responses. Application SSE is unavailable. Local preview also excludes `skipLibs` and non-low-code components. The sandbox applies debugger logging, which can capture inputs and outputs even when the Run manifest sets `hideRequest` or `hideResponse`. Use development data.
686
+ Pass `--skip-validate` to skip low-code source analysis for the component and libraries in Sandbox preview. Endpoint input schemas and runtime checks still apply.
687
+
688
+ The emulator authenticates upstream as the CLI user. Browser authorization headers and cookies are stripped. Local preview supports JSON bodies, flat query parameters, and ordinary HTTP responses. Application SSE is unavailable. Local preview excludes non-low-code components. Retired library-selection fields are rejected during configuration validation. The sandbox applies debugger logging, which can capture inputs and outputs even when the Run manifest sets `hideRequest` or `hideResponse`. Use development data.
679
689
 
680
690
  ## Other commands
681
691
 
@@ -697,6 +707,8 @@ revo component debug <componentId> --read-only=true --stream
697
707
  revo component debug <componentId> --read-only=false
698
708
  ```
699
709
 
710
+ Component debugging accepts `--call-strategy=caller|endpoints|jobs` or `callStrategy` in `.revoengine/debug.json`. The flag takes precedence; the default is `caller`. `endpoints` and `jobs` select the corresponding global execution policy, subject to account delegation and source approval. An inherited execution authority cannot be changed.
711
+
700
712
  Use low-level `request` carefully; it bypasses the higher-level migration planner.
701
713
 
702
714
  ## Command arguments and local workspace safety
@@ -107,8 +107,8 @@ function actionContract(args) {
107
107
  }
108
108
  if (command === 'emulate') {
109
109
  if (action && action !== 'endpoints')
110
- throw new Error('Usage: revo emulate endpoints --read-only=true|false [--host <address>] [--port <port>]');
111
- return { ...v('host port read-only service-account'), ...b('watch'), ...output };
110
+ throw new Error('Usage: revo emulate endpoints [--mode=local|published] [--read-only=true|false] [--host <address>] [--port <port>]');
111
+ return { ...v('host port read-only mode'), ...b('watch skip-validate'), ...output };
112
112
  }
113
113
  if (command === 'request')
114
114
  return { ...v('method m path p body d'), ...many('query q') };
@@ -187,7 +187,7 @@ function actionContract(args) {
187
187
  if (!action)
188
188
  return {};
189
189
  if (component && action === 'debug')
190
- return { ...v('id i body d timeout t memory m'), ...b('read-only stream extra-libs no-extra-libs raw-debug debug-raw debug-payload') };
190
+ return { ...v('id i body d timeout t memory m call-strategy'), ...b('read-only stream extra-libs no-extra-libs raw-debug debug-raw debug-payload') };
191
191
  const result = { ...all, ...output, ...omit,
192
192
  ...(action === 'plan' ? plan : force),
193
193
  ...(['push', 'push-all'].includes(action) ? yes : {}),
@@ -267,8 +267,8 @@ export function validateCommandArguments(args, options = {}) {
267
267
  }
268
268
  const [command, action] = args._;
269
269
  if (command === 'emulate' && action === 'endpoints' && !readBooleanOption(args, ['help', 'h'])
270
- && args['read-only'] !== 'true' && args['read-only'] !== 'false') {
271
- throw new Error('Pass --read-only=true or --read-only=false explicitly.');
270
+ && args['read-only'] !== undefined && args['read-only'] !== 'true' && args['read-only'] !== 'false') {
271
+ throw new Error('Pass --read-only=true or --read-only=false.');
272
272
  }
273
273
  if (command === 'deploy' && readBooleanOption(args, ['async']))
274
274
  throw new Error('Full deploy waits for schema readiness and verified readback before dependent phases; use database-tables push <stableKey> --async for admission only.');
@@ -142,10 +142,6 @@ export declare const requestContracts: {
142
142
  readonly EndpointOptionsDto: {
143
143
  readonly type: "object";
144
144
  readonly properties: {
145
- readonly skipLibs: {
146
- readonly nullable: true;
147
- readonly type: "boolean";
148
- };
149
145
  readonly legacyResults: {
150
146
  readonly nullable: true;
151
147
  readonly type: "boolean";
@@ -209,20 +205,6 @@ export declare const requestContracts: {
209
205
  readonly nullable: true;
210
206
  readonly type: "boolean";
211
207
  };
212
- readonly includeLibs: {
213
- readonly nullable: true;
214
- readonly type: "array";
215
- readonly items: {
216
- readonly type: "string";
217
- };
218
- };
219
- readonly excludeLibs: {
220
- readonly nullable: true;
221
- readonly type: "array";
222
- readonly items: {
223
- readonly type: "string";
224
- };
225
- };
226
208
  readonly componentSchemaId: {
227
209
  readonly nullable: true;
228
210
  readonly type: "string";
@@ -412,10 +394,6 @@ export declare const requestContracts: {
412
394
  readonly nullable: true;
413
395
  readonly type: "object";
414
396
  };
415
- readonly skipLibs: {
416
- readonly nullable: true;
417
- readonly type: "boolean";
418
- };
419
397
  readonly legacyResults: {
420
398
  readonly nullable: true;
421
399
  readonly type: "boolean";
@@ -680,7 +658,6 @@ export declare const requestContractDefaults: {
680
658
  readonly hideRequest: false;
681
659
  readonly hideResponse: false;
682
660
  readonly legacyResults: false;
683
- readonly skipLibs: false;
684
661
  readonly memory: 256;
685
662
  readonly concurrency: {
686
663
  readonly key: null;
@@ -724,7 +701,6 @@ export declare const requestContractDefaults: {
724
701
  readonly hideRequest: false;
725
702
  readonly hideResponse: false;
726
703
  readonly legacyResults: false;
727
- readonly skipLibs: false;
728
704
  readonly memory: 32;
729
705
  };
730
706
  };
@@ -739,10 +715,10 @@ export declare const requestContractSemanticSources: {
739
715
  readonly "packages/domain/src/dto/components/component.validator.ts#validateEndpointGuardSemantics": "fd885b48c2990e47d1f05965af044aef8e2256da5fa4a86d1248967b04a3fd1e";
740
716
  readonly "apps/api/src/modules/endpoints/endpoint.service.ts#create": "cb10fc198892423088d396acd09618d8c64504a57fac0df3a892d57993913067";
741
717
  readonly "apps/api/src/modules/endpoints/endpoint.service.ts#update": "bc59acaffdb7275659bddb65b8d71e9d8266447054723ea87495eaa0dd512fe1";
742
- readonly "apps/api/src/modules/endpoints/endpoint.service.ts#validateEndpointOptions": "07401218669a87a9488b0aeb59f15b8d51341a172fb346ff83d38ed563a2988f";
743
- readonly "apps/api/src/modules/endpoints/endpoint.service.ts#applyEndpointOptionDefaults": "990c27ae925b613215601c215a6e38f6ecb4e2b34b77d6e2819f0921d4e56230";
744
- readonly "apps/api/src/modules/automation/jobs.service.ts#createJobTemplate": "1513bad8634fdf6abcca52f0041044512b3e53b3e7451f1b443f7e79fc026b01";
745
- readonly "apps/api/src/modules/automation/jobs.service.ts#update": "950fad34e7ac3ffdfce9114ba213c11e113aea036a44569b126a8c1e5e589228";
718
+ readonly "apps/api/src/modules/endpoints/endpoint.service.ts#validateEndpointOptions": "64686ee1c1e2611aa00847b771de637797a3007062b95e303046ad2cba69e729";
719
+ readonly "apps/api/src/modules/endpoints/endpoint.service.ts#applyEndpointOptionDefaults": "9da1bdfd83a3142b7f44d4ce5ee2aac6cf4ed70bef790f979c412c411fe2790d";
720
+ readonly "apps/api/src/modules/automation/jobs.service.ts#createJobTemplate": "e5230697a846e6a20f4cfe5f16eccdf27ba409f309d0e101b225cd4302c0cc48";
721
+ readonly "apps/api/src/modules/automation/jobs.service.ts#update": "448412c945a9fef3792359df48fa7d27e5afa254e7c43c6cea64e518381e41a0";
746
722
  readonly "packages/platform-shared/src/services/job.scheduler.service.ts#resolveTemplateInputs": "a9a4cc5df4627abf7ee2d2df7f2494d290292a15f4889a5f07a9de104ee33d9f";
747
723
  readonly "packages/domain/src/dto/components/component-element-key.const.ts#isLowCodeComponentType": "4918470ef562727becb8c97c5afb7761a49734ecd21a6d3d5436576dbd10a6da";
748
724
  readonly "packages/domain/src/dto/components/component-element-key.const.ts#isDefaultLibraryElement": "4faa356b91be5c44ebe3d442b6da26088d6d35d2db5fb073e1103165431cee48";
@@ -756,11 +732,11 @@ export declare const requestContractSourceProvenance: {
756
732
  readonly main: {
757
733
  readonly "packages/domain/src/dto/automation/endpoint.template.request.dto.ts#EndpointRequestDto": "45a1a84e200b2cdf9b44051fe36cb7bda1b577a0f5bbcc88942764336a6d7302";
758
734
  readonly "packages/domain/src/dto/automation/update.api.template.request.dto.ts#UpdateEndpointRequestDto": "20ee0c9afbfa594f189ead2b751aa00b6003efe0b70c5e1158ee78c1e0d29567";
759
- readonly "packages/domain/src/dto/automation/endpoint.template.request.dto.ts#EndpointOptionsDto": "acb07cc1e2c80d1721150691ea185eb3fa2f255a0833749973bf8175d85d9a32";
735
+ readonly "packages/domain/src/dto/automation/endpoint.template.request.dto.ts#EndpointOptionsDto": "1ade11735627613a81b5cfaa796dfdc49d4c7e0db01ae6467da6a99a9f3af683";
760
736
  readonly "packages/domain/src/dto/automation/endpoint.sse.dto.ts#EndpointSseDto": "960d56ebb300ded00f61f1318522c010135675e0f32a8084fb3e9b16a1c20ecc";
761
737
  readonly "packages/domain/src/dto/automation/job.template.request.dto.ts#JobTemplateRequestDto": "c47123206c187f0e16b08d7033ed9c455932f2e78e34455577663eb09410559d";
762
738
  readonly "packages/domain/src/dto/automation/update.job.template.dto.ts#UpdateJobTemplate": "0f79fefc76e749a331b5c848b9dcd6061e7dc247c2094dd975d7d2fe9a101c08";
763
- readonly "packages/domain/src/dto/automation/run.options.dto.ts#JobOptionsDto": "6e8f3f4b7aa6d8f38bc9227ced3158e4697031e68c78be9ea0e24e5af29e37d3";
739
+ readonly "packages/domain/src/dto/automation/run.options.dto.ts#JobOptionsDto": "a4ee900b8610f7edbabf8d07738f99b33a288327ea0d66e67c0f8c28260215c8";
764
740
  readonly "packages/domain/src/dto/automation/run.options.dto.ts#ConcurrencyJobDto": "529600772a878c5d26d55a70f5e562031169967051f5d0485ab4659a480d4a8d";
765
741
  readonly "packages/domain/src/dto/automation/run.options.dto.ts#RetryJobDto": "e42fcd447fe111bdf2da20ad42654e536a01d566f33a1d8f52ec1bb0bd1ee8b1";
766
742
  readonly "packages/domain/src/dto/automation/runtime.execution.policy.dto.ts#RuntimeExecutionPolicyDto": "9978ee21a9b7da26c93a4e1516dfc319166a2b55520edee9319d17922b375474";
@@ -194,10 +194,6 @@ export const requestContracts = {
194
194
  "EndpointOptionsDto": {
195
195
  "type": "object",
196
196
  "properties": {
197
- "skipLibs": {
198
- "nullable": true,
199
- "type": "boolean"
200
- },
201
197
  "legacyResults": {
202
198
  "nullable": true,
203
199
  "type": "boolean"
@@ -264,20 +260,6 @@ export const requestContracts = {
264
260
  "nullable": true,
265
261
  "type": "boolean"
266
262
  },
267
- "includeLibs": {
268
- "nullable": true,
269
- "type": "array",
270
- "items": {
271
- "type": "string"
272
- }
273
- },
274
- "excludeLibs": {
275
- "nullable": true,
276
- "type": "array",
277
- "items": {
278
- "type": "string"
279
- }
280
- },
281
263
  "componentSchemaId": {
282
264
  "nullable": true,
283
265
  "type": "string",
@@ -484,10 +466,6 @@ export const requestContracts = {
484
466
  "nullable": true,
485
467
  "type": "object"
486
468
  },
487
- "skipLibs": {
488
- "nullable": true,
489
- "type": "boolean"
490
- },
491
469
  "legacyResults": {
492
470
  "nullable": true,
493
471
  "type": "boolean"
@@ -786,7 +764,6 @@ export const requestContractDefaults = {
786
764
  "hideRequest": false,
787
765
  "hideResponse": false,
788
766
  "legacyResults": false,
789
- "skipLibs": false,
790
767
  "memory": 256,
791
768
  "concurrency": {
792
769
  "key": null,
@@ -1011,7 +988,6 @@ export const requestContractDefaults = {
1011
988
  "hideRequest": false,
1012
989
  "hideResponse": false,
1013
990
  "legacyResults": false,
1014
- "skipLibs": false,
1015
991
  "memory": 32
1016
992
  }
1017
993
  }
@@ -1026,10 +1002,10 @@ export const requestContractSemanticSources = {
1026
1002
  "packages/domain/src/dto/components/component.validator.ts#validateEndpointGuardSemantics": "fd885b48c2990e47d1f05965af044aef8e2256da5fa4a86d1248967b04a3fd1e",
1027
1003
  "apps/api/src/modules/endpoints/endpoint.service.ts#create": "cb10fc198892423088d396acd09618d8c64504a57fac0df3a892d57993913067",
1028
1004
  "apps/api/src/modules/endpoints/endpoint.service.ts#update": "bc59acaffdb7275659bddb65b8d71e9d8266447054723ea87495eaa0dd512fe1",
1029
- "apps/api/src/modules/endpoints/endpoint.service.ts#validateEndpointOptions": "07401218669a87a9488b0aeb59f15b8d51341a172fb346ff83d38ed563a2988f",
1030
- "apps/api/src/modules/endpoints/endpoint.service.ts#applyEndpointOptionDefaults": "990c27ae925b613215601c215a6e38f6ecb4e2b34b77d6e2819f0921d4e56230",
1031
- "apps/api/src/modules/automation/jobs.service.ts#createJobTemplate": "1513bad8634fdf6abcca52f0041044512b3e53b3e7451f1b443f7e79fc026b01",
1032
- "apps/api/src/modules/automation/jobs.service.ts#update": "950fad34e7ac3ffdfce9114ba213c11e113aea036a44569b126a8c1e5e589228",
1005
+ "apps/api/src/modules/endpoints/endpoint.service.ts#validateEndpointOptions": "64686ee1c1e2611aa00847b771de637797a3007062b95e303046ad2cba69e729",
1006
+ "apps/api/src/modules/endpoints/endpoint.service.ts#applyEndpointOptionDefaults": "9da1bdfd83a3142b7f44d4ce5ee2aac6cf4ed70bef790f979c412c411fe2790d",
1007
+ "apps/api/src/modules/automation/jobs.service.ts#createJobTemplate": "e5230697a846e6a20f4cfe5f16eccdf27ba409f309d0e101b225cd4302c0cc48",
1008
+ "apps/api/src/modules/automation/jobs.service.ts#update": "448412c945a9fef3792359df48fa7d27e5afa254e7c43c6cea64e518381e41a0",
1033
1009
  "packages/platform-shared/src/services/job.scheduler.service.ts#resolveTemplateInputs": "a9a4cc5df4627abf7ee2d2df7f2494d290292a15f4889a5f07a9de104ee33d9f",
1034
1010
  "packages/domain/src/dto/components/component-element-key.const.ts#isLowCodeComponentType": "4918470ef562727becb8c97c5afb7761a49734ecd21a6d3d5436576dbd10a6da",
1035
1011
  "packages/domain/src/dto/components/component-element-key.const.ts#isDefaultLibraryElement": "4faa356b91be5c44ebe3d442b6da26088d6d35d2db5fb073e1103165431cee48",
@@ -1043,11 +1019,11 @@ export const requestContractSourceProvenance = {
1043
1019
  "main": {
1044
1020
  "packages/domain/src/dto/automation/endpoint.template.request.dto.ts#EndpointRequestDto": "45a1a84e200b2cdf9b44051fe36cb7bda1b577a0f5bbcc88942764336a6d7302",
1045
1021
  "packages/domain/src/dto/automation/update.api.template.request.dto.ts#UpdateEndpointRequestDto": "20ee0c9afbfa594f189ead2b751aa00b6003efe0b70c5e1158ee78c1e0d29567",
1046
- "packages/domain/src/dto/automation/endpoint.template.request.dto.ts#EndpointOptionsDto": "acb07cc1e2c80d1721150691ea185eb3fa2f255a0833749973bf8175d85d9a32",
1022
+ "packages/domain/src/dto/automation/endpoint.template.request.dto.ts#EndpointOptionsDto": "1ade11735627613a81b5cfaa796dfdc49d4c7e0db01ae6467da6a99a9f3af683",
1047
1023
  "packages/domain/src/dto/automation/endpoint.sse.dto.ts#EndpointSseDto": "960d56ebb300ded00f61f1318522c010135675e0f32a8084fb3e9b16a1c20ecc",
1048
1024
  "packages/domain/src/dto/automation/job.template.request.dto.ts#JobTemplateRequestDto": "c47123206c187f0e16b08d7033ed9c455932f2e78e34455577663eb09410559d",
1049
1025
  "packages/domain/src/dto/automation/update.job.template.dto.ts#UpdateJobTemplate": "0f79fefc76e749a331b5c848b9dcd6061e7dc247c2094dd975d7d2fe9a101c08",
1050
- "packages/domain/src/dto/automation/run.options.dto.ts#JobOptionsDto": "6e8f3f4b7aa6d8f38bc9227ced3158e4697031e68c78be9ea0e24e5af29e37d3",
1026
+ "packages/domain/src/dto/automation/run.options.dto.ts#JobOptionsDto": "a4ee900b8610f7edbabf8d07738f99b33a288327ea0d66e67c0f8c28260215c8",
1051
1027
  "packages/domain/src/dto/automation/run.options.dto.ts#ConcurrencyJobDto": "529600772a878c5d26d55a70f5e562031169967051f5d0485ab4659a480d4a8d",
1052
1028
  "packages/domain/src/dto/automation/run.options.dto.ts#RetryJobDto": "e42fcd447fe111bdf2da20ad42654e536a01d566f33a1d8f52ec1bb0bd1ee8b1",
1053
1029
  "packages/domain/src/dto/automation/runtime.execution.policy.dto.ts#RuntimeExecutionPolicyDto": "9978ee21a9b7da26c93a4e1516dfc319166a2b55520edee9319d17922b375474",
@@ -76,6 +76,7 @@ export type DatabaseSchemaUpdatePayload = Omit<DatabaseSchemaMetadataWritePayloa
76
76
  options?: {
77
77
  indexes: Record<string, unknown>[];
78
78
  };
79
+ audit?: boolean;
79
80
  };
80
81
  export type DatabaseSchemaCreatePayload = {
81
82
  name: string;
@@ -88,7 +89,7 @@ export type DatabaseSchemaCreatePayload = {
88
89
  options?: {
89
90
  indexes: Record<string, unknown>[];
90
91
  };
91
- audit?: false;
92
+ audit?: boolean;
92
93
  restricted?: boolean;
93
94
  };
94
95
  export type DatabaseViewPreviewPayload = ({
@@ -417,7 +418,6 @@ export declare class RevoClient {
417
418
  force?: boolean;
418
419
  }): Promise<unknown>;
419
420
  listEndpoints(options?: EndpointListRequest): Promise<unknown>;
420
- findPublishedEndpoint(method: string, path: string, signal: AbortSignal): Promise<EndpointRecord | undefined>;
421
421
  listDatabaseSchemas(options?: DatabaseSchemaListRequest): Promise<unknown>;
422
422
  listAllDatabaseSchemas(options?: {
423
423
  projection?: 'thin' | 'pull';
@@ -612,6 +612,10 @@ export class RevoClient {
612
612
  stage.value = 'redirect';
613
613
  assertNoAuthenticatedRedirect(fetched);
614
614
  stage.value = 'body';
615
+ if (options.publishedRun && /^text\/event-stream(?:\s*;|$)/i.test(fetched.headers.get('content-type') ?? '')) {
616
+ await fetched.body?.cancel();
617
+ return { response: fetched, data: undefined };
618
+ }
615
619
  return { response: fetched, data: options.publishedRun
616
620
  ? Buffer.from(await fetched.arrayBuffer()) : await readResponseData(fetched) };
617
621
  }, {
@@ -726,20 +730,6 @@ export class RevoClient {
726
730
  query: options.query,
727
731
  });
728
732
  }
729
- async findPublishedEndpoint(method, path, signal) {
730
- const response = await this.requestData('GET', '/api/v1/endpoints', {
731
- query: { take: 2, filter: JSON.stringify({ and: [
732
- { field: 'deletedAt', op: 'isNull' },
733
- { field: 'deletedBy', op: 'isNull' },
734
- { field: 'active', op: 'eq', value: true },
735
- { field: 'method', op: 'eq', value: method },
736
- { field: 'path', op: 'eq', value: path },
737
- ] }) },
738
- signal, timeoutMs: 10_000, spinnerLabel: false, maxRetries: 0,
739
- });
740
- const items = unwrapList(response);
741
- return items.length === 1 && isRecord(items[0]) ? items[0] : undefined;
742
- }
743
733
  async listDatabaseSchemas(options = {}) {
744
734
  return this.requestData('GET', options.path || '/api/v1/databases', {
745
735
  query: options.query,
@@ -1,3 +1,4 @@
1
+ import { retiredLibraryOptionErrors } from "../request-contract.js";
1
2
  import { buildDebugElements, normalizeComponentType, readDebugElementKey, readDebugElementOrder, sortDebugElements } from "../component-debug-source.js";
2
3
  import { withCommandSyncOmit } from "../sync-omit-command.js";
3
4
  import { preserveOmittedProperties, syncBaselineHash, syncSourceBaselineHash, withoutSyncOmit, assertOmittedPropertiesPreserved, omitPaths } from "../sync-omit.js";
@@ -1920,7 +1921,19 @@ function resolveDebugReadOnly(cwd, flag) {
1920
1921
  }
1921
1922
  return true;
1922
1923
  }
1924
+ function resolveDebugCallStrategy(cwd, flag) {
1925
+ const configPath = path.join(getProjectRoot(cwd) || cwd, '.revoengine', 'debug.json');
1926
+ const config = fs.existsSync(configPath) ? JSON.parse(fs.readFileSync(configPath, 'utf8')) : {};
1927
+ const strategy = flag ?? config.callStrategy ?? 'caller';
1928
+ if (strategy !== 'caller' && strategy !== 'endpoints' && strategy !== 'jobs') {
1929
+ throw new Error('callStrategy / --call-strategy must be caller, endpoints or jobs.');
1930
+ }
1931
+ return strategy;
1932
+ }
1923
1933
  function buildDebugPayload(cwd, component, input) {
1934
+ const retired = retiredLibraryOptionErrors(input.inputs, 'inputs');
1935
+ if (retired.length)
1936
+ throw new Error(retired.join('\n'));
1924
1937
  const type = normalizeComponentType(component);
1925
1938
  const base = {
1926
1939
  type,
@@ -1928,6 +1941,7 @@ function buildDebugPayload(cwd, component, input) {
1928
1941
  timeout: input.timeout,
1929
1942
  memory: input.memory,
1930
1943
  readOnly: input.readOnly,
1944
+ callStrategy: input.callStrategy,
1931
1945
  ...(input.extraLibs?.length ? { extraLibs: input.extraLibs } : {}),
1932
1946
  };
1933
1947
  if (!isDebugLibraryType(type)) {
@@ -2044,6 +2058,7 @@ async function debugSingleComponent(context, componentId) {
2044
2058
  const timeout = parseDebugNumber(context.args, ['timeout', 't'], 10, 600, 'Timeout');
2045
2059
  const memory = parseDebugNumber(context.args, ['memory', 'm'], 128, 1024, 'Memory');
2046
2060
  const readOnly = resolveDebugReadOnly(context.cwd, context.args['read-only']);
2061
+ const callStrategy = resolveDebugCallStrategy(context.cwd, context.args['call-strategy']);
2047
2062
  const stream = readBoolFlag(context.args, ['stream']);
2048
2063
  const includeExtraLibs = context.args['extra-libs'] !== false
2049
2064
  && !readBoolFlag(context.args, ['no-extra-libs']);
@@ -2059,6 +2074,7 @@ async function debugSingleComponent(context, componentId) {
2059
2074
  timeout,
2060
2075
  memory,
2061
2076
  readOnly,
2077
+ callStrategy,
2062
2078
  extraLibs: extraLibs.map((entry) => entry.payload),
2063
2079
  });
2064
2080
  const endpoint = stream ? buildSandboxDebugStreamUrl(sandboxEndpoint) : buildSandboxDebugUrl(sandboxEndpoint);
@@ -171,7 +171,7 @@ async function executeDatabaseTablesCommand(context) {
171
171
  const restricted = result.diagnostics.filter((item) => (item.acl && typeof item.acl === 'object' && item.acl.restricted === true)).length;
172
172
  const tagged = result.diagnostics.filter((item) => Array.isArray(item.tags) && item.tags.length > 0).length;
173
173
  if (auditEnabled > 0 || restricted > 0 || tagged > 0) {
174
- context.println(`Diagnostics (target-local, excluded from portable hash): ${auditEnabled} audit-enabled, ${restricted} restricted, ${tagged} tagged.`);
174
+ context.println(`Source diagnostics: ${auditEnabled} audit-enabled, ${restricted} restricted, ${tagged} tagged.`);
175
175
  }
176
176
  printSyncSummary(context.println, 'Pulled', output, Date.now() - startedAt);
177
177
  }