plazbot-cli 0.4.0 → 0.5.0

package/dist/commands/portal/add-agent.js

@@ -1,55 +1,116 @@
-import { Command } from 'commander';
-import { Portal, Agent } from 'plazbot';
-import { getStoredCredentials } from '../../utils/credentials.js';
+import { Command, Option } from 'commander';
+import { Agent } from 'plazbot';
+import { addExamples, addNotes } from '../../utils/help.js';
+import { jsonOption, isJsonMode, printJson, fail, CliError } from '../../utils/output.js';
+import { addYesOption, confirmAction } from '../../utils/confirm.js';
+import { createSpinner } from '../../utils/ui.js';
 import { logger } from '../../utils/logger.js';
-import { addExamples } from '../../utils/help.js';
-export const addAgentCommand = new Command('add-agent-portal')
-    .description('Add an existing agent to a portal')
-    .requiredOption('-p, --portal-id <portalId>', 'Portal ID')
-    .requiredOption('-a, --agent-id <agentId>', 'ID of the agent to add')
+import { createPortalClient, resolvePortalId } from './shared.js';
+function resolveAgentId(options) {
+    const id = (options.agent || options.agentId || '').trim();
+    if (!id) {
+        throw new CliError('Agent ID is required.', 'missing_agent_id', "Pass it with -a, --agent <agentId>. Find it with 'plazbot agent list'.");
+    }
+    return id;
+}
+/** Loads the agent name (the SDK returns { success, agent }). */
+async function fetchAgentName(client, agentId, dev) {
+    const agent = new Agent({
+        workspaceId: client.credentials.workspace,
+        apiKey: client.credentials.apiKey,
+        zone: client.credentials.zone,
+        ...(dev && { customUrl: 'http://localhost:5090' }),
+    });
+    const response = await agent.getAgentById({ id: agentId });
+    const data = response?.agent || response?.data || response;
+    return data?.name;
+}
+const portalIdOption = () => new Option('-p, --portal-id <portalId>', 'Portal ID (legacy, use the positional argument)').hideHelp();
+export const addAgentCommand = new Command('add-agent')
+    .alias('add-agent-portal')
+    .description('Attach an existing agent to a portal')
+    .argument('[portalId]', 'Portal ID (see plazbot portal list)')
+    .option('-a, --agent <agentId>', 'ID of the agent to attach (see plazbot agent list)')
+    .addOption(portalIdOption())
+    .addOption(new Option('--agent-id <agentId>', 'Alias of --agent').hideHelp())
+    .addOption(jsonOption())
     .option('--dev', 'Use development environment', false)
-    .action(async (options) => {
+    .action(async (portalIdArg, options) => {
     try {
-        // Obtener credenciales guardadas
-        const credentials = await getStoredCredentials();
-        const portal = new Portal({
-            workspaceId: credentials.workspace,
-            apiKey: credentials.apiKey,
-            zone: credentials.zone,
-            ...(options.dev && { customUrl: "http://localhost:5090" })
-        });
-        // Obtener detalles del portal
-        const portalDetails = await portal.getPortal(options.portalId);
-        // Crear instancia del agente para obtener sus detalles
-        const agent = new Agent({
-            workspaceId: credentials.workspace,
-            apiKey: credentials.apiKey,
-            zone: credentials.zone,
-            ...(options.dev && { customUrl: "http://localhost:5090" })
-        });
-        // Obtener detalles del agente
-        const agentDetails = await agent.getAgentById({ id: options.agentId });
-        logger.title('Operation details');
-        logger.label('Portal ID', portalDetails.portal?.id || options.portalId);
-        logger.label('Portal Name', portalDetails.portal?.name || 'N/A');
-        logger.label('Agent ID', agentDetails.id);
-        logger.label('Agent Name', agentDetails.name);
-        await portal.addAgentToPortal({
-            portalId: options.portalId,
-            id: options.agentId
-        });
-        logger.success('Agent added to the portal successfully');
-        if (options.dev) {
-            logger.warning('Environment: development');
+        const portalId = resolvePortalId(portalIdArg, options.portalId);
+        const agentId = resolveAgentId(options);
+        const client = await createPortalClient(options.dev);
+        const spinner = createSpinner('Attaching agent...').start();
+        const [portalRes, agentName] = await Promise.all([
+            client.portal.getPortal(portalId),
+            fetchAgentName(client, agentId, options.dev),
+        ]);
+        const portalName = portalRes?.portal?.name || portalId;
+        if (portalRes?.portal?.agents?.some(a => a.id === agentId)) {
+            spinner.info(`Agent "${agentName || agentId}" is already attached to portal "${portalName}"`);
+            if (isJsonMode())
+                printJson({ portalId, agentId, added: false, alreadyAttached: true });
+            return;
+        }
+        await client.portal.addAgentToPortal({ portalId, id: agentId });
+        spinner.succeed(`Agent "${agentName || agentId}" attached to portal "${portalName}"`);
+        if (isJsonMode()) {
+            printJson({ portalId, agentId, agentName: agentName ?? null, added: true });
+            return;
         }
+        console.log();
     }
     catch (error) {
-        const message = error instanceof Error ? error.message : 'Unknown error';
-        logger.error(message);
-        process.exit(1);
+        fail(error);
     }
 });
 addExamples(addAgentCommand, [
-    { description: 'Attach an existing agent to a portal',
-        command: 'plazbot portal add-agent-portal -p prt_AbcDef123 -a agt_AbcDef123' },
+    { description: 'Attach an agent to a portal', command: 'plazbot portal add-agent por_AbcDef123 -a age_AbcDef123' },
+    { description: 'Attach and get the result as JSON', command: 'plazbot portal add-agent por_AbcDef123 -a age_AbcDef123 --json' },
+]);
+addNotes(addAgentCommand, [
+    'The agent must already exist in the active workspace (plazbot agent list).',
+    'Old form still works: plazbot portal add-agent-portal -p <portalId> -a <agentId>.',
+]);
+export const removeAgentCommand = new Command('remove-agent')
+    .description('Detach an agent from a portal (the agent itself is not deleted)')
+    .argument('[portalId]', 'Portal ID (see plazbot portal list)')
+    .option('-a, --agent <agentId>', 'ID of the agent to detach')
+    .addOption(portalIdOption())
+    .addOption(new Option('--agent-id <agentId>', 'Alias of --agent').hideHelp())
+    .addOption(jsonOption())
+    .option('--dev', 'Use development environment', false);
+addYesOption(removeAgentCommand);
+removeAgentCommand.action(async (portalIdArg, options) => {
+    try {
+        const portalId = resolvePortalId(portalIdArg, options.portalId);
+        const agentId = resolveAgentId(options);
+        const client = await createPortalClient(options.dev);
+        const spinner = createSpinner('Loading portal...').start();
+        const portalRes = (await client.portal.getPortal(portalId));
+        spinner.stop();
+        const portalName = portalRes?.portal?.name || portalId;
+        const attached = portalRes?.portal?.agents?.find(a => a.id === agentId);
+        if (portalRes?.portal?.agents && !attached) {
+            throw new CliError(`Agent ${agentId} is not attached to portal "${portalName}".`, 'agent_not_attached', `See the attached agents with 'plazbot portal get ${portalId}'.`);
+        }
+        const agentLabel = attached?.name || agentId;
+        const ok = await confirmAction(`Detach agent "${agentLabel}" from portal "${portalName}"?`, options);
+        if (!ok) {
+            logger.dim('Aborted.');
+            process.exit(1);
+        }
+        const removing = createSpinner('Detaching agent...').start();
+        await client.portal.removeAgentFromPortal({ portalId, id: agentId });
+        removing.succeed(`Agent "${agentLabel}" detached from portal "${portalName}"`);
+        if (isJsonMode())
+            printJson({ portalId, agentId, removed: true });
+    }
+    catch (error) {
+        fail(error);
+    }
+});
+addExamples(removeAgentCommand, [
+    { description: 'Detach an agent from a portal (asks for confirmation)', command: 'plazbot portal remove-agent por_AbcDef123 -a age_AbcDef123' },
+    { description: 'Detach without confirmation (scripts and CI)', command: 'plazbot portal remove-agent por_AbcDef123 -a age_AbcDef123 --yes' },
 ]);

package/dist/commands/portal/add-link.js

@@ -1,38 +1,35 @@
 import { Command } from 'commander';
-import { Portal } from 'plazbot';
-import { getStoredCredentials } from '../../utils/credentials.js';
-import { logger } from '../../utils/logger.js';
 import { addExamples } from '../../utils/help.js';
+import { jsonOption, isJsonMode, printJson, fail, CliError } from '../../utils/output.js';
+import { createSpinner } from '../../utils/ui.js';
+import { createPortalClient, resolvePortalId, validateHttpUrl } from './shared.js';
 export const addLinkCommand = new Command('add-link')
-    .description('Add a link to the portal')
-    .argument('<portalId>', 'Portal ID')
-    .requiredOption('-t, --title <title>', 'Link title')
-    .requiredOption('-u, --url <url>', 'Link URL')
-    .option('--dev', 'Use development environment')
-    .action(async (portalId, options) => {
+    .description('Add a link to the portal navigation')
+    .argument('<portalId>', 'Portal ID (see plazbot portal list)')
+    .requiredOption('-t, --title <title>', 'Link text')
+    .requiredOption('-u, --url <url>', 'Link URL (http:// or https://)')
+    .addOption(jsonOption())
+    .option('--dev', 'Use development environment', false)
+    .action(async (portalIdArg, options) => {
     try {
-        const credentials = await getStoredCredentials();
-        const portal = new Portal({
-            workspaceId: credentials.workspace,
-            apiKey: credentials.apiKey,
-            zone: credentials.zone,
-            ...(options.dev && { customUrl: "http://localhost:5090" })
-        });
-        await portal.addLinkToPortal({
-            portalId,
-            value: options.title,
-            url: options.url
-        });
-        logger.success('Link added successfully');
+        const portalId = resolvePortalId(portalIdArg);
+        const title = options.title.trim();
+        if (!title)
+            throw new CliError('Link title cannot be empty.', 'missing_title', 'Pass it with -t, --title <title>.');
+        const url = validateHttpUrl(options.url, '--url');
+        const { portal } = await createPortalClient(options.dev);
+        const spinner = createSpinner('Adding link...').start();
+        await portal.addLinkToPortal({ portalId, value: title, url });
+        spinner.succeed(`Link "${title}" added`);
+        if (isJsonMode())
+            printJson({ portalId, title, url, added: true });
     }
     catch (error) {
-        logger.error(error.message);
-        process.exit(1);
+        fail(error);
     }
 });
 addExamples(addLinkCommand, [
-    { description: 'Add a documentation link to the portal',
-        command: 'plazbot portal add-link prt_AbcDef123 -t "Docs" -u https://docs.example.com' },
-    { description: 'Add a support link',
-        command: 'plazbot portal add-link prt_AbcDef123 -t "Contact us" -u https://example.com/contact' },
+    { description: 'Add a documentation link', command: 'plazbot portal add-link por_AbcDef123 -t "Docs" -u https://docs.example.com' },
+    { description: 'Add a contact link', command: 'plazbot portal add-link por_AbcDef123 -t "Contact us" -u https://example.com/contact' },
+    { description: 'Add a link and get the result as JSON', command: 'plazbot portal add-link por_AbcDef123 -t "Pricing" -u https://example.com/pricing --json' },
 ]);

package/dist/commands/portal/clear-links.js

@@ -1,30 +1,50 @@
 import { Command } from 'commander';
-import { Portal } from 'plazbot';
-import { getStoredCredentials } from '../../utils/credentials.js';
+import { addExamples, addNotes } from '../../utils/help.js';
+import { jsonOption, isJsonMode, printJson, fail } from '../../utils/output.js';
+import { addYesOption, confirmAction } from '../../utils/confirm.js';
+import { createSpinner } from '../../utils/ui.js';
 import { logger } from '../../utils/logger.js';
-import { addExamples } from '../../utils/help.js';
+import { createPortalClient, resolvePortalId } from './shared.js';
 export const clearLinksCommand = new Command('clear-links')
-    .description('Remove all links from the portal')
-    .argument('<portalId>', 'Portal ID')
-    .option('--dev', 'Use development environment')
-    .action(async (portalId, options) => {
+    .description('Remove every link from a portal')
+    .argument('<portalId>', 'Portal ID (see plazbot portal list)')
+    .addOption(jsonOption())
+    .option('--dev', 'Use development environment', false);
+addYesOption(clearLinksCommand);
+clearLinksCommand.action(async (portalIdArg, options) => {
     try {
-        const credentials = await getStoredCredentials();
-        const portal = new Portal({
-            workspaceId: credentials.workspace,
-            apiKey: credentials.apiKey,
-            zone: credentials.zone,
-            ...(options.dev && { customUrl: "http://localhost:5090" })
-        });
+        const portalId = resolvePortalId(portalIdArg);
+        const { portal } = await createPortalClient(options.dev);
+        const spinner = createSpinner('Loading portal...').start();
+        const response = (await portal.getPortal(portalId));
+        spinner.stop();
+        const name = response?.portal?.name || portalId;
+        const links = response?.portal?.links || [];
+        if (links.length === 0) {
+            logger.dim(`Portal "${name}" has no links. Nothing to remove.`);
+            if (isJsonMode())
+                printJson({ portalId, cleared: true, removed: 0 });
+            return;
+        }
+        const ok = await confirmAction(`Remove all ${links.length} link(s) from portal "${name}"?`, options);
+        if (!ok) {
+            logger.dim('Aborted.');
+            process.exit(1);
+        }
+        const clearing = createSpinner('Removing links...').start();
         await portal.clearLinks(portalId);
-        logger.success('Links removed successfully');
+        clearing.succeed(`Removed ${links.length} link(s) from portal "${name}"`);
+        if (isJsonMode())
+            printJson({ portalId, cleared: true, removed: links.length });
     }
     catch (error) {
-        logger.error(error.message);
-        process.exit(1);
+        fail(error);
     }
 });
 addExamples(clearLinksCommand, [
-    { description: 'Remove every link from a portal',
-        command: 'plazbot portal clear-links prt_AbcDef123' },
+    { description: 'Remove every link (asks for confirmation)', command: 'plazbot portal clear-links por_AbcDef123' },
+    { description: 'Remove every link without confirmation', command: 'plazbot portal clear-links por_AbcDef123 --yes' },
+]);
+addNotes(clearLinksCommand, [
+    'There is no command to remove a single link: clear them and add back the ones you want with add-link.',
 ]);

package/dist/commands/portal/create.js

@@ -1,51 +1,80 @@
 import { Command } from 'commander';
-import { Portal } from 'plazbot';
-import { getStoredCredentials } from '../../utils/credentials.js';
+import chalk from 'chalk';
+import { addExamples, addNotes } from '../../utils/help.js';
+import { jsonOption, isJsonMode, printJson, fail, CliError } from '../../utils/output.js';
+import { createSpinner } from '../../utils/ui.js';
 import { logger } from '../../utils/logger.js';
-import { addExamples } from '../../utils/help.js';
+import { createPortalClient, validateAccess, validateLogo } from './shared.js';
 export const createCommand = new Command('create')
-    .description('Create a new portal with a simplified configuration')
+    .description('Create the portal of the active workspace')
     .requiredOption('-n, --name <name>', 'Portal name')
-    .requiredOption('-t, --title <title>', 'Portal welcome title')
+    .requiredOption('-t, --title <title>', 'Welcome title shown on the portal')
+    .option('-s, --subtitle <subtitle>', 'Subtitle shown under the title')
+    .option('-l, --logo <url>', 'Logo URL (.png or .jpg)')
+    .option('-d, --logo-dark <url>', 'Dark-mode logo URL (.png or .jpg)')
+    .option('-a, --access <type>', 'Access type: direct (open) or form (asks for contact details first)', 'direct')
+    .addOption(jsonOption())
     .option('--dev', 'Use development environment', false)
     .action(async (options) => {
     try {
-        // Obtener credenciales guardadas
-        const credentials = await getStoredCredentials();
-        const portal = new Portal({
-            workspaceId: credentials.workspace,
-            apiKey: credentials.apiKey,
-            zone: credentials.zone,
-            ...(options.dev && { customUrl: "http://localhost:5090" })
-        });
-        const portalCreated = await portal.addPortal({
-            name: options.name,
-            title: options.title,
-            zone: credentials.zone,
-            subtitle: "",
-            logo: "",
-            logodark: "",
-            access: "direct",
-            disabled: false,
-            brandOff: false
-        });
-        logger.success('Portal created successfully');
-        logger.title('Portal details');
-        logger.label('ID', portalCreated.id);
-        logger.label('URL', portalCreated.url);
-        if (options.dev) {
-            logger.warning('\nEnvironment: development');
+        const name = options.name.trim();
+        const title = options.title.trim();
+        if (!name)
+            throw new CliError('Portal name is required.', 'missing_name', 'Pass it with -n, --name <name>.');
+        if (!title)
+            throw new CliError('Portal title is required.', 'missing_title', 'Pass it with -t, --title <title>.');
+        const access = validateAccess(options.access || 'direct');
+        const logo = options.logo ? validateLogo(options.logo, '--logo') : undefined;
+        const logodark = options.logoDark ? validateLogo(options.logoDark, '--logo-dark') : undefined;
+        const { portal, credentials } = await createPortalClient(options.dev);
+        const spinner = createSpinner('Creating portal...').start();
+        let created;
+        try {
+            created = await portal.addPortal({
+                name,
+                title,
+                zone: credentials.zone,
+                subtitle: options.subtitle?.trim() || '',
+                ...(logo && { logo }),
+                ...(logodark && { logodark }),
+                access,
+                disabled: false,
+                brandOff: false,
+            });
         }
+        catch (error) {
+            spinner.stop();
+            if (error instanceof Error && /only one portal/i.test(error.message)) {
+                throw new CliError('This workspace already has a portal (only one is allowed).', 'portal_exists', "See it with 'plazbot portal list' or change it with 'plazbot portal update <portalId>'.");
+            }
+            throw error;
+        }
+        spinner.succeed(`Portal "${name}" created`);
+        if (isJsonMode()) {
+            printJson({ id: created.id, url: created.url });
+            return;
+        }
+        logger.label('ID', created.id);
+        logger.label('URL', created.url);
+        console.log();
+        logger.dim(`Next: ${chalk.cyan(`plazbot portal add-agent ${created.id} -a <agentId>`)}`);
+        console.log();
     }
     catch (error) {
-        const message = error instanceof Error ? error.message : 'Unknown error while creating the portal';
-        logger.error(message);
-        process.exit(1);
+        fail(error);
     }
 });
 addExamples(createCommand, [
-    { description: 'Create a portal with name and welcome title',
-        command: 'plazbot portal create -n "Customer Portal" -t "Welcome to our help center"' },
-    { description: 'Create against the local backend',
-        command: 'plazbot portal create -n "Test" -t "Hello" --dev' },
+    { description: 'Create a portal with a name and welcome title',
+        command: 'plazbot portal create -n "Help Center" -t "How can we help you?"' },
+    { description: 'Create a portal with subtitle and logos',
+        command: 'plazbot portal create -n "Help Center" -t "Welcome" -s "Ask our AI agents" -l https://files.example.com/logo.png -d https://files.example.com/logo-dark.png' },
+    { description: 'Ask visitors for their details before chatting',
+        command: 'plazbot portal create -n "Support" -t "Welcome" -a form' },
+    { description: 'Create and capture the ID for scripts',
+        command: "plazbot portal create -n \"Help Center\" -t \"Welcome\" --json | jq -r '.id'" },
+]);
+addNotes(createCommand, [
+    'Only one portal per workspace is allowed.',
+    'Logos must be .png or .jpg, given as an https:// URL or a path starting with "/".',
 ]);

package/dist/commands/portal/delete.js

@@ -1,58 +1,53 @@
 import { Command } from 'commander';
-import { Portal } from 'plazbot';
-import { getStoredCredentials } from '../../utils/credentials.js';
+import { addExamples, addNotes } from '../../utils/help.js';
+import { jsonOption, isJsonMode, printJson, fail } from '../../utils/output.js';
+import { addYesOption, confirmAction } from '../../utils/confirm.js';
+import { createSpinner } from '../../utils/ui.js';
 import { logger } from '../../utils/logger.js';
-import { addExamples } from '../../utils/help.js';
-import inquirer from 'inquirer';
+import { createPortalClient, resolvePortalId } from './shared.js';
 export const deleteCommand = new Command('delete')
     .description('Delete a portal')
-    .argument('<portalId>', 'Portal ID')
-    .option('--force', 'Delete without confirmation', false)
-    .option('--dev', 'Use development environment', false)
-    .action(async (portalId, options) => {
+    .argument('<portalId>', 'Portal ID (see plazbot portal list)')
+    .addOption(jsonOption())
+    .option('--dev', 'Use development environment', false);
+addYesOption(deleteCommand);
+deleteCommand.action(async (portalIdArg, options) => {
     try {
-        // Obtener credenciales guardadas
-        const credentials = await getStoredCredentials();
-        const portal = new Portal({
-            workspaceId: credentials.workspace,
-            apiKey: credentials.apiKey,
-            zone: credentials.zone,
-            ...(options.dev && { customUrl: "http://localhost:5090" })
-        });
-        // Obtener detalles del portal para mostrar qué se va a eliminar
-        const portalDetails = await portal.getPortal(portalId);
-        logger.title('Portal to delete');
-        logger.label('ID', portalDetails.portal.id);
-        logger.label('Name', portalDetails.portal.name);
-        logger.label('URL', portalDetails.portal.url);
-        if (!options.force) {
-            const { confirm } = await inquirer.prompt([{
-                    type: 'confirm',
-                    name: 'confirm',
-                    message: 'Are you sure you want to delete this portal?',
-                    default: false
-                }]);
-            if (!confirm) {
-                logger.info('Operation cancelled.');
-                return;
-            }
+        const portalId = resolvePortalId(portalIdArg);
+        const { portal } = await createPortalClient(options.dev);
+        const spinner = createSpinner('Loading portal...').start();
+        const response = (await portal.getPortal(portalId));
+        spinner.stop();
+        const details = response.portal;
+        const name = details?.name || portalId;
+        if (!isJsonMode()) {
+            logger.title('Portal to delete');
+            logger.label('ID', details?.id || portalId);
+            logger.label('Name', name);
+            if (details?.url)
+                logger.label('URL', details.url);
+            console.log();
         }
-        logger.dim('Deleting portal...');
-        await portal.deletePortal(portalId);
-        logger.success('Portal deleted successfully');
-        if (options.dev) {
-            logger.warning('\nEnvironment: development');
+        const ok = await confirmAction(`Delete portal "${name}"? Its public URL will stop working.`, options);
+        if (!ok) {
+            logger.dim('Aborted.');
+            process.exit(1);
         }
+        const deleting = createSpinner('Deleting portal...').start();
+        await portal.deletePortal(portalId);
+        deleting.succeed(`Portal "${name}" deleted`);
+        if (isJsonMode())
+            printJson({ id: portalId, deleted: true });
     }
     catch (error) {
-        const message = error instanceof Error ? error.message : 'Unknown error while deleting the portal';
-        logger.error(message);
-        process.exit(1);
+        fail(error);
     }
 });
 addExamples(deleteCommand, [
-    { description: 'Delete a portal with confirmation prompt',
-        command: 'plazbot portal delete prt_AbcDef123' },
-    { description: 'Delete without confirmation (use in scripts)',
-        command: 'plazbot portal delete prt_AbcDef123 --force' },
+    { description: 'Delete a portal (asks for confirmation)', command: 'plazbot portal delete por_AbcDef123' },
+    { description: 'Delete without confirmation (scripts and CI)', command: 'plazbot portal delete por_AbcDef123 --yes' },
+    { description: 'Delete and get the result as JSON', command: 'plazbot portal delete por_AbcDef123 --yes --json' },
+]);
+addNotes(deleteCommand, [
+    'This cannot be undone. Agents attached to the portal are not deleted.',
 ]);

package/dist/commands/portal/get.js

@@ -1,66 +1,33 @@
 import { Command } from 'commander';
-import { Portal } from 'plazbot';
-import { getStoredCredentials } from '../../utils/credentials.js';
-import { logger } from '../../utils/logger.js';
 import { addExamples } from '../../utils/help.js';
+import { jsonOption, isJsonMode, printJson, fail } from '../../utils/output.js';
+import { createSpinner } from '../../utils/ui.js';
+import { createPortalClient, printPortalDetails, resolvePortalId } from './shared.js';
 export const getCommand = new Command('get')
-    .description('Show detailed information for a portal')
-    .argument('<portalId>', 'Portal ID')
+    .description('Show the details of a portal (settings, links and agents)')
+    .argument('<portalId>', 'Portal ID (see plazbot portal list)')
+    .addOption(jsonOption())
     .option('--dev', 'Use development environment', false)
-    .action(async (portalId, options) => {
+    .action(async (portalIdArg, options) => {
     try {
-        // Obtener credenciales guardadas
-        const credentials = await getStoredCredentials();
-        const portal = new Portal({
-            workspaceId: credentials.workspace,
-            apiKey: credentials.apiKey,
-            zone: credentials.zone,
-            ...(options.dev && { customUrl: "http://localhost:5090" })
-        });
-        const response = await portal.getPortal(portalId);
-        const portalDetails = response.portal;
-        logger.title('Portal details');
-        logger.label('ID', portalDetails.id);
-        logger.label('Name', portalDetails.name);
-        logger.label('URL', portalDetails.url);
-        logger.label('Access', portalDetails.access);
-        logger.label('Status', portalDetails.disabled ? 'Disabled' : 'Enabled');
-        if (portalDetails.title) {
-            logger.label('Title', portalDetails.title);
-        }
-        if (portalDetails.subtitle) {
-            logger.label('Subtitle', portalDetails.subtitle);
-        }
-        if (portalDetails.logo) {
-            logger.title('Assets');
-            logger.label('Logo', portalDetails.logo);
-            if (portalDetails.logodark) {
-                logger.label('Logo (dark mode)', portalDetails.logodark);
-            }
-        }
-        if (portalDetails.links && portalDetails.links.length > 0) {
-            logger.title('Links');
-            portalDetails.links.forEach((link) => {
-                logger.label(link.value, link.url);
-            });
-        }
-        if (portalDetails.agents && portalDetails.agents.length > 0) {
-            logger.title('Associated agents');
-            portalDetails.agents.forEach((agent) => {
-                logger.label(agent.name, agent.id);
-            });
-        }
-        if (options.dev) {
-            logger.warning('\nEnvironment: development');
+        const portalId = resolvePortalId(portalIdArg);
+        const { portal } = await createPortalClient(options.dev);
+        const spinner = createSpinner('Loading portal...').start();
+        const response = (await portal.getPortal(portalId));
+        spinner.stop();
+        if (isJsonMode()) {
+            printJson(response.portal);
+            return;
         }
+        printPortalDetails(response.portal, 'Portal details');
+        console.log();
     }
     catch (error) {
-        const message = error instanceof Error ? error.message : 'Unknown error while fetching portal details';
-        logger.error(message);
-        process.exit(1);
+        fail(error);
     }
 });
 addExamples(getCommand, [
-    { description: 'Show details for a specific portal',
-        command: 'plazbot portal get prt_AbcDef123' },
+    { description: 'Show the details of a portal', command: 'plazbot portal get por_AbcDef123' },
+    { description: 'Get the portal as JSON', command: 'plazbot portal get por_AbcDef123 --json' },
+    { description: 'List the agents attached to the portal', command: "plazbot portal get por_AbcDef123 --json | jq '.agents'" },
 ]);