pantheon-opencode 1.6.2-beta.3 → 1.6.2-beta.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 +34 -0
- package/README.md +38 -1
- package/bin/pantheon-init.mjs +17 -0
- package/package.json +9 -3
- package/plugin.json +1 -1
- package/pyproject.toml +1 -1
- package/scripts/decision-router-budget.mjs +781 -0
- package/scripts/decision-router.mjs +297 -0
- package/scripts/install/decision-router-config.mjs +432 -0
- package/scripts/install/interactive.mjs +76 -5
- package/scripts/install/opencode.mjs +12 -0
- package/scripts/install/state.mjs +5 -0
- package/scripts/install/strings.mjs +4 -0
- package/src/agents/zeus.md +12 -0
- package/src/pantheon/local-decision-agents.ts +170 -0
- package/src/pantheon/local-decision-budget.ts +1043 -0
- package/src/pantheon/local-decision-egress-gate.ts +264 -0
- package/src/pantheon/local-decision-prompt.ts +123 -0
- package/src/pantheon/local-decision-provider-matrix.ts +92 -0
- package/src/pantheon/local-decision-provider-protocol.ts +335 -0
- package/src/pantheon/local-decision-provider.internal.ts +260 -0
- package/src/pantheon/local-decision-router.ts +225 -0
- package/src/pantheon/local-decision-skills.ts +171 -0
- package/src/pantheon/local-decision-tool.ts +126 -0
- package/src/pantheon/local-decision-turn.ts +338 -0
- package/src/pantheon/local-decision-usage-evidence.internal.ts +207 -0
- package/src/pantheon/local-orchestration.ts +322 -0
- package/src/pantheon/pantheon-decision-catalog.ts +101 -0
- package/src/pantheon/v2-tools.ts +15 -14
- package/src/plugin-v2.ts +52 -19
- package/src/plugin.ts +4 -0
- package/src/plugins/tui/dist/tui-v2.js +3 -3
- package/src/plugins/tui/dist/tui.js +1 -1
- package/src/plugins/tui/package-lock.json +2 -2
- 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
|
+
}
|