[waleedlatif1]

Summary

• Add Hex live Search through its official MCP service and the existing member OAuth connection flow.
• Search project metadata and read draft notebook source with current access checks, bounded pagination, and revision validation. No code or queries are executed.
• Document plan, role, host, and content limits. Sync the Search provider contract with Mothership.

Companion: simstudioai/mothership#935

Type of Change

• New feature

Testing

• 110 focused Hex, managed MCP, account, policy, and provider tests passed.
• Root lint, type-check, all 62 audits, block-registry validation, and generated contract checks passed.
• Cleanup and independent reviews covered authorization, wire schemas, resource limits, docs, and tests.
• Verified real OAuth authorization, token refresh, and vendor tool discovery. Checked the adapter against the advertised tool schemas and official Hex documentation.
• Verified the failed-candidate regression fails before the fix; removing its error filter makes all four fatal-error controls fail.
• Full suites and application E2E run in CI.

Checklist

• Code follows project style guidelines
• Self-reviewed my changes
• Tests added/updated and passing (new tests pass the test-audit authoring gate)
• No new warnings introduced
• I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

[vercel]

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

Project	Deployment	Actions	Updated
docs	Ready	Preview	Nov 6, 2026 9:25pm UTC

[github-actions]

✅ Cross-repo companion check

All declared companion PRs are merged into staging.

• ✅ simstudioai/mothership#935 — merged into staging — feat(search): sync Hex provider contract

[cubic-dev-ai]

No issues found across 17 files

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

_{Turn on auto-fix | Re-trigger cubic}

[greptile-apps]

Confidence Score: 5/5

[Medium impact] The PR appears safe to merge; no new actionable issue was found.

Summary

Adds Hex project search and draft notebook reads through the member OAuth connection.

• Members can find Hex projects in their connected workspace.
• Reading a Hex result returns its available draft notebook source.

Diagram

%%{init: {'theme': 'neutral'}}%%
flowchart TD
  A[Connected Hex account] --> B[Check current workspace]
  B --> C[Search projects]
  C --> D[Verify project metadata]
  D --> E[Return search previews]
  E --> F[Read draft cells]
  F --> G[Check limits and project revision]
  G --> H[Return notebook source]

Loading

_{Reviews (3) · Last reviewed commit: "docs(search): keep Hex setup requirement..." · Reviewed by Greptile}

[waleedlatif1]

@greptile

[waleedlatif1]

@cubic-dev-ai review this PR

[cubic-dev-ai]

@cubic-dev-ai review this PR

@waleedlatif1 I have started the AI code review. It will take a few minutes to complete.

[cubic-dev-ai]

All reported issues were addressed across 17 files

<sub>Reply with feedback, questions, or to request a fix.

Turn on auto-fix | Re-trigger cubic</sub>

[waleedlatif1]

@greptile

[waleedlatif1]

@cubic-dev-ai review this PR

[cubic-dev-ai]

@cubic-dev-ai review this PR

@waleedlatif1 I have started the AI code review. It will take a few minutes to complete.

[cubic-dev-ai]

No issues found across 17 files

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

_{Turn on auto-fix | Re-trigger cubic}