@tanstack/ai-muse 0.0.0-stage → 0.1.0

package/dist/esm/model-meta.js

@@ -0,0 +1,214 @@
+//#region src/model-meta.ts
+var EFFORT_MINIMAL_TO_MAX = {
+	levels: {
+		minimal: "minimal",
+		low: "low",
+		medium: "medium",
+		high: "high",
+		xhigh: "xhigh",
+		max: "max"
+	},
+	budget: false
+};
+var EFFORT_MINIMAL_TO_XHIGH = {
+	levels: {
+		minimal: "minimal",
+		low: "low",
+		medium: "medium",
+		high: "high",
+		xhigh: "xhigh"
+	},
+	budget: false
+};
+var FEATURES = [
+	"streaming",
+	"tools",
+	"json_object",
+	"json_schema",
+	"reasoning",
+	"vision"
+];
+var EMBER_1_0 = {
+	name: "muse-ember-1.0",
+	context_window: 1048576,
+	max_completion_tokens: 524288,
+	pricing: {
+		input: {
+			normal: .1,
+			cached: .004
+		},
+		output: { normal: .5 }
+	},
+	supports: {
+		input: ["text", "image"],
+		output: ["text"],
+		endpoints: ["chat"],
+		features: [...FEATURES],
+		tools: []
+	},
+	reasoning: EFFORT_MINIMAL_TO_MAX
+};
+var WONDER_1_0 = {
+	name: "muse-wonder-1.0",
+	context_window: 1048576,
+	max_completion_tokens: 131072,
+	pricing: {
+		input: {
+			normal: 4,
+			cached: .2
+		},
+		output: { normal: 20 }
+	},
+	supports: {
+		input: ["text", "image"],
+		output: ["text"],
+		endpoints: ["chat"],
+		features: [...FEATURES],
+		tools: []
+	},
+	reasoning: EFFORT_MINIMAL_TO_MAX
+};
+var SPARK_1_3 = {
+	name: "muse-spark-1.3",
+	context_window: 1048576,
+	max_completion_tokens: 131072,
+	pricing: {
+		input: {
+			normal: 1.25,
+			cached: .15
+		},
+		output: { normal: 4.25 }
+	},
+	supports: {
+		input: ["text", "image"],
+		output: ["text"],
+		endpoints: ["chat"],
+		features: [...FEATURES],
+		tools: []
+	},
+	reasoning: EFFORT_MINIMAL_TO_MAX
+};
+var SPARK_1_3_CONTRIBUTOR = {
+	name: "muse-spark-1.3-contributor",
+	context_window: 1048576,
+	max_completion_tokens: 131072,
+	pricing: {
+		input: {
+			normal: .1,
+			cached: .002
+		},
+		output: { normal: .2 }
+	},
+	supports: {
+		input: ["text", "image"],
+		output: ["text"],
+		endpoints: ["chat"],
+		features: [...FEATURES],
+		tools: []
+	},
+	reasoning: EFFORT_MINIMAL_TO_XHIGH
+};
+var SPARK_1_2 = {
+	name: "muse-spark-1.2",
+	context_window: 1048576,
+	max_completion_tokens: 131072,
+	pricing: {
+		input: {
+			normal: 1.25,
+			cached: .15
+		},
+		output: { normal: 4.25 }
+	},
+	supports: {
+		input: ["text", "image"],
+		output: ["text"],
+		endpoints: ["chat"],
+		features: [...FEATURES],
+		tools: []
+	},
+	reasoning: EFFORT_MINIMAL_TO_XHIGH
+};
+var SPARK_1_2_CONTRIBUTOR = {
+	name: "muse-spark-1.2-contributor",
+	context_window: 1048576,
+	max_completion_tokens: 131072,
+	pricing: {
+		input: {
+			normal: .1,
+			cached: .002
+		},
+		output: { normal: .2 }
+	},
+	supports: {
+		input: ["text", "image"],
+		output: ["text"],
+		endpoints: ["chat"],
+		features: [...FEATURES],
+		tools: []
+	},
+	reasoning: EFFORT_MINIMAL_TO_XHIGH
+};
+var SPARK_1_1 = {
+	name: "muse-spark-1.1",
+	context_window: 1048576,
+	max_completion_tokens: 32768,
+	pricing: {
+		input: {
+			normal: 1.25,
+			cached: .15
+		},
+		output: { normal: 4.25 }
+	},
+	supports: {
+		input: ["text", "image"],
+		output: ["text"],
+		endpoints: ["chat"],
+		features: [...FEATURES],
+		tools: []
+	},
+	reasoning: EFFORT_MINIMAL_TO_XHIGH
+};
+/**
+* All supported Muse chat model identifiers.
+*/
+var MUSE_CHAT_MODELS = [
+	EMBER_1_0.name,
+	WONDER_1_0.name,
+	SPARK_1_3.name,
+	SPARK_1_3_CONTRIBUTOR.name,
+	SPARK_1_2.name,
+	SPARK_1_2_CONTRIBUTOR.name,
+	SPARK_1_1.name
+];
+/**
+* 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`.
+*/
+var MUSE_MODEL_INPUT_MODALITIES = {
+	[EMBER_1_0.name]: EMBER_1_0.supports.input,
+	[WONDER_1_0.name]: WONDER_1_0.supports.input,
+	[SPARK_1_3.name]: SPARK_1_3.supports.input,
+	[SPARK_1_3_CONTRIBUTOR.name]: SPARK_1_3_CONTRIBUTOR.supports.input,
+	[SPARK_1_2.name]: SPARK_1_2.supports.input,
+	[SPARK_1_2_CONTRIBUTOR.name]: SPARK_1_2_CONTRIBUTOR.supports.input,
+	[SPARK_1_1.name]: SPARK_1_1.supports.input
+};
+/**
+* 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.
+*/
+var MUSE_MODEL_REASONING = {
+	[EMBER_1_0.name]: EMBER_1_0.reasoning,
+	[WONDER_1_0.name]: WONDER_1_0.reasoning,
+	[SPARK_1_3.name]: SPARK_1_3.reasoning,
+	[SPARK_1_3_CONTRIBUTOR.name]: SPARK_1_3_CONTRIBUTOR.reasoning,
+	[SPARK_1_2.name]: SPARK_1_2.reasoning,
+	[SPARK_1_2_CONTRIBUTOR.name]: SPARK_1_2_CONTRIBUTOR.reasoning,
+	[SPARK_1_1.name]: SPARK_1_1.reasoning
+};
+//#endregion
+export { MUSE_CHAT_MODELS, MUSE_MODEL_INPUT_MODALITIES, MUSE_MODEL_REASONING };
+
+//# sourceMappingURL=model-meta.js.map

package/dist/esm/model-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-meta.js","names":[],"sources":["../../src/model-meta.ts"],"sourcesContent":["import type { Modality, ModelReasoning } from '@tanstack/ai'\nimport type { ModelReasoningCapability } from '@tanstack/ai/adapter-internals'\nimport type { MuseTextProviderOptions } from './text/text-provider-options'\n\n// Model data below is from Meta's official Model API docs (dev.meta.ai):\n// \"Pricing and rate limits\", \"Choose a model\", and the per-model pages,\n// checked 2026-11-11. Prices are USD per 1M tokens, Standard mode unless the\n// model id says `-contributor`. Every reasoning model on the API has a\n// 1,048,576-token context window. Muse Glimmer is an open-weight,\n// self-hosted model — it is NOT served by the Model API and is deliberately\n// absent here.\n\n// Reasoning shapes: the levels a model has for `chat({ reasoning })`, and the\n// provider value to send for each. Each model points at one of them.\nconst EFFORT_MINIMAL_TO_MAX = {\n  levels: {\n    minimal: 'minimal',\n    low: 'low',\n    medium: 'medium',\n    high: 'high',\n    xhigh: 'xhigh',\n    max: 'max',\n  },\n  budget: false,\n} as const\nconst EFFORT_MINIMAL_TO_XHIGH = {\n  levels: {\n    minimal: 'minimal',\n    low: 'low',\n    medium: 'medium',\n    high: 'high',\n    xhigh: 'xhigh',\n  },\n  budget: false,\n} as const\n\n/**\n * Internal metadata structure describing a Muse model's capabilities and\n * pricing.\n */\ninterface ModelMeta<TProviderOptions = unknown> {\n  name: string\n  context_window?: number\n  max_completion_tokens?: number\n  pricing: {\n    input?: { normal: number; cached?: number }\n    output?: { normal: number }\n  }\n  supports: {\n    input: Array<'text' | 'image'>\n    output: Array<'text'>\n    endpoints: Array<'chat'>\n    features: Array<\n      | 'streaming'\n      | 'tools'\n      | 'json_object'\n      | 'json_schema'\n      | 'reasoning'\n      | 'vision'\n    >\n    tools?: ReadonlyArray<never>\n  }\n  /** Type-level description of which provider options this model supports. */\n  providerOptions?: TProviderOptions\n  /** The model's data for `chat({ reasoning })`. None: it does not reason. */\n  reasoning?: ModelReasoning\n}\n\nconst FEATURES = [\n  'streaming',\n  'tools',\n  'json_object',\n  'json_schema',\n  'reasoning',\n  'vision',\n] as const\n\n// Ember pricing is the ≤200K-input-token tier; requests over 200K input\n// tokens bill at 3x ($0.30 / $0.012 cached / $1.50) for the whole request.\nconst EMBER_1_0 = {\n  name: 'muse-ember-1.0',\n  context_window: 1_048_576,\n  max_completion_tokens: 524_288,\n  pricing: {\n    input: { normal: 0.1, cached: 0.004 },\n    output: { normal: 0.5 },\n  },\n  supports: {\n    input: ['text', 'image'],\n    output: ['text'],\n    endpoints: ['chat'],\n    features: [...FEATURES],\n    tools: [] as const,\n  },\n  reasoning: EFFORT_MINIMAL_TO_MAX,\n} as const satisfies ModelMeta<MuseTextProviderOptions>\n\nconst WONDER_1_0 = {\n  name: 'muse-wonder-1.0',\n  context_window: 1_048_576,\n  max_completion_tokens: 131_072,\n  pricing: {\n    input: { normal: 4, cached: 0.2 },\n    output: { normal: 20 },\n  },\n  supports: {\n    input: ['text', 'image'],\n    output: ['text'],\n    endpoints: ['chat'],\n    features: [...FEATURES],\n    tools: [] as const,\n  },\n  reasoning: EFFORT_MINIMAL_TO_MAX,\n} as const satisfies ModelMeta<MuseTextProviderOptions>\n\nconst SPARK_1_3 = {\n  name: 'muse-spark-1.3',\n  context_window: 1_048_576,\n  max_completion_tokens: 131_072,\n  pricing: {\n    input: { normal: 1.25, cached: 0.15 },\n    output: { normal: 4.25 },\n  },\n  supports: {\n    input: ['text', 'image'],\n    output: ['text'],\n    endpoints: ['chat'],\n    features: [...FEATURES],\n    tools: [] as const,\n  },\n  // Spark 1.3 is the only Spark that accepts `max` effort.\n  reasoning: EFFORT_MINIMAL_TO_MAX,\n} as const satisfies ModelMeta<MuseTextProviderOptions>\n\nconst SPARK_1_3_CONTRIBUTOR = {\n  name: 'muse-spark-1.3-contributor',\n  context_window: 1_048_576,\n  max_completion_tokens: 131_072,\n  pricing: {\n    input: { normal: 0.1, cached: 0.002 },\n    output: { normal: 0.2 },\n  },\n  supports: {\n    input: ['text', 'image'],\n    output: ['text'],\n    endpoints: ['chat'],\n    features: [...FEATURES],\n    tools: [] as const,\n  },\n  // `max` is not available on the Contributor variant.\n  reasoning: EFFORT_MINIMAL_TO_XHIGH,\n} as const satisfies ModelMeta<MuseTextProviderOptions>\n\nconst SPARK_1_2 = {\n  name: 'muse-spark-1.2',\n  context_window: 1_048_576,\n  max_completion_tokens: 131_072,\n  pricing: {\n    input: { normal: 1.25, cached: 0.15 },\n    output: { normal: 4.25 },\n  },\n  supports: {\n    input: ['text', 'image'],\n    output: ['text'],\n    endpoints: ['chat'],\n    features: [...FEATURES],\n    tools: [] as const,\n  },\n  reasoning: EFFORT_MINIMAL_TO_XHIGH,\n} as const satisfies ModelMeta<MuseTextProviderOptions>\n\nconst SPARK_1_2_CONTRIBUTOR = {\n  name: 'muse-spark-1.2-contributor',\n  context_window: 1_048_576,\n  max_completion_tokens: 131_072,\n  pricing: {\n    input: { normal: 0.1, cached: 0.002 },\n    output: { normal: 0.2 },\n  },\n  supports: {\n    input: ['text', 'image'],\n    output: ['text'],\n    endpoints: ['chat'],\n    features: [...FEATURES],\n    tools: [] as const,\n  },\n  reasoning: EFFORT_MINIMAL_TO_XHIGH,\n} as const satisfies ModelMeta<MuseTextProviderOptions>\n\nconst SPARK_1_1 = {\n  name: 'muse-spark-1.1',\n  context_window: 1_048_576,\n  max_completion_tokens: 32_768,\n  pricing: {\n    input: { normal: 1.25, cached: 0.15 },\n    output: { normal: 4.25 },\n  },\n  supports: {\n    input: ['text', 'image'],\n    output: ['text'],\n    endpoints: ['chat'],\n    features: [...FEATURES],\n    tools: [] as const,\n  },\n  reasoning: EFFORT_MINIMAL_TO_XHIGH,\n} as const satisfies ModelMeta<MuseTextProviderOptions>\n\n/**\n * All supported Muse chat model identifiers.\n */\nexport const MUSE_CHAT_MODELS = [\n  EMBER_1_0.name,\n  WONDER_1_0.name,\n  SPARK_1_3.name,\n  SPARK_1_3_CONTRIBUTOR.name,\n  SPARK_1_2.name,\n  SPARK_1_2_CONTRIBUTOR.name,\n  SPARK_1_1.name,\n] as const\n\n/**\n * Union type of all supported Muse chat model names.\n */\nexport type MuseChatModels = (typeof MUSE_CHAT_MODELS)[number]\n\n/**\n * Type-only map from Muse chat model name to its supported input modalities.\n */\nexport type MuseModelInputModalitiesByName = {\n  [EMBER_1_0.name]: typeof EMBER_1_0.supports.input\n  [WONDER_1_0.name]: typeof WONDER_1_0.supports.input\n  [SPARK_1_3.name]: typeof SPARK_1_3.supports.input\n  [SPARK_1_3_CONTRIBUTOR.name]: typeof SPARK_1_3_CONTRIBUTOR.supports.input\n  [SPARK_1_2.name]: typeof SPARK_1_2.supports.input\n  [SPARK_1_2_CONTRIBUTOR.name]: typeof SPARK_1_2_CONTRIBUTOR.supports.input\n  [SPARK_1_1.name]: typeof SPARK_1_1.supports.input\n}\n\n/**\n * Runtime map from chat model name to its supported input modalities, for the\n * text adapter's `inputModalities`. `satisfies` keeps it equal to\n * {@link MuseModelInputModalitiesByName}. An unknown name gives `undefined`.\n */\nexport const MUSE_MODEL_INPUT_MODALITIES: Readonly<\n  Record<string, ReadonlyArray<Modality>>\n> = {\n  [EMBER_1_0.name]: EMBER_1_0.supports.input,\n  [WONDER_1_0.name]: WONDER_1_0.supports.input,\n  [SPARK_1_3.name]: SPARK_1_3.supports.input,\n  [SPARK_1_3_CONTRIBUTOR.name]: SPARK_1_3_CONTRIBUTOR.supports.input,\n  [SPARK_1_2.name]: SPARK_1_2.supports.input,\n  [SPARK_1_2_CONTRIBUTOR.name]: SPARK_1_2_CONTRIBUTOR.supports.input,\n  [SPARK_1_1.name]: SPARK_1_1.supports.input,\n} satisfies MuseModelInputModalitiesByName\n\n/**\n * Type-only map from Muse chat model name to its provider options type.\n */\nexport type MuseChatModelProviderOptionsByName = {\n  [K in (typeof MUSE_CHAT_MODELS)[number]]: MuseTextProviderOptions\n}\n\n/**\n * Type-only map from Muse chat model name to its supported provider tools.\n * Muse exposes no provider-specific tool factories, so every model gets an\n * empty tuple. This makes passing another provider's ProviderTool to a Muse\n * adapter a compile-time type error.\n */\nexport type MuseChatModelToolCapabilitiesByName = {\n  [EMBER_1_0.name]: typeof EMBER_1_0.supports.tools\n  [WONDER_1_0.name]: typeof WONDER_1_0.supports.tools\n  [SPARK_1_3.name]: typeof SPARK_1_3.supports.tools\n  [SPARK_1_3_CONTRIBUTOR.name]: typeof SPARK_1_3_CONTRIBUTOR.supports.tools\n  [SPARK_1_2.name]: typeof SPARK_1_2.supports.tools\n  [SPARK_1_2_CONTRIBUTOR.name]: typeof SPARK_1_2_CONTRIBUTOR.supports.tools\n  [SPARK_1_1.name]: typeof SPARK_1_1.supports.tools\n}\n\n/**\n * Resolves the provider options type for a specific Muse model.\n */\nexport type ResolveProviderOptions<TModel extends string> =\n  TModel extends keyof MuseChatModelProviderOptionsByName\n    ? MuseChatModelProviderOptionsByName[TModel]\n    : MuseTextProviderOptions\n\n/**\n * Resolve input modalities for a specific model. If the model has explicit\n * modalities in the map, use those; otherwise use text only.\n */\nexport type ResolveInputModalities<TModel extends string> =\n  TModel extends keyof MuseModelInputModalitiesByName\n    ? MuseModelInputModalitiesByName[TModel]\n    : readonly ['text']\n\n// Reasoning\n//\n// Each model's `reasoning` field holds its data for `chat({ reasoning })`: the\n// levels it has, with the provider value for each, and whether it takes a\n// thinking token budget.\n\nconst MUSE_REASONING = {\n  [EMBER_1_0.name]: EMBER_1_0.reasoning,\n  [WONDER_1_0.name]: WONDER_1_0.reasoning,\n  [SPARK_1_3.name]: SPARK_1_3.reasoning,\n  [SPARK_1_3_CONTRIBUTOR.name]: SPARK_1_3_CONTRIBUTOR.reasoning,\n  [SPARK_1_2.name]: SPARK_1_2.reasoning,\n  [SPARK_1_2_CONTRIBUTOR.name]: SPARK_1_2_CONTRIBUTOR.reasoning,\n  [SPARK_1_1.name]: SPARK_1_1.reasoning,\n}\n\n/**\n * Each chat model's reasoning levels, and whether it takes a token budget, for\n * `chat({ reasoning })`. Derived from the `reasoning` field. A model that is\n * not here does not reason.\n */\nexport type MuseModelReasoningByName = {\n  [K in keyof typeof MUSE_REASONING]: ModelReasoningCapability<\n    (typeof MUSE_REASONING)[K]\n  >\n}\n\n/**\n * Runtime map from chat model name to its reasoning data, for the text\n * adapter. An unknown name gives `undefined`: the adapter sends no reasoning\n * field.\n */\nexport const MUSE_MODEL_REASONING: Readonly<Record<string, ModelReasoning>> =\n  MUSE_REASONING\n"],"mappings":"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"}

package/dist/esm/text/text-provider-options.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Muse-specific provider options for text/chat models.
+ *
+ * Muse exposes an OpenAI-compatible Chat Completions endpoint, so these are
+ * the standard Chat Completions parameters. They are the values a caller can
+ * pass through `chat({ modelOptions })`.
+ */
+export interface MuseTextProviderOptions {
+    /**
+     * Sampling temperature between 0 and 2. Higher values make the output more
+     * random; lower values make it more focused and deterministic.
+     */
+    temperature?: number | null;
+    /**
+     * Nucleus sampling. The model considers the tokens with `top_p` probability
+     * mass. 0.1 means only the tokens in the top 10% are considered.
+     */
+    top_p?: number | null;
+    /**
+     * The maximum number of tokens to generate in the chat completion. The total
+     * of input tokens and generated tokens is limited by the model's context
+     * window.
+     */
+    max_completion_tokens?: number | null;
+    /**
+     * Number between -2.0 and 2.0. Positive values penalize new tokens by their
+     * frequency so far, so the model is less likely to repeat the same line.
+     */
+    frequency_penalty?: number | null;
+    /**
+     * Number between -2.0 and 2.0. Positive values penalize new tokens that have
+     * already appeared, so the model is more likely to talk about new topics.
+     */
+    presence_penalty?: number | null;
+    /**
+     * If set, the system makes a best effort to sample deterministically, so
+     * repeated requests with the same `seed` and parameters return the same
+     * result.
+     */
+    seed?: number | null;
+    /**
+     * Up to 4 sequences where the API stops generating further tokens. The
+     * returned text does not contain the stop sequence.
+     */
+    stop?: string | null | Array<string>;
+    /** Whether to enable parallel function calling during tool use. */
+    parallel_tool_calls?: boolean | null;
+    /**
+     * A unique identifier for your end-user, which can help monitor and detect
+     * abuse.
+     */
+    user?: string | null;
+}
+/**
+ * External provider options (what users pass in).
+ */
+export type ExternalTextProviderOptions = MuseTextProviderOptions;

package/dist/esm/utils/client.d.ts

@@ -0,0 +1,28 @@
+import { createOpenAIClient } from '@tanstack/openai-base';
+/**
+ * The options `createOpenAIClient` accepts. Derived from the base factory so
+ * the config type matches the exact `openai` copy the base resolves, rather
+ * than a second copy pulled in by a direct `openai` dependency.
+ */
+type OpenAIClientOptions = Parameters<typeof createOpenAIClient>[0];
+export interface MuseClientConfig extends Omit<OpenAIClientOptions, 'apiKey'> {
+    apiKey: string;
+}
+/**
+ * Gets the Muse API key from environment variables.
+ *
+ * `MUSE_API_KEY` is the provider-scoped name, matching the repo's other
+ * adapters (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, …). Meta's own docs call
+ * the same key `MODEL_API_KEY`, so that name is accepted as a fallback.
+ *
+ * @throws Error if neither variable is found
+ */
+export declare function getMuseApiKeyFromEnv(): string;
+/**
+ * Returns a Muse client config with the Meta Model API base URL applied
+ * when not already set. Meta serves Muse through an OpenAI-compatible
+ * endpoint at api.meta.ai, so the adapter drives it with the OpenAI SDK
+ * pointed at this base URL.
+ */
+export declare function withMuseDefaults(config: MuseClientConfig): MuseClientConfig;
+export {};

package/dist/esm/utils/client.js

@@ -0,0 +1,38 @@
+import { getApiKeyFromEnv } from "@tanstack/ai-utils";
+//#region src/utils/client.ts
+/**
+* Gets the Muse API key from environment variables.
+*
+* `MUSE_API_KEY` is the provider-scoped name, matching the repo's other
+* adapters (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, …). Meta's own docs call
+* the same key `MODEL_API_KEY`, so that name is accepted as a fallback.
+*
+* @throws Error if neither variable is found
+*/
+function getMuseApiKeyFromEnv() {
+	try {
+		return getApiKeyFromEnv("MUSE_API_KEY");
+	} catch {
+		try {
+			return getApiKeyFromEnv("MODEL_API_KEY");
+		} catch {
+			throw new Error("MUSE_API_KEY is required. Please set it in your environment variables or use the factory function with an explicit API key.");
+		}
+	}
+}
+/**
+* Returns a Muse client config with the Meta Model API base URL applied
+* when not already set. Meta serves Muse through an OpenAI-compatible
+* endpoint at api.meta.ai, so the adapter drives it with the OpenAI SDK
+* pointed at this base URL.
+*/
+function withMuseDefaults(config) {
+	return {
+		...config,
+		baseURL: config.baseURL || "https://api.meta.ai/v1"
+	};
+}
+//#endregion
+export { getMuseApiKeyFromEnv, withMuseDefaults };
+
+//# sourceMappingURL=client.js.map

package/dist/esm/utils/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","names":[],"sources":["../../../src/utils/client.ts"],"sourcesContent":["import { getApiKeyFromEnv } from '@tanstack/ai-utils'\nimport type { createOpenAIClient } from '@tanstack/openai-base'\n\n/**\n * The options `createOpenAIClient` accepts. Derived from the base factory so\n * the config type matches the exact `openai` copy the base resolves, rather\n * than a second copy pulled in by a direct `openai` dependency.\n */\ntype OpenAIClientOptions = Parameters<typeof createOpenAIClient>[0]\n\nexport interface MuseClientConfig extends Omit<OpenAIClientOptions, 'apiKey'> {\n  apiKey: string\n}\n\n/**\n * Gets the Muse API key from environment variables.\n *\n * `MUSE_API_KEY` is the provider-scoped name, matching the repo's other\n * adapters (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, …). Meta's own docs call\n * the same key `MODEL_API_KEY`, so that name is accepted as a fallback.\n *\n * @throws Error if neither variable is found\n */\nexport function getMuseApiKeyFromEnv(): string {\n  try {\n    return getApiKeyFromEnv('MUSE_API_KEY')\n  } catch {\n    try {\n      return getApiKeyFromEnv('MODEL_API_KEY')\n    } catch {\n      throw new Error(\n        'MUSE_API_KEY is required. Please set it in your environment variables or use the factory function with an explicit API key.',\n      )\n    }\n  }\n}\n\n/**\n * Returns a Muse client config with the Meta Model API base URL applied\n * when not already set. Meta serves Muse through an OpenAI-compatible\n * endpoint at api.meta.ai, so the adapter drives it with the OpenAI SDK\n * pointed at this base URL.\n */\nexport function withMuseDefaults(config: MuseClientConfig): MuseClientConfig {\n  return {\n    ...config,\n    baseURL: config.baseURL || 'https://api.meta.ai/v1',\n  }\n}\n"],"mappings":";;;;;;;;;;;AAuBA,SAAgB,uBAA+B;CAC7C,IAAI;EACF,OAAO,iBAAiB,cAAc;CACxC,QAAQ;EACN,IAAI;GACF,OAAO,iBAAiB,eAAe;EACzC,QAAQ;GACN,MAAM,IAAI,MACR,6HACF;EACF;CACF;AACF;;;;;;;AAQA,SAAgB,iBAAiB,QAA4C;CAC3E,OAAO;EACL,GAAG;EACH,SAAS,OAAO,WAAW;CAC7B;AACF"}

package/package.json

@@ -1,6 +1,72 @@
 {
   "name": "@tanstack/ai-muse",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Muse adapter for TanStack AI chat, tool calling, and structured outputs.",
+  "author": "Tanner Linsley",
+  "license": "MIT",
+  "homepage": "https://tanstack.com/ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TanStack/ai.git",
+    "directory": "packages/ai-muse"
+  },
+  "bugs": {
+    "url": "https://github.com/TanStack/ai/issues"
+  },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/tannerlinsley"
+  },
+  "type": "module",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/esm/index.d.ts",
+      "import": "./dist/esm/index.js"
+    },
+    "./byok": {
+      "types": "./dist/esm/byok.d.ts",
+      "import": "./dist/esm/byok.js"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "src"
+  ],
+  "keywords": [
+    "ai",
+    "ai-sdk",
+    "typescript",
+    "tanstack",
+    "muse",
+    "adapter",
+    "llm",
+    "chat",
+    "tool-calling",
+    "structured-outputs"
+  ],
+  "devDependencies": {
+    "@vitest/coverage-v8": "4.1.10",
+    "vite": "^8.2.1"
+  },
+  "peerDependencies": {
+    "@tanstack/ai": "^1.4.0"
+  },
+  "dependencies": {
+    "@tanstack/ai-utils": "^1.1.0",
+    "@tanstack/openai-base": "^1.0.4"
+  },
+  "scripts": {
+    "build": "vite build",
+    "clean": "premove ./build ./dist",
+    "lint:fix": "oxlint src --type-aware --fix",
+    "test:build": "publint --strict",
+    "test:oxlint": "oxlint src --type-aware",
+    "test:coverage": "vitest run --coverage --coverage.include='src/**' --coverage.reporter=text-summary --coverage.reporter=json-summary",
+    "test:lib": "vitest run",
+    "test:lib:dev": "pnpm test:lib --watch",
+    "test:types": "tsc"
+  }
 }

package/src/adapters/text.ts

@@ -0,0 +1,113 @@
+import {
+  OpenAIBaseChatCompletionsTextAdapter,
+  createOpenAIClient,
+} from '@tanstack/openai-base'
+import {
+  MUSE_MODEL_INPUT_MODALITIES,
+  MUSE_MODEL_REASONING,
+} from '../model-meta'
+import { getMuseApiKeyFromEnv, withMuseDefaults } from '../utils/client'
+import type { Modality } from '@tanstack/ai'
+import type {
+  MUSE_CHAT_MODELS,
+  MuseChatModelToolCapabilitiesByName,
+  MuseModelReasoningByName,
+  ResolveInputModalities,
+  ResolveProviderOptions,
+} from '../model-meta'
+import type { MuseMessageMetadataByModality } from '../message-types'
+import type { MuseClientConfig } from '../utils/client'
+import type { OpenAIBaseTextAdapterOptions } from '@tanstack/openai-base'
+
+/** 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'
+
+/**
+ * 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 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>
+> {
+  override readonly kind = 'text' as const
+  override readonly name = 'muse' as const
+  override readonly inputModalities = MUSE_MODEL_INPUT_MODALITIES[this.model]
+
+  constructor(config: MuseTextConfig, model: TModel) {
+    super(model, 'muse', createOpenAIClient(withMuseDefaults(config)), config)
+  }
+
+  protected override modelReasoning(model: string) {
+    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_...');
+ * ```
+ */
+export function createMuseText<
+  TModel extends (typeof MUSE_CHAT_MODELS)[number],
+>(
+  model: TModel,
+  apiKey: string,
+  config?: Omit<MuseTextConfig, 'apiKey'>,
+): MuseTextAdapter<TModel> {
+  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');
+ * ```
+ */
+export function museText<TModel extends (typeof MUSE_CHAT_MODELS)[number]>(
+  model: TModel,
+  config?: Omit<MuseTextConfig, 'apiKey'>,
+): MuseTextAdapter<TModel> {
+  const apiKey = getMuseApiKeyFromEnv()
+  return createMuseText(model, apiKey, config)
+}

package/src/byok.ts

@@ -0,0 +1,7 @@
+import { defineByokProvider } from '@tanstack/ai/byok'
+
+export const museByok = defineByokProvider({
+  id: 'muse',
+  label: 'Muse',
+  env: 'MUSE_API_KEY',
+})

package/src/index.ts

@@ -0,0 +1,36 @@
+/**
+ * @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.
+ */
+
+// Text (Chat) adapter
+export {
+  MuseTextAdapter,
+  createMuseText,
+  museText,
+  type MuseTextConfig,
+  type MuseTextProviderOptions,
+} from './adapters/text'
+
+// Types
+export type {
+  MuseChatModels,
+  MuseChatModelProviderOptionsByName,
+  MuseChatModelToolCapabilitiesByName,
+  MuseModelInputModalitiesByName,
+  MuseModelReasoningByName,
+  ResolveProviderOptions,
+  ResolveInputModalities,
+} from './model-meta'
+export { MUSE_CHAT_MODELS } from './model-meta'
+export type {
+  MuseTextMetadata,
+  MuseImageMetadata,
+  MuseAudioMetadata,
+  MuseVideoMetadata,
+  MuseDocumentMetadata,
+  MuseMessageMetadataByModality,
+} from './message-types'

package/src/message-types.ts

@@ -0,0 +1,45 @@
+/**
+ * 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
+}