feat(clients): Agent Studio initial version

[Fluf22]

🧭 What and Why

Add the Agent Studio API client — a new Algolia service for building generative AI experiences with Retrieval Augmented Generation (RAG). This PR introduces the full OpenAPI specification, registers the client across all 11 languages, and adds CTS coverage and playgrounds.

Note: Generator fixes, template fixes, test helpers, and client code fixes have been extracted into stacked PRs:

• feat(clients): Agent Studio v1 #6097 — Generator fixes (OneOf, ParametersWithDataType, PHP cleanup)
• fix(templates): handle null parameters and nullable fields in test generation #6098 — Template null-handling (Go, Kotlin, Scala, Swift)
• feat(cts): lenient JSON assertion helpers for e2e tests #6099 — E2E test helpers (C#, Java, Kotlin lenient JSON assertion)
• fix(clients): deserialization and HTTP header handling #6100 — Client fixes (Python deserialization, Scala header handling)

---

Changes included

1. OpenAPI Specification (specs/agent-studio/)

New agent-studio API spec from scratch:

• spec.yml — Main OpenAPI 3.0.2 definition. Server: https://agent-studio.{region}.algolia.com (EU/US). Custom timeouts (30s read/write/connect). Tags: Agents, Completions, Configurations, Conversations, Providers, User Data.
• 15 path files defining endpoints:
  • Agents: CRUD (/1/agents, /1/agents/{agentId}), publish/unpublish, cache invalidation
  • Completions: POST /1/agents/{agentId}/completions with AI SDK v4/v5 compatibility modes, streaming, caching, memory options
  • Conversations: list, get, delete, export (/1/agents/{agentId}/conversations/...)
  • Providers: CRUD (/1/providers), list models per provider
  • Configuration: get/patch application config (/1/configuration)
  • User Data: get/delete by user token (/1/user-data/{userToken})
• 143 schema files — Models for agents, providers, conversations, messages (v4/v5 formats), tool configs (Algolia Search, Algolia Recommend, MCP Server, Client-side, Unknown), search parameters, memory, episodes, pagination, validation errors, etc.
• common/parameters.yml — Shared path/query parameters (agentId, conversationId, providerId, userToken, page, hitsPerPage, stream)

2. Config & Infra

• config/clients.config.json — Added agent-studio to all 11 language client lists. JS gets a standalone client entry outputting to packages/agent-studio.
• config/clients.schema.json — Added agent-studio to allowed client enums.
• redocly.yaml — Added agent-studio API reference.
• renovate.json — Added **/client-agent-studio/** to ignore paths.
• specs/major-breaking-changes-rename.json — Added empty agent-studio entry.
• Bug report templates — Added "Agent Studio" to client dropdown.

3. JavaScript Packaging

• Added @algolia/agent-studio to lerna build scope and yarn workspaces.
• Pass region to standalone client constructors in e2e test template.

4. CTS (Common Test Suite)

• Client tests: timeout verification, region routing (EU/US/invalid).
• Request tests for all 20 operations: createAgent, createAgentCompletion, createProvider, deleteAgent, deleteAgentConversations, deleteConversation, deleteProvider, deleteUserData, exportConversations, getAgent, getApplicationConfiguration, getConversation, getProvider, getUserData, invalidateAgentCache, listAgentConversations, listAgents, listModels, listProviderModels, listProviders, publishAgent, unpublishAgent, updateAgent, updateConfiguration, updateProvider.
• Includes e2e test cases with response assertions for: getAgent, getProvider, getApplicationConfiguration, listAgents, listProviders, listModels, listAgentConversations.

5. Playgrounds (all languages)

New AgentStudio playground files for C#, Go, Java, JavaScript/Node, Kotlin, PHP, Python, Ruby, Scala, Swift. Each initializes the client with appId, apiKey, region "us", and calls listAgents().

[algolia-bot]

✔️ Code generated!

Name	Link
🪓 Triggered by	f6da183e65914f139bae8c543d6a0585408e60d4
🍃 Generated commit	4e3299732ff4f7398429ebab7b4ee792e56ef320
🌲 Generated branch	generated/feat/agent-studio-client

📊 Benchmark results

Benchmarks performed on the method using a mock server, the results might not reflect the real-world performance.

Language	Req/s
javascript	2317
go	2185
php	1809
csharp	1458
python	1314
java	1117
ruby	924
swift	795
scala	23

[PLNech]

[codacy-production]

Not up to standards ⛔

🔴 Issues 3 critical · 27 high · 10 medium

Alerts:

⚠ 30 issues (≤ 0 issues of at least high severity)

Results:
40 new issues

Category	Results
Security	27 high 3 critical 10 medium

View in Codacy

🟢 Metrics 4 complexity

Metric	Results
Complexity	4

View in Codacy

_{TIP This summary will be updated as you push new changes.}