# PAT-0150 — Interface Mismatch

## Ontology Metadata

Code: PAT-0150
Version: PAT-0150@0.1.0
Ontology release: 0.1.0
Updated: 2026-05-10T00:00:00Z
Canonical URL: /workbench/patterns/interface-mismatch/

## Summary

A structural condition where observed interface behavior, shape, or exchange differs from the declared interface contract.

## Primary Lenses

- LEN-0200 — Interface Contract Lens
  - URL: /workbench/lenses/interface-contract-lens/
  - Summary: Compares declared interface structure to observed runtime structure to detect contract deviations.

## Secondary Lenses

- LEN-0230 — Normalization Lens
  - URL: /workbench/lenses/normalization-lens/
  - Summary: Transforms structurally equivalent variants into a canonical form to prevent false divergence.

## Primary Issue Matches

- ISS-0017 — Tool Call Contract Mismatch
  - URL: /workbench/issues/tool-call-contract-mismatch/
  - Summary: The AI or agent calls a tool with names, arguments, types, modes, or shapes that do not match the declared tool interface.

## Supporting Issue Matches

- ISS-0087 — Agent Cannot Choose Tool Without Tool Result
  - URL: /workbench/issues/agent-cannot-choose-tool-without-tool-result/
  - Summary: The agent needs a tool result to choose the right tool, but cannot obtain that result without choosing a tool first.
- ISS-0115 — Agent Gets Conflicting Tool Authority
  - URL: /workbench/issues/agent-gets-conflicting-tool-authority/
  - Summary: An agent receives conflicting authority signals about whether, when, or how it may use a tool, connector, function, or integration.
- ISS-0026 — AI Output Breaks Parser
  - URL: /workbench/issues/ai-output-breaks-parser/
  - Summary: The AI output causes a parser, validator, importer, or structured-output consumer to fail.
- ISS-0003 — Citation Points to Wrong Source
  - URL: /workbench/issues/citation-points-to-wrong-source/
  - Summary: A citation, reference, link, or source pointer is present, but it points to the wrong source, wrong passage, wrong document, or unsupported evidence.
- ISS-0021 — Invalid JSON Output
  - URL: /workbench/issues/invalid-json-output/
  - Summary: The AI returns malformed JSON or structured output that cannot be parsed.
- ISS-0038 — Model and Workflow Disagree on Next Step
  - URL: /workbench/issues/model-and-workflow-disagree-on-next-step/
  - Summary: The AI model recommends or selects a next step that conflicts with the workflow state, required handoff, routing rule, or process sequence.
- ISS-0025 — Nested Fields Do Not Match
  - URL: /workbench/issues/nested-fields-do-not-match/
  - Summary: The AI returns nested structured fields whose internal shape, hierarchy, parent-child relationship, or contained values do not match the expected structure.
- ISS-0018 — Output Breaks the Next Step
  - URL: /workbench/issues/output-breaks-the-next-step/
  - Summary: The AI output looks acceptable by itself but cannot be used by the next tool, workflow step, parser, reviewer, or downstream consumer.
- ISS-0054 — Prompt Changed but Workflow Did Not
  - URL: /workbench/issues/prompt-changed-but-workflow-did-not/
  - Summary: A prompt changes but the workflow, parser, review step, routing rule, or downstream expectation still assumes the old prompt behavior.
- ISS-0057 — Same Contract Name Has Different Meanings
  - URL: /workbench/issues/same-contract-name-has-different-meanings/
  - Summary: The same prompt, schema, field, policy, tool, or workflow contract name is used in different places with different meanings.
- ISS-0108 — Tool Can Act Without Responsible Authority
  - URL: /workbench/issues/tool-can-act-without-responsible-authority/
  - Summary: A tool, connector, function, or integration can perform an action without a declared responsible authority for that action.
- ISS-0020 — Tool Exists but Required Inputs Are Missing
  - URL: /workbench/issues/tool-exists-but-required-inputs-are-missing/
  - Summary: A usable tool or integration exists, but the AI or agent does not have the required inputs, permissions, fields, identifiers, or context needed to call it correctly.
- ISS-0019 — Tool Result Not Integrated Correctly
  - URL: /workbench/issues/tool-result-not-integrated-correctly/
  - Summary: The AI receives a tool result but misreads, ignores, overwrites, misplaces, or fails to incorporate it correctly into the final output or workflow state.
- ISS-0110 — Tool Rules and Prompt Rules Conflict
  - URL: /workbench/issues/tool-rules-and-prompt-rules-conflict/
  - Summary: Tool, connector, function, or MCP rules conflict with prompt instructions, causing the AI or agent to face incompatible requirements.
- ISS-0024 — Wrong Field Types
  - URL: /workbench/issues/wrong-field-types/
  - Summary: The AI returns fields with values whose types do not match the expected schema, such as strings where numbers, booleans, arrays, objects, or enums are required.