cloneforce 0.0.2

package/src/resources/v1/clones/activity.ts

@@ -0,0 +1,112 @@
+// 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 { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+/**
+ * Task run history
+ */
+export class Activity extends APIResource {
+  /**
+   * Returns a single task run with skill execution details.
+   */
+  retrieve(
+    activityID: string,
+    params: ActivityRetrieveParams,
+    options?: RequestOptions,
+  ): APIPromise<ActivityRetrieveResponse> {
+    const { cloneId } = params;
+    return this._client.get(path`/api/v1/clones/${cloneId}/activity/${activityID}`, options);
+  }
+
+  /**
+   * Returns all task run records for a clone, ordered by creation date descending.
+   */
+  list(cloneID: string, options?: RequestOptions): APIPromise<ActivityListResponse> {
+    return this._client.get(path`/api/v1/clones/${cloneID}/activity`, options);
+  }
+
+  /**
+   * Delete a task run
+   */
+  delete(
+    activityID: string,
+    params: ActivityDeleteParams,
+    options?: RequestOptions,
+  ): APIPromise<ActivityDeleteResponse> {
+    const { cloneId } = params;
+    return this._client.delete(path`/api/v1/clones/${cloneId}/activity/${activityID}`, options);
+  }
+}
+
+export interface ActivityRetrieveResponse {
+  id: string;
+
+  createdAt: string;
+
+  isSuccess: boolean;
+
+  skillCount: number;
+
+  taskId: string;
+
+  response?: string;
+
+  skills?: Array<ActivityRetrieveResponse.Skill>;
+
+  taskTitle?: string;
+}
+
+export namespace ActivityRetrieveResponse {
+  export interface Skill {
+    isSuccess: boolean;
+
+    skillName: string;
+
+    result?: string;
+  }
+}
+
+export interface ActivityListResponse {
+  data: Array<ActivityListResponse.Data>;
+}
+
+export namespace ActivityListResponse {
+  export interface Data {
+    id: string;
+
+    createdAt: string;
+
+    isSuccess: boolean;
+
+    taskId: string;
+
+    response?: string;
+
+    taskTitle?: string;
+  }
+}
+
+export interface ActivityDeleteResponse {
+  deleted: true;
+}
+
+export interface ActivityRetrieveParams {
+  cloneId: string;
+}
+
+export interface ActivityDeleteParams {
+  cloneId: string;
+}
+
+export declare namespace Activity {
+  export {
+    type ActivityRetrieveResponse as ActivityRetrieveResponse,
+    type ActivityListResponse as ActivityListResponse,
+    type ActivityDeleteResponse as ActivityDeleteResponse,
+    type ActivityRetrieveParams as ActivityRetrieveParams,
+    type ActivityDeleteParams as ActivityDeleteParams,
+  };
+}

package/src/resources/v1/clones/clones.ts

@@ -0,0 +1,223 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as ActivityAPI from './activity';
+import {
+  Activity,
+  ActivityDeleteParams,
+  ActivityDeleteResponse,
+  ActivityListResponse,
+  ActivityRetrieveParams,
+  ActivityRetrieveResponse,
+} from './activity';
+import * as FilesAPI from './files';
+import {
+  FileCreateParams,
+  FileDeleteParams,
+  FileDeleteResponse,
+  FileListResponse,
+  FileRetrieveParams,
+  Files,
+  KBFileSummary,
+} from './files';
+import * as GalleryAPI from './gallery';
+import {
+  Gallery,
+  GalleryCreateParams,
+  GalleryDeleteParams,
+  GalleryDeleteResponse,
+  GalleryItemSummary,
+  GalleryListParams,
+  GalleryListResponse,
+  GalleryRetrieveParams,
+} from './gallery';
+import * as HeadshotAPI from './headshot';
+import { Headshot, HeadshotGenerateParams } from './headshot';
+import * as ProfileAPI from './profile';
+import { CloneHeadshot, CloneProfile, Profile, ProfilePatchAllParams } from './profile';
+import * as TasksAPI from './tasks';
+import {
+  TaskCreateParams,
+  TaskDeleteParams,
+  TaskDeleteResponse,
+  TaskListParams,
+  TaskListResponse,
+  TaskRecurrence,
+  TaskRetrieveParams,
+  TaskSummary,
+  TaskUpdateParams,
+  Tasks,
+} from './tasks';
+import * as VoiceAPI from './voice';
+import { GenerateRequest, GenerationStatus, Voice, VoiceGenerateParams } from './voice';
+import * as IntegrationsAPI from './integrations/integrations';
+import {
+  IntegrationDeleteParams,
+  IntegrationDeleteResponse,
+  IntegrationListParams,
+  IntegrationListResponse,
+  IntegrationPhoneParams,
+  IntegrationPhoneResponse,
+  IntegrationRetrieveParams,
+  IntegrationRetrieveSetupParams,
+  IntegrationRetrieveSetupResponse,
+  IntegrationSummary,
+  Integrations,
+} from './integrations/integrations';
+import * as SkillsAPI from './skills/skills';
+import {
+  SkillCreateParams,
+  SkillDeleteParams,
+  SkillDeleteResponse,
+  SkillListParams,
+  SkillListResponse,
+  SkillSummary,
+  SkillUpdateParams,
+  Skills,
+} from './skills/skills';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+
+/**
+ * Clone profile management and asset generation
+ */
+export class Clones extends APIResource {
+  profile: ProfileAPI.Profile = new ProfileAPI.Profile(this._client);
+  voice: VoiceAPI.Voice = new VoiceAPI.Voice(this._client);
+  headshot: HeadshotAPI.Headshot = new HeadshotAPI.Headshot(this._client);
+  skills: SkillsAPI.Skills = new SkillsAPI.Skills(this._client);
+  tasks: TasksAPI.Tasks = new TasksAPI.Tasks(this._client);
+  files: FilesAPI.Files = new FilesAPI.Files(this._client);
+  gallery: GalleryAPI.Gallery = new GalleryAPI.Gallery(this._client);
+  integrations: IntegrationsAPI.Integrations = new IntegrationsAPI.Integrations(this._client);
+  activity: ActivityAPI.Activity = new ActivityAPI.Activity(this._client);
+
+  /**
+   * Returns all clones in the organization, ordered by creation date descending.
+   */
+  list(options?: RequestOptions): APIPromise<CloneListResponse> {
+    return this._client.get('/api/v1/clones', options);
+  }
+}
+
+export interface CloneListResponse {
+  data: Array<CloneListResponse.Data>;
+}
+
+export namespace CloneListResponse {
+  export interface Data {
+    id: string;
+
+    createdAt: string;
+
+    generation: string;
+
+    name: string;
+
+    screenName: string;
+
+    status: string;
+
+    headshot?: ProfileAPI.CloneHeadshot;
+
+    isEnabled?: boolean;
+  }
+}
+
+Clones.Profile = Profile;
+Clones.Voice = Voice;
+Clones.Headshot = Headshot;
+Clones.Skills = Skills;
+Clones.Tasks = Tasks;
+Clones.Files = Files;
+Clones.Gallery = Gallery;
+Clones.Integrations = Integrations;
+Clones.Activity = Activity;
+
+export declare namespace Clones {
+  export { type CloneListResponse as CloneListResponse };
+
+  export {
+    Profile as Profile,
+    type CloneHeadshot as CloneHeadshot,
+    type CloneProfile as CloneProfile,
+    type ProfilePatchAllParams as ProfilePatchAllParams,
+  };
+
+  export {
+    Voice as Voice,
+    type GenerateRequest as GenerateRequest,
+    type GenerationStatus as GenerationStatus,
+    type VoiceGenerateParams as VoiceGenerateParams,
+  };
+
+  export { Headshot as Headshot, type HeadshotGenerateParams as HeadshotGenerateParams };
+
+  export {
+    Skills as Skills,
+    type SkillSummary as SkillSummary,
+    type SkillListResponse as SkillListResponse,
+    type SkillDeleteResponse as SkillDeleteResponse,
+    type SkillCreateParams as SkillCreateParams,
+    type SkillUpdateParams as SkillUpdateParams,
+    type SkillListParams as SkillListParams,
+    type SkillDeleteParams as SkillDeleteParams,
+  };
+
+  export {
+    Tasks as Tasks,
+    type TaskRecurrence as TaskRecurrence,
+    type TaskSummary as TaskSummary,
+    type TaskListResponse as TaskListResponse,
+    type TaskDeleteResponse as TaskDeleteResponse,
+    type TaskCreateParams as TaskCreateParams,
+    type TaskRetrieveParams as TaskRetrieveParams,
+    type TaskUpdateParams as TaskUpdateParams,
+    type TaskListParams as TaskListParams,
+    type TaskDeleteParams as TaskDeleteParams,
+  };
+
+  export {
+    Files as Files,
+    type KBFileSummary as KBFileSummary,
+    type FileListResponse as FileListResponse,
+    type FileDeleteResponse as FileDeleteResponse,
+    type FileCreateParams as FileCreateParams,
+    type FileRetrieveParams as FileRetrieveParams,
+    type FileDeleteParams as FileDeleteParams,
+  };
+
+  export {
+    Gallery as Gallery,
+    type GalleryItemSummary as GalleryItemSummary,
+    type GalleryListResponse as GalleryListResponse,
+    type GalleryDeleteResponse as GalleryDeleteResponse,
+    type GalleryCreateParams as GalleryCreateParams,
+    type GalleryRetrieveParams as GalleryRetrieveParams,
+    type GalleryListParams as GalleryListParams,
+    type GalleryDeleteParams as GalleryDeleteParams,
+  };
+
+  export {
+    Integrations as Integrations,
+    type IntegrationSummary as IntegrationSummary,
+    type IntegrationListResponse as IntegrationListResponse,
+    type IntegrationDeleteResponse as IntegrationDeleteResponse,
+    type IntegrationPhoneResponse as IntegrationPhoneResponse,
+    type IntegrationRetrieveSetupResponse as IntegrationRetrieveSetupResponse,
+    type IntegrationRetrieveParams as IntegrationRetrieveParams,
+    type IntegrationListParams as IntegrationListParams,
+    type IntegrationDeleteParams as IntegrationDeleteParams,
+    type IntegrationPhoneParams as IntegrationPhoneParams,
+    type IntegrationRetrieveSetupParams as IntegrationRetrieveSetupParams,
+  };
+
+  export {
+    Activity as Activity,
+    type ActivityRetrieveResponse as ActivityRetrieveResponse,
+    type ActivityListResponse as ActivityListResponse,
+    type ActivityDeleteResponse as ActivityDeleteResponse,
+    type ActivityRetrieveParams as ActivityRetrieveParams,
+    type ActivityDeleteParams as ActivityDeleteParams,
+  };
+}

package/src/resources/v1/clones/files.ts

@@ -0,0 +1,90 @@
+// 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 { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+/**
+ * Clone knowledge base file management
+ */
+export class Files extends APIResource {
+  /**
+   * **Not yet implemented.** Returns 501. Pending Pinecone migration.
+   */
+  create(cloneID: string, body: FileCreateParams, options?: RequestOptions): APIPromise<KBFileSummary> {
+    return this._client.post(path`/api/v1/clones/${cloneID}/files`, { body, ...options });
+  }
+
+  /**
+   * Get a knowledge base file
+   */
+  retrieve(fileID: string, params: FileRetrieveParams, options?: RequestOptions): APIPromise<KBFileSummary> {
+    const { cloneId } = params;
+    return this._client.get(path`/api/v1/clones/${cloneId}/files/${fileID}`, options);
+  }
+
+  /**
+   * List knowledge base files
+   */
+  list(cloneID: string, options?: RequestOptions): APIPromise<FileListResponse> {
+    return this._client.get(path`/api/v1/clones/${cloneID}/files`, options);
+  }
+
+  /**
+   * **Not yet implemented.** Returns 501. Pending Pinecone migration.
+   */
+  delete(fileID: string, params: FileDeleteParams, options?: RequestOptions): APIPromise<FileDeleteResponse> {
+    const { cloneId } = params;
+    return this._client.delete(path`/api/v1/clones/${cloneId}/files/${fileID}`, options);
+  }
+}
+
+export interface KBFileSummary {
+  id: string;
+
+  contentType: string;
+
+  createdAt: string;
+
+  name: string;
+
+  url: string;
+
+  uploadUrl?: string;
+}
+
+export interface FileListResponse {
+  data: Array<KBFileSummary>;
+}
+
+export interface FileDeleteResponse {
+  deleted: true;
+}
+
+export interface FileCreateParams {
+  url: string;
+
+  contentType?: string;
+
+  name?: string;
+}
+
+export interface FileRetrieveParams {
+  cloneId: string;
+}
+
+export interface FileDeleteParams {
+  cloneId: string;
+}
+
+export declare namespace Files {
+  export {
+    type KBFileSummary as KBFileSummary,
+    type FileListResponse as FileListResponse,
+    type FileDeleteResponse as FileDeleteResponse,
+    type FileCreateParams as FileCreateParams,
+    type FileRetrieveParams as FileRetrieveParams,
+    type FileDeleteParams as FileDeleteParams,
+  };
+}

package/src/resources/v1/clones/gallery.ts

@@ -0,0 +1,125 @@
+// 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 { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+/**
+ * Clone gallery media management
+ */
+export class Gallery extends APIResource {
+  /**
+   * Downloads media from the provided URL and adds it to the clone's gallery.
+   */
+  create(
+    cloneID: string,
+    body: GalleryCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<GalleryItemSummary> {
+    return this._client.post(path`/api/v1/clones/${cloneID}/gallery`, { body, ...options });
+  }
+
+  /**
+   * Get a gallery item
+   */
+  retrieve(
+    itemID: string,
+    params: GalleryRetrieveParams,
+    options?: RequestOptions,
+  ): APIPromise<GalleryItemSummary> {
+    const { cloneId } = params;
+    return this._client.get(path`/api/v1/clones/${cloneId}/gallery/${itemID}`, options);
+  }
+
+  /**
+   * List gallery items
+   */
+  list(
+    cloneID: string,
+    query: GalleryListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<GalleryListResponse> {
+    return this._client.get(path`/api/v1/clones/${cloneID}/gallery`, { query, ...options });
+  }
+
+  /**
+   * Delete a gallery item
+   */
+  delete(
+    itemID: string,
+    params: GalleryDeleteParams,
+    options?: RequestOptions,
+  ): APIPromise<GalleryDeleteResponse> {
+    const { cloneId } = params;
+    return this._client.delete(path`/api/v1/clones/${cloneId}/gallery/${itemID}`, options);
+  }
+}
+
+export interface GalleryItemSummary {
+  id: string;
+
+  createdAt: string;
+
+  name: string;
+
+  type: 'Video' | 'Audio' | 'Image';
+
+  updatedAt: string;
+
+  url: string;
+
+  description?: string;
+
+  isHeroVideo?: boolean;
+
+  thumbnailUrl?: string;
+}
+
+export interface GalleryListResponse {
+  data: Array<GalleryItemSummary>;
+}
+
+export interface GalleryDeleteResponse {
+  deleted: true;
+}
+
+export interface GalleryCreateParams {
+  /**
+   * URL of the media file to download and add to the gallery
+   */
+  mediaUrl: string;
+
+  type: 'Video' | 'Audio' | 'Image';
+
+  description?: string;
+
+  isHeroVideo?: boolean;
+}
+
+export interface GalleryRetrieveParams {
+  cloneId: string;
+}
+
+export interface GalleryListParams {
+  /**
+   * Filter by media type
+   */
+  type?: 'Video' | 'Audio' | 'Image';
+}
+
+export interface GalleryDeleteParams {
+  cloneId: string;
+}
+
+export declare namespace Gallery {
+  export {
+    type GalleryItemSummary as GalleryItemSummary,
+    type GalleryListResponse as GalleryListResponse,
+    type GalleryDeleteResponse as GalleryDeleteResponse,
+    type GalleryCreateParams as GalleryCreateParams,
+    type GalleryRetrieveParams as GalleryRetrieveParams,
+    type GalleryListParams as GalleryListParams,
+    type GalleryDeleteParams as GalleryDeleteParams,
+  };
+}

package/src/resources/v1/clones/headshot.ts

@@ -0,0 +1,41 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as VoiceAPI from './voice';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+/**
+ * Clone profile management and asset generation
+ */
+export class Headshot extends APIResource {
+  /**
+   * Triggers asynchronous headshot regeneration for a clone. Returns immediately
+   * with 202 Accepted. Poll `GET /clones/{cloneId}/profile` and check
+   * `state.headshot` for progress.
+   *
+   * An optional request body can include `additionalInstructions` to nudge the
+   * appearance (e.g. "longer hair", "wearing glasses"). An empty body performs a
+   * standard regeneration.
+   */
+  generate(
+    cloneID: string,
+    body: HeadshotGenerateParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<VoiceAPI.GenerationStatus> {
+    return this._client.post(path`/api/v1/clones/${cloneID}/headshot/generate`, { body, ...options });
+  }
+}
+
+export interface HeadshotGenerateParams {
+  /**
+   * Optional instructions to nudge the generation (e.g. "deeper voice", "longer
+   * hair")
+   */
+  additionalInstructions?: string;
+}
+
+export declare namespace Headshot {
+  export { type HeadshotGenerateParams as HeadshotGenerateParams };
+}

package/src/resources/v1/clones/index.ts

@@ -0,0 +1,68 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Activity,
+  type ActivityRetrieveResponse,
+  type ActivityListResponse,
+  type ActivityDeleteResponse,
+  type ActivityRetrieveParams,
+  type ActivityDeleteParams,
+} from './activity';
+export { Clones, type CloneListResponse } from './clones';
+export {
+  Files,
+  type KBFileSummary,
+  type FileListResponse,
+  type FileDeleteResponse,
+  type FileCreateParams,
+  type FileRetrieveParams,
+  type FileDeleteParams,
+} from './files';
+export {
+  Gallery,
+  type GalleryItemSummary,
+  type GalleryListResponse,
+  type GalleryDeleteResponse,
+  type GalleryCreateParams,
+  type GalleryRetrieveParams,
+  type GalleryListParams,
+  type GalleryDeleteParams,
+} from './gallery';
+export { Headshot, type HeadshotGenerateParams } from './headshot';
+export {
+  Integrations,
+  type IntegrationSummary,
+  type IntegrationListResponse,
+  type IntegrationDeleteResponse,
+  type IntegrationPhoneResponse,
+  type IntegrationRetrieveSetupResponse,
+  type IntegrationRetrieveParams,
+  type IntegrationListParams,
+  type IntegrationDeleteParams,
+  type IntegrationPhoneParams,
+  type IntegrationRetrieveSetupParams,
+} from './integrations/index';
+export { Profile, type CloneHeadshot, type CloneProfile, type ProfilePatchAllParams } from './profile';
+export {
+  Skills,
+  type SkillSummary,
+  type SkillListResponse,
+  type SkillDeleteResponse,
+  type SkillCreateParams,
+  type SkillUpdateParams,
+  type SkillListParams,
+  type SkillDeleteParams,
+} from './skills/index';
+export {
+  Tasks,
+  type TaskRecurrence,
+  type TaskSummary,
+  type TaskListResponse,
+  type TaskDeleteResponse,
+  type TaskCreateParams,
+  type TaskRetrieveParams,
+  type TaskUpdateParams,
+  type TaskListParams,
+  type TaskDeleteParams,
+} from './tasks';
+export { Voice, type GenerateRequest, type GenerationStatus, type VoiceGenerateParams } from './voice';

package/src/resources/v1/clones/integrations/index.ts

@@ -0,0 +1,17 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Integrations,
+  type IntegrationSummary,
+  type IntegrationListResponse,
+  type IntegrationDeleteResponse,
+  type IntegrationPhoneResponse,
+  type IntegrationRetrieveSetupResponse,
+  type IntegrationRetrieveParams,
+  type IntegrationListParams,
+  type IntegrationDeleteParams,
+  type IntegrationPhoneParams,
+  type IntegrationRetrieveSetupParams,
+} from './integrations';
+export { Msteams, type MsTeamsTeamRef, type MsteamTeamsResponse, type MsteamTeamsParams } from './msteams';
+export { Slack, type SlackIntegration, type SlackUpdateParams } from './slack';