specweave 2.1.0 → 2.2.1

package/dist/src/core/jev/browse.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Jev headless browser delegation.
+ *
+ * A mechanical navigation loop where Jev picks the next action from an enumerated set
+ * of things visible on the page. The loop is always HEADLESS: it never launches a
+ * visible window, never types text the model chose (values come from `inputs` only),
+ * never leaves `allowDomains`, and hands control back to the agent the moment the page
+ * needs judgement (login, captcha, payment, free text).
+ *
+ * Playwright is loaded lazily — it is not a dependency of this package.
+ *
+ * @module core/jev/browse
+ */
+import { type JevClient } from './client.js';
+export interface BrowseOptions {
+    goal: string;
+    url?: string;
+    allowDomains?: string[];
+    maxSteps?: number;
+    maxMs?: number;
+    minConfidence?: number;
+    inputs?: Record<string, string>;
+    screenshotDir?: string;
+    allowSensitive?: boolean;
+    projectRoot?: string;
+    client?: JevClient;
+    playwright?: unknown;
+}
+export interface BrowseStep {
+    n: number;
+    url: string;
+    action: string;
+    choice: string;
+    confidence: number;
+    apiMs: number;
+    executed: boolean;
+    reason?: string;
+}
+export interface BrowseResult {
+    status: 'done' | 'blocked' | 'needs_agent' | 'low_confidence' | 'step_limit' | 'budget' | 'error';
+    handoff?: string;
+    url: string;
+    title: string;
+    steps: BrowseStep[];
+    pageText: string;
+    screenshots: string[];
+    elapsedMs: number;
+    cost: number;
+    error?: string;
+}
+/**
+ * Run the headless browse loop. Always resolves — failures come back as
+ * `status: 'error'` so an agent can keep going without a try/catch.
+ */
+export declare function runBrowse(opts: BrowseOptions): Promise<BrowseResult>;
+//# sourceMappingURL=browse.d.ts.map

package/dist/src/core/jev/browse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse.d.ts","sourceRoot":"","sources":["../../../../src/core/jev/browse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,EAAmB,KAAK,SAAS,EAA4B,MAAM,aAAa,CAAC;AAGxF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,gBAAgB,GAAG,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAC;IAClG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAqeD;;;GAGG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CA+S1E"}