Skip to content

docs(oracles): document Workers workspaces and Topic research acceptance - #51

Open
ig-shaun wants to merge 4 commits into
mainfrom
qi/shared-workspace-workers-docs
Open

ig-shaun wants to merge 4 commits into
mainfrom
qi/shared-workspace-workers-docs

Conversation

@ig-shaun

@ig-shaun ig-shaun commented Oct 6, 2026 •

Copy link
Copy Markdown
Contributor

Why

Oracle developers need one canonical reference for the proposed Workers research and Portal workspace APIs, with clear activation and acceptance requirements.

What changed

Add a Workers reference and a two-person Topic research acceptance guide. Document signed owner routes, frozen inputs, exact VFS versions, skill/credential activation, recovery, current authorization and independent review.
Add navigation and short pointers from the existing Node endpoint, tasks and sandbox references. Preserve the separate public/internal documentation surfaces.

Scope

Seven documentation and navigation files. API anchors identify the pushed integrated histories from Workers PR 340 and PR 341.
The Portal integration is in PR 1880, with its protocol pin in PR 1879.

Blast Radius

Research is inactive by default and requires an operator canonical Topic resolver plus trusted pinned skills. The persistent principal sandbox is not execution/network isolation.
Composio execution restrictions, accepted private-delivery retries and broader open Node/recurring/wake/provider scope are explicit. No package publication, deployment or live-service readiness is claimed.

Verification

Docs QA and style passed. Touched ESLint, existing markdownlint rules, terminology, 11 internal links, navigation/JSON and diff checks passed.
Final source-anchor substitution was verified against origin refs. Existing whole-site broken links remain in five unrelated files; no new touched-link failure.
Release still requires real workerd, UCAN, Matrix, registry, sandbox and VFS acceptance with two separately authorized identities.


View with [code]smith Autofix with [code]smith
Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 6, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-06T18:06:23.664152Z 9aa94e7 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

This branch has not been deployed

No deployments
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.

1 participant