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

docs(ai): connect-mcp — api actions have no headless dispatch either#3128
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(需 targetbody)与 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>
@os-zhuang
os-zhuang merged commit 14dbf9c into main Jul 17, 2026
14 of 15 checks passed
@os-zhuang
os-zhuang deleted the docs/api-type-fix branch July 17, 2026 12:42
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