Skip to content

BuilderIO/agent-native / packages/core/docs

agent-native-docs

Unverified

How to look up version-matched Agent-Native framework docs and source in node_modules. Use before coding against @agent-native/core APIs or advanced features.

FileKindSize
AGENTS.mdmarkdown6.0 KB
SKILL.mdskill md2.2 KB
content/a2a-protocol.mdxmarkdown37.6 KB
content/actions-access-control.mdxmarkdown28.9 KB
content/actions-advanced.mdxmarkdown13.1 KB
content/actions-agent-tools.mdxmarkdown5.6 KB
content/actions-defining.mdxmarkdown31.2 KB
content/actions-other-surfaces.mdxmarkdown10.3 KB
content/actions-overview.mdxmarkdown8.3 KB
content/actions-run-context.mdxmarkdown9.1 KB
content/add-ui-to-your-agent.mdxmarkdown5.0 KB
content/administered-deployments.mdxmarkdown7.7 KB
content/agent-mentions.mdxmarkdown10.2 KB
content/agent-native-config.mdxmarkdown34.9 KB
content/agent-native-toolkit.mdxmarkdown17.3 KB
content/agent-resources.mdxmarkdown27.0 KB
content/agent-surfaces.mdxmarkdown33.8 KB
content/agent-teams.mdxmarkdown13.4 KB
content/agent-web-surfaces.mdxmarkdown10.7 KB
content/agentkit.mdxmarkdown14.0 KB
content/audit-log.mdxmarkdown14.3 KB
content/authentication.mdxmarkdown30.7 KB
content/automation-connectors.mdxmarkdown7.8 KB
content/automations.mdxmarkdown26.7 KB
content/aws-amplify.mdxmarkdown10.7 KB
content/aws-lambda.mdxmarkdown13.9 KB
content/aws-rds.mdxmarkdown1.7 KB
content/azure-postgresql.mdxmarkdown1.8 KB
content/azure-static-web-apps.mdxmarkdown9.1 KB
content/blueprint-installer.mdxmarkdown6.3 KB
content/cli-adapters.mdxmarkdown5.7 KB
content/client-advanced.mdxmarkdown13.1 KB
content/client-agent-chat.mdxmarkdown17.7 KB
content/client-data.mdxmarkdown19.3 KB
content/client-entry-points.mdxmarkdown1.2 KB
content/client-overview.mdxmarkdown10.6 KB
content/client-routing.mdxmarkdown5.7 KB
content/client-sync-internals.mdxmarkdown5.2 KB
content/cloneable-saas.mdxmarkdown16.6 KB
content/cloud-sql.mdxmarkdown2.3 KB
content/cloudflare.mdxmarkdown8.3 KB
content/code-agents-ui.mdxmarkdown26.6 KB
content/components.mdxmarkdown42.9 KB
content/context-awareness.mdxmarkdown24.9 KB
content/create-with-an-agent.mdxmarkdown8.8 KB
content/creating-templates.mdxmarkdown21.6 KB
content/cross-app-connect-design.mdxmarkdown8.4 KB
content/cross-app-sso.mdxmarkdown8.7 KB
content/custom-design-system.mdxmarkdown17.3 KB
content/data-programs.mdxmarkdown25.0 KB
content/decisions.mdxmarkdown7.9 KB
content/deno-deploy.mdxmarkdown7.2 KB
content/deploy-an-app.mdxmarkdown5.0 KB
content/deployment-environment-variables.mdxmarkdown16.3 KB
content/deployment.mdxmarkdown11.3 KB
content/dispatch.mdxmarkdown18.6 KB
content/docker.mdxmarkdown8.1 KB
content/docs-components.mdxmarkdown28.9 KB
content/doctor.mdxmarkdown21.3 KB
content/drafts/clips-experimental-features.mdmarkdown5.4 KB
content/drop-in-agent.mdxmarkdown16.0 KB
content/durable-background-runs.mdxmarkdown13.8 KB
content/durable-resume.mdxmarkdown10.0 KB
content/embedding-sdk.mdxmarkdown31.3 KB
content/environment-variables.mdxmarkdown29.9 KB
content/evals.mdxmarkdown12.4 KB
content/extensions.mdxmarkdown34.8 KB
content/external-agents-catalog.mdxmarkdown40.5 KB
content/external-agents.mdxmarkdown29.3 KB
content/file-uploads.mdxmarkdown10.7 KB
content/generative-ui.mdxmarkdown10.8 KB
content/getting-started-actions.mdxmarkdown2.7 KB
content/getting-started-pages.mdxmarkdown2.6 KB
content/getting-started.mdxmarkdown7.2 KB
content/harness-agents.mdxmarkdown16.9 KB
content/http-api.mdxmarkdown20.9 KB
content/integrations.mdxmarkdown33.8 KB
content/internationalization.mdxmarkdown6.2 KB
content/key-concepts.mdxmarkdown30.6 KB
content/koyeb.mdxmarkdown7.3 KB
content/locales/ar-SA/a2a-protocol.mdxmarkdown48.5 KB
content/locales/ar-SA/actions-access-control.mdxmarkdown40.8 KB
content/locales/ar-SA/actions-advanced.mdxmarkdown16.3 KB
content/locales/ar-SA/actions-agent-tools.mdxmarkdown8.1 KB
content/locales/ar-SA/actions-defining.mdxmarkdown42.2 KB
content/locales/ar-SA/actions-other-surfaces.mdxmarkdown14.5 KB
content/locales/ar-SA/actions-overview.mdxmarkdown11.3 KB
content/locales/ar-SA/actions-run-context.mdxmarkdown11.1 KB
content/locales/ar-SA/add-ui-to-your-agent.mdxmarkdown3.7 KB
content/locales/ar-SA/administered-deployments.mdxmarkdown6.4 KB
content/locales/ar-SA/agent-mentions.mdxmarkdown11.8 KB
content/locales/ar-SA/agent-native-toolkit.mdxmarkdown17.3 KB
content/locales/ar-SA/agent-resources.mdxmarkdown36.8 KB
content/locales/ar-SA/agent-surfaces.mdxmarkdown48.4 KB
content/locales/ar-SA/agent-teams.mdxmarkdown18.5 KB
content/locales/ar-SA/agent-web-surfaces.mdxmarkdown14.3 KB
content/locales/ar-SA/audit-log.mdxmarkdown15.9 KB
content/locales/ar-SA/authentication.mdxmarkdown39.8 KB
content/locales/ar-SA/automations.mdxmarkdown31.3 KB
content/locales/ar-SA/aws-amplify.mdxmarkdown14.9 KB
content/locales/ar-SA/aws-lambda.mdxmarkdown18.9 KB
content/locales/ar-SA/aws-rds.mdxmarkdown319 B
content/locales/ar-SA/azure-postgresql.mdxmarkdown344 B
content/locales/ar-SA/azure-static-web-apps.mdxmarkdown12.4 KB
content/locales/ar-SA/blueprint-installer.mdxmarkdown8.4 KB
content/locales/ar-SA/cli-adapters.mdxmarkdown6.7 KB
content/locales/ar-SA/client-advanced.mdxmarkdown17.8 KB
content/locales/ar-SA/client-agent-chat.mdxmarkdown23.0 KB
content/locales/ar-SA/client-data.mdxmarkdown23.8 KB
content/locales/ar-SA/client-entry-points.mdxmarkdown1.6 KB
content/locales/ar-SA/client-overview.mdxmarkdown13.9 KB
content/locales/ar-SA/client-routing.mdxmarkdown7.2 KB
content/locales/ar-SA/client-sync-internals.mdxmarkdown7.3 KB
content/locales/ar-SA/cloneable-saas.mdxmarkdown23.2 KB
content/locales/ar-SA/cloud-sql.mdxmarkdown317 B
content/locales/ar-SA/cloudflare.mdxmarkdown11.9 KB
content/locales/ar-SA/code-agents-ui.mdxmarkdown34.2 KB
content/locales/ar-SA/components.mdxmarkdown51.5 KB
content/locales/ar-SA/context-awareness.mdxmarkdown33.1 KB
content/locales/ar-SA/create-with-an-agent.mdxmarkdown12.2 KB
content/locales/ar-SA/creating-templates.mdxmarkdown26.8 KB
content/locales/ar-SA/cross-app-connect-design.mdxmarkdown1.5 KB
content/locales/ar-SA/cross-app-sso.mdxmarkdown9.7 KB
content/locales/ar-SA/custom-design-system.mdxmarkdown21.6 KB
content/locales/ar-SA/data-programs.mdxmarkdown33.3 KB
content/locales/ar-SA/decisions.mdxmarkdown9.1 KB
content/locales/ar-SA/deno-deploy.mdxmarkdown10.1 KB
content/locales/ar-SA/deploy-an-app.mdxmarkdown7.1 KB
content/locales/ar-SA/deployment-environment-variables.mdxmarkdown21.3 KB
content/locales/ar-SA/deployment.mdxmarkdown13.9 KB
content/locales/ar-SA/dispatch.mdxmarkdown27.3 KB
content/locales/ar-SA/docker.mdxmarkdown11.3 KB
content/locales/ar-SA/doctor.mdxmarkdown3.4 KB
content/locales/ar-SA/drop-in-agent.mdxmarkdown20.8 KB
content/locales/ar-SA/durable-resume.mdxmarkdown15.4 KB
content/locales/ar-SA/embedding-sdk.mdxmarkdown41.3 KB
content/locales/ar-SA/evals.mdxmarkdown13.3 KB
content/locales/ar-SA/extensions.mdxmarkdown34.0 KB
content/locales/ar-SA/external-agents.mdxmarkdown89.3 KB
content/locales/ar-SA/file-uploads.mdxmarkdown13.4 KB
content/locales/ar-SA/getting-started-actions.mdxmarkdown3.2 KB
content/locales/ar-SA/getting-started-pages.mdxmarkdown3.2 KB
content/locales/ar-SA/getting-started.mdxmarkdown9.7 KB
content/locales/ar-SA/harness-agents.mdxmarkdown22.3 KB
content/locales/ar-SA/internationalization.mdxmarkdown8.2 KB
content/locales/ar-SA/key-concepts.mdxmarkdown42.0 KB
content/locales/ar-SA/koyeb.mdxmarkdown10.2 KB
content/locales/ar-SA/mcp-apps.mdxmarkdown33.7 KB
content/locales/ar-SA/mcp-clients.mdxmarkdown35.0 KB
content/locales/ar-SA/mcp-protocol.mdxmarkdown27.6 KB
content/locales/ar-SA/messaging.mdxmarkdown59.2 KB
content/locales/ar-SA/multi-app-workspace.mdxmarkdown36.2 KB
content/locales/ar-SA/multi-tenancy.mdxmarkdown7.5 KB
content/locales/ar-SA/native-chat-ui.mdxmarkdown21.3 KB
content/locales/ar-SA/neon.mdxmarkdown244 B
content/locales/ar-SA/netlify.mdxmarkdown15.2 KB
content/locales/ar-SA/node-docker.mdxmarkdown878 B
content/locales/ar-SA/node-js.mdxmarkdown8.4 KB
content/locales/ar-SA/notifications.mdxmarkdown16.2 KB
content/locales/ar-SA/observability.mdxmarkdown45.2 KB
content/locales/ar-SA/observational-memory.mdxmarkdown10.9 KB
content/locales/ar-SA/onboarding.mdxmarkdown16.9 KB
content/locales/ar-SA/organizations-teams-permissions.mdxmarkdown5.9 KB
content/locales/ar-SA/package-lifecycle.mdxmarkdown3.0 KB
content/locales/ar-SA/plan-plugin.mdxmarkdown23.0 KB
content/locales/ar-SA/portal.mdxmarkdown636 B
content/locales/ar-SA/postgres.mdxmarkdown487 B
content/locales/ar-SA/pr-visual-recap.mdxmarkdown53.9 KB
content/locales/ar-SA/privacy-and-data-rights.mdxmarkdown6.2 KB
content/locales/ar-SA/processors.mdxmarkdown8.7 KB
content/locales/ar-SA/progress.mdxmarkdown10.7 KB
content/locales/ar-SA/pure-agent-apps.mdxmarkdown5.0 KB
content/locales/ar-SA/real-time-collaboration.mdxmarkdown55.6 KB
content/locales/ar-SA/recorder.mdxmarkdown16.7 KB
content/locales/ar-SA/recurring-jobs.mdxmarkdown23.8 KB
content/locales/ar-SA/render.mdxmarkdown11.2 KB
content/locales/ar-SA/sandbox-adapters.mdxmarkdown18.0 KB
content/locales/ar-SA/security.mdxmarkdown31.5 KB
content/locales/ar-SA/server-database.mdxmarkdown27.6 KB
content/locales/ar-SA/server-middleware.mdxmarkdown7.9 KB
content/locales/ar-SA/server-overview.mdxmarkdown12.2 KB
content/locales/ar-SA/server-plugins.mdxmarkdown9.1 KB
content/locales/ar-SA/server-routes.mdxmarkdown14.3 KB
content/locales/ar-SA/sharing.mdxmarkdown28.6 KB
content/locales/ar-SA/skills-guide.mdxmarkdown27.0 KB
content/locales/ar-SA/ssr-caching.mdxmarkdown7.4 KB
content/locales/ar-SA/supabase.mdxmarkdown264 B
content/locales/ar-SA/syncing-template-changes.mdxmarkdown11.7 KB
content/locales/ar-SA/telemetry.mdxmarkdown21.9 KB
content/locales/ar-SA/template-analytics.mdxmarkdown26.4 KB
content/locales/ar-SA/template-assets.mdxmarkdown31.9 KB
content/locales/ar-SA/template-brain.mdxmarkdown29.7 KB
content/locales/ar-SA/template-calendar-agent.mdxmarkdown10.2 KB
content/locales/ar-SA/template-calendar-developers.mdxmarkdown33.4 KB
content/locales/ar-SA/template-calendar-features.mdxmarkdown14.4 KB
content/locales/ar-SA/template-calendar-integrations.mdxmarkdown6.2 KB
content/locales/ar-SA/template-calendar.mdxmarkdown4.4 KB
content/locales/ar-SA/template-chat-agent.mdxmarkdown4.7 KB
content/locales/ar-SA/template-chat-developers.mdxmarkdown31.3 KB
content/locales/ar-SA/template-chat-features.mdxmarkdown9.9 KB

content/locales/ar-SA/server-routes.mdx

View on GitHub
---
title: "المسارات"
description: "مسارات خادم Nitro المستندة إلى الملفات، ومسار SSR الشامل، واصطلاحات التسمية، وتحديد نطاق المسارات المخصصة للمستخدم المصادق عليه."
---

# المسارات

ينقسم التوجيه على مستوى الخادم في تطبيق أصلي للوكيل إلى سطحين.

**مسارات إطار العمل** عند `/_agent-native/*` يديرها إطار العمل. وهي تكشف حلقة دردشة الوكيل، واستطلاع المزامنة، ونقاط نهاية actions، وقدرات أساسية أخرى. لا تُنشئ هذه المسارات أو تُعدّلها بنفسك.

**مسارات الملفات المخصصة** في `server/routes/` هي حيث تُضيف نقاط النهاية الخاصة بك. يلتقطها Nitro تلقائيًا استنادًا إلى موضعها في شجرة الأدلة — دون الحاجة إلى أي تسجيل أو تكوين. يحدّد اسم الملف طريقة HTTP، ويصبح مسار الدليل مسار URL، ويُصدّر كل ملف معالجًا واحدًا.

## المسارات المثبَّتة بواسطة إطار العمل {#framework-routes}

يحجز إطار العمل مساحة الاسم `/_agent-native/` لنقاط نهايته الخاصة. لا تضع أبدًا مسارات مخصصة هنا. هذا الجدول تمثيلي، وليس شاملاً.

| بادئة المسار                     | الغرض                                                                                 |
| -------------------------------- | ------------------------------------------------------------------------------------- |
| `/_agent-native/actions/:name`   | نقاط نهاية HTTP لـ actions                                                            |
| `/_agent-native/agent-chat`      | حلقة دردشة الوكيل                                                                     |
| `/_agent-native/poll`            | مزامنة واجهة المستخدم المدعومة بـ SQL                                                 |
| `/_agent-native/runs`            | بدائية التقدم (progress). يستطلع `RunsTray` هذا المسار؛ راجع [التقدم](/docs/progress) |
| `/_agent-native/resources/*`     | موارد مساحة العمل                                                                     |
| `/_agent-native/extensions/*`    | ملحقات وقت التشغيل ووكيل الملحقات (اسم مستعار قديم: `/_agent-native/tools/*`)         |
| `/_agent-native/integrations/*`  | تكاملات المراسلة/الويب هوك                                                            |
| `/_agent-native/a2a`             | JSON-RPC بين الوكلاء (agent-to-agent)                                                 |
| `/mcp`                           | نقطة نهاية MCP                                                                        |
| `/_agent-native/onboarding/*`    | قائمة تحقق الإعداد                                                                    |
| `/_agent-native/observability/*` | التتبعات (traces)، والتعليقات، والتقييمات (evals)، والتجارب                           |
| `/_agent-native/file-upload`     | نقطة نهاية موفر رفع الملفات                                                           |

تذهب مسارات التطبيق المخصصة إلى `/api/*` أو مسار آخر لا يتعارض مع `/_agent-native/`.

## متى تستخدم مسارًا مخصصًا {#when-custom-routes}

تغطي Actions الغالبية العظمى من عمليات التطبيق. لا تلجأ إلى مسار ملف في `server/routes/` إلا عندما تحتاج إلى شيء لا يمكن لـ action التعبير عنه.

<Comparison>

### استخدم مسارًا مخصصًا {#use-custom-route}

- رفع الملفات أو بيانات نماذج متعددة الأجزاء (multipart)
- الاستجابات المتدفقة (streaming) أو أحداث الخادم المُرسَلة (SSE)
- الويب هوك الواردة التي تحتاج إلى التحقق من الجسم الخام (raw body)
- استدعاءات OAuth المرتدة (callbacks)
- صفحات عامة غير مصادَق عليها
- عقود REST خارجية تتطلب مسار URL أو شكل استجابة محددًا

### استخدم action بدلاً من ذلك {#use-action-instead}

- العمليات التي تحتاجها واجهة المستخدم والوكيل معًا
- قراءة بيانات التطبيق أو كتابتها
- نقاط نهاية على شكل HTTP (استخدم خيار `http` في [Actions](/docs/actions-overview))
- أي شيء يجب أن يكون أداة للوكيل، أو أداة MCP، أو أمر CLI
- واجهات برمجة تطبيقات قياسية لطلبات/استجابات JSON

</Comparison>

### مثال: ويب هوك وارد {#example-webhook}

الويب هوك حالة واضحة لاستخدام مسار مخصص. ترسل الخدمات الخارجية جسم HTTP خامًا يجب قراءته كبايتات قبل تحليله حتى تتمكن من التحقق من توقيع الطلب. تستقبل Actions JSON مُحلَّلاً مسبقًا ولا يمكنها الوصول إلى الجسم الخام، مما يجعل التحقق من التوقيع مستحيلاً داخلها.

يتعامل المسار أدناه مع ويب هوك وارد عند `POST /api/webhooks/events`. فهو يقرأ الجسم الخام، ويتحقق من توقيع HMAC، ثم يعالج الحمولة (payload).

```ts filename="server/routes/api/webhooks/events.post.ts"
import { createHmac, timingSafeEqual } from "crypto";
import { createError, defineEventHandler, getHeader, readRawBody } from "h3";

export default defineEventHandler(async (event) => {
  const secret = process.env.WEBHOOK_SECRET;
  const signature = getHeader(event, "x-webhook-signature");
  const rawBody = await readRawBody(event);

  if (!secret || !signature || !rawBody) {
    throw createError({ statusCode: 400, statusMessage: "Bad Request" });
  }

  const expected = createHmac("sha256", secret).update(rawBody).digest("hex");
  const signatureBytes = Buffer.from(signature, "utf8");
  const expectedBytes = Buffer.from(expected, "utf8");
  if (
    signatureBytes.length !== expectedBytes.length ||
    !timingSafeEqual(signatureBytes, expectedBytes)
  ) {
    throw createError({ statusCode: 401, statusMessage: "Invalid signature" });
  }

  const payload = JSON.parse(rawBody) as { type: string; data: unknown };
  // handle payload.type ...

  return { received: true };
});
```

يُعيّن Nitro هذا الملف تلقائيًا إلى `POST /api/webhooks/events`. يجب ضبط متغير البيئة `WEBHOOK_SECRET` على سر التوقيع الذي توفره الخدمة الخارجية.

## المسارات المستندة إلى الملفات {#file-based-routes}

يصبح مسار الدليل مسار URL، ويحدد لاحق اسم الملف طريقة HTTP. يُعيَّن ملف عند `server/routes/api/items/[id].get.ts` إلى `GET /api/items/:id` — يأتي `items/` من الدليل، ويصبح `[id]` معلمة `:id`، ويحدد `.get` الطريقة.

```text
server/routes/
  api/
    items/
      index.get.ts         -> GET    /api/items
      index.post.ts        -> POST   /api/items
      [id].get.ts          -> GET    /api/items/:id
      [id].patch.ts        -> PATCH  /api/items/:id
      [id].delete.ts       -> DELETE /api/items/:id
    webhooks/
      stripe.post.ts       -> POST   /api/webhooks/stripe
  [...page].get.ts         -> SSR catch-all for public pages
  index.get.ts             -> SSR for the app root (re-exports the catch-all)
```

يُعد `defineEventHandler` بدائية H3 لكتابة مسار. فهو يلف دالة المعالج الخاصة بك ويمنحها وصولاً إلى كائن `event`، الذي يحمل الطلب، والاستجابة، ومعلمات الموجّه، وسلسلة الاستعلام، والترويسات، والجسم. يؤدي إرجاع قيمة من المعالج إلى إرسالها كاستجابة — يصبح الكائن العادي JSON تلقائيًا. ويؤدي رمي `createError` إلى إرسال حالة خطأ HTTP المناسبة.

تُقرأ معلمات الموجّه مثل `[id]` من `event` باستخدام `getRouterParam`:

```ts filename="server/routes/api/items/[id].get.ts"
import { defineEventHandler, getRouterParam, createError } from "h3";

export default defineEventHandler((event) => {
  const id = getRouterParam(event, "id");
  if (!id) throw createError({ statusCode: 400, statusMessage: "Missing id" });
  // fetch and return the item by id
});
```

### اصطلاحات التسمية {#naming-conventions}

| مسار الملف (نسبةً إلى `server/routes/`) | طريقة HTTP | مسار URL         |
| --------------------------------------- | ---------- | ---------------- |
| `api/items/index.get.ts`                | GET        | `/api/items`     |
| `api/items/index.post.ts`               | POST       | `/api/items`     |
| `api/items/[id].get.ts`                 | GET        | `/api/items/:id` |
| `api/items/[id].patch.ts`               | PATCH      | `/api/items/:id` |
| `api/items/[id].delete.ts`              | DELETE     | `/api/items/:id` |
| `api/items/[...slug].get.ts`            | GET        | `/api/items/*`   |

## سياق الطلب والوصول {#request-context}

تعمل Actions المثبَّتة بواسطة إطار العمل تلقائيًا مع سياق الطلب. أما المسارات المخصصة فلا. إذا كان مسار مخصص يقرأ موارد قابلة للامتلاك (ownable) أو يكتب إليها، فحمّل الجلسة والفّ العمل:

<AnnotatedCode
  id="doc-block-server-routes-ctx"
  title="تحديد نطاق مسار مخصص لمستخدم الطلب"
  filename="server/routes/api/projects.get.ts"
  language="ts"
  code={
    'import { defineEventHandler, createError } from "h3";\nimport { getSession, runWithRequestContext } from "@agent-native/core/server";\nimport { getDb } from "../../db/index.js";\nimport { accessFilter } from "@agent-native/core/sharing";\nimport * as schema from "../../db/schema";\n\nexport default defineEventHandler(async (event) => {\n  const session = await getSession(event);\n  if (!session?.email) {\n    throw createError({ statusCode: 401, statusMessage: "Unauthorized" });\n  }\n\n  return runWithRequestContext(\n    { userEmail: session.email, orgId: session.orgId },\n    async () => {\n      const db = getDb();\n      return db\n        .select()\n        .from(schema.projects)\n        .where(accessFilter(schema.projects, schema.projectShares));\n    },\n  );\n});'
  }
  annotations={[
    {
      lines: "8-11",
      label: "المسارات المخصصة لا تملك سياقًا تلقائيًا",
      note: "على عكس actions، يجب أن يحمّل مسار الملف الجلسة بنفسه، وأن يفشل بأمان (fail closed) عند عدم وجود مستخدم مصادَق عليه.",
    },
    {
      lines: "13",
      label: "إنشاء سياق الطلب",
      note: "يجعل `runWithRequestContext` المستخدم/المؤسسة متاحين لمساعدات تحديد النطاق طوال مدة العملية.",
    },
    {
      lines: "17-20",
      label: "تحديد نطاق القراءات القابلة للامتلاك",
      note: "يقيّد `accessFilter` الاستعلام بالصفوف التي يجوز للمستدعي رؤيتها. لا تُشغّل أبدًا `db.select().from(ownableTable)` غير محدد النطاق هنا.",
    },
  ]}
/>

يُنشأ `getDb` لكل تطبيق عبر `createGetDb(schema)` في `server/db/index.ts`، لذا تستورده المسارات المخصصة من مسار القالب (`../../db/index.js`)، وليس من `@agent-native/core/db`. راجع [قاعدة البيانات](/docs/server-database#db-client).

<Callout tone="warning">
  لا تُشغّل `db.select().from(ownableTable)` غير محدد النطاق في المسارات
  المخصصة. أنشئ دائمًا سياق الطلب باستخدام `runWithRequestContext` قبل الاستعلام
  عن بيانات قابلة للامتلاك.
</Callout>

## مسار SSR الشامل {#ssr-catch-all}

يتعامل مسار `[...page].get.ts` عند جذر `server/routes/` مع العرض من جانب الخادم (server-side rendering) للصفحات العامة. وهو يستخدم `createH3SSRHandler` لتسليم المهمة إلى إصدار البناء الخاص بـ React Router:

```ts filename="server/routes/[...page].get.ts"
import { createH3SSRHandler } from "@agent-native/core/server/ssr-handler";

export default createH3SSRHandler(
  () => import("virtual:react-router/server-build"),
);
```

لا يطابق المسار الشامل (catch-all) جذر التطبيق أبدًا، لذلك يعيد `server/routes/index.get.ts` تصديره. احتفظ بالملفين معًا؛ فبدون إعادة التصدير هذه، يُرجع التطبيق المثبَّت في مساحة عمل الخطأ 404 عند `/<app-id>`:

```ts filename="server/routes/index.get.ts"
export { default } from "./[...page].get";
```

كل استجابة SSR هي قالب (shell) عام وغير شخصي يُخزَّن مؤقتًا في CDN. لا تقرأ أبدًا ملفات تعريف الارتباط، أو حالة الجلسة، أو فروع المصادقة في هذا المعالج. يحدث التخصيص من جانب العميل بعد الترطيب (hydration).

## ما هي الخطوة التالية {#whats-next}

- [**Actions**](/docs/actions-overview): السطح المفضّل لعمليات التطبيق؛ لا تلجأ إلى مسار إلا عندما لا يناسب
- [**الإضافات**](/docs/server-plugins): إضافات بدء التشغيل وسلوك تهيئتها
- [**البرمجيات الوسيطة**](/docs/server-middleware): حراس المصادقة التي تحمي جميع المسارات بما في ذلك `/api/*`
- [**الأمان**](/docs/security#access-guards): `accessFilter`/`assertAccess` والنموذج الكامل لتحديد نطاق البيانات
rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file).Stars: 198kUpdated Claude CodeCodexUnverifiedInstall
doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.Stars: 198kUpdated Claude CodeCodexVerifiedInstall