@relauts/spotcheck-service 1.0.0

package/README.md

@@ -0,0 +1,169 @@
+# @relauts/spotcheck-service
+
+Local HTTP API that runs a Gemini computer-use agent in a Playwright Chromium session.
+
+No UI. The server always binds to `127.0.0.1`. Callers send a Bearer token. You can save flows, replay them, and read run history.
+
+License: AGPL-3.0-or-later. See [LICENSE](LICENSE) and [NOTICE](NOTICE).
+
+## Install
+
+```bash
+npm install @relauts/spotcheck-service
+npx playwright install chromium
+```
+
+Copy the example config into the folder where you will run the CLI:
+
+```bash
+cp node_modules/@relauts/spotcheck-service/relauts-spotcheck-service-config.example.json ./relauts-spotcheck-service-config.json
+```
+
+Set at least `apiToken` and `geminiApiKey`. Then:
+
+```bash
+npx spotcheck-service
+```
+
+The service listens on `http://127.0.0.1:18732` by default.
+
+Config is read from `relauts-spotcheck-service-config.json` in the current working directory. If that file is missing, the service looks next to the package folder (git clone layout).
+
+## Requirements
+
+- Node.js `>=18.18.0`
+- Chromium for Playwright: `npx playwright install chromium`
+
+## From source
+
+Config can also sit **next to this repo**, not inside it:
+
+```
+parent/
+  relauts-spotcheck-service/
+  relauts-spotcheck-service-config.json
+```
+
+```bash
+cp relauts-spotcheck-service-config.example.json ../relauts-spotcheck-service-config.json
+```
+
+Set at least `apiToken` and `geminiApiKey`. Do not commit the real config file.
+
+```bash
+npm install
+npx playwright install chromium
+npm run dev
+```
+
+Or:
+
+```bash
+npm start
+```
+
+CLI after build: `spotcheck-service`.
+
+## Auth
+
+All `/v1/*` routes require:
+
+```http
+Authorization: Bearer <apiToken>
+```
+
+Exception: `GET /v1/health` (no auth).
+
+Token compare uses SHA-256 digests + `timingSafeEqual`.
+
+## Endpoints
+
+| Method | Path | Auth | Body / notes |
+|---|---|---|---|
+| `GET` | `/v1/health` | no | `{ "ok": true }` |
+| `GET` | `/v1/models` | yes | model list from `files/model.json` |
+| `POST` | `/v1/agent` | yes | `{ "task", "model" }` → NDJSON stream |
+| `POST` | `/v1/agent/safety` | yes | `{ "id", "confirmed" }` |
+| `GET` | `/v1/session` | yes | `{ "open", "url" }` |
+| `POST` | `/v1/session/back` | yes | navigate back |
+| `POST` | `/v1/session/forward` | yes | navigate forward |
+| `POST` | `/v1/session/reload` | yes | reload |
+| `GET` | `/v1/screenshot` | yes | `{ "imageName": "..." }` |
+| `GET` | `/v1/saved` | yes | `{ "files": [...] }` |
+| `GET` | `/v1/saved/running` | yes | `{ "files": [...] }` currently running saved runs |
+| `POST` | `/v1/saved` | yes | `{ "fileName", "items" }` |
+| `GET` | `/v1/saved/:fileName` | yes | saved flow |
+| `PUT` | `/v1/saved/:fileName` | yes | `{ "items" }` |
+| `DELETE` | `/v1/saved/:fileName` | yes | delete |
+| `GET` | `/v1/saved/create-default.json` | yes | create-tab default |
+| `PUT` | `/v1/saved/create-default.json` | yes | `{ "items" }` |
+| `GET` | `/v1/history` | yes | `{ "runs": [{ "historyFile", "status" }] }` all history runs |
+| `POST` | `/v1/history/detail` | yes | `{ "historyFile" }` prompts, results, models, screenshots |
+| `POST` | `/v1/saved/run` | yes | `{ "fileName" }` start a saved run |
+| `POST` | `/v1/history/status` | yes | `{ "fileName" }` latest run status |
+| `POST` | `/v1/history/stop` | yes | `{ "fileName" }` stop latest run |
+
+Errors: `{ "error": "message" }` with HTTP status.
+
+Agent NDJSON events match the original Spotcheck UI contract (`intent`, `safety_confirm`, `done`, `error`).
+
+Full request and response shapes: [openapi.yaml](openapi.yaml).
+
+## Curl examples
+
+Health:
+
+```bash
+curl -s http://127.0.0.1:18732/v1/health
+```
+
+Models:
+
+```bash
+curl -s http://127.0.0.1:18732/v1/models \
+  -H "Authorization: Bearer <apiToken>"
+```
+
+Screenshot:
+
+```bash
+curl -s http://127.0.0.1:18732/v1/screenshot \
+  -H "Authorization: Bearer <apiToken>"
+```
+
+Run agent:
+
+```bash
+curl -N http://127.0.0.1:18732/v1/agent \
+  -H "Authorization: Bearer <apiToken>" \
+  -H "Content-Type: application/json" \
+  -d '{"task":"go to https://example.com and check the page loads","model":"gemini-3.6-flash"}'
+```
+
+## CORS
+
+Set `corsOrigins` in the config JSON to an allow list. No credentials. Preflight: `OPTIONS`.
+
+## Develop
+
+```bash
+npm test
+npm run typecheck
+```
+
+How to send a PR: [CONTRIBUTING.md](CONTRIBUTING.md).
+
+Install from npm: `npm install @relauts/spotcheck-service`.
+
+Local run data (`saved/`, `processed/`, `history/`) stays on disk and is gitignored.
+
+## License
+
+Spotcheck is free software: you can redistribute it and/or modify it under
+the terms of the GNU Affero General Public License as published by the
+Free Software Foundation, either version 3 of the License, or (at your
+option) any later version.
+
+See `LICENSE` and `NOTICE`.
+
+The names Relauts and Spotcheck are trademarks of Relauts Pvt. Ltd.

package/dist/api/auth.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Extracts the raw token from an Authorization header.
+ * Only the Bearer scheme is accepted.
+ */
+export declare function extractBearerToken(authorizationHeader: string | undefined): string | undefined;
+/**
+ * Compares tokens in constant time by hashing both to fixed-length digests first.
+ * Avoids leaking token length via early return on Buffer length mismatch.
+ */
+export declare function tokensEqual(expected: string, provided: string): boolean;
+export declare function isAuthorized(authorizationHeader: string | undefined, expectedToken: string): boolean;

package/dist/api/auth.js

@@ -0,0 +1,32 @@
+import { createHash, timingSafeEqual } from "node:crypto";
+/**
+ * Extracts the raw token from an Authorization header.
+ * Only the Bearer scheme is accepted.
+ */
+export function extractBearerToken(authorizationHeader) {
+    if (!authorizationHeader) {
+        return undefined;
+    }
+    const match = /^Bearer\s+(\S+)\s*$/i.exec(authorizationHeader);
+    if (!match) {
+        return undefined;
+    }
+    return match[1];
+}
+/**
+ * Compares tokens in constant time by hashing both to fixed-length digests first.
+ * Avoids leaking token length via early return on Buffer length mismatch.
+ */
+export function tokensEqual(expected, provided) {
+    const expectedDigest = createHash("sha256").update(expected, "utf8").digest();
+    const providedDigest = createHash("sha256").update(provided, "utf8").digest();
+    return timingSafeEqual(expectedDigest, providedDigest);
+}
+export function isAuthorized(authorizationHeader, expectedToken) {
+    const provided = extractBearerToken(authorizationHeader);
+    if (provided === undefined) {
+        return false;
+    }
+    return tokensEqual(expectedToken, provided);
+}
+//# sourceMappingURL=auth.js.map

package/dist/api/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/api/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE1D;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,mBAAuC;IACxE,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAG,sBAAsB,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC/D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,QAAgB;IAC5D,MAAM,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC;IAC9E,MAAM,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC;IAC9E,OAAO,eAAe,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,mBAAuC,EACvC,aAAqB;IAErB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,mBAAmB,CAAC,CAAC;IACzD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,WAAW,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;AAC9C,CAAC"}

package/dist/api/history.d.ts

@@ -0,0 +1,46 @@
+import { type SavedPromptItem } from "./saved.js";
+export declare const HISTORY_DIR: string;
+export declare const HISTORY_RUN_STATUSES: readonly ["running", "done", "error", "stopped"];
+export type HistoryRunStatus = (typeof HISTORY_RUN_STATUSES)[number];
+export type HistoryItemStatus = "pending" | "running" | "done" | "error" | "skipped";
+export interface HistoryRunSummary {
+    readonly historyFile: string;
+    readonly status: HistoryRunStatus;
+}
+export interface HistoryDetailItem {
+    readonly sequence: number;
+    readonly prompt: string;
+    readonly model: string;
+    readonly resultText?: string;
+    readonly screenshots: readonly string[];
+}
+export interface HistoryItem {
+    readonly sequence: number;
+    readonly id: string;
+    readonly prompt: string;
+    readonly model: string;
+    readonly status: HistoryItemStatus;
+    readonly resultText?: string;
+    readonly costUsd?: number;
+    readonly error?: string;
+}
+export interface HistoryDocument {
+    readonly fileName: string;
+    readonly status: HistoryRunStatus;
+    readonly current: number;
+    readonly total: number;
+    readonly items: readonly HistoryItem[];
+}
+export declare function makeHistoryFileName(savedFileName: string, now?: Date): string;
+export declare function createHistoryDocument(savedFileName: string, items: readonly SavedPromptItem[]): HistoryDocument;
+export declare function serializeHistoryDetailItem(item: HistoryItem, screenshots: readonly string[]): HistoryDetailItem;
+export declare function serializeHistoryItem(item: HistoryItem): HistoryItem;
+export declare function serializeHistoryDocument(document: HistoryDocument): HistoryDocument;
+export declare function writeHistoryFile(historyFileName: string, document: HistoryDocument, directory?: string): Promise<string>;
+export declare function readHistoryFile(historyFileName: string, directory?: string): Promise<HistoryDocument>;
+export interface LatestHistoryMatch {
+    readonly historyFile: string;
+    readonly document: HistoryDocument;
+}
+export declare function listHistoryRuns(directory?: string): Promise<HistoryRunSummary[]>;
+export declare function findLatestHistory(savedFileName: string, directory?: string): Promise<LatestHistoryMatch>;

package/dist/api/history.js

@@ -0,0 +1,172 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { SavedNameError, SavedNotFoundError, normalizeSavedFileName } from "./saved.js";
+export const HISTORY_DIR = path.resolve(process.cwd(), "history");
+export const HISTORY_RUN_STATUSES = ["running", "done", "error", "stopped"];
+function isHistoryRunStatus(value) {
+    return typeof value === "string" && HISTORY_RUN_STATUSES.includes(value);
+}
+export function makeHistoryFileName(savedFileName, now = new Date()) {
+    const name = normalizeSavedFileName(savedFileName);
+    const stem = name.slice(0, -".json".length);
+    const stamp = now.toISOString().replace(/[:.]/g, "-");
+    return `${stem}-${stamp}.json`;
+}
+export function createHistoryDocument(savedFileName, items) {
+    return {
+        fileName: normalizeSavedFileName(savedFileName),
+        status: "running",
+        current: 0,
+        total: items.length,
+        items: items.map((item) => ({
+            sequence: item.sequence,
+            id: item.id,
+            prompt: item.prompt,
+            model: item.model,
+            status: "pending",
+        })),
+    };
+}
+export function serializeHistoryDetailItem(item, screenshots) {
+    return {
+        sequence: item.sequence,
+        prompt: item.prompt,
+        model: item.model,
+        ...(item.resultText ? { resultText: item.resultText } : {}),
+        screenshots: [...screenshots],
+    };
+}
+export function serializeHistoryItem(item) {
+    return {
+        sequence: item.sequence,
+        id: item.id,
+        prompt: item.prompt,
+        model: item.model,
+        status: item.status,
+        ...(item.resultText ? { resultText: item.resultText } : {}),
+        ...(typeof item.costUsd === "number" ? { costUsd: item.costUsd } : {}),
+        ...(item.error ? { error: item.error } : {}),
+    };
+}
+export function serializeHistoryDocument(document) {
+    return {
+        fileName: document.fileName,
+        status: document.status,
+        current: document.current,
+        total: document.total,
+        items: document.items.map(serializeHistoryItem),
+    };
+}
+export async function writeHistoryFile(historyFileName, document, directory = HISTORY_DIR) {
+    const name = normalizeSavedFileName(historyFileName);
+    await fs.mkdir(directory, { recursive: true });
+    const body = `${JSON.stringify(serializeHistoryDocument(document), null, 2)}\n`;
+    const filePath = path.join(directory, name);
+    const tempPath = `${filePath}.${process.pid}.tmp`;
+    await fs.writeFile(tempPath, body);
+    await fs.rename(tempPath, filePath);
+    return name;
+}
+export async function readHistoryFile(historyFileName, directory = HISTORY_DIR) {
+    const name = normalizeSavedFileName(historyFileName);
+    const filePath = path.join(directory, name);
+    let raw;
+    try {
+        raw = await fs.readFile(filePath, "utf8");
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            throw new SavedNotFoundError(`History file not found: ${name}`);
+        }
+        throw error;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new SavedNameError("History file is not valid JSON");
+    }
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+        throw new SavedNameError("History file must be a JSON object");
+    }
+    return parsed;
+}
+export async function listHistoryRuns(directory = HISTORY_DIR) {
+    let names;
+    try {
+        names = await fs.readdir(directory);
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return [];
+        }
+        throw error;
+    }
+    const ranked = [];
+    for (const name of names) {
+        if (!name.toLowerCase().endsWith(".json")) {
+            continue;
+        }
+        try {
+            const document = await readHistoryFile(name, directory);
+            if (!isHistoryRunStatus(document.status)) {
+                continue;
+            }
+            const stats = await fs.stat(path.join(directory, name));
+            ranked.push({ historyFile: name, status: document.status, mtimeMs: stats.mtimeMs });
+        }
+        catch {
+            // Skip unreadable or invalid files.
+        }
+    }
+    ranked.sort((left, right) => {
+        if (right.mtimeMs !== left.mtimeMs) {
+            return right.mtimeMs - left.mtimeMs;
+        }
+        return right.historyFile.localeCompare(left.historyFile);
+    });
+    return ranked.map(({ historyFile, status }) => ({ historyFile, status }));
+}
+export async function findLatestHistory(savedFileName, directory = HISTORY_DIR) {
+    const wanted = normalizeSavedFileName(savedFileName);
+    let names;
+    try {
+        names = await fs.readdir(directory);
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            throw new SavedNotFoundError(`History file not found for: ${wanted}`);
+        }
+        throw error;
+    }
+    const ranked = [];
+    for (const name of names) {
+        if (!name.toLowerCase().endsWith(".json")) {
+            continue;
+        }
+        try {
+            const document = await readHistoryFile(name, directory);
+            if (normalizeSavedFileName(document.fileName) !== wanted) {
+                continue;
+            }
+            const stats = await fs.stat(path.join(directory, name));
+            ranked.push({ historyFile: name, document, mtimeMs: stats.mtimeMs });
+        }
+        catch {
+            // Skip unreadable or invalid files.
+        }
+    }
+    ranked.sort((left, right) => {
+        if (right.mtimeMs !== left.mtimeMs) {
+            return right.mtimeMs - left.mtimeMs;
+        }
+        return right.historyFile.localeCompare(left.historyFile);
+    });
+    const latest = ranked[0];
+    if (!latest) {
+        throw new SavedNotFoundError(`History file not found for: ${wanted}`);
+    }
+    return { historyFile: latest.historyFile, document: latest.document };
+}
+//# sourceMappingURL=history.js.map

package/dist/api/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/api/history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,sBAAsB,EAAwB,MAAM,YAAY,CAAC;AAE9G,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;AAElE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,CAAU,CAAC;AAiBrF,SAAS,kBAAkB,CAAC,KAAc;IACxC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,oBAA0C,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAClG,CAAC;AAqBD,MAAM,UAAU,mBAAmB,CAAC,aAAqB,EAAE,GAAG,GAAG,IAAI,IAAI,EAAE;IACzE,MAAM,IAAI,GAAG,sBAAsB,CAAC,aAAa,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO,GAAG,IAAI,IAAI,KAAK,OAAO,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,aAAqB,EACrB,KAAiC;IAEjC,OAAO;QACL,QAAQ,EAAE,sBAAsB,CAAC,aAAa,CAAC;QAC/C,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,CAAC;QACV,KAAK,EAAE,KAAK,CAAC,MAAM;QACnB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC1B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,SAAS;SAClB,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,IAAiB,EACjB,WAA8B;IAE9B,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,WAAW,EAAE,CAAC,GAAG,WAAW,CAAC;KAC9B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAiB;IACpD,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,CAAC,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,QAAyB;IAChE,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,oBAAoB,CAAC;KAChD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,eAAuB,EACvB,QAAyB,EACzB,SAAS,GAAG,WAAW;IAEvB,MAAM,IAAI,GAAG,sBAAsB,CAAC,eAAe,CAAC,CAAC;IACrD,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,wBAAwB,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;IAChF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,GAAG,QAAQ,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC;IAClD,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACnC,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACpC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,eAAuB,EACvB,SAAS,GAAG,WAAW;IAEvB,MAAM,IAAI,GAAG,sBAAsB,CAAC,eAAe,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC5C,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,MAAM,IAAI,kBAAkB,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAC;QAClE,CAAC;QAED,MAAM,KAAK,CAAC;IACd,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,cAAc,CAAC,gCAAgC,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,cAAc,CAAC,oCAAoC,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,MAAyB,CAAC;AACnC,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,SAAS,GAAG,WAAW;IAC3D,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,KAAK,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAA8E,EAAE,CAAC;IAC7F,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1C,SAAS;QACX,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YACxD,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzC,SAAS;YACX,CAAC;YAED,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;YACxD,MAAM,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACtF,CAAC;QAAC,MAAM,CAAC;YACP,oCAAoC;QACtC,CAAC;IACH,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC1B,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;YACnC,OAAO,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QACtC,CAAC;QAED,OAAO,KAAK,CAAC,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,aAAqB,EACrB,SAAS,GAAG,WAAW;IAEvB,MAAM,MAAM,GAAG,sBAAsB,CAAC,aAAa,CAAC,CAAC;IACrD,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,MAAM,IAAI,kBAAkB,CAAC,+BAA+B,MAAM,EAAE,CAAC,CAAC;QACxE,CAAC;QAED,MAAM,KAAK,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAA+E,EAAE,CAAC;IAC9F,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1C,SAAS;QACX,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YACxD,IAAI,sBAAsB,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,MAAM,EAAE,CAAC;gBACzD,SAAS;YACX,CAAC;YAED,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;YACxD,MAAM,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACvE,CAAC;QAAC,MAAM,CAAC;YACP,oCAAoC;QACtC,CAAC;IACH,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC1B,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;YACnC,OAAO,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QACtC,CAAC;QAED,OAAO,KAAK,CAAC,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACzB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,kBAAkB,CAAC,+BAA+B,MAAM,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;AACxE,CAAC"}

package/dist/api/saved-run.d.ts

@@ -0,0 +1,35 @@
+import { type AgentRunExtras, type AgentRunResult } from "../computer-use/index.js";
+import { type BrowserSession } from "../playwright/session.js";
+import type { AppConfig } from "../shared/config.js";
+import { type AutomationReporter } from "../shared/telemetry.js";
+export declare class SavedRunBusyError extends Error {
+    constructor(message?: string);
+}
+export declare class SavedRunLimitError extends Error {
+    constructor(message?: string);
+}
+export declare class SavedRunNotRunningError extends Error {
+    constructor(message?: string);
+}
+export declare class SavedRunFinishedError extends Error {
+    constructor(message?: string);
+}
+export type SavedRunTask = (task: string, model: string, session: BrowserSession, extras?: AgentRunExtras, screenshotDir?: string) => Promise<AgentRunResult>;
+export interface SavedRunManagerDeps {
+    readonly savedDir: string;
+    readonly historyDir: string;
+    readonly processedDir: string;
+    readonly config: AppConfig;
+    readonly runTask?: SavedRunTask;
+    readonly createSession?: (screenshotDir: string) => BrowserSession;
+    readonly now?: () => Date;
+    readonly reportAutomation?: AutomationReporter;
+}
+export declare function denySavedRunSafety(): Promise<boolean>;
+export declare function createSavedRunManager(deps: SavedRunManagerDeps): {
+    start(savedFileName: string): Promise<string>;
+    stop(historyFileName: string): Promise<void>;
+    close(): Promise<void>;
+    listRunning(): string[];
+};
+export type SavedRunManager = ReturnType<typeof createSavedRunManager>;