@nemesis-oss/ollama-sdk 1.7.0 → 1.9.0

package/dist/{runtime-bQ48I-RC.d.cts → runtime-D2W9TfCJ.d.cts}

@@ -1,4 +1,4 @@
-import { r as Message, h as ChatResponse, i as GenerateResponse, q as ToolCall, b as ProgressResponse } from './types-5PAjLoCp.cjs';
+import { n as Message, m as ChatResponse, i as ToolCall, b as ProgressResponse, o as GenerateResponse } from './types-DVcX_zMp.cjs';
 import { z } from 'zod';
 
 /**
@@ -168,6 +168,73 @@ declare class OllamaQuotaExceededError extends OllamaClientError {
 declare class OllamaServerError extends OllamaClientError {
     constructor(message: string, options?: Omit<OllamaClientErrorOptions, 'code' | 'retryable'> | undefined);
 }
+/**
+ * Thrown when the Ollama server returns HTTP **503 Service Unavailable**,
+ * indicating that the request queue is saturated (`OLLAMA_MAX_QUEUE`
+ * exceeded, default 512 — see the FAQ).
+ *
+ * Semantically a specialization of {@link OllamaServerError} (503 is a
+ * kind of 5xx server error), but extends {@link OllamaClientError}
+ * directly to preserve the subclass-specific `code: 'overloaded'` —
+ * `OllamaServerError`'s constructor unconditionally forces
+ * `code: 'server_error'`. Callers wanting to catch any 5xx should
+ * use `error.status >= 500 && error.status < 600` OR explicitly
+ * list both `OllamaServerError` and `OllamaOverloadedError`/
+ * `OllamaBadGatewayError` in their `instanceof` checks.
+ *
+ * `retryable` is `true` because the queue will eventually drain;
+ * callers using {@link withRetry} will get automatic backoff.
+ */
+declare class OllamaOverloadedError extends OllamaClientError {
+    constructor(message: string, options?: Omit<OllamaClientErrorOptions, 'code' | 'retryable' | 'status'> | undefined);
+}
+/**
+ * Thrown when the Ollama server returns HTTP **502 Bad Gateway**,
+ * indicating that a cloud model could not be reached by the
+ * Ollama Cloud proxy. The model may be temporarily down, the
+ * cloud provider may be experiencing an outage, or the model
+ * may have been deprovisioned.
+ *
+ * Semantically a specialization of {@link OllamaServerError} (502 is a
+ * kind of 5xx server error), but extends {@link OllamaClientError}
+ * directly to preserve the subclass-specific `code: 'bad_gateway'` —
+ * see {@link OllamaOverloadedError} for the rationale. Callers wanting
+ * to catch any 5xx should use `error.status >= 500 && error.status < 600`
+ * OR explicitly list both classes in their `instanceof` checks.
+ *
+ * `retryable` is `true` for transient cloud-provider outages.
+ */
+declare class OllamaBadGatewayError extends OllamaClientError {
+    constructor(message: string, options?: Omit<OllamaClientErrorOptions, 'code' | 'retryable' | 'status'> | undefined);
+}
+/**
+ * Thrown when the Ollama server emits an in-band error frame inside
+ * an NDJSON stream (chat / generate / pull / push / create).
+ *
+ * Ollama streams start with HTTP 200 OK and chunked transfer encoding.
+ * If an error occurs mid-generation (GPU OOM, driver crash, context
+ * window overflow, model unload race, etc.), the server emits a final
+ * JSON chunk of the form `{"error": "..."}` and closes the stream.
+ * The HTTP status code never changes from 200, so HTTP-status-based
+ * error detection misses these errors entirely — they would silently
+ * bleed into the assistant's content stream as garbage tokens or
+ * undefined-field accesses.
+ *
+ * `partialContent` carries whatever was accumulated before the error
+ * frame, so callers can log/diagnose what the model produced before
+ * failing. For chat streams this is the concatenated `message.content`;
+ * for generate streams it's the concatenated `response`; for pull/push
+ * streams it's empty (progress events don't accumulate content).
+ *
+ * See: https://github.com/ollama/ollama/blob/main/docs/api.md
+ */
+declare class OllamaStreamError extends OllamaClientError {
+    /** Content accumulated before the in-band error frame, or '' if none. */
+    readonly partialContent: string;
+    constructor(message: string, options?: Omit<OllamaClientErrorOptions, 'code' | 'retryable'> & {
+        partialContent?: string | undefined;
+    });
+}
 declare class OllamaAbortError extends OllamaClientError {
     constructor(message: string, options?: Omit<OllamaClientErrorOptions, 'code' | 'retryable'> | undefined);
 }
@@ -195,6 +262,61 @@ declare class OllamaRequestValidationError extends OllamaClientError {
         issues: readonly z.ZodIssue[];
     });
 }
+/**
+ * Thrown by `OllamaRuntime.invoke` BEFORE any HTTP request is made when the
+ * serialized request body exceeds the operation's declared
+ * `constraints.maxRequestBytes`. The Ollama server returns 413 for such
+ * payloads; this client-side check fails fast so the round-trip is avoided.
+ *
+ * Wave 12 (P0 #5): the IR has carried `maxRequestBytes` for System One
+ * (64 KiB) since v1.7.0, but the runtime never enforced it. This closes
+ * that contract/runtime gap.
+ */
+declare class OllamaRequestTooLargeError extends OllamaClientError {
+    readonly operationId: string;
+    readonly actualBytes: number;
+    readonly maxBytes: number;
+    constructor(message: string, options: Omit<OllamaClientErrorOptions, 'code' | 'retryable' | 'status'> & {
+        operationId: string;
+        actualBytes: number;
+        maxBytes: number;
+    });
+}
+/**
+ * Thrown by `OllamaRuntime.invoke` AFTER the HTTP response is received
+ * when `validateResponses: true` is set and the response body fails Zod
+ * validation against the operation's registered response schema.
+ *
+ * Wave 13: the runtime previously never validated responses (see ADR
+ * 0020). This opt-in error gives callers a way to detect wire-format
+ * mismatches for operations where typed response semantics are critical
+ * (e.g. System One). The error carries the original Zod issues so
+ * callers can inspect which fields failed.
+ */
+declare class OllamaResponseValidationError extends OllamaClientError {
+    readonly operationId: string;
+    readonly issues: readonly z.ZodIssue[];
+    constructor(message: string, options: Omit<OllamaClientErrorOptions, 'code' | 'retryable'> & {
+        operationId: string;
+        issues: readonly z.ZodIssue[];
+    });
+}
+/**
+ * Thrown by `OllamaRuntime.invoke` BEFORE any HTTP request is made when the
+ * operation declares `constraints.minOllamaVersion` and the runtime could
+ * not obtain a server version to compare against (e.g. `enforceVersion:
+ * 'strict'` was set and `/api/version` was unreachable). Distinct from
+ * {@link OllamaGenericClientError} so callers can branch on the failure
+ * mode rather than parsing the message.
+ */
+declare class OllamaServerVersionUnknownError extends OllamaClientError {
+    readonly operationId: string;
+    readonly minRequiredVersion: string;
+    constructor(message: string, options: Omit<OllamaClientErrorOptions, 'code' | 'retryable'> & {
+        operationId: string;
+        minRequiredVersion: string;
+    });
+}
 declare class OllamaToolTimeoutError extends OllamaClientError {
     readonly toolName: string;
     readonly timeoutMs: number;
@@ -494,6 +616,21 @@ type CapabilitySupport = 'supported' | 'unsupported' | 'model-dependent' | 'vers
 interface SchemaRef {
     readonly $ref: string;
 }
+/**
+ * Wave 15 (P0): structural parameter on an operation. Mirrors
+ * {@link OperationParameter} from the canonical IR. Path parameters
+ * are substituted into the operation's path template at runtime;
+ * query and header parameters are attached to the HTTP request.
+ */
+interface OperationParameter {
+    readonly name: string;
+    readonly in: 'path' | 'query' | 'header';
+    readonly required: boolean;
+    readonly schema?: {
+        readonly type?: string;
+    };
+    readonly description?: string;
+}
 /** Behavioral contract a generated operation carries into the runtime. */
 interface OperationDefinition {
     readonly operationId: string;
@@ -505,6 +642,25 @@ interface OperationDefinition {
         readonly local: boolean;
         readonly cloud: boolean;
     };
+    /**
+     * Wave 12 (P1 #7): host this operation targets, when different from
+     * the runtime's default HttpClient base URL. Cloud-hosted capability
+     * endpoints (web search, web fetch) live at `https://ollama.com/api/...`
+     * rather than the local Ollama server. The runtime rejects operations
+     * with a non-default host when the runtime's HttpClient isn't
+     * configured for that host — callers must use OllamaClient.webSearch /
+     * OllamaClient.webFetch (which spin up a dedicated cloud HttpClient)
+     * for these operations.
+     */
+    readonly host?: string;
+    /**
+     * Wave 15 (P0): structural parameters derived from the path template
+     * and OpenAPI declarations. Path parameters are substituted into the
+     * URL at runtime; query and header parameters are attached to the
+     * HTTP request. The runtime uses this to URI-encode and substitute
+     * `{name}` segments in the path.
+     */
+    readonly parameters?: readonly OperationParameter[];
     readonly transport: {
         readonly mode: TransportMode;
         readonly streaming: boolean;
@@ -521,6 +677,8 @@ interface OperationDefinition {
     readonly constraints?: {
         readonly minOllamaVersion?: string;
         readonly maxRequestBytes?: number;
+        /** Wave 13: limit when body contains images (e.g. System One: 32 MiB). */
+        readonly maxRequestBytesWithImages?: number;
     };
     readonly status: {
         readonly documented: boolean;
@@ -544,6 +702,28 @@ interface InvokeRequest {
      * doesn't explicitly set `stream`.
      */
     readonly streamingDefault?: boolean;
+    /**
+     * Wave 15 (P0): path parameter values keyed by parameter name. The
+     * runtime substitutes these into the operation's path template
+     * (e.g. `{model}` → `gpt-4`) with URI encoding.
+     */
+    readonly pathParams?: Readonly<Record<string, string>>;
+    /**
+     * Wave 15 (P0): query parameter values keyed by parameter name.
+     * The runtime attaches these to the HTTP request URL.
+     */
+    readonly queryParams?: Readonly<Record<string, string>>;
+    /**
+     * Wave 15 (P0): header parameter values keyed by header name.
+     * The runtime attaches these to the HTTP request headers.
+     */
+    readonly headerParams?: Readonly<Record<string, string>>;
+    /**
+     * Wave 15 (P1): model name for routing. Extracted from the request
+     * body when possible; used by the failover layer to filter endpoints
+     * by `OllamaEndpoint.models` (credential-scoped routing).
+     */
+    readonly model?: string;
 }
 
 /**
@@ -570,9 +750,30 @@ interface InvokeRequest {
  * existing HttpClient.
  */
 
+/**
+ * Minimal HTTP client surface the runtime consumes. Either a full
+ * {@link HttpClient} or a {@link FailoverHttpClient} — the runtime only
+ * calls `request()`.
+ *
+ * Wave 14: widened from `HttpClient` to allow the failover-aware wrapper
+ * without breaking existing callers that pass a plain HttpClient.
+ */
+type RuntimeHttpBackend = Pick<HttpClient, 'baseUrl' | 'request'>;
 /** Constructor options for {@link OllamaRuntime}. */
 interface OllamaRuntimeOptions {
-    readonly http: HttpClient;
+    readonly http: RuntimeHttpBackend;
+    /**
+     * Wave 15 (P0): HTTP backend for operations that declare a non-default
+     * `host` (e.g. web search/fetch at `https://ollama.com`). When an
+     * operation has `host: 'https://ollama.com'` and `cloudHttp` is
+     * configured, the runtime routes the request through this backend
+     * instead of the default `http`. When `cloudHttp` is not configured
+     * and a host-bearing operation is invoked, the runtime throws.
+     *
+     * OllamaClient.runtime sets this to a dedicated cloud HttpClient
+     * pointed at `https://ollama.com` with the configured API key.
+     */
+    readonly cloudHttp?: RuntimeHttpBackend;
     /**
      * Whether this runtime is targeting a local Ollama instance. Defaults to
      * `true`. When `false`, operations marked `environment.cloud === false`
@@ -583,6 +784,10 @@ interface OllamaRuntimeOptions {
      * Server version, if known (typically from a prior `/api/version` call).
      * When set, operations with `constraints.minOllamaVersion` are checked
      * against this value at request time.
+     *
+     * Wave 12 (P0 #5): when unset, the runtime will lazily fetch and cache
+     * the server version the first time a version-gated operation is
+     * invoked. The fetch policy is controlled by {@link enforceVersion}.
      */
     readonly serverVersion?: string;
     /**
@@ -601,15 +806,75 @@ interface OllamaRuntimeOptions {
      *     `/v1/systemone`, OpenAI/Anthropic compat surfaces), validation is
      *     skipped silently.
      *
-     * Response validation is intentionally NOT enabled — see ADR 0020 for
-     * the rationale (forward-compat with wire-format extensions).
+     * Response validation is intentionally NOT enabled by default — see
+     * ADR 0020 for the rationale (forward-compat with wire-format
+     * extensions).
+     *
+     * Wave 13: an opt-in `validateResponses` option is now available for
+     * operations where typed response semantics are the entire point
+     * (e.g. System One). When enabled, the runtime validates the HTTP
+     * response body against the operation's registered response schema
+     * before returning it to the caller. On failure, throws
+     * {@link OllamaResponseValidationError}.
      */
     readonly validateRequests?: boolean;
+    /**
+     * Wave 13: when `true`, the runtime validates every response body
+     * against the operation's registered response schema before returning
+     * it. Defaults to `false` — opt-in. Only operations with a registered
+     * response schema are validated; others pass through unchanged.
+     *
+     * On validation failure, throws {@link OllamaResponseValidationError}
+     * with the Zod issues attached. The HTTP response is still consumed.
+     *
+     * Use this for operations where typed response semantics are critical
+     * (System One, structured output). Don't enable globally — legitimate
+     * forward-compat wire-format extensions would cause false rejections.
+     */
+    readonly validateResponses?: boolean;
+    /**
+     * Policy for enforcing `constraints.minOllamaVersion` when
+     * {@link serverVersion} is not explicitly supplied.
+     *
+     *   - `'auto'` (default): lazily fetch `/api/version` once and cache the
+     *     result; subsequent version-gated invocations reuse the cached
+     *     value. If the fetch fails, the operation is allowed through
+     *     (fail-open) — the server will reject it if it truly doesn't
+     *     support it.
+     *   - `'strict'`: same as `'auto'`, but if the version fetch fails the
+     *     invocation throws {@link OllamaServerVersionUnknownError} rather
+     *     than fail-open. Use this when the caller wants hard guarantees
+     *     that a version-gated operation will not be sent to a server that
+     *     can't handle it.
+     *   - `'off'`: never fetch `/api/version` automatically. The runtime
+     *     only enforces the version constraint when {@link serverVersion}
+     *     was explicitly supplied. Useful in tests that mock fetch and want
+     *     to avoid spurious version probes.
+     */
+    readonly enforceVersion?: 'auto' | 'strict' | 'off';
 }
 /** The runtime seam. */
 declare class OllamaRuntime {
     private readonly options;
+    /**
+     * Cached promise of the Ollama server version, populated lazily the first
+     * time a version-gated operation is invoked. `undefined` until then.
+     *
+     * Wave 12 (P0 #5): see {@link OllamaRuntimeOptions.enforceVersion}.
+     */
+    private serverVersionCache;
     constructor(options: OllamaRuntimeOptions);
+    /**
+     * Wave 15 (P0): resolve the HTTP backend for a given operation.
+     *
+     * Operations with a declared `host` (e.g. web search/fetch at
+     * https://ollama.com) must route to a HttpClient pointed at that host,
+     * not the default one. The runtime accepts an optional `cloudHttp`
+     * backend for this purpose — if the operation declares a host and no
+     * cloud backend is configured, the runtime throws rather than silently
+     * sending the request to the wrong server.
+     */
+    private resolveHttpBackend;
     /**
      * Invoke an operation. Called by every generated API method.
      *
@@ -618,6 +883,22 @@ declare class OllamaRuntime {
      * class's overloads pick the right return type at compile time.
      */
     invoke<T = unknown>(req: InvokeRequest): Promise<T>;
+    /**
+     * Apply environment + version guards before delegating to HttpClient.
+     *
+     * Throws {@link OllamaGenericClientError} when:
+     *   - The operation is local-only and the runtime is in cloud mode.
+     *   - The operation has `constraints.minOllamaVersion` and the server is older.
+     *
+     * Wave 12 (P0 #5): when `minOllamaVersion` is declared but the runtime's
+     * `serverVersion` is unknown AND `enforceVersion` is `'auto'` or
+     * `'strict'`, the runtime lazily fetches `/api/version` (cached on the
+     * runtime instance) so the constraint is actually enforced even when the
+     * caller didn't supply it. Previously the constraint was only enforced
+     * when `serverVersion` was manually supplied — meaning in practice it was
+     * almost never enforced.
+     */
+    private assertOperationAllowed;
 }
 
-export { OllamaServerError as $, type AbortableAsyncIterable as A, type BinaryBody as B, type ChatStreamResult as C, type DoneEvent as D, type ErrorEvent as E, type FetchLike as F, type GenerateStreamResult as G, HttpClient as H, type InvokeRequest as I, type OllamaErrorResponseContext as J, OllamaGenericClientError as K, type Logger as L, type Middleware as M, NANOS_PER_MS as N, OllamaRuntime as O, type ProgressStreamResult as P, OllamaIncompatibleModelError as Q, type RequestLifecycleHook as R, type SchemaRef as S, type TokenUsage as T, OllamaMcpError as U, OllamaModelRoutingError as V, OllamaNetworkError as W, OllamaNotFoundError as X, OllamaQuotaExceededError as Y, OllamaRateLimitError as Z, OllamaRequestValidationError as _, type OperationDefinition as a, OllamaSkillInvalidError as a0, OllamaSkillNotFoundError as a1, OllamaTimeoutError as a2, OllamaToolTimeoutError as a3, OllamaToolValidationError as a4, OllamaUnsupportedCapabilityError as a5, type RequestContext as a6, type RequestLifecycleEvent as a7, type ResponseContext as a8, type ThinkingEvent as a9, type TokenEvent as aa, type ToolCallEvent as ab, composeMiddleware as ac, createConsoleLogger as ad, extractUsage as ae, mapError as af, parseSseStream as ag, type OllamaRuntimeOptions as b, type OllamaStreamEvent as c, type OllamaStreamEventType as d, type SseEvent as e, OllamaClientError as f, type RawUsageSource as g, type HttpBody as h, type HttpClientOptions as i, type HttpRequestOptions as j, type LifecycleErrorEvent as k, type LifecycleRetryEvent as l, type LifecycleStartEvent as m, type LifecycleSuccessEvent as n, type LogFn as o, type MessageEvent as p, type MiddlewareContext as q, NANOS_PER_SECOND as r, NOOP_LOGGER as s, type NextFunction as t, OllamaAbortError as u, OllamaAgentMaxIterationsError as v, OllamaAgentMaxToolCallsError as w, OllamaAuthError as x, type OllamaClientErrorOptions as y, type OllamaErrorRequestContext as z };
+export { OllamaRequestTooLargeError as $, type AbortableAsyncIterable as A, type BinaryBody as B, type ChatStreamResult as C, type DoneEvent as D, type ErrorEvent as E, type FetchLike as F, type GenerateStreamResult as G, HttpClient as H, type InvokeRequest as I, type OllamaErrorResponseContext as J, OllamaGenericClientError as K, type Logger as L, type Middleware as M, NANOS_PER_MS as N, OllamaRuntime as O, type ProgressStreamResult as P, OllamaIncompatibleModelError as Q, type RequestLifecycleHook as R, type SchemaRef as S, type TokenUsage as T, OllamaMcpError as U, OllamaModelRoutingError as V, OllamaNetworkError as W, OllamaNotFoundError as X, OllamaOverloadedError as Y, OllamaQuotaExceededError as Z, OllamaRateLimitError as _, type OperationDefinition as a, OllamaRequestValidationError as a0, OllamaResponseValidationError as a1, OllamaServerError as a2, OllamaServerVersionUnknownError as a3, OllamaSkillInvalidError as a4, OllamaSkillNotFoundError as a5, OllamaStreamError as a6, OllamaTimeoutError as a7, OllamaToolTimeoutError as a8, OllamaToolValidationError as a9, OllamaUnsupportedCapabilityError as aa, type RequestContext as ab, type RequestLifecycleEvent as ac, type ResponseContext as ad, type SseEvent as ae, type ThinkingEvent as af, type TokenEvent as ag, type ToolCallEvent as ah, composeMiddleware as ai, createConsoleLogger as aj, extractUsage as ak, mapError as al, parseSseStream as am, type OllamaRuntimeOptions as b, type OllamaStreamEvent as c, type OllamaStreamEventType as d, type RawUsageSource as e, type HttpBody as f, type HttpClientOptions as g, type HttpRequestOptions as h, type LifecycleErrorEvent as i, type LifecycleRetryEvent as j, type LifecycleStartEvent as k, type LifecycleSuccessEvent as l, type LogFn as m, type MessageEvent as n, type MiddlewareContext as o, NANOS_PER_SECOND as p, NOOP_LOGGER as q, type NextFunction as r, OllamaAbortError as s, OllamaAgentMaxIterationsError as t, OllamaAgentMaxToolCallsError as u, OllamaAuthError as v, OllamaBadGatewayError as w, OllamaClientError as x, type OllamaClientErrorOptions as y, type OllamaErrorRequestContext as z };

package/dist/skills.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/skills/frontmatter.ts","../src/skills/compose.ts","../src/skills/skill-registry.ts"],"names":["readdir","join","readFile"],"mappings":"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","file":"skills.cjs","sourcesContent":["/**\n * Structured, typed error hierarchy for OllamaClient.\n */\n\nimport type { z } from 'zod';\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\n/**\n * Thrown by `OllamaRuntime.invoke` when `validateRequests: true` is set and\n * the request body fails Zod validation against the operation's registered\n * schema. See ADR 0020 (runtime Zod validation).\n *\n * The error carries the original Zod issues so callers can inspect which\n * fields failed. No HTTP request is made when this error is thrown.\n */\nexport class OllamaRequestValidationError extends OllamaClientError {\n  readonly operationId: string;\n  readonly issues: readonly z.ZodIssue[];\n  constructor(\n    message: string,\n    options: Omit<OllamaClientErrorOptions, 'code'> & {\n      operationId: string;\n      issues: readonly z.ZodIssue[];\n    },\n  ) {\n    super(message, { ...options, code: 'request_validation_error', retryable: false });\n    this.operationId = options.operationId;\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:\n    | 'listTools'\n    | 'callTool'\n    | 'tools/call'\n    | 'tasks/get'\n    | 'tasks/result'\n    | 'tasks/cancel';\n  readonly toolName?: string | undefined;\n  readonly issues?: unknown;\n  constructor(\n    message: string,\n    options: Omit<OllamaClientErrorOptions, 'code'> & {\n      mcpMethod:\n        | 'listTools'\n        | 'callTool'\n        | 'tools/call'\n        | 'tasks/get'\n        | 'tasks/result'\n        | 'tasks/cancel';\n      toolName?: string | undefined;\n      issues?: unknown;\n    },\n  ) {\n    super(message, { ...options, code: 'mcp_error', retryable: options.retryable ?? false });\n    this.mcpMethod = options.mcpMethod;\n    this.toolName = options.toolName;\n    this.issues = options.issues;\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 * Lightweight frontmatter parser for SKILL.md files.\n */\n\nimport { OllamaSkillInvalidError } from '../errors.js';\nimport type { SkillFrontmatter } from './types.js';\n\nexport interface ParsedFrontmatter {\n  readonly frontmatter: SkillFrontmatter;\n  readonly body: string;\n}\n\nfunction parseYamlValue(raw: string): unknown {\n  const trimmed = raw.trim();\n  if (trimmed === 'true') return true;\n  if (trimmed === 'false') return false;\n  if (!Number.isNaN(Number(trimmed)) && trimmed !== '') return Number(trimmed);\n  if (\n    (trimmed.startsWith('\"') && trimmed.endsWith('\"')) ||\n    (trimmed.startsWith(\"'\") && trimmed.endsWith(\"'\"))\n  ) {\n    return trimmed.slice(1, -1);\n  }\n  return trimmed;\n}\n\nfunction parseYamlBlock(yamlText: string): Record<string, unknown> {\n  const result: Record<string, unknown> = {};\n  const lines = yamlText.split('\\n');\n  let currentKey: string | undefined;\n  let currentList: unknown[] | undefined;\n\n  for (const line of lines) {\n    const trimmed = line.trim();\n    if (!trimmed || trimmed.startsWith('#')) continue;\n\n    if (trimmed.startsWith('- ') && currentKey) {\n      if (!currentList) {\n        currentList = [];\n        result[currentKey] = currentList;\n      }\n      currentList.push(parseYamlValue(trimmed.slice(2)));\n      continue;\n    }\n\n    currentList = undefined;\n    const colonIndex = line.indexOf(':');\n    if (colonIndex > 0) {\n      const key = line.slice(0, colonIndex).trim();\n      const valStr = line.slice(colonIndex + 1).trim();\n      currentKey = key;\n      if (valStr.length > 0) {\n        result[key] = parseYamlValue(valStr);\n      }\n    }\n  }\n\n  return result;\n}\n\nexport function parseFrontmatter(source: string, path = ''): ParsedFrontmatter {\n  const match = source.match(/^---\\r?\\n([\\s\\S]*?)\\r?\\n---\\r?\\n?([\\s\\S]*)$/);\n  if (!match) {\n    throw new OllamaSkillInvalidError('Missing YAML frontmatter delimiters (---)', {\n      skillName: path || 'unknown',\n      path,\n    });\n  }\n\n  const rawYaml = match[1] ?? '';\n  const body = match[2]?.trim() ?? '';\n  const parsed = parseYamlBlock(rawYaml);\n\n  if (!parsed['name'] || typeof parsed['name'] !== 'string') {\n    throw new OllamaSkillInvalidError('Frontmatter missing required string \"name\"', {\n      skillName: String(parsed['name'] ?? 'unknown'),\n      path,\n    });\n  }\n  if (!parsed['description'] || typeof parsed['description'] !== 'string') {\n    throw new OllamaSkillInvalidError('Frontmatter missing required string \"description\"', {\n      skillName: parsed['name'],\n      path,\n    });\n  }\n\n  return {\n    frontmatter: parsed as unknown as SkillFrontmatter,\n    body,\n  };\n}\n","/**\n * Skill composition and context injection.\n */\n\nimport type { Message } from '../types.js';\nimport type { ToolRegistry } from '../tools/registry.js';\nimport type { Skill } from './types.js';\n\nexport interface ApplySkillOptions {\n  readonly messages: readonly Message[];\n  readonly tools?: ToolRegistry;\n}\n\nexport interface AppliedSkillResult {\n  readonly messages: readonly Message[];\n  readonly tools?: ToolRegistry;\n}\n\n/**\n * Injects a skill's body into messages as a system prompt and applies allowed tool filters.\n */\nexport function applySkill(skill: Skill, options: ApplySkillOptions): AppliedSkillResult {\n  const systemPrompt = `[Skill: ${skill.name}]\\n${skill.description}\\n\\n${skill.body}`;\n  const messages = [...options.messages];\n  const systemIndex = messages.findIndex((m) => m.role === 'system');\n\n  if (systemIndex >= 0) {\n    const existing = messages[systemIndex];\n    if (existing) {\n      messages[systemIndex] = {\n        role: 'system',\n        content: `${existing.content}\\n\\n${systemPrompt}`,\n      };\n    }\n  } else {\n    messages.unshift({ role: 'system', content: systemPrompt });\n  }\n\n  return {\n    messages,\n    ...(options.tools !== undefined ? { tools: options.tools } : {}),\n  };\n}\n","/**\n * Node.js filesystem skill registry for SKILL.md packages.\n */\n\nimport { readdir, readFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { OllamaSkillNotFoundError } from '../errors.js';\nimport { parseFrontmatter } from './frontmatter.js';\nimport type { Skill, SkillSummary } from './types.js';\n\nexport interface SkillRegistryOptions {\n  readonly directory: string;\n}\n\nexport class SkillRegistry {\n  readonly directory: string;\n\n  constructor(options: SkillRegistryOptions) {\n    this.directory = options.directory;\n  }\n\n  async list(): Promise<SkillSummary[]> {\n    const entries = await readdir(this.directory, { withFileTypes: true });\n    const summaries: SkillSummary[] = [];\n\n    for (const entry of entries) {\n      if (!entry.isDirectory()) continue;\n      const skillPath = join(this.directory, entry.name, 'SKILL.md');\n      try {\n        const content = await readFile(skillPath, 'utf-8');\n        const parsed = parseFrontmatter(content, skillPath);\n        summaries.push({\n          name: parsed.frontmatter.name,\n          description: parsed.frontmatter.description,\n          path: skillPath,\n        });\n      } catch {\n        // Skip directories without valid SKILL.md\n      }\n    }\n\n    return summaries;\n  }\n\n  async load(name: string): Promise<Skill> {\n    const skillPath = join(this.directory, name, 'SKILL.md');\n    try {\n      const content = await readFile(skillPath, 'utf-8');\n      const parsed = parseFrontmatter(content, skillPath);\n      return {\n        name: parsed.frontmatter.name,\n        description: parsed.frontmatter.description,\n        path: skillPath,\n        frontmatter: parsed.frontmatter,\n        body: parsed.body,\n        allowedTools: parsed.frontmatter['allowed-tools'],\n      };\n    } catch (err) {\n      throw new OllamaSkillNotFoundError(`Skill \"${name}\" not found at ${skillPath}`, {\n        skillName: name,\n        cause: err,\n      });\n    }\n  }\n}\n"]}
+{"version":3,"sources":["../src/errors.ts","../src/skills/frontmatter.ts","../src/skills/compose.ts","../src/skills/skill-registry.ts"],"names":["readdir","join","readFile"],"mappings":"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","file":"skills.cjs","sourcesContent":["/**\n * Structured, typed error hierarchy for OllamaClient.\n */\n\nimport type { z } from 'zod';\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\n/**\n * Thrown when the Ollama server returns HTTP **503 Service Unavailable**,\n * indicating that the request queue is saturated (`OLLAMA_MAX_QUEUE`\n * exceeded, default 512 — see the FAQ).\n *\n * Semantically a specialization of {@link OllamaServerError} (503 is a\n * kind of 5xx server error), but extends {@link OllamaClientError}\n * directly to preserve the subclass-specific `code: 'overloaded'` —\n * `OllamaServerError`'s constructor unconditionally forces\n * `code: 'server_error'`. Callers wanting to catch any 5xx should\n * use `error.status >= 500 && error.status < 600` OR explicitly\n * list both `OllamaServerError` and `OllamaOverloadedError`/\n * `OllamaBadGatewayError` in their `instanceof` checks.\n *\n * `retryable` is `true` because the queue will eventually drain;\n * callers using {@link withRetry} will get automatic backoff.\n */\nexport class OllamaOverloadedError extends OllamaClientError {\n  constructor(\n    message: string,\n    options?: Omit<OllamaClientErrorOptions, 'code' | 'retryable' | 'status'> | undefined,\n  ) {\n    super(message, { ...options, code: 'overloaded', status: 503, retryable: true });\n  }\n}\n\n/**\n * Thrown when the Ollama server returns HTTP **502 Bad Gateway**,\n * indicating that a cloud model could not be reached by the\n * Ollama Cloud proxy. The model may be temporarily down, the\n * cloud provider may be experiencing an outage, or the model\n * may have been deprovisioned.\n *\n * Semantically a specialization of {@link OllamaServerError} (502 is a\n * kind of 5xx server error), but extends {@link OllamaClientError}\n * directly to preserve the subclass-specific `code: 'bad_gateway'` —\n * see {@link OllamaOverloadedError} for the rationale. Callers wanting\n * to catch any 5xx should use `error.status >= 500 && error.status < 600`\n * OR explicitly list both classes in their `instanceof` checks.\n *\n * `retryable` is `true` for transient cloud-provider outages.\n */\nexport class OllamaBadGatewayError extends OllamaClientError {\n  constructor(\n    message: string,\n    options?: Omit<OllamaClientErrorOptions, 'code' | 'retryable' | 'status'> | undefined,\n  ) {\n    super(message, { ...options, code: 'bad_gateway', status: 502, retryable: true });\n  }\n}\n\n/**\n * Thrown when the Ollama server emits an in-band error frame inside\n * an NDJSON stream (chat / generate / pull / push / create).\n *\n * Ollama streams start with HTTP 200 OK and chunked transfer encoding.\n * If an error occurs mid-generation (GPU OOM, driver crash, context\n * window overflow, model unload race, etc.), the server emits a final\n * JSON chunk of the form `{\"error\": \"...\"}` and closes the stream.\n * The HTTP status code never changes from 200, so HTTP-status-based\n * error detection misses these errors entirely — they would silently\n * bleed into the assistant's content stream as garbage tokens or\n * undefined-field accesses.\n *\n * `partialContent` carries whatever was accumulated before the error\n * frame, so callers can log/diagnose what the model produced before\n * failing. For chat streams this is the concatenated `message.content`;\n * for generate streams it's the concatenated `response`; for pull/push\n * streams it's empty (progress events don't accumulate content).\n *\n * See: https://github.com/ollama/ollama/blob/main/docs/api.md\n */\nexport class OllamaStreamError extends OllamaClientError {\n  /** Content accumulated before the in-band error frame, or '' if none. */\n  readonly partialContent: string;\n  constructor(\n    message: string,\n    options?: Omit<OllamaClientErrorOptions, 'code' | 'retryable'> & {\n      partialContent?: string | undefined;\n    },\n  ) {\n    super(message, { ...options, code: 'stream_error', retryable: false });\n    this.partialContent = options?.partialContent ?? '';\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\n/**\n * Thrown by `OllamaRuntime.invoke` when `validateRequests: true` is set and\n * the request body fails Zod validation against the operation's registered\n * schema. See ADR 0020 (runtime Zod validation).\n *\n * The error carries the original Zod issues so callers can inspect which\n * fields failed. No HTTP request is made when this error is thrown.\n */\nexport class OllamaRequestValidationError extends OllamaClientError {\n  readonly operationId: string;\n  readonly issues: readonly z.ZodIssue[];\n  constructor(\n    message: string,\n    options: Omit<OllamaClientErrorOptions, 'code'> & {\n      operationId: string;\n      issues: readonly z.ZodIssue[];\n    },\n  ) {\n    super(message, { ...options, code: 'request_validation_error', retryable: false });\n    this.operationId = options.operationId;\n    this.issues = options.issues;\n  }\n}\n\n/**\n * Thrown by `OllamaRuntime.invoke` BEFORE any HTTP request is made when the\n * serialized request body exceeds the operation's declared\n * `constraints.maxRequestBytes`. The Ollama server returns 413 for such\n * payloads; this client-side check fails fast so the round-trip is avoided.\n *\n * Wave 12 (P0 #5): the IR has carried `maxRequestBytes` for System One\n * (64 KiB) since v1.7.0, but the runtime never enforced it. This closes\n * that contract/runtime gap.\n */\nexport class OllamaRequestTooLargeError extends OllamaClientError {\n  readonly operationId: string;\n  readonly actualBytes: number;\n  readonly maxBytes: number;\n  constructor(\n    message: string,\n    options: Omit<OllamaClientErrorOptions, 'code' | 'retryable' | 'status'> & {\n      operationId: string;\n      actualBytes: number;\n      maxBytes: number;\n    },\n  ) {\n    super(message, { ...options, code: 'request_too_large', retryable: false, status: 413 });\n    this.operationId = options.operationId;\n    this.actualBytes = options.actualBytes;\n    this.maxBytes = options.maxBytes;\n  }\n}\n\n/**\n * Thrown by `OllamaRuntime.invoke` AFTER the HTTP response is received\n * when `validateResponses: true` is set and the response body fails Zod\n * validation against the operation's registered response schema.\n *\n * Wave 13: the runtime previously never validated responses (see ADR\n * 0020). This opt-in error gives callers a way to detect wire-format\n * mismatches for operations where typed response semantics are critical\n * (e.g. System One). The error carries the original Zod issues so\n * callers can inspect which fields failed.\n */\nexport class OllamaResponseValidationError extends OllamaClientError {\n  readonly operationId: string;\n  readonly issues: readonly z.ZodIssue[];\n  constructor(\n    message: string,\n    options: Omit<OllamaClientErrorOptions, 'code' | 'retryable'> & {\n      operationId: string;\n      issues: readonly z.ZodIssue[];\n    },\n  ) {\n    super(message, { ...options, code: 'response_validation_error', retryable: false });\n    this.operationId = options.operationId;\n    this.issues = options.issues;\n  }\n}\n\n/**\n * Thrown by `OllamaRuntime.invoke` BEFORE any HTTP request is made when the\n * operation declares `constraints.minOllamaVersion` and the runtime could\n * not obtain a server version to compare against (e.g. `enforceVersion:\n * 'strict'` was set and `/api/version` was unreachable). Distinct from\n * {@link OllamaGenericClientError} so callers can branch on the failure\n * mode rather than parsing the message.\n */\nexport class OllamaServerVersionUnknownError extends OllamaClientError {\n  readonly operationId: string;\n  readonly minRequiredVersion: string;\n  constructor(\n    message: string,\n    options: Omit<OllamaClientErrorOptions, 'code' | 'retryable'> & {\n      operationId: string;\n      minRequiredVersion: string;\n    },\n  ) {\n    super(message, { ...options, code: 'server_version_unknown', retryable: false });\n    this.operationId = options.operationId;\n    this.minRequiredVersion = options.minRequiredVersion;\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:\n    | 'listTools'\n    | 'callTool'\n    | 'tools/call'\n    | 'tasks/get'\n    | 'tasks/result'\n    | 'tasks/cancel';\n  readonly toolName?: string | undefined;\n  readonly issues?: unknown;\n  constructor(\n    message: string,\n    options: Omit<OllamaClientErrorOptions, 'code'> & {\n      mcpMethod:\n        | 'listTools'\n        | 'callTool'\n        | 'tools/call'\n        | 'tasks/get'\n        | 'tasks/result'\n        | 'tasks/cancel';\n      toolName?: string | undefined;\n      issues?: unknown;\n    },\n  ) {\n    super(message, { ...options, code: 'mcp_error', retryable: options.retryable ?? false });\n    this.mcpMethod = options.mcpMethod;\n    this.toolName = options.toolName;\n    this.issues = options.issues;\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 === 502) {\n    // Cloud model could not be reached. Distinct from generic 5xx so\n    // callers running multi-model agents can branch on cloud-provider\n    // failures specifically (fail over to a different model/endpoint\n    // rather than blindly retrying the same one).\n    return new OllamaBadGatewayError(message, { ...options });\n  }\n  if (status === 503) {\n    // Queue saturation (OLLAMA_MAX_QUEUE exceeded). Retryable — the\n    // queue will eventually drain. Distinct from generic 5xx so\n    // callers running parallel swarms can branch on saturation.\n    return new OllamaOverloadedError(message, { ...options });\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 * Lightweight frontmatter parser for SKILL.md files.\n */\n\nimport { OllamaSkillInvalidError } from '../errors.js';\nimport type { SkillFrontmatter } from './types.js';\n\nexport interface ParsedFrontmatter {\n  readonly frontmatter: SkillFrontmatter;\n  readonly body: string;\n}\n\nfunction parseYamlValue(raw: string): unknown {\n  const trimmed = raw.trim();\n  if (trimmed === 'true') return true;\n  if (trimmed === 'false') return false;\n  if (!Number.isNaN(Number(trimmed)) && trimmed !== '') return Number(trimmed);\n  if (\n    (trimmed.startsWith('\"') && trimmed.endsWith('\"')) ||\n    (trimmed.startsWith(\"'\") && trimmed.endsWith(\"'\"))\n  ) {\n    return trimmed.slice(1, -1);\n  }\n  return trimmed;\n}\n\nfunction parseYamlBlock(yamlText: string): Record<string, unknown> {\n  const result: Record<string, unknown> = {};\n  const lines = yamlText.split('\\n');\n  let currentKey: string | undefined;\n  let currentList: unknown[] | undefined;\n\n  for (const line of lines) {\n    const trimmed = line.trim();\n    if (!trimmed || trimmed.startsWith('#')) continue;\n\n    if (trimmed.startsWith('- ') && currentKey) {\n      if (!currentList) {\n        currentList = [];\n        result[currentKey] = currentList;\n      }\n      currentList.push(parseYamlValue(trimmed.slice(2)));\n      continue;\n    }\n\n    currentList = undefined;\n    const colonIndex = line.indexOf(':');\n    if (colonIndex > 0) {\n      const key = line.slice(0, colonIndex).trim();\n      const valStr = line.slice(colonIndex + 1).trim();\n      currentKey = key;\n      if (valStr.length > 0) {\n        result[key] = parseYamlValue(valStr);\n      }\n    }\n  }\n\n  return result;\n}\n\nexport function parseFrontmatter(source: string, path = ''): ParsedFrontmatter {\n  const match = source.match(/^---\\r?\\n([\\s\\S]*?)\\r?\\n---\\r?\\n?([\\s\\S]*)$/);\n  if (!match) {\n    throw new OllamaSkillInvalidError('Missing YAML frontmatter delimiters (---)', {\n      skillName: path || 'unknown',\n      path,\n    });\n  }\n\n  const rawYaml = match[1] ?? '';\n  const body = match[2]?.trim() ?? '';\n  const parsed = parseYamlBlock(rawYaml);\n\n  if (!parsed['name'] || typeof parsed['name'] !== 'string') {\n    throw new OllamaSkillInvalidError('Frontmatter missing required string \"name\"', {\n      skillName: String(parsed['name'] ?? 'unknown'),\n      path,\n    });\n  }\n  if (!parsed['description'] || typeof parsed['description'] !== 'string') {\n    throw new OllamaSkillInvalidError('Frontmatter missing required string \"description\"', {\n      skillName: parsed['name'],\n      path,\n    });\n  }\n\n  return {\n    frontmatter: parsed as unknown as SkillFrontmatter,\n    body,\n  };\n}\n","/**\n * Skill composition and context injection.\n */\n\nimport type { Message } from '../types.js';\nimport type { ToolRegistry } from '../tools/registry.js';\nimport type { Skill } from './types.js';\n\nexport interface ApplySkillOptions {\n  readonly messages: readonly Message[];\n  readonly tools?: ToolRegistry;\n}\n\nexport interface AppliedSkillResult {\n  readonly messages: readonly Message[];\n  readonly tools?: ToolRegistry;\n}\n\n/**\n * Injects a skill's body into messages as a system prompt and applies allowed tool filters.\n */\nexport function applySkill(skill: Skill, options: ApplySkillOptions): AppliedSkillResult {\n  const systemPrompt = `[Skill: ${skill.name}]\\n${skill.description}\\n\\n${skill.body}`;\n  const messages = [...options.messages];\n  const systemIndex = messages.findIndex((m) => m.role === 'system');\n\n  if (systemIndex >= 0) {\n    const existing = messages[systemIndex];\n    if (existing) {\n      messages[systemIndex] = {\n        role: 'system',\n        content: `${existing.content}\\n\\n${systemPrompt}`,\n      };\n    }\n  } else {\n    messages.unshift({ role: 'system', content: systemPrompt });\n  }\n\n  return {\n    messages,\n    ...(options.tools !== undefined ? { tools: options.tools } : {}),\n  };\n}\n","/**\n * Node.js filesystem skill registry for SKILL.md packages.\n */\n\nimport { readdir, readFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { OllamaSkillNotFoundError } from '../errors.js';\nimport { parseFrontmatter } from './frontmatter.js';\nimport type { Skill, SkillSummary } from './types.js';\n\nexport interface SkillRegistryOptions {\n  readonly directory: string;\n}\n\nexport class SkillRegistry {\n  readonly directory: string;\n\n  constructor(options: SkillRegistryOptions) {\n    this.directory = options.directory;\n  }\n\n  async list(): Promise<SkillSummary[]> {\n    const entries = await readdir(this.directory, { withFileTypes: true });\n    const summaries: SkillSummary[] = [];\n\n    for (const entry of entries) {\n      if (!entry.isDirectory()) continue;\n      const skillPath = join(this.directory, entry.name, 'SKILL.md');\n      try {\n        const content = await readFile(skillPath, 'utf-8');\n        const parsed = parseFrontmatter(content, skillPath);\n        summaries.push({\n          name: parsed.frontmatter.name,\n          description: parsed.frontmatter.description,\n          path: skillPath,\n        });\n      } catch {\n        // Skip directories without valid SKILL.md\n      }\n    }\n\n    return summaries;\n  }\n\n  async load(name: string): Promise<Skill> {\n    const skillPath = join(this.directory, name, 'SKILL.md');\n    try {\n      const content = await readFile(skillPath, 'utf-8');\n      const parsed = parseFrontmatter(content, skillPath);\n      return {\n        name: parsed.frontmatter.name,\n        description: parsed.frontmatter.description,\n        path: skillPath,\n        frontmatter: parsed.frontmatter,\n        body: parsed.body,\n        allowedTools: parsed.frontmatter['allowed-tools'],\n      };\n    } catch (err) {\n      throw new OllamaSkillNotFoundError(`Skill \"${name}\" not found at ${skillPath}`, {\n        skillName: name,\n        cause: err,\n      });\n    }\n  }\n}\n"]}

package/dist/skills.d.cts

@@ -1,6 +1,6 @@
-import { g as SkillSummary, S as Skill } from './compose-DS-UWFx8.cjs';
-export { d as AppliedSkillResult, e as ApplySkillOptions, P as ParsedFrontmatter, f as SkillFrontmatter, l as applySkill, p as parseFrontmatter } from './compose-DS-UWFx8.cjs';
-import './types-5PAjLoCp.cjs';
+import { g as SkillSummary, S as Skill } from './compose-Dj6FdF2n.cjs';
+export { d as AppliedSkillResult, e as ApplySkillOptions, P as ParsedFrontmatter, f as SkillFrontmatter, l as applySkill, p as parseFrontmatter } from './compose-Dj6FdF2n.cjs';
+import './types-DVcX_zMp.cjs';
 import 'zod';
 
 /**

package/dist/skills.d.ts

@@ -1,6 +1,6 @@
-import { g as SkillSummary, S as Skill } from './compose-DLStUfaF.js';
-export { d as AppliedSkillResult, e as ApplySkillOptions, P as ParsedFrontmatter, f as SkillFrontmatter, l as applySkill, p as parseFrontmatter } from './compose-DLStUfaF.js';
-import './types-5PAjLoCp.js';
+import { g as SkillSummary, S as Skill } from './compose-DCVYMvOL.js';
+export { d as AppliedSkillResult, e as ApplySkillOptions, P as ParsedFrontmatter, f as SkillFrontmatter, l as applySkill, p as parseFrontmatter } from './compose-DCVYMvOL.js';
+import './types-DVcX_zMp.js';
 import 'zod';
 
 /**