@roarkanalytics/sdk 5.12.0 → 5.14.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [5.14.0](https://github.com/roarkhq/sdk-roark-analytics-node/compare/v5.13.0...v5.14.0) (2026-10-24)
+
+
+### Features
+
+* **api:** api update ([#1376](https://github.com/roarkhq/sdk-roark-analytics-node/issues/1376)) ([063eb87](https://github.com/roarkhq/sdk-roark-analytics-node/commit/063eb878de49ddacafbc1e7f58966ad6765efb5e))
+
+
+### Chores
+
+* fold next into main ([b58fee9](https://github.com/roarkhq/sdk-roark-analytics-node/commit/b58fee9c5803434a174306fdc838d4bb85a66999))
+
+## [5.13.0](https://github.com/roarkhq/sdk-roark-analytics-node/compare/v5.12.0...v5.13.0) (2026-10-24)
+
+
+### Features
+
+* **lib:** code-first config authoring (defineAgent/defineTool/defineConfig) ([#1374](https://github.com/roarkhq/sdk-roark-analytics-node/issues/1374)) ([cd8c8ec](https://github.com/roarkhq/sdk-roark-analytics-node/commit/cd8c8ec55e33c795a0917dea47a0327d6df70904))
+
 ## [5.12.0](https://github.com/roarkhq/sdk-roark-analytics-node/compare/v5.11.0...v5.12.0) (2026-10-22)
 
 

package/lib/config.d.mts

@@ -0,0 +1,45 @@
+import type { ConfigApplyParams } from "../resources/config.mjs";
+export type Ref<T extends {
+    name: string;
+}> = T | string;
+export type AgentConfig = ConfigApplyParams.AgentConfig;
+export type HTTPRequestDefinitionConfig = ConfigApplyParams.HTTPRequestDefinitionConfig;
+export type PersonaConfig = ConfigApplyParams.PersonaConfig;
+export type ImprovFlowConfig = ConfigApplyParams.ImprovFlowConfig;
+export type ScriptedFlowConfig = ConfigApplyParams.ScriptedFlowConfig;
+export type CollectorConfig = ConfigApplyParams.CollectorConfig;
+export type MetricConfig = ConfigApplyParams.MetricConfig;
+export type SimulationPlanConfig = ConfigApplyParams.SimulationPlanConfig;
+export type QaSimulationPlanConfig = ConfigApplyParams.QaSimulationPlanConfig;
+export type SimulationGroupConfig = ConfigApplyParams.SimulationGroupConfig;
+export type AlertConfig = ConfigApplyParams.AlertConfig;
+export type ToolConfig = ConfigApplyParams.ToolConfig;
+export type DashboardConfig = ConfigApplyParams.DashboardConfig;
+export type ProjectConfig = ConfigApplyParams.ProjectConfig;
+/** Any resource a config bundle can carry. */
+export type ResourceConfig = ConfigApplyParams['resources'][number];
+export declare const defineAgent: (agent: Omit<AgentConfig, "kind">) => AgentConfig;
+export declare const defineHTTPRequestDefinition: (def: Omit<HTTPRequestDefinitionConfig, "kind">) => HTTPRequestDefinitionConfig;
+export declare const definePersona: (persona: Omit<PersonaConfig, "kind">) => PersonaConfig;
+export declare const defineImprovFlow: (flow: Omit<ImprovFlowConfig, "kind" | "type">) => ImprovFlowConfig;
+export declare const defineScriptedFlow: (flow: Omit<ScriptedFlowConfig, "kind" | "type">) => ScriptedFlowConfig;
+export declare const defineCollector: (collector: Omit<CollectorConfig, "kind">) => CollectorConfig;
+export declare const defineMetric: (metric: Omit<MetricConfig, "kind">) => MetricConfig;
+export declare const defineSimulationPlan: (plan: Omit<SimulationPlanConfig, "kind">) => SimulationPlanConfig;
+export declare const defineQaSimulationPlan: (plan: Omit<QaSimulationPlanConfig, "kind" | "template">) => QaSimulationPlanConfig;
+export declare const defineSimulationGroup: (group: Omit<SimulationGroupConfig, "kind">) => SimulationGroupConfig;
+export declare const defineAlert: (alert: Omit<AlertConfig, "kind">) => AlertConfig;
+export declare const defineDashboard: (dashboard: Omit<DashboardConfig, "kind">) => DashboardConfig;
+export declare const defineProject: (project: Omit<ProjectConfig, "kind">) => ProjectConfig;
+/** Input to `defineTool`: `agent` accepts the agent construct or a name string. */
+export type DefineToolInput = Omit<ToolConfig, 'kind' | 'agent'> & {
+    /** Scope the tool to one agent (omit for a project-wide tool). */
+    agent?: Ref<AgentConfig>;
+};
+export declare const defineTool: (tool: DefineToolInput) => ToolConfig;
+export declare const defineConfig: (bundle: {
+    resources: Array<ResourceConfig>;
+    /** When true (the server default) config-managed resources absent from the bundle are deleted. */
+    prune?: boolean;
+}) => ConfigApplyParams;
+//# sourceMappingURL=config.d.mts.map

package/lib/config.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.mts","sourceRoot":"","sources":["../src/lib/config.ts"],"names":[],"mappings":"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"}

package/lib/config.d.ts

@@ -0,0 +1,45 @@
+import type { ConfigApplyParams } from "../resources/config.js";
+export type Ref<T extends {
+    name: string;
+}> = T | string;
+export type AgentConfig = ConfigApplyParams.AgentConfig;
+export type HTTPRequestDefinitionConfig = ConfigApplyParams.HTTPRequestDefinitionConfig;
+export type PersonaConfig = ConfigApplyParams.PersonaConfig;
+export type ImprovFlowConfig = ConfigApplyParams.ImprovFlowConfig;
+export type ScriptedFlowConfig = ConfigApplyParams.ScriptedFlowConfig;
+export type CollectorConfig = ConfigApplyParams.CollectorConfig;
+export type MetricConfig = ConfigApplyParams.MetricConfig;
+export type SimulationPlanConfig = ConfigApplyParams.SimulationPlanConfig;
+export type QaSimulationPlanConfig = ConfigApplyParams.QaSimulationPlanConfig;
+export type SimulationGroupConfig = ConfigApplyParams.SimulationGroupConfig;
+export type AlertConfig = ConfigApplyParams.AlertConfig;
+export type ToolConfig = ConfigApplyParams.ToolConfig;
+export type DashboardConfig = ConfigApplyParams.DashboardConfig;
+export type ProjectConfig = ConfigApplyParams.ProjectConfig;
+/** Any resource a config bundle can carry. */
+export type ResourceConfig = ConfigApplyParams['resources'][number];
+export declare const defineAgent: (agent: Omit<AgentConfig, "kind">) => AgentConfig;
+export declare const defineHTTPRequestDefinition: (def: Omit<HTTPRequestDefinitionConfig, "kind">) => HTTPRequestDefinitionConfig;
+export declare const definePersona: (persona: Omit<PersonaConfig, "kind">) => PersonaConfig;
+export declare const defineImprovFlow: (flow: Omit<ImprovFlowConfig, "kind" | "type">) => ImprovFlowConfig;
+export declare const defineScriptedFlow: (flow: Omit<ScriptedFlowConfig, "kind" | "type">) => ScriptedFlowConfig;
+export declare const defineCollector: (collector: Omit<CollectorConfig, "kind">) => CollectorConfig;
+export declare const defineMetric: (metric: Omit<MetricConfig, "kind">) => MetricConfig;
+export declare const defineSimulationPlan: (plan: Omit<SimulationPlanConfig, "kind">) => SimulationPlanConfig;
+export declare const defineQaSimulationPlan: (plan: Omit<QaSimulationPlanConfig, "kind" | "template">) => QaSimulationPlanConfig;
+export declare const defineSimulationGroup: (group: Omit<SimulationGroupConfig, "kind">) => SimulationGroupConfig;
+export declare const defineAlert: (alert: Omit<AlertConfig, "kind">) => AlertConfig;
+export declare const defineDashboard: (dashboard: Omit<DashboardConfig, "kind">) => DashboardConfig;
+export declare const defineProject: (project: Omit<ProjectConfig, "kind">) => ProjectConfig;
+/** Input to `defineTool`: `agent` accepts the agent construct or a name string. */
+export type DefineToolInput = Omit<ToolConfig, 'kind' | 'agent'> & {
+    /** Scope the tool to one agent (omit for a project-wide tool). */
+    agent?: Ref<AgentConfig>;
+};
+export declare const defineTool: (tool: DefineToolInput) => ToolConfig;
+export declare const defineConfig: (bundle: {
+    resources: Array<ResourceConfig>;
+    /** When true (the server default) config-managed resources absent from the bundle are deleted. */
+    prune?: boolean;
+}) => ConfigApplyParams;
+//# sourceMappingURL=config.d.ts.map

package/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/lib/config.ts"],"names":[],"mappings":"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"}

package/lib/config.js

@@ -0,0 +1,91 @@
+"use strict";
+// Code-first config authoring: a typed, ergonomic alternative to hand-written
+// config YAML. Build agents, tools, personas, flows, metrics and the rest in
+// TypeScript, then ship them with `client.config.apply(...)` (or preview with
+// `client.config.diff(...)`).
+//
+// Each `define*` helper injects the resource's `kind` (and any fixed
+// discriminator) and returns the exact param object the config endpoints expect,
+// so the output is identical to the YAML path: both produce a config bundle.
+// Input types are DERIVED from the generated `ConfigApplyParams`, so a new field
+// on a resource (for example a tool `handler`) shows up here automatically on the
+// next codegen, with no change to this file.
+//
+// This lives in `src/lib`, which Stainless codegen never touches. Import it from
+// `@roarkanalytics/sdk/lib/config`.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineConfig = exports.defineTool = exports.defineProject = exports.defineDashboard = exports.defineAlert = exports.defineSimulationGroup = exports.defineQaSimulationPlan = exports.defineSimulationPlan = exports.defineMetric = exports.defineCollector = exports.defineScriptedFlow = exports.defineImprovFlow = exports.definePersona = exports.defineHTTPRequestDefinition = exports.defineAgent = void 0;
+const refName = (ref) => typeof ref === 'string' ? ref : ref.name;
+// ── Builders ──
+// Prompts are just strings here: pass an inline template literal or
+// `readFileSync('./prompt.md', 'utf8')`. No `file://` sentinel needed.
+const defineAgent = (agent) => ({ kind: 'agent', ...agent });
+exports.defineAgent = defineAgent;
+const defineHTTPRequestDefinition = (def) => ({ kind: 'httpRequestDefinition', ...def });
+exports.defineHTTPRequestDefinition = defineHTTPRequestDefinition;
+const definePersona = (persona) => ({
+    kind: 'persona',
+    ...persona,
+});
+exports.definePersona = definePersona;
+const defineImprovFlow = (flow) => ({
+    kind: 'flow',
+    type: 'improv',
+    ...flow,
+});
+exports.defineImprovFlow = defineImprovFlow;
+const defineScriptedFlow = (flow) => ({
+    kind: 'flow',
+    type: 'scripted',
+    ...flow,
+});
+exports.defineScriptedFlow = defineScriptedFlow;
+const defineCollector = (collector) => ({
+    kind: 'collector',
+    ...collector,
+});
+exports.defineCollector = defineCollector;
+const defineMetric = (metric) => ({
+    kind: 'metric',
+    ...metric,
+});
+exports.defineMetric = defineMetric;
+const defineSimulationPlan = (plan) => ({
+    kind: 'simulationPlan',
+    ...plan,
+});
+exports.defineSimulationPlan = defineSimulationPlan;
+const defineQaSimulationPlan = (plan) => ({ kind: 'simulationPlan', template: 'question-answer-check', ...plan });
+exports.defineQaSimulationPlan = defineQaSimulationPlan;
+const defineSimulationGroup = (group) => ({
+    kind: 'simulationGroup',
+    ...group,
+});
+exports.defineSimulationGroup = defineSimulationGroup;
+const defineAlert = (alert) => ({ kind: 'alert', ...alert });
+exports.defineAlert = defineAlert;
+const defineDashboard = (dashboard) => ({
+    kind: 'dashboard',
+    ...dashboard,
+});
+exports.defineDashboard = defineDashboard;
+const defineProject = (project) => ({
+    kind: 'project',
+    ...project,
+});
+exports.defineProject = defineProject;
+const defineTool = (tool) => {
+    const { agent, ...rest } = tool;
+    return { kind: 'tool', ...rest, ...(agent === undefined ? {} : { agent: refName(agent) }) };
+};
+exports.defineTool = defineTool;
+// ── The bundle ──
+// `defineConfig` assembles the bundle you hand to `client.config.apply(bundle)`
+// or `client.config.diff(bundle)`. `resources` accepts both construct outputs
+// and raw resource objects, so a kind without a dedicated builder still fits.
+const defineConfig = (bundle) => ({
+    resources: bundle.resources,
+    ...(bundle.prune === undefined ? {} : { prune: bundle.prune }),
+});
+exports.defineConfig = defineConfig;
+//# sourceMappingURL=config.js.map

package/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/lib/config.ts"],"names":[],"mappings":"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"}

package/lib/config.mjs

@@ -0,0 +1,73 @@
+// Code-first config authoring: a typed, ergonomic alternative to hand-written
+// config YAML. Build agents, tools, personas, flows, metrics and the rest in
+// TypeScript, then ship them with `client.config.apply(...)` (or preview with
+// `client.config.diff(...)`).
+//
+// Each `define*` helper injects the resource's `kind` (and any fixed
+// discriminator) and returns the exact param object the config endpoints expect,
+// so the output is identical to the YAML path: both produce a config bundle.
+// Input types are DERIVED from the generated `ConfigApplyParams`, so a new field
+// on a resource (for example a tool `handler`) shows up here automatically on the
+// next codegen, with no change to this file.
+//
+// This lives in `src/lib`, which Stainless codegen never touches. Import it from
+// `@roarkanalytics/sdk/lib/config`.
+const refName = (ref) => typeof ref === 'string' ? ref : ref.name;
+// ── Builders ──
+// Prompts are just strings here: pass an inline template literal or
+// `readFileSync('./prompt.md', 'utf8')`. No `file://` sentinel needed.
+export const defineAgent = (agent) => ({ kind: 'agent', ...agent });
+export const defineHTTPRequestDefinition = (def) => ({ kind: 'httpRequestDefinition', ...def });
+export const definePersona = (persona) => ({
+    kind: 'persona',
+    ...persona,
+});
+export const defineImprovFlow = (flow) => ({
+    kind: 'flow',
+    type: 'improv',
+    ...flow,
+});
+export const defineScriptedFlow = (flow) => ({
+    kind: 'flow',
+    type: 'scripted',
+    ...flow,
+});
+export const defineCollector = (collector) => ({
+    kind: 'collector',
+    ...collector,
+});
+export const defineMetric = (metric) => ({
+    kind: 'metric',
+    ...metric,
+});
+export const defineSimulationPlan = (plan) => ({
+    kind: 'simulationPlan',
+    ...plan,
+});
+export const defineQaSimulationPlan = (plan) => ({ kind: 'simulationPlan', template: 'question-answer-check', ...plan });
+export const defineSimulationGroup = (group) => ({
+    kind: 'simulationGroup',
+    ...group,
+});
+export const defineAlert = (alert) => ({ kind: 'alert', ...alert });
+export const defineDashboard = (dashboard) => ({
+    kind: 'dashboard',
+    ...dashboard,
+});
+export const defineProject = (project) => ({
+    kind: 'project',
+    ...project,
+});
+export const defineTool = (tool) => {
+    const { agent, ...rest } = tool;
+    return { kind: 'tool', ...rest, ...(agent === undefined ? {} : { agent: refName(agent) }) };
+};
+// ── The bundle ──
+// `defineConfig` assembles the bundle you hand to `client.config.apply(bundle)`
+// or `client.config.diff(bundle)`. `resources` accepts both construct outputs
+// and raw resource objects, so a kind without a dedicated builder still fits.
+export const defineConfig = (bundle) => ({
+    resources: bundle.resources,
+    ...(bundle.prune === undefined ? {} : { prune: bundle.prune }),
+});
+//# sourceMappingURL=config.mjs.map

package/lib/config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.mjs","sourceRoot":"","sources":["../src/lib/config.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roarkanalytics/sdk",
-  "version": "5.12.0",
+  "version": "5.14.0",
   "description": "The official TypeScript library for the Roark API",
   "author": "Roark <james@roark.ai>",
   "types": "./index.d.ts",
@@ -81,6 +81,16 @@
     "./index.mjs": {
       "default": "./index.mjs"
     },
+    "./lib/*.mjs": {
+      "default": "./lib/*.mjs"
+    },
+    "./lib/*.js": {
+      "default": "./lib/*.js"
+    },
+    "./lib/*": {
+      "import": "./lib/*.mjs",
+      "require": "./lib/*.js"
+    },
     "./resource": {
       "import": "./resource.mjs",
       "require": "./resource.js"

package/resources/config.d.mts

@@ -498,11 +498,19 @@ export declare namespace Bundle {
         agent?: string;
         description?: string | null;
         expectedResult?: string | null;
+        handler?: ToolConfig.Handler;
         invocationCriteria?: string | null;
         parameters?: {
             [key: string]: 'string' | 'number' | 'boolean';
         };
     }
+    namespace ToolConfig {
+        interface Handler {
+            type: 'http';
+            url: string;
+            method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+        }
+    }
     interface DashboardConfig {
         kind: 'dashboard';
         name: string;
@@ -1073,11 +1081,19 @@ export declare namespace Bundle {
             agent?: string;
             description?: string | null;
             expectedResult?: string | null;
+            handler?: ToolConfig.Handler;
             invocationCriteria?: string | null;
             parameters?: {
                 [key: string]: 'string' | 'number' | 'boolean';
             };
         }
+        namespace ToolConfig {
+            interface Handler {
+                type: 'http';
+                url: string;
+                method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+            }
+        }
         interface DashboardConfig {
             kind: 'dashboard';
             name: string;
@@ -1726,11 +1742,19 @@ export declare namespace ConfigApplyParams {
         agent?: string;
         description?: string | null;
         expectedResult?: string | null;
+        handler?: ToolConfig.Handler;
         invocationCriteria?: string | null;
         parameters?: {
             [key: string]: 'string' | 'number' | 'boolean';
         };
     }
+    namespace ToolConfig {
+        interface Handler {
+            type: 'http';
+            url: string;
+            method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+        }
+    }
     interface DashboardConfig {
         kind: 'dashboard';
         name: string;
@@ -2301,11 +2325,19 @@ export declare namespace ConfigApplyParams {
             agent?: string;
             description?: string | null;
             expectedResult?: string | null;
+            handler?: ToolConfig.Handler;
             invocationCriteria?: string | null;
             parameters?: {
                 [key: string]: 'string' | 'number' | 'boolean';
             };
         }
+        namespace ToolConfig {
+            interface Handler {
+                type: 'http';
+                url: string;
+                method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+            }
+        }
         interface DashboardConfig {
             kind: 'dashboard';
             name: string;
@@ -2868,11 +2900,19 @@ export declare namespace ConfigDiffParams {
         agent?: string;
         description?: string | null;
         expectedResult?: string | null;
+        handler?: ToolConfig.Handler;
         invocationCriteria?: string | null;
         parameters?: {
             [key: string]: 'string' | 'number' | 'boolean';
         };
     }
+    namespace ToolConfig {
+        interface Handler {
+            type: 'http';
+            url: string;
+            method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+        }
+    }
     interface DashboardConfig {
         kind: 'dashboard';
         name: string;
@@ -3443,11 +3483,19 @@ export declare namespace ConfigDiffParams {
             agent?: string;
             description?: string | null;
             expectedResult?: string | null;
+            handler?: ToolConfig.Handler;
             invocationCriteria?: string | null;
             parameters?: {
                 [key: string]: 'string' | 'number' | 'boolean';
             };
         }
+        namespace ToolConfig {
+            interface Handler {
+                type: 'http';
+                url: string;
+                method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+            }
+        }
         interface DashboardConfig {
             kind: 'dashboard';
             name: string;