الانتقال إلى المحتوى الرئيسي
لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ النسخة الإنجليزية.
الأمر 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 من ai SDK الخاصة بـ Vercel مع @ai-sdk/openai/@ai-sdk/anthropic (وopenrouter هو @ai-sdk/openai موجّه إلى https://openrouter.ai/api/v1)، وكلها مبنية على fetch() ومعايير الويب فقط بلا أي استيراد node:*، فتُجمَّع وتعمل على Workers بنظافة؛ والـ leak check في الـ build يتحقق من كل bundle. الـ provider ollama غير مدعوم هنا: الـ endpoint الافتراضي محلي http://localhost:11434 والـ Worker لا يصل إليه؛ استخدم node-server أو docker له؛
  • الـ tools: current-date وday-name وhttp. الـ tool web-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 يُفشل كل طلب بخطأ يسمّيه.
    أي أن الـ model لا يستطيع اختيار host عشوائي ولا host يستغل DNS rebinding، لأن الأسماء التي أدرجتها وحدها تمر؛ والاسم المدرج موثوق أينما حُلّ، فلا تدرج إلا hosts تتحكم بهم أو تثق بهم. TLS يُتحقق منه دائمًا (لا يوجد خيار validateSSL) والـ tool تعمل بلا sandbox. أما tool من كتابتك تستدعي fetch() داخل Worker فلا تحصل على أي حماية من SSRF من الـ SDK.

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):
مفاتيح API الخاصة بالـ providers تُقرأ من Worker bindings بأسماء <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")، ومفتاحه في الـ binding OPENAI_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(): الأب يفوّض عبر الـ tool task أو الاسم البديل 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، تكون lousho subset آمنًا للـ 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.
إلى ماذا تصل الـ tool على Worker: ملف الـ tool يعمل داخل isolate الـ Worker، لا داخل sandbox، وبصلاحيات باقي الـ Worker نفسها. يستطيع استدعاء 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 التي يجب أن تعمل مرة واحدة لكل فاتورة تحتاج أيضًا مفتاحًا من وسائطها هي (رقم الفاتورة هنا):
وحين يجب أن يكون الأمر دقيقًا، احفظ الـ approvals في store فيه حجز atomic: Durable Object، أو D1 عبر 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 })، يعمل دون تعديل؛ ولا حاجة إلى flag nodejs_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.