dsh-local-ai 0.1.0

package/README.hi.md

@@ -0,0 +1,211 @@
+<div align="center">
+
+# 🤖 dsh-local-ai
+
+**DeepSeek Harness के लिए स्थानीय-मॉडल (Ollama) एकीकरण।**
+
+*स्थानीय मॉडल खोजें, खींचें, हटाएँ और जाँचें; कार्य-प्रकार या कीवर्ड के आधार पर अनुरोधों को स्थानीय मॉडल पर रूट करें और विफलता पर स्वतः क्लाउड पर वापस लौटें; `/ollama` से एक-झटके में स्थिति सारांश पाएँ।*
+
+[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
+[![DSH plugin](https://img.shields.io/badge/dsh-plugin-✅-green)](https://github.com/topics/dsh-plugin)
+[![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-brightgreen.svg)](#)
+[![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-local-ai/ci.yml?branch=main&label=CI)](https://github.com/PerryLink/dsh-local-ai/actions)
+[![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-local-ai?label=version)](https://github.com/PerryLink/dsh-local-ai/releases)
+[![npm version](https://img.shields.io/npm/v/dsh-local-ai)](https://www.npmjs.com/package/dsh-local-ai)
+[![npm downloads](https://img.shields.io/npm/dm/dsh-local-ai)](https://www.npmjs.com/package/dsh-local-ai)
+
+[English](README.md) · [简体中文](README.zh.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
+
+</div>
+
+---
+
+## Compatibility
+
+| सतह | स्थिति |
+|---|---|
+| Harness | DeepSeek Harness `0.1.0-rc.6` |
+| Node | `^22.19.0 \|\| >=24.0.0` |
+| Backend | [Ollama](https://ollama.com) (स्थानीय HTTP API + CLI जाँच) |
+| Model | केवल-पाठ रूट (`inputModalities: ['text']`); टूल कॉल व परिणाम समर्थित हैं |
+
+## What you get
+
+`dsh-local-ai` Ollama को DeepSeek Harness में एक प्रथम-श्रेणी स्थानीय प्रदाता बनाता है:
+
+- **खोज व प्रबंधन** — `ollama_list` (इंस्टॉल किए मॉडल, चालू मॉडल, डिस्क उपयोग), `ollama_show` (पैरामीटर आकार, क्वांटाइज़ेशन, संदर्भ लंबाई), `ollama_pull`, और `ollama_remove`।
+- **स्वास्थ्य जाँच** — प्रक्रिया की सक्रियता (`ollama` CLI के ज़रिए) और API प्रतिक्रिया (`/api/version` के ज़रिए), दो स्वतंत्र संकेतों के रूप में।
+- **आधिकारिक एडाप्टर** — `ollama` प्रदाता रूट `ctx.llm.registerAdapter` (`LlmAdapter`) से पंजीकृत होता है, जिसमें कॉन्फ़िगर करने योग्य मॉडल मैपिंग और temperature / max-tokens / stop अनुवाद होता है।
+- **स्थानीय रूटिंग** — `model_route` नियम कार्य-प्रकार (`purpose`), केस-असंवेदी कीवर्ड, या `always` के आधार पर अनुरोधों को स्थानीय मॉडल पर रूट करते हैं, और स्थानीय रूट सामग्री बनाने से पहले विफल होने पर स्वतः क्लाउड पर वापस लौटते हैं।
+- **`/ollama` कमांड** — एक-झटके में स्थिति सारांश: मॉडल, डिस्क उपयोग, स्वास्थ्य और सुझाव।
+- **शून्य निर्भरता, HTTP पहले** — सब कुछ Ollama की HTTP API से बात करता है (CLI केवल प्रक्रिया जाँच के लिए); कोई मॉडल फ़ाइल बंडल नहीं की जाती।
+
+```text
+request (loop)
+   │ llm/stream जलप्रपात
+   ├─ नियम मेल? ──▶ ollama पर रूट ──▶ Ollama /api/chat (NDJSON स्ट्रीम)
+   │                        └─ पहले विफल ─▶ क्लाउड पर वापस (next())
+   └─ कोई मेल नहीं ──▶ क्लाउड प्रदाता
+tools ──▶ /api/tags · /api/ps · /api/show · /api/pull · /api/delete
+health ──▶ /api/version (API) + ollama list (प्रक्रिया)
+```
+
+## Quick start
+
+```sh
+# 1. अपने प्रोफ़ाइल में बंडल इंस्टॉल करें
+dsh plugin --profile web add "github:PerryLink/dsh-local-ai#main"
+
+# या npm से (प्रकाशित संस्करण)
+dsh plugin --profile web add dsh-local-ai
+
+# 2. अपने प्रोफ़ाइल पैच (cordis.yml) में रूटिंग कॉन्फ़िगर करें और पुनः आरंभ करें
+dsh --profile web
+```
+
+न्यूनतम रूटिंग कॉन्फ़िगरेशन (नियम `cordis.patch.yml` में टिप्पणी के रूप में होता है):
+
+```yaml
+- insert:
+    - id: dsh-local-ai
+      name: dsh-local-ai
+      config:
+        route:
+          - model: llama3.2
+            keywords: ["confidential", "offline"]
+```
+
+फिर पुष्टि करें कि पंक्ति माउंट हुई:
+
+```sh
+dsh --profile web --dump-config | grep -A2 'id: dsh-local-ai'
+```
+
+## Install & uninstall
+
+- **git चैनल** (नवीनतम `main`): `dsh plugin --profile web add "github:PerryLink/dsh-local-ai#main"` — `prepare` स्क्रिप्ट केवल उत्पादन निर्भरताओं से बनाती है।
+- **npm चैनल** (प्रकाशित संस्करण): `dsh plugin --profile web add dsh-local-ai`।
+- **tarball चैनल**: इस रिपो में `pnpm pack`, फिर `dsh plugin --profile web add ./dsh-local-ai-<version>.tgz`।
+- **अनइंस्टॉल**: `dsh plugin --profile web remove dsh-local-ai` (या प्रोफ़ाइल पैच से पंक्ति हटाएँ)।
+
+> यदि pnpm इस पैकेज के लिए `ERR_PNPM_IGNORED_BUILDS` दिखाए, तो अपने `pnpm-workspace.yaml` में `allowBuilds: { esbuild: true }` जोड़ें — `dsh` CLI सटीक स्निपेट प्रिंट करता है।
+
+## Configuration
+
+सभी ट्यूनेबल Schemastery `Config` फ़ील्ड हैं (cordis.yml से बदले जा सकते हैं)। id-लक्षित ओवरराइड पूरी पंक्ति को बदल देता है — जिन कुंजियों की ज़रूरत हो उन्हें दोबारा लिखें। `cordis.patch.yml` हर कुंजी को इनलाइन दस्तावेज़ करता है।
+
+| Key | Default | Meaning |
+|---|---|---|
+| `baseURL` | `http://127.0.0.1:11434` | Ollama HTTP API आधार URL; `/api/*` पथ जोड़े जाते हैं |
+| `requestTimeoutMs` | `30000` | प्रति-अनुरोध HTTP टाइमआउट (मिलीसेकंड) |
+| `graceMs` | `15000` | स्वास्थ्य-जाँच CLI जाँच के लिए सबप्रोसेस समाप्ति की छूट |
+| `defaultContextWindow` | `8192` | जब मॉडल का कोई सटीक मान न हो तो संदर्भ क्षमता |
+| `maxTokens` | `4096` | जब मॉडल का कोई सटीक मान न हो तो प्रति-अनुरोध आउटपुट सीमा |
+| `temperature` | *(none)* | डिफ़ॉल्ट सैंपलिंग तापमान (0..2); छोड़ने पर प्रदाता डिफ़ॉल्ट रहता है |
+| `models` | `[]` | Harness-दृश्य नाम → Ollama मॉडल मैपिंग |
+| `models[].name` | *(required)* | Harness-दृश्य मॉडल नाम (`GenerateOptions.model`) |
+| `models[].model` | `= name` | Ollama मॉडल id |
+| `models[].contextWindow` | *(none)* | प्रति-मॉडल संदर्भ क्षमता |
+| `models[].maxTokens` | *(none)* | प्रति-मॉडल आउटपुट सीमा |
+| `models[].temperature` | *(none)* | प्रति-मॉडल सैंपलिंग तापमान |
+| `route` | `[]` | स्थानीय-मॉडल रूटिंग नियम (पहला मेल जीतता है) |
+| `route[].model` | *(required)* | लक्ष्य स्थानीय मॉडल नाम |
+| `route[].purpose` | *(none)* | कार्य-प्रकार मेल: `compaction` / `session-title` |
+| `route[].keywords` | `[]` | केस-असंवेदी अनुरोध कीवर्ड |
+| `route[].always` | `false` | हर पात्र अनुरोध को इस मॉडल पर रूट करें |
+
+## Tools & surfaces
+
+| सतह | प्रकार | क्या करता है |
+|---|---|---|
+| `ollama_list` | टूल | इंस्टॉल किए मॉडल, चालू मॉडल और डिस्क उपयोग सूचीबद्ध करता है |
+| `ollama_show` | टूल | पैरामीटर आकार, क्वांटाइज़ेशन, संदर्भ लंबाई, family, format दिखाता है |
+| `ollama_pull` | टूल | मॉडल खींचता (डाउनलोड करता) है |
+| `ollama_remove` | टूल | मॉडल हटाता है |
+| `ollama_health` | टूल | प्रक्रिया सक्रियता + API प्रतिक्रिया |
+| `/ollama` | कमांड | एक-झटके में स्थिति सारांश (मॉडल + स्वास्थ्य + सुझाव) |
+
+**उपभोग करता है** सार्वजनिक host सेवाएँ `ctx.llm` (`registerAdapter`), `ctx.tools`, `ctx.subprocess` (CLI जाँच), और `ctx.commands`। यह डिफ़ॉल्ट रूप से `llm/stream` को शॉर्ट-सर्किट नहीं करता — रूटिंग श्रोता तब तक आगे बढ़ाता है (`next()`) जब तक कोई नियम मेल न खाए।
+
+## Permissions & data
+
+- **अनुमतियाँ**: आपके द्वारा कॉन्फ़िगर किए गए Ollama एंडपॉइंट के लिए `network:outbound`; कोई नेटिव कोड नहीं, कोई फ़ाइल-सिस्टम पहुँच नहीं, कोई स्टोरेज नहीं।
+- **डेटा**: मॉडल या उपयोगकर्ता को दिखाई गई हर मॉडल सूची/विवरण, स्वास्थ्य तथ्य और त्रुटि संदेश दिखाने से पहले सैनिटाइज़ होते हैं (एंडपॉइंट userinfo व गुप्त क्वेरी पैरामीटर हटाए जाते हैं, नियंत्रण वर्ण हटाए जाते हैं, लंबाई सीमित होती है)। टूल व कमांड परिणाम harness के अपने tool/command तंत्र द्वारा लॉग होते हैं।
+- **क्रेडेंशियल**: प्लगइन कोई क्रेडेंशियल संग्रहीत या पढ़ता नहीं है। यह केवल आपके कॉन्फ़िगर किए एंडपॉइंट पर HTTP अनुरोध भेजता है, साथ ही स्थानीय `ollama list` प्रक्रिया जाँच करता है।
+
+## Security boundaries
+
+- **डिफ़ॉल्ट रूप से कोई पुनः-रूटिंग नहीं** — `route` सूची तब तक खाली है जब तक आप सहमति न दें; अनुरोध स्थानीय मॉडल तक केवल किसी स्पष्ट नियम या `ollama` प्रदाता के स्पष्ट चयन से पहुँचता है।
+- **दिखाने से पहले सैनिटाइज़** — एंडपॉइंट पते व स्थानीय पथ टूल आउटपुट, `/ollama` कमांड या त्रुटि संदेशों तक पहुँचने से पहले सैनिटाइज़ होते हैं।
+- **शून्य बंडल मॉडल** — डाउनलोड व स्टोरेज Ollama की अपनी ज़िम्मेदारी है; पैकेज में कुछ नहीं भेजा जाता।
+- **विफलता ज़ोरदार, विफलता सीमित** — अमान्य कॉन्फ़िग माउंट को विफल करता है; सामग्री बनाने से पहले विफल स्थानीय रूट क्लाउड पर वापस लौटता है (`next()`), इसलिए बंद Ollama कभी बातचीत को अटकाता नहीं।
+- **मॉडल-दृश्य ⟺ लॉग** — रूटिंग केवल यह बदलती है कि कौन-सा प्रदाता अनुरोध सेवा करता है (assistant संदेश अपनी `ollama` उत्पत्ति के साथ लॉग होता है); कोई नया मॉडल-दृश्य इनपुट नहीं गढ़ा जाता।
+
+## Known limitations
+
+- **केवल rc.6** — `@deepseek-ai/dsh@0.1.0-rc.6` के विरुद्ध विकसित व परीक्षित; नए harness बेसलाइन काम करने की अपेक्षा है, पर मासिक compat workflow उन्हें सत्यापित करता है।
+- **केवल-पाठ रूट** — छवि सामग्री अस्वीकृत होती है (`UNSUPPORTED_CONTENT`); मल्टीमॉडल स्थानीय मॉडल अभी जुड़े नहीं हैं।
+- **मध्य-स्ट्रीम वापसी** — एक बार स्थानीय रूट सामग्री बनाना शुरू कर दे, तो बाद की विफलता आगे भेजी जाती है (वापस नहीं ली जाती); केवल पहले टोकन से पहले की विफलता क्लाउड पर लौटती है।
+
+## Development
+
+```sh
+pnpm install        # node ^22.19 || >=24
+pnpm run typecheck  # tsc: src + परीक्षण, प्रकाशित 0.1.0-rc.6 प्रकारों के विरुद्ध
+pnpm run typecheck:ci  # सख्त tsc, प्रकाशित rc.6 प्रकारों के विरुद्ध (skipLibCheck बंद)
+pnpm test           # vitest: वास्तविक Context/LlmRuntime/ToolRuntime/CommandRuntime/subprocess सीम
+pnpm run test:coverage  # कवरेज द्वार (90/80/90/90)
+pnpm run build      # tsdown बंडल + tsc घोषणाएँ (lib/)
+pnpm run verify:self-contained  # निर्भरता विनिर्देश registry से हल होते हैं
+pnpm run verify:artifacts       # निर्मित ESM फलक + बंडल पैच मौजूद
+node scripts/check-readme-sync.mjs  # पाँच-भाषा README समन्वय द्वार
+pnpm pack           # प्रकाशित tarball
+```
+
+## Topics
+
+`dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `ollama`, `local-llm`, `local-models`, `offline`, `privacy`, `model-routing`
+
+## Contributors
+
+- [@PerryLink](https://github.com/PerryLink) — निर्माता व अनुरक्षक: एडाप्टर, रूटिंग, टूल, स्वास्थ्य जाँच, सैनिटाइज़ेशन और पाँच-भाषा दस्तावेज़।
+
+## PerryLink DSH Plugin Family
+
+यह प्रोजेक्ट [PerryLink](https://github.com/PerryLink) द्वारा अनुरक्षित [29 DeepSeek Harness प्लगइनों](https://github.com/PerryLink) में से एक है। अगर यह आपकी मदद करता है, तो बाकी भी करेंगे:
+
+| Plugin | One-liner |
+|---|---|
+| [dsh-auto-review](https://github.com/PerryLink/dsh-auto-review) | अनुमोदन श्रृंखला पर दूसरे मॉडल से स्वतः-समीक्षा, डिफ़ॉल्ट रूप से असफल-बंद |
+| [dsh-background-agents](https://github.com/PerryLink/dsh-background-agents) | Web UI साइडबार, संदेश और रुकावट के साथ स्थायी पृष्ठभूमि चाइल्ड एजेंट |
+| [dsh-budget](https://github.com/PerryLink/dsh-budget) | DeepSeek Harness के लिए लागत प्रशासन: बजट, कार्बन और विलंबता एक पैनल में। |
+| [dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind) | Claude Code /rewind-समतुल्य: स्नैपशॉट, सत्र फोर्क, एक-बार पुनर्स्थापन |
+| [dsh-claude-move](https://github.com/PerryLink/dsh-claude-move) | Claude Code सत्र, स्मृति, skills और CLAUDE.md को DSH में स्थानांतरित करें |
+| [dsh-click](https://github.com/PerryLink/dsh-click) | DeepSeek Harness के लिए क्रॉस-प्लेटफ़ॉर्म नेटिव डेस्कटॉप नियंत्रण — Windows पहले। |
+| [dsh-composer-history](https://github.com/PerryLink/dsh-composer-history) | Web कंपोज़र के लिए टर्मिनल-शैली इनपुट इतिहास: तीर, Ctrl+R खोज |
+| [dsh-defend](https://github.com/PerryLink/dsh-defend) | DeepSeek Harness के लिए प्रॉम्प्ट-इंजेक्शन, जेलब्रेक और सीक्रेट-लीक रक्षा। |
+| [dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck) | इंजीनियरिंग-अनुशासन गार्ड: आवश्यकताएँ पूछताछ, परीक्षण द्वार, विरोधी समीक्षा |
+| [dsh-draw](https://github.com/PerryLink/dsh-draw) | DeepSeek Harness के लिए एकीकृत स्थैतिक-छवि निर्माण रूटिंग। |
+| [dsh-fast](https://github.com/PerryLink/dsh-fast) | DeepSeek Harness के लिए केवल-पठन प्रदर्शन निदान। |
+| [dsh-github](https://github.com/PerryLink/dsh-github) | DSH के लिए GitHub PR/issues एकीकरण, हर लेखन अनुमोदन-द्वारित |
+| [dsh-library](https://github.com/PerryLink/dsh-library) | DeepSeek Harness के लिए स्थानीय दस्तावेज़ ज्ञानकोश। |
+| **[dsh-local-ai](https://github.com/PerryLink/dsh-local-ai)** | DeepSeek Harness के लिए स्थानीय-मॉडल (Ollama) एकीकरण। |
+| [dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions) | भाषा सर्वरों पर LSP निदान, फ़ॉर्मेटिंग, पूर्णता, कोड क्रियाएँ और नाम बदलना |
+| [dsh-mask](https://github.com/PerryLink/dsh-mask) | DeepSeek Harness के लिए PII मास्किंग मिडलवेयर — मॉडल तक पहुँचने से पहले व्यक्तिगत डेटा अनाम करता है, प्रदर्शन परत पर बहाल करता है। |
+| [dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel) | केवल-पठन MCP रनटाइम पैनल: /mcp कमांड + स्थिति, टूल और त्रुटियों वाला सेटिंग टैब |
+| [dsh-memento](https://github.com/PerryLink/dsh-memento) | अनुमोदन-द्वारित क्रॉस-सत्र स्मृति: ctx.memory seam + SQLite + memory टूल |
+| [dsh-observe](https://github.com/PerryLink/dsh-observe) | DeepSeek Harness के लिए OpenTelemetry और Langfuse अवलोकनीयता निर्यातक। |
+| [dsh-output-styles](https://github.com/PerryLink/dsh-output-styles) | Claude Code outputStyles-समतुल्य रनटाइम शैली स्विचिंग |
+| [dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules) | Claude Code-शैली घोषणात्मक allow/deny/ask अनुमति नियम, ऑडिट के साथ |
+| [dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide) | माँग-पर एजेंट स्किल के रूप में प्लगइन-विकास ज्ञानकोश |
+| [dsh-score](https://github.com/PerryLink/dsh-score) | DeepSeek Harness प्लगइनों के लिए बहु-आयामी गुणवत्ता स्कोरिंग। |
+| [dsh-session-pin](https://github.com/PerryLink/dsh-session-pin) | Web साइडबार में सत्र पिन करें, स्थायी क्रम के साथ |
+| [dsh-session-sync](https://github.com/PerryLink/dsh-session-sync) | DeepSeek Harness के लिए क्रॉस-डिवाइस सत्र सिंक — आपके सत्र स्टोर का एक समर्पित git मिरर। |
+| [dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security) | सुरक्षा-ऑडिट स्किल पैक: सीक्रेट स्कैन, निर्भरता और आपूर्ति-श्रृंखला समीक्षा |
+| [dsh-talk](https://github.com/PerryLink/dsh-talk) | DeepSeek Harness के लिए आवाज़-प्रथम सत्र लूप: बोलें और उत्तर सुनें। |
+| [dsh-test-drive](https://github.com/PerryLink/dsh-test-drive) | DeepSeek Harness प्लगइनों के लिए पृथक इंस्टॉल-और-स्मोक परीक्षण। |
+| [dsh-translate](https://github.com/PerryLink/dsh-translate) | DeepSeek Harness के लिए वेंडर पैरामीटर अनुवाद और नियतात्मक JSON मरम्मत। |
+
+## License
+
+[Apache License 2.0](LICENSE) © 2026 dsh-local-ai contributors

package/README.md

@@ -0,0 +1,211 @@
+<div align="center">
+
+# 🤖 dsh-local-ai
+
+**Local-model (Ollama) integration for DeepSeek Harness.**
+
+*Discover, pull, remove, and inspect local models, route requests to them by task type or keyword with automatic fallback to the cloud, and get a one-shot status overview via `/ollama`.*
+
+[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
+[![DSH plugin](https://img.shields.io/badge/dsh-plugin-✅-green)](https://github.com/topics/dsh-plugin)
+[![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-brightgreen.svg)](#)
+[![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-local-ai/ci.yml?branch=main&label=CI)](https://github.com/PerryLink/dsh-local-ai/actions)
+[![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-local-ai?label=version)](https://github.com/PerryLink/dsh-local-ai/releases)
+[![npm version](https://img.shields.io/npm/v/dsh-local-ai)](https://www.npmjs.com/package/dsh-local-ai)
+[![npm downloads](https://img.shields.io/npm/dm/dsh-local-ai)](https://www.npmjs.com/package/dsh-local-ai)
+
+[English](README.md) · [简体中文](README.zh.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
+
+</div>
+
+---
+
+## Compatibility
+
+| Surface | Status |
+|---|---|
+| Harness | DeepSeek Harness `0.1.0-rc.6` |
+| Node | `^22.19.0 \|\| >=24.0.0` |
+| Backend | [Ollama](https://ollama.com) (local HTTP API + CLI probe) |
+| Model | Text-only route (`inputModalities: ['text']`); tool calls and tool results are supported |
+
+## What you get
+
+`dsh-local-ai` makes Ollama a first-class local provider in DeepSeek Harness:
+
+- **Discovery & management** — `ollama_list` (installed models, running models, disk usage), `ollama_show` (parameter size, quantization, context length), `ollama_pull`, and `ollama_remove`.
+- **Health check** — process liveness (via the `ollama` CLI) and API responsiveness (via `/api/version`), reported as two independent signals.
+- **Official adapter** — the `ollama` provider route is registered through `ctx.llm.registerAdapter` (`LlmAdapter`), with configurable model mapping and temperature / max-tokens / stop translation.
+- **Local routing** — `model_route` rules route requests to a local model by task type (`purpose`), case-insensitive keyword, or `always`, with automatic fallback to the cloud when the local route fails before producing content.
+- **`/ollama` command** — a one-shot status overview: models, disk usage, health, and suggestions.
+- **Zero dependencies, HTTP first** — everything talks to Ollama's HTTP API (the CLI is used only for the process probe); no model files are bundled.
+
+```text
+request (loop)
+   │ llm/stream waterfall
+   ├─ rule matches? ──▶ route to ollama ──▶ Ollama /api/chat (NDJSON stream)
+   │                        └─ fails first ─▶ fall back to cloud (next())
+   └─ no match ──▶ cloud provider
+tools ──▶ /api/tags · /api/ps · /api/show · /api/pull · /api/delete
+health ──▶ /api/version (API) + ollama list (process)
+```
+
+## Quick start
+
+```sh
+# 1. install the bundle into your profile
+dsh plugin --profile web add "github:PerryLink/dsh-local-ai#main"
+
+# or from npm (published releases)
+dsh plugin --profile web add dsh-local-ai
+
+# 2. configure routing in your profile patch (cordis.yml) and restart
+dsh --profile web
+```
+
+Minimal routing configuration (the rule ships commented out in `cordis.patch.yml`):
+
+```yaml
+- insert:
+    - id: dsh-local-ai
+      name: dsh-local-ai
+      config:
+        route:
+          - model: llama3.2
+            keywords: ["confidential", "offline"]
+```
+
+Then verify the row mounts:
+
+```sh
+dsh --profile web --dump-config | grep -A2 'id: dsh-local-ai'
+```
+
+## Install & uninstall
+
+- **git channel** (latest `main`): `dsh plugin --profile web add "github:PerryLink/dsh-local-ai#main"` — the `prepare` script builds with production dependencies only.
+- **npm channel** (published releases): `dsh plugin --profile web add dsh-local-ai`.
+- **tarball channel**: `pnpm pack` in this repo, then `dsh plugin --profile web add ./dsh-local-ai-<version>.tgz`.
+- **uninstall**: `dsh plugin --profile web remove dsh-local-ai` (or remove the row from the profile patch).
+
+> If pnpm reports `ERR_PNPM_IGNORED_BUILDS` for this package, add `allowBuilds: { esbuild: true }` to your `pnpm-workspace.yaml` — the `dsh` CLI prints the exact snippet.
+
+## Configuration
+
+All tunables are Schemastery `Config` fields (changeable from cordis.yml). An id-targeted override replaces the whole row — restate every key you need. `cordis.patch.yml` documents each key inline.
+
+| Key | Default | Meaning |
+|---|---|---|
+| `baseURL` | `http://127.0.0.1:11434` | Ollama HTTP API base URL; `/api/*` paths are appended |
+| `requestTimeoutMs` | `30000` | Per-request HTTP timeout (milliseconds) |
+| `graceMs` | `15000` | Subprocess terminate grace for the health-check CLI probe |
+| `defaultContextWindow` | `8192` | Context capacity used when a model has no exact value |
+| `maxTokens` | `4096` | Per-request output cap used when a model has no exact value |
+| `temperature` | *(none)* | Default sampling temperature (0..2); omitted leaves the provider default |
+| `models` | `[]` | Harness-visible → Ollama model mappings |
+| `models[].name` | *(required)* | Harness-visible model name (`GenerateOptions.model`) |
+| `models[].model` | `= name` | Ollama model id |
+| `models[].contextWindow` | *(none)* | Per-model context capacity |
+| `models[].maxTokens` | *(none)* | Per-model output cap |
+| `models[].temperature` | *(none)* | Per-model sampling temperature |
+| `route` | `[]` | Local-model routing rules (first match wins) |
+| `route[].model` | *(required)* | Target local model name |
+| `route[].purpose` | *(none)* | Task type match: `compaction` / `session-title` |
+| `route[].keywords` | `[]` | Case-insensitive request keywords |
+| `route[].always` | `false` | Route every eligible request to this model |
+
+## Tools & surfaces
+
+| Surface | Kind | What it does |
+|---|---|---|
+| `ollama_list` | tool | List installed models, running models, and disk usage |
+| `ollama_show` | tool | Show parameter size, quantization, context length, family, format |
+| `ollama_pull` | tool | Pull (download) a model |
+| `ollama_remove` | tool | Remove a model |
+| `ollama_health` | tool | Process liveness + API responsiveness |
+| `/ollama` | command | One-shot status overview (models + health + suggestions) |
+
+**Consumes** the public host services `ctx.llm` (`registerAdapter`), `ctx.tools`, `ctx.subprocess` (CLI probe), and `ctx.commands`. It registers no `llm/stream` short-circuit by default — the routing listener passes through (`next()`) unless a rule matches.
+
+## Permissions & data
+
+- **Permissions**: `network:outbound` to the Ollama endpoint you configure; no native code, no filesystem access, no storage.
+- **Data**: every model list/detail, health fact, and error message shown to the model or the user is sanitized (endpoint userinfo and secret query params dropped, control characters stripped, lengths bounded) before display. Tool and command results are logged by the harness's own tool/command seams.
+- **Credentials**: the plugin stores and reads no credentials. It only issues HTTP requests to the endpoint you configure, plus the local `ollama list` process probe.
+
+## Security boundaries
+
+- **No re-routing by default** — the `route` list is empty unless you opt in; a request reaches a local model only through an explicit rule or an explicit `ollama` provider selection.
+- **Sanitize before display** — endpoint addresses and local paths are sanitized before they reach tool output, the `/ollama` command, or error messages.
+- **Zero bundled models** — downloads and storage are Ollama's own responsibility; nothing is shipped in the package.
+- **Failure loud, failure contained** — invalid config fails the mount; a local route that fails before producing content falls back to the cloud (`next()`), so a down Ollama never bricks a conversation.
+- **Model-visible ⟺ logged** — routing only changes which provider serves a request (the assistant message is logged with its `ollama` provenance); no new model-visible input is invented.
+
+## Known limitations
+
+- **rc.6 only** — developed and tested against `@deepseek-ai/dsh@0.1.0-rc.6`; newer harness baselines are expected to work but are verified by the monthly compat workflow.
+- **Text-only route** — image content is rejected (`UNSUPPORTED_CONTENT`); multimodal local models are not wired up yet.
+- **Mid-stream fallback** — once a local route has started producing content, a later failure is forwarded (not retracted); only a failure before the first token falls back to the cloud.
+
+## Development
+
+```sh
+pnpm install        # node ^22.19 || >=24
+pnpm run typecheck  # tsc: src + tests against the published 0.1.0-rc.6 types
+pnpm run typecheck:ci  # strict tsc against published rc.6 types (skipLibCheck off)
+pnpm test           # vitest: real Context/LlmRuntime/ToolRuntime/CommandRuntime/subprocess seams
+pnpm run test:coverage  # coverage gate (90/80/90/90)
+pnpm run build      # tsdown bundle + tsc declarations (lib/)
+pnpm run verify:self-contained  # dependency specs resolve from the registry
+pnpm run verify:artifacts       # built ESM face + bundle patch present
+node scripts/check-readme-sync.mjs  # five-language README sync gate
+pnpm pack           # the published tarball
+```
+
+## Topics
+
+`dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `ollama`, `local-llm`, `local-models`, `offline`, `privacy`, `model-routing`
+
+## Contributors
+
+- [@PerryLink](https://github.com/PerryLink) — creator and maintainer: adapter, routing, tools, health check, sanitization, and the five-language docs.
+
+## PerryLink DSH Plugin Family
+
+This project is one of the [29 DeepSeek Harness plugins](https://github.com/PerryLink) maintained by [PerryLink](https://github.com/PerryLink). If this one helps you, the others likely will too:
+
+| Plugin | One-liner |
+|---|---|
+| [dsh-auto-review](https://github.com/PerryLink/dsh-auto-review) | Second-model auto-review on the approval chain, fail-closed by default |
+| [dsh-background-agents](https://github.com/PerryLink/dsh-background-agents) | Durable background child agents with a Web UI sidebar, messaging and interrupt |
+| [dsh-budget](https://github.com/PerryLink/dsh-budget) | Cost governance for DeepSeek Harness: budgets, carbon, and latency in one panel. |
+| [dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind) | Claude Code /rewind-equivalent: snapshots, session forks, one-shot restore |
+| [dsh-claude-move](https://github.com/PerryLink/dsh-claude-move) | Migrate Claude Code sessions, memory, skills and CLAUDE.md into DSH |
+| [dsh-click](https://github.com/PerryLink/dsh-click) | Cross-platform native desktop control for DeepSeek Harness — Windows first. |
+| [dsh-composer-history](https://github.com/PerryLink/dsh-composer-history) | Terminal-style input history for the web composer: arrows, Ctrl+R search |
+| [dsh-defend](https://github.com/PerryLink/dsh-defend) | Prompt-injection, jailbreak, and secret-leak defense for DeepSeek Harness. |
+| [dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck) | Engineering-discipline guard: requirements grill, test gates, adversary review |
+| [dsh-draw](https://github.com/PerryLink/dsh-draw) | Unified static-image generation routing for DeepSeek Harness. |
+| [dsh-fast](https://github.com/PerryLink/dsh-fast) | Read-only performance diagnostics for DeepSeek Harness. |
+| [dsh-github](https://github.com/PerryLink/dsh-github) | GitHub PR/issues integration for DSH, every write gated by approval |
+| [dsh-library](https://github.com/PerryLink/dsh-library) | Local document knowledge base for DeepSeek Harness. |
+| **[dsh-local-ai](https://github.com/PerryLink/dsh-local-ai)** | Local-model (Ollama) integration for DeepSeek Harness. |
+| [dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions) | LSP diagnostics, formatting, completion, code actions and rename over language servers |
+| [dsh-mask](https://github.com/PerryLink/dsh-mask) | PII masking middleware for DeepSeek Harness — anonymize personal data before it reaches the model, restore it at the display layer. |
+| [dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel) | Read-only MCP runtime panel: /mcp command + Settings tab with status, tools and errors |
+| [dsh-memento](https://github.com/PerryLink/dsh-memento) | Approval-gated cross-session memory: ctx.memory seam + SQLite + memory tool |
+| [dsh-observe](https://github.com/PerryLink/dsh-observe) | OpenTelemetry and Langfuse observability exporter for DeepSeek Harness. |
+| [dsh-output-styles](https://github.com/PerryLink/dsh-output-styles) | Claude Code outputStyles-equivalent runtime style switching |
+| [dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules) | Claude Code-style declarative allow/deny/ask permission rules with audit |
+| [dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide) | Plugin-development knowledge base as an on-demand agent skill |
+| [dsh-score](https://github.com/PerryLink/dsh-score) | Multi-dimensional quality scoring for DeepSeek Harness plugins. |
+| [dsh-session-pin](https://github.com/PerryLink/dsh-session-pin) | Pin sessions in the Web sidebar with durable ordering |
+| [dsh-session-sync](https://github.com/PerryLink/dsh-session-sync) | Cross-device session sync for DeepSeek Harness — a dedicated git mirror of your session store. |
+| [dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security) | Security-audit skill pack: secret scan, dependency and supply-chain review |
+| [dsh-talk](https://github.com/PerryLink/dsh-talk) | Voice-first session loop for DeepSeek Harness: talk to it, hear it answer. |
+| [dsh-test-drive](https://github.com/PerryLink/dsh-test-drive) | Isolated install-and-smoke test drives for DeepSeek Harness plugins. |
+| [dsh-translate](https://github.com/PerryLink/dsh-translate) | Vendor parameter translation and deterministic JSON repair for DeepSeek Harness. |
+
+## License
+
+[Apache License 2.0](LICENSE) © 2026 dsh-local-ai contributors