paperclip/ui/storybook/stories
Aron Prins 897cc322c7
Improve external agent invite flow (#6183)
## Thinking Path

> - Paperclip orchestrates AI agents for zero-human companies.
> - Agent creation can happen through local runtimes, managed runtimes,
and external agents that onboard through invites.
> - The old OpenClaw-oriented invite UX lived under company
settings/invites and made a gateway-specific path look like a company
access setting.
> - That hid the broader bring-your-own-agent flow and forced operators
to leave the add-agent modal when adding an external agent.
> - This pull request moves external agent invite generation into the
add-agent modal and makes the copy agent-oriented instead of
OpenClaw-only.
> - The benefit is a clearer agent-first onboarding path while company
invites stay focused on human access.

## What Changed

- Added an external-agent invite branch to the add-agent modal,
including a dedicated prompt result view with Back navigation.
- Added a shared agent onboarding prompt builder and focused modal
coverage for prompt replacement/back navigation.
- Removed the agent invite prompt UI from Company Settings and Company
Invites, leaving Company Invites focused on human access links and
invite history.
- Updated the hidden OpenClaw Gateway runtime hint to direct operators
to the add-agent invite flow instead of presenting it as a blocked
runtime card.
- Updated invite/onboarding docs, storybook coverage, and server-side
onboarding copy toward generic agent language while preserving existing
gateway compatibility.

## Verification

- `pnpm -r typecheck`
- `pnpm build`
- `FAKE_BIN="$(mktemp -d)/bin"; mkdir -p "$FAKE_BIN"; printf
'#!/bin/sh\nexit 1\n' > "$FAKE_BIN/tailscale"; chmod +x
"$FAKE_BIN/tailscale"; PATH="$FAKE_BIN:$PATH" pnpm test:run`
- `pnpm test:run` without the fake `tailscale` shim was also attempted;
it failed only in two pre-existing CLI tailnet fallback tests because
this host has a real Tailscale address (`100.125.202.3`) where those
tests expect no Tailscale.
- Focused confirmation for that host-env issue: `FAKE_BIN=...
PATH="$FAKE_BIN:$PATH" pnpm exec vitest run --project paperclipai
cli/src/__tests__/network-bind.test.ts
cli/src/__tests__/onboard.test.ts`
- Manual UI verification: served UI locally in light mode, opened
add-agent modal, generated external agent prompt, verified the generated
prompt replaces the form and Back returns to the form.

### Screenshots

![Add agent
modal](https://raw.githubusercontent.com/aronprins/paperclip/pr-assets/6183-agent-invites/.github/pr-screenshots/6183/add-agent-modal-light.png)

![External agent invite
form](https://raw.githubusercontent.com/aronprins/paperclip/pr-assets/6183-agent-invites/.github/pr-screenshots/6183/external-agent-invite-form-light.png)

![Generated onboarding prompt replacement
view](https://raw.githubusercontent.com/aronprins/paperclip/pr-assets/6183-agent-invites/.github/pr-screenshots/6183/onboarding-prompt-result-light.png)

## Risks

- Existing OpenClaw gateway compatibility remains, but operators now
discover external agent onboarding from the add-agent modal instead of
company settings.
- Agent invites still appear in the invite history table, so that page
may show agent-scoped invite rows even though it no longer creates agent
onboarding prompts.
- Low migration risk: no schema changes.

> For core feature work, check [`ROADMAP.md`](ROADMAP.md) first and
discuss it in `#dev` before opening the PR. Feature PRs that overlap
with planned core work may need to be redirected — check the roadmap
first. See `CONTRIBUTING.md`.

## Model Used

- OpenAI Codex, GPT-5 coding agent in Codex desktop; tool-enabled
repository, shell, browser, and GitHub workflow. Context window size was
not exposed by the runtime.

## Checklist

- [x] I have included a thinking path that traces from project context
to this change
- [x] I have specified the model used (with version and capability
details)
- [x] I have checked ROADMAP.md and confirmed this PR does not duplicate
planned core work
- [x] I have run tests locally and they pass
- [x] I have added or updated tests where applicable
- [x] If this change affects the UI, I have included before/after
screenshots
- [x] I have updated relevant documentation to reflect my changes
- [x] I have considered and documented any risks above
- [x] I will address all Greptile and reviewer comments before
requesting merge
2026-05-23 09:09:40 -05:00
..
acpx-local.stories.tsx Improve ACPX adapter configuration (#5290) 2026-05-06 06:06:47 -05:00
agent-management.stories.tsx Add secrets provider vaults and remote import (#5429) 2026-05-09 18:22:17 -05:00
assigned-backlog-safeguards.stories.tsx Guard assigned backlog liveness (#5428) 2026-05-07 12:25:26 -05:00
blocked-inbox.stories.tsx [codex] Add blocked inbox attention view (#5603) 2026-05-13 16:41:36 -05:00
budget-finance.stories.tsx [codex] add comprehensive UI Storybook coverage (#4132) 2026-04-20 12:13:23 -05:00
chat-comments.stories.tsx Show workspace changes and stale notices in issue threads (#5356) 2026-05-06 09:00:54 -05:00
control-plane-surfaces.stories.tsx [codex] add comprehensive UI Storybook coverage (#4132) 2026-04-20 12:13:23 -05:00
data-viz-misc.stories.tsx [codex] Add runtime lifecycle recovery and live issue visibility (#4419) 2026-04-24 15:50:32 -05:00
dev-ops-surfaces.stories.tsx [codex] UI and dev ops quality-of-life (#6384) 2026-05-19 15:52:39 -05:00
dialogs-modals.stories.tsx Improve external agent invite flow (#6183) 2026-05-23 09:09:40 -05:00
forms-editors.stories.tsx Add secrets provider vaults and remote import (#5429) 2026-05-09 18:22:17 -05:00
foundations.stories.tsx [codex] add comprehensive UI Storybook coverage (#4132) 2026-04-20 12:13:23 -05:00
issue-management.stories.tsx Add cheap model profiles for local adapters (#4881) 2026-04-30 15:32:04 -05:00
issue-thread-interactions.stories.tsx [codex] Add structured issue-thread interactions (#4244) 2026-04-21 20:15:11 -05:00
monitor-surfaces.stories.tsx [codex] Add issue monitor liveness controls (#4988) 2026-05-03 08:58:53 -05:00
navigation-layout.stories.tsx Polish operator sidebar and issue property controls (#5355) 2026-05-06 08:59:39 -05:00
overview.stories.tsx [codex] add comprehensive UI Storybook coverage (#4132) 2026-04-20 12:13:23 -05:00
projects-goals-workspaces.stories.tsx Add cheap model profiles for local adapters (#4881) 2026-04-30 15:32:04 -05:00
routine-secrets.stories.tsx [codex] Add routine env secrets support (#6212) 2026-05-17 16:30:34 -05:00
scheduled-retry.stories.tsx Add issue controls and retry-now recovery (#5426) 2026-05-07 12:23:13 -05:00
search.stories.tsx Add full company search page (#5293) 2026-05-06 06:32:37 -05:00
secrets.stories.tsx [codex] Provider vault secrets UX (#6381) 2026-05-19 15:50:23 -05:00
source-issue-recovery.stories.tsx [codex] Add source-scoped recovery actions (#5599) 2026-05-12 09:37:15 -05:00
source-resolved-fold.stories.tsx [codex] Roll up May 17 branch changes (#6210) 2026-05-17 17:15:06 -05:00
status-language.stories.tsx [codex] Split PR #4692 UI/QoL updates (#4701) 2026-04-28 17:18:58 -05:00
sub-issues-workflow.stories.tsx Add cheap model profiles for local adapters (#4881) 2026-04-30 15:32:04 -05:00
successful-run-handoff.stories.tsx Add recovery handoff system notices (#5289) 2026-05-06 06:05:58 -05:00
ux-labs.stories.tsx Add recovery handoff system notices (#5289) 2026-05-06 06:05:58 -05:00