@dougbots/avenor-core 0.3.7 → 0.4.0

package/dist/index.d.ts

@@ -8,6 +8,22 @@ interface Event {
   runtime_id?: string;
   [key: string]: unknown;
 }
+interface SubscribeOptions {
+  runtime_id?: string;
+  replay?: boolean;
+  limit?: number;
+  after_seq?: number;
+}
+interface HistoryOptions {
+  runtime_id: string;
+  limit?: number;
+  after_seq?: number;
+}
+interface HistoryResult<TEvent = Event> {
+  runtime_id?: string;
+  events: TEvent[];
+  latest_seq?: number;
+}
 interface SpawnParams {
   agent: string;
   prompt_file?: string;
@@ -35,14 +51,16 @@ declare class Client {
   private eventDone;
   private dropped;
   private subscribed;
+  private subscriptionKey;
   constructor(socket: net.Socket, opts?: {
     callTimeoutMs?: number;
   });
   private startReadLoop;
   private pushEvent;
   call(method: string, params?: unknown): Promise<unknown>;
-  private subscribe;
-  events(): AsyncIterable<Event>;
+  subscribe(options?: SubscribeOptions): Promise<void>;
+  events(options?: SubscribeOptions): AsyncIterableIterator<Event>;
+  history(options: HistoryOptions): Promise<HistoryResult>;
   status(runtimeId?: string): Promise<Record<string, unknown>>;
   list(): Promise<Array<Record<string, unknown>>>;
   spawn(params: SpawnParams): Promise<Record<string, unknown>>;
@@ -56,6 +74,156 @@ declare function dial(socketPath: string, opts?: {
   callTimeoutMs?: number;
 }): Promise<Client>;
 //#endregion
+//#region src/run-events.d.ts
+type RunChunkRole = 'assistant' | 'thought' | 'user';
+interface RunPermissionOption {
+  option_id: string;
+  label: string;
+  kind: string;
+}
+interface RunPermissionSummary {
+  request_id?: string;
+  description?: string;
+  question?: string;
+  tool?: string;
+  options: RunPermissionOption[];
+  kind?: string;
+}
+interface RunToolSummary {
+  key: string;
+  id?: string;
+  title?: string;
+  kind?: string;
+  status?: string;
+  preview?: string;
+}
+interface NormalizedRunEvent {
+  event: string;
+  source_event: string;
+  raw: Record<string, unknown>;
+  runtime_id?: string;
+  session_id?: string;
+  run_id?: string;
+  run_label?: string;
+  seq?: number;
+  ts?: number;
+  phase?: string;
+  phase_label?: string;
+  stop_reason?: string;
+  final_output?: string;
+  usage?: Record<string, unknown>;
+  backend?: string;
+  agent?: string;
+  model?: string;
+  dir?: string;
+  parent_id?: string;
+  children?: string[];
+  event_path?: string;
+  delta?: string;
+  chunk_role?: RunChunkRole;
+  tool?: RunToolSummary;
+  permission?: RunPermissionSummary;
+  alias?: boolean;
+  semantic_fingerprint?: string;
+}
+declare function extractEventText(value: unknown, depth?: number): string | undefined;
+declare function normalizeRunEvent(input: unknown): NormalizedRunEvent | null;
+//#endregion
+//#region src/run-reducer.d.ts
+interface RunReducerLimits {
+  transcript_entries: number;
+  text_chars: number;
+  tool_preview_chars: number;
+  tools: number;
+  permissions: number;
+  legacy_keys: number;
+}
+declare const DEFAULT_RUN_REDUCER_LIMITS: RunReducerLimits;
+interface RunTranscriptEntry {
+  kind: 'assistant' | 'thought' | 'user' | 'tool' | 'permission' | 'session' | 'status';
+  event: string;
+  source_event: string;
+  text?: string;
+  title?: string;
+  status?: string;
+  request_id?: string;
+  seq?: number;
+  ts?: number;
+}
+interface RunToolState extends RunToolSummary {
+  started_at?: number;
+  updated_at?: number;
+  ended_at?: number;
+  live: boolean;
+}
+interface RunIdentity {
+  runtime_id?: string;
+  session_id?: string;
+  run_id?: string;
+  run_label?: string;
+  backend?: string;
+  agent?: string;
+  model?: string;
+  dir?: string;
+  parent_id?: string;
+  children?: string[];
+  event_path?: string;
+}
+interface RunSnapshot {
+  identity: RunIdentity;
+  limits: RunReducerLimits;
+  latest_seq?: number;
+  last_event?: string;
+  last_ts?: number;
+  phase?: string;
+  phase_label?: string;
+  ended: boolean;
+  stop_reason?: string;
+  usage?: Record<string, unknown>;
+  final_output?: string;
+  assistant_text: string;
+  thought_text: string;
+  user_text: string;
+  transcript: RunTranscriptEntry[];
+  tools: RunToolState[];
+  live_tools: RunToolState[];
+  pending_permission?: RunPermissionSummary;
+  permissions: RunPermissionSummary[];
+  _seen_seq_by_scope: Record<string, number>;
+  _recent_legacy_keys: string[];
+  _last_semantic_fingerprint?: string;
+  _last_source_event?: string;
+}
+declare function createRunSnapshot(limits?: Partial<RunReducerLimits>): RunSnapshot;
+declare function reduceRunSnapshot(current: RunSnapshot, input: unknown, limits?: Partial<RunReducerLimits>): RunSnapshot;
+type RunSnapshotSeed = Partial<Omit<RunSnapshot, '_seen_seq_by_scope' | '_recent_legacy_keys' | '_last_semantic_fingerprint' | '_last_source_event'>>;
+declare class RunReducer {
+  private state;
+  constructor(limits?: Partial<RunReducerLimits>, initial?: RunSnapshotSeed);
+  apply(input: unknown): RunSnapshot;
+  snapshot(): RunSnapshot;
+}
+//#endregion
+//#region src/run-observer.d.ts
+interface RunObserverClient {
+  events(options?: SubscribeOptions): AsyncIterable<Event>;
+  close?(): void;
+}
+interface ObserveRunOptions extends SubscribeOptions {
+  reducer_limits?: Partial<RunReducerLimits>;
+  initial_snapshot?: RunSnapshotSeed;
+  close_client?: boolean;
+}
+type SnapshotListener = (snapshot: RunSnapshot, event: Event) => void;
+interface RunObserver {
+  snapshot(): RunSnapshot;
+  subscribe(listener: SnapshotListener): () => void;
+  next(predicate?: (snapshot: RunSnapshot) => boolean): Promise<RunSnapshot | null>;
+  close(): Promise<void>;
+  readonly closed: boolean;
+}
+declare function observeRun(client: RunObserverClient, options?: ObserveRunOptions): RunObserver;
+//#endregion
 //#region src/supervisor.d.ts
 interface RunInfo {
   runId: string;
@@ -139,6 +307,16 @@ interface StatusResult {
   };
   session_id?: string;
   stop_reason?: string;
+  backend?: string;
+  agent?: string;
+  model?: string;
+  dir?: string;
+  parent_id?: string;
+  children?: string[];
+  event_path?: string;
+  usage?: Record<string, unknown>;
+  latest_seq?: number;
+  final_output?: string;
 }
 declare function statusTool(args: {
   runId?: string;
@@ -172,14 +350,36 @@ declare function eventsTool(args: {
   types?: string[];
   limit?: number;
   supervisorId?: string;
+  after_seq?: number;
 }): Promise<{
   events: Array<{
-    type: string;
-    ts: number;
+    event?: string;
+    type?: string;
+    ts?: number;
     [key: string]: unknown;
   }>;
 }>;
 //#endregion
+//#region src/tools/inspect.d.ts
+interface InspectResult {
+  run_id: string;
+  label: string;
+  status: StatusResult;
+  snapshot: Omit<RunSnapshot, '_seen_seq_by_scope' | '_recent_legacy_keys' | '_last_semantic_fingerprint' | '_last_source_event'>;
+  transcript: RunSnapshot['transcript'];
+  tools: RunSnapshot['tools'];
+  live_tools: RunSnapshot['live_tools'];
+  permissions: RunSnapshot['permissions'];
+  pending_permission?: RunSnapshot['pending_permission'];
+  final_output?: string;
+}
+declare function inspectTool(args: {
+  runId: string;
+  supervisorId?: string;
+  limit?: number;
+  after_seq?: number;
+}): Promise<InspectResult>;
+//#endregion
 //#region src/tools/shutdown.d.ts
 declare function shutdownTool(args: {
   supervisorId?: string;
@@ -189,4 +389,4 @@ declare function shutdownTool(args: {
   cleaned_up: string[];
 }>;
 //#endregion
-export { type Client, type Event, type RunInfo, type SpawnParams, type StatusResult, Supervisor, type SupervisorOptions, answerPermissionTool, dial, eventsTool, findAvenorBinary, followUpTool, getInstallDir, getVersion, installerBinaryPath, shutdownTool, spawnTool, statusTool };
+export { type Client, DEFAULT_RUN_REDUCER_LIMITS, type Event, type HistoryOptions, type HistoryResult, type InspectResult, type NormalizedRunEvent, type ObserveRunOptions, type RunChunkRole, type RunIdentity, type RunInfo, type RunObserver, type RunObserverClient, type RunPermissionOption, type RunPermissionSummary, RunReducer, type RunReducerLimits, type RunSnapshot, type RunSnapshotSeed, type RunToolState, type RunToolSummary, type RunTranscriptEntry, type SpawnParams, type StatusResult, type SubscribeOptions, Supervisor, type SupervisorOptions, answerPermissionTool, createRunSnapshot, dial, eventsTool, extractEventText, findAvenorBinary, followUpTool, getInstallDir, getVersion, inspectTool, installerBinaryPath, normalizeRunEvent, observeRun, reduceRunSnapshot, shutdownTool, spawnTool, statusTool };