docs(vision): package READMEs, Model Experience, and the capability Agent Note

Document the four image-recognition packages and the vision group, register
the vision domain in the package index, add the capability decision as an
Agent Note, declare the invariants peer dep, and drop the unused agents
injection from the consumer.

Co-Authored-By: Claude <noreply@anthropic.com>

packages/vision/image-recognition-http/README.md

@@ -0,0 +1,29 @@
+# @deepseek-ai/dsh-image-recognition-http
+
+A user-configurable HTTP vision provider for `ctx.imageRecognition`. It calls an
+OpenAI-compatible `/chat/completions` endpoint with the image encoded as a data
+URL and returns the recognized text.
+
+## Config
+
+| Key | Type | Meaning |
+|---|---|---|
+| `baseURL` | string | Endpoint base; `/chat/completions` is appended. Blank inherits `$DSH_IMAGE_RECOGNITION_BASE_URL`, else unavailable. |
+| `apiKey` | string (secret) | Literal key; prefer `apiKeyEnv`. |
+| `apiKeyEnv` | string (credential-ref) | Credential reference resolved per recognition; defaults to `DEEPSEEK_API_KEY`. |
+| `model` | string | Vision model name; defaults to `deepseek-v4-flash`. |
+| `maxTokens` | number | Generated-token bound; defaults to 2048. |
+
+The endpoint and key are editable live through the `image-recognition-http`
+settings section. The key never rides a response: it is resolved per recognition
+from the credentials domain, falling back to the launch environment.
+
+A recognition under an initiating Agent appends the log-only
+`image-recognition/llm-request` session event carrying the secret-free request
+body before dispatch.
+
+## Known Limitations and Deferred Work
+
+- The provider assumes an OpenAI-compatible vision endpoint; non-standard
+  endpoints must be adapted via `baseURL`/`model` (or a new provider).
+- `file-path` inputs require an inferable media type from the extension.

packages/vision/image-recognition-http/package.json

@@ -31,6 +31,9 @@
     "lib/types/**/*.d.ts"
   ],
   "license": "MIT",
+  "peerDependencies": {
+    "@deepseek-ai/dsh-invariants": "workspace:^"
+  },
   "dependencies": {
     "@deepseek-ai/schemastery": "workspace:^"
   },