تخطَّ إلى المحتوى
Hashee Docs

إضافة Codex

إضافة Hashee لـ Codex (@hasheeai/codex-plugin) تربط OpenAI Codex بمحادثات Hashee. تستخدم نظام hook في Codex (توجيه JSON عبر stdin/stdout) لتمرير الرسائل بين جلسات Codex ومستخدمي Hashee عبر Agent SDK.

كيف يعمل

Codex CLI ──stdin/stdout──> Hashee Codex Plugin ──Agent SDK (WS)──> Hashee API
                            │
                            ├── session-start   → Connect to Hashee, sync conversations
                            ├── prompt-submit   → Forward user prompt to Hashee
                            ├── pre-tool-use    → Permission relay from Hashee app
                            └── stop            → Disconnect and cleanup

تُستدعى الإضافة كملف ثنائي hook لـ Codex. تقرأ حدث JSON من stdin وتوجّهه إلى المعالج المناسب وتكتب نتيجة JSON إلى stdout.

أحداث Hook

الحدثالمشغّلإجراء Hashee
session-startبدء جلسة Codexاتصال Agent SDK، مزامنة المحادثات النشطة
prompt-submitالمستخدم يرسل إرشاداًتمرير إلى محادثة Hashee النشطة
pre-tool-useCodex يطلب تنفيذ أداةترحيل طلب الصلاحية إلى تطبيق Hashee
stopانتهاء جلسة Codexقطع اتصال Agent SDK، تنظيف

الإعداد

1. التثبيت

أضف الإضافة إلى مشروعك:

Terminal window
npm install @hasheeai/codex-plugin

2. تكوين البيئة

Terminal window
export HASHEE_AGENT_ID="your-agent-uuid"
export HASHEE_AGENT_TOKEN="hsk_your-token"
export HASHEE_SERVER_URL="https://api.hashee.ai"  # optional, this is the default
المتغيرمطلوبالافتراضيالوصف
HASHEE_AGENT_IDنعم—معرّف الوكيل UUID
HASHEE_AGENT_TOKENنعم—رمز مصادقة الوكيل
HASHEE_SERVER_URLلاhttps://api.hashee.aiعنوان API الأساسي

3. التسجيل كـ hook لـ Codex

أضف الملف الثنائي للإضافة إلى تكوين hook الخاص بـ Codex:

Terminal window
npx tsx packages/public/codex-plugin/src/index.ts

أو إذا ثُبّتت عالمياً:

Terminal window
hashee-codex-plugin

ترحيل الصلاحيات

عندما يطلب Codex صلاحية لتنفيذ أداة (مثلاً كتابة ملف، أمر shell)، تُمرر الإضافة الطلب إلى تطبيق Hashee كـ Artifact. يوافق المستخدم أو يرفض من محادثته على Hashee، ويُرحّل القرار إلى Codex.

التشفير

جميع التشفير يتعامل معه @hasheeai/agent-sdk-ts. ترسل الإضافة نصاً أصلياً إلى SDK، الذي يُشفّر قبل الإرسال. الرسائل الواردة تصل مشفرة ويفكّ SDK تشفيرها قبل معالجة الإضافة لها.

الخطوات التالية