@pellux/goodvibes-agent 0.1.56 → 0.1.57

package/src/input/handler-onboarding-cloudflare.ts

@@ -1,322 +0,0 @@
-import {
-  CloudflareDaemonRouteError,
-  createCloudflareDaemonClient,
-  type CloudflareComponentSelection,
-  type CloudflareDaemonClient,
-  type CloudflareDiscoverResult,
-  type CloudflareTokenRequirementsResult,
-  type CloudflareValidateResult,
-  type CloudflareVerifyResult,
-} from '../runtime/cloudflare-control-plane.ts';
-import type { OnboardingVerificationItem } from '../runtime/onboarding/index.ts';
-import type { InputHandler } from './handler.ts';
-import type { OnboardingWizardAction, OnboardingWizardApplyFeedback } from './onboarding/onboarding-wizard.ts';
-import {
-  buildCloudflareApiTokenRef,
-  getCloudflareBatchMode,
-  getCloudflareComponentSelection,
-  getCloudflareSetupSource,
-  shouldShowCloudflareStep,
-} from './onboarding/onboarding-wizard-cloudflare.ts';
-
-type CloudflareOnboardingAction = Extract<OnboardingWizardAction,
-  | 'cloudflare-token-requirements'
-  | 'cloudflare-create-operational-token'
-  | 'cloudflare-discover'
-  | 'cloudflare-validate'
-  | 'cloudflare-provision'
-  | 'cloudflare-verify'
-  | 'cloudflare-disable'
->;
-
-function getCloudflareDaemonClientForHandler(handler: InputHandler): CloudflareDaemonClient {
-  return createCloudflareDaemonClient({
-    configManager: handler.uiServices.platform.configManager,
-    homeDirectory: handler.uiServices.environment.homeDirectory,
-  });
-}
-
-function normalizeCloudflareActionError(error: unknown): string {
-  if (error instanceof CloudflareDaemonRouteError) {
-    return `${error.message} (HTTP ${error.status}, ${error.code})`;
-  }
-  return error instanceof Error ? error.message : String(error);
-}
-
-function setCloudflareWizardStatusForHandler(
-  handler: InputHandler,
-  title: string,
-  lines: readonly string[],
-  severity: OnboardingWizardApplyFeedback['severity'] = 'info',
-): void {
-  const message = [title, ...lines].filter((line) => line.length > 0).join('\n');
-  handler.onboardingWizard.textState.set('cloudflare.action-status', message);
-  handler.onboardingWizard.setApplyFeedback({
-    severity,
-    title,
-    summary: lines[0] ?? title,
-    messages: lines.length > 0 ? lines : [title],
-  });
-  const targetIndex = handler.onboardingWizard.steps.findIndex((step) => step.id === 'cloudflare');
-  if (targetIndex >= 0) handler.onboardingWizard.setStep(targetIndex);
-  handler.commandContext?.print?.(message);
-  handler.requestRender();
-}
-
-function formatCloudflareComponents(components: CloudflareComponentSelection): string {
-  const enabled = Object.entries(components)
-    .filter(([, selected]) => selected === true)
-    .map(([component]) => component);
-  return enabled.length > 0 ? enabled.join(', ') : 'none';
-}
-
-function formatCloudflareRequirements(result: CloudflareTokenRequirementsResult): string[] {
-  const permissionLines = result.permissions.length > 0
-    ? result.permissions.map((permission) => `  ${permission.scope}: ${permission.permission} (${permission.component}) - ${permission.reason}`)
-    : ['  No permissions returned for the selected components.'];
-  return [
-    `components: ${formatCloudflareComponents(result.components)}`,
-    'required permissions:',
-    ...permissionLines,
-    ...(result.bootstrapToken.instructions.length > 0
-      ? ['', 'bootstrap token instructions:', ...result.bootstrapToken.instructions.map((line) => `  ${line}`)]
-      : []),
-  ];
-}
-
-function formatCloudflareValidation(result: CloudflareValidateResult): string[] {
-  return [
-    `token: ${result.ok ? 'valid' : 'not valid'}`,
-    `source: ${result.tokenSource}`,
-    result.account
-      ? `account: ${result.account.name} (${result.account.id})`
-      : 'account: not resolved',
-  ];
-}
-
-function formatCloudflareDiscovery(result: CloudflareDiscoverResult): string[] {
-  return [
-    `token source: ${result.tokenSource}`,
-    `accounts: ${result.accounts.length}`,
-    `zones: ${result.zones.length}`,
-    `worker subdomain: ${result.workerSubdomain || 'not detected'}`,
-    `queues: ${result.queues?.length ?? 0}`,
-    `KV namespaces: ${result.kvNamespaces?.length ?? 0}`,
-    `R2 buckets: ${result.r2Buckets?.length ?? 0}`,
-    ...(result.selectedAccount ? [`selected account: ${result.selectedAccount.name} (${result.selectedAccount.id})`] : []),
-    ...(result.selectedZone ? [`selected zone: ${result.selectedZone.name} (${result.selectedZone.id})`] : []),
-    ...result.warnings.map((warning) => `warning: ${warning}`),
-  ];
-}
-
-function formatCloudflareVerify(result: CloudflareVerifyResult): string[] {
-  return [
-    `worker health: ${result.workerHealth.ok ? 'ok' : 'failed'} (HTTP ${result.workerHealth.status})${result.workerHealth.error ? ` - ${result.workerHealth.error}` : ''}`,
-    ...(result.daemonBatchProxy
-      ? [`daemon batch proxy: ${result.daemonBatchProxy.ok ? 'ok' : 'failed'} (HTTP ${result.daemonBatchProxy.status})${result.daemonBatchProxy.error ? ` - ${result.daemonBatchProxy.error}` : ''}`]
-      : []),
-  ];
-}
-
-function getCloudflareBootstrapTokenFromWizard(handler: InputHandler): string {
-  const wizard = handler.onboardingWizard;
-  const setupSource = getCloudflareSetupSource(wizard);
-  if (setupSource === 'bootstrap-token') {
-    return wizard.getStringFieldValue('cloudflare.bootstrap-token', '');
-  }
-  if (setupSource === 'bootstrap-env') {
-    const envName = wizard.getStringFieldValue('cloudflare.bootstrap-env-name', 'GOODVIBES_CLOUDFLARE_BOOTSTRAP_TOKEN');
-    return process.env[envName] ?? '';
-  }
-  return '';
-}
-
-function getCloudflareOperationalTokenFromWizard(handler: InputHandler): string {
-  const wizard = handler.onboardingWizard;
-  return getCloudflareSetupSource(wizard) === 'operational-token'
-    ? wizard.getStringFieldValue('cloudflare.operational-token', '')
-    : '';
-}
-
-function getCloudflareApiTokenRefFromWizard(handler: InputHandler): string {
-  const wizard = handler.onboardingWizard;
-  const setupSource = getCloudflareSetupSource(wizard);
-  if (setupSource === 'operational-env') {
-    return buildCloudflareApiTokenRef(wizard.getStringFieldValue('cloudflare.operational-env-name', 'CLOUDFLARE_API_TOKEN'));
-  }
-  return wizard.runtimeSnapshot?.config.cloudflare.apiTokenRef ?? '';
-}
-
-function buildCloudflareDiscoveryInputForHandler(handler: InputHandler): Parameters<CloudflareDaemonClient['discover']>[0] {
-  const wizard = handler.onboardingWizard;
-  const accountId = wizard.getStringFieldValue('cloudflare.account-id', wizard.runtimeSnapshot?.config.cloudflare.accountId ?? '');
-  const zoneId = wizard.getStringFieldValue('cloudflare.zone-id', wizard.runtimeSnapshot?.config.cloudflare.zoneId ?? '');
-  const zoneName = wizard.getStringFieldValue('cloudflare.zone-name', wizard.runtimeSnapshot?.config.cloudflare.zoneName ?? '');
-  const bootstrapToken = getCloudflareBootstrapTokenFromWizard(handler);
-  const apiToken = getCloudflareOperationalTokenFromWizard(handler) || bootstrapToken;
-  const apiTokenRef = getCloudflareApiTokenRefFromWizard(handler);
-  return {
-    components: getCloudflareComponentSelection(wizard),
-    includeResources: true,
-    ...(accountId ? { accountId } : {}),
-    ...(zoneId ? { zoneId } : {}),
-    ...(zoneName ? { zoneName } : {}),
-    ...(apiToken ? { apiToken } : apiTokenRef ? { apiTokenRef } : {}),
-  };
-}
-
-function blockedCloudflareMutationLines(action: CloudflareOnboardingAction): string[] {
-  switch (action) {
-    case 'cloudflare-create-operational-token':
-      return [
-        'Creating and storing Cloudflare tokens is a side-effecting operation.',
-        'Run /cloudflare create-token [flags] --yes from the main prompt when you explicitly want that mutation.',
-      ];
-    case 'cloudflare-provision':
-      return [
-        'Provisioning creates or updates Cloudflare resources.',
-        'Run /cloudflare provision [flags] --yes from the main prompt when you explicitly want that mutation.',
-      ];
-    case 'cloudflare-disable':
-      return [
-        'Disabling Cloudflare changes persisted daemon integration config.',
-        'Run /cloudflare disable [flags] --yes from the main prompt when you explicitly want that mutation.',
-      ];
-    default:
-      return [];
-  }
-}
-
-function isBlockedCloudflareMutation(action: CloudflareOnboardingAction): boolean {
-  return action === 'cloudflare-create-operational-token'
-    || action === 'cloudflare-provision'
-    || action === 'cloudflare-disable';
-}
-
-function buildCloudflareValidateInputForHandler(handler: InputHandler): Parameters<CloudflareDaemonClient['validate']>[0] {
-  const wizard = handler.onboardingWizard;
-  const accountId = wizard.getStringFieldValue('cloudflare.account-id', wizard.runtimeSnapshot?.config.cloudflare.accountId ?? '');
-  const bootstrapToken = getCloudflareBootstrapTokenFromWizard(handler);
-  const apiToken = getCloudflareOperationalTokenFromWizard(handler) || bootstrapToken;
-  const apiTokenRef = getCloudflareApiTokenRefFromWizard(handler);
-  return {
-    ...(accountId ? { accountId } : {}),
-    ...(apiToken ? { apiToken } : apiTokenRef ? { apiTokenRef } : {}),
-  };
-}
-
-export async function handleCloudflareOnboardingActionForHandler(
-  handler: InputHandler,
-  action: CloudflareOnboardingAction,
-): Promise<void> {
-  if (handler.onboardingApplyPending) return;
-  handler.onboardingApplyPending = true;
-  handler.onboardingWizard.clearApplyFeedback();
-  handler.requestRender();
-  try {
-    if (isBlockedCloudflareMutation(action)) {
-      setCloudflareWizardStatusForHandler(
-        handler,
-        'Cloudflare mutation requires explicit command',
-        blockedCloudflareMutationLines(action),
-        'warning',
-      );
-      return;
-    }
-
-    const client = getCloudflareDaemonClientForHandler(handler);
-    if (action === 'cloudflare-token-requirements') {
-      const result = await client.tokenRequirements({
-        components: getCloudflareComponentSelection(handler.onboardingWizard),
-        includeBootstrap: true,
-      });
-      setCloudflareWizardStatusForHandler(handler, 'Cloudflare token requirements', formatCloudflareRequirements(result));
-      return;
-    }
-
-    if (action === 'cloudflare-discover') {
-      const result = await client.discover(buildCloudflareDiscoveryInputForHandler(handler));
-      if (result.selectedAccount && !handler.onboardingWizard.getStringFieldValue('cloudflare.account-id', '')) {
-        handler.onboardingWizard.setFieldValue('cloudflare.account-id', result.selectedAccount.id);
-      } else if (result.accounts.length === 1 && !handler.onboardingWizard.getStringFieldValue('cloudflare.account-id', '')) {
-        handler.onboardingWizard.setFieldValue('cloudflare.account-id', result.accounts[0]!.id);
-      }
-      if (result.selectedZone && !handler.onboardingWizard.getStringFieldValue('cloudflare.zone-id', '')) {
-        handler.onboardingWizard.setFieldValue('cloudflare.zone-id', result.selectedZone.id);
-        handler.onboardingWizard.setFieldValue('cloudflare.zone-name', result.selectedZone.name);
-      } else if (result.zones.length === 1 && !handler.onboardingWizard.getStringFieldValue('cloudflare.zone-id', '')) {
-        handler.onboardingWizard.setFieldValue('cloudflare.zone-id', result.zones[0]!.id);
-        handler.onboardingWizard.setFieldValue('cloudflare.zone-name', result.zones[0]!.name);
-      }
-      if (result.workerSubdomain && !handler.onboardingWizard.getStringFieldValue('cloudflare.worker-subdomain', '')) {
-        handler.onboardingWizard.setFieldValue('cloudflare.worker-subdomain', result.workerSubdomain);
-      }
-      setCloudflareWizardStatusForHandler(handler, 'Cloudflare discovery completed', formatCloudflareDiscovery(result));
-      return;
-    }
-
-    if (action === 'cloudflare-validate') {
-      const result = await client.validate(buildCloudflareValidateInputForHandler(handler));
-      setCloudflareWizardStatusForHandler(
-        handler,
-        result.ok ? 'Cloudflare token validated' : 'Cloudflare token validation needs attention',
-        formatCloudflareValidation(result),
-        result.ok ? 'info' : 'warning',
-      );
-      return;
-    }
-
-    if (action === 'cloudflare-verify') {
-      const result = await client.verify({
-        workerBaseUrl: handler.onboardingWizard.getStringFieldValue('cloudflare.worker-base-url', handler.onboardingWizard.runtimeSnapshot?.config.cloudflare.workerBaseUrl ?? ''),
-        workerClientTokenRef: handler.onboardingWizard.runtimeSnapshot?.config.cloudflare.workerClientTokenRef ?? '',
-      });
-      setCloudflareWizardStatusForHandler(
-        handler,
-        result.ok ? 'Cloudflare Worker verified' : 'Cloudflare Worker verification needs attention',
-        formatCloudflareVerify(result),
-        result.ok ? 'info' : 'warning',
-      );
-      return;
-    }
-  } catch (error) {
-    setCloudflareWizardStatusForHandler(handler, 'Cloudflare action failed', [normalizeCloudflareActionError(error)], 'error');
-  } finally {
-    handler.onboardingApplyPending = false;
-    handler.requestRender();
-  }
-}
-
-export async function maybeProvisionCloudflareOnFinalApplyForHandler(handler: InputHandler): Promise<readonly OnboardingVerificationItem[]> {
-  const wizard = handler.onboardingWizard;
-  if (!shouldShowCloudflareStep(wizard)) return [];
-  const cloudflareEnabled = wizard.getBooleanFieldValue('cloudflare.enabled', wizard.isCapabilitySelected('cloudflare-batch') || wizard.runtimeSnapshot?.config.cloudflare.enabled === true);
-  if (!cloudflareEnabled) {
-    return [{
-      id: 'cloudflare:disabled',
-      status: 'pass',
-      message: 'Cloudflare integration is disabled; local daemon behavior remains active.',
-      target: 'cloudflare',
-    }];
-  }
-  const provisionOnApply = wizard.getStringFieldValue('cloudflare.provision-on-apply', 'no') === 'yes';
-  if (!provisionOnApply) {
-    return [{
-      id: 'cloudflare:configuration-saved',
-      status: 'pass',
-      message: `Cloudflare settings were saved. Batch mode is ${getCloudflareBatchMode(wizard)}; provisioning was not requested on final apply.`,
-      target: 'cloudflare',
-    }];
-  }
-
-  handler.onboardingWizard.textState.set('cloudflare.action-status', [
-    'Cloudflare provisioning was not run during final apply.',
-    'GoodVibes Agent requires an explicit /cloudflare provision [flags] --yes command for Cloudflare resource mutations.',
-  ].join('\n'));
-  return [{
-    id: 'cloudflare:provision',
-    status: 'warn',
-    message: 'Cloudflare settings were saved, but provisioning was blocked because Agent onboarding cannot create/update Cloudflare resources. Run /cloudflare provision [flags] --yes explicitly.',
-    target: 'cloudflare',
-  }];
-}

package/src/input/onboarding/onboarding-runtime-status.ts

@@ -1,87 +0,0 @@
-import type { HostServiceStatus } from '@/runtime/index.ts';
-
-export interface OnboardingExternalServiceState {
-  readonly daemonRunning?: boolean;
-  readonly daemonPortInUse?: boolean;
-  readonly httpListenerRunning?: boolean;
-  readonly httpListenerPortInUse?: boolean;
-  readonly daemonStatus?: HostServiceStatus;
-  readonly httpListenerStatus?: HostServiceStatus;
-}
-
-export type OnboardingRuntimeEndpoint = 'daemon' | 'httpListener';
-
-export function runtimePortDiagnostic(
-  binding: { readonly label: string; readonly host: string; readonly port: number },
-  portInUse: boolean | undefined,
-  status?: HostServiceStatus,
-): string {
-  if (status) {
-    const reason = status.reason ? ` ${status.reason}` : '';
-    if (status.mode === 'blocked') {
-      return `The configured endpoint ${status.baseUrl} is occupied but was not usable by this Agent instance.${reason}`;
-    }
-    if (status.mode === 'disabled') {
-      return `The configured endpoint ${status.baseUrl} is disabled in the runtime service configuration.${reason}`;
-    }
-    if (status.mode === 'unavailable') {
-      return `The configured endpoint ${status.baseUrl} is unavailable to Agent.${reason}`;
-    }
-    if (status.mode === 'external') {
-      const version = status.version ? ` version ${status.version}` : '';
-      return `An existing GoodVibes service was verified at ${status.baseUrl}${version}.`;
-    }
-    return `A GoodVibes service reports embedded mode at ${status.baseUrl}; Agent still treats daemon lifecycle as external.`;
-  }
-  if (portInUse) {
-    return `The configured port ${binding.host}:${binding.port} is occupied; another GoodVibes process or another service may own it.`;
-  }
-  return `No process is listening on ${binding.host}:${binding.port}.`;
-}
-
-export function getRuntimeEndpointStatus(
-  state: OnboardingExternalServiceState | undefined,
-  endpoint: OnboardingRuntimeEndpoint,
-): HostServiceStatus | undefined {
-  return endpoint === 'daemon' ? state?.daemonStatus : state?.httpListenerStatus;
-}
-
-export function isRuntimeEndpointActive(
-  state: OnboardingExternalServiceState | undefined,
-  endpoint: OnboardingRuntimeEndpoint,
-): boolean {
-  const status = getRuntimeEndpointStatus(state, endpoint);
-  if (status) return status.mode === 'embedded' || status.mode === 'external';
-  return endpoint === 'daemon'
-    ? state?.daemonRunning === true
-    : state?.httpListenerRunning === true;
-}
-
-export function isRuntimeEndpointOccupyingConfiguredPort(
-  state: OnboardingExternalServiceState | undefined,
-  endpoint: OnboardingRuntimeEndpoint,
-): boolean {
-  const status = getRuntimeEndpointStatus(state, endpoint);
-  if (status) return status.mode === 'embedded' || status.mode === 'external' || status.mode === 'blocked';
-  return endpoint === 'daemon'
-    ? state?.daemonRunning === true || state?.daemonPortInUse === true
-    : state?.httpListenerRunning === true || state?.httpListenerPortInUse === true;
-}
-
-export function formatRuntimeActiveSuccessMessage(
-  endpoint: OnboardingRuntimeEndpoint,
-  state: OnboardingExternalServiceState | undefined,
-): string {
-  const status = getRuntimeEndpointStatus(state, endpoint);
-  const label = endpoint === 'daemon' ? 'GoodVibes daemon' : 'HTTP listener';
-  if (status?.mode === 'external') {
-    const version = status.version ? ` version ${status.version}` : '';
-    return `${label} is already running as a verified external GoodVibes service at ${status.baseUrl}${version}.`;
-  }
-  if (status?.mode === 'embedded') {
-    return `${label} reports embedded mode at ${status.baseUrl}; Agent does not own that service lifecycle.`;
-  }
-  return endpoint === 'daemon'
-    ? 'The GoodVibes daemon is reachable to Agent.'
-    : 'The HTTP listener is reachable to Agent.';
-}