@jini-ai/chat 0.1.0

package/dist/react/features/chat-pane/react/hooks/useAgentRuntimePicker.hooks.js

@@ -0,0 +1,258 @@
+/**
+ * All of `AgentRuntimePicker`'s behavior, so the component itself is only markup.
+ *
+ * What lives here is popover mechanics — open/close, dismissal, viewport-bounded positioning,
+ * focus restoration, and roving/trapped keyboard focus — plus the two derived labels the view
+ * shows. None of it is chat-specific; the only reason it is scoped to this feature rather than
+ * promoted to `@jini-ai/ui` is noted at the bottom of this comment.
+ *
+ * The pure functions below are separated from the hook deliberately: geometry and key-to-index
+ * resolution have real input/output contracts and edge cases (viewport clamping, `currentIndex`
+ * of `-1`, Tab-at-an-edge) that are far cheaper to test directly than to drive through a rendered
+ * popover with a mocked `getBoundingClientRect`. The hook itself owns only React lifecycle.
+ *
+ * **Not yet using `@jini-ai/ui`'s `useDismissOnOutsideOrEscape`**, which covers the same
+ * outside-click/Escape ground and whose own doc notes six features had hand-rolled it before this
+ * one. Two concrete mismatches block a drop-in: it takes a single `containerRef`, whereas here
+ * "inside" means the trigger *or* the portaled popover (two disjoint subtrees, since the popover
+ * renders into `document.body`); and it exposes one `onDismiss` with no indication of which input
+ * dismissed, while this popover must restore focus on the next tick for a pointer and immediately
+ * for Escape (see the comment on that timeout). Consolidating means extending the shared hook to
+ * accept multiple containers and report the dismissal cause — worth doing, but as its own change
+ * to a package other features already depend on, not as a side effect of this extraction.
+ */
+import { useCallback, useEffect, useId, useMemo, useRef, useState, } from 'react';
+import { orderChatPaneAgents } from '../../rules.js';
+/** Everything in the popover a roving/trapping key handler is allowed to move focus between. */
+const FOCUSABLE_CONTROLS = 'button:not(:disabled), select:not(:disabled), input:not(:disabled)';
+/**
+ * Resolves the user-facing label for a selected model or reasoning option.
+ *
+ * @complexity Time: O(n) in the supplied option count; space: O(1).
+ * @overallScore 100/100
+ */
+export function runtimeOptionLabel(options, value, fallback) {
+    if (!value || value === 'default')
+        return fallback;
+    return options?.find((option) => option.id === value)?.label ?? value;
+}
+/**
+ * Computes a viewport-bounded fixed position for the body-portaled picker.
+ *
+ * @complexity Time/space: O(1).
+ * @overallScore 100/100
+ */
+export function runtimePopoverPosition(trigger, placement) {
+    const margin = 12;
+    const gap = 8;
+    const width = Math.min(320, window.innerWidth - margin * 2);
+    const left = Math.min(Math.max(trigger.left + trigger.width / 2 - width / 2, margin), window.innerWidth - width - margin);
+    if (placement === 'up') {
+        const availableHeight = Math.max(0, trigger.top - margin - gap);
+        return {
+            position: 'fixed',
+            left,
+            bottom: Math.max(margin, window.innerHeight - trigger.top + gap),
+            width,
+            maxHeight: Math.min(620, availableHeight),
+            overflowY: 'auto',
+            zIndex: 1000,
+        };
+    }
+    const top = trigger.bottom + gap;
+    const availableHeight = Math.max(0, window.innerHeight - top - margin);
+    return {
+        position: 'fixed',
+        top,
+        left,
+        width,
+        maxHeight: Math.min(620, availableHeight),
+        overflowY: 'auto',
+        zIndex: 1000,
+    };
+}
+/** `Tab` wraps focus around the popover's control list instead of leaving it (the popover is a
+ * modal-ish dialog). Returns the index to wrap TO, or `null` when `Tab` should behave natively
+ * (not at an edge). `currentIndex` may be `-1` (active element not in `controls`); `atStart`/
+ * `atEnd` below only matter when it legitimately is 0 or `count - 1`. */
+export function resolveTabWrapIndex(shiftKey, currentIndex, count) {
+    if (shiftKey && currentIndex === 0)
+        return count - 1;
+    if (!shiftKey && currentIndex === count - 1)
+        return 0;
+    return null;
+}
+/** Arrow/Home/End roving-tabindex target, or `null` for any other key. `currentIndex === -1`
+ * (nothing in `controls` focused yet) is a legitimate input — the modulo arithmetic below relies
+ * on it wrapping the same way a real index would. */
+export function resolveRovingIndex(key, currentIndex, count) {
+    if (key === 'Home')
+        return 0;
+    if (key === 'End')
+        return count - 1;
+    if (key === 'ArrowDown')
+        return (currentIndex + 1 + count) % count;
+    if (key === 'ArrowUp')
+        return (currentIndex - 1 + count) % count;
+    return null;
+}
+/**
+ * The control index the popover's key handler should move focus to, or `null` to leave focus alone
+ * (and, in the caller, to skip `preventDefault()`). `Tab` is resolved and returned immediately —
+ * it must never fall through to the roving-tabindex logic below it.
+ */
+export function resolvePopoverKeyAction(key, shiftKey, isButtonTarget, currentIndex, count) {
+    if (key === 'Tab')
+        return resolveTabWrapIndex(shiftKey, currentIndex, count);
+    // Native selects own their arrow/Home/End behavior. Roving applies only
+    // when a button (including the agent radios) has focus.
+    if (!isButtonTarget)
+        return null;
+    return resolveRovingIndex(key, currentIndex, count);
+}
+/** Builds the one-line "which runtime am I talking to" summary shown in the popover head. */
+export function runtimeSummaryText(selectedAgent, modelLabel, t) {
+    if (selectedAgent === undefined)
+        return t('No agent selected');
+    const version = selectedAgent.version ? ` · ${selectedAgent.version}` : '';
+    return `${selectedAgent.name}${version} · ${modelLabel}`;
+}
+/**
+ * The head/trigger labels while `executionMode` is `'api'`.
+ *
+ * Separate from {@link runtimeSummaryText} rather than folded into it because the two describe
+ * different things and fail differently: that one names a detected CLI and its model, this one
+ * names a provider and the model the credential is configured for, and neither has a sensible
+ * fallback to the other. A missing provider label here is not "no agent selected" — the API path is
+ * still what will run — so the fallback is a generic mode name, never a CLI's.
+ *
+ * @complexity Time/space: O(1).
+ */
+export function byokSummaryText(byokRuntime, t) {
+    const title = byokRuntime?.providerLabel?.trim() || t('API · BYOK');
+    const model = byokRuntime?.model?.trim();
+    const modelLabel = model || t('No model configured');
+    return { title, modelLabel, summary: `${title} · ${modelLabel}` };
+}
+/**
+ * Owns the runtime picker's popover state so the component stays presentational.
+ *
+ * @complexity Time: O(n) in the agent count for ordering/selection; space: O(n) for the ordered
+ * snapshot. The DOM queries are O(c) in the popover's own control count.
+ */
+export function useAgentRuntimePicker({ agents, value, placement, t, executionMode = 'local', byokRuntime, }) {
+    const dialogId = useId();
+    const [open, setOpen] = useState(false);
+    const [position, setPosition] = useState();
+    const triggerRef = useRef(null);
+    const popoverRef = useRef(null);
+    const orderedAgents = useMemo(() => orderChatPaneAgents(agents.filter((agent) => agent.available !== false)), [agents]);
+    const selectedAgent = orderedAgents.find((agent) => agent.id === value.agentId);
+    // `selectedAgent` stays resolved in BOTH modes on purpose — the CLI selection is still the stored
+    // one, and switching back to Local CLI must not have silently lost it. What changes in `'api'` is
+    // only what gets DESCRIBED, because none of the CLI's labels are true of an API turn.
+    const localModelLabel = runtimeOptionLabel(selectedAgent?.models, value.model, t('Default model'));
+    const byok = byokSummaryText(byokRuntime, t);
+    const isApi = executionMode === 'api';
+    const modelLabel = isApi ? byok.modelLabel : localModelLabel;
+    const runtimeSummary = isApi ? byok.summary : runtimeSummaryText(selectedAgent, localModelLabel, t);
+    const triggerTitle = isApi ? byok.title : (selectedAgent?.name ?? t('Choose agent'));
+    // Read during render rather than in an effect: the popover only mounts once `open` is true, which
+    // is itself a re-render, and `triggerRef` is populated at the first commit — so by the time this
+    // value is used it is always resolved. See `originTheme` on the result type for why it exists.
+    const originTheme = triggerRef.current?.closest('[data-theme]')?.getAttribute('data-theme') ?? null;
+    const focusTrigger = useCallback(() => {
+        triggerRef.current?.focus();
+    }, []);
+    const toggleOpen = useCallback(() => {
+        setOpen((current) => !current);
+    }, []);
+    useEffect(() => {
+        if (!open)
+            return;
+        const closeOnOutsidePointer = (event) => {
+            const target = event.target;
+            if (triggerRef.current?.contains(target)
+                || popoverRef.current?.contains(target)
+                // A control INSIDE the popover may itself portal its menu to `document.body` —
+                // `@jini-ai/ui`'s `CustomSelect` (and so `SearchableModelSelect`, which the BYOK model row
+                // uses) does exactly that. Such a menu is a descendant of neither ref, so without this the
+                // first mousedown on a model option would be read as an outside click and close the
+                // popover out from under the selection the operator was making.
+                || (target instanceof Element && target.closest('.jini-select-menu') !== null))
+                return;
+            setOpen(false);
+            // Let the pointer's click complete before restoring focus. Otherwise the
+            // browser focuses the clicked node after this mousedown handler runs.
+            window.setTimeout(focusTrigger, 0);
+        };
+        const closeOnEscape = (event) => {
+            if (event.key !== 'Escape')
+                return;
+            setOpen(false);
+            focusTrigger();
+        };
+        document.addEventListener('mousedown', closeOnOutsidePointer);
+        document.addEventListener('keydown', closeOnEscape);
+        return () => {
+            document.removeEventListener('mousedown', closeOnOutsidePointer);
+            document.removeEventListener('keydown', closeOnEscape);
+        };
+    }, [focusTrigger, open]);
+    useEffect(() => {
+        if (!open)
+            return;
+        const update = () => {
+            const rect = triggerRef.current?.getBoundingClientRect();
+            if (rect)
+                setPosition(runtimePopoverPosition(rect, placement));
+        };
+        update();
+        window.addEventListener('resize', update);
+        // Capture phase: a scroll inside any ancestor moves the trigger too, and scroll does not bubble.
+        window.addEventListener('scroll', update, true);
+        return () => {
+            window.removeEventListener('resize', update);
+            window.removeEventListener('scroll', update, true);
+        };
+    }, [open, placement]);
+    useEffect(() => {
+        if (!open || !position)
+            return;
+        const popover = popoverRef.current;
+        const selectedRadio = popover?.querySelector('[role="radio"][aria-checked="true"]');
+        const fallback = popover?.querySelector(FOCUSABLE_CONTROLS);
+        (selectedRadio ?? fallback)?.focus();
+    }, [open, position]);
+    const handlePopoverKeyDown = useCallback((event) => {
+        // No `?? []` fallback for a null ref: this handler is only ever reachable via the
+        // `onKeyDown` React wires to the exact element `popoverRef` is attached to, and
+        // React attaches refs during commit — before that element can dispatch any event — so
+        // `popoverRef.current` is guaranteed non-null by the time this runs.
+        const controls = [...popoverRef.current.querySelectorAll(FOCUSABLE_CONTROLS)];
+        if (controls.length === 0)
+            return;
+        const currentIndex = controls.indexOf(document.activeElement);
+        const nextIndex = resolvePopoverKeyAction(event.key, event.shiftKey, event.target instanceof HTMLButtonElement, currentIndex, controls.length);
+        if (nextIndex === null)
+            return;
+        event.preventDefault();
+        controls[nextIndex]?.focus();
+    }, []);
+    return {
+        dialogId,
+        open,
+        position,
+        triggerRef,
+        popoverRef,
+        orderedAgents,
+        selectedAgent,
+        modelLabel,
+        runtimeSummary,
+        triggerTitle,
+        originTheme,
+        toggleOpen,
+        handlePopoverKeyDown,
+    };
+}
+//# sourceMappingURL=useAgentRuntimePicker.hooks.js.map

package/dist/react/features/chat-pane/react/hooks/useAgentRuntimePicker.hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentRuntimePicker.hooks.js","sourceRoot":"","sources":["../../../../../../src/react/features/chat-pane/react/hooks/useAgentRuntimePicker.hooks.ts"],"names":[],"mappings":"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"}

package/dist/react/features/chat-pane/react/hooks/useChatPane.hooks.d.ts

@@ -0,0 +1,66 @@
+import { type ChatPaneSendBlocker } from '../../rules.js';
+import type { ChatPaneActivity, ChatPaneAgent, ChatPaneAttachmentUploadOptions, ChatPaneAgentSelection, ChatPaneRunContext, ChatPaneWorkingDirectoryAccess } from '../../types.js';
+import type { ChatAttachment, ChatMessage } from '@jini-ai/chat/core';
+import type { ChatTransport } from '@jini-ai/chat/core';
+import { type UseComposerResult } from '../../../../hooks/useComposer.js';
+import { type UseConversationResult } from '../../../../hooks/useConversation.js';
+import { type UseChatPaneWorkingDirectoryResult } from './useChatPaneWorkingDirectory.hooks.js';
+export interface UseChatPaneOptions {
+    transport: ChatTransport;
+    agents: readonly ChatPaneAgent[];
+    initialMessages?: ChatMessage[];
+    conversationId?: string | null;
+    initialSelection?: ChatPaneAgentSelection;
+    selection?: ChatPaneAgentSelection;
+    onSelectionChange?: (selection: ChatPaneAgentSelection) => void;
+    runContext?: ChatPaneRunContext;
+    initialDraft?: string;
+    uploadAttachments?: (files: File[], options?: ChatPaneAttachmentUploadOptions) => Promise<ChatAttachment[]>;
+    onActivityChange?: (activity: ChatPaneActivity) => void;
+    onMessagesChange?: (messages: ChatMessage[]) => void;
+    workingDirectory?: string | null;
+    initialWorkingDirectory?: string | null;
+    onChangeWorkingDirectory?: (workingDirectory: string | null) => void;
+    workingDirectoryAccess?: ChatPaneWorkingDirectoryAccess;
+}
+export interface UseChatPaneResult extends UseChatPaneWorkingDirectoryResult {
+    conversation: UseConversationResult;
+    composer: UseComposerResult;
+    selection: ChatPaneAgentSelection;
+    selectedAgent: ChatPaneAgent | undefined;
+    /**
+     * The runtime inventory this pane is choosing from.
+     *
+     * Exposed so a caller can tell whether a selection *would* be honored before making it.
+     * {@link setSelection} normalizes an unknown or unavailable agent to the first available one —
+     * right for a picker, which must not break when a runtime disappears, and wrong for a
+     * programmatic caller, which would otherwise be told its choice succeeded while a different
+     * runtime was selected.
+     */
+    agents: readonly ChatPaneAgent[];
+    activity: ChatPaneActivity;
+    canSend: boolean;
+    /**
+     * Why a send would be refused, or `null` when the pane is ready. `canSend` additionally requires
+     * a submittable composer; a caller supplying its own prompt should gate on this instead.
+     */
+    sendBlocker: ChatPaneSendBlocker | null;
+    isUploadingAttachments: boolean;
+    attachmentError: Error | null;
+    setSelection: (selection: ChatPaneAgentSelection) => void;
+    addAttachments: (files: File[]) => Promise<void>;
+    send: () => Promise<void>;
+    /**
+     * Sends `prompt` through the same guarded path as the composer's `send()` — same blocker checks,
+     * staged attachments, composer reset, attachment-batch rotation, and `onActivityChange('queued')`.
+     * Exists so non-composer callers (agent control) cannot drift into a weaker send.
+     *
+     * @throws If {@link UseChatPaneResult.sendBlocker} is non-null, or `prompt` is blank. `send()`
+     * pre-checks and never triggers this; agent-driven callers get a describable refusal instead of a
+     * silent no-op.
+     */
+    sendPrompt: (prompt: string) => Promise<void>;
+    reset: () => void;
+}
+export declare function useChatPane(options: UseChatPaneOptions): UseChatPaneResult;
+//# sourceMappingURL=useChatPane.hooks.d.ts.map

package/dist/react/features/chat-pane/react/hooks/useChatPane.hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChatPane.hooks.d.ts","sourceRoot":"","sources":["../../../../../../src/react/features/chat-pane/react/hooks/useChatPane.hooks.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACb,+BAA+B,EAC/B,sBAAsB,EACtB,kBAAkB,EAClB,8BAA8B,EAC/B,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAe,KAAK,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACvF,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAEL,KAAK,iCAAiC,EACvC,MAAM,wCAAwC,CAAC;AAEhD,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,aAAa,CAAC;IACzB,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IACjC,eAAe,CAAC,EAAE,WAAW,EAAE,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,SAAS,CAAC,EAAE,sBAAsB,CAAC;IACnC,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,sBAAsB,KAAK,IAAI,CAAC;IAChE,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,CAClB,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,CAAC,EAAE,+BAA+B,KACtC,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAC/B,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACxD,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;IACrD,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,wBAAwB,CAAC,EAAE,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACrE,sBAAsB,CAAC,EAAE,8BAA8B,CAAC;CACzD;AAED,MAAM,WAAW,iBAAkB,SAAQ,iCAAiC;IAC1E,YAAY,EAAE,qBAAqB,CAAC;IACpC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,SAAS,EAAE,sBAAsB,CAAC;IAClC,aAAa,EAAE,aAAa,GAAG,SAAS,CAAC;IACzC;;;;;;;;OAQG;IACH,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IACjC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,WAAW,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACxC,sBAAsB,EAAE,OAAO,CAAC;IAChC,eAAe,EAAE,KAAK,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,CAAC,SAAS,EAAE,sBAAsB,KAAK,IAAI,CAAC;IAC1D,cAAc,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B;;;;;;;;OAQG;IACH,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AA+CD,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CA6L1E"}

package/dist/react/features/chat-pane/react/hooks/useChatPane.hooks.js

@@ -0,0 +1,223 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { describeChatPaneSendBlocker, findChatPaneSendBlocker, resolveChatPaneSelection, } from '../../rules.js';
+import { definedProps } from '../../../../util/defined-props.js';
+import { useComposer } from '../../../../hooks/useComposer.js';
+import { useConversation, } from '../../../../hooks/useConversation.js';
+import { useChatPaneWorkingDirectory, } from './useChatPaneWorkingDirectory.hooks.js';
+function createAttachmentBatchId() {
+    return globalThis.crypto?.randomUUID?.()
+        ?? `chat-${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
+}
+/** Module scope so each branch costs 1 cognitive point instead of 2 (nested one level inside
+ * `useChatPane` where it used to live as a ternary chain). */
+function resolveChatPaneActivity(selectedAgent, conversation) {
+    if (selectedAgent === undefined)
+        return 'unavailable';
+    if (conversation.error)
+        return 'failed';
+    if (conversation.isStreaming)
+        return 'streaming';
+    return 'ready';
+}
+/**
+ * Runs one attachment upload and, unless superseded/unmounted/aborted by the time it resolves,
+ * hands the results (or error) to the caller's effects. Concurrent by design — unlike
+ * {@link useLatestOperation}'s latest-wins model, several batches may be in flight at once
+ * (`addAttachments`'s `activeUploadsRef` is a `Set`, not a single slot) — so this takes an explicit
+ * `stillWanted()` check per attempt rather than a shared generation token.
+ */
+async function uploadAttachmentBatch(files, effects) {
+    try {
+        const uploaded = await effects.upload(files, { signal: effects.signal, batchId: effects.batchId });
+        if (!effects.stillWanted())
+            return;
+        for (const attachment of uploaded)
+            effects.onAttachment(attachment);
+    }
+    catch (error) {
+        if (!effects.stillWanted())
+            return;
+        effects.onError(error instanceof Error ? error : new Error(String(error)));
+    }
+}
+export function useChatPane(options) {
+    const [activeUploadCount, setActiveUploadCount] = useState(0);
+    const [attachmentError, setAttachmentError] = useState(null);
+    const mountedRef = useRef(true);
+    const attachmentGenerationRef = useRef(0);
+    const attachmentBatchIdRef = useRef(createAttachmentBatchId());
+    const activeUploadsRef = useRef(new Set());
+    const [internalSelection, setInternalSelection] = useState(options.initialSelection ?? { agentId: '' });
+    const workingDirectoryState = useChatPaneWorkingDirectory(definedProps({
+        workingDirectory: options.workingDirectory,
+        initialWorkingDirectory: options.initialWorkingDirectory,
+        onChangeWorkingDirectory: options.onChangeWorkingDirectory,
+        workingDirectoryAccess: options.workingDirectoryAccess,
+    }));
+    const requestedSelection = options.selection ?? internalSelection;
+    const selection = useMemo(() => resolveChatPaneSelection(options.agents, requestedSelection), [options.agents, requestedSelection]);
+    const selectedAgent = options.agents.find((agent) => agent.id === selection.agentId);
+    const composer = useComposer(definedProps({
+        initialDraft: options.initialDraft,
+        initialAgent: selection,
+    }));
+    const conversation = useConversation(definedProps({
+        transport: options.transport,
+        initialMessages: options.initialMessages,
+        conversationId: options.conversationId,
+        // Keys off an empty string, not `undefined` — `selection.agentId` is always a string (never
+        // absent), so only the falsy "no agent selected" case should omit the key.
+        agentId: selection.agentId || undefined,
+    }));
+    const activity = resolveChatPaneActivity(selectedAgent, conversation);
+    useEffect(() => {
+        options.onActivityChange?.(activity);
+    }, [activity, options.onActivityChange]);
+    useEffect(() => {
+        options.onMessagesChange?.(conversation.messages);
+    }, [conversation.messages, options.onMessagesChange]);
+    useEffect(() => {
+        mountedRef.current = true;
+        return () => {
+            mountedRef.current = false;
+            attachmentGenerationRef.current += 1;
+            for (const controller of activeUploadsRef.current)
+                controller.abort();
+            activeUploadsRef.current.clear();
+        };
+    }, []);
+    useEffect(() => {
+        if (!selection.agentId)
+            return;
+        if (requestedSelection.agentId === selection.agentId
+            && requestedSelection.model === selection.model
+            && requestedSelection.reasoning === selection.reasoning)
+            return;
+        if (options.selection === undefined)
+            setInternalSelection(selection);
+        composer.setAgent(selection);
+        options.onSelectionChange?.(selection);
+    }, [
+        composer,
+        options.onSelectionChange,
+        options.selection,
+        requestedSelection.agentId,
+        requestedSelection.model,
+        requestedSelection.reasoning,
+        selection,
+    ]);
+    const setSelection = useCallback((next) => {
+        const validated = resolveChatPaneSelection(options.agents, next);
+        setInternalSelection(validated);
+        composer.setAgent(validated);
+        options.onSelectionChange?.(validated);
+    }, [composer, options.agents, options.onSelectionChange]);
+    const sendBlocker = findChatPaneSendBlocker({
+        selectedAgent,
+        isStreaming: conversation.isStreaming,
+        activeUploadCount,
+        workingDirectoryPending: workingDirectoryState.workingDirectoryPending,
+        workingDirectoryInvalid: workingDirectoryState.workingDirectoryInvalid,
+        workingDirectoryError: workingDirectoryState.workingDirectoryError,
+    });
+    const canSend = sendBlocker === null && composer.canSubmit;
+    const addAttachments = useCallback(async (files) => {
+        if (files.length === 0 || options.uploadAttachments === undefined)
+            return;
+        const generation = attachmentGenerationRef.current;
+        const controller = new AbortController();
+        activeUploadsRef.current.add(controller);
+        setActiveUploadCount(activeUploadsRef.current.size);
+        setAttachmentError(null);
+        try {
+            await uploadAttachmentBatch(files, {
+                upload: options.uploadAttachments,
+                signal: controller.signal,
+                batchId: attachmentBatchIdRef.current,
+                stillWanted: () => mountedRef.current
+                    && !controller.signal.aborted
+                    && generation === attachmentGenerationRef.current,
+                onAttachment: (attachment) => composer.addAttachment(attachment),
+                onError: setAttachmentError,
+            });
+        }
+        finally {
+            if (activeUploadsRef.current.delete(controller) && mountedRef.current) {
+                setActiveUploadCount(activeUploadsRef.current.size);
+            }
+        }
+    }, [composer, options.uploadAttachments]);
+    const sendPrompt = useCallback(async (prompt) => {
+        const trimmed = prompt.trim();
+        if (!trimmed)
+            throw new Error('cannot send: the prompt is empty');
+        if (sendBlocker !== null) {
+            throw new Error(`cannot send: ${describeChatPaneSendBlocker(sendBlocker)}`);
+        }
+        const attachments = composer.attachments;
+        const context = typeof options.runContext === 'function'
+            ? options.runContext({
+                prompt: trimmed,
+                selection,
+                workingDirectory: workingDirectoryState.workingDirectory,
+            })
+            : options.runContext;
+        composer.reset();
+        attachmentGenerationRef.current += 1;
+        attachmentBatchIdRef.current = createAttachmentBatchId();
+        options.onActivityChange?.('queued');
+        await conversation.sendMessage(trimmed, definedProps({
+            agentId: selection.agentId,
+            // Omitted when the array is EMPTY, not merely absent — an empty `attachments: []` would be a
+            // different (valid, present) value to the transport than "no attachments key at all".
+            attachments: attachments.length === 0 ? undefined : attachments,
+            context,
+        }));
+    }, [
+        composer,
+        conversation,
+        options.onActivityChange,
+        options.runContext,
+        selection,
+        sendBlocker,
+        workingDirectoryState.workingDirectory,
+    ]);
+    const send = useCallback(async () => {
+        const prompt = composer.draft.trim()
+            || (composer.attachments.length > 0 ? 'Review the attached file(s).' : '');
+        if (!prompt || !canSend)
+            return;
+        await sendPrompt(prompt);
+    }, [canSend, composer, sendPrompt]);
+    const reset = useCallback(() => {
+        attachmentGenerationRef.current += 1;
+        attachmentBatchIdRef.current = createAttachmentBatchId();
+        for (const controller of activeUploadsRef.current)
+            controller.abort();
+        activeUploadsRef.current.clear();
+        setActiveUploadCount(0);
+        conversation.cancel();
+        conversation.setMessages(options.initialMessages ?? []);
+        composer.reset();
+        setAttachmentError(null);
+    }, [composer, conversation, options.initialMessages]);
+    return {
+        conversation,
+        composer,
+        selection,
+        selectedAgent,
+        agents: options.agents,
+        activity,
+        canSend,
+        sendBlocker,
+        isUploadingAttachments: activeUploadCount > 0,
+        attachmentError,
+        ...workingDirectoryState,
+        setSelection,
+        addAttachments,
+        send,
+        sendPrompt,
+        reset,
+    };
+}
+//# sourceMappingURL=useChatPane.hooks.js.map

package/dist/react/features/chat-pane/react/hooks/useChatPane.hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChatPane.hooks.js","sourceRoot":"","sources":["../../../../../../src/react/features/chat-pane/react/hooks/useChatPane.hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE1E,OAAO,EACL,2BAA2B,EAC3B,uBAAuB,EACvB,wBAAwB,GAEzB,MAAM,gBAAgB,CAAC;AAWxB,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,WAAW,EAA0B,MAAM,kCAAkC,CAAC;AACvF,OAAO,EACL,eAAe,GAEhB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,2BAA2B,GAE5B,MAAM,wCAAwC,CAAC;AAgEhD,SAAS,uBAAuB;IAC9B,OAAO,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE;WACnC,QAAQ,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAChF,CAAC;AAED;8DAC8D;AAC9D,SAAS,uBAAuB,CAC9B,aAAwC,EACxC,YAAmC;IAEnC,IAAI,aAAa,KAAK,SAAS;QAAE,OAAO,aAAa,CAAC;IACtD,IAAI,YAAY,CAAC,KAAK;QAAE,OAAO,QAAQ,CAAC;IACxC,IAAI,YAAY,CAAC,WAAW;QAAE,OAAO,WAAW,CAAC;IACjD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,qBAAqB,CAClC,KAAa,EACb,OAOC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QACnG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE;YAAE,OAAO;QACnC,KAAK,MAAM,UAAU,IAAI,QAAQ;YAAE,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;IACtE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE;YAAE,OAAO;QACnC,OAAO,CAAC,OAAO,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,MAAM,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC9D,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAC3E,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,uBAAuB,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1C,MAAM,oBAAoB,GAAG,MAAM,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC/D,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,GAAG,EAAmB,CAAC,CAAC;IAC5D,MAAM,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,GAAG,QAAQ,CACxD,OAAO,CAAC,gBAAgB,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAC5C,CAAC;IACF,MAAM,qBAAqB,GAAG,2BAA2B,CAAC,YAAY,CAAC;QACrE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,uBAAuB,EAAE,OAAO,CAAC,uBAAuB;QACxD,wBAAwB,EAAE,OAAO,CAAC,wBAAwB;QAC1D,sBAAsB,EAAE,OAAO,CAAC,sBAAsB;KACvD,CAAC,CAAC,CAAC;IACJ,MAAM,kBAAkB,GAAG,OAAO,CAAC,SAAS,IAAI,iBAAiB,CAAC;IAClE,MAAM,SAAS,GAAG,OAAO,CACvB,GAAG,EAAE,CAAC,wBAAwB,CAAC,OAAO,CAAC,MAAM,EAAE,kBAAkB,CAAC,EAClE,CAAC,OAAO,CAAC,MAAM,EAAE,kBAAkB,CAAC,CACrC,CAAC;IACF,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,SAAS,CAAC,OAAO,CAAC,CAAC;IACrF,MAAM,QAAQ,GAAG,WAAW,CAAC,YAAY,CAAC;QACxC,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,YAAY,EAAE,SAAS;KACxB,CAAC,CAAC,CAAC;IACJ,MAAM,YAAY,GAAG,eAAe,CAAC,YAAY,CAAC;QAChD,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,4FAA4F;QAC5F,2EAA2E;QAC3E,OAAO,EAAE,SAAS,CAAC,OAAO,IAAI,SAAS;KACxC,CAAC,CAAC,CAAC;IAEJ,MAAM,QAAQ,GAAqB,uBAAuB,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IAExF,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,CAAC,gBAAgB,EAAE,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAEzC,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,CAAC,gBAAgB,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IACpD,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAEtD,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC;QAC1B,OAAO,GAAG,EAAE;YACV,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC;YAC3B,uBAAuB,CAAC,OAAO,IAAI,CAAC,CAAC;YACrC,KAAK,MAAM,UAAU,IAAI,gBAAgB,CAAC,OAAO;gBAAE,UAAU,CAAC,KAAK,EAAE,CAAC;YACtE,gBAAgB,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACnC,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,SAAS,CAAC,OAAO;YAAE,OAAO;QAC/B,IACE,kBAAkB,CAAC,OAAO,KAAK,SAAS,CAAC,OAAO;eAC7C,kBAAkB,CAAC,KAAK,KAAK,SAAS,CAAC,KAAK;eAC5C,kBAAkB,CAAC,SAAS,KAAK,SAAS,CAAC,SAAS;YACvD,OAAO;QACT,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;YAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;QACrE,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC7B,OAAO,CAAC,iBAAiB,EAAE,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC,EAAE;QACD,QAAQ;QACR,OAAO,CAAC,iBAAiB;QACzB,OAAO,CAAC,SAAS;QACjB,kBAAkB,CAAC,OAAO;QAC1B,kBAAkB,CAAC,KAAK;QACxB,kBAAkB,CAAC,SAAS;QAC5B,SAAS;KACV,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,WAAW,CAAC,CAAC,IAA4B,EAAE,EAAE;QAChE,MAAM,SAAS,GAAG,wBAAwB,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACjE,oBAAoB,CAAC,SAAS,CAAC,CAAC;QAChC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC7B,OAAO,CAAC,iBAAiB,EAAE,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAE1D,MAAM,WAAW,GAAG,uBAAuB,CAAC;QAC1C,aAAa;QACb,WAAW,EAAE,YAAY,CAAC,WAAW;QACrC,iBAAiB;QACjB,uBAAuB,EAAE,qBAAqB,CAAC,uBAAuB;QACtE,uBAAuB,EAAE,qBAAqB,CAAC,uBAAuB;QACtE,qBAAqB,EAAE,qBAAqB,CAAC,qBAAqB;KACnE,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,WAAW,KAAK,IAAI,IAAI,QAAQ,CAAC,SAAS,CAAC;IAE3D,MAAM,cAAc,GAAG,WAAW,CAAC,KAAK,EAAE,KAAa,EAAE,EAAE;QACzD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,iBAAiB,KAAK,SAAS;YAAE,OAAO;QAC1E,MAAM,UAAU,GAAG,uBAAuB,CAAC,OAAO,CAAC;QACnD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACzC,oBAAoB,CAAC,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACpD,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,qBAAqB,CAAC,KAAK,EAAE;gBACjC,MAAM,EAAE,OAAO,CAAC,iBAAiB;gBACjC,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,OAAO,EAAE,oBAAoB,CAAC,OAAO;gBACrC,WAAW,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO;uBAChC,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO;uBAC1B,UAAU,KAAK,uBAAuB,CAAC,OAAO;gBACnD,YAAY,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC;gBAChE,OAAO,EAAE,kBAAkB;aAC5B,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,IAAI,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;gBACtE,oBAAoB,CAAC,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;IACH,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAE1C,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,EAAE,MAAc,EAAE,EAAE;QACtD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAClE,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,gBAAgB,2BAA2B,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC9E,CAAC;QACD,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC;QACzC,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,UAAU,KAAK,UAAU;YACtD,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;gBACjB,MAAM,EAAE,OAAO;gBACf,SAAS;gBACT,gBAAgB,EAAE,qBAAqB,CAAC,gBAAgB;aACzD,CAAC;YACJ,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;QACvB,QAAQ,CAAC,KAAK,EAAE,CAAC;QACjB,uBAAuB,CAAC,OAAO,IAAI,CAAC,CAAC;QACrC,oBAAoB,CAAC,OAAO,GAAG,uBAAuB,EAAE,CAAC;QACzD,OAAO,CAAC,gBAAgB,EAAE,CAAC,QAAQ,CAAC,CAAC;QACrC,MAAM,YAAY,CAAC,WAAW,CAAC,OAAO,EAAE,YAAY,CAAC;YACnD,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,6FAA6F;YAC7F,sFAAsF;YACtF,WAAW,EAAE,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW;YAC/D,OAAO;SACR,CAAC,CAAC,CAAC;IACN,CAAC,EAAE;QACD,QAAQ;QACR,YAAY;QACZ,OAAO,CAAC,gBAAgB;QACxB,OAAO,CAAC,UAAU;QAClB,SAAS;QACT,WAAW;QACX,qBAAqB,CAAC,gBAAgB;KACvC,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE;eAC/B,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC7E,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO;YAAE,OAAO;QAChC,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;IAEpC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,uBAAuB,CAAC,OAAO,IAAI,CAAC,CAAC;QACrC,oBAAoB,CAAC,OAAO,GAAG,uBAAuB,EAAE,CAAC;QACzD,KAAK,MAAM,UAAU,IAAI,gBAAgB,CAAC,OAAO;YAAE,UAAU,CAAC,KAAK,EAAE,CAAC;QACtE,gBAAgB,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACjC,oBAAoB,CAAC,CAAC,CAAC,CAAC;QACxB,YAAY,CAAC,MAAM,EAAE,CAAC;QACtB,YAAY,CAAC,WAAW,CAAC,OAAO,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC;QACxD,QAAQ,CAAC,KAAK,EAAE,CAAC;QACjB,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC;IAEtD,OAAO;QACL,YAAY;QACZ,QAAQ;QACR,SAAS;QACT,aAAa;QACb,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,QAAQ;QACR,OAAO;QACP,WAAW;QACX,sBAAsB,EAAE,iBAAiB,GAAG,CAAC;QAC7C,eAAe;QACf,GAAG,qBAAqB;QACxB,YAAY;QACZ,cAAc;QACd,IAAI;QACJ,UAAU;QACV,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/react/features/chat-pane/react/hooks/useChatPaneAgentControl.hooks.d.ts

@@ -0,0 +1,38 @@
+import type { ChatPaneAgentBridgeAccess } from '../../types.js';
+import type { UseChatPaneResult } from './useChatPane.hooks.js';
+export interface UseChatPaneAgentControlOptions {
+    /** Defaults to `false` — agent control is opt-in. */
+    enabled?: boolean;
+    bridgeAccess?: ChatPaneAgentBridgeAccess;
+    /**
+     * Register these tools with the in-page WebMCP surface (`document.modelContext`). Defaults to
+     * `false`, and that default is a security position rather than caution.
+     *
+     * The daemon-relayed channel routes every call through `ToolExecutor` — policy, confirmation,
+     * timeout, audit. A WebMCP call cannot: it originates inside the page from a browser-native
+     * caller, with no run and no principal to authorize against, so there is nothing for the gate to
+     * decide on and no run to attribute the action to. Routing it through the daemon would mean
+     * inventing both, which is worse than not gating — an invented principal is a gate that says yes.
+     *
+     * So a host that turns this on is accepting that anything able to reach `document.modelContext`
+     * — a browser extension, another script on the page — can drive this pane ungated. That is a
+     * legitimate choice for a trusted first-party surface and a bad one for a page hosting untrusted
+     * content, which is exactly why it has to be the host's call and not a default.
+     */
+    webmcp?: boolean;
+}
+/**
+ * Wires the chat pane's own actions (send/draft/selection/cancel/reset/working-directory/state) up
+ * to the outside-caller surfaces the pane supports: a daemon-relayed action channel when
+ * `bridgeAccess` is supplied, so an HTTP- or MCP-driven caller can reach this SAME live pane
+ * instance, and — only when the host sets `webmcp` — in-page WebMCP tool registration
+ * (`document.modelContext.registerTool`, feature-detected). Both dispatch through one identical
+ * action map (`runChatPaneAction`, module scope above), so the two callers can never diverge in
+ * *behavior*.
+ *
+ * They do differ in *authorization*, and that difference is the reason WebMCP is off by default.
+ * The relayed channel arrives having already passed `ToolExecutor`; a WebMCP call has no run and
+ * no principal, so it cannot. See {@link UseChatPaneAgentControlOptions.webmcp}.
+ */
+export declare function useChatPaneAgentControl(pane: UseChatPaneResult, options?: UseChatPaneAgentControlOptions): void;
+//# sourceMappingURL=useChatPaneAgentControl.hooks.d.ts.map

package/dist/react/features/chat-pane/react/hooks/useChatPaneAgentControl.hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChatPaneAgentControl.hooks.d.ts","sourceRoot":"","sources":["../../../../../../src/react/features/chat-pane/react/hooks/useChatPaneAgentControl.hooks.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,yBAAyB,EAA2B,MAAM,gBAAgB,CAAC;AAEzF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,MAAM,WAAW,8BAA8B;IAC7C,qDAAqD;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,yBAAyB,CAAC;IACzC;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAoOD;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,iBAAiB,EACvB,OAAO,GAAE,8BAAmC,GAC3C,IAAI,CA+DN"}