@agents24/client 0.1.0

package/dist/protocol.d.ts

@@ -0,0 +1,5 @@
+export { Agents24ProtocolError, CONTRACT_HASH, RUNTIME_PROTOCOL_VERSION, THREAD_SUMMARY_PROTOCOL_VERSION, createSseParser, parseProtocolJson, parseRuntimeEvent, parseRuntimeSsePayload, parseSseBytes, parseThreadSummarySsePayload, validateResponseBlock, validateRuntimeEvent, validateThreadSummaryEvent, } from "./generated/protocol.js";
+export type { AbortSignalLike as ProtocolAbortSignalLike, JsonScalar, JsonValue, ProtocolErrorCategory, PublicResponseBlock, RuntimeEvent, SseParser, ThreadSummaryEvent, Utf8Decoder, } from "./generated/protocol.js";
+export { compressionFromContextWindow, createContextWindowTracker, mergeContextWindow, mergeContextWindowUpdate, normalizeContextCompression, normalizeContextWindow, } from "./context-window.js";
+export type { ActiveThreadRun, Attachment, AttachmentUploadResult, RunCancelResult, RunContext, RunResumeResult, ThreadDeleteResult, ThreadDetail, ThreadSummary, ThreadTurn, ThreadsResponse, ToolInputOverrides, Turn, } from "./runtime-types.js";
+export type { ContextCompression, ContextWindow, ContextWindowConfidence, ContextWindowSource, ContextWindowStage, ContextWindowTracker, } from "./context-window.js";

package/dist/protocol.js

@@ -0,0 +1,146 @@
+export { Agents24ProtocolError, CONTRACT_HASH, RUNTIME_PROTOCOL_VERSION, THREAD_SUMMARY_PROTOCOL_VERSION, createSseParser, parseProtocolJson, parseRuntimeEvent, parseRuntimeSsePayload, parseSseBytes, parseThreadSummarySsePayload, validateResponseBlock, validateRuntimeEvent, validateThreadSummaryEvent } from './chunk-VVLMMNXI.js';
+
+// src/context-window.ts
+var SOURCE_PRIORITY = {
+  unknown: 0,
+  heuristic_estimate: 1,
+  tokenizer_estimate: 1,
+  text_estimate: 1,
+  estimated: 1,
+  provider_cached_estimate: 1,
+  multimodal_estimate: 2,
+  hf_tokenizer: 3,
+  runtime_tokenizer: 3,
+  provider_count_api: 4,
+  provider_usage: 5,
+  exact: 5
+};
+var STAGE_PRIORITY = {
+  preflight: 0,
+  sent_prompt: 1,
+  final_usage: 2
+};
+function numberOrNull(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function normalizeSource(value) {
+  const raw = typeof value === "string" ? value.trim() : "";
+  return raw in SOURCE_PRIORITY ? raw : raw ? "estimated" : "unknown";
+}
+function normalizeStage(value) {
+  const raw = typeof value === "string" ? value.trim() : "";
+  return raw === "preflight" || raw === "sent_prompt" || raw === "final_usage" ? raw : "sent_prompt";
+}
+function normalizeConfidence(value) {
+  const raw = typeof value === "string" ? value.trim() : "";
+  return raw === "exact" || raw === "high" || raw === "medium" || raw === "low" || raw === "unknown" ? raw : null;
+}
+function stagePriority(value) {
+  return STAGE_PRIORITY[value?.stage || "sent_prompt"] ?? STAGE_PRIORITY.sent_prompt;
+}
+function hasRenderableWindow(value) {
+  const maxTokens = numberOrNull(value?.max_tokens);
+  return maxTokens !== null && maxTokens > 0;
+}
+function windowWeight(value) {
+  return value ? [stagePriority(value), SOURCE_PRIORITY[value.source] || 0] : [0, 0];
+}
+function normalizeContextCompression(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  const payload = value;
+  return {
+    active: Boolean(payload.active),
+    reason: typeof payload.reason === "string" ? payload.reason : null,
+    input_tokens: numberOrNull(payload.input_tokens),
+    max_tokens: numberOrNull(payload.max_tokens),
+    usage_ratio: numberOrNull(payload.usage_ratio),
+    full_frame_count: numberOrNull(payload.full_frame_count),
+    compact_frame_count: numberOrNull(payload.compact_frame_count),
+    dropped_frame_count: numberOrNull(payload.dropped_frame_count),
+    artifact_ref_count: numberOrNull(payload.artifact_ref_count),
+    compression_trigger_budget: numberOrNull(payload.compression_trigger_budget),
+    compression_target_budget: numberOrNull(payload.compression_target_budget),
+    compression_target_ratio: numberOrNull(payload.compression_target_ratio),
+    threshold_used: numberOrNull(payload.threshold_used)
+  };
+}
+function normalizeContextWindow(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  const payload = value;
+  return {
+    source: normalizeSource(payload.source),
+    run_id: typeof payload.run_id === "string" ? payload.run_id : null,
+    stage: normalizeStage(payload.stage),
+    confidence: normalizeConfidence(payload.confidence),
+    counter: typeof payload.counter === "string" ? payload.counter : null,
+    model_id: typeof payload.model_id === "string" ? payload.model_id : null,
+    max_tokens: numberOrNull(payload.max_tokens),
+    max_tokens_source: typeof payload.max_tokens_source === "string" ? payload.max_tokens_source : null,
+    input_tokens: numberOrNull(payload.input_tokens),
+    remaining_tokens: numberOrNull(payload.remaining_tokens),
+    usage_ratio: numberOrNull(payload.usage_ratio),
+    assembly: payload.assembly && typeof payload.assembly === "object" && !Array.isArray(payload.assembly) ? payload.assembly : null,
+    context_compression: normalizeContextCompression(payload.context_compression)
+  };
+}
+function mergeContextWindow(current, incoming) {
+  const before = current || null;
+  const next = incoming || null;
+  if (!next) return before;
+  if (!before) return next;
+  if (hasRenderableWindow(before) && !hasRenderableWindow(next)) return before;
+  if (before.run_id && next.run_id && before.run_id !== next.run_id) {
+    return stagePriority(next) >= STAGE_PRIORITY.sent_prompt ? next : before;
+  }
+  const beforeWeight = windowWeight(before);
+  const nextWeight = windowWeight(next);
+  return nextWeight[0] > beforeWeight[0] || nextWeight[0] === beforeWeight[0] && nextWeight[1] >= beforeWeight[1] ? next : before;
+}
+function mergeContextWindowUpdate(current, incoming) {
+  return mergeContextWindow(current, normalizeContextWindow(incoming));
+}
+function compressionFromContextWindow(value) {
+  if (!value) return null;
+  if (value.context_compression) return value.context_compression;
+  const assembly = value.assembly;
+  if (!assembly || typeof assembly !== "object" || Array.isArray(assembly)) return null;
+  const artifactRefs = Array.isArray(assembly.artifact_refs) ? assembly.artifact_refs : [];
+  const compactFrameCount = numberOrNull(assembly.compact_frame_count) ?? 0;
+  const droppedFrameCount = numberOrNull(assembly.dropped_frame_count) ?? 0;
+  const reason = typeof assembly.compaction_reason === "string" ? assembly.compaction_reason : "none";
+  return {
+    active: reason !== "none" || compactFrameCount > 0 || droppedFrameCount > 0,
+    reason,
+    input_tokens: value.input_tokens ?? null,
+    max_tokens: value.max_tokens ?? null,
+    usage_ratio: value.usage_ratio ?? null,
+    full_frame_count: numberOrNull(assembly.full_frame_count),
+    compact_frame_count: compactFrameCount,
+    dropped_frame_count: droppedFrameCount,
+    artifact_ref_count: artifactRefs.length,
+    compression_trigger_budget: numberOrNull(assembly.compression_trigger_budget),
+    compression_target_budget: numberOrNull(assembly.compression_target_budget),
+    compression_target_ratio: numberOrNull(assembly.compression_target_ratio),
+    threshold_used: numberOrNull(assembly.threshold_used)
+  };
+}
+function createContextWindowTracker(initial) {
+  let current = normalizeContextWindow(initial);
+  return {
+    get current() {
+      return current;
+    },
+    update(incoming) {
+      current = mergeContextWindowUpdate(current, incoming);
+      return current;
+    },
+    reset(next) {
+      current = normalizeContextWindow(next);
+      return current;
+    }
+  };
+}
+
+export { compressionFromContextWindow, createContextWindowTracker, mergeContextWindow, mergeContextWindowUpdate, normalizeContextCompression, normalizeContextWindow };
+//# sourceMappingURL=protocol.js.map
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/context-window.ts"],"names":[],"mappings":"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","file":"protocol.js","sourcesContent":["export type ContextWindowSource =\n  | \"exact\"\n  | \"estimated\"\n  | \"provider_count_api\"\n  | \"provider_usage\"\n  | \"provider_cached_estimate\"\n  | \"runtime_tokenizer\"\n  | \"hf_tokenizer\"\n  | \"multimodal_estimate\"\n  | \"text_estimate\"\n  | \"tokenizer_estimate\"\n  | \"heuristic_estimate\"\n  | \"unknown\";\n\nexport type ContextWindowStage = \"preflight\" | \"sent_prompt\" | \"final_usage\";\nexport type ContextWindowConfidence = \"exact\" | \"high\" | \"medium\" | \"low\" | \"unknown\";\n\nexport type ContextCompression = {\n  active: boolean;\n  reason?: string | null;\n  input_tokens?: number | null;\n  max_tokens?: number | null;\n  usage_ratio?: number | null;\n  full_frame_count?: number | null;\n  compact_frame_count?: number | null;\n  dropped_frame_count?: number | null;\n  artifact_ref_count?: number | null;\n  compression_trigger_budget?: number | null;\n  compression_target_budget?: number | null;\n  compression_target_ratio?: number | null;\n  threshold_used?: number | null;\n};\n\nexport type ContextWindow = {\n  source: ContextWindowSource;\n  run_id?: string | null;\n  stage?: ContextWindowStage | null;\n  confidence?: ContextWindowConfidence | null;\n  counter?: string | null;\n  model_id?: string | null;\n  max_tokens?: number | null;\n  max_tokens_source?: string | null;\n  input_tokens?: number | null;\n  remaining_tokens?: number | null;\n  usage_ratio?: number | null;\n  assembly?: Record<string, unknown> | null;\n  context_compression?: ContextCompression | null;\n};\n\nconst SOURCE_PRIORITY: Record<ContextWindowSource, number> = {\n  unknown: 0,\n  heuristic_estimate: 1,\n  tokenizer_estimate: 1,\n  text_estimate: 1,\n  estimated: 1,\n  provider_cached_estimate: 1,\n  multimodal_estimate: 2,\n  hf_tokenizer: 3,\n  runtime_tokenizer: 3,\n  provider_count_api: 4,\n  provider_usage: 5,\n  exact: 5,\n};\n\nconst STAGE_PRIORITY: Record<ContextWindowStage, number> = {\n  preflight: 0,\n  sent_prompt: 1,\n  final_usage: 2,\n};\n\nfunction numberOrNull(value: unknown): number | null {\n  return typeof value === \"number\" && Number.isFinite(value) ? value : null;\n}\n\nfunction normalizeSource(value: unknown): ContextWindowSource {\n  const raw = typeof value === \"string\" ? value.trim() : \"\";\n  return raw in SOURCE_PRIORITY ? raw as ContextWindowSource : raw ? \"estimated\" : \"unknown\";\n}\n\nfunction normalizeStage(value: unknown): ContextWindowStage {\n  const raw = typeof value === \"string\" ? value.trim() : \"\";\n  return raw === \"preflight\" || raw === \"sent_prompt\" || raw === \"final_usage\" ? raw : \"sent_prompt\";\n}\n\nfunction normalizeConfidence(value: unknown): ContextWindowConfidence | null {\n  const raw = typeof value === \"string\" ? value.trim() : \"\";\n  return raw === \"exact\" || raw === \"high\" || raw === \"medium\" || raw === \"low\" || raw === \"unknown\" ? raw : null;\n}\n\nfunction stagePriority(value: ContextWindow | null | undefined): number {\n  return STAGE_PRIORITY[value?.stage || \"sent_prompt\"] ?? STAGE_PRIORITY.sent_prompt;\n}\n\nfunction hasRenderableWindow(value: ContextWindow | null | undefined): boolean {\n  const maxTokens = numberOrNull(value?.max_tokens);\n  return maxTokens !== null && maxTokens > 0;\n}\n\nfunction windowWeight(value: ContextWindow | null | undefined): [number, number] {\n  return value ? [stagePriority(value), SOURCE_PRIORITY[value.source] || 0] : [0, 0];\n}\n\nexport function normalizeContextCompression(value: unknown): ContextCompression | null {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) return null;\n  const payload = value as Record<string, unknown>;\n  return {\n    active: Boolean(payload.active),\n    reason: typeof payload.reason === \"string\" ? payload.reason : null,\n    input_tokens: numberOrNull(payload.input_tokens),\n    max_tokens: numberOrNull(payload.max_tokens),\n    usage_ratio: numberOrNull(payload.usage_ratio),\n    full_frame_count: numberOrNull(payload.full_frame_count),\n    compact_frame_count: numberOrNull(payload.compact_frame_count),\n    dropped_frame_count: numberOrNull(payload.dropped_frame_count),\n    artifact_ref_count: numberOrNull(payload.artifact_ref_count),\n    compression_trigger_budget: numberOrNull(payload.compression_trigger_budget),\n    compression_target_budget: numberOrNull(payload.compression_target_budget),\n    compression_target_ratio: numberOrNull(payload.compression_target_ratio),\n    threshold_used: numberOrNull(payload.threshold_used),\n  };\n}\n\nexport function normalizeContextWindow(value: unknown): ContextWindow | null {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) return null;\n  const payload = value as Record<string, unknown>;\n  return {\n    source: normalizeSource(payload.source),\n    run_id: typeof payload.run_id === \"string\" ? payload.run_id : null,\n    stage: normalizeStage(payload.stage),\n    confidence: normalizeConfidence(payload.confidence),\n    counter: typeof payload.counter === \"string\" ? payload.counter : null,\n    model_id: typeof payload.model_id === \"string\" ? payload.model_id : null,\n    max_tokens: numberOrNull(payload.max_tokens),\n    max_tokens_source: typeof payload.max_tokens_source === \"string\" ? payload.max_tokens_source : null,\n    input_tokens: numberOrNull(payload.input_tokens),\n    remaining_tokens: numberOrNull(payload.remaining_tokens),\n    usage_ratio: numberOrNull(payload.usage_ratio),\n    assembly: payload.assembly && typeof payload.assembly === \"object\" && !Array.isArray(payload.assembly)\n      ? payload.assembly as Record<string, unknown>\n      : null,\n    context_compression: normalizeContextCompression(payload.context_compression),\n  };\n}\n\nexport function mergeContextWindow(\n  current: ContextWindow | null | undefined,\n  incoming: ContextWindow | null | undefined,\n): ContextWindow | null {\n  const before = current || null;\n  const next = incoming || null;\n  if (!next) return before;\n  if (!before) return next;\n  if (hasRenderableWindow(before) && !hasRenderableWindow(next)) return before;\n  if (before.run_id && next.run_id && before.run_id !== next.run_id) {\n    return stagePriority(next) >= STAGE_PRIORITY.sent_prompt ? next : before;\n  }\n  const beforeWeight = windowWeight(before);\n  const nextWeight = windowWeight(next);\n  return nextWeight[0] > beforeWeight[0] || (nextWeight[0] === beforeWeight[0] && nextWeight[1] >= beforeWeight[1])\n    ? next\n    : before;\n}\n\nexport function mergeContextWindowUpdate(\n  current: ContextWindow | null | undefined,\n  incoming: unknown,\n): ContextWindow | null {\n  return mergeContextWindow(current, normalizeContextWindow(incoming));\n}\n\nexport function compressionFromContextWindow(value: ContextWindow | null | undefined): ContextCompression | null {\n  if (!value) return null;\n  if (value.context_compression) return value.context_compression;\n  const assembly = value.assembly;\n  if (!assembly || typeof assembly !== \"object\" || Array.isArray(assembly)) return null;\n  const artifactRefs = Array.isArray(assembly.artifact_refs) ? assembly.artifact_refs : [];\n  const compactFrameCount = numberOrNull(assembly.compact_frame_count) ?? 0;\n  const droppedFrameCount = numberOrNull(assembly.dropped_frame_count) ?? 0;\n  const reason = typeof assembly.compaction_reason === \"string\" ? assembly.compaction_reason : \"none\";\n  return {\n    active: reason !== \"none\" || compactFrameCount > 0 || droppedFrameCount > 0,\n    reason,\n    input_tokens: value.input_tokens ?? null,\n    max_tokens: value.max_tokens ?? null,\n    usage_ratio: value.usage_ratio ?? null,\n    full_frame_count: numberOrNull(assembly.full_frame_count),\n    compact_frame_count: compactFrameCount,\n    dropped_frame_count: droppedFrameCount,\n    artifact_ref_count: artifactRefs.length,\n    compression_trigger_budget: numberOrNull(assembly.compression_trigger_budget),\n    compression_target_budget: numberOrNull(assembly.compression_target_budget),\n    compression_target_ratio: numberOrNull(assembly.compression_target_ratio),\n    threshold_used: numberOrNull(assembly.threshold_used),\n  };\n}\n\nexport type ContextWindowTracker = {\n  readonly current: ContextWindow | null;\n  update(incoming: unknown): ContextWindow | null;\n  reset(next?: unknown): ContextWindow | null;\n};\n\nexport function createContextWindowTracker(initial?: unknown): ContextWindowTracker {\n  let current = normalizeContextWindow(initial);\n  return {\n    get current() { return current; },\n    update(incoming) {\n      current = mergeContextWindowUpdate(current, incoming);\n      return current;\n    },\n    reset(next) {\n      current = normalizeContextWindow(next);\n      return current;\n    },\n  };\n}\n"]}

package/dist/runtime-types.d.ts

@@ -0,0 +1,93 @@
+import type { PublicResponseBlock, RuntimeEvent } from "./generated/protocol.js";
+import type { ContextCompression, ContextWindow } from "./context-window.js";
+export type ToolInputOverrides = Record<string, {
+    defaults?: Record<string, unknown>;
+    force?: Record<string, unknown>;
+}>;
+export type Attachment = {
+    id: string;
+    thread_id: string | null;
+    kind: string;
+    filename: string;
+    mime_type: string;
+    byte_size: number;
+    status: string;
+    processing_error: string | null;
+    metadata: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+};
+export type AttachmentUploadResult = {
+    items: Attachment[];
+};
+export type ActiveThreadRun = {
+    run_id: string;
+    status: string;
+    started_at: string | null;
+    created_at: string;
+};
+export type ThreadSummary = {
+    id: string;
+    agent_id: string | null;
+    external_user_id?: string | null;
+    external_session_id?: string | null;
+    title: string | null;
+    status: string;
+    surface: string;
+    last_run_id: string | null;
+    last_run_status: string | null;
+    active_run: ActiveThreadRun | null;
+    last_activity_at: string | null;
+    created_at: string;
+    updated_at: string;
+};
+export type ThreadTurn = {
+    id: string;
+    run_id: string;
+    turn_index: number;
+    user_input_text: string | null;
+    assistant_output_text: string | null;
+    status: string;
+    usage_tokens: number;
+    metadata: Record<string, unknown>;
+    response_blocks: PublicResponseBlock[];
+    attachments: Attachment[];
+    created_at: string;
+    completed_at: string | null;
+    run_events?: RuntimeEvent[];
+};
+export type Turn = ThreadTurn;
+export type ThreadDetail = ThreadSummary & {
+    turns: ThreadTurn[];
+    paging: {
+        has_more: boolean;
+        next_before_turn_index: number | null;
+    };
+};
+export type ThreadsResponse = {
+    items: ThreadSummary[];
+    total: number;
+};
+export type RunContext = {
+    run_id: string;
+    thread_id: string | null;
+    context_window: ContextWindow | null;
+    context_compression: ContextCompression | null;
+    run_usage: Record<string, unknown>;
+};
+export type RunCancelResult = {
+    run_id: string;
+    status: string;
+    thread_id?: string | null;
+};
+export type RunResumeResult = {
+    run_id: string;
+    interrupt_id: string;
+    run_status: string;
+    resolution_status: string;
+    idempotent: boolean;
+    thread_id?: string | null;
+};
+export type ThreadDeleteResult = {
+    deleted: boolean;
+};

package/dist/sessions.d.ts

@@ -0,0 +1,63 @@
+import type { AbortSignalLike, ClientSessionAccess, ClientSessionProvider, ClientSessionStorage, Clock, DpopKeyProvider, FetchLike, IdProvider, SessionRefreshCoordinator, SessionRefreshFenceStorage, TelemetrySink, WaitCapability } from "./types.js";
+export interface FencedRefreshCoordinatorOptions {
+    storage: SessionRefreshFenceStorage;
+    clock?: Clock;
+    ids?: IdProvider;
+    ownerId?: string;
+    leaseDurationMs?: number;
+    pollIntervalMs?: number;
+    wait?: WaitCapability;
+}
+/**
+ * Coordinates refresh-grant rotation across tabs/processes through an injected
+ * atomic compare-and-swap store. Takeovers retain the same operation ID so a
+ * timed-out owner and its successor address one server idempotency record.
+ */
+export declare function createFencedRefreshCoordinator(options: FencedRefreshCoordinatorOptions): SessionRefreshCoordinator;
+export declare function createInMemoryRefreshCoordinator(): SessionRefreshCoordinator;
+export declare function createStaticSessionProvider(access: ClientSessionAccess): ClientSessionProvider;
+export interface ManagedSessionProviderOptions {
+    baseUrl: string;
+    deploymentId: string;
+    fetch?: FetchLike;
+    dpopKeyProvider?: DpopKeyProvider | undefined;
+    storage?: ClientSessionStorage;
+    coordinator?: SessionRefreshCoordinator;
+    clock?: Clock;
+    ids?: IdProvider;
+    telemetry?: TelemetrySink;
+    mint(input: {
+        fetch: FetchLike;
+        url: string;
+        dpopKeyProvider?: DpopKeyProvider | undefined;
+        signal?: AbortSignalLike | undefined;
+    }): Promise<unknown>;
+}
+export declare function createManagedSessionProvider(options: ManagedSessionProviderOptions): ClientSessionProvider;
+export interface AnonymousSessionProviderOptions extends Omit<ManagedSessionProviderOptions, "mint"> {
+    persistent?: boolean;
+    nativeProfileId?: string;
+    requestedCapabilities?: readonly string[];
+    attestation?: string;
+}
+export declare function createAnonymousSessionProvider(options: AnonymousSessionProviderOptions): ClientSessionProvider;
+export interface HostedOidcSessionProvider extends ClientSessionProvider {
+    beginAuthorization(input: {
+        redirectUri: string;
+        codeChallenge: string;
+        nativeProfileId?: string;
+        signal?: AbortSignalLike;
+    }): Promise<{
+        authorizationUrl: string;
+    }>;
+    exchange(input: {
+        code: string;
+        codeVerifier: string;
+        signal?: AbortSignalLike;
+    }): Promise<ClientSessionAccess>;
+}
+export interface HostedOidcSessionProviderOptions extends Omit<ManagedSessionProviderOptions, "mint"> {
+    dpopKeyProvider: DpopKeyProvider;
+    redirectUri?: string;
+}
+export declare function createHostedOidcSessionProvider(options: HostedOidcSessionProviderOptions): HostedOidcSessionProvider;

package/dist/stream.d.ts

@@ -0,0 +1,20 @@
+import type { AbortSignalLike, FetchResponseLike, RuntimeEventHandler, StreamResult, TextDecoderLike, ThreadSummaryEventHandler } from "./types.js";
+export type RuntimeStreamState = StreamResult & {
+    detachReason?: "token_expired" | "revoked" | "policy_changed" | "server_detach";
+};
+export declare function consumeRuntimeStream(input: {
+    response: FetchResponseLike;
+    signal?: AbortSignalLike;
+    decoder: TextDecoderLike;
+    onEvent: RuntimeEventHandler;
+    afterCursor?: number;
+    onProgress?: (state: RuntimeStreamState) => void;
+}): Promise<RuntimeStreamState>;
+export declare function consumeThreadSummaryStream(input: {
+    response: FetchResponseLike;
+    signal?: AbortSignalLike;
+    decoder: TextDecoderLike;
+    onEvent: ThreadSummaryEventHandler;
+    afterCursor?: number;
+    onCursor?: (cursor: number) => void;
+}): Promise<number | null>;