@barry-rocks/sdk/adapters/models

The contract for model adapters: completion, embedding, and decision models, their requests, availability and compatibility checks, and the errors a model route raises.

import { … } from "@barry-rocks/sdk/adapters/models";

API

Classes

ModelsNotInstalled

Extends

Error

Constructors

Constructor

new ModelsNotInstalled(): ModelsNotInstalled

Returns

ModelsNotInstalled

Overrides

Error.constructor

ModelUnavailableError

The model cannot serve requests at all: unreachable, unauthenticated, or not installed. Distinct from an ordinary failure so a caller sweeping many items stops once instead of recording one outage as N per-item failures.

Extends

Error

Constructors

Constructor

new ModelUnavailableError(message, cause?): ModelUnavailableError

Parameters

Parameter	Type
`message`	`string`
`cause?`	`unknown`

Returns

ModelUnavailableError

Overrides

Error.constructor

Properties

Property	Modifier	Type	Overrides
`cause?`	`readonly`	`unknown`	`Error.cause`

RouteRefused

A model or vendor this harness cannot run, phrased for whoever chose it.

Extends

Error

Constructors

Constructor

new RouteRefused(message): RouteRefused

Parameters

Parameter	Type
`message`	`string`

Returns

RouteRefused

Overrides

Error.constructor

Interfaces

AvailableModels

Properties

Property	Type	Description
`models`	`Model`[]	-
`source`	`"discovered"` \| `"catalog"`	`discovered` came from the endpoint; `catalog` is Barry’s curated list.
`stale`	`boolean`	True when discovery was possible and failed, so the catalog stands in. A silently shortened list reads as a complete one; this is what says it is not.

Check

Properties

Property	Type	Description
`fix?`	`string`	Printed for the human to run — never run on their behalf.
`name`	`string`	A short label for the report line: “binary”, “version”, “context window”.
`observed`	`string`	-
`status`	`"unknown"` \| `"failed"` \| `"ok"`	`unknown` means not checked, which is different from checked and broken.

Compatibility

Properties

Property	Type	Description
`baseUrl`	`BaseUrl`	-
`egressSandbox?`	`boolean`	Whether Barry’s egress proxy has been shown to hold for requests here.
`structuredOutput?`	`"native"` \| `"prompted"`	Measured per endpoint, not inherited from the API it imitates: a compatible API can accept a schema field and ignore it. Absent means “prompted” — the safe reading until someone verifies otherwise.
`with`	`string`	-

Completion

The model contracts: what a model can be asked, and the Models door every caller reaches one through.

Everything needed to WRITE a vendor or call a model, and nothing that implements one. The vendors Barry ships live in registered bags’ vendor declarations with the call code attached by the installation composition root; a composition root hands them to createModels and installs the result.

Properties

Property	Type	Description
`servedModel`	`string` \| `null`	The model that actually served the request, for the audit trail.
`structured?`	`unknown`	Present when `schema` was set and the reply validated against it.
`text`	`string`	-
`usage?`	`TokenUsage`	-

CompletionModel

The model contracts: what a model can be asked, and the Models door every caller reaches one through.

Properties

Property	Type	Description
`ref`	`${string}/${string}`	-
`structuredOutput`	`"native"` \| `"prompted"`	How a `schema` is honoured. “prompted” keeps the validate-and-retry fallback on; flipping a model to “native” switches it off, so it takes a dated live verification against the real endpoint, not a reading of docs.

Methods

complete()

complete(request): Promise<Completion>

Parameters

Parameter	Type
`request`	`CompletionRequest`

Returns

Promise<Completion>

CompletionRequest

The model contracts: what a model can be asked, and the Models door every caller reaches one through.

Properties

Property	Type	Description
`keepAliveMs?`	`number`	How long a local model stays loaded after this call. For a caller on a timer longer than the vendor’s default, which would otherwise cold-start every call. Vendors with no such notion ignore it.
`maxTokens?`	`number`	-
`prompt`	`string`	-
`schema?`	`JsonSchema`	-
`system?`	`string`	-
`temperature?`	`number`	-
`timeoutMs?`	`number`	-

Decision

The model contracts: what a model can be asked, and the Models door every caller reaches one through.

Properties

Property	Type	Description
`answers`	`Record`<`string`, `Answer`>	Keyed by the names the questions were given.
`servedModel`	`string` \| `null`	The model that actually served the request, for the audit trail.
`usage?`	`TokenUsage`	-

DecisionModel

The model contracts: what a model can be asked, and the Models door every caller reaches one through.

Properties

Property	Type
`ref`	`${string}/${string}`

Methods

decide()

decide(request): Promise<Decision>

Parameters

Parameter	Type
`request`	`DecisionRequest`

Returns

Promise<Decision>

DecisionRequest

The model contracts: what a model can be asked, and the Models door every caller reaches one through.

Properties

Property	Type	Description
`questions`	`Record`<`string`, `Question`>	-
`state`	`string` \| `Record`<`string`, `unknown`> \| `string`[]	What the questions are about.
`timeoutMs?`	`number`	-

EmbeddingModel

The model contracts: what a model can be asked, and the Models door every caller reaches one through.

Properties

Property	Type
`dimensions?`	`number`
`ref`	`${string}/${string}`

Methods

embed()

embed(request): Promise<Embeddings>

Parameters

Parameter	Type
`request`	`EmbeddingRequest`

Returns

Promise<Embeddings>

EmbeddingRequest

The model contracts: what a model can be asked, and the Models door every caller reaches one through.

Properties

Property	Type	Description
`input`	readonly `string`[]	Batched because batching is the whole performance story: 128 texts in one call to nomic-embed-text take ~976ms, one per call pays the round trip every time. The caller picks the batch size — only it knows how much text each item holds.
`timeoutMs?`	`number`	-

Embeddings

The model contracts: what a model can be asked, and the Models door every caller reaches one through.

Properties

Property	Type	Description
`servedModel`	`string` \| `null`	-
`vectors`	`number`[][]	One vector per input, in the order given.

Endpoint

A resolved address and credential, ready to send a request to.

Properties

Property	Type
`apiKey?`	`string`
`baseUrl`	`string`
`egressSandbox?`	`boolean`
`structuredOutput?`	`"native"` \| `"prompted"`

HostProbes

What the checks need from the host, passed in so they can be tested.

Properties

Property	Type
`platform`	`Platform`

Methods

run()

run(command, args): { code: number; stdout: string; } | null

Parameters

Parameter	Type
`command`	`string`
`args`	readonly `string`[]

Returns

{ code: number; stdout: string; } | null

which()

which(command): string | null

Absolute path of a command on PATH, or null.

Parameters

Parameter	Type
`command`	`string`

Returns

string | null

ListedModel

Properties

Property	Type
`id`	`string`
`parameterSize?`	`string`
`sizeBytes?`	`number`

Model

Properties

Property	Type	Description
`dimensions?`	`number`	-
`id`	`string`	-
`kind`	`ModelKind`	-
`label`	`string`	-
`local?`	`boolean`	-
`note?`	`string`	A caveat shown in pickers — e.g. a measured failure at tool calling.
`roles?`	(`"default"` \| `"small"`)[]	`default` is used when nothing names a model; `small` for Barry’s own cheap internal calls.
`structuredOutput?`	`"native"` \| `"prompted"`	-

ModelProviders

Properties

Property	Type	Description
`refused`	`Map`<`string`, `string`[]>	Refusals from the most recent load; selections remain recorded for repair.

Methods

add()

add(path, options?): Promise<{ contractVersion: 1; factoryExport: string; packageName: string; path: string; shipped?: true; version: string; }>

Parameters

Parameter	Type
`path`	`string`
`options?`	{ `shipped?`: `true`; }
`options.shipped?`	`true`

Returns

Promise<{ contractVersion: 1; factoryExport: string; packageName: string; path: string; shipped?: true; version: string; }>

installed()

installed(): object[]

Returns

object[]

load()

load(packageNames?): Promise<VendorFactories>

Omitted names load registered selections. A named missing selection fails explicitly.

Parameters

Parameter	Type
`packageNames?`	readonly `string`[]

Returns

Promise<VendorFactories>

remove()

remove(packageName): boolean

Parameters

Parameter	Type
`packageName`	`string`

Returns

boolean

ModelProviderStoreOptions

Properties

Property	Type	Description
`file`	`string`	-
`importModule?`	(`entry`) => `Promise`<`unknown`>	Absolute module entry point; tests may inject imports without contacting a provider.

Models

Methods

available()

available(vendor, at?): Promise<AvailableModels>

Parameters

Parameter	Type
`vendor`	`string`
`at?`	`Partial`<`Endpoint`>

Returns

Promise<AvailableModels>

byRole()

byRole(vendor, role, kind?): `${string}/${string}` | undefined

Parameters

Parameter	Type
`vendor`	`string`
`role`	`"default"` \| `"small"`
`kind?`	`ModelKind`

Returns

`${string}/${string}` | undefined

check()

check(ref, at?): Promise<Check[]>

Parameters

Parameter	Type
`ref`	`${string}/${string}`
`at?`	`Partial`<`Endpoint`>

Returns

Promise<Check[]>

completion()

completion(ref, at?): CompletionModel

Parameters

Parameter	Type
`ref`	`${string}/${string}`
`at?`	`Partial`<`Endpoint`>

Returns

CompletionModel

decision()

decision(ref, at?): DecisionModel

Parameters

Parameter	Type
`ref`	`${string}/${string}`
`at?`	`Partial`<`Endpoint`>

Returns

DecisionModel

embedding()

embedding(ref, at?): EmbeddingModel

Parameters

Parameter	Type
`ref`	`${string}/${string}`
`at?`	`Partial`<`Endpoint`>

Returns

EmbeddingModel

endpoint()

endpoint(vendor, compatibleWith?): Endpoint | undefined

Where to send a request, with its credential. compatibleWith asks for the vendor’s imitation of another vendor’s API — how a harness reaches a model its own vendor does not serve. undefined when there is no such door.

Parameters

Parameter	Type
`vendor`	`string`
`compatibleWith?`	`string`

Returns

Endpoint | undefined

get()

get(ref): Model | undefined

The catalog entry, when there is one. Unknown ids still resolve everywhere else.

Parameters

Parameter	Type
`ref`	`${string}/${string}`

Returns

Model | undefined

vendors()

vendors(): Vendor[]

Returns

Vendor[]

ModelsOptions

Properties

Property	Type	Description
`env?`	`Record`<`string`, `string` \| `undefined`>	Where credentials and address overrides are read. Defaults to `process.env`.

OfferedModelInfo

Properties

Property	Type	Description
`id`	`string`	-
`label`	`string`	-
`note?`	`string`	A caveat worth showing where the model is picked, such as a measured weakness.

OfferingHarness

Extends

RoutingHarness

Properties

Property	Type	Description	Inherited from
`aliases?`	readonly `string`[]	Former ids it still answers to: an identity’s default may name one.	`RoutingHarness`.`aliases`
`capabilities`	`Pick`<`HarnessCapabilities`, `"endpoint"` \| `"withoutKey"`>	-	`RoutingHarness`.`capabilities`
`id`	`string`	-	`RoutingHarness`.`id`
`offeredModels?`	readonly `OfferedModel`[]	-	-
`vendor?`	`string`	-	`RoutingHarness`.`vendor`

Route

Properties

Property	Type	Description
`model`	`string` \| `undefined`	As the harness names it. Absent means no model flag: the harness decides.
`vendor`	`string` \| `undefined`	The vendor serving it, when that is not the harness’s own.

RouteRequest

Properties

Property	Type	Description
`identity?`	`object`	The identity’s model for the running harness.
`identity.model?`	`string`	-
`model?`	`string`	From the session or `-m`: a model id.
`vendor?`	`string`	The vendor to serve it, when the session names one (`--model-provider`).

RoutingHarness

Extended by

OfferingHarness

Properties

Property	Type	Description
`aliases?`	readonly `string`[]	Former ids it still answers to: an identity’s default may name one.
`capabilities`	`Pick`<`HarnessCapabilities`, `"endpoint"` \| `"withoutKey"`>	-
`id`	`string`	-
`vendor?`	`string`	-

TokenUsage

The model contracts: what a model can be asked, and the Models door every caller reaches one through.

Properties

Property	Type	Description
`cacheReadTokens?`	`number`	With heavy tool use cache reads are usually the majority of input and are priced far below it, so a cost computed without them is wrong by a large factor, not a small one.
`cacheWriteTokens?`	`number`	-
`costUsd?`	`number`	-
`inputTokens`	`number`	-
`outputTokens`	`number`	-
`totalTokens?`	`number`	-

Vendor

Properties

Property	Type	Description
`baseUrl?`	`BaseUrl`	Absent for a vendor Barry never calls directly (cursor serves only through its harness).
`compatible?`	`Compatibility`[]	Other vendors’ APIs this vendor also serves — z.ai and Ollama speak Anthropic’s Messages API, Ollama speaks OpenAI’s too. A harness reaches a model of this vendor only through one of these.
`credential`	{ `env`: `string`; `field?`: `"username"` \| `"password"` \| `"notes"` \| `"uri"`; `item?`: `string`; } \| { `placeholder`: `string`; } \| `null`	`null` for a vendor that needs none. A `placeholder` is always sent and is not authentication: without one, a harness falls back to the user’s own login and sends a real token to whatever endpoint it was pointed at. The env form carries an optional default vault item: when the identity does not define the variable, the gate reads `item.field` from the identity’s vault. Env-only keeps working — the identity must define the variable — and the checker warns on it.
`id`	`string`	-
`label`	`string`	-
`models`	`Model`[]	-

Methods

check()?

optional check(endpoint, model?): Promise<Check[]>

Parameters

Parameter	Type
`endpoint`	`Endpoint`
`model?`	`string`

Returns

Promise<Check[]>

completion()?

optional completion(model, endpoint): CompletionModel

Parameters

Parameter	Type
`model`	`string`
`endpoint`	`Endpoint`

Returns

CompletionModel

decision()?

optional decision(model, endpoint): DecisionModel

Parameters

Parameter	Type
`model`	`string`
`endpoint`	`Endpoint`

Returns

DecisionModel

embedding()?

optional embedding(model, endpoint): EmbeddingModel

Parameters

Parameter	Type
`model`	`string`
`endpoint`	`Endpoint`

Returns

EmbeddingModel

listModels()?

optional listModels(endpoint): Promise<ListedModel[]>

What this endpoint actually serves right now, where the vendor can say.

Parameters

Parameter	Type
`endpoint`	`Endpoint`

Returns

Promise<ListedModel[]>

VendorCode

The vendor call code an adapter package may ship beside its adapter.

A harness adapter owns a session model; a vendor-carrying adapter also owns call code for vendors Barry does not ship — its own rows and the factories that serve them, installed and recorded like the adapter itself. The rows are snapshotted into the installed record, so the catalog a picker reads costs no imports; the factories load when the process that hosts models asks for them.

Properties

Property	Type
`factories`	`VendorFactories`
`vendors`	`Vendor`[]

VendorFactories

The per-kind call code, keyed by the vendor id it serves. What a kind directory exports; what turns parsed catalog data into callable vendors.

Properties

Property	Type
`check?`	`Partial`<`Record`<`string`, (`endpoint`, `model?`) => `Promise`<`Check`[]>>>
`completion?`	`Partial`<`Record`<`string`, (`model`, `endpoint`) => `CompletionModel`>>
`decision?`	`Partial`<`Record`<`string`, (`model`, `endpoint`) => `DecisionModel`>>
`embedding?`	`Partial`<`Record`<`string`, (`model`, `endpoint`) => `EmbeddingModel`>>
`listModels?`	`Partial`<`Record`<`string`, (`endpoint`) => `Promise`<`ListedModel`[]>>>

Type Aliases

Answer

Answer = { confidence?: number; probability: number; type: "boolean"; value: boolean; } | { confidence?: number; probabilities?: Record<string, number>; type: "choice"; value: string; } | { confidence?: number; legend?: string; type: "score"; value: number; }

The model contracts: what a model can be asked, and the Models door every caller reaches one through.

BaseUrl

BaseUrl = string | { env?: string; fallback?: string; path?: string; }

Where a vendor listens: a fixed URL, or an env override with the vendor’s own default behind it. A local daemon’s default is its vendor’s documented port (Ollama’s 11434); Barry keeps no port table of other people’s software.

InstalledModelProvider

InstalledModelProvider = z.infer<typeof registration>

Platform

Platform = "aix" | "android" | "darwin" | "freebsd" | "haiku" | "linux" | "openbsd" | "sunos" | "win32" | "cygwin" | "netbsd"

Platform names are wire data and must also be usable without Node declarations.

Question

Question = { instructions: string; type: "boolean"; } | { instructions: string; options: string[]; type: "choice"; } | { instructions: string; levels: string[]; type: "score"; }

The model contracts: what a model can be asked, and the Models door every caller reaches one through.

Union Members

Type Literal

{ instructions: string; type: "boolean"; }

Type Literal

{ instructions: string; options: string[]; type: "choice"; }

Type Literal

{ instructions: string; levels: string[]; type: "score"; }

2–10 labelled levels.

ShippedModelProvider

ShippedModelProvider = Pick<InstalledModelProvider, "packageName" | "version" | "path"> & object

Type Declaration

Name	Type
`contractVersion`	`unknown`
`factoryExport`	`unknown`

Variables

registration

const registration: ZodObject<{ contractVersion: ZodLiteral<1>; factoryExport: ZodString; packageName: ZodString; path: ZodString; shipped: ZodOptional<ZodLiteral<true>>; version: ZodString; }, $strict>

SHIPPED_VENDORS

const SHIPPED_VENDORS: Vendor[]

SHIPPED_VENDORS_YAML

const SHIPPED_VENDORS_YAML: string

VendorCatalogSchema

const VendorCatalogSchema: ZodArray<ZodObject<{ baseUrl: ZodOptional<ZodUnion<readonly [ZodString, ZodObject<{ env: ZodOptional<ZodString>; fallback: ZodOptional<ZodString>; path: ZodOptional<ZodString>; }, $strict>]>>; compatible: ZodOptional<ZodArray<ZodObject<{ baseUrl: ZodUnion<readonly [ZodString, ZodObject<{ env: …; fallback: …; path: …; }, $strict>]>; egressSandbox: ZodOptional<ZodBoolean>; structuredOutput: ZodOptional<ZodEnum<{ native: "native"; prompted: "prompted"; }>>; with: ZodString; }, $strict>>>; credential: ZodUnion<readonly [ZodObject<{ env: ZodString; field: ZodOptional<ZodEnum<{ notes: "notes"; password: "password"; uri: "uri"; username: "username"; }>>; item: ZodOptional<ZodString>; }, $strict>, ZodObject<{ placeholder: ZodString; }, $strict>, ZodNull]>; id: ZodString; label: ZodString; models: ZodArray<ZodObject<{ dimensions: ZodOptional<ZodNumber>; id: ZodString; kind: ZodEnum<{ completion: "completion"; decision: "decision"; embedding: "embedding"; }>; label: ZodString; local: ZodOptional<ZodBoolean>; note: ZodOptional<ZodString>; roles: ZodOptional<ZodArray<ZodEnum<{ default: "default"; small: "small"; }>>>; structuredOutput: ZodOptional<ZodEnum<{ native: "native"; prompted: "prompted"; }>>; }, $strict>>; }, $strict>>

Functions

answerViaJson()

answerViaJson(questions, raw): Record<string, Answer>

Validate a model’s JSON into answers, failing loudly on anything unusable.

A missing key, a choice outside the offered set, or a score outside the level range all throw naming the question — the caller can retry or fall back, but it is never handed a value the model invented.

Parameters

Parameter	Type
`questions`	`Record`<`string`, `Question`>
`raw`	`string`

Returns

Record<string, Answer>

assembleVendors()

assembleVendors(specs, factories): Vendor[]

Attach the call code to the catalog data.

A factory keyed by a vendor the catalog does not list is refused rather than silently dropped: a misspelled id would otherwise leave that vendor’s models unpickable-at and the failure would surface frames away from the typo that caused it.

Parameters

Parameter	Type
`specs`	readonly `Vendor`[]
`factories`	`VendorFactories`

Returns

Vendor[]

checkRequirements()

checkRequirements(requirements, probes): Check[]

binary, version and pin — in that order, always all three. Credentials are not a host requirement: they are declared per harness bag and enforced by the session gate against the identity’s sources.

Parameters

Parameter	Type
`requirements`	`Requirements`
`probes`	`HostProbes`

Returns

Check[]

createModels()

createModels(vendors, options?): Models

Parameters

Parameter	Type
`vendors`	readonly `Vendor`[]
`options`	`ModelsOptions`

Returns

Models

defineVendor()

defineVendor(vendor): Vendor

Checks what no type can: each model id appears once, and at most one model of a kind claims each role — two default completion models would make the choice depend on file order.

Parameters

Parameter	Type
`vendor`	`Vendor`

Returns

Vendor

defineVendorCode()

defineVendorCode(code): VendorCode

Give a vendor-code literal its type, and refuse incoherence by name: a factory keyed by a vendor this code does not declare would dangle forever — no row, so no ref can ever reach it — and the moment to learn that is the install, not the first call.

Parameters

Parameter	Type
`code`	`VendorCode`

Returns

VendorCode

describeQuestions()

describeQuestions(questions): string

Describe the questions as a system prompt.

Says the shape once, per question, in the model’s own terms — an enum lists its options, a score lists its levels with their indices. Vaguer phrasing (“answer as JSON”) produces keys that do not match and values out of range.

Parameters

Parameter	Type
`questions`	`Record`<`string`, `Question`>

Returns

string

formatChecks()

formatChecks(title, checks): string[]

One line per check, passes included, then the fixes for what failed.

Parameters

Parameter	Type
`title`	`string`
`checks`	readonly `Check`[]

Returns

string[]

installedModels()

installedModels(): Models

The models this process was started with.

Throws ModelsNotInstalled — never a “model unavailable” — when nothing was installed: the two need different fixes, and reading a wiring mistake as an unavailable model is how a sweep once skipped every run while the daemon was up with the model pulled.

Returns

Models

installModels()

installModels(models): void

Called once by whatever process starts — the API, the engine, the CLI, a job.

Parameters

Parameter	Type
`models`	`Models`

Returns

void

isOfferedModel()

isOfferedModel(harness, vendors, id): boolean

Parameters

Parameter	Type
`harness`	`OfferingHarness`
`vendors`	readonly `Vendor`[]
`id`	`string`

Returns

boolean

keylessRouteRefusal()

keylessRouteRefusal(harness, route, vendors, env): string | null

Why routing this session to its endpoint would hand the user’s own login to another vendor, or null when it would not.

A harness whose fallback without a key is the user’s subscription login sends that login wherever it is pointed. So an endpoint that needs a key, reached without one, is refused rather than warned about: the request would fail at the vendor anyway, having carried the credential there.

Parameters

Parameter	Type
`harness`	`RoutingHarness`
`route`	`Route`
`vendors`	readonly `Vendor`[]
`env`	`Record`<`string`, `string` \| `undefined`>

Returns

string | null

loadModelProviders()

loadModelProviders(options): ModelProviders

No discovery of siblings and no implicit defaults: add is the installation’s selection.

Parameters

Parameter	Type
`options`	`ModelProviderStoreOptions`

Returns

ModelProviders

mergeVendorFactories()

mergeVendorFactories(…sources): VendorFactories

Compose independently installed providers without silently replacing one.

Parameters

Parameter	Type
…`sources`	`VendorFactories`[]

Returns

VendorFactories

offeredModels()

offeredModels(harness, vendors): OfferedModelInfo[]

A harness’s own vendor’s completion models, then those of each vendor it can be routed to; a harness with no vendor offers the list it declares.

Parameters

Parameter	Type
`harness`	`OfferingHarness`
`vendors`	readonly `Vendor`[]

Returns

OfferedModelInfo[]

parseVendorCatalog()

parseVendorCatalog(text): Vendor[]

Parse a legacy standalone catalog. Refuses, by name: an unknown or misspelled key (the schema is strict — a typo’d field must not parse as absence), a model id twice in one vendor, two default models of a kind, and a compatibility door naming a vendor the file does not list.

Parameters

Parameter	Type
`text`	`string`

Returns

Vendor[]

parseVersion()

parseVersion(requirements, output): string | null

The version a binary’s output reports, by the requirement’s pattern. null when the pattern finds nothing — Barry’s declaration is out of date, which is not the same as the harness being missing.

Parameters

Parameter	Type
`requirements`	`Requirements`
`output`	`string`

Returns

string | null

preflightLine()

preflightLine(subject, checks): string

The one line barry start prints before launching — always a line, success included.

Parameters

Parameter	Type
`subject`	`string`
`checks`	readonly `Check`[]

Returns

string

reachableVendors()

reachableVendors(harness, vendors): Vendor[]

Other vendors serving this harness vendor’s API, on a harness Barry can point at them.

Parameters

Parameter	Type
`harness`	`RoutingHarness`
`vendors`	readonly `Vendor`[]

Returns

Vendor[]

registeredVendorRows()

registeredVendorRows(registry?, includeShipped?): Vendor[]

Catalogs are installed declarations, independent of identity packing.

Parameters

Parameter	Type
`registry?`	`BagRegistry`
`includeShipped?`	`boolean`

Returns

Vendor[]

routedEndpoint()

routedEndpoint(harness, model, vendors, env, override?): Endpoint | undefined

Where a harness reaches a model another vendor serves: that vendor’s door for the harness vendor’s API, with its key, resolved against the session’s env — which is where an identity’s keys and a session’s BARRY_OLLAMA_URL live, not the process’s.

Undefined for the harness’s own vendor’s model, for a model named without its vendor, and for a harness Barry cannot point anywhere: the harness then uses its own settings, which Barry never overrides.

override moves only an address resolved at runtime (a local daemon’s); a vendor’s fixed address is its own.

Parameters

Parameter	Type
`harness`	`RoutingHarness`
`model`	`string` \| `undefined`
`vendors`	readonly `Vendor`[]
`env`	`Record`<`string`, `string` \| `undefined`>
`override`	{ `baseUrl?`: `string`; }
`override.baseUrl?`	`string`

Returns

Endpoint | undefined

routedVendorOf()

routedVendorOf(harness, model, vendors): Vendor | undefined

The vendor serving model that this harness can be pointed at, if any.

Parameters

Parameter	Type
`harness`	`RoutingHarness`
`model`	`string`
`vendors`	readonly `Vendor`[]

Returns

Vendor | undefined

routeModel()

routeModel(harness, given, vendors): Route

Parameters

Parameter	Type
`harness`	`RoutingHarness`
`given`	`RouteRequest`
`vendors`	readonly `Vendor`[]

Returns

Route

shippedModelProviders()

shippedModelProviders(root): ShippedModelProvider[]

Discover declarations without importing code or requiring a built package.

Parameters

Parameter	Type
`root`	`string`

Returns

ShippedModelProvider[]

suggestOfferedModels()

suggestOfferedModels(harness, vendors, partial): string[]

Offered models close to a (possibly misspelled) id. Substring matches win; otherwise a fuzzy subsequence match, so “claude-huiku” still suggests “claude-haiku-4-5”.

Parameters

Parameter	Type
`harness`	`OfferingHarness`
`vendors`	readonly `Vendor`[]
`partial`	`string`

Returns

string[]

validateVendorCatalog()

validateVendorCatalog(vendors, checkCompatibility?): Vendor[]

Validate catalog relationships independently of its containing file.

Parameters

Parameter	Type	Default value
`vendors`	`Vendor`[]	`undefined`
`checkCompatibility`	`boolean`	`true`

Returns

Vendor[]