sentinelayer-cli 0.4.5 → 0.8.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.
- package/README.md +16 -18
- package/package.json +7 -6
- package/src/agents/jules/config/definition.js +13 -62
- package/src/agents/jules/config/system-prompt.js +8 -1
- package/src/agents/jules/fix-cycle.js +12 -372
- package/src/agents/jules/loop.js +116 -26
- package/src/agents/jules/pulse.js +10 -327
- package/src/agents/jules/stream.js +13 -12
- package/src/agents/jules/swarm/orchestrator.js +3 -3
- package/src/agents/jules/swarm/sub-agent.js +6 -3
- package/src/agents/jules/tools/aidenid-email.js +189 -0
- package/src/agents/jules/tools/auth-audit.js +1187 -45
- package/src/agents/jules/tools/dispatch.js +25 -12
- package/src/agents/jules/tools/file-edit.js +2 -180
- package/src/agents/jules/tools/file-read.js +2 -100
- package/src/agents/jules/tools/glob.js +2 -168
- package/src/agents/jules/tools/grep.js +2 -228
- package/src/agents/jules/tools/path-guards.js +2 -161
- package/src/agents/jules/tools/runtime-audit.js +6 -2
- package/src/agents/jules/tools/shell.js +2 -383
- package/src/agents/persona-visuals.js +64 -0
- package/src/agents/shared-tools/dispatch-core.js +320 -0
- package/src/agents/shared-tools/file-edit.js +180 -0
- package/src/agents/shared-tools/file-read.js +100 -0
- package/src/agents/shared-tools/glob.js +168 -0
- package/src/agents/shared-tools/grep.js +228 -0
- package/src/agents/shared-tools/index.js +46 -0
- package/src/agents/shared-tools/path-guards.js +161 -0
- package/src/agents/shared-tools/shell.js +383 -0
- package/src/ai/aidenid.js +56 -7
- package/src/ai/client.js +45 -0
- package/src/ai/proxy.js +137 -0
- package/src/auth/gate.js +290 -16
- package/src/auth/http.js +450 -39
- package/src/auth/service.js +262 -47
- package/src/auth/session-store.js +475 -21
- package/src/cli.js +5 -0
- package/src/commands/audit.js +13 -8
- package/src/commands/auth.js +53 -9
- package/src/commands/omargate.js +10 -2
- package/src/commands/scan.js +10 -4
- package/src/commands/session.js +590 -0
- package/src/commands/spec.js +62 -0
- package/src/commands/watch.js +3 -2
- package/src/daemon/assignment-ledger.js +196 -0
- package/src/daemon/error-worker.js +599 -16
- package/src/daemon/fix-cycle.js +384 -0
- package/src/daemon/ingest-refresh.js +10 -9
- package/src/daemon/jira-lifecycle.js +135 -0
- package/src/daemon/pulse.js +327 -0
- package/src/daemon/scope-engine.js +1068 -0
- package/src/events/schema.js +190 -0
- package/src/interactive/index.js +18 -16
- package/src/legacy-cli.js +606 -37
- package/src/prompt/generator.js +19 -1
- package/src/review/ai-review.js +11 -1
- package/src/review/local-review.js +75 -19
- package/src/review/omargate-interactive.js +68 -0
- package/src/review/omargate-orchestrator.js +404 -0
- package/src/review/persona-prompts.js +296 -0
- package/src/review/scan-modes.js +48 -0
- package/src/scan/generator.js +1 -1
- package/src/session/agent-registry.js +352 -0
- package/src/session/daemon.js +801 -0
- package/src/session/paths.js +33 -0
- package/src/session/runtime-bridge.js +739 -0
- package/src/session/store.js +388 -0
- package/src/session/stream.js +325 -0
- package/src/spec/generator.js +100 -0
- package/src/telemetry/session-tracker.js +148 -32
- package/src/telemetry/sync.js +6 -2
- package/src/ui/command-hints.js +13 -0
package/src/agents/jules/loop.js
CHANGED
|
@@ -5,6 +5,7 @@ import { dispatchTool, createAgentContext, BudgetExhaustedError } from "./tools/
|
|
|
5
5
|
import { JULES_DEFINITION } from "./config/definition.js";
|
|
6
6
|
import { shouldSpawnSubAgents, runJulesSwarm } from "./swarm/orchestrator.js";
|
|
7
7
|
import { frontendAnalyze } from "./tools/frontend-analyze.js";
|
|
8
|
+
import { createAgentEvent } from "../../events/schema.js";
|
|
8
9
|
|
|
9
10
|
/**
|
|
10
11
|
* Jules Tanaka — Agentic Loop
|
|
@@ -66,10 +67,14 @@ export async function* julesAuditLoop(config) {
|
|
|
66
67
|
});
|
|
67
68
|
|
|
68
69
|
const emit = (event, payload) => {
|
|
69
|
-
const evt = {
|
|
70
|
-
stream: "sl_event",
|
|
70
|
+
const evt = createAgentEvent({
|
|
71
71
|
event,
|
|
72
|
-
agent: {
|
|
72
|
+
agent: {
|
|
73
|
+
id: JULES_DEFINITION.id,
|
|
74
|
+
persona: JULES_DEFINITION.persona,
|
|
75
|
+
color: JULES_DEFINITION.color,
|
|
76
|
+
avatar: JULES_DEFINITION.avatar,
|
|
77
|
+
},
|
|
73
78
|
payload,
|
|
74
79
|
usage: {
|
|
75
80
|
costUsd: ctx.usage.costUsd,
|
|
@@ -77,7 +82,9 @@ export async function* julesAuditLoop(config) {
|
|
|
77
82
|
toolCalls: ctx.usage.toolCalls,
|
|
78
83
|
durationMs: Date.now() - startedAt,
|
|
79
84
|
},
|
|
80
|
-
|
|
85
|
+
runId,
|
|
86
|
+
sessionId: ctx.sessionId,
|
|
87
|
+
});
|
|
81
88
|
if (onEvent) onEvent(evt);
|
|
82
89
|
return evt;
|
|
83
90
|
};
|
|
@@ -128,30 +135,16 @@ export async function* julesAuditLoop(config) {
|
|
|
128
135
|
|
|
129
136
|
yield emit("progress", { phase: "deep_analysis", message: "Starting deep analysis..." });
|
|
130
137
|
|
|
131
|
-
// Build context for LLM
|
|
138
|
+
// Build context for LLM — BLIND-FIRST: no Omar baseline or swarm findings
|
|
139
|
+
// in the initial context. Only codebase metadata and memory recall (past runs,
|
|
140
|
+
// not current-run findings). Swarm/baseline reconciliation happens AFTER the
|
|
141
|
+
// independent deep analysis completes.
|
|
132
142
|
const contextParts = [];
|
|
133
143
|
contextParts.push(`Framework: ${framework.framework || "unknown"}`);
|
|
134
144
|
contextParts.push(`Mode: ${mode}`);
|
|
135
145
|
contextParts.push(`Components: ${framework.componentCount || "unknown"}`);
|
|
136
146
|
contextParts.push(`Scope: ${(scopeMap.primary || []).length} primary files`);
|
|
137
147
|
|
|
138
|
-
if (swarmFindings.length > 0) {
|
|
139
|
-
contextParts.push(`\nSub-agent findings (${swarmFindings.length} total):`);
|
|
140
|
-
for (const f of swarmFindings.slice(0, 30)) {
|
|
141
|
-
contextParts.push(`- [${f.severity || "P3"}] ${f.file || ""}:${f.line || ""} ${f.title || f.type || ""}`);
|
|
142
|
-
}
|
|
143
|
-
}
|
|
144
|
-
|
|
145
|
-
if (omarBaseline) {
|
|
146
|
-
const baselineFindings = omarBaseline.findings || omarBaseline.summary || [];
|
|
147
|
-
if (Array.isArray(baselineFindings) && baselineFindings.length > 0) {
|
|
148
|
-
contextParts.push(`\nOmar baseline findings (${baselineFindings.length}):`);
|
|
149
|
-
for (const f of baselineFindings.slice(0, 20)) {
|
|
150
|
-
contextParts.push(`- [${f.severity || ""}] ${f.file || ""}:${f.line || ""} ${f.message || f.title || ""}`);
|
|
151
|
-
}
|
|
152
|
-
}
|
|
153
|
-
}
|
|
154
|
-
|
|
155
148
|
if (memory) {
|
|
156
149
|
try {
|
|
157
150
|
const recalled = memory.query ? memory.query({
|
|
@@ -170,7 +163,7 @@ export async function* julesAuditLoop(config) {
|
|
|
170
163
|
const messages = [
|
|
171
164
|
{ role: "user", content: contextParts.join("\n") +
|
|
172
165
|
"\n\nPerform your deep analysis now. Use FileRead, Grep, Glob, and FrontendAnalyze tools as needed. " +
|
|
173
|
-
"Return your findings in a ```json code block as an array of { severity, file, line, title, evidence, rootCause, recommendedFix, trafficLight }." },
|
|
166
|
+
"Return your findings in a ```json code block as an array of { severity, file, line, title, evidence, rootCause, recommendedFix, trafficLight, reproduction, user_impact, confidence }." },
|
|
174
167
|
];
|
|
175
168
|
|
|
176
169
|
const allFindings = [...swarmFindings];
|
|
@@ -217,12 +210,12 @@ export async function* julesAuditLoop(config) {
|
|
|
217
210
|
});
|
|
218
211
|
}
|
|
219
212
|
|
|
220
|
-
// Call LLM
|
|
213
|
+
// Call LLM — format system prompt + messages into a single prompt
|
|
214
|
+
// for the MultiProviderApiClient which uses a completions-style API
|
|
221
215
|
let response;
|
|
222
216
|
try {
|
|
223
217
|
response = await client.invoke({
|
|
224
|
-
systemPrompt,
|
|
225
|
-
messages,
|
|
218
|
+
prompt: formatPromptForClient(systemPrompt, messages),
|
|
226
219
|
});
|
|
227
220
|
} catch (err) {
|
|
228
221
|
yield emit("llm_error", { error: err.message, turn: turnCount });
|
|
@@ -290,6 +283,89 @@ export async function* julesAuditLoop(config) {
|
|
|
290
283
|
});
|
|
291
284
|
}
|
|
292
285
|
|
|
286
|
+
// ── Phase 2b: Reconciliation (post-blind-pass) ─────────────────────
|
|
287
|
+
// Now that the independent analysis is complete, cross-reference with
|
|
288
|
+
// swarm findings and Omar baseline. This preserves blind-first: the
|
|
289
|
+
// persona formed its own opinion before seeing prior conclusions.
|
|
290
|
+
|
|
291
|
+
const hasSwarmContext = swarmFindings.length > 0;
|
|
292
|
+
const baselineFindings = omarBaseline
|
|
293
|
+
? (omarBaseline.findings || omarBaseline.summary || [])
|
|
294
|
+
: [];
|
|
295
|
+
const hasBaselineContext = Array.isArray(baselineFindings) && baselineFindings.length > 0;
|
|
296
|
+
|
|
297
|
+
if (hasSwarmContext || hasBaselineContext) {
|
|
298
|
+
yield emit("progress", { phase: "reconciliation", message: "Cross-referencing with sub-agent and baseline findings..." });
|
|
299
|
+
|
|
300
|
+
const reconcileParts = [];
|
|
301
|
+
reconcileParts.push("Your independent analysis is complete. Now cross-reference with the following prior findings.");
|
|
302
|
+
reconcileParts.push("For each prior finding: confirm if your analysis agrees, dispute with evidence if you disagree, or flag as missed if you did not cover it.");
|
|
303
|
+
|
|
304
|
+
if (hasSwarmContext) {
|
|
305
|
+
reconcileParts.push(`\nYour sub-agents found ${swarmFindings.length} findings:`);
|
|
306
|
+
for (const f of swarmFindings.slice(0, 30)) {
|
|
307
|
+
reconcileParts.push(`- [${f.severity || "P3"}] ${f.file || ""}:${f.line || ""} ${f.title || f.type || ""}`);
|
|
308
|
+
}
|
|
309
|
+
}
|
|
310
|
+
|
|
311
|
+
if (hasBaselineContext) {
|
|
312
|
+
reconcileParts.push(`\nOmar baseline reported ${baselineFindings.length} findings:`);
|
|
313
|
+
for (const f of baselineFindings.slice(0, 20)) {
|
|
314
|
+
reconcileParts.push(`- [${f.severity || ""}] ${f.file || ""}:${f.line || ""} ${f.message || f.title || ""}`);
|
|
315
|
+
}
|
|
316
|
+
}
|
|
317
|
+
|
|
318
|
+
reconcileParts.push("\nReturn any additional or revised findings as a JSON array in a ```json code block. If no changes, return an empty array [].");
|
|
319
|
+
|
|
320
|
+
messages.push({ role: "user", content: reconcileParts.join("\n") });
|
|
321
|
+
|
|
322
|
+
// Budget check before reconciliation turn
|
|
323
|
+
const reconcilePreCheck = evaluateBudget({
|
|
324
|
+
sessionSummary: {
|
|
325
|
+
costUsd: ctx.usage.costUsd,
|
|
326
|
+
outputTokens: ctx.usage.outputTokens,
|
|
327
|
+
durationMs: Date.now() - startedAt,
|
|
328
|
+
toolCalls: ctx.usage.toolCalls,
|
|
329
|
+
},
|
|
330
|
+
...budget,
|
|
331
|
+
});
|
|
332
|
+
|
|
333
|
+
if (!reconcilePreCheck.blocking) {
|
|
334
|
+
try {
|
|
335
|
+
const reconcileResponse = await client.invoke({
|
|
336
|
+
prompt: formatPromptForClient(systemPrompt, messages),
|
|
337
|
+
});
|
|
338
|
+
|
|
339
|
+
const reconcileText = reconcileResponse.text || "";
|
|
340
|
+
ctx.usage.outputTokens += Math.ceil(reconcileText.length / 4);
|
|
341
|
+
ctx.usage.costUsd += (Math.ceil(reconcileText.length / 4) / 1_000_000) * 15;
|
|
342
|
+
|
|
343
|
+
yield emit("reasoning", { phase: "reconciliation", summary: reconcileText.slice(0, 200) });
|
|
344
|
+
|
|
345
|
+
const reconcileFindings = extractJsonFindings(reconcileText);
|
|
346
|
+
for (const finding of reconcileFindings) {
|
|
347
|
+
allFindings.push(finding);
|
|
348
|
+
yield emit("finding", { ...finding, source: "reconciliation" });
|
|
349
|
+
if (blackboard) {
|
|
350
|
+
try {
|
|
351
|
+
await blackboard.appendEntry({
|
|
352
|
+
agentId: JULES_DEFINITION.id,
|
|
353
|
+
source: "jules-reconciliation",
|
|
354
|
+
...finding,
|
|
355
|
+
});
|
|
356
|
+
} catch { /* blackboard write failure non-blocking */ }
|
|
357
|
+
}
|
|
358
|
+
}
|
|
359
|
+
|
|
360
|
+
messages.push({ role: "assistant", content: reconcileText });
|
|
361
|
+
} catch (err) {
|
|
362
|
+
yield emit("llm_error", { error: err.message, phase: "reconciliation" });
|
|
363
|
+
}
|
|
364
|
+
} else {
|
|
365
|
+
yield emit("budget_stop", { reasons: reconcilePreCheck.reasons, phase: "reconciliation" });
|
|
366
|
+
}
|
|
367
|
+
}
|
|
368
|
+
|
|
293
369
|
// ── Phase 3: Build final report ───────────────────────────────────
|
|
294
370
|
|
|
295
371
|
const durationMs = Date.now() - startedAt;
|
|
@@ -365,3 +441,17 @@ function sanitizeForEvent(input) {
|
|
|
365
441
|
}
|
|
366
442
|
return sanitized;
|
|
367
443
|
}
|
|
444
|
+
|
|
445
|
+
/**
|
|
446
|
+
* Format system prompt + chat messages into a single prompt string
|
|
447
|
+
* for MultiProviderApiClient which uses a completions-style API.
|
|
448
|
+
*/
|
|
449
|
+
function formatPromptForClient(systemPrompt, messages) {
|
|
450
|
+
const parts = [];
|
|
451
|
+
if (systemPrompt) parts.push(systemPrompt);
|
|
452
|
+
for (const msg of messages) {
|
|
453
|
+
const role = msg.role === "assistant" ? "ASSISTANT" : "USER";
|
|
454
|
+
parts.push(`\n${role}:\n${msg.content}`);
|
|
455
|
+
}
|
|
456
|
+
return parts.join("\n");
|
|
457
|
+
}
|
|
@@ -1,327 +1,10 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
// ── Stuck Detection ──────────────────────────────────────────────────
|
|
12
|
-
|
|
13
|
-
const STUCK_THRESHOLDS = Object.freeze({
|
|
14
|
-
noToolCallSeconds: 90,
|
|
15
|
-
noProgressTurns: 5,
|
|
16
|
-
sameFileReadCount: 3,
|
|
17
|
-
budgetConsumedNoOutput: 0.5,
|
|
18
|
-
maxIdleBeforeEscalate: 300,
|
|
19
|
-
maxIdleBeforeKill: 600,
|
|
20
|
-
});
|
|
21
|
-
|
|
22
|
-
/**
|
|
23
|
-
* Detect if an agent is stuck based on its current state.
|
|
24
|
-
*
|
|
25
|
-
* @param {object} agentState
|
|
26
|
-
* @param {number} agentState.lastToolCallAt - Epoch ms
|
|
27
|
-
* @param {number} agentState.lastTurnProgressAt - Epoch ms
|
|
28
|
-
* @param {number} agentState.sameFileReadCount - Consecutive reads of same file
|
|
29
|
-
* @param {string} [agentState.lastFileRead] - Path of last file read
|
|
30
|
-
* @param {number} agentState.budgetConsumedPct - 0-100
|
|
31
|
-
* @param {number} agentState.findingCount
|
|
32
|
-
* @param {number} [agentState.turnsSinceLastProgress]
|
|
33
|
-
* @returns {{ stuck: boolean, reason?: string, idleSeconds?: number, file?: string, budgetPct?: number }}
|
|
34
|
-
*/
|
|
35
|
-
export function detectStuckState(agentState) {
|
|
36
|
-
const now = Date.now();
|
|
37
|
-
|
|
38
|
-
// No tool calls for threshold period
|
|
39
|
-
if (agentState.lastToolCallAt) {
|
|
40
|
-
const idleMs = now - agentState.lastToolCallAt;
|
|
41
|
-
if (idleMs > STUCK_THRESHOLDS.noToolCallSeconds * 1000) {
|
|
42
|
-
return { stuck: true, reason: "no_tool_calls", idleSeconds: Math.floor(idleMs / 1000) };
|
|
43
|
-
}
|
|
44
|
-
}
|
|
45
|
-
|
|
46
|
-
// Same file read repeatedly (loop detection)
|
|
47
|
-
if (agentState.sameFileReadCount >= STUCK_THRESHOLDS.sameFileReadCount) {
|
|
48
|
-
return { stuck: true, reason: "loop_detected", file: agentState.lastFileRead };
|
|
49
|
-
}
|
|
50
|
-
|
|
51
|
-
// High budget consumption with no findings
|
|
52
|
-
if (
|
|
53
|
-
agentState.budgetConsumedPct > STUCK_THRESHOLDS.budgetConsumedNoOutput * 100 &&
|
|
54
|
-
agentState.findingCount === 0
|
|
55
|
-
) {
|
|
56
|
-
return { stuck: true, reason: "inefficient", budgetPct: agentState.budgetConsumedPct };
|
|
57
|
-
}
|
|
58
|
-
|
|
59
|
-
// No turn progress
|
|
60
|
-
if (agentState.turnsSinceLastProgress >= STUCK_THRESHOLDS.noProgressTurns) {
|
|
61
|
-
return { stuck: true, reason: "no_progress", turns: agentState.turnsSinceLastProgress };
|
|
62
|
-
}
|
|
63
|
-
|
|
64
|
-
return { stuck: false };
|
|
65
|
-
}
|
|
66
|
-
|
|
67
|
-
/**
|
|
68
|
-
* Determine recovery action based on idle duration.
|
|
69
|
-
*
|
|
70
|
-
* @param {number} idleSeconds
|
|
71
|
-
* @returns {"hint" | "escalate" | "kill"}
|
|
72
|
-
*/
|
|
73
|
-
export function determineRecoveryAction(idleSeconds) {
|
|
74
|
-
if (idleSeconds >= STUCK_THRESHOLDS.maxIdleBeforeKill) return "kill";
|
|
75
|
-
if (idleSeconds >= STUCK_THRESHOLDS.maxIdleBeforeEscalate) return "escalate";
|
|
76
|
-
return "hint";
|
|
77
|
-
}
|
|
78
|
-
|
|
79
|
-
// ── Error-to-Persona Routing ─────────────────────────────────────────
|
|
80
|
-
|
|
81
|
-
const ROUTING_RULES = [
|
|
82
|
-
// Stack trace patterns (most reliable)
|
|
83
|
-
{ test: (w) => /\.(tsx|jsx|vue|svelte):\d+/.test(w.stackTrace || ""), persona: "frontend" },
|
|
84
|
-
{ test: (w) => /React|Next|Vite|Webpack|hydrat/i.test(w.stackTrace || ""), persona: "frontend" },
|
|
85
|
-
{ test: (w) => /\.py:\d+/.test(w.stackTrace || ""), persona: "backend" },
|
|
86
|
-
{ test: (w) => /\.go:\d+/.test(w.stackTrace || ""), persona: "backend" },
|
|
87
|
-
|
|
88
|
-
// Endpoint patterns
|
|
89
|
-
{ test: (w) => /\.(html|css|js|png|svg|woff)$/.test(w.endpoint || ""), persona: "frontend" },
|
|
90
|
-
{ test: (w) => /\/api\/v\d+\/auth/.test(w.endpoint || ""), persona: "security" },
|
|
91
|
-
{ test: (w) => /\/api\//.test(w.endpoint || ""), persona: "backend" },
|
|
92
|
-
|
|
93
|
-
// Error code patterns
|
|
94
|
-
{ test: (w) => /HYDRATION|RENDER|DOM|CSR|SSR/i.test(w.errorCode || ""), persona: "frontend" },
|
|
95
|
-
{ test: (w) => /AUTH|TOKEN|SESSION|PERMISSION/i.test(w.errorCode || ""), persona: "security" },
|
|
96
|
-
{ test: (w) => /TIMEOUT|ECONNREFUSED|DNS|SOCKET/i.test(w.errorCode || ""), persona: "infrastructure" },
|
|
97
|
-
{ test: (w) => /QUERY|MIGRATION|CONSTRAINT|DEADLOCK/i.test(w.errorCode || ""), persona: "data" },
|
|
98
|
-
];
|
|
99
|
-
|
|
100
|
-
/**
|
|
101
|
-
* Route an error work item to the appropriate persona.
|
|
102
|
-
*
|
|
103
|
-
* @param {object} workItem - Error queue item
|
|
104
|
-
* @returns {string} Persona ID (e.g., "frontend", "backend", "security")
|
|
105
|
-
*/
|
|
106
|
-
export function routeErrorToPersona(workItem) {
|
|
107
|
-
for (const rule of ROUTING_RULES) {
|
|
108
|
-
if (rule.test(workItem)) return rule.persona;
|
|
109
|
-
}
|
|
110
|
-
return "backend"; // default fallback
|
|
111
|
-
}
|
|
112
|
-
|
|
113
|
-
// ── Alert Building ───────────────────────────────────────────────────
|
|
114
|
-
|
|
115
|
-
/**
|
|
116
|
-
* Build a concise alert payload for Slack/Telegram.
|
|
117
|
-
*
|
|
118
|
-
* @param {object} config
|
|
119
|
-
* @param {string} config.agentId - Persona ID
|
|
120
|
-
* @param {string} config.event - Alert event type
|
|
121
|
-
* @param {object} config.state - Agent state snapshot
|
|
122
|
-
* @param {string} [config.workItemId]
|
|
123
|
-
* @param {string} [config.jiraIssueKey]
|
|
124
|
-
* @returns {{ headline, body, severity }}
|
|
125
|
-
*/
|
|
126
|
-
export function buildAlertPayload({ agentId, event, state, workItemId, jiraIssueKey }) {
|
|
127
|
-
const visual = PERSONA_VISUALS[agentId] || { avatar: "", fullName: agentId, color: "white" };
|
|
128
|
-
const avatar = visual.avatar;
|
|
129
|
-
const name = visual.fullName;
|
|
130
|
-
|
|
131
|
-
const lines = [];
|
|
132
|
-
lines.push(`${avatar} ${name} \u2014 ${formatAlertEvent(event)}`);
|
|
133
|
-
lines.push("\u2501".repeat(30));
|
|
134
|
-
|
|
135
|
-
if (workItemId) lines.push(`Work Item: ${workItemId}`);
|
|
136
|
-
if (jiraIssueKey) lines.push(`Jira: ${jiraIssueKey}`);
|
|
137
|
-
|
|
138
|
-
if (state) {
|
|
139
|
-
if (state.durationMs) lines.push(`Duration: ${formatDuration(state.durationMs)}`);
|
|
140
|
-
if (state.budgetPct !== undefined) lines.push(`Budget: ${state.budgetPct.toFixed(0)}%`);
|
|
141
|
-
if (state.turnsCompleted !== undefined) lines.push(`Turns: ${state.turnsCompleted}/${state.turnsMax || "?"}`);
|
|
142
|
-
if (state.findingCount !== undefined) lines.push(`Findings: ${state.findingCount}`);
|
|
143
|
-
if (state.lastAction) lines.push(`Last: ${state.lastAction}`);
|
|
144
|
-
if (state.costUsd !== undefined) lines.push(`Cost: $${state.costUsd.toFixed(2)}`);
|
|
145
|
-
if (state.prNumber) lines.push(`PR: #${state.prNumber}`);
|
|
146
|
-
}
|
|
147
|
-
|
|
148
|
-
const severity = event.includes("stuck") || event.includes("kill") ? "warning" :
|
|
149
|
-
event.includes("merged") || event.includes("complete") ? "success" : "info";
|
|
150
|
-
|
|
151
|
-
lines.push("");
|
|
152
|
-
lines.push(`\u2014 ${name}, SentinelLayer`);
|
|
153
|
-
|
|
154
|
-
return {
|
|
155
|
-
headline: `${avatar} ${name}: ${formatAlertEvent(event)}`,
|
|
156
|
-
body: lines.join("\n"),
|
|
157
|
-
severity,
|
|
158
|
-
};
|
|
159
|
-
}
|
|
160
|
-
|
|
161
|
-
function formatAlertEvent(event) {
|
|
162
|
-
const map = {
|
|
163
|
-
agent_stuck: "Agent Stuck",
|
|
164
|
-
agent_recovered: "Agent Recovered",
|
|
165
|
-
budget_warning: "Budget Warning",
|
|
166
|
-
budget_exhausted: "Budget Exhausted",
|
|
167
|
-
pr_merged: "PR Merged",
|
|
168
|
-
audit_complete: "Audit Complete",
|
|
169
|
-
fix_complete: "Fix Complete",
|
|
170
|
-
kill_switch: "Kill Switch Activated",
|
|
171
|
-
error_intake: "Error Received",
|
|
172
|
-
jira_resolved: "Jira Resolved",
|
|
173
|
-
};
|
|
174
|
-
return map[event] || event;
|
|
175
|
-
}
|
|
176
|
-
|
|
177
|
-
function formatDuration(ms) {
|
|
178
|
-
if (ms < 60000) return `${(ms / 1000).toFixed(0)}s`;
|
|
179
|
-
if (ms < 3600000) return `${(ms / 60000).toFixed(1)}m`;
|
|
180
|
-
return `${(ms / 3600000).toFixed(1)}h`;
|
|
181
|
-
}
|
|
182
|
-
|
|
183
|
-
// ── Health Summary ───────────────────────────────────────────────────
|
|
184
|
-
|
|
185
|
-
/**
|
|
186
|
-
* Build a periodic health summary for Slack/Telegram.
|
|
187
|
-
*
|
|
188
|
-
* @param {object[]} agentStates - Current states of all running agents
|
|
189
|
-
* @returns {{ headline, body } | null} null if nothing to report
|
|
190
|
-
*/
|
|
191
|
-
export function buildHealthSummary(agentStates) {
|
|
192
|
-
if (!agentStates || agentStates.length === 0) return null;
|
|
193
|
-
|
|
194
|
-
const active = agentStates.filter(a => a.status === "active");
|
|
195
|
-
const stuck = agentStates.filter(a => a.stuck);
|
|
196
|
-
const completed = agentStates.filter(a => a.status === "completed");
|
|
197
|
-
|
|
198
|
-
if (active.length === 0 && stuck.length === 0 && completed.length === 0) return null;
|
|
199
|
-
|
|
200
|
-
const lines = [];
|
|
201
|
-
lines.push("\u{1F4CA} Pulse Health Summary");
|
|
202
|
-
lines.push("\u2501".repeat(30));
|
|
203
|
-
lines.push(`Active: ${active.length} | Stuck: ${stuck.length} | Completed: ${completed.length}`);
|
|
204
|
-
|
|
205
|
-
for (const a of active.slice(0, 5)) {
|
|
206
|
-
const visual = PERSONA_VISUALS[a.agentId] || {};
|
|
207
|
-
lines.push(` ${visual.avatar || ""} ${visual.shortName || a.agentId}: ${a.findingCount || 0} findings, $${(a.costUsd || 0).toFixed(2)}`);
|
|
208
|
-
}
|
|
209
|
-
|
|
210
|
-
if (stuck.length > 0) {
|
|
211
|
-
lines.push("");
|
|
212
|
-
lines.push("\u26A0\uFE0F Stuck agents:");
|
|
213
|
-
for (const s of stuck) {
|
|
214
|
-
const visual = PERSONA_VISUALS[s.agentId] || {};
|
|
215
|
-
lines.push(` ${visual.avatar || ""} ${visual.shortName || s.agentId}: ${s.reason || "unknown"} (${s.idleSeconds || 0}s idle)`);
|
|
216
|
-
}
|
|
217
|
-
}
|
|
218
|
-
|
|
219
|
-
return {
|
|
220
|
-
headline: `Pulse: ${active.length} active, ${stuck.length} stuck, ${completed.length} done`,
|
|
221
|
-
body: lines.join("\n"),
|
|
222
|
-
};
|
|
223
|
-
}
|
|
224
|
-
|
|
225
|
-
// ── Webhook Delivery ─────────────────────────────────────────────────
|
|
226
|
-
|
|
227
|
-
/**
|
|
228
|
-
* Send an alert to configured Slack/Telegram webhooks.
|
|
229
|
-
* Reads config from env or .sentinelayer.yml.
|
|
230
|
-
* Fails silently — alert delivery must never block agent work.
|
|
231
|
-
*
|
|
232
|
-
* @param {object} alert - { headline, body, severity } from buildAlertPayload
|
|
233
|
-
* @param {object} [channels] - Override channel config
|
|
234
|
-
* @returns {Promise<{ sent: object[], errors: object[] }>}
|
|
235
|
-
*/
|
|
236
|
-
export async function sendAlert(alert, channels) {
|
|
237
|
-
const resolved = channels || resolveAlertChannels();
|
|
238
|
-
const sent = [];
|
|
239
|
-
const errors = [];
|
|
240
|
-
|
|
241
|
-
for (const channel of resolved) {
|
|
242
|
-
try {
|
|
243
|
-
if (channel.type === "slack" && channel.webhook_url) {
|
|
244
|
-
await sendSlackWebhook(channel.webhook_url, alert);
|
|
245
|
-
sent.push({ type: "slack", status: "sent" });
|
|
246
|
-
} else if (channel.type === "telegram" && channel.bot_token && channel.chat_id) {
|
|
247
|
-
await sendTelegramMessage(channel.bot_token, channel.chat_id, alert);
|
|
248
|
-
sent.push({ type: "telegram", status: "sent" });
|
|
249
|
-
}
|
|
250
|
-
} catch (err) {
|
|
251
|
-
errors.push({ type: channel.type, error: err.message });
|
|
252
|
-
}
|
|
253
|
-
}
|
|
254
|
-
|
|
255
|
-
return { sent, errors };
|
|
256
|
-
}
|
|
257
|
-
|
|
258
|
-
async function sendSlackWebhook(webhookUrl, alert) {
|
|
259
|
-
const payload = JSON.stringify({
|
|
260
|
-
text: alert.headline,
|
|
261
|
-
blocks: [
|
|
262
|
-
{ type: "header", text: { type: "plain_text", text: alert.headline } },
|
|
263
|
-
{ type: "section", text: { type: "mrkdwn", text: alert.body } },
|
|
264
|
-
],
|
|
265
|
-
});
|
|
266
|
-
|
|
267
|
-
const response = await fetchWithTimeout(webhookUrl, {
|
|
268
|
-
method: "POST",
|
|
269
|
-
headers: { "Content-Type": "application/json" },
|
|
270
|
-
body: payload,
|
|
271
|
-
}, 10000);
|
|
272
|
-
|
|
273
|
-
if (!response.ok) {
|
|
274
|
-
throw new Error("Slack webhook failed: " + response.status);
|
|
275
|
-
}
|
|
276
|
-
}
|
|
277
|
-
|
|
278
|
-
async function sendTelegramMessage(botToken, chatId, alert) {
|
|
279
|
-
const url = "https://api.telegram.org/bot" + botToken + "/sendMessage";
|
|
280
|
-
const payload = JSON.stringify({
|
|
281
|
-
chat_id: chatId,
|
|
282
|
-
text: alert.body,
|
|
283
|
-
parse_mode: "Markdown",
|
|
284
|
-
disable_web_page_preview: true,
|
|
285
|
-
});
|
|
286
|
-
|
|
287
|
-
const response = await fetchWithTimeout(url, {
|
|
288
|
-
method: "POST",
|
|
289
|
-
headers: { "Content-Type": "application/json" },
|
|
290
|
-
body: payload,
|
|
291
|
-
}, 10000);
|
|
292
|
-
|
|
293
|
-
if (!response.ok) {
|
|
294
|
-
throw new Error("Telegram send failed: " + response.status);
|
|
295
|
-
}
|
|
296
|
-
}
|
|
297
|
-
|
|
298
|
-
function resolveAlertChannels() {
|
|
299
|
-
const channels = [];
|
|
300
|
-
|
|
301
|
-
// Slack from env
|
|
302
|
-
const slackUrl = process.env.SENTINELAYER_SLACK_WEBHOOK_URL;
|
|
303
|
-
if (slackUrl) {
|
|
304
|
-
channels.push({ type: "slack", webhook_url: slackUrl });
|
|
305
|
-
}
|
|
306
|
-
|
|
307
|
-
// Telegram from env
|
|
308
|
-
const tgToken = process.env.SENTINELAYER_TELEGRAM_BOT_TOKEN;
|
|
309
|
-
const tgChat = process.env.SENTINELAYER_TELEGRAM_CHAT_ID;
|
|
310
|
-
if (tgToken && tgChat) {
|
|
311
|
-
channels.push({ type: "telegram", bot_token: tgToken, chat_id: tgChat });
|
|
312
|
-
}
|
|
313
|
-
|
|
314
|
-
return channels;
|
|
315
|
-
}
|
|
316
|
-
|
|
317
|
-
async function fetchWithTimeout(url, options, timeoutMs) {
|
|
318
|
-
const controller = new AbortController();
|
|
319
|
-
const timeoutHandle = setTimeout(() => controller.abort(), timeoutMs);
|
|
320
|
-
try {
|
|
321
|
-
return await fetch(url, { ...options, signal: controller.signal });
|
|
322
|
-
} finally {
|
|
323
|
-
clearTimeout(timeoutHandle);
|
|
324
|
-
}
|
|
325
|
-
}
|
|
326
|
-
|
|
327
|
-
export { STUCK_THRESHOLDS };
|
|
1
|
+
// Re-export from platform daemon. Pulse is not Jules-specific.
|
|
2
|
+
export {
|
|
3
|
+
detectStuckState,
|
|
4
|
+
determineRecoveryAction,
|
|
5
|
+
routeErrorToPersona,
|
|
6
|
+
buildAlertPayload,
|
|
7
|
+
buildHealthSummary,
|
|
8
|
+
sendAlert,
|
|
9
|
+
STUCK_THRESHOLDS,
|
|
10
|
+
} from "../../daemon/pulse.js";
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { PERSONA_VISUALS, resolvePersonaVisual } from "./config/definition.js";
|
|
2
|
+
import { createAgentEvent } from "../../events/schema.js";
|
|
2
3
|
|
|
3
4
|
/**
|
|
4
5
|
* Jules Tanaka — Streaming Event Formatter
|
|
@@ -22,20 +23,20 @@ const SCHEMA_VERSION = 1;
|
|
|
22
23
|
export function buildStreamEvent(event, agentIdentity, payload, usage, runId) {
|
|
23
24
|
const visual = resolvePersonaVisual(agentIdentity?.id) || {};
|
|
24
25
|
return {
|
|
25
|
-
|
|
26
|
+
...createAgentEvent({
|
|
27
|
+
event,
|
|
28
|
+
agent: {
|
|
29
|
+
id: agentIdentity?.id || "unknown",
|
|
30
|
+
persona: agentIdentity?.persona || visual.fullName || "unknown",
|
|
31
|
+
color: agentIdentity?.color || visual.color || "white",
|
|
32
|
+
avatar: agentIdentity?.avatar || visual.avatar || "",
|
|
33
|
+
},
|
|
34
|
+
payload: payload || {},
|
|
35
|
+
usage: usage || {},
|
|
36
|
+
runId: runId || undefined,
|
|
37
|
+
}),
|
|
26
38
|
version: SCHEMA_VERSION,
|
|
27
39
|
command: "audit.deep",
|
|
28
|
-
runId: runId || null,
|
|
29
|
-
timestamp: new Date().toISOString(),
|
|
30
|
-
agent: {
|
|
31
|
-
id: agentIdentity?.id || "unknown",
|
|
32
|
-
persona: agentIdentity?.persona || visual.fullName || "unknown",
|
|
33
|
-
color: agentIdentity?.color || visual.color || "white",
|
|
34
|
-
avatar: agentIdentity?.avatar || visual.avatar || "",
|
|
35
|
-
},
|
|
36
|
-
event,
|
|
37
|
-
payload: payload || {},
|
|
38
|
-
usage: usage || {},
|
|
39
40
|
};
|
|
40
41
|
}
|
|
41
42
|
|
|
@@ -7,6 +7,7 @@ import { createPatternHunter, HUNT_TYPES } from "./pattern-hunter.js";
|
|
|
7
7
|
import { runSubAgentBatch } from "./sub-agent.js";
|
|
8
8
|
import { frontendAnalyze } from "../tools/frontend-analyze.js";
|
|
9
9
|
import { createAgentContext } from "../tools/dispatch.js";
|
|
10
|
+
import { createAgentEvent } from "../../../events/schema.js";
|
|
10
11
|
|
|
11
12
|
/**
|
|
12
13
|
* Jules Swarm Orchestrator
|
|
@@ -352,11 +353,10 @@ function collectDiscoveredDeps(scanResults) {
|
|
|
352
353
|
|
|
353
354
|
function emit(onEvent, event, payload) {
|
|
354
355
|
if (onEvent) {
|
|
355
|
-
onEvent({
|
|
356
|
-
stream: "sl_event",
|
|
356
|
+
onEvent(createAgentEvent({
|
|
357
357
|
event,
|
|
358
358
|
agent: { id: "frontend", persona: "Jules Tanaka", color: "cyan", avatar: "\u{1F3AF}" },
|
|
359
359
|
payload,
|
|
360
|
-
});
|
|
360
|
+
}));
|
|
361
361
|
}
|
|
362
362
|
}
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { randomUUID } from "node:crypto";
|
|
2
2
|
import { createAgentContext, dispatchTool, isReadOnlyTool, BudgetExhaustedError } from "../tools/dispatch.js";
|
|
3
3
|
import { createMultiProviderApiClient } from "../../../ai/client.js";
|
|
4
|
+
import { createAgentEvent } from "../../../events/schema.js";
|
|
4
5
|
|
|
5
6
|
/**
|
|
6
7
|
* JulesSubAgent — lightweight isolated agent for parallel audit work.
|
|
@@ -201,14 +202,14 @@ export class JulesSubAgent {
|
|
|
201
202
|
costUsd: this.ctx.usage.costUsd,
|
|
202
203
|
outputTokens: this.ctx.usage.outputTokens,
|
|
203
204
|
durationMs: Date.now() - this.ctx.startedAt,
|
|
205
|
+
filesRead: [...(this.ctx.usage.filesRead || [])],
|
|
204
206
|
},
|
|
205
207
|
};
|
|
206
208
|
}
|
|
207
209
|
|
|
208
210
|
emitEvent(event, payload) {
|
|
209
211
|
if (this.onEvent) {
|
|
210
|
-
this.onEvent({
|
|
211
|
-
stream: "sl_event",
|
|
212
|
+
this.onEvent(createAgentEvent({
|
|
212
213
|
event,
|
|
213
214
|
agent: { id: this.id, persona: `Jules Sub-Agent (${this.role})`, parentId: "frontend" },
|
|
214
215
|
payload,
|
|
@@ -217,7 +218,9 @@ export class JulesSubAgent {
|
|
|
217
218
|
toolCalls: this.ctx.usage.toolCalls,
|
|
218
219
|
durationMs: Date.now() - this.ctx.startedAt,
|
|
219
220
|
},
|
|
220
|
-
|
|
221
|
+
sessionId: this.ctx.sessionId,
|
|
222
|
+
runId: this.ctx.runId,
|
|
223
|
+
}));
|
|
221
224
|
}
|
|
222
225
|
}
|
|
223
226
|
}
|