agent-steward 0.0.2 → 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.
- package/CHANGELOG.md +45 -2
- package/CROSS_PLATFORM.md +11 -9
- package/README.md +11 -10
- package/ROADMAP-STRATEGY.md +93 -44
- package/ROADMAP.md +148 -1017
- package/dist/core/cron-to-schtasks.d.ts +0 -8
- package/dist/core/cron-to-schtasks.d.ts.map +1 -1
- package/dist/core/cron-to-schtasks.js +11 -86
- package/dist/core/dlq-api.d.ts +44 -0
- package/dist/core/dlq-api.d.ts.map +1 -0
- package/dist/core/dlq-api.js +68 -0
- package/dist/core/dry-run.d.ts.map +1 -1
- package/dist/core/dry-run.js +19 -2
- package/dist/core/file-watcher.js +9 -9
- package/dist/core/git-trigger.js +4 -4
- package/dist/core/lock.d.ts +20 -4
- package/dist/core/lock.d.ts.map +1 -1
- package/dist/core/lock.js +99 -26
- package/dist/core/one-shot.d.ts +31 -5
- package/dist/core/one-shot.d.ts.map +1 -1
- package/dist/core/one-shot.js +78 -10
- package/dist/core/opencode-cli.d.ts +28 -0
- package/dist/core/opencode-cli.d.ts.map +1 -0
- package/dist/core/opencode-cli.js +74 -0
- package/dist/core/opencode-models.d.ts +62 -0
- package/dist/core/opencode-models.d.ts.map +1 -0
- package/dist/core/opencode-models.js +277 -0
- package/dist/core/otel.js +2 -2
- package/dist/core/ps-wrapper.d.ts +1 -1
- package/dist/core/ps-wrapper.d.ts.map +1 -1
- package/dist/core/ps-wrapper.js +66 -36
- package/dist/core/record-history.d.ts +15 -0
- package/dist/core/record-history.d.ts.map +1 -1
- package/dist/core/record-history.js +78 -54
- package/dist/core/router/dispatch.d.ts +36 -0
- package/dist/core/router/dispatch.d.ts.map +1 -0
- package/dist/core/router/dispatch.js +59 -0
- package/dist/core/router/escalation.d.ts +47 -0
- package/dist/core/router/escalation.d.ts.map +1 -0
- package/dist/core/router/escalation.js +87 -0
- package/dist/core/router/planner.d.ts +53 -0
- package/dist/core/router/planner.d.ts.map +1 -0
- package/dist/core/router/planner.js +113 -0
- package/dist/core/router/rules.d.ts +46 -0
- package/dist/core/router/rules.d.ts.map +1 -0
- package/dist/core/router/rules.js +85 -0
- package/dist/core/run-panel-api.d.ts +94 -0
- package/dist/core/run-panel-api.d.ts.map +1 -0
- package/dist/core/run-panel-api.js +169 -0
- package/dist/core/schedule-gate.js +5 -1
- package/dist/core/schedule-v2.d.ts +36 -2
- package/dist/core/schedule-v2.d.ts.map +1 -1
- package/dist/core/schedule-v2.js +98 -12
- package/dist/core/scheduler/at-fallback.d.ts +95 -0
- package/dist/core/scheduler/at-fallback.d.ts.map +1 -0
- package/dist/core/scheduler/at-fallback.js +200 -0
- package/dist/core/scheduler/linux.d.ts +13 -2
- package/dist/core/scheduler/linux.d.ts.map +1 -1
- package/dist/core/scheduler/linux.js +67 -13
- package/dist/core/scheduler/mac.d.ts +14 -8
- package/dist/core/scheduler/mac.d.ts.map +1 -1
- package/dist/core/scheduler/mac.js +71 -22
- package/dist/core/scheduler/posix.d.ts.map +1 -1
- package/dist/core/scheduler/posix.js +37 -2
- package/dist/core/scheduler/registry.d.ts +13 -0
- package/dist/core/scheduler/registry.d.ts.map +1 -1
- package/dist/core/scheduler/registry.js +83 -21
- package/dist/core/scheduler/run-now.d.ts +16 -0
- package/dist/core/scheduler/run-now.d.ts.map +1 -0
- package/dist/core/scheduler/run-now.js +28 -0
- package/dist/core/scheduler/windows.d.ts +16 -3
- package/dist/core/scheduler/windows.d.ts.map +1 -1
- package/dist/core/scheduler/windows.js +249 -96
- package/dist/core/secrets.d.ts.map +1 -1
- package/dist/core/secrets.js +127 -30
- package/dist/core/self-analysis.js +55 -55
- package/dist/core/session.d.ts.map +1 -1
- package/dist/core/session.js +18 -11
- package/dist/core/summary.js +1 -1
- package/dist/core/task-name.d.ts +24 -0
- package/dist/core/task-name.d.ts.map +1 -0
- package/dist/core/task-name.js +40 -0
- package/dist/core/triage-chain.js +1 -1
- package/dist/core/triage-worker.js +2 -2
- package/dist/core/triage.js +1 -1
- package/dist/core/wrappers/bash.d.ts.map +1 -1
- package/dist/core/wrappers/bash.js +82 -37
- package/dist/db/capability-repo.d.ts +83 -0
- package/dist/db/capability-repo.d.ts.map +1 -0
- package/dist/db/capability-repo.js +182 -0
- package/dist/db/history-repo.d.ts +8 -0
- package/dist/db/history-repo.d.ts.map +1 -1
- package/dist/db/history-repo.js +19 -0
- package/dist/db/index.d.ts +6 -0
- package/dist/db/index.d.ts.map +1 -1
- package/dist/db/index.js +48 -2
- package/dist/db/migrate.d.ts.map +1 -1
- package/dist/db/migrate.js +3 -1
- package/dist/db/run-context.d.ts +103 -0
- package/dist/db/run-context.d.ts.map +1 -0
- package/dist/db/run-context.js +224 -0
- package/dist/db/run-dlq.d.ts +100 -0
- package/dist/db/run-dlq.d.ts.map +1 -0
- package/dist/db/run-dlq.js +191 -0
- package/dist/db/run-journal.d.ts +60 -0
- package/dist/db/run-journal.d.ts.map +1 -0
- package/dist/db/run-journal.js +143 -0
- package/dist/db/run-resume.d.ts +51 -0
- package/dist/db/run-resume.d.ts.map +1 -0
- package/dist/db/run-resume.js +156 -0
- package/dist/db/runs-repo.d.ts +128 -0
- package/dist/db/runs-repo.d.ts.map +1 -0
- package/dist/db/runs-repo.js +342 -0
- package/dist/db/schema.d.ts +16 -2
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +342 -35
- package/dist/db/settings-repo.d.ts +11 -0
- package/dist/db/settings-repo.d.ts.map +1 -1
- package/dist/db/settings-repo.js +25 -0
- package/dist/db/step-idempotency.d.ts +51 -0
- package/dist/db/step-idempotency.d.ts.map +1 -0
- package/dist/db/step-idempotency.js +136 -0
- package/dist/index.d.ts +5 -5
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +168 -40
- package/dist/notifications.js +18 -18
- package/dist/profiles.d.ts +7 -3
- package/dist/profiles.d.ts.map +1 -1
- package/dist/profiles.js +85 -7
- package/dist/rpc.d.ts +787 -0
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +324 -0
- package/dist/server.d.ts +33 -2
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +115 -54
- package/dist/shared/jobs-view.d.ts.map +1 -1
- package/dist/skill.js +1 -1
- package/dist/task-transfer.d.ts +1 -1
- package/dist/task-transfer.d.ts.map +1 -1
- package/dist/task-transfer.js +14 -10
- package/dist/types.d.ts +20 -4
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +44 -9
- package/dist/workspaces.d.ts +25 -3
- package/dist/workspaces.d.ts.map +1 -1
- package/dist/workspaces.js +44 -9
- package/docs/ARCHITECTURE.md +335 -9
- package/docs/COMPATIBILITY.md +10 -6
- package/docs/CONCEPT.md +183 -91
- package/docs/CROSS_PLATFORM.ru.md +11 -9
- package/docs/CROSS_PLATFORM.zh.md +11 -9
- package/docs/EXECUTION-LOOP.md +196 -0
- package/docs/FAQ.md +2 -2
- package/docs/FAQ.ru.md +2 -2
- package/docs/FAQ.zh.md +2 -2
- package/docs/FEATURES.md +5 -4
- package/docs/FEATURES.zh.md +5 -4
- package/docs/MIGRATION.md +34 -26
- package/docs/README.ru.md +27 -8
- package/docs/README.zh.md +11 -10
- package/docs/SAFETY.md +122 -0
- package/docs/SAVINGS.md +29 -0
- package/docs/SAVINGS.ru.md +29 -0
- package/docs/SAVINGS.zh.md +18 -0
- package/docs/V1-V2-COMPATIBILITY-PLAN.md +6 -6
- package/gui-experimental.cjs +8 -8
- package/index.js +1 -0
- package/locales/en.json +68 -0
- package/locales/ru.json +68 -0
- package/locales/zh.json +68 -0
- package/package.json +57 -11
- package/scripts/audit-bundle.mjs +215 -0
- package/src/core/analytics.ts +2 -2
- package/src/core/audit.ts +17 -17
- package/src/core/cron-to-schtasks.ts +14 -93
- package/src/core/dlq-api.ts +98 -0
- package/src/core/dry-run.ts +51 -27
- package/src/core/file-watcher.ts +17 -17
- package/src/core/git-trigger.ts +9 -9
- package/src/core/glob.ts +1 -1
- package/src/core/local-ai.ts +2 -2
- package/src/core/lock.ts +104 -31
- package/src/core/matrix.ts +31 -31
- package/src/core/native-notify.ts +2 -2
- package/src/core/one-shot.ts +91 -13
- package/src/core/opencode-cli.ts +103 -0
- package/src/core/opencode-models.ts +315 -0
- package/src/core/otel.ts +4 -4
- package/src/core/permissions.ts +5 -5
- package/src/core/prometheus.ts +17 -17
- package/src/core/ps-wrapper.ts +68 -38
- package/src/core/record-history.ts +114 -76
- package/src/core/retention.ts +3 -3
- package/src/core/router/dispatch.ts +94 -0
- package/src/core/router/escalation.ts +129 -0
- package/src/core/router/planner.ts +166 -0
- package/src/core/router/rules.ts +109 -0
- package/src/core/run-panel-api.ts +262 -0
- package/src/core/savings.ts +1 -1
- package/src/core/schedule-gate.ts +17 -13
- package/src/core/schedule-v2.ts +138 -29
- package/src/core/scheduler/at-fallback.ts +298 -0
- package/src/core/scheduler/index.ts +3 -3
- package/src/core/scheduler/linux.ts +92 -19
- package/src/core/scheduler/logs.ts +1 -1
- package/src/core/scheduler/mac.ts +112 -60
- package/src/core/scheduler/posix.ts +35 -2
- package/src/core/scheduler/registry.ts +109 -26
- package/src/core/scheduler/run-now.ts +32 -0
- package/src/core/scheduler/windows.ts +295 -125
- package/src/core/secrets.ts +139 -39
- package/src/core/self-analysis.ts +61 -61
- package/src/core/session.ts +26 -13
- package/src/core/structured-log.ts +3 -3
- package/src/core/summary.ts +25 -25
- package/src/core/task-name.ts +67 -0
- package/src/core/telegram.ts +16 -16
- package/src/core/triage-chain.ts +4 -4
- package/src/core/triage-compare.ts +8 -8
- package/src/core/triage-rules.ts +4 -4
- package/src/core/triage-shadow.ts +7 -7
- package/src/core/triage-worker.ts +6 -6
- package/src/core/triage.ts +23 -23
- package/src/core/watch-paths.ts +1 -1
- package/src/core/wrappers/bash.ts +90 -45
- package/src/db/capability-repo.ts +285 -0
- package/src/db/git-state-repo.ts +1 -1
- package/src/db/history-repo.ts +44 -22
- package/src/db/index.ts +53 -7
- package/src/db/metrics-repo.ts +10 -10
- package/src/db/migrate.ts +13 -11
- package/src/db/recovery.ts +3 -3
- package/src/db/run-context.ts +370 -0
- package/src/db/run-dlq.ts +310 -0
- package/src/db/run-journal.ts +212 -0
- package/src/db/run-resume.ts +256 -0
- package/src/db/runs-repo.ts +504 -0
- package/src/db/schema.ts +357 -44
- package/src/db/settings-repo.ts +33 -2
- package/src/db/step-idempotency.ts +185 -0
- package/src/db/tasks-repo.ts +10 -10
- package/src/db/templates-repo.ts +7 -7
- package/src/gui.tsx +516 -1
- package/src/history.ts +4 -4
- package/src/i18n.ts +7 -7
- package/src/index.ts +465 -308
- package/src/integrations.ts +6 -6
- package/src/notifications.ts +76 -76
- package/src/profiles.ts +98 -7
- package/src/rpc.ts +347 -1
- package/src/schtasks.ts +2 -2
- package/src/server.ts +155 -78
- package/src/settings.ts +44 -44
- package/src/shared/jobs-view.ts +60 -60
- package/src/skill.ts +1 -1
- package/src/task-transfer.ts +58 -56
- package/src/templates.ts +1 -1
- package/src/types.ts +54 -10
- package/src/workspaces.ts +73 -24
- package/dist/core/self-analysis.test.d.ts +0 -2
- package/dist/core/self-analysis.test.d.ts.map +0 -1
- package/dist/core/self-analysis.test.js +0 -219
- package/dist/gui-experimental.cjs +0 -1
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`:
|
package/docs/SAVINGS.ru.md
CHANGED
|
@@ -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`:
|
package/docs/SAVINGS.zh.md
CHANGED
|
@@ -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`:
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Статус: план утверждён по структуре, выполнение — по одной подзадаче.
|
|
4
4
|
Версия работ: `opencode-windows-scheduler@1.5.6`.
|
|
5
|
-
Переименование: milestone
|
|
5
|
+
Переименование: milestone Д7, пакет `agent-steward` начинается с `0.0.2`
|
|
6
6
|
(версия `0.0.1` занята placeholder-резервом).
|
|
7
7
|
|
|
8
8
|
## Принятые решения
|
|
@@ -65,13 +65,13 @@
|
|
|
65
65
|
(pinned, только типы), `peerDependencies` отсутствуют.
|
|
66
66
|
|
|
67
67
|
### Задача З1.2. Зафиксировать границы поверхности
|
|
68
|
-
- П1.2.1 — таблица «V1 / V2» в `
|
|
68
|
+
- П1.2.1 — таблица «V1 / V2» в `CROSS_PLATFORM.md` или отдельном документе. ✅
|
|
69
69
|
- П1.2.2 — явно указать: GUI и RPC — только V2; TUI — обе версии. ✅
|
|
70
70
|
- П1.2.3 — README: требование «OpenCode v2» заменить на «V1 >=1.18.29 или V2». ✅
|
|
71
71
|
|
|
72
72
|
### Задача З1.3. Инварианты состояния
|
|
73
73
|
- П1.3.1 — `plugin id` остаётся `opencode-windows-scheduler` до rename. ✅
|
|
74
|
-
- П1.3.2 — пути `%APPDATA
|
|
74
|
+
- П1.3.2 — пути `%APPDATA%\opencode\agent-steward`, SQLite и логов не меняются. ✅
|
|
75
75
|
- П1.3.3 — префикс задач планировщика не меняется. ✅
|
|
76
76
|
|
|
77
77
|
---
|
|
@@ -222,7 +222,7 @@
|
|
|
222
222
|
|
|
223
223
|
---
|
|
224
224
|
|
|
225
|
-
## Деталь Д7. Rename
|
|
225
|
+
## Деталь Д7. Rename → `agent-steward` 0.0.2
|
|
226
226
|
|
|
227
227
|
- П7.1 — rename-only релиз без фич.
|
|
228
228
|
- П7.2 — сменить `name` пакета, сохранить `plugin id` и пути состояния.
|
|
@@ -292,8 +292,8 @@
|
|
|
292
292
|
| П1.2.2 | В матрице GUI и RPC помечены «**нет**» для V1 (subpath `/gui` и `/rpc` в V1-пакете отсутствуют), TUI — «**обе линии**»: V2 регистрирует панель через `setup(ctx)`, V1 — через отдельный `src/tui-v1.tsx` (З3.4). Под таблицей добавлен явный абзац «GUI и RPC — только V2»; пакет не обещает их в V1 и не подменяет TUI заглушкой. |
|
|
293
293
|
| П1.2.3 | README (en/ru/zh) обновлены: tagline и раздел Install больше не требуют «OpenCode v2», теперь «V1 ≥ 1.18.29 или V2» + ссылка на `docs/COMPATIBILITY.md` (GUI/RPC — только V2, TUI — обе линии). Переводы `docs/README.ru.md` и `docs/README.zh.md` поправлены в том же коммите. |
|
|
294
294
|
| П1.3.1 | `plugin id` остаётся `opencode-windows-scheduler` (`src/index.ts`, `Plugin.define({ id })`). Зафиксировано в разделе «Инварианты состояния»; `test-docs` сверяет значение в коде и документе. |
|
|
295
|
-
| П1.3.2 | Пути состояния сведены в таблицу: Windows `%APPDATA%\opencode\
|
|
296
|
-
| П1.3.3 | Префикс задач не меняется: Windows default — `\OpenCode\windows-scheduler\`, профиль — `\OpenCode\windows-scheduler-<profile>\` (`windows.ts`); crontab-блок — `opencode-scheduler:<folder>` (legacy без суффикса читается); launchd label — `com.opencode.scheduler.<name>`. В таблице инвариантов указано, что rename
|
|
295
|
+
| П1.3.2 | Пути состояния сведены в таблицу: Windows `%APPDATA%\opencode\agent-steward`, macOS/Linux `$XDG_CONFIG_HOME/opencode/agent-steward` или `~/.config/opencode/agent-steward`; профили — `<base>/profiles/<name>`; SQLite — `<PLUGIN_DIR>/scheduler.db` (`OPENCODE_SCHEDULER_DB` только для тестов); логи/обёртки/locks/prompts/env и `secrets.json`/`secrets.key` — под `<PLUGIN_DIR>`. `test-docs` сверяет `profiles.ts`, `db/index.ts`, `types.ts`. |
|
|
296
|
+
| П1.3.3 | Префикс задач не меняется: Windows default — `\OpenCode\windows-scheduler\`, профиль — `\OpenCode\windows-scheduler-<profile>\` (`windows.ts`); crontab-блок — `opencode-scheduler:<folder>` (legacy без суффикса читается); launchd label — `com.opencode.scheduler.<name>`. В таблице инвариантов указано, что rename (Д7) меняет только npm-имя. Итог: `test-docs` 50 → 60/60. |
|
|
297
297
|
|
|
298
298
|
### Д2. Извлечение общего ядра — ✅ 17.11.2026 (П2.1.3, П2.2.3, П2.4.2 закрыты в З3.1)
|
|
299
299
|
|