Documentation / @agentick/core / SessionExecutionHandle

Interface: SessionExecutionHandle

Handle for interacting with a running session execution.

SessionExecutionHandle wraps the kernel's ExecutionHandle with session-specific methods using explicit delegation. This is the return type of session.send() and session.render().

The handle is AsyncIterable (not PromiseLike):

await handle.result → resolves to SendResult
for await (const event of handle) → streams StreamEvent

Example

typescript

// send/render are Procedures — await to get the handle
const handle = await session.send({ messages: [...] });

// Stream events
for await (const event of handle) {
  if (event.type === 'content_delta') {
    process.stdout.write(event.delta);
  }
}

// Or get result directly via ProcedurePromise chaining
const result = await session.send({ messages: [...] }).result;
console.log(result.response);

// Mid-execution interaction
handle.queueMessage({ role: "user", content: [...] });
handle.abort("User cancelled");

Extends

ExecutionHandle<SendResult, StreamEvent>

Properties

[ExecutionHandleBrand]

readonly [ExecutionHandleBrand]: true

Defined in: kernel/src/procedure.ts:260

Brand identifying this as an ExecutionHandle (not a plain AsyncIterable)

Inherited from

ExecutionHandle.[ExecutionHandleBrand]

currentTick

readonly currentTick: number

Defined in: core/src/app/types.ts:1041

Current tick number

events

readonly events: EventBuffer<StreamEvent>

Defined in: kernel/src/procedure.ts:283

Event buffer for streaming execution events. Supports dual consumption - multiple iterators can independently consume all events. Late subscribers receive replayed events from the start.

API is compatible with EventEmitter: on, once, off, emit, addListener, removeListener. Use on('eventType', handler) to subscribe to specific event types. Use on(handler) or on('*', handler) for wildcard subscription.