@opengeni/react 3.3.2 → 3.4.0

package/dist/components/chat-composer.d.ts

@@ -1,15 +1,25 @@
 import type { ClientModel, EffectiveSessionControl } from "@opengeni/sdk";
-import type { ClipboardEvent, ReactNode } from "react";
+import { type ClipboardEvent, type ComponentProps, type ReactNode, type Ref } from "react";
 import type { SlashCommand } from "../commands/types.js";
 import type { ComposerState } from "../hooks/use-composer.js";
 import type { UseFileAttachmentsResult } from "../hooks/use-file-attachments.js";
 import type { SlashCommandContext } from "../hooks/use-slash-commands.js";
 import { OPEN_WORKSTREAM_CONTROL_EVENT } from "../workstream-control-event.js";
-import { type ChatComposerMessages, type ComposerControlLinks, type ResponsiveBasis } from "./composer.js";
+import { Input, type ChatComposerMessages, type ComposerControlLinks, type ComposerRunControl, type ResponsiveBasis } from "./composer.js";
 import { type ComposerTranscriptionControlProps } from "./composer-transcription-control.js";
 export { OPEN_WORKSTREAM_CONTROL_EVENT };
 export type ChatComposerProps = {
     composer: ComposerState;
+    /** Replace only the normal footer, inside the shared composer context.
+     * Confirmation, drafts, annotations and attachments remain native. */
+    footer?: ReactNode;
+    focusRef?: Ref<{
+        focusInput: () => void;
+    }>;
+    inputProps?: ComponentProps<typeof Input> & {
+        [attribute: `data-${string}`]: string | number | boolean | undefined;
+    };
+    surfaceClassName?: string;
     /**
      * Measurement surface for responsive chrome. Defaults to the historical
      * viewport breakpoints; opt into `container` for narrow embedded panels.
@@ -58,10 +68,18 @@ export type ChatComposerProps = {
     onClearView?: (() => void) | undefined;
     /** Partial overrides for all composer-owned visible and accessible copy. */
     messages?: Partial<ChatComposerMessages> | undefined;
+    /**
+     * Run control: `pause` (default) shows the workstream Pause control and
+     * paused strip; `stop` shows Stop only while `running`, and the next message
+     * continues a stopped conversation; `none` shows neither.
+     */
+    runControl?: ComposerRunControl | undefined;
+    /** A response is in progress (drives the Stop control). */
+    running?: boolean | undefined;
 };
 /**
  * Batteries-included chat composer. This preset is assembled exclusively from
  * the public controller and compound primitives exported by the composer
  * subpath, so custom and default layouts share one behavioral implementation.
  */
-export declare function ChatComposer({ composer, responsiveBasis, effectiveControl, queuedAheadCount, canControlWorkspace, controlLinks, placeholder, disabled, autoFocus, hint, controlsLeading, controlsStart, actionsStart, attachButtonClassName, transcription, transcriptionClassName, transcriptionSuppressed, header, onPaste, attachments, models, selectedModel, onSelectModel, className, commands, commandContext, onClearView, messages, }: ChatComposerProps): import("react").JSX.Element;
+export declare function ChatComposer({ composer, responsiveBasis, effectiveControl, queuedAheadCount, canControlWorkspace, controlLinks, placeholder, disabled, autoFocus, hint, controlsLeading, controlsStart, actionsStart, attachButtonClassName, transcription, transcriptionClassName, transcriptionSuppressed, header, onPaste, attachments, models, selectedModel, onSelectModel, className, commands, commandContext, onClearView, messages, footer, focusRef, inputProps, surfaceClassName, runControl, running, }: ChatComposerProps): import("react").JSX.Element;

package/dist/components/child-session-link.d.ts

@@ -0,0 +1,9 @@
+import type { MachineInputMember } from "../timeline/types.js";
+/**
+ * Source IDs are routing coordinates only for typed agent updates (child
+ * lifecycle notices, agent messages, and agent directions), never parsed from
+ * prose.
+ */
+export declare function ChildSessionLink({ kind, sourceId, onOpenSession, }: Pick<MachineInputMember, "kind" | "sourceId"> & {
+    onOpenSession?: ((sessionId: string) => void) | undefined;
+}): import("react").JSX.Element | null;

package/dist/components/claude-mark.d.ts

@@ -0,0 +1,3 @@
+import type { SVGProps } from "react";
+/** ClaudeMark: Simple Icons, CC0; https://github.com/simple-icons/simple-icons */
+export declare function ClaudeMark(props: SVGProps<SVGSVGElement>): import("react").JSX.Element;

package/dist/components/code-editor.d.ts

@@ -1,8 +1,6 @@
 import { type ReactNode } from "react";
-/** Language grammar loaders, keyed by the extension class we infer from the path. */
-declare const LANGUAGE_LOADERS: Record<string, () => Promise<unknown>>;
 /** Map a filename to a grammar key (or null for plain text — still fully editable). */
-export declare function languageForPath(path: string): keyof typeof LANGUAGE_LOADERS | null;
+export declare function languageForPath(path: string): string | null;
 export type CodeEditorProps = {
     /** Workspace-relative path — drives language inference (and the save target upstream). */
     path: string;
@@ -62,4 +60,3 @@ export declare function reconcileEditorBuffer(current: EditorBufferState, incomi
  * be saved back (which would corrupt it by writing the truncated prefix).
  */
 export declare function CodeEditor({ path, initialContents, onSave, onOverwrite, onReload, onEditIntent, readOnly, themeType, loading, fallback, className, }: CodeEditorProps): import("react").JSX.Element;
-export {};

package/dist/components/composer-transcription-control.d.ts

@@ -5,6 +5,10 @@ export type ComposerTranscriptionMessages = {
     stop: string;
     cancel: string;
     retry: string;
+    /** Transcribe a recording that was stopped without transcribing or recovered. */
+    transcribeSaved: string;
+    /** Shown near the automatic stop; `{seconds}` is replaced. */
+    timeRemaining: string;
     pauseRetrying: string;
     requestingPermission: string;
     recording: string;
@@ -20,6 +24,9 @@ export type ComposerTranscriptionMessages = {
     errorPermissionDenied: string;
     errorNotSupported: string;
     errorUnavailable: string;
+    errorInsufficientCredits: string;
+    errorAllowanceExhausted: string;
+    errorPolicyBlocked: string;
     errorTooLarge: string;
     errorInvalidAudio: string;
     errorStorageUnavailable: string;

package/dist/components/composer.d.ts

@@ -5,83 +5,32 @@ import type { ComposerState } from "../hooks/use-composer.js";
 import type { UseFileAttachmentsResult } from "../hooks/use-file-attachments.js";
 import { type ConfirmState, type SlashCommandContext } from "../hooks/use-slash-commands.js";
 import { type ResponsiveBasis } from "../lib/composer-responsive-context.js";
+import { type ChatComposerMessages } from "../composer-messages.js";
 import type { PickerModelRow } from "../model-policy.js";
 import { OPEN_WORKSTREAM_CONTROL_EVENT } from "../workstream-control-event.js";
 export { OPEN_WORKSTREAM_CONTROL_EVENT };
 export type { ResponsiveBasis } from "../lib/composer-responsive-context.js";
-export type ComposerDelivery = Pick<ComposerState, "value" | "setValue" | "send" | "steer" | "sending" | "canSend" | "error" | "clearError">;
+export type ComposerDelivery = Pick<ComposerState, "value" | "setValue" | "send" | "steer" | "sending" | "canSend" | "error" | "clearError" | "annotations" | "requestAnnotationReview">;
 export type ComposerDraftState = Pick<ComposerState, "draftConflict" | "draftSaving" | "resolveDraftConflict" | "restoredResources" | "removeRestoredResource">;
 export type ComposerControlState = Pick<ComposerState, "pause" | "pausing" | "resume" | "resumeScope" | "resuming">;
 export type ComposerControlLinks = {
     workspaceHref?: string | undefined;
     sessionHref?: ((sessionId: string) => string) | undefined;
 };
-export type ChatComposerMessages = {
-    messagePlaceholder: string;
-    pausedPlaceholder: string;
-    inputLabel: string;
-    keyboardHint: string;
-    slashCommandBlocked: string;
-    controlChangedError: string;
-    sendFailedError: string;
-    dropFiles: string;
-    attachFiles: string;
-    pauseAriaLabel: string;
-    pauseTitle: string;
-    sendMessageAriaLabel: string;
-    sendAndResumeAriaLabel: string;
-    sendTitle: string;
-    sendAndResumeTitle: string;
-    workspacePaused: string;
-    pausedHere: string;
-    parentBlocker: string;
-    narrowerPause: string;
-    pausedBy: (displayName: string) => string;
-    queuedAhead: (count: number) => string;
-    resumingAndSending: string;
-    nextMessageResumes: string;
-    resumeThisWorkstream: string;
-    resumeShort: string;
-    hidePauseDetails: string;
-    showPauseDetails: string;
-    pauseReasonsLabel: string;
-    pausedByLabel: string;
-    alsoPausedByLabel: string;
-    resumeWorkspace: string;
-    resumeFromSession: string;
-    sessionCanRun: string;
-    stillPausedBy: (displayName: string) => string;
-    restoredResourcesLabel: string;
-    restoredFile: (fileId: string) => string;
-    removeRestoredResource: (index: number) => string;
-    uploading: string;
-    uploadFailed: string;
-    previewAttachment: (name: string) => string;
-    attachmentPreviewLabel: string;
-    downloadAttachment: (name: string) => string;
-    closeAttachmentPreview: string;
-    retryAttachment: (name: string) => string;
-    retryUpload: string;
-    removeAttachment: (name: string) => string;
-    confirmCommand: (name: string) => string;
-    confirmDescription: (command: SlashCommand) => string;
-    cancel: string;
-    runCommand: (name: string) => string;
-    commands: string;
-    slashCommandsLabel: string;
-    modelLabel: string;
-    close: string;
-    danger: string;
-    draftConflict: string;
-    useOtherDraft: string;
-    keepMine: string;
-    savingDraft: string;
-    formatBytes: (bytes: number) => string;
-    formatRelativeTime: (changedAt: string) => string;
-};
-export declare const defaultChatComposerMessages: ChatComposerMessages;
+export { defaultChatComposerMessages } from "../composer-messages.js";
+export type { ChatComposerMessages } from "../composer-messages.js";
 export type ComposerSubmitMode = "queue" | "steer";
-export type ComposerSubmitBlocker = "disabled" | "attachment" | "sending" | "command" | "empty" | null;
+export type ComposerSubmitBlocker = "disabled" | "attachment" | "sending" | "command" | "annotations" | "empty" | null;
+/**
+ * How the composer offers run control.
+ * - `pause`: the workstream Pause control and paused-state strip (default; the
+ *   Opengeni console).
+ * - `stop`: a Stop control only while a response runs. Stopping pauses this
+ *   conversation; the next message continues it, so people never see a paused
+ *   state they have to resume. Pauses applied elsewhere still show.
+ * - `none`: no run control.
+ */
+export type ComposerRunControl = "pause" | "stop" | "none";
 export type UseChatComposerControllerOptions = {
     delivery: ComposerDelivery;
     draft?: ComposerDraftState | undefined;
@@ -97,6 +46,10 @@ export type UseChatComposerControllerOptions = {
     onClearView?: (() => void) | undefined;
     onPaste?: ((event: ClipboardEvent<HTMLTextAreaElement>) => void) | undefined;
     messages?: Partial<ChatComposerMessages> | undefined;
+    /** Run control presentation. Defaults to `pause`. */
+    runControl?: ComposerRunControl | undefined;
+    /** A response is in progress; shows the Stop control under `runControl="stop"`. */
+    running?: boolean | undefined;
 };
 /**
  * Autosize a composer textarea up to `maxPx`. Never writes intermediate
@@ -111,7 +64,7 @@ export declare function applyComposerTextareaHeight(textarea: HTMLTextAreaElemen
  * delivery guards, keyboard routing, command interception, drag/drop, focus,
  * confirmation, and feedback state used by both the preset and primitives.
  */
-export declare function useChatComposerController({ delivery, draft, control, effectiveControl, queuedAheadCount, canControlWorkspace, controlLinks, disabled, attachments, commands, commandContext, onClearView, onPaste, messages: messageOverrides, }: UseChatComposerControllerOptions): {
+export declare function useChatComposerController({ delivery, draft, control, effectiveControl, queuedAheadCount, canControlWorkspace, controlLinks, disabled, attachments, commands, commandContext, onClearView, onPaste, messages: messageOverrides, runControl, running, }: UseChatComposerControllerOptions): {
     id: string;
     rootRef: RefObject<HTMLDivElement | null>;
     textareaRef: RefObject<HTMLTextAreaElement | null>;
@@ -136,10 +89,13 @@ export declare function useChatComposerController({ delivery, draft, control, ef
         attachFiles: string;
         pauseAriaLabel: string;
         pauseTitle: string;
+        stopAriaLabel?: string | undefined;
+        stopTitle?: string | undefined;
         sendMessageAriaLabel: string;
         sendAndResumeAriaLabel: string;
         sendTitle: string;
         sendAndResumeTitle: string;
+        annotationNotesRequired: string;
         workspacePaused: string;
         pausedHere: string;
         parentBlocker: string;
@@ -165,6 +121,7 @@ export declare function useChatComposerController({ delivery, draft, control, ef
         uploading: string;
         uploadFailed: string;
         previewAttachment: (name: string) => string;
+        previewUnavailable?: string | undefined;
         attachmentPreviewLabel: string;
         downloadAttachment: (name: string) => string;
         closeAttachmentPreview: string;
@@ -197,9 +154,12 @@ export declare function useChatComposerController({ delivery, draft, control, ef
     removeRestoredResource: ((index: number) => void) | undefined;
     resolveDraftConflict: ((choice: "keep_mine" | "use_remote") => Promise<void>) | undefined;
     hasControl: boolean;
+    runControl: ComposerRunControl;
+    running: boolean;
     pausing: boolean;
     resuming: boolean;
     pause: (reason?: string) => Promise<boolean>;
+    stop: () => Promise<boolean>;
     resume: (reason?: string) => Promise<boolean>;
     resumeScope: (option: EffectiveSessionControl["resumeOptions"][number]) => Promise<boolean>;
     paused: boolean;
@@ -301,6 +261,13 @@ export type ComposerModelPickerProps = {
 export declare function ModelPicker({ models, rows, value, onChange, label, className, codexOnly, }: ComposerModelPickerProps): import("react").JSX.Element;
 export type ComposerPauseButtonProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, OwnedButtonProps>;
 export declare const PauseButton: import("react").ForwardRefExoticComponent<ComposerPauseButtonProps & import("react").RefAttributes<HTMLButtonElement>>;
+export type ComposerStopButtonProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, OwnedButtonProps>;
+/**
+ * Stop the running response. Rendered only under `runControl="stop"` while a
+ * response runs; stopping pauses this conversation and the next message
+ * continues it.
+ */
+export declare const StopButton: import("react").ForwardRefExoticComponent<ComposerStopButtonProps & import("react").RefAttributes<HTMLButtonElement>>;
 export type ComposerSendButtonProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, OwnedButtonProps>;
 export declare const SendButton: import("react").ForwardRefExoticComponent<ComposerSendButtonProps & import("react").RefAttributes<HTMLButtonElement>>;
 export declare function Help(): import("react").JSX.Element;

package/dist/components/computer-viewer.d.ts

@@ -6,7 +6,7 @@ export type ComputerViewerNotification = {
     message: string;
 };
 export type ComputerViewerProps = EmbeddedComputerInteractionClientOverride & {
-    /** Selected OpenGeni agent/session. Peer ComputerSessions remain visible. */
+    /** Selected Opengeni agent/session. Peer ComputerSessions remain visible. */
     sessionId: string;
     enabled?: boolean | undefined;
     className?: string | undefined;

package/dist/components/copy-button.d.ts

@@ -14,8 +14,10 @@ export type CopyButtonProps = {
 /**
  * Ghost icon copy control — no chrome box, no "Copy code" label.
  * Copy → check flash. Hover-reveal via `group/copy` on a parent.
+ * Keep unchanged controls out of parent message rerenders: mounting history
+ * already has to commit each new tooltip, without redoing the retained suffix.
  */
-export declare function CopyButton({ text, label, className, reveal, }: CopyButtonProps): import("react").JSX.Element;
+export declare const CopyButton: import("react").MemoExoticComponent<({ text, label, className, reveal, }: CopyButtonProps) => import("react").JSX.Element>;
 /** Hover-reveal chrome around a message / turn so {@link CopyButton} can fade in. */
 export declare function CopyHoverFrame({ children, className, copyText, label, align, trailing, }: {
     children: ReactNode;

package/dist/components/desktop-viewer.d.ts

@@ -15,7 +15,7 @@ export type DesktopViewerProps = {
     /** Render the built-in Watching ⇄ Take control toggle (default true). */
     showControlToggle?: boolean | undefined;
     scaleViewport?: boolean | undefined;
-    /** Custom RFB factory (tests / a WebRTC swap). Defaults to lazy @novnc/novnc. */
+    /** Custom RFB factory; otherwise enableDesktopViewer() supplies lazy noVNC. */
     rfbFactory?: DesktopRfbFactory | undefined;
     /** Authenticated controller protocols for proxied RFB transports. */
     webSocketProtocols?: string[] | undefined;

package/dist/components/grok-mark.d.ts

@@ -0,0 +1,26 @@
+import type { SVGProps } from "react";
+/**
+ * MIT License
+ *
+ * Copyright (c) 2023 LobeHub
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ * Source: https://raw.githubusercontent.com/lobehub/lobe-icons/master/src/Grok/components/Mono.tsx
+ */
+export declare function GrokMark(props: SVGProps<SVGSVGElement>): import("react").JSX.Element;

package/dist/components/human-input-form.d.ts

@@ -1,33 +1,10 @@
-import type { HumanInputAnswer, HumanInputQuestion, SessionHumanInputRequest, SubmitHumanInputResponseRequest } from "@opengeni/sdk";
+import type { HumanInputQuestion, HumanInputSecretSaveTo, SkillRecord, SessionHumanInputRequest, SubmitHumanInputResponseRequest } from "@opengeni/sdk";
 import { type ReactNode } from "react";
-export type HumanInputAnswerDraft = {
-    values: string[];
-    other: string;
-    otherSelected: boolean;
-};
-export type HumanInputFormMessages = {
-    title: string;
-    description: string;
-    submit: string;
-    skip: string;
-    submitting: string;
-    other: string;
-    deadlineLabel: string;
-    formatDeadline: (value: string) => string;
-    required: string;
-    otherRequired: string;
-    minSelections: (count: number) => string;
-    maxSelections: (count: number) => string;
-    optional: string;
-    /** Shown when the question list overflows the card and more content is below. */
-    moreBelow: string;
-    questionCount: (count: number) => string;
-    collapse: string;
-    expand: string;
-    selectionHint: (min: number | null | undefined, max: number | null | undefined) => string | null;
-};
-export declare const defaultHumanInputFormMessages: HumanInputFormMessages;
+import { answersFromDrafts, defaultHumanInputFormMessages, type HumanInputAnswerDraft, type HumanInputFormMessages } from "../human-input-model.js";
+export { answersFromDrafts, defaultHumanInputFormMessages, type HumanInputAnswerDraft, type HumanInputFormMessages, };
 export type HumanInputFormProps = {
+    /** Scoped immutable revision reader. Saving a Skill fails closed without its full preview. */
+    loadSkillReview?: ((reference: NonNullable<HumanInputQuestion["skillReview"]>) => Promise<SkillRecord>) | undefined;
     request: Pick<SessionHumanInputRequest, "id" | "questions" | "allowSkip" | "expiresAt">;
     onSubmit: (response: SubmitHumanInputResponseRequest) => void | Promise<void>;
     submitting?: boolean | undefined;
@@ -42,6 +19,18 @@ export type HumanInputFormProps = {
     autoFocus?: boolean | undefined;
     /** Start collapsed to a compact bar (drafts still retained). */
     defaultCollapsed?: boolean | undefined;
+    /**
+     * Answer a yes/no decision (one required choice between an accept and a
+     * decline option, without Other) with two buttons instead of a radio list.
+     * Off by default; embedded conversations turn it on.
+     */
+    decisionButtons?: boolean | undefined;
+    /**
+     * Where this person may save an answer to a secret question. A request for
+     * a target outside this list falls back to the most private allowed one,
+     * with a note. Defaults to Only me, This task and This workspace.
+     */
+    allowedSaveTo?: readonly HumanInputSecretSaveTo[] | undefined;
     className?: string | undefined;
 };
 /**
@@ -51,7 +40,14 @@ export type HumanInputFormProps = {
  * use `useHumanInputRequests` headlessly.
  */
 export declare function HumanInputForm(props: HumanInputFormProps): import("react").JSX.Element;
-export declare function answersFromDrafts(questions: HumanInputQuestion[], drafts: Record<string, HumanInputAnswerDraft>, messageOverrides?: Partial<HumanInputFormMessages>): {
-    answers: HumanInputAnswer[];
-    errors: Record<string, string>;
-};
+/**
+ * A yes/no decision (an approval asked as a question): one required
+ * single-choice question with exactly an accept and a decline option. It is
+ * answered with two buttons; an "Other" free-text answer has no meaning for it,
+ * and the composer still accepts a different instruction.
+ */
+export declare function binaryDecision(questions: readonly HumanInputQuestion[]): {
+    question: HumanInputQuestion;
+    accept: HumanInputQuestion["options"][number];
+    decline: HumanInputQuestion["options"][number];
+} | null;

package/dist/components/human-input-surface.d.ts

@@ -1,6 +1,7 @@
 import type { SessionHumanInputRequest, SubmitHumanInputResponseRequest } from "@opengeni/sdk";
-import { type HumanInputFormMessages } from "./human-input-form.js";
+import { type HumanInputFormMessages, type HumanInputFormProps } from "./human-input-form.js";
 export type HumanInputSurfaceProps = {
+    loadSkillReview?: HumanInputFormProps["loadSkillReview"];
     requests: SessionHumanInputRequest[];
     onSubmit: (requestId: string, response: SubmitHumanInputResponseRequest) => void | Promise<void>;
     respondingRequestId?: string | null | undefined;
@@ -9,6 +10,10 @@ export type HumanInputSurfaceProps = {
     className?: string | undefined;
     /** Forwarded to the active form. Defaults true. */
     autoFocus?: boolean | undefined;
+    /** Forwarded to the active form: yes/no decisions as two buttons. */
+    decisionButtons?: boolean | undefined;
+    /** Forwarded to the active form: where secret answers may be saved. */
+    allowedSaveTo?: HumanInputFormProps["allowedSaveTo"];
 };
 /**
  * One decision shell for pending structured human-input requests. Parallel
@@ -16,4 +21,4 @@ export type HumanInputSurfaceProps = {
  * settles the active request and the next remaining set advances automatically
  * when the authoritative pending list updates.
  */
-export declare function HumanInputSurface({ requests, onSubmit, respondingRequestId, error, messages, className, autoFocus, }: HumanInputSurfaceProps): import("react").JSX.Element | null;
+export declare function HumanInputSurface({ requests, onSubmit, loadSkillReview, respondingRequestId, error, messages, className, autoFocus, decisionButtons, allowedSaveTo, }: HumanInputSurfaceProps): import("react").JSX.Element | null;

package/dist/components/linkified-text.d.ts

@@ -0,0 +1,18 @@
+import { type ReactNode } from "react";
+export declare const LINKIFIED_LINK_CLASS = "font-medium og-link [overflow-wrap:anywhere]";
+type Segment = {
+    kind: "text";
+    value: string;
+} | {
+    kind: "link";
+    value: string;
+};
+/** Split plain text into text and bare http(s) URL segments. */
+export declare function linkifySegments(text: string): Segment[];
+/**
+ * Render plain text with bare http(s) URLs as links that open in a new tab and
+ * wrap anywhere, so a long sign-in or approval URL stays clickable and inside
+ * its card. Non-string nodes pass through unchanged.
+ */
+export declare function linkifyText(node: ReactNode): ReactNode;
+export {};

package/dist/components/machine-input-display.d.ts

@@ -1,12 +1,33 @@
+import { type AgentTitleParts } from "../timeline/platform-activity-presentation.js";
 import type { MachineInputMember } from "../timeline/types.js";
 export declare const MACHINE_INPUT_META: Record<MachineInputMember["kind"], string>;
 /**
  * Collapsed landmark label for a coalesced machine-input batch.
  * Same-kind batches get a natural plural; mixed kinds stay short.
+ * When every agent update's sender has a known title, the label names them
+ * ("Update from Release audit", "3 updates from Audit and Flake · Wait ended").
  */
-export declare function machineInputBatchLabel(members: readonly MachineInputMember[]): string;
+export declare function machineInputBatchLabel(members: readonly MachineInputMember[], titleFor?: ((sessionId: string) => string | null) | undefined): string;
 /** Strip protocol prefixes and worker/session UUIDs from display summaries. */
 export declare function cleanMachineInputSummary(summary: string): string;
 export declare function readableMachineInputSource(sourceId: string): string | null;
 /** True when a cleaned single-member summary adds meaning beyond the pill label. */
 export declare function machineInputSummaryIsUseful(kind: MachineInputMember["kind"], cleanedSummary: string): boolean;
+/** Members sent by (or about) another agent session. */
+export declare function isAgentMember(member: Pick<MachineInputMember, "kind">): boolean;
+/** The agent session a member came from; only typed UUID sources route. */
+export declare function agentMemberSessionId(member: Pick<MachineInputMember, "kind" | "sourceId">): string | null;
+/**
+ * The row title for an agent member. A child result only means the agent went
+ * idle, so it reads "Result from …", never "finished".
+ */
+export declare function agentMemberTitle(member: Pick<MachineInputMember, "kind" | "classification">, name: string | null): AgentTitleParts;
+/**
+ * Human text for an agent member: the agent's own words where the summary
+ * carries them, without the model-facing "Worker <id> …" framing. `preview`
+ * is the most useful single passage; `body` is everything worth reading.
+ */
+export declare function agentMemberText(member: Pick<MachineInputMember, "kind" | "summary">): {
+    preview: string;
+    body: string;
+};

package/dist/components/machines/agent-status-icon.d.ts

@@ -0,0 +1,6 @@
+import type { StatusTone } from "./machine-status.js";
+/** The leading glyph for an agent status line; color follows the shared tone. */
+export declare function AgentStatusIcon({ tone, className }: {
+    tone: StatusTone;
+    className?: string;
+}): import("react").JSX.Element;

package/dist/components/machines/machine-detail.d.ts

@@ -13,7 +13,13 @@ export type MachineDetailProps = {
     onRemove?: ((machine: MachineView) => void) | undefined;
     onUpdateOperationPolicy?: ((machine: MachineView, request: UpdateMachineOperationPolicyRequest) => Promise<unknown>) | undefined;
     updatingOperationPolicy?: boolean | undefined;
+    /** Open "Who can use it?" for a connected machine. Omit when the viewer
+     * can't change it; the row then shows the current audience read-only. */
+    onChangeAudience?: ((machine: MachineView) => void) | undefined;
+    /** Start, retry or resend the signed agent update. Omit when the viewer can't. */
+    onUpdateAgent?: ((machine: MachineView) => void) | undefined;
+    updatingAgent?: boolean | undefined;
     now?: number | undefined;
     className?: string | undefined;
 };
-export declare function MachineDetail({ machine, series, window, onWindowChange, loadingSeries, onBack, onRemove, onUpdateOperationPolicy, updatingOperationPolicy, now, className, }: MachineDetailProps): import("react").JSX.Element;
+export declare function MachineDetail({ machine, series, window, onWindowChange, loadingSeries, onBack, onRemove, onUpdateOperationPolicy, updatingOperationPolicy, onChangeAudience, onUpdateAgent, updatingAgent, now, className, }: MachineDetailProps): import("react").JSX.Element;

package/dist/components/machines/machine-status.d.ts

@@ -0,0 +1,48 @@
+import type { MachineView } from "../../types/machines.js";
+type Runtime = NonNullable<MachineView["runtime"]>;
+type Authority = MachineView["connectionAuthority"];
+/** `waiting` is neutral progress or a postponement; `attention` asks for a look. */
+export type StatusTone = "ok" | "progress" | "waiting" | "attention" | "failed" | "muted";
+export type AgentUpdateAction = "update" | "retry" | "resend";
+export type AgentRuntimeStatus = {
+    /** "Agent v0.1.54" */
+    title: string;
+    /** One short line: "Up to date", "Updates to v0.1.55 when current work finishes", … */
+    status: string;
+    tone: StatusTone;
+    /** Extra explanation under the status (blocked reason, failure cause). */
+    note: string | null;
+    /** The one action that can help right now, before permission/online checks. */
+    action: {
+        kind: AgentUpdateAction;
+        label: string;
+    } | null;
+};
+/** An update request the agent has not confirmed after this long can be resent. */
+export declare const UPDATE_CONFIRMATION_GRACE_MS = 30000;
+/** A busy machine postpones an update instead of interrupting work. The agent
+ * reports this as a retryable `update_busy_*` result; it is not a failure. */
+export declare function isPostponedUpdate(errorCode: string | null | undefined): boolean;
+/**
+ * Describe the connected agent's build and update in plain words. A failed
+ * update whose target is already installed is moot and ignored; a postponed
+ * update reads as postponed, not failed.
+ */
+export declare function describeAgentRuntime(runtime: Runtime, now: number): AgentRuntimeStatus;
+/** A competing agent process retries at least every ten seconds while it runs,
+ * so a refusal older than this belongs to history, not to the present. */
+export declare const RUNNER_CONFLICT_ACTIVE_MS: number;
+export type RunnerConflict = {
+    /** A second agent process on the machine is being kept out right now. */
+    active: boolean;
+    count: number;
+    lastAt: string | null;
+};
+export declare function runnerConflict(authority: Authority, now: number): RunnerConflict | null;
+/** Plain words for the live connection: "Connected", "Reconnected 3 times". */
+export declare function describeAgentConnection(authority: Authority): {
+    label: string;
+    detail: string | null;
+};
+export declare const STATUS_TONE_TEXT: Record<StatusTone, string>;
+export {};

package/dist/components/markdown-table-layout.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Wide chat tables may extend past the prose column, but only to a readable
+ * line length. Beyond it, cells wrap instead of forcing horizontal scrolling.
+ */
+export declare const MARKDOWN_TABLE_MAX_WIDTH_REM = 64;
+export declare function markdownTableWidth({ columnLeft, columnWidth, contentLeft, contentRight, maxWidth, preferredWidth, }: {
+    columnLeft: number;
+    columnWidth: number;
+    contentLeft: number;
+    contentRight: number;
+    maxWidth?: number;
+    preferredWidth: number;
+}): number;
+/** Loaded only for assistant tables. Keep prose and nested scroll owners intact. */
+export declare function observeMarkdownTableLayout(wrapper: HTMLDivElement, table: HTMLTableElement): {
+    measure: () => void;
+    disconnect: () => void;
+} | undefined;