@opengeni/react 6.1.0 → 7.0.0-canary.35625901699001

package/dist/components/markdown.d.ts

@@ -1,4 +1,5 @@
 import { type ReactNode } from "react";
+import { type TimelineSearchTarget } from "./timeline-search.js";
 /**
  * The default renderer for chat message bodies in {@link MessageTimeline}.
  *
@@ -18,6 +19,10 @@ export type MarkdownInteractiveBlock = {
     content: string;
 };
 export type MarkdownProps = {
+    /** Resolve a retained-file reference to the host's authenticated artifact page. */
+    artifactHref?: ((artifactId: string) => string) | undefined;
+    /** Reveals a bounded source excerpt; closing Find retains it until explicit restore. */
+    searchTarget?: TimelineSearchTarget | null | undefined;
     renderImage?: ((image: {
         src: string;
         alt: string;
@@ -56,7 +61,5 @@ export declare function sandboxFileLocationFromHref(href: string | undefined): S
 /** Return the exact decoded path for a supported sandbox-link href. */
 export declare function sandboxFilePathFromHref(href: string | undefined): string | null;
 export declare function retainedImageId(src: string): string | null;
-declare function MarkdownImpl({ children, className, streaming, onSandboxFile, renderInteractiveBlock, renderImage, }: MarkdownProps): import("react").JSX.Element;
 /** Memoized so streaming re-renders of the parent don't re-parse settled bodies. */
-export declare const Markdown: import("react").MemoExoticComponent<typeof MarkdownImpl>;
-export {};
+export declare const Markdown: import("react").MemoExoticComponent<(props: MarkdownProps) => import("react").JSX.Element>;

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

@@ -1,3 +1,4 @@
+import { type TimelineSearchTarget } from "./timeline-search.js";
 import { type GenieLoadingOptions } from "../timeline/genie-loading.js";
 import type { DraftTimelineAnnotation, SessionEvent, SessionStatus } from "@opengeni/sdk";
 import { type ReactNode } from "react";
@@ -5,6 +6,8 @@ import { type OlderHistoryLoader } from "../older-history.js";
 import { type UserMessageDisclosureLabels } from "./user-message-body.js";
 import { type AgentMessageItem, type AuthNeededItem, type TimelineGroup, type TimelineItem, type RetainedArtifactLoader, type RetainedScreenshotLoader, type VideoArtifactPlaybackLoader, type ToolRegistry, type TurnSummaryOptions, type UserMessageItem } from "../timeline/index.js";
 export type MessageTimelineProps = {
+    /** Exact durable search hit; clearing it removes highlighting without moving the reader. */
+    searchTarget?: TimelineSearchTarget | null | undefined;
     /** Localized user-message disclosure actions, including custom UserMessageBody renderers. */
     userMessageDisclosureLabels?: UserMessageDisclosureLabels | undefined;
     /** Raw session events (projected internally) … */
@@ -16,7 +19,9 @@ export type MessageTimelineProps = {
     /** Host-owned controls beside Copy and the timestamp on settled message rows. */
     renderMessageActions?: ((item: AgentMessageItem | UserMessageItem) => ReactNode) | undefined;
     /** Plug a markdown renderer for message bodies (e.g. streamdown). */
-    renderMessageText?: ((text: string, item: AgentMessageItem | UserMessageItem) => ReactNode) | undefined;
+    renderMessageText?: ((text: string, item: AgentMessageItem | UserMessageItem, context: {
+        searchTarget: TimelineSearchTarget | null;
+    }) => ReactNode) | undefined;
     /** Drill into a spawned worker session. */
     onOpenSession?: ((sessionId: string) => void) | undefined;
     /**
@@ -116,7 +121,7 @@ export type MessageTimelineProps = {
  * cards, goal markers, and status transitions. Owns stick-to-bottom scrolling
  * with a "jump to latest" affordance when the reader scrolls back.
  */
-export declare function MessageTimeline({ userMessageDisclosureLabels, events, items, status: _status, renderMessageActions, renderMessageText, onOpenSession, onMemoryClick, onReconnect, renderAuthNeeded, shouldRenderAuthNeeded, resolveProviderLogo, toolRegistry, loadRetainedScreenshot, loadRetainedArtifact, loadVideoArtifactPlayback, computeLabel, genieLoading, turnSummary, autoFollow, onAnnotate, draftAnnotations, onDraftAnnotationSelect, hasOlder, loadingOlder, onLoadOlder, onJumpToStart, loadingOldest, hasNewer, loadingNewer, onLoadNewer, onJumpToLatest, trailingState, emptyState, className, }: MessageTimelineProps): import("react").JSX.Element;
+export declare function MessageTimeline({ userMessageDisclosureLabels, searchTarget, events, items, status: _status, renderMessageActions, renderMessageText, onOpenSession, onMemoryClick, onReconnect, renderAuthNeeded, shouldRenderAuthNeeded, resolveProviderLogo, toolRegistry, loadRetainedScreenshot, loadRetainedArtifact, loadVideoArtifactPlayback, computeLabel, genieLoading, turnSummary, autoFollow, onAnnotate, draftAnnotations, onDraftAnnotationSelect, hasOlder, loadingOlder, onLoadOlder, onJumpToStart, loadingOldest, hasNewer, loadingNewer, onLoadNewer, onJumpToLatest, trailingState, emptyState, className, }: MessageTimelineProps): import("react").JSX.Element;
 /**
  * Settled turns lift the final agent answer out as a sibling group. Include it
  * in "Copy turn" when present so the chip copies the full assistant reply.

package/dist/components/preview-loading.d.ts

@@ -0,0 +1,2 @@
+/** Private loading surface: never receives or executes the unfinished fence. */
+export declare function PreviewLoading(): import("react").JSX.Element;

package/dist/components/session-capability-frame.d.ts

@@ -0,0 +1,24 @@
+import { type ReactNode, type RefObject } from "react";
+export type SessionCapabilityFrameProps = {
+    name: string;
+    subtitle: string;
+    logo: string | null;
+    typeLabel: string;
+    description: string;
+    skill: boolean;
+    expanded: boolean;
+    complete: boolean;
+    actionLabel: string;
+    note: string;
+    onOpen(): void;
+    onClose(): void;
+    busy?: boolean;
+    opener?: RefObject<HTMLButtonElement | null>;
+    cardRef?: RefObject<HTMLElement | null>;
+    children?: ReactNode;
+    /** A catalogue row can own the opener while reusing the same details dialog. */
+    dialogOnly?: boolean;
+};
+/** The same conversation card in the console and embedded clients. Setup
+ * content owns the provider flow; this frame owns identity and protected focus. */
+export declare function SessionCapabilityFrame({ name, subtitle, logo, typeLabel, description, skill, expanded, complete, actionLabel, note, onOpen, onClose, busy, opener, cardRef, children, dialogOnly, }: SessionCapabilityFrameProps): import("react").JSX.Element;

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

@@ -52,7 +52,6 @@ export type SessionChromeAgentsSignal = {
     tone?: SessionChromeSignalTone | undefined;
 };
 export type SessionChromeProps = {
-    compact?: boolean;
     /** Authoritative execution status; omitted by older embedding hosts. */
     sessionStatus?: SessionStatus | undefined;
     queue: UseTurnQueueResult;
@@ -121,5 +120,5 @@ export declare function sessionChromeShouldOfferQueue(input: {
 }): boolean;
 /** Select pill state from the goal's authoritative continuation projection. */
 export declare function sessionChromeGoalPillState(goalStatus: "active" | "paused" | "completed", continuation: SessionGoal["continuation"] | null | undefined, sessionStatus?: SessionStatus): GoalPillState;
-export declare function SessionChrome({ compact, sessionStatus, queue, composer, onComposerFocus, goal, agentsPanel, commandsPanel, commandsCount, agentsSignal, onDismissIncoming, onOpenSession, readOnly, className, active: activeControlled, defaultActive, onActiveChange, }: SessionChromeProps): import("react").JSX.Element | null;
+export declare function SessionChrome({ sessionStatus, queue, composer, onComposerFocus, goal, agentsPanel, commandsPanel, commandsCount, agentsSignal, onDismissIncoming, onOpenSession, readOnly, className, active: activeControlled, defaultActive, onActiveChange, }: SessionChromeProps): import("react").JSX.Element | null;
 export {};

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

@@ -0,0 +1,6 @@
+import { type UseSessionBackgroundCommandsOptions } from "../hooks/use-session-background-commands.js";
+/** Mount in the open activity panel so closed chrome never polls commands. */
+export declare function SessionCommands({ sessionId, readOnly, ...options }: UseSessionBackgroundCommandsOptions & {
+    sessionId: string;
+    readOnly?: boolean;
+}): import("react").JSX.Element;

package/dist/components/session-connection-request.d.ts

@@ -0,0 +1,8 @@
+import type { AuthNeededItem } from "../timeline/types.js";
+import { type SessionMcpCapabilityCardProps } from "./session-mcp-capability-card.js";
+export type SessionConnectionRequestProps = Omit<SessionMcpCapabilityCardProps, "capabilityId" | "name" | "rationale"> & {
+    request: AuthNeededItem;
+};
+/** Resolve native reauthorization notices with the same exact-identity rules
+ * as the console. Recommendations never supply endpoints or account authority. */
+export declare function SessionConnectionRequest(props: SessionConnectionRequestProps): import("react").JSX.Element;

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

@@ -2,9 +2,12 @@ import { type CSSProperties } from "react";
 import { type ClientOverride } from "../session-context.js";
 import { type ChatComposerProps } from "./chat-composer.js";
 import { type HumanInputSurfaceProps } from "./human-input-surface.js";
+import { type MessageTimelineProps } from "./message-timeline.js";
 import type { UserMessageDisclosureLabels } from "./user-message-body.js";
 export type SessionConversationProps = ClientOverride & {
     sessionId: string;
+    /** Host-owned artifact links, previews and other message presentation. */
+    renderMessageText?: MessageTimelineProps["renderMessageText"];
     /** Localized actions for already-sent user-message disclosure. */
     userMessageDisclosureLabels?: UserMessageDisclosureLabels | undefined;
     loadSkillReview?: HumanInputSurfaceProps["loadSkillReview"];

package/dist/components/session-mcp-capability-card.d.ts

@@ -0,0 +1,22 @@
+import type { OpenGeniBrowserClient as OpenGeniClient } from "@opengeni/sdk/browser";
+export type SessionMcpCapabilityCardProps = {
+    client: OpenGeniClient;
+    workspaceId: string;
+    sessionId: string;
+    capabilityId: string;
+    name: string;
+    rationale?: string;
+    /** Exact host route; no console-specific routing is assumed. */
+    returnUrl: string;
+    onConfigured?: (() => void | Promise<void>) | undefined;
+};
+export type McpConnectionCardProps = Omit<SessionMcpCapabilityCardProps, "sessionId"> & {
+    /** Omit for connection management: no session tool selection is written. */
+    sessionId?: string;
+    dialogOnly?: boolean;
+    onClose?: (() => void) | undefined;
+};
+/** Native OAuth recommendation flow. Identity and endpoint come from the live
+ * catalog, never from model-authored recommendation text. */
+export declare function SessionMcpCapabilityCard(props: SessionMcpCapabilityCardProps): import("react").JSX.Element;
+export declare function McpConnectionCard(props: McpConnectionCardProps): import("react").JSX.Element;

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

@@ -0,0 +1,34 @@
+import { type RefObject } from "react";
+import type { TimelineItem } from "../timeline/types.js";
+export type TimelineSearchTarget = {
+    sequence: number;
+    eventId?: string | undefined;
+    /** Literal, case-insensitive text. No regex interpretation. */
+    query: string;
+    /** Zero-based occurrence within the source message. Defaults to zero. */
+    occurrence?: number | undefined;
+    /**
+     * Zero-based UTF-16 offset of the match in the original message text, as
+     * reported by backend all-occurrence search (messageMatchOffset). When set
+     * it takes precedence over `occurrence` and is validated against `query`,
+     * so a stale offset degrades to no highlight rather than a wrong one.
+     */
+    offset?: number | undefined;
+};
+/** Scoped to the target's group; disclosure expansion persists after closing find. */
+export declare const TimelineSearchRevealContext: import("react").Context<string | null>;
+export declare const useTimelineSearchReveal: () => string | null;
+export declare function isTimelineSearchTarget(item: TimelineItem, target: TimelineSearchTarget): boolean;
+/** Scan without allocating an offset array proportional to a huge message. */
+export declare function literalSearchOffset(text: string, query: string, occurrence?: number): number;
+/**
+ * Validate a caller-supplied UTF-16 offset against the text and query. The
+ * sticky flag pins the match to exactly `offset`; like literalSearchOffset,
+ * regex escaping keeps offsets in UTF-16 units even for length-changing case
+ * folds. Returns -1 when the offset is stale or the text no longer matches.
+ */
+export declare function matchAtOffset(text: string, query: string, offset: number): number;
+/** Resolve a target to a UTF-16 offset: explicit offset wins, else the ordinal scan. */
+export declare function searchMatchOffset(text: string, target: TimelineSearchTarget): number;
+/** Range highlighting does not mutate React-owned text or its layout. */
+export declare function useTimelineSearchNavigation(root: RefObject<HTMLDivElement | null>, itemId: string | undefined, target: TimelineSearchTarget | null | undefined, releasePin: () => void, revision: unknown): void;

package/dist/composer.js

@@ -1,6 +1,6 @@
 import {
   ModelPolicyPickerMenu
-} from "./chunk-UMECRJRV.js";
+} from "./chunk-HJ5VJ4JB.js";
 import {
   Actions,
   AttachButton,
@@ -40,8 +40,8 @@ import {
   useChatComposer,
   useChatComposerController,
   useVoiceInput
-} from "./chunk-45XEUVTK.js";
-import "./chunk-HQV2I5HV.js";
+} from "./chunk-UXE5SSNN.js";
+import "./chunk-BRM6FVZA.js";
 import {
   BillingClassMark,
   ModelPolicyPicker,
@@ -49,13 +49,13 @@ import {
   PickerBackHeader,
   PickerNavRow,
   defaultModelPolicyPickerMessages
-} from "./chunk-R4KRSFGA.js";
+} from "./chunk-IP4BUBKH.js";
 import "./chunk-VZTQ73XT.js";
-import "./chunk-NYESIADM.js";
-import "./chunk-PLYRL5ER.js";
+import "./chunk-AKOMC3VO.js";
 import "./chunk-KZ73RL76.js";
+import "./chunk-PLYRL5ER.js";
 import "./chunk-NEXLLTP4.js";
-import "./chunk-VRBL3F5E.js";
+import "./chunk-5GAL23FF.js";
 import "./chunk-22KP6LR5.js";
 export {
   Actions,

package/dist/connect-account-identity.d.ts

@@ -0,0 +1,8 @@
+import type { ConnectAccount } from "@opengeni/connect";
+import type { CapabilityCatalogItem, OpenGeniClient } from "@opengeni/sdk";
+/** Service presentation never changes which exact credential is acted on. */
+export declare function ConnectAccountIdentity({ account, client, capabilities, }: {
+    account: ConnectAccount;
+    client?: OpenGeniClient | undefined;
+    capabilities: CapabilityCatalogItem[];
+}): import("react").JSX.Element;

package/dist/connect-accounts.d.ts

@@ -1,9 +1,14 @@
 import type { ConnectController } from "@opengeni/connect";
+import type { OpenGeniClient } from "@opengeni/sdk";
 export type ConnectAccountsProps = {
     controller: ConnectController;
     className?: string;
     /** Enables explicit account-bound reconnect. Host supplies the exact destination. */
     returnUrl?: string;
+    /** Uses authenticated catalogue assets and exact connection references for service identity. */
+    client?: OpenGeniClient | undefined;
+    /** Reconcile surrounding service state after a confirmed account disconnect. */
+    onDisconnected?: (() => void) | undefined;
 };
 /** Local credential revocation only. Unknown or changed versions must be
  * refreshed; this component never retries a destructive operation implicitly. */

package/dist/connect-chooser.d.ts

@@ -5,6 +5,12 @@ export type ConnectChooserProps = {
     returnUrl: string;
     className?: string;
     presentation?: "select" | "catalog";
+    /** Compact mechanism picker when service discovery is already shown by the host. */
+    customOnly?: boolean;
+    providerOnly?: boolean;
+    compact?: boolean;
+    /** Select a service from the unified discovery list. */
+    initialProviderId?: string;
 };
 /** Catalog readiness is supplied by the authenticated backend, never inferred
  * from the existence of a provider definition. Host replaces the controller on

package/dist/connect-panel.d.ts

@@ -1,11 +1,18 @@
 import { type ConnectSetupProps } from "./connect-setup.js";
+import type { OpenGeniClient } from "@opengeni/sdk";
 export type ConnectPanelProps = ConnectSetupProps & {
     returnUrl: string;
-    title?: string;
+    /** Null omits the heading when the host already supplies one. */
+    title?: string | null;
     showAccounts?: boolean;
+    /** Presentation only; the host backend owns acquisition admission. */
+    showCustomConnections?: boolean;
+    /** Include ready, non-custom adapters from the host's Connect catalogue. */
+    showProviderConnections?: boolean;
     presentation?: "select" | "catalog";
+    client?: OpenGeniClient | undefined;
 };
 /** Optional composition over the same unstyled surfaces. Import
  * @opengeni/react/connect.css for styling; the host retains navigation,
  * transport, actor admission, and controller lifetime. */
-export declare function ConnectPanel({ returnUrl, title, showAccounts, presentation, className, ...setup }: ConnectPanelProps): import("react").JSX.Element;
+export declare function ConnectPanel({ returnUrl, title, showAccounts, showCustomConnections, showProviderConnections, presentation, className, client, ...setup }: ConnectPanelProps): import("react").JSX.Element;

package/dist/connect-setup.d.ts

@@ -3,10 +3,14 @@ export type ConnectSetupProps = {
     controller: ConnectController;
     /** Called synchronously in the click handler so a host can open a popup. */
     onAuthorize: (attempt: ConnectAttempt) => void | Promise<unknown>;
+    /** Called synchronously on Continue; hosts can reserve a popup before advancing. */
+    onSelectAccount?: (accountId: string) => void | Promise<unknown>;
     /** Host pagination must retain selections across pages and submit the final set. */
     onBrowseResources?: (attempt: ConnectAttempt) => void | Promise<unknown>;
     className?: string;
+    /** Provider-specific label supplied by the embedding host. */
+    authorizeLabel?: string | undefined;
 };
-/** Unstyled setup surface. No provider secrets enter React state. Host owns
+/** Controller-backed setup surface, styled by opt-in connect.css. No provider secrets enter React state. Host owns
  * chooser, controller lifetime, navigation and recovery after full redirect. */
 export declare function ConnectSetup(props: ConnectSetupProps): import("react").JSX.Element;

package/dist/connect.d.ts

@@ -1,37 +1,21 @@
+export { useConnect } from "./hooks/use-connect.js";
+export { CapabilityCatalogRow, CapabilityCatalogIndicator, type CapabilityCatalogRowProps, type CapabilityCatalogStatus, } from "./capability-catalog-row.js";
 export { SkillDiscovery, type SkillDiscoveryProps, type SkillDiscoveryClient, type SkillDiscoveryItem, type SkillDiscoveryPage, } from "./skill-discovery.js";
-import type { ConnectController } from "@opengeni/connect";
 export { ConnectSetup, type ConnectSetupProps } from "./connect-setup.js";
 export { ConnectChooser, type ConnectChooserProps } from "./connect-chooser.js";
 export { ConnectAccounts, type ConnectAccountsProps } from "./connect-accounts.js";
 export { ConnectPanel, type ConnectPanelProps } from "./connect-panel.js";
+export { ConnectionDiscovery, type ConnectionDiscoveryProps } from "./connection-discovery.js";
+export { McpConnectionCard, type McpConnectionCardProps, } from "./components/session-mcp-capability-card.js";
 export { DeviceAuthorization, type DeviceAuthorizationProps } from "./device-authorization.js";
 export { IdentityLinkConsent, type IdentityLinkClient, type IdentityLinkConsentProps, } from "./identity-link-consent.js";
 export { IdentityLinkAccounts, type IdentityLinkAccountsClient } from "./identity-link-accounts.js";
 export type { ConnectSnapshot } from "@opengeni/connect";
 export type { ConnectAccount, ConnectAdvance, ConnectAttempt, ConnectNextAction, ConnectOwnership, ConnectProvider, ConnectResource, ConnectTransport, } from "@opengeni/connect";
-export declare function useConnect(controller: ConnectController): {
-    attempt: import("@opengeni/connect").ConnectAttempt | null;
-    busy: boolean;
-    error: Error | null;
-    begin: (input: {
-        providerId: string;
-        ownership: import("@opengeni/connect").ConnectOwnership;
-        returnUrl: string;
-        idempotencyKey: string;
-        reconnectAccountId?: string;
-        installationTarget?: import("@opengeni/connect").ConnectInstallationTarget;
-    }) => Promise<import("@opengeni/connect").ConnectAttempt>;
-    recover: (attemptId: string) => Promise<import("@opengeni/connect").ConnectAttempt>;
-    refresh: () => Promise<import("@opengeni/connect").ConnectAttempt>;
-    waitForAction: (options?: {
-        timeoutMs?: number;
-    }) => Promise<import("@opengeni/connect").ConnectAttempt>;
-    advance: (action: import("@opengeni/connect").ConnectAdvance, idempotencyKey: string) => Promise<import("@opengeni/connect").ConnectAttempt>;
-    cancel: (idempotencyKey: string) => Promise<import("@opengeni/connect").ConnectAttempt>;
-};
 export { ConnectionCatalog, ConnectionServiceRow, ConnectionOptionRow, type ConnectionCatalogProps, type ConnectionCatalogService, type ConnectionCatalogOption, } from "./connection-catalog.js";
 export { ConnectionInstalled, type ConnectionInstalledItem } from "./connection-installed.js";
 export { ConnectionTypePicker, type ConnectionType } from "./connection-type-picker.js";
 export { ConnectionLogo } from "./connection-logo.js";
+export { capabilityLogoFallback } from "./capability-logo-fallback.js";
 export { PluginDiscovery, type PluginDiscoveryProps } from "./plugin-discovery.js";
 export { PluginDetails } from "./plugin-details.js";