@nimble-way/nimble-js 0.17.0 → 0.18.0

package/src/resources/jobs/runs/artifacts.ts

@@ -50,43 +50,104 @@ export class Artifacts extends APIResource {
   }
 }
 
+/**
+ * Artifacts produced by a run.
+ */
 export interface ArtifactListResponse {
+  /**
+   * Artifacts produced by the run.
+   */
   items: Array<ArtifactListResponse.Item>;
 }
 
 export namespace ArtifactListResponse {
+  /**
+   * A file produced by a run.
+   *
+   * Intentional subset of the bakery Artifact: `data_format` and `s3_path` are
+   * hidden from SDK consumers — internal storage details, not part of the public
+   * contract. Use the download-url endpoint to fetch the file. Bakery emits `id` as
+   * an int (crawlit native); the SDK contract is a string.
+   */
   export interface Item {
+    /**
+     * Artifact identifier.
+     */
     id: string;
 
+    /**
+     * When the artifact was created.
+     */
     created_at: string;
 
     description: string;
 
+    /**
+     * Artifact type.
+     */
     type: string;
   }
 }
 
+/**
+ * A pre-signed URL for downloading an artifact.
+ */
 export interface ArtifactDownloadURLResponse {
+  /**
+   * When the download URL expires.
+   */
   expires_at: string;
 
+  /**
+   * Pre-signed URL to download the artifact.
+   */
   url: string;
 }
 
+/**
+ * A file produced by a run.
+ *
+ * Intentional subset of the bakery Artifact: `data_format` and `s3_path` are
+ * hidden from SDK consumers — internal storage details, not part of the public
+ * contract. Use the download-url endpoint to fetch the file. Bakery emits `id` as
+ * an int (crawlit native); the SDK contract is a string.
+ */
 export interface ArtifactGetResponse {
+  /**
+   * Artifact identifier.
+   */
   id: string;
 
+  /**
+   * When the artifact was created.
+   */
   created_at: string;
 
   description: string;
 
+  /**
+   * Artifact type.
+   */
   type: string;
 }
 
+/**
+ * A tabular preview of an artifact's contents.
+ */
 export interface ArtifactPreviewResponse {
+  /**
+   * Column names in the preview.
+   */
   columns: Array<string>;
 
+  /**
+   * Total number of rows in the artifact.
+   */
   row_count: number;
 
+  /**
+   * Sample rows from the artifact.
+   */
   rows: Array<{ [key: string]: unknown }>;
 }
 

package/src/resources/jobs/runs/runs.ts

@@ -45,100 +45,239 @@ export class Runs extends APIResource {
   }
 }
 
+/**
+ * A page of job runs.
+ */
 export interface RunListResponse {
+  /**
+   * Runs on this page.
+   */
   items: Array<RunListResponse.Item>;
 
+  /**
+   * Current page number.
+   */
   page: number;
 
+  /**
+   * Number of items per page.
+   */
   per_page: number;
 
+  /**
+   * Total number of runs matching the query.
+   */
   total: number;
 }
 
 export namespace RunListResponse {
+  /**
+   * A single execution of a job.
+   */
   export interface Item {
+    /**
+     * Unique run identifier (run\_<n>).
+     */
     id: string;
 
+    /**
+     * When the run was created.
+     */
     created_at: string;
 
+    /**
+     * Identifier of the job this run belongs to.
+     */
     job_id: string;
 
+    /**
+     * Current run status.
+     */
     status: 'PENDING' | 'RUNNING' | 'SUCCESS' | 'FAILED' | 'CANCELLED' | 'TIMEOUT' | 'WARNING';
 
+    /**
+     * What triggered the run: 'schedule' or 'manual'.
+     */
     triggered_by: 'schedule' | 'manual';
 
+    /**
+     * When the run finished.
+     */
     finished_at?: string | null;
 
+    /**
+     * Number of input records processed.
+     */
     input_count?: number | null;
 
+    /**
+     * Number of result records produced.
+     */
     result_count?: number | null;
 
+    /**
+     * When the run started executing.
+     */
     started_at?: string | null;
   }
 }
 
+/**
+ * Result of cancelling a run.
+ */
 export interface RunCancelResponse {
+  /**
+   * Identifier of the cancelled run.
+   */
   id: string;
 
+  /**
+   * Run status after cancellation.
+   */
   status: 'PENDING' | 'RUNNING' | 'SUCCESS' | 'FAILED' | 'CANCELLED' | 'TIMEOUT' | 'WARNING';
 }
 
+/**
+ * Full detail for a single run.
+ */
 export interface RunGetResponse {
+  /**
+   * Unique run identifier (run\_<n>).
+   */
   id: string;
 
+  /**
+   * When the run was created.
+   */
   created_at: string;
 
+  /**
+   * Context of the job this run belongs to.
+   */
   job: RunGetResponse.Job;
 
+  /**
+   * Current run status.
+   */
   status: 'PENDING' | 'RUNNING' | 'SUCCESS' | 'FAILED' | 'CANCELLED' | 'TIMEOUT' | 'WARNING';
 
+  /**
+   * What triggered the run: 'schedule' or 'manual'.
+   */
   triggered_by: 'schedule' | 'manual';
 
+  /**
+   * Error details for a failed run.
+   */
   error?: RunGetResponse.Error | null;
 
+  /**
+   * When the run finished.
+   */
   finished_at?: string | null;
 
+  /**
+   * Sample of the run's input records.
+   */
   inputs_sample?: Array<unknown> | null;
 
+  /**
+   * When the run started executing.
+   */
   started_at?: string | null;
 
+  /**
+   * Aggregate metrics for a run.
+   */
   summary?: RunGetResponse.Summary | null;
 }
 
 export namespace RunGetResponse {
+  /**
+   * Context of the job this run belongs to.
+   */
   export interface Job {
+    /**
+     * Unique job identifier (job\_<n>).
+     */
     id: string;
 
+    /**
+     * Internal job name.
+     */
     name: string;
 
+    /**
+     * Name of the agent this job runs.
+     */
     agent_name?: string | null;
 
+    /**
+     * Human-friendly job name shown in the UI.
+     */
     display_name?: string | null;
 
+    /**
+     * Cron-based schedule controlling when a job runs automatically.
+     */
     schedule?: Job.Schedule | null;
   }
 
   export namespace Job {
+    /**
+     * Cron-based schedule controlling when a job runs automatically.
+     */
     export interface Schedule {
+      /**
+       * Cron expression defining when the job runs.
+       */
       cron: string;
 
+      /**
+       * Whether the schedule is currently active.
+       */
       enabled: boolean;
     }
   }
 
+  /**
+   * Error details for a failed run.
+   */
   export interface Error {
+    /**
+     * Sample of individual error records from the run.
+     */
     errors_sample?: Array<{ [key: string]: unknown }> | null;
 
+    /**
+     * Human-readable error message.
+     */
     message?: string | null;
 
+    /**
+     * Pipeline step where the error occurred.
+     */
     step?: string | null;
   }
 
+  /**
+   * Aggregate metrics for a run.
+   */
   export interface Summary {
+    /**
+     * Number of input records processed.
+     */
     input_count?: number | null;
 
+    /**
+     * Fraction of inputs that produced a result (result_count / input_count), from 0.0
+     * to 1.0.
+     */
     match_rate?: number | null;
 
+    /**
+     * Number of result records produced.
+     */
     result_count?: number | null;
   }
 }

package/src/resources/media.ts

@@ -440,7 +440,7 @@ export namespace MediaRunAsyncResponse {
     /**
      * Current state of the task.
      */
-    state: 'pending' | 'success' | 'error';
+    state: 'pending' | 'queued' | 'in_progress' | 'success' | 'error';
 
     /**
      * URL for checking the task status.
@@ -452,7 +452,7 @@ export namespace MediaRunAsyncResponse {
      */
     account_name?: string;
 
-    api_type?: 'web' | 'serp' | 'ecommerce' | 'social' | 'media' | 'agent' | 'extract' | 'fast-serp';
+    api_type?: 'web' | 'serp' | 'ecommerce' | 'social' | 'media' | 'agent' | 'extract' | 'fast-serp' | 'labs';
 
     /**
      * Batch ID if this task is part of a batch.
@@ -484,6 +484,11 @@ export namespace MediaRunAsyncResponse {
      */
     output_url?: string;
 
+    /**
+     * Queue name the task was submitted to.
+     */
+    queue?: string;
+
     /**
      * HTTP status code from the task execution.
      */

package/src/resources/serp.ts

@@ -454,7 +454,7 @@ export namespace SerpRunAsyncResponse {
     /**
      * Current state of the task.
      */
-    state: 'pending' | 'success' | 'error';
+    state: 'pending' | 'queued' | 'in_progress' | 'success' | 'error';
 
     /**
      * URL for checking the task status.
@@ -466,7 +466,7 @@ export namespace SerpRunAsyncResponse {
      */
     account_name?: string;
 
-    api_type?: 'web' | 'serp' | 'ecommerce' | 'social' | 'media' | 'agent' | 'extract' | 'fast-serp';
+    api_type?: 'web' | 'serp' | 'ecommerce' | 'social' | 'media' | 'agent' | 'extract' | 'fast-serp' | 'labs';
 
     /**
      * Batch ID if this task is part of a batch.
@@ -498,6 +498,11 @@ export namespace SerpRunAsyncResponse {
      */
     output_url?: string;
 
+    /**
+     * Queue name the task was submitted to.
+     */
+    queue?: string;
+
     /**
      * HTTP status code from the task execution.
      */
@@ -547,7 +552,7 @@ export namespace SerpRunBatchResponse {
     /**
      * Current state of the task.
      */
-    state: 'pending' | 'success' | 'error';
+    state: 'pending' | 'queued' | 'in_progress' | 'success' | 'error';
 
     /**
      * URL for checking the task status.
@@ -559,7 +564,7 @@ export namespace SerpRunBatchResponse {
      */
     account_name?: string;
 
-    api_type?: 'web' | 'serp' | 'ecommerce' | 'social' | 'media' | 'agent' | 'extract' | 'fast-serp';
+    api_type?: 'web' | 'serp' | 'ecommerce' | 'social' | 'media' | 'agent' | 'extract' | 'fast-serp' | 'labs';
 
     /**
      * Batch ID if this task is part of a batch.
@@ -591,6 +596,11 @@ export namespace SerpRunBatchResponse {
      */
     output_url?: string;
 
+    /**
+     * Queue name the task was submitted to.
+     */
+    queue?: string;
+
     /**
      * HTTP status code from the task execution.
      */

package/src/resources/task-agent/runs.ts

@@ -186,33 +186,65 @@ export namespace RunGetResultResponse {
        */
       content: string;
 
-      basis?: Array<AgentRunTextOutput.Basi>;
+      trust: AgentRunTextOutput.Trust;
 
       type?: 'text';
     }
 
     export namespace AgentRunTextOutput {
-      export interface Basi {
-        field: string;
+      export interface Trust {
+        claims: Array<Trust.Claim>;
 
-        citations?: Array<Basi.Citation>;
+        confidence: 'high' | 'medium' | 'low';
 
-        confidence?: 'high' | 'medium' | 'low' | null;
+        reasoning: string;
 
-        reasoning?: string;
+        sources: Array<Trust.Source>;
       }
 
-      export namespace Basi {
-        export interface Citation {
-          url: string;
+      export namespace Trust {
+        export interface Claim {
+          callout: number;
 
-          excerpts?: Array<string> | null;
+          citations: Array<Claim.Citation>;
 
-          index?: number | null;
+          confidence: 'high' | 'medium' | 'low';
 
-          title?: string | null;
+          reasoning: string;
+
+          source?: Claim.Source | null;
+        }
+
+        export namespace Claim {
+          export interface Citation {
+            url: string;
+
+            excerpts?: Array<string> | null;
+
+            extract_template_name?: string | null;
+
+            title?: string | null;
+          }
+
+          export interface Source {
+            type: 'primary' | 'secondary';
 
-          web_search_agent?: string | null;
+            url: string;
+
+            extract_template_name?: string | null;
+
+            title?: string | null;
+          }
+        }
+
+        export interface Source {
+          type: 'primary' | 'secondary';
+
+          url: string;
+
+          extract_template_name?: string | null;
+
+          title?: string | null;
         }
       }
     }
@@ -220,33 +252,65 @@ export namespace RunGetResultResponse {
     export interface AgentRunJsonOutput {
       content: { [key: string]: unknown } | Array<unknown>;
 
-      basis?: Array<AgentRunJsonOutput.Basi>;
+      trust: AgentRunJsonOutput.Trust;
 
       type?: 'json';
     }
 
     export namespace AgentRunJsonOutput {
-      export interface Basi {
-        field: string;
+      export interface Trust {
+        claims: Array<Trust.Claim>;
 
-        citations?: Array<Basi.Citation>;
+        confidence: 'high' | 'medium' | 'low';
 
-        confidence?: 'high' | 'medium' | 'low' | null;
+        reasoning: string;
 
-        reasoning?: string;
+        sources: Array<Trust.Source>;
       }
 
-      export namespace Basi {
-        export interface Citation {
-          url: string;
+      export namespace Trust {
+        export interface Claim {
+          citations: Array<Claim.Citation>;
 
-          excerpts?: Array<string> | null;
+          confidence: 'high' | 'medium' | 'low';
 
-          index?: number | null;
+          path: string;
 
-          title?: string | null;
+          reasoning: string;
+
+          source?: Claim.Source | null;
+        }
+
+        export namespace Claim {
+          export interface Citation {
+            url: string;
+
+            excerpts?: Array<string> | null;
+
+            extract_template_name?: string | null;
+
+            title?: string | null;
+          }
+
+          export interface Source {
+            type: 'primary' | 'secondary';
 
-          web_search_agent?: string | null;
+            url: string;
+
+            extract_template_name?: string | null;
+
+            title?: string | null;
+          }
+        }
+
+        export interface Source {
+          type: 'primary' | 'secondary';
+
+          url: string;
+
+          extract_template_name?: string | null;
+
+          title?: string | null;
         }
       }
     }

package/src/resources/tasks.ts

@@ -65,7 +65,7 @@ export namespace TaskListResponse {
     /**
      * Current state of the task.
      */
-    state: 'pending' | 'success' | 'error';
+    state: 'pending' | 'queued' | 'in_progress' | 'success' | 'error';
 
     /**
      * URL for checking the task status.
@@ -77,7 +77,7 @@ export namespace TaskListResponse {
      */
     account_name?: string;
 
-    api_type?: 'web' | 'serp' | 'ecommerce' | 'social' | 'media' | 'agent' | 'extract' | 'fast-serp';
+    api_type?: 'web' | 'serp' | 'ecommerce' | 'social' | 'media' | 'agent' | 'extract' | 'fast-serp' | 'labs';
 
     /**
      * Batch ID if this task is part of a batch.
@@ -109,6 +109,11 @@ export namespace TaskListResponse {
      */
     output_url?: string;
 
+    /**
+     * Queue name the task was submitted to.
+     */
+    queue?: string;
+
     /**
      * HTTP status code from the task execution.
      */
@@ -162,7 +167,7 @@ export namespace TaskGetResponse {
     /**
      * Current state of the task.
      */
-    state: 'pending' | 'success' | 'error';
+    state: 'pending' | 'queued' | 'in_progress' | 'success' | 'error';
 
     /**
      * URL for checking the task status.
@@ -174,7 +179,7 @@ export namespace TaskGetResponse {
      */
     account_name?: string;
 
-    api_type?: 'web' | 'serp' | 'ecommerce' | 'social' | 'media' | 'agent' | 'extract' | 'fast-serp';
+    api_type?: 'web' | 'serp' | 'ecommerce' | 'social' | 'media' | 'agent' | 'extract' | 'fast-serp' | 'labs';
 
     /**
      * Batch ID if this task is part of a batch.
@@ -206,6 +211,11 @@ export namespace TaskGetResponse {
      */
     output_url?: string;
 
+    /**
+     * Queue name the task was submitted to.
+     */
+    queue?: string;
+
     /**
      * HTTP status code from the task execution.
      */