kortyx 0.28.2 → 0.29.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [0.29.0](https://github.com/kortyx-io/kortyx/compare/kortyx-v0.28.2...kortyx-v0.29.0) (2026-10-08)
+
+
+### Features
+
+* **evals:** compact judge evidence and add suite selection ([#293](https://github.com/kortyx-io/kortyx/issues/293)) ([9754f7c](https://github.com/kortyx-io/kortyx/commit/9754f7cacc61b5945a254ccaa66e17b1b5c8d13f))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @kortyx/agent bumped to 0.32.0
+    * @kortyx/cli bumped to 0.15.1
+
 ## [0.28.2](https://github.com/kortyx-io/kortyx/compare/kortyx-v0.28.1...kortyx-v0.28.2) (2026-10-08)
 
 

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { Agent, AgentProcessOptions, ChatLifecycleErrorEvent, ChatLifecycleHookError, ChatLifecyclePhase, ChatRequestBody, ChatResponseFinalized, ChatResponseStatus, ChatRouteHandlerOptions, CheckpointRequestBody, CheckpointRouteHandlerOptions, CreateAgentArgs, CreateEvalsOptions, EvalCase, EvalCaseResult, EvalCommand, EvalConfigurationError, EvalContext, EvalCriterion, EvalCriterionResult, EvalDefaults, EvalExecution, EvalExpectation, EvalGradeInput, EvalHandlerRef, EvalInterrupt, EvalIssue, EvalJson, EvalJudge, EvalJudgeOptions, EvalJudgeUsage, EvalObservation, EvalOutputExpectation, EvalPhase, EvalProgress, EvalResponder, EvalRunOptions, EvalRunResult, EvalRunner, EvalSetupContext, EvalStatus, EvalStep, EvalStepResult, EvalSuite, EvalSuiteSchema, EvalVerdict, ExecutableWorkflow, ExecuteOptions, ExecutionInfo, ExecutionInterrupt, ExecutionRequestError, ExecutionResult, InterruptScope, ListInterruptsOptions, PendingInterrupt, ResumableInterrupt, ResumeHandle, ResumeOptions, ResumeResponse, StreamChatFromRouteArgs, StudioEvalJudgeOptions, createAgent, createChatRouteHandler, createCheckpointRouteHandler, createEvalJudge, createEvalRouteHandler, createEvals, createFailureResponse, createStudioEvalJudge, defineSuite, getEvalSuiteRevision, handleChatRequestBody, handleCheckpointRequestBody, parseChatRequestBody, parseCheckpointRequestBody, parseEvalSuite, readRequestJson, streamChatFromRoute } from '@kortyx/agent';
+export { Agent, AgentProcessOptions, ChatLifecycleErrorEvent, ChatLifecycleHookError, ChatLifecyclePhase, ChatRequestBody, ChatResponseFinalized, ChatResponseStatus, ChatRouteHandlerOptions, CheckpointRequestBody, CheckpointRouteHandlerOptions, CreateAgentArgs, CreateEvalsOptions, EvalCase, EvalCaseResult, EvalCommand, EvalConfigurationError, EvalContext, EvalCriterion, EvalCriterionResult, EvalDefaults, EvalEvidenceEvent, EvalEvidenceEventType, EvalEvidenceFilters, EvalEvidencePolicy, EvalExecution, EvalExpectation, EvalGradeInput, EvalHandlerRef, EvalInterrupt, EvalIssue, EvalJson, EvalJudge, EvalJudgeEvidence, EvalJudgeOptions, EvalJudgeUsage, EvalObservation, EvalOutputExpectation, EvalOutputSelector, EvalPhase, EvalProgress, EvalResponder, EvalRunOptions, EvalRunResult, EvalRunner, EvalSetupContext, EvalStatus, EvalStep, EvalStepResult, EvalSuite, EvalSuiteSchema, EvalVerdict, ExecutableWorkflow, ExecuteOptions, ExecutionInfo, ExecutionInterrupt, ExecutionRequestError, ExecutionResult, InterruptScope, ListInterruptsOptions, PendingInterrupt, ResumableInterrupt, ResumeHandle, ResumeOptions, ResumeResponse, StreamChatFromRouteArgs, StudioEvalJudgeOptions, createAgent, createChatRouteHandler, createCheckpointRouteHandler, createEvalJudge, createEvalRouteHandler, createEvals, createFailureResponse, createStudioEvalJudge, defineSuite, getEvalSuiteRevision, handleChatRequestBody, handleCheckpointRequestBody, parseChatRequestBody, parseCheckpointRequestBody, parseEvalSuite, readRequestJson, streamChatFromRoute } from '@kortyx/agent';
 export * from '@kortyx/core/errors';
 export { ExecutionLimit, ExecutionLimitReached, ExecutionLimits, GraphState, NodeConfig, NodeContext, NodeFn, NodeHandler, NodeResult, RuntimeEnvelope, WorkflowDefinition, WorkflowId, defineWorkflow, loadWorkflow, validateWorkflow } from '@kortyx/core';
 export { CompleteResponseOptions, EnsureWorkflowTopologyRequest, EnsureWorkflowTopologyResponse, InterruptContract, InterruptContractMap, InterruptHistoryEntry, KortyxErrorDetails, KortyxTelemetryConfig, KortyxTelemetryContentCapture, KortyxTelemetryCorrelation, KortyxTelemetryEvent, KortyxTelemetryEventType, KortyxTelemetryPrompt, KortyxTelemetryReporter, KortyxTelemetryService, KortyxTraceAdapter, KortyxTraceErrorProjection, KortyxTraceMetadata, OutputContract, OutputContractEntry, OutputContractMap, ParallelError, ReportErrorOptions, UseContractInterruptArgs, UseContractStructuredDataArgs, UseInterruptArgs, UseReasonArgs, UseReasonInterruptConfig, UseReasonInterruptsConfig, UseReasonOutputsConfig, UseReasonResult, UseReasonStep, UseReasonToolExecution, UseStructuredDataArgs, UseToolArgs, WorkflowCallError, completeResponse, createWorkflowHooks, defineInterruptContract, defineOutputContract, parallel, reportError, useAbortSignal, useInterrupt, useNodeState, useReason, useRuntimeContext, useStructuredData, useTool, useWorkflow, useWorkflowState } from '@kortyx/hooks';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export type {\n  CreateEvalsOptions,\n  EvalCase,\n  EvalCaseResult,\n  EvalCommand,\n  EvalContext,\n  EvalCriterion,\n  EvalCriterionResult,\n  EvalDefaults,\n  EvalExecution,\n  EvalExpectation,\n  EvalGradeInput,\n  EvalHandlerRef,\n  EvalInterrupt,\n  EvalIssue,\n  EvalJson,\n  EvalJudge,\n  EvalJudgeOptions,\n  EvalJudgeUsage,\n  EvalObservation,\n  EvalOutputExpectation,\n  EvalPhase,\n  EvalProgress,\n  EvalResponder,\n  EvalRunner,\n  EvalRunOptions,\n  EvalRunResult,\n  EvalSetupContext,\n  EvalStatus,\n  EvalStep,\n  EvalStepResult,\n  EvalSuite,\n  EvalVerdict,\n  StudioEvalJudgeOptions,\n} from \"@kortyx/agent\";\nexport {\n  createEvalJudge,\n  createEvalRouteHandler,\n  createEvals,\n  createStudioEvalJudge,\n  defineSuite,\n  EvalConfigurationError,\n  EvalSuiteSchema,\n  getEvalSuiteRevision,\n  parseEvalSuite,\n} from \"@kortyx/agent\";\nexport * from \"@kortyx/core/errors\";\n// release-test: 2026-01-22\n// Public DX surface for the Kortyx framework.\n\nexport type {\n  Agent,\n  AgentProcessOptions,\n  ChatLifecycleErrorEvent,\n  ChatLifecyclePhase,\n  ChatRequestBody,\n  ChatResponseFinalized,\n  ChatResponseStatus,\n  ChatRouteHandlerOptions,\n  CheckpointRequestBody,\n  CheckpointRouteHandlerOptions,\n  CreateAgentArgs,\n  ExecutableWorkflow,\n  ExecuteOptions,\n  ExecutionInfo,\n  ExecutionInterrupt,\n  ExecutionResult,\n  InterruptScope,\n  ListInterruptsOptions,\n  PendingInterrupt,\n  ResumableInterrupt,\n  ResumeHandle,\n  ResumeOptions,\n  ResumeResponse,\n  StreamChatFromRouteArgs,\n} from \"@kortyx/agent\";\nexport {\n  ChatLifecycleHookError,\n  createAgent,\n  createChatRouteHandler,\n  createCheckpointRouteHandler,\n  createFailureResponse,\n  ExecutionRequestError,\n  handleChatRequestBody,\n  handleCheckpointRequestBody,\n  parseChatRequestBody,\n  parseCheckpointRequestBody,\n  readRequestJson,\n  streamChatFromRoute,\n} from \"@kortyx/agent\";\nexport type {\n  ExecutionLimit,\n  ExecutionLimitReached,\n  ExecutionLimits,\n  GraphState,\n  NodeConfig,\n  NodeContext,\n  NodeFn,\n  NodeHandler,\n  NodeResult,\n  RuntimeEnvelope,\n  WorkflowDefinition,\n  WorkflowId,\n} from \"@kortyx/core\";\nexport { defineWorkflow, loadWorkflow, validateWorkflow } from \"@kortyx/core\";\nexport type {\n  EnsureWorkflowTopologyRequest,\n  EnsureWorkflowTopologyResponse,\n  InterruptContract,\n  InterruptContractMap,\n  InterruptHistoryEntry,\n  KortyxErrorDetails,\n  KortyxTelemetryConfig,\n  KortyxTelemetryContentCapture,\n  KortyxTelemetryCorrelation,\n  KortyxTelemetryEvent,\n  KortyxTelemetryEventType,\n  KortyxTelemetryPrompt,\n  KortyxTelemetryReporter,\n  KortyxTelemetryService,\n  KortyxTraceAdapter,\n  KortyxTraceErrorProjection,\n  KortyxTraceMetadata,\n  OutputContract,\n  OutputContractEntry,\n  OutputContractMap,\n  ReportErrorOptions,\n  UseContractInterruptArgs,\n  UseContractStructuredDataArgs,\n  UseInterruptArgs,\n  UseReasonArgs,\n  UseReasonInterruptConfig,\n  UseReasonInterruptsConfig,\n  UseReasonOutputsConfig,\n  UseReasonResult,\n  UseReasonStep,\n  UseReasonToolExecution,\n  UseStructuredDataArgs,\n  UseToolArgs,\n} from \"@kortyx/hooks\";\nexport {\n  type CompleteResponseOptions,\n  completeResponse,\n  createWorkflowHooks,\n  defineInterruptContract,\n  defineOutputContract,\n  ParallelError,\n  parallel,\n  reportError,\n  useAbortSignal,\n  useInterrupt,\n  useNodeState,\n  useReason,\n  useRuntimeContext,\n  useStructuredData,\n  useTool,\n  useWorkflow,\n  useWorkflowState,\n  WorkflowCallError,\n} from \"@kortyx/hooks\";\nexport type {\n  CreateMCPClientArgs,\n  MCPClient,\n  McpToolsArgs,\n  McpTransportConfig,\n} from \"@kortyx/mcp\";\nexport { createMCPClient } from \"@kortyx/mcp\";\nexport * from \"@kortyx/providers\";\nexport type {\n  CreateCachingFrameworkAdapterOptions,\n  CreatePostgresFrameworkAdapterOptions,\n  FrameworkAdapter,\n  ManagedFrameworkAdapter,\n  PostgresFrameworkAdapter,\n  PruneRuntimeOptions,\n  PruneRuntimeResult,\n  RuntimeMaintenance,\n  RuntimeRetentionPolicy,\n  WorkflowRegistry,\n} from \"@kortyx/runtime\";\nexport {\n  clearRegisteredNodes,\n  createCachingFrameworkAdapter,\n  createFileWorkflowRegistry,\n  createFrameworkAdapterFromEnv,\n  createInMemoryFrameworkAdapter,\n  createInMemoryWorkflowRegistry,\n  createPostgresFrameworkAdapter,\n  createRedisFrameworkAdapter,\n  getRegisteredNode,\n  listRegisteredNodes,\n  registerNode,\n} from \"@kortyx/runtime\";\nexport type {\n  BufferedStreamResult,\n  ConsumeStreamHandlers,\n  FinalizedChatContentPiece,\n  FinalizedChatMessage,\n  StreamChunk,\n  StructuredDataChunk,\n  StructuredStreamAccumulator,\n  StructuredStreamState,\n} from \"@kortyx/stream\";\nexport {\n  applyStructuredChunk,\n  collectBufferedStream,\n  collectStream,\n  consumeStream,\n  createFinalizedChatMessageAccumulator,\n  createStreamResponse,\n  createStructuredStreamAccumulator,\n  projectInterruptPiece,\n  readStream,\n  reduceStructuredChunks,\n  summarizeStreamChunks,\n  toSSE,\n} from \"@kortyx/stream\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAmCA,mBAUO;AACP,0BAAc,gCA9Cd;AA4EA,IAAAA,gBAaO;AAeP,kBAA+D;AAoC/D,mBAmBO;AAOP,iBAAgC;AAChC,0BAAc,8BAvKd;AAoLA,qBAYO;AAWP,oBAaO;","names":["import_agent"]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export type {\n  CreateEvalsOptions,\n  EvalCase,\n  EvalCaseResult,\n  EvalCommand,\n  EvalContext,\n  EvalCriterion,\n  EvalCriterionResult,\n  EvalDefaults,\n  EvalEvidenceEvent,\n  EvalEvidenceEventType,\n  EvalEvidenceFilters,\n  EvalEvidencePolicy,\n  EvalExecution,\n  EvalExpectation,\n  EvalGradeInput,\n  EvalHandlerRef,\n  EvalInterrupt,\n  EvalIssue,\n  EvalJson,\n  EvalJudge,\n  EvalJudgeEvidence,\n  EvalJudgeOptions,\n  EvalJudgeUsage,\n  EvalObservation,\n  EvalOutputExpectation,\n  EvalOutputSelector,\n  EvalPhase,\n  EvalProgress,\n  EvalResponder,\n  EvalRunner,\n  EvalRunOptions,\n  EvalRunResult,\n  EvalSetupContext,\n  EvalStatus,\n  EvalStep,\n  EvalStepResult,\n  EvalSuite,\n  EvalVerdict,\n  StudioEvalJudgeOptions,\n} from \"@kortyx/agent\";\nexport {\n  createEvalJudge,\n  createEvalRouteHandler,\n  createEvals,\n  createStudioEvalJudge,\n  defineSuite,\n  EvalConfigurationError,\n  EvalSuiteSchema,\n  getEvalSuiteRevision,\n  parseEvalSuite,\n} from \"@kortyx/agent\";\nexport * from \"@kortyx/core/errors\";\n// release-test: 2026-01-22\n// Public DX surface for the Kortyx framework.\n\nexport type {\n  Agent,\n  AgentProcessOptions,\n  ChatLifecycleErrorEvent,\n  ChatLifecyclePhase,\n  ChatRequestBody,\n  ChatResponseFinalized,\n  ChatResponseStatus,\n  ChatRouteHandlerOptions,\n  CheckpointRequestBody,\n  CheckpointRouteHandlerOptions,\n  CreateAgentArgs,\n  ExecutableWorkflow,\n  ExecuteOptions,\n  ExecutionInfo,\n  ExecutionInterrupt,\n  ExecutionResult,\n  InterruptScope,\n  ListInterruptsOptions,\n  PendingInterrupt,\n  ResumableInterrupt,\n  ResumeHandle,\n  ResumeOptions,\n  ResumeResponse,\n  StreamChatFromRouteArgs,\n} from \"@kortyx/agent\";\nexport {\n  ChatLifecycleHookError,\n  createAgent,\n  createChatRouteHandler,\n  createCheckpointRouteHandler,\n  createFailureResponse,\n  ExecutionRequestError,\n  handleChatRequestBody,\n  handleCheckpointRequestBody,\n  parseChatRequestBody,\n  parseCheckpointRequestBody,\n  readRequestJson,\n  streamChatFromRoute,\n} from \"@kortyx/agent\";\nexport type {\n  ExecutionLimit,\n  ExecutionLimitReached,\n  ExecutionLimits,\n  GraphState,\n  NodeConfig,\n  NodeContext,\n  NodeFn,\n  NodeHandler,\n  NodeResult,\n  RuntimeEnvelope,\n  WorkflowDefinition,\n  WorkflowId,\n} from \"@kortyx/core\";\nexport { defineWorkflow, loadWorkflow, validateWorkflow } from \"@kortyx/core\";\nexport type {\n  EnsureWorkflowTopologyRequest,\n  EnsureWorkflowTopologyResponse,\n  InterruptContract,\n  InterruptContractMap,\n  InterruptHistoryEntry,\n  KortyxErrorDetails,\n  KortyxTelemetryConfig,\n  KortyxTelemetryContentCapture,\n  KortyxTelemetryCorrelation,\n  KortyxTelemetryEvent,\n  KortyxTelemetryEventType,\n  KortyxTelemetryPrompt,\n  KortyxTelemetryReporter,\n  KortyxTelemetryService,\n  KortyxTraceAdapter,\n  KortyxTraceErrorProjection,\n  KortyxTraceMetadata,\n  OutputContract,\n  OutputContractEntry,\n  OutputContractMap,\n  ReportErrorOptions,\n  UseContractInterruptArgs,\n  UseContractStructuredDataArgs,\n  UseInterruptArgs,\n  UseReasonArgs,\n  UseReasonInterruptConfig,\n  UseReasonInterruptsConfig,\n  UseReasonOutputsConfig,\n  UseReasonResult,\n  UseReasonStep,\n  UseReasonToolExecution,\n  UseStructuredDataArgs,\n  UseToolArgs,\n} from \"@kortyx/hooks\";\nexport {\n  type CompleteResponseOptions,\n  completeResponse,\n  createWorkflowHooks,\n  defineInterruptContract,\n  defineOutputContract,\n  ParallelError,\n  parallel,\n  reportError,\n  useAbortSignal,\n  useInterrupt,\n  useNodeState,\n  useReason,\n  useRuntimeContext,\n  useStructuredData,\n  useTool,\n  useWorkflow,\n  useWorkflowState,\n  WorkflowCallError,\n} from \"@kortyx/hooks\";\nexport type {\n  CreateMCPClientArgs,\n  MCPClient,\n  McpToolsArgs,\n  McpTransportConfig,\n} from \"@kortyx/mcp\";\nexport { createMCPClient } from \"@kortyx/mcp\";\nexport * from \"@kortyx/providers\";\nexport type {\n  CreateCachingFrameworkAdapterOptions,\n  CreatePostgresFrameworkAdapterOptions,\n  FrameworkAdapter,\n  ManagedFrameworkAdapter,\n  PostgresFrameworkAdapter,\n  PruneRuntimeOptions,\n  PruneRuntimeResult,\n  RuntimeMaintenance,\n  RuntimeRetentionPolicy,\n  WorkflowRegistry,\n} from \"@kortyx/runtime\";\nexport {\n  clearRegisteredNodes,\n  createCachingFrameworkAdapter,\n  createFileWorkflowRegistry,\n  createFrameworkAdapterFromEnv,\n  createInMemoryFrameworkAdapter,\n  createInMemoryWorkflowRegistry,\n  createPostgresFrameworkAdapter,\n  createRedisFrameworkAdapter,\n  getRegisteredNode,\n  listRegisteredNodes,\n  registerNode,\n} from \"@kortyx/runtime\";\nexport type {\n  BufferedStreamResult,\n  ConsumeStreamHandlers,\n  FinalizedChatContentPiece,\n  FinalizedChatMessage,\n  StreamChunk,\n  StructuredDataChunk,\n  StructuredStreamAccumulator,\n  StructuredStreamState,\n} from \"@kortyx/stream\";\nexport {\n  applyStructuredChunk,\n  collectBufferedStream,\n  collectStream,\n  consumeStream,\n  createFinalizedChatMessageAccumulator,\n  createStreamResponse,\n  createStructuredStreamAccumulator,\n  projectInterruptPiece,\n  readStream,\n  reduceStructuredChunks,\n  summarizeStreamChunks,\n  toSSE,\n} from \"@kortyx/stream\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAyCA,mBAUO;AACP,0BAAc,gCApDd;AAkFA,IAAAA,gBAaO;AAeP,kBAA+D;AAoC/D,mBAmBO;AAOP,iBAAgC;AAChC,0BAAc,8BA7Kd;AA0LA,qBAYO;AAWP,oBAaO;","names":["import_agent"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kortyx",
-  "version": "0.28.2",
+  "version": "0.29.0",
   "private": false,
   "description": "TypeScript framework for production AI agents with explicit workflows, provider-agnostic models, streaming, interrupts, and runtime persistence.",
   "keywords": [
@@ -47,14 +47,14 @@
     "CHANGELOG.md"
   ],
   "dependencies": {
-    "@kortyx/agent": "0.31.1",
-    "@kortyx/cli": "0.15.0",
-    "@kortyx/hooks": "0.31.0",
+    "@kortyx/agent": "0.32.0",
+    "@kortyx/cli": "0.15.1",
     "@kortyx/core": "0.12.0",
+    "@kortyx/hooks": "0.31.0",
     "@kortyx/mcp": "0.2.9",
+    "@kortyx/providers": "0.9.0",
     "@kortyx/runtime": "0.21.7",
     "@kortyx/stream": "0.15.2",
-    "@kortyx/providers": "0.9.0",
     "@kortyx/utils": "0.3.4"
   },
   "devDependencies": {