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

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

@@ -70,7 +70,7 @@ OCR returns page text, coordinates, and confidence, and writes the full structur
 
 4. Always use `--json`. Read output paths, provider/model ids, and errors from JSON instead of scraping human text.
 
-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:
+5. After success, respond with every output in a format the user's client can render. For media generation and transcription commands, read `outputs[].path` from the JSON result. `outputs` is required and must contain at least one item for those commands; a missing or empty array is a command-contract failure. Resolve any relative path against `cwd` before rendering it. Then:
 
 | Output type | Response format | Example |
 |---|---|---|
@@ -79,7 +79,9 @@ OCR returns page text, coordinates, and confidence, and writes the full structur
 | 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.
+   `dim ocr recognize` uses its dedicated success contract instead of `outputs`: require `ok: true` and a non-empty absolute `resultPath`. Return `text` or `textPreview` to the user, link `resultPath` as the complete structured result, and also link optional `textPath` and `pagesPreview[].imagePath` values. Missing `outputs` is valid for OCR. Treat a missing `resultPath` as a command-contract failure.
+
+The absolute path is required — relative paths like `./artifacts/image.png` will not render in Desktop. Wrap Markdown destinations in angle brackets so paths containing spaces remain valid, for example `![Generated image](</workspace/my artifacts/image.png>)`.
 
 ## Operating Rules
 
@@ -88,7 +90,10 @@ The absolute path is required — relative paths like `./artifacts/image.png` wi
 - 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.
+- When the user requests a video length, always pass it through the CLI `--duration <seconds>` flag. Duration text inside the prompt does not set the provider duration.
+- Video generation can be slow. Use a generous CLI `--timeout` and set the exec tool's `timeoutMs` to the same value or higher. The exec timeout is independent, defaults to 300000 ms, and accepts at most 3600000 ms. For a longer CLI timeout, start exec with `runInBackground: true` and `timeoutMs: -1`.
+- A video command may move to an exec background task after 30 seconds. Use `wait` for its completion notification; do not run `sleep` or provider polling commands. Then read the notification `outputPath`. That path is the exec log containing the CLI JSON, not the generated video. Parse the log's `outputs[].path` and render those media paths.
+- 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.
 - Keep LLM model selection separate from multimodal defaults. A chat model change does not change modality defaults.
 - Do not expose API keys, credentials, headers, or provider secrets.

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

@@ -18,10 +18,10 @@ 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:
+The JSON result includes `outputs[].path`. Require at least one output, resolve each path to an absolute path, and respond with every output:
 
 ```
-![Generated image](/absolute/path/to/artifacts/image.png)
+![Generated image](</absolute/path/to/artifacts/image.png>)
 ```
 
 Edit an image:
@@ -52,6 +52,14 @@ 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
 ```
 
+The requested length must be passed with `--duration`. Writing a duration only
+inside `--prompt` leaves the provider duration unset and may use its default.
+
+Run this command through exec with `timeoutMs: 1800000`. If exec returns a
+background task, wait for the completion notification and read its
+`outputPath` to obtain the CLI JSON. The notification path is an exec log; the
+generated video path is the JSON `outputs[].path`.
+
 Respond with:
 
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dimcode-darwin-arm64",
-  "version": "0.2.28",
+  "version": "0.2.29-beta.0",
   "description": "dimcode binary for macOS ARM64 (Apple Silicon)",
   "os": [
     "darwin"