DeepSeek Harness: استخدام الأدوات

// معاملات استدعاء file_edit من Agent
{
  action: "read",
  path: "src/config.ts",
  encoding: "utf-8"
}

🤖 Agent:
🔍 استخدام أداة: file_edit (قراءة)
  → المسار: src/config.ts
  → الحجم: 1.2KB

ملف الإعداد هذا يصدّر ثلاثة إعدادات:
- DATABASE_URL: سلسلة اتصال قاعدة البيانات
- PORT: منفذ الخدمة (الافتراضي 3000)
- LOG_LEVEL: مستوى السجل (الافتراضي info)

// Agent يستدعي file_edit لإنشاء ملف
{
  action: "create",
  path: "src/utils/logger.ts",
  content: "export function log(level: string, msg: string) {\n  const ts = new Date().toISOString();\n  console.log(`[${ts}] [${level}] ${msg}`);\n}"
}

// Agent يستدعي file_edit لتعديل ملف
{
  action: "edit",
  path: "src/app.ts",
  changes: [
    {
      type: "insert",
      line: 5,
      content: "import { log } from './utils/logger';"
    },
    {
      type: "replace",
      line: 23,
      oldContent: "console.log('Server started');",
      newContent: "log('info', 'Server started');"
    }
  ]
}

⚠️ الموافقة مطلوبة: تعديل ملف src/app.ts

  +5 | import { log } from './utils/logger';
  
  -23| console.log('Server started');
  +23| log('info', 'Server started');

  [سماح] [دائمًا] [رفض]

// Agent ينفذ أمر ls
{
  command: "ls -la src/",
  cwd: "/home/alice/project",
  timeout: 30000
}

// Agent ينفذ npm view (عرض معلومات الحزمة، مخاطر متوسطة)
{
  command: "npm view jsonwebtoken",
  cwd: "/home/alice/project",
  timeout: 120000
}

⚠️ الموافقة مطلوبة: تنفيذ أمر shell

  الأمر: npm view jsonwebtoken
  دليل العمل: /home/alice/project
  الحزم المقدرة: 1

  [سماح] [دائمًا لـ npm] [رفض]

// معاملات أداة shell
interface ShellParams {
  command: string;
  cwd?: string;
  timeout?: number;      // المهلة بالمللي ثانية، الافتراضي 30000
  env?: Record<string, string>;  // متغيرات بيئة إضافية
}

🤖 Agent:
🔧 استخدام أداة: shell
  → الأمر: npm run build
  → المهلة: 120000ms

⏱️ اكتمل البناء في 45ث
  → المخرج: بناء ناجح. 15 ملفًا مُولَّدًا.

// البحث عن جميع ملفات الاختبار
{
  pattern: "*.test.ts",
  type: "file",
  maxResults: 50
}

// البحث عن جميع عبارات import
{
  pattern: "import.*from 'express'",
  type: "content",
  filePattern: "*.ts",
  maxResults: 100
}

🤖 Agent:
🔍 استخدام أداة: search
  → النمط: import.*from 'express'
  → النوع: محتوى
  → النتائج: 8 تطابقات

وُجد في:
  src/app.ts:1         — import express from 'express';
  src/routes/users.ts:3 — import express from 'express';
  src/routes/auth.ts:2  — import express from 'express';
  ...

// استدعاء مهارة add-test
{
  skill: "add-test",
  params: {
    target: "src/utils/format.ts::formatDate",
    framework: "jest"
  }
}

// إنشاء خطة
{
  action: "create",
  steps: [
    { id: 1, desc: "تثبيت التبعيات", tool: "shell" },
    { id: 2, desc: "إنشاء وحدة المصادقة", tool: "file_edit" },
    { id: 3, desc: "تحديث app.ts", tool: "file_edit" },
    { id: 4, desc: "كتابة الاختبارات", tool: "file_edit" },
    { id: 5, desc: "تشغيل الاختبارات", tool: "shell" }
  ]
}

// تعليم الخطوة كمكتملة
{
  action: "update",
  stepId: 1,
  status: "completed",
  result: "تم تثبيت jsonwebtoken، bcryptjs"
}

async function executeToolPipeline(tool: Tool, params: Params): Promise<Result> {
  // المرحلة 1: pre-execute
  const preResult = await preExecute(tool, params);
  if (preResult.denied) {
    throw new ToolDeniedError(preResult.reason);
  }

  // المرحلة 2: execute
  const result = await tool.execute(params);

  // المرحلة 3: post-execute
  await postExecute(tool, params, result);
  ctx.emit('tool.executed', { tool: tool.name, params, result });

  return result;
}

interface PreExecuteResult {
  allowed: boolean;
  reason?: string;
  modifiedParams?: Params;
}

interface PostExecuteAction {
  log: boolean;           // تسجيل في سجل الجلسة
  emit: boolean;          // إصدار حدث
  updateTrajectory: boolean;  // تحديث Trajectory
  notifyUI: boolean;      // إشعار واجهة الويب بالتحديث
}

# dsh.config.yaml
approval:
  # السياسة الافتراضية العامة
  default: ask

  # إعدادات حسب الأداة
  tools:
    file_edit:
      read: always          # القراءة مسموحة دائمًا
      create: ask           # الإنشاء يتطلب موافقة
      edit: ask             # التعديل يتطلب موافقة
      delete: ask_with_confirm  # الحذف يتطلب تأكيدًا مزدوجًا
    
    shell:
      safe: always          # الأوامر الآمنة مسموحة دائمًا
      moderate: ask         # الأوامر المتوسطة تتطلب موافقة
      dangerous: deny       # الأوامر الخطيرة مرفوضة تلقائيًا
    
    search:
      default: always       # البحث مسموح دائمًا
    
    skills:
      default: ask          # استدعاءات المهارات تتطلب موافقة
    
    plan:
      default: always       # الخطط مسموحة دائمًا

import { definePlugin } from '@deepseek-ai/dsh';

export default definePlugin({
  name: 'tool-http-request',
  version: '1.0.0',
  contribute(ctx) {
    ctx.registerTool({
      name: 'http_request',
      description: 'Make HTTP requests to external APIs',
      parameters: {
        type: 'object',
        properties: {
          url: { type: 'string', description: 'Request URL' },
          method: { type: 'string', enum: ['GET', 'POST', 'PUT', 'DELETE'] },
          headers: { type: 'object', description: 'Request headers' },
          body: { type: 'string', description: 'Request body' }
        },
        required: ['url', 'method']
      },
      async execute(params) {
        const response = await fetch(params.url, {
          method: params.method,
          headers: params.headers,
          body: params.body
        });
        return {
          status: response.status,
          body: await response.text()
        };
      }
    });
  }
});

.dsh/
└── plugins/
    └── tool-http-request/
        ├── index.ts
        └── package.json

# dsh.config.yaml
plugins:
  - path: "./custom-tools/http-request"
  - path: "./custom-tools/database-query"

ctx.registerTool({
  name: 'http_request',
  // ...
  approval: {
    level: 'ask',     // تتطلب موافقة افتراضيًا
    rules: [
      { match: { method: 'GET' }, level: 'always' },     // طلبات GET مسموحة تلقائيًا
      { match: { method: 'POST' }, level: 'ask' },       // POST يتطلب موافقة
      { match: { method: 'DELETE' }, level: 'deny' }     // DELETE مرفوض تلقائيًا
    ]
  }
});