Skip to content

Interface: IVisionProvider

Makaio Framework


Makaio Framework / contracts / IVisionProvider

Defined in: ../../../packages/contracts/src/capabilities/vision/types.ts:9

Vision provider interface.

Providers enable image analysis for non-vision LLMs.

readonly displayName: string

Defined in: ../../../packages/contracts/src/capability/types.ts:11

Human-readable name for display in UI

ICapabilityProvider.displayName


readonly id: string

Defined in: ../../../packages/contracts/src/capability/types.ts:9

Unique identifier for this provider instance

ICapabilityProvider.id


readonly optional providerKey?: string

Defined in: ../../../packages/contracts/src/capability/types.ts:17

Stable provider identity used for joins across registries.

Unlike id, this should remain stable across runtime re-registration.

ICapabilityProvider.providerKey

analyze(request): Promise<{ confidence?: number; description: string; }>

Defined in: ../../../packages/contracts/src/capabilities/vision/types.ts:14

Analyze an image and return a description.

Analysis request with image and optional prompt

string = ...

Image source: file path, base64 data URI, or URL

string = ...

Optional prompt to guide the analysis (default: “Describe this image”)

Promise<{ confidence?: number; description: string; }>


isAvailable(): Promise<boolean>

Defined in: ../../../packages/contracts/src/capabilities/vision/types.ts:19

Check if the provider is available (e.g. underlying adapter is ready).

Promise<boolean>


optional validate(): Promise<{ error?: string; valid: boolean; }>

Defined in: ../../../packages/contracts/src/capability/types.ts:22

Optional validation method to check provider configuration/credentials.

Promise<{ error?: string; valid: boolean; }>

Validation result with optional error message

ICapabilityProvider.validate