schema_version: 3
provider: fai
name: llm-chat
version: 0.1.0

# Capability provided by this module.
provides:
  - capability: llm.chat
    version: 0.1.0

# Declared inputs in verbose v3 form. Studio renders the
# description in the active locale as a tooltip on each
# port; the editor falls back to the English description
# when no peer is configured.
inputs:
  prompt:
    type: text
    description:
      en: The user-facing prompt text the model should respond to.
      de: Der vom Modell zu beantwortende Prompt-Text.
  endpoint:
    type: text
    description:
      en: |
        Ollama-shaped /api/chat endpoint, e.g.
        "http://localhost:11434/api/chat".
      de: |
        Ollama-kompatibler /api/chat-Endpunkt, z. B.
        "http://localhost:11434/api/chat".
  model:
    type: text
    description:
      en: Model identifier as registered with the endpoint, e.g. "qwen2.5:14b" or "llama3.1:8b".
      de: Modell-Identifier wie beim Endpunkt registriert, z. B. "qwen2.5:14b" oder "llama3.1:8b".
  api_key:
    type: text
    description:
      en: |
        Optional bearer token for cloud-hosted endpoints.
        Empty string means no Authorization header is sent.
      de: |
        Optionaler Bearer-Token für Cloud-Endpunkte.
        Leer = kein Authorization-Header gesendet.
  system_prompt:
    type: text
    description:
      en: |
        Optional system prompt. Empty string omits the system
        message and lets the model use its built-in default.
      de: |
        Optionaler System-Prompt. Leer = das Modell verwendet
        seinen eingebauten Default.

# Outputs produced.
outputs:
  response:
    type: text
    description:
      en: The assistant's plain-text reply.
      de: Die Klartext-Antwort des Modells.
  model_endpoint:
    type: text
    description:
      en: The endpoint the response was generated against. Used for audit correlation.
      de: Der Endpunkt, gegen den die Antwort erzeugt wurde — für Audit-Korrelation.
  model_name:
    type: text
    description:
      en: The model identifier as supplied to the LLM API.
      de: Der an die LLM-API übergebene Modell-Identifier.
  model_digest:
    type: text
    description:
      en: |
        SHA-256 digest of the served Ollama model, when reachable.
        Empty for non-Ollama endpoints (OpenAI / Anthropic do not
        expose a digest API). Together with model_endpoint and
        model_name this answers the audit question "which exact
        model produced this response?"
      de: |
        SHA-256-Digest des bedienten Ollama-Modells, wenn erreichbar.
        Leer für Nicht-Ollama-Endpunkte (OpenAI / Anthropic stellen
        keine Digest-API bereit). Zusammen mit model_endpoint und
        model_name beantwortet das die Audit-Frage "welches genaue
        Modell hat diese Antwort erzeugt?"

# Permissions required.
#
# The module makes outbound HTTP to the configured endpoint.
# Default declarations cover loopback (Ollama) and the common
# cloud providers. Operators with different endpoints fork
# module.yaml in Phase 0.5; operator-config-driven permission
# overrides arrive in Phase 1+.
permissions:
  - "net: localhost"
  - "net: 127.0.0.1"
  - "net: api.openai.com"
  - "net: api.anthropic.com"