Skip to content

docs(openrouter-typescript-sdk): sync with openrouter-web changes - #101

Open
devin-ai-integration[bot] wants to merge 1 commit into
mainfrom
devin/1785258312-update-openrouter-typescript-sdk
Open

docs(openrouter-typescript-sdk): sync with openrouter-web changes#101
devin-ai-integration[bot] wants to merge 1 commit into
mainfrom
devin/1785258312-update-openrouter-typescript-sdk

Conversation

@devin-ai-integration

Copy link
Copy Markdown
Contributor

Summary

Three docs-from-code PRs landed in openrouter-web documenting new @openrouter/agent 0.8.0 public surface that the skill didn't cover:

  • #30989strictFinalResponse?: boolean on callModel. Default is now tolerant: after at least one completed tool round, an empty final output is retried once and then resolves with empty text instead of throwing. strictFinalResponse: true restores the pre-0.8.0 throw.
  • #30990 — new @openrouter/mcp package: createMCPTools({ url, auth }){ tools, close() }, spreadable into callModel({ tools }) alongside local tool() definitions.
  • #30992 — conversation-state and tool-result contract: status: 'awaiting_client_tools' for unresolved manual tools, optional version field with serializeConversationState() / deserializeConversationState() (InvalidStateError, UnsupportedStateVersionError), and source: 'client' | 'mcp' on ToolExecutionResult / streaming tool.result.

The last one also makes existing skill content wrong: ToolExecutionResult.result is no longer unconditionally "validated against outputSchema" — that only holds for source === 'client'; MCP results are unknown. Corrected that line and added the install line, a "Final response behavior" subsection, manual-tool/state notes, and a "Remote MCP Tools" section. README's user-facing summary was still accurate.

Link to Devin session: https://openrouter.devinenterprise.com/sessions/d563e5e98e9a4de79adbfc5f46009bd2

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@devin-ai-integration

Copy link
Copy Markdown
Contributor Author
Original prompt from Automation

You are the public skills sync pipeline. Your job is to scan PRs merged to main on OpenRouterTeam/openrouter-web in the last 24 hours, determine if any changes warrant updating the public agent skills in OpenRouterTeam/skills, and open PRs to the skills repo when updates are needed.

#``# Step 1: Identify relevant merged PRs

Clone both repos:

cd /home/ubuntu/repos/openrouter-web
git fetch origin main
git log --since='24 hours ago' --merges --first-parent origin/main --pretty=format:'%H|%s' --name-only

For each merged PR, collect the list of changed files. Only PRs that touch the paths in the mapping below are relevant. Skip bot commits (devin-ai-integration[bot], Devin AI, GitHub Actions Bot, openrouter[bot], opencode-agent[bot], OpenRouter SDK Bot, Claude, detail-app[bot], forge-the-devex-intern[bot], dependabot[bot]).

If no relevant PRs were merged, post a short message to the #devrel Slack channel (C08LQFVSC7Q) saying no skill-relevant changes were detected today, and exit.

#``# Step 2: Map changed files to affected skills

Use this mapping to determine which public skills are potentially affected:

openrouter-web paths Affected skill(s) in OpenRouterTeam/skills
sdks/typescript/, packages/llm-interfaces/ openrouter-typescript-sdk, openrouter-agent-migration
services/cfw-*/src/routes/*analytics*, analytics query/response schemas openrouter-analytics, openrouter-analytics-query, openrouter-analytics-schema
Generation routes, /api/v1/generation openrouter-generations
Image generation adapters, packages/image-generation/ openrouter-images
supabase/seeds/, model schemas, /api/v1/models route openrouter-models
OAuth/auth routes, PKCE flow code openrouter-oauth
STT adapters, services/cfw-stt-api/, /api/v1/audio/transcriptions openrouter-stt
TTS routes, /api/v1/audio/speech openrouter-tts
Video adapters, /api/v1/videos openrouter-video
``@`openr... (3383 chars truncated...)

@devin-ai-integration

Copy link
Copy Markdown
Contributor Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR that start with 'DevinAI' or '@devin'.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment, CI, and merge conflict monitoring

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.

0 participants