scout_attach

Removed value: -false

Previous value: -"Open the live view (on this attach) and/or report.html (when scout_report writes it) in the user's default browser: 'live', 'report', 'both' or 'none'. Default: the SCENESCOUT_OPEN environment variable, else 'both' on a local desktop session (headed or headless) and 'none' in CI, over SSH, or with no display. Pass it only when the user asked for something other than the default."New value: +"Open the live view (on this attach) and/or report.html (when scout_report writes it) in the user's default browser: 'live', 'report', 'both' or 'none'. Default: the SCENESCOUT_OPEN environment variable, else 'both' on a local desktop session (headed or headless) and 'none' in CI, over SSH, or with no display. It can ask for less, never more: what SCENESCOUT_OPEN leaves out stays shut (SCENESCOUT_OPEN=none shuts both), and with SCENESCOUT_OPEN unset CI, SSH or no display shuts both; the result says what was not opened and why. Pass it only when the user asked for something other than the default."

Previous value: -"How this run tells a filed finding from one already recorded. Default: the SCENESCOUT_DEDUP environment variable, else 'rule', the store's rule alone. 'judge': the rule first, then, for a filing the rule keeps apart from everything recorded, a model is asked whether it is one of the open findings on its page, and merges it when it says so. It needs ANTHROPIC_API_KEY or OPENAI_API_KEY in the server's environment, and sends each pair's titles, categories and evidence, and the page's path, to that provider — ONLY when the user asked for it. Applies to every session of the project until the run ends."New value: +"How this run tells a filed finding from one already recorded. Default: the SCENESCOUT_DEDUP environment variable, else 'rule', the store's rule alone. 'judge': the rule first, then, for a filing the rule keeps apart from everything recorded, a model is asked whether it is one of the open findings on its page, and merges it when it says so. It sends each pair's titles, categories and evidence, and the page's path, to a model provider, so this argument alone does not switch it on: the person running the server does, with SCENESCOUT_DEDUP=judge and ANTHROPIC_API_KEY or OPENAI_API_KEY in the server's environment. Applies to every session of the project until the run ends."

Removed value: -"read-only"

Previous value: -"Write policy (see tool description). Never choose 'destructive' yourself — user opt-in only."New value: +"Write policy (see tool description). Default 'read-only', or the SceneScout config's maxMode when that is stricter; a mode above the config's maxMode is refused. Never choose 'destructive' yourself — user opt-in only."

Added value: +{
+  "description": "The guided plan this attach carries out, as its scout_attach call lists it. Once any guided plan is built in this server, an attach above 'observe' without an accepted plan's id is refused, and so is one above the plan's mode or on another site than the plan's, and any attach passing readPosts or trustedEmbeds. A plan's confirmation covers one check: once no session carries the plan, it must be confirmed again. Never leave it out to get round a plan's confirmation.",
+  "maxLength": 20,
+  "type": "string"
+}

Previous value: -"POST endpoints that only read, e.g. [\"POST /api/search\", \"POST https://api.example.com/reports/query\"], which observe mode then lets out — ONLY when the user named them. Never add one yourself, even when the gap ledger lists a refused POST: ask the user. Exact paths; * stands for one path segment. Still refused when the path or body looks destructive or the body is a GraphQL mutation. Observe mode only. Default: the SCENESCOUT_READ_POSTS environment variable, else none."New value: +"POST endpoints that only read, e.g. [\"POST /api/search\", \"POST https://api.example.com/reports/query\"], which observe mode then lets out — ONLY when the user named them. Never add one yourself, even when the gap ledger lists a refused POST: ask the user. Exact paths; * stands for one path segment. Still refused when the path or body looks destructive or the body is a GraphQL mutation. Observe mode only. Default: the SCENESCOUT_READ_POSTS environment variable, else none; while a guided plan is open in this server, none, and the variable is not read."

Previous value: -"Browser to drive. Default: the SCENESCOUT_BROWSER environment variable, else chromium. firefox and webkit must be downloaded first (scenescout install --browser-only --browsers firefox). Use them for a cross-browser pass; stay on chromium otherwise."New value: +"Browser to drive. Default: the SCENESCOUT_BROWSER environment variable, else chromium. A build that is not on disk is downloaded on this attach, once, except in CI or with SCENESCOUT_BROWSER_DOWNLOAD=off, where the attach names the command to run. Use firefox or webkit for a cross-browser pass; stay on chromium otherwise."

Added value: +{
+  "description": "How this run tells a filed finding from one already recorded. Default: the SCENESCOUT_DEDUP environment variable, else 'rule', the store's rule alone. 'judge': the rule first, then, for a filing the rule keeps apart from everything recorded, a model is asked whether it is one of the open findings on its page, and merges it when it says so. It needs ANTHROPIC_API_KEY or OPENAI_API_KEY in the server's environment, and sends each pair's titles, categories and evidence, and the page's path, to that provider — ONLY when the user asked for it. Applies to every session of the project until the run ends.",
+  "enum": [
+    "rule",
+    "judge"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "What happens to the picture each scout_finding takes of what it is about. 'inline': kept under .scenescout/recordings/, shown in report.html, and returned in the scout_finding result so the conversation shows it. 'file': kept and shown in the report only. 'off': none taken. Default: the SCENESCOUT_EVIDENCE environment variable, else 'inline', or 'file' in a CI job. Pictures are bounded in size and in how many one session returns (see the configuration reference).",
+  "enum": [
+    "inline",
+    "file",
+    "off"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Open the live view (on this attach) and/or report.html (when scout_report writes it) in the user's default browser: 'live', 'report', 'both' or 'none'. Default: the SCENESCOUT_OPEN environment variable, else 'both' on a local desktop session (headed or headless) and 'none' in CI, over SSH, or with no display. Pass it only when the user asked for something other than the default.",
+  "enum": [
+    "live",
+    "report",
+    "both",
+    "none"
+  ],
+  "type": "string"
+}

Previous value: -"Absolute path to the project (memory + report live in .scenescout/ here)"New value: +"Absolute path to the project (memory + report live in .scenescout/ here). Pass it whenever you have a project or working folder. Omitted: the client's workspace folder, else a folder per tested site under the user's documents folder (Documents/SceneScout/<host>/, or SCENESCOUT_PROJECTS_DIR), which the result names — tell the user where it is."

Added value: +{
+  "description": "POST endpoints that only read, e.g. [\"POST /api/search\", \"POST https://api.example.com/reports/query\"], which observe mode then lets out — ONLY when the user named them. Never add one yourself, even when the gap ledger lists a refused POST: ask the user. Exact paths; * stands for one path segment. Still refused when the path or body looks destructive or the body is a GraphQL mutation. Observe mode only. Default: the SCENESCOUT_READ_POSTS environment variable, else none.",
+  "items": {
+    "maxLength": 300,
+    "type": "string"
+  },
+  "maxItems": 20,
+  "type": "array"
+}

Removed value: -false

Previous value: -"Keep a frame of the page after every action, under .scenescout/recordings/, and show it beside that step in report.html. Off by default: a recording is pictures of the app under test sitting in the project folder. Turn it on for QA work, where the run is evidence and not only a report."New value: +"Keep a frame of the page after every action, under .scenescout/recordings/, and show it beside that step in report.html. Default: the SCENESCOUT_RECORD environment variable (on or off), else off: a recording is pictures of the app under test sitting in the project folder. Turn it on for QA work, where the run is evidence and not only a report."

Previous value: -[
-  "url",
-  "projectPath"
-]New value: +[
+  "url"
+]

Added value: +{
+  "description": "How long one click, keystroke, hover or pick may take, in ms. Default: the SCENESCOUT_ACTION_TIMEOUT_MS environment variable, else 5000. Raise it only when timeouts come from a loaded machine rather than the app.",
+  "maximum": 120000,
+  "minimum": 1000,
+  "type": "integer"
+}

Added value: +{
+  "description": "How long a page may take to load, in ms. Default: the SCENESCOUT_NAV_TIMEOUT_MS environment variable, else 20000 (crawled pages 15000; a value set here applies to them too). Raise it only when timeouts come from a loaded machine rather than the app.",
+  "maximum": 300000,
+  "minimum": 1000,
+  "type": "integer"
+}

Added value: +{
+  "description": "Sign in as a role whose login was saved with `scenescout login <url> --role <name>` (kept in the project's .scenescout/auth/). Every session given the same role gets its own browser built from that one login. Not with storageStatePath. No saved login for the role: the attach is refused and names the command to run — ask the user to run it, since it opens a window for them to sign in.",
+  "maxLength": 40,
+  "type": "string"
+}

Previous value: -"Optional Playwright storage-state JSON path for authenticated exploration"New value: +"Optional Playwright storage-state JSON path for authenticated exploration. Not with `role`."

Added value: +{
+  "description": "Origins of embedded frames (e.g. \"https://pay.example.com\") whose writes out of the app may go out — ONLY when the user named them, typically a provider in test mode, and only in safe-write mode. Never add one yourself. Hostile input, repeated-click probes and uploads stay refused in them.",
+  "items": {
+    "maxLength": 200,
+    "type": "string"
+  },
+  "maxItems": 10,
+  "type": "array"
+}

Added value: +{
+  "description": "This session's objective: the whole remit you were given, in one sentence (\"Admin lane: §2 registers, §7 plan gating\", \"Approve and reject orders as a manager\"). It sits above the task, which is what the session is doing at any moment. Shown to whoever is watching the run; worth setting whenever more than one session is live.",
+  "maxLength": 300,
+  "type": "string"
+}

Added value: +{
+  "description": "A floor between actions, in milliseconds, for when a person is watching and needs to keep up — following a flow, taking notes, demonstrating. Default 0: as fast as the page allows, which is what a run wants otherwise. Changeable mid-run with scout_session {paceMs}.",
+  "maximum": 60000,
+  "minimum": 0,
+  "type": "integer"
+}

Added value: +{
+  "default": false,
+  "description": "Keep a frame of the page after every action, under .scenescout/recordings/, and show it beside that step in report.html. Off by default: a recording is pictures of the app under test sitting in the project folder. Turn it on for QA work, where the run is evidence and not only a report.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "What this session is doing right now, shown under its objective from the moment it appears, e.g. Signing in and taking stock. Passed alone it is read as the 2.0 spelling of `objective`. Defaults to a placeholder so a fresh card never reads as idle.",
+  "maxLength": 300,
+  "type": "string"
+}

Added value: +{
+  "description": "Browser to drive. Default: the SCENESCOUT_BROWSER environment variable, else chromium. firefox and webkit must be downloaded first (scenescout install --browser-only --browsers firefox). Use them for a cross-browser pass; stay on chromium otherwise.",
+  "enum": [
+    "chromium",
+    "firefox",
+    "webkit"
+  ],
+  "type": "string"
+}