@tanstack/ai-bedrock 1.2.1 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -85,16 +85,35 @@ const adapter = createBedrockText(
85
85
  )
86
86
  ```
87
87
 
88
+ ## Reranking
89
+
90
+ Call `rerank()` with `bedrockRerank()` on the server to sort documents by relevance.
91
+
92
+ First, install `@aws-sdk/credential-providers` and configure AWS credentials. Bedrock API keys do not work for reranking. See [Bedrock reranking](https://tanstack.com/ai/latest/docs/adapters/bedrock#reranking) for permissions and model configuration.
93
+
94
+ ```typescript
95
+ import { rerank } from '@tanstack/ai'
96
+ import { bedrockRerank } from '@tanstack/ai-bedrock'
97
+
98
+ const { rerankedDocuments } = await rerank({
99
+ adapter: bedrockRerank('cohere.rerank-v3-5:0'),
100
+ query: 'talk about rain',
101
+ documents: ['sunny day at the beach', 'rainy afternoon in the city'],
102
+ topN: 2,
103
+ })
104
+ ```
105
+
88
106
  ## Authentication
89
107
 
90
- Auth is resolved in this order:
108
+ For chat and embeddings, auth is resolved in this order:
91
109
 
92
110
  1. Explicit `apiKey` passed to the factory
93
111
  2. `BEDROCK_API_KEY` environment variable
94
112
  3. `AWS_BEARER_TOKEN_BEDROCK` environment variable
95
113
  4. SigV4 via the AWS credential chain
96
114
 
97
- SigV4 signing is built in — no additional packages required. On the Converse
115
+ SigV4 signing is built in. The AWS credential chain requires
116
+ `@aws-sdk/credential-providers`. On the Converse
98
117
  (default) path the `@aws-sdk/client-bedrock-runtime` client signs requests
99
118
  itself; the OpenAI-compatible chat/responses paths sign via the bundled
100
119
  `@smithy/signature-v4`. Set `auth: 'sigv4'` and provide AWS credentials through
@@ -0,0 +1,33 @@
1
+ import { BaseRerankAdapter } from '@tanstack/ai/adapters';
2
+ import { RerankAdapterResult, RerankOptions } from '@tanstack/ai';
3
+ import { BedrockRerankModel } from '../model-meta.js';
4
+ /** Bedrock rerank uses AWS credentials, not Bedrock API keys. */
5
+ export interface BedrockRerankConfig {
6
+ /** AWS region; defaults to us-east-1. Amazon Rerank requires another region. */
7
+ region?: string;
8
+ /** Overrides the agent-runtime base URL, without the /rerank suffix. */
9
+ baseURL?: string;
10
+ /** Headers added before SigV4 signing. */
11
+ defaultHeaders?: Record<string, string>;
12
+ /** Custom transport; requests are still SigV4-signed. */
13
+ fetch?: typeof fetch;
14
+ }
15
+ /** Additional inference fields for the selected Bedrock rerank model. */
16
+ export interface BedrockRerankProviderOptions {
17
+ additionalModelRequestFields?: Record<string, unknown>;
18
+ }
19
+ /** Bedrock rerank adapter; core maps scored indices to original documents. */
20
+ export declare class BedrockRerankAdapter<TModel extends BedrockRerankModel> extends BaseRerankAdapter<TModel, BedrockRerankProviderOptions> {
21
+ readonly name: "bedrock";
22
+ private readonly region;
23
+ private readonly baseURL;
24
+ private readonly clientConfig;
25
+ constructor(config: BedrockRerankConfig, model: TModel);
26
+ rerank(options: RerankOptions<BedrockRerankProviderOptions>): Promise<RerankAdapterResult>;
27
+ }
28
+ /**
29
+ * Creates a Bedrock rerank adapter using the AWS credential chain (SigV4).
30
+ * Install `@aws-sdk/credential-providers`; Bedrock API keys are not supported.
31
+ * For `amazon.rerank-v1:0`, select a supported region such as `us-west-2`.
32
+ */
33
+ export declare function bedrockRerank<TModel extends BedrockRerankModel>(model: TModel, config?: BedrockRerankConfig): BedrockRerankAdapter<TModel>;
@@ -0,0 +1,123 @@
1
+ import { resolveBedrockAuth } from "../utils/auth.js";
2
+ import { createSigV4Fetch } from "../utils/openai-sigv4-fetch.js";
3
+ import { BaseRerankAdapter } from "@tanstack/ai/adapters";
4
+ import { toRunErrorPayload } from "@tanstack/ai/adapter-internals";
5
+ //#region src/adapters/rerank.ts
6
+ function isBedrockRerankResponse(value) {
7
+ return typeof value === "object" && value !== null && "results" in value && Array.isArray(value.results) && value.results.every((result) => typeof result === "object" && result !== null && Number.isInteger(result.index) && Number.isFinite(result.relevanceScore)) && (!("nextToken" in value) || typeof value.nextToken === "string" && value.nextToken.length > 0 && value.nextToken.length <= 2048 && !/\s/.test(value.nextToken));
8
+ }
9
+ /** Bedrock rerank adapter; core maps scored indices to original documents. */
10
+ var BedrockRerankAdapter = class extends BaseRerankAdapter {
11
+ name = "bedrock";
12
+ region;
13
+ baseURL;
14
+ clientConfig;
15
+ constructor(config, model) {
16
+ super({}, model);
17
+ this.clientConfig = config;
18
+ this.region = config.region ?? "us-east-1";
19
+ this.baseURL = (config.baseURL ?? `https://bedrock-agent-runtime.${this.region}.amazonaws.com`).replace(/\/+$/, "");
20
+ }
21
+ async rerank(options) {
22
+ const { model, query, documents, topN, modelOptions, abortSignal, logger } = options;
23
+ try {
24
+ if (documents.length < 1 || documents.length > 1e3) throw new Error("Bedrock rerank requires between 1 and 1000 documents");
25
+ const numberOfResults = topN ?? documents.length;
26
+ if (!Number.isInteger(numberOfResults) || numberOfResults < 1 || numberOfResults > 1e3) throw new Error("Bedrock rerank topN must be an integer between 1 and 1000");
27
+ const body = {
28
+ queries: [{
29
+ type: "TEXT",
30
+ textQuery: { text: query }
31
+ }],
32
+ sources: documents.map((text) => ({
33
+ type: "INLINE",
34
+ inlineDocumentSource: {
35
+ type: "TEXT",
36
+ textDocument: { text }
37
+ }
38
+ })),
39
+ rerankingConfiguration: {
40
+ type: "BEDROCK_RERANKING_MODEL",
41
+ bedrockRerankingConfiguration: {
42
+ modelConfiguration: {
43
+ modelArn: `arn:aws:bedrock:${this.region}::foundation-model/${model}`,
44
+ additionalModelRequestFields: modelOptions?.additionalModelRequestFields
45
+ },
46
+ numberOfResults
47
+ }
48
+ }
49
+ };
50
+ const signedFetch = createSigV4Fetch(resolveBedrockAuth({
51
+ region: this.region,
52
+ auth: "sigv4"
53
+ }, "runtime"), this.clientConfig.fetch);
54
+ const ranking = [];
55
+ const seenTokens = /* @__PURE__ */ new Set();
56
+ let nextToken;
57
+ let id;
58
+ do {
59
+ abortSignal?.throwIfAborted();
60
+ logger.request(`activity=rerank provider=${this.name} model=${model} documents=${documents.length}`, {
61
+ provider: this.name,
62
+ model
63
+ });
64
+ const response = await signedFetch(`${this.baseURL}/rerank`, {
65
+ method: "POST",
66
+ headers: {
67
+ "Content-Type": "application/json",
68
+ ...this.clientConfig.defaultHeaders
69
+ },
70
+ body: JSON.stringify({
71
+ ...body,
72
+ nextToken
73
+ }),
74
+ signal: abortSignal
75
+ });
76
+ if (!response.ok) {
77
+ const detail = await response.text();
78
+ throw new Error(`Bedrock rerank request failed: ${response.status} ${response.statusText}${detail ? `: ${detail}` : ""}`);
79
+ }
80
+ const page = await response.json();
81
+ abortSignal?.throwIfAborted();
82
+ if (!isBedrockRerankResponse(page)) throw new Error("Bedrock rerank response had an unexpected shape");
83
+ id ??= response.headers.get("x-amzn-requestid") ?? void 0;
84
+ ranking.push(...page.results.map((result) => ({
85
+ index: result.index,
86
+ score: result.relevanceScore
87
+ })));
88
+ nextToken = page.nextToken;
89
+ if (nextToken) {
90
+ if (seenTokens.has(nextToken)) throw new Error("Bedrock rerank pagination did not advance");
91
+ seenTokens.add(nextToken);
92
+ }
93
+ } while (nextToken && ranking.length < numberOfResults);
94
+ return {
95
+ id: id ?? this.generateId(),
96
+ ranking: ranking.slice(0, numberOfResults),
97
+ usage: {
98
+ promptTokens: 0,
99
+ completionTokens: 0,
100
+ totalTokens: 0
101
+ }
102
+ };
103
+ } catch (error) {
104
+ logger.errors(`${this.name}.rerank fatal`, {
105
+ error: toRunErrorPayload(error, "Bedrock rerank failed"),
106
+ source: `${this.name}.rerank`
107
+ });
108
+ throw error;
109
+ }
110
+ }
111
+ };
112
+ /**
113
+ * Creates a Bedrock rerank adapter using the AWS credential chain (SigV4).
114
+ * Install `@aws-sdk/credential-providers`; Bedrock API keys are not supported.
115
+ * For `amazon.rerank-v1:0`, select a supported region such as `us-west-2`.
116
+ */
117
+ function bedrockRerank(model, config) {
118
+ return new BedrockRerankAdapter(config ?? {}, model);
119
+ }
120
+ //#endregion
121
+ export { BedrockRerankAdapter, bedrockRerank };
122
+
123
+ //# sourceMappingURL=rerank.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rerank.js","names":[],"sources":["../../../src/adapters/rerank.ts"],"sourcesContent":["import { BaseRerankAdapter } from '@tanstack/ai/adapters'\nimport { toRunErrorPayload } from '@tanstack/ai/adapter-internals'\nimport { resolveBedrockAuth } from '../utils/auth'\nimport { createSigV4Fetch } from '../utils/openai-sigv4-fetch'\nimport type { RerankAdapterResult, RerankOptions } from '@tanstack/ai'\nimport type { BedrockRerankModel } from '../model-meta'\n\n/** Bedrock rerank uses AWS credentials, not Bedrock API keys. */\nexport interface BedrockRerankConfig {\n /** AWS region; defaults to us-east-1. Amazon Rerank requires another region. */\n region?: string\n /** Overrides the agent-runtime base URL, without the /rerank suffix. */\n baseURL?: string\n /** Headers added before SigV4 signing. */\n defaultHeaders?: Record<string, string>\n /** Custom transport; requests are still SigV4-signed. */\n fetch?: typeof fetch\n}\n\n/** Additional inference fields for the selected Bedrock rerank model. */\nexport interface BedrockRerankProviderOptions {\n additionalModelRequestFields?: Record<string, unknown>\n}\n\ninterface BedrockRerankResponse {\n results: Array<{ index: number; relevanceScore: number }>\n nextToken?: string\n}\n\nfunction isBedrockRerankResponse(\n value: unknown,\n): value is BedrockRerankResponse {\n return (\n typeof value === 'object' &&\n value !== null &&\n 'results' in value &&\n Array.isArray(value.results) &&\n value.results.every(\n (result) =>\n typeof result === 'object' &&\n result !== null &&\n Number.isInteger(result.index) &&\n Number.isFinite(result.relevanceScore),\n ) &&\n (!('nextToken' in value) ||\n (typeof value.nextToken === 'string' &&\n value.nextToken.length > 0 &&\n value.nextToken.length <= 2048 &&\n !/\\s/.test(value.nextToken)))\n )\n}\n\n/** Bedrock rerank adapter; core maps scored indices to original documents. */\nexport class BedrockRerankAdapter<\n TModel extends BedrockRerankModel,\n> extends BaseRerankAdapter<TModel, BedrockRerankProviderOptions> {\n readonly name = 'bedrock' as const\n private readonly region: string\n private readonly baseURL: string\n private readonly clientConfig: BedrockRerankConfig\n\n constructor(config: BedrockRerankConfig, model: TModel) {\n super({}, model)\n this.clientConfig = config\n this.region = config.region ?? 'us-east-1'\n this.baseURL = (\n config.baseURL ??\n `https://bedrock-agent-runtime.${this.region}.amazonaws.com`\n ).replace(/\\/+$/, '')\n }\n\n async rerank(\n options: RerankOptions<BedrockRerankProviderOptions>,\n ): Promise<RerankAdapterResult> {\n const { model, query, documents, topN, modelOptions, abortSignal, logger } =\n options\n\n try {\n if (documents.length < 1 || documents.length > 1000) {\n throw new Error('Bedrock rerank requires between 1 and 1000 documents')\n }\n const numberOfResults = topN ?? documents.length\n if (\n !Number.isInteger(numberOfResults) ||\n numberOfResults < 1 ||\n numberOfResults > 1000\n ) {\n throw new Error(\n 'Bedrock rerank topN must be an integer between 1 and 1000',\n )\n }\n\n const body = {\n queries: [{ type: 'TEXT', textQuery: { text: query } }],\n sources: documents.map((text) => ({\n type: 'INLINE',\n inlineDocumentSource: { type: 'TEXT', textDocument: { text } },\n })),\n rerankingConfiguration: {\n type: 'BEDROCK_RERANKING_MODEL',\n bedrockRerankingConfiguration: {\n modelConfiguration: {\n modelArn: `arn:aws:bedrock:${this.region}::foundation-model/${model}`,\n additionalModelRequestFields:\n modelOptions?.additionalModelRequestFields,\n },\n numberOfResults,\n },\n },\n }\n const signedFetch = createSigV4Fetch(\n resolveBedrockAuth({ region: this.region, auth: 'sigv4' }, 'runtime'),\n this.clientConfig.fetch,\n )\n const ranking: RerankAdapterResult['ranking'] = []\n const seenTokens = new Set<string>()\n let nextToken: string | undefined\n let id: string | undefined\n\n do {\n abortSignal?.throwIfAborted()\n logger.request(\n `activity=rerank provider=${this.name} model=${model} documents=${documents.length}`,\n { provider: this.name, model },\n )\n const response = await signedFetch(`${this.baseURL}/rerank`, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json',\n ...this.clientConfig.defaultHeaders,\n },\n body: JSON.stringify({ ...body, nextToken }),\n signal: abortSignal,\n })\n if (!response.ok) {\n const detail = await response.text()\n throw new Error(\n `Bedrock rerank request failed: ${response.status} ${response.statusText}${detail ? `: ${detail}` : ''}`,\n )\n }\n const page: unknown = await response.json()\n abortSignal?.throwIfAborted()\n if (!isBedrockRerankResponse(page)) {\n throw new Error('Bedrock rerank response had an unexpected shape')\n }\n id ??= response.headers.get('x-amzn-requestid') ?? undefined\n ranking.push(\n ...page.results.map((result) => ({\n index: result.index,\n score: result.relevanceScore,\n })),\n )\n nextToken = page.nextToken\n if (nextToken) {\n if (seenTokens.has(nextToken)) {\n throw new Error('Bedrock rerank pagination did not advance')\n }\n seenTokens.add(nextToken)\n }\n } while (nextToken && ranking.length < numberOfResults)\n\n return {\n id: id ?? this.generateId(),\n ranking: ranking.slice(0, numberOfResults),\n // The Bedrock Rerank API reports neither token counts nor billed units.\n usage: { promptTokens: 0, completionTokens: 0, totalTokens: 0 },\n }\n } catch (error) {\n logger.errors(`${this.name}.rerank fatal`, {\n error: toRunErrorPayload(error, 'Bedrock rerank failed'),\n source: `${this.name}.rerank`,\n })\n throw error\n }\n }\n}\n\n/**\n * Creates a Bedrock rerank adapter using the AWS credential chain (SigV4).\n * Install `@aws-sdk/credential-providers`; Bedrock API keys are not supported.\n * For `amazon.rerank-v1:0`, select a supported region such as `us-west-2`.\n */\nexport function bedrockRerank<TModel extends BedrockRerankModel>(\n model: TModel,\n config?: BedrockRerankConfig,\n): BedrockRerankAdapter<TModel> {\n return new BedrockRerankAdapter(config ?? {}, model)\n}\n"],"mappings":";;;;;AA6BA,SAAS,wBACP,OACgC;CAChC,OACE,OAAO,UAAU,YACjB,UAAU,QACV,aAAa,SACb,MAAM,QAAQ,MAAM,OAAO,KAC3B,MAAM,QAAQ,OACX,WACC,OAAO,WAAW,YAClB,WAAW,QACX,OAAO,UAAU,OAAO,KAAK,KAC7B,OAAO,SAAS,OAAO,cAAc,CACzC,MACC,EAAE,eAAe,UACf,OAAO,MAAM,cAAc,YAC1B,MAAM,UAAU,SAAS,KACzB,MAAM,UAAU,UAAU,QAC1B,CAAC,KAAK,KAAK,MAAM,SAAS;AAElC;;AAGA,IAAa,uBAAb,cAEU,kBAAwD;CAChE,OAAgB;CAChB;CACA;CACA;CAEA,YAAY,QAA6B,OAAe;EACtD,MAAM,CAAC,GAAG,KAAK;EACf,KAAK,eAAe;EACpB,KAAK,SAAS,OAAO,UAAU;EAC/B,KAAK,WACH,OAAO,WACP,iCAAiC,KAAK,OAAO,gBAAA,CAC7C,QAAQ,QAAQ,EAAE;CACtB;CAEA,MAAM,OACJ,SAC8B;EAC9B,MAAM,EAAE,OAAO,OAAO,WAAW,MAAM,cAAc,aAAa,WAChE;EAEF,IAAI;GACF,IAAI,UAAU,SAAS,KAAK,UAAU,SAAS,KAC7C,MAAM,IAAI,MAAM,sDAAsD;GAExE,MAAM,kBAAkB,QAAQ,UAAU;GAC1C,IACE,CAAC,OAAO,UAAU,eAAe,KACjC,kBAAkB,KAClB,kBAAkB,KAElB,MAAM,IAAI,MACR,2DACF;GAGF,MAAM,OAAO;IACX,SAAS,CAAC;KAAE,MAAM;KAAQ,WAAW,EAAE,MAAM,MAAM;IAAE,CAAC;IACtD,SAAS,UAAU,KAAK,UAAU;KAChC,MAAM;KACN,sBAAsB;MAAE,MAAM;MAAQ,cAAc,EAAE,KAAK;KAAE;IAC/D,EAAE;IACF,wBAAwB;KACtB,MAAM;KACN,+BAA+B;MAC7B,oBAAoB;OAClB,UAAU,mBAAmB,KAAK,OAAO,qBAAqB;OAC9D,8BACE,cAAc;MAClB;MACA;KACF;IACF;GACF;GACA,MAAM,cAAc,iBAClB,mBAAmB;IAAE,QAAQ,KAAK;IAAQ,MAAM;GAAQ,GAAG,SAAS,GACpE,KAAK,aAAa,KACpB;GACA,MAAM,UAA0C,CAAC;GACjD,MAAM,6BAAa,IAAI,IAAY;GACnC,IAAI;GACJ,IAAI;GAEJ,GAAG;IACD,aAAa,eAAe;IAC5B,OAAO,QACL,4BAA4B,KAAK,KAAK,SAAS,MAAM,aAAa,UAAU,UAC5E;KAAE,UAAU,KAAK;KAAM;IAAM,CAC/B;IACA,MAAM,WAAW,MAAM,YAAY,GAAG,KAAK,QAAQ,UAAU;KAC3D,QAAQ;KACR,SAAS;MACP,gBAAgB;MAChB,GAAG,KAAK,aAAa;KACvB;KACA,MAAM,KAAK,UAAU;MAAE,GAAG;MAAM;KAAU,CAAC;KAC3C,QAAQ;IACV,CAAC;IACD,IAAI,CAAC,SAAS,IAAI;KAChB,MAAM,SAAS,MAAM,SAAS,KAAK;KACnC,MAAM,IAAI,MACR,kCAAkC,SAAS,OAAO,GAAG,SAAS,aAAa,SAAS,KAAK,WAAW,IACtG;IACF;IACA,MAAM,OAAgB,MAAM,SAAS,KAAK;IAC1C,aAAa,eAAe;IAC5B,IAAI,CAAC,wBAAwB,IAAI,GAC/B,MAAM,IAAI,MAAM,iDAAiD;IAEnE,OAAO,SAAS,QAAQ,IAAI,kBAAkB,KAAK,KAAA;IACnD,QAAQ,KACN,GAAG,KAAK,QAAQ,KAAK,YAAY;KAC/B,OAAO,OAAO;KACd,OAAO,OAAO;IAChB,EAAE,CACJ;IACA,YAAY,KAAK;IACjB,IAAI,WAAW;KACb,IAAI,WAAW,IAAI,SAAS,GAC1B,MAAM,IAAI,MAAM,2CAA2C;KAE7D,WAAW,IAAI,SAAS;IAC1B;GACF,SAAS,aAAa,QAAQ,SAAS;GAEvC,OAAO;IACL,IAAI,MAAM,KAAK,WAAW;IAC1B,SAAS,QAAQ,MAAM,GAAG,eAAe;IAEzC,OAAO;KAAE,cAAc;KAAG,kBAAkB;KAAG,aAAa;IAAE;GAChE;EACF,SAAS,OAAO;GACd,OAAO,OAAO,GAAG,KAAK,KAAK,gBAAgB;IACzC,OAAO,kBAAkB,OAAO,uBAAuB;IACvD,QAAQ,GAAG,KAAK,KAAK;GACvB,CAAC;GACD,MAAM;EACR;CACF;AACF;;;;;;AAOA,SAAgB,cACd,OACA,QAC8B;CAC9B,OAAO,IAAI,qBAAqB,UAAU,CAAC,GAAG,KAAK;AACrD"}
@@ -24,8 +24,9 @@ export { BedrockTextAdapter, createBedrockChat, type BedrockTextConfig, type Bed
24
24
  export { BedrockResponsesTextAdapter, createBedrockResponsesText, type BedrockResponsesConfig, type BedrockResponsesProviderOptions, } from './adapters/responses-text.js';
25
25
  export { BedrockConverseTextAdapter, createBedrockConverse, type BedrockConverseConfig, } from './adapters/converse-text.js';
26
26
  export { BedrockEmbeddingAdapter, bedrockEmbedding, createBedrockEmbedding, type BedrockEmbeddingConfig, } from './adapters/embedding.js';
27
+ export { BedrockRerankAdapter, bedrockRerank, type BedrockRerankConfig, type BedrockRerankProviderOptions, } from './adapters/rerank.js';
27
28
  export type { BedrockCohereEmbeddingInputType, BedrockCohereEmbeddingProviderOptions, BedrockEmbeddingProviderOptions, BedrockTitanImageEmbeddingProviderOptions, BedrockTitanTextEmbeddingProviderOptions, } from './embedding/embedding-provider-options.js';
28
29
  export type { BedrockConverseProviderOptions } from './converse/provider-options.js';
29
30
  export { resolveBedrockAuth, withBedrockDefaults, type BedrockClientConfig, type BedrockEndpoint, type ResolvedBedrockAuth, } from './utils/client.js';
30
- export { BEDROCK_CHAT_MODELS, BEDROCK_RESPONSES_MODELS, BEDROCK_CONVERSE_MODELS, BEDROCK_EMBEDDING_MODELS, type BedrockEmbeddingModel, type BedrockEmbeddingModelProviderOptionsByName, type BedrockEmbeddingModelInputModalitiesByName, type BedrockChatModels, type BedrockResponsesModels, type BedrockConverseModels, type BedrockChatModelProviderOptionsByName, type BedrockChatModelToolCapabilitiesByName, type BedrockModelInputModalitiesByName, } from './model-meta.js';
31
+ export { BEDROCK_CHAT_MODELS, BEDROCK_RESPONSES_MODELS, BEDROCK_CONVERSE_MODELS, BEDROCK_EMBEDDING_MODELS, BEDROCK_RERANK_MODELS, type BedrockRerankModel, type BedrockEmbeddingModel, type BedrockEmbeddingModelProviderOptionsByName, type BedrockEmbeddingModelInputModalitiesByName, type BedrockChatModels, type BedrockResponsesModels, type BedrockConverseModels, type BedrockChatModelProviderOptionsByName, type BedrockChatModelToolCapabilitiesByName, type BedrockModelInputModalitiesByName, } from './model-meta.js';
31
32
  export type { BedrockCachePoint, BedrockSystemPromptMetadata, BedrockToolMetadata, BedrockMessageMetadataByModality, BedrockTextMetadata, BedrockImageMetadata, BedrockAudioMetadata, BedrockVideoMetadata, BedrockDocumentMetadata, } from './message-types.js';
package/dist/esm/index.js CHANGED
@@ -1,18 +1,18 @@
1
1
  import { resolveBedrockAuth } from "./utils/auth.js";
2
2
  import { withBedrockDefaults } from "./utils/client.js";
3
- import { BEDROCK_CHAT_MODELS, BEDROCK_CONVERSE_MODELS, BEDROCK_EMBEDDING_MODELS, BEDROCK_RESPONSES_MODELS } from "./model-meta.js";
3
+ import { BEDROCK_CHAT_MODELS, BEDROCK_CONVERSE_MODELS, BEDROCK_EMBEDDING_MODELS, BEDROCK_RERANK_MODELS, BEDROCK_RESPONSES_MODELS } from "./model-meta.js";
4
4
  import { BedrockTextAdapter, createBedrockChat } from "./adapters/text.js";
5
5
  import { BedrockResponsesTextAdapter, createBedrockResponsesText } from "./adapters/responses-text.js";
6
6
  import { BedrockConverseTextAdapter, createBedrockConverse } from "./adapters/converse-text.js";
7
7
  import { BedrockEmbeddingAdapter, bedrockEmbedding, createBedrockEmbedding } from "./adapters/embedding.js";
8
+ import { BedrockRerankAdapter, bedrockRerank } from "./adapters/rerank.js";
8
9
  //#region src/index.ts
9
10
  /**
10
11
  * @module @tanstack/ai-bedrock
11
12
  *
12
- * Amazon Bedrock adapter for TanStack AI via Bedrock's OpenAI-compatible APIs
13
- * and the native Converse API. The public `bedrockText` / `createBedrockText`
14
- * factory branches between the Converse adapter (DEFAULT), the Chat Completions
15
- * adapter (`api: 'chat'`), and the Responses adapter (`api: 'responses'`).
13
+ * Bedrock chat uses Converse by default, or the OpenAI-compatible APIs with
14
+ * `api: 'chat'` or `api: 'responses'`. Embeddings and reranking use
15
+ * `bedrockEmbedding` and `bedrockRerank`.
16
16
  */
17
17
  /** Cast-free runtime guard: is this model in the Responses-capable subset? */
18
18
  function isResponsesModel(model) {
@@ -62,6 +62,6 @@ function bedrockText(model, config) {
62
62
  return build(model, config);
63
63
  }
64
64
  //#endregion
65
- export { BEDROCK_CHAT_MODELS, BEDROCK_CONVERSE_MODELS, BEDROCK_EMBEDDING_MODELS, BEDROCK_RESPONSES_MODELS, BedrockConverseTextAdapter, BedrockEmbeddingAdapter, BedrockResponsesTextAdapter, BedrockTextAdapter, bedrockEmbedding, bedrockText, createBedrockChat, createBedrockConverse, createBedrockEmbedding, createBedrockResponsesText, createBedrockText, resolveBedrockAuth, withBedrockDefaults };
65
+ export { BEDROCK_CHAT_MODELS, BEDROCK_CONVERSE_MODELS, BEDROCK_EMBEDDING_MODELS, BEDROCK_RERANK_MODELS, BEDROCK_RESPONSES_MODELS, BedrockConverseTextAdapter, BedrockEmbeddingAdapter, BedrockRerankAdapter, BedrockResponsesTextAdapter, BedrockTextAdapter, bedrockEmbedding, bedrockRerank, bedrockText, createBedrockChat, createBedrockConverse, createBedrockEmbedding, createBedrockResponsesText, createBedrockText, resolveBedrockAuth, withBedrockDefaults };
66
66
 
67
67
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","names":[],"sources":["../../src/index.ts"],"sourcesContent":["/**\n * @module @tanstack/ai-bedrock\n *\n * Amazon Bedrock adapter for TanStack AI via Bedrock's OpenAI-compatible APIs\n * and the native Converse API. The public `bedrockText` / `createBedrockText`\n * factory branches between the Converse adapter (DEFAULT), the Chat Completions\n * adapter (`api: 'chat'`), and the Responses adapter (`api: 'responses'`).\n */\n\nimport { BedrockTextAdapter } from './adapters/text'\nimport { BedrockResponsesTextAdapter } from './adapters/responses-text'\nimport { BedrockConverseTextAdapter } from './adapters/converse-text'\nimport {\n BEDROCK_CHAT_MODELS,\n BEDROCK_CONVERSE_MODELS,\n BEDROCK_RESPONSES_MODELS,\n} from './model-meta'\nimport type { BedrockTextConfig } from './adapters/text'\nimport type { BedrockResponsesConfig } from './adapters/responses-text'\nimport type { BedrockConverseConfig } from './adapters/converse-text'\nimport type { BedrockClientConfig } from './utils/client'\nimport type {\n BedrockChatModels,\n BedrockConverseModels,\n BedrockResponsesModels,\n} from './model-meta'\n\n/** Config for the branching factory's converse mode (default, or api: 'converse'). */\nexport type BedrockConverseApiConfig = BedrockConverseConfig & {\n api?: 'converse'\n}\n/** Config for the branching factory's chat mode (api: 'chat' required). */\nexport type BedrockChatApiConfig = BedrockTextConfig & {\n api: 'chat'\n}\n/** Config for the branching factory's responses mode (api: 'responses' required). */\nexport type BedrockResponsesApiConfig = BedrockResponsesConfig & {\n api: 'responses'\n}\n\ntype AnyBedrockAdapter =\n | BedrockConverseTextAdapter<BedrockConverseModels>\n | BedrockTextAdapter<BedrockChatModels>\n | BedrockResponsesTextAdapter<BedrockResponsesModels>\n\n/** Any catalog id the branching factory can receive. */\ntype BedrockFactoryModel =\n | BedrockConverseModels\n | BedrockChatModels\n | BedrockResponsesModels\n\n/** Cast-free runtime guard: is this model in the Responses-capable subset? */\nfunction isResponsesModel(model: string): model is BedrockResponsesModels {\n return BEDROCK_RESPONSES_MODELS.some((m) => m === model)\n}\n\n/** Cast-free runtime guard: is this model in the Chat-capable subset? */\nfunction isChatModel(model: string): model is BedrockChatModels {\n return BEDROCK_CHAT_MODELS.some((m) => m === model)\n}\n\n/** Cast-free runtime guard: is this model in the Converse-capable subset? */\nfunction isConverseModel(model: string): model is BedrockConverseModels {\n return BEDROCK_CONVERSE_MODELS.some((m) => m === model)\n}\n\n/** Strip the `api` discriminator from a config without an unused-var lint error. */\nfunction stripApi<T extends { api?: unknown }>(config: T): Omit<T, 'api'> {\n const { api, ...rest } = config\n void api\n return rest\n}\n\n/**\n * Shared branching used by both public factories. Constructs the adapter\n * classes directly so their constructors run the full auth cascade lazily\n * (config.apiKey → BEDROCK_API_KEY → AWS_BEARER_TOKEN_BEDROCK → SigV4). No\n * eager env-key fetch here, so `auth: 'sigv4'` never throws for a missing key.\n *\n * Default path → Converse adapter; opt-in via `api: 'chat'` or `api: 'responses'`.\n */\nfunction build(\n model: BedrockFactoryModel,\n config?: BedrockClientConfig & { api?: 'converse' | 'chat' | 'responses' },\n): AnyBedrockAdapter {\n if (config?.api === 'responses') {\n const rest = stripApi(config)\n if (!isResponsesModel(model)) {\n throw new Error(\n `Model \"${model}\" is not available on the Bedrock Responses API. ` +\n `Responses-capable models: ${BEDROCK_RESPONSES_MODELS.join(', ')}.`,\n )\n }\n return new BedrockResponsesTextAdapter(rest, model)\n }\n if (config?.api === 'chat') {\n if (!isChatModel(model)) {\n throw new Error(\n `Model \"${model}\" is not available on the Bedrock Chat Completions API. ` +\n `Chat-capable models: ${BEDROCK_CHAT_MODELS.join(', ')}.`,\n )\n }\n return new BedrockTextAdapter(stripApi(config), model)\n }\n if (!isConverseModel(model)) {\n throw new Error(\n `Model \"${model}\" is not available on the Bedrock Converse API. ` +\n `Converse-capable models: ${BEDROCK_CONVERSE_MODELS.join(', ')}.`,\n )\n }\n return new BedrockConverseTextAdapter(config ? stripApi(config) : {}, model)\n}\n\n// --- createBedrockText: explicit key, overloaded on `api` ---\nexport function createBedrockText<TModel extends BedrockConverseModels>(\n model: TModel,\n apiKey: string,\n config?: BedrockConverseApiConfig,\n): BedrockConverseTextAdapter<TModel>\nexport function createBedrockText<TModel extends BedrockChatModels>(\n model: TModel,\n apiKey: string,\n config: BedrockChatApiConfig,\n): BedrockTextAdapter<TModel>\nexport function createBedrockText<TModel extends BedrockResponsesModels>(\n model: TModel,\n apiKey: string,\n config: BedrockResponsesApiConfig,\n): BedrockResponsesTextAdapter<TModel>\nexport function createBedrockText(\n model: BedrockFactoryModel,\n apiKey: string,\n config?:\n | BedrockConverseApiConfig\n | BedrockChatApiConfig\n | BedrockResponsesApiConfig,\n): AnyBedrockAdapter {\n // Explicit apiKey is authoritative — spread config first so it can't override.\n return build(model, { ...config, apiKey })\n}\n\n// --- bedrockText: env-key counterpart, same overloads ---\nexport function bedrockText<TModel extends BedrockConverseModels>(\n model: TModel,\n config?: BedrockConverseApiConfig,\n): BedrockConverseTextAdapter<TModel>\nexport function bedrockText<TModel extends BedrockChatModels>(\n model: TModel,\n config: BedrockChatApiConfig,\n): BedrockTextAdapter<TModel>\nexport function bedrockText<TModel extends BedrockResponsesModels>(\n model: TModel,\n config: BedrockResponsesApiConfig,\n): BedrockResponsesTextAdapter<TModel>\nexport function bedrockText(\n model: BedrockFactoryModel,\n config?:\n | BedrockConverseApiConfig\n | BedrockChatApiConfig\n | BedrockResponsesApiConfig,\n): AnyBedrockAdapter {\n // No eager env-key fetch: the adapter constructor resolves auth lazily so\n // SigV4 (and the env-key fallback) work without a forced API key here.\n return build(model, config)\n}\n\n// --- Re-exports ---\nexport {\n BedrockTextAdapter,\n createBedrockChat,\n type BedrockTextConfig,\n type BedrockTextProviderOptions,\n} from './adapters/text'\nexport {\n BedrockResponsesTextAdapter,\n createBedrockResponsesText,\n type BedrockResponsesConfig,\n type BedrockResponsesProviderOptions,\n} from './adapters/responses-text'\nexport {\n BedrockConverseTextAdapter,\n createBedrockConverse,\n type BedrockConverseConfig,\n} from './adapters/converse-text'\nexport {\n BedrockEmbeddingAdapter,\n bedrockEmbedding,\n createBedrockEmbedding,\n type BedrockEmbeddingConfig,\n} from './adapters/embedding'\nexport type {\n BedrockCohereEmbeddingInputType,\n BedrockCohereEmbeddingProviderOptions,\n BedrockEmbeddingProviderOptions,\n BedrockTitanImageEmbeddingProviderOptions,\n BedrockTitanTextEmbeddingProviderOptions,\n} from './embedding/embedding-provider-options'\nexport type { BedrockConverseProviderOptions } from './converse/provider-options'\nexport {\n resolveBedrockAuth,\n withBedrockDefaults,\n type BedrockClientConfig,\n type BedrockEndpoint,\n type ResolvedBedrockAuth,\n} from './utils/client'\nexport {\n BEDROCK_CHAT_MODELS,\n BEDROCK_RESPONSES_MODELS,\n BEDROCK_CONVERSE_MODELS,\n BEDROCK_EMBEDDING_MODELS,\n type BedrockEmbeddingModel,\n type BedrockEmbeddingModelProviderOptionsByName,\n type BedrockEmbeddingModelInputModalitiesByName,\n type BedrockChatModels,\n type BedrockResponsesModels,\n type BedrockConverseModels,\n type BedrockChatModelProviderOptionsByName,\n type BedrockChatModelToolCapabilitiesByName,\n type BedrockModelInputModalitiesByName,\n} from './model-meta'\nexport type {\n BedrockCachePoint,\n BedrockSystemPromptMetadata,\n BedrockToolMetadata,\n BedrockMessageMetadataByModality,\n BedrockTextMetadata,\n BedrockImageMetadata,\n BedrockAudioMetadata,\n BedrockVideoMetadata,\n BedrockDocumentMetadata,\n} from './message-types'\n"],"mappings":";;;;;;;;;;;;;;;;;AAoDA,SAAS,iBAAiB,OAAgD;CACxE,OAAO,yBAAyB,MAAM,MAAM,MAAM,KAAK;AACzD;;AAGA,SAAS,YAAY,OAA2C;CAC9D,OAAO,oBAAoB,MAAM,MAAM,MAAM,KAAK;AACpD;;AAGA,SAAS,gBAAgB,OAA+C;CACtE,OAAO,wBAAwB,MAAM,MAAM,MAAM,KAAK;AACxD;;AAGA,SAAS,SAAsC,QAA2B;CACxE,MAAM,EAAE,KAAK,GAAG,SAAS;CAEzB,OAAO;AACT;;;;;;;;;AAUA,SAAS,MACP,OACA,QACmB;CACnB,IAAI,QAAQ,QAAQ,aAAa;EAC/B,MAAM,OAAO,SAAS,MAAM;EAC5B,IAAI,CAAC,iBAAiB,KAAK,GACzB,MAAM,IAAI,MACR,UAAU,MAAM,6EACe,yBAAyB,KAAK,IAAI,EAAE,EACrE;EAEF,OAAO,IAAI,4BAA4B,MAAM,KAAK;CACpD;CACA,IAAI,QAAQ,QAAQ,QAAQ;EAC1B,IAAI,CAAC,YAAY,KAAK,GACpB,MAAM,IAAI,MACR,UAAU,MAAM,+EACU,oBAAoB,KAAK,IAAI,EAAE,EAC3D;EAEF,OAAO,IAAI,mBAAmB,SAAS,MAAM,GAAG,KAAK;CACvD;CACA,IAAI,CAAC,gBAAgB,KAAK,GACxB,MAAM,IAAI,MACR,UAAU,MAAM,2EACc,wBAAwB,KAAK,IAAI,EAAE,EACnE;CAEF,OAAO,IAAI,2BAA2B,SAAS,SAAS,MAAM,IAAI,CAAC,GAAG,KAAK;AAC7E;AAkBA,SAAgB,kBACd,OACA,QACA,QAImB;CAEnB,OAAO,MAAM,OAAO;EAAE,GAAG;EAAQ;CAAO,CAAC;AAC3C;AAeA,SAAgB,YACd,OACA,QAImB;CAGnB,OAAO,MAAM,OAAO,MAAM;AAC5B"}
1
+ {"version":3,"file":"index.js","names":[],"sources":["../../src/index.ts"],"sourcesContent":["/**\n * @module @tanstack/ai-bedrock\n *\n * Bedrock chat uses Converse by default, or the OpenAI-compatible APIs with\n * `api: 'chat'` or `api: 'responses'`. Embeddings and reranking use\n * `bedrockEmbedding` and `bedrockRerank`.\n */\n\nimport { BedrockTextAdapter } from './adapters/text'\nimport { BedrockResponsesTextAdapter } from './adapters/responses-text'\nimport { BedrockConverseTextAdapter } from './adapters/converse-text'\nimport {\n BEDROCK_CHAT_MODELS,\n BEDROCK_CONVERSE_MODELS,\n BEDROCK_RESPONSES_MODELS,\n} from './model-meta'\nimport type { BedrockTextConfig } from './adapters/text'\nimport type { BedrockResponsesConfig } from './adapters/responses-text'\nimport type { BedrockConverseConfig } from './adapters/converse-text'\nimport type { BedrockClientConfig } from './utils/client'\nimport type {\n BedrockChatModels,\n BedrockConverseModels,\n BedrockResponsesModels,\n} from './model-meta'\n\n/** Config for the branching factory's converse mode (default, or api: 'converse'). */\nexport type BedrockConverseApiConfig = BedrockConverseConfig & {\n api?: 'converse'\n}\n/** Config for the branching factory's chat mode (api: 'chat' required). */\nexport type BedrockChatApiConfig = BedrockTextConfig & {\n api: 'chat'\n}\n/** Config for the branching factory's responses mode (api: 'responses' required). */\nexport type BedrockResponsesApiConfig = BedrockResponsesConfig & {\n api: 'responses'\n}\n\ntype AnyBedrockAdapter =\n | BedrockConverseTextAdapter<BedrockConverseModels>\n | BedrockTextAdapter<BedrockChatModels>\n | BedrockResponsesTextAdapter<BedrockResponsesModels>\n\n/** Any catalog id the branching factory can receive. */\ntype BedrockFactoryModel =\n | BedrockConverseModels\n | BedrockChatModels\n | BedrockResponsesModels\n\n/** Cast-free runtime guard: is this model in the Responses-capable subset? */\nfunction isResponsesModel(model: string): model is BedrockResponsesModels {\n return BEDROCK_RESPONSES_MODELS.some((m) => m === model)\n}\n\n/** Cast-free runtime guard: is this model in the Chat-capable subset? */\nfunction isChatModel(model: string): model is BedrockChatModels {\n return BEDROCK_CHAT_MODELS.some((m) => m === model)\n}\n\n/** Cast-free runtime guard: is this model in the Converse-capable subset? */\nfunction isConverseModel(model: string): model is BedrockConverseModels {\n return BEDROCK_CONVERSE_MODELS.some((m) => m === model)\n}\n\n/** Strip the `api` discriminator from a config without an unused-var lint error. */\nfunction stripApi<T extends { api?: unknown }>(config: T): Omit<T, 'api'> {\n const { api, ...rest } = config\n void api\n return rest\n}\n\n/**\n * Shared branching used by both public factories. Constructs the adapter\n * classes directly so their constructors run the full auth cascade lazily\n * (config.apiKey → BEDROCK_API_KEY → AWS_BEARER_TOKEN_BEDROCK → SigV4). No\n * eager env-key fetch here, so `auth: 'sigv4'` never throws for a missing key.\n *\n * Default path → Converse adapter; opt-in via `api: 'chat'` or `api: 'responses'`.\n */\nfunction build(\n model: BedrockFactoryModel,\n config?: BedrockClientConfig & { api?: 'converse' | 'chat' | 'responses' },\n): AnyBedrockAdapter {\n if (config?.api === 'responses') {\n const rest = stripApi(config)\n if (!isResponsesModel(model)) {\n throw new Error(\n `Model \"${model}\" is not available on the Bedrock Responses API. ` +\n `Responses-capable models: ${BEDROCK_RESPONSES_MODELS.join(', ')}.`,\n )\n }\n return new BedrockResponsesTextAdapter(rest, model)\n }\n if (config?.api === 'chat') {\n if (!isChatModel(model)) {\n throw new Error(\n `Model \"${model}\" is not available on the Bedrock Chat Completions API. ` +\n `Chat-capable models: ${BEDROCK_CHAT_MODELS.join(', ')}.`,\n )\n }\n return new BedrockTextAdapter(stripApi(config), model)\n }\n if (!isConverseModel(model)) {\n throw new Error(\n `Model \"${model}\" is not available on the Bedrock Converse API. ` +\n `Converse-capable models: ${BEDROCK_CONVERSE_MODELS.join(', ')}.`,\n )\n }\n return new BedrockConverseTextAdapter(config ? stripApi(config) : {}, model)\n}\n\n// --- createBedrockText: explicit key, overloaded on `api` ---\nexport function createBedrockText<TModel extends BedrockConverseModels>(\n model: TModel,\n apiKey: string,\n config?: BedrockConverseApiConfig,\n): BedrockConverseTextAdapter<TModel>\nexport function createBedrockText<TModel extends BedrockChatModels>(\n model: TModel,\n apiKey: string,\n config: BedrockChatApiConfig,\n): BedrockTextAdapter<TModel>\nexport function createBedrockText<TModel extends BedrockResponsesModels>(\n model: TModel,\n apiKey: string,\n config: BedrockResponsesApiConfig,\n): BedrockResponsesTextAdapter<TModel>\nexport function createBedrockText(\n model: BedrockFactoryModel,\n apiKey: string,\n config?:\n | BedrockConverseApiConfig\n | BedrockChatApiConfig\n | BedrockResponsesApiConfig,\n): AnyBedrockAdapter {\n // Explicit apiKey is authoritative — spread config first so it can't override.\n return build(model, { ...config, apiKey })\n}\n\n// --- bedrockText: env-key counterpart, same overloads ---\nexport function bedrockText<TModel extends BedrockConverseModels>(\n model: TModel,\n config?: BedrockConverseApiConfig,\n): BedrockConverseTextAdapter<TModel>\nexport function bedrockText<TModel extends BedrockChatModels>(\n model: TModel,\n config: BedrockChatApiConfig,\n): BedrockTextAdapter<TModel>\nexport function bedrockText<TModel extends BedrockResponsesModels>(\n model: TModel,\n config: BedrockResponsesApiConfig,\n): BedrockResponsesTextAdapter<TModel>\nexport function bedrockText(\n model: BedrockFactoryModel,\n config?:\n | BedrockConverseApiConfig\n | BedrockChatApiConfig\n | BedrockResponsesApiConfig,\n): AnyBedrockAdapter {\n // No eager env-key fetch: the adapter constructor resolves auth lazily so\n // SigV4 (and the env-key fallback) work without a forced API key here.\n return build(model, config)\n}\n\n// --- Re-exports ---\nexport {\n BedrockTextAdapter,\n createBedrockChat,\n type BedrockTextConfig,\n type BedrockTextProviderOptions,\n} from './adapters/text'\nexport {\n BedrockResponsesTextAdapter,\n createBedrockResponsesText,\n type BedrockResponsesConfig,\n type BedrockResponsesProviderOptions,\n} from './adapters/responses-text'\nexport {\n BedrockConverseTextAdapter,\n createBedrockConverse,\n type BedrockConverseConfig,\n} from './adapters/converse-text'\nexport {\n BedrockEmbeddingAdapter,\n bedrockEmbedding,\n createBedrockEmbedding,\n type BedrockEmbeddingConfig,\n} from './adapters/embedding'\nexport {\n BedrockRerankAdapter,\n bedrockRerank,\n type BedrockRerankConfig,\n type BedrockRerankProviderOptions,\n} from './adapters/rerank'\nexport type {\n BedrockCohereEmbeddingInputType,\n BedrockCohereEmbeddingProviderOptions,\n BedrockEmbeddingProviderOptions,\n BedrockTitanImageEmbeddingProviderOptions,\n BedrockTitanTextEmbeddingProviderOptions,\n} from './embedding/embedding-provider-options'\nexport type { BedrockConverseProviderOptions } from './converse/provider-options'\nexport {\n resolveBedrockAuth,\n withBedrockDefaults,\n type BedrockClientConfig,\n type BedrockEndpoint,\n type ResolvedBedrockAuth,\n} from './utils/client'\nexport {\n BEDROCK_CHAT_MODELS,\n BEDROCK_RESPONSES_MODELS,\n BEDROCK_CONVERSE_MODELS,\n BEDROCK_EMBEDDING_MODELS,\n BEDROCK_RERANK_MODELS,\n type BedrockRerankModel,\n type BedrockEmbeddingModel,\n type BedrockEmbeddingModelProviderOptionsByName,\n type BedrockEmbeddingModelInputModalitiesByName,\n type BedrockChatModels,\n type BedrockResponsesModels,\n type BedrockConverseModels,\n type BedrockChatModelProviderOptionsByName,\n type BedrockChatModelToolCapabilitiesByName,\n type BedrockModelInputModalitiesByName,\n} from './model-meta'\nexport type {\n BedrockCachePoint,\n BedrockSystemPromptMetadata,\n BedrockToolMetadata,\n BedrockMessageMetadataByModality,\n BedrockTextMetadata,\n BedrockImageMetadata,\n BedrockAudioMetadata,\n BedrockVideoMetadata,\n BedrockDocumentMetadata,\n} from './message-types'\n"],"mappings":";;;;;;;;;;;;;;;;;AAmDA,SAAS,iBAAiB,OAAgD;CACxE,OAAO,yBAAyB,MAAM,MAAM,MAAM,KAAK;AACzD;;AAGA,SAAS,YAAY,OAA2C;CAC9D,OAAO,oBAAoB,MAAM,MAAM,MAAM,KAAK;AACpD;;AAGA,SAAS,gBAAgB,OAA+C;CACtE,OAAO,wBAAwB,MAAM,MAAM,MAAM,KAAK;AACxD;;AAGA,SAAS,SAAsC,QAA2B;CACxE,MAAM,EAAE,KAAK,GAAG,SAAS;CAEzB,OAAO;AACT;;;;;;;;;AAUA,SAAS,MACP,OACA,QACmB;CACnB,IAAI,QAAQ,QAAQ,aAAa;EAC/B,MAAM,OAAO,SAAS,MAAM;EAC5B,IAAI,CAAC,iBAAiB,KAAK,GACzB,MAAM,IAAI,MACR,UAAU,MAAM,6EACe,yBAAyB,KAAK,IAAI,EAAE,EACrE;EAEF,OAAO,IAAI,4BAA4B,MAAM,KAAK;CACpD;CACA,IAAI,QAAQ,QAAQ,QAAQ;EAC1B,IAAI,CAAC,YAAY,KAAK,GACpB,MAAM,IAAI,MACR,UAAU,MAAM,+EACU,oBAAoB,KAAK,IAAI,EAAE,EAC3D;EAEF,OAAO,IAAI,mBAAmB,SAAS,MAAM,GAAG,KAAK;CACvD;CACA,IAAI,CAAC,gBAAgB,KAAK,GACxB,MAAM,IAAI,MACR,UAAU,MAAM,2EACc,wBAAwB,KAAK,IAAI,EAAE,EACnE;CAEF,OAAO,IAAI,2BAA2B,SAAS,SAAS,MAAM,IAAI,CAAC,GAAG,KAAK;AAC7E;AAkBA,SAAgB,kBACd,OACA,QACA,QAImB;CAEnB,OAAO,MAAM,OAAO;EAAE,GAAG;EAAQ;CAAO,CAAC;AAC3C;AAeA,SAAgB,YACd,OACA,QAImB;CAGnB,OAAO,MAAM,OAAO,MAAM;AAC5B"}
@@ -116,6 +116,10 @@ export declare const BEDROCK_MODEL_REASONING: Readonly<Record<string, ModelReaso
116
116
  * entry for these models yet. Move it to the catalog when it has them.
117
117
  */
118
118
  export declare const BEDROCK_CLAUDE_NO_FORCED_TOOL_FAMILIES: ReadonlyArray<string>;
119
+ /** Models supported by the Bedrock Rerank API, separate from the chat catalog. */
120
+ export declare const BEDROCK_RERANK_MODELS: readonly ["amazon.rerank-v1:0", "cohere.rerank-v3-5:0"];
121
+ /** Short model IDs accepted by the Bedrock rerank adapter. */
122
+ export type BedrockRerankModel = (typeof BEDROCK_RERANK_MODELS)[number];
119
123
  /**
120
124
  * Embedding models reachable through Bedrock's `InvokeModel` API. These are
121
125
  * not part of the generated Converse catalog (embedding models have no
@@ -57,6 +57,8 @@ var BEDROCK_CLAUDE_NO_FORCED_TOOL_FAMILIES = [
57
57
  "claude-opus-5-5",
58
58
  "claude-sonnet-5-5"
59
59
  ];
60
+ /** Models supported by the Bedrock Rerank API, separate from the chat catalog. */
61
+ var BEDROCK_RERANK_MODELS = ["amazon.rerank-v1:0", "cohere.rerank-v3-5:0"];
60
62
  /**
61
63
  * Embedding models reachable through Bedrock's `InvokeModel` API. These are
62
64
  * not part of the generated Converse catalog (embedding models have no
@@ -69,6 +71,6 @@ var BEDROCK_EMBEDDING_MODELS = [
69
71
  "cohere.embed-multilingual-v3"
70
72
  ];
71
73
  //#endregion
72
- export { BEDROCK_CHAT_MODELS, BEDROCK_CLAUDE_NO_FORCED_TOOL_FAMILIES, BEDROCK_CONVERSE_MODELS, BEDROCK_EMBEDDING_MODELS, BEDROCK_MODEL_INPUT_MODALITIES, BEDROCK_MODEL_REASONING, BEDROCK_RESPONSES_MODELS };
74
+ export { BEDROCK_CHAT_MODELS, BEDROCK_CLAUDE_NO_FORCED_TOOL_FAMILIES, BEDROCK_CONVERSE_MODELS, BEDROCK_EMBEDDING_MODELS, BEDROCK_MODEL_INPUT_MODALITIES, BEDROCK_MODEL_REASONING, BEDROCK_RERANK_MODELS, BEDROCK_RESPONSES_MODELS };
73
75
 
74
76
  //# sourceMappingURL=model-meta.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"model-meta.js","names":[],"sources":["../../src/model-meta.ts"],"sourcesContent":["import { GENERATED_BEDROCK_MODELS } from './model-catalog.generated.js'\nimport type { Modality, ModelReasoning } from '@tanstack/ai'\nimport type { ModelReasoningCapability } from '@tanstack/ai/adapter-internals'\nimport type { BedrockTextProviderOptions } from './text/text-provider-options'\nimport type { BedrockConverseProviderOptions } from './converse/provider-options'\nimport type {\n BedrockCohereEmbeddingProviderOptions,\n BedrockEmbeddingProviderOptions,\n BedrockTitanImageEmbeddingProviderOptions,\n BedrockTitanTextEmbeddingProviderOptions,\n} from './embedding/embedding-provider-options'\n\n// Reasoning shapes: the levels a model has for `chat({ reasoning })`, and\n// the provider value to send for each. Each model points at one of them.\nconst BUDGET_OFF_HIGH = {\n levels: { off: 'off', high: 'high' },\n budget: true,\n} as const\nconst EFFORT_LOW_TO_HIGH = {\n levels: { low: 'low', medium: 'medium', high: 'high' },\n budget: false,\n} as const\nconst EFFORT_NONE_HIGH = {\n levels: { off: 'none', high: 'high' },\n budget: false,\n} as const\n\ntype Entry = (typeof GENERATED_BEDROCK_MODELS)[number]\n\n/**\n * Type-level per-API filter over the generated catalog. Because the catalog is\n * `as const`, `Extract` preserves literal `id` unions (no widening to `string`).\n */\ntype IdsWhere<TApi extends 'converse' | 'chat' | 'responses'> = Extract<\n Entry,\n { apis: Record<TApi, true> }\n>['id']\n\nexport type BedrockConverseModels = IdsWhere<'converse'>\nexport type BedrockChatModels = IdsWhere<'chat'>\nexport type BedrockResponsesModels = IdsWhere<'responses'>\n\n/** Runtime catalogs. Cast-free narrowing via a type predicate (the ai-bedrock pattern). */\nexport const BEDROCK_CONVERSE_MODELS: ReadonlyArray<BedrockConverseModels> =\n GENERATED_BEDROCK_MODELS.filter(\n (m): m is Extract<Entry, { apis: { converse: true } }> => m.apis.converse,\n ).map((m) => m.id)\n\nexport const BEDROCK_CHAT_MODELS: ReadonlyArray<BedrockChatModels> =\n GENERATED_BEDROCK_MODELS.filter(\n (m): m is Extract<Entry, { apis: { chat: true } }> => m.apis.chat,\n ).map((m) => m.id)\n\nexport const BEDROCK_RESPONSES_MODELS: ReadonlyArray<BedrockResponsesModels> =\n GENERATED_BEDROCK_MODELS.filter(\n (m): m is Extract<Entry, { apis: { responses: true } }> => m.apis.responses,\n ).map((m) => m.id)\n\n/** Per-model input modalities (drives type-safe multimodal content). Covers ALL models. */\nexport type BedrockModelInputModalitiesByName = {\n [E in Entry as E['id']]: E['input']\n}\n\n/**\n * Runtime map from model id to its input modalities, for the text adapters'\n * `inputModalities`. An unknown id gives `undefined`.\n */\nexport const BEDROCK_MODEL_INPUT_MODALITIES: Readonly<\n Record<string, ReadonlyArray<Modality>>\n> = Object.fromEntries(GENERATED_BEDROCK_MODELS.map((m) => [m.id, m.input]))\n\n/** Provider options per model. Same options for every model; keyed over the full catalog. */\nexport type BedrockChatModelProviderOptionsByName = {\n [E in Entry as E['id']]: BedrockTextProviderOptions\n}\n\n/** Converse provider options per model (narrower than the Chat Completions set). */\nexport type BedrockConverseModelProviderOptionsByName = {\n [E in Entry as E['id']]: BedrockConverseProviderOptions\n}\n\n/** No provider-specific tools — empty tuple makes cross-provider ProviderTool a compile error. */\nexport type BedrockChatModelToolCapabilitiesByName = {\n [E in Entry as E['id']]: readonly []\n}\n\nexport type ResolveProviderOptions<TModel extends string> =\n TModel extends keyof BedrockChatModelProviderOptionsByName\n ? BedrockChatModelProviderOptionsByName[TModel]\n : BedrockTextProviderOptions\n\nexport type ResolveConverseProviderOptions<TModel extends string> =\n TModel extends keyof BedrockConverseModelProviderOptionsByName\n ? BedrockConverseModelProviderOptionsByName[TModel]\n : BedrockConverseProviderOptions\n\nexport type ResolveInputModalities<TModel extends string> =\n TModel extends keyof BedrockModelInputModalitiesByName\n ? BedrockModelInputModalitiesByName[TModel]\n : readonly ['text']\n\n// ============================================================================\n// Reasoning\n// ============================================================================\n//\n// Each model's data for `chat({ reasoning })`: the levels it has, with the\n// provider value for each, and whether it takes a thinking token budget. The\n// data comes from models.dev. The generator that writes it comes with the model\n// catalog later. Until then, edit these entries by hand.\n// scripts/fetch-bedrock-models.ts does not touch them.\n\nconst BEDROCK_REASONING = {\n 'openai.gpt-oss-120b-1:0': EFFORT_LOW_TO_HIGH,\n 'openai.gpt-oss-20b-1:0': EFFORT_LOW_TO_HIGH,\n 'us.anthropic.claude-sonnet-4-5-20250929-v1:0': BUDGET_OFF_HIGH,\n 'us.anthropic.claude-haiku-4-5-20251001-v1:0': BUDGET_OFF_HIGH,\n 'google.gemma-4-31b': EFFORT_NONE_HIGH,\n 'google.gemma-4-26b-a4b': EFFORT_NONE_HIGH,\n 'google.gemma-4-e2b': EFFORT_NONE_HIGH,\n} satisfies Partial<Record<Entry['id'], ModelReasoning>>\n\n/**\n * Each model's reasoning levels, and whether it takes a token budget, for\n * `chat({ reasoning })`. A model that is not here does not reason.\n */\nexport type BedrockModelReasoningByName = {\n [K in keyof typeof BEDROCK_REASONING]: ModelReasoningCapability<\n (typeof BEDROCK_REASONING)[K]\n >\n}\n\n/**\n * Runtime map from model id to its reasoning data, for the text adapters. An\n * unknown id gives `undefined`: the adapter sends no reasoning field.\n */\nexport const BEDROCK_MODEL_REASONING: Readonly<Record<string, ModelReasoning>> =\n BEDROCK_REASONING\n\n/**\n * The Claude families that reject a forced tool (`any` or a named `tool`) on\n * every request, with or without thinking. A Bedrock id has the family name\n * inside it, for example `us.anthropic.claude-opus-5-5-...`.\n * ponytail: names, not catalog entries, because the generated catalog has no\n * entry for these models yet. Move it to the catalog when it has them.\n */\nexport const BEDROCK_CLAUDE_NO_FORCED_TOOL_FAMILIES: ReadonlyArray<string> = [\n 'claude-fable-5-1',\n 'claude-mythos-5-1',\n 'claude-opus-5-5',\n 'claude-sonnet-5-5',\n]\n\n// ============================================================================\n// Embedding models\n// ============================================================================\n\n/**\n * Embedding models reachable through Bedrock's `InvokeModel` API. These are\n * not part of the generated Converse catalog (embedding models have no\n * conversational surface), so they're maintained by hand here.\n */\nexport const BEDROCK_EMBEDDING_MODELS = [\n 'amazon.titan-embed-text-v2:0',\n 'amazon.titan-embed-image-v1',\n 'cohere.embed-english-v3',\n 'cohere.embed-multilingual-v3',\n] as const\n\nexport type BedrockEmbeddingModel = (typeof BEDROCK_EMBEDDING_MODELS)[number]\n\n/**\n * Type-only map from embedding model name to its provider options type.\n * The Cohere models make `modelOptions` REQUIRED at the `embed()` call site\n * because `inputType` is a required field.\n */\nexport type BedrockEmbeddingModelProviderOptionsByName = {\n 'amazon.titan-embed-text-v2:0': BedrockTitanTextEmbeddingProviderOptions\n 'amazon.titan-embed-image-v1': BedrockTitanImageEmbeddingProviderOptions\n 'cohere.embed-english-v3': BedrockCohereEmbeddingProviderOptions\n 'cohere.embed-multilingual-v3': BedrockCohereEmbeddingProviderOptions\n}\n\n/**\n * Per-model input modalities for embedding models. Titan Multimodal accepts\n * text and/or images (including fused text+image items embedded into one\n * vector); the rest are text-only, so image inputs fail at compile time.\n */\nexport type BedrockEmbeddingModelInputModalitiesByName = {\n 'amazon.titan-embed-text-v2:0': readonly ['text']\n 'amazon.titan-embed-image-v1': readonly ['text', 'image']\n 'cohere.embed-english-v3': readonly ['text']\n 'cohere.embed-multilingual-v3': readonly ['text']\n}\n\nexport type ResolveEmbeddingProviderOptions<TModel extends string> =\n TModel extends keyof BedrockEmbeddingModelProviderOptionsByName\n ? BedrockEmbeddingModelProviderOptionsByName[TModel]\n : BedrockEmbeddingProviderOptions\n"],"mappings":";;AAcA,IAAM,kBAAkB;CACtB,QAAQ;EAAE,KAAK;EAAO,MAAM;CAAO;CACnC,QAAQ;AACV;AACA,IAAM,qBAAqB;CACzB,QAAQ;EAAE,KAAK;EAAO,QAAQ;EAAU,MAAM;CAAO;CACrD,QAAQ;AACV;AACA,IAAM,mBAAmB;CACvB,QAAQ;EAAE,KAAK;EAAQ,MAAM;CAAO;CACpC,QAAQ;AACV;;AAkBA,IAAa,0BACX,yBAAyB,QACtB,MAAyD,EAAE,KAAK,QACnE,CAAC,CAAC,KAAK,MAAM,EAAE,EAAE;AAEnB,IAAa,sBACX,yBAAyB,QACtB,MAAqD,EAAE,KAAK,IAC/D,CAAC,CAAC,KAAK,MAAM,EAAE,EAAE;AAEnB,IAAa,2BACX,yBAAyB,QACtB,MAA0D,EAAE,KAAK,SACpE,CAAC,CAAC,KAAK,MAAM,EAAE,EAAE;;;;;AAWnB,IAAa,iCAET,OAAO,YAAY,yBAAyB,KAAK,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;;;;;AAkE3E,IAAa,0BACX;CAxBA,2BAA2B;CAC3B,0BAA0B;CAC1B,gDAAgD;CAChD,+CAA+C;CAC/C,sBAAsB;CACtB,0BAA0B;CAC1B,sBAAsB;AAkBtB;;;;;;;;AASF,IAAa,yCAAgE;CAC3E;CACA;CACA;CACA;AACF;;;;;;AAWA,IAAa,2BAA2B;CACtC;CACA;CACA;CACA;AACF"}
1
+ {"version":3,"file":"model-meta.js","names":[],"sources":["../../src/model-meta.ts"],"sourcesContent":["import { GENERATED_BEDROCK_MODELS } from './model-catalog.generated.js'\nimport type { Modality, ModelReasoning } from '@tanstack/ai'\nimport type { ModelReasoningCapability } from '@tanstack/ai/adapter-internals'\nimport type { BedrockTextProviderOptions } from './text/text-provider-options'\nimport type { BedrockConverseProviderOptions } from './converse/provider-options'\nimport type {\n BedrockCohereEmbeddingProviderOptions,\n BedrockEmbeddingProviderOptions,\n BedrockTitanImageEmbeddingProviderOptions,\n BedrockTitanTextEmbeddingProviderOptions,\n} from './embedding/embedding-provider-options'\n\n// Reasoning shapes: the levels a model has for `chat({ reasoning })`, and\n// the provider value to send for each. Each model points at one of them.\nconst BUDGET_OFF_HIGH = {\n levels: { off: 'off', high: 'high' },\n budget: true,\n} as const\nconst EFFORT_LOW_TO_HIGH = {\n levels: { low: 'low', medium: 'medium', high: 'high' },\n budget: false,\n} as const\nconst EFFORT_NONE_HIGH = {\n levels: { off: 'none', high: 'high' },\n budget: false,\n} as const\n\ntype Entry = (typeof GENERATED_BEDROCK_MODELS)[number]\n\n/**\n * Type-level per-API filter over the generated catalog. Because the catalog is\n * `as const`, `Extract` preserves literal `id` unions (no widening to `string`).\n */\ntype IdsWhere<TApi extends 'converse' | 'chat' | 'responses'> = Extract<\n Entry,\n { apis: Record<TApi, true> }\n>['id']\n\nexport type BedrockConverseModels = IdsWhere<'converse'>\nexport type BedrockChatModels = IdsWhere<'chat'>\nexport type BedrockResponsesModels = IdsWhere<'responses'>\n\n/** Runtime catalogs. Cast-free narrowing via a type predicate (the ai-bedrock pattern). */\nexport const BEDROCK_CONVERSE_MODELS: ReadonlyArray<BedrockConverseModels> =\n GENERATED_BEDROCK_MODELS.filter(\n (m): m is Extract<Entry, { apis: { converse: true } }> => m.apis.converse,\n ).map((m) => m.id)\n\nexport const BEDROCK_CHAT_MODELS: ReadonlyArray<BedrockChatModels> =\n GENERATED_BEDROCK_MODELS.filter(\n (m): m is Extract<Entry, { apis: { chat: true } }> => m.apis.chat,\n ).map((m) => m.id)\n\nexport const BEDROCK_RESPONSES_MODELS: ReadonlyArray<BedrockResponsesModels> =\n GENERATED_BEDROCK_MODELS.filter(\n (m): m is Extract<Entry, { apis: { responses: true } }> => m.apis.responses,\n ).map((m) => m.id)\n\n/** Per-model input modalities (drives type-safe multimodal content). Covers ALL models. */\nexport type BedrockModelInputModalitiesByName = {\n [E in Entry as E['id']]: E['input']\n}\n\n/**\n * Runtime map from model id to its input modalities, for the text adapters'\n * `inputModalities`. An unknown id gives `undefined`.\n */\nexport const BEDROCK_MODEL_INPUT_MODALITIES: Readonly<\n Record<string, ReadonlyArray<Modality>>\n> = Object.fromEntries(GENERATED_BEDROCK_MODELS.map((m) => [m.id, m.input]))\n\n/** Provider options per model. Same options for every model; keyed over the full catalog. */\nexport type BedrockChatModelProviderOptionsByName = {\n [E in Entry as E['id']]: BedrockTextProviderOptions\n}\n\n/** Converse provider options per model (narrower than the Chat Completions set). */\nexport type BedrockConverseModelProviderOptionsByName = {\n [E in Entry as E['id']]: BedrockConverseProviderOptions\n}\n\n/** No provider-specific tools — empty tuple makes cross-provider ProviderTool a compile error. */\nexport type BedrockChatModelToolCapabilitiesByName = {\n [E in Entry as E['id']]: readonly []\n}\n\nexport type ResolveProviderOptions<TModel extends string> =\n TModel extends keyof BedrockChatModelProviderOptionsByName\n ? BedrockChatModelProviderOptionsByName[TModel]\n : BedrockTextProviderOptions\n\nexport type ResolveConverseProviderOptions<TModel extends string> =\n TModel extends keyof BedrockConverseModelProviderOptionsByName\n ? BedrockConverseModelProviderOptionsByName[TModel]\n : BedrockConverseProviderOptions\n\nexport type ResolveInputModalities<TModel extends string> =\n TModel extends keyof BedrockModelInputModalitiesByName\n ? BedrockModelInputModalitiesByName[TModel]\n : readonly ['text']\n\n// ============================================================================\n// Reasoning\n// ============================================================================\n//\n// Each model's data for `chat({ reasoning })`: the levels it has, with the\n// provider value for each, and whether it takes a thinking token budget. The\n// data comes from models.dev. The generator that writes it comes with the model\n// catalog later. Until then, edit these entries by hand.\n// scripts/fetch-bedrock-models.ts does not touch them.\n\nconst BEDROCK_REASONING = {\n 'openai.gpt-oss-120b-1:0': EFFORT_LOW_TO_HIGH,\n 'openai.gpt-oss-20b-1:0': EFFORT_LOW_TO_HIGH,\n 'us.anthropic.claude-sonnet-4-5-20250929-v1:0': BUDGET_OFF_HIGH,\n 'us.anthropic.claude-haiku-4-5-20251001-v1:0': BUDGET_OFF_HIGH,\n 'google.gemma-4-31b': EFFORT_NONE_HIGH,\n 'google.gemma-4-26b-a4b': EFFORT_NONE_HIGH,\n 'google.gemma-4-e2b': EFFORT_NONE_HIGH,\n} satisfies Partial<Record<Entry['id'], ModelReasoning>>\n\n/**\n * Each model's reasoning levels, and whether it takes a token budget, for\n * `chat({ reasoning })`. A model that is not here does not reason.\n */\nexport type BedrockModelReasoningByName = {\n [K in keyof typeof BEDROCK_REASONING]: ModelReasoningCapability<\n (typeof BEDROCK_REASONING)[K]\n >\n}\n\n/**\n * Runtime map from model id to its reasoning data, for the text adapters. An\n * unknown id gives `undefined`: the adapter sends no reasoning field.\n */\nexport const BEDROCK_MODEL_REASONING: Readonly<Record<string, ModelReasoning>> =\n BEDROCK_REASONING\n\n/**\n * The Claude families that reject a forced tool (`any` or a named `tool`) on\n * every request, with or without thinking. A Bedrock id has the family name\n * inside it, for example `us.anthropic.claude-opus-5-5-...`.\n * ponytail: names, not catalog entries, because the generated catalog has no\n * entry for these models yet. Move it to the catalog when it has them.\n */\nexport const BEDROCK_CLAUDE_NO_FORCED_TOOL_FAMILIES: ReadonlyArray<string> = [\n 'claude-fable-5-1',\n 'claude-mythos-5-1',\n 'claude-opus-5-5',\n 'claude-sonnet-5-5',\n]\n\n/** Models supported by the Bedrock Rerank API, separate from the chat catalog. */\nexport const BEDROCK_RERANK_MODELS = [\n 'amazon.rerank-v1:0',\n 'cohere.rerank-v3-5:0',\n] as const\n\n/** Short model IDs accepted by the Bedrock rerank adapter. */\nexport type BedrockRerankModel = (typeof BEDROCK_RERANK_MODELS)[number]\n\n// ============================================================================\n// Embedding models\n// ============================================================================\n\n/**\n * Embedding models reachable through Bedrock's `InvokeModel` API. These are\n * not part of the generated Converse catalog (embedding models have no\n * conversational surface), so they're maintained by hand here.\n */\nexport const BEDROCK_EMBEDDING_MODELS = [\n 'amazon.titan-embed-text-v2:0',\n 'amazon.titan-embed-image-v1',\n 'cohere.embed-english-v3',\n 'cohere.embed-multilingual-v3',\n] as const\n\nexport type BedrockEmbeddingModel = (typeof BEDROCK_EMBEDDING_MODELS)[number]\n\n/**\n * Type-only map from embedding model name to its provider options type.\n * The Cohere models make `modelOptions` REQUIRED at the `embed()` call site\n * because `inputType` is a required field.\n */\nexport type BedrockEmbeddingModelProviderOptionsByName = {\n 'amazon.titan-embed-text-v2:0': BedrockTitanTextEmbeddingProviderOptions\n 'amazon.titan-embed-image-v1': BedrockTitanImageEmbeddingProviderOptions\n 'cohere.embed-english-v3': BedrockCohereEmbeddingProviderOptions\n 'cohere.embed-multilingual-v3': BedrockCohereEmbeddingProviderOptions\n}\n\n/**\n * Per-model input modalities for embedding models. Titan Multimodal accepts\n * text and/or images (including fused text+image items embedded into one\n * vector); the rest are text-only, so image inputs fail at compile time.\n */\nexport type BedrockEmbeddingModelInputModalitiesByName = {\n 'amazon.titan-embed-text-v2:0': readonly ['text']\n 'amazon.titan-embed-image-v1': readonly ['text', 'image']\n 'cohere.embed-english-v3': readonly ['text']\n 'cohere.embed-multilingual-v3': readonly ['text']\n}\n\nexport type ResolveEmbeddingProviderOptions<TModel extends string> =\n TModel extends keyof BedrockEmbeddingModelProviderOptionsByName\n ? BedrockEmbeddingModelProviderOptionsByName[TModel]\n : BedrockEmbeddingProviderOptions\n"],"mappings":";;AAcA,IAAM,kBAAkB;CACtB,QAAQ;EAAE,KAAK;EAAO,MAAM;CAAO;CACnC,QAAQ;AACV;AACA,IAAM,qBAAqB;CACzB,QAAQ;EAAE,KAAK;EAAO,QAAQ;EAAU,MAAM;CAAO;CACrD,QAAQ;AACV;AACA,IAAM,mBAAmB;CACvB,QAAQ;EAAE,KAAK;EAAQ,MAAM;CAAO;CACpC,QAAQ;AACV;;AAkBA,IAAa,0BACX,yBAAyB,QACtB,MAAyD,EAAE,KAAK,QACnE,CAAC,CAAC,KAAK,MAAM,EAAE,EAAE;AAEnB,IAAa,sBACX,yBAAyB,QACtB,MAAqD,EAAE,KAAK,IAC/D,CAAC,CAAC,KAAK,MAAM,EAAE,EAAE;AAEnB,IAAa,2BACX,yBAAyB,QACtB,MAA0D,EAAE,KAAK,SACpE,CAAC,CAAC,KAAK,MAAM,EAAE,EAAE;;;;;AAWnB,IAAa,iCAET,OAAO,YAAY,yBAAyB,KAAK,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;;;;;AAkE3E,IAAa,0BACX;CAxBA,2BAA2B;CAC3B,0BAA0B;CAC1B,gDAAgD;CAChD,+CAA+C;CAC/C,sBAAsB;CACtB,0BAA0B;CAC1B,sBAAsB;AAkBtB;;;;;;;;AASF,IAAa,yCAAgE;CAC3E;CACA;CACA;CACA;AACF;;AAGA,IAAa,wBAAwB,CACnC,sBACA,sBACF;;;;;;AAcA,IAAa,2BAA2B;CACtC;CACA;CACA;CACA;AACF"}
@@ -23,4 +23,9 @@ export interface BedrockAuthConfig {
23
23
  auth?: 'apikey' | 'sigv4' | 'auto';
24
24
  }
25
25
  /** apiKey -> BEDROCK_API_KEY -> AWS_BEARER_TOKEN_BEDROCK -> SigV4 (credential chain). */
26
+ export declare function resolveBedrockAuth(config: BedrockAuthConfig & {
27
+ auth: 'sigv4';
28
+ }, endpoint: BedrockEndpoint): Extract<ResolvedBedrockAuth, {
29
+ kind: 'sigv4';
30
+ }>;
26
31
  export declare function resolveBedrockAuth(config: BedrockAuthConfig, endpoint: BedrockEndpoint): ResolvedBedrockAuth;
@@ -23,7 +23,6 @@ function readApiKeyFromEnv() {
23
23
  const env = typeof process !== "undefined" ? process.env : void 0;
24
24
  for (const value of [env?.BEDROCK_API_KEY, env?.AWS_BEARER_TOKEN_BEDROCK]) if (value && value.trim() !== "") return value;
25
25
  }
26
- /** apiKey -> BEDROCK_API_KEY -> AWS_BEARER_TOKEN_BEDROCK -> SigV4 (credential chain). */
27
26
  function resolveBedrockAuth(config, endpoint) {
28
27
  const mode = config.auth ?? "auto";
29
28
  const region = config.region ?? DEFAULT_REGION;
@@ -1 +1 @@
1
- {"version":3,"file":"auth.js","names":[],"sources":["../../../src/utils/auth.ts"],"sourcesContent":["import type { AwsCredentialIdentityProvider } from '@smithy/types'\nimport type * as CredentialProviders from '@aws-sdk/credential-providers'\n\nexport type BedrockEndpoint = 'runtime' | 'mantle'\n\n/** SigV4 service name differs per endpoint. */\nexport function sigv4Service(endpoint: BedrockEndpoint): string {\n return endpoint === 'mantle' ? 'bedrock-mantle' : 'bedrock'\n}\n\nexport type ResolvedBedrockAuth =\n | { kind: 'bearer'; token: string }\n | {\n kind: 'sigv4'\n region: string\n service: string\n credentials: AwsCredentialIdentityProvider\n }\n\n/**\n * Loads an optional peer dependency of this package (the AWS SDK parts). If\n * the import fails, throws an error that names the package to install. The\n * original error is kept as `cause`.\n */\nexport async function importOptionalPeer<T>(mod: string): Promise<T> {\n try {\n return (await import(/* @vite-ignore */ mod)) as T\n } catch (cause) {\n throw new Error(\n `@tanstack/ai-bedrock could not load \"${mod}\". It is an optional peer ` +\n `dependency. Install it: npm install ${mod}`,\n { cause },\n )\n }\n}\n\nconst DEFAULT_REGION = 'us-east-1'\n\nfunction readApiKeyFromEnv(): string | undefined {\n // Bedrock is server-only (the AWS SDK is Node-only), so the key always comes\n // from process.env. Read it directly: a property access never throws, so —\n // unlike the previous try/catch around getApiKeyFromEnv — we no longer swallow\n // unrelated errors as \"key not set\". Each var is blank-checked independently\n // so a present-but-blank BEDROCK_API_KEY falls through to\n // AWS_BEARER_TOKEN_BEDROCK (and only then to SigV4) rather than masking it.\n const env = typeof process !== 'undefined' ? process.env : undefined\n for (const value of [env?.BEDROCK_API_KEY, env?.AWS_BEARER_TOKEN_BEDROCK]) {\n if (value && value.trim() !== '') return value\n }\n return undefined\n}\n\nexport interface BedrockAuthConfig {\n apiKey?: string\n region?: string\n auth?: 'apikey' | 'sigv4' | 'auto'\n}\n\n/** apiKey -> BEDROCK_API_KEY -> AWS_BEARER_TOKEN_BEDROCK -> SigV4 (credential chain). */\nexport function resolveBedrockAuth(\n config: BedrockAuthConfig,\n endpoint: BedrockEndpoint,\n): ResolvedBedrockAuth {\n const mode = config.auth ?? 'auto'\n const region = config.region ?? DEFAULT_REGION\n\n if (mode !== 'sigv4') {\n const token = config.apiKey ?? readApiKeyFromEnv()\n if (token) return { kind: 'bearer', token }\n if (mode === 'apikey') {\n throw new Error(\n 'No Bedrock API key found. Set BEDROCK_API_KEY (or ' +\n 'AWS_BEARER_TOKEN_BEDROCK), pass `apiKey`, or use auth: \"sigv4\".',\n )\n }\n }\n\n return {\n kind: 'sigv4',\n region,\n service: sigv4Service(endpoint),\n // Lazy credential provider: the AWS SDK is Node/server-only, so we defer the\n // dynamic import until SigV4 actually needs to resolve credentials. The\n // specifier is held in a variable (not a string literal) so bundler dep\n // scanners (e.g. Vite/esbuild optimizeDeps) cannot statically discover the\n // AWS SDK and try to pre-bundle it for the browser — it would fail on the\n // SDK's Node-only `fromTokenFile` export chain. `typeof import(...)` is a\n // type-only reference (erased at emit) so we keep full typing.\n credentials: async (...args) => {\n const mod = '@aws-sdk/credential-providers'\n const { fromNodeProviderChain } =\n await importOptionalPeer<typeof CredentialProviders>(mod)\n return fromNodeProviderChain()(...args)\n },\n }\n}\n"],"mappings":";;AAMA,SAAgB,aAAa,UAAmC;CAC9D,OAAO,aAAa,WAAW,mBAAmB;AACpD;;;;;;AAgBA,eAAsB,mBAAsB,KAAyB;CACnE,IAAI;EACF,OAAQ,MAAM;;GAA0B;;CAC1C,SAAS,OAAO;EACd,MAAM,IAAI,MACR,wCAAwC,IAAI,gEACH,OACzC,EAAE,MAAM,CACV;CACF;AACF;AAEA,IAAM,iBAAiB;AAEvB,SAAS,oBAAwC;CAO/C,MAAM,MAAM,OAAO,YAAY,cAAc,QAAQ,MAAM,KAAA;CAC3D,KAAK,MAAM,SAAS,CAAC,KAAK,iBAAiB,KAAK,wBAAwB,GACtE,IAAI,SAAS,MAAM,KAAK,MAAM,IAAI,OAAO;AAG7C;;AASA,SAAgB,mBACd,QACA,UACqB;CACrB,MAAM,OAAO,OAAO,QAAQ;CAC5B,MAAM,SAAS,OAAO,UAAU;CAEhC,IAAI,SAAS,SAAS;EACpB,MAAM,QAAQ,OAAO,UAAU,kBAAkB;EACjD,IAAI,OAAO,OAAO;GAAE,MAAM;GAAU;EAAM;EAC1C,IAAI,SAAS,UACX,MAAM,IAAI,MACR,qHAEF;CAEJ;CAEA,OAAO;EACL,MAAM;EACN;EACA,SAAS,aAAa,QAAQ;EAQ9B,aAAa,OAAO,GAAG,SAAS;GAE9B,MAAM,EAAE,0BACN,MAAM,mBAA+C,+BAAG;GAC1D,OAAO,sBAAsB,CAAC,CAAC,GAAG,IAAI;EACxC;CACF;AACF"}
1
+ {"version":3,"file":"auth.js","names":[],"sources":["../../../src/utils/auth.ts"],"sourcesContent":["import type { AwsCredentialIdentityProvider } from '@smithy/types'\nimport type * as CredentialProviders from '@aws-sdk/credential-providers'\n\nexport type BedrockEndpoint = 'runtime' | 'mantle'\n\n/** SigV4 service name differs per endpoint. */\nexport function sigv4Service(endpoint: BedrockEndpoint): string {\n return endpoint === 'mantle' ? 'bedrock-mantle' : 'bedrock'\n}\n\nexport type ResolvedBedrockAuth =\n | { kind: 'bearer'; token: string }\n | {\n kind: 'sigv4'\n region: string\n service: string\n credentials: AwsCredentialIdentityProvider\n }\n\n/**\n * Loads an optional peer dependency of this package (the AWS SDK parts). If\n * the import fails, throws an error that names the package to install. The\n * original error is kept as `cause`.\n */\nexport async function importOptionalPeer<T>(mod: string): Promise<T> {\n try {\n return (await import(/* @vite-ignore */ mod)) as T\n } catch (cause) {\n throw new Error(\n `@tanstack/ai-bedrock could not load \"${mod}\". It is an optional peer ` +\n `dependency. Install it: npm install ${mod}`,\n { cause },\n )\n }\n}\n\nconst DEFAULT_REGION = 'us-east-1'\n\nfunction readApiKeyFromEnv(): string | undefined {\n // Bedrock is server-only (the AWS SDK is Node-only), so the key always comes\n // from process.env. Read it directly: a property access never throws, so —\n // unlike the previous try/catch around getApiKeyFromEnv — we no longer swallow\n // unrelated errors as \"key not set\". Each var is blank-checked independently\n // so a present-but-blank BEDROCK_API_KEY falls through to\n // AWS_BEARER_TOKEN_BEDROCK (and only then to SigV4) rather than masking it.\n const env = typeof process !== 'undefined' ? process.env : undefined\n for (const value of [env?.BEDROCK_API_KEY, env?.AWS_BEARER_TOKEN_BEDROCK]) {\n if (value && value.trim() !== '') return value\n }\n return undefined\n}\n\nexport interface BedrockAuthConfig {\n apiKey?: string\n region?: string\n auth?: 'apikey' | 'sigv4' | 'auto'\n}\n\n/** apiKey -> BEDROCK_API_KEY -> AWS_BEARER_TOKEN_BEDROCK -> SigV4 (credential chain). */\nexport function resolveBedrockAuth(\n config: BedrockAuthConfig & { auth: 'sigv4' },\n endpoint: BedrockEndpoint,\n): Extract<ResolvedBedrockAuth, { kind: 'sigv4' }>\nexport function resolveBedrockAuth(\n config: BedrockAuthConfig,\n endpoint: BedrockEndpoint,\n): ResolvedBedrockAuth\nexport function resolveBedrockAuth(\n config: BedrockAuthConfig,\n endpoint: BedrockEndpoint,\n): ResolvedBedrockAuth {\n const mode = config.auth ?? 'auto'\n const region = config.region ?? DEFAULT_REGION\n\n if (mode !== 'sigv4') {\n const token = config.apiKey ?? readApiKeyFromEnv()\n if (token) return { kind: 'bearer', token }\n if (mode === 'apikey') {\n throw new Error(\n 'No Bedrock API key found. Set BEDROCK_API_KEY (or ' +\n 'AWS_BEARER_TOKEN_BEDROCK), pass `apiKey`, or use auth: \"sigv4\".',\n )\n }\n }\n\n return {\n kind: 'sigv4',\n region,\n service: sigv4Service(endpoint),\n // Lazy credential provider: the AWS SDK is Node/server-only, so we defer the\n // dynamic import until SigV4 actually needs to resolve credentials. The\n // specifier is held in a variable (not a string literal) so bundler dep\n // scanners (e.g. Vite/esbuild optimizeDeps) cannot statically discover the\n // AWS SDK and try to pre-bundle it for the browser — it would fail on the\n // SDK's Node-only `fromTokenFile` export chain. `typeof import(...)` is a\n // type-only reference (erased at emit) so we keep full typing.\n credentials: async (...args) => {\n const mod = '@aws-sdk/credential-providers'\n const { fromNodeProviderChain } =\n await importOptionalPeer<typeof CredentialProviders>(mod)\n return fromNodeProviderChain()(...args)\n },\n }\n}\n"],"mappings":";;AAMA,SAAgB,aAAa,UAAmC;CAC9D,OAAO,aAAa,WAAW,mBAAmB;AACpD;;;;;;AAgBA,eAAsB,mBAAsB,KAAyB;CACnE,IAAI;EACF,OAAQ,MAAM;;GAA0B;;CAC1C,SAAS,OAAO;EACd,MAAM,IAAI,MACR,wCAAwC,IAAI,gEACH,OACzC,EAAE,MAAM,CACV;CACF;AACF;AAEA,IAAM,iBAAiB;AAEvB,SAAS,oBAAwC;CAO/C,MAAM,MAAM,OAAO,YAAY,cAAc,QAAQ,MAAM,KAAA;CAC3D,KAAK,MAAM,SAAS,CAAC,KAAK,iBAAiB,KAAK,wBAAwB,GACtE,IAAI,SAAS,MAAM,KAAK,MAAM,IAAI,OAAO;AAG7C;AAiBA,SAAgB,mBACd,QACA,UACqB;CACrB,MAAM,OAAO,OAAO,QAAQ;CAC5B,MAAM,SAAS,OAAO,UAAU;CAEhC,IAAI,SAAS,SAAS;EACpB,MAAM,QAAQ,OAAO,UAAU,kBAAkB;EACjD,IAAI,OAAO,OAAO;GAAE,MAAM;GAAU;EAAM;EAC1C,IAAI,SAAS,UACX,MAAM,IAAI,MACR,qHAEF;CAEJ;CAEA,OAAO;EACL,MAAM;EACN;EACA,SAAS,aAAa,QAAQ;EAQ9B,aAAa,OAAO,GAAG,SAAS;GAE9B,MAAM,EAAE,0BACN,MAAM,mBAA+C,+BAAG;GAC1D,OAAO,sBAAsB,CAAC,CAAC,GAAG,IAAI;EACxC;CACF;AACF"}
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "@tanstack/ai-bedrock",
3
- "version": "1.2.1",
3
+ "version": "1.3.0",
4
4
  "type": "module",
5
- "description": "Amazon Bedrock adapter for TanStack AI — OpenAI-compatible chat, responses, tools, and reasoning.",
5
+ "description": "Amazon Bedrock adapter for TanStack AI with chat, tools, reasoning, embeddings, and reranking.",
6
6
  "author": "",
7
7
  "license": "MIT",
8
8
  "repository": {
@@ -52,7 +52,7 @@
52
52
  "@aws-sdk/client-bedrock-runtime": "^3.1057.0",
53
53
  "@aws-sdk/credential-providers": "^3.1057.0",
54
54
  "@smithy/types": "^4.14.2",
55
- "@tanstack/ai": "^1.3.0"
55
+ "@tanstack/ai": "^1.4.0"
56
56
  },
57
57
  "peerDependenciesMeta": {
58
58
  "@aws-sdk/client-bedrock-runtime": {
@@ -67,7 +67,7 @@
67
67
  },
68
68
  "dependencies": {
69
69
  "openai": "^7.30.0",
70
- "@tanstack/openai-base": "^1.0.3"
70
+ "@tanstack/openai-base": "^1.0.4"
71
71
  },
72
72
  "scripts": {
73
73
  "build": "vite build",
@@ -0,0 +1,188 @@
1
+ import { BaseRerankAdapter } from '@tanstack/ai/adapters'
2
+ import { toRunErrorPayload } from '@tanstack/ai/adapter-internals'
3
+ import { resolveBedrockAuth } from '../utils/auth'
4
+ import { createSigV4Fetch } from '../utils/openai-sigv4-fetch'
5
+ import type { RerankAdapterResult, RerankOptions } from '@tanstack/ai'
6
+ import type { BedrockRerankModel } from '../model-meta'
7
+
8
+ /** Bedrock rerank uses AWS credentials, not Bedrock API keys. */
9
+ export interface BedrockRerankConfig {
10
+ /** AWS region; defaults to us-east-1. Amazon Rerank requires another region. */
11
+ region?: string
12
+ /** Overrides the agent-runtime base URL, without the /rerank suffix. */
13
+ baseURL?: string
14
+ /** Headers added before SigV4 signing. */
15
+ defaultHeaders?: Record<string, string>
16
+ /** Custom transport; requests are still SigV4-signed. */
17
+ fetch?: typeof fetch
18
+ }
19
+
20
+ /** Additional inference fields for the selected Bedrock rerank model. */
21
+ export interface BedrockRerankProviderOptions {
22
+ additionalModelRequestFields?: Record<string, unknown>
23
+ }
24
+
25
+ interface BedrockRerankResponse {
26
+ results: Array<{ index: number; relevanceScore: number }>
27
+ nextToken?: string
28
+ }
29
+
30
+ function isBedrockRerankResponse(
31
+ value: unknown,
32
+ ): value is BedrockRerankResponse {
33
+ return (
34
+ typeof value === 'object' &&
35
+ value !== null &&
36
+ 'results' in value &&
37
+ Array.isArray(value.results) &&
38
+ value.results.every(
39
+ (result) =>
40
+ typeof result === 'object' &&
41
+ result !== null &&
42
+ Number.isInteger(result.index) &&
43
+ Number.isFinite(result.relevanceScore),
44
+ ) &&
45
+ (!('nextToken' in value) ||
46
+ (typeof value.nextToken === 'string' &&
47
+ value.nextToken.length > 0 &&
48
+ value.nextToken.length <= 2048 &&
49
+ !/\s/.test(value.nextToken)))
50
+ )
51
+ }
52
+
53
+ /** Bedrock rerank adapter; core maps scored indices to original documents. */
54
+ export class BedrockRerankAdapter<
55
+ TModel extends BedrockRerankModel,
56
+ > extends BaseRerankAdapter<TModel, BedrockRerankProviderOptions> {
57
+ readonly name = 'bedrock' as const
58
+ private readonly region: string
59
+ private readonly baseURL: string
60
+ private readonly clientConfig: BedrockRerankConfig
61
+
62
+ constructor(config: BedrockRerankConfig, model: TModel) {
63
+ super({}, model)
64
+ this.clientConfig = config
65
+ this.region = config.region ?? 'us-east-1'
66
+ this.baseURL = (
67
+ config.baseURL ??
68
+ `https://bedrock-agent-runtime.${this.region}.amazonaws.com`
69
+ ).replace(/\/+$/, '')
70
+ }
71
+
72
+ async rerank(
73
+ options: RerankOptions<BedrockRerankProviderOptions>,
74
+ ): Promise<RerankAdapterResult> {
75
+ const { model, query, documents, topN, modelOptions, abortSignal, logger } =
76
+ options
77
+
78
+ try {
79
+ if (documents.length < 1 || documents.length > 1000) {
80
+ throw new Error('Bedrock rerank requires between 1 and 1000 documents')
81
+ }
82
+ const numberOfResults = topN ?? documents.length
83
+ if (
84
+ !Number.isInteger(numberOfResults) ||
85
+ numberOfResults < 1 ||
86
+ numberOfResults > 1000
87
+ ) {
88
+ throw new Error(
89
+ 'Bedrock rerank topN must be an integer between 1 and 1000',
90
+ )
91
+ }
92
+
93
+ const body = {
94
+ queries: [{ type: 'TEXT', textQuery: { text: query } }],
95
+ sources: documents.map((text) => ({
96
+ type: 'INLINE',
97
+ inlineDocumentSource: { type: 'TEXT', textDocument: { text } },
98
+ })),
99
+ rerankingConfiguration: {
100
+ type: 'BEDROCK_RERANKING_MODEL',
101
+ bedrockRerankingConfiguration: {
102
+ modelConfiguration: {
103
+ modelArn: `arn:aws:bedrock:${this.region}::foundation-model/${model}`,
104
+ additionalModelRequestFields:
105
+ modelOptions?.additionalModelRequestFields,
106
+ },
107
+ numberOfResults,
108
+ },
109
+ },
110
+ }
111
+ const signedFetch = createSigV4Fetch(
112
+ resolveBedrockAuth({ region: this.region, auth: 'sigv4' }, 'runtime'),
113
+ this.clientConfig.fetch,
114
+ )
115
+ const ranking: RerankAdapterResult['ranking'] = []
116
+ const seenTokens = new Set<string>()
117
+ let nextToken: string | undefined
118
+ let id: string | undefined
119
+
120
+ do {
121
+ abortSignal?.throwIfAborted()
122
+ logger.request(
123
+ `activity=rerank provider=${this.name} model=${model} documents=${documents.length}`,
124
+ { provider: this.name, model },
125
+ )
126
+ const response = await signedFetch(`${this.baseURL}/rerank`, {
127
+ method: 'POST',
128
+ headers: {
129
+ 'Content-Type': 'application/json',
130
+ ...this.clientConfig.defaultHeaders,
131
+ },
132
+ body: JSON.stringify({ ...body, nextToken }),
133
+ signal: abortSignal,
134
+ })
135
+ if (!response.ok) {
136
+ const detail = await response.text()
137
+ throw new Error(
138
+ `Bedrock rerank request failed: ${response.status} ${response.statusText}${detail ? `: ${detail}` : ''}`,
139
+ )
140
+ }
141
+ const page: unknown = await response.json()
142
+ abortSignal?.throwIfAborted()
143
+ if (!isBedrockRerankResponse(page)) {
144
+ throw new Error('Bedrock rerank response had an unexpected shape')
145
+ }
146
+ id ??= response.headers.get('x-amzn-requestid') ?? undefined
147
+ ranking.push(
148
+ ...page.results.map((result) => ({
149
+ index: result.index,
150
+ score: result.relevanceScore,
151
+ })),
152
+ )
153
+ nextToken = page.nextToken
154
+ if (nextToken) {
155
+ if (seenTokens.has(nextToken)) {
156
+ throw new Error('Bedrock rerank pagination did not advance')
157
+ }
158
+ seenTokens.add(nextToken)
159
+ }
160
+ } while (nextToken && ranking.length < numberOfResults)
161
+
162
+ return {
163
+ id: id ?? this.generateId(),
164
+ ranking: ranking.slice(0, numberOfResults),
165
+ // The Bedrock Rerank API reports neither token counts nor billed units.
166
+ usage: { promptTokens: 0, completionTokens: 0, totalTokens: 0 },
167
+ }
168
+ } catch (error) {
169
+ logger.errors(`${this.name}.rerank fatal`, {
170
+ error: toRunErrorPayload(error, 'Bedrock rerank failed'),
171
+ source: `${this.name}.rerank`,
172
+ })
173
+ throw error
174
+ }
175
+ }
176
+ }
177
+
178
+ /**
179
+ * Creates a Bedrock rerank adapter using the AWS credential chain (SigV4).
180
+ * Install `@aws-sdk/credential-providers`; Bedrock API keys are not supported.
181
+ * For `amazon.rerank-v1:0`, select a supported region such as `us-west-2`.
182
+ */
183
+ export function bedrockRerank<TModel extends BedrockRerankModel>(
184
+ model: TModel,
185
+ config?: BedrockRerankConfig,
186
+ ): BedrockRerankAdapter<TModel> {
187
+ return new BedrockRerankAdapter(config ?? {}, model)
188
+ }
package/src/index.ts CHANGED
@@ -1,10 +1,9 @@
1
1
  /**
2
2
  * @module @tanstack/ai-bedrock
3
3
  *
4
- * Amazon Bedrock adapter for TanStack AI via Bedrock's OpenAI-compatible APIs
5
- * and the native Converse API. The public `bedrockText` / `createBedrockText`
6
- * factory branches between the Converse adapter (DEFAULT), the Chat Completions
7
- * adapter (`api: 'chat'`), and the Responses adapter (`api: 'responses'`).
4
+ * Bedrock chat uses Converse by default, or the OpenAI-compatible APIs with
5
+ * `api: 'chat'` or `api: 'responses'`. Embeddings and reranking use
6
+ * `bedrockEmbedding` and `bedrockRerank`.
8
7
  */
9
8
 
10
9
  import { BedrockTextAdapter } from './adapters/text'
@@ -188,6 +187,12 @@ export {
188
187
  createBedrockEmbedding,
189
188
  type BedrockEmbeddingConfig,
190
189
  } from './adapters/embedding'
190
+ export {
191
+ BedrockRerankAdapter,
192
+ bedrockRerank,
193
+ type BedrockRerankConfig,
194
+ type BedrockRerankProviderOptions,
195
+ } from './adapters/rerank'
191
196
  export type {
192
197
  BedrockCohereEmbeddingInputType,
193
198
  BedrockCohereEmbeddingProviderOptions,
@@ -208,6 +213,8 @@ export {
208
213
  BEDROCK_RESPONSES_MODELS,
209
214
  BEDROCK_CONVERSE_MODELS,
210
215
  BEDROCK_EMBEDDING_MODELS,
216
+ BEDROCK_RERANK_MODELS,
217
+ type BedrockRerankModel,
211
218
  type BedrockEmbeddingModel,
212
219
  type BedrockEmbeddingModelProviderOptionsByName,
213
220
  type BedrockEmbeddingModelInputModalitiesByName,
package/src/model-meta.ts CHANGED
@@ -150,6 +150,15 @@ export const BEDROCK_CLAUDE_NO_FORCED_TOOL_FAMILIES: ReadonlyArray<string> = [
150
150
  'claude-sonnet-5-5',
151
151
  ]
152
152
 
153
+ /** Models supported by the Bedrock Rerank API, separate from the chat catalog. */
154
+ export const BEDROCK_RERANK_MODELS = [
155
+ 'amazon.rerank-v1:0',
156
+ 'cohere.rerank-v3-5:0',
157
+ ] as const
158
+
159
+ /** Short model IDs accepted by the Bedrock rerank adapter. */
160
+ export type BedrockRerankModel = (typeof BEDROCK_RERANK_MODELS)[number]
161
+
153
162
  // ============================================================================
154
163
  // Embedding models
155
164
  // ============================================================================
package/src/utils/auth.ts CHANGED
@@ -57,6 +57,14 @@ export interface BedrockAuthConfig {
57
57
  }
58
58
 
59
59
  /** apiKey -> BEDROCK_API_KEY -> AWS_BEARER_TOKEN_BEDROCK -> SigV4 (credential chain). */
60
+ export function resolveBedrockAuth(
61
+ config: BedrockAuthConfig & { auth: 'sigv4' },
62
+ endpoint: BedrockEndpoint,
63
+ ): Extract<ResolvedBedrockAuth, { kind: 'sigv4' }>
64
+ export function resolveBedrockAuth(
65
+ config: BedrockAuthConfig,
66
+ endpoint: BedrockEndpoint,
67
+ ): ResolvedBedrockAuth
60
68
  export function resolveBedrockAuth(
61
69
  config: BedrockAuthConfig,
62
70
  endpoint: BedrockEndpoint,