Skip to content

Merge OpenAI Agents tutorial rewrite#743

Merged
nearestnabors merged 23 commits intomainfrom
merge-openai-agents-tutorial
Feb 10, 2026
Merged

Merge OpenAI Agents tutorial rewrite#743
nearestnabors merged 23 commits intomainfrom
merge-openai-agents-tutorial

Conversation

@nearestnabors
Copy link
Contributor

Summary

  • Merges the OpenAI Agents tutorial rewrite with resolved conflicts
  • Restructures tutorials into overview, setup-python, and setup-typescript pages
  • Removes old tutorial pages (use-arcade-tools, use-arcade-with-openai-agents, user-auth-interrupts)

🤖 Generated with Claude Code

nearestnabors and others added 21 commits February 4, 2026 12:41
- Replace overview page with simple landing page linking to language-specific tutorials
- Create separate setup-python tutorial using agents-arcade package
- Create separate setup-typescript tutorial explaining factory pattern vs functools.partial
- Delete redundant pages (use-arcade-tools, user-auth-interrupts, use-arcade-with-openai-agents)
- Add redirects for deleted pages to overview
- Update landing page link to new overview

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
…/page.mdx

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
…ript/page.mdx

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
…ements

- Fix import path from @arcadeai/arcadejs/lib to @arcadeai/arcadejs/lib/index
- Add interactive chat loop with multi-turn conversation history
- Add readline for terminal input
- Update welcome message with helpful prompts
- Fix .env example (remove curly braces from placeholder)
- Add tabs for npx/bun run commands
- Add key takeaway about result.history for conversation context

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
…ript/page.mdx

Co-authored-by: Mateo Torres <mateo@arcade.dev>
…ript/page.mdx

Co-authored-by: Mateo Torres <mateo@arcade.dev>
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Change tab label from "npx" to "npm" for consistency
- Add note explaining that npx is included with npm

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* Add content negotiation for markdown responses

- Serve markdown directly when Accept: text/markdown header is present
- Auto-detect known AI/LLM agents by User-Agent and serve markdown
- Update Content-Type from text/plain to text/markdown
- Refactor middleware for lower cognitive complexity

Supported agents include Claude, ChatGPT, Cursor, Copilot, Gemini,
Perplexity, LangChain, LlamaIndex, and many more.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Add Vary: Accept header to prevent edge cache poisoning

When using content negotiation to serve markdown vs HTML based on the
Accept header, edge caches (like Vercel's) need to know that responses
vary by this header. Without the Vary header, the cache could serve a
cached markdown response to a browser expecting HTML, or vice versa.

This adds Vary: Accept to both response paths in the markdown API route
to ensure caches store separate versions for different Accept header values.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Fix content negotiation edge cases in middleware

Two fixes based on PR feedback:

1. Limit content negotiation to GET and HEAD requests only. This avoids
   potential issues with POST/PUT requests that may be implemented in
   the future.

2. Normalize trailing slashes before building the markdown path. Without
   this, /en/home/ would produce /en/home/.md which would 404.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Make Accept header check case-insensitive

HTTP header values should be compared case-insensitively. This fixes
requests with Accept: Text/Markdown or TEXT/MARKDOWN being ignored.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

---------

Co-authored-by: Rachel Lee Nabors <nearestnabors@users.noreply.github.com>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
* isolating changes

* isolating changes

* isolating changes

* isolating changes

* isolating changes

* 🤖 Regenerate LLMs.txt

* fixing url slug issues

* some changes in slugs once again

* minor changes

* more review changeds

* minor change pointed by cursor bot

* removong ui tests

* some cleaning and fixing

* .

* fixing typo

* merge

* fixing broken link

* Regenerate clean markdown files

* chore: retrigger deploy

Co-authored-by: Cursor <cursoragent@cursor.com>

* updating script to ignore markdowns from toolkits as they are built at buid time in vercel

* changes after sugestion from sergion el chico guapo

* gpt 5.3 codex review

* merge changes

* minor change

* ,

* Merge main and resolve conflicts

* Save local route changes before merging main

* Merge origin/main and resolve conflicts in route and middleware

* Fix sortChunksDeterministically complexity warning and stage route changes

Extract compareByHeader helper to reduce cognitive complexity from 17 to
below the max threshold of 15.

Co-authored-by: Cursor <cursoragent@cursor.com>

* Format markdown route (auto-format)

Co-authored-by: Cursor <cursoragent@cursor.com>

* Fix route.ts formatting (join on single line)

Co-authored-by: Cursor <cursoragent@cursor.com>

* Regenerate clean markdown files

* Fix Bugbot findings: dead scope filter and missing metadata guard

- Remove permanently empty selectedScopes array and unused parameter
  from filterTools, eliminating unreachable scope-filtering dead code
- Strengthen isValidToolkitData type guard to verify metadata object
  exists, preventing TypeError on malformed toolkit JSON
- Add defensive optional chaining for data.metadata access in
  ToolkitPage to match the stricter guard

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
@vercel
Copy link

vercel bot commented Feb 10, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Feb 10, 2026 5:14pm

Request Review

@nearestnabors nearestnabors enabled auto-merge (squash) February 10, 2026 17:10
@nearestnabors nearestnabors merged commit a243eeb into main Feb 10, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants