@iloveagents/foundry-web-ui 0.1.1 → 0.1.3

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @iloveagents/foundry-web-ui
 
+## 0.1.3
+
+### Patch Changes
+
+- Updated dependencies [d9b0460]
+  - @iloveagents/foundry-agent@0.1.3
+  - @iloveagents/foundry-web-primitives@0.1.3
+
+## 0.1.2
+
+### Patch Changes
+
+- Updated dependencies [30a4346]
+  - @iloveagents/foundry-agent@0.1.2
+  - @iloveagents/foundry-web-primitives@0.1.2
+
 ## 0.1.1
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iloveagents/foundry-web-ui",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",
   "types": "./src/index.ts",
@@ -23,8 +23,8 @@
     "lucide-react": ">=0.400.0",
     "@azure/msal-browser": "^5.0.0",
     "@azure/msal-react": "^5.0.0",
-    "@iloveagents/foundry-agent": "0.1.1",
-    "@iloveagents/foundry-web-primitives": "0.1.1"
+    "@iloveagents/foundry-agent": "0.1.3",
+    "@iloveagents/foundry-web-primitives": "0.1.3"
   },
   "peerDependenciesMeta": {
     "@azure/msal-browser": {

package/src/components/app-brand.tsx

@@ -14,7 +14,7 @@ export function AppBrand({
   labelClassName?: string;
 }) {
   const runtime = useThemeRuntime();
-  const brandName = runtime.branding.appName || "LastSpace.ai";
+  const brandName = runtime.branding.appName || "eomi";
   const logoUrl =
     runtime.mode === "dark"
       ? runtime.branding.darkLogoUrl || runtime.branding.logoUrl

package/src/components/assistant-chat.tsx

@@ -223,11 +223,15 @@ const ComposerActionButton: FC = () => {
   );
 };
 
-/** Starter prompts shown on empty state. Customize these for your agent's capabilities. */
-const STARTER_SUGGESTIONS = [
-  "Show me a short document about Python",
-  "Summarize what you can help me with here",
-  "Draft a concise release note from bullet points",
+/**
+ * Default starter prompts shown on empty state. Override per-app by passing
+ * a `starterSuggestions` prop to `<ChatContent>`. An empty array (`[]`)
+ * suppresses the suggestion buttons entirely.
+ */
+export const DEFAULT_STARTER_SUGGESTIONS = [
+  "Create a new Contract Space",
+  "List all contracts I have access to",
+  "Show me what I can do here",
 ];
 
 const ScrollToBottomButton: FC = () => {
@@ -306,11 +310,23 @@ const DropZone: FC<{ children: React.ReactNode }> = ({ children }) => {
   );
 };
 
+export interface ChatContentProps {
+  /**
+   * Starter prompts shown when the thread is empty. Defaults to
+   * `DEFAULT_STARTER_SUGGESTIONS`. Pass an empty array to hide the
+   * suggestion buttons entirely. Customer apps (e.g. ANDRITZ Contracts)
+   * can pass a workspace-aware list derived from app context.
+   */
+  starterSuggestions?: string[];
+}
+
 /**
  * Reusable chat content — used by ChatPage and ChatBubble.
  * Renders inside a ThreadPrimitive.Root context.
  */
-export function ChatContent() {
+export function ChatContent({
+  starterSuggestions = DEFAULT_STARTER_SUGGESTIONS,
+}: ChatContentProps = {}) {
   const isExpanded = useChatBubbleStore((s) => s.isExpanded);
   const collapseChat = useChatBubbleStore((s) => s.collapse);
   const showPagePanel = useChatBubbleStore((s) => s.showPagePanel);
@@ -357,15 +373,17 @@ export function ChatContent() {
                 <h1 className="text-[2rem] font-normal text-foreground text-center mb-6">
                   How can I help you today?
                 </h1>
-                <div className="flex flex-wrap justify-center gap-2 max-w-lg">
-                  {STARTER_SUGGESTIONS.map((prompt) => (
-                    <ThreadPrimitive.Suggestion key={prompt} prompt={prompt} send asChild>
-                      <Button variant="outline" className="text-sm">
-                        {prompt}
-                      </Button>
-                    </ThreadPrimitive.Suggestion>
-                  ))}
-                </div>
+                {starterSuggestions.length > 0 && (
+                  <div className="flex flex-wrap justify-center gap-2 max-w-lg">
+                    {starterSuggestions.map((prompt) => (
+                      <ThreadPrimitive.Suggestion key={prompt} prompt={prompt} send asChild>
+                        <Button variant="outline" className="text-sm">
+                          {prompt}
+                        </Button>
+                      </ThreadPrimitive.Suggestion>
+                    ))}
+                  </div>
+                )}
               </div>
             </ThreadPrimitive.Empty>
 
@@ -383,10 +401,10 @@ export function ChatContent() {
                 </ThreadPrimitive.If>
               </div>
             </ThreadPrimitive.If>
-            <ThreadPrimitive.If empty={false}>
-              <ScrollToBottomButton />
-            </ThreadPrimitive.If>
           </ThreadPrimitive.Viewport>
+          <ThreadPrimitive.If empty={false}>
+            <ScrollToBottomButton />
+          </ThreadPrimitive.If>
         </div>
 
         <div className="shrink-0 bg-background">

package/src/components/chat-bubble.tsx

@@ -11,6 +11,7 @@ import {
   MessageSquare,
   X,
   Maximize2,
+  SquarePen,
   ArrowUp,
   Square,
   ChevronDown,
@@ -28,6 +29,7 @@ import { MarkdownText } from "./markdown-text.tsx";
 import { LoadingIndicator } from "./loading-indicator.tsx";
 import { useAppStore } from "../lib/app-store.ts";
 import { useChatBubbleStore } from "../lib/chat-bubble-store.ts";
+import { useNewConversation } from "../lib/use-new-conversation.ts";
 import { RAIL_WIDTH, useSidebarStore } from "../lib/sidebar-store.ts";
 
 const CHAT_BUBBLE_INSET = 8;
@@ -106,6 +108,7 @@ export function ChatBubble() {
   const openBubble = useChatBubbleStore((s) => s.open);
   const closeBubble = useChatBubbleStore((s) => s.close);
   const expandChat = useChatBubbleStore((s) => s.expand);
+  const startNewThread = useNewConversation({ navigateToChat: false, preserveNavigation: true });
   const isSidebarOpen = useSidebarStore((s) => s.isOpen);
   const sidebarWidth = useSidebarStore((s) => s.width);
   const pageLabel = useAppStore((s) => s.navContext.label);
@@ -239,6 +242,14 @@ export function ChatBubble() {
               </span>
             </div>
             <div className="flex items-center gap-0.5">
+              <TooltipIconButton
+                tooltip="New Thread"
+                size="icon"
+                className="size-7"
+                onClick={startNewThread}
+              >
+                <SquarePen className="size-3.5" />
+              </TooltipIconButton>
               <TooltipIconButton
                 tooltip="Expand chat"
                 size="icon"
@@ -283,11 +294,10 @@ export function ChatBubble() {
                     </ThreadPrimitive.If>
                   </div>
                 </ThreadPrimitive.If>
-
-                <ThreadPrimitive.If empty={false}>
-                  <BubbleScrollToBottomButton />
-                </ThreadPrimitive.If>
               </ThreadPrimitive.Viewport>
+              <ThreadPrimitive.If empty={false}>
+                <BubbleScrollToBottomButton />
+              </ThreadPrimitive.If>
             </div>
 
             {/* Composer — same pattern as full chat: clip + pin + input + send */}

package/src/components/theme-runtime-provider.tsx

@@ -86,7 +86,7 @@ export function ThemeDocumentMetadata() {
 
   useEffect(() => {
     if (typeof document === "undefined") return;
-    document.title = runtime.branding.appTitle || runtime.branding.appName || "LastSpace.ai";
+    document.title = runtime.branding.appTitle || runtime.branding.appName || "eomi";
   }, [runtime.branding.appName, runtime.branding.appTitle]);
 
   return null;

package/src/index.ts

@@ -5,7 +5,8 @@ export { ToolPanelLayout } from "./components/tool-panel-layout.tsx";
 export { MarkdownText, markdownComponents } from "./components/markdown-text.tsx";
 export { ClientToolExecutor } from "./components/client-tool-executor.tsx";
 export { AGUIRuntimeProvider, useAGUIAdapter } from "./components/ag-ui-runtime-provider.tsx";
-export { ChatContent } from "./components/assistant-chat.tsx";
+export { ChatContent, DEFAULT_STARTER_SUGGESTIONS } from "./components/assistant-chat.tsx";
+export type { ChatContentProps } from "./components/assistant-chat.tsx";
 export { ChatBubble } from "./components/chat-bubble.tsx";
 export { ChatHeader } from "./components/chat-header.tsx";
 export {

package/src/lib/__tests__/ag-ui-adapter.test.ts

@@ -16,7 +16,10 @@ import { describe, expect, it, vi, beforeEach } from "vitest";
 import type { RunnerEvent } from "@iloveagents/foundry-agent";
 
 const appStoreMock = vi.hoisted(() => ({
-  agentState: { contextItems: [] as Array<Record<string, unknown>> },
+  agentState: {
+    contextItems: [] as Array<Record<string, unknown>>,
+    navigation: { contextInstructions: null as string | null },
+  },
   consumedMessageIds: [] as string[],
 }));
 
@@ -73,7 +76,9 @@ import { AGUIAdapterSDK } from "../ag-ui-adapter.ts";
 
 function makeRunInput() {
   return {
-    messages: [{ id: "u-1", role: "user" as const, content: [{ type: "text" as const, text: "hi" }] }],
+    messages: [
+      { id: "u-1", role: "user" as const, content: [{ type: "text" as const, text: "hi" }] },
+    ],
     abortSignal: undefined as AbortSignal | undefined,
   };
 }
@@ -82,7 +87,10 @@ describe("AGUIAdapterSDK", () => {
   beforeEach(() => {
     runMock.mockReset();
     runnerMock.mockClear();
-    appStoreMock.agentState = { contextItems: [] };
+    appStoreMock.agentState = {
+      contextItems: [],
+      navigation: { contextInstructions: null },
+    };
     appStoreMock.consumedMessageIds = [];
   });
 
@@ -186,6 +194,7 @@ describe("AGUIAdapterSDK", () => {
 
   it("forwards app context items through the native AG-UI context field", async () => {
     appStoreMock.agentState = {
+      navigation: { contextInstructions: null },
       contextItems: [
         {
           type: "ref",
@@ -214,6 +223,48 @@ describe("AGUIAdapterSDK", () => {
     ]);
     expect(appStoreMock.consumedMessageIds).toEqual(["u-1"]);
   });
+
+  it("describes typed JSON ref targets without losing the stable ref handle", async () => {
+    appStoreMock.agentState = {
+      navigation: { contextInstructions: null },
+      contextItems: [
+        {
+          type: "ref",
+          label: "Page Instructions · Test Page",
+          refType: "entity-field",
+          refId: "entity-1:instructions.agent_instructions",
+          preview: "Current: old\nProposed: new",
+          targetPath: "$.instructions.agent_instructions",
+          target: {
+            kind: "json-field",
+            path: "$.instructions.agent_instructions",
+            label: "Page Instructions",
+            scope: "entity-field",
+            containerId: "entity-1",
+            containerLabel: "Test Page",
+            currentValue: "old",
+            proposedValue: "new",
+            changeIds: ["change-1"],
+          },
+          sourcePage: "/spaces/entity-1",
+        },
+      ],
+    };
+    runMock.mockImplementation(async function* (): AsyncGenerator<RunnerEvent> {});
+
+    const adapter = new AGUIAdapterSDK();
+    for await (const _ of adapter.run(makeRunInput())) {
+      // Drain the adapter.
+    }
+
+    expect(runMock.mock.calls[0][0].context).toEqual([
+      {
+        description:
+          "Selected entity-field Page Instructions. Use targetPath as the exact JSON edit target when the user asks to modify, rewrite, or transform this reference.",
+        value: JSON.stringify(appStoreMock.agentState.contextItems[0]),
+      },
+    ]);
+  });
 });
 
 interface ChatModelRunResultLike {

package/src/lib/__tests__/app-store.test.ts

@@ -339,6 +339,39 @@ describe("app-store", () => {
       expect(projection.navigation.groupMeta).toEqual({ orgId: "org-1" });
       expect(projection.navigation.group).toBe("Contracts");
     });
+
+    it("compacts reference target values within the documented context limit", () => {
+      const longValue = "x".repeat(2_001);
+
+      store().addContextItem({
+        type: "ref",
+        label: "Long field",
+        sourcePage: "/spaces/entity-1",
+        persistence: "ephemeral",
+        payload: {
+          kind: "ref",
+          refType: "entity-field",
+          refId: "entity-1",
+          target: {
+            path: "$.instructions.page",
+            label: "Page Instructions",
+            currentValue: longValue,
+            proposedValue: longValue,
+          },
+        },
+      });
+
+      const projection = store().getAgentState();
+      const target = projection.contextItems[0].target as {
+        currentValue: string;
+        proposedValue: string;
+      };
+
+      expect(target.currentValue).toHaveLength(2_000);
+      expect(target.currentValue.endsWith("...")).toBe(true);
+      expect(target.proposedValue).toHaveLength(2_000);
+      expect(target.proposedValue.endsWith("...")).toBe(true);
+    });
   });
 
   describe("resetAll", () => {

package/src/lib/ag-ui-adapter.ts

@@ -25,11 +25,7 @@ import type {
   ToolCallMessagePart,
 } from "@assistant-ui/react";
 import type { Context, Message as AGUIMessage } from "@ag-ui/core";
-import {
-  AGUIRunner,
-  clientToolRegistry,
-  streamingStatusStore,
-} from "@iloveagents/foundry-agent";
+import { AGUIRunner, clientToolRegistry, streamingStatusStore } from "@iloveagents/foundry-agent";
 import { tokenFetch } from "@iloveagents/foundry-agent/msal";
 import { useAppStore, type AgentStateProjection } from "./app-store.ts";
 import { useDevStore } from "./dev-store.ts";
@@ -45,10 +41,7 @@ interface ToolCallSnapshot {
 export class AGUIAdapterSDK implements ChatModelAdapter {
   private readonly runner: AGUIRunner;
 
-  constructor(
-    url: string = "/api/agent",
-    options?: { threadId?: string; fetchFn?: typeof fetch },
-  ) {
+  constructor(url: string = "/api/agent", options?: { threadId?: string; fetchFn?: typeof fetch }) {
     this.runner = new AGUIRunner({
       url,
       threadId: options?.threadId,
@@ -91,9 +84,7 @@ export class AGUIAdapterSDK implements ChatModelAdapter {
      * generator returns. assistant-ui leaves the message stuck in the
      * loading state if the last yield's status is `running`.
      */
-    const buildResult = (
-      statusOverride?: ChatModelRunResult["status"],
-    ): ChatModelRunResult => {
+    const buildResult = (statusOverride?: ChatModelRunResult["status"]): ChatModelRunResult => {
       const content: (ToolCallMessagePart | TextMessagePart)[] = [];
 
       for (const [id, tc] of toolCalls) {
@@ -278,8 +269,21 @@ function describeContextItem(item: Record<string, unknown>, index: number): stri
 
   if (type === "ref") {
     const refType = typeof item.refType === "string" ? item.refType : "reference";
-    if (typeof item.targetPath === "string") {
-      return `Selected ${refType} atom. Use targetPath as the exact edit target when the user asks to modify, rewrite, or transform selected content.`;
+    const target = isRecord(item.target) ? item.target : undefined;
+    const targetPath =
+      typeof item.targetPath === "string"
+        ? item.targetPath
+        : typeof target?.path === "string"
+          ? target.path
+          : undefined;
+    const targetLabel = typeof target?.label === "string" ? target.label : undefined;
+    const targetScope = typeof target?.scope === "string" ? target.scope : undefined;
+    if (targetPath) {
+      if (!targetLabel && !targetScope) {
+        return `Selected ${refType} atom. Use targetPath as the exact edit target when the user asks to modify, rewrite, or transform selected content.`;
+      }
+      const targetText = targetLabel || targetScope || "JSON atom";
+      return `Selected ${refType} ${targetText}. Use targetPath as the exact JSON edit target when the user asks to modify, rewrite, or transform this reference.`;
     }
     return `Selected ${refType} reference. Use refId as the edit target when the user asks to modify, rewrite, or transform selected content.`;
   }
@@ -305,6 +309,10 @@ function stringifyContextItem(item: Record<string, unknown>): string {
   }
 }
 
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
 /**
  * Convert assistant-ui's `Message[]` into AG-UI's wire format.
  *

package/src/lib/app-store.ts

@@ -33,6 +33,25 @@ export interface ReferencePayload {
   refId: string;
   /** Optional display text (~100 chars) */
   preview?: string;
+  /**
+   * Optional exact JSON target inside the referenced domain object.
+   *
+   * This keeps the existing refType/refId contract stable for deep links
+   * while allowing feature modules to target one schema-declared field,
+   * table cell, JSON atom, or app-defined custom value precisely.
+   */
+  target?: {
+    kind?: string;
+    path?: string;
+    label?: string;
+    scope?: string;
+    containerId?: string;
+    containerLabel?: string;
+    currentValue?: unknown;
+    proposedValue?: unknown;
+    changeIds?: string[];
+    meta?: Record<string, unknown>;
+  };
   /** Domain-specific data the agent can use */
   meta?: Record<string, unknown>;
 }
@@ -82,6 +101,8 @@ export interface AgentStateProjection {
 
 const MAX_ITEMS = 10;
 const MAX_LABEL_LENGTH = 500;
+const MAX_CONTEXT_VALUE_LENGTH = 2_000;
+const TRUNCATION_SUFFIX = "...";
 
 const DEFAULT_NAV_CONTEXT: NavContext = {
   group: null,
@@ -97,7 +118,11 @@ function refDedupKey(payload: ReferencePayload): string {
   const selectionScope =
     typeof payload.meta?.selectionScope === "string" ? payload.meta.selectionScope : "block";
   const targetPath =
-    typeof payload.meta?.targetPath === "string" ? payload.meta.targetPath : undefined;
+    typeof payload.target?.path === "string"
+      ? payload.target.path
+      : typeof payload.meta?.targetPath === "string"
+        ? payload.meta.targetPath
+        : undefined;
 
   if (selectionScope === "atom" && targetPath) {
     return `${payload.refType}:${payload.refId}:atom:${targetPath}`;
@@ -108,6 +133,24 @@ function refDedupKey(payload: ReferencePayload): string {
   return `${payload.refType}:${payload.refId}:block`;
 }
 
+function compactContextValue(value: unknown): unknown {
+  if (typeof value === "string" && value.length > MAX_CONTEXT_VALUE_LENGTH) {
+    return `${value.slice(0, MAX_CONTEXT_VALUE_LENGTH - TRUNCATION_SUFFIX.length)}${TRUNCATION_SUFFIX}`;
+  }
+  return value;
+}
+
+function compactReferenceTarget(
+  target: ReferencePayload["target"],
+): ReferencePayload["target"] {
+  if (!target) return undefined;
+  return {
+    ...target,
+    currentValue: compactContextValue(target.currentValue),
+    proposedValue: compactContextValue(target.proposedValue),
+  };
+}
+
 interface AppState {
   // Thread state
   threadActive: boolean;
@@ -282,12 +325,18 @@ export const useAppStore = create<AppState>((set, get) => ({
           case "ref":
             return {
               type,
+              label: label.slice(0, 200),
               refType: payload.refType,
               refId: payload.refId,
               preview: payload.preview?.slice(0, 100),
+              target: compactReferenceTarget(payload.target),
               meta: payload.meta,
               targetPath:
-                typeof payload.meta?.targetPath === "string" ? payload.meta.targetPath : undefined,
+                typeof payload.target?.path === "string"
+                  ? payload.target.path
+                  : typeof payload.meta?.targetPath === "string"
+                    ? payload.meta.targetPath
+                    : undefined,
               sourcePage,
             };
           default:

package/src/lib/theme-runtime.ts

@@ -595,8 +595,8 @@ export const FOUNDRY_VIOLET_THEME: ThemeDefinition = {
     radius: "0.875rem",
   },
   branding: {
-    appName: "LastSpace.ai",
-    appTitle: "LastSpace.ai",
+    appName: "eomi",
+    appTitle: "eomi",
   },
 };
 

package/src/lib/use-new-conversation.test.tsx

@@ -39,6 +39,18 @@ function Trigger() {
   );
 }
 
+function PreserveNavigationTrigger() {
+  const handleNewConversation = useNewConversation({
+    navigateToChat: false,
+    preserveNavigation: true,
+  });
+  return (
+    <button type="button" onClick={handleNewConversation}>
+      New Bubble Thread
+    </button>
+  );
+}
+
 describe("useNewConversation", () => {
   let container: HTMLDivElement;
   let root: Root;
@@ -121,4 +133,30 @@ describe("useNewConversation", () => {
     expect(citationStore.getState().results).toEqual([]);
     expect(citationStore.getState().handler).toBeNull();
   });
+
+  it("can reset the thread without leaving the current page", async () => {
+    await act(async () => {
+      root.render(
+        <MemoryRouter initialEntries={["/spaces/demo"]}>
+          <PreserveNavigationTrigger />
+          <LocationProbe />
+        </MemoryRouter>,
+      );
+    });
+
+    const button = container.querySelector("button");
+    expect(button).toBeTruthy();
+
+    await act(async () => {
+      button?.dispatchEvent(new MouseEvent("click", { bubbles: true }));
+    });
+
+    expect(container.querySelector('[data-testid="location"]')?.textContent).toBe("/spaces/demo");
+    expect(switchToNewThread).toHaveBeenCalledTimes(1);
+    expect(resetThread).toHaveBeenCalledTimes(1);
+    expect(useAppStore.getState().currentPage).toBe("/spaces/demo");
+    expect(useAppStore.getState().navContext.label).toBe("Demo");
+    expect(useAppStore.getState().threadActive).toBe(false);
+    expect(useAppStore.getState().contextItems).toEqual([]);
+  });
 });

package/src/lib/use-new-conversation.ts

@@ -12,7 +12,7 @@ import { useSidebarStore } from "./sidebar-store.ts";
  * Shared hook for starting a new conversation.
  * Used by ChatHeader and Sidebar to keep behavior in sync.
  */
-export function useNewConversation() {
+export function useNewConversation(options?: { navigateToChat?: boolean; preserveNavigation?: boolean }) {
   const aui = useAui();
   const { resetThread } = useAGUIAdapter();
   const navigate = useNavigate();
@@ -22,12 +22,33 @@ export function useNewConversation() {
   const clearCitations = useStore(citationStore, (s) => s.clear);
 
   return useCallback(() => {
+    const preserved = options?.preserveNavigation
+      ? {
+          currentPage: useAppStore.getState().currentPage,
+          navContext: useAppStore.getState().navContext,
+        }
+      : null;
     closePanel();
     resetApp();
+    if (preserved) {
+      useAppStore.setState(preserved);
+    }
     closeMobile();
     clearCitations();
     resetThread();
     aui.threads().switchToNewThread();
-    navigate("/");
-  }, [closePanel, resetApp, closeMobile, clearCitations, resetThread, aui, navigate]);
+    if (options?.navigateToChat ?? true) {
+      navigate("/");
+    }
+  }, [
+    closePanel,
+    resetApp,
+    options?.preserveNavigation,
+    closeMobile,
+    clearCitations,
+    resetThread,
+    aui,
+    options?.navigateToChat,
+    navigate,
+  ]);
 }