npx lousho build --target=cloudflare-worker --agent=agent.yaml يولّد module Worker باسم worker.ts، وwrangler.toml، وbundle هو dist/worker.js يفحصه الـ build بحثًا عن استيرادات node:. يحتاج tsup وwrangler مثبتين، ويأخذ ملف agent spec أو agent directory (npx lousho build ./my-agent --target=cloudflare-worker). الـ Worker يقدّم نفس HTTP API التي تقدّمها الأهداف الثانية. هذا الهدف هو الأضيق حدودًا بين الثلاثة، فنبدأ بحدوده.
ما يعمل وما لا يعمل
lousho build يرفض spec يكون الـ provider أو الـ tool فيه خارج عمود Worker، ويرفض agent directory فيه مجلد أو إعداد لا يذكره عمود Worker. الخطأ LOUSHO_DEPLOY_FAILED يسمّي العنصر ويقترح --target=node-server أو --target=docker.
Providers and tools
أسباب صفوف الـ providers والـ tools:-
الـ providers:
mockوopenaiوanthropicوopenrouter. الـ providers الحقيقية مبنية علىgenerateText/streamTextمنaiSDK الخاصة بـ Vercel مع@ai-sdk/openai/@ai-sdk/anthropic(وopenrouterهو@ai-sdk/openaiموجّه إلىhttps://openrouter.ai/api/v1)، وكلها مبنية علىfetch()ومعايير الويب فقط بلا أي استيرادnode:*، فتُجمَّع وتعمل على Workers بنظافة؛ والـ leak check في الـ build يتحقق من كل bundle. الـ providerollamaغير مدعوم هنا: الـ endpoint الافتراضي محليhttp://localhost:11434والـ Worker لا يصل إليه؛ استخدمnode-serverأوdockerله؛ -
الـ tools:
current-dateوday-nameوhttp. الـ toolweb-fetchغير مدعومة. على Node ترفضhttpوweb-fetchالوجهات الخاصة عبر DNS lookup خاص بها (node:dnsداخلAgentمنundici) يفحص كل عنوان يُحلّ إليه الـ host ويتصل بالعنوان الذي فحصه، فهجوم DNS rebinding لا يتجاوز الفحص. الـ Worker لا يملك أيًّا من الاثنين:fetch()يحلّ الأسماء داخل شبكة Cloudflare ولا يعطي أي hook لرؤية العنوان أو تثبيته. ما يستطيع الـ Worker فحصه هو الـ URL (الـ scheme، واسم الـ host، والـ host بصيغة IP literal)؛ وما لا يستطيع ضمانه هو إلى أين يتصل اسم الـ host، فالاسم الذي يُحلّ إلى عنوان داخلي لن يُكتشف. لذلكhttpعلى الـ Worker (باسم الـ tool نفسهhttp_requestوالمدخلات نفسها كما على Node) هي tool مختلفة: تصل فقط إلى أسماء الـ hosts التي تدرجها. عند أول URL وعند كل redirect ترفض:- أي scheme غير
http:وhttps:؛ - host بصيغة IP (
http://10.0.0.1/وhttp://[::1]/)، حتى لو كان مدرجًا: لا يوجد فحص للعناوين، فالمسموح أسماء فقط؛ - host لا يطابق الـ binding
LOUSHO_HTTP_ALLOW، وهو قائمة مفصولة بفواصل من أسماء الـ hosts (api.github.com) وwildcards بـ*.(*.example.com، وهي تطابق الـ subdomains فقط، لاexample.comنفسه). إذا كان الـ binding غير مضبوط أو فارغًا يُرفض كل طلب (fail closed)؛ وإدخال ليس اسم host يُفشل كل طلب بخطأ يسمّيه.
validateSSL) والـ tool تعمل بلا sandbox. أما tool من كتابتك تستدعيfetch()داخل Worker فلا تحصل على أي حماية من SSRF من الـ SDK. - أي scheme غير
Build and deploy
الـ build يولّد module Worker (export default { fetch }، ومعه scheduled حين
يعلن المصدر cron triggers) ويجمّعه كـ ES module
لمنصة المتصفح؛ ويفشل الـ build إذا انتهى أي استيراد node: داخل
dist/worker.js. حقل main في wrangler.toml يشير إلى dist/worker.js
مع no_bundle = true، فيُرفع بالضبط الـ bundle الذي تم التحقق منه. وقيمة
compatibility_date فيه افتراضيًا تاريخ مثبّت لكل إصدار من الـ SDK (2026-09-01).
أول build يكتب الملف كاملًا؛ والـ builds التالية تحدّث فقط المفاتيح التي يملكها
الـ build (name وmain وno_bundle و[triggers] crons) وتُبقي كل ما
غيّرته أو أضفته: compatibility_date الخاص بك، و[vars]، وكتلة [[kv_namespaces]]
المملوءة، والـ routes، والتعليقات. يُبنى ويعمل
مع ai v4 (التثبيت الافتراضي) أو ai v7 (مع
@ai-sdk/openai/@ai-sdk/anthropic v4) مثبتة، بلا أي
compatibility flag (أي بلا nodejs_compat):
<TYPE>_API_KEY (مثلًا
wrangler secret put OPENAI_API_KEY أو wrangler secret put ANTHROPIC_API_KEY أو
wrangler secret put OPENROUTER_API_KEY). والـ peer packages (@ai-sdk/openai لكل من
openai وopenrouter، و@ai-sdk/anthropic لـ anthropic، وai) يجب أن تكون
مثبتة بجانب lousho كي يجمّعها lousho build.
مجلدات agent على Worker. الـ Worker لا يملك file system ولا يستطيع استيراد
ملفًا بمساره وقت التشغيل، لذلك الـ build يقرأ
agent directory على Node ويكتب agent.module.ts:
استيراد ثابت لكل ملف tools/*.ts وschedules/*.ts وchannels/*.ts و
memory/*.ts (ولإعدادات agent.ts / agent.js إن وُجدت)، وبشكل recursive
لكل مجلد subagents/<name>/، مع نسخ instructions.md وإعدادات JSON/YAML
والـ skills وملف projectInstructions كـ JSON. والـ Worker يبني الـ agent
بنفس قواعد resolveAgentDir() (مفاتيح الإعدادات، وصادرات
الـ tools، وأسماء الـ tools المكررة):
- يجب أن يسمّي
modelفي الإعدادات provider من الجدول أعلاه ("model": "openai/gpt-4o-mini")، ومفتاحه في الـ bindingOPENAI_API_KEY؛ أو أن يضبطagent.tsالخاصيةproviderعلى instance. بادئةvendor/في الـ model تختار الـ provider؛ ومع OpenRouter استخدمopenrouter/<vendor>/<model>(مثلopenrouter/openai/gpt-4o-mini). لا توجد بيئة تعطي model افتراضي، لذلك يُرفض المجلد الذي يخلو من الاثنين. - إعدادات JSON/YAML يفحصها
lousho build(وإعدادات الـ sub-agent أيضًا، حين لا تكون كود)؛ أما إعداداتagent.tsفتُفحص عند إقلاع الـ Worker، فيبلّغwrangler deployعن المشكلة. - مجلدات
subagents/<name>/تُضمَّن بشكل recursive، وبنفس قواعد التخطيط المتبعة في مجلد الأب. كل واحد يحتاجdescriptionفي إعداداته (يقرأها model الأب ليقرر متى يفوّض). وكل واحد sub-agent أصلي (native) للأب، كما معloadAgentDir(): الأب يفوّض عبر الـ tooltaskأو الاسم البديلdelegate_to_<name>، والـ sub-agent يعمل داخل run الأب، فتسري فيه قواعدpermissionsالخاصة بالأب، والـ approvals الخاصة به توقف الأب (وapproveالمضمّن الخاص به يبتّ فيها أولًا)، واستهلاكه يُضاف إلى استهلاك الأب (راجع Sub-agents). والـ sub-agent يرث model الأب ما لم تضبط إعداداته model خاصًا به. - ملفات
schedules/تصبح cron triggers: الـ build يقيّم كل ملف ليكتب تعبير cron الخاص به في[triggers] cronsضمنwrangler.toml(نفس قواعد triggers الـ spec: UTC وخمسة حقول وأسماء الأيام)، والـ Worker المولَّد يصدّر handler باسمscheduled()يشغّلها. وبدونschedules/لا يوجدscheduled(). - قنوات
channels/تُركَّب تحت/channels(POST /channels/<name>وPOST /channels/<name>/approvals/:id): نفس المسارات والقواعد التي يطبقهاmountChannels()على Node، على Fetch API. والقنوات تصادق نفسها بنفسها (verify)، فـLOUSHO_API_TOKENلا يغطيها. والـ turn الذي يعيش أطول من الـ webhook الذي أُقرّ به يكمل العمل تحتctx.waitUntil. - خانات
memory/تحتاج provider يعمل بلا file system.kvMemory()يحفظ عناصر الخانة تحت مفاتيحmemory/<slot>#<scope>في KV namespace المسمىAGENT_CHECKPOINTS(أو في الـ binding الذي يسمّيه خيارbinding)؛ وبدون ذلك الـ binding تعيش العناصر في ذاكرة isolate واحد.inMemoryMemory()يعمل بنفس الطريقة؛ أماfileMemory()فلا يمكن تشغيله هنا. projectInstructions: trueيقرأ أقربAGENTS.md/CLAUDE.mdوقت الـ build ويضمّن نصه؛ وكائن الخيارات (cwdوfiles) في إعدادات JSON/YAML يُحترم بنفس الطريقة. أما في إعداداتagent.tsفيمكن تضمينtrueفقط — كائن الخيارات يُرفض عند إقلاع الـ Worker.- ملفات الـ tools تُجمَّع من مكانها، فتنحلّ استيراداتها النسبية و
node_modulesالخاصة بها كما في التطوير. والـ tool التي تستورد Node builtin تُفشل الـ leak check في الـ build، الذي يسمّي الملف. - داخل tool أو
agent.ts، تكونloushosubset آمنًا للـ Worker من الحزمة:defineToolوisDefinedToolوalwaysوneverوonceوdefineSkillوdefineScheduleوisDefinedScheduleوdefineChannelوhttpChannelوslackChannelوdiscordChannelوtelegramChannelوgithubChannelوteamsChannelوdefineMemoryوinMemoryMemoryوkvMemoryوcreateMockProviderوMockLLMProviderوOpenAIProviderوAnthropicProviderوOpenRouterProviderوfromAiSdkوLLMProviderRegistryوtextOfوSDKErrorوConfigurationErrorوToolExecutionErrorوValidationError. واستيراد أي اسم آخر يُفشل الـ build مع عرض هذه القائمة؛ أما type-only imports فتعمل لكل type.
fetch() لأي host
(LOUSHO_HTTP_ALLOW يقيّد الـ tool المدمجة http فقط، لا كودك)، ويشارك
ذاكرة الـ isolate مع كل session يخدمها الـ isolate (وبدون
AGENT_CHECKPOINTS يشمل ذلك الـ sessions نفسها). الـ SDK لا يعطي الـ tool كائن
env الخاص بالـ Worker (مفاتيح API الخاصة بالـ providers وLOUSHO_API_TOKEN والـ KV namespace)،
والـ build لا يحلّ استيرادات cloudflare:، فيفشل الـ build عند
import { env } from 'cloudflare:workers'؛ لكن الكود داخل isolate واحد ليس حدًّا أمنيًا. لا تنشر إلا كود
tools تثق فيه مع هذه الـ bindings.
Bindings
الـ Worker يقدّم HTTP API:GET /health، وPOST /chat
مبثوثًا كـ SSE (ReadableStream)، وGET /chat/:sessionId، وendpoint
الـ approvals، وجسم { "message" } المُهمَل. وقنوات channels/ في agent
directory تضيف مساراتها تحت /channels (انظر أعلاه). الـ bindings الخاصة به:
يُولَّد
wrangler.toml وكتلة [[kv_namespaces]] الخاصة بـ
AGENT_CHECKPOINTS فيه معلّقة، مع أوامر إنشاء الـ namespace
(npx wrangler kv namespace create AGENT_CHECKPOINTS، ونسخة
--preview منها) ومكان لصق الـ ids الناتجة. أزل التعليق عنها واملأ الـ ids.
وإذا كانت الـ spec تدرج http ففيه أيضًا كتلة [vars] معلّقة من أجل
LOUSHO_HTTP_ALLOW؛ أزل التعليق عنها واذكر الـ hosts الخاصة بك:
Sessions, checkpoints and approvals
KVStore(kvBinding, { prefix?, ttl?, historyLimit?, tokenKey? }) هو الـ AgentStore الذي
يبنيه الـ Worker المولَّد من الـ binding. أما الـ Worker المكتوب باليد فيستورده من
الـ subpath /kv، الذي لا يحتوي أي استيراد node:* في أي موضع من dependency graph الخاص به،
مع تعريف الـ binding بالنوع KVBinding (الجزء get/put/delete من
KVNamespace في Cloudflare، فلا تحتاج @cloudflare/workers-types). وcreateAgent يأتي
من الـ subpath /worker — راجع كتابة Worker بنفسك:
/kv يصدّر أيضًا KVCheckpointStore (للـ checkpoints فقط) و
CHECKPOINT_KV_BINDING ('AGENT_CHECKPOINTS'، وهو اسم الـ binding الذي يقرؤه الـ Worker
المولَّد). مفاتيح KVStore، وقبل كل منها prefix اختياري:
ttl: { sessions?, checkpoints?, approvals? } (بالثواني، وKV يقبل 60 فأكثر)
يجعل كل نوع سجل ينتهي بعد هذه المدة من آخر كتابة؛ وافتراضيًا
تبقى السجلات حتى تُحذف.
يمكن البتّ في approval أوقف turn في طلب ما، عبر طلب لاحق
على isolate آخر: الـ session ذات الـ checkpoint تسمّي الـ approval المعلّق،
وendpoint الـ approvals يتابعه من KV. والمتابعة تُبث كـ run مستأنف عادي:
tool.resume وtool.done للاستدعاء الذي بُتّ فيه (tool.error عند الرفض)،
ثم أحداث الـ turn، وتنتهي بـ run.done يحمل النص النهائي.
البتّ في approval واحد مرتين
KV لا يملك compare-and-swap، لذلك لا يستطيعKVStore أن يحجز approval بشكل atomic
كما يفعل fileStore وSqliteStore. للبتّ في approval، يكتب الطلب
token عشوائيًا تحت approvals/<id>#claim (ما لم يكن هناك حجز سابق)،
وينتظر 50 ms، ثم يقرؤه من جديد، والطلب الذي ما زال الـ token الخاص به موجودًا
(وما زال يجد الـ approval) هو وحده الذي يحذف الـ approval ويشغّل الاستدعاء. وفي
موقع واحد، حيث يكتب الطلب المتزامن الـ token الخاص به داخل تلك النافذة، فإن
النقرة المزدوجة أو الـ webhook المُعاد أو مراجعَين يبتّان في الوقت نفسه يشغّلون
الـ tool الموافق عليها مرة واحدة بالضبط. والـ run leases (checkpoints/<id>#lease) تُؤخذ
بنفس الطريقة.
هذا لا يغلق السباق بين المواقع: طلبان يخدمهما موقعا edge مختلفان
داخل مهلة الانتشار في KV (حتى نحو 60 ثانية) قد يقرأ كل منهما الـ token
الخاص به ويشغّل كلاهما الاستدعاء. لـ tool لها أثر جانبي يجب أن يحدث
مرة واحدة (دفعة، أو بريد إلكتروني)، مرّر ctx.approval.id كـ
idempotency key. هو نفسه في كل محاولة لتشغيل استدعاء واحد بُتّ فيه. لكنه
لا يعرّف الحدث التجاري: بعد crash قد يعيد الـ model المحاولة باستدعاء
جديد يأخذ معرّف approval جديدًا، لذلك الـ tool التي يجب أن تعمل مرة واحدة لكل
فاتورة تحتاج أيضًا مفتاحًا من وسائطها هي (رقم الفاتورة هنا):
ApprovalStore من كتابتك تحذف resolve() فيه
السجل وترجعه في statement واحد. الـ Worker المولَّد لا يربط
أي Durable Object، لذلك يستخدم KVStore.
الـ POST /chat { "message", "sessionId"? } المُهمَل يحتفظ بسلوكه القديم
على Workers: مع sessionId يُحفَظ الـ run كـ checkpoint في
checkpoints/<sessionId> بعد كل نتيجة tool، وطلب لاحق
يعيد استخدام sessionId يستعيده (بعد crash أو إعادة تدوير isolate).
Scheduled runs
الـ cron triggers في الـ spec (triggers: [{ type: 'cron', cron: '0 9 * * MON', input: '...' }])
تصبح [triggers] crons = [...] في wrangler.toml، والـ Worker المولَّد
يصدّر handler باسم scheduled() يشغّلها كـ turns للـ agent (الـ session
schedule-<name>-<fire time>، راجع Schedules). وملفات schedules/ في agent
directory تعمل بنفس الطريقة: الـ build يقيّمها لاستخراج التعابير ويولّد تصدير
scheduled(). Cloudflare تقيّم
التعابير بتوقيت UTC وبدقة دقيقة واحدة؛ والـ build يرفض
timezone أو حقل ثوانٍ أو اختصار @daily أو يوم أسبوع
رقمي (LOUSHO_SCHEDULE_INVALID).
وفي Worker تكتبه بنفسك، اربط agent معرَّفًا في الكود عبر
handleScheduled(agent, schedules, controller, ctx) (مُصدَّرة من
lousho/worker —
فالمحدِّد lousho/deploy-runtime-worker في الكود المولَّد
محدِّد virtual لا يحلّه إلا الـ bundler الخاص بـ lousho build؛ لا تستورده بنفسك). تشغّل الـ schedules التي
يساوي cron فيها controller.cron داخل ctx.waitUntil() ولا ترمي أي شيء؛
وعليك أنت إدراج التعابير نفسها تحت [triggers] crons. أعطِ الـ agent store —
فبدونها تعيش session الـ run المجدول في ذاكرة isolate واحد
وتختفي عند إعادة تدويره:
كتابة Worker بنفسك
استورد منlousho/worker، لا من جذر الحزمة. المدخل الجذر
يصدّر أيضًا file stores ومحمّل agent directory وMCP عبر stdio وsandboxes
ووحدات أخرى خاصة بـ Node، فتجميعه لـ platform: 'browser' يفشل بـ
Could not resolve "async_hooks" وأمثاله. أما /worker فهو createAgent
زائد السطح الآمن للـ Worker، مبني بالـ shims نفسها التي
يطبقها lousho build، فلا يحمل أي استيراد node: قد يتعثر فيه الـ bundler الخاص بك:
createAgent (وأنواع إعداداته)، وmemoryStore، ومخازن KV
(KVStore وKVCheckpointStore وCHECKPOINT_KV_BINDING)، ومساعدات الـ schedules
(defineSchedule وhandleScheduled وأنواعهما)، وserveFetch
(واجهة /chat HTTP كـ fetch handler،
لـ Worker يريد المسارات نفسها التي يقدّمها الـ Worker المولَّد)،
والـ providers التي يستطيع الـ Worker تشغيلها (mock وopenai وanthropic و
openrouter)، وكل ما يجوز لكود agent directory استيراده (defineTool و
isDefinedTool وalways وnever وonce وdefineSkill وdefineChannel و
الـ channel factories وdefineMemory وinMemoryMemory وkvMemory وfromAiSdk و
textOf وأصناف الأخطاء).
نقطتان تعرفهما:
aiوzodو@opentelemetry/apiوحزم الـ providers (@ai-sdk/openaiو@ai-sdk/anthropic) لا تُجمَّع داخل/worker— تنحلّ من تثبيتك كي تتشارك نسخةaiالخاصة بك. ثبّت الـ peer الذي يحتاجه الـ provider الخاص بك (لا شيء لـmock)؛ وإذا ظل الـ bundler يحاول حلّ واحدة لم تثبّتها، فعلّمهاexternal— الـimport()الكسول لا يعمل أبدًا لـ provider لا تنشئه أصلًا.- الميزات التي لا يستطيع الـ Worker تشغيلها — project instructions، وfile session
store، وguardrail patches، وtools داخل sandbox، وcode mode،
والـ provider
ollama— تُحمَّل كـ shims تفشل عند استدعائها، تمامًا كما في الـ Worker المولَّد. وكذلكmcpServers(stdio وstreamable HTTP): المدخل المنشور لا يستطيع الاحتفاظ بمحدِّد external للـ peer الاختيارية@modelcontextprotocol/sdk، فيفشل الاتصال عند أول استخدام — استخدمlousho build(الـ Worker المولَّد) أو هدف Node لأجل MCP. كل شيء آخر، بما فيه turn منcreateAgent({ provider, store })، يعمل دون تعديل؛ ولا حاجة إلى flagnodejs_compat.
الاتساق
عمر الطلب في Worker أقصر من أن يناسبCheckpointStore في الذاكرة أو
معتمدًا على file system (راجع
الإعدادات / src/execution/checkpoint.ts لتعرف
ما هو CheckpointStore ولماذا يحتاج الـ run إليه لينجو من crash أو
من توقف عند بوابة approval). وAGENT_CHECKPOINTS هو هذا الـ store، مدعومًا بـ KV
(KVCheckpointStore)، والـ binding الواحد أعلاه يكفي لتفعيله.
لماذا KV لا D1 ولا Durable Objects: الـ Checkpoint هو blob JSON واحدة مفتاحها
sessionId، تُقرأ وتُكتب كاملة — وهذا بالضبط الشكل الذي بُني له Workers KV،
بلا أي بنية تحتية إضافية سوى binding إلى namespace. أما D1
فكانت ستعطيك قدرة استعلام relational لا يحتاجها هذا الـ store؛ وأما Durable Object
فكانت ستعطيك اتساقًا صارمًا لكل session على حساب إعداد
DO class وmigration ودفع كلفة object ذي حالة لكل session. إذا كان
حملك فعلًا يحتاج read-after-write consistency صارمة عبر
مواقع الـ edge (راجع الملاحظة أدناه)، فـ CheckpointStore مدعومًا بـ Durable Object
هو مسار الترقية الطبيعي — بتنفيذ واجهة CheckpointStore نفسها
(save/load/delete) على namespace لـ Durable Object
بدل namespace لـ KV.
الـ eventual consistency — اقرأ هذا قبل الاعتماد عليها في مسارات
الـ approvals: Workers KV مخزن eventually consistent. الـ put()
يظهر فورًا لموقع الـ edge الذي كتبه، لكنه قد يستغرق حتى
~60 ثانية لينتشر إلى باقي مواقع edge في Cloudflare عالميًا. عمليًا
يعني هذا: إذا كُتب checkpoint لـ session في موقع edge ووصل بعده بقليل طلب
لنفس sessionId إلى موقع edge مختلف، فقد يرى ذلك الطلب
بيانات قديمة (checkpoint أقدم، أو لا شيء) بدل ما كُتب للتو.
وهذا يهم أكثر في توقفات الـ approvals، لأن التوقف
والاستئناف الذي يطلقه approval الإنسان لاحقًا طلبان منفصلان بطبيعتهما
قد يصلان إلى موقعين مختلفين. هذا الـ SDK لا يَعِد — وفي ظل
ضمانات KV لا يستطيع أن يَعِد — بـ read-after-write consistency صارمة هنا.
إذا كان مسار الـ approval عندك لا يحتمل هذه النافذة، وجّه طلبات الـ session الواحدة
إلى موقع Cloudflare واحد بنفسك (مثلًا عبر توجيه طلبات مبني على
Durable Object) أو استخدم store قوي الاتساق
بدل AGENT_CHECKPOINTS/KV. وينطبق الشيء نفسه على الـ sessions: طلبان من
نفس الـ session في اللحظة نفسها قد يكتب أحدهما فوق turn الآخر، لأن
read-modify-write في KV ليست atomic.
حجم الـ bundle ووحدات Node المدمجة
مخازن KV (KVStore وKVCheckpointStore وCHECKPOINT_KV_BINDING،
المُصدَّرة من lousho/kv) لا تحتوي أي إشارة node:* في
أي موضع من dependency graph الخاص بها، وكذلك مدخل lousho/worker الذي
يجمّعه Worker مكتوب باليد (بناؤه يُفحص بنفس الطريقة؛ راجع كتابة Worker
بنفسك). الـ Worker يشغّل الـ spec كـ agent من createAgent()،
والـ build يوجّه استيراداتها الخاصة بـ Node فقط (project instructions، وfile session
store، وguardrail patches، وMCP عبر stdio) إلى shim يفشل عند استخدامه
(src/deploy/shims/node.worker.ts). ثم تُفحص حزمة dist/worker.js المبنية
بحثًا عن node: وعن محدِّدات وحدات Node المدمجة المجرّدة ضمن lousho build،
ويفشل الـ build إن وُجد منها شيء؛ وحين يكون أحدها قد استُورد (من tool في agent
directory مثلًا) يسمّي الخطأ الملف المستورِد. استثناء واحد: ai v7 و
@ai-sdk/provider-utils v5 يبحثان عن node:module وnode:dns و
node:diagnostics_channel وnode:async_hooks وقت التشغيل عبر
process.getBuiltinModule()، وفقط حين يكتشفان Node، ويرجعان إلى
fetch() (أو يتخطيان telemetry tracing) في غيره. وهذه الـ ids الأربعة
تُقبل وسيطًا لاستدعاء كهذا ولا تُقبل في أي موضع آخر. والـ bundle أكبر من Worker
بـ turn واحد (نحو 1.7 MB خام و340 KB بـ gzip لـ agent mock على ai v4؛ ونحو 3.4 MB
خام و630 KB بـ gzip على ai v7): lousho build يبلّغ عن
حجمه، وdescribe() تقارنه بحد حجم السكربت في Cloudflare.