dsh-local-ai 0.1.0

package/lib/types/ollama.js

@@ -0,0 +1,184 @@
+/**
+ * Ollama HTTP API client (zero runtime dependencies — plain `fetch`). The
+ * harness `LlmAdapter` streams through `/api/chat`; discovery and management
+ * tools call `/api/tags`, `/api/show`, `/api/pull`, `/api/delete`, and
+ * `/api/version`. Every request carries the harness attribution headers and
+ * honors the caller's abort signal; non-2xx responses fail with a normalized
+ * `LlmError`. The fetch implementation is injectable for tests.
+ * @module dsh-local-ai/ollama
+ */
+import { attributionHeaders, LlmError } from '@deepseek-ai/dsh-llm';
+import { sanitizeEndpoint } from "./sanitize.js";
+/** Build an absolute API URL from a normalized base URL. */
+export function endpointUrl(baseURL, path) {
+    return `${baseURL}${path}`;
+}
+/** Map an HTTP status to a stable LlmError code. */
+export function httpErrorCode(status) {
+    if (status === 404)
+        return 'NOT_FOUND';
+    if (status === 400)
+        return 'INVALID_REQUEST';
+    if (status >= 500)
+        return 'SERVER';
+    return `HTTP_${status}`;
+}
+/** Throw a normalized LlmError from a non-2xx response, using the body's `error`. */
+async function throwHttpError(response, context) {
+    let message = `Ollama API error (HTTP ${response.status}) from ${sanitizeEndpoint(context)}`;
+    try {
+        const body = await response.json();
+        if (typeof body.error === 'string' && body.error.length > 0)
+            message = body.error;
+    }
+    catch {
+        // Only swallow error-body parsing: the HTTP status still identifies the failure.
+    }
+    throw new LlmError(message, httpErrorCode(response.status), { status: response.status });
+}
+/** Send a GET request and parse the JSON response. */
+export async function requestJson(baseURL, path, fetchImpl, signal) {
+    const response = await fetchImpl(endpointUrl(baseURL, path), {
+        method: 'GET',
+        headers: { accept: 'application/json', ...attributionHeaders() },
+        ...signal === undefined ? {} : { signal },
+    });
+    if (!response.ok)
+        await throwHttpError(response, endpointUrl(baseURL, path));
+    return response.json();
+}
+/** Send a POST request and parse the JSON response. */
+export async function postJson(baseURL, path, body, fetchImpl, signal) {
+    const response = await fetchImpl(endpointUrl(baseURL, path), {
+        method: 'POST',
+        headers: { 'content-type': 'application/json', accept: 'application/json', ...attributionHeaders() },
+        body: JSON.stringify(body),
+        ...signal === undefined ? {} : { signal },
+    });
+    if (!response.ok)
+        await throwHttpError(response, endpointUrl(baseURL, path));
+    return response.json();
+}
+/** Send a DELETE request and parse the JSON response. */
+export async function deleteJson(baseURL, path, body, fetchImpl, signal) {
+    const response = await fetchImpl(endpointUrl(baseURL, path), {
+        method: 'DELETE',
+        headers: { 'content-type': 'application/json', accept: 'application/json', ...attributionHeaders() },
+        body: JSON.stringify(body),
+        ...signal === undefined ? {} : { signal },
+    });
+    if (!response.ok)
+        await throwHttpError(response, endpointUrl(baseURL, path));
+    return response.json();
+}
+/**
+ * Send a POST and return the raw `Response` after validating 2xx. Used by the
+ * streaming adapter, which owns body decoding and the idle watchdog.
+ */
+export async function postStream(baseURL, path, body, fetchImpl, signal) {
+    const response = await fetchImpl(endpointUrl(baseURL, path), {
+        method: 'POST',
+        headers: { 'content-type': 'application/json', accept: 'application/x-ndjson', ...attributionHeaders() },
+        body: JSON.stringify(body),
+        ...signal === undefined ? {} : { signal },
+    });
+    if (!response.ok)
+        await throwHttpError(response, endpointUrl(baseURL, path));
+    return response;
+}
+/** List installed models from `/api/tags`. */
+export async function listModels(baseURL, fetchImpl, signal) {
+    const result = await requestJson(baseURL, '/api/tags', fetchImpl, signal);
+    return result.models ?? [];
+}
+/** List currently-loaded (running) models from `/api/ps`. */
+export async function listRunning(baseURL, fetchImpl, signal) {
+    const result = await requestJson(baseURL, '/api/ps', fetchImpl, signal);
+    return result.models ?? [];
+}
+/** Inspect one model via `/api/show`. */
+export async function showModel(baseURL, name, fetchImpl, signal) {
+    return postJson(baseURL, '/api/show', { name }, fetchImpl, signal);
+}
+/** Remove one model via `/api/delete`. */
+export async function removeModel(baseURL, name, fetchImpl, signal) {
+    await deleteJson(baseURL, '/api/delete', { name }, fetchImpl, signal);
+}
+/** Query the Ollama server version via `/api/version`. */
+export async function apiVersion(baseURL, fetchImpl, signal) {
+    const result = await requestJson(baseURL, '/api/version', fetchImpl, signal);
+    return result.version;
+}
+/**
+ * Pull a model via `/api/pull`, consuming the progress stream and returning the
+ * final status. An intermediate error status or a non-2xx response fails loud.
+ */
+export async function pullModel(baseURL, name, fetchImpl, signal) {
+    const response = await postStream(baseURL, '/api/pull', { name, stream: true }, fetchImpl, signal);
+    if (!response.body)
+        throw new LlmError('Ollama pull returned no response body', 'EMPTY_RESPONSE');
+    let last = { status: 'success' };
+    for await (const line of readNdjsonLines(response.body)) {
+        if (line.length === 0)
+            continue;
+        const chunk = JSON.parse(line);
+        if (typeof chunk.error === 'string' && chunk.error.length > 0) {
+            throw new LlmError(chunk.error, 'PROVIDER');
+        }
+        if (typeof chunk.status === 'string')
+            last = { status: chunk.status };
+    }
+    return last;
+}
+/**
+ * Decode a `ReadableStream<Uint8Array>` into newline-delimited text lines.
+ * The final line is yielded even without a trailing newline; a missing body
+ * yields nothing.
+ * @param body - the response body stream.
+ * @returns text lines in delivery order.
+ */
+export async function* readNdjsonLines(body) {
+    const reader = body.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 });
+            let newline = buffer.indexOf('\n');
+            while (newline >= 0) {
+                const line = buffer.slice(0, newline).replace(/\r$/u, '');
+                buffer = buffer.slice(newline + 1);
+                newline = buffer.indexOf('\n');
+                yield line;
+            }
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+    buffer += decoder.decode();
+    if (buffer.length > 0)
+        yield buffer;
+}
+/**
+ * Extract the context length from an `/api/show` result by scanning
+ * `model_info` for a `*.context_length` or bare `context_length` entry.
+ * @param show - the `/api/show` result.
+ * @returns the context length, or `undefined` when not reported.
+ */
+export function contextLengthOf(show) {
+    const info = show.model_info;
+    if (info === undefined)
+        return undefined;
+    for (const [key, value] of Object.entries(info)) {
+        if (key === 'context_length' || key.endsWith('.context_length')) {
+            if (typeof value === 'number' && Number.isInteger(value) && value > 0)
+                return value;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=ollama.js.map

package/lib/types/ollama.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.js","sourceRoot":"","sources":["../../src/ollama.ts"],"names":[],"mappings":"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"}

package/lib/types/route.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Local-model routing decision and the streaming fallback. The pure decision
+ * matches configured rules (task type via `purpose`, case-insensitive
+ * keywords, or a blanket `always`) against a request, in list order — first
+ * match wins. The streaming helper routes a matched request to the local
+ * Ollama adapter and, when the local route fails BEFORE producing any visible
+ * content, falls back to the cloud (`next()`) so a down Ollama never bricks a
+ * conversation. Once local content has started, it is streamed through — a
+ * mid-stream failure cannot be retracted.
+ * @module dsh-local-ai/route
+ */
+import type { GenerateOptions, StreamChunk } from '@deepseek-ai/dsh-llm';
+import type { ResolvedConfig, ResolvedRouteRule } from './config.ts';
+/** The chosen local model for one matched request. */
+export interface RouteDecision {
+    /** Harness-visible local model name. */
+    readonly model: string;
+}
+/**
+ * Concatenate the request's model-visible text (system prompt + every text
+ * block) for keyword matching.
+ * @param options - the request.
+ * @returns the joined text.
+ */
+export declare function requestText(options: GenerateOptions): string;
+/** Whether a keyword appears case-insensitively in the text. */
+export declare function matchesKeyword(text: string, keyword: string): boolean;
+/** Whether one resolved rule matches a request. */
+export declare function ruleMatches(rule: ResolvedRouteRule, options: GenerateOptions): boolean;
+/**
+ * Decide whether a request should route to a local model. A request already
+ * addressed to the `ollama` provider (explicit selection or a prior re-route)
+ * never re-routes.
+ * @param options - the request.
+ * @param resolved - the resolved config.
+ * @returns the local model to use, or `undefined` to stay on the cloud route.
+ */
+export declare function decideRoute(options: GenerateOptions, resolved: ResolvedConfig): RouteDecision | undefined;
+/**
+ * Stream a locally-routed request with automatic cloud fallback. The local
+ * stream is produced through `streamLocal` (the full harness stream, so the
+ * local route keeps retry and failure normalization). If the local route
+ * finishes with an error or aborts before any token delta, `next()` (the
+ * cloud) is streamed instead; otherwise the local stream is forwarded.
+ * @param streamLocal - produces the local stream for a re-routed request.
+ * @param options - the original request.
+ * @param decision - the local model to route to.
+ * @param next - the cloud stream (the waterfall's `next()`).
+ * @returns the effective chunk stream.
+ */
+export declare function routeLocal(streamLocal: (options: GenerateOptions) => AsyncIterable<StreamChunk>, options: GenerateOptions, decision: RouteDecision, next: () => AsyncIterable<StreamChunk>): AsyncGenerator<StreamChunk>;
+//# sourceMappingURL=route.d.ts.map

package/lib/types/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../src/route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAExE,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEpE,sDAAsD;AACtD,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAS5D;AAED,gEAAgE;AAChE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAErE;AAED,mDAAmD;AACnD,wBAAgB,WAAW,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAQtF;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,cAAc,GAAG,aAAa,GAAG,SAAS,CAMzG;AAED;;;;;;;;;;;GAWG;AACH,wBAAuB,UAAU,CAC/B,WAAW,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,aAAa,CAAC,WAAW,CAAC,EACrE,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,MAAM,aAAa,CAAC,WAAW,CAAC,GACrC,cAAc,CAAC,WAAW,CAAC,CAqC7B"}

package/lib/types/route.js

@@ -0,0 +1,119 @@
+/**
+ * Local-model routing decision and the streaming fallback. The pure decision
+ * matches configured rules (task type via `purpose`, case-insensitive
+ * keywords, or a blanket `always`) against a request, in list order — first
+ * match wins. The streaming helper routes a matched request to the local
+ * Ollama adapter and, when the local route fails BEFORE producing any visible
+ * content, falls back to the cloud (`next()`) so a down Ollama never bricks a
+ * conversation. Once local content has started, it is streamed through — a
+ * mid-stream failure cannot be retracted.
+ * @module dsh-local-ai/route
+ */
+import { isTokenDelta } from '@deepseek-ai/dsh-llm';
+import { OLLAMA_PROVIDER } from "./adapter.js";
+/**
+ * Concatenate the request's model-visible text (system prompt + every text
+ * block) for keyword matching.
+ * @param options - the request.
+ * @returns the joined text.
+ */
+export function requestText(options) {
+    const parts = [];
+    if (options.system !== undefined)
+        parts.push(options.system);
+    for (const message of options.messages) {
+        for (const block of message.content) {
+            if (block.type === 'text')
+                parts.push(block.text);
+        }
+    }
+    return parts.join('\n');
+}
+/** Whether a keyword appears case-insensitively in the text. */
+export function matchesKeyword(text, keyword) {
+    return text.toLowerCase().includes(keyword.toLowerCase());
+}
+/** Whether one resolved rule matches a request. */
+export function ruleMatches(rule, options) {
+    if (rule.always)
+        return true;
+    if (rule.purpose !== undefined && options.purpose === rule.purpose)
+        return true;
+    if (rule.keywords.length > 0) {
+        const text = requestText(options);
+        return rule.keywords.some(keyword => matchesKeyword(text, keyword));
+    }
+    return false;
+}
+/**
+ * Decide whether a request should route to a local model. A request already
+ * addressed to the `ollama` provider (explicit selection or a prior re-route)
+ * never re-routes.
+ * @param options - the request.
+ * @param resolved - the resolved config.
+ * @returns the local model to use, or `undefined` to stay on the cloud route.
+ */
+export function decideRoute(options, resolved) {
+    if (options.provider === OLLAMA_PROVIDER)
+        return undefined;
+    for (const rule of resolved.route) {
+        if (ruleMatches(rule, options))
+            return { model: rule.model };
+    }
+    return undefined;
+}
+/**
+ * Stream a locally-routed request with automatic cloud fallback. The local
+ * stream is produced through `streamLocal` (the full harness stream, so the
+ * local route keeps retry and failure normalization). If the local route
+ * finishes with an error or aborts before any token delta, `next()` (the
+ * cloud) is streamed instead; otherwise the local stream is forwarded.
+ * @param streamLocal - produces the local stream for a re-routed request.
+ * @param options - the original request.
+ * @param decision - the local model to route to.
+ * @param next - the cloud stream (the waterfall's `next()`).
+ * @returns the effective chunk stream.
+ */
+export async function* routeLocal(streamLocal, options, decision, next) {
+    const localOptions = { ...options, provider: OLLAMA_PROVIDER, model: decision.model };
+    const upstream = streamLocal(localOptions);
+    let producedContent = false;
+    const pending = [];
+    try {
+        for await (const chunk of upstream) {
+            if (producedContent) {
+                yield chunk;
+                continue;
+            }
+            if (chunk.type === 'finish') {
+                if (chunk.reason.kind === 'error' || chunk.reason.kind === 'aborted') {
+                    // Local failed before producing content — fall back to the cloud.
+                    yield* next();
+                    return;
+                }
+                yield chunk;
+                return;
+            }
+            pending.push(chunk);
+            if (isTokenDelta(chunk)) {
+                producedContent = true;
+                for (const buffered of pending)
+                    yield buffered;
+                pending.length = 0;
+            }
+        }
+        // Stream ended without a finish chunk — flush whatever was buffered.
+        for (const buffered of pending)
+            yield buffered;
+    }
+    catch (error) {
+        if (!producedContent) {
+            yield* next();
+            return;
+        }
+        for (const buffered of pending)
+            yield buffered;
+        throw error;
+    }
+}
+//# sourceMappingURL=route.js.map

package/lib/types/route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.js","sourceRoot":"","sources":["../../src/route.ts"],"names":[],"mappings":"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"}

package/lib/types/sanitize.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Display/log sanitization for `dsh-local-ai`. Every value shown to the model
+ * or to the user (tool results, the `/ollama` command, error messages) passes
+ * through one of these pure functions first, so an endpoint address or a local
+ * path can never leak credentials, secret query parameters, or unbounded text.
+ *
+ * All functions are pure: they depend only on their arguments, never on
+ * process state (the caller supplies a home directory for path redaction).
+ * @module dsh-local-ai/sanitize
+ */
+/** Placeholder substituted for a redacted secret or credential. */
+export declare const REDACTED = "[REDACTED]";
+/** Remove C0/DEL control characters from a string. */
+export declare function stripControl(value: string): string;
+/**
+ * Truncate a string to `maxChars`, appending an ellipsis when it was cut.
+ * A non-positive `maxChars` yields the empty string.
+ * @param value - the string to bound.
+ * @param maxChars - maximum returned length, including the ellipsis.
+ * @returns the bounded string.
+ */
+export declare function truncate(value: string, maxChars: number): string;
+/**
+ * Sanitize an endpoint address for display: strip the URL userinfo
+ * (`user:pass@`), drop query parameters whose key looks like a secret, strip
+ * control characters, and bound the length. Values that are not parseable as
+ * a URL are still stripped and truncated.
+ * @param value - the raw endpoint (URL string or anything stringifiable).
+ * @param maxChars - maximum returned length.
+ * @returns the sanitized endpoint text.
+ */
+export declare function sanitizeEndpoint(value: unknown, maxChars?: number): string;
+/**
+ * Sanitize a local path for display: strip control characters, redact a
+ * leading home directory to `~`, and bound the length.
+ * @param value - the raw path (string or anything stringifiable).
+ * @param home - the user's home directory to redact; omit to skip redaction.
+ * @param maxChars - maximum returned length.
+ * @returns the sanitized path text.
+ */
+export declare function sanitizePath(value: unknown, home?: string, maxChars?: number): string;
+/**
+ * Redact built-in secret literals (API keys, GitHub tokens, AWS keys, bearer
+ * credentials, PEM private keys) from arbitrary text. Control characters are
+ * stripped first.
+ * @param value - the raw text (string or anything stringifiable).
+ * @returns the text with secret literals replaced by {@link REDACTED}.
+ */
+export declare function redactSecrets(value: unknown): string;
+/**
+ * Sanitize arbitrary display text: redact secrets, strip control characters,
+ * and bound the length.
+ * @param value - the raw text (string or anything stringifiable).
+ * @param maxChars - maximum returned length.
+ * @returns the sanitized text.
+ */
+export declare function sanitizeText(value: unknown, maxChars?: number): string;
+//# sourceMappingURL=sanitize.d.ts.map

package/lib/types/sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/sanitize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,mEAAmE;AACnE,eAAO,MAAM,QAAQ,eAAe,CAAA;AAkBpC,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAO,GAAG,MAAM,CAexE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,SAAK,EAAE,QAAQ,SAAO,GAAG,MAAM,CAM/E;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKpD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAO,GAAG,MAAM,CAEpE"}

package/lib/types/sanitize.js

@@ -0,0 +1,110 @@
+/**
+ * Display/log sanitization for `dsh-local-ai`. Every value shown to the model
+ * or to the user (tool results, the `/ollama` command, error messages) passes
+ * through one of these pure functions first, so an endpoint address or a local
+ * path can never leak credentials, secret query parameters, or unbounded text.
+ *
+ * All functions are pure: they depend only on their arguments, never on
+ * process state (the caller supplies a home directory for path redaction).
+ * @module dsh-local-ai/sanitize
+ */
+/** Placeholder substituted for a redacted secret or credential. */
+export const REDACTED = '[REDACTED]';
+/** Control characters (C0 + DEL) stripped from every sanitized value. */
+const CONTROL_CHARS = /[\u0000-\u001f\u007f]/gu;
+/** Secret-shaped query-parameter keys removed from endpoint URLs. */
+const SECRET_KEY_PATTERN = /key|token|secret|password|credential|auth/iu;
+/** Built-in secret literal patterns redacted from arbitrary text. */
+const BUILTIN_SECRET_PATTERNS = [
+    /\bsk-[A-Za-z0-9]{16,}\b/u,
+    /\bghp_[A-Za-z0-9]{20,}\b/u,
+    /\bgho_[A-Za-z0-9]{20,}\b/u,
+    /\bAKIA[0-9A-Z]{16}\b/u,
+    /\bBearer\s+[A-Za-z0-9._~+/=-]{8,}\b/u,
+    /-----BEGIN [A-Z ]*PRIVATE KEY-----[A-Za-z0-9+/=\s]*-----END [A-Z ]*PRIVATE KEY-----/u,
+];
+/** Remove C0/DEL control characters from a string. */
+export function stripControl(value) {
+    return value.replace(CONTROL_CHARS, '');
+}
+/**
+ * Truncate a string to `maxChars`, appending an ellipsis when it was cut.
+ * A non-positive `maxChars` yields the empty string.
+ * @param value - the string to bound.
+ * @param maxChars - maximum returned length, including the ellipsis.
+ * @returns the bounded string.
+ */
+export function truncate(value, maxChars) {
+    if (value.length <= maxChars)
+        return value;
+    if (maxChars <= 1)
+        return maxChars <= 0 ? '' : '…';
+    return `${value.slice(0, maxChars - 1)}…`;
+}
+/**
+ * Sanitize an endpoint address for display: strip the URL userinfo
+ * (`user:pass@`), drop query parameters whose key looks like a secret, strip
+ * control characters, and bound the length. Values that are not parseable as
+ * a URL are still stripped and truncated.
+ * @param value - the raw endpoint (URL string or anything stringifiable).
+ * @param maxChars - maximum returned length.
+ * @returns the sanitized endpoint text.
+ */
+export function sanitizeEndpoint(value, maxChars = 2048) {
+    const text = stripControl(typeof value === 'string' ? value : String(value));
+    let out;
+    try {
+        const url = new URL(text);
+        url.username = '';
+        url.password = '';
+        for (const key of [...url.searchParams.keys()]) {
+            if (SECRET_KEY_PATTERN.test(key))
+                url.searchParams.delete(key);
+        }
+        out = url.href;
+    }
+    catch {
+        out = text;
+    }
+    return truncate(out, maxChars);
+}
+/**
+ * Sanitize a local path for display: strip control characters, redact a
+ * leading home directory to `~`, and bound the length.
+ * @param value - the raw path (string or anything stringifiable).
+ * @param home - the user's home directory to redact; omit to skip redaction.
+ * @param maxChars - maximum returned length.
+ * @returns the sanitized path text.
+ */
+export function sanitizePath(value, home = '', maxChars = 1024) {
+    const text = stripControl(typeof value === 'string' ? value : String(value));
+    const redacted = home.length > 0 && text.startsWith(home)
+        ? `~${text.slice(home.length)}`
+        : text;
+    return truncate(redacted, maxChars);
+}
+/**
+ * Redact built-in secret literals (API keys, GitHub tokens, AWS keys, bearer
+ * credentials, PEM private keys) from arbitrary text. Control characters are
+ * stripped first.
+ * @param value - the raw text (string or anything stringifiable).
+ * @returns the text with secret literals replaced by {@link REDACTED}.
+ */
+export function redactSecrets(value) {
+    const text = stripControl(typeof value === 'string' ? value : String(value));
+    let out = text;
+    for (const pattern of BUILTIN_SECRET_PATTERNS)
+        out = out.replace(pattern, REDACTED);
+    return out;
+}
+/**
+ * Sanitize arbitrary display text: redact secrets, strip control characters,
+ * and bound the length.
+ * @param value - the raw text (string or anything stringifiable).
+ * @param maxChars - maximum returned length.
+ * @returns the sanitized text.
+ */
+export function sanitizeText(value, maxChars = 4000) {
+    return truncate(redactSecrets(value), maxChars);
+}
+//# sourceMappingURL=sanitize.js.map

package/lib/types/sanitize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.js","sourceRoot":"","sources":["../../src/sanitize.ts"],"names":[],"mappings":"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"}

package/lib/types/serialize.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Serialize harness messages and requests into the Ollama `/api/chat` wire
+ * vocabulary. User text is joined; assistant text becomes `content` and tool
+ * calls become `tool_calls` (with arguments parsed from the raw JSON string to
+ * the object Ollama expects); tool results become separate `tool` messages.
+ * Core image blocks are rejected explicitly because this route is text-only;
+ * unknown declaration-merged block types retain the documented extension
+ * fallback (ignored for content, retained as text where text is expected).
+ * @module dsh-local-ai/serialize
+ */
+import type { GenerateOptions, Message, ToolSchema } from '@deepseek-ai/dsh-llm';
+import type { ResolvedConfig } from './config.ts';
+/** One Ollama chat message on the wire. */
+export interface OllamaWireMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    tool_calls?: Array<{
+        function: {
+            name: string;
+            arguments: Record<string, unknown>;
+        };
+    }>;
+    tool_name?: string;
+}
+/** The Ollama `/api/chat` request body. */
+export interface OllamaWireRequest {
+    model: string;
+    messages: OllamaWireMessage[];
+    stream: boolean;
+    options?: Record<string, unknown>;
+    tools?: Array<{
+        type: 'function';
+        function: ToolSchema;
+    }>;
+}
+/**
+ * Parse a tool-call argument string into the object Ollama expects. The raw
+ * string is guaranteed by the harness contract to be JSON; a malformed value
+ * from a hand-built call degrades to a single `value` field rather than
+ * bricking the whole session.
+ * @param raw - the raw JSON string produced by the model.
+ * @returns the parsed object, or a `{ value }` fallback.
+ */
+export declare function parseToolArguments(raw: string): Record<string, unknown>;
+/**
+ * Serialize the conversation. `tool-result` blocks become standalone
+ * `{role: 'tool'}` messages; the harness puts each tool result in its own
+ * user-role message, so a mixed user message contributes its text first and
+ * its tool results as separate wire messages after. Assistant tool calls are
+ * indexed first so their results can carry the tool name Ollama needs.
+ * @param messages - the harness conversation, in order.
+ * @returns the wire messages; order preserved, each tool result expanded into its own entry.
+ */
+export declare function serializeMessages(messages: Message[]): OllamaWireMessage[];
+/**
+ * Build the full wire request. Always streaming (`stream: true`); optional
+ * fields are omitted rather than sent as null, so Ollama defaults apply.
+ * `temperature` resolves request → model mapping → plugin default; `num_predict`
+ * is the harness-materialized `maxTokens`.
+ * @param options - the harness request (model, history, system, tools, sampling).
+ * @param resolved - the resolved plugin config.
+ * @returns the `/api/chat` request body.
+ */
+export declare function serializeRequest(options: GenerateOptions, resolved: ResolvedConfig): OllamaWireRequest;
+//# sourceMappingURL=serialize.d.ts.map

package/lib/types/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../src/serialize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAgB,eAAe,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAC9F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAA;IAC9C,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE,CAAA;KAAE,CAAC,CAAA;IACtF,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,iBAAiB,EAAE,CAAA;IAC7B,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE,UAAU,CAAA;KAAE,CAAC,CAAA;CAC1D;AAiBD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUvE;AAuBD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,iBAAiB,EAAE,CAsC1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,cAAc,GACvB,iBAAiB,CA4BnB"}