ruvnet/ruflo · error

Failed to convert AgentDB entry to bead: ${entry.key}

Error message

Failed to convert AgentDB entry to bead: ${entry.key}

What it means

Log warning in syncFromAgentDB: converting an individual AgentDB entry to a bead (agentDBToBead) threw; that entry is skipped and the paginated sync continues with the rest.

Source

Thrown at v3/plugins/gastown-bridge/src/bridges/sync-bridge.ts:529

          offset
        );

        if (entries.length === 0) {
          hasMore = false;
          continue;
        }

        for (const entry of entries) {
          // Skip sync state entry
          if (entry.key === '_sync_state') continue;

          try {
            const bead = this.agentDBToBead(entry);
            if (bead) {
              beads.push(bead);
            }
          } catch (error) {
            this.logger.warn(`Failed to convert AgentDB entry to bead: ${entry.key}`, {
              error: error instanceof Error ? error.message : String(error),
            });
          }
        }

        offset += entries.length;
        hasMore = entries.length === this.config.batchSize;
      }

      // Update sync state
      this.syncState.lastSyncTime = new Date().toISOString();
      await this.saveSyncState();

      const durationMs = Date.now() - startTime;
      this.logger.info('Sync from AgentDB complete', {
        beads: beads.length,
        durationMs,
      });

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Check the AgentDB entry named in the message for missing/invalid fields; fix the entry shape so it maps to a bead.

When it happens

Trigger: Thrown at v3/plugins/gastown-bridge/src/bridges/sync-bridge.ts:529 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of ruvnet/ruflo@fa13ee4ad6 (2026-08-18). Data as JSON: /api/errors/a4bba716e6180a29. Report an issue: GitHub.