@roarkanalytics/sdk 5.12.0 → 5.13.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [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.13.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/src/lib/config.ts

@@ -0,0 +1,131 @@
+// 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`.
+
+import type { ConfigApplyParams } from '../resources/config';
+
+// ── Cross-references ──
+// A resource that points at another by name accepts either the construct a
+// `define*` helper returned (its `name` is used) or a bare name string.
+export type Ref<T extends { name: string }> = T | string;
+
+const refName = <T extends { name: string }>(ref: Ref<T>): string =>
+  typeof ref === 'string' ? ref : ref.name;
+
+// ── Friendly aliases for the generated param types ──
+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];
+
+// ── Builders ──
+// Prompts are just strings here: pass an inline template literal or
+// `readFileSync('./prompt.md', 'utf8')`. No `file://` sentinel needed.
+
+export const defineAgent = (agent: Omit<AgentConfig, 'kind'>): AgentConfig => ({ kind: 'agent', ...agent });
+
+export const defineHTTPRequestDefinition = (
+  def: Omit<HTTPRequestDefinitionConfig, 'kind'>,
+): HTTPRequestDefinitionConfig => ({ kind: 'httpRequestDefinition', ...def });
+
+export const definePersona = (persona: Omit<PersonaConfig, 'kind'>): PersonaConfig => ({
+  kind: 'persona',
+  ...persona,
+});
+
+export const defineImprovFlow = (flow: Omit<ImprovFlowConfig, 'kind' | 'type'>): ImprovFlowConfig => ({
+  kind: 'flow',
+  type: 'improv',
+  ...flow,
+});
+
+export const defineScriptedFlow = (flow: Omit<ScriptedFlowConfig, 'kind' | 'type'>): ScriptedFlowConfig => ({
+  kind: 'flow',
+  type: 'scripted',
+  ...flow,
+});
+
+export const defineCollector = (collector: Omit<CollectorConfig, 'kind'>): CollectorConfig => ({
+  kind: 'collector',
+  ...collector,
+});
+
+export const defineMetric = (metric: Omit<MetricConfig, 'kind'>): MetricConfig => ({
+  kind: 'metric',
+  ...metric,
+});
+
+export const defineSimulationPlan = (plan: Omit<SimulationPlanConfig, 'kind'>): SimulationPlanConfig => ({
+  kind: 'simulationPlan',
+  ...plan,
+});
+
+export const defineQaSimulationPlan = (
+  plan: Omit<QaSimulationPlanConfig, 'kind' | 'template'>,
+): QaSimulationPlanConfig => ({ kind: 'simulationPlan', template: 'question-answer-check', ...plan });
+
+export const defineSimulationGroup = (group: Omit<SimulationGroupConfig, 'kind'>): SimulationGroupConfig => ({
+  kind: 'simulationGroup',
+  ...group,
+});
+
+export const defineAlert = (alert: Omit<AlertConfig, 'kind'>): AlertConfig => ({ kind: 'alert', ...alert });
+
+export const defineDashboard = (dashboard: Omit<DashboardConfig, 'kind'>): DashboardConfig => ({
+  kind: 'dashboard',
+  ...dashboard,
+});
+
+export const defineProject = (project: Omit<ProjectConfig, 'kind'>): ProjectConfig => ({
+  kind: 'project',
+  ...project,
+});
+
+/** 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 const defineTool = (tool: DefineToolInput): ToolConfig => {
+  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: Array<ResourceConfig>;
+  /** When true (the server default) config-managed resources absent from the bundle are deleted. */
+  prune?: boolean;
+}): ConfigApplyParams => ({
+  resources: bundle.resources,
+  ...(bundle.prune === undefined ? {} : { prune: bundle.prune }),
+});

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '5.12.0'; // x-release-please-version
+export const VERSION = '5.13.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "5.12.0";
+export declare const VERSION = "5.13.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "5.12.0";
+export declare const VERSION = "5.13.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '5.12.0'; // x-release-please-version
+exports.VERSION = '5.13.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '5.12.0'; // x-release-please-version
+export const VERSION = '5.13.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map