@bunny-agent/sdk 0.9.62 → 0.10.0-beta.1

package/README.md

@@ -333,7 +333,7 @@ const model = bunnyAgent("claude-sonnet-4-20250514");
 
 #### Daemon HTTP transport (same provider)
 
-**With any sandbox adapter** (E2B, Sandock, `LocalMachine`, etc.): pass **`sandbox` + `daemonUrl`**. The URL is resolved **inside** the sandbox (the `vikadata/bunny-agent` image starts `bunny-agent-daemon` on port 3080). The SDK streams via `streamCodingRunFromSandbox` (`curl -N` in the sandbox, including `LocalMachine`), not `fetch` from your server. It does **not** call `/healthz` for you — use `isBunnyAgentDaemonHealthy` from `@bunny-agent/sdk` when you want a probe before setting `daemonUrl` (e.g. to fall back to the CLI runner).
+**With any sandbox adapter** (E2B, Sandock, `LocalMachine`, etc.): pass **`sandbox` + `daemonUrl`**. The URL is resolved **inside** the sandbox (the `vikadata/bunny-agent` image starts `bunny-agent-daemon` on port 3080). The SDK streams via `streamCodingRunFromSandbox` (`curl -N` in the sandbox, including `LocalMachine`), not `fetch` from your server. It does not call `/healthz` unless you select Pi search contract `"auto"`, as described below. Use `isBunnyAgentDaemonHealthy` from `@bunny-agent/sdk` for an explicit readiness probe before setting `daemonUrl` (e.g. to fall back to the CLI runner).
 
 ```typescript
 import { createBunnyAgent, DEFAULT_BUNNY_AGENT_DAEMON_URL } from "@bunny-agent/sdk";
@@ -348,6 +348,35 @@ const bunnyAgent = createBunnyAgent({
 
 Omit `daemonUrl` to use the **CLI runner** in the same sandbox. `createBunnyAgent` always requires a `sandbox` adapter.
 
+#### Structured web search and answer citations
+
+For Pi daemon execution, select `searchContractVersion: "auto"` on the provider
+or an individual model. The SDK discovers the attached runtime's capabilities
+before starting the turn:
+
+```typescript
+const bunnyAgent = createBunnyAgent({
+  sandbox: mySandboxAdapter,
+  daemonUrl: DEFAULT_BUNNY_AGENT_DAEMON_URL,
+  runnerType: "pi",
+  searchContractVersion: "auto",
+});
+```
+
+- A capable daemon uses v1 structured search and answer annotations, with a
+  required stream acknowledgement. A healthy older daemon uses legacy search.
+- Discovery sends a read-only `/healthz` GET through the same sandbox transport.
+  The turn executes once; it is never replayed to negotiate support. Failed or
+  malformed discovery rejects before execution instead of silently downgrading.
+- Healthy results are cached for 30 seconds per attached handle, sandbox ID,
+  and daemon URL. An in-place runtime restart can take that long to be discovered.
+- Omitting the option preserves legacy behavior without discovery. Explicit `1`
+  preserves strict acknowledgement requirements without discovery. CLI execution
+  and other runners remain legacy when `"auto"` is selected.
+
+See the [search citation contract](../../docs/search-citation-contract.md) for
+the capability schema, AI SDK requirements, and citation metadata fields.
+
 ### Exports
 
 | Entry Point | Exports |

package/dist/chunk-WQI667GT.js

@@ -0,0 +1,106 @@
+// src/contracts.ts
+import {
+  codePointLength,
+  codePointOffsetToUtf16Index,
+  enforceSourceLimit,
+  isAnnotationRangeValidForText,
+  isCitationBinding,
+  isSafeHttpUrl,
+  isSupportedSearchContractVersion,
+  isUrlCitationAnnotation,
+  isValidCitationContractMetadata as isValidCitationContractMetadata2,
+  isValidCodePointRange,
+  isValidWebSearchCallRecord,
+  isWebSearchAction,
+  isWebSearchError,
+  isWebSearchResultItem,
+  isWebSearchSource,
+  projectOutputText as projectOutputText2,
+  SEARCH_CONTRACT_LIMITS,
+  SEARCH_CONTRACT_VERSION_1,
+  sliceByCodePointRange,
+  utf16IndexToCodePointOffset,
+  utf16RangeToCodePointRange
+} from "@bunny-agent/manager/contracts";
+
+// src/ui-message-projection.ts
+import {
+  isValidCitationContractMetadata,
+  projectOutputText
+} from "@bunny-agent/manager/contracts";
+function isSearchContractCapabilities(value) {
+  if (value === null || typeof value !== "object") return false;
+  const v = value;
+  return v.version === 1 && typeof v.structured_retrieval === "boolean" && typeof v.native_annotations === "boolean" && typeof v.explicit_source_marker_annotations === "boolean";
+}
+function record(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+}
+function projectUIMessageOutputText(message) {
+  return message.parts.flatMap((value) => {
+    const part = record(value);
+    if (part?.type !== "text" || typeof part.text !== "string") return [];
+    const bunny = record(record(part.providerMetadata)?.["bunny-agent"]);
+    const identity = typeof bunny?.textPartId === "string" && bunny.textPartId.length > 0 ? bunny.textPartId : void 0;
+    const contract = record(bunny?.citation_contract);
+    const acknowledgement = isSearchContractCapabilities(bunny?.searchContract) ? bunny.searchContract : void 0;
+    if (acknowledgement && bunny?.citation_contract !== void 0 && contract?.schema_version === void 0) {
+      throw new TypeError(
+        "Invalid durable Bunny citation contract v1 text part"
+      );
+    }
+    if (contract?.schema_version === 1) {
+      if (!identity || !acknowledgement || !isValidCitationContractMetadata(contract, { text: part.text })) {
+        throw new TypeError(
+          "Invalid durable Bunny citation contract v1 text part"
+        );
+      }
+      return [
+        {
+          textPartId: identity,
+          output_text: projectOutputText(part.text, contract.annotations),
+          bindings: contract.bindings.map((binding) => ({
+            ...binding,
+            tool_call_ids: [...binding.tool_call_ids]
+          })),
+          searchContract: { ...acknowledgement }
+        }
+      ];
+    }
+    return [
+      {
+        ...identity ? { textPartId: identity } : {},
+        output_text: projectOutputText(part.text, []),
+        bindings: [],
+        ...acknowledgement ? { searchContract: { ...acknowledgement } } : {}
+      }
+    ];
+  });
+}
+
+export {
+  isSearchContractCapabilities,
+  projectUIMessageOutputText,
+  codePointLength,
+  codePointOffsetToUtf16Index,
+  enforceSourceLimit,
+  isAnnotationRangeValidForText,
+  isCitationBinding,
+  isSafeHttpUrl,
+  isSupportedSearchContractVersion,
+  isUrlCitationAnnotation,
+  isValidCitationContractMetadata2 as isValidCitationContractMetadata,
+  isValidCodePointRange,
+  isValidWebSearchCallRecord,
+  isWebSearchAction,
+  isWebSearchError,
+  isWebSearchResultItem,
+  isWebSearchSource,
+  projectOutputText2 as projectOutputText,
+  SEARCH_CONTRACT_LIMITS,
+  SEARCH_CONTRACT_VERSION_1,
+  sliceByCodePointRange,
+  utf16IndexToCodePointOffset,
+  utf16RangeToCodePointRange
+};
+//# sourceMappingURL=chunk-WQI667GT.js.map

package/dist/chunk-WQI667GT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/contracts.ts","../src/ui-message-projection.ts"],"sourcesContent":["/**\n * Browser-safe re-export of the web search / answer citation contract\n * types and helpers from `@bunny-agent/manager/contracts`, published as\n * `@bunny-agent/sdk/contracts` for product (Buda Cloud/OpenBuda) consumers.\n *\n * This file intentionally re-exports only the browser-safe manager barrel —\n * never `@bunny-agent/manager/contracts/source-id`, which uses `node:crypto`\n * and must stay server-only.\n */\nexport type {\n  CitationBinding,\n  CitationContractMetadata,\n  CitationDiagnostic,\n  CitationOffsetUnit,\n  CitationOrigin,\n  CitationProcessingState,\n  CitationValidationContext,\n  OutputTextContent,\n  SearchContractCapabilities,\n  SearchContractLimits,\n  SearchContractVersion,\n  SourceDetails,\n  UrlCitationAnnotation,\n  WebSearchAction,\n  WebSearchCallRecord,\n  WebSearchCallStatus,\n  WebSearchError,\n  WebSearchErrorCode,\n  WebSearchResultItem,\n  WebSearchSource,\n} from \"@bunny-agent/manager/contracts\";\nexport {\n  codePointLength,\n  codePointOffsetToUtf16Index,\n  enforceSourceLimit,\n  isAnnotationRangeValidForText,\n  isCitationBinding,\n  isSafeHttpUrl,\n  isSupportedSearchContractVersion,\n  isUrlCitationAnnotation,\n  isValidCitationContractMetadata,\n  isValidCodePointRange,\n  isValidWebSearchCallRecord,\n  isWebSearchAction,\n  isWebSearchError,\n  isWebSearchResultItem,\n  isWebSearchSource,\n  projectOutputText,\n  SEARCH_CONTRACT_LIMITS,\n  SEARCH_CONTRACT_VERSION_1,\n  sliceByCodePointRange,\n  utf16IndexToCodePointOffset,\n  utf16RangeToCodePointRange,\n} from \"@bunny-agent/manager/contracts\";\nexport type { UIMessageOutputText } from \"./ui-message-projection\";\nexport {\n  isSearchContractCapabilities,\n  projectUIMessageOutputText,\n} from \"./ui-message-projection\";\n","import {\n  type CitationBinding,\n  isValidCitationContractMetadata,\n  type OutputTextContent,\n  projectOutputText,\n  type SearchContractCapabilities,\n} from \"@bunny-agent/manager/contracts\";\n\n/** A canonical text projection with associations kept outside flat annotations. */\nexport interface UIMessageOutputText {\n  textPartId?: string;\n  output_text: OutputTextContent;\n  bindings: CitationBinding[];\n  searchContract?: SearchContractCapabilities;\n}\n\n/** Validate a request's effective acknowledgement without inferring capabilities. */\nexport function isSearchContractCapabilities(\n  value: unknown,\n): value is SearchContractCapabilities {\n  if (value === null || typeof value !== \"object\") return false;\n  const v = value as Record<string, unknown>;\n  return (\n    v.version === 1 &&\n    typeof v.structured_retrieval === \"boolean\" &&\n    typeof v.native_annotations === \"boolean\" &&\n    typeof v.explicit_source_marker_annotations === \"boolean\"\n  );\n}\n\nfunction record(value: unknown): Record<string, unknown> | undefined {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : undefined;\n}\n\n/**\n * Project durable AI SDK UIMessage text parts in message order, without a\n * registry or Node dependencies. Identity lives in Bunny `textPartId` metadata.\n * Legacy/unknown-version parts yield plain text with empty annotations/bindings.\n * Recognized v1 citation metadata fails closed with TypeError if malformed,\n * out of bounds, missing durable identity, or lacking a valid acknowledgement.\n * Links, raw search snippets, and source cards never create annotations.\n */\nexport function projectUIMessageOutputText(message: {\n  parts: readonly unknown[];\n}): UIMessageOutputText[] {\n  return message.parts.flatMap((value): UIMessageOutputText[] => {\n    const part = record(value);\n    if (part?.type !== \"text\" || typeof part.text !== \"string\") return [];\n    const bunny = record(record(part.providerMetadata)?.[\"bunny-agent\"]);\n    const identity =\n      typeof bunny?.textPartId === \"string\" && bunny.textPartId.length > 0\n        ? bunny.textPartId\n        : undefined;\n    const contract = record(bunny?.citation_contract);\n    const acknowledgement = isSearchContractCapabilities(bunny?.searchContract)\n      ? bunny.searchContract\n      : undefined;\n    if (\n      acknowledgement &&\n      bunny?.citation_contract !== undefined &&\n      contract?.schema_version === undefined\n    ) {\n      throw new TypeError(\n        \"Invalid durable Bunny citation contract v1 text part\",\n      );\n    }\n    if (contract?.schema_version === 1) {\n      if (\n        !identity ||\n        !acknowledgement ||\n        !isValidCitationContractMetadata(contract, { text: part.text })\n      ) {\n        throw new TypeError(\n          \"Invalid durable Bunny citation contract v1 text part\",\n        );\n      }\n      return [\n        {\n          textPartId: identity,\n          output_text: projectOutputText(part.text, contract.annotations),\n          bindings: contract.bindings.map((binding) => ({\n            ...binding,\n            tool_call_ids: [...binding.tool_call_ids],\n          })),\n          searchContract: { ...acknowledgement },\n        },\n      ];\n    }\n    return [\n      {\n        ...(identity ? { textPartId: identity } : {}),\n        output_text: projectOutputText(part.text, []),\n        bindings: [],\n        ...(acknowledgement ? { searchContract: { ...acknowledgement } } : {}),\n      },\n    ];\n  });\n}\n"],"mappings":";AA+BA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,mCAAAA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,qBAAAC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;;;ACrDP;AAAA,EAEE;AAAA,EAEA;AAAA,OAEK;AAWA,SAAS,6BACd,OACqC;AACrC,MAAI,UAAU,QAAQ,OAAO,UAAU,SAAU,QAAO;AACxD,QAAM,IAAI;AACV,SACE,EAAE,YAAY,KACd,OAAO,EAAE,yBAAyB,aAClC,OAAO,EAAE,uBAAuB,aAChC,OAAO,EAAE,uCAAuC;AAEpD;AAEA,SAAS,OAAO,OAAqD;AACnE,SAAO,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK,IACrE,QACD;AACN;AAUO,SAAS,2BAA2B,SAEjB;AACxB,SAAO,QAAQ,MAAM,QAAQ,CAAC,UAAiC;AAC7D,UAAM,OAAO,OAAO,KAAK;AACzB,QAAI,MAAM,SAAS,UAAU,OAAO,KAAK,SAAS,SAAU,QAAO,CAAC;AACpE,UAAM,QAAQ,OAAO,OAAO,KAAK,gBAAgB,IAAI,aAAa,CAAC;AACnE,UAAM,WACJ,OAAO,OAAO,eAAe,YAAY,MAAM,WAAW,SAAS,IAC/D,MAAM,aACN;AACN,UAAM,WAAW,OAAO,OAAO,iBAAiB;AAChD,UAAM,kBAAkB,6BAA6B,OAAO,cAAc,IACtE,MAAM,iBACN;AACJ,QACE,mBACA,OAAO,sBAAsB,UAC7B,UAAU,mBAAmB,QAC7B;AACA,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AACA,QAAI,UAAU,mBAAmB,GAAG;AAClC,UACE,CAAC,YACD,CAAC,mBACD,CAAC,gCAAgC,UAAU,EAAE,MAAM,KAAK,KAAK,CAAC,GAC9D;AACA,cAAM,IAAI;AAAA,UACR;AAAA,QACF;AAAA,MACF;AACA,aAAO;AAAA,QACL;AAAA,UACE,YAAY;AAAA,UACZ,aAAa,kBAAkB,KAAK,MAAM,SAAS,WAAW;AAAA,UAC9D,UAAU,SAAS,SAAS,IAAI,CAAC,aAAa;AAAA,YAC5C,GAAG;AAAA,YACH,eAAe,CAAC,GAAG,QAAQ,aAAa;AAAA,UAC1C,EAAE;AAAA,UACF,gBAAgB,EAAE,GAAG,gBAAgB;AAAA,QACvC;AAAA,MACF;AAAA,IACF;AACA,WAAO;AAAA,MACL;AAAA,QACE,GAAI,WAAW,EAAE,YAAY,SAAS,IAAI,CAAC;AAAA,QAC3C,aAAa,kBAAkB,KAAK,MAAM,CAAC,CAAC;AAAA,QAC5C,UAAU,CAAC;AAAA,QACX,GAAI,kBAAkB,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,EAAE,IAAI,CAAC;AAAA,MACtE;AAAA,IACF;AAAA,EACF,CAAC;AACH;","names":["isValidCitationContractMetadata","projectOutputText"]}

package/dist/contracts.d.ts

@@ -0,0 +1,25 @@
+import { OutputTextContent, CitationBinding, SearchContractCapabilities } from '@bunny-agent/manager/contracts';
+export { CitationBinding, CitationContractMetadata, CitationDiagnostic, CitationOffsetUnit, CitationOrigin, CitationProcessingState, CitationValidationContext, OutputTextContent, SEARCH_CONTRACT_LIMITS, SEARCH_CONTRACT_VERSION_1, SearchContractCapabilities, SearchContractLimits, SearchContractVersion, SourceDetails, UrlCitationAnnotation, WebSearchAction, WebSearchCallRecord, WebSearchCallStatus, WebSearchError, WebSearchErrorCode, WebSearchResultItem, WebSearchSource, codePointLength, codePointOffsetToUtf16Index, enforceSourceLimit, isAnnotationRangeValidForText, isCitationBinding, isSafeHttpUrl, isSupportedSearchContractVersion, isUrlCitationAnnotation, isValidCitationContractMetadata, isValidCodePointRange, isValidWebSearchCallRecord, isWebSearchAction, isWebSearchError, isWebSearchResultItem, isWebSearchSource, projectOutputText, sliceByCodePointRange, utf16IndexToCodePointOffset, utf16RangeToCodePointRange } from '@bunny-agent/manager/contracts';
+
+/** A canonical text projection with associations kept outside flat annotations. */
+interface UIMessageOutputText {
+    textPartId?: string;
+    output_text: OutputTextContent;
+    bindings: CitationBinding[];
+    searchContract?: SearchContractCapabilities;
+}
+/** Validate a request's effective acknowledgement without inferring capabilities. */
+declare function isSearchContractCapabilities(value: unknown): value is SearchContractCapabilities;
+/**
+ * Project durable AI SDK UIMessage text parts in message order, without a
+ * registry or Node dependencies. Identity lives in Bunny `textPartId` metadata.
+ * Legacy/unknown-version parts yield plain text with empty annotations/bindings.
+ * Recognized v1 citation metadata fails closed with TypeError if malformed,
+ * out of bounds, missing durable identity, or lacking a valid acknowledgement.
+ * Links, raw search snippets, and source cards never create annotations.
+ */
+declare function projectUIMessageOutputText(message: {
+    parts: readonly unknown[];
+}): UIMessageOutputText[];
+
+export { type UIMessageOutputText, isSearchContractCapabilities, projectUIMessageOutputText };

package/dist/contracts.js

@@ -0,0 +1,51 @@
+import {
+  SEARCH_CONTRACT_LIMITS,
+  SEARCH_CONTRACT_VERSION_1,
+  codePointLength,
+  codePointOffsetToUtf16Index,
+  enforceSourceLimit,
+  isAnnotationRangeValidForText,
+  isCitationBinding,
+  isSafeHttpUrl,
+  isSearchContractCapabilities,
+  isSupportedSearchContractVersion,
+  isUrlCitationAnnotation,
+  isValidCitationContractMetadata,
+  isValidCodePointRange,
+  isValidWebSearchCallRecord,
+  isWebSearchAction,
+  isWebSearchError,
+  isWebSearchResultItem,
+  isWebSearchSource,
+  projectOutputText,
+  projectUIMessageOutputText,
+  sliceByCodePointRange,
+  utf16IndexToCodePointOffset,
+  utf16RangeToCodePointRange
+} from "./chunk-WQI667GT.js";
+export {
+  SEARCH_CONTRACT_LIMITS,
+  SEARCH_CONTRACT_VERSION_1,
+  codePointLength,
+  codePointOffsetToUtf16Index,
+  enforceSourceLimit,
+  isAnnotationRangeValidForText,
+  isCitationBinding,
+  isSafeHttpUrl,
+  isSearchContractCapabilities,
+  isSupportedSearchContractVersion,
+  isUrlCitationAnnotation,
+  isValidCitationContractMetadata,
+  isValidCodePointRange,
+  isValidWebSearchCallRecord,
+  isWebSearchAction,
+  isWebSearchError,
+  isWebSearchResultItem,
+  isWebSearchSource,
+  projectOutputText,
+  projectUIMessageOutputText,
+  sliceByCodePointRange,
+  utf16IndexToCodePointOffset,
+  utf16RangeToCodePointRange
+};
+//# sourceMappingURL=contracts.js.map

package/dist/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/index.d.ts

@@ -96,8 +96,8 @@ type BunnyAgentRunnerType = "claude" | "pi" | "codex" | "gemini" | "opencode";
 /**
  * AI Provider specific settings that extend BunnyAgentOptions.
  * Requires a `sandbox`. Optional `daemonUrl` streams via bunny-agent-daemon HTTP
- * (`POST /api/coding/run`) inside the sandbox. The SDK does **not** probe `/healthz`
- * on each request — call `isBunnyAgentDaemonHealthy` (re-exported from
+ * (`POST /api/coding/run`) inside the sandbox. Unless search contract `"auto"`
+ * is selected, the SDK does not probe `/healthz` — call `isBunnyAgentDaemonHealthy` (re-exported from
  * `@bunny-agent/sdk`) when you want to check readiness and omit `daemonUrl` to fall
  * back to the CLI runner, or set `daemonUrl` and handle HTTP errors yourself.
  */
@@ -107,7 +107,8 @@ interface BunnyAgentProviderSettings extends Omit<BunnyAgentOptions, "runner" |
     /**
      * bunny-agent-daemon base URL **inside** the sandbox (e.g. BunnyAgent image:
      * `http://127.0.0.1:3080`). When set, the SDK uses HTTP streaming only (no
-     * automatic health probe or CLI fallback).
+     * automatic health probe or CLI fallback, except read-only capability discovery
+     * when `searchContractVersion: "auto"` is selected).
      */
     daemonUrl?: string;
     /**
@@ -163,6 +164,26 @@ interface BunnyAgentProviderSettings extends Omit<BunnyAgentOptions, "runner" |
     mcpConfig?: McpConfig;
     /** Reasoning effort / thinking level (e.g. "low", "medium", "high"). */
     effort?: string;
+    /**
+     * Explicit opt-in to the versioned web search / answer citation contract
+     * (see `@bunny-agent/manager/contracts`, re-exported browser-safe as
+     * `@bunny-agent/sdk/contracts`). Absent means legacy text-only search
+     * behavior, unchanged; `1` requests the structured retrieval envelope and
+     * Responses-shaped answer annotations. V1 requires a stable AI SDK 6 peer
+     * at >=6.0.264 <7.0.0 to preserve tool-result metadata; older peers are
+     * rejected before execution. Request-scoped, never a
+     * process-global switch. The SDK rejects the call (surfaced as a stream
+     * error / rejected `generateText`/`streamText` result) if the runner/daemon
+     * never acknowledges support for the requested version rather than
+     * silently falling back to legacy behavior or retrying automatically.
+     * `"auto"` discovers a Pi daemon's capabilities before coding execution and
+     * selects v1 only when advertised. An older healthy daemon without that
+     * advertisement uses legacy behavior. Other runners and CLI-only transports
+     * stay legacy in auto mode. Discovery failures reject instead of executing or
+     * downgrading. Successful discovery is cached per handle/sandbox ID/URL for
+     * 30 seconds; an in-place daemon restart can take that long to be rediscovered.
+     */
+    searchContractVersion?: 1 | "auto";
     /**
      * Optional subset of `env` whose keys are safe to expose to the pi runner's
      * bash tool. When omitted, the runner classifies `env` via a built-in
@@ -205,11 +226,40 @@ declare class BunnyAgentLanguageModel implements LanguageModelV3 {
     private legacyTextPartCounter;
     private receivedFinish;
     private activeReasoningPartId;
+    private acknowledgedSearchContract;
+    /** Defense in depth: the runner already dedupes per emitted source, but a
+     * duplicate `source-url` event must never reach the UI as two source parts. */
+    private emittedSourceIds;
+    private readonly completedTextIds;
+    private readonly completedToolIds;
+    private readonly textById;
+    private readonly textMetadata;
+    private readonly toolMetadata;
+    private readonly pendingSources;
+    private readonly citedSources;
+    private messageMetadata;
+    private readonly seenMessageMetadata;
+    private readonly seenStreamErrors;
+    /** Merge every provider namespace while retaining negotiated request facts. */
+    private partMetadata;
+    private toolPartMetadata;
+    private emitCitedSource;
     private logUnparsedStreamLine;
     constructor(modelOptions: BunnyAgentLanguageModelOptions);
     doGenerate(options: LanguageModelV3CallOptions): Promise<LanguageModelV3GenerateResult>;
     doStream(options: LanguageModelV3CallOptions): Promise<LanguageModelV3StreamResult>;
-    private resetStreamState;
+    private doStreamInvocation;
+    /** The `searchContractVersion` explicitly requested for this turn, if any (never a process-global default). */
+    private get requestedSearchContractVersion();
+    /**
+     * When an explicit v1 selection was requested but the stream reached a
+     * normal finish without ever delivering a `searchContract` acknowledgement
+     * (e.g. an older daemon/CLI peer that silently ignores the field), surface
+     * a clear error instead of letting the caller believe v1 behavior is
+     * active. Never retried automatically — the caller decides whether to
+     * retry without the contract.
+     */
+    private buildMissingAcknowledgementErrorParts;
     /** Close the open reasoning part, if any (returns the end part to emit). */
     private closeReasoningPart;
     /** Synthesize a terminal error+finish pair for streams that end (EOF or `[DONE]`) without ever emitting a "finish" part, so the UI shows an error instead of silently stalling. */