@burdenoff/microfe-botmanor 2026.1110.2 → 2026.1110.3

package/dist/botlit/components/HandoffConfigPanel.js

@@ -0,0 +1,286 @@
+import { useTr as e } from "../../shared/hooks/useTr.js";
+import { Card as t, CardContent as n, CardDescription as r, CardHeader as i, CardTitle as a } from "./Card.js";
+import { Button as o } from "./Button.js";
+import { Input as s } from "./Input.js";
+import { Badge as c } from "./Badge.js";
+import "../hooks/index.js";
+import { useHandoffConfig as l, useUpsertHandoffConfig as u } from "../hooks/useHandoffs.js";
+import { BotmanorHandoffFallbackBehavior as d } from "../../generated/wspace-types.js";
+import { useEffect as f, useState as p } from "react";
+import { jsx as m, jsxs as h } from "react/jsx-runtime";
+// src/botlit/components/HandoffConfigPanel.tsx
+function g(e) {
+	return {
+		enabled: e?.enabled ?? !1,
+		explicitRequest: e?.explicitRequest ?? !0,
+		lowConfidence: e?.lowConfidence ?? !1,
+		lowConfidenceThreshold: String(e?.lowConfidenceThreshold ?? .3),
+		repeatedFailures: e?.repeatedFailures ?? !1,
+		repeatedFailuresConsecutive: String(e?.repeatedFailuresConsecutive ?? 3),
+		policyRefusal: e?.policyRefusal ?? !1,
+		customIntentRows: (e?.customIntents ?? []).map((e) => `${e.name}|${e.pattern}|${e.isRegex ? "regex" : "text"}`).join("\n"),
+		targetUserIds: (e?.targetUserIds ?? []).join(", "),
+		targetRole: e?.targetRole ?? "",
+		notifyInApp: e?.notifyInApp ?? !0,
+		notifyEmail: e?.notifyEmail ?? !1,
+		notifyPush: e?.notifyPush ?? !1,
+		fallbackBehavior: e?.fallbackBehavior ?? d.Continue,
+		handoffMessage: e?.handoffMessage ?? ""
+	};
+}
+function _(e, t, n, r) {
+	let i = Number(e);
+	return Number.isFinite(i) ? Math.min(Math.max(i, n), r) : t;
+}
+function v(e) {
+	return {
+		enabled: e.enabled,
+		explicitRequest: e.explicitRequest,
+		lowConfidence: e.lowConfidence,
+		lowConfidenceThreshold: _(e.lowConfidenceThreshold, .3, 0, 1),
+		repeatedFailures: e.repeatedFailures,
+		repeatedFailuresConsecutive: Math.trunc(_(e.repeatedFailuresConsecutive, 3, 2, 10)),
+		policyRefusal: e.policyRefusal,
+		customIntents: e.customIntentRows.split("\n").map((e) => e.trim()).filter(Boolean).map((e) => {
+			let [t = "", n = "", r = "text"] = e.split("|");
+			return {
+				name: t.trim(),
+				pattern: n.trim(),
+				isRegex: r.trim() === "regex"
+			};
+		}),
+		targetUserIds: e.targetUserIds.split(",").map((e) => e.trim()).filter(Boolean),
+		targetRole: e.targetRole.trim() || null,
+		notifyInApp: e.notifyInApp,
+		notifyEmail: e.notifyEmail,
+		notifyPush: e.notifyPush,
+		fallbackBehavior: e.fallbackBehavior,
+		handoffMessage: e.handoffMessage.trim() || null
+	};
+}
+var y = ({ agentId: d }) => {
+	let _ = e(), y = l(d), [b, x] = u(d), [S, C] = p(() => g(y.data)), [w, T] = p(null);
+	f(() => {
+		y.data && C(g(y.data));
+	}, [y.data]);
+	let E = (e) => C((t) => ({
+		...t,
+		...e
+	})), D = async () => {
+		T(null);
+		try {
+			await b(v(S));
+		} catch (e) {
+			T(e instanceof Error ? e.message : "Failed to save handoff configuration");
+		}
+	};
+	return y.loading ? /* @__PURE__ */ m("p", {
+		role: "status",
+		children: _("botlit.handoffs.config.loading", "Loading handoff settings…")
+	}) : y.error ? /* @__PURE__ */ h("div", {
+		role: "alert",
+		children: [/* @__PURE__ */ m("p", { children: _("botlit.handoffs.config.error", "Handoff settings could not be loaded.") }), /* @__PURE__ */ m(o, {
+			variant: "outline",
+			onClick: () => void y.refetch(),
+			children: _("botlit.common.retry", "Retry")
+		})]
+	}) : /* @__PURE__ */ h(t, { children: [/* @__PURE__ */ h(i, { children: [/* @__PURE__ */ h(a, {
+		className: "flex items-center gap-2",
+		children: [_("botlit.handoffs.config.title", "Human Handoff"), S.enabled ? /* @__PURE__ */ m(c, {
+			variant: "success",
+			children: _("botlit.handoffs.config.enabled", "Enabled")
+		}) : /* @__PURE__ */ m(c, {
+			variant: "outline",
+			children: _("botlit.handoffs.config.disabled", "Disabled")
+		})]
+	}), /* @__PURE__ */ m(r, { children: _("botlit.handoffs.config.description", "Detect when a live conversation needs a human — an explicit request, a low-confidence reply, repeated failures, a policy-blocked response, or a custom intent — and hand it to your team automatically.") })] }), /* @__PURE__ */ h(n, {
+		className: "grid gap-6",
+		children: [
+			/* @__PURE__ */ h("label", {
+				className: "flex items-center gap-2 text-sm font-medium",
+				children: [/* @__PURE__ */ m("input", {
+					type: "checkbox",
+					checked: S.enabled,
+					onChange: (e) => E({ enabled: e.target.checked })
+				}), _("botlit.handoffs.config.enableLabel", "Enable automated human handoff for this agent")]
+			}),
+			/* @__PURE__ */ h("fieldset", {
+				className: "grid gap-3 rounded-card border border-border-seam p-4",
+				children: [
+					/* @__PURE__ */ m("legend", {
+						className: "px-1 text-sm font-semibold",
+						children: _("botlit.handoffs.config.triggers", "Triggers")
+					}),
+					/* @__PURE__ */ h("label", {
+						className: "flex items-center gap-2 text-sm",
+						children: [/* @__PURE__ */ m("input", {
+							type: "checkbox",
+							checked: S.explicitRequest,
+							onChange: (e) => E({ explicitRequest: e.target.checked })
+						}), _("botlit.handoffs.config.explicitRequest", "End user asks for a human (\"speak to a human\", \"talk to a person\", …)")]
+					}),
+					/* @__PURE__ */ h("div", {
+						className: "flex flex-wrap items-center gap-2 text-sm",
+						children: [/* @__PURE__ */ h("label", {
+							className: "flex items-center gap-2",
+							children: [/* @__PURE__ */ m("input", {
+								type: "checkbox",
+								checked: S.lowConfidence,
+								onChange: (e) => E({ lowConfidence: e.target.checked })
+							}), _("botlit.handoffs.config.lowConfidence", "Reply confidence below")]
+						}), /* @__PURE__ */ m(s, {
+							className: "w-24",
+							inputMode: "decimal",
+							value: S.lowConfidenceThreshold,
+							onChange: (e) => E({ lowConfidenceThreshold: e.target.value }),
+							"aria-label": _("botlit.handoffs.config.lowConfidenceThreshold", "Confidence threshold")
+						})]
+					}),
+					/* @__PURE__ */ h("div", {
+						className: "flex flex-wrap items-center gap-2 text-sm",
+						children: [/* @__PURE__ */ h("label", {
+							className: "flex items-center gap-2",
+							children: [/* @__PURE__ */ m("input", {
+								type: "checkbox",
+								checked: S.repeatedFailures,
+								onChange: (e) => E({ repeatedFailures: e.target.checked })
+							}), _("botlit.handoffs.config.repeatedFailures", "This many consecutive failed runs:")]
+						}), /* @__PURE__ */ m(s, {
+							className: "w-24",
+							inputMode: "numeric",
+							value: S.repeatedFailuresConsecutive,
+							onChange: (e) => E({ repeatedFailuresConsecutive: e.target.value }),
+							"aria-label": _("botlit.handoffs.config.repeatedFailuresCount", "Consecutive failure count")
+						})]
+					}),
+					/* @__PURE__ */ h("label", {
+						className: "flex items-center gap-2 text-sm",
+						children: [/* @__PURE__ */ m("input", {
+							type: "checkbox",
+							checked: S.policyRefusal,
+							onChange: (e) => E({ policyRefusal: e.target.checked })
+						}), _("botlit.handoffs.config.policyRefusal", "Reply was blocked by a workspace content policy")]
+					}),
+					/* @__PURE__ */ h("label", {
+						className: "grid gap-1 text-sm",
+						children: [_("botlit.handoffs.config.customIntents", "Custom intents (one per line: name|pattern|text or regex)"), /* @__PURE__ */ m("textarea", {
+							className: "min-h-20 rounded-md border border-border-default bg-bg-surface px-3 py-2 font-mono text-xs",
+							value: S.customIntentRows,
+							onChange: (e) => E({ customIntentRows: e.target.value }),
+							placeholder: "refund rage|refund me|text\ncancel order|cancel\\s+order|regex"
+						})]
+					})
+				]
+			}),
+			/* @__PURE__ */ h("fieldset", {
+				className: "grid gap-3 rounded-card border border-border-seam p-4",
+				children: [
+					/* @__PURE__ */ m("legend", {
+						className: "px-1 text-sm font-semibold",
+						children: _("botlit.handoffs.config.targets", "Who takes over")
+					}),
+					/* @__PURE__ */ h("label", {
+						className: "grid gap-1 text-sm",
+						children: [_("botlit.handoffs.config.targetUsers", "Specific users (auth user ids, comma-separated)"), /* @__PURE__ */ m(s, {
+							value: S.targetUserIds,
+							onChange: (e) => E({ targetUserIds: e.target.value }),
+							placeholder: "user-id-1, user-id-2"
+						})]
+					}),
+					/* @__PURE__ */ h("label", {
+						className: "grid gap-1 text-sm",
+						children: [_("botlit.handoffs.config.targetRole", "Or a workspace role (e.g. admin, owner)"), /* @__PURE__ */ m(s, {
+							value: S.targetRole,
+							onChange: (e) => E({ targetRole: e.target.value }),
+							placeholder: "admin"
+						})]
+					})
+				]
+			}),
+			/* @__PURE__ */ h("fieldset", {
+				className: "grid gap-3 rounded-card border border-border-seam p-4",
+				children: [/* @__PURE__ */ m("legend", {
+					className: "px-1 text-sm font-semibold",
+					children: _("botlit.handoffs.config.notify", "Notify")
+				}), [
+					[
+						"notifyInApp",
+						"botlit.handoffs.config.notifyInApp",
+						"In-app notification"
+					],
+					[
+						"notifyEmail",
+						"botlit.handoffs.config.notifyEmail",
+						"Email"
+					],
+					[
+						"notifyPush",
+						"botlit.handoffs.config.notifyPush",
+						"Push (mobile/desktop)"
+					]
+				].map(([e, t, n]) => /* @__PURE__ */ h("label", {
+					className: "flex items-center gap-2 text-sm",
+					children: [/* @__PURE__ */ m("input", {
+						type: "checkbox",
+						checked: S[e],
+						onChange: (t) => E({ [e]: t.target.checked })
+					}), _(t, n)]
+				}, e))]
+			}),
+			/* @__PURE__ */ h("fieldset", {
+				className: "grid gap-3 rounded-card border border-border-seam p-4",
+				children: [
+					/* @__PURE__ */ m("legend", {
+						className: "px-1 text-sm font-semibold",
+						children: _("botlit.handoffs.config.behaviour", "While a handoff is pending")
+					}),
+					/* @__PURE__ */ h("label", {
+						className: "grid gap-1 text-sm",
+						children: [_("botlit.handoffs.config.fallbackBehaviour", "Fallback behaviour"), /* @__PURE__ */ h("select", {
+							className: "h-10 rounded-md border border-border-default bg-bg-surface px-3",
+							value: S.fallbackBehavior,
+							onChange: (e) => E({ fallbackBehavior: e.target.value }),
+							children: [/* @__PURE__ */ m("option", {
+								value: "CONTINUE",
+								children: _("botlit.handoffs.config.fallbackContinue", "Bot keeps answering until a human accepts")
+							}), /* @__PURE__ */ m("option", {
+								value: "ABSTAIN",
+								children: _("botlit.handoffs.config.fallbackAbstain", "Bot stops replying as soon as a handoff opens")
+							})]
+						})]
+					}),
+					/* @__PURE__ */ h("label", {
+						className: "grid gap-1 text-sm",
+						children: [_("botlit.handoffs.config.handoffMessage", "Message shown to the end user when a handoff opens"), /* @__PURE__ */ m(s, {
+							value: S.handoffMessage,
+							onChange: (e) => E({ handoffMessage: e.target.value }),
+							placeholder: "You're being connected with a human…"
+						})]
+					})
+				]
+			}),
+			w ? /* @__PURE__ */ m("p", {
+				role: "alert",
+				className: "text-sm text-status-danger-text",
+				children: w
+			}) : null,
+			x.error && !w ? /* @__PURE__ */ m("p", {
+				role: "alert",
+				className: "text-sm text-status-danger-text",
+				children: x.error.message
+			}) : null,
+			x.data ? /* @__PURE__ */ m("p", {
+				className: "text-sm text-status-success-text",
+				children: _("botlit.handoffs.config.saved", "Handoff configuration saved.")
+			}) : null,
+			/* @__PURE__ */ m("div", { children: /* @__PURE__ */ m(o, {
+				onClick: () => void D(),
+				disabled: x.loading,
+				children: x.loading ? _("botlit.handoffs.config.saving", "Saving…") : _("botlit.handoffs.config.save", "Save handoff settings")
+			}) })
+		]
+	})] });
+};
+export { y as HandoffConfigPanel };
+
+//# sourceMappingURL=HandoffConfigPanel.js.map

package/dist/botlit/components/HandoffConfigPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HandoffConfigPanel.js","names":["draftFrom","config","intent","BotmanorHandoffFallbackBehavior","numberOr","parsed","value","min","max","fallback","buildInput","draft","line","name","pattern","kind","HandoffConfigPanel","t","useTr","useHandoffConfig","agentId","save","saveState","useUpsertHandoffConfig","setDraft","useState","saveError","setSaveError","patch","current","partial","onSave","error","Button","Card","CardHeader","CardTitle","Badge","CardDescription","CardContent","event","Input","key","labelKey","label"],"sources":["../../../src/botlit/components/HandoffConfigPanel.tsx"],"sourcesContent":["/**\n * Handoff Config Panel (BOFF-5813)\n * @module botlit/components\n *\n * Per-agent escalation configuration: which triggers hand a conversation to\n * a human, who gets notified, and how the bot behaves while a handoff is\n * pending. Saved through `upsertHandoffConfig` on wspace-botmanor-svc.\n */\nimport type { FC } from 'react';\nimport { useEffect, useState } from 'react';\nimport { useTr } from '../../shared/hooks/useTr';\nimport { Card, CardContent, CardDescription, CardHeader, CardTitle } from './Card';\nimport { Button } from './Button';\nimport { Input } from './Input';\nimport { Badge } from './Badge';\nimport { useHandoffConfig, useUpsertHandoffConfig } from '../hooks';\nimport type { HandoffConfigRecord } from '../hooks';\nimport {\n  BotmanorHandoffFallbackBehavior,\n  type BotmanorHandoffConfigInput,\n} from '../../generated/wspace-types';\n\ninterface DraftState {\n  enabled: boolean;\n  explicitRequest: boolean;\n  lowConfidence: boolean;\n  lowConfidenceThreshold: string;\n  repeatedFailures: boolean;\n  repeatedFailuresConsecutive: string;\n  policyRefusal: boolean;\n  customIntentRows: string; // \"name|pattern|regex\" per line\n  targetUserIds: string; // comma-separated\n  targetRole: string;\n  notifyInApp: boolean;\n  notifyEmail: boolean;\n  notifyPush: boolean;\n  fallbackBehavior: BotmanorHandoffFallbackBehavior;\n  handoffMessage: string;\n}\n\nfunction draftFrom(config: HandoffConfigRecord | null | undefined): DraftState {\n  return {\n    enabled: config?.enabled ?? false,\n    explicitRequest: config?.explicitRequest ?? true,\n    lowConfidence: config?.lowConfidence ?? false,\n    lowConfidenceThreshold: String(config?.lowConfidenceThreshold ?? 0.3),\n    repeatedFailures: config?.repeatedFailures ?? false,\n    repeatedFailuresConsecutive: String(config?.repeatedFailuresConsecutive ?? 3),\n    policyRefusal: config?.policyRefusal ?? false,\n    customIntentRows: (config?.customIntents ?? [])\n      .map((intent) => `${intent.name}|${intent.pattern}|${intent.isRegex ? 'regex' : 'text'}`)\n      .join('\\n'),\n    targetUserIds: (config?.targetUserIds ?? []).join(', '),\n    targetRole: config?.targetRole ?? '',\n    notifyInApp: config?.notifyInApp ?? true,\n    notifyEmail: config?.notifyEmail ?? false,\n    notifyPush: config?.notifyPush ?? false,\n    fallbackBehavior: config?.fallbackBehavior ?? BotmanorHandoffFallbackBehavior.Continue,\n    handoffMessage: config?.handoffMessage ?? '',\n  };\n}\n\n/** Parse a free-text numeric field, falling back and clamping to the bounds the backend enforces. */\nfunction numberOr(value: string, fallback: number, min: number, max: number): number {\n  const parsed = Number(value);\n  if (!Number.isFinite(parsed)) return fallback;\n  return Math.min(Math.max(parsed, min), max);\n}\n\nfunction buildInput(draft: DraftState): BotmanorHandoffConfigInput {\n  return {\n    enabled: draft.enabled,\n    explicitRequest: draft.explicitRequest,\n    lowConfidence: draft.lowConfidence,\n    lowConfidenceThreshold: numberOr(draft.lowConfidenceThreshold, 0.3, 0, 1),\n    repeatedFailures: draft.repeatedFailures,\n    repeatedFailuresConsecutive: Math.trunc(numberOr(draft.repeatedFailuresConsecutive, 3, 2, 10)),\n    policyRefusal: draft.policyRefusal,\n    customIntents: draft.customIntentRows\n      .split('\\n')\n      .map((line) => line.trim())\n      .filter(Boolean)\n      .map((line) => {\n        const [name = '', pattern = '', kind = 'text'] = line.split('|');\n        return { name: name.trim(), pattern: pattern.trim(), isRegex: kind.trim() === 'regex' };\n      }),\n    targetUserIds: draft.targetUserIds\n      .split(',')\n      .map((value) => value.trim())\n      .filter(Boolean),\n    targetRole: draft.targetRole.trim() || null,\n    notifyInApp: draft.notifyInApp,\n    notifyEmail: draft.notifyEmail,\n    notifyPush: draft.notifyPush,\n    fallbackBehavior: draft.fallbackBehavior,\n    handoffMessage: draft.handoffMessage.trim() || null,\n  };\n}\n\nexport const HandoffConfigPanel: FC<{ agentId: string }> = ({ agentId }) => {\n  const t = useTr();\n  const config = useHandoffConfig(agentId);\n  const [save, saveState] = useUpsertHandoffConfig(agentId);\n  const [draft, setDraft] = useState<DraftState>(() => draftFrom(config.data));\n  const [saveError, setSaveError] = useState<string | null>(null);\n\n  useEffect(() => {\n    if (config.data) setDraft(draftFrom(config.data));\n  }, [config.data]);\n\n  const patch = (partial: Partial<DraftState>) =>\n    setDraft((current) => ({ ...current, ...partial }));\n\n  const onSave = async () => {\n    setSaveError(null);\n    try {\n      await save(buildInput(draft));\n    } catch (error) {\n      setSaveError(error instanceof Error ? error.message : 'Failed to save handoff configuration');\n    }\n  };\n\n  if (config.loading)\n    return <p role=\"status\">{t('botlit.handoffs.config.loading', 'Loading handoff settings…')}</p>;\n  if (config.error) {\n    return (\n      <div role=\"alert\">\n        <p>{t('botlit.handoffs.config.error', 'Handoff settings could not be loaded.')}</p>\n        <Button variant=\"outline\" onClick={() => void config.refetch()}>\n          {t('botlit.common.retry', 'Retry')}\n        </Button>\n      </div>\n    );\n  }\n\n  return (\n    <Card>\n      <CardHeader>\n        <CardTitle className=\"flex items-center gap-2\">\n          {t('botlit.handoffs.config.title', 'Human Handoff')}\n          {draft.enabled ? (\n            <Badge variant=\"success\">{t('botlit.handoffs.config.enabled', 'Enabled')}</Badge>\n          ) : (\n            <Badge variant=\"outline\">{t('botlit.handoffs.config.disabled', 'Disabled')}</Badge>\n          )}\n        </CardTitle>\n        <CardDescription>\n          {t(\n            'botlit.handoffs.config.description',\n            'Detect when a live conversation needs a human — an explicit request, a low-confidence reply, repeated failures, a policy-blocked response, or a custom intent — and hand it to your team automatically.'\n          )}\n        </CardDescription>\n      </CardHeader>\n      <CardContent className=\"grid gap-6\">\n        <label className=\"flex items-center gap-2 text-sm font-medium\">\n          <input\n            type=\"checkbox\"\n            checked={draft.enabled}\n            onChange={(event) => patch({ enabled: event.target.checked })}\n          />\n          {t('botlit.handoffs.config.enableLabel', 'Enable automated human handoff for this agent')}\n        </label>\n\n        <fieldset className=\"grid gap-3 rounded-card border border-border-seam p-4\">\n          <legend className=\"px-1 text-sm font-semibold\">\n            {t('botlit.handoffs.config.triggers', 'Triggers')}\n          </legend>\n\n          <label className=\"flex items-center gap-2 text-sm\">\n            <input\n              type=\"checkbox\"\n              checked={draft.explicitRequest}\n              onChange={(event) => patch({ explicitRequest: event.target.checked })}\n            />\n            {t(\n              'botlit.handoffs.config.explicitRequest',\n              'End user asks for a human (\"speak to a human\", \"talk to a person\", …)'\n            )}\n          </label>\n\n          <div className=\"flex flex-wrap items-center gap-2 text-sm\">\n            <label className=\"flex items-center gap-2\">\n              <input\n                type=\"checkbox\"\n                checked={draft.lowConfidence}\n                onChange={(event) => patch({ lowConfidence: event.target.checked })}\n              />\n              {t('botlit.handoffs.config.lowConfidence', 'Reply confidence below')}\n            </label>\n            <Input\n              className=\"w-24\"\n              inputMode=\"decimal\"\n              value={draft.lowConfidenceThreshold}\n              onChange={(event) => patch({ lowConfidenceThreshold: event.target.value })}\n              aria-label={t(\n                'botlit.handoffs.config.lowConfidenceThreshold',\n                'Confidence threshold'\n              )}\n            />\n          </div>\n\n          <div className=\"flex flex-wrap items-center gap-2 text-sm\">\n            <label className=\"flex items-center gap-2\">\n              <input\n                type=\"checkbox\"\n                checked={draft.repeatedFailures}\n                onChange={(event) => patch({ repeatedFailures: event.target.checked })}\n              />\n              {t('botlit.handoffs.config.repeatedFailures', 'This many consecutive failed runs:')}\n            </label>\n            <Input\n              className=\"w-24\"\n              inputMode=\"numeric\"\n              value={draft.repeatedFailuresConsecutive}\n              onChange={(event) => patch({ repeatedFailuresConsecutive: event.target.value })}\n              aria-label={t(\n                'botlit.handoffs.config.repeatedFailuresCount',\n                'Consecutive failure count'\n              )}\n            />\n          </div>\n\n          <label className=\"flex items-center gap-2 text-sm\">\n            <input\n              type=\"checkbox\"\n              checked={draft.policyRefusal}\n              onChange={(event) => patch({ policyRefusal: event.target.checked })}\n            />\n            {t(\n              'botlit.handoffs.config.policyRefusal',\n              'Reply was blocked by a workspace content policy'\n            )}\n          </label>\n\n          <label className=\"grid gap-1 text-sm\">\n            {t(\n              'botlit.handoffs.config.customIntents',\n              'Custom intents (one per line: name|pattern|text or regex)'\n            )}\n            <textarea\n              className=\"min-h-20 rounded-md border border-border-default bg-bg-surface px-3 py-2 font-mono text-xs\"\n              value={draft.customIntentRows}\n              onChange={(event) => patch({ customIntentRows: event.target.value })}\n              placeholder={'refund rage|refund me|text\\ncancel order|cancel\\\\s+order|regex'}\n            />\n          </label>\n        </fieldset>\n\n        <fieldset className=\"grid gap-3 rounded-card border border-border-seam p-4\">\n          <legend className=\"px-1 text-sm font-semibold\">\n            {t('botlit.handoffs.config.targets', 'Who takes over')}\n          </legend>\n          <label className=\"grid gap-1 text-sm\">\n            {t(\n              'botlit.handoffs.config.targetUsers',\n              'Specific users (auth user ids, comma-separated)'\n            )}\n            <Input\n              value={draft.targetUserIds}\n              onChange={(event) => patch({ targetUserIds: event.target.value })}\n              placeholder=\"user-id-1, user-id-2\"\n            />\n          </label>\n          <label className=\"grid gap-1 text-sm\">\n            {t('botlit.handoffs.config.targetRole', 'Or a workspace role (e.g. admin, owner)')}\n            <Input\n              value={draft.targetRole}\n              onChange={(event) => patch({ targetRole: event.target.value })}\n              placeholder=\"admin\"\n            />\n          </label>\n        </fieldset>\n\n        <fieldset className=\"grid gap-3 rounded-card border border-border-seam p-4\">\n          <legend className=\"px-1 text-sm font-semibold\">\n            {t('botlit.handoffs.config.notify', 'Notify')}\n          </legend>\n          {(\n            [\n              ['notifyInApp', 'botlit.handoffs.config.notifyInApp', 'In-app notification'],\n              ['notifyEmail', 'botlit.handoffs.config.notifyEmail', 'Email'],\n              ['notifyPush', 'botlit.handoffs.config.notifyPush', 'Push (mobile/desktop)'],\n            ] as const\n          ).map(([key, labelKey, label]) => (\n            <label key={key} className=\"flex items-center gap-2 text-sm\">\n              <input\n                type=\"checkbox\"\n                checked={draft[key]}\n                onChange={(event) => patch({ [key]: event.target.checked })}\n              />\n              {t(labelKey, label)}\n            </label>\n          ))}\n        </fieldset>\n\n        <fieldset className=\"grid gap-3 rounded-card border border-border-seam p-4\">\n          <legend className=\"px-1 text-sm font-semibold\">\n            {t('botlit.handoffs.config.behaviour', 'While a handoff is pending')}\n          </legend>\n          <label className=\"grid gap-1 text-sm\">\n            {t('botlit.handoffs.config.fallbackBehaviour', 'Fallback behaviour')}\n            <select\n              className=\"h-10 rounded-md border border-border-default bg-bg-surface px-3\"\n              value={draft.fallbackBehavior}\n              onChange={(event) =>\n                patch({ fallbackBehavior: event.target.value as BotmanorHandoffFallbackBehavior })\n              }\n            >\n              <option value=\"CONTINUE\">\n                {t(\n                  'botlit.handoffs.config.fallbackContinue',\n                  'Bot keeps answering until a human accepts'\n                )}\n              </option>\n              <option value=\"ABSTAIN\">\n                {t(\n                  'botlit.handoffs.config.fallbackAbstain',\n                  'Bot stops replying as soon as a handoff opens'\n                )}\n              </option>\n            </select>\n          </label>\n          <label className=\"grid gap-1 text-sm\">\n            {t(\n              'botlit.handoffs.config.handoffMessage',\n              'Message shown to the end user when a handoff opens'\n            )}\n            <Input\n              value={draft.handoffMessage}\n              onChange={(event) => patch({ handoffMessage: event.target.value })}\n              placeholder=\"You're being connected with a human…\"\n            />\n          </label>\n        </fieldset>\n\n        {saveError ? (\n          <p role=\"alert\" className=\"text-sm text-status-danger-text\">\n            {saveError}\n          </p>\n        ) : null}\n        {saveState.error && !saveError ? (\n          <p role=\"alert\" className=\"text-sm text-status-danger-text\">\n            {saveState.error.message}\n          </p>\n        ) : null}\n        {saveState.data ? (\n          <p className=\"text-sm text-status-success-text\">\n            {t('botlit.handoffs.config.saved', 'Handoff configuration saved.')}\n          </p>\n        ) : null}\n\n        <div>\n          <Button onClick={() => void onSave()} disabled={saveState.loading}>\n            {saveState.loading\n              ? t('botlit.handoffs.config.saving', 'Saving…')\n              : t('botlit.handoffs.config.save', 'Save handoff settings')}\n          </Button>\n        </div>\n      </CardContent>\n    </Card>\n  );\n};\n"],"mappings":"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"}

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

@@ -33,3 +33,5 @@ export { useMyUserPlatformConnection, useInitiateSlackConnect, useCompleteSlackC
 export type { UserPlatformConnectionData, GlobalChannelData } from './useUserPlatformConnection';
 export { useAiPredictions, useSetAiPredictionStatus, useSupervisorConfig, useConfigureSupervisor, useRunSupervisorNow, useSupervisorRuns, aiOperationsKeys, predictionSeverity, predictionSubjectName, } from './useAiOperations';
 export type { AiPredictionRecord, AiPredictionsFilter, SupervisorConfigRecord, SupervisorRunRecord, RunSupervisorNowResult, } from './useAiOperations';
+export { useHandoffConfig, useHandoffQueue, useConversationHandoff, useUpsertHandoffConfig, useRequestHandoff, useAcceptHandoff, useReleaseHandoff, useResolveHandoff, useRejectHandoff, isActiveHandoff, ACTIVE_HANDOFF_STATUSES, } from './useHandoffs';
+export type { HandoffConfigRecord, HandoffCustomIntentRecord, HandoffEventRecord, HandoffRecord, } from './useHandoffs';

package/dist/botlit/hooks/index.js

@@ -15,4 +15,5 @@ import { storePackageDescription as ee, storePackageName as te, useInstallPackag
 import "./useLLMProviders.js";
 import { useInitiateSlackConnect as le, useLinkIntegrationConnection as ue, useMyUserPlatformConnection as de, useRevokeSlackConnection as fe, useToggleSlackNotifications as pe } from "./useUserPlatformConnection.js";
 import { useConfigureSupervisor as me, useRunSupervisorNow as he, useSupervisorConfig as ge, useSupervisorRuns as _e } from "./useAiOperations.js";
-export { m as a2aAgentSkillCount, r as isMCPServerHealthy, i as mcpServerDescription, a as mcpServerEndpoint, R as promptTemplateVariables, g as routeMetadataString, ee as storePackageDescription, te as storePackageName, G as summariseExecutions, h as useA2AAgents, t as useAgents, j as useApplyRetention, _ as useBotChannelRoutes, e as useBots, q as useBucket, J as useBucketTree, Y as useBuckets, v as useChannelConnector, y as useChannelConnectors, b as useChannelRoutes, X as useChildBuckets, me as useConfigureSupervisor, Z as useCreateBucket, x as useCreateChannelConnector, S as useCreateChannelRoute, o as useCreateMCPServer, E as useCreatePolicy, z as useCreatePromptTemplate, N as useCreateSkill, Q as useDeleteBucket, C as useDeleteChannelConnector, w as useDeleteChannelRoute, s as useDeleteMCPServer, D as useDeletePolicy, B as useDeletePromptTemplate, P as useDeleteSkill, K as useExecutions, le as useInitiateSlackConnect, ne as useInstallPackage, re as useInstalledPackages, ue as useLinkIntegrationConnection, c as useMCPResources, l as useMCPServer, u as useMCPTools, de as useMyUserPlatformConnection, ie as usePinPackageVersion, O as usePolicies, k as usePolicy, V as usePromptTemplate, H as usePromptTemplates, U as useRenderPromptTemplate, M as useRetentionStatus, n as useRetrievalProfiles, fe as useRevokeSlackConnection, he as useRunSupervisorNow, F as useSkill, I as useSkills, ae as useStorePackage, oe as useStorePackages, ge as useSupervisorConfig, _e as useSupervisorRuns, d as useTestMCPConnection, pe as useToggleSlackNotifications, se as useUninstallPackage, $ as useUpdateBucket, T as useUpdateChannelConnector, ce as useUpdateInstalledPackage, f as useUpdateMCPServer, p as useUpdateMCPTool, A as useUpdatePolicy, W as useUpdatePromptTemplate, L as useUpdateSkill };
+import { useAcceptHandoff as ve, useHandoffConfig as ye, useHandoffQueue as be, useRejectHandoff as xe, useReleaseHandoff as Se, useResolveHandoff as Ce, useUpsertHandoffConfig as we } from "./useHandoffs.js";
+export { m as a2aAgentSkillCount, r as isMCPServerHealthy, i as mcpServerDescription, a as mcpServerEndpoint, R as promptTemplateVariables, g as routeMetadataString, ee as storePackageDescription, te as storePackageName, G as summariseExecutions, h as useA2AAgents, ve as useAcceptHandoff, t as useAgents, j as useApplyRetention, _ as useBotChannelRoutes, e as useBots, q as useBucket, J as useBucketTree, Y as useBuckets, v as useChannelConnector, y as useChannelConnectors, b as useChannelRoutes, X as useChildBuckets, me as useConfigureSupervisor, Z as useCreateBucket, x as useCreateChannelConnector, S as useCreateChannelRoute, o as useCreateMCPServer, E as useCreatePolicy, z as useCreatePromptTemplate, N as useCreateSkill, Q as useDeleteBucket, C as useDeleteChannelConnector, w as useDeleteChannelRoute, s as useDeleteMCPServer, D as useDeletePolicy, B as useDeletePromptTemplate, P as useDeleteSkill, K as useExecutions, ye as useHandoffConfig, be as useHandoffQueue, le as useInitiateSlackConnect, ne as useInstallPackage, re as useInstalledPackages, ue as useLinkIntegrationConnection, c as useMCPResources, l as useMCPServer, u as useMCPTools, de as useMyUserPlatformConnection, ie as usePinPackageVersion, O as usePolicies, k as usePolicy, V as usePromptTemplate, H as usePromptTemplates, xe as useRejectHandoff, Se as useReleaseHandoff, U as useRenderPromptTemplate, Ce as useResolveHandoff, M as useRetentionStatus, n as useRetrievalProfiles, fe as useRevokeSlackConnection, he as useRunSupervisorNow, F as useSkill, I as useSkills, ae as useStorePackage, oe as useStorePackages, ge as useSupervisorConfig, _e as useSupervisorRuns, d as useTestMCPConnection, pe as useToggleSlackNotifications, se as useUninstallPackage, $ as useUpdateBucket, T as useUpdateChannelConnector, ce as useUpdateInstalledPackage, f as useUpdateMCPServer, p as useUpdateMCPTool, A as useUpdatePolicy, W as useUpdatePromptTemplate, L as useUpdateSkill, we as useUpsertHandoffConfig };

package/dist/botlit/hooks/useHandoffs.d.ts

@@ -0,0 +1,78 @@
+import { BotmanorHandoffFallbackBehavior, BotmanorHandoffStatus, BotmanorHandoffTrigger, BotmanorHandoffConfigInput } from '../../generated/wspace-types';
+import { MutationState, QueryResult } from './internal/workspaceGateway';
+export interface HandoffCustomIntentRecord {
+    name: string;
+    pattern: string;
+    isRegex: boolean;
+}
+export interface HandoffConfigRecord {
+    agentId: string;
+    enabled: boolean;
+    explicitRequest: boolean;
+    lowConfidence: boolean;
+    lowConfidenceThreshold: number;
+    repeatedFailures: boolean;
+    repeatedFailuresConsecutive: number;
+    policyRefusal: boolean;
+    customIntents: HandoffCustomIntentRecord[];
+    targetUserIds: string[];
+    targetRole?: string | null;
+    notifyInApp: boolean;
+    notifyEmail: boolean;
+    notifyPush: boolean;
+    fallbackBehavior: BotmanorHandoffFallbackBehavior;
+    handoffMessage?: string | null;
+    updatedAt?: string | null;
+}
+export interface HandoffEventRecord {
+    at: string;
+    actorId: string;
+    from?: BotmanorHandoffStatus | null;
+    to: BotmanorHandoffStatus;
+    note?: string | null;
+}
+export interface HandoffRecord {
+    id: string;
+    agentId: string;
+    conversationKey: string;
+    conversationId?: string | null;
+    status: BotmanorHandoffStatus;
+    trigger: BotmanorHandoffTrigger;
+    reason: string;
+    userMessage?: string | null;
+    assignedToId?: string | null;
+    executionId?: string | null;
+    events: HandoffEventRecord[];
+    createdAt: string;
+    acceptedAt?: string | null;
+    resolvedAt?: string | null;
+    releasedAt?: string | null;
+}
+export declare const ACTIVE_HANDOFF_STATUSES: readonly BotmanorHandoffStatus[];
+export declare function isActiveHandoff(status: BotmanorHandoffStatus): boolean;
+export declare function useHandoffConfig(agentId: string | undefined): QueryResult<HandoffConfigRecord | null>;
+export interface HandoffQueueResult {
+    items: HandoffRecord[];
+    total: number;
+    hasMore: boolean;
+}
+export declare function useHandoffQueue(options: {
+    agentId?: string;
+    statuses?: BotmanorHandoffStatus[];
+}): QueryResult<HandoffQueueResult>;
+export declare function useConversationHandoff(agentId: string | undefined, conversationKey: string | undefined): QueryResult<HandoffRecord | null>;
+export declare function useUpsertHandoffConfig(agentId: string): readonly [(input: BotmanorHandoffConfigInput) => Promise<HandoffConfigRecord>, MutationState<HandoffConfigRecord>];
+export declare function useRequestHandoff(): readonly [(input: {
+    agentId: string;
+    conversationKey: string;
+    reason?: string;
+}) => Promise<HandoffRecord>, MutationState<HandoffRecord>];
+interface HandoffTransitionResult {
+    id: string;
+    status: BotmanorHandoffStatus;
+}
+export declare function useAcceptHandoff(): readonly [(id: string) => Promise<HandoffTransitionResult>, MutationState<HandoffTransitionResult>];
+export declare function useReleaseHandoff(): readonly [(id: string) => Promise<HandoffTransitionResult>, MutationState<HandoffTransitionResult>];
+export declare function useResolveHandoff(): readonly [(id: string) => Promise<HandoffTransitionResult>, MutationState<HandoffTransitionResult>];
+export declare function useRejectHandoff(): readonly [(id: string) => Promise<HandoffTransitionResult>, MutationState<HandoffTransitionResult>];
+export {};

package/dist/botlit/hooks/useHandoffs.js

@@ -0,0 +1,77 @@
+import { AcceptHandoffDocument as e, HandoffConfigDocument as t, HandoffQueueDocument as n, RejectHandoffDocument as r, ReleaseHandoffDocument as i, ResolveHandoffDocument as a, UpsertHandoffConfigDocument as o } from "../../generated/wspace-operations.js";
+import { BotmanorHandoffStatus as s } from "../../generated/wspace-types.js";
+import { useWorkspaceId as c, useWorkspaceMutation as l, useWorkspaceQuery as u } from "./internal/workspaceGateway.js";
+s.Requested, s.Assigned, s.Accepted;
+function d(e) {
+	let n = c();
+	return u({
+		document: t,
+		variables: { agentId: e ?? "" },
+		select: (e) => e?.handoffConfig ?? null,
+		fallback: null,
+		enabled: !!(n && e),
+		errorMessage: "Failed to load handoff configuration"
+	});
+}
+var f = 100;
+function p(e) {
+	let t = c();
+	return u({
+		document: n,
+		variables: {
+			...e.agentId ? { agentId: e.agentId } : {},
+			...e.statuses && e.statuses.length > 0 ? { statuses: e.statuses } : {},
+			pagination: {
+				limit: f,
+				offset: 0
+			}
+		},
+		select: (e) => ({
+			items: e?.handoffQueue.items ?? [],
+			total: e?.handoffQueue.total ?? 0,
+			hasMore: e?.handoffQueue.hasMore ?? !1
+		}),
+		fallback: {
+			items: [],
+			total: 0,
+			hasMore: !1
+		},
+		enabled: !!t,
+		errorMessage: "Failed to load the handoff queue"
+	});
+}
+function m(e) {
+	let [t, n] = l({
+		document: o,
+		variables: (t) => ({
+			agentId: e,
+			input: t
+		}),
+		select: (e) => e?.upsertHandoffConfig,
+		errorMessage: "Failed to save handoff configuration"
+	});
+	return [t, n];
+}
+function h(e, t, n) {
+	return l({
+		document: e,
+		variables: (e) => ({ id: e }),
+		select: t,
+		errorMessage: n
+	});
+}
+function g() {
+	return h(e, (e) => e?.acceptHandoff, "Failed to accept the handoff");
+}
+function _() {
+	return h(i, (e) => e?.releaseHandoff, "Failed to release the handoff");
+}
+function v() {
+	return h(a, (e) => e?.resolveHandoff, "Failed to resolve the handoff");
+}
+function y() {
+	return h(r, (e) => e?.rejectHandoff, "Failed to reject the handoff");
+}
+export { g as useAcceptHandoff, d as useHandoffConfig, p as useHandoffQueue, y as useRejectHandoff, _ as useReleaseHandoff, v as useResolveHandoff, m as useUpsertHandoffConfig };
+
+//# sourceMappingURL=useHandoffs.js.map

package/dist/botlit/hooks/useHandoffs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHandoffs.js","names":["BotmanorHandoffStatus","useHandoffConfig","workspaceId","useWorkspaceId","useWorkspaceQuery","HandoffConfigDocument","agentId","data","QUEUE_PAGE_LIMIT","useHandoffQueue","HandoffQueueDocument","options","useUpsertHandoffConfig","mutate","state","useWorkspaceMutation","UpsertHandoffConfigDocument","useHandoffTransition","useAcceptHandoff","AcceptHandoffDocument","useReleaseHandoff","ReleaseHandoffDocument","useResolveHandoff","ResolveHandoffDocument","useRejectHandoff","RejectHandoffDocument"],"sources":["../../../src/botlit/hooks/useHandoffs.ts"],"sourcesContent":["/**\n * Handoff hooks (BOFF-5813)\n * @module botlit/hooks\n *\n * Backed by the live `handoffConfig` / `handoffQueue` / `conversationHandoff`\n * queries and the upsert / request / accept / release / resolve / reject\n * mutations on wspace-botmanor-svc.\n */\n\nimport {\n  AcceptHandoffDocument,\n  ConversationHandoffDocument,\n  HandoffConfigDocument,\n  HandoffQueueDocument,\n  RejectHandoffDocument,\n  ReleaseHandoffDocument,\n  RequestHandoffDocument,\n  ResolveHandoffDocument,\n  UpsertHandoffConfigDocument,\n  type AcceptHandoffMutation,\n  type ConversationHandoffQuery,\n  type HandoffConfigQuery,\n  type HandoffQueueQuery,\n  type RejectHandoffMutation,\n  type ReleaseHandoffMutation,\n  type RequestHandoffMutation,\n  type ResolveHandoffMutation,\n  type UpsertHandoffConfigMutation,\n} from '../../generated/wspace-operations';\nimport {\n  BotmanorHandoffFallbackBehavior,\n  BotmanorHandoffStatus,\n  BotmanorHandoffTrigger,\n  type BotmanorHandoffConfigInput,\n} from '../../generated/wspace-types';\nimport {\n  useWorkspaceId,\n  useWorkspaceMutation,\n  useWorkspaceQuery,\n  type MutationState,\n  type QueryResult,\n} from './internal/workspaceGateway';\n\nexport interface HandoffCustomIntentRecord {\n  name: string;\n  pattern: string;\n  isRegex: boolean;\n}\n\nexport interface HandoffConfigRecord {\n  agentId: string;\n  enabled: boolean;\n  explicitRequest: boolean;\n  lowConfidence: boolean;\n  lowConfidenceThreshold: number;\n  repeatedFailures: boolean;\n  repeatedFailuresConsecutive: number;\n  policyRefusal: boolean;\n  customIntents: HandoffCustomIntentRecord[];\n  targetUserIds: string[];\n  targetRole?: string | null;\n  notifyInApp: boolean;\n  notifyEmail: boolean;\n  notifyPush: boolean;\n  fallbackBehavior: BotmanorHandoffFallbackBehavior;\n  handoffMessage?: string | null;\n  updatedAt?: string | null;\n}\n\nexport interface HandoffEventRecord {\n  at: string;\n  actorId: string;\n  from?: BotmanorHandoffStatus | null;\n  to: BotmanorHandoffStatus;\n  note?: string | null;\n}\n\nexport interface HandoffRecord {\n  id: string;\n  agentId: string;\n  conversationKey: string;\n  conversationId?: string | null;\n  status: BotmanorHandoffStatus;\n  trigger: BotmanorHandoffTrigger;\n  reason: string;\n  userMessage?: string | null;\n  assignedToId?: string | null;\n  executionId?: string | null;\n  events: HandoffEventRecord[];\n  createdAt: string;\n  acceptedAt?: string | null;\n  resolvedAt?: string | null;\n  releasedAt?: string | null;\n}\n\nexport const ACTIVE_HANDOFF_STATUSES: readonly BotmanorHandoffStatus[] = [\n  BotmanorHandoffStatus.Requested,\n  BotmanorHandoffStatus.Assigned,\n  BotmanorHandoffStatus.Accepted,\n];\n\nexport function isActiveHandoff(status: BotmanorHandoffStatus): boolean {\n  return ACTIVE_HANDOFF_STATUSES.includes(status);\n}\n\nexport function useHandoffConfig(\n  agentId: string | undefined\n): QueryResult<HandoffConfigRecord | null> {\n  const workspaceId = useWorkspaceId();\n  return useWorkspaceQuery<HandoffConfigQuery, HandoffConfigRecord | null>({\n    document: HandoffConfigDocument,\n    variables: { agentId: agentId ?? '' },\n    select: (data) => data?.handoffConfig ?? null,\n    fallback: null,\n    enabled: Boolean(workspaceId && agentId),\n    errorMessage: 'Failed to load handoff configuration',\n  });\n}\n\nexport interface HandoffQueueResult {\n  items: HandoffRecord[];\n  total: number;\n  hasMore: boolean;\n}\n\nconst QUEUE_PAGE_LIMIT = 100;\n\nexport function useHandoffQueue(options: {\n  agentId?: string;\n  statuses?: BotmanorHandoffStatus[];\n}): QueryResult<HandoffQueueResult> {\n  const workspaceId = useWorkspaceId();\n  return useWorkspaceQuery<HandoffQueueQuery, HandoffQueueResult>({\n    document: HandoffQueueDocument,\n    variables: {\n      ...(options.agentId ? { agentId: options.agentId } : {}),\n      ...(options.statuses && options.statuses.length > 0 ? { statuses: options.statuses } : {}),\n      pagination: { limit: QUEUE_PAGE_LIMIT, offset: 0 },\n    },\n    select: (data) => ({\n      items: data?.handoffQueue.items ?? [],\n      total: data?.handoffQueue.total ?? 0,\n      hasMore: data?.handoffQueue.hasMore ?? false,\n    }),\n    fallback: { items: [], total: 0, hasMore: false },\n    enabled: Boolean(workspaceId),\n    errorMessage: 'Failed to load the handoff queue',\n  });\n}\n\nexport function useConversationHandoff(\n  agentId: string | undefined,\n  conversationKey: string | undefined\n): QueryResult<HandoffRecord | null> {\n  const workspaceId = useWorkspaceId();\n  return useWorkspaceQuery<ConversationHandoffQuery, HandoffRecord | null>({\n    document: ConversationHandoffDocument,\n    variables: { agentId: agentId ?? '', conversationKey: conversationKey ?? '' },\n    select: (data) => data?.conversationHandoff ?? null,\n    fallback: null,\n    enabled: Boolean(workspaceId && agentId && conversationKey),\n    errorMessage: 'Failed to load the conversation handoff',\n  });\n}\n\nexport function useUpsertHandoffConfig(agentId: string) {\n  const [mutate, state] = useWorkspaceMutation<\n    UpsertHandoffConfigMutation,\n    BotmanorHandoffConfigInput,\n    HandoffConfigRecord\n  >({\n    document: UpsertHandoffConfigDocument,\n    variables: (input) => ({ agentId, input }),\n    select: (data) => data?.upsertHandoffConfig,\n    errorMessage: 'Failed to save handoff configuration',\n  });\n  return [mutate, state] as const;\n}\n\nexport function useRequestHandoff() {\n  const [mutate, state] = useWorkspaceMutation<\n    RequestHandoffMutation,\n    { agentId: string; conversationKey: string; reason?: string },\n    HandoffRecord\n  >({\n    document: RequestHandoffDocument,\n    variables: (input) => ({ ...input }),\n    select: (data) => data?.requestHandoff,\n    errorMessage: 'Failed to request a human',\n  });\n  return [mutate, state] as const;\n}\n\ninterface HandoffTransitionResult {\n  id: string;\n  status: BotmanorHandoffStatus;\n}\n\nfunction useHandoffTransition<TMutation>(\n  document: Parameters<typeof useWorkspaceMutation>[0]['document'],\n  select: (data: TMutation | undefined) => HandoffTransitionResult | undefined,\n  errorMessage: string\n): readonly [\n  (id: string) => Promise<HandoffTransitionResult>,\n  MutationState<HandoffTransitionResult>,\n] {\n  return useWorkspaceMutation<TMutation, string, HandoffTransitionResult>({\n    document,\n    variables: (id) => ({ id }),\n    select,\n    errorMessage,\n  });\n}\n\nexport function useAcceptHandoff() {\n  return useHandoffTransition<AcceptHandoffMutation>(\n    AcceptHandoffDocument,\n    (data) => data?.acceptHandoff,\n    'Failed to accept the handoff'\n  );\n}\n\nexport function useReleaseHandoff() {\n  return useHandoffTransition<ReleaseHandoffMutation>(\n    ReleaseHandoffDocument,\n    (data) => data?.releaseHandoff,\n    'Failed to release the handoff'\n  );\n}\n\nexport function useResolveHandoff() {\n  return useHandoffTransition<ResolveHandoffMutation>(\n    ResolveHandoffDocument,\n    (data) => data?.resolveHandoff,\n    'Failed to resolve the handoff'\n  );\n}\n\nexport function useRejectHandoff() {\n  return useHandoffTransition<RejectHandoffMutation>(\n    RejectHandoffDocument,\n    (data) => data?.rejectHandoff,\n    'Failed to reject the handoff'\n  );\n}\n"],"mappings":";;;AAgGEA,EAAsB,WACtBA,EAAsB,UACtBA,EAAsB;AAOxB,SAAgBC,EACd,GACyC;CACzC,IAAMC,IAAcC,EAAe;CACnC,OAAOC,EAAkE;EACvE,UAAUC;EACV,WAAW,EAAE,SAASC,KAAW,GAAG;EACpC,SAAS,MAASC,GAAM,iBAAiB;EACzC,UAAU;EACV,SAAS,GAAQL,KAAeI;EAChC,cAAc;CAChB,CAAC;AACH;AAQA,IAAME,IAAmB;AAEzB,SAAgBC,EAAgB,GAGI;CAClC,IAAMP,IAAcC,EAAe;CACnC,OAAOC,EAAyD;EAC9D,UAAUM;EACV,WAAW;GACT,GAAIC,EAAQ,UAAU,EAAE,SAASA,EAAQ,QAAQ,IAAI,CAAC;GACtD,GAAIA,EAAQ,YAAYA,EAAQ,SAAS,SAAS,IAAI,EAAE,UAAUA,EAAQ,SAAS,IAAI,CAAC;GACxF,YAAY;IAAE,OAAOH;IAAkB,QAAQ;GAAE;EACnD;EACA,SAAS,OAAU;GACjB,OAAOD,GAAM,aAAa,SAAS,CAAC;GACpC,OAAOA,GAAM,aAAa,SAAS;GACnC,SAASA,GAAM,aAAa,WAAW;EACzC;EACA,UAAU;GAAE,OAAO,CAAC;GAAG,OAAO;GAAG,SAAS;EAAM;EAChD,SAAS,EAAQL;EACjB,cAAc;CAChB,CAAC;AACH;AAiBA,SAAgBU,EAAuB,GAAiB;CACtD,IAAM,CAACC,GAAQC,KAASC,EAItB;EACA,UAAUC;EACV,YAAY,OAAW;GAAE;GAAS;EAAM;EACxC,SAAS,MAAST,GAAM;EACxB,cAAc;CAChB,CAAC;CACD,OAAO,CAACM,GAAQC,CAAK;AACvB;AAqBA,SAASG,EACP,GACA,GACA,GAIA;CACA,OAAOF,EAAiE;EACtE;EACA,YAAY,OAAQ,EAAE,MAAG;EACzB;EACA;CACF,CAAC;AACH;AAEA,SAAgBG,IAAmB;CACjC,OAAOD,EACLE,IACC,MAASZ,GAAM,eAChB,8BACF;AACF;AAEA,SAAgBa,IAAoB;CAClC,OAAOH,EACLI,IACC,MAASd,GAAM,gBAChB,+BACF;AACF;AAEA,SAAgBe,IAAoB;CAClC,OAAOL,EACLM,IACC,MAAShB,GAAM,gBAChB,+BACF;AACF;AAEA,SAAgBiB,IAAmB;CACjC,OAAOP,EACLQ,IACC,MAASlB,GAAM,eAChB,8BACF;AACF"}