@inconvoai/node 0.3.0 → 0.4.0

package/resources/datasets.d.ts

@@ -1,67 +1,2 @@
-import { APIResource } from "../core/resource.js";
-import { APIPromise } from "../core/api-promise.js";
-import { type Uploadable } from "../core/uploads.js";
-import { RequestOptions } from "../internal/request-options.js";
-export declare class Datasets extends APIResource {
-    /**
-     * List dataset files
-     */
-    list(query: DatasetListParams, options?: RequestOptions): APIPromise<DatasetListResponse>;
-    /**
-     * Delete dataset file
-     */
-    delete(filename: string, params: DatasetDeleteParams, options?: RequestOptions): APIPromise<DatasetDeleteResponse>;
-    /**
-     * Upload dataset file
-     */
-    upload(body: DatasetUploadParams, options?: RequestOptions): APIPromise<DatasetUploadResponse>;
-}
-export interface DatasetListResponse {
-    files: Array<string>;
-}
-export interface DatasetDeleteResponse {
-    file: string;
-    success: boolean;
-    error?: string;
-}
-export interface DatasetUploadResponse {
-    file: DatasetUploadResponse.File;
-    error?: string;
-}
-export declare namespace DatasetUploadResponse {
-    interface File {
-        name: string;
-        path: string;
-        size: number;
-    }
-}
-export interface DatasetListParams {
-    userContext: {
-        [key: string]: string | number;
-    };
-}
-export interface DatasetDeleteParams {
-    userContext: {
-        [key: string]: string | number;
-    };
-}
-export interface DatasetUploadParams {
-    /**
-     * The file to upload
-     */
-    file: Uploadable;
-    /**
-     * Request context for scoping the file, as a JSON-encoded string. Pass your
-     * context object through JSON.stringify() before sending. Example:
-     * JSON.stringify({ userId: 123, orgId: 456 })
-     */
-    userContext: string;
-    /**
-     * Optional notes or description for the dataset
-     */
-    notes?: string;
-}
-export declare namespace Datasets {
-    export { type DatasetListResponse as DatasetListResponse, type DatasetDeleteResponse as DatasetDeleteResponse, type DatasetUploadResponse as DatasetUploadResponse, type DatasetListParams as DatasetListParams, type DatasetDeleteParams as DatasetDeleteParams, type DatasetUploadParams as DatasetUploadParams, };
-}
+export * from "./datasets/index.js";
 //# sourceMappingURL=datasets.d.ts.map

package/resources/datasets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"datasets.d.ts","sourceRoot":"","sources":["../src/resources/datasets.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,KAAK,UAAU,EAAE;OACnB,EAAE,cAAc,EAAE;AAIzB,qBAAa,QAAS,SAAQ,WAAW;IACvC;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,mBAAmB,CAAC;IAIzF;;OAEG;IACH,MAAM,CACJ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,qBAAqB,CAAC;IAKpC;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,qBAAqB,CAAC;CAG/F;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IAEb,OAAO,EAAE,OAAO,CAAC;IAEjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,qBAAqB,CAAC,IAAI,CAAC;IAEjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,yBAAiB,qBAAqB,CAAC;IACrC,UAAiB,IAAI;QACnB,IAAI,EAAE,MAAM,CAAC;QAEb,IAAI,EAAE,MAAM,CAAC;QAEb,IAAI,EAAE,MAAM,CAAC;KACd;CACF;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CACjD;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CACjD;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,EAAE,UAAU,CAAC;IAEjB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EACL,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,mBAAmB,IAAI,mBAAmB,GAChD,CAAC;CACH"}
+{"version":3,"file":"datasets.d.ts","sourceRoot":"","sources":["../src/resources/datasets.ts"],"names":[],"mappings":""}

package/resources/datasets.js

@@ -1,30 +1,6 @@
 "use strict";
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Datasets = void 0;
-const resource_1 = require("../core/resource.js");
-const uploads_1 = require("../internal/uploads.js");
-const path_1 = require("../internal/utils/path.js");
-class Datasets extends resource_1.APIResource {
-    /**
-     * List dataset files
-     */
-    list(query, options) {
-        return this._client.get('/datasets', { query, ...options });
-    }
-    /**
-     * Delete dataset file
-     */
-    delete(filename, params, options) {
-        const { userContext } = params;
-        return this._client.delete((0, path_1.path) `/datasets/${filename}`, { query: { userContext }, ...options });
-    }
-    /**
-     * Upload dataset file
-     */
-    upload(body, options) {
-        return this._client.post('/datasets', (0, uploads_1.multipartFormRequestOptions)({ body, ...options }, this._client));
-    }
-}
-exports.Datasets = Datasets;
+const tslib_1 = require("../internal/tslib.js");
+tslib_1.__exportStar(require("./datasets/index.js"), exports);
 //# sourceMappingURL=datasets.js.map

package/resources/datasets.js.map

@@ -1 +1 @@
-{"version":3,"file":"datasets.js","sourceRoot":"","sources":["../src/resources/datasets.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C,oDAAkE;AAClE,oDAA8C;AAE9C,MAAa,QAAS,SAAQ,sBAAW;IACvC;;OAEG;IACH,IAAI,CAAC,KAAwB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,MAAM,CACJ,QAAgB,EAChB,MAA2B,EAC3B,OAAwB;QAExB,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,aAAa,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClG,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,IAAA,qCAA2B,EAAC,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACzG,CAAC;CACF;AA1BD,4BA0BC"}
+{"version":3,"file":"datasets.js","sourceRoot":"","sources":["../src/resources/datasets.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,8DAAiC"}

package/resources/datasets.mjs

@@ -1,26 +1,3 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-import { APIResource } from "../core/resource.mjs";
-import { multipartFormRequestOptions } from "../internal/uploads.mjs";
-import { path } from "../internal/utils/path.mjs";
-export class Datasets extends APIResource {
-    /**
-     * List dataset files
-     */
-    list(query, options) {
-        return this._client.get('/datasets', { query, ...options });
-    }
-    /**
-     * Delete dataset file
-     */
-    delete(filename, params, options) {
-        const { userContext } = params;
-        return this._client.delete(path `/datasets/${filename}`, { query: { userContext }, ...options });
-    }
-    /**
-     * Upload dataset file
-     */
-    upload(body, options) {
-        return this._client.post('/datasets', multipartFormRequestOptions({ body, ...options }, this._client));
-    }
-}
+export * from "./datasets/index.mjs";
 //# sourceMappingURL=datasets.mjs.map

package/resources/datasets.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"datasets.mjs","sourceRoot":"","sources":["../src/resources/datasets.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAIf,EAAE,2BAA2B,EAAE;OAC/B,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;OAEG;IACH,IAAI,CAAC,KAAwB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,MAAM,CACJ,QAAgB,EAChB,MAA2B,EAC3B,OAAwB;QAExB,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,aAAa,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClG,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,2BAA2B,CAAC,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACzG,CAAC;CACF"}
+{"version":3,"file":"datasets.mjs","sourceRoot":"","sources":["../src/resources/datasets.ts"],"names":[],"mappings":"AAAA,sFAAsF"}

package/resources/index.d.mts

@@ -1,5 +1,5 @@
 export { Agents } from "./agents/agents.mjs";
 export { Conversations, type InconvoConversation, type ConversationCreateResponse, type ConversationListResponse, type ConversationCreateParams, type ConversationListParams, type ConversationListResponsesConversationsCursor, } from "./conversations/conversations.mjs";
-export { Datasets, type DatasetListResponse, type DatasetDeleteResponse, type DatasetUploadResponse, type DatasetListParams, type DatasetDeleteParams, type DatasetUploadParams, } from "./datasets.mjs";
+export { Datasets } from "./datasets/datasets.mjs";
 export { McpServers } from "./mcp-servers/mcp-servers.mjs";
 //# sourceMappingURL=index.d.mts.map

package/resources/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"OAEO,EAAE,MAAM,EAAE;OACV,EACL,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,4CAA4C,GAClD;OACM,EACL,QAAQ,EACR,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,GACzB;OACM,EAAE,UAAU,EAAE"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"OAEO,EAAE,MAAM,EAAE;OACV,EACL,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,4CAA4C,GAClD;OACM,EAAE,QAAQ,EAAE;OACZ,EAAE,UAAU,EAAE"}

package/resources/index.d.ts

@@ -1,5 +1,5 @@
 export { Agents } from "./agents/agents.js";
 export { Conversations, type InconvoConversation, type ConversationCreateResponse, type ConversationListResponse, type ConversationCreateParams, type ConversationListParams, type ConversationListResponsesConversationsCursor, } from "./conversations/conversations.js";
-export { Datasets, type DatasetListResponse, type DatasetDeleteResponse, type DatasetUploadResponse, type DatasetListParams, type DatasetDeleteParams, type DatasetUploadParams, } from "./datasets.js";
+export { Datasets } from "./datasets/datasets.js";
 export { McpServers } from "./mcp-servers/mcp-servers.js";
 //# sourceMappingURL=index.d.ts.map

package/resources/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"OAEO,EAAE,MAAM,EAAE;OACV,EACL,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,4CAA4C,GAClD;OACM,EACL,QAAQ,EACR,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,GACzB;OACM,EAAE,UAAU,EAAE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"OAEO,EAAE,MAAM,EAAE;OACV,EACL,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,4CAA4C,GAClD;OACM,EAAE,QAAQ,EAAE;OACZ,EAAE,UAAU,EAAE"}

package/resources/index.js

@@ -6,7 +6,7 @@ var agents_1 = require("./agents/agents.js");
 Object.defineProperty(exports, "Agents", { enumerable: true, get: function () { return agents_1.Agents; } });
 var conversations_1 = require("./conversations/conversations.js");
 Object.defineProperty(exports, "Conversations", { enumerable: true, get: function () { return conversations_1.Conversations; } });
-var datasets_1 = require("./datasets.js");
+var datasets_1 = require("./datasets/datasets.js");
 Object.defineProperty(exports, "Datasets", { enumerable: true, get: function () { return datasets_1.Datasets; } });
 var mcp_servers_1 = require("./mcp-servers/mcp-servers.js");
 Object.defineProperty(exports, "McpServers", { enumerable: true, get: function () { return mcp_servers_1.McpServers; } });

package/resources/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,6CAAyC;AAAhC,gGAAA,MAAM,OAAA;AACf,kEAQuC;AAPrC,8GAAA,aAAa,OAAA;AAQf,0CAQoB;AAPlB,oGAAA,QAAQ,OAAA;AAQV,4DAAuD;AAA9C,yGAAA,UAAU,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,6CAAyC;AAAhC,gGAAA,MAAM,OAAA;AACf,kEAQuC;AAPrC,8GAAA,aAAa,OAAA;AAQf,mDAA+C;AAAtC,oGAAA,QAAQ,OAAA;AACjB,4DAAuD;AAA9C,yGAAA,UAAU,OAAA"}

package/resources/index.mjs

@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 export { Agents } from "./agents/agents.mjs";
 export { Conversations, } from "./conversations/conversations.mjs";
-export { Datasets, } from "./datasets.mjs";
+export { Datasets } from "./datasets/datasets.mjs";
 export { McpServers } from "./mcp-servers/mcp-servers.mjs";
 //# sourceMappingURL=index.mjs.map

package/resources/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,MAAM,EAAE;OACV,EACL,aAAa,GAOd;OACM,EACL,QAAQ,GAOT;OACM,EAAE,UAAU,EAAE"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,MAAM,EAAE;OACV,EACL,aAAa,GAOd;OACM,EAAE,QAAQ,EAAE;OACZ,EAAE,UAAU,EAAE"}

package/src/client.ts

@@ -19,15 +19,6 @@ import { AbstractPage, type ConversationsCursorParams, ConversationsCursorRespon
 import * as Uploads from './core/uploads';
 import * as API from './resources/index';
 import { APIPromise } from './core/api-promise';
-import {
-  DatasetDeleteParams,
-  DatasetDeleteResponse,
-  DatasetListParams,
-  DatasetListResponse,
-  DatasetUploadParams,
-  DatasetUploadResponse,
-  Datasets,
-} from './resources/datasets';
 import { Agents } from './resources/agents/agents';
 import {
   ConversationCreateParams,
@@ -38,6 +29,7 @@ import {
   Conversations,
   InconvoConversation,
 } from './resources/conversations/conversations';
+import { Datasets } from './resources/datasets/datasets';
 import { McpServers } from './resources/mcp-servers/mcp-servers';
 import { type Fetch } from './internal/builtin-types';
 import { HeadersLike, NullableHeaders, buildHeaders } from './internal/headers';
@@ -773,13 +765,5 @@ export declare namespace Inconvo {
 
   export { Agents as Agents };
 
-  export {
-    Datasets as Datasets,
-    type DatasetListResponse as DatasetListResponse,
-    type DatasetDeleteResponse as DatasetDeleteResponse,
-    type DatasetUploadResponse as DatasetUploadResponse,
-    type DatasetListParams as DatasetListParams,
-    type DatasetDeleteParams as DatasetDeleteParams,
-    type DatasetUploadParams as DatasetUploadParams,
-  };
+  export { Datasets as Datasets };
 }

package/src/resources/conversations/conversations.ts

@@ -21,6 +21,13 @@ export class Conversations extends APIResource {
 
   /**
    * Create conversation
+   *
+   * @example
+   * ```ts
+   * const conversation = await client.conversations.create({
+   *   userIdentifier: 'user_123',
+   * });
+   * ```
    */
   create(body: ConversationCreateParams, options?: RequestOptions): APIPromise<ConversationCreateResponse> {
     return this._client.post('/conversations', { body, ...options });
@@ -28,6 +35,12 @@ export class Conversations extends APIResource {
 
   /**
    * Retrieve conversation
+   *
+   * @example
+   * ```ts
+   * const inconvoConversation =
+   *   await client.conversations.retrieve('id');
+   * ```
    */
   retrieve(id: string, options?: RequestOptions): APIPromise<InconvoConversation> {
     return this._client.get(path`/conversations/${id}`, options);
@@ -35,6 +48,14 @@ export class Conversations extends APIResource {
 
   /**
    * List conversations
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const conversationListResponse of client.conversations.list()) {
+   *   // ...
+   * }
+   * ```
    */
   list(
     query: ConversationListParams | null | undefined = {},
@@ -55,6 +76,11 @@ export interface InconvoConversation {
   messages: Array<InconvoConversation.Message>;
 
   userContext: { [key: string]: string | number };
+
+  /**
+   * Unique identifier for the end-user (may be null for legacy conversations)
+   */
+  userIdentifier?: string | null;
 }
 
 export namespace InconvoConversation {
@@ -89,13 +115,24 @@ export interface ConversationListResponse {
   title: string;
 
   userContext: { [key: string]: string | number };
+
+  /**
+   * Unique identifier for the end-user (may be null for legacy conversations)
+   */
+  userIdentifier?: string | null;
 }
 
 export interface ConversationCreateParams {
   /**
-   * Context key-values used for tenancy / filtering.
+   * Unique identifier for the end-user (1-256 chars). Allowed characters:
+   * alphanumeric, underscore, hyphen, colon, period, at symbol.
    */
-  userContext: { [key: string]: unknown };
+  userIdentifier: string;
+
+  /**
+   * Optional context key-values for additional filtering/tenancy.
+   */
+  userContext?: { [key: string]: unknown };
 }
 
 export interface ConversationListParams extends ConversationsCursorParams {
@@ -104,6 +141,11 @@ export interface ConversationListParams extends ConversationsCursorParams {
    * /conversations?userContext[userId]=42&userContext[orgId]=12
    */
   userContext?: { [key: string]: string | number };
+
+  /**
+   * Filter by user identifier
+   */
+  userIdentifier?: string;
 }
 
 Conversations.Response = Response;

package/src/resources/conversations/response/feedback.ts

@@ -8,6 +8,15 @@ import { path } from '../../../internal/utils/path';
 export class FeedbackResource extends APIResource {
   /**
    * Create feedback
+   *
+   * @example
+   * ```ts
+   * const feedback =
+   *   await client.conversations.response.feedback.create(
+   *     'response_id',
+   *     { id: 'id', rating: 'positive' },
+   *   );
+   * ```
    */
   create(responseID: string, params: FeedbackCreateParams, options?: RequestOptions): APIPromise<Feedback> {
     const { id, ...body } = params;
@@ -19,6 +28,15 @@ export class FeedbackResource extends APIResource {
 
   /**
    * Update feedback
+   *
+   * @example
+   * ```ts
+   * const feedback =
+   *   await client.conversations.response.feedback.update(
+   *     'feedback_id',
+   *     { id: 'id', response_id: 'response_id' },
+   *   );
+   * ```
    */
   update(feedbackID: string, params: FeedbackUpdateParams, options?: RequestOptions): APIPromise<Feedback> {
     const { id, response_id, ...body } = params;

package/src/resources/conversations/response/response.ts

@@ -14,6 +14,14 @@ export class Response extends APIResource {
 
   /**
    * Create response (sync or streamed)
+   *
+   * @example
+   * ```ts
+   * const response = await client.conversations.response.create(
+   *   'id',
+   *   { message: 'message' },
+   * );
+   * ```
    */
   create(
     id: string,
@@ -43,6 +51,15 @@ export class Response extends APIResource {
 
   /**
    * Get a response
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.conversations.response.retrieve(
+   *     'response_id',
+   *     { conversation_id: 'conversation_id' },
+   *   );
+   * ```
    */
   retrieve(
     responseID: string,

package/src/resources/datasets/context.ts

@@ -0,0 +1,153 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { type Uploadable } from '../../core/uploads';
+import { RequestOptions } from '../../internal/request-options';
+import { multipartFormRequestOptions } from '../../internal/uploads';
+import { path } from '../../internal/utils/path';
+
+export class Context extends APIResource {
+  /**
+   * List all dataset files scoped to a context value. These files are shared with
+   * all users who have this context value.
+   *
+   * @example
+   * ```ts
+   * const contexts = await client.datasets.context.list(
+   *   'org_456',
+   *   { contextKey: 'orgId' },
+   * );
+   * ```
+   */
+  list(
+    contextValue: string,
+    params: ContextListParams,
+    options?: RequestOptions,
+  ): APIPromise<ContextListResponse> {
+    const { contextKey } = params;
+    return this._client.get(path`/datasets/context/${contextKey}/${contextValue}`, options);
+  }
+
+  /**
+   * Delete a dataset file scoped to a context value.
+   *
+   * @example
+   * ```ts
+   * const context = await client.datasets.context.delete(
+   *   'shared_data.csv',
+   *   { contextKey: 'orgId', contextValue: 'org_456' },
+   * );
+   * ```
+   */
+  delete(
+    filename: string,
+    params: ContextDeleteParams,
+    options?: RequestOptions,
+  ): APIPromise<ContextDeleteResponse> {
+    const { contextKey, contextValue } = params;
+    return this._client.delete(path`/datasets/context/${contextKey}/${contextValue}/${filename}`, options);
+  }
+
+  /**
+   * Upload a dataset file scoped to a context value. This file will be shared with
+   * all users who have this context value.
+   *
+   * @example
+   * ```ts
+   * const response = await client.datasets.context.upload(
+   *   'org_456',
+   *   {
+   *     contextKey: 'orgId',
+   *     file: fs.createReadStream('path/to/file'),
+   *   },
+   * );
+   * ```
+   */
+  upload(
+    contextValue: string,
+    params: ContextUploadParams,
+    options?: RequestOptions,
+  ): APIPromise<ContextUploadResponse> {
+    const { contextKey, ...body } = params;
+    return this._client.post(
+      path`/datasets/context/${contextKey}/${contextValue}`,
+      multipartFormRequestOptions({ body, ...options }, this._client),
+    );
+  }
+}
+
+export interface ContextListResponse {
+  files: Array<string>;
+}
+
+export interface ContextDeleteResponse {
+  file: string;
+
+  success: boolean;
+
+  error?: string;
+}
+
+export interface ContextUploadResponse {
+  file: ContextUploadResponse.File;
+
+  error?: string;
+}
+
+export namespace ContextUploadResponse {
+  export interface File {
+    name: string;
+
+    path: string;
+
+    size: number;
+  }
+}
+
+export interface ContextListParams {
+  /**
+   * The context key (e.g., "orgId", "teamId")
+   */
+  contextKey: string;
+}
+
+export interface ContextDeleteParams {
+  /**
+   * The context key (e.g., "orgId", "teamId")
+   */
+  contextKey: string;
+
+  /**
+   * The context value
+   */
+  contextValue: string;
+}
+
+export interface ContextUploadParams {
+  /**
+   * Path param: The context key (e.g., "orgId", "teamId")
+   */
+  contextKey: string;
+
+  /**
+   * Body param: The file to upload (CSV or JSON, max 10MB)
+   */
+  file: Uploadable;
+
+  /**
+   * Body param: Optional notes or description for the dataset
+   */
+  notes?: string;
+}
+
+export declare namespace Context {
+  export {
+    type ContextListResponse as ContextListResponse,
+    type ContextDeleteResponse as ContextDeleteResponse,
+    type ContextUploadResponse as ContextUploadResponse,
+    type ContextListParams as ContextListParams,
+    type ContextDeleteParams as ContextDeleteParams,
+    type ContextUploadParams as ContextUploadParams,
+  };
+}

package/src/resources/datasets/datasets.ts

@@ -0,0 +1,51 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as ContextAPI from './context';
+import {
+  Context,
+  ContextDeleteParams,
+  ContextDeleteResponse,
+  ContextListParams,
+  ContextListResponse,
+  ContextUploadParams,
+  ContextUploadResponse,
+} from './context';
+import * as UserAPI from './user';
+import {
+  User,
+  UserDeleteParams,
+  UserDeleteResponse,
+  UserListResponse,
+  UserUploadParams,
+  UserUploadResponse,
+} from './user';
+
+export class Datasets extends APIResource {
+  user: UserAPI.User = new UserAPI.User(this._client);
+  context: ContextAPI.Context = new ContextAPI.Context(this._client);
+}
+
+Datasets.User = User;
+Datasets.Context = Context;
+
+export declare namespace Datasets {
+  export {
+    User as User,
+    type UserListResponse as UserListResponse,
+    type UserDeleteResponse as UserDeleteResponse,
+    type UserUploadResponse as UserUploadResponse,
+    type UserDeleteParams as UserDeleteParams,
+    type UserUploadParams as UserUploadParams,
+  };
+
+  export {
+    Context as Context,
+    type ContextListResponse as ContextListResponse,
+    type ContextDeleteResponse as ContextDeleteResponse,
+    type ContextUploadResponse as ContextUploadResponse,
+    type ContextListParams as ContextListParams,
+    type ContextDeleteParams as ContextDeleteParams,
+    type ContextUploadParams as ContextUploadParams,
+  };
+}

package/src/resources/datasets/index.ts

@@ -0,0 +1,20 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Context,
+  type ContextListResponse,
+  type ContextDeleteResponse,
+  type ContextUploadResponse,
+  type ContextListParams,
+  type ContextDeleteParams,
+  type ContextUploadParams,
+} from './context';
+export { Datasets } from './datasets';
+export {
+  User,
+  type UserListResponse,
+  type UserDeleteResponse,
+  type UserUploadResponse,
+  type UserDeleteParams,
+  type UserUploadParams,
+} from './user';