@senomas/proxy-provider

A pi-coding-agent extension that registers a deepseek provider via a configurable AI proxy.

What it does

This package extends pi with a "deepseek" provider (always registered). On every session:

1. Walks up from the current directory looking for .pi-project.json
2. Reads the project, proxy, and optional providers fields from that file
3. Fetches model definitions from ${proxy}/static/providers/deepseek.json and registers the default "deepseek" provider
4. If a providers map is present, fetches and registers each additional provider
5. All providers get the proxy as baseUrl and the project name as the AI-Proxy-Project header

Prerequisites

• Node.js 18+ (for global fetch)
• pi-coding-agent installed (npm install -g @earendil-works/pi-coding-agent)

Installation

pi install npm:@senomas/proxy-provider

Configuration

Create a .pi-project.json file in your project root:

{
  "project": "my-project",
  "proxy": "https://proxy.example.com"
}

Field	Type	Description
project	string	Project name sent as the AI-Proxy-Project header
proxy	string	Base URL of the AI proxy server
providers	object (optional)	Map of provider names to config filenames under {proxy}/static/providers/

Multiple providers

You can register additional providers by adding a providers map. Each entry registers a provider with the same baseUrl and AI-Proxy-Project header as the default "deepseek".

{
  "project": "my-project",
  "proxy": "https://proxy.example.com",
  "providers": {
    "deepseek-work": "deepseek.json",
    "deepseek-chat": "deepseek-chat.json"
  }
}

The default "deepseek" from deepseek.json is always registered. If you include a key named "deepseek" in providers, it overrides the default.

Server-side dependency

This extension requires a running AI proxy server that exposes provider configuration files under /static/providers/.
Refer to the ai-team-proxy project for the reference proxy implementation and deployment instructions.

Verification

After installation, list available models to confirm the provider is registered:

pi --list-models | grep deepseek

You should see the deepseek models exposed by your proxy.

How it works

The extension exports an async default function that:

1. Uses fs.existsSync and fs.readFileSync (Node built-ins) to find and parse .pi-project.json
2. Calls fetch() to retrieve the default "deepseek" provider metadata from the proxy
3. If a providers map is present, fetches and registers each additional provider in the same way
4. Calls pi.registerProvider(name, config) for each provider with the fetched models, proxy baseUrl, and AI-Proxy-Project header

License

MIT