docs: reframe AI + SSO for the open-source site; remove cloud-only intro pages#2649
Merged
Conversation
…tro pages
This is the open-source (community) documentation site. Two changes:
1. Remove genuinely cloud-only introduction pages (verified absent from the open
framework's packages/):
- ai/chatbot-integration.mdx — in-product chat / HITL wiring on
@objectstack/service-ai (cloud, ADR-0025).
- deployment/cloud-artifact-api.mdx — the Cloud control-plane artifact HTTP
contract.
Nav (meta.json) and the two inbound cross-links (ai/index,
deployment/publish-and-preview) are updated so nothing dangles.
2. Reframe docs that positioned an open capability as cloud/Enterprise-only. The
open framework ships the whole AI stack except the in-product chat runtime:
- AI: agents/tools/skills are typed metadata (defineAgent/defineTool/defineSkill,
@objectstack/spec/ai); data query and action invocation run through
@objectstack/mcp (BYO-AI, RLS-governed); the Knowledge/RAG stack
(service-knowledge + knowledge-memory / knowledge-ragflow + embedder-openai)
is open. Only the in-product ask/build chat runtime (@objectstack/service-ai,
/api/v1/ai/*) is cloud/Enterprise — now clearly labeled, not the default
narrative. Touches ai/index, agents, actions-as-tools, knowledge-rag,
natural-language-queries. Also corrects the actions "explicit opt-in" framing:
the open MCP path filters by permission, not the cloud-only ai.exposed gate.
- Auth: OIDC + SAML SSO ship in the open @objectstack/plugin-auth via
@better-auth/sso (Setup → SSO Providers, no code); sso.mdx no longer implies
they require an enterprise package.
Every open/cloud claim is backed by packages/ (or its absence): @objectstack/mcp,
service-knowledge, knowledge-*, embedder-openai, and plugin-auth SSO/SCIM are
present; @objectstack/service-ai is not. Also fixed a fabricated MCP wiring API in
the reframed examples (MCPServerPlugin.configure(...) → the real
`new MCPServerPlugin({ transport, autoStart })`).
Note for maintainers: packages/spec/src/ai/skill.zod.ts:80 calls the `ask` surface
"the open-source/free surface", which contradicts cloud ADR-0025 (ask/build
in-product runtime = cloud-only). These docs follow ADR-0025; the spec comment
likely needs reconciling.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LHQscZJ8NvXceSmsPNdTZd
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
os-zhuang
added
documentation
Claude
os-zhuang
marked this pull request as ready for review
July 5, 2026 16:56
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
背景
当前是开源(社区版)文档站点。本 PR 按两条原则清理 cloud/Enterprise 相关内容:①删除真正 cloud-only 的介绍文档;②纠正"宣称企业版专属、实为社区版已有"的说法。每条判断都对照本仓库
packages/的实际代码(或其不存在)验证。1. 删除纯 cloud 介绍文档
在
packages/中核实这些能力确不在开源版:ai/chatbot-integration.mdx—— in-product chat / HITL,依赖@objectstack/service-ai(cloud,ADR-0025)。deployment/cloud-artifact-api.mdx—— Cloud 控制面 artifact HTTP 契约。同步更新导航(
meta.json)与两处入站交叉链接(ai/index、deployment/publish-and-preview),无死链残留。2. 外科式重构:开源能力不再被框成企业版专属
开源框架除 in-product 聊天运行时外已具备整套 AI 能力:
defineAgent/defineTool/defineSkill,@objectstack/spec/ai);数据查询与 action 调用经@objectstack/mcp(BYO-AI,受 RLS 约束);知识/RAG 栈(service-knowledge+knowledge-memory/knowledge-ragflow+embedder-openai)全开源。仅 in-product 的ask/build聊天运行时(@objectstack/service-ai、/api/v1/ai/*)属 cloud/Enterprise —— 现已明确标注,不再充当默认叙事。涉及ai/index、agents、actions-as-tools、knowledge-rag、natural-language-queries。同时纠正 actions 的 "explicit opt-in" 措辞:开源 MCP 路径按权限过滤,而非 cloud-only 的ai.exposed开关。@objectstack/plugin-auth(经@better-auth/sso,Setup → SSO Providers,无需代码);sso.mdx不再暗示需要企业版包。验证
每条开源/cloud 判断都以
packages/佐证(或以其缺失佐证):@objectstack/mcp、service-knowledge、knowledge-*、embedder-openai、plugin-auth的 SSO/SCIM 均存在;@objectstack/service-ai不存在。重构示例中还修正了一个虚构的 MCP 装配 API(MCPServerPlugin.configure(...)→ 真实的new MCPServerPlugin({ transport, autoStart }))。所有改动文件已通过 frontmatter / 代码围栏 / JSX 组件配平校验,内部链接全部有效。给维护者的提示(源头不一致)
packages/spec/src/ai/skill.zod.ts:80把asksurface 注释为 "the open-source/free surface",这与 cloud ADR-0025(ask/build的 in-product 运行时 = cloud-only)相矛盾。本 PR 文档遵循 ADR-0025 口径;该 spec 注释疑似需要统一,建议单独跟进。🤖 Generated with Claude Code
https://claude.ai/code/session_01LHQscZJ8NvXceSmsPNdTZd
Generated by Claude Code