@wildix/wilma-copilot-headless 0.1.0

package/dist/hooks.d.ts

@@ -0,0 +1,80 @@
+import { type WilmaAssistantClient } from '@wildix/wilma-assistant-client';
+import { type CopilotAlert, type CopilotRelationshipHandle, type CopilotSessionStreamHandle, type CopilotSmartActionEntry, type CopilotUiState } from '@wildix/wilma-copilot-core';
+import { type CopilotContextLookup, type CopilotSessionEvent, type CopilotSessionSummary, type WilmaCopilotSessionsClient } from '@wildix/wilma-copilot-sessions-client';
+export interface CopilotDependencies {
+    copilotClient: WilmaCopilotSessionsClient;
+    onError?: (error: unknown) => void;
+}
+export interface UseCopilotRelationshipOptions extends CopilotDependencies {
+    lookup?: CopilotContextLookup;
+    enabled?: boolean;
+    sessionsLimit?: number;
+}
+export declare function useCopilotRelationship({ copilotClient, lookup, enabled, sessionsLimit, onError, }: UseCopilotRelationshipOptions): CopilotRelationshipHandle;
+export type CopilotEventStream = (sessionId: string, startIndex: number, signal: AbortSignal) => AsyncIterable<CopilotSessionEvent>;
+export interface UseCopilotSessionStreamOptions extends CopilotDependencies {
+    sessionId?: string;
+    live?: boolean;
+    streamEvents?: CopilotEventStream;
+    onRelationship?: (sessionId: string | undefined) => void;
+}
+export declare function useCopilotSessionStream({ copilotClient, sessionId, live, streamEvents, onRelationship, onError, }: UseCopilotSessionStreamOptions): CopilotSessionStreamHandle;
+export interface UseCopilotAskOptions extends CopilotDependencies {
+    assistantClient: WilmaAssistantClient;
+    copilotSessionId?: string;
+}
+export declare function useCopilotAsk({ assistantClient, copilotClient, copilotSessionId, onError }: UseCopilotAskOptions): {
+    ask: (question: string) => Promise<string | undefined>;
+    isAsking: boolean;
+};
+export interface UseCopilotActionsOptions extends CopilotDependencies {
+    sessionId?: string;
+    /**
+     * Opens the URL of an `openUrl` smart action. Navigation belongs to the host, so the
+     * SDK reports the invocation and leaves the window to the app.
+     */
+    onOpenUrl?: (url: string, openInNewTab: boolean) => void;
+}
+export interface CopilotActionsHandle {
+    /** Keys of the smart actions this client already invoked, for the muted styling. */
+    usedKeys: ReadonlySet<string>;
+    runSmartAction: (entry: CopilotSmartActionEntry) => Promise<void>;
+    searchKnowledge: (questionId: string, question?: string) => Promise<void>;
+}
+/**
+ * The two members of `CopilotClientAction`. Both are accepted into the session mailbox,
+ * so the outcome arrives as an `action` event rather than from the call itself.
+ */
+export declare function useCopilotActions({ copilotClient, sessionId, onOpenUrl, onError, }: UseCopilotActionsOptions): CopilotActionsHandle;
+export interface UseCopilotAlertsOptions {
+    state: CopilotUiState;
+    /** True while recorded events are replaying. Those are history, and history never alerts. */
+    isLoading?: boolean;
+    /** Called once per batch of alerts that arrived live, oldest first. */
+    onAlert?: (alerts: CopilotAlert[]) => void;
+}
+export interface CopilotAlertsHandle {
+    /** Alerts seen since the last `clear`, oldest first. Drives an unread badge. */
+    unseen: CopilotAlert[];
+    clear: () => void;
+}
+/**
+ * Watches a session for the few things worth interrupting for (`collectCopilotAlerts`).
+ *
+ * The point of the hook is the baseline. A session is rehydrated by replaying its
+ * recorded events, so a panel opened next to a call that has been running for ten
+ * minutes sees every earlier detection arrive at once — and firing a notification for
+ * each would be both wrong and unbearable. Everything present when the stream settles
+ * is therefore marked seen without alerting, and only what arrives afterwards is news.
+ */
+export declare function useCopilotAlerts({ state, isLoading, onAlert }: UseCopilotAlertsOptions): CopilotAlertsHandle;
+export declare function useCopilotRecentSessions(options: CopilotDependencies & {
+    enabled?: boolean;
+    limit?: number;
+}): {
+    sessions: CopilotSessionSummary[];
+    isLoading: boolean;
+    error?: Error;
+    refresh: () => void;
+};
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

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

package/dist/hooks.js

@@ -0,0 +1,257 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { StartSessionCommand } from '@wildix/wilma-assistant-client';
+import { asRecord, collectCopilotAlerts, getCopilotEventIndex, getSmartActionType, initialCopilotUiState, reduceCopilotEvent, sortSessionsRecentFirst, } from '@wildix/wilma-copilot-core';
+import { ActCommand, AskCommand, EnrichCommand, GetSessionEventsCommand, ListRelationshipSessionsCommand, ListSessionsCommand, OpenCommand, } from '@wildix/wilma-copilot-sessions-client';
+const PAGE_LIMIT = 1000;
+function lookupKey(lookup) {
+    return JSON.stringify(lookup ?? {});
+}
+export function useCopilotRelationship({ copilotClient, lookup, enabled = true, sessionsLimit = 50, onError, }) {
+    const [relationshipId, setRelationshipId] = useState();
+    const [defaultSessionId, setDefaultSessionId] = useState();
+    const [sessions, setSessions] = useState([]);
+    const [isLoading, setIsLoading] = useState(enabled);
+    const [error, setError] = useState();
+    const [attempt, setAttempt] = useState(0);
+    const relationshipRef = useRef(undefined);
+    const openedLookupRef = useRef(undefined);
+    relationshipRef.current = relationshipId;
+    const loadSessions = useCallback(async (id, signal) => {
+        const result = await copilotClient.send(new ListRelationshipSessionsCommand({ relationshipId: id, limit: sessionsLimit }), signal ? { abortSignal: signal } : undefined);
+        if (!signal?.aborted)
+            setSessions(sortSessionsRecentFirst(result.sessions ?? []));
+    }, [copilotClient, sessionsLimit]);
+    const refresh = useCallback(() => {
+        if (relationshipRef.current)
+            void loadSessions(relationshipRef.current).catch(onError);
+    }, [loadSessions, onError]);
+    const retry = useCallback(() => {
+        setError(undefined);
+        setAttempt((value) => value + 1);
+    }, []);
+    useEffect(() => {
+        if (!enabled)
+            return;
+        const abort = new AbortController();
+        setIsLoading(true);
+        void (async () => {
+            try {
+                const result = await copilotClient.send(new OpenCommand({ lookup }), { abortSignal: abort.signal });
+                if (abort.signal.aborted)
+                    return;
+                openedLookupRef.current = lookupKey(lookup);
+                setRelationshipId(result.relationshipId);
+                setDefaultSessionId(result.session.id);
+                await loadSessions(result.relationshipId, abort.signal);
+                setError(undefined);
+            }
+            catch (cause) {
+                if (!abort.signal.aborted) {
+                    const next = cause instanceof Error ? cause : new Error(String(cause));
+                    setError(next);
+                    onError?.(cause);
+                }
+            }
+            finally {
+                if (!abort.signal.aborted)
+                    setIsLoading(false);
+            }
+        })();
+        return () => abort.abort();
+    }, [attempt, copilotClient, enabled, loadSessions, onError]);
+    const key = lookupKey(lookup);
+    useEffect(() => {
+        const currentId = relationshipRef.current;
+        if (!enabled || !currentId || openedLookupRef.current === undefined || openedLookupRef.current === key)
+            return;
+        openedLookupRef.current = key;
+        void copilotClient
+            .send(new EnrichCommand({ relationshipId: currentId, lookup: lookup }))
+            .then((result) => {
+            setRelationshipId(result.relationshipId);
+            setSessions(sortSessionsRecentFirst(result.related ?? []));
+        })
+            .catch(onError);
+    }, [copilotClient, enabled, key, lookup, onError]);
+    return { relationshipId, sessions, defaultSessionId, isLoading, error, retry, refresh };
+}
+export function useCopilotSessionStream({ copilotClient, sessionId, live = true, streamEvents, onRelationship, onError, }) {
+    const [state, setState] = useState(initialCopilotUiState);
+    const [isLoading, setIsLoading] = useState(Boolean(sessionId));
+    const [error, setError] = useState();
+    useEffect(() => {
+        if (!sessionId) {
+            setState(initialCopilotUiState);
+            setIsLoading(false);
+            return;
+        }
+        const abort = new AbortController();
+        let nextIndex = 0;
+        setState(initialCopilotUiState);
+        setIsLoading(true);
+        setError(undefined);
+        const apply = (event) => {
+            nextIndex = Math.max(nextIndex, getCopilotEventIndex(event) + 1);
+            if (event.relationship)
+                onRelationship?.(event.relationship.sessionId);
+            setState((current) => reduceCopilotEvent(current, event));
+        };
+        const replay = async (startIndex = 0) => {
+            const output = await copilotClient.send(new GetSessionEventsCommand({ sessionId, startIndex, limit: PAGE_LIMIT }), {
+                abortSignal: abort.signal,
+            });
+            for (const event of output.events ?? []) {
+                apply(event);
+            }
+            if (output.nextStartIndex != null && !abort.signal.aborted) {
+                await replay(output.nextStartIndex);
+            }
+        };
+        void (async () => {
+            try {
+                await replay();
+                setIsLoading(false);
+                if (live && streamEvents && !abort.signal.aborted) {
+                    for await (const event of streamEvents(sessionId, nextIndex, abort.signal))
+                        apply(event);
+                }
+            }
+            catch (cause) {
+                if (!abort.signal.aborted) {
+                    setError(cause instanceof Error ? cause : new Error(String(cause)));
+                    onError?.(cause);
+                }
+            }
+            finally {
+                if (!abort.signal.aborted)
+                    setIsLoading(false);
+            }
+        })();
+        return () => abort.abort();
+    }, [copilotClient, live, onError, onRelationship, sessionId, streamEvents]);
+    return { state, isLoading, error };
+}
+export function useCopilotAsk({ assistantClient, copilotClient, copilotSessionId, onError }) {
+    const [isAsking, setIsAsking] = useState(false);
+    const ask = useCallback(async (question) => {
+        const message = question.trim();
+        if (!message || !copilotSessionId)
+            return undefined;
+        setIsAsking(true);
+        try {
+            const started = await assistantClient.send(new StartSessionCommand({
+                message,
+                visibility: 'hidden',
+                target: `copilot://sessions/${copilotSessionId}`,
+            }));
+            await copilotClient.send(new AskCommand({ sessionId: copilotSessionId, wilmaSessionId: started.sessionId }));
+            return started.sessionId;
+        }
+        catch (cause) {
+            onError?.(cause);
+            throw cause;
+        }
+        finally {
+            setIsAsking(false);
+        }
+    }, [assistantClient, copilotClient, copilotSessionId, onError]);
+    return { ask, isAsking };
+}
+/**
+ * The two members of `CopilotClientAction`. Both are accepted into the session mailbox,
+ * so the outcome arrives as an `action` event rather than from the call itself.
+ */
+export function useCopilotActions({ copilotClient, sessionId, onOpenUrl, onError, }) {
+    const [usedKeys, setUsedKeys] = useState(new Set());
+    const runSmartAction = useCallback(async (entry) => {
+        const type = getSmartActionType(entry.action);
+        if (!type || !sessionId)
+            return;
+        setUsedKeys((current) => new Set(current).add(entry.key));
+        if (type === 'openUrl') {
+            const { url, openInNewTab } = asRecord(entry.action.openUrl);
+            if (typeof url === 'string' && url)
+                onOpenUrl?.(url, openInNewTab !== false);
+        }
+        try {
+            await copilotClient.send(new ActCommand({ sessionId, action: { smartAction: { assetId: entry.assetId, actionId: entry.itemId } } }));
+        }
+        catch (cause) {
+            onError?.(cause);
+        }
+    }, [copilotClient, onError, onOpenUrl, sessionId]);
+    const searchKnowledge = useCallback(async (questionId, question) => {
+        if (!sessionId)
+            return;
+        try {
+            await copilotClient.send(new ActCommand({ sessionId, action: { knowledgeSearch: { questionId, question } } }));
+        }
+        catch (cause) {
+            onError?.(cause);
+        }
+    }, [copilotClient, onError, sessionId]);
+    return { usedKeys, runSmartAction, searchKnowledge };
+}
+/**
+ * Watches a session for the few things worth interrupting for (`collectCopilotAlerts`).
+ *
+ * The point of the hook is the baseline. A session is rehydrated by replaying its
+ * recorded events, so a panel opened next to a call that has been running for ten
+ * minutes sees every earlier detection arrive at once — and firing a notification for
+ * each would be both wrong and unbearable. Everything present when the stream settles
+ * is therefore marked seen without alerting, and only what arrives afterwards is news.
+ */
+export function useCopilotAlerts({ state, isLoading = false, onAlert }) {
+    const [unseen, setUnseen] = useState([]);
+    const alerts = useMemo(() => collectCopilotAlerts(state), [state]);
+    const seenRef = useRef(new Set());
+    const settledRef = useRef(false);
+    useEffect(() => {
+        const fresh = alerts.filter((alert) => !seenRef.current.has(alert.key));
+        for (const alert of fresh)
+            seenRef.current.add(alert.key);
+        if (!settledRef.current) {
+            settledRef.current = !isLoading;
+            return;
+        }
+        if (fresh.length === 0)
+            return;
+        setUnseen((current) => [...current, ...fresh]);
+        onAlert?.(fresh);
+    }, [alerts, isLoading, onAlert]);
+    return { unseen, clear: useCallback(() => setUnseen([]), []) };
+}
+export function useCopilotRecentSessions(options) {
+    const { copilotClient, enabled = true, limit = 20, onError } = options;
+    const [sessions, setSessions] = useState([]);
+    const [isLoading, setIsLoading] = useState(enabled);
+    const [error, setError] = useState();
+    const [nonce, setNonce] = useState(0);
+    useEffect(() => {
+        if (!enabled)
+            return;
+        let cancelled = false;
+        setIsLoading(true);
+        void copilotClient
+            .send(new ListSessionsCommand({ limit }))
+            .then((result) => {
+            if (!cancelled)
+                setSessions(sortSessionsRecentFirst(result.sessions ?? []));
+        })
+            .catch((cause) => {
+            if (!cancelled) {
+                setError(cause instanceof Error ? cause : new Error(String(cause)));
+                onError?.(cause);
+            }
+        })
+            .finally(() => {
+            if (!cancelled)
+                setIsLoading(false);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [copilotClient, enabled, limit, nonce, onError]);
+    return { sessions, isLoading, error, refresh: () => setNonce((value) => value + 1) };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './hooks';
+export * from '@wildix/wilma-copilot-core';
+//# 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,cAAc,SAAS,CAAC;AACxB,cAAc,4BAA4B,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from './hooks';
+export * from '@wildix/wilma-copilot-core';
+//# 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,cAAc,SAAS,CAAC;AACxB,cAAc,4BAA4B,CAAC"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@wildix/wilma-copilot-headless",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "React hooks for Wilma Copilot relationships, session streams and asks with injected clients.",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "react-native": "./src/index.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "pnpm run clean && tsc --project tsconfig.build.json",
+    "clean": "rimraf --glob './dist' '*.tsbuildinfo'",
+    "lint": "eslint src --config ../wilma-core/.eslintrc.cjs --max-warnings 0",
+    "typecheck": "tsc --project tsconfig.build.json --noEmit",
+    "test": "vitest run --passWithNoTests"
+  },
+  "peerDependencies": {
+    "@wildix/wilma-assistant-client": ">=0.0.9 <1",
+    "@wildix/wilma-copilot-core": ">=0.1 <1",
+    "@wildix/wilma-copilot-sessions-client": ">=1.0.9 <2",
+    "react": "^19"
+  },
+  "devDependencies": {
+    "@types/react": "^19.1.9",
+    "@wildix/eslint-config-style-guide": "^1.2.2",
+    "@wildix/wilma-assistant-client": "0.0.9",
+    "@wildix/wilma-copilot-core": "workspace:*",
+    "@wildix/wilma-copilot-sessions-client": "1.0.10",
+    "eslint": "^8",
+    "react": "^19",
+    "rimraf": "^5.0.5",
+    "typescript": "^5.9.2",
+    "vitest": "^4.0.4"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "react-native": "./src/index.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/hooks.ts

@@ -0,0 +1,406 @@
+import {useCallback, useEffect, useMemo, useRef, useState} from 'react';
+
+import {StartSessionCommand, type WilmaAssistantClient} from '@wildix/wilma-assistant-client';
+import {
+  asRecord,
+  collectCopilotAlerts,
+  type CopilotAlert,
+  type CopilotRelationshipHandle,
+  type CopilotSessionStreamHandle,
+  type CopilotSmartActionEntry,
+  type CopilotUiState,
+  getCopilotEventIndex,
+  getSmartActionType,
+  initialCopilotUiState,
+  reduceCopilotEvent,
+  sortSessionsRecentFirst,
+} from '@wildix/wilma-copilot-core';
+import {
+  ActCommand,
+  AskCommand,
+  type CopilotContextLookup,
+  type CopilotSessionEvent,
+  type CopilotSessionSummary,
+  EnrichCommand,
+  GetSessionEventsCommand,
+  ListRelationshipSessionsCommand,
+  ListSessionsCommand,
+  OpenCommand,
+  type WilmaCopilotSessionsClient,
+} from '@wildix/wilma-copilot-sessions-client';
+
+const PAGE_LIMIT = 1000;
+
+export interface CopilotDependencies {
+  copilotClient: WilmaCopilotSessionsClient;
+  onError?: (error: unknown) => void;
+}
+
+function lookupKey(lookup: CopilotContextLookup | undefined): string {
+  return JSON.stringify(lookup ?? {});
+}
+
+export interface UseCopilotRelationshipOptions extends CopilotDependencies {
+  lookup?: CopilotContextLookup;
+  enabled?: boolean;
+  sessionsLimit?: number;
+}
+
+export function useCopilotRelationship({
+  copilotClient,
+  lookup,
+  enabled = true,
+  sessionsLimit = 50,
+  onError,
+}: UseCopilotRelationshipOptions): CopilotRelationshipHandle {
+  const [relationshipId, setRelationshipId] = useState<string>();
+  const [defaultSessionId, setDefaultSessionId] = useState<string>();
+  const [sessions, setSessions] = useState<CopilotSessionSummary[]>([]);
+  const [isLoading, setIsLoading] = useState(enabled);
+  const [error, setError] = useState<Error>();
+  const [attempt, setAttempt] = useState(0);
+  const relationshipRef = useRef<string | undefined>(undefined);
+  const openedLookupRef = useRef<string | undefined>(undefined);
+
+  relationshipRef.current = relationshipId;
+
+  const loadSessions = useCallback(
+    async (id: string, signal?: AbortSignal) => {
+      const result = await copilotClient.send(
+        new ListRelationshipSessionsCommand({relationshipId: id, limit: sessionsLimit}),
+        signal ? {abortSignal: signal} : undefined,
+      );
+      if (!signal?.aborted) setSessions(sortSessionsRecentFirst(result.sessions ?? []));
+    },
+    [copilotClient, sessionsLimit],
+  );
+
+  const refresh = useCallback(() => {
+    if (relationshipRef.current) void loadSessions(relationshipRef.current).catch(onError);
+  }, [loadSessions, onError]);
+
+  const retry = useCallback(() => {
+    setError(undefined);
+    setAttempt((value) => value + 1);
+  }, []);
+
+  useEffect(() => {
+    if (!enabled) return;
+    const abort = new AbortController();
+    setIsLoading(true);
+
+    void (async () => {
+      try {
+        const result = await copilotClient.send(new OpenCommand({lookup}), {abortSignal: abort.signal});
+        if (abort.signal.aborted) return;
+        openedLookupRef.current = lookupKey(lookup);
+        setRelationshipId(result.relationshipId);
+        setDefaultSessionId(result.session.id);
+        await loadSessions(result.relationshipId, abort.signal);
+        setError(undefined);
+      } catch (cause) {
+        if (!abort.signal.aborted) {
+          const next = cause instanceof Error ? cause : new Error(String(cause));
+          setError(next);
+          onError?.(cause);
+        }
+      } finally {
+        if (!abort.signal.aborted) setIsLoading(false);
+      }
+    })();
+
+    return () => abort.abort();
+  }, [attempt, copilotClient, enabled, loadSessions, onError]);
+
+  const key = lookupKey(lookup);
+  useEffect(() => {
+    const currentId = relationshipRef.current;
+    if (!enabled || !currentId || openedLookupRef.current === undefined || openedLookupRef.current === key) return;
+    openedLookupRef.current = key;
+
+    void copilotClient
+      .send(new EnrichCommand({relationshipId: currentId, lookup: lookup as CopilotContextLookup}))
+      .then((result) => {
+        setRelationshipId(result.relationshipId);
+        setSessions(sortSessionsRecentFirst(result.related ?? []));
+      })
+      .catch(onError);
+  }, [copilotClient, enabled, key, lookup, onError]);
+
+  return {relationshipId, sessions, defaultSessionId, isLoading, error, retry, refresh};
+}
+
+export type CopilotEventStream = (
+  sessionId: string,
+  startIndex: number,
+  signal: AbortSignal,
+) => AsyncIterable<CopilotSessionEvent>;
+
+export interface UseCopilotSessionStreamOptions extends CopilotDependencies {
+  sessionId?: string;
+  live?: boolean;
+  streamEvents?: CopilotEventStream;
+  onRelationship?: (sessionId: string | undefined) => void;
+}
+
+export function useCopilotSessionStream({
+  copilotClient,
+  sessionId,
+  live = true,
+  streamEvents,
+  onRelationship,
+  onError,
+}: UseCopilotSessionStreamOptions): CopilotSessionStreamHandle {
+  const [state, setState] = useState(initialCopilotUiState);
+  const [isLoading, setIsLoading] = useState(Boolean(sessionId));
+  const [error, setError] = useState<Error>();
+
+  useEffect(() => {
+    if (!sessionId) {
+      setState(initialCopilotUiState);
+      setIsLoading(false);
+
+      return;
+    }
+
+    const abort = new AbortController();
+    let nextIndex = 0;
+    setState(initialCopilotUiState);
+    setIsLoading(true);
+    setError(undefined);
+
+    const apply = (event: CopilotSessionEvent) => {
+      nextIndex = Math.max(nextIndex, getCopilotEventIndex(event) + 1);
+      if (event.relationship) onRelationship?.(event.relationship.sessionId);
+      setState((current) => reduceCopilotEvent(current, event));
+    };
+
+    const replay = async (startIndex = 0): Promise<void> => {
+      const output = await copilotClient.send(new GetSessionEventsCommand({sessionId, startIndex, limit: PAGE_LIMIT}), {
+        abortSignal: abort.signal,
+      });
+
+      for (const event of output.events ?? []) {
+        apply(event);
+      }
+
+      if (output.nextStartIndex != null && !abort.signal.aborted) {
+        await replay(output.nextStartIndex);
+      }
+    };
+
+    void (async () => {
+      try {
+        await replay();
+        setIsLoading(false);
+
+        if (live && streamEvents && !abort.signal.aborted) {
+          for await (const event of streamEvents(sessionId, nextIndex, abort.signal)) apply(event);
+        }
+      } catch (cause) {
+        if (!abort.signal.aborted) {
+          setError(cause instanceof Error ? cause : new Error(String(cause)));
+          onError?.(cause);
+        }
+      } finally {
+        if (!abort.signal.aborted) setIsLoading(false);
+      }
+    })();
+
+    return () => abort.abort();
+  }, [copilotClient, live, onError, onRelationship, sessionId, streamEvents]);
+
+  return {state, isLoading, error};
+}
+
+export interface UseCopilotAskOptions extends CopilotDependencies {
+  assistantClient: WilmaAssistantClient;
+  copilotSessionId?: string;
+}
+
+export function useCopilotAsk({assistantClient, copilotClient, copilotSessionId, onError}: UseCopilotAskOptions): {
+  ask: (question: string) => Promise<string | undefined>;
+  isAsking: boolean;
+} {
+  const [isAsking, setIsAsking] = useState(false);
+  const ask = useCallback(
+    async (question: string) => {
+      const message = question.trim();
+      if (!message || !copilotSessionId) return undefined;
+      setIsAsking(true);
+
+      try {
+        const started = await assistantClient.send(
+          new StartSessionCommand({
+            message,
+            visibility: 'hidden',
+            target: `copilot://sessions/${copilotSessionId}`,
+          }),
+        );
+        await copilotClient.send(new AskCommand({sessionId: copilotSessionId, wilmaSessionId: started.sessionId}));
+
+        return started.sessionId;
+      } catch (cause) {
+        onError?.(cause);
+        throw cause;
+      } finally {
+        setIsAsking(false);
+      }
+    },
+    [assistantClient, copilotClient, copilotSessionId, onError],
+  );
+
+  return {ask, isAsking};
+}
+
+export interface UseCopilotActionsOptions extends CopilotDependencies {
+  sessionId?: string;
+  /**
+   * Opens the URL of an `openUrl` smart action. Navigation belongs to the host, so the
+   * SDK reports the invocation and leaves the window to the app.
+   */
+  onOpenUrl?: (url: string, openInNewTab: boolean) => void;
+}
+
+export interface CopilotActionsHandle {
+  /** Keys of the smart actions this client already invoked, for the muted styling. */
+  usedKeys: ReadonlySet<string>;
+  runSmartAction: (entry: CopilotSmartActionEntry) => Promise<void>;
+  searchKnowledge: (questionId: string, question?: string) => Promise<void>;
+}
+
+/**
+ * The two members of `CopilotClientAction`. Both are accepted into the session mailbox,
+ * so the outcome arrives as an `action` event rather than from the call itself.
+ */
+export function useCopilotActions({
+  copilotClient,
+  sessionId,
+  onOpenUrl,
+  onError,
+}: UseCopilotActionsOptions): CopilotActionsHandle {
+  const [usedKeys, setUsedKeys] = useState<ReadonlySet<string>>(new Set());
+
+  const runSmartAction = useCallback(
+    async (entry: CopilotSmartActionEntry) => {
+      const type = getSmartActionType(entry.action);
+      if (!type || !sessionId) return;
+      setUsedKeys((current) => new Set(current).add(entry.key));
+
+      if (type === 'openUrl') {
+        const {url, openInNewTab} = asRecord(entry.action.openUrl);
+        if (typeof url === 'string' && url) onOpenUrl?.(url, openInNewTab !== false);
+      }
+
+      try {
+        await copilotClient.send(
+          new ActCommand({sessionId, action: {smartAction: {assetId: entry.assetId, actionId: entry.itemId}}}),
+        );
+      } catch (cause) {
+        onError?.(cause);
+      }
+    },
+    [copilotClient, onError, onOpenUrl, sessionId],
+  );
+
+  const searchKnowledge = useCallback(
+    async (questionId: string, question?: string) => {
+      if (!sessionId) return;
+
+      try {
+        await copilotClient.send(new ActCommand({sessionId, action: {knowledgeSearch: {questionId, question}}}));
+      } catch (cause) {
+        onError?.(cause);
+      }
+    },
+    [copilotClient, onError, sessionId],
+  );
+
+  return {usedKeys, runSmartAction, searchKnowledge};
+}
+
+export interface UseCopilotAlertsOptions {
+  state: CopilotUiState;
+  /** True while recorded events are replaying. Those are history, and history never alerts. */
+  isLoading?: boolean;
+  /** Called once per batch of alerts that arrived live, oldest first. */
+  onAlert?: (alerts: CopilotAlert[]) => void;
+}
+
+export interface CopilotAlertsHandle {
+  /** Alerts seen since the last `clear`, oldest first. Drives an unread badge. */
+  unseen: CopilotAlert[];
+  clear: () => void;
+}
+
+/**
+ * Watches a session for the few things worth interrupting for (`collectCopilotAlerts`).
+ *
+ * The point of the hook is the baseline. A session is rehydrated by replaying its
+ * recorded events, so a panel opened next to a call that has been running for ten
+ * minutes sees every earlier detection arrive at once — and firing a notification for
+ * each would be both wrong and unbearable. Everything present when the stream settles
+ * is therefore marked seen without alerting, and only what arrives afterwards is news.
+ */
+export function useCopilotAlerts({state, isLoading = false, onAlert}: UseCopilotAlertsOptions): CopilotAlertsHandle {
+  const [unseen, setUnseen] = useState<CopilotAlert[]>([]);
+  const alerts = useMemo(() => collectCopilotAlerts(state), [state]);
+  const seenRef = useRef<Set<string>>(new Set());
+  const settledRef = useRef(false);
+
+  useEffect(() => {
+    const fresh = alerts.filter((alert) => !seenRef.current.has(alert.key));
+    for (const alert of fresh) seenRef.current.add(alert.key);
+
+    if (!settledRef.current) {
+      settledRef.current = !isLoading;
+
+      return;
+    }
+
+    if (fresh.length === 0) return;
+    setUnseen((current) => [...current, ...fresh]);
+    onAlert?.(fresh);
+  }, [alerts, isLoading, onAlert]);
+
+  return {unseen, clear: useCallback(() => setUnseen([]), [])};
+}
+
+export function useCopilotRecentSessions(options: CopilotDependencies & {enabled?: boolean; limit?: number}): {
+  sessions: CopilotSessionSummary[];
+  isLoading: boolean;
+  error?: Error;
+  refresh: () => void;
+} {
+  const {copilotClient, enabled = true, limit = 20, onError} = options;
+  const [sessions, setSessions] = useState<CopilotSessionSummary[]>([]);
+  const [isLoading, setIsLoading] = useState(enabled);
+  const [error, setError] = useState<Error>();
+  const [nonce, setNonce] = useState(0);
+
+  useEffect(() => {
+    if (!enabled) return;
+    let cancelled = false;
+    setIsLoading(true);
+    void copilotClient
+      .send(new ListSessionsCommand({limit}))
+      .then((result) => {
+        if (!cancelled) setSessions(sortSessionsRecentFirst(result.sessions ?? []));
+      })
+      .catch((cause: unknown) => {
+        if (!cancelled) {
+          setError(cause instanceof Error ? cause : new Error(String(cause)));
+          onError?.(cause);
+        }
+      })
+      .finally(() => {
+        if (!cancelled) setIsLoading(false);
+      });
+
+    return () => {
+      cancelled = true;
+    };
+  }, [copilotClient, enabled, limit, nonce, onError]);
+
+  return {sessions, isLoading, error, refresh: () => setNonce((value) => value + 1)};
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './hooks';
+export * from '@wildix/wilma-copilot-core';