conductor-oss/conductor · error · Error

Agent Card response did not contain agentCard

Error message

Agent Card response did not contain agentCard

What it means

Error "Agent Card response did not contain agentCard" thrown in conductor-oss/conductor.

Source

Thrown at ui-next/src/utils/agentMetadata.ts:204

        : "";
    const definition = (await fetchJson(
      `/agent/definitions/${encodeURIComponent(identity)}${version}`,
    )) as AgentWorkflowDefinition;
    return buildConductorAgentSnapshot(input, definition);
  }

  const inputRecord = input as unknown as Record<string, unknown>;
  const cardRequest = {
    agentType: "a2a",
    agentUrl: identity,
    ...(isRecord(inputRecord.headers) ? { headers: inputRecord.headers } : {}),
  };
  const response = (await fetchJson("/a2a/agent-card", {
    method: "POST",
    body: JSON.stringify(cardRequest),
  })) as { agentCard?: A2AAgentCard };
  if (!response?.agentCard) {
    throw new Error("Agent Card response did not contain agentCard");
  }
  return buildA2AAgentSnapshot(input, response.agentCard);
}

const childTaskLists = (task: TaskDef): TaskDef[][] => {
  const lists: TaskDef[][] = [];
  if (task.decisionCases) lists.push(...Object.values(task.decisionCases));
  if (task.defaultCase) lists.push(task.defaultCase);
  if (task.forkTasks) lists.push(...task.forkTasks);
  if (task.loopOver) lists.push(task.loopOver);
  return lists;
};

/**
 * Refresh stale static AGENT snapshots immediately before registration. Resolution is best effort:
 * a failed remote discovery leaves an explicit unresolved snapshot and never blocks workflow save.
 */
export async function resolveAgentSnapshotsInWorkflow(

View on GitHub (pinned to cf7c3e4a8a)

Solutions

1. Check that the /a2a/agent-card endpoint is returning a JSON body with an agentCard field for the requested agentUrl.
2. Verify the target A2A agent publishes a valid agent card at its well-known URL.
3. Confirm agentType is 'a2a' and agentUrl is reachable; an empty or malformed response yields this error.

When it happens

Trigger: Thrown at ui-next/src/utils/agentMetadata.ts:204 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of conductor-oss/conductor@cf7c3e4a8a (2026-08-14). Data as JSON: /api/errors/652af506d7b73b15. Report an issue: GitHub.