DeepSeek Harness: عزل الخدمات والنطاق

export default class CacheService extends Service {
  constructor(ctx: Context) {
    super(ctx, 'cache')  // فريد عالمياً
  }
}

// ❌ الذاكرة المؤقتة العامة تُسبب تسرب بيانات عبر الجلسات
export default class CacheService extends Service {
  private data = new Map<string, any>()
  
  set(key: string, value: any) {
    this.data.set(key, value)
  }
}

// الجلسة A: ctx.cache.set('temp', 'secret-data')
// الجلسة B: ctx.cache.get('temp') → 'secret-data' (تسرب!)

export default class SessionCacheService extends Service {
  static scope = 'session'

  constructor(ctx: Context) {
    super(ctx, 'session-cache')
  }
}

export default class SessionCacheService extends Service {
  static scope = 'session'
  // أو
  // static scope = Symbol('session')
}

الجلسة A:
  ctx.sessionCache.set('key', 'value-A')

الجلسة B:
  ctx.sessionCache.get('key') → undefined  (معزول)

الجلسة A:
  ctx.sessionCache.get('key') → 'value-A'  (متاح داخل الجلسة)

export default class RequestContextService extends Service {
  static scope = 'request'

  constructor(ctx: Context) {
    super(ctx, 'request-context')
  }
}

# cordis.yml
realms:
  agent-a:
    isolate: ['cache', 'tools']
    plugins:
      my-tool-a:
        $insert: ./plugins/tool-a
  
  agent-b:
    isolate: ['cache', 'tools']
    plugins:
      my-tool-b:
        $insert: ./plugins/tool-b

realms:
  my-realm:
    isolate:
      - cache       # خدمة cache تحصل على نسخة مستقلة
      - tools       # خدمة tools تحصل على نسخة مستقلة
      # الخدمات غير المُدرجة تبقى مشتركة عالمياً

عام: llm (مشترك)
realm-a: cache (مستقل)، tools (مستقل)
realm-b: cache (مستقل)، tools (مستقل)

الإضافات في realm-a → ctx.cache = cache الخاص بـ realm-a
الإضافات في realm-b → ctx.cache = cache الخاص بـ realm-b
لا يؤثران على بعضهما

// خدمة عامة (غير متأثرة بـ isolate)
export default class EventBusService extends Service {
  constructor(ctx: Context) {
    super(ctx, 'event-bus')  // ليس في قائمة isolate → مشترك عالمياً
  }

  emit(event: string, data: any) { /* ... */ }
  on(event: string, handler: Function) { /* ... */ }
}

// إضافة في realm-a
ctx.eventBus.emit('data-updated', { source: 'realm-a' })

// إضافة في realm-b
ctx.eventBus.on('data-updated', (data) => {
  ctx.logger.info(`received from ${data.source}`)
})

presets:
  coder:
    model: deepseek-coder
    tools: [file_edit, shell, search]
    mode: standard
    
  reviewer:
    model: deepseek-chat
    tools: [file_edit, search]
    mode: minimal
    isolate: [cache]

وكيل coder:  cache مشترك، tools مستقل
وكيل reviewer: cache مستقل، tools مشترك

# cordis.yml
agents:
  coder:
    preset: coder
    isolate: [tools]
    
  reviewer:
    preset: reviewer
    isolate: [tools, cache]

مشترك بالكامل:     جميع الخدمات عامة → بسيط لكن تعارضات محتملة
معزول بالكامل:   جميع الخدمات مستقلة → آمن لكن هدر موارد
عزل مختلط:  خدمات أساسية مشتركة + خدمات أعمال معزولة → نهج متوازن

agents:
  frontend-dev:
    preset: coder
    isolate: [tools, cache]
    tools:
      - file_edit
      - shell
      - search
    config:
      cache:
        maxSize: 100
  
  backend-dev:
    preset: coder
    isolate: [tools, cache]
    tools:
      - file_edit
      - shell
      - search
      - database
    config:
      cache:
        maxSize: 200

// مراقبة عدّاد نسخ الخدمات
ctx.on('service/created', (name, instance) => {
  ctx.logger.info(`service created: ${name}, total instances: ${countInstances(name)}`)
})

// إذا كان عدد نسخ خدمة يتجاوز عدد الوكلاء بكثير، قد يكون هناك تسرب