Skip to content

docs(ai): connect-mcp — api actions have no headless dispatch either - #3128

Merged
os-zhuang merged 1 commit into
mainfrom
docs/api-type-fix
Jul 17, 2026
Merged

os-zhuang merged 1 commit into
mainfrom
docs/api-type-fix

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

自查发现 #3093 新增的 ai/connect-mcp.mdx 有一处不完整:暴露规则与排错表把"永远不出现在 list_actions"的类型列为 url/modal/form,漏了 api。

源码 packages/runtime/src/http-dispatcher.ts:895-901 isHeadlessInvokableAction 只放行两种:script(需 target 或 body)与 flow(需 target + automation 服务),其余一律 false——注释也明写 "UI-only types (url, modal, form) and api have no server dispatch here"。

(api 的 HTTP 派发只存在于 ObjectOS 的 bridge,actions-as-tools.mdx:110 已正确标注为 "ObjectOS runtime only",无需改。)

现改为正面表述:开源框架里恰好两种类型可 headless 调用,并列全不可调用的四种。

🤖 Generated with Claude Code

@vercel

vercel Bot commented Jul 17, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
spec Ready Ready Preview, Comment Jul 17, 2026 1:18pm

Request Review

@github-actions github-actions Bot added documentation Improvements or additions to documentation size/xs labels Jul 17, 2026
The exposure rules and the troubleshooting table listed `url` / `modal` /
`form` as the types that never reach `list_actions`, omitting `api`.
isHeadlessInvokableAction only admits `script` (with target or body) and
`flow` (with an automation service) — everything else, `api` included,
returns false in the open framework. (`api` dispatch exists only in the
ObjectOS runtime bridge, which actions-as-tools.mdx already scopes
correctly.)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

This branch had an error being deployed

1 failed deployment
Preview — 196e029f Deployed Jul 17, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size/xs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant