@nodaro/sdk 2.44.0 → 2.46.0

package/dist/entries/client.js

@@ -1,17 +1,18 @@
-export { NodaroClient, createClient } from '../chunk-6PI3CI7P.js';
+export { NodaroClient, createClient } from '../chunk-WFAFFAGV.js';
+import '../chunk-WY4QRJZW.js';
 import '../chunk-ERLXU47J.js';
 import '../chunk-T7N7DFQJ.js';
 import '../chunk-YN6CBIIB.js';
-import '../chunk-RETNLKOC.js';
+import '../chunk-33HT46A3.js';
 import '../chunk-Z5GLY4R3.js';
 import '../chunk-NNHWH7ER.js';
-import '../chunk-Y6VDCZPB.js';
+import '../chunk-WS4ZQ4AA.js';
 import '../chunk-WVFAQBS7.js';
 import '../chunk-AUKHMT53.js';
-import '../chunk-ILG5DHQQ.js';
-import '../chunk-4UPVE662.js';
-import '../chunk-YSZM3N7Q.js';
-import '../chunk-WY4QRJZW.js';
+import '../chunk-M7VSFZMV.js';
+import '../chunk-KBHDUHKM.js';
+import '../chunk-XILR6TFO.js';
+import '../chunk-HPXE3NZW.js';
 import '../chunk-WEQWU2IC.js';
 import '../chunk-KFZOJBI5.js';
 import '../chunk-K4RQOSJH.js';
@@ -20,18 +21,18 @@ import '../chunk-OIPPTBW4.js';
 import '../chunk-AJVSMNPZ.js';
 import '../chunk-IHKIYVZQ.js';
 import '../chunk-NCCBS6GU.js';
-import '../chunk-DQAYIVVS.js';
+import '../chunk-BQAW4RX2.js';
 import '../chunk-Y6V6CBY5.js';
 import '../chunk-YVU2M7MI.js';
 import '../chunk-JTAW54UM.js';
-import '../chunk-ZWPDWFN2.js';
+import '../chunk-GW76IRQD.js';
 import '../chunk-Z7LGWNI7.js';
 import '../chunk-7LSFG2AF.js';
 import '../chunk-ALSLZG3U.js';
-import '../chunk-Z7UZ3FD3.js';
+import '../chunk-RBX3QTKB.js';
 import '../chunk-Z3ZKFI2M.js';
 import '../chunk-JDEZHITT.js';
-import '../chunk-6MQ2LTJZ.js';
+import '../chunk-PQHZUWSL.js';
 import '../chunk-P6E4QDJN.js';
 import '../chunk-E37CVHWW.js';
 import '../chunk-TVENC6PH.js';
@@ -40,15 +41,15 @@ import '../chunk-SFB4YLCS.js';
 import '../chunk-BU5A6K4C.js';
 import '../chunk-D2ILCSOQ.js';
 import '../chunk-7CUWAVWB.js';
-export { CallbackAuth, StaticTokenAuth, supabaseAuth } from '../chunk-DAGJLS7W.js';
+export { CallbackAuth, StaticTokenAuth, supabaseAuth } from '../chunk-5Q4SUZPL.js';
 import '../chunk-L6T44A3G.js';
 import '../chunk-CK3AMMSC.js';
-import '../chunk-IGMWFEFB.js';
+import '../chunk-5MOJSYHI.js';
 import '../chunk-65E3JBFZ.js';
-import '../chunk-FQNCIP6K.js';
+import '../chunk-7LODCIQK.js';
 import '../chunk-3QFTP5P5.js';
 import '../chunk-J4WFSKY6.js';
-import '../chunk-HKDIIFG2.js';
+import '../chunk-C3C7IL25.js';
 import '../chunk-KG4R454Z.js';
 import '../chunk-EJSGJDZY.js';
 //# sourceMappingURL=client.js.map

package/dist/entries/core.cjs

@@ -1,26 +1,26 @@
 'use strict';
 
 require('../chunk-X7XP5WBP.cjs');
-var chunkMPQQC45L_cjs = require('../chunk-MPQQC45L.cjs');
+var chunkZJCHIJND_cjs = require('../chunk-ZJCHIJND.cjs');
 require('../chunk-FM2KM5TY.cjs');
 
 
 
 Object.defineProperty(exports, "CallbackAuth", {
   enumerable: true,
-  get: function () { return chunkMPQQC45L_cjs.CallbackAuth; }
+  get: function () { return chunkZJCHIJND_cjs.CallbackAuth; }
 });
 Object.defineProperty(exports, "NodaroClientCore", {
   enumerable: true,
-  get: function () { return chunkMPQQC45L_cjs.NodaroClientCore; }
+  get: function () { return chunkZJCHIJND_cjs.NodaroClientCore; }
 });
 Object.defineProperty(exports, "StaticTokenAuth", {
   enumerable: true,
-  get: function () { return chunkMPQQC45L_cjs.StaticTokenAuth; }
+  get: function () { return chunkZJCHIJND_cjs.StaticTokenAuth; }
 });
 Object.defineProperty(exports, "supabaseAuth", {
   enumerable: true,
-  get: function () { return chunkMPQQC45L_cjs.supabaseAuth; }
+  get: function () { return chunkZJCHIJND_cjs.supabaseAuth; }
 });
 //# sourceMappingURL=core.cjs.map
 //# sourceMappingURL=core.cjs.map

package/dist/entries/core.js

@@ -1,5 +1,5 @@
 import '../chunk-AUDHV3OE.js';
-export { CallbackAuth, NodaroClientCore, StaticTokenAuth, supabaseAuth } from '../chunk-DAGJLS7W.js';
+export { CallbackAuth, NodaroClientCore, StaticTokenAuth, supabaseAuth } from '../chunk-5Q4SUZPL.js';
 import '../chunk-L6T44A3G.js';
 //# sourceMappingURL=core.js.map
 //# sourceMappingURL=core.js.map

package/dist/entries/creatures.d.cts

@@ -2,7 +2,7 @@ import { CreatureAttachColumn, ObjectAspectRatio } from '@nodaro/shared/entities
 export { OBJECT_ASPECT_DEFAULTS as CREATURE_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS as CREATURE_ASPECT_OPTIONS, CREATURE_ATTACH_COLUMNS, ObjectAspectRatio as CreatureAspectRatio, CreatureAttachColumn } from '@nodaro/shared/entities';
 import { TtsProvider } from '@nodaro/shared/models';
 import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
-import { l as GenerationSessionParams } from '../nodes-DzBGNOUV.cjs';
+import { l as GenerationSessionParams } from '../nodes-DGIefTze.cjs';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 import '@nodaro/shared/types';

package/dist/entries/creatures.d.ts

@@ -2,7 +2,7 @@ import { CreatureAttachColumn, ObjectAspectRatio } from '@nodaro/shared/entities
 export { OBJECT_ASPECT_DEFAULTS as CREATURE_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS as CREATURE_ASPECT_OPTIONS, CREATURE_ATTACH_COLUMNS, ObjectAspectRatio as CreatureAspectRatio, CreatureAttachColumn } from '@nodaro/shared/entities';
 import { TtsProvider } from '@nodaro/shared/models';
 import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
-import { l as GenerationSessionParams } from '../nodes-B4ZEqx2V.js';
+import { l as GenerationSessionParams } from '../nodes-C9j0PFto.js';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 import '@nodaro/shared/types';

package/dist/entries/credits.cjs

@@ -1,13 +1,13 @@
 'use strict';
 
 require('../chunk-ALUUBPDG.cjs');
-var chunkPQ7OKM3E_cjs = require('../chunk-PQ7OKM3E.cjs');
+var chunkFIMBPKIH_cjs = require('../chunk-FIMBPKIH.cjs');
 
 
 
 Object.defineProperty(exports, "CreditsResource", {
   enumerable: true,
-  get: function () { return chunkPQ7OKM3E_cjs.CreditsResource; }
+  get: function () { return chunkFIMBPKIH_cjs.CreditsResource; }
 });
 //# sourceMappingURL=credits.cjs.map
 //# sourceMappingURL=credits.cjs.map

package/dist/entries/credits.d.cts

@@ -118,7 +118,7 @@ interface ModelCostsResult {
      * The identifiers in `data` whose figure is an ESTIMATE, not a fixed price:
      * metered LLM price keys (`llmPriceKey` from `@nodaro/shared/llm-models`,
      * `<feature>:<model>[:direct]`), charged on what the call actually uses.
-     * Show these as `~N`. Omitted when there are none, so a batch of fixed ids
+     * Show these as `≈N`. Omitted when there are none, so a batch of fixed ids
      * answers exactly as it always has. A metered key that lands in `missing`
      * instead means the server is not pricing LLM calls per model — show no
      * price for it.
@@ -135,7 +135,7 @@ interface ModelCostError {
 /**
  * Result of `GET /v1/credits/model-cost?model=<id>` (`data`): the credits one
  * identifier is charged. `estimate: true` marks a metered LLM price key's
- * figure as an estimate (show it as `~N`); such an answer is never cached.
+ * figure as an estimate (show it as `≈N`); such an answer is never cached.
  */
 interface ModelCostResult {
     model: string;

package/dist/entries/credits.d.ts

@@ -118,7 +118,7 @@ interface ModelCostsResult {
      * The identifiers in `data` whose figure is an ESTIMATE, not a fixed price:
      * metered LLM price keys (`llmPriceKey` from `@nodaro/shared/llm-models`,
      * `<feature>:<model>[:direct]`), charged on what the call actually uses.
-     * Show these as `~N`. Omitted when there are none, so a batch of fixed ids
+     * Show these as `≈N`. Omitted when there are none, so a batch of fixed ids
      * answers exactly as it always has. A metered key that lands in `missing`
      * instead means the server is not pricing LLM calls per model — show no
      * price for it.
@@ -135,7 +135,7 @@ interface ModelCostError {
 /**
  * Result of `GET /v1/credits/model-cost?model=<id>` (`data`): the credits one
  * identifier is charged. `estimate: true` marks a metered LLM price key's
- * figure as an estimate (show it as `~N`); such an answer is never cached.
+ * figure as an estimate (show it as `≈N`); such an answer is never cached.
  */
 interface ModelCostResult {
     model: string;

package/dist/entries/credits.js

@@ -1,4 +1,4 @@
 import '../chunk-V4GPQ6Y2.js';
-export { CreditsResource } from '../chunk-IGMWFEFB.js';
+export { CreditsResource } from '../chunk-5MOJSYHI.js';
 //# sourceMappingURL=credits.js.map
 //# sourceMappingURL=credits.js.map

package/dist/entries/edit.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 var chunk6T54F65Q_cjs = require('../chunk-6T54F65Q.cjs');
-var chunk7XOK277W_cjs = require('../chunk-7XOK277W.cjs');
+var chunkSF2CMKWA_cjs = require('../chunk-SF2CMKWA.cjs');
 require('../chunk-FM2KM5TY.cjs');
 
 
@@ -12,23 +12,23 @@ Object.defineProperty(exports, "unwrapEditPlanOutput", {
 });
 Object.defineProperty(exports, "CLIP_PACK_MAX_TARGET_SEC", {
   enumerable: true,
-  get: function () { return chunk7XOK277W_cjs.CLIP_PACK_MAX_TARGET_SEC; }
+  get: function () { return chunkSF2CMKWA_cjs.CLIP_PACK_MAX_TARGET_SEC; }
 });
 Object.defineProperty(exports, "CLIP_PACK_MIN_TARGET_SEC", {
   enumerable: true,
-  get: function () { return chunk7XOK277W_cjs.CLIP_PACK_MIN_TARGET_SEC; }
+  get: function () { return chunkSF2CMKWA_cjs.CLIP_PACK_MIN_TARGET_SEC; }
 });
 Object.defineProperty(exports, "EditResource", {
   enumerable: true,
-  get: function () { return chunk7XOK277W_cjs.EditResource; }
+  get: function () { return chunkSF2CMKWA_cjs.EditResource; }
 });
 Object.defineProperty(exports, "TRAILER_FORMATS", {
   enumerable: true,
-  get: function () { return chunk7XOK277W_cjs.TRAILER_FORMATS; }
+  get: function () { return chunkSF2CMKWA_cjs.TRAILER_FORMATS; }
 });
 Object.defineProperty(exports, "USE_CASE_NODE_TYPES", {
   enumerable: true,
-  get: function () { return chunk7XOK277W_cjs.USE_CASE_NODE_TYPES; }
+  get: function () { return chunkSF2CMKWA_cjs.USE_CASE_NODE_TYPES; }
 });
 //# sourceMappingURL=edit.cjs.map
 //# sourceMappingURL=edit.cjs.map

package/dist/entries/edit.d.cts

@@ -546,7 +546,7 @@ interface UseCaseEstimate {
     /** The per-run fee. */
     feeCredits: number;
     /** A step is a metered LLM call's ESTIMATE (charged its actual usage), so the
-     *  total is one: show it `~N`. Absent for a fixed figure. */
+     *  total is one: show it `≈N`. Absent for a fixed figure. */
     estimate?: true;
     /** The recording's length, in seconds. */
     durationSec: number | null;

package/dist/entries/edit.d.ts

@@ -546,7 +546,7 @@ interface UseCaseEstimate {
     /** The per-run fee. */
     feeCredits: number;
     /** A step is a metered LLM call's ESTIMATE (charged its actual usage), so the
-     *  total is one: show it `~N`. Absent for a fixed figure. */
+     *  total is one: show it `≈N`. Absent for a fixed figure. */
     estimate?: true;
     /** The recording's length, in seconds. */
     durationSec: number | null;

package/dist/entries/edit.js

@@ -1,5 +1,5 @@
 export { unwrapEditPlanOutput } from '../chunk-UKB64254.js';
-export { CLIP_PACK_MAX_TARGET_SEC, CLIP_PACK_MIN_TARGET_SEC, EditResource, TRAILER_FORMATS, USE_CASE_NODE_TYPES } from '../chunk-Z7UZ3FD3.js';
+export { CLIP_PACK_MAX_TARGET_SEC, CLIP_PACK_MIN_TARGET_SEC, EditResource, TRAILER_FORMATS, USE_CASE_NODE_TYPES } from '../chunk-RBX3QTKB.js';
 import '../chunk-L6T44A3G.js';
 //# sourceMappingURL=edit.js.map
 //# sourceMappingURL=edit.js.map

package/dist/entries/jobs.cjs

@@ -1,13 +1,13 @@
 'use strict';
 
 require('../chunk-EHRWTYGR.cjs');
-var chunk34JMD6ZO_cjs = require('../chunk-34JMD6ZO.cjs');
+var chunk7LTVS75S_cjs = require('../chunk-7LTVS75S.cjs');
 
 
 
 Object.defineProperty(exports, "JobsResource", {
   enumerable: true,
-  get: function () { return chunk34JMD6ZO_cjs.JobsResource; }
+  get: function () { return chunk7LTVS75S_cjs.JobsResource; }
 });
 //# sourceMappingURL=jobs.cjs.map
 //# sourceMappingURL=jobs.cjs.map

package/dist/entries/jobs.d.cts

@@ -160,6 +160,17 @@ interface Job {
     /** The generation session this job was born in (the `sessionId` sent with
      *  the generation request), or null. See `client.sessions`. */
     session_id?: string | null;
+    /**
+     * With `list({ withSessions: true })`: every session that holds the job now,
+     * each linkable — empty when it is in no session (General). Absent otherwise.
+     */
+    sessions?: JobSessionRef[];
+    /**
+     * When the job was deleted, on a job read from the Trash
+     * (`client.trash.list()`). A deleted job is left out of every other read, so
+     * this is otherwise absent or `null`.
+     */
+    deleted_at?: string | null;
     /**
      * Whether the job's owner favorited it (`client.gallery.toggleFavorite`).
      * Returned by `get()` and `list()`. Absent from an older server, and when
@@ -191,6 +202,13 @@ type JobSource = "internal" | "mcp" | "app" | "cli" | "sdk" | "extension" | "web
 interface DeleteJobResult {
     success: true;
 }
+/** A session that holds a job now (`Job.sessions`). */
+interface JobSessionRef {
+    id: string;
+    title: string | null;
+    /** The session's project, or `null` when it has none. */
+    projectId: string | null;
+}
 interface ListJobsParams {
     /** One status or several (a job matching any of them). An unknown status is a 400. */
     status?: JobStatus | readonly JobStatus[];
@@ -208,6 +226,19 @@ interface ListJobsParams {
     rating?: JobRatingFilter;
     /** The jobs of one generate-image batch (`count` / `models`) — its `batchId`. */
     batchId?: string;
+    /**
+     * The jobs a session of this project holds now — or, `"none"`, a session
+     * with no project. Each job once, however many sessions hold it. Not with
+     * `inSession: false`.
+     */
+    projectId?: string | "none";
+    /**
+     * `false`: the jobs no session holds now (General), whatever session they
+     * were born in. `true`: the jobs at least one session holds.
+     */
+    inSession?: boolean;
+    /** `true`: each job carries `sessions`, the sessions that hold it now. */
+    withSessions?: boolean;
     /** Page size, 1–100 (server default 50). */
     limit?: number;
     /** The previous page's `next`. */
@@ -279,8 +310,11 @@ declare class JobsResource {
      * a client app lists its runs with `{ type: "llm-structured", origin: "studio" }`.
      * `status` and `type` take one value or a list; `favorited` and `rating`
      * filter on your own marks, `source` on the surface that created the job.
-     * Every filter combines with AND, and each job
-     * carries `favorited` and `rating`.
+     * `projectId` / `inSession` filter on where the job is now (a project's
+     * sessions, or General), and `withSessions` says which sessions each job is
+     * in — for "everything in this project". Every filter combines with AND,
+     * and each job carries `favorited` and `rating`. A deleted job is never
+     * listed: read the Trash with `client.trash.list()`.
      */
     list(params?: ListJobsParams): Promise<ListJobsPage>;
     /**
@@ -322,12 +356,27 @@ declare class JobsResource {
      */
     cancel(id: string): Promise<CancelJobResult>;
     /**
-     * Delete a job and the private media it produced. Server route is
-     * `DELETE /v1/jobs/:jobId`. Only the job's owner (or an admin) may delete it;
-     * a job that is still running is deleted as-is — cancel it first when its
-     * worker should stop ({@link cancel}).
+     * Delete a job: it goes to the Trash (`client.trash.list()`). It is left out
+     * of every read from then on, stays restorable for 30 days ({@link restore},
+     * back into the sessions it was in), and is then deleted for good, as a
+     * delete always was (a copy saved to the Library stays). `{ forever: true }` deletes a job already in the Trash for good now;
+     * on a live job it fails with a 409 `NodaroError` whose `code` is
+     * `"not_in_trash"`. Only the job's owner (or an admin) may delete it; a job
+     * that is still running keeps running — cancel it first when its worker
+     * should stop ({@link cancel}). Nothing is refunded. OAuth apps need the
+     * `assets:write` scope.
      */
-    delete(id: string): Promise<DeleteJobResult>;
+    delete(id: string, options?: {
+        forever?: boolean;
+    }): Promise<DeleteJobResult>;
+    /**
+     * Bring a deleted job back from the Trash: it reappears in every read and in
+     * every session it was in. A job that is not in the Trash succeeds too.
+     * OAuth apps need the `assets:write` scope.
+     */
+    restore(id: string): Promise<{
+        success: true;
+    }>;
 }
 
-export { type CancelJobResult, type CreditStatus, type CreditsHint, type DeleteJobResult, type InputRefusedHint, type Job, type JobErrorHint, type JobFromUploadParams, type JobRating, type JobRatingFilter, type JobSource, type JobStatus, type JobStatusResult, JobsResource, type ListJobsPage, type ListJobsParams, type PolicyBlockHint, type RateJobResult, type SafetyBlockHint };
+export { type CancelJobResult, type CreditStatus, type CreditsHint, type DeleteJobResult, type InputRefusedHint, type Job, type JobErrorHint, type JobFromUploadParams, type JobRating, type JobRatingFilter, type JobSessionRef, type JobSource, type JobStatus, type JobStatusResult, JobsResource, type ListJobsPage, type ListJobsParams, type PolicyBlockHint, type RateJobResult, type SafetyBlockHint };

package/dist/entries/jobs.d.ts

@@ -160,6 +160,17 @@ interface Job {
     /** The generation session this job was born in (the `sessionId` sent with
      *  the generation request), or null. See `client.sessions`. */
     session_id?: string | null;
+    /**
+     * With `list({ withSessions: true })`: every session that holds the job now,
+     * each linkable — empty when it is in no session (General). Absent otherwise.
+     */
+    sessions?: JobSessionRef[];
+    /**
+     * When the job was deleted, on a job read from the Trash
+     * (`client.trash.list()`). A deleted job is left out of every other read, so
+     * this is otherwise absent or `null`.
+     */
+    deleted_at?: string | null;
     /**
      * Whether the job's owner favorited it (`client.gallery.toggleFavorite`).
      * Returned by `get()` and `list()`. Absent from an older server, and when
@@ -191,6 +202,13 @@ type JobSource = "internal" | "mcp" | "app" | "cli" | "sdk" | "extension" | "web
 interface DeleteJobResult {
     success: true;
 }
+/** A session that holds a job now (`Job.sessions`). */
+interface JobSessionRef {
+    id: string;
+    title: string | null;
+    /** The session's project, or `null` when it has none. */
+    projectId: string | null;
+}
 interface ListJobsParams {
     /** One status or several (a job matching any of them). An unknown status is a 400. */
     status?: JobStatus | readonly JobStatus[];
@@ -208,6 +226,19 @@ interface ListJobsParams {
     rating?: JobRatingFilter;
     /** The jobs of one generate-image batch (`count` / `models`) — its `batchId`. */
     batchId?: string;
+    /**
+     * The jobs a session of this project holds now — or, `"none"`, a session
+     * with no project. Each job once, however many sessions hold it. Not with
+     * `inSession: false`.
+     */
+    projectId?: string | "none";
+    /**
+     * `false`: the jobs no session holds now (General), whatever session they
+     * were born in. `true`: the jobs at least one session holds.
+     */
+    inSession?: boolean;
+    /** `true`: each job carries `sessions`, the sessions that hold it now. */
+    withSessions?: boolean;
     /** Page size, 1–100 (server default 50). */
     limit?: number;
     /** The previous page's `next`. */
@@ -279,8 +310,11 @@ declare class JobsResource {
      * a client app lists its runs with `{ type: "llm-structured", origin: "studio" }`.
      * `status` and `type` take one value or a list; `favorited` and `rating`
      * filter on your own marks, `source` on the surface that created the job.
-     * Every filter combines with AND, and each job
-     * carries `favorited` and `rating`.
+     * `projectId` / `inSession` filter on where the job is now (a project's
+     * sessions, or General), and `withSessions` says which sessions each job is
+     * in — for "everything in this project". Every filter combines with AND,
+     * and each job carries `favorited` and `rating`. A deleted job is never
+     * listed: read the Trash with `client.trash.list()`.
      */
     list(params?: ListJobsParams): Promise<ListJobsPage>;
     /**
@@ -322,12 +356,27 @@ declare class JobsResource {
      */
     cancel(id: string): Promise<CancelJobResult>;
     /**
-     * Delete a job and the private media it produced. Server route is
-     * `DELETE /v1/jobs/:jobId`. Only the job's owner (or an admin) may delete it;
-     * a job that is still running is deleted as-is — cancel it first when its
-     * worker should stop ({@link cancel}).
+     * Delete a job: it goes to the Trash (`client.trash.list()`). It is left out
+     * of every read from then on, stays restorable for 30 days ({@link restore},
+     * back into the sessions it was in), and is then deleted for good, as a
+     * delete always was (a copy saved to the Library stays). `{ forever: true }` deletes a job already in the Trash for good now;
+     * on a live job it fails with a 409 `NodaroError` whose `code` is
+     * `"not_in_trash"`. Only the job's owner (or an admin) may delete it; a job
+     * that is still running keeps running — cancel it first when its worker
+     * should stop ({@link cancel}). Nothing is refunded. OAuth apps need the
+     * `assets:write` scope.
      */
-    delete(id: string): Promise<DeleteJobResult>;
+    delete(id: string, options?: {
+        forever?: boolean;
+    }): Promise<DeleteJobResult>;
+    /**
+     * Bring a deleted job back from the Trash: it reappears in every read and in
+     * every session it was in. A job that is not in the Trash succeeds too.
+     * OAuth apps need the `assets:write` scope.
+     */
+    restore(id: string): Promise<{
+        success: true;
+    }>;
 }
 
-export { type CancelJobResult, type CreditStatus, type CreditsHint, type DeleteJobResult, type InputRefusedHint, type Job, type JobErrorHint, type JobFromUploadParams, type JobRating, type JobRatingFilter, type JobSource, type JobStatus, type JobStatusResult, JobsResource, type ListJobsPage, type ListJobsParams, type PolicyBlockHint, type RateJobResult, type SafetyBlockHint };
+export { type CancelJobResult, type CreditStatus, type CreditsHint, type DeleteJobResult, type InputRefusedHint, type Job, type JobErrorHint, type JobFromUploadParams, type JobRating, type JobRatingFilter, type JobSessionRef, type JobSource, type JobStatus, type JobStatusResult, JobsResource, type ListJobsPage, type ListJobsParams, type PolicyBlockHint, type RateJobResult, type SafetyBlockHint };

package/dist/entries/jobs.js

@@ -1,4 +1,4 @@
 import '../chunk-I3TYBAOX.js';
-export { JobsResource } from '../chunk-6MQ2LTJZ.js';
+export { JobsResource } from '../chunk-PQHZUWSL.js';
 //# sourceMappingURL=jobs.js.map
 //# sourceMappingURL=jobs.js.map

package/dist/entries/locations.d.cts

@@ -1,7 +1,7 @@
 import { LocationAssetType, CharacterAspectRatio, LocationAttachColumn, SurroundDirection } from '@nodaro/shared/entities';
 export { LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, LocationAssetType, LocationAttachColumn, SURROUND_DIRECTIONS, SurroundDirection } from '@nodaro/shared/entities';
 import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
-import { l as GenerationSessionParams } from '../nodes-DzBGNOUV.cjs';
+import { l as GenerationSessionParams } from '../nodes-DGIefTze.cjs';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 import '@nodaro/shared/types';

package/dist/entries/locations.d.ts

@@ -1,7 +1,7 @@
 import { LocationAssetType, CharacterAspectRatio, LocationAttachColumn, SurroundDirection } from '@nodaro/shared/entities';
 export { LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, LocationAssetType, LocationAttachColumn, SURROUND_DIRECTIONS, SurroundDirection } from '@nodaro/shared/entities';
 import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
-import { l as GenerationSessionParams } from '../nodes-B4ZEqx2V.js';
+import { l as GenerationSessionParams } from '../nodes-C9j0PFto.js';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 import '@nodaro/shared/types';

package/dist/entries/media.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 require('../chunk-RHETJOUM.cjs');
-var chunkETX3TLNB_cjs = require('../chunk-ETX3TLNB.cjs');
+var chunk22P4X3N5_cjs = require('../chunk-22P4X3N5.cjs');
 require('../chunk-FRQJNGJS.cjs');
 require('../chunk-FM2KM5TY.cjs');
 
@@ -9,7 +9,7 @@ require('../chunk-FM2KM5TY.cjs');
 
 Object.defineProperty(exports, "MediaResource", {
   enumerable: true,
-  get: function () { return chunkETX3TLNB_cjs.MediaResource; }
+  get: function () { return chunk22P4X3N5_cjs.MediaResource; }
 });
 //# sourceMappingURL=media.cjs.map
 //# sourceMappingURL=media.cjs.map

package/dist/entries/media.d.cts

@@ -434,13 +434,16 @@ declare class MediaResource {
      * `height`, `frames`, `coverage` (the fraction of pixels selected, rounded
      * to 4 decimals) and `kept` (any region left on any frame: false only when
      * the size / zone filters left an empty mask — read it rather than
-     * `coverage`, which a few pixels round to 0). Feed the mask to
+     * `coverage`, which a few pixels round to 0), and `recipe` (the version of
+     * the masking algorithm that made it, `VIDEO_MASK_RECIPE`: it changes
+     * whenever the same clip and settings would give a different mask). Feed the mask to
      * {@link MediaResource.maskComposite}.
      *
      * `holdLastMask: true` keeps the last mask on frames where the subject is
      * lost (a mask covering under 0.002 % of the frame, e.g. a face behind a
      * hand): each such frame after the first detection repeats the most recent
-     * non-empty one; the output then also carries `heldFrames`.
+     * non-empty one, for at most 1 s of frames (`VIDEO_MASK_LIMITS.HOLD_MAX_SEC`;
+     * longer gaps stay empty after that); the output then also carries `heldFrames`.
      * `minSubjectHeightPct` (0–100, default 0 = off) drops every connected
      * region whose bounding box is shorter than that % of the frame height
      * (extras' small faces behind the main subject); it runs before
@@ -456,7 +459,15 @@ declare class MediaResource {
      * detected again after every cut, `holdLastMask` never crosses a cut, and
      * each shot's mask is fitted to that shot's exact frame count; on a clip
      * with no cut it gives the same mask, fitted to the clip's exact frame
-     * count. The output carries `shots` (1 when off).
+     * count. The output carries `shots` (1 when off). `redetectEverySec` (0 =
+     * off, the default, or 1–10) also detects the subject again every that
+     * many seconds — the clip (each shot, with `perShot`) is sent to the model
+     * in pieces of at most that length, a last piece under 8 frames joining the
+     * one before — so someone who walks in or turns to the camera mid-shot is
+     * masked from the next boundary on. These boundaries are not cuts:
+     * `holdLastMask` holds across them. Each piece is one more model request
+     * (three run at a time), so it is slower; the price does not change. The
+     * output's `chunks` counts the requests.
      */
     videoMask(input: VideoMaskRequest): Promise<{
         jobId: string;

package/dist/entries/media.d.ts

@@ -434,13 +434,16 @@ declare class MediaResource {
      * `height`, `frames`, `coverage` (the fraction of pixels selected, rounded
      * to 4 decimals) and `kept` (any region left on any frame: false only when
      * the size / zone filters left an empty mask — read it rather than
-     * `coverage`, which a few pixels round to 0). Feed the mask to
+     * `coverage`, which a few pixels round to 0), and `recipe` (the version of
+     * the masking algorithm that made it, `VIDEO_MASK_RECIPE`: it changes
+     * whenever the same clip and settings would give a different mask). Feed the mask to
      * {@link MediaResource.maskComposite}.
      *
      * `holdLastMask: true` keeps the last mask on frames where the subject is
      * lost (a mask covering under 0.002 % of the frame, e.g. a face behind a
      * hand): each such frame after the first detection repeats the most recent
-     * non-empty one; the output then also carries `heldFrames`.
+     * non-empty one, for at most 1 s of frames (`VIDEO_MASK_LIMITS.HOLD_MAX_SEC`;
+     * longer gaps stay empty after that); the output then also carries `heldFrames`.
      * `minSubjectHeightPct` (0–100, default 0 = off) drops every connected
      * region whose bounding box is shorter than that % of the frame height
      * (extras' small faces behind the main subject); it runs before
@@ -456,7 +459,15 @@ declare class MediaResource {
      * detected again after every cut, `holdLastMask` never crosses a cut, and
      * each shot's mask is fitted to that shot's exact frame count; on a clip
      * with no cut it gives the same mask, fitted to the clip's exact frame
-     * count. The output carries `shots` (1 when off).
+     * count. The output carries `shots` (1 when off). `redetectEverySec` (0 =
+     * off, the default, or 1–10) also detects the subject again every that
+     * many seconds — the clip (each shot, with `perShot`) is sent to the model
+     * in pieces of at most that length, a last piece under 8 frames joining the
+     * one before — so someone who walks in or turns to the camera mid-shot is
+     * masked from the next boundary on. These boundaries are not cuts:
+     * `holdLastMask` holds across them. Each piece is one more model request
+     * (three run at a time), so it is slower; the price does not change. The
+     * output's `chunks` counts the requests.
      */
     videoMask(input: VideoMaskRequest): Promise<{
         jobId: string;

package/dist/entries/media.js

@@ -1,5 +1,5 @@
 import '../chunk-ES2E65HT.js';
-export { MediaResource } from '../chunk-DQAYIVVS.js';
+export { MediaResource } from '../chunk-BQAW4RX2.js';
 import '../chunk-7CUWAVWB.js';
 import '../chunk-L6T44A3G.js';
 //# sourceMappingURL=media.js.map

package/dist/entries/nodes.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 var chunk7CK6I4CT_cjs = require('../chunk-7CK6I4CT.cjs');
-var chunk2VJOHJUZ_cjs = require('../chunk-2VJOHJUZ.cjs');
+var chunkTK2CEVSK_cjs = require('../chunk-TK2CEVSK.cjs');
 require('../chunk-FM2KM5TY.cjs');
 
 
@@ -16,7 +16,7 @@ Object.defineProperty(exports, "PROMPT_SUFFIX_KEY", {
 });
 Object.defineProperty(exports, "NodesResource", {
   enumerable: true,
-  get: function () { return chunk2VJOHJUZ_cjs.NodesResource; }
+  get: function () { return chunkTK2CEVSK_cjs.NodesResource; }
 });
 //# sourceMappingURL=nodes.cjs.map
 //# sourceMappingURL=nodes.cjs.map