‏Flue: فریم‌ورک TypeScript برای ساخت ایجنت‌های هوش مصنوعی

Flue یه فریم‌ورک TypeScript‌ه که ادعا می‌کنه نه یه SDK معمولی، بلکه یه «harness» کامل برای ساخت ایجنت‌های هوش مصنوعی خودمختاره. ایده اصلی اینه که ایجنت‌های قدرتمندی مثل Claude Code یا Codex به همین معماری تکیه می‌کنن — مدل به‌تنهایی کافی نیست؛ باید بهش زمینه، ابزار، حافظه و یه محیط امن برای کار دادی.

معماری Flue از چهار لایه تشکیل شده: Model (توکن‌ها، ابزارها و promptها)، Harness (مهارت‌ها، حافظه و session‌ها)، Sandbox (bash، امنیت و شبکه) و Filesystem (خواندن، نوشتن، جست‌وجو در فایل‌ها). این لایه‌بندی به ایجنت اجازه می‌ده که برنامه‌ریزی کنه، فایل بنویسه، subagent بسازه و وظایف رو به متخصصان مختلف واگذار کنه.

در Flue، یه ایجنت با تابع createAgent تعریف می‌شه و می‌شه بهش مدل، ابزار، مهارت و sandbox اختصاص داد:

export default createAgent(() => ({
  model:   'anthropic/claude-sonnet-4-6',
  tools:   [...githubTools],
  skills:  [triage, verify],
  sandbox: local(),
  instructions,
}));

Skills یه مفهوم جالب توی Flue‌ان — بسته‌هایی از دانش تخصصی که می‌شه از فایل‌های Markdown ایمپورت کرد و به ایجنت داد تا در موقع نیاز ازشون استفاده کنه. Tools هم action‌های typed‌ای هستن برای فراخوانی APIها و تعامل کنترل‌شده با سیستم‌های خارجی.

قابلیت‌های دیگه‌ای که Flue ارائه می‌ده شامل می‌شه: اجرای بادوام (Durable Execution) که در صورت crash بازیابی می‌کنه، پشتیبانی از پروتکل MCP برای اتصال به سرویس‌های خارجی، observability با OpenTelemetry و Braintrust، و اتصال به ابزارهایی مثل Slack، GitHub و Discord. استقرار هم روی Node.js، Cloudflare Workers، GitHub Actions و چند پلتفرم دیگه پشتیبانی می‌شه.

نکات کلیدی:

• ایجنت = مدل + harness؛ فقط مدل کافی نیست
• معماری چهارلایه: Model، Harness، Sandbox، Filesystem
• Skills از فایل‌های Markdown ایمپورت می‌شن و دانش تخصصی رو به ایجنت می‌دن
• پشتیبانی از HTTP و WebSocket برای expose کردن ایجنت‌ها
• قابل استقرار روی Node.js، Cloudflare Workers، GitHub Actions و GitLab CI/CD