Visão geral
Last updated
O @tunnelhub/sdk é a base pública para implementar automações no TunnelHub.
flows prontos para integrações com e sem delta;
persistência e comparação de estado em flows delta;
logging operacional com estratégia inteligente;
utilitários para parâmetros, systems, Tabelas De/Para e Sequências;
utilitários de interceptação HTTP, validação e concorrência;
suporte a build, testes locais e troubleshooting.
npm install @tunnelhub/sdkO entrypoint principal exporta, entre outros:
AutomationExecution
DeltaIntegrationFlow
BatchDeltaIntegrationFlow
NoDeltaIntegrationFlow
NoDeltaBatchIntegrationFlow
AutomationParameter
DataStore
Sequences
System
setupInterceptor
promiseWithConcurrency
validateMetadata
SDK
O pacote também possui export separado para build tooling em @tunnelhub/sdk/building.
Na prática, um projeto TunnelHub costuma combinar:
um handler em src/index.ts;
uma classe que herda um dos flows do SDK;
AutomationExecution.executeAutomation(...) como ponto central da execução;
tunnelhub.yml para build e deploy.
Consulte Estrutura de projeto e runtime para o fluxo completo.
use No delta quando o processamento é unidirecional e sem comparação de estado;
use No delta batch para alto volume unidirecional;
use Delta quando precisa detectar insert, update e delete;
use Delta batch quando precisa do modelo delta com processamento em lote.
Além da documentação, existe um skill público chamado tunnelhub-sdk para ajudar agentes a trabalhar melhor com o SDK.
Esse skill é especialmente útil para:
escolher o flow correto;
trabalhar com parâmetros, systems, Tabelas De/Para e Sequências;
entender logging, interceptor HTTP e utilitários;
acelerar troubleshooting e implementação de testes.
Instalação:
Instalação global:
Last updated
npx skills add tunnelhub/agent-skills --skill tunnelhub-sdk -a opencodenpx skills add tunnelhub/agent-skills --skill tunnelhub-sdk -a opencode -g