2026-03-03 22:40:18 +01:00
/**
* @fileoverview Shared constants, utility functions, and SSE event type registry for all frontend modules.
*
* This is the first script loaded in index.html. Every other frontend module depends on the
2026-03-11 19:36:58 +01:00
* globals defined here: timing constants, Z-index layers, respawn
* preset definitions, the SSE_EVENTS registry, and shared utilities (escapeHtml,
2026-03-03 22:40:18 +01:00
* getEventCoords, scheduleBackground, urlBase64ToUint8Array).
*
* @globals {function} urlBase64ToUint8Array - VAPID key conversion for Web Push
* @globals {function} scheduleBackground - scheduler.postTask wrapper (background priority)
* @globals {function} getEventCoords - Unified mouse/touch coordinate extractor
* @globals {function} escapeHtml - XSS-safe HTML escaping
2026-06-09 00:50:34 +02:00
* @globals {object} SSE_EVENTS - Centralized SSE event type constants (120 event types; must match backend src/web/sse-events.ts)
2026-03-03 22:40:18 +01:00
* @globals {Array} BUILTIN_RESPAWN_PRESETS - Built-in respawn configuration presets
*
* @dependency None (first in load order)
2026-03-14 21:24:22 +01:00
* @loadorder 1 of 15 — constants.js → mobile-handlers.js → voice-input.js → notification-manager.js
* → keyboard-accessory.js → input-cjk.js → app.js → terminal-ui.js → respawn-ui.js
* → ralph-panel.js → settings-ui.js → panels-ui.js → session-ui.js → ralph-wizard.js
* → api-client.js → subagent-windows.js
2026-03-03 22:40:18 +01:00
*/
2026-03-01 04:57:37 +01:00
// Codeman — Shared constants and utility functions for frontend modules
2026-03-03 22:40:18 +01:00
// ═══════════════════════════════════════════════════════════════
2026-03-01 04:57:37 +01:00
// Web Push Utilities
2026-03-03 22:40:18 +01:00
// ═══════════════════════════════════════════════════════════════
2026-03-01 04:57:37 +01:00
/** Convert a base64-encoded VAPID key to Uint8Array for pushManager.subscribe() */
function urlBase64ToUint8Array ( base64String ) {
const padding = '=' . repeat (( 4 - base64String . length % 4 ) % 4 );
const base64 = ( base64String + padding ). replace ( /-/g , '+' ). replace ( /_/g , '/' );
const rawData = atob ( base64 );
const outputArray = new Uint8Array ( rawData . length );
for ( let i = 0 ; i < rawData . length ; ++ i ) {
outputArray [ i ] = rawData . charCodeAt ( i );
}
return outputArray ;
}
2026-03-03 22:40:18 +01:00
// ═══════════════════════════════════════════════════════════════
2026-03-01 04:57:37 +01:00
// Constants
2026-03-03 22:40:18 +01:00
// ═══════════════════════════════════════════════════════════════
2026-03-01 04:57:37 +01:00
// Default terminal scrollback (can be changed via settings)
2026-05-11 22:41:11 +02:00
const DEFAULT_SCROLLBACK = 50000 ;
2026-03-01 04:57:37 +01:00
// Timing constants
const STUCK_THRESHOLD_DEFAULT_MS = 600000 ; // 10 minutes - default for stuck detection
const GROUPING_TIMEOUT_MS = 5000 ; // 5 seconds - notification grouping window
const NOTIFICATION_LIST_CAP = 100 ; // Max notifications in list
const TITLE_FLASH_INTERVAL_MS = 1500 ; // Title flash rate
const BROWSER_NOTIF_RATE_LIMIT_MS = 3000 ; // Rate limit for browser notifications
2026-06-10 20:41:34 +02:00
const MOBILE_RESIZE_RETRY_MS = 30000 ; // Small-viewport resize re-send while a desktop sizing claim is hot
2026-03-01 04:57:37 +01:00
const AUTO_CLOSE_NOTIFICATION_MS = 8000 ; // Auto-close browser notifications
const THROTTLE_DELAY_MS = 100 ; // General UI throttle delay
2026-03-06 17:10:25 +01:00
const TERMINAL_CHUNK_SIZE = 32 * 1024 ; // 32KB chunks for terminal buffer loading
2026-05-12 09:18:14 +02:00
const TERMINAL_TAIL_SIZE = 1024 * 1024 ; // 1MB tail for initial load (more scrollback on tab switch)
2026-03-01 04:57:37 +01:00
const SYNC_WAIT_TIMEOUT_MS = 50 ; // Wait timeout for terminal sync
const STATS_POLLING_INTERVAL_MS = 2000 ; // System stats polling
2026-06-10 02:07:26 +02:00
const TUI_REDRAW_SETTLE_MS = 400 ; // Grace for a TUI to redraw after a real resize, before fetching its buffer
2026-03-01 04:57:37 +01:00
// Z-index base values for layered floating windows
const ZINDEX_SUBAGENT_BASE = 1000 ;
const ZINDEX_PLAN_SUBAGENT_BASE = 1100 ;
const ZINDEX_LOG_VIEWER_BASE = 2000 ;
const ZINDEX_IMAGE_POPUP_BASE = 3000 ;
// Subagent/floating window layout
const WINDOW_INITIAL_TOP_PX = 120 ;
const WINDOW_CASCADE_OFFSET_PX = 30 ;
const WINDOW_MIN_WIDTH_PX = 200 ;
const WINDOW_MIN_HEIGHT_PX = 200 ;
const WINDOW_DEFAULT_WIDTH_PX = 300 ;
2026-05-19 11:43:36 +02:00
// WebGL renderer auto-fallback thresholds.
// _installWebGLLongTaskGuard() observes longtask entries and disables WebGL
// after LONGTASK_COUNT stalls of >= LONGTASK_MS within WINDOW_MS. GRACE_MS
// suppresses the noisy initial-load stalls. STICKY_EXPIRY_MS is how long
// localStorage's webgl-disabled marker survives before we retry WebGL on a
// fresh load (driver/Chrome may have been updated).
const WEBGL_FALLBACK = {
LONGTASK_MS : 200 ,
LONGTASK_COUNT : 3 ,
WINDOW_MS : 30000 ,
GRACE_MS : 5000 ,
STICKY_EXPIRY_MS : 7 * 24 * 60 * 60 * 1000 ,
};
/**
* Pure rolling-window trip evaluator for the WebGL longtask guard.
* Mutates `recent` in place (prunes entries older than `now - WINDOW_MS`)
* and appends each new duration's startTime that meets the threshold.
* Returns true when the count inside the window reaches `LONGTASK_COUNT`.
*
* Exposed on `window` for unit testing — the production guard in app.js
* inlines this same logic in its PerformanceObserver callback. Splitting it
* out keeps the threshold math testable without a real PerformanceObserver.
*
* @param {number[]} recent - mutable array of startTimes inside the window
* @param {{startTime: number, duration: number}[]} entries - new longtask entries
* @param {number} now - performance.now() at evaluation time
* @param {typeof WEBGL_FALLBACK} [config=WEBGL_FALLBACK] - thresholds
* @returns {boolean} true if the rolling window has reached the trip count
*/
function evaluateWebGLLongTaskTrip ( recent , entries , now , config = WEBGL_FALLBACK ) {
for ( const entry of entries ) {
if ( entry . duration >= config . LONGTASK_MS ) recent . push ( entry . startTime );
}
while ( recent . length && now - recent [ 0 ] > config . WINDOW_MS ) recent . shift ();
return recent . length >= config . LONGTASK_COUNT ;
}
2026-07-01 20:41:38 -05:00
/**
* Pure decision for whether to skip the WebGL renderer at terminal init, and
* whether to clear the auto-fallback sticky marker. Keeps the interaction
* between device type, URL params, the sticky marker, and the user's settings
* toggle in one testable place (terminal-ui.js calls this).
*
* Precedence (desktop only — mobile always skips):
* 1. user toggle OFF -> skip (one-shot opt-out, sticky untouched)
* 2. ?nowebgl -> skip (one-shot opt-out, sticky untouched)
2026-07-12 12:42:36 +02:00
* 3. ?webgl=force -> enable + clear stale sticky marker
* 4. toggle ON / untouched -> respect the auto-fallback sticky marker
*
* A stored `true` is treated like the untouched default here: the checkbox
* ships checked on desktop, so any unrelated settings save stores `true` —
* letting it clear the marker would permanently defeat the GPU-stall
* auto-fallback safety net. The marker is only retired by ?webgl=force or by
* a real OFF->ON toggle flip, which saveAppSettings() detects at save time.
2026-07-01 20:41:38 -05:00
*
* @param {{deviceType?: string, noWebglParam?: boolean, forceParam?: boolean,
* stickyDisabled?: boolean, userPrefEnabled?: (boolean|undefined)}} [input]
* @returns {{skip: boolean, clearSticky: boolean}}
*/
function shouldSkipWebGL ( input = {}) {
if ( input . deviceType !== 'desktop' ) return { skip : true , clearSticky : false };
2026-07-12 12:42:36 +02:00
if ( input . userPrefEnabled === false ) return { skip : true , clearSticky : false };
2026-07-01 20:41:38 -05:00
if ( input . noWebglParam ) return { skip : true , clearSticky : false };
2026-07-12 12:42:36 +02:00
if ( input . forceParam ) return { skip : false , clearSticky : true };
2026-07-01 20:41:38 -05:00
return { skip : !! input . stickyDisabled , clearSticky : false };
}
2026-05-19 11:43:36 +02:00
// Expose for tests. `const` declarations at the top of a non-module script
// are global lexical bindings but not `window` properties, so explicit
// assignment is the test-visible API surface.
2026-06-14 15:49:12 -04:00
// Desktop tab-overflow policy: auto-wrap the session tabs to a second row when
// they overflow one row (and the user hasn't pinned the manual two-row layout).
function shouldAutoWrapTabs ( input ) {
if ( ! input || input . deviceType !== 'desktop' ) return false ;
if ( input . manualTwoRows ) return false ;
if (( input . tabCount || 0 ) < 2 ) return false ;
const scrollWidth = Number ( input . scrollWidth ) || 0 ;
const clientWidth = Number ( input . clientWidth ) || 0 ;
return scrollWidth > clientWidth + 1 ;
}
2026-06-19 21:32:42 -04:00
// COD-134 — Terminal WebSocket reconnect policy.
//
// Decide what to do after a terminal WebSocket closes, given the close `code`
// and `attempt` (0-based count of consecutive reconnects already made):
// - transient closes (code < 4004: 1000/1001/1005/1006/etc.) → 'reconnect'
// with exponential backoff (0 on the first attempt; the caller adds jitter),
// 250ms → 500 → 1000 → ... capped at 10s.
// - 4004 (session not found) / 4009 (session terminated) → 'give-up': the
// session is gone, retrying only wastes connections.
// - 4008 (too many connections) and any other code >= 4004 → 'retry-fallback':
// show the HTTP fallback but keep retrying on a bounded 5s timer so the
// transport returns to WS once the transient condition clears (un-stick).
// Pure: no DOM, no side effects.
function planWsReconnect ( code , attempt ) {
if ( code === 4004 || code === 4009 ) {
return { action : 'give-up' , delayMs : 0 };
}
if ( code >= 4004 ) {
return { action : 'retry-fallback' , delayMs : 5000 };
}
const delayMs = attempt <= 0 ? 0 : Math . min ( 250 * Math . pow ( 2 , attempt - 1 ), 10000 );
return { action : 'reconnect' , delayMs };
}
2026-05-19 11:43:36 +02:00
if ( typeof window !== 'undefined' ) {
window . WEBGL_FALLBACK = WEBGL_FALLBACK ;
window . evaluateWebGLLongTaskTrip = evaluateWebGLLongTaskTrip ;
2026-07-01 20:41:38 -05:00
window . shouldSkipWebGL = shouldSkipWebGL ;
2026-06-14 15:49:12 -04:00
window . CodemanTabOverflow = {
shouldAutoWrapTabs ,
};
2026-06-19 21:32:42 -04:00
window . CodemanWsReconnect = {
plan : planWsReconnect ,
};
2026-05-19 11:43:36 +02:00
}
2026-03-01 04:57:37 +01:00
// Scheduler API — prioritize terminal writes over background UI updates.
// scheduler.postTask('background') defers non-critical work (connection lines, panel renders)
// so the main thread stays free for terminal rendering at 60fps.
const _hasScheduler = typeof globalThis . scheduler ? . postTask === 'function' ;
function scheduleBackground ( fn ) {
if ( _hasScheduler ) { scheduler . postTask ( fn , { priority : 'background' }); }
else { requestAnimationFrame ( fn ); }
}
2026-03-11 19:36:58 +01:00
// DEC mode 2026 marker stripping — xterm.js 6.0 handles sync natively,
// but server-sent terminal buffers may still contain markers from Claude CLI.
2026-03-01 04:57:37 +01:00
const DEC_SYNC_STRIP_RE = /\x1b\[\?2026[hl]/g ;
// Built-in respawn configuration presets
const BUILTIN_RESPAWN_PRESETS = [
{
id : 'solo-work' ,
name : 'Solo' ,
description : 'Claude working alone — fast respawn cycles with context reset' ,
config : {
idleTimeoutMs : 3000 ,
updatePrompt : 'summarize your progress so far before the context reset.' ,
interStepDelayMs : 2000 ,
sendClear : true ,
sendInit : true ,
kickstartPrompt : 'continue working. Pick up where you left off based on the context above.' ,
autoAcceptPrompts : true ,
},
durationMinutes : 60 ,
builtIn : true ,
createdAt : 0 ,
},
{
id : 'subagent-workflow' ,
name : 'Subagents' ,
description : 'Lead session with Task tool subagents — longer idle tolerance' ,
config : {
idleTimeoutMs : 45000 ,
updatePrompt : 'check on your running subagents and summarize their results before the context reset. If all subagents have finished, note what was completed and what remains.' ,
interStepDelayMs : 3000 ,
sendClear : true ,
sendInit : true ,
kickstartPrompt : 'check on your running subagents and continue coordinating their work. If all subagents have finished, summarize their results and proceed with the next step.' ,
autoAcceptPrompts : true ,
},
durationMinutes : 240 ,
builtIn : true ,
createdAt : 0 ,
},
{
id : 'team-lead' ,
name : 'Team' ,
description : 'Leading an agent team via TeamCreate — tolerates long silences' ,
config : {
idleTimeoutMs : 90000 ,
updatePrompt : 'review the task list and teammate progress. Summarize the current state before the context reset.' ,
interStepDelayMs : 5000 ,
sendClear : true ,
sendInit : true ,
kickstartPrompt : 'check on your teammates by reviewing the task list and any messages in your inbox. Assign new tasks if teammates are idle, or continue coordinating the team effort.' ,
autoAcceptPrompts : true ,
},
durationMinutes : 480 ,
builtIn : true ,
createdAt : 0 ,
},
{
id : 'ralph-todo' ,
name : 'Ralph/Todo' ,
description : 'Ralph Loop task list — works through todos with progress tracking' ,
config : {
idleTimeoutMs : 8000 ,
updatePrompt : 'update CLAUDE.md with discoveries and progress notes, mark completed tasks in @fix_plan.md, write a brief summary so the next cycle can continue seamlessly.' ,
interStepDelayMs : 3000 ,
sendClear : true ,
sendInit : true ,
kickstartPrompt : 'read @fix_plan.md for task status, continue on the next uncompleted task. When ALL tasks are complete, output <promise>COMPLETE</promise>.' ,
autoAcceptPrompts : true ,
},
durationMinutes : 480 ,
builtIn : true ,
createdAt : 0 ,
},
{
id : 'overnight-autonomous' ,
name : 'Overnight' ,
description : 'Unattended overnight runs with full context reset between cycles' ,
config : {
idleTimeoutMs : 10000 ,
updatePrompt : 'summarize what you accomplished so far and write key progress notes to CLAUDE.md so the next cycle can pick up where you left off.' ,
interStepDelayMs : 3000 ,
sendClear : true ,
sendInit : true ,
kickstartPrompt : 'continue working on the task. Pick up where you left off based on the context above.' ,
autoAcceptPrompts : true ,
},
durationMinutes : 480 ,
builtIn : true ,
createdAt : 0 ,
},
];
2026-03-03 22:40:18 +01:00
// ═══════════════════════════════════════════════════════════════
// SSE Event Types
// ═══════════════════════════════════════════════════════════════
/** @type {Record<string, string>} Centralized SSE event type constants */
const SSE_EVENTS = {
// Core
INIT : 'init' ,
// Session lifecycle
SESSION_CREATED : 'session:created' ,
SESSION_UPDATED : 'session:updated' ,
SESSION_DELETED : 'session:deleted' ,
SESSION_TERMINAL : 'session:terminal' ,
SESSION_NEEDS_REFRESH : 'session:needsRefresh' ,
SESSION_CLEAR_TERMINAL : 'session:clearTerminal' ,
SESSION_COMPLETION : 'session:completion' ,
SESSION_ERROR : 'session:error' ,
SESSION_EXIT : 'session:exit' ,
SESSION_IDLE : 'session:idle' ,
SESSION_WORKING : 'session:working' ,
SESSION_AUTO_CLEAR : 'session:autoClear' ,
2026-06-09 00:50:34 +02:00
SESSION_AUTO_COMPACT : 'session:autoCompact' ,
2026-06-10 20:41:34 +02:00
SESSION_LIMIT_PAUSE_SCHEDULED : 'session:limitPauseScheduled' ,
SESSION_LIMIT_RESUME : 'session:limitResume' ,
SESSION_LIMIT_RESUME_CANCELLED : 'session:limitResumeCancelled' ,
2026-06-16 08:53:29 -04:00
SESSION_RESPAWN_BREAKER_TRIPPED : 'session:respawnBreakerTripped' ,
2026-03-03 22:40:18 +01:00
SESSION_CLI_INFO : 'session:cliInfo' ,
2026-06-09 00:50:34 +02:00
SESSION_MESSAGE : 'session:message' ,
SESSION_INTERACTIVE : 'session:interactive' ,
SESSION_RUNNING : 'session:running' ,
2026-06-14 05:00:28 +02:00
SESSION_STATUS_TELEMETRY : 'session:statusTelemetry' ,
2026-03-03 22:40:18 +01:00
// Scheduled runs
SCHEDULED_CREATED : 'scheduled:created' ,
SCHEDULED_UPDATED : 'scheduled:updated' ,
SCHEDULED_COMPLETED : 'scheduled:completed' ,
SCHEDULED_STOPPED : 'scheduled:stopped' ,
2026-06-09 00:50:34 +02:00
SCHEDULED_LOG : 'scheduled:log' ,
SCHEDULED_DELETED : 'scheduled:deleted' ,
2026-03-03 22:40:18 +01:00
2026-06-29 11:35:56 +05:30
// Cron jobs
CRON_JOBS_CHANGED : 'cron:jobsChanged' ,
CRON_JOB_DELETED : 'cron:jobDeleted' ,
CRON_RUN_CREATED : 'cron:runCreated' ,
CRON_RUN_UPDATED : 'cron:runUpdated' ,
2026-06-27 08:15:36 +05:30
2026-03-03 22:40:18 +01:00
// Respawn
RESPAWN_STARTED : 'respawn:started' ,
RESPAWN_STOPPED : 'respawn:stopped' ,
RESPAWN_STATE_CHANGED : 'respawn:stateChanged' ,
RESPAWN_CYCLE_STARTED : 'respawn:cycleStarted' ,
2026-06-09 00:50:34 +02:00
RESPAWN_CYCLE_COMPLETED : 'respawn:cycleCompleted' ,
2026-03-03 22:40:18 +01:00
RESPAWN_BLOCKED : 'respawn:blocked' ,
2026-06-09 00:50:34 +02:00
RESPAWN_STEP_SENT : 'respawn:stepSent' ,
RESPAWN_STEP_COMPLETED : 'respawn:stepCompleted' ,
2026-03-03 22:40:18 +01:00
RESPAWN_DETECTION_UPDATE : 'respawn:detectionUpdate' ,
2026-06-09 00:50:34 +02:00
RESPAWN_AUTO_ACCEPT_SENT : 'respawn:autoAcceptSent' ,
RESPAWN_AI_CHECK_STARTED : 'respawn:aiCheckStarted' ,
RESPAWN_AI_CHECK_COMPLETED : 'respawn:aiCheckCompleted' ,
RESPAWN_AI_CHECK_FAILED : 'respawn:aiCheckFailed' ,
RESPAWN_AI_CHECK_COOLDOWN : 'respawn:aiCheckCooldown' ,
RESPAWN_PLAN_CHECK_STARTED : 'respawn:planCheckStarted' ,
RESPAWN_PLAN_CHECK_COMPLETED : 'respawn:planCheckCompleted' ,
RESPAWN_PLAN_CHECK_FAILED : 'respawn:planCheckFailed' ,
2026-03-03 22:40:18 +01:00
RESPAWN_TIMER_STARTED : 'respawn:timerStarted' ,
RESPAWN_TIMER_CANCELLED : 'respawn:timerCancelled' ,
RESPAWN_TIMER_COMPLETED : 'respawn:timerCompleted' ,
RESPAWN_ACTION_LOG : 'respawn:actionLog' ,
2026-06-09 00:50:34 +02:00
RESPAWN_LOG : 'respawn:log' ,
RESPAWN_ERROR : 'respawn:error' ,
RESPAWN_CONFIG_UPDATED : 'respawn:configUpdated' ,
2026-03-03 22:40:18 +01:00
// Tasks
TASK_CREATED : 'task:created' ,
TASK_COMPLETED : 'task:completed' ,
TASK_FAILED : 'task:failed' ,
TASK_UPDATED : 'task:updated' ,
// Mux (tmux)
MUX_CREATED : 'mux:created' ,
MUX_KILLED : 'mux:killed' ,
MUX_DIED : 'mux:died' ,
MUX_STATS_UPDATED : 'mux:statsUpdated' ,
// Ralph
SESSION_RALPH_LOOP_UPDATE : 'session:ralphLoopUpdate' ,
SESSION_RALPH_TODO_UPDATE : 'session:ralphTodoUpdate' ,
SESSION_RALPH_COMPLETION_DETECTED : 'session:ralphCompletionDetected' ,
SESSION_RALPH_STATUS_UPDATE : 'session:ralphStatusUpdate' ,
SESSION_CIRCUIT_BREAKER_UPDATE : 'session:circuitBreakerUpdate' ,
SESSION_EXIT_GATE_MET : 'session:exitGateMet' ,
// Bash tools
SESSION_BASH_TOOL_START : 'session:bashToolStart' ,
SESSION_BASH_TOOL_END : 'session:bashToolEnd' ,
SESSION_BASH_TOOLS_UPDATE : 'session:bashToolsUpdate' ,
2026-06-09 00:50:34 +02:00
// Session: Plan
SESSION_PLAN_TASK_UPDATE : 'session:planTaskUpdate' ,
SESSION_PLAN_CHECKPOINT : 'session:planCheckpoint' ,
SESSION_PLAN_ROLLBACK : 'session:planRollback' ,
SESSION_PLAN_TASK_ADDED : 'session:planTaskAdded' ,
2026-03-03 22:40:18 +01:00
// Hooks (Claude Code hook events)
HOOK_IDLE_PROMPT : 'hook:idle_prompt' ,
HOOK_PERMISSION_PROMPT : 'hook:permission_prompt' ,
HOOK_ELICITATION_DIALOG : 'hook:elicitation_dialog' ,
HOOK_STOP : 'hook:stop' ,
HOOK_TEAMMATE_IDLE : 'hook:teammate_idle' ,
HOOK_TASK_COMPLETED : 'hook:task_completed' ,
// Subagents (Claude Code background agents)
SUBAGENT_DISCOVERED : 'subagent:discovered' ,
SUBAGENT_UPDATED : 'subagent:updated' ,
SUBAGENT_TOOL_CALL : 'subagent:tool_call' ,
SUBAGENT_PROGRESS : 'subagent:progress' ,
SUBAGENT_MESSAGE : 'subagent:message' ,
SUBAGENT_TOOL_RESULT : 'subagent:tool_result' ,
SUBAGENT_COMPLETED : 'subagent:completed' ,
2026-06-15 08:40:05 +02:00
// Workflow runs (ultracode / Workflow tool)
WORKFLOW_RUN_DISCOVERED : 'workflow:run_discovered' ,
WORKFLOW_RUN_UPDATED : 'workflow:run_updated' ,
WORKFLOW_RUN_REMOVED : 'workflow:run_removed' ,
2026-03-03 22:40:18 +01:00
// Images
IMAGE_DETECTED : 'image:detected' ,
2026-06-10 20:42:17 -04:00
ATTACHMENT_DETECTED : 'attachment:detected' ,
2026-03-03 22:40:18 +01:00
// Tunnel
TUNNEL_STARTED : 'tunnel:started' ,
TUNNEL_STOPPED : 'tunnel:stopped' ,
TUNNEL_PROGRESS : 'tunnel:progress' ,
TUNNEL_ERROR : 'tunnel:error' ,
TUNNEL_QR_ROTATED : 'tunnel:qrRotated' ,
TUNNEL_QR_REGENERATED : 'tunnel:qrRegenerated' ,
TUNNEL_QR_AUTH_USED : 'tunnel:qrAuthUsed' ,
// Plan orchestration
PLAN_SUBAGENT : 'plan:subagent' ,
PLAN_PROGRESS : 'plan:progress' ,
PLAN_STARTED : 'plan:started' ,
PLAN_CANCELLED : 'plan:cancelled' ,
PLAN_COMPLETED : 'plan:completed' ,
2026-03-21 07:20:18 +01:00
// Orchestrator Loop
ORCHESTRATOR_STATE_CHANGED : 'orchestrator:stateChanged' ,
2026-03-21 20:03:24 +01:00
ORCHESTRATOR_PLAN_PROGRESS : 'orchestrator:planProgress' ,
2026-03-21 07:20:18 +01:00
ORCHESTRATOR_PLAN_READY : 'orchestrator:planReady' ,
ORCHESTRATOR_PHASE_STARTED : 'orchestrator:phaseStarted' ,
ORCHESTRATOR_PHASE_COMPLETED : 'orchestrator:phaseCompleted' ,
ORCHESTRATOR_PHASE_FAILED : 'orchestrator:phaseFailed' ,
ORCHESTRATOR_VERIFICATION : 'orchestrator:verification' ,
ORCHESTRATOR_TASK_ASSIGNED : 'orchestrator:taskAssigned' ,
ORCHESTRATOR_TASK_COMPLETED : 'orchestrator:taskCompleted' ,
ORCHESTRATOR_TASK_FAILED : 'orchestrator:taskFailed' ,
ORCHESTRATOR_COMPLETED : 'orchestrator:completed' ,
ORCHESTRATOR_ERROR : 'orchestrator:error' ,
2026-04-03 09:45:19 +08:00
2026-06-09 00:50:34 +02:00
// Teams (agent teams)
TEAM_CREATED : 'team:created' ,
TEAM_UPDATED : 'team:updated' ,
TEAM_REMOVED : 'team:removed' ,
TEAM_TASK_UPDATED : 'team:taskUpdated' ,
// Transcript
TRANSCRIPT_COMPLETE : 'transcript:complete' ,
TRANSCRIPT_PLAN_MODE : 'transcript:plan_mode' ,
TRANSCRIPT_TOOL_START : 'transcript:tool_start' ,
TRANSCRIPT_TOOL_END : 'transcript:tool_end' ,
2026-04-12 10:07:15 -04:00
// Clipboard
CLIPBOARD_WRITE : 'clipboard:write' ,
2026-04-03 09:45:19 +08:00
// Cases
CASE_CREATED : 'case:created' ,
CASE_LINKED : 'case:linked' ,
CASE_DELETED : 'case:deleted' ,
CASE_ORDER_CHANGED : 'case:order-changed' ,
2026-07-19 17:38:01 +02:00
DOCKER_EXPORT_COMPLETE : 'docker:exportComplete' ,
DOCKER_EXPORT_FAILED : 'docker:exportFailed' ,
DOCKER_IMPORT_COMPLETE : 'docker:importComplete' ,
2026-07-20 01:28:53 +02:00
DOCKER_IMAGE_BUILD_STARTED : 'docker:imageBuildStarted' ,
DOCKER_IMAGE_BUILD_PROGRESS : 'docker:imageBuildProgress' ,
DOCKER_IMAGE_BUILD_COMPLETE : 'docker:imageBuildComplete' ,
DOCKER_IMAGE_BUILD_FAILED : 'docker:imageBuildFailed' ,
2026-03-03 22:40:18 +01:00
};
// ═══════════════════════════════════════════════════════════════
2026-03-01 04:57:37 +01:00
// Utility Functions
2026-03-03 22:40:18 +01:00
// ═══════════════════════════════════════════════════════════════
2026-03-01 04:57:37 +01:00
/**
* Get unified coordinates from mouse or touch event.
* @param {MouseEvent|TouchEvent} e - The event
* @returns {{ clientX: number, clientY: number }} Coordinates
*/
function getEventCoords ( e ) {
if ( e . touches && e . touches . length > 0 ) {
return { clientX : e . touches [ 0 ]. clientX , clientY : e . touches [ 0 ]. clientY };
}
if ( e . changedTouches && e . changedTouches . length > 0 ) {
return { clientX : e . changedTouches [ 0 ]. clientX , clientY : e . changedTouches [ 0 ]. clientY };
}
return { clientX : e . clientX , clientY : e . clientY };
}
// HTML escape utility (shared by NotificationManager, CodemanApp, and ralph-wizard.js)
const _htmlEscapeMap = { '&' : '&' , '<' : '<' , '>' : '>' , '"' : '"' , "'" : ''' };
const _htmlEscapePattern = /[&<>"']/g ;
function escapeHtml ( text ) {
if ( typeof text !== 'string' ) return '' ;
return text . replace ( _htmlEscapePattern , ( ch ) => _htmlEscapeMap [ ch ]);
}