@kortyx/agent 0.18.0 → 0.19.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [0.19.0](https://github.com/kortyx-io/kortyx/compare/agent-v0.18.0...agent-v0.19.0) (2026-09-11)
+
+
+### Features
+
+* complete client responses while workflows continue in background ([#165](https://github.com/kortyx-io/kortyx/issues/165)) ([a8a08cd](https://github.com/kortyx-io/kortyx/commit/a8a08cd1e9533e4b44efa4af54a2d2cec54431ae))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @kortyx/runtime bumped to 0.15.0
+  * devDependencies
+    * @kortyx/hooks bumped to 0.22.0
+
 ## [0.18.0](https://github.com/kortyx-io/kortyx/compare/agent-v0.17.0...agent-v0.18.0) (2026-09-10)
 
 

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 import { WorkflowDefinition, ExecutionLimits, TokenUsage, ExecutionLimitReached, ExecutionBudget, GraphState } from '@kortyx/core';
 import { GetProviderFn } from '@kortyx/providers';
-import { PendingRequestRecord, CheckpointSummary, CheckpointId, SessionCheckpointRecord, RollbackSessionCheckpointResult, ForkSessionCheckpointResult, WorkflowRegistry, FrameworkAdapter, ExecutionRuntimeConfig } from '@kortyx/runtime';
+import { PendingRequestRecord, PendingRequestStore, CheckpointSummary, CheckpointId, SessionCheckpointRecord, RollbackSessionCheckpointResult, ForkSessionCheckpointResult, WorkflowRegistry, FrameworkAdapter, ExecutionRuntimeConfig } from '@kortyx/runtime';
 import { StreamChunk } from '@kortyx/stream';
 import { z } from 'zod';
+import * as _kortyx_hooks from '@kortyx/hooks';
 import { KortyxTelemetryConfig, EnsureWorkflowTopologyRequest } from '@kortyx/hooks';
 import { C as ChatMessage } from './browser-wjeg_MwV.js';
 export { S as StreamChatFromRouteArgs, s as streamChatFromRoute } from './browser-wjeg_MwV.js';
@@ -87,6 +88,42 @@ declare class ExecutionRequestError extends Error {
     constructor(code: string, message: string);
 }
 
+declare const scopeSchema: z.ZodObject<{
+    sessionId: z.ZodOptional<z.ZodString>;
+    runId: z.ZodOptional<z.ZodString>;
+    context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
+}, z.core.$strict>;
+type InterruptScope = z.input<typeof scopeSchema>;
+type ListInterruptsOptions = InterruptScope & {
+    status?: "pending";
+    afterResponseCompleted?: boolean;
+};
+type PendingInterrupt = {
+    id: string;
+    status: "pending";
+    runId: string;
+    sessionId: string;
+    workflow: string;
+    node: string;
+    createdAt: string;
+    expiresAt: string;
+    afterResponseCompleted: boolean;
+    input: Omit<PendingRequestRecord["schema"], "meta"> & {
+        options: Array<{
+            id: string;
+            label: string;
+            description?: string;
+        }>;
+    };
+};
+type ResumableInterrupt = PendingInterrupt & {
+    resume: ResumeHandle;
+};
+declare function createInterruptDiscovery(store: PendingRequestStore): {
+    listInterrupts(options: ListInterruptsOptions): Promise<PendingInterrupt[]>;
+    getInterrupt(id: string, scope: InterruptScope): Promise<ResumableInterrupt | null>;
+};
+
 /** Produces the topology-only, deterministic Contract A snapshot. */
 declare const projectWorkflowTopology: (args: {
     workflow: WorkflowDefinition;
@@ -96,6 +133,8 @@ declare const projectWorkflowTopology: (args: {
 }) => EnsureWorkflowTopologyRequest;
 
 interface AgentProcessOptions {
+    executionSignal?: AbortSignal | undefined;
+    onExecution?: ((completion: Promise<void>) => void) | undefined;
     limits?: ExecutionLimits | undefined;
     abortSignal?: AbortSignal | undefined;
     sessionId?: string | undefined;
@@ -117,7 +156,7 @@ interface CreateAgentArgs {
     frameworkAdapter?: FrameworkAdapter;
     telemetry?: ExecutionRuntimeConfig["telemetry"];
 }
-interface Agent {
+interface Agent extends ReturnType<typeof createInterruptDiscovery> {
     execute<W extends ExecutableWorkflow>(args: ExecuteOptions<W>): Promise<ExecutionResult<z.output<W["outputSchema"]>>>;
     execute(args: {
         limits?: ExecutionLimits;
@@ -171,10 +210,12 @@ declare function parseChatRequestBody(value: unknown): ChatRequestBody;
 declare function parseCheckpointRequestBody(value: unknown): CheckpointRequestBody;
 declare function handleChatRequestBody(args: {
     abortSignal?: AbortSignal | undefined;
+    onExecution?: ((completion: Promise<void>) => void) | undefined;
     agent: Agent;
     body: ChatRequestBody;
 }): Promise<Response>;
 declare function createChatRouteHandler(args: {
+    onExecution?: ((completion: Promise<void>) => void) | undefined;
     agent: Agent;
     errorStatus?: number | undefined;
 }): (request: Request) => Promise<Response>;
@@ -193,6 +234,7 @@ interface CompiledGraphLike {
     execution?: {
         abortSignal?: AbortSignal | undefined;
         budget?: ExecutionBudget | undefined;
+        completeResponse?: ((options: _kortyx_hooks.CompleteResponseOptions, state: GraphState) => Promise<void>) | undefined;
     };
     config?: Record<string, unknown>;
     streamEvents: (state: GraphState, options?: {
@@ -211,6 +253,8 @@ type OrchestrationOutcome = {
     error?: unknown;
 };
 interface OrchestrateArgs {
+    executionSignal?: AbortSignal | undefined;
+    onExecution?: ((completion: Promise<void>) => void) | undefined;
     abortSignal?: AbortSignal | undefined;
     emitOutput?: boolean | undefined;
     onOutcome?: ((outcome: OrchestrationOutcome) => void) | undefined;
@@ -227,7 +271,7 @@ interface OrchestrateArgs {
  * Orchestrates runtime execution with mid-stream transitions emitted by
  * runtime events.
  */
-declare function orchestrateGraphStream({ sessionId, runId, graph, state, config: initialConfig, abortSignal: requestSignal, emitOutput, onOutcome, selectWorkflow, knownWorkflowIds, frameworkAdapter, }: OrchestrateArgs): Promise<NodeJS.ReadableStream>;
+declare function orchestrateGraphStream({ sessionId, runId, graph, state, config: initialConfig, abortSignal: requestSignal, executionSignal, onExecution, emitOutput, onOutcome, selectWorkflow, knownWorkflowIds, frameworkAdapter, }: OrchestrateArgs): Promise<NodeJS.ReadableStream>;
 
 interface ResumeMeta {
     token: string;
@@ -243,6 +287,8 @@ declare function parseResumeMeta(msg: ChatMessage | undefined): ResumeMeta | nul
 interface TryResumeArgs {
     limits?: ExecutionLimits | undefined;
     abortSignal?: AbortSignal | undefined;
+    executionSignal?: AbortSignal | undefined;
+    onExecution?: ((completion: Promise<void>) => void) | undefined;
     lastMessage?: ChatMessage | undefined;
     meta?: ResumeMeta | undefined;
     emitOutput?: boolean | undefined;
@@ -256,7 +302,7 @@ interface TryResumeArgs {
     applyResumeSelection?: ApplyResumeSelection;
     frameworkAdapter?: FrameworkAdapter;
 }
-declare function tryPrepareResumeStream({ limits, abortSignal, lastMessage, meta: suppliedMeta, emitOutput, onOutcome, validatePending, sessionId, config, selectWorkflow, knownWorkflowIds, defaultWorkflowId, applyResumeSelection, frameworkAdapter, }: TryResumeArgs): Promise<AsyncIterable<StreamChunk> | null>;
+declare function tryPrepareResumeStream({ limits, abortSignal, executionSignal, onExecution, lastMessage, meta: suppliedMeta, emitOutput, onOutcome, validatePending, sessionId, config, selectWorkflow, knownWorkflowIds, defaultWorkflowId, applyResumeSelection, frameworkAdapter, }: TryResumeArgs): Promise<AsyncIterable<StreamChunk> | null>;
 
 interface RuntimeConfig {
     session?: {
@@ -266,6 +312,8 @@ interface RuntimeConfig {
 }
 interface StreamChatArgs<Options> {
     abortSignal?: AbortSignal | undefined;
+    executionSignal?: AbortSignal | undefined;
+    onExecution?: ((completion: Promise<void>) => void) | undefined;
     messages: ChatMessage[];
     options?: Options | undefined;
     sessionId?: string;
@@ -278,7 +326,7 @@ interface StreamChatArgs<Options> {
     getProvider: GetProviderFn;
     applyResumeSelection?: ApplyResumeSelection;
 }
-declare function streamChat<Options = unknown>({ messages, abortSignal, options, sessionId, defaultWorkflowId, loadRuntimeConfig, selectWorkflow, workflowRegistry, knownWorkflowIds, frameworkAdapter, getProvider, applyResumeSelection, }: StreamChatArgs<Options>): Promise<AsyncIterable<StreamChunk>>;
+declare function streamChat<Options = unknown>({ messages, abortSignal, executionSignal, onExecution, options, sessionId, defaultWorkflowId, loadRuntimeConfig, selectWorkflow, workflowRegistry, knownWorkflowIds, frameworkAdapter, getProvider, applyResumeSelection, }: StreamChatArgs<Options>): Promise<AsyncIterable<StreamChunk>>;
 
 interface TransformOptions {
     debug?: boolean;
@@ -294,4 +342,4 @@ declare function transformGraphStreamForUI(stream: AsyncIterable<StreamEvent>, o
 
 declare function extractLatestUserMessage(messages: ChatMessage[]): string;
 
-export { type Agent, type AgentProcessOptions, type AgentProjectTopologyOptions, type ApplyResumeSelection, ChatMessage, type ChatRequestBody, type CheckpointRequestBody, type CompiledGraphLike, type CreateAgentArgs, type ExecutableWorkflow, type ExecuteOptions, type ExecutionInfo, type ExecutionInterrupt, ExecutionRequestError, type ExecutionResult, type OrchestrateArgs, type ResumeHandle, type ResumeMeta, type ResumeOptions, type ResumeResponse, type SaveMemoryFn, type SelectWorkflowFn, type StreamChatArgs, createAgent, createChatRouteHandler, createCheckpointRouteHandler, extractLatestUserMessage, handleChatRequestBody, handleCheckpointRequestBody, orchestrateGraphStream, parseChatRequestBody, parseCheckpointRequestBody, parseResumeMeta, projectWorkflowTopology, streamChat, transformGraphStreamForUI, tryPrepareResumeStream };
+export { type Agent, type AgentProcessOptions, type AgentProjectTopologyOptions, type ApplyResumeSelection, ChatMessage, type ChatRequestBody, type CheckpointRequestBody, type CompiledGraphLike, type CreateAgentArgs, type ExecutableWorkflow, type ExecuteOptions, type ExecutionInfo, type ExecutionInterrupt, ExecutionRequestError, type ExecutionResult, type InterruptScope, type ListInterruptsOptions, type OrchestrateArgs, type PendingInterrupt, type ResumableInterrupt, type ResumeHandle, type ResumeMeta, type ResumeOptions, type ResumeResponse, type SaveMemoryFn, type SelectWorkflowFn, type StreamChatArgs, createAgent, createChatRouteHandler, createCheckpointRouteHandler, extractLatestUserMessage, handleChatRequestBody, handleCheckpointRequestBody, orchestrateGraphStream, parseChatRequestBody, parseCheckpointRequestBody, parseResumeMeta, projectWorkflowTopology, streamChat, transformGraphStreamForUI, tryPrepareResumeStream };