@origintrail-official/dkg-local-llm 10.0.15

package/LICENSE

@@ -0,0 +1,17 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+Copyright 2026 OriginTrail
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,173 @@
+# `@origintrail-official/dkg-local-llm`
+
+Bounded local-model orchestration for the DKG MCP surface. The package talks to
+an OpenAI-compatible llama.cpp or Ollama endpoint and receives its tools
+dynamically from MCP `tools/list`.
+
+The runtime is read-only by default. It tokenizes each prompt and dynamically
+ranks the discovered MCP tools by their names, descriptions, and input schemas
+instead of maintaining a use-case allowlist. The default shortlist is bounded
+to eight schemas and 18,000 serialized JSON bytes. Mutations require
+`allowWrite: true` and an explicit action/target request.
+
+It also provides:
+
+- local-server-safe JSON Schema normalization (`\\d` becomes `[0-9]` losslessly);
+- local argument validation and one repair retry;
+- repeated-call and tool-call-count guards;
+- bounded chat history whose old evidence is never treated as fresh;
+- plain-text interaction traces with secret redaction and `0600` permissions;
+- system context v4.2, without benchmark fixtures or domain-specific IDs.
+
+Partner integrations can supply a validated JSON domain profile containing
+literal routing keywords, read/write adapter tool hints, and a domain context
+addendum. Profiles boost dynamically discovered tools; they do not patch the
+core router or weaken the runtime's read-only default.
+
+The package is a library. The umbrella `dkg llm` CLI owns MCP stdio lifecycle,
+configuration, and operator-facing write opt-in.
+
+For agent and operator copy/paste setup, model recommendations, and the required
+Query-Catalog-first workflow for small models, see
+[`Run a Local LLM with DKG`](../../docs/use-dkg/local-llm.md).
+
+## Interactive chat from a source checkout
+
+Start the DKG daemon first. Then use two terminals for the model server and the
+interactive DKG client.
+
+### Terminal 1: start Qwen with llama.cpp or Ollama
+
+llama.cpp remains the reference backend:
+
+```bash
+/absolute/path/to/llama-server \
+  -hf Qwen/Qwen3-8B-GGUF:Q4_K_M \
+  -ngl 999 \
+  -c 8192 \
+  --flash-attn on \
+  --jinja \
+  --temp 0.15 \
+  --top-p 0.9 \
+  --repeat-penalty 1.05 \
+  --host 127.0.0.1 \
+  --port 8080
+```
+
+Leave that terminal running. Wait for the model to load, then verify it from
+another terminal:
+
+```bash
+curl -sS http://127.0.0.1:8080/health
+curl -sS http://127.0.0.1:8080/v1/models
+```
+
+Continue only when `/v1/models` returns HTTP 200. The llama.cpp `/health`
+response should also be `{"status":"ok"}`.
+
+Alternatively, complete the full guide's canonical
+[Ollama setup procedure](../../docs/use-dkg/local-llm.md#install-and-run-ollama).
+That section is the sole source for installation, server ownership, context,
+model loading, and readiness policy. Leave the verified server running, then
+use the Ollama client options below.
+
+### Terminal 2: start interactive DKG chat
+
+From the DKG repository root, start an interactive Qwen session against the
+`testing` Context Graph with an explicit session pin:
+
+```bash
+DKG_HOME=/absolute/path/to/dkg-home \
+pnpm dkg llm \
+  --interactive \
+  --project testing \
+  --llama-url http://127.0.0.1:8080/v1/chat/completions \
+  --model qwen3-8b-q4-k-m \
+  --allow-write
+```
+
+`pnpm dkg` runs the source checkout's built CLI from
+`packages/cli/dist/cli.js`. Build the workspace first if that file is absent or
+stale.
+
+`--allow-write` exposes relevant mutation tools, but a mutation still requires
+an explicit user request. Omit `--allow-write` for the recommended read-only
+chat:
+
+```bash
+DKG_HOME=/absolute/path/to/dkg-home \
+pnpm dkg llm \
+  --interactive \
+  --project testing \
+  --llama-url http://127.0.0.1:8080/v1/chat/completions \
+  --model qwen3-8b-q4-k-m
+```
+
+For Ollama, replace the last two options with:
+
+```bash
+--llama-url http://127.0.0.1:11434/v1/chat/completions \
+--model qwen3:8b
+```
+
+The legacy option name `--llama-url` accepts either supported backend.
+
+`--project` is an explicit LLM-session pin. The local-LLM command does not
+inherit `DKG_PROJECT` as an invisible default. A scoped tool call always carries
+`projectId` in the logged MCP arguments: the runtime copies it from exact
+catalog evidence first, then from the explicit session pin. Without either, the
+call is rejected instead of falling through to the first graph in DKG config.
+
+## Real DKG benchmark
+
+The bundled benchmark uses this production runtime, a real `dkg mcp serve`
+child, a real DKG daemon/store, and a real OpenAI-compatible local model. It
+creates persistent local data, so `--allow-write` is mandatory and each run
+should use unique graph/asset names.
+
+```bash
+# Terminal 1: start DKG from this checkout
+DKG_HOME=/absolute/path/to/dkg-home \
+  node packages/cli/dist/cli.js daemon-foreground-worker
+
+# Terminal 2: start llama.cpp with one model
+/absolute/path/to/llama-server \
+  -hf Qwen/Qwen3-8B-GGUF:Q4_K_M -ngl 999 -c 8192 \
+  --flash-attn on --jinja --temp 0.15 --top-p 0.9 --repeat-penalty 1.05
+
+# Terminal 3: run 8 core scenarios plus 5 holdouts
+RUN_ID="$(date +%Y%m%d-%H%M%S)"
+DKG_HOME=/absolute/path/to/dkg-home \
+DKG_CLI_PATH="$PWD/packages/cli/dist/cli.js" \
+pnpm --filter @origintrail-official/dkg-local-llm benchmark:dkg -- \
+  --allow-write \
+  --graph-id "dkg-llm-qwen8-$RUN_ID" \
+  --asset-name "model-families-qwen8-$RUN_ID" \
+  --model qwen3-8b-q4-k-m \
+  --label "qwen3-8b-q4-k-m-$RUN_ID"
+```
+
+To validate Ollama rather than assume parity, start it with the intended model
+tag and add
+`--llama-url http://127.0.0.1:11434/v1/chat/completions --model qwen3:8b`
+to the benchmark command. On the sub-24-GiB acceptance machine, retain
+`ollama ps` evidence showing at least `8192` context immediately before the run,
+then require the complete 13-scenario benchmark to finish without prompt or tool
+schema truncation at the default eight-tool/18,000-byte routing budget. Keep
+each model/server pair's output and score separate from the llama.cpp reference
+result.
+
+The suite covers Context Graph creation, two subgraphs, model-authored RDF,
+asset retrieval, raw SPARQL, parameterized query-catalog save/list/run, and five
+generalization holdouts. Prerequisite fixture repairs are tagged `source:
+"fixture"` and excluded from model scores, so an early write failure cannot
+turn every later read into a cascade failure. The output directory contains:
+
+- `interaction.log` — complete readable, redacted request/tool/result trace;
+- `results.json` — phase scores plus every guarded MCP call;
+- `report.md` — compact comparison table and independent DKG verification.
+
+The guard permits only local benchmark mutations (graph/subgraph creation,
+Working Memory asset write/finalize, and catalog save). Share, publish,
+registration, messaging, and destructive operations are blocked even when the
+runtime is in benchmark write mode.

package/dist/dkg-tool-validation.d.ts

@@ -0,0 +1,41 @@
+import type { McpToolDefinition } from './schema.js';
+export interface DkgToolValidationResult {
+    ok: boolean;
+    errors: string[];
+}
+export interface SanitizedContextGraphArguments {
+    args: Record<string, unknown>;
+    removed: Array<'projectId' | 'contextGraphId'>;
+    reasons: Array<{
+        key: 'projectId' | 'contextGraphId';
+        reason: 'config-path' | 'default-placeholder';
+        value: unknown;
+    }>;
+}
+export declare function isDkgConfigPath(value: unknown): boolean;
+export declare function isDefaultContextGraphPlaceholder(value: unknown): boolean;
+export declare function referencesUnresolvedContextGraphAlias(value: string): boolean;
+/**
+ * Ported from the qwen-dkg harness. Local models sometimes copy prose from a
+ * schema description and send `.dkg/config.yaml` (or a placeholder such as
+ * `default-context-graph-id`) as if it were a real graph id. Remove those
+ * synthetic values before scope materialization so they can never reach MCP.
+ */
+export declare function sanitizeContextGraphArguments(args: Record<string, unknown>): SanitizedContextGraphArguments;
+/** Remove MCP-default wording that local models can mistake for a literal id. */
+export declare function sanitizeDkgToolForLocalLlm(tool: McpToolDefinition): McpToolDefinition;
+/**
+ * Cheap, deterministic checks for mistakes small local models commonly make.
+ * This is deliberately a preflight rather than a SPARQL parser: the DKG query
+ * engine remains authoritative, while obvious malformed calls get the
+ * runtime's single bounded repair attempt instead of a daemon round trip.
+ */
+export declare function validateSparqlForDkg(value: unknown): DkgToolValidationResult;
+export declare function validateDkgToolCall(name: string, args: Record<string, unknown>): DkgToolValidationResult;
+/**
+ * Produce one conservative alternate for data written through the DKG quad
+ * API, which preserves compact predicate strings such as `rdf:type`. This is
+ * used only after the original, syntactically-valid read returned no evidence.
+ */
+export declare function rewriteCompactPredicatesForDkg(sparql: string): string;
+//# sourceMappingURL=dkg-tool-validation.d.ts.map

package/dist/dkg-tool-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dkg-tool-validation.d.ts","sourceRoot":"","sources":["../src/dkg-tool-validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGrD,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAID,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,EAAE,KAAK,CAAC,WAAW,GAAG,gBAAgB,CAAC,CAAC;IAC/C,OAAO,EAAE,KAAK,CAAC;QACb,GAAG,EAAE,WAAW,GAAG,gBAAgB,CAAC;QACpC,MAAM,EAAE,aAAa,GAAG,qBAAqB,CAAC;QAC9C,KAAK,EAAE,OAAO,CAAC;KAChB,CAAC,CAAC;CACJ;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAGvD;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKxE;AAED,wBAAgB,qCAAqC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAG5E;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,8BAA8B,CAgBhC;AAiBD,iFAAiF;AACjF,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,iBAAiB,GAAG,iBAAiB,CAKrF;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,uBAAuB,CA0C5E;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,uBAAuB,CAKzB;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAiDrE"}

package/dist/dkg-tool-validation.js

@@ -0,0 +1,171 @@
+import { prepareSparql } from '@origintrail-official/dkg-rdf-utils/sparql';
+import { scanSparqlPreflight } from './sparql-preflight-scanner.js';
+const MAX_SPARQL_PREFLIGHT_CHARS = 65_536;
+export function isDkgConfigPath(value) {
+    return typeof value === 'string'
+        && /(?:^|[/\\])(?:\.dkg[/\\])?config\.(?:ya?ml|json)$/i.test(value.trim());
+}
+export function isDefaultContextGraphPlaceholder(value) {
+    if (typeof value !== 'string')
+        return false;
+    const normalized = value.trim().toLowerCase();
+    return /^(?:the[-_ ]?)?default(?:[-_ ]?(?:context[-_ ]?graph)(?:[-_ ]?id)?)?$/.test(normalized)
+        || /^(?:context[-_ ]?graph|project)[-_ ]?id$/.test(normalized);
+}
+export function referencesUnresolvedContextGraphAlias(value) {
+    return /\b(?:default|current)\s+(?:dkg\s+)?(?:context\s+graphs?|cgs?)\b/i.test(value)
+        || /\b(?:context\s+graphs?|cgs?)\s+(?:called\s+)?(?:the\s+)?(?:default|current)\b/i.test(value);
+}
+/**
+ * Ported from the qwen-dkg harness. Local models sometimes copy prose from a
+ * schema description and send `.dkg/config.yaml` (or a placeholder such as
+ * `default-context-graph-id`) as if it were a real graph id. Remove those
+ * synthetic values before scope materialization so they can never reach MCP.
+ */
+export function sanitizeContextGraphArguments(args) {
+    const cleaned = { ...args };
+    const removed = [];
+    const reasons = [];
+    for (const key of ['projectId', 'contextGraphId']) {
+        const reason = isDkgConfigPath(cleaned[key])
+            ? 'config-path'
+            : isDefaultContextGraphPlaceholder(cleaned[key])
+                ? 'default-placeholder'
+                : undefined;
+        if (!reason)
+            continue;
+        reasons.push({ key, reason, value: cleaned[key] });
+        delete cleaned[key];
+        removed.push(key);
+    }
+    return { args: cleaned, removed, reasons };
+}
+function rewriteLocalLlmScopeDescriptions(value) {
+    if (Array.isArray(value))
+        return value.map(rewriteLocalLlmScopeDescriptions);
+    if (!value || typeof value !== 'object')
+        return value;
+    const output = {};
+    for (const [key, child] of Object.entries(value)) {
+        output[key] = key === 'description' && typeof child === 'string'
+            ? child.replace(/Defaults to \.dkg\/config\.yaml\.?/gi, 'Omit only when an explicit Session Context Graph is selected. Never pass a config filename or generic placeholder as a graph id.')
+            : rewriteLocalLlmScopeDescriptions(child);
+    }
+    return output;
+}
+/** Remove MCP-default wording that local models can mistake for a literal id. */
+export function sanitizeDkgToolForLocalLlm(tool) {
+    return {
+        ...tool,
+        inputSchema: rewriteLocalLlmScopeDescriptions(tool.inputSchema),
+    };
+}
+/**
+ * Cheap, deterministic checks for mistakes small local models commonly make.
+ * This is deliberately a preflight rather than a SPARQL parser: the DKG query
+ * engine remains authoritative, while obvious malformed calls get the
+ * runtime's single bounded repair attempt instead of a daemon round trip.
+ */
+export function validateSparqlForDkg(value) {
+    const rawSparql = typeof value === 'string' ? value : '';
+    if (rawSparql.length > MAX_SPARQL_PREFLIGHT_CHARS) {
+        return {
+            ok: false,
+            errors: [`sparql must not exceed ${MAX_SPARQL_PREFLIGHT_CHARS} characters`],
+        };
+    }
+    const sparql = rawSparql.trim();
+    const errors = [];
+    if (!sparql)
+        return { ok: false, errors: ['sparql must not be empty'] };
+    if (/```/.test(sparql))
+        errors.push('remove Markdown fences and send raw SPARQL only');
+    const scan = scanSparqlPreflight(sparql);
+    if (scan.unterminated)
+        errors.push('close the unterminated string literal or IRI');
+    if (!scan.operation) {
+        errors.push('query must start with SELECT, ASK, or CONSTRUCT');
+    }
+    if (!scan.bracesBalanced)
+        errors.push('balance SPARQL braces');
+    if (!scan.parenthesesBalanced)
+        errors.push('balance SPARQL parentheses');
+    if (scan.hasFrom) {
+        errors.push('remove FROM because projectId, subGraphName, and view already scope the query');
+    }
+    if (scan.hasFilterNotExistsParentheses) {
+        errors.push('use braces for FILTER NOT EXISTS');
+    }
+    if (scan.hasStrcontains) {
+        errors.push('use SPARQL CONTAINS instead of STRCONTAINS');
+    }
+    if (scan.hasUnwrappedAggregateAlias) {
+        errors.push('wrap aggregate aliases as (COUNT(...) AS ?count)');
+    }
+    // Prefixed names (schema:name) are valid. Absolute identifiers copied from
+    // DKG evidence (urn:..., did:..., http://...) are not prefixed names and
+    // must be enclosed in <...> when used as SPARQL terms.
+    if (scan.bareAbsoluteIri) {
+        errors.push(`wrap absolute IRI ${scan.bareAbsoluteIri} in angle brackets`);
+    }
+    const unique = [...new Set(errors)];
+    return { ok: unique.length === 0, errors: unique };
+}
+export function validateDkgToolCall(name, args) {
+    if (name === 'dkg_query' || name === 'dkg_query_catalog_save') {
+        return validateSparqlForDkg(args.sparql);
+    }
+    return { ok: true, errors: [] };
+}
+/**
+ * Produce one conservative alternate for data written through the DKG quad
+ * API, which preserves compact predicate strings such as `rdf:type`. This is
+ * used only after the original, syntactically-valid read returned no evidence.
+ */
+export function rewriteCompactPredicatesForDkg(sparql) {
+    const scan = prepareSparql(sparql);
+    if (scan.unterminated)
+        return sparql;
+    const edits = [];
+    const hasWhitespaceGap = (start, end) => (end > start && /^\s+$/u.test(scan.masked.slice(start, end)));
+    const canPrecedePredicate = (index) => {
+        const token = scan.tokens[index];
+        if (!token)
+            return false;
+        if (token.kind === 'iri')
+            return true;
+        if (token.kind === 'variable')
+            return token.logicalValue.startsWith('?');
+        return token.kind === 'prefixed-name';
+    };
+    for (let index = 1; index < scan.tokens.length - 1; index++) {
+        const previous = scan.tokens[index - 1];
+        const candidate = scan.tokens[index];
+        const next = scan.tokens[index + 1];
+        const followsSubject = canPrecedePredicate(index - 1)
+            && hasWhitespaceGap(previous.end, candidate.start);
+        const followsSemicolon = previous.kind === 'symbol'
+            && previous.logicalValue === ';'
+            && hasWhitespaceGap(previous.end, candidate.start);
+        if (!followsSubject && !followsSemicolon)
+            continue;
+        if (!hasWhitespaceGap(candidate.end, next.start))
+            continue;
+        if (candidate.kind === 'word' && candidate.upper === 'A') {
+            edits.push({ start: candidate.start, end: candidate.end, value: '<rdf:type>' });
+            continue;
+        }
+        if (candidate.kind === 'prefixed-name'
+            && /^(?:rdf|rdfs|schema):[A-Za-z_][A-Za-z0-9_.-]*$/iu.test(candidate.logicalValue)) {
+            edits.push({
+                start: candidate.start,
+                end: candidate.end,
+                value: `<${candidate.raw}>`,
+            });
+        }
+    }
+    return edits
+        .sort((left, right) => right.start - left.start)
+        .reduce((rewritten, edit) => rewritten.slice(0, edit.start) + edit.value + rewritten.slice(edit.end), sparql);
+}
+//# sourceMappingURL=dkg-tool-validation.js.map

package/dist/dkg-tool-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dkg-tool-validation.js","sourceRoot":"","sources":["../src/dkg-tool-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAE3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAOpE,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAY1C,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ;WAC3B,oDAAoD,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,KAAc;IAC7D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,OAAO,uEAAuE,CAAC,IAAI,CAAC,UAAU,CAAC;WAC1F,0CAA0C,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,qCAAqC,CAAC,KAAa;IACjE,OAAO,kEAAkE,CAAC,IAAI,CAAC,KAAK,CAAC;WAChF,gFAAgF,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACpG,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAC3C,IAA6B;IAE7B,MAAM,OAAO,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;IAC5B,MAAM,OAAO,GAA8C,EAAE,CAAC;IAC9D,MAAM,OAAO,GAA8C,EAAE,CAAC;IAC9D,KAAK,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,gBAAgB,CAAU,EAAE,CAAC;QAC3D,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC1C,CAAC,CAAC,aAAsB;YACxB,CAAC,CAAC,gCAAgC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC9C,CAAC,CAAC,qBAA8B;gBAChC,CAAC,CAAC,SAAS,CAAC;QAChB,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC7C,CAAC;AAED,SAAS,gCAAgC,CAAC,KAAc;IACtD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;IAC7E,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,KAAK,aAAa,IAAI,OAAO,KAAK,KAAK,QAAQ;YAC9D,CAAC,CAAC,KAAK,CAAC,OAAO,CACb,sCAAsC,EACtC,kIAAkI,CACnI;YACD,CAAC,CAAC,gCAAgC,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,0BAA0B,CAAC,IAAuB;IAChE,OAAO;QACL,GAAG,IAAI;QACP,WAAW,EAAE,gCAAgC,CAAC,IAAI,CAAC,WAAW,CAA4B;KAC3F,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,MAAM,SAAS,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACzD,IAAI,SAAS,CAAC,MAAM,GAAG,0BAA0B,EAAE,CAAC;QAClD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,CAAC,0BAA0B,0BAA0B,aAAa,CAAC;SAC5E,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;IAChC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,0BAA0B,CAAC,EAAE,CAAC;IACxE,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;IAEvF,MAAM,IAAI,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,IAAI,CAAC,YAAY;QAAE,MAAM,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;IACnF,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACpB,MAAM,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,cAAc;QAAE,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAC/D,IAAI,CAAC,IAAI,CAAC,mBAAmB;QAAE,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IACzE,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,CAAC,IAAI,CAAC,+EAA+E,CAAC,CAAC;IAC/F,CAAC;IACD,IAAI,IAAI,CAAC,6BAA6B,EAAE,CAAC;QACvC,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,MAAM,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,IAAI,CAAC,0BAA0B,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;IAClE,CAAC;IAED,2EAA2E;IAC3E,yEAAyE;IACzE,uDAAuD;IACvD,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,qBAAqB,IAAI,CAAC,eAAe,oBAAoB,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACpC,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,IAA6B;IAE7B,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,wBAAwB,EAAE,CAAC;QAC9D,OAAO,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,8BAA8B,CAAC,MAAc;IAC3D,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,YAAY;QAAE,OAAO,MAAM,CAAC;IACrC,MAAM,KAAK,GAAyD,EAAE,CAAC;IAEvE,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAE,GAAW,EAAW,EAAE,CAAC,CAChE,GAAG,GAAG,KAAK,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAC5D,CAAC;IACF,MAAM,mBAAmB,GAAG,CAAC,KAAa,EAAW,EAAE;QACrD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACzB,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK;YAAE,OAAO,IAAI,CAAC;QACtC,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU;YAAE,OAAO,KAAK,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACzE,OAAO,KAAK,CAAC,IAAI,KAAK,eAAe,CAAC;IACxC,CAAC,CAAC;IAEF,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACxC,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACpC,MAAM,cAAc,GAAG,mBAAmB,CAAC,KAAK,GAAG,CAAC,CAAC;eAChD,gBAAgB,CAAC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;QACrD,MAAM,gBAAgB,GAAG,QAAQ,CAAC,IAAI,KAAK,QAAQ;eAC9C,QAAQ,CAAC,YAAY,KAAK,GAAG;eAC7B,gBAAgB,CAAC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;QACrD,IAAI,CAAC,cAAc,IAAI,CAAC,gBAAgB;YAAE,SAAS;QACnD,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC;YAAE,SAAS;QAE3D,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM,IAAI,SAAS,CAAC,KAAK,KAAK,GAAG,EAAE,CAAC;YACzD,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,SAAS,CAAC,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;YAChF,SAAS;QACX,CAAC;QACD,IACE,SAAS,CAAC,IAAI,KAAK,eAAe;eAC/B,kDAAkD,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,EAClF,CAAC;YACD,KAAK,CAAC,IAAI,CAAC;gBACT,KAAK,EAAE,SAAS,CAAC,KAAK;gBACtB,GAAG,EAAE,SAAS,CAAC,GAAG;gBAClB,KAAK,EAAE,IAAI,SAAS,CAAC,GAAG,GAAG;aAC5B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,KAAK;SACT,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;SAC/C,MAAM,CACL,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAC5F,MAAM,CACP,CAAC;AACN,CAAC"}

package/dist/domain-profile.d.ts

@@ -0,0 +1,10 @@
+export interface DkgLocalLlmDomainProfile {
+    name: string;
+    description?: string;
+    routingKeywords: string[];
+    readTools: string[];
+    writeTools?: string[];
+    systemContext?: string;
+}
+export declare function parseDomainProfile(value: unknown): DkgLocalLlmDomainProfile;
+//# sourceMappingURL=domain-profile.d.ts.map

package/dist/domain-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-profile.d.ts","sourceRoot":"","sources":["../src/domain-profile.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAoCD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,wBAAwB,CAmB3E"}

package/dist/domain-profile.js

@@ -0,0 +1,53 @@
+const TOOL_NAME = /^[A-Za-z0-9_.:-]{1,128}$/;
+function stringField(record, key, required = false) {
+    const value = record[key];
+    if (value === undefined && !required)
+        return undefined;
+    if (typeof value !== 'string' || !value.trim())
+        throw new Error(`Domain profile '${key}' must be a non-empty string.`);
+    return value.trim();
+}
+function stringList(record, key, options = {}) {
+    const value = record[key];
+    if (value === undefined && !options.required)
+        return [];
+    if (!Array.isArray(value) || (options.required && value.length === 0)) {
+        throw new Error(`Domain profile '${key}' must be a${options.required ? ' non-empty' : ''} string array.`);
+    }
+    if (value.length > 64)
+        throw new Error(`Domain profile '${key}' allows at most 64 entries.`);
+    const entries = value.map((entry) => {
+        if (typeof entry !== 'string' || !entry.trim()) {
+            throw new Error(`Domain profile '${key}' must contain only non-empty strings.`);
+        }
+        const normalized = entry.trim();
+        if (normalized.length > 128)
+            throw new Error(`Domain profile '${key}' entries must be at most 128 characters.`);
+        if (options.toolNames && !TOOL_NAME.test(normalized)) {
+            throw new Error(`Domain profile '${key}' contains an invalid MCP tool name: ${normalized}`);
+        }
+        return normalized;
+    });
+    return [...new Set(entries)];
+}
+export function parseDomainProfile(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('Domain profile must be a JSON object.');
+    }
+    const record = value;
+    const systemContext = stringField(record, 'systemContext');
+    if (systemContext && systemContext.length > 20_000) {
+        throw new Error("Domain profile 'systemContext' must be at most 20000 characters.");
+    }
+    return {
+        name: stringField(record, 'name', true),
+        ...(stringField(record, 'description') ? { description: stringField(record, 'description') } : {}),
+        routingKeywords: stringList(record, 'routingKeywords', { required: true }),
+        readTools: stringList(record, 'readTools', { required: true, toolNames: true }),
+        ...(record.writeTools !== undefined
+            ? { writeTools: stringList(record, 'writeTools', { toolNames: true }) }
+            : {}),
+        ...(systemContext ? { systemContext } : {}),
+    };
+}
+//# sourceMappingURL=domain-profile.js.map

package/dist/domain-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-profile.js","sourceRoot":"","sources":["../src/domain-profile.ts"],"names":[],"mappings":"AASA,MAAM,SAAS,GAAG,0BAA0B,CAAC;AAE7C,SAAS,WAAW,CAAC,MAA+B,EAAE,GAAW,EAAE,QAAQ,GAAG,KAAK;IACjF,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,+BAA+B,CAAC,CAAC;IACvH,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,SAAS,UAAU,CACjB,MAA+B,EAC/B,GAAW,EACX,UAAuD,EAAE;IAEzD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IACxD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,cAAc,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;IAC5G,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,8BAA8B,CAAC,CAAC;IAC7F,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAClC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,wCAAwC,CAAC,CAAC;QAClF,CAAC;QACD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,UAAU,CAAC,MAAM,GAAG,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,2CAA2C,CAAC,CAAC;QAChH,IAAI,OAAO,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,wCAAwC,UAAU,EAAE,CAAC,CAAC;QAC9F,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,aAAa,GAAG,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC3D,IAAI,aAAa,IAAI,aAAa,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IACtF,CAAC;IACD,OAAO;QACL,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAE;QACxC,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClG,eAAe,EAAE,UAAU,CAAC,MAAM,EAAE,iBAAiB,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC1E,SAAS,EAAE,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QAC/E,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS;YACjC,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE;YACvE,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5C,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { parseDomainProfile, type DkgLocalLlmDomainProfile, } from './domain-profile.js';
+export { rewriteCompactPredicatesForDkg, validateDkgToolCall, validateSparqlForDkg, type DkgToolValidationResult, } from './dkg-tool-validation.js';
+export { DkgLocalLlmRuntime, normalizeFinalAnswer, type DkgChatEvidence, type DkgChatSessionInfo, type DkgChatTurn, type DkgLocalLlmOptions, type DkgLocalLlmResult, type McpClientLike, } from './runtime.js';
+export { probeLocalModelEndpoint, type LocalModelEndpointAvailability, type LocalModelEndpointProbeStrategy, type ProbeLocalModelEndpointOptions, } from './model-endpoint.js';
+export { normalizeToolForLlama, parseAndValidateToolArguments, stableJson, validateAgainstSchema, type JsonSchema, type McpToolAnnotations, type McpToolDefinition, type OpenAiToolDefinition, } from './schema.js';
+export { DKG_LOCAL_LLM_SYSTEM_CONTEXT_VERSION, dkgLocalLlmSystemContext, } from './system-context.js';
+export { classifyTool, createToolRouter, isMutatingTool, routeTools, type ResolvedToolProfile, type ToolCategory, type ToolProfile, type ToolRoute, type ToolRouteRequest, } from './tool-router.js';
+export { createRelevanceRanker, tokenizeToolText, type RelevanceDocument, type RelevanceRankOptions, type RelevanceRankResult, type RelevanceRankedItem, } from './relevance-router.js';
+export { NOOP_TRACE, TextInteractionTrace, redactSecrets, type InteractionTrace, } from './text-trace.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,KAAK,wBAAwB,GAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,8BAA8B,EAC9B,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,uBAAuB,GAC7B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,aAAa,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,uBAAuB,EACvB,KAAK,8BAA8B,EACnC,KAAK,+BAA+B,EACpC,KAAK,8BAA8B,GACpC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,qBAAqB,EACrB,6BAA6B,EAC7B,UAAU,EACV,qBAAqB,EACrB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,GAC1B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,oCAAoC,EACpC,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,GACzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,UAAU,EACV,oBAAoB,EACpB,aAAa,EACb,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export { parseDomainProfile, } from './domain-profile.js';
+export { rewriteCompactPredicatesForDkg, validateDkgToolCall, validateSparqlForDkg, } from './dkg-tool-validation.js';
+export { DkgLocalLlmRuntime, normalizeFinalAnswer, } from './runtime.js';
+export { probeLocalModelEndpoint, } from './model-endpoint.js';
+export { normalizeToolForLlama, parseAndValidateToolArguments, stableJson, validateAgainstSchema, } from './schema.js';
+export { DKG_LOCAL_LLM_SYSTEM_CONTEXT_VERSION, dkgLocalLlmSystemContext, } from './system-context.js';
+export { classifyTool, createToolRouter, isMutatingTool, routeTools, } from './tool-router.js';
+export { createRelevanceRanker, tokenizeToolText, } from './relevance-router.js';
+export { NOOP_TRACE, TextInteractionTrace, redactSecrets, } from './text-trace.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,GAEnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,8BAA8B,EAC9B,mBAAmB,EACnB,oBAAoB,GAErB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,kBAAkB,EAClB,oBAAoB,GAOrB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,uBAAuB,GAIxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,qBAAqB,EACrB,6BAA6B,EAC7B,UAAU,EACV,qBAAqB,GAKtB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,oCAAoC,EACpC,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,UAAU,GAMX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,qBAAqB,EACrB,gBAAgB,GAKjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,UAAU,EACV,oBAAoB,EACpB,aAAa,GAEd,MAAM,iBAAiB,CAAC"}

package/dist/model-endpoint.d.ts

@@ -0,0 +1,33 @@
+export type LocalModelEndpointProbeStrategy = Readonly<{
+    kind: 'auto';
+}> | Readonly<{
+    kind: 'ollama';
+}> | Readonly<{
+    kind: 'llama.cpp';
+}>;
+export type LocalModelEndpointAvailability = Readonly<{
+    status: 'ready';
+    reachable: true;
+}> | Readonly<{
+    status: 'not-ready';
+    reachable: true;
+    error: string;
+}> | Readonly<{
+    status: 'offline';
+    reachable: false;
+    error: string;
+}>;
+export interface ProbeLocalModelEndpointOptions {
+    chatCompletionsUrl: string;
+    model: string;
+    strategy?: LocalModelEndpointProbeStrategy;
+    fetch?: typeof fetch;
+    timeoutMs?: number;
+}
+/**
+ * Probe the exact configured model through an explicit backend strategy.
+ * `auto` preserves legacy llama.cpp and Ollama configuration; callers that know
+ * their backend can select its strategy without exposing endpoint details.
+ */
+export declare function probeLocalModelEndpoint(options: ProbeLocalModelEndpointOptions): Promise<LocalModelEndpointAvailability>;
+//# sourceMappingURL=model-endpoint.d.ts.map

package/dist/model-endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-endpoint.d.ts","sourceRoot":"","sources":["../src/model-endpoint.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,+BAA+B,GACvC,QAAQ,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAC1B,QAAQ,CAAC;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,GAC5B,QAAQ,CAAC;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC,CAAC;AAEpC,MAAM,MAAM,8BAA8B,GACtC,QAAQ,CAAC;IACT,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB,CAAC,GACA,QAAQ,CAAC;IACT,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,IAAI,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,GACA,QAAQ,CAAC;IACT,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,KAAK,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAAC;AAEL,MAAM,WAAW,8BAA8B;IAC7C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,+BAA+B,CAAC;IAC3C,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAuHD;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,8BAA8B,CAAC,CAqFzC"}