@aliou/pi-synthetic 0.13.5 → 0.14.0

package/README.md

@@ -2,7 +2,7 @@
 
 # Pi Synthetic Extension
 
-A Pi extension that adds [Synthetic](https://synthetic.new) as a model provider, giving you access to open-source models through an OpenAI-compatible API.
+A Pi extension that adds [Synthetic](https://synthetic.new) as a model provider, giving you access to open-source models through Synthetic's OpenAI-compatible API.
 
 ## Installation
 
@@ -52,6 +52,12 @@ Once installed, select `synthetic` as your provider and choose from available mo
 /model synthetic hf:moonshotai/Kimi-K2.5
 ```
 
+### Model Hosting
+
+All models are accessed through Synthetic's API. Some models are hosted by Synthetic directly; others are proxied by Synthetic to upstream backends such as Fireworks or Together.
+
+The code tracks this in `src/extensions/provider/models.ts` with each model's `provider` field. That field is for maintenance only and is stripped before registering models with Pi, so users always select the `synthetic` provider.
+
 ### Web Search Tool
 
 The extension registers `synthetic_web_search` — a zero-data-retention web search tool. The tool is always visible; it fails with a clear message if credentials are missing or the account lacks a subscription.
@@ -89,21 +95,22 @@ The extension automatically notifies you when you approach or exceed your Synthe
 
 ## Disabling Features
 
-Each feature (provider, web search, quotas command, usage status, quota warnings) is a separate Pi extension. You can disable individual features using `pi config`:
+Each feature (provider, web search, quotas command, sub bar integration, usage status, quota warnings) is a separate Pi extension. You can disable individual features using `pi config`:
 
 ```
 pi config extensions.disabled add @aliou/pi-synthetic/quota-warnings
 ```
 
-This prevents the quota-warnings extension from loading while keeping the rest of pi-synthetic active. Replace `quota-warnings` with `web-search`, `command-quotas`, or `provider` to disable other features.
+This prevents the quota-warnings extension from loading while keeping the rest of pi-synthetic active. Replace `quota-warnings` with `web-search`, `command-quotas`, `sub-bar-integration`, `usage-status`, or `provider` to disable other features.
 
 ## Adding or Updating Models
 
-Models are hardcoded in `src/providers/models.ts`. To add or update models:
+Models are hardcoded in `src/extensions/provider/models.ts`. To add or update models:
 
-1. Edit `src/providers/models.ts`
+1. Edit `src/extensions/provider/models.ts`
 2. Add the model configuration following the `SyntheticModelConfig` interface
-3. Run `pnpm run typecheck` to verify
+3. Set `provider` to the upstream backend Synthetic uses for that model, such as `synthetic`, `fireworks`, or `together`
+4. Run `pnpm run typecheck` to verify
 
 ## Development
 
@@ -156,7 +163,7 @@ This repository uses [Changesets](https://github.com/changesets/changesets) for
 
 ## Requirements
 
-- Pi coding agent v0.50.0+
+- Pi coding agent v0.72.0+
 - Synthetic API key (configured in `~/.pi/agent/auth.json` or via `SYNTHETIC_API_KEY`)
 
 ## Links

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aliou/pi-synthetic",
-  "version": "0.13.5",
+  "version": "0.14.0",
   "license": "MIT",
   "type": "module",
   "private": false,
@@ -32,8 +32,8 @@
     "README.md"
   ],
   "peerDependencies": {
-    "@mariozechner/pi-coding-agent": "0.61.0",
-    "@mariozechner/pi-tui": "0.61.0"
+    "@mariozechner/pi-coding-agent": "0.72.0",
+    "@mariozechner/pi-tui": "0.72.0"
   },
   "dependencies": {
     "@aliou/pi-utils-settings": "^0.13.0",
@@ -43,8 +43,8 @@
     "@aliou/biome-plugins": "^0.7.0",
     "@biomejs/biome": "^2.4.2",
     "@changesets/cli": "^2.27.11",
-    "@mariozechner/pi-coding-agent": "0.61.0",
-    "@sinclair/typebox": "^0.34.48",
+    "@mariozechner/pi-coding-agent": "0.72.0",
+    "typebox": "^1.1.37",
     "@types/node": "^25.0.10",
     "husky": "^9.1.7",
     "typescript": "^5.9.3",

package/src/extensions/provider/models.ts

@@ -9,14 +9,6 @@ export interface SyntheticModelConfig extends ProviderModelConfig {
   provider: string;
 }
 
-const SYNTHETIC_REASONING_EFFORT_MAP = {
-  minimal: "low",
-  low: "low",
-  medium: "medium",
-  high: "high",
-  xhigh: "high",
-} as const;
-
 export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
   // API: hf:zai-org/GLM-4.7 → ctx=202752
   {
@@ -24,9 +16,9 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
     name: "zai-org/GLM-4.7",
     provider: "synthetic",
     reasoning: true,
+    thinkingLevelMap: { minimal: null, xhigh: null },
     compat: {
       supportsReasoningEffort: true,
-      reasoningEffortMap: SYNTHETIC_REASONING_EFFORT_MAP,
     },
     input: ["text"],
     cost: {
@@ -44,9 +36,9 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
     name: "zai-org/GLM-5",
     provider: "synthetic",
     reasoning: true,
+    thinkingLevelMap: { minimal: null, xhigh: null },
     compat: {
       supportsReasoningEffort: true,
-      reasoningEffortMap: SYNTHETIC_REASONING_EFFORT_MAP,
     },
     input: ["text"],
     cost: {
@@ -64,9 +56,9 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
     name: "zai-org/GLM-5.1",
     provider: "synthetic",
     reasoning: true,
+    thinkingLevelMap: { minimal: null, xhigh: null },
     compat: {
       supportsReasoningEffort: true,
-      reasoningEffortMap: SYNTHETIC_REASONING_EFFORT_MAP,
       supportsDeveloperRole: false,
     },
     input: ["text"],
@@ -85,9 +77,9 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
     name: "zai-org/GLM-4.7-Flash",
     provider: "synthetic",
     reasoning: true,
+    thinkingLevelMap: { minimal: null, xhigh: null },
     compat: {
       supportsReasoningEffort: true,
-      reasoningEffortMap: SYNTHETIC_REASONING_EFFORT_MAP,
     },
     input: ["text"],
     cost: {
@@ -104,7 +96,7 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
     id: "hf:meta-llama/Llama-3.3-70B-Instruct",
     name: "meta-llama/Llama-3.3-70B-Instruct",
     provider: "together",
-    reasoning: true,
+    reasoning: false,
     input: ["text"],
     cost: {
       input: 0.88,
@@ -121,10 +113,6 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
     name: "deepseek-ai/DeepSeek-R1-0528",
     provider: "together",
     reasoning: true,
-    compat: {
-      supportsReasoningEffort: true,
-      reasoningEffortMap: SYNTHETIC_REASONING_EFFORT_MAP,
-    },
     input: ["text"],
     cost: {
       input: 3,
@@ -173,10 +161,6 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
     name: "Qwen/Qwen3-Coder-480B-A35B-Instruct",
     provider: "together",
     reasoning: true,
-    compat: {
-      supportsReasoningEffort: true,
-      reasoningEffortMap: SYNTHETIC_REASONING_EFFORT_MAP,
-    },
     input: ["text"],
     cost: {
       input: 2,
@@ -193,9 +177,9 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
     name: "moonshotai/Kimi-K2.6",
     provider: "synthetic",
     reasoning: true,
+    thinkingLevelMap: { minimal: null, low: null, xhigh: null },
     compat: {
       supportsReasoningEffort: true,
-      reasoningEffortMap: SYNTHETIC_REASONING_EFFORT_MAP,
     },
     input: ["text", "image"],
     cost: {
@@ -207,16 +191,28 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
     contextWindow: 262144,
     maxTokens: 65536,
   },
+  // API: hf:moonshotai/Kimi-K2.5 → ctx=262144, out=65536
+  {
+    id: "hf:moonshotai/Kimi-K2.5",
+    name: "moonshotai/Kimi-K2.5",
+    provider: "together",
+    reasoning: true,
+    input: ["text", "image"],
+    cost: {
+      input: 0.5,
+      output: 2.8,
+      cacheRead: 0.5,
+      cacheWrite: 0,
+    },
+    contextWindow: 262144,
+    maxTokens: 65536,
+  },
   // API: hf:nvidia/Kimi-K2.5-NVFP4 → ctx=262144; models.dev: out=65536 (NVFP4 quantized)
   {
     id: "hf:nvidia/Kimi-K2.5-NVFP4",
     name: "nvidia/Kimi-K2.5-NVFP4",
     provider: "together",
     reasoning: true,
-    compat: {
-      supportsReasoningEffort: true,
-      reasoningEffortMap: SYNTHETIC_REASONING_EFFORT_MAP,
-    },
     input: ["text", "image"],
     cost: {
       input: 0.5,
@@ -249,10 +245,6 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
     name: "Qwen/Qwen3-235B-A22B-Thinking-2507",
     provider: "together",
     reasoning: true,
-    compat: {
-      supportsReasoningEffort: true,
-      reasoningEffortMap: SYNTHETIC_REASONING_EFFORT_MAP,
-    },
     input: ["text"],
     cost: {
       input: 0.65,
@@ -269,10 +261,6 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
     name: "Qwen/Qwen3.5-397B-A17B",
     provider: "together",
     reasoning: true,
-    compat: {
-      supportsReasoningEffort: true,
-      reasoningEffortMap: SYNTHETIC_REASONING_EFFORT_MAP,
-    },
     input: ["text", "image"],
     cost: {
       input: 0.6,
@@ -289,6 +277,7 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
     name: "MiniMaxAI/MiniMax-M2.5",
     provider: "synthetic",
     reasoning: true,
+    thinkingLevelMap: { off: null, minimal: null, low: null, xhigh: null },
     input: ["text"],
     cost: {
       input: 0.4,
@@ -300,7 +289,6 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
     maxTokens: 65536,
     compat: {
       supportsReasoningEffort: true,
-      reasoningEffortMap: SYNTHETIC_REASONING_EFFORT_MAP,
       maxTokensField: "max_completion_tokens",
     },
   },
@@ -310,9 +298,9 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
     name: "nvidia/NVIDIA-Nemotron-3-Super-120B-A12B-NVFP4",
     provider: "synthetic",
     reasoning: true,
+    thinkingLevelMap: { minimal: null, low: null, xhigh: null },
     compat: {
       supportsReasoningEffort: true,
-      reasoningEffortMap: SYNTHETIC_REASONING_EFFORT_MAP,
     },
     input: ["text"],
     cost: {

package/src/extensions/usage-status/index.ts

@@ -210,13 +210,20 @@ export default async function (pi: ExtensionAPI) {
     void refresher.refreshFor(ctx);
   });
 
-  pi.on("session_switch", (_event, ctx) => {
-    currentContext = ctx;
-    currentProvider = ctx.model?.provider;
-    if (enabled && ctx.model?.provider === "synthetic") {
-      void refresher.refreshFor(ctx);
-    } else {
-      refresher.stopAutoRefresh(ctx);
+  pi.on("session_start", (event, ctx) => {
+    // Handle session switches (model_select handles mid-session provider changes)
+    if (
+      event.reason === "new" ||
+      event.reason === "resume" ||
+      event.reason === "fork"
+    ) {
+      currentContext = ctx;
+      currentProvider = ctx.model?.provider;
+      if (enabled && ctx.model?.provider === "synthetic") {
+        void refresher.refreshFor(ctx);
+      } else {
+        refresher.stopAutoRefresh(ctx);
+      }
     }
   });
 

package/src/extensions/web-search/tool.ts

@@ -8,7 +8,7 @@ import type {
 } from "@mariozechner/pi-coding-agent";
 import { getMarkdownTheme, keyHint } from "@mariozechner/pi-coding-agent";
 import { Container, Markdown, Text } from "@mariozechner/pi-tui";
-import { type Static, Type } from "@sinclair/typebox";
+import { type Static, Type } from "typebox";
 import { configLoader } from "../../config";
 import { getSyntheticApiKey } from "../../lib/env";