@shepai/cli 1.180.0 → 1.181.0-pr512.ba01d33

package/dist/src/presentation/cli/commands/app/index.js

@@ -0,0 +1,33 @@
+/**
+ * App Command
+ *
+ * Top-level app command with subcommands for managing applications.
+ *
+ * Usage:
+ *   shep app [subcommand]
+ *
+ * Subcommands:
+ *   shep app ls             List applications
+ *   shep app show <id>      Display details of an application
+ *   shep app new <desc>     Create a new application
+ *   shep app del <id>       Delete an application
+ */
+import { Command } from 'commander';
+import { createLsCommand } from './ls.command.js';
+import { createShowCommand } from './show.command.js';
+import { createNewCommand } from './new.command.js';
+import { createDelCommand } from './del.command.js';
+import { getCliI18n } from '../../i18n.js';
+/**
+ * Create the app command with all subcommands
+ */
+export function createAppCommand() {
+    const t = getCliI18n().t;
+    const app = new Command('app')
+        .description(t('cli:commands.app.description'))
+        .addCommand(createLsCommand())
+        .addCommand(createShowCommand())
+        .addCommand(createNewCommand())
+        .addCommand(createDelCommand());
+    return app;
+}

package/dist/src/presentation/cli/commands/app/ls.command.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Application List Command
+ *
+ * List all applications in a formatted table.
+ *
+ * Usage:
+ *   shep app ls
+ */
+import { Command } from 'commander';
+export declare function createLsCommand(): Command;
+//# sourceMappingURL=ls.command.d.ts.map

package/dist/src/presentation/cli/commands/app/ls.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ls.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/app/ls.command.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgCpC,wBAAgB,eAAe,IAAI,OAAO,CAkCzC"}

package/dist/src/presentation/cli/commands/app/ls.command.js

@@ -0,0 +1,74 @@
+/**
+ * Application List Command
+ *
+ * List all applications in a formatted table.
+ *
+ * Usage:
+ *   shep app ls
+ */
+import { Command } from 'commander';
+import { container } from '../../../../../packages/core/src/infrastructure/di/container.js';
+import { ListApplicationsUseCase } from '../../../../../packages/core/src/application/use-cases/applications/list-applications.use-case.js';
+import { colors, messages, renderListView } from '../../ui/index.js';
+import { getCliI18n } from '../../i18n.js';
+/** Format a duration in ms to a compact human-readable string. */
+function formatDuration(ms) {
+    const seconds = Math.floor(ms / 1000);
+    if (seconds < 60)
+        return `${seconds}s`;
+    const minutes = Math.floor(seconds / 60);
+    if (minutes < 60)
+        return `${minutes}m`;
+    const hours = Math.floor(minutes / 60);
+    const remMin = minutes % 60;
+    if (hours < 24)
+        return remMin > 0 ? `${hours}h ${remMin}m` : `${hours}h`;
+    const days = Math.floor(hours / 24);
+    return `${days}d`;
+}
+function colorStatus(status) {
+    switch (status) {
+        case 'Idle':
+            return colors.muted(status);
+        case 'Active':
+            return colors.success(status);
+        case 'Error':
+            return colors.warning(status);
+        default:
+            return colors.muted(status);
+    }
+}
+export function createLsCommand() {
+    const t = getCliI18n().t;
+    return new Command('ls').description(t('cli:commands.app.ls.description')).action(async () => {
+        try {
+            const useCase = container.resolve(ListApplicationsUseCase);
+            const applications = await useCase.execute();
+            const now = Date.now();
+            const rows = applications.map((app) => [
+                app.id.substring(0, 8),
+                app.name,
+                colorStatus(app.status),
+                app.repositoryPath,
+                colors.muted(`${formatDuration(now - new Date(app.createdAt).getTime())} ago`),
+            ]);
+            renderListView({
+                title: t('cli:commands.app.ls.title'),
+                columns: [
+                    { label: t('cli:commands.app.ls.idColumn'), width: 10 },
+                    { label: t('cli:commands.app.ls.nameColumn'), width: 28 },
+                    { label: t('cli:commands.app.ls.statusColumn'), width: 10 },
+                    { label: t('cli:commands.app.ls.pathColumn'), width: 36 },
+                    { label: t('cli:commands.app.ls.createdColumn'), width: 12 },
+                ],
+                rows,
+                emptyMessage: t('cli:commands.app.ls.noApps'),
+            });
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            messages.error(t('cli:commands.app.ls.failedToList'), err);
+            process.exitCode = 1;
+        }
+    });
+}

package/dist/src/presentation/cli/commands/app/new.command.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Application New Command
+ *
+ * Creates a new application with optional initial prompt to kick off
+ * an interactive agent session.
+ *
+ * Usage:
+ *   shep app new <description> [options]
+ *
+ * @example
+ * $ shep app new "Build a todo list app with React"
+ * $ shep app new "REST API for inventory management" --agent claude-code
+ * $ shep app new "Portfolio website" --model claude-opus-4-6
+ */
+import { Command } from 'commander';
+export declare function createNewCommand(): Command;
+//# sourceMappingURL=new.command.d.ts.map

package/dist/src/presentation/cli/commands/app/new.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"new.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/app/new.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,wBAAgB,gBAAgB,IAAI,OAAO,CAuD1C"}

package/dist/src/presentation/cli/commands/app/new.command.js

@@ -0,0 +1,58 @@
+/**
+ * Application New Command
+ *
+ * Creates a new application with optional initial prompt to kick off
+ * an interactive agent session.
+ *
+ * Usage:
+ *   shep app new <description> [options]
+ *
+ * @example
+ * $ shep app new "Build a todo list app with React"
+ * $ shep app new "REST API for inventory management" --agent claude-code
+ * $ shep app new "Portfolio website" --model claude-opus-4-6
+ */
+import { Command } from 'commander';
+import { container } from '../../../../../packages/core/src/infrastructure/di/container.js';
+import { CreateApplicationUseCase } from '../../../../../packages/core/src/application/use-cases/applications/create-application.use-case.js';
+import { colors, messages, spinner } from '../../ui/index.js';
+import { getCliI18n } from '../../i18n.js';
+export function createNewCommand() {
+    const t = getCliI18n().t;
+    return new Command('new')
+        .description(t('cli:commands.app.new.description'))
+        .argument('<description>', t('cli:commands.app.new.descriptionArgument'))
+        .option('--agent <type>', t('cli:commands.app.new.agentOption'))
+        .option('--model <model>', t('cli:commands.app.new.modelOption'))
+        .action(async (description, options) => {
+        try {
+            const useCase = container.resolve(CreateApplicationUseCase);
+            const result = await spinner(t('cli:commands.app.new.spinnerText'), () => useCase.execute({
+                description,
+                agentType: options.agent,
+                modelOverride: options.model,
+                initialPrompt: description,
+            }));
+            const { application } = result;
+            messages.newline();
+            messages.success(t('cli:commands.app.new.appCreated'));
+            console.log(`  ${colors.muted(t('cli:commands.app.new.idLabel'))}       ${colors.accent(application.id)}`);
+            console.log(`  ${colors.muted(t('cli:commands.app.new.nameLabel'))}     ${application.name}`);
+            console.log(`  ${colors.muted(t('cli:commands.app.new.slugLabel'))}     ${application.slug}`);
+            console.log(`  ${colors.muted(t('cli:commands.app.new.pathLabel'))}     ${result.repositoryPath}`);
+            console.log(`  ${colors.muted(t('cli:commands.app.new.statusLabel'))}   ${application.status}`);
+            if (application.agentType) {
+                console.log(`  ${colors.muted(t('cli:commands.app.new.agentLabel'))}    ${application.agentType}`);
+            }
+            if (application.modelOverride) {
+                console.log(`  ${colors.muted(t('cli:commands.app.new.modelLabel'))}    ${application.modelOverride}`);
+            }
+            messages.newline();
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            messages.error(t('cli:commands.app.new.failedToCreate'), err);
+            process.exitCode = 1;
+        }
+    });
+}

package/dist/src/presentation/cli/commands/app/resolve-application.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Shared helper: resolve an application by exact ID, prefix, or slug.
+ */
+import type { Application } from '../../../../../packages/core/src/domain/generated/output.js';
+export declare function resolveApplication(id: string): Promise<{
+    application: Application;
+} | {
+    error: string;
+}>;
+//# sourceMappingURL=resolve-application.d.ts.map

package/dist/src/presentation/cli/commands/app/resolve-application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-application.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/app/resolve-application.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAGhE,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,MAAM,GACT,OAAO,CAAC;IAAE,WAAW,EAAE,WAAW,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CA6B3D"}

package/dist/src/presentation/cli/commands/app/resolve-application.js

@@ -0,0 +1,33 @@
+/**
+ * Shared helper: resolve an application by exact ID, prefix, or slug.
+ */
+import { container } from '../../../../../packages/core/src/infrastructure/di/container.js';
+import { getCliI18n } from '../../i18n.js';
+export async function resolveApplication(id) {
+    const t = getCliI18n().t;
+    const repo = container.resolve('IApplicationRepository');
+    // Try exact ID match first
+    const exact = await repo.findById(id);
+    if (exact)
+        return { application: exact };
+    // Try slug match
+    const bySlug = await repo.findBySlug(id);
+    if (bySlug)
+        return { application: bySlug };
+    // Try prefix match on ID
+    if (id.length < 36) {
+        const all = await repo.list();
+        const matches = all.filter((a) => a.id.startsWith(id));
+        if (matches.length === 1)
+            return { application: matches[0] };
+        if (matches.length > 1) {
+            return {
+                error: t('cli:commands.app.resolve.multipleMatch', {
+                    id,
+                    matches: matches.map((m) => m.id.substring(0, 8)).join(', '),
+                }),
+            };
+        }
+    }
+    return { error: t('cli:commands.app.resolve.notFound', { id }) };
+}

package/dist/src/presentation/cli/commands/app/show.command.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Application Show Command
+ *
+ * Display details of a specific application.
+ *
+ * Usage:
+ *   shep app show <id>
+ */
+import { Command } from 'commander';
+export declare function createShowCommand(): Command;
+//# sourceMappingURL=show.command.d.ts.map

package/dist/src/presentation/cli/commands/app/show.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/app/show.command.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAcpC,wBAAgB,iBAAiB,IAAI,OAAO,CAwE3C"}

package/dist/src/presentation/cli/commands/app/show.command.js

@@ -0,0 +1,95 @@
+/**
+ * Application Show Command
+ *
+ * Display details of a specific application.
+ *
+ * Usage:
+ *   shep app show <id>
+ */
+import { Command } from 'commander';
+import { colors, messages, renderDetailView } from '../../ui/index.js';
+import { resolveApplication } from './resolve-application.js';
+import { getCliI18n } from '../../i18n.js';
+function formatDate(date) {
+    if (!date)
+        return null;
+    try {
+        return new Date(date).toLocaleString();
+    }
+    catch {
+        return String(date);
+    }
+}
+export function createShowCommand() {
+    const t = getCliI18n().t;
+    return new Command('show')
+        .description(t('cli:commands.app.show.description'))
+        .argument('<id>', t('cli:commands.app.show.idArgument'))
+        .action(async (id) => {
+        try {
+            const resolved = await resolveApplication(id);
+            if ('error' in resolved) {
+                messages.error(resolved.error);
+                process.exitCode = 1;
+                return;
+            }
+            const app = resolved.application;
+            renderDetailView({
+                title: t('cli:commands.app.show.title', { name: app.name }),
+                sections: [
+                    {
+                        fields: [
+                            { label: 'ID', value: app.id },
+                            { label: t('cli:commands.app.show.nameLabel'), value: app.name },
+                            { label: t('cli:commands.app.show.slugLabel'), value: app.slug },
+                            { label: t('cli:commands.app.show.statusLabel'), value: app.status },
+                            {
+                                label: t('cli:commands.app.show.descriptionLabel'),
+                                value: app.description,
+                            },
+                            {
+                                label: t('cli:commands.app.show.pathLabel'),
+                                value: app.repositoryPath,
+                            },
+                        ],
+                    },
+                    {
+                        title: t('cli:commands.app.show.configTitle'),
+                        fields: [
+                            {
+                                label: t('cli:commands.app.show.agentLabel'),
+                                value: app.agentType ?? colors.muted('default'),
+                            },
+                            {
+                                label: t('cli:commands.app.show.modelLabel'),
+                                value: app.modelOverride ?? colors.muted('default'),
+                            },
+                        ],
+                    },
+                    {
+                        title: t('cli:commands.app.show.timestampsTitle'),
+                        fields: [
+                            {
+                                label: t('cli:commands.app.show.createdLabel'),
+                                value: formatDate(app.createdAt),
+                            },
+                            {
+                                label: t('cli:commands.app.show.updatedLabel'),
+                                value: formatDate(app.updatedAt),
+                            },
+                            {
+                                label: t('cli:commands.app.show.deletedLabel'),
+                                value: formatDate(app.deletedAt),
+                            },
+                        ],
+                    },
+                ],
+            });
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            messages.error(t('cli:commands.app.show.failedToShow'), err);
+            process.exitCode = 1;
+        }
+    });
+}

package/dist/src/presentation/cli/commands/settings/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/settings/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAuB/C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/settings/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAwB/C"}

package/dist/src/presentation/cli/commands/settings/index.js

@@ -22,6 +22,7 @@ import { createIdeCommand } from './ide.command.js';
 import { createWorkflowCommand } from './workflow.command.js';
 import { createModelCommand } from './model.command.js';
 import { createLanguageCommand } from './language.command.js';
+import { createMessagingCommand } from './messaging.command.js';
 import { onboardingWizard } from '../../../tui/wizards/onboarding/onboarding.wizard.js';
 import { messages } from '../../ui/index.js';
 import { getCliI18n } from '../../i18n.js';
@@ -37,7 +38,8 @@ export function createSettingsCommand() {
         .addCommand(createIdeCommand())
         .addCommand(createWorkflowCommand())
         .addCommand(createModelCommand())
-        .addCommand(createLanguageCommand());
+        .addCommand(createLanguageCommand())
+        .addCommand(createMessagingCommand());
     // Default action: launch the full setup wizard when no subcommand is given
     cmd.action(async () => {
         try {

package/dist/src/presentation/cli/commands/settings/messaging.command.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Messaging Configuration Command
+ *
+ * Configures external messaging remote control via Telegram or WhatsApp
+ * through the Commands.com Gateway.
+ *
+ * Usage:
+ *   shep settings messaging             # Interactive setup wizard
+ *   shep settings messaging status      # Show connection status
+ *   shep settings messaging disconnect  # Disconnect messaging
+ */
+import { Command } from 'commander';
+/**
+ * Create the messaging configuration command.
+ */
+export declare function createMessagingCommand(): Command;
+//# sourceMappingURL=messaging.command.d.ts.map

package/dist/src/presentation/cli/commands/settings/messaging.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/settings/messaging.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBpC;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CA6EhD"}

package/dist/src/presentation/cli/commands/settings/messaging.command.js

@@ -0,0 +1,187 @@
+/**
+ * Messaging Configuration Command
+ *
+ * Configures external messaging remote control via Telegram or WhatsApp
+ * through the Commands.com Gateway.
+ *
+ * Usage:
+ *   shep settings messaging             # Interactive setup wizard
+ *   shep settings messaging status      # Show connection status
+ *   shep settings messaging disconnect  # Disconnect messaging
+ */
+import { Command } from 'commander';
+import { select, input, confirm } from '@inquirer/prompts';
+import { container } from '../../../../../packages/core/src/infrastructure/di/container.js';
+import { BeginMessagingPairingUseCase } from '../../../../../packages/core/src/application/use-cases/messaging/begin-pairing.use-case.js';
+import { ConfirmMessagingPairingUseCase } from '../../../../../packages/core/src/application/use-cases/messaging/confirm-pairing.use-case.js';
+import { DisconnectMessagingUseCase } from '../../../../../packages/core/src/application/use-cases/messaging/disconnect-messaging.use-case.js';
+import { UpdateSettingsUseCase } from '../../../../../packages/core/src/application/use-cases/settings/update-settings.use-case.js';
+import { getSettings, resetSettings, initializeSettings, } from '../../../../../packages/core/src/infrastructure/services/settings.service.js';
+import { LoadSettingsUseCase } from '../../../../../packages/core/src/application/use-cases/settings/load-settings.use-case.js';
+import { MessagingPlatform } from '../../../../../packages/core/src/domain/generated/output.js';
+import { messages } from '../../ui/index.js';
+import { shepTheme } from '../../../tui/themes/shep.theme.js';
+/**
+ * Create the messaging configuration command.
+ */
+export function createMessagingCommand() {
+    const cmd = new Command('messaging')
+        .description('Configure messaging remote control (Telegram/WhatsApp)')
+        .addHelpText('after', `
+Examples:
+  $ shep settings messaging             Interactive setup wizard
+  $ shep settings messaging status      Show connection status
+  $ shep settings messaging disconnect  Disconnect messaging`)
+        .action(async () => {
+        try {
+            await runMessagingWizard();
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            if (err.message.includes('force closed') || err.message.includes('User force closed')) {
+                messages.info('Messaging setup cancelled.');
+                return;
+            }
+            messages.error('Failed to configure messaging', err);
+            process.exitCode = 1;
+        }
+    });
+    cmd
+        .command('status')
+        .description('Show messaging connection status')
+        .action(() => {
+        const settings = getSettings();
+        const mc = settings.messaging;
+        if (!mc?.enabled) {
+            messages.info('Messaging remote control is not configured.');
+            return;
+        }
+        console.log(`\nMessaging Remote Control`);
+        console.log(`  Gateway: ${mc.gatewayUrl ?? 'not set'}`);
+        console.log(`  Enabled: ${mc.enabled}`);
+        if (mc.telegram) {
+            console.log(`  Telegram: ${mc.telegram.enabled ? 'enabled' : 'disabled'} (${mc.telegram.paired ? 'paired' : 'not paired'})`);
+        }
+        if (mc.whatsapp) {
+            console.log(`  WhatsApp: ${mc.whatsapp.enabled ? 'enabled' : 'disabled'} (${mc.whatsapp.paired ? 'paired' : 'not paired'})`);
+        }
+        console.log('');
+    });
+    cmd
+        .command('disconnect')
+        .description('Disconnect all messaging platforms')
+        .action(async () => {
+        try {
+            const useCase = container.resolve(DisconnectMessagingUseCase);
+            await useCase.execute();
+            await refreshSettingsSingleton();
+            messages.success('Messaging remote control disconnected.');
+        }
+        catch (error) {
+            messages.error('Failed to disconnect messaging', error instanceof Error ? error : new Error(String(error)));
+            process.exitCode = 1;
+        }
+    });
+    return cmd;
+}
+async function refreshSettingsSingleton() {
+    const loadUseCase = container.resolve(LoadSettingsUseCase);
+    const fresh = await loadUseCase.execute();
+    resetSettings();
+    initializeSettings(fresh);
+}
+async function runMessagingWizard() {
+    const settings = getSettings();
+    const platformChoice = await select({
+        message: 'Which platform would you like to connect?',
+        choices: [
+            { name: 'Telegram', value: 'telegram' },
+            { name: 'WhatsApp', value: 'whatsapp' },
+            { name: 'Disconnect all', value: 'disconnect' },
+        ],
+        theme: shepTheme,
+    });
+    if (platformChoice === 'disconnect') {
+        const disconnectUseCase = container.resolve(DisconnectMessagingUseCase);
+        await disconnectUseCase.execute();
+        await refreshSettingsSingleton();
+        messages.success('Messaging remote control disconnected.');
+        return;
+    }
+    const platform = platformChoice === 'telegram' ? MessagingPlatform.Telegram : MessagingPlatform.WhatsApp;
+    const platformLabel = platformChoice === 'telegram' ? 'Telegram' : 'WhatsApp';
+    // Get Gateway URL
+    const gatewayUrl = await input({
+        message: 'Enter your Gateway URL:',
+        default: settings.messaging?.gatewayUrl ?? '',
+        validate: (value) => {
+            if (!value.trim())
+                return 'Gateway URL is required';
+            try {
+                new URL(value);
+                return true;
+            }
+            catch {
+                return 'Please enter a valid URL (e.g., https://my-gateway.railway.app)';
+            }
+        },
+        theme: shepTheme,
+    });
+    // Begin pairing — generates a one-time code and persists pending state.
+    const beginUseCase = container.resolve(BeginMessagingPairingUseCase);
+    const session = await beginUseCase.execute({ platform, gatewayUrl });
+    await refreshSettingsSingleton();
+    messages.info(`${platformLabel} pairing initiated.`);
+    console.log('');
+    console.log(`  Pairing code: ${session.code}`);
+    console.log(`  Expires at:   ${new Date(session.expiresAt).toLocaleString()}`);
+    console.log('');
+    console.log(`  Webhook URL (${platformLabel}):`);
+    console.log(`    ${session.publicUrl}`);
+    console.log('');
+    console.log('  Next steps:');
+    console.log(`    1. Point your ${platformLabel} bot webhook at the URL above`);
+    console.log(`       (Telegram: curl -X POST https://api.telegram.org/bot<TOKEN>/setWebhook -d url=...)`);
+    console.log(`    2. Send: /pair ${session.code}`);
+    console.log(`    3. Return here and enter the chat ID the bot replies with`);
+    console.log('');
+    const shouldConfirm = await confirm({
+        message: 'Confirm pairing now?',
+        default: true,
+        theme: shepTheme,
+    });
+    if (!shouldConfirm) {
+        messages.info('You can confirm pairing later by re-running `shep settings messaging`.');
+        return;
+    }
+    const chatId = await input({
+        message: 'Chat ID the bot replied with:',
+        validate: (value) => (value.trim() ? true : 'Chat ID is required'),
+        theme: shepTheme,
+    });
+    const confirmUseCase = container.resolve(ConfirmMessagingPairingUseCase);
+    await confirmUseCase.execute({ platform, chatId });
+    await refreshSettingsSingleton();
+    // Collect the bot API token so the daemon can reply to the user.
+    const botToken = await input({
+        message: `${platformLabel} bot API token (leave blank to use $SHEP_TELEGRAM_BOT_TOKEN):`,
+        default: '',
+        theme: shepTheme,
+    });
+    if (botToken.trim()) {
+        const current = getSettings();
+        const key = platform === MessagingPlatform.Telegram ? 'telegram' : 'whatsapp';
+        const existingPlatform = current.messaging?.[key];
+        if (existingPlatform && current.messaging) {
+            current.messaging = {
+                ...current.messaging,
+                [key]: { ...existingPlatform, botToken: botToken.trim() },
+            };
+            const updateUseCase = container.resolve(UpdateSettingsUseCase);
+            await updateUseCase.execute(current);
+            await refreshSettingsSingleton();
+        }
+    }
+    messages.success(`${platformLabel} messaging paired.`);
+    messages.info('Restart the Shep daemon (`shep _serve`) to activate messaging.');
+}

package/dist/src/presentation/cli/index.js

@@ -37,6 +37,7 @@ import { createRunCommand } from './commands/run.command.js';
 import { createAgentCommand } from './commands/agent/index.js';
 import { createFeatCommand } from './commands/feat/index.js';
 import { createRepoCommand } from './commands/repo/index.js';
+import { createAppCommand } from './commands/app/index.js';
 import { createSessionCommand } from './commands/session/index.js';
 import { createIdeOpenCommand } from './commands/ide-open.command.js';
 import { createInstallCommand } from './commands/install.command.js';
@@ -117,6 +118,7 @@ async function bootstrap() {
         program.addCommand(createAgentCommand());
         program.addCommand(createFeatCommand());
         program.addCommand(createRepoCommand());
+        program.addCommand(createAppCommand());
         program.addCommand(createSessionCommand());
         program.addCommand(createIdeOpenCommand());
         program.addCommand(createInstallCommand());

package/dist/src/presentation/web/app/actions/messaging.d.ts

@@ -0,0 +1,29 @@
+import type { MessagingPlatform } from '../../../../../packages/core/src/domain/generated/output.js';
+export interface BeginPairingResult {
+    success: boolean;
+    error?: string;
+    session?: {
+        platform: MessagingPlatform;
+        code: string;
+        expiresAt: string;
+        gatewayUrl: string;
+        publicUrl: string;
+        routeId: string;
+    };
+}
+export interface MessagingActionResult {
+    success: boolean;
+    error?: string;
+}
+export declare function beginMessagingPairingAction(input: {
+    platform: MessagingPlatform;
+    gatewayUrl: string;
+}): Promise<BeginPairingResult>;
+export declare function confirmMessagingPairingAction(input: {
+    platform: MessagingPlatform;
+    chatId: string;
+}): Promise<MessagingActionResult>;
+export declare function disconnectMessagingAction(input: {
+    platform?: MessagingPlatform;
+}): Promise<MessagingActionResult>;
+//# sourceMappingURL=messaging.d.ts.map

package/dist/src/presentation/web/app/actions/messaging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/app/actions/messaging.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAE9E,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE;QACR,QAAQ,EAAE,iBAAiB,CAAC;QAC5B,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAcD,wBAAsB,2BAA2B,CAAC,KAAK,EAAE;IACvD,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAW9B;AAED,wBAAsB,6BAA6B,CAAC,KAAK,EAAE;IACzD,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAWjC;AAED,wBAAsB,yBAAyB,CAAC,KAAK,EAAE;IACrD,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAWjC"}