pi-multikey 1.2.0 → 1.3.0

package/README.md

@@ -46,6 +46,22 @@ Built-in presets decouple "model settings" from "keys". The data comes from b.ai
 
 > Why `null` must be explicit: pi's `getSupportedThinkingLevels` treats `mapped === null` as unsupported and hides that level, but **omitting** it is treated as supported and the level name is sent to the API verbatim; `xhigh` / `max` additionally require an explicit non-null value to be usable.
 
+### OpenCode Zen (free tier)
+
+Endpoint `https://opencode.ai/zen/v1`; keys from [opencode.ai/auth](https://opencode.ai/auth) → workspace Keys. Context / max-output are the **Zen free-tier serving limits** (consistent across models.dev `opencode` provider + pi's built-in opencode catalog); the raw models are bigger — MiMo V2.5 = 1M ctx, Hy3 = 262K ctx. `muse-spark-1.2-contributor-free` uses the OpenAI **Responses** API endpoint; the other six use chat completions.
+
+| Model | ctx / max-out | Modalities | Supported thinking levels |
+|---|---|---|---|
+| big-pickle | 200K / 32K | text | always-on (no thinkingLevelMap, like pi's catalog) |
+| mimo-v2.5-free | 200K / 32K | text+image | always-on (no thinkingLevelMap) |
+| hy3-free | 190K / 64K | text | low · medium · high (no off) |
+| ling-3.0-flash-fin-free | 256K / 32K | text | always-on (no thinkingLevelMap) |
+| nemotron-3-ultra-free | 1M / 128K | text | always-on (no thinkingLevelMap) |
+| nemotron-3.5-lightning-free | 256K / 256K | text | always-on (no thinkingLevelMap) |
+| muse-spark-1.2-contributor-free | 1M / 128K | text+image | minimal · low · medium · high · xhigh (no off, Responses API) |
+
+> All seven models are free (zero per-token cost) for a limited time while OpenCode collects feedback; data may be used to improve the models (Nemotron free endpoints are NVIDIA trials — don't send confidential data).
+
 To add a preset: append one entry to the `PRESETS` array in `presets.ts`.
 
 ## Configuration
@@ -74,7 +90,7 @@ To add a preset: append one entry to the `PRESETS` array in `presets.ts`.
 }
 ```
 
-To add nvidia / opencode etc. later: `/multikey` → `Add pool…` (Custom), or edit the JSON directly and `Reload config from disk`.
+To add nvidia / other providers later: `/multikey` → `Add pool…` (Custom), or edit the JSON directly and `Reload config from disk`.
 
 ### Adding a custom pool (no questions about API types)
 
@@ -100,6 +116,7 @@ The detected header style is stored as `"auth": "api-key"` only when the endpoin
 │  └─ Delete pool
 ├─ Add pool…
 │  ├─ Preset: B.AI           all model settings preloaded; paste keys (verified by a probe) and you're done
+│  ├─ Preset: OpenCode Zen   free-tier models preloaded (7 models); paste keys and you're done
 │  └─ Custom…                id + base URL + keys, then auto-probe, model multi-select, safe defaults
 └─ Reload config from disk
 ```

package/README.zh.md

@@ -49,6 +49,25 @@ DeepSeek / Tencent / 小米官方文档，并对每个 thinking 档位做过实
 > 视为不支持并隐藏该档，但**省略**会被当作支持并把档名原样发给 API；
 > `xhigh` / `max` 还要求显式给出非 null 值才可用。
 
+### OpenCode Zen（免费层）
+
+端点 `https://opencode.ai/zen/v1`；密钥从 [opencode.ai/auth](https://opencode.ai/auth) → workspace Keys 获取。
+上下文/最大输出为 **Zen 免费层限制**（models.dev `opencode` provider 与 pi 内置 opencode 目录一致）；
+原始模型更大——MiMo V2.5 = 1M ctx，Hy3 = 262K ctx。
+`muse-spark-1.2-contributor-free` 使用 OpenAI **Responses** API；其余六个使用 chat completions。
+
+| 模型 | ctx / max-out | 模态 | 生效 thinking 档位 |
+|---|---|---|---|
+| big-pickle | 200K / 32K | text | 始终思考（无 thinkingLevelMap，与 pi 内置目录一致） |
+| mimo-v2.5-free | 200K / 32K | text+image | 始终思考（无 thinkingLevelMap） |
+| hy3-free | 190K / 64K | text | low · medium · high（无 off） |
+| ling-3.0-flash-fin-free | 256K / 32K | text | 始终思考（无 thinkingLevelMap） |
+| nemotron-3-ultra-free | 1M / 128K | text | 始终思考（无 thinkingLevelMap） |
+| nemotron-3.5-lightning-free | 256K / 256K | text | 始终思考（无 thinkingLevelMap） |
+| muse-spark-1.2-contributor-free | 1M / 128K | text+image | minimal · low · medium · high · xhigh（无 off，Responses API） |
+
+> 以上七个模型在 OpenCode 收集反馈期间均免费（零 token 费用）；数据可能用于改进模型（Nemotron 免费端点为 NVIDIA 试用——请勿提交机密数据）。
+
 新增 preset：在 `presets.ts` 的 `PRESETS` 数组里加一项即可。
 
 ## 配置
@@ -79,7 +98,7 @@ DeepSeek / Tencent / 小米官方文档，并对每个 thinking 档位做过实
 }
 ```
 
-以后要加 nvidia / opencode 等：`/multikey` → `Add pool…`（Custom），或直接编辑
+以后要加 nvidia 等其他 provider：`/multikey` → `Add pool…`（Custom），或直接编辑
 JSON 后 `Reload config from disk`。
 
 ### 添加自定义池（不再询问 API 类型）
@@ -106,6 +125,7 @@ JSON 后 `Reload config from disk`。
 │  └─ Delete pool
 ├─ Add pool…
 │  ├─ Preset: B.AI           预置全部模型设定，粘贴 key（自动校验）即可用
+│  ├─ Preset: OpenCode Zen   免费层模型预置（7 个模型），粘贴 key 即可用
 │  └─ Custom…                只填 id + Base URL + key，随后自动探测、多选模型、安全默认值
 └─ Reload config from disk
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-multikey",
-	"version": "1.2.0",
+	"version": "1.3.0",
 	"description": "One pi provider backed by many API keys: automatic 429 rotation, per-request key leases for concurrent subagents, and a /multikey management TUI",
 	"keywords": [
 		"pi-package",

package/presets.ts

@@ -43,6 +43,14 @@ const BAI_COMPAT = {
 	supportsReasoningEffort: true,
 };
 
+// Shared compat for OpenCode Zen's openai-completions free models, mirroring pi's
+// built-in opencode catalog (dist/bundle/chunks/chunk-OMWWHBTG.js).
+const ZEN_CHAT_COMPAT = {
+	supportsStore: false,
+	supportsDeveloperRole: false,
+	maxTokensField: "max_tokens",
+};
+
 export const PRESETS: Preset[] = [
 	{
 		id: "b-ai",
@@ -120,6 +128,94 @@ export const PRESETS: Preset[] = [
 			},
 		],
 	},
+	{
+		id: "opencode-zen",
+		name: "OpenCode Zen",
+		description: "opencode.ai/zen free tier — Big Pickle, MiMo V2.5, Hy3, Ling 3.0 Fin, Nemotron 3 Ultra/Lightning, Muse Spark 1.2 (7 free models)",
+		defaultPoolId: "zen",
+		baseUrl: "https://opencode.ai/zen/v1",
+		api: "openai-completions",
+		keyHint: "https://opencode.ai/auth → sign in → workspace Keys page (one entry per key; multiple keys share the load)",
+		models: [
+			{
+				// models.dev `opencode` provider + pi built-in catalog. Stealth model;
+				// always-on reasoning with no effort control (no thinkingLevelMap, like pi's catalog).
+				id: "big-pickle",
+				name: "Big Pickle",
+				reasoning: true,
+				input: ["text"],
+				contextWindow: 200_000,
+				maxTokens: 32_000,
+				compat: ZEN_CHAT_COMPAT,
+			},
+			{
+				// Xiaomi MiMo V2.5 omni; raw model is 1M ctx but the Zen FREE tier serves 200K/32K.
+				id: "mimo-v2.5-free",
+				name: "MiMo V2.5 Free",
+				reasoning: true,
+				input: ["text", "image"],
+				contextWindow: 200_000,
+				maxTokens: 32_000,
+				compat: ZEN_CHAT_COMPAT,
+			},
+			{
+				// Tencent Hy3; raw model is 262K ctx but the Zen FREE tier serves 190K/64K.
+				// thinkingFormat defaults to reasoning_effort: levels map straight to Hy3's
+				// low/medium/high effort tiers; no off toggle on the free endpoint.
+				id: "hy3-free",
+				name: "Hy3 Free",
+				reasoning: true,
+				input: ["text"],
+				contextWindow: 190_000,
+				maxTokens: 64_000,
+				thinkingLevelMap: levels({ low: "low", medium: "medium", high: "high" }),
+				compat: ZEN_CHAT_COMPAT,
+			},
+			{
+				// Finance-tuned Ling 3.0 Flash; reasoning toggle only (no effort tiers).
+				id: "ling-3.0-flash-fin-free",
+				name: "Ling 3.0 Flash Fin Free",
+				reasoning: true,
+				input: ["text"],
+				contextWindow: 262_144,
+				maxTokens: 32_768,
+				compat: ZEN_CHAT_COMPAT,
+			},
+			{
+				// NVIDIA Nemotron 3 Ultra; largest open-weight reasoning model on the free tier.
+				id: "nemotron-3-ultra-free",
+				name: "Nemotron 3 Ultra Free",
+				reasoning: true,
+				input: ["text"],
+				contextWindow: 1_000_000,
+				maxTokens: 128_000,
+				compat: ZEN_CHAT_COMPAT,
+			},
+			{
+				// NVIDIA Nemotron 3.5 Lightning (MoE); fast agentic model, 262K output cap.
+				id: "nemotron-3.5-lightning-free",
+				name: "Nemotron 3.5 Lightning Free",
+				reasoning: true,
+				input: ["text"],
+				contextWindow: 262_144,
+				maxTokens: 262_144,
+				compat: ZEN_CHAT_COMPAT,
+			},
+			{
+				// Meta Muse Spark 1.2 Contributor Free — OpenAI Responses API endpoint (not chat
+				// completions), effort tiers minimal..xhigh, no off. compat mirrors pi's catalog.
+				id: "muse-spark-1.2-contributor-free",
+				name: "Muse Spark 1.2 Contributor Free",
+				api: "openai-responses",
+				reasoning: true,
+				input: ["text", "image"],
+				contextWindow: 1_048_576,
+				maxTokens: 131_072,
+				thinkingLevelMap: levels({ minimal: "minimal", low: "low", medium: "medium", high: "high", xhigh: "xhigh" }),
+				compat: { sessionAffinityFormat: "openai-nosession" },
+			},
+		],
+	},
 ];
 
 export function findPreset(id: string): Preset | undefined {