@sriinnu/kosha-discovery 0.5.0

package/dist/discovery/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/discovery/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,cAAc,EAA2B,MAAM,WAAW,CAAC;AAkBpE;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,cAAc;IACtD,QAAQ,CAAC,UAAU,eAAe;IAClC,QAAQ,CAAC,YAAY,eAAe;IACpC,QAAQ,CAAC,OAAO,+BAA+B;IAE/C;;;;;OAKG;IACG,QAAQ,CAAC,UAAU,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAiClG;;OAEG;IACH,OAAO,CAAC,WAAW;IAanB;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAmBzB;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;CAMxB"}

package/dist/discovery/anthropic.js

@@ -0,0 +1,101 @@
+/**
+ * kosha-discovery — Anthropic provider discoverer.
+ *
+ * Queries the Anthropic `/v1/models` endpoint to enumerate all available
+ * Claude models and maps them into normalized {@link ModelCard} objects.
+ * @module
+ */
+import { BaseDiscoverer, MAX_MODELS_PER_PROVIDER } from "./base.js";
+/**
+ * Discovers models available through the Anthropic API.
+ *
+ * Authentication is via `x-api-key` header. The endpoint is paginated,
+ * so we loop until `has_more` is false.
+ */
+export class AnthropicDiscoverer extends BaseDiscoverer {
+    providerId = "anthropic";
+    providerName = "Anthropic";
+    baseUrl = "https://api.anthropic.com";
+    /**
+     * Fetch all models from the Anthropic API using cursor-based pagination.
+     * @param credential - Must contain an `apiKey` or `accessToken`.
+     * @param options    - Optional timeout override (default 10 s).
+     * @returns Normalized model cards, or an empty array if unauthenticated.
+     */
+    async discover(credential, options) {
+        const apiKey = credential.apiKey ?? credential.accessToken;
+        if (!apiKey) {
+            return [];
+        }
+        const timeoutMs = this.validateTimeout(options?.timeout);
+        const headers = {
+            "x-api-key": apiKey,
+            "anthropic-version": "2023-06-01",
+        };
+        const allModels = [];
+        let url = `${this.baseUrl}/v1/models?limit=100`;
+        // Cursor-based pagination: keep fetching pages while `has_more` is true.
+        // Each page returns up to 100 models; `last_id` serves as the cursor.
+        while (url) {
+            const response = await this.fetchJSON(url, headers, timeoutMs);
+            allModels.push(...response.data);
+            if (allModels.length >= MAX_MODELS_PER_PROVIDER)
+                break;
+            if (response.has_more && response.last_id) {
+                url = `${this.baseUrl}/v1/models?limit=100&after_id=${response.last_id}`;
+            }
+            else {
+                url = "";
+            }
+        }
+        return allModels.map((model) => this.toModelCard(model));
+    }
+    /**
+     * Convert an Anthropic API model object into a normalized {@link ModelCard}.
+     */
+    toModelCard(model) {
+        const capabilities = this.inferCapabilities(model.id);
+        const mode = model.id.toLowerCase().includes("embed") ? "embedding" : "chat";
+        return this.makeCard({
+            id: model.id,
+            name: model.display_name || model.id,
+            provider: this.providerId,
+            mode,
+            capabilities,
+        });
+    }
+    /**
+     * Infer capability flags from the model ID string.
+     *
+     * All Claude chat models get "chat", "code", "nlu", and "function_calling".
+     * Vision is added for Claude 3+ models (detected via regex).
+     * @param modelId - The canonical Anthropic model ID.
+     */
+    inferCapabilities(modelId) {
+        const id = modelId.toLowerCase();
+        // Embedding models have a single capability
+        if (id.includes("embed")) {
+            return ["embedding"];
+        }
+        // All Claude chat models get base capabilities
+        const capabilities = ["chat", "code", "nlu", "function_calling"];
+        // Claude 3+ models have multimodal vision support
+        if (this.hasVisionSupport(id)) {
+            capabilities.push("vision");
+        }
+        return capabilities;
+    }
+    /**
+     * Check whether a model ID indicates vision (multimodal) support.
+     *
+     * @param id - Lowercased model ID.
+     * @returns `true` for Claude 3, 3.5, 4, 4.5, 4.6, etc.
+     */
+    hasVisionSupport(id) {
+        // Matches "claude-3", "claude-4", "claude-4-6", etc.
+        // The regex captures a major version >= 3, covering all current and future multimodal Claude models.
+        const visionPattern = /claude-([3-9]|[1-9]\d)/;
+        return visionPattern.test(id);
+    }
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/discovery/anthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../src/discovery/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAkBpE;;;;;GAKG;AACH,MAAM,OAAO,mBAAoB,SAAQ,cAAc;IAC7C,UAAU,GAAG,WAAW,CAAC;IACzB,YAAY,GAAG,WAAW,CAAC;IAC3B,OAAO,GAAG,2BAA2B,CAAC;IAE/C;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,UAA4B,EAAE,OAA8B;QAC1E,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,WAAW,CAAC;QAC3D,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,OAAO,EAAE,CAAC;QACX,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACzD,MAAM,OAAO,GAA2B;YACvC,WAAW,EAAE,MAAM;YACnB,mBAAmB,EAAE,YAAY;SACjC,CAAC;QAEF,MAAM,SAAS,GAAqB,EAAE,CAAC;QACvC,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,sBAAsB,CAAC;QAEhD,yEAAyE;QACzE,sEAAsE;QACtE,OAAO,GAAG,EAAE,CAAC;YACZ,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAwB,GAAG,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;YACtF,SAAS,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YAEjC,IAAI,SAAS,CAAC,MAAM,IAAI,uBAAuB;gBAAE,MAAM;YAEvD,IAAI,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBAC3C,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,iCAAiC,QAAQ,CAAC,OAAO,EAAE,CAAC;YAC1E,CAAC;iBAAM,CAAC;gBACP,GAAG,GAAG,EAAE,CAAC;YACV,CAAC;QACF,CAAC;QAED,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,KAAqB;QACxC,MAAM,YAAY,GAAG,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,WAAoB,CAAC,CAAC,CAAC,MAAe,CAAC;QAE/F,OAAO,IAAI,CAAC,QAAQ,CAAC;YACpB,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,IAAI,EAAE,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,EAAE;YACpC,QAAQ,EAAE,IAAI,CAAC,UAAU;YACzB,IAAI;YACJ,YAAY;SACZ,CAAC,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACK,iBAAiB,CAAC,OAAe;QACxC,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QAEjC,4CAA4C;QAC5C,IAAI,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,WAAW,CAAC,CAAC;QACtB,CAAC;QAED,+CAA+C;QAC/C,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAAC;QAEjE,kDAAkD;QAClD,IAAI,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,EAAE,CAAC;YAC/B,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC;QAED,OAAO,YAAY,CAAC;IACrB,CAAC;IAED;;;;;OAKG;IACK,gBAAgB,CAAC,EAAU;QAClC,qDAAqD;QACrD,qGAAqG;QACrG,MAAM,aAAa,GAAG,wBAAwB,CAAC;QAC/C,OAAO,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;CACD"}

package/dist/discovery/base.d.ts

@@ -0,0 +1,59 @@
+/**
+ * kosha-discovery — Base discoverer abstraction.
+ *
+ * Provides shared HTTP fetching, timeout handling, and {@link ModelCard}
+ * construction logic that every concrete provider discoverer inherits.
+ * @module
+ */
+import type { CredentialResult, ModelCard, ProviderDiscoverer } from "../types.js";
+/** Safety cap for paginated model listing. */
+export declare const MAX_MODELS_PER_PROVIDER = 10000;
+/**
+ * Abstract base class for all provider discoverers.
+ *
+ * Subclasses only need to implement {@link discover} and set the three
+ * readonly identity fields; the base class supplies `fetchJSON` for
+ * HTTP calls and `makeCard` for building uniform {@link ModelCard} objects.
+ */
+export declare abstract class BaseDiscoverer implements ProviderDiscoverer {
+    abstract readonly providerId: string;
+    abstract readonly providerName: string;
+    abstract readonly baseUrl: string;
+    /**
+     * Query the provider's API and return a list of normalized model cards.
+     * @param credential - Resolved credential for authentication.
+     * @param options    - Optional per-request timeout override.
+     */
+    abstract discover(credential: CredentialResult, options?: {
+        timeout?: number;
+    }): Promise<ModelCard[]>;
+    /**
+     * Fetch JSON from a URL with timeout and automatic retry on transient errors.
+     *
+     * Retries up to {@link maxRetries} times with exponential backoff on:
+     * - Network failures (fetch throws)
+     * - Timeout / abort errors
+     * - Server errors (HTTP 5xx)
+     *
+     * Client errors (4xx) are thrown immediately without retry.
+     */
+    protected fetchJSON<T>(url: string, headers?: Record<string, string>, timeoutMs?: number): Promise<T>;
+    /**
+     * Create a ModelCard with sensible defaults for missing fields.
+     *
+     * - `originProvider` defaults to `partial.provider` when not explicitly set,
+     *   which is correct for first-party providers (e.g. "anthropic" serving its
+     *   own Claude models). Aggregators like openrouter or managed services like
+     *   bedrock/vertex should pass an explicit `originProvider` to distinguish
+     *   the serving layer from the original model creator.
+     * - `region` and `projectId` are passed through unchanged when present
+     *   (used by Bedrock and Vertex AI respectively).
+     */
+    /** Validate and normalise a timeout value. Returns defaultMs when invalid. */
+    protected validateTimeout(timeout: number | undefined, defaultMs?: number): number;
+    protected makeCard(partial: Partial<ModelCard> & {
+        id: string;
+        provider: string;
+    }): ModelCard;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/discovery/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/discovery/base.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGnF,8CAA8C;AAC9C,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAa9C;;;;;;GAMG;AACH,8BAAsB,cAAe,YAAW,kBAAkB;IACjE,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAElC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAErG;;;;;;;;;OASG;cACa,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC;IAwD3G;;;;;;;;;;OAUG;IACH,8EAA8E;IAC9E,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,SAAS,GAAG,MAAM;IAIlF,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS;CAkB7F"}

package/dist/discovery/base.js

@@ -0,0 +1,123 @@
+/**
+ * kosha-discovery — Base discoverer abstraction.
+ *
+ * Provides shared HTTP fetching, timeout handling, and {@link ModelCard}
+ * construction logic that every concrete provider discoverer inherits.
+ * @module
+ */
+import { assertCleanPayload } from "../security.js";
+/** Safety cap for paginated model listing. */
+export const MAX_MODELS_PER_PROVIDER = 10_000;
+/** Common API-key patterns to redact from error messages. */
+const API_KEY_PATTERN = /\b(sk-[A-Za-z0-9_-]{8,}|key-[A-Za-z0-9_-]{8,}|Bearer\s+[A-Za-z0-9._\-]{20,})\b/gi;
+/** Sanitize a response body before including it in an error message. */
+function sanitizeErrorBody(raw, maxLen = 200) {
+    const redacted = raw.replace(API_KEY_PATTERN, "[REDACTED]");
+    if (redacted.length <= maxLen)
+        return redacted;
+    return `${redacted.slice(0, maxLen)}…[truncated]`;
+}
+/**
+ * Abstract base class for all provider discoverers.
+ *
+ * Subclasses only need to implement {@link discover} and set the three
+ * readonly identity fields; the base class supplies `fetchJSON` for
+ * HTTP calls and `makeCard` for building uniform {@link ModelCard} objects.
+ */
+export class BaseDiscoverer {
+    /**
+     * Fetch JSON from a URL with timeout and automatic retry on transient errors.
+     *
+     * Retries up to {@link maxRetries} times with exponential backoff on:
+     * - Network failures (fetch throws)
+     * - Timeout / abort errors
+     * - Server errors (HTTP 5xx)
+     *
+     * Client errors (4xx) are thrown immediately without retry.
+     */
+    async fetchJSON(url, headers, timeoutMs = 10_000) {
+        const maxRetries = 3;
+        const baseDelayMs = 500;
+        let lastError;
+        for (let attempt = 0; attempt < maxRetries; attempt++) {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), timeoutMs);
+            try {
+                const response = await fetch(url, {
+                    headers,
+                    signal: controller.signal,
+                });
+                if (!response.ok) {
+                    const body = await response.text().catch(() => "");
+                    const safeBody = body ? sanitizeErrorBody(body) : "";
+                    const err = new Error(`${this.providerName} API error: ${response.status} ${response.statusText}${safeBody ? ` — ${safeBody}` : ""}`);
+                    // 4xx client errors are not transient — fail immediately
+                    if (response.status >= 400 && response.status < 500) {
+                        throw err;
+                    }
+                    // 5xx server errors are retryable
+                    lastError = err;
+                }
+                else {
+                    const data = (await response.json());
+                    assertCleanPayload(data, `${this.providerName} API`);
+                    return data;
+                }
+            }
+            catch (error) {
+                if (error instanceof DOMException && error.name === "AbortError") {
+                    lastError = new Error(`${this.providerName} API request timed out after ${timeoutMs}ms`);
+                }
+                else if (error instanceof Error) {
+                    // 4xx errors rethrown above will have already propagated
+                    lastError = error;
+                }
+                else {
+                    lastError = new Error(String(error));
+                }
+            }
+            finally {
+                clearTimeout(timer);
+            }
+            // Wait before retrying (exponential backoff: 500ms, 1s, 2s)
+            if (attempt < maxRetries - 1) {
+                await new Promise((resolve) => setTimeout(resolve, baseDelayMs * 2 ** attempt));
+            }
+        }
+        throw lastError ?? new Error(`${this.providerName} API request failed after ${maxRetries} attempts`);
+    }
+    /**
+     * Create a ModelCard with sensible defaults for missing fields.
+     *
+     * - `originProvider` defaults to `partial.provider` when not explicitly set,
+     *   which is correct for first-party providers (e.g. "anthropic" serving its
+     *   own Claude models). Aggregators like openrouter or managed services like
+     *   bedrock/vertex should pass an explicit `originProvider` to distinguish
+     *   the serving layer from the original model creator.
+     * - `region` and `projectId` are passed through unchanged when present
+     *   (used by Bedrock and Vertex AI respectively).
+     */
+    /** Validate and normalise a timeout value. Returns defaultMs when invalid. */
+    validateTimeout(timeout, defaultMs = 10_000) {
+        return (Number.isFinite(timeout) && timeout > 0) ? timeout : defaultMs;
+    }
+    makeCard(partial) {
+        const capabilities = partial.capabilities ?? ["chat"];
+        return {
+            name: partial.id,
+            mode: "chat",
+            capabilities,
+            rawCapabilities: partial.rawCapabilities ?? [...capabilities],
+            contextWindow: 0,
+            maxOutputTokens: 0,
+            aliases: [],
+            discoveredAt: Date.now(),
+            source: "api",
+            // originProvider falls back to the serving provider when the caller
+            // does not supply a more-specific original creator.
+            originProvider: partial.originProvider ?? partial.provider,
+            ...partial,
+        };
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/discovery/base.js.map

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

package/dist/discovery/bedrock.d.ts

@@ -0,0 +1,122 @@
+/**
+ * kosha-discovery — AWS Bedrock model discoverer.
+ *
+ * Resolution strategy (in order):
+ * 1. AWS SDK (`@aws-sdk/client-bedrock`) — if installed in the host project.
+ * 2. AWS CLI fallback (`aws bedrock list-foundation-models --output json`).
+ * 3. Static fallback list of well-known Bedrock foundation models (Feb 2026).
+ *
+ * Credentials use the standard AWS credential chain:
+ * environment variables (`AWS_ACCESS_KEY_ID` / `AWS_SECRET_ACCESS_KEY`),
+ * `~/.aws/credentials`, EC2 / ECS instance-metadata IAM roles, etc.
+ * No explicit credential is required by this discoverer — the SDK and CLI
+ * both pick up the ambient credential automatically.
+ *
+ * @module
+ */
+import type { CredentialResult, ModelCard } from "../types.js";
+import { BaseDiscoverer } from "./base.js";
+/**
+ * Discovers models available through AWS Bedrock.
+ *
+ * Tries three resolution strategies in order:
+ * 1. `@aws-sdk/client-bedrock` (if installed in the host project).
+ * 2. AWS CLI (`aws bedrock list-foundation-models`).
+ * 3. Static fallback catalogue.
+ *
+ * The `credential` argument is optional in the sense that the AWS SDK and CLI
+ * both rely on the ambient credential chain.  However, the `credential.metadata`
+ * bag may carry an explicit `{ region }` override.
+ */
+export declare class BedrockDiscoverer extends BaseDiscoverer {
+    readonly providerId = "bedrock";
+    readonly providerName = "AWS Bedrock";
+    readonly baseUrl = "https://bedrock.us-east-1.amazonaws.com";
+    /**
+     * Discover all foundation models available on AWS Bedrock.
+     *
+     * Resolution order: SDK → CLI → static fallback.
+     *
+     * @param credential - Optional credential; `metadata.region` overrides the
+     *                     `AWS_DEFAULT_REGION` environment variable.
+     * @param options    - Optional timeout in milliseconds (used for CLI exec).
+     */
+    discover(credential: CredentialResult, options?: {
+        timeout?: number;
+    }): Promise<ModelCard[]>;
+    /**
+     * Use `@aws-sdk/client-bedrock` to list foundation models.
+     *
+     * Dynamic import prevents a hard dependency: the SDK is optional and must
+     * be installed separately by the host project.  If the import fails we
+     * throw so the caller can fall through to the next strategy.
+     *
+     * @throws When `@aws-sdk/client-bedrock` is not installed, or the API call fails.
+     */
+    private discoverViaSdk;
+    /**
+     * Use the `aws` CLI to list foundation models.
+     *
+     * Runs `aws bedrock list-foundation-models --region {region} --output json`
+     * synchronously.  Wrapped in try/catch so failures are surfaced to the caller
+     * as thrown errors, letting `discover()` fall through gracefully.
+     *
+     * @throws When the `aws` CLI is not installed or returns a non-zero exit code.
+     */
+    private discoverViaCli;
+    /**
+     * Return a hardcoded catalogue of well-known Bedrock foundation models.
+     *
+     * Used when neither the SDK nor the CLI is available.  All entries have
+     * `source: "manual"` and zero context/output token limits — the litellm
+     * enrichment pass is expected to populate those fields later.
+     */
+    private staticFallback;
+    /**
+     * Convert a raw Bedrock foundation model summary into a {@link ModelCard}.
+     *
+     * @param model  - Raw model summary from SDK or CLI.
+     * @param source - Whether the data came from a live API call or static data.
+     * @param credential - Used to attach the resolved AWS region.
+     */
+    private toModelCard;
+    /**
+     * Infer the primary {@link ModelMode} from Bedrock output modalities.
+     *
+     * Bedrock reports modalities as uppercase strings: "TEXT", "IMAGE", "EMBEDDING".
+     * We pick the most specific non-TEXT modality first; TEXT-only → "chat".
+     */
+    private inferMode;
+    /**
+     * Infer capability flags from Bedrock input/output modalities and inference types.
+     *
+     * - "embedding" models → ["embedding"]
+     * - "image" output-only models → ["image"]
+     * - All chat models get ["chat"] plus optional vision/code/function_calling
+     */
+    private inferCapabilities;
+    /**
+     * Resolve the AWS region to use for API calls.
+     *
+     * Priority: `credential.metadata.region` > `AWS_DEFAULT_REGION` env var > `"us-east-1"`.
+     */
+    private resolveRegion;
+}
+/**
+ * Extract the origin provider from a Bedrock model ID.
+ *
+ * Bedrock model IDs follow the pattern `{vendor}.{model-name}-v{n}:{variant}`,
+ * e.g. `anthropic.claude-opus-4-6-v1:0` → `"anthropic"`.
+ *
+ * Falls back to `"unknown"` for unrecognised vendor prefixes.
+ *
+ * @param modelId - A Bedrock foundation model ID.
+ * @returns The canonical origin provider string.
+ *
+ * @example
+ * inferOriginFromBedrockId("anthropic.claude-sonnet-4-6-v1:0") // "anthropic"
+ * inferOriginFromBedrockId("meta.llama3-3-70b-instruct-v1:0")  // "meta"
+ * inferOriginFromBedrockId("amazon.titan-text-premier-v2:0")   // "amazon"
+ */
+export declare function inferOriginFromBedrockId(modelId: string): string;
+//# sourceMappingURL=bedrock.d.ts.map

package/dist/discovery/bedrock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bedrock.d.ts","sourceRoot":"","sources":["../../src/discovery/bedrock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAa,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAwH3C;;;;;;;;;;;GAWG;AACH,qBAAa,iBAAkB,SAAQ,cAAc;IACpD,QAAQ,CAAC,UAAU,aAAa;IAChC,QAAQ,CAAC,YAAY,iBAAiB;IACtC,QAAQ,CAAC,OAAO,6CAA6C;IAE7D;;;;;;;;OAQG;IACG,QAAQ,CAAC,UAAU,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IA6BlG;;;;;;;;OAQG;YACW,cAAc;IAmB5B;;;;;;;;OAQG;YACW,cAAc;IAuC5B;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAoBtB;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;IAwBnB;;;;;OAKG;IACH,OAAO,CAAC,SAAS;IAiBjB;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAoCzB;;;;OAIG;IACH,OAAO,CAAC,aAAa;CAGrB;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAShE"}