@shepai/cli 1.180.0 → 1.181.0-pr512.ba01d33

package/dist/src/presentation/web/app/actions/messaging.js

@@ -0,0 +1,55 @@
+'use server';
+import { revalidatePath } from 'next/cache';
+import { resolve } from '../../lib/server-container.js';
+import { updateSettings as updateSettingsSingleton } from '../../../../../packages/core/src/infrastructure/services/settings.service.js';
+async function refreshSettingsCache() {
+    // Keep the in-memory settings singleton in sync with the DB so that the
+    // running daemon (started from the same process) sees the latest config.
+    try {
+        const loadUseCase = resolve('LoadSettingsUseCase');
+        const fresh = await loadUseCase.execute();
+        updateSettingsSingleton(fresh);
+    }
+    catch {
+        // Settings service may not be initialized yet in some contexts — ignore.
+    }
+}
+export async function beginMessagingPairingAction(input) {
+    try {
+        const useCase = resolve('BeginMessagingPairingUseCase');
+        const session = await useCase.execute(input);
+        await refreshSettingsCache();
+        revalidatePath('/settings');
+        return { success: true, session };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Failed to begin pairing';
+        return { success: false, error: message };
+    }
+}
+export async function confirmMessagingPairingAction(input) {
+    try {
+        const useCase = resolve('ConfirmMessagingPairingUseCase');
+        await useCase.execute(input);
+        await refreshSettingsCache();
+        revalidatePath('/settings');
+        return { success: true };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Failed to confirm pairing';
+        return { success: false, error: message };
+    }
+}
+export async function disconnectMessagingAction(input) {
+    try {
+        const useCase = resolve('DisconnectMessagingUseCase');
+        await useCase.execute(input);
+        await refreshSettingsCache();
+        revalidatePath('/settings');
+        return { success: true };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Failed to disconnect messaging';
+        return { success: false, error: message };
+    }
+}

package/dist/src/presentation/web/components/features/settings/messaging-settings-section.d.ts

@@ -0,0 +1,6 @@
+import type { MessagingConfig } from '../../../../../../packages/core/src/domain/generated/output.js';
+export interface MessagingSettingsSectionProps {
+    messaging?: MessagingConfig;
+}
+export declare function MessagingSettingsSection({ messaging }: MessagingSettingsSectionProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=messaging-settings-section.d.ts.map

package/dist/src/presentation/web/components/features/settings/messaging-settings-section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging-settings-section.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/settings/messaging-settings-section.tsx"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAG5E,MAAM,WAAW,6BAA6B;IAC5C,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AA+BD,wBAAgB,wBAAwB,CAAC,EAAE,SAAS,EAAE,EAAE,6BAA6B,2CA8VpF"}

package/dist/src/presentation/web/components/features/settings/messaging-settings-section.js

@@ -0,0 +1,206 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useState, useTransition, useRef, useEffect, useCallback } from 'react';
+import { MessageCircle, Check, Copy, Link2, ShieldCheck, Unplug } from 'lucide-react';
+import { toast } from 'sonner';
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '../../ui/card.js';
+import { Label } from '../../ui/label.js';
+import { Switch } from '../../ui/switch.js';
+import { Separator } from '../../ui/separator.js';
+import { Input } from '../../ui/input.js';
+import { Button } from '../../ui/button.js';
+import { Badge } from '../../ui/badge.js';
+import { Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, } from '../../ui/dialog.js';
+import { updateSettingsAction } from '../../../app/actions/update-settings.js';
+import { beginMessagingPairingAction, confirmMessagingPairingAction, disconnectMessagingAction, } from '../../../app/actions/messaging.js';
+import { MessagingPlatform } from '../../../../../../packages/core/src/domain/generated/output.js';
+const DEFAULT_CONFIG = {
+    enabled: false,
+    debounceMs: 5000,
+    chatBufferMs: 3000,
+};
+function platformLabel(platform) {
+    return platform === MessagingPlatform.Telegram ? 'Telegram' : 'WhatsApp';
+}
+function isValidUrl(value) {
+    if (!value.trim())
+        return false;
+    try {
+        new URL(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function MessagingSettingsSection({ messaging }) {
+    const config = messaging ?? DEFAULT_CONFIG;
+    const [enabled, setEnabled] = useState(config.enabled);
+    const [gatewayUrl, setGatewayUrl] = useState(config.gatewayUrl ?? '');
+    const [telegram, setTelegram] = useState(config.telegram);
+    const [whatsapp, setWhatsapp] = useState(config.whatsapp);
+    const [isPending, startTransition] = useTransition();
+    const [showSaved, setShowSaved] = useState(false);
+    const prevPendingRef = useRef(false);
+    const [pairing, setPairing] = useState(null);
+    const [pairingLoading, setPairingLoading] = useState(false);
+    const [chatIdInput, setChatIdInput] = useState('');
+    useEffect(() => {
+        if (prevPendingRef.current && !isPending) {
+            setShowSaved(true);
+            const timer = setTimeout(() => setShowSaved(false), 2000);
+            return () => clearTimeout(timer);
+        }
+        prevPendingRef.current = isPending;
+    }, [isPending]);
+    // Keep local state in sync when the server prop changes after a server action.
+    useEffect(() => {
+        setEnabled(config.enabled);
+        setGatewayUrl(config.gatewayUrl ?? '');
+        setTelegram(config.telegram);
+        setWhatsapp(config.whatsapp);
+    }, [config.enabled, config.gatewayUrl, config.telegram, config.whatsapp]);
+    const saveTopLevel = useCallback((payload) => {
+        startTransition(async () => {
+            const result = await updateSettingsAction({
+                messaging: {
+                    ...config,
+                    enabled: payload.enabled ?? enabled,
+                    gatewayUrl: payload.gatewayUrl ?? gatewayUrl,
+                },
+            });
+            if (!result.success) {
+                toast.error(result.error ?? 'Failed to save messaging settings');
+            }
+        });
+    }, [config, enabled, gatewayUrl]);
+    const savePlatformBotToken = useCallback((platform, botToken) => {
+        const key = platform === MessagingPlatform.Telegram ? 'telegram' : 'whatsapp';
+        const existing = config[key];
+        if (!existing) {
+            toast.error('Pair this platform before setting a bot token.');
+            return;
+        }
+        startTransition(async () => {
+            const result = await updateSettingsAction({
+                messaging: {
+                    ...config,
+                    [key]: { ...existing, botToken: botToken || undefined },
+                },
+            });
+            if (!result.success) {
+                toast.error(result.error ?? 'Failed to save bot token');
+            }
+        });
+    }, [config]);
+    function handleEnableChange(value) {
+        setEnabled(value);
+        saveTopLevel({ enabled: value });
+    }
+    function handleGatewayBlur() {
+        if (gatewayUrl === (config.gatewayUrl ?? ''))
+            return;
+        if (gatewayUrl && !isValidUrl(gatewayUrl)) {
+            toast.error('Gateway URL must be a valid URL (e.g., https://gateway.example.com)');
+            return;
+        }
+        saveTopLevel({ gatewayUrl });
+    }
+    async function handlePair(platform) {
+        if (!isValidUrl(gatewayUrl)) {
+            toast.error('Set a valid Gateway URL before pairing');
+            return;
+        }
+        setPairingLoading(true);
+        setChatIdInput('');
+        try {
+            const result = await beginMessagingPairingAction({ platform, gatewayUrl });
+            if (!result.success || !result.session) {
+                toast.error(result.error ?? 'Failed to begin pairing');
+                return;
+            }
+            setPairing(result.session);
+        }
+        finally {
+            setPairingLoading(false);
+        }
+    }
+    async function handleConfirmPairing() {
+        if (!pairing)
+            return;
+        if (!chatIdInput.trim()) {
+            toast.error('Enter the chat ID that received the code');
+            return;
+        }
+        setPairingLoading(true);
+        try {
+            const result = await confirmMessagingPairingAction({
+                platform: pairing.platform,
+                chatId: chatIdInput.trim(),
+            });
+            if (!result.success) {
+                toast.error(result.error ?? 'Failed to confirm pairing');
+                return;
+            }
+            toast.success(`${platformLabel(pairing.platform)} paired`);
+            setPairing(null);
+        }
+        finally {
+            setPairingLoading(false);
+        }
+    }
+    async function handleDisconnect(platform) {
+        setPairingLoading(true);
+        try {
+            const result = await disconnectMessagingAction({ platform });
+            if (!result.success) {
+                toast.error(result.error ?? 'Failed to disconnect');
+                return;
+            }
+            toast.success(platform ? `${platformLabel(platform)} disconnected` : 'Messaging disconnected');
+        }
+        finally {
+            setPairingLoading(false);
+        }
+    }
+    async function handleCopyCode() {
+        if (!pairing)
+            return;
+        try {
+            await navigator.clipboard.writeText(pairing.code);
+            toast.success('Code copied');
+        }
+        catch {
+            toast.error('Unable to copy code');
+        }
+    }
+    async function handleCopyPublicUrl() {
+        if (!pairing)
+            return;
+        try {
+            await navigator.clipboard.writeText(pairing.publicUrl);
+            toast.success('Webhook URL copied');
+        }
+        catch {
+            toast.error('Unable to copy URL');
+        }
+    }
+    return (_jsxs(Card, { id: "messaging", className: "scroll-mt-6", "data-testid": "messaging-settings-section", children: [_jsxs(CardHeader, { children: [_jsxs("div", { className: "flex items-center justify-between", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(MessageCircle, { className: "text-muted-foreground h-4 w-4" }), _jsx(CardTitle, { children: "Messaging Remote Control" })] }), isPending ? _jsx("span", { className: "text-muted-foreground text-xs", children: "Saving..." }) : null, showSaved && !isPending ? (_jsxs("span", { className: "flex items-center gap-1 text-xs text-green-600", children: [_jsx(Check, { className: "h-3 w-3" }), "Saved"] })) : null] }), _jsx(CardDescription, { children: "Drive Shep remotely from Telegram or WhatsApp via the Commands.com Gateway." })] }), _jsxs(CardContent, { className: "space-y-4", children: [_jsxs("div", { className: "flex items-center justify-between", children: [_jsx(Label, { htmlFor: "messaging-enabled", children: "Enable messaging" }), _jsx(Switch, { id: "messaging-enabled", "data-testid": "switch-messaging-enabled", checked: enabled, onCheckedChange: handleEnableChange })] }), _jsxs("div", { className: "space-y-1.5", children: [_jsxs(Label, { htmlFor: "messaging-gateway-url", className: "flex items-center gap-1 text-xs", children: [_jsx(Link2, { className: "h-3 w-3" }), "Gateway URL"] }), _jsx(Input, { id: "messaging-gateway-url", "data-testid": "input-gateway-url", placeholder: "https://gateway.example.com", value: gatewayUrl, disabled: !enabled, onChange: (e) => setGatewayUrl(e.target.value), onBlur: handleGatewayBlur })] }), _jsx(Separator, {}), _jsx(PlatformRow, { platform: MessagingPlatform.Telegram, config: telegram, disabled: !enabled || pairingLoading, onPair: () => handlePair(MessagingPlatform.Telegram), onDisconnect: () => handleDisconnect(MessagingPlatform.Telegram), onSaveBotToken: (value) => savePlatformBotToken(MessagingPlatform.Telegram, value) }), _jsx(PlatformRow, { platform: MessagingPlatform.WhatsApp, config: whatsapp, disabled: !enabled || pairingLoading, onPair: () => handlePair(MessagingPlatform.WhatsApp), onDisconnect: () => handleDisconnect(MessagingPlatform.WhatsApp), onSaveBotToken: (value) => savePlatformBotToken(MessagingPlatform.WhatsApp, value) }), telegram?.paired === true || whatsapp?.paired === true ? (_jsxs(_Fragment, { children: [_jsx(Separator, {}), _jsxs("div", { className: "flex items-center justify-between", children: [_jsx("div", { className: "text-muted-foreground text-xs", children: "Disconnect all platforms" }), _jsxs(Button, { variant: "outline", size: "sm", disabled: pairingLoading, "data-testid": "btn-disconnect-all", onClick: () => handleDisconnect(), children: [_jsx(Unplug, { className: "mr-1 h-3 w-3" }), "Disconnect all"] })] })] })) : null] }), _jsx(Dialog, { open: !!pairing, onOpenChange: (open) => !open && setPairing(null), children: _jsxs(DialogContent, { "data-testid": "messaging-pairing-dialog", children: [_jsxs(DialogHeader, { children: [_jsxs(DialogTitle, { children: ["Pair ", pairing ? platformLabel(pairing.platform) : ''] }), _jsx(DialogDescription, { children: "Send this one-time code to your bot. Then enter the chat ID that received it to finish pairing." })] }), pairing ? (_jsxs("div", { className: "space-y-4", children: [_jsxs("div", { className: "bg-muted flex items-center justify-between rounded-md border px-4 py-3", "data-testid": "pairing-code-box", children: [_jsx("code", { className: "font-mono text-2xl tracking-[0.3em]", children: pairing.code }), _jsx(Button, { variant: "ghost", size: "sm", onClick: handleCopyCode, "data-testid": "btn-copy-code", "aria-label": "Copy code", children: _jsx(Copy, { className: "h-4 w-4" }) })] }), _jsxs("div", { className: "space-y-1.5", "data-testid": "pairing-public-url-box", children: [_jsxs(Label, { className: "flex items-center gap-1 text-xs", children: [_jsx(Link2, { className: "h-3 w-3" }), "Webhook URL for ", platformLabel(pairing.platform)] }), _jsxs("div", { className: "bg-muted flex items-center justify-between gap-2 rounded-md border px-3 py-2", children: [_jsx("code", { className: "truncate font-mono text-[11px]", "data-testid": "pairing-public-url", children: pairing.publicUrl }), _jsx(Button, { variant: "ghost", size: "sm", onClick: handleCopyPublicUrl, "data-testid": "btn-copy-public-url", "aria-label": "Copy webhook URL", children: _jsx(Copy, { className: "h-4 w-4" }) })] })] }), _jsxs("ol", { className: "text-muted-foreground list-decimal space-y-1 pl-4 text-xs", children: [_jsxs("li", { children: ["Point your ", platformLabel(pairing.platform), " bot webhook at the URL above (e.g.", ' ', _jsx("code", { className: "font-mono", children: "setWebhook" }), " for Telegram)."] }), _jsxs("li", { children: ["Send ", _jsxs("code", { className: "font-mono", children: ["/pair ", pairing.code] }), " to the bot."] }), _jsx("li", { children: "Enter the chat ID that received your code below and click Confirm." })] }), _jsxs("div", { className: "space-y-1.5", children: [_jsx(Label, { htmlFor: "pairing-chat-id", className: "text-xs", children: "Chat ID" }), _jsx(Input, { id: "pairing-chat-id", "data-testid": "input-pairing-chat-id", placeholder: "e.g. 123456789 or @username", value: chatIdInput, onChange: (e) => setChatIdInput(e.target.value) })] })] })) : null, _jsxs(DialogFooter, { children: [_jsx(Button, { variant: "outline", onClick: () => setPairing(null), disabled: pairingLoading, "data-testid": "btn-cancel-pairing", children: "Cancel" }), _jsxs(Button, { onClick: handleConfirmPairing, disabled: pairingLoading || !chatIdInput.trim(), "data-testid": "btn-confirm-pairing", children: [_jsx(ShieldCheck, { className: "mr-1 h-3 w-3" }), "Confirm pairing"] })] })] }) })] }));
+}
+function PlatformRow({ platform, config, disabled, onPair, onDisconnect, onSaveBotToken, }) {
+    const label = platformLabel(platform);
+    const paired = !!config?.paired;
+    const enabled = !!config?.enabled;
+    const chatId = config?.chatId;
+    const testIdPrefix = platform === MessagingPlatform.Telegram ? 'telegram' : 'whatsapp';
+    const [botToken, setBotToken] = useState(config?.botToken ?? '');
+    useEffect(() => {
+        setBotToken(config?.botToken ?? '');
+    }, [config?.botToken]);
+    function handleBotTokenBlur() {
+        if (botToken === (config?.botToken ?? ''))
+            return;
+        onSaveBotToken(botToken);
+    }
+    return (_jsxs("div", { className: "space-y-2", "data-testid": `messaging-platform-${testIdPrefix}`, children: [_jsxs("div", { className: "flex items-center justify-between gap-2", children: [_jsxs("div", { className: "min-w-0", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Label, { className: "text-sm", children: label }), paired ? (_jsx(Badge, { variant: "secondary", className: "text-[10px]", children: "Paired" })) : enabled ? (_jsx(Badge, { variant: "outline", className: "text-[10px]", children: "Pairing" })) : (_jsx(Badge, { variant: "outline", className: "text-[10px]", children: "Not configured" }))] }), chatId ? (_jsxs("p", { className: "text-muted-foreground truncate text-[11px]", children: ["chat: ", chatId] })) : null] }), _jsx("div", { className: "flex shrink-0 gap-2", children: paired ? (_jsx(Button, { variant: "outline", size: "sm", disabled: disabled, onClick: onDisconnect, "data-testid": `btn-${testIdPrefix}-disconnect`, children: "Disconnect" })) : (_jsx(Button, { size: "sm", disabled: disabled, onClick: onPair, "data-testid": `btn-${testIdPrefix}-pair`, children: "Pair device" })) })] }), paired ? (_jsxs("div", { className: "space-y-1 pl-1", children: [_jsx(Label, { htmlFor: `${testIdPrefix}-bot-token`, className: "text-[11px]", children: "Bot API token" }), _jsx(Input, { id: `${testIdPrefix}-bot-token`, "data-testid": `input-${testIdPrefix}-bot-token`, type: "password", placeholder: platform === MessagingPlatform.Telegram ? '123456:ABC-...' : 'WhatsApp access token', value: botToken, disabled: disabled, onChange: (e) => setBotToken(e.target.value), onBlur: handleBotTokenBlur }), _jsxs("p", { className: "text-muted-foreground text-[10px]", children: ["Needed so the daemon can send replies and notifications. Stored in settings.db; you can also set the ", _jsx("code", { className: "font-mono", children: "SHEP_TELEGRAM_BOT_TOKEN" }), " env var instead."] })] })) : null] }));
+}

package/dist/src/presentation/web/components/features/settings/messaging-settings-section.stories.d.ts

@@ -0,0 +1,17 @@
+import type { StoryObj } from '@storybook/react';
+import { MessagingSettingsSection } from './messaging-settings-section.js';
+declare const meta: {
+    title: string;
+    component: typeof MessagingSettingsSection;
+    tags: string[];
+    parameters: {
+        layout: string;
+    };
+};
+export default meta;
+type Story = StoryObj<typeof meta>;
+export declare const Disabled: Story;
+export declare const EnabledUnpaired: Story;
+export declare const TelegramPaired: Story;
+export declare const BothPaired: Story;
+//# sourceMappingURL=messaging-settings-section.stories.d.ts.map

package/dist/src/presentation/web/components/features/settings/messaging-settings-section.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging-settings-section.stories.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/settings/messaging-settings-section.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAExE,QAAA,MAAM,IAAI;;;;;;;CAOuC,CAAC;AAElD,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,QAAQ,EAAE,KAQtB,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,KAW7B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,KAW5B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,KAWxB,CAAC"}

package/dist/src/presentation/web/components/features/settings/messaging-settings-section.stories.js

@@ -0,0 +1,55 @@
+import { MessagingSettingsSection } from './messaging-settings-section.js';
+const meta = {
+    title: 'Features/Settings/MessagingSettingsSection',
+    component: MessagingSettingsSection,
+    tags: ['autodocs'],
+    parameters: {
+        layout: 'padded',
+    },
+};
+export default meta;
+export const Disabled = {
+    args: {
+        messaging: {
+            enabled: false,
+            debounceMs: 5000,
+            chatBufferMs: 3000,
+        },
+    },
+};
+export const EnabledUnpaired = {
+    args: {
+        messaging: {
+            enabled: true,
+            gatewayUrl: 'https://gateway.example.com',
+            debounceMs: 5000,
+            chatBufferMs: 3000,
+            telegram: { enabled: false, paired: false },
+            whatsapp: { enabled: false, paired: false },
+        },
+    },
+};
+export const TelegramPaired = {
+    args: {
+        messaging: {
+            enabled: true,
+            gatewayUrl: 'https://gateway.example.com',
+            debounceMs: 5000,
+            chatBufferMs: 3000,
+            telegram: { enabled: true, paired: true, chatId: '@alice' },
+            whatsapp: { enabled: false, paired: false },
+        },
+    },
+};
+export const BothPaired = {
+    args: {
+        messaging: {
+            enabled: true,
+            gatewayUrl: 'https://gateway.example.com',
+            debounceMs: 5000,
+            chatBufferMs: 3000,
+            telegram: { enabled: true, paired: true, chatId: '@alice' },
+            whatsapp: { enabled: true, paired: true, chatId: '+15551234567' },
+        },
+    },
+};

package/dist/src/presentation/web/components/features/settings/settings-page-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings-page-client.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/settings/settings-page-client.tsx"],"names":[],"mappings":"AA4CA,OAAO,KAAK,EACV,QAAQ,EAKT,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AA8B/E,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC1C;AA+QD,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,kBAAkB,GACnB,EAAE,uBAAuB,2CAw5CzB"}
+{"version":3,"file":"settings-page-client.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/settings/settings-page-client.tsx"],"names":[],"mappings":"AA8CA,OAAO,KAAK,EACV,QAAQ,EAKT,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AA+B/E,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC1C;AA+QD,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,kBAAkB,GACnB,EAAE,uBAAuB,2CA26CzB"}

package/dist/src/presentation/web/components/features/settings/settings-page-client.js

@@ -1,7 +1,7 @@
 'use client';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useState, useTransition, useRef, useEffect, useCallback } from 'react';
-import { Check, Bot, Terminal, GitBranch, Activity, Bell, Flag, Database, Globe, Minus, Plus, ExternalLink, Settings2, Timer, MessageSquare, LayoutGrid, } from 'lucide-react';
+import { Check, Bot, Terminal, GitBranch, Activity, Bell, Flag, Database, Globe, Minus, Plus, ExternalLink, Settings2, Timer, MessageSquare, LayoutGrid, MessageCircle, } from 'lucide-react';
 import { toast } from 'sonner';
 import { useTranslation } from 'react-i18next';
 import { cn } from '../../../lib/utils.js';
@@ -13,6 +13,7 @@ import { EditorType, Language, TerminalType, } from '../../../../../../packages/
 import { getEditorTypeIcon } from '../../common/editor-type-icons.js';
 import { AgentModelPicker } from '../../features/settings/AgentModelPicker/index.js';
 import { LanguageSettingsSection } from '../../features/settings/language-settings-section.js';
+import { MessagingSettingsSection } from '../../features/settings/messaging-settings-section.js';
 import { TimeoutSlider } from '../../features/settings/timeout-slider.js';
 const EDITOR_OPTIONS = [
     { value: EditorType.VsCode, label: 'VS Code' },
@@ -34,6 +35,7 @@ const SECTIONS = [
     { id: 'ci', labelKey: 'settings.sections.ci', icon: Activity },
     { id: 'stage-timeouts', labelKey: 'settings.sections.timeouts', icon: Timer },
     { id: 'notifications', labelKey: 'settings.sections.notifications', icon: Bell },
+    { id: 'messaging', labelKey: 'settings.sections.messaging', icon: MessageCircle },
     { id: 'feature-flags', labelKey: 'settings.sections.flags', icon: Flag },
     { id: 'interactive-agent', labelKey: 'settings.sections.chat', icon: MessageSquare },
     { id: 'fab-layout', labelKey: 'settings.sections.layout', icon: LayoutGrid },
@@ -540,7 +542,12 @@ export function SettingsPageClient({ settings, shepHome, dbFileSize, availableTe
                                         label: t('settings.notifications.links.notificationSystem'),
                                         href: 'https://github.com/shep-ai/shep/blob/main/specs/021-agent-notifications/spec.yaml',
                                     },
-                                ], children: t('settings.notifications.hint') })] }), _jsxs("div", { id: "section-feature-flags", className: "grid scroll-mt-18 grid-cols-1 gap-x-5 rounded-lg lg:grid-cols-[1fr_280px]", children: [_jsxs(SettingsSection, { icon: Flag, title: t('settings.featureFlags.title'), description: t('settings.featureFlags.sectionDescription'), badge: t('settings.featureFlags.badge'), testId: "feature-flags-settings-section", children: [_jsx(SwitchRow, { label: t('settings.featureFlags.skills'), description: t('settings.featureFlags.skillsDescription'), id: "flag-skills", testId: "switch-flag-skills", checked: flags.skills, onChange: (v) => {
+                                ], children: t('settings.notifications.hint') })] }), _jsxs("div", { id: "section-messaging", className: "grid scroll-mt-18 grid-cols-1 gap-x-5 rounded-lg lg:grid-cols-[1fr_280px]", children: [_jsx(MessagingSettingsSection, { messaging: settings.messaging }), _jsx(SectionHint, { links: [
+                                    {
+                                        label: 'Commands.com Gateway',
+                                        href: 'https://github.com/Commands-com/gateway',
+                                    },
+                                ], children: "Drive Shep remotely from Telegram or WhatsApp. Pair a chat to send commands and receive notifications through the Commands.com Gateway." })] }), _jsxs("div", { id: "section-feature-flags", className: "grid scroll-mt-18 grid-cols-1 gap-x-5 rounded-lg lg:grid-cols-[1fr_280px]", children: [_jsxs(SettingsSection, { icon: Flag, title: t('settings.featureFlags.title'), description: t('settings.featureFlags.sectionDescription'), badge: t('settings.featureFlags.badge'), testId: "feature-flags-settings-section", children: [_jsx(SwitchRow, { label: t('settings.featureFlags.skills'), description: t('settings.featureFlags.skillsDescription'), id: "flag-skills", testId: "switch-flag-skills", checked: flags.skills, onChange: (v) => {
                                             const newFlags = { ...flags, skills: v };
                                             setFlags(newFlags);
                                             save({ featureFlags: newFlags });

package/dist/src/presentation/web/dev-server.js

@@ -73,6 +73,26 @@ async function main() {
         // Start auto-archive watcher for completed features
         initializeAutoArchiveWatcher(featureRepo);
         getAutoArchiveWatcher().start();
+        // Optionally start the messaging remote-control service.
+        // Dev mode skips this by default because it opens a persistent
+        // WebSocket tunnel to the gateway and is not something every
+        // developer wants running on every `pnpm dev:web` invocation.
+        // Opt in with SHEP_ENABLE_MESSAGING=1.
+        if (process.env.SHEP_ENABLE_MESSAGING === '1') {
+            try {
+                const messagingService = container.resolve('IMessagingService');
+                if (messagingService.isConfigured()) {
+                    await messagingService.start();
+                    console.log('[dev-server] messaging remote control started');
+                }
+                else {
+                    console.log('[dev-server] SHEP_ENABLE_MESSAGING=1 but messaging is not configured yet — pair a platform in Settings first');
+                }
+            }
+            catch (err) {
+                console.warn('[dev-server] failed to start messaging service:', err);
+            }
+        }
     }
     catch (error) {
         console.warn('[dev-server] DI initialization failed — features will be empty:', error);
@@ -137,6 +157,13 @@ async function main() {
             catch {
                 /* not initialized */
             }
+            try {
+                const messagingService = container.resolve('IMessagingService');
+                await messagingService.stop();
+            }
+            catch {
+                /* not initialized or not running */
+            }
             server.closeAllConnections();
             await Promise.all([
                 new Promise((resolve) => server.close(() => resolve())),

package/dist/translations/ar/cli.json

@@ -478,6 +478,69 @@
         "notFound": "المستودع غير موجود: {{id}}"
       }
     },
+    "app": {
+      "description": "Manage applications",
+      "ls": {
+        "description": "List applications",
+        "title": "Applications",
+        "idColumn": "ID",
+        "nameColumn": "Name",
+        "statusColumn": "Status",
+        "pathColumn": "Path",
+        "createdColumn": "Created",
+        "noApps": "No applications found",
+        "failedToList": "Failed to list applications"
+      },
+      "show": {
+        "description": "Display details of an application",
+        "idArgument": "Application ID, slug, or prefix",
+        "title": "Application: {{name}}",
+        "nameLabel": "Name",
+        "slugLabel": "Slug",
+        "statusLabel": "Status",
+        "descriptionLabel": "Description",
+        "pathLabel": "Path",
+        "configTitle": "Configuration",
+        "agentLabel": "Agent",
+        "modelLabel": "Model",
+        "timestampsTitle": "Timestamps",
+        "createdLabel": "Created",
+        "updatedLabel": "Updated",
+        "deletedLabel": "Deleted",
+        "failedToShow": "Failed to show application"
+      },
+      "new": {
+        "description": "Create a new application",
+        "descriptionArgument": "Application description",
+        "agentOption": "Agent type override",
+        "modelOption": "LLM model override (e.g. claude-opus-4-6)",
+        "spinnerText": "Creating application",
+        "appCreated": "Application created",
+        "idLabel": "ID:",
+        "nameLabel": "Name:",
+        "slugLabel": "Slug:",
+        "pathLabel": "Path:",
+        "statusLabel": "Status:",
+        "agentLabel": "Agent:",
+        "modelLabel": "Model:",
+        "failedToCreate": "Failed to create application"
+      },
+      "del": {
+        "description": "Delete an application",
+        "idArgument": "Application ID, slug, or prefix",
+        "forceOption": "Skip confirmation prompt",
+        "confirmDelete": "Delete application \"{{name}}\"?",
+        "cancelled": "Cancelled",
+        "appDeleted": "Application deleted",
+        "nameLabel": "Name:",
+        "slugLabel": "Slug:",
+        "failedToDelete": "Failed to delete application"
+      },
+      "resolve": {
+        "multipleMatch": "Multiple applications match prefix \"{{id}}\": {{matches}}",
+        "notFound": "Application not found: {{id}}"
+      }
+    },
     "agent": {
       "description": "إدارة وعرض تشغيلات الوكيل",
       "show": {

package/dist/translations/ar/web.json

@@ -15,7 +15,8 @@
       "flags": "العلامات",
       "chat": "المحادثة",
       "layout": "التخطيط",
-      "database": "قاعدة البيانات"
+      "database": "قاعدة البيانات",
+      "messaging": "Messaging"
     },
     "language": {
       "title": "اللغة",

package/dist/translations/de/cli.json

@@ -478,6 +478,69 @@
         "notFound": "Repository nicht gefunden: {{id}}"
       }
     },
+    "app": {
+      "description": "Manage applications",
+      "ls": {
+        "description": "List applications",
+        "title": "Applications",
+        "idColumn": "ID",
+        "nameColumn": "Name",
+        "statusColumn": "Status",
+        "pathColumn": "Path",
+        "createdColumn": "Created",
+        "noApps": "No applications found",
+        "failedToList": "Failed to list applications"
+      },
+      "show": {
+        "description": "Display details of an application",
+        "idArgument": "Application ID, slug, or prefix",
+        "title": "Application: {{name}}",
+        "nameLabel": "Name",
+        "slugLabel": "Slug",
+        "statusLabel": "Status",
+        "descriptionLabel": "Description",
+        "pathLabel": "Path",
+        "configTitle": "Configuration",
+        "agentLabel": "Agent",
+        "modelLabel": "Model",
+        "timestampsTitle": "Timestamps",
+        "createdLabel": "Created",
+        "updatedLabel": "Updated",
+        "deletedLabel": "Deleted",
+        "failedToShow": "Failed to show application"
+      },
+      "new": {
+        "description": "Create a new application",
+        "descriptionArgument": "Application description",
+        "agentOption": "Agent type override",
+        "modelOption": "LLM model override (e.g. claude-opus-4-6)",
+        "spinnerText": "Creating application",
+        "appCreated": "Application created",
+        "idLabel": "ID:",
+        "nameLabel": "Name:",
+        "slugLabel": "Slug:",
+        "pathLabel": "Path:",
+        "statusLabel": "Status:",
+        "agentLabel": "Agent:",
+        "modelLabel": "Model:",
+        "failedToCreate": "Failed to create application"
+      },
+      "del": {
+        "description": "Delete an application",
+        "idArgument": "Application ID, slug, or prefix",
+        "forceOption": "Skip confirmation prompt",
+        "confirmDelete": "Delete application \"{{name}}\"?",
+        "cancelled": "Cancelled",
+        "appDeleted": "Application deleted",
+        "nameLabel": "Name:",
+        "slugLabel": "Slug:",
+        "failedToDelete": "Failed to delete application"
+      },
+      "resolve": {
+        "multipleMatch": "Multiple applications match prefix \"{{id}}\": {{matches}}",
+        "notFound": "Application not found: {{id}}"
+      }
+    },
     "agent": {
       "description": "Agentläufe verwalten und anzeigen",
       "show": {

package/dist/translations/de/web.json

@@ -15,7 +15,8 @@
       "flags": "Flags",
       "chat": "Chat",
       "layout": "Layout",
-      "database": "Datenbank"
+      "database": "Datenbank",
+      "messaging": "Messaging"
     },
     "language": {
       "title": "Sprache",