@tanstack/ai-muse 0.0.0-stage → 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Tanner Linsley
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,80 @@
-# Temporary Holding Version
+<div align="center">
+  <picture>
+    <source
+      media="(prefers-color-scheme: dark)"
+      srcset="https://tanstack.com/api/readme/ai.png?theme=dark"
+    />
+    <source
+      media="(prefers-color-scheme: light)"
+      srcset="https://tanstack.com/api/readme/ai.png"
+    />
+    <img
+      src="https://tanstack.com/api/readme/ai.png"
+      alt="TanStack AI"
+      width="900"
+    />
+  </picture>
+</div>
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<br />
+
+# @tanstack/ai-muse
+
+Muse provider adapter for TanStack AI.
+
+Muse is served by the Meta Model API through an OpenAI-compatible Chat
+Completions endpoint at `https://api.meta.ai/v1`, so this adapter drives it
+with an OpenAI-compatible client through a `baseURL` override. It gives you
+tree-shakeable text adapters for the Muse model family, including the
+flagship `muse-ember-1.0` (Ember) model.
+
+## Installation
+
+```bash
+npm install @tanstack/ai-muse @tanstack/ai
+```
+
+## Usage
+
+```typescript
+import { museText } from '@tanstack/ai-muse'
+import { chat } from '@tanstack/ai'
+
+// Reads the API key from MUSE_API_KEY (MODEL_API_KEY, the name used in
+// Meta's docs, is also accepted).
+const adapter = museText('muse-ember-1.0')
+
+const result = await chat({
+  adapter,
+  threadId: 'thread-1',
+  stream: false,
+  messages: [{ role: 'user', content: 'Write a haiku about embers.' }],
+})
+
+console.log(result.text)
+```
+
+Pass an explicit key when you do not want to read it from the environment:
+
+```typescript
+import { createMuseText } from '@tanstack/ai-muse'
+
+const adapter = createMuseText('muse-ember-1.0', 'your-meta-model-api-key')
+```
+
+## Models
+
+Chat models served by the Meta Model API:
+
+- `muse-ember-1.0` — flagship for high-volume execution (Ember)
+- `muse-wonder-1.0`
+- `muse-spark-1.3`, `muse-spark-1.2`, `muse-spark-1.1`
+- `muse-spark-1.3-contributor`, `muse-spark-1.2-contributor` — Contributor
+  mode: discounted rates, your traffic may be used for training
+
+All of these accept `text` and `image` input through this adapter. (On the
+API itself they also accept video, audio, and PDF input, which this adapter
+does not yet expose.)
+
+Muse Glimmer is an open-weight model you run yourself; it is not served by
+the Meta Model API and is not part of this adapter.

package/dist/esm/adapters/text.d.ts

@@ -0,0 +1,51 @@
+import { OpenAIBaseChatCompletionsTextAdapter, OpenAIBaseTextAdapterOptions } from '@tanstack/openai-base';
+import { Modality } from '@tanstack/ai';
+import { MUSE_CHAT_MODELS, MuseChatModelToolCapabilitiesByName, MuseModelReasoningByName, ResolveInputModalities, ResolveProviderOptions } from '../model-meta.js';
+import { MuseMessageMetadataByModality } from '../message-types.js';
+import { MuseClientConfig } from '../utils/client.js';
+/** The reasoning levels of a model, for `chat({ reasoning })`. `never`: none. */
+type ResolveReasoning<TModel extends string> = TModel extends keyof MuseModelReasoningByName ? MuseModelReasoningByName[TModel] : never;
+type ResolveToolCapabilities<TModel extends string> = TModel extends keyof MuseChatModelToolCapabilitiesByName ? NonNullable<MuseChatModelToolCapabilitiesByName[TModel]> : readonly [];
+/**
+ * Configuration for the Muse text adapter.
+ */
+export interface MuseTextConfig extends MuseClientConfig, OpenAIBaseTextAdapterOptions {
+}
+/**
+ * Re-export of the public provider options type.
+ */
+export type { ExternalTextProviderOptions as MuseTextProviderOptions } from '../text/text-provider-options.js';
+/**
+ * Muse Text (Chat) Adapter
+ *
+ * Tree-shakeable adapter for Muse chat/text completion. Muse exposes an
+ * OpenAI-compatible Chat Completions endpoint, so we drive it with an
+ * OpenAI-compatible client via a `baseURL` override. There are no Muse-only
+ * wire quirks, so the OpenAI Chat Completions base handles streaming, tools,
+ * reasoning, and structured output unchanged.
+ */
+export declare class MuseTextAdapter<TModel extends (typeof MUSE_CHAT_MODELS)[number], TProviderOptions extends Record<string, any> = ResolveProviderOptions<TModel>, TInputModalities extends ReadonlyArray<Modality> = ResolveInputModalities<TModel>, TToolCapabilities extends ReadonlyArray<string> = ResolveToolCapabilities<TModel>> extends OpenAIBaseChatCompletionsTextAdapter<TModel, TProviderOptions, TInputModalities, MuseMessageMetadataByModality, TToolCapabilities, ResolveReasoning<TModel>> {
+    readonly kind: "text";
+    readonly name: "muse";
+    readonly inputModalities: readonly ("text" | "image" | "audio" | "video" | "document")[] | undefined;
+    constructor(config: MuseTextConfig, model: TModel);
+    protected modelReasoning(model: string): import('@tanstack/ai').ModelReasoning | undefined;
+}
+/**
+ * Creates a Muse text adapter with an explicit API key.
+ *
+ * @example
+ * ```typescript
+ * const adapter = createMuseText('muse-ember-1.0', 'muse_...');
+ * ```
+ */
+export declare function createMuseText<TModel extends (typeof MUSE_CHAT_MODELS)[number]>(model: TModel, apiKey: string, config?: Omit<MuseTextConfig, 'apiKey'>): MuseTextAdapter<TModel>;
+/**
+ * Creates a Muse text adapter with the API key from `MUSE_API_KEY`.
+ *
+ * @example
+ * ```typescript
+ * const adapter = museText('muse-ember-1.0');
+ * ```
+ */
+export declare function museText<TModel extends (typeof MUSE_CHAT_MODELS)[number]>(model: TModel, config?: Omit<MuseTextConfig, 'apiKey'>): MuseTextAdapter<TModel>;

package/dist/esm/adapters/text.js

@@ -0,0 +1,53 @@
+import { MUSE_MODEL_INPUT_MODALITIES, MUSE_MODEL_REASONING } from "../model-meta.js";
+import { getMuseApiKeyFromEnv, withMuseDefaults } from "../utils/client.js";
+import { OpenAIBaseChatCompletionsTextAdapter, createOpenAIClient } from "@tanstack/openai-base";
+//#region src/adapters/text.ts
+/**
+* Muse Text (Chat) Adapter
+*
+* Tree-shakeable adapter for Muse chat/text completion. Muse exposes an
+* OpenAI-compatible Chat Completions endpoint, so we drive it with an
+* OpenAI-compatible client via a `baseURL` override. There are no Muse-only
+* wire quirks, so the OpenAI Chat Completions base handles streaming, tools,
+* reasoning, and structured output unchanged.
+*/
+var MuseTextAdapter = class extends OpenAIBaseChatCompletionsTextAdapter {
+	kind = "text";
+	name = "muse";
+	inputModalities = MUSE_MODEL_INPUT_MODALITIES[this.model];
+	constructor(config, model) {
+		super(model, "muse", createOpenAIClient(withMuseDefaults(config)), config);
+	}
+	modelReasoning(model) {
+		return MUSE_MODEL_REASONING[model];
+	}
+};
+/**
+* Creates a Muse text adapter with an explicit API key.
+*
+* @example
+* ```typescript
+* const adapter = createMuseText('muse-ember-1.0', 'muse_...');
+* ```
+*/
+function createMuseText(model, apiKey, config) {
+	return new MuseTextAdapter({
+		apiKey,
+		...config
+	}, model);
+}
+/**
+* Creates a Muse text adapter with the API key from `MUSE_API_KEY`.
+*
+* @example
+* ```typescript
+* const adapter = museText('muse-ember-1.0');
+* ```
+*/
+function museText(model, config) {
+	return createMuseText(model, getMuseApiKeyFromEnv(), config);
+}
+//#endregion
+export { MuseTextAdapter, createMuseText, museText };
+
+//# sourceMappingURL=text.js.map

package/dist/esm/adapters/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","names":[],"sources":["../../../src/adapters/text.ts"],"sourcesContent":["import {\n  OpenAIBaseChatCompletionsTextAdapter,\n  createOpenAIClient,\n} from '@tanstack/openai-base'\nimport {\n  MUSE_MODEL_INPUT_MODALITIES,\n  MUSE_MODEL_REASONING,\n} from '../model-meta'\nimport { getMuseApiKeyFromEnv, withMuseDefaults } from '../utils/client'\nimport type { Modality } from '@tanstack/ai'\nimport type {\n  MUSE_CHAT_MODELS,\n  MuseChatModelToolCapabilitiesByName,\n  MuseModelReasoningByName,\n  ResolveInputModalities,\n  ResolveProviderOptions,\n} from '../model-meta'\nimport type { MuseMessageMetadataByModality } from '../message-types'\nimport type { MuseClientConfig } from '../utils/client'\nimport type { OpenAIBaseTextAdapterOptions } from '@tanstack/openai-base'\n\n/** The reasoning levels of a model, for `chat({ reasoning })`. `never`: none. */\ntype ResolveReasoning<TModel extends string> =\n  TModel extends keyof MuseModelReasoningByName\n    ? MuseModelReasoningByName[TModel]\n    : never\n\ntype ResolveToolCapabilities<TModel extends string> =\n  TModel extends keyof MuseChatModelToolCapabilitiesByName\n    ? NonNullable<MuseChatModelToolCapabilitiesByName[TModel]>\n    : readonly []\n\n/**\n * Configuration for the Muse text adapter.\n */\nexport interface MuseTextConfig\n  extends MuseClientConfig, OpenAIBaseTextAdapterOptions {}\n\n/**\n * Re-export of the public provider options type.\n */\nexport type { ExternalTextProviderOptions as MuseTextProviderOptions } from '../text/text-provider-options'\n\n/**\n * Muse Text (Chat) Adapter\n *\n * Tree-shakeable adapter for Muse chat/text completion. Muse exposes an\n * OpenAI-compatible Chat Completions endpoint, so we drive it with an\n * OpenAI-compatible client via a `baseURL` override. There are no Muse-only\n * wire quirks, so the OpenAI Chat Completions base handles streaming, tools,\n * reasoning, and structured output unchanged.\n */\nexport class MuseTextAdapter<\n  TModel extends (typeof MUSE_CHAT_MODELS)[number],\n  TProviderOptions extends Record<string, any> = ResolveProviderOptions<TModel>,\n  TInputModalities extends ReadonlyArray<Modality> =\n    ResolveInputModalities<TModel>,\n  TToolCapabilities extends ReadonlyArray<string> =\n    ResolveToolCapabilities<TModel>,\n> extends OpenAIBaseChatCompletionsTextAdapter<\n  TModel,\n  TProviderOptions,\n  TInputModalities,\n  MuseMessageMetadataByModality,\n  TToolCapabilities,\n  ResolveReasoning<TModel>\n> {\n  override readonly kind = 'text' as const\n  override readonly name = 'muse' as const\n  override readonly inputModalities = MUSE_MODEL_INPUT_MODALITIES[this.model]\n\n  constructor(config: MuseTextConfig, model: TModel) {\n    super(model, 'muse', createOpenAIClient(withMuseDefaults(config)), config)\n  }\n\n  protected override modelReasoning(model: string) {\n    return MUSE_MODEL_REASONING[model]\n  }\n}\n\n/**\n * Creates a Muse text adapter with an explicit API key.\n *\n * @example\n * ```typescript\n * const adapter = createMuseText('muse-ember-1.0', 'muse_...');\n * ```\n */\nexport function createMuseText<\n  TModel extends (typeof MUSE_CHAT_MODELS)[number],\n>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<MuseTextConfig, 'apiKey'>,\n): MuseTextAdapter<TModel> {\n  return new MuseTextAdapter({ apiKey, ...config }, model)\n}\n\n/**\n * Creates a Muse text adapter with the API key from `MUSE_API_KEY`.\n *\n * @example\n * ```typescript\n * const adapter = museText('muse-ember-1.0');\n * ```\n */\nexport function museText<TModel extends (typeof MUSE_CHAT_MODELS)[number]>(\n  model: TModel,\n  config?: Omit<MuseTextConfig, 'apiKey'>,\n): MuseTextAdapter<TModel> {\n  const apiKey = getMuseApiKeyFromEnv()\n  return createMuseText(model, apiKey, config)\n}\n"],"mappings":";;;;;;;;;;;;;AAoDA,IAAa,kBAAb,cAOU,qCAOR;CACA,OAAyB;CACzB,OAAyB;CACzB,kBAAoC,4BAA4B,KAAK;CAErE,YAAY,QAAwB,OAAe;EACjD,MAAM,OAAO,QAAQ,mBAAmB,iBAAiB,MAAM,CAAC,GAAG,MAAM;CAC3E;CAEA,eAAkC,OAAe;EAC/C,OAAO,qBAAqB;CAC9B;AACF;;;;;;;;;AAUA,SAAgB,eAGd,OACA,QACA,QACyB;CACzB,OAAO,IAAI,gBAAgB;EAAE;EAAQ,GAAG;CAAO,GAAG,KAAK;AACzD;;;;;;;;;AAUA,SAAgB,SACd,OACA,QACyB;CAEzB,OAAO,eAAe,OADP,qBACc,GAAQ,MAAM;AAC7C"}

package/dist/esm/byok.d.ts

@@ -0,0 +1 @@
+export declare const museByok: import('@tanstack/ai/byok').ByokProvider<"muse">;

package/dist/esm/byok.js

@@ -0,0 +1,11 @@
+import { defineByokProvider } from "@tanstack/ai/byok";
+//#region src/byok.ts
+var museByok = defineByokProvider({
+	id: "muse",
+	label: "Muse",
+	env: "MUSE_API_KEY"
+});
+//#endregion
+export { museByok };
+
+//# sourceMappingURL=byok.js.map

package/dist/esm/byok.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"byok.js","names":[],"sources":["../../src/byok.ts"],"sourcesContent":["import { defineByokProvider } from '@tanstack/ai/byok'\n\nexport const museByok = defineByokProvider({\n  id: 'muse',\n  label: 'Muse',\n  env: 'MUSE_API_KEY',\n})\n"],"mappings":";;AAEA,IAAa,WAAW,mBAAmB;CACzC,IAAI;CACJ,OAAO;CACP,KAAK;AACP,CAAC"}

package/dist/esm/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @module @tanstack/ai-muse
+ *
+ * Muse provider adapter for TanStack AI.
+ * Provides a tree-shakeable adapter for Muse's OpenAI-compatible Chat
+ * Completions endpoint, including the flagship `muse-ember-1.0` (Ember) model.
+ */
+export { MuseTextAdapter, createMuseText, museText, type MuseTextConfig, type MuseTextProviderOptions, } from './adapters/text.js';
+export type { MuseChatModels, MuseChatModelProviderOptionsByName, MuseChatModelToolCapabilitiesByName, MuseModelInputModalitiesByName, MuseModelReasoningByName, ResolveProviderOptions, ResolveInputModalities, } from './model-meta.js';
+export { MUSE_CHAT_MODELS } from './model-meta.js';
+export type { MuseTextMetadata, MuseImageMetadata, MuseAudioMetadata, MuseVideoMetadata, MuseDocumentMetadata, MuseMessageMetadataByModality, } from './message-types.js';

package/dist/esm/index.js

@@ -0,0 +1,3 @@
+import { MUSE_CHAT_MODELS } from "./model-meta.js";
+import { MuseTextAdapter, createMuseText, museText } from "./adapters/text.js";
+export { MUSE_CHAT_MODELS, MuseTextAdapter, createMuseText, museText };

package/dist/esm/message-types.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Muse message metadata types.
+ *
+ * Muse uses the OpenAI Chat Completions wire format, so these hold the
+ * provider-specific metadata a caller can attach to each content part. Muse
+ * has no extra per-part options today, so text is empty and image mirrors the
+ * standard `detail` control.
+ */
+/** Metadata for Muse text content parts. */
+export interface MuseTextMetadata {
+}
+/** Metadata for Muse image content parts. */
+export interface MuseImageMetadata {
+    /**
+     * The detail level of the image.
+     * - 'auto': let the model decide based on image size and content
+     * - 'low': low resolution processing (faster, cheaper, less detail)
+     * - 'high': high resolution processing (slower, more expensive, more detail)
+     *
+     * @default 'auto'
+     */
+    detail?: 'auto' | 'low' | 'high';
+}
+/** Metadata for Muse audio content parts. */
+export interface MuseAudioMetadata {
+}
+/** Metadata for Muse video content parts. */
+export interface MuseVideoMetadata {
+}
+/** Metadata for Muse document content parts. */
+export interface MuseDocumentMetadata {
+}
+/**
+ * Map of modality types to their Muse-specific metadata types.
+ * Used for type inference when constructing multimodal messages.
+ */
+export interface MuseMessageMetadataByModality {
+    text: MuseTextMetadata;
+    image: MuseImageMetadata;
+    audio: MuseAudioMetadata;
+    video: MuseVideoMetadata;
+    document: MuseDocumentMetadata;
+}

package/dist/esm/model-meta.d.ts

@@ -0,0 +1,369 @@
+import { Modality, ModelReasoning } from '@tanstack/ai';
+import { ModelReasoningCapability } from '@tanstack/ai/adapter-internals';
+import { MuseTextProviderOptions } from './text/text-provider-options.js';
+declare const EMBER_1_0: {
+    readonly name: "muse-ember-1.0";
+    readonly context_window: 1048576;
+    readonly max_completion_tokens: 524288;
+    readonly pricing: {
+        readonly input: {
+            readonly normal: 0.1;
+            readonly cached: 0.004;
+        };
+        readonly output: {
+            readonly normal: 0.5;
+        };
+    };
+    readonly supports: {
+        readonly input: ["text", "image"];
+        readonly output: ["text"];
+        readonly endpoints: ["chat"];
+        readonly features: ["streaming", "tools", "json_object", "json_schema", "reasoning", "vision"];
+        readonly tools: readonly [];
+    };
+    readonly reasoning: {
+        readonly levels: {
+            readonly minimal: "minimal";
+            readonly low: "low";
+            readonly medium: "medium";
+            readonly high: "high";
+            readonly xhigh: "xhigh";
+            readonly max: "max";
+        };
+        readonly budget: false;
+    };
+};
+declare const WONDER_1_0: {
+    readonly name: "muse-wonder-1.0";
+    readonly context_window: 1048576;
+    readonly max_completion_tokens: 131072;
+    readonly pricing: {
+        readonly input: {
+            readonly normal: 4;
+            readonly cached: 0.2;
+        };
+        readonly output: {
+            readonly normal: 20;
+        };
+    };
+    readonly supports: {
+        readonly input: ["text", "image"];
+        readonly output: ["text"];
+        readonly endpoints: ["chat"];
+        readonly features: ["streaming", "tools", "json_object", "json_schema", "reasoning", "vision"];
+        readonly tools: readonly [];
+    };
+    readonly reasoning: {
+        readonly levels: {
+            readonly minimal: "minimal";
+            readonly low: "low";
+            readonly medium: "medium";
+            readonly high: "high";
+            readonly xhigh: "xhigh";
+            readonly max: "max";
+        };
+        readonly budget: false;
+    };
+};
+declare const SPARK_1_3: {
+    readonly name: "muse-spark-1.3";
+    readonly context_window: 1048576;
+    readonly max_completion_tokens: 131072;
+    readonly pricing: {
+        readonly input: {
+            readonly normal: 1.25;
+            readonly cached: 0.15;
+        };
+        readonly output: {
+            readonly normal: 4.25;
+        };
+    };
+    readonly supports: {
+        readonly input: ["text", "image"];
+        readonly output: ["text"];
+        readonly endpoints: ["chat"];
+        readonly features: ["streaming", "tools", "json_object", "json_schema", "reasoning", "vision"];
+        readonly tools: readonly [];
+    };
+    readonly reasoning: {
+        readonly levels: {
+            readonly minimal: "minimal";
+            readonly low: "low";
+            readonly medium: "medium";
+            readonly high: "high";
+            readonly xhigh: "xhigh";
+            readonly max: "max";
+        };
+        readonly budget: false;
+    };
+};
+declare const SPARK_1_3_CONTRIBUTOR: {
+    readonly name: "muse-spark-1.3-contributor";
+    readonly context_window: 1048576;
+    readonly max_completion_tokens: 131072;
+    readonly pricing: {
+        readonly input: {
+            readonly normal: 0.1;
+            readonly cached: 0.002;
+        };
+        readonly output: {
+            readonly normal: 0.2;
+        };
+    };
+    readonly supports: {
+        readonly input: ["text", "image"];
+        readonly output: ["text"];
+        readonly endpoints: ["chat"];
+        readonly features: ["streaming", "tools", "json_object", "json_schema", "reasoning", "vision"];
+        readonly tools: readonly [];
+    };
+    readonly reasoning: {
+        readonly levels: {
+            readonly minimal: "minimal";
+            readonly low: "low";
+            readonly medium: "medium";
+            readonly high: "high";
+            readonly xhigh: "xhigh";
+        };
+        readonly budget: false;
+    };
+};
+declare const SPARK_1_2: {
+    readonly name: "muse-spark-1.2";
+    readonly context_window: 1048576;
+    readonly max_completion_tokens: 131072;
+    readonly pricing: {
+        readonly input: {
+            readonly normal: 1.25;
+            readonly cached: 0.15;
+        };
+        readonly output: {
+            readonly normal: 4.25;
+        };
+    };
+    readonly supports: {
+        readonly input: ["text", "image"];
+        readonly output: ["text"];
+        readonly endpoints: ["chat"];
+        readonly features: ["streaming", "tools", "json_object", "json_schema", "reasoning", "vision"];
+        readonly tools: readonly [];
+    };
+    readonly reasoning: {
+        readonly levels: {
+            readonly minimal: "minimal";
+            readonly low: "low";
+            readonly medium: "medium";
+            readonly high: "high";
+            readonly xhigh: "xhigh";
+        };
+        readonly budget: false;
+    };
+};
+declare const SPARK_1_2_CONTRIBUTOR: {
+    readonly name: "muse-spark-1.2-contributor";
+    readonly context_window: 1048576;
+    readonly max_completion_tokens: 131072;
+    readonly pricing: {
+        readonly input: {
+            readonly normal: 0.1;
+            readonly cached: 0.002;
+        };
+        readonly output: {
+            readonly normal: 0.2;
+        };
+    };
+    readonly supports: {
+        readonly input: ["text", "image"];
+        readonly output: ["text"];
+        readonly endpoints: ["chat"];
+        readonly features: ["streaming", "tools", "json_object", "json_schema", "reasoning", "vision"];
+        readonly tools: readonly [];
+    };
+    readonly reasoning: {
+        readonly levels: {
+            readonly minimal: "minimal";
+            readonly low: "low";
+            readonly medium: "medium";
+            readonly high: "high";
+            readonly xhigh: "xhigh";
+        };
+        readonly budget: false;
+    };
+};
+declare const SPARK_1_1: {
+    readonly name: "muse-spark-1.1";
+    readonly context_window: 1048576;
+    readonly max_completion_tokens: 32768;
+    readonly pricing: {
+        readonly input: {
+            readonly normal: 1.25;
+            readonly cached: 0.15;
+        };
+        readonly output: {
+            readonly normal: 4.25;
+        };
+    };
+    readonly supports: {
+        readonly input: ["text", "image"];
+        readonly output: ["text"];
+        readonly endpoints: ["chat"];
+        readonly features: ["streaming", "tools", "json_object", "json_schema", "reasoning", "vision"];
+        readonly tools: readonly [];
+    };
+    readonly reasoning: {
+        readonly levels: {
+            readonly minimal: "minimal";
+            readonly low: "low";
+            readonly medium: "medium";
+            readonly high: "high";
+            readonly xhigh: "xhigh";
+        };
+        readonly budget: false;
+    };
+};
+/**
+ * All supported Muse chat model identifiers.
+ */
+export declare const MUSE_CHAT_MODELS: readonly ["muse-ember-1.0", "muse-wonder-1.0", "muse-spark-1.3", "muse-spark-1.3-contributor", "muse-spark-1.2", "muse-spark-1.2-contributor", "muse-spark-1.1"];
+/**
+ * Union type of all supported Muse chat model names.
+ */
+export type MuseChatModels = (typeof MUSE_CHAT_MODELS)[number];
+/**
+ * Type-only map from Muse chat model name to its supported input modalities.
+ */
+export type MuseModelInputModalitiesByName = {
+    [EMBER_1_0.name]: typeof EMBER_1_0.supports.input;
+    [WONDER_1_0.name]: typeof WONDER_1_0.supports.input;
+    [SPARK_1_3.name]: typeof SPARK_1_3.supports.input;
+    [SPARK_1_3_CONTRIBUTOR.name]: typeof SPARK_1_3_CONTRIBUTOR.supports.input;
+    [SPARK_1_2.name]: typeof SPARK_1_2.supports.input;
+    [SPARK_1_2_CONTRIBUTOR.name]: typeof SPARK_1_2_CONTRIBUTOR.supports.input;
+    [SPARK_1_1.name]: typeof SPARK_1_1.supports.input;
+};
+/**
+ * Runtime map from chat model name to its supported input modalities, for the
+ * text adapter's `inputModalities`. `satisfies` keeps it equal to
+ * {@link MuseModelInputModalitiesByName}. An unknown name gives `undefined`.
+ */
+export declare const MUSE_MODEL_INPUT_MODALITIES: Readonly<Record<string, ReadonlyArray<Modality>>>;
+/**
+ * Type-only map from Muse chat model name to its provider options type.
+ */
+export type MuseChatModelProviderOptionsByName = {
+    [K in (typeof MUSE_CHAT_MODELS)[number]]: MuseTextProviderOptions;
+};
+/**
+ * Type-only map from Muse chat model name to its supported provider tools.
+ * Muse exposes no provider-specific tool factories, so every model gets an
+ * empty tuple. This makes passing another provider's ProviderTool to a Muse
+ * adapter a compile-time type error.
+ */
+export type MuseChatModelToolCapabilitiesByName = {
+    [EMBER_1_0.name]: typeof EMBER_1_0.supports.tools;
+    [WONDER_1_0.name]: typeof WONDER_1_0.supports.tools;
+    [SPARK_1_3.name]: typeof SPARK_1_3.supports.tools;
+    [SPARK_1_3_CONTRIBUTOR.name]: typeof SPARK_1_3_CONTRIBUTOR.supports.tools;
+    [SPARK_1_2.name]: typeof SPARK_1_2.supports.tools;
+    [SPARK_1_2_CONTRIBUTOR.name]: typeof SPARK_1_2_CONTRIBUTOR.supports.tools;
+    [SPARK_1_1.name]: typeof SPARK_1_1.supports.tools;
+};
+/**
+ * Resolves the provider options type for a specific Muse model.
+ */
+export type ResolveProviderOptions<TModel extends string> = TModel extends keyof MuseChatModelProviderOptionsByName ? MuseChatModelProviderOptionsByName[TModel] : MuseTextProviderOptions;
+/**
+ * Resolve input modalities for a specific model. If the model has explicit
+ * modalities in the map, use those; otherwise use text only.
+ */
+export type ResolveInputModalities<TModel extends string> = TModel extends keyof MuseModelInputModalitiesByName ? MuseModelInputModalitiesByName[TModel] : readonly ['text'];
+declare const MUSE_REASONING: {
+    "muse-ember-1.0": {
+        readonly levels: {
+            readonly minimal: "minimal";
+            readonly low: "low";
+            readonly medium: "medium";
+            readonly high: "high";
+            readonly xhigh: "xhigh";
+            readonly max: "max";
+        };
+        readonly budget: false;
+    };
+    "muse-wonder-1.0": {
+        readonly levels: {
+            readonly minimal: "minimal";
+            readonly low: "low";
+            readonly medium: "medium";
+            readonly high: "high";
+            readonly xhigh: "xhigh";
+            readonly max: "max";
+        };
+        readonly budget: false;
+    };
+    "muse-spark-1.3": {
+        readonly levels: {
+            readonly minimal: "minimal";
+            readonly low: "low";
+            readonly medium: "medium";
+            readonly high: "high";
+            readonly xhigh: "xhigh";
+            readonly max: "max";
+        };
+        readonly budget: false;
+    };
+    "muse-spark-1.3-contributor": {
+        readonly levels: {
+            readonly minimal: "minimal";
+            readonly low: "low";
+            readonly medium: "medium";
+            readonly high: "high";
+            readonly xhigh: "xhigh";
+        };
+        readonly budget: false;
+    };
+    "muse-spark-1.2": {
+        readonly levels: {
+            readonly minimal: "minimal";
+            readonly low: "low";
+            readonly medium: "medium";
+            readonly high: "high";
+            readonly xhigh: "xhigh";
+        };
+        readonly budget: false;
+    };
+    "muse-spark-1.2-contributor": {
+        readonly levels: {
+            readonly minimal: "minimal";
+            readonly low: "low";
+            readonly medium: "medium";
+            readonly high: "high";
+            readonly xhigh: "xhigh";
+        };
+        readonly budget: false;
+    };
+    "muse-spark-1.1": {
+        readonly levels: {
+            readonly minimal: "minimal";
+            readonly low: "low";
+            readonly medium: "medium";
+            readonly high: "high";
+            readonly xhigh: "xhigh";
+        };
+        readonly budget: false;
+    };
+};
+/**
+ * Each chat model's reasoning levels, and whether it takes a token budget, for
+ * `chat({ reasoning })`. Derived from the `reasoning` field. A model that is
+ * not here does not reason.
+ */
+export type MuseModelReasoningByName = {
+    [K in keyof typeof MUSE_REASONING]: ModelReasoningCapability<(typeof MUSE_REASONING)[K]>;
+};
+/**
+ * Runtime map from chat model name to its reasoning data, for the text
+ * adapter. An unknown name gives `undefined`: the adapter sends no reasoning
+ * field.
+ */
+export declare const MUSE_MODEL_REASONING: Readonly<Record<string, ModelReasoning>>;
+export {};