@roarkanalytics/sdk 3.11.0 → 3.12.0

package/src/client.ts

@@ -37,6 +37,14 @@ import {
   AgentEndpointUpdateParams,
   AgentEndpointUpdateResponse,
 } from './resources/agent-endpoint';
+import {
+  AgentPrompt,
+  AgentPromptListResponse,
+  AgentPromptListVersionsParams,
+  AgentPromptListVersionsResponse,
+  AgentPromptUpdateParams,
+  AgentPromptUpdateResponse,
+} from './resources/agent-prompt';
 import {
   Call,
   CallAppendToolInvocationsParams,
@@ -66,6 +74,8 @@ import {
   CustomerFlowCreateParams,
   CustomerFlowCreateResponse,
   CustomerFlowDeleteResponse,
+  CustomerFlowDuplicateParams,
+  CustomerFlowDuplicateResponse,
   CustomerFlowGetByIDResponse,
   CustomerFlowListParams,
   CustomerFlowListResponse,
@@ -142,9 +152,14 @@ import {
 import { Simulation, SimulationRunParams, SimulationRunResponse } from './resources/simulation';
 import {
   SimulationEnvironment,
+  SimulationEnvironmentCreateParams,
+  SimulationEnvironmentCreateResponse,
+  SimulationEnvironmentDeleteResponse,
   SimulationEnvironmentGetByIDResponse,
   SimulationEnvironmentListParams,
   SimulationEnvironmentListResponse,
+  SimulationEnvironmentUpdateParams,
+  SimulationEnvironmentUpdateResponse,
 } from './resources/simulation-environment';
 import {
   SimulationJob,
@@ -925,6 +940,7 @@ export class Roark {
   customerFlowEdgeCase: API.CustomerFlowEdgeCase = new API.CustomerFlowEdgeCase(this);
   agent: API.Agent = new API.Agent(this);
   agentEndpoint: API.AgentEndpoint = new API.AgentEndpoint(this);
+  agentPrompt: API.AgentPrompt = new API.AgentPrompt(this);
   httpRequestDefinition: API.HTTPRequestDefinition = new API.HTTPRequestDefinition(this);
   webhook: API.Webhook = new API.Webhook(this);
   config: API.Config = new API.Config(this);
@@ -947,6 +963,7 @@ Roark.CustomerFlow = CustomerFlow;
 Roark.CustomerFlowEdgeCase = CustomerFlowEdgeCase;
 Roark.Agent = Agent;
 Roark.AgentEndpoint = AgentEndpoint;
+Roark.AgentPrompt = AgentPrompt;
 Roark.HTTPRequestDefinition = HTTPRequestDefinition;
 Roark.Webhook = Webhook;
 Roark.Config = Config;
@@ -1063,8 +1080,13 @@ export declare namespace Roark {
 
   export {
     SimulationEnvironment as SimulationEnvironment,
+    type SimulationEnvironmentCreateResponse as SimulationEnvironmentCreateResponse,
+    type SimulationEnvironmentUpdateResponse as SimulationEnvironmentUpdateResponse,
     type SimulationEnvironmentListResponse as SimulationEnvironmentListResponse,
+    type SimulationEnvironmentDeleteResponse as SimulationEnvironmentDeleteResponse,
     type SimulationEnvironmentGetByIDResponse as SimulationEnvironmentGetByIDResponse,
+    type SimulationEnvironmentCreateParams as SimulationEnvironmentCreateParams,
+    type SimulationEnvironmentUpdateParams as SimulationEnvironmentUpdateParams,
     type SimulationEnvironmentListParams as SimulationEnvironmentListParams,
   };
 
@@ -1080,12 +1102,14 @@ export declare namespace Roark {
     type CustomerFlowUpdateResponse as CustomerFlowUpdateResponse,
     type CustomerFlowListResponse as CustomerFlowListResponse,
     type CustomerFlowDeleteResponse as CustomerFlowDeleteResponse,
+    type CustomerFlowDuplicateResponse as CustomerFlowDuplicateResponse,
     type CustomerFlowGetByIDResponse as CustomerFlowGetByIDResponse,
     type CustomerFlowReplaceGraphResponse as CustomerFlowReplaceGraphResponse,
     type CustomerFlowUpdateHappyPathResponse as CustomerFlowUpdateHappyPathResponse,
     type CustomerFlowCreateParams as CustomerFlowCreateParams,
     type CustomerFlowUpdateParams as CustomerFlowUpdateParams,
     type CustomerFlowListParams as CustomerFlowListParams,
+    type CustomerFlowDuplicateParams as CustomerFlowDuplicateParams,
     type CustomerFlowReplaceGraphParams as CustomerFlowReplaceGraphParams,
     type CustomerFlowUpdateHappyPathParams as CustomerFlowUpdateHappyPathParams,
   };
@@ -1124,6 +1148,15 @@ export declare namespace Roark {
     type AgentEndpointListParams as AgentEndpointListParams,
   };
 
+  export {
+    AgentPrompt as AgentPrompt,
+    type AgentPromptUpdateResponse as AgentPromptUpdateResponse,
+    type AgentPromptListResponse as AgentPromptListResponse,
+    type AgentPromptListVersionsResponse as AgentPromptListVersionsResponse,
+    type AgentPromptUpdateParams as AgentPromptUpdateParams,
+    type AgentPromptListVersionsParams as AgentPromptListVersionsParams,
+  };
+
   export {
     HTTPRequestDefinition as HTTPRequestDefinition,
     type HTTPRequestDefinitionCreateResponse as HTTPRequestDefinitionCreateResponse,

package/src/resources/agent-prompt.ts

@@ -0,0 +1,183 @@
+// 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';
+
+export class AgentPrompt extends APIResource {
+  /**
+   * Sets the agent's API-managed prompt. This is its own version history
+   * (`source: API_MANAGED`), separate from prompts observed on calls, edited in the
+   * app, or managed by config-as-code. Setting the same content twice is a no-op (no
+   * new version). Roark does not run your agent and no metric reads this prompt: it
+   * is stored and versioned for your reference.
+   *
+   * @example
+   * ```ts
+   * const agentPrompt = await client.agentPrompt.update(
+   *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   *   { prompt: 'x' },
+   * );
+   * ```
+   */
+  update(
+    agentID: string,
+    body: AgentPromptUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<AgentPromptUpdateResponse> {
+    return this._client.put(path`/v1/agent/${agentID}/prompts`, { body, ...options });
+  }
+
+  /**
+   * Returns the agent's prompt lineages. Each lineage is an independent version
+   * history, labelled by its `source` (USER, API, CONFIG, or a provider
+   * integration). `prompt` is the current content.
+   *
+   * @example
+   * ```ts
+   * const agentPrompts = await client.agentPrompt.list(
+   *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   * );
+   * ```
+   */
+  list(agentID: string, options?: RequestOptions): APIPromise<AgentPromptListResponse> {
+    return this._client.get(path`/v1/agent/${agentID}/prompts`, options);
+  }
+
+  /**
+   * Returns the full version history of a single prompt lineage, newest first.
+   *
+   * @example
+   * ```ts
+   * const response = await client.agentPrompt.listVersions(
+   *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   *   { agentId: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e' },
+   * );
+   * ```
+   */
+  listVersions(
+    promptID: string,
+    params: AgentPromptListVersionsParams,
+    options?: RequestOptions,
+  ): APIPromise<AgentPromptListVersionsResponse> {
+    const { agentId } = params;
+    return this._client.get(path`/v1/agent/${agentId}/prompts/${promptID}/versions`, options);
+  }
+}
+
+export interface AgentPromptUpdateResponse {
+  data: AgentPromptUpdateResponse.Data;
+}
+
+export namespace AgentPromptUpdateResponse {
+  export interface Data {
+    /**
+     * True if a new version was appended; false if the content matched the current
+     * version (no-op).
+     */
+    changed: boolean;
+
+    /**
+     * The ID of the API-managed prompt lineage.
+     */
+    promptId: string;
+
+    /**
+     * The current version number after the set.
+     */
+    versionNumber: number;
+  }
+}
+
+export interface AgentPromptListResponse {
+  data: Array<AgentPromptListResponse.Data>;
+}
+
+export namespace AgentPromptListResponse {
+  /**
+   * A prompt lineage on an agent.
+   */
+  export interface Data {
+    /**
+     * Prompt lineage ID (its own version history).
+     */
+    id: string;
+
+    /**
+     * When this prompt lineage was first created (ISO 8601).
+     */
+    createdAt: string;
+
+    /**
+     * Current prompt content (the latest version).
+     */
+    prompt: string;
+
+    /**
+     * Where this prompt came from: USER (edited in the app), API (provided via the API
+     * or on calls), CONFIG (managed by config-as-code), or a provider integration.
+     */
+    source:
+      | 'USER'
+      | 'RETELL_INTEGRATION'
+      | 'VAPI_INTEGRATION'
+      | 'ELEVEN_LABS_INTEGRATION'
+      | 'BLAND_INTEGRATION'
+      | 'PIPECAT_CLOUD_INTEGRATION'
+      | 'PIPECAT_SELF_HOSTED_INTEGRATION'
+      | 'LIVEKIT_SELF_HOSTED_INTEGRATION'
+      | 'API'
+      | 'CONFIG'
+      | 'API_MANAGED';
+
+    /**
+     * When the current version was recorded (ISO 8601).
+     */
+    updatedAt: string;
+  }
+}
+
+export interface AgentPromptListVersionsResponse {
+  data: Array<AgentPromptListVersionsResponse.Data>;
+}
+
+export namespace AgentPromptListVersionsResponse {
+  export interface Data {
+    /**
+     * When this version was recorded (ISO 8601).
+     */
+    createdAt: string;
+
+    /**
+     * Prompt content at this version.
+     */
+    prompt: string;
+
+    /**
+     * Version number: 1-based and increasing.
+     */
+    versionNumber: number;
+  }
+}
+
+export interface AgentPromptUpdateParams {
+  /**
+   * The prompt content to set.
+   */
+  prompt: string;
+}
+
+export interface AgentPromptListVersionsParams {
+  agentId: string;
+}
+
+export declare namespace AgentPrompt {
+  export {
+    type AgentPromptUpdateResponse as AgentPromptUpdateResponse,
+    type AgentPromptListResponse as AgentPromptListResponse,
+    type AgentPromptListVersionsResponse as AgentPromptListVersionsResponse,
+    type AgentPromptUpdateParams as AgentPromptUpdateParams,
+    type AgentPromptListVersionsParams as AgentPromptListVersionsParams,
+  };
+}

package/src/resources/call.ts

@@ -1148,7 +1148,7 @@ export namespace CallListMetricsResponse {
          * How this property resolved against the transcript. NOT_MENTIONED means the
          * subject never came up and is not a mismatch.
          */
-        verdict: 'MATCH' | 'MISMATCH' | 'NOT_MENTIONED';
+        verdict: 'MATCH' | 'MISMATCH' | 'TRANSCRIPTION_ERROR' | 'NOT_MENTIONED';
 
         /**
          * What the transcript said instead. Only present when verdict is MISMATCH.