Class IntentError

constructor

• new IntentError(options: IntentErrorOptions): IntentError

  Creates a new IntentError instance.

  Parameters

  • options: IntentErrorOptions

    Intent error construction options including field name and SAP domain context for the failing operation.

  Returns IntentError

  Example

  import { IntentError } from '#core/errors/intent-error.js';
  
  const error = new IntentError({
    message: 'Field selector not resolved: supplier',
    attempted: 'Fill field via vocabulary: supplier',
    fieldName: 'supplier',
    sapDomain: 'procurement',
    suggestions: [
      'Verify the field name exists in vocabulary/domains/procurement.json',
      'Provide a custom selector via options.selectors',
    ],
  });
  Copy

ReadonlyfieldName

ReadonlysapDomain

toAIContext

• toAIContext(): AIErrorContext & {
      fieldName: string
      | undefined;
      sapDomain: string | undefined;
  }

  Returns AI-agent-friendly context with intent-specific diagnostic fields.

  Returns AIErrorContext & {
      fieldName: string | undefined;
      sapDomain: string | undefined;
  }

  Base AI context extended with field name and SAP domain details.

  Example

  const ctx = error.toAIContext();
  // LLM can use ctx.fieldName to look up vocabulary alternatives
  // and ctx.sapDomain to narrow the search scope
  Copy

toJSON

• toJSON(): SerializedPramanError & {
      fieldName: string
      | undefined;
      sapDomain: string | undefined;
  }

  Serializes this error to a JSON-safe object with intent-specific fields.

  Returns SerializedPramanError & {
      fieldName: string | undefined;
      sapDomain: string | undefined;
  }

  Base serialization extended with fieldName and sapDomain.

  Example

  const json = error.toJSON();
  console.log(json.fieldName); // 'supplier'
  console.log(json.sapDomain); // 'procurement'
  Copy