@liyuera/dsh-chrome-browser 0.6.8 → 0.7.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 (58) hide show
  1. package/README.md +35 -10
  2. package/extension/manifest.json +1 -1
  3. package/extension/service-worker.js +107 -3
  4. package/lib/activity.d.ts +0 -1
  5. package/lib/activity.js +1 -6
  6. package/lib/activity.js.map +1 -1
  7. package/lib/backend-registry.d.ts +56 -0
  8. package/lib/backend-registry.js +120 -0
  9. package/lib/backend-registry.js.map +1 -0
  10. package/lib/backend.d.ts +20 -1
  11. package/lib/backend.d.ts.map +1 -1
  12. package/lib/backend.js +48 -7
  13. package/lib/backend.js.map +1 -1
  14. package/lib/bridge.d.ts +0 -1
  15. package/lib/bridge.js +2 -2
  16. package/lib/caller.d.ts +9 -0
  17. package/lib/caller.js +17 -0
  18. package/lib/caller.js.map +1 -0
  19. package/lib/cdp.d.ts +0 -1
  20. package/lib/cdp.js.map +1 -1
  21. package/lib/chrome.d.ts +46 -5
  22. package/lib/chrome.d.ts.map +1 -1
  23. package/lib/chrome.js +94 -23
  24. package/lib/chrome.js.map +1 -1
  25. package/lib/console-events.d.ts +0 -1
  26. package/lib/console-log.d.ts +0 -1
  27. package/lib/console-log.js.map +1 -1
  28. package/lib/expressions.d.ts +0 -1
  29. package/lib/extension-package.d.ts +0 -1
  30. package/lib/help.d.ts +0 -1
  31. package/lib/index.d.ts +14 -3
  32. package/lib/index.d.ts.map +1 -1
  33. package/lib/index.js +39 -26
  34. package/lib/index.js.map +1 -1
  35. package/lib/invariant.d.ts +0 -1
  36. package/lib/local-server.d.ts +0 -1
  37. package/lib/mentions.d.ts +0 -1
  38. package/lib/mentions.js +3 -2
  39. package/lib/mentions.js.map +1 -1
  40. package/lib/message-source.d.ts +0 -1
  41. package/lib/ports.d.ts +13 -0
  42. package/lib/ports.js +20 -0
  43. package/lib/ports.js.map +1 -0
  44. package/lib/presentation.d.ts +0 -1
  45. package/lib/routes.d.ts +0 -1
  46. package/lib/routes.js +3 -3
  47. package/lib/routes.js.map +1 -1
  48. package/lib/skill.d.ts +0 -1
  49. package/lib/skill.d.ts.map +1 -1
  50. package/lib/skill.js +36 -13
  51. package/lib/skill.js.map +1 -1
  52. package/lib/text.d.ts +0 -1
  53. package/lib/tools.d.ts +8 -4
  54. package/lib/tools.d.ts.map +1 -1
  55. package/lib/tools.js +142 -27
  56. package/lib/tools.js.map +1 -1
  57. package/lib/ws.d.ts +0 -1
  58. package/package.json +5 -2
package/lib/ports.js ADDED
@@ -0,0 +1,20 @@
1
+ /**
2
+ * Fixed-increment debug-port allocation with reuse. Never uses an OS ephemeral
3
+ * port (Chrome 151 no longer writes DevToolsActivePort for a dedicated profile),
4
+ * so the port is always a concrete number the CDP HTTP endpoint can bind.
5
+ * @module @liyuera/dsh-chrome-browser/ports
6
+ */
7
+ export class PortAllocator {
8
+ next;
9
+ free = [];
10
+ constructor(basePort) {
11
+ this.next = basePort;
12
+ }
13
+ allocate() {
14
+ return this.free.pop() ?? this.next++;
15
+ }
16
+ release(port) {
17
+ this.free.push(port);
18
+ }
19
+ }
20
+ //# sourceMappingURL=ports.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ports.js","sourceRoot":"","sources":["../src/ports.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IAChB,IAAI,CAAQ;IACH,IAAI,GAAa,EAAE,CAAA;IAEpC,YAAY,QAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAA;IACtB,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAA;IACvC,CAAC;IAED,OAAO,CAAC,IAAY;QAClB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACtB,CAAC;CACF"}
@@ -140,4 +140,3 @@ export declare function consoleCall(args: {
140
140
  }): GenericCallView;
141
141
  /** `chrome_console` completed card: the lifecycle result, or the entries read. */
142
142
  export declare function consoleResult(outcome: ToolResult): GenericResultView | undefined;
143
- //# sourceMappingURL=presentation.d.ts.map
package/lib/routes.d.ts CHANGED
@@ -54,4 +54,3 @@ export declare function registerExtensionRoutes(carrier: RouteCarrier, backend:
54
54
  * @param bridge - fixed-port bridge state reported by the extension status route.
55
55
  */
56
56
  export declare function registerChromeRoutes(ctx: Context, backend: BrowserBackend, screenshotDir: string, activity: ActivityTracker, bridge?: BridgeReport): void;
57
- //# sourceMappingURL=routes.d.ts.map
package/lib/routes.js CHANGED
@@ -11,11 +11,11 @@
11
11
  * port and cannot discover an OS-assigned one.
12
12
  * @module @liyuera/dsh-chrome-browser/routes
13
13
  */
14
- import { ExtensionBackend } from "./backend.js";
14
+ import { ExtensionBackend } from './backend.js';
15
15
  import { mkdirSync, writeFileSync } from 'node:fs';
16
16
  import { dirname, join } from 'node:path';
17
- import { createExtensionZip, extensionDir } from "./extension-package.js";
18
- import { wsHandshake } from "./ws.js";
17
+ import { createExtensionZip, extensionDir } from './extension-package.js';
18
+ import { wsHandshake } from './ws.js';
19
19
  /** JSON response writer. */
20
20
  export function writeJson(res, status, value) {
21
21
  const body = JSON.stringify(value);
package/lib/routes.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"routes.js","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEzC,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAEzE,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAkBrC,4BAA4B;AAC5B,MAAM,UAAU,SAAS,CAAC,GAAmB,EAAE,MAAc,EAAE,KAAc;IAC3E,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IAClC,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAA;IAC7D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;AACf,CAAC;AAED,oEAAoE;AACpE,SAAS,cAAc,CAAC,OAAuB;IAC7C,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;QAC3B,IAAI,CAAC,CAAC,OAAO,YAAY,gBAAgB,CAAC,EAAE,CAAC;YAC3C,MAAM,CAAC,OAAO,EAAE,CAAA;YAChB,OAAM;QACR,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC;YAAE,OAAM;QACrC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;QAC5B,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAC5C,CAAC,CAAA;AACH,CAAC;AAED,sFAAsF;AACtF,SAAS,aAAa,CAAC,aAAqB;IAC1C,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACxB,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC1B,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC,CAAA;YAC/D,OAAM;QACR,CAAC;QACD,MAAM,MAAM,GAAa,EAAE,CAAA;QAC3B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG;YAAE,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,CAAA;QAC3D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QACpC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,CAAA;YAC9D,OAAM;QACR,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;YACrC,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,6BAA6B,EAAE,CAAC,CAAA;YACxE,OAAM;QACR,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,EAAE,UAAU,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;QAC5D,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC7C,IAAI,CAAC;YACH,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QAC7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YACjG,OAAM;QACR,CAAC;QACD,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IACzC,CAAC,CAAA;AACH,CAAC;AAED,4DAA4D;AAC5D,SAAS,YAAY,CAAC,OAAuB;IAC3C,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACxB,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YACzB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC,CAAA;YAC/D,OAAM;QACR,CAAC;QACD,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,OAA0E,CAAA;YAC5F,IAAI,OAAO,SAAS,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;gBAC1C,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC,CAAA;gBACzE,OAAM;YACR,CAAC;YACD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,kBAAkB,CAAC,CAAA;YACvD,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,GAAG,CAAC,CAAA;YACzE,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE;gBAClB,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAA;QACJ,CAAC;IACH,CAAC,CAAA;AACH,CAAC;AAED,uEAAuE;AACvE,SAAS,aAAa,CAAC,OAAuB,EAAE,MAAgC;IAC9E,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAClB,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YACzB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC,CAAA;YAC/D,OAAM;QACR,CAAC;QACD,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE;YAClB,EAAE,EAAE,IAAI;YACR,OAAO,EAAE,OAAO,YAAY,gBAAgB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK;YAClE,SAAS,EAAE,OAAO,YAAY,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;YAC7E,sEAAsE;YACtE,uEAAuE;YACvE,eAAe;YACf,GAAG,CAAC,OAAO,YAAY,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzE,GAAG,CAAC,OAAO,YAAY,gBAAgB,IAAI,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnF,CAAC,CAAA;IACJ,CAAC,CAAA;AACH,CAAC;AAED,8FAA8F;AAC9F,SAAS,wBAAwB;IAC/B,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAClB,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAClD,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC,CAAA;YAC/D,OAAM;QACR,CAAC;QACD,IAAI,OAAe,CAAA;QACnB,IAAI,CAAC;YACH,OAAO,GAAG,kBAAkB,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;QAC7D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,kCAAkC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAA;YAC5F,OAAM;QACR,CAAC;QACD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;YACjB,cAAc,EAAE,iBAAiB;YACjC,gBAAgB,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;YACxC,qBAAqB,EAAE,yDAAyD;SACjF,CAAC,CAAA;QACF,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;IACtD,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAqB,EACrB,OAAuB,EACvB,aAAqB,EACrB,MAAqB;IAErB,MAAM,SAAS,GAAG;QAChB,OAAO,CAAC,QAAQ,CAAC;YACf,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,4BAA4B;YAClC,OAAO,EAAE,aAAa,CAAC,aAAa,CAAC;SACtC,CAAC;QACF,OAAO,CAAC,QAAQ,CAAC;YACf,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,2BAA2B;YACjC,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC;SAC/B,CAAC;QACF,OAAO,CAAC,QAAQ,CAAC;YACf,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,4BAA4B;YAClC,OAAO,EAAE,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC;SACxC,CAAC;QACF,OAAO,CAAC,QAAQ,CAAC;YACf,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,+BAA+B;YACrC,OAAO,EAAE,wBAAwB,EAAE;SACpC,CAAC;QACF,OAAO,CAAC,eAAe,CAAC;YACtB,IAAI,EAAE,wBAAwB;YAC9B,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC;SACjC,CAAC;KACH,CAAA;IACD,OAAO,GAAG,EAAE;QACV,KAAK,MAAM,OAAO,IAAI,SAAS;YAAE,OAAO,EAAE,CAAA;IAC5C,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAClC,GAAY,EACZ,OAAuB,EACvB,aAAqB,EACrB,QAAyB,EACzB,MAAqB;IAErB,MAAM,SAAS,GAAG,GAAG,CAAC,GAAG,CAAC,WAAW,CAA6B,CAAA;IAClE,IAAI,SAAS,KAAK,SAAS;QAAE,OAAM;IAEnC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC;QAClC,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;YAC1B,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBAC1B,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC,CAAA;gBAC/D,OAAM;YACR,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAA;gBACrC,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;YACzC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE;oBAClB,EAAE,EAAE,KAAK;oBACT,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;iBAC9D,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;KACF,CAAC,EAAE,4BAA4B,CAAC,CAAA;IAEjC,4EAA4E;IAC5E,4EAA4E;IAC5E,8EAA8E;IAC9E,wEAAwE;IACxE,sEAAsE;IACtE,iEAAiE;IACjE,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC;QAClC,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,0BAA0B;QAChC,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;YACpB,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;gBACzB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC,CAAA;gBAC/D,OAAM;YACR,CAAC;YACD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,qBAAqB,CAAC,CAAA;YAC1D,MAAM,SAAS,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,CAAA;YACzD,MAAM,IAAI,GAAG,OAAO,YAAY,gBAAgB;gBAC9C,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE;gBAC9E,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;YACrC,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE;gBAClB,EAAE,EAAE,IAAI;gBACR,GAAG,IAAI;gBACP,GAAG,QAAQ,CAAC,QAAQ,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;aAC/D,CAAC,CAAA;QACJ,CAAC;KACF,CAAC,EAAE,gCAAgC,CAAC,CAAA;IAErC,GAAG,CAAC,MAAM,CACR,GAAG,EAAE,CAAC,uBAAuB,CAAC,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC,EACxE,kCAAkC,CACnC,CAAA;AACH,CAAC"}
1
+ {"version":3,"file":"routes.js","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEzC,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAEzE,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAkBrC,4BAA4B;AAC5B,MAAM,UAAU,SAAS,CAAC,GAAmB,EAAE,MAAc,EAAE,KAAc;IAC3E,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IAClC,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAA;IAC7D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;AACf,CAAC;AAED,oEAAoE;AACpE,SAAS,cAAc,CAAC,OAAuB;IAC7C,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;QAC3B,IAAI,CAAC,CAAC,OAAO,YAAY,gBAAgB,CAAC,EAAE,CAAC;YAC3C,MAAM,CAAC,OAAO,EAAE,CAAA;YAChB,OAAM;QACR,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC;YAAE,OAAM;QACrC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;QAC5B,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAC5C,CAAC,CAAA;AACH,CAAC;AAED,sFAAsF;AACtF,SAAS,aAAa,CAAC,aAAqB;IAC1C,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACxB,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC1B,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC,CAAA;YAC/D,OAAM;QACR,CAAC;QACD,MAAM,MAAM,GAAa,EAAE,CAAA;QAC3B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG;YAAE,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,CAAA;QAC3D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QACpC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,CAAA;YAC9D,OAAM;QACR,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;YACrC,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,6BAA6B,EAAE,CAAC,CAAA;YACxE,OAAM;QACR,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,EAAE,UAAU,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;QAC5D,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC7C,IAAI,CAAC;YACH,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QAC7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YACjG,OAAM;QACR,CAAC;QACD,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IACzC,CAAC,CAAA;AACH,CAAC;AAED,4DAA4D;AAC5D,SAAS,YAAY,CAAC,OAAuB;IAC3C,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACxB,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YACzB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC,CAAA;YAC/D,OAAM;QACR,CAAC;QACD,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,OAA0E,CAAA;YAC5F,IAAI,OAAO,SAAS,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;gBAC1C,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC,CAAA;gBACzE,OAAM;YACR,CAAC;YACD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,kBAAkB,CAAC,CAAA;YACvD,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,GAAG,CAAC,CAAA;YACzE,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE;gBAClB,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAA;QACJ,CAAC;IACH,CAAC,CAAA;AACH,CAAC;AAED,uEAAuE;AACvE,SAAS,aAAa,CAAC,OAAuB,EAAE,MAAgC;IAC9E,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAClB,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YACzB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC,CAAA;YAC/D,OAAM;QACR,CAAC;QACD,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE;YAClB,EAAE,EAAE,IAAI;YACR,OAAO,EAAE,OAAO,YAAY,gBAAgB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK;YAClE,SAAS,EAAE,OAAO,YAAY,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;YAC7E,sEAAsE;YACtE,uEAAuE;YACvE,eAAe;YACf,GAAG,CAAC,OAAO,YAAY,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzE,GAAG,CAAC,OAAO,YAAY,gBAAgB,IAAI,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnF,CAAC,CAAA;IACJ,CAAC,CAAA;AACH,CAAC;AAED,8FAA8F;AAC9F,SAAS,wBAAwB;IAC/B,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAClB,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAClD,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC,CAAA;YAC/D,OAAM;QACR,CAAC;QACD,IAAI,OAAe,CAAA;QACnB,IAAI,CAAC;YACH,OAAO,GAAG,kBAAkB,CAAC,YAAY,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;QAC7D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,kCAAkC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAA;YAC5F,OAAM;QACR,CAAC;QACD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;YACjB,cAAc,EAAE,iBAAiB;YACjC,gBAAgB,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;YACxC,qBAAqB,EAAE,yDAAyD;SACjF,CAAC,CAAA;QACF,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;IACtD,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAqB,EACrB,OAAuB,EACvB,aAAqB,EACrB,MAAqB;IAErB,MAAM,SAAS,GAAG;QAChB,OAAO,CAAC,QAAQ,CAAC;YACf,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,4BAA4B;YAClC,OAAO,EAAE,aAAa,CAAC,aAAa,CAAC;SACtC,CAAC;QACF,OAAO,CAAC,QAAQ,CAAC;YACf,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,2BAA2B;YACjC,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC;SAC/B,CAAC;QACF,OAAO,CAAC,QAAQ,CAAC;YACf,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,4BAA4B;YAClC,OAAO,EAAE,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC;SACxC,CAAC;QACF,OAAO,CAAC,QAAQ,CAAC;YACf,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,+BAA+B;YACrC,OAAO,EAAE,wBAAwB,EAAE;SACpC,CAAC;QACF,OAAO,CAAC,eAAe,CAAC;YACtB,IAAI,EAAE,wBAAwB;YAC9B,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC;SACjC,CAAC;KACH,CAAA;IACD,OAAO,GAAG,EAAE;QACV,KAAK,MAAM,OAAO,IAAI,SAAS;YAAE,OAAO,EAAE,CAAA;IAC5C,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAClC,GAAY,EACZ,OAAuB,EACvB,aAAqB,EACrB,QAAyB,EACzB,MAAqB;IAErB,MAAM,SAAS,GAAG,GAAG,CAAC,GAAG,CAAC,WAAW,CAA6B,CAAA;IAClE,IAAI,SAAS,KAAK,SAAS;QAAE,OAAM;IAEnC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC;QAClC,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;YAC1B,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBAC1B,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC,CAAA;gBAC/D,OAAM;YACR,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAA;gBACrC,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;YACzC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE;oBAClB,EAAE,EAAE,KAAK;oBACT,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;iBAC9D,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;KACF,CAAC,EAAE,4BAA4B,CAAC,CAAA;IAEjC,4EAA4E;IAC5E,4EAA4E;IAC5E,8EAA8E;IAC9E,wEAAwE;IACxE,sEAAsE;IACtE,iEAAiE;IACjE,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC;QAClC,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,0BAA0B;QAChC,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;YACpB,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;gBACzB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC,CAAA;gBAC/D,OAAM;YACR,CAAC;YACD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,qBAAqB,CAAC,CAAA;YAC1D,MAAM,SAAS,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,CAAA;YACzD,MAAM,IAAI,GAAG,OAAO,YAAY,gBAAgB;gBAC9C,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE;gBAC9E,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;YACrC,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE;gBAClB,EAAE,EAAE,IAAI;gBACR,GAAG,IAAI;gBACP,GAAG,QAAQ,CAAC,QAAQ,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;aAC/D,CAAC,CAAA;QACJ,CAAC;KACF,CAAC,EAAE,gCAAgC,CAAC,CAAA;IAErC,GAAG,CAAC,MAAM,CACR,GAAG,EAAE,CAAC,uBAAuB,CAAC,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC,EACxE,kCAAkC,CACnC,CAAA;AACH,CAAC"}
package/lib/skill.d.ts CHANGED
@@ -47,4 +47,3 @@ export declare function chromeSkill(): SkillRegistrationLike;
47
47
  * @param ctx - the plugin's Cordis context.
48
48
  */
49
49
  export declare function registerChromeSkill(ctx: Context): void;
50
- //# sourceMappingURL=skill.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,+EAA+E;AAC/E,eAAO,MAAM,UAAU,mBAAmB,CAAA;AAE1C,oEAAoE;AACpE,eAAO,MAAM,iBAAiB,EAAE,MAEa,CAAA;AAE7C;yDACyD;AACzD,eAAO,MAAM,aAAa,EAAE,MAuJ3B,CAAA;AAED,mEAAmE;AACnE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE;QAAE,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;KAAE,CAAA;CAC5F;AAED,4DAA4D;AAC5D,MAAM,WAAW,UAAU;IACzB,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,IAAI,CAAA;CACnD;AAED,yCAAyC;AACzC,wBAAgB,WAAW,IAAI,qBAAqB,CAUnD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAMtD"}
1
+ {"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,+EAA+E;AAC/E,eAAO,MAAM,UAAU,mBAAmB,CAAA;AAE1C,oEAAoE;AACpE,eAAO,MAAM,iBAAiB,EAAE,MAEa,CAAA;AAE7C;yDACyD;AACzD,eAAO,MAAM,aAAa,EAAE,MA6J3B,CAAA;AAED,mEAAmE;AACnE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE;QAAE,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;KAAE,CAAA;CAC5F;AAED,4DAA4D;AAC5D,MAAM,WAAW,UAAU;IACzB,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,IAAI,CAAA;CACnD;AAED,yCAAyC;AACzC,wBAAgB,WAAW,IAAI,qBAAqB,CAUnD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAMtD"}
package/lib/skill.js CHANGED
@@ -10,14 +10,15 @@
10
10
  /** Skill name the catalog, the `skill` tool, and `/chrome-browser` address. */
11
11
  export const SKILL_NAME = 'chrome-browser';
12
12
  /** Routing line the catalog shows while the body stays unloaded. */
13
- export const SKILL_DESCRIPTION = '控制用户当前打开的 Chrome 标签页:列标签页、读页面、导航、点击、输入、截图、执行 JS。'
14
- + '适用于用户提到"这个页面/我开着的标签页",或需要读取已登录的内网/后台页面。';
13
+ export const SKILL_DESCRIPTION = '控制浏览器(默认是每个 agent 自己的沙箱;传 backend: "user" 改用用户真实 Chrome):列标签页、读页面、'
14
+ + '导航、点击、输入、截图、执行 JS。适用于用户提到"这个页面/我开着的标签页",或需要读取已登录的内网/后台页面。';
15
15
  /** Body loaded only when the skill is invoked. Annotated `string` so the emitted
16
16
  * declarations carry the type and not a 6 KB literal. */
17
- export const SKILL_CONTENT = `# Chrome 浏览器(用户真实标签页)
17
+ export const SKILL_CONTENT = `# Chrome 浏览器(沙箱优先,真实浏览器按需)
18
18
 
19
- \`chrome_*\` 工具直接操作用户正在使用的 Chrome——不新开窗口、不复制 profile。
20
- 用户打开什么,你就能看什么;登录态、内网、后台系统都能用。
19
+ \`chrome_*\` 工具驱动的浏览器由 \`backend\` 参数选择(见下「后端选择」):默认是这个 agent 自己的隔离浏览器;
20
+ 只有传 \`backend: 'user'\` 时才操作你用户正在使用的真实 Chrome——不新开窗口、不复制 profile。
21
+ 也只有这条通道能看到用户打开什么、登录态、内网与后台系统。
21
22
 
22
23
  ## 工具一览
23
24
 
@@ -38,15 +39,26 @@ export const SKILL_CONTENT = `# Chrome 浏览器(用户真实标签页)
38
39
  | \`chrome_webmcp_list\` | 列出该页声明的 **WebMCP 工具**(名称/说明/JSON Schema/安全注解);\`available: false\` 表示浏览器没开 WebMCP 或列表失败,退回 DOM 工具;\`available: true\` 且 \`tools: []\` 表示页面有 API 但当前没注册工具 |
39
40
  | \`chrome_webmcp_call\` | 执行一个 WebMCP 工具(页面自己实现的动作,比点 DOM 稳);\`pending: true\` 表示已激活但等用户操作,不要重试;对象结果会以 JSON 字符串返回,需要自行解析 |
40
41
  | \`chrome_wait\` | 等元素达到 visible / hidden / attached / detached;\`satisfied: false\` 表示超时,不是成功 |
41
- | \`chrome_console\` | 采集/读取控制台(start / read / stop),含浏览器自己抛的错误 |
42
+ | \`chrome_console\` | 采集/读取控制台(start / read / stop),含浏览器自己抛的错误。**start 会占用调试器,用完必须 stop**;5 分钟无读取会自动释放调试器(日志保留,read 返回 \`detached: "idle"\`) |
42
43
  | \`chrome_request_help\` | 请用户做只有人能做的事(登录/验证码),等答复;\`completed: false\` 表示用户跳过,不要重试 |
43
44
 
45
+ ## 后端选择:沙箱优先,真实浏览器备选
46
+
47
+ 16 个**操作浏览器**的工具都有这个可选参数(\`chrome_request_help\` 不驱动浏览器,没有该参数):
48
+
49
+ - \`backend: 'sandbox'\`(**默认**):驱动这个 agent **自己的隔离浏览器**(owned Chrome),并行子代理互不干扰;没有你的登录态。
50
+ - \`backend: 'user'\`:驱动**用户真实 Chrome**(扩展桥),用于已登录的内网/后台页面、用户正在看的 \`@\` 标签页。
51
+
52
+ 默认用 sandbox;只有当你需要用户的登录态、或要操作引用/打开的真实标签页时,才传 \`backend: 'user'\`。
53
+ 如果插件以 \`backend: 'extension'\` 或 \`backend: 'cdp'\` 配置运行(没有沙箱),所有工具都走真实浏览器,\`backend\` 参数无效果。
54
+
44
55
  ## 什么时候用
45
56
 
46
57
  - 用户提到"这个页面""我现在开着的标签页""帮我填一下这个表单"。
47
58
  - 用户消息里带 \`@"页面标题"\` 引用——宿主随后注入一条 \`## Referenced Chrome tabs\`,
48
- 里面有该标签页的 \`tabId\` 与 URL,照着用即可。
49
- - 需要读取用户已登录、你抓不到的页面。
59
+ 里面有该标签页的 \`tabId\` 与 URL。**这个 id 属于用户真实浏览器,调用时必须带 \`backend: 'user'\`**;
60
+ \`chrome_tabs\` 返回的 id 只在当次选择的那个浏览器里有效,切后端后要重新列。
61
+ - 需要读取用户已登录、你抓不到的页面——这类页面只在用户真实浏览器里,调用时带 \`backend: 'user'\`。
50
62
 
51
63
  不需要浏览器时不要调用这些工具。
52
64
 
@@ -55,7 +67,7 @@ export const SKILL_CONTENT = `# Chrome 浏览器(用户真实标签页)
55
67
  0. **先看有没有 WebMCP**——页面若实现了 WebMCP(需要 Chrome 启用 WebMCP),先 \`chrome_webmcp_list\`;
56
68
  有工具时优先 \`chrome_webmcp_call\`,比点 DOM 稳。\`pending: true\` 表示工具已激活但还在等用户操作
57
69
  (常见于声明式表单),不要重复调用,先请用户确认。
58
- 1. **拿到 tabId**——引用已注入时直接用;否则先 \`chrome_tabs\`。
70
+ 1. **拿到 tabId**——引用已注入时直接用(并带 \`backend: 'user'\`);否则先 \`chrome_tabs\` 列当前后端的标签页。
59
71
  2. **先感知再操作**——要动手时用 \`chrome_read { mode: 'interactive' }\`:它直接给出每个可交互元素的
60
72
  \`selector\` 以及 \`disabled\` / \`covered\` / \`inView\`,比读正文小得多,而且读完就能点。
61
73
  只是要理解页面内容时才用默认的 \`mode: 'text'\`。
@@ -74,11 +86,16 @@ export const SKILL_CONTENT = `# Chrome 浏览器(用户真实标签页)
74
86
  ## tabId 从哪来
75
87
 
76
88
  - **显式 id**——来自 \`chrome_tabs\`,或用户引用某标签页时宿主注入的上下文。**优先用这个。**
77
- - 省略 \`tabId\`、或写 \`"active"\`——都是**用户当前正在看的那个标签页**。
89
+ - 省略 \`tabId\`、或写 \`"active"\`——指**你当前所选后端(默认沙箱)的活动标签页**;
90
+ 默认沙箱时它是沙箱自己的活动页,不是你用户正在看的那一页。要操作用户真实浏览器里的活动页,
91
+ 显式传 \`backend: 'user'\`。
78
92
 
79
93
  \`@\` 菜单插入的是引用芯片,**不绑定会话**;所以没有「本会话选中的标签页」这回事。
80
94
  用户明确要你操作某个页面时,不要省略 \`tabId\`:那时活动标签页很可能已经是别的了。
81
95
 
96
+ **id 只在产生它的浏览器里有效。** \`chrome_tabs\` 拿到的 id 属于当次选择的那个后端;
97
+ 切换 \`backend\` 后要重新列,不要拿沙箱的 id 去操作真实浏览器(反之亦然)。
98
+
82
99
  **模型侧看到的是 id,不是标题。** 标题只能用来在 \`chrome_tabs\` 的结果里认出目标。
83
100
 
84
101
  ## 失败怎么办
@@ -101,6 +118,7 @@ export const SKILL_CONTENT = `# Chrome 浏览器(用户真实标签页)
101
118
  | 读到的内容明显不全 | 只覆盖主框架的 \`innerText\`;iframe 与大量隐藏内容不在其中,必要时用 \`chrome_eval\` 取。 |
102
119
  | 页面没反应,但说不清为什么 | **先 \`chrome_console { action: 'start' }\`,再复现,再 \`action: 'read'\`**。采集不回溯,所以必须在使用之前开。控制台里有资源加载失败、CSP 拦截这类浏览器自己抛的错误——\`chrome_eval\` 看不到它们。 |
103
120
  | \`chrome_console\` 报 \`not being captured\` | 没 start。顺序是 start → 操作 → read,不是「出问题了再回头看」。 |
121
+ | \`chrome_console\` 的 read 返回 \`detached: "idle"\` | 采集因 5 分钟无读取被自动结束、调试器已释放,**已捕获的日志仍在**返回的 \`entries\` 里——不要以为没采到、不要连续重试 read;要继续采集就重新 \`action: 'start'\`。 |
104
122
  | \`chrome_console\` 报标签页已被占用 | 该标签页已打开 DevTools。让用户关掉 DevTools 再试。 |
105
123
  | \`chrome_screenshot\` 报错,或结果带 \`fallback\` | 工具已经自动降级过(见「截图与降级」)。带 \`fallback\` 的图只有可视区域、可能是旧帧、指定范围可能没生效;**两级都失败时不要连续重试截图**,改用 \`chrome_eval\` 量尺寸/样式、\`chrome_read\` 读文本作为替代证据,并告诉用户要关 DevTools 或把窗口切到前台。 |
106
124
 
@@ -143,12 +161,17 @@ export const SKILL_CONTENT = `# Chrome 浏览器(用户真实标签页)
143
161
  控制台有 \`chrome_console\`,但**不回溯**:必须在复现之前 start。
144
162
  - **控制台缓冲有上限且会丢**:每标签页最多 200 条 / 256 KB,同时最多采集 5 个标签页;
145
163
  \`read\` 返回的 \`dropped\` 是被淘汰的条数。桥断开期间的消息直接丢失。
164
+ - **控制台采集会自己退出**:\`start\` 会占用 Chrome 调试器(标签页顶部显示「正在调试」条),
165
+ **用完立刻 \`action: 'stop'\`**。忘了 stop 也不会一直占着:宿主 5 分钟没有 \`read\` 会自动结束采集
166
+ 并释放调试器(已捕获日志保留,下次 read 返回 \`detached: "idle"\` + note,继续采集要重新 start);
167
+ 宿主进程断开 60 秒后扩展会自动挂断;重启的宿主还会用 \`console-sync\` 让扩展丢弃上一进程遗留的采集。
168
+ 看到 \`detached\` 不代表日志丢了——先读 buffer,不要重复 start 再抱怨采集不回溯。
146
169
  - **按键、悬停、下拉的事件是合成的**:送达页面监听器,但不产生浏览器默认行为。
147
170
  Enter 提交靠显式 \`requestSubmit()\` 兜底(\`chrome_press\` 会报告 \`submitted\`);依赖真实按键序列
148
171
  (组合键、输入法)或真实指针的组件仍可能不响应,这些场景退回 \`chrome_eval\`。
149
- - **操作的是用户真实标签页**:用户可能同时在操作同一个页面;
150
- 写操作前确认目标,不要在用户正在输入的页面上抢焦点。截图优先走调试通道,不会切换标签页,
151
- 但会在该标签页显示「正在调试」提示条。
172
+ - **默认操作的是你自己的沙箱(隔离)**:只有传 \`backend: 'user'\` 才碰用户真实页面——那时用户可能
173
+ 同时在操作同一个页面,写操作前确认目标,不要在用户正在输入的页面上抢焦点。截图优先走调试通道,
174
+ 不会切换标签页,但会在该标签页显示「正在调试」提示条。
152
175
  - **截图自带降级**:调试通道失败(DevTools 占用、页面拒绝渲染、clip 测量失败等)时,
153
176
  \`chrome_screenshot\` 自动退回 \`chrome.tabs.captureVisibleTab\` 的可视区域截图,结果带
154
177
  \`fallback: "visible-tab"\` + \`warning\`(含失败原因),\`fullPage\`/\`selector\` 不生效时还带
package/lib/skill.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"skill.js","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,+EAA+E;AAC/E,MAAM,CAAC,MAAM,UAAU,GAAG,gBAAgB,CAAA;AAE1C,oEAAoE;AACpE,MAAM,CAAC,MAAM,iBAAiB,GAC5B,kDAAkD;MAChD,yCAAyC,CAAA;AAE7C;yDACyD;AACzD,MAAM,CAAC,MAAM,aAAa,GAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuJpC,CAAA;AAuBD,yCAAyC;AACzC,MAAM,UAAU,WAAW;IACzB,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,iBAAiB;QAC9B,OAAO,EAAE,aAAa;QACtB,MAAM,EAAE,SAAS;QACjB,yEAAyE;QACzE,6BAA6B;QAC7B,UAAU,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;KAC1D,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE;QAChC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAA2B,CAAA;QAC7D,IAAI,MAAM,KAAK,SAAS;YAAE,OAAM;QAChC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,EAAE,uBAAuB,CAAC,CAAA;IAC9E,CAAC,CAAC,CAAA;AACJ,CAAC"}
1
+ {"version":3,"file":"skill.js","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,+EAA+E;AAC/E,MAAM,CAAC,MAAM,UAAU,GAAG,gBAAgB,CAAA;AAE1C,oEAAoE;AACpE,MAAM,CAAC,MAAM,iBAAiB,GAC5B,oEAAoE;MAClE,2DAA2D,CAAA;AAE/D;yDACyD;AACzD,MAAM,CAAC,MAAM,aAAa,GAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8KpC,CAAA;AAuBD,yCAAyC;AACzC,MAAM,UAAU,WAAW;IACzB,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,iBAAiB;QAC9B,OAAO,EAAE,aAAa;QACtB,MAAM,EAAE,SAAS;QACjB,yEAAyE;QACzE,6BAA6B;QAC7B,UAAU,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;KAC1D,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE;QAChC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAA2B,CAAA;QAC7D,IAAI,MAAM,KAAK,SAAS;YAAE,OAAM;QAChC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,EAAE,uBAAuB,CAAC,CAAA;IAC9E,CAAC,CAAC,CAAA;AACJ,CAAC"}
package/lib/text.d.ts CHANGED
@@ -43,4 +43,3 @@ export declare function windowText(text: string, offset: number, limit: number):
43
43
  * @returns bounded JSON text.
44
44
  */
45
45
  export declare function clipJson(value: unknown, maxChars: number): string;
46
- //# sourceMappingURL=text.d.ts.map
package/lib/tools.d.ts CHANGED
@@ -20,12 +20,16 @@ import type { HelpChannel } from './help.ts';
20
20
  */
21
21
  export declare function clickWarnings(outcome: ClickOutcome): string[];
22
22
  /**
23
- * Build every chrome-browser tool definition bound to one backend.
24
- * @param backend - the live browser backend.
23
+ * Build every chrome-browser tool definition. Each tool resolves its backend
24
+ * from the executing agent on every call, so a sandbox backend stays scoped to
25
+ * one agent while the extension/cdp backends keep a shared singleton. An
26
+ * explicit per-call `backend: 'user'` opts out of the sandbox and drives the
27
+ * shared backend (the user's real browser) instead.
28
+ * @param resolve - maps an execution context and an optional backend preference
29
+ * to the browser backend the call drives.
25
30
  * @param config - the resolved plugin configuration.
26
31
  * @param consoleLog - the bounded console buffer `chrome_console` reads.
27
32
  * @param help - the human-help channel `chrome_request_help` speaks to.
28
33
  * @returns the tool definitions in registration order.
29
34
  */
30
- export declare function chromeToolDefinitions(backend: BrowserBackend, config: ResolvedChromeConfig, consoleLog: ConsoleLog, help: HelpChannel): ToolDefinition[];
31
- //# sourceMappingURL=tools.d.ts.map
35
+ export declare function chromeToolDefinitions(resolve: (exec: unknown, backend?: 'sandbox' | 'user') => BrowserBackend, config: ResolvedChromeConfig, consoleLog: ConsoleLog, help: HelpChannel): ToolDefinition[];
@@ -1 +1 @@
1
- {"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAE5D,OAAO,KAAK,EAAc,cAAc,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAmE5C;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,EAAE,CA0B7D;AA+GD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,oBAAoB,EAC5B,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,WAAW,GAChB,cAAc,EAAE,CAqmBlB"}
1
+ {"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAE5D,OAAO,KAAK,EAAc,cAAc,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAmE5C;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,EAAE,CA0B7D;AA+GD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,oBAAoB,EAC5B,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,WAAW,GAChB,cAAc,EAAE,CA6pBlB"}