@crouton-kit/capture 1.4.25 → 1.4.26

package/bin/capture

@@ -10174,7 +10174,8 @@ function resolveCliContext(parsed) {
       parsed.target = session.targetId;
       parsed.targetSource = "session";
     }
-    if (parsed.port === void 0 && session.port !== void 0 && session.port !== null) {
+    const discoveringEndpoints = parsed.command === "tab" && parsed.positional[0] === "list";
+    if (parsed.port === void 0 && !discoveringEndpoints && session.port !== void 0 && session.port !== null) {
       parsed.port = session.port;
       parsed.portSource = "session";
     }
@@ -10944,7 +10945,7 @@ function validateHarAppendBatch(value, source) {
   return { entries, incompleteLifecycles };
 }
 function captureVersion() {
-  const version = "1.4.25";
+  const version = "1.4.26";
   return typeof version === "string" && version.length > 0 ? version : "development";
 }
 function token() {
@@ -13046,7 +13047,7 @@ function wallTime(value) {
   }
 }
 function captureVersion2() {
-  const version = "1.4.25";
+  const version = "1.4.26";
   return typeof version === "string" && version.length > 0 ? version : "development";
 }
 function deepFreeze(value) {
@@ -230583,7 +230584,7 @@ var init_list = __esm({
     USAGE11 = `capture tab list \u2014 discover CDP endpoints and list the page tabs on each.
 
 input:
-  --port <port>   probe one endpoint only, instead of discovering every localhost CDP endpoint
+  --port <port>   probe one endpoint only, instead of discovering every localhost CDP endpoint; an active session's endpoint does not narrow it (CDP_PORT still pins one endpoint)
 
 output: <tabs endpoints=\u2026 tabs=\u2026> \u2014 one section per reachable endpoint (port, app, page-tab count, preferred marker, and a capture-owned pid marker on any browser \`tab launch\` started) listing each page tab's target id (first 8 chars, enough for --target), title, and url; an endpoint that failed the tab fetch is an endpoints-unreachable fact, never a silent omission.
 effects: probes local CDP endpoints over HTTP/WebSocket; no page-observable writes. Also sweeps capture-launched browsers, stopping any that have exited, stopped answering CDP, or gone idle \u2014 browsers capture did not start are never signalled.`;
@@ -267595,7 +267596,7 @@ I/O contract: flags and positionals on input; one rendered prose block on stdout
 A CDP-enabled browser must be running; \`capture tab list\` is the probe, and \`capture tab launch\` starts one capture owns and reaps when nothing is (never hand-roll a detached browser \u2014 nothing reaps that). Capture never signals a browser it did not start, so attaching to your own with --port is unchanged. CDP_PORT / CDP_TARGET pin the browser + tab for target-selecting commands \u2014 precedence: explicit flag > active session > env. \`session start\` adopts only an explicit --target. When CRTR_NODE_ID is set (a crtr agent node), a browser command with no --port, no --target and no active session of that node is refused instead of falling back to CDP_PORT, CDP_TARGET or localhost discovery, because the browser found could belong to another node: run \`capture session start --url <url>\`, or pass --port or --target. \`capture tab list\` and commands that only read a recorded artifact are not refused.`;
 }
 function printVersion() {
-  const declared = "1.4.25";
+  const declared = "1.4.26";
   if (declared) {
     console.log(declared);
     return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crouton-kit/capture",
-  "version": "1.4.25",
+  "version": "1.4.26",
   "description": "Browser automation and UI validation via CDP — session-based screenshots, HAR, a11y, click/type, and JS exec",
   "bin": {
     "capture": "./bin/capture"

package/src/cdp/args.ts

@@ -625,7 +625,10 @@ export function resolveCliContext(parsed: ParsedArgs): ParsedArgs {
     // A session target is inseparable from the endpoint that created it.
     // Prefer that endpoint over ambient CDP_PORT, but retain an explicit
     // --port override for deliberate multi-browser work.
-    if (parsed.port === undefined && session.port !== undefined && session.port !== null) { parsed.port = session.port; parsed.portSource = 'session'; }
+    // `tab list` is the discovery probe: without --port it lists every
+    // localhost endpoint, so the session's endpoint must not narrow it.
+    const discoveringEndpoints = parsed.command === 'tab' && parsed.positional[0] === 'list';
+    if (parsed.port === undefined && !discoveringEndpoints && session.port !== undefined && session.port !== null) { parsed.port = session.port; parsed.portSource = 'session'; }
   }
   refuseUnownedEndpoint(parsed, sessionStart);
   if (parsed.port === undefined && process.env.CDP_PORT !== undefined) {

package/src/cdp/commands/tab/list.ts

@@ -30,7 +30,7 @@ import {
 const USAGE = `capture tab list — discover CDP endpoints and list the page tabs on each.
 
 input:
-  --port <port>   probe one endpoint only, instead of discovering every localhost CDP endpoint
+  --port <port>   probe one endpoint only, instead of discovering every localhost CDP endpoint; an active session's endpoint does not narrow it (CDP_PORT still pins one endpoint)
 
 output: <tabs endpoints=… tabs=…> — one section per reachable endpoint (port, app, page-tab count, preferred marker, and a capture-owned pid marker on any browser \`tab launch\` started) listing each page tab's target id (first 8 chars, enough for --target), title, and url; an endpoint that failed the tab fetch is an endpoints-unreachable fact, never a silent omission.
 effects: probes local CDP endpoints over HTTP/WebSocket; no page-observable writes. Also sweeps capture-launched browsers, stopping any that have exited, stopped answering CDP, or gone idle — browsers capture did not start are never signalled.`;