dimcode-darwin-arm64 0.2.27 → 0.2.28-beta.0

package/bin/runtime/apple-vision/darwin/arm64/manifest.json

@@ -0,0 +1,9 @@
+{
+  "version": 1,
+  "runtimeId": "apple-vision",
+  "providerId": "apple-vision-local",
+  "modelId": "system-text-recognizer",
+  "platform": "darwin",
+  "arch": "arm64",
+  "helper": "dim-vision-ocr"
+}

package/bin/skills-assets/dim-modality/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: dim-modality
-description: Use DimCode multimodal CLI when the user asks the agent to generate or edit images, generate video, synthesize speech, transcribe audio, generate music or sound effects, create 3D assets or motion data, or inspect available multimodal defaults through `dim modality`. This skill teaches when to use the CLI, the main execution path, failure handling, and model-specific notes.
+description: Use DimCode multimodal CLI when the user asks the agent to generate or edit images, generate video, synthesize speech, transcribe audio, generate music or sound effects, create 3D assets or motion data, extract exact text from images or PDFs with OCR, or inspect available multimodal defaults through `dim modality`. This skill teaches when to use the CLI, the main execution path, failure handling, and model-specific notes.
 ---
 
 # Dim Modality
@@ -44,17 +44,49 @@ dim modality list --json
 | Generate a 3D asset | `asset.generate` | `dim asset generate` |
 | Generate motion data | `motion.generate` | `dim motion generate` |
 
+### Image understanding vs. exact text extraction
+
+Two different tools read images and PDFs. Pick by what the user actually wants:
+
+| User goal | Tool | Why |
+|---|---|---|
+| Describe, summarize, or explain an image or screenshot | `read` | Semantic understanding, charts, diagrams, layout — the vision model interprets meaning |
+| Answer questions about what an image shows | `read` | Visual reasoning, not character accuracy |
+| Extract the **exact characters** from an image or PDF | `dim ocr recognize` | Precise text, page numbers, coordinates, confidence — OCR is authoritative for verbatim text |
+| Read a scanned document, receipt, invoice, or contract | `dim ocr recognize` | Faithful transcription of the printed words |
+| Copy numbers, codes, IDs, or tables out of an image | `dim ocr recognize` | Character-level accuracy matters |
+
+The rule: image understanding and visual reasoning go through `read`; verbatim text extraction from images and PDFs goes through `dim ocr recognize`. They do not substitute for each other. When unsure which the user wants, OCR is the safe default only when exact text is the deliverable; otherwise `read`.
+
+```bash
+# Extract exact text from an image or PDF
+dim ocr recognize ./invoice.png --json
+dim ocr recognize ./contract.pdf --json
+```
+
+OCR returns page text, coordinates, and confidence, and writes the full structured result to a file reported in the JSON output. After OCR, you can still pass page images to `read` if the user wants semantic analysis of a specific page.
+
 3. Write outputs under the current workspace, usually `./artifacts/` unless the user asked for another path.
 
 4. Always use `--json`. Read output paths, provider/model ids, and errors from JSON instead of scraping human text.
 
-5. After success, reference the absolute output path. Images can be shown with Markdown image syntax. Audio and video should be reported as absolute paths until Desktop preview support is richer.
+5. After success, respond with the output in a format the user's client can render. Read the `outputPath` field from the JSON result and convert it to an absolute path (resolve relative paths against `cwd`). Then:
+
+| Output type | Response format | Example |
+|---|---|---|
+| Image | Markdown image with absolute path | `![Generated image](/home/user/project/artifacts/image.png)` |
+| Audio | Markdown link with absolute path | `[speech.mp3](/home/user/project/artifacts/speech.mp3)` |
+| Video | Markdown link with absolute path | `[video.mp4](/home/user/project/artifacts/video.mp4)` |
+| Other (3D, motion, transcript) | Markdown link with absolute path | `[robot.glb](/home/user/project/artifacts/robot.glb)` |
+
+The absolute path is required — relative paths like `./artifacts/image.png` will not render in Desktop.
 
 ## Operating Rules
 
 - If the user did not specify provider/model, use the configured default for that capability.
 - Only pass `--provider` and `--model` when the user explicitly asks for a temporary override. Overrides do not change defaults.
 - If a default is missing, tell the user to configure that capability in Settings / Agent Defaults.
+- `ocr.recognize` is a host-owned local capability. Use the provider/model selected by `dim modality get ocr.recognize`; do not silently switch providers after an execution failure. If `dim modality list --json` reports the selected target as unavailable, report that local runtime error to the user.
 - Put provider-specific parameters in a JSON object file and pass it with `--options <path>`.
 - Video generation can be slow. Use a generous `--timeout`, and never claim completion unless an output file exists.
 - For failed commands, explain `error.code`, `error.message`, and `details` from the JSON output. Do not hide the original provider or CLI error.
@@ -75,6 +107,7 @@ Read `references/model-notes.md` when a provider or model may need special handl
 | Provider disconnected or missing key | Ask the user to check provider connection and API key |
 | Model disabled | Ask the user to enable the model in the provider model list |
 | Unsupported capability | Use a model that supports the capability, or ask the user to configure one |
+| OCR runtime unavailable (`local_runtime_unavailable`) | Tell the user the bundled OCR engine is missing or corrupt; recommend reinstalling DimCode. Do not attempt a remote or Python fallback |
 | Output file missing | Do not report success; explain the CLI JSON error and stderr |
 | Video timeout | Report timeout details and operation id when available |
 
@@ -83,6 +116,6 @@ Read `references/model-notes.md` when a provider or model may need special handl
 When reporting back:
 
 - Say which capability was used.
-- Give the output file path.
+- Include the output as a Markdown image (for images) or Markdown link (for audio/video/other), using the absolute path from the JSON result. See the format table in §Main Path.
 - If it failed, state the failure point and the next user action.
 - Keep the response short unless the user asks for detailed debugging.

package/bin/skills-assets/dim-modality/references/cli-recipes.md

@@ -18,6 +18,12 @@ mkdir -p ./artifacts
 dim image generate --prompt "A clean product poster on a white background with soft natural lighting" --out ./artifacts/image.png --json
 ```
 
+The JSON result includes `outputPath`. Resolve it to an absolute path and respond with:
+
+```
+![Generated image](/absolute/path/to/artifacts/image.png)
+```
+
 Edit an image:
 
 ```bash
@@ -46,6 +52,12 @@ mkdir -p ./artifacts
 dim video generate --prompt "A robot walking slowly through a rainy neon street, cinematic camera movement" --duration 5 --out ./artifacts/video.mp4 --json --timeout 1800000
 ```
 
+Respond with:
+
+```
+[video.mp4](/absolute/path/to/artifacts/video.mp4)
+```
+
 Image-to-video:
 
 ```bash
@@ -73,6 +85,12 @@ mkdir -p ./artifacts
 dim speech synthesize --text "Hello, this is a speech generation test." --out ./artifacts/speech.mp3 --json
 ```
 
+Respond with:
+
+```
+[speech.mp3](/absolute/path/to/artifacts/speech.mp3)
+```
+
 Specify a voice:
 
 ```bash
@@ -94,6 +112,12 @@ mkdir -p ./artifacts
 dim music generate --prompt "Warm lo-fi piano for a podcast intro" --title "warm intro" --out ./artifacts/music.mp3 --json
 ```
 
+Respond with:
+
+```
+[music.mp3](/absolute/path/to/artifacts/music.mp3)
+```
+
 Generate a sound effect:
 
 ```bash
@@ -113,6 +137,32 @@ dim asset generate --prompt "low poly robot game asset" --out ./artifacts/robot.
 dim motion generate --prompt "walk cycle for a friendly robot" --out ./artifacts/walk.fbx --json
 ```
 
+Respond with:
+
+```
+[robot.glb](/absolute/path/to/artifacts/robot.glb)
+```
+
+## OCR (Exact Text From Images And PDFs)
+
+`ocr.recognize` runs the selected host-owned OCR provider. It needs no provider connection or API key. Use it when the deliverable is the verbatim printed text, not a description, and do not silently switch OCR providers when execution fails.
+
+Image OCR:
+
+```bash
+dim ocr recognize ./invoice.png --json
+```
+
+PDF OCR (each page is rendered and recognized):
+
+```bash
+dim ocr recognize ./contract.pdf --json
+```
+
+The JSON returns a short text preview plus a `resultPath` to the full structured result (per-page text, coordinates, confidence). For long PDFs, read additional pages from `resultPath` with `read`.
+
+If `dim modality list --json` shows `ocr.recognize` with `available=false` (`local_runtime_unavailable`), the bundled OCR engine is missing or corrupt for this platform. Tell the user to reinstall; do not retry against a remote provider.
+
 ## Temporary Provider Or Model Override
 
 Use this only when the user explicitly asks for a specific provider or model:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dimcode-darwin-arm64",
-  "version": "0.2.27",
+  "version": "0.2.28-beta.0",
   "description": "dimcode binary for macOS ARM64 (Apple Silicon)",
   "os": [
     "darwin"
@@ -9,6 +9,7 @@
     "arm64"
   ],
   "files": [
-    "bin"
+    "bin",
+    "runtime"
   ]
 }