@xingular/harness 1.0.0 → 1.2.0

package/dist/sdk/world/cli.d.ts

@@ -1,6 +1,6 @@
 import { type SecretStore } from "../accounts/secrets.js";
-export declare const WEB_USAGE = "Usage: xharness web <status | key <provider> [--remove] | keyless on|off> [--state <dir>] [--data <dir>]\n\n  status                 Which search services are ready\n  key <provider>         Save a key for brave, tavily or exa, read from standard input\n  key <provider> --remove\n                         Forget that key\n  keyless on|off         Search DuckDuckGo's public results page when no key is saved\n                         (default off; it often answers automated requests with a bot check)\n";
-export declare const BROWSER_USAGE = "Usage: xharness browser [status | set <options>] [--state <dir>]\n\n  status                       How the browser runs\n  set --headed | --headless    Show the browser window, or not (default: headless)\n  set --allow-private | --public-only\n                               Let pages reach this machine and private networks (local\n                               development), or only public addresses (default)\n  set --domains a.com,b.org | --any-domain\n                               Only these sites (and their subdomains), or any\n  set --attach <http://127.0.0.1:9222> | --launch\n                               Use a browser you already run (its DevTools address, on this\n                               machine), or launch one (default: Chrome, Edge, then Chromium)\n  set --executable <path> | --default-executable\n";
+export declare const WEB_USAGE = "Usage: xagent web <status | key <provider> [--remove] | keyless on|off> [--state <dir>] [--data <dir>]\n\n  status                 Which search services are ready\n  key <provider>         Save a key for brave, tavily or exa, read from standard input\n  key <provider> --remove\n                         Forget that key\n  keyless on|off         Search DuckDuckGo's public results page when no key is saved\n                         (default off; it often answers automated requests with a bot check)\n";
+export declare const BROWSER_USAGE = "Usage: xagent browser [status | set <options>] [--state <dir>]\n\n  status                       How the browser runs\n  set --headed | --headless    Show the browser window, or not (default: headless)\n  set --allow-private | --public-only\n                               Let pages reach this machine and private networks (local\n                               development), or only public addresses (default)\n  set --domains a.com,b.org | --any-domain\n                               Only these sites (and their subdomains), or any\n  set --attach <http://127.0.0.1:9222> | --launch\n                               Use a browser you already run (its DevTools address, on this\n                               machine), or launch one (default: Chrome, Edge, then Chromium)\n  set --executable <path> | --default-executable\n";
 interface CliDependencies {
     home?: string;
     write?: (text: string) => void;

package/dist/sdk/world/cli.js

@@ -1,4 +1,4 @@
-// `xharness web` and `xharness browser`: the settings a person keeps for the world tools on this
+// `xagent web` and `xagent browser`: the settings a person keeps for the world tools on this
 // device. Keys are read from standard input, never from the command line, so they stay out of
 // shell history.
 import { homedir } from 'node:os';
@@ -9,7 +9,7 @@ import { settingValue } from "../plugins/firstParty.js";
 import { readBrowserConfig, writeBrowserConfig } from "../browser/config.js";
 import { SEARCH_PROVIDERS } from "../web/search.js";
 import { KEYLESS_SEARCH, WEB_PLUGIN, WEB_SETTINGS } from "../web/tools.js";
-export const WEB_USAGE = `Usage: xharness web <status | key <provider> [--remove] | keyless on|off> [--state <dir>] [--data <dir>]
+export const WEB_USAGE = `Usage: xagent web <status | key <provider> [--remove] | keyless on|off> [--state <dir>] [--data <dir>]
 
   status                 Which search services are ready
   key <provider>         Save a key for brave, tavily or exa, read from standard input
@@ -18,7 +18,7 @@ export const WEB_USAGE = `Usage: xharness web <status | key <provider> [--remove
   keyless on|off         Search DuckDuckGo's public results page when no key is saved
                          (default off; it often answers automated requests with a bot check)
 `;
-export const BROWSER_USAGE = `Usage: xharness browser [status | set <options>] [--state <dir>]
+export const BROWSER_USAGE = `Usage: xagent browser [status | set <options>] [--state <dir>]
 
   status                       How the browser runs
   set --headed | --headless    Show the browser window, or not (default: headless)
@@ -66,7 +66,7 @@ export async function runWebCli(argv, dependencies = {}) {
     if (command === 'status') {
         for (const provider of SEARCH_PROVIDERS) {
             if (!provider.key) {
-                write(`${provider.title.padEnd(22)} ${keylessOn(dataRoot) ? 'on' : 'off (xharness web keyless on)'}\n`);
+                write(`${provider.title.padEnd(22)} ${keylessOn(dataRoot) ? 'on' : 'off (xagent web keyless on)'}\n`);
                 continue;
             }
             write(`${provider.title.padEnd(22)} ${(await secrets.get(provider.key)) ? 'key saved' : 'no key'}\n`);
@@ -75,7 +75,7 @@ export async function runWebCli(argv, dependencies = {}) {
     }
     if (command === 'keyless') {
         if (name !== 'on' && name !== 'off') {
-            write('Say on or off: xharness web keyless on\n');
+            write('Say on or off: xagent web keyless on\n');
             return 2;
         }
         const choices = attachments.load(dataRoot);
@@ -97,7 +97,7 @@ export async function runWebCli(argv, dependencies = {}) {
         }
         const key = (await (dependencies.read ?? readStdin)()).trim();
         if (!key || /\s/.test(key)) {
-            write('Give the key on standard input, for example: pbpaste | xharness web key brave\n');
+            write('Give the key on standard input, for example: pbpaste | xagent web key brave\n');
             return 2;
         }
         await secrets.set(provider.key, key);

package/dist/sdk/world/world.d.ts

@@ -27,6 +27,8 @@ export interface WorldOptions {
     request?: WebRequest;
     /** Replaces the browser's launcher and address check in tests. */
     browser?: Omit<BrowserPartOptions, 'stateDir'> | false;
+    /** Told when the agent marks a page note fixed, so front ends refresh (PROP-0018). */
+    notesChanged?: (sessionId: string | null, ids: string[]) => void;
 }
 /** A family of world tools, switched as one plugin. */
 export interface WorldPart {
@@ -40,7 +42,7 @@ export interface WorldPart {
 export declare class World {
     private readonly options;
     readonly parts: WorldPart[];
-    private readonly web;
+    private readonly browserEngine;
     constructor(options: WorldOptions);
     add(part: WorldPart): void;
     get plugins(): PluginDescriptor[];

package/dist/sdk/world/world.js

@@ -1,23 +1,22 @@
 import * as attachments from "../plugins/attachments.js";
+import { BUILTIN_PLUGIN_REGISTRY } from "../plugins/builtin.js";
 import { settingValue } from "../plugins/firstParty.js";
 import { contributionId } from "../plugins/identity.js";
 import { findRun } from "../sessions/runStore.js";
-import { KEYLESS_SEARCH, WEB_PLUGIN, WEB_SETTINGS, webTools } from "../web/tools.js";
+import { KEYLESS_SEARCH, WEB_PLUGIN, WEB_SETTINGS } from "../web/tools.js";
 import { SEARCH_PROVIDERS } from "../web/search.js";
 import { invalid } from "../core/errors.js";
 import { readBrowserConfig, writeBrowserConfig } from "../browser/config.js";
-import { browserPart } from "../browser/index.js";
+import { createBrowserEngine } from "../browser/index.js";
 const UNATTENDED = new Set(['probe', 'improver', 'reflection']);
 export class World {
     options;
     parts = [];
-    web;
+    browserEngine;
     constructor(options) {
         this.options = options;
-        this.web = webTools({ secrets: options.secrets, request: options.request, keyless: () => this.setting(WEB_PLUGIN.id, KEYLESS_SEARCH) === 1 });
-        this.parts.push({ plugin: WEB_PLUGIN, tools: () => this.web({}) });
-        if (options.browser !== false)
-            this.parts.push(browserPart({ stateDir: options.stateDir, ...options.browser }));
+        this.browserEngine = options.browser === false ? null : createBrowserEngine({ stateDir: options.stateDir, ...options.browser });
+        this.parts.push(...BUILTIN_PLUGIN_REGISTRY.worldParts({ options, setting: (pluginId, key) => this.setting(pluginId, key), browserEngine: this.browserEngine }));
     }
     add(part) {
         this.parts.push(part);
@@ -72,9 +71,9 @@ export class World {
         return writeBrowserConfig(this.options.stateDir, change);
     }
     async release(sessionKey) {
-        await Promise.all(this.parts.map((part) => part.release?.(sessionKey)));
+        await Promise.all([...this.parts.map((part) => part.release?.(sessionKey)), this.browserEngine?.release(sessionKey)]);
     }
     async close() {
-        await Promise.all(this.parts.map((part) => part.close?.()));
+        await Promise.all([...this.parts.map((part) => part.close?.()), this.browserEngine?.close()]);
     }
 }