@theokit/sdk 4.53.1 → 4.55.0

package/dist/subscription/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/subscription/define-subscription.ts","../../src/subscription/internal/sse-parser.ts","../../src/subscription/types.ts","../../src/subscription/theokit-subscribe.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @theokit/sdk — `defineSubscription` DSL (G8 public API).\n *\n * Per ADR D426 (AsyncGenerator handler + Zod input/output schemas).\n *\n * @public\n */\n\nimport type { SubscriptionCtx, SubscriptionDescriptor, TrackedEnvelope, ZodLike } from \"./types.js\";\n\n/**\n * Options accepted by {@link defineSubscription}.\n *\n * @public\n */\nexport interface DefineSubscriptionOptions<TInput, TOutput> {\n  /** Optional explicit name. Falls back to filename derivation by the scanner. */\n  name?: string;\n  /** Zod schema validating subscription input. Required (typed RPC contract). */\n  input: ZodLike<TInput>;\n  /** Zod schema describing each output frame. Informational; not enforced per-frame. */\n  output: ZodLike<TOutput>;\n  /**\n   * Handler that produces the subscription stream.\n   *\n   * Receives the validated input + {@link SubscriptionCtx}. Yielding a value\n   * emits a plain output frame. Yielding a `tracked(id, payload)` envelope\n   * additionally advertises a resume token to the client so reconnects can\n   * resume from that point.\n   */\n  handler: (\n    input: TInput,\n    ctx: SubscriptionCtx,\n  ) => AsyncGenerator<TOutput | TrackedEnvelope<TOutput>, void, void>;\n}\n\n/**\n * Define a typed subscription. Pair with `Theokit.subscribe(name, input)`\n * on the client side.\n *\n * Per ADR D426 — handler is `AsyncGenerator<TOutput | TrackedEnvelope<TOutput>>`.\n * The runtime validates input via `opts.input.safeParse` BEFORE invoking the\n * handler; failure throws {@link import('./types.js').SubscriptionInputError}.\n *\n * @example\n * ```ts\n * import { Subscription } from \"@theokit/sdk/subscription\";\n * import { z } from \"zod\";\n *\n * export default Subscription.create({\n *   input: z.object({ topic: z.string() }),\n *   output: z.object({ message: z.string(), ts: z.number() }),\n *   async *handler(input, ctx) {\n *     let cursor = ctx.lastEventId ?? \"0\";\n *     while (!ctx.signal.aborted) {\n *       const msgs = await fetchMessagesSince(input.topic, cursor);\n *       for (const m of msgs) {\n *         cursor = m.id;\n *         yield ctx.tracked(m.id, { message: m.body, ts: m.ts });\n *       }\n *       await sleep(1000);\n *     }\n *   },\n * });\n * ```\n *\n * @public\n */\nexport function defineSubscription<TInput, TOutput>(\n  opts: DefineSubscriptionOptions<TInput, TOutput>,\n): SubscriptionDescriptor<TInput, TOutput> {\n  if (opts === null || typeof opts !== \"object\") {\n    throw new TypeError(\"defineSubscription: options object is required\");\n  }\n  if (opts.input === undefined || typeof opts.input.safeParse !== \"function\") {\n    throw new TypeError(\"defineSubscription: opts.input must be a Zod schema (or ZodLike)\");\n  }\n  if (opts.output === undefined || typeof opts.output.safeParse !== \"function\") {\n    throw new TypeError(\"defineSubscription: opts.output must be a Zod schema (or ZodLike)\");\n  }\n  if (typeof opts.handler !== \"function\") {\n    throw new TypeError(\"defineSubscription: opts.handler must be an async generator function\");\n  }\n  return {\n    ...(opts.name !== undefined ? { name: opts.name } : {}),\n    input: opts.input,\n    output: opts.output,\n    handler: opts.handler,\n  };\n}\n\n/** SE36 — `Subscription.create` replaces `defineSubscription` (ADR 0015). @public */\nexport class Subscription {\n  private constructor() {}\n  static create<TInput, TOutput>(\n    opts: DefineSubscriptionOptions<TInput, TOutput>,\n  ): SubscriptionDescriptor<TInput, TOutput> {\n    return defineSubscription(opts);\n  }\n}\n","/**\n * @theokit/sdk — W3C SSE parser (G8 internal).\n *\n * Per ADR D428. Reads from `ReadableStream<Uint8Array>` or async iterable of\n * UTF-8 chunks; yields parsed {@link SSEvent} objects per W3C SSE spec.\n *\n * Independent of `internal/llm/sse.ts:parseSseStream` (LLM-specific a peer vendor AI\n * Data Stream v1; locked by D38). This parser handles the `id:` field needed\n * for tracked envelopes (G8 resume mechanism), which the LLM parser ignores.\n *\n * Reference: https://html.spec.whatwg.org/multipage/server-sent-events.html\n *\n * @internal\n */\n\nimport type { SSEvent } from \"./sse-encoder.js\";\n\nconst decoder = new TextDecoder(\"utf-8\");\n\n/**\n * Parse an async iterable of UTF-8 byte chunks into a stream of SSE events.\n *\n * Implements the W3C event stream parser:\n * - Lines are split by `\\n`, `\\r\\n`, or `\\r`\n * - Events are dispatched on blank line (no `:` and no field name)\n * - Fields: `event`, `data` (multi-line concat with `\\n`), `id`, `retry`\n * - Lines starting with `:` are comments (ignored, except dispatched as `comment`)\n * - Unknown fields silently ignored per spec\n *\n * Empty events (no fields) are NOT dispatched per spec.\n *\n * @internal\n */\nexport async function* parseSseW3C(\n  source: AsyncIterable<Uint8Array>,\n): AsyncGenerator<SSEvent, void, void> {\n  let buffer = \"\";\n  let eventName: string | undefined;\n  let dataLines: string[] = [];\n  let id: string | undefined;\n  let retry: number | undefined;\n  let commentLines: string[] = [];\n  let hasField = false;\n\n  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: dispatch builds SSEvent from per-field state per W3C spec — refactor candidate\n  const dispatch = (): SSEvent | null => {\n    if (!hasField) {\n      // Blank line with no preceding fields → reset state, no dispatch (per spec § 9.2.6)\n      eventName = undefined;\n      dataLines = [];\n      id = undefined;\n      retry = undefined;\n      commentLines = [];\n      return null;\n    }\n    const chunk: SSEvent = {};\n    if (eventName !== undefined) (chunk as { event?: string }).event = eventName;\n    if (dataLines.length > 0) (chunk as { data?: string }).data = dataLines.join(\"\\n\");\n    if (id !== undefined) (chunk as { id?: string }).id = id;\n    if (retry !== undefined) (chunk as { retry?: number }).retry = retry;\n    if (commentLines.length > 0) (chunk as { comment?: string }).comment = commentLines.join(\"\\n\");\n    eventName = undefined;\n    dataLines = [];\n    id = undefined;\n    retry = undefined;\n    commentLines = [];\n    hasField = false;\n    return chunk;\n  };\n\n  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: handleLine dispatches across all SSE field kinds per W3C spec — refactor candidate\n  const handleLine = (line: string): SSEvent | null => {\n    if (line === \"\") {\n      return dispatch();\n    }\n    if (line.startsWith(\":\")) {\n      // Comment line — per spec ignored, but we surface it for keepalive visibility.\n      commentLines.push(line.slice(1).replace(/^ /, \"\"));\n      hasField = true;\n      return null;\n    }\n    const colonIdx = line.indexOf(\":\");\n    let field: string;\n    let value: string;\n    if (colonIdx === -1) {\n      field = line;\n      value = \"\";\n    } else {\n      field = line.slice(0, colonIdx);\n      value = line.slice(colonIdx + 1);\n      // Strip ONE leading space if present (per spec § 9.2.6)\n      if (value.startsWith(\" \")) value = value.slice(1);\n    }\n    switch (field) {\n      case \"event\":\n        eventName = value;\n        hasField = true;\n        break;\n      case \"data\":\n        dataLines.push(value);\n        hasField = true;\n        break;\n      case \"id\":\n        // Per spec: id with NULL is ignored\n        if (!value.includes(\"\\0\")) {\n          id = value;\n          hasField = true;\n        }\n        break;\n      case \"retry\":\n        if (/^\\d+$/.test(value)) {\n          retry = Number.parseInt(value, 10);\n          hasField = true;\n        }\n        break;\n      default:\n        // Unknown field — ignored per spec\n        break;\n    }\n    return null;\n  };\n\n  for await (const bytes of source) {\n    // Normalize CRLF / CR to LF then split\n    buffer += decoder.decode(bytes, { stream: true }).replace(/\\r\\n|\\r/g, \"\\n\");\n    let idx: number;\n    // biome-ignore lint/suspicious/noAssignInExpressions: idiomatic while-assignment loop for buffered line parsing\n    while ((idx = buffer.indexOf(\"\\n\")) !== -1) {\n      const line = buffer.slice(0, idx);\n      buffer = buffer.slice(idx + 1);\n      const event = handleLine(line);\n      if (event !== null) yield event;\n    }\n  }\n  // Flush remaining buffer as a final line (no trailing newline case)\n  buffer += decoder.decode();\n  if (buffer.length > 0) {\n    const event = handleLine(buffer);\n    if (event !== null) yield event;\n  }\n  // Final dispatch in case last event lacked terminating blank line\n  const tail = dispatch();\n  if (tail !== null) yield tail;\n}\n","/**\n * @theokit/sdk — Subscription type contract (G8 v1.7.0).\n *\n * Per ADRs D423 (resume token opaque), D424 (transport selection),\n * D426 (defineSubscription DSL shape).\n *\n * @public\n */\n\nimport { TheokitAgentError } from \"../errors.js\";\n\n/**\n * Transport selection for subscriptions.\n *\n * - `'ws'`: WebSocket (bidirectional). Required for inbound client→server frames.\n *   v1.7 ships Node-canonical `ws` adapter; CF/Bun/Deno deferred to v1.8.x per ADR D425.\n * - `'sse'`: W3C Server-Sent Events (server→client only). Browser-native EventSource.\n * - `'auto'`: Prefer WS, fall back SSE on upgrade failure. Default.\n *\n * @public\n */\nexport type SubscriptionTransport = \"ws\" | \"sse\" | \"auto\";\n\n/**\n * Context passed to a subscription `handler` on each invocation.\n *\n * @public\n */\nexport interface SubscriptionCtx {\n  /**\n   * Opaque resume token forwarded by the client when reconnecting.\n   * Handler defines its own semantics (monotonic int, ULID, timestamp,\n   * encrypted cursor). SDK passes through unchanged. Per ADR D423.\n   */\n  readonly lastEventId?: string;\n\n  /**\n   * AbortSignal that fires when the subscription is cancelled\n   * (client disconnect, consumer abort, server shutdown).\n   * Handler MUST honor `signal.aborted` in long-running loops.\n   */\n  readonly signal: AbortSignal;\n\n  /**\n   * Stable identifier for the underlying transport connection.\n   * Different from the subscription name — one connection may host\n   * many subscriptions. Useful for logging / per-connection state.\n   */\n  readonly connectionId: string;\n\n  /**\n   * Force-close the underlying transport with optional WS close code + reason.\n   * Used by consumer code (e.g., auth middleware revoking a session) to\n   * terminate a subscription that should not continue.\n   */\n  disconnect(code?: number, reason?: string): void;\n\n  /**\n   * Helper to mint a tracked envelope `[id, payload]`.\n   * Yielding tracked envelopes lets the client advance `lastEventId`\n   * so reconnects can resume from that point.\n   */\n  tracked<TPayload>(id: string, payload: TPayload): TrackedEnvelope<TPayload>;\n}\n\n/**\n * Tracked envelope: `[id, payload]` tuple yielded by subscription handlers\n * to advertise the resume token associated with the payload.\n *\n * The encoder writes the `id` as an SSE `id:` field or WS payload metadata\n * so the client can echo it back on reconnect (`input.lastEventId`).\n *\n * Per ADR D423.\n *\n * @public\n */\nexport type TrackedEnvelope<T> = readonly [id: string, payload: T];\n\n/**\n * Type guard for {@link TrackedEnvelope}.\n *\n * @public\n */\nexport function isTrackedEnvelope(value: unknown): value is TrackedEnvelope<unknown> {\n  return Array.isArray(value) && value.length === 2 && typeof value[0] === \"string\";\n}\n\n/**\n * Mint a tracked envelope. Equivalent to `[id, payload] as const`,\n * exported as a function so consumers don't repeat the tuple cast.\n *\n * @public\n */\nexport function tracked<T>(id: string, payload: T): TrackedEnvelope<T> {\n  if (typeof id !== \"string\" || id.length === 0) {\n    throw new TypeError(\"tracked(): id must be a non-empty string\");\n  }\n  return [id, payload] as const;\n}\n\n/**\n * Base error for the subscription subsystem. Extends {@link TheokitAgentError}\n * so existing `instanceof TheokitAgentError` branches keep working.\n *\n * @public\n */\nexport class SubscriptionError extends TheokitAgentError {\n  override readonly name: string = \"SubscriptionError\";\n\n  constructor(message: string, options: { code?: string; cause?: unknown } = {}) {\n    super(message, { ...options, isRetryable: false });\n  }\n}\n\n/**\n * Thrown when subscription input fails Zod schema validation.\n *\n * @public\n */\nexport class SubscriptionInputError extends SubscriptionError {\n  override readonly name: string = \"SubscriptionInputError\";\n\n  readonly issues: unknown;\n\n  constructor(message: string, options: { issues: unknown; cause?: unknown }) {\n    super(message, { code: \"subscription_input_invalid\", cause: options.cause });\n    this.issues = options.issues;\n  }\n}\n\n/**\n * Thrown when a subscription transport disconnects unexpectedly\n * AND the client did not opt out of reconnect.\n *\n * @public\n */\nexport class SubscriptionDisconnectError extends SubscriptionError {\n  override readonly name: string = \"SubscriptionDisconnectError\";\n\n  readonly closeCode?: number;\n  readonly closeReason?: string;\n\n  constructor(\n    message: string,\n    options: { closeCode?: number; closeReason?: string; cause?: unknown } = {},\n  ) {\n    super(message, { code: \"subscription_disconnected\", cause: options.cause });\n    if (options.closeCode !== undefined) this.closeCode = options.closeCode;\n    if (options.closeReason !== undefined) this.closeReason = options.closeReason;\n  }\n}\n\n/**\n * Descriptor returned by {@link Subscription.create}. Carries the typed\n * input/output Zod schemas + handler factory.\n *\n * @public\n */\nexport interface SubscriptionDescriptor<TInput = unknown, TOutput = unknown> {\n  /** Optional explicit name; the runtime may also derive name from file path. */\n  readonly name?: string;\n  /** Zod schema for the subscription input. Validated at dispatch boundary. */\n  readonly input: ZodLike<TInput>;\n  /** Zod schema for each output frame (informational; not enforced per-frame). */\n  readonly output: ZodLike<TOutput>;\n  /** Async handler that yields output frames (or tracked envelopes). */\n  readonly handler: (\n    input: TInput,\n    ctx: SubscriptionCtx,\n  ) => AsyncGenerator<TOutput | TrackedEnvelope<TOutput>, void, void>;\n}\n\n/**\n * Minimal structural Zod type used to avoid hard peer-dep import.\n * Mirrors the surface used by other SDK modules (e.g., `define-tool.ts`).\n *\n * @internal\n */\nexport interface ZodLike<T> {\n  safeParse(value: unknown): { success: true; data: T } | { success: false; error: unknown };\n  parse(value: unknown): T;\n}\n","/**\n * @theokit/sdk — `Theokit.subscribe` client (G8 public API).\n *\n * Per ADR D427 (Theokit.subscribe namespace) + D424 (transport selection)\n * + D423 (lastEventId opaque propagation).\n *\n * Returns an AsyncGenerator that yields server-sent values. Transparent\n * reconnect with exponential backoff. Propagates `lastEventId` from the last\n * received tracked envelope on each reconnect attempt.\n *\n * @public\n */\n\nimport { parseSseW3C } from \"./internal/sse-parser.js\";\nimport type { WireFrame } from \"./internal/subscription-runtime.js\";\nimport {\n  SubscriptionDisconnectError,\n  SubscriptionError,\n  type SubscriptionTransport,\n} from \"./types.js\";\n\n/**\n * Options accepted by `Theokit.subscribe(name, input, opts?)`.\n *\n * @public\n */\nexport interface SubscribeOptions {\n  /** Base URL of the server (e.g., `\"http://localhost:3000\"`). Required. */\n  baseUrl: string;\n  /** Preferred transport. Default `\"auto\"` (WS preferred, SSE fallback). */\n  transport?: SubscriptionTransport;\n  /** Max reconnect attempts (default 10). 0 disables reconnect. */\n  maxReconnectAttempts?: number;\n  /** Backoff strategy. Default exponential `min(30_000, 1000 * 2^attempt)` ms. */\n  retryDelayMs?: (attempt: number) => number;\n  /** Caller-supplied abort signal. Cancels the subscription entirely. */\n  signal?: AbortSignal;\n  /** Additional fetch-style headers (e.g., `Authorization`). */\n  headers?: Record<string, string>;\n}\n\nconst defaultRetry = (attempt: number) => Math.min(30_000, 1000 * 2 ** attempt);\n\n/**\n * Subscribe to a typed subscription. Yields values produced by the server\n * handler. On disconnect with reconnect enabled, transparently re-establishes\n * the connection and forwards `lastEventId` from the last received tracked\n * envelope so the server handler can resume.\n *\n * @public\n */\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: G8 subscribe orchestrates reconnect + transport switch + resume — refactor candidate tracked in subscription/theokit-subscribe.ts:52 followup\nexport async function* subscribe<TInput, TOutput>(\n  name: string,\n  input: TInput,\n  opts: SubscribeOptions,\n): AsyncGenerator<TOutput, void, void> {\n  if (typeof name !== \"string\" || name.length === 0) {\n    throw new SubscriptionError(\"Theokit.subscribe: name must be a non-empty string\", {\n      code: \"subscribe_name_invalid\",\n    });\n  }\n  if (opts === null || typeof opts !== \"object\" || typeof opts.baseUrl !== \"string\") {\n    throw new SubscriptionError(\"Theokit.subscribe: opts.baseUrl is required\", {\n      code: \"subscribe_baseUrl_missing\",\n    });\n  }\n  const transport = opts.transport ?? \"auto\";\n  const maxReconnects = opts.maxReconnectAttempts ?? 10;\n  const retry = opts.retryDelayMs ?? defaultRetry;\n\n  let lastEventId: string | undefined;\n  let attempt = 0;\n\n  while (true) {\n    if (opts.signal?.aborted) return;\n    try {\n      const inputWithCursor = mergeLastEventId(input, lastEventId);\n      const chosen = await selectTransport(transport, name, opts);\n      if (chosen === \"ws\") {\n        for await (const out of openWs<TOutput>(name, inputWithCursor, opts)) {\n          if (out.lastEventId !== undefined) lastEventId = out.lastEventId;\n          attempt = 0; // reset backoff on successful frame\n          yield out.value;\n        }\n      } else {\n        for await (const out of openSse<TOutput>(name, inputWithCursor, opts)) {\n          if (out.lastEventId !== undefined) lastEventId = out.lastEventId;\n          attempt = 0;\n          yield out.value;\n        }\n      }\n      // Clean end-of-stream — no reconnect.\n      return;\n    } catch (cause) {\n      if (opts.signal?.aborted) return;\n      if (maxReconnects === 0 || attempt >= maxReconnects) {\n        if (cause instanceof SubscriptionError) throw cause;\n        throw new SubscriptionDisconnectError(\n          `subscription \"${name}\" disconnected; reconnect exhausted`,\n          { cause },\n        );\n      }\n      const delay = retry(attempt);\n      attempt++;\n      await sleep(delay, opts.signal);\n    }\n  }\n}\n\ninterface FrameOut<T> {\n  readonly value: T;\n  readonly lastEventId?: string;\n}\n\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: openSse parses framed SSE stream with abort/error/retry branches — refactor candidate\nasync function* openSse<T>(\n  name: string,\n  input: unknown,\n  opts: SubscribeOptions,\n): AsyncIterable<FrameOut<T>> {\n  const url = `${stripTrailingSlash(opts.baseUrl)}/api/subscriptions/${encodeURIComponent(name)}?input=${encodeURIComponent(JSON.stringify(input))}`;\n  const res = await fetch(url, {\n    method: \"GET\",\n    headers: {\n      accept: \"text/event-stream\",\n      ...(opts.headers ?? {}),\n    },\n    ...(opts.signal !== undefined ? { signal: opts.signal } : {}),\n  });\n  if (!res.ok || res.body === null) {\n    throw new SubscriptionError(`SSE subscribe failed: HTTP ${res.status} ${res.statusText}`, {\n      code: \"sse_http_error\",\n    });\n  }\n  const events = parseSseW3C(streamToAsyncIterable(res.body));\n  for await (const ev of events) {\n    if (ev.event === \"end\") return;\n    if (ev.event === \"error\") {\n      throw new SubscriptionError(`SSE server emitted error: ${ev.data ?? \"(no body)\"}`, {\n        code: \"sse_server_error\",\n      });\n    }\n    if (ev.event === \"connected\") continue;\n    if (ev.data === undefined) continue;\n    const parsedValue = safeJsonParse<T>(ev.data);\n    if (parsedValue === undefined) continue;\n    yield {\n      value: parsedValue,\n      ...(ev.id !== undefined ? { lastEventId: ev.id } : {}),\n    };\n  }\n}\n\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: openWs orchestrates WS lifecycle + envelope decode + cleanup — refactor candidate\nasync function* openWs<T>(\n  name: string,\n  input: unknown,\n  opts: SubscribeOptions,\n): AsyncIterable<FrameOut<T>> {\n  const baseUrl = stripTrailingSlash(opts.baseUrl);\n  const wsUrl = baseUrl\n    .replace(/^http:/, \"ws:\")\n    .replace(/^https:/, \"wss:\")\n    .concat(\"/api/ws\");\n\n  const WS = (globalThis as { WebSocket?: typeof WebSocket }).WebSocket;\n  if (WS === undefined) {\n    throw new SubscriptionError(\n      \"Theokit.subscribe(transport='ws'): no global WebSocket available. Use Node >=22 or install 'ws' as a runtime dep + assign to globalThis.WebSocket.\",\n      { code: \"ws_global_missing\" },\n    );\n  }\n  const ws = new WS(wsUrl);\n\n  // Set up async iterator-like state.\n  const incoming: WireFrame[] = [];\n  // biome-ignore lint/suspicious/noConfusingVoidType: idiomatic event-callback signature; refactoring to undefined would mask the no-value semantics\n  let waiter: ((value: void) => void) | null = null;\n  let closed = false;\n  let closeError: Error | undefined;\n\n  ws.addEventListener(\"message\", (ev: MessageEvent) => {\n    const data = typeof ev.data === \"string\" ? ev.data : \"\";\n    const frame = safeJsonParse<WireFrame>(data);\n    if (frame !== undefined) {\n      incoming.push(frame);\n      if (waiter !== null) {\n        waiter();\n        waiter = null;\n      }\n    }\n  });\n  ws.addEventListener(\"close\", () => {\n    closed = true;\n    if (waiter !== null) {\n      waiter();\n      waiter = null;\n    }\n  });\n  ws.addEventListener(\"error\", () => {\n    closed = true;\n    closeError = new Error(\"WebSocket error\");\n    if (waiter !== null) {\n      waiter();\n      waiter = null;\n    }\n  });\n\n  await new Promise<void>((resolve, reject) => {\n    ws.addEventListener(\"open\", () => resolve(), { once: true });\n    ws.addEventListener(\"error\", () => reject(new Error(\"WS connect failed\")), { once: true });\n  });\n\n  // Send subscribe request after handshake.\n  ws.send(JSON.stringify({ kind: \"subscribe\", name, input }));\n\n  if (opts.signal !== undefined) {\n    opts.signal.addEventListener(\"abort\", () => ws.close(), { once: true });\n  }\n\n  try {\n    while (true) {\n      if (incoming.length === 0) {\n        if (closed) {\n          if (closeError !== undefined) throw closeError;\n          return;\n        }\n        await new Promise<void>((resolve) => {\n          waiter = resolve;\n        });\n        continue;\n      }\n      const frame = incoming.shift() as WireFrame;\n      if (frame.type === \"end\") return;\n      if (frame.type === \"error\") {\n        throw new SubscriptionError(\n          `WS server emitted error: ${frame.error?.message ?? \"(unknown)\"}`,\n          { code: \"ws_server_error\" },\n        );\n      }\n      const value = frame.data as T;\n      yield {\n        value,\n        ...(frame.id !== undefined ? { lastEventId: frame.id } : {}),\n      };\n    }\n  } finally {\n    try {\n      ws.close();\n    } catch {\n      /* ignore */\n    }\n  }\n}\n\nasync function selectTransport(\n  pref: SubscriptionTransport,\n  _name: string,\n  _opts: SubscribeOptions,\n): Promise<\"ws\" | \"sse\"> {\n  if (pref === \"ws\") return \"ws\";\n  if (pref === \"sse\") return \"sse\";\n  // auto — prefer WS if available, else SSE.\n  if (typeof (globalThis as { WebSocket?: unknown }).WebSocket === \"function\") {\n    return \"ws\";\n  }\n  return \"sse\";\n}\n\nfunction mergeLastEventId(input: unknown, lastEventId: string | undefined): unknown {\n  if (lastEventId === undefined) return input;\n  if (input === null || typeof input !== \"object\" || Array.isArray(input)) {\n    // Cannot merge into primitive — return as-is.\n    return input;\n  }\n  return { ...(input as object), lastEventId };\n}\n\nfunction stripTrailingSlash(s: string): string {\n  return s.endsWith(\"/\") ? s.slice(0, -1) : s;\n}\n\nfunction safeJsonParse<T>(s: string): T | undefined {\n  try {\n    return JSON.parse(s) as T;\n  } catch {\n    return undefined;\n  }\n}\n\nasync function* streamToAsyncIterable(\n  stream: ReadableStream<Uint8Array>,\n): AsyncIterable<Uint8Array> {\n  const reader = stream.getReader();\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n      if (done) return;\n      if (value !== undefined) yield value;\n    }\n  } finally {\n    reader.releaseLock();\n  }\n}\n\nfunction sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(new Error(\"aborted\"));\n      return;\n    }\n    const t = setTimeout(() => {\n      signal?.removeEventListener(\"abort\", onAbort);\n      resolve();\n    }, ms);\n    const onAbort = () => {\n      clearTimeout(t);\n      reject(new Error(\"aborted\"));\n    };\n    signal?.addEventListener(\"abort\", onAbort, { once: true });\n  });\n}\n"]}
+{"version":3,"sources":["../../src/subscription/define-subscription.ts","../../src/subscription/internal/sse-parser.ts","../../src/subscription/types.ts","../../src/subscription/theokit-subscribe.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * `defineSubscription` DSL (G8 public API) — `@theokit/sdk`.\n *\n * Per ADR D426 (AsyncGenerator handler + Zod input/output schemas).\n *\n * @public\n */\n\nimport type { SubscriptionCtx, SubscriptionDescriptor, TrackedEnvelope, ZodLike } from \"./types.js\";\n\n/**\n * Options accepted by {@link defineSubscription}.\n *\n * @public\n */\nexport interface DefineSubscriptionOptions<TInput, TOutput> {\n  /** Optional explicit name. Falls back to filename derivation by the scanner. */\n  name?: string;\n  /** Zod schema validating subscription input. Required (typed RPC contract). */\n  input: ZodLike<TInput>;\n  /** Zod schema describing each output frame. Informational; not enforced per-frame. */\n  output: ZodLike<TOutput>;\n  /**\n   * Handler that produces the subscription stream.\n   *\n   * Receives the validated input + {@link SubscriptionCtx}. Yielding a value\n   * emits a plain output frame. Yielding a `tracked(id, payload)` envelope\n   * additionally advertises a resume token to the client so reconnects can\n   * resume from that point.\n   */\n  handler: (\n    input: TInput,\n    ctx: SubscriptionCtx,\n  ) => AsyncGenerator<TOutput | TrackedEnvelope<TOutput>, void, void>;\n}\n\n/**\n * Define a typed subscription. Pair with `Theokit.subscribe(name, input)`\n * on the client side.\n *\n * Per ADR D426 — handler is `AsyncGenerator<TOutput | TrackedEnvelope<TOutput>>`.\n * The runtime validates input via `opts.input.safeParse` BEFORE invoking the\n * handler; failure throws {@link import('./types.js').SubscriptionInputError}.\n *\n * @example\n * ```ts\n * import { Subscription } from \"@theokit/sdk/subscription\";\n * import { z } from \"zod\";\n *\n * export default Subscription.create({\n *   input: z.object({ topic: z.string() }),\n *   output: z.object({ message: z.string(), ts: z.number() }),\n *   async *handler(input, ctx) {\n *     let cursor = ctx.lastEventId ?? \"0\";\n *     while (!ctx.signal.aborted) {\n *       const msgs = await fetchMessagesSince(input.topic, cursor);\n *       for (const m of msgs) {\n *         cursor = m.id;\n *         yield ctx.tracked(m.id, { message: m.body, ts: m.ts });\n *       }\n *       await sleep(1000);\n *     }\n *   },\n * });\n * ```\n *\n * @public\n */\nexport function defineSubscription<TInput, TOutput>(\n  opts: DefineSubscriptionOptions<TInput, TOutput>,\n): SubscriptionDescriptor<TInput, TOutput> {\n  if (opts === null || typeof opts !== \"object\") {\n    throw new TypeError(\"defineSubscription: options object is required\");\n  }\n  if (opts.input === undefined || typeof opts.input.safeParse !== \"function\") {\n    throw new TypeError(\"defineSubscription: opts.input must be a Zod schema (or ZodLike)\");\n  }\n  if (opts.output === undefined || typeof opts.output.safeParse !== \"function\") {\n    throw new TypeError(\"defineSubscription: opts.output must be a Zod schema (or ZodLike)\");\n  }\n  if (typeof opts.handler !== \"function\") {\n    throw new TypeError(\"defineSubscription: opts.handler must be an async generator function\");\n  }\n  return {\n    ...(opts.name !== undefined ? { name: opts.name } : {}),\n    input: opts.input,\n    output: opts.output,\n    handler: opts.handler,\n  };\n}\n\n/** SE36 — `Subscription.create` replaces `defineSubscription` (ADR 0015). @public */\nexport class Subscription {\n  private constructor() {}\n  static create<TInput, TOutput>(\n    opts: DefineSubscriptionOptions<TInput, TOutput>,\n  ): SubscriptionDescriptor<TInput, TOutput> {\n    return defineSubscription(opts);\n  }\n}\n","/**\n * W3C SSE parser (G8 internal) — `@theokit/sdk`.\n *\n * Per ADR D428. Reads from `ReadableStream<Uint8Array>` or async iterable of\n * UTF-8 chunks; yields parsed {@link SSEvent} objects per W3C SSE spec.\n *\n * Independent of `internal/llm/sse.ts:parseSseStream` (LLM-specific a peer vendor AI\n * Data Stream v1; locked by D38). This parser handles the `id:` field needed\n * for tracked envelopes (G8 resume mechanism), which the LLM parser ignores.\n *\n * Reference: https://html.spec.whatwg.org/multipage/server-sent-events.html\n *\n * @internal\n */\n\nimport type { SSEvent } from \"./sse-encoder.js\";\n\nconst decoder = new TextDecoder(\"utf-8\");\n\n/**\n * Parse an async iterable of UTF-8 byte chunks into a stream of SSE events.\n *\n * Implements the W3C event stream parser:\n * - Lines are split by `\\n`, `\\r\\n`, or `\\r`\n * - Events are dispatched on blank line (no `:` and no field name)\n * - Fields: `event`, `data` (multi-line concat with `\\n`), `id`, `retry`\n * - Lines starting with `:` are comments (ignored, except dispatched as `comment`)\n * - Unknown fields silently ignored per spec\n *\n * Empty events (no fields) are NOT dispatched per spec.\n *\n * @internal\n */\nexport async function* parseSseW3C(\n  source: AsyncIterable<Uint8Array>,\n): AsyncGenerator<SSEvent, void, void> {\n  let buffer = \"\";\n  let eventName: string | undefined;\n  let dataLines: string[] = [];\n  let id: string | undefined;\n  let retry: number | undefined;\n  let commentLines: string[] = [];\n  let hasField = false;\n\n  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: dispatch builds SSEvent from per-field state per W3C spec — refactor candidate\n  const dispatch = (): SSEvent | null => {\n    if (!hasField) {\n      // Blank line with no preceding fields → reset state, no dispatch (per spec § 9.2.6)\n      eventName = undefined;\n      dataLines = [];\n      id = undefined;\n      retry = undefined;\n      commentLines = [];\n      return null;\n    }\n    const chunk: SSEvent = {};\n    if (eventName !== undefined) (chunk as { event?: string }).event = eventName;\n    if (dataLines.length > 0) (chunk as { data?: string }).data = dataLines.join(\"\\n\");\n    if (id !== undefined) (chunk as { id?: string }).id = id;\n    if (retry !== undefined) (chunk as { retry?: number }).retry = retry;\n    if (commentLines.length > 0) (chunk as { comment?: string }).comment = commentLines.join(\"\\n\");\n    eventName = undefined;\n    dataLines = [];\n    id = undefined;\n    retry = undefined;\n    commentLines = [];\n    hasField = false;\n    return chunk;\n  };\n\n  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: handleLine dispatches across all SSE field kinds per W3C spec — refactor candidate\n  const handleLine = (line: string): SSEvent | null => {\n    if (line === \"\") {\n      return dispatch();\n    }\n    if (line.startsWith(\":\")) {\n      // Comment line — per spec ignored, but we surface it for keepalive visibility.\n      commentLines.push(line.slice(1).replace(/^ /, \"\"));\n      hasField = true;\n      return null;\n    }\n    const colonIdx = line.indexOf(\":\");\n    let field: string;\n    let value: string;\n    if (colonIdx === -1) {\n      field = line;\n      value = \"\";\n    } else {\n      field = line.slice(0, colonIdx);\n      value = line.slice(colonIdx + 1);\n      // Strip ONE leading space if present (per spec § 9.2.6)\n      if (value.startsWith(\" \")) value = value.slice(1);\n    }\n    switch (field) {\n      case \"event\":\n        eventName = value;\n        hasField = true;\n        break;\n      case \"data\":\n        dataLines.push(value);\n        hasField = true;\n        break;\n      case \"id\":\n        // Per spec: id with NULL is ignored\n        if (!value.includes(\"\\0\")) {\n          id = value;\n          hasField = true;\n        }\n        break;\n      case \"retry\":\n        if (/^\\d+$/.test(value)) {\n          retry = Number.parseInt(value, 10);\n          hasField = true;\n        }\n        break;\n      default:\n        // Unknown field — ignored per spec\n        break;\n    }\n    return null;\n  };\n\n  for await (const bytes of source) {\n    // Normalize CRLF / CR to LF then split\n    buffer += decoder.decode(bytes, { stream: true }).replace(/\\r\\n|\\r/g, \"\\n\");\n    let idx: number;\n    // biome-ignore lint/suspicious/noAssignInExpressions: idiomatic while-assignment loop for buffered line parsing\n    while ((idx = buffer.indexOf(\"\\n\")) !== -1) {\n      const line = buffer.slice(0, idx);\n      buffer = buffer.slice(idx + 1);\n      const event = handleLine(line);\n      if (event !== null) yield event;\n    }\n  }\n  // Flush remaining buffer as a final line (no trailing newline case)\n  buffer += decoder.decode();\n  if (buffer.length > 0) {\n    const event = handleLine(buffer);\n    if (event !== null) yield event;\n  }\n  // Final dispatch in case last event lacked terminating blank line\n  const tail = dispatch();\n  if (tail !== null) yield tail;\n}\n","/**\n * Subscription type contract (G8 v1.7.0) — `@theokit/sdk`.\n *\n * Per ADRs D423 (resume token opaque), D424 (transport selection),\n * D426 (defineSubscription DSL shape).\n *\n * @public\n */\n\nimport { TheokitAgentError } from \"../errors.js\";\n\n/**\n * Transport selection for subscriptions.\n *\n * - `'ws'`: WebSocket (bidirectional). Required for inbound client→server frames.\n *   v1.7 ships Node-canonical `ws` adapter; CF/Bun/Deno deferred to v1.8.x per ADR D425.\n * - `'sse'`: W3C Server-Sent Events (server→client only). Browser-native EventSource.\n * - `'auto'`: Prefer WS, fall back SSE on upgrade failure. Default.\n *\n * @public\n */\nexport type SubscriptionTransport = \"ws\" | \"sse\" | \"auto\";\n\n/**\n * Context passed to a subscription `handler` on each invocation.\n *\n * @public\n */\nexport interface SubscriptionCtx {\n  /**\n   * Opaque resume token forwarded by the client when reconnecting.\n   * Handler defines its own semantics (monotonic int, ULID, timestamp,\n   * encrypted cursor). SDK passes through unchanged. Per ADR D423.\n   */\n  readonly lastEventId?: string;\n\n  /**\n   * AbortSignal that fires when the subscription is cancelled\n   * (client disconnect, consumer abort, server shutdown).\n   * Handler MUST honor `signal.aborted` in long-running loops.\n   */\n  readonly signal: AbortSignal;\n\n  /**\n   * Stable identifier for the underlying transport connection.\n   * Different from the subscription name — one connection may host\n   * many subscriptions. Useful for logging / per-connection state.\n   */\n  readonly connectionId: string;\n\n  /**\n   * Force-close the underlying transport with optional WS close code + reason.\n   * Used by consumer code (e.g., auth middleware revoking a session) to\n   * terminate a subscription that should not continue.\n   */\n  disconnect(code?: number, reason?: string): void;\n\n  /**\n   * Helper to mint a tracked envelope `[id, payload]`.\n   * Yielding tracked envelopes lets the client advance `lastEventId`\n   * so reconnects can resume from that point.\n   */\n  tracked<TPayload>(id: string, payload: TPayload): TrackedEnvelope<TPayload>;\n}\n\n/**\n * Tracked envelope: `[id, payload]` tuple yielded by subscription handlers\n * to advertise the resume token associated with the payload.\n *\n * The encoder writes the `id` as an SSE `id:` field or WS payload metadata\n * so the client can echo it back on reconnect (`input.lastEventId`).\n *\n * Per ADR D423.\n *\n * @public\n */\nexport type TrackedEnvelope<T> = readonly [id: string, payload: T];\n\n/**\n * Type guard for {@link TrackedEnvelope}.\n *\n * @public\n */\nexport function isTrackedEnvelope(value: unknown): value is TrackedEnvelope<unknown> {\n  return Array.isArray(value) && value.length === 2 && typeof value[0] === \"string\";\n}\n\n/**\n * Mint a tracked envelope. Equivalent to `[id, payload] as const`,\n * exported as a function so consumers don't repeat the tuple cast.\n *\n * @public\n */\nexport function tracked<T>(id: string, payload: T): TrackedEnvelope<T> {\n  if (typeof id !== \"string\" || id.length === 0) {\n    throw new TypeError(\"tracked(): id must be a non-empty string\");\n  }\n  return [id, payload] as const;\n}\n\n/**\n * Base error for the subscription subsystem. Extends {@link TheokitAgentError}\n * so existing `instanceof TheokitAgentError` branches keep working.\n *\n * @public\n */\nexport class SubscriptionError extends TheokitAgentError {\n  override readonly name: string = \"SubscriptionError\";\n\n  constructor(message: string, options: { code?: string; cause?: unknown } = {}) {\n    super(message, { ...options, isRetryable: false });\n  }\n}\n\n/**\n * Thrown when subscription input fails Zod schema validation.\n *\n * @public\n */\nexport class SubscriptionInputError extends SubscriptionError {\n  override readonly name: string = \"SubscriptionInputError\";\n\n  readonly issues: unknown;\n\n  constructor(message: string, options: { issues: unknown; cause?: unknown }) {\n    super(message, { code: \"subscription_input_invalid\", cause: options.cause });\n    this.issues = options.issues;\n  }\n}\n\n/**\n * Thrown when a subscription transport disconnects unexpectedly\n * AND the client did not opt out of reconnect.\n *\n * @public\n */\nexport class SubscriptionDisconnectError extends SubscriptionError {\n  override readonly name: string = \"SubscriptionDisconnectError\";\n\n  readonly closeCode?: number;\n  readonly closeReason?: string;\n\n  constructor(\n    message: string,\n    options: { closeCode?: number; closeReason?: string; cause?: unknown } = {},\n  ) {\n    super(message, { code: \"subscription_disconnected\", cause: options.cause });\n    if (options.closeCode !== undefined) this.closeCode = options.closeCode;\n    if (options.closeReason !== undefined) this.closeReason = options.closeReason;\n  }\n}\n\n/**\n * Descriptor returned by {@link Subscription.create}. Carries the typed\n * input/output Zod schemas + handler factory.\n *\n * @public\n */\nexport interface SubscriptionDescriptor<TInput = unknown, TOutput = unknown> {\n  /** Optional explicit name; the runtime may also derive name from file path. */\n  readonly name?: string;\n  /** Zod schema for the subscription input. Validated at dispatch boundary. */\n  readonly input: ZodLike<TInput>;\n  /** Zod schema for each output frame (informational; not enforced per-frame). */\n  readonly output: ZodLike<TOutput>;\n  /** Async handler that yields output frames (or tracked envelopes). */\n  readonly handler: (\n    input: TInput,\n    ctx: SubscriptionCtx,\n  ) => AsyncGenerator<TOutput | TrackedEnvelope<TOutput>, void, void>;\n}\n\n/**\n * Minimal structural Zod type used to avoid hard peer-dep import.\n * Mirrors the surface used by other SDK modules (e.g., `define-tool.ts`).\n *\n * Emitted rather than erased: it appears in the signature of `defineSubscription`, which\n * `@theokit/sdk/subscription` publishes, so a consumer's type-aware lint has to be able to\n * resolve it.\n */\nexport interface ZodLike<T> {\n  safeParse(value: unknown): { success: true; data: T } | { success: false; error: unknown };\n  parse(value: unknown): T;\n}\n","/**\n * `Theokit.subscribe` client (G8 public API) — `@theokit/sdk`.\n *\n * Per ADR D427 (Theokit.subscribe namespace) + D424 (transport selection)\n * + D423 (lastEventId opaque propagation).\n *\n * Returns an AsyncGenerator that yields server-sent values. Transparent\n * reconnect with exponential backoff. Propagates `lastEventId` from the last\n * received tracked envelope on each reconnect attempt.\n *\n * @public\n */\n\nimport { parseSseW3C } from \"./internal/sse-parser.js\";\nimport type { WireFrame } from \"./internal/subscription-runtime.js\";\nimport {\n  SubscriptionDisconnectError,\n  SubscriptionError,\n  type SubscriptionTransport,\n} from \"./types.js\";\n\n/**\n * Options accepted by `Theokit.subscribe(name, input, opts?)`.\n *\n * @public\n */\nexport interface SubscribeOptions {\n  /** Base URL of the server (e.g., `\"http://localhost:3000\"`). Required. */\n  baseUrl: string;\n  /** Preferred transport. Default `\"auto\"` (WS preferred, SSE fallback). */\n  transport?: SubscriptionTransport;\n  /** Max reconnect attempts (default 10). 0 disables reconnect. */\n  maxReconnectAttempts?: number;\n  /** Backoff strategy. Default exponential `min(30_000, 1000 * 2^attempt)` ms. */\n  retryDelayMs?: (attempt: number) => number;\n  /** Caller-supplied abort signal. Cancels the subscription entirely. */\n  signal?: AbortSignal;\n  /** Additional fetch-style headers (e.g., `Authorization`). */\n  headers?: Record<string, string>;\n  /**\n   * Override the SSE transport's `fetch`. Defaults to `globalThis.fetch`.\n   * Lets a consumer supply a proxying agent or instrumented fetch without\n   * mutating the runtime global.\n   */\n  fetch?: typeof globalThis.fetch;\n  /**\n   * Override the WS transport's `WebSocket` constructor. Defaults to\n   * `globalThis.WebSocket`. Lets a consumer polyfill WS on a runtime that\n   * lacks it, or supply an instrumented implementation, without mutating\n   * the runtime global.\n   */\n  WebSocket?: typeof WebSocket;\n}\n\nconst defaultRetry = (attempt: number) => Math.min(30_000, 1000 * 2 ** attempt);\n\n/**\n * Subscribe to a typed subscription. Yields values produced by the server\n * handler. On disconnect with reconnect enabled, transparently re-establishes\n * the connection and forwards `lastEventId` from the last received tracked\n * envelope so the server handler can resume.\n *\n * @public\n */\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: G8 subscribe orchestrates reconnect + transport switch + resume — refactor candidate tracked in subscription/theokit-subscribe.ts:52 followup\nexport async function* subscribe<TInput, TOutput>(\n  name: string,\n  input: TInput,\n  opts: SubscribeOptions,\n): AsyncGenerator<TOutput, void, void> {\n  if (typeof name !== \"string\" || name.length === 0) {\n    throw new SubscriptionError(\"Theokit.subscribe: name must be a non-empty string\", {\n      code: \"subscribe_name_invalid\",\n    });\n  }\n  if (opts === null || typeof opts !== \"object\" || typeof opts.baseUrl !== \"string\") {\n    throw new SubscriptionError(\"Theokit.subscribe: opts.baseUrl is required\", {\n      code: \"subscribe_baseUrl_missing\",\n    });\n  }\n  const transport = opts.transport ?? \"auto\";\n  const maxReconnects = opts.maxReconnectAttempts ?? 10;\n  const retry = opts.retryDelayMs ?? defaultRetry;\n\n  let lastEventId: string | undefined;\n  let attempt = 0;\n\n  while (true) {\n    if (opts.signal?.aborted) return;\n    try {\n      const inputWithCursor = mergeLastEventId(input, lastEventId);\n      const chosen = await selectTransport(transport, name, opts);\n      if (chosen === \"ws\") {\n        for await (const out of openWs<TOutput>(name, inputWithCursor, opts)) {\n          if (out.lastEventId !== undefined) lastEventId = out.lastEventId;\n          attempt = 0; // reset backoff on successful frame\n          yield out.value;\n        }\n      } else {\n        for await (const out of openSse<TOutput>(name, inputWithCursor, opts)) {\n          if (out.lastEventId !== undefined) lastEventId = out.lastEventId;\n          attempt = 0;\n          yield out.value;\n        }\n      }\n      // Clean end-of-stream — no reconnect.\n      return;\n    } catch (cause) {\n      if (opts.signal?.aborted) return;\n      if (maxReconnects === 0 || attempt >= maxReconnects) {\n        if (cause instanceof SubscriptionError) throw cause;\n        throw new SubscriptionDisconnectError(\n          `subscription \"${name}\" disconnected; reconnect exhausted`,\n          { cause },\n        );\n      }\n      const delay = retry(attempt);\n      attempt++;\n      await sleep(delay, opts.signal);\n    }\n  }\n}\n\ninterface FrameOut<T> {\n  readonly value: T;\n  readonly lastEventId?: string;\n}\n\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: openSse parses framed SSE stream with abort/error/retry branches — refactor candidate\nasync function* openSse<T>(\n  name: string,\n  input: unknown,\n  opts: SubscribeOptions,\n): AsyncIterable<FrameOut<T>> {\n  const url = `${stripTrailingSlash(opts.baseUrl)}/api/subscriptions/${encodeURIComponent(name)}?input=${encodeURIComponent(JSON.stringify(input))}`;\n  const fetchFn = opts.fetch ?? globalThis.fetch;\n  const res = await fetchFn(url, {\n    method: \"GET\",\n    headers: {\n      accept: \"text/event-stream\",\n      ...(opts.headers ?? {}),\n    },\n    ...(opts.signal !== undefined ? { signal: opts.signal } : {}),\n  });\n  if (!res.ok || res.body === null) {\n    throw new SubscriptionError(`SSE subscribe failed: HTTP ${res.status} ${res.statusText}`, {\n      code: \"sse_http_error\",\n    });\n  }\n  const events = parseSseW3C(streamToAsyncIterable(res.body));\n  for await (const ev of events) {\n    if (ev.event === \"end\") return;\n    if (ev.event === \"error\") {\n      throw new SubscriptionError(`SSE server emitted error: ${ev.data ?? \"(no body)\"}`, {\n        code: \"sse_server_error\",\n      });\n    }\n    if (ev.event === \"connected\") continue;\n    if (ev.data === undefined) continue;\n    const parsedValue = safeJsonParse<T>(ev.data);\n    if (parsedValue === undefined) continue;\n    yield {\n      value: parsedValue,\n      ...(ev.id !== undefined ? { lastEventId: ev.id } : {}),\n    };\n  }\n}\n\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: openWs orchestrates WS lifecycle + envelope decode + cleanup — refactor candidate\nasync function* openWs<T>(\n  name: string,\n  input: unknown,\n  opts: SubscribeOptions,\n): AsyncIterable<FrameOut<T>> {\n  const baseUrl = stripTrailingSlash(opts.baseUrl);\n  const wsUrl = baseUrl\n    .replace(/^http:/, \"ws:\")\n    .replace(/^https:/, \"wss:\")\n    .concat(\"/api/ws\");\n\n  const WS = opts.WebSocket ?? (globalThis as { WebSocket?: typeof WebSocket }).WebSocket;\n  if (WS === undefined) {\n    throw new SubscriptionError(\n      \"Theokit.subscribe(transport='ws'): no global WebSocket available. Use Node >=22 or install 'ws' as a runtime dep + assign to globalThis.WebSocket, or pass opts.WebSocket.\",\n      { code: \"ws_global_missing\" },\n    );\n  }\n  const ws = new WS(wsUrl);\n\n  // Set up async iterator-like state.\n  const incoming: WireFrame[] = [];\n  // biome-ignore lint/suspicious/noConfusingVoidType: idiomatic event-callback signature; refactoring to undefined would mask the no-value semantics\n  let waiter: ((value: void) => void) | null = null;\n  let closed = false;\n  let closeError: Error | undefined;\n\n  ws.addEventListener(\"message\", (ev: MessageEvent) => {\n    const data = typeof ev.data === \"string\" ? ev.data : \"\";\n    const frame = safeJsonParse<WireFrame>(data);\n    if (frame !== undefined) {\n      incoming.push(frame);\n      if (waiter !== null) {\n        waiter();\n        waiter = null;\n      }\n    }\n  });\n  ws.addEventListener(\"close\", () => {\n    closed = true;\n    if (waiter !== null) {\n      waiter();\n      waiter = null;\n    }\n  });\n  ws.addEventListener(\"error\", () => {\n    closed = true;\n    closeError = new Error(\"WebSocket error\");\n    if (waiter !== null) {\n      waiter();\n      waiter = null;\n    }\n  });\n\n  await new Promise<void>((resolve, reject) => {\n    ws.addEventListener(\"open\", () => resolve(), { once: true });\n    ws.addEventListener(\"error\", () => reject(new Error(\"WS connect failed\")), { once: true });\n  });\n\n  // Send subscribe request after handshake.\n  ws.send(JSON.stringify({ kind: \"subscribe\", name, input }));\n\n  if (opts.signal !== undefined) {\n    opts.signal.addEventListener(\"abort\", () => ws.close(), { once: true });\n  }\n\n  try {\n    while (true) {\n      if (incoming.length === 0) {\n        if (closed) {\n          if (closeError !== undefined) throw closeError;\n          return;\n        }\n        await new Promise<void>((resolve) => {\n          waiter = resolve;\n        });\n        continue;\n      }\n      const frame = incoming.shift() as WireFrame;\n      if (frame.type === \"end\") return;\n      if (frame.type === \"error\") {\n        throw new SubscriptionError(\n          `WS server emitted error: ${frame.error?.message ?? \"(unknown)\"}`,\n          { code: \"ws_server_error\" },\n        );\n      }\n      const value = frame.data as T;\n      yield {\n        value,\n        ...(frame.id !== undefined ? { lastEventId: frame.id } : {}),\n      };\n    }\n  } finally {\n    try {\n      ws.close();\n    } catch {\n      /* ignore */\n    }\n  }\n}\n\nasync function selectTransport(\n  pref: SubscriptionTransport,\n  _name: string,\n  opts: SubscribeOptions,\n): Promise<\"ws\" | \"sse\"> {\n  if (pref === \"ws\") return \"ws\";\n  if (pref === \"sse\") return \"sse\";\n  // auto — prefer WS if available (injected or global), else SSE.\n  const WS = opts.WebSocket ?? (globalThis as { WebSocket?: unknown }).WebSocket;\n  if (typeof WS === \"function\") {\n    return \"ws\";\n  }\n  return \"sse\";\n}\n\nfunction mergeLastEventId(input: unknown, lastEventId: string | undefined): unknown {\n  if (lastEventId === undefined) return input;\n  if (input === null || typeof input !== \"object\" || Array.isArray(input)) {\n    // Cannot merge into primitive — return as-is.\n    return input;\n  }\n  return { ...(input as object), lastEventId };\n}\n\nfunction stripTrailingSlash(s: string): string {\n  return s.endsWith(\"/\") ? s.slice(0, -1) : s;\n}\n\nfunction safeJsonParse<T>(s: string): T | undefined {\n  try {\n    return JSON.parse(s) as T;\n  } catch {\n    return undefined;\n  }\n}\n\nasync function* streamToAsyncIterable(\n  stream: ReadableStream<Uint8Array>,\n): AsyncIterable<Uint8Array> {\n  const reader = stream.getReader();\n  let finishedNaturally = false;\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n      if (done) {\n        finishedNaturally = true;\n        return;\n      }\n      if (value !== undefined) yield value;\n    }\n  } finally {\n    // B-131: `releaseLock()` alone detaches the reader WITHOUT canceling the stream (WHATWG\n    // Streams spec) — the underlying `fetch` response body, and its socket, stays open until\n    // something else cancels it or reads it to completion. A consumer that breaks out of the\n    // subscription mid-stream (the ordinary shape: `for await ... break`) used to leave that\n    // connection dangling. `cancel()` is a no-op once the stream is already closed, so it is safe\n    // to call unconditionally on the early-exit path; skip it on natural completion, where the\n    // stream is already done and canceling only risks surfacing a spurious rejection.\n    if (!finishedNaturally) {\n      try {\n        await reader.cancel();\n      } catch {\n        /* best-effort cleanup — the caller's own error (if any) already takes precedence */\n      }\n    }\n    reader.releaseLock();\n  }\n}\n\nfunction sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(new Error(\"aborted\"));\n      return;\n    }\n    const t = setTimeout(() => {\n      signal?.removeEventListener(\"abort\", onAbort);\n      resolve();\n    }, ms);\n    const onAbort = () => {\n      clearTimeout(t);\n      reject(new Error(\"aborted\"));\n    };\n    signal?.addEventListener(\"abort\", onAbort, { once: true });\n  });\n}\n"]}

package/dist/subscription/internal/adapter-types.d.cts

@@ -1,5 +1,5 @@
 /**
- * @theokit/sdk — WS adapter contract (G8 internal).
+ * WS adapter contract (G8 internal) — `@theokit/sdk`.
  *
  * Per ADR D425. Defines the minimal interface that runtime adapters
  * (Node `ws`, CF Workers WebSocketPair v1.8.x, Bun.serve v1.8.x, etc.)

package/dist/subscription/internal/adapter-types.d.ts

@@ -1,5 +1,5 @@
 /**
- * @theokit/sdk — WS adapter contract (G8 internal).
+ * WS adapter contract (G8 internal) — `@theokit/sdk`.
  *
  * Per ADR D425. Defines the minimal interface that runtime adapters
  * (Node `ws`, CF Workers WebSocketPair v1.8.x, Bun.serve v1.8.x, etc.)

package/dist/subscription/internal/server-integration.d.cts

@@ -1,5 +1,5 @@
 /**
- * @theokit/sdk — theokit/server integration (G8 internal).
+ * Theokit/server integration (G8 internal) — `@theokit/sdk`.
  *
  * Per ADR D429 (auto-route via theokit.subscriptions namespace).
  *

package/dist/subscription/internal/server-integration.d.ts

@@ -1,5 +1,5 @@
 /**
- * @theokit/sdk — theokit/server integration (G8 internal).
+ * Theokit/server integration (G8 internal) — `@theokit/sdk`.
  *
  * Per ADR D429 (auto-route via theokit.subscriptions namespace).
  *

package/dist/subscription/internal/sse-encoder.d.cts

@@ -1,5 +1,5 @@
 /**
- * @theokit/sdk — W3C SSE encoder (G8 internal).
+ * W3C SSE encoder (G8 internal) — `@theokit/sdk`.
  *
  * Per ADR D428 (W3C wire format, independent of D38 a peer vendor AI Data Stream).
  *

package/dist/subscription/internal/sse-encoder.d.ts

@@ -1,5 +1,5 @@
 /**
- * @theokit/sdk — W3C SSE encoder (G8 internal).
+ * W3C SSE encoder (G8 internal) — `@theokit/sdk`.
  *
  * Per ADR D428 (W3C wire format, independent of D38 a peer vendor AI Data Stream).
  *

package/dist/subscription/internal/sse-parser.d.cts

@@ -1,5 +1,5 @@
 /**
- * @theokit/sdk — W3C SSE parser (G8 internal).
+ * W3C SSE parser (G8 internal) — `@theokit/sdk`.
  *
  * Per ADR D428. Reads from `ReadableStream<Uint8Array>` or async iterable of
  * UTF-8 chunks; yields parsed {@link SSEvent} objects per W3C SSE spec.

package/dist/subscription/internal/sse-parser.d.ts

@@ -1,5 +1,5 @@
 /**
- * @theokit/sdk — W3C SSE parser (G8 internal).
+ * W3C SSE parser (G8 internal) — `@theokit/sdk`.
  *
  * Per ADR D428. Reads from `ReadableStream<Uint8Array>` or async iterable of
  * UTF-8 chunks; yields parsed {@link SSEvent} objects per W3C SSE spec.

package/dist/subscription/internal/subscription-runtime.d.cts

@@ -1,5 +1,5 @@
 /**
- * @theokit/sdk — Subscription runtime (G8 internal).
+ * Subscription runtime (G8 internal) — `@theokit/sdk`.
  *
  * Per ADR D422 (Form 4 Hybrid). Hosts registered {@link SubscriptionDescriptor}
  * + dispatches incoming subscription requests across SSE / WS transports.

package/dist/subscription/internal/subscription-runtime.d.ts

@@ -1,5 +1,5 @@
 /**
- * @theokit/sdk — Subscription runtime (G8 internal).
+ * Subscription runtime (G8 internal) — `@theokit/sdk`.
  *
  * Per ADR D422 (Form 4 Hybrid). Hosts registered {@link SubscriptionDescriptor}
  * + dispatches incoming subscription requests across SSE / WS transports.

package/dist/subscription/internal/ws-adapter-node.d.cts

@@ -1,5 +1,5 @@
 /**
- * @theokit/sdk — Node `ws` WebSocket adapter (G8 internal).
+ * Node `ws` WebSocket adapter (G8 internal) — `@theokit/sdk`.
  *
  * Per ADR D425. Canonical v1.7.0 adapter — wraps `ws.WebSocketServer({ noServer: true })`
  * for explicit HTTP upgrade integration. Dynamic `import('ws')` keeps the lib

package/dist/subscription/internal/ws-adapter-node.d.ts

@@ -1,5 +1,5 @@
 /**
- * @theokit/sdk — Node `ws` WebSocket adapter (G8 internal).
+ * Node `ws` WebSocket adapter (G8 internal) — `@theokit/sdk`.
  *
  * Per ADR D425. Canonical v1.7.0 adapter — wraps `ws.WebSocketServer({ noServer: true })`
  * for explicit HTTP upgrade integration. Dynamic `import('ws')` keeps the lib

package/dist/subscription/theokit-subscribe.d.cts

@@ -1,5 +1,5 @@
 /**
- * @theokit/sdk — `Theokit.subscribe` client (G8 public API).
+ * `Theokit.subscribe` client (G8 public API) — `@theokit/sdk`.
  *
  * Per ADR D427 (Theokit.subscribe namespace) + D424 (transport selection)
  * + D423 (lastEventId opaque propagation).
@@ -29,6 +29,19 @@ export interface SubscribeOptions {
     signal?: AbortSignal;
     /** Additional fetch-style headers (e.g., `Authorization`). */
     headers?: Record<string, string>;
+    /**
+     * Override the SSE transport's `fetch`. Defaults to `globalThis.fetch`.
+     * Lets a consumer supply a proxying agent or instrumented fetch without
+     * mutating the runtime global.
+     */
+    fetch?: typeof globalThis.fetch;
+    /**
+     * Override the WS transport's `WebSocket` constructor. Defaults to
+     * `globalThis.WebSocket`. Lets a consumer polyfill WS on a runtime that
+     * lacks it, or supply an instrumented implementation, without mutating
+     * the runtime global.
+     */
+    WebSocket?: typeof WebSocket;
 }
 /**
  * Subscribe to a typed subscription. Yields values produced by the server

package/dist/subscription/theokit-subscribe.d.ts

@@ -1,5 +1,5 @@
 /**
- * @theokit/sdk — `Theokit.subscribe` client (G8 public API).
+ * `Theokit.subscribe` client (G8 public API) — `@theokit/sdk`.
  *
  * Per ADR D427 (Theokit.subscribe namespace) + D424 (transport selection)
  * + D423 (lastEventId opaque propagation).
@@ -29,6 +29,19 @@ export interface SubscribeOptions {
     signal?: AbortSignal;
     /** Additional fetch-style headers (e.g., `Authorization`). */
     headers?: Record<string, string>;
+    /**
+     * Override the SSE transport's `fetch`. Defaults to `globalThis.fetch`.
+     * Lets a consumer supply a proxying agent or instrumented fetch without
+     * mutating the runtime global.
+     */
+    fetch?: typeof globalThis.fetch;
+    /**
+     * Override the WS transport's `WebSocket` constructor. Defaults to
+     * `globalThis.WebSocket`. Lets a consumer polyfill WS on a runtime that
+     * lacks it, or supply an instrumented implementation, without mutating
+     * the runtime global.
+     */
+    WebSocket?: typeof WebSocket;
 }
 /**
  * Subscribe to a typed subscription. Yields values produced by the server

package/dist/subscription/types.d.cts

@@ -1,5 +1,5 @@
 /**
- * @theokit/sdk — Subscription type contract (G8 v1.7.0).
+ * Subscription type contract (G8 v1.7.0) — `@theokit/sdk`.
  *
  * Per ADRs D423 (resume token opaque), D424 (transport selection),
  * D426 (defineSubscription DSL shape).
@@ -138,3 +138,21 @@ export interface SubscriptionDescriptor<TInput = unknown, TOutput = unknown> {
     /** Async handler that yields output frames (or tracked envelopes). */
     readonly handler: (input: TInput, ctx: SubscriptionCtx) => AsyncGenerator<TOutput | TrackedEnvelope<TOutput>, void, void>;
 }
+/**
+ * Minimal structural Zod type used to avoid hard peer-dep import.
+ * Mirrors the surface used by other SDK modules (e.g., `define-tool.ts`).
+ *
+ * Emitted rather than erased: it appears in the signature of `defineSubscription`, which
+ * `@theokit/sdk/subscription` publishes, so a consumer's type-aware lint has to be able to
+ * resolve it.
+ */
+export interface ZodLike<T> {
+    safeParse(value: unknown): {
+        success: true;
+        data: T;
+    } | {
+        success: false;
+        error: unknown;
+    };
+    parse(value: unknown): T;
+}

package/dist/subscription/types.d.ts

@@ -1,5 +1,5 @@
 /**
- * @theokit/sdk — Subscription type contract (G8 v1.7.0).
+ * Subscription type contract (G8 v1.7.0) — `@theokit/sdk`.
  *
  * Per ADRs D423 (resume token opaque), D424 (transport selection),
  * D426 (defineSubscription DSL shape).
@@ -138,3 +138,21 @@ export interface SubscriptionDescriptor<TInput = unknown, TOutput = unknown> {
     /** Async handler that yields output frames (or tracked envelopes). */
     readonly handler: (input: TInput, ctx: SubscriptionCtx) => AsyncGenerator<TOutput | TrackedEnvelope<TOutput>, void, void>;
 }
+/**
+ * Minimal structural Zod type used to avoid hard peer-dep import.
+ * Mirrors the surface used by other SDK modules (e.g., `define-tool.ts`).
+ *
+ * Emitted rather than erased: it appears in the signature of `defineSubscription`, which
+ * `@theokit/sdk/subscription` publishes, so a consumer's type-aware lint has to be able to
+ * resolve it.
+ */
+export interface ZodLike<T> {
+    safeParse(value: unknown): {
+        success: true;
+        data: T;
+    } | {
+        success: false;
+        error: unknown;
+    };
+    parse(value: unknown): T;
+}

package/dist/task-store.cjs

@@ -1,23 +1,24 @@
 'use strict';
 
-var chunkVGPXHHF3_cjs = require('./chunk-VGPXHHF3.cjs');
-require('./chunk-C4H6PB5J.cjs');
-require('./chunk-LPVIRJVF.cjs');
-require('./chunk-BM6N4KHO.cjs');
+var chunk2C72DXQF_cjs = require('./chunk-2C72DXQF.cjs');
+require('./chunk-I6TGFUCO.cjs');
+require('./chunk-K3FW2XZD.cjs');
+require('./chunk-JTB5Q42C.cjs');
+require('./chunk-NUKRL3I6.cjs');
 
 
 
 Object.defineProperty(exports, "InMemoryTaskStore", {
   enumerable: true,
-  get: function () { return chunkVGPXHHF3_cjs.InMemoryTaskStore; }
+  get: function () { return chunk2C72DXQF_cjs.InMemoryTaskStore; }
 });
 Object.defineProperty(exports, "JsonFileTaskStore", {
   enumerable: true,
-  get: function () { return chunkVGPXHHF3_cjs.JsonFileTaskStore; }
+  get: function () { return chunk2C72DXQF_cjs.JsonFileTaskStore; }
 });
 Object.defineProperty(exports, "getTaskStoreFor", {
   enumerable: true,
-  get: function () { return chunkVGPXHHF3_cjs.getTaskStoreFor; }
+  get: function () { return chunk2C72DXQF_cjs.getTaskStoreFor; }
 });
 //# sourceMappingURL=task-store.cjs.map
 //# sourceMappingURL=task-store.cjs.map

package/dist/task-store.js

@@ -1,6 +1,7 @@
-export { InMemoryTaskStore, JsonFileTaskStore, getTaskStoreFor } from './chunk-V26QVGUG.js';
-import './chunk-6AZDM6LK.js';
-import './chunk-U4UJHOSH.js';
-import './chunk-5F5NWKPN.js';
+export { InMemoryTaskStore, JsonFileTaskStore, getTaskStoreFor } from './chunk-RUDY2GTT.js';
+import './chunk-VF7EWVDG.js';
+import './chunk-IDCKSLYH.js';
+import './chunk-T7XEKOVW.js';
+import './chunk-T7O6K6PX.js';
 //# sourceMappingURL=task-store.js.map
 //# sourceMappingURL=task-store.js.map

package/dist/types/agent-prims.d.ts

@@ -37,6 +37,20 @@ export interface ModelSelection {
      * clamped — declaring 10M does not blow past the provider.
      */
     contextWindow?: number;
+    /**
+     * #332 — the endpoint THIS model should reach, for OpenAI-compatible and local servers.
+     *
+     * Without it the base URL came only from a process-wide env var (`OLLAMA_HOST`) or the provider
+     * profile's shipped default, so every `ollama/*` model in a process shared one host — an app
+     * could not run a small model on localhost and a large one on a GPU box.
+     *
+     * It outranks the env var deliberately: with the env var winning, whoever set it for one model
+     * would keep hijacking every other one, which is the same bug wearing a hat.
+     *
+     * Leaving it unset keeps the zero-config path exactly as it was — `ollama/qwen2.5:3b` still
+     * resolves to `http://localhost:11434` from the profile, with no key and no setup.
+     */
+    url?: string;
 }
 /**
  * SE12 — a read-only, text-only projection of one turn of the run's conversation,

package/dist/types/agent.d.ts

@@ -15,12 +15,48 @@ export type { InvalidateCacheOptions, PersonalityPreset, SDKAgent, SystemPromptS
  * @public
  */
 export type SettingSource = "project" | "user" | "team" | "mdm" | "plugins" | "all";
+/**
+ * A tool the SDK declares to the model on its own initiative — not one the consumer passed in
+ * {@link AgentOptions.tools}, and not one an MCP server exposed.
+ *
+ * These three names are also the ones the SDK reserves: a custom tool may not claim them. Listing
+ * one in {@link AgentOptions.withheldBuiltinTools} both stops it being declared and releases the
+ * name, because nothing of the SDK's is occupying it any more.
+ *
+ * Named for usetheokit/theokit-sdk#381, which is the report that the catalog had no opt-out.
+ *
+ * @public
+ */
+export type BuiltinToolName = "shell" | "memory_search" | "memory_get";
 /**
  * Local agent configuration.
  *
+ * TWO THINGS A LOCAL AGENT DOES BY DEFAULT, both reported as surprises (#338):
+ *
+ * 1. **A `shell` tool is always registered**, including when you pass `tools: []`. Every local
+ *    agent can therefore read any file reachable from {@link LocalOptions.cwd}. One report describes
+ *    an evaluation invalidated this way: the working directory held the benchmark's answer key, and
+ *    two transcripts show the model citing it. Deny it explicitly if that matters —
+ *    `{ tool: "shell", action: "deny" }` on a {@link PermissionEngine} rule is terminal under every
+ *    permission mode, including `bypass`. A deny rule still leaves the tool in the advertised
+ *    catalog, so the model may attempt it and be refused; to keep it out of the catalog entirely,
+ *    pass `withheldBuiltinTools: ["shell"]` on {@link AgentOptions} (usetheokit/theokit-sdk#381).
+ *
+ * 2. **Finished runs write a transcript to disk**, at `.theokit/memory/sessions/<runId>.md` under
+ *    the workspace `cwd`, with the full prompt and reply. This happens with no `memory` config and
+ *    with `settingSources: []` — it is what `memory_search({ corpus: "sessions" })` reads. Opt out
+ *    with `memory: { enabled: false }`, which suppresses the write entirely
+ *    (usetheokit/theokit-sdk#382). Leaving `memory`
+ *    unset still writes, so if the workspace is a git repository, add `.theokit/` to `.gitignore`:
+ *    one report describes a transcript reaching a public repo before it was noticed.
+ *
  * @public
  */
 export interface LocalOptions {
+    /**
+     * Workspace root(s). Also the reach of the always-present `shell` tool — see the note on
+     * {@link LocalOptions}, and the transcript written under `.theokit/memory/sessions/` here.
+     */
     cwd?: string | string[];
     settingSources?: SettingSource[];
     sandboxOptions?: {
@@ -282,8 +318,11 @@ export interface MemorySettings {
  * to add prompt/response/args events to the spans (consumer's
  * responsibility to sanitize PII).
  *
- * `@opentelemetry/api` is an OPTIONAL peer dependency. Without it
- * installed, telemetry is a no-op even when `enabled: true`.
+ * `@opentelemetry/api` is an OPTIONAL peer dependency — declared, so your package manager can
+ * tell you the version range, and not installed for you. Without it, telemetry is a NO-OP even
+ * when `enabled: true`: the tracer is loaded lazily inside a try/catch, so nothing throws and
+ * nothing is recorded. A run that reports no spans with `enabled: true` is almost always this,
+ * not a misconfigured collector.
  *
  * @public
  */
@@ -413,6 +452,32 @@ export interface AgentOptions {
      * See {@link CustomTool}.
      */
     tools?: CustomTool[];
+    /**
+     * Builtin tools this agent must NOT declare to the model. Absent or empty ⇒ every builtin the
+     * rest of the configuration would register is declared, exactly as before this option existed.
+     *
+     * WHY WITHHOLDING IS NOT THE SAME AS DENYING. A consumer that cannot allow `shell` — because it
+     * reaches outside their own sandbox scope — can already refuse the call in a `pre_tool_call` hook
+     * or with a {@link PermissionEngine} deny rule. That stops the execution and pays for the offer
+     * twice over: the schema rides in EVERY request of EVERY round (measured at 267 characters for
+     * `shell`, 1,462 for `memory_search` + `memory_get` together — usetheokit/theokit-sdk#381), and
+     * the model can spend a whole round discovering a refusal it had no way to anticipate. Declaring
+     * a tool that is guaranteed to be refused is the wrong shape; withholding removes it from the
+     * catalog, so the model is never offered what it cannot have.
+     *
+     * WITHHOLDING RELEASES THE NAME. `withheldBuiltinTools: ["shell"]` lets {@link AgentOptions.tools}
+     * declare a tool called `shell` without the `tool_reserved_name` error — the reservation exists to
+     * stop a collision with the SDK's own tool, and there is no longer one to collide with. Every
+     * builtin still declared stays reserved.
+     *
+     * This governs DECLARATION, not authorization. A withheld builtin is simply absent from the
+     * catalog: a model that invents the name anyway gets `Unknown tool <name>` (exit 127) rather than
+     * an execution, but nothing here evaluates a policy. Keep the deny rule if you need one that a
+     * per-send `tools` override cannot reopen.
+     *
+     * @public
+     */
+    withheldBuiltinTools?: readonly BuiltinToolName[];
     /**
      * SE37 — opt-in reasoning. When `true`, the agent gets a chain-of-thought
      * preamble prepended to its system prompt AND the `think` reasoning tool
@@ -688,6 +753,12 @@ export interface AgentDescription {
 /**
  * Options for `Agent.list()`.
  *
+ * `limit`/`cursor` paginate (B-115): a `limit` bounds the page and, when more agents remain,
+ * `ListResult.nextCursor` is set — pass it back as `cursor` for the next page. Omitting `limit`
+ * returns every matching agent in one page, unpaginated, exactly as before (M107 declared imposing
+ * pagination order unconditionally a breaking change to every caller's observed order; pagination
+ * here is opt-in and only reorders the page it returns, never the unlimited default).
+ *
  * @public
  */
 export type ListAgentsOptions = {
@@ -700,13 +771,19 @@ export type ListAgentsOptions = {
     cwd?: string;
 } | {
     runtime: "cloud";
-    prUrl?: string;
+    /**
+     * Hide archived agents unless `true`. Default `false` (hidden) — B-115, this used to be
+     * accepted and silently ignored; every archived agent was always included.
+     */
     includeArchived?: boolean;
     apiKey?: string;
 });
 /**
  * Options for `Agent.get()`.
  *
+ * `cwd` (default `process.cwd()`) selects which workspace's on-disk registry to hydrate before the
+ * lookup — same rule `Agent.list` uses (B-115; this used to be accepted and silently ignored).
+ *
  * @public
  */
 export interface GetAgentOptions {
@@ -716,18 +793,22 @@ export interface GetAgentOptions {
 /**
  * Options for `Agent.listRuns()`.
  *
+ * `cwd` (default `process.cwd()`) hydrates that workspace's registry before validating the agent
+ * exists — same rule as `Agent.get` (B-115). `limit`/`cursor` paginate the SAME way as
+ * `Agent.list` — see its doc — except no reordering is ever needed: a single agent's runs are
+ * already returned in the stable order they were created.
+ *
+ * B-115 — `runtime` removed 2026-08-19. A single `agentId` already pins exactly one runtime;
+ * filtering an already-single-agent's runs by runtime filtered nothing and was never checked.
+ *
  * @public
  */
-export type ListRunsOptions = {
-    limit?: number;
-    cursor?: string;
-} & ({
-    runtime?: "local";
+export interface ListRunsOptions {
     cwd?: string;
-} | {
-    runtime: "cloud";
     apiKey?: string;
-});
+    limit?: number;
+    cursor?: string;
+}
 /**
  * Options for `Agent.getRun()`. Cloud requires the parent `agentId`.
  *