@tiny-fish/sdk 0.0.5 → 0.0.7

package/dist/runs/index.js

@@ -3,6 +3,7 @@
  */
 import { SDKError } from "../_utils/errors.js";
 import { APIResource } from "../_utils/resource.js";
+import { runListParamsSchema, runListResponseSchema, runSchema, } from "./types.js";
 /** Retrieve and list automation runs. */
 export class RunsResource extends APIResource {
     /**
@@ -17,7 +18,8 @@ export class RunsResource extends APIResource {
         if (typeof runId !== "string" || !runId.trim()) {
             throw new SDKError("run_id must be a non-empty string");
         }
-        return this._client.get(`/v1/runs/${encodeURIComponent(runId)}`);
+        const response = await this._client.get(`/v1/runs/${encodeURIComponent(runId)}`);
+        return runSchema.parse(response);
     }
     /**
      * List automation runs, with optional filtering and pagination.
@@ -26,23 +28,30 @@ export class RunsResource extends APIResource {
      * and pagination info (total count, next cursor).
      */
     async list(params = {}) {
+        const parsed = runListParamsSchema.safeParse(params);
+        if (!parsed.success) {
+            const issue = parsed.error.issues[0];
+            throw new SDKError(issue?.message ?? "Invalid run list request");
+        }
+        const validParams = parsed.data;
         const queryParams = {};
-        if (params.cursor !== undefined)
-            queryParams["cursor"] = params.cursor;
-        if (params.limit !== undefined)
-            queryParams["limit"] = params.limit;
-        if (params.status !== undefined)
-            queryParams["status"] = params.status;
-        if (params.goal !== undefined)
-            queryParams["goal"] = params.goal;
-        if (params.created_after !== undefined)
-            queryParams["created_after"] = params.created_after;
-        if (params.created_before !== undefined)
-            queryParams["created_before"] = params.created_before;
-        if (params.sort_direction !== undefined)
-            queryParams["sort_direction"] = params.sort_direction;
+        if (validParams.cursor !== undefined)
+            queryParams["cursor"] = validParams.cursor;
+        if (validParams.limit !== undefined)
+            queryParams["limit"] = validParams.limit;
+        if (validParams.status !== undefined)
+            queryParams["status"] = validParams.status;
+        if (validParams.goal !== undefined)
+            queryParams["goal"] = validParams.goal;
+        if (validParams.created_after !== undefined)
+            queryParams["created_after"] = validParams.created_after;
+        if (validParams.created_before !== undefined)
+            queryParams["created_before"] = validParams.created_before;
+        if (validParams.sort_direction !== undefined)
+            queryParams["sort_direction"] = validParams.sort_direction;
         const hasParams = Object.keys(queryParams).length > 0;
-        return this._client.get("/v1/runs", hasParams ? { params: queryParams } : undefined);
+        const response = await this._client.get("/v1/runs", hasParams ? { params: queryParams } : undefined);
+        return runListResponseSchema.parse(response);
     }
 }
 //# sourceMappingURL=index.js.map

package/dist/runs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runs/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,yCAAyC;AACzC,MAAM,OAAO,YAAa,SAAQ,WAAW;IAC5C;;;;;;;OAOG;IACH,KAAK,CAAC,GAAG,CAAC,KAAa;QACtB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YAChD,MAAM,IAAI,QAAQ,CAAC,mCAAmC,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAM,YAAY,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,SAAwB,EAAE;QACpC,MAAM,WAAW,GAA8C,EAAE,CAAC;QAClE,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;YAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;QACvE,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;YAAE,WAAW,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;QACpE,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;YAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;QACvE,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;YAAE,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;QACjE,IAAI,MAAM,CAAC,aAAa,KAAK,SAAS;YAAE,WAAW,CAAC,eAAe,CAAC,GAAG,MAAM,CAAC,aAAa,CAAC;QAC5F,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS;YAAE,WAAW,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAAC,cAAc,CAAC;QAC/F,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS;YAAE,WAAW,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAAC,cAAc,CAAC;QAE/F,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CACtB,UAAU,EACV,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAC/C,CAAC;IACH,CAAC;CACD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runs/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAIN,mBAAmB,EACnB,qBAAqB,EACrB,SAAS,GACT,MAAM,YAAY,CAAC;AAEpB,yCAAyC;AACzC,MAAM,OAAO,YAAa,SAAQ,WAAW;IAC5C;;;;;;;OAOG;IACH,KAAK,CAAC,GAAG,CAAC,KAAa;QACtB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YAChD,MAAM,IAAI,QAAQ,CAAC,mCAAmC,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACjF,OAAO,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,SAAwB,EAAE;QACpC,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACrB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACrC,MAAM,IAAI,QAAQ,CAAC,KAAK,EAAE,OAAO,IAAI,0BAA0B,CAAC,CAAC;QAClE,CAAC;QACD,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC;QAChC,MAAM,WAAW,GAA8C,EAAE,CAAC;QAClE,IAAI,WAAW,CAAC,MAAM,KAAK,SAAS;YAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC;QACjF,IAAI,WAAW,CAAC,KAAK,KAAK,SAAS;YAAE,WAAW,CAAC,OAAO,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC;QAC9E,IAAI,WAAW,CAAC,MAAM,KAAK,SAAS;YAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC;QACjF,IAAI,WAAW,CAAC,IAAI,KAAK,SAAS;YAAE,WAAW,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC;QAC3E,IAAI,WAAW,CAAC,aAAa,KAAK,SAAS;YAC1C,WAAW,CAAC,eAAe,CAAC,GAAG,WAAW,CAAC,aAAa,CAAC;QAC1D,IAAI,WAAW,CAAC,cAAc,KAAK,SAAS;YAC3C,WAAW,CAAC,gBAAgB,CAAC,GAAG,WAAW,CAAC,cAAc,CAAC;QAC5D,IAAI,WAAW,CAAC,cAAc,KAAK,SAAS;YAC3C,WAAW,CAAC,gBAAgB,CAAC,GAAG,WAAW,CAAC,cAAc,CAAC;QAE5D,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACtC,UAAU,EACV,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAC/C,CAAC;QACF,OAAO,qBAAqB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9C,CAAC;CACD"}

package/dist/runs/types.d.ts

@@ -1,75 +1,123 @@
 /**
- * Runs management request/response types.
+ * Runs management request/response types and schemas.
  */
-import type { RunError, RunStatus } from "../agent/types.js";
+import { z } from "zod";
 /** Sort order for list queries. */
-export declare enum SortDirection {
-    ASC = "asc",
-    DESC = "desc"
-}
+export declare const SortDirection: {
+    readonly ASC: "asc";
+    readonly DESC: "desc";
+};
+export declare const sortDirectionSchema: z.ZodEnum<{
+    readonly ASC: "asc";
+    readonly DESC: "desc";
+}>;
+export type SortDirection = z.infer<typeof sortDirectionSchema>;
 /** Browser configuration used for a run. */
-export interface BrowserConfig {
-    /** Whether proxy was enabled. */
-    proxy_enabled: boolean | null;
-    /** Country code for proxy. */
-    proxy_country_code: string | null;
-}
+export declare const browserConfigSchema: z.ZodObject<{
+    proxy_enabled: z.ZodNullable<z.ZodBoolean>;
+    proxy_country_code: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type BrowserConfig = z.infer<typeof browserConfigSchema>;
 /** A single automation run with full details. */
-export interface Run {
-    /** Unique identifier for the run. */
-    run_id: string;
-    /** Current status of the run. */
-    status: RunStatus;
-    /** Natural language goal for this automation run. */
-    goal: string;
-    /** ISO 8601 timestamp when run was created. */
-    created_at: string;
-    /** ISO 8601 timestamp when run started executing. */
-    started_at: string | null;
-    /** ISO 8601 timestamp when run finished executing. */
-    finished_at: string | null;
-    /** Number of steps taken during the automation. */
-    num_of_steps: number;
-    /** Extracted data from the automation run. `null` if not completed or failed. */
-    result: Record<string, unknown> | null;
-    /** Error details. `null` if the run succeeded or is still running. */
-    error: RunError | null;
-    /** URL to watch live browser session (available while running). */
-    streaming_url: string | null;
-    /** Browser configuration used for the run. */
-    browser_config: BrowserConfig | null;
-}
+export declare const runSchema: z.ZodObject<{
+    run_id: z.ZodString;
+    status: z.ZodEnum<{
+        readonly PENDING: "PENDING";
+        readonly RUNNING: "RUNNING";
+        readonly COMPLETED: "COMPLETED";
+        readonly FAILED: "FAILED";
+        readonly CANCELLED: "CANCELLED";
+    }>;
+    goal: z.ZodString;
+    created_at: z.ZodString;
+    started_at: z.ZodNullable<z.ZodString>;
+    finished_at: z.ZodNullable<z.ZodString>;
+    num_of_steps: z.ZodNullable<z.ZodNumber>;
+    result: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    error: z.ZodNullable<z.ZodObject<{
+        message: z.ZodString;
+        category: z.ZodEnum<{
+            readonly SYSTEM_FAILURE: "SYSTEM_FAILURE";
+            readonly AGENT_FAILURE: "AGENT_FAILURE";
+            readonly UNKNOWN: "UNKNOWN";
+        }>;
+        retry_after: z.ZodNullable<z.ZodNumber>;
+        help_url: z.ZodOptional<z.ZodString>;
+        help_message: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    streaming_url: z.ZodNullable<z.ZodString>;
+    browser_config: z.ZodNullable<z.ZodObject<{
+        proxy_enabled: z.ZodNullable<z.ZodBoolean>;
+        proxy_country_code: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Run = z.infer<typeof runSchema>;
 /** Pagination metadata for list responses. */
-export interface PaginationInfo {
-    /** Total number of runs matching the current filters. */
-    total: number;
-    /** Whether there are more results after this page. */
-    has_more: boolean;
-    /** Cursor for fetching next page. `null` if no more results. */
-    next_cursor: string | null;
-}
+export declare const paginationInfoSchema: z.ZodObject<{
+    total: z.ZodNumber;
+    has_more: z.ZodBoolean;
+    next_cursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type PaginationInfo = z.infer<typeof paginationInfoSchema>;
 /** Paginated list of automation runs. */
-export interface RunListResponse {
-    /** Array of runs. */
-    data: Run[];
-    /** Pagination information. */
-    pagination: PaginationInfo;
-}
+export declare const runListResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        run_id: z.ZodString;
+        status: z.ZodEnum<{
+            readonly PENDING: "PENDING";
+            readonly RUNNING: "RUNNING";
+            readonly COMPLETED: "COMPLETED";
+            readonly FAILED: "FAILED";
+            readonly CANCELLED: "CANCELLED";
+        }>;
+        goal: z.ZodString;
+        created_at: z.ZodString;
+        started_at: z.ZodNullable<z.ZodString>;
+        finished_at: z.ZodNullable<z.ZodString>;
+        num_of_steps: z.ZodNullable<z.ZodNumber>;
+        result: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        error: z.ZodNullable<z.ZodObject<{
+            message: z.ZodString;
+            category: z.ZodEnum<{
+                readonly SYSTEM_FAILURE: "SYSTEM_FAILURE";
+                readonly AGENT_FAILURE: "AGENT_FAILURE";
+                readonly UNKNOWN: "UNKNOWN";
+            }>;
+            retry_after: z.ZodNullable<z.ZodNumber>;
+            help_url: z.ZodOptional<z.ZodString>;
+            help_message: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        streaming_url: z.ZodNullable<z.ZodString>;
+        browser_config: z.ZodNullable<z.ZodObject<{
+            proxy_enabled: z.ZodNullable<z.ZodBoolean>;
+            proxy_country_code: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    pagination: z.ZodObject<{
+        total: z.ZodNumber;
+        has_more: z.ZodBoolean;
+        next_cursor: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type RunListResponse = z.infer<typeof runListResponseSchema>;
 /** Parameters for listing runs. */
-export interface RunListParams {
-    /** Pagination cursor from a previous response's `next_cursor` field. */
-    cursor?: string;
-    /** Maximum number of runs to return. */
-    limit?: number;
-    /** Filter by run status. */
-    status?: RunStatus;
-    /** Filter by goal text. */
-    goal?: string;
-    /** Filter runs created after this ISO timestamp. */
-    created_after?: string;
-    /** Filter runs created before this ISO timestamp. */
-    created_before?: string;
-    /** Sort order — `"asc"` or `"desc"`. */
-    sort_direction?: SortDirection;
-}
+export declare const runListParamsSchema: z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    status: z.ZodOptional<z.ZodEnum<{
+        readonly PENDING: "PENDING";
+        readonly RUNNING: "RUNNING";
+        readonly COMPLETED: "COMPLETED";
+        readonly FAILED: "FAILED";
+        readonly CANCELLED: "CANCELLED";
+    }>>;
+    goal: z.ZodOptional<z.ZodString>;
+    created_after: z.ZodOptional<z.ZodString>;
+    created_before: z.ZodOptional<z.ZodString>;
+    sort_direction: z.ZodOptional<z.ZodEnum<{
+        readonly ASC: "asc";
+        readonly DESC: "desc";
+    }>>;
+}, z.core.$strict>;
+export type RunListParams = z.infer<typeof runListParamsSchema>;
 //# sourceMappingURL=types.d.ts.map

package/dist/runs/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/runs/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE7D,mCAAmC;AACnC,oBAAY,aAAa;IACxB,GAAG,QAAQ;IACX,IAAI,SAAS;CACb;AAED,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC7B,iCAAiC;IACjC,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,8BAA8B;IAC9B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,iDAAiD;AACjD,MAAM,WAAW,GAAG;IACnB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,MAAM,EAAE,SAAS,CAAC;IAClB,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,sDAAsD;IACtD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,mDAAmD;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACvC,sEAAsE;IACtE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IACvB,mEAAmE;IACnE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,8CAA8C;IAC9C,cAAc,EAAE,aAAa,GAAG,IAAI,CAAC;CACrC;AAED,8CAA8C;AAC9C,MAAM,WAAW,cAAc;IAC9B,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,QAAQ,EAAE,OAAO,CAAC;IAClB,gEAAgE;IAChE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,yCAAyC;AACzC,MAAM,WAAW,eAAe;IAC/B,qBAAqB;IACrB,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,8BAA8B;IAC9B,UAAU,EAAE,cAAc,CAAC;CAC3B;AAED,mCAAmC;AACnC,MAAM,WAAW,aAAa;IAC7B,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,cAAc,CAAC,EAAE,aAAa,CAAC;CAC/B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/runs/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,mCAAmC;AACnC,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AACX,eAAO,MAAM,mBAAmB;;;EAAwB,CAAC;AACzD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,4CAA4C;AAC5C,eAAO,MAAM,mBAAmB;;;iBAG9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,iDAAiD;AACjD,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAYpB,CAAC;AACH,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAE5C,8CAA8C;AAC9C,eAAO,MAAM,oBAAoB;;;;iBAI/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,yCAAyC;AACzC,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,mCAAmC;AACnC,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;kBAQ9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/runs/types.js

@@ -1,10 +1,52 @@
 /**
- * Runs management request/response types.
+ * Runs management request/response types and schemas.
  */
+import { z } from "zod";
+import { runErrorSchema, runStatusSchema } from "../agent/types.js";
 /** Sort order for list queries. */
-export var SortDirection;
-(function (SortDirection) {
-    SortDirection["ASC"] = "asc";
-    SortDirection["DESC"] = "desc";
-})(SortDirection || (SortDirection = {}));
+export const SortDirection = {
+    ASC: "asc",
+    DESC: "desc",
+};
+export const sortDirectionSchema = z.enum(SortDirection);
+/** Browser configuration used for a run. */
+export const browserConfigSchema = z.object({
+    proxy_enabled: z.boolean().nullable(),
+    proxy_country_code: z.string().nullable(),
+});
+/** A single automation run with full details. */
+export const runSchema = z.object({
+    run_id: z.string(),
+    status: runStatusSchema,
+    goal: z.string(),
+    created_at: z.string(),
+    started_at: z.string().nullable(),
+    finished_at: z.string().nullable(),
+    num_of_steps: z.number().nullable(),
+    result: z.record(z.string(), z.unknown()).nullable(),
+    error: runErrorSchema.nullable(),
+    streaming_url: z.string().nullable(),
+    browser_config: browserConfigSchema.nullable(),
+});
+/** Pagination metadata for list responses. */
+export const paginationInfoSchema = z.object({
+    total: z.number(),
+    has_more: z.boolean(),
+    next_cursor: z.string().nullable(),
+});
+/** Paginated list of automation runs. */
+export const runListResponseSchema = z.object({
+    data: z.array(runSchema),
+    pagination: paginationInfoSchema,
+});
+/** Parameters for listing runs. */
+export const runListParamsSchema = z.strictObject({
+    cursor: z.string().optional(),
+    limit: z.number().optional(),
+    status: runStatusSchema.optional(),
+    goal: z.string().optional(),
+    created_after: z.string().optional(),
+    created_before: z.string().optional(),
+    sort_direction: sortDirectionSchema.optional(),
+});
 //# sourceMappingURL=types.js.map

package/dist/runs/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/runs/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,mCAAmC;AACnC,MAAM,CAAN,IAAY,aAGX;AAHD,WAAY,aAAa;IACxB,4BAAW,CAAA;IACX,8BAAa,CAAA;AACd,CAAC,EAHW,aAAa,KAAb,aAAa,QAGxB"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/runs/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpE,mCAAmC;AACnC,MAAM,CAAC,MAAM,aAAa,GAAG;IAC5B,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,MAAM;CACH,CAAC;AACX,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AAGzD,4CAA4C;AAC5C,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACrC,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACzC,CAAC,CAAC;AAGH,iDAAiD;AACjD,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,MAAM,EAAE,eAAe;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpD,KAAK,EAAE,cAAc,CAAC,QAAQ,EAAE;IAChC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,cAAc,EAAE,mBAAmB,CAAC,QAAQ,EAAE;CAC9C,CAAC,CAAC;AAGH,8CAA8C;AAC9C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IACrB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAGH,yCAAyC;AACzC,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC;IACxB,UAAU,EAAE,oBAAoB;CAChC,CAAC,CAAC;AAGH,mCAAmC;AACnC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,YAAY,CAAC;IACjD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,MAAM,EAAE,eAAe,CAAC,QAAQ,EAAE;IAClC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,cAAc,EAAE,mBAAmB,CAAC,QAAQ,EAAE;CAC9C,CAAC,CAAC"}

package/dist/search/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Search API resource.
+ */
+import { APIResource } from "../_utils/resource.js";
+import { type SearchQueryParams, type SearchQueryResponse } from "./types.js";
+/** Query the Search API. */
+export declare class SearchResource extends APIResource {
+    query(params: SearchQueryParams): Promise<SearchQueryResponse>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/search/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/search/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EACN,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EAGxB,MAAM,YAAY,CAAC;AAEpB,4BAA4B;AAC5B,qBAAa,cAAe,SAAQ,WAAW;IACxC,KAAK,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAmBpE"}

package/dist/search/index.js

@@ -0,0 +1,29 @@
+/**
+ * Search API resource.
+ */
+import { SDKError } from "../_utils/errors.js";
+import { APIResource } from "../_utils/resource.js";
+import { searchQueryParamsSchema, searchQueryResponseSchema, } from "./types.js";
+/** Query the Search API. */
+export class SearchResource extends APIResource {
+    async query(params) {
+        const parsed = searchQueryParamsSchema.safeParse(params);
+        if (!parsed.success) {
+            const issue = parsed.error.issues[0];
+            throw new SDKError(issue?.message ?? "Invalid search request");
+        }
+        const validParams = parsed.data;
+        const queryParams = {
+            query: validParams.query,
+        };
+        if (validParams.location !== undefined)
+            queryParams["location"] = validParams.location;
+        if (validParams.language !== undefined)
+            queryParams["language"] = validParams.language;
+        const response = await this._client.get("/v1/search", {
+            params: queryParams,
+        });
+        return searchQueryResponseSchema.parse(response);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/search/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAGN,uBAAuB,EACvB,yBAAyB,GACzB,MAAM,YAAY,CAAC;AAEpB,4BAA4B;AAC5B,MAAM,OAAO,cAAe,SAAQ,WAAW;IAC9C,KAAK,CAAC,KAAK,CAAC,MAAyB;QACpC,MAAM,MAAM,GAAG,uBAAuB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACrB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACrC,MAAM,IAAI,QAAQ,CAAC,KAAK,EAAE,OAAO,IAAI,wBAAwB,CAAC,CAAC;QAChE,CAAC;QACD,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC;QAEhC,MAAM,WAAW,GAA8C;YAC9D,KAAK,EAAE,WAAW,CAAC,KAAK;SACxB,CAAC;QACF,IAAI,WAAW,CAAC,QAAQ,KAAK,SAAS;YAAE,WAAW,CAAC,UAAU,CAAC,GAAG,WAAW,CAAC,QAAQ,CAAC;QACvF,IAAI,WAAW,CAAC,QAAQ,KAAK,SAAS;YAAE,WAAW,CAAC,UAAU,CAAC,GAAG,WAAW,CAAC,QAAQ,CAAC;QAEvF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE;YACrD,MAAM,EAAE,WAAW;SACnB,CAAC,CAAC;QACH,OAAO,yBAAyB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC;CACD"}

package/dist/search/types.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Search API request/response types and schemas.
+ */
+import { z } from "zod";
+/** Parameters for `search.query(...)`. */
+export declare const searchQueryParamsSchema: z.ZodObject<{
+    query: z.ZodString;
+    location: z.ZodOptional<z.ZodString>;
+    language: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type SearchQueryParams = z.infer<typeof searchQueryParamsSchema>;
+/** A single search result item. */
+export declare const searchResultSchema: z.ZodObject<{
+    position: z.ZodNumber;
+    site_name: z.ZodString;
+    snippet: z.ZodString;
+    title: z.ZodString;
+    url: z.ZodString;
+}, z.core.$strip>;
+export type SearchResult = z.infer<typeof searchResultSchema>;
+/** Public response for `GET /v1/search`. */
+export declare const searchQueryResponseSchema: z.ZodObject<{
+    query: z.ZodString;
+    results: z.ZodArray<z.ZodObject<{
+        position: z.ZodNumber;
+        site_name: z.ZodString;
+        snippet: z.ZodString;
+        title: z.ZodString;
+        url: z.ZodString;
+    }, z.core.$strip>>;
+    total_results: z.ZodNumber;
+}, z.core.$strip>;
+export type SearchQueryResponse = z.infer<typeof searchQueryResponseSchema>;
+//# sourceMappingURL=types.d.ts.map

package/dist/search/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/search/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,0CAA0C;AAC1C,eAAO,MAAM,uBAAuB;;;;kBAIlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,mCAAmC;AACnC,eAAO,MAAM,kBAAkB;;;;;;iBAM7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,4CAA4C;AAC5C,eAAO,MAAM,yBAAyB;;;;;;;;;;iBAIpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/search/types.js

@@ -0,0 +1,25 @@
+/**
+ * Search API request/response types and schemas.
+ */
+import { z } from "zod";
+/** Parameters for `search.query(...)`. */
+export const searchQueryParamsSchema = z.strictObject({
+    query: z.string().trim().min(1, "query must be a non-empty string"),
+    location: z.string().optional(),
+    language: z.string().optional(),
+});
+/** A single search result item. */
+export const searchResultSchema = z.object({
+    position: z.number(),
+    site_name: z.string(),
+    snippet: z.string(),
+    title: z.string(),
+    url: z.string(),
+});
+/** Public response for `GET /v1/search`. */
+export const searchQueryResponseSchema = z.object({
+    query: z.string(),
+    results: z.array(searchResultSchema),
+    total_results: z.number(),
+});
+//# sourceMappingURL=types.js.map

package/dist/search/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/search/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,0CAA0C;AAC1C,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,YAAY,CAAC;IACrD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,kCAAkC,CAAC;IACnE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAGH,mCAAmC;AACnC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;CACf,CAAC,CAAC;AAGH,4CAA4C;AAC5C,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC;IACpC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;CACzB,CAAC,CAAC"}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.0.5";
+export declare const VERSION = "0.0.7";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,3 +1,3 @@
 // Auto-generated by scripts/generate-version.ts — do not edit manually.
-export const VERSION = "0.0.5";
+export const VERSION = "0.0.7";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiny-fish/sdk",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "description": "TinyFish TypeScript SDK — State-of-the-art web agents in an API",
   "type": "module",
   "main": "dist/index.js",
@@ -33,7 +33,8 @@
     "typescript": "^5"
   },
   "dependencies": {
-    "p-retry": "^7.1.1"
+    "p-retry": "^7.1.1",
+    "zod": "^4.3.6"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",