From f49a003bd94157f927602a7f8606b21aac7e239d Mon Sep 17 00:00:00 2001
From: Dotta <bippadotta@protonmail.com>
Date: Fri, 6 Mar 2026 14:16:39 -0600
Subject: [PATCH] fix: improve invite onboarding text and callback reachability
 prompt

Add skill URL note to onboarding text document and strengthen callback
reachability test language in company settings invite snippet.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 server/src/routes/access.ts      | 8 +++++++-
 ui/src/pages/CompanySettings.tsx | 2 +-
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/server/src/routes/access.ts b/server/src/routes/access.ts
index 3fba5208..58cde03f 100644
--- a/server/src/routes/access.ts
+++ b/server/src/routes/access.ts
@@ -1171,6 +1171,8 @@ export function buildInviteOnboardingTextDocument(
     GET ${onboarding.skill.url}
     Install path: ${onboarding.skill.installPath}
 
+    Be sure to prepend your PAPERCLIP_API_URL to the top of your skill and note the path to your PAPERCLIP_API_URL
+
     ## Text onboarding URL
     ${onboarding.textInstructions.url}
 
@@ -2288,7 +2290,11 @@ export function accessRoutes(
 
         const agentName = deduplicateAgentName(
           existing.agentName ?? "New Agent",
-          existingAgents.map((a) => ({ id: a.id, name: a.name, status: a.status })),
+          existingAgents.map((a) => ({
+            id: a.id,
+            name: a.name,
+            status: a.status
+          }))
         );
 
         const created = await agents.create(companyId, {
diff --git a/ui/src/pages/CompanySettings.tsx b/ui/src/pages/CompanySettings.tsx
index de3e2798..0b9cd255 100644
--- a/ui/src/pages/CompanySettings.tsx
+++ b/ui/src/pages/CompanySettings.tsx
@@ -461,7 +461,7 @@ Suggested command:
 Then verify with: curl -fsS <base-url>/api/health`;
 
   const resolutionLine = resolutionTestUrl
-    ? `\nIf you need to test callback reachability, call: http://<whatever hostname worked above>?url=<urlencoded-webhook-url>`
+    ? `\nYou MUST test callback reachability, call: ${resolutionTestUrl}?url=<urlencoded-webhook-url> (well using the hostname that worked above). Do not assume your 172.x is necessarily reachable from Paperclip. Test it. `
     : "";
 
   return `You're invited to join a Paperclip organization.