langgenius/dify · error · Error

Missing referenced schema: ${refName}

Error message

Missing referenced schema: ${refName}

What it means

Error "Missing referenced schema: ${refName}" thrown in langgenius/dify.

Source

Thrown at packages/contracts/openapi-ts.api.config.ts:320

const selectReferencedSchemas = (
  schemas: Record<string, SwaggerSchema>,
  paths: Record<string, Record<string, unknown>>,
) => {
  const selectedSchemas: Record<string, SwaggerSchema> = {}
  const pendingRefs = new Set<string>()
  collectSchemaRefs(paths, pendingRefs)

  while (pendingRefs.size > 0) {
    const refName = pendingRefs.values().next().value
    if (!refName) break

    pendingRefs.delete(refName)

    if (selectedSchemas[refName]) continue

    const schema = schemas[refName]
    if (!schema) throw new Error(`Missing referenced schema: ${refName}`)

    selectedSchemas[refName] = schema

    const nestedRefs = new Set<string>()
    collectSchemaRefs(selectedSchemas[refName], nestedRefs)
    for (const nestedRef of nestedRefs) {
      if (!selectedSchemas[nestedRef]) pendingRefs.add(nestedRef)
    }
  }

  return selectedSchemas
}

const cloneDocumentWithPaths = (
  document: SwaggerDocument,
  paths: Record<string, Record<string, unknown>>,
) => {
  const { components: _components, paths: _paths, ...metadata } = document

View on GitHub (pinned to ef8544b173)

When it happens

Trigger: Thrown at packages/contracts/openapi-ts.api.config.ts:320 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of langgenius/dify@ef8544b173 (2026-08-12). Data as JSON: /api/errors/49bb2fe2d77f1a2b. Report an issue: GitHub.