@kortix/ui 0.14.12 → 0.14.14

package/dist/session/composer/send-blockers.d.ts

@@ -26,17 +26,7 @@ import type { UiTranslator } from '../../i18n/index.js';
  *
  * Two gates from the old set are deliberately NOT here:
  *
- *   - `revertStaged`. It blocked the auto-drain from firing into a trajectory
- *     the user had asked to discard. There is no auto-drain, and a staged
- *     revert is precisely the state in which the user types their REPLACEMENT
- *     prompt — refusing it would make edit-and-resend impossible. The
- *     replacement prompt IS what commits the revert: OpenCode truncates on the
- *     next delivery, from any producer. The server's own guard
- *     (`queuedContinueHasStagedRevert`,
- *     `apps/api/src/projects/session-lifecycle/engine.ts`) lets a prompt that
- *     never waited commit the revert for that reason, and refuses the rows that
- *     queued BEFORE it — for every client, which a gate in this tab could never
- *     do.
+ *   - `revertStaged`. No runtime stages a revert: pi answers rewind `501`.
  *   - `isServerBusy`, for a PROMPT. That is the inbox's decision now.
  *   - `runtimeReady`, for a PROMPT. A prompt typed at a sleeping box becomes an
  *     inbox row and is delivered when the box answers. A COMMAND cannot: see

package/dist/session/composer/send-blockers.js

@@ -25,17 +25,7 @@
  *
  * Two gates from the old set are deliberately NOT here:
  *
- *   - `revertStaged`. It blocked the auto-drain from firing into a trajectory
- *     the user had asked to discard. There is no auto-drain, and a staged
- *     revert is precisely the state in which the user types their REPLACEMENT
- *     prompt — refusing it would make edit-and-resend impossible. The
- *     replacement prompt IS what commits the revert: OpenCode truncates on the
- *     next delivery, from any producer. The server's own guard
- *     (`queuedContinueHasStagedRevert`,
- *     `apps/api/src/projects/session-lifecycle/engine.ts`) lets a prompt that
- *     never waited commit the revert for that reason, and refuses the rows that
- *     queued BEFORE it — for every client, which a gate in this tab could never
- *     do.
+ *   - `revertStaged`. No runtime stages a revert: pi answers rewind `501`.
  *   - `isServerBusy`, for a PROMPT. That is the inbox's decision now.
  *   - `runtimeReady`, for a PROMPT. A prompt typed at a sleeping box becomes an
  *     inbox row and is delivered when the box answers. A COMMAND cannot: see

package/dist/session/composer/session-composer-readiness.d.ts

@@ -26,7 +26,6 @@
  * — the composer stays usable, and this module's job shrinks to one thing:
  * saying what is going on.
  */
-import { type SessionConnection } from '@kortix/sdk';
 export interface SessionComposerReadiness {
     /** The runtime is up. False means a submit becomes a queued inbox row rather
      *  than a delivery. */
@@ -86,11 +85,6 @@ export declare function serverHoldsOpenTurn(working: {
 }): boolean;
 export declare function sessionComposerReadiness(input: {
     runtimeReady: boolean;
-    /** A prompt sent from this page is waiting for the computer. Its turn
-     *  already shows it working; do not ask for another message. */
-    pendingPrompt?: boolean;
-    /** A queued status already describes this send; do not ask for another. */
-    pendingDelivery?: boolean;
     /**
      * The CONTROL PLANE holds an open turn for this session right now — pass
      * `serverHoldsOpenTurn(working)`, never `working.source === 'server'`.
@@ -115,27 +109,6 @@ export declare function sessionComposerReadiness(input: {
      * "indistinguishable from stuck" failure this module exists to prevent.
      */
     stalled?: boolean;
-    /**
-     * This page's own `/start` is bringing the computer up: its stage is
-     * `provisioning` or `starting`, or it has not answered yet. A stopped
-     * computer is then WAKING, not idle, and the composer must not claim the
-     * next message is what wakes it.
-     */
-    starting?: boolean;
-    /**
-     * The shared connection projection (`projectSessionConnection`).
-     *
-     * This is what replaced a settle TIMER here. The timer was the same mistake
-     * this module keeps having to unlearn: it guessed how long to stay quiet
-     * instead of asking whether anything was actually wrong, so it was always
-     * either too short (the notice flashed over a live session) or too long (a
-     * genuinely parked box announced itself late).
-     *
-     * `unknown` and `connecting` are WAITS. Only `waking` with no wake under
-     * way — the control plane saying the box is down, and nothing bringing it
-     * up — earns a notice: the asleep one.
-     */
-    connection?: SessionConnection;
 }): SessionComposerReadiness;
 /**
  * The last turn's shimmer, decided once in `SessionChat` and passed down to
@@ -145,7 +118,7 @@ export declare function sessionComposerReadiness(input: {
  * `GET .../turn`), already delay-hidden 300ms by the caller — never the raw
  * SSE slot, which this tab can miss frames from: a dropped end-of-turn frame
  * latched the slot busy and shimmered a finished answer until reload. A
- * transient sub-session (`sub-session-modal.tsx` mounts `SessionChat` with no
+ * transient sub-session (`legacy-subagent-chat.tsx` mounts `SessionChat` with no
  * `projectSessionId`) has no Kortix session row for `/turn` to answer about,
  * so it keeps the raw slot — the same split `session-layout.tsx` makes for
  * its busy indicator. A non-last turn is NEVER working: that is a fact about

package/dist/session/composer/session-composer-readiness.js

@@ -92,22 +92,11 @@ export function sessionComposerReadiness(input) {
             retryable: true,
         };
     }
-    if (input.connection === 'waking') {
-        // A PARKED / idle box: the control plane says the sandbox is not up, and
-        // nothing is actively booting — a genuine boot-stall is caught by `stalled`
-        // above, and the SDK no longer arms the stall clock for a parked box
-        // (`setOpenCodeHealth({ parked })`), so this never escalates to an infinite
-        // "taking longer than usual" spinner. The box resumes on the next SEND, so
-        // say exactly that: an honest idle state (RC-3). A wake already under way
-        // says nothing: opening the session wakes its computer in the background,
-        // and a send goes out as soon as it is up.
-        const waking = input.pendingPrompt || input.pendingDelivery || input.starting;
-        return { ready: false, notice: waking ? null : SESSION_NOTICE.idle, retryable: false };
-    }
-    // A wait is not a fault, and a routine wake is silent: `unknown` means
+    // A wait is not a fault, and sleep and wake are silent: `unknown` means
     // nothing has answered, `connecting` that the box is up and the runtime has
-    // not reached us yet, and a waking box comes up in the background while a
-    // send queues. A wake that goes wrong speaks through `stalled` or
+    // not reached us yet, and `waking` that the box is parked or coming up. A
+    // parked box wakes on the next send, so the user never needs to know it
+    // slept. A wake that goes wrong speaks through `stalled` or
     // `unreachable` above.
     return { ready: false, notice: null, retryable: false };
 }
@@ -119,7 +108,7 @@ export function sessionComposerReadiness(input) {
  * `GET .../turn`), already delay-hidden 300ms by the caller — never the raw
  * SSE slot, which this tab can miss frames from: a dropped end-of-turn frame
  * latched the slot busy and shimmered a finished answer until reload. A
- * transient sub-session (`sub-session-modal.tsx` mounts `SessionChat` with no
+ * transient sub-session (`legacy-subagent-chat.tsx` mounts `SessionChat` with no
  * `projectSessionId`) has no Kortix session row for `/turn` to answer about,
  * so it keeps the raw slot — the same split `session-layout.tsx` makes for
  * its busy indicator. A non-last turn is NEVER working: that is a fact about

package/dist/session/header/reminder-parts.d.ts

@@ -22,7 +22,7 @@ export declare function useReminderView(now: number): (reminder: SessionReminder
     nextAt: number;
     countdown: [string, string | null];
     share: number | null;
-    tone: "purple" | "red";
+    tone: "red" | "purple";
     pauseLabel: string;
     schedule: string;
     meta: string;

package/dist/session/header/session-site-header.js

@@ -25,7 +25,8 @@ import { SessionPendingApprovalsIndicator } from './session-pending-approvals-in
 import { SessionGoalIndicator } from './session-goal-indicator.js';
 import { SessionRemindersIndicator } from './session-reminders-indicator.js';
 import { SessionTitleInput } from './session-title-input.js';
-import { SubagentHoverCard, subagentTitle } from './subagent-hover-card.js';
+import { subagentTitle } from '../agents/agent-model.js';
+import { SubagentHoverCard } from './subagent-hover-card.js';
 import { Copy } from '../../icons/copy.js';
 import { Home } from '../../internal/icons/home.js';
 import { openSessionQuickView } from '../panel/open-session-quick-view.js';
@@ -41,7 +42,7 @@ import { cn } from '../../lib/utils.js';
 import { useSessionHistoryViewStore } from '../../internal/stores/session-history-view-store.js';
 import { useIsActionPanelOpen, useReadyChip, useToggleActionPanel, } from '../../internal/stores/kortix-computer-store.js';
 import { createProjectSession, directSubsessions, restartProjectSession, stopProjectSession } from '@kortix/sdk';
-import { qk, useProjectSession, useRuntimeSupports, useSessionParticipants, useSessionWatch, } from '@kortix/sdk/react';
+import { qk, useHasSessionDesktop, useProjectSession, useRuntimeSupports, useSessionParticipants, useSessionWatch, } from '@kortix/sdk/react';
 import { ArchiveIcon, ArrowsClockwiseIcon, BellIcon, BellSlashIcon, CaretDoubleLeftIcon, GitForkIcon, LinkSimpleIcon, CaretDownIcon, CodeSimpleIcon as Code2, FileArrowDownIcon as FileDown, FolderSimpleIcon, GlobeSimpleIcon, MonitorIcon, StackIcon as Layers, PencilSimpleIcon, PushPinIcon, PushPinSlashIcon, ArrowCounterClockwiseIcon as RotateCcw, ShareIcon as Share, SquareIcon as Square, TerminalIcon, TrashIcon, } from '@phosphor-icons/react';
 import { useMutation, useQueryClient } from '@tanstack/react-query';
 import { useMemo, useRef, useState } from 'react';
@@ -64,7 +65,9 @@ export function SessionSiteHeader({ sessionId, sessionTitle, isMobileView, leadi
     const localizedDevTools = useLocalizedUiCatalog(DEV_TOOLS);
     // A host that cannot reach the pty WebSocket turns the terminal off (`config.terminalEnabled`).
     const { terminalEnabled } = useUiHostConfig();
-    const devTools = useMemo(() => (terminalEnabled ? localizedDevTools : localizedDevTools.filter((tool) => tool.view !== 'terminal')), [localizedDevTools, terminalEnabled]);
+    // A template on a base other than Ubuntu 24.04, or an old image, has no desktop.
+    const hasDesktop = useHasSessionDesktop() === true;
+    const devTools = useMemo(() => localizedDevTools.filter((tool) => (tool.view !== 'terminal' || terminalEnabled) && (tool.view !== 'desktop' || hasDesktop)), [localizedDevTools, terminalEnabled, hasDesktop]);
     const router = useUiRouter();
     const pathname = useUiPathname();
     const queryClient = useQueryClient();

package/dist/session/header/subagent-hover-card.d.ts

@@ -1,7 +1,5 @@
 import type { ProjectRuntimeSession } from '@kortix/sdk';
 import { type ReactElement } from 'react';
-/** A subsession's own title, without OpenCode's "(@general subagent)" suffix. */
-export declare function subagentTitle(title: string): string;
 /**
  * The parent session's title, on hover: the subagent sessions it spawned.
  *

package/dist/session/header/subagent-hover-card.js

@@ -9,11 +9,8 @@ import { shortRelative } from '../actions/project-session-list-helpers.js';
 import { useTranslations } from '../../i18n/index.js';
 import { formatDistanceToNowStrict } from 'date-fns';
 import { useState } from 'react';
+import { subagentTitle } from '../agents/agent-model.js';
 import { childSessionHref } from '../tool/tools/session-spawn-urls.js';
-/** A subsession's own title, without OpenCode's "(@general subagent)" suffix. */
-export function subagentTitle(title) {
-    return title.replace(/\s*\(@[^)]*subagent\)$/, '');
-}
 /**
  * The parent session's title, on hover: the subagent sessions it spawned.
  *

package/dist/session/models/claude-connection-slot.d.ts

@@ -0,0 +1,11 @@
+/** Which Claude fix a failed turn needs, from the error text, if any. */
+export declare function claudeConnectionAction(text: string | null | undefined): 'connect' | 'reconnect' | null;
+/**
+ * The fix for a turn that failed on the viewer's Claude login: the provider
+ * list (Customize → Models → Providers), where Anthropic signs in with Claude,
+ * as every other subscription does. Renders on a project route only.
+ */
+export declare function ClaudeConnectionSlot({ action, className }: {
+    action: 'connect' | 'reconnect';
+    className?: string;
+}): import("react").JSX.Element | null;

package/dist/session/models/claude-connection-slot.js

@@ -0,0 +1,30 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button } from '../../primitives/button.js';
+import { useTranslations } from '../../i18n/index.js';
+import { useModelConnectionGate } from './use-model-connection-gate.js';
+/** The turn error kortixd writes when the session user has no Claude login (`CLAUDE_CONNECT_MESSAGE`). */
+const CLAUDE_CONNECT_MESSAGE = 'Connect your Claude subscription to use Claude models.';
+/** The turn error kortixd writes when Anthropic refused the stored login (`CLAUDE_RECONNECT_MESSAGE`). */
+const CLAUDE_RECONNECT_MESSAGE = 'Your Claude subscription login stopped working. Reconnect Claude to continue.';
+/** Which Claude fix a failed turn needs, from the error text, if any. */
+export function claudeConnectionAction(text) {
+    const value = (text ?? '').trim();
+    if (value.includes(CLAUDE_CONNECT_MESSAGE))
+        return 'connect';
+    if (value.includes(CLAUDE_RECONNECT_MESSAGE))
+        return 'reconnect';
+    return null;
+}
+/**
+ * The fix for a turn that failed on the viewer's Claude login: the provider
+ * list (Customize → Models → Providers), where Anthropic signs in with Claude,
+ * as every other subscription does. Renders on a project route only.
+ */
+export function ClaudeConnectionSlot({ action, className = 'mt-2 pl-7' }) {
+    const t = useTranslations('claudeSubscription');
+    const { canConnectProvider, openConnectProvider, modal } = useModelConnectionGate();
+    if (!canConnectProvider)
+        return null;
+    return (_jsxs("div", { className: className, children: [modal, _jsx(Button, { size: "sm", className: "active:scale-[0.96]", onClick: () => openConnectProvider('providers'), children: t(action === 'reconnect' ? 'reconnectClaude' : 'connectClaude') })] }));
+}

package/dist/session/models/model-availability.d.ts

@@ -21,9 +21,11 @@ export declare function unavailableModelConnection(model: {
     enabled?: boolean;
     available?: boolean;
     availability?: 'login' | 'provider';
+    providerID?: string;
+    provider?: string | null;
 }, options: {
     chatGptAvailable: boolean;
-}): 'chatgpt' | 'provider' | null;
+}): 'chatgpt' | 'claude' | 'provider' | null;
 export declare function resolveAvailableSelectedModel(selectedModel: ModelKey | null | undefined, isSelectableModel: (model: ModelKey) => boolean): ModelKey | null;
 /**
  * The name of the selected model when it cannot read an attached image, else null.

package/dist/session/models/model-availability.js

@@ -18,6 +18,9 @@ export function isRunnableModel(model) {
 export function unavailableModelConnection(model, options) {
     if (model.available !== false)
         return null;
+    // A Claude subscription model needs the caller's own Claude login, never a project provider.
+    if (model.providerID === 'claude-agent' || model.provider === 'claude-agent')
+        return 'claude';
     return model.availability === 'login' && options.chatGptAvailable ? 'chatgpt' : 'provider';
 }
 export function resolveAvailableSelectedModel(selectedModel, isSelectableModel) {

package/dist/session/models/model-selector.js

@@ -14,10 +14,10 @@ import { useSessionIds } from '../../providers/session-ids.js';
 import { useUiComponents } from '../../providers/ui-provider.js';
 import { Fragment, useCallback, useEffect, useMemo, useState } from 'react';
 import { ModelSearchEmpty } from './model-search-empty.js';
-import { isRunnableModel, resolveAvailableSelectedModel, unavailableModelConnection, } from './model-availability.js';
+import { resolveAvailableSelectedModel, unavailableModelConnection, } from './model-availability.js';
 import { isPickerGroupOpen, modelItemValue, pickerGroupId, pickerGroupLabel, buildPickerSections, splitModelLabel, } from './model-grouping.js';
 import { modelInDefaultView } from '@kortix/sdk';
-import { isSubscriptionModel, pickerModelName, shouldShowFreeTag } from './model-tags.js';
+import { isClaudeSubscriptionModel, isSubscriptionModel, pickerModelName, shouldShowFreeTag } from './model-tags.js';
 import { useModelConnectionGate } from './use-model-connection-gate.js';
 // Re-export for consumers
 export { Tag };
@@ -199,6 +199,9 @@ export function ModelSelector({ models, selectedModel, onSelect, defaultControls
         const q = search.toLowerCase();
         return models
             .filter((m) => m.enabled !== false &&
+            // Claude subscription models appear once the member signed in to Claude
+            // (Customize → Models → Anthropic), like ChatGPT subscription models.
+            !(isClaudeSubscriptionModel(m) && m.available === false) &&
             (!q ||
                 (m.modelName || '').toLowerCase().includes(q) ||
                 (m.modelID || '').toLowerCase().includes(q) ||
@@ -213,10 +216,7 @@ export function ModelSelector({ models, selectedModel, onSelect, defaultControls
     /** Is there anything to pick AT ALL, ignoring the search box? The empty
      *  state below branches on this: "no models match your search" and "you have
      *  no models" are different problems with different ways out. */
-    const hasAnyModel = useMemo(() => models.some((m) => m.enabled !== false), [models]);
-    /** Does this member already have ChatGPT subscription models? Then the row
-     *  manages their accounts instead of offering to connect one. */
-    const hasChatGptModels = useMemo(() => models.some((m) => isRunnableModel(m) && pickerGroupId(m) === 'codex'), [models]);
+    const hasAnyModel = useMemo(() => models.some((m) => m.enabled !== false && !(isClaudeSubscriptionModel(m) && m.available === false)), [models]);
     const grouped = useMemo(() => {
         const groups = new Map();
         for (const m of visibleModels) {
@@ -295,7 +295,8 @@ export function ModelSelector({ models, selectedModel, onSelect, defaultControls
         const connect = unavailableModelConnection(model, { chatGptAvailable });
         if (connect === 'chatgpt')
             return handleOpenChatGpt();
-        if (connect === 'provider')
+        // A Claude model signs in under Anthropic, in the provider list.
+        if (connect === 'claude' || connect === 'provider')
             return handleOpenProviderModal('providers');
         onSelect({ providerID: model.providerID, modelID: model.modelID });
         setOpen(false);
@@ -327,15 +328,13 @@ export function ModelSelector({ models, selectedModel, onSelect, defaultControls
                                                                     section.models.map((model) => (_jsx(ModelRow, { model: model, groupProviderID: section.providerID, groupProviderName: section.label, isSelected: availableSelectedModel?.providerID === model.providerID &&
                                                                             availableSelectedModel?.modelID === model.modelID, isAccountDefault: defaultControls?.accountDefault?.providerID === model.providerID &&
                                                                             defaultControls?.accountDefault?.modelID === model.modelID, defaultControls: rowDefaultControls, onSelect: handleSelect, connectLabel: tPooled('connect'), scope: "model", showSubscriptionTag: false }, `${section.id}:${model.providerID}:${model.modelID}`)))] })] }, section.id));
-                                            }), chatGptAvailable && !searching && (_jsxs(_Fragment, { children: [_jsx(CommandSeparator, {}), _jsx(CommandGroup, { forceMount: true, children: _jsxs(CommandItem, { value: "chatgpt-subscription", onSelect: handleOpenChatGpt, className: "cursor-pointer", children: [_jsx(ProviderLogo, { providerID: "codex", name: "ChatGPT", size: "small", className: "size-4 rounded-none bg-transparent" }), _jsx("span", { className: "text-foreground min-w-0 flex-1 truncate text-sm font-medium", children: hasChatGptModels
-                                                                        ? tPooled('manageChatGptAccounts')
-                                                                        : tPooled('useYourChatGpt') }), !hasChatGptModels && (_jsx("span", { className: "text-muted-foreground text-xs", children: tPooled('connect') }))] }) })] }))] })) : hasAnyModel ? (
+                                            })] })) : hasAnyModel ? (
                                     /* Models ARE connected — the SEARCH matched none of them.
                                        `grouped` is built from `visibleModels`, which is already
                                        filtered by `search`, so the branch below could not tell the
                                        two apart: typing "zzz" with 40 models connected showed
                                        "No models available" and a Connect-provider CTA. */
-                                    _jsx(ModelSearchEmpty, { search: search, modelCount: models.filter((model) => model.enabled !== false).length, onClear: () => setSearch(''), onUpgrade: showUpgradeOption ? handleUpgrade : undefined })) : (_jsxs("div", { className: "px-3 py-5 text-center", children: [_jsx("div", { className: "text-foreground text-sm font-medium", children: tModel('empty.title') }), _jsx("p", { className: "text-muted-foreground mx-auto mt-1 max-w-[220px] text-xs leading-5", children: showUpgradeOption
+                                    _jsx(ModelSearchEmpty, { search: search, modelCount: models.filter((model) => model.enabled !== false && !(isClaudeSubscriptionModel(model) && model.available === false)).length, onClear: () => setSearch(''), onUpgrade: showUpgradeOption ? handleUpgrade : undefined })) : (_jsxs("div", { className: "px-3 py-5 text-center", children: [_jsx("div", { className: "text-foreground text-sm font-medium", children: tModel('empty.title') }), _jsx("p", { className: "text-muted-foreground mx-auto mt-1 max-w-[220px] text-xs leading-5", children: showUpgradeOption
                                                     ? tModel('empty.upgradeDescription')
-                                                    : tModel('empty.description') }), _jsxs("div", { className: "mt-4 flex items-center justify-center gap-2", children: [showUpgradeOption && (_jsxs(Button, { type: "button", size: "xs", onClick: handleUpgrade, children: [_jsx(CreditCard, { className: "size-3.5" }), tModel('upgrade')] })), canConnectProvider && (_jsxs(Button, { type: "button", size: "xs", variant: showUpgradeOption ? 'outline' : 'default', onClick: () => handleOpenProviderModal('providers'), children: [_jsx(KeyRound, { className: "size-3.5" }), tModel('connectProvider')] })), chatGptAvailable && (_jsx(Button, { type: "button", size: "xs", variant: "outline", onClick: handleOpenChatGpt, children: tPooled('connectChatGpt') }))] })] })) })] }) })] })] }));
+                                                    : tModel('empty.description') }), _jsxs("div", { className: "mt-4 flex items-center justify-center gap-2", children: [showUpgradeOption && (_jsxs(Button, { type: "button", size: "xs", onClick: handleUpgrade, children: [_jsx(CreditCard, { className: "size-3.5" }), tModel('upgrade')] })), canConnectProvider && (_jsxs(Button, { type: "button", size: "xs", variant: showUpgradeOption ? 'outline' : 'default', onClick: () => handleOpenProviderModal('providers'), children: [_jsx(KeyRound, { className: "size-3.5" }), tModel('connectProvider')] }))] })] })) })] }) })] })] }));
 }

package/dist/session/models/model-tags.d.ts

@@ -9,6 +9,15 @@ export declare function shouldShowFreeTag(model: Pick<FlatModel, 'free' | 'model
 export declare function isSubscriptionModel(model: Pick<FlatModel, 'modelID'> & {
     provider?: string | null;
 }): boolean;
+/**
+ * A model that runs through Claude Code on the caller's own Claude Pro or Max
+ * plan (`claude-agent/<id>`, `@kortix/api-contract/claude-agent`). It never
+ * reaches the LLM gateway.
+ */
+export declare function isClaudeSubscriptionModel(model: {
+    provider?: string | null;
+    providerID?: string;
+}): boolean;
 /**
  * What the picker prints for a model.
  *

package/dist/session/models/model-tags.js

@@ -13,6 +13,14 @@ export function shouldShowFreeTag(model) {
 export function isSubscriptionModel(model) {
     return model.provider === 'codex' || model.modelID.startsWith('codex/');
 }
+/**
+ * A model that runs through Claude Code on the caller's own Claude Pro or Max
+ * plan (`claude-agent/<id>`, `@kortix/api-contract/claude-agent`). It never
+ * reaches the LLM gateway.
+ */
+export function isClaudeSubscriptionModel(model) {
+    return model.providerID === 'claude-agent' || model.provider === 'claude-agent';
+}
 /**
  * What the picker prints for a model.
  *

package/dist/session/panel/easy/easy-panel.js

@@ -47,7 +47,7 @@ export function EasyPanel() {
     // with `session-chat.tsx` so the two cannot disagree.
     const planInChat = usePlanInChat();
     // Null outside a `SessionPanelProvider` — `SessionChat` also renders
-    // read-only inside `sub-session-modal.tsx`, which has no panel at all.
+    // read-only inside `legacy-subagent-chat.tsx`, which has no panel at all.
     if (!panel)
         return null;
     const { files, context, apps, outputsDefaultOpen, sessionId, handleOpenOutput, openDetail } = panel;

package/dist/session/panel/easy/step-icon.js

@@ -11,7 +11,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * "what is it?".
  */
 import { cn } from '../../../lib/utils.js';
-import { ArchiveIcon as Archive, RobotIcon as Bot, BrainIcon as Brain, CodeIcon as Code, QuestionIcon as CircleHelp, NotePencilIcon as FilePen, FolderOpenIcon as FolderOpen, GlobeIcon as Globe, ClockCounterClockwiseIcon as History, ListChecksIcon as ListChecks, PlugIcon as Plug, MagnifyingGlassIcon as Search, SparkleIcon as Sparkles, TerminalIcon as Terminal, MagicWandIcon as Wand2, WrenchIcon as Wrench, LightningIcon as Zap, } from '@phosphor-icons/react';
+import { ArchiveIcon as Archive, RobotIcon as Bot, BrainIcon as Brain, CodeIcon as Code, QuestionIcon as CircleHelp, NotePencilIcon as FilePen, FlowArrowIcon as FlowArrow, FolderOpenIcon as FolderOpen, GlobeIcon as Globe, ClockCounterClockwiseIcon as History, ListChecksIcon as ListChecks, PlugIcon as Plug, MagnifyingGlassIcon as Search, SlidersHorizontalIcon as Sliders, SparkleIcon as Sparkles, TerminalIcon as Terminal, MagicWandIcon as Wand2, WrenchIcon as Wrench, LightningIcon as Zap, } from '@phosphor-icons/react';
 const FAMILY_ICON = {
     explore: Search,
     edit: FilePen,
@@ -23,6 +23,10 @@ const FAMILY_ICON = {
     create: Sparkles,
     plan: ListChecks,
     delegate: Bot,
+    // pi's workflow: several agents on one run.
+    workflow: FlowArrow,
+    // My Kortix's platform tools: settings of the project (agents, schedules, members, …).
+    platform: Sliders,
     sessions: History,
     memory: Brain,
     connectors: Plug,

package/dist/session/panel/mobile-tool-drawer.js

@@ -38,7 +38,7 @@ const TOOL_META = {
     browser: { label: 'Browser', Icon: GlobeIcon },
     files: { label: 'Files', Icon: FolderOpenIcon },
     audit: { label: 'Audit', Icon: ScrollIcon },
-    reminders: { label: 'Reminders', Icon: AlarmIcon },
+    reminders: { label: 'Loops', Icon: AlarmIcon },
     desktop: { label: 'Desktop', Icon: MonitorIcon },
 };
 export function MobileToolDrawer({ sessionId, projectId, projectSessionId, }) {

package/dist/session/panel/session-action-panel-column.js

@@ -134,7 +134,7 @@ hotkey = true, } = {}) {
         };
     }, [shouldHandleHotkey, toggleRight]);
     // No provider means no panel to render: `SessionChat` also renders read-only
-    // inside `sub-session-modal.tsx`, outside `SessionLayout`. Mobile has no
+    // inside `legacy-subagent-chat.tsx`, outside `SessionLayout`. Mobile has no
     // column either — at 375px a side column is the whole screen, so the cards
     // stay in the bottom drawer they have always used.
     if (!panel || isMobile)

package/dist/session/panel/session-desktop.js

@@ -17,6 +17,11 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
  * viewer to the slowest one, and a background tab stops acking frames, so a
  * forgotten tab would slow the stream for everyone watching. It reconnects,
  * on a fresh keyframe, when the tab is shown again.
+ *
+ * A computer without a desktop (a template on another base, or a computer
+ * that booted an image built before it had one) says so; the header does not offer the panel there. The
+ * control bar appears only once the desktop answers, never over the proxy's
+ * "not answering" page.
  */
 import { useTranslations } from '../../i18n/index.js';
 import { Button } from '../../primitives/button.js';
@@ -30,9 +35,17 @@ import { PanelWidthButton } from '../../files/viewer/viewer-actions.js';
 import { CloseButton, DetailSidebarToggle } from '../../files/viewer/viewer-chrome.js';
 import { cn } from '../../lib/utils.js';
 import { probePreviewPort } from '@kortix/sdk';
+import { useHasSessionDesktop } from '@kortix/sdk/react';
 import { ArrowSquareOutIcon, MonitorIcon } from '@phosphor-icons/react';
 import { useEffect, useRef, useState, useSyncExternalStore } from 'react';
 export const DESKTOP_URL = 'http://localhost:6901/';
+/** How often the panel asks again until the desktop answers. */
+const PROBE_INTERVAL_MS = 3_000;
+/**
+ * The proxy answers 502 for a stopped desktop only after ~5 s (measured 4.8 s:
+ * it retries the port first). The probe's 3 s default reads that as `unknown`.
+ */
+const PROBE_TIMEOUT_MS = 10_000;
 const subscribeVisibility = (onChange) => {
     document.addEventListener('visibilitychange', onChange);
     return () => document.removeEventListener('visibilitychange', onChange);
@@ -48,27 +61,41 @@ export function SessionDesktop({ projectId, projectSessionId, onClose, }) {
     }).url;
     const frameRef = useRef(null);
     const [control, setControl] = useState(false);
-    // 'off' = the proxy answered 502/503/504: nothing listens on 6901.
-    const [state, setState] = useState('probing');
+    // `undefined` until the session's daemon answers its health probe.
+    const hasDesktop = useHasSessionDesktop();
+    // `unreachable` = the proxy answered 502/503/504: nothing listens on 6901.
+    const [probe, setProbe] = useState('unknown');
     const [attempt, setAttempt] = useState(0);
     const visible = useSyncExternalStore(subscribeVisibility, tabVisible, () => true);
-    const live = !!src && state === 'on';
+    const live = probe === 'reachable';
+    // Ask until the desktop answers. The first answer is often `unknown`: the
+    // preview cookie arrives with the frame's first load. A stopped desktop
+    // answers `unreachable`, and the panel shows it again once it starts.
     useEffect(() => {
-        if (!src)
+        if (!src || !hasDesktop || !visible)
             return;
         const abort = new AbortController();
-        void probePreviewPort(src, { signal: abort.signal }).then((probe) => {
-            if (!abort.signal.aborted)
-                setState(probe === 'unreachable' ? 'off' : 'on');
-        });
-        return () => abort.abort();
-    }, [src, attempt]);
+        let timer;
+        const ask = async () => {
+            const result = await probePreviewPort(src, { signal: abort.signal, timeoutMs: PROBE_TIMEOUT_MS });
+            if (abort.signal.aborted)
+                return;
+            setProbe(result);
+            if (result !== 'reachable')
+                timer = setTimeout(ask, PROBE_INTERVAL_MS);
+        };
+        void ask();
+        return () => {
+            abort.abort();
+            clearTimeout(timer);
+        };
+    }, [src, hasDesktop, visible, attempt]);
     const takeOver = () => {
         setControl(true);
         frameRef.current?.focus();
     };
-    return (_jsxs("div", { className: "bg-background flex h-full min-h-0 min-w-0 flex-col", children: [_jsxs("div", { className: "flex shrink-0 items-center gap-1 px-2 py-1", children: [_jsx(DetailSidebarToggle, { className: "size-7" }), _jsx(MonitorIcon, { className: "text-muted-foreground ml-1 size-3.5 shrink-0" }), _jsx("span", { className: "truncate text-sm font-medium", children: t('title') }), _jsx("div", { className: "flex-1" }), _jsxs(ButtonGroup, { className: "shrink-0", children: [_jsx(Button, { variant: "secondary", size: "icon", className: "size-7", disabled: !live, "aria-label": t('openTab'), onClick: () => src && window.open(src, '_blank', 'noopener,noreferrer'), children: _jsx(ArrowSquareOutIcon, { className: "size-3.5" }) }), _jsx(PanelWidthButton, { isMobile: isMobile }), _jsx(CloseButton, { onClose: onClose })] })] }), _jsxs("div", { className: "flex min-h-0 flex-1 flex-col gap-2 px-3 pb-3", children: [_jsx("div", { "data-slot": "desktop-screen", "data-control": control ? 'user' : 'agent', className: cn('bg-muted relative min-h-0 flex-1 overflow-hidden rounded-xl ring-1 ring-border transition-shadow', control && 'ring-2 ring-primary'), children: state === 'off' ? (_jsxs("div", { className: "text-muted-foreground flex h-full flex-col items-center justify-center gap-3 px-6 text-center text-sm", children: [_jsx(MonitorIcon, { className: "size-10 opacity-20" }), _jsx("p", { children: t('offline') }), _jsxs("p", { className: "text-xs", children: [t('start'), " ", _jsx("code", { children: "kortix-desktop start" }), "."] }), _jsx(Button, { variant: "secondary", size: "sm", onClick: () => {
-                                        setState('probing');
-                                        setAttempt((n) => n + 1);
-                                    }, children: t('retry') })] })) : !live || !visible ? (_jsx("div", { className: "flex h-full items-center justify-center", children: _jsx(Loading, { className: "size-4" }) })) : (_jsxs(_Fragment, { children: [_jsx("iframe", { ref: frameRef, src: src, title: t('title'), className: "h-full w-full border-0", sandbox: framePolicy('app', src).sandbox, allow: "clipboard-read; clipboard-write; autoplay; fullscreen", tabIndex: control ? 0 : -1 }), !control && (_jsx("button", { type: "button", "aria-label": t('takeOver'), "data-slot": "desktop-shield", className: "absolute inset-0 cursor-pointer", onClick: takeOver }))] })) }), _jsx("div", { className: "flex h-9 shrink-0 items-center justify-center gap-3 text-sm", children: live && (_jsxs(_Fragment, { children: [_jsx("span", { className: "text-muted-foreground", children: control ? t('userControl') : t('agentControl') }), _jsx(Button, { variant: control ? 'secondary' : 'default', size: "sm", className: "h-7 rounded-full px-3", "aria-pressed": control, onClick: control ? () => setControl(false) : takeOver, children: control ? t('returnControl') : t('takeOver') })] })) })] })] }));
+    return (_jsxs("div", { className: "bg-background flex h-full min-h-0 min-w-0 flex-col", children: [_jsxs("div", { className: "flex shrink-0 items-center gap-1 px-2 py-1", children: [_jsx(DetailSidebarToggle, { className: "size-7" }), _jsx(MonitorIcon, { className: "text-muted-foreground ml-1 size-3.5 shrink-0" }), _jsx("span", { className: "truncate text-sm font-medium", children: t('title') }), _jsx("div", { className: "flex-1" }), _jsxs(ButtonGroup, { className: "shrink-0", children: [_jsx(Button, { variant: "secondary", size: "icon", className: "size-7", disabled: !live, "aria-label": t('openTab'), onClick: () => src && window.open(src, '_blank', 'noopener,noreferrer'), children: _jsx(ArrowSquareOutIcon, { className: "size-3.5" }) }), _jsx(PanelWidthButton, { isMobile: isMobile }), _jsx(CloseButton, { onClose: onClose })] })] }), _jsxs("div", { className: "flex min-h-0 flex-1 flex-col gap-2 px-3 pb-3", children: [_jsx("div", { "data-slot": "desktop-screen", "data-control": control ? 'user' : 'agent', className: cn('bg-muted relative min-h-0 flex-1 overflow-hidden rounded-xl ring-1 ring-border transition-shadow', control && 'ring-2 ring-primary'), children: hasDesktop === false ? (_jsx(DesktopNotice, { title: t('noDesktop'), hint: t('noDesktopHint') })) : probe === 'unreachable' ? (_jsx(DesktopNotice, { title: t('offline'), hint: _jsxs(_Fragment, { children: [t('start'), " ", _jsx("code", { children: "kortix-desktop start" }), "."] }), children: _jsx(Button, { variant: "secondary", size: "sm", onClick: () => setAttempt((n) => n + 1), children: t('retry') }) })) : !hasDesktop || !src || !visible ? (_jsx("div", { className: "flex h-full items-center justify-center", children: _jsx(Loading, { className: "size-4" }) })) : (_jsxs(_Fragment, { children: [_jsx("iframe", { ref: frameRef, src: src, title: t('title'), className: "h-full w-full border-0", sandbox: framePolicy('app', src).sandbox, allow: "clipboard-read; clipboard-write; autoplay; fullscreen", tabIndex: control ? 0 : -1 }), !control && (_jsx("button", { type: "button", "aria-label": t('takeOver'), "data-slot": "desktop-shield", className: "absolute inset-0 cursor-pointer", onClick: takeOver }))] })) }), _jsx("div", { className: "flex h-9 shrink-0 items-center justify-center gap-3 text-sm", children: live && (_jsxs(_Fragment, { children: [_jsx("span", { className: "text-muted-foreground", children: control ? t('userControl') : t('agentControl') }), _jsx(Button, { variant: control ? 'secondary' : 'default', size: "sm", className: "h-7 rounded-full px-3", "aria-pressed": control, onClick: control ? () => setControl(false) : takeOver, children: control ? t('returnControl') : t('takeOver') })] })) })] })] }));
+}
+function DesktopNotice({ title, hint, children }) {
+    return (_jsxs("div", { className: "text-muted-foreground flex h-full flex-col items-center justify-center gap-3 px-6 text-center text-sm", children: [_jsx(MonitorIcon, { className: "size-10 opacity-20" }), _jsx("p", { children: title }), _jsx("p", { className: "text-xs", children: hint }), children] }));
 }

package/dist/session/panel/session-panel-provider.d.ts

@@ -45,7 +45,7 @@ export declare const SessionPanelContext: import("react").Context<SessionPanelVa
  * The panel value, or null outside a provider.
  *
  * Optional on purpose, exactly as `useOptionalSidebar` is: `SessionChat` has a
- * second call site in `sub-session-modal.tsx` that renders it read-only and
+ * second call site in `legacy-subagent-chat.tsx` that renders it read-only and
  * OUTSIDE `SessionLayout`. The floating overlay self-gates to null there rather
  * than every call site having to know which tree it is in.
  */

package/dist/session/panel/session-panel-provider.js

@@ -44,9 +44,7 @@ import { useSessionComposerPrefillStore } from '../composer/stores/session-compo
 import { panelToRestore, rememberedPanelOf, useSessionPanelMemoryStore, } from '../../internal/stores/session-panel-memory-store.js';
 import { useUserPreferencesStore } from '../../internal/stores/user-preferences-store.js';
 import { getProjectSession, SANDBOX_PORTS } from '@kortix/sdk';
-import { qk } from '@kortix/sdk/react';
 import { FileTextIcon as FileText } from '@phosphor-icons/react';
-import { useQueryClient } from '@tanstack/react-query';
 import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, } from 'react';
 import { AppPreview, AppPreviewBooting } from './easy/app-preview.js';
 import { isWideDeliverable, neighborOutputs, outputKey, quickBrowserOutput, } from './easy/easy-panel-logic.js';
@@ -67,7 +65,7 @@ export const SessionPanelContext = createContext(null);
  * The panel value, or null outside a provider.
  *
  * Optional on purpose, exactly as `useOptionalSidebar` is: `SessionChat` has a
- * second call site in `sub-session-modal.tsx` that renders it read-only and
+ * second call site in `legacy-subagent-chat.tsx` that renders it read-only and
  * OUTSIDE `SessionLayout`. The floating overlay self-gates to null there rather
  * than every call site having to know which tree it is in.
  */
@@ -479,7 +477,6 @@ export function SessionPanelProvider({ sessionId, isSessionBusy = false, project
     const sidePanelOpen = useKortixComputerStore((s) => s.isSidePanelOpen);
     const advancedPanel = useUserPreferencesStore((s) => s.preferences.panelMode === 'advanced');
     const isMobile = useIsMobile();
-    const queryClient = useQueryClient();
     // Nothing is recorded before the arrival is decided: until then the panel is
     // closed by the arrival itself, not by the person.
     const [restoreSettled, setRestoreSettled] = useState(false);
@@ -497,12 +494,11 @@ export function SessionPanelProvider({ sessionId, isSessionBusy = false, project
         let alive = true;
         // A FRESH row, never the cached one: it can be 30 s old, and reopening a
         // Terminal on a session stopped since then wakes its computer (measured).
-        void queryClient
-            .fetchQuery({
-            queryKey: qk.project.session(projectId, projectSessionId),
-            queryFn: () => getProjectSession(projectId, projectSessionId, { showErrors: false }),
-            staleTime: 0,
-        })
+        // Its own request, not the query cache's: `fetchQuery` joins the page's
+        // in-flight fetch of the same row, a refetch on arrival cancels that
+        // (`CancelledError`), and the restore was dropped on about half the
+        // returns from another session (measured).
+        void getProjectSession(projectId, projectSessionId, { showErrors: false })
             .then((row) => {
             if (!alive)
                 return;
@@ -531,7 +527,7 @@ export function SessionPanelProvider({ sessionId, isSessionBusy = false, project
             alive = false;
             setRestoreSettled(true);
         };
-    }, [isActivePanel, memoryKey, isMobile, projectId, projectSessionId, queryClient, sessionId]);
+    }, [isActivePanel, memoryKey, isMobile, projectId, projectSessionId, sessionId]);
     // A file preview reopens once the transcript has derived its output, and only
     // if the person has not opened something else meanwhile.
     useEffect(() => {

package/dist/session/prompts/question-prompt.js

@@ -21,7 +21,9 @@ import { Close } from '../../icons/close.js';
 // ---------------------------------------------------------------------------
 function QuestionMarkdown({ content, className }) {
     return (_jsx("div", { className: cn('question-md', className), children: _jsx(ReactMarkdown, { remarkPlugins: [remarkGfm], components: {
-                p: ({ children }) => _jsx("p", { className: "my-1 leading-relaxed", children: children }),
+                // `pre-line`: a single newline is a line break. A question's lines (a workflow's
+                // title, phases and agent count) would otherwise run together as one paragraph.
+                p: ({ children }) => _jsx("p", { className: "my-1 leading-relaxed whitespace-pre-line", children: children }),
                 strong: ({ children }) => (_jsx("strong", { className: "text-foreground font-semibold", children: children })),
                 em: ({ children }) => _jsx("em", { className: "text-muted-foreground", children: children }),
                 ul: ({ children }) => _jsx("ul", { className: "my-0.5 list-disc pl-4", children: children }),