Data e Hora

Mayros usa por padrão horário local do host para timestamps de transporte e fuso horário do usuário apenas no prompt do sistema. Timestamps do provedor são preservados para que as ferramentas mantenham sua semântica nativa (o horário atual está disponível via session_status).

Envelopes de mensagem (local por padrão)

Mensagens recebidas são envolvidas com um timestamp (precisão de minuto):

[Provider ... 2026-01-05 16:26 PST] texto da mensagem

Este timestamp do envelope é local do host por padrão, independentemente do fuso horário do provedor.

Você pode substituir este comportamento:

json5
{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | fuso horário IANA
      envelopeTimestamp: "on", // "on" | "off"
      envelopeElapsed: "on", // "on" | "off"
    },
  },
}
  • envelopeTimezone: "utc" usa UTC.
  • envelopeTimezone: "local" usa o fuso horário do host.
  • envelopeTimezone: "user" usa agents.defaults.userTimezone (retorna ao fuso horário do host).
  • Use um fuso horário IANA explícito (por exemplo, "America/Chicago") para uma zona fixa.
  • envelopeTimestamp: "off" remove timestamps absolutos dos cabeçalhos de envelope.
  • envelopeElapsed: "off" remove sufixos de tempo decorrido (estilo +2m).

Exemplos

Local (padrão):

[WhatsApp +1555 2026-01-18 00:19 PST] olá

Fuso horário do usuário:

[WhatsApp +1555 2026-01-18 00:19 CST] olá

Tempo decorrido habilitado:

[WhatsApp +1555 +30s 2026-01-18T05:19Z] acompanhamento

Prompt do sistema: Data e Hora Atual

Se o fuso horário do usuário for conhecido, o prompt do sistema inclui uma seção dedicada Data e Hora Atual com apenas o fuso horário (sem formato de relógio/hora) para manter o cache do prompt estável:

Time zone: America/Chicago

Quando o agente precisar do horário atual, use a ferramenta session_status; o cartão de status inclui uma linha de timestamp.

Linhas de eventos do sistema (local por padrão)

Eventos do sistema enfileirados inseridos no contexto do agente são prefixados com um timestamp usando a mesma seleção de fuso horário que os envelopes de mensagem (padrão: local do host).

System: [2026-01-12 12:19:17 PST] Modelo alternado.

Configurar fuso horário + formato do usuário

json5
{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
      timeFormat: "auto", // auto | 12 | 24
    },
  },
}
  • userTimezone define o fuso horário local do usuário para o contexto do prompt.
  • timeFormat controla exibição 12h/24h no prompt. auto segue as preferências do sistema operacional.

Detecção de formato de hora (auto)

Quando timeFormat: "auto", Mayros inspeciona a preferência do sistema operacional (macOS/Windows) e retorna à formatação de localidade. O valor detectado é cacheado por processo para evitar chamadas repetidas ao sistema.

Payloads de ferramentas + conectores (tempo bruto do provedor + campos normalizados)

Ferramentas de canal retornam timestamps nativos do provedor e adicionam campos normalizados para consistência:

  • timestampMs: milissegundos de época (UTC)
  • timestampUtc: string UTC ISO 8601

Campos brutos do provedor são preservados para que nada seja perdido.

  • Slack: strings tipo época da API
  • Discord: timestamps ISO UTC
  • Telegram/WhatsApp: timestamps numéricos/ISO específicos do provedor

Se você precisar do horário local, converta-o downstream usando o fuso horário conhecido.

Documentação relacionada