TanStack AI 1.0: واجهات مستقرة و23 مزوّداً، فهل حان وقت الاعتماد عليها؟

وصلت حزمة TanStack AI إلى الإصدار 1.0 في 23 أكتوبر، وخرجت معها كل حزمها الست والسبعون إلى الاستقرار دفعة واحدة. الخبر يبدو إعلان إصدار تقنياً عادياً، لكنه يهمّ كل فريق يبني ميزات ذكاء اصطناعي فوق React أو Vue أو Svelte، لأنه يعد بشيء نادر في هذا المجال: واجهة برمجية ثابتة لا تتغيّر تحت قدميك كل شهر، ومعها حرية اختيار المزوّد دون ارتباط بواحد منهم. في هذا المقال نشرح ما الذي تغيّر فعلاً، وما الذي كُسر عند الترقية، ومتى تعتمد الحزمة في مشروعك.

ما الذي يعنيه «1.0» هنا؟

في عالم الأدوات المتسارع، رقم 1.0 ليس تسويقاً فقط. هو التزام بأن الواجهات العامة لن تُكسر في إصدارات فرعية. بحسب مدونة TanStack الرسمية فإن الإصدار:

• يثبّت 76 حزمة معاً، ويشترط أن يكون العميل والخادم على 1.0 كليهما.
• يحذف كل واجهة اعتُبرت مهجورة في سلسلة 0.x.
• يعيد كتابة التوثيق بالكامل.
• يضيف حزمة تجريبية لتشغيل الوكلاء طويلي العمر.

القاعدة العملية الأولى: لا ترقِّ حزمة واحدة وتترك الباقي. حدّث كل حزم @tanstack/ai* في الوقت نفسه، وإلا ستظهر أخطاء عدم توافق بين العميل والخادم.

من 4 مزوّدين إلى 23

أوضح قفزة منذ النسخة التجريبية الأولى هي عدد المحوّلات. انتقل عدد مزوّدي النماذج المدعومين من أربعة إلى ثلاثة وعشرين، مع محوّل openaiCompatible يتيح ربط أي خدمة تتحدث بصيغة OpenAI. أما بيئات التنفيذ المعزولة (Sandbox) فقفزت من لا شيء إلى أحد عشر مزوّداً.

الجانب	قبل (ألفا)	الآن (1.0)
مزوّدو النماذج	4	23 + محوّل متوافق مع OpenAI
بيئات العزل	لا شيء	11
الحزم المستقرة	تجريبية	76
وكلاء البرمجة المدعومون	محدود	Claude Code وCodex وOpenCode وGrok Build وأي وكيل ACP

لماذا يهمّك ذلك؟ لأن تبديل المزوّد يصبح تغيير سطر إعداد بدلاً من إعادة كتابة طبقة كاملة. وهذا بالضبط ما يحتاجه الفريق الذي يتعلّم من حوادث الاعتماد على مزوّد واحد، كما ناقشنا في مقالنا عن خصم 30% وخطر الارتباط بمزوّد نموذج واحد.

ميزات الوكلاء: وكلاء فرعيون وقرارات مكتوبة الأنواع

يقدّم الإصدار ثلاث إضافات تخص بناء الوكلاء:

الوكلاء الفرعيون

يمكنك داخل chat() وuseChat تسليم دور المحادثة إلى وكيل فرعي مسمّى، مثل «باحث» أو «كاتب»، بمدخلات مكتوبة الأنواع وحدود صريحة. الفائدة تقسيم العمل المعقّد إلى أجزاء يسهل اختبارها وضبط تكلفتها.

دالة decide()

تعالج الاختيارات المكتوبة الأنواع: اختيار من قائمة، أو درجة رقمية، أو قرار نعم/لا. بدل أن تحلّل نصاً حراً من النموذج وتأمل أن يطابق توقعك، تحصل على قيمة بنوع معروف يمكن للمترجم فحصه.

مهارات الوكلاء المحمولة

يمكن لأي نموذج يدعم استدعاء الأدوات أن يحمّل مهارات بصيغة SKILL.md عند الحاجة. هذا يربط الحزمة بالمعيار الذي انضم أخيراً إلى مؤسسة الذكاء الوكيلي المفتوحة، فتكتب المهارة مرة وتستعملها في أدوات متعددة.

الاستقرار في أدوات الذكاء الاصطناعي ليس ترفاً: كل واجهة تُكسر تعني أسبوعاً من الترحيل لا يراه العميل ولا يدفع ثمنه.

الحزمة التجريبية: ai-harness

ثمة تنبيه مهم لمن ينجذب للعنوان فقط. حزمتا @tanstack/ai-harness و@tanstack/ai-harness-cli ما زالتا في سلسلة 0.x، وبعض نقاط الدخول في حزم أخرى مثل @tanstack/ai-skills/harness و@tanstack/ai-acp/agent تجريبية كذلك، وقد تتغيّر في إصدار فرعي. الهدف منها بناء وكلاء يعملون لفترات طويلة، كمساعدي البرمجة، ويستمرون عبر إعادة التشغيل ويقبلون التوجيه أثناء الدور.

نصيحتنا: استعمل النواة المستقرة في الإنتاج، وجرّب الـharness في مشروع جانبي فقط. لا تبنِ عليه مسار عمل حرجاً قبل أن يخرج من التجريب.

كيف تُرقّي مشروعك بأمان؟

أبرز التغييرات الكاسرة، بحسب ما أعلنه الفريق:

1. استبدال body بـforwardedProps.
2. استبدال conversationId بـthreadId، وصار إلزامياً في العميل والخادم معاً.
3. حذف كل الواجهات المهجورة في 0.x.

يقول الفريق إن معظم التطبيقات تنتقل بأداة تحويل آلية (codemod) ثم فحص الأنواع. خطّة معقولة:

• أنشئ فرعاً مستقلاً للترقية.
• حدّث كل حزم @tanstack/ai* معاً.
• شغّل الـcodemod ثم فحص الأنواع.
• اختبر مسارات المحادثة التي تعتمد على المعرّفات، لأن threadId الإلزامي هو الأرجح أن يكشف أخطاءً صامتة.
• راجع دليل الترحيل الرسمي قبل الدمج.

أسئلة شائعة

هل أستعمل TanStack AI بدل حزمة المزوّد مباشرة؟

إن كنت تعتمد مزوّداً واحداً ولن تغيّره، فالحزمة الرسمية له قد تكفي. أما إن أردت تبديل النماذج أو مقارنتها أو دعم أكثر من إطار واجهة، فطبقة موحّدة كهذه توفّر عليك وقتاً حقيقياً.

هل الإصدار 1.0 جاهز للإنتاج؟

النواة والحزم المستقرة نعم، فهذا معنى الإعلان. الحزم التجريبية للـharness لا، وهي موسومة صراحة بأنها قد تتغيّر.

كم إطار واجهة مدعوم؟

تختلف المصادر في العدد. المدونة الرسمية تذكر React وVue وSolid وSvelte وPreact وAngular وغيرها، وبعض المواقع تقول ثمانية وأخرى تسعة. راجع التوثيق الرسمي لإطارك تحديداً قبل الاعتماد.

الخلاصة

TanStack AI 1.0 خطوة نضج مهمة: واجهات ثابتة، ومزوّدون كثر، وأدوات وكلاء مكتوبة الأنواع. الترقية تحتاج انضباطاً، فحدّث الحزم كلها معاً وانتبه لـthreadId. أما الـharness فتعامل معه كتجربة حتى يستقر.

المصادر: TanStack AI 1.0، byteiota، daily.dev.