wip: agui integration

src/main/engine/ChatEngine.ts

@@ -326,7 +326,19 @@ When answering questions:
 2. If asked about something outside your tools (weather, news, websites), explain that you can only access the user's local blog content.
 3. Be concise and helpful. Format post information clearly when displaying it.
 4. If a search returns no results, suggest alternative queries or filters.
-5. When asked to describe or analyze an image, use the view_image tool to see the actual image content.`;
+5. When asked to describe or analyze an image, use the view_image tool to see the actual image content.
+
+Agentic UI Contract:
+- You may include structured UI payloads in your assistant response so the app can render interactive widgets.
+- You DO have the ability to return interactive AGUI payloads (including bar charts) as JSON, even though you cannot draw bitmap images.
+- When the user asks for a chart or guided workflow, prefer returning a valid AGUI payload over refusing.
+- Use JSON with specVersion: "1" and an elements array.
+- Prefer actionable widgets (cards, forms, tabs, inputs, metrics, tables, charts) when they reduce follow-up friction.
+- Keep textual guidance and UI semantically consistent.
+- Include only valid, supported action names. Supported actions include: openSettings, openPost, openMedia, openPanel, setActiveView, toggleSidebar, togglePanel, toggleAssistantSidebar.
+- Supported element types include: text, metric, list, table, action, chart, form, input, datePicker, card, image, tabs.
+- For tabs elements, include each tab with id, label, and nested elements.
+- Never invent unsupported specVersion values or unsupported element/action names.`;
   }
 
   /**

src/main/engine/OpenCodeManager.ts

@@ -66,6 +66,9 @@ export interface ModelInfo {
 }
 
 export interface SendMessageOptions {
+  metadata?: {
+    surface?: 'tab' | 'sidebar';
+  };
   onDelta?: (delta: string) => void;
   onToolCall?: (toolCall: { name: string; args: unknown }) => void;
   onToolResult?: (result: { name: string; result: unknown }) => void;
@@ -237,7 +240,7 @@ export class OpenCodeManager {
     userMessage: string,
     options: SendMessageOptions = {}
   ): Promise<SendMessageResult> {
-    const { onDelta, onToolCall, onToolResult } = options;
+    const { metadata, onDelta, onToolCall, onToolResult } = options;
 
     try {
       const readyCheck = await this.checkReady();
@@ -272,11 +275,15 @@ export class OpenCodeManager {
 
       // Build message history from DB (excluding system messages)
       const dbMessages = conversation.messages.filter(m => m.role !== 'system');
+      const surfaceHint = metadata?.surface
+        ? `\n\n[Client UI surface: ${metadata.surface}. Render response UI for this surface while keeping content functionally equivalent.]`
+        : '';
+      const userMessageForModel = `${userMessage}${surfaceHint}`;
       // Add the new user message
       dbMessages.push({
         conversationId,
         role: 'user',
-        content: userMessage,
+        content: userMessageForModel,
         createdAt: new Date(),
       });