@kortix/ui 0.0.0-stage → 0.14.4

package/dist/internal/reminders/reminder-format.d.ts

@@ -0,0 +1,20 @@
+/** @internal Kortix apps only. No semver: it may change in any release. */
+import type { SessionReminder } from '@kortix/sdk';
+/**
+ * A fire time as people read it: "in 12 min" / "in 3 hr" up to a day out,
+ * then a short weekday-and-time ("Tue 09:00"), then a date. Past values say
+ * how long ago. Pure: `now` is a parameter so tests and renders agree.
+ */
+export declare function formatFireTime(iso: string, locale: string, now: number): string;
+/** The soonest scheduled fire among active reminders, in ms since epoch, or null. */
+/**
+ * The fire to show when the calendar's range has none: the soonest upcoming
+ * one, else the latest that happened, else a paused reminder's next slot.
+ * Null when no reminder has a time at all.
+ */
+export declare function nearestFire(reminders: readonly Pick<SessionReminder, 'state' | 'next_fire_at' | 'last_fired_at' | 'at'>[]): number | null;
+export declare function soonestFire(reminders: readonly Pick<SessionReminder, 'state' | 'next_fire_at'>[]): number | null;
+/** The first line of the reminder text, for a one-line row title. */
+export declare function reminderTitle(reminder: Pick<SessionReminder, 'name' | 'prompt'>): string;
+/** "Cron 0 9 * * * Europe/Berlin", "Every 1h" or "Once"; `t` is the `reminders` translator. */
+export declare function scheduleLabel(reminder: Pick<SessionReminder, 'cron' | 'timezone' | 'every'>, t: (key: 'cron' | 'every' | 'once', values?: Record<string, string>) => string): string;

package/dist/internal/reminders/reminder-format.js

@@ -0,0 +1,72 @@
+/**
+ * A fire time as people read it: "in 12 min" / "in 3 hr" up to a day out,
+ * then a short weekday-and-time ("Tue 09:00"), then a date. Past values say
+ * how long ago. Pure: `now` is a parameter so tests and renders agree.
+ */
+export function formatFireTime(iso, locale, now) {
+    const at = Date.parse(iso);
+    if (!Number.isFinite(at))
+        return '';
+    const deltaMin = Math.round((at - now) / 60_000);
+    const rtf = new Intl.RelativeTimeFormat(locale, { numeric: 'auto', style: 'short' });
+    const abs = Math.abs(deltaMin);
+    if (abs < 60)
+        return rtf.format(deltaMin, 'minute');
+    if (abs < 24 * 60)
+        return rtf.format(Math.round(deltaMin / 60), 'hour');
+    const date = new Date(at);
+    if (deltaMin > 0 && deltaMin < 7 * 24 * 60) {
+        return date.toLocaleString(locale, { weekday: 'short', hour: '2-digit', minute: '2-digit' });
+    }
+    return date.toLocaleString(locale, {
+        month: 'short',
+        day: 'numeric',
+        hour: '2-digit',
+        minute: '2-digit',
+    });
+}
+/** The soonest scheduled fire among active reminders, in ms since epoch, or null. */
+/**
+ * The fire to show when the calendar's range has none: the soonest upcoming
+ * one, else the latest that happened, else a paused reminder's next slot.
+ * Null when no reminder has a time at all.
+ */
+export function nearestFire(reminders) {
+    const soonest = soonestFire(reminders);
+    if (soonest !== null)
+        return soonest;
+    let latest = null;
+    let paused = null;
+    for (const reminder of reminders) {
+        const last = reminder.last_fired_at ? Date.parse(reminder.last_fired_at) : NaN;
+        if (Number.isFinite(last) && (latest === null || last > latest))
+            latest = last;
+        // A paused one-shot keeps its time in `at`; `next_fire_at` is cleared.
+        const slot = reminder.next_fire_at ?? reminder.at;
+        const next = slot ? Date.parse(slot) : NaN;
+        if (reminder.state === 'paused' && Number.isFinite(next) && (paused === null || next < paused))
+            paused = next;
+    }
+    return latest ?? paused;
+}
+export function soonestFire(reminders) {
+    let soonest = null;
+    for (const reminder of reminders) {
+        if (reminder.state !== 'active' || !reminder.next_fire_at)
+            continue;
+        const at = Date.parse(reminder.next_fire_at);
+        if (Number.isFinite(at) && (soonest === null || at < soonest))
+            soonest = at;
+    }
+    return soonest;
+}
+/** The first line of the reminder text, for a one-line row title. */
+export function reminderTitle(reminder) {
+    return reminder.name ?? reminder.prompt.split('\n')[0].trim();
+}
+/** "Cron 0 9 * * * Europe/Berlin", "Every 1h" or "Once"; `t` is the `reminders` translator. */
+export function scheduleLabel(reminder, t) {
+    if (reminder.cron)
+        return t('cron', { expression: [reminder.cron, reminder.timezone ?? ''].join(' ').trim() });
+    return reminder.every ? t('every', { period: reminder.every }) : t('once');
+}

package/dist/internal/reminders/use-refetch-after-fire.d.ts

@@ -0,0 +1,10 @@
+/** @internal Kortix apps only. No semver: it may change in any release. */
+import type { SessionReminder } from '@kortix/sdk';
+/**
+ * Refetch once, just after the soonest active reminder fires, so its "next"
+ * time and state never sit stale on screen. No polling: one timer, re-armed
+ * from each fresh list.
+ */
+export declare function useRefetchAfterFire(reminders: readonly Pick<SessionReminder, 'state' | 'next_fire_at'>[] | undefined, refetch: () => unknown): void;
+/** The current time for relative labels ("in 12 min"), re-read every 30 s. */
+export declare function useNow(intervalMs?: number): number;

package/dist/internal/reminders/use-refetch-after-fire.js

@@ -0,0 +1,30 @@
+'use client';
+import { useEffect, useState } from 'react';
+import { soonestFire } from './reminder-format.js';
+/** The scheduler ticks every second; this is enough for the fire to land. */
+const AFTER_FIRE_MS = 5_000;
+/**
+ * Refetch once, just after the soonest active reminder fires, so its "next"
+ * time and state never sit stale on screen. No polling: one timer, re-armed
+ * from each fresh list.
+ */
+export function useRefetchAfterFire(reminders, refetch) {
+    const soonest = reminders ? soonestFire(reminders) : null;
+    useEffect(() => {
+        if (soonest === null)
+            return;
+        // setTimeout caps at ~24.8 days; a reminder further out re-arms on the next load.
+        const wait = Math.min(Math.max(soonest - Date.now(), 0) + AFTER_FIRE_MS, 2_000_000_000);
+        const timer = setTimeout(() => void refetch(), wait);
+        return () => clearTimeout(timer);
+    }, [soonest, refetch]);
+}
+/** The current time for relative labels ("in 12 min"), re-read every 30 s. */
+export function useNow(intervalMs = 30_000) {
+    const [now, setNow] = useState(() => Date.now());
+    useEffect(() => {
+        const timer = setInterval(() => setNow(Date.now()), intervalMs);
+        return () => clearInterval(timer);
+    }, [intervalMs]);
+    return now;
+}

package/dist/internal/selection/selection-bar.d.ts

@@ -0,0 +1,31 @@
+/** @internal Kortix apps only. No semver: it may change in any release. */
+export interface SelectionBarAction {
+    id: string;
+    label: string;
+    tone?: 'default' | 'destructive';
+    disabled?: boolean;
+    onSelect: () => void;
+}
+export declare function SelectionBar({ selectedCount, allSelected, canSelectAll, onSelectAll, onClear, onExit, actions, progress, animateIn, note, }: {
+    selectedCount: number;
+    allSelected: boolean;
+    /** False when the list shows nothing to select. */
+    canSelectAll?: boolean;
+    onSelectAll: () => void;
+    onClear: () => void;
+    onExit: () => void;
+    actions: readonly SelectionBarAction[];
+    /**
+     * A running bulk action: `label` is the full progress line ("Pausing 3 of 12…").
+     * `done` and `total` ride along for consumers that render their own label.
+     */
+    progress?: {
+        label: string;
+        done: number;
+        total: number;
+    } | null;
+    /** False skips the enter animation (select mode opened from the keyboard). */
+    animateIn?: boolean;
+    /** A muted line after the count, such as a selection limit. */
+    note?: string;
+}): import("react").JSX.Element;

package/dist/internal/selection/selection-bar.js

@@ -0,0 +1,45 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * The floating select-mode bar shared by every multi-select list: the count,
+ * then one `secondary` ButtonGroup of text buttons (Select all, then the
+ * caller's actions),
+ * then the exit button. A destructive action keeps the group's variant and
+ * takes the destructive text tone. While a bulk action runs, the count line
+ * reads its progress with the session dot matrix and every control disables.
+ *
+ * It enters with a short rise and fade (reduced motion keeps the fade only).
+ * It leaves at once: Esc exits select mode, and a keyboard action never
+ * animates. `animateIn={false}` skips the enter too, for a keyboard-opened bar.
+ */
+import { XIcon } from '@phosphor-icons/react';
+import { m, useReducedMotion } from 'motion/react';
+import { useTranslations } from '../../i18n/index.js';
+import { cn } from '../lib/utils.js';
+import { Button } from '../../primitives/button.js';
+import { ButtonGroup } from '../../primitives/button-group.js';
+import { SessionDotMatrix } from '../../primitives/dot-matrix/session-dot-matrix.js';
+import Hint from '../../primitives/hint.js';
+const EASE_OUT = [0.23, 1, 0.32, 1];
+// A full transform string, not `y`: it runs on the compositor while the list loads.
+const RISE = 'translateY(8px)';
+const REST = 'translateY(0px)';
+export function SelectionBar({ selectedCount, allSelected, canSelectAll = true, onSelectAll, onClear, onExit, actions, progress = null, animateIn = true, note, }) {
+    const t = useTranslations('hardcodedUi.i18nComplete');
+    const reduceMotion = useReducedMotion();
+    const busy = progress !== null;
+    const selectLabel = allSelected ? t.raw('text83b12c2216ef') : t.raw('text1fc9a387654d');
+    // One action: a fixed-height button that reads its label. No glyph: a
+    // verb in a bulk bar is read, not recognised.
+    const action = (a) => (_jsx(Button, { type: "button", variant: "secondary", size: "sm", onClick: a.onSelect, disabled: busy || a.disabled, className: cn('h-8 shrink-0', a.tone === 'destructive' && 'text-destructive hover:text-destructive'), children: a.label }, a.id));
+    return (_jsxs(m.div, { initial: animateIn ? { opacity: 0, transform: reduceMotion ? REST : RISE } : false, animate: {
+            opacity: 1,
+            transform: REST,
+            transition: { duration: 0.18, ease: EASE_OUT },
+        }, className: "bg-popover text-popover-foreground border-border flex w-full items-center gap-3 rounded-lg border p-2 pl-3.5 shadow-md", children: [_jsxs("span", { className: "flex min-w-0 flex-1 items-center gap-2 text-sm font-medium tabular-nums", "aria-live": "polite", children: [progress ? _jsx(SessionDotMatrix, { size: 14, className: "shrink-0" }) : null, _jsx("span", { className: "truncate", children: progress ? progress.label : t('text1cc5b0d9628f', { count: selectedCount }) }), note && !progress ? (_jsx("span", { className: "text-muted-foreground truncate font-normal", children: note })) : null] }), _jsxs(ButtonGroup, { className: "shrink-0", children: [action({
+                        id: 'select-all',
+                        label: selectLabel,
+                        disabled: !canSelectAll,
+                        onSelect: allSelected ? onClear : onSelectAll,
+                    }), actions.map(action)] }), _jsx(Hint, { label: t.raw('text22206bc67806'), side: "top", children: _jsx(Button, { type: "button", variant: "ghost", size: "icon", "aria-label": t.raw('text22206bc67806'), onClick: onExit, disabled: busy, className: "size-8 shrink-0", children: _jsx(XIcon, { className: "size-4 shrink-0" }) }) })] }));
+}

package/dist/internal/selection/selection.d.ts

@@ -0,0 +1,9 @@
+/** @internal Kortix apps only. No semver: it may change in any release. */
+/** Multi-select rules shared by every list that selects rows by string id. */
+/** Toggle one id. */
+export declare function toggleId(selected: ReadonlySet<string>, id: string): Set<string>;
+/**
+ * Shift-click: add every id between the anchor and the target, both
+ * included, in list order. Without an anchor in the list it toggles the target.
+ */
+export declare function selectRange(selected: ReadonlySet<string>, ordered: readonly string[], anchor: string | null, target: string): Set<string>;

package/dist/internal/selection/selection.js

@@ -0,0 +1,25 @@
+/** Multi-select rules shared by every list that selects rows by string id. */
+/** Toggle one id. */
+export function toggleId(selected, id) {
+    const next = new Set(selected);
+    if (next.has(id))
+        next.delete(id);
+    else
+        next.add(id);
+    return next;
+}
+/**
+ * Shift-click: add every id between the anchor and the target, both
+ * included, in list order. Without an anchor in the list it toggles the target.
+ */
+export function selectRange(selected, ordered, anchor, target) {
+    const from = anchor ? ordered.indexOf(anchor) : -1;
+    const to = ordered.indexOf(target);
+    if (from < 0 || to < 0)
+        return toggleId(selected, target);
+    const [lo, hi] = from < to ? [from, to] : [to, from];
+    const next = new Set(selected);
+    for (const id of ordered.slice(lo, hi + 1))
+        next.add(id);
+    return next;
+}

package/dist/internal/session-types/index.d.ts

@@ -0,0 +1,30 @@
+/** @internal Kortix apps only. No semver: it may change in any release. */
+/**
+ * Shared session UI primitives — framework-agnostic.
+ *
+ * Import from './index.js' for types, turn grouping, part helpers, and status text.
+ * The turn helpers live in `@kortix/sdk` (single implementation shared
+ * with mobile); this barrel re-exports them alongside the web view-model types.
+ *
+ * IMPORTANT: No React / DOM / framework imports in this folder.
+ */
+export * from './types.js';
+/**
+ * The framework-free turn/part helpers, from the canonical `@kortix/sdk` root.
+ *
+ * This was `export * from '@kortix/sdk/turns'`. That subpath is a deprecated
+ * alias, but the replacement cannot be a bare `export * from '@kortix/sdk'`:
+ * the root carries the whole 844-name surface, which (a) collides with the web
+ * view-model types in `./types` and (b) would re-expose `getClient`,
+ * `getActiveOpenCodeUrl`, `createKortixPty`, `getKortixPtyWebSocketUrl` and
+ * `removeKortixPty` through `@/ui` — the ambient-runtime accessors that
+ * eslint's no-restricted-imports forbids precisely because they resolve a
+ * runtime from global state instead of from a session.
+ *
+ * So the names are listed. This set is exactly what `@kortix/sdk/turns`
+ * exported, so every existing `@/ui` importer resolves to the same
+ * declaration it did before. Regenerate from
+ * `packages/sdk/src/public-*-surface.snapshot.json` under the `"./turns"` key.
+ */
+export { COST_MARKUP, allDescendantIds, childMapByParent, classifyPart, classifyTurn, collectTurnParts, compareMessagesForDisplay, computeStatusFromPart, extractGatewayErrorDetails, findLastTextPart, formatCost, formatDuration, formatTokens, getAgentCardLabel, getAnsweredQuestionParts, getChildSessionError, getChildSessionId, getChildSessionToolParts, getDiagnostics, getDirectory, getFileWithDir, getFilename, getHiddenToolParts, getPartText, getPermissionForTool, getQuestionForTool, getRetryInfo, getRetryMessage, getSessionCost, getShellModePart, getToolInfo, getTurnCost, getTurnError, getTurnErrorDetails, getTurnErrorRawText, getTurnStatus, getWorkingState, groupMessagesIntoTurns, hasDiffs, hasRetryingAssistantTurn, humanizeToolName, isAgentPart, isAttachment, isCompactionPart, isFilePart, isLastUserMessage, isPatchPart, isReasoningPart, isRetryableTurnError, isShellMode, isSnapshotPart, isTextPart, isToolPart, isToolPartHidden, normalizeToolName, relativizePath, shellExitCode, shouldHideResponsePart, shouldShowToolPart, sortSessions, splitUserParts, stripAnsi, toolInfo, toolViewModel, turnHasSteps, unwrapError, } from '@kortix/sdk';
+export type { ClassifiedAgentPart, ClassifiedCompactionPart, ClassifiedFilePart, ClassifiedPart, ClassifiedPatchPart, ClassifiedReasoningPart, ClassifiedRetryPart, ClassifiedSnapshotPart, ClassifiedStepPart, ClassifiedSubtaskPart, ClassifiedTextPart, ClassifiedToolPart, ClassifiedTurn, ClassifiedUnknownPart, Diagnostic, DiffLine, DiffLineType, GatewayAttemptFailure, GatewayErrorDetails, HiddenToolRef, MessageInfoLike, MessageWithPartsLike, ModelCostRates, ModelCostTierRates, ModelPricingLookup, OpenTurnMessageLike, PartLike, PartWithMessage, QuestionItem, QuestionOption, RequestWithToolLike, RetryInfo, SearchMatch, SessionStatusLike, TodoItem, TokenUsageLike, ToolCategory, ToolInfo, ToolInfoEntry, ToolPartLike, ToolStateLike, ToolStatus, ToolView, ToolViewModel, TurnCostInfo, TurnError, TurnLike, WebSearchResultItem, } from '@kortix/sdk';

package/dist/internal/session-types/index.js

@@ -0,0 +1,28 @@
+/**
+ * Shared session UI primitives — framework-agnostic.
+ *
+ * Import from './index.js' for types, turn grouping, part helpers, and status text.
+ * The turn helpers live in `@kortix/sdk` (single implementation shared
+ * with mobile); this barrel re-exports them alongside the web view-model types.
+ *
+ * IMPORTANT: No React / DOM / framework imports in this folder.
+ */
+export * from './types.js';
+/**
+ * The framework-free turn/part helpers, from the canonical `@kortix/sdk` root.
+ *
+ * This was `export * from '@kortix/sdk/turns'`. That subpath is a deprecated
+ * alias, but the replacement cannot be a bare `export * from '@kortix/sdk'`:
+ * the root carries the whole 844-name surface, which (a) collides with the web
+ * view-model types in `./types` and (b) would re-expose `getClient`,
+ * `getActiveOpenCodeUrl`, `createKortixPty`, `getKortixPtyWebSocketUrl` and
+ * `removeKortixPty` through `@/ui` — the ambient-runtime accessors that
+ * eslint's no-restricted-imports forbids precisely because they resolve a
+ * runtime from global state instead of from a session.
+ *
+ * So the names are listed. This set is exactly what `@kortix/sdk/turns`
+ * exported, so every existing `@/ui` importer resolves to the same
+ * declaration it did before. Regenerate from
+ * `packages/sdk/src/public-*-surface.snapshot.json` under the `"./turns"` key.
+ */
+export { COST_MARKUP, allDescendantIds, childMapByParent, classifyPart, classifyTurn, collectTurnParts, compareMessagesForDisplay, computeStatusFromPart, extractGatewayErrorDetails, findLastTextPart, formatCost, formatDuration, formatTokens, getAgentCardLabel, getAnsweredQuestionParts, getChildSessionError, getChildSessionId, getChildSessionToolParts, getDiagnostics, getDirectory, getFileWithDir, getFilename, getHiddenToolParts, getPartText, getPermissionForTool, getQuestionForTool, getRetryInfo, getRetryMessage, getSessionCost, getShellModePart, getToolInfo, getTurnCost, getTurnError, getTurnErrorDetails, getTurnErrorRawText, getTurnStatus, getWorkingState, groupMessagesIntoTurns, hasDiffs, hasRetryingAssistantTurn, humanizeToolName, isAgentPart, isAttachment, isCompactionPart, isFilePart, isLastUserMessage, isPatchPart, isReasoningPart, isRetryableTurnError, isShellMode, isSnapshotPart, isTextPart, isToolPart, isToolPartHidden, normalizeToolName, relativizePath, shellExitCode, shouldHideResponsePart, shouldShowToolPart, sortSessions, splitUserParts, stripAnsi, toolInfo, toolViewModel, turnHasSteps, unwrapError, } from '@kortix/sdk';

package/dist/internal/session-types/types.d.ts

@@ -0,0 +1,78 @@
+/** @internal Kortix apps only. No semver: it may change in any release. */
+/**
+ * Shared session UI types — framework-agnostic.
+ *
+ * These types are consumed by both web (React) and mobile (React Native)
+ * frontends. They re-export from the SDK and add view-model types on top.
+ *
+ * IMPORTANT: No React / DOM / framework imports allowed in this folder.
+ */
+export type { Agent, AgentPart, AssistantMessage, Command, CompactionPart, FilePart, Message, Model, Part, PatchPart, PermissionRequest, Project, Provider, QuestionAnswer, QuestionInfo, QuestionOption, QuestionRequest, ReasoningPart, RetryPart, Session, SessionStatus, SnapshotFileDiff, SnapshotPart, StepFinishPart, StepStartPart, SubtaskPart, TextPart, Todo, ToolPart, ToolState, ToolStateCompleted, ToolStateError, ToolStatePending, ToolStateRunning, UserMessage, } from '@kortix/sdk';
+export type FileDiff = Omit<import('@kortix/sdk').SnapshotFileDiff, 'patch'> & {
+    patch?: string;
+    before?: string;
+    after?: string;
+};
+/**
+ * A message with its pre-resolved parts — the shape returned by
+ * `session.messages()`.
+ */
+export interface MessageWithParts {
+    info: import('@kortix/sdk').Message;
+    parts: import('@kortix/sdk').Part[];
+}
+/**
+ * A "turn" groups a user message with all its assistant responses.
+ * This is the primary rendering unit for the chat history.
+ */
+export interface Turn {
+    userMessage: MessageWithParts;
+    assistantMessages: MessageWithParts[];
+    /** The prompt is not loaded; `userMessage` is a stand-in (see the SDK's `TurnLike.partial`). */
+    partial?: true;
+}
+export type { Diagnostic, RetryInfo, ToolInfo, TurnCostInfo } from '@kortix/sdk';
+/** Structured trigger data for the BasicTool wrapper. */
+export interface TriggerTitle {
+    title: string;
+    subtitle?: string;
+    args?: string[];
+    /**
+     * Line-count summary rendered beside the subtitle as `+N −N` (DiffStat on
+     * web). Plain data, not a node — this folder is framework-free, and the
+     * numbers mean the same thing on every surface.
+     */
+    stat?: {
+        additions: number;
+        deletions: number;
+    };
+    /**
+     * The subtitle repeats text the OPEN body already shows, so the row drops it
+     * once it is expanded.
+     *
+     * A closed row is the only place that text appears, so it stays there. Open,
+     * it is the same string twice — and the trigger's copy is the worse one: it
+     * is truncated to one line, so a long value disagrees with the full one
+     * directly beneath it.
+     *
+     * Opt-in per call, not a blanket rule, because most subtitles are NOT
+     * repeated by the body: a `pty` row's terminal id, for instance, appears
+     * nowhere in the buffer it opens, and hiding it would lose the only thing
+     * saying WHICH terminal this is. Set it where the body genuinely echoes the
+     * subtitle, and leave it off everywhere else.
+     */
+    hideSubtitleWhenOpen?: boolean;
+}
+/** A file entry in an apply_patch tool part's metadata. */
+export interface ApplyPatchFile {
+    filePath: string;
+    relativePath: string;
+    type: 'add' | 'update' | 'delete' | 'move';
+    diff: string;
+    before: string;
+    after: string;
+    additions: number;
+    deletions: number;
+    movePath?: string;
+}
+export declare const PERMISSION_LABELS: Record<string, string>;

package/dist/internal/session-types/types.js

@@ -0,0 +1,20 @@
+/**
+ * Shared session UI types — framework-agnostic.
+ *
+ * These types are consumed by both web (React) and mobile (React Native)
+ * frontends. They re-export from the SDK and add view-model types on top.
+ *
+ * IMPORTANT: No React / DOM / framework imports allowed in this folder.
+ */
+// ---------------------------------------------------------------------------
+// Permission labels (shared between web & mobile)
+// ---------------------------------------------------------------------------
+export const PERMISSION_LABELS = {
+    bash: 'Run command',
+    edit: 'Edit file',
+    write: 'Write file',
+    read: 'Read file',
+    webfetch: 'Fetch URL',
+    mcp: 'Use MCP tool',
+    doom_loop: 'Repeated tool call',
+};

package/dist/internal/share/public-share-link-button.d.ts

@@ -0,0 +1,14 @@
+/** @internal Kortix apps only. No semver: it may change in any release. */
+import type { CreateSessionPublicShareInput } from '@kortix/sdk';
+export declare function PublicShareLinkButton({ projectId, sessionId, input, tooltip, title, className, iconClassName, tooltipSideOffset, }: {
+    projectId?: string;
+    sessionId?: string;
+    input: CreateSessionPublicShareInput | null;
+    tooltip?: string;
+    title?: string;
+    className?: string;
+    /** Icon size override. Defaults to this component's own 16px. */
+    iconClassName?: string;
+    /** Tooltip sideOffset override. Omit to keep `Hint`'s own default. */
+    tooltipSideOffset?: number;
+}): import("react").JSX.Element | null;

package/dist/internal/share/public-share-link-button.js

@@ -0,0 +1,17 @@
+'use client';
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { CheckIcon as Check, LinkSimpleIcon } from '@phosphor-icons/react';
+import { AnimatePresence, m } from 'motion/react';
+import { PublicShareLinkConfirm } from './public-share-link-confirm.js';
+import { Button } from '../../primitives/button.js';
+import Hint from '../../primitives/hint.js';
+import Loading from '../../primitives/loading.js';
+import { usePublicShareLink } from './use-public-share-link.js';
+import { cn } from '../../lib/utils.js';
+export function PublicShareLinkButton({ projectId, sessionId, input, tooltip = 'Copy a public view-only link', title = 'Copy public link', className, iconClassName = 'size-4', tooltipSideOffset, }) {
+    const share = usePublicShareLink({ projectId, sessionId, input });
+    const disabled = !share.canShare || share.isPending;
+    if (!share.enabled)
+        return null;
+    return (_jsxs(_Fragment, { children: [_jsx(Hint, { label: share.copied ? 'Copied' : tooltip, side: "bottom", sideOffset: tooltipSideOffset, className: "max-w-56 text-xs", children: _jsx(Button, { variant: "ghost", size: "icon", className: cn('size-8 active:scale-[0.96]', className), onClick: share.copyLink, disabled: disabled, title: title, children: share.isPending ? (_jsx(Loading, { className: cn(iconClassName, 'shrink-0') })) : (_jsx("span", { className: cn('relative inline-flex items-center justify-center', iconClassName), children: _jsx(AnimatePresence, { initial: false, mode: "popLayout", children: _jsx(m.span, { initial: { scale: 0.25, opacity: 0, filter: 'blur(4px)' }, animate: { scale: 1, opacity: 1, filter: 'blur(0px)' }, exit: { scale: 0.25, opacity: 0, filter: 'blur(4px)' }, transition: { type: 'spring', duration: 0.3, bounce: 0 }, className: "absolute inset-0 inline-flex items-center justify-center", children: share.copied ? (_jsx(Check, { className: cn(iconClassName, 'text-kortix-green') })) : (_jsx(LinkSimpleIcon, { className: iconClassName })) }, share.copied ? 'check' : 'link') }) })) }) }), _jsx(PublicShareLinkConfirm, { confirmation: share.confirmation })] }));
+}

package/dist/internal/share/public-share-link-confirm.d.ts

@@ -0,0 +1,15 @@
+/** @internal Kortix apps only. No semver: it may change in any release. */
+export interface PublicShareLinkConfirmation {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    onConfirm: (expiresAt?: string | null) => void;
+    isPending: boolean;
+}
+/**
+ * The confirmation in front of every public link. The link needs no sign-in,
+ * so creating one is a decision, not a copy: "Copy link" opens this, and only
+ * "Create link" mints the share and copies it.
+ */
+export declare function PublicShareLinkConfirm({ confirmation, }: {
+    confirmation: PublicShareLinkConfirmation;
+}): import("react").JSX.Element;

package/dist/internal/share/public-share-link-confirm.js

@@ -0,0 +1,13 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { ConfirmDialog } from '../../primitives/confirm-dialog.js';
+import { useTranslations } from '../../i18n/index.js';
+/**
+ * The confirmation in front of every public link. The link needs no sign-in,
+ * so creating one is a decision, not a copy: "Copy link" opens this, and only
+ * "Create link" mints the share and copies it.
+ */
+export function PublicShareLinkConfirm({ confirmation, }) {
+    const tHardcodedUi = useTranslations('hardcodedUi');
+    return (_jsx(ConfirmDialog, { open: confirmation.open, onOpenChange: confirmation.onOpenChange, title: tHardcodedUi.raw('publicShareConfirm.title'), description: tHardcodedUi.raw('publicShareConfirm.description'), confirmLabel: tHardcodedUi.raw('publicShareConfirm.confirm'), onConfirm: () => confirmation.onConfirm(), isPending: confirmation.isPending }));
+}

package/dist/internal/share/session-shares-modal.d.ts

@@ -0,0 +1,7 @@
+/** @internal Kortix apps only. No semver: it may change in any release. */
+export declare function SessionSharesModal({ projectId, sessionId, open, onOpenChange, }: {
+    projectId?: string;
+    sessionId?: string;
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+}): import("react").JSX.Element;

package/dist/internal/share/session-shares-modal.js

@@ -0,0 +1,59 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useTranslations } from '../../i18n/index.js';
+import { ChatTextIcon as ChatText, CheckIcon as Check, FileTextIcon as FileText, GlobeIcon as Globe, LinkSimpleIcon as Link2, } from '@phosphor-icons/react';
+import { useState } from 'react';
+import { Badge } from '../../primitives/badge.js';
+import { Button } from '../../primitives/button.js';
+import { ConfirmDialog } from '../../primitives/confirm-dialog.js';
+import Hint from '../../primitives/hint.js';
+import Loading from '../../primitives/loading.js';
+import { Modal, ModalBody, ModalContent, ModalDescription, ModalHeader, ModalTitle, } from '../../primitives/modal.js';
+import { successToast } from '../../primitives/toast.js';
+import { EmptyState } from '../../primitives/empty-state.js';
+import { ErrorState } from '../../primitives/error-state.js';
+import { isShareLive, publicShareUrl, shareListState, useRevokePublicShare, useSessionPublicShares, } from './use-session-public-shares.js';
+import { cn } from '../../lib/utils.js';
+function ShareRow({ share, onRevoke, isRevoking, }) {
+    const tI18nComplete = useTranslations('hardcodedUi.i18nComplete');
+    const tTranscript = useTranslations('hardcodedUi.publicTranscriptShare');
+    const [copied, setCopied] = useState(false);
+    const live = isShareLive(share);
+    // Read at render time: `publicShareUrl` is null outside a browser (SSR).
+    const url = publicShareUrl(share.public_path);
+    const isFile = share.resource_type === 'file';
+    // A transcript share has no port and no file: it names the conversation.
+    const isTranscript = share.resource_type === 'transcript';
+    const Icon = isFile ? FileText : isTranscript ? ChatText : Globe;
+    const copy = async () => {
+        if (!url)
+            return;
+        await navigator.clipboard.writeText(url);
+        setCopied(true);
+        successToast(tI18nComplete.raw('textd0f24de8dbc6'));
+        setTimeout(() => setCopied(false), 2000);
+    };
+    return (_jsxs("li", { className: cn('group bg-popover flex items-center gap-3 rounded-md border px-4 py-2.5 transition-colors', !live && 'opacity-60'), children: [_jsx("span", { className: cn('flex size-9 shrink-0 items-center justify-center rounded-sm', live ? 'bg-kortix-green/15' : 'bg-muted'), children: _jsx(Icon, { className: cn('size-5', live ? 'text-kortix-green' : 'text-muted-foreground') }) }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsxs("div", { className: "flex items-center gap-1.5", children: [_jsx("span", { className: "truncate text-sm font-medium", children: share.label }), !live && (_jsx(Badge, { variant: "outline", size: "xs", children: share.revoked_at ? 'Revoked' : 'Expired' }))] }), _jsx("p", { className: "text-muted-foreground truncate text-xs", children: isFile
+                            ? share.file_path
+                            : isTranscript
+                                ? tTranscript('rowMeta')
+                                : `Port ${share.port}${share.path}` })] }), live && (_jsxs("span", { className: "flex shrink-0 items-center gap-1", children: [_jsx(Hint, { label: copied ? 'Copied' : tI18nComplete.raw('textdbf362d4f210'), side: "bottom", children: _jsx(Button, { variant: "ghost", size: "icon", "aria-label": tI18nComplete.raw('textdbf362d4f210'), disabled: !url, onClick: () => void copy(), className: "size-8 active:scale-[0.96]", children: copied ? (_jsx(Check, { className: "text-kortix-green size-4" })) : (_jsx(Link2, { className: "size-4" })) }) }), _jsxs(Button, { variant: "ghost", size: "sm", onClick: onRevoke, disabled: isRevoking, children: [isRevoking ? _jsx(Loading, { className: "size-4 shrink-0" }) : null, tI18nComplete.raw('text87e6d00bbf53')] })] }))] }));
+}
+export function SessionSharesModal({ projectId, sessionId, open, onOpenChange, }) {
+    const tI18nComplete = useTranslations('hardcodedUi.i18nComplete');
+    const { shares, liveShares, isLoading, isError } = useSessionPublicShares(projectId, sessionId);
+    const { revoke, revokingId } = useRevokePublicShare(projectId, sessionId);
+    const [pendingRevoke, setPendingRevoke] = useState(null);
+    const inactive = shares.filter((share) => !isShareLive(share));
+    const listState = shareListState({ isLoading, isError, count: shares.length });
+    return (_jsxs(_Fragment, { children: [_jsx(Modal, { open: open, onOpenChange: onOpenChange, children: _jsxs(ModalContent, { className: "lg:max-w-lg", children: [_jsxs(ModalHeader, { children: [_jsx(ModalTitle, { children: tI18nComplete.raw('texta95952c8b021') }), _jsx(ModalDescription, { children: tI18nComplete.raw('text5ba39e7fa782') })] }), _jsx(ModalBody, { className: "max-h-[60vh] space-y-6 overflow-y-auto", children: listState === 'loading' ? (_jsx("div", { className: "flex justify-center py-6", children: _jsx(Loading, { className: "size-4 shrink-0" }) })) : listState === 'error' ? (
+                            // The list 403s for a project member who neither created the
+                            // session nor has manage rights (`canManageSharing` = owner OR
+                            // project manager). Falling through to the empty state would tell
+                            // them nothing is shared, which may simply be false.
+                            _jsx(ErrorState, { size: "sm", title: tI18nComplete.raw('text25c9ab3f2bf6'), description: tI18nComplete.raw('text93bce1d8f18d') })) : listState === 'empty' ? (_jsx(EmptyState, { icon: Link2, size: "sm", title: tI18nComplete.raw('texteeb088fdeabf'), description: tI18nComplete.raw('text3c45b1a13f8b') })) : (_jsxs(_Fragment, { children: [liveShares.length > 0 && (_jsx("ul", { className: "space-y-2", children: liveShares.map((share) => (_jsx(ShareRow, { share: share, isRevoking: revokingId === share.share_id, onRevoke: () => setPendingRevoke(share) }, share.share_id))) })), inactive.length > 0 && (_jsxs("div", { className: "space-y-2", children: [_jsx("p", { className: "text-muted-foreground text-xs", children: tI18nComplete.raw('textb3839e7c0b51') }), _jsx("ul", { className: "space-y-2", children: inactive.map((share) => (_jsx(ShareRow, { share: share, isRevoking: false, onRevoke: () => { } }, share.share_id))) })] }))] })) })] }) }), _jsx(ConfirmDialog, { open: !!pendingRevoke, onOpenChange: (next) => !next && setPendingRevoke(null), title: tI18nComplete.raw('text3d3b295854fe'), description: _jsxs(_Fragment, { children: [_jsx("span", { className: "font-medium", children: pendingRevoke?.label }), ' ', tI18nComplete.raw('text35b38cfe5b26')] }), confirmLabel: tI18nComplete.raw('text87e6d00bbf53'), confirmVariant: "destructive", onConfirm: () => {
+                    if (pendingRevoke)
+                        revoke(pendingRevoke.share_id);
+                    setPendingRevoke(null);
+                } })] }));
+}

package/dist/internal/share/use-public-share-link.d.ts

@@ -0,0 +1,39 @@
+/** @internal Kortix apps only. No semver: it may change in any release. */
+/**
+ * Mint a public share for a session resource and copy its link.
+ *
+ * This exists because the same twelve lines were written three times — in
+ * `PublicShareLinkButton`, in `browser-panel`, and (missing entirely) in
+ * `app-preview`, which is how the last one ended up copying the raw
+ * authenticated proxy URL instead. One owner, so the next surface that needs a
+ * share link cannot quietly invent a fourth spelling.
+ *
+ * The link is always `{origin}{share.public_path}` — the `/share/session/{token}`
+ * page, never the `/v1/p/...` proxy path. The proxy path is an implementation
+ * detail the share page resolves; handing it out directly would leak the
+ * sandbox id and, for the authenticated form, only work for people who already
+ * have access.
+ */
+import { type CreateSessionPublicShareInput } from '@kortix/sdk';
+export interface PublicShareLinkTarget {
+    projectId?: string;
+    sessionId?: string;
+    input: CreateSessionPublicShareInput | null;
+}
+export declare function usePublicShareLink({ projectId, sessionId, input }: PublicShareLinkTarget): {
+    /** Ask to create a public link. Opens the confirmation; mints nothing. */
+    copyLink: () => void;
+    /** Props for `PublicShareLinkConfirm`, which every caller renders. */
+    confirmation: {
+        open: boolean;
+        onOpenChange: (open: boolean) => void;
+        /** `expiresAt` is an ISO timestamp, or null for a link that never expires. */
+        onConfirm: (expiresAt?: string | null) => void;
+        isPending: boolean;
+    };
+    isPending: boolean;
+    copied: boolean;
+    canShare: boolean;
+    /** The host serves public share pages at all (`config.publicSharesEnabled`). */
+    enabled: boolean;
+};