cloneforce 0.0.2

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

@@ -0,0 +1,209 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../../core/resource';
+import * as MsteamsAPI from './msteams';
+import { MsTeamsTeamRef, MsteamTeamsParams, MsteamTeamsResponse, Msteams } from './msteams';
+import * as SlackAPI from './slack';
+import { Slack, SlackIntegration, SlackUpdateParams } from './slack';
+import { APIPromise } from '../../../../core/api-promise';
+import { RequestOptions } from '../../../../internal/request-options';
+import { path } from '../../../../internal/utils/path';
+
+/**
+ * Clone integration management (Slack, Email, MS Teams, Phone)
+ */
+export class Integrations extends APIResource {
+  slack: SlackAPI.Slack = new SlackAPI.Slack(this._client);
+  msteams: MsteamsAPI.Msteams = new MsteamsAPI.Msteams(this._client);
+
+  /**
+   * Get an integration
+   */
+  retrieve(
+    integrationID: string,
+    params: IntegrationRetrieveParams,
+    options?: RequestOptions,
+  ): APIPromise<IntegrationSummary> {
+    const { cloneId } = params;
+    return this._client.get(path`/api/v1/clones/${cloneId}/integrations/${integrationID}`, options);
+  }
+
+  /**
+   * Returns all integrations for a clone (Slack, Email, MS Teams, Phone).
+   */
+  list(
+    cloneID: string,
+    query: IntegrationListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<IntegrationListResponse> {
+    return this._client.get(path`/api/v1/clones/${cloneID}/integrations`, { query, ...options });
+  }
+
+  /**
+   * Deletes an integration and performs type-specific cleanup (e.g. Twilio release
+   * for phone).
+   */
+  delete(
+    integrationID: string,
+    params: IntegrationDeleteParams,
+    options?: RequestOptions,
+  ): APIPromise<IntegrationDeleteResponse> {
+    const { cloneId } = params;
+    return this._client.delete(path`/api/v1/clones/${cloneId}/integrations/${integrationID}`, options);
+  }
+
+  /**
+   * Purchases a phone number and provisions it for clone voice calls. Requires
+   * sufficient account credits. Creates a Twilio number, ElevenLabs voice agent, and
+   * billing subscription.
+   */
+  phone(
+    cloneID: string,
+    body: IntegrationPhoneParams,
+    options?: RequestOptions,
+  ): APIPromise<IntegrationPhoneResponse> {
+    return this._client.post(path`/api/v1/clones/${cloneID}/integrations/phone`, { body, ...options });
+  }
+
+  /**
+   * Returns a browser URL for the OAuth-based setup flow. Supported types: `email`,
+   * `msteams`. Present this URL to the user and poll the integrations list to detect
+   * completion.
+   */
+  retrieveSetup(
+    type: 'email' | 'msteams',
+    params: IntegrationRetrieveSetupParams,
+    options?: RequestOptions,
+  ): APIPromise<IntegrationRetrieveSetupResponse> {
+    const { cloneId } = params;
+    return this._client.get(path`/api/v1/clones/${cloneId}/integrations/${type}/setup`, options);
+  }
+}
+
+export interface IntegrationSummary {
+  id: string;
+
+  createdAt: string;
+
+  status: 'Pending' | 'Connected' | 'Error' | 'Provisioning';
+
+  type: 'Slack' | 'Email' | 'MsTeams' | 'Phone';
+
+  updatedAt: string;
+
+  /**
+   * Type-specific integration details
+   */
+  detail?:
+    | IntegrationSummary.SlackDetail
+    | IntegrationSummary.EmailDetail
+    | IntegrationSummary.MsTeamsDetail
+    | IntegrationSummary.PhoneDetail;
+
+  errorMessage?: string;
+
+  name?: string;
+}
+
+export namespace IntegrationSummary {
+  export interface SlackDetail {
+    teamId?: string;
+
+    teamName?: string;
+  }
+
+  export interface EmailDetail {
+    email: string;
+
+    connectionType?: string;
+  }
+
+  export interface MsTeamsDetail {
+    organizationName?: string;
+
+    teams?: Array<MsteamsAPI.MsTeamsTeamRef>;
+  }
+
+  export interface PhoneDetail {
+    phoneNumber?: string;
+  }
+}
+
+export interface IntegrationListResponse {
+  data: Array<IntegrationSummary>;
+}
+
+export interface IntegrationDeleteResponse {
+  deleted: true;
+}
+
+export interface IntegrationPhoneResponse {
+  id: string;
+
+  phoneNumber: string;
+
+  status: string;
+}
+
+export interface IntegrationRetrieveSetupResponse {
+  setupUrl: string;
+
+  type: string;
+}
+
+export interface IntegrationRetrieveParams {
+  cloneId: string;
+}
+
+export interface IntegrationListParams {
+  /**
+   * Filter by integration type
+   */
+  type?: 'Slack' | 'Email' | 'MsTeams' | 'Phone';
+}
+
+export interface IntegrationDeleteParams {
+  cloneId: string;
+}
+
+export interface IntegrationPhoneParams {
+  /**
+   * Phone number to purchase (from the available numbers search)
+   */
+  phone: string;
+}
+
+export interface IntegrationRetrieveSetupParams {
+  cloneId: string;
+}
+
+Integrations.Slack = Slack;
+Integrations.Msteams = Msteams;
+
+export declare namespace Integrations {
+  export {
+    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 {
+    Slack as Slack,
+    type SlackIntegration as SlackIntegration,
+    type SlackUpdateParams as SlackUpdateParams,
+  };
+
+  export {
+    Msteams as Msteams,
+    type MsTeamsTeamRef as MsTeamsTeamRef,
+    type MsteamTeamsResponse as MsteamTeamsResponse,
+    type MsteamTeamsParams as MsteamTeamsParams,
+  };
+}

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

@@ -0,0 +1,63 @@
+// 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 integration management (Slack, Email, MS Teams, Phone)
+ */
+export class Msteams extends APIResource {
+  /**
+   * Adds a team to an existing MS Teams integration. Validates team access via MS
+   * Graph.
+   */
+  teams(
+    integrationID: string,
+    params: MsteamTeamsParams,
+    options?: RequestOptions,
+  ): APIPromise<MsteamTeamsResponse> {
+    const { cloneId, ...body } = params;
+    return this._client.post(path`/api/v1/clones/${cloneId}/integrations/msteams/${integrationID}/teams`, {
+      body,
+      ...options,
+    });
+  }
+}
+
+export interface MsTeamsTeamRef {
+  id: string;
+
+  name: string;
+}
+
+export interface MsteamTeamsResponse {
+  id: string;
+
+  status: string;
+
+  organizationName?: string;
+
+  teams?: Array<MsTeamsTeamRef>;
+}
+
+export interface MsteamTeamsParams {
+  /**
+   * Path param
+   */
+  cloneId: string;
+
+  /**
+   * Body param
+   */
+  teamId: string;
+}
+
+export declare namespace Msteams {
+  export {
+    type MsTeamsTeamRef as MsTeamsTeamRef,
+    type MsteamTeamsResponse as MsteamTeamsResponse,
+    type MsteamTeamsParams as MsteamTeamsParams,
+  };
+}

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

@@ -0,0 +1,68 @@
+// 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 integration management (Slack, Email, MS Teams, Phone)
+ */
+export class Slack extends APIResource {
+  /**
+   * Creates a pending Slack integration and returns a Slack app manifest for
+   * installation.
+   */
+  create(cloneID: string, options?: RequestOptions): APIPromise<SlackIntegration> {
+    return this._client.post(path`/api/v1/clones/${cloneID}/integrations/slack`, options);
+  }
+
+  /**
+   * Configures bot token and signing secret. Tests the connection if the bot token
+   * changes.
+   */
+  update(
+    integrationID: string,
+    params: SlackUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<SlackIntegration> {
+    const { cloneId, ...body } = params;
+    return this._client.patch(path`/api/v1/clones/${cloneId}/integrations/slack/${integrationID}`, {
+      body,
+      ...options,
+    });
+  }
+}
+
+export interface SlackIntegration {
+  id: string;
+
+  status: string;
+
+  manifest?: string;
+
+  teamId?: string;
+
+  teamName?: string;
+}
+
+export interface SlackUpdateParams {
+  /**
+   * Path param
+   */
+  cloneId: string;
+
+  /**
+   * Body param
+   */
+  botToken?: string;
+
+  /**
+   * Body param
+   */
+  signingSecret?: string;
+}
+
+export declare namespace Slack {
+  export { type SlackIntegration as SlackIntegration, type SlackUpdateParams as SlackUpdateParams };
+}

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

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

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

@@ -0,0 +1,180 @@
+// 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 profile management and asset generation
+ */
+export class Profile extends APIResource {
+  /**
+   * Returns the full profile and aesthetics for a clone.
+   */
+  list(cloneID: string, options?: RequestOptions): APIPromise<CloneProfile> {
+    return this._client.get(path`/api/v1/clones/${cloneID}/profile`, options);
+  }
+
+  /**
+   * Updates one or more fields on a clone's profile. Only provided fields are
+   * changed.
+   */
+  patchAll(cloneID: string, body: ProfilePatchAllParams, options?: RequestOptions): APIPromise<CloneProfile> {
+    return this._client.patch(path`/api/v1/clones/${cloneID}/profile`, { body, ...options });
+  }
+}
+
+export interface CloneHeadshot {
+  large?: string;
+
+  medium?: string;
+
+  small?: string;
+}
+
+export interface CloneProfile {
+  id: string;
+
+  createdAt: string;
+
+  generation: string;
+
+  name: string;
+
+  screenName: string;
+
+  status: string;
+
+  updatedAt: string;
+
+  appearanceDesc?: string;
+
+  birthdate?: string;
+
+  careerDesc?: string;
+
+  childhoodDesc?: string;
+
+  currentCity?: string;
+
+  educationDesc?: string;
+
+  familyDesc?: string;
+
+  financesDesc?: string;
+
+  gender?: string;
+
+  headshot?: CloneHeadshot;
+
+  hometown?: string;
+
+  interestsDesc?: string;
+
+  isEnabled?: boolean;
+
+  language?: string;
+
+  lifestyleDesc?: string;
+
+  maritalStatus?: string;
+
+  nationality?: string;
+
+  occupation?: string;
+
+  principlesDesc?: string;
+
+  races?: Array<string>;
+
+  socialCircleDesc?: string;
+
+  socialHobbiesDesc?: string;
+
+  sportsDesc?: string;
+
+  state?: CloneProfile.State;
+
+  travelDesc?: string;
+
+  unusualHobbiesDesc?: string;
+
+  voiceUrl?: string;
+}
+
+export namespace CloneProfile {
+  export interface State {
+    /**
+     * Generation status: none, generating, ready, error
+     */
+    headshot: 'none' | 'generating' | 'ready' | 'error';
+
+    /**
+     * Generation status: none, generating, ready, error
+     */
+    voice: 'none' | 'generating' | 'ready' | 'error';
+  }
+}
+
+export interface ProfilePatchAllParams {
+  appearanceDesc?: string;
+
+  birthdate?: string;
+
+  careerDesc?: string;
+
+  childhoodDesc?: string;
+
+  currentCity?: string;
+
+  educationDesc?: string;
+
+  familyDesc?: string;
+
+  financesDesc?: string;
+
+  gender?: string;
+
+  hometown?: string;
+
+  interestsDesc?: string;
+
+  isEnabled?: boolean;
+
+  language?: string;
+
+  lifestyleDesc?: string;
+
+  maritalStatus?: string;
+
+  name?: string;
+
+  nationality?: string;
+
+  occupation?: string;
+
+  principlesDesc?: string;
+
+  races?: Array<string>;
+
+  screenName?: string;
+
+  socialCircleDesc?: string;
+
+  socialHobbiesDesc?: string;
+
+  sportsDesc?: string;
+
+  travelDesc?: string;
+
+  unusualHobbiesDesc?: string;
+}
+
+export declare namespace Profile {
+  export {
+    type CloneHeadshot as CloneHeadshot,
+    type CloneProfile as CloneProfile,
+    type ProfilePatchAllParams as ProfilePatchAllParams,
+  };
+}

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

@@ -0,0 +1,85 @@
+// 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';
+
+/**
+ * Skill marketplace search and clone skill management
+ */
+export class Connections extends APIResource {
+  /**
+   * Assigns a connection to a connection-type setting on a clone skill.
+   */
+  update(
+    settingName: string,
+    params: ConnectionUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<SkillConnectionInfo> {
+    const { cloneId, skillName, ...body } = params;
+    return this._client.put(path`/api/v1/clones/${cloneId}/skills/${skillName}/connections/${settingName}`, {
+      body,
+      ...options,
+    });
+  }
+
+  /**
+   * Returns connection-type settings for a skill on a clone, with their
+   * configuration status.
+   */
+  list(
+    skillName: string,
+    params: ConnectionListParams,
+    options?: RequestOptions,
+  ): APIPromise<ConnectionListResponse> {
+    const { cloneId } = params;
+    return this._client.get(path`/api/v1/clones/${cloneId}/skills/${skillName}/connections`, options);
+  }
+}
+
+export interface SkillConnectionInfo {
+  isConfigured: boolean;
+
+  settingName: string;
+
+  settingType: string;
+
+  connectionId?: string;
+
+  isValid?: boolean;
+}
+
+export interface ConnectionListResponse {
+  data: Array<SkillConnectionInfo>;
+}
+
+export interface ConnectionUpdateParams {
+  /**
+   * Path param
+   */
+  cloneId: string;
+
+  /**
+   * Path param
+   */
+  skillName: string;
+
+  /**
+   * Body param
+   */
+  connectionId: string;
+}
+
+export interface ConnectionListParams {
+  cloneId: string;
+}
+
+export declare namespace Connections {
+  export {
+    type SkillConnectionInfo as SkillConnectionInfo,
+    type ConnectionListResponse as ConnectionListResponse,
+    type ConnectionUpdateParams as ConnectionUpdateParams,
+    type ConnectionListParams as ConnectionListParams,
+  };
+}

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

@@ -0,0 +1,19 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Connections,
+  type SkillConnectionInfo,
+  type ConnectionListResponse,
+  type ConnectionUpdateParams,
+  type ConnectionListParams,
+} from './connections';
+export {
+  Skills,
+  type SkillSummary,
+  type SkillListResponse,
+  type SkillDeleteResponse,
+  type SkillCreateParams,
+  type SkillUpdateParams,
+  type SkillListParams,
+  type SkillDeleteParams,
+} from './skills';