useChat من @ai-sdk/react ومثيلاتها في Vue وSvelte وAngular)، فيمكنك إبقاؤها على حالها وتشغيل Lousho agent خلف الـ route. ثلاث دوال مُصدَّرة من جذر الحزمة تتولى التحويل. لا تستورد شيئًا من ai، ولا تستخدم أي node:* module، وتعمل على Node وWorkers وأي runtime مبني على Fetch.
Route handler
بادئة الـ modelvendor/ هي التي تختار الـ provider؛ ومع OpenRouter استخدم openrouter/<vendor>/<model> (مثلًا openrouter/openai/gpt-4o-mini).
toUIMessageStreamResponse(agent.stream(fromUIMessages(messages))).
Client
ai 6 و7 (useChat يأخذ transport، وsendMessage يرسل الرسالة). على ai 4 — وهو peer مدعوم أيضًا — useChat({ api: '/api/chat' }) يأخذ الـ endpoint مباشرة ويرجع input وhandleInputChange وhandleSubmit بدل sendMessage؛ أما ai 5 فليس ضمن الـ peer range.
Event mapping
الـ snapshots التي تأتي من streaming tool تصل كـ preliminary outputs، و
useChat يعرضها كـ output للـ tool part مع preliminary: true. أما الـ tool.done الذي يليها فبدون preliminary، وهو الـ output النهائي.
الأحداث التي ليس لها مقابل في الـ UI — retries وcompaction وقرارات الصلاحيات وguardrails وغيرها — وأحداث الـ sub-agents لا تصل. وfinishReason في الـ finish chunk هو الخاص بـ AI SDK (stop، length، content-filter، tool-calls، error؛ وأي قيمة أخرى مثل awaiting-approval أو max-steps تتحوّل إلى other).
Usage والتكلفة
الـ usage يُوضع فيmessageMetadata الخاصة بالـ finish chunk، فتجده في message.metadata على رسالة الـ assistant المكتملة:
usage هو الـ AgentEventUsage للـ run (يغيب إذا فشل الـ run)؛ وloushoFinishReason هو الـ finish reason الخاص بالـ run نفسه، بدون mapping.
Approvals وask_question
الـ tool الذي يحتاج approval (موافقة)، أو استدعاء ask_question، يوقّف الـ run: الـ stream ينتهي بـ finish مع loushoFinishReason: "awaiting-approval"، بعد data part مخصص يعرضه useChat كـ part من النوع data-lousho-approval:
kind وquestion موجودان فقط في حالة ask_question؛ أما الـ tool الذي ينتظر تسجيل دخول OAuth فيحمل بدلها kind: 'sign-in' وsignIn: { provider, displayName?, url } — اعرض الرابط، وعندما يُعيد الـ provider المستخدم، اعتمده («سجّلت الدخول»). ارسم الـ part بأزرارك وأجب عليه عبر الـ approvals route في الـ session API (POST /chat/:sessionId/approvals/:approvalId، راجع Sessions وApprovals): { "approved": true } أو { "approved": false, "note": "..." } للـ tool، و{ "answer": "prod" } للسؤال. الاستجابة هي تكملة الـ run كـ event stream: يمكنك قراءته بالـ parser الذي توفره الـ UI bindings، أو تجاهله واستدعاء sendMessage من useChat من جديد؛ أو في الـ route لديك، استدعِ agent.approvals.streamResolve() / streamAnswer() وأرجع toUIMessageStreamResponse() للنتيجة، فتظهر التكملة في نفس المحادثة.
تحويل الرسائل الواردة
fromUIMessages() تحوّل الـ text parts إلى نص، والـ file parts من نوع image/* إلى image parts، وباقي الـ file parts إلى file parts — والـ url الخاص بالـ part (عنوان data: أو http(s)) يصبح هو البيانات. أما أجزاء الـ tool وreasoning وdata وsource وأي جزء غير معروف فتتجاهلها، والرسائل التي تصبح فارغة تحذفها.
الرسائل تأتي من الـ client، لذا لا يُحتفظ إلا برسائل user وassistant: رسالة system (أو أي role آخر، أو أي عنصر ليس رسالة أصلًا) تُحذف، كي لا يتمكن المستدعي من إضافة تعليمات إلى الـ prompt الخاص بالـ agent. حدّد التعليمات على الـ agent نفسه (createAgent({ instructions }))، لا في الطلب.
قد يُضاف لاحقًا subpath مخصص lousho/ai-sdk-ui؛ أما حاليًا فالدوال تأتي من جذر الحزمة.