FE-1653: Ground every Brunch conversation in the current Petrinaut net

.changeset/fresh-net-grounding-docs.md

@@ -0,0 +1,10 @@
+---
+"@hashintel/petrinaut": patch
+---
+
+Document that ordinary Brunch chat gives typed and completed Voice turns the
+same on-demand current-net read capability and pre-answer instruction, without
+claiming that every response is mechanically guaranteed to use a fresh
+snapshot or automatically construct a net. The read-only path does not itself
+authorize mutation or attach construction provenance; explicit construction
+modes retain their existing provenance and validation contracts.

apps/brunch-agent/test/integration/petrinaut-chat-result.ts

@@ -15,6 +15,18 @@ export interface PetrinautChatResult {
     UIMessageChunk,
     { type: "tool-input-available" }
   > | null;
+  readonly firstCurrentNetCall: Extract<
+    UIMessageChunk,
+    { type: "tool-input-available" }
+  > | null;
+  readonly firstCurrentNetSnapshot: unknown;
+  readonly firstGroundingText: string;
+  readonly secondCurrentNetCall: Extract<
+    UIMessageChunk,
+    { type: "tool-input-available" }
+  > | null;
+  readonly secondCurrentNetSnapshot: unknown;
+  readonly secondGroundingText: string;
   readonly clientToolOutputsOnInitial: readonly UIMessageChunk[];
   readonly initialFinish: UIMessageChunk | undefined;
   readonly pendingHistoryClientToolState: string | undefined;
@@ -29,6 +41,8 @@ export interface PetrinautChatResult {
   readonly historyClientToolResultCount: number;
   readonly historyGetStatus: number;
   readonly historyUserText: string;
+  readonly historyUserTexts: readonly string[];
+  readonly clientToolResultSignals: readonly unknown[];
   readonly legacyRouteStatus: number;
   readonly unauthenticatedHistoryStatus: number;
   readonly foreignAgentHistoryStatus: number;