@agent-native/toolkit 0.5.0 → 0.6.0

package/dist/composer/realtime-voice-transcript.js

@@ -0,0 +1,103 @@
+export function appendRealtimeVoiceTranscriptToRepository(value, transcript) {
+    const repository = value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+    const messages = Array.isArray(repository.messages)
+        ? [...repository.messages]
+        : [];
+    const duplicate = messages.some((entry) => {
+        if (!entry || typeof entry !== "object")
+            return false;
+        const record = entry;
+        const message = record.message && typeof record.message === "object"
+            ? record.message
+            : record;
+        return message.id === transcript.id;
+    });
+    if (duplicate)
+        return { appended: false, repository };
+    const parentId = typeof repository.headId === "string" ? repository.headId : null;
+    const createdAt = new Date(transcript.createdAt);
+    const message = {
+        id: transcript.id,
+        role: transcript.role,
+        content: [{ type: "text", text: transcript.text }],
+        createdAt: Number.isNaN(createdAt.getTime()) ? new Date() : createdAt,
+        metadata: {
+            custom: {
+                source: "realtime-voice",
+            },
+        },
+        ...(transcript.role === "assistant"
+            ? { status: { type: "complete", reason: "stop" } }
+            : {}),
+    };
+    return {
+        appended: true,
+        repository: {
+            ...repository,
+            messages: [...messages, { message, parentId }],
+            headId: transcript.id,
+        },
+    };
+}
+export function createRealtimeVoiceTranscriptRegistry() {
+    const sinks = new Map();
+    const pending = new Map();
+    const delivered = new Set();
+    let order = 0;
+    const flush = () => {
+        for (const [id, message] of pending) {
+            let consumed = false;
+            for (const sink of sinks.values()) {
+                if (sink.threadId !== message.threadId)
+                    continue;
+                try {
+                    consumed = sink.append(message) || consumed;
+                }
+                catch {
+                    // Keep the completed transcript queued until the chat can import it.
+                }
+            }
+            if (!consumed)
+                continue;
+            pending.delete(id);
+            delivered.add(id);
+            if (delivered.size > 1_000) {
+                const oldest = delivered.values().next().value;
+                if (typeof oldest === "string")
+                    delivered.delete(oldest);
+            }
+        }
+    };
+    return {
+        activeThreadId() {
+            let active;
+            for (const sink of sinks.values()) {
+                if (!sink.active || (active && sink.order <= active.order))
+                    continue;
+                active = sink;
+            }
+            return active?.threadId;
+        },
+        publish(message) {
+            const id = message.id.trim();
+            const threadId = message.threadId.trim();
+            const text = message.text.trim();
+            if (!id || !threadId || !text || delivered.has(id) || pending.has(id)) {
+                return;
+            }
+            pending.set(id, { ...message, id, threadId, text });
+            flush();
+        },
+        register(sink) {
+            const token = Symbol("realtime-voice-transcript-sink");
+            sinks.set(token, { ...sink, order: ++order });
+            flush();
+            return () => sinks.delete(token);
+        },
+        pendingCount: () => pending.size,
+    };
+}
+export const realtimeVoiceTranscriptRegistry = createRealtimeVoiceTranscriptRegistry();
+//# sourceMappingURL=realtime-voice-transcript.js.map

package/dist/composer/realtime-voice-transcript.js.map

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

package/dist/composer/realtime-voice-transcript.spec.d.ts

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

package/dist/composer/realtime-voice-transcript.spec.d.ts.map

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

package/dist/composer/realtime-voice-transcript.spec.js

@@ -0,0 +1,76 @@
+import { describe, expect, it, vi } from "vitest";
+import { appendRealtimeVoiceTranscriptToRepository, createRealtimeVoiceTranscriptRegistry, } from "./realtime-voice-transcript.js";
+function transcript(overrides = {}) {
+    return {
+        id: "voice-1",
+        threadId: "thread-1",
+        role: "user",
+        text: "Open sources",
+        createdAt: "2026-07-10T20:00:00.000Z",
+        ...overrides,
+    };
+}
+describe("realtime voice transcript registry", () => {
+    it("captures the latest active thread and buffers until its sink mounts", () => {
+        const registry = createRealtimeVoiceTranscriptRegistry();
+        registry.register({
+            threadId: "thread-old",
+            active: true,
+            append: vi.fn(() => true),
+        });
+        registry.register({
+            threadId: "thread-1",
+            active: true,
+            // Simulate the chat surface being selected but not yet ready to apply
+            // the completed transcript. The registry must retain it for the sink
+            // that mounts once the surface is ready.
+            append: vi.fn(() => false),
+        });
+        expect(registry.activeThreadId()).toBe("thread-1");
+        registry.publish(transcript());
+        expect(registry.pendingCount()).toBe(1);
+        const append = vi.fn(() => true);
+        registry.register({ threadId: "thread-1", active: false, append });
+        expect(append).toHaveBeenCalledOnce();
+        expect(registry.pendingCount()).toBe(0);
+    });
+    it("deduplicates completed provider transcript events", () => {
+        const registry = createRealtimeVoiceTranscriptRegistry();
+        const append = vi.fn(() => true);
+        registry.register({ threadId: "thread-1", active: true, append });
+        registry.publish(transcript());
+        registry.publish(transcript());
+        expect(append).toHaveBeenCalledOnce();
+    });
+});
+describe("appendRealtimeVoiceTranscriptToRepository", () => {
+    it("links completed user and assistant messages without starting a run", () => {
+        const first = appendRealtimeVoiceTranscriptToRepository({}, transcript());
+        const second = appendRealtimeVoiceTranscriptToRepository(first.repository, transcript({
+            id: "voice-2",
+            role: "assistant",
+            text: "Opening Sources.",
+        }));
+        expect(second.repository.headId).toBe("voice-2");
+        expect(second.repository.messages).toMatchObject([
+            {
+                parentId: null,
+                message: {
+                    id: "voice-1",
+                    role: "user",
+                    metadata: { custom: { source: "realtime-voice" } },
+                },
+            },
+            {
+                parentId: "voice-1",
+                message: {
+                    id: "voice-2",
+                    role: "assistant",
+                    status: { type: "complete", reason: "stop" },
+                },
+            },
+        ]);
+        expect(appendRealtimeVoiceTranscriptToRepository(second.repository, transcript({ id: "voice-2" })).appended).toBe(false);
+    });
+});
+//# sourceMappingURL=realtime-voice-transcript.spec.js.map

package/dist/composer/realtime-voice-transcript.spec.js.map

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

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

@@ -0,0 +1,163 @@
+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;
+}
+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;
+    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;
+    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,130 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, } from "react";
+const identityPath = (path) => path;
+const fallbackTranslate = (key, options) => typeof options?.defaultValue === "string" ? options.defaultValue : key;
+const fallbackModels = {
+    useChatModels: () => ({
+        selectedModel: "auto",
+        selectedEngine: "auto",
+        selectedEffort: "medium",
+        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,
+    start: () => { },
+};
+const fallbackAdapters = {
+    resolvePath: identityPath,
+    translate: fallbackTranslate,
+    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, }) {
+    return (_jsx(ComposerRuntimeAdaptersContext.Provider, { value: {
+            ...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 },
+        }, children: children }));
+}
+export function useComposerRuntimeAdapters() {
+    return useContext(ComposerRuntimeAdaptersContext);
+}
+export const DEFAULT_REASONING_EFFORT = "medium";
+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/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