@aliou/pi-synthetic 0.0.1 → 0.1.0

package/.changeset/config.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.1.2/schema.json",
+  "changelog": "@changesets/cli/changelog",
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "public",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}

package/.github/workflows/ci.yml

@@ -0,0 +1,32 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: "pnpm"
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Lint
+        run: pnpm lint
+
+      - name: Typecheck
+        run: pnpm typecheck

package/.github/workflows/publish.yml

@@ -0,0 +1,143 @@
+name: Publish
+
+on:
+  push:
+    branches:
+      - main
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: "pnpm"
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Lint
+        run: pnpm lint
+
+      - name: Typecheck
+        run: pnpm typecheck
+
+  publish:
+    name: Publish
+    needs: check
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      packages: write
+      pull-requests: write
+      id-token: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          registry-url: "https://registry.npmjs.org"
+          scope: "@aliou"
+          cache: "pnpm"
+
+      - name: Upgrade npm for OIDC support
+        run: npm install -g npm@latest
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Get release info
+        id: release-info
+        run: |
+          pnpm changeset status --output=release.json 2>/dev/null || echo '{"releases":[]}' > release.json
+          node <<NODE
+          const fs = require('fs');
+          const release = JSON.parse(fs.readFileSync('release.json', 'utf8'));
+          const releases = release.releases?.filter(r => r.type !== 'none') || [];
+
+          let title = 'Version Packages';
+          let commit = 'Version Packages';
+          if (releases.length === 1) {
+            const { name, newVersion } = releases[0];
+            title = 'Updating ' + name + ' to version ' + newVersion;
+            commit = name + '@' + newVersion;
+          } else if (releases.length > 1) {
+            const summary = releases.map(r => r.name + '@' + r.newVersion).join(', ');
+            title = 'Updating ' + summary;
+            commit = summary;
+          }
+
+          fs.appendFileSync(process.env.GITHUB_OUTPUT, 'title=' + title + '\n');
+          fs.appendFileSync(process.env.GITHUB_OUTPUT, 'commit=' + commit + '\n');
+          NODE
+          rm -f release.json
+        continue-on-error: true
+
+      - name: Create Release PR or Publish
+        id: changesets
+        uses: changesets/action@v1
+        with:
+          version: pnpm changeset version
+          publish: pnpm changeset publish
+          title: ${{ steps.release-info.outputs.title || 'Version Packages' }}
+          commit: ${{ steps.release-info.outputs.commit || 'Version Packages' }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_CONFIG_PROVENANCE: true
+
+      - name: Create GitHub releases
+        if: steps.changesets.outputs.published == 'true'
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          PUBLISHED_PACKAGES: ${{ steps.changesets.outputs.publishedPackages }}
+        run: |
+          node <<'NODE'
+          const { execSync } = require("node:child_process");
+
+          const published = JSON.parse(process.env.PUBLISHED_PACKAGES || "[]");
+
+          for (const pkg of published) {
+            const shortName = pkg.name.replace(/^@[^/]+\//, "");
+            const tag = `${shortName}@${pkg.version}`;
+
+            const existing = execSync(`git tag --list ${tag}`, { encoding: "utf8" }).trim();
+            if (!existing) {
+              execSync(`git tag ${tag}`);
+              execSync(`git push origin ${tag}`);
+            }
+
+            let hasRelease = false;
+            try {
+              const output = execSync(`gh release view ${tag} --json tagName --jq .tagName`, {
+                stdio: ["ignore", "pipe", "ignore"],
+              }).toString().trim();
+              hasRelease = output.length > 0;
+            } catch {
+              hasRelease = false;
+            }
+
+            if (!hasRelease) {
+              execSync(`gh release create ${tag} --title ${tag} --notes "Release ${tag}"`, {
+                stdio: "inherit",
+              });
+            }
+          }
+          NODE

package/.husky/pre-commit

@@ -0,0 +1,3 @@
+pnpm run typecheck
+pnpm run lint
+pnpm run format

package/AGENTS.md

@@ -0,0 +1,69 @@
+# pi-synthetic
+
+Public Pi extension providing open-source language models via Synthetic's API. People could be using this, so consider backwards compatibility when making changes.
+
+Pi is pre-1.0.0, so breaking changes can happen between Pi versions. This extension must stay up to date with Pi or things will break.
+
+## Stack
+
+- TypeScript (strict mode)
+- pnpm 10.26.1
+- Biome for linting/formatting
+- Changesets for versioning
+
+## Scripts
+
+```bash
+pnpm typecheck    # Type check
+pnpm lint         # Lint (runs on pre-commit)
+pnpm format       # Format
+pnpm changeset    # Create changeset for versioning
+```
+
+## Structure
+
+```
+src/
+  index.ts           # Extension entry, registers provider
+  providers/
+    index.ts         # Provider registration
+    models.ts        # Hardcoded model definitions
+```
+
+## Conventions
+
+- API key comes from environment (`SYNTHETIC_API_KEY`)
+- Uses Anthropic-compatible API at `https://api.synthetic.new/anthropic`
+- Models are hardcoded in `src/providers/models.ts`
+- Update model list when Synthetic adds new models
+
+## Adding Models
+
+Edit `src/providers/models.ts`:
+
+```typescript
+{
+  id: "hf:vendor/model-name",
+  name: "vendor/model-name",
+  reasoning: true/false,
+  input: ["text"] or ["text", "image"],
+  cost: {
+    input: 0.55,      // $ per million tokens
+    output: 2.19,
+    cacheRead: 0.55,
+    cacheWrite: 0
+  },
+  contextWindow: 202752,
+  maxTokens: 65536
+}
+```
+
+Get pricing from `https://api.synthetic.new/openai/v1/models`.
+
+## Versioning
+
+Uses changesets. Run `pnpm changeset` before committing user-facing changes.
+
+- `patch`: bug fixes, model updates
+- `minor`: new models, features
+- `major`: breaking changes

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# @aliou/pi-synthetic
+
+## 0.1.0
+
+### Minor Changes
+
+- 4a32d18: Initial release with 19 open-source models
+
+  - Add Synthetic provider with Anthropic-compatible API
+  - Support for DeepSeek, Qwen, MiniMax, Kimi, Llama, GLM models
+  - Vision and reasoning capabilities where available
+  - Hardcoded model definitions with per-token pricing

package/README.md

@@ -0,0 +1,108 @@
+# 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.
+
+## Installation
+
+### Get API Key
+
+Sign up at [synthetic.new](https://synthetic.new/?referral=NDWw1u3UDWiFyDR) to get an API key (referral link).
+
+### Set Environment Variable
+
+```bash
+export SYNTHETIC_API_KEY="your-api-key-here"
+```
+
+Add to shell profile for persistence:
+
+```bash
+echo 'export SYNTHETIC_API_KEY="your-api-key-here"' >> ~/.zshrc
+```
+
+### Install Extension
+
+```bash
+# From npm
+pi install npm:@aliou/pi-synthetic
+
+# From git
+pi install git:github.com/aliou/pi-synthetic
+
+# Local development
+pi -e ./src/index.ts
+```
+
+## Usage
+
+Once installed, select `synthetic` as your provider and choose from available models:
+
+```
+/model synthetic hf:moonshotai/Kimi-K2.5
+```
+
+## Adding or Updating Models
+
+Models are hardcoded in `src/providers/models.ts`. To add or update models:
+
+1. Edit `src/providers/models.ts`
+2. Add the model configuration following the `SyntheticModelConfig` interface
+3. Run `pnpm run typecheck` to verify
+
+## Development
+
+### Setup
+
+```bash
+git clone https://github.com/aliou/pi-synthetic.git
+cd pi-synthetic
+
+# Install dependencies (sets up pre-commit hooks)
+pnpm install && pnpm prepare
+```
+
+Pre-commit hooks run on every commit:
+- TypeScript type checking
+- Biome linting
+- Biome formatting with auto-fix
+
+### Commands
+
+```bash
+# Type check
+pnpm run typecheck
+
+# Lint
+pnpm run lint
+
+# Format
+pnpm run format
+```
+
+### Test Locally
+
+```bash
+pi -e ./src/index.ts
+```
+
+## Release
+
+This repository uses [Changesets](https://github.com/changesets/changesets) for versioning.
+
+**Note:** Automatic NPM publishing is currently disabled. To publish manually:
+
+1. Create a changeset: `pnpm changeset`
+2. Version packages: `pnpm version`
+3. Publish (when ready): Uncomment the publish job in `.github/workflows/publish.yml`
+
+## Requirements
+
+- Pi coding agent v0.50.0+
+- SYNTHETIC_API_KEY environment variable
+
+## Links
+
+- [Synthetic](https://synthetic.new)
+- [Synthetic Models](https://synthetic.new/models)
+- [Synthetic API Docs](https://dev.synthetic.new/docs/api/overview)
+- [Pi Documentation](https://buildwithpi.ai/)

package/biome.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.3.13/schema.json",
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
+  "files": {
+    "includes": ["**/*.ts", "**/*.json"],
+    "ignoreUnknown": true
+  },
+  "assist": {
+    "actions": {
+      "source": {
+        "organizeImports": "on"
+      }
+    }
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true
+    }
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2
+  }
+}

package/package.json

@@ -1,9 +1,33 @@
 {
   "name": "@aliou/pi-synthetic",
-  "version": "0.0.1",
-  "private": false,
+  "version": "0.1.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aliou/pi-synthetic"
+  },
   "keywords": [
     "pi-package"
-  ]
-}
-
+  ],
+  "pi": {
+    "extensions": [
+      "./src/index.ts"
+    ]
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.13",
+    "@changesets/cli": "^2.27.11",
+    "@mariozechner/pi-coding-agent": "^0.50.1",
+    "@mariozechner/pi-tui": "^0.50.1",
+    "@types/node": "^25.0.10",
+    "husky": "^9.1.7",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check",
+    "format": "biome check --write",
+    "changeset": "changeset",
+    "version": "changeset version",
+    "release": "pnpm changeset publish"
+  }
+}

package/shell.nix

@@ -0,0 +1,10 @@
+{
+  pkgs ? import <nixpkgs> { },
+}:
+
+pkgs.mkShell {
+  buildInputs = with pkgs; [
+    nodejs
+    pnpm_10
+  ];
+}

package/src/index.ts

@@ -0,0 +1,6 @@
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import { registerSyntheticProvider } from "./providers/index.js";
+
+export default function (pi: ExtensionAPI) {
+  registerSyntheticProvider(pi);
+}

package/src/providers/index.ts

@@ -0,0 +1,19 @@
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import { SYNTHETIC_MODELS } from "./models.js";
+
+export function registerSyntheticProvider(pi: ExtensionAPI): void {
+  pi.registerProvider("synthetic", {
+    baseUrl: "https://api.synthetic.new/anthropic",
+    apiKey: "SYNTHETIC_API_KEY",
+    api: "anthropic-messages",
+    models: SYNTHETIC_MODELS.map((model) => ({
+      id: model.id,
+      name: model.name,
+      reasoning: model.reasoning,
+      input: model.input,
+      cost: model.cost,
+      contextWindow: model.contextWindow,
+      maxTokens: model.maxTokens,
+    })),
+  });
+}

package/src/providers/models.ts

@@ -0,0 +1,286 @@
+// Hardcoded models from Synthetic API
+// Source: https://api.synthetic.new/openai/v1/models
+
+export interface SyntheticModelConfig {
+  id: string;
+  name: string;
+  reasoning: boolean;
+  input: ("text" | "image")[];
+  cost: {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+  };
+  contextWindow: number;
+  maxTokens: number;
+}
+
+export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
+  {
+    id: "hf:zai-org/GLM-4.7",
+    name: "zai-org/GLM-4.7",
+    reasoning: true,
+    input: ["text"],
+    cost: {
+      input: 0.55,
+      output: 2.19,
+      cacheRead: 0.55,
+      cacheWrite: 0,
+    },
+    contextWindow: 202752,
+    maxTokens: 65536,
+  },
+  {
+    id: "hf:MiniMaxAI/MiniMax-M2.1",
+    name: "MiniMaxAI/MiniMax-M2.1",
+    reasoning: true,
+    input: ["text"],
+    cost: {
+      input: 0.55,
+      output: 2.19,
+      cacheRead: 0.55,
+      cacheWrite: 0,
+    },
+    contextWindow: 196608,
+    maxTokens: 65536,
+  },
+  {
+    id: "hf:meta-llama/Llama-3.3-70B-Instruct",
+    name: "meta-llama/Llama-3.3-70B-Instruct",
+    reasoning: false,
+    input: ["text"],
+    cost: {
+      input: 0.9,
+      output: 0.9,
+      cacheRead: 0.9,
+      cacheWrite: 0,
+    },
+    contextWindow: 131072,
+    maxTokens: 4096,
+  },
+  {
+    id: "hf:deepseek-ai/DeepSeek-V3-0324",
+    name: "deepseek-ai/DeepSeek-V3-0324",
+    reasoning: false,
+    input: ["text"],
+    cost: {
+      input: 1.2,
+      output: 1.2,
+      cacheRead: 1.2,
+      cacheWrite: 0,
+    },
+    contextWindow: 131072,
+    maxTokens: 4096,
+  },
+  {
+    id: "hf:deepseek-ai/DeepSeek-R1-0528",
+    name: "deepseek-ai/DeepSeek-R1-0528",
+    reasoning: true,
+    input: ["text"],
+    cost: {
+      input: 3,
+      output: 8,
+      cacheRead: 3,
+      cacheWrite: 0,
+    },
+    contextWindow: 131072,
+    maxTokens: 4096,
+  },
+  {
+    id: "hf:deepseek-ai/DeepSeek-V3.1",
+    name: "deepseek-ai/DeepSeek-V3.1",
+    reasoning: false,
+    input: ["text"],
+    cost: {
+      input: 0.56,
+      output: 1.68,
+      cacheRead: 0.56,
+      cacheWrite: 0,
+    },
+    contextWindow: 131072,
+    maxTokens: 4096,
+  },
+  {
+    id: "hf:deepseek-ai/DeepSeek-V3.1-Terminus",
+    name: "deepseek-ai/DeepSeek-V3.1-Terminus",
+    reasoning: false,
+    input: ["text"],
+    cost: {
+      input: 1.2,
+      output: 1.2,
+      cacheRead: 1.2,
+      cacheWrite: 0,
+    },
+    contextWindow: 131072,
+    maxTokens: 4096,
+  },
+  {
+    id: "hf:deepseek-ai/DeepSeek-V3.2",
+    name: "deepseek-ai/DeepSeek-V3.2",
+    reasoning: false,
+    input: ["text"],
+    cost: {
+      input: 0.56,
+      output: 1.68,
+      cacheRead: 0.56,
+      cacheWrite: 0,
+    },
+    contextWindow: 162816,
+    maxTokens: 4096,
+  },
+  {
+    id: "hf:Qwen/Qwen3-VL-235B-A22B-Instruct",
+    name: "Qwen/Qwen3-VL-235B-A22B-Instruct",
+    reasoning: true,
+    input: ["text", "image"],
+    cost: {
+      input: 0.22,
+      output: 0.88,
+      cacheRead: 0.22,
+      cacheWrite: 0,
+    },
+    contextWindow: 256000,
+    maxTokens: 4096,
+  },
+  {
+    id: "hf:moonshotai/Kimi-K2-Instruct-0905",
+    name: "moonshotai/Kimi-K2-Instruct-0905",
+    reasoning: true,
+    input: ["text"],
+    cost: {
+      input: 1.2,
+      output: 1.2,
+      cacheRead: 1.2,
+      cacheWrite: 0,
+    },
+    contextWindow: 262144,
+    maxTokens: 4096,
+  },
+  {
+    id: "hf:moonshotai/Kimi-K2-Thinking",
+    name: "moonshotai/Kimi-K2-Thinking",
+    reasoning: true,
+    input: ["text"],
+    cost: {
+      input: 0.6,
+      output: 2.5,
+      cacheRead: 0.6,
+      cacheWrite: 0,
+    },
+    contextWindow: 262144,
+    maxTokens: 4096,
+  },
+  {
+    id: "hf:openai/gpt-oss-120b",
+    name: "openai/gpt-oss-120b",
+    reasoning: false,
+    input: ["text"],
+    cost: {
+      input: 0.1,
+      output: 0.1,
+      cacheRead: 0.1,
+      cacheWrite: 0,
+    },
+    contextWindow: 131072,
+    maxTokens: 4096,
+  },
+  {
+    id: "hf:Qwen/Qwen3-Coder-480B-A35B-Instruct",
+    name: "Qwen/Qwen3-Coder-480B-A35B-Instruct",
+    reasoning: false,
+    input: ["text"],
+    cost: {
+      input: 0.45,
+      output: 1.8,
+      cacheRead: 0.45,
+      cacheWrite: 0,
+    },
+    contextWindow: 262144,
+    maxTokens: 4096,
+  },
+  {
+    id: "hf:Qwen/Qwen3-235B-A22B-Instruct-2507",
+    name: "Qwen/Qwen3-235B-A22B-Instruct-2507",
+    reasoning: false,
+    input: ["text"],
+    cost: {
+      input: 0.22,
+      output: 0.88,
+      cacheRead: 0.22,
+      cacheWrite: 0,
+    },
+    contextWindow: 262144,
+    maxTokens: 4096,
+  },
+  {
+    id: "hf:zai-org/GLM-4.6",
+    name: "zai-org/GLM-4.6",
+    reasoning: true,
+    input: ["text"],
+    cost: {
+      input: 0.55,
+      output: 2.19,
+      cacheRead: 0.55,
+      cacheWrite: 0,
+    },
+    contextWindow: 202752,
+    maxTokens: 4096,
+  },
+  {
+    id: "hf:MiniMaxAI/MiniMax-M2",
+    name: "MiniMaxAI/MiniMax-M2",
+    reasoning: true,
+    input: ["text"],
+    cost: {
+      input: 0.3,
+      output: 1.2,
+      cacheRead: 0.3,
+      cacheWrite: 0,
+    },
+    contextWindow: 196608,
+    maxTokens: 4096,
+  },
+  {
+    id: "hf:moonshotai/Kimi-K2.5",
+    name: "moonshotai/Kimi-K2.5",
+    reasoning: true,
+    input: ["text", "image"],
+    cost: {
+      input: 1.2,
+      output: 1.2,
+      cacheRead: 1.2,
+      cacheWrite: 0,
+    },
+    contextWindow: 262144,
+    maxTokens: 4096,
+  },
+  {
+    id: "hf:deepseek-ai/DeepSeek-V3",
+    name: "deepseek-ai/DeepSeek-V3",
+    reasoning: false,
+    input: ["text"],
+    cost: {
+      input: 1.25,
+      output: 1.25,
+      cacheRead: 1.25,
+      cacheWrite: 0,
+    },
+    contextWindow: 131072,
+    maxTokens: 4096,
+  },
+  {
+    id: "hf:Qwen/Qwen3-235B-A22B-Thinking-2507",
+    name: "Qwen/Qwen3-235B-A22B-Thinking-2507",
+    reasoning: true,
+    input: ["text"],
+    cost: {
+      input: 0.65,
+      output: 3,
+      cacheRead: 0.65,
+      cacheWrite: 0,
+    },
+    contextWindow: 262144,
+    maxTokens: 4096,
+  },
+];

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "noEmit": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules"]
+}