डैशबोर्ड आर्किटेक्चर

​

परिकल्पना

• बोर्ड किसी सत्र का एक रूप है, कोई नई वस्तु नहीं। हर सत्र (थ्रेड) के दो रूप होते हैं: ट्रांसक्रिप्ट और बोर्ड। बिना पिन किए गए विजेट वाला सत्र सामान्य चैट होता है। एक विजेट पिन करते ही बोर्ड अस्तित्व में आ जाता है। बोर्ड सत्र की पहचान, एजेंट स्वामित्व, नामकरण, पिनिंग और जीवनचक्र प्राप्त करते हैं। कोई dashboard_create नहीं, कोई बोर्ड रजिस्ट्री नहीं, कोई अलग ACL मॉडल नहीं।
• एजेंट समानता। उपयोगकर्ता बोर्ड पर जो कुछ भी कर सकता है, एजेंट टूल्स से कर सकता है: विजेट जोड़ना/अपडेट करना/हटाना, उन्हें व्यवस्थित करना, टैब प्रबंधित करना, दृश्यमान टैब बदलना, चैट को डॉक करना या छिपाना।
• नेटिव, एम्बेडेड नहीं। बोर्ड Control UI शेल में Lit कंपोनेंट्स है (वही डिज़ाइन सिस्टम जो शेष ऐप में है)। केवल विजेट की सामग्री को iframe में सैंडबॉक्स किया जाता है। कोई URL बार नहीं, कोई ब्राउज़र क्रोम नहीं।
• छोटी एजेंट सतह। विजेट को स्थिर नाम से संबोधित किया जाता है और उसी स्थान पर अपडेट किया जाता है। लेआउट एक प्रवाही, स्वतः-संकुचित होने वाला ग्रिड है; एजेंट आकार और एंकर बताता है, पिक्सेल या निर्देशांक कभी नहीं।
• भरोसे के बजाय क्षमताएँ। विजेट कोड एक कठोर सैंडबॉक्स में मनमाना, एजेंट-लिखित HTML/JS है। पहुँच (Gateway डेटा, क्रियाएँ, नेटवर्क) केवल घोषित, ऑपरेटर-द्वारा-प्रदत्त क्षमता मैनिफ़ेस्ट के माध्यम से उपलब्ध होती है।

​

अवधारणाएँ

​

UX प्रवाह

• उन्नयन: एजेंट किसी भी चैट में show_widget कॉल करता है → विजेट ठीक आज की तरह ट्रांसक्रिप्ट में इनलाइन रेंडर होता है → होवर करने पर डैशबोर्ड पर पिन करें दिखता है → विजेट सत्र के बोर्ड पर दिखाई देता है। यही करने के लिए एजेंट pin: true पास कर सकता है।
• बोर्ड दृश्य: बोर्ड वाले सत्र को एक रूप टॉगल (चैट / डैशबोर्ड) मिलता है। बोर्ड दृश्य = टैब पट्टी (केवल जब >1 टैब हों) + प्रवाही ग्रिड + डॉक किया हुआ चैट पेन। चैट डॉक का आकार बदला जा सकता है, उसे स्थानांतरित किया जा सकता है (बाएँ/दाएँ/नीचे), और उसे ठीक साइडबार की तरह संक्षिप्त किया जा सकता है। प्रत्येक टैब की डॉक स्थिति याद रखी जाती है।
• ड्रैग: उपयोगकर्ता विजेट खींचता है; ग्रिड स्वतः संकुचित होता है (विजेट ऊपर तैरते हैं, पास वाले पुनः प्रवाहित होते हैं)। हैंडल से आकार बदलना आकार-चरणों पर स्नैप होता है। किसी के लिए भी पिक्सेल प्लेसमेंट नहीं।
• रीसेट चेतावनी: बोर्ड वाले सत्र पर /new / /reset वेब UI में पुष्टि माँगता है (“कॉन्टेक्स्ट रीसेट होता है, डैशबोर्ड बना रहता है”) और बोर्ड को बनाए रखता है।
• साइडबार: पिन किए गए सत्रों में बोर्ड होने पर उनका बोर्ड रूप रेंडर होता है। Home सत्र का बोर्ड डिफ़ॉल्ट “एजेंट डैशबोर्ड” है।
• इंटरैक्शन (तीन स्तर, नीचे देखें): मौन स्थिति इवेंट, दृश्यमान प्रॉम्प्ट प्रेषण और ऑटोमेशन ट्रिगर।

​

इंटरैक्शन स्तर

1. स्थिति इवेंट (डिफ़ॉल्ट)। विजेट UI इंटरैक्शन जिनके बारे में मॉडल को पता होना चाहिए, लेकिन प्रतिक्रिया नहीं देनी चाहिए। bridge.emitState({...}) एक संरचित सत्र सूचना जोड़ता है (समूह-गतिविधि सूचनाओं वाली ही व्यवस्था)। कोई एजेंट टर्न शुरू नहीं होता; मॉडल अपने अगले रन में संचित सूचनाएँ देखता है।
2. प्रॉम्प्ट (स्पष्ट बातचीत)। bridge.sendPrompt(text) — उपयोगकर्ता सक्रियण आवश्यक है; सत्र में एक दृश्यमान उपयोगकर्ता संदेश भेजता है (डॉक की हुई चैट उसे दिखाती है)। दर-सीमित; प्रत्येक प्रेषण की उपयोगकर्ता पुष्टि करता है, जब तक विजेट के पास prompt क्षमता अनुदान न हो।
3. ऑटोमेशन। bridge.runAction(name, args) — मैनिफ़ेस्ट में घोषित क्रिया चलाता है। आरंभिक क्रिया समुच्चय: cron.trigger (किसी मौजूदा Cron जॉब को अभी चलाएँ) और binding.refresh। Cron जॉब पहले से दृश्यमान, पृथक रन-सत्रों में चलते हैं और कम लागत वाला मॉडल उपयोग कर सकते हैं: यही “छोटा मॉडल विजेट को शक्ति देता है” मार्ग है। कहीं भी छिपे हुए सत्र नहीं।

​

विजेट मॉडल और होस्टिंग

• इनलाइन (ट्रांसक्रिप्ट) विजेट वर्तमान कैनवस-दस्तावेज़ पाइपलाइन बनाए रखते हैं: स्टेट डायरेक्टरी के अंतर्गत लिखे जाते हैं, Gateway द्वारा सर्व किए जाते हैं, स्कोप के अनुसार छाँटे जाते हैं, कोई अनुमोदन नहीं (वे संरचनात्मक रूप से क्षमतारहित हैं — प्रॉम्प्ट प्रेषण की उपयोगकर्ता पुष्टि करता है)।
• बोर्ड विजेट सत्र स्थिति हैं: बाइट्स स्वामी एजेंट के SQLite DB (board_widgets) में रहती हैं, और DB पढ़ने वाला एक कोर Gateway रूट (/__openclaw__/board/<agentId>/<sessionKey>/<name>/) उन्हें सर्व करता है। ट्रांसक्रिप्ट विजेट को पिन करने पर बाइट्स कॉपी होती हैं। सीमाएँ: प्रति विजेट 256 KB, प्रति बोर्ड 48 विजेट।
• उसी स्थान पर अपडेट: समान name के साथ विजेट को फिर उत्सर्जित करने पर बाइट्स बदलती हैं, revision बढ़ता है, board.changed प्रसारित होता है और लाइव दृश्य केवल उसी iframe को पुनः लोड करते हैं।
• बाइट फ़्रीज़िंग: प्रदत्त क्षमताएँ विजेट बाइट्स के sha256 से बँधती हैं। बाइट्स बदलने पर data/net/actions अनुदान केवल तभी बने रहते हैं, जब नया संशोधन प्रदत्त मैनिफ़ेस्ट के उपसमुच्चय की घोषणा करता है; विस्तृत मैनिफ़ेस्ट ऑपरेटर से फिर अनुमति माँगता है।

​

विजेट सामग्री होस्ट करते हैं; MCP ऐप्स सामग्री का एक प्रकार हैं

• html — एजेंट द्वारा show_widget के माध्यम से लिखा गया, बाइट्स बोर्ड स्टोरेज में।
• mcp-app — कॉन्फ़िगर किए गए सर्वर से तृतीय-पक्ष MCP ऐप दृश्य (ui:// संसाधन), जिसे विजेट सेल के भीतर होस्ट किया जाता है।

• एक सैंडबॉक्स होस्ट। html विजेट उसी सुदृढ़ पाइपलाइन के माध्यम से रेंडर होते हैं जिसके साथ MCP ऐप्स जारी हुए थे (समर्पित सैंडबॉक्स ओरिजिन पर डबल-iframe, प्रत्येक विजेट का CSP घोषित और त्रुटि पर बंद होने वाले ढंग से डीकोड किया गया), न कि किसी दूसरे विशेष रूप से निर्मित iframe होस्ट से। प्रॉक्सी HTML को मान के रूप में प्राप्त करता है, इसलिए स्थानीय सामग्री स्वाभाविक स्थिति है।
• एक प्राधिकरण मॉडल। विजेट की पहुँच एक प्रदत्त अनुमति-सूची है, चाहे उसका प्रकार कोई भी हो: html विजेट के लिए होस्ट टूल्स; mcp-app विजेट के लिए, सर्वर के ऐप-दृश्य टूल्स (मौजूदा allowedAppToolNames व्यवस्था के माध्यम से, जिसे प्रत्येक निर्माण-रन के बजाय प्रत्येक विजेट के लिए स्थायी बनाया गया है)।
• html विजेट के लिए होस्ट टूल्स (विजेट ब्रिज पर उपलब्ध, अनुदान के विरुद्ध जाँचे गए):
  • openclaw.prompt.send — स्तर 2; दृश्यमान कंपोज़र के माध्यम से रूट किया जाता है, अनुदान न होने पर उपयोगकर्ता द्वारा पुष्टि की जाती है
  • openclaw.state.emit — स्तर 1 सत्र सूचनाएँ (एकत्रित, आकार-सीमित)
  • openclaw.data.read — पैरामीटरयुक्त केवल-पठन बाइंडिंग (मौजूदा अनुमति-सूचीबद्ध रीड RPC समुच्चय), Gateway की ओर से समाधान किया जाता है
  • openclaw.cron.trigger — स्तर 3 ऑटोमेशन
• net = CSP। नेटवर्क पहुँच पहले से जारी प्रत्येक विजेट की CSP घोषणा (connect-src ओरिजिन) का उपयोग करती है — स्वयं अपडेट होने वाला मौसम विजेट अपना API सीधे सैंडबॉक्स से फ़ेच करता है, इसमें Gateway की कोई भागीदारी नहीं।
• अनुदान। कुछ भी घोषित न करने वाला विजेट तुरंत रेंडर होता है (सैंडबॉक्स किया हुआ, default-src 'none', प्रॉम्प्ट प्रेषण की अलग-अलग पुष्टि होती है) — आज के इनलाइन चैट विजेट जितना ही भरोसा। घोषित टूल्स/ओरिजिन विजेट को बोर्ड पर pending में डालते हैं: एक प्लेसहोल्डर कार्ड उन्हें मानव-पठनीय रूप में सूचीबद्ध करता है, साथ में एक-टैप अनुमति दें/अस्वीकार करें। अनुदान प्रत्येक विजेट नाम के अनुसार होते हैं; html विजेट के लिए वे बाइट-फ़्रीज़ (sha256) होते हैं और बदली हुई बाइट्स अनुदान केवल तभी बनाए रखती हैं, जब घोषणा छोटी हुई हो।
• लेखन शिम। दस्तावेज़ रैपर स्थिर लेखक API के रूप में window.openclaw.prompt, window.openclaw.state, window.openclaw.data और window.openclaw.cron इंजेक्ट करता है। डैशबोर्ड कॉल एक दृश्य-टिकट-बद्ध अनुरोध चैनल साझा करते हैं; आकार रिपोर्टिंग और थीम टोकन अलग होस्ट सूचनाएँ बने रहते हैं।

​

Plugin क्षमता घोषणाएँ

​

मॉडल किया हुआ अवशिष्ट: WebRTC डेटा चैनल

​

ट्रांसक्रिप्ट प्रदर्शन: एक विजेट कार्ड

​

सर्वर-स्रोतित विजेट (पिन किए गए MCP ऐप)

​

WorkBoard एकीकरण

​

लेआउट: तरल ग्रिड

• size: sm (3×3) · md (6×4) · lg (8×6) · xl (12×8) · full (एकल-विजेट टैब)
• after: <widgetName> वैकल्पिक क्रम निर्धारण एंकर; छोड़ा गया = अंत में जोड़ें
• उपयोगकर्ता स्वतंत्र रूप से ड्रैग/आकार बदलता है; वही क्रम+आकार मॉडल राउंड-ट्रिप करता है।

​

डेटा मॉडल (प्रति-एजेंट DB)

CREATE TABLE board_tabs (
  session_key TEXT NOT NULL,
  tab_id      TEXT NOT NULL,           -- slug
  title       TEXT NOT NULL,
  position    INTEGER NOT NULL,
  chat_dock   TEXT NOT NULL DEFAULT 'right',  -- left|right|bottom|hidden
  created_by  TEXT NOT NULL,           -- 'user' | 'agent'
  PRIMARY KEY (session_key, tab_id)
) STRICT;

CREATE TABLE board_widgets (
  session_key  TEXT NOT NULL,
  name         TEXT NOT NULL,          -- stable widget name
  tab_id       TEXT NOT NULL,
  title        TEXT,
  html         BLOB NOT NULL,          -- wrapped document source
  sha256       TEXT NOT NULL,
  revision     INTEGER NOT NULL,
  size_w       INTEGER NOT NULL,
  size_h       INTEGER NOT NULL,
  position     INTEGER NOT NULL,       -- order within tab (auto-compact input)
  manifest     TEXT NOT NULL DEFAULT '{}',  -- capability manifest JSON
  grant_state  TEXT NOT NULL DEFAULT 'none', -- none|pending|granted|rejected
  granted_sha  TEXT,                   -- byte-frozen grant
  created_by   TEXT NOT NULL,
  created_at   INTEGER NOT NULL,
  updated_at   INTEGER NOT NULL,
  PRIMARY KEY (session_key, name)
) STRICT;

​

प्रोटोकॉल सतह

• board.get { sessionKey } → टैब + विजेट मेटाडेटा (कोई बाइट नहीं) — operator.read
• board.update { sessionKey, ops[] } — टैब CRUD/पुनःक्रमण, विजेट स्थानांतरण/आकार बदलना/ हटाना/अनपिन करना, डॉक स्थिति, फ़ोकस-टैब — operator.write
• board.widget.put { sessionKey, name, html, manifest, placement } — operator.write (एजेंट टूल मार्ग और पिन मार्ग)
• board.widget.grant { sessionKey, name, decision } — operator.approvals
• board.event { ticket, payload } — टिकट-आधारित टियर-1 स्थिति इवेंट अंतर्ग्रहण; पुराना विश्वसनीय-होस्ट { sessionKey, widget, payload } आकार बना रहता है — operator.write
• board.prompt.authorize { ticket } — बताता है कि दृश्य प्रॉम्प्ट भेजने के लिए अब भी प्रति-क्लिक पुष्टि आवश्यक है या नहीं — operator.read
• board.data.read { ticket, bindingId, params? } — Gateway-पक्षीय अनुमति-सूचीबद्ध कोर या सक्रिय-Plugin रीड बाइंडिंग समाधान — operator.read
• board.action { ticket, action, ... } — मौजूदा cron तत्काल-रन मार्ग या किसी सक्रिय Plugin की सत्यापित क्रिया क्रिया-पद के माध्यम से सटीक-अनुदान ऑटोमेशन प्रेषण — operator.write

• board.changed { sessionKey, revision, widget? } — स्थायी स्थिति बदली; UI पुनः प्राप्त करता है (और widget मौजूद होने पर एक iframe पुनः लोड करता है)।
• board.command { sessionKey, command } — क्षणिक UI संचालन (एजेंट दृश्य टैब बदलता है, चैट डॉक टॉगल करता है) — ui.command पैटर्न।

​

एजेंट टूल

• show_widget { title, widget_code, name?, pin?, size?, tab?, after?, capabilities? } — नाम से बनाएँ/अपडेट करें; pin इसे बोर्ड पर रखता है। name/pin के बिना यह ठीक आज की तरह व्यवहार करता है (इनलाइन, अल्पकालिक)।
• dashboard { action, ... } — बोर्ड प्रबंधन क्रिया-पद: read, tab_create, tab_update, tab_delete, tabs_reorder, widget_move, widget_remove, unpin, focus_tab, set_chat_dock।
• मौजूदा cron टूल ऑटोमेशन टियर को कवर करते हैं; किसी नए टूल की आवश्यकता नहीं।

​

यह किसे प्रतिस्थापित करता है

• extensions/workspaces हटा दिया गया है। प्रायोगिक, enabledByDefault: false, किसी स्थिर रिलीज़ में कभी नहीं था (पहली बार 2026.7.2 बीटा में दिखाई दिया)। कोई माइग्रेशन नहीं; मौजूद होने पर doctor नियम पुराने <stateDir>/workspaces/ को हटा देता है। अपनाए गए विचार: शुद्ध ग्रिड गणित, ब्रिज सुरक्षा मॉडल (पोर्ट बूटस्ट्रैप, बाइंडिंग प्रतिबंध, दर सीमाएँ), बाइट-फ़्रीज़ की गई स्वीकृति।
• विजेट होस्टिंग extensions/canvas से कोर में जाती है। कैनवास दस्तावेज़ स्टोर, दस्तावेज़ रैपर, HTTP सेवा और show_widget टूल कोर बन जाते हैं (src/canvas/); Plugin नोड-कैनवास नियंत्रण टूल (canvas) और A2UI रखता है। pluginSurfaceUrls["canvas"] विज्ञापन और /__openclaw__/canvas मार्ग जारी किए गए मूल-क्लाइंट अनुबंध हैं और स्थिर रहते हैं। Discord सत्र Discord-स्वामित्व वाला show_widget संस्करण रखते हैं।

​

गैर-लक्ष्य (यह कार्यक्रम)

• बहु-उपयोगकर्ता बोर्ड साझाकरण/ACL (भविष्य; सत्र साझाकरण के माध्यम से आएगा)।
• मूल macOS/iOS बोर्ड रेंडरिंग (जहाँ भी वे Control UI एम्बेड करते हैं, वहाँ यह उन्हें मिलता है; इनलाइन-विजेट मार्ग अपरिवर्तित है)।
• अंतर्निहित डेटा विजेट (सत्र/उपयोग/cron कार्ड) — क्षमता ब्रिज और एजेंट-रचित विजेट v1 को कवर करते हैं; अंतर्निहित प्रकार रजिस्ट्री बाद में आ सकती है।

​

कार्यान्वयन योजना