@nodaro/sdk 1.26.0 → 1.27.0

package/dist/index.d.cts

@@ -317,6 +317,29 @@ declare class ProjectsResource {
 }
 
 type JobStatus = "pending" | "queued" | "processing" | "completed" | "failed" | "cancelled";
+/**
+ * A job's `jobs.error_hint` (migration 376) — a user-safe, machine-readable
+ * failure verdict the worker writes on a FINAL provider content-policy
+ * block, so a caller can act on it without parsing `error_message` prose.
+ * `class` distinguishes a deterministic block (copyright/likeness — retrying
+ * the same request never helps) from `safety`, whose filter is known to be
+ * non-deterministic for some models: `retried` says whether the worker
+ * already spent its one extra attempt, and `suggestedProvider` — present
+ * only when the catalog declares a fallback for the model that failed — is a
+ * real model id the SAME prompt/references can be retried on.
+ */
+interface JobErrorHint {
+    kind: "safety-block";
+    class: "copyright" | "likeness" | "safety";
+    retried: boolean;
+    suggestedProvider?: string;
+}
+/**
+ * The billing lifecycle of a job's credit reservation — `usage_logs.status`
+ * for the job's `usage_log_id`. `null` when the job has no usage log (e.g. a
+ * free run) or hasn't reserved credits yet.
+ */
+type CreditStatus = "reserved" | "committed" | "refunded";
 /**
  * Job record returned to non-admin SDK consumers. Field names are snake_case
  * to match the wire format (per the OpenAPI fix in Phase 1).
@@ -335,6 +358,13 @@ interface Job {
     input_data: unknown;
     output_data: unknown;
     error_message: string | null;
+    /** PR9: present on a failed job the worker classified as a content-policy
+     *  block; absent/null otherwise. User-safe by construction. */
+    error_hint?: JobErrorHint | null;
+    /** PR9: the job's credit reservation lifecycle, derived server-side from
+     *  `usage_logs.status`. `null` when there is no usage log to report. Never
+     *  changes the meaning of `credits` (the reserved amount) below. */
+    credit_status?: CreditStatus | null;
     credits: number | null;
     job_type: string | null;
     created_at: string;
@@ -382,6 +412,10 @@ interface JobStatusResult {
     progress?: number;
     output_data?: unknown;
     error_message?: string | null;
+    /** PR9: see {@link Job.error_hint}. */
+    error_hint?: JobErrorHint | null;
+    /** PR9: see {@link Job.credit_status}. */
+    credit_status?: CreditStatus | null;
 }
 declare class JobsResource {
     private client;

package/dist/index.d.ts

@@ -317,6 +317,29 @@ declare class ProjectsResource {
 }
 
 type JobStatus = "pending" | "queued" | "processing" | "completed" | "failed" | "cancelled";
+/**
+ * A job's `jobs.error_hint` (migration 376) — a user-safe, machine-readable
+ * failure verdict the worker writes on a FINAL provider content-policy
+ * block, so a caller can act on it without parsing `error_message` prose.
+ * `class` distinguishes a deterministic block (copyright/likeness — retrying
+ * the same request never helps) from `safety`, whose filter is known to be
+ * non-deterministic for some models: `retried` says whether the worker
+ * already spent its one extra attempt, and `suggestedProvider` — present
+ * only when the catalog declares a fallback for the model that failed — is a
+ * real model id the SAME prompt/references can be retried on.
+ */
+interface JobErrorHint {
+    kind: "safety-block";
+    class: "copyright" | "likeness" | "safety";
+    retried: boolean;
+    suggestedProvider?: string;
+}
+/**
+ * The billing lifecycle of a job's credit reservation — `usage_logs.status`
+ * for the job's `usage_log_id`. `null` when the job has no usage log (e.g. a
+ * free run) or hasn't reserved credits yet.
+ */
+type CreditStatus = "reserved" | "committed" | "refunded";
 /**
  * Job record returned to non-admin SDK consumers. Field names are snake_case
  * to match the wire format (per the OpenAPI fix in Phase 1).
@@ -335,6 +358,13 @@ interface Job {
     input_data: unknown;
     output_data: unknown;
     error_message: string | null;
+    /** PR9: present on a failed job the worker classified as a content-policy
+     *  block; absent/null otherwise. User-safe by construction. */
+    error_hint?: JobErrorHint | null;
+    /** PR9: the job's credit reservation lifecycle, derived server-side from
+     *  `usage_logs.status`. `null` when there is no usage log to report. Never
+     *  changes the meaning of `credits` (the reserved amount) below. */
+    credit_status?: CreditStatus | null;
     credits: number | null;
     job_type: string | null;
     created_at: string;
@@ -382,6 +412,10 @@ interface JobStatusResult {
     progress?: number;
     output_data?: unknown;
     error_message?: string | null;
+    /** PR9: see {@link Job.error_hint}. */
+    error_hint?: JobErrorHint | null;
+    /** PR9: see {@link Job.credit_status}. */
+    credit_status?: CreditStatus | null;
 }
 declare class JobsResource {
     private client;

package/dist/index.js

@@ -2718,7 +2718,7 @@ var WorkspacesResource = class {
     return this.client.requestText("GET", `/v1/workspaces/${encodeURIComponent(id)}/usage`, { query: { ...opts, format: "csv" } });
   }
 };
-var SDK_VERSION = "1.26.0" ;
+var SDK_VERSION = "1.27.0" ;
 var CLIENT_HEADER = "X-Nodaro-Client";
 var isBrowser = () => typeof window !== "undefined" && typeof window.document !== "undefined";
 var NodaroClient = class _NodaroClient {