Method hello

src/proxy/lifecycle/manager.js:755–920

({ rotateSecret = false } = {})

  }

  async hello({ rotateSecret = false } = {}) {
    if (!this.hubUrl) return { ok: false, error: 'no_hub_url' };

    if (this._helloRateLimitUntil > Date.now()) {
      const waitSec = Math.ceil((this._helloRateLimitUntil - Date.now()) / 1000);
      this.logger.warn(`[lifecycle] hello suppressed: rate limited for ${waitSec}s`);
      return { ok: false, error: 'hello_rate_limit_active', waitSec };
    }

    const waitMs = this._hubUnreachableWaitMs();
    if (waitMs > 0) {
      return {
        ok: false,
        error: 'hub_unreachable_backoff',
        retryAfterMs: waitMs,
      };
    }

    const endpoint = `${this.hubUrl}/a2a/hello`;
    const nodeId = this.store.getState('node_id')
      || _readLegacyNodeId()
      || `node_${crypto.randomBytes(6).toString('hex')}`;

    const payload = { capabilities: {} };
    if (rotateSecret) payload.rotate_secret = true;

    const fp = _getEnvFingerprint();

    const body = {
      ...buildEnvelope('hello', payload, nodeId),
      env_fingerprint: fp,
    };

    try {
      const res = await hubFetch(endpoint, {
        method: 'POST',
        headers: this._buildHeaders(),
        body: JSON.stringify(body),
        signal: AbortSignal.timeout(HELLO_TIMEOUT),
      });
      await throwIfHubUnreachableResponse(res, 'lifecycle hello');
      this._recordHubReachable();
      if (!res.ok) {
        const errText = await readHubResponseText(res).catch(() => '');
        let errData = {};
        try { errData = errText ? JSON.parse(errText) : {}; } catch (_) { /* non-JSON API error */ }
        const errMsg = safeHubErrorCode(errData, res.status);
        if (res.status === 429) {
          const retryAfter = parseInt(res.headers.get('retry-after') || '3600', 10);
          this._helloRateLimitUntil = Date.now() + retryAfter * 1000;
          this.logger.error(`[lifecycle] hello rate limited (429): retry after ${retryAfter}s`);
          return { ok: false, error: 'hello_rate_limited', retryAfter };
        }
        const divergenceReason = (res.status === 401 || res.status === 403)
          ? extractSecretDivergenceReason(errData)
          : null;
        if (divergenceReason) {
          this.logger.warn(