claude-accountant 1.0.0

package/dist/tools/estimate-task-cost.d.ts

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import type { Config } from "../types.js";
+export declare const estimateTaskCostSchema: z.ZodObject<{
+    task_description: z.ZodString;
+    complexity: z.ZodOptional<z.ZodEnum<["trivial", "simple", "moderate", "complex", "massive"]>>;
+    file_count: z.ZodDefault<z.ZodNumber>;
+    model: z.ZodOptional<z.ZodString>;
+    extended_thinking: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    task_description: string;
+    file_count: number;
+    extended_thinking: boolean;
+    complexity?: "trivial" | "simple" | "moderate" | "complex" | "massive" | undefined;
+    model?: string | undefined;
+}, {
+    task_description: string;
+    complexity?: "trivial" | "simple" | "moderate" | "complex" | "massive" | undefined;
+    file_count?: number | undefined;
+    model?: string | undefined;
+    extended_thinking?: boolean | undefined;
+}>;
+export type EstimateTaskCostInput = z.infer<typeof estimateTaskCostSchema>;
+export declare function estimateTaskCostTool(config: Config, input: EstimateTaskCostInput): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    data: import("../types.js").CostEstimate;
+};
+//# sourceMappingURL=estimate-task-cost.d.ts.map

package/dist/tools/estimate-task-cost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimate-task-cost.d.ts","sourceRoot":"","sources":["../../src/tools/estimate-task-cost.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAkB,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;EAiBjC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE3E,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,qBAAqB;;;;;;EA0B7B"}

package/dist/tools/estimate-task-cost.js

@@ -0,0 +1,37 @@
+import { z } from "zod";
+import { estimateTaskCost, inferComplexity } from "../estimator.js";
+export const estimateTaskCostSchema = z.object({
+    task_description: z.string().describe("Brief description of the planned task"),
+    complexity: z
+        .enum(["trivial", "simple", "moderate", "complex", "massive"])
+        .optional()
+        .describe("Override complexity tier (auto-detected if omitted)"),
+    file_count: z
+        .number()
+        .int()
+        .min(0)
+        .default(0)
+        .describe("Number of files involved"),
+    model: z.string().optional().describe("Model to use for cost calculation"),
+    extended_thinking: z
+        .boolean()
+        .default(false)
+        .describe("Whether extended thinking will be used"),
+});
+export function estimateTaskCostTool(config, input) {
+    const complexity = input.complexity ?? inferComplexity(input.task_description);
+    const model = input.model ?? config.default_model;
+    const estimate = estimateTaskCost(model, complexity, input.file_count, config.budget.daily_limit_usd, input.extended_thinking);
+    const lines = [
+        `Task: ${input.task_description}`,
+        `Model: ${model}`,
+        estimate.breakdown,
+        `Estimated Cost: $${estimate.estimated_cost_usd.toFixed(4)}`,
+        `% of Daily Budget: ${estimate.pct_of_daily_budget.toFixed(2)}%`,
+    ];
+    return {
+        content: [{ type: "text", text: lines.join("\n") }],
+        data: estimate,
+    };
+}
+//# sourceMappingURL=estimate-task-cost.js.map

package/dist/tools/estimate-task-cost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimate-task-cost.js","sourceRoot":"","sources":["../../src/tools/estimate-task-cost.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEpE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IAC9E,UAAU,EAAE,CAAC;SACV,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;SAC7D,QAAQ,EAAE;SACV,QAAQ,CAAC,qDAAqD,CAAC;IAClE,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,OAAO,CAAC,CAAC,CAAC;SACV,QAAQ,CAAC,0BAA0B,CAAC;IACvC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAC1E,iBAAiB,EAAE,CAAC;SACjB,OAAO,EAAE;SACT,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,wCAAwC,CAAC;CACtD,CAAC,CAAC;AAIH,MAAM,UAAU,oBAAoB,CAClC,MAAc,EACd,KAA4B;IAE5B,MAAM,UAAU,GACd,KAAK,CAAC,UAAU,IAAI,eAAe,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,aAAa,CAAC;IAElD,MAAM,QAAQ,GAAG,gBAAgB,CAC/B,KAAK,EACL,UAAU,EACV,KAAK,CAAC,UAAU,EAChB,MAAM,CAAC,MAAM,CAAC,eAAe,EAC7B,KAAK,CAAC,iBAAiB,CACxB,CAAC;IAEF,MAAM,KAAK,GAAG;QACZ,SAAS,KAAK,CAAC,gBAAgB,EAAE;QACjC,UAAU,KAAK,EAAE;QACjB,QAAQ,CAAC,SAAS;QAClB,oBAAoB,QAAQ,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;QAC5D,sBAAsB,QAAQ,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;KACjE,CAAC;IAEF,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5D,IAAI,EAAE,QAAQ;KACf,CAAC;AACJ,CAAC"}

package/dist/tools/get-recommendations.d.ts

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import type { Config } from "../types.js";
+export declare const getRecommendationsSchema: z.ZodObject<{
+    current_model: z.ZodOptional<z.ZodString>;
+    task_complexity: z.ZodOptional<z.ZodEnum<["trivial", "simple", "moderate", "complex", "massive"]>>;
+    is_urgent: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    is_urgent: boolean;
+    current_model?: string | undefined;
+    task_complexity?: "trivial" | "simple" | "moderate" | "complex" | "massive" | undefined;
+}, {
+    current_model?: string | undefined;
+    task_complexity?: "trivial" | "simple" | "moderate" | "complex" | "massive" | undefined;
+    is_urgent?: boolean | undefined;
+}>;
+export type GetRecommendationsInput = z.infer<typeof getRecommendationsSchema>;
+export declare function getRecommendationsTool(config: Config, input: GetRecommendationsInput): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    data: {
+        recommendations: import("../types.js").Recommendation[];
+        budget_status: import("../types.js").BudgetStatus;
+    };
+};
+//# sourceMappingURL=get-recommendations.d.ts.map

package/dist/tools/get-recommendations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-recommendations.d.ts","sourceRoot":"","sources":["../../src/tools/get-recommendations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAI1C,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAanC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE/E,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,uBAAuB;;;;;;;;;EAwC/B"}

package/dist/tools/get-recommendations.js

@@ -0,0 +1,47 @@
+import { z } from "zod";
+import { getBudgetStatus } from "../budget.js";
+import { getRecommendations } from "../offload.js";
+export const getRecommendationsSchema = z.object({
+    current_model: z
+        .string()
+        .optional()
+        .describe("Model currently being used"),
+    task_complexity: z
+        .enum(["trivial", "simple", "moderate", "complex", "massive"])
+        .optional()
+        .describe("Complexity of the planned task"),
+    is_urgent: z
+        .boolean()
+        .default(true)
+        .describe("Whether the current task is time-sensitive"),
+});
+export function getRecommendationsTool(config, input) {
+    const budget = getBudgetStatus(config);
+    const model = input.current_model ?? config.default_model;
+    const recs = getRecommendations(budget, model, input.task_complexity, input.is_urgent);
+    if (recs.length === 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "No cost-saving recommendations at this time. Budget usage is healthy.",
+                },
+            ],
+            data: { recommendations: [], budget_status: budget.status },
+        };
+    }
+    const lines = [
+        `Budget: ${budget.pct_used.toFixed(1)}% used ($${budget.spent_today_usd.toFixed(4)} / $${budget.daily_limit_usd.toFixed(2)})`,
+        "",
+        "Recommendations:",
+    ];
+    for (const rec of recs) {
+        lines.push(`[${rec.priority.toUpperCase()}] ${rec.action} (~${rec.estimated_savings_pct}% savings)`);
+        lines.push(`  ${rec.description}`);
+    }
+    return {
+        content: [{ type: "text", text: lines.join("\n") }],
+        data: { recommendations: recs, budget_status: budget.status },
+    };
+}
+//# sourceMappingURL=get-recommendations.js.map

package/dist/tools/get-recommendations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-recommendations.js","sourceRoot":"","sources":["../../src/tools/get-recommendations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,4BAA4B,CAAC;IACzC,eAAe,EAAE,CAAC;SACf,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;SAC7D,QAAQ,EAAE;SACV,QAAQ,CAAC,gCAAgC,CAAC;IAC7C,SAAS,EAAE,CAAC;SACT,OAAO,EAAE;SACT,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,4CAA4C,CAAC;CAC1D,CAAC,CAAC;AAIH,MAAM,UAAU,sBAAsB,CACpC,MAAc,EACd,KAA8B;IAE9B,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,KAAK,CAAC,aAAa,IAAI,MAAM,CAAC,aAAa,CAAC;IAC1D,MAAM,IAAI,GAAG,kBAAkB,CAC7B,MAAM,EACN,KAAK,EACL,KAAK,CAAC,eAAe,EACrB,KAAK,CAAC,SAAS,CAChB,CAAC;IAEF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,uEAAuE;iBAC9E;aACF;YACD,IAAI,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE;SAC5D,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG;QACZ,WAAW,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;QAC7H,EAAE;QACF,kBAAkB;KACnB,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CACR,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,MAAM,MAAM,GAAG,CAAC,qBAAqB,YAAY,CACzF,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5D,IAAI,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE;KAC9D,CAAC;AACJ,CAAC"}

package/dist/tools/get-usage-history.d.ts

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import type { Config } from "../types.js";
+export declare const getUsageHistorySchema: z.ZodObject<{
+    days: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    days: number;
+}, {
+    days?: number | undefined;
+}>;
+export type GetUsageHistoryInput = z.infer<typeof getUsageHistorySchema>;
+export declare function getUsageHistoryTool(config: Config, input: GetUsageHistoryInput): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    data: {
+        history: never[];
+        trend: null;
+        total_cost?: undefined;
+        avg_daily?: undefined;
+    };
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    data: {
+        history: import("../types.js").DailySummary[];
+        total_cost: number;
+        avg_daily: number;
+        trend?: undefined;
+    };
+};
+//# sourceMappingURL=get-usage-history.d.ts.map

package/dist/tools/get-usage-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-usage-history.d.ts","sourceRoot":"","sources":["../../src/tools/get-usage-history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,eAAO,MAAM,qBAAqB;;;;;;EAQhC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEzE,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,oBAAoB;;;;;;;;;;;;;;;;;;;;;;EAsC5B"}

package/dist/tools/get-usage-history.js

@@ -0,0 +1,42 @@
+import { z } from "zod";
+import { getUsageHistory } from "../db.js";
+export const getUsageHistorySchema = z.object({
+    days: z
+        .number()
+        .int()
+        .min(1)
+        .max(90)
+        .default(7)
+        .describe("Number of days of history to retrieve"),
+});
+export function getUsageHistoryTool(config, input) {
+    const history = getUsageHistory(config, input.days);
+    if (history.length === 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `No usage data found for the past ${input.days} days.`,
+                },
+            ],
+            data: { history: [], trend: null },
+        };
+    }
+    const totalCost = history.reduce((sum, d) => sum + d.total_cost_usd, 0);
+    const avgDaily = totalCost / history.length;
+    const lines = [
+        `Usage History (past ${input.days} days, ${history.length} days with data):`,
+        "",
+    ];
+    for (const day of history) {
+        lines.push(`${day.date}: $${day.total_cost_usd.toFixed(4)} (${day.request_count} requests, ${(day.total_input_tokens + day.total_output_tokens).toLocaleString()} tokens)`);
+    }
+    lines.push("");
+    lines.push(`Total: $${totalCost.toFixed(4)}`);
+    lines.push(`Daily Average: $${avgDaily.toFixed(4)}`);
+    return {
+        content: [{ type: "text", text: lines.join("\n") }],
+        data: { history, total_cost: totalCost, avg_daily: avgDaily },
+    };
+}
+//# sourceMappingURL=get-usage-history.js.map

package/dist/tools/get-usage-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-usage-history.js","sourceRoot":"","sources":["../../src/tools/get-usage-history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,OAAO,CAAC,CAAC,CAAC;SACV,QAAQ,CAAC,uCAAuC,CAAC;CACrD,CAAC,CAAC;AAIH,MAAM,UAAU,mBAAmB,CACjC,MAAc,EACd,KAA2B;IAE3B,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAEpD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,oCAAoC,KAAK,CAAC,IAAI,QAAQ;iBAC7D;aACF;YACD,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;SACnC,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;IACxE,MAAM,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAE5C,MAAM,KAAK,GAAG;QACZ,uBAAuB,KAAK,CAAC,IAAI,UAAU,OAAO,CAAC,MAAM,mBAAmB;QAC5E,EAAE;KACH,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CACR,GAAG,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,aAAa,cAAc,CAAC,GAAG,CAAC,kBAAkB,GAAG,GAAG,CAAC,mBAAmB,CAAC,CAAC,cAAc,EAAE,UAAU,CAChK,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,WAAW,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC9C,KAAK,CAAC,IAAI,CAAC,mBAAmB,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAErD,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5D,IAAI,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE;KAC9D,CAAC;AACJ,CAAC"}

package/dist/tools/log-usage.d.ts

@@ -0,0 +1,42 @@
+import { z } from "zod";
+import type { Config } from "../types.js";
+export declare const logUsageSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    model: z.ZodOptional<z.ZodString>;
+    input_tokens: z.ZodNumber;
+    output_tokens: z.ZodNumber;
+    cache_read_tokens: z.ZodDefault<z.ZodNumber>;
+    cache_write_tokens: z.ZodDefault<z.ZodNumber>;
+    task_description: z.ZodDefault<z.ZodString>;
+    source: z.ZodDefault<z.ZodEnum<["estimate", "admin_api", "hook", "manual"]>>;
+}, "strip", z.ZodTypeAny, {
+    task_description: string;
+    session_id: string;
+    input_tokens: number;
+    output_tokens: number;
+    cache_read_tokens: number;
+    cache_write_tokens: number;
+    source: "estimate" | "admin_api" | "hook" | "manual";
+    model?: string | undefined;
+}, {
+    session_id: string;
+    input_tokens: number;
+    output_tokens: number;
+    task_description?: string | undefined;
+    model?: string | undefined;
+    cache_read_tokens?: number | undefined;
+    cache_write_tokens?: number | undefined;
+    source?: "estimate" | "admin_api" | "hook" | "manual" | undefined;
+}>;
+export type LogUsageInput = z.infer<typeof logUsageSchema>;
+export declare function logUsageTool(config: Config, input: LogUsageInput): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    data: {
+        cost: number;
+        model: string;
+    };
+};
+//# sourceMappingURL=log-usage.d.ts.map

package/dist/tools/log-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-usage.d.ts","sourceRoot":"","sources":["../../src/tools/log-usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,EAAe,MAAM,aAAa,CAAC;AAIvD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYzB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE3D,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa;;;;;;;;;EAgChE"}

package/dist/tools/log-usage.js

@@ -0,0 +1,42 @@
+import { z } from "zod";
+import { logUsage } from "../db.js";
+import { calculateCost } from "../pricing.js";
+export const logUsageSchema = z.object({
+    session_id: z.string().describe("Current session identifier"),
+    model: z.string().optional().describe("Model used (defaults to config default)"),
+    input_tokens: z.number().int().min(0).describe("Input tokens consumed"),
+    output_tokens: z.number().int().min(0).describe("Output tokens consumed"),
+    cache_read_tokens: z.number().int().min(0).default(0),
+    cache_write_tokens: z.number().int().min(0).default(0),
+    task_description: z.string().default("").describe("What was done"),
+    source: z
+        .enum(["estimate", "admin_api", "hook", "manual"])
+        .default("estimate")
+        .describe("Source of token counts"),
+});
+export function logUsageTool(config, input) {
+    const model = input.model ?? config.default_model;
+    const cost = calculateCost(model, input.input_tokens, input.output_tokens, input.cache_read_tokens, input.cache_write_tokens);
+    logUsage(config, {
+        timestamp: new Date().toISOString(),
+        session_id: input.session_id,
+        model,
+        input_tokens: input.input_tokens,
+        output_tokens: input.output_tokens,
+        cache_read_tokens: input.cache_read_tokens,
+        cache_write_tokens: input.cache_write_tokens,
+        estimated_cost_usd: cost,
+        task_description: input.task_description,
+        source: input.source,
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Logged: ${input.input_tokens} input + ${input.output_tokens} output tokens ($${cost.toFixed(4)})`,
+            },
+        ],
+        data: { cost, model },
+    };
+}
+//# sourceMappingURL=log-usage.js.map

package/dist/tools/log-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-usage.js","sourceRoot":"","sources":["../../src/tools/log-usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IAC7D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IAChF,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IACvE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IACzE,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrD,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACtD,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC;IAClE,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;SACjD,OAAO,CAAC,UAAU,CAAC;SACnB,QAAQ,CAAC,wBAAwB,CAAC;CACtC,CAAC,CAAC;AAIH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,KAAoB;IAC/D,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,aAAa,CAAC;IAClD,MAAM,IAAI,GAAG,aAAa,CACxB,KAAK,EACL,KAAK,CAAC,YAAY,EAClB,KAAK,CAAC,aAAa,EACnB,KAAK,CAAC,iBAAiB,EACvB,KAAK,CAAC,kBAAkB,CACzB,CAAC;IAEF,QAAQ,CAAC,MAAM,EAAE;QACf,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,KAAK;QACL,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;QAC1C,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,kBAAkB,EAAE,IAAI;QACxB,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;QACxC,MAAM,EAAE,KAAK,CAAC,MAAqB;KACpC,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,WAAW,KAAK,CAAC,YAAY,YAAY,KAAK,CAAC,aAAa,oBAAoB,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;aACzG;SACF;QACD,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE;KACtB,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,73 @@
+export type BudgetStatus = "ok" | "warning" | "critical" | "exceeded";
+export type ComplexityTier = "trivial" | "simple" | "moderate" | "complex" | "massive";
+export type UsageSource = "estimate" | "admin_api" | "hook" | "manual";
+export interface Config {
+    budget: {
+        daily_limit_usd: number;
+        monthly_limit_usd: number | null;
+        warning_threshold_pct: number;
+        critical_threshold_pct: number;
+    };
+    pricing_tier: string;
+    default_model: string;
+    data_dir: string;
+    admin_api?: {
+        api_key: string;
+        organization_id: string;
+        sync_interval_minutes: number;
+    };
+}
+export interface UsageLogEntry {
+    id?: number;
+    timestamp: string;
+    session_id: string;
+    model: string;
+    input_tokens: number;
+    output_tokens: number;
+    cache_read_tokens: number;
+    cache_write_tokens: number;
+    estimated_cost_usd: number;
+    task_description: string;
+    source: UsageSource;
+}
+export interface DailySummary {
+    date: string;
+    total_input_tokens: number;
+    total_output_tokens: number;
+    total_cache_read_tokens: number;
+    total_cache_write_tokens: number;
+    total_cost_usd: number;
+    request_count: number;
+}
+export interface BudgetSnapshot {
+    status: BudgetStatus;
+    daily_limit_usd: number;
+    spent_today_usd: number;
+    remaining_usd: number;
+    pct_used: number;
+    request_count_today: number;
+    monthly_limit_usd: number | null;
+    spent_this_month_usd: number | null;
+}
+export interface CostEstimate {
+    estimated_input_tokens: number;
+    estimated_output_tokens: number;
+    estimated_cost_usd: number;
+    pct_of_daily_budget: number;
+    complexity: ComplexityTier;
+    breakdown: string;
+}
+export interface Recommendation {
+    action: string;
+    description: string;
+    estimated_savings_pct: number;
+    priority: "low" | "medium" | "high";
+}
+export interface ModelPricing {
+    model: string;
+    input_per_mtok: number;
+    output_per_mtok: number;
+    cache_read_per_mtok: number;
+    cache_write_per_mtok: 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,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAEtE,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,QAAQ,GACR,UAAU,GACV,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEvE,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE;QACN,eAAe,EAAE,MAAM,CAAC;QACxB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;QACjC,qBAAqB,EAAE,MAAM,CAAC;QAC9B,sBAAsB,EAAE,MAAM,CAAC;KAChC,CAAC;IACF,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE;QACV,OAAO,EAAE,MAAM,CAAC;QAChB,eAAe,EAAE,MAAM,CAAC;QACxB,qBAAqB,EAAE,MAAM,CAAC;KAC/B,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uBAAuB,EAAE,MAAM,CAAC;IAChC,wBAAwB,EAAE,MAAM,CAAC;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,YAAY,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,YAAY;IAC3B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,uBAAuB,EAAE,MAAM,CAAC;IAChC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,cAAc,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oBAAoB,EAAE,MAAM,CAAC;CAC9B"}

package/dist/types.js

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

package/dist/types.js.map

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

package/hooks/hooks.json

@@ -0,0 +1,10 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": ".*",
+        "command": "bash scripts/post-tool-hook.sh \"$TOOL_NAME\" \"$SESSION_ID\""
+      }
+    ]
+  }
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "claude-accountant",
+  "version": "1.0.0",
+  "description": "Claude Code plugin that tracks API usage, estimates costs, and recommends budget-aware actions",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "claude-accountant": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "skills",
+    "hooks",
+    "scripts",
+    ".claude-plugin",
+    ".mcp.json"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "mcp",
+    "usage-tracker",
+    "budget",
+    "anthropic",
+    "plugin",
+    "model-context-protocol"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "better-sqlite3": "^11.8.1",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^22.13.1",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.5"
+  }
+}

package/scripts/post-tool-hook.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+# PostToolUse hook: logs tool invocations to JSONL for usage tracking
+# Called automatically after each tool use in Claude Code
+
+TOOL_NAME="${1:-unknown}"
+SESSION_ID="${2:-unknown}"
+TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+DATA_DIR="${HOME}/.config/usage-plugin/data"
+mkdir -p "$DATA_DIR"
+
+LOG_FILE="${DATA_DIR}/hook_events.jsonl"
+
+echo "{\"timestamp\":\"${TIMESTAMP}\",\"tool\":\"${TOOL_NAME}\",\"session_id\":\"${SESSION_ID}\"}" >> "$LOG_FILE"

package/skills/usage-awareness/SKILL.md

@@ -0,0 +1,29 @@
+# Usage Awareness Skill
+
+You have access to a usage tracking plugin. Follow these rules to stay budget-aware:
+
+## Session Start
+- Call `check_budget` at the beginning of every conversation to see how much budget remains today.
+- If budget status is "warning" or "critical", mention this to the user and adjust your approach accordingly.
+
+## Before Expensive Operations
+- Before large refactors, multi-file edits, or complex analysis, call `estimate_task_cost` with the task description and file count.
+- If the estimated cost exceeds 10% of the daily budget, inform the user and suggest alternatives.
+- Call `get_offload_recommendations` when budget is above 60% used.
+
+## After Completing Work
+- Call `log_usage` with your best estimate of tokens consumed after each significant task.
+- Use session_id to group related work within a conversation.
+- Include a brief task_description so the user can see what each charge was for.
+
+## Budget Thresholds
+- **OK** (<80%): Work normally.
+- **Warning** (80-95%): Prioritize essential tasks. Use concise responses. Suggest deferring non-urgent work.
+- **Critical** (95-100%): Only handle urgent requests. Recommend switching to a cheaper model. Strongly suggest deferring.
+- **Exceeded** (>100%): Inform the user their daily budget is spent. Suggest waiting until tomorrow or increasing the limit.
+
+## Cost-Saving Habits
+- Prefer concise answers when budget is above 60%.
+- Suggest Haiku for simple lookups and formatting tasks.
+- Recommend breaking large tasks into smaller, focused pieces.
+- Mention the Batch API for non-time-sensitive bulk operations.