@oxy-hq/sdk 2.4.0 → 2.6.0

package/dist/{react-BLsczFL4.d.cts → react-DnBdQ8dG.d.mts}

@@ -1,6 +1,6 @@
 
 import * as React from "react";
-//#region src/customer-app/manifest.d.ts
+//#region src/custom-app/manifest.d.ts
 /**
  * Declaration of a single Oxy Function shipped in the bundle's
  * `functions/` dir. See `internal-docs/2026-06-12-customer-apps-functions-design.md`.
@@ -136,7 +136,7 @@ interface OxyAppManifest {
  * should treat this as the only source of truth for "which org/app
  * does this bundle belong to."
  */
-interface ResolvedCustomerAppManifest {
+interface ResolvedCustomAppManifest {
   manifest: OxyAppManifest;
   /**
    * Always an empty array for v2 manifests. Kept for API compatibility;
@@ -179,13 +179,13 @@ interface LoadManifestOptions {
  * Load + validate the manifest. Cached after the first call so callers
  * can invoke this from every component without coordinating.
  */
-declare function loadCustomerAppManifest(options?: LoadManifestOptions): Promise<ResolvedCustomerAppManifest>;
+declare function loadCustomAppManifest(options?: LoadManifestOptions): Promise<ResolvedCustomAppManifest>;
 /** For tests: reset the cache between runs. */
-declare function _resetCustomerAppManifestCacheForTest(): void;
+declare function _resetCustomAppManifestCacheForTest(): void;
 //#endregion
-//#region src/customer-app/errors.d.ts
+//#region src/custom-app/errors.d.ts
 /**
- * Error thrown by all customer-app hooks when an API call returns a
+ * Error thrown by all custom-app hooks when an API call returns a
  * non-2xx response. Carries the structured `code` + `hint` the server
  * emits so bundle UIs can render an actionable message instead of
  * "404: { ...json... }".
@@ -208,23 +208,23 @@ declare class OxyApiError extends Error {
  * dominate the bundle UI).
  */
 declare function apiErrorFromResponse(resp: Response): Promise<OxyApiError>;
-interface CustomerAppErrorReport {
+interface CustomAppErrorReport {
   title: string;
   message: string;
   hint: string;
   docs?: string;
 }
 /** Interpret a thrown error as a structured report for UI display. */
-declare function interpretCustomerAppError(err: unknown): CustomerAppErrorReport;
+declare function interpretCustomAppError(err: unknown): CustomAppErrorReport;
 //#endregion
-//#region src/customer-app/function-sse.d.ts
+//#region src/custom-app/function-sse.d.ts
 /** A captured `console.*` / `ctx.log` line from a function run. */
 interface FunctionLog {
   level: string;
   message: string;
 }
 //#endregion
-//#region src/customer-app/react.d.ts
+//#region src/custom-app/react.d.ts
 /**
  * Credentialed fetch wrapper stored in context so `useQuery` can share
  * the same request mechanism without coupling it to the global `fetch`.
@@ -237,7 +237,7 @@ interface FunctionLog {
  */
 type AppFetcher = typeof fetch;
 interface OxyAppProviderProps {
-  /** Optional manifest load options. Same shape as `loadCustomerAppManifest`. */
+  /** Optional manifest load options. Same shape as `loadCustomAppManifest`. */
   manifestOptions?: LoadManifestOptions;
   /**
    * Rendered while the manifest is loading. Defaults to nothing; pass a
@@ -249,13 +249,23 @@ interface OxyAppProviderProps {
    * report so the bundle can show its own branded error card. Defaults
    * to a minimal text-only fallback (better than a blank page).
    */
-  errorFallback?: (err: CustomerAppErrorReport) => React.ReactNode;
+  errorFallback?: (err: CustomAppErrorReport) => React.ReactNode;
   /**
    * Override the fetch implementation used by all hooks (`useQuery`).
    * Useful for test environments or proxy setups. Defaults to a wrapper
    * that sets `credentials: "include"` on every request.
    */
   fetcher?: AppFetcher;
+  /**
+   * Origin of the oxy backend to call (e.g. `https://oxy.example.com` or
+   * `http://localhost:3000`). When set, the SDK resolves its relative `/api/…`
+   * requests — `shell-context`, Ask Oxygen, events — against this origin
+   * instead of the app's own, so a standalone / cross-origin dev app can drive
+   * the wired shell without a same-origin proxy. The backend must allow the
+   * app's origin (see oxy's dev-origin CORS list). Leave unset when the app is
+   * served same-origin by oxy.
+   */
+  backendUrl?: string;
   children: React.ReactNode;
 }
 /**
@@ -268,7 +278,7 @@ declare function OxyAppProvider(props: OxyAppProviderProps): React.JSX.Element;
  * `<OxyAppProvider>` — that's a programmer error worth surfacing
  * loudly, not silently swallowing.
  */
-declare function useResolvedManifest(): ResolvedCustomerAppManifest;
+declare function useResolvedManifest(): ResolvedCustomAppManifest;
 /**
  * Low-level hook that returns the raw context value (including the
  * fetcher). Prefer `useResolvedManifest` for manifest access; use
@@ -300,7 +310,7 @@ interface UseQueryResult<Row = Record<string, unknown>> {
 }
 /**
  * Execute an ad-hoc SQL query against the project linked to this
- * customer app. The query is specified inline by the caller; no
+ * custom app. The query is specified inline by the caller; no
  * manifest declaration is involved.
  *
  * Re-runs whenever `input` or enabled `params` change. Use the
@@ -642,5 +652,5 @@ interface OxyChatProps {
  */
 declare function OxyChat(props: OxyChatProps): React.JSX.Element;
 //#endregion
-export { UseSemanticQueryOpts as A, CustomerAppErrorReport as B, UseProcedureRunInput as C, UseQueryOpts as D, UseQueryInput as E, useProcedureRun as F, OxyAppFunctionManifest as G, apiErrorFromResponse as H, useQuery as I, _resetCustomerAppManifestCacheForTest as J, OxyAppManifest as K, useResolvedManifest as L, useAgentRun as M, useFunction as N, UseQueryResult as O, useOxyApp as P, useSemanticQuery as R, UseFunctionResult as S, UseProcedureRunResult as T, interpretCustomerAppError as U, OxyApiError as V, LoadManifestOptions as W, loadCustomerAppManifest as Y, SemanticFilter as _, AppFetcher as a, UseAgentRunInput as b, OxyAppProvider as c, OxyChatProps as d, ProcedureProgress as f, SemanticDateRangeOp as g, SemanticArrayOp as h, AgentSqlArtifact as i, UseSemanticQueryResult as j, UseSemanticQueryInput as k, OxyAppProviderProps as l, ProcedureRunState as m, AgentRunEvent as n, OxyAnswer as o, ProcedureResult as p, ResolvedCustomerAppManifest as q, AgentRunState as r, OxyAnswerProps as s, AgentArtifact as t, OxyChat as u, SemanticScalarOp as v, UseProcedureRunOpts as w, UseAgentRunResult as x, SemanticTimeDimension as y, useTrackEvent as z };
-//# sourceMappingURL=react-BLsczFL4.d.cts.map
+export { UseSemanticQueryOpts as A, CustomAppErrorReport as B, UseProcedureRunInput as C, UseQueryOpts as D, UseQueryInput as E, useProcedureRun as F, OxyAppFunctionManifest as G, apiErrorFromResponse as H, useQuery as I, _resetCustomAppManifestCacheForTest as J, OxyAppManifest as K, useResolvedManifest as L, useAgentRun as M, useFunction as N, UseQueryResult as O, useOxyApp as P, useSemanticQuery as R, UseFunctionResult as S, UseProcedureRunResult as T, interpretCustomAppError as U, OxyApiError as V, LoadManifestOptions as W, loadCustomAppManifest as Y, SemanticFilter as _, AppFetcher as a, UseAgentRunInput as b, OxyAppProvider as c, OxyChatProps as d, ProcedureProgress as f, SemanticDateRangeOp as g, SemanticArrayOp as h, AgentSqlArtifact as i, UseSemanticQueryResult as j, UseSemanticQueryInput as k, OxyAppProviderProps as l, ProcedureRunState as m, AgentRunEvent as n, OxyAnswer as o, ProcedureResult as p, ResolvedCustomAppManifest as q, AgentRunState as r, OxyAnswerProps as s, AgentArtifact as t, OxyChat as u, SemanticScalarOp as v, UseProcedureRunOpts as w, UseAgentRunResult as x, SemanticTimeDimension as y, useTrackEvent as z };
+//# sourceMappingURL=react-DnBdQ8dG.d.mts.map

package/dist/react-DnBdQ8dG.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-DnBdQ8dG.d.mts","names":[],"sources":["../src/custom-app/manifest.ts","../src/custom-app/errors.ts","../src/custom-app/function-sse.ts","../src/custom-app/react.tsx"],"mappings":"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"}

package/dist/shell.cjs

@@ -1,6 +1,6 @@
 // @oxy/sdk - TypeScript SDK for Oxy data platform
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_react = require('./react-B7Blpmt7.cjs');
+const require_react = require('./react-BAiiXftp.cjs');
 let react = require("react");
 react = require_react.__toESM(react, 1);
 let react_jsx_runtime = require("react/jsx-runtime");
@@ -1189,6 +1189,38 @@ function HistoryIcon() {
 		]
 	});
 }
+function SearchIcon() {
+	return /* @__PURE__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsx)("circle", {
+			cx: "11",
+			cy: "11",
+			r: "8"
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "m21 21-4.3-4.3" })]
+	});
+}
+function ThreadIcon() {
+	return /* @__PURE__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsxs)("svg", {
 		width: "14",
@@ -1240,6 +1272,26 @@ function StopIcon() {
 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) {
@@ -1265,9 +1317,12 @@ function AskDock({ agentId, workspaceName, suggestions = [], threadsHref, open,
 	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]);
@@ -1291,7 +1346,8 @@ function AskDock({ agentId, workspaceName, suggestions = [], threadsHref, open,
 			id: threadId ?? all[0].question,
 			title: all[0].question,
 			turns: all,
-			threadId
+			threadId,
+			createdAt: startedAtRef.current ?? (/* @__PURE__ */ new Date()).toISOString()
 		};
 	};
 	const resetToEmpty = () => {
@@ -1301,6 +1357,7 @@ function AskDock({ agentId, workspaceName, suggestions = [], threadsHref, open,
 		setPending(null);
 		setDraft("");
 		setThreadId(null);
+		startedAtRef.current = null;
 	};
 	const newChat = () => {
 		const snap = snapshotCurrent();
@@ -1334,6 +1391,7 @@ function AskDock({ agentId, workspaceName, suggestions = [], threadsHref, open,
 		setPending(null);
 		setDraft("");
 		setThreadId(id);
+		startedAtRef.current = serverThreads.find((t) => t.id === id)?.created_at ?? (/* @__PURE__ */ new Date()).toISOString();
 		setHistoryOpen(false);
 		setRestoring(true);
 		try {
@@ -1348,6 +1406,7 @@ function AskDock({ agentId, workspaceName, suggestions = [], threadsHref, open,
 		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]);
@@ -1363,16 +1422,31 @@ function AskDock({ agentId, workspaceName, suggestions = [], threadsHref, open,
 	});
 	const empty = pending === null && turns.length === 0;
 	const canNewChat = !empty;
-	const historyEntries = [...history.filter((c) => c.id !== threadId).map((c) => ({
+	const currentId = threadId ?? turns[0]?.question ?? pending ?? null;
+	const historyEntries = [...history.map((c) => ({
 		id: c.id,
 		title: c.title,
-		meta: `${c.turns.length} message${c.turns.length === 1 ? "" : "s"}`,
-		onOpen: () => openConversation(c)
-	})), ...serverThreads.filter((t) => t.id !== threadId && !history.some((c) => c.id === t.id)).map((t) => ({
+		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,
-		onOpen: () => void openServerThread(t.id)
+		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__ */ (0, react_jsx_runtime.jsxs)("aside", {
 		className: cx("oxy-shell-scope oxy-askdock", !open && "oxy-askdock--closed", className),
@@ -1405,7 +1479,11 @@ function AskDock({ agentId, workspaceName, suggestions = [], threadsHref, open,
 							onClick: () => {
 								const next = !historyOpen;
 								setHistoryOpen(next);
-								if (next) refetchHistory();
+								if (next) {
+									refetchHistory();
+									setHistoryQuery("");
+									setHistoryShown(HISTORY_PAGE_SIZE);
+								}
 							},
 							"data-testid": "askdock-history",
 							"aria-label": "Chat history",
@@ -1430,24 +1508,51 @@ function AskDock({ agentId, workspaceName, suggestions = [], threadsHref, open,
 					]
 				})
 			]
-		}), historyOpen ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+		}), historyOpen ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 			className: "oxy-askdock__history",
 			"data-testid": "askdock-history-panel",
-			children: historyEntries.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: "oxy-askdock__history-search",
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SearchIcon, {}), /* @__PURE__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsx)("p", {
 				className: "oxy-askdock__history-empty",
-				children: "No previous chats yet."
-			}) : historyEntries.map((entry) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+				children: historyQuery ? "No matching chats." : "No previous chats yet."
+			}) : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [visibleEntries.map((entry) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
 				type: "button",
-				className: "oxy-askdock__history-item",
+				className: cx("oxy-askdock__history-item", entry.active && "oxy-askdock__history-item--active"),
 				onClick: entry.onOpen,
-				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-					className: "oxy-askdock__history-title",
-					children: entry.title
-				}), entry.meta && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-					className: "oxy-askdock__history-meta",
-					children: entry.meta
-				})]
-			}, entry.id))
+				title: entry.title,
+				"aria-current": entry.active ? "true" : void 0,
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: "oxy-askdock__history-icon",
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ThreadIcon, {})
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: "oxy-askdock__history-title",
+						children: entry.title
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: "oxy-askdock__history-time",
+						children: formatHistoryTime(entry.createdAt)
+					})
+				]
+			}, entry.id)), filteredEntries.length > visibleEntries.length && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+				type: "button",
+				className: "oxy-askdock__history-more",
+				onClick: () => setHistoryShown((n) => n + HISTORY_PAGE_SIZE),
+				children: "Show more"
+			})] })]
 		}) : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 			className: "oxy-askdock__scroll",
 			ref: scrollRef,
@@ -1679,7 +1784,7 @@ function ShellRail({ top, groups, footerItems, bottom, className }) {
 //#endregion
 //#region src/shell/shellContext.ts
 /**
-* Fetch the shell bootstrap payload for the current customer app. Must be
+* Fetch the shell bootstrap payload for the current custom 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.
@@ -1907,25 +2012,6 @@ function MessagesIcon() {
 		children: [/* @__PURE__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsx)("path", { d: "M20 9a2 2 0 0 1 2 2v11l-4-4h-6a2 2 0 0 1-2-2v-1" })]
 	});
 }
-/** Settings glyph (lucide "settings" outline, inlined). */
-function GearIcon() {
-	return /* @__PURE__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsx)("path", { d: "M12.22 2h-.44a2 2 0 0 0-2 2v.18a2 2 0 0 1-1 1.73l-.43.25a2 2 0 0 1-2 0l-.15-.08a2 2 0 0 0-2.73.73l-.22.38a2 2 0 0 0 .73 2.73l.15.1a2 2 0 0 1 1 1.72v.51a2 2 0 0 1-1 1.74l-.15.09a2 2 0 0 0-.73 2.73l.22.38a2 2 0 0 0 2.73.73l.15-.08a2 2 0 0 1 2 0l.43.25a2 2 0 0 1 1 1.73V20a2 2 0 0 0 2 2h.44a2 2 0 0 0 2-2v-.18a2 2 0 0 1 1-1.73l.43-.25a2 2 0 0 1 2 0l.15.08a2 2 0 0 0 2.73-.73l.22-.39a2 2 0 0 0-.73-2.73l-.15-.08a2 2 0 0 1-1-1.74v-.5a2 2 0 0 1 1-1.74l.15-.09a2 2 0 0 0 .73-2.73l-.22-.38a2 2 0 0 0-2.73-.73l-.15.08a2 2 0 0 1-2 0l-.43-.25a2 2 0 0 1-1-1.73V4a2 2 0 0 0-2-2z" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("circle", {
-			cx: "12",
-			cy: "12",
-			r: "3"
-		})]
-	});
-}
 /** 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
@@ -1965,11 +2051,18 @@ function buildRailGroups(data, currentAppSlug, abs) {
 	return appItems.length ? [[hq, chat], appItems] : [[hq, chat]];
 }
 /**
-* The workspace chrome around a customer app: icon rail + universal top bar
+* The workspace chrome around a custom 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 }) {
+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 } = require_react.useOxyApp();
 	const { manifest } = require_react.useResolvedManifest();
 	const { data, loading } = useShellContext();
@@ -1992,22 +2085,13 @@ function OxyShell({ children, pageLabel, topBarLeft, topBarExtra, railBottom, hi
 		window.addEventListener("keydown", onKey);
 		return () => window.removeEventListener("keydown", onKey);
 	}, [askAgent, askHotkey]);
-	const settingsEntry = data?.links.settings ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ShellTooltip, {
-		content: "Settings",
-		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("a", {
-			href: abs(data.links.settings),
-			"aria-label": "Settings",
-			"data-testid": "rail-settings",
-			className: "oxy-rail__item",
-			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(GearIcon, {})
-		})
-	}) : null;
-	const bottom = railBottom || settingsEntry ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [railBottom, settingsEntry] }) : void 0;
+	const bottom = railBottom;
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ShellPortalContext.Provider, {
 		value: container,
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 			ref: setContainer,
 			className: cx("oxy-shell-scope oxy-shell", degraded && "oxy-shell--degraded", className),
+			style: chromeStyle,
 			children: [
 				!degraded && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ShellRail, {
 					top: data ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(WorkspaceTile, {