tokmon 0.28.1 → 0.28.3

package/dist/chunk-JZSZEHVD.js

@@ -0,0 +1,406 @@
+#!/usr/bin/env node
+import {
+  BUILT_IN_THEME_PRESET_IDS,
+  DESKTOP_GRAPH_RANGES,
+  PROVIDER_IDS,
+  THEME_PRESET_IDS
+} from "./chunk-HNWEJ6MS.js";
+
+// src/rpc/contract.ts
+import { Schema } from "effect";
+import * as Rpc from "effect/unstable/rpc/Rpc";
+import * as RpcGroup from "effect/unstable/rpc/RpcGroup";
+var TOKMON_WS_PATH = "/ws";
+var TOKMON_PROTOCOL_VERSION = 3;
+var TOKMON_CAPABILITIES = ["config-cas", "config-revision", "allowed-hosts", "tray-config", "usage-activity", "tray-pins", "provider-pins", "desktop-disclosure", "desktop-graph-range", "provider-headroom", "canonical-identity", "appearance-v1", "theme-engine", "account-detection-v1"];
+var TOKMON_WS_METHODS = {
+  getConfig: "tokmon.getConfig",
+  setConfig: "tokmon.setConfig",
+  refresh: "tokmon.refresh",
+  browseFs: "tokmon.browseFs",
+  snapshot: "tokmon.snapshot",
+  config: "tokmon.config"
+};
+var RefreshScopeSchema = Schema.Literals([
+  "all",
+  "summary",
+  "table",
+  "billing",
+  "peak"
+]);
+var ProviderIdSchema = Schema.Literals(PROVIDER_IDS);
+var NonNegativeIntegerSchema = Schema.Int.check(Schema.isGreaterThanOrEqualTo(0));
+var PositiveFiniteSchema = Schema.Finite.check(Schema.isGreaterThanOrEqualTo(1));
+var AccountSchema = Schema.Struct({
+  id: Schema.String,
+  providerId: ProviderIdSchema,
+  name: Schema.String,
+  homeDir: Schema.String,
+  color: Schema.optionalKey(Schema.String)
+});
+var TrayConfigSchema = Schema.Struct({
+  enabled: Schema.Boolean,
+  showMenuBarText: Schema.Boolean,
+  displayMetric: Schema.Literals(["smartHeadroom", "tightestRemaining"]),
+  pollIntervalSec: Schema.Finite.check(Schema.isBetween({ minimum: 1, maximum: 86400 })),
+  activeTimeoutMin: Schema.Finite.check(Schema.isBetween({ minimum: 1, maximum: 1440 })),
+  graceMin: Schema.Finite.check(Schema.isBetween({ minimum: 1, maximum: 10080 })),
+  promotionHoldMin: Schema.Finite.check(Schema.isBetween({ minimum: 0, maximum: 1440 })),
+  lowWatermarkPct: Schema.Finite.check(Schema.isBetween({ minimum: 0, maximum: 100 })),
+  criticalWatermarkPct: Schema.Finite.check(Schema.isBetween({ minimum: 0, maximum: 100 })),
+  pinnedAccount: Schema.NullOr(Schema.String),
+  pins: Schema.Array(Schema.String),
+  // Additive since `tray-pins`: older daemons omit it, so tolerate absence and let
+  // `repairConfig` materialise the empty default rather than failing the decode.
+  pinnedProviders: Schema.optionalKey(Schema.Array(Schema.String)),
+  launchAtLogin: Schema.Boolean,
+  theme: Schema.Literal("dark")
+});
+var DesktopConfigSchema = Schema.Struct({
+  expandedProviders: Schema.Array(Schema.String),
+  graphRangeDays: Schema.optionalKey(Schema.Literals(DESKTOP_GRAPH_RANGES))
+});
+var AccountDetectionConfigSchema = Schema.Struct({
+  enabled: Schema.Boolean,
+  disabledProviders: Schema.Array(ProviderIdSchema),
+  excludedAccounts: Schema.Array(Schema.Struct({
+    providerId: ProviderIdSchema,
+    homeDir: Schema.String
+  }))
+});
+var HexColorSchema = Schema.String.check(Schema.isPattern(/^#[0-9a-f]{6}$/i));
+var ThemeOverridesSchema = Schema.Struct({
+  canvas: Schema.optionalKey(HexColorSchema),
+  panel: Schema.optionalKey(HexColorSchema),
+  inset: Schema.optionalKey(HexColorSchema),
+  insetStrong: Schema.optionalKey(HexColorSchema),
+  chrome: Schema.optionalKey(HexColorSchema),
+  line: Schema.optionalKey(HexColorSchema),
+  lineStrong: Schema.optionalKey(HexColorSchema),
+  lineFaint: Schema.optionalKey(HexColorSchema),
+  text: Schema.optionalKey(HexColorSchema),
+  textDim: Schema.optionalKey(HexColorSchema),
+  textFaint: Schema.optionalKey(HexColorSchema),
+  textStrong: Schema.optionalKey(HexColorSchema),
+  accent: Schema.optionalKey(HexColorSchema),
+  cost: Schema.optionalKey(HexColorSchema),
+  positive: Schema.optionalKey(HexColorSchema)
+});
+var AppearanceConfigSchema = Schema.Struct({
+  version: Schema.Literal(1),
+  mode: Schema.Literals(["auto", "light", "dark"]),
+  preset: Schema.Literals(THEME_PRESET_IDS),
+  terminal: Schema.Literals(["ansi", "dark", "light", "off"]),
+  custom: Schema.optionalKey(Schema.Struct({
+    base: Schema.Literals(BUILT_IN_THEME_PRESET_IDS),
+    light: ThemeOverridesSchema,
+    dark: ThemeOverridesSchema
+  }))
+});
+var ConfigSchema = Schema.Struct({
+  revision: NonNegativeIntegerSchema,
+  interval: PositiveFiniteSchema,
+  billingInterval: PositiveFiniteSchema,
+  clearScreen: Schema.Boolean,
+  privacyMode: Schema.Boolean,
+  privacyToggleKey: Schema.String,
+  timezone: Schema.NullOr(Schema.String),
+  accounts: Schema.Array(AccountSchema),
+  activeAccountId: Schema.NullOr(Schema.String),
+  disabledProviders: Schema.Array(ProviderIdSchema),
+  onboarded: Schema.Boolean,
+  dashboardLayout: Schema.Literals(["grid", "single"]),
+  defaultFocus: Schema.Literals(["all", "last"]),
+  ascii: Schema.Literals(["auto", "on", "off"]),
+  allowNetworkAccess: Schema.Boolean,
+  allowedHosts: Schema.Array(Schema.String),
+  resetDisplay: Schema.Literals(["relative", "absolute"]),
+  knownProviders: Schema.Array(ProviderIdSchema),
+  // Additive under `appearance-v1`; omission is accepted for old clients and
+  // preserved by the daemon's CAS boundary rather than resetting the theme.
+  appearance: Schema.optionalKey(AppearanceConfigSchema),
+  // Additive: older clients omit detector policy, so the daemon preserves its
+  // current value and repairConfig supplies legacy current-behaviour defaults.
+  accountDetection: Schema.optionalKey(AccountDetectionConfigSchema),
+  // The complete tray block was added within protocol v3. Accept omission from
+  // older peers and normalize it at the client / preserve it at the CAS boundary.
+  tray: Schema.optionalKey(TrayConfigSchema),
+  desktop: Schema.optionalKey(DesktopConfigSchema)
+});
+var ProtocolInfoSchema = Schema.Struct({
+  version: Schema.Literal(TOKMON_PROTOCOL_VERSION),
+  // Capabilities are additive within a protocol version. Older clients must
+  // preserve forward compatibility when a newer daemon advertises one they do
+  // not understand yet.
+  capabilities: Schema.Array(Schema.String)
+});
+var ConfigStateSchema = Schema.Struct({
+  protocol: ProtocolInfoSchema,
+  config: ConfigSchema
+});
+var ConfigUpdateRequestSchema = Schema.Struct({
+  expectedRevision: NonNegativeIntegerSchema,
+  config: ConfigSchema
+});
+var LegacyConfigUpdateConflictSchema = Schema.Struct({
+  kind: Schema.Literal("conflict"),
+  state: ConfigStateSchema
+});
+var ConfigUpdateConflictFailure = class extends Schema.TaggedErrorClass()(
+  "ConfigUpdateConflictFailure",
+  {
+    kind: Schema.Literal("conflict"),
+    state: ConfigStateSchema
+  }
+) {
+};
+var LegacyConfigPersistenceFailureSchema = Schema.Struct({
+  kind: Schema.Literal("persistence"),
+  message: Schema.String
+});
+var ConfigPersistenceFailure = class extends Schema.TaggedErrorClass()(
+  "ConfigPersistenceFailure",
+  {
+    kind: Schema.Literal("persistence"),
+    message: Schema.String
+  }
+) {
+};
+var ConfigUpdateConflictSchema = Schema.Union([
+  ConfigUpdateConflictFailure,
+  LegacyConfigUpdateConflictSchema
+]);
+var ConfigPersistenceFailureSchema = Schema.Union([
+  ConfigPersistenceFailure,
+  LegacyConfigPersistenceFailureSchema
+]);
+var RefreshFailure = class extends Schema.TaggedErrorClass()(
+  "RefreshFailure",
+  {
+    kind: Schema.Literal("refresh"),
+    message: Schema.String
+  }
+) {
+};
+var FsEntrySchema = Schema.Struct({
+  name: Schema.String,
+  path: Schema.String,
+  dir: Schema.Boolean
+});
+var FsListingSchema = Schema.Struct({
+  path: Schema.String,
+  parent: Schema.NullOr(Schema.String),
+  entries: Schema.Array(FsEntrySchema)
+});
+var UsageSummarySchema = Schema.Struct({
+  cost: Schema.Finite,
+  tokens: Schema.Finite,
+  input: Schema.Finite,
+  cacheRead: Schema.Finite,
+  cacheSavings: Schema.Finite
+});
+var ModelDetailSchema = Schema.Struct({
+  name: Schema.String,
+  input: Schema.Finite,
+  output: Schema.Finite,
+  cacheCreate: Schema.Finite,
+  cacheRead: Schema.Finite,
+  cacheSavings: Schema.Finite,
+  cost: Schema.Finite,
+  count: Schema.Finite
+});
+var TableRowSchema = Schema.Struct({
+  label: Schema.String,
+  models: Schema.Array(Schema.String),
+  input: Schema.Finite,
+  output: Schema.Finite,
+  cacheCreate: Schema.Finite,
+  cacheRead: Schema.Finite,
+  cacheSavings: Schema.Finite,
+  total: Schema.Finite,
+  cost: Schema.Finite,
+  count: Schema.Finite,
+  breakdown: Schema.Array(ModelDetailSchema)
+});
+var DashboardDataSchema = Schema.Struct({
+  today: UsageSummarySchema,
+  week: UsageSummarySchema,
+  month: UsageSummarySchema,
+  burnRate: Schema.Finite,
+  series: Schema.Array(Schema.Finite),
+  lastActivityAt: Schema.NullOr(NonNegativeIntegerSchema)
+});
+var TableDataSchema = Schema.Struct({
+  daily: Schema.Array(TableRowSchema),
+  weekly: Schema.Array(TableRowSchema),
+  monthly: Schema.Array(TableRowSchema)
+});
+var MetricFormatSchema = Schema.Union([
+  Schema.Struct({ kind: Schema.Literal("percent") }),
+  Schema.Struct({ kind: Schema.Literal("dollars"), currency: Schema.optionalKey(Schema.String) }),
+  Schema.Struct({ kind: Schema.Literal("count"), suffix: Schema.optionalKey(Schema.String) })
+]);
+var MetricSchema = Schema.Struct({
+  key: Schema.optionalKey(Schema.String),
+  role: Schema.optionalKey(Schema.Literals(["session", "weekly", "model", "other", "unbounded"])),
+  modelId: Schema.optionalKey(Schema.NullOr(Schema.String)),
+  active: Schema.optionalKey(Schema.Boolean),
+  label: Schema.String,
+  used: Schema.Finite,
+  limit: Schema.NullOr(Schema.Finite),
+  format: MetricFormatSchema,
+  resetsAt: Schema.optionalKey(Schema.NullOr(Schema.String)),
+  primary: Schema.optionalKey(Schema.Boolean)
+});
+var MetricRoleSchema = Schema.Literals(["session", "weekly", "model", "other", "unbounded"]);
+var AccountIdentityViewSchema = Schema.Struct({
+  title: Schema.String,
+  subtitle: Schema.NullOr(Schema.String),
+  accessibleLabel: Schema.String,
+  redacted: Schema.Boolean
+});
+var QuotaViewSchema = Schema.Struct({
+  key: Schema.String,
+  label: Schema.String,
+  role: MetricRoleSchema,
+  modelId: Schema.NullOr(Schema.String),
+  usedPct: Schema.NullOr(Schema.Finite),
+  remainingPct: Schema.NullOr(Schema.Finite),
+  resetsAt: Schema.NullOr(NonNegativeIntegerSchema),
+  bounded: Schema.Boolean,
+  primary: Schema.Boolean,
+  active: Schema.Boolean,
+  displayOrder: NonNegativeIntegerSchema,
+  valueText: Schema.String
+});
+var HeadroomFactorSchema = Schema.Struct({
+  key: Schema.String,
+  label: Schema.String,
+  role: MetricRoleSchema,
+  remainingPct: Schema.Finite,
+  included: Schema.Boolean,
+  reason: Schema.Literals(["session", "active-model", "weekly-cap", "primary", "fallback-floor"])
+});
+var HeadroomViewSchema = Schema.Struct({
+  value: Schema.NullOr(Schema.Finite),
+  unit: Schema.Literal("index-100"),
+  mode: Schema.Literals(["smart", "single-window", "fallback-floor", "unavailable"]),
+  basis: Schema.Literals(["active", "idle-runway", "unavailable"]),
+  representativeAccountId: Schema.NullOr(Schema.String),
+  activeAccountIds: Schema.Array(Schema.String),
+  factors: Schema.Array(HeadroomFactorSchema),
+  explanation: Schema.String
+});
+var BillingResultSchema = Schema.Struct({
+  plan: Schema.NullOr(Schema.String),
+  metrics: Schema.Array(MetricSchema),
+  error: Schema.NullOr(Schema.String),
+  email: Schema.optionalKey(Schema.NullOr(Schema.String)),
+  displayName: Schema.optionalKey(Schema.NullOr(Schema.String)),
+  activity: Schema.optionalKey(Schema.NullOr(Schema.Struct({
+    series: Schema.Array(Schema.Finite),
+    summary: Schema.String
+  }))),
+  modelSpend: Schema.optionalKey(Schema.NullOr(Schema.Array(Schema.Struct({
+    name: Schema.String,
+    usd: Schema.Finite,
+    requests: Schema.Finite
+  })))),
+  asOfMs: Schema.optionalKey(NonNegativeIntegerSchema)
+});
+var WebAccountSchema = Schema.Struct({
+  id: Schema.String,
+  providerId: ProviderIdSchema,
+  name: Schema.String,
+  color: Schema.String,
+  homeDir: Schema.NullOr(Schema.String),
+  hasUsage: Schema.Boolean,
+  hasBilling: Schema.Boolean,
+  email: Schema.optionalKey(Schema.NullOr(Schema.String)),
+  displayName: Schema.optionalKey(Schema.NullOr(Schema.String)),
+  identity: Schema.optionalKey(AccountIdentityViewSchema),
+  quotas: Schema.optionalKey(Schema.Array(QuotaViewSchema)),
+  headroom: Schema.optionalKey(HeadroomViewSchema),
+  plan: Schema.optionalKey(Schema.NullOr(Schema.String)),
+  lastActivityAt: Schema.NullOr(NonNegativeIntegerSchema),
+  dashboard: Schema.NullOr(DashboardDataSchema),
+  table: Schema.NullOr(TableDataSchema),
+  billing: Schema.NullOr(BillingResultSchema),
+  summaryState: Schema.Literals(["pending", "ready", "error"]),
+  billingState: Schema.Literals(["pending", "ready", "error"]),
+  tableState: Schema.Literals(["pending", "ready", "error"]),
+  summaryUpdatedAt: Schema.optionalKey(Schema.NullOr(NonNegativeIntegerSchema)),
+  billingUpdatedAt: Schema.optionalKey(Schema.NullOr(NonNegativeIntegerSchema)),
+  tableUpdatedAt: Schema.optionalKey(Schema.NullOr(NonNegativeIntegerSchema))
+});
+var WebSnapshotSchema = Schema.Struct({
+  version: Schema.String,
+  generatedAt: NonNegativeIntegerSchema,
+  tz: Schema.String,
+  intervalMs: PositiveFiniteSchema,
+  billingIntervalMs: Schema.optionalKey(PositiveFiniteSchema),
+  providers: Schema.Array(Schema.Struct({
+    id: ProviderIdSchema,
+    name: Schema.String,
+    color: Schema.String,
+    headroom: Schema.optionalKey(HeadroomViewSchema)
+  })),
+  accounts: Schema.Array(WebAccountSchema),
+  seeded: Schema.Boolean,
+  peak: Schema.NullOr(Schema.Struct({
+    state: Schema.Literals(["peak", "off-peak", "weekend"]),
+    label: Schema.String,
+    // The upstream clock is only normalized to a finite number; do not make
+    // the wire contract narrower than the producer's declared type.
+    minutesUntilChange: Schema.NullOr(Schema.Finite),
+    changesAt: Schema.optionalKey(Schema.NullOr(Schema.String))
+  }))
+});
+var EmptyPayloadSchema = Schema.Struct({});
+var GetConfigRpc = Rpc.make(TOKMON_WS_METHODS.getConfig, {
+  payload: EmptyPayloadSchema,
+  success: ConfigStateSchema
+});
+var SetConfigRpc = Rpc.make(TOKMON_WS_METHODS.setConfig, {
+  payload: ConfigUpdateRequestSchema,
+  success: ConfigStateSchema,
+  error: Schema.Union([ConfigUpdateConflictSchema, ConfigPersistenceFailureSchema])
+});
+var RefreshRpc = Rpc.make(TOKMON_WS_METHODS.refresh, {
+  payload: Schema.Struct({ scope: RefreshScopeSchema }),
+  success: Schema.Void,
+  error: RefreshFailure
+});
+var BrowseFsRpc = Rpc.make(TOKMON_WS_METHODS.browseFs, {
+  payload: Schema.Struct({ path: Schema.String }),
+  success: FsListingSchema
+});
+var SnapshotRpc = Rpc.make(TOKMON_WS_METHODS.snapshot, {
+  payload: EmptyPayloadSchema,
+  success: WebSnapshotSchema,
+  stream: true
+});
+var ConfigRpc = Rpc.make(TOKMON_WS_METHODS.config, {
+  payload: EmptyPayloadSchema,
+  success: ConfigStateSchema,
+  stream: true
+});
+var TokmonRpcGroup = RpcGroup.make(
+  GetConfigRpc,
+  SetConfigRpc,
+  RefreshRpc,
+  BrowseFsRpc,
+  SnapshotRpc,
+  ConfigRpc
+);
+
+export {
+  TOKMON_WS_PATH,
+  TOKMON_PROTOCOL_VERSION,
+  TOKMON_CAPABILITIES,
+  TOKMON_WS_METHODS,
+  ConfigUpdateConflictFailure,
+  ConfigPersistenceFailure,
+  RefreshFailure,
+  TokmonRpcGroup
+};