@opengeni/react 3.5.1-canary.0 → 3.7.0-canary.1

package/dist/components/session-chrome.d.ts

@@ -28,16 +28,23 @@
  * Inbox has no product dismiss API; pass `onDismissIncoming` when the host
  * wants a visible action (dev harness may use a local dummy).
  *
+ * Queue opens by default when chrome is idle and at least one authoritative
+ * prompt is queued. Closing the queue dismisses that session's offer until
+ * occupancy drains; a different session on the same chrome instance may
+ * offer again. An in-flight optimistic Send never opens the drawer —
+ * admission stays a paint-only receipt on the chip so layout does not jump
+ * under the pointer.
+ *
  * Segment switches keep the panel shell mounted and crossfade content. The
  * shell uses one CSS grid-track transition for deliberate open/close actions;
  * live queue reconciliation never feeds measurements back into layout.
  */
-import type { SessionGoal } from "@opengeni/sdk";
+import type { SessionGoal, SessionTurn } from "@opengeni/sdk";
 import { type ReactNode } from "react";
-import type { ComposerState } from "../hooks/use-composer.js";
+import type { ComposerOptimisticMessage, ComposerState } from "../hooks/use-composer.js";
 import type { UseGoalResult } from "../hooks/use-goal.js";
 import type { UseTurnQueueResult } from "../hooks/use-turn-queue.js";
-export type SessionChromeSignalId = "incoming" | "steering" | "queue" | "goal" | "agents";
+export type SessionChromeSignalId = "incoming" | "steering" | "queue" | "goal" | "agents" | "commands";
 export type SessionChromeSignalTone = "neutral" | "accent" | "waiting" | "running";
 export type SessionChromeAgentsSignal = {
     count: number;
@@ -45,12 +52,16 @@ export type SessionChromeAgentsSignal = {
     tone?: SessionChromeSignalTone | undefined;
 };
 export type SessionChromeProps = {
+    compact?: boolean;
     queue: UseTurnQueueResult;
     /** Needed for queue edit → composer checkout. Omit with `readOnly`. */
     composer?: ComposerState | undefined;
     goal?: UseGoalResult | null | undefined;
     /** Expanded agents body (host supplies tree / list). */
     agentsPanel?: ReactNode;
+    /** Active commands only. The host mounts the body only when opened. */
+    commandsPanel?: ReactNode;
+    commandsCount?: number | undefined;
     /** Chip summary; when `count > 0` the agents segment appears. */
     agentsSignal?: SessionChromeAgentsSignal | undefined;
     /**
@@ -73,11 +84,33 @@ type GoalPillRecord = Pick<SessionGoal, "status" | "pausedReason"> & {
 export declare function sessionChromeGoalPillLabel(state: GoalPillState, record: GoalPillRecord | null | undefined): string;
 /**
  * One human sentence explaining WHY the goal is not pursuing right now: the
- * pause reason, the agent's own `goal_wait` hold (reason + deadline), or the
+ * pause reason, the agent's own `wait_for_input` hold (reason + deadline), or the
  * next idle-backoff check time. Null when the state needs no explanation.
  */
 export declare function sessionChromeGoalPillExplanation(state: GoalPillState, record: GoalPillRecord | null | undefined): string | null;
+export declare function countAuthoritativeQueuedTurns(turns: readonly SessionTurn[], mutationFor: UseTurnQueueResult["mutationFor"]): number;
+export declare function countOptimisticQueuedMessages(messages: readonly ComposerOptimisticMessage[] | undefined, queuedTurnIds: ReadonlySet<string>, snapshot: UseTurnQueueResult["snapshot"]): number;
+/**
+ * First uncontrolled segment. An existing authoritative queue opens itself
+ * when the host did not pick another default; optimistic-only occupancy
+ * stays collapsed so a live Send does not shove a drawer under the pointer.
+ */
+export declare function sessionChromeInitialActive(input: {
+    defaultActive: SessionChromeSignalId | null;
+    authoritativeQueuedCount: number;
+}): SessionChromeSignalId | null;
+/**
+ * Whether idle chrome should offer the queue panel. A dismissed session
+ * stays collapsed until occupancy drains. Controlled hosts own this.
+ */
+export declare function sessionChromeShouldOfferQueue(input: {
+    controlled: boolean;
+    active: SessionChromeSignalId | null;
+    activityOpen: boolean;
+    authoritativeQueuedCount: number;
+    suppressed: boolean;
+}): boolean;
 /** Select pill state from the goal's authoritative continuation projection. */
 export declare function sessionChromeGoalPillState(goalStatus: "active" | "paused" | "completed", continuation: SessionGoal["continuation"] | null | undefined): GoalPillState;
-export declare function SessionChrome({ queue, composer, goal, agentsPanel, agentsSignal, onDismissIncoming, readOnly, className, active: activeControlled, defaultActive, onActiveChange, }: SessionChromeProps): import("react").JSX.Element | null;
+export declare function SessionChrome({ compact, queue, composer, goal, agentsPanel, commandsPanel, commandsCount, agentsSignal, onDismissIncoming, readOnly, className, active: activeControlled, defaultActive, onActiveChange, }: SessionChromeProps): import("react").JSX.Element | null;
 export {};

package/dist/components/session-commands-panel.d.ts

@@ -0,0 +1,6 @@
+import type { UseSessionBackgroundCommandsResult } from "../hooks/use-session-background-commands.js";
+/** The current session's live commands. Settled commands belong to the timeline. */
+export declare function SessionCommandsPanel({ commands: state, readOnly, }: {
+    commands: UseSessionBackgroundCommandsResult;
+    readOnly?: boolean;
+}): import("react").JSX.Element;

package/dist/components/session-conversation.d.ts

@@ -0,0 +1,14 @@
+import { type CSSProperties } from "react";
+import { type ClientOverride } from "../session-context.js";
+import { type ChatComposerProps } from "./chat-composer.js";
+export type SessionConversationProps = ClientOverride & {
+    sessionId: string;
+    className?: string;
+    /** Defaults to filling the host. The host owns available height. */
+    height?: CSSProperties["height"];
+    /** Presentation/custom controls only; queue and delivery wiring stay owned here. */
+    composerProps?: Omit<ChatComposerProps, "composer" | "effectiveControl" | "queuedAheadCount">;
+};
+/** Complete existing-session conversation. Uses the provider's normal SDK client
+ * (including Site clients), one shared event feed, and authoritative queue state. */
+export declare function SessionConversation(props: SessionConversationProps): import("react").JSX.Element;

package/dist/components/timeline-anchor.d.ts

@@ -0,0 +1,21 @@
+import { Component, type ReactNode } from "react";
+type Anchor = {
+    element: HTMLElement;
+    key: string | null;
+    text: string | null;
+    top: number;
+};
+export type TimelineAnchor = Anchor[];
+/** Read the old DOM immediately before React changes it, not when a fetch starts. */
+export declare class TimelineBeforeLayout extends Component<{
+    capture: () => void;
+    children: ReactNode;
+}> {
+    getSnapshotBeforeUpdate(): null;
+    componentDidUpdate(): void;
+    render(): ReactNode;
+}
+export declare function captureTimelineAnchor(scroller: HTMLElement): TimelineAnchor | null;
+/** Return only the correction native browser anchoring has not already made. */
+export declare function timelineAnchorCorrection(scroller: HTMLElement, anchors: TimelineAnchor): number | null;
+export {};

package/dist/composer.js

@@ -37,7 +37,7 @@ import {
   useChatComposer,
   useChatComposerController,
   useVoiceInput
-} from "./chunk-UNCXXIQR.js";
+} from "./chunk-INGB2N5R.js";
 import {
   BillingClassMark,
   ModelPolicyPicker,
@@ -47,12 +47,11 @@ import {
   PickerNavRow,
   defaultModelPolicyPickerMessages
 } from "./chunk-4JFUT22W.js";
-import "./chunk-7EAFGICR.js";
 import "./chunk-VZTQ73XT.js";
 import "./chunk-IOLVN74D.js";
+import "./chunk-PLYRL5ER.js";
 import "./chunk-KZ73RL76.js";
 import "./chunk-NEXLLTP4.js";
-import "./chunk-VTOREEXF.js";
 import "./chunk-WMGF4Z7X.js";
 import "./chunk-22KP6LR5.js";
 export {

package/dist/conversation-timeline.d.ts

@@ -0,0 +1,5 @@
+import type { ComposerState } from "./hooks/use-composer.js";
+import type { UseTurnQueueResult } from "./hooks/use-turn-queue.js";
+import type { TimelineItem } from "./timeline/types.js";
+/** Keep pending prompts in the queue, not duplicated in the conversation. */
+export declare function conversationTimeline(items: TimelineItem[], queue: Pick<UseTurnQueueResult, "queue" | "snapshot" | "acceptedSteers">, composer: Pick<ComposerState, "optimisticMessages" | "retryOptimisticMessage" | "removeOptimisticMessage">): TimelineItem[];

package/dist/{fleet-decision-row-GGCAT4E4.js → fleet-decision-row-YZ3ZKWMM.js}

@@ -23,6 +23,7 @@ var FLEET_ACTUAL_REASON_LABEL = {
   rotation: "Rotated for capacity",
   active: "Used the active subscription",
   all_capped: "All observed subscriptions were capped",
+  allocator_disabled: "The policy-selected subscription was disabled for new allocations",
   none: "No production candidate was selected"
 };
 var FLEET_SHADOW_REASON_LABEL = {
@@ -348,4 +349,4 @@ function formatFleetScore(value) {
 export {
   FleetDecisionRow as default
 };
-//# sourceMappingURL=fleet-decision-row-GGCAT4E4.js.map
+//# sourceMappingURL=fleet-decision-row-YZ3ZKWMM.js.map

package/dist/fleet-decision-row-YZ3ZKWMM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/timeline/fleet-decision-row.tsx"],"sourcesContent":["import type { FleetDecisionItem } from \"./types\";\n\ntype RowJsx = typeof import(\"react/jsx-runtime\").jsx;\ntype RowJsxs = typeof import(\"react/jsx-runtime\").jsxs;\n\nfunction GaugeMark({ className, j, s }: { className: string; j: RowJsx; s: RowJsxs }) {\n  return s(\"svg\", {\n    \"aria-hidden\": \"true\",\n    className,\n    fill: \"none\",\n    height: \"24\",\n    stroke: \"currentColor\",\n    strokeLinecap: \"round\",\n    strokeLinejoin: \"round\",\n    strokeWidth: \"2\",\n    viewBox: \"0 0 24 24\",\n    width: \"24\",\n    children: [\n      j(\"path\", { d: \"m 12 14 4-4\" }, \"needle\"),\n      j(\"path\", { d: \"M3.34 19a10 10 0 1 1 17.32 0\" }, \"arc\"),\n    ],\n  });\n}\n\nconst FLEET_ACTUAL_REASON_LABEL: Record<FleetDecisionItem[\"actualReason\"], string> = {\n  lease_reused: \"Reused the fenced lease\",\n  pin: \"Kept the session pin\",\n  rotation: \"Rotated for capacity\",\n  active: \"Used the active subscription\",\n  all_capped: \"All observed subscriptions were capped\",\n  allocator_disabled: \"The policy-selected subscription was disabled for new allocations\",\n  none: \"No production candidate was selected\",\n};\n\nconst FLEET_SHADOW_REASON_LABEL: Record<FleetDecisionItem[\"shadowReason\"], string> = {\n  fenced_in_flight: \"Kept the fenced in-flight assignment\",\n  fenced_candidate_missing: \"The fenced assignment was missing from the snapshot\",\n  admission_paced: \"Admission would have been paced\",\n  no_eligible_candidate: \"No candidate passed the policy checks\",\n  overlay_isolated_empty: \"Explicit isolation left no eligible candidate\",\n  best_score: \"Selected the lowest-pressure candidate\",\n  affinity_best: \"Session affinity was already best\",\n  hysteresis_hold: \"Hysteresis avoided a low-value switch\",\n};\n\nconst FLEET_COMPARISON_LABEL: Record<FleetDecisionItem[\"comparison\"], string> = {\n  match: \"Production and shadow matched\",\n  different_candidate: \"Shadow preferred another candidate\",\n  different_outcome: \"Production and shadow outcomes differed\",\n  not_comparable_truncated: \"Comparison limited by bounded candidate data\",\n};\n\nconst FLEET_ADMISSION_REASON_LABEL: Record<FleetDecisionItem[\"admissionReason\"], string> = {\n  fenced_in_flight: \"In-flight assignment was fenced\",\n  pacing_disabled: \"Admission pacing was disabled\",\n  capacity_unknown: \"Capacity was unknown, so work remained admissible\",\n  capacity_available: \"Observed capacity was available\",\n  work_conserving_borrow: \"Idle capacity was borrowed for standard work\",\n  manager_priority: \"Standard work was paced for queued manager demand\",\n  standard_starvation_bound: \"The standard-work starvation bound was reached\",\n  capacity_saturated: \"Observed dynamic capacity was saturated\",\n  emergency_fuse: \"The emergency fuse blocked new work\",\n};\n\nconst FLEET_REJECTION_LABEL: Record<\n  Exclude<FleetDecisionItem[\"scores\"][number][\"rejectionReason\"], null>,\n  string\n> = {\n  allocator_disabled: \"Allocator disabled\",\n  unavailable: \"Unavailable\",\n  cooling: \"Cooling down\",\n  quota_ceiling: \"Quota ceiling reached\",\n  overlay_isolation: \"Outside explicit isolation\",\n};\n\nconst FLEET_CONFIDENCE_LABEL: Record<FleetDecisionItem[\"confidence\"], string> = {\n  unknown: \"Unknown confidence\",\n  low: \"Low confidence\",\n  medium: \"Medium confidence\",\n  high: \"High confidence\",\n};\n\nexport default function FleetDecisionRow({\n  item,\n  d: ActivityDisclosure,\n  b: BodyNote,\n  j,\n  s,\n}: {\n  item: FleetDecisionItem;\n  d: typeof import(\"./shared\").ActivityDisclosure;\n  b: typeof import(\"./shared\").BodyNote;\n  j: RowJsx;\n  s: RowJsxs;\n}) {\n  const scoreRowsHidden = item.scoreRowsTruncatedCount > 0;\n  const scores =\n    item.scores.length > 0\n      ? j(\n          \"div\",\n          {\n            className: \"min-w-0\",\n            children: [\n              j(\n                \"h4\",\n                {\n                  className: \"text-og-sm font-medium text-og-fg\",\n                  children: \"Bounded candidate scores\",\n                },\n                \"heading\",\n              ),\n              j(\n                \"p\",\n                {\n                  className: \"mt-0.5 text-og-xs leading-5 text-og-fg-subtle\",\n                  children:\n                    \"Lower scores rank first. Candidate aliases are temporary and local to this event.\",\n                },\n                \"description\",\n              ),\n              j(\n                \"ul\",\n                {\n                  className: \"mt-2 flex min-w-0 flex-col gap-1.5\",\n                  \"aria-label\": \"Candidate scores\",\n                  children: item.scores.map((score) =>\n                    s(\n                      \"li\",\n                      {\n                        className:\n                          \"flex min-w-0 flex-col gap-1 rounded-og-sm bg-og-surface-1 px-2.5 py-2 text-og-sm sm:flex-row sm:items-center sm:gap-3\",\n                        children: [\n                          j(\n                            \"span\",\n                            {\n                              className: \"font-og-mono text-og-fg\",\n                              children: score.candidateKey,\n                            },\n                            \"candidate\",\n                          ),\n                          j(\n                            \"span\",\n                            {\n                              className: \"min-w-0 text-og-fg-muted sm:flex-1\",\n                              children: score.eligible\n                                ? \"Eligible\"\n                                : score.rejectionReason\n                                  ? FLEET_REJECTION_LABEL[score.rejectionReason]\n                                  : \"Unavailable\",\n                            },\n                            \"eligibility\",\n                          ),\n                          s(\n                            \"span\",\n                            {\n                              className: \"font-og-mono text-og-fg-subtle\",\n                              children: [\n                                \"score \",\n                                formatFleetScore(score.total),\n                                \" ·\",\n                                \" \",\n                                FLEET_CONFIDENCE_LABEL[score.confidence],\n                              ],\n                            },\n                            \"score\",\n                          ),\n                        ],\n                      },\n                      score.candidateKey,\n                    ),\n                  ),\n                },\n                \"rows\",\n              ),\n            ],\n          },\n          \"score-list\",\n        )\n      : null;\n  const truncated =\n    item.truncatedCandidateCount > 0\n      ? j(\n          BodyNote,\n          {\n            tone: \"muted\",\n            children: [\n              item.truncatedCandidateCount,\n              \" additional \",\n              item.truncatedCandidateCount === 1 ? \"candidate was\" : \"candidates were\",\n              \" excluded from this bounded replay record.\",\n            ],\n          },\n          \"truncated\",\n        )\n      : null;\n  const hidden = scoreRowsHidden\n    ? j(\n        BodyNote,\n        {\n          tone: \"muted\",\n          children: [\n            item.scoreRowsTruncatedCount,\n            \" additional \",\n            item.scoreRowsTruncatedCount === 1 ? \"score row was\" : \"score rows were\",\n            \" hidden by this view’s safety limit.\",\n          ],\n        },\n        \"hidden\",\n      )\n    : null;\n  return j(ActivityDisclosure, {\n    icon: j(GaugeMark, { className: \"size-3.5\", j, s }),\n    iconTone: \"muted\",\n    title: \"Fleet policy shadow\",\n    preview: FLEET_COMPARISON_LABEL[item.comparison],\n    chip: {\n      tone: \"muted\",\n      text:\n        item.comparison === \"match\"\n          ? \"matched\"\n          : item.comparison === \"not_comparable_truncated\"\n            ? \"limited\"\n            : \"different\",\n    },\n    children: s(\"section\", {\n      \"aria-label\": \"Fleet policy shadow details\",\n      className: \"flex min-w-0 flex-col gap-3\",\n      children: [\n        j(\n          BodyNote,\n          {\n            tone: \"muted\",\n            children:\n              \"Shadow observation only — it did not change the subscription serving this turn.\",\n          },\n          \"observation\",\n        ),\n        j(\n          \"dl\",\n          {\n            className: \"grid min-w-0 grid-cols-1 gap-x-5 gap-y-3 sm:grid-cols-2\",\n            children: [\n              j(\n                FleetDetail,\n                {\n                  term: \"Production\",\n                  value: fleetOutcomeLabel(item.actualOutcome, item.actualCandidateKey),\n                  note: FLEET_ACTUAL_REASON_LABEL[item.actualReason],\n                  j,\n                  s,\n                },\n                \"production\",\n              ),\n              j(\n                FleetDetail,\n                {\n                  term: \"Shadow policy\",\n                  value: fleetOutcomeLabel(item.shadowOutcome, item.shadowCandidateKey),\n                  note: FLEET_SHADOW_REASON_LABEL[item.shadowReason],\n                  j,\n                  s,\n                },\n                \"shadow\",\n              ),\n              j(\n                FleetDetail,\n                {\n                  term: \"Comparison\",\n                  value: FLEET_COMPARISON_LABEL[item.comparison],\n                  j,\n                  s,\n                },\n                \"comparison\",\n              ),\n              j(\n                FleetDetail,\n                {\n                  term: \"Decision confidence\",\n                  value: FLEET_CONFIDENCE_LABEL[item.confidence],\n                  j,\n                  s,\n                },\n                \"confidence\",\n              ),\n              j(\n                FleetDetail,\n                {\n                  term: \"Admission\",\n                  value:\n                    item.admissionOutcome === \"admit\"\n                      ? \"Would admit new work\"\n                      : \"Would pace new work\",\n                  note: FLEET_ADMISSION_REASON_LABEL[item.admissionReason],\n                  j,\n                  s,\n                },\n                \"admission\",\n              ),\n              j(\n                FleetDetail,\n                {\n                  term: \"Observed candidates\",\n                  value: `${item.candidateCount} in the bounded replay`,\n                  j,\n                  s,\n                },\n                \"candidate-count\",\n              ),\n              j(\n                FleetDetail,\n                {\n                  term: \"Idle-capacity borrowing\",\n                  value: item.borrowedIdleCapacity ? \"Borrowed for standard work\" : \"Not borrowed\",\n                  j,\n                  s,\n                },\n                \"idle-capacity\",\n              ),\n              j(\n                FleetDetail,\n                {\n                  term: \"Named-policy borrowing\",\n                  value: item.borrowedOverlayCapacity\n                    ? \"Borrowed outside the preferred group\"\n                    : \"Not borrowed\",\n                  j,\n                  s,\n                },\n                \"named-policy\",\n              ),\n              j(\n                FleetDetail,\n                {\n                  term: \"Stranded capacity\",\n                  value:\n                    item.strandedEligibleCount === 0\n                      ? \"None\"\n                      : `${item.strandedEligibleCount} eligible ${item.strandedEligibleCount === 1 ? \"candidate\" : \"candidates\"}`,\n                  note:\n                    item.strandedEligibleCount > 0\n                      ? \"Capacity excluded by explicit isolation; existing fenced turns are unchanged.\"\n                      : undefined,\n                  j,\n                  s,\n                },\n                \"stranded-capacity\",\n              ),\n            ],\n          },\n          \"details\",\n        ),\n        scores,\n        truncated,\n        hidden,\n      ],\n    }),\n  });\n}\n\nfunction FleetDetail({\n  term,\n  value,\n  note,\n  j,\n  s,\n}: {\n  term: string;\n  value: string;\n  note?: string | undefined;\n  j: RowJsx;\n  s: RowJsxs;\n}) {\n  return j(\"div\", {\n    className: \"min-w-0\",\n    children: [\n      j(\n        \"dt\",\n        {\n          className: \"text-og-xs font-medium uppercase tracking-wide text-og-fg-subtle\",\n          children: term,\n        },\n        \"term\",\n      ),\n      s(\n        \"dd\",\n        {\n          className: \"mt-0.5 break-words text-og-sm text-og-fg-muted\",\n          children: [\n            j(\"span\", { className: \"text-og-fg\", children: value }, \"value\"),\n            note\n              ? j(\"span\", { className: \"mt-0.5 block leading-5\", children: note }, \"note\")\n              : null,\n          ],\n        },\n        \"description\",\n      ),\n    ],\n  });\n}\n\nfunction fleetOutcomeLabel(\n  outcome: FleetDecisionItem[\"actualOutcome\"] | FleetDecisionItem[\"shadowOutcome\"],\n  candidateKey: string | null,\n): string {\n  if (outcome === \"selected\" && candidateKey) return `Selected ${candidateKey}`;\n  if (outcome === \"waiting\") return \"Waiting for capacity\";\n  if (outcome === \"paced\") return \"Paced before placement\";\n  return \"No candidate selected\";\n}\n\nfunction formatFleetScore(value: number): string {\n  return new Intl.NumberFormat(\"en-US\", { maximumFractionDigits: 2 }).format(value);\n}\n"],"mappings":"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","names":[]}

package/dist/hooks/use-file-attachments.d.ts

@@ -47,6 +47,12 @@ export type UseFileAttachmentsResult = {
     }) => void;
     /** Restore already-ready server assets without recreating browser-local bytes. */
     restoreReadyFiles: (files: Iterable<FileAsset>) => void;
+    /**
+     * Resolve a ready image's short-lived server preview URL on demand. Optional
+     * for upload-only embedded clients; local object-URL previews remain usable
+     * without it.
+     */
+    loadPreview?: ((id: string, signal?: AbortSignal) => Promise<string | undefined>) | undefined;
     /**
      * Re-run the upload for a `failed` attachment, in place (same id, same
      * source file). No-op for an id that isn't a known failed upload.

package/dist/hooks/use-sandbox-files.d.ts

@@ -1,4 +1,4 @@
-import type { FsReadResponse, FsWriteResponse, OpenGeniRequestOptions, SessionCapabilities, SessionEvent, WorkspaceCaptureManifest } from "@opengeni/sdk";
+import type { FileSystemRouteIdentity, FsReadResponse, FsWriteResponse, OpenGeniRequestOptions, SessionCapabilities, SessionEvent, WorkspaceCaptureManifest } from "@opengeni/sdk";
 import { type ClientOverride } from "../provider.js";
 /** The git-status overlay a file row may carry (tints modified files in the tree). */
 export type FileTreeStatus = "added" | "modified" | "deleted" | "renamed" | "untracked";
@@ -47,6 +47,9 @@ export type UseSandboxFilesOptions = ClientOverride & {
     events?: SessionEvent[] | undefined;
     /** Initial path to list (workspace root by default). */
     rootPath?: string | undefined;
+    /** Exact capability identity for the selected filesystem route. A route/root
+     * change resets this hook and makes stale provider requests fail retryably. */
+    route?: FileSystemRouteIdentity | undefined;
     /** Hold off the initial list (e.g. panel collapsed). Default true. */
     enabled?: boolean | undefined;
     /** Pause live reads/invalidation while preserving the last rendered result. */

package/dist/hooks/use-workspace-edit.d.ts

@@ -1,3 +1,4 @@
+import type { FileSystemRouteIdentity } from "@opengeni/sdk";
 import { type ClientOverride } from "../provider.js";
 /**
  * The wake-on-edit state machine. This hook owns the logic and the UI renders
@@ -27,6 +28,9 @@ export type UseWorkspaceEditOptions = ClientOverride & {
     path?: string | null | undefined;
     /** The capture-served content loaded into the editor — the flush base (C2). */
     baseContent?: string | null | undefined;
+    /** Exact capability identity for the selected filesystem route. A route/root
+     * change discards the buffered edit and makes stale flushes fail retryably. */
+    route?: FileSystemRouteIdentity | undefined;
     /** `capabilities.liveness` — "warm" | "draining" | "cold". Drives the flush. */
     liveness?: string | undefined;
     /** True while the host is actively warming the box (attach in flight, not warm

package/dist/index.d.ts

@@ -112,6 +112,8 @@ export type { ConfirmState, SlashCommandContext, SlashCommandHandlers, UseSlashC
 export { CommandPalette } from "./components/command-palette.js";
 export type { CommandPaletteProps } from "./components/command-palette.js";
 export { ChatComposer } from "./components/chat-composer.js";
+export { SessionConversation } from "./components/session-conversation.js";
+export type { SessionConversationProps } from "./components/session-conversation.js";
 export type { ChatComposerProps } from "./components/chat-composer.js";
 export { ComposerTranscriptionControl } from "./components/composer-transcription-control.js";
 export type { ComposerTranscriptionControlProps, ComposerTranscriptionMessages, } from "./components/composer-transcription-control.js";
@@ -167,4 +169,5 @@ export type { SuperGrokAccountsClientLike, UseSuperGrokAccountsOptions, UseSuper
 export { gitFileDiffToPatch } from "./lib/git-patch.js";
 export { xtermThemeFromTokens } from "./lib/xterm-theme.js";
 export { cn } from "./lib/cn.js";
-export { CREDIT_EXHAUSTION_MESSAGE, formatBytes, formatClockTime, formatRelativeTime, humanizeFailureReason, isCreditExhaustion, stringifyPayload, truncate, tryParseJson, } from "./lib/format.js";
+export { CREDIT_EXHAUSTION_MESSAGE, formatBytes, formatClockTime, formatRelativeTime, humanizeFailureReason, presentFailure, isCreditExhaustion, stringifyPayload, truncate, tryParseJson, } from "./lib/format.js";
+export { SessionCommandsPanel } from "./components/session-commands-panel.js";