@howaboua/opencode-usage-plugin 0.0.1

package/dist/types.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Core type definitions for the Usage Tracking Plugin.
+ */
+export declare const PlanTypes: readonly ["guest", "free", "go", "plus", "pro", "free_workspace", "team", "business", "education", "quorum", "k12", "enterprise", "edu"];
+export type PlanType = (typeof PlanTypes)[number];
+export interface RateLimitWindow {
+    usedPercent: number;
+    windowMinutes: number | null;
+    resetsAt: number | null;
+}
+export interface CreditsSnapshot {
+    hasCredits: boolean;
+    unlimited: boolean;
+    balance: string | null;
+}
+export interface ProxyQuotaGroup {
+    name: string;
+    remaining: number;
+    max: number;
+    remainingPct: number;
+    resetTime?: string | null;
+}
+export interface ProxyTierInfo {
+    tier: "paid" | "free";
+    quotaGroups: ProxyQuotaGroup[];
+}
+export interface ProxyProviderInfo {
+    name: string;
+    tiers: ProxyTierInfo[];
+}
+export interface ProxyQuota {
+    providers: ProxyProviderInfo[];
+    totalCredentials: number;
+    activeCredentials: number;
+    dataSource: string;
+}
+export interface UsageSnapshot {
+    timestamp: number;
+    provider: string;
+    planType: PlanType | null;
+    primary: RateLimitWindow | null;
+    secondary: RateLimitWindow | null;
+    codeReview: RateLimitWindow | null;
+    credits: CreditsSnapshot | null;
+    proxyQuota?: ProxyQuota;
+    updatedAt: number;
+}
+export interface UsageEntry {
+    id: string;
+    timestamp: number;
+    provider: string;
+    model: string;
+    sessionID: string;
+    agent?: string;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+    reasoningTokens?: number;
+    cost?: number;
+    requestID?: string;
+    statusCode?: number;
+    latency?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,SAAS,0IAcZ,CAAA;AAEV,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAA;AAEjD,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,OAAO,CAAA;IACnB,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,GAAG,EAAE,MAAM,CAAA;IACX,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IACrB,WAAW,EAAE,eAAe,EAAE,CAAA;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,aAAa,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,iBAAiB,EAAE,CAAA;IAC9B,gBAAgB,EAAE,MAAM,CAAA;IACxB,iBAAiB,EAAE,MAAM,CAAA;IACzB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAA;IACzB,OAAO,EAAE,eAAe,GAAG,IAAI,CAAA;IAC/B,SAAS,EAAE,eAAe,GAAG,IAAI,CAAA;IACjC,UAAU,EAAE,eAAe,GAAG,IAAI,CAAA;IAClC,OAAO,EAAE,eAAe,GAAG,IAAI,CAAA;IAE/B,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB"}

package/dist/types.js

@@ -0,0 +1,18 @@
+/**
+ * Core type definitions for the Usage Tracking Plugin.
+ */
+export const PlanTypes = [
+    "guest",
+    "free",
+    "go",
+    "plus",
+    "pro",
+    "free_workspace",
+    "team",
+    "business",
+    "education",
+    "quorum",
+    "k12",
+    "enterprise",
+    "edu",
+];

package/dist/ui/index.d.ts

@@ -0,0 +1,2 @@
+export { renderUsageStatus, sendStatusMessage } from "./status";
+//# sourceMappingURL=index.d.ts.map

package/dist/ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA"}

package/dist/ui/index.js

@@ -0,0 +1 @@
+export { renderUsageStatus, sendStatusMessage } from "./status";

package/dist/ui/status.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Renders usage snapshots into readable status text.
+ */
+import type { PluginInput } from "@opencode-ai/plugin";
+import type { UsageSnapshot } from "../types";
+import type { UsageState } from "../state";
+type UsageClient = PluginInput["client"];
+export declare function sendStatusMessage(options: {
+    client: UsageClient;
+    state: UsageState;
+    sessionID: string;
+    text: string;
+}): Promise<void>;
+export declare function renderUsageStatus(options: {
+    client: UsageClient;
+    state: UsageState;
+    sessionID: string;
+    snapshots: UsageSnapshot[];
+    filter?: string;
+}): Promise<void>;
+export {};
+//# sourceMappingURL=status.d.ts.map

package/dist/ui/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/ui/status.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAE1C,KAAK,WAAW,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAA;AAExC,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,MAAM,EAAE,WAAW,CAAA;IACnB,KAAK,EAAE,UAAU,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;CACb,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBhB;AA0GD,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,MAAM,EAAE,WAAW,CAAA;IACnB,KAAK,EAAE,UAAU,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,aAAa,EAAE,CAAA;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BhB"}

package/dist/ui/status.js

@@ -0,0 +1,142 @@
+/**
+ * Renders usage snapshots into readable status text.
+ */
+export async function sendStatusMessage(options) {
+    const sent = await options.client.session
+        .prompt({
+        path: { id: options.sessionID },
+        body: {
+            noReply: true,
+            agent: options.state.agent,
+            model: options.state.model,
+            parts: [{ type: "text", text: options.text, ignored: true }],
+        },
+    })
+        .then(() => true)
+        .catch(() => false);
+    if (sent)
+        return;
+    await options.client.tui
+        .showToast({
+        body: { title: "Usage Status", message: options.text, variant: "info" },
+    })
+        .catch(() => { });
+}
+function formatBar(remainingPercent) {
+    const clamped = Math.max(0, Math.min(100, remainingPercent));
+    const size = 15;
+    const filled = Math.round((clamped / 100) * size);
+    const empty = size - filled;
+    return `${"█".repeat(filled)}${"░".repeat(empty)}`;
+}
+function formatPlanType(planType) {
+    return planType
+        .replace(/_/g, " ")
+        .split(" ")
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(" ");
+}
+function formatResetTime(resetAt) {
+    const now = Math.floor(Date.now() / 1000);
+    const diff = resetAt - now;
+    if (diff <= 0)
+        return "now";
+    if (diff < 60)
+        return `${diff}s`;
+    if (diff < 3600)
+        return `${Math.ceil(diff / 60)}m`;
+    if (diff < 86400)
+        return `${Math.round(diff / 3600)}h`;
+    return `${Math.round(diff / 86400)}d`;
+}
+function formatResetSuffix(resetAt) {
+    if (!resetAt)
+        return "";
+    return ` (resets in ${formatResetTime(resetAt)})`;
+}
+function formatResetSuffixISO(isoString) {
+    try {
+        const resetAt = Math.floor(new Date(isoString).getTime() / 1000);
+        return ` (resets in ${formatResetTime(resetAt)})`;
+    }
+    catch {
+        return "";
+    }
+}
+function formatProxySnapshot(snapshot) {
+    const proxy = snapshot.proxyQuota;
+    if (!proxy)
+        return ["→ [proxy] No data"];
+    const lines = ["→ [Google] Mirrowel Proxy"];
+    for (const provider of proxy.providers) {
+        lines.push("");
+        lines.push(`  ${provider.name}:`);
+        for (const tierInfo of provider.tiers) {
+            const tierLabel = tierInfo.tier === "paid" ? "Paid" : "Free";
+            lines.push(`    ${tierLabel}:`);
+            for (const group of tierInfo.quotaGroups) {
+                const resetSuffix = group.resetTime ? formatResetSuffixISO(group.resetTime) : "";
+                const label = `${group.name}:`.padEnd(9);
+                lines.push(`      ${label} ${formatBar(group.remainingPct)} ${group.remaining}/${group.max}${resetSuffix}`);
+            }
+        }
+    }
+    return lines;
+}
+function formatSnapshot(snapshot) {
+    if (snapshot.provider === "proxy" && snapshot.proxyQuota) {
+        return formatProxySnapshot(snapshot);
+    }
+    const plan = snapshot.planType ? ` (${formatPlanType(snapshot.planType)})` : "";
+    const lines = [`→ [${snapshot.provider.toUpperCase()}]${plan}`];
+    const primary = snapshot.primary;
+    if (primary) {
+        const remainingPct = 100 - primary.usedPercent;
+        const label = "Hourly:".padEnd(13);
+        lines.push(`  ${label} ${formatBar(remainingPct)} ${remainingPct.toFixed(0)}% left${formatResetSuffix(primary.resetsAt)}`);
+    }
+    const secondary = snapshot.secondary;
+    if (secondary) {
+        const remainingPct = 100 - secondary.usedPercent;
+        const label = "Weekly:".padEnd(13);
+        lines.push(`  ${label} ${formatBar(remainingPct)} ${remainingPct.toFixed(0)}% left${formatResetSuffix(secondary.resetsAt)}`);
+    }
+    const codeReview = snapshot.codeReview;
+    if (codeReview) {
+        const remainingPct = 100 - codeReview.usedPercent;
+        const label = "Code Review:".padEnd(13);
+        lines.push(`  ${label} ${formatBar(remainingPct)} ${remainingPct.toFixed(0)}% left${formatResetSuffix(codeReview.resetsAt)}`);
+    }
+    if (snapshot.credits?.hasCredits) {
+        lines.push(`  Credits:      ${snapshot.credits.balance}`);
+    }
+    return lines;
+}
+export async function renderUsageStatus(options) {
+    if (options.snapshots.length === 0) {
+        const filterMsg = options.filter ? ` for "${options.filter}"` : "";
+        await sendStatusMessage({
+            client: options.client,
+            state: options.state,
+            sessionID: options.sessionID,
+            text: `▣ Usage | No data received${filterMsg}.`,
+        });
+        return;
+    }
+    const lines = ["▣ Usage Status", ""];
+    options.snapshots.forEach((snapshot, index) => {
+        const snapshotLines = formatSnapshot(snapshot);
+        for (const line of snapshotLines)
+            lines.push(line);
+        if (index < options.snapshots.length - 1) {
+            lines.push("");
+            lines.push("---");
+        }
+    });
+    await sendStatusMessage({
+        client: options.client,
+        state: options.state,
+        sessionID: options.sessionID,
+        text: lines.join("\n"),
+    });
+}

package/dist/usage/fetch.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Loads auth data and fetches live usage snapshots from providers.
+ * Supports filtering by provider alias.
+ */
+import type { UsageSnapshot } from "../types";
+import type { AuthRecord } from "./registry";
+export declare const providerAliases: Record<string, string>;
+export declare function resolveProviderFilter(filter?: string): string | undefined;
+export declare function fetchUsageSnapshots(filter?: string): Promise<UsageSnapshot[]>;
+export declare function loadAuths(): Promise<AuthRecord>;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/usage/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/usage/fetch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAG7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAe5C,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQlD,CAAA;AAED,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIzE;AAED,wBAAsB,mBAAmB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAiCnF;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC,CASrD"}

package/dist/usage/fetch.js

@@ -0,0 +1,80 @@
+/**
+ * Loads auth data and fetches live usage snapshots from providers.
+ * Supports filtering by provider alias.
+ */
+import z from "zod";
+import { providers } from "../providers";
+import { getAuthFilePath } from "../utils";
+import { resolveProviderAuths } from "./registry";
+const authEntrySchema = z
+    .object({
+    type: z.string().optional(),
+    access: z.string().optional(),
+    refresh: z.string().optional(),
+    enterpriseUrl: z.string().optional(),
+    accountId: z.string().optional(),
+})
+    .passthrough();
+const authRecordSchema = z.record(z.string(), authEntrySchema);
+export const providerAliases = {
+    codex: "codex",
+    openai: "codex",
+    gpt: "codex",
+    proxy: "proxy",
+    agy: "proxy",
+    antigravity: "proxy",
+    gemini: "proxy",
+};
+export function resolveProviderFilter(filter) {
+    if (!filter)
+        return undefined;
+    const normalized = filter.toLowerCase().trim();
+    return providerAliases[normalized];
+}
+export async function fetchUsageSnapshots(filter) {
+    const targetProvider = resolveProviderFilter(filter);
+    const auths = await loadAuths();
+    const entries = resolveProviderAuths(auths, null);
+    const snapshots = [];
+    // Fetch from auth-based providers
+    const fetches = entries
+        .filter((entry) => !targetProvider || entry.providerID === targetProvider)
+        .map(async (entry) => {
+        const provider = providers[entry.providerID];
+        if (!provider?.fetchUsage)
+            return;
+        const snapshot = await provider.fetchUsage(entry.auth).catch(() => null);
+        if (snapshot)
+            snapshots.push(snapshot);
+    });
+    // Always include proxy if no filter or filter matches proxy
+    if (!targetProvider || targetProvider === "proxy") {
+        const proxyProvider = providers["proxy"];
+        if (proxyProvider?.fetchUsage) {
+            fetches.push(proxyProvider
+                .fetchUsage(undefined)
+                .then((snapshot) => {
+                if (snapshot)
+                    snapshots.push(snapshot);
+            })
+                .catch(() => { }));
+        }
+    }
+    await Promise.race([Promise.all(fetches), timeout(5000)]);
+    return snapshots;
+}
+export async function loadAuths() {
+    const authPath = getAuthFilePath();
+    const data = await Bun.file(authPath)
+        .json()
+        .catch(() => ({}));
+    if (!data || typeof data !== "object")
+        return {};
+    const parsed = authRecordSchema.safeParse(data);
+    if (!parsed.success)
+        return {};
+    return parsed.data;
+}
+function timeout(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}

package/dist/usage/index.d.ts

@@ -0,0 +1,2 @@
+export { fetchUsageSnapshots, resolveProviderFilter } from "./fetch";
+//# sourceMappingURL=index.d.ts.map

package/dist/usage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/usage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA"}

package/dist/usage/index.js

@@ -0,0 +1 @@
+export { fetchUsageSnapshots, resolveProviderFilter } from "./fetch";

package/dist/usage/registry.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Resolves provider auth entries for usage snapshots.
+ */
+import type { CodexAuth } from "../providers/codex";
+export type AuthEntry = {
+    type?: string;
+    access?: string;
+    refresh?: string;
+    enterpriseUrl?: string;
+    accountId?: string;
+};
+export type AuthRecord = Record<string, AuthEntry>;
+type ProviderAuthEntry = {
+    providerID: "codex";
+    auth: CodexAuth;
+};
+export declare function resolveProviderAuths(auths: AuthRecord, usageToken: string | null): ProviderAuthEntry[];
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist/usage/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/usage/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAEnD,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;AAElD,KAAK,iBAAiB,GAClB;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAA;AAqB5C,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,iBAAiB,EAAE,CActG"}

package/dist/usage/registry.js

@@ -0,0 +1,30 @@
+/**
+ * Resolves provider auth entries for usage snapshots.
+ */
+const providerDescriptors = [
+    {
+        id: "codex",
+        authKeys: ["codex", "openai"],
+        requiresOAuth: true,
+        buildAuth: (entry) => ({
+            access: entry.access,
+            accountId: entry.accountId,
+        }),
+    },
+];
+export function resolveProviderAuths(auths, usageToken) {
+    const entries = [];
+    for (const descriptor of providerDescriptors) {
+        const matched = descriptor.authKeys.find((key) => Boolean(auths[key]));
+        if (!matched)
+            continue;
+        const auth = auths[matched];
+        if (!auth)
+            continue;
+        if (descriptor.requiresOAuth && auth.type && auth.type !== "oauth")
+            continue;
+        const built = descriptor.buildAuth(auth, usageToken);
+        entries.push({ providerID: descriptor.id, auth: built });
+    }
+    return entries;
+}

package/dist/utils/headers.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Parses numeric and boolean headers from usage responses.
+ * Keeps header parsing consistent across providers.
+ */
+export declare function parseNumberHeader(headers: Headers, name: string): number | null;
+export declare function parseIntegerHeader(headers: Headers, name: string): number | null;
+export declare function parseBooleanHeader(headers: Headers, name: string): boolean | null;
+//# sourceMappingURL=headers.d.ts.map

package/dist/utils/headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.d.ts","sourceRoot":"","sources":["../../src/utils/headers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM/E;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMhF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAOjF"}

package/dist/utils/headers.js

@@ -0,0 +1,33 @@
+/**
+ * Parses numeric and boolean headers from usage responses.
+ * Keeps header parsing consistent across providers.
+ */
+export function parseNumberHeader(headers, name) {
+    const value = headers.get(name);
+    if (!value)
+        return null;
+    const parsed = Number.parseFloat(value);
+    if (Number.isNaN(parsed))
+        return null;
+    return parsed;
+}
+export function parseIntegerHeader(headers, name) {
+    const value = headers.get(name);
+    if (!value)
+        return null;
+    const parsed = Number.parseInt(value, 10);
+    if (Number.isNaN(parsed))
+        return null;
+    return parsed;
+}
+export function parseBooleanHeader(headers, name) {
+    const value = headers.get(name);
+    if (!value)
+        return null;
+    const normalized = value.toLowerCase();
+    if (normalized === "true" || normalized === "1")
+        return true;
+    if (normalized === "false" || normalized === "0")
+        return false;
+    return null;
+}

package/dist/utils/index.d.ts

@@ -0,0 +1,3 @@
+export { parseBooleanHeader, parseIntegerHeader, parseNumberHeader } from "./headers";
+export { getAppDataPath, getAuthFilePath } from "./paths";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AACrF,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA"}

package/dist/utils/index.js

@@ -0,0 +1,2 @@
+export { parseBooleanHeader, parseIntegerHeader, parseNumberHeader } from "./headers";
+export { getAppDataPath, getAuthFilePath } from "./paths";

package/dist/utils/paths.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Resolves filesystem locations for OpenCode data files.
+ * Centralizes platform-specific paths so callers stay simple and consistent.
+ */
+export declare function getAppDataPath(): string;
+export declare function getAuthFilePath(): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,wBAAgB,cAAc,IAAI,MAAM,CAiBvC;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC"}

package/dist/utils/paths.js

@@ -0,0 +1,24 @@
+/**
+ * Resolves filesystem locations for OpenCode data files.
+ * Centralizes platform-specific paths so callers stay simple and consistent.
+ */
+import { homedir, platform } from "os";
+import { join } from "path";
+export function getAppDataPath() {
+    const plat = platform();
+    const home = homedir();
+    if (plat === "darwin") {
+        return join(home, "Library", "Application Support", "opencode");
+    }
+    if (plat === "win32") {
+        return join(process.env.APPDATA || join(home, "AppData", "Roaming"), "opencode");
+    }
+    const xdgData = process.env.XDG_DATA_HOME;
+    if (xdgData) {
+        return join(xdgData, "opencode");
+    }
+    return join(home, ".local", "share", "opencode");
+}
+export function getAuthFilePath() {
+    return join(getAppDataPath(), "auth.json");
+}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@howaboua/opencode-usage-plugin",
+  "version": "0.0.1",
+  "description": "OpenCode plugin for tracking AI provider usage, rate limits, and quotas",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": ["dist", "README.md", "LICENSE"],
+  "keywords": ["opencode", "opencode-plugin", "plugin", "usage", "tracking", "rate-limit"],
+  "license": "MIT",
+  "peerDependencies": {
+    "@opencode-ai/plugin": "^1.0.0"
+  },
+  "devDependencies": {
+    "@opencode-ai/plugin": "^1.0.0",
+    "@types/bun": "^1.2.0",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "npm run clean && tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}