cloneforce 0.0.2

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

@@ -0,0 +1,157 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../../core/resource';
+import * as ConnectionsAPI from './connections';
+import {
+  ConnectionListParams,
+  ConnectionListResponse,
+  ConnectionUpdateParams,
+  Connections,
+  SkillConnectionInfo,
+} from './connections';
+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 Skills extends APIResource {
+  connections: ConnectionsAPI.Connections = new ConnectionsAPI.Connections(this._client);
+
+  /**
+   * Attaches a marketplace skill to a clone. Returns 409 if already attached.
+   */
+  create(cloneID: string, body: SkillCreateParams, options?: RequestOptions): APIPromise<SkillSummary> {
+    return this._client.post(path`/api/v1/clones/${cloneID}/skills`, { body, ...options });
+  }
+
+  /**
+   * Updates settings and/or active status of a skill on a clone.
+   */
+  update(skillName: string, params: SkillUpdateParams, options?: RequestOptions): APIPromise<SkillSummary> {
+    const { cloneId, ...body } = params;
+    return this._client.patch(path`/api/v1/clones/${cloneId}/skills/${skillName}`, { body, ...options });
+  }
+
+  /**
+   * Returns all skills attached to a clone, excluding hidden system skills.
+   */
+  list(
+    cloneID: string,
+    query: SkillListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<SkillListResponse> {
+    return this._client.get(path`/api/v1/clones/${cloneID}/skills`, { query, ...options });
+  }
+
+  /**
+   * Detaches a skill from a clone. System skills cannot be removed.
+   */
+  delete(
+    skillName: string,
+    params: SkillDeleteParams,
+    options?: RequestOptions,
+  ): APIPromise<SkillDeleteResponse> {
+    const { cloneId } = params;
+    return this._client.delete(path`/api/v1/clones/${cloneId}/skills/${skillName}`, options);
+  }
+}
+
+export interface SkillSummary {
+  accuracy: number;
+
+  isActive: boolean;
+
+  isSystemSkill: boolean;
+
+  name: string;
+
+  totalRuns: number;
+
+  category?: string;
+
+  description?: string;
+
+  skillId?: string;
+}
+
+export interface SkillListResponse {
+  data: Array<SkillSummary>;
+}
+
+export interface SkillDeleteResponse {
+  deleted: true;
+}
+
+export interface SkillCreateParams {
+  skillId: string;
+
+  isActive?: boolean;
+}
+
+export interface SkillUpdateParams {
+  /**
+   * Path param
+   */
+  cloneId: string;
+
+  /**
+   * Body param
+   */
+  isActive?: boolean;
+
+  /**
+   * Body param
+   */
+  settings?: Array<SkillUpdateParams.Setting>;
+}
+
+export namespace SkillUpdateParams {
+  export interface Setting {
+    name: string;
+
+    /**
+     * Required for connection-type settings
+     */
+    connectionId?: string;
+
+    /**
+     * Required for non-connection settings
+     */
+    value?: string;
+  }
+}
+
+export interface SkillListParams {
+  /**
+   * Filter by active status
+   */
+  active?: 'true' | 'false';
+}
+
+export interface SkillDeleteParams {
+  cloneId: string;
+}
+
+Skills.Connections = Connections;
+
+export declare namespace Skills {
+  export {
+    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 {
+    Connections as Connections,
+    type SkillConnectionInfo as SkillConnectionInfo,
+    type ConnectionListResponse as ConnectionListResponse,
+    type ConnectionUpdateParams as ConnectionUpdateParams,
+    type ConnectionListParams as ConnectionListParams,
+  };
+}

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

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

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

@@ -0,0 +1,171 @@
+// 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';
+
+/**
+ * Scheduled task management
+ */
+export class Tasks extends APIResource {
+  /**
+   * Creates a new scheduled task for a clone.
+   */
+  create(cloneID: string, body: TaskCreateParams, options?: RequestOptions): APIPromise<TaskSummary> {
+    return this._client.post(path`/api/v1/clones/${cloneID}/tasks`, { body, ...options });
+  }
+
+  /**
+   * Get a scheduled task
+   */
+  retrieve(taskID: string, params: TaskRetrieveParams, options?: RequestOptions): APIPromise<TaskSummary> {
+    const { cloneId } = params;
+    return this._client.get(path`/api/v1/clones/${cloneId}/tasks/${taskID}`, options);
+  }
+
+  /**
+   * Updates one or more fields on a scheduled task.
+   */
+  update(taskID: string, params: TaskUpdateParams, options?: RequestOptions): APIPromise<TaskSummary> {
+    const { cloneId, ...body } = params;
+    return this._client.patch(path`/api/v1/clones/${cloneId}/tasks/${taskID}`, { body, ...options });
+  }
+
+  /**
+   * Returns all scheduled tasks for a clone.
+   */
+  list(
+    cloneID: string,
+    query: TaskListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<TaskListResponse> {
+    return this._client.get(path`/api/v1/clones/${cloneID}/tasks`, { query, ...options });
+  }
+
+  /**
+   * Delete a scheduled task
+   */
+  delete(taskID: string, params: TaskDeleteParams, options?: RequestOptions): APIPromise<TaskDeleteResponse> {
+    const { cloneId } = params;
+    return this._client.delete(path`/api/v1/clones/${cloneId}/tasks/${taskID}`, options);
+  }
+}
+
+export interface TaskRecurrence {
+  interval: number;
+
+  pattern: 'Minutely' | 'Hourly' | 'Daily' | 'Weekly' | 'Monthly' | 'Yearly';
+
+  endsAt?: string;
+}
+
+export interface TaskSummary {
+  id: string;
+
+  createdAt: string;
+
+  isRecurring: boolean;
+
+  prompt: string;
+
+  startsAt: string;
+
+  title: string;
+
+  updatedAt: string;
+
+  color?: string;
+
+  lastRanAt?: string;
+
+  recurrence?: TaskRecurrence;
+}
+
+export interface TaskListResponse {
+  data: Array<TaskSummary>;
+}
+
+export interface TaskDeleteResponse {
+  deleted: true;
+}
+
+export interface TaskCreateParams {
+  prompt: string;
+
+  startsAt: string;
+
+  title: string;
+
+  color?: string;
+
+  isRecurring?: boolean;
+
+  recurrence?: TaskRecurrence;
+}
+
+export interface TaskRetrieveParams {
+  cloneId: string;
+}
+
+export interface TaskUpdateParams {
+  /**
+   * Path param
+   */
+  cloneId: string;
+
+  /**
+   * Body param
+   */
+  color?: string;
+
+  /**
+   * Body param
+   */
+  isRecurring?: boolean;
+
+  /**
+   * Body param
+   */
+  prompt?: string;
+
+  /**
+   * Body param
+   */
+  recurrence?: TaskRecurrence;
+
+  /**
+   * Body param
+   */
+  startsAt?: string;
+
+  /**
+   * Body param
+   */
+  title?: string;
+}
+
+export interface TaskListParams {
+  /**
+   * Filter by recurring status
+   */
+  isRecurring?: 'true' | 'false';
+}
+
+export interface TaskDeleteParams {
+  cloneId: string;
+}
+
+export declare namespace Tasks {
+  export {
+    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,
+  };
+}

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

@@ -0,0 +1,56 @@
+// 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 Voice extends APIResource {
+  /**
+   * Triggers asynchronous voice regeneration for a clone. Returns immediately with
+   * 202 Accepted. Poll `GET /clones/{cloneId}/profile` and check `state.voice` for
+   * progress.
+   *
+   * An optional request body can include `additionalInstructions` to nudge the voice
+   * style (e.g. "deeper voice", "more energetic"). An empty body performs a standard
+   * regeneration.
+   */
+  generate(
+    cloneID: string,
+    body: VoiceGenerateParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<GenerationStatus> {
+    return this._client.post(path`/api/v1/clones/${cloneID}/voice/generate`, { body, ...options });
+  }
+}
+
+export interface GenerateRequest {
+  /**
+   * Optional instructions to nudge the generation (e.g. "deeper voice", "longer
+   * hair")
+   */
+  additionalInstructions?: string;
+}
+
+export interface GenerationStatus {
+  status: string;
+}
+
+export interface VoiceGenerateParams {
+  /**
+   * Optional instructions to nudge the generation (e.g. "deeper voice", "longer
+   * hair")
+   */
+  additionalInstructions?: string;
+}
+
+export declare namespace Voice {
+  export {
+    type GenerateRequest as GenerateRequest,
+    type GenerationStatus as GenerationStatus,
+    type VoiceGenerateParams as VoiceGenerateParams,
+  };
+}

package/src/resources/v1/clones.ts

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

package/src/resources/v1/connections.ts

@@ -0,0 +1,207 @@
+// 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';
+
+/**
+ * Organization-level connection credential management
+ */
+export class Connections extends APIResource {
+  /**
+   * Creates a new key-value connection credential.
+   */
+  create(body: ConnectionCreateParams, options?: RequestOptions): APIPromise<ConnectionDetail> {
+    return this._client.post('/api/v1/connections', { body, ...options });
+  }
+
+  /**
+   * Get a connection
+   */
+  retrieve(connectionID: string, options?: RequestOptions): APIPromise<ConnectionDetail> {
+    return this._client.get(path`/api/v1/connections/${connectionID}`, options);
+  }
+
+  /**
+   * Updates name, key, and/or value on a standard connection. OAuth connections
+   * cannot be updated here.
+   */
+  update(
+    connectionID: string,
+    body: ConnectionUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<ConnectionDetail> {
+    return this._client.patch(path`/api/v1/connections/${connectionID}`, { body, ...options });
+  }
+
+  /**
+   * Returns all connections in the organization.
+   */
+  list(
+    query: ConnectionListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ConnectionListResponse> {
+    return this._client.get('/api/v1/connections', { query, ...options });
+  }
+
+  /**
+   * Delete a connection
+   */
+  delete(connectionID: string, options?: RequestOptions): APIPromise<ConnectionDeleteResponse> {
+    return this._client.delete(path`/api/v1/connections/${connectionID}`, options);
+  }
+
+  /**
+   * Creates a pending OAuth connection and returns a provision URL. Present the
+   * provision URL to the user to complete the OAuth consent flow.
+   */
+  createOAuth(body: ConnectionCreateOAuthParams, options?: RequestOptions): APIPromise<OAuthProvision> {
+    return this._client.post('/api/v1/connections/oauth', { body, ...options });
+  }
+
+  /**
+   * Returns lightweight validity and expiration status.
+   */
+  getStatus(connectionID: string, options?: RequestOptions): APIPromise<ConnectionStatus> {
+    return this._client.get(path`/api/v1/connections/${connectionID}/status`, options);
+  }
+
+  /**
+   * Refreshes OAuth tokens for a connection. Only supported for refreshable
+   * connection types.
+   */
+  refresh(connectionID: string, options?: RequestOptions): APIPromise<ConnectionStatus> {
+    return this._client.post(path`/api/v1/connections/${connectionID}/refresh`, options);
+  }
+
+  /**
+   * Returns a new provision URL for an existing OAuth connection to re-authorize.
+   */
+  reprovisionOAuth(connectionID: string, options?: RequestOptions): APIPromise<OAuthProvision> {
+    return this._client.post(path`/api/v1/connections/${connectionID}/reprovision`, options);
+  }
+}
+
+export interface ConnectionDetail {
+  id: string;
+
+  createdAt: string;
+
+  isExpired: boolean;
+
+  isValid: boolean;
+
+  name: string;
+
+  settingType: string;
+
+  updatedAt: string;
+
+  acquiredPermissions?: Array<string>;
+
+  errorReason?: string;
+
+  expiresAt?: string;
+
+  extraFields?: { [key: string]: string };
+}
+
+export interface ConnectionStatus {
+  id: string;
+
+  isExpired: boolean;
+
+  isValid: boolean;
+
+  errorReason?: string;
+
+  expiresAt?: string;
+}
+
+export interface OAuthProvision {
+  connectionId: string;
+
+  /**
+   * URL to present to the user to complete the OAuth consent flow
+   */
+  provisionUrl: string;
+}
+
+export interface ConnectionListResponse {
+  data: Array<ConnectionListResponse.Data>;
+}
+
+export namespace ConnectionListResponse {
+  export interface Data {
+    id: string;
+
+    createdAt: string;
+
+    isExpired: boolean;
+
+    isValid: boolean;
+
+    name: string;
+
+    settingType: string;
+
+    updatedAt: string;
+
+    errorReason?: string;
+
+    expiresAt?: string;
+  }
+}
+
+export interface ConnectionDeleteResponse {
+  deleted: true;
+}
+
+export interface ConnectionCreateParams {
+  key: string;
+
+  name: string;
+
+  value: string;
+}
+
+export interface ConnectionUpdateParams {
+  key?: string;
+
+  name?: string;
+
+  value?: string;
+}
+
+export interface ConnectionListParams {
+  /**
+   * Filter by setting type (e.g. Standard, or an OAuth provider type)
+   */
+  type?: string;
+}
+
+export interface ConnectionCreateOAuthParams {
+  name: string;
+
+  /**
+   * Must be an OAuth provider type
+   */
+  settingType: string;
+
+  scopes?: Array<string>;
+}
+
+export declare namespace Connections {
+  export {
+    type ConnectionDetail as ConnectionDetail,
+    type ConnectionStatus as ConnectionStatus,
+    type OAuthProvision as OAuthProvision,
+    type ConnectionListResponse as ConnectionListResponse,
+    type ConnectionDeleteResponse as ConnectionDeleteResponse,
+    type ConnectionCreateParams as ConnectionCreateParams,
+    type ConnectionUpdateParams as ConnectionUpdateParams,
+    type ConnectionListParams as ConnectionListParams,
+    type ConnectionCreateOAuthParams as ConnectionCreateOAuthParams,
+  };
+}

package/src/resources/v1/index.ts

@@ -0,0 +1,24 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Clones, type CloneListResponse } from './clones/index';
+export {
+  Connections,
+  type ConnectionDetail,
+  type ConnectionStatus,
+  type OAuthProvision,
+  type ConnectionListResponse,
+  type ConnectionDeleteResponse,
+  type ConnectionCreateParams,
+  type ConnectionUpdateParams,
+  type ConnectionListParams,
+  type ConnectionCreateOAuthParams,
+} from './connections';
+export { Integrations } from './integrations/index';
+export {
+  Skills,
+  type SkillRetrieveResponse,
+  type SkillSearchResponse,
+  type SkillRetrieveParams,
+  type SkillSearchParams,
+} from './skills';
+export { V1 } from './v1';

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

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Integrations } from './integrations';
+export { Phone, type PhoneListAvailableResponse, type PhoneListAvailableParams } from './phone';

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

@@ -0,0 +1,19 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as PhoneAPI from './phone';
+import { Phone, PhoneListAvailableParams, PhoneListAvailableResponse } from './phone';
+
+export class Integrations extends APIResource {
+  phone: PhoneAPI.Phone = new PhoneAPI.Phone(this._client);
+}
+
+Integrations.Phone = Phone;
+
+export declare namespace Integrations {
+  export {
+    Phone as Phone,
+    type PhoneListAvailableResponse as PhoneListAvailableResponse,
+    type PhoneListAvailableParams as PhoneListAvailableParams,
+  };
+}