From 0e209b6bc3e7ac9920756ad17a7d8d38aa183f3d Mon Sep 17 00:00:00 2001
From: Leslie Barry <195984913+LeslieCBarry@users.noreply.github.com>
Date: Thu, 5 Nov 2026 19:53:54 +1100
Subject: [PATCH] docs(adrs): the workspace profile can't open the workspace's
 own website

---
 adrs/workspace-profile-site-link.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)
 create mode 100644 adrs/workspace-profile-site-link.md

diff --git a/adrs/workspace-profile-site-link.md b/adrs/workspace-profile-site-link.md
new file mode 100644
index 000000000..1cb137756
--- /dev/null
+++ b/adrs/workspace-profile-site-link.md
@@ -0,0 +1,22 @@
+# The workspace profile can't open the workspace's own website
+
+On a fresh install the workspace profile never gets written. Onboarding queues the
+`workspace-profile` task, the agent runs, and it stops without calling
+`write_workspace_profile`.
+
+The session is told to read our site with `web_fetch` (`apps/agent/agent/lib/preamble.ts`).
+That instruction is system-role (`instructions/task.ts`), and `webFetchAllowed` in
+`lib/web-policy.ts` only accepts links that appear in user messages. The user message for
+this task is the fixed text from `work("workspace-profile")` in `lib/dispatch.ts`, which has
+no link in it. So every fetch is refused with "That URL is not user-linked or approved
+documentation", the `web_search` tool refuses every call anyway, and the profile stays
+empty. The sign-in sweep tries again after seven days and hits the same wall.
+
+It matters because every other session opens with that profile. Without it the agent is
+told not to guess what we sell.
+
+I'd let `webFetchAllowed` accept the workspace's own website and the pages under it, using
+the same `websiteUrl()` the preamble already builds. That opens one site the operator typed
+in themselves, so I can't see what it breaks. Putting the full https link in the task's
+message would also work, but it only covers the home page, not the pricing or product page
+the preamble asks for. Happy to send the change if you'd like it.