[yardend-wix]

Summary

JSDoc-only change to AiGatewayModule. No runtime or type changes.

• Structured evaluations. feat(ai-gateway): add TypeSafe connection provider #288 added connection({ provider: "typesafe" }) with a single intro sentence, so the published page names the provider without saying what it does or how to call it. This PR replaces that sentence with a Structured evaluations section and an example that shows the answer shape, where to find confidence, and a threshold applied in code. The section covers:
  • the jev model, and that the gateway rejects "jev-latest", which the package README uses
  • experimental_evaluate, which needs ai 7.0.105 or later
  • the three question types and their answer shapes
• Authentication modes. The section from docs(ai-gateway): publish AI Gateway module reference #231 said there's no permission difference between modes. That's wrong for most new apps: they're created with Core integrations restricted, and public apps then reject user-token gateway calls with 403 (core_integration_policy.py in apper), while service-role calls from a backend function always pass. The original wording is kept; only that sentence and the service-role bullet change. Every example connects with base44.asServiceRole.aiGateway, matching the gateway's Builder capability guides; agent tools still run through base44.entities in the caller's scope.

Video isn't covered on purpose. The video API is open to all apps, but it isn't documented on the public site yet.

Docs

npm run create-docs renders the new Structured evaluations subsection and the example on interfaces/ai-gateway.mdx. The page on docs.base44.com updates on the next push-docs to mintlify-docs.

Checks

• Examples executed end to end as deployed backend functions on a production test app: service-role connection, user-scope 403, chat with a tool loop and streaming, Jev evaluate.

• eslint, npm run test:types, vitest run tests/unit/ai-gateway.test.ts

🤖 Generated with Claude Code

[github-actions]

🚀 Package Preview Available!

---

Install this PR's preview build with npm:

npm i @base44-preview/sdk@0.8.52-pr.297.e5cedd8

Prefer not to change any import paths? Install using npm alias so your code still imports @base44/sdk:

npm i "@base44/sdk@npm:@base44-preview/sdk@0.8.52-pr.297.e5cedd8"

Or add it to your package.json dependencies:

{
  "dependencies": {
    "@base44/sdk": "npm:@base44-preview/sdk@0.8.52-pr.297.e5cedd8"
  }
}

• 📦 Preview Package: @base44-preview/sdk@0.8.52-pr.297.e5cedd8
• 🔗 View this commit on GitHub

---

_{Preview published to npm registry — try new features instantly!}