@aliou/pi-synthetic 0.4.6 → 0.4.7

package/package.json

@@ -1,27 +1,40 @@
 {
   "name": "@aliou/pi-synthetic",
-  "version": "0.4.6",
+  "version": "0.4.7",
+  "license": "MIT",
+  "type": "module",
+  "private": false,
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "pi"
+  ],
   "repository": {
     "type": "git",
     "url": "https://github.com/aliou/pi-synthetic"
   },
-  "keywords": [
-    "pi-package"
-  ],
   "pi": {
     "extensions": [
       "./src/index.ts"
     ],
     "video": "https://assets.aliou.me/pi-extensions/demos/pi-synthetic.mp4"
   },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "src",
+    "README.md"
+  ],
   "peerDependencies": {
-    "@mariozechner/pi-coding-agent": ">=0.52.7"
+    "@mariozechner/pi-coding-agent": ">=0.52.7",
+    "@mariozechner/pi-tui": ">=0.51.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.3.13",
+    "@aliou/biome-plugins": "^0.3.2",
+    "@biomejs/biome": "^2.4.2",
     "@changesets/cli": "^2.27.11",
     "@mariozechner/pi-coding-agent": "0.52.7",
-    "@mariozechner/pi-tui": "0.52.7",
     "@sinclair/typebox": "^0.34.48",
     "@types/node": "^25.0.10",
     "husky": "^9.1.7",
@@ -30,12 +43,16 @@
   "peerDependenciesMeta": {
     "@mariozechner/pi-coding-agent": {
       "optional": true
+    },
+    "@mariozechner/pi-tui": {
+      "optional": true
     }
   },
   "scripts": {
     "typecheck": "tsc --noEmit",
     "lint": "biome check",
     "format": "biome check --write",
+    "check:lockfile": "pnpm install --frozen-lockfile --ignore-scripts",
     "changeset": "changeset",
     "version": "changeset version",
     "release": "pnpm changeset publish"

package/src/commands/quotas.ts

@@ -9,16 +9,6 @@ export function registerQuotasCommand(pi: ExtensionAPI): void {
   pi.registerCommand("synthetic:quotas", {
     description: "Display Synthetic API usage quotas",
     handler: async (_args, ctx) => {
-      if (!ctx.hasUI) {
-        const quotas = await fetchQuotas();
-        if (!quotas) {
-          console.error("Failed to fetch quotas");
-          return;
-        }
-        console.log(formatQuotasPlain(quotas));
-        return;
-      }
-
       const result = await ctx.ui.custom<null>((tui, theme, _kb, done) => {
         let currentComponent: Component = new QuotasLoadingComponent(theme);
 

package/src/hooks/search-tool-availability.ts

@@ -1,13 +1,6 @@
-import type {
-  ExtensionAPI,
-  ExtensionContext,
-} from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
 import { SYNTHETIC_WEB_SEARCH_TOOL } from "../tools/search";
 
-function notifyDebug(ctx: ExtensionContext, message: string): void {
-  ctx.ui.notify(`[pi-synthetic:web-search] ${message}`, "info");
-}
-
 async function checkSubscriptionAccess(
   apiKey: string,
 ): Promise<{ ok: true } | { ok: false; reason: string }> {
@@ -51,48 +44,36 @@ export function registerSyntheticWebSearchHooks(pi: ExtensionAPI): void {
   let didNotifyDenied = false;
 
   // Keep tool inactive at session start. Availability is decided before each agent run.
-  pi.on("session_start", (_event, ctx) => {
-    notifyDebug(ctx, "session_start: preparing web search tool");
-
+  pi.on("session_start", () => {
     const current = pi.getActiveTools();
     if (current.includes(SYNTHETIC_WEB_SEARCH_TOOL)) {
       pi.setActiveTools(
         current.filter((toolName) => toolName !== SYNTHETIC_WEB_SEARCH_TOOL),
       );
-      notifyDebug(ctx, "session_start: tool disabled until subscription check");
     }
   });
 
   // Verify subscription only when user starts agent execution.
   pi.on("before_agent_start", async (_event, ctx) => {
-    notifyDebug(ctx, "before_agent_start: ensuring tool availability");
-
     const apiKey = process.env.SYNTHETIC_API_KEY;
     if (!apiKey) {
       hasAccess = false;
       deniedReason = "SYNTHETIC_API_KEY is not configured";
       accessCheckPromise = undefined;
-      notifyDebug(ctx, "before_agent_start: access denied (missing API key)");
     } else {
       if (deniedReason === "SYNTHETIC_API_KEY is not configured") {
         deniedReason = undefined;
       }
 
       if (!hasAccess && !deniedReason) {
-        notifyDebug(ctx, "before_agent_start: checking subscription access");
         accessCheckPromise ??= checkSubscriptionAccess(apiKey);
         const access = await accessCheckPromise;
 
         if (!access.ok) {
           deniedReason = access.reason;
-          notifyDebug(
-            ctx,
-            `before_agent_start: access denied (${access.reason})`,
-          );
         } else {
           hasAccess = true;
           didNotifyDenied = false;
-          notifyDebug(ctx, "before_agent_start: access granted");
         }
       }
     }
@@ -103,7 +84,6 @@ export function registerSyntheticWebSearchHooks(pi: ExtensionAPI): void {
         pi.setActiveTools(
           current.filter((toolName) => toolName !== SYNTHETIC_WEB_SEARCH_TOOL),
         );
-        notifyDebug(ctx, "before_agent_start: tool kept disabled");
       }
 
       if (ctx.hasUI && !didNotifyDenied) {
@@ -112,10 +92,6 @@ export function registerSyntheticWebSearchHooks(pi: ExtensionAPI): void {
           "warning",
         );
         didNotifyDenied = true;
-        notifyDebug(
-          ctx,
-          "before_agent_start: user notified about disabled tool",
-        );
       }
       return;
     }
@@ -123,7 +99,6 @@ export function registerSyntheticWebSearchHooks(pi: ExtensionAPI): void {
     const current = pi.getActiveTools();
     if (!current.includes(SYNTHETIC_WEB_SEARCH_TOOL)) {
       pi.setActiveTools([...current, SYNTHETIC_WEB_SEARCH_TOOL]);
-      notifyDebug(ctx, "before_agent_start: tool enabled");
     }
   });
 }

package/.changeset/config.json

@@ -1,11 +0,0 @@
-{
-  "$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

@@ -1,30 +0,0 @@
-name: CI
-
-on:
-  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

@@ -1,151 +0,0 @@
-name: Publish
-
-on:
-  push:
-    branches:
-      - main
-  workflow_dispatch:
-    inputs:
-      skip-checks:
-        description: "Skip lint and typecheck"
-        type: boolean
-        default: false
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
-
-jobs:
-  check:
-    if: ${{ !(github.event_name == 'workflow_dispatch' && inputs.skip-checks) }}
-    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
-    if: ${{ always() && (needs.check.result == 'success' || needs.check.result == 'skipped') }}
-    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

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

package/AGENTS.md

@@ -1,69 +0,0 @@
-# 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 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
-
-## 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

@@ -1,91 +0,0 @@
-# @aliou/pi-synthetic
-
-## 0.4.6
-
-### Patch Changes
-
-- 6180572: mark pi SDK peer deps as optional to prevent koffi OOM in Gondolin VMs
-- fe8094f: register synthetic web search tool at init time and move availability checks to hooks
-
-## 0.4.5
-
-### Patch Changes
-
-- 7489bc0: update model list: add nvidia/Kimi-K2.5-NVFP4, remove 6 discontinued models
-
-## 0.4.4
-
-### Patch Changes
-
-- 86a3145: Fix quotas command showing duplicate notification in TUI mode
-- f94cc6b: fix: register search tool at init time so it's available when pi collects tools
-
-## 0.4.3
-
-### Patch Changes
-
-- 7dc1d80: Defer subscription check to session_start for non-blocking extension init.
-
-## 0.4.2
-
-### Patch Changes
-
-- d9af905: Add demo video URL for the Pi package browser.
-
-## 0.4.1
-
-### Patch Changes
-
-- aba3bb8: fix: use correct /v2/quotas endpoint for subscription access check
-
-## 0.4.0
-
-### Minor Changes
-
-- 5cca252: Add `/synthetic:quotas` command to display API usage quotas
-
-  A new slash command that shows your Synthetic API subscription quotas in a rich terminal UI:
-
-  - Visual usage bar with color-coded severity (green/yellow/red based on usage)
-  - Aligned columns showing limit, used, and remaining requests
-  - ISO8601 renewal timestamp with relative time formatting (e.g., "in 5 hours")
-  - Closes on any key press
-
-  The command is only registered when `SYNTHETIC_API_KEY` environment variable is set.
-
-- a8cacfb: Add Synthetic web search tool
-
-  New tool `synthetic_web_search` allows agents to search the web using Synthetic's zero-data-retention API. Returns search results with titles, URLs, content snippets, and publication dates.
-
-  **Note:** Search is a subscription-only feature. The tool will only be registered if the `SYNTHETIC_API_KEY` belongs to an active subscription (verified via the usage endpoint).
-
-## 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
-
-- 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/biome.json

@@ -1,30 +0,0 @@
-{
-  "$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/shell.nix

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

package/tsconfig.json

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