feat: refine position roundtable workflow

frontend-web/src/core/threads/hooks.ts

@@ -45,11 +45,45 @@ export type ThreadStreamOptions = {
 
 type SendMessageOptions = {
   additionalKwargs?: Record<string, unknown>;
+  /**
+   * Extra human-context messages submitted before the visible user message.
+   * They are persisted with `hide_from_ui` so the model receives rich business
+   * context without dumping long prompts into the conversation surface.
+   */
+  hiddenContext?:
+    | string
+    | {
+        text: string;
+        name?: string;
+        additionalKwargs?: Record<string, unknown>;
+      }
+    | Array<{
+        text: string;
+        name?: string;
+        additionalKwargs?: Record<string, unknown>;
+      }>;
 };
 
 type ThreadTitleRefreshState = Pick<AgentThreadState, "title"> & {
   title_provisional?: boolean;
 };
+
+function normalizeHiddenContextMessages(options?: SendMessageOptions) {
+  const value = options?.hiddenContext;
+  if (!value) return [];
+  const items =
+    typeof value === "string"
+      ? [{ text: value }]
+      : Array.isArray(value)
+        ? value
+        : [value];
+  return items
+    .map((item) => ({
+      ...item,
+      text: item.text.trim(),
+    }))
+    .filter((item) => item.text.length > 0);
+}
 
 function normalizeStoredRunId(runId: string | null): string | null {
   if (!runId) {
@@ -965,27 +999,44 @@ export function useThreadStream({
           ...extraContext,
         };
 
-        await thread.submit(
-          {
-            messages: [
-              {
-                type: "human",
-                content: [
-                  {
-                    type: "text",
-                    text,
-                  },
-                ],
-                additional_kwargs: {
-                  ...options?.additionalKwargs,
-                  client_ts: clientTs,
-                  ...(filesForSubmit.length > 0
-                    ? { files: filesForSubmit }
-                    : {}),
-                },
-              },
-            ],
-          },
+        const hiddenContextMessages = normalizeHiddenContextMessages(options);
+        const submittedMessages: Message[] = [
+          ...hiddenContextMessages.map((item) => ({
+            type: "human" as const,
+            ...(item.name ? { name: item.name } : {}),
+            content: [
+              {
+                type: "text" as const,
+                text: item.text,
+              },
+            ],
+            additional_kwargs: {
+              ...item.additionalKwargs,
+              hide_from_ui: true,
+            },
+          })),
+          {
+            type: "human" as const,
+            content: [
+              {
+                type: "text" as const,
+                text,
+              },
+            ],
+            additional_kwargs: {
+              ...options?.additionalKwargs,
+              client_ts: clientTs,
+              ...(filesForSubmit.length > 0
+                ? { files: filesForSubmit }
+                : {}),
+            },
+          },
+        ];
+
+        await thread.submit(
+          {
+            messages: submittedMessages,
+          },
           {
             threadId: threadId,
             streamSubgraphs: true,