chatboxai/chatbox · error

Resource contains a duplicate storage key: ${resource.id}

Error message

Resource contains a duplicate storage key: ${resource.id}

What it means

Thrown when a single resource's originalStorageKeys array contains the same key more than once. originalStorageKeys lists where the resource bytes live in storage; intra-resource duplicates imply a packing bug.

Source

Thrown at src/renderer/packages/backup/types.ts:107

  }),
})
export type BackupManifest = z.infer<typeof BackupManifestSchema>

export function validateBackupManifestGraph(manifest: BackupManifest): void {
  const resourceIds = new Set<string>()
  const resourceKeys = new Set<string>()
  const sessionIds = new Set<string>()
  for (const session of manifest.sessions) {
    if (sessionIds.has(session.id)) throw new Error(`Duplicate session id in manifest: ${session.id}`)
    sessionIds.add(session.id)
    if (session.meta.id !== session.id) throw new Error(`Session metadata id does not match: ${session.id}`)
  }
  for (const resource of manifest.resources) {
    if (resourceIds.has(resource.id)) throw new Error(`Duplicate resource id in manifest: ${resource.id}`)
    resourceIds.add(resource.id)
    const ownResourceKeys = new Set<string>()
    for (const key of resource.originalStorageKeys) {
      if (ownResourceKeys.has(key)) throw new Error(`Resource contains a duplicate storage key: ${resource.id}`)
      ownResourceKeys.add(key)
      if (resourceKeys.has(key)) throw new Error(`Duplicate resource storage key in manifest: ${key}`)
      resourceKeys.add(key)
    }
    const ownSessionIds = new Set<string>()
    for (const sessionId of resource.sessionIds) {
      if (ownSessionIds.has(sessionId)) throw new Error(`Resource contains a duplicate session id: ${resource.id}`)
      ownSessionIds.add(sessionId)
      if (!sessionIds.has(sessionId)) throw new Error(`Resource references an unknown session: ${sessionId}`)
    }
    if (resource.scope === 'session' && resource.sessionIds.length !== 1) {
      throw new Error(`Session-scoped resource must reference exactly one session: ${resource.id}`)
    }
    if (resource.scope === 'global' && resource.sessionIds.length !== 0) {
      throw new Error(`Global resource must not reference a session: ${resource.id}`)
    }
  }
  const resourcesById = new Map(manifest.resources.map((resource) => [resource.id, resource]))

View on GitHub (pinned to 81571269ad)

Solutions

  1. Dedupe originalStorageKeys within each resource before validation.
  2. Re-export the resource.
  3. Audit the exporter's key-collection loop.

Example fix

// before
validateBackupManifestGraph(manifest)

// after
for (const r of manifest.resources) {
  r.originalStorageKeys = [...new Set(r.originalStorageKeys)]
}
Defensive patterns

Strategy: validation

Validate before calling

function resourcesHaveUniqueStorageKeysLocally(manifest: BackupManifest): boolean {
  return manifest.resources.every((r) => new Set(r.originalStorageKeys).size === r.originalStorageKeys.length)
}

Try / catch

try {
  validateBackupManifestGraph(manifest)
} catch (error) {
  if (/duplicate storage key/.test((error as Error).message)) dedupeLocalStorageKeys(manifest)
  throw error
}

Prevention

When it happens

Trigger: resource.originalStorageKeys has a repeated string within one resource entry.

Common situations: Exporter appended the same storage key twice; hand-edited manifest; naive concatenation of key lists.

Related errors


AI-assisted analysis of chatboxai/chatbox@81571269ad (2026-08-12). Data as JSON: /api/errors/c9c9af634fb2af3c. Report an issue: GitHub.