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.
Files changed (72) hide show
  1. package/README.md +16 -18
  2. package/package.json +7 -6
  3. package/src/agents/jules/config/definition.js +13 -62
  4. package/src/agents/jules/config/system-prompt.js +8 -1
  5. package/src/agents/jules/fix-cycle.js +12 -372
  6. package/src/agents/jules/loop.js +116 -26
  7. package/src/agents/jules/pulse.js +10 -327
  8. package/src/agents/jules/stream.js +13 -12
  9. package/src/agents/jules/swarm/orchestrator.js +3 -3
  10. package/src/agents/jules/swarm/sub-agent.js +6 -3
  11. package/src/agents/jules/tools/aidenid-email.js +189 -0
  12. package/src/agents/jules/tools/auth-audit.js +1187 -45
  13. package/src/agents/jules/tools/dispatch.js +25 -12
  14. package/src/agents/jules/tools/file-edit.js +2 -180
  15. package/src/agents/jules/tools/file-read.js +2 -100
  16. package/src/agents/jules/tools/glob.js +2 -168
  17. package/src/agents/jules/tools/grep.js +2 -228
  18. package/src/agents/jules/tools/path-guards.js +2 -161
  19. package/src/agents/jules/tools/runtime-audit.js +6 -2
  20. package/src/agents/jules/tools/shell.js +2 -383
  21. package/src/agents/persona-visuals.js +64 -0
  22. package/src/agents/shared-tools/dispatch-core.js +320 -0
  23. package/src/agents/shared-tools/file-edit.js +180 -0
  24. package/src/agents/shared-tools/file-read.js +100 -0
  25. package/src/agents/shared-tools/glob.js +168 -0
  26. package/src/agents/shared-tools/grep.js +228 -0
  27. package/src/agents/shared-tools/index.js +46 -0
  28. package/src/agents/shared-tools/path-guards.js +161 -0
  29. package/src/agents/shared-tools/shell.js +383 -0
  30. package/src/ai/aidenid.js +56 -7
  31. package/src/ai/client.js +45 -0
  32. package/src/ai/proxy.js +137 -0
  33. package/src/auth/gate.js +290 -16
  34. package/src/auth/http.js +450 -39
  35. package/src/auth/service.js +262 -47
  36. package/src/auth/session-store.js +475 -21
  37. package/src/cli.js +5 -0
  38. package/src/commands/audit.js +13 -8
  39. package/src/commands/auth.js +53 -9
  40. package/src/commands/omargate.js +10 -2
  41. package/src/commands/scan.js +10 -4
  42. package/src/commands/session.js +590 -0
  43. package/src/commands/spec.js +62 -0
  44. package/src/commands/watch.js +3 -2
  45. package/src/daemon/assignment-ledger.js +196 -0
  46. package/src/daemon/error-worker.js +599 -16
  47. package/src/daemon/fix-cycle.js +384 -0
  48. package/src/daemon/ingest-refresh.js +10 -9
  49. package/src/daemon/jira-lifecycle.js +135 -0
  50. package/src/daemon/pulse.js +327 -0
  51. package/src/daemon/scope-engine.js +1068 -0
  52. package/src/events/schema.js +190 -0
  53. package/src/interactive/index.js +18 -16
  54. package/src/legacy-cli.js +606 -37
  55. package/src/prompt/generator.js +19 -1
  56. package/src/review/ai-review.js +11 -1
  57. package/src/review/local-review.js +75 -19
  58. package/src/review/omargate-interactive.js +68 -0
  59. package/src/review/omargate-orchestrator.js +404 -0
  60. package/src/review/persona-prompts.js +296 -0
  61. package/src/review/scan-modes.js +48 -0
  62. package/src/scan/generator.js +1 -1
  63. package/src/session/agent-registry.js +352 -0
  64. package/src/session/daemon.js +801 -0
  65. package/src/session/paths.js +33 -0
  66. package/src/session/runtime-bridge.js +739 -0
  67. package/src/session/store.js +388 -0
  68. package/src/session/stream.js +325 -0
  69. package/src/spec/generator.js +100 -0
  70. package/src/telemetry/session-tracker.js +148 -32
  71. package/src/telemetry/sync.js +6 -2
  72. package/src/ui/command-hints.js +13 -0
@@ -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: { id: JULES_DEFINITION.id, persona: JULES_DEFINITION.persona, color: JULES_DEFINITION.color, avatar: JULES_DEFINITION.avatar },
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
- import { PERSONA_VISUALS } from "./config/definition.js";
2
-
3
- /**
4
- * Pulse — SentinelLayer Internal Daemon Monitor
5
- *
6
- * Monitors running agent health, routes errors to the right persona,
7
- * detects stuck/idle agents, and sends alerts on state changes.
8
- * NOT called Kairos — Pulse monitors the heartbeat of all agents.
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
- stream: "sl_event",
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
  }