Pine
f5f114dfb8
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>
1.1 KiB
1.1 KiB
@deepseek-ai/dsh-image-recognition
Service Definition for the image-recognition capability seam (ctx.imageRecognition):
a provider registry and provider-selecting execution, mirrored on the web seam.
- A provider registers via
ctx.imageRecognition.registerProvider(provider); a duplicateidthrowsIMAGE_RECOGNITION_DUPLICATE_PROVIDER. recognize(request, signal)resolves the provider at call time. Selection is order-independent: a configured id must be registered andavailable(); without a configured id, exactly one usable provider auto-selects. See theImageRecognitionErrorcodes for missing/unavailable/ambiguous providers.ImageInputis a closed union offile-path,base64, andurl; a provider encodes the kind it serves.
Config
provider pins which provider wins; $DSH_IMAGE_RECOGNITION_PROVIDER is the
environment equivalent (not a hidden priority chain).
Known Limitations and Deferred Work
- The seam is provider-neutral by design; image decoding/encoding lives in the provider, not here.
ImageRecognitionErrorcodes are open-string and provider-specific codes are tolerated by consumers.