From 57823d892062417613e7ff36c1482613e74b66d5 Mon Sep 17 00:00:00 2001
From: os-zhuang <jack@objectstack.ai>
Date: Sat, 27 Jun 2026 04:12:56 +0800
Subject: [PATCH] =?UTF-8?q?feat(console):=20"Edit=20with=20AI"=20=E2=80=94?=
 =?UTF-8?q?=20open=20the=20build=20agent=20pre-scoped=20to=20an=20app's=20?=
 =?UTF-8?q?package?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

ADR-0070 follow-up (UI half). Adds an "Edit with AI" action to each app in App
Management that opens the build agent in a fresh conversation pre-scoped to that
app's package: it navigates to `/ai/build?package=<packageId>&new=1`, and the AI
chat page forwards the package as `context.packageId`. The cloud agent seeds it
as the conversation's active package, so the AI's metadata reads scope to THIS
app and edits bind to it from the first message (no reliance on the model calling
set_active_package). Shown only for apps that have a package id.

- AppManagementPage: a Sparkles "Edit with AI" button beside "Edit app".
- AiChatPage: read `?package=` and forward it as `context.packageId` (threaded
  into ChatPane, the component that builds the chat request context).

Pairs with the cloud seeding mechanism (objectstack-ai/cloud#590). Type-check
clean (app-shell + console); app-shell 927 + console 4656 tests pass, 0 regressions.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 .../src/pages/system/AppManagementPage.tsx     | 18 ++++++++++++++++++
 .../app-shell/src/console/ai/AiChatPage.tsx    | 13 +++++++++++++
 2 files changed, 31 insertions(+)

diff --git a/apps/console/src/pages/system/AppManagementPage.tsx b/apps/console/src/pages/system/AppManagementPage.tsx
index bef5868b3..92205e8f9 100644
--- a/apps/console/src/pages/system/AppManagementPage.tsx
+++ b/apps/console/src/pages/system/AppManagementPage.tsx
@@ -25,6 +25,7 @@ import {
   Star,
   ExternalLink,
   Search,
+  Sparkles,
 } from 'lucide-react';
 import { toast } from 'sonner';
 import { useMetadata } from '@object-ui/app-shell';
@@ -241,6 +242,23 @@ export function AppManagementPage() {
                     >
                       <Pencil className="h-4 w-4" />
                     </Button>
+                    {app._packageId ? (
+                      <Button
+                        variant="ghost"
+                        size="icon"
+                        title="Edit with AI"
+                        aria-label={`Edit ${app.label || app.name} with AI`}
+                        // ADR-0070 — open the build agent in a fresh conversation
+                        // pre-scoped to this app's package (passed as the chat
+                        // context.packageId the cloud seeds as the active package),
+                        // so the AI iterates within THIS app, not the whole env.
+                        onClick={() =>
+                          navigate(`/ai/build?package=${encodeURIComponent(app._packageId!)}&new=1`)
+                        }
+                      >
+                        <Sparkles className="h-4 w-4" />
+                      </Button>
+                    ) : null}
                     <Button
                       variant="ghost"
                       size="icon"
diff --git a/packages/app-shell/src/console/ai/AiChatPage.tsx b/packages/app-shell/src/console/ai/AiChatPage.tsx
index 0885dbacb..2f6a02288 100644
--- a/packages/app-shell/src/console/ai/AiChatPage.tsx
+++ b/packages/app-shell/src/console/ai/AiChatPage.tsx
@@ -486,6 +486,11 @@ export function AiChatPage({ apiBase: apiBaseProp, defaultAgent: defaultAgentPro
   // existing conversation, and the flag is stripped once the fresh id is
   // mirrored into the URL.
   const forceNewConversation = searchParams.get('new') !== null;
+  // ADR-0070 "Edit with AI": the package the user opened to edit (from the app
+  // list's per-app action). Forwarded to the build agent as `context.packageId`
+  // so its metadata reads scope to that app and edits bind to it from the first
+  // message (the agent seeds it as the conversation's active package).
+  const editPackageId = searchParams.get('package')?.trim() || undefined;
   const navigate = useNavigate();
   const { setContext } = useNavigationContext();
 
@@ -849,6 +854,7 @@ export function AiChatPage({ apiBase: apiBaseProp, defaultAgent: defaultAgentPro
             chatApi={chatApi}
             apiBase={apiBase}
             conversationId={conversationId}
+            editPackageId={editPackageId}
             initialMessages={initialMessages}
             onSent={handleSent}
             onShare={() => setShareOpen(true)}
@@ -920,6 +926,9 @@ interface ChatPaneProps {
   chatApi: string | undefined;
   apiBase: string;
   conversationId: string | undefined;
+  /** ADR-0070 "Edit with AI": the package the user opened to edit (from `?package=`),
+   *  forwarded to the build agent as `context.packageId` to scope it to that app. */
+  editPackageId?: string;
   initialMessages: HydratedUIMessage[];
   onSent: (firstUserMessage?: string) => void;
   onShare: () => void;
@@ -935,6 +944,7 @@ function ChatPane({
   chatApi,
   apiBase,
   conversationId,
+  editPackageId,
   initialMessages,
   onSent,
   onShare,
@@ -1040,6 +1050,9 @@ function ChatPane({
         // Tell the agent the environment's publish posture so its narration
         // matches reality (an auto-published build is live, not "to publish").
         autoPublishAiBuilds: getRuntimeConfig().features.autoPublishAiBuilds,
+        // ADR-0070 "Edit with AI": scope the build agent to the app the user
+        // opened to edit. Cloud seeds it as the conversation's active package.
+        ...(editPackageId ? { packageId: editPackageId } : {}),
       },
     },
     initialMessages: hydrated,