pi-meta-oauth 0.7.3 → 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)).
+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).
 
@@ -75,7 +81,7 @@ Then open a **new** terminal and restart Pi. Shells that were already open don't
 
 The header is the same on every OS. The captured string names `linux-x86_64`, but the platform segment doesn't appear to be checked: it was accepted from Windows (2026-09-26), and oh-my-pi sends the same fixed string on every platform.
 
-With the flag set, the extension exposes `max` on `muse-spark-1.3-contributor` and sends the captured Muse `User-Agent` on that model's requests to `https://api.meta.ai/v1` only. Other models, proxies and custom `baseUrl`s, and any `User-Agent` you set yourself are left untouched. Without the flag, Contributor `max` is hidden and Pi's own `User-Agent` is sent.
+With the flag set, the extension exposes `max` on the gated contributor models (`muse-spark-1.3-contributor`, `muse-wonder-1.0-contributor`, and `muse-wonder-full-1.0-contributor`) and sends the captured Muse `User-Agent` on those models' requests to `https://api.meta.ai/v1` only. Other models, proxies and custom `baseUrl`s, and any `User-Agent` you set yourself are left untouched. Without the flag, Contributor `max` is hidden and Pi's own `User-Agent` is sent.
 
 > **Warning:** this makes Pi identify as Meta's first-party Muse client. It relies on undocumented server behavior, is not supported by Meta, may stop working without notice, and may conflict with Meta's terms. Enable it only if you accept that risk for your account.
 
@@ -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.3",
+  "version": "0.7.5",
   "description": "Meta Model API OAuth provider for pi",
   "keywords": [
     "pi-package",
@@ -32,13 +32,13 @@
     "image": "https://raw.githubusercontent.com/BlockedPath/pi-meta-oauth/main/preview.png"
   },
   "peerDependencies": {
-    "@earendil-works/pi-ai": ">=0.83.0 <0.88.0",
-    "@earendil-works/pi-coding-agent": ">=0.83.0 <0.88.0"
+    "@earendil-works/pi-ai": ">=0.83.0 <2.0.0",
+    "@earendil-works/pi-coding-agent": ">=0.83.0 <2.0.0"
   },
   "devDependencies": {
     "@biomejs/biome": "2.5.15",
-    "@earendil-works/pi-ai": "0.87.1",
-    "@earendil-works/pi-coding-agent": "0.87.1",
+    "@earendil-works/pi-ai": "1.4.0",
+    "@earendil-works/pi-coding-agent": "1.4.0",
     "bun-types": "latest",
     "typescript": "^5.9.0"
   },

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

@@ -4,6 +4,20 @@ import type { MetaEnv, MetaProviderModel } from "./types.ts";
 /** Models whose max effort requires the captured Muse client fingerprint. */
 export const MUSE_USER_AGENT_MODEL_IDS: ReadonlySet<string> = new Set([
 	"muse-spark-1.3-contributor",
+	"muse-wonder-1.0-contributor",
+	"muse-wonder-full-1.0-contributor",
+]);
+
+/**
+ * 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",
+	"muse-wonder-1.0",
+	"muse-wonder-full-1.0",
 ]);
 
 /** Recognize the documented, explicit Muse fingerprint opt-in values. */
@@ -15,18 +29,26 @@ export function isMuseUserAgentEnabled(env: MetaEnv = process.env): boolean {
 }
 
 /**
- * Gate the literal max effort on known fingerprint-dependent models. A future
- * server-advertised mapping to a different effort remains authoritative.
+ * Apply known literal-max support: always on MAX_EFFORT_MODEL_IDS, and on
+ * fingerprint-dependent models only when opted in. A future server-advertised
+ * mapping to a different effort remains authoritative. Runs on every model
+ * list (fallbacks, catalog, cached restore) so a stale cached `max: null`
+ * cannot mask known support.
  */
 export function gateMuseMaxEffort(
 	model: MetaProviderModel,
 	env: MetaEnv = process.env,
 ): MetaProviderModel {
 	const map = model.thinkingLevelMap;
-	if (!map || !MUSE_USER_AGENT_MODEL_IDS.has(model.id)) return model;
+	if (!map) return model;
 	if (map.max != null && map.max !== "max") return model;
 
-	const max = isMuseUserAgentEnabled(env) ? "max" : null;
+	let max: string | null;
+	if (MAX_EFFORT_MODEL_IDS.has(model.id)) max = "max";
+	else if (MUSE_USER_AGENT_MODEL_IDS.has(model.id))
+		max = isMuseUserAgentEnabled(env) ? "max" : null;
+	else return model;
+
 	if (map.max === max) return model;
 	return { ...model, thinkingLevelMap: { ...map, max } };
 }

package/src/meta/types.ts

@@ -1,6 +1,14 @@
 import type { ProviderConfig } from "@earendil-works/pi-coding-agent";
 
-type ProviderModel = NonNullable<ProviderConfig["models"]>[number];
+/**
+ * Pi 0.99+ registers chat, image, and classifier model configs as a union; Omit
+ * over that union keeps only their shared keys. Narrow to the chat member, which
+ * is the whole element type on older Pi versions.
+ */
+type ProviderModel = Extract<
+	NonNullable<ProviderConfig["models"]>[number],
+	{ reasoning: boolean }
+>;
 
 /** Responses hints spanning the supported Pi versions, including newer flags. */
 export interface MetaResponsesCompat {