चैनल इनबाउंड API

Channel Plugin को प्राप्ति पथों को आगत और संदेश संज्ञाओं के साथ मॉडल करना चाहिए:

platform event -> inbound facts/context -> agent reply -> message delivery

आगत इवेंट सामान्यीकरण, स्वरूपण, रूट्स और ऑर्केस्ट्रेशन के लिए openclaw/plugin-sdk/channel-inbound का उपयोग करें। नेटिव भेजने, रसीद, टिकाऊ डिलीवरी और लाइव पूर्वावलोकन व्यवहार के लिए openclaw/plugin-sdk/channel-outbound का उपयोग करें।

मुख्य सहायक

   buildChannelInboundEventContext,  runChannelInboundEvent,  dispatchChannelInboundReply,} from "openclaw/plugin-sdk/channel-inbound";

• buildChannelInboundEventContext(...): सामान्यीकृत चैनल तथ्यों को प्रॉम्प्ट/सेशन संदर्भ में प्रोजेक्ट करें। चैनल-स्वामित्व वाले प्रेषक/चैट मेटाडेटा को Plugin हुक ctx.channelContext तक पास करने के लिए channelContext का उपयोग करें; चैनल-विशिष्ट फ़ील्ड के लिए इस सबपाथ से PluginHookChannelSenderContext या PluginHookChannelChatContext को बढ़ाएँ।
• runChannelInboundEvent(...): एक आगत प्लेटफ़ॉर्म इवेंट के लिए इंजेस्ट, वर्गीकरण, प्रीफ़्लाइट, रिज़ॉल्व, रिकॉर्ड, डिस्पैच और फ़ाइनलाइज़ चलाएँ।
• dispatchChannelInboundReply(...): डिलीवरी एडैप्टर के साथ पहले से असेंबल किए गए आगत उत्तर को रिकॉर्ड और डिस्पैच करें।

इंजेक्ट किया गया Plugin रनटाइम उन बंडल्ड/नेटिव चैनलों के लिए runtime.channel.inbound.* के अंतर्गत वही उच्च-स्तरीय सहायक उजागर करता है जिन्हें पहले से रनटाइम ऑब्जेक्ट मिलता है।

await runtime.channel.inbound.run({  channel: "demo",  accountId,  raw: platformEvent,  adapter: {    ingest: normalizePlatformEvent,    resolveTurn: resolveInboundReply,  },});

संगतता डिस्पैचर को dispatchChannelInboundReply(...) इनपुट असेंबल करने चाहिए और प्लेटफ़ॉर्म डिलीवरी को डिलीवरी एडैप्टर में रखना चाहिए। नए भेजने वाले पथों को संदेश एडैप्टर और टिकाऊ संदेश सहायकों को प्राथमिकता देनी चाहिए।

माइग्रेशन

पुराने runtime.channel.turn.* रनटाइम एलियस हटा दिए गए थे। उपयोग करें:

• कच्चे आगत इवेंट के लिए runtime.channel.inbound.run(...)।
• असेंबल किए गए उत्तर संदर्भों के लिए runtime.channel.inbound.dispatchReply(...)।
• आगत संदर्भ पेलोड के लिए runtime.channel.inbound.buildContext(...)।
• runtime.channel.inbound.runPreparedReply(...) केवल चैनल-स्वामित्व वाले तैयार डिस्पैच पथों के लिए जो पहले से अपना डिस्पैच क्लोज़र असेंबल करते हैं।

नए Plugin कोड को turn-नाम वाले चैनल API नहीं जोड़ने चाहिए। मॉडल या एजेंट turn शब्दावली को एजेंट/प्रोवाइडर कोड के अंदर रखें; चैनल Plugin आगत, संदेश, डिलीवरी और उत्तर शब्दों का उपयोग करते हैं।