@inconvoai/node 0.3.1 → 0.5.0

package/src/resources/{conversations → agents/conversations}/response/response.ts

@@ -1,61 +1,87 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../../../core/resource';
+import { APIResource } from '../../../../core/resource';
 import * as ResponseAPI from './response';
 import * as FeedbackAPI from './feedback';
 import { Feedback, FeedbackCreateParams, FeedbackResource, FeedbackUpdateParams } from './feedback';
-import { APIPromise } from '../../../core/api-promise';
-import { RequestOptions } from '../../../internal/request-options';
-import { path } from '../../../internal/utils/path';
-import { SSEStream, createSSEStream } from '../../../core/sse-stream';
+import { APIPromise } from '../../../../core/api-promise';
+import { RequestOptions } from '../../../../internal/request-options';
+import { path } from '../../../../internal/utils/path';
+import { SSEStream, createSSEStream } from '../../../../core/sse-stream';
 
 export class Response extends APIResource {
   feedback: FeedbackAPI.FeedbackResource = new FeedbackAPI.FeedbackResource(this._client);
 
   /**
    * Create response (sync or streamed)
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.agents.conversations.response.create('id', {
+   *     agentId: 'agentId',
+   *     message: 'message',
+   *   });
+   * ```
    */
   create(
     id: string,
-    body: ResponseCreateParams & { stream: true },
+    params: ResponseCreateParams & { stream: true },
     options?: RequestOptions,
   ): SSEStream<ResponseStreamEvent>;
   create(
     id: string,
-    body: ResponseCreateParams & { stream?: false },
+    params: ResponseCreateParams & { stream?: false },
     options?: RequestOptions,
   ): APIPromise<ResponseCreateResponse>;
   create(
     id: string,
-    body: ResponseCreateParams,
+    params: ResponseCreateParams,
     options?: RequestOptions,
   ): APIPromise<ResponseCreateResponse>;
   create(
     id: string,
-    body: ResponseCreateParams,
+    params: ResponseCreateParams,
     options?: RequestOptions,
   ): APIPromise<ResponseCreateResponse> | SSEStream<ResponseStreamEvent> {
+    const { agentId, ...body } = params;
     if (body.stream === true) {
-      return this._createStreaming(id, body, options);
+      return this._createStreaming(id, agentId, body, options);
     }
-    return this._client.post(path`/conversations/${id}/response`, { body, ...options });
+    return this._client.post(path`/agents/${agentId}/conversations/${id}/response`, { body, ...options });
   }
 
   /**
    * Get a response
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.agents.conversations.response.retrieve(
+   *     'response_id',
+   *     {
+   *       agentId: 'agentId',
+   *       conversation_id: 'conversation_id',
+   *     },
+   *   );
+   * ```
    */
   retrieve(
     responseID: string,
     params: ResponseRetrieveParams,
     options?: RequestOptions,
   ): APIPromise<ResponseRetrieveResponse> {
-    const { conversation_id } = params;
-    return this._client.get(path`/conversations/${conversation_id}/response/${responseID}`, options);
+    const { agentId, conversation_id } = params;
+    return this._client.get(
+      path`/agents/${agentId}/conversations/${conversation_id}/response/${responseID}`,
+      options,
+    );
   }
 
   private _createStreaming(
     id: string,
-    body: ResponseCreateParams,
+    agentId: string,
+    body: Omit<ResponseCreateParams, 'agentId'>,
     options?: RequestOptions,
   ): SSEStream<ResponseStreamEvent> {
     // Create a controller for aborting the request if needed
@@ -73,7 +99,7 @@ export class Response extends APIResource {
     };
 
     // When __binaryResponse is true, post() returns the raw Response directly
-    const responsePromise = this._client.post(path`/conversations/${id}/response`, {
+    const responsePromise = this._client.post(path`/agents/${agentId}/conversations/${id}/response`, {
       body,
       ...requestOptions,
     }) as Promise<globalThis.Response>;
@@ -210,16 +236,29 @@ export type ResponseStreamEvent = ResponseCreatedEvent | ResponseProgressEvent |
 export type ResponseCreateStreamResponse = SSEStream<ResponseStreamEvent>;
 
 export interface ResponseCreateParams {
+  /**
+   * Path param: The unique identifier of the agent
+   */
+  agentId: string;
+
+  /**
+   * Body param
+   */
   message: string;
 
   /**
-   * If true and the client sets `Accept: text/event-stream`, the API returns an SSE
-   * stream instead of a single JSON body.
+   * Body param: If true and the client sets `Accept: text/event-stream`, the API
+   * returns an SSE stream instead of a single JSON body.
    */
   stream?: boolean;
 }
 
 export interface ResponseRetrieveParams {
+  /**
+   * The unique identifier of the agent
+   */
+  agentId: string;
+
   conversation_id: string;
 }
 

package/src/resources/agents/data-summary.ts

@@ -3,13 +3,20 @@
 import { APIResource } from '../../core/resource';
 import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
 
 export class DataSummary extends APIResource {
   /**
    * Retrieve a summary of data available to the agent
+   *
+   * @example
+   * ```ts
+   * const dataSummary =
+   *   await client.agents.dataSummary.retrieve('agentId');
+   * ```
    */
-  retrieve(options?: RequestOptions): APIPromise<DataSummaryRetrieveResponse> {
-    return this._client.get('/agents/data-summary', options);
+  retrieve(agentID: string, options?: RequestOptions): APIPromise<DataSummaryRetrieveResponse> {
+    return this._client.get(path`/agents/${agentID}/data-summary`, options);
   }
 }
 

package/src/resources/agents/datasets/context.ts

@@ -0,0 +1,174 @@
+// 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.agents.datasets.context.list(
+   *   'org_456',
+   *   { agentId: 'agentId', contextKey: 'orgId' },
+   * );
+   * ```
+   */
+  list(
+    contextValue: string,
+    params: ContextListParams,
+    options?: RequestOptions,
+  ): APIPromise<ContextListResponse> {
+    const { agentId, contextKey } = params;
+    return this._client.get(path`/agents/${agentId}/datasets/context/${contextKey}/${contextValue}`, options);
+  }
+
+  /**
+   * Delete a dataset file scoped to a context value.
+   *
+   * @example
+   * ```ts
+   * const context = await client.agents.datasets.context.delete(
+   *   'shared_data.csv',
+   *   {
+   *     agentId: 'agentId',
+   *     contextKey: 'orgId',
+   *     contextValue: 'org_456',
+   *   },
+   * );
+   * ```
+   */
+  delete(
+    filename: string,
+    params: ContextDeleteParams,
+    options?: RequestOptions,
+  ): APIPromise<ContextDeleteResponse> {
+    const { agentId, contextKey, contextValue } = params;
+    return this._client.delete(
+      path`/agents/${agentId}/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.agents.datasets.context.upload('org_456', {
+   *     agentId: 'agentId',
+   *     contextKey: 'orgId',
+   *     file: fs.createReadStream('path/to/file'),
+   *   });
+   * ```
+   */
+  upload(
+    contextValue: string,
+    params: ContextUploadParams,
+    options?: RequestOptions,
+  ): APIPromise<ContextUploadResponse> {
+    const { agentId, contextKey, ...body } = params;
+    return this._client.post(
+      path`/agents/${agentId}/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 unique identifier of the agent
+   */
+  agentId: string;
+
+  /**
+   * The context key (e.g., "orgId", "teamId")
+   */
+  contextKey: string;
+}
+
+export interface ContextDeleteParams {
+  /**
+   * The unique identifier of the agent
+   */
+  agentId: string;
+
+  /**
+   * The context key (e.g., "orgId", "teamId")
+   */
+  contextKey: string;
+
+  /**
+   * The context value
+   */
+  contextValue: string;
+}
+
+export interface ContextUploadParams {
+  /**
+   * Path param: The unique identifier of the agent
+   */
+  agentId: string;
+
+  /**
+   * 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/agents/datasets/datasets.ts

@@ -0,0 +1,53 @@
+// 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,
+  UserListParams,
+  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 UserListParams as UserListParams,
+    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/agents/datasets/index.ts

@@ -0,0 +1,21 @@
+// 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 UserListParams,
+  type UserDeleteParams,
+  type UserUploadParams,
+} from './user';

package/src/resources/agents/datasets/user.ts

@@ -0,0 +1,151 @@
+// 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 User extends APIResource {
+  /**
+   * List all dataset files scoped to a specific user.
+   *
+   * @example
+   * ```ts
+   * const users = await client.agents.datasets.user.list(
+   *   'user_123',
+   *   { agentId: 'agentId' },
+   * );
+   * ```
+   */
+  list(
+    userIdentifier: string,
+    params: UserListParams,
+    options?: RequestOptions,
+  ): APIPromise<UserListResponse> {
+    const { agentId } = params;
+    return this._client.get(path`/agents/${agentId}/datasets/user/${userIdentifier}`, options);
+  }
+
+  /**
+   * Delete a dataset file scoped to a specific user.
+   *
+   * @example
+   * ```ts
+   * const user = await client.agents.datasets.user.delete(
+   *   'data.csv',
+   *   { agentId: 'agentId', userIdentifier: 'user_123' },
+   * );
+   * ```
+   */
+  delete(
+    filename: string,
+    params: UserDeleteParams,
+    options?: RequestOptions,
+  ): APIPromise<UserDeleteResponse> {
+    const { agentId, userIdentifier } = params;
+    return this._client.delete(path`/agents/${agentId}/datasets/user/${userIdentifier}/${filename}`, options);
+  }
+
+  /**
+   * Upload a dataset file scoped to a specific user.
+   *
+   * @example
+   * ```ts
+   * const response = await client.agents.datasets.user.upload(
+   *   'user_123',
+   *   {
+   *     agentId: 'agentId',
+   *     file: fs.createReadStream('path/to/file'),
+   *   },
+   * );
+   * ```
+   */
+  upload(
+    userIdentifier: string,
+    params: UserUploadParams,
+    options?: RequestOptions,
+  ): APIPromise<UserUploadResponse> {
+    const { agentId, ...body } = params;
+    return this._client.post(
+      path`/agents/${agentId}/datasets/user/${userIdentifier}`,
+      multipartFormRequestOptions({ body, ...options }, this._client),
+    );
+  }
+}
+
+export interface UserListResponse {
+  files: Array<string>;
+}
+
+export interface UserDeleteResponse {
+  file: string;
+
+  success: boolean;
+
+  error?: string;
+}
+
+export interface UserUploadResponse {
+  file: UserUploadResponse.File;
+
+  error?: string;
+}
+
+export namespace UserUploadResponse {
+  export interface File {
+    name: string;
+
+    path: string;
+
+    size: number;
+  }
+}
+
+export interface UserListParams {
+  /**
+   * The unique identifier of the agent
+   */
+  agentId: string;
+}
+
+export interface UserDeleteParams {
+  /**
+   * The unique identifier of the agent
+   */
+  agentId: string;
+
+  /**
+   * The user identifier
+   */
+  userIdentifier: string;
+}
+
+export interface UserUploadParams {
+  /**
+   * Path param: The unique identifier of the agent
+   */
+  agentId: 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 User {
+  export {
+    type UserListResponse as UserListResponse,
+    type UserDeleteResponse as UserDeleteResponse,
+    type UserUploadResponse as UserUploadResponse,
+    type UserListParams as UserListParams,
+    type UserDeleteParams as UserDeleteParams,
+    type UserUploadParams as UserUploadParams,
+  };
+}

package/src/resources/agents/datasets.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './datasets/index';

package/src/resources/agents/index.ts

@@ -1,4 +1,16 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 export { Agents } from './agents';
+export {
+  Conversations,
+  type InconvoConversation,
+  type ConversationCreateResponse,
+  type ConversationListResponse,
+  type ConversationCreateParams,
+  type ConversationRetrieveParams,
+  type ConversationListParams,
+  type ConversationListResponsesConversationsCursor,
+} from './conversations/index';
 export { DataSummary, type DataSummaryRetrieveResponse } from './data-summary';
+export { Datasets } from './datasets/index';
+export { McpServers } from './mcp-servers/index';

package/src/resources/{mcp-servers → agents/mcp-servers}/index.ts

@@ -4,6 +4,7 @@ export { McpServers } from './mcp-servers';
 export {
   Tenants,
   type TenantCreateResponse,
+  type TenantDeleteResponse,
   type TenantCreateParams,
   type TenantDeleteParams,
 } from './tenants';

package/src/resources/{mcp-servers → agents/mcp-servers}/mcp-servers.ts

@@ -1,8 +1,14 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../../core/resource';
+import { APIResource } from '../../../core/resource';
 import * as TenantsAPI from './tenants';
-import { TenantCreateParams, TenantCreateResponse, TenantDeleteParams, Tenants } from './tenants';
+import {
+  TenantCreateParams,
+  TenantCreateResponse,
+  TenantDeleteParams,
+  TenantDeleteResponse,
+  Tenants,
+} from './tenants';
 
 export class McpServers extends APIResource {
   tenants: TenantsAPI.Tenants = new TenantsAPI.Tenants(this._client);
@@ -14,6 +20,7 @@ export declare namespace McpServers {
   export {
     Tenants as Tenants,
     type TenantCreateResponse as TenantCreateResponse,
+    type TenantDeleteResponse as TenantDeleteResponse,
     type TenantCreateParams as TenantCreateParams,
     type TenantDeleteParams as TenantDeleteParams,
   };