@tetherto/mdk-ui-agent 0.0.0 → 0.12.1

package/dist/hooks/use-agent-chat.d.ts

@@ -0,0 +1,46 @@
+/**
+ * The one stateful hook: owns the session, the live turn, and persistence.
+ *
+ * Components below this are presentational — they receive already-shaped props
+ * and render them, per the repo's separation-of-concerns rule.
+ */
+import type { StoreApi } from 'zustand/vanilla';
+import type { ChatMessage, Conversation, ConversationStore } from '../core/conversation-store';
+import type { AgentTurnState, PendingApproval } from '../core/turn';
+import type { AgentConfigOptions } from './use-agent-config';
+export type UseAgentChatOptions = AgentConfigOptions & {
+    /** Isolated store for tests and the catalog demo; defaults to the singleton. */
+    store?: StoreApi<ConversationStore>;
+    /**
+     * The three silences a turn is allowed, all defaulted in `core/sse`: between
+     * events, while an approval is outstanding, and before the first event. Raise
+     * the second if your gateway's `agent.approvalTimeoutMs` is longer than five
+     * minutes, and the third if its model is slower to route than two minutes.
+     */
+    idleTimeoutMs?: number;
+    approvalIdleTimeoutMs?: number;
+    firstEventIdleTimeoutMs?: number;
+};
+export type UseAgentChatResult = {
+    conversations: Conversation[];
+    active: Conversation | null;
+    /** Persisted transcript of the active conversation. */
+    messages: ChatMessage[];
+    /** The turn currently streaming, rendered after `messages`. Null when idle. */
+    live: AgentTurnState | null;
+    isStreaming: boolean;
+    pendingApproval: PendingApproval | null;
+    /** A decision has been POSTed and the stream has not resumed yet. */
+    isDecisionPending: boolean;
+    canSend: boolean;
+    send: (text: string) => void;
+    decide: (approved: boolean) => void;
+    abort: VoidFunction;
+    /** Re-sends the last question, for a turn that failed. */
+    retry: VoidFunction;
+    newConversation: VoidFunction;
+    selectConversation: (id: string) => void;
+    removeConversation: (id: string) => void;
+};
+export declare function useAgentChat(options?: UseAgentChatOptions): UseAgentChatResult;
+//# sourceMappingURL=use-agent-chat.d.ts.map

package/dist/hooks/use-agent-chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-agent-chat.d.ts","sourceRoot":"","sources":["../../src/hooks/use-agent-chat.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAG/C,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAC9F,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAoC5D,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,GAAG;IACrD,gFAAgF;IAChF,KAAK,CAAC,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAA;IACnC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,uBAAuB,CAAC,EAAE,MAAM,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,aAAa,EAAE,YAAY,EAAE,CAAA;IAC7B,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;IAC3B,uDAAuD;IACvD,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB,+EAA+E;IAC/E,IAAI,EAAE,cAAc,GAAG,IAAI,CAAA;IAC3B,WAAW,EAAE,OAAO,CAAA;IACpB,eAAe,EAAE,eAAe,GAAG,IAAI,CAAA;IACvC,qEAAqE;IACrE,iBAAiB,EAAE,OAAO,CAAA;IAC1B,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5B,MAAM,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAA;IACnC,KAAK,EAAE,YAAY,CAAA;IACnB,0DAA0D;IAC1D,KAAK,EAAE,YAAY,CAAA;IACnB,eAAe,EAAE,YAAY,CAAA;IAC7B,kBAAkB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACxC,kBAAkB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;CACzC,CAAA;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,kBAAkB,CA8SlF"}

package/dist/hooks/use-agent-chat.js

@@ -0,0 +1,288 @@
+/**
+ * The one stateful hook: owns the session, the live turn, and persistence.
+ *
+ * Components below this are presentational — they receive already-shaped props
+ * and render them, per the repo's separation-of-concerns rule.
+ */
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { conversationStore as defaultStore, MESSAGE_ROLE } from '../core/conversation-store';
+import { describeAgentError, GENERIC_TURN_ERROR } from '../core/error-text';
+import { AGENT_ERROR, AgentApiError, createSession, decideApproval, deleteSession, streamTurn, } from '../core/transport';
+import { abortTurn, createTurnState, failTurn, isTurnSettled, reduceTurn } from '../core/turn';
+import { uuid } from '../core/uuid';
+import { useAgentConfig } from './use-agent-config';
+import { useConversations } from './use-conversations';
+/**
+ * Said in the transcript when a turn had to open a new gateway session.
+ *
+ * Sessions live in the gateway's memory, so a restart or the agent's own TTL makes
+ * a stored id a 404 and the next message starts a session with no history. The
+ * transcript above it still reads as one conversation, so without this the operator
+ * asks a follow-up about "that container" and the agent has never heard of it.
+ */
+const SESSION_RESET_NOTICE = 'New session — the agent does not remember the messages above this line.';
+function describeError(error) {
+    if (error instanceof AgentApiError)
+        return describeAgentError(error.code) ?? error.message;
+    return GENERIC_TURN_ERROR;
+}
+function isAbort(error) {
+    return error instanceof DOMException && error.name === 'AbortError';
+}
+export function useAgentChat(options = {}) {
+    const { store = defaultStore, idleTimeoutMs, approvalIdleTimeoutMs, firstEventIdleTimeoutMs, ...configOptions } = options;
+    const config = useAgentConfig(configOptions);
+    const { conversations, active, create, select, remove } = useConversations(store);
+    const [live, setLive] = useState(null);
+    const [isBusy, setIsBusy] = useState(false);
+    const [decidedApprovalId, setDecidedApprovalId] = useState(null);
+    // Read inside async callbacks, where the rendered value would be stale.
+    const liveRef = useRef(null);
+    const abortRef = useRef(null);
+    const busyRef = useRef(false);
+    const frameRef = useRef(null);
+    /**
+     * Records the live turn, and commits it to React at most once per frame.
+     *
+     * One `setState` per SSE event means the whole panel re-renders 30–60 times a
+     * second at token rate, for a transcript whose settled half never changed. The
+     * ref is updated synchronously — callbacks and the next reduce read it — and the
+     * scheduled commit always publishes the latest value, so no event is skipped,
+     * only the intermediate paints. Clearing the turn commits immediately: it is the
+     * end of the turn, not a frame of it.
+     */
+    const publish = useCallback((next) => {
+        liveRef.current = next;
+        if (next === null) {
+            if (frameRef.current !== null)
+                cancelAnimationFrame(frameRef.current);
+            frameRef.current = null;
+            setLive(null);
+            return;
+        }
+        if (frameRef.current !== null)
+            return;
+        frameRef.current = requestAnimationFrame(() => {
+            frameRef.current = null;
+            setLive(liveRef.current);
+        });
+    }, []);
+    useEffect(() => () => {
+        if (frameRef.current !== null)
+            cancelAnimationFrame(frameRef.current);
+        abortRef.current?.abort();
+    }, []);
+    /**
+     * A stored `sessionId` outlives the session it names — the gateway holds
+     * sessions in memory per process, so a restart or the agent's own TTL makes it
+     * a 404. `force` mints a replacement.
+     */
+    const resolveSessionId = useCallback(async (conversationId, force) => {
+        const conversation = store
+            .getState()
+            .conversations.find((candidate) => candidate.id === conversationId);
+        if (!force && conversation?.sessionId)
+            return conversation.sessionId;
+        const sessionId = await createSession(config);
+        store.getState().setSessionId(conversationId, sessionId);
+        // Only a break if there was something to lose. A conversation whose only
+        // message is the question now being sent has no context to carry over, so
+        // the first session of a conversation is not announced.
+        const hadContext = conversation?.messages.some((message) => message.role === MESSAGE_ROLE.ASSISTANT) ?? false;
+        if (hadContext) {
+            store.getState().appendMessage(conversationId, {
+                id: uuid(),
+                role: MESSAGE_ROLE.SYSTEM,
+                text: SESSION_RESET_NOTICE,
+                at: Date.now(),
+            });
+        }
+        return sessionId;
+    }, [config, store]);
+    /**
+     * Opens the stream, retrying once against a fresh session if the stored one is
+     * gone. The first `next()` is what performs the fetch — an async generator's
+     * body does not run until then — so the status check happens here, not later
+     * in the consume loop.
+     */
+    const openStream = useCallback(async (conversationId, text, signal) => {
+        const start = async (force) => {
+            const sessionId = await resolveSessionId(conversationId, force);
+            const iterator = streamTurn(sessionId, text, {
+                ...config,
+                ...(idleTimeoutMs === undefined ? {} : { idleTimeoutMs }),
+                ...(approvalIdleTimeoutMs === undefined ? {} : { approvalIdleTimeoutMs }),
+                ...(firstEventIdleTimeoutMs === undefined ? {} : { firstEventIdleTimeoutMs }),
+                signal,
+            });
+            return { iterator, first: await iterator.next() };
+        };
+        try {
+            return await start(false);
+        }
+        catch (error) {
+            if (error instanceof AgentApiError && error.is(AGENT_ERROR.SESSION_NOT_FOUND)) {
+                return await start(true);
+            }
+            throw error;
+        }
+    }, [approvalIdleTimeoutMs, config, firstEventIdleTimeoutMs, idleTimeoutMs, resolveSessionId]);
+    const runTurn = useCallback(async (text) => {
+        busyRef.current = true;
+        setIsBusy(true);
+        setDecidedApprovalId(null);
+        const conversationId = store.getState().activeId ?? store.getState().create();
+        store.getState().appendMessage(conversationId, {
+            id: uuid(),
+            role: MESSAGE_ROLE.USER,
+            text,
+            at: Date.now(),
+        });
+        const controller = new AbortController();
+        abortRef.current = controller;
+        let state = createTurnState();
+        publish(state);
+        try {
+            const { iterator, first } = await openStream(conversationId, text, controller.signal);
+            let result = first;
+            while (!result.done) {
+                state = reduceTurn(state, result.value);
+                publish(state);
+                result = await iterator.next();
+            }
+        }
+        catch (error) {
+            // An abort is the operator's own doing: keep whatever streamed, add no
+            // error. Anything else becomes the turn's error. Either way a tool call
+            // still outstanding is closed — it will never report back now.
+            state = isAbort(error) ? abortTurn(state) : failTurn(state, describeError(error));
+        }
+        finally {
+            // An abort cancels the reader rather than rejecting the read, so it
+            // usually ends the loop normally and never reaches the catch above. The
+            // closing-down a stopped turn needs therefore happens here.
+            const interrupted = controller.signal.aborted && !isTurnSettled(state);
+            if (interrupted)
+                state = abortTurn(state);
+            store.getState().appendMessage(conversationId, {
+                id: uuid(),
+                role: MESSAGE_ROLE.ASSISTANT,
+                text: state.text,
+                at: Date.now(),
+                tools: state.tools,
+                error: state.error,
+                // Half an answer must not read back later as the agent's full statement.
+                ...(interrupted ? { interrupted: true } : {}),
+            });
+            publish(null);
+            abortRef.current = null;
+            busyRef.current = false;
+            setIsBusy(false);
+            setDecidedApprovalId(null);
+        }
+    }, [openStream, publish, store]);
+    const send = useCallback((raw) => {
+        const text = raw.trim();
+        // Guarded on the ref rather than the rendered flag: two submits inside one
+        // frame would both see the old state and provoke a 409.
+        if (!text || busyRef.current)
+            return;
+        void runTurn(text);
+    }, [runTurn]);
+    const decide = useCallback((approved) => {
+        const pending = liveRef.current?.pendingApproval;
+        const conversationId = store.getState().activeId;
+        if (!pending || !conversationId)
+            return;
+        const sessionId = store
+            .getState()
+            .conversations.find((conversation) => conversation.id === conversationId)?.sessionId;
+        if (!sessionId)
+            return;
+        setDecidedApprovalId(pending.approvalId);
+        void decideApproval(sessionId, pending.approvalId, approved, config).catch((error) => {
+            // A 404 means the approval already settled — it timed out server-side, or
+            // this is a second decision. Both are indistinguishable by design, and
+            // the stream resumes either way, so there is nothing to report.
+            if (error instanceof AgentApiError && error.is(AGENT_ERROR.APPROVAL_NOT_FOUND))
+                return;
+            setDecidedApprovalId(null);
+        });
+    }, [config, store]);
+    const abort = useCallback(() => {
+        abortRef.current?.abort();
+    }, []);
+    /**
+     * Re-asks the last question after a failed turn.
+     *
+     * The question is re-sent as a new message rather than the failed turn being
+     * resumed — the gateway has no notion of resuming one — so the transcript shows
+     * it asked twice, which is what happened.
+     */
+    const retry = useCallback(() => {
+        if (busyRef.current)
+            return;
+        const conversationId = store.getState().activeId;
+        if (!conversationId)
+            return;
+        const messages = store
+            .getState()
+            .conversations.find((conversation) => conversation.id === conversationId)?.messages ?? [];
+        const lastQuestion = [...messages].reverse().find((message) => message.role === MESSAGE_ROLE.USER);
+        if (!lastQuestion)
+            return;
+        void runTurn(lastQuestion.text);
+    }, [runTurn, store]);
+    const newConversation = useCallback(() => {
+        if (busyRef.current)
+            return;
+        create();
+    }, [create]);
+    const selectConversation = useCallback((id) => {
+        if (busyRef.current)
+            return;
+        select(id);
+    }, [select]);
+    /**
+     * Drops the conversation locally and releases its gateway session.
+     *
+     * The DELETE is best-effort and deliberately unawaited: the session may
+     * already be gone (a restart, or the agent's own TTL) and the gateway refuses
+     * to delete one with a turn in flight. Neither should block removing the local
+     * record, which is the only copy the operator can see.
+     */
+    const removeConversation = useCallback((id) => {
+        if (busyRef.current && store.getState().activeId === id)
+            return;
+        const sessionId = store
+            .getState()
+            .conversations.find((conversation) => conversation.id === id)?.sessionId;
+        remove(id);
+        if (sessionId) {
+            void deleteSession(sessionId, config).catch(() => {
+                // Already collected, or still busy. The gateway reaps it either way.
+            });
+        }
+    }, [config, remove, store]);
+    const pendingApproval = live?.pendingApproval ?? null;
+    return {
+        conversations,
+        active,
+        messages: active?.messages ?? [],
+        live,
+        isStreaming: isBusy,
+        pendingApproval,
+        isDecisionPending: pendingApproval !== null && decidedApprovalId === pendingApproval.approvalId,
+        // A turn paused on an approval still holds the session busy, so this stays
+        // false through the approval too — sending now would be a 409.
+        canSend: !isBusy,
+        send,
+        decide,
+        abort,
+        retry,
+        newConversation,
+        selectConversation,
+        removeConversation,
+    };
+}
+//# sourceMappingURL=use-agent-chat.js.map

package/dist/hooks/use-agent-chat.js.map

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

package/dist/hooks/use-agent-config.d.ts

@@ -0,0 +1,29 @@
+import type { AgentTransportOptions, TokenSource } from '../core/transport';
+export type AgentConfigOptions = {
+    /**
+     * Gateway origin. Defaults to whatever the app already configured on
+     * `MdkProvider`, so a host that set its API base once does not set it again
+     * here — and to `''` outside one, meaning relative URLs, which is what the
+     * generated shell wants: it proxies `/agent` in dev and is served same-origin
+     * in production. Set it only to override that, and remember the gateway sends
+     * no CORS headers if you point it at another origin.
+     */
+    apiBaseUrl?: string;
+    /**
+     * Bearer token source. Defaults to the `MdkProvider`'s auth provider, and to
+     * no token at all outside one — which is correct for a gateway running without
+     * an auth plugin, where every caller is the single local operator.
+     */
+    getToken?: TokenSource;
+    /** Injected in tests and by the catalog demo. */
+    fetchImpl?: typeof fetch;
+};
+/**
+ * Resolves transport options from explicit props, falling back to the MDK
+ * provider.
+ *
+ * `useMdkAuth` deliberately does not throw outside an `MdkProvider`, which is
+ * what lets the panel be dropped into a non-MDK app with just an `apiBaseUrl`.
+ */
+export declare function useAgentConfig(options?: AgentConfigOptions): AgentTransportOptions;
+//# sourceMappingURL=use-agent-config.d.ts.map

package/dist/hooks/use-agent-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-agent-config.d.ts","sourceRoot":"","sources":["../../src/hooks/use-agent-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAK3E,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CACzB,CAAA;AA0BD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,kBAAuB,GAAG,qBAAqB,CAatF"}

package/dist/hooks/use-agent-config.js

@@ -0,0 +1,45 @@
+import { useMdkAuth, useQueryClient } from '@tetherto/mdk-react-adapter';
+import { getFetcher, getMdkRuntime } from '@tetherto/mdk-ui-foundation';
+import { useMemo } from 'react';
+/**
+ * The base URL the app already configured on `MdkProvider`, or undefined.
+ *
+ * Two things make this narrower than a plain `getApiBaseUrl`. It has to survive
+ * having no provider at all, since the panel is meant to drop into a non-MDK
+ * app — `useQueryClient` throws there, and the context read happens before the
+ * throw, so guarding it leaves hook order intact. And `getApiBaseUrl` answers
+ * `http://localhost:3000` for a client MDK did not build, which would quietly
+ * point the panel at an origin nobody chose. A fetcher in the meta is what says
+ * the client came from `createMdkQueryClient`, so its base URL — including the
+ * empty string the shell sets deliberately — is meant rather than defaulted.
+ */
+function useConfiguredBaseUrl() {
+    // Neither MDK package re-exports the QueryClient type, and @tanstack/react-query is not a
+    // dependency here — so the type comes from the hook that returns it.
+    let client;
+    try {
+        client = useQueryClient();
+    }
+    catch {
+        return undefined;
+    }
+    return getFetcher(client) ? getMdkRuntime(client).baseUrl : undefined;
+}
+/**
+ * Resolves transport options from explicit props, falling back to the MDK
+ * provider.
+ *
+ * `useMdkAuth` deliberately does not throw outside an `MdkProvider`, which is
+ * what lets the panel be dropped into a non-MDK app with just an `apiBaseUrl`.
+ */
+export function useAgentConfig(options = {}) {
+    const auth = useMdkAuth();
+    const configuredBaseUrl = useConfiguredBaseUrl();
+    const { apiBaseUrl, getToken, fetchImpl } = options;
+    return useMemo(() => ({
+        baseUrl: apiBaseUrl ?? configuredBaseUrl ?? '',
+        getToken: getToken ?? (() => auth.getToken()),
+        ...(fetchImpl ? { fetchImpl } : {}),
+    }), [apiBaseUrl, configuredBaseUrl, getToken, fetchImpl, auth]);
+}
+//# sourceMappingURL=use-agent-config.js.map

package/dist/hooks/use-agent-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-agent-config.js","sourceRoot":"","sources":["../../src/hooks/use-agent-config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AACxE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AACvE,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAsB/B;;;;;;;;;;;GAWG;AACH,SAAS,oBAAoB;IAC3B,0FAA0F;IAC1F,qEAAqE;IACrE,IAAI,MAAyC,CAAA;IAC7C,IAAI,CAAC;QACH,MAAM,GAAG,cAAc,EAAE,CAAA;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;AACvE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,OAAO,GAAuB,EAAE;IAC7D,MAAM,IAAI,GAAG,UAAU,EAAE,CAAA;IACzB,MAAM,iBAAiB,GAAG,oBAAoB,EAAE,CAAA;IAChD,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,OAAO,CAAA;IAEnD,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC;QACL,OAAO,EAAE,UAAU,IAAI,iBAAiB,IAAI,EAAE;QAC9C,QAAQ,EAAE,QAAQ,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC7C,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpC,CAAC,EACF,CAAC,UAAU,EAAE,iBAAiB,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,CAC3D,CAAA;AACH,CAAC"}

package/dist/hooks/use-conversations.d.ts

@@ -0,0 +1,19 @@
+import type { StoreApi } from 'zustand/vanilla';
+import type { Conversation, ConversationStore } from '../core/conversation-store';
+export type UseConversationsResult = {
+    /** Newest first — the order the Conversations view renders. */
+    conversations: Conversation[];
+    active: Conversation | null;
+    activeId: string | null;
+    create: ConversationStore['create'];
+    select: ConversationStore['select'];
+    remove: ConversationStore['remove'];
+};
+/**
+ * Binds the conversation store to React.
+ *
+ * Takes a store instance so tests and the catalog demo can run against an
+ * isolated one; runtime callers get the module singleton.
+ */
+export declare function useConversations(store?: StoreApi<ConversationStore>): UseConversationsResult;
+//# sourceMappingURL=use-conversations.d.ts.map

package/dist/hooks/use-conversations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-conversations.d.ts","sourceRoot":"","sources":["../../src/hooks/use-conversations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAI/C,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAGjF,MAAM,MAAM,sBAAsB,GAAG;IACnC,+DAA+D;IAC/D,aAAa,EAAE,YAAY,EAAE,CAAA;IAC7B,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,MAAM,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAA;IACnC,MAAM,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAA;IACnC,MAAM,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAA;CACpC,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,GAAE,QAAQ,CAAC,iBAAiB,CAAgB,GAChD,sBAAsB,CAaxB"}

package/dist/hooks/use-conversations.js

@@ -0,0 +1,19 @@
+import { useMemo } from 'react';
+import { useStore } from 'zustand';
+import { conversationStore as defaultStore } from '../core/conversation-store';
+/**
+ * Binds the conversation store to React.
+ *
+ * Takes a store instance so tests and the catalog demo can run against an
+ * isolated one; runtime callers get the module singleton.
+ */
+export function useConversations(store = defaultStore) {
+    const conversations = useStore(store, (state) => state.conversations);
+    const activeId = useStore(store, (state) => state.activeId);
+    const create = useStore(store, (state) => state.create);
+    const select = useStore(store, (state) => state.select);
+    const remove = useStore(store, (state) => state.remove);
+    const active = useMemo(() => conversations.find((conversation) => conversation.id === activeId) ?? null, [conversations, activeId]);
+    return { conversations, active, activeId, create, select, remove };
+}
+//# sourceMappingURL=use-conversations.js.map

package/dist/hooks/use-conversations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-conversations.js","sourceRoot":"","sources":["../../src/hooks/use-conversations.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAGlC,OAAO,EAAE,iBAAiB,IAAI,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAY9E;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAK,GAAgC,YAAY;IAEjD,MAAM,aAAa,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,CAAA;IACrE,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IAC3D,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IACvD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IACvD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAEvD,MAAM,MAAM,GAAG,OAAO,CACpB,GAAG,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,EAAE,KAAK,QAAQ,CAAC,IAAI,IAAI,EAChF,CAAC,aAAa,EAAE,QAAQ,CAAC,CAC1B,CAAA;IAED,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;AACpE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @tetherto/mdk-ui-agent
+ *
+ * The operator Co-pilot, as a drop-in for any MDK UI shell. Talks to the agent
+ * gateway plugin (`@tetherto/mdk-app-agent`) over SSE and renders its
+ * six-event contract as a conversation.
+ *
+ * ```tsx
+ * import { CoPilot } from '@tetherto/mdk-ui-agent'
+ * import '@tetherto/mdk-ui-agent/styles.css'
+ *
+ * <CoPilot />
+ * ```
+ *
+ * `CoPilotPanel` is deliberately NOT exported here — it is reachable from
+ * `@tetherto/mdk-ui-agent/panel`. Both entries load it through a lazy boundary
+ * so the markdown renderer and syntax highlighter stay out of the host's first
+ * paint, and a single static import from this barrel would collapse that split
+ * for every consumer.
+ */
+export { AGENT_LABELS, AGENT_NAME, OPERATOR_NAME } from './branding';
+export * from './core';
+export type { ChatUIEntryProps } from './entries/chat-page';
+export { ChatUIEntry } from './entries/chat-page';
+export type { CoPilotPosition, CoPilotProps } from './entries/co-pilot';
+export { CoPilot, COPILOT_POSITION } from './entries/co-pilot';
+export * from './hooks';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AACpE,cAAc,QAAQ,CAAA;AACtB,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAE3D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEvE,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC9D,cAAc,SAAS,CAAA"}

package/dist/index.js

@@ -0,0 +1,26 @@
+/**
+ * @tetherto/mdk-ui-agent
+ *
+ * The operator Co-pilot, as a drop-in for any MDK UI shell. Talks to the agent
+ * gateway plugin (`@tetherto/mdk-app-agent`) over SSE and renders its
+ * six-event contract as a conversation.
+ *
+ * ```tsx
+ * import { CoPilot } from '@tetherto/mdk-ui-agent'
+ * import '@tetherto/mdk-ui-agent/styles.css'
+ *
+ * <CoPilot />
+ * ```
+ *
+ * `CoPilotPanel` is deliberately NOT exported here — it is reachable from
+ * `@tetherto/mdk-ui-agent/panel`. Both entries load it through a lazy boundary
+ * so the markdown renderer and syntax highlighter stay out of the host's first
+ * paint, and a single static import from this barrel would collapse that split
+ * for every consumer.
+ */
+export { AGENT_LABELS, AGENT_NAME, OPERATOR_NAME } from './branding';
+export * from './core';
+export { ChatUIEntry } from './entries/chat-page';
+export { CoPilot, COPILOT_POSITION } from './entries/co-pilot';
+export * from './hooks';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AACpE,cAAc,QAAQ,CAAA;AAGtB,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAGjD,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC9D,cAAc,SAAS,CAAA"}

package/dist/styles.css

@@ -0,0 +1 @@
+@layer base{:root{--mdk-agent-surface:var(--mdk-color-obsidian,#161514);--mdk-agent-surface-raised:var(--mdk-color-gray-900,#1a1815);--mdk-agent-border:var(--mdk-color-white-alpha-024,#ffffff24);--mdk-agent-border-strong:var(--mdk-color-white-alpha-04,#ffffff40);--mdk-agent-text:var(--mdk-color-text-secondary,#ffffffd9);--mdk-agent-text-muted:var(--mdk-color-gray-400,#8e8e8e);--mdk-agent-accent:var(--mdk-color-primary,#f7931a);--mdk-agent-accent-contrast:var(--mdk-color-dark-black,#10100f);--mdk-agent-success:var(--mdk-color-brick-green,#34c759);--mdk-agent-danger:var(--mdk-color-brick-red,#ff3b30);--mdk-agent-panel-width:420px;--mdk-agent-panel-height:640px;--mdk-agent-panel-inset:24px;--mdk-agent-radius:var(--mdk-radius,0px);--mdk-agent-font:var(--font-mono,ui-monospace, "SF Mono", monospace);--mdk-agent-z:900}}@layer mdk{.mdk-agent-root{bottom:var(--mdk-agent-panel-inset);z-index:var(--mdk-agent-z);font-family:var(--mdk-agent-font);position:fixed}.mdk-agent-root--bottom-right{right:var(--mdk-agent-panel-inset)}.mdk-agent-root--bottom-left{left:var(--mdk-agent-panel-inset)}.mdk-agent-fab{background:var(--mdk-agent-accent);width:48px;height:48px;color:var(--mdk-agent-accent-contrast);cursor:pointer;clip-path:polygon(25% 0,100% 0,100% 75%,75% 100%,0 100%,0 25%);border:none;justify-content:center;align-items:center;padding:0;display:flex}.mdk-agent-fab:hover{background:var(--mdk-color-primary-button-hover,#f8a348)}.mdk-agent-fab:focus-visible{box-shadow:inset 0 0 0 2px var(--mdk-agent-accent-contrast);outline:none}.mdk-agent-panel{border:1px solid var(--mdk-agent-border);border-radius:var(--mdk-agent-radius);background:var(--mdk-agent-surface);min-height:0;color:var(--mdk-agent-text);font-family:var(--mdk-agent-font);flex-direction:column;font-size:13px;line-height:19px;display:flex}.mdk-agent-panel--docked{width:var(--mdk-agent-panel-width);height:var(--mdk-agent-panel-height);max-width:calc(100vw - var(--mdk-agent-panel-inset) * 2);max-height:calc(100vh - var(--mdk-agent-panel-inset) * 2);box-shadow:0 18px 48px #0000008c}.mdk-agent-panel--page{width:100%;height:100%;min-height:480px}.mdk-agent-header{border-bottom:1px solid var(--mdk-agent-border);justify-content:space-between;align-items:flex-start;gap:12px;padding:10px 12px 10px 16px;display:flex}.mdk-agent-header__titles{flex-direction:column;gap:4px;min-width:0;display:flex}.mdk-agent-header__title{color:var(--mdk-color-white,#fff);align-items:center;gap:4px;margin:0;font-size:15px;font-weight:600;line-height:20px;display:flex}.mdk-agent-header__back{margin-left:-8px}.mdk-agent-header__status{color:var(--mdk-agent-text-muted);margin:0;font-size:11px;line-height:13px}.mdk-agent-header__actions{flex:none;align-items:center;gap:2px;display:flex}.mdk-agent-header__actions button,.mdk-agent-header__back{width:28px;height:28px;color:var(--mdk-agent-text-muted);background:0 0;border:none;padding:0}.mdk-agent-header__actions button:hover:not(:disabled),.mdk-agent-header__back:hover:not(:disabled){background:var(--mdk-agent-surface-raised);color:var(--mdk-color-white,#fff)}.mdk-agent-header__actions button:disabled,.mdk-agent-header__back:disabled{opacity:.4}.mdk-agent-header__actions button svg,.mdk-agent-header__back svg{width:16px;height:16px}.mdk-agent-messages{overscroll-behavior:contain;flex-direction:column;flex:auto;gap:20px;min-height:0;padding:16px;display:flex;overflow-y:auto}.mdk-agent-messages__empty{color:var(--mdk-agent-text-muted);text-align:center;margin:auto 0}.mdk-agent-message{flex-direction:column;gap:6px;min-width:0;display:flex}.mdk-agent-message__role{color:var(--mdk-agent-text-muted);letter-spacing:.08em;text-transform:uppercase;margin:0;font-size:10px}.mdk-agent-message__dot{background:var(--mdk-agent-accent);width:6px;height:6px;margin-right:6px;display:inline-block}.mdk-agent-message__bubble{border:1px solid var(--mdk-agent-border-strong);border-radius:var(--mdk-agent-radius);white-space:pre-wrap;overflow-wrap:anywhere;padding:9px 12px}.mdk-agent-message__tools{flex-wrap:wrap;gap:6px;display:flex}.mdk-agent-message__intent{margin:0}.mdk-agent-message__error{color:var(--mdk-agent-danger);align-items:baseline;gap:8px;margin:0;display:flex}.mdk-agent-message__retry{color:inherit;font:inherit;white-space:nowrap;cursor:pointer;background:0 0;border:none;flex:none;padding:0;text-decoration:underline}.mdk-agent-message__note{color:var(--mdk-agent-text-muted);margin:0;font-size:11px}.mdk-agent-message--user{align-items:flex-end}.mdk-agent-message--user .mdk-agent-message__role,.mdk-agent-message--user .mdk-agent-message__bubble{max-width:85%}.mdk-agent-tool-chip{border:1px solid var(--mdk-agent-border-strong);border-radius:var(--mdk-agent-radius);color:var(--mdk-agent-text-muted);align-items:center;gap:6px;padding:3px 8px;font-size:11px;line-height:13px;display:inline-flex}.mdk-agent-tool-chip__icon:empty{display:none}.mdk-agent-tool-chip__icon{display:inline-flex}.mdk-agent-tool-chip--ok{color:var(--mdk-agent-success);border-color:color-mix(in srgb, var(--mdk-agent-success) 45%, transparent)}.mdk-agent-tool-chip--running,.mdk-agent-tool-chip--awaiting-approval{color:var(--mdk-agent-accent);border-color:color-mix(in srgb, var(--mdk-agent-accent) 45%, transparent)}.mdk-agent-tool-chip--rejected{color:var(--mdk-agent-text-muted);border-color:var(--mdk-agent-border-strong);text-decoration:line-through}.mdk-agent-tool-chip--error{color:var(--mdk-agent-danger);border-color:color-mix(in srgb, var(--mdk-agent-danger) 45%, transparent)}.mdk-agent-tool-chip--interrupted{color:var(--mdk-agent-text-muted);border-color:var(--mdk-agent-border-strong);border-style:dashed}.mdk-agent-system{border-top:1px dashed var(--mdk-agent-border);color:var(--mdk-agent-text-muted);text-align:center;margin:0;padding:6px 0;font-size:11px}.mdk-agent-markdown{overflow-wrap:anywhere;min-width:0}.mdk-agent-markdown--streaming{white-space:pre-wrap}.mdk-agent-markdown>:first-child{margin-top:0}.mdk-agent-markdown>:last-child{margin-bottom:0}.mdk-agent-markdown p,.mdk-agent-markdown ul,.mdk-agent-markdown ol,.mdk-agent-markdown pre,.mdk-agent-markdown table,.mdk-agent-markdown blockquote,.mdk-agent-markdown hr,.mdk-agent-markdown .mdk-agent-code{margin:0 0 10px}.mdk-agent-markdown ul,.mdk-agent-markdown ol{padding-left:20px}.mdk-agent-markdown h1,.mdk-agent-markdown h2,.mdk-agent-markdown h3,.mdk-agent-markdown h4,.mdk-agent-markdown h5,.mdk-agent-markdown h6{margin:14px 0 6px;font-weight:600;line-height:1.3}.mdk-agent-markdown h1{font-size:15px}.mdk-agent-markdown h2{font-size:14px}.mdk-agent-markdown h3,.mdk-agent-markdown h4,.mdk-agent-markdown h5,.mdk-agent-markdown h6{font-size:13px}.mdk-agent-markdown blockquote{border-left:2px solid var(--mdk-agent-border-strong);color:var(--mdk-agent-text-muted);padding-left:10px}.mdk-agent-markdown hr{border:none;border-top:1px solid var(--mdk-agent-border);height:0}.mdk-agent-markdown img{max-width:100%;height:auto}.mdk-agent-markdown code{background:var(--mdk-agent-surface-raised);padding:1px 4px;font-size:12px}.mdk-agent-markdown pre{background:var(--mdk-agent-surface-raised);border:1px solid var(--mdk-agent-border);padding:10px;overflow-x:auto}.mdk-agent-markdown pre code{background:0 0;padding:0}.mdk-agent-markdown table{border-collapse:collapse;width:max-content;max-width:100%;display:block;overflow-x:auto}.mdk-agent-markdown th,.mdk-agent-markdown td{text-align:left;padding:4px 10px 4px 0}.mdk-agent-markdown th{color:var(--mdk-agent-text-muted);font-weight:600}.mdk-agent-markdown li:has(>input[type=checkbox]){margin-left:-20px;list-style:none}.mdk-agent-markdown input[type=checkbox]{vertical-align:baseline;accent-color:var(--mdk-agent-accent);margin-right:6px}.mdk-agent-markdown .footnotes{border-top:1px solid var(--mdk-agent-border);color:var(--mdk-agent-text-muted);margin-top:12px;padding-top:6px;font-size:11px}.mdk-agent-markdown .footnotes h2{clip-path:inset(50%);width:1px;height:1px;position:absolute;overflow:hidden}.mdk-agent-markdown a{color:var(--mdk-agent-accent)}.mdk-agent-markdown__more{color:var(--mdk-agent-accent);font:inherit;cursor:pointer;background:0 0;border:none;align-self:flex-start;padding:0;font-size:11px;text-decoration:underline}.mdk-agent-code{position:relative}.mdk-agent-code pre{margin:0}.mdk-agent-code__copy{border:1px solid var(--mdk-agent-border-strong);background:var(--mdk-agent-surface);color:var(--mdk-agent-text-muted);font:inherit;cursor:pointer;opacity:0;padding:2px 6px;font-size:10px;position:absolute;top:4px;right:4px}.mdk-agent-code:hover .mdk-agent-code__copy,.mdk-agent-code__copy:focus-visible{opacity:1}.mdk-agent-markdown pre code.hljs .hljs-keyword,.mdk-agent-markdown pre code.hljs .hljs-built_in,.mdk-agent-markdown pre code.hljs .hljs-section{color:var(--mdk-agent-accent)}.mdk-agent-markdown pre code.hljs .hljs-string,.mdk-agent-markdown pre code.hljs .hljs-symbol{color:var(--mdk-agent-success)}.mdk-agent-markdown pre code.hljs .hljs-attr,.mdk-agent-markdown pre code.hljs .hljs-attribute{color:color-mix(in srgb, var(--mdk-agent-accent) 60%, var(--mdk-agent-text))}.mdk-agent-markdown pre code.hljs .hljs-number,.mdk-agent-markdown pre code.hljs .hljs-literal,.mdk-agent-markdown pre code.hljs .hljs-bullet{color:color-mix(in srgb, var(--mdk-agent-success) 55%, var(--mdk-agent-text))}.mdk-agent-markdown pre code.hljs .hljs-variable,.mdk-agent-markdown pre code.hljs .hljs-template-variable,.mdk-agent-markdown pre code.hljs .hljs-meta{color:var(--mdk-agent-text)}.mdk-agent-markdown pre code.hljs .hljs-comment,.mdk-agent-markdown pre code.hljs .hljs-quote{color:var(--mdk-agent-text-muted);font-style:italic}.mdk-agent-no-tools{color:var(--mdk-agent-text-muted);letter-spacing:0;text-transform:none;opacity:.75;align-items:center;gap:4px;margin-left:8px;display:inline-flex}.mdk-agent-no-tools svg{flex:none}.mdk-agent-leaked{border:1px dashed color-mix(in srgb, var(--mdk-agent-accent) 55%, transparent);border-radius:var(--mdk-agent-radius);padding:10px 12px}.mdk-agent-leaked__title{color:var(--mdk-agent-accent);margin:0 0 4px}.mdk-agent-leaked__body{color:var(--mdk-agent-text-muted);margin:0}.mdk-agent-leaked__tool{color:var(--mdk-agent-text)}.mdk-agent-approval{border:1px dashed color-mix(in srgb, var(--mdk-agent-accent) 60%, transparent);border-radius:var(--mdk-agent-radius);background:color-mix(in srgb, var(--mdk-agent-accent) 6%, var(--mdk-agent-surface));padding:12px 14px 14px}.mdk-agent-approval__title{color:var(--mdk-agent-accent);letter-spacing:.08em;text-transform:uppercase;margin:0 0 12px;font-size:10px;font-weight:600}.mdk-agent-approval__details{margin:0 0 14px}.mdk-agent-approval__row{align-items:baseline;gap:12px;display:flex}.mdk-agent-approval__row+.mdk-agent-approval__row{margin-top:6px}.mdk-agent-approval__label{width:90px;color:var(--mdk-agent-text-muted);text-transform:capitalize;flex:none;font-size:11px}.mdk-agent-approval__value{overflow-wrap:anywhere;min-width:0;margin:0}.mdk-agent-approval__actions{justify-content:flex-end;gap:8px;display:flex}.mdk-agent-approval__actions button:first-child{border:1px solid var(--mdk-agent-border-strong);color:var(--mdk-agent-text);background:0 0}.mdk-agent-approval__actions button:first-child:hover:not(:disabled){border-color:var(--mdk-agent-danger);color:var(--mdk-agent-danger)}.mdk-agent-composer{border-top:1px solid var(--mdk-agent-border);flex:none;align-items:flex-end;gap:8px;padding:12px;display:flex}.mdk-agent-composer__input{border:1px solid var(--mdk-agent-border-strong);border-radius:var(--mdk-agent-radius);min-width:0;color:var(--mdk-agent-text);resize:none;background:0 0;flex:auto;padding:10px 12px;font-family:inherit;font-size:13px;line-height:19px}.mdk-agent-composer__input::placeholder{color:var(--mdk-agent-text-muted)}.mdk-agent-composer__input:focus-visible{border-color:var(--mdk-agent-accent);outline:none}.mdk-agent-composer__input:disabled{cursor:not-allowed;opacity:.5}.mdk-agent-composer__send{flex:none;width:40px;height:40px;padding:0}.mdk-agent-conversations{flex-direction:column;flex:auto;min-height:0;display:flex}.mdk-agent-conversations__scroll{overscroll-behavior:contain;flex-direction:column;flex:auto;min-height:0;display:flex;overflow-y:auto}.mdk-agent-conversations__empty{color:var(--mdk-agent-text-muted);text-align:center;margin:auto 0}.mdk-agent-conversations__row{border-bottom:1px solid var(--mdk-agent-border);align-items:center;gap:12px;padding:12px 16px;display:flex}.mdk-agent-conversations__row:hover{background:var(--mdk-agent-surface-raised)}.mdk-agent-conversations__row--active{background:var(--mdk-agent-surface-raised);box-shadow:inset 2px 0 0 var(--mdk-agent-accent)}.mdk-agent-conversations__open{min-width:0;color:inherit;font:inherit;text-align:left;cursor:pointer;background:0 0;border:none;flex-direction:column;flex:auto;gap:2px;padding:0;display:flex}.mdk-agent-conversations__title{white-space:nowrap;text-overflow:ellipsis;color:var(--mdk-color-white,#fff);overflow:hidden}.mdk-agent-conversations__meta{color:var(--mdk-agent-text-muted);font-size:11px}.mdk-agent-conversations__badge{color:var(--mdk-agent-text-muted);letter-spacing:.08em;text-transform:uppercase;flex:none;align-items:center;gap:6px;font-size:10px;display:flex}.mdk-agent-conversations__badge:before{content:"";background:currentColor;width:6px;height:6px}.mdk-agent-conversations__badge--running{color:var(--mdk-agent-accent)}.mdk-agent-conversations__delete{width:24px;height:24px;color:var(--mdk-agent-text-muted);cursor:pointer;opacity:0;background:0 0;border:none;flex:none;justify-content:center;align-items:center;padding:0;display:flex}.mdk-agent-conversations__delete:hover:not(:disabled){color:var(--mdk-agent-danger)}.mdk-agent-conversations__delete:disabled{cursor:not-allowed}.mdk-agent-conversations__row:hover .mdk-agent-conversations__delete,.mdk-agent-conversations__delete:focus-visible{opacity:1}.mdk-agent-conversations__confirm{flex:none;align-items:center;gap:6px;display:flex}.mdk-agent-conversations__confirm button{border:1px solid var(--mdk-agent-border-strong);color:var(--mdk-agent-text);font:inherit;cursor:pointer;background:0 0;padding:3px 8px;font-size:11px}.mdk-agent-conversations__confirm .mdk-agent-conversations__confirm-yes{border-color:color-mix(in srgb, var(--mdk-agent-danger) 60%, transparent);color:var(--mdk-agent-danger)}.mdk-agent-conversations__footer{border-top:1px solid var(--mdk-agent-border);flex:none;padding:12px}.mdk-agent-conversations__footer button{border:1px solid var(--mdk-agent-border-strong);color:var(--mdk-agent-text);background:0 0}.mdk-agent-conversations__footer button:hover:not(:disabled){border-color:var(--mdk-agent-accent);background:var(--mdk-agent-surface-raised);color:var(--mdk-color-white,#fff)}}@layer app;