schema_version: 3
provider: fai
name: text-translate
version: 0.1.0

provides:
  - capability: text.translate
    version: 0.1.0

inputs:
  text:
    type: text
    description:
      en: Source text to translate.
      de: Quelltext, der übersetzt werden soll.
  target_language:
    type: text
    description:
      en: |
        Target language name in plain English (e.g. "German",
        "French", "ja-JP" — anything the configured LLM
        understands).
      de: |
        Zielsprache in Klartext (z. B. "German", "French",
        "ja-JP" — alles was das konfigurierte LLM versteht).
  source_language:
    type: text
    description:
      en: |
        Optional source language hint. Empty = let the model
        auto-detect.
      de: |
        Optionaler Hinweis zur Quellsprache. Leer = das Modell
        erkennt sie selbst.
  endpoint:
    type: text
    description:
      en: Ollama-shaped /api/chat endpoint.
      de: Ollama-kompatibler /api/chat-Endpunkt.
  model:
    type: text
    description:
      en: Model identifier (e.g. "qwen2.5:14b").
      de: Modell-Identifier (z. B. "qwen2.5:14b").
  api_key:
    type: text
    description:
      en: Optional bearer token for cloud-hosted endpoints.
      de: Optionaler Bearer-Token für Cloud-Endpunkte.

outputs:
  translation:
    type: text
    description:
      en: The translated text.
      de: Der übersetzte Text.
  source_language:
    type: text
    description:
      en: Echo of the source-language input for downstream audit.
      de: Echo des source_language-Inputs für Downstream-Audit.
  target_language:
    type: text
    description:
      en: Echo of the target-language input.
      de: Echo des target_language-Inputs.
  model_endpoint:
    type: text
    description:
      en: Endpoint the translation was generated against.
      de: Endpunkt, gegen den die Übersetzung erzeugt wurde.
  model_name:
    type: text
    description:
      en: Model identifier as supplied to the LLM API.
      de: An die LLM-API übergebenes Modell.
  model_digest:
    type: text
    description:
      en: SHA-256 digest of the served Ollama model (when reachable).
      de: SHA-256-Digest des bedienten Ollama-Modells (wenn erreichbar).

permissions:
  - "net: localhost"
  - "net: 127.0.0.1"
  - "net: api.openai.com"
  - "net: api.anthropic.com"