अनुबंध
sidecar एक Unix सॉकेट पर चलने वाला gRPC सर्वर है। NEBO_APP_SOCK में दिए पाथ पर सुनें और apps.v0.UIService लागू करें। Nebo हर अनुरोध के लिए HandleRequest कॉल करता है; HealthCheck और Configure सर्विस का हिस्सा हैं पर अभी कॉल नहीं किए जाते। सॉकेट मैनिफ़ेस्ट के startup_timeout के अंदर दिखना चाहिए, जो डिफ़ॉल्ट रूप से 10 सेकंड है और ज़्यादा से ज़्यादा 120 हो सकता है।
syntax = "proto3";
package apps.v0;
service UIService {
rpc HealthCheck(HealthCheckRequest) returns (HealthCheckResponse);
rpc Configure(SettingsMap) returns (Empty);
rpc HandleRequest(HttpRequest) returns (HttpResponse);
}
message HttpRequest {
string method = 1; // GET, POST, PUT, DELETE, ...
string path = 2; // relative to /apps/{id}/api/
string query = 3; // raw query string
map<string, string> headers = 4;
bytes body = 5;
}
message HttpResponse {
int32 status_code = 1;
map<string, string> headers = 2;
bytes body = 3;
} sidecar macOS और Linux पर चलते हैं।
Nebo बाइनरी कहाँ खोजता है
ऐप के फ़ोल्डर में, Nebo इनमें से जो पहले मौजूद हो उसे इस्तेमाल करता है:
binaryनाम की फ़ाइलappनाम की फ़ाइलtmp/में पहली फ़ाइलbin/में पहली फ़ाइल- लोकल डेवलपमेंट के लिए,
sidecar/target/release/में पहला एक्ज़िक्यूटेबल
बाइनरी एक सामान्य, एक्ज़िक्यूटेबल फ़ाइल होनी चाहिए, सिंबॉलिक लिंक नहीं, और ज़्यादा से ज़्यादा 500 MB की। पब्लिश किए गए ऐप्स में यह bin/<name> पर होती है। जब डिस्क पर फ़ाइल बदलती है, तो Nebo sidecar को रीस्टार्ट करता है।
एनवायरनमेंट
sidecar एक खाली एनवायरनमेंट और इन वेरिएबल के साथ शुरू होता है:
| वेरिएबल | मान |
|---|---|
NEBO_APP_ID, NEBO_APP_NAME, NEBO_APP_VERSION | ऐप की पहचान। |
NEBO_APP_DIR | ऐप का फ़ोल्डर। |
NEBO_APP_SOCK | सुनने के लिए सॉकेट, <app folder>/<id>.sock। Nebo इसका मोड 0600 पर सेट करता है। |
NEBO_DATA_DIR | ऐप का डेटा फ़ोल्डर, <data>/appdata/agents/<id>/। यही वर्किंग डायरेक्टरी भी है। |
NEBO_API_URL | बॉट की लोकल API, http://127.0.0.1:<port>। |
NEBO_APP_TOKEN | बॉट की ऐप API को कॉल करने के लिए एक टोकन। |
PATH, HOME, TMPDIR, LANG, LC_ALL, TZ | जैसा है वैसा पास किया जाता है। |
स्टैंडर्ड आउटपुट और स्टैंडर्ड एरर डेटा फ़ोल्डर में sidecar.log में जाते हैं। स्टैंडर्ड इनपुट एक पाइप है; फ़ाइल के अंत का मतलब है कि Nebo चला गया है और sidecar को बंद हो जाना चाहिए। sidecar अपने खुद के प्रोसेस ग्रुप में चलता है।
पेज से आने वाले अनुरोध
/apps/<id>/api/<path> पर अनुरोध, जो पेज neboFetch और एक रिलेटिव पाथ से करता है, HandleRequest तक पहुँचता है और उसमें path का मान <path> होता है। _ से शुरू होने वाले पाथ अस्वीकार किए जाते हैं। अनुरोध का मुख्य भाग 10 MB तक और जवाब 32 MB तक सीमित होते हैं।
कर्मचारी के लिए टूल
ऐप की agent.json में टूल घोषित करें। हर एक app__<app>__<name> नाम का टूल बन जाता है, जो कर्मचारी को ज़रूरत पड़ने पर लोड होता है। हर कॉल method और path पर sidecar के लिए एक अनुरोध बन जाती है।
"tools": [
{
"name": "list_deals",
"description": "List open deals, optionally filtered by stage.",
"method": "GET",
"path": "/deals",
"input_schema": { "type": "object", "properties": { "stage": { "type": "string" } } }
}
] Nebo को कॉल करना
sidecar Authorization: Bearer $NEBO_APP_TOKEN हेडर के साथ $NEBO_API_URL/api/v1/apps/$NEBO_APP_ID/... कॉल करके वही सेवाएँ इस्तेमाल कर सकता है जो पेज करता है।
| रूट | क्या करता है |
|---|---|
GET /storage, GET|PUT|DELETE /storage/<key> | ऐप का की-वैल्यू स्टोर। |
POST /agents/invoke, POST /agents/stream | किसी कर्मचारी से पूछता है: {message, agent, data}। स्ट्रीम जवाब server-sent events होते हैं। |
POST /janus/complete, POST /janus/stream | एक सीधा मॉडल कॉल: {messages, model, temperature, max_tokens, system}। |
POST /http/proxy | एक बाहरी अनुरोध, {url, method, headers, body}, जिसकी अनुमति ऐप की network: अनुमतियाँ देती हैं। |
GET /identity | ऐप का कर्मचारी। |
लाइफ़साइकल
- Nebo हर तीन सेकंड में सॉकेट की जाँच करता है।
- विफल sidecar एक सेकंड बाद रीस्टार्ट होता है, और यह समय दोगुना होते-होते ज़्यादा से ज़्यादा 60 सेकंड तक जाता है। लगातार पाँच विफलताओं के बाद इसे विफल चिह्नित कर दिया जाता है। जो sidecar 60 सेकंड तक चालू रहे, वह फिर से स्वस्थ माना जाता है।
- रुके हुए sidecar को भेजा गया अनुरोध उसे शुरू करता है और 15 सेकंड तक इंतज़ार करता है। GET और HEAD अनुरोध दोबारा भेजे जाते हैं।
- sidecar रोकने के लिए, Nebo उसके प्रोसेस ग्रुप को SIGTERM भेजता है, फिर दो सेकंड बाद उसे ज़बरदस्ती बंद कर देता है।