async-render-example git:20260505.5c57b27A

Immutable. This exact content is served forever at /api/v1/blob/562decfd3d9c9e0e.

---
name: async-render-example
description: >-
  Example skill — demonstrates async execution affinity: long-running tools
  surface as deferredHint=true in MCP tools/list. Use as a reference when
  writing domain skills with render or simulation tools. Not intended for
  production use.
license: MIT
compatibility: Python 3.7+
metadata:
  dcc-mcp:
    dcc: python
    version: "1.0.0"
    layer: example
    search-hint: "async tool, long-running, deferred hint, timeout hint, render async, authoring reference"
    tags: "example, async, render, deferred"
    tools: tools.yaml
---

# Async Render Example (issue #317)

This skill demonstrates the `execution` and `timeout_hint_secs` fields added
for issue #317. Tools are declared with either `execution: sync` (default)
or `execution: async`; the MCP server derives the `deferredHint` annotation
from this value and surfaces `timeout_hint_secs` under
`_meta.dcc.timeoutHintSecs` on the tool definition (never inside
`annotations`).

## Behaviour

- `render_frames` → `execution: async` + `timeout_hint_secs: 600`
  → `tools/list` entry gets `"annotations": { "deferredHint": true, ... }`
  and `"_meta": { "dcc": { "timeoutHintSecs": 600 } }`.
- `quick_status` → no `execution` field → default `Sync`
  → `"annotations": { "deferredHint": false, ... }` and no `_meta`.

## Script convention

Each script reads JSON parameters from stdin and writes a JSON result to
stdout — the standard dcc-mcp-core skill script contract.