NeboAI
NeboAI
Eñepyrũ

plugin.json rehegua

plugin.json ha'e manifiesto Nebo omoñe'ẽva omohenda ha omomba'apo hag̃ua peteĩ plugin. Clave-kuéra oĩ camelCase-pe. Ko kuatiarogue ohechauka opa kora Nebo omoñe'ẽva ko'ág̃a ha mba'épa ojapo peteĩteĩ.

Kora yvategua

KoraMba'éichaguaTekotevẽHe'iséva
idstringhéẽPlugin mba'ehechaukaha ñemuhápe. Eiporu slug rembosako'i aja.
slugstringhéẽMba'ehechaukaha ndoiambuéiva. [a-z0-9-], 64 carácter peve, ndaipóri guion ñepyrũme, pahápe térã mokõi oñondive. Ombohéra tembiporu plugin__<slug> ha variable <SLUG>_BIN.
namestringhéẽTéra ojehechaukáva. Embohéra pe servicio ojoajúvape.
versionstringhéẽPeteĩchagua semántica, ha'eháicha 0.1.0.
platformsmaphéẽClave plataforma rehegua binario-pe. Ehecha Plataforma-kuéra.
descriptionstringnahániriPeteĩ ñe'ẽjoaju yvypórape ha mba'apoharakuérape g̃uarã.
authorstringnahániriMoherakuãhára réra.
categorystringnahániriOipytyvõ mba'apoharakuérape ojuhu hag̃ua plugin.
triggersñe'ẽjoaju listanahániriÑe'ẽ omombe'úva araka'épa plugin oñeikotevẽ. Ojeporu jeheka ñe'ẽpykĩme.
entrySkillsñe'ẽjoaju listanahániriKatupyry oñembojoajúva oñembohéra raẽ hag̃ua plugin tembiporu ñemyesakãme.
dependencies{name, version, optional} listanahániriAmbue plugin ko plugin omomba'apóva. version ijypykuéva ha'e "*"; optional ha'e false. Umi <SLUG>_BIN rape oñemoĩ opa ñehenóime.
authobjectnahániriJeike ha kuénta-kuéra. Ehecha Jeike.
capabilitiesobjectnahániriconfigSchema, hooks, commands, routes, providers.
permissionsobjectnahániriEntorno ñemboguaku ha timeout yvatevéva.
eventslistnahániriÑangarekoha omongaruva mba'apoharakuéra tembiaporape.
interfaceBindingsmapnahániriTembiapo tipo reheguáva plugin ome'ẽva.
channelobjectnahániriPeteĩ joaju opytáva peteĩ servicio ñe'ẽmondo rehegua ndive.
setupobjectnahániriPeteĩ asistente de configuración pasoha pasoha.

Nebo ohecha ñemuha guive ñemohenda: slug léi, peteĩchagua semántica, sa'ivévo peteĩ plataforma, peteĩ binaryName ndorekóiva separador rape térã .., peteĩ tembiapoukapy login ndaha'éirõ auth.type env, jehu réra ha tembiapoukapy nandi'ỹva, ha binding plantilla oñeanalisakuaáva. Plugin oĩva puruhára plugin ñongatuhápe ndohasái ko jehecha.

Plataforma-kuéra

Clave-kuéra ha'e darwin-arm64, darwin-amd64, linux-arm64, linux-amd64, windows-arm64 ha windows-amd64. Peteĩteĩ entrada oguereko opa po kora oĩva iguýpe. Removerakuã jave, ñemuha ohai hash, tamaño, firma ha mboguejyha URL añetegua, upévare eheja nandi umi marandurenda rembohupívape.

"platforms": {
  "darwin-arm64":  { "binaryName": "notes-sync",     "sha256": "", "signature": "", "size": 0, "downloadUrl": "" },
  "linux-amd64":   { "binaryName": "notes-sync",     "sha256": "", "signature": "", "size": 0, "downloadUrl": "" },
  "windows-amd64": { "binaryName": "notes-sync.exe", "sha256": "", "signature": "", "size": 0, "downloadUrl": "" }
}
KoraHe'iséva
binaryNameEjecutable marandurenda réra. Emoĩ .exe Windows-pe.
sha256Binario hash. Ojehecha ñemohenda jave.
signatureBinario firma. Ojehecha ñemohenda jave oĩ jave peteĩ clave firma rehegua.
sizeTamaño byte-pe.
downloadUrlMoõpa Nebo omboguejy paquete.

Jeike

KoraHe'iséva
typeoauth_cli jeike navegador rupi plugin omomba'apóvape g̃uarã; env credencial oñemoĩva valor ramo; neboai ohupyty hag̃ua jára token NeboAI opa clave auth.env opáva _TOKEN-pe.
envMapa variable réra valor ijypykuévape. Avei ha'e umi credencial réra añoite Nebo ome'ẽva login-pe.
commands.loginOike. Tekotevẽ ndaha'éirõ type env. Omba'apo kuénta ñongatuha oñemoĩmava ndive.
commands.statusOhai JSON he'íva kuénta oikepa.
commands.refreshOmbopyahu peteĩ token ndojeikotevẽi ñemba'apo.
commands.logoutOsẽ kuéntagui. Jára añoite ikatu omomba'apo.
profileDirEnvVariable ohupytýva peteĩ ñongatuha credencial-pe g̃uarã peteĩteĩ mba'apohára ha kuéntape. Ko'ỹre plugin oguereko peteĩ kuénta oñemboja'opáva.
label, descriptionMoñe'ẽrã tarjeta joaju reheguápe.
help{url, urlLabel, text} ojehechaukáva ojoaju aja.
publicRedirectEmoĩ true proveedor ndoipotáiramo redirección http://localhost-pe; upéicharõ jeike ohasa NeboAI redirección pública rupi.

Nebo omoñe'ẽ peteĩha oĩva ko'ã apytépe: authenticated, isAuthenticated, logged_in, loggedIn térã token_valid estado salida-pe. Peteĩ token_error nandi'ỹva, térã valor none credential_source, auth_method, storage térã status-pe, he'ise osẽma kuéntagui. Estado tembiapoukapy oguereko 45 segundo.

{"authenticated": true, "account": "finance@example.com"}

configSchema

capabilities.configSchema omombe'u umi valor jára omoĩva plugin-pe g̃uarã. Peteĩteĩ valor oguahẽ binario-pe variable de entorno ramo, key ombohérava. Clave credencial reheguáva oĩvape avei auth.env-pe, esquema ombohéra kora formulario joaju rehegua peteĩteĩ mba'apohárape g̃uarã.

KoraMba'éichaguaIjypykuévaHe'iséva
keystringtekotevẽVariable de entorno réra.
labelstringtekotevẽKora réra.
descriptionstring""Moñe'ẽrã pytyvõrã.
fieldTypestring"string"Entrada mba'éichagua, ha'eháicha string, number, boolean, select térã password.
defaultstringmba'eveValor oñemyenyhẽmava.
requiredbooleanfalsePlugin noĩri listo valor oñemoĩ peve.
secretbooleanfalseValor oñemokañy oñemoñe'ẽjey jave.
optionsñe'ẽjoaju listamba'eveJeporavorã select-pe g̃uarã.

permissions

KoraIjypykuévaHe'iséva
envAllow[]Variable oñepyhy ypykuégui plugin ikatúva ohecha. Nandi ramo opavave oñemoneĩ.
envDeny[]Variable oñepyhy ypykuégui ojeipe'akuaáva tapiaite.
maxTimeoutSeconds300Ijyvatevéva oimeraẽ ñehenói timeout-pe g̃uarã.
networkfalseOmombe'u ñandutí jeporu. Marandu ramo añoite; ndojejapokatúi.

events

Peteĩ jehu ha'e peteĩ ñangarekoha omba'apóva are. Nebo omoñepyrũ peteĩ mba'apohára tembiaporape omaña jave hese, ha omoñepyrũjey opytárõ. Peteĩteĩ tysýi ñangarekoha ohaíva stdout-pe ha'e peteĩ jehu. Jehu réra oguereko slug tenondépe omba'apo jave, upévare note.created oiko notes-sync.note.created.

"events": [
  {
    "name": "note.created",
    "description": "A note was created in the watched notebook.",
    "command": "watch --notebook {{notebook}} --format ndjson"
  }
]
KoraHe'iséva
nameJehu réra, slug'ỹre. Tekotevẽ.
commandArgumento omoñepyrũva ñangarekoha. Tekotevẽ. {{key}} oñemyengovia mba'apohára entrada valor-kuéragui.
descriptionMba'épa omoheñói jehu.
multiplexedtrue jave, peteĩ ñangarekoha omondo heta jehu mba'éichagua ha peteĩteĩ tysýi oguereko kora "event".

Tembiaporape-kuéra oñemboheraguapy jehu-kuérape peteĩ mbopu'ãha watch rupive. Ehecha Mbopu'ãha-kuéra.

interfaceBindings

Peteĩ binding ombojoaju peteĩ tembiapo interfaz rehegua ne tembiapoukapy peteĩme. Peteĩteĩ binding oiko tembiporu tipo reheguáva mba'apoharakuérape g̃uarã, oñembohéráva tembiapo rérape letra michĩme ha punto ha guion oiko guion guýpe: notes.search oiko notes_search. Binding-kuéra rupive peteĩ plugin omoañete umi pu'aka peteĩ mba'apohára oikotevẽva; ehecha Pu'aka-kuéra.

"interfaceBindings": {
  "notes.search": "notes search --query {query} {tag[]:--tag} {limit?:--limit}",
  "invoice.create": "invoices create --amount {amount_cents:cents->dollars}"
}
MarcadorOiko
{field}Kora valor peteĩ ñe'ẽ ramo. Kora noñemondói avei flag ramo.
{field[]:--flag}Peteĩ --flag <item> peteĩteĩ mba'épe g̃uarã peteĩ kora lista-pe.
{field?:--flag}--flag <value> kora oĩ jave; mba'eve ndaipóri jave.
{field:cents->dollars}Peteĩ cantidad entero centavo-pe, ojehaíva dólar ramo.

Kora entrada peteĩ plantilla ombohéra'ỹva oñembojoapy --field value ramo. Marcador lista ha poravopyrã ha'eva'erã ñe'ẽ henyhẽva. Peteĩ tembiapo oikotevẽva ñemoneĩ ndaikatúi ojehupyty pe tembiapoukapy peteĩchagua ojehenóirõ plugin__<slug> rupive.

Hook, slash command ha ruta

"capabilities": {
  "hooks": [
    { "hook": "tool.post_execute", "hookType": "filter", "command": "hook redact", "priority": 50, "timeoutMs": 500 }
  ],
  "commands": [
    { "name": "notes", "description": "Show today's notes", "command": "notes today", "slash": true }
  ],
  "routes": [
    { "path": "/callback", "method": "GET", "command": "http callback" }
  ]
}

hooks

Peteĩ hook omongu'e ne comando peteĩ momento-pe peteĩ mba'apohára jehasápe. Nebo ohai peteĩ payload JSON stdin-pe. Peteĩ hook action rehegua osẽva ndojehesaréi. Peteĩ hook filter ome'ẽ {"payload": ..., "handled": false}; "handled": true ojoko umi hook upe riregua. Jejavy ha tiempo opa oñongatu payload yma ha araka'eve ndojokói pe jehasa. Mbohapy jejavy oñondive rire, peteĩ hook opyta po aravo'i.

KoraIjypykuévaHe'iséva
hooktekotevẽPeteĩ ko'ã apytégui: tool.pre_execute, tool.post_execute, message.post_receive, session.message_append, steering.generate, agent.turn, agent.should_continue.
hookType"action"action térã filter.
commandtekotevẽArgumento ne binario-pe g̃uarã.
priority100Michĩvéva omba'apo raẽ.
timeoutMs500Aravo pa'ũ milisegundo-pe.

commands

"slash": true ndive, rehai jave /name args ñomongetápe omomba'apo command args pya'e, mba'apohára'ỹre. Salida ha'e mbohovái. Aravo pa'ũ ha'e 30 segundo.

routes

Peteĩ ruta ombohovái HTTP mba'ejerure /api/v1/plugins/<slug>/api/<path>-pe bot-pe, path ha method rupive. Mba'ejerure rete oho stdin-pe ha ne stdout ha'e mbohovái. Aravo pa'ũ ha'e 30 segundo.

providers

Peteĩ proveedor omoĩ peteĩ ypykue modelo ñomongeta rehegua. Emombe'u id, displayName, providerType, modelsCommand ha chatCommand. Nebo omondo peteĩ mba'ejerure ñomongeta rehegua JSON ramo stdin rupi chatCommand-pe ha omoñe'ẽ jehu oñemondóva JSON tysýi pyahu rupi oñemboja'óva ramo stdout-pe, 300 segundo peve. Ko'ág̃a ojeporu ñomongeta streaming añoite.

channel

Peteĩ canal ombojoaju peteĩ servicio ñe'ẽmondo rehegua. Nebo omomba'apo meme command, omoñe'ẽ ñe'ẽmondo oguahẽva istdout-gui ha ohai mbohovái istdin-pe, mokõivéva JSON tysýi pyahu rupi oñemboja'óva ramo.

KoraIjypykuévaHe'iséva
commandtekotevẽArgumento omoñepyrũva joaju.
name, description""Ojehechauka ñembohekópe.
restartDelaySecs5Eha'arõ emoñepyrũjey mboyve oñembyai rire.
sharedfalsePeteĩ joaju opavave mba'apohárape g̃uarã; ñe'ẽmondo oñemondo mba'apohára réra rupive ha mbohovái oguereko peteĩteĩ mba'apohára identidad.
needsLocalApifalseEme'ẽ joajúpe bot API rape local, peteĩ token ha mba'apohára id. Oñembogue, reikotevẽ'ỹrõ.

setup

Peteĩ asistente ñemboheko rehegua ogueraha jára jehasa rupi peteĩ formulario añoite ndaikatúiva ohupyty. Valor oúva form jehasagui omyenyhẽ {{key}} umi argumento generate upe rireguápe. Valor oúva credentials jehasagui oñeñongatu plugin variable de entorno ramo.

"setup": {
  "title": "Connect Example Chat",
  "steps": [
    { "kind": "form", "title": "Bot name", "fields": [ { "key": "bot_name", "label": "Name", "required": true } ] },
    { "kind": "generate", "title": "App manifest", "command": "manifest", "args": ["--name", "{{bot_name}}"], "outputFormat": "yaml" },
    { "kind": "external", "title": "Create the app", "url": "https://example.com/apps", "urlLabel": "Open admin" },
    { "kind": "credentials", "title": "Paste the token", "fields": [ { "key": "EXAMPLE_CHAT_TOKEN", "label": "Token", "inputType": "password", "required": true } ], "verifyCommand": "auth status" }
  ]
}
Paso mba'éichaguaKora-kuéra
formtitle, description, fields
generatetitle, description, command, args, outputFormat (yaml, json, toml, text), buttonLabel. Ohechauka tembiapoukapy salida rekopia hag̃ua.
externaltitle, description, url, urlLabel, instructions
credentialstitle, description, fields, verifyCommand. Paso opa verifyCommand oiko porã jave.

Kora-kuéra oguereko key, label, default, placeholder, maxLength, help, inputType (text, textarea, password) ha required.