pantheon-opencode 1.6.2-beta.3 → 1.6.2-beta.5

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 (71) hide show
  1. package/CHANGELOG.md +42 -0
  2. package/README.md +209 -1
  3. package/bin/pantheon-init.mjs +22 -0
  4. package/package.json +9 -3
  5. package/plugin.json +1 -1
  6. package/pyproject.toml +1 -1
  7. package/scripts/decision-router-budget.mjs +781 -0
  8. package/scripts/decision-router-v2-budget.mjs +218 -0
  9. package/scripts/decision-router-v2-egress.mjs +272 -0
  10. package/scripts/decision-router.mjs +519 -0
  11. package/scripts/docs-check-changelog.mjs +5 -3
  12. package/scripts/install/decision-layer-preview.mjs +376 -0
  13. package/scripts/install/decision-router-config.mjs +579 -0
  14. package/scripts/install/interactive.mjs +76 -5
  15. package/scripts/install/opencode.mjs +12 -0
  16. package/scripts/install/state.mjs +5 -0
  17. package/scripts/install/strings.mjs +4 -0
  18. package/scripts/mcp_resources.py +11 -9
  19. package/scripts/release-notes.mjs +30 -7
  20. package/scripts/versioning.mjs +41 -5
  21. package/src/agents/zeus.md +12 -0
  22. package/src/mcp/eval_store.py +11 -4
  23. package/src/mcp/mcp_resources.py +11 -9
  24. package/src/mcp/memory_mcp.py +293 -150
  25. package/src/pantheon/local-decision-agents.ts +170 -0
  26. package/src/pantheon/local-decision-budget.ts +1043 -0
  27. package/src/pantheon/local-decision-egress-gate.ts +264 -0
  28. package/src/pantheon/local-decision-prompt.ts +268 -0
  29. package/src/pantheon/local-decision-provider-matrix.ts +92 -0
  30. package/src/pantheon/local-decision-provider-protocol.ts +335 -0
  31. package/src/pantheon/local-decision-provider.internal.ts +260 -0
  32. package/src/pantheon/local-decision-router.ts +225 -0
  33. package/src/pantheon/local-decision-skills.ts +281 -0
  34. package/src/pantheon/local-decision-tool.ts +160 -0
  35. package/src/pantheon/local-decision-turn.ts +338 -0
  36. package/src/pantheon/local-decision-usage-evidence.internal.ts +207 -0
  37. package/src/pantheon/local-orchestration.ts +322 -0
  38. package/src/pantheon/pantheon-decision-catalog.ts +101 -0
  39. package/src/pantheon/v2-decision-budget.ts +456 -0
  40. package/src/pantheon/v2-decision-contracts.ts +300 -0
  41. package/src/pantheon/v2-decision-egress.ts +203 -0
  42. package/src/pantheon/v2-decision-events.ts +180 -0
  43. package/src/pantheon/v2-decision-heuristic.ts +121 -0
  44. package/src/pantheon/v2-decision-points/p1-agent.ts +91 -0
  45. package/src/pantheon/v2-decision-points/p10-claims.ts +243 -0
  46. package/src/pantheon/v2-decision-points/p11-catalog.ts +220 -0
  47. package/src/pantheon/v2-decision-points/p2-skill.ts +83 -0
  48. package/src/pantheon/v2-decision-points/p3-complexity.ts +108 -0
  49. package/src/pantheon/v2-decision-points/p4-memory.ts +137 -0
  50. package/src/pantheon/v2-decision-points/p5-themis-verify.ts +190 -0
  51. package/src/pantheon/v2-decision-points/p6-council.ts +161 -0
  52. package/src/pantheon/v2-decision-points/p7-loop.ts +263 -0
  53. package/src/pantheon/v2-decision-points/p8-guardrail.ts +366 -0
  54. package/src/pantheon/v2-decision-points/p9-memory-compaction.ts +304 -0
  55. package/src/pantheon/v2-decision-points.ts +242 -0
  56. package/src/pantheon/v2-decision-policy.ts +166 -0
  57. package/src/pantheon/v2-decision-premises.ts +146 -0
  58. package/src/pantheon/v2-decision-prompt-surface.ts +115 -0
  59. package/src/pantheon/v2-decision-rank.ts +91 -0
  60. package/src/pantheon/v2-decision-registry.ts +391 -0
  61. package/src/pantheon/v2-decision-resource-ids.ts +127 -0
  62. package/src/pantheon/v2-decision-shadow.ts +123 -0
  63. package/src/pantheon/v2-decision-telemetry.ts +214 -0
  64. package/src/pantheon/v2-decision-verify.ts +51 -0
  65. package/src/pantheon/v2-tools.ts +35 -15
  66. package/src/plugin-v2.ts +357 -22
  67. package/src/plugin.ts +4 -0
  68. package/src/plugins/tui/dist/tui-v2.js +3 -3
  69. package/src/plugins/tui/dist/tui.js +1 -1
  70. package/src/plugins/tui/package-lock.json +2 -2
  71. package/src/plugins/tui/package.json +1 -1
@@ -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
+ }