@schlenkr/ragents 0.1.4 → 0.1.6

package/bundles/ragents.browser/server/index.js

@@ -0,0 +1,479 @@
+import { createRequire as __ragentsCreateRequire } from "node:module";
+const require = __ragentsCreateRequire(import.meta.url);
+import {
+  browserRuntimeToken
+} from "./chunks/chunk-2GKLLCBE.js";
+
+// server/index.ts
+import { BROWSER_EXECUTABLE_VARIABLE } from "@ragents/workspace-executor";
+import { sandboxServicesToken } from "@ragents/host/plugin-support/workspace-sandbox-host.js";
+import { documentStoreToken } from "@ragents/host/ragents/document-store.js";
+
+// server/browser.ts
+import { randomUUID } from "node:crypto";
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import path from "node:path";
+import {
+  BROWSER_OPERATIONS
+} from "@ragents/workspace-executor";
+import { documentsApiPrefix } from "@ragents/plugins/ragents.documents/contract";
+var DEFAULT_VIEWPORT = { width: 1920, height: 1080 };
+var capturePath = (id) => `browser/${id}.png`;
+var RunBrowser = class {
+  #options;
+  #pages = /* @__PURE__ */ new Map();
+  #viewports = /* @__PURE__ */ new Map();
+  #captures = /* @__PURE__ */ new Map();
+  #captureLoads = /* @__PURE__ */ new Map();
+  #captureWrites = /* @__PURE__ */ new Map();
+  #generations = /* @__PURE__ */ new Map();
+  #shutdown = false;
+  constructor(options) {
+    this.#options = options;
+  }
+  restore(runId) {
+    const loading = this.#captureLoads.get(runId);
+    if (loading) return loading;
+    const pending = this.#restore(runId).catch((error) => {
+      this.#captureLoads.delete(runId);
+      throw error;
+    });
+    this.#captureLoads.set(runId, pending);
+    return pending;
+  }
+  async open(runId, url, options = {}) {
+    options.signal?.throwIfAborted();
+    this.#assertRunning();
+    const generation = this.#generation(runId);
+    await this.restore(runId);
+    options.signal?.throwIfAborted();
+    this.#assertRunning();
+    if (generation !== this.#generation(runId)) throw new Error("Der Browser wurde beendet.");
+    return this.#run(runId, BROWSER_OPERATIONS.open, { url, viewport: this.#viewports.get(runId) ?? DEFAULT_VIEWPORT }, options);
+  }
+  snapshot(runId, options = {}) {
+    return this.#run(runId, BROWSER_OPERATIONS.snapshot, null, options);
+  }
+  /** Der gewählte Viewport gilt für den Run, auch für einen später neu gestarteten Browser. */
+  async viewport(runId, viewport, options = {}) {
+    const snapshot = await this.#run(runId, BROWSER_OPERATIONS.viewport, viewport, options);
+    this.#viewports.set(runId, viewport);
+    return snapshot;
+  }
+  click(runId, target, options = {}) {
+    return this.#run(runId, BROWSER_OPERATIONS.click, { target }, options);
+  }
+  fill(runId, target, value, options = {}) {
+    return this.#run(runId, BROWSER_OPERATIONS.fill, { target, value }, options);
+  }
+  select(runId, target, label, options = {}) {
+    return this.#run(runId, BROWSER_OPERATIONS.select, { target, label }, options);
+  }
+  press(runId, target, key, options = {}) {
+    return this.#run(runId, BROWSER_OPERATIONS.press, { target, key }, options);
+  }
+  /** Die Zeit einer bestandenen Prüfung ist die des Servers, damit sie sich mit seinen übrigen Zeiten vergleichen lässt. */
+  async check(runId, input, options = {}) {
+    const generation = this.#generation(runId);
+    const { result, page } = await this.#execute(runId, generation, BROWSER_OPERATIONS.check, input, options);
+    const checkedAt = (/* @__PURE__ */ new Date()).toISOString();
+    this.#observe(runId, generation, page, checkedAt);
+    return { checkedAt, url: result.url, assertions: result.assertions };
+  }
+  async screenshot(runId, input, options = {}) {
+    await this.restore(runId);
+    const id = randomUUID();
+    const image = await this.#run(runId, BROWSER_OPERATIONS.screenshot, { id, fullPage: input.fullPage ?? false }, options);
+    const capture = { name: input.label?.trim() || "Browseraufnahme", path: capturePath(id) };
+    await this.#store(runId, capture, Buffer.from(image, "base64"));
+    const url = this.#captureUrl(runId, capture.path);
+    return {
+      ...capture,
+      url,
+      markdown: `![${capture.name.replace(/[\[\]\\]/g, "")}](${url})`,
+      capturedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+  }
+  async image(runId) {
+    const latest = this.#captures.get(runId)?.at(-1);
+    if (!latest) throw new Error("F\xFCr diesen Run gibt es noch keinen Browser-Screenshot. Zuerst browser_screenshot aufrufen.");
+    return readFile(path.join(await this.#options.filesFor(runId), latest.path));
+  }
+  evidence(runId) {
+    const captures = this.#captures.get(runId) ?? [];
+    const shown = (capture) => ({ name: capture.name, url: this.#captureUrl(runId, capture.path) });
+    const screenshots = captures.map(shown);
+    const page = this.#pages.get(runId);
+    if (!page) return { screenshots, currentScreenshots: [], errors: [] };
+    const current = page.screenshots.map((id) => captures.find((capture) => capture.path === capturePath(id))).filter((capture) => capture !== void 0);
+    return {
+      ...page.checkedAt ? { checkedAt: page.checkedAt } : {},
+      url: page.url,
+      screenshots,
+      currentScreenshots: current.map(shown),
+      errors: [...page.errors]
+    };
+  }
+  /** Schließt den Browser beim Executor des Runs; ein nicht verbundener Arbeitsplatz hält nichts, was sich jetzt schließen ließe. */
+  async close(runId) {
+    this.#forget(runId);
+    await this.#options.sandbox.execute(runId, BROWSER_OPERATIONS.close, null, { whenReachable: true });
+  }
+  async delete(runId) {
+    await this.close(runId);
+    this.#viewports.delete(runId);
+    this.#captures.delete(runId);
+    this.#captureLoads.delete(runId);
+    this.#captureWrites.delete(runId);
+  }
+  async shutdown() {
+    this.#shutdown = true;
+    const results = await Promise.allSettled([...this.#pages.keys()].map((runId) => this.close(runId)));
+    this.#viewports.clear();
+    this.#captures.clear();
+    this.#captureLoads.clear();
+    this.#captureWrites.clear();
+    const failed = results.find((result) => result.status === "rejected");
+    if (failed) throw failed.reason;
+  }
+  #assertRunning() {
+    if (this.#shutdown) throw new Error("Der Browserdienst ist beendet.");
+  }
+  #generation(runId) {
+    return this.#generations.get(runId) ?? 0;
+  }
+  /** Ein geschlossener Browser hat keine Seite mehr; Ergebnisse, die vorher begonnen haben, zählen danach nicht. */
+  #forget(runId) {
+    this.#generations.set(runId, this.#generation(runId) + 1);
+    this.#pages.delete(runId);
+  }
+  async #run(runId, operation, input, options) {
+    const generation = this.#generation(runId);
+    const { result, page } = await this.#execute(runId, generation, operation, input, options);
+    this.#observe(runId, generation, page);
+    return result;
+  }
+  async #execute(runId, generation, operation, input, options) {
+    try {
+      return await this.#options.sandbox.execute(runId, operation, input, options);
+    } catch (error) {
+      await this.#resync(runId, generation);
+      throw error;
+    }
+  }
+  /** Nach einem gescheiterten Aufruf fragt der Server den Stand der Seite nach; wer ihn nicht nennen kann, hat keine Seite. */
+  async #resync(runId, generation) {
+    const page = await this.#options.sandbox.execute(runId, BROWSER_OPERATIONS.state, null, { whenReachable: true }).then((value) => value, () => null);
+    this.#observe(runId, generation, page);
+  }
+  /** Nur eine bestandene Prüfung setzt die Zeit; jeder andere Stand behält sie, solange die Seite geprüft bleibt. */
+  #observe(runId, generation, page, checkedAt) {
+    if (generation !== this.#generation(runId)) return;
+    if (!page) {
+      this.#pages.delete(runId);
+      return;
+    }
+    const stamp = page.checked ? checkedAt ?? this.#pages.get(runId)?.checkedAt : void 0;
+    this.#pages.set(runId, {
+      url: page.url,
+      errors: page.errors,
+      screenshots: page.screenshots,
+      ...stamp ? { checkedAt: stamp } : {}
+    });
+  }
+  /** Legt eine Aufnahme in die Dateiablage des Runs und schreibt die Aufnahmeliste atomar; die Aufnahmen eines Runs der Reihe nach. */
+  #store(runId, capture, image) {
+    const previous = this.#captureWrites.get(runId) ?? Promise.resolve();
+    const pending = previous.then(async () => {
+      const directory = await this.#options.filesFor(runId);
+      await mkdir(path.join(directory, "browser"), { recursive: true });
+      await writeFile(path.join(directory, capture.path), image);
+      const captures = [...this.#captures.get(runId) ?? [], capture];
+      const manifest = path.join(directory, "browser", ".captures.json");
+      const temporary = `${manifest}.${randomUUID()}.tmp`;
+      await writeFile(temporary, JSON.stringify(captures), "utf8");
+      await rename(temporary, manifest);
+      this.#captures.set(runId, captures);
+    });
+    this.#captureWrites.set(runId, pending.then(() => void 0, () => void 0));
+    return pending;
+  }
+  #captureUrl(runId, filename) {
+    return `${documentsApiPrefix}/runs/${encodeURIComponent(runId)}/files/content?path=${encodeURIComponent(filename)}`;
+  }
+  async #restore(runId) {
+    const directory = await this.#options.filesFor(runId);
+    const manifest = path.join(directory, "browser", ".captures.json");
+    let content;
+    try {
+      content = await readFile(manifest, "utf8");
+    } catch (error) {
+      if (error.code !== "ENOENT") throw error;
+      this.#captures.set(runId, []);
+      return;
+    }
+    const captures = JSON.parse(content);
+    if (!Array.isArray(captures) || captures.some((entry) => !entry || typeof entry.name !== "string" || typeof entry.path !== "string" || !/^browser\/[a-f0-9-]{36}\.png$/.test(entry.path))) {
+      throw new Error("Die gespeicherte Browser-Aufnahmeliste dieses Runs ist besch\xE4digt.");
+    }
+    this.#captures.set(runId, captures);
+  }
+};
+
+// server/tools.ts
+import { Type } from "typebox";
+import { defineRunFunction } from "@ragents/engine";
+import { alwaysAvailable } from "@ragents/host/plugin-support/tool-availability.js";
+var targetSchema = Type.Object({
+  role: Type.Optional(Type.String({ minLength: 1, description: "Accessible role, e.g. button, textbox, link, combobox." })),
+  name: Type.Optional(Type.String({ description: "Exact accessible name for role." })),
+  label: Type.Optional(Type.String({ minLength: 1, description: "Exact form label." })),
+  text: Type.Optional(Type.String({ minLength: 1, description: "Exact visible text." })),
+  testId: Type.Optional(Type.String({ minLength: 1, description: "data-testid value." })),
+  css: Type.Optional(Type.String({ minLength: 1, description: "CSS selector for elements without useful accessible names." })),
+  frame: Type.Optional(Type.String({ minLength: 1, description: "CSS selector of an iframe containing the target." })),
+  nth: Type.Optional(Type.Integer({ minimum: 0, description: "0-based index among all matches when the target matches several elements; not together with first." })),
+  first: Type.Optional(Type.Boolean({ description: "Use the first match when the target matches several elements; not together with nth." }))
+}, { additionalProperties: false, description: "Use exactly one of role (with optional name), label, text, testId, css. Resolve semantic targets server-side; never copy snapshot element IDs. Ambiguous targets are errors naming the candidates unless nth or first selects one." });
+var snapshotSchema = Type.Object({
+  url: Type.String(),
+  title: Type.String(),
+  snapshot: Type.String(),
+  truncated: Type.Boolean(),
+  errors: Type.Array(Type.String())
+}, { additionalProperties: false });
+var emptySchema = Type.Object({}, { additionalProperties: false });
+var targetInputSchema = Type.Object({ target: targetSchema }, { additionalProperties: false });
+var screenshotDescription = "Capture the real browser page into this run's document library. The returned URL and Markdown display it to the user. Call browser_view_screenshot to inspect the latest capture as an image without copying a path.";
+var createBrowserFunctions = (browser) => [
+  defineRunFunction({
+    name: "browser_open",
+    label: "Browser \xF6ffnen",
+    description: "Open an HTTP(S) page in this run's isolated headless browser. Returns its accessible structure and browser errors. Reuses the current run browser; other runs have separate cookies and processes.",
+    schema: Type.Object({ url: Type.String({ minLength: 1 }) }, { additionalProperties: false }),
+    resultSchema: snapshotSchema,
+    nativeTool: true,
+    available: alwaysAvailable,
+    executionMode: "sequential",
+    run: async ({ caller, signal }, toolCallId, input) => ({ ...await browser.open(caller.runId, input.url, { signal, toolCallId }) })
+  }),
+  defineRunFunction({
+    name: "browser_snapshot",
+    label: "Browser lesen",
+    description: "Read the current real page's accessible structure, title, URL and errors. Use role/name or labels for subsequent actions; snapshot reference IDs never need to be copied.",
+    schema: emptySchema,
+    resultSchema: snapshotSchema,
+    nativeTool: true,
+    available: alwaysAvailable,
+    executionMode: "sequential",
+    run: async ({ caller, signal }, toolCallId) => ({ ...await browser.snapshot(caller.runId, { signal, toolCallId }) })
+  }),
+  defineRunFunction({
+    name: "browser_click",
+    label: "Im Browser klicken",
+    description: "Click a uniquely identified visible element with Playwright auto-waiting. Returns the actual resulting page. Ambiguous or absent targets are errors.",
+    schema: targetInputSchema,
+    resultSchema: snapshotSchema,
+    nativeTool: true,
+    available: alwaysAvailable,
+    executionMode: "sequential",
+    run: async ({ caller, signal }, toolCallId, input) => ({ ...await browser.click(caller.runId, input.target, { signal, toolCallId }) })
+  }),
+  defineRunFunction({
+    name: "browser_fill",
+    label: "Browserfeld ausf\xFCllen",
+    description: "Fill an input or textarea by accessible label or another semantic target, firing the normal input events. Returns the resulting page.",
+    schema: Type.Object({ target: targetSchema, value: Type.String() }, { additionalProperties: false }),
+    resultSchema: snapshotSchema,
+    nativeTool: true,
+    available: alwaysAvailable,
+    executionMode: "sequential",
+    run: async ({ caller, signal }, toolCallId, input) => ({ ...await browser.fill(caller.runId, input.target, input.value, { signal, toolCallId }) })
+  }),
+  defineRunFunction({
+    name: "browser_select",
+    label: "Im Browser ausw\xE4hlen",
+    description: "Choose an option by its visible label in a native select element. For custom dropdowns use browser_click on the trigger and the visible option.",
+    schema: Type.Object({ target: targetSchema, label: Type.String({ minLength: 1 }) }, { additionalProperties: false }),
+    resultSchema: snapshotSchema,
+    nativeTool: true,
+    available: alwaysAvailable,
+    executionMode: "sequential",
+    run: async ({ caller, signal }, toolCallId, input) => ({ ...await browser.select(caller.runId, input.target, input.label, { signal, toolCallId }) })
+  }),
+  defineRunFunction({
+    name: "browser_press",
+    label: "Browsertaste dr\xFCcken",
+    description: "Focus a target and press a Playwright key or chord such as Enter, Escape, Tab or ControlOrMeta+A. Returns the resulting page.",
+    schema: Type.Object({ target: targetSchema, key: Type.String({ minLength: 1 }) }, { additionalProperties: false }),
+    resultSchema: snapshotSchema,
+    nativeTool: true,
+    available: alwaysAvailable,
+    executionMode: "sequential",
+    run: async ({ caller, signal }, toolCallId, input) => ({ ...await browser.press(caller.runId, input.target, input.key, { signal, toolCallId }) })
+  }),
+  defineRunFunction({
+    name: "browser_check",
+    label: "Browserergebnis pr\xFCfen",
+    description: "Assert visible target/text, resulting URL and absence of browser errors. Fails on mismatch; records successful evidence for this page until the next action/navigation/error. Supply at least one assertion. Browser errors are checked by default. Visibility assertions wait at most 5 seconds, shorter than actions.",
+    schema: Type.Object({
+      target: Type.Optional(targetSchema),
+      text: Type.Optional(Type.String({ minLength: 1 })),
+      url: Type.Optional(Type.String({ minLength: 1 })),
+      count: Type.Optional(Type.Integer({ minimum: 0, description: "Expected number of visible matches of target instead of exactly one; 0 asserts absence. Requires target without nth or first." })),
+      noErrors: Type.Optional(Type.Boolean({ description: "true (default): the check also fails on any browser error collected since the last navigation. false: ignore browser errors and judge only the assertions; use this when the page has known noise such as 404s or third-party script errors that are not part of the check." }))
+    }, { additionalProperties: false }),
+    resultSchema: Type.Object({ checkedAt: Type.String(), url: Type.String(), assertions: Type.Array(Type.String()) }, { additionalProperties: false }),
+    nativeTool: true,
+    available: alwaysAvailable,
+    executionMode: "sequential",
+    run: ({ caller, signal }, toolCallId, input) => browser.check(caller.runId, input, { signal, toolCallId })
+  }),
+  defineRunFunction({
+    name: "browser_viewport",
+    label: "Browsergr\xF6\xDFe setzen",
+    description: "Resize the page viewport in CSS pixels, for example to check a narrow layout. The default is 1920 x 1080 (16:9) and screenshots use the viewport size at scale 1; the chosen size stays for the run until changed again. Returns the resulting page.",
+    schema: Type.Object({
+      width: Type.Integer({ minimum: 320, maximum: 3840 }),
+      height: Type.Integer({ minimum: 240, maximum: 2160 })
+    }, { additionalProperties: false }),
+    resultSchema: snapshotSchema,
+    available: alwaysAvailable,
+    executionMode: "sequential",
+    run: async ({ caller, signal }, toolCallId, input) => ({ ...await browser.viewport(caller.runId, input, { signal, toolCallId }) })
+  }),
+  defineRunFunction({
+    name: "browser_screenshot",
+    label: "Browser aufnehmen",
+    description: screenshotDescription,
+    schema: Type.Object({ label: Type.Optional(Type.String({ maxLength: 200 })), fullPage: Type.Optional(Type.Boolean()) }, { additionalProperties: false }),
+    resultSchema: Type.Object({
+      name: Type.String(),
+      path: Type.String(),
+      url: Type.String(),
+      markdown: Type.String(),
+      capturedAt: Type.String()
+    }, { additionalProperties: false }),
+    nativeTool: true,
+    available: alwaysAvailable,
+    executionMode: "sequential",
+    run: ({ caller, signal }, toolCallId, input) => browser.screenshot(caller.runId, input, { signal, toolCallId })
+  }),
+  defineRunFunction({
+    name: "browser_view_screenshot",
+    label: "Browseraufnahme ansehen",
+    description: "View this run's latest screenshot as native image input without a path. Invoke this native tool directly to receive pixels; calling it through TypeScript only verifies image availability. Requires an image-capable model for native image input.",
+    nativeTool: true,
+    schema: emptySchema,
+    resultSchema: Type.String(),
+    available: alwaysAvailable,
+    executionMode: "sequential",
+    run: async ({ caller, signal }) => {
+      signal?.throwIfAborted();
+      await browser.image(caller.runId);
+      return "Letzte Browseraufnahme dieses Runs ist verf\xFCgbar.";
+    }
+  }),
+  defineRunFunction({
+    name: "browser_close",
+    label: "Browser schlie\xDFen",
+    description: "Close this run's browser and discard its cookies. Saved screenshots remain in the document library.",
+    schema: emptySchema,
+    resultSchema: Type.Object({ closed: Type.Boolean() }, { additionalProperties: false }),
+    nativeTool: true,
+    available: alwaysAvailable,
+    executionMode: "sequential",
+    run: async ({ caller }) => {
+      await browser.close(caller.runId);
+      return { closed: true };
+    }
+  })
+];
+var createBrowserImageContribution = (browser) => ({
+  id: "ragents.browser.image",
+  afterToolCall: async ({ runId }, outcome, call) => {
+    if (outcome.toolName !== "browser_view_screenshot" || outcome.isError) return void 0;
+    try {
+      call.signal?.throwIfAborted();
+      if (!call.modelReadsImages) throw new Error("Das gew\xE4hlte Modell unterst\xFCtzt keine Bilder. Screenshot \xFCber die Dokumente ansehen oder ein bildf\xE4higes Modell w\xE4hlen.");
+      const data = (await browser.image(runId)).toString("base64");
+      call.signal?.throwIfAborted();
+      return { content: [
+        { type: "text", text: "Letzte Browseraufnahme dieses Runs." },
+        { type: "image", data, mimeType: "image/png" }
+      ] };
+    } catch (error) {
+      return { content: [{ type: "text", text: error instanceof Error ? error.message : String(error) }], isError: true };
+    }
+  }
+});
+
+// server/index.ts
+var browserConfigDescriptors = [{ key: BROWSER_EXECUTABLE_VARIABLE, source: "environment" }];
+var browserPlugin = {
+  manifest: { id: "ragents.browser" },
+  register: (host) => {
+    const documents = host.service(documentStoreToken);
+    const browser = new RunBrowser({
+      sandbox: host.service(sandboxServicesToken),
+      filesFor: (runId) => documents.directoryFor(runId)
+    });
+    host.config(...browserConfigDescriptors);
+    host.provide(browserRuntimeToken, browser);
+    host.functions(...createBrowserFunctions(browser));
+    host.agentRuntime(createBrowserImageContribution(browser));
+    host.lifecycle({
+      id: "ragents.browser.lifecycle",
+      prepareSession: ({ runId }) => browser.restore(runId),
+      stopSession: ({ runId }) => browser.close(runId),
+      afterStopSession: ({ runId }) => browser.close(runId),
+      deleteSession: ({ runId }) => browser.delete(runId),
+      shutdown: () => browser.shutdown()
+    });
+  }
+};
+var plugin = { requires: ["ragents.documents"], create: () => browserPlugin };
+
+// provision.ts
+import { spawn } from "node:child_process";
+import { access, constants } from "node:fs/promises";
+import path2 from "node:path";
+import { chromium } from "playwright-core";
+import { BROWSER_EXECUTABLE_VARIABLE as BROWSER_EXECUTABLE_VARIABLE2 } from "@ragents/workspace-executor";
+import {
+  hostPackageFolder,
+  provisionGap,
+  provisionReady
+} from "@ragents/host/plugin-support/provision.js";
+var executable = async (file) => access(file, constants.X_OK).then(() => true, () => false);
+var playwrightCli = () => path2.join(hostPackageFolder("playwright-core"), "cli.js");
+var install = (log) => new Promise((resolve, reject) => {
+  const child = spawn(process.execPath, [playwrightCli(), "install", ...process.platform === "linux" ? ["--with-deps"] : [], "chromium"], { stdio: ["ignore", "pipe", "pipe"] });
+  for (const stream of [child.stdout, child.stderr]) stream.on("data", (chunk) => log(chunk.toString().trimEnd()));
+  child.once("error", reject);
+  child.once("exit", (code) => code === 0 ? resolve() : reject(new Error(`playwright-core install chromium endete mit Code ${code}`)));
+});
+var createBrowserProvision = () => ({
+  check: async () => {
+    const configured = process.env[BROWSER_EXECUTABLE_VARIABLE2];
+    if (configured) {
+      return await executable(configured) ? provisionReady : provisionGap("browser", `${BROWSER_EXECUTABLE_VARIABLE2} nennt ${configured}; dort gibt es keinen ausf\xFChrbaren Browser`, false);
+    }
+    const bundled = chromium.executablePath();
+    return await executable(bundled) ? provisionReady : provisionGap("chromium", `Chromium fehlt unter ${bundled}; entweder ${BROWSER_EXECUTABLE_VARIABLE2} auf einen vorhandenen Chrome setzen (auf einem Server in der Profilsektion ragents.browser, auf einem Arbeitsplatz in seiner Umgebung) oder die Provisionierung den Browser laden lassen`, true);
+  },
+  apply: async (_target, log) => {
+    const state = await createBrowserProvision().check("");
+    if (state.kind === "ready") return;
+    if (!state.installable) throw new Error(state.instruction);
+    log("Chromium f\xFCr playwright-core laden");
+    await install(log);
+  }
+});
+var provision = createBrowserProvision();
+export {
+  browserConfigDescriptors,
+  plugin,
+  provision
+};
+//# sourceMappingURL=index.js.map

package/bundles/ragents.browser/server/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../plugins/ragents.browser/server/index.ts", "../../../plugins/ragents.browser/server/browser.ts", "../../../plugins/ragents.browser/server/tools.ts", "../../../plugins/ragents.browser/provision.ts"],
+  "sourcesContent": ["import type { RAgentsPlugin } from \"@ragents/engine\";\nimport { BROWSER_EXECUTABLE_VARIABLE } from \"@ragents/workspace-executor\";\nimport type { PluginModule } from \"@ragents/host/plugin-support/plugin-module.js\";\nimport { sandboxServicesToken } from \"@ragents/host/plugin-support/workspace-sandbox-host.js\";\nimport { documentStoreToken } from \"@ragents/host/ragents/document-store.js\";\nimport { RunBrowser } from \"./browser.js\";\nimport { browserRuntimeToken } from \"./contract.js\";\nimport { createBrowserFunctions, createBrowserImageContribution } from \"./tools.js\";\n\n/** Der Executor des Servers liest den Wert aus seiner Umgebung; ein Arbeitsplatz aus seiner eigenen, nie aus dem Profil. */\nexport const browserConfigDescriptors = [{ key: BROWSER_EXECUTABLE_VARIABLE, source: \"environment\" }] as const;\n\nconst browserPlugin: RAgentsPlugin = {\n  manifest: { id: \"ragents.browser\" },\n  register: (host) => {\n    const documents = host.service(documentStoreToken);\n    const browser = new RunBrowser({\n      sandbox: host.service(sandboxServicesToken),\n      filesFor: (runId) => documents.directoryFor(runId),\n    });\n    host.config(...browserConfigDescriptors);\n    host.provide(browserRuntimeToken, browser);\n    host.functions(...createBrowserFunctions(browser));\n    host.agentRuntime(createBrowserImageContribution(browser));\n    host.lifecycle({\n      id: \"ragents.browser.lifecycle\",\n      prepareSession: ({ runId }) => browser.restore(runId),\n      stopSession: ({ runId }) => browser.close(runId),\n      afterStopSession: ({ runId }) => browser.close(runId),\n      deleteSession: ({ runId }) => browser.delete(runId),\n      shutdown: () => browser.shutdown(),\n    });\n  },\n};\n\nexport const plugin: PluginModule = { requires: [\"ragents.documents\"], create: () => browserPlugin };\n", "import { randomUUID } from \"node:crypto\";\nimport { mkdir, readFile, rename, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport {\n  BROWSER_OPERATIONS,\n  type BrowserCheck,\n  type BrowserCheckResult,\n  type BrowserPageState,\n  type BrowserSnapshot,\n  type BrowserStep,\n  type BrowserTarget,\n  type BrowserViewport,\n} from \"@ragents/workspace-executor\";\nimport type { SandboxServices } from \"@ragents/host/plugin-support/workspace-sandbox-host.js\";\nimport { documentsApiPrefix } from \"@ragents/plugins/ragents.documents/contract.js\";\nimport type { BrowserCallOptions, BrowserEvidence, BrowserRuntime } from \"./contract.js\";\n\nexport const DEFAULT_VIEWPORT: BrowserViewport = { width: 1920, height: 1080 };\n\ninterface SavedCapture {\n  name: string;\n  path: string;\n}\n\n/** Was der Server von der Seite eines Runs wei\u00DF: den zuletzt gemeldeten Stand und die Zeit der letzten bestandenen Pr\u00FCfung. */\ninterface ObservedPage {\n  url: string;\n  checkedAt?: string;\n  errors: string[];\n  screenshots: string[];\n}\n\nexport interface BrowserOptions {\n  sandbox: Pick<SandboxServices, \"execute\">;\n  filesFor: (runId: string) => Promise<string>;\n}\n\nconst capturePath = (id: string): string => `browser/${id}.png`;\n\n/** Die Browserpr\u00FCfung eines Runs: die Seite lebt beim Executor des Runs, Evidenz, Aufnahmen und Viewport h\u00E4lt der Server. */\nexport class RunBrowser implements BrowserRuntime {\n  readonly #options: BrowserOptions;\n  readonly #pages = new Map<string, ObservedPage>();\n  readonly #viewports = new Map<string, BrowserViewport>();\n  readonly #captures = new Map<string, SavedCapture[]>();\n  readonly #captureLoads = new Map<string, Promise<void>>();\n  readonly #captureWrites = new Map<string, Promise<void>>();\n  readonly #generations = new Map<string, number>();\n  #shutdown = false;\n\n  constructor(options: BrowserOptions) {\n    this.#options = options;\n  }\n\n  restore(runId: string): Promise<void> {\n    const loading = this.#captureLoads.get(runId);\n    if (loading) return loading;\n    const pending = this.#restore(runId).catch((error) => { this.#captureLoads.delete(runId); throw error; });\n    this.#captureLoads.set(runId, pending);\n    return pending;\n  }\n\n  async open(runId: string, url: string, options: BrowserCallOptions = {}): Promise<BrowserSnapshot> {\n    options.signal?.throwIfAborted();\n    this.#assertRunning();\n    const generation = this.#generation(runId);\n    await this.restore(runId);\n    options.signal?.throwIfAborted();\n    this.#assertRunning();\n    if (generation !== this.#generation(runId)) throw new Error(\"Der Browser wurde beendet.\");\n    return this.#run(runId, BROWSER_OPERATIONS.open, { url, viewport: this.#viewports.get(runId) ?? DEFAULT_VIEWPORT }, options);\n  }\n\n  snapshot(runId: string, options: BrowserCallOptions = {}): Promise<BrowserSnapshot> {\n    return this.#run(runId, BROWSER_OPERATIONS.snapshot, null, options);\n  }\n\n  /** Der gew\u00E4hlte Viewport gilt f\u00FCr den Run, auch f\u00FCr einen sp\u00E4ter neu gestarteten Browser. */\n  async viewport(runId: string, viewport: BrowserViewport, options: BrowserCallOptions = {}): Promise<BrowserSnapshot> {\n    const snapshot = await this.#run<BrowserSnapshot>(runId, BROWSER_OPERATIONS.viewport, viewport, options);\n    this.#viewports.set(runId, viewport);\n    return snapshot;\n  }\n\n  click(runId: string, target: BrowserTarget, options: BrowserCallOptions = {}): Promise<BrowserSnapshot> {\n    return this.#run(runId, BROWSER_OPERATIONS.click, { target }, options);\n  }\n\n  fill(runId: string, target: BrowserTarget, value: string, options: BrowserCallOptions = {}): Promise<BrowserSnapshot> {\n    return this.#run(runId, BROWSER_OPERATIONS.fill, { target, value }, options);\n  }\n\n  select(runId: string, target: BrowserTarget, label: string, options: BrowserCallOptions = {}): Promise<BrowserSnapshot> {\n    return this.#run(runId, BROWSER_OPERATIONS.select, { target, label }, options);\n  }\n\n  press(runId: string, target: BrowserTarget, key: string, options: BrowserCallOptions = {}): Promise<BrowserSnapshot> {\n    return this.#run(runId, BROWSER_OPERATIONS.press, { target, key }, options);\n  }\n\n  /** Die Zeit einer bestandenen Pr\u00FCfung ist die des Servers, damit sie sich mit seinen \u00FCbrigen Zeiten vergleichen l\u00E4sst. */\n  async check(runId: string, input: BrowserCheck, options: BrowserCallOptions = {}): Promise<{ checkedAt: string; url: string; assertions: string[] }> {\n    const generation = this.#generation(runId);\n    const { result, page } = await this.#execute<BrowserCheckResult>(runId, generation, BROWSER_OPERATIONS.check, input, options);\n    const checkedAt = new Date().toISOString();\n    this.#observe(runId, generation, page, checkedAt);\n    return { checkedAt, url: result.url, assertions: result.assertions };\n  }\n\n  async screenshot(runId: string, input: { label?: string; fullPage?: boolean }, options: BrowserCallOptions = {}): Promise<{\n    name: string;\n    path: string;\n    url: string;\n    markdown: string;\n    capturedAt: string;\n  }> {\n    await this.restore(runId);\n    const id = randomUUID();\n    const image = await this.#run<string>(runId, BROWSER_OPERATIONS.screenshot, { id, fullPage: input.fullPage ?? false }, options);\n    const capture = { name: input.label?.trim() || \"Browseraufnahme\", path: capturePath(id) };\n    await this.#store(runId, capture, Buffer.from(image, \"base64\"));\n    const url = this.#captureUrl(runId, capture.path);\n    return {\n      ...capture,\n      url,\n      markdown: `![${capture.name.replace(/[\\[\\]\\\\]/g, \"\")}](${url})`,\n      capturedAt: new Date().toISOString(),\n    };\n  }\n\n  async image(runId: string): Promise<Buffer> {\n    const latest = this.#captures.get(runId)?.at(-1);\n    if (!latest) throw new Error(\"F\u00FCr diesen Run gibt es noch keinen Browser-Screenshot. Zuerst browser_screenshot aufrufen.\");\n    return readFile(path.join(await this.#options.filesFor(runId), latest.path));\n  }\n\n  evidence(runId: string): BrowserEvidence {\n    const captures = this.#captures.get(runId) ?? [];\n    const shown = (capture: SavedCapture) => ({ name: capture.name, url: this.#captureUrl(runId, capture.path) });\n    const screenshots = captures.map(shown);\n    const page = this.#pages.get(runId);\n    if (!page) return { screenshots, currentScreenshots: [], errors: [] };\n    const current = page.screenshots\n      .map((id) => captures.find((capture) => capture.path === capturePath(id)))\n      .filter((capture): capture is SavedCapture => capture !== undefined);\n    return {\n      ...(page.checkedAt ? { checkedAt: page.checkedAt } : {}),\n      url: page.url,\n      screenshots,\n      currentScreenshots: current.map(shown),\n      errors: [...page.errors],\n    };\n  }\n\n  /** Schlie\u00DFt den Browser beim Executor des Runs; ein nicht verbundener Arbeitsplatz h\u00E4lt nichts, was sich jetzt schlie\u00DFen lie\u00DFe. */\n  async close(runId: string): Promise<void> {\n    this.#forget(runId);\n    await this.#options.sandbox.execute(runId, BROWSER_OPERATIONS.close, null, { whenReachable: true });\n  }\n\n  async delete(runId: string): Promise<void> {\n    await this.close(runId);\n    this.#viewports.delete(runId);\n    this.#captures.delete(runId);\n    this.#captureLoads.delete(runId);\n    this.#captureWrites.delete(runId);\n  }\n\n  async shutdown(): Promise<void> {\n    this.#shutdown = true;\n    const results = await Promise.allSettled([...this.#pages.keys()].map((runId) => this.close(runId)));\n    this.#viewports.clear();\n    this.#captures.clear();\n    this.#captureLoads.clear();\n    this.#captureWrites.clear();\n    const failed = results.find((result): result is PromiseRejectedResult => result.status === \"rejected\");\n    if (failed) throw failed.reason;\n  }\n\n  #assertRunning(): void {\n    if (this.#shutdown) throw new Error(\"Der Browserdienst ist beendet.\");\n  }\n\n  #generation(runId: string): number {\n    return this.#generations.get(runId) ?? 0;\n  }\n\n  /** Ein geschlossener Browser hat keine Seite mehr; Ergebnisse, die vorher begonnen haben, z\u00E4hlen danach nicht. */\n  #forget(runId: string): void {\n    this.#generations.set(runId, this.#generation(runId) + 1);\n    this.#pages.delete(runId);\n  }\n\n  async #run<T>(runId: string, operation: string, input: unknown, options: BrowserCallOptions): Promise<T> {\n    const generation = this.#generation(runId);\n    const { result, page } = await this.#execute<T>(runId, generation, operation, input, options);\n    this.#observe(runId, generation, page);\n    return result;\n  }\n\n  async #execute<T>(runId: string, generation: number, operation: string, input: unknown, options: BrowserCallOptions): Promise<BrowserStep<T>> {\n    try {\n      return await this.#options.sandbox.execute(runId, operation, input, options) as BrowserStep<T>;\n    } catch (error) {\n      await this.#resync(runId, generation);\n      throw error;\n    }\n  }\n\n  /** Nach einem gescheiterten Aufruf fragt der Server den Stand der Seite nach; wer ihn nicht nennen kann, hat keine Seite. */\n  async #resync(runId: string, generation: number): Promise<void> {\n    const page = await this.#options.sandbox.execute(runId, BROWSER_OPERATIONS.state, null, { whenReachable: true })\n      .then((value) => value as BrowserPageState | null, () => null);\n    this.#observe(runId, generation, page);\n  }\n\n  /** Nur eine bestandene Pr\u00FCfung setzt die Zeit; jeder andere Stand beh\u00E4lt sie, solange die Seite gepr\u00FCft bleibt. */\n  #observe(runId: string, generation: number, page: BrowserPageState | null, checkedAt?: string): void {\n    if (generation !== this.#generation(runId)) return;\n    if (!page) {\n      this.#pages.delete(runId);\n      return;\n    }\n    const stamp = page.checked ? checkedAt ?? this.#pages.get(runId)?.checkedAt : undefined;\n    this.#pages.set(runId, {\n      url: page.url,\n      errors: page.errors,\n      screenshots: page.screenshots,\n      ...(stamp ? { checkedAt: stamp } : {}),\n    });\n  }\n\n  /** Legt eine Aufnahme in die Dateiablage des Runs und schreibt die Aufnahmeliste atomar; die Aufnahmen eines Runs der Reihe nach. */\n  #store(runId: string, capture: SavedCapture, image: Buffer): Promise<void> {\n    const previous = this.#captureWrites.get(runId) ?? Promise.resolve();\n    const pending = previous.then(async () => {\n      const directory = await this.#options.filesFor(runId);\n      await mkdir(path.join(directory, \"browser\"), { recursive: true });\n      await writeFile(path.join(directory, capture.path), image);\n      const captures = [...this.#captures.get(runId) ?? [], capture];\n      const manifest = path.join(directory, \"browser\", \".captures.json\");\n      const temporary = `${manifest}.${randomUUID()}.tmp`;\n      await writeFile(temporary, JSON.stringify(captures), \"utf8\");\n      await rename(temporary, manifest);\n      this.#captures.set(runId, captures);\n    });\n    this.#captureWrites.set(runId, pending.then(() => undefined, () => undefined));\n    return pending;\n  }\n\n  #captureUrl(runId: string, filename: string): string {\n    return `${documentsApiPrefix}/runs/${encodeURIComponent(runId)}/files/content?path=${encodeURIComponent(filename)}`;\n  }\n\n  async #restore(runId: string): Promise<void> {\n    const directory = await this.#options.filesFor(runId);\n    const manifest = path.join(directory, \"browser\", \".captures.json\");\n    let content: string;\n    try { content = await readFile(manifest, \"utf8\"); }\n    catch (error) {\n      if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n      this.#captures.set(runId, []);\n      return;\n    }\n    const captures: unknown = JSON.parse(content);\n    if (!Array.isArray(captures) || captures.some((entry) => !entry || typeof entry.name !== \"string\"\n      || typeof entry.path !== \"string\" || !/^browser\\/[a-f0-9-]{36}\\.png$/.test(entry.path))) {\n      throw new Error(\"Die gespeicherte Browser-Aufnahmeliste dieses Runs ist besch\u00E4digt.\");\n    }\n    this.#captures.set(runId, captures);\n  }\n}\n", "import { Type } from \"typebox\";\nimport { defineRunFunction, type AgentContribution, type RunFunction } from \"@ragents/engine\";\nimport { alwaysAvailable } from \"@ragents/host/plugin-support/tool-availability.js\";\nimport { RunBrowser } from \"./browser.js\";\n\nconst targetSchema = Type.Object({\n  role: Type.Optional(Type.String({ minLength: 1, description: \"Accessible role, e.g. button, textbox, link, combobox.\" })),\n  name: Type.Optional(Type.String({ description: \"Exact accessible name for role.\" })),\n  label: Type.Optional(Type.String({ minLength: 1, description: \"Exact form label.\" })),\n  text: Type.Optional(Type.String({ minLength: 1, description: \"Exact visible text.\" })),\n  testId: Type.Optional(Type.String({ minLength: 1, description: \"data-testid value.\" })),\n  css: Type.Optional(Type.String({ minLength: 1, description: \"CSS selector for elements without useful accessible names.\" })),\n  frame: Type.Optional(Type.String({ minLength: 1, description: \"CSS selector of an iframe containing the target.\" })),\n  nth: Type.Optional(Type.Integer({ minimum: 0, description: \"0-based index among all matches when the target matches several elements; not together with first.\" })),\n  first: Type.Optional(Type.Boolean({ description: \"Use the first match when the target matches several elements; not together with nth.\" })),\n}, { additionalProperties: false, description: \"Use exactly one of role (with optional name), label, text, testId, css. Resolve semantic targets server-side; never copy snapshot element IDs. Ambiguous targets are errors naming the candidates unless nth or first selects one.\" });\n\nconst snapshotSchema = Type.Object({\n  url: Type.String(),\n  title: Type.String(),\n  snapshot: Type.String(),\n  truncated: Type.Boolean(),\n  errors: Type.Array(Type.String()),\n}, { additionalProperties: false });\n\nconst emptySchema = Type.Object({}, { additionalProperties: false });\nconst targetInputSchema = Type.Object({ target: targetSchema }, { additionalProperties: false });\nconst screenshotDescription = \"Capture the real browser page into this run's document library. The returned URL and Markdown display it to the user. Call browser_view_screenshot to inspect the latest capture as an image without copying a path.\";\n\nexport const createBrowserFunctions = (browser: RunBrowser): RunFunction[] => [\n  defineRunFunction({\n    name: \"browser_open\",\n    label: \"Browser \u00F6ffnen\",\n    description: \"Open an HTTP(S) page in this run's isolated headless browser. Returns its accessible structure and browser errors. Reuses the current run browser; other runs have separate cookies and processes.\",\n    schema: Type.Object({ url: Type.String({ minLength: 1 }) }, { additionalProperties: false }),\n    resultSchema: snapshotSchema,\n    nativeTool: true,\n    available: alwaysAvailable,\n    executionMode: \"sequential\",\n    run: async ({ caller, signal }, toolCallId, input) => ({ ...await browser.open(caller.runId, input.url, { signal, toolCallId }) }),\n  }),\n  defineRunFunction({\n    name: \"browser_snapshot\",\n    label: \"Browser lesen\",\n    description: \"Read the current real page's accessible structure, title, URL and errors. Use role/name or labels for subsequent actions; snapshot reference IDs never need to be copied.\",\n    schema: emptySchema,\n    resultSchema: snapshotSchema,\n    nativeTool: true,\n    available: alwaysAvailable,\n    executionMode: \"sequential\",\n    run: async ({ caller, signal }, toolCallId) => ({ ...await browser.snapshot(caller.runId, { signal, toolCallId }) }),\n  }),\n  defineRunFunction({\n    name: \"browser_click\",\n    label: \"Im Browser klicken\",\n    description: \"Click a uniquely identified visible element with Playwright auto-waiting. Returns the actual resulting page. Ambiguous or absent targets are errors.\",\n    schema: targetInputSchema,\n    resultSchema: snapshotSchema,\n    nativeTool: true,\n    available: alwaysAvailable,\n    executionMode: \"sequential\",\n    run: async ({ caller, signal }, toolCallId, input) => ({ ...await browser.click(caller.runId, input.target, { signal, toolCallId }) }),\n  }),\n  defineRunFunction({\n    name: \"browser_fill\",\n    label: \"Browserfeld ausf\u00FCllen\",\n    description: \"Fill an input or textarea by accessible label or another semantic target, firing the normal input events. Returns the resulting page.\",\n    schema: Type.Object({ target: targetSchema, value: Type.String() }, { additionalProperties: false }),\n    resultSchema: snapshotSchema,\n    nativeTool: true,\n    available: alwaysAvailable,\n    executionMode: \"sequential\",\n    run: async ({ caller, signal }, toolCallId, input) => ({ ...await browser.fill(caller.runId, input.target, input.value, { signal, toolCallId }) }),\n  }),\n  defineRunFunction({\n    name: \"browser_select\",\n    label: \"Im Browser ausw\u00E4hlen\",\n    description: \"Choose an option by its visible label in a native select element. For custom dropdowns use browser_click on the trigger and the visible option.\",\n    schema: Type.Object({ target: targetSchema, label: Type.String({ minLength: 1 }) }, { additionalProperties: false }),\n    resultSchema: snapshotSchema,\n    nativeTool: true,\n    available: alwaysAvailable,\n    executionMode: \"sequential\",\n    run: async ({ caller, signal }, toolCallId, input) => ({ ...await browser.select(caller.runId, input.target, input.label, { signal, toolCallId }) }),\n  }),\n  defineRunFunction({\n    name: \"browser_press\",\n    label: \"Browsertaste dr\u00FCcken\",\n    description: \"Focus a target and press a Playwright key or chord such as Enter, Escape, Tab or ControlOrMeta+A. Returns the resulting page.\",\n    schema: Type.Object({ target: targetSchema, key: Type.String({ minLength: 1 }) }, { additionalProperties: false }),\n    resultSchema: snapshotSchema,\n    nativeTool: true,\n    available: alwaysAvailable,\n    executionMode: \"sequential\",\n    run: async ({ caller, signal }, toolCallId, input) => ({ ...await browser.press(caller.runId, input.target, input.key, { signal, toolCallId }) }),\n  }),\n  defineRunFunction({\n    name: \"browser_check\",\n    label: \"Browserergebnis pr\u00FCfen\",\n    description: \"Assert visible target/text, resulting URL and absence of browser errors. Fails on mismatch; records successful evidence for this page until the next action/navigation/error. Supply at least one assertion. Browser errors are checked by default. Visibility assertions wait at most 5 seconds, shorter than actions.\",\n    schema: Type.Object({\n      target: Type.Optional(targetSchema),\n      text: Type.Optional(Type.String({ minLength: 1 })),\n      url: Type.Optional(Type.String({ minLength: 1 })),\n      count: Type.Optional(Type.Integer({ minimum: 0, description: \"Expected number of visible matches of target instead of exactly one; 0 asserts absence. Requires target without nth or first.\" })),\n      noErrors: Type.Optional(Type.Boolean({ description: \"true (default): the check also fails on any browser error collected since the last navigation. false: ignore browser errors and judge only the assertions; use this when the page has known noise such as 404s or third-party script errors that are not part of the check.\" })),\n    }, { additionalProperties: false }),\n    resultSchema: Type.Object({ checkedAt: Type.String(), url: Type.String(), assertions: Type.Array(Type.String()) }, { additionalProperties: false }),\n    nativeTool: true,\n    available: alwaysAvailable,\n    executionMode: \"sequential\",\n    run: ({ caller, signal }, toolCallId, input) => browser.check(caller.runId, input, { signal, toolCallId }),\n  }),\n  defineRunFunction({\n    name: \"browser_viewport\",\n    label: \"Browsergr\u00F6\u00DFe setzen\",\n    description: \"Resize the page viewport in CSS pixels, for example to check a narrow layout. The default is 1920 x 1080 (16:9) and screenshots use the viewport size at scale 1; the chosen size stays for the run until changed again. Returns the resulting page.\",\n    schema: Type.Object({\n      width: Type.Integer({ minimum: 320, maximum: 3840 }),\n      height: Type.Integer({ minimum: 240, maximum: 2160 }),\n    }, { additionalProperties: false }),\n    resultSchema: snapshotSchema,\n    available: alwaysAvailable,\n    executionMode: \"sequential\",\n    run: async ({ caller, signal }, toolCallId, input) => ({ ...await browser.viewport(caller.runId, input, { signal, toolCallId }) }),\n  }),\n  defineRunFunction({\n    name: \"browser_screenshot\",\n    label: \"Browser aufnehmen\",\n    description: screenshotDescription,\n    schema: Type.Object({ label: Type.Optional(Type.String({ maxLength: 200 })), fullPage: Type.Optional(Type.Boolean()) }, { additionalProperties: false }),\n    resultSchema: Type.Object({\n      name: Type.String(),\n      path: Type.String(),\n      url: Type.String(),\n      markdown: Type.String(),\n      capturedAt: Type.String(),\n    }, { additionalProperties: false }),\n    nativeTool: true,\n    available: alwaysAvailable,\n    executionMode: \"sequential\",\n    run: ({ caller, signal }, toolCallId, input) => browser.screenshot(caller.runId, input, { signal, toolCallId }),\n  }),\n  defineRunFunction({\n    name: \"browser_view_screenshot\",\n    label: \"Browseraufnahme ansehen\",\n    description: \"View this run's latest screenshot as native image input without a path. Invoke this native tool directly to receive pixels; calling it through TypeScript only verifies image availability. Requires an image-capable model for native image input.\",\n    nativeTool: true,\n    schema: emptySchema,\n    resultSchema: Type.String(),\n    available: alwaysAvailable,\n    executionMode: \"sequential\",\n    run: async ({ caller, signal }) => {\n      signal?.throwIfAborted();\n      await browser.image(caller.runId);\n      return \"Letzte Browseraufnahme dieses Runs ist verf\u00FCgbar.\";\n    },\n  }),\n  defineRunFunction({\n    name: \"browser_close\",\n    label: \"Browser schlie\u00DFen\",\n    description: \"Close this run's browser and discard its cookies. Saved screenshots remain in the document library.\",\n    schema: emptySchema,\n    resultSchema: Type.Object({ closed: Type.Boolean() }, { additionalProperties: false }),\n    nativeTool: true,\n    available: alwaysAvailable,\n    executionMode: \"sequential\",\n    run: async ({ caller }) => { await browser.close(caller.runId); return { closed: true }; },\n  }),\n];\n\nexport const createBrowserImageContribution = (browser: RunBrowser): AgentContribution => ({\n  id: \"ragents.browser.image\",\n  afterToolCall: async ({ runId }, outcome, call) => {\n    if (outcome.toolName !== \"browser_view_screenshot\" || outcome.isError) return undefined;\n    try {\n      call.signal?.throwIfAborted();\n      if (!call.modelReadsImages) throw new Error(\"Das gew\u00E4hlte Modell unterst\u00FCtzt keine Bilder. Screenshot \u00FCber die Dokumente ansehen oder ein bildf\u00E4higes Modell w\u00E4hlen.\");\n      const data = (await browser.image(runId)).toString(\"base64\");\n      call.signal?.throwIfAborted();\n      return { content: [\n        { type: \"text\", text: \"Letzte Browseraufnahme dieses Runs.\" },\n        { type: \"image\", data, mimeType: \"image/png\" },\n      ] };\n    } catch (error) {\n      return { content: [{ type: \"text\", text: error instanceof Error ? error.message : String(error) }], isError: true };\n    }\n  },\n});\n", "import { spawn } from \"node:child_process\";\nimport { access, constants } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { chromium } from \"playwright-core\";\nimport { BROWSER_EXECUTABLE_VARIABLE } from \"@ragents/workspace-executor\";\nimport {\n  hostPackageFolder,\n  provisionGap,\n  provisionReady,\n  type PluginProvision,\n} from \"@ragents/host/plugin-support/provision.js\";\n\nconst executable = async (file: string): Promise<boolean> => access(file, constants.X_OK).then(() => true, () => false);\n\nconst playwrightCli = (): string => path.join(hostPackageFolder(\"playwright-core\"), \"cli.js\");\n\nconst install = (log: (line: string) => void): Promise<void> => new Promise((resolve, reject) => {\n  const child = spawn(process.execPath, [playwrightCli(), \"install\", ...(process.platform === \"linux\" ? [\"--with-deps\"] : []), \"chromium\"], { stdio: [\"ignore\", \"pipe\", \"pipe\"] });\n  for (const stream of [child.stdout, child.stderr]) stream.on(\"data\", (chunk: Buffer) => log(chunk.toString().trimEnd()));\n  child.once(\"error\", reject);\n  child.once(\"exit\", (code) => code === 0 ? resolve() : reject(new Error(`playwright-core install chromium endete mit Code ${code}`)));\n});\n\n// Playwright verwaltet seinen Browsercache selbst; der Werkzeugordner des Plugins bleibt leer.\nexport const createBrowserProvision = (): PluginProvision => ({\n  check: async () => {\n    const configured = process.env[BROWSER_EXECUTABLE_VARIABLE];\n    if (configured) {\n      return await executable(configured)\n        ? provisionReady\n        : provisionGap(\"browser\", `${BROWSER_EXECUTABLE_VARIABLE} nennt ${configured}; dort gibt es keinen ausf\u00FChrbaren Browser`, false);\n    }\n    const bundled = chromium.executablePath();\n    return await executable(bundled)\n      ? provisionReady\n      : provisionGap(\"chromium\", `Chromium fehlt unter ${bundled}; entweder ${BROWSER_EXECUTABLE_VARIABLE} auf einen vorhandenen Chrome `\n        + \"setzen (auf einem Server in der Profilsektion ragents.browser, auf einem Arbeitsplatz in seiner Umgebung) oder die \"\n        + \"Provisionierung den Browser laden lassen\", true);\n  },\n  apply: async (_target, log) => {\n    const state = await createBrowserProvision().check(\"\");\n    if (state.kind === \"ready\") return;\n    if (!state.installable) throw new Error(state.instruction);\n    log(\"Chromium f\u00FCr playwright-core laden\");\n    await install(log);\n  },\n});\n\nexport const provision = createBrowserProvision();\n"],
+  "mappings": "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",
+  "names": ["path", "BROWSER_EXECUTABLE_VARIABLE"]
+}

package/bundles/ragents.browser/skills/browser-testing/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: browser-testing
+description: Prüfe eine laufende Webanwendung mit echten Browseraktionen, sichtbaren Ergebnissen und Screenshots.
+---
+
+# Webanwendung prüfen
+
+Verwende die TypeScript-Funktionen `browser_open`, `browser_snapshot`, `browser_click`,
+`browser_fill`, `browser_select`, `browser_press`, `browser_check`, `browser_viewport`,
+`browser_screenshot` und `browser_close`. Lade deren genaue Verträge mit `typescript_api`.
+
+1. Starte die Anwendung mit ihren tatsächlichen Diensten und warte auf deren Bereitschaft.
+2. Öffne ihre HTTP-Adresse mit `browser_open`. Jeder Run hat einen eigenen Browser ohne
+   übernommene Anmeldung. Er läuft auf dem Rechner Deines Arbeitsbereichs; eine dort gestartete
+   Anwendung erreichst Du über `localhost`. Melde fehlende Dienste und Browser-Voraussetzungen
+   ausdrücklich.
+3. Lies den Snapshot und bediene den tatsächlichen Nutzerweg. Wähle Ziele über sichtbare
+   Rollen/Namen oder Feldbeschriftungen, beispielsweise `{ role: "button", name: "Speichern" }`.
+   Die Auflösung erfolgt im Browser. Snapshot-IDs werden nicht abgeschrieben.
+4. Prüfe Erfolg und relevante Fehlerfälle mit `browser_check`: sichtbares Ergebnis, Zieladresse
+   und Browserfehler. Ein Typecheck oder Screenshot allein belegt keinen erfolgreichen Nutzerweg.
+   Nach jeder Aktion ist eine neue Prüfung nötig. Erfinde keine Ergebnisse bei fehlendem Netz.
+5. Erzeuge mit `browser_screenshot` echte Aufnahmen. Übernimm `url` oder `markdown`
+   programmatisch in den Ergebnisbericht oder die Mini-App. Das Bild liegt in der Dateiablage
+   dieses Runs. Das native Werkzeug `browser_view_screenshot` zeigt Dir die letzte Aufnahme
+   ohne Pfadangabe; dafür benötigt Dein Modell Bildunterstützung. Der Viewport ist standardmäßig
+   1920 x 1080 (16:9); für schmale Layouts oder kleine Bildschirme stellst Du ihn mit
+   `browser_viewport` um und prüfst danach erneut.
+6. Benenne geprüfte Schritte und verbleibende Grenzen. Schließe den Browser nach Abschluss;
+   Aufnahmen bleiben erhalten. Run-Stopp und Serverende schließen ihn ebenfalls.
+
+Die Browseraktionen verwenden Playwright-Locators mit automatischem Warten. Mehrdeutige Ziele
+sind Fehler, die die Kandidaten nennen; wähle dann mit `nth` (0-basiert) oder `first: true` im
+Ziel einen Treffer, oder prüfe die Anzahl sichtbarer Treffer mit `count` in `browser_check`.
+Sichtbarkeitsprüfungen warten höchstens 5 Sekunden, Aktionen länger; ein fehlendes Element
+kostet also keine lange Wartezeit. Native Selects verwenden `browser_select`; eigene Auswahlmenüs werden geklickt.
+Mit `target.frame` wählst Du ein Iframe per CSS. Neue Fenster werden ausdrücklich gemeldet;
+dieser Ablauf bedient eine Seite. Verdeckte Elemente werden nicht per JavaScript angeklickt.

package/bundles/ragents.documents/prompt.hbs

@@ -0,0 +1,18 @@
+# File store and documents
+
+This run has a file store outside the working directory. It is not a path in bash; the only way
+to put something there is the tool `document_write`.
+
+- Create one subdirectory per topic: `<topic>/<file>`.
+- Put documents, reports and temporary products there - NOT into the working directory, unless
+  they are part of the actual assignment.
+- `document_write` takes the full `content` of the file. For a file of the working directory,
+  `read` it first and pass the content here.
+- The user sees these files in the "Dokumente" area of the interface, grouped by subdirectory.
+- When you spawn agents, name in their assignment the store path they are supposed to write to.
+
+If the user wants to see the content of a file or a document, show it COMPLETELY via
+`show_document` (title = file name or document name) - never paraphrase or shorten. Files of the
+file store you show via `path`, relative to the store. Everything else - files from your working
+directory and content you produced yourself - you pass via `content`; `path` finds nothing outside
+the file store.