dsh-budget 0.1.0

package/lib/typert.host.js

@@ -0,0 +1,26 @@
+import { t as BUDGET_INVOCATIONS } from "./wire-DVO8yw7L.js";
+//#region src/typert.host.ts
+/**
+* The hand-written Typert HOST manifest for `dsh-budget`, exported as
+* `./typert` so the harness's typert-loader registers the `budget`
+* status/setSettings/unblock invocations automatically when this plugin
+* mounts. Same shape as a generator output (validated by the loader): package
+* face, empty model and schemas, and the canonical invocation list shared
+* with the client Remote contribution (`src/wire.ts`).
+*
+* @module dsh-budget/typert
+*/
+/** Host Typert manifest (validated by `@deepseek-ai/dsh-typert-loader`). */
+const TYPERT = Object.freeze({
+	package: "dsh-budget",
+	face: "host",
+	schemas: Object.freeze([]),
+	invocations: BUDGET_INVOCATIONS,
+	model: Object.freeze({
+		services: Object.freeze([]),
+		events: Object.freeze([]),
+		objects: Object.freeze([])
+	})
+});
+//#endregion
+export { TYPERT };

package/lib/types/aggregate/usage.d.ts

@@ -0,0 +1,112 @@
+/**
+ * The usage aggregator: turns the session event stream into per-session,
+ * per-day, and per-month token/cost/carbon buckets plus per-model latency
+ * windows. Pure state and pure accounting — the caller feeds events and the
+ * aggregator owns no I/O, no timers, and no Cordis services, so every policy
+ * path is unit-testable without a harness.
+ *
+ * @module dsh-budget/aggregate
+ */
+import type { TokenUsage } from '@deepseek-ai/dsh-llm';
+import type { ResolvedConfig } from '../config.ts';
+/** One scope's token buckets (disjoint, mirroring TokenUsage). */
+export interface TokenBuckets {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+}
+/** One scope's aggregated usage. */
+export interface ScopeUsage extends TokenBuckets {
+    costUsd: number;
+    carbonKg: number;
+}
+/** Empty usage record. */
+export declare function emptyUsage(): ScopeUsage;
+/** One model's aggregated usage plus latency statistics. */
+export interface ModelUsage extends ScopeUsage {
+    provider: string;
+    model: string;
+    /** Latency samples kept for this model (ms). */
+    latencyMs: readonly number[];
+}
+/** One recorded threshold alert. */
+export interface AlertRecord {
+    scope: 'session' | 'daily' | 'monthly';
+    kind: 'warn' | 'over';
+    at: number;
+    usedUsd: number;
+    capUsd: number;
+}
+/** UTC day key, e.g. `2026-08-16`. */
+export declare function dayKey(timestamp: number): string;
+/** UTC month key, e.g. `2026-08`. */
+export declare function monthKey(timestamp: number): string;
+/** Everything the panel and the /budget command read (session-attributed via {@link BudgetAggregator.snapshotFor}). */
+export interface BudgetSnapshot {
+    session: ScopeUsage;
+    today: ScopeUsage;
+    thisMonth: ScopeUsage;
+    models: readonly ModelUsage[];
+    /** Alerts in reverse chronological order. */
+    alerts: readonly AlertRecord[];
+    blockedScopes: readonly ('session' | 'daily' | 'monthly')[];
+}
+/**
+ * The runtime aggregator. All methods are synchronous; the caller invokes
+ * them from the session-event listener (the event hot path).
+ */
+export declare class BudgetAggregator {
+    private readonly config;
+    private readonly now;
+    private readonly state;
+    private readonly table;
+    /** @param config - resolved plugin config. @param now - clock (defaults to Date.now). */
+    constructor(config: ResolvedConfig, now?: () => number);
+    /** Update the current provider/model attribution from a request header. */
+    setAttribution(provider: string, model: string): void;
+    /** The current provider/model attribution (latest request header). */
+    attribution(): {
+        provider: string;
+        model: string;
+    };
+    /**
+     * Record one usage payload against the current attribution. Unknown or
+     * zero usage is a no-op.
+     *
+     * @param sessionId - owning session id (string form).
+     * @param usage - the token usage payload.
+     */
+    recordUsage(sessionId: string, usage: TokenUsage): void;
+    /** Record one measured call duration for one model. */
+    recordLatency(model: string, durationMs: number): void;
+    /** Merge one usage record into a per-model map. */
+    private addModel;
+    /** Read one session's usage (empty when unknown). */
+    sessionUsage(sessionId: string): ScopeUsage;
+    /** Read today's usage. */
+    todayUsage(): ScopeUsage;
+    /** Read this month's usage. */
+    monthUsage(): ScopeUsage;
+    /** Per-model usage (today) with latency percentiles, sorted by cost. */
+    modelUsage(): ModelUsage[];
+    /** Record one threshold alert (bounded to the most recent 50). */
+    recordAlert(alert: AlertRecord): void;
+    /** Milliseconds since the last alert of the same scope+kind (Infinity when none). */
+    lastAlertAge(scope: 'session' | 'daily' | 'monthly', kind: 'warn' | 'over', at: number): number;
+    /** The current blocked scopes (budget crosses that the user has not lifted). */
+    get blockedScopes(): readonly ('session' | 'daily' | 'monthly')[];
+    /** Mark one scope blocked (over-limit with block/degrade policy). */
+    blockScope(scope: 'session' | 'daily' | 'monthly'): void;
+    /** Lift a block (user confirmation through /budget unblock or the panel). */
+    unblockScope(scope: 'session' | 'daily' | 'monthly'): void;
+    /**
+     * The per-scope snapshot for one session (the panel and the command
+     * attribute usage to the session that owns the view).
+     *
+     * @param sessionId - owning session id.
+     * @returns the session-attributed snapshot.
+     */
+    snapshotFor(sessionId: string): BudgetSnapshot;
+}
+//# sourceMappingURL=usage.d.ts.map

package/lib/types/aggregate/usage.d.ts.map

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

package/lib/types/client/BudgetTab.d.ts

@@ -0,0 +1,18 @@
+/** The budget settings tab: usage bars, model breakdown, alerts, cap editors, and unblock actions. */
+import { type ReactNode } from 'react';
+import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { BudgetStatus } from '../wire.ts';
+/** Registration-side injected face: the budget RPCs (RemoteResult already unwrapped). */
+export interface BudgetTabInjected {
+    /** Read the current Host snapshot. */
+    status: () => Promise<BudgetStatus>;
+    /** Apply runtime budget caps and alert switches. */
+    setSettings: (settingsJson: string) => Promise<BudgetStatus>;
+    /** Lift one blocked scope after user confirmation. */
+    unblock: (scope: string) => Promise<BudgetStatus>;
+}
+/** Full component props assembled by the Settings slot renderer. */
+export type BudgetTabProps = PropsRuntime<'settings.plugins.tab'> & PropsLocale<'settings.budget'> & InjectFace<BudgetTabInjected>;
+/** The budget tab body. */
+export declare function BudgetTab({ status, setSettings, unblock, t }: BudgetTabProps): ReactNode;
+//# sourceMappingURL=BudgetTab.d.ts.map

package/lib/types/client/BudgetTab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BudgetTab.d.ts","sourceRoot":"","sources":["../../../src/client/BudgetTab.tsx"],"names":[],"mappings":"AAAA,sGAAsG;AAEtG,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAE7F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,yFAAyF;AACzF,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,MAAM,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAA;IACnC,oDAAoD;IACpD,WAAW,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;IAC5D,sDAAsD;IACtD,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;CAClD;AAED,oEAAoE;AACpE,MAAM,MAAM,cAAc,GACxB,YAAY,CAAC,sBAAsB,CAAC,GAClC,WAAW,CAAC,iBAAiB,CAAC,GAC9B,UAAU,CAAC,iBAAiB,CAAC,CAAA;AAOjC,2BAA2B;AAC3B,wBAAgB,SAAS,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,cAAc,GAAG,SAAS,CAqLxF"}

package/lib/types/client/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `dsh-budget`, browser half: mounts the `budget` Remote contribution, then
+ * registers the budget tab into the Plugins settings section
+ * (`settings.plugins.tab`, id `budget`). All data arrives through the
+ * `remote.budget` namespace — the tab issues no other RPC and holds no state
+ * of its own beyond the edit form and the last loaded snapshot.
+ *
+ * @module dsh-budget/client
+ */
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import { type BudgetLocaleKey } from './locales.ts';
+export type { BudgetTabInjected, BudgetTabProps } from './BudgetTab.tsx';
+export type { BudgetLocaleKey } from './locales.ts';
+export { formatAlertTime, formatMoney, scopePercent, scopeTone } from './present.ts';
+export type { BudgetTone } from './present.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** Budget settings tab copy. */
+        'settings.budget': BudgetLocaleKey;
+    }
+}
+/** Dictionary namespace owned by this plugin. */
+export declare const NS = "settings.budget";
+/** Plugin name: matches the package name, the graph row id, and the bundle id. */
+export declare const name = "dsh-budget";
+/** Services the tab reads; `remote.budget` appears once this plugin mounts its contribution. */
+export declare const inject: string[];
+/**
+ * Browser plugin body: dictionaries, the scoped stylesheet, the Remote
+ * contribution mount, and the settings tab registration.
+ *
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: ClientContext): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAA;AAM3E,OAAO,EAAU,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA;AAM3D,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACxE,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACpF,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAE9C,OAAO,QAAQ,kCAAkC,CAAC;IAChD,UAAU,kBAAkB;QAC1B,gCAAgC;QAChC,iBAAiB,EAAE,eAAe,CAAA;KACnC;CACF;AAED,iDAAiD;AACjD,eAAO,MAAM,EAAE,oBAAoB,CAAA;AAEnC,kFAAkF;AAClF,eAAO,MAAM,IAAI,eAAe,CAAA;AAEhC,gGAAgG;AAChG,eAAO,MAAM,MAAM,UAA4C,CAAA;AAE/D;;;;;GAKG;AACH,wBAAsB,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA+B7D"}

package/lib/types/client/locales.d.ts

@@ -0,0 +1,42 @@
+/** Copy dictionaries for the budget settings tab (en/zh, matching the locale registry constraint). */
+/** Simplified Chinese dictionary. */
+export declare const zh: {
+    readonly tab: "预算";
+    readonly loading: "正在读取预算用量…";
+    readonly error: "暂时无法读取预算用量。";
+    readonly retry: "重试";
+    readonly scopes: "预算作用域";
+    readonly session: "会话";
+    readonly daily: "今日";
+    readonly monthly: "本月";
+    readonly unlimited: "不限";
+    readonly blocked: "已阻断";
+    readonly unblock: "解除阻断";
+    readonly usage: "用量";
+    readonly carbon: "碳足迹";
+    readonly models: "模型用量";
+    readonly model: "模型";
+    readonly cost: "费用";
+    readonly tokens: "tokens";
+    readonly latency: "p50 延迟";
+    readonly alerts: "告警";
+    readonly noAlerts: "暂无告警记录。";
+    readonly warnAlert: "阈值告警";
+    readonly overAlert: "超限告警";
+    readonly caps: "预算上限（USD）";
+    readonly sessionCap: "会话上限";
+    readonly dailyCap: "每日上限";
+    readonly monthlyCap: "每月上限";
+    readonly capUnlimited: "留空或 0 表示不限";
+    readonly alertsEnabled: "启用阈值告警";
+    readonly desktopNotifications: "浏览器桌面通知";
+    readonly save: "保存";
+    readonly saved: "已保存（会话内生效，重载后恢复 cordis.yml 配置）";
+    readonly degraded: "已降级至";
+    readonly history: "最近告警";
+};
+/** English dictionary (source of truth for keys). */
+export declare const en: Record<keyof typeof zh, string>;
+/** Every dictionary key. */
+export type BudgetLocaleKey = keyof typeof zh;
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/client/locales.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../../src/client/locales.ts"],"names":[],"mappings":"AAAA,sGAAsG;AAEtG,qCAAqC;AACrC,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCL,CAAA;AAEV,qDAAqD;AACrD,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,MAAM,OAAO,EAAE,EAAE,MAAM,CAkCrC,CAAA;AAEV,4BAA4B;AAC5B,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,EAAE,CAAA"}

package/lib/types/client/present.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Pure presentation helpers for the budget tab: money formatting and one
+ * scope row's tone. Pure functions of the wire payload — replay-safe and
+ * unit-testable without a browser.
+ *
+ * @module dsh-budget/client/present
+ */
+import type { BudgetStatus, ScopeLine } from '../wire.ts';
+/** One scope row's bar tone. */
+export type BudgetTone = 'ok' | 'warn' | 'over';
+/** Format one USD amount through the snapshot's display currency. */
+export declare function formatMoney(status: BudgetStatus, usd: number): string;
+/** The tone for one scope line. */
+export declare function scopeTone(line: ScopeLine, warnRatio: number, blocked: boolean): BudgetTone;
+/** The bar width (percent, 0..100) for one scope line. */
+export declare function scopePercent(line: ScopeLine): number;
+/** Local wall-clock time for one alert timestamp. */
+export declare function formatAlertTime(at: number): string;
+//# sourceMappingURL=present.d.ts.map

package/lib/types/client/present.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"present.d.ts","sourceRoot":"","sources":["../../../src/client/present.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAEzD,gCAAgC;AAChC,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAA;AAE/C,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGrE;AAED,mCAAmC;AACnC,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,UAAU,CAI1F;AAED,0DAA0D;AAC1D,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAGpD;AAED,qDAAqD;AACrD,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/lib/types/client/remote.d.ts

@@ -0,0 +1,270 @@
+/**
+ * The client-side Remote face of the `budget` namespace: the hand-written
+ * `TypertRemoteContribution` mounted through `ctx.remote.$mount`, plus the
+ * declaration merging that types `ctx.remote.budget`. The descriptor list is
+ * shared with the host `./typert` manifest (`../wire.ts`), so the two faces
+ * can never drift.
+ *
+ * @module dsh-budget/client/remote
+ */
+import type { RemoteResult } from '@deepseek-ai/dsh-typert-protocol';
+import type { BudgetStatus } from '../wire.ts';
+declare module '@deepseek-ai/dsh-typert-protocol' {
+    interface TypertRemoteNamespace$budget {
+        /** Read the current budget snapshot (session-attributed). */
+        status: (sessionId?: string) => Promise<RemoteResult<BudgetStatus>>;
+        /** Apply runtime budget caps and alert switches (panel). */
+        setSettings: (settingsJson: string) => Promise<RemoteResult<BudgetStatus>>;
+        /** Lift one blocked scope after user confirmation. */
+        unblock: (scope: string) => Promise<RemoteResult<BudgetStatus>>;
+    }
+    interface TypertRemoteMap {
+        'budget/status': (sessionId?: string) => Promise<RemoteResult<BudgetStatus>>;
+        'budget/setSettings': (settingsJson: string) => Promise<RemoteResult<BudgetStatus>>;
+        'budget/unblock': (scope: string) => Promise<RemoteResult<BudgetStatus>>;
+    }
+    interface TypertRemoteNamespaceMap {
+        budget: TypertRemoteNamespace$budget;
+    }
+}
+/** The client Remote contribution for the `budget` namespace. */
+export declare const BUDGET_REMOTE: Readonly<{
+    package: string;
+    descriptors: readonly (Readonly<{
+        readonly id: "dsh-budget#budget/status";
+        readonly service: "budget";
+        readonly namespace: "budget";
+        readonly method: "status";
+        readonly invocation: Readonly<{
+            kind: "direct";
+        }>;
+        readonly parameters: readonly never[];
+        readonly result: Readonly<{
+            mode: "strict";
+            typeSymbol: "dsh-budget/types#BudgetStatus";
+            schema: import("zod").ZodObject<{
+                scopes: import("zod").ZodArray<import("zod").ZodObject<{
+                    scope: import("zod").ZodEnum<{
+                        session: "session";
+                        daily: "daily";
+                        monthly: "monthly";
+                    }>;
+                    capUsd: import("zod").ZodNullable<import("zod").ZodNumber>;
+                    usedUsd: import("zod").ZodNumber;
+                    ratio: import("zod").ZodNumber;
+                    tokens: import("zod").ZodNumber;
+                    carbonKg: import("zod").ZodNumber;
+                }, import("zod/v4/core").$strip>>;
+                models: import("zod").ZodArray<import("zod").ZodObject<{
+                    provider: import("zod").ZodString;
+                    model: import("zod").ZodString;
+                    inputTokens: import("zod").ZodNumber;
+                    outputTokens: import("zod").ZodNumber;
+                    costUsd: import("zod").ZodNumber;
+                    carbonKg: import("zod").ZodNumber;
+                    latency: import("zod").ZodObject<{
+                        min: import("zod").ZodNullable<import("zod").ZodNumber>;
+                        p50: import("zod").ZodNullable<import("zod").ZodNumber>;
+                        p95: import("zod").ZodNullable<import("zod").ZodNumber>;
+                        max: import("zod").ZodNullable<import("zod").ZodNumber>;
+                        samples: import("zod").ZodNumber;
+                    }, import("zod/v4/core").$strip>;
+                }, import("zod/v4/core").$strip>>;
+                alerts: import("zod").ZodArray<import("zod").ZodObject<{
+                    scope: import("zod").ZodEnum<{
+                        session: "session";
+                        daily: "daily";
+                        monthly: "monthly";
+                    }>;
+                    kind: import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"warn">, import("zod").ZodLiteral<"over">]>;
+                    at: import("zod").ZodNumber;
+                    usedUsd: import("zod").ZodNumber;
+                    capUsd: import("zod").ZodNumber;
+                }, import("zod/v4/core").$strip>>;
+                blockedScopes: import("zod").ZodArray<import("zod").ZodEnum<{
+                    session: "session";
+                    daily: "daily";
+                    monthly: "monthly";
+                }>>;
+                currency: import("zod").ZodObject<{
+                    code: import("zod").ZodString;
+                    rate: import("zod").ZodNumber;
+                    decimals: import("zod").ZodNumber;
+                }, import("zod/v4/core").$strip>;
+                alertsEnabled: import("zod").ZodBoolean;
+                desktopNotifications: import("zod").ZodBoolean;
+                degradedModel: import("zod").ZodNullable<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>;
+        }>;
+        readonly sourceLocation: Readonly<{
+            file: "src/wire.ts";
+            line: 1;
+            column: 1;
+        }>;
+    }> | Readonly<{
+        readonly id: "dsh-budget#budget/setSettings";
+        readonly service: "budget";
+        readonly namespace: "budget";
+        readonly method: "setSettings";
+        readonly invocation: Readonly<{
+            kind: "direct";
+        }>;
+        readonly parameters: readonly Readonly<{
+            name: string;
+            wire: string;
+            source: "json";
+            codec: Readonly<{
+                mode: "strict";
+                typeSymbol: "dsh-budget/types#BudgetSettingsJson";
+                schema: import("zod").ZodString;
+            }>;
+        }>[];
+        readonly result: Readonly<{
+            mode: "strict";
+            typeSymbol: "dsh-budget/types#BudgetStatus";
+            schema: import("zod").ZodObject<{
+                scopes: import("zod").ZodArray<import("zod").ZodObject<{
+                    scope: import("zod").ZodEnum<{
+                        session: "session";
+                        daily: "daily";
+                        monthly: "monthly";
+                    }>;
+                    capUsd: import("zod").ZodNullable<import("zod").ZodNumber>;
+                    usedUsd: import("zod").ZodNumber;
+                    ratio: import("zod").ZodNumber;
+                    tokens: import("zod").ZodNumber;
+                    carbonKg: import("zod").ZodNumber;
+                }, import("zod/v4/core").$strip>>;
+                models: import("zod").ZodArray<import("zod").ZodObject<{
+                    provider: import("zod").ZodString;
+                    model: import("zod").ZodString;
+                    inputTokens: import("zod").ZodNumber;
+                    outputTokens: import("zod").ZodNumber;
+                    costUsd: import("zod").ZodNumber;
+                    carbonKg: import("zod").ZodNumber;
+                    latency: import("zod").ZodObject<{
+                        min: import("zod").ZodNullable<import("zod").ZodNumber>;
+                        p50: import("zod").ZodNullable<import("zod").ZodNumber>;
+                        p95: import("zod").ZodNullable<import("zod").ZodNumber>;
+                        max: import("zod").ZodNullable<import("zod").ZodNumber>;
+                        samples: import("zod").ZodNumber;
+                    }, import("zod/v4/core").$strip>;
+                }, import("zod/v4/core").$strip>>;
+                alerts: import("zod").ZodArray<import("zod").ZodObject<{
+                    scope: import("zod").ZodEnum<{
+                        session: "session";
+                        daily: "daily";
+                        monthly: "monthly";
+                    }>;
+                    kind: import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"warn">, import("zod").ZodLiteral<"over">]>;
+                    at: import("zod").ZodNumber;
+                    usedUsd: import("zod").ZodNumber;
+                    capUsd: import("zod").ZodNumber;
+                }, import("zod/v4/core").$strip>>;
+                blockedScopes: import("zod").ZodArray<import("zod").ZodEnum<{
+                    session: "session";
+                    daily: "daily";
+                    monthly: "monthly";
+                }>>;
+                currency: import("zod").ZodObject<{
+                    code: import("zod").ZodString;
+                    rate: import("zod").ZodNumber;
+                    decimals: import("zod").ZodNumber;
+                }, import("zod/v4/core").$strip>;
+                alertsEnabled: import("zod").ZodBoolean;
+                desktopNotifications: import("zod").ZodBoolean;
+                degradedModel: import("zod").ZodNullable<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>;
+        }>;
+        readonly sourceLocation: Readonly<{
+            file: "src/wire.ts";
+            line: 1;
+            column: 1;
+        }>;
+    }> | Readonly<{
+        readonly id: "dsh-budget#budget/unblock";
+        readonly service: "budget";
+        readonly namespace: "budget";
+        readonly method: "unblock";
+        readonly invocation: Readonly<{
+            kind: "direct";
+        }>;
+        readonly parameters: readonly Readonly<{
+            name: string;
+            wire: string;
+            source: "json";
+            codec: Readonly<{
+                mode: "strict";
+                typeSymbol: "dsh-budget/types#BudgetUnblockScope";
+                schema: import("zod").ZodEnum<{
+                    session: "session";
+                    daily: "daily";
+                    monthly: "monthly";
+                }>;
+            }>;
+        }>[];
+        readonly result: Readonly<{
+            mode: "strict";
+            typeSymbol: "dsh-budget/types#BudgetStatus";
+            schema: import("zod").ZodObject<{
+                scopes: import("zod").ZodArray<import("zod").ZodObject<{
+                    scope: import("zod").ZodEnum<{
+                        session: "session";
+                        daily: "daily";
+                        monthly: "monthly";
+                    }>;
+                    capUsd: import("zod").ZodNullable<import("zod").ZodNumber>;
+                    usedUsd: import("zod").ZodNumber;
+                    ratio: import("zod").ZodNumber;
+                    tokens: import("zod").ZodNumber;
+                    carbonKg: import("zod").ZodNumber;
+                }, import("zod/v4/core").$strip>>;
+                models: import("zod").ZodArray<import("zod").ZodObject<{
+                    provider: import("zod").ZodString;
+                    model: import("zod").ZodString;
+                    inputTokens: import("zod").ZodNumber;
+                    outputTokens: import("zod").ZodNumber;
+                    costUsd: import("zod").ZodNumber;
+                    carbonKg: import("zod").ZodNumber;
+                    latency: import("zod").ZodObject<{
+                        min: import("zod").ZodNullable<import("zod").ZodNumber>;
+                        p50: import("zod").ZodNullable<import("zod").ZodNumber>;
+                        p95: import("zod").ZodNullable<import("zod").ZodNumber>;
+                        max: import("zod").ZodNullable<import("zod").ZodNumber>;
+                        samples: import("zod").ZodNumber;
+                    }, import("zod/v4/core").$strip>;
+                }, import("zod/v4/core").$strip>>;
+                alerts: import("zod").ZodArray<import("zod").ZodObject<{
+                    scope: import("zod").ZodEnum<{
+                        session: "session";
+                        daily: "daily";
+                        monthly: "monthly";
+                    }>;
+                    kind: import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"warn">, import("zod").ZodLiteral<"over">]>;
+                    at: import("zod").ZodNumber;
+                    usedUsd: import("zod").ZodNumber;
+                    capUsd: import("zod").ZodNumber;
+                }, import("zod/v4/core").$strip>>;
+                blockedScopes: import("zod").ZodArray<import("zod").ZodEnum<{
+                    session: "session";
+                    daily: "daily";
+                    monthly: "monthly";
+                }>>;
+                currency: import("zod").ZodObject<{
+                    code: import("zod").ZodString;
+                    rate: import("zod").ZodNumber;
+                    decimals: import("zod").ZodNumber;
+                }, import("zod/v4/core").$strip>;
+                alertsEnabled: import("zod").ZodBoolean;
+                desktopNotifications: import("zod").ZodBoolean;
+                degradedModel: import("zod").ZodNullable<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>;
+        }>;
+        readonly sourceLocation: Readonly<{
+            file: "src/wire.ts";
+            line: 1;
+            column: 1;
+        }>;
+    }>)[];
+}>;
+//# sourceMappingURL=remote.d.ts.map

package/lib/types/client/remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../../src/client/remote.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAA4B,MAAM,kCAAkC,CAAA;AAE9F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,OAAO,QAAQ,kCAAkC,CAAC;IAChD,UAAU,4BAA4B;QACpC,6DAA6D;QAC7D,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAA;QACnE,4DAA4D;QAC5D,WAAW,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAA;QAC1E,sDAAsD;QACtD,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAA;KAChE;IACD,UAAU,eAAe;QACvB,eAAe,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAA;QAC5E,oBAAoB,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAA;QACnF,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAA;KACzE;IACD,UAAU,wBAAwB;QAChC,MAAM,EAAE,4BAA4B,CAAA;KACrC;CACF;AAED,iEAAiE;AACjE,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGW,CAAA"}

package/lib/types/client/styles.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Scoped stylesheet for the budget tab. Standalone client bundles cannot use
+ * the in-repo CSS-module pipeline, so the sheet ships as a string and is
+ * installed effect-scoped into a `<style data-dsh-budget>` element. Every
+ * selector is scoped under `[data-dsh-budget]` and uses theme design tokens
+ * only, so it follows both color schemes.
+ *
+ * @module dsh-budget/client/styles
+ */
+/** One `<style>` installation; returns the exact disposer that removes it. */
+export declare function installBudgetStyles(): () => void;
+//# sourceMappingURL=styles.d.ts.map

package/lib/types/client/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../src/client/styles.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,8EAA8E;AAC9E,wBAAgB,mBAAmB,IAAI,MAAM,IAAI,CAQhD"}

package/lib/types/command.d.ts

@@ -0,0 +1,51 @@
+/**
+ * The `/budget` command: per-scope overview with aggregated tokens, cost,
+ * carbon and latency, plus `unblock <scope>` and `models` subcommands.
+ * Output is model-readable and reconstructable from the session log (the
+ * `command/run` + `command/done` events record the invocation; the
+ * `budget/alert`/`budget/block` events record every threshold transition).
+ *
+ * @module dsh-budget/command
+ */
+import type { CommandDefinition } from '@deepseek-ai/dsh-commands';
+import { sanitizeText } from './estimate/sanitize.ts';
+import type { BudgetService } from './service.ts';
+import type { BudgetStatus, BudgetScope } from './wire.ts';
+/** Command output language. */
+export type BudgetCommandLanguage = 'en' | 'zh';
+/** Message bundle per language. */
+interface Messages {
+    hint: string;
+    unlimited: string;
+    blocked: string;
+    usage: string;
+    unknownScope: (scope: string) => string;
+    unblocked: (scope: string) => string;
+    noModels: string;
+}
+/** Render the overview body for one snapshot. */
+export declare function renderBudgetOverview(status: BudgetStatus, messages: Messages): string;
+/** Parse the raw input after `/budget`. */
+export declare function parseBudgetArgs(rawInput: string): {
+    kind: 'overview';
+} | {
+    kind: 'unblock';
+    scope: BudgetScope;
+} | {
+    kind: 'models';
+} | {
+    kind: 'usage';
+};
+/** Render the per-model breakdown body. */
+export declare function renderBudgetModels(status: BudgetStatus, _messages: Messages): string;
+/**
+ * Build the `/budget` command definition.
+ *
+ * @param service - the budget service (snapshot + unblock).
+ * @param language - output language.
+ * @returns the command definition.
+ */
+export declare function budgetCommand(service: BudgetService, language?: BudgetCommandLanguage): CommandDefinition;
+/** Sanitize helper re-export for display callers. */
+export { sanitizeText };
+//# sourceMappingURL=command.d.ts.map

package/lib/types/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/command.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAE1D,+BAA+B;AAC/B,MAAM,MAAM,qBAAqB,GAAG,IAAI,GAAG,IAAI,CAAA;AAE/C,mCAAmC;AACnC,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;IACvC,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;IACpC,QAAQ,EAAE,MAAM,CAAA;CACjB;AA4BD,iDAAiD;AACjD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAuBrF;AAED,2CAA2C;AAC3C,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAC5C;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAOpB;AAED,2CAA2C;AAC3C,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,GAAG,MAAM,CAMpF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,GAAE,qBAA4B,GAAG,iBAAiB,CAyB/G;AAED,qDAAqD;AACrD,OAAO,EAAE,YAAY,EAAE,CAAA"}