reflect

Faça uma prévia antes de alterar a memória

Use dry_run=true para inspecionar as cinco ações de reflexão liberadas, suas contagens e os detalhes candidatos antes de permitir uma gravação de resumo, promoção, expiração, decaimento ou arquivamento.

Ferramenta MCP pública

reflect

Finalidade

Execute uma etapa limitada de manutenção de Dream/Reflection que informa decisões de consolidação e do ciclo de vida da memória, aplicando opcionalmente as gravações selecionadas.

Quando usar

Um operador autorizado ou worker de manutenção precisa resumir memórias episódicas recentes em registros semânticos de reflexão.
Você precisa inspecionar evidências episódicas repetidas antes de decidir se elas devem se tornar um fato semântico duradouro.
Você precisa de uma etapa explícita e limitada de expiração, decaimento de importância ou arquivamento sobre um limite autorizado de owner/equipe/escopo.

Quando NÃO usar

Não use para um fato duradouro solicitado por um usuário comum; use remember ou um auxiliar de captura do SDK.
Não use como ferramenta geral de busca, recuperação de contexto ou exclusão física; use recall_context, search_memory ou a superfície governada de forget.
Não omita dry_run quando o chamador estiver apenas avaliando candidatos ou não estiver explicitamente autorizado a alterar a memória.
Não descreva esta ferramenta como o design mais amplo de Dream Light/REM/Deep nem como um agendador autônomo; a superfície publicada contém somente estas cinco ações.

Escopo necessário

dry_run=true exige memory:read; uma execução de gravação exige memory:write.
O catálogo classifica reflect como uma superfície interna de manutenção, não como uma ferramenta mínima de aplicativo de marketplace público. Use-a somente por um contexto autorizado de manutenção ou MCP direto.
Owner, bucket, escopo, equipe, bound-space e autorização do agente são resolvidos pelo servidor; filtros do chamador não podem ampliar esse limite.

Parâmetros

Nome	Tipo	Descrição
`actions_csv`	string · padrão: summarize,promote,expire,decay,archive	Ações separadas por vírgula. As ações publicadas são summarize, promote, expire, decay e archive; aliases como summary, promotion, expiry e importance_decay são normalizados pelo compactor.
`dry_run`	boolean · padrão: false	Quando true, calcula candidatos e contagens sem gravações de consolidação ou do ciclo de vida; prefira-o para revisão.
`time_window_hours`	number · padrão: 24.0	Janela positiva de consulta retroativa para seleção episódica de summarize/promote; since a substitui quando fornecido.
`since / until`	string · padrão: empty	Limites ISO 8601 opcionais para a janela de reflexão; timestamps malformados são rejeitados.
`path_filter / owner_filter`	string · padrão: % / authenticated owner	Filtros de caminho lógico e proprietário. O servidor resolve o filtro de proprietário no contexto autenticado.
`bucket / scope / team_id`	string · padrão: % / empty / empty	Filtros opcionais de limite da memória; um team_id explícito precisa corresponder ao contexto de equipe vinculado/autenticado.
`limit`	integer · padrão: 500	Orçamento máximo de candidatos passado ao compactor; a implementação o limita ao intervalo compatível.

Esquema de retorno

O compactor monta um relatório com dry_run, ações normalizadas, filtros, resumos, promoções, detalhes do ciclo de vida, counts.summarized/promoted/expired/decayed/archived e audit_record_ids. A resposta de texto MCP começa com '### Memory Reflect Report' e renderiza Dry Run, Actions, as cinco contagens, Audit Records e até os primeiros 20 Audit IDs.

Exemplos

Faça uma prévia de uma etapa completa de manutenção

reflect({
  actions_csv: "summarize,promote,expire,decay,archive",
  dry_run: true,
  time_window_hours: 24,
  limit: 500
})

Aplique uma ação de ciclo de vida explicitamente autorizada

reflect({
  actions_csv: "archive",
  dry_run: false,
  bucket: "personal",
  limit: 100
})

Erros

401/403: o chamador não possui escopo de leitura para dry_run ou escopo de gravação para uma execução mutável, ou o owner/equipe/bound space solicitado não é autorizado.
Falha de validação: uma ação não é compatível, time_window_hours não é positivo, since/until não está em ISO 8601 ou um valor de limite/paginação é inválido.
Falha de autorização de equipe: uma alteração do ciclo de vida de uma equipe não autorizada é rejeitada, em vez de ser aplicada silenciosamente.
Falha de concorrência ou auditoria: uma memória alterada, uma transição de status incompleta ou uma auditoria de consolidação com falha é revertida ou informada como erro.

recall_context — Leia um pacote de contexto limitado antes de decidir se a manutenção é necessária.
remember — Persista um fato duradouro explicitamente solicitado sem executar uma etapa de consolidação.
search_memory — Pesquise memórias autorizadas quando precisar de recuperação, não de manutenção do ciclo de vida.

Origem: Dream / Reflection