@jini-ai/chat 0.1.0

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

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

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

@@ -0,0 +1,26 @@
+import { type DragEventHandler } from 'react';
+export interface UseChatPaneFileDropOptions {
+    enabled: boolean;
+    onFiles: (files: File[]) => void | Promise<void>;
+}
+export interface ChatPaneFileDropTargetProps {
+    onDragEnter: DragEventHandler<HTMLDivElement>;
+    onDragOver: DragEventHandler<HTMLDivElement>;
+    onDragLeave: DragEventHandler<HTMLDivElement>;
+    onDrop: DragEventHandler<HTMLDivElement>;
+}
+export interface UseChatPaneFileDropResult {
+    draggingFiles: boolean;
+    dropReadError: string | null;
+    targetProps: ChatPaneFileDropTargetProps;
+}
+/**
+ * Adapts the shared nesting-safe file drop target to the chat composer.
+ * Non-file drags are ignored, while temporarily disabled composers still
+ * consume a file drop so the browser cannot navigate away to the local file.
+ *
+ * @complexity Time: O(n) for the dropped file list; space: O(n).
+ * @overallScore 100/100
+ */
+export declare function useChatPaneFileDrop({ enabled, onFiles, }: UseChatPaneFileDropOptions): UseChatPaneFileDropResult;
+//# sourceMappingURL=useChatPaneFileDrop.hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useChatPaneFileDrop.hooks.d.ts","sourceRoot":"","sources":["../../../../../../src/react/features/chat-pane/react/hooks/useChatPaneFileDrop.hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,OAAO,CAAC;AAGf,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAC;IAC9C,UAAU,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAC;IAC7C,WAAW,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAC;IAC9C,MAAM,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,2BAA2B,CAAC;CAC1C;AAQD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,OAAO,EACP,OAAO,GACR,EAAE,0BAA0B,GAAG,yBAAyB,CA4CxD"}

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

@@ -0,0 +1,60 @@
+import { useCallback, } from 'react';
+import { useFileDropTarget } from '@jini-ai/ui';
+function carriesFiles(event) {
+    return Array.from(event.dataTransfer.types ?? []).includes('Files')
+        || Array.from(event.dataTransfer.items ?? []).some((item) => item.kind === 'file')
+        || (event.type === 'drop' && event.dataTransfer.files.length > 0);
+}
+/**
+ * Adapts the shared nesting-safe file drop target to the chat composer.
+ * Non-file drags are ignored, while temporarily disabled composers still
+ * consume a file drop so the browser cannot navigate away to the local file.
+ *
+ * @complexity Time: O(n) for the dropped file list; space: O(n).
+ * @overallScore 100/100
+ */
+export function useChatPaneFileDrop({ enabled, onFiles, }) {
+    const dropTarget = useFileDropTarget((files) => {
+        void onFiles(files);
+    });
+    const onDragEnter = useCallback((event) => {
+        if (!enabled || !carriesFiles(event))
+            return;
+        dropTarget.onDragEnter(event);
+    }, [dropTarget.onDragEnter, enabled]);
+    const onDragOver = useCallback((event) => {
+        if (!carriesFiles(event))
+            return;
+        event.preventDefault();
+        if (!enabled) {
+            event.dataTransfer.dropEffect = 'none';
+            return;
+        }
+        dropTarget.onDragOver(event);
+    }, [dropTarget.onDragOver, enabled]);
+    const onDragLeave = useCallback((event) => {
+        if (!enabled || !carriesFiles(event))
+            return;
+        dropTarget.onDragLeave(event);
+    }, [dropTarget.onDragLeave, enabled]);
+    const onDrop = useCallback((event) => {
+        if (!carriesFiles(event))
+            return;
+        if (!enabled) {
+            event.preventDefault();
+            return;
+        }
+        dropTarget.onDrop(event);
+    }, [dropTarget.onDrop, enabled]);
+    return {
+        draggingFiles: enabled && dropTarget.draggingFiles,
+        dropReadError: dropTarget.dropReadError,
+        targetProps: {
+            onDragEnter,
+            onDragOver,
+            onDragLeave,
+            onDrop,
+        },
+    };
+}
+//# sourceMappingURL=useChatPaneFileDrop.hooks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useChatPaneFileDrop.hooks.js","sourceRoot":"","sources":["../../../../../../src/react/features/chat-pane/react/hooks/useChatPaneFileDrop.hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,GAGZ,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAoBhD,SAAS,YAAY,CAAC,KAAyB;IAC7C,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;WAC9D,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;WAC/E,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACtE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAClC,OAAO,EACP,OAAO,GACoB;IAC3B,MAAM,UAAU,GAAG,iBAAiB,CAAC,CAAC,KAAK,EAAE,EAAE;QAC7C,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,WAAW,CAAmC,CAAC,KAAK,EAAE,EAAE;QAC1E,IAAI,CAAC,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;YAAE,OAAO;QAC7C,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IAEtC,MAAM,UAAU,GAAG,WAAW,CAAmC,CAAC,KAAK,EAAE,EAAE;QACzE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;YAAE,OAAO;QACjC,KAAK,CAAC,cAAc,EAAE,CAAC;QACvB,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,KAAK,CAAC,YAAY,CAAC,UAAU,GAAG,MAAM,CAAC;YACvC,OAAO;QACT,CAAC;QACD,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IAErC,MAAM,WAAW,GAAG,WAAW,CAAmC,CAAC,KAAK,EAAE,EAAE;QAC1E,IAAI,CAAC,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;YAAE,OAAO;QAC7C,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IAEtC,MAAM,MAAM,GAAG,WAAW,CAAmC,CAAC,KAAK,EAAE,EAAE;QACrE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;YAAE,OAAO;QACjC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,KAAK,CAAC,cAAc,EAAE,CAAC;YACvB,OAAO;QACT,CAAC;QACD,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAEjC,OAAO;QACL,aAAa,EAAE,OAAO,IAAI,UAAU,CAAC,aAAa;QAClD,aAAa,EAAE,UAAU,CAAC,aAAa;QACvC,WAAW,EAAE;YACX,WAAW;YACX,UAAU;YACV,WAAW;YACX,MAAM;SACP;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,25 @@
+import type { ChatPaneAgent, ChatPaneRuntimeAccess } from '../../types.js';
+export interface UseChatPaneRuntimeInventoryOptions {
+    access?: ChatPaneRuntimeAccess;
+    initialAgents?: readonly ChatPaneAgent[];
+    pollIntervalMs?: number;
+}
+export interface UseChatPaneRuntimeInventoryResult {
+    agents: readonly ChatPaneAgent[];
+    scanningAgents: boolean;
+    daemonOnline: boolean;
+    runtimeInventoryError: Error | null;
+    rescanAgents: () => Promise<void>;
+}
+/**
+ * Owns agent inventory, explicit rescans, and daemon-health polling while the
+ * host supplies only the environment-specific I/O effects.
+ *
+ * Inventory and health are tracked as two independent operations: a slow `listAgents` must not
+ * suppress a health tick that resolved after it, and vice versa.
+ *
+ * @complexity Time: O(n) per inventory response; space: O(n) for the snapshot.
+ * @overallScore 100/100
+ */
+export declare function useChatPaneRuntimeInventory({ access, initialAgents, pollIntervalMs, }: UseChatPaneRuntimeInventoryOptions): UseChatPaneRuntimeInventoryResult;
+//# sourceMappingURL=useChatPaneRuntimeInventory.hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useChatPaneRuntimeInventory.hooks.d.ts","sourceRoot":"","sources":["../../../../../../src/react/features/chat-pane/react/hooks/useChatPaneRuntimeInventory.hooks.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAI3E,MAAM,WAAW,kCAAkC;IACjD,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,aAAa,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iCAAiC;IAChD,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IACjC,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,qBAAqB,EAAE,KAAK,GAAG,IAAI,CAAC;IACpC,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,EAC1C,MAAM,EACN,aAA4B,EAC5B,cAAsB,GACvB,EAAE,kCAAkC,GAAG,iCAAiC,CAsExE"}

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

@@ -0,0 +1,83 @@
+import { useCallback, useEffect, useState } from 'react';
+import { useLatestOperation } from '../../../../hooks/useLatestOperation.js';
+const EMPTY_AGENTS = [];
+/**
+ * Owns agent inventory, explicit rescans, and daemon-health polling while the
+ * host supplies only the environment-specific I/O effects.
+ *
+ * Inventory and health are tracked as two independent operations: a slow `listAgents` must not
+ * suppress a health tick that resolved after it, and vice versa.
+ *
+ * @complexity Time: O(n) per inventory response; space: O(n) for the snapshot.
+ * @overallScore 100/100
+ */
+export function useChatPaneRuntimeInventory({ access, initialAgents = EMPTY_AGENTS, pollIntervalMs = 5_000, }) {
+    const [agents, setAgents] = useState(initialAgents);
+    const [scanningAgents, setScanningAgents] = useState(false);
+    const [daemonOnline, setDaemonOnline] = useState(false);
+    const [runtimeInventoryError, setRuntimeInventoryError] = useState(null);
+    const inventory = useLatestOperation();
+    const health = useLatestOperation();
+    useEffect(() => {
+        if (access !== undefined)
+            return;
+        inventory.supersede();
+        setAgents(initialAgents);
+        setScanningAgents(false);
+        setRuntimeInventoryError(null);
+    }, [access, initialAgents, inventory]);
+    const loadAgents = useCallback(async (rescan) => {
+        if (!access)
+            return;
+        setScanningAgents(true);
+        setRuntimeInventoryError(null);
+        await inventory.run(async (token) => {
+            const nextAgents = await (rescan ? access.rescanAgents() : access.listAgents());
+            token.ensureCurrent();
+            setAgents([...nextAgents]);
+            setScanningAgents(false);
+        }, (error) => {
+            // A failed rescan keeps the last good inventory on screen; a failed initial load has no
+            // last-good to keep, so it clears to empty rather than showing agents that may be gone.
+            if (!rescan)
+                setAgents([]);
+            setRuntimeInventoryError(error);
+            setScanningAgents(false);
+        });
+    }, [access, inventory]);
+    const refreshStatus = useCallback(async () => {
+        // No `if (!access) return` guard here (unlike `loadAgents`, which is reachable through
+        // the publicly-exposed `rescanAgents` and so can be invoked with a stale closure by the
+        // host): `refreshStatus` is never returned from this hook, so its only two call sites
+        // (the effect below, both the immediate call and the interval tick) are inside the SAME
+        // closure as the effect's own `if (!access) return` at its top — `access` is guaranteed
+        // defined by the time either one runs.
+        const runtimeAccess = access;
+        await health.run(async (token) => {
+            const online = await runtimeAccess.daemonOnline();
+            token.ensureCurrent();
+            setDaemonOnline(online);
+        }, () => setDaemonOnline(false));
+    }, [access, health]);
+    useEffect(() => {
+        if (!access)
+            return;
+        void loadAgents(false);
+        void refreshStatus();
+        const timer = window.setInterval(() => void refreshStatus(), pollIntervalMs);
+        return () => {
+            window.clearInterval(timer);
+            inventory.supersede();
+            health.supersede();
+        };
+    }, [access, health, inventory, loadAgents, pollIntervalMs, refreshStatus]);
+    const rescanAgents = useCallback(() => loadAgents(true), [loadAgents]);
+    return {
+        agents,
+        scanningAgents,
+        daemonOnline,
+        runtimeInventoryError,
+        rescanAgents,
+    };
+}
+//# sourceMappingURL=useChatPaneRuntimeInventory.hooks.js.map

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

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

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

@@ -0,0 +1,38 @@
+import type { ChatPaneWorkingDirectoryAccess } from '../../types.js';
+export interface UseChatPaneWorkingDirectoryOptions {
+    workingDirectory?: string | null;
+    initialWorkingDirectory?: string | null;
+    onChangeWorkingDirectory?: (workingDirectory: string | null) => void;
+    workingDirectoryAccess?: ChatPaneWorkingDirectoryAccess;
+}
+export interface UseChatPaneWorkingDirectoryResult {
+    workingDirectory: string | null;
+    recentDirectories: readonly string[];
+    workingDirectoryInvalid: boolean;
+    workingDirectoryPending: boolean;
+    workingDirectoryError: Error | null;
+    openWorkingDirectoryPicker: () => Promise<void>;
+    pickWorkingDirectory: () => Promise<void>;
+    selectRecentDirectory: (directory: string) => Promise<void>;
+    clearWorkingDirectory: () => void;
+}
+/**
+ * Owns controlled/uncontrolled directory state and orchestrates the native
+ * filesystem effects used by the packaged working-directory picker.
+ *
+ * Every async path runs through one {@link useLatestOperation} instance, so a validation still in
+ * flight cannot clobber the result of the pick that replaced it, and a resolved promise arriving
+ * after unmount writes nothing. `token.ensureCurrent()` is that check — it stands where a
+ * `if (!mounted || stale) return;` guard used to sit after each await.
+ *
+ * @param options - Public value, change callback, and optional host I/O access.
+ * @returns Current picker state plus actions consumed by {@link ChatPane}.
+ * @throws Never. Native capability failures are exposed as
+ * `workingDirectoryError` for package-owned validation UI.
+ *
+ * @complexity Time: O(r) when refreshing `r` recent paths; O(1) otherwise.
+ * @complexity Space: O(r) for the package-owned recent-directory snapshot.
+ * @overallScore 100/100
+ */
+export declare function useChatPaneWorkingDirectory(options: UseChatPaneWorkingDirectoryOptions): UseChatPaneWorkingDirectoryResult;
+//# sourceMappingURL=useChatPaneWorkingDirectory.hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useChatPaneWorkingDirectory.hooks.d.ts","sourceRoot":"","sources":["../../../../../../src/react/features/chat-pane/react/hooks/useChatPaneWorkingDirectory.hooks.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAC;AAErE,MAAM,WAAW,kCAAkC;IACjD,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,iCAAiC;IAChD,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,uBAAuB,EAAE,OAAO,CAAC;IACjC,uBAAuB,EAAE,OAAO,CAAC;IACjC,qBAAqB,EAAE,KAAK,GAAG,IAAI,CAAC;IACpC,0BAA0B,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,oBAAoB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,qBAAqB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,qBAAqB,EAAE,MAAM,IAAI,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,kCAAkC,GAC1C,iCAAiC,CA4KnC"}