@roarkanalytics/sdk 4.0.0 → 4.2.0

package/resources/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EACL,KAAK,GAQN,oBAAgB;AACjB,OAAO,EACL,aAAa,GAQd,6BAAyB;AAC1B,OAAO,EACL,WAAW,GAMZ,2BAAuB;AACxB,OAAO,EACL,cAAc,GAaf,8BAA0B;AAC3B,OAAO,EACL,SAAS,GAYV,wBAAoB;AACrB,OAAO,EACL,IAAI,GAaL,mBAAe;AAChB,OAAO,EACL,MAAM,GAOP,qBAAiB;AAClB,OAAO,EACL,YAAY,GAgBb,4BAAwB;AACzB,OAAO,EACL,oBAAoB,GASrB,sCAAkC;AACnC,OAAO,EACL,qBAAqB,GAQtB,sCAAkC;AACnC,OAAO,EAAE,MAAM,EAA0B,qBAAiB;AAC1D,OAAO,EACL,MAAM,GAOP,qBAAiB;AAClB,OAAO,EACL,mBAAmB,GAMpB,oCAAgC;AACjC,OAAO,EACL,YAAY,GASb,4BAAwB;AACzB,OAAO,EACL,aAAa,GAUd,6BAAyB;AAC1B,OAAO,EAAE,UAAU,EAAwD,yBAAqB;AAChG,OAAO,EACL,qBAAqB,GAStB,qCAAiC;AAClC,OAAO,EACL,aAAa,GAId,6BAAyB;AAC1B,OAAO,EACL,iBAAiB,GAQlB,iCAA6B;AAC9B,OAAO,EACL,iBAAiB,GASlB,kCAA8B;AAC/B,OAAO,EACL,oBAAoB,GAOrB,sCAAkC;AACnC,OAAO,EAAE,kBAAkB,EAAuC,kCAA8B;AAChG,OAAO,EACL,OAAO,GAOR,sBAAkB"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EACL,KAAK,GAUN,oBAAgB;AACjB,OAAO,EACL,WAAW,GAUZ,2BAAuB;AACxB,OAAO,EACL,aAAa,GAQd,6BAAyB;AAC1B,OAAO,EACL,WAAW,GAMZ,2BAAuB;AACxB,OAAO,EACL,cAAc,GAaf,8BAA0B;AAC3B,OAAO,EACL,SAAS,GAYV,wBAAoB;AACrB,OAAO,EACL,IAAI,GAaL,mBAAe;AAChB,OAAO,EACL,MAAM,GAOP,qBAAiB;AAClB,OAAO,EACL,YAAY,GAgBb,4BAAwB;AACzB,OAAO,EACL,oBAAoB,GASrB,sCAAkC;AACnC,OAAO,EACL,qBAAqB,GAQtB,sCAAkC;AACnC,OAAO,EAAE,MAAM,EAA0B,qBAAiB;AAC1D,OAAO,EACL,MAAM,GAOP,qBAAiB;AAClB,OAAO,EACL,mBAAmB,GAMpB,oCAAgC;AACjC,OAAO,EACL,YAAY,GASb,4BAAwB;AACzB,OAAO,EACL,aAAa,GAUd,6BAAyB;AAC1B,OAAO,EAAE,UAAU,EAAwD,yBAAqB;AAChG,OAAO,EACL,qBAAqB,GAStB,qCAAiC;AAClC,OAAO,EACL,aAAa,GAId,6BAAyB;AAC1B,OAAO,EACL,iBAAiB,GAQlB,iCAA6B;AAC9B,OAAO,EACL,iBAAiB,GASlB,kCAA8B;AAC/B,OAAO,EACL,oBAAoB,GAOrB,sCAAkC;AACnC,OAAO,EAAE,kBAAkB,EAAuC,kCAA8B;AAChG,OAAO,EACL,OAAO,GAOR,sBAAkB"}

package/src/client.ts

@@ -19,6 +19,8 @@ import * as API from './resources/index';
 import { APIPromise } from './core/api-promise';
 import {
   Agent,
+  AgentBuildParams,
+  AgentBuildResponse,
   AgentCreateParams,
   AgentCreateResponse,
   AgentGetByIDResponse,
@@ -27,6 +29,18 @@ import {
   AgentUpdateParams,
   AgentUpdateResponse,
 } from './resources/agent';
+import {
+  AgentConfig,
+  AgentConfigDeleteStagingResponse,
+  AgentConfigGetByIDResponse,
+  AgentConfigListResponse,
+  AgentConfigPromoteResponse,
+  AgentConfigResolveParams,
+  AgentConfigResolveResponse,
+  AgentConfigUpdateParams,
+  AgentConfigUpdateResponse,
+  ManagedAgentConfigRevision,
+} from './resources/agent-config';
 import {
   AgentEndpoint,
   AgentEndpointCreateParams,
@@ -966,6 +980,7 @@ export class Roark {
   simulationPersona: API.SimulationPersona = new API.SimulationPersona(this);
   simulationEnvironment: API.SimulationEnvironment = new API.SimulationEnvironment(this);
   simulationTemplate: API.SimulationTemplate = new API.SimulationTemplate(this);
+  agentConfig: API.AgentConfig = new API.AgentConfig(this);
   autoimproveJob: API.AutoimproveJob = new API.AutoimproveJob(this);
   customerFlow: API.CustomerFlow = new API.CustomerFlow(this);
   customerFlowEdgeCase: API.CustomerFlowEdgeCase = new API.CustomerFlowEdgeCase(this);
@@ -991,6 +1006,7 @@ Roark.SimulationRunPlanJob = SimulationRunPlanJob;
 Roark.SimulationPersona = SimulationPersona;
 Roark.SimulationEnvironment = SimulationEnvironment;
 Roark.SimulationTemplate = SimulationTemplate;
+Roark.AgentConfig = AgentConfig;
 Roark.AutoimproveJob = AutoimproveJob;
 Roark.CustomerFlow = CustomerFlow;
 Roark.CustomerFlowEdgeCase = CustomerFlowEdgeCase;
@@ -1130,6 +1146,19 @@ export declare namespace Roark {
     type SimulationTemplateListResponse as SimulationTemplateListResponse,
   };
 
+  export {
+    AgentConfig as AgentConfig,
+    type ManagedAgentConfigRevision as ManagedAgentConfigRevision,
+    type AgentConfigUpdateResponse as AgentConfigUpdateResponse,
+    type AgentConfigListResponse as AgentConfigListResponse,
+    type AgentConfigDeleteStagingResponse as AgentConfigDeleteStagingResponse,
+    type AgentConfigGetByIDResponse as AgentConfigGetByIDResponse,
+    type AgentConfigPromoteResponse as AgentConfigPromoteResponse,
+    type AgentConfigResolveResponse as AgentConfigResolveResponse,
+    type AgentConfigUpdateParams as AgentConfigUpdateParams,
+    type AgentConfigResolveParams as AgentConfigResolveParams,
+  };
+
   export {
     AutoimproveJob as AutoimproveJob,
     type AutoimproveLogEntry as AutoimproveLogEntry,
@@ -1182,10 +1211,12 @@ export declare namespace Roark {
     type AgentCreateResponse as AgentCreateResponse,
     type AgentUpdateResponse as AgentUpdateResponse,
     type AgentListResponse as AgentListResponse,
+    type AgentBuildResponse as AgentBuildResponse,
     type AgentGetByIDResponse as AgentGetByIDResponse,
     type AgentCreateParams as AgentCreateParams,
     type AgentUpdateParams as AgentUpdateParams,
     type AgentListParams as AgentListParams,
+    type AgentBuildParams as AgentBuildParams,
   };
 
   export {

package/src/resources/agent-config.ts

@@ -0,0 +1,487 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import * as AgentConfigAPI from './agent-config';
+import { APIPromise } from '../core/api-promise';
+import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
+
+export class AgentConfig extends APIResource {
+  /**
+   * Write a new revision onto a channel. Writing production creates the key when it
+   * does not exist; writing staging stages a candidate that only Roark-recognized
+   * simulation sessions will read. Every write is a new revision; nothing is
+   * overwritten.
+   *
+   * @example
+   * ```ts
+   * const agentConfig = await client.agentConfig.update('x', {
+   *   channel: 'production',
+   *   document: { foo: 'string' },
+   * });
+   * ```
+   */
+  update(
+    key: string,
+    body: AgentConfigUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<AgentConfigUpdateResponse> {
+    return this._client.put(path`/v1/agent-config/${key}`, { body, ...options });
+  }
+
+  /**
+   * List the managed agent configs in this project, most recent first.
+   *
+   * @example
+   * ```ts
+   * const agentConfigs = await client.agentConfig.list();
+   * ```
+   */
+  list(options?: RequestOptions): APIPromise<AgentConfigListResponse> {
+    return this._client.get('/v1/agent-config', options);
+  }
+
+  /**
+   * Clear the staging channel. Production is untouched; recognized simulation
+   * sessions go back to reading production.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.agentConfig.deleteStaging('x');
+   * ```
+   */
+  deleteStaging(key: string, options?: RequestOptions): APIPromise<AgentConfigDeleteStagingResponse> {
+    return this._client.delete(path`/v1/agent-config/${key}/staging`, options);
+  }
+
+  /**
+   * Fetch one managed config with its channel pointers and recent revisions, newest
+   * first.
+   *
+   * @example
+   * ```ts
+   * const response = await client.agentConfig.getByID('x');
+   * ```
+   */
+  getByID(key: string, options?: RequestOptions): APIPromise<AgentConfigGetByIDResponse> {
+    return this._client.get(path`/v1/agent-config/${key}`, options);
+  }
+
+  /**
+   * Point the production channel at the staging revision. Real traffic reads it from
+   * the next session onward; roll back by writing the prior revision id to
+   * production (the chain preserves every state).
+   *
+   * @example
+   * ```ts
+   * const response = await client.agentConfig.promote('x');
+   * ```
+   */
+  promote(key: string, options?: RequestOptions): APIPromise<AgentConfigPromoteResponse> {
+    return this._client.post(path`/v1/agent-config/${key}/promote`, options);
+  }
+
+  /**
+   * The call your agent makes at session start. Returns the config JSON for this
+   * session, with per-session simulation recognition built in: when the session was
+   * originated by a Roark simulation (matched by caller number against the calls
+   * Roark has in flight), the STAGING revision is served for that session only, so
+   * Autoimprove candidates are tested on your real deployment. Real traffic always
+   * resolves to production; any recognition miss degrades to production too.
+   *
+   * On the first fetch of an unknown key, pass `defaults` (your baked-in config):
+   * the key is registered and the defaults become revision 1. That makes integration
+   * a single call.
+   *
+   * Cache the response per session; do not fetch per turn.
+   *
+   * @example
+   * ```ts
+   * const response = await client.agentConfig.resolve('x');
+   * ```
+   */
+  resolve(
+    key: string,
+    body: AgentConfigResolveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<AgentConfigResolveResponse> {
+    return this._client.post(path`/v1/agent-config/${key}/resolve`, { body, ...options });
+  }
+}
+
+export interface ManagedAgentConfigRevision {
+  id: string;
+
+  /**
+   * ISO 8601.
+   */
+  createdAt: string;
+
+  /**
+   * Who wrote it: your own pushes, or the Autoimprove loop staging a candidate.
+   */
+  createdByType: 'CUSTOMER' | 'AUTOIMPROVE';
+
+  /**
+   * The config JSON, verbatim.
+   */
+  document: { [key: string]: unknown };
+
+  parentRevisionId: string | null;
+
+  /**
+   * One-line story of the change.
+   */
+  summary: string | null;
+}
+
+export interface AgentConfigUpdateResponse {
+  /**
+   * A managed config for a code-first agent (LiveKit, Pipecat, or any stack using
+   * the SDK): your agent fetches its tunable surface from Roark at session start.
+   * Two channels: production for real traffic, staging for candidates under test.
+   */
+  data: AgentConfigUpdateResponse.Data;
+}
+
+export namespace AgentConfigUpdateResponse {
+  /**
+   * A managed config for a code-first agent (LiveKit, Pipecat, or any stack using
+   * the SDK): your agent fetches its tunable surface from Roark at session start.
+   * Two channels: production for real traffic, staging for candidates under test.
+   */
+  export interface Data {
+    id: string;
+
+    /**
+     * The linked Roark agent, when one exists.
+     */
+    agentId: string | null;
+
+    /**
+     * ISO 8601.
+     */
+    createdAt: string;
+
+    /**
+     * The stable handle your code fetches by.
+     */
+    key: string;
+
+    /**
+     * The revision real traffic reads.
+     */
+    productionRevisionId: string | null;
+
+    /**
+     * The candidate revision Roark test calls read. Null when nothing is staged.
+     */
+    stagingRevisionId: string | null;
+
+    /**
+     * ISO 8601.
+     */
+    updatedAt: string;
+  }
+}
+
+export interface AgentConfigListResponse {
+  data: Array<AgentConfigListResponse.Data>;
+}
+
+export namespace AgentConfigListResponse {
+  /**
+   * A managed config for a code-first agent (LiveKit, Pipecat, or any stack using
+   * the SDK): your agent fetches its tunable surface from Roark at session start.
+   * Two channels: production for real traffic, staging for candidates under test.
+   */
+  export interface Data {
+    id: string;
+
+    /**
+     * The linked Roark agent, when one exists.
+     */
+    agentId: string | null;
+
+    /**
+     * ISO 8601.
+     */
+    createdAt: string;
+
+    /**
+     * The stable handle your code fetches by.
+     */
+    key: string;
+
+    /**
+     * The revision real traffic reads.
+     */
+    productionRevisionId: string | null;
+
+    /**
+     * The candidate revision Roark test calls read. Null when nothing is staged.
+     */
+    stagingRevisionId: string | null;
+
+    /**
+     * ISO 8601.
+     */
+    updatedAt: string;
+  }
+}
+
+export interface AgentConfigDeleteStagingResponse {
+  /**
+   * A managed config for a code-first agent (LiveKit, Pipecat, or any stack using
+   * the SDK): your agent fetches its tunable surface from Roark at session start.
+   * Two channels: production for real traffic, staging for candidates under test.
+   */
+  data: AgentConfigDeleteStagingResponse.Data;
+}
+
+export namespace AgentConfigDeleteStagingResponse {
+  /**
+   * A managed config for a code-first agent (LiveKit, Pipecat, or any stack using
+   * the SDK): your agent fetches its tunable surface from Roark at session start.
+   * Two channels: production for real traffic, staging for candidates under test.
+   */
+  export interface Data {
+    id: string;
+
+    /**
+     * The linked Roark agent, when one exists.
+     */
+    agentId: string | null;
+
+    /**
+     * ISO 8601.
+     */
+    createdAt: string;
+
+    /**
+     * The stable handle your code fetches by.
+     */
+    key: string;
+
+    /**
+     * The revision real traffic reads.
+     */
+    productionRevisionId: string | null;
+
+    /**
+     * The candidate revision Roark test calls read. Null when nothing is staged.
+     */
+    stagingRevisionId: string | null;
+
+    /**
+     * ISO 8601.
+     */
+    updatedAt: string;
+  }
+}
+
+export interface AgentConfigGetByIDResponse {
+  data: AgentConfigGetByIDResponse.Data;
+}
+
+export namespace AgentConfigGetByIDResponse {
+  /**
+   * A managed config for a code-first agent (LiveKit, Pipecat, or any stack using
+   * the SDK): your agent fetches its tunable surface from Roark at session start.
+   * Two channels: production for real traffic, staging for candidates under test.
+   */
+  export interface Data {
+    id: string;
+
+    /**
+     * The linked Roark agent, when one exists.
+     */
+    agentId: string | null;
+
+    /**
+     * ISO 8601.
+     */
+    createdAt: string;
+
+    /**
+     * The stable handle your code fetches by.
+     */
+    key: string;
+
+    /**
+     * The revision real traffic reads.
+     */
+    productionRevisionId: string | null;
+
+    /**
+     * Recent revisions, newest first.
+     */
+    revisions: Array<AgentConfigAPI.ManagedAgentConfigRevision>;
+
+    /**
+     * The candidate revision Roark test calls read. Null when nothing is staged.
+     */
+    stagingRevisionId: string | null;
+
+    /**
+     * ISO 8601.
+     */
+    updatedAt: string;
+  }
+}
+
+export interface AgentConfigPromoteResponse {
+  /**
+   * A managed config for a code-first agent (LiveKit, Pipecat, or any stack using
+   * the SDK): your agent fetches its tunable surface from Roark at session start.
+   * Two channels: production for real traffic, staging for candidates under test.
+   */
+  data: AgentConfigPromoteResponse.Data;
+}
+
+export namespace AgentConfigPromoteResponse {
+  /**
+   * A managed config for a code-first agent (LiveKit, Pipecat, or any stack using
+   * the SDK): your agent fetches its tunable surface from Roark at session start.
+   * Two channels: production for real traffic, staging for candidates under test.
+   */
+  export interface Data {
+    id: string;
+
+    /**
+     * The linked Roark agent, when one exists.
+     */
+    agentId: string | null;
+
+    /**
+     * ISO 8601.
+     */
+    createdAt: string;
+
+    /**
+     * The stable handle your code fetches by.
+     */
+    key: string;
+
+    /**
+     * The revision real traffic reads.
+     */
+    productionRevisionId: string | null;
+
+    /**
+     * The candidate revision Roark test calls read. Null when nothing is staged.
+     */
+    stagingRevisionId: string | null;
+
+    /**
+     * ISO 8601.
+     */
+    updatedAt: string;
+  }
+}
+
+export interface AgentConfigResolveResponse {
+  data: AgentConfigResolveResponse.Data;
+}
+
+export namespace AgentConfigResolveResponse {
+  export interface Data {
+    /**
+     * Which channel this session resolved to.
+     */
+    channel: 'production' | 'staging';
+
+    /**
+     * The config JSON to apply.
+     */
+    document: { [key: string]: unknown };
+
+    key: string;
+
+    revisionId: string;
+
+    /**
+     * Set when this session is a Roark simulation call. Stamp it (and the revisionId)
+     * into your session metadata so analysis attributes the call correctly.
+     */
+    simulationJobId: string | null;
+  }
+}
+
+export interface AgentConfigUpdateParams {
+  /**
+   * Which channel to write.
+   */
+  channel: 'production' | 'staging';
+
+  /**
+   * The full config JSON for the new revision.
+   */
+  document: { [key: string]: unknown };
+
+  /**
+   * Link this config to a Roark agent (the one your calls report). Required before
+   * Autoimprove can run on it: the link is how a fix finds the config channel.
+   */
+  agentId?: string;
+
+  /**
+   * One-line story of the change.
+   */
+  summary?: string;
+}
+
+export interface AgentConfigResolveParams {
+  /**
+   * Your baked-in config. On the first fetch of an unknown key this registers the
+   * config and becomes revision 1, so integration is a single call. Ignored once the
+   * key exists.
+   */
+  defaults?: { [key: string]: unknown };
+
+  /**
+   * Session context. When the call was originated by a Roark simulation, Roark
+   * recognizes it here and serves the staging revision for this session only; real
+   * traffic always gets production.
+   */
+  session?: AgentConfigResolveParams.Session;
+}
+
+export namespace AgentConfigResolveParams {
+  /**
+   * Session context. When the call was originated by a Roark simulation, Roark
+   * recognizes it here and serves the staging revision for this session only; real
+   * traffic always gets production.
+   */
+  export interface Session {
+    /**
+     * The number your agent was reached on (E.164).
+     */
+    calledNumber?: string;
+
+    /**
+     * The number calling your agent (E.164). Required for simulation recognition.
+     */
+    callerNumber?: string;
+
+    /**
+     * Your session or room identifier, for correlation.
+     */
+    sessionId?: string;
+  }
+}
+
+export declare namespace AgentConfig {
+  export {
+    type ManagedAgentConfigRevision as ManagedAgentConfigRevision,
+    type AgentConfigUpdateResponse as AgentConfigUpdateResponse,
+    type AgentConfigListResponse as AgentConfigListResponse,
+    type AgentConfigDeleteStagingResponse as AgentConfigDeleteStagingResponse,
+    type AgentConfigGetByIDResponse as AgentConfigGetByIDResponse,
+    type AgentConfigPromoteResponse as AgentConfigPromoteResponse,
+    type AgentConfigResolveResponse as AgentConfigResolveResponse,
+    type AgentConfigUpdateParams as AgentConfigUpdateParams,
+    type AgentConfigResolveParams as AgentConfigResolveParams,
+  };
+}

package/src/resources/agent.ts

@@ -49,6 +49,23 @@ export class Agent extends APIResource {
     return this._client.get('/v1/agent', { query, ...options });
   }
 
+  /**
+   * Creates a new Roark-hosted agent from a one-line job description. Roark authors
+   * the system prompt and hosts the config, so the agent is live and self-improvable
+   * from creation.
+   *
+   * @example
+   * ```ts
+   * const response = await client.agent.build({
+   *   jobDescription: 'x',
+   *   name: 'x',
+   * });
+   * ```
+   */
+  build(body: AgentBuildParams, options?: RequestOptions): APIPromise<AgentBuildResponse> {
+    return this._client.post('/v1/agent/build', { body, ...options });
+  }
+
   /**
    * Returns a specific agent by its ID.
    *
@@ -195,6 +212,44 @@ export namespace AgentListResponse {
   }
 }
 
+export interface AgentBuildResponse {
+  data: AgentBuildResponse.Data;
+}
+
+export namespace AgentBuildResponse {
+  export interface Data {
+    /**
+     * Unique identifier of the agent
+     */
+    id: string;
+
+    /**
+     * Creation timestamp in ISO 8601 format
+     */
+    createdAt: string;
+
+    /**
+     * Custom identifier for the agent
+     */
+    customId: string | null;
+
+    /**
+     * Description of the agent
+     */
+    description: string | null;
+
+    /**
+     * Name of the agent
+     */
+    name: string;
+
+    /**
+     * Last update timestamp in ISO 8601 format
+     */
+    updatedAt: string;
+  }
+}
+
 export interface AgentGetByIDResponse {
   data: AgentGetByIDResponse.Data;
 }
@@ -270,14 +325,34 @@ export interface AgentListParams {
   searchText?: string;
 }
 
+export interface AgentBuildParams {
+  /**
+   * One-line description of what the agent should do. Roark authors the system
+   * prompt from this.
+   */
+  jobDescription: string;
+
+  /**
+   * Name of the agent
+   */
+  name: string;
+
+  /**
+   * Optional voice label for the hosted agent
+   */
+  voice?: string | null;
+}
+
 export declare namespace Agent {
   export {
     type AgentCreateResponse as AgentCreateResponse,
     type AgentUpdateResponse as AgentUpdateResponse,
     type AgentListResponse as AgentListResponse,
+    type AgentBuildResponse as AgentBuildResponse,
     type AgentGetByIDResponse as AgentGetByIDResponse,
     type AgentCreateParams as AgentCreateParams,
     type AgentUpdateParams as AgentUpdateParams,
     type AgentListParams as AgentListParams,
+    type AgentBuildParams as AgentBuildParams,
   };
 }