@ai-digital-factory/lmt-web-cli 0.1.0 → 0.1.2

package/README.md

@@ -5,6 +5,67 @@ browser interaction with the configured local or dev Live Market Terminal Web UR
 keeps browser dependencies and session lifetime out of the browser-free `lmt`
 HTTP CLI.
 
+## Agent guide (Dev only)
+
+Agents working with a deployed Live Market Terminal must use the **Dev** environment.
+Do not target production. The examples here use the published CLI through `npx` and
+open a headless desktop browser by default.
+
+Install Chromium once on the machine that will own the browser session:
+
+```sh
+npx --yes @ai-digital-factory/lmt-web-cli@latest install-browser
+```
+
+If Operator login needs the Gate Operator Directory, provision this CLI's SMS read
+credential once from a secure input source. The Web CLI keeps its credential
+separately from `lmt-cli` and does not use profiles:
+
+```sh
+npx --yes @ai-digital-factory/lmt-web-cli@latest credential provision --env dev --credential-stdin
+```
+
+Start a fresh desktop session against Dev and keep the returned `sessionId` for every
+later command:
+
+```sh
+npx --yes @ai-digital-factory/lmt-web-cli@latest start --env dev --device desktop
+```
+
+The session starts on the Home Page. Use the same session to log into the Operator;
+if a Zerodha login is required, start that flow and submit the current OTP through
+standard input only, using the `attemptId` returned by `zerodha-login`:
+
+```sh
+npx --yes @ai-digital-factory/lmt-web-cli@latest operator-login --session SESSION_ID
+npx --yes @ai-digital-factory/lmt-web-cli@latest zerodha-login --session SESSION_ID
+npx --yes @ai-digital-factory/lmt-web-cli@latest zerodha-otp --session SESSION_ID --attempt ATTEMPT_ID --stdin
+```
+
+The user supplies the OTP for the active attempt. Never put it in a command-line
+argument or ask the CLI to retrieve it. Inspect the latest JSON result after each
+command. Control references are short-lived: every new observation or action returns
+fresh references, so use only references from the most recent result.
+
+For example, to add an instrument to Market Watch, inspect the page, select `NSE`
+in an empty row, enter the symbol, then apply that row. Use the current row's control
+references from each immediately preceding result. `Apply` configures the Market
+Watch row; it does not submit a trade.
+
+Each command returns JSON with the page state and screenshot path. Review the result
+before continuing, especially if an action is `uncertain`; inspect the page instead
+of repeating that action automatically. When finished, stop only the session you
+started:
+
+```sh
+npx --yes @ai-digital-factory/lmt-web-cli@latest stop --session SESSION_ID
+```
+
+Stopping releases the browser process but does not log out the Operator or stop
+Broker activity. The CLI also supports `inspect`, `click`, `fill`, `select`, and
+`navigate`; run `npx --yes @ai-digital-factory/lmt-web-cli@latest --help` for the
+complete command list.
+
 ## Install
 
 Requires Node.js 22 or later, Chromium, and a macOS or Linux session owner.
@@ -83,7 +144,9 @@ are written to unique absolute paths in an owner-only temporary directory;
 screenshots preserve the rendered page without added blur or masking. Field values
 are omitted from JSON observations. Captures wait for document loading, visible
 session-loading or busy indicators, fonts, visible images, and finite animations
-to finish. Infinite animations do not block capture. `--timeout` sets one deadline for the command's browser action and
+to finish. The page must render text, controls, or visual content; an empty app
+root is not ready. Pages that remain empty reach the command deadline without a
+captured screenshot. Infinite animations do not block capture. `--timeout` sets one deadline for the command's browser action and
 screenshot, from `1ms` through `10m`. If an operation exceeds it, the session is
 closed. Action failures return nonzero; invalid commands and targets return exit code 2.
 The JSON `error.code` is machine-readable:

package/dist/index.js

@@ -1854,7 +1854,10 @@ async function waitForRenderedPage(page) {
         (animation) => (animation.pending || animation.playState === "running") && Number.isFinite(Number(animation.effect?.getComputedTiming().endTime))
       );
       const imagesPending = Array.from(document.images).some((image) => visible(image) && !image.complete);
-      return document.readyState === "complete" && document.fonts.status === "loaded" && !!document.body && !loading && !animating && !imagesPending;
+      const hasContent = !!document.body?.innerText.trim() || Array.from(
+        document.querySelectorAll('button, a[href], input:not([type="hidden"]), select, textarea, canvas, svg, img, video, iframe')
+      ).some(visible);
+      return document.readyState === "complete" && document.fonts.status === "loaded" && hasContent && !loading && !animating && !imagesPending;
     });
     if (ready && settled) return;
     settled = ready;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-digital-factory/lmt-web-cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "bin": {
     "lmt-web": "dist/index.js"