@oxy-hq/sdk 2.11.0 → 2.13.0

package/dist/shell.d.cts

@@ -1,5 +1,6 @@
 
-import { a as AppFetcher, n as AgentRunEvent } from "./react-CLONxcnA.cjs";
+import { a as AppFetcher, n as AgentRunEvent } from "./react-D-Sf973d.cjs";
+import { _ as OxyReach } from "./function-context-D8eyZuw_.cjs";
 import * as React from "react";
 import { ReactNode } from "react";
 //#region src/shell/AnswerChart.d.ts
@@ -228,17 +229,31 @@ interface ShellContextData {
   /** Product-surface navigation targets, host-aware. `settings` opens the
    *  Unified Settings Dialog via the SPA's `?settings=<section>` deep link
    *  (optional: absent on servers older than the link). */
+  /** `login` is the product's login page, for `signOut()`; absent on a server that predates it. */
   links: {
     home: string;
     threads: string;
     settings?: string;
+    login?: string;
   };
   /** Viewer display identity; null on unauthenticated/local modes. */
-  user: {
-    name: string;
-    email: string;
-    picture?: string | null;
-  } | null;
+  user: ShellContextUser | null;
+}
+/**
+ * The viewer, for display. `id`, `kind` and `reach` arrive on servers that
+ * carry the operating graph (2026-09-07 on) and are absent before — read them
+ * through `useIdentity()`, which fills the gaps with the fail-closed answer.
+ * None of this is a gate: the function's `ctx.user` is.
+ */
+interface ShellContextUser {
+  name: string;
+  /** Empty for a frontline worker, who has no mailbox. */
+  email: string;
+  picture?: string | null;
+  id?: string;
+  /** `member` holds an org membership; `frontline` is a crew member. */
+  kind?: "member" | "frontline";
+  reach?: OxyReach | null;
 }
 interface UseShellContextResult {
   data: ShellContextData | null;
@@ -252,6 +267,46 @@ interface UseShellContextResult {
  * endpoint), so errors are surfaced on the result, never thrown.
  */
 declare function useShellContext(): UseShellContextResult;
+/** What `useIdentity()` returns. */
+interface ViewerIdentity {
+  id: string | null;
+  name: string;
+  /** `null` for a frontline worker — the crew signal, as in `ctx.user.email`. */
+  email: string | null;
+  picture: string | null;
+  kind: "member" | "frontline" | null;
+  /** Display-only reach; the fail-closed answer until the server says otherwise. */
+  reach: OxyReach;
+  loading: boolean;
+}
+/**
+ * The viewer, in one shape, on every server version: who is signed in, the
+ * crew-or-office signal, and where they work — for a greeting, a "your
+ * store" default, or hiding a tab. Never for authorization: a browser can
+ * edit what it renders, and the function's `ctx.user.reach` is the gate.
+ */
+declare function useIdentity(): ViewerIdentity;
+/**
+ * Where a signed-out person lands: the product's login page, with this app
+ * as the place to come back to.
+ *
+ * `loginUrl` is `links.login` from the shell context — the product host's,
+ * which a custom-app subdomain cannot derive — and `/login` on the current
+ * origin when the context is unavailable or the server predates the field.
+ * `returnTo` is the app's own address, which it knows legitimately.
+ */
+declare function signOutUrl(loginUrl: string | null | undefined, returnTo: string): string;
+/**
+ * End the platform session, then leave for the login page.
+ *
+ * `GET /api/logout` clears the session cookie server-side. That is the same
+ * cookie a crew member's PIN session rides, so on an enrolled tablet the login
+ * page comes back as "Who's on shift?" and returns to the app after the next
+ * PIN; elsewhere it is the ordinary sign-in. Throws when the server refused,
+ * so a caller can say so rather than navigate away from a session that still
+ * exists. Pass the app's `fetcher` from `useOxyApp()` so credentials ride.
+ */
+declare function signOut(fetcher: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>, loginUrl?: string | null, returnTo?: string): Promise<void>;
 //#endregion
 //#region src/shell/Tooltip.d.ts
 /**
@@ -342,5 +397,5 @@ declare function WorkspaceTile({ name, logoUrl }: {
   logoUrl?: string;
 }): import("react").JSX.Element;
 //#endregion
-export { AnswerChart, type AnswerChartProps, AskDock, type AskDockProps, Breadcrumb, type ChartBlock, type ChartBlockConfig, OXY_MARK_PATH, OxyMark, OxyShell, type OxyShellProps, OxygenFactoryMark, type RailItem, ReasoningTrace, type ReasoningTraceProps, type ShellContextApp, type ShellContextData, ShellRail, ShellTooltip, SystemIndicator, type ThreadSummary, type ThreadTranscript, TopBar, type TraceItem, type TraceStep, type TraceStepStatus, type TranscriptTurn, type UseShellContextResult, type UseThreadHistoryResult, WorkspaceClock, WorkspaceTile, buildTraceSteps, fetchThreadTranscript, useShellContext, useThreadHistory, workspaceLogoUrl };
+export { AnswerChart, type AnswerChartProps, AskDock, type AskDockProps, Breadcrumb, type ChartBlock, type ChartBlockConfig, OXY_MARK_PATH, OxyMark, OxyShell, type OxyShellProps, OxygenFactoryMark, type RailItem, ReasoningTrace, type ReasoningTraceProps, type ShellContextApp, type ShellContextData, type ShellContextUser, ShellRail, ShellTooltip, SystemIndicator, type ThreadSummary, type ThreadTranscript, TopBar, type TraceItem, type TraceStep, type TraceStepStatus, type TranscriptTurn, type UseShellContextResult, type UseThreadHistoryResult, type ViewerIdentity, WorkspaceClock, WorkspaceTile, buildTraceSteps, fetchThreadTranscript, signOut, signOutUrl, useIdentity, useShellContext, useThreadHistory, workspaceLogoUrl };
 //# sourceMappingURL=shell.d.cts.map

package/dist/shell.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"shell.d.cts","names":[],"sources":["../src/shell/AnswerChart.tsx","../src/shell/AskDock.tsx","../src/shell/logoUrl.ts","../src/shell/marks.tsx","../src/shell/OxyShell.tsx","../src/shell/trace.ts","../src/shell/ReasoningTrace.tsx","../src/shell/ShellRail.tsx","../src/shell/shellContext.ts","../src/shell/Tooltip.tsx","../src/shell/TopBar.tsx","../src/shell/threadHistory.ts","../src/shell/WorkspaceTile.tsx"],"mappings":";;;;;UAYiB;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;UAGe;EACf,QAAQ;EACR;EACA;;UA8ce;EACf,OAAO;EACP;;;;;iBAMc,cAAc,OAAO,aAAa,mBAAgB,MAAA,IAAA;;;UCzUjD;;EAEf;;EAEA;;EAEA;;EAEA;EACA;EACA;EACA;;;;;;iBAuEc,UACd,SACA,eACA,aACA,aACA,MACA,SACA,aACC,eAAY,MAAA,IAAA;;;;;;;;cC7PF,mBAAgB,oBAAsB,qBAAqB;;;;cCA3D;;;iBAKG,UAAU;EAAe;oBAAoB,IAAA;;;;;;iBAyB7C,oBAAoB;EAAe;oBAAoB,IAAA;;;UC+BtD;EACf,UAAU;;EAEV;;;;;EAKA,aAAa;;;EAGb,cAAc;;;EAGd,aAAa;;EAEb;;;EAGA;;;;;;;;EAQA;EACA;;;;;EAKA;;;;EAIA;;;;;;iBAsDc,WACd,UACA,WACA,YACA,aACA,YACA,YACA,WACA,gBACA,WACA,kBACA,oBACC,gCAAa,IAAA;;;KC9JJ;UAEK;EACf;EACA;EACA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;EACA;EACA;;UAGe;EACf;EACA;EACA;EACA,QAAQ;EACR,OAAO;;;;iBA8IO,gBAAgB,QAAQ,kBAAkB;;;UCvDzC;EACf,OAAO;;EAEP;;EAEA;IAAQ;IAAe;;EACvB;;;;iBAKc,iBAAiB,OAAO,WAAmB,KAAK,aAAa,sCAAmB,IAAA;;;;;;;KCxHpF;EACV;EACA;;;EAGA;EACA;EACA;EACA,OAAO;EACP;EACA;EACA;EACA;;;;;;;iBAuDc,YACd,KACA,QACA,aACA,QACA;EAEA,MAAM;EACN,QAAQ;EACR,cAAc;EACd,SAAS;EACT;oBACD,IAAA;;;UC9EgB;EACf;EACA;EACA;;EAEA;EACA;;;EAGA;;EAEA;;UAGe;EACf;IAAa;IAAY;;EACzB;IAAO;IAAY;IAAc;;;EAEjC;;EAEA,MAAM;;;;EAIN;IAAS;IAAc;IAAiB;;;EAExC;IAAQ;IAAc;IAAe;;;UAGtB;EACf,MAAM;EACN;EACA,OAAO;;;;;;;;iBASO,mBAAmB;;;;;;;;iBC/CnB,eACd,SACA,MACA;EAEA,SAAS,MAAM;EACf;EACA,UAAU,MAAM;IACjB,MAAA,IAAA;;;;;iBCNe,SACd,MACA,OACA;EAEA,OAAO;EACP,QAAQ;EACR;oBACD,IAAA;;;;;;iBAqBe,aACd,gBACA,WACA,UACA;EAEA;EACA;EACA;EACA;oBACD,IAAA;;;;;;;iBAmDe,mCAAe,IAAA;;;;;;iBA+Bf,iBAAiB;EAAc;oBAAmB,IAAA;;;UCrHjD;EACf;EACA;EACA;;UAGe;EACf;EACA,QAAQ;;UAGO;EACf;EACA,OAAO;;UAGQ;EACf,SAAS;EACT;EACA,OAAO;;EAEP;;;;;;;iBAQc,oBAAoB;;;;;iBAyCd,sBACpB,SAAS,YACT,mBACA,mBACC,QAAQ;;;;;;iBCnFK,gBAAgB,MAAM;EAAa;EAAc;oBAAkB,IAAA"}
+{"version":3,"file":"shell.d.cts","names":[],"sources":["../src/shell/AnswerChart.tsx","../src/shell/AskDock.tsx","../src/shell/logoUrl.ts","../src/shell/marks.tsx","../src/shell/OxyShell.tsx","../src/shell/trace.ts","../src/shell/ReasoningTrace.tsx","../src/shell/ShellRail.tsx","../src/shell/shellContext.ts","../src/shell/Tooltip.tsx","../src/shell/TopBar.tsx","../src/shell/threadHistory.ts","../src/shell/WorkspaceTile.tsx"],"mappings":";;;;;;UAYiB;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;UAGe;EACf,QAAQ;EACR;EACA;;UA8ce;EACf,OAAO;EACP;;;;;iBAMc,cAAc,OAAO,aAAa,mBAAgB,MAAA,IAAA;;;UCzUjD;;EAEf;;EAEA;;EAEA;;EAEA;EACA;EACA;EACA;;;;;;iBAuEc,UACd,SACA,eACA,aACA,aACA,MACA,SACA,aACC,eAAY,MAAA,IAAA;;;;;;;;cC7PF,mBAAgB,oBAAsB,qBAAqB;;;;cCA3D;;;iBAKG,UAAU;EAAe;oBAAoB,IAAA;;;;;;iBAyB7C,oBAAoB;EAAe;oBAAoB,IAAA;;;UC+BtD;EACf,UAAU;;EAEV;;;;;EAKA,aAAa;;;EAGb,cAAc;;;EAGd,aAAa;;EAEb;;;EAGA;;;;;;;;EAQA;EACA;;;;;EAKA;;;;EAIA;;;;;;iBAsDc,WACd,UACA,WACA,YACA,aACA,YACA,YACA,WACA,gBACA,WACA,kBACA,oBACC,gCAAa,IAAA;;;KC9JJ;UAEK;EACf;EACA;EACA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;EACA;EACA;;UAGe;EACf;EACA;EACA;EACA,QAAQ;EACR,OAAO;;;;iBA8IO,gBAAgB,QAAQ,kBAAkB;;;UCvDzC;EACf,OAAO;;EAEP;;EAEA;IAAQ;IAAe;;EACvB;;;;iBAKc,iBAAiB,OAAO,WAAmB,KAAK,aAAa,sCAAmB,IAAA;;;;;;;KCxHpF;EACV;EACA;;;EAGA;EACA;EACA;EACA,OAAO;EACP;EACA;EACA;EACA;;;;;;;iBAuDc,YACd,KACA,QACA,aACA,QACA;EAEA,MAAM;EACN,QAAQ;EACR,cAAc;EACd,SAAS;EACT;oBACD,IAAA;;;UC7EgB;EACf;EACA;EACA;;EAEA;EACA;;;EAGA;;EAEA;;UAGe;EACf;IAAa;IAAY;;EACzB;IAAO;IAAY;IAAc;;;EAEjC;;EAEA,MAAM;;;;;EAKN;IAAS;IAAc;IAAiB;IAAmB;;;EAE3D,MAAM;;;;;;;;UASS;EACf;;EAEA;EACA;EACA;;EAEA;EACA,QAAQ;;UAGO;EACf,MAAM;EACN;EACA,OAAO;;;;;;;;iBASO,mBAAmB;;UA4ClB;EACf;EACA;;EAEA;EACA;EACA;;EAEA,OAAO;EACP;;;;;;;;iBAWc,eAAe;;;;;;;;;;iBAuBf,WAAW,qCAAqC;;;;;;;;;;;iBAgB1C,QACpB,UAAU,OAAO,cAAc,KAAK,OAAO,gBAAgB,QAAQ,WACnE,0BACA,oBACC;;;;;;;;iBC7Ka,eACd,SACA,MACA;EAEA,SAAS,MAAM;EACf;EACA,UAAU,MAAM;IACjB,MAAA,IAAA;;;;;iBCNe,SACd,MACA,OACA;EAEA,OAAO;EACP,QAAQ;EACR;oBACD,IAAA;;;;;;iBAqBe,aACd,gBACA,WACA,UACA;EAEA;EACA;EACA;EACA;oBACD,IAAA;;;;;;;iBAmDe,mCAAe,IAAA;;;;;;iBA+Bf,iBAAiB;EAAc;oBAAmB,IAAA;;;UCrHjD;EACf;EACA;EACA;;UAGe;EACf;EACA,QAAQ;;UAGO;EACf;EACA,OAAO;;UAGQ;EACf,SAAS;EACT;EACA,OAAO;;EAEP;;;;;;;iBAQc,oBAAoB;;;;;iBAyCd,sBACpB,SAAS,YACT,mBACA,mBACC,QAAQ;;;;;;iBCnFK,gBAAgB,MAAM;EAAa;EAAc;oBAAkB,IAAA"}

package/dist/shell.d.mts

@@ -1,5 +1,6 @@
 
-import { a as AppFetcher, n as AgentRunEvent } from "./react-CLONxcnA.mjs";
+import { a as AppFetcher, n as AgentRunEvent } from "./react-D-Sf973d.mjs";
+import { _ as OxyReach } from "./function-context-D8eyZuw_.mjs";
 import * as React from "react";
 import { ReactNode } from "react";
 //#region src/shell/AnswerChart.d.ts
@@ -228,17 +229,31 @@ interface ShellContextData {
   /** Product-surface navigation targets, host-aware. `settings` opens the
    *  Unified Settings Dialog via the SPA's `?settings=<section>` deep link
    *  (optional: absent on servers older than the link). */
+  /** `login` is the product's login page, for `signOut()`; absent on a server that predates it. */
   links: {
     home: string;
     threads: string;
     settings?: string;
+    login?: string;
   };
   /** Viewer display identity; null on unauthenticated/local modes. */
-  user: {
-    name: string;
-    email: string;
-    picture?: string | null;
-  } | null;
+  user: ShellContextUser | null;
+}
+/**
+ * The viewer, for display. `id`, `kind` and `reach` arrive on servers that
+ * carry the operating graph (2026-09-07 on) and are absent before — read them
+ * through `useIdentity()`, which fills the gaps with the fail-closed answer.
+ * None of this is a gate: the function's `ctx.user` is.
+ */
+interface ShellContextUser {
+  name: string;
+  /** Empty for a frontline worker, who has no mailbox. */
+  email: string;
+  picture?: string | null;
+  id?: string;
+  /** `member` holds an org membership; `frontline` is a crew member. */
+  kind?: "member" | "frontline";
+  reach?: OxyReach | null;
 }
 interface UseShellContextResult {
   data: ShellContextData | null;
@@ -252,6 +267,46 @@ interface UseShellContextResult {
  * endpoint), so errors are surfaced on the result, never thrown.
  */
 declare function useShellContext(): UseShellContextResult;
+/** What `useIdentity()` returns. */
+interface ViewerIdentity {
+  id: string | null;
+  name: string;
+  /** `null` for a frontline worker — the crew signal, as in `ctx.user.email`. */
+  email: string | null;
+  picture: string | null;
+  kind: "member" | "frontline" | null;
+  /** Display-only reach; the fail-closed answer until the server says otherwise. */
+  reach: OxyReach;
+  loading: boolean;
+}
+/**
+ * The viewer, in one shape, on every server version: who is signed in, the
+ * crew-or-office signal, and where they work — for a greeting, a "your
+ * store" default, or hiding a tab. Never for authorization: a browser can
+ * edit what it renders, and the function's `ctx.user.reach` is the gate.
+ */
+declare function useIdentity(): ViewerIdentity;
+/**
+ * Where a signed-out person lands: the product's login page, with this app
+ * as the place to come back to.
+ *
+ * `loginUrl` is `links.login` from the shell context — the product host's,
+ * which a custom-app subdomain cannot derive — and `/login` on the current
+ * origin when the context is unavailable or the server predates the field.
+ * `returnTo` is the app's own address, which it knows legitimately.
+ */
+declare function signOutUrl(loginUrl: string | null | undefined, returnTo: string): string;
+/**
+ * End the platform session, then leave for the login page.
+ *
+ * `GET /api/logout` clears the session cookie server-side. That is the same
+ * cookie a crew member's PIN session rides, so on an enrolled tablet the login
+ * page comes back as "Who's on shift?" and returns to the app after the next
+ * PIN; elsewhere it is the ordinary sign-in. Throws when the server refused,
+ * so a caller can say so rather than navigate away from a session that still
+ * exists. Pass the app's `fetcher` from `useOxyApp()` so credentials ride.
+ */
+declare function signOut(fetcher: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>, loginUrl?: string | null, returnTo?: string): Promise<void>;
 //#endregion
 //#region src/shell/Tooltip.d.ts
 /**
@@ -342,5 +397,5 @@ declare function WorkspaceTile({ name, logoUrl }: {
   logoUrl?: string;
 }): import("react").JSX.Element;
 //#endregion
-export { AnswerChart, type AnswerChartProps, AskDock, type AskDockProps, Breadcrumb, type ChartBlock, type ChartBlockConfig, OXY_MARK_PATH, OxyMark, OxyShell, type OxyShellProps, OxygenFactoryMark, type RailItem, ReasoningTrace, type ReasoningTraceProps, type ShellContextApp, type ShellContextData, ShellRail, ShellTooltip, SystemIndicator, type ThreadSummary, type ThreadTranscript, TopBar, type TraceItem, type TraceStep, type TraceStepStatus, type TranscriptTurn, type UseShellContextResult, type UseThreadHistoryResult, WorkspaceClock, WorkspaceTile, buildTraceSteps, fetchThreadTranscript, useShellContext, useThreadHistory, workspaceLogoUrl };
+export { AnswerChart, type AnswerChartProps, AskDock, type AskDockProps, Breadcrumb, type ChartBlock, type ChartBlockConfig, OXY_MARK_PATH, OxyMark, OxyShell, type OxyShellProps, OxygenFactoryMark, type RailItem, ReasoningTrace, type ReasoningTraceProps, type ShellContextApp, type ShellContextData, type ShellContextUser, ShellRail, ShellTooltip, SystemIndicator, type ThreadSummary, type ThreadTranscript, TopBar, type TraceItem, type TraceStep, type TraceStepStatus, type TranscriptTurn, type UseShellContextResult, type UseThreadHistoryResult, type ViewerIdentity, WorkspaceClock, WorkspaceTile, buildTraceSteps, fetchThreadTranscript, signOut, signOutUrl, useIdentity, useShellContext, useThreadHistory, workspaceLogoUrl };
 //# sourceMappingURL=shell.d.mts.map

package/dist/shell.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"shell.d.mts","names":[],"sources":["../src/shell/AnswerChart.tsx","../src/shell/AskDock.tsx","../src/shell/logoUrl.ts","../src/shell/marks.tsx","../src/shell/OxyShell.tsx","../src/shell/trace.ts","../src/shell/ReasoningTrace.tsx","../src/shell/ShellRail.tsx","../src/shell/shellContext.ts","../src/shell/Tooltip.tsx","../src/shell/TopBar.tsx","../src/shell/threadHistory.ts","../src/shell/WorkspaceTile.tsx"],"mappings":";;;;;UAYiB;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;UAGe;EACf,QAAQ;EACR;EACA;;UA8ce;EACf,OAAO;EACP;;;;;iBAMc,cAAc,OAAO,aAAa,mBAAgB,MAAA,IAAA;;;UCzUjD;;EAEf;;EAEA;;EAEA;;EAEA;EACA;EACA;EACA;;;;;;iBAuEc,UACd,SACA,eACA,aACA,aACA,MACA,SACA,aACC,eAAY,MAAA,IAAA;;;;;;;;cC7PF,mBAAgB,oBAAsB,qBAAqB;;;;cCA3D;;;iBAKG,UAAU;EAAe;oBAAoB,IAAA;;;;;;iBAyB7C,oBAAoB;EAAe;oBAAoB,IAAA;;;UC+BtD;EACf,UAAU;;EAEV;;;;;EAKA,aAAa;;;EAGb,cAAc;;;EAGd,aAAa;;EAEb;;;EAGA;;;;;;;;EAQA;EACA;;;;;EAKA;;;;EAIA;;;;;;iBAsDc,WACd,UACA,WACA,YACA,aACA,YACA,YACA,WACA,gBACA,WACA,kBACA,oBACC,gCAAa,IAAA;;;KC9JJ;UAEK;EACf;EACA;EACA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;EACA;EACA;;UAGe;EACf;EACA;EACA;EACA,QAAQ;EACR,OAAO;;;;iBA8IO,gBAAgB,QAAQ,kBAAkB;;;UCvDzC;EACf,OAAO;;EAEP;;EAEA;IAAQ;IAAe;;EACvB;;;;iBAKc,iBAAiB,OAAO,WAAmB,KAAK,aAAa,sCAAmB,IAAA;;;;;;;KCxHpF;EACV;EACA;;;EAGA;EACA;EACA;EACA,OAAO;EACP;EACA;EACA;EACA;;;;;;;iBAuDc,YACd,KACA,QACA,aACA,QACA;EAEA,MAAM;EACN,QAAQ;EACR,cAAc;EACd,SAAS;EACT;oBACD,IAAA;;;UC9EgB;EACf;EACA;EACA;;EAEA;EACA;;;EAGA;;EAEA;;UAGe;EACf;IAAa;IAAY;;EACzB;IAAO;IAAY;IAAc;;;EAEjC;;EAEA,MAAM;;;;EAIN;IAAS;IAAc;IAAiB;;;EAExC;IAAQ;IAAc;IAAe;;;UAGtB;EACf,MAAM;EACN;EACA,OAAO;;;;;;;;iBASO,mBAAmB;;;;;;;;iBC/CnB,eACd,SACA,MACA;EAEA,SAAS,MAAM;EACf;EACA,UAAU,MAAM;IACjB,MAAA,IAAA;;;;;iBCNe,SACd,MACA,OACA;EAEA,OAAO;EACP,QAAQ;EACR;oBACD,IAAA;;;;;;iBAqBe,aACd,gBACA,WACA,UACA;EAEA;EACA;EACA;EACA;oBACD,IAAA;;;;;;;iBAmDe,mCAAe,IAAA;;;;;;iBA+Bf,iBAAiB;EAAc;oBAAmB,IAAA;;;UCrHjD;EACf;EACA;EACA;;UAGe;EACf;EACA,QAAQ;;UAGO;EACf;EACA,OAAO;;UAGQ;EACf,SAAS;EACT;EACA,OAAO;;EAEP;;;;;;;iBAQc,oBAAoB;;;;;iBAyCd,sBACpB,SAAS,YACT,mBACA,mBACC,QAAQ;;;;;;iBCnFK,gBAAgB,MAAM;EAAa;EAAc;oBAAkB,IAAA"}
+{"version":3,"file":"shell.d.mts","names":[],"sources":["../src/shell/AnswerChart.tsx","../src/shell/AskDock.tsx","../src/shell/logoUrl.ts","../src/shell/marks.tsx","../src/shell/OxyShell.tsx","../src/shell/trace.ts","../src/shell/ReasoningTrace.tsx","../src/shell/ShellRail.tsx","../src/shell/shellContext.ts","../src/shell/Tooltip.tsx","../src/shell/TopBar.tsx","../src/shell/threadHistory.ts","../src/shell/WorkspaceTile.tsx"],"mappings":";;;;;;UAYiB;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;UAGe;EACf,QAAQ;EACR;EACA;;UA8ce;EACf,OAAO;EACP;;;;;iBAMc,cAAc,OAAO,aAAa,mBAAgB,MAAA,IAAA;;;UCzUjD;;EAEf;;EAEA;;EAEA;;EAEA;EACA;EACA;EACA;;;;;;iBAuEc,UACd,SACA,eACA,aACA,aACA,MACA,SACA,aACC,eAAY,MAAA,IAAA;;;;;;;;cC7PF,mBAAgB,oBAAsB,qBAAqB;;;;cCA3D;;;iBAKG,UAAU;EAAe;oBAAoB,IAAA;;;;;;iBAyB7C,oBAAoB;EAAe;oBAAoB,IAAA;;;UC+BtD;EACf,UAAU;;EAEV;;;;;EAKA,aAAa;;;EAGb,cAAc;;;EAGd,aAAa;;EAEb;;;EAGA;;;;;;;;EAQA;EACA;;;;;EAKA;;;;EAIA;;;;;;iBAsDc,WACd,UACA,WACA,YACA,aACA,YACA,YACA,WACA,gBACA,WACA,kBACA,oBACC,gCAAa,IAAA;;;KC9JJ;UAEK;EACf;EACA;EACA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;EACA;EACA;;UAGe;EACf;EACA;EACA;EACA,QAAQ;EACR,OAAO;;;;iBA8IO,gBAAgB,QAAQ,kBAAkB;;;UCvDzC;EACf,OAAO;;EAEP;;EAEA;IAAQ;IAAe;;EACvB;;;;iBAKc,iBAAiB,OAAO,WAAmB,KAAK,aAAa,sCAAmB,IAAA;;;;;;;KCxHpF;EACV;EACA;;;EAGA;EACA;EACA;EACA,OAAO;EACP;EACA;EACA;EACA;;;;;;;iBAuDc,YACd,KACA,QACA,aACA,QACA;EAEA,MAAM;EACN,QAAQ;EACR,cAAc;EACd,SAAS;EACT;oBACD,IAAA;;;UC7EgB;EACf;EACA;EACA;;EAEA;EACA;;;EAGA;;EAEA;;UAGe;EACf;IAAa;IAAY;;EACzB;IAAO;IAAY;IAAc;;;EAEjC;;EAEA,MAAM;;;;;EAKN;IAAS;IAAc;IAAiB;IAAmB;;;EAE3D,MAAM;;;;;;;;UASS;EACf;;EAEA;EACA;EACA;;EAEA;EACA,QAAQ;;UAGO;EACf,MAAM;EACN;EACA,OAAO;;;;;;;;iBASO,mBAAmB;;UA4ClB;EACf;EACA;;EAEA;EACA;EACA;;EAEA,OAAO;EACP;;;;;;;;iBAWc,eAAe;;;;;;;;;;iBAuBf,WAAW,qCAAqC;;;;;;;;;;;iBAgB1C,QACpB,UAAU,OAAO,cAAc,KAAK,OAAO,gBAAgB,QAAQ,WACnE,0BACA,oBACC;;;;;;;;iBC7Ka,eACd,SACA,MACA;EAEA,SAAS,MAAM;EACf;EACA,UAAU,MAAM;IACjB,MAAA,IAAA;;;;;iBCNe,SACd,MACA,OACA;EAEA,OAAO;EACP,QAAQ;EACR;oBACD,IAAA;;;;;;iBAqBe,aACd,gBACA,WACA,UACA;EAEA;EACA;EACA;EACA;oBACD,IAAA;;;;;;;iBAmDe,mCAAe,IAAA;;;;;;iBA+Bf,iBAAiB;EAAc;oBAAmB,IAAA;;;UCrHjD;EACf;EACA;EACA;;UAGe;EACf;EACA,QAAQ;;UAGO;EACf;EACA,OAAO;;UAGQ;EACf,SAAS;EACT;EACA,OAAO;;EAEP;;;;;;;iBAQc,oBAAoB;;;;;iBAyCd,sBACpB,SAAS,YACT,mBACA,mBACC,QAAQ;;;;;;iBCnFK,gBAAgB,MAAM;EAAa;EAAc;oBAAkB,IAAA"}

package/dist/shell.mjs

@@ -1,5 +1,5 @@
 // @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-DqnINwTi.mjs";
+import { i as useAgentRun, l as useResolvedManifest, o as useOxyApp, t as OxyAnswer, v as getOxyAppLogger } from "./react-Cq3xULOr.mjs";
 import * as React from "react";
 import { Fragment, useEffect, useMemo, useState } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
@@ -1785,7 +1785,7 @@ function ShellRail({ top, groups, footerItems, bottom, className }) {
 * endpoint), so errors are surfaced on the result, never thrown.
 */
 function useShellContext() {
-	const { projectId, fetcher } = useOxyApp();
+	const { projectId, appId, fetcher } = useOxyApp();
 	const [state, setState] = React.useState({
 		data: null,
 		loading: true,
@@ -1801,7 +1801,8 @@ function useShellContext() {
 			return;
 		}
 		let cancelled = false;
-		fetcher(`/api/projects/${projectId}/shell-context`, { method: "GET" }).then(async (resp) => {
+		const query = appId ? `?app=${encodeURIComponent(appId)}` : "";
+		fetcher(`/api/projects/${projectId}/shell-context${query}`, { 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({
@@ -1821,9 +1822,69 @@ function useShellContext() {
 		return () => {
 			cancelled = true;
 		};
-	}, [projectId, fetcher]);
+	}, [
+		projectId,
+		appId,
+		fetcher
+	]);
 	return state;
 }
+const NOWHERE = {
+	everywhere: false,
+	via: null,
+	locations: []
+};
+/**
+* The viewer, in one shape, on every server version: who is signed in, the
+* crew-or-office signal, and where they work — for a greeting, a "your
+* store" default, or hiding a tab. Never for authorization: a browser can
+* edit what it renders, and the function's `ctx.user.reach` is the gate.
+*/
+function useIdentity() {
+	const { data, loading } = useShellContext();
+	const u = data?.user ?? null;
+	return {
+		id: u?.id ?? null,
+		name: u?.name ?? "",
+		email: u?.email ? u.email : null,
+		picture: u?.picture ?? null,
+		kind: u?.kind ?? null,
+		reach: u?.reach ?? NOWHERE,
+		loading
+	};
+}
+/**
+* Where a signed-out person lands: the product's login page, with this app
+* as the place to come back to.
+*
+* `loginUrl` is `links.login` from the shell context — the product host's,
+* which a custom-app subdomain cannot derive — and `/login` on the current
+* origin when the context is unavailable or the server predates the field.
+* `returnTo` is the app's own address, which it knows legitimately.
+*/
+function signOutUrl(loginUrl, returnTo) {
+	const base = loginUrl?.trim() ? loginUrl.trim() : "/login";
+	return `${base}${base.includes("?") ? "&" : "?"}return_to=${encodeURIComponent(returnTo)}`;
+}
+/**
+* End the platform session, then leave for the login page.
+*
+* `GET /api/logout` clears the session cookie server-side. That is the same
+* cookie a crew member's PIN session rides, so on an enrolled tablet the login
+* page comes back as "Who's on shift?" and returns to the app after the next
+* PIN; elsewhere it is the ordinary sign-in. Throws when the server refused,
+* so a caller can say so rather than navigate away from a session that still
+* exists. Pass the app's `fetcher` from `useOxyApp()` so credentials ride.
+*/
+async function signOut(fetcher, loginUrl, returnTo) {
+	const res = await fetcher("/api/logout", {
+		method: "GET",
+		credentials: "include"
+	});
+	if (!res.ok) throw new Error(`sign-out refused: HTTP ${res.status}`);
+	if (typeof window === "undefined") return;
+	window.location.assign(signOutUrl(loginUrl, returnTo ?? window.location.href));
+}
 
 //#endregion
 //#region src/shell/TopBar.tsx
@@ -2150,5 +2211,5 @@ function OxyShell({ children, pageLabel, topBarLeft, topBarExtra, railBottom, hi
 }
 
 //#endregion
-export { AnswerChart, AskDock, Breadcrumb, OXY_MARK_PATH, OxyMark, OxyShell, OxygenFactoryMark, ReasoningTrace, ShellRail, ShellTooltip, SystemIndicator, TopBar, WorkspaceClock, WorkspaceTile, buildTraceSteps, fetchThreadTranscript, useShellContext, useThreadHistory, workspaceLogoUrl };
+export { AnswerChart, AskDock, Breadcrumb, OXY_MARK_PATH, OxyMark, OxyShell, OxygenFactoryMark, ReasoningTrace, ShellRail, ShellTooltip, SystemIndicator, TopBar, WorkspaceClock, WorkspaceTile, buildTraceSteps, fetchThreadTranscript, signOut, signOutUrl, useIdentity, useShellContext, useThreadHistory, workspaceLogoUrl };
 //# sourceMappingURL=shell.mjs.map