@roarkanalytics/sdk 5.16.0 → 5.17.0

package/resources/metric.d.ts

@@ -54,7 +54,7 @@ export interface MetricCreateDefinitionResponse {
     /**
      * The created metric definition. The variant is selected by `calculationType`.
      */
-    data: MetricCreateDefinitionResponse.LlmJudgeMetricResponse | MetricCreateDefinitionResponse.FormulaMetricResponse | MetricCreateDefinitionResponse.PatternMetricResponse;
+    data: MetricCreateDefinitionResponse.LlmJudgeMetricResponse | MetricCreateDefinitionResponse.FormulaMetricResponse | MetricCreateDefinitionResponse.PatternMetricResponse | MetricCreateDefinitionResponse.HTTPRequestMetricResponse;
 }
 export declare namespace MetricCreateDefinitionResponse {
     interface LlmJudgeMetricResponse {
@@ -130,10 +130,12 @@ export declare namespace MetricCreateDefinitionResponse {
         /**
          * Whether you can create a variant of this metric with POST
          * /v1/metric/definitions/{idOrSlug}/variants. False for threshold metrics (their
-         * configuration comes from the metric they derive from), for provider-computed
-         * metrics whose calculation lives in the collector rather than an editable prompt,
-         * and for metrics in a package that manages its own variants. Most of Roark’s own
-         * metrics are false, so read this rather than discovering it from a 403.
+         * configuration comes from the metric they derive from), for HTTP request metrics
+         * (their configuration is the request, edited on the metric), for
+         * provider-computed metrics whose calculation lives in the collector rather than
+         * an editable prompt, and for metrics in a package that manages its own variants.
+         * Most of Roark’s own metrics are false, so read this rather than discovering it
+         * from a 403.
          */
         supportsVariants: boolean;
         /**
@@ -252,10 +254,12 @@ export declare namespace MetricCreateDefinitionResponse {
         /**
          * Whether you can create a variant of this metric with POST
          * /v1/metric/definitions/{idOrSlug}/variants. False for threshold metrics (their
-         * configuration comes from the metric they derive from), for provider-computed
-         * metrics whose calculation lives in the collector rather than an editable prompt,
-         * and for metrics in a package that manages its own variants. Most of Roark’s own
-         * metrics are false, so read this rather than discovering it from a 403.
+         * configuration comes from the metric they derive from), for HTTP request metrics
+         * (their configuration is the request, edited on the metric), for
+         * provider-computed metrics whose calculation lives in the collector rather than
+         * an editable prompt, and for metrics in a package that manages its own variants.
+         * Most of Roark’s own metrics are false, so read this rather than discovering it
+         * from a 403.
          */
         supportsVariants: boolean;
         /**
@@ -387,10 +391,12 @@ export declare namespace MetricCreateDefinitionResponse {
         /**
          * Whether you can create a variant of this metric with POST
          * /v1/metric/definitions/{idOrSlug}/variants. False for threshold metrics (their
-         * configuration comes from the metric they derive from), for provider-computed
-         * metrics whose calculation lives in the collector rather than an editable prompt,
-         * and for metrics in a package that manages its own variants. Most of Roark’s own
-         * metrics are false, so read this rather than discovering it from a 403.
+         * configuration comes from the metric they derive from), for HTTP request metrics
+         * (their configuration is the request, edited on the metric), for
+         * provider-computed metrics whose calculation lives in the collector rather than
+         * an editable prompt, and for metrics in a package that manages its own variants.
+         * Most of Roark’s own metrics are false, so read this rather than discovering it
+         * from a 403.
          */
         supportsVariants: boolean;
         /**
@@ -475,12 +481,165 @@ export declare namespace MetricCreateDefinitionResponse {
             symbol: string | null;
         }
     }
+    interface HTTPRequestMetricResponse {
+        /**
+         * Unique identifier for the metric definition
+         */
+        id: string;
+        /**
+         * What a failed check is called
+         */
+        booleanFalseLabel: string | null;
+        /**
+         * What a passed check is called
+         */
+        booleanTrueLabel: string | null;
+        /**
+         * BOOLEAN metric answered by your own endpoint: Roark sends a request about each
+         * call and records the {"passed", "reason"} it answers with.
+         */
+        calculationType: 'HTTP_REQUEST';
+        /**
+         * Description of what the metric measures
+         */
+        description: string;
+        /**
+         * For a Roark count or rate summed from the per-turn verdicts of a sibling metric
+         * (for example `incorrect_barge_in_yield_count` over
+         * `barge_in_yield_appropriateness`): where the reasoning and transcript positions
+         * live. The count value itself carries neither. `null` for a metric that is its
+         * own evidence.
+         */
+        evidenceSource: HTTPRequestMetricResponse.EvidenceSource | null;
+        /**
+         * The request this metric sends.
+         */
+        httpRequest: HTTPRequestMetricResponse.HTTPRequest | null;
+        /**
+         * Alias of `slug` retained for backwards compatibility. Same value as `slug`.
+         */
+        metricId: string;
+        /**
+         * Name of the metric
+         */
+        name: string;
+        /**
+         * True when this metric can only be scored from a live recording
+         * (`supportedConversationSources` is `["LIVE"]`). Selecting one of these on a
+         * simulation run forces live enrichment: the run waits for your recording and, if
+         * none arrives, the metric produces no value. Check this before a run rather than
+         * discovering the wait afterwards.
+         */
+        requiresLiveConversation: boolean;
+        /**
+         * Whether metric is global or per-participant
+         */
+        scope: 'GLOBAL' | 'PER_PARTICIPANT';
+        /**
+         * Stable metric slug (e.g. "call_reason", "customer_satisfaction")
+         */
+        slug: string;
+        /**
+         * Which levels this metric can produce values at
+         */
+        supportedContexts: Array<'CALL' | 'SEGMENT' | 'TURN'>;
+        /**
+         * Which kinds of conversation this metric can be scored on. `null` means both.
+         * `["LIVE"]` marks a metric that can only be scored from your own recording of a
+         * real call, and `["SIMULATED"]` one that only applies to simulations.
+         */
+        supportedConversationSources: Array<'SIMULATED' | 'LIVE'> | null;
+        /**
+         * Whether you can create a variant of this metric with POST
+         * /v1/metric/definitions/{idOrSlug}/variants. False for threshold metrics (their
+         * configuration comes from the metric they derive from), for HTTP request metrics
+         * (their configuration is the request, edited on the metric), for
+         * provider-computed metrics whose calculation lives in the collector rather than
+         * an editable prompt, and for metrics in a package that manages its own variants.
+         * Most of Roark’s own metrics are false, so read this rather than discovering it
+         * from a 403.
+         */
+        supportsVariants: boolean;
+        /**
+         * Type of value this metric produces
+         */
+        type: 'COUNT' | 'NUMERIC' | 'BOOLEAN' | 'SCALE' | 'TEXT' | 'CLASSIFICATION' | 'OFFSET';
+        /**
+         * The resolved variant this response reflects (org-scoped Default if the org has
+         * customized it, otherwise the system Default). Pass this as sourceVariantId when
+         * building a derived metric off this one to pin the exact config.
+         */
+        variantId: string;
+        /**
+         * The variant's current version. Immutable snapshot of the config — editing the
+         * metric produces a new versionId. Use it to detect config changes.
+         */
+        versionId: string;
+        /**
+         * Unit information if applicable
+         */
+        unit?: HTTPRequestMetricResponse.Unit;
+    }
+    namespace HTTPRequestMetricResponse {
+        /**
+         * For a Roark count or rate summed from the per-turn verdicts of a sibling metric
+         * (for example `incorrect_barge_in_yield_count` over
+         * `barge_in_yield_appropriateness`): where the reasoning and transcript positions
+         * live. The count value itself carries neither. `null` for a metric that is its
+         * own evidence.
+         */
+        interface EvidenceSource {
+            /**
+             * The per-turn value this metric tallies. `false` for an "incorrect" count over an
+             * appropriateness metric, `true` for a count of a boolean event.
+             */
+            countsWhen: boolean;
+            /**
+             * Slug of the metric whose per-turn values are the evidence behind this count or
+             * rate
+             */
+            metricId: string;
+        }
+        /**
+         * The request this metric sends.
+         */
+        interface HTTPRequest {
+            /**
+             * The JSON body template, or null when the default payload is sent
+             */
+            body: string | null;
+            /**
+             * Request headers as key-value pairs
+             */
+            headers: {
+                [key: string]: string;
+            };
+            method: 'GET' | 'POST';
+            /**
+             * The URL the request is sent to, placeholders included
+             */
+            url: string;
+        }
+        /**
+         * Unit information if applicable
+         */
+        interface Unit {
+            /**
+             * Name of the unit
+             */
+            name: string;
+            /**
+             * Symbol for the unit
+             */
+            symbol: string | null;
+        }
+    }
 }
 /**
  * Cursor-paginated metric definitions available in the project
  */
 export interface MetricListDefinitionsResponse {
-    data: Array<MetricListDefinitionsResponse.LlmJudgeMetricResponse | MetricListDefinitionsResponse.ProviderMetricResponse | MetricListDefinitionsResponse.ThresholdMetricResponse | MetricListDefinitionsResponse.FormulaMetricResponse | MetricListDefinitionsResponse.PatternMetricResponse>;
+    data: Array<MetricListDefinitionsResponse.LlmJudgeMetricResponse | MetricListDefinitionsResponse.ProviderMetricResponse | MetricListDefinitionsResponse.ThresholdMetricResponse | MetricListDefinitionsResponse.FormulaMetricResponse | MetricListDefinitionsResponse.PatternMetricResponse | MetricListDefinitionsResponse.HTTPRequestMetricResponse>;
     pagination: MetricListDefinitionsResponse.Pagination;
 }
 export declare namespace MetricListDefinitionsResponse {
@@ -557,10 +716,12 @@ export declare namespace MetricListDefinitionsResponse {
         /**
          * Whether you can create a variant of this metric with POST
          * /v1/metric/definitions/{idOrSlug}/variants. False for threshold metrics (their
-         * configuration comes from the metric they derive from), for provider-computed
-         * metrics whose calculation lives in the collector rather than an editable prompt,
-         * and for metrics in a package that manages its own variants. Most of Roark’s own
-         * metrics are false, so read this rather than discovering it from a 403.
+         * configuration comes from the metric they derive from), for HTTP request metrics
+         * (their configuration is the request, edited on the metric), for
+         * provider-computed metrics whose calculation lives in the collector rather than
+         * an editable prompt, and for metrics in a package that manages its own variants.
+         * Most of Roark’s own metrics are false, so read this rather than discovering it
+         * from a 403.
          */
         supportsVariants: boolean;
         /**
@@ -675,10 +836,12 @@ export declare namespace MetricListDefinitionsResponse {
         /**
          * Whether you can create a variant of this metric with POST
          * /v1/metric/definitions/{idOrSlug}/variants. False for threshold metrics (their
-         * configuration comes from the metric they derive from), for provider-computed
-         * metrics whose calculation lives in the collector rather than an editable prompt,
-         * and for metrics in a package that manages its own variants. Most of Roark’s own
-         * metrics are false, so read this rather than discovering it from a 403.
+         * configuration comes from the metric they derive from), for HTTP request metrics
+         * (their configuration is the request, edited on the metric), for
+         * provider-computed metrics whose calculation lives in the collector rather than
+         * an editable prompt, and for metrics in a package that manages its own variants.
+         * Most of Roark’s own metrics are false, so read this rather than discovering it
+         * from a 403.
          */
         supportsVariants: boolean;
         /**
@@ -793,10 +956,12 @@ export declare namespace MetricListDefinitionsResponse {
         /**
          * Whether you can create a variant of this metric with POST
          * /v1/metric/definitions/{idOrSlug}/variants. False for threshold metrics (their
-         * configuration comes from the metric they derive from), for provider-computed
-         * metrics whose calculation lives in the collector rather than an editable prompt,
-         * and for metrics in a package that manages its own variants. Most of Roark’s own
-         * metrics are false, so read this rather than discovering it from a 403.
+         * configuration comes from the metric they derive from), for HTTP request metrics
+         * (their configuration is the request, edited on the metric), for
+         * provider-computed metrics whose calculation lives in the collector rather than
+         * an editable prompt, and for metrics in a package that manages its own variants.
+         * Most of Roark’s own metrics are false, so read this rather than discovering it
+         * from a 403.
          */
         supportsVariants: boolean;
         /**
@@ -931,10 +1096,12 @@ export declare namespace MetricListDefinitionsResponse {
         /**
          * Whether you can create a variant of this metric with POST
          * /v1/metric/definitions/{idOrSlug}/variants. False for threshold metrics (their
-         * configuration comes from the metric they derive from), for provider-computed
-         * metrics whose calculation lives in the collector rather than an editable prompt,
-         * and for metrics in a package that manages its own variants. Most of Roark’s own
-         * metrics are false, so read this rather than discovering it from a 403.
+         * configuration comes from the metric they derive from), for HTTP request metrics
+         * (their configuration is the request, edited on the metric), for
+         * provider-computed metrics whose calculation lives in the collector rather than
+         * an editable prompt, and for metrics in a package that manages its own variants.
+         * Most of Roark’s own metrics are false, so read this rather than discovering it
+         * from a 403.
          */
         supportsVariants: boolean;
         /**
@@ -1066,10 +1233,12 @@ export declare namespace MetricListDefinitionsResponse {
         /**
          * Whether you can create a variant of this metric with POST
          * /v1/metric/definitions/{idOrSlug}/variants. False for threshold metrics (their
-         * configuration comes from the metric they derive from), for provider-computed
-         * metrics whose calculation lives in the collector rather than an editable prompt,
-         * and for metrics in a package that manages its own variants. Most of Roark’s own
-         * metrics are false, so read this rather than discovering it from a 403.
+         * configuration comes from the metric they derive from), for HTTP request metrics
+         * (their configuration is the request, edited on the metric), for
+         * provider-computed metrics whose calculation lives in the collector rather than
+         * an editable prompt, and for metrics in a package that manages its own variants.
+         * Most of Roark’s own metrics are false, so read this rather than discovering it
+         * from a 403.
          */
         supportsVariants: boolean;
         /**
@@ -1154,6 +1323,159 @@ export declare namespace MetricListDefinitionsResponse {
             symbol: string | null;
         }
     }
+    interface HTTPRequestMetricResponse {
+        /**
+         * Unique identifier for the metric definition
+         */
+        id: string;
+        /**
+         * What a failed check is called
+         */
+        booleanFalseLabel: string | null;
+        /**
+         * What a passed check is called
+         */
+        booleanTrueLabel: string | null;
+        /**
+         * BOOLEAN metric answered by your own endpoint: Roark sends a request about each
+         * call and records the {"passed", "reason"} it answers with.
+         */
+        calculationType: 'HTTP_REQUEST';
+        /**
+         * Description of what the metric measures
+         */
+        description: string;
+        /**
+         * For a Roark count or rate summed from the per-turn verdicts of a sibling metric
+         * (for example `incorrect_barge_in_yield_count` over
+         * `barge_in_yield_appropriateness`): where the reasoning and transcript positions
+         * live. The count value itself carries neither. `null` for a metric that is its
+         * own evidence.
+         */
+        evidenceSource: HTTPRequestMetricResponse.EvidenceSource | null;
+        /**
+         * The request this metric sends.
+         */
+        httpRequest: HTTPRequestMetricResponse.HTTPRequest | null;
+        /**
+         * Alias of `slug` retained for backwards compatibility. Same value as `slug`.
+         */
+        metricId: string;
+        /**
+         * Name of the metric
+         */
+        name: string;
+        /**
+         * True when this metric can only be scored from a live recording
+         * (`supportedConversationSources` is `["LIVE"]`). Selecting one of these on a
+         * simulation run forces live enrichment: the run waits for your recording and, if
+         * none arrives, the metric produces no value. Check this before a run rather than
+         * discovering the wait afterwards.
+         */
+        requiresLiveConversation: boolean;
+        /**
+         * Whether metric is global or per-participant
+         */
+        scope: 'GLOBAL' | 'PER_PARTICIPANT';
+        /**
+         * Stable metric slug (e.g. "call_reason", "customer_satisfaction")
+         */
+        slug: string;
+        /**
+         * Which levels this metric can produce values at
+         */
+        supportedContexts: Array<'CALL' | 'SEGMENT' | 'TURN'>;
+        /**
+         * Which kinds of conversation this metric can be scored on. `null` means both.
+         * `["LIVE"]` marks a metric that can only be scored from your own recording of a
+         * real call, and `["SIMULATED"]` one that only applies to simulations.
+         */
+        supportedConversationSources: Array<'SIMULATED' | 'LIVE'> | null;
+        /**
+         * Whether you can create a variant of this metric with POST
+         * /v1/metric/definitions/{idOrSlug}/variants. False for threshold metrics (their
+         * configuration comes from the metric they derive from), for HTTP request metrics
+         * (their configuration is the request, edited on the metric), for
+         * provider-computed metrics whose calculation lives in the collector rather than
+         * an editable prompt, and for metrics in a package that manages its own variants.
+         * Most of Roark’s own metrics are false, so read this rather than discovering it
+         * from a 403.
+         */
+        supportsVariants: boolean;
+        /**
+         * Type of value this metric produces
+         */
+        type: 'COUNT' | 'NUMERIC' | 'BOOLEAN' | 'SCALE' | 'TEXT' | 'CLASSIFICATION' | 'OFFSET';
+        /**
+         * The resolved variant this response reflects (org-scoped Default if the org has
+         * customized it, otherwise the system Default). Pass this as sourceVariantId when
+         * building a derived metric off this one to pin the exact config.
+         */
+        variantId: string;
+        /**
+         * The variant's current version. Immutable snapshot of the config — editing the
+         * metric produces a new versionId. Use it to detect config changes.
+         */
+        versionId: string;
+        /**
+         * Unit information if applicable
+         */
+        unit?: HTTPRequestMetricResponse.Unit;
+    }
+    namespace HTTPRequestMetricResponse {
+        /**
+         * For a Roark count or rate summed from the per-turn verdicts of a sibling metric
+         * (for example `incorrect_barge_in_yield_count` over
+         * `barge_in_yield_appropriateness`): where the reasoning and transcript positions
+         * live. The count value itself carries neither. `null` for a metric that is its
+         * own evidence.
+         */
+        interface EvidenceSource {
+            /**
+             * The per-turn value this metric tallies. `false` for an "incorrect" count over an
+             * appropriateness metric, `true` for a count of a boolean event.
+             */
+            countsWhen: boolean;
+            /**
+             * Slug of the metric whose per-turn values are the evidence behind this count or
+             * rate
+             */
+            metricId: string;
+        }
+        /**
+         * The request this metric sends.
+         */
+        interface HTTPRequest {
+            /**
+             * The JSON body template, or null when the default payload is sent
+             */
+            body: string | null;
+            /**
+             * Request headers as key-value pairs
+             */
+            headers: {
+                [key: string]: string;
+            };
+            method: 'GET' | 'POST';
+            /**
+             * The URL the request is sent to, placeholders included
+             */
+            url: string;
+        }
+        /**
+         * Unit information if applicable
+         */
+        interface Unit {
+            /**
+             * Name of the unit
+             */
+            name: string;
+            /**
+             * Symbol for the unit
+             */
+            symbol: string | null;
+        }
+    }
     interface Pagination {
         hasMore: boolean;
         limit: number;
@@ -1164,7 +1486,7 @@ export interface MetricUpdateDefinitionResponse {
     /**
      * The updated metric definition. The variant is selected by `calculationType`.
      */
-    data: MetricUpdateDefinitionResponse.LlmJudgeMetricResponse | MetricUpdateDefinitionResponse.FormulaMetricResponse | MetricUpdateDefinitionResponse.PatternMetricResponse | MetricUpdateDefinitionResponse.ThresholdMetricResponse;
+    data: MetricUpdateDefinitionResponse.LlmJudgeMetricResponse | MetricUpdateDefinitionResponse.FormulaMetricResponse | MetricUpdateDefinitionResponse.PatternMetricResponse | MetricUpdateDefinitionResponse.ThresholdMetricResponse | MetricUpdateDefinitionResponse.HTTPRequestMetricResponse;
 }
 export declare namespace MetricUpdateDefinitionResponse {
     interface LlmJudgeMetricResponse {
@@ -1240,10 +1562,12 @@ export declare namespace MetricUpdateDefinitionResponse {
         /**
          * Whether you can create a variant of this metric with POST
          * /v1/metric/definitions/{idOrSlug}/variants. False for threshold metrics (their
-         * configuration comes from the metric they derive from), for provider-computed
-         * metrics whose calculation lives in the collector rather than an editable prompt,
-         * and for metrics in a package that manages its own variants. Most of Roark’s own
-         * metrics are false, so read this rather than discovering it from a 403.
+         * configuration comes from the metric they derive from), for HTTP request metrics
+         * (their configuration is the request, edited on the metric), for
+         * provider-computed metrics whose calculation lives in the collector rather than
+         * an editable prompt, and for metrics in a package that manages its own variants.
+         * Most of Roark’s own metrics are false, so read this rather than discovering it
+         * from a 403.
          */
         supportsVariants: boolean;
         /**
@@ -1362,10 +1686,12 @@ export declare namespace MetricUpdateDefinitionResponse {
         /**
          * Whether you can create a variant of this metric with POST
          * /v1/metric/definitions/{idOrSlug}/variants. False for threshold metrics (their
-         * configuration comes from the metric they derive from), for provider-computed
-         * metrics whose calculation lives in the collector rather than an editable prompt,
-         * and for metrics in a package that manages its own variants. Most of Roark’s own
-         * metrics are false, so read this rather than discovering it from a 403.
+         * configuration comes from the metric they derive from), for HTTP request metrics
+         * (their configuration is the request, edited on the metric), for
+         * provider-computed metrics whose calculation lives in the collector rather than
+         * an editable prompt, and for metrics in a package that manages its own variants.
+         * Most of Roark’s own metrics are false, so read this rather than discovering it
+         * from a 403.
          */
         supportsVariants: boolean;
         /**
@@ -1497,10 +1823,12 @@ export declare namespace MetricUpdateDefinitionResponse {
         /**
          * Whether you can create a variant of this metric with POST
          * /v1/metric/definitions/{idOrSlug}/variants. False for threshold metrics (their
-         * configuration comes from the metric they derive from), for provider-computed
-         * metrics whose calculation lives in the collector rather than an editable prompt,
-         * and for metrics in a package that manages its own variants. Most of Roark’s own
-         * metrics are false, so read this rather than discovering it from a 403.
+         * configuration comes from the metric they derive from), for HTTP request metrics
+         * (their configuration is the request, edited on the metric), for
+         * provider-computed metrics whose calculation lives in the collector rather than
+         * an editable prompt, and for metrics in a package that manages its own variants.
+         * Most of Roark’s own metrics are false, so read this rather than discovering it
+         * from a 403.
          */
         supportsVariants: boolean;
         /**
@@ -1643,10 +1971,12 @@ export declare namespace MetricUpdateDefinitionResponse {
         /**
          * Whether you can create a variant of this metric with POST
          * /v1/metric/definitions/{idOrSlug}/variants. False for threshold metrics (their
-         * configuration comes from the metric they derive from), for provider-computed
-         * metrics whose calculation lives in the collector rather than an editable prompt,
-         * and for metrics in a package that manages its own variants. Most of Roark’s own
-         * metrics are false, so read this rather than discovering it from a 403.
+         * configuration comes from the metric they derive from), for HTTP request metrics
+         * (their configuration is the request, edited on the metric), for
+         * provider-computed metrics whose calculation lives in the collector rather than
+         * an editable prompt, and for metrics in a package that manages its own variants.
+         * Most of Roark’s own metrics are false, so read this rather than discovering it
+         * from a 403.
          */
         supportsVariants: boolean;
         /**
@@ -1719,8 +2049,161 @@ export declare namespace MetricUpdateDefinitionResponse {
             symbol: string | null;
         }
     }
+    interface HTTPRequestMetricResponse {
+        /**
+         * Unique identifier for the metric definition
+         */
+        id: string;
+        /**
+         * What a failed check is called
+         */
+        booleanFalseLabel: string | null;
+        /**
+         * What a passed check is called
+         */
+        booleanTrueLabel: string | null;
+        /**
+         * BOOLEAN metric answered by your own endpoint: Roark sends a request about each
+         * call and records the {"passed", "reason"} it answers with.
+         */
+        calculationType: 'HTTP_REQUEST';
+        /**
+         * Description of what the metric measures
+         */
+        description: string;
+        /**
+         * For a Roark count or rate summed from the per-turn verdicts of a sibling metric
+         * (for example `incorrect_barge_in_yield_count` over
+         * `barge_in_yield_appropriateness`): where the reasoning and transcript positions
+         * live. The count value itself carries neither. `null` for a metric that is its
+         * own evidence.
+         */
+        evidenceSource: HTTPRequestMetricResponse.EvidenceSource | null;
+        /**
+         * The request this metric sends.
+         */
+        httpRequest: HTTPRequestMetricResponse.HTTPRequest | null;
+        /**
+         * Alias of `slug` retained for backwards compatibility. Same value as `slug`.
+         */
+        metricId: string;
+        /**
+         * Name of the metric
+         */
+        name: string;
+        /**
+         * True when this metric can only be scored from a live recording
+         * (`supportedConversationSources` is `["LIVE"]`). Selecting one of these on a
+         * simulation run forces live enrichment: the run waits for your recording and, if
+         * none arrives, the metric produces no value. Check this before a run rather than
+         * discovering the wait afterwards.
+         */
+        requiresLiveConversation: boolean;
+        /**
+         * Whether metric is global or per-participant
+         */
+        scope: 'GLOBAL' | 'PER_PARTICIPANT';
+        /**
+         * Stable metric slug (e.g. "call_reason", "customer_satisfaction")
+         */
+        slug: string;
+        /**
+         * Which levels this metric can produce values at
+         */
+        supportedContexts: Array<'CALL' | 'SEGMENT' | 'TURN'>;
+        /**
+         * Which kinds of conversation this metric can be scored on. `null` means both.
+         * `["LIVE"]` marks a metric that can only be scored from your own recording of a
+         * real call, and `["SIMULATED"]` one that only applies to simulations.
+         */
+        supportedConversationSources: Array<'SIMULATED' | 'LIVE'> | null;
+        /**
+         * Whether you can create a variant of this metric with POST
+         * /v1/metric/definitions/{idOrSlug}/variants. False for threshold metrics (their
+         * configuration comes from the metric they derive from), for HTTP request metrics
+         * (their configuration is the request, edited on the metric), for
+         * provider-computed metrics whose calculation lives in the collector rather than
+         * an editable prompt, and for metrics in a package that manages its own variants.
+         * Most of Roark’s own metrics are false, so read this rather than discovering it
+         * from a 403.
+         */
+        supportsVariants: boolean;
+        /**
+         * Type of value this metric produces
+         */
+        type: 'COUNT' | 'NUMERIC' | 'BOOLEAN' | 'SCALE' | 'TEXT' | 'CLASSIFICATION' | 'OFFSET';
+        /**
+         * The resolved variant this response reflects (org-scoped Default if the org has
+         * customized it, otherwise the system Default). Pass this as sourceVariantId when
+         * building a derived metric off this one to pin the exact config.
+         */
+        variantId: string;
+        /**
+         * The variant's current version. Immutable snapshot of the config — editing the
+         * metric produces a new versionId. Use it to detect config changes.
+         */
+        versionId: string;
+        /**
+         * Unit information if applicable
+         */
+        unit?: HTTPRequestMetricResponse.Unit;
+    }
+    namespace HTTPRequestMetricResponse {
+        /**
+         * For a Roark count or rate summed from the per-turn verdicts of a sibling metric
+         * (for example `incorrect_barge_in_yield_count` over
+         * `barge_in_yield_appropriateness`): where the reasoning and transcript positions
+         * live. The count value itself carries neither. `null` for a metric that is its
+         * own evidence.
+         */
+        interface EvidenceSource {
+            /**
+             * The per-turn value this metric tallies. `false` for an "incorrect" count over an
+             * appropriateness metric, `true` for a count of a boolean event.
+             */
+            countsWhen: boolean;
+            /**
+             * Slug of the metric whose per-turn values are the evidence behind this count or
+             * rate
+             */
+            metricId: string;
+        }
+        /**
+         * The request this metric sends.
+         */
+        interface HTTPRequest {
+            /**
+             * The JSON body template, or null when the default payload is sent
+             */
+            body: string | null;
+            /**
+             * Request headers as key-value pairs
+             */
+            headers: {
+                [key: string]: string;
+            };
+            method: 'GET' | 'POST';
+            /**
+             * The URL the request is sent to, placeholders included
+             */
+            url: string;
+        }
+        /**
+         * Unit information if applicable
+         */
+        interface Unit {
+            /**
+             * Name of the unit
+             */
+            name: string;
+            /**
+             * Symbol for the unit
+             */
+            symbol: string | null;
+        }
+    }
 }
-export type MetricCreateDefinitionParams = MetricCreateDefinitionParams.PromptMetricInput | MetricCreateDefinitionParams.FormulaMetricInput | MetricCreateDefinitionParams.PatternMetricInput;
+export type MetricCreateDefinitionParams = MetricCreateDefinitionParams.PromptMetricInput | MetricCreateDefinitionParams.FormulaMetricInput | MetricCreateDefinitionParams.PatternMetricInput | MetricCreateDefinitionParams.HTTPRequestMetricInput;
 export declare namespace MetricCreateDefinitionParams {
     interface PromptMetricInput {
         /**
@@ -1972,6 +2455,76 @@ export declare namespace MetricCreateDefinitionParams {
             sourceVariantId?: string;
         }
     }
+    interface HTTPRequestMetricInput {
+        /**
+         * BOOLEAN metric answered by your own endpoint. Roark sends a request about each
+         * call, live or simulated, and your endpoint answers {"passed": true | false,
+         * "reason": "..."}.
+         */
+        calculationType: 'HTTP_REQUEST';
+        /**
+         * The request to send. With no body, Roark POSTs the default payload: { version,
+         * requestId, metric, call, simulation }.
+         */
+        httpRequest: HTTPRequestMetricInput.HTTPRequest;
+        /**
+         * Name of the metric
+         */
+        name: string;
+        /**
+         * ID of the analysis package to add this metric to. Optional: when omitted, the
+         * metric is added to a default "Custom Metrics" package for your project (created
+         * automatically the first time).
+         */
+        analysisPackageId?: string;
+        /**
+         * What a failed check is called (default: Fail)
+         */
+        booleanFalseLabel?: string;
+        /**
+         * What a passed check is called (default: Pass)
+         */
+        booleanTrueLabel?: string;
+        /**
+         * Alias of `slug` accepted for backwards compatibility. Use `slug` for new
+         * integrations.
+         */
+        metricId?: string;
+        /**
+         * Stable slug for the metric. Auto-generated from name if omitted.
+         */
+        slug?: string;
+    }
+    namespace HTTPRequestMetricInput {
+        /**
+         * The request to send. With no body, Roark POSTs the default payload: { version,
+         * requestId, metric, call, simulation }.
+         */
+        interface HTTPRequest {
+            /**
+             * Public http(s) URL. May contain {{path}} placeholders into the request payload,
+             * which are URL-encoded.
+             */
+            url: string;
+            /**
+             * A JSON template with {{path}} placeholders into the request payload, such as
+             * {"cardId": "{{call.properties.cardId}}"}. Omit or pass null to send the default
+             * payload.
+             */
+            body?: string | null;
+            /**
+             * Request headers, for example your own Authorization header. Values may contain
+             * placeholders.
+             */
+            headers?: {
+                [key: string]: string;
+            };
+            /**
+             * GET or POST (default POST). A GET request has no body.
+             */
+            method?: 'GET' | 'POST';
+        }
+    }
 }
 export interface MetricListDefinitionsParams {
     after?: string;
@@ -2001,6 +2554,11 @@ export interface MetricUpdateDefinitionParams {
      * referenced metrics change.
      */
     formula?: string;
+    /**
+     * Replacement request (HTTP_REQUEST only). Send the whole request; omitted headers
+     * are removed.
+     */
+    httpRequest?: MetricUpdateDefinitionParams.HTTPRequest;
     /**
      * New LLM prompt (only for LLM_JUDGE metrics whose prompt is editable)
      */
@@ -2060,6 +2618,34 @@ export declare namespace MetricUpdateDefinitionParams {
         displayOrder: number;
         label: string;
     }
+    /**
+     * Replacement request (HTTP_REQUEST only). Send the whole request; omitted headers
+     * are removed.
+     */
+    interface HTTPRequest {
+        /**
+         * Public http(s) URL. May contain {{path}} placeholders into the request payload,
+         * which are URL-encoded.
+         */
+        url: string;
+        /**
+         * A JSON template with {{path}} placeholders into the request payload, such as
+         * {"cardId": "{{call.properties.cardId}}"}. Omit or pass null to send the default
+         * payload.
+         */
+        body?: string | null;
+        /**
+         * Request headers, for example your own Authorization header. Values may contain
+         * placeholders.
+         */
+        headers?: {
+            [key: string]: string;
+        };
+        /**
+         * GET or POST (default POST). A GET request has no body.
+         */
+        method?: 'GET' | 'POST';
+    }
     interface ScaleLabel {
         /**
          * Display order of this label