downcity

Downcity é um projeto de infraestrutura de agente para desenvolvedores, criadores independentes e equipes que lançam muitos produtos e fluxos de trabalho alimentados por IA. Seu princípio é uma camada de runtime reutilizável que serve muitos agentes e produtos, de modo que o roteamento de modelos, ferramentas, memória, tarefas, autenticação, uso, cobrança e operações não precisam ser reconstruídos para cada novo produto de IA. O repositório é um monorepo de workspace pnpm. O pacote público downcity expõe duas superfícies de comando: city/downcity, o container City local que gerencia e executa agentes, e fed/downfed, um gerenciador de Servidor de Federação. Os pacotes de suporte incluem @downcity/workspace (recursos de workspace, ferramentas de arquivo e pesquisa enraizadas, ambiente, armazenamento privado e shell integrado), @downcity/agent (runtime de agente e container City com AgentWorkspace, Session, Plugin SDK, propriedade multi-agente e transporte HTTP/RPC), @downcity/federation (runtime de Federação e SDK Embassy para serviços, auth, env, Bureau, acesso de usuário e admin), @downcity/type (tipos de protocolo compartilhados), @downcity/services (contas, saldo, uso, pagamento e fluxos Stripe) e @downcity/ui (componentes React + Tailwind para console e aplicativos host). Os templates de partida cobrem cenários de agente, federação de edge, federação local e UI React, e um diretório de página inicial contém o site e a documentação do usuário final. Uso local típico: instale o CLI com npm ou pnpm, conecte-se a uma Federação via downcity federation use e federation status, registre um repositório como um workspace com downcity agent create ., depois inicie o City local com downcity on e inspecione-o com downcity agent list ou downcity status. A identidade e a configuração do agente ficam em um diretório ~/.downcity de nível de usuário (agents/, plugins/) enquanto o workspace é inserido no momento da execução. O README observa que os agentes não têm estado independente de iniciado/parado, e que o chat ainda funciona enquanto o CLI City está desligado porque um City local temporário é criado e descartado para a interação. As capacidades de agente integradas listadas são chat, task, memory, shell, contact, skill, web, sound e workboard. A integração é oferecida em vários níveis. O exemplo de SDK constrói um Workspace com um sandbox Shell, cria um Agent e Session, injeta um modelo criado pelo aplicativo host (o README afirma que @downcity/agent não resolve IDs de provedor ou modelo por si só), envia um prompt e aguarda o turno finalizado. Uma classe RemoteAgent se conecta a um City em execução via HTTP por URL base. As superfícies de produto são o Downcity CLI, Agent SDK, City SDK e UI SDK, além de plugins, serviços e componentes de UI React. Suporte de plataforma e segurança: macOS usa Seatbelt, Linux usa Bubblewrap, e Windows 11 24H2 e mais recente (build 26100+) é descrito como desenvolvimento/instável via processcontainer MXC da Microsoft com execução nativa de cmd.exe. O README diz que falhas de pré-voo nunca fazem fallback para execução irrestrita, e que MXC está em Pré-visualização Pública em vez de um limite de segurança de produção. Comandos de shell e script são executados no sandbox do agente por padrão, com um projeto gravável, rede aberta e home/cache de sandbox sob .downcity/sandbox. Os conselhos incluem auditar mudanças com git status e git diff, manter segredos em variáveis de ambiente locais ou downcity env, usar tokens para limites de console, HTTP e chat, e observar que instalações de nível de host e gravações de diretório do sistema ficam fora do sandbox. A documentação é publicada em downcity.ai/docs com páginas separadas de City SDK, Agent SDK e UI SDK, READMEs de nível de pacote, e uma tradução em chinês simplificado do README principal.