@kindgi/capabilities 0.0.0-bootstrap.0 → 0.1.1

package/dist/capability.schema.json

@@ -0,0 +1,250 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://kindgi.com/schemas/v1/capability.schema.json",
+    "$comment": "schema-version: 1.1.0",
+    "title": "Capability declaration",
+    "description": "An agent's model requirements as declarative constraints. The model router matches capabilities against registered providers, respecting per-tenant policy. `defineCapability` validates a declaration against this schema; a declaration that no registered provider satisfies fails at routing time with `capability-unsatisfiable`.",
+    "type": "object",
+    "required": ["needs"],
+    "additionalProperties": false,
+    "properties": {
+        "kind": {
+            "type": "string",
+            "minLength": 1,
+            "default": "llm-inference",
+            "examples": ["llm-inference", "embedding", "gpu-compute", "sandbox-exec", "browser-session"],
+            "description": "Resource kind this capability requests. Open string: `examples` lists the well-known kinds, and adapters can declare their own. Absent means `llm-inference`. The router only considers providers whose `capabilityKind` equals it (a provider that declares none counts as `llm-inference`). Added in schema-version 1.1.0."
+        },
+        "needs": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+                "$ref": "#/$defs/Requirement"
+            }
+        },
+        "prefer": {
+            "type": "array",
+            "items": {
+                "$ref": "#/$defs/Preference"
+            },
+            "description": "Soft preferences: the router picks the highest-scoring model that also satisfies all 'needs'."
+        },
+        "budget": {
+            "$ref": "#/$defs/Budget",
+            "description": "Per-invocation budget. Declarative: carried with the declaration but not enforced by the runtime (per-turn spend is capped by the agent's `budget.maxCostUsd`)."
+        }
+    },
+    "$defs": {
+        "Requirement": {
+            "oneOf": [
+                {
+                    "$ref": "#/$defs/FeatureRequirement"
+                },
+                {
+                    "$ref": "#/$defs/ContextRequirement"
+                },
+                {
+                    "$ref": "#/$defs/CostRequirement"
+                },
+                {
+                    "$ref": "#/$defs/RegionRequirement"
+                },
+                {
+                    "$ref": "#/$defs/LatencyRequirement"
+                },
+                {
+                    "$ref": "#/$defs/ProviderRequirement"
+                },
+                {
+                    "$ref": "#/$defs/ModelRequirement"
+                }
+            ]
+        },
+        "FeatureRequirement": {
+            "type": "object",
+            "required": ["feature"],
+            "additionalProperties": false,
+            "properties": {
+                "feature": {
+                    "type": "string",
+                    "enum": [
+                        "structured-output",
+                        "vision",
+                        "audio-input",
+                        "audio-output",
+                        "tool-use",
+                        "parallel-tool-use",
+                        "thinking",
+                        "long-context",
+                        "code-execution",
+                        "web-search",
+                        "file-search",
+                        "streaming",
+                        "batch"
+                    ]
+                }
+            }
+        },
+        "ContextRequirement": {
+            "type": "object",
+            "required": ["contextWindow"],
+            "additionalProperties": false,
+            "properties": {
+                "contextWindow": {
+                    "type": "object",
+                    "required": ["op", "value"],
+                    "additionalProperties": false,
+                    "properties": {
+                        "op": {
+                            "type": "string",
+                            "enum": [">=", ">", "=", "<=", "<"]
+                        },
+                        "value": {
+                            "type": "integer",
+                            "minimum": 1
+                        }
+                    }
+                }
+            }
+        },
+        "CostRequirement": {
+            "type": "object",
+            "required": ["costPerCall"],
+            "additionalProperties": false,
+            "properties": {
+                "costPerCall": {
+                    "type": "object",
+                    "required": ["op", "usd"],
+                    "additionalProperties": false,
+                    "properties": {
+                        "op": {
+                            "type": "string",
+                            "enum": [">=", ">", "=", "<=", "<"]
+                        },
+                        "usd": {
+                            "type": "number",
+                            "minimum": 0
+                        }
+                    }
+                }
+            }
+        },
+        "RegionRequirement": {
+            "type": "object",
+            "required": ["region"],
+            "additionalProperties": false,
+            "properties": {
+                "region": {
+                    "type": "string",
+                    "description": "Geographic region constraint (e.g. 'eu-only', 'us-only', 'us-gov'). Enforced by the router against each provider's declared region; a tenant policy's `regionAllow` can constrain it further."
+                }
+            }
+        },
+        "LatencyRequirement": {
+            "type": "object",
+            "required": ["p95LatencyMs"],
+            "additionalProperties": false,
+            "properties": {
+                "p95LatencyMs": {
+                    "type": "object",
+                    "required": ["op", "value"],
+                    "additionalProperties": false,
+                    "properties": {
+                        "op": {
+                            "type": "string",
+                            "enum": ["<=", "<"]
+                        },
+                        "value": {
+                            "type": "integer",
+                            "minimum": 0
+                        }
+                    }
+                }
+            }
+        },
+        "ProviderRequirement": {
+            "type": "object",
+            "required": ["providers"],
+            "additionalProperties": false,
+            "description": "Hard constraint on allowed providers (allowlist) or disallowed providers (denylist). Tenant policy can narrow the set further.",
+            "properties": {
+                "providers": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                        "allow": {
+                            "type": "array",
+                            "items": {
+                                "type": "string"
+                            }
+                        },
+                        "deny": {
+                            "type": "array",
+                            "items": {
+                                "type": "string"
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "ModelRequirement": {
+            "type": "object",
+            "required": ["models"],
+            "additionalProperties": false,
+            "description": "Hard constraint on allowed models (allowlist) or disallowed models (denylist), matched against each provider's model names (`ModelInfo.name`). Can be combined with a providers requirement. Tenant policy can narrow the set further. Added in schema-version 1.1.0.",
+            "properties": {
+                "models": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                        "allow": {
+                            "type": "array",
+                            "items": {
+                                "type": "string"
+                            }
+                        },
+                        "deny": {
+                            "type": "array",
+                            "items": {
+                                "type": "string"
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "Preference": {
+            "type": "object",
+            "required": ["feature", "weight"],
+            "additionalProperties": false,
+            "properties": {
+                "feature": {
+                    "type": "string",
+                    "description": "A capability feature or a soft attribute (e.g. 'lower-cost', 'lower-latency', 'higher-accuracy')."
+                },
+                "weight": {
+                    "type": "number"
+                }
+            }
+        },
+        "Budget": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+                "maxCostUsd": {
+                    "type": "number",
+                    "minimum": 0
+                },
+                "maxTokens": {
+                    "type": "integer",
+                    "minimum": 0
+                },
+                "maxDurationMs": {
+                    "type": "integer",
+                    "minimum": 0
+                }
+            }
+        }
+    }
+}

package/dist/define.d.ts

@@ -0,0 +1,13 @@
+import type { Result } from '@kindgi/types';
+import type { InvalidCapabilityError } from './errors.js';
+import type { Capability } from './types.js';
+/**
+ * Validate a capability declaration against `@kindgi/specs/capability.schema.json`
+ * and return a typed `Capability` on success. Called by pack authors at
+ * agent construction — a rejection here surfaces at pack init, well
+ * before any user request touches the flow.
+ */
+export declare function defineCapability(spec: Capability): Result<Capability, InvalidCapabilityError>;
+/** The `$id` of the JSON Schema this loader validates against. */
+export declare const CAPABILITY_SCHEMA_URI = "https://kindgi.com/schemas/v1/capability.schema.json";
+//# sourceMappingURL=define.d.ts.map

package/dist/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAiB7C;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC,UAAU,EAAE,sBAAsB,CAAC,CAkB7F;AAED,kEAAkE;AAClE,eAAO,MAAM,qBAAqB,yDAAuB,CAAC"}

package/dist/define.js

@@ -0,0 +1,45 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+import { createSpecRegistry } from '@kindgi/schema';
+import capabilitySchema from './capability.schema.json' with { type: 'json' };
+const CAPABILITY_SCHEMA_ID = 'https://kindgi.com/schemas/v1/capability.schema.json';
+let cachedRegistry;
+function registry() {
+    if (cachedRegistry !== undefined)
+        return cachedRegistry;
+    const built = createSpecRegistry([capabilitySchema]);
+    if (built.kind === 'err') {
+        throw new Error(`@kindgi/capabilities: bundled schema failed to compile: ${built.error.message}`);
+    }
+    cachedRegistry = built.value;
+    return cachedRegistry;
+}
+/**
+ * Validate a capability declaration against `@kindgi/specs/capability.schema.json`
+ * and return a typed `Capability` on success. Called by pack authors at
+ * agent construction — a rejection here surfaces at pack init, well
+ * before any user request touches the flow.
+ */
+export function defineCapability(spec) {
+    const r = registry().validate(CAPABILITY_SCHEMA_ID, spec);
+    if (r.kind === 'ok')
+        return r;
+    const err = r.error;
+    if (err.code !== 'validation-error') {
+        throw new Error(`@kindgi/capabilities: unexpected schema error ${err.code}: ${err.message}`);
+    }
+    const issues = err.errors.map((e) => {
+        const ajv = e;
+        return {
+            path: typeof ajv.instancePath === 'string' ? ajv.instancePath : '',
+            message: typeof ajv.message === 'string' ? ajv.message : 'validation failed',
+        };
+    });
+    return {
+        kind: 'err',
+        error: { code: 'invalid-capability', message: err.message, issues },
+    };
+}
+/** The `$id` of the JSON Schema this loader validates against. */
+export const CAPABILITY_SCHEMA_URI = CAPABILITY_SCHEMA_ID;
+//# sourceMappingURL=define.js.map

package/dist/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC;AAEjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAIpD,OAAO,gBAAgB,MAAM,0BAA0B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAI9E,MAAM,oBAAoB,GAAG,sDAAsD,CAAC;AAEpF,IAAI,cAAwC,CAAC;AAC7C,SAAS,QAAQ;IACf,IAAI,cAAc,KAAK,SAAS;QAAE,OAAO,cAAc,CAAC;IACxD,MAAM,KAAK,GAAG,kBAAkB,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACrD,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,2DAA2D,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CACjF,CAAC;IACJ,CAAC;IACD,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC;IAC7B,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAgB;IAC/C,MAAM,CAAC,GAAG,QAAQ,EAAE,CAAC,QAAQ,CAAa,oBAAoB,EAAE,IAAI,CAAC,CAAC;IACtE,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI;QAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC;IACpB,IAAI,GAAG,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,iDAAiD,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/F,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAClC,MAAM,GAAG,GAAG,CAAkD,CAAC;QAC/D,OAAO;YACL,IAAI,EAAE,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE;YAClE,OAAO,EAAE,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB;SAC7E,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,OAAO;QACL,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE;KACpE,CAAC;AACJ,CAAC;AAED,kEAAkE;AAClE,MAAM,CAAC,MAAM,qBAAqB,GAAG,oBAAoB,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,67 @@
+import type { TenantId } from '@kindgi/types';
+/**
+ * Errors emitted by @kindgi/capabilities. Every variant carries a `code`
+ * for pattern matching; messages are human-readable, not API contract.
+ */
+export type CapabilityError = InvalidCapabilityError | InvalidProviderError | DuplicateProviderError | CapabilityUnsatisfiableError | BudgetExceededError;
+/** `defineCapability` rejected the declaration shape (schema mismatch). */
+export interface InvalidCapabilityError {
+    readonly code: 'invalid-capability';
+    readonly message: string;
+    readonly issues: readonly {
+        readonly path: string;
+        readonly message: string;
+    }[];
+}
+/** Provider registration (`createProviderRegistry(...).register`) rejected the metadata shape. */
+export interface InvalidProviderError {
+    readonly code: 'invalid-provider';
+    readonly message: string;
+    readonly reason: string;
+}
+/** Provider registration was called with an id already registered for the tenant. */
+export interface DuplicateProviderError {
+    readonly code: 'duplicate-provider';
+    readonly message: string;
+    readonly providerId: string;
+}
+/**
+ * The router couldn't find any provider satisfying the capability
+ * declaration + tenant policy. `reasons` explains which requirement
+ * rejected which `(provider, model)` candidate.
+ */
+export interface CapabilityUnsatisfiableError {
+    readonly code: 'capability-unsatisfiable';
+    readonly message: string;
+    /**
+     * One entry per requirement, indicating which providers matched
+     * and which didn't. Each rejection carries a structured
+     * `RejectionReason` — callers can `switch (r.reason.code)` to route
+     * on specific failure modes (e.g. surface an "add region" tip when
+     * every failure is `region-mismatch`).
+     */
+    readonly reasons: readonly {
+        readonly requirement: string;
+        readonly satisfyingProviders: readonly string[];
+        readonly rejectingProviders: readonly {
+            readonly id: string;
+            readonly reason: import('./types.js').RejectionReason;
+        }[];
+    }[];
+    readonly tenantId?: TenantId;
+}
+/**
+ * A model invocation exceeded the caller's declared `budget`. Cost meter
+ * emits this either pre-flight (if the estimated cost is already over
+ * budget) or post-flight (if actual cost overran).
+ */
+export interface BudgetExceededError {
+    readonly code: 'budget-exceeded';
+    readonly message: string;
+    readonly limit: {
+        readonly kind: 'cost' | 'tokens' | 'duration';
+        readonly value: number;
+    };
+    readonly actual: number;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C;;;GAGG;AACH,MAAM,MAAM,eAAe,GACvB,sBAAsB,GACtB,oBAAoB,GACpB,sBAAsB,GACtB,4BAA4B,GAC5B,mBAAmB,CAAC;AAExB,2EAA2E;AAC3E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACjF;AAED,kGAAkG;AAClG,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,qFAAqF;AACrF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS;QACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;QAChD,QAAQ,CAAC,kBAAkB,EAAE,SAAS;YACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;YACpB,QAAQ,CAAC,MAAM,EAAE,OAAO,YAAY,EAAE,eAAe,CAAC;SACvD,EAAE,CAAC;KACL,EAAE,CAAC;IACJ,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1F,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB"}

package/dist/errors.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+export {};
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { createAdapterFactoryRegistry } from './adapter-factory.js';
+export type { AdapterConfig, AdapterFactory, AdapterFactoryEntry, AdapterFactoryInput, AdapterFactoryRegistry, PrepareEvent, } from './adapter-factory.js';
+export { CAPABILITY_SCHEMA_URI, defineCapability } from './define.js';
+export { createProviderRegistry } from './registry.js';
+export { matchTuples, route } from './router.js';
+export type { RouteInput } from './router.js';
+export { BUILT_IN_CAPABILITY_KINDS, DEFAULT_CAPABILITY_KIND, FEATURES } from './types.js';
+export type { Budget, BuiltInCapabilityKind, Capability, CapabilityKind, ComparisonOp, Feature, ModelCallInput, ModelCallResult, ModelMessage, ModelInfo, ModelProvider, ModelToolCall, ModelToolDefinition, Preference, ProviderMetadata, ProviderModelPick, ProviderRegistry, RejectionReason, Requirement, RoutingDecision, StructuredOutputRequest, TenantPolicy, UpperBoundOp, UsageCounters, } from './types.js';
+export type { BudgetExceededError, CapabilityError, CapabilityUnsatisfiableError, DuplicateProviderError, InvalidCapabilityError, InvalidProviderError, } from './errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AACpE,YAAY,EACV,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,YAAY,GACb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC1F,YAAY,EACV,MAAM,EACN,qBAAqB,EACrB,UAAU,EACV,cAAc,EACd,YAAY,EACZ,OAAO,EACP,cAAc,EACd,eAAe,EACf,YAAY,EACZ,SAAS,EACT,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,eAAe,EACf,uBAAuB,EACvB,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,4BAA4B,EAC5B,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+export { createAdapterFactoryRegistry } from './adapter-factory.js';
+export { CAPABILITY_SCHEMA_URI, defineCapability } from './define.js';
+export { createProviderRegistry } from './registry.js';
+export { matchTuples, route } from './router.js';
+export { BUILT_IN_CAPABILITY_KINDS, DEFAULT_CAPABILITY_KIND, FEATURES } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC;AAEjC,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AASpE,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,26 @@
+import type { Result, TenantId } from '@kindgi/types';
+import type { CapabilityError } from './errors.js';
+import type { ModelProvider, ProviderRegistry } from './types.js';
+/**
+ * Create an in-memory registry of model providers. Tenant-scoped:
+ * each tenant owns its own `providerId → ModelProvider` map. The
+ * router receives a tenant's slice, so cross-tenant leakage is
+ * impossible at the routing layer.
+ *
+ * Registration is validated for shape: provider `id` + `region`
+ * non-empty; `models[]` non-empty with unique `name` per entry;
+ * per-model `contextWindow` positive integer; per-model `cost`
+ * non-negative; optional per-model `p95LatencyMs` / `maxOutputTokens`
+ * well-shaped; `invoke` is a function. Duplicate ids within a tenant
+ * are refused — accidental clobber of a running provider would be
+ * catastrophic under a live workload. The same `providerId` may be
+ * registered under different tenants (that's the whole point).
+ */
+export declare function createProviderRegistry(seed?: readonly {
+    readonly tenantId: TenantId;
+    readonly provider: ModelProvider;
+}[]): {
+    readonly registry: ProviderRegistry;
+    register(tenantId: TenantId, provider: ModelProvider): Result<void, CapabilityError>;
+};
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,KAAK,EAAE,eAAe,EAAgD,MAAM,aAAa,CAAC;AACjG,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAElE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,GAAE,SAAS;IAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;CAAE,EAAO,GACtF;IACD,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,GAAG,MAAM,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;CACtF,CAsJA"}

package/dist/registry.js

@@ -0,0 +1,156 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+/**
+ * Create an in-memory registry of model providers. Tenant-scoped:
+ * each tenant owns its own `providerId → ModelProvider` map. The
+ * router receives a tenant's slice, so cross-tenant leakage is
+ * impossible at the routing layer.
+ *
+ * Registration is validated for shape: provider `id` + `region`
+ * non-empty; `models[]` non-empty with unique `name` per entry;
+ * per-model `contextWindow` positive integer; per-model `cost`
+ * non-negative; optional per-model `p95LatencyMs` / `maxOutputTokens`
+ * well-shaped; `invoke` is a function. Duplicate ids within a tenant
+ * are refused — accidental clobber of a running provider would be
+ * catastrophic under a live workload. The same `providerId` may be
+ * registered under different tenants (that's the whole point).
+ */
+export function createProviderRegistry(seed = []) {
+    const byTenant = new Map();
+    function tenantMap(tenantId) {
+        let m = byTenant.get(tenantId);
+        if (m === undefined) {
+            m = new Map();
+            byTenant.set(tenantId, m);
+        }
+        return m;
+    }
+    function validate(p) {
+        if (typeof p.metadata.id !== 'string' || p.metadata.id.length === 0) {
+            return {
+                code: 'invalid-provider',
+                message: 'provider.metadata.id required',
+                reason: 'empty-id',
+            };
+        }
+        if (typeof p.metadata.region !== 'string' || p.metadata.region.length === 0) {
+            return {
+                code: 'invalid-provider',
+                message: `provider "${p.metadata.id}" missing metadata.region`,
+                reason: 'empty-region',
+            };
+        }
+        if (!Array.isArray(p.metadata.models) || p.metadata.models.length === 0) {
+            return {
+                code: 'invalid-provider',
+                message: `provider "${p.metadata.id}" must expose at least one model in metadata.models[]`,
+                reason: 'empty-models',
+            };
+        }
+        const seenNames = new Set();
+        for (const m of p.metadata.models) {
+            if (typeof m.name !== 'string' || m.name.length === 0) {
+                return {
+                    code: 'invalid-provider',
+                    message: `provider "${p.metadata.id}" has a model with empty name`,
+                    reason: 'empty-model-name',
+                };
+            }
+            if (seenNames.has(m.name)) {
+                return {
+                    code: 'invalid-provider',
+                    message: `provider "${p.metadata.id}" declares model "${m.name}" more than once in metadata.models[]`,
+                    reason: 'duplicate-model-name',
+                };
+            }
+            seenNames.add(m.name);
+            if (typeof m.contextWindow !== 'number' ||
+                m.contextWindow <= 0 ||
+                !Number.isInteger(m.contextWindow)) {
+                return {
+                    code: 'invalid-provider',
+                    message: `provider "${p.metadata.id}" model "${m.name}" contextWindow must be a positive integer`,
+                    reason: 'invalid-context-window',
+                };
+            }
+            if (typeof m.cost?.promptUsdPer1kTokens !== 'number' ||
+                m.cost.promptUsdPer1kTokens < 0 ||
+                typeof m.cost.completionUsdPer1kTokens !== 'number' ||
+                m.cost.completionUsdPer1kTokens < 0) {
+                return {
+                    code: 'invalid-provider',
+                    message: `provider "${p.metadata.id}" model "${m.name}" cost table must have non-negative promptUsdPer1kTokens + completionUsdPer1kTokens`,
+                    reason: 'invalid-cost',
+                };
+            }
+            if (m.p95LatencyMs !== undefined &&
+                (typeof m.p95LatencyMs !== 'number' || m.p95LatencyMs < 0)) {
+                return {
+                    code: 'invalid-provider',
+                    message: `provider "${p.metadata.id}" model "${m.name}" p95LatencyMs must be a non-negative number`,
+                    reason: 'invalid-p95-latency',
+                };
+            }
+            if (m.maxOutputTokens !== undefined &&
+                (typeof m.maxOutputTokens !== 'number' ||
+                    m.maxOutputTokens <= 0 ||
+                    !Number.isInteger(m.maxOutputTokens))) {
+                return {
+                    code: 'invalid-provider',
+                    message: `provider "${p.metadata.id}" model "${m.name}" maxOutputTokens must be a positive integer`,
+                    reason: 'invalid-max-output-tokens',
+                };
+            }
+        }
+        if (typeof p.invoke !== 'function') {
+            return {
+                code: 'invalid-provider',
+                message: `provider "${p.metadata.id}" invoke must be a function`,
+                reason: 'invalid-invoke',
+            };
+        }
+        return undefined;
+    }
+    function register(tenantId, provider) {
+        const invalid = validate(provider);
+        if (invalid !== undefined)
+            return { kind: 'err', error: invalid };
+        const m = tenantMap(tenantId);
+        if (m.has(provider.metadata.id)) {
+            const dup = {
+                code: 'duplicate-provider',
+                message: `Provider "${provider.metadata.id}" is already registered for tenant "${tenantId}"`,
+                providerId: provider.metadata.id,
+            };
+            return { kind: 'err', error: dup };
+        }
+        m.set(provider.metadata.id, provider);
+        return { kind: 'ok', value: undefined };
+    }
+    const registry = {
+        register(tenantId, provider) {
+            const r = register(tenantId, provider);
+            if (r.kind === 'err')
+                throw new Error(r.error.message);
+        },
+        get(tenantId, id) {
+            return byTenant.get(tenantId)?.get(id);
+        },
+        list(tenantId) {
+            const m = byTenant.get(tenantId);
+            if (m === undefined)
+                return [];
+            return [...m.values()];
+        },
+        has(tenantId, id) {
+            return byTenant.get(tenantId)?.has(id) ?? false;
+        },
+    };
+    for (const entry of seed) {
+        const r = register(entry.tenantId, entry.provider);
+        if (r.kind === 'err')
+            throw new Error(`seed provider "${entry.provider.metadata.id}" rejected for tenant "${entry.tenantId}": ${r.error.message}`);
+    }
+    return { registry, register };
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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"}