@kortyx/telemetry-contracts 0.17.1 → 0.18.0

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## [0.18.0](https://github.com/kortyx-io/kortyx/compare/telemetry-contracts-v0.17.2...telemetry-contracts-v0.18.0) (2026-10-16)
+
+
+### Features
+
+* **evals:** configurable deadlines and original error visibility ([#354](https://github.com/kortyx-io/kortyx/issues/354)) ([7dde173](https://github.com/kortyx-io/kortyx/commit/7dde173b54eb37a2d28ff28ac342a3333e5ed902))
+* **studio:** standardize tables, filters and column behavior ([#353](https://github.com/kortyx-io/kortyx/issues/353)) ([c662e59](https://github.com/kortyx-io/kortyx/commit/c662e59d814a6a9f12c709595968ee7b1ece3191))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @kortyx/prompts bumped to 0.2.2
+    * @kortyx/core bumped to 0.15.0
+
+## [0.17.2](https://github.com/kortyx-io/kortyx/compare/telemetry-contracts-v0.17.1...telemetry-contracts-v0.17.2) (2026-10-13)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @kortyx/prompts bumped to 0.2.1
+
 ## [0.17.1](https://github.com/kortyx-io/kortyx/compare/telemetry-contracts-v0.17.0...telemetry-contracts-v0.17.1) (2026-10-13)
 
 

package/README.md

@@ -1,3 +1,21 @@
 # @kortyx/telemetry-contracts
 
 Shared Zod wire contracts and fixtures for Kortyx telemetry producers and consumers.
+
+Studio tables share `TableFiltersSchema`, `TableFilterRuleSchema`, the field
+registries and validation/matching helpers. Groups select `match: "all" | "any"`;
+values within a rule are alternatives. Text comparison is case-insensitive and
+literal (wildcards are not query syntax). Negative comparisons require a value;
+`missing` explicitly selects absent data. Pass field definitions to the matcher
+so date equality compares instants, while text equality compares literal text.
+
+Limits: 32 rules, 30 values per rule, 512 characters per string, 32 KiB serialized
+filters. Dates require ISO timestamps with an offset. Unknown fields, unsupported
+operators, malformed values and reversed ranges fail validation. Legacy Studio
+query aliases remain readable through `readStudioTableFilters`.
+
+Column registries include execution identity, environment, completion timestamps,
+prompt assignments and evaluation judge metadata. `tablePassRate` returns a
+percentage of recorded passed/failed/error cases (unrun cases are excluded), or
+no value when none finished. `tableQueueMs` returns elapsed queue milliseconds
+only when a valid start timestamp is recorded.

package/dist/index.d.ts

@@ -41,6 +41,11 @@ type DiagnosticContent = z.infer<typeof DiagnosticContentSchema>;
 type DiagnosticNote = z.infer<typeof DiagnosticNoteSchema>;
 declare const DiagnosticCorrelationSchema: z.ZodObject<{
     runId: z.ZodOptional<z.ZodString>;
+    evaluationId: z.ZodOptional<z.ZodString>;
+    suiteRunId: z.ZodOptional<z.ZodString>;
+    caseId: z.ZodOptional<z.ZodString>;
+    repetition: z.ZodOptional<z.ZodString>;
+    phase: z.ZodOptional<z.ZodString>;
     workflowId: z.ZodOptional<z.ZodString>;
     nodeId: z.ZodOptional<z.ZodString>;
     sessionId: z.ZodOptional<z.ZodString>;
@@ -66,6 +71,11 @@ declare const DiagnosticManifestSchema: z.ZodObject<{
     }, z.core.$strict>;
     correlation: z.ZodObject<{
         runId: z.ZodOptional<z.ZodString>;
+        evaluationId: z.ZodOptional<z.ZodString>;
+        suiteRunId: z.ZodOptional<z.ZodString>;
+        caseId: z.ZodOptional<z.ZodString>;
+        repetition: z.ZodOptional<z.ZodString>;
+        phase: z.ZodOptional<z.ZodString>;
         workflowId: z.ZodOptional<z.ZodString>;
         nodeId: z.ZodOptional<z.ZodString>;
         sessionId: z.ZodOptional<z.ZodString>;
@@ -120,6 +130,11 @@ declare const DiagnosticResponseSchema: z.ZodObject<{
         }, z.core.$strict>;
         correlation: z.ZodObject<{
             runId: z.ZodOptional<z.ZodString>;
+            evaluationId: z.ZodOptional<z.ZodString>;
+            suiteRunId: z.ZodOptional<z.ZodString>;
+            caseId: z.ZodOptional<z.ZodString>;
+            repetition: z.ZodOptional<z.ZodString>;
+            phase: z.ZodOptional<z.ZodString>;
             workflowId: z.ZodOptional<z.ZodString>;
             nodeId: z.ZodOptional<z.ZodString>;
             sessionId: z.ZodOptional<z.ZodString>;
@@ -517,6 +532,9 @@ declare const StudioToolSchema: z.ZodObject<{
 type WorkflowTool = z.infer<typeof WorkflowToolSchema>;
 type StudioTool = z.infer<typeof StudioToolSchema>;
 
+/** Data-only graph capture. Getters and application toJSON methods are never invoked. */
+declare function captureDiagnosticContent(error: unknown, project?: (error: unknown) => Record<string, unknown> | null): DiagnosticContent | null;
+
 declare const PromptCategorySchema: z.ZodObject<{
     id: z.ZodUUID;
     name: z.ZodString;
@@ -1247,6 +1265,122 @@ type StudioUpdateStatus = z.infer<typeof StudioUpdateStatusSchema>;
 declare function newerStudioVersion(candidate: string, current: string): boolean;
 declare function studioUpdateRunning(operation: StudioUpdateOperation | null): boolean;
 
+declare const TableFilterRuleSchema: z.ZodObject<{
+    field: z.ZodString;
+    operator: z.ZodEnum<{
+        contains: "contains";
+        notContains: "notContains";
+        is: "is";
+        isNot: "isNot";
+        gt: "gt";
+        gte: "gte";
+        lt: "lt";
+        lte: "lte";
+        between: "between";
+        present: "present";
+        missing: "missing";
+    }>;
+    values: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+}, z.core.$strict>;
+declare const TableFiltersSchema: z.ZodObject<{
+    match: z.ZodEnum<{
+        any: "any";
+        all: "all";
+    }>;
+    rules: z.ZodArray<z.ZodObject<{
+        field: z.ZodString;
+        operator: z.ZodEnum<{
+            contains: "contains";
+            notContains: "notContains";
+            is: "is";
+            isNot: "isNot";
+            gt: "gt";
+            gte: "gte";
+            lt: "lt";
+            lte: "lte";
+            between: "between";
+            present: "present";
+            missing: "missing";
+        }>;
+        values: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type TableFilterRule = z.infer<typeof TableFilterRuleSchema>;
+type TableFilters = z.infer<typeof TableFiltersSchema>;
+type TableFilterKind = "text" | "enum" | "number" | "date" | "boolean";
+type TableFilterValue = string | number | boolean | null | undefined;
+type TableFilterDefinition = {
+    key: string;
+    label: string;
+    kind: TableFilterKind;
+    options?: readonly string[];
+    unit?: string;
+};
+declare const EMPTY_TABLE_FILTERS: TableFilters;
+declare const filterOperators: (kind: TableFilterKind) => TableFilterRule["operator"][];
+declare function validateTableFilters(filters: TableFilters, fields: readonly TableFilterDefinition[]): {
+    match: "any" | "all";
+    rules: {
+        field: string;
+        operator: "contains" | "notContains" | "is" | "isNot" | "gt" | "gte" | "lt" | "lte" | "between" | "present" | "missing";
+        values: (string | number | boolean)[];
+    }[];
+};
+declare function matchesTableRule(value: TableFilterValue | readonly TableFilterValue[], rule: TableFilterRule, kind?: TableFilterKind): boolean;
+declare function matchesTableFilters(filters: TableFilters, read: (key: string) => TableFilterValue | readonly TableFilterValue[], fields?: readonly TableFilterDefinition[]): boolean;
+declare const STUDIO_TABLE_FIELDS: {
+    runs: TableFilterDefinition[];
+    sessions: TableFilterDefinition[];
+    interrupts: TableFilterDefinition[];
+};
+type StudioTableResource = keyof typeof STUDIO_TABLE_FIELDS;
+/** Existing links/views remain valid; new edits replace these aliases atomically. */
+declare const LEGACY_TABLE_FILTERS: {
+    readonly toolName: readonly ["toolName", "contains"];
+    readonly toolOutcome: readonly ["toolOutcome", "is"];
+    readonly toolMode: readonly ["toolMode", "is"];
+    readonly error: readonly ["hasError", "is"];
+    readonly interrupt: readonly ["hasInterrupt", "is"];
+    readonly checkpoint: readonly ["hasCheckpoint", "is"];
+    readonly fork: readonly ["hasFork", "is"];
+    readonly transition: readonly ["transitionIds", "is"];
+    readonly status: readonly ["status", "is"];
+    readonly provider: readonly ["provider", "is"];
+    readonly workflow: readonly ["workflowIds", "is"];
+    readonly version: readonly ["versions", "is"];
+    readonly path: readonly ["path", "is"];
+    readonly session: readonly ["sessionId", "contains"];
+    readonly model: readonly ["models", "contains"];
+    readonly result: readonly ["result", "contains"];
+    readonly feedback: readonly ["feedback", "is"];
+    readonly tool: readonly ["hasTool", "is"];
+    readonly user: readonly ["userId", "contains"];
+    readonly tenant: readonly ["tenantId", "contains"];
+    readonly tags: readonly ["tags", "contains"];
+    readonly node: readonly ["nodeId", "contains"];
+    readonly resolver: readonly ["resolvedBy", "contains"];
+    readonly outcome: readonly ["resumeOutcome", "is"];
+    readonly type: readonly ["type", "is"];
+    readonly minCost: readonly ["cost", "gte"];
+    readonly maxCost: readonly ["cost", "lte"];
+    readonly minTokens: readonly ["tokens", "gte"];
+    readonly maxTokens: readonly ["tokens", "lte"];
+    readonly minDuration: readonly ["durationMs", "gte"];
+    readonly maxDuration: readonly ["durationMs", "lte"];
+    readonly minAge: readonly ["age", "gte"];
+    readonly maxAge: readonly ["age", "lte"];
+};
+declare function readStudioTableFilters(query: Record<string, string | undefined>, resource: StudioTableResource): TableFilters;
+declare const PROMPT_TABLE_FILTER_FIELDS: TableFilterDefinition[];
+declare const EVALUATION_TABLE_FILTER_FIELDS: TableFilterDefinition[];
+/** Completed attempt outcomes; cancelled and unrun attempts are excluded. */
+declare function tablePassRate(counts: {
+    passed: number;
+    failed: number;
+    error: number;
+} | null | undefined): number;
+declare function tableQueueMs(createdAt: string, startedAt: string | null | undefined): number;
+
 type StudioWorkflowCall = {
     id: string;
     invocationId: string;
@@ -3618,4 +3752,4 @@ type StudioWorkflowsResponse = z.infer<typeof StudioWorkflowsResponseSchema>;
 type StudioCatalogsResponse = z.infer<typeof StudioCatalogsResponseSchema>;
 type StudioContextResponse = z.infer<typeof StudioContextResponseSchema>;
 
-export { ClearScoreResponseSchema, ClearUserFeedbackRequestSchema, DIAGNOSTIC_LIMITS, type DiagnosticContent, DiagnosticContentSchema, DiagnosticCorrelationSchema, type DiagnosticManifest, DiagnosticManifestSchema, type DiagnosticNote, DiagnosticNoteSchema, DiagnosticPartSchema, type DiagnosticResponse, DiagnosticResponseSchema, type EnsureWorkflowTopologyRequest, EnsureWorkflowTopologyRequestSchema, type EnsureWorkflowTopologyResponse, EnsureWorkflowTopologyResponseSchema, FEEDBACK_FILTERS, FeedbackReasonSchema, type FeedbackSummary, FeedbackSummarySchema, type KortyxTelemetryEvent, type KortyxTelemetryEventType, type KortyxTelemetryService, type KortyxWorkflowTopologyEdge, type KortyxWorkflowTopologyNode, type KortyxWorkflowTopologyTransition, PromptAssetSchema, PromptAssignmentSchema, type PromptBundle, PromptBundleSchema, type PromptCategory, PromptCategorySchema, type PromptDetail, PromptDetailSchema, type PromptEvidence, PromptEvidenceSchema, type PromptGroup, PromptGroupSchema, type PromptLibrary, PromptLibrarySchema, type PromptMutation, PromptMutationSchema, PromptPolicySchema, type PromptSelection, PromptSelectionSchema, PromptStoredVersionSchema, type PromptTransferRequest, PromptTransferRequestSchema, PromptUsageSchema, ReviewVerdictSchema, STUDIO_API_PROTOCOL_VERSION, STUDIO_TIME_RANGES, type StudioCatalogsResponse, StudioCatalogsResponseSchema, type StudioChange, type StudioChangeResource, StudioChangeResourceSchema, StudioChangeSchema, type StudioContextResponse, StudioContextResponseSchema, type StudioCostSummary, StudioCostSummarySchema, type StudioDetailEvent, StudioDetailEventSchema, type StudioInterrupt, type StudioInterruptDetailResponse, StudioInterruptDetailResponseSchema, type StudioInterruptInteractionMode, StudioInterruptInteractionModeSchema, type StudioInterruptOption, StudioInterruptOptionSchema, StudioInterruptSchema, type StudioInterruptStatus, StudioInterruptStatusSchema, type StudioInterruptType, StudioInterruptTypeSchema, StudioInterruptValueSchema, type StudioInterruptsResponse, StudioInterruptsResponseSchema, type StudioMetric, StudioMetricSchema, type StudioPricingSource, StudioPricingSourceSchema, type StudioPricingStatus, StudioPricingStatusSchema, type StudioRelease, StudioReleaseDeploymentSchema, StudioReleaseSchema, StudioReleaseVersionSchema, type StudioResumeOutcome, StudioResumeOutcomeSchema, type StudioReviewRequest, StudioReviewRequestSchema, type StudioRun, type StudioRunDetailResponse, StudioRunDetailResponseSchema, StudioRunSchema, type StudioRunStatus, StudioRunStatusSchema, type StudioRunsResponse, StudioRunsResponseSchema, type StudioScore, StudioScoreResponseSchema, StudioScoreSchema, type StudioSession, type StudioSessionDetailResponse, StudioSessionDetailResponseSchema, StudioSessionSchema, type StudioSessionsResponse, StudioSessionsResponseSchema, type StudioTimeRange, type StudioTimeRangeContext, StudioTimeRangeContextSchema, StudioTimeRangeQuerySchema, type StudioTimeRangeResolution, StudioTimeRangeSchema, type StudioTool, StudioToolSchema, type StudioUpdateOperation, StudioUpdateOperationSchema, type StudioUpdateSettings, StudioUpdateSettingsSchema, type StudioUpdateStatus, StudioUpdateStatusSchema, type StudioWorkflow, type StudioWorkflowCall, type StudioWorkflowHealth, StudioWorkflowHealthSchema, type StudioWorkflowInternalEdge, StudioWorkflowInternalEdgeSchema, type StudioWorkflowNode, StudioWorkflowNodeSchema, StudioWorkflowSchema, type StudioWorkflowTransition, StudioWorkflowTransitionSchema, type StudioWorkflowsResponse, StudioWorkflowsResponseSchema, TELEMETRY_EVENT_TYPES, type TelemetryEventBatch, type TelemetryEventBatchResponse, TelemetryEventBatchResponseSchema, TelemetryEventBatchSchema, TelemetryEventSchema, TelemetryEventTypeSchema, type TelemetryPricingHint, TelemetryPricingHintSchema, type TelemetryPricingLineItem, TelemetryPricingLineItemSchema, type TelemetryPricingSource, TelemetryPricingSourceSchema, type TelemetryPricingUnit, TelemetryPricingUnitSchema, type TelemetryPricingUsageType, TelemetryPricingUsageTypeSchema, TelemetryServiceSchema, type TelemetryUnitPrice, TelemetryUnitPriceSchema, type TelemetryUsageItem, TelemetryUsageItemSchema, ToolDiscoverySchema, ToolObservationSchema, ToolOutcomeSchema, type UserFeedbackRequest, UserFeedbackRequestSchema, type WorkflowTool, WorkflowToolSchema, WorkflowTopologyCallSchema, WorkflowTopologyEdgeSchema, WorkflowTopologyNodeSchema, WorkflowTopologyTransitionSchema, isPrivateDiagnosticField, newerStudioVersion, projectWorkflowCalls, redactDiagnosticContent, redactDiagnosticText, resolveStudioInterruptStatus, resolveStudioTimeRange, studioUpdateRunning, summarizeDiagnostic, summarizeUserFeedback };
+export { ClearScoreResponseSchema, ClearUserFeedbackRequestSchema, DIAGNOSTIC_LIMITS, type DiagnosticContent, DiagnosticContentSchema, DiagnosticCorrelationSchema, type DiagnosticManifest, DiagnosticManifestSchema, type DiagnosticNote, DiagnosticNoteSchema, DiagnosticPartSchema, type DiagnosticResponse, DiagnosticResponseSchema, EMPTY_TABLE_FILTERS, EVALUATION_TABLE_FILTER_FIELDS, type EnsureWorkflowTopologyRequest, EnsureWorkflowTopologyRequestSchema, type EnsureWorkflowTopologyResponse, EnsureWorkflowTopologyResponseSchema, FEEDBACK_FILTERS, FeedbackReasonSchema, type FeedbackSummary, FeedbackSummarySchema, type KortyxTelemetryEvent, type KortyxTelemetryEventType, type KortyxTelemetryService, type KortyxWorkflowTopologyEdge, type KortyxWorkflowTopologyNode, type KortyxWorkflowTopologyTransition, LEGACY_TABLE_FILTERS, PROMPT_TABLE_FILTER_FIELDS, PromptAssetSchema, PromptAssignmentSchema, type PromptBundle, PromptBundleSchema, type PromptCategory, PromptCategorySchema, type PromptDetail, PromptDetailSchema, type PromptEvidence, PromptEvidenceSchema, type PromptGroup, PromptGroupSchema, type PromptLibrary, PromptLibrarySchema, type PromptMutation, PromptMutationSchema, PromptPolicySchema, type PromptSelection, PromptSelectionSchema, PromptStoredVersionSchema, type PromptTransferRequest, PromptTransferRequestSchema, PromptUsageSchema, ReviewVerdictSchema, STUDIO_API_PROTOCOL_VERSION, STUDIO_TABLE_FIELDS, STUDIO_TIME_RANGES, type StudioCatalogsResponse, StudioCatalogsResponseSchema, type StudioChange, type StudioChangeResource, StudioChangeResourceSchema, StudioChangeSchema, type StudioContextResponse, StudioContextResponseSchema, type StudioCostSummary, StudioCostSummarySchema, type StudioDetailEvent, StudioDetailEventSchema, type StudioInterrupt, type StudioInterruptDetailResponse, StudioInterruptDetailResponseSchema, type StudioInterruptInteractionMode, StudioInterruptInteractionModeSchema, type StudioInterruptOption, StudioInterruptOptionSchema, StudioInterruptSchema, type StudioInterruptStatus, StudioInterruptStatusSchema, type StudioInterruptType, StudioInterruptTypeSchema, StudioInterruptValueSchema, type StudioInterruptsResponse, StudioInterruptsResponseSchema, type StudioMetric, StudioMetricSchema, type StudioPricingSource, StudioPricingSourceSchema, type StudioPricingStatus, StudioPricingStatusSchema, type StudioRelease, StudioReleaseDeploymentSchema, StudioReleaseSchema, StudioReleaseVersionSchema, type StudioResumeOutcome, StudioResumeOutcomeSchema, type StudioReviewRequest, StudioReviewRequestSchema, type StudioRun, type StudioRunDetailResponse, StudioRunDetailResponseSchema, StudioRunSchema, type StudioRunStatus, StudioRunStatusSchema, type StudioRunsResponse, StudioRunsResponseSchema, type StudioScore, StudioScoreResponseSchema, StudioScoreSchema, type StudioSession, type StudioSessionDetailResponse, StudioSessionDetailResponseSchema, StudioSessionSchema, type StudioSessionsResponse, StudioSessionsResponseSchema, type StudioTableResource, type StudioTimeRange, type StudioTimeRangeContext, StudioTimeRangeContextSchema, StudioTimeRangeQuerySchema, type StudioTimeRangeResolution, StudioTimeRangeSchema, type StudioTool, StudioToolSchema, type StudioUpdateOperation, StudioUpdateOperationSchema, type StudioUpdateSettings, StudioUpdateSettingsSchema, type StudioUpdateStatus, StudioUpdateStatusSchema, type StudioWorkflow, type StudioWorkflowCall, type StudioWorkflowHealth, StudioWorkflowHealthSchema, type StudioWorkflowInternalEdge, StudioWorkflowInternalEdgeSchema, type StudioWorkflowNode, StudioWorkflowNodeSchema, StudioWorkflowSchema, type StudioWorkflowTransition, StudioWorkflowTransitionSchema, type StudioWorkflowsResponse, StudioWorkflowsResponseSchema, TELEMETRY_EVENT_TYPES, type TableFilterDefinition, type TableFilterKind, type TableFilterRule, TableFilterRuleSchema, type TableFilterValue, type TableFilters, TableFiltersSchema, type TelemetryEventBatch, type TelemetryEventBatchResponse, TelemetryEventBatchResponseSchema, TelemetryEventBatchSchema, TelemetryEventSchema, TelemetryEventTypeSchema, type TelemetryPricingHint, TelemetryPricingHintSchema, type TelemetryPricingLineItem, TelemetryPricingLineItemSchema, type TelemetryPricingSource, TelemetryPricingSourceSchema, type TelemetryPricingUnit, TelemetryPricingUnitSchema, type TelemetryPricingUsageType, TelemetryPricingUsageTypeSchema, TelemetryServiceSchema, type TelemetryUnitPrice, TelemetryUnitPriceSchema, type TelemetryUsageItem, TelemetryUsageItemSchema, ToolDiscoverySchema, ToolObservationSchema, ToolOutcomeSchema, type UserFeedbackRequest, UserFeedbackRequestSchema, type WorkflowTool, WorkflowToolSchema, WorkflowTopologyCallSchema, WorkflowTopologyEdgeSchema, WorkflowTopologyNodeSchema, WorkflowTopologyTransitionSchema, captureDiagnosticContent, filterOperators, isPrivateDiagnosticField, matchesTableFilters, matchesTableRule, newerStudioVersion, projectWorkflowCalls, readStudioTableFilters, redactDiagnosticContent, redactDiagnosticText, resolveStudioInterruptStatus, resolveStudioTimeRange, studioUpdateRunning, summarizeDiagnostic, summarizeUserFeedback, tablePassRate, tableQueueMs, validateTableFilters };