Desenvolvedores

A arquitetura da Alethoryn parte de contratos explícitos. Modelos podem raciocinar sobre o contexto; somente capacidades declaradas, autoridade válida e componentes responsáveis pelo efeito podem alterar um sistema de negócio.

Esta página descreve o que já possui contrato técnico verificável e separa protocolo efetivo, candidata de evolução, serviço submetido e disponibilidade comercial. O estágio público atual é DEMONSTRATION; isso não significa aprovação OpenAI, publicação em diretório, ativação de cliente ou LIVE.

Princípios de integração

1. O sistema de origem continua soberano. O adapter normaliza diferenças sem transformar a Alethoryn em um segundo ERP.
2. Capacidade não é autoridade. Descobrir que uma operação existe não concede permissão para executá-la.
3. Autoridade é verificada por ato. Sessão, conversa, modelo ou ferramenta não criam autoridade por associação.
4. Recibo não é resultado. Execução técnica e observação do efeito possuem contratos diferentes.
5. Incerteza falha fechada. Um possível efeito externo sem resposta exige reconciliação, não repetição automática.
6. Dados ausentes permanecem ausentes. NOT_SUPPORTED, UNAVAILABLE, REDACTED, nulo e coleção vazia não são equivalentes.

Semantic MCP V1

O Semantic MCP V1 é uma superfície host-neutral e somente leitura. Ela entrega fatos canônicos, métricas determinísticas, escopo, frescor, proveniência, paginação e emissão de auditoria para que um host externo faça o raciocínio.

Ela não gera narrativa, não invoca LLM, não expõe SQL ou CRUD genérico e não possui caminho de escrita, aprovação ou despacho.

Catálogo de leitura

Ferramenta	O que retorna
get_business_capabilities	domínios, métricas e dimensões realmente disponíveis ao escopo autorizado
get_business_snapshot	resumo determinístico de métricas autorizadas e mudanças no período
get_metric	uma métrica registrada, com fórmula e dimensões suportadas
get_sales	fatos canônicos de vendas e agregações permitidas
get_inventory	posições observadas de estoque e risco informado pela origem
get_receivables	recebíveis e estado de vencimento derivado de forma determinística
get_entity	uma entidade canônica autorizada
find_entities	descoberta tipada e paginada de entidades
get_recent_changes	mudanças canônicas dentro de uma janela temporal limitada

As nove ferramentas fazem leituras de negócio determinísticas, não destrutivas e sem efeito no sistema de origem. Como cada chamada cria registros privados de auditoria e capacidade, os hints submetidos são readOnlyHint=false e idempotentHint=false. Uma mudança observada não concede autoridade de efeito.

Semântica da resposta

Uma resposta material bem-sucedida carrega:

• versão do schema e da ferramenta;
• escopo de organização e unidade de negócio quando aplicável;
• disponibilidade, frescor, cobertura e lacunas;
• proveniência e referências opacas de evidência;
• identificador de correlação;
• paginação quando necessária.

Valores monetários usam representação decimal exata. Mistura de moedas ou unidades falha fechada; dados ausentes não são preenchidos com zero.

Public MCP e identidade

O chamador não escolhe tenant, principal, papel ou grant em um argumento de ferramenta. A autoridade de leitura é resolvida pelo servidor e revalidada a cada chamada; expiração, revogação, troca de vínculo ou substituição de escopo são recusadas antes da leitura canônica.

O Public MCP V1 materializa esse limite em um host externo: https://mcp.alethoryn.com/mcp. O app registrado usa OAuth Authorization Code com PKCE S256 via Descope. Uma jornada real no ChatGPT foi observada historicamente, e os metadados OAuth públicos foram observados novamente em 2026-09-01. A configuração privada atual e a jornada autenticada não foram relidas nessa observação recente.

O app Alethoryn versão 1.0.0 foi submetido à OpenAI em 2026-09-01. Seu estado público normalizado é SUBMITTED_AWAITING_REVIEW. Como o portal não foi relido, a necessidade atual de ressubmissão é UNKNOWN_NOT_READ_BACK; ressubmissão autônoma não é autorizada. Submissão não prova aprovação nem publicação no diretório.

Public API, SDK e conformidade

O contrato de protocolo Public API V1 da Slice 7 está aprovado, publicado e efetivo para o subject exato. Isso não torna o runtime operacional. A evolução corrente é a candidata Slice 8, PROPOSED_NON_AUTHORITY, sem transferência da autoridade histórica da Slice 7.

Os SDKs candidatos gerados para Python e TypeScript estão na versão 0.1.1 e vinculados à Slice 8; isso não prova publicação em registries. A suíte de conformidade 0.8.0 declara 32 casos e é RUNNABLE_NON_CERTIFYING: um resultado verde não emite certificação.

Limites do estágio DEMONSTRATION

• aprovação ou publicação do app no diretório OpenAI;
• publicação dos SDKs em registries;
• catálogo de conectores certificados;
• adapter de produção para dados de cliente;
• caminho MCP de escrita ou execução;
• SLA, ambiente produtivo ou ativação LIVE.

Planos, packs, preços, descontos, prospecção, venda e negociação contratual podem avançar em qualquer estágio. A alegação de entrega continua limitada pelo estágio real, e uma venda não promove automaticamente disponibilidade. ALETHORYN_LIVE_READY=false e LIVE=false.

Quickstart: prepare uma avaliação técnica

O primeiro passo não é gerar um cliente de API. É escolher um Caso operacional estreito e reunir o contrato mínimo que permite avaliá-lo sem inventar disponibilidade. Antes de discutir código de integração, reúna:

1. um Caso operacional estreito;
2. os Eventos que iniciam a jornada;
3. o sistema responsável por cada fato;
4. as capacidades mínimas de leitura e escrita;
5. as políticas e autoridades aplicáveis;
6. a observação que comprova o resultado;
7. o comportamento esperado quando o resultado ficar incerto.

Com esse recorte, a conversa técnica pode decidir o que já existe, o que precisa de adapter, o que permanece fora do escopo e qual evidência demonstraria o resultado. Isso prepara uma avaliação; não cria endpoint, SDK publicado, conector certificado ou ativação.

Veja o desenho completo dos adapters, comece pelo vocabulário operacional ou leve o Caso para a conversa de integração.