@nodaro/sdk 2.53.1 → 2.55.0

package/dist/entries/keepers.d.cts

@@ -0,0 +1,100 @@
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.cjs';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+/**
+ * Nodaro Keepers — the shared catalog of characters, creatures, locations and
+ * objects (`/v1/keepers/catalog`). An admin puts some of their own items on
+ * the shelf; everyone browses it (the read takes no credential — a guest
+ * sees it too); using one copies it into the caller's own account as a row
+ * of their own, editable in Studio. The original is never changed, a later
+ * change to it does not reach the copies, and taking it off the shelf
+ * removes no copy. No credits for reading or copying.
+ */
+declare const KEEPER_KINDS: readonly ["character", "creature", "location", "object"];
+type KeeperKind = (typeof KEEPER_KINDS)[number];
+/** One item on the shelf — display fields only. */
+interface KeeperCatalogItem {
+    id: string;
+    kind: KeeperKind;
+    name: string;
+    description: string | null;
+    /** The main image, as stored. */
+    imageUrl: string;
+    /** A 480px-wide copy of it for a tile (the image itself where the CDN does not resize). */
+    previewUrl: string;
+    /** The shelf heading the admin filed it under, if any. */
+    category: string | null;
+    /** The shelf order, lowest first. */
+    sort: number;
+    createdAt: string;
+}
+interface KeeperCatalogParams {
+    /** One kind only; omitted, the page runs through the kinds in `KEEPER_KINDS` order. */
+    kind?: KeeperKind;
+    /** A previous page's `next`. */
+    cursor?: string;
+    /** 1–200, default 50. */
+    limit?: number;
+}
+interface KeeperCatalogPage {
+    data: KeeperCatalogItem[];
+    /** The next page's cursor, or null on the last page. */
+    next: string | null;
+}
+/** The caller's own copy of a shelf item. */
+interface CopyKeeperResult {
+    /** The id of the caller's row — `client.characters.get(id)` and the others read it. */
+    id: string;
+    name: string;
+    kind: KeeperKind;
+    /** `false` when the caller already had a copy of this item: that copy is returned, no second one is made. */
+    created: boolean;
+}
+/** `client.<kind>.setCatalog(id, input)` — admin only, on the admin's own rows. */
+interface SetKeeperCatalogInput {
+    /** On the shelf, or not. */
+    catalog: boolean;
+    /** The shelf order, lowest first (default 0). */
+    sort?: number;
+    /** A shelf heading; `null` clears it. */
+    category?: string | null;
+}
+interface SetKeeperCatalogResult {
+    id: string;
+    kind: KeeperKind;
+    catalog: boolean;
+    sort: number;
+    category: string | null;
+}
+declare class KeepersResource {
+    private readonly client;
+    constructor(client: NodaroClientCore);
+    /**
+     * One page of the shelf. Public data: the same for every caller.
+     *
+     * ```ts
+     * const { data, next } = await client.keepers.catalog({ kind: "character" })
+     * ```
+     */
+    catalog(params?: KeeperCatalogParams): Promise<KeeperCatalogPage>;
+    /**
+     * Use a shelf item: a copy of it in the caller's account — their own row,
+     * made like a community clone: the public text, the main image and the
+     * variant assets (every file copied into the caller's own storage and
+     * counted against it), a custom voice reduced to its name and sample,
+     * editable in Studio. Calling again returns the same copy
+     * (`created: false`). No credits. A 413 `storage_limit_exceeded` when the
+     * files do not fit the caller's storage; `ForbiddenError`
+     * `personal_space_disabled` when their organization closed the personal
+     * space.
+     *
+     * ```ts
+     * const { id } = await client.keepers.copy("character", item.id)
+     * const mine = await client.characters.get(id)
+     * ```
+     */
+    copy(kind: KeeperKind, id: string): Promise<CopyKeeperResult>;
+}
+
+export { type CopyKeeperResult, KEEPER_KINDS, type KeeperCatalogItem, type KeeperCatalogPage, type KeeperCatalogParams, type KeeperKind, KeepersResource, type SetKeeperCatalogInput, type SetKeeperCatalogResult };

package/dist/entries/keepers.d.ts

@@ -0,0 +1,100 @@
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.js';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+/**
+ * Nodaro Keepers — the shared catalog of characters, creatures, locations and
+ * objects (`/v1/keepers/catalog`). An admin puts some of their own items on
+ * the shelf; everyone browses it (the read takes no credential — a guest
+ * sees it too); using one copies it into the caller's own account as a row
+ * of their own, editable in Studio. The original is never changed, a later
+ * change to it does not reach the copies, and taking it off the shelf
+ * removes no copy. No credits for reading or copying.
+ */
+declare const KEEPER_KINDS: readonly ["character", "creature", "location", "object"];
+type KeeperKind = (typeof KEEPER_KINDS)[number];
+/** One item on the shelf — display fields only. */
+interface KeeperCatalogItem {
+    id: string;
+    kind: KeeperKind;
+    name: string;
+    description: string | null;
+    /** The main image, as stored. */
+    imageUrl: string;
+    /** A 480px-wide copy of it for a tile (the image itself where the CDN does not resize). */
+    previewUrl: string;
+    /** The shelf heading the admin filed it under, if any. */
+    category: string | null;
+    /** The shelf order, lowest first. */
+    sort: number;
+    createdAt: string;
+}
+interface KeeperCatalogParams {
+    /** One kind only; omitted, the page runs through the kinds in `KEEPER_KINDS` order. */
+    kind?: KeeperKind;
+    /** A previous page's `next`. */
+    cursor?: string;
+    /** 1–200, default 50. */
+    limit?: number;
+}
+interface KeeperCatalogPage {
+    data: KeeperCatalogItem[];
+    /** The next page's cursor, or null on the last page. */
+    next: string | null;
+}
+/** The caller's own copy of a shelf item. */
+interface CopyKeeperResult {
+    /** The id of the caller's row — `client.characters.get(id)` and the others read it. */
+    id: string;
+    name: string;
+    kind: KeeperKind;
+    /** `false` when the caller already had a copy of this item: that copy is returned, no second one is made. */
+    created: boolean;
+}
+/** `client.<kind>.setCatalog(id, input)` — admin only, on the admin's own rows. */
+interface SetKeeperCatalogInput {
+    /** On the shelf, or not. */
+    catalog: boolean;
+    /** The shelf order, lowest first (default 0). */
+    sort?: number;
+    /** A shelf heading; `null` clears it. */
+    category?: string | null;
+}
+interface SetKeeperCatalogResult {
+    id: string;
+    kind: KeeperKind;
+    catalog: boolean;
+    sort: number;
+    category: string | null;
+}
+declare class KeepersResource {
+    private readonly client;
+    constructor(client: NodaroClientCore);
+    /**
+     * One page of the shelf. Public data: the same for every caller.
+     *
+     * ```ts
+     * const { data, next } = await client.keepers.catalog({ kind: "character" })
+     * ```
+     */
+    catalog(params?: KeeperCatalogParams): Promise<KeeperCatalogPage>;
+    /**
+     * Use a shelf item: a copy of it in the caller's account — their own row,
+     * made like a community clone: the public text, the main image and the
+     * variant assets (every file copied into the caller's own storage and
+     * counted against it), a custom voice reduced to its name and sample,
+     * editable in Studio. Calling again returns the same copy
+     * (`created: false`). No credits. A 413 `storage_limit_exceeded` when the
+     * files do not fit the caller's storage; `ForbiddenError`
+     * `personal_space_disabled` when their organization closed the personal
+     * space.
+     *
+     * ```ts
+     * const { id } = await client.keepers.copy("character", item.id)
+     * const mine = await client.characters.get(id)
+     * ```
+     */
+    copy(kind: KeeperKind, id: string): Promise<CopyKeeperResult>;
+}
+
+export { type CopyKeeperResult, KEEPER_KINDS, type KeeperCatalogItem, type KeeperCatalogPage, type KeeperCatalogParams, type KeeperKind, KeepersResource, type SetKeeperCatalogInput, type SetKeeperCatalogResult };

package/dist/entries/keepers.js

@@ -0,0 +1,4 @@
+import '../chunk-BEQCU7YJ.js';
+export { KEEPER_KINDS, KeepersResource } from '../chunk-MQWZFWHE.js';
+//# sourceMappingURL=keepers.js.map
+//# sourceMappingURL=keepers.js.map

package/dist/entries/keepers.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"keepers.js"}

package/dist/entries/library.d.cts

@@ -1,4 +1,4 @@
-import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.cjs';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 

package/dist/entries/library.d.ts

@@ -1,4 +1,4 @@
-import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.js';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 

package/dist/entries/llm.d.cts

@@ -1,4 +1,4 @@
-import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.cjs';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 

package/dist/entries/llm.d.ts

@@ -1,4 +1,4 @@
-import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.js';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 

package/dist/entries/locations.cjs

@@ -1,25 +1,25 @@
 'use strict';
 
 require('../chunk-YXBZRB5H.cjs');
-var chunkMQ74AKA2_cjs = require('../chunk-MQ74AKA2.cjs');
+var chunkMIXRL6I2_cjs = require('../chunk-MIXRL6I2.cjs');
 
 
 
 Object.defineProperty(exports, "LOCATION_ASSET_TYPES", {
   enumerable: true,
-  get: function () { return chunkMQ74AKA2_cjs.LOCATION_ASSET_TYPES; }
+  get: function () { return chunkMIXRL6I2_cjs.LOCATION_ASSET_TYPES; }
 });
 Object.defineProperty(exports, "LOCATION_ATTACH_COLUMNS", {
   enumerable: true,
-  get: function () { return chunkMQ74AKA2_cjs.LOCATION_ATTACH_COLUMNS; }
+  get: function () { return chunkMIXRL6I2_cjs.LOCATION_ATTACH_COLUMNS; }
 });
 Object.defineProperty(exports, "LocationsResource", {
   enumerable: true,
-  get: function () { return chunkMQ74AKA2_cjs.LocationsResource; }
+  get: function () { return chunkMIXRL6I2_cjs.LocationsResource; }
 });
 Object.defineProperty(exports, "SURROUND_DIRECTIONS", {
   enumerable: true,
-  get: function () { return chunkMQ74AKA2_cjs.SURROUND_DIRECTIONS; }
+  get: function () { return chunkMIXRL6I2_cjs.SURROUND_DIRECTIONS; }
 });
 //# sourceMappingURL=locations.cjs.map
 //# sourceMappingURL=locations.cjs.map

package/dist/entries/locations.d.cts

@@ -1,7 +1,8 @@
 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-DGIefTze.cjs';
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.cjs';
+import { SetKeeperCatalogInput, SetKeeperCatalogResult } from './keepers.cjs';
+import { l as GenerationSessionParams } from '../nodes-Ceetyyh0.cjs';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 import '@nodaro/shared/types';
@@ -14,7 +15,7 @@ import '@nodaro/shared/scene3d';
 import '@nodaro/shared/credits';
 import './jobs.cjs';
 import './errors.cjs';
-import '../studio-productions-r2-VZsKj.cjs';
+import '../studio-productions-CMiS827q.cjs';
 import '@nodaro/shared/model-catalog';
 import '@nodaro/prompts/prompt-builder';
 
@@ -118,6 +119,14 @@ interface Location {
      *  NOT normalized; soft-capped server-side at 200 keys / 2048-char values
      *  (overflow dropped silently). Defaults to `{}`. */
     selectedAssetByVariant?: Record<string, string> | null;
+    /** Nodaro Keepers: whether this row is on the shared shelf (`client.keepers`).
+     *  Admin-set through `setCatalog`; `false` on everyone else's rows and on
+     *  every copy. Optional on the read surface for older servers. */
+    catalog?: boolean;
+    /** The shelf order (lowest first); `0` when never set. */
+    catalogSort?: number;
+    /** The shelf heading, or `null`. */
+    catalogCategory?: string | null;
     deletedAt: string | null;
     createdAt: string;
     updatedAt: string;
@@ -493,6 +502,13 @@ declare class LocationsResource {
         id: string;
         name: string;
     }>;
+    /**
+     * Admin only: put one of your own locations on the shared Nodaro Keepers
+     * shelf (`client.keepers.catalog()`), or take it off. A first-party session
+     * or your personal token; `forbidden` for anyone who is not a platform
+     * admin, `not_found` for a row that is not yours.
+     */
+    setCatalog(id: string, input: SetKeeperCatalogInput): Promise<SetKeeperCatalogResult>;
     /**
      * Fire `POST /v1/generate-location` to produce one or more candidate main
      * images. With `count > 1`, all jobs are reserved up-front before any

package/dist/entries/locations.d.ts

@@ -1,7 +1,8 @@
 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-C9j0PFto.js';
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.js';
+import { SetKeeperCatalogInput, SetKeeperCatalogResult } from './keepers.js';
+import { l as GenerationSessionParams } from '../nodes-B74WaY9r.js';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 import '@nodaro/shared/types';
@@ -14,7 +15,7 @@ import '@nodaro/shared/scene3d';
 import '@nodaro/shared/credits';
 import './jobs.js';
 import './errors.js';
-import '../studio-productions-DtTE8mdl.js';
+import '../studio-productions-DkI51Z9M.js';
 import '@nodaro/shared/model-catalog';
 import '@nodaro/prompts/prompt-builder';
 
@@ -118,6 +119,14 @@ interface Location {
      *  NOT normalized; soft-capped server-side at 200 keys / 2048-char values
      *  (overflow dropped silently). Defaults to `{}`. */
     selectedAssetByVariant?: Record<string, string> | null;
+    /** Nodaro Keepers: whether this row is on the shared shelf (`client.keepers`).
+     *  Admin-set through `setCatalog`; `false` on everyone else's rows and on
+     *  every copy. Optional on the read surface for older servers. */
+    catalog?: boolean;
+    /** The shelf order (lowest first); `0` when never set. */
+    catalogSort?: number;
+    /** The shelf heading, or `null`. */
+    catalogCategory?: string | null;
     deletedAt: string | null;
     createdAt: string;
     updatedAt: string;
@@ -493,6 +502,13 @@ declare class LocationsResource {
         id: string;
         name: string;
     }>;
+    /**
+     * Admin only: put one of your own locations on the shared Nodaro Keepers
+     * shelf (`client.keepers.catalog()`), or take it off. A first-party session
+     * or your personal token; `forbidden` for anyone who is not a platform
+     * admin, `not_found` for a row that is not yours.
+     */
+    setCatalog(id: string, input: SetKeeperCatalogInput): Promise<SetKeeperCatalogResult>;
     /**
      * Fire `POST /v1/generate-location` to produce one or more candidate main
      * images. With `count > 1`, all jobs are reserved up-front before any

package/dist/entries/locations.js

@@ -1,4 +1,4 @@
 import '../chunk-HFBR6G36.js';
-export { LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, LocationsResource, SURROUND_DIRECTIONS } from '../chunk-TVENC6PH.js';
+export { LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, LocationsResource, SURROUND_DIRECTIONS } from '../chunk-XZPSJG2X.js';
 //# sourceMappingURL=locations.js.map
 //# sourceMappingURL=locations.js.map

package/dist/entries/media.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 require('../chunk-RHETJOUM.cjs');
-var chunk22P4X3N5_cjs = require('../chunk-22P4X3N5.cjs');
+var chunkXALPYUZI_cjs = require('../chunk-XALPYUZI.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 chunk22P4X3N5_cjs.MediaResource; }
+  get: function () { return chunkXALPYUZI_cjs.MediaResource; }
 });
 //# sourceMappingURL=media.cjs.map
 //# sourceMappingURL=media.cjs.map

package/dist/entries/media.d.cts

@@ -1,4 +1,4 @@
-import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.cjs';
 import { OverlayAnchor, VideoMaskRequest, MaskCompositeRequest } from '@nodaro/shared/media';
 import { CaptionLookId, SupportedFontName, CaptionStyle } from '@nodaro/shared/captions';
 import { TranscribeLane } from '@nodaro/shared/models';
@@ -110,13 +110,16 @@ declare class MediaResource {
      * `requireAudio: false` to accept a clip that really has no sound. Returns a
      * `downloadId`; progress streams from
      * `GET /v1/download-video/progress/:downloadId` (server-sent events) and the
-     * finished file lands in your library.
+     * finished file lands in your library. A section is fetched with ±3 s of
+     * padding for the caller to trim; `exactSection: true` cuts it exactly at
+     * `sectionStartSec`–`sectionEndSec` instead.
      */
     downloadVideo(input: {
         url: string;
         maxHeight?: number;
         sectionStartSec?: number;
         sectionEndSec?: number;
+        exactSection?: boolean;
         requireAudio?: boolean;
     }): Promise<{
         downloadId: string;
@@ -508,11 +511,32 @@ declare class MediaResource {
      * free, the source-preparation sibling of the priced `trimVideo` node.
      * `trim` is `[startTime, endTime]` in seconds; `deleteSource: true` removes
      * the source object afterwards when it is yours and nothing else references
-     * it ("the cut replaces the original"). Answers the stored file.
+     * it ("the cut replaces the original"). Answers the stored file. The
+     * platform may take up to 300 s on a long file: pass `timeoutMs` to wait
+     * longer than the client's default.
      */
-    process(input: MediaProcessInput): Promise<{
+    process(input: MediaProcessInput, options?: {
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<{
         data: MediaProcessResult;
     }>;
+    /**
+     * Throw away a file you just made and no longer need (`POST /v1/media/discard`):
+     * a link download replaced before use, a cut superseded by a newer one, a
+     * picture imported then cancelled. Not a general delete. The file goes only
+     * when it is your own, was made by a link download (`downloadVideo`), a cut
+     * (`process`) or a URL import, is under 24 hours old, and no job of yours
+     * uses it (as an output or as an input such as a run's `videoUrl`);
+     * otherwise it is left untouched and the call fails with 409
+     * `not_discardable`. `discarded: false` means there was nothing of yours at
+     * that address (already gone, or not yours).
+     */
+    discard(input: {
+        url: string;
+    }): Promise<{
+        data: MediaDiscardResult;
+    }>;
 }
 /**
  * One event from {@link MediaResource.downloadVideoProgress}. The stream ends
@@ -581,6 +605,11 @@ interface MediaProcessInput {
     format?: "mp4" | "webm" | "mp3" | "wav" | "m4a" | "aac";
     deleteSource?: boolean;
 }
+/** Result of {@link MediaResource.discard}. */
+interface MediaDiscardResult {
+    /** True when the file was deleted; false when there was nothing of yours at that address. */
+    discarded: boolean;
+}
 interface MediaProcessResult {
     url: string;
     thumbnailUrl: string | null;
@@ -590,4 +619,4 @@ interface MediaProcessResult {
     metadata: Record<string, unknown>;
 }
 
-export { type AddCaptionsInput, type CaptionEntry, type CaptionLookInput, type CaptionSegmentInput, type DownloadVideoProgress, type MediaProcessInput, type MediaProcessResult, MediaResource, type OverlayPlacement, type SplitMediaInput, type SplitMediaOutput, type VideoMetadata };
+export { type AddCaptionsInput, type CaptionEntry, type CaptionLookInput, type CaptionSegmentInput, type DownloadVideoProgress, type MediaDiscardResult, type MediaProcessInput, type MediaProcessResult, MediaResource, type OverlayPlacement, type SplitMediaInput, type SplitMediaOutput, type VideoMetadata };

package/dist/entries/media.d.ts

@@ -1,4 +1,4 @@
-import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.js';
 import { OverlayAnchor, VideoMaskRequest, MaskCompositeRequest } from '@nodaro/shared/media';
 import { CaptionLookId, SupportedFontName, CaptionStyle } from '@nodaro/shared/captions';
 import { TranscribeLane } from '@nodaro/shared/models';
@@ -110,13 +110,16 @@ declare class MediaResource {
      * `requireAudio: false` to accept a clip that really has no sound. Returns a
      * `downloadId`; progress streams from
      * `GET /v1/download-video/progress/:downloadId` (server-sent events) and the
-     * finished file lands in your library.
+     * finished file lands in your library. A section is fetched with ±3 s of
+     * padding for the caller to trim; `exactSection: true` cuts it exactly at
+     * `sectionStartSec`–`sectionEndSec` instead.
      */
     downloadVideo(input: {
         url: string;
         maxHeight?: number;
         sectionStartSec?: number;
         sectionEndSec?: number;
+        exactSection?: boolean;
         requireAudio?: boolean;
     }): Promise<{
         downloadId: string;
@@ -508,11 +511,32 @@ declare class MediaResource {
      * free, the source-preparation sibling of the priced `trimVideo` node.
      * `trim` is `[startTime, endTime]` in seconds; `deleteSource: true` removes
      * the source object afterwards when it is yours and nothing else references
-     * it ("the cut replaces the original"). Answers the stored file.
+     * it ("the cut replaces the original"). Answers the stored file. The
+     * platform may take up to 300 s on a long file: pass `timeoutMs` to wait
+     * longer than the client's default.
      */
-    process(input: MediaProcessInput): Promise<{
+    process(input: MediaProcessInput, options?: {
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<{
         data: MediaProcessResult;
     }>;
+    /**
+     * Throw away a file you just made and no longer need (`POST /v1/media/discard`):
+     * a link download replaced before use, a cut superseded by a newer one, a
+     * picture imported then cancelled. Not a general delete. The file goes only
+     * when it is your own, was made by a link download (`downloadVideo`), a cut
+     * (`process`) or a URL import, is under 24 hours old, and no job of yours
+     * uses it (as an output or as an input such as a run's `videoUrl`);
+     * otherwise it is left untouched and the call fails with 409
+     * `not_discardable`. `discarded: false` means there was nothing of yours at
+     * that address (already gone, or not yours).
+     */
+    discard(input: {
+        url: string;
+    }): Promise<{
+        data: MediaDiscardResult;
+    }>;
 }
 /**
  * One event from {@link MediaResource.downloadVideoProgress}. The stream ends
@@ -581,6 +605,11 @@ interface MediaProcessInput {
     format?: "mp4" | "webm" | "mp3" | "wav" | "m4a" | "aac";
     deleteSource?: boolean;
 }
+/** Result of {@link MediaResource.discard}. */
+interface MediaDiscardResult {
+    /** True when the file was deleted; false when there was nothing of yours at that address. */
+    discarded: boolean;
+}
 interface MediaProcessResult {
     url: string;
     thumbnailUrl: string | null;
@@ -590,4 +619,4 @@ interface MediaProcessResult {
     metadata: Record<string, unknown>;
 }
 
-export { type AddCaptionsInput, type CaptionEntry, type CaptionLookInput, type CaptionSegmentInput, type DownloadVideoProgress, type MediaProcessInput, type MediaProcessResult, MediaResource, type OverlayPlacement, type SplitMediaInput, type SplitMediaOutput, type VideoMetadata };
+export { type AddCaptionsInput, type CaptionEntry, type CaptionLookInput, type CaptionSegmentInput, type DownloadVideoProgress, type MediaDiscardResult, type MediaProcessInput, type MediaProcessResult, MediaResource, type OverlayPlacement, type SplitMediaInput, type SplitMediaOutput, type VideoMetadata };

package/dist/entries/media.js

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

package/dist/entries/models.d.cts

@@ -1,4 +1,4 @@
-import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.cjs';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 

package/dist/entries/models.d.ts

@@ -1,4 +1,4 @@
-import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.js';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 

package/dist/entries/moodboards.d.cts

@@ -1,4 +1,4 @@
-import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.cjs';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 

package/dist/entries/moodboards.d.ts

@@ -1,4 +1,4 @@
-import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.js';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 

package/dist/entries/node-presets.d.cts

@@ -1,4 +1,4 @@
-import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.cjs';
 import { FactoryPreset } from '@nodaro/prompts/presets';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';

package/dist/entries/node-presets.d.ts

@@ -1,4 +1,4 @@
-import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.js';
 import { FactoryPreset } from '@nodaro/prompts/presets';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';

package/dist/entries/nodes.cjs

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

package/dist/entries/nodes.d.cts

@@ -4,15 +4,15 @@ export { GeminiOmniVoicePresetId, ImageAspectRatio, ImageEditProvider, ImageEdit
 export { PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY, PromptAffixFields } from '@nodaro/shared/nodes';
 export { SocialPlatform, SocialPost, SocialPostAuthor, SocialPostMedia, SocialPostMetrics, SocialSearchCount, SocialSearchMode, SocialSearchParams, SocialSearchPeriod, SocialSearchSort, SocialSearchVideoKind } from '@nodaro/shared/social';
 export { GenerateMaskOutput, GenerateMaskRequest, VideoDepthColormap, VideoDepthModelSize, VideoDepthProvider, VideoDepthResolution } from '@nodaro/shared/media';
-export { A as AssembleNarratedVideoParams, B as BatchJobOutcome, E as EditImageCommonParams, a as EditImageFromTaskParams, b as EditImageFromUrlParams, c as EditImageParams, G as GenerateImageBatchGroup, e as GenerateImageBatchOutput, f as GenerateImageBatchResult, g as GenerateImageParams, h as GenerateMaskJobOutput, i as GenerateMaskParams, k as GenerateVideoParams, l as GenerationSessionParams, I as ImageJobStarted, m as ImageToImageParams, J as JobOutputImage, N as NodeCategory, n as NodeCreditRate, o as NodeDescriptor, p as NodeInputField, q as NodeInputSchema, r as NodeJobOutput, s as NodeQuote, t as NodesResource, O as OutputType, Q as QuoteAdjustment, y as QuoteWarning, R as ReferenceCaptionParams, F as RunAndWaitOptions, H as RunManyResult, K as RunNodeAdjustment, L as RunNodeOptions, M as RunNodeResult, S as RunNodeWarning, _ as SocialSearchJobOutput, $ as SplitImageParams, a0 as SplitImageResult, a1 as SplitImageTile, a2 as StructuredReferenceParams, a3 as Subject, a4 as TextToSpeechParams, a5 as TextToVideoParams, a6 as VideoDepthParams, a7 as VideoToVideoParams, a8 as VideoUpscaleParams } from '../nodes-DGIefTze.cjs';
+export { A as AssembleNarratedVideoParams, B as BatchJobOutcome, E as EditImageCommonParams, a as EditImageFromTaskParams, b as EditImageFromUrlParams, c as EditImageParams, G as GenerateImageBatchGroup, e as GenerateImageBatchOutput, f as GenerateImageBatchResult, g as GenerateImageParams, h as GenerateMaskJobOutput, i as GenerateMaskParams, k as GenerateVideoParams, l as GenerationSessionParams, I as ImageJobStarted, m as ImageToImageParams, J as JobOutputImage, N as NodeCategory, n as NodeCreditRate, o as NodeDescriptor, p as NodeInputField, q as NodeInputSchema, r as NodeJobOutput, s as NodeQuote, t as NodesResource, O as OutputType, Q as QuoteAdjustment, y as QuoteWarning, R as ReferenceCaptionParams, F as RunAndWaitOptions, H as RunManyResult, K as RunNodeAdjustment, L as RunNodeOptions, M as RunNodeResult, S as RunNodeWarning, _ as SocialSearchJobOutput, $ as SplitImageParams, a0 as SplitImageResult, a1 as SplitImageTile, a2 as StructuredReferenceParams, a3 as Subject, a4 as TextToSpeechParams, a5 as TextToVideoParams, a6 as VideoDepthParams, a7 as VideoToVideoParams, a8 as VideoUpscaleParams } from '../nodes-Ceetyyh0.cjs';
 export { TopazUpscaleFactor } from '@nodaro/shared/credits';
 export { ImageToImageAttachColumn } from '@nodaro/shared/entities';
 import '@nodaro/shared/scene3d';
-import '../developer-apps-zSQXWmEG.cjs';
+import '../developer-apps-CMUzKpE9.cjs';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 import './jobs.cjs';
 import './errors.cjs';
-import '../studio-productions-r2-VZsKj.cjs';
+import '../studio-productions-CMiS827q.cjs';
 import '@nodaro/shared/model-catalog';
 import '@nodaro/prompts/prompt-builder';