أدوات بوابة القرار MCP

تحميل: tooling.json (326 كيلوبايت) تحميل: openapi/decision-gate.json (408 كيلوبايت)

صفحات تفاصيل الأدوات

• scenario_define - تسجيل ScenarioSpec، التحقق من صحته، وإرجاع التجزئة القياسية المستخدمة لفحوصات السلامة.
• scenario_start - إنشاء حالة تشغيل جديدة لسيناريو وإصدار حزم دخول اختيارية.
• scenario_status - جلب لقطة تشغيل للقراءة فقط وملخص آمن دون تغيير الحالة.
• scenario_next - تقييم البوابات استجابةً لطلب التالي المدفوع من قبل الوكيل.
• scenario_submit - تقديم العناصر الخارجية إلى حالة التشغيل للتدقيق والتقييم لاحقًا.
• scenario_trigger - تقديم حدث تفعيل (جدولة/خارجي) وتقييم التشغيل.
• evidence_query - استعلام عن مزود الأدلة مع سياق التشغيل الكامل وسياسة الإفصاح.
• runpack_export - تصدير قطع العمل المحددة للتحقق غير المتصل.
• runpack_verify - تحقق من بيان تشغيل الحزمة والفنون المرفقة دون اتصال.
• providers_list - قائمة مقدمي الأدلة المسجلين وملخص القدرات.
• provider_contract_get - استرجاع JSON عقد المزود القياسي والتجزئة لمزود الخدمة.
• provider_check_schema_get - جلب تفاصيل مخطط التحقق (المعلمات/النتيجة/المقارنات) لمزود الخدمة.
• schemas_register - تسجيل مخطط شكل البيانات لمستأجر وفضاء اسم.
• schemas_list - قائمة الأشكال البيانية المسجلة لمستأجر وفضاء أسماء.
• schemas_get - استرجاع شكل بيانات محدد بواسطة المعرف والإصدار.
• scenarios_list - قائمة السيناريوهات المسجلة لمستأجر وفضاء اسم.
• precheck - تقييم سيناريو مقابل البيانات المحددة دون تغيير الحالة.
• decision_gate_docs_search - ابحث في وثائق بوابة القرار للحصول على إرشادات وقت التشغيل.
• typed_providers_import - استيراد OpenAPI إلى فنون الموفرين المخصصة وتسجيل إصدار الملف الشخصي.
• typed_providers_register - تسجيل عقد مزودين محددين مسبقًا + ملفات تعريف وقت التشغيل.
• typed_providers_list - قائمة كتالوجات دورة حياة المزودين المTyped والإصدارات المسجلة.
• typed_providers_get - جلب بيانات مزودين محددين + بيانات دورة الحياة لإصدار واحد.
• typed_providers_activate - تفعيل إصدار دورة حياة مزود نوعي.
• typed_providers_deprecate - إلغاء إصدار دورة حياة مزود مخصص، مع إمكانية التراجع النشط.

هذا المستند يلخص واجهة أداة MCP والاستخدام المتوقع. المخططات الكاملة موجودة في tooling.json، مع المخططات الداعمة تحت schemas/ والأمثلة تحت examples/.

بدء سريع لدورة الحياة

• scenario_define يسجل ويحقق في صحة ScenarioSpec.
• scenario_start ينشئ عملية تشغيل ويصدر حزم إدخال بشكل اختياري.
• scenario_next يتقدم بتشغيل مدفوع من قبل الوكيل؛ scenario_trigger يتقدم بالوقت/المحفزات الخارجية.
• scenario_status يستعلم عن حالة التشغيل دون تغييرها.
• scenario_submit يضيف عناصر خارجية للتدقيق والفحوصات اللاحقة.
• runpack_export و runpack_verify تدعمان التحقق غير المتصل بالإنترنت.

مراجع الأثر

• authoring.md: إرشادات تنسيق التأليف والتطبيع.
• [scenario.json](/downloads/decision-gate/examples/scenario.json): مثال كامل لـ ScenarioSpec.
• examples/scenario.ron: مثال ScenarioSpec سهل التأليف.
• [run-config.json](/downloads/decision-gate/examples/run-config.json): مثال على تكوين التشغيل لسيناريو البدء.
• [decision-gate.toml](/downloads/decision-gate/examples/decision-gate.toml): مثال على تكوين MCP لمقدمي الخدمات.

الأداة	الوصف
scenario_define	تسجيل ScenarioSpec، التحقق منه، وإرجاع التجزئة القياسية المستخدمة لفحوصات السلامة.
scenario_start	إنشاء حالة تشغيل جديدة لسيناريو وإصدار حزم دخول اختيارية.
scenario_status	جلب لقطة تشغيل للقراءة فقط وملخص آمن دون تغيير الحالة.
scenario_next	تقييم البوابات استجابةً لطلب التالي المدفوع بواسطة وكيل.
scenario_submit	تقديم العناصر الخارجية إلى حالة التشغيل للتدقيق والتقييم لاحقًا.
scenario_trigger	تقديم حدث تحفيزي (جدولة/خارجي) وتقييم التشغيل.
evidence_query	استعلام عن مزود الأدلة مع سياق التشغيل الكامل وسياسة الإفصاح.
runpack_export	تصدير عناصر runpack الحتمية للتحقق غير المتصل.
runpack_verify	التحقق من بيان runpack والعناصر غير المتصلة.
providers_list	قائمة بمزودي الأدلة المسجلين وملخص القدرات.
provider_contract_get	جلب JSON عقد المزود القياسي والتجزئة لمزود.
provider_check_schema_get	جلب تفاصيل مخطط الفحص (المعلمات/النتيجة/المقارنات) لمزود.
schemas_register	تسجيل مخطط شكل البيانات لمستأجر وفضاء أسماء.
schemas_list	قائمة بأشكال البيانات المسجلة لمستأجر وفضاء أسماء.
schemas_get	جلب شكل بيانات محدد بواسطة المعرف والإصدار.
scenarios_list	قائمة بالسيناريوهات المسجلة لمستأجر وفضاء أسماء.
precheck	تقييم سيناريو مقابل البيانات المؤكدة دون تغيير الحالة.
decision_gate_docs_search	البحث في وثائق Decision Gate للحصول على إرشادات وقت التشغيل.
typed_providers_import	استيراد OpenAPI إلى عناصر مزود محددة وتسجيل إصدار الملف الشخصي.
typed_providers_register	تسجيل عقد مزود محدد مسبقًا + عناصر ملف تعريف وقت التشغيل.
typed_providers_list	قائمة بكتالوجات دورة حياة المزودين المحددين والإصدارات المسجلة.
typed_providers_get	جلب عناصر مزود محدد + بيانات دورة الحياة لإصدار واحد.
typed_providers_activate	تفعيل إصدار دورة حياة مزود محدد.
typed_providers_deprecate	إلغاء إصدار دورة حياة مزود محدد، مع إمكانية التراجع النشط الاختياري.

تحديد_السيناريو

قم بتسجيل ScenarioSpec، تحقق منه، وارجع إلى الهاش القياسي المستخدم لفحوصات السلامة.

مدخلات

• spec (مطلوب): مواصفة السيناريو للتسجيل.

المخرجات

• scenario_id (required): معرف السيناريو.
• spec_hash (مطلوب): النوع: object.

ملاحظات

• استخدم قبل بدء الجولات؛ scenario_id يصبح المقبض الثابت لاستدعاءات لاحقة.
• يحقق في معرفات المرحلة/البوابة/الشرط، وأشجار RET، ومراجع الشروط.
• هاش التحقق محدد؛ خزنه للتدقيق وسلامة فك الحزمة.
• يفشل النظام عند وجود مواصفات غير صالحة أو معرفات سيناريو مكررة.

مثال

سجل مواصفات سيناريو المثال.

مدخل:

{
  "spec": {
    "conditions": [
      {
        "comparator": "equals",
        "condition_id": "env_is_prod",
        "expected": "production",
        "policy_tags": [],
        "query": {
          "check_id": "get",
          "params": {
            "key": "DEPLOY_ENV"
          },
          "provider_id": "env"
        }
      },
      {
        "comparator": "equals",
        "condition_id": "after_freeze",
        "expected": true,
        "policy_tags": [],
        "query": {
          "check_id": "after",
          "params": {
            "timestamp": 1710000000000
          },
          "provider_id": "time"
        }
      }
    ],
    "default_tenant_id": null,
    "namespace_id": 1,
    "policies": [],
    "scenario_id": "example-scenario",
    "schemas": [],
    "spec_version": "v1",
    "stages": [
      {
        "advance_to": {
          "kind": "terminal"
        },
        "entry_packets": [
          {
            "content_type": "application/json",
            "expiry": null,
            "packet_id": "packet-hello",
            "payload": {
              "kind": "json",
              "value": {
                "message": "hello",
                "purpose": "scenario entry packet"
              }
            },
            "policy_tags": [],
            "schema_id": "schema-hello",
            "visibility_labels": [
              "public"
            ]
          }
        ],
        "gates": [
          {
            "gate_id": "env_gate",
            "requirement": {
              "Condition": "env_is_prod"
            }
          },
          {
            "gate_id": "time_gate",
            "requirement": {
              "Condition": "after_freeze"
            }
          }
        ],
        "on_timeout": "fail",
        "stage_id": "main",
        "timeout": null
      }
    ]
  }
}

Output:

{
  "scenario_id": "example-scenario",
  "spec_hash": {
    "algorithm": "sha256",
    "value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
  }
}

سيناريو_البداية

إنشاء حالة تشغيل جديدة لسيناريو وإصدار حزم الدخول بشكل اختياري.

مدخلات

• issue_entry_packets (required): إصدار حزم الإدخال على الفور.
• run_config (مطلوب): تكوين التشغيل وأهداف الإرسال.
• scenario_id (required): معرف السيناريو.
• started_at (مطلوب): الطابع الزمني لبداية التشغيل المقدم من المتصل.

المخرجات

• current_stage_id (required): معرف المرحلة الحالية.
• القرارات (مطلوبة): النوع: array.
• dispatch_targets (مطلوب): النوع: array.
• gate_evals (مطلوب): النوع: array.
• namespace_id (مطلوب): معرف مساحة الاسم.
• الحزم (مطلوب): النوع: array.
• run_id (مطلوب): معرف التشغيل.
• scenario_id (required): معرف السيناريو.
• spec_hash (مطلوب): النوع: object.
• stage_entered_at (مطلوب): واحد من: كائن، كائن.
• الحالة (مطلوب): النوع: string.
• التقديمات (مطلوب): النوع: array.
• tenant_id (مطلوب): معرف المستأجر.
• tool_calls (مطلوب): النوع: array.
• المشغلات (مطلوب): النوع: array.

ملاحظات

• يتطلب RunConfig (tenant_id, run_id, scenario_id, dispatch_targets).
• استخدم started_at لتسجيل الطابع الزمني الذي يقدمه المتصل كبداية.
• إذا كانت issue_entry_packets صحيحة، يتم الكشف عن حزم الإدخال على الفور.
• يفشل الإغلاق إذا كان run_id موجودًا بالفعل أو كان scenario_id غير معروف.

مثال

ابدأ تشغيلًا لسيناريو المثال وأصدر حزم الإدخال.

مدخل:

{
  "issue_entry_packets": true,
  "run_config": {
    "dispatch_targets": [
      {
        "agent_id": "agent-alpha",
        "kind": "agent"
      }
    ],
    "namespace_id": 1,
    "policy_tags": [],
    "run_id": "run-0001",
    "scenario_id": "example-scenario",
    "tenant_id": 1
  },
  "scenario_id": "example-scenario",
  "started_at": {
    "kind": "unix_millis",
    "value": 1710000000000
  }
}

Output:

{
  "current_stage_id": "main",
  "decisions": [],
  "dispatch_targets": [
    {
      "agent_id": "agent-alpha",
      "kind": "agent"
    }
  ],
  "gate_evals": [],
  "namespace_id": 1,
  "packets": [],
  "run_id": "run-0001",
  "scenario_id": "example-scenario",
  "spec_hash": {
    "algorithm": "sha256",
    "value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
  },
  "stage_entered_at": {
    "kind": "unix_millis",
    "value": 1710000000000
  },
  "status": "active",
  "submissions": [],
  "tenant_id": 1,
  "tool_calls": [],
  "triggers": []
}

حالة السيناريو

احصل على لقطة تشغيل للقراءة فقط وملخص آمن دون تغيير الحالة.

مدخلات

• طلب (مطلوب): حمولة طلب الحالة.
• scenario_id (required): معرف السيناريو.

المخرجات

• current_stage_id (required): معرف المرحلة الحالية.
• issued_packet_ids (required): النوع: array.
• last_decision (مطلوب، قابل للاحتواء): واحد من: null، كائن.
• namespace_id (اختياري): معرف المساحة الاسمية.
• run_id (مطلوب): معرف التشغيل.
• safe_summary (مطلوب، قابل للإلغاء): واحد من: null، كائن.
• scenario_id (required): معرف السيناريو.
• الحالة (مطلوب): النوع: string.

ملاحظات

• استخدم لاستطلاع الرأي أو حالة واجهة المستخدم؛ لا يقوم بتقييم البوابات.
• تتجاهل الملخصات الآمنة قيم الأدلة وقد تتضمن تلميحات لإعادة المحاولة.
• يُرجع معرفات الحزم الصادرة للمساعدة في تتبع الإفصاحات.

مثال

استعلام حالة التشغيل دون التقدم في التشغيل.

مدخل:

{
  "request": {
    "correlation_id": null,
    "namespace_id": 1,
    "requested_at": {
      "kind": "unix_millis",
      "value": 1710000000000
    },
    "run_id": "run-0001",
    "tenant_id": 1
  },
  "scenario_id": "example-scenario"
}

Output:

{
  "current_stage_id": "main",
  "issued_packet_ids": [],
  "last_decision": null,
  "run_id": "run-0001",
  "safe_summary": null,
  "scenario_id": "example-scenario",
  "status": "active"
}

سيناريو_التالي

تقييم البوابات استجابةً لطلب التالي المدفوع بواسطة وكيل.

مدخلات

• feedback (اختياري، قابل لأن يكون فارغاً): تجاوز مستوى التعليقات الاختياري لسيناريو_التالي.
• request (required): الحمولة التالية المطلوبة من وكيل.
• scenario_id (required): معرف السيناريو.

المخرجات

• القرار (مطلوب): النوع: كائن.
• feedback (اختياري، يمكن أن يكون فارغاً): واحد من: فارغ، كائن.
• الحزم (مطلوب): النوع: array.
• الحالة (مطلوب): النوع: string.

ملاحظات

• متماثل بواسطة trigger_id؛ المكالمات المتكررة تعيد نفس القرار.
• يسجل القرار، والأدلة، وكشف الحزم في حالة التشغيل.
• يتطلب تشغيلًا نشطًا؛ لا تتقدم العمليات المكتملة أو الفاشلة.
• يمكن أن تتضمن الملاحظات الاختيارية تتبع البوابة أو الأدلة عندما يسمح بذلك سياسة ملاحظات الخادم.

مثال

مثال 1: تقييم الخطوة التالية المدفوعة بالوكيل لجولة.

مدخل:

{
  "request": {
    "agent_id": "agent-alpha",
    "correlation_id": null,
    "namespace_id": 1,
    "run_id": "run-0001",
    "tenant_id": 1,
    "time": {
      "kind": "unix_millis",
      "value": 1710000000000
    },
    "trigger_id": "trigger-0001"
  },
  "scenario_id": "example-scenario"
}

Output:

{
  "decision": {
    "correlation_id": null,
    "decided_at": {
      "kind": "unix_millis",
      "value": 1710000000000
    },
    "decision_id": "decision-0001",
    "outcome": {
      "kind": "complete",
      "stage_id": "main"
    },
    "seq": 0,
    "stage_id": "main",
    "trigger_id": "trigger-0001"
  },
  "packets": [],
  "status": "completed"
}

مثال 2: تقييم عملية وتشغيل طلب ملاحظات التتبع.

مدخل:

{
  "feedback": "trace",
  "request": {
    "agent_id": "agent-alpha",
    "correlation_id": null,
    "namespace_id": 1,
    "run_id": "run-0001",
    "tenant_id": 1,
    "time": {
      "kind": "unix_millis",
      "value": 1710000000000
    },
    "trigger_id": "trigger-0001"
  },
  "scenario_id": "example-scenario"
}

Output:

{
  "decision": {
    "correlation_id": null,
    "decided_at": {
      "kind": "unix_millis",
      "value": 1710000000000
    },
    "decision_id": "decision-0001",
    "outcome": {
      "kind": "complete",
      "stage_id": "main"
    },
    "seq": 0,
    "stage_id": "main",
    "trigger_id": "trigger-0001"
  },
  "feedback": {
    "gate_evaluations": [],
    "level": "trace"
  },
  "packets": [],
  "status": "completed"
}

سيناريو_تقديم

قم بتقديم العناصر الخارجية إلى حالة التشغيل للتدقيق والتقييم لاحقًا.

مدخلات

• طلب (مطلوب): حمولة الإرسال والبيانات الوصفية.
• scenario_id (required): معرف السيناريو.

المخرجات

• سجل (مطلوب): النوع: كائن.

ملاحظات

• يتم تجزئة الحمولة وتخزينها كسجل تقديم.
• يتم الاحتفاظ بالحمولة في سجلات حالة التشغيل/تفكيك التشغيل؛ لا ترسل الأسرار الخام.
• لا يحرّك الجري بنفسه.
• استخدم للنماذج أو المشغلين الذين يزودون بالقطع الأثرية.

مثال

تقديم عنصر خارجي للتدقيق والتقييم لاحقًا.

مدخل:

{
  "request": {
    "content_type": "application/json",
    "correlation_id": null,
    "namespace_id": 1,
    "payload": {
      "kind": "json",
      "value": {
        "artifact": "attestation",
        "status": "approved"
      }
    },
    "run_id": "run-0001",
    "submission_id": "submission-0001",
    "submitted_at": {
      "kind": "unix_millis",
      "value": 1710000000000
    },
    "tenant_id": 1
  },
  "scenario_id": "example-scenario"
}

Output:

{
  "record": {
    "content_hash": {
      "algorithm": "sha256",
      "value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
    },
    "content_type": "application/json",
    "correlation_id": null,
    "payload": {
      "kind": "json",
      "value": {
        "artifact": "attestation",
        "status": "approved"
      }
    },
    "run_id": "run-0001",
    "submission_id": "submission-0001",
    "submitted_at": {
      "kind": "unix_millis",
      "value": 1710000000000
    }
  }
}

مشغل_السيناريو

قم بتقديم حدث تشغيل (جدولة/خارجي) وتقييم التشغيل.

مدخلات

• scenario_id (required): معرف السيناريو.
• trigger (مطلوب): حمولة حدث الزناد.

المخرجات

• القرار (مطلوب): النوع: كائن.
• الحزم (مطلوب): النوع: array.
• الحالة (مطلوب): النوع: string.

ملاحظات

• يتم توفير وقت الزناد بواسطة المتصل؛ لا توجد قراءات للساعة الحائطية.
• يسجل حدث الزناد والقرار الناتج.
• يتم الاحتفاظ بالحمولة في سجلات حالة التشغيل/تفكيك التشغيل؛ لا ترسل الأسرار الخام.
• استخدمها لتحفيزات النظام المعتمدة على الوقت أو الخارجية.

مثال

تقدم تشغيلًا من مجدول أو مشغل خارجي.

مدخل:

{
  "scenario_id": "example-scenario",
  "trigger": {
    "correlation_id": null,
    "kind": "tick",
    "namespace_id": 1,
    "payload": null,
    "run_id": "run-0001",
    "source_id": "scheduler-01",
    "tenant_id": 1,
    "time": {
      "kind": "unix_millis",
      "value": 1710000000000
    },
    "trigger_id": "trigger-0001"
  }
}

Output:

{
  "decision": {
    "correlation_id": null,
    "decided_at": {
      "kind": "unix_millis",
      "value": 1710000000000
    },
    "decision_id": "decision-0001",
    "outcome": {
      "kind": "complete",
      "stage_id": "main"
    },
    "seq": 0,
    "stage_id": "main",
    "trigger_id": "trigger-0001"
  },
  "packets": [],
  "status": "completed"
}

استعلام_الأدلة

استعلام عن مزود الأدلة مع سياق التشغيل الكامل وسياسة الإفصاح.

مدخلات

• سياق (مطلوب): سياق الأدلة المستخدمة للتقييم.
• استعلام (مطلوب): حمولة استعلام الأدلة.

المخرجات

• النتيجة (مطلوب): النوع: كائن.

ملاحظات

• قد تقوم سياسة الإفصاح بحذف القيم الخام؛ لا تزال القيم التجزئة/المرتكزات مُرجعة.
• استخدم للتشخيصات أو فحوصات ما قبل الطيران؛ يستخدم وقت التشغيل نفس منطق المزود.
• يتطلب provider_id و check_id و EvidenceContext الكامل.

مثال

استعلام عن مزود الأدلة باستخدام سياق التشغيل.

مدخل:

{
  "context": {
    "correlation_id": null,
    "namespace_id": 1,
    "run_id": "run-0001",
    "scenario_id": "example-scenario",
    "stage_id": "main",
    "tenant_id": 1,
    "trigger_id": "trigger-0001",
    "trigger_time": {
      "kind": "unix_millis",
      "value": 1710000000000
    }
  },
  "query": {
    "check_id": "get",
    "params": {
      "key": "DEPLOY_ENV"
    },
    "provider_id": "env"
  }
}

Output:

{
  "result": {
    "content_type": "text/plain",
    "error": null,
    "evidence_anchor": {
      "anchor_type": "env",
      "anchor_value": "DEPLOY_ENV"
    },
    "evidence_hash": {
      "algorithm": "sha256",
      "value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
    },
    "evidence_ref": null,
    "lane": "verified",
    "signature": null,
    "value": {
      "kind": "json",
      "value": "production"
    }
  }
}

runpack_export

تصدير فنون تشغيل الحزم الحتمية للتحقق غير المتصل.

مدخلات

• generated_at (مطلوب): الطابع الزمني المسجل في البيان.
• include_verification (required): إنشاء تقرير تحقق.
• manifest_name (اختياري، يمكن أن يكون فارغًا): تجاوز اختياري لاسم ملف البيان.
• namespace_id (مطلوب): معرف مساحة الاسم.
• output_dir (اختياري، قابل للإلغاء): دليل الإخراج الاختياري (مطلوب لتصدير نظام الملفات).
• run_id (مطلوب): معرف التشغيل.
• scenario_id (required): معرف السيناريو.
• tenant_id (مطلوب): معرف المستأجر.

المخرجات

• manifest (مطلوب): النوع: كائن.
• report (مطلوب، قابل للإلغاء): واحد من: null، كائن.
• storage_uri (اختياري، يمكن أن يكون فارغًا): URI تخزين اختياري لواجهات تخزين runpack المدارة.

ملاحظات

• يكتب البيان والسجلات إلى output_dir؛ يتم تسجيل generated_at في البيان.
• include_verification يضيف عنصر تقرير التحقق.
• تقرير وقت التصدير .checked_files يستثني verifier_report.json؛ التشغيل غير المتصل runpack_verify .checked_files يتضمنه (+1 لنفس runpack).
• استخدم بعد اكتمال التشغيل أو لقطات التدقيق.

مثال

تصدير حزمة تشغيل مع بيانات وصفية للمانيفيست.

مدخل:

{
  "generated_at": {
    "kind": "unix_millis",
    "value": 1710000000000
  },
  "include_verification": false,
  "manifest_name": "manifest.json",
  "namespace_id": 1,
  "output_dir": "/var/lib/decision-gate/runpacks/run-0001",
  "run_id": "run-0001",
  "scenario_id": "example-scenario",
  "tenant_id": 1
}

Output:

{
  "manifest": {
    "artifacts": [
      {
        "artifact_id": "decision_log",
        "content_type": "application/json",
        "hash": {
          "algorithm": "sha256",
          "value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
        },
        "kind": "decision_log",
        "path": "decision_log.json",
        "required": true
      }
    ],
    "generated_at": {
      "kind": "unix_millis",
      "value": 1710000000000
    },
    "hash_algorithm": "sha256",
    "integrity": {
      "file_hashes": [
        {
          "hash": {
            "algorithm": "sha256",
            "value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
          },
          "path": "decision_log.json"
        }
      ],
      "root_hash": {
        "algorithm": "sha256",
        "value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
      }
    },
    "manifest_version": "v1",
    "namespace_id": 1,
    "run_id": "run-0001",
    "scenario_id": "example-scenario",
    "spec_hash": {
      "algorithm": "sha256",
      "value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
    },
    "tenant_id": 1,
    "verifier_mode": "offline_strict"
  },
  "report": null,
  "storage_uri": null
}

runpack_verify

تحقق من بيان التشغيل والمكونات في وضع عدم الاتصال.

مدخلات

• مسار_التطبيق (مطلوب): مسار التطبيق بالنسبة لجذر حزمة التشغيل.
• runpack_dir (مطلوب): دليل الجذر لـ Runpack.

المخرجات

• التقرير (مطلوب): النوع: كائن.
• حالة (مطلوبة): حالة تحقق من Runpack.

ملاحظات

• يحقق في التجزئات، وجذر السلامة، وبنية سجل القرارات.
• يفشل النظام في حالة فقدان أو العبث بالملفات.
• استخدم في CI أو في خطوط تدقيق غير متصلة بالإنترنت.

مثال

تحقق من بيان التشغيل والمكونات في وضع عدم الاتصال.

مدخل:

{
  "manifest_path": "manifest.json",
  "runpack_dir": "/var/lib/decision-gate/runpacks/run-0001"
}

Output:

{
  "report": {
    "checked_files": 12,
    "errors": [],
    "status": "pass"
  },
  "status": "pass"
}

providers_list

قائمة مقدمي الأدلة المسجلين وملخص القدرات.

مدخلات

المخرجات

• المزودون (مطلوب): النوع: array.

ملاحظات

• يعيد معرفات المزود وبيانات النقل.
• نتائج محصورة بسياسة المصادقة.

مثال

قائمة مقدمي الأدلة المسجلين.

مدخل:

{}

Output:

{
  "providers": [
    {
      "checks": [
        "get"
      ],
      "provider_id": "env",
      "transport": "builtin"
    }
  ]
}

providercontractget

احصل على JSON عقد المزود القياسي وهاش لمزود.

مدخلات

• provider_id (required): معرف المزود.

المخرجات

• عقد (مطلوب): النوع: كائن.
• contract_hash (مطلوب): النوع: object.
• provider_id (required): معرف المزود.
• المصدر (مطلوب): مصدر أصل العقد.
• version (مطلوب، قابل للإلغاء): تسمية إصدار العقد الاختيارية.

ملاحظات

• يعيد عقد المزود كما تم تحميله بواسطة خادم MCP.
• يتضمن تجزئة معيارية للتدقيق وإعادة الإنتاج.
• خاضع لسياسة إفصاح المزود والتفويض.

مثال

احصل على JSON العقد لمزود الخدمة.

مدخل:

{
  "provider_id": "json"
}

Output:

{
  "contract": {
    "checks": [],
    "config_schema": {
      "additionalProperties": false,
      "type": "object"
    },
    "description": "Reads JSON or YAML files and evaluates JSONPath.",
    "name": "JSON Provider",
    "notes": [],
    "provider_id": "json",
    "transport": "builtin"
  },
  "contract_hash": {
    "algorithm": "sha256",
    "value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
  },
  "provider_id": "json",
  "source": "builtin",
  "version": null
}

providercheckschema_get

احصل على تفاصيل مخطط التحقق (المعلمات/النتيجة/المقارنات) لمزود الخدمة.

مدخلات

• check_id (required): معرف فحص المزود.
• provider_id (required): معرف المزود.

المخرجات

• allowed_comparators (مطلوب): قائمة السماح للمقارنات لهذا الفحص.
• أنواع_الرابط (مطلوب): أنواع الروابط التي تصدرها هذه الفحص.
• check_id (required): تحقق من المعرف.
• أنواع المحتوى (مطلوب): أنواع المحتوى لنتيجة الفحص.
• contract_hash (مطلوب): النوع: object.
• الحتمية (مطلوب): تصنيف الحتمية لفحوصات المزود.
• أمثلة (مطلوب): النوع: array.
• params_required (required): ما إذا كانت المعلمات مطلوبة لهذا الفحص.
• params_schema (required): مخطط JSON للتحقق من المعلمات.
• provider_id (required): معرف المزود.
• result_schema (مطلوب): مخطط JSON لقيمة نتيجة الفحص.

ملاحظات

• يُرجع بيانات التعريف المخزنة للمخطط لمراجعة واحدة.
• يتضمن قوائم السماح للمقارنات وأمثلة الفحص.
• خاضع لسياسة إفصاح المزود والتفويض.

مثال

احصل على تفاصيل مخطط التحقق لمقدم الخدمة.

مدخل:

{
  "check_id": "path",
  "provider_id": "json"
}

Output:

{
  "allowed_comparators": [
    "equals",
    "in_set",
    "exists",
    "not_exists"
  ],
  "anchor_types": [],
  "check_id": "path",
  "content_types": [
    "application/json"
  ],
  "contract_hash": {
    "algorithm": "sha256",
    "value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
  },
  "determinism": "external",
  "examples": [],
  "params_required": true,
  "params_schema": {
    "properties": {
      "file": {
        "type": "string"
      },
      "jsonpath": {
        "type": "string"
      }
    },
    "required": [
      "file"
    ],
    "type": "object"
  },
  "provider_id": "json",
  "result_schema": {
    "type": [
      "null",
      "string",
      "number",
      "boolean",
      "array",
      "object"
    ]
  }
}

schemas_register

قم بتسجيل مخطط شكل البيانات لمستأجر وفضاء الأسماء.

مدخلات

• سجل (مطلوب): النوع: كائن.

المخرجات

• سجل (مطلوب): النوع: كائن.

ملاحظات

• المخططات غير قابلة للتغيير؛ تسجيل نفس النسخة مرتين يفشل.
• قدم created_at لتسجيل متى تم تأليف المخطط.

مثال

تسجيل مخطط شكل البيانات.

مدخل:

{
  "record": {
    "created_at": {
      "kind": "unix_millis",
      "value": 1710000000000
    },
    "description": "Asserted payload schema.",
    "namespace_id": 1,
    "schema": {
      "additionalProperties": false,
      "properties": {
        "deploy_env": {
          "type": "string"
        }
      },
      "required": [
        "deploy_env"
      ],
      "type": "object"
    },
    "schema_id": "asserted_payload",
    "tenant_id": 1,
    "version": "v1"
  }
}

Output:

{
  "record": {
    "created_at": {
      "kind": "unix_millis",
      "value": 1710000000000
    },
    "description": "Asserted payload schema.",
    "namespace_id": 1,
    "schema": {
      "additionalProperties": false,
      "properties": {
        "deploy_env": {
          "type": "string"
        }
      },
      "required": [
        "deploy_env"
      ],
      "type": "object"
    },
    "schema_id": "asserted_payload",
    "tenant_id": 1,
    "version": "v1"
  }
}

قائمة_المخططات

قائمة أشكال البيانات المسجلة لمستأجر وفضاء أسماء.

مدخلات

• المؤشر (اختياري، قابل للإلغاء): واحد من: null، string.
• الحد (اختياري): الحد الأقصى لعدد السجلات التي سيتم إرجاعها.
• namespace_id (مطلوب): معرف مساحة الاسم.
• tenant_id (مطلوب): معرف المستأجر.

المخرجات

• العناصر (مطلوب): النوع: array.
• next_token (مطلوب، قابل للإلغاء): واحد من: null، string.

ملاحظات

• يتطلب tenant_id و namespace_id.
• يدعم الترقيم عبر المؤشر + الحد.

مثال

قائمة أشكال البيانات لمساحة الأسماء.

مدخل:

{
  "cursor": null,
  "limit": 50,
  "namespace_id": 1,
  "tenant_id": 1
}

Output:

{
  "items": [
    {
      "created_at": {
        "kind": "unix_millis",
        "value": 1710000000000
      },
      "description": "Asserted payload schema.",
      "namespace_id": 1,
      "schema": {
        "additionalProperties": false,
        "properties": {
          "deploy_env": {
            "type": "string"
          }
        },
        "required": [
          "deploy_env"
        ],
        "type": "object"
      },
      "schema_id": "asserted_payload",
      "tenant_id": 1,
      "version": "v1"
    }
  ],
  "next_token": null
}

schemas_get

احصل على شكل بيانات محدد بواسطة المعرف والإصدار.

مدخلات

• namespace_id (مطلوب): معرف مساحة الاسم.
• schema_id (مطلوب): معرف شكل البيانات.
• tenant_id (مطلوب): معرف المستأجر.
• version (required): معرف إصدار شكل البيانات.

المخرجات

• سجل (مطلوب): النوع: كائن.

ملاحظات

• يتطلب tenant_id و namespace_id و schema_id و version.
• يفشل في الإغلاق عندما يكون المخطط مفقودًا.

مثال

استرجاع شكل البيانات بواسطة المعرف والإصدار.

مدخل:

{
  "namespace_id": 1,
  "schema_id": "asserted_payload",
  "tenant_id": 1,
  "version": "v1"
}

Output:

{
  "record": {
    "created_at": {
      "kind": "unix_millis",
      "value": 1710000000000
    },
    "description": "Asserted payload schema.",
    "namespace_id": 1,
    "schema": {
      "additionalProperties": false,
      "properties": {
        "deploy_env": {
          "type": "string"
        }
      },
      "required": [
        "deploy_env"
      ],
      "type": "object"
    },
    "schema_id": "asserted_payload",
    "tenant_id": 1,
    "version": "v1"
  }
}

قائمة السيناريوهات

قائمة السيناريوهات المسجلة لمستأجر وفضاء الأسماء.

مدخلات

• المؤشر (اختياري، قابل للإلغاء): واحد من: null، string.
• الحد (اختياري): الحد الأقصى لعدد السجلات التي سيتم إرجاعها.
• namespace_id (مطلوب): معرف مساحة الاسم.
• tenant_id (مطلوب): معرف المستأجر.

المخرجات

• العناصر (مطلوب): النوع: array.
• next_token (مطلوب، قابل للإلغاء): واحد من: null، string.

ملاحظات

• يتطلب tenant_id و namespace_id.
• يعيد معرفات السيناريو والتجزئات.

مثال

قائمة السيناريوهات لمساحة الأسماء.

مدخل:

{
  "cursor": null,
  "limit": 50,
  "namespace_id": 1,
  "tenant_id": 1
}

Output:

{
  "items": [
    {
      "namespace_id": 1,
      "scenario_id": "example-scenario",
      "spec_hash": {
        "algorithm": "sha256",
        "value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
      }
    }
  ],
  "next_token": null
}

فحص مسبق

قم بتقييم سيناريو مقابل البيانات المصرح بها دون تغيير الحالة.

مدخلات

• data_shape (مطلوب): النوع: كائن.
• namespace_id (مطلوب): معرف مساحة الاسم.
• حمولة البيانات (مطلوبة): حمولة البيانات المؤكدة.
• scenario_id (اختياري، يمكن أن يكون فارغاً): واحد من: فارغ، سلسلة.
• spec (اختياري، يمكن أن يكون فارغًا): واحد من: null، ref decision-gate://contract/schemas/scenario.schema.json.
• stage_id (اختياري، يمكن أن يكون فارغاً): واحد من: فارغ، سلسلة.
• tenant_id (مطلوب): معرف المستأجر.

المخرجات

• decision (مطلوب): واحد من: كائن، كائن، كائن، كائن، كائن.
• تقييمات_البوابة (مطلوب): النوع: array.

ملاحظات

• يحقق في البيانات المصرح بها مقابل شكل مسجل.
• لا يغير حالة التشغيل؛ مخصص للمحاكاة.

مثال

تحقق مسبقًا من سيناريو مع بيانات مؤكدة.

مدخل:

{
  "data_shape": {
    "schema_id": "asserted_payload",
    "version": "v1"
  },
  "namespace_id": 1,
  "payload": {
    "deploy_env": "production"
  },
  "scenario_id": "example-scenario",
  "spec": null,
  "stage_id": null,
  "tenant_id": 1
}

Output:

{
  "decision": {
    "kind": "hold",
    "summary": {
      "policy_tags": [],
      "retry_hint": "await_evidence",
      "status": "hold",
      "unmet_gates": [
        "ready"
      ]
    }
  },
  "gate_evaluations": []
}

decisiongatedocs_search

ابحث في وثائق Decision Gate للحصول على إرشادات وقت التشغيل.

مدخلات

• max_sections (اختياري): الحد الأقصى لعدد الأقسام التي سيتم إرجاعها (الافتراضي 3، الحد الأقصى 10).
• استعلام (مطلوب): استعلام البحث عن أقسام الوثائق.

المخرجات

• docs_covered (مطلوب): النوع: array.
• الأقسام (مطلوب): النوع: array.
• suggested_followups (required): مطالبات متابعة مدركة للدور.

ملاحظات

• استخدم للبحث السريع عن تدفق الأدلة، والمقارنات، ودلالات المزود.
• يُرجع الأقسام المرتبة مع علامات الدور والمتابعات المقترحة.
• البحث محدد ويقتصر على فهرس الوثائق المكون.

مثال

ابحث عن تدفق الأدلة وإرشادات مسار الثقة.

مدخل:

{
  "max_sections": 2,
  "query": "precheck vs live run trust lanes"
}

Output:

{
  "docs_covered": [
    {
      "doc_id": "evidence_flow_and_execution_model",
      "doc_role": "reasoning",
      "doc_title": "Evidence Flow + Execution Model"
    }
  ],
  "sections": [
    {
      "content": "...",
      "doc_id": "evidence_flow_and_execution_model",
      "doc_role": "reasoning",
      "doc_title": "Evidence Flow + Execution Model",
      "heading": "Core Data Flow",
      "rank": 0
    }
  ],
  "suggested_followups": [
    "Refine the query with comparator or provider keywords for targeted guidance."
  ]
}

typedprovidersimport

استيراد OpenAPI إلى فنون مزود مكتوبة وتسجيل إصدار الملف الشخصي.

مدخلات

• activate (اختياري): قم بتفعيل هذه النسخة بعد التسجيل.
• allow_unsafe_methods (اختياري): السماح بأساليب HTTP غير الآمنة أثناء الاستيراد.
• credential_bindings (مطلوب): معرف نظام أمان OpenAPI لبيانات الربط الهيكلية (المحدد + قيمة العرض). استخدم {} للاستيرادات غير المصرح بها.
• external_ref_mode (اختياري): سياسة حل مرجع خارجي اختيارية.
• max_response_bytes (اختياري): حد حجم الاستجابة في وقت التشغيل الاختياري.
• media_support_mode (اختياري): وضع دعم الوسائط الاختياري.
• namespace_id (مطلوب): معرف مساحة الاسم.
• openapi (مطلوب): وثيقة OpenAPI 3.x بصيغة JSON.
• openapi_conformance_mode (اختياري): وضع التوافق: الكتل الصارمة تمنع الإنشاءات غير المدعومة؛ تقارير التدقيق بدون تفعيل.
• openapi_semantics_mode (اختياري): تجاوز وضع دلالات OpenAPI الاختياري.
• openapi_source_path (اختياري): مسار مصدر اختياري يُستخدم لحل مراجع الملفات المحلية.
• operation_allowlist (مطلوب): قائمة السماح بالمعرفات التشغيلية الصريحة للاستيراد الصارم.
• outbound_max_inflight (اختياري): تجاوز حد الطيران الخارجي الاختياري.
• provider_id (مطلوب): معرف المزود المكتوب.
• retry_initial_backoff_ms (اختياري): تجاوز اختياري لوقت الانتظار الأولي لإعادة المحاولة.
• retry_max_attempts (اختياري): تجاوز الحد الأقصى لمحاولات إعادة المحاولة الخارجية الاختيارية.
• retry_max_backoff_ms (اختياري): تجاوز الحد الأقصى للاحتفاظ بالوقت بين المحاولات الخارجية.
• tenant_id (مطلوب): معرف المستأجر.
• timeout_ms (اختياري): تجاوز وقت التشغيل الاختياري بالمللي ثانية.
• version (مطلوب): معرف إصدار دورة الحياة.

المخرجات

• active_version (مطلوب، قابل للإلغاء): واحد من: null، string.
• conformance_summary (مطلوب): النوع: كائن.
• contract_hash (مطلوب): النوع: object.
• operation_count (مطلوب): النوع: عدد صحيح.
• profile_digest (مطلوب): النوع: كائن.
• provider_id (مطلوب): معرف المزود المكتوب.
• register_outcome (مطلوب): نتيجة تسجيل دورة حياة الملف الشخصي المطبوع.
• source_digest (مطلوب): النوع: كائن.
• version (مطلوب): معرف إصدار دورة الحياة.

ملاحظات

• يتطلب حقول tenant_id و namespace_id.
• يتطلب الاستيراد المغلق الصارم قائمة مسموح بها للعمليات بشكل صريح.
• يتطلب رسم خرائط credential_bindings صريح؛ استخدم {} للاستيرادات غير الموثقة.
• يدعم حدود الخروج المحدودة وسياسة إعادة المحاولة لملفات تعريف وقت التشغيل المولدة.
• يولد عقود مزود حتمية + قطع ملفات تعريف وقت التشغيل.
• يسجل بيانات دورة الحياة ويقوم بتفعيل النسخة المستوردة بشكل اختياري.

مثال

استيراد وثيقة OpenAPI إلى كائنات ذات نوع محدد.

مدخل:

{
  "activate": true,
  "allow_unsafe_methods": false,
  "credential_bindings": {},
  "external_ref_mode": "local_file_only",
  "max_response_bytes": 1048576,
  "media_support_mode": "json_only",
  "namespace_id": 1,
  "openapi": {
    "openapi": "3.1.0",
    "paths": {
      "/assets": {
        "get": {
          "operationId": "listAssets",
          "responses": {
            "200": {
              "content": {
                "application/json": {
                  "schema": {
                    "additionalProperties": false,
                    "properties": {
                      "items": {
                        "type": "array"
                      }
                    },
                    "required": [
                      "items"
                    ],
                    "type": "object"
                  }
                }
              },
              "description": "ok"
            }
          }
        }
      }
    }
  },
  "openapi_conformance_mode": "strict",
  "openapi_semantics_mode": "auto",
  "operation_allowlist": [
    "listAssets"
  ],
  "outbound_max_inflight": 32,
  "provider_id": "asset_api",
  "retry_initial_backoff_ms": 100,
  "retry_max_attempts": 3,
  "retry_max_backoff_ms": 2000,
  "tenant_id": 1,
  "timeout_ms": 5000,
  "version": "2026-02-17.1"
}

Output:

{
  "active_version": "2026-02-17.1",
  "conformance_summary": {
    "activation_allowed": true,
    "import_mode": "strict",
    "supported_feature_hits": [
      "openapi.version.3_1"
    ],
    "supported_features_covered": 1,
    "unsupported_codes": [],
    "unsupported_construct_count": 0,
    "unsupported_findings": []
  },
  "contract_hash": {
    "algorithm": "sha256",
    "value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
  },
  "operation_count": 1,
  "profile_digest": {
    "algorithm": "sha256",
    "value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
  },
  "provider_id": "asset_api",
  "register_outcome": "registered",
  "source_digest": {
    "algorithm": "sha256",
    "value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
  },
  "version": "2026-02-17.1"
}

typedprovidersregister

تسجيل عقد مزود مكتوب مسبقًا + ملفات تعريف وقت التشغيل.

مدخلات

• activate (اختياري): قم بتفعيل هذه النسخة بعد التسجيل.
• عقد (مطلوب): النوع: كائن.
• namespace_id (مطلوب): معرف مساحة الاسم.
• provider_id (مطلوب): معرف المزود المكتوب.
• runtime_profile (مطلوب): عنصر ملف تعريف وقت التشغيل المخصص.
• tenant_id (مطلوب): معرف المستأجر.
• version (مطلوب): معرف إصدار دورة الحياة.

المخرجات

• active_version (مطلوب، قابل للإلغاء): واحد من: null، string.
• contract_hash (مطلوب): النوع: object.
• operation_count (مطلوب): النوع: عدد صحيح.
• profile_digest (مطلوب): النوع: كائن.
• provider_id (مطلوب): معرف المزود المكتوب.
• register_outcome (مطلوب): نتيجة تسجيل دورة حياة الملف الشخصي المطبوع.
• source_digest (مطلوب): النوع: كائن.
• version (مطلوب): معرف إصدار دورة الحياة.

ملاحظات

• يتطلب حقول tenant_id و namespace_id.
• يتحقق من اتساق هوية الناقل/المزود المدخلة.
• يتحقق من سلامة ملخص ملف تعريف وقت التشغيل قبل التسجيل.
• يسجل بيانات دورة حياة النسخة ويفعل النسخة بشكل اختياري.

مثال

تسجيل فنون مزود مكتوبة مسبقًا.

مدخل:

{
  "activate": false,
  "contract": {
    "checks": [],
    "config_schema": {
      "additionalProperties": false,
      "type": "object"
    },
    "description": "Typed API provider",
    "name": "Asset API",
    "notes": [],
    "provider_id": "asset_api",
    "transport": "typed"
  },
  "namespace_id": 1,
  "provider_id": "asset_api",
  "runtime_profile": {
    "anchors": {
      "anchor_type": "typed_request"
    },
    "operations": [
      {
        "allowed_status_codes": [
          200
        ],
        "auth": {
          "alternatives": [
            {
              "kind": "none"
            }
          ]
        },
        "bindings": [],
        "check_id": "listAssets",
        "content_types": [
          "application/json"
        ],
        "extraction": {
          "kind": "json_body"
        },
        "method": "GET",
        "operation_id": "listAssets",
        "target": "https://api.example.com/assets"
      }
    ],
    "profile_digest": {
      "algorithm": "sha256",
      "value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
    },
    "profile_version": "typed-runtime-v4",
    "protocol": "openapi_http",
    "provider_id": "asset_api",
    "security": {
      "allow_http": false,
      "allow_private_networks": false,
      "allowed_hosts": null,
      "max_response_bytes": 1048576,
      "outbound_max_inflight": 32,
      "retry": {
        "initial_backoff_ms": 100,
        "max_attempts": 3,
        "max_backoff_ms": 2000
      },
      "timeout_ms": 5000
    },
    "source_digest": {
      "algorithm": "sha256",
      "value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
    }
  },
  "tenant_id": 1,
  "version": "2026-02-17.2"
}

Output:

{
  "active_version": null,
  "contract_hash": {
    "algorithm": "sha256",
    "value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
  },
  "operation_count": 1,
  "profile_digest": {
    "algorithm": "sha256",
    "value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
  },
  "provider_id": "asset_api",
  "register_outcome": "registered",
  "source_digest": {
    "algorithm": "sha256",
    "value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
  },
  "version": "2026-02-17.2"
}

typedproviderslist

قائمة كتالوجات دورة حياة موفري الأنواع والإصدارات المسجلة.

مدخلات

• المؤشر (اختياري، قابل للإلغاء): واحد من: null، string.
• limit (اختياري): الحد الأقصى لعدد كتالوجات المزودين التي يجب إرجاعها.
• namespace_id (مطلوب): معرف مساحة الاسم.
• tenant_id (مطلوب): معرف المستأجر.

المخرجات

• العناصر (مطلوب): النوع: array.
• next_token (مطلوب، قابل للإلغاء): واحد من: null، string.

ملاحظات

• يتطلب حقول tenant_id و namespace_id.
• يدعم التصفح الحتمي عبر المؤشر + الحد.
• النتائج محددة بسياسة الكشف عن اكتشاف المزود.

مثال

قائمة كتالوجات دورة حياة موفري الأنواع.

مدخل:

{
  "cursor": null,
  "limit": 50,
  "namespace_id": 1,
  "tenant_id": 1
}

Output:

{
  "items": [
    {
      "active_version": "2026-02-17.1",
      "provider_id": "asset_api",
      "versions": [
        {
          "deprecated": false,
          "profile_digest": {
            "algorithm": "sha256",
            "value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
          },
          "source_digest": {
            "algorithm": "sha256",
            "value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
          },
          "version": "2026-02-17.1"
        }
      ]
    }
  ],
  "next_token": null
}

typedprovidersget

استرجاع فنون مزود مكتوبة + بيانات دورة الحياة لإصدار واحد.

مدخلات

• namespace_id (مطلوب): معرف مساحة الاسم.
• observed_profile_digest (اختياري، يمكن أن يكون فارغًا): ملاحظة اختياريّة لملخص الملف الشخصي لفحوصات الانحراف.
• observed_source_digest (اختياري، قابل للإلغاء): ملاحظة اختياريّة لملخص المصدر لمراقبة الانجراف.
• provider_id (مطلوب): معرف المزود المكتوب.
• tenant_id (مطلوب): معرف المستأجر.
• version (اختياري، قابل للإلغاء): واحد من: null، string.

المخرجات

• active_version (مطلوب، قابل للإلغاء): واحد من: null، string.
• catalog_version (مطلوب): إصدار مخطط دورة حياة الكتالوج المطبوع.
• عقد (مطلوب): النوع: كائن.
• drift_status (مطلوب، قابل للإلغاء): واحد من: null، string.
• provider_id (مطلوب): معرف المزود المكتوب.
• سجل (مطلوب): النوع: كائن.
• runtime_profile (مطلوب): عنصر ملف تعريف وقت التشغيل المخصص.
• selected_version (مطلوب): إصدار دورة الحياة المحدد.
• source (مطلوب): كيفية تسجيل العناصر المكتوبة.

ملاحظات

• يتطلب حقول tenant_id و namespace_id.
• إرجاع عقد المزود + ملف التشغيل للإصدار المحدد.
• يمكن تقييم انحراف التجزئة مقابل التجزئات المصدر/الملف الشخصي الملاحظة.
• إذا تم حذف الإصدار، يتم اختيار الإصدار النشط.

مثال

استرجاع العناصر الفنية لمزود البيانات المدخلة وبيانات دورة الحياة.

مدخل:

{
  "namespace_id": 1,
  "observed_profile_digest": {
    "algorithm": "sha256",
    "value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
  },
  "observed_source_digest": {
    "algorithm": "sha256",
    "value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
  },
  "provider_id": "asset_api",
  "tenant_id": 1,
  "version": "2026-02-17.1"
}

Output:

{
  "active_version": "2026-02-17.1",
  "catalog_version": "typed-lifecycle-v1",
  "contract": {
    "checks": [],
    "config_schema": {
      "additionalProperties": false,
      "type": "object"
    },
    "description": "Typed API provider",
    "name": "Asset API",
    "notes": [],
    "provider_id": "asset_api",
    "transport": "typed"
  },
  "drift_status": "in_sync",
  "provider_id": "asset_api",
  "record": {
    "deprecated": false,
    "profile_digest": {
      "algorithm": "sha256",
      "value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
    },
    "source_digest": {
      "algorithm": "sha256",
      "value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
    },
    "version": "2026-02-17.1"
  },
  "runtime_profile": {
    "anchors": {
      "anchor_type": "typed_request"
    },
    "operations": [
      {
        "allowed_status_codes": [
          200
        ],
        "auth": {
          "alternatives": [
            {
              "kind": "none"
            }
          ]
        },
        "bindings": [],
        "check_id": "listAssets",
        "content_types": [
          "application/json"
        ],
        "extraction": {
          "kind": "json_body"
        },
        "method": "GET",
        "operation_id": "listAssets",
        "target": "https://api.example.com/assets"
      }
    ],
    "profile_digest": {
      "algorithm": "sha256",
      "value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
    },
    "profile_version": "typed-runtime-v4",
    "protocol": "openapi_http",
    "provider_id": "asset_api",
    "security": {
      "allow_http": false,
      "allow_private_networks": false,
      "allowed_hosts": null,
      "max_response_bytes": 1048576,
      "outbound_max_inflight": 32,
      "retry": {
        "initial_backoff_ms": 100,
        "max_attempts": 3,
        "max_backoff_ms": 2000
      },
      "timeout_ms": 5000
    },
    "source_digest": {
      "algorithm": "sha256",
      "value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
    }
  },
  "selected_version": "2026-02-17.1",
  "source": "openapi_import"
}

typedprovidersactivate

تفعيل إصدار دورة حياة موفر مكتوب.

مدخلات

• namespace_id (مطلوب): معرف مساحة الاسم.
• provider_id (مطلوب): معرف المزود المكتوب.
• tenant_id (مطلوب): معرف المستأجر.
• version (مطلوب): إصدار دورة الحياة للتفعيل.

المخرجات

• active_version (مطلوب): النسخة المفعلة.
• previous_active_version (مطلوب، قابل لأن يكون فارغاً): واحد من: null، string.
• provider_id (مطلوب): معرف المزود المكتوب.

ملاحظات

• يتطلب حقول tenant_id و namespace_id.
• سجلات التفعيل تحتفظ بالإصدارات النشطة السابقة للعودة.
• لا يمكن تفعيل الإصدارات المهجورة.

مثال

قم بتنشيط إصدار مزود مكتوب.

مدخل:

{
  "namespace_id": 1,
  "provider_id": "asset_api",
  "tenant_id": 1,
  "version": "2026-02-17.2"
}

Output:

{
  "active_version": "2026-02-17.2",
  "previous_active_version": "2026-02-17.1",
  "provider_id": "asset_api"
}

typedprovidersdeprecate

إلغاء إصدار دورة حياة موفر مخصص، مع إمكانية التراجع النشط.

مدخلات

• namespace_id (مطلوب): معرف مساحة الاسم.
• provider_id (مطلوب): معرف المزود المكتوب.
• rollback_if_active (اختياري): تراجع عن النسخة النشطة قبل إلغاء استخدامها عند الحاجة.
• tenant_id (مطلوب): معرف المستأجر.
• version (مطلوب): إصدار دورة الحياة لإلغاء الاستخدام.

المخرجات

• active_version (مطلوب، قابل للإلغاء): واحد من: null، string.
• deprecated_version (مطلوب): إصدار دورة حياة قديم.
• provider_id (مطلوب): معرف المزود المكتوب.
• rolled_back_from (مطلوب، قابل للإلغاء): واحد من: null، string.

ملاحظات

• يتطلب حقول tenant_id و namespace_id.
• يتطلب إلغاء النسخة النشطة تراجعًا صريحًا إذا كانت نشطة = true.
• التراجع يختار أحدث إصدار نشط غير مهمل.

مثال

إلغاء إصدار مزود مكتوب مع إمكانية التراجع.

مدخل:

{
  "namespace_id": 1,
  "provider_id": "asset_api",
  "rollback_if_active": true,
  "tenant_id": 1,
  "version": "2026-02-17.2"
}

Output:

{
  "active_version": "2026-02-17.1",
  "deprecated_version": "2026-02-17.2",
  "provider_id": "asset_api",
  "rolled_back_from": "2026-02-17.2"
}