@agent-native/toolkit 0.0.0-beta-20260819143124

package/dist/composer/runtime-adapters.d.ts

@@ -0,0 +1,169 @@
+import { type ComponentType, type ReactNode } from "react";
+export type ComposerTranslate = (key: string, options?: Record<string, unknown>) => string;
+export type ReasoningEffort = "auto" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
+export interface EngineModelGroup {
+    engine: string;
+    label: string;
+    models: string[];
+    configured: boolean;
+    /** Provider-owned connection state shown at the far edge of the row. */
+    statusLabel?: string;
+    /** Marks a configured local subscription so setup CTAs can stay hidden. */
+    isSubscription?: boolean;
+}
+export interface ComposerModelState {
+    selectedModel: string;
+    selectedEngine: string;
+    selectedEffort: ReasoningEffort;
+    availableModels: EngineModelGroup[];
+    isLoading: boolean;
+    onModelChange: (model: string, engine: string) => void;
+    onEffortChange: (effort: ReasoningEffort) => void;
+}
+export interface ComposerBuilderConnectFlow {
+    hasFetchedStatus: boolean;
+    configured: boolean;
+    envManaged: boolean;
+    connecting: boolean;
+    statusResolved: boolean;
+    error: string | null;
+    start: () => void;
+}
+export interface AgentChatContextItem {
+    key: string;
+    title: string;
+    context: string;
+}
+export interface ComposerAgentChatMessage {
+    message: string;
+    context?: string;
+    mode?: "plan" | "act";
+    submit?: boolean;
+}
+export interface ComposerAgentChatContextSetOptions extends AgentChatContextItem {
+    openSidebar?: boolean;
+    focus?: boolean;
+}
+export interface ComposerAgentChatOpenThreadRequest {
+    threadId: string;
+    onlyIfActiveThreadId?: string;
+}
+export interface ComposerBuilderConnectFlowOptions {
+    enabled?: boolean;
+    popupUrl?: string;
+    trackingSource?: string;
+    trackingFlow?: string;
+    onConnected?: (state: {
+        orgName: string | null;
+    }) => void | Promise<void>;
+}
+export interface AgentComposerReference {
+    label: string;
+    icon?: string;
+    source?: string;
+    refType: string;
+    refId?: string | null;
+    refPath?: string | null;
+    slotKey?: string;
+    slotLabel?: string;
+    metadata?: Record<string, unknown>;
+    clearsSlots?: string[];
+    relatedReferences?: AgentComposerReference[];
+}
+export interface AgentComposerReferenceInsertPayload extends AgentComposerReference {
+    insertMessageId: string;
+}
+export interface VoiceContextPack {
+    surface?: string;
+    mode?: string;
+    snippets?: Array<{
+        label: string;
+        value: string;
+    }>;
+    terms?: Array<{
+        term: string;
+        replacement?: string;
+    }>;
+}
+export interface ComposerRuntimeAdapters {
+    resolvePath?: (path: string) => string;
+    translate?: ComposerTranslate;
+    formatNumber?: (value: number, options?: Intl.NumberFormatOptions) => string;
+    models?: {
+        useChatModels?: (options: {
+            enabled: boolean;
+        }) => ComposerModelState;
+        useAgentEngineConfigured?: (enabled: boolean) => {
+            missing: boolean;
+            state: string;
+        };
+        fetchAgentEngineConfiguredState?: (enabled: boolean, options: {
+            timeoutMs: number;
+        }) => Promise<"missing" | "configured" | string>;
+        BuilderSetupCard?: ComponentType<any>;
+        BuilderSetupContent?: ComponentType<any>;
+        reasoning?: {
+            defaultEffort?: ReasoningEffort;
+            getOptionsForModel?: (model?: string) => ReasoningEffort[];
+            label?: (effort: ReasoningEffort) => string;
+            resolve?: (model: string, effort?: ReasoningEffort) => ReasoningEffort;
+        };
+    };
+    agentChat?: {
+        sendToAgentChat?: (input: ComposerAgentChatMessage) => void;
+        setContextItem?: (input: ComposerAgentChatContextSetOptions) => void;
+        requestThreadOpen?: (input: ComposerAgentChatOpenThreadRequest) => void;
+        formatContextItems?: (items: readonly AgentChatContextItem[] | undefined) => string;
+        normalizeReference?: (reference: unknown) => AgentComposerReference | null;
+        StaleIndexBoundary?: ComponentType<any>;
+    };
+    builder?: {
+        useConnectFlow?: (options: ComposerBuilderConnectFlowOptions) => ComposerBuilderConnectFlow;
+        tryDelegateBuildRequest?: (text: string) => boolean;
+        isTrustedFrameMessage?: (event: MessageEvent) => boolean;
+        isTrustedBuilderMessage?: (event: MessageEvent) => boolean;
+    };
+    resources?: {
+        useOrg?: () => {
+            data?: {
+                orgId?: string | null;
+                role?: string | null;
+            } | null;
+        };
+        isMcpIntegrationAvailable?: () => boolean;
+        useCreateMcpServer?: () => {
+            mutateAsync: (input: any) => Promise<unknown>;
+        };
+        McpIntegrationDialog?: ComponentType<any>;
+    };
+    voice?: {
+        useProviderStatus?: () => {
+            status: {
+                builder?: boolean;
+                openai?: boolean;
+            } | null;
+            refresh: () => void;
+        };
+        getBrowserTabId?: () => string;
+        readAppState?: <T>(key: string) => T | null | undefined | Promise<T | null | undefined>;
+        setAppState?: (key: string, value: unknown) => void | Promise<unknown>;
+        subscribeSidebarState?: (listener: (detail: {
+            open?: boolean;
+        } | undefined) => void) => () => void;
+        applyContextReplacements?: (text: string, context: VoiceContextPack | undefined) => string;
+    };
+}
+export declare function ComposerRuntimeAdaptersProvider({ adapters, children, }: {
+    adapters: ComposerRuntimeAdapters;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function useComposerRuntimeAdapters(): ComposerRuntimeAdapters;
+export declare const DEFAULT_REASONING_EFFORT: ReasoningEffort;
+export declare function getReasoningEffortOptionsForModel(_model?: string): ReasoningEffort[];
+export declare function reasoningEffortLabel(effort: ReasoningEffort): string;
+export declare function resolveReasoningEffortSelection(_model: string, effort?: ReasoningEffort): ReasoningEffort;
+export declare const AGENT_CHAT_INSERT_REFERENCE_EVENT = "agent-native:insert-composer-reference";
+export declare const AGENT_CHAT_INSERT_REFERENCE_MESSAGE_TYPE = "agent-native:insert-composer-reference";
+export declare function formatPromptContextItems(items: AgentChatContextItem[] | undefined): string;
+export declare function applyVoiceContextReplacements(text: string, context: VoiceContextPack | undefined): string;
+//# sourceMappingURL=runtime-adapters.d.ts.map

package/dist/composer/runtime-adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-adapters.d.ts","sourceRoot":"","sources":["../../src/composer/runtime-adapters.tsx"],"names":[],"mappings":"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"}

package/dist/composer/runtime-adapters.js

@@ -0,0 +1,141 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useMemo, } from "react";
+const identityPath = (path) => path;
+const fallbackTranslate = (key, options) => {
+    const template = typeof options?.defaultValue === "string" ? options.defaultValue : key;
+    return template.replace(/{{\s*([\w$.-]+)\s*}}/g, (match, name) => {
+        const value = options?.[name];
+        return value == null ? match : String(value);
+    });
+};
+const fallbackModels = {
+    useChatModels: () => ({
+        selectedModel: "auto",
+        selectedEngine: "auto",
+        selectedEffort: "high",
+        availableModels: [],
+        isLoading: false,
+        onModelChange: () => { },
+        onEffortChange: () => { },
+    }),
+    useAgentEngineConfigured: () => ({ missing: false, state: "configured" }),
+    fetchAgentEngineConfiguredState: async () => "configured",
+};
+const FragmentBoundary = ({ children, }) => _jsx(_Fragment, { children: children });
+const fallbackBuilderFlow = {
+    hasFetchedStatus: false,
+    configured: false,
+    envManaged: false,
+    connecting: false,
+    statusResolved: false,
+    error: null,
+    start: () => { },
+};
+const fallbackAdapters = {
+    resolvePath: identityPath,
+    translate: fallbackTranslate,
+    formatNumber: (value, options) => new Intl.NumberFormat("en-US", options).format(value),
+    models: fallbackModels,
+    agentChat: {
+        sendToAgentChat: () => { },
+        setContextItem: () => { },
+        requestThreadOpen: () => { },
+        formatContextItems: () => "",
+        normalizeReference: (reference) => reference &&
+            typeof reference === "object" &&
+            typeof reference.label === "string" &&
+            typeof reference.refType === "string"
+            ? reference
+            : null,
+        StaleIndexBoundary: FragmentBoundary,
+    },
+    builder: {
+        useConnectFlow: () => fallbackBuilderFlow,
+        tryDelegateBuildRequest: () => false,
+        isTrustedFrameMessage: () => false,
+        isTrustedBuilderMessage: () => false,
+    },
+    resources: {
+        useOrg: () => ({ data: null }),
+        isMcpIntegrationAvailable: () => false,
+        useCreateMcpServer: () => ({ mutateAsync: async () => undefined }),
+    },
+    voice: {
+        useProviderStatus: () => ({ status: null, refresh: () => { } }),
+        getBrowserTabId: () => "",
+        readAppState: () => undefined,
+        setAppState: () => { },
+        subscribeSidebarState: () => () => { },
+        applyContextReplacements: applyVoiceContextReplacements,
+    },
+};
+const ComposerRuntimeAdaptersContext = createContext(fallbackAdapters);
+export function ComposerRuntimeAdaptersProvider({ adapters, children, }) {
+    // Consumers key effects off this value; a fresh identity per render re-runs
+    // every one of them (app-state reads, event subscriptions) on each render.
+    const value = useMemo(() => ({
+        ...fallbackAdapters,
+        ...adapters,
+        models: { ...fallbackModels, ...adapters.models },
+        agentChat: { ...fallbackAdapters.agentChat, ...adapters.agentChat },
+        builder: { ...fallbackAdapters.builder, ...adapters.builder },
+        resources: { ...fallbackAdapters.resources, ...adapters.resources },
+        voice: { ...fallbackAdapters.voice, ...adapters.voice },
+    }), [adapters]);
+    return (_jsx(ComposerRuntimeAdaptersContext.Provider, { value: value, children: children }));
+}
+export function useComposerRuntimeAdapters() {
+    return useContext(ComposerRuntimeAdaptersContext);
+}
+export const DEFAULT_REASONING_EFFORT = "high";
+export function getReasoningEffortOptionsForModel(_model) {
+    return ["low", "medium", "high"];
+}
+export function reasoningEffortLabel(effort) {
+    return effort === "xhigh"
+        ? "Extra high"
+        : effort[0].toUpperCase() + effort.slice(1);
+}
+export function resolveReasoningEffortSelection(_model, effort) {
+    return effort ?? DEFAULT_REASONING_EFFORT;
+}
+export const AGENT_CHAT_INSERT_REFERENCE_EVENT = "agent-native:insert-composer-reference";
+export const AGENT_CHAT_INSERT_REFERENCE_MESSAGE_TYPE = "agent-native:insert-composer-reference";
+export function formatPromptContextItems(items) {
+    return (items
+        ?.map((item) => item.context ?? item.title ?? "")
+        .filter(Boolean)
+        .join("\n\n") ?? "");
+}
+export function applyVoiceContextReplacements(text, context) {
+    const isAlphaNumeric = (value) => value != null && /[\p{L}\p{N}_]/u.test(value);
+    const isSafeBoundary = (value, index, direction) => {
+        const char = value[index];
+        if (char == null)
+            return true;
+        if (isAlphaNumeric(char) || "@/\\:".includes(char))
+            return false;
+        if (".-+".includes(char)) {
+            const neighbor = direction === "before" ? value[index - 1] : value[index + 1];
+            return !isAlphaNumeric(neighbor);
+        }
+        return true;
+    };
+    let next = text;
+    for (const term of context?.terms ?? []) {
+        const source = term.term.trim();
+        const replacement = term.replacement?.trim();
+        if (!replacement || source.length < 2 || replacement === source)
+            continue;
+        const escaped = source.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        next = next.replace(new RegExp(escaped, "giu"), (match, offset) => {
+            const end = offset + match.length;
+            return isSafeBoundary(next, offset - 1, "before") &&
+                isSafeBoundary(next, end, "after")
+                ? replacement
+                : match;
+        });
+    }
+    return next;
+}
+//# sourceMappingURL=runtime-adapters.js.map

package/dist/composer/runtime-adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-adapters.js","sourceRoot":"","sources":["../../src/composer/runtime-adapters.tsx"],"names":[],"mappings":"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"}

package/dist/composer/runtime-adapters.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime-adapters.spec.d.ts.map

package/dist/composer/runtime-adapters.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-adapters.spec.d.ts","sourceRoot":"","sources":["../../src/composer/runtime-adapters.spec.tsx"],"names":[],"mappings":""}

package/dist/composer/runtime-adapters.spec.js

@@ -0,0 +1,69 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// @vitest-environment happy-dom
+import { act, useEffect } from "react";
+import { createRoot } from "react-dom/client";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { ComposerRuntimeAdaptersProvider, useComposerRuntimeAdapters, } from "./runtime-adapters.js";
+let container;
+let root;
+beforeEach(() => {
+    container = document.createElement("div");
+    document.body.appendChild(container);
+    root = createRoot(container);
+});
+afterEach(() => {
+    act(() => root.unmount());
+    container.remove();
+});
+describe("ComposerRuntimeAdaptersProvider", () => {
+    it("interpolates fallback translations without a provider", () => {
+        let translated = "";
+        function Consumer() {
+            const runtime = useComposerRuntimeAdapters();
+            translated = runtime.translate("attachment.tooLarge", {
+                defaultValue: '"{{name}}" is {{size}} MB (max {{maxSize}} MB)',
+                name: "report.pdf",
+                size: 12.5,
+                maxSize: 10,
+            });
+            return null;
+        }
+        act(() => root.render(_jsx(Consumer, {})));
+        expect(translated).toBe('"report.pdf" is 12.5 MB (max 10 MB)');
+    });
+    it("keeps the context value stable so consumer effects do not refire", () => {
+        const readAppState = vi.fn(() => undefined);
+        const adapters = { voice: { readAppState } };
+        const seen = [];
+        function Consumer() {
+            const runtime = useComposerRuntimeAdapters();
+            seen.push(runtime);
+            // Mirrors VoiceButton's voice-input-preference read.
+            useEffect(() => {
+                void runtime.voice.readAppState("voice-input-preference");
+            }, [runtime]);
+            return null;
+        }
+        function Tree({ tick }) {
+            return (_jsxs(ComposerRuntimeAdaptersProvider, { adapters: adapters, children: [_jsx("span", { children: tick }), _jsx(Consumer, {})] }));
+        }
+        act(() => root.render(_jsx(Tree, { tick: 0 })));
+        act(() => root.render(_jsx(Tree, { tick: 1 })));
+        act(() => root.render(_jsx(Tree, { tick: 2 })));
+        expect(seen.length).toBeGreaterThan(1);
+        expect(new Set(seen).size).toBe(1);
+        expect(readAppState).toHaveBeenCalledTimes(1);
+    });
+    it("rebuilds the context value when the adapters prop changes", () => {
+        const seen = [];
+        function Consumer() {
+            seen.push(useComposerRuntimeAdapters());
+            return null;
+        }
+        const render = (adapters) => act(() => root.render(_jsx(ComposerRuntimeAdaptersProvider, { adapters: adapters, children: _jsx(Consumer, {}) })));
+        render({ resolvePath: (path) => `/a${path}` });
+        render({ resolvePath: (path) => `/b${path}` });
+        expect(seen.at(-1).resolvePath("/x")).toBe("/b/x");
+    });
+});
+//# sourceMappingURL=runtime-adapters.spec.js.map

package/dist/composer/runtime-adapters.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-adapters.spec.js","sourceRoot":"","sources":["../../src/composer/runtime-adapters.spec.tsx"],"names":[],"mappings":"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"}

package/dist/composer/types.d.ts

@@ -0,0 +1,60 @@
+export interface FileResult {
+    path: string;
+    name: string;
+    source: "codebase" | "resource";
+    type: "file" | "folder";
+}
+export interface SkillResult {
+    name: string;
+    description: string;
+    path: string;
+    source: "codebase" | "resource";
+}
+export interface MentionItem {
+    id: string;
+    label: string;
+    description?: string;
+    icon?: string;
+    source: string;
+    refType: string;
+    refPath?: string;
+    refId?: string;
+    section?: string;
+    slotKey?: string;
+    slotLabel?: string;
+    metadata?: Record<string, unknown>;
+    clearsSlots?: string[];
+    relatedReferences?: MentionReferenceInsert[];
+}
+export interface Reference {
+    type: "file" | "skill" | "mention" | "agent" | "custom-agent";
+    path: string;
+    name: string;
+    source: string;
+    refType?: string;
+    refId?: string;
+    slotKey?: string;
+    slotLabel?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface MentionReferenceInsert {
+    label: string;
+    icon?: string;
+    source?: string;
+    refType: string;
+    refId?: string | null;
+    refPath?: string | null;
+    slotKey?: string;
+    slotLabel?: string;
+    metadata?: Record<string, unknown>;
+    clearsSlots?: string[];
+    relatedReferences?: MentionReferenceInsert[];
+}
+export interface SlashCommand {
+    name: string;
+    description: string;
+    icon?: string;
+}
+export type ComposerMode = "skill" | "job" | "automation" | "extension";
+export type AgentComposerLayoutVariant = "default" | "compact" | "hero";
+//# sourceMappingURL=types.d.ts.map

package/dist/composer/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/composer/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,GAAG,UAAU,CAAC;IAChC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,GAAG,UAAU,CAAC;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,iBAAiB,CAAC,EAAE,sBAAsB,EAAE,CAAC;CAC9C;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,cAAc,CAAC;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,iBAAiB,CAAC,EAAE,sBAAsB,EAAE,CAAC;CAC9C;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,KAAK,GAAG,YAAY,GAAG,WAAW,CAAC;AAExE,MAAM,MAAM,0BAA0B,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC"}

package/dist/composer/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/composer/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/composer/types.ts"],"names":[],"mappings":""}

package/dist/composer/use-file-search.d.ts

@@ -0,0 +1,6 @@
+import type { FileResult } from "./types.js";
+export declare function useFileSearch(query: string, enabled: boolean): {
+    files: FileResult[];
+    isLoading: boolean;
+};
+//# sourceMappingURL=use-file-search.d.ts.map

package/dist/composer/use-file-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-file-search.d.ts","sourceRoot":"","sources":["../../src/composer/use-file-search.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;;;EA0D5D"}

package/dist/composer/use-file-search.js

@@ -0,0 +1,53 @@
+import { useState, useEffect, useRef } from "react";
+import { useComposerRuntimeAdapters } from "./runtime-adapters.js";
+export function useFileSearch(query, enabled) {
+    const { resolvePath = (path) => path } = useComposerRuntimeAdapters();
+    const [files, setFiles] = useState([]);
+    const [isLoading, setIsLoading] = useState(false);
+    const requestIdRef = useRef(0);
+    const abortRef = useRef(null);
+    useEffect(() => {
+        if (!enabled) {
+            setFiles([]);
+            setIsLoading(false);
+            return;
+        }
+        setIsLoading(true);
+        const id = ++requestIdRef.current;
+        // Abort any in-flight request so a superseded/unmounted query stops fetching
+        // (mirrors use-mention-search). The requestId guard still protects state.
+        abortRef.current?.abort();
+        const abort = new AbortController();
+        abortRef.current = abort;
+        const timer = setTimeout(async () => {
+            try {
+                const res = await fetch(resolvePath(`/_agent-native/agent-chat/files?q=${encodeURIComponent(query)}`), { signal: abort.signal });
+                if (!res.ok)
+                    throw new Error();
+                const data = await res.json();
+                // Only update if this is still the latest request
+                if (id === requestIdRef.current) {
+                    setFiles(data.files || []);
+                }
+            }
+            catch (err) {
+                if (err?.name === "AbortError")
+                    return;
+                if (id === requestIdRef.current) {
+                    setFiles([]);
+                }
+            }
+            finally {
+                if (id === requestIdRef.current) {
+                    setIsLoading(false);
+                }
+            }
+        }, query.length === 0 ? 0 : 200);
+        return () => {
+            clearTimeout(timer);
+            abort.abort();
+        };
+    }, [query, enabled, resolvePath]);
+    return { files, isLoading };
+}
+//# sourceMappingURL=use-file-search.js.map

package/dist/composer/use-file-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-file-search.js","sourceRoot":"","sources":["../../src/composer/use-file-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAEpD,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAGnE,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,OAAgB;IAC3D,MAAM,EAAE,WAAW,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG,0BAA0B,EAAE,CAAC;IACtE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,EAAE,CAAC,CAAC;IACrD,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,QAAQ,GAAG,MAAM,CAAyB,IAAI,CAAC,CAAC;IAEtD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,QAAQ,CAAC,EAAE,CAAC,CAAC;YACb,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO;QACT,CAAC;QAED,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,MAAM,EAAE,GAAG,EAAE,YAAY,CAAC,OAAO,CAAC;QAClC,6EAA6E;QAC7E,0EAA0E;QAC1E,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,IAAI,eAAe,EAAE,CAAC;QACpC,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC;QAEzB,MAAM,KAAK,GAAG,UAAU,CACtB,KAAK,IAAI,EAAE;YACT,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,KAAK,CACrB,WAAW,CACT,qCAAqC,kBAAkB,CAAC,KAAK,CAAC,EAAE,CACjE,EACD,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CACzB,CAAC;gBACF,IAAI,CAAC,GAAG,CAAC,EAAE;oBAAE,MAAM,IAAI,KAAK,EAAE,CAAC;gBAC/B,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;gBAC9B,kDAAkD;gBAClD,IAAI,EAAE,KAAK,YAAY,CAAC,OAAO,EAAE,CAAC;oBAChC,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;gBAC7B,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAK,GAAa,EAAE,IAAI,KAAK,YAAY;oBAAE,OAAO;gBAClD,IAAI,EAAE,KAAK,YAAY,CAAC,OAAO,EAAE,CAAC;oBAChC,QAAQ,CAAC,EAAE,CAAC,CAAC;gBACf,CAAC;YACH,CAAC;oBAAS,CAAC;gBACT,IAAI,EAAE,KAAK,YAAY,CAAC,OAAO,EAAE,CAAC;oBAChC,YAAY,CAAC,KAAK,CAAC,CAAC;gBACtB,CAAC;YACH,CAAC;QACH,CAAC,EACD,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAC7B,CAAC;QAEF,OAAO,GAAG,EAAE;YACV,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;IAElC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAC9B,CAAC"}

package/dist/composer/use-mention-search.d.ts

@@ -0,0 +1,6 @@
+import type { MentionItem } from "./types.js";
+export declare function useMentionSearch(query: string, enabled: boolean, resolvePathOverride?: (path: string) => string): {
+    items: MentionItem[];
+    isLoading: boolean;
+};
+//# sourceMappingURL=use-mention-search.d.ts.map

package/dist/composer/use-mention-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-mention-search.d.ts","sourceRoot":"","sources":["../../src/composer/use-mention-search.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,EAChB,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM;;;EAiF/C"}

package/dist/composer/use-mention-search.js

@@ -0,0 +1,75 @@
+import { useState, useEffect, useRef } from "react";
+import { useComposerRuntimeAdapters } from "./runtime-adapters.js";
+export function useMentionSearch(query, enabled, resolvePathOverride) {
+    const { resolvePath = (path) => path } = useComposerRuntimeAdapters();
+    const resolveRequestPath = resolvePathOverride ?? resolvePath;
+    const [items, setItems] = useState([]);
+    const [isLoading, setIsLoading] = useState(false);
+    const abortRef = useRef(null);
+    const requestIdRef = useRef(0);
+    useEffect(() => {
+        if (!enabled) {
+            setItems([]);
+            setIsLoading(false);
+            return;
+        }
+        // Cancel any in-flight stream
+        abortRef.current?.abort();
+        const abort = new AbortController();
+        abortRef.current = abort;
+        const id = ++requestIdRef.current;
+        setItems([]);
+        setIsLoading(true);
+        const debounceMs = query.length === 0 ? 0 : 150;
+        const timer = setTimeout(async () => {
+            try {
+                const res = await fetch(resolveRequestPath(`/_agent-native/agent-chat/mentions?q=${encodeURIComponent(query)}`), { signal: abort.signal });
+                if (!res.ok || !res.body)
+                    throw new Error();
+                const reader = res.body.getReader();
+                const decoder = new TextDecoder();
+                let buf = "";
+                while (true) {
+                    const { done, value } = await reader.read();
+                    if (done)
+                        break;
+                    buf += decoder.decode(value, { stream: true });
+                    const lines = buf.split("\n");
+                    buf = lines.pop(); // last line may be incomplete
+                    for (const line of lines) {
+                        if (!line.trim())
+                            continue;
+                        try {
+                            const { items: batch } = JSON.parse(line);
+                            if (id === requestIdRef.current && batch?.length) {
+                                setItems((prev) => {
+                                    // Deduplicate by id
+                                    const seen = new Set(prev.map((x) => x.id));
+                                    const fresh = batch.filter((x) => !seen.has(x.id));
+                                    return fresh.length ? [...prev, ...fresh] : prev;
+                                });
+                            }
+                        }
+                        catch { }
+                    }
+                }
+            }
+            catch (err) {
+                if (err instanceof Error && err.name === "AbortError")
+                    return;
+                if (id === requestIdRef.current)
+                    setItems([]);
+            }
+            finally {
+                if (id === requestIdRef.current)
+                    setIsLoading(false);
+            }
+        }, debounceMs);
+        return () => {
+            clearTimeout(timer);
+            abort.abort();
+        };
+    }, [query, enabled, resolveRequestPath]);
+    return { items, isLoading };
+}
+//# sourceMappingURL=use-mention-search.js.map