ultimate-pi 0.18.1 → 0.19.0

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 (284) hide show
  1. package/.agents/skills/harness-debate-plan/SKILL.md +1 -1
  2. package/.agents/skills/harness-decisions/SKILL.md +1 -2
  3. package/.agents/skills/harness-governor/SKILL.md +6 -5
  4. package/.pi/PACKAGING.md +4 -4
  5. package/.pi/SYSTEM.md +54 -120
  6. package/.pi/agents/harness/incident-recorder.md +0 -1
  7. package/.pi/agents/harness/planning/decompose.md +0 -2
  8. package/.pi/agents/harness/planning/execution-plan-author.md +0 -2
  9. package/.pi/agents/harness/planning/hypothesis-validator.md +0 -2
  10. package/.pi/agents/harness/planning/hypothesis.md +0 -2
  11. package/.pi/agents/harness/planning/implementation-researcher.md +0 -2
  12. package/.pi/agents/harness/planning/plan-adversary.md +0 -2
  13. package/.pi/agents/harness/planning/plan-evaluator.md +1 -3
  14. package/.pi/agents/harness/planning/planning-context.md +0 -2
  15. package/.pi/agents/harness/planning/review-integrator.md +0 -2
  16. package/.pi/agents/harness/planning/sprint-contract-auditor.md +0 -2
  17. package/.pi/agents/harness/planning/stack-researcher.md +0 -2
  18. package/.pi/agents/harness/reviewing/adversary.md +0 -2
  19. package/.pi/agents/harness/reviewing/evaluator.md +0 -2
  20. package/.pi/agents/harness/reviewing/tie-breaker.md +0 -2
  21. package/.pi/agents/harness/running/executor.md +0 -2
  22. package/.pi/agents/harness/sentrux-bootstrap.md +0 -1
  23. package/.pi/agents/harness/sentrux-steward.md +0 -2
  24. package/.pi/agents/harness/trace-librarian.md +0 -1
  25. package/.pi/extensions/00-posthog-network-bootstrap.ts +1 -1
  26. package/.pi/extensions/agt-kill-switch.ts +57 -0
  27. package/.pi/extensions/agt-prompt-guard.ts +32 -0
  28. package/.pi/extensions/custom-footer.ts +46 -145
  29. package/.pi/extensions/custom-header.ts +1 -1
  30. package/.pi/extensions/custom-system-prompt.ts +1 -1
  31. package/.pi/extensions/debate-orchestrator.ts +6 -6
  32. package/.pi/extensions/harness-ask-user.ts +7 -7
  33. package/.pi/extensions/harness-debate-tools.ts +26 -42
  34. package/.pi/extensions/harness-lens.ts +94 -0
  35. package/.pi/extensions/harness-plan-approval.ts +11 -11
  36. package/.pi/extensions/harness-run-context.ts +1070 -876
  37. package/.pi/extensions/harness-subagent-governance.ts +8 -0
  38. package/.pi/extensions/harness-subagent-submit.ts +34 -163
  39. package/.pi/extensions/harness-subagents.ts +3 -3
  40. package/.pi/extensions/harness-telemetry.ts +2 -2
  41. package/.pi/extensions/harness-web-tools.ts +2 -2
  42. package/.pi/extensions/policy-gate.ts +25 -5
  43. package/.pi/extensions/sentrux-rules-sync.ts +1 -1
  44. package/.pi/extensions/subagent-governance.ts +92 -0
  45. package/.pi/extensions/trace-recorder.ts +1 -1
  46. package/.pi/extensions/{ultimate-pi-vcc.ts → vcc-compaction.ts} +1 -1
  47. package/.pi/harness/README.md +6 -2
  48. package/.pi/harness/agents.manifest.json +22 -25
  49. package/.pi/harness/agents.policy.yaml +275 -0
  50. package/.pi/harness/docs/adrs/0030-inhouse-vcc-compaction.md +1 -1
  51. package/.pi/harness/docs/adrs/0035-plan-phase-review-gate.md +1 -1
  52. package/.pi/harness/docs/adrs/0045-harness-lens-minimal-contract.md +49 -0
  53. package/.pi/harness/docs/adrs/0046-agt-policy-engine.md +51 -0
  54. package/.pi/harness/docs/adrs/0047-agt-layered-security.md +39 -0
  55. package/.pi/harness/docs/adrs/0048-tool-call-hook-order.md +25 -0
  56. package/.pi/harness/docs/adrs/0049-agents-policy-manifest.md +36 -0
  57. package/.pi/harness/docs/adrs/README.md +5 -0
  58. package/.pi/harness/evolution/README.md +1 -2
  59. package/.pi/harness/examples/agents.policy.project.yaml +19 -0
  60. package/.pi/harness/examples/policies/custom-deny-bash.yaml +9 -0
  61. package/.pi/harness/policies/bash-denylists.yaml +5 -0
  62. package/.pi/harness/policies/defaults.yaml +51 -0
  63. package/.pi/harness/policies/orchestrator.yaml +18 -0
  64. package/.pi/harness/policies/phases.yaml +10 -0
  65. package/.pi/harness/policies/roles.yaml +5 -0
  66. package/.pi/harness/policies/web-guard.yaml +5 -0
  67. package/.pi/harness/policies/workflow-sequences.yaml +9 -0
  68. package/.pi/harness/sentrux/architecture.manifest.json +26 -4
  69. package/.pi/harness/specs/observation.schema.json +2 -1
  70. package/.pi/lib/agents-policy.d.mts +70 -0
  71. package/.pi/lib/agents-policy.mjs +325 -0
  72. package/.pi/lib/agents-policy.ts +19 -0
  73. package/.pi/lib/agt/audit-run-sink.ts +52 -0
  74. package/.pi/lib/agt/build-evaluation-context.ts +285 -0
  75. package/.pi/lib/agt/config.ts +28 -0
  76. package/.pi/lib/agt/delegation.ts +69 -0
  77. package/.pi/lib/agt/evaluate-policy.ts +56 -0
  78. package/.pi/lib/agt/identity-registry.ts +41 -0
  79. package/.pi/lib/agt/index.ts +55 -0
  80. package/.pi/lib/agt/kill-switch-state.ts +11 -0
  81. package/.pi/lib/agt/legacy-evaluate.ts +101 -0
  82. package/.pi/lib/agt/policy-engine.ts +154 -0
  83. package/.pi/lib/agt/rings.ts +21 -0
  84. package/.pi/lib/agt/sre-hooks.ts +45 -0
  85. package/.pi/lib/agt/trust-run-store.ts +26 -0
  86. package/.pi/lib/agt/workflow-history.ts +29 -0
  87. package/.pi/lib/agt-governance-active.ts +14 -0
  88. package/.pi/lib/agt-tool-guard.ts +78 -0
  89. package/.pi/lib/ask-user/dialog.ts +314 -0
  90. package/.pi/{extensions/lib → lib}/debate-bus-core.ts +10 -10
  91. package/.pi/{extensions/lib → lib}/debate-bus-state.ts +1 -1
  92. package/.pi/{extensions/lib → lib}/extension-load-guard.ts +13 -2
  93. package/.pi/lib/harness-agt-tool-guard.ts +5 -0
  94. package/.pi/{extensions/lib → lib}/harness-artifact-gate.ts +1 -1
  95. package/.pi/lib/harness-debate-core-deps.ts +14 -0
  96. package/.pi/lib/harness-debate-workflow-deps.ts +43 -0
  97. package/.pi/lib/harness-lens/.gitattributes +1 -0
  98. package/.pi/lib/harness-lens/clients/edit-autopatch.ts +88 -0
  99. package/.pi/lib/harness-lens/clients/file-kinds.ts +380 -0
  100. package/.pi/lib/harness-lens/clients/file-time.ts +215 -0
  101. package/.pi/lib/harness-lens/clients/file-utils.ts +484 -0
  102. package/.pi/lib/harness-lens/clients/format-service.ts +276 -0
  103. package/.pi/lib/harness-lens/clients/formatters.ts +1000 -0
  104. package/.pi/lib/harness-lens/clients/git-guard.ts +31 -0
  105. package/.pi/lib/harness-lens/clients/indent-retarget.ts +90 -0
  106. package/.pi/lib/harness-lens/clients/installer/index.ts +2368 -0
  107. package/.pi/lib/harness-lens/clients/latency-logger.ts +80 -0
  108. package/.pi/lib/harness-lens/clients/lens-config.ts +43 -0
  109. package/.pi/lib/harness-lens/clients/lens-events.ts +164 -0
  110. package/.pi/lib/harness-lens/clients/lsp/aggregation.ts +91 -0
  111. package/.pi/lib/harness-lens/clients/lsp/client.ts +1466 -0
  112. package/.pi/lib/harness-lens/clients/lsp/config.ts +216 -0
  113. package/.pi/lib/harness-lens/clients/lsp/edits.ts +297 -0
  114. package/.pi/lib/harness-lens/clients/lsp/index.ts +1355 -0
  115. package/.pi/lib/harness-lens/clients/lsp/interactive-install.ts +424 -0
  116. package/.pi/lib/harness-lens/clients/lsp/language.ts +223 -0
  117. package/.pi/lib/harness-lens/clients/lsp/launch.ts +939 -0
  118. package/.pi/lib/harness-lens/clients/lsp/lsp-index.ts +11 -0
  119. package/.pi/lib/harness-lens/clients/lsp/path-utils.ts +12 -0
  120. package/.pi/lib/harness-lens/clients/lsp/server-strategies.ts +81 -0
  121. package/.pi/lib/harness-lens/clients/lsp/server.ts +1971 -0
  122. package/.pi/lib/harness-lens/clients/path-utils.ts +182 -0
  123. package/.pi/lib/harness-lens/clients/pipeline.ts +360 -0
  124. package/.pi/lib/harness-lens/clients/project-profile.ts +117 -0
  125. package/.pi/lib/harness-lens/clients/runtime-agent-end.ts +112 -0
  126. package/.pi/lib/harness-lens/clients/runtime-config.ts +33 -0
  127. package/.pi/lib/harness-lens/clients/runtime-coordinator.ts +186 -0
  128. package/.pi/lib/harness-lens/clients/runtime-tool-result.ts +171 -0
  129. package/.pi/lib/harness-lens/clients/safe-spawn.ts +339 -0
  130. package/.pi/lib/harness-lens/clients/secrets-scanner.ts +214 -0
  131. package/.pi/lib/harness-lens/clients/tool-policy.ts +2072 -0
  132. package/.pi/lib/harness-lens/clients/types.ts +59 -0
  133. package/.pi/lib/harness-lens/clients/widget-state.ts +283 -0
  134. package/.pi/lib/harness-lens/index.ts +532 -0
  135. package/.pi/lib/harness-lens/tools/lsp-diagnostics.ts +706 -0
  136. package/.pi/lib/harness-lens/tools/lsp-navigation.ts +1246 -0
  137. package/.pi/{extensions/lib → lib}/harness-posthog.ts +3 -0
  138. package/.pi/lib/harness-run-context-responses.ts +9 -0
  139. package/.pi/lib/harness-run-context.ts +0 -2
  140. package/.pi/{extensions/lib/spawn-policy.ts → lib/harness-spawn-policy.ts} +1 -0
  141. package/.pi/{extensions/lib → lib}/harness-spawn-topology.ts +1 -1
  142. package/.pi/lib/harness-subagent-auth.ts +51 -0
  143. package/.pi/{extensions/lib → lib}/harness-subagent-precheck.ts +10 -7
  144. package/.pi/{extensions/lib → lib}/harness-subagent-submit-pipeline.ts +3 -3
  145. package/.pi/lib/harness-subagent-submit-register.ts +163 -0
  146. package/.pi/{extensions/lib → lib}/harness-subagent-submit-registry.ts +1 -37
  147. package/.pi/{extensions/lib → lib}/harness-subagents-bridge.ts +53 -14
  148. package/.pi/{extensions/lib → lib}/harness-subprocess-bootstrap.ts +1 -1
  149. package/.pi/{extensions/lib → lib}/plan-approval/create-plan.ts +2 -2
  150. package/.pi/{extensions/lib → lib}/plan-approval/format-plan.ts +2 -2
  151. package/.pi/{extensions/lib → lib}/plan-approval/plan-review.ts +162 -201
  152. package/.pi/{extensions/lib → lib}/plan-approval/render.ts +1 -1
  153. package/.pi/{extensions/lib → lib}/plan-approval/resolve-disk.ts +2 -2
  154. package/.pi/{extensions/lib → lib}/plan-approval/types.ts +1 -1
  155. package/.pi/{extensions/lib → lib}/plan-approval/validate.ts +3 -3
  156. package/.pi/{extensions/lib → lib}/plan-debate-envelope.ts +1 -1
  157. package/.pi/{extensions/lib → lib}/plan-debate-gate.ts +1 -1
  158. package/.pi/{extensions/lib → lib}/plan-debate-lane.ts +1 -4
  159. package/.pi/{extensions/lib → lib}/plan-messenger.ts +1 -1
  160. package/.pi/prompts/harness-plan.md +1 -1
  161. package/.pi/prompts/harness-setup.md +37 -64
  162. package/.pi/scripts/README.md +2 -5
  163. package/.pi/scripts/generate-agents-policy-yaml.mjs +148 -0
  164. package/.pi/scripts/harness-agents-manifest.mjs +60 -3
  165. package/.pi/scripts/harness-agt-doctor.ts +36 -0
  166. package/.pi/scripts/harness-cli-verify.sh +9 -2
  167. package/.pi/scripts/harness-verify.mjs +113 -39
  168. package/.pi/scripts/harness-web-policy-guard.mjs +2 -2
  169. package/.pi/scripts/validate-plan-dag.mjs +65 -74
  170. package/.pi/scripts/vendor-pi-vcc-settings.stub.ts +2 -2
  171. package/.pi/scripts/vendor-sync-pi-vcc.sh +1 -1
  172. package/.pi/skills/architecture/broker-domain/SKILL.md +65 -0
  173. package/.pi/skills/architecture/cqrs/SKILL.md +63 -0
  174. package/.pi/skills/architecture/event-driven/SKILL.md +60 -0
  175. package/.pi/skills/architecture/hexagonal-ports-adapters/SKILL.md +66 -0
  176. package/.pi/skills/architecture/layered/SKILL.md +68 -0
  177. package/.pi/skills/architecture/microkernel/SKILL.md +62 -0
  178. package/.pi/skills/architecture/microservices/SKILL.md +64 -0
  179. package/.pi/skills/architecture/modular-monolith/SKILL.md +65 -0
  180. package/.pi/skills/architecture/orchestration-driven-soa/SKILL.md +61 -0
  181. package/.pi/skills/architecture/pipeline/SKILL.md +63 -0
  182. package/.pi/skills/architecture/service-based/SKILL.md +64 -0
  183. package/.pi/skills/architecture/service-mesh/SKILL.md +60 -0
  184. package/.pi/skills/architecture/space-based/SKILL.md +60 -0
  185. package/.pi/skills/ast-grep/SKILL.md +40 -321
  186. package/.pi/skills/delivery/debugging-discipline/SKILL.md +36 -0
  187. package/.pi/skills/delivery/documentation-update/SKILL.md +33 -0
  188. package/.pi/skills/delivery/requirements-to-implementation/SKILL.md +34 -0
  189. package/.pi/skills/delivery/risk-based-verification/SKILL.md +43 -0
  190. package/.pi/skills/delivery/tradeoff-analysis/SKILL.md +34 -0
  191. package/.pi/skills/engineering/api-contract-design/SKILL.md +38 -0
  192. package/.pi/skills/engineering/cohesion-coupling/SKILL.md +43 -0
  193. package/.pi/skills/engineering/complexity-control/SKILL.md +31 -0
  194. package/.pi/skills/engineering/defensive-programming/SKILL.md +38 -0
  195. package/.pi/skills/engineering/dependency-management/SKILL.md +29 -0
  196. package/.pi/skills/engineering/domain-modeling/SKILL.md +32 -0
  197. package/.pi/skills/engineering/error-handling/SKILL.md +37 -0
  198. package/.pi/skills/engineering/legacy-code-seams/SKILL.md +35 -0
  199. package/.pi/skills/engineering/naming-and-intent/SKILL.md +29 -0
  200. package/.pi/skills/engineering/refactoring-safe-evolution/SKILL.md +35 -0
  201. package/.pi/skills/engineering/routine-function-design/SKILL.md +34 -0
  202. package/.pi/skills/engineering/small-change-discipline/SKILL.md +35 -0
  203. package/.pi/skills/lsp-navigation/SKILL.md +89 -0
  204. package/.pi/skills/quality/code-review-self-check/SKILL.md +35 -0
  205. package/.pi/skills/quality/privacy-data-handling/SKILL.md +26 -0
  206. package/.pi/skills/quality/security-review/SKILL.md +34 -0
  207. package/.pi/skills/quality/test-strategy/SKILL.md +33 -0
  208. package/.pi/skills/quality/testability-design/SKILL.md +33 -0
  209. package/.pi/skills/systems/concurrency-safety/SKILL.md +32 -0
  210. package/.pi/skills/systems/data-modeling-migrations/SKILL.md +31 -0
  211. package/.pi/skills/systems/observability-instrumentation/SKILL.md +32 -0
  212. package/.pi/skills/systems/performance-measurement/SKILL.md +35 -0
  213. package/.pi/skills/systems/reliability-design/SKILL.md +32 -0
  214. package/.sentrux/rules.toml +20 -4
  215. package/AGENTS.md +5 -0
  216. package/CHANGELOG.md +14 -0
  217. package/README.md +3 -12
  218. package/THIRD_PARTY_NOTICES.md +12 -21
  219. package/package.json +15 -7
  220. package/vendor/pi-subagents/src/agents.ts +45 -1
  221. package/vendor/pi-subagents/src/subagents.ts +866 -811
  222. package/vendor/pi-vcc/src/core/brief.ts +68 -99
  223. package/vendor/pi-vcc/src/core/settings.ts +2 -2
  224. package/.agents/skills/caveman/SKILL.md +0 -67
  225. package/.pi/agents/harness/meta-optimizer.md +0 -36
  226. package/.pi/extensions/lib/ask-user/dialog.ts +0 -260
  227. package/.pi/extensions/lib/harness-subagent-auth.ts +0 -207
  228. package/.pi/extensions/lib/harness-subagent-policy.ts +0 -236
  229. package/.pi/extensions/pi-model-router-harness.ts +0 -42
  230. package/.pi/harness/evolution/meta-optimizer.mjs +0 -99
  231. package/.pi/harness/specs/router-tuning-proposal.schema.json +0 -114
  232. package/.pi/model-router.example.json +0 -36
  233. package/.pi/prompts/harness-critic.md +0 -10
  234. package/.pi/prompts/harness-eval.md +0 -10
  235. package/.pi/prompts/harness-router-tune.md +0 -52
  236. package/.pi/scripts/harness-generate-model-router.mjs +0 -327
  237. package/.pi/scripts/harness-model-router-routing.test.mjs +0 -97
  238. package/.pi/scripts/harness-sync-model-router.mjs +0 -97
  239. package/.pi/scripts/vendor-sync-pi-model-router.sh +0 -47
  240. package/vendor/pi-model-router/.prettierignore +0 -4
  241. package/vendor/pi-model-router/.prettierrc +0 -5
  242. package/vendor/pi-model-router/AGENTS.md +0 -39
  243. package/vendor/pi-model-router/LICENSE +0 -21
  244. package/vendor/pi-model-router/README.md +0 -99
  245. package/vendor/pi-model-router/UPSTREAM_PIN.md +0 -10
  246. package/vendor/pi-model-router/docs/ARCHITECTURE.md +0 -54
  247. package/vendor/pi-model-router/extensions/commands.ts +0 -720
  248. package/vendor/pi-model-router/extensions/config.ts +0 -348
  249. package/vendor/pi-model-router/extensions/constants.ts +0 -1
  250. package/vendor/pi-model-router/extensions/index.ts +0 -478
  251. package/vendor/pi-model-router/extensions/provider.ts +0 -580
  252. package/vendor/pi-model-router/extensions/routing.ts +0 -564
  253. package/vendor/pi-model-router/extensions/state.ts +0 -52
  254. package/vendor/pi-model-router/extensions/types.ts +0 -95
  255. package/vendor/pi-model-router/extensions/ui.ts +0 -144
  256. package/vendor/pi-model-router/model-router.example.json +0 -48
  257. package/vendor/pi-model-router/package.json +0 -48
  258. package/vendor/pi-model-router/tsconfig.json +0 -16
  259. /package/.pi/{prompts → harness/docs}/planning-rubrics.md +0 -0
  260. /package/.pi/{extensions/lib → lib}/ask-user/fallback.ts +0 -0
  261. /package/.pi/{extensions/lib → lib}/ask-user/render.ts +0 -0
  262. /package/.pi/{extensions/lib → lib}/ask-user/schema.ts +0 -0
  263. /package/.pi/{extensions/lib → lib}/ask-user/types.ts +0 -0
  264. /package/.pi/{extensions/lib → lib}/ask-user/validate-core.mjs +0 -0
  265. /package/.pi/{extensions/lib → lib}/ask-user/validate.ts +0 -0
  266. /package/.pi/{extensions/lib → lib}/harness-cocoindex-refresh.ts +0 -0
  267. /package/.pi/{extensions/lib → lib}/harness-paths.ts +0 -0
  268. /package/.pi/{extensions/lib → lib}/harness-spawn-budget.ts +0 -0
  269. /package/.pi/{extensions/lib → lib}/harness-vcc-settings.ts +0 -0
  270. /package/.pi/{extensions/lib → lib}/harness-web/run-cli.ts +0 -0
  271. /package/.pi/{extensions/lib → lib}/plan-approval/dialog.ts +0 -0
  272. /package/.pi/{extensions/lib → lib}/plan-approval/schema.ts +0 -0
  273. /package/.pi/{extensions/lib → lib}/plan-approval-readiness.ts +0 -0
  274. /package/.pi/{extensions/lib → lib}/plan-debate-eligibility.ts +0 -0
  275. /package/.pi/{extensions/lib → lib}/plan-debate-focus.ts +0 -0
  276. /package/.pi/{extensions/lib → lib}/plan-debate-id.ts +0 -0
  277. /package/.pi/{extensions/lib → lib}/plan-debate-lanes.ts +0 -0
  278. /package/.pi/{extensions/lib → lib}/plan-debate-round-status.ts +0 -0
  279. /package/.pi/{extensions/lib → lib}/plan-debate-write-guard.ts +0 -0
  280. /package/.pi/{extensions/lib → lib}/plan-review-gate.ts +0 -0
  281. /package/.pi/{extensions/lib → lib}/plan-review-integrator-rules.ts +0 -0
  282. /package/.pi/{extensions/lib → lib}/plan-scope-guard.ts +0 -0
  283. /package/.pi/{extensions/lib → lib}/posthog-client.ts +0 -0
  284. /package/.pi/{extensions/lib → lib}/posthog-node.d.ts +0 -0
@@ -1,348 +0,0 @@
1
- import { existsSync, readFileSync } from 'node:fs';
2
- import { join } from 'node:path';
3
- import { getAgentDir } from '@earendil-works/pi-coding-agent';
4
- import type { ThinkingLevel } from '@earendil-works/pi-agent-core';
5
- import type {
6
- RouterConfig,
7
- RouterProfile,
8
- RoutedTierConfig,
9
- ConfigLoadResult,
10
- ParsedConfigFile,
11
- RouterTier,
12
- RoutingRule,
13
- } from './types.js';
14
-
15
- export const ROUTER_TIERS = ['high', 'medium', 'low'] as const;
16
-
17
- export const FALLBACK_CONFIG: RouterConfig = {
18
- defaultProfile: 'auto',
19
- debug: false,
20
- profiles: {
21
- auto: {
22
- high: { model: 'openai/gpt-5.4-pro', thinking: 'off' },
23
- medium: { model: 'google/gemini-flash-latest', thinking: 'off' },
24
- low: { model: 'openai/gpt-5.4-nano', thinking: 'off' },
25
- },
26
- },
27
- };
28
-
29
- export const THINKING_LEVELS: readonly ThinkingLevel[] = [
30
- 'off',
31
- 'minimal',
32
- 'low',
33
- 'medium',
34
- 'high',
35
- 'xhigh',
36
- ];
37
- export const ROUTER_PIN_VALUES = ['auto', 'high', 'medium', 'low'] as const;
38
-
39
- export const isObjectRecord = (
40
- value: unknown,
41
- ): value is Record<string, unknown> =>
42
- typeof value === 'object' && value !== null;
43
-
44
- export const isThinkingLevel = (value: unknown): value is ThinkingLevel =>
45
- typeof value === 'string' && THINKING_LEVELS.includes(value as ThinkingLevel);
46
-
47
- export const isRouterTier = (value: unknown): value is RouterTier =>
48
- value === 'high' || value === 'medium' || value === 'low';
49
-
50
- export const parseConfigFile = (path: string): ParsedConfigFile => {
51
- if (!existsSync(path)) {
52
- return { config: {}, warnings: [] };
53
- }
54
-
55
- try {
56
- const parsed = JSON.parse(readFileSync(path, 'utf-8')) as unknown;
57
- if (!isObjectRecord(parsed)) {
58
- return {
59
- config: {},
60
- warnings: [`Ignored router config at ${path}: expected a JSON object.`],
61
- };
62
- }
63
- return { config: parsed as Partial<RouterConfig>, warnings: [] };
64
- } catch (error) {
65
- return {
66
- config: {},
67
- warnings: [
68
- `Failed to parse router config at ${path}: ${error instanceof Error ? error.message : String(error)}`,
69
- ],
70
- };
71
- }
72
- };
73
-
74
- export const mergeConfig = (
75
- base: RouterConfig,
76
- override: Partial<RouterConfig>,
77
- ): RouterConfig => {
78
- const mergedProfiles: Record<string, RouterProfile> = { ...base.profiles };
79
- for (const [name, profile] of Object.entries(override.profiles ?? {})) {
80
- const existing = mergedProfiles[name];
81
- const nextProfile = profile as Partial<RouterProfile>;
82
- mergedProfiles[name] = {
83
- high: {
84
- ...(existing?.high ?? FALLBACK_CONFIG.profiles.auto.high),
85
- ...(nextProfile.high ?? {}),
86
- },
87
- medium: {
88
- ...(existing?.medium ?? FALLBACK_CONFIG.profiles.auto.medium),
89
- ...(nextProfile.medium ?? {}),
90
- },
91
- low: {
92
- ...(existing?.low ?? FALLBACK_CONFIG.profiles.auto.low),
93
- ...(nextProfile.low ?? {}),
94
- },
95
- };
96
- }
97
- return {
98
- defaultProfile: override.defaultProfile ?? base.defaultProfile,
99
- debug: override.debug ?? base.debug,
100
- classifierModel: override.classifierModel ?? base.classifierModel,
101
- phaseBias: override.phaseBias ?? base.phaseBias,
102
- largeContextThreshold:
103
- override.largeContextThreshold ?? base.largeContextThreshold,
104
- maxSessionBudget: override.maxSessionBudget ?? base.maxSessionBudget,
105
- rules: override.rules ?? base.rules,
106
- profiles: mergedProfiles,
107
- };
108
- };
109
-
110
- export const parseCanonicalModelRef = (
111
- value: string,
112
- ): { provider: string; modelId: string } => {
113
- const slashIndex = value.indexOf('/');
114
- if (slashIndex === -1) {
115
- throw new Error(
116
- `Invalid model reference "${value}". Expected "provider/model".`,
117
- );
118
- }
119
- const provider = value.slice(0, slashIndex).trim();
120
- const modelId = value.slice(slashIndex + 1).trim();
121
- if (!provider || !modelId) {
122
- throw new Error(
123
- `Invalid model reference "${value}". Expected "provider/model".`,
124
- );
125
- }
126
- return { provider, modelId };
127
- };
128
-
129
- export const normalizeTierConfig = (
130
- value: unknown,
131
- fallback: RoutedTierConfig,
132
- profileName: string,
133
- tier: RouterTier,
134
- warnings: string[],
135
- ): RoutedTierConfig => {
136
- if (!isObjectRecord(value)) {
137
- warnings.push(
138
- `Profile "${profileName}" has invalid ${tier} tier config. Falling back to ${fallback.model}.`,
139
- );
140
- return { ...fallback };
141
- }
142
-
143
- const model = typeof value.model === 'string' ? value.model.trim() : '';
144
- let parsedModel = fallback.model;
145
- if (!model) {
146
- warnings.push(
147
- `Profile "${profileName}" ${tier} tier is missing a model. Falling back to ${fallback.model}.`,
148
- );
149
- } else {
150
- try {
151
- parseCanonicalModelRef(model);
152
- parsedModel = model;
153
- } catch (error) {
154
- warnings.push(error instanceof Error ? error.message : String(error));
155
- }
156
- }
157
-
158
- const thinking = isThinkingLevel(value.thinking)
159
- ? value.thinking
160
- : fallback.thinking;
161
- if (value.thinking !== undefined && !isThinkingLevel(value.thinking)) {
162
- warnings.push(
163
- `Profile "${profileName}" ${tier} tier has invalid thinking level. Falling back to ${fallback.thinking ?? 'medium'}.`,
164
- );
165
- }
166
-
167
- let fallbacks: string[] | undefined = undefined;
168
- if (Array.isArray(value.fallbacks)) {
169
- fallbacks = [];
170
- for (const f of value.fallbacks) {
171
- if (typeof f === 'string') {
172
- try {
173
- parseCanonicalModelRef(f);
174
- fallbacks.push(f);
175
- } catch (error) {
176
- warnings.push(
177
- `Invalid fallback model "${f}" in profile "${profileName}" ${tier} tier: ${error instanceof Error ? error.message : String(error)}`,
178
- );
179
- }
180
- }
181
- }
182
- }
183
-
184
- return { model: parsedModel, thinking, fallbacks };
185
- };
186
-
187
- export const normalizeConfig = (raw: RouterConfig): ConfigLoadResult => {
188
- const warnings: string[] = [];
189
- const normalizedProfiles: Record<string, RouterProfile> = {};
190
- const fallbackAuto = FALLBACK_CONFIG.profiles.auto;
191
-
192
- for (const [name, profile] of Object.entries(raw.profiles ?? {})) {
193
- normalizedProfiles[name] = {
194
- high: normalizeTierConfig(
195
- profile?.high,
196
- fallbackAuto.high,
197
- name,
198
- 'high',
199
- warnings,
200
- ),
201
- medium: normalizeTierConfig(
202
- profile?.medium,
203
- fallbackAuto.medium,
204
- name,
205
- 'medium',
206
- warnings,
207
- ),
208
- low: normalizeTierConfig(
209
- profile?.low,
210
- fallbackAuto.low,
211
- name,
212
- 'low',
213
- warnings,
214
- ),
215
- };
216
- }
217
-
218
- if (Object.keys(normalizedProfiles).length === 0) {
219
- normalizedProfiles.auto = fallbackAuto;
220
- warnings.push(
221
- 'No valid router profiles found. Falling back to the built-in auto profile.',
222
- );
223
- }
224
-
225
- let defaultProfile =
226
- typeof raw.defaultProfile === 'string' && raw.defaultProfile.trim()
227
- ? raw.defaultProfile.trim()
228
- : undefined;
229
- if (!defaultProfile || !normalizedProfiles[defaultProfile]) {
230
- const fallbackProfile = normalizedProfiles[
231
- FALLBACK_CONFIG.defaultProfile ?? 'auto'
232
- ]
233
- ? (FALLBACK_CONFIG.defaultProfile ?? 'auto')
234
- : Object.keys(normalizedProfiles).sort()[0];
235
- if (defaultProfile && !normalizedProfiles[defaultProfile]) {
236
- warnings.push(
237
- `Default router profile "${defaultProfile}" was not found. Falling back to "${fallbackProfile}".`,
238
- );
239
- }
240
- defaultProfile = fallbackProfile;
241
- }
242
-
243
- const phaseBias =
244
- typeof raw.phaseBias === 'number'
245
- ? Math.max(0, Math.min(1, raw.phaseBias))
246
- : 0.5;
247
-
248
- const largeContextThreshold =
249
- typeof raw.largeContextThreshold === 'number' &&
250
- raw.largeContextThreshold > 0
251
- ? raw.largeContextThreshold
252
- : undefined;
253
-
254
- const maxSessionBudget =
255
- typeof raw.maxSessionBudget === 'number' && raw.maxSessionBudget > 0
256
- ? raw.maxSessionBudget
257
- : undefined;
258
-
259
- const rules: RoutingRule[] = [];
260
- if (Array.isArray(raw.rules)) {
261
- for (const rule of raw.rules) {
262
- if (isObjectRecord(rule)) {
263
- const matches = rule.matches;
264
- const tier = rule.tier;
265
- if (
266
- (typeof matches === 'string' || Array.isArray(matches)) &&
267
- isRouterTier(tier)
268
- ) {
269
- rules.push({
270
- matches,
271
- tier,
272
- reason: typeof rule.reason === 'string' ? rule.reason : undefined,
273
- });
274
- } else {
275
- warnings.push(
276
- `Ignored invalid routing rule: ${JSON.stringify(rule)}`,
277
- );
278
- }
279
- }
280
- }
281
- }
282
-
283
- let classifierModel =
284
- typeof raw.classifierModel === 'string'
285
- ? raw.classifierModel.trim()
286
- : undefined;
287
- if (classifierModel) {
288
- try {
289
- parseCanonicalModelRef(classifierModel);
290
- } catch (error) {
291
- warnings.push(
292
- `Invalid classifierModel: ${error instanceof Error ? error.message : String(error)}`,
293
- );
294
- classifierModel = undefined;
295
- }
296
- }
297
-
298
- return {
299
- config: {
300
- defaultProfile,
301
- debug: typeof raw.debug === 'boolean' ? raw.debug : false,
302
- classifierModel,
303
- phaseBias,
304
- largeContextThreshold,
305
- maxSessionBudget,
306
- rules: rules.length > 0 ? rules : undefined,
307
- profiles: normalizedProfiles,
308
- },
309
- warnings,
310
- };
311
- };
312
-
313
- export const loadRouterConfig = (cwd: string): ConfigLoadResult => {
314
- const globalPath = join(getAgentDir(), 'model-router.json');
315
- const projectPath = join(cwd, '.pi', 'model-router.json');
316
- const globalResult = parseConfigFile(globalPath);
317
- const projectResult = parseConfigFile(projectPath);
318
- const merged = mergeConfig(
319
- mergeConfig(FALLBACK_CONFIG, globalResult.config),
320
- projectResult.config,
321
- );
322
- const normalized = normalizeConfig(merged);
323
- return {
324
- config: normalized.config,
325
- warnings: [
326
- ...globalResult.warnings,
327
- ...projectResult.warnings,
328
- ...normalized.warnings,
329
- ],
330
- };
331
- };
332
-
333
- export const profileNames = (config: RouterConfig): string[] => {
334
- return Object.keys(config.profiles).sort();
335
- };
336
-
337
- export const resolveProfileName = (
338
- config: RouterConfig,
339
- requested?: string,
340
- ): string => {
341
- if (requested && config.profiles[requested]) {
342
- return requested;
343
- }
344
- if (config.defaultProfile && config.profiles[config.defaultProfile]) {
345
- return config.defaultProfile;
346
- }
347
- return profileNames(config)[0] ?? 'auto';
348
- };
@@ -1 +0,0 @@
1
- export const MAX_DEBUG_HISTORY = 12;