Yeachan-Heo/oh-my-codex · error · Error

catalog_manifest_invalid:agents[${index}].status

Error message

catalog_manifest_invalid:agents[${index}].status

What it means

agents[i].status must be one of active|alias|merged|deprecated|internal. This error fires when the status is a string but not in that set — the same status vocabulary used for skills.

Source

Thrown at src/catalog/schema.ts:102

      status: entry.status as CatalogEntryStatus,
      canonical,
      core: entry.core === true,
      internalRequired: entry.internalRequired === true,
    };
  });

  const seenAgents = new Set<string>();
  const agents: CatalogAgentEntry[] = input.agents.map((entry, index) => {
    if (!isObject(entry)) throw new Error(`catalog_manifest_invalid:agents[${index}]`);
    assertNonEmptyString(entry.name, `agents[${index}].name`);
    assertNonEmptyString(entry.category, `agents[${index}].category`);
    assertNonEmptyString(entry.status, `agents[${index}].status`);

    if (!AGENT_CATEGORIES.has(entry.category as CatalogAgentCategory)) {
      throw new Error(`catalog_manifest_invalid:agents[${index}].category`);
    }
    if (!ENTRY_STATUSES.has(entry.status as CatalogEntryStatus)) {
      throw new Error(`catalog_manifest_invalid:agents[${index}].status`);
    }

    const name = entry.name.trim();
    if (seenAgents.has(name)) throw new Error(`catalog_manifest_invalid:duplicate_agent:${name}`);
    seenAgents.add(name);

    const canonical = typeof entry.canonical === 'string' && entry.canonical.trim() !== ''
      ? entry.canonical.trim()
      : undefined;

    if ((entry.status === 'alias' || entry.status === 'merged') && !canonical) {
      throw new Error(`catalog_manifest_invalid:agents[${index}].canonical`);
    }

    return {
      name,
      category: entry.category as CatalogAgentCategory,
      status: entry.status as CatalogEntryStatus,

View on GitHub (pinned to 3ad79a8a6f)

Solutions

1. Set status to one of active, alias, merged, deprecated, internal
2. Add canonical when using alias/merged
3. Regenerate the manifest

Example fix

// before
{ "name": "builder", "category": "build", "status": "enabled" }

// after
{ "name": "builder", "category": "build", "status": "active" }

const STATUSES = new Set(['active','alias','merged','deprecated','internal']);
if (!raw.agents.every((a: any) => STATUSES.has(a?.status))) { /* fix statuses */ }

function isEntryStatus(v: unknown): v is 'active'|'alias'|'merged'|'deprecated'|'internal' {
  return typeof v === 'string' && ['active','alias','merged','deprecated','internal'].includes(v);
}

When it happens

Trigger: An agent entry with status "enabled", "off", or "Active" (case-sensitive).

Common situations: Statuses invented during hand-editing, or generator/validator version drift.

Understand the failure class

Background: Invalid enum value errors: "Unknown type", "Invalid scope", "must be one of" — when a string is not on the library's allowed list — this error's family across 23 libraries.

Related errors

• catalog_manifest_invalid:agents[${index}].category
• catalog_manifest_invalid:skills[${index}].category
• catalog_manifest_invalid:skills[${index}].status
• catalog_manifest_invalid:agents[${index}]
• catalog_manifest_invalid:duplicate_agent:${name}

AI-assisted analysis of Yeachan-Heo/oh-my-codex@3ad79a8a6f (2026-08-27). Data as JSON: /api/errors/f0ed69b440e2c8c4. Report an issue: GitHub.