@oxy-hq/sdk 2.3.0 → 2.5.0

package/dist/shell.mjs

@@ -0,0 +1,2155 @@
+// @oxy/sdk - TypeScript SDK for Oxy data platform
+import { i as useAgentRun, l as useResolvedManifest, o as useOxyApp, t as OxyAnswer, v as getOxyAppLogger } from "./react-CVdWXcu8.mjs";
+import * as React from "react";
+import { Fragment, useEffect, useMemo, useState } from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+import * as TooltipPrimitive from "@radix-ui/react-tooltip";
+
+//#region src/shell/cx.ts
+/** Join truthy class names. Local minimal `clsx` — the shell uses fixed
+*  namespaced classes, so no Tailwind-style merge logic is needed. */
+function cx(...parts) {
+	return parts.filter(Boolean).join(" ");
+}
+
+//#endregion
+//#region src/shell/AnswerChart.tsx
+const PALETTE = [
+	"#3b82f6",
+	"#22c55e",
+	"#eab308",
+	"#a855f7",
+	"#06b6d4",
+	"#f97316"
+];
+const compact = new Intl.NumberFormat("en", {
+	notation: "compact",
+	maximumFractionDigits: 1
+});
+const toNum = (v) => {
+	const n = typeof v === "number" ? v : Number(v);
+	return Number.isFinite(n) ? n : 0;
+};
+const toStr = (v) => v === null || v === void 0 ? "" : String(v);
+/** "sales_daily__total_net_sales" → "Total Net Sales" — a friendly series
+*  label instead of the raw semantic column id. */
+function humanizeCol(name) {
+	return ((name ?? "").split("__").pop() ?? "").replace(/_/g, " ").trim().replace(/\b\w/g, (c) => c.toUpperCase());
+}
+/** Pivot rows into per-series value arrays aligned on x categories. */
+function pivotChart(block) {
+	const { config, columns, rows } = block;
+	const xi = config.x ? columns.indexOf(config.x) : 0;
+	const yi = config.y ? columns.indexOf(config.y) : columns.length > 1 ? 1 : 0;
+	const si = config.series ? columns.indexOf(config.series) : -1;
+	const categories = [];
+	const catIndex = /* @__PURE__ */ new Map();
+	for (const row of rows) {
+		const cat = toStr(row[xi]);
+		if (!catIndex.has(cat)) {
+			catIndex.set(cat, categories.length);
+			categories.push(cat);
+		}
+	}
+	if (si === -1) {
+		const values = new Array(categories.length).fill(0);
+		for (const row of rows) {
+			const idx = catIndex.get(toStr(row[xi]));
+			if (idx !== void 0) values[idx] = toNum(row[yi]);
+		}
+		return {
+			categories,
+			series: [{
+				name: config.y ?? "value",
+				values
+			}]
+		};
+	}
+	const seriesIndex = /* @__PURE__ */ new Map();
+	for (const row of rows) {
+		const name = toStr(row[si]);
+		let values = seriesIndex.get(name);
+		if (!values) {
+			values = new Array(categories.length).fill(0);
+			seriesIndex.set(name, values);
+		}
+		const idx = catIndex.get(toStr(row[xi]));
+		if (idx !== void 0) values[idx] = toNum(row[yi]);
+	}
+	return {
+		categories,
+		series: [...seriesIndex.entries()].map(([name, values]) => ({
+			name,
+			values
+		}))
+	};
+}
+/** A "nice" axis ceiling so tick labels land on round numbers. */
+function niceCeil(max) {
+	if (max <= 0) return 1;
+	const pow = 10 ** Math.floor(Math.log10(max));
+	const unit = max / pow;
+	return (unit <= 1 ? 1 : unit <= 2 ? 2 : unit <= 5 ? 5 : 10) * pow;
+}
+/** Axis domain `[lo, hi]` that always includes zero, with nice round
+*  bounds. Signed measures (profit, net change) must render below a zero
+*  baseline instead of being clamped to an invisible 0..max axis. */
+function axisDomain(values) {
+	const rawMax = Math.max(...values, 0);
+	const rawMin = Math.min(...values, 0);
+	const hi = rawMax > 0 ? niceCeil(rawMax) : 0;
+	const lo = rawMin < 0 ? -niceCeil(-rawMin) : 0;
+	return hi === lo ? {
+		lo: 0,
+		hi: 1
+	} : {
+		lo,
+		hi
+	};
+}
+const W = 360;
+const H = 190;
+const M = {
+	top: 8,
+	right: 8,
+	bottom: 34,
+	left: 42
+};
+const IW = W - M.left - M.right;
+const IH = H - M.top - M.bottom;
+const TICKS = 4;
+function truncate(label, max) {
+	return label.length > max ? `${label.slice(0, max - 1)}…` : label;
+}
+/** Map a value to its y pixel within the plot area for domain `[lo, hi]`. */
+const yFor = (v, lo, hi) => M.top + IH * (1 - (v - lo) / (hi - lo || 1));
+function Axes({ lo, hi }) {
+	const span = hi - lo || 1;
+	return /* @__PURE__ */ jsx("g", {
+		className: "oxy-chart__grid",
+		children: Array.from({ length: 5 }, (_, i) => {
+			const y = M.top + IH * i / TICKS;
+			const value = hi - span * i / TICKS;
+			return /* @__PURE__ */ jsxs("g", { children: [/* @__PURE__ */ jsx("line", {
+				x1: M.left,
+				x2: M.left + IW,
+				y1: y,
+				y2: y
+			}), /* @__PURE__ */ jsx("text", {
+				x: M.left - 5,
+				y: y + 3,
+				textAnchor: "end",
+				className: "oxy-chart__tick",
+				children: compact.format(value)
+			})] }, i);
+		})
+	});
+}
+function XLabels({ categories }) {
+	const slot = IW / categories.length;
+	const maxChars = Math.max(4, Math.floor(slot / 5.5));
+	return /* @__PURE__ */ jsx("g", { children: categories.map((cat, i) => /* @__PURE__ */ jsxs("text", {
+		x: M.left + slot * (i + .5),
+		y: H - M.bottom + 12,
+		textAnchor: "middle",
+		className: "oxy-chart__tick",
+		children: [/* @__PURE__ */ jsx("title", { children: cat }), truncate(cat, maxChars)]
+	}, cat)) });
+}
+function BarChart({ data }) {
+	const { lo, hi } = axisDomain(data.series.flatMap((s) => s.values));
+	const zeroY = yFor(0, lo, hi);
+	const slot = IW / data.categories.length;
+	const group = slot * .7;
+	const barW = group / data.series.length;
+	return /* @__PURE__ */ jsxs("svg", {
+		viewBox: `0 0 ${W} ${H}`,
+		className: "oxy-chart__svg",
+		role: "img",
+		children: [
+			/* @__PURE__ */ jsx(Axes, {
+				lo,
+				hi
+			}),
+			data.series.map((s, si) => s.values.map((v, ci) => {
+				const vy = yFor(v, lo, hi);
+				return /* @__PURE__ */ jsx("rect", {
+					x: M.left + slot * ci + (slot - group) / 2 + barW * si,
+					y: Math.min(zeroY, vy),
+					width: Math.max(1, barW - 1),
+					height: Math.max(0, Math.abs(vy - zeroY)),
+					rx: 1.5,
+					fill: PALETTE[si % PALETTE.length],
+					children: /* @__PURE__ */ jsx("title", { children: `${data.categories[ci]}${data.series.length > 1 ? ` · ${s.name}` : ""}: ${compact.format(v)}` })
+				}, `${s.name}-${data.categories[ci]}`);
+			})),
+			lo < 0 && /* @__PURE__ */ jsx("line", {
+				className: "oxy-chart__grid-zero",
+				x1: M.left,
+				x2: M.left + IW,
+				y1: zeroY,
+				y2: zeroY
+			}),
+			/* @__PURE__ */ jsx(XLabels, { categories: data.categories })
+		]
+	});
+}
+function LineChart({ data }) {
+	const { lo, hi } = axisDomain(data.series.flatMap((s) => s.values));
+	const zeroY = yFor(0, lo, hi);
+	const slot = IW / Math.max(1, data.categories.length - 1 || 1);
+	const px = (ci) => data.categories.length === 1 ? M.left + IW / 2 : M.left + slot * ci;
+	const py = (v) => yFor(v, lo, hi);
+	return /* @__PURE__ */ jsxs("svg", {
+		viewBox: `0 0 ${W} ${H}`,
+		className: "oxy-chart__svg",
+		role: "img",
+		children: [
+			/* @__PURE__ */ jsx(Axes, {
+				lo,
+				hi
+			}),
+			lo < 0 && /* @__PURE__ */ jsx("line", {
+				className: "oxy-chart__grid-zero",
+				x1: M.left,
+				x2: M.left + IW,
+				y1: zeroY,
+				y2: zeroY
+			}),
+			data.series.map((s, si) => /* @__PURE__ */ jsxs("g", { children: [/* @__PURE__ */ jsx("polyline", {
+				points: s.values.map((v, ci) => `${px(ci)},${py(v)}`).join(" "),
+				fill: "none",
+				stroke: PALETTE[si % PALETTE.length],
+				strokeWidth: 1.8
+			}), s.values.map((v, ci) => /* @__PURE__ */ jsx("circle", {
+				cx: px(ci),
+				cy: py(v),
+				r: 2.2,
+				fill: PALETTE[si % PALETTE.length],
+				children: /* @__PURE__ */ jsx("title", { children: `${data.categories[ci]}${data.series.length > 1 ? ` · ${s.name}` : ""}: ${compact.format(v)}` })
+			}, data.categories[ci]))] }, s.name)),
+			/* @__PURE__ */ jsx(XLabels, { categories: data.categories })
+		]
+	});
+}
+function PieChart({ block }) {
+	const { config, columns, rows } = block;
+	const ni = config.name ? columns.indexOf(config.name) : config.x ? columns.indexOf(config.x) : 0;
+	const vi = config.value ? columns.indexOf(config.value) : config.y ? columns.indexOf(config.y) : 1;
+	const slices = rows.map((r) => ({
+		name: toStr(r[ni]),
+		value: Math.max(0, toNum(r[vi]))
+	}));
+	const total = slices.reduce((sum, s) => sum + s.value, 0) || 1;
+	const cxp = W / 2;
+	const cyp = H / 2;
+	const r = Math.min(W, H) / 2 - 14;
+	let angle = -Math.PI / 2;
+	const paths = slices.map((s, i) => {
+		const sweep = s.value / total * Math.PI * 2;
+		const title = `${s.name}: ${compact.format(s.value)} (${Math.round(s.value / total * 100)}%)`;
+		const fill = PALETTE[i % PALETTE.length];
+		if (sweep >= Math.PI * 2 - 1e-6) {
+			angle += sweep;
+			return /* @__PURE__ */ jsx("circle", {
+				cx: cxp,
+				cy: cyp,
+				r,
+				fill,
+				stroke: "var(--oxy-shell-background, #fff)",
+				strokeWidth: 1,
+				children: /* @__PURE__ */ jsx("title", { children: title })
+			}, s.name);
+		}
+		const x1 = cxp + r * Math.cos(angle);
+		const y1 = cyp + r * Math.sin(angle);
+		angle += sweep;
+		const x2 = cxp + r * Math.cos(angle);
+		const y2 = cyp + r * Math.sin(angle);
+		return /* @__PURE__ */ jsx("path", {
+			d: `M ${cxp} ${cyp} L ${x1} ${y1} A ${r} ${r} 0 ${sweep > Math.PI ? 1 : 0} 1 ${x2} ${y2} Z`,
+			fill,
+			stroke: "var(--oxy-shell-background, #fff)",
+			strokeWidth: 1,
+			children: /* @__PURE__ */ jsx("title", { children: title })
+		}, s.name);
+	});
+	return /* @__PURE__ */ jsx("svg", {
+		viewBox: `0 0 ${W} ${H}`,
+		className: "oxy-chart__svg",
+		role: "img",
+		children: paths
+	});
+}
+const TABLE_MAX_ROWS = 10;
+function TableChart({ block }) {
+	const visible = block.rows.slice(0, TABLE_MAX_ROWS);
+	return /* @__PURE__ */ jsxs("div", {
+		className: "oxy-chart__table-wrap",
+		children: [/* @__PURE__ */ jsxs("table", {
+			className: "oxy-chart__table",
+			children: [/* @__PURE__ */ jsx("thead", { children: /* @__PURE__ */ jsx("tr", { children: block.columns.map((c) => /* @__PURE__ */ jsx("th", { children: c }, c)) }) }), /* @__PURE__ */ jsx("tbody", { children: visible.map((row, i) => /* @__PURE__ */ jsx("tr", { children: block.columns.map((c, j) => /* @__PURE__ */ jsx("td", { children: toStr(row[j]) }, c)) }, row.map(toStr).join("|") || i)) })]
+		}), block.rows.length > TABLE_MAX_ROWS && /* @__PURE__ */ jsxs("div", {
+			className: "oxy-chart__note",
+			children: [
+				"+",
+				block.rows.length - TABLE_MAX_ROWS,
+				" more rows"
+			]
+		})]
+	});
+}
+/** Dependency-free SVG rendering — the fallback when the host app has no
+*  `echarts`. */
+function SvgChart({ block }) {
+	const data = block.config.chart_type === "bar_chart" || block.config.chart_type === "line_chart" ? pivotChart(block) : null;
+	let body;
+	switch (block.config.chart_type) {
+		case "bar_chart":
+			body = data && /* @__PURE__ */ jsx(BarChart, { data });
+			break;
+		case "line_chart":
+			body = data && /* @__PURE__ */ jsx(LineChart, { data });
+			break;
+		case "pie_chart":
+			body = /* @__PURE__ */ jsx(PieChart, { block });
+			break;
+		default: body = /* @__PURE__ */ jsx(TableChart, { block });
+	}
+	const multiSeries = data && data.series.length > 1;
+	return /* @__PURE__ */ jsxs(Fragment$1, { children: [body, multiSeries && /* @__PURE__ */ jsx("div", {
+		className: "oxy-chart__legend",
+		children: data.series.map((s, i) => /* @__PURE__ */ jsxs("span", {
+			className: "oxy-chart__legend-item",
+			children: [/* @__PURE__ */ jsx("span", {
+				className: "oxy-chart__legend-dot",
+				style: { background: PALETTE[i % PALETTE.length] }
+			}), s.name]
+		}, s.name))
+	})] });
+}
+/** Read the shell's design tokens off an element so the ECharts chart
+*  matches the surrounding light/dark theme. */
+function tokenColors(el) {
+	const cs = getComputedStyle(el);
+	const pick = (name, fallback) => cs.getPropertyValue(name).trim() || fallback;
+	return {
+		fg: pick("--oxy-shell-foreground", "#0a0a0a"),
+		muted: pick("--oxy-shell-muted-fg", "#71717a"),
+		border: pick("--oxy-shell-border", "#d4d4d8"),
+		bg: pick("--oxy-shell-background", "#ffffff")
+	};
+}
+/** Build the ECharts option for a `chart_rendered` block — the analytics
+*  pipeline's `{chart_type, x, y, series, …}` config, the same shape the
+*  main web-app charts. Interactive: axis/item tooltips, legend, hover. */
+function buildEchartsOption(block, el) {
+	const { fg, muted, border } = tokenColors(el);
+	const axisLabel = {
+		color: muted,
+		fontSize: 10
+	};
+	const ct = block.config.chart_type;
+	if (ct === "pie_chart") {
+		const { config, columns, rows } = block;
+		const ni = config.name ? columns.indexOf(config.name) : config.x ? columns.indexOf(config.x) : 0;
+		const vi = config.value ? columns.indexOf(config.value) : config.y ? columns.indexOf(config.y) : 1;
+		const data = rows.map((r) => ({
+			name: toStr(r[ni]),
+			value: Math.max(0, toNum(r[vi]))
+		}));
+		return {
+			color: PALETTE,
+			tooltip: {
+				trigger: "item",
+				formatter: "{b}: {c} ({d}%)"
+			},
+			legend: {
+				bottom: 0,
+				textStyle: {
+					color: muted,
+					fontSize: 10
+				},
+				type: "scroll"
+			},
+			series: [{
+				type: "pie",
+				radius: ["38%", "66%"],
+				center: ["50%", "44%"],
+				data,
+				label: {
+					color: fg,
+					fontSize: 10
+				},
+				labelLine: { lineStyle: { color: border } }
+			}]
+		};
+	}
+	const pivot = pivotChart(block);
+	const multi = pivot.series.length > 1;
+	const singleName = block.config.y_axis_label || humanizeCol(block.config.y) || "Value";
+	const longLabels = pivot.categories.length > 4 || pivot.categories.some((c) => c.length > 10);
+	return {
+		color: PALETTE,
+		tooltip: {
+			trigger: "axis",
+			valueFormatter: (v) => typeof v === "number" ? compact.format(v) : String(v)
+		},
+		grid: {
+			left: 6,
+			right: 12,
+			top: multi ? 30 : 12,
+			bottom: 4,
+			containLabel: true
+		},
+		legend: multi ? {
+			top: 0,
+			textStyle: {
+				color: muted,
+				fontSize: 10
+			},
+			type: "scroll"
+		} : void 0,
+		xAxis: {
+			type: "category",
+			data: pivot.categories,
+			name: block.config.x_axis_label,
+			nameLocation: "middle",
+			nameGap: longLabels ? 42 : 24,
+			nameTextStyle: {
+				color: muted,
+				fontSize: 10
+			},
+			axisLabel: {
+				...axisLabel,
+				interval: 0,
+				rotate: longLabels ? 30 : 0,
+				formatter: (v) => v.length > 18 ? `${v.slice(0, 17)}…` : v
+			},
+			axisTick: { show: false },
+			axisLine: { lineStyle: { color: border } }
+		},
+		yAxis: {
+			type: "value",
+			name: block.config.y_axis_label,
+			nameTextStyle: {
+				color: muted,
+				fontSize: 10
+			},
+			axisLabel: {
+				...axisLabel,
+				formatter: (v) => compact.format(v)
+			},
+			splitLine: { lineStyle: {
+				color: border,
+				opacity: .5
+			} }
+		},
+		series: pivot.series.map((s, i) => ({
+			name: multi ? s.name : singleName,
+			type: ct === "bar_chart" ? "bar" : "line",
+			data: s.values,
+			itemStyle: { color: PALETTE[i % PALETTE.length] },
+			...ct === "line_chart" ? {
+				lineStyle: { width: 2 },
+				symbolSize: 5,
+				smooth: false
+			} : {},
+			barMaxWidth: 32
+		}))
+	};
+}
+/** Renders one `chart_rendered` block. Uses ECharts (interactive, matching
+*  the main web-app) when the host app has it installed; otherwise falls
+*  back to a dependency-free SVG render. Table type always uses SVG. */
+function AnswerChart({ block, className }) {
+	const ref = React.useRef(null);
+	const [engine, setEngine] = React.useState(block.config.chart_type === "table" ? "svg" : "pending");
+	React.useEffect(() => {
+		if (engine === "svg") return;
+		let disposed = false;
+		let chart = null;
+		let ro = null;
+		import(
+			/* @vite-ignore */
+			"echarts"
+).then((echarts) => {
+			const el = ref.current;
+			if (disposed || !el) return;
+			chart = echarts.init(el, void 0, { renderer: "canvas" });
+			chart.setOption(buildEchartsOption(block, el));
+			ro = new ResizeObserver(() => chart?.resize());
+			ro.observe(el);
+		}).catch(() => {
+			if (!disposed) setEngine("svg");
+		});
+		return () => {
+			disposed = true;
+			ro?.disconnect();
+			chart?.dispose();
+		};
+	}, [block, engine]);
+	return /* @__PURE__ */ jsxs("figure", {
+		className: cx("oxy-chart", className),
+		"data-testid": "askdock-chart",
+		children: [block.config.title && /* @__PURE__ */ jsx("figcaption", {
+			className: "oxy-chart__title",
+			children: block.config.title
+		}), engine === "svg" ? /* @__PURE__ */ jsx(SvgChart, { block }) : /* @__PURE__ */ jsx("div", {
+			ref,
+			className: "oxy-chart__echarts",
+			style: {
+				width: "100%",
+				height: 240
+			}
+		})]
+	});
+}
+
+//#endregion
+//#region src/shell/marks.tsx
+/** The Oxygen "O" glyph path, in a 0 0 44 44 viewBox, used by `OxyMark`. */
+const OXY_MARK_PATH = "M38.4 22C39.2837 22 40.0074 22.7178 39.9289 23.5979C39.6619 26.5942 38.6471 29.485 36.9665 32.0003C34.9886 34.9603 32.1774 37.2674 28.8883 38.6298C25.5992 39.9922 21.98 40.3487 18.4884 39.6541C14.9967 38.9596 11.7894 37.2453 9.27209 34.7279C6.75474 32.2106 5.04041 29.0033 4.34587 25.5116C3.65134 22.02 4.0078 18.4008 5.37018 15.1117C6.73255 11.8226 9.03966 9.0114 11.9997 7.03353C14.515 5.35287 17.4058 4.33807 20.4021 4.07104C21.2822 3.9926 22 4.71633 22 5.59998L22 11.2C22 12.0837 22.7163 12.8 23.6 12.8H29.2C30.0837 12.8 30.8 12.0837 30.8 11.2V5.6C30.8 4.71634 31.5163 4 32.4 4H38.4C39.2836 4 40 4.71634 40 5.6V11.6C40 12.4837 39.2836 13.2 38.4 13.2H32.8C31.9163 13.2 31.2 13.9163 31.2 14.8V20.4C31.2 21.2837 31.9163 22 32.8 22L38.4 22ZM23.6 22C22.7163 22 22 21.2837 22 20.4L22 14.8371C22 13.9534 21.2778 13.2223 20.4089 13.3827C19.2427 13.5981 18.1268 14.0489 17.1316 14.7139C15.6905 15.6768 14.5674 17.0454 13.9041 18.6466C13.2409 20.2478 13.0674 22.0097 13.4055 23.7095C13.7436 25.4094 14.5782 26.9708 15.8037 28.1963C17.0292 29.4218 18.5906 30.2564 20.2904 30.5945C21.9903 30.9326 23.7522 30.7591 25.3534 30.0959C26.9546 29.4326 28.3232 28.3095 29.2861 26.8684C29.9511 25.8732 30.4019 24.7573 30.6172 23.5911C30.7777 22.7222 30.0466 22 29.1629 22L23.6 22Z";
+/** The Oxygen "O" mark as an inline SVG that inherits `currentColor`, so it
+*  reads correctly on any surface in light or dark mode. */
+function OxyMark({ className }) {
+	return /* @__PURE__ */ jsx("svg", {
+		viewBox: "0 0 44 44",
+		fill: "currentColor",
+		xmlns: "http://www.w3.org/2000/svg",
+		className,
+		"aria-hidden": "true",
+		children: /* @__PURE__ */ jsx("path", {
+			fillRule: "evenodd",
+			clipRule: "evenodd",
+			d: OXY_MARK_PATH
+		})
+	});
+}
+const FACTORY_PATHS = [
+	"M64.7079 60.8981C66.2159 61.5769 66.42 63.424 64.8831 64.0349C53.9237 68.3911 22.4112 68.2339 12.6945 62.9613C11.4576 62.2901 11.6244 60.6958 12.7979 59.9191C17.3748 56.8895 25.3973 51.7874 31.0332 48.4864C31.9361 47.9575 33.0153 47.8364 34.0043 48.1784C41.0152 50.6027 55.7832 56.8809 64.7079 60.8981Z",
+	"M40.8612 14.4068C40.6005 13.1343 41.6723 12.0367 42.847 12.591C53.7523 17.7375 68.2377 45.3963 68.9964 57.4238C69.0787 58.7282 67.7002 59.4009 66.5675 58.7485C62.2989 56.2901 53.2249 51.0848 48.6689 48.6258C47.5323 48.0123 46.7649 46.8912 46.5938 45.611C45.4688 37.1953 42.1634 20.7629 40.8612 14.4068Z",
+	"M39.2805 32.7689C39.2947 33.8426 38.8352 34.8657 38.0314 35.5777C28.4104 44.1006 18.5237 51.9152 13.0125 56.3133C11.7919 57.2874 10.0954 56.4483 10.3571 54.9087C12.5527 41.9933 25.758 17.8554 35.9571 12.7314C36.9805 12.2172 38.0789 12.9771 38.1857 14.1175C38.5311 17.8049 39.186 25.6228 39.2805 32.7689Z"
+];
+/** The Oxygen Factory mark (three-shard glyph) as an inline SVG in
+*  `currentColor`, so it follows the shell foreground in either theme.
+*  (The web-app's asset files are fixed-color; this inline variant frees
+*  external bundles from carrying those assets.) Decorative — the rail
+*  button supplies the "Oxygen Factory" aria-label. */
+function OxygenFactoryMark({ className }) {
+	return /* @__PURE__ */ jsx("svg", {
+		viewBox: "0 0 80 80",
+		fill: "none",
+		xmlns: "http://www.w3.org/2000/svg",
+		className,
+		"aria-hidden": "true",
+		children: FACTORY_PATHS.map((d) => /* @__PURE__ */ jsx("path", {
+			d,
+			fill: "currentColor"
+		}, d.slice(0, 16)))
+	});
+}
+
+//#endregion
+//#region src/shell/trace.ts
+const str = (v) => typeof v === "string" ? v : void 0;
+const num = (v) => typeof v === "number" ? v : void 0;
+/** "search_catalog" -> "Search Catalog" — matches the web-app pill labels. */
+function prettyToolName(name) {
+	return name.split(/[_-]+/).filter(Boolean).map((w) => w[0].toUpperCase() + w.slice(1)).join(" ");
+}
+/** Compact one-line preview of a tool input (string arg or first string
+*  field of an object), truncated for the trace row. */
+function inputPreview(input, max = 60) {
+	if (typeof input === "string" && /^[[{]/.test(input.trim())) try {
+		return inputPreview(JSON.parse(input), max);
+	} catch {}
+	let text;
+	if (typeof input === "string") text = input;
+	else if (Array.isArray(input)) {
+		const first = input.find((v) => typeof v === "string" && v.trim());
+		text = typeof first === "string" ? first : JSON.stringify(input);
+	} else if (input && typeof input === "object") {
+		for (const v of Object.values(input)) if (typeof v === "string" && v.trim()) {
+			text = v;
+			break;
+		}
+		if (!text) {
+			const json = JSON.stringify(input);
+			text = json === "{}" ? void 0 : json;
+		}
+	}
+	if (!text) return void 0;
+	text = text.replace(/\s+/g, " ").trim();
+	return text.length > max ? `${text.slice(0, max - 1)}…` : text;
+}
+/** Full pretty-printed payload for the expandable row detail: unwraps
+*  pre-serialized JSON strings, indents objects, caps runaway sizes. */
+function prettyPayload(v, max = 2e3) {
+	if (v === null || v === void 0) return void 0;
+	let val = v;
+	if (typeof val === "string") {
+		const t = val.trim();
+		if (!t) return void 0;
+		if (/^[[{]/.test(t)) try {
+			val = JSON.parse(t);
+		} catch {}
+	}
+	const text = typeof val === "string" ? val : JSON.stringify(val, null, 2);
+	if (!text || text === "{}" || text === "[]") return void 0;
+	return text.length > max ? `${text.slice(0, max)}\n…` : text;
+}
+function formatMs(ms) {
+	return ms >= 1e3 ? `${(ms / 1e3).toFixed(1)}s` : `${ms}ms`;
+}
+/** Header meta, same as the web-app trace: LLM call count + total LLM time
+*  folded from `llm_usage` events. */
+function aggregateLlmStats(events) {
+	let calls = 0;
+	let totalMs = 0;
+	for (const ev of events) {
+		if (ev.type !== "llm_usage") continue;
+		calls++;
+		const d = ev.data ?? {};
+		totalMs += num(d.duration_ms) ?? 0;
+	}
+	return {
+		calls,
+		totalMs
+	};
+}
+/** Reconstruct the streamed answer markdown from persisted events —
+*  concatenate the `text_delta` tokens, the same accumulation the live
+*  `useAgentRun` does. Used to rebuild a turn's answer on history restore. */
+function extractAnswer(events) {
+	let out = "";
+	for (const ev of events) {
+		if (ev.type !== "text_delta") continue;
+		const d = ev.data ?? {};
+		if (typeof d.token === "string") out += d.token;
+	}
+	return out;
+}
+/** Pull the clarifying-question prompt from a persisted `awaiting_input`
+*  event (`{ questions: [{ prompt, suggestions }] }`) so a turn that ended
+*  in a suspension restores with its question instead of a blank answer.
+*  Mirrors the live `useAgentRun` clarification parse. */
+function extractClarification(events) {
+	for (const ev of events) {
+		if (ev.type !== "awaiting_input") continue;
+		const d = ev.data ?? {};
+		const first = (Array.isArray(d.questions) ? d.questions : [])[0];
+		if (first && typeof first.prompt === "string") return first.prompt;
+		if (typeof d.question === "string") return d.question;
+	}
+	return null;
+}
+function sqlDetail(d) {
+	const parts = [];
+	const rows = num(d.row_count) ?? (Array.isArray(d.rows) ? d.rows.length : void 0);
+	if (rows !== void 0) parts.push(`${rows} row${rows === 1 ? "" : "s"}`);
+	const ms = num(d.duration_ms);
+	if (ms !== void 0) parts.push(formatMs(ms));
+	return parts.length ? parts.join(" · ") : void 0;
+}
+/** Mark any still-running items in a step as settled — called when the step
+*  closes so a tool/SQL/semantic row whose matching result never arrived
+*  (cancel, error mid-flight, terminal event) doesn't spin forever on a
+*  finished turn. */
+function settleStepItems(step, asError = false) {
+	for (const item of step.items) if (item.running) {
+		item.running = false;
+		if (asError) item.error = true;
+	}
+}
+/** Fold raw SSE events into display steps. Pure — safe to re-run on every
+*  render over the accumulated event array. */
+function buildTraceSteps(events) {
+	const steps = [];
+	let open = null;
+	let n = 0;
+	const id = (prefix) => `${prefix}-${n++}`;
+	const ensureStep = () => {
+		if (open) return open;
+		open = {
+			id: id("step"),
+			label: "Working",
+			status: "running",
+			items: []
+		};
+		steps.push(open);
+		return open;
+	};
+	const lastRunning = (kind) => {
+		for (let i = steps.length - 1; i >= 0; i--) {
+			const items = steps[i].items;
+			for (let j = items.length - 1; j >= 0; j--) {
+				const item = items[j];
+				if (item.kind === kind && item.running) return item;
+			}
+		}
+	};
+	for (const ev of events) {
+		const d = ev.data ?? {};
+		switch (ev.type) {
+			case "step_start":
+				if (open) {
+					settleStepItems(open);
+					open.status = "done";
+				}
+				open = {
+					id: id("step"),
+					label: str(d.label) ?? "Step",
+					summary: str(d.summary),
+					status: "running",
+					items: []
+				};
+				steps.push(open);
+				break;
+			case "step_end": {
+				if (!open) break;
+				const outcome = str(d.outcome);
+				open.status = outcome === "failed" ? "failed" : outcome === "suspended" ? "suspended" : "done";
+				settleStepItems(open, open.status === "failed");
+				open = null;
+				break;
+			}
+			case "step_summary_update": {
+				const summary = str(d.summary);
+				if (open && summary) open.summary = summary;
+				break;
+			}
+			case "tool_call": {
+				const name = str(d.name) ?? "tool";
+				ensureStep().items.push({
+					id: id("tool"),
+					kind: "tool",
+					label: prettyToolName(name),
+					preview: inputPreview(d.input),
+					input: prettyPayload(d.input),
+					running: true
+				});
+				break;
+			}
+			case "tool_result": {
+				const item = lastRunning("tool");
+				if (item) {
+					item.running = false;
+					item.error = d.is_error === true;
+					item.output = prettyPayload(d.output);
+					const ms = num(d.duration_ms);
+					if (ms !== void 0) item.detail = formatMs(ms);
+				}
+				break;
+			}
+			case "thinking_start":
+				ensureStep().items.push({
+					id: id("think"),
+					kind: "thinking",
+					label: "Thinking",
+					text: "",
+					running: true
+				});
+				break;
+			case "thinking_token": {
+				const item = lastRunning("thinking");
+				if (item) item.text = (item.text ?? "") + (str(d.token) ?? "");
+				break;
+			}
+			case "thinking_end": {
+				const item = lastRunning("thinking");
+				if (item) item.running = false;
+				break;
+			}
+			case "semantic_shortcut_attempted":
+				ensureStep().items.push({
+					id: id("sem"),
+					kind: "tool",
+					label: "Compile semantic query",
+					input: prettyPayload(d),
+					running: true
+				});
+				break;
+			case "semantic_shortcut_resolved": {
+				const item = lastRunning("tool");
+				if (item) {
+					item.running = false;
+					item.output = prettyPayload(d.sql ?? d);
+				}
+				break;
+			}
+			case "query_executed": {
+				const failed = d.success === false;
+				ensureStep().items.push({
+					id: id("sql"),
+					kind: "sql",
+					label: failed ? "Query failed" : "Query",
+					detail: failed ? str(d.error) ?? void 0 : sqlDetail(d),
+					input: prettyPayload(d.query ?? d.sql),
+					output: failed ? prettyPayload(d.error) : void 0,
+					error: failed
+				});
+				break;
+			}
+			case "verified_sql":
+				ensureStep().items.push({
+					id: id("sql"),
+					kind: "sql",
+					label: "Verified query",
+					detail: sqlDetail(d),
+					input: prettyPayload(d.query ?? d.sql)
+				});
+				break;
+			case "schema_resolved": {
+				const tables = Array.isArray(d.tables) ? d.tables.length : void 0;
+				ensureStep().items.push({
+					id: id("schema"),
+					kind: "note",
+					label: "Schema resolved",
+					detail: tables ? `${tables} table${tables === 1 ? "" : "s"}` : void 0
+				});
+				break;
+			}
+			case "recovery_resumed":
+				if (open) {
+					settleStepItems(open);
+					open.status = "done";
+					open = null;
+				}
+				steps.push({
+					id: id("step"),
+					label: "Resuming",
+					summary: str(d.message) ?? "Resuming from server restart",
+					status: "done",
+					items: []
+				});
+				break;
+			case "awaiting_input":
+				if (open) {
+					settleStepItems(open);
+					open.status = "suspended";
+					open = null;
+				}
+				break;
+			case "error":
+			case "failed":
+				if (open) {
+					settleStepItems(open, true);
+					open.status = "failed";
+					open = null;
+				}
+				break;
+			case "done":
+			case "cancelled":
+				if (open) {
+					settleStepItems(open);
+					open.status = "done";
+					open = null;
+				}
+				break;
+			default: break;
+		}
+	}
+	return steps;
+}
+
+//#endregion
+//#region src/shell/ReasoningTrace.tsx
+function StatusIcon({ status }) {
+	if (status === "running") return /* @__PURE__ */ jsx("span", {
+		role: "status",
+		className: "oxy-trace__spin",
+		"aria-label": "running"
+	});
+	if (status === "failed") return /* @__PURE__ */ jsx("span", {
+		className: "oxy-trace__icon oxy-trace__icon--fail",
+		children: "✕"
+	});
+	if (status === "suspended") return /* @__PURE__ */ jsx("span", {
+		className: "oxy-trace__icon oxy-trace__icon--wait",
+		children: "…"
+	});
+	return /* @__PURE__ */ jsx("span", {
+		className: "oxy-trace__icon oxy-trace__icon--ok",
+		children: "✓"
+	});
+}
+function ChevronIcon({ open }) {
+	return /* @__PURE__ */ jsx("svg", {
+		width: "12",
+		height: "12",
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: "2",
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		"aria-hidden": "true",
+		style: {
+			transform: open ? "rotate(90deg)" : void 0,
+			transition: "transform 0.15s"
+		},
+		children: /* @__PURE__ */ jsx("path", { d: "m9 18 6-6-6-6" })
+	});
+}
+function TraceItemRows({ step, itemToggles, onToggleItem }) {
+	return /* @__PURE__ */ jsx("div", {
+		className: "oxy-trace__items",
+		children: step.items.map((item) => {
+			if (item.kind === "thinking") return (item.text ?? "").trim() ? /* @__PURE__ */ jsx("p", {
+				className: "oxy-trace__think",
+				children: item.text
+			}, item.id) : null;
+			const hasDetail = Boolean(item.input || item.output);
+			const itemOpen = hasDetail && (itemToggles[item.id] ?? item.running === true);
+			const row = /* @__PURE__ */ jsxs(Fragment$1, { children: [
+				item.running && /* @__PURE__ */ jsx("span", {
+					role: "status",
+					className: "oxy-trace__spin oxy-trace__spin--sm",
+					"aria-label": "running"
+				}),
+				/* @__PURE__ */ jsx("span", {
+					className: "oxy-trace__row-label",
+					children: item.label
+				}),
+				item.preview && /* @__PURE__ */ jsx("span", {
+					className: "oxy-trace__row-preview",
+					children: item.preview
+				}),
+				item.detail && /* @__PURE__ */ jsx("span", {
+					className: "oxy-trace__row-detail",
+					children: item.detail
+				})
+			] });
+			return /* @__PURE__ */ jsxs("div", {
+				className: "oxy-trace__item",
+				children: [hasDetail ? /* @__PURE__ */ jsxs("button", {
+					type: "button",
+					className: cx("oxy-trace__row", "oxy-trace__row--btn", item.error && "oxy-trace__row--error"),
+					onClick: () => onToggleItem(item.id, !itemOpen),
+					"aria-expanded": itemOpen,
+					"data-testid": `reasoning-pill-${item.label.toLowerCase().replace(/[^a-z0-9]+/g, "-")}`,
+					children: [row, /* @__PURE__ */ jsx("span", {
+						className: "oxy-trace__step-chevron",
+						children: /* @__PURE__ */ jsx(ChevronIcon, { open: itemOpen })
+					})]
+				}) : /* @__PURE__ */ jsx("div", {
+					className: cx("oxy-trace__row", item.error && "oxy-trace__row--error"),
+					"data-testid": `reasoning-pill-${item.label.toLowerCase().replace(/[^a-z0-9]+/g, "-")}`,
+					children: row
+				}), itemOpen && /* @__PURE__ */ jsxs("div", {
+					className: "oxy-trace__payloads",
+					children: [item.input && /* @__PURE__ */ jsx("pre", {
+						className: "oxy-trace__payload",
+						children: item.input
+					}), item.output && /* @__PURE__ */ jsx("pre", {
+						className: "oxy-trace__payload oxy-trace__payload--out",
+						children: item.output
+					})]
+				})]
+			}, item.id);
+		})
+	});
+}
+/** Renders nothing when there are no steps (runs whose stream carries no
+*  step events degrade to the plain answer, same as before). */
+function ReasoningTrace({ steps, streaming = false, llm, className }) {
+	const [userToggled, setUserToggled] = useState(null);
+	const [stepToggles, setStepToggles] = useState({});
+	const [itemToggles, setItemToggles] = useState({});
+	const runKey = steps[0]?.id ?? "";
+	const [prevRunKey, setPrevRunKey] = useState(runKey);
+	if (prevRunKey !== runKey) {
+		setPrevRunKey(runKey);
+		setUserToggled(null);
+		setStepToggles({});
+		setItemToggles({});
+	}
+	const open = userToggled ?? streaming;
+	const meta = useMemo(() => {
+		const parts = [];
+		if (llm && llm.calls > 0) {
+			parts.push(`${llm.calls} LLM ${llm.calls === 1 ? "call" : "calls"}`);
+			if (llm.totalMs > 0) parts.push(formatMs(llm.totalMs));
+		}
+		parts.push(`${steps.length} step${steps.length === 1 ? "" : "s"}`);
+		if (steps.some((s) => s.status === "failed")) parts.push("failed");
+		return parts.join(" · ");
+	}, [llm, steps]);
+	if (steps.length === 0) return null;
+	return /* @__PURE__ */ jsxs("div", {
+		className: cx("oxy-trace", className),
+		"data-run": runKey,
+		children: [/* @__PURE__ */ jsxs("button", {
+			type: "button",
+			className: "oxy-trace__head",
+			onClick: () => setUserToggled(!open),
+			"aria-expanded": open,
+			children: [
+				/* @__PURE__ */ jsx(ChevronIcon, { open }),
+				/* @__PURE__ */ jsx("span", {
+					className: "oxy-trace__title",
+					children: "Reasoning trace"
+				}),
+				/* @__PURE__ */ jsx("span", {
+					className: "oxy-trace__meta",
+					children: meta
+				}),
+				streaming && /* @__PURE__ */ jsx("span", {
+					role: "status",
+					className: "oxy-trace__spin",
+					"aria-label": "running"
+				})
+			]
+		}), open && /* @__PURE__ */ jsx("div", {
+			className: "oxy-trace__body",
+			children: steps.map((step) => {
+				const stepOpen = stepToggles[step.id] ?? step.status === "running";
+				if (step.items.length === 0) return /* @__PURE__ */ jsx("div", {
+					className: "oxy-trace__step",
+					children: /* @__PURE__ */ jsxs("div", {
+						className: "oxy-trace__step-row",
+						children: [
+							/* @__PURE__ */ jsx(StatusIcon, { status: step.status }),
+							/* @__PURE__ */ jsx("span", {
+								className: "oxy-trace__label",
+								children: step.label
+							}),
+							step.summary && /* @__PURE__ */ jsx("span", {
+								className: "oxy-trace__summary",
+								children: step.summary
+							})
+						]
+					})
+				}, step.id);
+				return /* @__PURE__ */ jsxs("div", {
+					className: "oxy-trace__step",
+					children: [/* @__PURE__ */ jsxs("button", {
+						type: "button",
+						className: "oxy-trace__step-row oxy-trace__step-row--btn",
+						onClick: () => setStepToggles((t) => ({
+							...t,
+							[step.id]: !stepOpen
+						})),
+						"aria-expanded": stepOpen,
+						children: [
+							/* @__PURE__ */ jsx(StatusIcon, { status: step.status }),
+							/* @__PURE__ */ jsx("span", {
+								className: "oxy-trace__label",
+								children: step.label
+							}),
+							step.summary && /* @__PURE__ */ jsx("span", {
+								className: "oxy-trace__summary",
+								children: step.summary
+							}),
+							!stepOpen && /* @__PURE__ */ jsxs("span", {
+								className: "oxy-trace__count",
+								children: [
+									step.items.length,
+									" action",
+									step.items.length === 1 ? "" : "s"
+								]
+							}),
+							/* @__PURE__ */ jsx("span", {
+								className: "oxy-trace__step-chevron",
+								children: /* @__PURE__ */ jsx(ChevronIcon, { open: stepOpen })
+							})
+						]
+					}), stepOpen && /* @__PURE__ */ jsx(TraceItemRows, {
+						step,
+						itemToggles,
+						onToggleItem: (id, next) => setItemToggles((t) => ({
+							...t,
+							[id]: next
+						}))
+					})]
+				}, step.id);
+			})
+		})]
+	});
+}
+
+//#endregion
+//#region src/shell/threadHistory.ts
+/**
+* List the viewer's persistent chat threads for the current project.
+* Non-fatal on failure (older server / no session): returns an empty
+* list so the dock falls back to session-only history.
+*/
+function useThreadHistory() {
+	const { projectId, fetcher } = useOxyApp();
+	const [state, setState] = React.useState({
+		threads: [],
+		loading: false,
+		error: null
+	});
+	const [nonce, setNonce] = React.useState(0);
+	const refetch = React.useCallback(() => setNonce((n) => n + 1), []);
+	React.useEffect(() => {
+		if (!projectId) {
+			setState({
+				threads: [],
+				loading: false,
+				error: null
+			});
+			return;
+		}
+		let cancelled = false;
+		setState((s) => ({
+			...s,
+			loading: true
+		}));
+		fetcher(`/api/projects/${projectId}/threads`, { method: "GET" }).then(async (resp) => {
+			if (!resp.ok) throw new Error(`threads list failed: HTTP ${resp.status}`);
+			const threads = await resp.json();
+			if (!cancelled) setState({
+				threads,
+				loading: false,
+				error: null
+			});
+		}).catch((e) => {
+			const error = e instanceof Error ? e : new Error(String(e));
+			getOxyAppLogger().log("warn", "thread history unavailable", { error: error.message });
+			if (!cancelled) setState({
+				threads: [],
+				loading: false,
+				error
+			});
+		});
+		return () => {
+			cancelled = true;
+		};
+	}, [
+		projectId,
+		fetcher,
+		nonce
+	]);
+	return {
+		...state,
+		refetch
+	};
+}
+/**
+* Fetch a thread's transcript for restore. Throws on failure so the
+* caller can surface a toast / fall back.
+*/
+async function fetchThreadTranscript(fetcher, projectId, threadId) {
+	const resp = await fetcher(`/api/projects/${projectId}/threads/${threadId}`, { method: "GET" });
+	if (!resp.ok) throw new Error(`thread transcript failed: HTTP ${resp.status}`);
+	return await resp.json();
+}
+
+//#endregion
+//#region src/shell/AskDock.tsx
+function CloseIcon() {
+	return /* @__PURE__ */ jsxs("svg", {
+		width: "14",
+		height: "14",
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: "2",
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		"aria-hidden": "true",
+		children: [/* @__PURE__ */ jsx("path", { d: "M18 6 6 18" }), /* @__PURE__ */ jsx("path", { d: "m6 6 12 12" })]
+	});
+}
+function PlusIcon() {
+	return /* @__PURE__ */ jsxs("svg", {
+		width: "15",
+		height: "15",
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: "2",
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		"aria-hidden": "true",
+		children: [/* @__PURE__ */ jsx("path", { d: "M5 12h14" }), /* @__PURE__ */ jsx("path", { d: "M12 5v14" })]
+	});
+}
+function HistoryIcon() {
+	return /* @__PURE__ */ jsxs("svg", {
+		width: "14",
+		height: "14",
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: "2",
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		"aria-hidden": "true",
+		children: [
+			/* @__PURE__ */ jsx("path", { d: "M3 12a9 9 0 1 0 9-9 9.75 9.75 0 0 0-6.74 2.74L3 8" }),
+			/* @__PURE__ */ jsx("path", { d: "M3 3v5h5" }),
+			/* @__PURE__ */ jsx("path", { d: "M12 7v5l4 2" })
+		]
+	});
+}
+function SearchIcon() {
+	return /* @__PURE__ */ jsxs("svg", {
+		width: "14",
+		height: "14",
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: "2",
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		"aria-hidden": "true",
+		children: [/* @__PURE__ */ jsx("circle", {
+			cx: "11",
+			cy: "11",
+			r: "8"
+		}), /* @__PURE__ */ jsx("path", { d: "m21 21-4.3-4.3" })]
+	});
+}
+function ThreadIcon() {
+	return /* @__PURE__ */ jsxs("svg", {
+		width: "15",
+		height: "15",
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: "2",
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		"aria-hidden": "true",
+		children: [/* @__PURE__ */ jsx("path", { d: "M14 9a2 2 0 0 1-2 2H6l-4 4V4a2 2 0 0 1 2-2h8a2 2 0 0 1 2 2z" }), /* @__PURE__ */ jsx("path", { d: "M18 9h2a2 2 0 0 1 2 2v11l-4-4h-6a2 2 0 0 1-2-2v-1" })]
+	});
+}
+function ExternalIcon() {
+	return /* @__PURE__ */ jsxs("svg", {
+		width: "14",
+		height: "14",
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: "2",
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		"aria-hidden": "true",
+		children: [
+			/* @__PURE__ */ jsx("path", { d: "M15 3h6v6" }),
+			/* @__PURE__ */ jsx("path", { d: "M10 14 21 3" }),
+			/* @__PURE__ */ jsx("path", { d: "M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6" })
+		]
+	});
+}
+function ArrowUpIcon() {
+	return /* @__PURE__ */ jsxs("svg", {
+		width: "14",
+		height: "14",
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: "2",
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		"aria-hidden": "true",
+		children: [/* @__PURE__ */ jsx("path", { d: "m5 12 7-7 7 7" }), /* @__PURE__ */ jsx("path", { d: "M12 19V5" })]
+	});
+}
+function StopIcon() {
+	return /* @__PURE__ */ jsx("svg", {
+		width: "12",
+		height: "12",
+		viewBox: "0 0 24 24",
+		fill: "currentColor",
+		"aria-hidden": "true",
+		children: /* @__PURE__ */ jsx("rect", {
+			x: "6",
+			y: "6",
+			width: "12",
+			height: "12",
+			rx: "2"
+		})
+	});
+}
+function chartsFrom(events) {
+	return events.filter((ev) => ev.type === "chart_rendered").map((ev) => ev.data).filter((b) => b?.config && Array.isArray(b.columns) && Array.isArray(b.rows));
+}
+/** History label: a relative "N minutes/hours/days ago" for when the
+*  conversation was started. */
+function formatHistoryTime(iso) {
+	const d = new Date(iso);
+	if (Number.isNaN(d.getTime())) return "";
+	const s = Math.max(0, Math.round((Date.now() - d.getTime()) / 1e3));
+	if (s < 45) return "just now";
+	const min = Math.round(s / 60);
+	if (min < 60) return `${min} minute${min === 1 ? "" : "s"} ago`;
+	const hr = Math.round(s / 3600);
+	if (hr < 24) return `${hr} hour${hr === 1 ? "" : "s"} ago`;
+	const day = Math.round(s / 86400);
+	if (day < 30) return `${day} day${day === 1 ? "" : "s"} ago`;
+	const mo = Math.round(day / 30);
+	if (mo < 12) return `${mo} month${mo === 1 ? "" : "s"} ago`;
+	const yr = Math.round(day / 365);
+	return `${yr} year${yr === 1 ? "" : "s"} ago`;
+}
+/** How many history rows to show before the "Show more" button. */
+const HISTORY_PAGE_SIZE = 12;
+/** Rebuild a completed turn from a transcript turn's processed events —
+*  identical to what the live dock accumulates during a run. */
+function turnFromEvents(question, events) {
+	return {
+		question,
+		answer: extractAnswer(events) || extractClarification(events) || null,
+		charts: chartsFrom(events),
+		steps: buildTraceSteps(events),
+		llm: aggregateLlmStats(events)
+	};
+}
+/**
+* The Ask Oxygen drawer. Keep it mounted and toggle `open` — the
+* transcript survives close/reopen, matching the web-app dock.
+*/
+function AskDock({ agentId, workspaceName, suggestions = [], threadsHref, open, onClose, className }) {
+	const run = useAgentRun({ agentId });
+	const { projectId, fetcher } = useOxyApp();
+	const { threads: serverThreads, refetch: refetchHistory } = useThreadHistory();
+	const [turns, setTurns] = React.useState([]);
+	const [pending, setPending] = React.useState(null);
+	const [draft, setDraft] = React.useState("");
+	const [threadId, setThreadId] = React.useState(null);
+	const [history, setHistory] = React.useState([]);
+	const [historyOpen, setHistoryOpen] = React.useState(false);
+	const [historyQuery, setHistoryQuery] = React.useState("");
+	const [historyShown, setHistoryShown] = React.useState(HISTORY_PAGE_SIZE);
+	const [restoring, setRestoring] = React.useState(false);
+	const scrollRef = React.useRef(null);
+	const restoreGenRef = React.useRef(0);
+	const startedAtRef = React.useRef(null);
+	const busy = run.state === "running";
+	const liveSteps = React.useMemo(() => buildTraceSteps(run.events), [run.events]);
+	const liveLlm = React.useMemo(() => aggregateLlmStats(run.events), [run.events]);
+	const liveCharts = React.useMemo(() => chartsFrom(run.events), [run.events]);
+	React.useEffect(() => {
+		if (run.threadId) setThreadId(run.threadId);
+	}, [run.threadId]);
+	const finalizedPendingTurn = () => pending === null ? null : {
+		question: pending,
+		answer: run.answer ?? run.clarification,
+		charts: liveCharts,
+		steps: liveSteps,
+		llm: liveLlm
+	};
+	/** The current conversation as a snapshot, or null when it's empty. */
+	const snapshotCurrent = () => {
+		const finalized = finalizedPendingTurn();
+		const all = finalized ? [...turns, finalized] : turns;
+		if (all.length === 0) return null;
+		return {
+			id: threadId ?? all[0].question,
+			title: all[0].question,
+			turns: all,
+			threadId,
+			createdAt: startedAtRef.current ?? (/* @__PURE__ */ new Date()).toISOString()
+		};
+	};
+	const resetToEmpty = () => {
+		restoreGenRef.current += 1;
+		run.cancel();
+		setTurns([]);
+		setPending(null);
+		setDraft("");
+		setThreadId(null);
+		startedAtRef.current = null;
+	};
+	const newChat = () => {
+		const snap = snapshotCurrent();
+		if (snap) setHistory((h) => [snap, ...h.filter((c) => c.id !== snap.id)]);
+		resetToEmpty();
+		setHistoryOpen(false);
+	};
+	const openConversation = (conv) => {
+		restoreGenRef.current += 1;
+		const snap = snapshotCurrent();
+		setHistory((h) => {
+			const rest = h.filter((c) => c.id !== conv.id && (!snap || c.id !== snap.id));
+			return snap && snap.id !== conv.id ? [snap, ...rest] : rest;
+		});
+		run.cancel();
+		setTurns(conv.turns);
+		setPending(null);
+		setDraft("");
+		setThreadId(conv.threadId);
+		setHistoryOpen(false);
+	};
+	/** Restore a persistent (server) thread: archive the current chat, then
+	*  fetch + rebuild the transcript. Follow-ups resume the same thread. */
+	const openServerThread = async (id) => {
+		if (!projectId) return;
+		const gen = restoreGenRef.current += 1;
+		const snap = snapshotCurrent();
+		if (snap && snap.id !== id) setHistory((h) => [snap, ...h.filter((c) => c.id !== snap.id)]);
+		run.cancel();
+		setTurns([]);
+		setPending(null);
+		setDraft("");
+		setThreadId(id);
+		startedAtRef.current = serverThreads.find((t) => t.id === id)?.created_at ?? (/* @__PURE__ */ new Date()).toISOString();
+		setHistoryOpen(false);
+		setRestoring(true);
+		try {
+			const transcript = await fetchThreadTranscript(fetcher, projectId, id);
+			if (restoreGenRef.current !== gen) return;
+			setTurns(transcript.turns.map((t) => turnFromEvents(t.question, t.events)));
+		} catch {} finally {
+			if (restoreGenRef.current === gen) setRestoring(false);
+		}
+	};
+	const send = (raw) => {
+		const question = raw.trim();
+		if (!question || busy) return;
+		restoreGenRef.current += 1;
+		if (startedAtRef.current === null) startedAtRef.current = (/* @__PURE__ */ new Date()).toISOString();
+		if (pending !== null) {
+			const finalized = finalizedPendingTurn();
+			if (finalized) setTurns((t) => [...t, finalized]);
+		}
+		setPending(question);
+		setDraft("");
+		run.ask(question, threadId ? { threadId } : void 0);
+	};
+	React.useEffect(() => {
+		const el = scrollRef.current;
+		if (!el) return;
+		if (el.scrollHeight - el.scrollTop - el.clientHeight < 120) el.scrollTo({ top: el.scrollHeight });
+	});
+	const empty = pending === null && turns.length === 0;
+	const canNewChat = !empty;
+	const currentId = threadId ?? turns[0]?.question ?? pending ?? null;
+	const historyEntries = [...history.map((c) => ({
+		id: c.id,
+		title: c.title,
+		createdAt: c.createdAt,
+		active: c.id === currentId,
+		onOpen: c.id === currentId ? () => setHistoryOpen(false) : () => openConversation(c)
+	})), ...serverThreads.filter((t) => !history.some((c) => c.id === t.id)).map((t) => ({
+		id: t.id,
+		title: t.title,
+		createdAt: t.created_at,
+		active: t.id === currentId,
+		onOpen: t.id === currentId ? () => setHistoryOpen(false) : () => void openServerThread(t.id)
+	}))];
+	if (!empty && currentId != null && !historyEntries.some((e) => e.id === currentId)) historyEntries.push({
+		id: currentId,
+		title: turns[0]?.question ?? pending ?? currentId,
+		createdAt: startedAtRef.current ?? (/* @__PURE__ */ new Date()).toISOString(),
+		active: true,
+		onOpen: () => setHistoryOpen(false)
+	});
+	historyEntries.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+	const q = historyQuery.trim().toLowerCase();
+	const filteredEntries = q ? historyEntries.filter((e) => e.title.toLowerCase().includes(q)) : historyEntries;
+	const visibleEntries = filteredEntries.slice(0, historyShown);
+	const placeholder = run.state === "needs_clarification" ? "Reply…" : pending !== null ? "Ask a follow-up…" : `Ask Oxygen anything about ${workspaceName ?? "your workspace"}…`;
+	return /* @__PURE__ */ jsxs("aside", {
+		className: cx("oxy-shell-scope oxy-askdock", !open && "oxy-askdock--closed", className),
+		"aria-label": "Ask Oxygen",
+		"aria-hidden": !open,
+		children: [/* @__PURE__ */ jsxs("header", {
+			className: "oxy-askdock__head",
+			children: [
+				/* @__PURE__ */ jsx(OxyMark, { className: "oxy-askdock__mark" }),
+				/* @__PURE__ */ jsx("span", {
+					className: "oxy-askdock__title",
+					children: "Ask Oxygen"
+				}),
+				/* @__PURE__ */ jsxs("span", {
+					className: "oxy-askdock__actions",
+					children: [
+						/* @__PURE__ */ jsx("button", {
+							type: "button",
+							className: "oxy-askdock__iconbtn",
+							onClick: newChat,
+							disabled: !canNewChat,
+							"data-testid": "askdock-new-chat",
+							"aria-label": "New chat",
+							title: "New chat",
+							children: /* @__PURE__ */ jsx(PlusIcon, {})
+						}),
+						/* @__PURE__ */ jsx("button", {
+							type: "button",
+							className: cx("oxy-askdock__iconbtn", historyOpen && "oxy-askdock__iconbtn--active"),
+							onClick: () => {
+								const next = !historyOpen;
+								setHistoryOpen(next);
+								if (next) {
+									refetchHistory();
+									setHistoryQuery("");
+									setHistoryShown(HISTORY_PAGE_SIZE);
+								}
+							},
+							"data-testid": "askdock-history",
+							"aria-label": "Chat history",
+							"aria-expanded": historyOpen,
+							title: "Chat history",
+							children: /* @__PURE__ */ jsx(HistoryIcon, {})
+						}),
+						threadsHref && /* @__PURE__ */ jsx("a", {
+							className: "oxy-askdock__iconbtn",
+							href: threadsHref,
+							"aria-label": "Open chat in Oxygen",
+							title: "Open chat in Oxygen",
+							children: /* @__PURE__ */ jsx(ExternalIcon, {})
+						}),
+						/* @__PURE__ */ jsx("button", {
+							type: "button",
+							className: "oxy-askdock__iconbtn",
+							onClick: onClose,
+							"aria-label": "Close Ask Oxygen",
+							children: /* @__PURE__ */ jsx(CloseIcon, {})
+						})
+					]
+				})
+			]
+		}), historyOpen ? /* @__PURE__ */ jsxs("div", {
+			className: "oxy-askdock__history",
+			"data-testid": "askdock-history-panel",
+			children: [/* @__PURE__ */ jsxs("div", {
+				className: "oxy-askdock__history-search",
+				children: [/* @__PURE__ */ jsx(SearchIcon, {}), /* @__PURE__ */ jsx("input", {
+					type: "text",
+					className: "oxy-askdock__history-searchinput",
+					placeholder: "Search threads…",
+					value: historyQuery,
+					onChange: (e) => {
+						setHistoryQuery(e.target.value);
+						setHistoryShown(HISTORY_PAGE_SIZE);
+					},
+					"aria-label": "Search threads"
+				})]
+			}), visibleEntries.length === 0 ? /* @__PURE__ */ jsx("p", {
+				className: "oxy-askdock__history-empty",
+				children: historyQuery ? "No matching chats." : "No previous chats yet."
+			}) : /* @__PURE__ */ jsxs(Fragment$1, { children: [visibleEntries.map((entry) => /* @__PURE__ */ jsxs("button", {
+				type: "button",
+				className: cx("oxy-askdock__history-item", entry.active && "oxy-askdock__history-item--active"),
+				onClick: entry.onOpen,
+				title: entry.title,
+				"aria-current": entry.active ? "true" : void 0,
+				children: [
+					/* @__PURE__ */ jsx("span", {
+						className: "oxy-askdock__history-icon",
+						children: /* @__PURE__ */ jsx(ThreadIcon, {})
+					}),
+					/* @__PURE__ */ jsx("span", {
+						className: "oxy-askdock__history-title",
+						children: entry.title
+					}),
+					/* @__PURE__ */ jsx("span", {
+						className: "oxy-askdock__history-time",
+						children: formatHistoryTime(entry.createdAt)
+					})
+				]
+			}, entry.id)), filteredEntries.length > visibleEntries.length && /* @__PURE__ */ jsx("button", {
+				type: "button",
+				className: "oxy-askdock__history-more",
+				onClick: () => setHistoryShown((n) => n + HISTORY_PAGE_SIZE),
+				children: "Show more"
+			})] })]
+		}) : /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsxs("div", {
+			className: "oxy-askdock__scroll",
+			ref: scrollRef,
+			children: [
+				restoring && /* @__PURE__ */ jsx("p", {
+					className: "oxy-askdock__history-empty",
+					children: "Loading conversation…"
+				}),
+				empty && !restoring && suggestions.length > 0 && /* @__PURE__ */ jsx("div", {
+					className: "oxy-askdock__chips",
+					children: suggestions.map((s) => /* @__PURE__ */ jsx("button", {
+						type: "button",
+						className: "oxy-askdock__chip",
+						onClick: () => send(s),
+						children: s
+					}, s))
+				}),
+				turns.map((t, i) => /* @__PURE__ */ jsxs("div", {
+					className: "oxy-askdock__turn",
+					children: [
+						/* @__PURE__ */ jsx("div", {
+							className: "oxy-askdock__q",
+							children: t.question
+						}),
+						/* @__PURE__ */ jsx(ReasoningTrace, {
+							steps: t.steps,
+							llm: t.llm
+						}),
+						t.charts.map((c, ci) => /* @__PURE__ */ jsx(AnswerChart, { block: c }, `${ci}-${c.config.title ?? c.config.chart_type}`)),
+						/* @__PURE__ */ jsx(OxyAnswer, {
+							answer: t.answer,
+							state: "done",
+							threadUrl: null
+						})
+					]
+				}, `${i}-${t.question}`)),
+				pending !== null && /* @__PURE__ */ jsxs("div", {
+					className: "oxy-askdock__turn",
+					children: [
+						/* @__PURE__ */ jsx("div", {
+							className: "oxy-askdock__q",
+							children: pending
+						}),
+						/* @__PURE__ */ jsx(ReasoningTrace, {
+							steps: liveSteps,
+							streaming: busy,
+							llm: liveLlm
+						}),
+						liveCharts.map((c, ci) => /* @__PURE__ */ jsx(AnswerChart, { block: c }, `${ci}-${c.config.title ?? c.config.chart_type}`)),
+						/* @__PURE__ */ jsx(OxyAnswer, {
+							answer: run.answer,
+							state: run.state,
+							clarification: run.clarification,
+							error: run.error,
+							threadUrl: null
+						})
+					]
+				})
+			]
+		}), /* @__PURE__ */ jsxs("form", {
+			className: "oxy-askdock__composer",
+			onSubmit: (e) => {
+				e.preventDefault();
+				send(draft);
+			},
+			children: [/* @__PURE__ */ jsx("textarea", {
+				className: "oxy-askdock__input",
+				rows: 3,
+				placeholder,
+				value: draft,
+				onChange: (e) => setDraft(e.target.value),
+				onKeyDown: (e) => {
+					if (e.key === "Enter" && !e.shiftKey) {
+						e.preventDefault();
+						send(draft);
+					}
+				}
+			}), /* @__PURE__ */ jsx("div", {
+				className: "oxy-askdock__composer-row",
+				children: busy ? /* @__PURE__ */ jsx("button", {
+					type: "button",
+					className: "oxy-askdock__send",
+					onClick: run.cancel,
+					"aria-label": "Stop generating",
+					children: /* @__PURE__ */ jsx(StopIcon, {})
+				}) : /* @__PURE__ */ jsx("button", {
+					type: "submit",
+					className: "oxy-askdock__send",
+					disabled: !draft.trim(),
+					"aria-label": "Send",
+					children: /* @__PURE__ */ jsx(ArrowUpIcon, {})
+				})
+			})]
+		})] })]
+	});
+}
+
+//#endregion
+//#region src/shell/logoUrl.ts
+/** URL of the workspace logo endpoint (org-uploaded logo, falling back to
+*  the code-first file). Consumers render an `<img>` and fall back on error.
+*  `apiBaseUrl` is the API root (e.g. `"/api"` same-origin, or an absolute
+*  base in dev); pass `version` (the org's `updated_at`) to bust the cache
+*  after an upload/remove. */
+const workspaceLogoUrl = (apiBaseUrl, workspaceId, version) => {
+	const base = `${apiBaseUrl.replace(/\/$/, "")}/${workspaceId}/logo`;
+	return version ? `${base}?v=${encodeURIComponent(version)}` : base;
+};
+
+//#endregion
+//#region src/shell/portal.tsx
+/**
+* Floating shell content (tooltips) portals into the nearest shell scope
+* element instead of `document.body`, so the `oxy-shell-scope` tokens and a
+* host-applied `.dark` ancestor keep applying to it. Falls back to the
+* default body portal when no provider is mounted (standalone `ShellRail`
+* under a host that themes `<body>` itself).
+*/
+const ShellPortalContext = React.createContext(null);
+/** Track the portal container element for descendants of a shell root. */
+function useShellPortalContainer() {
+	const [container, setContainer] = React.useState(null);
+	return {
+		container,
+		setContainer
+	};
+}
+
+//#endregion
+//#region src/shell/Tooltip.tsx
+/**
+* Hover tooltip for shell controls. Mirrors the web-app's Radix tooltip
+* (zero delay, side arrow, `--zinc-200`/muted surface) but portals into the
+* shell scope so the namespaced tokens and dark-mode class reach it.
+*/
+function ShellTooltip({ content, side = "right", children }) {
+	const container = React.useContext(ShellPortalContext);
+	return /* @__PURE__ */ jsx(TooltipPrimitive.Provider, {
+		delayDuration: 0,
+		children: /* @__PURE__ */ jsxs(TooltipPrimitive.Root, { children: [/* @__PURE__ */ jsx(TooltipPrimitive.Trigger, {
+			asChild: true,
+			children
+		}), /* @__PURE__ */ jsx(TooltipPrimitive.Portal, {
+			container: container ?? void 0,
+			children: /* @__PURE__ */ jsxs(TooltipPrimitive.Content, {
+				side,
+				sideOffset: 0,
+				className: "oxy-shell-scope oxy-shell-tooltip",
+				children: [content, /* @__PURE__ */ jsx(TooltipPrimitive.Arrow, { className: "oxy-shell-tooltip__arrow" })]
+			})
+		})] })
+	});
+}
+
+//#endregion
+//#region src/shell/ShellRail.tsx
+function RailEntry({ item }) {
+	const [failedUrl, setFailedUrl] = useState(null);
+	const content = item.imageUrl && failedUrl !== item.imageUrl ? /* @__PURE__ */ jsx("img", {
+		src: item.imageUrl,
+		alt: "",
+		onError: () => setFailedUrl(item.imageUrl ?? null),
+		className: "oxy-rail__item-img"
+	}) : item.icon ?? /* @__PURE__ */ jsx("span", {
+		className: "oxy-rail__item-letter",
+		children: item.letter
+	});
+	const className = cx("oxy-rail__item", item.active && "oxy-rail__item--active");
+	const ariaCurrent = item.active ? "page" : void 0;
+	const entry = item.href ? /* @__PURE__ */ jsx("a", {
+		href: item.href,
+		"data-testid": item.testId,
+		"aria-label": item.label,
+		"aria-current": ariaCurrent,
+		className,
+		children: content
+	}) : /* @__PURE__ */ jsx("button", {
+		type: "button",
+		onClick: item.onSelect,
+		"data-testid": item.testId,
+		"aria-label": item.label,
+		"aria-current": ariaCurrent,
+		className,
+		children: content
+	});
+	return /* @__PURE__ */ jsx(ShellTooltip, {
+		content: item.tooltip ?? item.label,
+		children: entry
+	});
+}
+/** A hairline divider between conceptual rail groups. */
+function RailDivider() {
+	return /* @__PURE__ */ jsx("div", { className: "oxy-rail__divider" });
+}
+/** The icon rail. `groups` are the conceptual sections (HQ · Apps ·
+*  Intelligence), rendered top-down with a hairline divider between them.
+*  `footerItems` pin to the bottom of the scroll area as a distinct
+*  "system" zone (Oxygen Factory), above the `bottom` account slot
+*  (workspace switch · user menu — injected by the host app). */
+function ShellRail({ top, groups, footerItems, bottom, className }) {
+	const { container, setContainer } = useShellPortalContainer();
+	return /* @__PURE__ */ jsx(ShellPortalContext.Provider, {
+		value: container,
+		children: /* @__PURE__ */ jsxs("div", {
+			ref: setContainer,
+			"data-testid": "shell-rail",
+			className: cx("oxy-shell-scope oxy-rail", className),
+			children: [
+				top && /* @__PURE__ */ jsx("div", {
+					className: "oxy-rail__top",
+					children: top
+				}),
+				/* @__PURE__ */ jsxs("div", {
+					className: "oxy-rail__nav",
+					children: [groups.map((group, i) => /* @__PURE__ */ jsxs(Fragment, { children: [i > 0 && /* @__PURE__ */ jsx(RailDivider, {}), group.map((item) => /* @__PURE__ */ jsx(RailEntry, { item }, item.key))] }, group[0]?.key ?? i)), footerItems && footerItems.length > 0 && /* @__PURE__ */ jsxs("div", {
+						className: "oxy-rail__footer",
+						children: [/* @__PURE__ */ jsx(RailDivider, {}), footerItems.map((item) => /* @__PURE__ */ jsx(RailEntry, { item }, item.key))]
+					})]
+				}),
+				bottom && /* @__PURE__ */ jsx("div", {
+					className: "oxy-rail__bottom",
+					children: bottom
+				})
+			]
+		})
+	});
+}
+
+//#endregion
+//#region src/shell/shellContext.ts
+/**
+* Fetch the shell bootstrap payload for the current customer app. Must be
+* called inside `<OxyAppProvider>`. Failure is non-fatal by design: the
+* shell degrades to chrome-less rendering (older servers don't have the
+* endpoint), so errors are surfaced on the result, never thrown.
+*/
+function useShellContext() {
+	const { projectId, fetcher } = useOxyApp();
+	const [state, setState] = React.useState({
+		data: null,
+		loading: true,
+		error: null
+	});
+	React.useEffect(() => {
+		if (!projectId) {
+			setState({
+				data: null,
+				loading: false,
+				error: /* @__PURE__ */ new Error("no projectId resolved")
+			});
+			return;
+		}
+		let cancelled = false;
+		fetcher(`/api/projects/${projectId}/shell-context`, { method: "GET" }).then(async (resp) => {
+			if (!resp.ok) throw new Error(`shell-context failed: HTTP ${resp.status}`);
+			const data = await resp.json();
+			if (!cancelled) setState({
+				data,
+				loading: false,
+				error: null
+			});
+		}).catch((e) => {
+			const error = e instanceof Error ? e : new Error(String(e));
+			getOxyAppLogger().log("warn", "shell-context unavailable, rendering without chrome", { error: error.message });
+			if (!cancelled) setState({
+				data: null,
+				loading: false,
+				error
+			});
+		});
+		return () => {
+			cancelled = true;
+		};
+	}, [projectId, fetcher]);
+	return state;
+}
+
+//#endregion
+//#region src/shell/TopBar.tsx
+/** Frame only: left content + right cluster. Mirrors the rail's
+*  `--sidebar-background` so the two read as one 48px-tall frame. */
+function TopBar({ left, right, className }) {
+	const { container, setContainer } = useShellPortalContainer();
+	return /* @__PURE__ */ jsx(ShellPortalContext.Provider, {
+		value: container,
+		children: /* @__PURE__ */ jsxs("header", {
+			ref: setContainer,
+			"data-testid": "workspace-topbar",
+			className: cx("oxy-shell-scope oxy-topbar", className),
+			children: [left, /* @__PURE__ */ jsx("div", {
+				className: "oxy-topbar__right",
+				children: right
+			})]
+		})
+	});
+}
+/**
+* "<Workspace> / <Page>" — e.g. "Poke House / HQ". The workspace name links
+* back to the HQ home; pass `onHomeNavigate` to intercept for SPA routing
+* (the anchor still carries `homeHref` for middle-click/new-tab).
+*/
+function Breadcrumb({ workspaceLabel, pageLabel, homeHref, onHomeNavigate }) {
+	return /* @__PURE__ */ jsxs("div", {
+		className: "oxy-breadcrumb",
+		children: [
+			/* @__PURE__ */ jsx("a", {
+				href: homeHref,
+				"data-testid": "topbar-workspace-link",
+				className: "oxy-breadcrumb__workspace",
+				onClick: onHomeNavigate ? (e) => {
+					if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey || e.button !== 0) return;
+					e.preventDefault();
+					onHomeNavigate();
+				} : void 0,
+				children: workspaceLabel
+			}),
+			/* @__PURE__ */ jsx("span", {
+				className: "oxy-breadcrumb__sep",
+				children: "/"
+			}),
+			/* @__PURE__ */ jsx("span", {
+				className: "oxy-breadcrumb__page",
+				children: pageLabel
+			})
+		]
+	});
+}
+/** `navigator.onLine` + online/offline events. */
+function useOnlineStatus() {
+	const [online, setOnline] = useState(() => typeof navigator === "undefined" ? true : navigator.onLine);
+	useEffect(() => {
+		const up = () => setOnline(true);
+		const down = () => setOnline(false);
+		window.addEventListener("online", up);
+		window.addEventListener("offline", down);
+		return () => {
+			window.removeEventListener("online", up);
+			window.removeEventListener("offline", down);
+		};
+	}, []);
+	return online;
+}
+/**
+* Universal "Sys: Connected" indicator — a pulsing green dot when the browser
+* is online, red when offline. Presentational connectivity signal; a real
+* backend health ping can replace `useOnlineStatus` later without touching
+* consumers.
+*/
+function SystemIndicator() {
+	const online = useOnlineStatus();
+	return /* @__PURE__ */ jsxs("span", {
+		"data-testid": "topbar-system",
+		className: "oxy-shell-scope oxy-sysind",
+		children: [/* @__PURE__ */ jsx("span", { children: "Sys:" }), /* @__PURE__ */ jsxs("span", {
+			className: cx("oxy-sysind__state", online ? "oxy-sysind__state--online" : "oxy-sysind__state--offline"),
+			children: [/* @__PURE__ */ jsxs("span", {
+				className: "oxy-sysind__dot-wrap",
+				children: [online && /* @__PURE__ */ jsx("span", { className: "oxy-sysind__ping" }), /* @__PURE__ */ jsx("span", { className: cx("oxy-sysind__dot", online ? "oxy-sysind__dot--online" : "oxy-sysind__dot--offline") })]
+			}), online ? "Connected" : "Offline"]
+		})]
+	});
+}
+/**
+* Live clock in the given IANA timezone (viewer-local when omitted or
+* invalid). Updates each half-minute (minute precision), pausing while the
+* tab is hidden.
+*/
+function WorkspaceClock({ timezone }) {
+	const [now, setNow] = useState(() => /* @__PURE__ */ new Date());
+	useEffect(() => {
+		const update = () => setNow(/* @__PURE__ */ new Date());
+		const id = setInterval(() => {
+			if (!document.hidden) update();
+		}, 3e4);
+		const onVisible = () => {
+			if (!document.hidden) update();
+		};
+		document.addEventListener("visibilitychange", onVisible);
+		return () => {
+			clearInterval(id);
+			document.removeEventListener("visibilitychange", onVisible);
+		};
+	}, []);
+	return /* @__PURE__ */ jsx("span", {
+		"data-testid": "topbar-clock",
+		className: "oxy-shell-scope oxy-clock",
+		children: useMemo(() => {
+			try {
+				return new Intl.DateTimeFormat(void 0, {
+					timeZone: timezone,
+					hour: "numeric",
+					minute: "2-digit",
+					timeZoneName: timezone ? "short" : void 0
+				}).format(now);
+			} catch {
+				return new Intl.DateTimeFormat(void 0, {
+					hour: "numeric",
+					minute: "2-digit"
+				}).format(now);
+			}
+		}, [now, timezone])
+	});
+}
+
+//#endregion
+//#region src/shell/WorkspaceTile.tsx
+/** Rail-top workspace identity: the org/code-first logo when present, the
+*  name initial otherwise. Pure branding — switching workspaces is the host
+*  app's concern (the rail `bottom` slot). */
+function WorkspaceTile({ name, logoUrl }) {
+	const [failedUrl, setFailedUrl] = useState(null);
+	return /* @__PURE__ */ jsx("span", {
+		"data-testid": "rail-workspace",
+		title: name,
+		className: "oxy-shell-scope oxy-workspace-tile",
+		children: !!logoUrl && failedUrl !== logoUrl ? /* @__PURE__ */ jsx("img", {
+			src: logoUrl,
+			alt: name,
+			onError: () => setFailedUrl(logoUrl ?? null),
+			className: "oxy-workspace-tile__img"
+		}) : /* @__PURE__ */ jsx("span", {
+			className: "oxy-workspace-tile__letter",
+			children: name.slice(0, 1).toUpperCase()
+		})
+	});
+}
+
+//#endregion
+//#region src/shell/OxyShell.tsx
+/** Home/HQ glyph (lucide "house" outline, inlined). */
+function HouseIcon() {
+	return /* @__PURE__ */ jsxs("svg", {
+		width: "16",
+		height: "16",
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: "2",
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		"aria-hidden": "true",
+		children: [/* @__PURE__ */ jsx("path", { d: "M15 21v-8a1 1 0 0 0-1-1h-4a1 1 0 0 0-1 1v8" }), /* @__PURE__ */ jsx("path", { d: "M3 10a2 2 0 0 1 .709-1.528l7-5.999a2 2 0 0 1 2.582 0l7 5.999A2 2 0 0 1 21 10v9a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z" })]
+	});
+}
+/** Chat glyph (lucide "messages-square" outline, inlined). */
+function MessagesIcon() {
+	return /* @__PURE__ */ jsxs("svg", {
+		width: "16",
+		height: "16",
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: "2",
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		"aria-hidden": "true",
+		children: [/* @__PURE__ */ jsx("path", { d: "M16 10a2 2 0 0 1-2 2H6l-4 4V4a2 2 0 0 1 2-2h10a2 2 0 0 1 2 2z" }), /* @__PURE__ */ jsx("path", { d: "M20 9a2 2 0 0 1 2 2v11l-4-4h-6a2 2 0 0 1-2-2v-1" })]
+	});
+}
+/** Rewrite a shell-context relative product path to an absolute URL against
+*  the oxy origin, when one is configured. `/api/*` paths are left relative
+*  — they ride the host's same-origin fetch / dev proxy (which attaches
+*  auth), so absolutizing them would drop the credentials the proxy adds. */
+function makeAbs(base) {
+	const origin = base?.replace(/\/$/, "");
+	return (url) => {
+		if (!url) return void 0;
+		if (!origin || !url.startsWith("/") || url.startsWith("/api/")) return url;
+		return `${origin}${url}`;
+	};
+}
+function buildRailGroups(data, currentAppSlug, abs) {
+	const hq = {
+		key: "hq",
+		label: "HQ",
+		testId: "rail-hq",
+		icon: /* @__PURE__ */ jsx(HouseIcon, {}),
+		href: abs(data.links.home)
+	};
+	const chat = {
+		key: "chat",
+		label: "Chat",
+		testId: "rail-chat",
+		icon: /* @__PURE__ */ jsx(MessagesIcon, {}),
+		href: abs(data.links.threads)
+	};
+	const appItems = data.apps.map((app) => ({
+		key: app.id,
+		label: app.name,
+		testId: `rail-app-${app.slug}`,
+		letter: app.name.slice(0, 1).toUpperCase(),
+		imageUrl: abs(app.icon_url),
+		active: app.slug === currentAppSlug,
+		href: abs(app.url)
+	}));
+	return appItems.length ? [[hq, chat], appItems] : [[hq, chat]];
+}
+/**
+* The workspace chrome around a customer app: icon rail + universal top bar
+* + content column — visually identical to the main web-app shell.
+*/
+function OxyShell({ children, pageLabel, topBarLeft, topBarExtra, railBottom, hideTopBar, askHotkey = true, productBaseUrl, className, chromeBackground, chromeForeground }) {
+	const abs = makeAbs(productBaseUrl);
+	const chromeStyle = {
+		...chromeBackground ? { "--sidebar-background": chromeBackground } : {},
+		...chromeForeground ? {
+			"--foreground": chromeForeground,
+			"--muted-foreground": `color-mix(in srgb, ${chromeForeground} 65%, transparent)`
+		} : {}
+	};
+	const { appSlug } = useOxyApp();
+	const { manifest } = useResolvedManifest();
+	const { data, loading } = useShellContext();
+	const { container, setContainer } = useShellPortalContainer();
+	const degraded = !loading && !data;
+	const effectiveSlug = appSlug || manifest.slug;
+	const currentApp = data?.apps.find((app) => app.slug === effectiveSlug);
+	const workspaceLabel = data ? data.org.name || data.workspace.name : "";
+	const page = pageLabel ?? currentApp?.name ?? manifest.name ?? effectiveSlug ?? "";
+	const askAgent = currentApp?.default_agent ?? manifest.ask?.agent ?? void 0;
+	const askSuggestions = currentApp?.suggested_questions?.length ? currentApp.suggested_questions : manifest.ask?.suggestedQuestions ?? [];
+	const [askOpen, setAskOpen] = useState(false);
+	useEffect(() => {
+		if (!askAgent || !askHotkey) return;
+		const onKey = (e) => {
+			if (e.key.toLowerCase() !== "k" || !(e.metaKey || e.ctrlKey)) return;
+			e.preventDefault();
+			setAskOpen((o) => !o);
+		};
+		window.addEventListener("keydown", onKey);
+		return () => window.removeEventListener("keydown", onKey);
+	}, [askAgent, askHotkey]);
+	const bottom = railBottom;
+	return /* @__PURE__ */ jsx(ShellPortalContext.Provider, {
+		value: container,
+		children: /* @__PURE__ */ jsxs("div", {
+			ref: setContainer,
+			className: cx("oxy-shell-scope oxy-shell", degraded && "oxy-shell--degraded", className),
+			style: chromeStyle,
+			children: [
+				!degraded && /* @__PURE__ */ jsx(ShellRail, {
+					top: data ? /* @__PURE__ */ jsx(WorkspaceTile, {
+						name: data.workspace.name,
+						logoUrl: data.logo_url ?? void 0
+					}) : /* @__PURE__ */ jsx("span", {
+						className: "oxy-workspace-tile",
+						children: /* @__PURE__ */ jsx(OxyMark, { className: "oxy-rail__item-img" })
+					}),
+					groups: data ? buildRailGroups(data, effectiveSlug, abs) : [[]],
+					bottom
+				}),
+				/* @__PURE__ */ jsxs("div", {
+					className: "oxy-shell__content-col",
+					children: [!hideTopBar && (!degraded || topBarLeft || topBarExtra) && /* @__PURE__ */ jsx(TopBar, {
+						left: topBarLeft ?? (data ? /* @__PURE__ */ jsx(Breadcrumb, {
+							workspaceLabel,
+							pageLabel: page,
+							homeHref: abs(data.links.home) ?? data.links.home
+						}) : void 0),
+						right: /* @__PURE__ */ jsxs(Fragment$1, { children: [
+							/* @__PURE__ */ jsx(SystemIndicator, {}),
+							/* @__PURE__ */ jsx(WorkspaceClock, {}),
+							topBarExtra,
+							askAgent && !degraded && /* @__PURE__ */ jsxs("button", {
+								type: "button",
+								"data-testid": "ask-oxygen-button",
+								onClick: () => setAskOpen((o) => !o),
+								className: cx("oxy-askbtn", askOpen && "oxy-askbtn--open"),
+								children: [
+									/* @__PURE__ */ jsx(OxyMark, { className: "oxy-askbtn__mark" }),
+									/* @__PURE__ */ jsx("span", {
+										className: "oxy-askbtn__label",
+										children: "Ask Oxygen"
+									}),
+									/* @__PURE__ */ jsx("kbd", {
+										className: "oxy-askbtn__kbd",
+										children: "⌘K"
+									})
+								]
+							})
+						] })
+					}), /* @__PURE__ */ jsx("div", {
+						className: "oxy-shell__main",
+						children
+					})]
+				}),
+				askAgent && !degraded && /* @__PURE__ */ jsx(AskDock, {
+					agentId: askAgent,
+					open: askOpen,
+					onClose: () => setAskOpen(false),
+					workspaceName: data?.workspace.name,
+					suggestions: askSuggestions,
+					threadsHref: abs(data?.links.threads)
+				})
+			]
+		})
+	});
+}
+
+//#endregion
+export { AnswerChart, AskDock, Breadcrumb, OXY_MARK_PATH, OxyMark, OxyShell, OxygenFactoryMark, ReasoningTrace, ShellRail, ShellTooltip, SystemIndicator, TopBar, WorkspaceClock, WorkspaceTile, buildTraceSteps, fetchThreadTranscript, useShellContext, useThreadHistory, workspaceLogoUrl };
+//# sourceMappingURL=shell.mjs.map