pantheon-opencode 1.6.2-beta.1 → 1.6.2-beta.11

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 (145) hide show
  1. package/CHANGELOG.md +171 -0
  2. package/README.md +236 -60
  3. package/README.pt-BR.md +19 -1
  4. package/bin/pantheon-init.mjs +195 -13
  5. package/package.json +11 -3
  6. package/plugin.json +1 -1
  7. package/prompts/README.md +58 -0
  8. package/prompts/debug-issue.prompt.md +46 -0
  9. package/prompts/dynamic/agora-generated.txt +38 -0
  10. package/prompts/dynamic/orchestrate-generated.txt +51 -0
  11. package/prompts/focus.prompt.md +42 -0
  12. package/prompts/implement-feature.prompt.md +39 -0
  13. package/prompts/optimize-database.prompt.md +58 -0
  14. package/prompts/orchestrate-with-zeus.prompt.md +441 -0
  15. package/prompts/plan-architecture.prompt.md +59 -0
  16. package/prompts/quick-discovery-large-codebase.prompt.md +294 -0
  17. package/prompts/quick-plan-large-feature.prompt.md +197 -0
  18. package/prompts/semantic-summarize.md +50 -0
  19. package/prompts/sketch.prompt.md +91 -0
  20. package/prompts/subtask.prompt.md +131 -0
  21. package/pyproject.toml +1 -1
  22. package/scripts/decision-router-budget.mjs +780 -0
  23. package/scripts/decision-router-v2-budget.mjs +218 -0
  24. package/scripts/decision-router-v2-egress.mjs +272 -0
  25. package/scripts/decision-router.mjs +758 -0
  26. package/scripts/docs-check-changelog.mjs +5 -3
  27. package/scripts/install/component-selection.mjs +9 -4
  28. package/scripts/install/decision-layer-preview.mjs +376 -0
  29. package/scripts/install/decision-router-config.mjs +560 -0
  30. package/scripts/install/health-check.mjs +20 -11
  31. package/scripts/install/interactive.mjs +103 -14
  32. package/scripts/install/interrupt.mjs +4 -3
  33. package/scripts/install/migrate.mjs +123 -72
  34. package/scripts/install/opencode.mjs +178 -122
  35. package/scripts/install/plan.mjs +8 -1
  36. package/scripts/install/plugin.mjs +4 -3
  37. package/scripts/install/state.mjs +12 -0
  38. package/scripts/install/strings.mjs +22 -0
  39. package/scripts/install/venv.mjs +34 -17
  40. package/scripts/mcp_resources.py +11 -9
  41. package/scripts/release-gates.mjs +6 -82
  42. package/scripts/release-notes.mjs +30 -7
  43. package/scripts/restore.mjs +22 -10
  44. package/scripts/sync-tui.mjs +3 -3
  45. package/scripts/test-opencode-v2-sandbox.sh +10 -6
  46. package/scripts/versioning.mjs +41 -5
  47. package/src/agents/aphrodite.md +6 -1
  48. package/src/agents/apollo.md +1 -0
  49. package/src/agents/athena.md +1 -0
  50. package/src/agents/demeter.md +1 -1
  51. package/src/agents/gaia.md +1 -0
  52. package/src/agents/hephaestus.md +1 -1
  53. package/src/agents/hermes.md +8 -10
  54. package/src/agents/iris.md +1 -1
  55. package/src/agents/mnemosyne.md +1 -0
  56. package/src/agents/nyx.md +1 -1
  57. package/src/agents/prometheus.md +1 -1
  58. package/src/agents/talos.md +6 -1
  59. package/src/agents/themis.md +1 -1
  60. package/src/agents/zeus.md +52 -62
  61. package/src/mcp/eval_store.py +11 -4
  62. package/src/mcp/mcp_resources.py +11 -9
  63. package/src/mcp/memory_mcp.py +293 -150
  64. package/src/pantheon/cost-command.ts +30 -133
  65. package/src/pantheon/jev-decision-tool.ts +359 -0
  66. package/src/pantheon/jev-decisions.ts +625 -0
  67. package/src/pantheon/local-decision-agents.ts +170 -0
  68. package/src/pantheon/local-decision-budget.ts +1046 -0
  69. package/src/pantheon/local-decision-egress-gate.ts +144 -0
  70. package/src/pantheon/local-decision-prompt.ts +256 -0
  71. package/src/pantheon/local-decision-provider-matrix.ts +44 -0
  72. package/src/pantheon/local-decision-router.ts +225 -0
  73. package/src/pantheon/local-decision-skills.ts +281 -0
  74. package/src/pantheon/local-decision-tool.ts +160 -0
  75. package/src/pantheon/local-decision-turn.ts +101 -0
  76. package/src/pantheon/local-decision-usage-evidence.internal.ts +168 -0
  77. package/src/pantheon/local-orchestration.ts +322 -0
  78. package/src/pantheon/model-pricing.ts +1 -536
  79. package/src/pantheon/pantheon-decision-catalog.ts +101 -0
  80. package/src/pantheon/v2-decision-budget.ts +456 -0
  81. package/src/pantheon/v2-decision-contracts.ts +300 -0
  82. package/src/pantheon/v2-decision-egress.ts +203 -0
  83. package/src/pantheon/v2-decision-events.ts +180 -0
  84. package/src/pantheon/v2-decision-heuristic.ts +121 -0
  85. package/src/pantheon/v2-decision-points/p1-agent.ts +91 -0
  86. package/src/pantheon/v2-decision-points/p10-claims.ts +243 -0
  87. package/src/pantheon/v2-decision-points/p11-catalog.ts +220 -0
  88. package/src/pantheon/v2-decision-points/p2-skill.ts +83 -0
  89. package/src/pantheon/v2-decision-points/p3-complexity.ts +108 -0
  90. package/src/pantheon/v2-decision-points/p4-memory.ts +137 -0
  91. package/src/pantheon/v2-decision-points/p5-themis-verify.ts +190 -0
  92. package/src/pantheon/v2-decision-points/p6-council.ts +161 -0
  93. package/src/pantheon/v2-decision-points/p7-loop.ts +263 -0
  94. package/src/pantheon/v2-decision-points/p8-guardrail.ts +367 -0
  95. package/src/pantheon/v2-decision-points/p9-memory-compaction.ts +304 -0
  96. package/src/pantheon/v2-decision-points.ts +242 -0
  97. package/src/pantheon/v2-decision-policy.ts +166 -0
  98. package/src/pantheon/v2-decision-premises.ts +146 -0
  99. package/src/pantheon/v2-decision-prompt-surface.ts +115 -0
  100. package/src/pantheon/v2-decision-rank.ts +91 -0
  101. package/src/pantheon/v2-decision-registry.ts +391 -0
  102. package/src/pantheon/v2-decision-resource-ids.ts +127 -0
  103. package/src/pantheon/v2-decision-shadow.ts +123 -0
  104. package/src/pantheon/v2-decision-telemetry.ts +214 -0
  105. package/src/pantheon/v2-decision-verify.ts +51 -0
  106. package/src/pantheon/v2-hook-engine.ts +307 -0
  107. package/src/pantheon/v2-native-decisions.ts +365 -0
  108. package/src/pantheon/v2-shell-hooks.ts +66 -2
  109. package/src/pantheon/v2-tools.ts +38 -15
  110. package/src/plugin-v2.ts +419 -26
  111. package/src/plugin.ts +4 -0
  112. package/src/plugins/tui/THIRD_PARTY_NOTICES.md +24 -0
  113. package/src/plugins/tui/dist/server-v2.d.ts +19 -11
  114. package/src/plugins/tui/dist/server-v2.d.ts.map +1 -1
  115. package/src/plugins/tui/dist/server-v2.js +19 -666
  116. package/src/plugins/tui/dist/server-v2.js.map +1 -1
  117. package/src/plugins/tui/dist/tui-v2.d.ts +11 -203
  118. package/src/plugins/tui/dist/tui-v2.d.ts.map +1 -1
  119. package/src/plugins/tui/dist/tui-v2.js +187 -1917
  120. package/src/plugins/tui/dist/tui-v2.js.map +1 -1
  121. package/src/plugins/tui/dist/tui.js +1 -1
  122. package/src/plugins/tui/package-lock.json +17 -2
  123. package/src/plugins/tui/package.json +4 -2
  124. package/src/plugins/tui/src/cost-data.ts +607 -0
  125. package/src/plugins/tui/src/index-v2.tsx +213 -54
  126. package/src/plugins/tui/src/model-pricing.ts +536 -0
  127. package/src/plugins/tui/src/server-v2.ts +18 -838
  128. package/src/plugins/tui/tsdown.config.ts +28 -6
  129. package/src/plugins/tui/dist/quota-adapters.d.ts +0 -89
  130. package/src/plugins/tui/dist/quota-adapters.d.ts.map +0 -1
  131. package/src/plugins/tui/dist/quota-adapters.js +0 -1142
  132. package/src/plugins/tui/dist/quota-adapters.js.map +0 -1
  133. package/src/plugins/tui/dist/quota-cli.d.ts +0 -17
  134. package/src/plugins/tui/dist/quota-cli.d.ts.map +0 -1
  135. package/src/plugins/tui/dist/quota-cli.js +0 -184
  136. package/src/plugins/tui/dist/quota-cli.js.map +0 -1
  137. package/src/plugins/tui/dist/quota-rpc-UL2HuFRJ.js +0 -390
  138. package/src/plugins/tui/dist/quota-rpc-UL2HuFRJ.js.map +0 -1
  139. package/src/plugins/tui/src/go-key-diagnostic-ui.ts +0 -100
  140. package/src/plugins/tui/src/go-key-diagnostic.ts +0 -125
  141. package/src/plugins/tui/src/quota-adapters.ts +0 -1598
  142. package/src/plugins/tui/src/quota-cli.ts +0 -237
  143. package/src/plugins/tui/src/quota-rpc.ts +0 -209
  144. package/src/plugins/tui/src/quota-v2-model.ts +0 -1032
  145. package/src/plugins/tui/src/quota-v2.tsx +0 -986
@@ -0,0 +1,170 @@
1
+ import type { LocalDecisionPolicy } from './local-orchestration.ts'
2
+ import { PANTHEON_AGENT_CATALOG, PANTHEON_AGENT_IDS } from './pantheon-decision-catalog.ts'
3
+ import { isAgentAllowed } from './permission-globs.ts'
4
+ import { PANTHEON_AGENTS } from './v2-delegation-enforce.ts'
5
+
6
+ export type AgentRecommendationReason =
7
+ | 'RECOMMENDED'
8
+ | 'NO_DELEGATION_SIGNAL'
9
+ | 'NO_ELIGIBLE_CANDIDATE'
10
+ | 'AMBIGUOUS_CANDIDATE'
11
+ | 'POLICY_UNAVAILABLE'
12
+ | 'INVALID_INPUT'
13
+
14
+ export interface LocalAgentRecommendation {
15
+ agent: string | null
16
+ reasonCode: AgentRecommendationReason
17
+ }
18
+
19
+ const MAX_REQUEST_LENGTH = 20_000
20
+ const CATALOG_ORDER = new Map(PANTHEON_AGENT_CATALOG.map((entry, index) => [entry.id, index]))
21
+
22
+ const EXPLICIT_DELEGATION_TOKENS = new Set([
23
+ 'delegate',
24
+ 'delegation',
25
+ 'delegar',
26
+ 'delegacao',
27
+ 'handoff',
28
+ 'subagent',
29
+ 'specialist',
30
+ 'especialista',
31
+ 'route',
32
+ 'routing',
33
+ 'parallel',
34
+ 'paralelo',
35
+ ])
36
+
37
+ const ACTION_TOKENS = new Set([
38
+ 'add',
39
+ 'audit',
40
+ 'build',
41
+ 'change',
42
+ 'create',
43
+ 'debug',
44
+ 'design',
45
+ 'fix',
46
+ 'implement',
47
+ 'implementar',
48
+ 'investigate',
49
+ 'migrate',
50
+ 'optimize',
51
+ 'plan',
52
+ 'planejar',
53
+ 'refactor',
54
+ 'research',
55
+ 'review',
56
+ 'revisar',
57
+ 'update',
58
+ ])
59
+
60
+ /** Specialist keywords. Scores are local only and never grant permission. */
61
+ const AGENT_KEYWORDS: Readonly<Record<string, readonly string[]>> = Object.freeze({
62
+ athena: ['plan', 'planning', 'architecture', 'architect', 'strategy', 'spec', 'requirements'],
63
+ apollo: ['investigate', 'investigation', 'research', 'discovery', 'explore', 'find', 'search'],
64
+ hermes: ['api', 'backend', 'fastapi', 'python', 'endpoint', 'async', 'server', 'pytest'],
65
+ aphrodite: [
66
+ 'frontend',
67
+ 'react',
68
+ 'typescript',
69
+ 'css',
70
+ 'component',
71
+ 'ui',
72
+ 'accessibility',
73
+ 'wcag',
74
+ 'responsive',
75
+ ],
76
+ demeter: ['database', 'sql', 'schema', 'migration', 'alembic', 'sqlalchemy', 'query', 'index'],
77
+ themis: ['security', 'owasp', 'audit', 'lint', 'coverage', 'quality', 'vulnerability', 'cve'],
78
+ prometheus: ['docker', 'ci', 'pipeline', 'deploy', 'infrastructure', 'provider', 'container'],
79
+ hephaestus: ['langchain', 'langgraph', 'rag', 'vector', 'embedding', 'llm', 'pipeline', 'ai'],
80
+ nyx: ['observability', 'telemetry', 'opentelemetry', 'tracing', 'metrics', 'langsmith', 'cost'],
81
+ gaia: ['satellite', 'spectral', 'sar', 'geospatial', 'imagery', 'remote', 'sensing'],
82
+ iris: ['github', 'pull', 'request', 'issue', 'branch', 'release', 'tag', 'pr'],
83
+ mnemosyne: ['memory', 'adr', 'documentation', 'knowledge', 'persistent'],
84
+ talos: ['typo', 'hotfix', 'small', 'quick', 'minor', 'css'],
85
+ })
86
+
87
+ function normalize(value: string): string {
88
+ return value
89
+ .normalize('NFD')
90
+ .replace(/[\u0300-\u036f]/g, '')
91
+ .toLowerCase()
92
+ }
93
+
94
+ function tokenize(value: string): Set<string> {
95
+ const tokens = value.match(/[a-z0-9]+(?:[+#.-][a-z0-9]+)*/g) ?? []
96
+ return new Set(tokens)
97
+ }
98
+
99
+ /** True when the request plausibly considers delegating to a specialist. */
100
+ export function hasDelegationSignal(request: unknown): boolean {
101
+ if (typeof request !== 'string' || request.trim().length === 0) return false
102
+ if (request.length > MAX_REQUEST_LENGTH) return false
103
+ const tokens = tokenize(normalize(request))
104
+ for (const token of EXPLICIT_DELEGATION_TOKENS) {
105
+ if (tokens.has(token)) return true
106
+ }
107
+ if (![...tokens].some((token) => ACTION_TOKENS.has(token))) return false
108
+ return [...tokens].some((token) =>
109
+ Object.values(AGENT_KEYWORDS).some((keywords) => keywords.includes(token)),
110
+ )
111
+ }
112
+
113
+ /** Intersect canonical agents with Zeus grants, routing defaults, and task rules. */
114
+ export function listEligibleDecisionAgents(policy: LocalDecisionPolicy | undefined): string[] {
115
+ if (policy === undefined || !PANTHEON_AGENTS.has('zeus')) return []
116
+ const zeus = policy.agents.zeus
117
+ if (zeus === undefined) return []
118
+ return PANTHEON_AGENT_CATALOG.filter(({ id }) => id !== 'zeus')
119
+ .filter(({ id }) => {
120
+ const target = policy.agents[id]
121
+ return (
122
+ PANTHEON_AGENT_IDS.has(id) &&
123
+ target?.canReceiveDelegation === true &&
124
+ zeus.canDelegateTo.includes(id) &&
125
+ isAgentAllowed(policy.permissionTask, id)
126
+ )
127
+ })
128
+ .map(({ id }) => id)
129
+ }
130
+
131
+ /**
132
+ * Recommend at most one canonical specialist, or abstain. The result is
133
+ * advisory only: it neither dispatches nor grants anything.
134
+ */
135
+ export function recommendLocalDecisionAgent(
136
+ request: unknown,
137
+ policy: LocalDecisionPolicy | undefined,
138
+ ): LocalAgentRecommendation {
139
+ if (typeof request !== 'string' || request.trim().length === 0) {
140
+ return { agent: null, reasonCode: 'INVALID_INPUT' }
141
+ }
142
+ if (request.length > MAX_REQUEST_LENGTH) {
143
+ return { agent: null, reasonCode: 'INVALID_INPUT' }
144
+ }
145
+ if (policy === undefined) return { agent: null, reasonCode: 'POLICY_UNAVAILABLE' }
146
+ if (!hasDelegationSignal(request)) {
147
+ return { agent: null, reasonCode: 'NO_DELEGATION_SIGNAL' }
148
+ }
149
+
150
+ const eligible = new Set(listEligibleDecisionAgents(policy))
151
+ if (eligible.size === 0) return { agent: null, reasonCode: 'NO_ELIGIBLE_CANDIDATE' }
152
+
153
+ const tokens = tokenize(normalize(request))
154
+ const scored: Array<{ id: string; score: number; order: number }> = []
155
+ for (const id of eligible) {
156
+ const keywords = AGENT_KEYWORDS[id] ?? []
157
+ const score = keywords.reduce((total, keyword) => total + (tokens.has(keyword) ? 1 : 0), 0)
158
+ if (score <= 0) continue
159
+ scored.push({ id, score, order: CATALOG_ORDER.get(id) ?? 0 })
160
+ }
161
+ if (scored.length === 0) return { agent: null, reasonCode: 'NO_ELIGIBLE_CANDIDATE' }
162
+
163
+ scored.sort((left, right) => right.score - left.score || left.order - right.order)
164
+ const [first, second] = scored
165
+ if (first === undefined) return { agent: null, reasonCode: 'NO_ELIGIBLE_CANDIDATE' }
166
+ if (second !== undefined && second.score === first.score) {
167
+ return { agent: null, reasonCode: 'AMBIGUOUS_CANDIDATE' }
168
+ }
169
+ return { agent: first.id, reasonCode: 'RECOMMENDED' }
170
+ }