@nebula-ai/sdk 1.5.0 → 1.6.1

package/dist/index.d.ts

@@ -31,6 +31,10 @@ interface RequestArgs {
   idempotent?: boolean;
   signal?: AbortSignal;
 }
+/** Per-call options every generated resource method accepts. */
+interface RequestOptions {
+  signal?: AbortSignal;
+}
 declare class NebulaCore {
   readonly baseUrl: string;
   readonly apiKey?: string;
@@ -120,8 +124,8 @@ interface components {
      * ActivatedProcedure
      * @description A procedure-like memory activated during memory traversal.
      *
-     *     This includes preference procedures, atomic traces, and trace-derived
-     *     strategies. Distinct from facts which are descriptive assertions.
+     *     This includes preference procedures and atomic traces. Distinct from facts
+     *     which are descriptive assertions.
      */
     ActivatedProcedure: {
       /**
@@ -154,8 +158,11 @@ interface components {
       is_negated?: boolean; /** Metadata */
       metadata?: {
         [key: string]: unknown;
-      } | null; /** Statement */
-      statement: string;
+      } | null; /** Stability Confidence */
+      stability_confidence?: number | null; /** Statement */
+      statement: string; /** Truth Confidence */
+      truth_confidence?: number | null; /** Use Confidence */
+      use_confidence?: number | null;
     };
     /**
      * ActivatedSemantic
@@ -515,7 +522,8 @@ interface components {
        */
       preview_query_limit?: number | null; /** Purchase Price Usd */
       purchase_price_usd?: string | null; /** Rental Price Monthly Usd */
-      rental_price_monthly_usd?: string | null;
+      rental_price_monthly_usd?: string | null; /** Storage Target Id */
+      storage_target_id?: string | null;
       /**
        * Updated At
        * Format: date-time
@@ -679,11 +687,20 @@ interface components {
     CreateCollectionRequest: {
       /** Description */description?: string | null; /** Name */
       name: string;
+      /**
+       * Storage Target Id
+       * @description BYOC storage target to host this collection's graph data. Requires a team workspace and an active target provisioned through the dashboard or workspace storage-target APIs.
+       */
+      storage_target_id?: string | null;
       /**
        * Workflows Enabled
        * @default false
        */
-      workflows_enabled?: boolean; /** Workspace Id */
+      workflows_enabled?: boolean;
+      /**
+       * Workspace Id
+       * @description Workspace this collection belongs to. Provisioned via the dashboard / management API, not minted through the public SDK.
+       */
       workspace_id?: string | null;
     };
     /**
@@ -755,7 +772,8 @@ interface components {
        * @description Raw text content for document kind
        */
       raw_text?: string | null; /** @description Device-memory snapshot (mutually exclusive with collection_id). */
-      snapshot?: components["schemas"]["SnapshotEnvelope-Input"] | null;
+      snapshot?: components["schemas"]["SnapshotEnvelope-Input"] | null; /** @description Device-memory snapshot reference for customer-owned object storage. Mutually exclusive with collection_id and snapshot. */
+      snapshot_ref?: components["schemas"]["SnapshotObjectReference"] | null;
       /**
        * Speaker Id
        * @description UUID of the SourceRole entity creating this memory
@@ -1397,7 +1415,8 @@ interface components {
        */
       query?: string | null; /** @description Advanced search settings. */
       search_settings?: components["schemas"]["SearchSettings"] | null; /** @description Device-memory snapshot for stateless search. */
-      snapshot?: components["schemas"]["SnapshotEnvelope-Input"] | null;
+      snapshot?: components["schemas"]["SnapshotEnvelope-Input"] | null; /** @description Device-memory snapshot reference for stateless search. */
+      snapshot_ref?: components["schemas"]["SnapshotObjectReference"] | null;
     };
     /**
      * Message
@@ -1770,9 +1789,11 @@ interface components {
        * Format: uuid
        */
       collection_id: string;
+      destination?: components["schemas"]["SnapshotObjectReference"] | null;
     }; /** SnapshotImportRequest */
     SnapshotImportRequest: {
-      snapshot: components["schemas"]["SnapshotEnvelope-Input"];
+      snapshot?: components["schemas"]["SnapshotEnvelope-Input"] | null;
+      snapshot_ref?: components["schemas"]["SnapshotObjectReference"] | null;
     };
     /**
      * SnapshotImportResult
@@ -1790,7 +1811,42 @@ interface components {
      * @description Updated snapshot returned by snapshot-mode memory writes.
      */
     SnapshotMutationResult: {
-      snapshot: components["schemas"]["SnapshotEnvelope-Output"];
+      snapshot?: components["schemas"]["SnapshotEnvelope-Output"] | null;
+      snapshot_ref?: components["schemas"]["SnapshotObjectReference"] | null;
+    };
+    /**
+     * SnapshotObjectReference
+     * @description Customer-owned snapshot object transport for device memory.
+     */
+    SnapshotObjectReference: {
+      /**
+       * Collection Id
+       * Format: uuid
+       * @description Collection UUID the referenced snapshot belongs to. Nebula authorizes this collection before fetching customer-owned URLs.
+       */
+      collection_id: string; /** Get Headers */
+      get_headers?: {
+        [key: string]: string;
+      };
+      /**
+       * Get Url
+       * @description Short-lived signed URL Nebula can GET to load the snapshot.
+       */
+      get_url?: string | null; /** Put Headers */
+      put_headers?: {
+        [key: string]: string;
+      };
+      /**
+       * Put Url
+       * @description Short-lived signed URL Nebula can PUT to store an updated snapshot.
+       */
+      put_url?: string | null;
+      /**
+       * Type
+       * @default signed_url
+       * @constant
+       */
+      type?: "signed_url";
     }; /** SnapshotSearchEntityResponse */
     SnapshotSearchEntityResponse: {
       /** Category */category?: string | null; /** Description */
@@ -1831,6 +1887,67 @@ interface components {
       /** Entities */entities?: components["schemas"]["SnapshotSearchEntityResponse"][]; /** Relationships */
       relationships?: components["schemas"]["SnapshotSearchRelationshipResponse"][];
     };
+    /**
+     * StorageTargetCreateRequest
+     * @description Hosted SaaS storage target registration. Use AWS S3 and omit custom endpoint configuration.
+     */
+    StorageTargetCreateRequest: {
+      /** Bucket */bucket: string; /** Kms Key Id */
+      kms_key_id?: string; /** Name */
+      name: string;
+      /**
+       * Prefix
+       * @default
+       */
+      prefix?: string; /** Region */
+      region: string;
+      /**
+       * Role Arn
+       * @description AWS IAM role ARN Nebula assumes to access the bucket.
+       */
+      role_arn: string;
+    }; /** StorageTargetResponse */
+    StorageTargetResponse: {
+      /** Bucket */bucket: string;
+      /**
+       * Created At
+       * Format: date-time
+       */
+      created_at: string; /** External Id */
+      external_id: string;
+      /**
+       * Id
+       * Format: uuid
+       */
+      id: string;
+      /**
+       * Kind
+       * @constant
+       */
+      kind: "customer_s3"; /** Kms Key Id */
+      kms_key_id?: string | null; /** Last Validated At */
+      last_validated_at?: string | null; /** Name */
+      name: string; /** Prefix */
+      prefix: string; /** Region */
+      region?: string | null; /** Role Arn */
+      role_arn?: string | null;
+      /**
+       * Status
+       * @enum {string}
+       */
+      status: "pending" | "active" | "validation_failed" | "disabled";
+      /**
+       * Updated At
+       * Format: date-time
+       */
+      updated_at: string; /** Validation Error */
+      validation_error?: string | null;
+      /**
+       * Workspace Id
+       * Format: uuid
+       */
+      workspace_id: string;
+    };
     /**
      * TextContentRequest
      * @description Text content block.
@@ -1945,6 +2062,9 @@ interface components {
     }; /** NebulaResults[list[ConnectorConnectionResponse]] */
     WrappedListOfConnectorConnectionResponse: {
       /** Results */results: components["schemas"]["ConnectorConnectionResponse"][];
+    }; /** NebulaResults[list[StorageTargetResponse]] */
+    WrappedListOfStorageTargetResponse: {
+      /** Results */results: components["schemas"]["StorageTargetResponse"][];
     }; /** NebulaResults[list[str]] */
     WrappedListOfStr: {
       /** Results */results: string[];
@@ -1957,9 +2077,9 @@ interface components {
     }; /** NebulaResults[PresignedUploadResponse] */
     WrappedPresignedUploadResponse: {
       results: components["schemas"]["PresignedUploadResponse"];
-    }; /** NebulaResults[SnapshotEnvelope] */
-    WrappedSnapshotEnvelope: {
-      results: components["schemas"]["SnapshotEnvelope-Output"];
+    }; /** NebulaResults[Union[SnapshotEnvelope, SnapshotObjectReference]] */
+    WrappedSnapshotEnvelopeOrSnapshotObjectReference: {
+      /** Results */results: components["schemas"]["SnapshotEnvelope-Output"] | components["schemas"]["SnapshotObjectReference"];
     }; /** NebulaResults[SnapshotImportResult] */
     WrappedSnapshotImportResult: {
       results: components["schemas"]["SnapshotImportResult"];
@@ -1969,6 +2089,9 @@ interface components {
     }; /** NebulaResults[SnapshotSearchResult] */
     WrappedSnapshotSearchResult: {
       results: components["schemas"]["SnapshotSearchResult"];
+    }; /** NebulaResults[StorageTargetResponse] */
+    WrappedStorageTargetResponse: {
+      results: components["schemas"]["StorageTargetResponse"];
     };
   };
   responses: never;
@@ -1979,32 +2102,24 @@ interface components {
 }
 //#endregion
 //#region src/resources/client.d.ts
-interface RequestOptions$4 {
-  signal?: AbortSignal;
-}
 declare class ClientResource {
   private readonly core;
   constructor(core: NebulaCore);
   /**
-   *
    * Health probe
    *
    * Lightweight liveness probe. Returns a 200 with a fixed message when the API process is up. Does not verify downstream dependencies (database, storage, workers) — use the internal status endpoints for those.
    * @operationId client.health
    * @endpoint GET /v1/health
    */
-  health(options?: RequestOptions$4): Promise<components["schemas"]["GenericMessageResponse"]>;
+  health(options?: RequestOptions): Promise<components["schemas"]["GenericMessageResponse"]>;
 }
 //#endregion
 //#region src/resources/collections.d.ts
-interface RequestOptions$3 {
-  signal?: AbortSignal;
-}
 declare class CollectionsResource {
   private readonly core;
   constructor(core: NebulaCore);
   /**
-   *
    * Create a new collection
    *
    * Create a new collection and automatically add the creating user
@@ -2016,9 +2131,8 @@ declare class CollectionsResource {
    * @operationId collections.create
    * @endpoint POST /v1/collections
    */
-  create(body: components["schemas"]["CreateCollectionRequest"], options?: RequestOptions$3): Promise<components["schemas"]["CollectionResponse"]>;
+  create(body: components["schemas"]["CreateCollectionRequest"], options?: RequestOptions): Promise<components["schemas"]["CollectionResponse"]>;
   /**
-   *
    * Delete collection
    *
    * Delete an existing collection.
@@ -2030,9 +2144,8 @@ declare class CollectionsResource {
    * @operationId collections.delete
    * @endpoint DELETE /v1/collections/{id}
    */
-  delete(id: string, options?: RequestOptions$3): Promise<components["schemas"]["GenericBooleanResponse"]>;
+  delete(id: string, options?: RequestOptions): Promise<components["schemas"]["GenericBooleanResponse"]>;
   /**
-   *
    * List collections
    *
    * Returns a cursor-paginated list of collections the authenticated
@@ -2054,9 +2167,8 @@ declare class CollectionsResource {
     limit?: number; /** If true, only returns collections owned by the user, not all accessible collections. */
     ownerOnly?: boolean; /** Filter by workspace ID. Pass a UUID to scope to a workspace, or omit for all. */
     workspaceId?: string | null;
-  }, options?: RequestOptions$3): Promise<components["schemas"]["PaginatedCollectionResponse"]>;
+  }, options?: RequestOptions): Promise<components["schemas"]["PaginatedCollectionResponse"]>;
   /**
-   *
    * Get collection details
    *
    * Get details of a specific collection.
@@ -2067,9 +2179,8 @@ declare class CollectionsResource {
    * @operationId collections.retrieve
    * @endpoint GET /v1/collections/{id}
    */
-  retrieve(id: string, options?: RequestOptions$3): Promise<components["schemas"]["CollectionResponse"]>;
+  retrieve(id: string, options?: RequestOptions): Promise<components["schemas"]["CollectionResponse"]>;
   /**
-   *
    * Get a collection by name
    *
    * Retrieve a collection by its (owner_id, name) combination.
@@ -2082,9 +2193,8 @@ declare class CollectionsResource {
   retrieveByName(params: {
     /** The name of the collection */collectionName: string; /** (Superuser only) Specify the owner_id to retrieve a collection by name */
     ownerId?: string | null;
-  }, options?: RequestOptions$3): Promise<components["schemas"]["CollectionResponse"]>;
+  }, options?: RequestOptions): Promise<components["schemas"]["CollectionResponse"]>;
   /**
-   *
    * Update collection
    *
    * Update an existing collection's configuration.
@@ -2098,18 +2208,14 @@ declare class CollectionsResource {
   update(params: {
     /** The unique identifier of the collection to update */id: string;
     body: components["schemas"]["UpdateCollectionRequest"];
-  }, options?: RequestOptions$3): Promise<components["schemas"]["CollectionResponse"]>;
+  }, options?: RequestOptions): Promise<components["schemas"]["CollectionResponse"]>;
 }
 //#endregion
 //#region src/resources/connectors.d.ts
-interface RequestOptions$2 {
-  signal?: AbortSignal;
-}
 declare class ConnectorsResource {
   private readonly core;
   constructor(core: NebulaCore);
   /**
-   *
    * Start OAuth connection flow
    *
    * Start the OAuth connection flow for the given external provider. Returns the authorization URL the user should visit to grant Nebula access. After consent the provider redirects back to Nebula and the connection becomes active.
@@ -2119,9 +2225,8 @@ declare class ConnectorsResource {
   connect(params: {
     provider: string;
     body: components["schemas"]["ConnectRequest"];
-  }, options?: RequestOptions$2): Promise<components["schemas"]["ConnectorConnectResponse"]>;
+  }, options?: RequestOptions): Promise<components["schemas"]["ConnectorConnectResponse"]>;
   /**
-   *
    * Disconnect an external data source
    *
    * Disconnect the named connection, revoking the stored OAuth credentials and stopping future syncs. Optionally pass `delete_memories=true` to also remove every memory this connection had ingested.
@@ -2131,9 +2236,8 @@ declare class ConnectorsResource {
   disconnect(params: {
     connectionId: string;
     deleteMemories?: boolean;
-  }, options?: RequestOptions$2): Promise<components["schemas"]["ConnectorDisconnectResponse"]>;
+  }, options?: RequestOptions): Promise<components["schemas"]["ConnectorDisconnectResponse"]>;
   /**
-   *
    * List active connections for a collection
    *
    * Return every connector connection associated with the given collection, with encrypted credentials redacted. Useful for showing the user which third-party data sources are wired up to a collection.
@@ -2142,45 +2246,38 @@ declare class ConnectorsResource {
    */
   list(params: {
     collectionId: string;
-  }, options?: RequestOptions$2): Promise<Array<components["schemas"]["ConnectorConnectionResponse"]>>;
+  }, options?: RequestOptions): Promise<Array<components["schemas"]["ConnectorConnectionResponse"]>>;
   /**
-   *
    * List available connector providers
    *
    * Return the set of connector provider identifiers (e.g. `google_drive`, `slack`) that this Nebula instance is configured to expose. Pass one of these to `POST /connectors/{provider}/connect` to start an OAuth flow.
    * @operationId connectors.listProviders
    * @endpoint GET /v1/connectors/providers
    */
-  listProviders(options?: RequestOptions$2): Promise<Array<string>>;
+  listProviders(options?: RequestOptions): Promise<Array<string>>;
   /**
-   *
    * Get a single connection by ID
    *
    * Fetch a single connector connection by its UUID. Returns the connection metadata plus whether the underlying subscription is active. Encrypted credentials are never returned to clients.
    * @operationId connectors.retrieve
    * @endpoint GET /v1/connectors/{connection_id}
    */
-  retrieve(connectionId: string, options?: RequestOptions$2): Promise<components["schemas"]["ConnectorConnectionResponse"]>;
+  retrieve(connectionId: string, options?: RequestOptions): Promise<components["schemas"]["ConnectorConnectionResponse"]>;
   /**
-   *
    * Manually trigger a sync
    *
    * Schedule an immediate sync for an active connection, bypassing the normal cadence. Returns 409 if a sync is already in progress and 400 if the connection isn't in the `active` state.
    * @operationId connectors.sync
    * @endpoint POST /v1/connectors/{connection_id}/sync
    */
-  sync(connectionId: string, options?: RequestOptions$2): Promise<components["schemas"]["ConnectorSyncResponse"]>;
+  sync(connectionId: string, options?: RequestOptions): Promise<components["schemas"]["ConnectorSyncResponse"]>;
 }
 //#endregion
 //#region src/resources/memories.d.ts
-interface RequestOptions$1 {
-  signal?: AbortSignal;
-}
 declare class MemoriesResource {
   private readonly core;
   constructor(core: NebulaCore);
   /**
-   *
    * Append content to an engram
    *
    * Append content to an existing engram.
@@ -2198,9 +2295,8 @@ declare class MemoriesResource {
   append(params: {
     /** The unique identifier of the engram */id: string;
     body: components["schemas"]["AppendMemoryRequest"];
-  }, options?: RequestOptions$1): Promise<components["schemas"]["AppendMemoryResponse"] | components["schemas"]["IngestionResponse"]>;
+  }, options?: RequestOptions): Promise<components["schemas"]["AppendMemoryResponse"] | components["schemas"]["IngestionResponse"]>;
   /**
-   *
    * Create a new memory (conversation or document)
    *
    * Create a new memory (conversation or document) using clean JSON body.
@@ -2215,9 +2311,8 @@ declare class MemoriesResource {
    * @operationId memories.create
    * @endpoint POST /v1/memories
    */
-  create(body: components["schemas"]["CreateMemoryRequest"], options?: RequestOptions$1): Promise<components["schemas"]["MemoryCreateAcceptedResponse"] | components["schemas"]["SnapshotMutationResult"]>;
+  create(body: components["schemas"]["CreateMemoryRequest"], options?: RequestOptions): Promise<components["schemas"]["MemoryCreateAcceptedResponse"] | components["schemas"]["SnapshotMutationResult"]>;
   /**
-   *
    * Get presigned URL for large file upload
    *
    * Get a presigned URL for uploading large files directly to S3.
@@ -2245,9 +2340,8 @@ declare class MemoriesResource {
     /** Original filename (e.g., 'image.jpg') */filename: string; /** MIME type (e.g., 'image/jpeg', 'application/pdf') */
     contentType: string; /** Expected file size in bytes (max 100MB) */
     fileSize: number;
-  }, options?: RequestOptions$1): Promise<components["schemas"]["PresignedUploadResponse"]>;
+  }, options?: RequestOptions): Promise<components["schemas"]["PresignedUploadResponse"]>;
   /**
-   *
    * Delete an engram
    *
    * Delete a specific engram with graph awareness. All chunks corresponding to the
@@ -2259,9 +2353,8 @@ declare class MemoriesResource {
    * @operationId memories.delete
    * @endpoint DELETE /v1/memories/{id}
    */
-  delete(id: string, options?: RequestOptions$1): Promise<components["schemas"]["GenericBooleanResponse"]>;
+  delete(id: string, options?: RequestOptions): Promise<components["schemas"]["GenericBooleanResponse"]>;
   /**
-   *
    * Delete one or more engrams
    *
    * Delete one or more engrams.
@@ -2278,9 +2371,8 @@ declare class MemoriesResource {
    * @operationId memories.deleteMany
    * @endpoint POST /v1/memories/delete
    */
-  deleteMany(body: components["schemas"]["DeleteMemoriesRequest"], options?: RequestOptions$1): Promise<unknown>;
+  deleteMany(body: components["schemas"]["DeleteMemoriesRequest"], options?: RequestOptions): Promise<unknown>;
   /**
-   *
    * Delete a previously uploaded S3 file
    *
    * Delete a file from S3 that was uploaded via a presigned URL.
@@ -2290,9 +2382,8 @@ declare class MemoriesResource {
    */
   deleteUpload(params: {
     /** S3 key of the file to delete (returned by POST /memories/upload) */s3Key: string;
-  }, options?: RequestOptions$1): Promise<components["schemas"]["GenericMessageResponse"]>;
+  }, options?: RequestOptions): Promise<components["schemas"]["GenericMessageResponse"]>;
   /**
-   *
    * List engrams
    *
    * Returns a cursor-paginated list of engrams the authenticated user
@@ -2316,9 +2407,8 @@ declare class MemoriesResource {
     collectionIds?: Array<string> | null; /** JSON string for metadata filtering. Example: '{"metadata.source": {"$eq": "playground"}}' */
     metadataFilters?: string | null; /** Read-your-writes assertion: the WAL-tail overlay path waits for at least this seq to be applied before serving (or returns 503 Unavailable on timeout). REQUIRES exactly one collection_ids entry — without a collection scope the request returns 422 (the per-WAL-shard scalar applied_wal_seq is meaningless across collections). When the served shard has not been migrated to wal_compaction_enabled, the field is accepted but the served path is the legacy overlay (the assertion has no effect — the response's applied_wal_seq will be 0). Pass back the value the matching upload response surfaced. */
     minAppliedWalSeq?: number | null;
-  }, options?: RequestOptions$1): Promise<components["schemas"]["PaginatedListedEngram"]>;
+  }, options?: RequestOptions): Promise<components["schemas"]["PaginatedListedEngram"]>;
   /**
-   *
    * Recall workflow patterns by intent
    *
    * Workflow-pattern recall over 5 intents.
@@ -2334,9 +2424,8 @@ declare class MemoriesResource {
    * @operationId memories.recallWorkflow
    * @endpoint POST /v1/memories/workflow/recall
    */
-  recallWorkflow(body: components["schemas"]["CursorRecallRequest"] | components["schemas"]["PredictRecallRequest"] | components["schemas"]["ResumeRecallRequest"] | components["schemas"]["EvidenceRecallRequest"] | components["schemas"]["BootstrapRecallRequest"], options?: RequestOptions$1): Promise<Record<string, unknown>>;
+  recallWorkflow(body: components["schemas"]["CursorRecallRequest"] | components["schemas"]["PredictRecallRequest"] | components["schemas"]["ResumeRecallRequest"] | components["schemas"]["EvidenceRecallRequest"] | components["schemas"]["BootstrapRecallRequest"], options?: RequestOptions): Promise<Record<string, unknown>>;
   /**
-   *
    * Retrieve an engram
    *
    * Retrieves detailed information about a specific engram by its
@@ -2350,9 +2439,8 @@ declare class MemoriesResource {
    * @operationId memories.retrieve
    * @endpoint GET /v1/memories/{id}
    */
-  retrieve(id: string, options?: RequestOptions$1): Promise<components["schemas"]["Engram"]>;
+  retrieve(id: string, options?: RequestOptions): Promise<components["schemas"]["Engram"]>;
   /**
-   *
    * Search memories
    *
    * Perform a search query across your memories.
@@ -2365,9 +2453,8 @@ declare class MemoriesResource {
    * @operationId memories.search
    * @endpoint POST /v1/memories/search
    */
-  search(body: components["schemas"]["MemorySearchRequest"], options?: RequestOptions$1): Promise<components["schemas"]["CompactMemoryRecallResponse"] | components["schemas"]["MemoryRecall"] | components["schemas"]["SnapshotSearchResult"]>;
+  search(body: components["schemas"]["MemorySearchRequest"], options?: RequestOptions): Promise<components["schemas"]["CompactMemoryRecallResponse"] | components["schemas"]["MemoryRecall"] | components["schemas"]["SnapshotSearchResult"]>;
   /**
-   *
    * Update a memory
    *
    * Update memory-level properties including name, metadata, and collection associations.
@@ -2390,18 +2477,14 @@ declare class MemoriesResource {
     /** The unique identifier of the memory */id: string; /** Collection context for copy-on-write. If provided and engram is shared, creates a copy before modification. */
     collectionId?: string | null;
     body: components["schemas"]["UpdateMemoryRequest"];
-  }, options?: RequestOptions$1): Promise<components["schemas"]["Engram"]>;
+  }, options?: RequestOptions): Promise<components["schemas"]["Engram"]>;
 }
 //#endregion
 //#region src/resources/snapshots.d.ts
-interface RequestOptions {
-  signal?: AbortSignal;
-}
 declare class SnapshotsResource {
   private readonly core;
   constructor(core: NebulaCore);
   /**
-   *
    * Export a collection snapshot
    *
    * Export a collection's full graph state as a
@@ -2409,9 +2492,8 @@ declare class SnapshotsResource {
    * @operationId snapshots.export
    * @endpoint POST /v1/device-memory/snapshot/export
    */
-  export(body: components["schemas"]["SnapshotExportRequest"], options?: RequestOptions): Promise<components["schemas"]["SnapshotEnvelope-Output"]>;
+  export(body: components["schemas"]["SnapshotExportRequest"], options?: RequestOptions): Promise<components["schemas"]["SnapshotEnvelope-Output"] | components["schemas"]["SnapshotObjectReference"]>;
   /**
-   *
    * Import a snapshot into an ephemeral collection
    *
    * Import a SnapshotEnvelope into an ephemeral
@@ -2422,6 +2504,53 @@ declare class SnapshotsResource {
   import(body: components["schemas"]["SnapshotImportRequest"], options?: RequestOptions): Promise<components["schemas"]["SnapshotImportResult"]>;
 }
 //#endregion
+//#region src/resources/workspaces.d.ts
+declare class WorkspacesResource {
+  private readonly core;
+  constructor(core: NebulaCore);
+  /**
+   * Create workspace storage target
+   *
+   * Register a customer S3 bucket for hosted BYOC storage.
+   * @operationId workspaces.createStorageTarget
+   * @endpoint POST /v1/workspaces/{workspace_id}/storage-targets
+   */
+  createStorageTarget(params: {
+    workspaceId: string;
+    body: components["schemas"]["StorageTargetCreateRequest"];
+  }, options?: RequestOptions): Promise<components["schemas"]["StorageTargetResponse"]>;
+  /**
+   * Disable workspace storage target
+   *
+   * Disable a customer storage target for future collection binds.
+   * @operationId workspaces.disableStorageTarget
+   * @endpoint DELETE /v1/workspaces/{workspace_id}/storage-targets/{target_id}
+   */
+  disableStorageTarget(params: {
+    workspaceId: string;
+    targetId: string;
+  }, options?: RequestOptions): Promise<components["schemas"]["StorageTargetResponse"]>;
+  /**
+   * List workspace storage targets
+   *
+   * List customer-owned object storage targets for a workspace.
+   * @operationId workspaces.listStorageTargets
+   * @endpoint GET /v1/workspaces/{workspace_id}/storage-targets
+   */
+  listStorageTargets(workspaceId: string, options?: RequestOptions): Promise<Array<components["schemas"]["StorageTargetResponse"]>>;
+  /**
+   * Validate workspace storage target
+   *
+   * Probe a customer storage target and mark it active on success.
+   * @operationId workspaces.validateStorageTarget
+   * @endpoint POST /v1/workspaces/{workspace_id}/storage-targets/{target_id}/validate
+   */
+  validateStorageTarget(params: {
+    workspaceId: string;
+    targetId: string;
+  }, options?: RequestOptions): Promise<components["schemas"]["StorageTargetResponse"]>;
+}
+//#endregion
 //#region src/client.d.ts
 declare class NebulaClient {
   protected readonly core: NebulaCore;
@@ -2430,6 +2559,7 @@ declare class NebulaClient {
   readonly connectors: ConnectorsResource;
   readonly memories: MemoriesResource;
   readonly snapshots: SnapshotsResource;
+  readonly workspaces: WorkspacesResource;
   constructor(options?: ClientOptions);
 }
 //#endregion
@@ -2579,5 +2709,5 @@ declare class Nebula extends NebulaClient {
   }): Promise<unknown>;
 }
 //#endregion
-export { type APIErrorPayload, type ClientOptions, type CompatClientOptions, DEFAULT_RETRY, Nebula, Nebula as default, NebulaAPIError, NebulaBadRequestError, NebulaClient, NebulaConflictError, NebulaConnectionError, NebulaCore, NebulaError, NebulaForbiddenError, NebulaNotFoundError, NebulaRateLimitError, NebulaServerError, NebulaTimeoutError, NebulaUnauthorizedError, NebulaValidationError, type RequestArgs, type RetryPolicy, backoffMs, type components, errorFromResponse, isRetryableStatus, sleep };
+export { type APIErrorPayload, type ClientOptions, type CompatClientOptions, DEFAULT_RETRY, Nebula, Nebula as default, NebulaAPIError, NebulaBadRequestError, NebulaClient, NebulaConflictError, NebulaConnectionError, NebulaCore, NebulaError, NebulaForbiddenError, NebulaNotFoundError, NebulaRateLimitError, NebulaServerError, NebulaTimeoutError, NebulaUnauthorizedError, NebulaValidationError, type RequestArgs, type RequestOptions, type RetryPolicy, backoffMs, type components, errorFromResponse, isRetryableStatus, sleep };
 //# sourceMappingURL=index.d.ts.map