@vidiemme/copilot-proxy 0.1.0

package/dist/usage/parseAnthropic.js

@@ -0,0 +1,83 @@
+import { coerceTokenCount, EMPTY_USAGE } from './types.js';
+function asObject(value) {
+    return typeof value === 'object' && value !== null ? value : undefined;
+}
+/**
+ * Estrae i token da un blocco `usage` in formato Anthropic Messages API.
+ *
+ * In Anthropic `input_tokens` esclude gia' i token di cache, quindi non
+ * serve alcuna sottrazione.
+ */
+export function readAnthropicUsageBlock(usage) {
+    const u = asObject(usage);
+    if (!u)
+        return undefined;
+    return {
+        inputTokens: coerceTokenCount(u.input_tokens),
+        cachedInputTokens: coerceTokenCount(u.cache_read_input_tokens),
+        cacheWriteTokens: coerceTokenCount(u.cache_creation_input_tokens),
+        outputTokens: coerceTokenCount(u.output_tokens),
+    };
+}
+/**
+ * Accumulatore per uno stream Anthropic.
+ *
+ * Lo stream distribuisce l'informazione su due eventi:
+ *  - `message_start` porta gli input token (definitivi) e un output parziale
+ *  - `message_delta` porta gli output token cumulativi finali
+ */
+export class AnthropicUsageAccumulator {
+    usage = { ...EMPTY_USAGE };
+    seen = false;
+    handleEvent(payload) {
+        const event = asObject(payload);
+        if (!event)
+            return;
+        const type = typeof event.type === 'string' ? event.type : undefined;
+        if (type === 'message_start') {
+            const message = asObject(event.message);
+            if (!message)
+                return;
+            const parsed = readAnthropicUsageBlock(message.usage);
+            if (parsed) {
+                this.usage = parsed;
+                this.seen = true;
+            }
+            if (typeof message.model === 'string')
+                this.usage.model = message.model;
+            return;
+        }
+        if (type === 'message_delta') {
+            const parsed = readAnthropicUsageBlock(event.usage);
+            if (!parsed)
+                return;
+            this.seen = true;
+            // I contatori di message_delta sono cumulativi: si sovrascrive solo
+            // cio' che l'evento dichiara effettivamente.
+            if (parsed.outputTokens > 0)
+                this.usage.outputTokens = parsed.outputTokens;
+            if (parsed.inputTokens > 0)
+                this.usage.inputTokens = parsed.inputTokens;
+            if (parsed.cachedInputTokens > 0)
+                this.usage.cachedInputTokens = parsed.cachedInputTokens;
+            if (parsed.cacheWriteTokens > 0)
+                this.usage.cacheWriteTokens = parsed.cacheWriteTokens;
+        }
+    }
+    result() {
+        return this.seen ? { ...this.usage } : undefined;
+    }
+}
+/** Risposta Anthropic non-streaming. */
+export function parseAnthropicResponse(body) {
+    const root = asObject(body);
+    if (!root)
+        return undefined;
+    const parsed = readAnthropicUsageBlock(root.usage);
+    if (!parsed)
+        return undefined;
+    if (typeof root.model === 'string')
+        parsed.model = root.model;
+    return parsed;
+}
+//# sourceMappingURL=parseAnthropic.js.map

package/dist/usage/parseAnthropic.js.map

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

package/dist/usage/parseOpenAI.d.ts

@@ -0,0 +1,24 @@
+import { type ParsedUsage } from './types.js';
+/**
+ * Estrae i token da un blocco `usage` in formato OpenAI / Copilot chat completions.
+ *
+ * Attenzione: `prompt_tokens` INCLUDE i `cached_tokens`. Vanno sottratti,
+ * altrimenti i token in cache verrebbero fatturati due volte (a tariffa piena
+ * e a tariffa cache).
+ */
+export declare function readOpenAIUsageBlock(usage: unknown): ParsedUsage | undefined;
+/**
+ * Accumulatore per uno stream OpenAI/Copilot.
+ *
+ * L'usage arriva tipicamente in un unico chunk finale (richiede
+ * `stream_options: { include_usage: true }`). Alcuni gateway lo ripetono su
+ * piu' chunk: si tiene sempre l'ultimo blocco non vuoto.
+ */
+export declare class OpenAIUsageAccumulator {
+    private usage;
+    private model;
+    handleEvent(payload: unknown): void;
+    result(): ParsedUsage | undefined;
+}
+/** Risposta OpenAI/Copilot non-streaming. */
+export declare function parseOpenAIResponse(body: unknown): ParsedUsage | undefined;

package/dist/usage/parseOpenAI.js

@@ -0,0 +1,72 @@
+import { coerceTokenCount } from './types.js';
+function asObject(value) {
+    return typeof value === 'object' && value !== null ? value : undefined;
+}
+/**
+ * Estrae i token da un blocco `usage` in formato OpenAI / Copilot chat completions.
+ *
+ * Attenzione: `prompt_tokens` INCLUDE i `cached_tokens`. Vanno sottratti,
+ * altrimenti i token in cache verrebbero fatturati due volte (a tariffa piena
+ * e a tariffa cache).
+ */
+export function readOpenAIUsageBlock(usage) {
+    const u = asObject(usage);
+    if (!u)
+        return undefined;
+    const promptTokens = coerceTokenCount(u.prompt_tokens ?? u.input_tokens);
+    const promptDetails = asObject(u.prompt_tokens_details ?? u.input_tokens_details);
+    const cachedTokens = coerceTokenCount(promptDetails?.cached_tokens);
+    const outputTokens = coerceTokenCount(u.completion_tokens ?? u.output_tokens);
+    return {
+        inputTokens: Math.max(0, promptTokens - cachedTokens),
+        cachedInputTokens: cachedTokens,
+        // Il formato OpenAI non espone il cache write: resta a zero.
+        cacheWriteTokens: 0,
+        outputTokens,
+    };
+}
+/**
+ * Accumulatore per uno stream OpenAI/Copilot.
+ *
+ * L'usage arriva tipicamente in un unico chunk finale (richiede
+ * `stream_options: { include_usage: true }`). Alcuni gateway lo ripetono su
+ * piu' chunk: si tiene sempre l'ultimo blocco non vuoto.
+ */
+export class OpenAIUsageAccumulator {
+    usage;
+    model;
+    handleEvent(payload) {
+        const chunk = asObject(payload);
+        if (!chunk)
+            return;
+        if (typeof chunk.model === 'string' && chunk.model.length > 0) {
+            this.model = chunk.model;
+        }
+        if (chunk.usage === null || chunk.usage === undefined)
+            return;
+        const parsed = readOpenAIUsageBlock(chunk.usage);
+        if (!parsed)
+            return;
+        if (parsed.inputTokens + parsed.cachedInputTokens + parsed.outputTokens === 0)
+            return;
+        this.usage = parsed;
+    }
+    result() {
+        if (!this.usage)
+            return undefined;
+        return { ...this.usage, model: this.usage.model ?? this.model };
+    }
+}
+/** Risposta OpenAI/Copilot non-streaming. */
+export function parseOpenAIResponse(body) {
+    const root = asObject(body);
+    if (!root)
+        return undefined;
+    const parsed = readOpenAIUsageBlock(root.usage);
+    if (!parsed)
+        return undefined;
+    if (typeof root.model === 'string')
+        parsed.model = root.model;
+    return parsed;
+}
+//# sourceMappingURL=parseOpenAI.js.map

package/dist/usage/parseOpenAI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseOpenAI.js","sourceRoot":"","sources":["../../src/usage/parseOpenAI.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAoB,MAAM,YAAY,CAAC;AAIhE,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAE,KAAc,CAAC,CAAC,CAAC,SAAS,CAAC;AACnF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1B,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAEzB,MAAM,YAAY,GAAG,gBAAgB,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC;IACzE,MAAM,aAAa,GAAG,QAAQ,CAAC,CAAC,CAAC,qBAAqB,IAAI,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAClF,MAAM,YAAY,GAAG,gBAAgB,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;IACpE,MAAM,YAAY,GAAG,gBAAgB,CAAC,CAAC,CAAC,iBAAiB,IAAI,CAAC,CAAC,aAAa,CAAC,CAAC;IAE9E,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,GAAG,YAAY,CAAC;QACrD,iBAAiB,EAAE,YAAY;QAC/B,6DAA6D;QAC7D,gBAAgB,EAAE,CAAC;QACnB,YAAY;KACb,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,OAAO,sBAAsB;IACzB,KAAK,CAA0B;IAC/B,KAAK,CAAqB;IAElC,WAAW,CAAC,OAAgB;QAC1B,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9D,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAC3B,CAAC;QAED,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;YAAE,OAAO;QAC9D,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,IAAI,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,iBAAiB,GAAG,MAAM,CAAC,YAAY,KAAK,CAAC;YAAE,OAAO;QACtF,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;IACtB,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAClC,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;IAClE,CAAC;CACF;AAED,6CAA6C;AAC7C,MAAM,UAAU,mBAAmB,CAAC,IAAa;IAC/C,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,MAAM,MAAM,GAAG,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ;QAAE,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAC9D,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/usage/sse.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Parser incrementale di Server-Sent Events.
+ *
+ * Accetta chunk arbitrari (anche spezzati a meta' di un evento) e invoca il
+ * callback una volta per ogni payload `data:` deserializzabile come JSON.
+ * I payload non-JSON (es. `[DONE]`) vengono ignorati silenziosamente.
+ */
+export declare class SseParser {
+    private readonly onPayload;
+    private buffer;
+    private readonly decoder;
+    constructor(onPayload: (payload: unknown) => void);
+    push(chunk: Uint8Array): void;
+    end(): void;
+    private drain;
+    private emit;
+}

package/dist/usage/sse.js

@@ -0,0 +1,59 @@
+/**
+ * Parser incrementale di Server-Sent Events.
+ *
+ * Accetta chunk arbitrari (anche spezzati a meta' di un evento) e invoca il
+ * callback una volta per ogni payload `data:` deserializzabile come JSON.
+ * I payload non-JSON (es. `[DONE]`) vengono ignorati silenziosamente.
+ */
+export class SseParser {
+    onPayload;
+    buffer = '';
+    decoder = new TextDecoder('utf-8');
+    constructor(onPayload) {
+        this.onPayload = onPayload;
+    }
+    push(chunk) {
+        this.buffer += this.decoder.decode(chunk, { stream: true });
+        this.drain(false);
+    }
+    end() {
+        this.buffer += this.decoder.decode();
+        this.drain(true);
+        this.buffer = '';
+    }
+    drain(flush) {
+        // Gli eventi SSE sono separati da una riga vuota; si accettano sia \n\n
+        // che \r\n\r\n.
+        const normalized = this.buffer.replace(/\r\n/g, '\n');
+        const parts = normalized.split('\n\n');
+        const tail = flush ? '' : (parts.pop() ?? '');
+        this.buffer = tail;
+        for (const part of parts) {
+            if (part.trim().length === 0)
+                continue;
+            this.emit(part);
+        }
+        if (flush && tail.trim().length > 0)
+            this.emit(tail);
+    }
+    emit(rawEvent) {
+        const dataLines = [];
+        for (const line of rawEvent.split('\n')) {
+            if (!line.startsWith('data:'))
+                continue;
+            dataLines.push(line.slice(5).trimStart());
+        }
+        if (dataLines.length === 0)
+            return;
+        const data = dataLines.join('\n');
+        if (data === '[DONE]')
+            return;
+        try {
+            this.onPayload(JSON.parse(data));
+        }
+        catch {
+            // Payload non JSON: non e' un evento di usage, si ignora.
+        }
+    }
+}
+//# sourceMappingURL=sse.js.map

package/dist/usage/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../src/usage/sse.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,OAAO,SAAS;IAIS;IAHrB,MAAM,GAAG,EAAE,CAAC;IACH,OAAO,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;IAEpD,YAA6B,SAAqC;QAArC,cAAS,GAAT,SAAS,CAA4B;IAAG,CAAC;IAEtE,IAAI,CAAC,KAAiB;QACpB,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAED,GAAG;QACD,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACrC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;IAEO,KAAK,CAAC,KAAc;QAC1B,wEAAwE;QACxE,gBAAgB;QAChB,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QAEnB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YACvC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;QAED,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC;IAEO,IAAI,CAAC,QAAgB;QAC3B,MAAM,SAAS,GAAa,EAAE,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACxC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;gBAAE,SAAS;YACxC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAEnC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,IAAI,KAAK,QAAQ;YAAE,OAAO;QAE9B,IAAI,CAAC;YACH,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,0DAA0D;QAC5D,CAAC;IACH,CAAC;CACF"}

package/dist/usage/types.d.ts

@@ -0,0 +1,23 @@
+import { totalInputTokens, type TokenCounters } from '@vidiemme/copilot-usage-contract';
+/**
+ * Contatori di token normalizzati, indipendenti dal protocollo upstream.
+ *
+ * Convenzione (allineata alla tariffazione GitHub Copilot):
+ *  - inputTokens       = token di input NON serviti da cache
+ *  - cachedInputTokens = token di input letti dalla cache
+ *  - cacheWriteTokens  = token scritti in cache (solo modelli Anthropic)
+ *  - outputTokens      = token generati
+ *
+ * Importante: le famiglie non sono sovrapposte. I parser che ricevono
+ * un `prompt_tokens` comprensivo dei cached devono sottrarli.
+ */
+export type TokenUsage = TokenCounters;
+export { totalInputTokens };
+export interface ParsedUsage extends TokenUsage {
+    /** Id modello dichiarato dalla risposta upstream, se presente. */
+    model?: string;
+}
+export declare const EMPTY_USAGE: TokenUsage;
+export declare function isUsageEmpty(usage: TokenUsage): boolean;
+declare function toInt(value: unknown): number;
+export { toInt as coerceTokenCount };

package/dist/usage/types.js

@@ -0,0 +1,19 @@
+import { totalInputTokens } from '@vidiemme/copilot-usage-contract';
+export { totalInputTokens };
+export const EMPTY_USAGE = {
+    inputTokens: 0,
+    cachedInputTokens: 0,
+    cacheWriteTokens: 0,
+    outputTokens: 0,
+};
+export function isUsageEmpty(usage) {
+    return (usage.inputTokens === 0 &&
+        usage.cachedInputTokens === 0 &&
+        usage.cacheWriteTokens === 0 &&
+        usage.outputTokens === 0);
+}
+function toInt(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? Math.max(0, Math.trunc(value)) : 0;
+}
+export { toInt as coerceTokenCount };
+//# sourceMappingURL=types.js.map

package/dist/usage/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/usage/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAsB,MAAM,kCAAkC,CAAC;AAgBxF,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAO5B,MAAM,CAAC,MAAM,WAAW,GAAe;IACrC,WAAW,EAAE,CAAC;IACd,iBAAiB,EAAE,CAAC;IACpB,gBAAgB,EAAE,CAAC;IACnB,YAAY,EAAE,CAAC;CAChB,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,KAAiB;IAC5C,OAAO,CACL,KAAK,CAAC,WAAW,KAAK,CAAC;QACvB,KAAK,CAAC,iBAAiB,KAAK,CAAC;QAC7B,KAAK,CAAC,gBAAgB,KAAK,CAAC;QAC5B,KAAK,CAAC,YAAY,KAAK,CAAC,CACzB,CAAC;AACJ,CAAC;AAED,SAAS,KAAK,CAAC,KAAc;IAC3B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClG,CAAC;AAED,OAAO,EAAE,KAAK,IAAI,gBAAgB,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@vidiemme/copilot-proxy",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Proxy locale: misura il consumo di token di GitHub Copilot e lo attribuisce al progetto",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vidiemme/copilot-usage.git",
+    "directory": "packages/client"
+  },
+  "homepage": "https://github.com/vidiemme/copilot-usage#readme",
+  "keywords": [
+    "github-copilot",
+    "token-usage",
+    "cost-attribution",
+    "proxy"
+  ],
+  "bin": {
+    "copilot-proxy": "dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22.9"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "tsx watch --env-file-if-exists=.env src/cli.ts start",
+    "start": "node dist/cli.js start",
+    "smoke": "npm run build && node scripts/smoke.mjs",
+    "verify-detection": "npm run build && node scripts/verify-detection.mjs",
+    "verify-e2e": "npm run build && node --env-file-if-exists=.env scripts/verify-e2e.mjs",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@vidiemme/copilot-usage-contract": "^0.1.0",
+    "fastify": "^5.2.1",
+    "undici": "^7.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.7",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3"
+  }
+}