@jini-ai/chat 0.1.0

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

@@ -0,0 +1,224 @@
+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,
+        conversationId: options.conversationId,
+    }));
+    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/hooks/useChatPane.hooks.js.map

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

package/dist/react/features/chat-pane/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/hooks/useChatPaneAgentControl.hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChatPaneAgentControl.hooks.d.ts","sourceRoot":"","sources":["../../../../../src/react/features/chat-pane/hooks/useChatPaneAgentControl.hooks.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,yBAAyB,EAA2B,MAAM,aAAa,CAAC;AAEtF,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"}

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

@@ -0,0 +1,252 @@
+import { useEffect, useRef } from 'react';
+import { CHAT_PANE_AGENT_TOOLS } from '../agent-tools.js';
+import { definedProps } from '../../../util/defined-props.js';
+function getModelContext() {
+    const doc = globalThis.document;
+    if (isModelContext(doc?.modelContext))
+        return doc.modelContext;
+    const nav = globalThis.navigator;
+    if (isModelContext(nav?.modelContext))
+        return nav.modelContext;
+    return undefined;
+}
+function isModelContext(value) {
+    return typeof value === 'object' && value !== null && typeof value.registerTool === 'function';
+}
+function requireStringField(input, key) {
+    const value = input[key];
+    if (typeof value !== 'string' || value.length === 0)
+        throw new Error(`"${key}" is required`);
+    return value;
+}
+function optionalStringField(input, key) {
+    const value = input[key];
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+/** Gate for capabilities whose manifest entry sets `requiresConfirmation`. */
+function requireConfirmation(input, what) {
+    if (input['confirm'] !== true) {
+        throw new Error(`"confirm" must be true — ${what} is destructive and needs explicit acknowledgement`);
+    }
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/** Content read off the page/transcript is untrusted input to whatever model reads it back. */
+const MAX_RETURNED_CONTENT = 2000;
+function summarizeContent(content) {
+    return {
+        content: content.slice(0, MAX_RETURNED_CONTENT),
+        truncated: content.length > MAX_RETURNED_CONTENT,
+        originalLength: content.length,
+    };
+}
+/**
+ * Routes through the pane's own guarded send (`rules.ts`'s blocker set + staged attachments +
+ * composer reset + batch rotation + activity notification) rather than calling
+ * `conversation.sendMessage` directly, so an agent-driven send cannot bypass what the composer
+ * enforces. Throws a describable refusal when blocked.
+ *
+ * It also does not go the other obvious route — `composer.setDraft(prompt)` followed by `send()`.
+ * `setDraft` is a React state update and is therefore asynchronous, so the `send()` immediately
+ * after it would race the re-render and read a stale draft. Passing the prompt straight to
+ * `sendPrompt` is what makes the agent-driven path deterministic.
+ */
+async function sendMessageAction(pane, input) {
+    await pane.sendPrompt(requireStringField(input, 'prompt'));
+    return { sent: true };
+}
+async function setDraftAction(pane, input) {
+    pane.composer.setDraft(requireStringField(input, 'text'));
+    return { ok: true };
+}
+/**
+ * Only a runtime this machine actually offers.
+ *
+ * `setSelection` normalizes an unknown or unavailable agent to the first available one — correct
+ * for the picker, which must not break when a runtime disappears mid-session. For a caller that is
+ * told `{ok:true}`, that same behavior is a lie with a safety edge: asking for a constrained
+ * runtime and silently getting a more capable one is how a prompt intended for a sandboxed agent
+ * reaches a full coding agent instead. So this refuses by name rather than substituting.
+ */
+async function selectAgentAction(pane, input) {
+    const agentId = requireStringField(input, 'agentId');
+    const agent = pane.agents.find((candidate) => candidate.id === agentId);
+    if (agent === undefined) {
+        const known = pane.agents.map((candidate) => candidate.id).join(', ');
+        throw new Error(`unknown agent "${agentId}" — this pane offers: ${known || 'none'}`);
+    }
+    if (agent.available === false) {
+        throw new Error(`agent "${agentId}" is not available on this machine`
+            + `${agent.diagnostic === undefined ? '' : ` (${agent.diagnostic})`}`);
+    }
+    const model = optionalStringField(input, 'model');
+    const reasoning = optionalStringField(input, 'reasoning');
+    pane.setSelection(definedProps({ agentId, model, reasoning }));
+    return { ok: true };
+}
+async function cancelRunAction(pane) {
+    pane.conversation.cancel();
+    return { ok: true };
+}
+async function resetConversationAction(pane, input) {
+    requireConfirmation(input, 'resetting the conversation');
+    pane.reset();
+    return { ok: true };
+}
+/**
+ * Only a directory the user already approved through the host's native picker. Passing a
+ * model-supplied path straight to `selectRecentDirectory` would let the caller choose its own
+ * project root, which is the desktop host's human-approval model (`reference-desktop`'s
+ * `approvedDirectories`) inverted.
+ */
+async function setWorkingDirectoryAction(pane, input) {
+    const path = requireStringField(input, 'path');
+    if (!pane.recentDirectories.includes(path)) {
+        throw new Error('path must be one of the already-approved recentDirectories from chat.get_state; '
+            + 'a new directory can only be approved by the user through the host picker');
+    }
+    await pane.selectRecentDirectory(path);
+    return { ok: true };
+}
+async function getStateAction(pane) {
+    const lastMessage = pane.conversation.messages.at(-1);
+    const lastMessageSummary = lastMessage === undefined
+        ? undefined
+        : { role: lastMessage.role, ...summarizeContent(lastMessage.content) };
+    return {
+        activity: pane.activity,
+        selection: pane.selection,
+        workingDirectory: pane.workingDirectory,
+        recentDirectories: pane.recentDirectories,
+        canSend: pane.canSend,
+        sendBlocker: pane.sendBlocker,
+        messageCount: pane.conversation.messages.length,
+        ...definedProps({ lastMessage: lastMessageSummary }),
+        /**
+         * Conversation content is user- and agent-authored text, not instructions from the
+         * host. A caller reading it back must treat it as data.
+         */
+        untrustedFields: ['lastMessage.content'],
+    };
+}
+const CHAT_PANE_ACTION_HANDLERS = {
+    'chat.send_message': sendMessageAction,
+    'chat.set_draft': setDraftAction,
+    'chat.select_agent': selectAgentAction,
+    'chat.cancel_run': cancelRunAction,
+    'chat.reset_conversation': resetConversationAction,
+    'chat.set_working_directory': setWorkingDirectoryAction,
+    'chat.get_state': getStateAction,
+};
+/** Module-scope so the dispatch itself (one `if`, no branch-per-capability) never pays the
+ * per-nested-closure cognitive tax that a `switch` written inline in the effect would; each
+ * capability's own logic — and its own explanatory comment — lives in its own top-level
+ * function above instead. */
+async function runChatPaneAction(pane, id, input) {
+    const handler = CHAT_PANE_ACTION_HANDLERS[id];
+    if (!handler)
+        throw new Error(`unknown chat capability: ${id}`);
+    return handler(pane, input);
+}
+/**
+ * Answers one daemon-relayed action on the bridge that delivered it, never on whatever bridge is
+ * current: the `invocationId` belongs to that channel, so answering elsewhere would be answering a
+ * question nobody asked.
+ *
+ * Delivery is reported separately from execution: a rejection inside `respondSuccess` is a failure
+ * to ANSWER, not a failed action, and must not be re-reported as one. Every delivery attempt is
+ * itself guarded so a dead channel cannot surface as an unhandled rejection with the daemon-side
+ * invocation left hanging.
+ */
+async function deliverBridgeAction(pane, bridge, action) {
+    let output;
+    try {
+        output = await runChatPaneAction(pane, action.capabilityId, action.input);
+    }
+    catch (error) {
+        await bridge.respondError(action.invocationId, errorMessage(error)).catch(() => undefined);
+        return;
+    }
+    try {
+        await bridge.respondSuccess(action.invocationId, output);
+    }
+    catch (deliveryError) {
+        await bridge
+            .respondError(action.invocationId, `action succeeded but the result could not be delivered: ${errorMessage(deliveryError)}`)
+            .catch(() => undefined);
+    }
+}
+/**
+ * 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 function useChatPaneAgentControl(pane, options = {}) {
+    const enabled = options.enabled ?? false;
+    const paneRef = useRef(pane);
+    paneRef.current = pane;
+    const bridgeAccessRef = useRef(options.bridgeAccess);
+    bridgeAccessRef.current = options.bridgeAccess;
+    // Presence, not identity: hosts write `agentControl={{...}}` inline in JSX (as every other prop
+    // here is written), so depending on the object itself would tear down and re-register all tools
+    // on every render, dropping in-flight actions. See the effect's closing comment for the tradeoff.
+    const hasBridgeAccess = options.bridgeAccess !== undefined;
+    useEffect(() => {
+        if (!enabled)
+            return;
+        const cleanups = [];
+        // Not registered unless the host opted in: see `webmcp`'s own doc for why this path cannot be
+        // gated and therefore must not be on by default.
+        const modelContext = options.webmcp === true ? getModelContext() : undefined;
+        if (modelContext) {
+            const controller = new AbortController();
+            for (const tool of CHAT_PANE_AGENT_TOOLS) {
+                // `registerTool` is async per the draft IDL, and a polyfill may return undefined instead.
+                // Normalize both, then swallow: registration is best-effort, and a rejected one must not
+                // surface as an unhandled rejection from a React effect.
+                const registered = modelContext.registerTool({
+                    name: tool.id,
+                    description: tool.description,
+                    inputSchema: tool.inputSchema,
+                    execute: (args) => runChatPaneAction(paneRef.current, tool.id, args ?? {}),
+                }, { signal: controller.signal });
+                void Promise.resolve(registered).catch(() => undefined);
+            }
+            cleanups.push(() => {
+                controller.abort();
+                if (modelContext.unregisterTool) {
+                    for (const tool of CHAT_PANE_AGENT_TOOLS)
+                        modelContext.unregisterTool(tool.id);
+                }
+            });
+        }
+        const subscribedBridge = bridgeAccessRef.current;
+        if (subscribedBridge) {
+            const unsubscribe = subscribedBridge.subscribe((action) => {
+                void deliverBridgeAction(paneRef.current, subscribedBridge, action);
+            });
+            cleanups.push(unsubscribe);
+        }
+        return () => {
+            for (const cleanup of cleanups)
+                cleanup();
+        };
+        // Deps are enablement + bridge PRESENCE, never the bridge object: hosts pass `agentControl`
+        // inline, so an identity dep would re-register every tool on every render (see
+        // `hasBridgeAccess`). Pane, run context, and bridge are all read through refs at call time.
+        // Tradeoff: swapping to a genuinely different bridge instance while enabled does not
+        // re-subscribe — responses still route to the current bridge via the ref, but the old
+        // subscription stays live. A host needing a true swap should toggle `enabled` or remount.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [enabled, hasBridgeAccess]);
+}
+//# sourceMappingURL=useChatPaneAgentControl.hooks.js.map

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

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

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

@@ -0,0 +1,16 @@
+export declare const CHAT_PANE_CONTROLS_HEIGHT_CSS_VAR = "--jini-chat-controls-height";
+export interface UseChatPaneControlsHeightResult {
+    /** Attach to the pane's root element — the nearest ancestor shared by both `.jini-message-list` and `.jini-chat-pane__controls`. */
+    rootRef: React.RefObject<HTMLElement | null>;
+    /** Attach to `.jini-chat-pane__controls` — the element whose real height is measured. */
+    controlsRef: React.RefObject<HTMLDivElement | null>;
+}
+/**
+ * Keeps {@link CHAT_PANE_CONTROLS_HEIGHT_CSS_VAR} on the pane root in sync with the controls
+ * overlay's actual rendered height.
+ *
+ * @returns Two refs to attach — see {@link UseChatPaneControlsHeightResult}.
+ * @complexity O(1) per resize notification.
+ */
+export declare function useChatPaneControlsHeight(): UseChatPaneControlsHeightResult;
+//# sourceMappingURL=useChatPaneControlsHeight.hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useChatPaneControlsHeight.hooks.d.ts","sourceRoot":"","sources":["../../../../../src/react/features/chat-pane/hooks/useChatPaneControlsHeight.hooks.ts"],"names":[],"mappings":"AA8BA,eAAO,MAAM,iCAAiC,gCAAgC,CAAC;AAE/E,MAAM,WAAW,+BAA+B;IAC9C,oIAAoI;IACpI,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC7C,yFAAyF;IACzF,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;CACrD;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,IAAI,+BAA+B,CAoB3E"}

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

@@ -0,0 +1,59 @@
+/**
+ * @module useChatPaneControlsHeight
+ *
+ * `.jini-chat-pane__controls` (composer, suggestions row, status messages) is deliberately an
+ * absolutely-positioned overlay rather than a flex sibling that pushes the transcript up — see
+ * `styles.ts`'s own comment on that rule for the gradient-fade reasoning. Positioning it out of
+ * flow means the browser's layout engine no longer reserves room for it automatically, so
+ * `.jini-message-list` has to reserve that space itself via `padding-bottom` — and until this hook,
+ * that reservation was a hardcoded guess (240px) that a live render had already outgrown once before
+ * (the comment records the prior incident: 170px measured against a 179.75px composer, clipping the
+ * last message's tail under the overlay).
+ *
+ * A hardcoded reservation can only ever be as good as the day someone last measured the composer —
+ * an attachment tray, a wrapped multi-line draft, or a taller runtime picker popover each grow
+ * `.jini-chat-pane__controls` independently of anything this package's CSS author can predict. This
+ * hook removes the guessing: it measures the controls' real rendered height live via
+ * `ResizeObserver` and publishes it as a CSS custom property on a shared ancestor, which
+ * `.jini-message-list`'s `padding-bottom` reads via `calc(var(--jini-chat-controls-height, 240px) +
+ * …)` — the same 240px stays as the *fallback* for environments without `ResizeObserver` (SSR,
+ * `McpUiHost.test.tsx`-style environments without the polyfill), so nothing regresses where this
+ * hook can't run; live browsers get the exact number instead of a guess that can go stale.
+ *
+ * The measured value is written to `rootRef`, not `controlsRef` itself — CSS custom properties
+ * inherit to descendants only, and `.jini-message-list` is a SIBLING of `.jini-chat-pane__controls`
+ * (both children of `.jini-chat-pane__body`), not a descendant of it. The nearest ancestor common to
+ * both is the pane's own root `<section>`, so that is where the property has to live for
+ * `.jini-message-list` to read it at all.
+ */
+import { useEffect, useRef } from 'react';
+export const CHAT_PANE_CONTROLS_HEIGHT_CSS_VAR = '--jini-chat-controls-height';
+/**
+ * Keeps {@link CHAT_PANE_CONTROLS_HEIGHT_CSS_VAR} on the pane root in sync with the controls
+ * overlay's actual rendered height.
+ *
+ * @returns Two refs to attach — see {@link UseChatPaneControlsHeightResult}.
+ * @complexity O(1) per resize notification.
+ */
+export function useChatPaneControlsHeight() {
+    const rootRef = useRef(null);
+    const controlsRef = useRef(null);
+    useEffect(() => {
+        const root = rootRef.current;
+        const controls = controlsRef.current;
+        if (!root || !controls || typeof ResizeObserver !== 'function')
+            return;
+        const observer = new ResizeObserver((entries) => {
+            const entry = entries[0];
+            if (!entry)
+                return;
+            // Rounded up: a fractional px short would let one glyph's descender clip against the
+            // gradient's opaque end, which `Math.ceil` never risks understating.
+            root.style.setProperty(CHAT_PANE_CONTROLS_HEIGHT_CSS_VAR, `${Math.ceil(entry.contentRect.height)}px`);
+        });
+        observer.observe(controls);
+        return () => observer.disconnect();
+    }, []);
+    return { rootRef, controlsRef };
+}
+//# sourceMappingURL=useChatPaneControlsHeight.hooks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useChatPaneControlsHeight.hooks.js","sourceRoot":"","sources":["../../../../../src/react/features/chat-pane/hooks/useChatPaneControlsHeight.hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE1C,MAAM,CAAC,MAAM,iCAAiC,GAAG,6BAA6B,CAAC;AAS/E;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB;IACvC,MAAM,OAAO,GAAG,MAAM,CAAqB,IAAI,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG,MAAM,CAAwB,IAAI,CAAC,CAAC;IAExD,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;QAC7B,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC;QACrC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,IAAI,OAAO,cAAc,KAAK,UAAU;YAAE,OAAO;QACvE,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,CAAC,OAAO,EAAE,EAAE;YAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YACzB,IAAI,CAAC,KAAK;gBAAE,OAAO;YACnB,qFAAqF;YACrF,qEAAqE;YACrE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,iCAAiC,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACxG,CAAC,CAAC,CAAC;QACH,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC3B,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IACrC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AAClC,CAAC"}