Files
pi-provider-qoder/src/stream.ts
T
liyanan d4c31fcc4e fix(stream): map usage to pi-core's cache convention (input excludes cached tokens)
pi-core computes promptTokens = input + cacheRead + cacheWrite (Anthropic
convention: input EXCLUDES cached/written tokens), but qoder follows OpenAI
semantics where prompt_tokens INCLUDES cached_tokens. pi-ai's own OpenAI
provider subtracts them; this provider didn't, which under-reported the
cache rate (45% vs the true ~83%) and tripped pi-core's miss detector on
every cached turn.

- input = max(0, prompt_tokens - cacheRead - cache_write_tokens)
- cacheWrite reads cache_write_tokens, not cacheable_tokens (a capacity
  metric that is 0 even on first-turn writes, not a write count)
2026-07-30 12:42:22 +08:00

514 lines
18 KiB
TypeScript

import crypto from "node:crypto";
import type {
Api,
AssistantMessage,
AssistantMessageEventStream,
Context,
Model,
SimpleStreamOptions,
TextContent,
ThinkingContent,
ToolCall,
} from "@earendil-works/pi-ai";
import * as PiAi from "@earendil-works/pi-ai";
import {
buildAuthHeaders,
getMachineId,
getQoderChatURL,
getQoderCNDirectModel,
getQoderMode,
getQoderUserEmailFallback,
isQoderCNMode,
} from "./cosy.js";
import { getCachedModelConfig } from "./models.js";
import { getCachedCredentials } from "./oauth.js";
import { qoderEncodeBody } from "./qoder-encoding.js";
import { stripThinkingTags, ThinkingTagParser } from "./thinking-parser.js";
import { transformMessagesForQoder, transformTools } from "./transform.js";
interface ToolCallState {
arguments: string;
id: string;
name: string;
emittedStart?: boolean;
emittedEnd?: boolean;
contentIndex: number;
}
function stableHash(prefix: string, ...inputs: string[]): string {
const hash = crypto.createHash("sha256");
hash.update(prefix);
for (const input of inputs) {
hash.update("\0");
hash.update(input);
}
return hash.digest("hex").slice(0, 16);
}
function stableChatRecordID(
model: string,
messages: Array<{ role?: string; content?: unknown }>,
tools: unknown,
maxTokens: number,
): string {
const hash = crypto.createHash("sha256");
hash.update("qoder-record");
hash.update("\0");
hash.update(model);
for (const msg of messages) {
if (msg?.role) {
hash.update("\0");
hash.update(msg.role);
}
if (msg?.content) {
hash.update("\0");
hash.update(typeof msg.content === "string" ? msg.content : JSON.stringify(msg.content));
}
}
if (tools) {
hash.update("\0");
hash.update(JSON.stringify(tools));
}
hash.update("\0");
hash.update(`mt=${maxTokens}`);
return hash.digest("hex").slice(0, 16);
}
export function streamQoder(
model: Model<Api>,
context: Context,
options?: SimpleStreamOptions,
): AssistantMessageEventStream {
const StreamCtor = (PiAi as unknown as { AssistantMessageEventStream: new () => AssistantMessageEventStream })
.AssistantMessageEventStream;
const stream = new StreamCtor();
const output: AssistantMessage = {
role: "assistant",
content: [],
api: model.api,
provider: model.provider,
model: model.id,
usage: {
input: 0,
output: 0,
cacheRead: 0,
cacheWrite: 0,
totalTokens: 0,
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
},
stopReason: "stop",
timestamp: Date.now(),
};
(async () => {
try {
const providerMode = model.provider === "qoder-cn" ? "cn" : getQoderMode();
const accessToken = options?.apiKey;
if (!accessToken) {
throw new Error(
isQoderCNMode(providerMode)
? "Qoder CN credentials not set. Run /login qoder-cn or set QODERCN_PERSONAL_ACCESS_TOKEN."
: "Qoder credentials not set. Run /login qoder or set QODER_PERSONAL_ACCESS_TOKEN.",
);
}
// Resolve user details from cached credentials
const cachedCreds = getCachedCredentials(accessToken, model.provider);
const userID = cachedCreds?.userID || "qoder-user";
const name = cachedCreds?.name || (isQoderCNMode(providerMode) ? "Qoder CN User" : "Qoder User");
const email = cachedCreds?.email || getQoderUserEmailFallback(providerMode);
const machineID = cachedCreds?.machineID || getMachineId();
const qoderModel = isQoderCNMode(providerMode) ? getQoderCNDirectModel(model.id) : model.id;
const modelConfig = getCachedModelConfig(qoderModel, providerMode) || {
key: qoderModel,
is_reasoning:
qoderModel === "ultimate" ||
qoderModel === "performance" ||
qoderModel.includes("dmodel") ||
qoderModel.includes("dfmodel"),
max_output_tokens: 32768,
source: "system",
};
modelConfig.key = qoderModel;
const isReasoning = !!modelConfig.is_reasoning;
const maxOutputTokens = modelConfig.max_output_tokens || 32768;
const normalizedMessages = transformMessagesForQoder(context.messages);
const systemText = context.systemPrompt || "";
let lastUserText = "";
for (let i = normalizedMessages.length - 1; i >= 0; i--) {
if (normalizedMessages[i].role === "user") {
const content = normalizedMessages[i].content;
lastUserText =
typeof content === "string"
? content
: Array.isArray(content)
? content.map((c) => ("text" in c ? c.text : "")).join("")
: "";
break;
}
}
// Use a stable session id when pi provides one (per agent session) so
// the Qoder server can maintain prompt cache affinity across consecutive
// requests. Fall back to a random id only when no sessionId is available.
const stablePart = stableHash("qoder-session", userID, qoderModel);
const sessionID = options?.sessionId
? `${stablePart}-${options.sessionId}`
: `${stablePart}-${crypto.randomUUID()}`;
let maxTokens = 32768;
if (maxOutputTokens > 0) {
maxTokens = maxOutputTokens;
}
if (options?.maxTokens && options.maxTokens < maxTokens) {
maxTokens = options.maxTokens;
}
const toolsRaw = context.tools && context.tools.length > 0 ? transformTools(context.tools) : undefined;
const recordID = stableChatRecordID(qoderModel, normalizedMessages, toolsRaw, maxTokens);
const reqBody: Record<string, unknown> = {
request_id: crypto.randomUUID(),
request_set_id: recordID,
chat_record_id: recordID,
session_id: sessionID,
stream: true,
chat_task: "FREE_INPUT",
is_reply: true,
is_retry: false,
source: 1,
version: "3",
session_type: "qodercli",
agent_id: "agent_common",
task_id: "common",
code_language: "",
chat_prompt: "",
image_urls: null,
aliyun_user_type: "",
// Qoder's server ignores the top-level `system` field (verified: the
// model never sees it). Inject the system prompt as a leading
// role:system message instead, which the server does honor.
system: "",
messages: systemText ? [{ role: "system", content: systemText }, ...normalizedMessages] : normalizedMessages,
tools: toolsRaw || [],
parameters: { max_tokens: maxTokens },
chat_context: {
chatPrompt: "",
imageUrls: null,
extra: {
context: [],
modelConfig: {
key: qoderModel,
is_reasoning: isReasoning,
},
originalContent: lastUserText,
},
features: [],
text: lastUserText,
},
model_config: modelConfig,
business: {
product: "cli",
version: "1.0.0",
type: "agent",
stage: "start",
id: crypto.randomUUID(),
name: lastUserText.substring(0, 30),
begin_at: Date.now(),
},
};
const bodyBytes = Buffer.from(JSON.stringify(reqBody));
const encodedBody = qoderEncodeBody(bodyBytes);
const encodedBytes = Buffer.from(encodedBody, "utf8");
const chatURL = getQoderChatURL(providerMode);
const headers = buildAuthHeaders(encodedBytes, chatURL, {
userID,
authToken: accessToken,
name,
email,
machineID,
});
const modelSource = modelConfig.source || "system";
const response = await fetch(chatURL, {
method: "POST",
headers: {
"Content-Type": "application/json",
Accept: "text/event-stream",
"Cache-Control": "no-cache",
"Accept-Encoding": "identity",
"X-Model-Key": qoderModel,
"X-Model-Source": modelSource,
...headers,
},
body: encodedBytes,
signal: options?.signal,
});
if (!response.ok) {
const errText = await response.text();
throw new Error(`Qoder API request failed: ${response.status} ${response.statusText}. Response: ${errText}`);
}
const reader = response.body?.getReader();
if (!reader) throw new Error("No response body");
const decoder = new TextDecoder();
let buffer = "";
let contentBlockIndex = -1;
let thinkingBlockIndex = -1;
const toolCallsState: ToolCallState[] = [];
const thinkingEnabled = (options?.reasoning as unknown) !== false && (options?.reasoning as unknown) !== "off";
const thinkingParser = thinkingEnabled ? new ThinkingTagParser(output, stream) : null;
stream.push({ type: "start", partial: output });
while (true) {
const { done, value } = await reader.read();
if (done) break;
buffer += decoder.decode(value, { stream: true });
while (true) {
const lineEnd = buffer.indexOf("\n");
if (lineEnd === -1) break;
const line = buffer.substring(0, lineEnd).trim();
buffer = buffer.substring(lineEnd + 1);
if (!line.startsWith("data:")) continue;
const dataStr = line.substring(5).trim();
if (dataStr === "[DONE]") {
break;
}
try {
const envelope = JSON.parse(dataStr);
if (envelope.statusCodeValue && envelope.statusCodeValue !== 200) {
throw new Error(`Upstream status ${envelope.statusCodeValue}: ${envelope.body}`);
}
const innerStr = envelope.body;
if (!innerStr || innerStr === "[DONE]") continue;
const inner = JSON.parse(innerStr);
if (inner.id) output.responseId = inner.id as string;
if (inner.model) output.responseModel = inner.model as string;
if (inner.usage) {
const u = inner.usage as {
prompt_tokens?: number;
completion_tokens?: number;
total_tokens?: number;
completion_tokens_details?: { reasoning_tokens?: number };
prompt_tokens_details?: {
cacheable_tokens?: number;
cached_tokens?: number;
cache_write_tokens?: number;
};
};
// pi-core computes `promptTokens = input + cacheRead + cacheWrite`
// (Anthropic convention: `input` EXCLUDES cached/written tokens).
// Qoder follows OpenAI semantics where `prompt_tokens` INCLUDES
// `cached_tokens`, so subtract cacheRead (and cache_write_tokens
// when reported) to match the contract pi-ai's own OpenAI
// provider uses. `cacheable_tokens` is a capacity metric, not a
// write count (it is 0 even on first-turn writes), so it is NOT
// mapped to cacheWrite.
const promptTokens = u.prompt_tokens ?? 0;
const cacheReadTokens = u.prompt_tokens_details?.cached_tokens ?? 0;
const cacheWriteTokens = u.prompt_tokens_details?.cache_write_tokens ?? 0;
output.usage.input = Math.max(0, promptTokens - cacheReadTokens - cacheWriteTokens);
output.usage.output = u.completion_tokens ?? 0;
output.usage.totalTokens = u.total_tokens ?? 0;
output.usage.cacheRead = cacheReadTokens;
output.usage.cacheWrite = cacheWriteTokens;
}
if (inner.choices && inner.choices.length > 0) {
const choice = inner.choices[0];
const delta = choice.delta;
if (delta) {
// 1. Process reasoning/thinking content (API reasoning)
if (delta.reasoning_content) {
// Qoder's backend sometimes routes a literal `<thinking>`
// opener into reasoning_content (with the matching
// `</thinking>` closer landing in the content stream). Strip
// tag artifacts so the thinking block stays clean, matching
// the SDK's ContentBlock model.
const reasoningChunk = stripThinkingTags(delta.reasoning_content);
if (reasoningChunk) {
if (thinkingBlockIndex === -1) {
thinkingBlockIndex = output.content.length;
output.content.push({ type: "thinking", thinking: "" });
stream.push({ type: "thinking_start", contentIndex: thinkingBlockIndex, partial: output });
}
const block = output.content[thinkingBlockIndex] as ThinkingContent;
block.thinking += reasoningChunk;
stream.push({
type: "thinking_delta",
contentIndex: thinkingBlockIndex,
delta: reasoningChunk,
partial: output,
});
}
}
// 2. Process text content
if (delta.content) {
// End API thinking block if active
if (thinkingBlockIndex !== -1) {
const block = output.content[thinkingBlockIndex] as ThinkingContent;
stream.push({
type: "thinking_end",
contentIndex: thinkingBlockIndex,
content: block.thinking,
partial: output,
});
thinkingBlockIndex = -1;
}
if (thinkingParser) {
thinkingParser.processChunk(delta.content);
} else {
if (contentBlockIndex === -1) {
contentBlockIndex = output.content.length;
output.content.push({ type: "text", text: "" });
stream.push({ type: "text_start", contentIndex: contentBlockIndex, partial: output });
}
const block = output.content[contentBlockIndex] as TextContent;
block.text += delta.content;
stream.push({
type: "text_delta",
contentIndex: contentBlockIndex,
delta: delta.content,
partial: output,
});
}
}
// 3. Process tool calls
if (delta.tool_calls && Array.isArray(delta.tool_calls)) {
for (const tc of delta.tool_calls) {
const idx = tc.index ?? 0;
if (!toolCallsState[idx]) {
toolCallsState[idx] = { arguments: "", id: "", name: "", contentIndex: 0 };
}
const state = toolCallsState[idx];
if (tc.id) state.id = tc.id;
if (tc.function?.name) state.name = tc.function.name;
if (tc.function?.arguments) {
const argDelta = tc.function.arguments;
state.arguments += argDelta;
if (state.emittedStart === undefined) {
state.emittedStart = true;
state.contentIndex = output.content.length;
const block: ToolCall = { type: "toolCall", id: state.id, name: state.name, arguments: {} };
output.content.push(block);
stream.push({ type: "toolcall_start", contentIndex: state.contentIndex, partial: output });
}
stream.push({
type: "toolcall_delta",
contentIndex: state.contentIndex,
delta: argDelta,
partial: output,
});
}
}
}
}
if (choice.finish_reason) {
// Preserve the real upstream finish_reason (e.g. "length",
// "content_filter") instead of forcing "stop" later.
output.stopReason = choice.finish_reason as AssistantMessage["stopReason"];
}
}
} catch (e) {
// A single malformed SSE line shouldn't kill the stream — skip it.
// But a genuine upstream error (thrown below) must propagate to the
// outer catch and surface as stopReason="error", not be swallowed.
if (e instanceof SyntaxError) {
if (process.env.QODER_DEBUG) {
console.error("[pi-provider-qoder] skipping malformed SSE line:", dataStr.slice(0, 200));
}
continue;
}
throw e;
}
}
}
if (thinkingParser) {
thinkingParser.finalize();
}
if (thinkingBlockIndex !== -1) {
const block = output.content[thinkingBlockIndex] as ThinkingContent;
stream.push({
type: "thinking_end",
contentIndex: thinkingBlockIndex,
content: block.thinking,
partial: output,
});
}
for (const state of toolCallsState) {
if (state?.emittedStart && !state.emittedEnd) {
state.emittedEnd = true;
let args = {};
try {
args = JSON.parse(state.arguments || "{}");
} catch {}
const block = output.content[state.contentIndex] as ToolCall;
block.arguments = args;
stream.push({
type: "toolcall_end",
contentIndex: state.contentIndex,
toolCall: {
type: "toolCall",
id: state.id,
name: state.name,
arguments: args,
},
partial: output,
});
}
}
if (toolCallsState.length > 0) {
output.stopReason = "toolUse";
}
// Otherwise keep whatever finish_reason set upstream (defaults to "stop").
// Never overwrite a meaningful finish_reason ("length", "content_filter",
// ...) with "stop".
stream.push({
type: "done",
reason: output.stopReason as Extract<AssistantMessage["stopReason"], "stop" | "length" | "toolUse">,
message: output,
});
stream.end();
} catch (e: unknown) {
output.stopReason = options?.signal?.aborted ? "aborted" : "error";
output.errorMessage = e instanceof Error ? e.message : String(e);
stream.push({ type: "error", reason: output.stopReason, error: output });
try {
stream.end();
} catch {}
}
})();
return stream;
}