@aliou/pi-synthetic 0.1.0 → 0.3.0

package/AGENTS.md

@@ -33,7 +33,7 @@ src/
 ## Conventions
 
 - API key comes from environment (`SYNTHETIC_API_KEY`)
-- Uses Anthropic-compatible API at `https://api.synthetic.new/anthropic`
+- Uses OpenAI-compatible API at `https://api.synthetic.new/openai/v1`
 - Models are hardcoded in `src/providers/models.ts`
 - Update model list when Synthetic adds new models
 

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @aliou/pi-synthetic
 
+## 0.3.0
+
+### Minor Changes
+
+- 5f67daf: Switch from Anthropic to OpenAI API endpoints
+
+  - Change API endpoint from `/anthropic` to `/openai/v1`
+  - Update from `anthropic-messages` to `openai-completions` API
+  - Add compatibility flags for proper role handling (`supportsDeveloperRole: false`)
+  - Use standard `max_tokens` field instead of `max_completion_tokens`
+
+## 0.2.0
+
+### Minor Changes
+
+- 58d21ca: Fix model configurations from Synthetic API
+
+  - Update maxTokens for all Synthetic models using values from models.dev (synthetic provider)
+  - Fix Kimi-K2-Instruct-0905 reasoning flag to false
+
 ## 0.1.0
 
 ### Minor Changes

package/README.md

@@ -1,6 +1,6 @@
 # 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 Anthropic-compatible API.
+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.
 
 ## Installation
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aliou/pi-synthetic",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/aliou/pi-synthetic"

package/src/providers/index.ts

@@ -3,9 +3,9 @@ import { SYNTHETIC_MODELS } from "./models.js";
 
 export function registerSyntheticProvider(pi: ExtensionAPI): void {
   pi.registerProvider("synthetic", {
-    baseUrl: "https://api.synthetic.new/anthropic",
+    baseUrl: "https://api.synthetic.new/openai/v1",
     apiKey: "SYNTHETIC_API_KEY",
-    api: "anthropic-messages",
+    api: "openai-completions",
     models: SYNTHETIC_MODELS.map((model) => ({
       id: model.id,
       name: model.name,
@@ -14,6 +14,10 @@ export function registerSyntheticProvider(pi: ExtensionAPI): void {
       cost: model.cost,
       contextWindow: model.contextWindow,
       maxTokens: model.maxTokens,
+      compat: {
+        supportsDeveloperRole: false,
+        maxTokensField: "max_tokens",
+      },
     })),
   });
 }

package/src/providers/models.ts

@@ -1,5 +1,6 @@
 // Hardcoded models from Synthetic API
 // Source: https://api.synthetic.new/openai/v1/models
+// maxTokens sourced from https://models.dev/api.json (synthetic provider)
 
 export interface SyntheticModelConfig {
   id: string;
@@ -14,9 +15,17 @@ export interface SyntheticModelConfig {
   };
   contextWindow: number;
   maxTokens: number;
+  compat?: {
+    supportsDeveloperRole?: boolean;
+    supportsReasoningEffort?: boolean;
+    maxTokensField?: "max_completion_tokens" | "max_tokens";
+    requiresToolResultName?: boolean;
+    requiresMistralToolIds?: boolean;
+  };
 }
 
 export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
+  // models.dev: synthetic/hf:zai-org/GLM-4.7 → ctx=200000, out=64000
   {
     id: "hf:zai-org/GLM-4.7",
     name: "zai-org/GLM-4.7",
@@ -29,8 +38,9 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
       cacheWrite: 0,
     },
     contextWindow: 202752,
-    maxTokens: 65536,
+    maxTokens: 64000,
   },
+  // models.dev: synthetic/hf:MiniMaxAI/MiniMax-M2.1 → ctx=204800, out=131072
   {
     id: "hf:MiniMaxAI/MiniMax-M2.1",
     name: "MiniMaxAI/MiniMax-M2.1",
@@ -43,8 +53,9 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
       cacheWrite: 0,
     },
     contextWindow: 196608,
-    maxTokens: 65536,
+    maxTokens: 131072,
   },
+  // models.dev: synthetic/hf:meta-llama/Llama-3.3-70B-Instruct → ctx=128000, out=32768
   {
     id: "hf:meta-llama/Llama-3.3-70B-Instruct",
     name: "meta-llama/Llama-3.3-70B-Instruct",
@@ -57,8 +68,9 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
       cacheWrite: 0,
     },
     contextWindow: 131072,
-    maxTokens: 4096,
+    maxTokens: 32768,
   },
+  // models.dev: synthetic/hf:deepseek-ai/DeepSeek-V3-0324 → ctx=128000, out=128000
   {
     id: "hf:deepseek-ai/DeepSeek-V3-0324",
     name: "deepseek-ai/DeepSeek-V3-0324",
@@ -71,8 +83,9 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
       cacheWrite: 0,
     },
     contextWindow: 131072,
-    maxTokens: 4096,
+    maxTokens: 128000,
   },
+  // models.dev: synthetic/hf:deepseek-ai/DeepSeek-R1-0528 → ctx=128000, out=128000
   {
     id: "hf:deepseek-ai/DeepSeek-R1-0528",
     name: "deepseek-ai/DeepSeek-R1-0528",
@@ -85,8 +98,9 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
       cacheWrite: 0,
     },
     contextWindow: 131072,
-    maxTokens: 4096,
+    maxTokens: 128000,
   },
+  // models.dev: synthetic/hf:deepseek-ai/DeepSeek-V3.1 → ctx=128000, out=128000
   {
     id: "hf:deepseek-ai/DeepSeek-V3.1",
     name: "deepseek-ai/DeepSeek-V3.1",
@@ -99,8 +113,9 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
       cacheWrite: 0,
     },
     contextWindow: 131072,
-    maxTokens: 4096,
+    maxTokens: 128000,
   },
+  // models.dev: synthetic/hf:deepseek-ai/DeepSeek-V3.1-Terminus → ctx=128000, out=128000
   {
     id: "hf:deepseek-ai/DeepSeek-V3.1-Terminus",
     name: "deepseek-ai/DeepSeek-V3.1-Terminus",
@@ -113,8 +128,9 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
       cacheWrite: 0,
     },
     contextWindow: 131072,
-    maxTokens: 4096,
+    maxTokens: 128000,
   },
+  // models.dev: synthetic/hf:deepseek-ai/DeepSeek-V3.2 → ctx=162816, out=8000
   {
     id: "hf:deepseek-ai/DeepSeek-V3.2",
     name: "deepseek-ai/DeepSeek-V3.2",
@@ -127,8 +143,9 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
       cacheWrite: 0,
     },
     contextWindow: 162816,
-    maxTokens: 4096,
+    maxTokens: 8000,
   },
+  // NOTE: not present in models.dev synthetic provider; maxTokens unchanged
   {
     id: "hf:Qwen/Qwen3-VL-235B-A22B-Instruct",
     name: "Qwen/Qwen3-VL-235B-A22B-Instruct",
@@ -143,10 +160,11 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
     contextWindow: 256000,
     maxTokens: 4096,
   },
+  // models.dev: synthetic/hf:moonshotai/Kimi-K2-Instruct-0905 → ctx=262144, out=32768
   {
     id: "hf:moonshotai/Kimi-K2-Instruct-0905",
     name: "moonshotai/Kimi-K2-Instruct-0905",
-    reasoning: true,
+    reasoning: false,
     input: ["text"],
     cost: {
       input: 1.2,
@@ -155,8 +173,9 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
       cacheWrite: 0,
     },
     contextWindow: 262144,
-    maxTokens: 4096,
+    maxTokens: 32768,
   },
+  // models.dev: synthetic/hf:moonshotai/Kimi-K2-Thinking → ctx=262144, out=262144
   {
     id: "hf:moonshotai/Kimi-K2-Thinking",
     name: "moonshotai/Kimi-K2-Thinking",
@@ -169,8 +188,9 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
       cacheWrite: 0,
     },
     contextWindow: 262144,
-    maxTokens: 4096,
+    maxTokens: 262144,
   },
+  // models.dev: synthetic/hf:openai/gpt-oss-120b → ctx=128000, out=32768
   {
     id: "hf:openai/gpt-oss-120b",
     name: "openai/gpt-oss-120b",
@@ -183,8 +203,9 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
       cacheWrite: 0,
     },
     contextWindow: 131072,
-    maxTokens: 4096,
+    maxTokens: 32768,
   },
+  // models.dev: synthetic/hf:Qwen/Qwen3-Coder-480B-A35B-Instruct → ctx=256000, out=32000
   {
     id: "hf:Qwen/Qwen3-Coder-480B-A35B-Instruct",
     name: "Qwen/Qwen3-Coder-480B-A35B-Instruct",
@@ -197,8 +218,9 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
       cacheWrite: 0,
     },
     contextWindow: 262144,
-    maxTokens: 4096,
+    maxTokens: 32000,
   },
+  // models.dev: synthetic/hf:Qwen/Qwen3-235B-A22B-Instruct-2507 → ctx=256000, out=32000
   {
     id: "hf:Qwen/Qwen3-235B-A22B-Instruct-2507",
     name: "Qwen/Qwen3-235B-A22B-Instruct-2507",
@@ -211,8 +233,9 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
       cacheWrite: 0,
     },
     contextWindow: 262144,
-    maxTokens: 4096,
+    maxTokens: 32000,
   },
+  // models.dev: synthetic/hf:zai-org/GLM-4.6 → ctx=200000, out=64000
   {
     id: "hf:zai-org/GLM-4.6",
     name: "zai-org/GLM-4.6",
@@ -225,8 +248,9 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
       cacheWrite: 0,
     },
     contextWindow: 202752,
-    maxTokens: 4096,
+    maxTokens: 64000,
   },
+  // models.dev: synthetic/hf:MiniMaxAI/MiniMax-M2 → ctx=196608, out=131000
   {
     id: "hf:MiniMaxAI/MiniMax-M2",
     name: "MiniMaxAI/MiniMax-M2",
@@ -239,8 +263,9 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
       cacheWrite: 0,
     },
     contextWindow: 196608,
-    maxTokens: 4096,
+    maxTokens: 131000,
   },
+  // models.dev: synthetic/hf:moonshotai/Kimi-K2.5 → ctx=262144, out=65536
   {
     id: "hf:moonshotai/Kimi-K2.5",
     name: "moonshotai/Kimi-K2.5",
@@ -253,8 +278,9 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
       cacheWrite: 0,
     },
     contextWindow: 262144,
-    maxTokens: 4096,
+    maxTokens: 65536,
   },
+  // models.dev: synthetic/hf:deepseek-ai/DeepSeek-V3 → ctx=128000, out=128000
   {
     id: "hf:deepseek-ai/DeepSeek-V3",
     name: "deepseek-ai/DeepSeek-V3",
@@ -267,8 +293,9 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
       cacheWrite: 0,
     },
     contextWindow: 131072,
-    maxTokens: 4096,
+    maxTokens: 128000,
   },
+  // models.dev: synthetic/hf:Qwen/Qwen3-235B-A22B-Thinking-2507 → ctx=256000, out=32000
   {
     id: "hf:Qwen/Qwen3-235B-A22B-Thinking-2507",
     name: "Qwen/Qwen3-235B-A22B-Thinking-2507",
@@ -281,6 +308,6 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
       cacheWrite: 0,
     },
     contextWindow: 262144,
-    maxTokens: 4096,
+    maxTokens: 32000,
   },
 ];