@lihuu/dsh-ollama-cloud 0.1.0

package/README.md

@@ -0,0 +1,70 @@
+# @lihuu/dsh-ollama-cloud
+
+A [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) plugin that adds the **Ollama cloud** chat-completions provider, so the agent can use Ollama cloud models (DeepSeek, GLM, and more).
+
+## What it does
+
+- Registers the `ollama-cloud-direct` provider route on the LLM seam
+- Ships with a default model catalog: DeepSeek-V4-Flash (cloud), DeepSeek-V4-Pro (cloud), GLM-5.2 (cloud)
+- Reads the API key through the harness credential seam, per request — a changed key takes effect without a restart
+- Model ids without a `:cloud` suffix are sent as `id:cloud` (e.g. `deepseek-v4-flash` → `deepseek-v4-flash:cloud`)
+
+## Requirements
+
+- [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 0.1.2+
+- An [Ollama cloud](https://ollama.com) API key
+
+## Install
+
+The package is a **bundle**: it ships its own configuration layer, so installing it into a profile activates the plugin automatically.
+
+```sh
+dsh plugin --profile web add @lihuu/dsh-ollama-cloud
+```
+
+`dsh plugin add` appends the bundle to the profile's layer stack (`dsh.profile.bundles`), and the bundle's patch file mounts the plugin row. No manual patch editing is needed.
+
+> If you previously mounted this plugin by hand (an `llm-ollama-cloud` row in `~/.dsh/cordis.patch.yml`), remove that row before installing the bundle — the duplicate row id fails the boot.
+
+Restart the web service once after installing (bundle layers are composed at boot).
+
+## Configuration
+
+### 1. Set the API key
+
+The plugin reads the key through the harness credential seam, per request — a changed key takes effect without a restart.
+
+**Recommended — credentials file.** Add one line to `~/.dsh/.credentials.yaml`:
+
+```yaml
+version: 1
+refs:
+  OLLAMA_CLOUD_API_KEY: ollama-xxxxxxxxxxxxxxxx
+```
+
+**Alternative — environment variable.** Set `OLLAMA_CLOUD_API_KEY` in the environment the harness process runs under (your shell profile, a launchd unit, a process manager, etc.):
+
+```sh
+export OLLAMA_CLOUD_API_KEY="ollama-xxxxxxxxxxxxxxxx"
+```
+
+### 2. Select the provider
+
+Choose the `ollama-cloud-direct` provider for the model (for example in the model settings or the agent's provider configuration).
+
+## Custom model catalog
+
+The bundle mounts the plugin with its default model catalog. To override it, add a config row in `~/.dsh/cordis.patch.yml`:
+
+```yaml
+- id: llm-ollama-cloud
+  config:
+    models:
+      - id: deepseek-v4-flash
+        name: DeepSeek-V4-Flash
+        contextWindow: 800000
+```
+
+## License
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,8 @@
+# The llm-ollama-cloud bundle patch: mounts the Ollama cloud provider row.
+# Applied as a profile layer when the profile lists this bundle; the row
+# references the package by name so Node resolution finds the installed code.
+# The API key is read from the OLLAMA_CLOUD_API_KEY credential reference
+# (credentials file or environment) — never stored in this file.
+- insert:
+    - id: llm-ollama-cloud
+      name: '@lihuu/dsh-ollama-cloud'