DeepSeek Harness: إعدادات الإضافة: Config و Schemastery

import { Schema } from '@deepseek-ai/cordis'

export const Config = Schema.object({
  apiKey: Schema.string().required().description('API key for the service'),
  maxRetries: Schema.number().default(3).description('Maximum retry attempts'),
  debug: Schema.boolean().default(false).description('Enable debug logging')
})

export const Config = Schema.object({
  apiKey: Schema.string().required(),
  maxRetries: Schema.number().default(3)
})

export const name = 'my-plugin'

export function apply(ctx: Context) {
  // نوع ctx.config يُستنتج تلقائياً
  ctx.logger.info(`API key: ${ctx.config.apiKey}`)
  ctx.logger.info(`Max retries: ${ctx.config.maxRetries}`)
}

Schema.string()                           // أي سلسلة
Schema.string().required()                // مطلوب
Schema.string().default('hello')          // قيمة افتراضية
Schema.string().description('Your name')  // وصف
Schema.string().pattern(/^[a-z]+$/)       // تحقق بالتعابير النمطية
Schema.string().min(1).max(100)           // حدود الطول

Schema.number()                    // أي عدد
Schema.number().default(0)         // قيمة افتراضية
Schema.number().min(0).max(100)    // حدود النطاق
Schema.number().step(1)            // خطوة (لشرائح واجهة المستخدم)
Schema.integer()                   // عدد صحيح

Schema.boolean()                   // منطقي
Schema.boolean().default(false)    // افتراضي false

Schema.object({
  host: Schema.string().default('localhost'),
  port: Schema.number().default(5432),
  ssl: Schema.boolean().default(false)
})

Schema.array(Schema.string())                          // مصفوفة سلاسل
Schema.array(Schema.string()).default([])              // افتراضي مصفوفة فارغة
Schema.array(Schema.object({                           // مصفوفة كائنات
  name: Schema.string().required(),
  url: Schema.string().required()
}))

// قيم تعداد
Schema.union(['read', 'write', 'execute'])

// ثابت
Schema.const('fixed-value')

// تعداد مع أوصاف
Schema.union([
  Schema.const('read').description('Read-only access'),
  Schema.const('write').description('Read and write access'),
  Schema.const('execute').description('Full access')
])

// نوع القاموس
Schema.dict(
  Schema.string(),           // نوع القيمة
  Schema.string()            // نوع المفتاح (اختياري)
)

apiKey: Schema.string().required()

maxRetries: Schema.number().default(3)
timeout: Schema.number().default(30000)

apiKey: Schema.string().required()
  .description('API key obtained from the service dashboard')

port: Schema.number().min(1).max(65535).default(8080)
name: Schema.string().min(1).max(50)

email: Schema.string().pattern(/^[^@]+@[^@]+\.[^@]+$/)
  .description('Valid email address')

timeout: Schema.number().min(1000).max(300000).step(1000).default(30000)

const Config = Schema.object({
  apiKey: Schema.string()
    .required()
    .pattern(/^sk-[a-zA-Z0-9]+$/)
    .description('DeepSeek API key (starts with sk-)'),
  
  maxTokens: Schema.number()
    .min(1).max(32768)
    .default(4096)
    .description('Maximum tokens per request'),
  
  model: Schema.union(['deepseek-chat', 'deepseek-reasoner'])
    .default('deepseek-chat')
    .description('Model to use'),
  
  temperature: Schema.number()
    .min(0).max(2).step(0.1)
    .default(0.7)
    .description('Sampling temperature')
})

const Config = Schema.object({
  database: Schema.object({
    host: Schema.string().default('localhost'),
    port: Schema.number().default(5432),
    name: Schema.string().required(),
    ssl: Schema.boolean().default(false)
  }).default({ host: 'localhost', port: 5432, ssl: false }),

  cache: Schema.object({
    enabled: Schema.boolean().default(true),
    ttl: Schema.number().default(3600).description('Cache TTL in seconds')
  }).default({ enabled: true, ttl: 3600 })
})

const Config = Schema.object({
  llm: Schema.object({
    provider: Schema.union(['deepseek', 'openai']).default('deepseek'),
    deepseek: Schema.object({
      apiKey: Schema.string().required(),
      model: Schema.string().default('deepseek-chat')
    }),
    openai: Schema.object({
      apiKey: Schema.string(),
      endpoint: Schema.string().default('https://api.openai.com/v1')
    })
  })
})

const ConnectionSchema = Schema.object({
  host: Schema.string().default('localhost'),
  port: Schema.number().default(5432),
  timeout: Schema.number().default(5000)
})

const Config = Schema.object({
  primary: ConnectionSchema.description('Primary connection'),
  replica: ConnectionSchema.description('Replica connection')
})

┌─────────────────────────────────────────┐
│ API Key                                 │
│ [sk-xxxxxxxxxxxxxxx                   ] │
│ DeepSeek API key (starts with sk-)      │
├─────────────────────────────────────────┤
│ Max Tokens                              │
│ [4096                                 ] │
│ Maximum tokens per request              │
└─────────────────────────────────────────┘

┌─────────────────────────────────────────┐
│ API Key                                 │
│ [invalid-key                          ] │
│ ❌ Must match pattern: /^sk-[a-zA-Z0-9]+$/ │
└─────────────────────────────────────────┘

const Config = Schema.object({
  port: Schema.number().min(1).max(65535)
})

// إعدادات المستخدم: port: -1
// → Error: Invalid config for plugin my-plugin:
//   port: must be >= 1

const Config = Schema.object({
  apiKey: Schema.string().required(),
  maxRetries: Schema.number().default(3)
})

export function apply(ctx: Context) {
  ctx.config.apiKey     // string ✅
  ctx.config.maxRetries // number ✅
  ctx.config.unknown    // خطأ نوع ❌
}

const Config = Schema.object({
  startDate: Schema.string().required(),
  endDate: Schema.string().required()
}).validate((value) => {
  if (new Date(value.startDate) > new Date(value.endDate)) {
    throw new Error('startDate must be before endDate')
  }
  return value
})

export function apply(ctx: Context) {
  ctx.on('config/updated', (newConfig) => {
    ctx.logger.info('config updated:', newConfig)
    // ضبط السلوك بناءً على الإعدادات الجديدة
  })
}

export function apply(ctx: Context) {
  ctx.on('config/updated', (config) => {
    if (config.port !== ctx.config.port) {
      ctx.logger.warn('port change requires restart')
    }
  })
}