@jx-grxf/patchpilot 0.2.0

package/dist/core/openrouter.js

@@ -0,0 +1,168 @@
+import { attachTokenCost } from "./tokenAccounting.js";
+export const defaultOpenRouterModel = "openrouter/auto";
+export const defaultOpenRouterBaseUrl = "https://openrouter.ai/api/v1";
+const modelPricingCacheTtlMs = 15 * 60_000;
+let modelPricingCache = null;
+export class OpenRouterClient {
+    apiKey;
+    baseUrl;
+    runtimeOptions;
+    constructor(apiKey = readOpenRouterApiKey(), baseUrl = process.env.PATCHPILOT_OPENROUTER_BASE_URL ?? defaultOpenRouterBaseUrl, runtimeOptions = readOpenRouterRuntimeOptions()) {
+        this.apiKey = apiKey;
+        this.baseUrl = baseUrl.replace(/\/$/, "");
+        this.runtimeOptions = runtimeOptions;
+    }
+    async chat(options) {
+        this.assertConfigured();
+        const startedAt = Date.now();
+        const response = await this.fetchOpenRouter("/chat/completions", {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.apiKey}`,
+                "HTTP-Referer": "https://github.com/jx-grxf/PatchPilot",
+                "X-Title": "PatchPilot"
+            },
+            body: JSON.stringify({
+                model: normalizeOpenRouterModel(options.model),
+                messages: options.messages,
+                max_tokens: this.runtimeOptions.maxTokens,
+                temperature: this.runtimeOptions.temperature,
+                reasoning: options.reasoningEffort
+                    ? {
+                        effort: options.reasoningEffort,
+                        exclude: true
+                    }
+                    : undefined,
+                response_format: options.formatJson ? { type: "json_object" } : undefined
+            }),
+            signal: options.signal
+        });
+        const durationMs = Date.now() - startedAt;
+        const payload = (await readJsonSafely(response));
+        if (!response.ok || payload.error) {
+            const reason = payload.error?.message ? ` ${payload.error.message}` : "";
+            throw new Error(`OpenRouter chat failed for model "${options.model}": HTTP ${response.status}.${reason}`);
+        }
+        const content = payload.choices?.[0]?.message?.content?.trim() ?? "";
+        if (!content) {
+            throw new Error("OpenRouter returned an empty response.");
+        }
+        return {
+            content,
+            telemetry: await toTelemetry(payload, durationMs, options.model)
+        };
+    }
+    async listModels() {
+        const models = await fetchOpenRouterModels(this.baseUrl);
+        return [defaultOpenRouterModel, ...models.map((model) => model.id).sort()];
+    }
+    async fetchOpenRouter(path, init) {
+        try {
+            return await fetch(`${this.baseUrl}${path}`, init);
+        }
+        catch (error) {
+            const suffix = error instanceof Error ? ` ${error.message}` : "";
+            throw new Error(`Cannot reach OpenRouter API at ${this.baseUrl}.${suffix}`);
+        }
+    }
+    assertConfigured() {
+        if (!this.apiKey) {
+            throw new Error("OpenRouter API key missing. Set OPENROUTER_API_KEY in PatchPilot config, .env, or your shell.");
+        }
+    }
+}
+export function readOpenRouterApiKey(env = process.env) {
+    return env.OPENROUTER_API_KEY?.trim() || env.PATCHPILOT_OPENROUTER_API_KEY?.trim() || "";
+}
+export function isOpenRouterFreeModel(model) {
+    return normalizeOpenRouterModel(model).endsWith(":free");
+}
+export async function getOpenRouterModelRates(model) {
+    const normalizedModel = normalizeOpenRouterModel(model);
+    const rates = await readOpenRouterPricing();
+    return rates.get(normalizedModel) ?? null;
+}
+function normalizeOpenRouterModel(model) {
+    const trimmedModel = model.trim();
+    if (!trimmedModel || trimmedModel === "auto" || trimmedModel === "openrouter/auto") {
+        return defaultOpenRouterModel;
+    }
+    return trimmedModel;
+}
+async function readOpenRouterPricing() {
+    if (modelPricingCache && modelPricingCache.expiresAt > Date.now()) {
+        return modelPricingCache.rates;
+    }
+    const models = await fetchOpenRouterModels(process.env.PATCHPILOT_OPENROUTER_BASE_URL ?? defaultOpenRouterBaseUrl).catch(() => []);
+    const rates = new Map();
+    for (const model of models) {
+        rates.set(model.id, {
+            inputPerToken: readPrice(model.pricing?.prompt),
+            cachedInputPerToken: readPrice(model.pricing?.input_cache_read),
+            cacheWritePerToken: readPrice(model.pricing?.input_cache_write),
+            outputPerToken: readPrice(model.pricing?.completion)
+        });
+    }
+    modelPricingCache = {
+        expiresAt: Date.now() + modelPricingCacheTtlMs,
+        rates
+    };
+    return rates;
+}
+async function fetchOpenRouterModels(baseUrl) {
+    const response = await fetch(`${baseUrl.replace(/\/$/, "")}/models`);
+    const payload = (await readJsonSafely(response));
+    if (!response.ok || payload.error) {
+        const reason = payload.error?.message ? ` ${payload.error.message}` : "";
+        throw new Error(`OpenRouter models failed with HTTP ${response.status}.${reason}`);
+    }
+    return payload.data ?? [];
+}
+async function toTelemetry(payload, durationMs, model) {
+    const promptTokens = payload.usage?.prompt_tokens ?? 0;
+    const responseTokens = payload.usage?.completion_tokens ?? 0;
+    const totalTokens = payload.usage?.total_tokens ?? promptTokens + responseTokens;
+    const cachedPromptTokens = payload.usage?.prompt_tokens_details?.cached_tokens ?? 0;
+    const cacheWriteTokens = payload.usage?.prompt_tokens_details?.cache_write_tokens ?? 0;
+    const rates = await getOpenRouterModelRates(model);
+    return attachTokenCost({
+        promptTokens,
+        cachedPromptTokens,
+        cacheWriteTokens,
+        responseTokens,
+        totalTokens,
+        evalTokensPerSecond: responseTokens > 0 && durationMs > 0 ? responseTokens / (durationMs / 1000) : null,
+        promptDurationMs: 0,
+        responseDurationMs: durationMs,
+        totalDurationMs: durationMs,
+        tokenSource: "provider"
+    }, "openrouter", model, rates, payload.usage?.cost);
+}
+function readOpenRouterRuntimeOptions(env = process.env) {
+    return {
+        maxTokens: readPositiveInteger(env.PATCHPILOT_NUM_PREDICT, 1024),
+        temperature: readTemperature(env.PATCHPILOT_TEMPERATURE, 0.1)
+    };
+}
+async function readJsonSafely(response) {
+    try {
+        return await response.json();
+    }
+    catch {
+        return {};
+    }
+}
+function readPrice(value) {
+    const parsedValue = Number.parseFloat(value ?? "0");
+    return Number.isFinite(parsedValue) && parsedValue >= 0 ? parsedValue : 0;
+}
+function readPositiveInteger(value, fallback) {
+    const parsedValue = Number.parseInt(value ?? "", 10);
+    return Number.isFinite(parsedValue) && parsedValue > 0 ? parsedValue : fallback;
+}
+function readTemperature(value, fallback) {
+    const parsedValue = Number.parseFloat(value ?? "");
+    return Number.isFinite(parsedValue) && parsedValue >= 0 ? parsedValue : fallback;
+}
+//# sourceMappingURL=openrouter.js.map

package/dist/core/openrouter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openrouter.js","sourceRoot":"","sources":["../../src/core/openrouter.ts"],"names":[],"mappings":"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"}

package/dist/core/subagents.d.ts

@@ -0,0 +1,14 @@
+import type { ModelClient, ModelTelemetry, SubagentRole } from "./types.js";
+export type SubagentAdvice = {
+    role: SubagentRole;
+    message: string;
+    telemetry: ModelTelemetry;
+};
+export declare function runSubagentAdvisors(options: {
+    client: ModelClient;
+    model: string;
+    task: string;
+    workspaceRoot: string;
+    workspaceSummary?: string;
+}): Promise<SubagentAdvice[]>;
+export declare function formatSubagentContext(advice: SubagentAdvice[]): string;

package/dist/core/subagents.js

@@ -0,0 +1,89 @@
+import { readdir } from "node:fs/promises";
+import path from "node:path";
+const advisorSpecs = [
+    {
+        role: "explorer",
+        system: [
+            "You are PatchPilot's explorer subagent.",
+            "Map likely files, commands, and repo shape for the primary agent.",
+            "Stay factual and brief. Do not warn unless a risk blocks progress.",
+            "Use at most 4 short bullet lines."
+        ].join("\n")
+    },
+    {
+        role: "planner",
+        system: [
+            "You are PatchPilot's planner subagent.",
+            "Give the primary agent a direct tactical path before it edits code.",
+            "Focus on likely files, next actions, and fast verification.",
+            "Do not claim you inspected files beyond the provided workspace hint.",
+            "Use at most 4 short bullet lines."
+        ].join("\n")
+    },
+    {
+        role: "reviewer",
+        system: [
+            "You are PatchPilot's reviewer subagent.",
+            "Call out only concrete blockers or easy checks the primary agent should not miss.",
+            "Do not produce generic warnings about permissions, overwrites, or tests for simple explicit file edits.",
+            "Use at most 3 short bullet lines."
+        ].join("\n")
+    }
+];
+export async function runSubagentAdvisors(options) {
+    const workspaceHint = await buildWorkspaceHint(options.workspaceRoot);
+    const userMessage = [
+        `Task: ${options.task}`,
+        `Workspace: ${path.basename(options.workspaceRoot) || "workspace"}`,
+        "",
+        "Workspace hint:",
+        workspaceHint,
+        options.workspaceSummary ? `\nWorkspace context:\n${options.workspaceSummary}` : ""
+    ].join("\n");
+    const results = await Promise.allSettled(advisorSpecs.map(async (advisor) => {
+        const messages = [
+            {
+                role: "system",
+                content: advisor.system
+            },
+            {
+                role: "user",
+                content: userMessage
+            }
+        ];
+        const response = await options.client.chat({
+            model: options.model,
+            messages,
+            formatJson: false
+        });
+        return {
+            role: advisor.role,
+            message: clipAdvice(response.content),
+            telemetry: response.telemetry
+        };
+    }));
+    return results.flatMap((result) => (result.status === "fulfilled" ? [result.value] : []));
+}
+export function formatSubagentContext(advice) {
+    if (advice.length === 0) {
+        return "";
+    }
+    return advice.map((item) => `${item.role} subagent:\n${item.message}`).join("\n\n");
+}
+async function buildWorkspaceHint(workspaceRoot) {
+    const entries = await readdir(workspaceRoot, { withFileTypes: true }).catch(() => []);
+    const visibleEntries = entries
+        .filter((entry) => !entry.name.startsWith(".") || entry.name === ".github")
+        .sort((left, right) => left.name.localeCompare(right.name))
+        .slice(0, 60)
+        .map((entry) => `${entry.isDirectory() ? "dir " : "file"} ${entry.name}`);
+    return visibleEntries.length > 0 ? visibleEntries.join("\n") : "No top-level workspace entries could be read.";
+}
+function clipAdvice(value) {
+    const trimmedValue = value.trim();
+    if (trimmedValue.length <= 1200) {
+        return trimmedValue;
+    }
+    return `${trimmedValue.slice(0, 1200)}\n...[clipped ${trimmedValue.length - 1200} chars]`;
+}
+//# sourceMappingURL=subagents.js.map

package/dist/core/subagents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagents.js","sourceRoot":"","sources":["../../src/core/subagents.ts"],"names":[],"mappings":"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"}

package/dist/core/tokenAccounting.d.ts

@@ -0,0 +1,6 @@
+import type { ModelProvider, ModelTelemetry, SessionTelemetry } from "./types.js";
+import type { OpenRouterTokenRates } from "./openrouter.js";
+export declare function estimateTokens(value: string): number;
+export declare function attachTokenCost(telemetry: Omit<ModelTelemetry, "estimatedCostUsd" | "costSource">, provider: ModelProvider, model: string, openRouterRates?: OpenRouterTokenRates | null, providerCostUsd?: number | null): ModelTelemetry;
+export declare function emptySessionTelemetry(): SessionTelemetry;
+export declare function addTelemetryToSession(session: SessionTelemetry, telemetry: ModelTelemetry): SessionTelemetry;

package/dist/core/tokenAccounting.js

@@ -0,0 +1,134 @@
+const codexApiTokenRates = {
+    "gpt-5.4": {
+        inputPerMillion: 2.5,
+        cachedInputPerMillion: 0.25,
+        outputPerMillion: 15
+    },
+    "gpt-5.4-mini": {
+        inputPerMillion: 0.75,
+        cachedInputPerMillion: 0.075,
+        outputPerMillion: 4.5
+    },
+    "gpt-5.2": {
+        inputPerMillion: 1.75,
+        cachedInputPerMillion: 0.175,
+        outputPerMillion: 14
+    },
+    "gpt-5.2-codex": {
+        inputPerMillion: 1.75,
+        cachedInputPerMillion: 0.175,
+        outputPerMillion: 14
+    },
+    "gpt-5.3-codex": {
+        inputPerMillion: 1.75,
+        cachedInputPerMillion: 0.175,
+        outputPerMillion: 14
+    },
+    "gpt-5.1-codex-max": {
+        inputPerMillion: 1.25,
+        cachedInputPerMillion: 0.125,
+        outputPerMillion: 10
+    },
+    "gpt-5.1-codex-mini": {
+        inputPerMillion: 0.25,
+        cachedInputPerMillion: 0.025,
+        outputPerMillion: 2
+    },
+    "codex-mini-latest": {
+        inputPerMillion: 1.5,
+        cachedInputPerMillion: 0.375,
+        outputPerMillion: 6
+    }
+};
+export function estimateTokens(value) {
+    const normalizedValue = value.trim();
+    return normalizedValue ? Math.ceil(normalizedValue.length / 4) : 0;
+}
+export function attachTokenCost(telemetry, provider, model, openRouterRates, providerCostUsd) {
+    if (provider === "ollama") {
+        return {
+            ...telemetry,
+            estimatedCostUsd: 0,
+            costSource: "local"
+        };
+    }
+    if (provider === "openrouter") {
+        if (providerCostUsd !== undefined && providerCostUsd !== null) {
+            return {
+                ...telemetry,
+                cachedPromptTokens: Math.min(telemetry.cachedPromptTokens, telemetry.promptTokens),
+                estimatedCostUsd: providerCostUsd,
+                costSource: "api-pricing"
+            };
+        }
+        if (!openRouterRates) {
+            return {
+                ...telemetry,
+                cachedPromptTokens: Math.min(telemetry.cachedPromptTokens, telemetry.promptTokens),
+                estimatedCostUsd: null,
+                costSource: "unknown"
+            };
+        }
+        const cachedPromptTokens = Math.min(telemetry.cachedPromptTokens, telemetry.promptTokens);
+        const cacheWriteTokens = Math.min(telemetry.cacheWriteTokens, Math.max(0, telemetry.promptTokens - cachedPromptTokens));
+        const uncachedPromptTokens = Math.max(0, telemetry.promptTokens - cachedPromptTokens - cacheWriteTokens);
+        const estimatedCostUsd = uncachedPromptTokens * openRouterRates.inputPerToken +
+            cachedPromptTokens * openRouterRates.cachedInputPerToken +
+            cacheWriteTokens * openRouterRates.cacheWritePerToken +
+            telemetry.responseTokens * openRouterRates.outputPerToken;
+        return {
+            ...telemetry,
+            cachedPromptTokens,
+            estimatedCostUsd,
+            costSource: "api-pricing"
+        };
+    }
+    const rates = provider === "codex" ? codexApiTokenRates[model] : undefined;
+    if (!rates) {
+        return {
+            ...telemetry,
+            estimatedCostUsd: null,
+            costSource: "unknown"
+        };
+    }
+    const cachedPromptTokens = Math.min(telemetry.cachedPromptTokens, telemetry.promptTokens);
+    const uncachedPromptTokens = Math.max(0, telemetry.promptTokens - cachedPromptTokens);
+    const estimatedCostUsd = (uncachedPromptTokens * rates.inputPerMillion +
+        cachedPromptTokens * rates.cachedInputPerMillion +
+        telemetry.responseTokens * rates.outputPerMillion) /
+        1_000_000;
+    return {
+        ...telemetry,
+        cachedPromptTokens,
+        estimatedCostUsd,
+        costSource: "api-pricing"
+    };
+}
+export function emptySessionTelemetry() {
+    return {
+        requests: 0,
+        promptTokens: 0,
+        cachedPromptTokens: 0,
+        cacheWriteTokens: 0,
+        responseTokens: 0,
+        totalTokens: 0,
+        estimatedCostUsd: null
+    };
+}
+export function addTelemetryToSession(session, telemetry) {
+    const estimatedCostUsd = session.requests === 0
+        ? telemetry.estimatedCostUsd
+        : session.estimatedCostUsd === null || telemetry.estimatedCostUsd === null
+            ? null
+            : session.estimatedCostUsd + telemetry.estimatedCostUsd;
+    return {
+        requests: session.requests + 1,
+        promptTokens: session.promptTokens + telemetry.promptTokens,
+        cachedPromptTokens: session.cachedPromptTokens + telemetry.cachedPromptTokens,
+        cacheWriteTokens: session.cacheWriteTokens + telemetry.cacheWriteTokens,
+        responseTokens: session.responseTokens + telemetry.responseTokens,
+        totalTokens: session.totalTokens + telemetry.totalTokens,
+        estimatedCostUsd
+    };
+}
+//# sourceMappingURL=tokenAccounting.js.map

package/dist/core/tokenAccounting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenAccounting.js","sourceRoot":"","sources":["../../src/core/tokenAccounting.ts"],"names":[],"mappings":"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"}

package/dist/core/types.d.ts

@@ -0,0 +1,90 @@
+export type ChatRole = "system" | "user" | "assistant";
+export type ChatMessage = {
+    role: ChatRole;
+    content: string;
+};
+export type ModelProvider = "ollama" | "gemini" | "codex" | "openrouter" | "nvidia";
+export type ReasoningEffort = "low" | "medium" | "high" | "xhigh";
+export type ModelChatOptions = {
+    model: string;
+    messages: ChatMessage[];
+    formatJson?: boolean;
+    reasoningEffort?: ReasoningEffort;
+    signal?: AbortSignal;
+};
+export type ModelChatResult = {
+    content: string;
+    telemetry: ModelTelemetry;
+};
+export type ModelClient = {
+    chat(options: ModelChatOptions): Promise<ModelChatResult>;
+    listModels(): Promise<string[]>;
+};
+export type AgentToolName = "list_files" | "read_file" | "search_text" | "inspect_document" | "write_file" | "run_shell";
+export type AgentToolCall = {
+    name: AgentToolName;
+    arguments: Record<string, unknown>;
+};
+export type AgentResponse = {
+    action: "tools";
+    message: string;
+    tool_calls: AgentToolCall[];
+} | {
+    action: "final";
+    message: string;
+};
+export type SubagentRole = "planner" | "reviewer" | "explorer";
+export type AgentEvent = {
+    type: "status";
+    message: string;
+} | {
+    type: "metrics";
+    metrics: ModelTelemetry;
+} | {
+    type: "assistant";
+    message: string;
+} | {
+    type: "subagent";
+    role: SubagentRole;
+    message: string;
+    metrics: ModelTelemetry;
+} | {
+    type: "tool";
+    name: AgentToolName;
+    summary: string;
+    ok: boolean;
+} | {
+    type: "final";
+    message: string;
+} | {
+    type: "error";
+    message: string;
+};
+export type ToolResult = {
+    ok: boolean;
+    summary: string;
+    content: string;
+};
+export type ModelTelemetry = {
+    promptTokens: number;
+    cachedPromptTokens: number;
+    cacheWriteTokens: number;
+    responseTokens: number;
+    totalTokens: number;
+    evalTokensPerSecond: number | null;
+    promptDurationMs: number;
+    responseDurationMs: number;
+    totalDurationMs: number;
+    estimatedCostUsd: number | null;
+    tokenSource: "provider" | "estimated";
+    costSource: "api-pricing" | "local" | "unknown";
+};
+export type SessionTelemetry = {
+    requests: number;
+    promptTokens: number;
+    cachedPromptTokens: number;
+    cacheWriteTokens: number;
+    responseTokens: number;
+    totalTokens: number;
+    estimatedCostUsd: number | null;
+};

package/dist/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":""}

package/dist/core/workspace.d.ts

@@ -0,0 +1,28 @@
+import type { AgentToolCall, ToolResult } from "./types.js";
+export type WorkspaceToolsOptions = {
+    root: string;
+    allowWrite: boolean;
+    allowShell: boolean;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+};
+export declare class WorkspaceTools {
+    readonly root: string;
+    private readonly rootRealPath;
+    private readonly allowWrite;
+    private readonly allowShell;
+    private readonly timeoutMs;
+    private readonly signal?;
+    constructor(options: WorkspaceToolsOptions);
+    execute(call: AgentToolCall): Promise<ToolResult>;
+    resolveInsideWorkspace(requestedPath: string): string;
+    normalizeWorkspaceRelativePath(requestedPath: string): string;
+    private listFiles;
+    private readFile;
+    private inspectDocument;
+    private searchText;
+    private writeFile;
+    private runShell;
+    private resolveReadPath;
+    private resolveWritePath;
+}