@opencraw/driver 0.1.0 → 0.3.0

package/dist/src/protocol/driver-message.contract.d.ts

@@ -3,7 +3,7 @@ import { z } from 'zod';
  * The driver protocol's version, separate from the package's: a client pins a major and the driver refuses
  * another. Additions (methods, optional fields) raise the minor; anything a client could break on, the major.
  */
-export declare const PROTOCOL_VERSION = "1.0.0";
+export declare const PROTOCOL_VERSION = "1.2.0";
 export declare const initializeParamsSchema: z.ZodObject<{
     clientName: z.ZodString;
     clientVersion: z.ZodString;
@@ -35,6 +35,9 @@ export declare const validateResultSchema: z.ZodObject<{
 }, z.core.$strict>;
 export type ValidateResult = z.infer<typeof validateResultSchema>;
 export declare const runParamsSchema: z.ZodObject<{
+    accessConfig: z.ZodOptional<z.ZodString>;
+    access: z.ZodOptional<z.ZodString>;
+    accessPlugins: z.ZodOptional<z.ZodArray<z.ZodString>>;
     paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
     recipes: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     only: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -49,11 +52,37 @@ export declare const runParamsSchema: z.ZodObject<{
         ignoreHTTPSErrors: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
     hooks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    captchaSolvers: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strict>;
 export type RunParams = z.infer<typeof runParamsSchema>;
 export declare const runResultSchema: z.ZodObject<{
     runId: z.ZodString;
 }, z.core.$strict>;
+export declare const workParamsSchema: z.ZodObject<{
+    accessConfig: z.ZodOptional<z.ZodString>;
+    access: z.ZodOptional<z.ZodString>;
+    accessPlugins: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    recipes: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    only: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    out: z.ZodOptional<z.ZodString>;
+    append: z.ZodOptional<z.ZodBoolean>;
+    browser: z.ZodOptional<z.ZodObject<{
+        headless: z.ZodOptional<z.ZodBoolean>;
+        executablePath: z.ZodOptional<z.ZodString>;
+        ignoreHTTPSErrors: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    hooks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    captchaSolvers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    windows: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
+}, z.core.$strict>;
+export type WorkParams = z.infer<typeof workParamsSchema>;
+export declare const workItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    vars: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+    recipe: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type WorkItemMessage = z.infer<typeof workItemSchema>;
 export type RunResult = z.infer<typeof runResultSchema>;
 export declare const cancelParamsSchema: z.ZodObject<{
     runId: z.ZodString;
@@ -63,7 +92,95 @@ export declare const cancelResultSchema: z.ZodObject<{
     cancelled: z.ZodBoolean;
 }, z.core.$strict>;
 export type CancelResult = z.infer<typeof cancelResultSchema>;
+export declare const probeParamsSchema: z.ZodObject<{
+    accessConfig: z.ZodOptional<z.ZodString>;
+    access: z.ZodOptional<z.ZodString>;
+    accessPlugins: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    url: z.ZodString;
+    browser: z.ZodOptional<z.ZodBoolean>;
+    browserPath: z.ZodOptional<z.ZodString>;
+    insecureTls: z.ZodOptional<z.ZodBoolean>;
+    userAgent: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ProbeParams = z.infer<typeof probeParamsSchema>;
+/** What the page holds and how a recipe could reach it (`ProbeResult`); its shape is the probe's, versioned with it. */
+export declare const probeResultSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+export declare const diffParamsSchema: z.ZodObject<{
+    previous: z.ZodString;
+    current: z.ZodString;
+    key: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    ignore: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type DiffParams = z.infer<typeof diffParamsSchema>;
+export declare const diffResultSchema: z.ZodObject<{
+    added: z.ZodNumber;
+    removed: z.ZodNumber;
+    changed: z.ZodNumber;
+    unchanged: z.ZodNumber;
+    shrunk: z.ZodOptional<z.ZodObject<{
+        previous: z.ZodNumber;
+        current: z.ZodNumber;
+    }, z.core.$strict>>;
+    summary: z.ZodArray<z.ZodString>;
+    changes: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    truncated: z.ZodBoolean;
+}, z.core.$strict>;
+export type DiffResult = z.infer<typeof diffResultSchema>;
+export declare const exportParamsSchema: z.ZodObject<{
+    records: z.ZodString;
+    output: z.ZodString;
+    out: z.ZodString;
+}, z.core.$strict>;
+export type ExportParams = z.infer<typeof exportParamsSchema>;
+export declare const exportResultSchema: z.ZodObject<{
+    written: z.ZodNumber;
+    location: z.ZodString;
+}, z.core.$strict>;
+export type ExportResult = z.infer<typeof exportResultSchema>;
 export declare const shutdownResultSchema: z.ZodObject<{}, z.core.$strict>;
+/** A window wants its next item. The client may hold the answer until it has one; `null` ends the work. */
+export declare const workNextParamsSchema: z.ZodObject<{
+    runId: z.ZodString;
+}, z.core.$strict>;
+export declare const workNextResultSchema: z.ZodObject<{
+    item: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        vars: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+        recipe: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type WorkNextResult = z.infer<typeof workNextResultSchema>;
+/** An item succeeded: its report (`RecipeReport`) and its records. */
+export declare const workDoneParamsSchema: z.ZodObject<{
+    runId: z.ZodString;
+    item: z.ZodObject<{
+        id: z.ZodString;
+        vars: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+        recipe: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    report: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    records: z.ZodArray<z.ZodObject<{
+        key: z.ZodNullable<z.ZodString>;
+        data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type WorkDoneParams = z.infer<typeof workDoneParamsSchema>;
+/** An item failed (`failure`) or came out neither way (`neutral`, such as a captcha it could not pass). */
+export declare const workFailedParamsSchema: z.ZodObject<{
+    runId: z.ZodString;
+    item: z.ZodObject<{
+        id: z.ZodString;
+        vars: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+        recipe: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    report: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    outcome: z.ZodEnum<{
+        failure: "failure";
+        neutral: "neutral";
+    }>;
+}, z.core.$strict>;
+export type WorkFailedParams = z.infer<typeof workFailedParamsSchema>;
 /** Every crawl event, as core reports it (`CrawlEvent`); its shape is core's, versioned with core. */
 export declare const eventParamsSchema: z.ZodObject<{
     runId: z.ZodString;
@@ -83,7 +200,7 @@ export declare const finishedParamsSchema: z.ZodObject<{
     error: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type FinishedParams = z.infer<typeof finishedParamsSchema>;
-/** A hook the client serves: core's own callout request, answered with core's callout response. */
+/** A hook, captcha solver or access plugin the client serves (`request.kind`): core's own callout request, answered with core's callout response. */
 export declare const calloutParamsSchema: z.ZodObject<{
     runId: z.ZodString;
     request: z.ZodObject<{
@@ -153,6 +270,9 @@ export declare const MESSAGES: {
     readonly run: {
         readonly direction: 'client-to-driver';
         readonly params: z.ZodObject<{
+            accessConfig: z.ZodOptional<z.ZodString>;
+            access: z.ZodOptional<z.ZodString>;
+            accessPlugins: z.ZodOptional<z.ZodArray<z.ZodString>>;
             paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
             recipes: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
             only: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -167,6 +287,31 @@ export declare const MESSAGES: {
                 ignoreHTTPSErrors: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strict>>;
             hooks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            captchaSolvers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>;
+        readonly result: z.ZodObject<{
+            runId: z.ZodString;
+        }, z.core.$strict>;
+    };
+    readonly work: {
+        readonly direction: 'client-to-driver';
+        readonly params: z.ZodObject<{
+            accessConfig: z.ZodOptional<z.ZodString>;
+            access: z.ZodOptional<z.ZodString>;
+            accessPlugins: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            recipes: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            only: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            out: z.ZodOptional<z.ZodString>;
+            append: z.ZodOptional<z.ZodBoolean>;
+            browser: z.ZodOptional<z.ZodObject<{
+                headless: z.ZodOptional<z.ZodBoolean>;
+                executablePath: z.ZodOptional<z.ZodString>;
+                ignoreHTTPSErrors: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
+            hooks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            captchaSolvers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            windows: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
         }, z.core.$strict>;
         readonly result: z.ZodObject<{
             runId: z.ZodString;
@@ -181,6 +326,55 @@ export declare const MESSAGES: {
             cancelled: z.ZodBoolean;
         }, z.core.$strict>;
     };
+    readonly probe: {
+        readonly direction: 'client-to-driver';
+        readonly params: z.ZodObject<{
+            accessConfig: z.ZodOptional<z.ZodString>;
+            access: z.ZodOptional<z.ZodString>;
+            accessPlugins: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            url: z.ZodString;
+            browser: z.ZodOptional<z.ZodBoolean>;
+            browserPath: z.ZodOptional<z.ZodString>;
+            insecureTls: z.ZodOptional<z.ZodBoolean>;
+            userAgent: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        readonly result: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    };
+    readonly diff: {
+        readonly direction: 'client-to-driver';
+        readonly params: z.ZodObject<{
+            previous: z.ZodString;
+            current: z.ZodString;
+            key: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            ignore: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            limit: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>;
+        readonly result: z.ZodObject<{
+            added: z.ZodNumber;
+            removed: z.ZodNumber;
+            changed: z.ZodNumber;
+            unchanged: z.ZodNumber;
+            shrunk: z.ZodOptional<z.ZodObject<{
+                previous: z.ZodNumber;
+                current: z.ZodNumber;
+            }, z.core.$strict>>;
+            summary: z.ZodArray<z.ZodString>;
+            changes: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            truncated: z.ZodBoolean;
+        }, z.core.$strict>;
+    };
+    readonly export: {
+        readonly direction: 'client-to-driver';
+        readonly params: z.ZodObject<{
+            records: z.ZodString;
+            output: z.ZodString;
+            out: z.ZodString;
+        }, z.core.$strict>;
+        readonly result: z.ZodObject<{
+            written: z.ZodNumber;
+            location: z.ZodString;
+        }, z.core.$strict>;
+    };
     readonly shutdown: {
         readonly direction: 'client-to-driver';
         readonly params: undefined;
@@ -220,6 +414,53 @@ export declare const MESSAGES: {
             retryAfterMs: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>], "status">;
     };
+    readonly 'work.next': {
+        readonly direction: 'driver-to-client';
+        readonly params: z.ZodObject<{
+            runId: z.ZodString;
+        }, z.core.$strict>;
+        readonly result: z.ZodObject<{
+            item: z.ZodNullable<z.ZodObject<{
+                id: z.ZodString;
+                vars: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+                recipe: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+    };
+    readonly 'work.done': {
+        readonly direction: 'driver-to-client';
+        readonly params: z.ZodObject<{
+            runId: z.ZodString;
+            item: z.ZodObject<{
+                id: z.ZodString;
+                vars: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+                recipe: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
+            report: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            records: z.ZodArray<z.ZodObject<{
+                key: z.ZodNullable<z.ZodString>;
+                data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        readonly result: undefined;
+    };
+    readonly 'work.failed': {
+        readonly direction: 'driver-to-client';
+        readonly params: z.ZodObject<{
+            runId: z.ZodString;
+            item: z.ZodObject<{
+                id: z.ZodString;
+                vars: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+                recipe: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
+            report: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            outcome: z.ZodEnum<{
+                failure: "failure";
+                neutral: "neutral";
+            }>;
+        }, z.core.$strict>;
+        readonly result: undefined;
+    };
     readonly event: {
         readonly direction: 'driver-to-client';
         readonly params: z.ZodObject<{

package/dist/src/protocol/index.d.ts

@@ -1,4 +1,4 @@
-export { PROTOCOL_VERSION, MESSAGES, initializeParamsSchema, initializeResultSchema, validateParamsSchema, validateResultSchema, runParamsSchema, runResultSchema, cancelParamsSchema, cancelResultSchema, shutdownResultSchema, eventParamsSchema, recordParamsSchema, finishedParamsSchema, calloutParamsSchema, calloutResultSchema, } from './driver-message.contract.js';
-export type { InitializeParams, InitializeResult, ValidateParams, ValidateResult, RunParams, RunResult, CancelParams, CancelResult, EventParams, RecordParams, FinishedParams, CalloutParams, } from './driver-message.contract.js';
+export { PROTOCOL_VERSION, MESSAGES, initializeParamsSchema, initializeResultSchema, validateParamsSchema, validateResultSchema, runParamsSchema, runResultSchema, cancelParamsSchema, cancelResultSchema, shutdownResultSchema, eventParamsSchema, recordParamsSchema, finishedParamsSchema, calloutParamsSchema, calloutResultSchema, probeParamsSchema, probeResultSchema, diffParamsSchema, diffResultSchema, exportParamsSchema, exportResultSchema, workParamsSchema, workItemSchema, workNextParamsSchema, workNextResultSchema, workDoneParamsSchema, workFailedParamsSchema, } from './driver-message.contract.js';
+export type { InitializeParams, InitializeResult, ValidateParams, ValidateResult, RunParams, RunResult, CancelParams, CancelResult, EventParams, RecordParams, FinishedParams, CalloutParams, ProbeParams, DiffParams, DiffResult, ExportParams, ExportResult, WorkParams, WorkItemMessage, WorkNextResult, WorkDoneParams, WorkFailedParams, } from './driver-message.contract.js';
 export { driverProtocolJsonSchema } from './driver-json-schema.mapper.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/record-files/diff-record-files.use-case.d.ts

@@ -0,0 +1,10 @@
+import type { DiffParams, DiffResult } from '../protocol/index.js';
+/**
+ * Compares two runs' JSON Lines files by key: how many records were added, removed, changed and left
+ * alone, the report a person reads, and the changes themselves, up to `limit`.
+ *
+ * @param params - The two files, the key fields, the fields to ignore and the limit.
+ * @returns The comparison.
+ */
+export declare function diffRecordFiles(params: DiffParams): Promise<DiffResult>;
+//# sourceMappingURL=diff-record-files.use-case.d.ts.map

package/dist/src/record-files/export-record-files.use-case.d.ts

@@ -0,0 +1,11 @@
+import type { ExportParams, ExportResult } from '../protocol/index.js';
+/**
+ * Writes a finished run's JSON Lines file again in another format, the extension of `out` naming it, as
+ * the CLI's `export` does. The output recipe gives the columns: its fields, in order, with their types.
+ *
+ * @param params - The records, the output recipe and the file to write.
+ * @returns How many records were written, and where.
+ * @throws RecipeValidationError When `output` is not an output recipe.
+ */
+export declare function exportRecordFiles(params: ExportParams): Promise<ExportResult>;
+//# sourceMappingURL=export-record-files.use-case.d.ts.map

package/dist/src/record-files/index.d.ts

@@ -0,0 +1,3 @@
+export { diffRecordFiles } from './diff-record-files.use-case.js';
+export { exportRecordFiles } from './export-record-files.use-case.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/session/index.d.ts

@@ -1,5 +1,5 @@
 export { runSessions } from './run-session.use-case.js';
-export type { NotifyClient, RunSessions } from './run-session.use-case.js';
+export type { RunSessions } from './run-session.use-case.js';
 export { validateRecipes, hooksOf, loadRecipes, sourceOf } from './recipe-loading.use-case.js';
 export { streamingSink } from './streaming-sink.repository.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/session/run-session.use-case.d.ts

@@ -1,23 +1,23 @@
-import type { AskClient } from '../callout-bridge/index.js';
-import type { RunParams } from '../protocol/index.js';
-/** Sends a notification to the client. */
-export type NotifyClient = (method: string, params: unknown) => void;
+import type { AskClient, NotifyClient } from '../callout-bridge/index.js';
+import type { RunParams, WorkParams } from '../protocol/index.js';
 /** The runs a driver has going, by id, so `cancel` can reach them and `shutdown` close them all. */
 export interface RunSessions {
     start: (params: RunParams) => Promise<string>;
+    startWork: (params: WorkParams) => Promise<string>;
     cancel: (runId: string) => Promise<boolean>;
     closeAll: () => Promise<void>;
 }
 /**
- * Starts and tracks runs. `start` loads and binds the recipes (a bad recipe fails the `run` request
- * itself, with its problems), answers with a run id at once, and crawls in the background: every crawl
- * event goes to the client as an `event` notification, every record as a `record` one unless `out`
- * names a file, and the end as `finished` with the report. A hook the client serves is asked back with
- * a `callout` request. `cancel` closes the run's crawler, which stops its recipes; the run still ends
- * with `finished`.
+ * Starts and tracks runs and worker pools. `start` and `startWork` load and bind the recipes (a bad
+ * recipe fails the request itself, with its problems), answer with a run id at once, and crawl in the
+ * background: every crawl event goes to the client as an `event` notification, every record as a
+ * `record` one unless `out` names a file, and the end as `finished` with the report. A hook the client
+ * serves is asked back with a `callout` request, and so are the captcha solvers and access plugins it
+ * serves; a worker pool asks the client for its items (`work.next`). `cancel` closes the run's crawler,
+ * which stops its recipes; the run still ends with `finished`.
  *
  * @param notify - The channel's notify.
- * @param ask - The channel's request, for callouts.
+ * @param ask - The channel's request, for callouts and work.
  * @returns The sessions.
  */
 export declare function runSessions(notify: NotifyClient, ask: AskClient): RunSessions;

package/dist/src/site-access/index.d.ts

@@ -0,0 +1,3 @@
+export { resolveSiteAccess } from './resolve-site-access.use-case.js';
+export type { SiteAccess, SiteAccessParams } from './resolve-site-access.use-case.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/site-access/resolve-site-access.use-case.d.ts

@@ -0,0 +1,26 @@
+import type { AccessConfig, AccessPlugin } from '@opencraw/core';
+import type { AskClient } from '../callout-bridge/index.js';
+/** What a run or a probe asks of access: the config file, the profile, and the plugins the client serves. */
+export interface SiteAccessParams {
+    accessConfig?: string;
+    access?: string;
+    accessPlugins?: string[];
+}
+/** How a run or a probe reaches sites. */
+export interface SiteAccess {
+    access?: AccessConfig;
+    accessPlugins: AccessPlugin[];
+}
+/**
+ * Loads the access config (the file the client names, else `OPENCRAW_ACCESS`), with `access` as its
+ * default profile, and builds a plugin for each one the client serves.
+ *
+ * @param params - The method's access fields.
+ * @param runId - The run, or the probe, the plugins' callouts belong to.
+ * @param ask - The channel's request.
+ * @param env - Where `OPENCRAW_ACCESS` is read.
+ * @returns The config and the plugins.
+ * @throws Error When a profile is named without a config, or the config has no such profile.
+ */
+export declare function resolveSiteAccess(params: SiteAccessParams, runId: string, ask: AskClient, env?: NodeJS.ProcessEnv): Promise<SiteAccess>;
+//# sourceMappingURL=resolve-site-access.use-case.d.ts.map

package/dist/src/site-probe/index.d.ts

@@ -0,0 +1,2 @@
+export { probeSite } from './probe-site.use-case.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/site-probe/probe-site.use-case.d.ts

@@ -0,0 +1,13 @@
+import type { AskClient } from '../callout-bridge/index.js';
+import type { ProbeParams } from '../protocol/index.js';
+/**
+ * Fetches a page, or renders it with `browser`, and says where its data lives: the probe the CLI and the
+ * MCP server use, through the access the client names (its plugins served by the client).
+ *
+ * @param params - The page and how to reach it.
+ * @param probeId - What the plugins' callouts carry as their `runId`.
+ * @param ask - The channel's request.
+ * @returns The probe's findings.
+ */
+export declare function probeSite(params: ProbeParams, probeId: string, ask: AskClient): Promise<Record<string, unknown>>;
+//# sourceMappingURL=probe-site.use-case.d.ts.map

package/dist/src/work-bridge/client-work-source.client.d.ts

@@ -0,0 +1,17 @@
+import type { WorkSource } from '@opencraw/core';
+import type { AskClient, NotifyClient } from '../callout-bridge/index.js';
+/**
+ * A `WorkSource` whose items come from the client: each window that wants work sends a `work.next`
+ * request, which the client may hold until it has an item, and an answer of `null` ends the work. Each
+ * item's end goes back as `work.done` (with its records) or `work.failed`.
+ *
+ * A window that retires while its request is out (core aborts its `next`) still gets an answer later;
+ * that item is kept and handed to the next window that asks, so nothing the client sent is lost.
+ *
+ * @param runId - The work's run id, sent with every message.
+ * @param ask - The channel's request.
+ * @param notify - The channel's notify.
+ * @returns The source for `crawler.work`.
+ */
+export declare function clientWorkSource(runId: string, ask: AskClient, notify: NotifyClient): WorkSource;
+//# sourceMappingURL=client-work-source.client.d.ts.map

package/dist/src/work-bridge/index.d.ts

@@ -0,0 +1,2 @@
+export { clientWorkSource } from './client-work-source.client.js';
+//# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opencraw/driver",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "OpenCraw's driver: the engine over JSON-RPC on stdio, for clients in other languages",
   "license": "MIT",
   "type": "module",
@@ -40,8 +40,8 @@
     "schemas": "node tools/emit-protocol-schema.mjs"
   },
   "dependencies": {
-    "@opencraw/cli": "^0.1.55",
-    "@opencraw/core": "^0.2.0",
+    "@opencraw/cli": "^0.0.1",
+    "@opencraw/core": "^0.0.1",
     "zod": "^4.6.5"
   }
 }