samrito-pi-preset 1.0.1 → 1.0.2

package/README.md

@@ -1,7 +1,7 @@
 # samrito-pi-preset
 
 A portable [pi](https://pi.dev) package that bundles this machine's extension
-collection (including the `pi-cliproxyapi-provider` provider) under a single
+collection (including the `@samrito/pi-cliproxyapi-provider` provider) under a single
 `pi install`-able package.
 
 Install it from npm in one command:
@@ -55,7 +55,7 @@ managed separately, or copy the directory to the target machine.
 | `@juicesharp/rpiv-todo` | ^2.9.0 | `index.ts` |
 | `@narumitw/pi-btw` | ^0.58.1 | `dist/index.ts` |
 | `pi-background-tasks` | ^2.5.0 | `extensions/*.ts` (2) |
-| `pi-cliproxyapi-provider` | ^0.15.30 | `extensions/index.ts` |
+| `@samrito/pi-cliproxyapi-provider` | ^0.16.0 | `extensions/index.ts` |
 | `pi-goal-x` | ^0.31.2 | `extensions/goal.ts` |
 | `pi-tool-display` | ^0.5.0 | `index.ts` |
 | `pi-zentui` | ^0.23.0 | `extensions/zentui/index.ts` |
@@ -427,12 +427,18 @@ node scripts/setup.mjs [--skip-install] [--force-config]
 - **Paths are relative to this package.** `pi.extensions` points into
   `node_modules/`, so the directory must stay where it was installed (or be
   re-installed). Moving it requires re-running `pi install`.
-- **No vendor-locked provider is bundled.** `pi-cliproxyapi-provider` is the
-  proxy provider this preset targets; the previously excluded vendor-scoped
-  alternative must not be re-introduced. CI enforces this with a grep over
-  tracked files (the term is assembled at runtime in the workflow so the guard
-  cannot match itself), and `scripts/pi-package-lib.mjs`'s `EXCLUDED_PACKAGES`
-  lists what is deliberately skipped.
+- **The provider is a fork.** `@samrito/pi-cliproxyapi-provider` is a fork of
+  the upstream `pi-cliproxyapi-provider`, adding thinking levels derived from
+  models.dev `reasoning_options`. It keeps the upstream settings namespace,
+  config paths, cache directory, and `/cliproxyapi` command, so it is a drop-in
+  replacement — but the two must not be installed together, since both register
+  the same provider and command and pi rejects the duplicate.
+- **No vendor-locked provider is bundled.** The vendor-scoped provider package
+  that was previously excluded from this bundle must not be re-introduced. CI
+  enforces this with a grep over tracked files (the term is assembled at runtime
+  in the workflow so the guard cannot match its own source), and
+  `scripts/pi-package-lib.mjs`'s `EXCLUDED_PACKAGES` lists what is deliberately
+  skipped — currently empty.
 - **Traditional token publishing should stay disabled.** npm's *Require
   two-factor authentication and disallow tokens* setting affects only traditional
   token auth: "Your trusted publishers will continue to work normally, as they

package/node_modules/{pi-cliproxyapi-provider → @samrito/pi-cliproxyapi-provider}/LICENSE

@@ -1,6 +1,13 @@
 MIT License
 
 Copyright (c) 2026 Richard Hao
+Copyright (c) 2026 samrito (modifications to this fork)
+
+This package is a fork of pi-cliproxyapi-provider
+(https://github.com/0xRichardH/pi-cliproxyapi-provider) by Richard Hao,
+distributed under the MIT License reproduced below. The original copyright
+notice is retained as the license requires; the modifications in this fork are
+copyright their respective author.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/node_modules/{pi-cliproxyapi-provider → @samrito/pi-cliproxyapi-provider}/README.md

@@ -1,25 +1,32 @@
-# pi-cliproxyapi-provider
+# @samrito/pi-cliproxyapi-provider
 
-`pi-cliproxyapi-provider` registers one [CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI) instance as a pi model provider. It discovers models from CLIProxyAPI's OpenAI-compatible `/v1/models` endpoint and enriches them with provider-specific metadata from [models.dev](https://models.dev/). Mixed catalogs use OpenAI Completions by default, while GPT-5.6 family models (including Codex variants) use the Responses API so pi can read their usage data. Canonical `/v1/models` owners such as `openai` select the matching provider metadata; aliases can override that selection when a proxy routes billing differently.
+> A fork of [pi-cliproxyapi-provider](https://github.com/0xRichardH/pi-cliproxyapi-provider)
+> by Richard Hao (MIT). This fork adds model thinking levels sourced from
+> models.dev. It is a drop-in replacement: the settings namespace, config paths,
+> cache directory, and `/cliproxyapi` command are unchanged, so existing
+> configuration keeps working. Do not install it alongside the original — both
+> register the same provider and command, and pi rejects the duplicate.
+
+`@samrito/pi-cliproxyapi-provider` registers one [CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI) instance as a pi model provider. It discovers models from CLIProxyAPI's OpenAI-compatible `/v1/models` endpoint and enriches them with provider-specific metadata from [models.dev](https://models.dev/). Mixed catalogs use OpenAI Completions by default, while GPT-5.6 family models (including Codex variants) use the Responses API so pi can read their usage data. Canonical `/v1/models` owners such as `openai` select the matching provider metadata; aliases can override that selection when a proxy routes billing differently.
 
 ## Install
 
 Install from npm:
 
 ```bash
-pi install npm:pi-cliproxyapi-provider
+pi install npm:@samrito/pi-cliproxyapi-provider
 ```
 
 Or install from GitHub:
 
 ```bash
-pi install git:github.com/0xRichardH/pi-cliproxyapi-provider@master
+pi install git:github.com/xiangsam/pi-cliproxyapi-provider@master
 ```
 
 You can omit `@master`, but pinning a branch, tag, or commit makes Git installs reproducible:
 
 ```bash
-pi install git:github.com/0xRichardH/pi-cliproxyapi-provider@a28f326
+pi install git:github.com/xiangsam/pi-cliproxyapi-provider@a28f326
 ```
 
 Restart pi after installing, then run:
@@ -96,6 +103,72 @@ The same setting can be placed in project `.pi/settings.json`; project settings
 
 Use `"full"` only when the selected CLIProxyAPI route and upstream account actually support that limit. Requests above `272000` input tokens also use the higher models.dev context-pricing tier where one is defined.
 
+### Thinking levels
+
+The provider derives each model's selectable thinking levels from the
+`reasoning_options` field in models.dev metadata. When a model publishes an
+effort list, exactly those levels appear in Pi's thinking selector:
+
+```text
+deepseek-flash   reasoning_options: [{"type":"effort","values":["low","high","max"]}]
+                 -> Pi offers off, low, high, max
+```
+
+Two details make this more than cosmetic:
+
+- **Absent levels are hidden, not defaulted.** models.dev publishes an
+exhaustive list, so every level it omits is explicitly marked unsupported. This
+matters because Pi otherwise offers levels up to `high` using the provider
+default, and a proxy that validates the level rejects the request. CLIProxyAPI
+does exactly that: an unsupported level comes back as
+`400 level "medium" not supported, valid levels: low, high, max`.
+- **`xhigh` and `max` only appear when the list names them.** Pi hides extended
+levels unless a model maps them explicitly, which is why `max` was previously
+unreachable for models that support it.
+
+Only `type: "effort"` publishes levels. `toggle` and `budget_tokens` describe
+other reasoning shapes and are ignored, so those models keep Pi's default. A
+built-in rule for the GPT-5.6 family remains as a fallback for models whose
+metadata carries no effort list; where models.dev publishes one, it wins, because
+it tracks the model's current capability and the rule does not.
+
+> **Levels describe the model, not your proxy.** models.dev publishes the
+> canonical capability, and a CLIProxyAPI route can accept a different set. A
+> mismatch that offers a level the proxy rejects makes Pi send a request that
+> fails with `400`. Correct it with the override below.
+
+#### Correcting a level list
+
+When a proxy serves a model differently from its published metadata, or when
+the models.dev match lands on a different provider, override the map in Pi's own
+`~/.pi/agent/models.json`:
+
+```json
+{
+  "providers": {
+    "cpa": {
+      "modelOverrides": {
+        "deepseek-flash": {
+          "thinkingLevelMap": {
+            "off": "none",
+            "minimal": null,
+            "low": "low",
+            "medium": null,
+            "high": "high",
+            "xhigh": null,
+            "max": "max"
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+This layer is applied by Pi after the provider registers its models, so it wins
+over both models.dev and the built-in rules. Use `null` to hide a level the
+proxy rejects. Replace `cpa` with your configured provider name.
+
 ### Model and display configuration
 
 Run `/cliproxyapi config` in Pi TUI mode to edit every package-level `settings.json` value. The tabbed panel has `Connection`, `Models`, and `Display` sections; it controls the GPT-5.6 context-window mode and whether the model selector shows the published strict tool-schema capability.

package/node_modules/{pi-cliproxyapi-provider → @samrito/pi-cliproxyapi-provider}/package.json

@@ -1,6 +1,6 @@
 {
-  "name": "pi-cliproxyapi-provider",
-  "version": "0.15.30",
+  "name": "@samrito/pi-cliproxyapi-provider",
+  "version": "0.16.0",
   "description": "Pi provider package for CLIProxyAPI with automatic model discovery and models.dev enrichment.",
   "type": "module",
   "license": "MIT",
@@ -15,12 +15,15 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/0xRichardH/pi-cliproxyapi-provider.git"
+    "url": "git+https://github.com/xiangsam/pi-cliproxyapi-provider.git"
   },
   "bugs": {
-    "url": "https://github.com/0xRichardH/pi-cliproxyapi-provider/issues"
+    "url": "https://github.com/xiangsam/pi-cliproxyapi-provider/issues"
+  },
+  "homepage": "https://github.com/xiangsam/pi-cliproxyapi-provider#readme",
+  "publishConfig": {
+    "access": "public"
   },
-  "homepage": "https://github.com/0xRichardH/pi-cliproxyapi-provider#readme",
   "files": [
     "src",
     "extensions",

package/node_modules/{pi-cliproxyapi-provider → @samrito/pi-cliproxyapi-provider}/src/model-capabilities.ts

@@ -15,9 +15,20 @@ interface ModelCapabilityRule {
   overrides: ModelCapabilityOverrides;
 }
 
+/**
+ * Fallback level map for the GPT-5.6 family, used only when models.dev publishes
+ * no effort list for the model.
+ *
+ * `minimal` is explicitly unsupported. Measured against a live CLIProxyAPI
+ * instance, gpt-5.6-sol, -terra, and -luna all answer
+ * `400 level "minimal" not supported, valid levels: low, medium, high, xhigh, max`,
+ * so offering it produces a failing request. models.dev omits `minimal` for the
+ * same models, which is why this rule is the fallback rather than the source of
+ * truth; it stays correct by hiding what the model does not accept.
+ */
 const GPT_5_6_THINKING_LEVEL_MAP: ThinkingLevelMap = {
   off: "none",
-  minimal: "minimal",
+  minimal: null,
   low: "low",
   medium: "medium",
   high: "high",

package/node_modules/{pi-cliproxyapi-provider → @samrito/pi-cliproxyapi-provider}/src/model-ui.ts

@@ -75,13 +75,33 @@ function detailItems(model: ProviderModelConfigLike, override: ProviderModelOver
   ];
 }
 
+/**
+ * Render the thinking levels pi will actually offer.
+ *
+ * Listing `Object.keys(thinkingLevelMap)` would be misleading: a key is present
+ * with value `null` precisely to mean "unsupported, hidden", so the keys alone
+ * include levels the user can never select. Show the mapped values instead and
+ * state the count of explicitly unsupported levels.
+ */
+function thinkingLevelSummary(map: ProviderModelConfigLike["thinkingLevelMap"]): string {
+  if (!map) return "none";
+
+  const offered = Object.entries(map)
+    .filter(([, value]) => typeof value === "string")
+    .map(([level]) => level);
+  const hidden = Object.values(map).filter((value) => value === null).length;
+  if (offered.length === 0) return "none";
+
+  return hidden > 0 ? `${offered.join(", ")} (${hidden} unsupported)` : offered.join(", ");
+}
+
 function details(model: ProviderModelConfigLike): string[] {
   return [
     `Name: ${model.name}`,
     `API: ${model.api ?? "openai-completions (provider default)"}`,
     `Input: ${model.input.join(", ")}`,
     `Cost: in ${model.cost.input}, out ${model.cost.output}, cache read ${model.cost.cacheRead}, cache write ${model.cost.cacheWrite}`,
-    `Thinking map: ${model.thinkingLevelMap ? Object.keys(model.thinkingLevelMap).join(", ") : "none"}`,
+    `Thinking map: ${thinkingLevelSummary(model.thinkingLevelMap)}`,
     `Other compat: ${formattedOtherCompat(model)}`,
   ];
 }

package/node_modules/{pi-cliproxyapi-provider → @samrito/pi-cliproxyapi-provider}/src/provider.ts

@@ -2,6 +2,7 @@ import type { CpaModel } from "./cpa.ts";
 import { findMetadataMatch, type MetadataMatchMethod } from "./matching.ts";
 import { getModelApiOverride, isGpt56Model, type ModelApiContext } from "./model-api.ts";
 import { getModelCapabilityOverrides } from "./model-capabilities.ts";
+import { thinkingLevelMapFromReasoningOptions } from "./reasoning-levels.ts";
 import type { Gpt56ContextWindowMode } from "./settings.ts";
 import type {
   InputModality,
@@ -83,14 +84,22 @@ function modelFromMetadata(
   const capabilityOverrides = getModelCapabilityOverrides(capabilityContext);
   const api = getModelApiOverride(capabilityContext);
 
+  // Precedence: models.dev wins when it publishes a level list, because that
+  // list tracks the model's current capability while the rules were written
+  // against an older catalog. Measured against a live CLIProxyAPI instance, the
+  // gpt-5.6 rule is now stale: it maps `minimal`, which the proxy rejects with
+  // `400 level "minimal" not supported`, whereas the models.dev list for the
+  // same model omits `minimal` and matches the proxy exactly. The rules still
+  // fill the gap when metadata is absent or carries no effort list.
+  const thinkingLevelMap =
+    thinkingLevelMapFromReasoningOptions(metadata.reasoning_options) ?? capabilityOverrides.thinkingLevelMap;
+
   return {
     id: cpaModel.id,
     name: metadata.name ?? cpaModel.id,
     reasoning: capabilityOverrides.reasoning ?? metadata.reasoning ?? PI_MODEL_DEFAULTS.reasoning,
     ...(api ? { api } : {}),
-    ...(capabilityOverrides.thinkingLevelMap
-      ? { thinkingLevelMap: capabilityOverrides.thinkingLevelMap }
-      : {}),
+    ...(thinkingLevelMap ? { thinkingLevelMap } : {}),
     input: inputFromMetadata(metadata),
     cost: costFromMetadata(metadata),
     contextWindow: contextWindowForModel(capabilityContext, metadata.limit?.context, gpt56ContextWindow),

package/node_modules/@samrito/pi-cliproxyapi-provider/src/reasoning-levels.ts

@@ -0,0 +1,59 @@
+import type { ThinkingLevelMap } from "@earendil-works/pi-ai";
+import type { ModelsDevReasoningOption } from "./types.ts";
+
+/** pi thinking levels in ascending depth, excluding `off`. */
+const PI_THINKING_LEVELS = ["minimal", "low", "medium", "high", "xhigh", "max"] as const;
+
+/** The models.dev effort value that means "thinking disabled". */
+const EFFORT_OFF = "none";
+
+/**
+ * Convert models.dev `reasoning_options` into a pi `ThinkingLevelMap`.
+ *
+ * models.dev publishes an exhaustive `type: "effort"` list for models whose
+ * reasoning depth is selectable, using the same vocabulary pi exposes (`none`
+ * plus `minimal`..`max`). The conversion is total in both directions:
+ *
+ *   - a level present in the list maps to itself, so pi sends that exact value
+ *   - a level absent from the list maps to `null`, which hides it in pi's UI
+ *   - pi's `off` maps to models.dev `none`, which the list may signal either as
+ *     an effort value or as a separate `toggle` entry
+ *
+ * Null-ing absent levels is the point of this function. Because the list is
+ * exhaustive, leaving a level `undefined` would let pi offer it using the
+ * provider default, and a proxy that validates the level rejects the request.
+ * CLIProxyAPI does exactly that: it answers an unsupported level with
+ * `400 level "medium" not supported, valid levels: low, high, max`.
+ *
+ * `off` needs both signals because models.dev splits the ability to disable
+ * thinking from the level list. A model can publish `["low","high","max"]`
+ * alongside `{type: "toggle"}`, meaning thinking is selectable only within those
+ * levels but can still be switched off; reading the effort list alone would hide
+ * `off` from a model that supports it. 296 catalog entries have this shape,
+ * including `deepseek/deepseek-flash`, which a live CLIProxyAPI instance accepts
+ * `reasoning_effort: "none"` for.
+ *
+ * Returns `undefined` when the model publishes no effort list, so callers keep
+ * their own default. A lone `toggle` or `budget_tokens` entry enumerates no
+ * levels and cannot be expressed as a level map, so it is ignored.
+ */
+export function thinkingLevelMapFromReasoningOptions(
+  options: ModelsDevReasoningOption[] | undefined,
+): ThinkingLevelMap | undefined {
+  const effort = options?.find(
+    (option) => option.type === "effort" && Array.isArray(option.values) && option.values.length > 0,
+  );
+  const values = effort?.values;
+  if (!values) return undefined;
+
+  const offered = new Set(values);
+  const canDisableThinking =
+    offered.has(EFFORT_OFF) || (options?.some((option) => option.type === "toggle") ?? false);
+  const map: ThinkingLevelMap = {
+    off: canDisableThinking ? EFFORT_OFF : null,
+  };
+  for (const level of PI_THINKING_LEVELS) {
+    map[level] = offered.has(level) ? level : null;
+  }
+  return map;
+}

package/node_modules/{pi-cliproxyapi-provider → @samrito/pi-cliproxyapi-provider}/src/types.ts

@@ -36,6 +36,12 @@ export interface ModelsDevMetadata {
   sourceProvider?: string;
   name?: string;
   reasoning?: boolean;
+  /**
+   * How the model exposes reasoning control. Only `type: "effort"` entries carry
+   * a level list that maps onto pi thinking levels; `toggle` and `budget_tokens`
+   * describe other shapes and are not converted.
+   */
+  reasoning_options?: ModelsDevReasoningOption[];
   modalities?: {
     input?: string[];
     output?: string[];
@@ -64,6 +70,22 @@ export interface ModelsDevMetadata {
 
 export type ModelsDevCatalog = Record<string, ModelsDevMetadata>;
 
+/**
+ * One entry of a models.dev `reasoning_options` array.
+ *
+ * `type` is kept as a plain string because models.dev adds shapes over time
+ * (currently `effort`, `toggle`, and `budget_tokens`) and unknown ones must be
+ * ignored rather than rejected.
+ */
+export interface ModelsDevReasoningOption {
+  type: string;
+  /** Levels for `type: "effort"`, drawn from the same vocabulary pi uses. */
+  values?: string[];
+  /** Token bounds for `type: "budget_tokens"`. */
+  min?: number;
+  max?: number;
+}
+
 export interface ProviderModelConfigLike {
   id: string;
   name: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "samrito-pi-preset",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "type": "module",
   "description": "Portable pi agent setup: bundles the extension collection and user config templates so another machine can be brought up with one install.",
   "keywords": [
@@ -33,9 +33,9 @@
       "node_modules/@juicesharp/rpiv-ask-user-question/index.ts",
       "node_modules/@juicesharp/rpiv-todo/index.ts",
       "node_modules/@narumitw/pi-btw/dist/index.ts",
+      "node_modules/@samrito/pi-cliproxyapi-provider/extensions/index.ts",
       "node_modules/pi-background-tasks/extensions/anthropic-attribution.ts",
       "node_modules/pi-background-tasks/extensions/background-tasks.ts",
-      "node_modules/pi-cliproxyapi-provider/extensions/index.ts",
       "node_modules/pi-goal-x/extensions/goal.ts",
       "node_modules/pi-tool-display/index.ts",
       "node_modules/pi-zentui/extensions/zentui/index.ts"
@@ -54,8 +54,8 @@
     "@juicesharp/rpiv-ask-user-question": "^2.9.0",
     "@juicesharp/rpiv-todo": "^2.9.0",
     "@narumitw/pi-btw": "^0.58.1",
+    "@samrito/pi-cliproxyapi-provider": "^0.16.0",
     "pi-background-tasks": "^2.5.0",
-    "pi-cliproxyapi-provider": "^0.15.30",
     "pi-goal-x": "^0.31.2",
     "pi-tool-display": "^0.5.0",
     "pi-zentui": "^0.23.0"
@@ -65,8 +65,8 @@
     "@juicesharp/rpiv-ask-user-question",
     "@juicesharp/rpiv-todo",
     "@narumitw/pi-btw",
+    "@samrito/pi-cliproxyapi-provider",
     "pi-background-tasks",
-    "pi-cliproxyapi-provider",
     "pi-goal-x",
     "pi-tool-display",
     "pi-zentui"