@pellux/goodvibes-sdk 0.18.13 → 0.18.15

package/dist/_internal/platform/daemon/service-manager.js

@@ -0,0 +1,351 @@
+import { existsSync, mkdirSync, openSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { spawnSync, spawn } from 'node:child_process';
+import { ConfigManager } from '../config/manager.js';
+function detectPlatform(platform) {
+    switch (platform) {
+        case 'systemd':
+        case 'launchd':
+        case 'windows':
+        case 'manual':
+            return platform;
+        case 'auto':
+        default:
+            if (process.platform === 'darwin')
+                return 'launchd';
+            if (process.platform === 'win32')
+                return 'windows';
+            if (process.platform === 'linux')
+                return 'systemd';
+            return 'manual';
+    }
+}
+function buildDefaultDefinition(configManager, workingDirectory) {
+    const compiledBinary = resolve(workingDirectory, 'dist', process.platform === 'win32' ? 'goodvibes-windows.exe' : 'goodvibes');
+    const useCompiledBinary = existsSync(compiledBinary);
+    const serviceName = String(configManager.get('service.serviceName') ?? 'goodvibes').trim() || 'goodvibes';
+    return {
+        name: serviceName,
+        description: 'goodvibes omnichannel daemon host',
+        workingDirectory,
+        command: useCompiledBinary ? compiledBinary : process.execPath,
+        args: useCompiledBinary ? [] : ['run', resolve(workingDirectory, 'src', 'daemon', 'cli.ts')],
+        env: {
+            GOODVIBES_DAEMON_TOKEN: process.env.GOODVIBES_DAEMON_TOKEN ?? '',
+            GOODVIBES_HTTP_TOKEN: process.env.GOODVIBES_HTTP_TOKEN ?? '',
+            NODE_ENV: process.env.NODE_ENV ?? 'production',
+        },
+        restartOnFailure: Boolean(configManager.get('service.restartOnFailure')),
+    };
+}
+function resolveServiceName(configManager) {
+    return String(configManager.get('service.serviceName') ?? 'goodvibes').trim() || 'goodvibes';
+}
+function resolveLogPath(configManager, platform, workingDirectory) {
+    const configured = String(configManager.get('service.logPath') ?? '').trim();
+    if (configured)
+        return resolve(workingDirectory, configured);
+    return join(workingDirectory, '.goodvibes', 'goodvibes', 'service', `${platform}.log`);
+}
+function renderSystemdUnit(definition) {
+    const envLines = Object.entries(definition.env)
+        .filter(([, value]) => value.length > 0)
+        .map(([key, value]) => `Environment=${key}=${value.replace(/"/g, '\\"')}`);
+    return [
+        '[Unit]',
+        `Description=${definition.description}`,
+        'After=network-online.target',
+        '',
+        '[Service]',
+        'Type=simple',
+        `WorkingDirectory=${definition.workingDirectory}`,
+        `ExecStart=${[definition.command, ...definition.args].join(' ')}`,
+        ...envLines,
+        `Restart=${definition.restartOnFailure ? 'on-failure' : 'no'}`,
+        '',
+        '[Install]',
+        'WantedBy=default.target',
+        '',
+    ].join('\n');
+}
+function renderLaunchdPlist(definition) {
+    const envLines = Object.entries(definition.env)
+        .filter(([, value]) => value.length > 0)
+        .map(([key, value]) => `    <key>${key}</key>\n    <string>${value}</string>`)
+        .join('\n');
+    const args = [definition.command, ...definition.args]
+        .map((value) => `    <string>${value}</string>`)
+        .join('\n');
+    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>${definition.name}</string>`,
+        '  <key>ProgramArguments</key>',
+        '  <array>',
+        args,
+        '  </array>',
+        '  <key>WorkingDirectory</key>',
+        `  <string>${definition.workingDirectory}</string>`,
+        '  <key>RunAtLoad</key>',
+        '  <true/>',
+        '  <key>KeepAlive</key>',
+        definition.restartOnFailure ? '  <true/>' : '  <false/>',
+        ...(envLines ? ['  <key>EnvironmentVariables</key>', '  <dict>', envLines, '  </dict>'] : []),
+        '</dict>',
+        '</plist>',
+        '',
+    ].join('\n');
+}
+function renderWindowsCommand(definition) {
+    const taskName = definition.name;
+    const commandLine = [definition.command, ...definition.args].join(' ');
+    return `schtasks /Create /SC ONLOGON /TN "${taskName}" /TR "${commandLine}" /F`;
+}
+function definitionPath(platform, serviceName, paths) {
+    switch (platform) {
+        case 'systemd':
+            return join(paths.homeDirectory, '.config', 'systemd', 'user', `${serviceName}.service`);
+        case 'launchd':
+            return join(paths.homeDirectory, 'Library', 'LaunchAgents', `${serviceName}.plist`);
+        case 'windows':
+            return join(paths.workingDirectory, '.goodvibes', 'goodvibes', 'service', 'windows-task.txt');
+        case 'manual':
+        default:
+            return join(paths.workingDirectory, '.goodvibes', 'goodvibes', 'service', 'manual-service.txt');
+    }
+}
+function pidFilePath(platform, workingDirectory) {
+    switch (platform) {
+        case 'systemd':
+        case 'launchd':
+        case 'windows':
+        case 'manual':
+        default:
+            return join(workingDirectory, '.goodvibes', 'goodvibes', 'service', `${platform}.pid`);
+    }
+}
+function suggestedCommands(platform, path, serviceName) {
+    switch (platform) {
+        case 'systemd':
+            return [
+                `systemctl --user daemon-reload`,
+                `systemctl --user enable --now ${serviceName}.service`,
+                `systemctl --user status ${serviceName}.service`,
+            ];
+        case 'launchd':
+            return [
+                `launchctl unload ${path} || true`,
+                `launchctl load ${path}`,
+                `launchctl list | grep goodvibes`,
+            ];
+        case 'windows':
+            return [
+                `schtasks /Run /TN "${serviceName}"`,
+                `schtasks /Query /TN "${serviceName}"`,
+                `schtasks /Delete /TN "${serviceName}" /F`,
+            ];
+        case 'manual':
+        default:
+            return [
+                `bun run src/daemon/cli.ts`,
+            ];
+    }
+}
+export class PlatformServiceManager {
+    configManager;
+    workingDirectory;
+    homeDirectory;
+    definitionOverride;
+    actionRunner;
+    constructor(configManager, options) {
+        this.configManager = configManager;
+        this.workingDirectory = resolve(options.workingDirectory);
+        this.homeDirectory = resolve(options.homeDirectory);
+        this.definitionOverride = options.definitionOverride;
+        this.actionRunner = options.actionRunner;
+    }
+    getPaths() {
+        return {
+            workingDirectory: this.workingDirectory,
+            homeDirectory: this.homeDirectory,
+        };
+    }
+    status() {
+        const platform = detectPlatform(String(this.configManager.get('service.platform')));
+        const serviceName = resolveServiceName(this.configManager);
+        const path = definitionPath(platform, serviceName, this.getPaths());
+        const installed = existsSync(path);
+        const pidPath = pidFilePath(platform, this.workingDirectory);
+        const pid = existsSync(pidPath) ? this.readPid(pidPath) : undefined;
+        const running = pid !== undefined ? this.isPidRunning(pid) : false;
+        if (!running && existsSync(pidPath)) {
+            rmSync(pidPath, { force: true });
+        }
+        const definition = this.resolveDefinition();
+        return {
+            platform,
+            path,
+            installed,
+            autostart: Boolean(this.configManager.get('service.autostart')),
+            running,
+            ...(pid !== undefined && running ? { pid } : {}),
+            logPath: resolveLogPath(this.configManager, platform, this.workingDirectory),
+            commandPreview: installed ? path : [definition.command, ...definition.args].join(' '),
+            contents: installed ? readFileSync(path, 'utf-8') : undefined,
+            suggestedCommands: suggestedCommands(platform, path, serviceName),
+            lastAction: 'status',
+        };
+    }
+    install() {
+        const platform = detectPlatform(String(this.configManager.get('service.platform')));
+        const serviceName = resolveServiceName(this.configManager);
+        const definition = this.resolveDefinition();
+        const path = definitionPath(platform, serviceName, this.getPaths());
+        const contents = platform === 'systemd'
+            ? renderSystemdUnit(definition)
+            : platform === 'launchd'
+                ? renderLaunchdPlist(definition)
+                : platform === 'windows'
+                    ? renderWindowsCommand(definition)
+                    : [definition.command, ...definition.args].join(' ');
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, `${contents}\n`, 'utf-8');
+        return {
+            ...this.status(),
+            lastAction: 'install',
+        };
+    }
+    uninstall() {
+        const status = this.status();
+        if (existsSync(status.path)) {
+            rmSync(status.path, { force: true });
+        }
+        const pidPath = pidFilePath(status.platform, this.workingDirectory);
+        if (existsSync(pidPath)) {
+            rmSync(pidPath, { force: true });
+        }
+        return {
+            ...this.status(),
+            lastAction: 'uninstall',
+        };
+    }
+    start() {
+        const platform = detectPlatform(String(this.configManager.get('service.platform')));
+        if (platform === 'manual') {
+            return this.startManual(platform);
+        }
+        return this.runPlatformAction(platform, 'start');
+    }
+    stop() {
+        const platform = detectPlatform(String(this.configManager.get('service.platform')));
+        if (platform === 'manual') {
+            return this.stopManual(platform);
+        }
+        return this.runPlatformAction(platform, 'stop');
+    }
+    restart() {
+        const platform = detectPlatform(String(this.configManager.get('service.platform')));
+        if (platform === 'manual') {
+            this.stopManual(platform);
+            return this.startManual(platform, 'restart');
+        }
+        return this.runPlatformAction(platform, 'restart');
+    }
+    resolveDefinition() {
+        return this.definitionOverride ?? buildDefaultDefinition(this.configManager, this.workingDirectory);
+    }
+    startManual(platform, action = 'start') {
+        const current = this.status();
+        if (current.running) {
+            return {
+                ...current,
+                lastAction: action,
+            };
+        }
+        const definition = this.resolveDefinition();
+        const logPath = resolveLogPath(this.configManager, platform, this.workingDirectory);
+        const pidPath = pidFilePath(platform, this.workingDirectory);
+        mkdirSync(dirname(pidPath), { recursive: true });
+        mkdirSync(dirname(logPath), { recursive: true });
+        const stdoutFd = openSync(logPath, 'a');
+        const stderrFd = openSync(logPath, 'a');
+        const spawnOptions = {
+            cwd: definition.workingDirectory,
+            detached: true,
+            stdio: ['ignore', stdoutFd, stderrFd],
+            env: {
+                ...process.env,
+                ...definition.env,
+            },
+        };
+        const child = spawn(definition.command, [...definition.args], spawnOptions);
+        child.unref();
+        writeFileSync(pidPath, `${child.pid}\n`, 'utf-8');
+        return {
+            ...this.status(),
+            lastAction: action,
+        };
+    }
+    stopManual(platform) {
+        const pidPath = pidFilePath(platform, this.workingDirectory);
+        const pid = existsSync(pidPath) ? this.readPid(pidPath) : undefined;
+        if (pid !== undefined && this.isPidRunning(pid)) {
+            try {
+                process.kill(pid, 'SIGTERM');
+            }
+            catch {
+                // ignore stale processes
+            }
+        }
+        if (existsSync(pidPath)) {
+            rmSync(pidPath, { force: true });
+        }
+        return {
+            ...this.status(),
+            lastAction: 'stop',
+        };
+    }
+    runPlatformAction(platform, action) {
+        const serviceName = resolveServiceName(this.configManager);
+        const path = definitionPath(platform, serviceName, this.getPaths());
+        const command = platform === 'systemd'
+            ? ['systemctl', '--user', action === 'start' ? 'enable' : action, ...(action === 'start' ? ['--now'] : []), `${serviceName}.service`]
+            : platform === 'launchd'
+                ? ['launchctl', action === 'stop' ? 'unload' : 'load', path]
+                : platform === 'windows'
+                    ? ['schtasks', action === 'start' ? '/Run' : action === 'stop' ? '/End' : '/Run', '/TN', serviceName]
+                    : [];
+        if (command.length === 0) {
+            return {
+                ...this.status(),
+                lastAction: action,
+                actionError: `Unsupported platform action: ${platform}`,
+            };
+        }
+        const result = this.actionRunner
+            ? this.actionRunner(command[0], command.slice(1))
+            : spawnSync(command[0], command.slice(1), { stdio: 'pipe', encoding: 'utf-8' });
+        return {
+            ...this.status(),
+            lastAction: action,
+            ...((result.status ?? 1) === 0 ? {} : { actionError: ((result.stderr ?? '') || (result.stdout ?? '') || `command exited with ${result.status}`).trim() }),
+        };
+    }
+    readPid(path) {
+        const raw = readFileSync(path, 'utf-8').trim();
+        const pid = Number.parseInt(raw, 10);
+        return Number.isFinite(pid) && pid > 0 ? pid : undefined;
+    }
+    isPidRunning(pid) {
+        try {
+            process.kill(pid, 0);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}

package/dist/_internal/platform/daemon/surface-actions.d.ts

@@ -0,0 +1,54 @@
+import type { ConfigManager } from '../config/manager.js';
+import type { ServiceRegistry } from '../config/service-registry.js';
+import type { AgentRecord } from '../tools/agent/index.js';
+import type { AgentManager } from '../tools/agent/index.js';
+import type { SharedSessionBroker } from '../control-plane/index.js';
+import type { RouteBindingManager, ChannelPolicyManager } from '../channels/index.js';
+import type { GenericWebhookAdapterContext, SurfaceAdapterContext } from '../adapters/index.js';
+import type { AutomationManager } from '../automation/index.js';
+import type { ChannelPolicyDecision, ChannelIngressPolicyInput } from '../channels/index.js';
+interface DaemonSurfaceActionContext {
+    readonly serviceRegistry: ServiceRegistry;
+    readonly configManager: ConfigManager;
+    readonly routeBindings: RouteBindingManager;
+    readonly sessionBroker: SharedSessionBroker;
+    readonly channelPolicy: ChannelPolicyManager;
+    readonly automationManager: AutomationManager;
+    readonly agentManager: AgentManager;
+    readonly trySpawnAgent: (input: Parameters<AgentManager['spawn']>[0], logLabel?: string, sessionId?: string) => AgentRecord | Response;
+    readonly queueSurfaceReplyFromBinding: (binding: import('@pellux/goodvibes-sdk/platform/automation/routes').AutomationRouteBinding | undefined, input: {
+        readonly agentId: string;
+        readonly task: string;
+        readonly sessionId?: string;
+    }) => void;
+    readonly queueWebhookReply: (input: {
+        readonly agentId: string;
+        readonly task: string;
+        readonly sessionId?: string;
+        readonly routeId?: string;
+        readonly callbackUrl?: string;
+        readonly callbackCorrelationId?: string;
+        readonly callbackSignature?: import('./types.js').PendingSurfaceReply['callbackSignature'];
+    }) => void;
+    readonly surfaceDeliveryEnabled: (surface: 'slack' | 'discord' | 'ntfy' | 'webhook' | 'telegram' | 'google-chat' | 'signal' | 'whatsapp' | 'imessage' | 'msteams' | 'bluebubbles' | 'mattermost' | 'matrix') => boolean;
+    readonly signWebhookPayload: (body: string, secret: string) => string;
+    readonly handleApprovalAction: (approvalId: string, action: 'claim' | 'approve' | 'deny' | 'cancel', req: Request) => Promise<Response>;
+}
+export declare class DaemonSurfaceActionHelper {
+    private readonly context;
+    constructor(context: DaemonSurfaceActionContext);
+    buildSurfaceAdapterContext(): SurfaceAdapterContext;
+    buildGenericWebhookAdapterContext(): GenericWebhookAdapterContext;
+    authorizeSurfaceIngress(input: ChannelIngressPolicyInput): Promise<ChannelPolicyDecision>;
+    parseSurfaceControlCommand(text: string): {
+        readonly action: 'status' | 'cancel' | 'retry';
+        readonly id: string;
+    } | null;
+    performSurfaceControlCommand(command: {
+        readonly action: 'status' | 'cancel' | 'retry';
+        readonly id: string;
+    }): Promise<string>;
+    performInteractiveSurfaceAction(actionId: string, surface: 'slack' | 'discord', req: Request): Promise<string>;
+}
+export {};
+//# sourceMappingURL=surface-actions.d.ts.map

package/dist/_internal/platform/daemon/surface-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-actions.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/daemon/surface-actions.ts"],"names":[],"mappings":"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"}

package/dist/_internal/platform/daemon/surface-actions.js

@@ -0,0 +1,124 @@
+export class DaemonSurfaceActionHelper {
+    context;
+    constructor(context) {
+        this.context = context;
+    }
+    buildSurfaceAdapterContext() {
+        return {
+            serviceRegistry: this.context.serviceRegistry,
+            configManager: this.context.configManager,
+            routeBindings: this.context.routeBindings,
+            sessionBroker: this.context.sessionBroker,
+            authorizeSurfaceIngress: (input) => this.authorizeSurfaceIngress(input),
+            parseSurfaceControlCommand: (text) => this.parseSurfaceControlCommand(text),
+            performSurfaceControlCommand: (command) => this.performSurfaceControlCommand(command),
+            performInteractiveSurfaceAction: (actionId, surface, request) => this.performInteractiveSurfaceAction(actionId, surface, request),
+            trySpawnAgent: (input, logLabel, sessionId) => this.context.trySpawnAgent(input, logLabel, sessionId),
+            queueSurfaceReplyFromBinding: (binding, input) => this.context.queueSurfaceReplyFromBinding(binding, input),
+        };
+    }
+    buildGenericWebhookAdapterContext() {
+        return {
+            configManager: this.context.configManager,
+            routeBindings: this.context.routeBindings,
+            sessionBroker: this.context.sessionBroker,
+            authorizeSurfaceIngress: (input) => this.authorizeSurfaceIngress(input),
+            trySpawnAgent: (input, logLabel, sessionId) => this.context.trySpawnAgent(input, logLabel, sessionId),
+            surfaceDeliveryEnabled: (surface) => this.context.surfaceDeliveryEnabled(surface),
+            signWebhookPayload: (body, secret) => this.context.signWebhookPayload(body, secret),
+            queueWebhookReply: (input) => this.context.queueWebhookReply(input),
+        };
+    }
+    async authorizeSurfaceIngress(input) {
+        return this.context.channelPolicy.evaluateIngress(input);
+    }
+    parseSurfaceControlCommand(text) {
+        const trimmed = text.trim();
+        const match = trimmed.match(/^(status|cancel|retry)\s+([a-z0-9:_-]+)/i);
+        if (!match)
+            return null;
+        return {
+            action: match[1].toLowerCase(),
+            id: match[2],
+        };
+    }
+    async performSurfaceControlCommand(command) {
+        if (command.action === 'status') {
+            const run = this.context.automationManager.getRun(command.id);
+            if (run) {
+                return `Run ${run.id}: ${run.status}${run.agentId ? ` agent=${run.agentId}` : ''}`;
+            }
+            const agent = this.context.agentManager.getStatus(command.id);
+            if (agent) {
+                return `Agent ${agent.id}: ${agent.status}${agent.progress ? ` (${agent.progress})` : ''}`;
+            }
+            const session = this.context.sessionBroker.getSession(command.id);
+            if (session) {
+                return `Session ${session.id}: ${session.status} messages=${session.messageCount}${session.activeAgentId ? ` activeAgent=${session.activeAgentId}` : ''}`;
+            }
+            return `Unknown run, agent, or session: ${command.id}`;
+        }
+        if (command.action === 'cancel') {
+            const run = await this.context.automationManager.cancelRun(command.id, 'surface-cancelled');
+            if (run) {
+                return `Cancelled run ${run.id}`;
+            }
+            const agent = this.context.agentManager.getStatus(command.id);
+            if (agent) {
+                this.context.agentManager.cancel(command.id);
+                return `Cancelled agent ${command.id}`;
+            }
+            return `Unknown run or agent: ${command.id}`;
+        }
+        try {
+            const run = await this.context.automationManager.retryRun(command.id);
+            return `Retried run ${run.id}`;
+        }
+        catch {
+            const agent = this.context.agentManager.getStatus(command.id);
+            if (agent) {
+                const retried = this.context.trySpawnAgent({
+                    mode: 'spawn',
+                    task: agent.task,
+                    ...(agent.model ? { model: agent.model } : {}),
+                    ...(agent.provider ? { provider: agent.provider } : {}),
+                    ...(agent.tools.length > 0 ? { tools: agent.tools } : {}),
+                }, 'DaemonSurfaceActionHelper.performSurfaceControlCommand');
+                if (!(retried instanceof Response)) {
+                    return `Retried agent ${command.id} as ${retried.id}`;
+                }
+            }
+            return `Unable to retry ${command.id}`;
+        }
+    }
+    async performInteractiveSurfaceAction(actionId, surface, req) {
+        const approvalMatch = actionId.match(/^gv:approval:(approve|deny|claim):(.+)$/);
+        if (approvalMatch) {
+            const [, action, approvalId] = approvalMatch;
+            const result = await this.context.handleApprovalAction(approvalId, action, new Request(req.url, {
+                method: 'POST',
+                headers: req.headers,
+            }));
+            const body = await result.json().catch(() => ({}));
+            return result.ok
+                ? `Approval ${action}d: ${approvalId}`
+                : String(body.error ?? `Failed to ${action} approval ${approvalId}`);
+        }
+        const runMatch = actionId.match(/^gv:run:(cancel|retry):(.+)$/);
+        if (runMatch) {
+            const [, action, runId] = runMatch;
+            if (action === 'cancel') {
+                const run = await this.context.automationManager.cancelRun(runId, 'interactive-surface-cancel');
+                return run ? `Cancelled run ${runId}` : `Failed to cancel run ${runId}`;
+            }
+            try {
+                await this.context.automationManager.retryRun(runId);
+                return `Retried run ${runId}`;
+            }
+            catch (error) {
+                return error instanceof Error ? error.message : `Failed to retry run ${runId}`;
+            }
+        }
+        return `No handler for ${surface} action ${actionId}`;
+    }
+}

package/dist/_internal/platform/daemon/surface-delivery.d.ts

@@ -0,0 +1,57 @@
+import type { ConfigManager } from '../config/manager.js';
+import type { ServiceRegistry } from '../config/service-registry.js';
+import type { AgentManager } from '../tools/agent/index.js';
+import type { SharedSessionBroker } from '../control-plane/index.js';
+import type { ChannelPluginRegistry, ChannelReplyPipeline, RouteBindingManager } from '../channels/index.js';
+import type { SharedApprovalRecord } from '../control-plane/index.js';
+import type { PendingSurfaceReply } from './types.js';
+type DeliverySurface = 'slack' | 'discord' | 'ntfy' | 'webhook' | 'telegram' | 'google-chat' | 'signal' | 'whatsapp' | 'imessage' | 'msteams' | 'bluebubbles' | 'mattermost' | 'matrix';
+type RouteBinding = import('@pellux/goodvibes-sdk/platform/automation/routes').AutomationRouteBinding;
+interface SurfaceReplyInput {
+    readonly agentId: string;
+    readonly task: string;
+    readonly sessionId?: string;
+}
+interface WebhookReplyInput extends SurfaceReplyInput {
+    readonly routeId?: string;
+    readonly callbackUrl?: string;
+    readonly callbackCorrelationId?: string;
+    readonly callbackSignature?: PendingSurfaceReply['callbackSignature'];
+}
+interface DaemonSurfaceDeliveryContext {
+    readonly pendingSurfaceReplies: Map<string, PendingSurfaceReply>;
+    readonly channelReplyPipeline: ChannelReplyPipeline;
+    readonly configManager: ConfigManager;
+    readonly serviceRegistry: ServiceRegistry;
+    readonly agentManager: AgentManager;
+    readonly sessionBroker: SharedSessionBroker;
+    readonly routeBindings: RouteBindingManager;
+    readonly channelPlugins: ChannelPluginRegistry;
+    readonly authToken: () => string | null;
+    readonly surfaceDeliveryEnabled: (surface: DeliverySurface) => boolean;
+}
+export declare class DaemonSurfaceDeliveryHelper {
+    private readonly context;
+    constructor(context: DaemonSurfaceDeliveryContext);
+    queueSurfaceReplyFromBinding(binding: RouteBinding | undefined, input: SurfaceReplyInput): void;
+    queueWebhookReply(input: WebhookReplyInput): void;
+    pollPendingSurfaceReplies(syncFinishedAgentTask: (record: import('../tools/agent/index.js').AgentRecord) => void): Promise<void>;
+    deliverSurfaceProgress(pending: PendingSurfaceReply, progress: string): Promise<void>;
+    deliverSlackAgentReply(pending: PendingSurfaceReply, message: string): Promise<void>;
+    deliverDiscordAgentReply(pending: PendingSurfaceReply, message: string): Promise<void>;
+    deliverNtfyAgentReply(pending: PendingSurfaceReply, message: string): Promise<void>;
+    deliverWebhookAgentReply(pending: PendingSurfaceReply, message: string): Promise<void>;
+    notifyApprovalUpdate(approval: SharedApprovalRecord): Promise<void>;
+    controlPlaneWebUrl(input: {
+        readonly approvalId?: string;
+        readonly sessionId?: string;
+    }): string | undefined;
+    signWebhookPayload(body: string, secret: string): string;
+    private buildPendingSurfaceReply;
+    deliverSlackApprovalUpdate(approval: SharedApprovalRecord, binding: RouteBinding): Promise<void>;
+    deliverDiscordApprovalUpdate(approval: SharedApprovalRecord, binding: RouteBinding): Promise<void>;
+    deliverNtfyApprovalUpdate(approval: SharedApprovalRecord, binding: RouteBinding): Promise<void>;
+    deliverWebhookApprovalUpdate(approval: SharedApprovalRecord, binding: RouteBinding): Promise<void>;
+}
+export {};
+//# sourceMappingURL=surface-delivery.d.ts.map

package/dist/_internal/platform/daemon/surface-delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-delivery.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/daemon/surface-delivery.ts"],"names":[],"mappings":"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"}