bem-ai-sdk 0.25.0 → 0.27.0

package/resources/buckets.d.mts

@@ -0,0 +1,272 @@
+import { APIResource } from "../core/resource.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+/**
+ * Buckets are named partitions of the knowledge graph within an
+ * account+environment. Entities, mentions, and relations are scoped to a
+ * bucket so a single account+environment can host multiple isolated graphs
+ * — for example one per data source or workspace.
+ *
+ * Every account+environment has exactly one **default** bucket, used by
+ * unscoped flows. The default bucket can be renamed but never deleted.
+ *
+ * Use these endpoints to create, list, fetch, rename, and delete buckets:
+ *
+ * - **`POST /v3/buckets`** creates a non-default bucket.
+ * - **`GET /v3/buckets`** lists buckets with cursor pagination
+ *   (`startingAfter` / `endingBefore` over `bucketID`).
+ * - **`PATCH /v3/buckets/{bucketID}`** updates `name` and/or `description`.
+ * - **`DELETE /v3/buckets/{bucketID}`** soft-deletes a bucket. A non-empty
+ *   bucket is rejected with `409 Conflict` unless `?cascade=true` is
+ *   passed; the default bucket can never be deleted.
+ */
+export declare class Buckets extends APIResource {
+    /**
+     * Create a Bucket
+     *
+     * @example
+     * ```ts
+     * const bucket = await client.buckets.create({
+     *   name: 'invoices',
+     *   description: 'Knowledge graph for invoice documents',
+     * });
+     * ```
+     */
+    create(body: BucketCreateParams, options?: RequestOptions): APIPromise<BucketCreateResponse>;
+    /**
+     * Get a Bucket
+     *
+     * @example
+     * ```ts
+     * const bucket = await client.buckets.retrieve('bucketID');
+     * ```
+     */
+    retrieve(bucketID: string, options?: RequestOptions): APIPromise<BucketRetrieveResponse>;
+    /**
+     * Update a Bucket
+     *
+     * @example
+     * ```ts
+     * const bucket = await client.buckets.update('bucketID');
+     * ```
+     */
+    update(bucketID: string, body: BucketUpdateParams, options?: RequestOptions): APIPromise<BucketUpdateResponse>;
+    /**
+     * List Buckets
+     *
+     * @example
+     * ```ts
+     * const buckets = await client.buckets.list();
+     * ```
+     */
+    list(query?: BucketListParams | null | undefined, options?: RequestOptions): APIPromise<BucketListResponse>;
+    /**
+     * Delete a Bucket
+     *
+     * @example
+     * ```ts
+     * await client.buckets.delete('bucketID');
+     * ```
+     */
+    delete(bucketID: string, params?: BucketDeleteParams | null | undefined, options?: RequestOptions): APIPromise<void>;
+}
+/**
+ * A Bucket is a named partition of the knowledge graph within an
+ * account+environment. Entities, mentions, and relations are scoped to a bucket so
+ * a single account+environment can host multiple isolated graphs.
+ *
+ * Every account+environment has exactly one default bucket. The default bucket can
+ * be renamed but never deleted.
+ */
+export interface BucketCreateResponse {
+    /**
+     * Stable public identifier for the bucket (`bkt_...`).
+     */
+    bucketID: string;
+    /**
+     * Creation timestamp (RFC 3339).
+     */
+    createdAt: string;
+    /**
+     * Optional human-facing note about the bucket.
+     */
+    description: string;
+    /**
+     * Whether this is the account+environment's default bucket.
+     */
+    isDefault: boolean;
+    /**
+     * Human-facing bucket name. Unique within an account+environment.
+     */
+    name: string;
+    /**
+     * Last-update timestamp (RFC 3339).
+     */
+    updatedAt: string;
+}
+/**
+ * A Bucket is a named partition of the knowledge graph within an
+ * account+environment. Entities, mentions, and relations are scoped to a bucket so
+ * a single account+environment can host multiple isolated graphs.
+ *
+ * Every account+environment has exactly one default bucket. The default bucket can
+ * be renamed but never deleted.
+ */
+export interface BucketRetrieveResponse {
+    /**
+     * Stable public identifier for the bucket (`bkt_...`).
+     */
+    bucketID: string;
+    /**
+     * Creation timestamp (RFC 3339).
+     */
+    createdAt: string;
+    /**
+     * Optional human-facing note about the bucket.
+     */
+    description: string;
+    /**
+     * Whether this is the account+environment's default bucket.
+     */
+    isDefault: boolean;
+    /**
+     * Human-facing bucket name. Unique within an account+environment.
+     */
+    name: string;
+    /**
+     * Last-update timestamp (RFC 3339).
+     */
+    updatedAt: string;
+}
+/**
+ * A Bucket is a named partition of the knowledge graph within an
+ * account+environment. Entities, mentions, and relations are scoped to a bucket so
+ * a single account+environment can host multiple isolated graphs.
+ *
+ * Every account+environment has exactly one default bucket. The default bucket can
+ * be renamed but never deleted.
+ */
+export interface BucketUpdateResponse {
+    /**
+     * Stable public identifier for the bucket (`bkt_...`).
+     */
+    bucketID: string;
+    /**
+     * Creation timestamp (RFC 3339).
+     */
+    createdAt: string;
+    /**
+     * Optional human-facing note about the bucket.
+     */
+    description: string;
+    /**
+     * Whether this is the account+environment's default bucket.
+     */
+    isDefault: boolean;
+    /**
+     * Human-facing bucket name. Unique within an account+environment.
+     */
+    name: string;
+    /**
+     * Last-update timestamp (RFC 3339).
+     */
+    updatedAt: string;
+}
+/**
+ * Response body for listing buckets.
+ */
+export interface BucketListResponse {
+    buckets: Array<BucketListResponse.Bucket>;
+    /**
+     * Total number of buckets matching the query, ignoring pagination.
+     */
+    totalCount: number;
+}
+export declare namespace BucketListResponse {
+    /**
+     * A Bucket is a named partition of the knowledge graph within an
+     * account+environment. Entities, mentions, and relations are scoped to a bucket so
+     * a single account+environment can host multiple isolated graphs.
+     *
+     * Every account+environment has exactly one default bucket. The default bucket can
+     * be renamed but never deleted.
+     */
+    interface Bucket {
+        /**
+         * Stable public identifier for the bucket (`bkt_...`).
+         */
+        bucketID: string;
+        /**
+         * Creation timestamp (RFC 3339).
+         */
+        createdAt: string;
+        /**
+         * Optional human-facing note about the bucket.
+         */
+        description: string;
+        /**
+         * Whether this is the account+environment's default bucket.
+         */
+        isDefault: boolean;
+        /**
+         * Human-facing bucket name. Unique within an account+environment.
+         */
+        name: string;
+        /**
+         * Last-update timestamp (RFC 3339).
+         */
+        updatedAt: string;
+    }
+}
+export interface BucketCreateParams {
+    /**
+     * Bucket name. Required and unique within the account+environment.
+     */
+    name: string;
+    /**
+     * Optional description.
+     */
+    description?: string;
+}
+export interface BucketUpdateParams {
+    /**
+     * New description.
+     */
+    description?: string;
+    /**
+     * New name.
+     */
+    name?: string;
+}
+export interface BucketListParams {
+    /**
+     * Cursor: return buckets whose `bucketID` sorts before this value.
+     */
+    endingBefore?: string;
+    /**
+     * Maximum number of buckets to return (default 50, max 200).
+     */
+    limit?: number;
+    /**
+     * Case-insensitive substring match on the bucket name.
+     */
+    nameSubstring?: string;
+    /**
+     * Cursor: return buckets whose `bucketID` sorts after this value.
+     */
+    startingAfter?: string;
+}
+export interface BucketDeleteParams {
+    /**
+     * When `true`, delete the bucket even if it still contains entities (the entities
+     * are removed along with it). When omitted or `false`, the request is rejected
+     * with `409 Conflict` if the bucket is non-empty.
+     *
+     * The default bucket can never be deleted regardless of this flag.
+     */
+    cascade?: boolean;
+}
+export declare namespace Buckets {
+    export { type BucketCreateResponse as BucketCreateResponse, type BucketRetrieveResponse as BucketRetrieveResponse, type BucketUpdateResponse as BucketUpdateResponse, type BucketListResponse as BucketListResponse, type BucketCreateParams as BucketCreateParams, type BucketUpdateParams as BucketUpdateParams, type BucketListParams as BucketListParams, type BucketDeleteParams as BucketDeleteParams, };
+}
+//# sourceMappingURL=buckets.d.mts.map

package/resources/buckets.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buckets.d.mts","sourceRoot":"","sources":["../src/resources/buckets.ts"],"names":[],"mappings":"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"}

package/resources/buckets.d.ts

@@ -0,0 +1,272 @@
+import { APIResource } from "../core/resource.js";
+import { APIPromise } from "../core/api-promise.js";
+import { RequestOptions } from "../internal/request-options.js";
+/**
+ * Buckets are named partitions of the knowledge graph within an
+ * account+environment. Entities, mentions, and relations are scoped to a
+ * bucket so a single account+environment can host multiple isolated graphs
+ * — for example one per data source or workspace.
+ *
+ * Every account+environment has exactly one **default** bucket, used by
+ * unscoped flows. The default bucket can be renamed but never deleted.
+ *
+ * Use these endpoints to create, list, fetch, rename, and delete buckets:
+ *
+ * - **`POST /v3/buckets`** creates a non-default bucket.
+ * - **`GET /v3/buckets`** lists buckets with cursor pagination
+ *   (`startingAfter` / `endingBefore` over `bucketID`).
+ * - **`PATCH /v3/buckets/{bucketID}`** updates `name` and/or `description`.
+ * - **`DELETE /v3/buckets/{bucketID}`** soft-deletes a bucket. A non-empty
+ *   bucket is rejected with `409 Conflict` unless `?cascade=true` is
+ *   passed; the default bucket can never be deleted.
+ */
+export declare class Buckets extends APIResource {
+    /**
+     * Create a Bucket
+     *
+     * @example
+     * ```ts
+     * const bucket = await client.buckets.create({
+     *   name: 'invoices',
+     *   description: 'Knowledge graph for invoice documents',
+     * });
+     * ```
+     */
+    create(body: BucketCreateParams, options?: RequestOptions): APIPromise<BucketCreateResponse>;
+    /**
+     * Get a Bucket
+     *
+     * @example
+     * ```ts
+     * const bucket = await client.buckets.retrieve('bucketID');
+     * ```
+     */
+    retrieve(bucketID: string, options?: RequestOptions): APIPromise<BucketRetrieveResponse>;
+    /**
+     * Update a Bucket
+     *
+     * @example
+     * ```ts
+     * const bucket = await client.buckets.update('bucketID');
+     * ```
+     */
+    update(bucketID: string, body: BucketUpdateParams, options?: RequestOptions): APIPromise<BucketUpdateResponse>;
+    /**
+     * List Buckets
+     *
+     * @example
+     * ```ts
+     * const buckets = await client.buckets.list();
+     * ```
+     */
+    list(query?: BucketListParams | null | undefined, options?: RequestOptions): APIPromise<BucketListResponse>;
+    /**
+     * Delete a Bucket
+     *
+     * @example
+     * ```ts
+     * await client.buckets.delete('bucketID');
+     * ```
+     */
+    delete(bucketID: string, params?: BucketDeleteParams | null | undefined, options?: RequestOptions): APIPromise<void>;
+}
+/**
+ * A Bucket is a named partition of the knowledge graph within an
+ * account+environment. Entities, mentions, and relations are scoped to a bucket so
+ * a single account+environment can host multiple isolated graphs.
+ *
+ * Every account+environment has exactly one default bucket. The default bucket can
+ * be renamed but never deleted.
+ */
+export interface BucketCreateResponse {
+    /**
+     * Stable public identifier for the bucket (`bkt_...`).
+     */
+    bucketID: string;
+    /**
+     * Creation timestamp (RFC 3339).
+     */
+    createdAt: string;
+    /**
+     * Optional human-facing note about the bucket.
+     */
+    description: string;
+    /**
+     * Whether this is the account+environment's default bucket.
+     */
+    isDefault: boolean;
+    /**
+     * Human-facing bucket name. Unique within an account+environment.
+     */
+    name: string;
+    /**
+     * Last-update timestamp (RFC 3339).
+     */
+    updatedAt: string;
+}
+/**
+ * A Bucket is a named partition of the knowledge graph within an
+ * account+environment. Entities, mentions, and relations are scoped to a bucket so
+ * a single account+environment can host multiple isolated graphs.
+ *
+ * Every account+environment has exactly one default bucket. The default bucket can
+ * be renamed but never deleted.
+ */
+export interface BucketRetrieveResponse {
+    /**
+     * Stable public identifier for the bucket (`bkt_...`).
+     */
+    bucketID: string;
+    /**
+     * Creation timestamp (RFC 3339).
+     */
+    createdAt: string;
+    /**
+     * Optional human-facing note about the bucket.
+     */
+    description: string;
+    /**
+     * Whether this is the account+environment's default bucket.
+     */
+    isDefault: boolean;
+    /**
+     * Human-facing bucket name. Unique within an account+environment.
+     */
+    name: string;
+    /**
+     * Last-update timestamp (RFC 3339).
+     */
+    updatedAt: string;
+}
+/**
+ * A Bucket is a named partition of the knowledge graph within an
+ * account+environment. Entities, mentions, and relations are scoped to a bucket so
+ * a single account+environment can host multiple isolated graphs.
+ *
+ * Every account+environment has exactly one default bucket. The default bucket can
+ * be renamed but never deleted.
+ */
+export interface BucketUpdateResponse {
+    /**
+     * Stable public identifier for the bucket (`bkt_...`).
+     */
+    bucketID: string;
+    /**
+     * Creation timestamp (RFC 3339).
+     */
+    createdAt: string;
+    /**
+     * Optional human-facing note about the bucket.
+     */
+    description: string;
+    /**
+     * Whether this is the account+environment's default bucket.
+     */
+    isDefault: boolean;
+    /**
+     * Human-facing bucket name. Unique within an account+environment.
+     */
+    name: string;
+    /**
+     * Last-update timestamp (RFC 3339).
+     */
+    updatedAt: string;
+}
+/**
+ * Response body for listing buckets.
+ */
+export interface BucketListResponse {
+    buckets: Array<BucketListResponse.Bucket>;
+    /**
+     * Total number of buckets matching the query, ignoring pagination.
+     */
+    totalCount: number;
+}
+export declare namespace BucketListResponse {
+    /**
+     * A Bucket is a named partition of the knowledge graph within an
+     * account+environment. Entities, mentions, and relations are scoped to a bucket so
+     * a single account+environment can host multiple isolated graphs.
+     *
+     * Every account+environment has exactly one default bucket. The default bucket can
+     * be renamed but never deleted.
+     */
+    interface Bucket {
+        /**
+         * Stable public identifier for the bucket (`bkt_...`).
+         */
+        bucketID: string;
+        /**
+         * Creation timestamp (RFC 3339).
+         */
+        createdAt: string;
+        /**
+         * Optional human-facing note about the bucket.
+         */
+        description: string;
+        /**
+         * Whether this is the account+environment's default bucket.
+         */
+        isDefault: boolean;
+        /**
+         * Human-facing bucket name. Unique within an account+environment.
+         */
+        name: string;
+        /**
+         * Last-update timestamp (RFC 3339).
+         */
+        updatedAt: string;
+    }
+}
+export interface BucketCreateParams {
+    /**
+     * Bucket name. Required and unique within the account+environment.
+     */
+    name: string;
+    /**
+     * Optional description.
+     */
+    description?: string;
+}
+export interface BucketUpdateParams {
+    /**
+     * New description.
+     */
+    description?: string;
+    /**
+     * New name.
+     */
+    name?: string;
+}
+export interface BucketListParams {
+    /**
+     * Cursor: return buckets whose `bucketID` sorts before this value.
+     */
+    endingBefore?: string;
+    /**
+     * Maximum number of buckets to return (default 50, max 200).
+     */
+    limit?: number;
+    /**
+     * Case-insensitive substring match on the bucket name.
+     */
+    nameSubstring?: string;
+    /**
+     * Cursor: return buckets whose `bucketID` sorts after this value.
+     */
+    startingAfter?: string;
+}
+export interface BucketDeleteParams {
+    /**
+     * When `true`, delete the bucket even if it still contains entities (the entities
+     * are removed along with it). When omitted or `false`, the request is rejected
+     * with `409 Conflict` if the bucket is non-empty.
+     *
+     * The default bucket can never be deleted regardless of this flag.
+     */
+    cascade?: boolean;
+}
+export declare namespace Buckets {
+    export { type BucketCreateResponse as BucketCreateResponse, type BucketRetrieveResponse as BucketRetrieveResponse, type BucketUpdateResponse as BucketUpdateResponse, type BucketListResponse as BucketListResponse, type BucketCreateParams as BucketCreateParams, type BucketUpdateParams as BucketUpdateParams, type BucketListParams as BucketListParams, type BucketDeleteParams as BucketDeleteParams, };
+}
+//# sourceMappingURL=buckets.d.ts.map

package/resources/buckets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buckets.d.ts","sourceRoot":"","sources":["../src/resources/buckets.ts"],"names":[],"mappings":"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"}

package/resources/buckets.js

@@ -0,0 +1,93 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Buckets = void 0;
+const resource_1 = require("../core/resource.js");
+const headers_1 = require("../internal/headers.js");
+const path_1 = require("../internal/utils/path.js");
+/**
+ * Buckets are named partitions of the knowledge graph within an
+ * account+environment. Entities, mentions, and relations are scoped to a
+ * bucket so a single account+environment can host multiple isolated graphs
+ * — for example one per data source or workspace.
+ *
+ * Every account+environment has exactly one **default** bucket, used by
+ * unscoped flows. The default bucket can be renamed but never deleted.
+ *
+ * Use these endpoints to create, list, fetch, rename, and delete buckets:
+ *
+ * - **`POST /v3/buckets`** creates a non-default bucket.
+ * - **`GET /v3/buckets`** lists buckets with cursor pagination
+ *   (`startingAfter` / `endingBefore` over `bucketID`).
+ * - **`PATCH /v3/buckets/{bucketID}`** updates `name` and/or `description`.
+ * - **`DELETE /v3/buckets/{bucketID}`** soft-deletes a bucket. A non-empty
+ *   bucket is rejected with `409 Conflict` unless `?cascade=true` is
+ *   passed; the default bucket can never be deleted.
+ */
+class Buckets extends resource_1.APIResource {
+    /**
+     * Create a Bucket
+     *
+     * @example
+     * ```ts
+     * const bucket = await client.buckets.create({
+     *   name: 'invoices',
+     *   description: 'Knowledge graph for invoice documents',
+     * });
+     * ```
+     */
+    create(body, options) {
+        return this._client.post('/v3/buckets', { body, ...options });
+    }
+    /**
+     * Get a Bucket
+     *
+     * @example
+     * ```ts
+     * const bucket = await client.buckets.retrieve('bucketID');
+     * ```
+     */
+    retrieve(bucketID, options) {
+        return this._client.get((0, path_1.path) `/v3/buckets/${bucketID}`, options);
+    }
+    /**
+     * Update a Bucket
+     *
+     * @example
+     * ```ts
+     * const bucket = await client.buckets.update('bucketID');
+     * ```
+     */
+    update(bucketID, body, options) {
+        return this._client.patch((0, path_1.path) `/v3/buckets/${bucketID}`, { body, ...options });
+    }
+    /**
+     * List Buckets
+     *
+     * @example
+     * ```ts
+     * const buckets = await client.buckets.list();
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.get('/v3/buckets', { query, ...options });
+    }
+    /**
+     * Delete a Bucket
+     *
+     * @example
+     * ```ts
+     * await client.buckets.delete('bucketID');
+     * ```
+     */
+    delete(bucketID, params = {}, options) {
+        const { cascade } = params ?? {};
+        return this._client.delete((0, path_1.path) `/v3/buckets/${bucketID}`, {
+            query: { cascade },
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+exports.Buckets = Buckets;
+//# sourceMappingURL=buckets.js.map

package/resources/buckets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buckets.js","sourceRoot":"","sources":["../src/resources/buckets.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAE/C,oDAAmD;AAEnD,oDAA8C;AAE9C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAa,OAAQ,SAAQ,sBAAW;IACtC;;;;;;;;;;OAUG;IACH,MAAM,CAAC,IAAwB,EAAE,OAAwB;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAgB,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,eAAe,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CACJ,QAAgB,EAChB,IAAwB,EACxB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,eAAe,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjF,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CACF,QAA6C,EAAE,EAC/C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CACJ,QAAgB,EAChB,SAAgD,EAAE,EAClD,OAAwB;QAExB,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,eAAe,QAAQ,EAAE,EAAE;YACxD,KAAK,EAAE,EAAE,OAAO,EAAE;YAClB,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF;AA/ED,0BA+EC"}