@wildix/wilma-copilot-headless 0.1.0 → 0.1.2

package/dist/hooks/CopilotSessionStreamSlot.d.ts

@@ -0,0 +1,18 @@
+import { type ReactElement, type ReactNode } from 'react';
+import type { CopilotSessionStreamHandle } from '@wildix/wilma-copilot-core';
+import { type UseCopilotSessionStreamOptions } from './useCopilotSessionStream';
+export interface CopilotSessionStreamSlotProps extends UseCopilotSessionStreamOptions {
+    children: (handle: CopilotSessionStreamHandle) => ReactNode;
+}
+/**
+ * Runs `useCopilotSessionStream` for one included session and hands the result to
+ * `children`.
+ *
+ * Hooks cannot be called in a loop, and an "included" session list is exactly that — an
+ * array whose length changes at runtime. Rendering one of these per included session id
+ * gives each its own stream and its own component identity, so React (not a manual map
+ * of subscriptions) is what starts and tears them down as sessions are included and
+ * removed.
+ */
+export declare function CopilotSessionStreamSlot({ children, ...options }: CopilotSessionStreamSlotProps): ReactElement;
+//# sourceMappingURL=CopilotSessionStreamSlot.d.ts.map

package/dist/hooks/CopilotSessionStreamSlot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CopilotSessionStreamSlot.d.ts","sourceRoot":"","sources":["../../src/hooks/CopilotSessionStreamSlot.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,YAAY,EAAE,KAAK,SAAS,EAAC,MAAM,OAAO,CAAC;AAEjF,OAAO,KAAK,EAAC,0BAA0B,EAAC,MAAM,4BAA4B,CAAC;AAE3E,OAAO,EAA0B,KAAK,8BAA8B,EAAC,MAAM,2BAA2B,CAAC;AAEvG,MAAM,WAAW,6BAA8B,SAAQ,8BAA8B;IACnF,QAAQ,EAAE,CAAC,MAAM,EAAE,0BAA0B,KAAK,SAAS,CAAC;CAC7D;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,EAAC,QAAQ,EAAE,GAAG,OAAO,EAAC,EAAE,6BAA6B,GAAG,YAAY,CAO5G"}

package/dist/hooks/CopilotSessionStreamSlot.js

@@ -0,0 +1,20 @@
+import { createElement, Fragment } from 'react';
+import { useCopilotSessionStream } from './useCopilotSessionStream';
+/**
+ * Runs `useCopilotSessionStream` for one included session and hands the result to
+ * `children`.
+ *
+ * Hooks cannot be called in a loop, and an "included" session list is exactly that — an
+ * array whose length changes at runtime. Rendering one of these per included session id
+ * gives each its own stream and its own component identity, so React (not a manual map
+ * of subscriptions) is what starts and tears them down as sessions are included and
+ * removed.
+ */
+export function CopilotSessionStreamSlot({ children, ...options }) {
+    const handle = useCopilotSessionStream(options);
+    // `createElement` rather than JSX: this package ships `.ts` sources with no JSX
+    // transform configured, and a bare fragment is the only wrapper a "returns whatever
+    // `children` produced" component needs.
+    return createElement(Fragment, null, children(handle));
+}
+//# sourceMappingURL=CopilotSessionStreamSlot.js.map

package/dist/hooks/CopilotSessionStreamSlot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CopilotSessionStreamSlot.js","sourceRoot":"","sources":["../../src/hooks/CopilotSessionStreamSlot.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAE,QAAQ,EAAoC,MAAM,OAAO,CAAC;AAIjF,OAAO,EAAC,uBAAuB,EAAsC,MAAM,2BAA2B,CAAC;AAMvG;;;;;;;;;GASG;AACH,MAAM,UAAU,wBAAwB,CAAC,EAAC,QAAQ,EAAE,GAAG,OAAO,EAAgC;IAC5F,MAAM,MAAM,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAEhD,gFAAgF;IAChF,oFAAoF;IACpF,wCAAwC;IACxC,OAAO,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,10 @@
+export * from './CopilotSessionStreamSlot';
+export * from './shared';
+export * from './useCopilotActions';
+export * from './useCopilotAlerts';
+export * from './useCopilotAsk';
+export * from './useCopilotPanelView';
+export * from './useCopilotRecentSessions';
+export * from './useCopilotRelationship';
+export * from './useCopilotSessionStream';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,10 @@
+export * from './CopilotSessionStreamSlot';
+export * from './shared';
+export * from './useCopilotActions';
+export * from './useCopilotAlerts';
+export * from './useCopilotAsk';
+export * from './useCopilotPanelView';
+export * from './useCopilotRecentSessions';
+export * from './useCopilotRelationship';
+export * from './useCopilotSessionStream';
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC"}

package/dist/hooks/shared.d.ts

@@ -0,0 +1,8 @@
+import type { CopilotContextLookup, WilmaCopilotSessionsClient } from '@wildix/wilma-copilot-sessions-client';
+export declare const PAGE_LIMIT = 1000;
+export interface CopilotDependencies {
+    copilotClient: WilmaCopilotSessionsClient;
+    onError?: (error: unknown) => void;
+}
+export declare function lookupKey(lookup: CopilotContextLookup | undefined): string;
+//# sourceMappingURL=shared.d.ts.map

package/dist/hooks/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/hooks/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,oBAAoB,EAAE,0BAA0B,EAAC,MAAM,uCAAuC,CAAC;AAE5G,eAAO,MAAM,UAAU,OAAO,CAAC;AAE/B,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,0BAA0B,CAAC;IAC1C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,oBAAoB,GAAG,SAAS,GAAG,MAAM,CAE1E"}

package/dist/hooks/shared.js

@@ -0,0 +1,5 @@
+export const PAGE_LIMIT = 1000;
+export function lookupKey(lookup) {
+    return JSON.stringify(lookup ?? {});
+}
+//# sourceMappingURL=shared.js.map

package/dist/hooks/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/hooks/shared.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC;AAO/B,MAAM,UAAU,SAAS,CAAC,MAAwC;IAChE,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;AACtC,CAAC"}

package/dist/hooks/useCopilotActions.d.ts

@@ -0,0 +1,36 @@
+import { type CopilotSmartActionEntry } from '@wildix/wilma-copilot-core';
+import { type CopilotDependencies } from './shared';
+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;
+}
+/** Playbook progress the agent made by hand, as `Act` takes it. */
+export interface CopilotPlaybookProgress {
+    /** Steps the agent ticked. Append-only server-side, so re-sending an id is a no-op. */
+    stepIds?: readonly string[];
+    /** Marks the whole playbook complete. Honoured only while the view reports `canMarkComplete`. */
+    complete?: boolean;
+}
+export interface CopilotActionsHandle {
+    /** Keys of the smart actions this client already invoked, for the muted styling. */
+    usedKeys: ReadonlySet<string>;
+    /**
+     * Runs a suggestion against `sessionId`, or against `overrideSessionId` when it came
+     * from another session. A panel showing included sessions offers their actions too,
+     * and an action belongs to the session that suggested it, not to the one in focus.
+     */
+    runSmartAction: (entry: CopilotSmartActionEntry, overrideSessionId?: string) => Promise<void>;
+    searchKnowledge: (questionId: string, question?: string) => Promise<void>;
+    markPlaybookProgress: (assetId: string, progress: CopilotPlaybookProgress) => Promise<void>;
+}
+/**
+ * The three members of `CopilotClientAction`. All are accepted into the session mailbox, so the
+ * outcome arrives as an `action` event and — for a playbook tick or a knowledge answer — as the
+ * asset re-emitted under its own id, rather than from the call itself.
+ */
+export declare function useCopilotActions({ copilotClient, sessionId, onOpenUrl, onError, }: UseCopilotActionsOptions): CopilotActionsHandle;
+//# sourceMappingURL=useCopilotActions.d.ts.map

package/dist/hooks/useCopilotActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCopilotActions.d.ts","sourceRoot":"","sources":["../../src/hooks/useCopilotActions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAW,KAAK,uBAAuB,EAAqB,MAAM,4BAA4B,CAAC;AAGtG,OAAO,EAAC,KAAK,mBAAmB,EAAC,MAAM,UAAU,CAAC;AAElD,MAAM,WAAW,wBAAyB,SAAQ,mBAAmB;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,KAAK,IAAI,CAAC;CAC1D;AAED,mEAAmE;AACnE,MAAM,WAAW,uBAAuB;IACtC,uFAAuF;IACvF,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,iGAAiG;IACjG,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,oFAAoF;IACpF,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9B;;;;OAIG;IACH,cAAc,EAAE,CAAC,KAAK,EAAE,uBAAuB,EAAE,iBAAiB,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9F,eAAe,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,oBAAoB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7F;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,aAAa,EACb,SAAS,EACT,SAAS,EACT,OAAO,GACR,EAAE,wBAAwB,GAAG,oBAAoB,CAmEjD"}

package/dist/hooks/useCopilotActions.js

@@ -0,0 +1,64 @@
+import { useCallback, useState } from 'react';
+import { asRecord, getSmartActionType } from '@wildix/wilma-copilot-core';
+import { ActCommand } from '@wildix/wilma-copilot-sessions-client';
+import {} from './shared';
+/**
+ * The three members of `CopilotClientAction`. All are accepted into the session mailbox, so the
+ * outcome arrives as an `action` event and — for a playbook tick or a knowledge answer — as the
+ * asset re-emitted under its own id, rather than from the call itself.
+ */
+export function useCopilotActions({ copilotClient, sessionId, onOpenUrl, onError, }) {
+    const [usedKeys, setUsedKeys] = useState(new Set());
+    const runSmartAction = useCallback(async (entry, overrideSessionId) => {
+        const type = getSmartActionType(entry.action);
+        const target = overrideSessionId ?? sessionId;
+        if (!type || !target)
+            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: target,
+                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]);
+    const markPlaybookProgress = useCallback(async (assetId, { stepIds, complete }) => {
+        if (!sessionId)
+            return;
+        try {
+            await copilotClient.send(new ActCommand({
+                sessionId,
+                action: {
+                    playbook: {
+                        assetId,
+                        ...(stepIds ? { stepIds: [...stepIds] } : {}),
+                        ...(complete === undefined ? {} : { complete }),
+                    },
+                },
+            }));
+        }
+        catch (cause) {
+            onError?.(cause);
+        }
+    }, [copilotClient, onError, sessionId]);
+    return { usedKeys, runSmartAction, searchKnowledge, markPlaybookProgress };
+}
+//# sourceMappingURL=useCopilotActions.js.map

package/dist/hooks/useCopilotActions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCopilotActions.js","sourceRoot":"","sources":["../../src/hooks/useCopilotActions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAE,QAAQ,EAAC,MAAM,OAAO,CAAC;AAE5C,OAAO,EAAC,QAAQ,EAAgC,kBAAkB,EAAC,MAAM,4BAA4B,CAAC;AACtG,OAAO,EAAC,UAAU,EAAC,MAAM,uCAAuC,CAAC;AAEjE,OAAO,EAA0B,MAAM,UAAU,CAAC;AAgClD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAChC,aAAa,EACb,SAAS,EACT,SAAS,EACT,OAAO,GACkB;IACzB,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAsB,IAAI,GAAG,EAAE,CAAC,CAAC;IAEzE,MAAM,cAAc,GAAG,WAAW,CAChC,KAAK,EAAE,KAA8B,EAAE,iBAA0B,EAAE,EAAE;QACnE,MAAM,IAAI,GAAG,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,iBAAiB,IAAI,SAAS,CAAC;QAC9C,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QAC7B,WAAW,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QAE1D,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,EAAC,GAAG,EAAE,YAAY,EAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC3D,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG;gBAAE,SAAS,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,KAAK,CAAC,CAAC;QAC/E,CAAC;QAED,IAAI,CAAC;YACH,MAAM,aAAa,CAAC,IAAI,CACtB,IAAI,UAAU,CAAC;gBACb,SAAS,EAAE,MAAM;gBACjB,MAAM,EAAE,EAAC,WAAW,EAAE,EAAC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,MAAM,EAAC,EAAC;aACxE,CAAC,CACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,EACD,CAAC,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAC/C,CAAC;IAEF,MAAM,eAAe,GAAG,WAAW,CACjC,KAAK,EAAE,UAAkB,EAAE,QAAiB,EAAE,EAAE;QAC9C,IAAI,CAAC,SAAS;YAAE,OAAO;QAEvB,IAAI,CAAC;YACH,MAAM,aAAa,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,EAAC,SAAS,EAAE,MAAM,EAAE,EAAC,eAAe,EAAE,EAAC,UAAU,EAAE,QAAQ,EAAC,EAAC,EAAC,CAAC,CAAC,CAAC;QAC3G,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,EACD,CAAC,aAAa,EAAE,OAAO,EAAE,SAAS,CAAC,CACpC,CAAC;IAEF,MAAM,oBAAoB,GAAG,WAAW,CACtC,KAAK,EAAE,OAAe,EAAE,EAAC,OAAO,EAAE,QAAQ,EAA0B,EAAE,EAAE;QACtE,IAAI,CAAC,SAAS;YAAE,OAAO;QAEvB,IAAI,CAAC;YACH,MAAM,aAAa,CAAC,IAAI,CACtB,IAAI,UAAU,CAAC;gBACb,SAAS;gBACT,MAAM,EAAE;oBACN,QAAQ,EAAE;wBACR,OAAO;wBACP,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;wBAC3C,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAC,QAAQ,EAAC,CAAC;qBAC9C;iBACF;aACF,CAAC,CACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,EACD,CAAC,aAAa,EAAE,OAAO,EAAE,SAAS,CAAC,CACpC,CAAC;IAEF,OAAO,EAAC,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,oBAAoB,EAAC,CAAC;AAC3E,CAAC"}

package/dist/hooks/useCopilotAlerts.d.ts

@@ -0,0 +1,24 @@
+import { type CopilotAlert, type CopilotUiState } from '@wildix/wilma-copilot-core';
+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;
+//# sourceMappingURL=useCopilotAlerts.d.ts.map

package/dist/hooks/useCopilotAlerts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCopilotAlerts.d.ts","sourceRoot":"","sources":["../../src/hooks/useCopilotAlerts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAuB,KAAK,YAAY,EAAE,KAAK,cAAc,EAAC,MAAM,4BAA4B,CAAC;AAExG,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,cAAc,CAAC;IACtB,6FAA6F;IAC7F,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uEAAuE;IACvE,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,IAAI,CAAC;CAC5C;AAED,MAAM,WAAW,mBAAmB;IAClC,gFAAgF;IAChF,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,EAAC,KAAK,EAAE,SAAiB,EAAE,OAAO,EAAC,EAAE,uBAAuB,GAAG,mBAAmB,CAsBlH"}

package/dist/hooks/useCopilotAlerts.js

@@ -0,0 +1,32 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { collectCopilotAlerts } from '@wildix/wilma-copilot-core';
+/**
+ * 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([]), []) };
+}
+//# sourceMappingURL=useCopilotAlerts.js.map

package/dist/hooks/useCopilotAlerts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCopilotAlerts.js","sourceRoot":"","sources":["../../src/hooks/useCopilotAlerts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAC,MAAM,OAAO,CAAC;AAExE,OAAO,EAAC,oBAAoB,EAAyC,MAAM,4BAA4B,CAAC;AAgBxG;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAC,KAAK,EAAE,SAAS,GAAG,KAAK,EAAE,OAAO,EAA0B;IAC3F,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAiB,EAAE,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IACnE,MAAM,OAAO,GAAG,MAAM,CAAc,IAAI,GAAG,EAAE,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAEjC,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QACxE,KAAK,MAAM,KAAK,IAAI,KAAK;YAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAE1D,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YACxB,UAAU,CAAC,OAAO,GAAG,CAAC,SAAS,CAAC;YAEhC,OAAO;QACT,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC/B,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC;QAC/C,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IAEjC,OAAO,EAAC,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAC,CAAC;AAC/D,CAAC"}

package/dist/hooks/useCopilotAsk.d.ts

@@ -0,0 +1,11 @@
+import { type WilmaAssistantClient } from '@wildix/wilma-assistant-client';
+import { type CopilotDependencies } from './shared';
+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;
+};
+//# sourceMappingURL=useCopilotAsk.d.ts.map

package/dist/hooks/useCopilotAsk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCopilotAsk.d.ts","sourceRoot":"","sources":["../../src/hooks/useCopilotAsk.ts"],"names":[],"mappings":"AAEA,OAAO,EAAsB,KAAK,oBAAoB,EAAC,MAAM,gCAAgC,CAAC;AAG9F,OAAO,EAAC,KAAK,mBAAmB,EAAC,MAAM,UAAU,CAAC;AAElD,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC/D,eAAe,EAAE,oBAAoB,CAAC;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,aAAa,CAAC,EAAC,eAAe,EAAE,aAAa,EAAE,gBAAgB,EAAE,OAAO,EAAC,EAAE,oBAAoB,GAAG;IAChH,GAAG,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACvD,QAAQ,EAAE,OAAO,CAAC;CACnB,CA8BA"}

package/dist/hooks/useCopilotAsk.js

@@ -0,0 +1,31 @@
+import { useCallback, useState } from 'react';
+import { StartSessionCommand } from '@wildix/wilma-assistant-client';
+import { AskCommand } from '@wildix/wilma-copilot-sessions-client';
+import {} from './shared';
+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 };
+}
+//# sourceMappingURL=useCopilotAsk.js.map

package/dist/hooks/useCopilotAsk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCopilotAsk.js","sourceRoot":"","sources":["../../src/hooks/useCopilotAsk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAE,QAAQ,EAAC,MAAM,OAAO,CAAC;AAE5C,OAAO,EAAC,mBAAmB,EAA4B,MAAM,gCAAgC,CAAC;AAC9F,OAAO,EAAC,UAAU,EAAC,MAAM,uCAAuC,CAAC;AAEjE,OAAO,EAA0B,MAAM,UAAU,CAAC;AAOlD,MAAM,UAAU,aAAa,CAAC,EAAC,eAAe,EAAE,aAAa,EAAE,gBAAgB,EAAE,OAAO,EAAuB;IAI7G,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,WAAW,CACrB,KAAK,EAAE,QAAgB,EAAE,EAAE;QACzB,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC,OAAO,IAAI,CAAC,gBAAgB;YAAE,OAAO,SAAS,CAAC;QACpD,WAAW,CAAC,IAAI,CAAC,CAAC;QAElB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,IAAI,CACxC,IAAI,mBAAmB,CAAC;gBACtB,OAAO;gBACP,UAAU,EAAE,QAAQ;gBACpB,MAAM,EAAE,sBAAsB,gBAAgB,EAAE;aACjD,CAAC,CACH,CAAC;YACF,MAAM,aAAa,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,EAAC,SAAS,EAAE,gBAAgB,EAAE,cAAc,EAAE,OAAO,CAAC,SAAS,EAAC,CAAC,CAAC,CAAC;YAE3G,OAAO,OAAO,CAAC,SAAS,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;YACjB,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,WAAW,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,EACD,CAAC,eAAe,EAAE,aAAa,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAC5D,CAAC;IAEF,OAAO,EAAC,GAAG,EAAE,QAAQ,EAAC,CAAC;AACzB,CAAC"}

package/dist/hooks/useCopilotPanelView.d.ts

@@ -0,0 +1,48 @@
+export type CopilotPanelView = 
+/** The session the panel opened on: guidance, smart actions and the composer. */
+{
+    kind: 'live';
+} | {
+    kind: 'history';
+}
+/** An earlier session from the history, read-only. */
+ | {
+    kind: 'session';
+    sessionId: string;
+};
+export interface CopilotPanelViewHandle {
+    view: CopilotPanelView;
+    /** The session the current view is about, if it is about one. */
+    sessionId: string | undefined;
+    /** Whether transcript lines are interleaved in the live timeline. */
+    showTranscript: boolean;
+    toggleTranscript: () => void;
+    setShowTranscript: (value: boolean) => void;
+    openHistory: () => void;
+    openSession: (sessionId: string) => void;
+    /** Returns to the view that opened this one, and to the live view from the root. */
+    back: () => void;
+    goLive: () => void;
+    /**
+     * Past sessions folded into the live timeline instead of opened on their own, oldest
+     * first. History offers this as "include" beside "switch to", for pulling an earlier
+     * conversation's guidance into view without losing the current one.
+     */
+    includedSessionIds: string[];
+    isIncluded: (sessionId: string) => boolean;
+    includeSession: (sessionId: string) => void;
+    removeIncludedSession: (sessionId: string) => void;
+}
+/**
+ * Which view the panel is showing, as a stack.
+ *
+ * A stack rather than a flag because the views nest: history opens a session, and every
+ * back step has to land where the reader came from rather than dropping them at the live
+ * session. Transcript lines are toggled inline on the timeline instead of opening a
+ * separate view.
+ *
+ * `initialView` opens the panel on that view with the live one beneath it, so a deep
+ * link into the history still has somewhere to go back to.
+ */
+export declare function useCopilotPanelView(initialView?: CopilotPanelView): CopilotPanelViewHandle;
+//# sourceMappingURL=useCopilotPanelView.d.ts.map

package/dist/hooks/useCopilotPanelView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCopilotPanelView.d.ts","sourceRoot":"","sources":["../../src/hooks/useCopilotPanelView.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB;AAC1B,iFAAiF;AAC/E;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,GACd;IAAC,IAAI,EAAE,SAAS,CAAA;CAAC;AACnB,sDAAsD;GACpD;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAC,CAAC;AAEzC,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,gBAAgB,CAAC;IACvB,iEAAiE;IACjE,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,qEAAqE;IACrE,cAAc,EAAE,OAAO,CAAC;IACxB,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,iBAAiB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC5C,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,oFAAoF;IACpF,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB;;;;OAIG;IACH,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3C,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,qBAAqB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACpD;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,CAAC,EAAE,gBAAgB,GAAG,sBAAsB,CAqC1F"}

package/dist/hooks/useCopilotPanelView.js

@@ -0,0 +1,41 @@
+import { useCallback, useEffect, useMemo, useState } from 'react';
+const LIVE_VIEW = { kind: 'live' };
+/**
+ * Which view the panel is showing, as a stack.
+ *
+ * A stack rather than a flag because the views nest: history opens a session, and every
+ * back step has to land where the reader came from rather than dropping them at the live
+ * session. Transcript lines are toggled inline on the timeline instead of opening a
+ * separate view.
+ *
+ * `initialView` opens the panel on that view with the live one beneath it, so a deep
+ * link into the history still has somewhere to go back to.
+ */
+export function useCopilotPanelView(initialView) {
+    const [stack, setStack] = useState(() => initialView && initialView.kind !== 'live' ? [LIVE_VIEW, initialView] : [LIVE_VIEW]);
+    const [showTranscript, setShowTranscript] = useState(false);
+    const [includedSessionIds, setIncludedSessionIds] = useState([]);
+    const view = stack[stack.length - 1] ?? LIVE_VIEW;
+    const sessionId = view.kind === 'session' ? view.sessionId : undefined;
+    const push = useCallback((next) => setStack((current) => [...current, next]), []);
+    useEffect(() => {
+        setShowTranscript(false);
+    }, [sessionId, view.kind]);
+    const includedSet = useMemo(() => new Set(includedSessionIds), [includedSessionIds]);
+    return {
+        view,
+        sessionId,
+        showTranscript,
+        toggleTranscript: useCallback(() => setShowTranscript((current) => !current), []),
+        setShowTranscript,
+        openHistory: useCallback(() => push({ kind: 'history' }), [push]),
+        openSession: useCallback((id) => push({ kind: 'session', sessionId: id }), [push]),
+        back: useCallback(() => setStack((current) => (current.length > 1 ? current.slice(0, -1) : current)), []),
+        goLive: useCallback(() => setStack([LIVE_VIEW]), []),
+        includedSessionIds,
+        isIncluded: useCallback((id) => includedSet.has(id), [includedSet]),
+        includeSession: useCallback((id) => setIncludedSessionIds((current) => (current.includes(id) ? current : [...current, id])), []),
+        removeIncludedSession: useCallback((id) => setIncludedSessionIds((current) => current.filter((entry) => entry !== id)), []),
+    };
+}
+//# sourceMappingURL=useCopilotPanelView.js.map

package/dist/hooks/useCopilotPanelView.js.map

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

package/dist/hooks/useCopilotRecentSessions.d.ts

@@ -0,0 +1,12 @@
+import { type CopilotSessionSummary } from '@wildix/wilma-copilot-sessions-client';
+import { type CopilotDependencies } from './shared';
+export declare function useCopilotRecentSessions(options: CopilotDependencies & {
+    enabled?: boolean;
+    limit?: number;
+}): {
+    sessions: CopilotSessionSummary[];
+    isLoading: boolean;
+    error?: Error;
+    refresh: () => void;
+};
+//# sourceMappingURL=useCopilotRecentSessions.d.ts.map

package/dist/hooks/useCopilotRecentSessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCopilotRecentSessions.d.ts","sourceRoot":"","sources":["../../src/hooks/useCopilotRecentSessions.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,KAAK,qBAAqB,EAAsB,MAAM,uCAAuC,CAAC;AAEtG,OAAO,EAAC,KAAK,mBAAmB,EAAC,MAAM,UAAU,CAAC;AAElD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,mBAAmB,GAAG;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAC,GAAG;IAC5G,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAgCA"}

package/dist/hooks/useCopilotRecentSessions.js

@@ -0,0 +1,38 @@
+import { useEffect, useState } from 'react';
+import { sortSessionsRecentFirst } from '@wildix/wilma-copilot-core';
+import { ListSessionsCommand } from '@wildix/wilma-copilot-sessions-client';
+import {} from './shared';
+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=useCopilotRecentSessions.js.map

package/dist/hooks/useCopilotRecentSessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCopilotRecentSessions.js","sourceRoot":"","sources":["../../src/hooks/useCopilotRecentSessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAE,QAAQ,EAAC,MAAM,OAAO,CAAC;AAE1C,OAAO,EAAC,uBAAuB,EAAC,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAA6B,mBAAmB,EAAC,MAAM,uCAAuC,CAAC;AAEtG,OAAO,EAA0B,MAAM,UAAU,CAAC;AAElD,MAAM,UAAU,wBAAwB,CAAC,OAAkE;IAMzG,MAAM,EAAC,aAAa,EAAE,OAAO,GAAG,IAAI,EAAE,KAAK,GAAG,EAAE,EAAE,OAAO,EAAC,GAAG,OAAO,CAAC;IACrE,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAA0B,EAAE,CAAC,CAAC;IACtE,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,EAAS,CAAC;IAC5C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEtC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,KAAK,aAAa;aACf,IAAI,CAAC,IAAI,mBAAmB,CAAC,EAAC,KAAK,EAAC,CAAC,CAAC;aACtC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACf,IAAI,CAAC,SAAS;gBAAE,WAAW,CAAC,uBAAuB,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;QAC9E,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACxB,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,QAAQ,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBACpE,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;YACnB,CAAC;QACH,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,CAAC,SAAS;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;QAEL,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IAEpD,OAAO,EAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,EAAC,CAAC;AACrF,CAAC"}

package/dist/hooks/useCopilotRelationship.d.ts

@@ -0,0 +1,10 @@
+import { type CopilotRelationshipHandle } from '@wildix/wilma-copilot-core';
+import { type CopilotContextLookup } from '@wildix/wilma-copilot-sessions-client';
+import { type CopilotDependencies } from './shared';
+export interface UseCopilotRelationshipOptions extends CopilotDependencies {
+    lookup?: CopilotContextLookup;
+    enabled?: boolean;
+    sessionsLimit?: number;
+}
+export declare function useCopilotRelationship({ copilotClient, lookup, enabled, sessionsLimit, onError, }: UseCopilotRelationshipOptions): CopilotRelationshipHandle;
+//# sourceMappingURL=useCopilotRelationship.d.ts.map

package/dist/hooks/useCopilotRelationship.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCopilotRelationship.d.ts","sourceRoot":"","sources":["../../src/hooks/useCopilotRelationship.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,KAAK,yBAAyB,EAA0B,MAAM,4BAA4B,CAAC;AACnG,OAAO,EACL,KAAK,oBAAoB,EAK1B,MAAM,uCAAuC,CAAC;AAE/C,OAAO,EAAC,KAAK,mBAAmB,EAAY,MAAM,UAAU,CAAC;AAE7D,MAAM,WAAW,6BAA8B,SAAQ,mBAAmB;IACxE,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,sBAAsB,CAAC,EACrC,aAAa,EACb,MAAM,EACN,OAAc,EACd,aAAkB,EAClB,OAAO,GACR,EAAE,6BAA6B,GAAG,yBAAyB,CA4E3D"}

package/dist/hooks/useCopilotRelationship.js

@@ -0,0 +1,74 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { sortSessionsRecentFirst } from '@wildix/wilma-copilot-core';
+import { EnrichCommand, ListRelationshipSessionsCommand, OpenCommand, } from '@wildix/wilma-copilot-sessions-client';
+import { lookupKey } from './shared';
+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 };
+}
+//# sourceMappingURL=useCopilotRelationship.js.map

package/dist/hooks/useCopilotRelationship.js.map

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

package/dist/hooks/useCopilotSessionStream.d.ts

@@ -0,0 +1,12 @@
+import { type CopilotSessionStreamHandle } from '@wildix/wilma-copilot-core';
+import { type CopilotSessionEvent } from '@wildix/wilma-copilot-sessions-client';
+import { type CopilotDependencies } from './shared';
+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;
+//# sourceMappingURL=useCopilotSessionStream.d.ts.map

package/dist/hooks/useCopilotSessionStream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCopilotSessionStream.d.ts","sourceRoot":"","sources":["../../src/hooks/useCopilotSessionStream.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,0BAA0B,EAIhC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAC,KAAK,mBAAmB,EAA0B,MAAM,uCAAuC,CAAC;AAExG,OAAO,EAAC,KAAK,mBAAmB,EAAa,MAAM,UAAU,CAAC;AAE9D,MAAM,MAAM,kBAAkB,GAAG,CAC/B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,WAAW,KAChB,aAAa,CAAC,mBAAmB,CAAC,CAAC;AAExC,MAAM,WAAW,8BAA+B,SAAQ,mBAAmB;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;CAC1D;AAED,wBAAgB,uBAAuB,CAAC,EACtC,aAAa,EACb,SAAS,EACT,IAAW,EACX,YAAY,EACZ,cAAc,EACd,OAAO,GACR,EAAE,8BAA8B,GAAG,0BAA0B,CA6D7D"}