@nemesis-oss/ollama-sdk 1.3.0 → 1.4.0

package/dist/generated-runtime.js

@@ -0,0 +1,143 @@
+// src/errors.ts
+var OllamaClientError = class extends Error {
+  code;
+  status;
+  retryable;
+  request;
+  response;
+  constructor(message, options) {
+    super(message, { cause: options.cause });
+    this.name = this.constructor.name;
+    this.code = options.code;
+    this.status = options.status;
+    this.retryable = options.retryable ?? false;
+    this.request = options.request;
+    this.response = options.response;
+  }
+};
+var OllamaGenericClientError = class extends OllamaClientError {
+  constructor(message, options) {
+    super(message, { ...options, code: "client_error" });
+  }
+};
+
+// src/streaming/ndjson.ts
+async function* parseNdjsonStream(stream) {
+  const reader = stream.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      buffer += decoder.decode(value, { stream: true });
+      const lines = buffer.split("\n");
+      buffer = lines.pop() ?? "";
+      for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed) continue;
+        try {
+          yield JSON.parse(trimmed);
+        } catch (err) {
+          throw new OllamaGenericClientError(`Failed to parse stream JSON chunk: ${trimmed}`, {
+            cause: err
+          });
+        }
+      }
+    }
+    if (buffer.trim()) {
+      yield JSON.parse(buffer.trim());
+    }
+  } finally {
+    try {
+      await reader.cancel();
+    } catch {
+    }
+    reader.releaseLock();
+  }
+}
+
+// src/generated/runtime/runtime.ts
+function compareVersions(a, b) {
+  const pa = a.split(".").map((s) => Number.parseInt(s, 10) ?? 0);
+  const pb = b.split(".").map((s) => Number.parseInt(s, 10) ?? 0);
+  for (let i = 0; i < Math.max(pa.length, pb.length); i += 1) {
+    const va = pa[i] ?? 0;
+    const vb = pb[i] ?? 0;
+    if (va !== vb) return va - vb;
+  }
+  return 0;
+}
+function assertOperationAllowed(operation, options) {
+  const localMode = options.localMode ?? true;
+  if (!localMode && !operation.environment.cloud) {
+    throw new OllamaGenericClientError(
+      `Operation ${operation.operationId} (${operation.method} ${operation.path}) is local-only and not supported in cloud mode.`
+    );
+  }
+  if (operation.constraints?.minOllamaVersion && options.serverVersion && compareVersions(options.serverVersion, operation.constraints.minOllamaVersion) < 0) {
+    throw new OllamaGenericClientError(
+      `Operation ${operation.operationId} (${operation.method} ${operation.path}) requires Ollama >= ${operation.constraints.minOllamaVersion} (server reports ${options.serverVersion}).`
+    );
+  }
+}
+function shouldStream(req) {
+  if (req.body && typeof req.body === "object" && "stream" in req.body) {
+    const explicit = req.body.stream;
+    if (typeof explicit === "boolean") return explicit;
+  }
+  return Boolean(req.streamingDefault ?? req.operation.transport.streamingDefault);
+}
+function buildBody(req) {
+  if (req.body === void 0) return void 0;
+  if (typeof req.body !== "object" || req.body === null) return req.body;
+  const body = req.body;
+  if (req.operation.transport.streaming && req.operation.transport.streamingDefault && body.stream === void 0) {
+    return { ...body, stream: true };
+  }
+  return body;
+}
+var OllamaRuntime = class {
+  constructor(options) {
+    this.options = options;
+  }
+  options;
+  /**
+   * Invoke an operation. Called by every generated API method.
+   *
+   * Returns a `Promise<T>` for non-streaming operations, or an
+   * `AsyncGenerator<T>` for streaming operations. The generated API
+   * class's overloads pick the right return type at compile time.
+   */
+  async invoke(req) {
+    assertOperationAllowed(req.operation, this.options);
+    const body = buildBody(req);
+    const streaming = shouldStream(req);
+    const httpReq = {
+      path: req.operation.path,
+      method: req.operation.method,
+      ...body !== void 0 ? { body } : {},
+      ...req.signal !== void 0 ? { signal: req.signal } : {},
+      // For streaming calls, request the raw Response so we can pipe it
+      // through parseNdjsonStream directly. This inherits middleware,
+      // retry, telemetry, and error-mapping from HttpClient — the
+      // previous Wave 3 implementation bypassed them with a direct
+      // `fetch()` call.
+      ...streaming ? { raw: true } : {}
+    };
+    if (!streaming) {
+      return await this.options.http.request(httpReq);
+    }
+    const response = await this.options.http.request(httpReq);
+    if (!response.body) {
+      throw new OllamaGenericClientError(
+        `Operation ${req.operation.operationId}: streaming response had no body.`
+      );
+    }
+    return parseNdjsonStream(response.body);
+  }
+};
+
+export { OllamaRuntime };
+//# sourceMappingURL=generated-runtime.js.map
+//# sourceMappingURL=generated-runtime.js.map

package/dist/generated-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/streaming/ndjson.ts","../src/generated/runtime/runtime.ts"],"names":[],"mappings":"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","file":"generated-runtime.js","sourcesContent":["/**\n * Structured, typed error hierarchy for OllamaClient.\n */\n\nexport interface OllamaErrorRequestContext {\n  readonly method?: string | undefined;\n  readonly url?: string | undefined;\n  readonly model?: string | undefined;\n}\n\nexport interface OllamaErrorResponseContext {\n  readonly status?: number | undefined;\n  readonly headers?: Record<string, string> | undefined;\n  readonly body?: unknown;\n}\n\nexport interface OllamaClientErrorOptions extends ErrorOptions {\n  readonly code: string;\n  readonly status?: number | undefined;\n  readonly retryable?: boolean | undefined;\n  readonly request?: OllamaErrorRequestContext | undefined;\n  readonly response?: OllamaErrorResponseContext | undefined;\n}\n\nexport class OllamaClientError extends Error {\n  readonly code: string;\n  readonly status?: number | undefined;\n  readonly retryable: boolean;\n  readonly request?: OllamaErrorRequestContext | undefined;\n  readonly response?: OllamaErrorResponseContext | undefined;\n\n  constructor(message: string, options: OllamaClientErrorOptions) {\n    super(message, { cause: options.cause });\n    this.name = this.constructor.name;\n    this.code = options.code;\n    this.status = options.status;\n    this.retryable = options.retryable ?? false;\n    this.request = options.request;\n    this.response = options.response;\n  }\n}\n\nexport class OllamaNetworkError extends OllamaClientError {\n  constructor(\n    message: string,\n    options?: Omit<OllamaClientErrorOptions, 'code' | 'retryable'> | undefined,\n  ) {\n    super(message, { ...options, code: 'network_error', retryable: true });\n  }\n}\n\nexport class OllamaTimeoutError extends OllamaClientError {\n  readonly timeoutMs?: number | undefined;\n  constructor(\n    message: string,\n    options?:\n      | (Omit<OllamaClientErrorOptions, 'code' | 'retryable'> & { timeoutMs?: number | undefined })\n      | undefined,\n  ) {\n    super(message, { ...options, code: 'timeout', retryable: true });\n    this.timeoutMs = options?.timeoutMs;\n  }\n}\n\nexport class OllamaAuthError extends OllamaClientError {\n  constructor(\n    message: string,\n    options?: Omit<OllamaClientErrorOptions, 'code' | 'retryable'> | undefined,\n  ) {\n    super(message, { ...options, code: 'auth_error', retryable: false });\n  }\n}\n\nexport class OllamaNotFoundError extends OllamaClientError {\n  constructor(\n    message: string,\n    options?: Omit<OllamaClientErrorOptions, 'code' | 'retryable'> | undefined,\n  ) {\n    super(message, { ...options, code: 'not_found', retryable: false });\n  }\n}\n\nexport class OllamaRateLimitError extends OllamaClientError {\n  readonly retryAfterMs?: number | undefined;\n  constructor(\n    message: string,\n    options?:\n      | (Omit<OllamaClientErrorOptions, 'code' | 'retryable'> & {\n          retryAfterMs?: number | undefined;\n        })\n      | undefined,\n  ) {\n    super(message, { ...options, code: 'rate_limited', retryable: true });\n    this.retryAfterMs = options?.retryAfterMs;\n  }\n}\n\n/**\n * Thrown client-side, before a network request is made, by `QuotaManager.assertCanProceed`\n * (see `src/quota.ts`) when issuing the request would exceed a configured usage budget for\n * one of its rolling windows. This is distinct from `OllamaRateLimitError`, which reflects\n * the server's own 429 response — Ollama Cloud does not expose account-level quota via the\n * API, so `QuotaManager` tracks usage against budgets the caller configures locally and\n * fails fast rather than waiting for the server to reject the request.\n */\nexport class OllamaQuotaExceededError extends OllamaClientError {\n  readonly windowId: string;\n  readonly resetAt: number;\n  constructor(\n    message: string,\n    options: Omit<OllamaClientErrorOptions, 'code' | 'retryable'> & {\n      windowId: string;\n      resetAt: number;\n    },\n  ) {\n    super(message, { ...options, code: 'quota_exceeded', retryable: false });\n    this.windowId = options.windowId;\n    this.resetAt = options.resetAt;\n  }\n}\n\nexport class OllamaServerError extends OllamaClientError {\n  constructor(\n    message: string,\n    options?: Omit<OllamaClientErrorOptions, 'code' | 'retryable'> | undefined,\n  ) {\n    super(message, { ...options, code: 'server_error', retryable: true });\n  }\n}\n\nexport class OllamaAbortError extends OllamaClientError {\n  constructor(\n    message: string,\n    options?: Omit<OllamaClientErrorOptions, 'code' | 'retryable'> | undefined,\n  ) {\n    super(message, { ...options, code: 'aborted', retryable: false });\n  }\n}\n\nexport class OllamaToolValidationError extends OllamaClientError {\n  readonly toolName: string;\n  readonly issues?: unknown;\n  constructor(\n    message: string,\n    options: Omit<OllamaClientErrorOptions, 'code'> & { toolName: string; issues?: unknown },\n  ) {\n    super(message, { ...options, code: 'tool_validation_error', retryable: false });\n    this.toolName = options.toolName;\n    this.issues = options.issues;\n  }\n}\n\nexport class OllamaToolTimeoutError extends OllamaClientError {\n  readonly toolName: string;\n  readonly timeoutMs: number;\n  constructor(\n    message: string,\n    options: Omit<OllamaClientErrorOptions, 'code' | 'retryable'> & {\n      toolName: string;\n      timeoutMs: number;\n    },\n  ) {\n    super(message, { ...options, code: 'tool_timeout', retryable: false });\n    this.toolName = options.toolName;\n    this.timeoutMs = options.timeoutMs;\n  }\n}\n\n/**\n * Thrown client-side, before a network request is made, when a request asks for a\n * capability an endpoint is known not to support (e.g. structured output `format` against\n * an Ollama Cloud endpoint — see `ModelCapabilities.supportsStructuredOutputRequest` in\n * `src/capabilities/capabilities.ts`). Its `code` is included in `DEFAULT_FAILOVER_CODES`\n * by default, so in a multi-endpoint setup it causes failover to the next candidate rather\n * than failing outright — it only surfaces to the caller if every candidate is rejected.\n */\nexport class OllamaUnsupportedCapabilityError extends OllamaClientError {\n  readonly capability: string;\n  constructor(\n    message: string,\n    options: Omit<OllamaClientErrorOptions, 'code' | 'retryable'> & { capability: string },\n  ) {\n    super(message, { ...options, code: 'unsupported_capability', retryable: false });\n    this.capability = options.capability;\n  }\n}\n\n/**\n * Thrown client-side, before any network call, when `config.endpoints` uses\n * `OllamaEndpoint.models` to scope endpoints/credentials to specific models and the\n * requested `model` isn't in any configured endpoint's allow-list. This is a routing\n * misconfiguration, not a connectivity problem — the SDK deliberately does not \"probe\"\n * unauthorized endpoints to find one that happens to work (that would burn quota on keys\n * that were never entitled to the model and produce non-deterministic startup behavior).\n */\nexport class OllamaModelRoutingError extends OllamaClientError {\n  readonly model: string;\n  readonly availableModels: readonly string[];\n  constructor(\n    message: string,\n    options: Omit<OllamaClientErrorOptions, 'code' | 'retryable'> & {\n      model: string;\n      availableModels: readonly string[];\n    },\n  ) {\n    super(message, { ...options, code: 'model_routing_error', retryable: false });\n    this.model = options.model;\n    this.availableModels = options.availableModels;\n  }\n}\n\n/**\n * Thrown before an agent tool loop starts when the selected model's /api/show metadata\n * does not advertise a capability required by the loop.\n */\nexport class OllamaIncompatibleModelError extends OllamaClientError {\n  readonly model: string;\n  readonly capability: string;\n  readonly reportedCapabilities: readonly string[];\n\n  constructor(\n    message: string,\n    options: Omit<OllamaClientErrorOptions, 'code' | 'retryable'> & {\n      model: string;\n      capability: string;\n      reportedCapabilities: readonly string[];\n    },\n  ) {\n    super(message, { ...options, code: 'incompatible_model', retryable: false });\n    this.model = options.model;\n    this.capability = options.capability;\n    this.reportedCapabilities = options.reportedCapabilities;\n  }\n}\nexport class OllamaAgentMaxToolCallsError extends OllamaClientError {\n  readonly maxToolCalls: number;\n  readonly toolCallsExecuted: number;\n\n  constructor(\n    message: string,\n    options: Omit<OllamaClientErrorOptions, 'code'> & {\n      maxToolCalls: number;\n      toolCallsExecuted: number;\n    },\n  ) {\n    super(message, { ...options, code: 'agent_max_tool_calls_exceeded', retryable: false });\n    this.maxToolCalls = options.maxToolCalls;\n    this.toolCallsExecuted = options.toolCallsExecuted;\n  }\n}\n\nexport class OllamaAgentMaxIterationsError extends OllamaClientError {\n  readonly maxIterations: number;\n  constructor(\n    message: string,\n    options: Omit<OllamaClientErrorOptions, 'code'> & { maxIterations: number },\n  ) {\n    super(message, { ...options, code: 'agent_max_iterations_exceeded', retryable: false });\n    this.maxIterations = options.maxIterations;\n  }\n}\n\nexport class OllamaMcpError extends OllamaClientError {\n  readonly mcpMethod: 'listTools' | 'callTool';\n  readonly toolName?: string | undefined;\n  constructor(\n    message: string,\n    options: Omit<OllamaClientErrorOptions, 'code'> & {\n      mcpMethod: 'listTools' | 'callTool';\n      toolName?: string | undefined;\n    },\n  ) {\n    super(message, { ...options, code: 'mcp_error', retryable: options.retryable ?? false });\n    this.mcpMethod = options.mcpMethod;\n    this.toolName = options.toolName;\n  }\n}\n\nexport class OllamaSkillNotFoundError extends OllamaClientError {\n  readonly skillName: string;\n  constructor(\n    message: string,\n    options: Omit<OllamaClientErrorOptions, 'code'> & { skillName: string },\n  ) {\n    super(message, { ...options, code: 'skill_not_found', retryable: false });\n    this.skillName = options.skillName;\n  }\n}\n\nexport class OllamaSkillInvalidError extends OllamaClientError {\n  readonly skillName: string;\n  readonly path?: string | undefined;\n  constructor(\n    message: string,\n    options: Omit<OllamaClientErrorOptions, 'code'> & {\n      skillName: string;\n      path?: string | undefined;\n    },\n  ) {\n    super(message, { ...options, code: 'skill_invalid', retryable: false });\n    this.skillName = options.skillName;\n    this.path = options.path;\n  }\n}\n\nexport class OllamaGenericClientError extends OllamaClientError {\n  constructor(message: string, options?: Omit<OllamaClientErrorOptions, 'code'> | undefined) {\n    super(message, { ...options, code: 'client_error' });\n  }\n}\n\nfunction isDomAbortError(error: unknown): error is DOMException {\n  return (\n    typeof DOMException !== 'undefined' &&\n    error instanceof DOMException &&\n    error.name === 'AbortError'\n  );\n}\n\nfunction statusToError(\n  status: number,\n  message: string,\n  options: Omit<OllamaClientErrorOptions, 'code' | 'status'>,\n): OllamaClientError {\n  if (status === 401 || status === 403) {\n    return new OllamaAuthError(message, { ...options, status });\n  }\n  if (status === 404) {\n    return new OllamaNotFoundError(message, { ...options, status });\n  }\n  if (status === 429) {\n    return new OllamaRateLimitError(message, { ...options, status });\n  }\n  if (status >= 500) {\n    return new OllamaServerError(message, { ...options, status });\n  }\n  return new OllamaGenericClientError(message, { ...options, status });\n}\n\n/**\n * Maps arbitrary thrown exceptions into structured OllamaClientError instances.\n */\nexport function mapError(\n  error: unknown,\n  context: {\n    request?: OllamaErrorRequestContext | undefined;\n    response?: OllamaErrorResponseContext | undefined;\n  } = {},\n): OllamaClientError {\n  if (error instanceof OllamaClientError) {\n    return error;\n  }\n  if (isDomAbortError(error)) {\n    return new OllamaAbortError(error.message || 'Request was aborted', {\n      cause: error,\n      request: context.request,\n    });\n  }\n  if (error instanceof TypeError) {\n    return new OllamaNetworkError(error.message || 'Network request failed', {\n      cause: error,\n      request: context.request,\n    });\n  }\n  if (context.response?.status !== undefined) {\n    const message = error instanceof Error ? error.message : String(error);\n    return statusToError(context.response.status, message, {\n      cause: error,\n      request: context.request,\n      response: context.response,\n    });\n  }\n  const message = error instanceof Error ? error.message : String(error);\n  return new OllamaGenericClientError(message, {\n    cause: error,\n    request: context.request,\n    response: context.response,\n  });\n}\n","/**\n * NDJSON (newline-delimited JSON) stream reader for native fetch Response bodies.\n */\n\nimport { OllamaGenericClientError } from '../errors.js';\n\n/**\n * Parses a byte stream from fetch body into an async generator of typed JSON chunks.\n */\nexport async function* parseNdjsonStream<T>(\n  stream: ReadableStream<Uint8Array>,\n): AsyncGenerator<T, void, undefined> {\n  const reader = stream.getReader();\n  const decoder = new TextDecoder();\n  let buffer = '';\n\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n      if (done) break;\n\n      buffer += decoder.decode(value, { stream: true });\n      const lines = buffer.split('\\n');\n      // Keep the last partial line in buffer\n      buffer = lines.pop() ?? '';\n\n      for (const line of lines) {\n        const trimmed = line.trim();\n        if (!trimmed) continue;\n        try {\n          yield JSON.parse(trimmed) as T;\n        } catch (err) {\n          throw new OllamaGenericClientError(`Failed to parse stream JSON chunk: ${trimmed}`, {\n            cause: err,\n          });\n        }\n      }\n    }\n\n    if (buffer.trim()) {\n      yield JSON.parse(buffer.trim()) as T;\n    }\n  } finally {\n    try {\n      await reader.cancel();\n    } catch {\n      // The stream may already be closed or errored.\n    }\n    reader.releaseLock();\n  }\n}\n","/**\n * OllamaRuntime — the runtime seam generated API classes delegate to.\n *\n * This is the only hand-written file in `src/generated/runtime/`. Every\n * generated method in `src/generated/api/*-api.ts` ends with:\n *\n * ```ts\n * return this.runtime.invoke({ operation: chatOp, body: request });\n * ```\n *\n * The runtime is responsible for:\n *   - Method/path resolution (from {@link OperationDefinition})\n *   - Streaming default application (when the request doesn't set `stream`)\n *   - Environment guard (rejecting cloud calls for local-only operations)\n *   - Version constraint guard (failing fast when the server is too old)\n *   - Delegating to the existing {@link HttpClient} for transport, retry,\n *     telemetry, NDJSON/SSE parsing\n *\n * It is intentionally a thin adapter — the existing transport, streaming,\n * middleware, and error-mapping layers are preserved verbatim. This file\n * only adds the contract-aware glue between generated API classes and the\n * existing HttpClient.\n */\nimport { HttpClient, type HttpRequestOptions } from '../../transport/http.js';\nimport { parseNdjsonStream } from '../../streaming/ndjson.js';\nimport { OllamaGenericClientError } from '../../errors.js';\nimport type { OperationDefinition, InvokeRequest } from './operation-definition.js';\n\n/** Constructor options for {@link OllamaRuntime}. */\nexport interface OllamaRuntimeOptions {\n  readonly http: HttpClient;\n  /**\n   * Whether this runtime is targeting a local Ollama instance. Defaults to\n   * `true`. When `false`, operations marked `environment.cloud === false`\n   * (i.e. local-only like `/v1/systemone`) are rejected at request time.\n   */\n  readonly localMode?: boolean;\n  /**\n   * Server version, if known (typically from a prior `/api/version` call).\n   * When set, operations with `constraints.minOllamaVersion` are checked\n   * against this value at request time.\n   */\n  readonly serverVersion?: string;\n}\n\nfunction compareVersions(a: string, b: string): number {\n  const pa = a.split('.').map((s) => Number.parseInt(s, 10) ?? 0);\n  const pb = b.split('.').map((s) => Number.parseInt(s, 10) ?? 0);\n  for (let i = 0; i < Math.max(pa.length, pb.length); i += 1) {\n    const va = pa[i] ?? 0;\n    const vb = pb[i] ?? 0;\n    if (va !== vb) return va - vb;\n  }\n  return 0;\n}\n\n/**\n * Apply environment + version guards before delegating to HttpClient.\n *\n * Throws {@link OllamaGenericClientError} when:\n *   - The operation is local-only and the runtime is in cloud mode.\n *   - The operation has `constraints.minOllamaVersion` and the server is older.\n */\nfunction assertOperationAllowed(\n  operation: OperationDefinition,\n  options: OllamaRuntimeOptions,\n): void {\n  const localMode = options.localMode ?? true;\n  if (!localMode && !operation.environment.cloud) {\n    throw new OllamaGenericClientError(\n      `Operation ${operation.operationId} (${operation.method} ${operation.path}) ` +\n        `is local-only and not supported in cloud mode.`,\n    );\n  }\n  if (\n    operation.constraints?.minOllamaVersion &&\n    options.serverVersion &&\n    compareVersions(options.serverVersion, operation.constraints.minOllamaVersion) < 0\n  ) {\n    throw new OllamaGenericClientError(\n      `Operation ${operation.operationId} (${operation.method} ${operation.path}) ` +\n        `requires Ollama >= ${operation.constraints.minOllamaVersion} ` +\n        `(server reports ${options.serverVersion}).`,\n    );\n  }\n}\n\n/**\n * Decide whether the request should stream. If the request body explicitly\n * sets `stream`, that wins. Otherwise the operation's `streamingDefault`\n * from the contract is used.\n */\nfunction shouldStream(req: InvokeRequest): boolean {\n  if (req.body && typeof req.body === 'object' && 'stream' in req.body) {\n    const explicit = (req.body as { stream?: unknown }).stream;\n    if (typeof explicit === 'boolean') return explicit;\n  }\n  return Boolean(req.streamingDefault ?? req.operation.transport.streamingDefault);\n}\n\n/**\n * Apply the streaming default to the request body if needed.\n *\n * If the operation streams by default and the body doesn't set `stream`,\n * add `stream: true`. The user can always override by setting `stream`\n * explicitly on the request.\n */\nfunction buildBody(req: InvokeRequest): unknown {\n  if (req.body === undefined) return undefined;\n  if (typeof req.body !== 'object' || req.body === null) return req.body;\n  const body = req.body as Record<string, unknown>;\n  if (\n    req.operation.transport.streaming &&\n    req.operation.transport.streamingDefault &&\n    body.stream === undefined\n  ) {\n    return { ...body, stream: true };\n  }\n  return body;\n}\n\n/** The runtime seam. */\nexport class OllamaRuntime {\n  constructor(private readonly options: OllamaRuntimeOptions) {}\n\n  /**\n   * Invoke an operation. Called by every generated API method.\n   *\n   * Returns a `Promise<T>` for non-streaming operations, or an\n   * `AsyncGenerator<T>` for streaming operations. The generated API\n   * class's overloads pick the right return type at compile time.\n   */\n  async invoke<T = unknown>(req: InvokeRequest): Promise<T> {\n    assertOperationAllowed(req.operation, this.options);\n    const body = buildBody(req);\n    const streaming = shouldStream(req);\n\n    // The HttpClient expects the narrow method union 'GET' | 'POST' |\n    // 'DELETE' | 'HEAD' | undefined — cast through `as` because our\n    // OperationDefinition.method is the wider HttpMethod type.\n    const httpReq: HttpRequestOptions = {\n      path: req.operation.path,\n      method: req.operation.method as 'GET' | 'POST' | 'DELETE' | 'HEAD',\n      ...(body !== undefined ? { body } : {}),\n      ...(req.signal !== undefined ? { signal: req.signal } : {}),\n      // For streaming calls, request the raw Response so we can pipe it\n      // through parseNdjsonStream directly. This inherits middleware,\n      // retry, telemetry, and error-mapping from HttpClient — the\n      // previous Wave 3 implementation bypassed them with a direct\n      // `fetch()` call.\n      ...(streaming ? { raw: true } : {}),\n    };\n\n    if (!streaming) {\n      return (await this.options.http.request<T>(httpReq)) as T;\n    }\n\n    // Streaming: HttpClient returns the raw Response (via the `raw: true`\n    // option) so we can read its body as an NDJSON stream.\n    const response = await this.options.http.request<Response>(httpReq);\n    if (!response.body) {\n      throw new OllamaGenericClientError(\n        `Operation ${req.operation.operationId}: streaming response had no body.`,\n      );\n    }\n    return parseNdjsonStream<T>(response.body) as unknown as T;\n  }\n}\n"]}