agent-steward 0.0.3 → 0.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (171) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/README.md +3 -3
  3. package/ROADMAP-STRATEGY.md +9 -9
  4. package/ROADMAP.md +50 -34
  5. package/dist/core/dlq-api.d.ts +44 -0
  6. package/dist/core/dlq-api.d.ts.map +1 -0
  7. package/dist/core/dlq-api.js +68 -0
  8. package/dist/core/dry-run.d.ts.map +1 -1
  9. package/dist/core/dry-run.js +18 -1
  10. package/dist/core/lock.d.ts +20 -4
  11. package/dist/core/lock.d.ts.map +1 -1
  12. package/dist/core/lock.js +97 -22
  13. package/dist/core/one-shot.d.ts +5 -1
  14. package/dist/core/one-shot.d.ts.map +1 -1
  15. package/dist/core/one-shot.js +33 -8
  16. package/dist/core/opencode-cli.d.ts +28 -0
  17. package/dist/core/opencode-cli.d.ts.map +1 -0
  18. package/dist/core/opencode-cli.js +74 -0
  19. package/dist/core/opencode-models.d.ts +62 -0
  20. package/dist/core/opencode-models.d.ts.map +1 -0
  21. package/dist/core/opencode-models.js +277 -0
  22. package/dist/core/ps-wrapper.d.ts +1 -1
  23. package/dist/core/ps-wrapper.d.ts.map +1 -1
  24. package/dist/core/ps-wrapper.js +11 -1
  25. package/dist/core/record-history.d.ts +15 -0
  26. package/dist/core/record-history.d.ts.map +1 -1
  27. package/dist/core/record-history.js +56 -32
  28. package/dist/core/router/dispatch.d.ts +36 -0
  29. package/dist/core/router/dispatch.d.ts.map +1 -0
  30. package/dist/core/router/dispatch.js +59 -0
  31. package/dist/core/router/escalation.d.ts +47 -0
  32. package/dist/core/router/escalation.d.ts.map +1 -0
  33. package/dist/core/router/escalation.js +87 -0
  34. package/dist/core/router/planner.d.ts +53 -0
  35. package/dist/core/router/planner.d.ts.map +1 -0
  36. package/dist/core/router/planner.js +113 -0
  37. package/dist/core/router/rules.d.ts +46 -0
  38. package/dist/core/router/rules.d.ts.map +1 -0
  39. package/dist/core/router/rules.js +85 -0
  40. package/dist/core/run-panel-api.d.ts +94 -0
  41. package/dist/core/run-panel-api.d.ts.map +1 -0
  42. package/dist/core/run-panel-api.js +169 -0
  43. package/dist/core/schedule-gate.js +5 -1
  44. package/dist/core/schedule-v2.d.ts +34 -0
  45. package/dist/core/schedule-v2.d.ts.map +1 -1
  46. package/dist/core/schedule-v2.js +91 -5
  47. package/dist/core/scheduler/at-fallback.d.ts +55 -2
  48. package/dist/core/scheduler/at-fallback.d.ts.map +1 -1
  49. package/dist/core/scheduler/at-fallback.js +135 -5
  50. package/dist/core/scheduler/linux.d.ts +10 -1
  51. package/dist/core/scheduler/linux.d.ts.map +1 -1
  52. package/dist/core/scheduler/linux.js +29 -11
  53. package/dist/core/scheduler/posix.d.ts.map +1 -1
  54. package/dist/core/scheduler/posix.js +25 -1
  55. package/dist/core/scheduler/registry.d.ts +11 -0
  56. package/dist/core/scheduler/registry.d.ts.map +1 -1
  57. package/dist/core/scheduler/registry.js +83 -21
  58. package/dist/core/scheduler/run-now.d.ts +16 -0
  59. package/dist/core/scheduler/run-now.d.ts.map +1 -0
  60. package/dist/core/scheduler/run-now.js +28 -0
  61. package/dist/core/secrets.d.ts.map +1 -1
  62. package/dist/core/secrets.js +125 -28
  63. package/dist/core/session.d.ts.map +1 -1
  64. package/dist/core/session.js +18 -11
  65. package/dist/core/task-name.d.ts +24 -0
  66. package/dist/core/task-name.d.ts.map +1 -0
  67. package/dist/core/task-name.js +40 -0
  68. package/dist/core/wrappers/bash.d.ts.map +1 -1
  69. package/dist/core/wrappers/bash.js +49 -4
  70. package/dist/db/capability-repo.d.ts +83 -0
  71. package/dist/db/capability-repo.d.ts.map +1 -0
  72. package/dist/db/capability-repo.js +182 -0
  73. package/dist/db/history-repo.d.ts +8 -0
  74. package/dist/db/history-repo.d.ts.map +1 -1
  75. package/dist/db/history-repo.js +19 -0
  76. package/dist/db/index.d.ts +4 -0
  77. package/dist/db/index.d.ts.map +1 -1
  78. package/dist/db/index.js +39 -1
  79. package/dist/db/migrate.d.ts.map +1 -1
  80. package/dist/db/migrate.js +3 -1
  81. package/dist/db/run-context.d.ts +103 -0
  82. package/dist/db/run-context.d.ts.map +1 -0
  83. package/dist/db/run-context.js +224 -0
  84. package/dist/db/run-dlq.d.ts +100 -0
  85. package/dist/db/run-dlq.d.ts.map +1 -0
  86. package/dist/db/run-dlq.js +191 -0
  87. package/dist/db/run-resume.d.ts +5 -2
  88. package/dist/db/run-resume.d.ts.map +1 -1
  89. package/dist/db/run-resume.js +30 -11
  90. package/dist/db/runs-repo.d.ts +13 -5
  91. package/dist/db/runs-repo.d.ts.map +1 -1
  92. package/dist/db/runs-repo.js +28 -5
  93. package/dist/db/schema.d.ts +2 -2
  94. package/dist/db/schema.d.ts.map +1 -1
  95. package/dist/db/schema.js +154 -2
  96. package/dist/db/settings-repo.d.ts +11 -0
  97. package/dist/db/settings-repo.d.ts.map +1 -1
  98. package/dist/db/settings-repo.js +25 -0
  99. package/dist/db/step-idempotency.d.ts +51 -0
  100. package/dist/db/step-idempotency.d.ts.map +1 -0
  101. package/dist/db/step-idempotency.js +136 -0
  102. package/dist/index.d.ts +4 -4
  103. package/dist/index.d.ts.map +1 -1
  104. package/dist/index.js +102 -4
  105. package/dist/rpc.d.ts +678 -0
  106. package/dist/rpc.d.ts.map +1 -1
  107. package/dist/rpc.js +235 -0
  108. package/dist/server.d.ts +31 -0
  109. package/dist/server.d.ts.map +1 -1
  110. package/dist/server.js +95 -35
  111. package/dist/types.d.ts.map +1 -1
  112. package/dist/types.js +7 -0
  113. package/dist/workspaces.d.ts +25 -3
  114. package/dist/workspaces.d.ts.map +1 -1
  115. package/dist/workspaces.js +43 -8
  116. package/docs/ARCHITECTURE.md +229 -5
  117. package/docs/CONCEPT.md +171 -91
  118. package/docs/EXECUTION-LOOP.md +196 -0
  119. package/docs/README.ru.md +2 -2
  120. package/docs/README.zh.md +3 -3
  121. package/docs/SAFETY.md +122 -0
  122. package/docs/SAVINGS.md +29 -0
  123. package/docs/SAVINGS.ru.md +29 -0
  124. package/docs/SAVINGS.zh.md +18 -0
  125. package/gui-experimental.cjs +8 -8
  126. package/locales/en.json +67 -0
  127. package/locales/ru.json +67 -0
  128. package/locales/zh.json +67 -0
  129. package/package.json +28 -3
  130. package/scripts/audit-bundle.mjs +215 -0
  131. package/src/core/dlq-api.ts +98 -0
  132. package/src/core/dry-run.ts +25 -1
  133. package/src/core/lock.ts +95 -22
  134. package/src/core/one-shot.ts +36 -8
  135. package/src/core/opencode-cli.ts +103 -0
  136. package/src/core/opencode-models.ts +315 -0
  137. package/src/core/ps-wrapper.ts +11 -1
  138. package/src/core/record-history.ts +75 -37
  139. package/src/core/router/dispatch.ts +94 -0
  140. package/src/core/router/escalation.ts +129 -0
  141. package/src/core/router/planner.ts +166 -0
  142. package/src/core/router/rules.ts +109 -0
  143. package/src/core/run-panel-api.ts +262 -0
  144. package/src/core/schedule-gate.ts +6 -2
  145. package/src/core/schedule-v2.ts +114 -5
  146. package/src/core/scheduler/at-fallback.ts +190 -5
  147. package/src/core/scheduler/linux.ts +32 -10
  148. package/src/core/scheduler/posix.ts +20 -1
  149. package/src/core/scheduler/registry.ts +107 -26
  150. package/src/core/scheduler/run-now.ts +32 -0
  151. package/src/core/secrets.ts +127 -27
  152. package/src/core/session.ts +23 -10
  153. package/src/core/task-name.ts +67 -0
  154. package/src/core/wrappers/bash.ts +49 -4
  155. package/src/db/capability-repo.ts +285 -0
  156. package/src/db/history-repo.ts +22 -0
  157. package/src/db/index.ts +37 -1
  158. package/src/db/migrate.ts +3 -1
  159. package/src/db/run-context.ts +370 -0
  160. package/src/db/run-dlq.ts +310 -0
  161. package/src/db/run-resume.ts +48 -12
  162. package/src/db/runs-repo.ts +30 -7
  163. package/src/db/schema.ts +154 -2
  164. package/src/db/settings-repo.ts +31 -0
  165. package/src/db/step-idempotency.ts +185 -0
  166. package/src/gui.tsx +515 -0
  167. package/src/index.ts +124 -4
  168. package/src/rpc.ts +251 -0
  169. package/src/server.ts +112 -36
  170. package/src/types.ts +9 -0
  171. package/src/workspaces.ts +58 -9
package/docs/README.ru.md CHANGED
@@ -18,7 +18,7 @@ Translations: [English](../README.md) · [中文](README.zh.md).
18
18
 
19
19
  > Поставь задачу «утренний-отчёт»: каждый день в 09:00 с промптом «Просуммаризируй вчерашние git-коммиты и запиши отчёт в ~/reports/».
20
20
 
21
- 3. Откройте дашборд: агент печатает ссылку при создании задачи (по умолчанию `http://localhost:4380`), позже её можно получить инструментом `get_dashboard_info`. Посмотреть демо без установки: `node scripts/demo-dashboard.mjs` — дашборд с демо-данными на `http://localhost:4380`.
21
+ 3. Откройте дашборд: агент печатает ссылку при создании задачи (по умолчанию `http://localhost:3782`), позже её можно получить инструментом `get_dashboard_info`. Посмотреть демо без установки: `node scripts/demo-dashboard.mjs` — дашборд с демо-данными на `http://localhost:3782`.
22
22
 
23
23
  ![Локальный веб-дашборд: матричные сборки, граф DAG, метрики и история запусков](dashboard.png)
24
24
 
@@ -224,7 +224,7 @@ src/
224
224
  npm install
225
225
  npm run build # tsc
226
226
  npm run build:gui # vite
227
- npm test # 73 сюит, 600+ проверок
227
+ npm test # 83 сюит, 600+ проверок
228
228
  npm run test:en # те же сюиты с английской локалью
229
229
  ```
230
230
 
package/docs/README.zh.md CHANGED
@@ -19,7 +19,7 @@ Translations: [English](../README.md) · [Русский](README.ru.md).
19
19
 
20
20
  > 创建一个名为 "morning-report" 的任务,每天 09:00 运行,提示词为:"Summarize yesterday's git commits and write the report to ~/reports/"。
21
21
 
22
- 3. 打开仪表盘观察运行情况:创建任务时 agent 会打印 URL(默认 `http://localhost:4380`),之后也可以随时用 `get_dashboard_info` 工具获取。想不安装任何东西先看看效果?`node scripts/demo-dashboard.mjs` 会在 `http://localhost:4380` 启动一个演示仪表盘。
22
+ 3. 打开仪表盘观察运行情况:创建任务时 agent 会打印 URL(默认 `http://localhost:3782`),之后也可以随时用 `get_dashboard_info` 工具获取。想不安装任何东西先看看效果?`node scripts/demo-dashboard.mjs` 会在 `http://localhost:3782` 启动一个演示仪表盘。
23
23
 
24
24
  ## 为什么需要它
25
25
 
@@ -35,7 +35,7 @@ Translations: [English](../README.md) · [Русский](README.ru.md).
35
35
 
36
36
  ![本地 Web 仪表盘:矩阵构建、DAG 图、指标与运行历史](dashboard.png)
37
37
 
38
- 不想安装 OpenCode 也想看看效果?`node scripts/demo-dashboard.mjs` 会用演示数据在 http://localhost:4380 启动仪表盘。
38
+ 不想安装 OpenCode 也想看看效果?`node scripts/demo-dashboard.mjs` 会用演示数据在 http://localhost:3782 启动仪表盘。
39
39
 
40
40
  ## 功能
41
41
 
@@ -231,7 +231,7 @@ src/
231
231
  npm install
232
232
  npm run build # tsc
233
233
  npm run build:gui # vite
234
- npm test # 73 test suites, 600+ checks
234
+ npm test # 83 test suites, 600+ checks
235
235
  npm run test:en # same suites with the English locale
236
236
  ```
237
237
 
package/docs/SAFETY.md ADDED
@@ -0,0 +1,122 @@
1
+ # SAFETY — контракт безопасности миссии
2
+
3
+ > Шаг 1 цикла v2.1. Принцип: **продукт для людей** — не сломать репо, не слить
4
+ > данные, не разорить. Порядок столпов: надёжно > приватно > дёшево > фичи.
5
+ > Контракт одинаков для **ad-hoc**, внутренних и registered запусков.
6
+
7
+ ## 1. Классы риска
8
+
9
+ | Класс | Что делает | Примеры | Default |
10
+ |-------|-----------|---------|---------|
11
+ | **R0** read-only | Читает, ничего не меняет | анализ, отчёт, обзор | разрешён |
12
+ | **R1** local-write | Меняет файлы в изолированном worktree | правка кода, бойлерплейт | разрешён в worktree |
13
+ | **R2** external-effect | Меняет внешнее состояние | git push, PR, API-запись, деплой | **approval + отложенные эффекты** |
14
+ | **R3** destructive / egress | Удаляет, льёт данные наружу | reset --hard, удаление, отправка наружу | **approval + явный opt-in** |
15
+
16
+ Класс определяется по **инструментам и командам**, а не по описанию миссии.
17
+
18
+ ## 2. Компиляция политики (принуждение, не декларация)
19
+
20
+ ```
21
+ risk R2 → allowedTools: [read, edit, glob, grep]
22
+ deniedTools: [shell]
23
+ egress: [] (кроме явного allowlist)
24
+ requiredGates: [tests, lint, approval]
25
+ effects: deferred (intents)
26
+ budget: из контракта
27
+ ```
28
+
29
+ - Enforcement — существующие `permissions` / `OPENCODE_CONFIG_CONTENT` +
30
+ egress-контроль на уровне исполнения.
31
+ - `policy_hash` пишется в ledger; изменение политики посреди миссии → `fail` +
32
+ аудит-инцидент.
33
+ - Внешние policy-движки (OPA/Cedar) на этом этапе не используем: локальная одна
34
+ машина, мало зависимостей.
35
+
36
+ ## 3. Capability issuance на шаг
37
+
38
+ - Агент получает **scoped-конфиг ровно на шаг**, не на миссию.
39
+ - Секреты — короткоживущая инъекция только используемых (`collectSecretNames`),
40
+ очистка после шага.
41
+ - Никаких долгоживущих токенов в окружении задачи.
42
+
43
+ ## 4. Уровни изоляции
44
+
45
+ | Уровень | Механизм | Когда |
46
+ |---------|----------|-------|
47
+ | 1 (default) | git worktree | R0/R1 |
48
+ | 2 | OS-jail: ограничение ФС/процессов | R1 с недоверенным контентом |
49
+ | 3 | Docker runner (opt-in, спринт 46) | R2/R3, недоверенные зависимости |
50
+
51
+ **Worktree не защищает от сети/API/БД** — поэтому обязателен следующий раздел.
52
+
53
+ ## 5. Отложенные внешние эффекты
54
+
55
+ 1. До гейта агент **не выполняет** irreversible-действие, а пишет `effect_intents`.
56
+ 2. Гейт проверяет артефакт и валидность intents (политика, egress, blast-radius).
57
+ 3. `pass` → применение, отметка `effects_applied_at`.
58
+ 4. `fail` → discard; частично применённые — компенсация (saga).
59
+
60
+ Так «локальность» действительно ограничивает ущерб, а не только конфликты файлов.
61
+
62
+ ## 6. Blast-radius
63
+
64
+ - Работа в worktree; основное дерево не трогается до принятия.
65
+ - Запрет push в защищённые ветки; лимит числа файлов и объёма diff.
66
+ - Egress только по явному allowlist; всё в аудит.
67
+ - Destructive-команды запрещены без явного разрешения в контракте.
68
+
69
+ ## 7. Бюджет миссии (живой)
70
+
71
+ ```yaml
72
+ budget:
73
+ maxUsd: 0.50
74
+ maxTokens: 200000
75
+ maxMinutes: 30
76
+ maxEscalations: 2
77
+ ```
78
+
79
+ Счётчик ведётся в durable-run и учитывает **верификацию и эскалации**. При
80
+ подходе к границе роутинг предлагает более дешёвую модель или `review`;
81
+ превышение → circuit-breaker, статус `review`, уведомление.
82
+
83
+ ## 8. Approval-матрица
84
+
85
+ | Условие | Требуется |
86
+ |---------|-----------|
87
+ | R0 / R1 в worktree | нет |
88
+ | R2 (внешний эффект) | approval + отложенные эффекты |
89
+ | R3 (destructive / egress) | approval + явный opt-in |
90
+ | Превышен бюджет | остановка + review |
91
+ | Capability-карта даёт `review` | очередь человеку с evidence |
92
+
93
+ `approval` — **тип гейта**. Исполнение — на существующей паузе с инъекциями:
94
+ paused-миссия **не потребляет compute**, комментарий человека доставляется шагу
95
+ при resume.
96
+
97
+ ## 9. Least privilege и недоверенный контент
98
+
99
+ - Политика прав задачи (`hybrid` по умолчанию) — пол, не потолок.
100
+ - Gate-файлы и gate-команда вне write-scope агента.
101
+ - Внешний контент (web, issues, PR) — недоверенный по умолчанию: prompt-injection
102
+ учитывается как угроза.
103
+ - Секреты маскируются в логах, истории и аудите.
104
+
105
+ ## 10. Kill switch
106
+
107
+ - Остановка миссии в любой момент; откат worktree чистый, intents отбрасываются.
108
+ - Глобальная пауза планировщика останавливает новые **registered** запуски;
109
+ ad-hoc миссии можно запускать и на паузе планировщика (это разные подсистемы).
110
+
111
+ ## 11. Инварианты (проверяются тестами)
112
+
113
+ 1. Миссия без gate-спеки не принимается.
114
+ 2. Миссия без safety-контракта получает safe-default (R1, worktree, бюджет).
115
+ 3. R2/R3 без approval не стартует.
116
+ 4. Агент не получает инструмент, запрещённый скомпилированной политикой.
117
+ 5. Агент не может изменить gate-файлы (`gate_hash` сверяется).
118
+ 6. Irreversible-действие невозможно до `pass`.
119
+ 7. Превышение бюджета останавливает миссию.
120
+ 8. Каждый вердикт, эскалация и применение эффектов попадают в аудит.
121
+ 9. **Ad-hoc миссия проходит ту же политику, бюджет и gate, что и registered.**
122
+ 10. **Ad-hoc миссия не создаёт записей в планировщике ОС.**
package/docs/SAVINGS.md CHANGED
@@ -42,6 +42,35 @@ there is nothing to compare.
42
42
  So the counter answers "how much would this cost in the cloud at the reference
43
43
  price", not "how much money came back to the account".
44
44
 
45
+ ## What-If models and prices
46
+
47
+ The dashboard block "what if every run used model X" does not rely on a fixed
48
+ model list any more. Both the list and the prices come from OpenCode itself:
49
+
50
+ 1. **Available models** — `opencode models`, i.e. exactly the models configured
51
+ on this machine (providers, keys, local Ollama models). Models that already
52
+ appear in the run history go first; after them there is one model per
53
+ distinct price level (cheapest, middle, most expensive), at most five
54
+ entries in total.
55
+ 2. **Prices** — the models.dev catalogue that OpenCode caches in
56
+ `<cache>/opencode/models.json` (`cost.input` / `cost.output`, USD per 1M
57
+ tokens). History does not split tokens into input and output, so the
58
+ estimate uses the average of the two prices.
59
+
60
+ Price lookup order: `OPENCODE_SCHEDULER_MODEL_PRICES` (JSON) → OpenCode
61
+ catalogue → built-in table → $3 per 1M tokens. Local providers (Ollama,
62
+ LM Studio) and `*-free` models cost zero.
63
+
64
+ | Variable | Meaning |
65
+ | --- | --- |
66
+ | `OPENCODE_SCHEDULER_WHAT_IF_MODELS` | explicit JSON list, replaces the selection |
67
+ | `OPENCODE_SCHEDULER_MODEL_PRICES` | explicit prices, for example `{"openai/gpt-4o": 2.5}` |
68
+ | `OPENCODE_SCHEDULER_MODELS_CACHE` | path to another `models.json` |
69
+ | `OPENCODE_SCHEDULER_MODEL_SOURCE=static` | never call OpenCode, use built-in values only |
70
+
71
+ If OpenCode is not reachable, the block falls back to the built-in list and
72
+ prices, so the dashboard keeps working.
73
+
45
74
  ## API
46
75
 
47
76
  `get_analytics` returns `report.savings`:
@@ -41,6 +41,35 @@ Translations: [English](SAVINGS.md) · [中文](SAVINGS.zh.md)
41
41
  Поэтому счётчик отвечает на вопрос «сколько бы это стоило в облаке по
42
42
  эталонной цене», а не «сколько денег вернулось на счёт».
43
43
 
44
+ ## What-If: модели и цены
45
+
46
+ Блок дашборда «если бы все запуски шли через модель X» больше не опирается на
47
+ захардкоженный список. И список, и цены берутся из самого OpenCode:
48
+
49
+ 1. **Доступные модели** — `opencode models`, то есть ровно то, что настроено
50
+ на этой машине (провайдеры, ключи, локальные модели Ollama). Первыми идут
51
+ модели, которые уже встречались в истории запусков, дальше — по одной
52
+ модели на каждую цену (самая дешёвая, средняя, самая дорогая). Всего не
53
+ больше пяти строк.
54
+ 2. **Цены** — каталог models.dev, который OpenCode держит в
55
+ `<cache>/opencode/models.json` (`cost.input` / `cost.output`, USD за 1M
56
+ токенов). История не делит токены на входные и выходные, поэтому берётся
57
+ среднее из двух цен.
58
+
59
+ Порядок выбора цены: `OPENCODE_SCHEDULER_MODEL_PRICES` (JSON) → каталог
60
+ OpenCode → встроенная таблица → 3 $ за 1M токенов. Локальные провайдеры
61
+ (Ollama, LM Studio) и модели `*-free` считаются бесплатными.
62
+
63
+ | Переменная | Значение |
64
+ | --- | --- |
65
+ | `OPENCODE_SCHEDULER_WHAT_IF_MODELS` | явный JSON-список, заменяет подбор |
66
+ | `OPENCODE_SCHEDULER_MODEL_PRICES` | явные цены, например `{"openai/gpt-4o": 2.5}` |
67
+ | `OPENCODE_SCHEDULER_MODELS_CACHE` | путь к другому `models.json` |
68
+ | `OPENCODE_SCHEDULER_MODEL_SOURCE=static` | не обращаться к OpenCode, только встроенные значения |
69
+
70
+ Если OpenCode недоступен, блок откатывается на встроенный список и цены —
71
+ дашборд продолжает работать.
72
+
44
73
  ## API
45
74
 
46
75
  `get_analytics` возвращает `report.savings`:
@@ -33,6 +33,24 @@ Translations: [English](SAVINGS.md) · [Русский](SAVINGS.ru.md)
33
33
 
34
34
  因此该计数器回答的是「按参考价格在云端要花多少钱」,而不是「实际退回了多少钱」。
35
35
 
36
+ ## What-If:模型与价格
37
+
38
+ 仪表盘的「如果所有运行都使用模型 X」区块不再依赖硬编码列表。列表和价格都来自 OpenCode 本身:
39
+
40
+ 1. **可用模型** —— `opencode models`,即本机实际配置的模型(提供商、密钥、本地 Ollama 模型)。先列出运行历史中出现过的模型,之后每种价格只列一个(最便宜、中间、最贵),总共不超过五行。
41
+ 2. **价格** —— OpenCode 缓存在 `<cache>/opencode/models.json` 的 models.dev 目录(`cost.input` / `cost.output`,USD / 1M token)。历史记录不区分输入与输出 token,因此取两者价格的平均值。
42
+
43
+ 价格顺序:`OPENCODE_SCHEDULER_MODEL_PRICES`(JSON)→ OpenCode 目录 → 内置表 → 每 1M token 3 美元。本地提供商(Ollama、LM Studio)和 `*-free` 模型按零计算。
44
+
45
+ | 变量 | 含义 |
46
+ | --- | --- |
47
+ | `OPENCODE_SCHEDULER_WHAT_IF_MODELS` | 显式 JSON 列表,替换自动选择 |
48
+ | `OPENCODE_SCHEDULER_MODEL_PRICES` | 显式价格,例如 `{"openai/gpt-4o": 2.5}` |
49
+ | `OPENCODE_SCHEDULER_MODELS_CACHE` | 指向另一个 `models.json` |
50
+ | `OPENCODE_SCHEDULER_MODEL_SOURCE=static` | 不访问 OpenCode,只用内置值 |
51
+
52
+ 如果 OpenCode 不可用,该区块会回退到内置列表和价格,仪表盘继续正常工作。
53
+
36
54
  ## API
37
55
 
38
56
  `get_analytics` 返回 `report.savings`: