abtars 0.2.0 → 0.2.1-alpha.10

package/README.md

@@ -29,31 +29,28 @@ abTARS (agent brain)
 ## Quick Start
 
 ```bash
-npm install -g abtars
-abtars init
+npm install -g abtars@alpha abmind@alpha
+abmind install
+abtars install
+abtars update
+abtars onboard
+sudo $(which abtars) daemon install
 ```
 
-The init wizard walks you through:
-1. Telegram bot token (from [@BotFather](https://t.me/BotFather))
-2. Model provider (kiro-cli, gemini-cli, ollama, or OpenRouter)
-3. Your user ID
-
-Then start:
-
-```bash
-abtars start
-```
+Full installation guide: **[docs/wiki/install.md](docs/wiki/install.md)**
 
 ## Documentation
 
-Full docs, configuration reference, and guides: **[Wiki](https://github.com/aksika/abtars/wiki)**
+Docs live in the repo at **[docs/wiki/](docs/wiki/)** — always up to date with the code.
 
-- [Installation](https://github.com/aksika/abtars/wiki/Installation)
-- [Configuration](https://github.com/aksika/abtars/wiki/Configuration)
-- [Commands](https://github.com/aksika/abtars/wiki/Commands)
+- [Installation](docs/wiki/install.md)
+- [Configuration](docs/wiki/commands.md)
+- [Commands](docs/wiki/cli.md)
 - [Memory System (abmind)](https://github.com/aksika/abmind)
-- [Skills & Extensions](https://github.com/aksika/abtars/wiki/Skills)
-- [Deployment & Watchdog](https://github.com/aksika/abtars/wiki/Deployment)
+- [Skills & Extensions](docs/wiki/skills.md)
+- [Deployment & Supervision](docs/wiki/supervision.md)
+
+> **Note:** The [aksika.github.io](https://aksika.github.io/abtars/) site may be outdated. Always refer to the docs in this repo.
 
 ## Supported Transports
 

package/bundle/{_registry.generated-6GO2PAMD.js → _registry.generated-4P6KTBTH.js}

@@ -1,21 +1,21 @@
 #!/usr/bin/env node
  import { createRequire as __bundleCreateRequire } from 'node:module'; import { fileURLToPath as __bundleFileURLToPath } from 'node:url'; import { dirname as __bundleDirname } from 'node:path'; const require = __bundleCreateRequire(import.meta.url); const __chunk_filename = __bundleFileURLToPath(import.meta.url); const __chunk_dirname = __bundleDirname(__chunk_filename);
+import {
+  sleep_exports
+} from "./chunk-7I5C2U3C.js";
 import {
   browser_exports
-} from "./chunk-GZUQQWBZ.js";
-import "./chunk-K7P74UNQ.js";
+} from "./chunk-MNKLPRGY.js";
+import "./chunk-LDKSCXGL.js";
 import {
   hotskills_exports
 } from "./chunk-RE3F3CFW.js";
-import {
-  sleep_exports
-} from "./chunk-KWBGYWDO.js";
-import "./chunk-PQ62LZNA.js";
+import "./chunk-HEHD3GG5.js";
 import "./chunk-JAJ3DUQ2.js";
 import "./chunk-BYDUMHXT.js";
 import "./chunk-UDZIZB5F.js";
 import "./chunk-TBLYGCPQ.js";
-import "./chunk-XLLSPBBT.js";
+import "./chunk-GPL57SRN.js";
 import "./chunk-MZWMYN4O.js";
 import "./chunk-KSEIWT4T.js";
 import "./chunk-EX2SRTUE.js";
@@ -33,4 +33,4 @@ var capabilities = [
 export {
   capabilities
 };
-//# sourceMappingURL=_registry.generated-6GO2PAMD.js.map
+//# sourceMappingURL=_registry.generated-4P6KTBTH.js.map

package/bundle/_registry.generated-G2FSGHNY.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+ import { createRequire as __bundleCreateRequire } from 'node:module'; import { fileURLToPath as __bundleFileURLToPath } from 'node:url'; import { dirname as __bundleDirname } from 'node:path'; const require = __bundleCreateRequire(import.meta.url); const __chunk_filename = __bundleFileURLToPath(import.meta.url); const __chunk_dirname = __bundleDirname(__chunk_filename);
+import {
+  sleep_exports
+} from "./chunk-7I5C2U3C.js";
+import {
+  browser_exports
+} from "./chunk-KJOCXWJ5.js";
+import "./chunk-LDKSCXGL.js";
+import {
+  hotskills_exports
+} from "./chunk-RE3F3CFW.js";
+import "./chunk-HEHD3GG5.js";
+import "./chunk-JAJ3DUQ2.js";
+import "./chunk-BYDUMHXT.js";
+import "./chunk-UDZIZB5F.js";
+import "./chunk-TBLYGCPQ.js";
+import "./chunk-GPL57SRN.js";
+import "./chunk-MZWMYN4O.js";
+import "./chunk-KSEIWT4T.js";
+import "./chunk-EX2SRTUE.js";
+import "./chunk-PZE3J7ER.js";
+import "./chunk-2BY6I4P5.js";
+import "./chunk-MJ6PHMOK.js";
+import "./chunk-7K2YZTLD.js";
+
+// src/capabilities/_registry.generated.ts
+var capabilities = [
+  { name: "browser", module: browser_exports },
+  { name: "hotskills", module: hotskills_exports },
+  { name: "sleep", module: sleep_exports }
+];
+export {
+  capabilities
+};
+//# sourceMappingURL=_registry.generated-G2FSGHNY.js.map

package/bundle/_registry.generated-G2FSGHNY.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/capabilities/_registry.generated.ts"],
+  "sourcesContent": ["// AUTO-GENERATED by esbuild.config.js \u2014 do not edit\n// Static capability registry for bundled builds\n\nimport * as cap0 from \"./browser/index.js\";\nimport * as cap1 from \"./hotskills/index.js\";\nimport * as cap2 from \"./sleep/index.js\";\n\nexport const capabilities = [\n  { name: \"browser\", module: cap0 },\n  { name: \"hotskills\", module: cap1 },\n  { name: \"sleep\", module: cap2 },\n];\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;AAOO,IAAM,eAAe;AAAA,EAC1B,EAAE,MAAM,WAAW,QAAQ,gBAAK;AAAA,EAChC,EAAE,MAAM,aAAa,QAAQ,kBAAK;AAAA,EAClC,EAAE,MAAM,SAAS,QAAQ,cAAK;AAChC;",
+  "names": []
+}

package/bundle/_registry.generated-N74SMTUJ.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+ import { createRequire as __bundleCreateRequire } from 'node:module'; import { fileURLToPath as __bundleFileURLToPath } from 'node:url'; import { dirname as __bundleDirname } from 'node:path'; const require = __bundleCreateRequire(import.meta.url); const __chunk_filename = __bundleFileURLToPath(import.meta.url); const __chunk_dirname = __bundleDirname(__chunk_filename);
+import {
+  sleep_exports
+} from "./chunk-7I5C2U3C.js";
+import {
+  browser_exports
+} from "./chunk-VYR25H37.js";
+import "./chunk-LDKSCXGL.js";
+import {
+  hotskills_exports
+} from "./chunk-RE3F3CFW.js";
+import "./chunk-HEHD3GG5.js";
+import "./chunk-JAJ3DUQ2.js";
+import "./chunk-BYDUMHXT.js";
+import "./chunk-UDZIZB5F.js";
+import "./chunk-TBLYGCPQ.js";
+import "./chunk-GPL57SRN.js";
+import "./chunk-MZWMYN4O.js";
+import "./chunk-KSEIWT4T.js";
+import "./chunk-EX2SRTUE.js";
+import "./chunk-PZE3J7ER.js";
+import "./chunk-2BY6I4P5.js";
+import "./chunk-MJ6PHMOK.js";
+import "./chunk-7K2YZTLD.js";
+
+// src/capabilities/_registry.generated.ts
+var capabilities = [
+  { name: "browser", module: browser_exports },
+  { name: "hotskills", module: hotskills_exports },
+  { name: "sleep", module: sleep_exports }
+];
+export {
+  capabilities
+};
+//# sourceMappingURL=_registry.generated-N74SMTUJ.js.map

package/bundle/_registry.generated-N74SMTUJ.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/capabilities/_registry.generated.ts"],
+  "sourcesContent": ["// AUTO-GENERATED by esbuild.config.js \u2014 do not edit\n// Static capability registry for bundled builds\n\nimport * as cap0 from \"./browser/index.js\";\nimport * as cap1 from \"./hotskills/index.js\";\nimport * as cap2 from \"./sleep/index.js\";\n\nexport const capabilities = [\n  { name: \"browser\", module: cap0 },\n  { name: \"hotskills\", module: cap1 },\n  { name: \"sleep\", module: cap2 },\n];\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;AAOO,IAAM,eAAe;AAAA,EAC1B,EAAE,MAAM,WAAW,QAAQ,gBAAK;AAAA,EAChC,EAAE,MAAM,aAAa,QAAQ,kBAAK;AAAA,EAClC,EAAE,MAAM,SAAS,QAAQ,cAAK;AAChC;",
+  "names": []
+}

package/bundle/_registry.generated-Y4VT5MBX.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+ import { createRequire as __bundleCreateRequire } from 'node:module'; import { fileURLToPath as __bundleFileURLToPath } from 'node:url'; import { dirname as __bundleDirname } from 'node:path'; const require = __bundleCreateRequire(import.meta.url); const __chunk_filename = __bundleFileURLToPath(import.meta.url); const __chunk_dirname = __bundleDirname(__chunk_filename);
+import {
+  sleep_exports
+} from "./chunk-7I5C2U3C.js";
+import {
+  browser_exports
+} from "./chunk-O73EZGKR.js";
+import "./chunk-LDKSCXGL.js";
+import {
+  hotskills_exports
+} from "./chunk-RE3F3CFW.js";
+import "./chunk-HEHD3GG5.js";
+import "./chunk-JAJ3DUQ2.js";
+import "./chunk-BYDUMHXT.js";
+import "./chunk-UDZIZB5F.js";
+import "./chunk-TBLYGCPQ.js";
+import "./chunk-GPL57SRN.js";
+import "./chunk-MZWMYN4O.js";
+import "./chunk-KSEIWT4T.js";
+import "./chunk-EX2SRTUE.js";
+import "./chunk-PZE3J7ER.js";
+import "./chunk-2BY6I4P5.js";
+import "./chunk-MJ6PHMOK.js";
+import "./chunk-7K2YZTLD.js";
+
+// src/capabilities/_registry.generated.ts
+var capabilities = [
+  { name: "browser", module: browser_exports },
+  { name: "hotskills", module: hotskills_exports },
+  { name: "sleep", module: sleep_exports }
+];
+export {
+  capabilities
+};
+//# sourceMappingURL=_registry.generated-Y4VT5MBX.js.map

package/bundle/_registry.generated-Y4VT5MBX.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/capabilities/_registry.generated.ts"],
+  "sourcesContent": ["// AUTO-GENERATED by esbuild.config.js \u2014 do not edit\n// Static capability registry for bundled builds\n\nimport * as cap0 from \"./browser/index.js\";\nimport * as cap1 from \"./hotskills/index.js\";\nimport * as cap2 from \"./sleep/index.js\";\n\nexport const capabilities = [\n  { name: \"browser\", module: cap0 },\n  { name: \"hotskills\", module: cap1 },\n  { name: \"sleep\", module: cap2 },\n];\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;AAOO,IAAM,eAAe;AAAA,EAC1B,EAAE,MAAM,WAAW,QAAQ,gBAAK;AAAA,EAChC,EAAE,MAAM,aAAa,QAAQ,kBAAK;AAAA,EAClC,EAAE,MAAM,SAAS,QAAQ,cAAK;AAChC;",
+  "names": []
+}

package/bundle/abtars-browser.js

@@ -1,4 +1,3 @@
-#!/usr/bin/env node
 #!/usr/bin/env node
  import { createRequire as __bundleCreateRequire } from 'node:module'; import { fileURLToPath as __bundleFileURLToPath } from 'node:url'; import { dirname as __bundleDirname } from 'node:path'; const require = __bundleCreateRequire(import.meta.url); const __chunk_filename = __bundleFileURLToPath(import.meta.url); const __chunk_dirname = __bundleDirname(__chunk_filename);
 import {

package/bundle/abtars-browser.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/cli/abtars-browser.ts"],
-  "sourcesContent": ["#!/usr/bin/env node\n/**\n * abtars-browser \u2014 standalone CLI for agent-initiated browser control.\n *\n * Gives the LLM agent direct control over a headless Chromium browser.\n * Follows the same pattern as abmind recall and abmind store.\n *\n * Usage:\n *   abtars-browser --action navigate --url \"https://example.com\" --session-id default\n *   abtars-browser --action fill --selector \"#email\" --value \"user@example.com\" --session-id auth\n *   abtars-browser --action click --selector \"text=Sign In\" --session-id auth\n *   abtars-browser --action extract_text --session-id auth\n *   abtars-browser --action screenshot --full-page --session-id auth\n *   abtars-browser --action get_page_info --session-id auth\n *   abtars-browser --action close_session --session-id auth\n *\n * Output (success):\n *   { \"success\": true, \"title\": \"Example\", \"url\": \"https://example.com\", \"status\": 200 }\n *\n * Output (error):\n *   { \"success\": false, \"error\": \"navigate action requires --url\" }\n */\n\nimport * as net from \"node:net\";\nimport * as fs from \"node:fs\";\nimport type { BrowserAction, BrowserActionType, BrowserToolResult } from \"../types/browser.js\";\nimport { BrowserManager } from \"../capabilities/browser/browser-manager.js\";\nimport { BrowserTool } from \"../capabilities/browser/browser-tool.js\";\nimport { DomainAllowlist } from \"../capabilities/browser/domain-allowlist.js\";\nimport { getDefaultSocketPath } from \"../capabilities/browser/browser-ipc-server.js\";\n\n/** The 7 valid browser action types. */\nconst VALID_ACTIONS: ReadonlySet<string> = new Set<BrowserActionType>([\n  \"navigate\",\n  \"click\",\n  \"fill\",\n  \"extract_text\",\n  \"screenshot\",\n  \"get_page_info\",\n  \"close_session\",\n  \"set_cookie\",\n]);\n\nexport type RawBrowserArgs = {\n  action?: string;\n  url?: string;\n  selector?: string;\n  value?: string;\n  sessionId: string;\n  fullPage: boolean;\n  cookieFile?: string;\n  engine?: string;\n};\n\n/**\n * Parse raw CLI argv into a RawBrowserArgs object.\n * Exported for unit testing.\n */\nexport function parseArgs(argv: string[]): RawBrowserArgs {\n  const args = argv.slice(2);\n  const parsed: RawBrowserArgs = { sessionId: \"default\", fullPage: false };\n\n  for (let i = 0; i < args.length; i++) {\n    switch (args[i]) {\n      case \"--action\":     parsed.action = args[++i] ?? \"\"; break;\n      case \"--url\":        parsed.url = args[++i] ?? \"\"; break;\n      case \"--selector\":   parsed.selector = args[++i] ?? \"\"; break;\n      case \"--value\":      parsed.value = args[++i] ?? \"\"; break;\n      case \"--session-id\": parsed.sessionId = args[++i] ?? \"default\"; break;\n      case \"--full-page\":  parsed.fullPage = true; break;\n      case \"--cookie-file\": parsed.cookieFile = args[++i] ?? \"\"; break;\n      case \"--engine\":     parsed.engine = args[++i] ?? \"\"; break;\n    }\n  }\n\n  return parsed;\n}\n\n/**\n * Validate raw CLI arguments and return either a parsed BrowserAction or an error string.\n * Exported for unit testing.\n */\nexport function validateArgs(\n  raw: RawBrowserArgs,\n): { ok: true; action: BrowserAction; raw: RawBrowserArgs } | { ok: false; error: string } {\n  // Validate action is one of the 7 valid types\n  if (!raw.action) {\n    return { ok: false, error: \"--action is required\" };\n  }\n  if (!VALID_ACTIONS.has(raw.action)) {\n    return {\n      ok: false,\n      error: `Invalid action \"${raw.action}\". Valid actions: ${[...VALID_ACTIONS].join(\", \")}`,\n    };\n  }\n\n  const actionType = raw.action as BrowserActionType;\n\n  // Validate required params per action\n  switch (actionType) {\n    case \"navigate\":\n      if (!raw.url) return { ok: false, error: \"navigate action requires --url\" };\n      break;\n    case \"click\":\n      if (!raw.selector) return { ok: false, error: \"click action requires --selector\" };\n      break;\n    case \"fill\":\n      if (!raw.selector) return { ok: false, error: \"fill action requires --selector\" };\n      if (raw.value === undefined) return { ok: false, error: \"fill action requires --value\" };\n      break;\n    case \"set_cookie\":\n      if (!raw.cookieFile) return { ok: false, error: \"set_cookie action requires --cookie-file\" };\n      break;\n    // extract_text, screenshot, get_page_info, close_session have no extra required params\n  }\n\n  return {\n    ok: true,\n    raw,\n    action: {\n      action: actionType,\n      sessionId: raw.sessionId,\n      url: raw.url,\n      selector: raw.selector,\n      value: raw.value,\n      fullPage: raw.fullPage,\n      cookieFile: raw.cookieFile,\n    },\n  };\n}\n\n// --- CLI entry point (only runs when executed directly) ---\n\n/**\n * Try executing the action via the main process IPC socket.\n * Returns null if socket unavailable (caller should fall back to ephemeral).\n */\nexport function executeViaIpc(\n  action: BrowserAction,\n  socketPath?: string,\n): Promise<BrowserToolResult | null> {\n  const sock = socketPath ?? getDefaultSocketPath();\n\n  if (!fs.existsSync(sock)) return Promise.resolve(null);\n\n  return new Promise<BrowserToolResult | null>((resolve) => {\n    const conn = net.createConnection(sock, () => {\n      conn.end(JSON.stringify(action) + \"\\n\");\n    });\n\n    let data = \"\";\n    conn.on(\"data\", (chunk) => { data += chunk.toString(); });\n\n    conn.on(\"end\", () => {\n      try {\n        resolve(JSON.parse(data.trim()) as BrowserToolResult);\n      } catch {\n        resolve(null);\n      }\n    });\n\n    conn.on(\"error\", () => resolve(null));\n\n    // Don't hang forever if main process is stuck.\n    conn.setTimeout(60_000, () => {\n      conn.destroy();\n      resolve(null);\n    });\n  });\n}\n\nasync function main() {\n  const raw = parseArgs(process.argv);\n  const validation = validateArgs(raw);\n\n  if (!validation.ok) {\n    console.log(JSON.stringify({ success: false, error: validation.error }));\n    process.exit(1);\n  }\n\n  // Try IPC to main process first (sessions persist across calls).\n  const ipcResult = await executeViaIpc(validation.action);\n  if (ipcResult !== null) {\n    console.log(JSON.stringify(ipcResult));\n    return;\n  }\n\n  // Fallback: ephemeral browser (no session persistence).\n  if (validation.raw.engine) process.env[\"BROWSER_ENGINE\"] = validation.raw.engine;\n  else if (!process.env[\"BROWSER_ENGINE\"]) process.env[\"BROWSER_ENGINE\"] = \"patchright\";\n  const browserManager = new BrowserManager();\n  const allowlist = DomainAllowlist.fromEnv();\n  const tool = new BrowserTool(browserManager, allowlist);\n\n  try {\n    const result = await tool.execute(validation.action);\n    console.log(JSON.stringify(result));\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    console.log(JSON.stringify({ success: false, error: message }));\n  } finally {\n    await browserManager.shutdown();\n  }\n}\n\n// Only run when executed as a script, not when imported for testing\nconst isDirectRun =\n  process.argv[1]?.endsWith(\"abtars-browser.ts\") ||\n  process.argv[1]?.endsWith(\"abtars-browser.js\");\nif (isDirectRun) {\n  main();\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * abtars-browser \u2014 standalone CLI for agent-initiated browser control.\n *\n * Gives the LLM agent direct control over a headless Chromium browser.\n * Follows the same pattern as abmind recall and abmind store.\n *\n * Usage:\n *   abtars-browser --action navigate --url \"https://example.com\" --session-id default\n *   abtars-browser --action fill --selector \"#email\" --value \"user@example.com\" --session-id auth\n *   abtars-browser --action click --selector \"text=Sign In\" --session-id auth\n *   abtars-browser --action extract_text --session-id auth\n *   abtars-browser --action screenshot --full-page --session-id auth\n *   abtars-browser --action get_page_info --session-id auth\n *   abtars-browser --action close_session --session-id auth\n *\n * Output (success):\n *   { \"success\": true, \"title\": \"Example\", \"url\": \"https://example.com\", \"status\": 200 }\n *\n * Output (error):\n *   { \"success\": false, \"error\": \"navigate action requires --url\" }\n */\n\nimport * as net from \"node:net\";\nimport * as fs from \"node:fs\";\nimport type { BrowserAction, BrowserActionType, BrowserToolResult } from \"../types/browser.js\";\nimport { BrowserManager } from \"../capabilities/browser/browser-manager.js\";\nimport { BrowserTool } from \"../capabilities/browser/browser-tool.js\";\nimport { DomainAllowlist } from \"../capabilities/browser/domain-allowlist.js\";\nimport { getDefaultSocketPath } from \"../capabilities/browser/browser-ipc-server.js\";\n\n/** The 7 valid browser action types. */\nconst VALID_ACTIONS: ReadonlySet<string> = new Set<BrowserActionType>([\n  \"navigate\",\n  \"click\",\n  \"fill\",\n  \"extract_text\",\n  \"screenshot\",\n  \"get_page_info\",\n  \"close_session\",\n  \"set_cookie\",\n]);\n\nexport type RawBrowserArgs = {\n  action?: string;\n  url?: string;\n  selector?: string;\n  value?: string;\n  sessionId: string;\n  fullPage: boolean;\n  cookieFile?: string;\n  engine?: string;\n};\n\n/**\n * Parse raw CLI argv into a RawBrowserArgs object.\n * Exported for unit testing.\n */\nexport function parseArgs(argv: string[]): RawBrowserArgs {\n  const args = argv.slice(2);\n  const parsed: RawBrowserArgs = { sessionId: \"default\", fullPage: false };\n\n  for (let i = 0; i < args.length; i++) {\n    switch (args[i]) {\n      case \"--action\":     parsed.action = args[++i] ?? \"\"; break;\n      case \"--url\":        parsed.url = args[++i] ?? \"\"; break;\n      case \"--selector\":   parsed.selector = args[++i] ?? \"\"; break;\n      case \"--value\":      parsed.value = args[++i] ?? \"\"; break;\n      case \"--session-id\": parsed.sessionId = args[++i] ?? \"default\"; break;\n      case \"--full-page\":  parsed.fullPage = true; break;\n      case \"--cookie-file\": parsed.cookieFile = args[++i] ?? \"\"; break;\n      case \"--engine\":     parsed.engine = args[++i] ?? \"\"; break;\n    }\n  }\n\n  return parsed;\n}\n\n/**\n * Validate raw CLI arguments and return either a parsed BrowserAction or an error string.\n * Exported for unit testing.\n */\nexport function validateArgs(\n  raw: RawBrowserArgs,\n): { ok: true; action: BrowserAction; raw: RawBrowserArgs } | { ok: false; error: string } {\n  // Validate action is one of the 7 valid types\n  if (!raw.action) {\n    return { ok: false, error: \"--action is required\" };\n  }\n  if (!VALID_ACTIONS.has(raw.action)) {\n    return {\n      ok: false,\n      error: `Invalid action \"${raw.action}\". Valid actions: ${[...VALID_ACTIONS].join(\", \")}`,\n    };\n  }\n\n  const actionType = raw.action as BrowserActionType;\n\n  // Validate required params per action\n  switch (actionType) {\n    case \"navigate\":\n      if (!raw.url) return { ok: false, error: \"navigate action requires --url\" };\n      break;\n    case \"click\":\n      if (!raw.selector) return { ok: false, error: \"click action requires --selector\" };\n      break;\n    case \"fill\":\n      if (!raw.selector) return { ok: false, error: \"fill action requires --selector\" };\n      if (raw.value === undefined) return { ok: false, error: \"fill action requires --value\" };\n      break;\n    case \"set_cookie\":\n      if (!raw.cookieFile) return { ok: false, error: \"set_cookie action requires --cookie-file\" };\n      break;\n    // extract_text, screenshot, get_page_info, close_session have no extra required params\n  }\n\n  return {\n    ok: true,\n    raw,\n    action: {\n      action: actionType,\n      sessionId: raw.sessionId,\n      url: raw.url,\n      selector: raw.selector,\n      value: raw.value,\n      fullPage: raw.fullPage,\n      cookieFile: raw.cookieFile,\n    },\n  };\n}\n\n// --- CLI entry point (only runs when executed directly) ---\n\n/**\n * Try executing the action via the main process IPC socket.\n * Returns null if socket unavailable (caller should fall back to ephemeral).\n */\nexport function executeViaIpc(\n  action: BrowserAction,\n  socketPath?: string,\n): Promise<BrowserToolResult | null> {\n  const sock = socketPath ?? getDefaultSocketPath();\n\n  if (!fs.existsSync(sock)) return Promise.resolve(null);\n\n  return new Promise<BrowserToolResult | null>((resolve) => {\n    const conn = net.createConnection(sock, () => {\n      conn.end(JSON.stringify(action) + \"\\n\");\n    });\n\n    let data = \"\";\n    conn.on(\"data\", (chunk) => { data += chunk.toString(); });\n\n    conn.on(\"end\", () => {\n      try {\n        resolve(JSON.parse(data.trim()) as BrowserToolResult);\n      } catch {\n        resolve(null);\n      }\n    });\n\n    conn.on(\"error\", () => resolve(null));\n\n    // Don't hang forever if main process is stuck.\n    conn.setTimeout(60_000, () => {\n      conn.destroy();\n      resolve(null);\n    });\n  });\n}\n\nasync function main() {\n  const raw = parseArgs(process.argv);\n  const validation = validateArgs(raw);\n\n  if (!validation.ok) {\n    console.log(JSON.stringify({ success: false, error: validation.error }));\n    process.exit(1);\n  }\n\n  // Try IPC to main process first (sessions persist across calls).\n  const ipcResult = await executeViaIpc(validation.action);\n  if (ipcResult !== null) {\n    console.log(JSON.stringify(ipcResult));\n    return;\n  }\n\n  // Fallback: ephemeral browser (no session persistence).\n  if (validation.raw.engine) process.env[\"BROWSER_ENGINE\"] = validation.raw.engine;\n  else if (!process.env[\"BROWSER_ENGINE\"]) process.env[\"BROWSER_ENGINE\"] = \"patchright\";\n  const browserManager = new BrowserManager();\n  const allowlist = DomainAllowlist.fromEnv();\n  const tool = new BrowserTool(browserManager, allowlist);\n\n  try {\n    const result = await tool.execute(validation.action);\n    console.log(JSON.stringify(result));\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    console.log(JSON.stringify({ success: false, error: message }));\n  } finally {\n    await browserManager.shutdown();\n  }\n}\n\n// Only run when executed as a script, not when imported for testing\nconst isDirectRun =\n  process.argv[1]?.endsWith(\"abtars-browser.ts\") ||\n  process.argv[1]?.endsWith(\"abtars-browser.js\");\nif (isDirectRun) {\n  main();\n}\n"],
+  "mappings": "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",
   "names": []
 }