منصوبے کے بارے میں

Vocion (@vocion/core) ایک اوپن فریم ورک ہے جو AI ایجنٹ کے کاموں کو صرف پروٹو ٹائپنگ کے بجائے پروڈکشن میں چلانے کے لیے بنایا گیا ہے۔ اس کا README اسے ایک ایسے انجینئر یا ٹیک لیڈ کے لیے موزوں قرار دیتا ہے جو ایجنٹس کی ایک ٹیم کو پروڈکشن میں منتقل کر رہا ہو، اور واضح طور پر بتاتا ہے کہ یہ پروجیکٹ کہاں موزوں نہیں ہے: جیسے کہ ایک واحد چیٹ بوٹ، ایک ون-آف اسکرپٹ، یا کوئی ہوسٹڈ نو-کوڈ بلڈر۔ یہ فرض کرتا ہے کہ آپ Postgres استعمال کرتے ہیں، کنفیگریشن کو git میں رکھتے ہیں، اور اہم اقدامات پر انسانی مداخلت (human in the loop) چاہتے ہیں۔ اس کا کور پیکیج npm پر شائع نہیں ہے؛ آپ ریپوزٹری کو کلون کرتے ہیں اور اسے خود چلاتے ہیں۔ پلیٹ فارم کن چیزوں کا مجموعہ ہے Vocion کو ایک Next.js ایپ، Postgres اسکیما، MCP سرور اور ورک فلو رنر کے مجموعے کے طور پر بیان کیا گیا ہے۔ آپ Sources، Objects، Skills، Playbooks، Workflows، Missions، Automations، Agents اور Teams کو git میں YAML اور markdown کے طور پر لکھتے ہیں، انہیں ڈیٹا بیس پر لاگو کرتے ہیں، اور ایک ٹائپڈ رن ٹائم حاصل کرتے ہیں جس میں ایک متحد انسانی ریویو کیو، آبزرو ایبلٹی (observability) اور پلگ ان ایکو سسٹم موجود ہوتا ہے۔ تین ورک موڈز ایک ہی رن ٹائم استعمال کرتے ہیں: - Workflows: طے شدہ اقدامات جن میں منظوری (approve) اور سوال (ask) کے گیٹس ہوتے ہیں۔ - Missions: کھلے اختتام والی مستقل ذمہ داریاں، جہاں ایجنٹس کی ایک ٹیم منصوبہ بندی کرتی ہے، کام کرتی ہے اور ریویو کے لیے نتائج تیار کرتی ہے۔ - Teams: ایک لیڈ کے تحت گروپ کیے گئے متعدد ایجنٹس جن کا ایک ذمہ دار انسان ہوتا ہے۔ دیگر صلاحیتوں میں Google Ads، GA4، HubSpot، Gmail، Slack اور Google Drive کے لیے ایک بلٹ-ان کنیکٹر پیک شامل ہے؛ ایک ملٹی-ٹیننٹ کنٹرول پلین جس میں ٹیننٹ Bearer ٹوکنز ہوتے ہیں؛ ایک رائٹ API جو REST کے ذریعے ریویو کیو کو ظاہر کرتی ہے؛ اور ایجنٹ اور ٹول پلین کے طور پر HTTP پر MCP۔ ڈسکوری اور میوٹیشن کی اجازتیں الگ ہیں، ایک خود مختاری کی سیڑھی (autonomy ladder) منظوری کے گیٹس کے ذریعے عمل درآمد کو کنٹرول کرتی ہے، اور کلائنٹ کے درمیان علیحدگی کو پرامپٹس کے بجائے کوئری لیول پر نافذ کیا جاتا ہے۔ ایجنٹ کا عمل درآمد ایک واحد سیٹنگ harness.runsOn کے ذریعے کنفیگر کیا جا سکتا ہے۔ دستاویزی آپشنز میں ایجنٹ لوپ کو ایپ پراسیس کے اندر چلانا، AWS Bedrock AgentCore Runtime پر پروجیکٹ کے اپنے کنٹینر میں چلانا، یا AWS کے مینجڈ ہارنس کے حوالے کرنا شامل ہے، جس میں یہ وضاحت کی گئی ہے کہ ہر کیس میں ٹوکنز کی ادائیگی کون سا AWS اکاؤنٹ کرے گا۔ لیئرڈ پیکیجز اور پلگ ان کنٹریکٹ ریپوزٹری ایک بڑے پلیٹ فارم کی کور لیئر ہے۔ SDK پیکیج ایک مستحکم پلگ ان کنٹریکٹ کی تعریف کرتا ہے، جس میں Skill اور PluginManifest ٹائپس اور LLM کلائنٹ ٹائپس شامل ہیں۔ کنیکٹرز اور اسکلز الگ npm پیکیجز کے طور پر فراہم کیے جاتے ہیں۔ ایک پلگ ان ایک npm پیکیج ہوتا ہے جو ایک مینی فیسٹ ایکسپورٹ کرتا ہے؛ کور بوٹ کے وقت SDK کے ذریعے مینی فیسٹس لوڈ کرتا ہے۔ README ایک نمونہ اسکل تعریف دکھاتا ہے جو اسکیما ویلیڈیشن لائبریری کے ساتھ بنائی گئی ہے، جس میں slug، نام، ورژن، فراہم کنندہ، منظوری کی ضرورت، ان پٹ اور آؤٹ پٹ اسکیما، اور ایک run فنکشن شامل ہے، جسے PluginManifest کے طور پر ایکسپورٹ کیا گیا ہے۔ کوڈ کے طور پر ورک اسپیس (Workspace as code) تمام ٹیننٹ سیاق و سباق ایک ورک اسپیس میں رہتا ہے: ایک git-ٹریکڈ ڈائریکٹری جس میں YAML اور markdown فائلیں ہوتی ہیں اور یہ ریپوزٹری چیک آؤٹ سے باہر ہوتی ہے، تاکہ کلائنٹ کا سیاق و سباق پل ریکویسٹ میں ریویو کیا جا سکے اور کور کے ساتھ مکس نہ ہو۔ ایک انوائرمنٹ ویری ایبل ایپ کو اس کی طرف اشارہ کرتا ہے۔ دستاویزی اینٹیٹی ٹائپس میں ورک اسپیس مینی فیسٹ، ایجنٹس، ٹیمیں، اسکلز، پلے بکس، مشنز، ورک فلو رنز، آٹومیشنز، آبجیکٹ ٹائپس، سورسز، ٹرسٹ رولز، لرننگ اسٹیپس، ایول ڈیٹا سیٹس اور ٹیننٹ کے ذریعے تعریف شدہ ڈیش بورڈ صفحات شامل ہیں۔ کور کے اندر ایک بیس پیک فراہم کیا جاتا ہے جو ورک اسپیس کے نیچے لیئر ہوتا ہے: آپ اسے extends ڈائریکٹو کے ساتھ پن کرتے ہیں، ایجنٹس کو use لسٹ کے ساتھ فعال کرتے ہیں، اور ڈیفالٹس کو سیم-سلگ فائلوں کے ساتھ اوور رائیڈ کرتے ہیں۔ سیٹ اپ اور آپریشنز شروعات کے لیے کلون اور انسٹال، انوائرمنٹ ایگزیمپل فائل کی کاپی اور ڈیٹا بیس URL، ایک auth سیکرٹ اور کم از کم ایک LLM فراہم کنندہ کی (key) سیٹ کرنے کی ہدایت دی گئی ہے۔ سپورٹنگ سروسز (Postgres, Langfuse, Temporal) کو dev:up اسکرپٹ سے شروع کریں، مائیگریشنز چلائیں، ورک اسپیس اسکیفولڈ کریں، WORKSPACE_PATH کو اس کی طرف اشارہ کریں، اسے اپلائی کریں، اور پھر localhost پورٹ 3000 پر ڈویلپمنٹ سرور شروع کریں۔ Claude Code، Cursor یا Zed جیسے MCP کلائنٹس کے لیے، ایک مقامی stdio کمانڈ موجود ہے، ساتھ ہی ایک ریموٹ HTTP اینڈ پوائنٹ بھی ہے جہاں ٹیننٹ Bearer ٹوکن کے ذریعے آرگنائزیشن کی شناخت کی جاتی ہے۔ کریڈنشلز کو ڈیش بورڈ پیج سے مینج کیا جاتا ہے۔ ان باؤنڈ ٹوکنز Vocion کے ذریعے بنائے جاتے ہیں اور صرف SHA-256 ہیش کے طور پر محفوظ کیے جاتے ہیں۔ آؤٹ باؤنڈ وینڈر کیز (keys) ہر ورک اسپیس کے لیے فراہم کی جا سکتی ہیں، جنہیں AES-256-GCM کے تحت انکرپٹ کیا جاتا ہے تاکہ ورک اسپیس کے اپنے وینڈر اکاؤنٹ کو بل کیا جائے۔ ریٹریول (Retrieval) فرسٹ پارٹی ہے: pgvector کے ساتھ HNSW کوسائن پلس Postgres فل-ٹیکسٹ سرچ، جسے reciprocal rank fusion کے ذریعے یکجا کیا جاتا ہے، اور ایک اختیاری LLM ری رینک (rerank) موجود ہے۔ اسٹیک اور انٹیگریشنز بیان کردہ اسٹیک Next.js 16 (App Router کے ساتھ)، React 19 اور سخت TypeScript، PostgreSQL 16 (ORM کے ساتھ)، Auth.js / NextAuth v5، OpenAI اور Anthropic (LLM فراہم کنندگان کے طور پر)، Langfuse (LLM ٹریسز کے لیے) اور OpenTelemetry (اسپینز اور میٹرکس کے لیے) پر مشتمل ہے۔ اس میں Slack چیٹ کی سطحیں شامل ہیں جہاں ایجنٹ کو مینشن کرنے سے تھریڈڈ جواب ملتا ہے، جبکہ ریویو کیو ہی وہ واحد جگہ ہے جہاں کسی چیز کی منظوری دی جاتی ہے۔ لائسنس یہ پروجیکٹ Mozilla Public License 2.0 کے تحت سورس-اوپن ہے: آپ اسے استعمال، سیلف-ہوسٹ، معائنہ، ترمیم اور کسی بڑے ملکیتی سسٹم میں شامل کر سکتے ہیں۔ ترمیم شدہ Vocion فائلیں تقسیم کے وقت MPL کے تحت کھلی رہیں گی جبکہ ارد گرد کا ایپلی کیشن کوڈ آپ کا رہے گا۔ ڈیٹا، بزنس سیاق و سباق، ایجنٹ کنفیگریشنز اور آپریشنل آؤٹ پٹس آپ کے اپنے رہیں گے۔ Vocion کی وائٹ لیبلنگ یا اسے ملکیتی لائسنس کے تحت تقسیم کرنے کے لیے ایک علیحدہ معاہدے کی ضرورت ہوگی۔ نام اور لوگوز Metacto, Inc. کے ٹریڈ مارکس ہیں۔ دستاویزی اشارے README میں ایک گیٹنگ-اسٹارٹڈ گائیڈ، کوڈنگ ایجنٹس کے لیے ایک فائل، ایک مشین ریڈ ایبل ڈاکومنٹیشن انڈیکس، ورک اسپیس آتھرنگ گائیڈ، اینٹیٹی فیلڈ ریفرنسز، آبجیکٹ ماڈل پیج، ڈیش بورڈ پیجز گائیڈ اور ڈیپلائمنٹ ڈاکومنٹیشن کے لنکس موجود ہیں۔