@abdasis/agentdeck 2.44.2

package/dist/service/index.d.ts

@@ -0,0 +1,44 @@
+export interface ServiceStatus {
+    installed: boolean;
+    running: boolean;
+    enabled: boolean;
+    pid?: number;
+    configPath?: string;
+}
+export interface ServiceInstallOptions {
+    startNow?: boolean;
+    enableAtBoot?: boolean;
+}
+export interface ServiceResult {
+    success: boolean;
+    error?: string;
+    configPath?: string;
+}
+export interface ServiceManager {
+    /** Platform identifier */
+    platform: 'macos' | 'linux';
+    /** Service identifier */
+    serviceName: string;
+    /** Get current service status */
+    status(): Promise<ServiceStatus>;
+    /** Install service configuration */
+    install(options?: ServiceInstallOptions): Promise<ServiceResult>;
+    /** Uninstall service configuration */
+    uninstall(): Promise<ServiceResult>;
+    /** Start the service */
+    start(): Promise<ServiceResult>;
+    /** Stop the service */
+    stop(): Promise<ServiceResult>;
+    /** Restart the service */
+    restart(): Promise<ServiceResult>;
+    /** Get log file paths */
+    getLogPaths(): {
+        stdout: string;
+        stderr: string;
+    };
+}
+/**
+ * Create platform-appropriate service manager
+ */
+export declare function createServiceManager(): ServiceManager;
+//# sourceMappingURL=index.d.ts.map

package/dist/service/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/service/index.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC;IAE5B,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IAEpB,iCAAiC;IACjC,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAEjC,oCAAoC;IACpC,OAAO,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEjE,sCAAsC;IACtC,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAEpC,wBAAwB;IACxB,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAEhC,uBAAuB;IACvB,IAAI,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAE/B,0BAA0B;IAC1B,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAElC,yBAAyB;IACzB,WAAW,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACnD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAWrD"}

package/dist/service/index.js

@@ -0,0 +1,18 @@
+import { platform } from 'os';
+import { LaunchdService } from './launchd.js';
+import { SystemdService } from './systemd.js';
+/**
+ * Create platform-appropriate service manager
+ */
+export function createServiceManager() {
+    const os = platform();
+    switch (os) {
+        case 'darwin':
+            return new LaunchdService();
+        case 'linux':
+            return new SystemdService();
+        default:
+            throw new Error(`Unsupported platform: ${os}. Only macOS and Linux are supported.`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/service/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/service/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAkD9C;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC;IAEtB,QAAQ,EAAE,EAAE,CAAC;QACX,KAAK,QAAQ;YACX,OAAO,IAAI,cAAc,EAAE,CAAC;QAC9B,KAAK,OAAO;YACV,OAAO,IAAI,cAAc,EAAE,CAAC;QAC9B;YACE,MAAM,IAAI,KAAK,CAAC,yBAAyB,EAAE,uCAAuC,CAAC,CAAC;IACxF,CAAC;AACH,CAAC"}

package/dist/service/launchd.d.ts

@@ -0,0 +1,18 @@
+import type { ServiceManager, ServiceStatus, ServiceInstallOptions, ServiceResult } from './index.js';
+export declare class LaunchdService implements ServiceManager {
+    platform: "macos";
+    serviceName: string;
+    private get plistPath();
+    status(): Promise<ServiceStatus>;
+    install(options?: ServiceInstallOptions): Promise<ServiceResult>;
+    uninstall(): Promise<ServiceResult>;
+    start(): Promise<ServiceResult>;
+    stop(): Promise<ServiceResult>;
+    restart(): Promise<ServiceResult>;
+    getLogPaths(): {
+        stdout: string;
+        stderr: string;
+    };
+    private generatePlist;
+}
+//# sourceMappingURL=launchd.d.ts.map

package/dist/service/launchd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launchd.d.ts","sourceRoot":"","sources":["../../src/service/launchd.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,qBAAqB,EACrB,aAAa,EACd,MAAM,YAAY,CAAC;AAQpB,qBAAa,cAAe,YAAW,cAAc;IACnD,QAAQ,EAAG,OAAO,CAAU;IAC5B,WAAW,SAAiB;IAE5B,OAAO,KAAK,SAAS,GAEpB;IAEK,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC;IA2BhC,OAAO,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,aAAa,CAAC;IA6DpE,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC;IAoBnC,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC;IAS/B,IAAI,IAAI,OAAO,CAAC,aAAa,CAAC;IAS9B,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC;IAMvC,WAAW,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAQjD,OAAO,CAAC,aAAa;CA0EtB"}

package/dist/service/launchd.js

@@ -0,0 +1,208 @@
+import { existsSync, writeFileSync, unlinkSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import { getAgentPaths, getTestableHomedir } from '../lib/paths.js';
+import { checkTmux } from '../lib/prerequisites.js';
+const execAsync = promisify(exec);
+const SERVICE_LABEL = 'com.agentdeck.agent';
+export class LaunchdService {
+    platform = 'macos';
+    serviceName = SERVICE_LABEL;
+    get plistPath() {
+        return join(getTestableHomedir(), 'Library', 'LaunchAgents', `${SERVICE_LABEL}.plist`);
+    }
+    async status() {
+        const installed = existsSync(this.plistPath);
+        let running = false;
+        let pid;
+        if (installed) {
+            try {
+                const { stdout } = await execAsync(`launchctl list | grep ${SERVICE_LABEL}`);
+                const parts = stdout.trim().split(/\s+/);
+                if (parts[0] && parts[0] !== '-') {
+                    pid = parseInt(parts[0], 10);
+                    running = !isNaN(pid);
+                }
+            }
+            catch {
+                // Service not running or not found in list
+            }
+        }
+        return {
+            installed,
+            running,
+            enabled: installed,
+            pid,
+            configPath: installed ? this.plistPath : undefined,
+        };
+    }
+    async install(options = {}) {
+        const paths = getAgentPaths();
+        // Verify tmux is installed
+        const tmuxCheck = checkTmux();
+        if (tmuxCheck.status === 'error') {
+            return {
+                success: false,
+                error: 'tmux is not installed. Please install it first: brew install tmux',
+            };
+        }
+        const home = getTestableHomedir();
+        // Create LaunchAgents directory if needed
+        const launchAgentsDir = join(home, 'Library', 'LaunchAgents');
+        if (!existsSync(launchAgentsDir)) {
+            mkdirSync(launchAgentsDir, { recursive: true });
+        }
+        // Create log directory
+        const logDir = join(home, 'Library', 'Logs', 'agentdeck-agent');
+        if (!existsSync(logDir)) {
+            mkdirSync(logDir, { recursive: true });
+        }
+        const logs = this.getLogPaths();
+        // Determine entry point
+        const entryPoint = paths.isDev
+            ? join(paths.agentRoot, 'src', 'index.ts')
+            : join(paths.agentRoot, 'dist', 'index.js');
+        // Generate plist content
+        const plistContent = this.generatePlist({
+            label: SERVICE_LABEL,
+            nodePath: paths.nodePath,
+            agentScript: entryPoint,
+            workingDirectory: paths.agentRoot,
+            stdoutPath: logs.stdout,
+            stderrPath: logs.stderr,
+            runAtLoad: options.enableAtBoot ?? true,
+            keepAlive: true,
+            isDev: paths.isDev,
+            configPath: paths.configPath,
+            dataDir: paths.dataDir,
+        });
+        writeFileSync(this.plistPath, plistContent, 'utf-8');
+        // Load the service if requested
+        if (options.startNow) {
+            const startResult = await this.start();
+            if (!startResult.success) {
+                return { ...startResult, configPath: this.plistPath };
+            }
+        }
+        return { success: true, configPath: this.plistPath };
+    }
+    async uninstall() {
+        const status = await this.status();
+        // Stop service first if running
+        if (status.running) {
+            await this.stop();
+        }
+        // Remove plist file
+        if (existsSync(this.plistPath)) {
+            try {
+                unlinkSync(this.plistPath);
+            }
+            catch (err) {
+                return { success: false, error: `Failed to remove plist: ${err.message}` };
+            }
+        }
+        return { success: true };
+    }
+    async start() {
+        try {
+            await execAsync(`launchctl load "${this.plistPath}"`);
+            return { success: true };
+        }
+        catch (err) {
+            return { success: false, error: err.message };
+        }
+    }
+    async stop() {
+        try {
+            await execAsync(`launchctl unload "${this.plistPath}"`);
+            return { success: true };
+        }
+        catch (err) {
+            return { success: false, error: err.message };
+        }
+    }
+    async restart() {
+        await this.stop();
+        await new Promise((resolve) => setTimeout(resolve, 500));
+        return this.start();
+    }
+    getLogPaths() {
+        const logDir = join(getTestableHomedir(), 'Library', 'Logs', 'agentdeck-agent');
+        return {
+            stdout: join(logDir, 'agent.log'),
+            stderr: join(logDir, 'agent.error.log'),
+        };
+    }
+    generatePlist(options) {
+        let programArgs;
+        if (options.isDev) {
+            programArgs = `        <string>/usr/bin/env</string>
+        <string>npx</string>
+        <string>tsx</string>
+        <string>${escapeXml(options.agentScript)}</string>`;
+        }
+        else {
+            programArgs = `        <string>${escapeXml(options.nodePath)}</string>
+        <string>${escapeXml(options.agentScript)}</string>`;
+        }
+        return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>${escapeXml(options.label)}</string>
+
+    <key>ProgramArguments</key>
+    <array>
+${programArgs}
+    </array>
+
+    <key>WorkingDirectory</key>
+    <string>${escapeXml(options.workingDirectory)}</string>
+
+    <key>RunAtLoad</key>
+    <${options.runAtLoad}/>
+
+    <key>KeepAlive</key>
+    <dict>
+        <key>SuccessfulExit</key>
+        <false/>
+        <key>Crashed</key>
+        <true/>
+    </dict>
+
+    <key>StandardOutPath</key>
+    <string>${escapeXml(options.stdoutPath)}</string>
+
+    <key>StandardErrorPath</key>
+    <string>${escapeXml(options.stderrPath)}</string>
+
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>AGENTDECK_CONFIG</key>
+        <string>${escapeXml(options.configPath)}</string>
+        <key>AGENTDECK_DATA</key>
+        <string>${escapeXml(options.dataDir)}</string>
+        <key>PATH</key>
+        <string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin</string>
+    </dict>
+
+    <key>ProcessType</key>
+    <string>Interactive</string>
+
+    <key>ThrottleInterval</key>
+    <integer>5</integer>
+</dict>
+</plist>`;
+    }
+}
+function escapeXml(str) {
+    return str
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+}
+//# sourceMappingURL=launchd.js.map

package/dist/service/launchd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launchd.js","sourceRoot":"","sources":["../../src/service/launchd.ts"],"names":[],"mappings":"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"}

package/dist/service/systemd.d.ts

@@ -0,0 +1,18 @@
+import type { ServiceManager, ServiceStatus, ServiceInstallOptions, ServiceResult } from './index.js';
+export declare class SystemdService implements ServiceManager {
+    platform: "linux";
+    serviceName: string;
+    private get unitPath();
+    status(): Promise<ServiceStatus>;
+    install(options?: ServiceInstallOptions): Promise<ServiceResult>;
+    uninstall(): Promise<ServiceResult>;
+    start(): Promise<ServiceResult>;
+    stop(): Promise<ServiceResult>;
+    restart(): Promise<ServiceResult>;
+    getLogPaths(): {
+        stdout: string;
+        stderr: string;
+    };
+    private generateUnit;
+}
+//# sourceMappingURL=systemd.d.ts.map

package/dist/service/systemd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemd.d.ts","sourceRoot":"","sources":["../../src/service/systemd.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,qBAAqB,EACrB,aAAa,EACd,MAAM,YAAY,CAAC;AAQpB,qBAAa,cAAe,YAAW,cAAc;IACnD,QAAQ,EAAG,OAAO,CAAU;IAC5B,WAAW,SAAgB;IAE3B,OAAO,KAAK,QAAQ,GAEnB;IAEK,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC;IAyChC,OAAO,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,aAAa,CAAC;IAuEpE,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC;IA4BnC,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC;IAS/B,IAAI,IAAI,OAAO,CAAC,aAAa,CAAC;IAS9B,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC;IASvC,WAAW,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAOjD,OAAO,CAAC,YAAY;CAqCrB"}

package/dist/service/systemd.js

@@ -0,0 +1,196 @@
+import { existsSync, writeFileSync, unlinkSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import { getAgentPaths, getTestableHomedir } from '../lib/paths.js';
+import { checkTmux } from '../lib/prerequisites.js';
+const execAsync = promisify(exec);
+const SERVICE_NAME = 'agentdeck-agent';
+export class SystemdService {
+    platform = 'linux';
+    serviceName = SERVICE_NAME;
+    get unitPath() {
+        return join(getTestableHomedir(), '.config', 'systemd', 'user', `${SERVICE_NAME}.service`);
+    }
+    async status() {
+        const installed = existsSync(this.unitPath);
+        let running = false;
+        let enabled = false;
+        let pid;
+        if (installed) {
+            try {
+                const { stdout: statusOutput } = await execAsync(`systemctl --user is-active ${SERVICE_NAME} 2>/dev/null || true`);
+                running = statusOutput.trim() === 'active';
+                const { stdout: enabledOutput } = await execAsync(`systemctl --user is-enabled ${SERVICE_NAME} 2>/dev/null || true`);
+                enabled = enabledOutput.trim() === 'enabled';
+                if (running) {
+                    const { stdout: pidOutput } = await execAsync(`systemctl --user show ${SERVICE_NAME} --property=MainPID --value 2>/dev/null || true`);
+                    const parsedPid = parseInt(pidOutput.trim(), 10);
+                    if (!isNaN(parsedPid) && parsedPid > 0) {
+                        pid = parsedPid;
+                    }
+                }
+            }
+            catch {
+                // Service not available
+            }
+        }
+        return {
+            installed,
+            running,
+            enabled,
+            pid,
+            configPath: installed ? this.unitPath : undefined,
+        };
+    }
+    async install(options = {}) {
+        const paths = getAgentPaths();
+        // Verify tmux is installed
+        const tmuxCheck = checkTmux();
+        if (tmuxCheck.status === 'error') {
+            return {
+                success: false,
+                error: 'tmux is not installed. Please install it first: sudo apt install tmux',
+            };
+        }
+        const home = getTestableHomedir();
+        // Create systemd user directory
+        const systemdUserDir = join(home, '.config', 'systemd', 'user');
+        if (!existsSync(systemdUserDir)) {
+            mkdirSync(systemdUserDir, { recursive: true });
+        }
+        // Create log directory
+        const logDir = join(home, '.local', 'log', 'agentdeck-agent');
+        if (!existsSync(logDir)) {
+            mkdirSync(logDir, { recursive: true });
+        }
+        // Determine entry point
+        const entryPoint = paths.isDev
+            ? join(paths.agentRoot, 'src', 'index.ts')
+            : join(paths.agentRoot, 'dist', 'index.js');
+        // Generate unit content
+        const unitContent = this.generateUnit({
+            description: 'AgentDeck Agent',
+            nodePath: paths.nodePath,
+            agentScript: entryPoint,
+            workingDirectory: paths.agentRoot,
+            isDev: paths.isDev,
+            configPath: paths.configPath,
+            dataDir: paths.dataDir,
+        });
+        writeFileSync(this.unitPath, unitContent, 'utf-8');
+        // Reload systemd
+        try {
+            await execAsync('systemctl --user daemon-reload');
+        }
+        catch (err) {
+            return { success: false, error: `Failed to reload systemd: ${err.message}` };
+        }
+        // Enable at boot if requested
+        if (options.enableAtBoot ?? true) {
+            try {
+                await execAsync(`systemctl --user enable ${SERVICE_NAME}`);
+            }
+            catch (err) {
+                return { success: false, error: `Failed to enable service: ${err.message}` };
+            }
+        }
+        // Start now if requested
+        if (options.startNow) {
+            const startResult = await this.start();
+            if (!startResult.success) {
+                return { ...startResult, configPath: this.unitPath };
+            }
+        }
+        return { success: true, configPath: this.unitPath };
+    }
+    async uninstall() {
+        const status = await this.status();
+        // Stop and disable first
+        if (status.running) {
+            await this.stop();
+        }
+        if (status.enabled) {
+            try {
+                await execAsync(`systemctl --user disable ${SERVICE_NAME}`);
+            }
+            catch {
+                // Ignore disable errors
+            }
+        }
+        // Remove unit file
+        if (existsSync(this.unitPath)) {
+            try {
+                unlinkSync(this.unitPath);
+                await execAsync('systemctl --user daemon-reload');
+            }
+            catch (err) {
+                return { success: false, error: `Failed to remove unit file: ${err.message}` };
+            }
+        }
+        return { success: true };
+    }
+    async start() {
+        try {
+            await execAsync(`systemctl --user start ${SERVICE_NAME}`);
+            return { success: true };
+        }
+        catch (err) {
+            return { success: false, error: err.message };
+        }
+    }
+    async stop() {
+        try {
+            await execAsync(`systemctl --user stop ${SERVICE_NAME}`);
+            return { success: true };
+        }
+        catch (err) {
+            return { success: false, error: err.message };
+        }
+    }
+    async restart() {
+        try {
+            await execAsync(`systemctl --user restart ${SERVICE_NAME}`);
+            return { success: true };
+        }
+        catch (err) {
+            return { success: false, error: err.message };
+        }
+    }
+    getLogPaths() {
+        return {
+            stdout: `journalctl --user -u ${SERVICE_NAME} -o cat`,
+            stderr: `journalctl --user -u ${SERVICE_NAME} -p err -o cat`,
+        };
+    }
+    generateUnit(options) {
+        let execStart;
+        if (options.isDev) {
+            execStart = `/usr/bin/env npx tsx ${options.agentScript}`;
+        }
+        else {
+            execStart = `${options.nodePath} ${options.agentScript}`;
+        }
+        return `[Unit]
+Description=${options.description}
+After=network.target
+
+[Service]
+Type=simple
+ExecStart=${execStart}
+WorkingDirectory=${options.workingDirectory}
+Restart=on-failure
+RestartSec=5
+StandardOutput=journal
+StandardError=journal
+
+Environment="AGENTDECK_CONFIG=${options.configPath}"
+Environment="AGENTDECK_DATA=${options.dataDir}"
+Environment="PATH=/usr/local/bin:/usr/bin:/bin"
+
+[Install]
+WantedBy=default.target
+`;
+    }
+}
+//# sourceMappingURL=systemd.js.map

package/dist/service/systemd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemd.js","sourceRoot":"","sources":["../../src/service/systemd.ts"],"names":[],"mappings":"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"}

package/hooks/notify-agentdeck.sh

@@ -0,0 +1,53 @@
+#!/bin/bash
+# AgentDeck Hook Script for Claude Code + Codex
+# VERSION: 2.32.0
+# Ultra simple: hook called = needs_attention
+set -euo pipefail
+
+AGENT_URL="http://${AGENTDECK_HOST:-localhost}:${AGENTDECK_PORT:-4678}/api/hooks/status"
+
+# Read stdin only if it's not a TTY (Claude/Codex send JSON via stdin)
+PAYLOAD=""
+if [ $# -gt 0 ] && [ -n "${1:-}" ]; then
+  PAYLOAD="$1"
+elif [ ! -t 0 ]; then
+  PAYLOAD="$(cat)"
+fi
+
+# Prefer explicit session env vars (set by agentdeck when starting session)
+SESSION_ID="${AGENTDECK_SESSION:-${CODEX_TMUX_SESSION:-${CLAUDE_TMUX_SESSION:-}}}"
+if [ -z "$SESSION_ID" ] && [ -n "${TMUX:-}" ]; then
+  SESSION_ID="$(tmux display-message -p '#S' 2>/dev/null || true)"
+fi
+[ -z "$SESSION_ID" ] && exit 0
+
+EVENT_TYPE="hook"
+ATTENTION_REASON=""
+TRANSCRIPT_PATH=""
+if [ -n "$PAYLOAD" ]; then
+  EVENT_TYPE="$(
+    echo "$PAYLOAD" | jq -r '(.event // .eventType // .type // .notification_type // "hook")' 2>/dev/null || echo "hook"
+  )"
+  ATTENTION_REASON="$(
+    echo "$PAYLOAD" | jq -r '(.notification_type // .attention_reason // .attentionReason // .reason // empty)' 2>/dev/null || echo ""
+  )"
+  TRANSCRIPT_PATH="$(
+    echo "$PAYLOAD" | jq -r '(.transcript_path // .transcriptPath // empty)' 2>/dev/null || echo ""
+  )"
+fi
+
+curl -s -X POST "$AGENT_URL" \
+  -H "Content-Type: application/json" \
+  -d "$(
+    jq -n \
+      --arg sid "$SESSION_ID" \
+      --arg event "$EVENT_TYPE" \
+      --arg reason "$ATTENTION_REASON" \
+      --arg transcript "$TRANSCRIPT_PATH" \
+      '{sessionId:$sid,status:"needs_attention",source:"hook",timestamp:(now*1000|floor),eventType:$event}
+       | if $reason != "" then .attentionReason=$reason else . end
+       | if $transcript != "" then .transcriptPath=$transcript else . end'
+  )" \
+  --connect-timeout 2 --max-time 5 > /dev/null 2>&1 || true
+
+echo "[agentdeck-hook] $SESSION_ID needs attention" >&2