Skip to content

Garry's Opinionated OpenClaw/Hermes Agent Brain

TypeScript
4.1 KB
Raw Blame
/**
 * commands/connectors/status.ts — `gbrain connectors status [provider] [--json]`.
 *
 * Reuses the `connectors_status` op handler shape via the same helpers, but runs
 * locally (trusted). Never prints the raw cookie/token — only provenance,
 * expiry, and sync state. `unresolved` lists conversations the source has not
 * archived yet (#6387): attempts, next retry, and whether only a `--full` sync
 * can retry them.
 */

import type { BrainEngine } from '../../core/engine.ts';
import { setCliExitVerdict } from '../../core/cli-force-exit.ts';
import { connectorProviders, getConnectorProvider } from '../../core/connectors/registry.ts';
import { credentialMode, resolveApiToken, resolveCredential } from '../../core/connectors/credentials.ts';
import { isTokenProviderName } from '../../core/connectors/types.ts';
import {
  authErrorAtKey,
  autoSyncKey,
  isTruthy,
  readConnectorState,
  sourceIdKey,
} from '../../core/connectors/config-keys.ts';
import { fullSyncArgv, readFailedLedger } from '../../core/connectors/failed-ledger.ts';

export async function runConnectorStatus(engine: BrainEngine, args: string[]): Promise<void> {
  const json = args.includes('--json');
  const only = args.find((a) => !a.startsWith('-'));
  if (only && isTokenProviderName(only)) {
    const key = resolveApiToken(only);
    const row = { provider: only, credential_present: !!key, credential_source: key?.source ?? null, credential_file_mode: credentialMode(only) };
    if (json) console.log(JSON.stringify({ providers: [row] }, null, 2));
    else console.log(key ? `${only}  credential: ${key.source}` : `${only}  no credential (gbrain connectors auth ${only} --token -)`);
    if (!key) setCliExitVerdict(1);
    return;
  }
  const providers = only
    ? [getConnectorProvider(only)].filter(Boolean)
    : [...connectorProviders];
  if (only && providers.length === 0) {
    console.error(`Unknown provider: ${only}`);
    setCliExitVerdict(1);
    return;
  }

  const rows = [];
  const sourceId = (await engine.getConfig(sourceIdKey())) || 'default';
  for (const prov of providers) {
    if (!prov) continue;
    const resolved = resolveCredential(prov.name);
    const unresolved = Object.entries(await readFailedLedger(engine, prov.name, sourceId)).map(([id, e]) => ({
      id,
      attempts: e.attempts,
      updated_at: e.updatedAt,
      next_retry_at: e.nextRetryAt ?? null,
      ...(e.code ? { code: e.code } : {}),
      needs_full_sync: !!prov.routesByOrg && !e.orgId,
    }));
    rows.push({
      provider: prov.name,
      strategies: prov.strategies,
      spec_target_status: prov.specTarget.status,
      credential_present: !!resolved,
      credential_source: resolved?.source ?? null,
      credential_file_mode: credentialMode(prov.name),
      token_expires_at: resolved?.cred.expiresAt ?? null,
      auto_sync: isTruthy(await engine.getConfig(autoSyncKey(prov.name))),
      source_id: sourceId,
      last_sync_at: await readConnectorState(engine, prov.name, sourceId, 'last_sync_at'),
      auth_error_at: (await engine.getConfig(authErrorAtKey(prov.name))) || null,
      watermark_iso: await readConnectorState(engine, prov.name, sourceId, 'watermark_iso'),
      unresolved,
    });
  }

  if (json) {
    console.log(JSON.stringify({ providers: rows }, null, 2));
    return;
  }

  for (const r of rows) {
    const cred = r.credential_present ? `credential: ${r.credential_source}` : 'no credential';
    const auth = r.auth_error_at ? `  ⚠ auth error at ${r.auth_error_at} (re-auth)` : '';
    console.log(
      `${r.provider}  [${r.spec_target_status}]  ${cred}  auto_sync=${r.auto_sync}\n` +
        `  last_sync: ${r.last_sync_at ?? 'never'}  watermark: ${r.watermark_iso ?? 'none'}${auth}`,
    );
    if (r.unresolved.length === 0) continue;
    const needsFull = r.unresolved.filter((u) => u.needs_full_sync).length;
    console.log(
      `  ⚠ archive incomplete: ${r.unresolved.length} conversation(s) not archived yet; sync retries them automatically` +
        (needsFull ? `; ${needsFull} need one full re-sync (re-downloads the whole history; ask first): ${fullSyncArgv(r.provider, r.source_id).join(' ')}` : ''),
    );
  }
}