Files
pi-provider-qoder/README.md
T
Simon Shi bcaa66091e fix: route PAT login through pi LoginDialog callbacks
The custom ctx.ui.custom login menu stole focus from pi's built-in
LoginDialog, so onPrompt never received keystrokes and PAT login
silently failed with 'No API key found'. Drive login via the provided
onPrompt/onAuth/onProgress callbacks instead, and drop login-ui.ts and
the now-unused pi-tui dependency. Also clears remaining lint warnings
by removing any-casts in models/oauth/stream/transform.
2026-06-16 13:39:16 +08:00

3.0 KiB

pi-provider-qoder

A pi provider extension that connects pi to the Qoder API, exposing Qoder models through one provider surface.

Features

  • Interactive Login: Standard OAuth browser device-code flow or Personal Access Token (PAT) login.
  • WAF Bypass: Built-in WAF obfuscation and body encoding (Encode=1).
  • COSY Signing: Full COSY signature header generation (RSA/AES-CBC/MD5).
  • Dynamic Model Catalog: Dynamically fetches model limits, effort configurations, and options from the /algo/api/v2/model/list endpoint.
  • Reasoning/Thinking Support: Real-time extraction of thinking process from API reasoning or HTML-like <think> tags.

Quick start

Install the provider:

pi install npm:pi-provider-qoder

Or install it globally with npm:

npm install -g pi-provider-qoder

Then log in from pi:

/login qoder

The login menu offers two methods:

  • Browser Login — OAuth device-code flow; complete authorization in your browser.
  • Use API Key (PAT) — paste a Qoder Personal Access Token (pt-...).

Personal Access Token (PAT)

A Qoder PAT (pt-...) cannot authenticate API calls directly — the provider exchanges it for a short-lived job token (mirroring the official qodercli flow) and resolves your account identity automatically. You can supply a PAT in two ways:

  • Run /login qoder and choose Use API Key (PAT), then paste the token.
  • Set the QODER_PERSONAL_ACCESS_TOKEN (or QODER_PAT) environment variable, then run /login qoder — the PAT is picked up automatically and exchanged without further prompts. This is the recommended path for headless/CI setups.

The exchanged job token is short-lived; the provider transparently re-exchanges the stored PAT when it expires.

Models

Exposes the following backing models:

  • Tier Tiers: auto, ultimate, performance, efficient, lite
  • Frontier Models:
    • qmodel (Qwen3.7 Plus)
    • qmodel_latest (Qwen3.7 Max)
    • dmodel (DeepSeek V4 Pro)
    • dfmodel (DeepSeek V4 Flash)
    • gm51model (GLM 5.1)
    • kmodel (Kimi K2.6)
    • mmodel (MiniMax M3)

Usage

Once logged in, select any Qoder model in pi:

/model ultimate

Or let Qoder select automatically:

/model auto

Architecture

src/
├── index.ts            # Extension registration
├── cosy.ts             # COSY Signature and Machine ID resolver
├── login.ts            # OAuth Device Flow + PAT login sequence
├── pat.ts              # PAT → job-token exchange + identity resolution
├── models.ts           # Model definitions and Dynamic Config Cache
├── oauth.ts            # PAT / OAuth callback orchestrator
├── stream.ts           # Main streaming response handler
├── transform.ts        # Message conversions (OpenAI schema mapping)
├── thinking-parser.ts  # Fallback <think> tag parser
└── qoder-encoding.ts   # WAF bypass body encoder

License

MIT