pi-meta-oauth 0.7.4 → 0.7.5

package/README.md

@@ -48,7 +48,7 @@ Prefer a static key instead? Set `META_API_KEY` (or `MODEL_API_KEY`) and skip
 
 ## Models
 
-Fallback models use a 1,048,576-token context window, up to 256K output tokens, image input, and reasoning levels `minimal`, `low`, `medium`, `high`, and `xhigh` (`muse-spark-1.3` additionally supports `max`; `muse-spark-1.3-contributor` does too when [opted in](#contributor-max-opt-in)). The catalog-discovered `muse-wonder-1.0` and `muse-wonder-full-1.0` also support `max`, as do their `-contributor` variants when opted in.
+Bundled models use a 1,048,576-token context window, up to 256K output tokens, image input, and reasoning levels `minimal`, `low`, `medium`, `high`, and `xhigh`. `muse-spark-1.3`, `muse-wonder-1.0`, and `muse-wonder-full-1.0` additionally support `max`; their `-contributor` variants do too when [opted in](#contributor-max-opt-in). Meta's catalog endpoint has returned bare model IDs without names, prices, or modalities since at least 2026-10-23, so these bundled definitions supply that metadata for known IDs; an unknown ID still appears with default values.
 
 | id | pricing (input/output/cached) $/M |
 | --- | --- |
@@ -57,6 +57,12 @@ Fallback models use a 1,048,576-token context window, up to 256K output tokens,
 | `muse-spark-1.2` | 1.25 / 4.25 / 0.15 |
 | `muse-spark-1.2-contributor` | 0.10 / 0.20 / 0.002 |
 | `muse-spark-1.1` | 1.25 / 4.25 / 0.15 |
+| `muse-wonder-1.0` | 4.00 / 20.00 / 0.20 |
+| `muse-wonder-1.0-contributor` | no published per-token rate (Muse Code subscription); Pi shows $0 |
+| `muse-wonder-full-1.0` | no published per-token rate (Muse Code subscription); Pi shows $0 |
+| `muse-wonder-full-1.0-contributor` | no published per-token rate (Muse Code subscription); Pi shows $0 |
+
+The catalog also lists Meta's non-chat models, which are billed per generated image, per hour of audio, or per video frame rather than per token: the `muse-image-*`, `muse-voice-*`, and `sam-*` families. The extension hides them from the chat model list, including entries an earlier release cached in `models-store.json`.
 
 > **Contributor-model privacy:** discounted contributor models allow Meta to use prompts and completions for product improvement, including training future Meta models. Use a standard model such as `muse-spark-1.3` if you do not want the contributor terms. See [Meta's model documentation](https://dev.meta.ai/docs/models).
 
@@ -135,10 +141,11 @@ also bypasses isolation and can run these probes when credentials are available.
 The cache probe makes two billable Responses requests plus one retry on a cache
 miss. The fingerprint probe makes two tiny Contributor-`max` requests; it sends
 the header directly, independently of `META_MUSE_USER_AGENT`. The catalog probe
-runs when `PI_META_LIVE_API_KEY` is set. Cache and fingerprint probes resolve
-credentials from `PI_META_LIVE_API_KEY`, `META_API_KEY`, `MODEL_API_KEY`, or an
-unexpired minted key in `~/.pi/agent/auth.json`, in that order. Probes skip when
-no usable credential exists.
+makes one catalog request and fails when a live model ID has neither a bundled
+definition nor a non-chat prefix. All three probes resolve credentials from
+`PI_META_LIVE_API_KEY`, `META_API_KEY`, `MODEL_API_KEY`, or an unexpired minted
+key in `~/.pi/agent/auth.json`, in that order, and skip when no usable
+credential exists.
 
 ```bash
 bun run test:live tests/meta-cache.test.ts

package/extensions/meta.ts

@@ -15,7 +15,11 @@ export {
 	MUSE_USER_AGENT_ENV_VAR,
 } from "../src/meta/constants.ts";
 export { refreshMetaModels } from "../src/meta/model-store.ts";
-export { metaFallbackCost, toProviderModels } from "../src/meta/models.ts";
+export {
+	isNonChatModelId,
+	metaFallbackCost,
+	toProviderModels,
+} from "../src/meta/models.ts";
 export { isMuseUserAgentEnabled } from "../src/meta/muse-policy.ts";
 export {
 	loginMeta,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-meta-oauth",
-  "version": "0.7.4",
+  "version": "0.7.5",
   "description": "Meta Model API OAuth provider for pi",
   "keywords": [
     "pi-package",

package/src/meta/models.ts

@@ -21,6 +21,24 @@ const CONTRIBUTOR_COST = {
 	cacheRead: 0.002,
 	cacheWrite: 0,
 };
+/** Meta Model API list price for muse-wonder-1.0 (dev.meta.ai pricing page, 2026-10-23). */
+const WONDER_COST = {
+	input: 4,
+	output: 20,
+	cacheRead: 0.2,
+	cacheWrite: 0,
+};
+/**
+ * Muse Wonder Full and the Wonder Contributor variants are reachable only
+ * through a Muse Code subscription; Meta publishes no per-token rate for
+ * them, so Pi shows $0. This is a representation of "unpriced", not a fact.
+ */
+const SUBSCRIPTION_ONLY_COST = {
+	input: 0,
+	output: 0,
+	cacheRead: 0,
+	cacheWrite: 0,
+};
 const UNKNOWN_MODEL_COST = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 };
 const THINKING_LEVELS = [
 	"minimal",
@@ -32,7 +50,13 @@ const THINKING_LEVELS = [
 ] as const;
 type ThinkingLevelMap = NonNullable<MetaProviderModel["thinkingLevelMap"]>;
 
-/** Data-only definitions; callers always receive fresh model objects. */
+/**
+ * Data-only definitions; callers always receive fresh model objects. The live
+ * catalog has carried no `metadata["muse-code"]` block since at least
+ * 2026-10-23, so names, prices, and image input for known IDs come from here.
+ * Spark first keeps the long-standing default model; after the first refresh
+ * the catalog's own order wins anyway.
+ */
 const FALLBACK_DEFINITIONS = [
 	{
 		id: "muse-spark-1.3",
@@ -64,8 +88,54 @@ const FALLBACK_DEFINITIONS = [
 		cost: STANDARD_COST,
 		max: false,
 	},
+	{
+		id: "muse-wonder-1.0",
+		name: "Muse Wonder 1.0",
+		cost: WONDER_COST,
+		max: true,
+	},
+	{
+		id: "muse-wonder-1.0-contributor",
+		name: "Muse Wonder 1.0 Contributor",
+		cost: SUBSCRIPTION_ONLY_COST,
+		max: false,
+	},
+	{
+		id: "muse-wonder-full-1.0",
+		name: "Muse Wonder Full 1.0",
+		cost: SUBSCRIPTION_ONLY_COST,
+		max: true,
+	},
+	{
+		id: "muse-wonder-full-1.0-contributor",
+		name: "Muse Wonder Full 1.0 Contributor",
+		cost: SUBSCRIPTION_ONLY_COST,
+		max: false,
+	},
 ] as const;
 
+/**
+ * Catalog families Meta bills per generated image, per hour of audio, or per
+ * video frame instead of per token (dev.meta.ai pricing page, 2026-10-23):
+ * Muse Image, Muse Voice Transcribe, and Segment Anything. They share the
+ * catalog with the chat models but are not chat models, so neither the live
+ * catalog nor a cached entry may list them as one. Prefixes, not exact IDs,
+ * so a new version of a family stays hidden without a code change.
+ */
+export const NON_CHAT_MODEL_ID_PREFIXES = [
+	"muse-image-",
+	"muse-voice-",
+	"sam-",
+] as const;
+
+export function isNonChatModelId(id: string): boolean {
+	return NON_CHAT_MODEL_ID_PREFIXES.some((prefix) => id.startsWith(prefix));
+}
+
+function isBundledModelId(id: string): boolean {
+	return FALLBACK_DEFINITIONS.some((model) => model.id === id);
+}
+
 function nonemptyString(value: unknown): string | undefined {
 	return typeof value === "string" && value.trim() ? value.trim() : undefined;
 }
@@ -166,7 +236,7 @@ export function toProviderModels(catalog: unknown): MetaProviderModel[] {
 	for (const value of data) {
 		const entry = asRecord(value);
 		const id = nonemptyString(entry?.id);
-		if (!id || seen.has(id)) continue;
+		if (!id || seen.has(id) || isNonChatModelId(id)) continue;
 		const metadata = asRecord(asRecord(entry?.metadata)?.["muse-code"]);
 		if (metadata?.is_hidden === true) continue;
 		const fallback = defaultModel(id);
@@ -308,7 +378,14 @@ function storedCost(
 	return cost;
 }
 
-/** Cache contents cross the same untrusted-data boundary as the remote catalog. */
+/**
+ * Cache contents cross the same untrusted-data boundary as the remote catalog.
+ * For bundled IDs the name, price, and input come from FALLBACK_DEFINITIONS:
+ * the bare catalog cannot have advertised them, so a cached copy is at best an
+ * older release's bundled value and at worst its unknown-model default (0.7.4
+ * persisted Wonder as a $0 text-only model). Cached limits, effort names,
+ * headers, and compat flags are kept; unknown IDs restore every cached field.
+ */
 export function restoreProviderModels(value: unknown): MetaProviderModel[] {
 	if (!Array.isArray(value)) return [];
 	const models: MetaProviderModel[] = [];
@@ -321,12 +398,16 @@ export function restoreProviderModels(value: unknown): MetaProviderModel[] {
 		)
 			continue;
 		const id = nonemptyString(entry.id);
-		if (!id || seen.has(id)) continue;
+		// A catalog persisted by an earlier release may hold non-chat IDs.
+		if (!id || seen.has(id) || isNonChatModelId(id)) continue;
 		const fallback = defaultModel(id);
+		const bundled = isBundledModelId(id);
 		models.push(
 			gateMuseMaxEffort({
 				...fallback,
-				name: nonemptyString(entry.name) ?? fallback.name,
+				name: bundled
+					? fallback.name
+					: (nonemptyString(entry.name) ?? fallback.name),
 				api: "openai-responses",
 				// The extension only persists the direct endpoint; a cached URL must never redirect the key.
 				baseUrl: META_API_BASE_URL,
@@ -338,8 +419,10 @@ export function restoreProviderModels(value: unknown): MetaProviderModel[] {
 					entry.thinkingLevelMap,
 					fallback.thinkingLevelMap ?? {},
 				),
-				input: modelInput(entry.input, fallback.input),
-				cost: storedCost(entry.cost, fallback.cost),
+				input: bundled
+					? fallback.input
+					: modelInput(entry.input, fallback.input),
+				cost: bundled ? fallback.cost : storedCost(entry.cost, fallback.cost),
 				contextWindow: positiveInteger(
 					entry.contextWindow,
 					fallback.contextWindow,

package/src/meta/muse-policy.ts

@@ -9,11 +9,10 @@ export const MUSE_USER_AGENT_MODEL_IDS: ReadonlySet<string> = new Set([
 ]);
 
 /**
- * Models known to accept literal max effort with any User-Agent. The Wonder
- * models have no bundled definition in models.ts, so max originates here;
- * muse-spark-1.3 has one, but is listed so the gate — which runs on every
- * model list — is the single authority and a stale cached `max: null`
- * cannot mask its fallback-declared support.
+ * Models known to accept literal max effort with any User-Agent. Each also
+ * has a bundled definition in models.ts that declares max, but they are
+ * listed here so the gate — which runs on every model list — is the single
+ * authority and a stale cached `max: null` cannot mask that support.
  */
 export const MAX_EFFORT_MODEL_IDS: ReadonlySet<string> = new Set([
 	"muse-spark-1.3",