@echo-escape/dsh-cost-governor

Configuration

Configure the plugin in your session's cordis.yml:

plugins:
  cost-governor:
    enabled: true
    config:
      currency: "USD"
      maxSessionBudgetUsd: 5.0
      compactionThresholdPercent: 80
      modelRates:
        deepseek-chat:
          inputPerM: 0.27
          outputPerM: 1.10
          cacheHitInputPerM: 0.07
        deepseek-reasoner:
          inputPerM: 0.55
          outputPerM: 2.19
          cacheHitInputPerM: 0.14

Usage

The plugin automatically registers the get_cost_stats tool on ctx.tools. An agent or caller can execute this tool to retrieve structured cost statistics:

{
  "status": "success",
  "currency": "USD",
  "totalTokens": 150000,
  "promptTokens": 100000,
  "completionTokens": 50000,
  "cacheHitTokens": 20000,
  "totalCostUsd": 0.0806,
  "recordCount": 5,
  "byModel": {
    "deepseek-chat": {
      "promptTokens": 100000,
      "completionTokens": 50000,
      "costUsd": 0.0806
    }
  }
}