@hasna/economy 0.2.43 → 0.3.1

package/dist/lib/analytics.d.ts

@@ -0,0 +1,68 @@
+import type { SqliteAdapter as Database } from '@hasna/cloud';
+export interface ProjectDetailModel {
+    model: string;
+    requests: number;
+    cost_usd: number;
+}
+export interface ProjectDetailSession {
+    id: string;
+    total_cost_usd: number;
+    started_at: string;
+}
+export interface ProjectDetail {
+    project_name: string;
+    project_path: string;
+    total_cost_usd: number;
+    total_tokens: number;
+    sessions: number;
+    daily: Array<{
+        date: string;
+        cost_usd: number;
+    }>;
+    models: ProjectDetailModel[];
+    top_sessions: ProjectDetailSession[];
+}
+/** Detailed breakdown for a single project matched by name or path substring. */
+export declare function queryProjectDetail(db: Database, nameOrPath: string): ProjectDetail | null;
+export type ExportType = 'sessions' | 'requests';
+/** Raw rows for a CSV export. CSV formatting stays in the caller. */
+export declare function queryExportRows(db: Database, type: ExportType, period: string): Array<Record<string, unknown>>;
+export interface RangeStats {
+    cost: number;
+    requests: number;
+    tokens: number;
+    sessions: number;
+}
+/** Cost/request/token/session totals for an inclusive [from,to] date range. */
+export declare function queryRangeStats(db: Database, from: string, to: string): RangeStats;
+export interface ForecastData {
+    day_of_month: number;
+    days_in_month: number;
+    spent_so_far_usd: number;
+    daily_avg_usd: number;
+    projected_usd: number;
+    last7_daily_avg_usd: number;
+    last7_projected_usd: number;
+    cheapest_day: {
+        date: string;
+        cost_usd: number;
+    } | null;
+    most_expensive_day: {
+        date: string;
+        cost_usd: number;
+    } | null;
+}
+/** End-of-month projection based on current burn rate. */
+export declare function queryForecast(db: Database, now?: Date): ForecastData;
+export interface ModelEfficiency {
+    model: string;
+    input: number;
+    output: number;
+    cache_read: number;
+    cache_write: number;
+    requests: number;
+    cost: number;
+}
+/** Per-model token efficiency (output/input ratio, cache hit %, cost/1k out). */
+export declare function queryModelEfficiency(db: Database): ModelEfficiency[];
+//# sourceMappingURL=analytics.d.ts.map

package/dist/lib/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/lib/analytics.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,cAAc,CAAA;AAI7D,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAA;IACV,cAAc,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,MAAM,CAAA;IACtB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAChD,MAAM,EAAE,kBAAkB,EAAE,CAAA;IAC5B,YAAY,EAAE,oBAAoB,EAAE,CAAA;CACrC;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAmDzF;AAID,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,UAAU,CAAA;AAWhD,qEAAqE;AACrE,wBAAgB,eAAe,CAC7B,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM,GACb,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAOhC;AAID,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,CAUlF;AAID,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,gBAAgB,EAAE,MAAM,CAAA;IACxB,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IACvD,kBAAkB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CAC9D;AAED,0DAA0D;AAC1D,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,GAAE,IAAiB,GAAG,YAAY,CAkChF;AAID,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,iFAAiF;AACjF,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,QAAQ,GAAG,eAAe,EAAE,CAWpE"}

package/dist/lib/brief.d.ts

@@ -0,0 +1,72 @@
+import type { SqliteAdapter as Database } from '@hasna/cloud';
+type BriefPeriod = 'today' | 'week';
+export interface BriefTotals {
+    sessions: number;
+    requests: number;
+    input_tokens: number;
+    output_tokens: number;
+    cache_read_tokens: number;
+    cache_create_tokens: number;
+    cache_create_5m_tokens: number;
+    cache_create_1h_tokens: number;
+    total_tokens: number;
+    cost_usd: number;
+    last_active: string | null;
+}
+export interface BriefPeriodSummary extends BriefTotals {
+    label: string;
+    period: BriefPeriod | 'since';
+    since?: string;
+}
+export interface BriefMachineRow extends BriefTotals {
+    machine_id: string;
+    last_data_at: string | null;
+    last_data_age: string;
+}
+export interface BriefAgentRow extends BriefTotals {
+    agent: string;
+}
+export interface BriefAccountRow extends BriefTotals {
+    account_key: string;
+    account_tool: string;
+    account_name: string;
+    account_email: string | null;
+    account_source: string;
+}
+export interface BriefFreshnessMachine {
+    machine_id: string;
+    max_request_at: string | null;
+    request_age: string;
+    last_merge_sync_at: string | null;
+    merge_sync_age: string;
+}
+export interface EconomyBrief {
+    generated_at: string;
+    machine: string;
+    since: {
+        input: string;
+        timestamp: string;
+        label: string;
+    };
+    summaries: BriefPeriodSummary[];
+    machines: BriefMachineRow[];
+    agents: BriefAgentRow[];
+    accounts: BriefAccountRow[];
+    freshness: {
+        machines: BriefFreshnessMachine[];
+        max_request_line: string;
+        merge_sync_line: string;
+    };
+}
+export interface BriefOptions {
+    since?: string;
+    machine?: string;
+    now?: Date;
+    currentMachineId?: string;
+    localSyncAt?: Date;
+}
+/** Human-readable age of a timestamp relative to now (never/<1m/Nm/Nh/Nd). */
+export declare function formatAge(timestamp: string | null | undefined, now: Date): string;
+export declare function buildBrief(db: Database, opts?: BriefOptions): EconomyBrief;
+export {};
+//# sourceMappingURL=brief.d.ts.map

package/dist/lib/brief.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brief.d.ts","sourceRoot":"","sources":["../../src/lib/brief.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,cAAc,CAAA;AAU7D,KAAK,WAAW,GAAG,OAAO,GAAG,MAAM,CAAA;AAEnC,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,iBAAiB,EAAE,MAAM,CAAA;IACzB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,sBAAsB,EAAE,MAAM,CAAA;IAC9B,sBAAsB,EAAE,MAAM,CAAA;IAC9B,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B;AAED,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,WAAW,GAAG,OAAO,CAAA;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,aAAc,SAAQ,WAAW;IAChD,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,WAAW,EAAE,MAAM,CAAA;IACnB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE;QACL,KAAK,EAAE,MAAM,CAAA;QACb,SAAS,EAAE,MAAM,CAAA;QACjB,KAAK,EAAE,MAAM,CAAA;KACd,CAAA;IACD,SAAS,EAAE,kBAAkB,EAAE,CAAA;IAC/B,QAAQ,EAAE,eAAe,EAAE,CAAA;IAC3B,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,QAAQ,EAAE,eAAe,EAAE,CAAA;IAC3B,SAAS,EAAE;QACT,QAAQ,EAAE,qBAAqB,EAAE,CAAA;QACjC,gBAAgB,EAAE,MAAM,CAAA;QACxB,eAAe,EAAE,MAAM,CAAA;KACxB,CAAA;CACF;AAcD,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,GAAG,CAAC,EAAE,IAAI,CAAA;IACV,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,WAAW,CAAC,EAAE,IAAI,CAAA;CACnB;AAyBD,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,EAAE,IAAI,GAAG,MAAM,CAWjF;AAsmBD,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,GAAE,YAAiB,GAAG,YAAY,CAmD9E"}

package/dist/lib/cloud-storage.d.ts

@@ -0,0 +1,48 @@
+import { resolveStorageClient, type HasnaStorageClient } from "./contracts-client/storage.js";
+/** Transport overrides (test injection: fetchImpl, headers, timeout, retry). */
+type StorageClientOverrides = Parameters<typeof resolveStorageClient>[2];
+/** The economy app slug used for the HASNA_<APP>_* env lookups. */
+export declare const ECONOMY_APP = "economy";
+export type EconomyCloudStorage = {
+    /** True when reads/writes must go to the cloud HTTP API. */
+    readonly active: true;
+    /** The ready HTTP storage client. */
+    readonly client: HasnaStorageClient;
+} | {
+    readonly active: false;
+    readonly client: null;
+};
+/**
+ * Resolve the economy client storage transport for the current environment.
+ *
+ * Returns `{ active: true, client }` only when mode=self_hosted/cloud AND
+ * HASNA_ECONOMY_API_URL + HASNA_ECONOMY_API_KEY are set. Otherwise
+ * `{ active: false }` (local store). Throws if cloud was requested but is
+ * misconfigured.
+ */
+export declare function resolveEconomyCloudStorage(env?: NodeJS.ProcessEnv, overrides?: StorageClientOverrides): EconomyCloudStorage;
+/** Memoized {@link resolveEconomyCloudStorage} for the process lifetime. */
+export declare function economyCloudStorage(env?: NodeJS.ProcessEnv): EconomyCloudStorage;
+/** Test-only: drop the memoized resolution so a new env can be resolved. */
+export declare function resetEconomyCloudStorageCache(): void;
+/** Active cloud storage (narrowed so `client` is non-null). */
+export type ActiveEconomyCloudStorage = Extract<EconomyCloudStorage, {
+    active: true;
+}>;
+/** Query params accepted by the read helpers below. */
+export type CloudQuery = Record<string, string | number | boolean | null | undefined>;
+/**
+ * Read a collection resource from the cloud API and return the extracted array
+ * (the serve envelope's `data`/`items`). Used by the read commands (sessions,
+ * top, breakdown, accounts) so they render cloud data — never the local store —
+ * when the client is in self_hosted/cloud mode.
+ */
+export declare function cloudListItems<T = unknown>(storage: ActiveEconomyCloudStorage, resource: string, query?: CloudQuery): Promise<T[]>;
+/**
+ * Read a single (non-collection) resource and return the unwrapped `data`
+ * payload (e.g. `/usage` -> `{ snapshots, summary }`). Falls back to the raw
+ * body if the server does not use the `{ data }` envelope.
+ */
+export declare function cloudObject<T = unknown>(storage: ActiveEconomyCloudStorage, path: string, query?: CloudQuery): Promise<T>;
+export {};
+//# sourceMappingURL=cloud-storage.d.ts.map

package/dist/lib/cloud-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-storage.d.ts","sourceRoot":"","sources":["../../src/lib/cloud-storage.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,oBAAoB,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAE9F,gFAAgF;AAChF,KAAK,sBAAsB,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC;AAEzE,mEAAmE;AACnE,eAAO,MAAM,WAAW,YAAY,CAAC;AAErC,MAAM,MAAM,mBAAmB,GAC3B;IACE,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;CACrC,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;CACvB,CAAC;AAIN;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,SAAS,CAAC,EAAE,sBAAsB,GACjC,mBAAmB,CAKrB;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,mBAAmB,CAG7F;AAED,4EAA4E;AAC5E,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD;AAED,+DAA+D;AAC/D,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAAC,mBAAmB,EAAE;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,CAAC,CAAC;AAEvF,uDAAuD;AACvD,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAYtF;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,CAAC,GAAG,OAAO,EAC9C,OAAO,EAAE,yBAAyB,EAClC,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,UAAU,GACjB,OAAO,CAAC,CAAC,EAAE,CAAC,CAId;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,CAAC,GAAG,OAAO,EAC3C,OAAO,EAAE,yBAAyB,EAClC,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,UAAU,GACjB,OAAO,CAAC,CAAC,CAAC,CAOZ"}

package/dist/lib/contracts-client/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./transport.js";
+export * from "./storage.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/contracts-client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/contracts-client/index.ts"],"names":[],"mappings":"AAGA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/dist/lib/contracts-client/mode.d.ts

@@ -0,0 +1,20 @@
+/** Environment map (subset of NodeJS.ProcessEnv). */
+export type Env = Record<string, string | undefined>;
+/** Runtime storage enum. `local | cloud` ONLY (Amendment A1: PURE REMOTE). */
+export type StorageMode = "local" | "cloud";
+/** Deprecated storage-mode aliases accepted at parse time and mapped to cloud. */
+export declare const DEPRECATED_STORAGE_MODE_ALIASES: readonly ["remote", "hybrid", "self_hosted"];
+export interface StorageModeNormalization {
+    mode: StorageMode;
+    /** The deprecated alias that was normalized to `cloud`, if any. */
+    deprecatedAlias: string | null;
+}
+/**
+ * Normalize a raw storage-mode string to the `local | cloud` runtime enum.
+ * Accepts deprecated aliases (`remote`, `hybrid`, `self_hosted`) and maps them
+ * to `cloud`. Throws on any other value.
+ */
+export declare function normalizeStorageMode(value: string): StorageModeNormalization;
+/** Upper-snake env token for an app name, e.g. `economy` -> `ECONOMY`. */
+export declare function envToken(name: string): string;
+//# sourceMappingURL=mode.d.ts.map

package/dist/lib/contracts-client/mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.d.ts","sourceRoot":"","sources":["../../../src/lib/contracts-client/mode.ts"],"names":[],"mappings":"AAaA,qDAAqD;AACrD,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAErD,8EAA8E;AAC9E,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5C,kFAAkF;AAClF,eAAO,MAAM,+BAA+B,8CAA+C,CAAC;AAE5F,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,WAAW,CAAC;IAClB,mEAAmE;IACnE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,wBAAwB,CAQ5E;AAED,0EAA0E;AAC1E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C"}

package/dist/lib/contracts-client/storage.d.ts

@@ -0,0 +1,83 @@
+import type { Env } from "./mode.js";
+import { createClientTransport, type HasnaHttpTransport, type HasnaRequestOptions, type QueryParams } from "./transport.js";
+/** Options for a list() call: filters/pagination as query params. */
+export interface StorageListOptions extends Pick<HasnaRequestOptions, "timeoutMs" | "headers" | "retry" | "signal"> {
+    /** Query params (limit, offset, cursor, filters, ...). */
+    query?: QueryParams;
+}
+/** Options for a get() call. */
+export type StorageGetOptions = Pick<HasnaRequestOptions, "timeoutMs" | "headers" | "retry" | "signal" | "query">;
+/** Options for a create() call. */
+export interface StorageCreateOptions extends Pick<HasnaRequestOptions, "timeoutMs" | "headers" | "retry" | "signal" | "query"> {
+    /**
+     * Idempotency key for the create. Defaults to a fresh UUID so a transparently
+     * retried POST is deduped by the server instead of creating a duplicate. Pass
+     * a stable value to make an app-level operation idempotent across calls.
+     */
+    idempotencyKey?: string;
+}
+/** Options for an update() call. */
+export interface StorageUpdateOptions extends Pick<HasnaRequestOptions, "timeoutMs" | "headers" | "retry" | "signal" | "query"> {
+    /** HTTP verb for the update. Default `PATCH` (partial); use `PUT` for replace. */
+    method?: "PATCH" | "PUT";
+    /** Idempotency key. PUT is idempotent by definition; set this to make PATCH retry-safe too. */
+    idempotencyKey?: string;
+}
+/** Options for a delete() call. */
+export type StorageDeleteOptions = Pick<HasnaRequestOptions, "timeoutMs" | "headers" | "retry" | "signal" | "query">;
+/** Result of a list() call. `items` is the extracted array; `raw` is the full envelope. */
+export interface StorageListResult<T> {
+    items: T[];
+    /** Total count when the server reports one (`total`/`count`), else null. */
+    total: number | null;
+    /** Opaque pagination cursor when the server reports one, else null. */
+    cursor: string | null;
+    /** The full parsed response body (envelope preserved). */
+    raw: unknown;
+}
+/**
+ * The app storage interface, HTTP edition. This is deliberately the same small
+ * CRUD surface a local store exposes, so an app's resolver can return either a
+ * local implementation or this one behind one interface.
+ */
+export interface HasnaStorageClient {
+    /** App slug this client targets. */
+    readonly name: string;
+    /** `<origin>/v1` base URL. */
+    readonly baseUrl: string;
+    /** The underlying HTTP transport (escape hatch for non-CRUD routes). */
+    readonly transport: HasnaHttpTransport;
+    /** List a collection. Returns extracted `items` plus the raw envelope. */
+    list<T = unknown>(resource: string, options?: StorageListOptions): Promise<StorageListResult<T>>;
+    /** Fetch one entity by id. Returns `null` on 404. */
+    get<T = unknown>(resource: string, id: string, options?: StorageGetOptions): Promise<T | null>;
+    /** Create one entity. Retry-safe via an auto `Idempotency-Key`. */
+    create<T = unknown>(resource: string, body: unknown, options?: StorageCreateOptions): Promise<T>;
+    /** Update one entity by id (PATCH by default). */
+    update<T = unknown>(resource: string, id: string, patch: unknown, options?: StorageUpdateOptions): Promise<T>;
+    /** Delete one entity by id. Resolves for 2xx and 404 (already gone). */
+    delete(resource: string, id: string, options?: StorageDeleteOptions): Promise<void>;
+}
+/**
+ * Wrap an HTTP transport with the resource CRUD storage interface. Use this when
+ * you already have a transport (e.g. from `createClientTransport`).
+ */
+export declare function createHasnaStorageClient(name: string, transport: HasnaHttpTransport): HasnaStorageClient;
+/** Result of {@link resolveStorageClient}. */
+export type ResolveStorageClientResult = {
+    transport: "local";
+    client: null;
+} | {
+    transport: "cloud-http";
+    client: HasnaStorageClient;
+};
+/**
+ * The one call an app's storage resolver makes. Reads the client-flip env for
+ * `name`; when it resolves to `cloud-http` (mode=cloud/self_hosted + API_URL +
+ * API_KEY), returns a ready {@link HasnaStorageClient}. Otherwise returns
+ * `{ transport: 'local', client: null }` so the app uses its local store.
+ * Throws if cloud was requested but is misconfigured (so callers never silently
+ * read the wrong dataset).
+ */
+export declare function resolveStorageClient(name: string, env?: Env, overrides?: Parameters<typeof createClientTransport>[2]): ResolveStorageClientResult;
+//# sourceMappingURL=storage.d.ts.map

package/dist/lib/contracts-client/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/lib/contracts-client/storage.ts"],"names":[],"mappings":"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"}

package/dist/lib/contracts-client/transport.d.ts

@@ -0,0 +1,148 @@
+import { type Env, type StorageMode } from "./mode.js";
+/** Default cloud host template. `<app>` is the app slug. */
+export declare function defaultCloudBaseUrl(name: string): string;
+export interface ClientTransportEnvKeys {
+    /** Mode keys, in precedence order. */
+    modeKeys: string[];
+    /** API base-URL keys, in precedence order. */
+    apiUrlKeys: string[];
+    /** API-key keys, in precedence order. */
+    apiKeyKeys: string[];
+}
+/** Resolve the canonical client-flip env-key spec for an app. */
+export declare function clientTransportEnvKeys(name: string): ClientTransportEnvKeys;
+/** Normalize a base URL to `<origin>/v1` (dropping any trailing slash or existing /v1). */
+export declare function toV1BaseUrl(apiUrl: string): string;
+export type ClientTransportKind = "local" | "cloud-http";
+export interface ClientTransportResolution {
+    /** Where the client should read/write from. */
+    transport: ClientTransportKind;
+    /** Resolved storage mode (`local` | `cloud`). */
+    mode: StorageMode;
+    /** Deprecated mode alias that was normalized (e.g. `self_hosted`), if any. */
+    deprecatedAlias: string | null;
+    /** Env key the mode was read from, or `"default"`. */
+    modeSource: string;
+    /** `<origin>/v1` base for the cloud API when transport is cloud-http, else null. */
+    baseUrl: string | null;
+    /** Env key the API URL came from, `"default"` (host template), or null. */
+    apiUrlSource: string | null;
+    /** Whether an API key is present (value never exposed). */
+    apiKeyPresent: boolean;
+    /** Env key the API key came from, or null. */
+    apiKeySource: string | null;
+    /**
+     * True when the operator asked for cloud but the config is incomplete (no API
+     * key), so we fell back to local. Callers SHOULD treat this as an error rather
+     * than silently reading local data.
+     */
+    misconfigured: boolean;
+    /** Human-readable warning, or null. Never contains secret values. */
+    warning: string | null;
+}
+/**
+ * Resolve how a client should reach an app's data given the environment.
+ *
+ * Precedence for the mode: the first present of `HASNA_<NAME>_STORAGE_MODE`,
+ * `HASNA_<NAME>_MODE`, `<NAME>_STORAGE_MODE`, `<NAME>_MODE`, else `local`.
+ */
+export declare function resolveClientTransport(name: string, env?: Env): ClientTransportResolution;
+/** Thrown when a cloud HTTP request returns a non-2xx status. */
+export declare class HasnaHttpError extends Error {
+    readonly status: number;
+    readonly method: string;
+    readonly path: string;
+    readonly body: unknown;
+    constructor(method: string, path: string, status: number, body: unknown);
+}
+type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;
+/** Query params for a request. Nullish values are dropped; arrays repeat the key. */
+export type QueryParams = URLSearchParams | Record<string, string | number | boolean | null | undefined | ReadonlyArray<string | number | boolean>>;
+/** Retry policy for transient failures (network errors, timeouts, 5xx, 429). */
+export interface HasnaRetryOptions {
+    /** Max RETRY attempts after the first try. Default 2 (=> up to 3 total tries). */
+    retries?: number;
+    /** Base backoff in ms for exponential backoff. Default 200. */
+    baseDelayMs?: number;
+    /** Backoff ceiling in ms. Default 2000. */
+    maxDelayMs?: number;
+    /** HTTP statuses that trigger a retry. Default 408, 425, 429, 500, 502, 503, 504. */
+    retryStatuses?: number[];
+}
+/** Per-call request options: query, idempotency, timeout, retry, extra headers. */
+export interface HasnaRequestOptions {
+    /** Query string params appended to the URL. */
+    query?: QueryParams;
+    /**
+     * Idempotency key sent as `Idempotency-Key`. When set, unsafe methods (POST)
+     * become safe to retry: the server dedupes replays. Auto-generated for
+     * `create()` in the storage client.
+     */
+    idempotencyKey?: string;
+    /** Override the transport timeout for this call (ms). */
+    timeoutMs?: number;
+    /** Extra headers merged into this call (override transport headers). */
+    headers?: Record<string, string>;
+    /** Override or disable retry for this call. `false` disables retries. */
+    retry?: HasnaRetryOptions | false;
+    /** Caller abort signal, combined with the internal timeout. */
+    signal?: AbortSignal;
+}
+export interface HasnaHttpTransportOptions {
+    /** App slug (for error context / default host). */
+    name: string;
+    /** `<origin>/v1` base. Usually from `resolveClientTransport().baseUrl`. */
+    baseUrl: string;
+    /** The API key (secret). Sent as both `x-api-key` and `Authorization: Bearer`. */
+    apiKey: string;
+    /** Override fetch (tests). Defaults to global fetch. */
+    fetchImpl?: FetchLike;
+    /** Extra headers merged into every request. */
+    headers?: Record<string, string>;
+    /** Per-request timeout in ms. Default 30000. */
+    timeoutMs?: number;
+    /** Default retry policy for all requests. Pass `false` to disable. */
+    retry?: HasnaRetryOptions | false;
+    /** Injectable sleep (tests). Defaults to a real timer. */
+    sleepImpl?: (ms: number) => Promise<void>;
+}
+export interface HasnaHttpTransport {
+    readonly baseUrl: string;
+    request<T = unknown>(method: string, path: string, body?: unknown, opts?: HasnaRequestOptions): Promise<T>;
+    get<T = unknown>(path: string, opts?: HasnaRequestOptions): Promise<T>;
+    post<T = unknown>(path: string, body?: unknown, opts?: HasnaRequestOptions): Promise<T>;
+    put<T = unknown>(path: string, body?: unknown, opts?: HasnaRequestOptions): Promise<T>;
+    patch<T = unknown>(path: string, body?: unknown, opts?: HasnaRequestOptions): Promise<T>;
+    del<T = unknown>(path: string, body?: unknown, opts?: HasnaRequestOptions): Promise<T>;
+}
+/** Append query params to a `/v1`-relative path (no-op when empty). */
+export declare function appendQuery(path: string, query?: QueryParams): string;
+/**
+ * Build an authenticated HTTP transport for an app's cloud `/v1` API. Sends the
+ * API key on every request as BOTH `x-api-key` and `Authorization: Bearer`
+ * (serve apps accept either), returns parsed JSON, times out, and retries
+ * transient failures with exponential backoff + jitter. Never logs the key.
+ *
+ * Retry safety: idempotent methods (GET/HEAD/PUT/DELETE/OPTIONS) are always
+ * retried on transient failure; POST/PATCH are retried ONLY when an
+ * `Idempotency-Key` is supplied, so replays can't create duplicates.
+ */
+export declare function createHasnaHttpTransport(options: HasnaHttpTransportOptions): HasnaHttpTransport;
+/**
+ * Convenience: resolve transport from env and, when cloud-http, build the HTTP
+ * client in one call. Returns `{ transport: 'local', resolution }` for local, or
+ * `{ transport: 'cloud-http', client, resolution }` for cloud. Throws if the
+ * config is `misconfigured` (cloud requested but unusable) so callers can't drift
+ * onto local data by accident.
+ */
+export declare function createClientTransport(name: string, env?: Env, overrides?: Partial<Pick<HasnaHttpTransportOptions, "fetchImpl" | "headers" | "timeoutMs" | "retry" | "sleepImpl">>): {
+    transport: "local";
+    client: null;
+    resolution: ClientTransportResolution;
+} | {
+    transport: "cloud-http";
+    client: HasnaHttpTransport;
+    resolution: ClientTransportResolution;
+};
+export {};
+//# sourceMappingURL=transport.d.ts.map

package/dist/lib/contracts-client/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/lib/contracts-client/transport.ts"],"names":[],"mappings":"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"}

package/dist/lib/pricing.d.ts

@@ -1,5 +1,6 @@
 import type { SqliteAdapter as Database } from '@hasna/cloud';
 import type { ModelPricing } from '../types/index.js';
+import { type DbModelPricing } from '../db/database.js';
 export declare const DEFAULT_PRICING: Record<string, ModelPricing>;
 export declare function normalizeModelName(raw: string): string;
 export declare function ensurePricingSeeded(db: Database): void;
@@ -7,4 +8,6 @@ export declare function getPricingFromDb(db: Database, model: string): ModelPric
 export declare function getPricing(model: string): ModelPricing | null;
 export declare function computeCost(model: string, inputTokens: number, outputTokens: number, cacheReadTokens?: number, cacheWriteTokens?: number, cacheWrite1hTokens?: number, cacheStorageTokenHours?: number): number;
 export declare function computeCostFromDb(db: Database, model: string, inputTokens: number, outputTokens: number, cacheReadTokens?: number, cacheWriteTokens?: number, cacheWrite1hTokens?: number, cacheStorageTokenHours?: number): number;
+export declare function getPricingFromRows(rows: DbModelPricing[], model: string): ModelPricing | null;
+export declare function estimateCostFromRows(rows: DbModelPricing[], model: string, inputTokens: number, outputTokens: number, cacheReadTokens?: number, cacheWriteTokens?: number, cacheWrite1hTokens?: number, cacheStorageTokenHours?: number): number;
 //# sourceMappingURL=pricing.d.ts.map

package/dist/lib/pricing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../../src/lib/pricing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,cAAc,CAAA;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAKrD,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CA+FxD,CAAA;AAqND,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOtD;AA2CD,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAMtD;AA+GD,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAoBjF;AA4BD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAG7D;AAMD,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,eAAe,SAAI,EACnB,gBAAgB,SAAI,EACpB,kBAAkB,SAAI,EACtB,sBAAsB,SAAI,GACzB,MAAM,CAIR;AAED,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,eAAe,SAAI,EACnB,gBAAgB,SAAI,EACpB,kBAAkB,SAAI,EACtB,sBAAsB,SAAI,GACzB,MAAM,CAIR"}
+{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../../src/lib/pricing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,cAAc,CAAA;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAA6E,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAIlI,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CA+FxD,CAAA;AAqND,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOtD;AA2CD,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAMtD;AA+GD,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAoBjF;AA4BD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAG7D;AAMD,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,eAAe,SAAI,EACnB,gBAAgB,SAAI,EACpB,kBAAkB,SAAI,EACtB,sBAAsB,SAAI,GACzB,MAAM,CAIR;AAED,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,eAAe,SAAI,EACnB,gBAAgB,SAAI,EACpB,kBAAkB,SAAI,EACtB,sBAAsB,SAAI,GACzB,MAAM,CAIR;AAMD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAW7F;AAMD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,cAAc,EAAE,EACtB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,eAAe,SAAI,EACnB,gBAAgB,SAAI,EACpB,kBAAkB,SAAI,EACtB,sBAAsB,SAAI,GACzB,MAAM,CAIR"}