@kunal_dutt/token-lens 0.2.25 → 0.2.27

package/types/src/core/compare.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Check a prompt someone shortened by hand (or with another tool) against the
+ * original: tokens and money saved, and whether anything that steers the
+ * answer went missing. Uses the same meaning guard as Token Lens's own
+ * rewrites, so a hand edit is held to the same bar.
+ */
+import { type Savings } from "./cost";
+import type { ModelProfile } from "./models";
+export interface PromptComparison {
+    before: number;
+    after: number;
+    /** Positive when the edit is shorter. */
+    saved: Savings;
+    /** True when every number, URL, code span, quote, negation, constraint and instruction word is kept. */
+    sameInstructions: boolean;
+    /** Facts or constraints the edit dropped, e.g. "negation: not", "number: 30". */
+    lostFacts: string[];
+    /** Content words the edit dropped (beyond politeness and filler). */
+    lostWords: string[];
+    verdict: string;
+}
+export declare function comparePrompts(original: string, edited: string, profile: ModelProfile): PromptComparison;

package/types/src/core/data.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Lossless compaction of pasted data. Pretty-printed JSON spends many tokens
+ * on indentation and line breaks the model doesn't need: the same values,
+ * keys and order fit in far fewer tokens. Only whitespace outside JSON strings
+ * is removed, and each block is proven identical by parsing both versions.
+ * Outside code fences, trailing spaces and runs of blank lines go too;
+ * indentation and every other character stay as written.
+ *
+ * Skipped when the request is about formatting itself (indent, pretty-print,
+ * whitespace), since there the layout is the subject.
+ */
+import type { ModelProfile } from "./models";
+export interface DataBlock {
+    kind: "json";
+    /** Where it was found: "whole text", "```json block 2", "lines 4-31". */
+    where: string;
+    tokens: number;
+    compactTokens: number;
+}
+export interface CompactResult {
+    text: string;
+    before: number;
+    after: number;
+    saved: number;
+    blocks: DataBlock[];
+    /** Plain-words list of what changed. */
+    changes: string[];
+    /** Evidence: each JSON block parses to the same value before and after. */
+    checks: Array<{
+        name: string;
+        passed: boolean;
+        detail: string;
+    }>;
+    /** Why nothing was compacted, when that's the case. */
+    skipped?: string;
+}
+/** Removes whitespace outside JSON strings. Every other character stays, in order. */
+export declare function minifyJson(src: string): string;
+export declare function compactData(text: string, profile: ModelProfile): CompactResult;

package/types/src/core/forecast.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Monthly cost forecast for an app or agent on the model it already uses, and
+ * what the same-answer options cut from it: prompt caching for the part every
+ * call repeats, and the provider's half-price batch option for work that can
+ * wait. Never a different model. Long-context pricing applies when a call's
+ * input passes the model's price step.
+ */
+import type { ModelProfile } from "./models";
+export interface ForecastInput {
+    /** Input tokens per call, including the repeated part. */
+    inputTokens: number;
+    /** Output tokens per call (the answer, plus reasoning tokens on thinking models). */
+    outputTokens: number;
+    callsPerDay: number;
+    /** Tokens at the start of every call that never change (system prompt, tools, examples). */
+    repeatedPrefixTokens?: number;
+    /** Share of calls that can wait up to 24 hours for the answer (0 to 1). */
+    canWaitShare?: number;
+    /** Days per month, default 30. */
+    days?: number;
+}
+export interface ForecastLine {
+    id: "now" | "caching" | "batch" | "both";
+    label: string;
+    monthlyUsd: number;
+    savedUsd: number;
+    note: string;
+}
+export interface Forecast {
+    priced: boolean;
+    callsPerMonth: number;
+    longContext: boolean;
+    /** Rates used, USD per 1M tokens. */
+    rates: {
+        input: number;
+        output: number;
+        cached: number | null;
+    };
+    lines: ForecastLine[];
+}
+/** Providers whose own API has a half-price batch option on the same model. */
+export declare const BATCH_FAMILIES: Set<string>;
+export declare function forecastCost(profile: ModelProfile, f: ForecastInput): Forecast;

package/types/src/core/index.d.ts

@@ -12,6 +12,9 @@ export * from "./advice";
 export * from "./budget";
 export * from "./compress";
 export * from "./cost";
+export * from "./compare";
+export * from "./data";
+export * from "./forecast";
 export * from "./guard";
 export * from "./hotspots";
 export * from "./media";