feat: proper PAT support via job-token exchange

Qoder PATs (pt-...) cannot authenticate directly; they must be exchanged
for a short-lived job token (jt-...), mirroring the official qodercli flow.

- pat.ts: exchangeJobToken + credentialsFromPat (exchange + identity)
- oauth: fix QODER_PERSONAL_ACCESS_TOKEN env path; re-exchange PAT on refresh
- login: add 'Use API Key (PAT)' option to /login menu and terminal fallback
- README: correct PAT docs (exchange required, two entry points)
This commit is contained in:
Simon Shi
2026-06-16 13:39:13 +08:00
parent 0a4a0ddd97
commit 842bec6eb2
5 changed files with 244 additions and 56 deletions
+148
View File
@@ -0,0 +1,148 @@
import type { OAuthCredentials } from "@earendil-works/pi-ai";
import { getMachineId } from "./cosy.js";
const UA = "pi-provider-qoder";
const EXCHANGE_URL = "https://openapi.qoder.sh/api/v1/jobToken/exchange";
const USERINFO_URL = "https://openapi.qoder.sh/api/v1/userinfo";
/**
* Marker prefix used in the credential `refresh` field to identify PAT-based
* credentials. Layout: `pat|<personalToken>|<jobRefreshToken>|<userID>|<machineID>`
*/
export const PAT_REFRESH_PREFIX = "pat";
export interface PatExchangeResult {
/** Short-lived job token (jt-...) used for auth + COSY signatures. */
jobToken: string;
/** Job refresh token (jrt-...), if returned. */
jobRefreshToken: string;
expiresAt: number;
}
export function isPatRefresh(refresh: string): boolean {
return refresh.startsWith(`${PAT_REFRESH_PREFIX}|`);
}
/** Encode a PAT credential's refresh field. */
export function encodePatRefresh(pat: string, jobRefreshToken: string, userID: string, machineID: string): string {
return [PAT_REFRESH_PREFIX, pat, jobRefreshToken, userID, machineID].join("|");
}
/** Decode a PAT credential's refresh field. */
export function decodePatRefresh(refresh: string): {
pat: string;
jobRefreshToken: string;
userID: string;
machineID: string;
} {
const parts = refresh.split("|");
return {
pat: parts[1] || "",
jobRefreshToken: parts[2] || "",
userID: parts[3] || "",
machineID: parts[4] || "",
};
}
/**
* Exchange a Qoder Personal Access Token (pt-...) for a short-lived Job Token
* (jt-...). PATs cannot authenticate API calls directly; they must first be
* exchanged. This mirrors the official qodercli flow:
* POST /api/v1/jobToken/exchange { personal_token } -> { token, refresh_token, expires_at }
* The exchange endpoint does not require a COSY signature.
*/
export async function exchangeJobToken(pat: string): Promise<PatExchangeResult> {
const res = await fetch(EXCHANGE_URL, {
method: "POST",
headers: {
"Content-Type": "application/json",
Accept: "application/json",
"User-Agent": UA,
"Cosy-Version": "1.0.1",
"Cosy-ClientType": "5",
},
body: JSON.stringify({ personal_token: pat }),
});
if (!res.ok) {
const text = await res.text().catch(() => "");
throw new Error(`Qoder PAT exchange failed: ${res.status} ${res.statusText}. ${text.slice(0, 200)}`);
}
const data = (await res.json()) as {
token?: string;
refresh_token?: string;
expires_at?: string;
expires_in?: number;
};
if (!data.token) {
throw new Error("Qoder PAT exchange returned no job token");
}
let expiresAt = Date.now() + 24 * 60 * 60 * 1000;
if (data.expires_at) {
const parsed = Date.parse(data.expires_at);
if (!Number.isNaN(parsed)) expiresAt = parsed;
} else if (data.expires_in) {
// expires_in is in milliseconds per the observed API response.
expiresAt = Date.now() + data.expires_in;
}
return {
jobToken: data.token,
jobRefreshToken: data.refresh_token || "",
expiresAt,
};
}
/** Fetch user profile using a job token (jt-...). Best-effort. */
async function fetchUserInfo(jobToken: string): Promise<{ userID: string; email: string; name: string }> {
let userID = "";
let email = "";
let name = "";
try {
const res = await fetch(USERINFO_URL, {
headers: {
Authorization: `Bearer ${jobToken}`,
Accept: "application/json",
"User-Agent": UA,
"Cosy-Version": "1.0.1",
"Cosy-ClientType": "5",
},
});
if (res.ok) {
const info = (await res.json()) as {
id?: string;
email?: string;
name?: string;
username?: string;
};
userID = info.id || "";
email = info.email || "";
name = info.name || info.username || "";
}
} catch {}
return { userID, email, name };
}
/**
* Build full Qoder credentials from a Personal Access Token.
* Exchanges the PAT for a job token, resolves identity, and encodes the PAT
* into the refresh field so the token can be re-exchanged on expiry.
*/
export async function credentialsFromPat(pat: string): Promise<OAuthCredentials> {
const { jobToken, jobRefreshToken, expiresAt } = await exchangeJobToken(pat);
const { userID, email, name } = await fetchUserInfo(jobToken);
const machineID = getMachineId();
return {
refresh: encodePatRefresh(pat, jobRefreshToken, userID, machineID),
access: jobToken,
expires: expiresAt - 5 * 60 * 1000, // 5 min buffer
userID,
email,
name,
machineID,
} as OAuthCredentials;
}