@kortix/ui 0.14.12 → 0.14.14

package/dist/session/agents/workflow-run-controls.js

@@ -0,0 +1,141 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Badge } from '../../primitives/badge.js';
+import { Button } from '../../primitives/button.js';
+import { ButtonGroup } from '../../primitives/button-group.js';
+import { Hint } from '../../primitives/hint.js';
+import Loading from '../../primitives/loading.js';
+import { errorToast, successToast } from '../../primitives/toast.js';
+import { useTranslations } from '../../i18n/index.js';
+import { FloppyDiskIcon, PauseIcon, PlayIcon, SquareIcon, WarningIcon } from '@phosphor-icons/react';
+import { useEffect, useMemo, useState } from 'react';
+import { WORKFLOW_LARGE_AGENT_COUNT } from '@kortix/sdk';
+import { useSessionWorkflows } from '@kortix/sdk/react';
+import { parseWorkflowRun } from '../tool/tools/workflow-run.js';
+import { useSessionPromptSend } from './session-prompt.js';
+/**
+ * One workflow run's controls, for the run card in the chat and the strip's
+ * "Workflows" group: Claude Code's `/workflows` keys as buttons. Pause or
+ * resume (`p`), stop the run (`x`), save its script as a workflow (`s`), and,
+ * per agent row, restart (`r`). Every control goes to the box that runs the
+ * run: the session that called `workflow`, or a background run's runner.
+ */
+/** A run's large-run warning: more agents than Claude Code's "Large workflow" threshold, or the run says so. */
+export function isLargeRun(run) {
+    return run.large === true || run.agents.length > WORKFLOW_LARGE_AGENT_COUNT;
+}
+/** The file name a run saves as: its saved name, else its title in kebab case. */
+export function workflowFileName(run) {
+    const base = (run.name || run.title || '')
+        .toLowerCase()
+        .normalize('NFKD')
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 48)
+        .replace(/-+$/g, '');
+    return base || 'workflow';
+}
+/**
+ * The live copy of a run: a background run's progress lives on its runner's box,
+ * so it is read from there (`useSessionWorkflows(project, runner)`, polled while it
+ * runs) and keeps updating after this session's turn ended. A foreground run is the
+ * card's own metadata. `controlSessionId` is the session whose box takes the controls.
+ */
+export function useLiveWorkflowRun(projectId, sessionId, run) {
+    const runner = run?.background?.sessionId;
+    const { data } = useSessionWorkflows(projectId, runner, { enabled: !!projectId && !!runner });
+    const live = useMemo(() => {
+        if (!run || !runner || !data)
+            return null;
+        const match = data.find((candidate) => candidate.runId === run.runId) ?? (run.runId ? undefined : data[0]);
+        const parsed = match ? parseWorkflowRun(match) : null;
+        // The runner runs it in the foreground; this card still knows it as a background run.
+        return parsed ? { ...parsed, background: run.background } : null;
+    }, [run, runner, data]);
+    if (!run)
+        return { run: null, controlSessionId: undefined, fromRunner: false };
+    if (runner)
+        return { run: live ?? run, controlSessionId: runner, fromRunner: !!live };
+    return { run, controlSessionId: sessionId, fromRunner: false };
+}
+/** The current time, every second while `active`: a live run's elapsed labels tick. */
+export function useNow(active) {
+    const [now, setNow] = useState(() => Date.now());
+    useEffect(() => {
+        if (!active)
+            return;
+        const timer = setInterval(() => setNow(Date.now()), 1_000);
+        return () => clearInterval(timer);
+    }, [active]);
+    return now;
+}
+/** The prompt "Save" sends to the session that owns the run. */
+export function useSaveWorkflowPrompt() {
+    const t = useTranslations('multiAgent.workflow');
+    return (run) => t('savePrompt', { title: run.title || run.name || run.runId, runId: run.runId, file: `.kortix/workflows/${workflowFileName(run)}.js` });
+}
+export function LargeRunBadge() {
+    const t = useTranslations('multiAgent.workflow');
+    return (_jsx(Hint, { label: t('largeHint'), side: "top", children: _jsxs(Badge, { variant: "warning", size: "sm", children: [_jsx(WarningIcon, { weight: "fill", "aria-hidden": true }), t('large')] }) }));
+}
+export function WorkflowRunControls({ projectId, controlSessionId, ownerSessionId, run }) {
+    const t = useTranslations('multiAgent.workflow');
+    const { control } = useSessionWorkflows(projectId, controlSessionId, { enabled: false });
+    const send = useSessionPromptSend(ownerSessionId);
+    const savePrompt = useSaveWorkflowPrompt();
+    const running = run.status === 'running';
+    const canControl = !!projectId && !!controlSessionId && !!run.runId && running;
+    const pending = control.isPending ? control.variables?.body.action : undefined;
+    const act = (action) => control.mutate({ runId: run.runId, body: { action } }, {
+        onError: (error) => errorToast(t(`failed.${action}`), { description: error instanceof Error ? error.message : undefined }),
+    });
+    const save = async () => {
+        if (!send)
+            return;
+        try {
+            await send(savePrompt(run));
+            successToast(t('saveSent'));
+        }
+        catch (error) {
+            errorToast(t('saveFailed'), { description: error instanceof Error ? error.message : undefined });
+        }
+    };
+    const buttons = [
+        canControl && (_jsx(Hint, { label: run.paused ? t('resumeHint') : t('pauseHint'), side: "top", children: _jsx(Button, { type: "button", variant: "ghost", size: "icon-xs", "aria-label": run.paused ? t('resume') : t('pause'), disabled: !!pending, onClick: (event) => {
+                    event.stopPropagation();
+                    act(run.paused ? 'resume' : 'pause');
+                }, children: pending === 'pause' || pending === 'resume' ? (_jsx(Loading, { className: "size-3 shrink-0" })) : run.paused ? (_jsx(PlayIcon, { weight: "fill", className: "size-3 shrink-0" })) : (_jsx(PauseIcon, { weight: "fill", className: "size-3 shrink-0" })) }) }, "pause")),
+        canControl && (_jsx(Hint, { label: t('stopHint'), side: "top", children: _jsx(Button, { type: "button", variant: "ghost", size: "icon-xs", "aria-label": t('stop'), disabled: !!pending, onClick: (event) => {
+                    event.stopPropagation();
+                    act('stop');
+                }, children: pending === 'stop' ? _jsx(Loading, { className: "size-3 shrink-0" }) : _jsx(SquareIcon, { weight: "fill", className: "size-2.5 shrink-0" }) }) }, "stop")),
+        // A saved workflow is a file already; any other run can become one.
+        !run.name && send && run.runId && (_jsx(Hint, { label: t('saveHint'), side: "top", children: _jsx(Button, { type: "button", variant: "ghost", size: "icon-xs", "aria-label": t('save'), onClick: (event) => {
+                    event.stopPropagation();
+                    void save();
+                }, children: _jsx(FloppyDiskIcon, { className: "size-3 shrink-0" }) }) }, "save")),
+    ].filter(Boolean);
+    if (buttons.length === 0)
+        return null;
+    return buttons.length === 1 ? _jsx(_Fragment, { children: buttons }) : _jsx(ButtonGroup, { children: buttons });
+}
+/** `restart_agent` for one agent row of a run, on the box that runs it. */
+export function useRestartAgent(projectId, controlSessionId, run) {
+    const t = useTranslations('multiAgent.workflow');
+    const { control } = useSessionWorkflows(projectId, controlSessionId, { enabled: false });
+    const enabled = !!projectId && !!controlSessionId && !!run?.runId && run.status === 'running';
+    const restarting = control.isPending && control.variables?.body.action === 'restart_agent' ? control.variables.body.session_id : undefined;
+    return {
+        enabled,
+        restarting,
+        restart: (agent) => {
+            if (!enabled || !agent.sessionId || !run)
+                return;
+            control.mutate({ runId: run.runId, body: { action: 'restart_agent', session_id: agent.sessionId } }, {
+                onError: (error) => errorToast(t('failed.restart', { label: agent.label }), {
+                    description: error instanceof Error ? error.message : undefined,
+                }),
+            });
+        },
+    };
+}

package/dist/session/composer/ComposerCard.d.ts

@@ -71,4 +71,4 @@ export interface ComposerCardDerived {
     noModelsConnected: boolean;
 }
 export type ComposerCardProps = SessionChatInputProps & ComposerCardDerived;
-export declare function ComposerCard({ tHardcodedUi, isDragOver, handleDragEnter, handleDragOver, handleDragLeave, handleDropFiles, attachedFiles, promptAttachmentItems, removeAttachedFile, retryAttachedFile, pastes, removePaste, onOpenPastedContent, commandAttachmentPlan, editorDisabled, editorRef, setEditorRef, editorPlaceholder, animatePlaceholder, handleSubmit, handleArrowUpAtStart, setIsEmpty, handleDocChange, allSessions, slashActions, handleSelectAction, dockId, setMenuOpen, fileInputRef, handleFileSelect, sessionId, handleAttachClick, primaryAgents, availableSelectedModel, agentMenuOpen, setAgentMenuOpen, modelMenuOpen, setModelMenuOpen, reasoningMenuOpen, setReasoningMenuOpen, isEmpty, canSubmit, submitDisabled, attachmentFailed, modelRejectingImages, imagesUnsupportedReason, modelUnavailable, agentUnavailable, noModelsConnected, agents, commands, slashFiles, models, notice, disabled, lockForQuestion, lockForApproval, questionButtonLabel, questionActive, submitLabel, questionCanAct, escCount, isBusy, isSending, onStop, stopDisabled, canStop, modelsLoading, modelRequired, onModelChange, modelDefaultControls, providers, variants, selectedVariant, onVariantChange, projectId, toolbarSlot, rewind, selectedAgent, onAgentChange, noAccessibleAgents, onContextClick, messages, underbarPlacement, agentPickerCompact, slashMenuPlacement, cardClassName, onArrowUpAtStart, }: ComposerCardProps): import("react").JSX.Element;
+export declare function ComposerCard({ tHardcodedUi, isDragOver, handleDragEnter, handleDragOver, handleDragLeave, handleDropFiles, attachedFiles, promptAttachmentItems, removeAttachedFile, retryAttachedFile, pastes, removePaste, onOpenPastedContent, commandAttachmentPlan, editorDisabled, editorRef, setEditorRef, editorPlaceholder, animatePlaceholder, handleSubmit, handleArrowUpAtStart, setIsEmpty, handleDocChange, allSessions, slashActions, handleSelectAction, dockId, setMenuOpen, fileInputRef, handleFileSelect, sessionId, handleAttachClick, primaryAgents, availableSelectedModel, agentMenuOpen, setAgentMenuOpen, modelMenuOpen, setModelMenuOpen, reasoningMenuOpen, setReasoningMenuOpen, isEmpty, canSubmit, submitDisabled, attachmentFailed, modelRejectingImages, imagesUnsupportedReason, modelUnavailable, agentUnavailable, noModelsConnected, agents, commands, slashFiles, models, notice, disabled, lockForQuestion, lockForApproval, questionButtonLabel, questionActive, submitLabel, questionCanAct, escCount, isBusy, isSending, onStop, stopDisabled, canStop, modelsLoading, modelRequired, onModelChange, modelDefaultControls, providers, variants, selectedVariant, onVariantChange, projectId, toolbarSlot, underbarSlot, rewind, selectedAgent, onAgentChange, noAccessibleAgents, onContextClick, messages, underbarPlacement, agentPickerCompact, slashMenuPlacement, cardClassName, onArrowUpAtStart, }: ComposerCardProps): import("react").JSX.Element;

package/dist/session/composer/ComposerCard.js

@@ -21,7 +21,7 @@ export function ComposerCard({ tHardcodedUi, isDragOver, handleDragEnter, handle
 // Raw props the moved JSX reads; `{...props}` carries the rest. These
 // defaults mirror `ComposerImpl`'s, because the spread passes the raw
 // values, not the component's defaulted locals.
-agents = EMPTY_AGENTS, commands = EMPTY_COMMANDS, slashFiles = EMPTY_SLASH_FILES, models = EMPTY_MODELS, notice = null, disabled = false, lockForQuestion = false, lockForApproval = false, questionButtonLabel = null, questionActive = false, submitLabel = null, questionCanAct = true, escCount = 0, isBusy = false, isSending = false, onStop, stopDisabled = false, canStop = true, modelsLoading = false, modelRequired = false, onModelChange, modelDefaultControls, providers, variants = EMPTY_VARIANTS, selectedVariant = null, onVariantChange, projectId, toolbarSlot, rewind, selectedAgent = null, onAgentChange, noAccessibleAgents = false, onContextClick, messages, underbarPlacement = 'below', agentPickerCompact = false, slashMenuPlacement = 'above', cardClassName, onArrowUpAtStart, }) {
+agents = EMPTY_AGENTS, commands = EMPTY_COMMANDS, slashFiles = EMPTY_SLASH_FILES, models = EMPTY_MODELS, notice = null, disabled = false, lockForQuestion = false, lockForApproval = false, questionButtonLabel = null, questionActive = false, submitLabel = null, questionCanAct = true, escCount = 0, isBusy = false, isSending = false, onStop, stopDisabled = false, canStop = true, modelsLoading = false, modelRequired = false, onModelChange, modelDefaultControls, providers, variants = EMPTY_VARIANTS, selectedVariant = null, onVariantChange, projectId, toolbarSlot, underbarSlot, rewind, selectedAgent = null, onAgentChange, noAccessibleAgents = false, onContextClick, messages, underbarPlacement = 'below', agentPickerCompact = false, slashMenuPlacement = 'above', cardClassName, onArrowUpAtStart, }) {
     const cardRef = useRef(null);
     const { attachAccept } = useUiHostConfig();
     const inlineUnderbar = underbarPlacement === 'inline';
@@ -51,7 +51,7 @@ agents = EMPTY_AGENTS, commands = EMPTY_COMMANDS, slashFiles = EMPTY_SLASH_FILES
                                             // the div and immediately fights the caret we are placing.
                                             e.preventDefault();
                                             editorRef.current?.focus();
-                                        }, children: [_jsx(AnimatedComposerPlaceholder, { placeholder: editorPlaceholder, active: animatePlaceholder }), _jsx(Suspense, { fallback: _jsx(ComposerEditorFallback, {}), children: _jsx(ComposerEditorLazy, { ref: setEditorRef, placeholder: animatePlaceholder ? '' : editorPlaceholder, disabled: editorDisabled, onSubmit: handleSubmit, onArrowUpAtStart: onArrowUpAtStart ? handleArrowUpAtStart : undefined, onEmptyChange: setIsEmpty, onDocChange: handleDocChange, agents: agents, sessions: allSessions ?? [], currentSessionId: sessionId, commands: commands, actions: slashActions, files: slashFiles, onSelectAction: handleSelectAction, slashDockSelector: `#${dockId}`, onMenuOpenChange: setMenuOpen }) })] }), _jsx("input", { ref: fileInputRef, type: "file", accept: attachAccept ?? DEFAULT_ATTACH_ACCEPT, multiple: true, className: "hidden", onChange: handleFileSelect }), _jsx(ComposerToolbar, { leading: inlineUnderbar ? (_jsx(ComposerUnderbar, { variant: "inline", agentPickerCompact: agentPickerCompact, onAttachClick: handleAttachClick, agents: primaryAgents, selectedAgent: selectedAgent, onAgentChange: onAgentChange, agentMenuOpen: agentMenuOpen, onAgentMenuOpenChange: setAgentMenuOpen, noAccessibleAgents: noAccessibleAgents, messages: messages, models: models, selectedModel: availableSelectedModel, onContextClick: onContextClick })) : null, modelsLoading: modelsLoading, models: models, selectedModel: availableSelectedModel, onModelChange: onModelChange, modelDefaultControls: modelDefaultControls, providers: providers, modelRequired: modelRequired, modelMenuOpen: modelMenuOpen, onModelMenuOpenChange: setModelMenuOpen, reasoningMenuOpen: reasoningMenuOpen, onReasoningMenuOpenChange: setReasoningMenuOpen, variants: variants, selectedVariant: selectedVariant, onVariantChange: onVariantChange, projectId: projectId, 
+                                        }, children: [_jsx(AnimatedComposerPlaceholder, { placeholder: editorPlaceholder, active: animatePlaceholder }), _jsx(Suspense, { fallback: _jsx(ComposerEditorFallback, {}), children: _jsx(ComposerEditorLazy, { ref: setEditorRef, placeholder: animatePlaceholder ? '' : editorPlaceholder, disabled: editorDisabled, onSubmit: handleSubmit, onArrowUpAtStart: onArrowUpAtStart ? handleArrowUpAtStart : undefined, onEmptyChange: setIsEmpty, onDocChange: handleDocChange, agents: agents, sessions: allSessions ?? [], currentSessionId: sessionId, commands: commands, actions: slashActions, files: slashFiles, onSelectAction: handleSelectAction, slashDockSelector: `#${dockId}`, onMenuOpenChange: setMenuOpen }) })] }), _jsx("input", { ref: fileInputRef, type: "file", accept: attachAccept ?? DEFAULT_ATTACH_ACCEPT, multiple: true, className: "hidden", onChange: handleFileSelect }), _jsx(ComposerToolbar, { leading: inlineUnderbar ? (_jsx(ComposerUnderbar, { variant: "inline", agentPickerCompact: agentPickerCompact, onAttachClick: handleAttachClick, agents: primaryAgents, selectedAgent: selectedAgent, onAgentChange: onAgentChange, agentMenuOpen: agentMenuOpen, onAgentMenuOpenChange: setAgentMenuOpen, noAccessibleAgents: noAccessibleAgents, messages: messages, models: models, selectedModel: availableSelectedModel, onContextClick: onContextClick, agentsSlot: underbarSlot })) : null, modelsLoading: modelsLoading, models: models, selectedModel: availableSelectedModel, onModelChange: onModelChange, modelDefaultControls: modelDefaultControls, providers: providers, modelRequired: modelRequired, modelMenuOpen: modelMenuOpen, onModelMenuOpenChange: setModelMenuOpen, reasoningMenuOpen: reasoningMenuOpen, onReasoningMenuOpenChange: setReasoningMenuOpen, variants: variants, selectedVariant: selectedVariant, onVariantChange: onVariantChange, projectId: projectId, 
                                         // Inline placement has no under-row, so the slot (the session
                                         // overrides gear, meta indicator) rides the toolbar itself. With
                                         // the 'below' placement the ComposerUnderbar further down renders
@@ -59,5 +59,5 @@ agents = EMPTY_AGENTS, commands = EMPTY_COMMANDS, slashFiles = EMPTY_SLASH_FILES
                                         toolbarSlot: inlineUnderbar ? toolbarSlot : undefined, rewind: rewind, isSending: isSending, isBusy: isBusy, onStop: onStop, stopDisabled: stopDisabled, canStop: canStop, escCount: escCount, lockForQuestion: lockForQuestion, questionButtonLabel: questionButtonLabel, submitLabel: submitLabel, questionCanAct: questionCanAct, hasText: !isEmpty, canSubmit: canSubmit, submitDisabled: submitDisabled ||
                                             attachmentFailed ||
                                             modelRejectingImages !== null ||
-                                            commandAttachmentPlan.kind === 'refuse', attachmentFailed: attachmentFailed, attachmentUnsupported: imagesUnsupportedReason, disabled: disabled, modelUnavailable: modelUnavailable, agentUnavailable: agentUnavailable, onSubmit: () => handleSubmit() })] })] })] }), _jsx(ModelConnectionBar, { show: noModelsConnected }), _jsx(ImagesUnsupportedBar, { modelName: noModelsConnected ? null : modelRejectingImages }), inlineUnderbar ? null : (_jsx(ComposerUnderbar, { onAttachClick: handleAttachClick, agents: primaryAgents, selectedAgent: selectedAgent, onAgentChange: onAgentChange, agentMenuOpen: agentMenuOpen, onAgentMenuOpenChange: setAgentMenuOpen, noAccessibleAgents: noAccessibleAgents, messages: messages, models: models, selectedModel: availableSelectedModel, onContextClick: onContextClick, toolbarSlot: toolbarSlot })), slashMenuPlacement === 'below' && (_jsx("div", { id: dockId, className: "absolute top-full right-4 left-4 z-99 mt-3.5" }))] }));
+                                            commandAttachmentPlan.kind === 'refuse', attachmentFailed: attachmentFailed, attachmentUnsupported: imagesUnsupportedReason, disabled: disabled, modelUnavailable: modelUnavailable, agentUnavailable: agentUnavailable, onSubmit: () => handleSubmit() })] })] })] }), _jsx(ModelConnectionBar, { show: noModelsConnected }), _jsx(ImagesUnsupportedBar, { modelName: noModelsConnected ? null : modelRejectingImages }), inlineUnderbar ? null : (_jsx(ComposerUnderbar, { onAttachClick: handleAttachClick, agents: primaryAgents, selectedAgent: selectedAgent, onAgentChange: onAgentChange, agentMenuOpen: agentMenuOpen, onAgentMenuOpenChange: setAgentMenuOpen, noAccessibleAgents: noAccessibleAgents, messages: messages, models: models, selectedModel: availableSelectedModel, onContextClick: onContextClick, toolbarSlot: toolbarSlot, agentsSlot: underbarSlot })), slashMenuPlacement === 'below' && (_jsx("div", { id: dockId, className: "absolute top-full right-4 left-4 z-99 mt-3.5" }))] }));
 }

package/dist/session/composer/agent-selector.js

@@ -1,6 +1,5 @@
 'use client';
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { Badge } from '../../primitives/badge.js';
 import { Button } from '../../primitives/button.js';
 import { CommandGroup, CommandInput, CommandItem, CommandList, CommandPopover, CommandPopoverContent, CommandPopoverTrigger, CommandSeparator, } from '../../primitives/command.js';
 import Hint from '../../primitives/hint.js';
@@ -8,7 +7,7 @@ import { useTranslations } from '../../i18n/index.js';
 import { useUiHostConfig } from '../../providers/ui-provider.js';
 import { cn } from '../../lib/utils.js';
 import { TRIGGER_CARET_CLASS, triggerVariants } from '../../primitives/trigger-variants.js';
-import { capitalizeWords, isMetaAgentName, META_AGENT_DISPLAY_NAME } from '../../_vendor/kortix-shared.js';
+import { capitalizeWords, isMyKortixAgentName, MY_KORTIX_DISPLAY_NAME } from '../../_vendor/kortix-shared.js';
 import { CaretDownIcon, CheckIcon } from '@phosphor-icons/react';
 import { AgentMark } from '../../internal/components/agent-mark.js';
 import { createContext, useContext, useEffect, useMemo, useState } from 'react';
@@ -42,7 +41,7 @@ export function agentDisplayLabel(agents, selectedAgent) {
     const name = resolveDisplayedAgentName(composerSelectableAgents(agents), selectedAgent);
     if (!name)
         return 'Agent';
-    return isMetaAgentName(name) ? META_AGENT_DISPLAY_NAME : capitalizeWords(name);
+    return isMyKortixAgentName(name) ? MY_KORTIX_DISPLAY_NAME : capitalizeWords(name);
 }
 export function AgentSelector({ agents, selectedAgent, onSelect, disabled = false, triggerLabelClassName, unavailableHint, open: controlledOpen, onOpenChange, compact = false, appearance = 'chip', }) {
     const tHardcodedUi = useTranslations('hardcodedUi');
@@ -60,7 +59,7 @@ export function AgentSelector({ agents, selectedAgent, onSelect, disabled = fals
         return agents.filter((a) => offeredNames.has(a.name));
     }, [agents, offeredAgents]);
     const primaryAgents = useMemo(() => composerSelectableAgents(offered), [offered]);
-    const label = (name) => agentLabels?.[name] ?? (isMetaAgentName(name) ? META_AGENT_DISPLAY_NAME : capitalizeWords(name));
+    const label = (name) => agentLabels?.[name] ?? (isMyKortixAgentName(name) ? MY_KORTIX_DISPLAY_NAME : capitalizeWords(name));
     // A `flash` state, a `prevAgentRef` feeding it, two effects and a 400ms
     // timer used to live here. Nothing ever READ `flash` — it was written on
     // every agent change and rendered nowhere, so the whole apparatus bought a
@@ -77,8 +76,8 @@ export function AgentSelector({ agents, selectedAgent, onSelect, disabled = fals
             (agentLabels?.[a.name] ?? '').toLowerCase().includes(q) ||
             (a.description || '').toLowerCase().includes(q));
     }, [primaryAgents, search, agentLabels]);
-    const filteredMeta = useMemo(() => filteredPrimary.filter((a) => isMetaAgentName(a.name)), [filteredPrimary]);
-    const filteredProject = useMemo(() => filteredPrimary.filter((a) => !isMetaAgentName(a.name)), [filteredPrimary]);
+    const filteredMeta = useMemo(() => filteredPrimary.filter((a) => isMyKortixAgentName(a.name)), [filteredPrimary]);
+    const filteredProject = useMemo(() => filteredPrimary.filter((a) => !isMyKortixAgentName(a.name)), [filteredPrimary]);
     // The place's agents, in its order, then every other agent.
     const featured = useContext(FeaturedAgentsContext);
     const filteredFeatured = useMemo(() => (featured?.names ?? []).flatMap((name) => {
@@ -106,16 +105,11 @@ export function AgentSelector({ agents, selectedAgent, onSelect, disabled = fals
     const field = appearance === 'field';
     const fieldTrigger = (caret, props) => (_jsxs("button", { type: "button", className: cn(triggerVariants(), 'h-9 w-full'), ...props, children: [_jsxs("span", { className: "flex min-w-0 items-center gap-2", children: [triggerMark, _jsx("span", { className: "truncate", children: displayName })] }), caret ? _jsx(CaretDownIcon, { className: cn(TRIGGER_CARET_CLASS, 'size-4') }) : null] }));
     /**
-     * One agent: name, its type, its description, and a check when it is the
-     * one in use.
+     * One agent: its mark, name and description (My Kortix: what picking it
+     * does), and a check when it is the one in use.
      *
-     * The type is a `Badge` on the row rather than a `CommandGroup` heading.
-     * Headings only earn their place when there is more than one section to
-     * tell apart, and there usually is not — most projects have no meta agents
-     * at all, so the list rendered a lone "Agents" label over a single group,
-     * captioning something that needed no caption. A badge says the same thing
-     * where it is actually useful (on the row that differs) and disappears
-     * entirely when every agent is the same kind.
+     * No type badge and no group heading: My Kortix sorts first, a separator
+     * follows it, and its own line says what it does.
      *
      * Selection is shown ONCE, by the check plus the tinted row. It used to be
      * said three times — check, tinted row, AND a heavier font weight on the
@@ -131,7 +125,7 @@ export function AgentSelector({ agents, selectedAgent, onSelect, disabled = fals
             className: cn('items-start gap-2 py-2', isSelected && 'bg-primary/[0.06]'), onSelect: () => {
                 onSelect(agent.name);
                 setOpen(false);
-            }, children: [agent.description ? (_jsx(AgentMark, { slug: agent.name, size: 28, tile: 36 })) : (_jsx(AgentMark, { slug: agent.name, size: 14 })), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsxs("div", { className: "flex min-w-0 items-center gap-1.5", children: [_jsx("span", { className: "text-foreground truncate text-sm font-medium", children: label(agent.name) }), meta && (_jsx(Badge, { variant: "outline", size: "xs", className: "shrink-0 font-normal", children: tHardcodedUi.raw('i18nComplete.textc78ffe195710') }))] }), agent.description && (_jsx("p", { className: "text-muted-foreground truncate text-xs", children: agent.description }))] }), isSelected && (
+            }, children: [agent.description || meta ? (_jsx(AgentMark, { slug: agent.name, size: 28, tile: 36 })) : (_jsx(AgentMark, { slug: agent.name, size: 14 })), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("span", { className: "text-foreground block truncate text-sm font-medium", children: label(agent.name) }), meta ? (_jsx("p", { className: "text-muted-foreground text-xs", children: t('myKortixRoutes') })) : agent.description ? (_jsx("p", { className: "text-muted-foreground line-clamp-2 text-xs text-pretty", children: agent.description })) : null] }), isSelected && (
                 // `mt-0.5` optically centres the 16px check against the first line
                 // rather than the top edge of the text box.
                 _jsx(CheckIcon, { className: "text-foreground mt-0.5 size-4 shrink-0" }))] }, agent.name));
@@ -173,11 +167,11 @@ export function AgentSelector({ agents, selectedAgent, onSelect, disabled = fals
             // The mark alone: the name is the tooltip and the menu's checked row.
             // A placeholder name has no mark, so it shows as text.
             triggerMark ?? _jsx("span", { className: cn('max-w-[100px] truncate', triggerLabelClassName), children: displayName })) : (_jsxs(_Fragment, { children: [triggerMark, _jsx("span", { className: cn('max-w-[100px] truncate', triggerLabelClassName), children: displayName }), _jsx(CaretDownIcon, { className: cn('size-3 transition-transform duration-moderate ease-out', open && 'rotate-180') })] })) })) }));
-    return (_jsxs(CommandPopover, { open: open, onOpenChange: setOpen, children: [compact ? (_jsx(Hint, { side: "top", label: displayName, children: trigger })) : (trigger), _jsxs(CommandPopoverContent, { side: "top", align: "start", sideOffset: 8, className: "w-[min(300px,calc(100vw-1.5rem))]", children: [_jsx("div", { className: showSearch ? undefined : 'sr-only', children: _jsx(CommandInput, { compact: true, placeholder: tHardcodedUi.raw('componentsSessionSessionChatInput.line231JsxAttrPlaceholderSearchAgents'), value: search, onValueChange: setSearch }) }), _jsxs(CommandList, { className: "max-h-[320px]", children: [filteredFeatured.length > 0 && featured ? (
+    return (_jsxs(CommandPopover, { open: open, onOpenChange: setOpen, children: [compact ? (_jsx(Hint, { side: "top", label: displayName, children: trigger })) : (trigger), _jsxs(CommandPopoverContent, { side: "top", align: "start", sideOffset: 8, className: "w-[min(340px,calc(100vw-1.5rem))]", children: [_jsx("div", { className: showSearch ? undefined : 'sr-only', children: _jsx(CommandInput, { compact: true, placeholder: tHardcodedUi.raw('componentsSessionSessionChatInput.line231JsxAttrPlaceholderSearchAgents'), value: search, onValueChange: setSearch }) }), _jsxs(CommandList, { className: "max-h-[320px]", children: [filteredFeatured.length > 0 && featured ? (
                             // Two groups, so each earns its heading: the place's agents, then the rest.
-                            _jsxs(_Fragment, { children: [_jsx(CommandGroup, { forceMount: true, heading: featured.label, className: "[&_[cmdk-group-items]]:flex [&_[cmdk-group-items]]:flex-col [&_[cmdk-group-items]]:gap-px", children: filteredFeatured.map((agent) => renderAgentItem(agent, isMetaAgentName(agent.name))) }), filteredPrimary.length > filteredFeatured.length && (_jsx(CommandGroup, { forceMount: true, heading: featured.restLabel, className: "[&_[cmdk-group-items]]:flex [&_[cmdk-group-items]]:flex-col [&_[cmdk-group-items]]:gap-px", children: filteredPrimary
+                            _jsxs(_Fragment, { children: [_jsx(CommandGroup, { forceMount: true, heading: featured.label, className: "[&_[cmdk-group-items]]:flex [&_[cmdk-group-items]]:flex-col [&_[cmdk-group-items]]:gap-px", children: filteredFeatured.map((agent) => renderAgentItem(agent, isMyKortixAgentName(agent.name))) }), filteredPrimary.length > filteredFeatured.length && (_jsx(CommandGroup, { forceMount: true, heading: featured.restLabel, className: "[&_[cmdk-group-items]]:flex [&_[cmdk-group-items]]:flex-col [&_[cmdk-group-items]]:gap-px", children: filteredPrimary
                                             .filter((agent) => !filteredFeatured.includes(agent))
-                                            .map((agent) => renderAgentItem(agent, isMetaAgentName(agent.name))) }))] })) : filteredPrimary.length > 0 && (
+                                            .map((agent) => renderAgentItem(agent, isMyKortixAgentName(agent.name))) }))] })) : filteredPrimary.length > 0 && (
                             // `gap-px` between rows: a selected row and a hovered row next to it
                             // otherwise draw one merged grey block.
                             _jsxs(CommandGroup, { forceMount: true, className: "[&_[cmdk-group-items]]:flex [&_[cmdk-group-items]]:flex-col [&_[cmdk-group-items]]:gap-px", children: [filteredMeta.map((agent) => renderAgentItem(agent, true)), filteredMeta.length > 0 && filteredProject.length > 0 && (_jsx(CommandSeparator, { className: "my-1" })), filteredProject.map((agent) => renderAgentItem(agent, false))] })), filteredPrimary.length === 0 && search.trim() && (_jsxs("div", { className: "text-muted-foreground py-8 text-center text-xs", children: [tHardcodedUi.raw('componentsSessionSessionChatInput.line273JsxTextNoAgentsMatchLdquo'), search.trim(), tHardcodedUi.raw('componentsSessionSessionChatInput.line273JsxTextRdquo')] }))] })] })] }));

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

@@ -52,5 +52,7 @@ export interface ComposerUnderbarProps {
     /** See `SessionChatInputProps.agentPickerCompact`. */
     agentPickerCompact?: boolean;
     toolbarSlot?: React.ReactNode;
+    /** Right of the agent picker: the session's agents line. Same row, no added height. */
+    agentsSlot?: React.ReactNode;
 }
-export declare function ComposerUnderbar({ onAttachClick, agents, selectedAgent, agentMenuOpen, onAgentMenuOpenChange, onAgentChange, noAccessibleAgents, messages, models, selectedModel, onContextClick, variant, agentPickerCompact, toolbarSlot, }: ComposerUnderbarProps): import("react").JSX.Element;
+export declare function ComposerUnderbar({ onAttachClick, agents, selectedAgent, agentMenuOpen, onAgentMenuOpenChange, onAgentChange, noAccessibleAgents, messages, models, selectedModel, onContextClick, variant, agentPickerCompact, toolbarSlot, agentsSlot, }: ComposerUnderbarProps): import("react").JSX.Element;

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

@@ -14,7 +14,7 @@ import { TokenProgress } from './token-progress.js';
 const NO_AGENT_SELECT = () => { };
 /** Stable identity so the empty roster doesn't remount the picker per render. */
 const EMPTY_AGENTS = [];
-export function ComposerUnderbar({ onAttachClick, agents, selectedAgent, agentMenuOpen, onAgentMenuOpenChange, onAgentChange, noAccessibleAgents = false, messages, models, selectedModel, onContextClick, variant = 'row', agentPickerCompact = false, toolbarSlot, }) {
+export function ComposerUnderbar({ onAttachClick, agents, selectedAgent, agentMenuOpen, onAgentMenuOpenChange, onAgentChange, noAccessibleAgents = false, messages, models, selectedModel, onContextClick, variant = 'row', agentPickerCompact = false, toolbarSlot, agentsSlot, }) {
     const t = useTranslations('threads');
     const { contextMeterEnabled } = useUiHostConfig();
     /*
@@ -55,5 +55,5 @@ export function ComposerUnderbar({ onAttachClick, agents, selectedAgent, agentMe
             : 'kortix-composer-underbar flex items-center justify-between gap-2 px-px pt-1.5 pb-2', children: [_jsxs("div", { className: "flex min-w-0 items-center gap-1", children: [_jsx(Hint, { side: "top", label: t('attachFiles'), children: _jsx(Button, { type: "button", variant: "ghost", size: "icon-base", onClick: onAttachClick, "aria-label": t('attachFiles'), 
                             // `hit-area-3` — the ≈29px ghost chip clears the 44px mobile tap
                             // floor only with the shared pseudo-element extension.
-                            className: "text-muted-foreground hit-area-3 rounded-lg", children: _jsx(Paperclip, { className: "size-4 shrink-0" }) }) }), _jsx(AgentSelector, { compact: agentPickerCompact, agents: noAccessibleAgents ? EMPTY_AGENTS : agents, selectedAgent: selectedAgent, open: agentMenuOpen, onOpenChange: onAgentMenuOpenChange, onSelect: onAgentChange ?? NO_AGENT_SELECT, triggerLabelClassName: "max-w-[7rem]", unavailableHint: noAccessibleAgents ? NO_AGENT_ACCESS_MESSAGE : undefined })] }), _jsxs("div", { className: "flex items-center gap-1", children: [(inline && !messages) || !contextMeterEnabled ? null : (_jsx(TokenProgress, { messages: messages, models: models, selectedModel: selectedModel, onContextClick: onContextClick })), toolbarSlot] })] }));
+                            className: "text-muted-foreground hit-area-3 rounded-lg", children: _jsx(Paperclip, { className: "size-4 shrink-0" }) }) }), _jsx(AgentSelector, { compact: agentPickerCompact, agents: noAccessibleAgents ? EMPTY_AGENTS : agents, selectedAgent: selectedAgent, open: agentMenuOpen, onOpenChange: onAgentMenuOpenChange, onSelect: onAgentChange ?? NO_AGENT_SELECT, triggerLabelClassName: "max-w-[7rem]", unavailableHint: noAccessibleAgents ? NO_AGENT_ACCESS_MESSAGE : undefined }), agentsSlot] }), _jsxs("div", { className: "flex items-center gap-1", children: [(inline && !messages) || !contextMeterEnabled ? null : (_jsx(TokenProgress, { messages: messages, models: models, selectedModel: selectedModel, onContextClick: onContextClick })), toolbarSlot] })] }));
 }

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

@@ -234,6 +234,11 @@ export interface SessionChatInputProps {
     aboveSlot?: React.ReactNode;
     inputSlot?: React.ReactNode;
     toolbarSlot?: React.ReactNode;
+    /**
+     * Rides the under-row right of the agent picker, in both placements: the
+     * session's agents line (`AgentsLine`). It must not add height to the row.
+     */
+    underbarSlot?: React.ReactNode;
     /**
      * Where the under-row's controls live — attach, the agent picker and the
      * context ring.

package/dist/session/composer/composer.js

@@ -5,7 +5,8 @@ import { useUiHostConfig } from '../../providers/ui-provider.js';
 import { useTranslations } from '../../i18n/index.js';
 import { cn } from '../../lib/utils.js';
 import { isImageFile } from '../../internal/lib/utils/file-utils.js';
-import { usePromptAttachments, useRuntimeSessions } from '@kortix/sdk/react';
+import { useProjectConfig, usePromptAttachments, useRuntimeSessions } from '@kortix/sdk/react';
+import { useActiveSpace } from '../../internal/stores/active-space-store.js';
 import { newPastedContentId, splitPastedContent, trimPastedText } from '../../_vendor/kortix-shared.js';
 import { memo, useCallback, useEffect, useId, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore, } from 'react';
 import { extractClipboardFiles } from './clipboard-files.js';
@@ -16,7 +17,6 @@ import { isModelRequiredButUnavailable, NO_MODEL_AVAILABLE_ACTION_MESSAGE, NO_MO
 import { useModelConnectionGate } from '../models/use-model-connection-gate.js';
 import { NO_AGENT_ACCESS_HINT, NO_AGENT_ACCESS_LABEL } from './composer-agent-access.js';
 import { useComposerDropZone } from './composer-drop-zone.js';
-import { useComposerEscapeStop } from './hooks/use-composer-escape-stop.js';
 import { finishedDraftUploads, keepUnsentUploadFile, restoreDraftUploads } from './draft/draft-uploads.js';
 import { useComposerDraft } from './draft/use-composer-draft.js';
 import { commandBlocker, sendBlocker, sendBlockerMessage } from './send-blockers.js';
@@ -110,7 +110,7 @@ function setDocumentWithoutStealingFocus(handle, doc) {
     }
 }
 function ComposerImpl(props) {
-    const { onSend, promptAttachments: hostPromptAttachments, isBusy = false, sessionWorking, runtimeReady = true, onStop, stopDisabled = false, canStop = true, isSending = false, rewind, agents = EMPTY_AGENTS, selectedAgent = null, onAgentChange, noAccessibleAgents = false, commands: runtimeCommands = EMPTY_COMMANDS, 
+    const { onSend, promptAttachments: hostPromptAttachments, isBusy = false, sessionWorking, runtimeReady = true, onStop, stopDisabled = false, isSending = false, rewind, agents = EMPTY_AGENTS, selectedAgent = null, onAgentChange, noAccessibleAgents = false, commands: runtimeCommands = EMPTY_COMMANDS, 
     /** Whether the live command list has EVER resolved — see `planUnresolvedCommandChip`. */
     commandsResolved = false, slashFiles = EMPTY_SLASH_FILES, onCommand, onHoldCommand, models = EMPTY_MODELS, selectedModel = null, onModelChange, modelDefaultControls, variants = EMPTY_VARIANTS, selectedVariant = null, onVariantChange, messages, sessionId, projectId, draftScope = null, draftActive = true, disabled = false, notice = null, onNoticeRetry, clearOnSend = true, modelRequired = false, modelsLoading = false, autoFocus, placeholder = 'Ask anything…', hint, onArrowUpAtStart, prefill = null, onPrefillApplied, attachRequestId = null, providers, onContextClick, onCompactClick, inputSlot, toolbarSlot, underbarPlacement = 'below', slashMenuPlacement = 'above', cardClassName, quoteRequests = NO_QUOTE_REQUESTS, onQuoteRequestsApplied, lockForQuestion = false, lockForApproval = false, onCustomAnswer, questionButtonLabel = null, questionCanAct = true, onQuestionAction, escCount = 0, parentClassName, } = props;
     const tI18nComplete = useTranslations('hardcodedUi.i18nComplete');
@@ -317,7 +317,19 @@ function ComposerImpl(props) {
         handleDocChange(doc, isEmpty);
     }, [handleDocChange]);
     const { data: allSessions } = useRuntimeSessions();
-    const primaryAgents = useMemo(() => agents.filter((a) => !a.hidden && a.mode !== 'subagent'), [agents]);
+    // Scope the startable agents to the active space (the sidebar's Spaces
+    // selection): in a space you start only that space's agents. The current
+    // agent is always kept so a session's own agent never disappears while you
+    // are viewing another space. No space selected = every agent, as before.
+    const [activeSpace] = useActiveSpace(projectId ?? '');
+    const scopeConfig = useProjectConfig(projectId);
+    const primaryAgents = useMemo(() => {
+        const base = agents.filter((a) => !a.hidden && a.mode !== 'subagent');
+        if (!activeSpace || !scopeConfig)
+            return base;
+        const spaceByName = new Map(scopeConfig.agents.map((a) => [a.name, a.space ?? null]));
+        return base.filter((a) => spaceByName.get(a.name) === activeSpace || a.name === selectedAgent);
+    }, [agents, activeSpace, scopeConfig, selectedAgent]);
     const editorDisabled = disabled || lockForApproval;
     const appendAttachedFiles = useCallback((files) => {
         // The host keeps files in its own store: they go there, not to the session.
@@ -676,12 +688,6 @@ function ComposerImpl(props) {
     const canSubmit = !isEmpty ||
         attachedFiles.length > 0 ||
         (!lockForQuestion && (quotes.length > 0 || pastes.length > 0));
-    useComposerEscapeStop({
-        editorElement,
-        enabled: isBusy && canStop && !stopDisabled && !isSending && !lockForQuestion && !props.submitLabel,
-        hasDraft: canSubmit,
-        onStop,
-    });
     /**
      * No agent may run this prompt. Refused here rather than at the server:
      * `lockForQuestion` is exempt because answering an open question is not a new

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

@@ -1,9 +1,9 @@
 'use client';
-import { jsx as _jsx } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useTranslations } from '../../../i18n/index.js';
 import { cn } from '../../../lib/utils.js';
 import { EditorContent, useEditor } from '@tiptap/react';
-import { forwardRef, useEffect, useImperativeHandle, useMemo, useRef } from 'react';
+import { forwardRef, useEffect, useImperativeHandle, useMemo, useRef, useState } from 'react';
 import { textToParagraphs } from '../composer-logic.js';
 import { COMPOSER_TEXT_METRICS } from '../composer-text-metrics.js';
 import { useLatestRef } from '../hooks/use-latest-ref.js';
@@ -15,6 +15,7 @@ import { isCursorOnFirstVisualLine } from './first-visual-line.js';
 import { MentionNode } from './mention-node.js';
 import { serializeDocument } from './serialize.js';
 import { createSuggestionExtension } from './suggestion.js';
+import { UltracodeHighlight } from './ultracode.js';
 /**
  * Wraps `onEmptyChange` so it fires ONLY on the empty<->non-empty boundary.
  * Exported (rather than kept as an inline `useEditor({ onUpdate })` closure)
@@ -161,8 +162,16 @@ export function insertTextAtCursor(editor, text) {
         return;
     editor.commands.insertContent(content);
 }
+/** The dismiss shortcut as the person's keyboard prints it. */
+function dismissKeyLabel() {
+    const platform = typeof navigator !== 'undefined' ? navigator.platform || navigator.userAgent : '';
+    return /Mac|iPhone|iPad/.test(platform) ? '⌥W' : 'Alt+W';
+}
 export const ComposerEditor = forwardRef(function ComposerEditor({ placeholder, disabled, autoFocus = false, onSubmit, onArrowUpAtStart, onEmptyChange, onDocChange, agents, sessions, currentSessionId, commands, onSelectCommand, onSelectAction, actions, files, slashDockSelector, onMenuOpenChange, }, ref) {
     const t = useTranslations('threads');
+    const tUltracode = useTranslations('multiAgent.ultracode');
+    // A marked `ultracode` keyword: the one-line hint under the text says what it does.
+    const [ultracodeActive, setUltracodeActive] = useState(false);
     const tI18nComplete = useTranslations('hardcodedUi.i18nComplete');
     const defaultActions = useMemo(() => localizedSlashActions(tI18nComplete), [tI18nComplete]);
     // Mirrors use-composer-focus.ts's onTypeAheadRef: @tiptap/react only
@@ -277,6 +286,8 @@ export const ComposerEditor = forwardRef(function ComposerEditor({ placeholder,
         extensions: [
             ...baseExtensions(() => placeholderRef.current),
             MentionNode,
+            // `setUltracodeActive` is a state setter: stable, so freezing it at construction is safe.
+            UltracodeHighlight.configure({ onActiveChange: setUltracodeActive }),
             // The one `@tiptap/suggestion` code path both `@` and `/` register
             // through (editor/suggestion.ts's `createSuggestionExtension`).
             // Built fresh every render like every extension above, but only the
@@ -427,10 +438,10 @@ export const ComposerEditor = forwardRef(function ComposerEditor({ placeholder,
         isEmpty: () => editor?.isEmpty ?? true,
         getElement: () => (editor && !editor.isDestroyed ? editor.view.dom : null),
     }), [editor]);
-    return (_jsx(EditorContent, { editor: editor, className: cn(
-        // `text-base` (16px) on mobile, NOT 15px: iOS Safari force-zooms the
-        // page on focus for any input under 16px, and the composer is the one
-        // field on the screen. `sm:text-sm` above 640px, which is the size
-        // `styles/components.css`'s slash-trigger rule already documents.
-        'kortix-composer-editor w-full text-sm', disabled && 'opacity-50') }));
+    return (_jsxs(_Fragment, { children: [_jsx(EditorContent, { editor: editor, className: cn(
+                // `text-base` (16px) on mobile, NOT 15px: iOS Safari force-zooms the
+                // page on focus for any input under 16px, and the composer is the one
+                // field on the screen. `sm:text-sm` above 640px, which is the size
+                // `styles/components.css`'s slash-trigger rule already documents.
+                'kortix-composer-editor w-full text-sm', disabled && 'opacity-50') }), ultracodeActive ? (_jsxs("p", { "data-slot": "ultracode-hint", className: "text-muted-foreground mt-1 truncate text-xs", children: [tUltracode('hint'), _jsx("span", { "aria-hidden": true, className: "px-1", children: "\u00B7" }), tUltracode('dismiss', { key: dismissKeyLabel() })] })) : null] }));
 });

package/dist/session/composer/editor/ultracode.d.ts

@@ -0,0 +1,34 @@
+import { Extension } from '@tiptap/core';
+import type { Node as ProseMirrorNode } from '@tiptap/pm/model';
+import { PluginKey, type EditorState, type Transaction } from '@tiptap/pm/state';
+import { DecorationSet } from '@tiptap/pm/view';
+/** The utility classes of a marked keyword: the mention chip's tint, no padding (the caret must not jump). */
+export declare const ULTRACODE_MARK_CLASS = "kortix-ultracode rounded-sm bg-primary/[0.08] font-medium text-foreground";
+export interface UltracodeRange {
+    from: number;
+    to: number;
+}
+/** Every occurrence of the keyword in a document, as document positions. */
+export declare function findUltracodeRanges(doc: ProseMirrorNode): UltracodeRange[];
+/** True for a plain-text keyword check (the sent prompt, a test). Same rule as the editor mark. */
+export declare function hasUltracodeKeyword(text: string): boolean;
+export interface UltracodeState {
+    /** The person dismissed the keyword for this prompt. */
+    dismissed: boolean;
+    ranges: UltracodeRange[];
+    /** At least one marked keyword: the host shows the hint. */
+    active: boolean;
+    decorations: DecorationSet;
+}
+export declare const ultracodePluginKey: PluginKey<UltracodeState>;
+/** The next state after a transaction: a dismiss meta sets it, an empty document resets it. */
+export declare function nextUltracodeState(tr: Transaction, previous: UltracodeState, state: EditorState): UltracodeState;
+/** Dismiss the keyword for this prompt. Returns false when nothing is marked. */
+export declare function dismissUltracode(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
+/** Alt+W anywhere, or Backspace with the caret right after a marked keyword. */
+export declare function isUltracodeDismissKey(event: Pick<KeyboardEvent, 'key' | 'code' | 'altKey' | 'ctrlKey' | 'metaKey' | 'shiftKey'>, state: EditorState): boolean;
+export interface UltracodeOptions {
+    /** Fires when the hint should appear or go: a marked keyword exists, or none does. */
+    onActiveChange?: (active: boolean) => void;
+}
+export declare const UltracodeHighlight: Extension<UltracodeOptions, any>;

package/dist/session/composer/editor/ultracode.js

@@ -0,0 +1,127 @@
+import { Extension } from '@tiptap/core';
+import { Plugin, PluginKey } from '@tiptap/pm/state';
+import { Decoration, DecorationSet } from '@tiptap/pm/view';
+/**
+ * The `ultracode` keyword, as Claude Code's dynamic workflows treat it: a
+ * prompt that holds the word runs as a workflow of agents. The composer marks
+ * each occurrence in place and the host shows a one-line hint, so the person
+ * sees the opt-in before they send. The prompt text never changes: the word
+ * is sent as typed, and the agent reads it.
+ *
+ * Alt+W (Option+W on a Mac), or Backspace right after a marked word, dismisses
+ * the mark and the hint for this prompt. A dismissed prompt stays dismissed
+ * while the person keeps typing; an empty composer (the prompt was sent or
+ * cleared) arms the keyword again.
+ */
+/** Whole word, any case. `\b` keeps `ultracoder` and `myultracode` plain text. */
+const KEYWORD = /\bultracode\b/gi;
+/** The utility classes of a marked keyword: the mention chip's tint, no padding (the caret must not jump). */
+export const ULTRACODE_MARK_CLASS = 'kortix-ultracode rounded-sm bg-primary/[0.08] font-medium text-foreground';
+/** Every occurrence of the keyword in a document, as document positions. */
+export function findUltracodeRanges(doc) {
+    const ranges = [];
+    doc.descendants((node, pos) => {
+        if (!node.isText || !node.text)
+            return;
+        for (const match of node.text.matchAll(KEYWORD)) {
+            const from = pos + (match.index ?? 0);
+            ranges.push({ from, to: from + match[0].length });
+        }
+    });
+    return ranges;
+}
+/** True for a plain-text keyword check (the sent prompt, a test). Same rule as the editor mark. */
+export function hasUltracodeKeyword(text) {
+    KEYWORD.lastIndex = 0;
+    const found = KEYWORD.test(text);
+    KEYWORD.lastIndex = 0;
+    return found;
+}
+export const ultracodePluginKey = new PluginKey('ultracode');
+const isBlank = (doc) => doc.textContent.trim().length === 0;
+function stateFor(doc, dismissed) {
+    const ranges = dismissed ? [] : findUltracodeRanges(doc);
+    return {
+        dismissed,
+        ranges,
+        active: ranges.length > 0,
+        decorations: ranges.length
+            ? DecorationSet.create(doc, ranges.map(({ from, to }) => Decoration.inline(from, to, { class: ULTRACODE_MARK_CLASS, 'data-ultracode': '' })))
+            : DecorationSet.empty,
+    };
+}
+/** The next state after a transaction: a dismiss meta sets it, an empty document resets it. */
+export function nextUltracodeState(tr, previous, state) {
+    const meta = tr.getMeta(ultracodePluginKey);
+    let dismissed = meta?.dismiss ? true : previous.dismissed;
+    if (dismissed && isBlank(state.doc))
+        dismissed = false;
+    if (!tr.docChanged && dismissed === previous.dismissed)
+        return previous;
+    return stateFor(state.doc, dismissed);
+}
+/** Dismiss the keyword for this prompt. Returns false when nothing is marked. */
+export function dismissUltracode(state, dispatch) {
+    if (!ultracodePluginKey.getState(state)?.active)
+        return false;
+    dispatch?.(state.tr.setMeta(ultracodePluginKey, { dismiss: true }));
+    return true;
+}
+/** Alt+W anywhere, or Backspace with the caret right after a marked keyword. */
+export function isUltracodeDismissKey(event, state) {
+    const plugin = ultracodePluginKey.getState(state);
+    if (!plugin?.active)
+        return false;
+    // `code`, not `key`: Option+W on a Mac types `∑`.
+    if (event.altKey && !event.ctrlKey && !event.metaKey && event.code === 'KeyW')
+        return true;
+    if (event.key !== 'Backspace' || event.altKey || event.ctrlKey || event.metaKey || event.shiftKey)
+        return false;
+    const { empty, from } = state.selection;
+    return empty && plugin.ranges.some((range) => range.to === from);
+}
+export const UltracodeHighlight = Extension.create({
+    name: 'ultracodeHighlight',
+    addOptions() {
+        return { onActiveChange: undefined };
+    },
+    addProseMirrorPlugins() {
+        const options = this.options;
+        return [
+            new Plugin({
+                key: ultracodePluginKey,
+                state: {
+                    init: (_config, state) => stateFor(state.doc, false),
+                    apply: (tr, previous, _old, state) => nextUltracodeState(tr, previous, state),
+                },
+                props: {
+                    decorations: (state) => ultracodePluginKey.getState(state)?.decorations ?? DecorationSet.empty,
+                    handleKeyDown: (view, event) => {
+                        if (!isUltracodeDismissKey(event, view.state))
+                            return false;
+                        event.preventDefault();
+                        return dismissUltracode(view.state, view.dispatch);
+                    },
+                },
+                view: (view) => {
+                    let reported = ultracodePluginKey.getState(view.state)?.active ?? false;
+                    if (reported)
+                        options.onActiveChange?.(true);
+                    return {
+                        update: (next) => {
+                            const active = ultracodePluginKey.getState(next.state)?.active ?? false;
+                            if (active === reported)
+                                return;
+                            reported = active;
+                            options.onActiveChange?.(active);
+                        },
+                        destroy: () => {
+                            if (reported)
+                                options.onActiveChange?.(false);
+                        },
+                    };
+                },
+            }),
+        ];
+    },
+});