@proteos/component-sdk 0.59.2 → 0.61.0

package/dist/{chunk-3VUWWDED.cjs → chunk-HD5ADY7F.cjs}

@@ -14,5 +14,5 @@ exports.COMPONENT_OVERLAY_Z_INDEX = COMPONENT_OVERLAY_Z_INDEX;
 exports.MESSAGE_SOURCE = MESSAGE_SOURCE;
 exports.isHostMessage = isHostMessage;
 exports.isRuntimeMessage = isRuntimeMessage;
-//# sourceMappingURL=chunk-3VUWWDED.cjs.map
-//# sourceMappingURL=chunk-3VUWWDED.cjs.map
+//# sourceMappingURL=chunk-HD5ADY7F.cjs.map
+//# sourceMappingURL=chunk-HD5ADY7F.cjs.map

package/dist/{chunk-3VUWWDED.cjs.map → chunk-HD5ADY7F.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/protocol.ts"],"names":[],"mappings":";;;AAUO,IAAM,cAAA,GAAiB;AAuBvB,IAAM,yBAAA,GAA4B;AAmNlC,SAAS,cAAc,IAAA,EAA8C;AAC1E,EAAA,OACE,OAAO,IAAA,KAAS,QAAA,IAChB,IAAA,KAAS,IAAA,IACR,KAA8B,MAAA,KAAW,cAAA,IAC1C,OAAQ,IAAA,CAA4B,IAAA,KAAS,QAAA;AAEjD;AAEO,SAAS,iBAAiB,IAAA,EAAiD;AAChF,EAAA,OACE,OAAO,IAAA,KAAS,QAAA,IAChB,IAAA,KAAS,IAAA,IACR,KAA8B,MAAA,KAAW,cAAA,IAC1C,OAAQ,IAAA,CAA4B,IAAA,KAAS,QAAA;AAEjD","file":"chunk-3VUWWDED.cjs","sourcesContent":["// postMessage protocol between the host page and the component-runtime iframe.\n// This is the single source of truth for the wire contract: the host renderer\n// (clients/web .../component-frame.tsx), the runtime shell\n// (clients/web/component-runtime/shell.tsx), and the author-facing hooks\n// (this package's RuntimeProvider / useNavigate) all import these same types so\n// every end stays in lockstep.\n//\n// Every message carries `source: MESSAGE_SOURCE` so we can ignore the unrelated\n// postMessage traffic that shares the window (OIDC silent-renew, Vite HMR, …).\n\nexport const MESSAGE_SOURCE = 'proteos-component-runtime' as const\n\n/**\n * z-index the component iframe is promoted to while one of its own overlays\n * (modal, popover, menu, select, tooltip) is open. The iframe goes\n * `position: fixed; inset: 0` at this z so the overlay — which portals to the\n * IFRAME's body and would otherwise clip at the frame's box — can paint over\n * the rest of the page.\n *\n * Host z ladder this slots into:\n *   50    @proteos/ui Modal / Tooltip / ImageLightbox (default tier)\n *   1000+ full-page panel stack (scrim 1000, panels 1001+n)\n *   1090  peek scrim   1100  peek panel, ask-proteos window\n *   1150  ← THIS\n *   1200  menu popover, command palette, action dialog, component modal\n *   1300  select popover\n *\n * Above the peek/full-page surfaces a component can live on, below the global\n * host chrome. Note the cap: inside a peek (a `fixed` + z-index ancestor) the\n * promoted iframe paints within that 1100 stacking context — it covers the\n * peek's own content and everything under it, but host chrome at 1200+ still\n * wins. That is the intended layering, not a bug.\n */\nexport const COMPONENT_OVERLAY_Z_INDEX = 1150\n\n/** Viewport-relative box of the iframe's in-flow placeholder, in CSS px. */\nexport interface OverlayRect {\n  top: number\n  left: number\n  width: number\n  height: number\n}\n\nexport interface PageContext {\n  record?: Record<string, unknown>\n  entity?: { slug: string; [key: string]: unknown }\n  params?: Record<string, unknown>\n  /** The signed-in viewer (absent on public pages and offline previews). The\n   *  host resolves `{{ current_user.* }}` and the bare `current_user` prop\n   *  sentinel against it before posting props. */\n  current_user?: { id: string; email: string; given_name: string; family_name: string }\n  [key: string]: unknown\n}\n\n// ── Host → runtime ──────────────────────────────────────────────────────────\n\nexport interface InitMessage {\n  type: 'INIT'\n  /** Raw bearer token (the OIDC `id_token`). The runtime's ProteosClient\n   *  prepends `Bearer ` when building the Authorization header, so the host\n   *  sends the token verbatim — NOT a full `Bearer …` header value.\n   *  Empty string in public mode (`isPublic: true`). */\n  authToken: string\n  /** API origin the bundle endpoint + SDK calls resolve against. */\n  apiBaseUrl: string\n  /** Resolved props for the component (Liquid templating happens host-side). */\n  props: Record<string, unknown>\n  pageCtx: PageContext\n  /** PUBLIC mode: the component renders on an unauthenticated public page.\n   *  The shell fetches the bundle from the public endpoint (no bearer) and\n   *  injects a restricted sdk — only `functions.actions.invokePublic` reaches\n   *  the platform. Requires `orgId`. */\n  isPublic?: boolean\n  /** Org id for public mode — public endpoints carry the org in the path\n   *  because there is no token to scope from. */\n  orgId?: string\n  /** Set when this frame is the CONTENT of a host component modal (opened by\n   *  another component via OPEN_MODAL). The component reads it through\n   *  `useModalHost()` and closes with a result by posting MODAL_RESULT with\n   *  this id. Absent on ordinary page-hosted frames. */\n  modalRequestId?: string\n}\n\nexport interface AuthRefreshMessage {\n  type: 'AUTH_REFRESH'\n  token: string\n}\n\nexport interface DataInvalidateMessage {\n  type: 'DATA_INVALIDATE'\n  queryKey?: unknown[]\n}\n\n/** Where the iframe's in-flow box sits in the host viewport. Sent while the\n *  frame is promoted (OVERLAY_STATE open) so the runtime can keep its content\n *  parked at the original rect while the iframe itself covers the viewport —\n *  and re-sent when the host window resizes under an open overlay. */\nexport interface OverlayRectMessage {\n  type: 'OVERLAY_RECT'\n  rect: OverlayRect\n}\n\n/** Resolution of an OPEN_MODAL request: the host modal closed. `result` is the\n *  value the modal's component passed to MODAL_RESULT, and is absent when the\n *  modal was dismissed (backdrop / Esc / ×). */\nexport interface ModalClosedMessage {\n  type: 'MODAL_CLOSED'\n  requestId: string\n  result?: unknown\n}\n\nexport type HostMessage =\n  | InitMessage\n  | AuthRefreshMessage\n  | DataInvalidateMessage\n  | OverlayRectMessage\n  | ModalClosedMessage\n\n// ── Runtime → host ──────────────────────────────────────────────────────────\n\nexport interface ReadyMessage {\n  type: 'READY'\n}\n\nexport interface ResizeMessage {\n  type: 'RESIZE'\n  height: number\n}\n\nexport interface NavigateMessage {\n  type: 'NAVIGATE'\n  to: string\n}\n\n/** Open an in-app path in a peek (slide-over) panel instead of full-page\n *  navigation. Same `/…` in-app path grammar as NAVIGATE; the host decides\n *  what can peek (today: platform pages) and falls back to NAVIGATE otherwise. */\nexport interface OpenPeekMessage {\n  type: 'OPEN_PEEK'\n  to: string\n}\n\n/** Ask the host to open a prepared call: the host shows the conversation brief's\n *  preview (its softphone owns the dial) and lets the user place the call.\n *  Ignored on public pages and on hosts without a softphone. */\nexport interface OpenCallMessage {\n  type: 'OPEN_CALL'\n  /** The conversation brief to preview and dial from. */\n  conversationBriefId: string\n}\n\n/** The runtime has (or no longer has) an overlay open and needs the host to\n *  promote (or restore) the iframe. See {@link COMPONENT_OVERLAY_Z_INDEX}.\n *\n *  Same-origin today, so the runtime applies the promotion styles to its own\n *  `window.frameElement` synchronously (pre-paint, no flicker) and this message\n *  is the host's cue to MIRROR that state into React — gate RESIZE, hold the\n *  placeholder height, start posting OVERLAY_RECT. When components move to a\n *  dedicated origin the runtime can no longer touch the frame and this message\n *  becomes the actuation instead; the runtime hides its overlay until the\n *  answering OVERLAY_RECT arrives. */\nexport interface OverlayStateMessage {\n  type: 'OVERLAY_STATE'\n  open: boolean\n}\n\n/** Width of a host component modal's panel: `sm` 384px, `md` 512px, `lg` 672px,\n *  `xl` 896px. Below 640px the modal is a full-screen sheet whatever the\n *  width. */\nexport type ModalWidth = 'sm' | 'md' | 'lg' | 'xl'\n\n/** Ask the host to open ANOTHER component in a central modal, above everything\n *  this frame could reach on its own. The host answers with MODAL_CLOSED\n *  carrying the same `requestId`.\n *\n *  One modal per opener at a time: while a request from this frame is still\n *  open, the host answers any further OPEN_MODAL from it as dismissed (a\n *  double click must not stack two dialogs). The modal's own component may\n *  open another — that request comes from a different frame. */\nexport interface OpenModalMessage {\n  type: 'OPEN_MODAL'\n  /** Correlates the eventual MODAL_CLOSED. Generated by the opener. */\n  requestId: string\n  /** Slug of the component to mount inside the modal. */\n  componentSlug: string\n  /** Props for that component. The host renders Liquid in every string value\n   *  against the OPENER's page scope (`record`, `entity`, `params`,\n   *  `current_user`) before handing them over — exactly as it does for a\n   *  page-placed component. So `{{ … }}` / `{% … %}` in a value is evaluated,\n   *  not passed through. */\n  props?: Record<string, unknown>\n  /** Optional modal heading. */\n  title?: string\n  /** Panel width. Defaults to `lg`. */\n  width?: ModalWidth\n  /** Height of the component's frame, in px. Set: the frame is that tall from\n   *  the first paint (capped at the viewport), scrolls its own content, and\n   *  sits edge to edge in the panel — the component owns its padding. Unset:\n   *  the frame grows with its content inside the host's padded body. */\n  height?: number\n}\n\n/** Escape was pressed with focus inside the iframe, and nothing in the runtime\n *  consumed it.\n *\n *  Keyboard events don't cross the iframe boundary, and react-aria binds its\n *  Escape handling to the overlay element in its own React tree — so a\n *  host-rendered dialog CANNOT see Escape once the user has clicked into a\n *  component. The runtime forwards it so the host can dismiss on the user's\n *  behalf. Not sent while the runtime has its own overlay open: that overlay\n *  owns Escape. */\nexport interface EscapePressedMessage {\n  type: 'ESCAPE_PRESSED'\n}\n\n/** Posted by the component INSIDE a host modal to close it with a value. The\n *  `requestId` is the one INIT carried as `modalRequestId`. */\nexport interface ModalResultMessage {\n  type: 'MODAL_RESULT'\n  requestId: string\n  result?: unknown\n}\n\nexport interface ErrorMessage {\n  type: 'ERROR'\n  message: string\n  stack?: string\n}\n\nexport type RuntimeMessage =\n  | ReadyMessage\n  | ResizeMessage\n  | NavigateMessage\n  | OpenPeekMessage\n  | OpenCallMessage\n  | OverlayStateMessage\n  | OpenModalMessage\n  | ModalResultMessage\n  | EscapePressedMessage\n  | ErrorMessage\n\n// Wire envelope: the message plus the source discriminator.\nexport type Envelope<T> = T & { source: typeof MESSAGE_SOURCE }\n\nexport function isHostMessage(data: unknown): data is Envelope<HostMessage> {\n  return (\n    typeof data === 'object' &&\n    data !== null &&\n    (data as { source?: unknown }).source === MESSAGE_SOURCE &&\n    typeof (data as { type?: unknown }).type === 'string'\n  )\n}\n\nexport function isRuntimeMessage(data: unknown): data is Envelope<RuntimeMessage> {\n  return (\n    typeof data === 'object' &&\n    data !== null &&\n    (data as { source?: unknown }).source === MESSAGE_SOURCE &&\n    typeof (data as { type?: unknown }).type === 'string'\n  )\n}\n"]}
+{"version":3,"sources":["../src/protocol.ts"],"names":[],"mappings":";;;AAUO,IAAM,cAAA,GAAiB;AAuBvB,IAAM,yBAAA,GAA4B;AA2OlC,SAAS,cAAc,IAAA,EAA8C;AAC1E,EAAA,OACE,OAAO,IAAA,KAAS,QAAA,IAChB,IAAA,KAAS,IAAA,IACR,KAA8B,MAAA,KAAW,cAAA,IAC1C,OAAQ,IAAA,CAA4B,IAAA,KAAS,QAAA;AAEjD;AAEO,SAAS,iBAAiB,IAAA,EAAiD;AAChF,EAAA,OACE,OAAO,IAAA,KAAS,QAAA,IAChB,IAAA,KAAS,IAAA,IACR,KAA8B,MAAA,KAAW,cAAA,IAC1C,OAAQ,IAAA,CAA4B,IAAA,KAAS,QAAA;AAEjD","file":"chunk-HD5ADY7F.cjs","sourcesContent":["// postMessage protocol between the host page and the component-runtime iframe.\n// This is the single source of truth for the wire contract: the host renderer\n// (clients/web .../component-frame.tsx), the runtime shell\n// (clients/web/component-runtime/shell.tsx), and the author-facing hooks\n// (this package's RuntimeProvider / useNavigate) all import these same types so\n// every end stays in lockstep.\n//\n// Every message carries `source: MESSAGE_SOURCE` so we can ignore the unrelated\n// postMessage traffic that shares the window (OIDC silent-renew, Vite HMR, …).\n\nexport const MESSAGE_SOURCE = 'proteos-component-runtime' as const\n\n/**\n * z-index the component iframe is promoted to while one of its own overlays\n * (modal, popover, menu, select, tooltip) is open. The iframe goes\n * `position: fixed; inset: 0` at this z so the overlay — which portals to the\n * IFRAME's body and would otherwise clip at the frame's box — can paint over\n * the rest of the page.\n *\n * Host z ladder this slots into:\n *   50    @proteos/ui Modal / Tooltip / ImageLightbox (default tier)\n *   1000+ full-page panel stack (scrim 1000, panels 1001+n)\n *   1090  peek scrim   1100  peek panel, ask-proteos window\n *   1150  ← THIS\n *   1200  menu popover, command palette, action dialog, component modal\n *   1300  select popover\n *\n * Above the peek/full-page surfaces a component can live on, below the global\n * host chrome. Note the cap: inside a peek (a `fixed` + z-index ancestor) the\n * promoted iframe paints within that 1100 stacking context — it covers the\n * peek's own content and everything under it, but host chrome at 1200+ still\n * wins. That is the intended layering, not a bug.\n */\nexport const COMPONENT_OVERLAY_Z_INDEX = 1150\n\n/** Viewport-relative box of the iframe's in-flow placeholder, in CSS px. */\nexport interface OverlayRect {\n  top: number\n  left: number\n  width: number\n  height: number\n}\n\nexport interface PageContext {\n  record?: Record<string, unknown>\n  entity?: { slug: string; [key: string]: unknown }\n  params?: Record<string, unknown>\n  /** The signed-in viewer (absent on public pages and offline previews). The\n   *  host resolves `{{ current_user.* }}` and the bare `current_user` prop\n   *  sentinel against it before posting props. */\n  current_user?: { id: string; email: string; given_name: string; family_name: string }\n  [key: string]: unknown\n}\n\n// ── Host → runtime ──────────────────────────────────────────────────────────\n\nexport interface InitMessage {\n  type: 'INIT'\n  /** Raw bearer token (the OIDC `id_token`). The runtime's ProteosClient\n   *  prepends `Bearer ` when building the Authorization header, so the host\n   *  sends the token verbatim — NOT a full `Bearer …` header value.\n   *  Empty string in public mode (`isPublic: true`). */\n  authToken: string\n  /** API origin the bundle endpoint + SDK calls resolve against. */\n  apiBaseUrl: string\n  /** Resolved props for the component (Liquid templating happens host-side). */\n  props: Record<string, unknown>\n  pageCtx: PageContext\n  /** PUBLIC mode: the component renders on an unauthenticated public page.\n   *  The shell fetches the bundle from the public endpoint (no bearer) and\n   *  injects a restricted sdk — only `functions.actions.invokePublic` reaches\n   *  the platform. Requires `orgId`. */\n  isPublic?: boolean\n  /** Org id for public mode — public endpoints carry the org in the path\n   *  because there is no token to scope from. */\n  orgId?: string\n  /** Set when this frame is the CONTENT of a host component modal (opened by\n   *  another component via OPEN_MODAL). The component reads it through\n   *  `useModalHost()` and closes with a result by posting MODAL_RESULT with\n   *  this id. Absent on ordinary page-hosted frames. */\n  modalRequestId?: string\n}\n\nexport interface AuthRefreshMessage {\n  type: 'AUTH_REFRESH'\n  token: string\n}\n\nexport interface DataInvalidateMessage {\n  type: 'DATA_INVALIDATE'\n  queryKey?: unknown[]\n}\n\n/** Where the iframe's in-flow box sits in the host viewport. Sent while the\n *  frame is promoted (OVERLAY_STATE open) so the runtime can keep its content\n *  parked at the original rect while the iframe itself covers the viewport —\n *  and re-sent when the host window resizes under an open overlay. */\nexport interface OverlayRectMessage {\n  type: 'OVERLAY_RECT'\n  rect: OverlayRect\n}\n\n/** Resolution of an OPEN_MODAL request: the host modal closed. `result` is the\n *  value the modal's component passed to MODAL_RESULT, and is absent when the\n *  modal was dismissed (backdrop / Esc / ×). */\nexport interface ModalClosedMessage {\n  type: 'MODAL_CLOSED'\n  requestId: string\n  result?: unknown\n}\n\nexport type HostMessage =\n  | InitMessage\n  | AuthRefreshMessage\n  | DataInvalidateMessage\n  | OverlayRectMessage\n  | ModalClosedMessage\n\n// ── Runtime → host ──────────────────────────────────────────────────────────\n\nexport interface ReadyMessage {\n  type: 'READY'\n}\n\nexport interface ResizeMessage {\n  type: 'RESIZE'\n  height: number\n}\n\nexport interface NavigateMessage {\n  type: 'NAVIGATE'\n  to: string\n}\n\n/** Open an in-app path in a peek (slide-over) panel instead of full-page\n *  navigation. Same `/…` in-app path grammar as NAVIGATE; the host decides\n *  what can peek (today: platform pages) and falls back to NAVIGATE otherwise. */\nexport interface OpenPeekMessage {\n  type: 'OPEN_PEEK'\n  to: string\n}\n\n/** Ask the host to open a prepared call: the host shows the conversation brief's\n *  preview (its softphone owns the dial) and lets the user place the call.\n *  Ignored on public pages and on hosts without a softphone. */\nexport interface OpenCallMessage {\n  type: 'OPEN_CALL'\n  /** The conversation brief to preview and dial from. */\n  conversationBriefId: string\n}\n\n/** The runtime has (or no longer has) an overlay open and needs the host to\n *  promote (or restore) the iframe. See {@link COMPONENT_OVERLAY_Z_INDEX}.\n *\n *  Same-origin today, so the runtime applies the promotion styles to its own\n *  `window.frameElement` synchronously (pre-paint, no flicker) and this message\n *  is the host's cue to MIRROR that state into React — gate RESIZE, hold the\n *  placeholder height, start posting OVERLAY_RECT. When components move to a\n *  dedicated origin the runtime can no longer touch the frame and this message\n *  becomes the actuation instead; the runtime hides its overlay until the\n *  answering OVERLAY_RECT arrives. */\nexport interface OverlayStateMessage {\n  type: 'OVERLAY_STATE'\n  open: boolean\n}\n\n/** Width of a host component modal's panel: `sm` 384px, `md` 512px, `lg` 672px,\n *  `xl` 896px. Below 640px the modal is a full-screen sheet whatever the\n *  width. */\nexport type ModalWidth = 'sm' | 'md' | 'lg' | 'xl'\n\n/** Ask the host to open ANOTHER component in a central modal, above everything\n *  this frame could reach on its own. The host answers with MODAL_CLOSED\n *  carrying the same `requestId`.\n *\n *  One modal per opener at a time: while a request from this frame is still\n *  open, the host answers any further OPEN_MODAL from it as dismissed (a\n *  double click must not stack two dialogs). The modal's own component may\n *  open another — that request comes from a different frame. */\nexport interface OpenModalMessage {\n  type: 'OPEN_MODAL'\n  /** Correlates the eventual MODAL_CLOSED. Generated by the opener. */\n  requestId: string\n  /** Slug of the component to mount inside the modal. */\n  componentSlug: string\n  /** Props for that component. The host renders Liquid in every string value\n   *  against the OPENER's page scope (`record`, `entity`, `params`,\n   *  `current_user`) before handing them over — exactly as it does for a\n   *  page-placed component. So `{{ … }}` / `{% … %}` in a value is evaluated,\n   *  not passed through. */\n  props?: Record<string, unknown>\n  /** Optional modal heading. */\n  title?: string\n  /** Panel width. Defaults to `lg`. */\n  width?: ModalWidth\n  /** Height of the component's frame, in px. Set: the frame is that tall from\n   *  the first paint (capped at the viewport), scrolls its own content, and\n   *  sits edge to edge in the panel — the component owns its padding. Unset:\n   *  the frame grows with its content inside the host's padded body. */\n  height?: number\n}\n\n/** Escape was pressed with focus inside the iframe, and nothing in the runtime\n *  consumed it.\n *\n *  Keyboard events don't cross the iframe boundary, and react-aria binds its\n *  Escape handling to the overlay element in its own React tree — so a\n *  host-rendered dialog CANNOT see Escape once the user has clicked into a\n *  component. The runtime forwards it so the host can dismiss on the user's\n *  behalf. Not sent while the runtime has its own overlay open: that overlay\n *  owns Escape. */\nexport interface EscapePressedMessage {\n  type: 'ESCAPE_PRESSED'\n}\n\n/** Posted by the component INSIDE a host modal to close it with a value. The\n *  `requestId` is the one INIT carried as `modalRequestId`. */\nexport interface ModalResultMessage {\n  type: 'MODAL_RESULT'\n  requestId: string\n  result?: unknown\n}\n\n/** Ask the host to open its agent session window (the floating assistant).\n *\n *  - `sessionId` set: the window resumes THAT session (its agent is read from\n *    the session). A `prompt` is sent into it.\n *  - no `sessionId`: a fresh session with `agentKey` (or the agent currently\n *    selected in the window); a `prompt` is sent as its first message. With\n *    neither field the window just opens as it is.\n *\n *  Ignored on public pages (there is no signed-in user to run an agent as). */\nexport interface OpenAgentWindowMessage {\n  type: 'OPEN_AGENT_WINDOW'\n  sessionId?: string\n  agentKey?: string\n  prompt?: string\n}\n\n/** Ask the host to minimize its agent session window. The active session and\n *  its stream stay alive — reopening resumes it. */\nexport interface CloseAgentWindowMessage {\n  type: 'CLOSE_AGENT_WINDOW'\n}\n\nexport interface ErrorMessage {\n  type: 'ERROR'\n  message: string\n  stack?: string\n}\n\nexport type RuntimeMessage =\n  | ReadyMessage\n  | ResizeMessage\n  | NavigateMessage\n  | OpenPeekMessage\n  | OpenCallMessage\n  | OverlayStateMessage\n  | OpenModalMessage\n  | ModalResultMessage\n  | EscapePressedMessage\n  | OpenAgentWindowMessage\n  | CloseAgentWindowMessage\n  | ErrorMessage\n\n// Wire envelope: the message plus the source discriminator.\nexport type Envelope<T> = T & { source: typeof MESSAGE_SOURCE }\n\nexport function isHostMessage(data: unknown): data is Envelope<HostMessage> {\n  return (\n    typeof data === 'object' &&\n    data !== null &&\n    (data as { source?: unknown }).source === MESSAGE_SOURCE &&\n    typeof (data as { type?: unknown }).type === 'string'\n  )\n}\n\nexport function isRuntimeMessage(data: unknown): data is Envelope<RuntimeMessage> {\n  return (\n    typeof data === 'object' &&\n    data !== null &&\n    (data as { source?: unknown }).source === MESSAGE_SOURCE &&\n    typeof (data as { type?: unknown }).type === 'string'\n  )\n}\n"]}

package/dist/{chunk-HODSL6ER.js → chunk-NOCSMXCW.js}

@@ -9,5 +9,5 @@ function isRuntimeMessage(data) {
 }
 
 export { COMPONENT_OVERLAY_Z_INDEX, MESSAGE_SOURCE, isHostMessage, isRuntimeMessage };
-//# sourceMappingURL=chunk-HODSL6ER.js.map
-//# sourceMappingURL=chunk-HODSL6ER.js.map
+//# sourceMappingURL=chunk-NOCSMXCW.js.map
+//# sourceMappingURL=chunk-NOCSMXCW.js.map

package/dist/{chunk-HODSL6ER.js.map → chunk-NOCSMXCW.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/protocol.ts"],"names":[],"mappings":";AAUO,IAAM,cAAA,GAAiB;AAuBvB,IAAM,yBAAA,GAA4B;AAmNlC,SAAS,cAAc,IAAA,EAA8C;AAC1E,EAAA,OACE,OAAO,IAAA,KAAS,QAAA,IAChB,IAAA,KAAS,IAAA,IACR,KAA8B,MAAA,KAAW,cAAA,IAC1C,OAAQ,IAAA,CAA4B,IAAA,KAAS,QAAA;AAEjD;AAEO,SAAS,iBAAiB,IAAA,EAAiD;AAChF,EAAA,OACE,OAAO,IAAA,KAAS,QAAA,IAChB,IAAA,KAAS,IAAA,IACR,KAA8B,MAAA,KAAW,cAAA,IAC1C,OAAQ,IAAA,CAA4B,IAAA,KAAS,QAAA;AAEjD","file":"chunk-HODSL6ER.js","sourcesContent":["// postMessage protocol between the host page and the component-runtime iframe.\n// This is the single source of truth for the wire contract: the host renderer\n// (clients/web .../component-frame.tsx), the runtime shell\n// (clients/web/component-runtime/shell.tsx), and the author-facing hooks\n// (this package's RuntimeProvider / useNavigate) all import these same types so\n// every end stays in lockstep.\n//\n// Every message carries `source: MESSAGE_SOURCE` so we can ignore the unrelated\n// postMessage traffic that shares the window (OIDC silent-renew, Vite HMR, …).\n\nexport const MESSAGE_SOURCE = 'proteos-component-runtime' as const\n\n/**\n * z-index the component iframe is promoted to while one of its own overlays\n * (modal, popover, menu, select, tooltip) is open. The iframe goes\n * `position: fixed; inset: 0` at this z so the overlay — which portals to the\n * IFRAME's body and would otherwise clip at the frame's box — can paint over\n * the rest of the page.\n *\n * Host z ladder this slots into:\n *   50    @proteos/ui Modal / Tooltip / ImageLightbox (default tier)\n *   1000+ full-page panel stack (scrim 1000, panels 1001+n)\n *   1090  peek scrim   1100  peek panel, ask-proteos window\n *   1150  ← THIS\n *   1200  menu popover, command palette, action dialog, component modal\n *   1300  select popover\n *\n * Above the peek/full-page surfaces a component can live on, below the global\n * host chrome. Note the cap: inside a peek (a `fixed` + z-index ancestor) the\n * promoted iframe paints within that 1100 stacking context — it covers the\n * peek's own content and everything under it, but host chrome at 1200+ still\n * wins. That is the intended layering, not a bug.\n */\nexport const COMPONENT_OVERLAY_Z_INDEX = 1150\n\n/** Viewport-relative box of the iframe's in-flow placeholder, in CSS px. */\nexport interface OverlayRect {\n  top: number\n  left: number\n  width: number\n  height: number\n}\n\nexport interface PageContext {\n  record?: Record<string, unknown>\n  entity?: { slug: string; [key: string]: unknown }\n  params?: Record<string, unknown>\n  /** The signed-in viewer (absent on public pages and offline previews). The\n   *  host resolves `{{ current_user.* }}` and the bare `current_user` prop\n   *  sentinel against it before posting props. */\n  current_user?: { id: string; email: string; given_name: string; family_name: string }\n  [key: string]: unknown\n}\n\n// ── Host → runtime ──────────────────────────────────────────────────────────\n\nexport interface InitMessage {\n  type: 'INIT'\n  /** Raw bearer token (the OIDC `id_token`). The runtime's ProteosClient\n   *  prepends `Bearer ` when building the Authorization header, so the host\n   *  sends the token verbatim — NOT a full `Bearer …` header value.\n   *  Empty string in public mode (`isPublic: true`). */\n  authToken: string\n  /** API origin the bundle endpoint + SDK calls resolve against. */\n  apiBaseUrl: string\n  /** Resolved props for the component (Liquid templating happens host-side). */\n  props: Record<string, unknown>\n  pageCtx: PageContext\n  /** PUBLIC mode: the component renders on an unauthenticated public page.\n   *  The shell fetches the bundle from the public endpoint (no bearer) and\n   *  injects a restricted sdk — only `functions.actions.invokePublic` reaches\n   *  the platform. Requires `orgId`. */\n  isPublic?: boolean\n  /** Org id for public mode — public endpoints carry the org in the path\n   *  because there is no token to scope from. */\n  orgId?: string\n  /** Set when this frame is the CONTENT of a host component modal (opened by\n   *  another component via OPEN_MODAL). The component reads it through\n   *  `useModalHost()` and closes with a result by posting MODAL_RESULT with\n   *  this id. Absent on ordinary page-hosted frames. */\n  modalRequestId?: string\n}\n\nexport interface AuthRefreshMessage {\n  type: 'AUTH_REFRESH'\n  token: string\n}\n\nexport interface DataInvalidateMessage {\n  type: 'DATA_INVALIDATE'\n  queryKey?: unknown[]\n}\n\n/** Where the iframe's in-flow box sits in the host viewport. Sent while the\n *  frame is promoted (OVERLAY_STATE open) so the runtime can keep its content\n *  parked at the original rect while the iframe itself covers the viewport —\n *  and re-sent when the host window resizes under an open overlay. */\nexport interface OverlayRectMessage {\n  type: 'OVERLAY_RECT'\n  rect: OverlayRect\n}\n\n/** Resolution of an OPEN_MODAL request: the host modal closed. `result` is the\n *  value the modal's component passed to MODAL_RESULT, and is absent when the\n *  modal was dismissed (backdrop / Esc / ×). */\nexport interface ModalClosedMessage {\n  type: 'MODAL_CLOSED'\n  requestId: string\n  result?: unknown\n}\n\nexport type HostMessage =\n  | InitMessage\n  | AuthRefreshMessage\n  | DataInvalidateMessage\n  | OverlayRectMessage\n  | ModalClosedMessage\n\n// ── Runtime → host ──────────────────────────────────────────────────────────\n\nexport interface ReadyMessage {\n  type: 'READY'\n}\n\nexport interface ResizeMessage {\n  type: 'RESIZE'\n  height: number\n}\n\nexport interface NavigateMessage {\n  type: 'NAVIGATE'\n  to: string\n}\n\n/** Open an in-app path in a peek (slide-over) panel instead of full-page\n *  navigation. Same `/…` in-app path grammar as NAVIGATE; the host decides\n *  what can peek (today: platform pages) and falls back to NAVIGATE otherwise. */\nexport interface OpenPeekMessage {\n  type: 'OPEN_PEEK'\n  to: string\n}\n\n/** Ask the host to open a prepared call: the host shows the conversation brief's\n *  preview (its softphone owns the dial) and lets the user place the call.\n *  Ignored on public pages and on hosts without a softphone. */\nexport interface OpenCallMessage {\n  type: 'OPEN_CALL'\n  /** The conversation brief to preview and dial from. */\n  conversationBriefId: string\n}\n\n/** The runtime has (or no longer has) an overlay open and needs the host to\n *  promote (or restore) the iframe. See {@link COMPONENT_OVERLAY_Z_INDEX}.\n *\n *  Same-origin today, so the runtime applies the promotion styles to its own\n *  `window.frameElement` synchronously (pre-paint, no flicker) and this message\n *  is the host's cue to MIRROR that state into React — gate RESIZE, hold the\n *  placeholder height, start posting OVERLAY_RECT. When components move to a\n *  dedicated origin the runtime can no longer touch the frame and this message\n *  becomes the actuation instead; the runtime hides its overlay until the\n *  answering OVERLAY_RECT arrives. */\nexport interface OverlayStateMessage {\n  type: 'OVERLAY_STATE'\n  open: boolean\n}\n\n/** Width of a host component modal's panel: `sm` 384px, `md` 512px, `lg` 672px,\n *  `xl` 896px. Below 640px the modal is a full-screen sheet whatever the\n *  width. */\nexport type ModalWidth = 'sm' | 'md' | 'lg' | 'xl'\n\n/** Ask the host to open ANOTHER component in a central modal, above everything\n *  this frame could reach on its own. The host answers with MODAL_CLOSED\n *  carrying the same `requestId`.\n *\n *  One modal per opener at a time: while a request from this frame is still\n *  open, the host answers any further OPEN_MODAL from it as dismissed (a\n *  double click must not stack two dialogs). The modal's own component may\n *  open another — that request comes from a different frame. */\nexport interface OpenModalMessage {\n  type: 'OPEN_MODAL'\n  /** Correlates the eventual MODAL_CLOSED. Generated by the opener. */\n  requestId: string\n  /** Slug of the component to mount inside the modal. */\n  componentSlug: string\n  /** Props for that component. The host renders Liquid in every string value\n   *  against the OPENER's page scope (`record`, `entity`, `params`,\n   *  `current_user`) before handing them over — exactly as it does for a\n   *  page-placed component. So `{{ … }}` / `{% … %}` in a value is evaluated,\n   *  not passed through. */\n  props?: Record<string, unknown>\n  /** Optional modal heading. */\n  title?: string\n  /** Panel width. Defaults to `lg`. */\n  width?: ModalWidth\n  /** Height of the component's frame, in px. Set: the frame is that tall from\n   *  the first paint (capped at the viewport), scrolls its own content, and\n   *  sits edge to edge in the panel — the component owns its padding. Unset:\n   *  the frame grows with its content inside the host's padded body. */\n  height?: number\n}\n\n/** Escape was pressed with focus inside the iframe, and nothing in the runtime\n *  consumed it.\n *\n *  Keyboard events don't cross the iframe boundary, and react-aria binds its\n *  Escape handling to the overlay element in its own React tree — so a\n *  host-rendered dialog CANNOT see Escape once the user has clicked into a\n *  component. The runtime forwards it so the host can dismiss on the user's\n *  behalf. Not sent while the runtime has its own overlay open: that overlay\n *  owns Escape. */\nexport interface EscapePressedMessage {\n  type: 'ESCAPE_PRESSED'\n}\n\n/** Posted by the component INSIDE a host modal to close it with a value. The\n *  `requestId` is the one INIT carried as `modalRequestId`. */\nexport interface ModalResultMessage {\n  type: 'MODAL_RESULT'\n  requestId: string\n  result?: unknown\n}\n\nexport interface ErrorMessage {\n  type: 'ERROR'\n  message: string\n  stack?: string\n}\n\nexport type RuntimeMessage =\n  | ReadyMessage\n  | ResizeMessage\n  | NavigateMessage\n  | OpenPeekMessage\n  | OpenCallMessage\n  | OverlayStateMessage\n  | OpenModalMessage\n  | ModalResultMessage\n  | EscapePressedMessage\n  | ErrorMessage\n\n// Wire envelope: the message plus the source discriminator.\nexport type Envelope<T> = T & { source: typeof MESSAGE_SOURCE }\n\nexport function isHostMessage(data: unknown): data is Envelope<HostMessage> {\n  return (\n    typeof data === 'object' &&\n    data !== null &&\n    (data as { source?: unknown }).source === MESSAGE_SOURCE &&\n    typeof (data as { type?: unknown }).type === 'string'\n  )\n}\n\nexport function isRuntimeMessage(data: unknown): data is Envelope<RuntimeMessage> {\n  return (\n    typeof data === 'object' &&\n    data !== null &&\n    (data as { source?: unknown }).source === MESSAGE_SOURCE &&\n    typeof (data as { type?: unknown }).type === 'string'\n  )\n}\n"]}
+{"version":3,"sources":["../src/protocol.ts"],"names":[],"mappings":";AAUO,IAAM,cAAA,GAAiB;AAuBvB,IAAM,yBAAA,GAA4B;AA2OlC,SAAS,cAAc,IAAA,EAA8C;AAC1E,EAAA,OACE,OAAO,IAAA,KAAS,QAAA,IAChB,IAAA,KAAS,IAAA,IACR,KAA8B,MAAA,KAAW,cAAA,IAC1C,OAAQ,IAAA,CAA4B,IAAA,KAAS,QAAA;AAEjD;AAEO,SAAS,iBAAiB,IAAA,EAAiD;AAChF,EAAA,OACE,OAAO,IAAA,KAAS,QAAA,IAChB,IAAA,KAAS,IAAA,IACR,KAA8B,MAAA,KAAW,cAAA,IAC1C,OAAQ,IAAA,CAA4B,IAAA,KAAS,QAAA;AAEjD","file":"chunk-NOCSMXCW.js","sourcesContent":["// postMessage protocol between the host page and the component-runtime iframe.\n// This is the single source of truth for the wire contract: the host renderer\n// (clients/web .../component-frame.tsx), the runtime shell\n// (clients/web/component-runtime/shell.tsx), and the author-facing hooks\n// (this package's RuntimeProvider / useNavigate) all import these same types so\n// every end stays in lockstep.\n//\n// Every message carries `source: MESSAGE_SOURCE` so we can ignore the unrelated\n// postMessage traffic that shares the window (OIDC silent-renew, Vite HMR, …).\n\nexport const MESSAGE_SOURCE = 'proteos-component-runtime' as const\n\n/**\n * z-index the component iframe is promoted to while one of its own overlays\n * (modal, popover, menu, select, tooltip) is open. The iframe goes\n * `position: fixed; inset: 0` at this z so the overlay — which portals to the\n * IFRAME's body and would otherwise clip at the frame's box — can paint over\n * the rest of the page.\n *\n * Host z ladder this slots into:\n *   50    @proteos/ui Modal / Tooltip / ImageLightbox (default tier)\n *   1000+ full-page panel stack (scrim 1000, panels 1001+n)\n *   1090  peek scrim   1100  peek panel, ask-proteos window\n *   1150  ← THIS\n *   1200  menu popover, command palette, action dialog, component modal\n *   1300  select popover\n *\n * Above the peek/full-page surfaces a component can live on, below the global\n * host chrome. Note the cap: inside a peek (a `fixed` + z-index ancestor) the\n * promoted iframe paints within that 1100 stacking context — it covers the\n * peek's own content and everything under it, but host chrome at 1200+ still\n * wins. That is the intended layering, not a bug.\n */\nexport const COMPONENT_OVERLAY_Z_INDEX = 1150\n\n/** Viewport-relative box of the iframe's in-flow placeholder, in CSS px. */\nexport interface OverlayRect {\n  top: number\n  left: number\n  width: number\n  height: number\n}\n\nexport interface PageContext {\n  record?: Record<string, unknown>\n  entity?: { slug: string; [key: string]: unknown }\n  params?: Record<string, unknown>\n  /** The signed-in viewer (absent on public pages and offline previews). The\n   *  host resolves `{{ current_user.* }}` and the bare `current_user` prop\n   *  sentinel against it before posting props. */\n  current_user?: { id: string; email: string; given_name: string; family_name: string }\n  [key: string]: unknown\n}\n\n// ── Host → runtime ──────────────────────────────────────────────────────────\n\nexport interface InitMessage {\n  type: 'INIT'\n  /** Raw bearer token (the OIDC `id_token`). The runtime's ProteosClient\n   *  prepends `Bearer ` when building the Authorization header, so the host\n   *  sends the token verbatim — NOT a full `Bearer …` header value.\n   *  Empty string in public mode (`isPublic: true`). */\n  authToken: string\n  /** API origin the bundle endpoint + SDK calls resolve against. */\n  apiBaseUrl: string\n  /** Resolved props for the component (Liquid templating happens host-side). */\n  props: Record<string, unknown>\n  pageCtx: PageContext\n  /** PUBLIC mode: the component renders on an unauthenticated public page.\n   *  The shell fetches the bundle from the public endpoint (no bearer) and\n   *  injects a restricted sdk — only `functions.actions.invokePublic` reaches\n   *  the platform. Requires `orgId`. */\n  isPublic?: boolean\n  /** Org id for public mode — public endpoints carry the org in the path\n   *  because there is no token to scope from. */\n  orgId?: string\n  /** Set when this frame is the CONTENT of a host component modal (opened by\n   *  another component via OPEN_MODAL). The component reads it through\n   *  `useModalHost()` and closes with a result by posting MODAL_RESULT with\n   *  this id. Absent on ordinary page-hosted frames. */\n  modalRequestId?: string\n}\n\nexport interface AuthRefreshMessage {\n  type: 'AUTH_REFRESH'\n  token: string\n}\n\nexport interface DataInvalidateMessage {\n  type: 'DATA_INVALIDATE'\n  queryKey?: unknown[]\n}\n\n/** Where the iframe's in-flow box sits in the host viewport. Sent while the\n *  frame is promoted (OVERLAY_STATE open) so the runtime can keep its content\n *  parked at the original rect while the iframe itself covers the viewport —\n *  and re-sent when the host window resizes under an open overlay. */\nexport interface OverlayRectMessage {\n  type: 'OVERLAY_RECT'\n  rect: OverlayRect\n}\n\n/** Resolution of an OPEN_MODAL request: the host modal closed. `result` is the\n *  value the modal's component passed to MODAL_RESULT, and is absent when the\n *  modal was dismissed (backdrop / Esc / ×). */\nexport interface ModalClosedMessage {\n  type: 'MODAL_CLOSED'\n  requestId: string\n  result?: unknown\n}\n\nexport type HostMessage =\n  | InitMessage\n  | AuthRefreshMessage\n  | DataInvalidateMessage\n  | OverlayRectMessage\n  | ModalClosedMessage\n\n// ── Runtime → host ──────────────────────────────────────────────────────────\n\nexport interface ReadyMessage {\n  type: 'READY'\n}\n\nexport interface ResizeMessage {\n  type: 'RESIZE'\n  height: number\n}\n\nexport interface NavigateMessage {\n  type: 'NAVIGATE'\n  to: string\n}\n\n/** Open an in-app path in a peek (slide-over) panel instead of full-page\n *  navigation. Same `/…` in-app path grammar as NAVIGATE; the host decides\n *  what can peek (today: platform pages) and falls back to NAVIGATE otherwise. */\nexport interface OpenPeekMessage {\n  type: 'OPEN_PEEK'\n  to: string\n}\n\n/** Ask the host to open a prepared call: the host shows the conversation brief's\n *  preview (its softphone owns the dial) and lets the user place the call.\n *  Ignored on public pages and on hosts without a softphone. */\nexport interface OpenCallMessage {\n  type: 'OPEN_CALL'\n  /** The conversation brief to preview and dial from. */\n  conversationBriefId: string\n}\n\n/** The runtime has (or no longer has) an overlay open and needs the host to\n *  promote (or restore) the iframe. See {@link COMPONENT_OVERLAY_Z_INDEX}.\n *\n *  Same-origin today, so the runtime applies the promotion styles to its own\n *  `window.frameElement` synchronously (pre-paint, no flicker) and this message\n *  is the host's cue to MIRROR that state into React — gate RESIZE, hold the\n *  placeholder height, start posting OVERLAY_RECT. When components move to a\n *  dedicated origin the runtime can no longer touch the frame and this message\n *  becomes the actuation instead; the runtime hides its overlay until the\n *  answering OVERLAY_RECT arrives. */\nexport interface OverlayStateMessage {\n  type: 'OVERLAY_STATE'\n  open: boolean\n}\n\n/** Width of a host component modal's panel: `sm` 384px, `md` 512px, `lg` 672px,\n *  `xl` 896px. Below 640px the modal is a full-screen sheet whatever the\n *  width. */\nexport type ModalWidth = 'sm' | 'md' | 'lg' | 'xl'\n\n/** Ask the host to open ANOTHER component in a central modal, above everything\n *  this frame could reach on its own. The host answers with MODAL_CLOSED\n *  carrying the same `requestId`.\n *\n *  One modal per opener at a time: while a request from this frame is still\n *  open, the host answers any further OPEN_MODAL from it as dismissed (a\n *  double click must not stack two dialogs). The modal's own component may\n *  open another — that request comes from a different frame. */\nexport interface OpenModalMessage {\n  type: 'OPEN_MODAL'\n  /** Correlates the eventual MODAL_CLOSED. Generated by the opener. */\n  requestId: string\n  /** Slug of the component to mount inside the modal. */\n  componentSlug: string\n  /** Props for that component. The host renders Liquid in every string value\n   *  against the OPENER's page scope (`record`, `entity`, `params`,\n   *  `current_user`) before handing them over — exactly as it does for a\n   *  page-placed component. So `{{ … }}` / `{% … %}` in a value is evaluated,\n   *  not passed through. */\n  props?: Record<string, unknown>\n  /** Optional modal heading. */\n  title?: string\n  /** Panel width. Defaults to `lg`. */\n  width?: ModalWidth\n  /** Height of the component's frame, in px. Set: the frame is that tall from\n   *  the first paint (capped at the viewport), scrolls its own content, and\n   *  sits edge to edge in the panel — the component owns its padding. Unset:\n   *  the frame grows with its content inside the host's padded body. */\n  height?: number\n}\n\n/** Escape was pressed with focus inside the iframe, and nothing in the runtime\n *  consumed it.\n *\n *  Keyboard events don't cross the iframe boundary, and react-aria binds its\n *  Escape handling to the overlay element in its own React tree — so a\n *  host-rendered dialog CANNOT see Escape once the user has clicked into a\n *  component. The runtime forwards it so the host can dismiss on the user's\n *  behalf. Not sent while the runtime has its own overlay open: that overlay\n *  owns Escape. */\nexport interface EscapePressedMessage {\n  type: 'ESCAPE_PRESSED'\n}\n\n/** Posted by the component INSIDE a host modal to close it with a value. The\n *  `requestId` is the one INIT carried as `modalRequestId`. */\nexport interface ModalResultMessage {\n  type: 'MODAL_RESULT'\n  requestId: string\n  result?: unknown\n}\n\n/** Ask the host to open its agent session window (the floating assistant).\n *\n *  - `sessionId` set: the window resumes THAT session (its agent is read from\n *    the session). A `prompt` is sent into it.\n *  - no `sessionId`: a fresh session with `agentKey` (or the agent currently\n *    selected in the window); a `prompt` is sent as its first message. With\n *    neither field the window just opens as it is.\n *\n *  Ignored on public pages (there is no signed-in user to run an agent as). */\nexport interface OpenAgentWindowMessage {\n  type: 'OPEN_AGENT_WINDOW'\n  sessionId?: string\n  agentKey?: string\n  prompt?: string\n}\n\n/** Ask the host to minimize its agent session window. The active session and\n *  its stream stay alive — reopening resumes it. */\nexport interface CloseAgentWindowMessage {\n  type: 'CLOSE_AGENT_WINDOW'\n}\n\nexport interface ErrorMessage {\n  type: 'ERROR'\n  message: string\n  stack?: string\n}\n\nexport type RuntimeMessage =\n  | ReadyMessage\n  | ResizeMessage\n  | NavigateMessage\n  | OpenPeekMessage\n  | OpenCallMessage\n  | OverlayStateMessage\n  | OpenModalMessage\n  | ModalResultMessage\n  | EscapePressedMessage\n  | OpenAgentWindowMessage\n  | CloseAgentWindowMessage\n  | ErrorMessage\n\n// Wire envelope: the message plus the source discriminator.\nexport type Envelope<T> = T & { source: typeof MESSAGE_SOURCE }\n\nexport function isHostMessage(data: unknown): data is Envelope<HostMessage> {\n  return (\n    typeof data === 'object' &&\n    data !== null &&\n    (data as { source?: unknown }).source === MESSAGE_SOURCE &&\n    typeof (data as { type?: unknown }).type === 'string'\n  )\n}\n\nexport function isRuntimeMessage(data: unknown): data is Envelope<RuntimeMessage> {\n  return (\n    typeof data === 'object' &&\n    data !== null &&\n    (data as { source?: unknown }).source === MESSAGE_SOURCE &&\n    typeof (data as { type?: unknown }).type === 'string'\n  )\n}\n"]}

package/dist/index.cjs

@@ -1,26 +1,44 @@
 'use strict';
 
-var chunk3VUWWDED_cjs = require('./chunk-3VUWWDED.cjs');
+var chunkHD5ADY7F_cjs = require('./chunk-HD5ADY7F.cjs');
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 
 var RuntimeContext = react.createContext(null);
 function postNavigate(to) {
-  const envelope = { source: chunk3VUWWDED_cjs.MESSAGE_SOURCE, type: "NAVIGATE", to };
+  const envelope = { source: chunkHD5ADY7F_cjs.MESSAGE_SOURCE, type: "NAVIGATE", to };
   window.parent?.postMessage(envelope, "*");
 }
 function postOpenPeek(to) {
-  const envelope = { source: chunk3VUWWDED_cjs.MESSAGE_SOURCE, type: "OPEN_PEEK", to };
+  const envelope = { source: chunkHD5ADY7F_cjs.MESSAGE_SOURCE, type: "OPEN_PEEK", to };
   window.parent?.postMessage(envelope, "*");
 }
 function openCall(conversationBriefId) {
   const envelope = {
-    source: chunk3VUWWDED_cjs.MESSAGE_SOURCE,
+    source: chunkHD5ADY7F_cjs.MESSAGE_SOURCE,
     type: "OPEN_CALL",
     conversationBriefId
   };
   window.parent?.postMessage(envelope, "*");
 }
+function openAgentWindow(options) {
+  const envelope = {
+    source: chunkHD5ADY7F_cjs.MESSAGE_SOURCE,
+    type: "OPEN_AGENT_WINDOW",
+    ...options?.sessionId !== void 0 ? { sessionId: options.sessionId } : {},
+    ...options?.agentKey !== void 0 ? { agentKey: options.agentKey } : {},
+    ...options?.prompt !== void 0 ? { prompt: options.prompt } : {}
+  };
+  window.parent?.postMessage(envelope, "*");
+}
+function closeAgentWindow() {
+  const envelope = {
+    source: chunkHD5ADY7F_cjs.MESSAGE_SOURCE,
+    type: "CLOSE_AGENT_WINDOW"
+  };
+  window.parent?.postMessage(envelope, "*");
+}
+var agentWindow = { open: openAgentWindow, close: closeAgentWindow };
 function navigate(to, options) {
   if (options?.peek) postOpenPeek(to);
   else postNavigate(to);
@@ -32,7 +50,7 @@ function ensureModalListener() {
   modalListenerAttached = true;
   window.addEventListener("message", (event) => {
     const data = event.data;
-    if (!chunk3VUWWDED_cjs.isHostMessage(data) || data.type !== "MODAL_CLOSED") return;
+    if (!chunkHD5ADY7F_cjs.isHostMessage(data) || data.type !== "MODAL_CLOSED") return;
     const resolve = pendingModals.get(data.requestId);
     if (!resolve) return;
     pendingModals.delete(data.requestId);
@@ -68,7 +86,7 @@ function openModal(componentSlug, props, options) {
   ensureModalListener();
   const requestId = newRequestId();
   const envelope = {
-    source: chunk3VUWWDED_cjs.MESSAGE_SOURCE,
+    source: chunkHD5ADY7F_cjs.MESSAGE_SOURCE,
     type: "OPEN_MODAL",
     requestId,
     componentSlug,
@@ -88,7 +106,7 @@ function openModal(componentSlug, props, options) {
 }
 function postModalResult(requestId, result) {
   const envelope = {
-    source: chunk3VUWWDED_cjs.MESSAGE_SOURCE,
+    source: chunkHD5ADY7F_cjs.MESSAGE_SOURCE,
     type: "MODAL_RESULT",
     requestId,
     ...result !== void 0 ? { result } : {}
@@ -97,7 +115,7 @@ function postModalResult(requestId, result) {
 }
 function RuntimeProvider({ value, children }) {
   const ctx = react.useMemo(
-    () => ({ ...value, navigate, openCall, openModal }),
+    () => ({ ...value, navigate, openCall, openModal, agentWindow }),
     [value]
   );
   return /* @__PURE__ */ jsxRuntime.jsx(RuntimeContext.Provider, { value: ctx, children });
@@ -126,6 +144,9 @@ function useNavigate() {
 function useOpenCall() {
   return useRuntime().openCall;
 }
+function useAgentWindow() {
+  return useRuntime().agentWindow;
+}
 function useApiBaseUrl() {
   return useRuntime().apiBaseUrl;
 }
@@ -208,21 +229,22 @@ function useFillViewportHeight(options = {}) {
 
 Object.defineProperty(exports, "COMPONENT_OVERLAY_Z_INDEX", {
   enumerable: true,
-  get: function () { return chunk3VUWWDED_cjs.COMPONENT_OVERLAY_Z_INDEX; }
+  get: function () { return chunkHD5ADY7F_cjs.COMPONENT_OVERLAY_Z_INDEX; }
 });
 Object.defineProperty(exports, "MESSAGE_SOURCE", {
   enumerable: true,
-  get: function () { return chunk3VUWWDED_cjs.MESSAGE_SOURCE; }
+  get: function () { return chunkHD5ADY7F_cjs.MESSAGE_SOURCE; }
 });
 Object.defineProperty(exports, "isHostMessage", {
   enumerable: true,
-  get: function () { return chunk3VUWWDED_cjs.isHostMessage; }
+  get: function () { return chunkHD5ADY7F_cjs.isHostMessage; }
 });
 Object.defineProperty(exports, "isRuntimeMessage", {
   enumerable: true,
-  get: function () { return chunk3VUWWDED_cjs.isRuntimeMessage; }
+  get: function () { return chunkHD5ADY7F_cjs.isRuntimeMessage; }
 });
 exports.RuntimeProvider = RuntimeProvider;
+exports.useAgentWindow = useAgentWindow;
 exports.useApiBaseUrl = useApiBaseUrl;
 exports.useAuthToken = useAuthToken;
 exports.useComponentModal = useComponentModal;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/context.tsx","../src/hooks.ts"],"names":["createContext","MESSAGE_SOURCE","isHostMessage","useMemo","useContext","useCallback","useState","useEffect"],"mappings":"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","file":"index.cjs","sourcesContent":["import type {\n  AccountClient,\n  AgentClient,\n  ConversationClient,\n  DataClient,\n  FunctionsClient,\n  KnowledgeClient,\n  MetaClient,\n  StorageClient,\n} from '@proteos/sdk'\nimport { createContext, type ReactNode, useMemo } from 'react'\n\nimport {\n  type Envelope,\n  isHostMessage,\n  MESSAGE_SOURCE,\n  type ModalResultMessage,\n  type ModalWidth,\n  type NavigateMessage,\n  type OpenCallMessage,\n  type OpenModalMessage,\n  type OpenPeekMessage,\n  type PageContext,\n} from './protocol'\n\n/** Options for {@link RuntimeContextValue.navigate}. */\nexport interface NavigateOptions {\n  /** Open the target in a peek (slide-over) panel instead of full-page. */\n  peek?: boolean\n}\n\n/** Options for {@link RuntimeContextValue.openModal}. */\nexport interface OpenModalOptions {\n  /** Heading rendered in the modal chrome. */\n  title?: string\n  /** Panel width: `sm` 384px, `md` 512px, `lg` 672px (default), `xl` 896px. */\n  width?: ModalWidth\n  /** Height of the component's frame, in px. Pass it whenever you know it: the\n   *  modal then opens at its final size instead of growing once the component\n   *  has loaded. The frame is capped at the viewport, scrolls its own content,\n   *  and sits edge to edge in the panel — so the component owns its padding\n   *  (`ModalBody` / `ModalFooter` from `@proteos/ui` carry the standard one).\n   *  Leave it out and the frame grows with its content inside the host's\n   *  padded body. */\n  height?: number\n}\n\n/**\n * Manual control over iframe overlay promotion. The runtime already detects\n * overlays automatically (anything portaled to the iframe's `document.body` —\n * every `@proteos/ui` overlay qualifies), so components need this only for\n * custom portal targets, or to promote a frame *before* opening an overlay.\n * Calls are reference-counted: every `expand()` needs its `collapse()`.\n */\nexport interface OverlayController {\n  expand: () => void\n  collapse: () => void\n  isExpanded: () => boolean\n}\n\n/**\n * The authenticated `@proteos/sdk` clients the runtime injects. Same instances\n * the host app uses — pre-wired with a refreshing bearer token, so a component\n * never touches auth headers.\n */\nexport interface ComponentSdk {\n  account: AccountClient\n  agents: AgentClient\n  /**\n   * Conversations, messages, contacts, connections (conversation-service) —\n   * e.g. the DraftMessageComposer review surface. Plural per the platform's\n   * resource-naming rule; the web app's own `useSdk().conversation` predates\n   * it (documented asymmetry).\n   */\n  conversations: ConversationClient\n  data: DataClient\n  functions: FunctionsClient\n  knowledge: KnowledgeClient\n  meta: MetaClient\n  storage: StorageClient\n}\n\n/**\n * The raw runtime payload the shell hands a component at INIT. The shell builds\n * this; component authors read it through the hooks.\n */\nexport interface RuntimeValue {\n  /**\n   * The injected sdk clients. On an authenticated page these are the full,\n   * bearer-wired clients. On a PUBLIC page (`isPublic: true`) only\n   * `functions.actions.invokePublic` reaches the platform — every other\n   * client throws on use (there is no token, and the server rejects\n   * unauthenticated calls anyway).\n   */\n  sdk: ComponentSdk\n  /** Liquid-resolved props (a snapshot — not a live binding). */\n  props: Record<string, unknown>\n  /** Page context snapshot: the host record, entity, and URL params. */\n  pageCtx: PageContext\n  /** API origin SDK calls + asset URLs resolve against. */\n  apiBaseUrl: string\n  /** Current bearer token getter (escape hatch for raw fetches). Returns ''\n   *  on public pages. */\n  getToken: () => string\n  /** True when rendering on an unauthenticated public page. */\n  isPublic?: boolean\n  /** Org id, set in public mode (public API routes carry it in the path). */\n  orgId?: string\n  /** Set when this component is the content of a host component modal — the\n   *  correlation id it closes with. See `useModalHost()`. */\n  modalRequestId?: string\n  /** Overlay promotion controller, provided by the shell. Absent on older\n   *  shells / non-promoting hosts, in which case `useOverlayExpansion()`\n   *  no-ops. */\n  overlay?: OverlayController\n}\n\n/** Runtime value plus the derived helpers the hooks expose. */\nexport interface RuntimeContextValue extends RuntimeValue {\n  /** Navigate the host SPA to an in-app path (posts a NAVIGATE message), or\n   *  open it in a peek panel with `{ peek: true }` (posts OPEN_PEEK). */\n  navigate: (to: string, options?: NavigateOptions) => void\n  /** Ask the host to open a prepared call from a conversation brief (posts\n   *  OPEN_CALL): the host previews the brief and dials through its softphone. */\n  openCall: (conversationBriefId: string) => void\n  /** Open another component in a host-rendered modal; resolves with the value\n   *  that component closed with (`undefined` if dismissed). */\n  openModal: (\n    componentSlug: string,\n    props?: Record<string, unknown>,\n    options?: OpenModalOptions,\n  ) => Promise<unknown>\n}\n\nexport const RuntimeContext = createContext<RuntimeContextValue | null>(null)\n\n/** Post a NAVIGATE envelope to the host. The host only honours relative,\n *  in-app targets (it ignores absolute/external URLs). */\nfunction postNavigate(to: string): void {\n  const envelope: Envelope<NavigateMessage> = { source: MESSAGE_SOURCE, type: 'NAVIGATE', to }\n  window.parent?.postMessage(envelope, '*')\n}\n\n/** Post an OPEN_PEEK envelope to the host — open the in-app path in a peek\n *  panel. Same relative-path contract as {@link postNavigate}. */\nfunction postOpenPeek(to: string): void {\n  const envelope: Envelope<OpenPeekMessage> = { source: MESSAGE_SOURCE, type: 'OPEN_PEEK', to }\n  window.parent?.postMessage(envelope, '*')\n}\n\n/** Post OPEN_CALL — the host previews the conversation brief and owns the dial. */\nfunction openCall(conversationBriefId: string): void {\n  const envelope: Envelope<OpenCallMessage> = {\n    source: MESSAGE_SOURCE,\n    type: 'OPEN_CALL',\n    conversationBriefId,\n  }\n  window.parent?.postMessage(envelope, '*')\n}\n\n/** Navigate full-page (default) or into a peek panel (`{ peek: true }`). */\nfunction navigate(to: string, options?: NavigateOptions): void {\n  if (options?.peek) postOpenPeek(to)\n  else postNavigate(to)\n}\n\n// ── Component modals ────────────────────────────────────────────────────────\n// One module-level listener + a pending map, rather than a listener per call:\n// the SDK is an import-mapped singleton, so this is per-iframe state.\n\nconst pendingModals = new Map<string, (result: unknown) => void>()\nlet modalListenerAttached = false\n\nfunction ensureModalListener(): void {\n  if (modalListenerAttached) return\n  modalListenerAttached = true\n  window.addEventListener('message', (event: MessageEvent) => {\n    const data: unknown = event.data\n    if (!isHostMessage(data) || data.type !== 'MODAL_CLOSED') return\n    const resolve = pendingModals.get(data.requestId)\n    // An unknown requestId is someone else's modal (or a stale reply) — drop it.\n    if (!resolve) return\n    pendingModals.delete(data.requestId)\n    resolve(data.result)\n  })\n}\n\n// How long after a modal closed the opener still claims the focus the host\n// hands back. Past that, focus arriving on the frame is something else.\nconst FOCUS_RESTORE_WINDOW_MS = 1000\n\n/** Puts focus back on the control that opened a modal.\n *\n *  The host returns focus to this FRAME when its dialog closes, but not to the\n *  control inside it: the frame is inert while the dialog is up, which drops\n *  the focus it held, so it comes back on `<body>`. Only this side knows which\n *  control it was.\n *\n *  The reply (MODAL_CLOSED) arrives before the dialog has finished closing —\n *  the frame may still be inert then and refuse focus — so this waits for the\n *  frame to actually receive it. */\nfunction restoreFocus(opener: HTMLElement | null): void {\n  if (!opener?.isConnected) return\n  const isUnplaced = () =>\n    document.activeElement === null || document.activeElement === document.body\n  if (document.hasFocus() && isUnplaced()) {\n    opener.focus({ preventScroll: true })\n    return\n  }\n  const onFocus = () => {\n    stop()\n    // Something in here took focus in the meantime — leave it be.\n    if (opener.isConnected && isUnplaced()) opener.focus({ preventScroll: true })\n  }\n  const timer = window.setTimeout(stop, FOCUS_RESTORE_WINDOW_MS)\n  function stop(): void {\n    window.clearTimeout(timer)\n    window.removeEventListener('focus', onFocus)\n  }\n  window.addEventListener('focus', onFocus)\n}\n\nfunction newRequestId(): string {\n  if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {\n    return crypto.randomUUID()\n  }\n  return `modal_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`\n}\n\n/** Post OPEN_MODAL and resolve when the host answers MODAL_CLOSED. */\nfunction openModal(\n  componentSlug: string,\n  props?: Record<string, unknown>,\n  options?: OpenModalOptions,\n): Promise<unknown> {\n  ensureModalListener()\n  const requestId = newRequestId()\n  const envelope: Envelope<OpenModalMessage> = {\n    source: MESSAGE_SOURCE,\n    type: 'OPEN_MODAL',\n    requestId,\n    componentSlug,\n    ...(props !== undefined ? { props } : {}),\n    ...(options?.title !== undefined ? { title: options.title } : {}),\n    ...(options?.width !== undefined ? { width: options.width } : {}),\n    ...(options?.height !== undefined ? { height: options.height } : {}),\n  }\n  const opener = document.activeElement instanceof HTMLElement ? document.activeElement : null\n  return new Promise<unknown>((resolve) => {\n    pendingModals.set(requestId, (result) => {\n      restoreFocus(opener)\n      resolve(result)\n    })\n    window.parent?.postMessage(envelope, '*')\n  })\n}\n\n/** Post MODAL_RESULT — the component inside a host modal closing with a value. */\nexport function postModalResult(requestId: string, result?: unknown): void {\n  const envelope: Envelope<ModalResultMessage> = {\n    source: MESSAGE_SOURCE,\n    type: 'MODAL_RESULT',\n    requestId,\n    ...(result !== undefined ? { result } : {}),\n  }\n  window.parent?.postMessage(envelope, '*')\n}\n\n/**\n * Provides the runtime value + derived helpers to a component subtree. Mounted\n * by the component-runtime shell around the loaded component — authors never\n * render this themselves. Lives in `@proteos/component-sdk` (a shared,\n * import-mapped singleton) so the context the shell provides is the very same\n * context the component's hooks read, across the bundle boundary.\n */\nexport function RuntimeProvider({ value, children }: { value: RuntimeValue; children: ReactNode }) {\n  // The shell builds `value` once at INIT (a stable state object — clients,\n  // props and pageCtx are all set once), so memoizing on its identity recreates\n  // the context only when the runtime genuinely re-inits.\n  const ctx = useMemo<RuntimeContextValue>(\n    () => ({ ...value, navigate, openCall, openModal }),\n    [value],\n  )\n  return <RuntimeContext.Provider value={ctx}>{children}</RuntimeContext.Provider>\n}\n","import { useCallback, useContext, useEffect, useMemo, useState } from 'react'\n\nimport {\n  type ComponentSdk,\n  type NavigateOptions,\n  type OpenModalOptions,\n  type OverlayController,\n  postModalResult,\n  RuntimeContext,\n  type RuntimeContextValue,\n} from './context'\nimport type { PageContext } from './protocol'\n\n/**\n * Low-level escape hatch: the whole runtime context (sdk, props, pageCtx,\n * apiBaseUrl, getToken, navigate). Prefer the focused hooks below. Throws a\n * clear error if used outside the component runtime.\n */\nexport function useRuntime(): RuntimeContextValue {\n  const ctx = useContext(RuntimeContext)\n  if (!ctx) {\n    throw new Error(\n      '@proteos/component-sdk: hooks must run inside the Proteos component runtime. ' +\n        'This usually means the component is rendered outside its iframe, or a ' +\n        'second copy of @proteos/component-sdk was bundled instead of using the ' +\n        'runtime-provided one (keep it external).',\n    )\n  }\n  return ctx\n}\n\n/** The authenticated SDK clients (account / agents / conversations / data / functions / knowledge / meta / storage). */\nexport function useSdk(): ComponentSdk {\n  return useRuntime().sdk\n}\n\n/** The component's Liquid-resolved props (a snapshot, not a live binding). */\nexport function useProps<T extends Record<string, unknown> = Record<string, unknown>>(): T {\n  return useRuntime().props as T\n}\n\n/**\n * The full page context: host `record`, `entity`, and URL `params`. The\n * `record` is a snapshot taken at mount (`undefined` on record-less platform\n * pages) — fetch via `useSdk().data` for anything that must stay fresh.\n */\nexport function usePageContext(): PageContext {\n  return useRuntime().pageCtx\n}\n\n/**\n * Navigate the host SPA to an in-app path, e.g.\n * `navigate('/org/acme/record/task/123')`. The host ignores absolute/external\n * URLs. Build org/app-prefixed paths with `useHostLocation().appBasePath`.\n *\n * Pass `{ peek: true }` to open the path in a peek (slide-over) panel instead\n * of full-page navigation — e.g. `navigate(path, { peek: true })`. The host\n * peeks what it can (today: platform pages) and falls back to full navigation.\n */\nexport function useNavigate(): (to: string, options?: NavigateOptions) => void {\n  return useRuntime().navigate\n}\n\n/**\n * Open a prepared call from a conversation brief id: the HOST previews the brief and\n * places the call through its softphone (an iframe cannot dial). Pair it with\n * `ConversationBriefReview`'s `onOpenCall` from `@proteos/ui`.\n */\nexport function useOpenCall(): (conversationBriefId: string) => void {\n  return useRuntime().openCall\n}\n\n/** The API origin SDK calls resolve against (for building raw asset URLs). */\nexport function useApiBaseUrl(): string {\n  return useRuntime().apiBaseUrl\n}\n\nconst NOOP_OVERLAY: OverlayController = {\n  expand: () => {\n    console.warn(\n      '@proteos/component-sdk: useOverlayExpansion() has no effect — this runtime ' +\n        'does not support overlay promotion (older shell or non-promoting host).',\n    )\n  },\n  collapse: () => {},\n  isExpanded: () => false,\n}\n\n/**\n * Manual overlay promotion — lifts the whole component iframe over the rest of\n * the page so an overlay can escape the frame's box.\n *\n * You rarely need this. Every `@proteos/ui` overlay (Modal, Popover, Menu,\n * Select, Tooltip, …) portals to the iframe document's `<body>`, which the\n * runtime watches — those promote automatically, with no code. Reach for this\n * hook only when you portal somewhere else yourself, or want the frame lifted\n * *before* the overlay mounts. Reference-counted: pair every `expand()` with a\n * `collapse()`.\n */\nexport function useOverlayExpansion(): OverlayController {\n  return useRuntime().overlay ?? NOOP_OVERLAY\n}\n\n/**\n * Open ANOTHER component in a modal the host renders above everything — the\n * cross-component flow (a picker, a wizard step, a confirm dialog shared by\n * several components). Resolves with whatever that component closed with, or\n * `undefined` if the user dismissed it.\n *\n * ```ts\n * const openModal = useComponentModal()\n * const picked = await openModal(\n *   'contact-picker',\n *   { entity: 'contact' },\n *   { title: 'Pick a contact', width: 'md', height: 480 },\n * )\n * ```\n *\n * Pass `height` whenever you know it — the modal opens at its final size\n * instead of growing after the component loads (see {@link OpenModalOptions}).\n * One modal per component at a time: a second call while the first is still\n * open resolves `undefined` straight away.\n *\n * String props are Liquid-rendered by the host against this component's page\n * scope, like the props of a page-placed component.\n *\n * For an overlay that is part of THIS component, just render a `<Modal>` from\n * `@proteos/ui` — it promotes automatically.\n */\nexport function useComponentModal(): (\n  componentSlug: string,\n  props?: Record<string, unknown>,\n  options?: OpenModalOptions,\n) => Promise<unknown> {\n  return useRuntime().openModal\n}\n\nexport interface ModalHost {\n  /** True when this component is rendered as the content of a host modal. */\n  isInModal: boolean\n  /** Close the host modal, resolving the opener's promise with `result`.\n   *  No-op outside a modal. */\n  close: (result?: unknown) => void\n}\n\n/**\n * For a component that is being shown INSIDE a host modal (opened by another\n * component's `useComponentModal()`): close it and hand a value back.\n * `isInModal` is false on ordinary page-hosted mounts, so one component can\n * serve both roles.\n */\nexport function useModalHost(): ModalHost {\n  const requestId = useRuntime().modalRequestId\n  const close = useCallback(\n    (result?: unknown) => {\n      if (requestId === undefined) return\n      postModalResult(requestId, result)\n    },\n    [requestId],\n  )\n  return useMemo(() => ({ isInModal: requestId !== undefined, close }), [requestId, close])\n}\n\n/**\n * A getter for the current bearer token. Returns a function (not the token)\n * because the token is refreshed in place — read it at call time for a raw\n * `fetch`. Most components never need this; prefer `useSdk()`.\n */\nexport function useAuthToken(): () => string {\n  return useRuntime().getToken\n}\n\nexport interface HostLocation {\n  /** The host tab's pathname (same-origin read), or null if unavailable. */\n  pathname: string | null\n  /** The org id parsed from `/org/<orgId>/…`, or null. */\n  orgId: string | null\n  /** The `/org/<orgId>/app/<appId>` prefix, or null when not on an app page. */\n  appBasePath: string | null\n}\n\nfunction readHostLocation(): HostLocation {\n  const empty: HostLocation = { pathname: null, orgId: null, appBasePath: null }\n  try {\n    const parentWindow = window.parent\n    if (!parentWindow || parentWindow === window) return empty\n    const pathname = parentWindow.location.pathname\n    const appMatch = pathname.match(/^\\/org\\/[^/]+\\/app\\/[^/]+/)\n    const orgMatch = pathname.match(/^\\/org\\/([^/]+)\\//)\n    return {\n      pathname,\n      orgId: orgMatch ? (orgMatch[1] ?? null) : null,\n      appBasePath: appMatch ? appMatch[0] : null,\n    }\n  } catch {\n    // Cross-origin (untrusted-component future) or detached — fall back to null.\n    return empty\n  }\n}\n\n/**\n * Read the host tab's location (same-origin) — the org id and `/org/.../app/...`\n * prefix needed to build navigation targets on platform pages. Read once on\n * mount (the iframe re-inits when the host route changes).\n */\nexport function useHostLocation(): HostLocation {\n  const [loc] = useState(readHostLocation)\n  return loc\n}\n\nexport interface FillViewportOptions {\n  /** Gap left below the component (px). Default 24. */\n  bottomMargin?: number\n  /** Floor for the computed height (px). Default 320. */\n  minHeight?: number\n}\n\n/**\n * Compute a \"fill the rest of the viewport\" height for full-bleed layouts\n * (boards, canvases). The runtime auto-sizes the iframe to its content, so a\n * component can't use its own `vh` units (circular). The iframe is same-origin,\n * so this measures the parent viewport minus the iframe's offset instead.\n * Returns `null` when it can't measure (fall back to natural height).\n */\nexport function useFillViewportHeight(options: FillViewportOptions = {}): number | null {\n  const { bottomMargin = 24, minHeight = 320 } = options\n  const [height, setHeight] = useState<number | null>(null)\n\n  useEffect(() => {\n    function compute(): void {\n      try {\n        const frame = window.frameElement\n        const parentWindow = window.parent\n        if (!frame || !parentWindow || parentWindow === window) return\n        const available =\n          parentWindow.innerHeight - frame.getBoundingClientRect().top - bottomMargin\n        setHeight(Math.max(available, minHeight))\n      } catch {\n        setHeight(null) // cross-origin or detached — fall back to natural height\n      }\n    }\n    compute()\n    try {\n      window.parent.addEventListener('resize', compute)\n      return () => window.parent.removeEventListener('resize', compute)\n    } catch {\n      return\n    }\n  }, [bottomMargin, minHeight])\n\n  return height\n}\n"]}
+{"version":3,"sources":["../src/context.tsx","../src/hooks.ts"],"names":["createContext","MESSAGE_SOURCE","isHostMessage","useMemo","useContext","useCallback","useState","useEffect"],"mappings":";;;;;;AAkKO,IAAM,cAAA,GAAiBA,oBAA0C,IAAI,CAAA;AAI5E,SAAS,aAAa,EAAA,EAAkB;AACtC,EAAA,MAAM,WAAsC,EAAE,MAAA,EAAQC,gCAAA,EAAgB,IAAA,EAAM,YAAY,EAAA,EAAG;AAC3F,EAAA,MAAA,CAAO,MAAA,EAAQ,WAAA,CAAY,QAAA,EAAU,GAAG,CAAA;AAC1C;AAIA,SAAS,aAAa,EAAA,EAAkB;AACtC,EAAA,MAAM,WAAsC,EAAE,MAAA,EAAQA,gCAAA,EAAgB,IAAA,EAAM,aAAa,EAAA,EAAG;AAC5F,EAAA,MAAA,CAAO,MAAA,EAAQ,WAAA,CAAY,QAAA,EAAU,GAAG,CAAA;AAC1C;AAGA,SAAS,SAAS,mBAAA,EAAmC;AACnD,EAAA,MAAM,QAAA,GAAsC;AAAA,IAC1C,MAAA,EAAQA,gCAAA;AAAA,IACR,IAAA,EAAM,WAAA;AAAA,IACN;AAAA,GACF;AACA,EAAA,MAAA,CAAO,MAAA,EAAQ,WAAA,CAAY,QAAA,EAAU,GAAG,CAAA;AAC1C;AAGA,SAAS,gBAAgB,OAAA,EAAwC;AAC/D,EAAA,MAAM,QAAA,GAA6C;AAAA,IACjD,MAAA,EAAQA,gCAAA;AAAA,IACR,IAAA,EAAM,mBAAA;AAAA,IACN,GAAI,SAAS,SAAA,KAAc,MAAA,GAAY,EAAE,SAAA,EAAW,OAAA,CAAQ,SAAA,EAAU,GAAI,EAAC;AAAA,IAC3E,GAAI,SAAS,QAAA,KAAa,MAAA,GAAY,EAAE,QAAA,EAAU,OAAA,CAAQ,QAAA,EAAS,GAAI,EAAC;AAAA,IACxE,GAAI,SAAS,MAAA,KAAW,MAAA,GAAY,EAAE,MAAA,EAAQ,OAAA,CAAQ,MAAA,EAAO,GAAI;AAAC,GACpE;AACA,EAAA,MAAA,CAAO,MAAA,EAAQ,WAAA,CAAY,QAAA,EAAU,GAAG,CAAA;AAC1C;AAGA,SAAS,gBAAA,GAAyB;AAChC,EAAA,MAAM,QAAA,GAA8C;AAAA,IAClD,MAAA,EAAQA,gCAAA;AAAA,IACR,IAAA,EAAM;AAAA,GACR;AACA,EAAA,MAAA,CAAO,MAAA,EAAQ,WAAA,CAAY,QAAA,EAAU,GAAG,CAAA;AAC1C;AAEA,IAAM,WAAA,GAAqC,EAAE,IAAA,EAAM,eAAA,EAAiB,OAAO,gBAAA,EAAiB;AAG5F,SAAS,QAAA,CAAS,IAAY,OAAA,EAAiC;AAC7D,EAAA,IAAI,OAAA,EAAS,IAAA,EAAM,YAAA,CAAa,EAAE,CAAA;AAAA,oBAChB,EAAE,CAAA;AACtB;AAMA,IAAM,aAAA,uBAAoB,GAAA,EAAuC;AACjE,IAAI,qBAAA,GAAwB,KAAA;AAE5B,SAAS,mBAAA,GAA4B;AACnC,EAAA,IAAI,qBAAA,EAAuB;AAC3B,EAAA,qBAAA,GAAwB,IAAA;AACxB,EAAA,MAAA,CAAO,gBAAA,CAAiB,SAAA,EAAW,CAAC,KAAA,KAAwB;AAC1D,IAAA,MAAM,OAAgB,KAAA,CAAM,IAAA;AAC5B,IAAA,IAAI,CAACC,+BAAA,CAAc,IAAI,CAAA,IAAK,IAAA,CAAK,SAAS,cAAA,EAAgB;AAC1D,IAAA,MAAM,OAAA,GAAU,aAAA,CAAc,GAAA,CAAI,IAAA,CAAK,SAAS,CAAA;AAEhD,IAAA,IAAI,CAAC,OAAA,EAAS;AACd,IAAA,aAAA,CAAc,MAAA,CAAO,KAAK,SAAS,CAAA;AACnC,IAAA,OAAA,CAAQ,KAAK,MAAM,CAAA;AAAA,EACrB,CAAC,CAAA;AACH;AAIA,IAAM,uBAAA,GAA0B,GAAA;AAYhC,SAAS,aAAa,MAAA,EAAkC;AACtD,EAAA,IAAI,CAAC,QAAQ,WAAA,EAAa;AAC1B,EAAA,MAAM,aAAa,MACjB,QAAA,CAAS,kBAAkB,IAAA,IAAQ,QAAA,CAAS,kBAAkB,QAAA,CAAS,IAAA;AACzE,EAAA,IAAI,QAAA,CAAS,QAAA,EAAS,IAAK,UAAA,EAAW,EAAG;AACvC,IAAA,MAAA,CAAO,KAAA,CAAM,EAAE,aAAA,EAAe,IAAA,EAAM,CAAA;AACpC,IAAA;AAAA,EACF;AACA,EAAA,MAAM,UAAU,MAAM;AACpB,IAAA,IAAA,EAAK;AAEL,IAAA,IAAI,MAAA,CAAO,eAAe,UAAA,EAAW,SAAU,KAAA,CAAM,EAAE,aAAA,EAAe,IAAA,EAAM,CAAA;AAAA,EAC9E,CAAA;AACA,EAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,UAAA,CAAW,IAAA,EAAM,uBAAuB,CAAA;AAC7D,EAAA,SAAS,IAAA,GAAa;AACpB,IAAA,MAAA,CAAO,aAAa,KAAK,CAAA;AACzB,IAAA,MAAA,CAAO,mBAAA,CAAoB,SAAS,OAAO,CAAA;AAAA,EAC7C;AACA,EAAA,MAAA,CAAO,gBAAA,CAAiB,SAAS,OAAO,CAAA;AAC1C;AAEA,SAAS,YAAA,GAAuB;AAC9B,EAAA,IAAI,OAAO,MAAA,KAAW,WAAA,IAAe,OAAO,MAAA,CAAO,eAAe,UAAA,EAAY;AAC5E,IAAA,OAAO,OAAO,UAAA,EAAW;AAAA,EAC3B;AACA,EAAA,OAAO,SAAS,IAAA,CAAK,GAAA,EAAI,CAAE,QAAA,CAAS,EAAE,CAAC,CAAA,CAAA,EAAI,IAAA,CAAK,MAAA,GAAS,QAAA,CAAS,EAAE,EAAE,KAAA,CAAM,CAAA,EAAG,EAAE,CAAC,CAAA,CAAA;AACpF;AAGA,SAAS,SAAA,CACP,aAAA,EACA,KAAA,EACA,OAAA,EACkB;AAClB,EAAA,mBAAA,EAAoB;AACpB,EAAA,MAAM,YAAY,YAAA,EAAa;AAC/B,EAAA,MAAM,QAAA,GAAuC;AAAA,IAC3C,MAAA,EAAQD,gCAAA;AAAA,IACR,IAAA,EAAM,YAAA;AAAA,IACN,SAAA;AAAA,IACA,aAAA;AAAA,IACA,GAAI,KAAA,KAAU,MAAA,GAAY,EAAE,KAAA,KAAU,EAAC;AAAA,IACvC,GAAI,SAAS,KAAA,KAAU,MAAA,GAAY,EAAE,KAAA,EAAO,OAAA,CAAQ,KAAA,EAAM,GAAI,EAAC;AAAA,IAC/D,GAAI,SAAS,KAAA,KAAU,MAAA,GAAY,EAAE,KAAA,EAAO,OAAA,CAAQ,KAAA,EAAM,GAAI,EAAC;AAAA,IAC/D,GAAI,SAAS,MAAA,KAAW,MAAA,GAAY,EAAE,MAAA,EAAQ,OAAA,CAAQ,MAAA,EAAO,GAAI;AAAC,GACpE;AACA,EAAA,MAAM,MAAA,GAAS,QAAA,CAAS,aAAA,YAAyB,WAAA,GAAc,SAAS,aAAA,GAAgB,IAAA;AACxF,EAAA,OAAO,IAAI,OAAA,CAAiB,CAAC,OAAA,KAAY;AACvC,IAAA,aAAA,CAAc,GAAA,CAAI,SAAA,EAAW,CAAC,MAAA,KAAW;AACvC,MAAA,YAAA,CAAa,MAAM,CAAA;AACnB,MAAA,OAAA,CAAQ,MAAM,CAAA;AAAA,IAChB,CAAC,CAAA;AACD,IAAA,MAAA,CAAO,MAAA,EAAQ,WAAA,CAAY,QAAA,EAAU,GAAG,CAAA;AAAA,EAC1C,CAAC,CAAA;AACH;AAGO,SAAS,eAAA,CAAgB,WAAmB,MAAA,EAAwB;AACzE,EAAA,MAAM,QAAA,GAAyC;AAAA,IAC7C,MAAA,EAAQA,gCAAA;AAAA,IACR,IAAA,EAAM,cAAA;AAAA,IACN,SAAA;AAAA,IACA,GAAI,MAAA,KAAW,MAAA,GAAY,EAAE,MAAA,KAAW;AAAC,GAC3C;AACA,EAAA,MAAA,CAAO,MAAA,EAAQ,WAAA,CAAY,QAAA,EAAU,GAAG,CAAA;AAC1C;AASO,SAAS,eAAA,CAAgB,EAAE,KAAA,EAAO,QAAA,EAAS,EAAiD;AAIjG,EAAA,MAAM,GAAA,GAAME,aAAA;AAAA,IACV,OAAO,EAAE,GAAG,OAAO,QAAA,EAAU,QAAA,EAAU,WAAW,WAAA,EAAY,CAAA;AAAA,IAC9D,CAAC,KAAK;AAAA,GACR;AACA,EAAA,sCAAQ,cAAA,CAAe,QAAA,EAAf,EAAwB,KAAA,EAAO,KAAM,QAAA,EAAS,CAAA;AACxD;AC5TO,SAAS,UAAA,GAAkC;AAChD,EAAA,MAAM,GAAA,GAAMC,iBAAW,cAAc,CAAA;AACrC,EAAA,IAAI,CAAC,GAAA,EAAK;AACR,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KAIF;AAAA,EACF;AACA,EAAA,OAAO,GAAA;AACT;AAGO,SAAS,MAAA,GAAuB;AACrC,EAAA,OAAO,YAAW,CAAE,GAAA;AACtB;AAGO,SAAS,QAAA,GAA2E;AACzF,EAAA,OAAO,YAAW,CAAE,KAAA;AACtB;AAOO,SAAS,cAAA,GAA8B;AAC5C,EAAA,OAAO,YAAW,CAAE,OAAA;AACtB;AAWO,SAAS,WAAA,GAA+D;AAC7E,EAAA,OAAO,YAAW,CAAE,QAAA;AACtB;AAOO,SAAS,WAAA,GAAqD;AACnE,EAAA,OAAO,YAAW,CAAE,QAAA;AACtB;AAkBO,SAAS,cAAA,GAAwC;AACtD,EAAA,OAAO,YAAW,CAAE,WAAA;AACtB;AAGO,SAAS,aAAA,GAAwB;AACtC,EAAA,OAAO,YAAW,CAAE,UAAA;AACtB;AAEA,IAAM,YAAA,GAAkC;AAAA,EACtC,QAAQ,MAAM;AACZ,IAAA,OAAA,CAAQ,IAAA;AAAA,MACN;AAAA,KAEF;AAAA,EACF,CAAA;AAAA,EACA,UAAU,MAAM;AAAA,EAAC,CAAA;AAAA,EACjB,YAAY,MAAM;AACpB,CAAA;AAaO,SAAS,mBAAA,GAAyC;AACvD,EAAA,OAAO,UAAA,GAAa,OAAA,IAAW,YAAA;AACjC;AA4BO,SAAS,iBAAA,GAIM;AACpB,EAAA,OAAO,YAAW,CAAE,SAAA;AACtB;AAgBO,SAAS,YAAA,GAA0B;AACxC,EAAA,MAAM,SAAA,GAAY,YAAW,CAAE,cAAA;AAC/B,EAAA,MAAM,KAAA,GAAQC,iBAAA;AAAA,IACZ,CAAC,MAAA,KAAqB;AACpB,MAAA,IAAI,cAAc,MAAA,EAAW;AAC7B,MAAA,eAAA,CAAgB,WAAW,MAAM,CAAA;AAAA,IACnC,CAAA;AAAA,IACA,CAAC,SAAS;AAAA,GACZ;AACA,EAAA,OAAOF,aAAAA,CAAQ,OAAO,EAAE,SAAA,EAAW,SAAA,KAAc,MAAA,EAAW,KAAA,EAAM,CAAA,EAAI,CAAC,SAAA,EAAW,KAAK,CAAC,CAAA;AAC1F;AAOO,SAAS,YAAA,GAA6B;AAC3C,EAAA,OAAO,YAAW,CAAE,QAAA;AACtB;AAWA,SAAS,gBAAA,GAAiC;AACxC,EAAA,MAAM,QAAsB,EAAE,QAAA,EAAU,MAAM,KAAA,EAAO,IAAA,EAAM,aAAa,IAAA,EAAK;AAC7E,EAAA,IAAI;AACF,IAAA,MAAM,eAAe,MAAA,CAAO,MAAA;AAC5B,IAAA,IAAI,CAAC,YAAA,IAAgB,YAAA,KAAiB,MAAA,EAAQ,OAAO,KAAA;AACrD,IAAA,MAAM,QAAA,GAAW,aAAa,QAAA,CAAS,QAAA;AACvC,IAAA,MAAM,QAAA,GAAW,QAAA,CAAS,KAAA,CAAM,2BAA2B,CAAA;AAC3D,IAAA,MAAM,QAAA,GAAW,QAAA,CAAS,KAAA,CAAM,mBAAmB,CAAA;AACnD,IAAA,OAAO;AAAA,MACL,QAAA;AAAA,MACA,KAAA,EAAO,QAAA,GAAY,QAAA,CAAS,CAAC,KAAK,IAAA,GAAQ,IAAA;AAAA,MAC1C,WAAA,EAAa,QAAA,GAAW,QAAA,CAAS,CAAC,CAAA,GAAI;AAAA,KACxC;AAAA,EACF,CAAA,CAAA,MAAQ;AAEN,IAAA,OAAO,KAAA;AAAA,EACT;AACF;AAOO,SAAS,eAAA,GAAgC;AAC9C,EAAA,MAAM,CAAC,GAAG,CAAA,GAAIG,cAAA,CAAS,gBAAgB,CAAA;AACvC,EAAA,OAAO,GAAA;AACT;AAgBO,SAAS,qBAAA,CAAsB,OAAA,GAA+B,EAAC,EAAkB;AACtF,EAAA,MAAM,EAAE,YAAA,GAAe,EAAA,EAAI,SAAA,GAAY,KAAI,GAAI,OAAA;AAC/C,EAAA,MAAM,CAAC,MAAA,EAAQ,SAAS,CAAA,GAAIA,eAAwB,IAAI,CAAA;AAExD,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,SAAS,OAAA,GAAgB;AACvB,MAAA,IAAI;AACF,QAAA,MAAM,QAAQ,MAAA,CAAO,YAAA;AACrB,QAAA,MAAM,eAAe,MAAA,CAAO,MAAA;AAC5B,QAAA,IAAI,CAAC,KAAA,IAAS,CAAC,YAAA,IAAgB,iBAAiB,MAAA,EAAQ;AACxD,QAAA,MAAM,YACJ,YAAA,CAAa,WAAA,GAAc,KAAA,CAAM,qBAAA,GAAwB,GAAA,GAAM,YAAA;AACjE,QAAA,SAAA,CAAU,IAAA,CAAK,GAAA,CAAI,SAAA,EAAW,SAAS,CAAC,CAAA;AAAA,MAC1C,CAAA,CAAA,MAAQ;AACN,QAAA,SAAA,CAAU,IAAI,CAAA;AAAA,MAChB;AAAA,IACF;AACA,IAAA,OAAA,EAAQ;AACR,IAAA,IAAI;AACF,MAAA,MAAA,CAAO,MAAA,CAAO,gBAAA,CAAiB,QAAA,EAAU,OAAO,CAAA;AAChD,MAAA,OAAO,MAAM,MAAA,CAAO,MAAA,CAAO,mBAAA,CAAoB,UAAU,OAAO,CAAA;AAAA,IAClE,CAAA,CAAA,MAAQ;AACN,MAAA;AAAA,IACF;AAAA,EACF,CAAA,EAAG,CAAC,YAAA,EAAc,SAAS,CAAC,CAAA;AAE5B,EAAA,OAAO,MAAA;AACT","file":"index.cjs","sourcesContent":["import type {\n  AccountClient,\n  AgentClient,\n  ConversationClient,\n  DataClient,\n  FunctionsClient,\n  KnowledgeClient,\n  MetaClient,\n  StorageClient,\n} from '@proteos/sdk'\nimport { createContext, type ReactNode, useMemo } from 'react'\n\nimport {\n  type CloseAgentWindowMessage,\n  type Envelope,\n  isHostMessage,\n  MESSAGE_SOURCE,\n  type ModalResultMessage,\n  type ModalWidth,\n  type NavigateMessage,\n  type OpenAgentWindowMessage,\n  type OpenCallMessage,\n  type OpenModalMessage,\n  type OpenPeekMessage,\n  type PageContext,\n} from './protocol'\n\n/** Options for {@link RuntimeContextValue.navigate}. */\nexport interface NavigateOptions {\n  /** Open the target in a peek (slide-over) panel instead of full-page. */\n  peek?: boolean\n}\n\n/** Options for {@link RuntimeContextValue.openModal}. */\nexport interface OpenModalOptions {\n  /** Heading rendered in the modal chrome. */\n  title?: string\n  /** Panel width: `sm` 384px, `md` 512px, `lg` 672px (default), `xl` 896px. */\n  width?: ModalWidth\n  /** Height of the component's frame, in px. Pass it whenever you know it: the\n   *  modal then opens at its final size instead of growing once the component\n   *  has loaded. The frame is capped at the viewport, scrolls its own content,\n   *  and sits edge to edge in the panel — so the component owns its padding\n   *  (`ModalBody` / `ModalFooter` from `@proteos/ui` carry the standard one).\n   *  Leave it out and the frame grows with its content inside the host's\n   *  padded body. */\n  height?: number\n}\n\n/** What {@link AgentWindowController.open} opens the host's agent window to. */\nexport interface OpenAgentWindowOptions {\n  /** Resume this session (its agent comes with it). */\n  sessionId?: string\n  /** Start a fresh session with this agent. Ignored when `sessionId` is set,\n   *  and when the host surface pins its agent. Without it (and without a\n   *  session) the window's currently selected agent is used. */\n  agentKey?: string\n  /** A message to send — into the resumed session, or as the first message\n   *  of the fresh one. */\n  prompt?: string\n}\n\n/**\n * The host's agent session window (the floating assistant), driven from a\n * component. `open()` posts OPEN_AGENT_WINDOW, `close()` posts\n * CLOSE_AGENT_WINDOW — closing minimizes; the session and its stream live on.\n */\nexport interface AgentWindowController {\n  open: (options?: OpenAgentWindowOptions) => void\n  close: () => void\n}\n\n/**\n * Manual control over iframe overlay promotion. The runtime already detects\n * overlays automatically (anything portaled to the iframe's `document.body` —\n * every `@proteos/ui` overlay qualifies), so components need this only for\n * custom portal targets, or to promote a frame *before* opening an overlay.\n * Calls are reference-counted: every `expand()` needs its `collapse()`.\n */\nexport interface OverlayController {\n  expand: () => void\n  collapse: () => void\n  isExpanded: () => boolean\n}\n\n/**\n * The authenticated `@proteos/sdk` clients the runtime injects. Same instances\n * the host app uses — pre-wired with a refreshing bearer token, so a component\n * never touches auth headers.\n */\nexport interface ComponentSdk {\n  account: AccountClient\n  agents: AgentClient\n  /**\n   * Conversations, messages, contacts, connections (conversation-service) —\n   * e.g. the DraftMessageComposer review surface. Plural per the platform's\n   * resource-naming rule; the web app's own `useSdk().conversation` predates\n   * it (documented asymmetry).\n   */\n  conversations: ConversationClient\n  data: DataClient\n  functions: FunctionsClient\n  knowledge: KnowledgeClient\n  meta: MetaClient\n  storage: StorageClient\n}\n\n/**\n * The raw runtime payload the shell hands a component at INIT. The shell builds\n * this; component authors read it through the hooks.\n */\nexport interface RuntimeValue {\n  /**\n   * The injected sdk clients. On an authenticated page these are the full,\n   * bearer-wired clients. On a PUBLIC page (`isPublic: true`) only\n   * `functions.actions.invokePublic` reaches the platform — every other\n   * client throws on use (there is no token, and the server rejects\n   * unauthenticated calls anyway).\n   */\n  sdk: ComponentSdk\n  /** Liquid-resolved props (a snapshot — not a live binding). */\n  props: Record<string, unknown>\n  /** Page context snapshot: the host record, entity, and URL params. */\n  pageCtx: PageContext\n  /** API origin SDK calls + asset URLs resolve against. */\n  apiBaseUrl: string\n  /** Current bearer token getter (escape hatch for raw fetches). Returns ''\n   *  on public pages. */\n  getToken: () => string\n  /** True when rendering on an unauthenticated public page. */\n  isPublic?: boolean\n  /** Org id, set in public mode (public API routes carry it in the path). */\n  orgId?: string\n  /** Set when this component is the content of a host component modal — the\n   *  correlation id it closes with. See `useModalHost()`. */\n  modalRequestId?: string\n  /** Overlay promotion controller, provided by the shell. Absent on older\n   *  shells / non-promoting hosts, in which case `useOverlayExpansion()`\n   *  no-ops. */\n  overlay?: OverlayController\n}\n\n/** Runtime value plus the derived helpers the hooks expose. */\nexport interface RuntimeContextValue extends RuntimeValue {\n  /** Navigate the host SPA to an in-app path (posts a NAVIGATE message), or\n   *  open it in a peek panel with `{ peek: true }` (posts OPEN_PEEK). */\n  navigate: (to: string, options?: NavigateOptions) => void\n  /** Ask the host to open a prepared call from a conversation brief (posts\n   *  OPEN_CALL): the host previews the brief and dials through its softphone. */\n  openCall: (conversationBriefId: string) => void\n  /** Open another component in a host-rendered modal; resolves with the value\n   *  that component closed with (`undefined` if dismissed). */\n  openModal: (\n    componentSlug: string,\n    props?: Record<string, unknown>,\n    options?: OpenModalOptions,\n  ) => Promise<unknown>\n  /** Open / minimize the host's agent session window (posts OPEN_AGENT_WINDOW\n   *  / CLOSE_AGENT_WINDOW). */\n  agentWindow: AgentWindowController\n}\n\nexport const RuntimeContext = createContext<RuntimeContextValue | null>(null)\n\n/** Post a NAVIGATE envelope to the host. The host only honours relative,\n *  in-app targets (it ignores absolute/external URLs). */\nfunction postNavigate(to: string): void {\n  const envelope: Envelope<NavigateMessage> = { source: MESSAGE_SOURCE, type: 'NAVIGATE', to }\n  window.parent?.postMessage(envelope, '*')\n}\n\n/** Post an OPEN_PEEK envelope to the host — open the in-app path in a peek\n *  panel. Same relative-path contract as {@link postNavigate}. */\nfunction postOpenPeek(to: string): void {\n  const envelope: Envelope<OpenPeekMessage> = { source: MESSAGE_SOURCE, type: 'OPEN_PEEK', to }\n  window.parent?.postMessage(envelope, '*')\n}\n\n/** Post OPEN_CALL — the host previews the conversation brief and owns the dial. */\nfunction openCall(conversationBriefId: string): void {\n  const envelope: Envelope<OpenCallMessage> = {\n    source: MESSAGE_SOURCE,\n    type: 'OPEN_CALL',\n    conversationBriefId,\n  }\n  window.parent?.postMessage(envelope, '*')\n}\n\n/** Post OPEN_AGENT_WINDOW — only the fields that were given ride the wire. */\nfunction openAgentWindow(options?: OpenAgentWindowOptions): void {\n  const envelope: Envelope<OpenAgentWindowMessage> = {\n    source: MESSAGE_SOURCE,\n    type: 'OPEN_AGENT_WINDOW',\n    ...(options?.sessionId !== undefined ? { sessionId: options.sessionId } : {}),\n    ...(options?.agentKey !== undefined ? { agentKey: options.agentKey } : {}),\n    ...(options?.prompt !== undefined ? { prompt: options.prompt } : {}),\n  }\n  window.parent?.postMessage(envelope, '*')\n}\n\n/** Post CLOSE_AGENT_WINDOW — minimize the host's agent window. */\nfunction closeAgentWindow(): void {\n  const envelope: Envelope<CloseAgentWindowMessage> = {\n    source: MESSAGE_SOURCE,\n    type: 'CLOSE_AGENT_WINDOW',\n  }\n  window.parent?.postMessage(envelope, '*')\n}\n\nconst agentWindow: AgentWindowController = { open: openAgentWindow, close: closeAgentWindow }\n\n/** Navigate full-page (default) or into a peek panel (`{ peek: true }`). */\nfunction navigate(to: string, options?: NavigateOptions): void {\n  if (options?.peek) postOpenPeek(to)\n  else postNavigate(to)\n}\n\n// ── Component modals ────────────────────────────────────────────────────────\n// One module-level listener + a pending map, rather than a listener per call:\n// the SDK is an import-mapped singleton, so this is per-iframe state.\n\nconst pendingModals = new Map<string, (result: unknown) => void>()\nlet modalListenerAttached = false\n\nfunction ensureModalListener(): void {\n  if (modalListenerAttached) return\n  modalListenerAttached = true\n  window.addEventListener('message', (event: MessageEvent) => {\n    const data: unknown = event.data\n    if (!isHostMessage(data) || data.type !== 'MODAL_CLOSED') return\n    const resolve = pendingModals.get(data.requestId)\n    // An unknown requestId is someone else's modal (or a stale reply) — drop it.\n    if (!resolve) return\n    pendingModals.delete(data.requestId)\n    resolve(data.result)\n  })\n}\n\n// How long after a modal closed the opener still claims the focus the host\n// hands back. Past that, focus arriving on the frame is something else.\nconst FOCUS_RESTORE_WINDOW_MS = 1000\n\n/** Puts focus back on the control that opened a modal.\n *\n *  The host returns focus to this FRAME when its dialog closes, but not to the\n *  control inside it: the frame is inert while the dialog is up, which drops\n *  the focus it held, so it comes back on `<body>`. Only this side knows which\n *  control it was.\n *\n *  The reply (MODAL_CLOSED) arrives before the dialog has finished closing —\n *  the frame may still be inert then and refuse focus — so this waits for the\n *  frame to actually receive it. */\nfunction restoreFocus(opener: HTMLElement | null): void {\n  if (!opener?.isConnected) return\n  const isUnplaced = () =>\n    document.activeElement === null || document.activeElement === document.body\n  if (document.hasFocus() && isUnplaced()) {\n    opener.focus({ preventScroll: true })\n    return\n  }\n  const onFocus = () => {\n    stop()\n    // Something in here took focus in the meantime — leave it be.\n    if (opener.isConnected && isUnplaced()) opener.focus({ preventScroll: true })\n  }\n  const timer = window.setTimeout(stop, FOCUS_RESTORE_WINDOW_MS)\n  function stop(): void {\n    window.clearTimeout(timer)\n    window.removeEventListener('focus', onFocus)\n  }\n  window.addEventListener('focus', onFocus)\n}\n\nfunction newRequestId(): string {\n  if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {\n    return crypto.randomUUID()\n  }\n  return `modal_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`\n}\n\n/** Post OPEN_MODAL and resolve when the host answers MODAL_CLOSED. */\nfunction openModal(\n  componentSlug: string,\n  props?: Record<string, unknown>,\n  options?: OpenModalOptions,\n): Promise<unknown> {\n  ensureModalListener()\n  const requestId = newRequestId()\n  const envelope: Envelope<OpenModalMessage> = {\n    source: MESSAGE_SOURCE,\n    type: 'OPEN_MODAL',\n    requestId,\n    componentSlug,\n    ...(props !== undefined ? { props } : {}),\n    ...(options?.title !== undefined ? { title: options.title } : {}),\n    ...(options?.width !== undefined ? { width: options.width } : {}),\n    ...(options?.height !== undefined ? { height: options.height } : {}),\n  }\n  const opener = document.activeElement instanceof HTMLElement ? document.activeElement : null\n  return new Promise<unknown>((resolve) => {\n    pendingModals.set(requestId, (result) => {\n      restoreFocus(opener)\n      resolve(result)\n    })\n    window.parent?.postMessage(envelope, '*')\n  })\n}\n\n/** Post MODAL_RESULT — the component inside a host modal closing with a value. */\nexport function postModalResult(requestId: string, result?: unknown): void {\n  const envelope: Envelope<ModalResultMessage> = {\n    source: MESSAGE_SOURCE,\n    type: 'MODAL_RESULT',\n    requestId,\n    ...(result !== undefined ? { result } : {}),\n  }\n  window.parent?.postMessage(envelope, '*')\n}\n\n/**\n * Provides the runtime value + derived helpers to a component subtree. Mounted\n * by the component-runtime shell around the loaded component — authors never\n * render this themselves. Lives in `@proteos/component-sdk` (a shared,\n * import-mapped singleton) so the context the shell provides is the very same\n * context the component's hooks read, across the bundle boundary.\n */\nexport function RuntimeProvider({ value, children }: { value: RuntimeValue; children: ReactNode }) {\n  // The shell builds `value` once at INIT (a stable state object — clients,\n  // props and pageCtx are all set once), so memoizing on its identity recreates\n  // the context only when the runtime genuinely re-inits.\n  const ctx = useMemo<RuntimeContextValue>(\n    () => ({ ...value, navigate, openCall, openModal, agentWindow }),\n    [value],\n  )\n  return <RuntimeContext.Provider value={ctx}>{children}</RuntimeContext.Provider>\n}\n","import { useCallback, useContext, useEffect, useMemo, useState } from 'react'\n\nimport {\n  type AgentWindowController,\n  type ComponentSdk,\n  type NavigateOptions,\n  type OpenModalOptions,\n  type OverlayController,\n  postModalResult,\n  RuntimeContext,\n  type RuntimeContextValue,\n} from './context'\nimport type { PageContext } from './protocol'\n\n/**\n * Low-level escape hatch: the whole runtime context (sdk, props, pageCtx,\n * apiBaseUrl, getToken, navigate). Prefer the focused hooks below. Throws a\n * clear error if used outside the component runtime.\n */\nexport function useRuntime(): RuntimeContextValue {\n  const ctx = useContext(RuntimeContext)\n  if (!ctx) {\n    throw new Error(\n      '@proteos/component-sdk: hooks must run inside the Proteos component runtime. ' +\n        'This usually means the component is rendered outside its iframe, or a ' +\n        'second copy of @proteos/component-sdk was bundled instead of using the ' +\n        'runtime-provided one (keep it external).',\n    )\n  }\n  return ctx\n}\n\n/** The authenticated SDK clients (account / agents / conversations / data / functions / knowledge / meta / storage). */\nexport function useSdk(): ComponentSdk {\n  return useRuntime().sdk\n}\n\n/** The component's Liquid-resolved props (a snapshot, not a live binding). */\nexport function useProps<T extends Record<string, unknown> = Record<string, unknown>>(): T {\n  return useRuntime().props as T\n}\n\n/**\n * The full page context: host `record`, `entity`, and URL `params`. The\n * `record` is a snapshot taken at mount (`undefined` on record-less platform\n * pages) — fetch via `useSdk().data` for anything that must stay fresh.\n */\nexport function usePageContext(): PageContext {\n  return useRuntime().pageCtx\n}\n\n/**\n * Navigate the host SPA to an in-app path, e.g.\n * `navigate('/org/acme/record/task/123')`. The host ignores absolute/external\n * URLs. Build org/app-prefixed paths with `useHostLocation().appBasePath`.\n *\n * Pass `{ peek: true }` to open the path in a peek (slide-over) panel instead\n * of full-page navigation — e.g. `navigate(path, { peek: true })`. The host\n * peeks what it can (today: platform pages) and falls back to full navigation.\n */\nexport function useNavigate(): (to: string, options?: NavigateOptions) => void {\n  return useRuntime().navigate\n}\n\n/**\n * Open a prepared call from a conversation brief id: the HOST previews the brief and\n * places the call through its softphone (an iframe cannot dial). Pair it with\n * `ConversationBriefReview`'s `onOpenCall` from `@proteos/ui`.\n */\nexport function useOpenCall(): (conversationBriefId: string) => void {\n  return useRuntime().openCall\n}\n\n/**\n * Open or minimize the HOST's agent session window (the floating assistant)\n * from a component — the iframe cannot render it itself.\n *\n * ```ts\n * const agentWindow = useAgentWindow()\n * agentWindow.open()                                   // just open it\n * agentWindow.open({ sessionId })                      // resume a session\n * agentWindow.open({ agentKey: 'sales-bot', prompt })  // fresh session, prompt sent\n * agentWindow.close()                                  // minimize (session lives on)\n * ```\n *\n * `sessionId` wins over `agentKey` (the session already has an agent); a\n * `prompt` goes into whichever session the window lands on. Ignored on public\n * pages, and by preview hosts.\n */\nexport function useAgentWindow(): AgentWindowController {\n  return useRuntime().agentWindow\n}\n\n/** The API origin SDK calls resolve against (for building raw asset URLs). */\nexport function useApiBaseUrl(): string {\n  return useRuntime().apiBaseUrl\n}\n\nconst NOOP_OVERLAY: OverlayController = {\n  expand: () => {\n    console.warn(\n      '@proteos/component-sdk: useOverlayExpansion() has no effect — this runtime ' +\n        'does not support overlay promotion (older shell or non-promoting host).',\n    )\n  },\n  collapse: () => {},\n  isExpanded: () => false,\n}\n\n/**\n * Manual overlay promotion — lifts the whole component iframe over the rest of\n * the page so an overlay can escape the frame's box.\n *\n * You rarely need this. Every `@proteos/ui` overlay (Modal, Popover, Menu,\n * Select, Tooltip, …) portals to the iframe document's `<body>`, which the\n * runtime watches — those promote automatically, with no code. Reach for this\n * hook only when you portal somewhere else yourself, or want the frame lifted\n * *before* the overlay mounts. Reference-counted: pair every `expand()` with a\n * `collapse()`.\n */\nexport function useOverlayExpansion(): OverlayController {\n  return useRuntime().overlay ?? NOOP_OVERLAY\n}\n\n/**\n * Open ANOTHER component in a modal the host renders above everything — the\n * cross-component flow (a picker, a wizard step, a confirm dialog shared by\n * several components). Resolves with whatever that component closed with, or\n * `undefined` if the user dismissed it.\n *\n * ```ts\n * const openModal = useComponentModal()\n * const picked = await openModal(\n *   'contact-picker',\n *   { entity: 'contact' },\n *   { title: 'Pick a contact', width: 'md', height: 480 },\n * )\n * ```\n *\n * Pass `height` whenever you know it — the modal opens at its final size\n * instead of growing after the component loads (see {@link OpenModalOptions}).\n * One modal per component at a time: a second call while the first is still\n * open resolves `undefined` straight away.\n *\n * String props are Liquid-rendered by the host against this component's page\n * scope, like the props of a page-placed component.\n *\n * For an overlay that is part of THIS component, just render a `<Modal>` from\n * `@proteos/ui` — it promotes automatically.\n */\nexport function useComponentModal(): (\n  componentSlug: string,\n  props?: Record<string, unknown>,\n  options?: OpenModalOptions,\n) => Promise<unknown> {\n  return useRuntime().openModal\n}\n\nexport interface ModalHost {\n  /** True when this component is rendered as the content of a host modal. */\n  isInModal: boolean\n  /** Close the host modal, resolving the opener's promise with `result`.\n   *  No-op outside a modal. */\n  close: (result?: unknown) => void\n}\n\n/**\n * For a component that is being shown INSIDE a host modal (opened by another\n * component's `useComponentModal()`): close it and hand a value back.\n * `isInModal` is false on ordinary page-hosted mounts, so one component can\n * serve both roles.\n */\nexport function useModalHost(): ModalHost {\n  const requestId = useRuntime().modalRequestId\n  const close = useCallback(\n    (result?: unknown) => {\n      if (requestId === undefined) return\n      postModalResult(requestId, result)\n    },\n    [requestId],\n  )\n  return useMemo(() => ({ isInModal: requestId !== undefined, close }), [requestId, close])\n}\n\n/**\n * A getter for the current bearer token. Returns a function (not the token)\n * because the token is refreshed in place — read it at call time for a raw\n * `fetch`. Most components never need this; prefer `useSdk()`.\n */\nexport function useAuthToken(): () => string {\n  return useRuntime().getToken\n}\n\nexport interface HostLocation {\n  /** The host tab's pathname (same-origin read), or null if unavailable. */\n  pathname: string | null\n  /** The org id parsed from `/org/<orgId>/…`, or null. */\n  orgId: string | null\n  /** The `/org/<orgId>/app/<appId>` prefix, or null when not on an app page. */\n  appBasePath: string | null\n}\n\nfunction readHostLocation(): HostLocation {\n  const empty: HostLocation = { pathname: null, orgId: null, appBasePath: null }\n  try {\n    const parentWindow = window.parent\n    if (!parentWindow || parentWindow === window) return empty\n    const pathname = parentWindow.location.pathname\n    const appMatch = pathname.match(/^\\/org\\/[^/]+\\/app\\/[^/]+/)\n    const orgMatch = pathname.match(/^\\/org\\/([^/]+)\\//)\n    return {\n      pathname,\n      orgId: orgMatch ? (orgMatch[1] ?? null) : null,\n      appBasePath: appMatch ? appMatch[0] : null,\n    }\n  } catch {\n    // Cross-origin (untrusted-component future) or detached — fall back to null.\n    return empty\n  }\n}\n\n/**\n * Read the host tab's location (same-origin) — the org id and `/org/.../app/...`\n * prefix needed to build navigation targets on platform pages. Read once on\n * mount (the iframe re-inits when the host route changes).\n */\nexport function useHostLocation(): HostLocation {\n  const [loc] = useState(readHostLocation)\n  return loc\n}\n\nexport interface FillViewportOptions {\n  /** Gap left below the component (px). Default 24. */\n  bottomMargin?: number\n  /** Floor for the computed height (px). Default 320. */\n  minHeight?: number\n}\n\n/**\n * Compute a \"fill the rest of the viewport\" height for full-bleed layouts\n * (boards, canvases). The runtime auto-sizes the iframe to its content, so a\n * component can't use its own `vh` units (circular). The iframe is same-origin,\n * so this measures the parent viewport minus the iframe's offset instead.\n * Returns `null` when it can't measure (fall back to natural height).\n */\nexport function useFillViewportHeight(options: FillViewportOptions = {}): number | null {\n  const { bottomMargin = 24, minHeight = 320 } = options\n  const [height, setHeight] = useState<number | null>(null)\n\n  useEffect(() => {\n    function compute(): void {\n      try {\n        const frame = window.frameElement\n        const parentWindow = window.parent\n        if (!frame || !parentWindow || parentWindow === window) return\n        const available =\n          parentWindow.innerHeight - frame.getBoundingClientRect().top - bottomMargin\n        setHeight(Math.max(available, minHeight))\n      } catch {\n        setHeight(null) // cross-origin or detached — fall back to natural height\n      }\n    }\n    compute()\n    try {\n      window.parent.addEventListener('resize', compute)\n      return () => window.parent.removeEventListener('resize', compute)\n    } catch {\n      return\n    }\n  }, [bottomMargin, minHeight])\n\n  return height\n}\n"]}

package/dist/index.d.cts

@@ -2,7 +2,7 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 import { AccountClient, AgentClient, ConversationClient, DataClient, FunctionsClient, KnowledgeClient, MetaClient, StorageClient } from '@proteos/sdk';
 import { ModalWidth, PageContext } from './protocol.cjs';
-export { AuthRefreshMessage, COMPONENT_OVERLAY_Z_INDEX, DataInvalidateMessage, Envelope, ErrorMessage, EscapePressedMessage, HostMessage, InitMessage, MESSAGE_SOURCE, ModalClosedMessage, ModalResultMessage, NavigateMessage, OpenCallMessage, OpenModalMessage, OpenPeekMessage, OverlayRect, OverlayRectMessage, OverlayStateMessage, ReadyMessage, ResizeMessage, RuntimeMessage, isHostMessage, isRuntimeMessage } from './protocol.cjs';
+export { AuthRefreshMessage, COMPONENT_OVERLAY_Z_INDEX, CloseAgentWindowMessage, DataInvalidateMessage, Envelope, ErrorMessage, EscapePressedMessage, HostMessage, InitMessage, MESSAGE_SOURCE, ModalClosedMessage, ModalResultMessage, NavigateMessage, OpenAgentWindowMessage, OpenCallMessage, OpenModalMessage, OpenPeekMessage, OverlayRect, OverlayRectMessage, OverlayStateMessage, ReadyMessage, ResizeMessage, RuntimeMessage, isHostMessage, isRuntimeMessage } from './protocol.cjs';
 
 /** Options for {@link RuntimeContextValue.navigate}. */
 interface NavigateOptions {
@@ -24,6 +24,27 @@ interface OpenModalOptions {
      *  padded body. */
     height?: number;
 }
+/** What {@link AgentWindowController.open} opens the host's agent window to. */
+interface OpenAgentWindowOptions {
+    /** Resume this session (its agent comes with it). */
+    sessionId?: string;
+    /** Start a fresh session with this agent. Ignored when `sessionId` is set,
+     *  and when the host surface pins its agent. Without it (and without a
+     *  session) the window's currently selected agent is used. */
+    agentKey?: string;
+    /** A message to send — into the resumed session, or as the first message
+     *  of the fresh one. */
+    prompt?: string;
+}
+/**
+ * The host's agent session window (the floating assistant), driven from a
+ * component. `open()` posts OPEN_AGENT_WINDOW, `close()` posts
+ * CLOSE_AGENT_WINDOW — closing minimizes; the session and its stream live on.
+ */
+interface AgentWindowController {
+    open: (options?: OpenAgentWindowOptions) => void;
+    close: () => void;
+}
 /**
  * Manual control over iframe overlay promotion. The runtime already detects
  * overlays automatically (anything portaled to the iframe's `document.body` —
@@ -102,6 +123,9 @@ interface RuntimeContextValue extends RuntimeValue {
     /** Open another component in a host-rendered modal; resolves with the value
      *  that component closed with (`undefined` if dismissed). */
     openModal: (componentSlug: string, props?: Record<string, unknown>, options?: OpenModalOptions) => Promise<unknown>;
+    /** Open / minimize the host's agent session window (posts OPEN_AGENT_WINDOW
+     *  / CLOSE_AGENT_WINDOW). */
+    agentWindow: AgentWindowController;
 }
 /**
  * Provides the runtime value + derived helpers to a component subtree. Mounted
@@ -159,6 +183,23 @@ declare function useNavigate(): (to: string, options?: NavigateOptions) => void;
  * `ConversationBriefReview`'s `onOpenCall` from `@proteos/ui`.
  */
 declare function useOpenCall(): (conversationBriefId: string) => void;
+/**
+ * Open or minimize the HOST's agent session window (the floating assistant)
+ * from a component — the iframe cannot render it itself.
+ *
+ * ```ts
+ * const agentWindow = useAgentWindow()
+ * agentWindow.open()                                   // just open it
+ * agentWindow.open({ sessionId })                      // resume a session
+ * agentWindow.open({ agentKey: 'sales-bot', prompt })  // fresh session, prompt sent
+ * agentWindow.close()                                  // minimize (session lives on)
+ * ```
+ *
+ * `sessionId` wins over `agentKey` (the session already has an agent); a
+ * `prompt` goes into whichever session the window lands on. Ignored on public
+ * pages, and by preview hosts.
+ */
+declare function useAgentWindow(): AgentWindowController;
 /** The API origin SDK calls resolve against (for building raw asset URLs). */
 declare function useApiBaseUrl(): string;
 /**
@@ -249,4 +290,4 @@ interface FillViewportOptions {
  */
 declare function useFillViewportHeight(options?: FillViewportOptions): number | null;
 
-export { type ComponentSdk, type FillViewportOptions, type HostLocation, type ModalHost, ModalWidth, type NavigateOptions, type OpenModalOptions, type OverlayController, PageContext, type RuntimeContextValue, RuntimeProvider, type RuntimeValue, useApiBaseUrl, useAuthToken, useComponentModal, useFillViewportHeight, useHostLocation, useModalHost, useNavigate, useOpenCall, useOverlayExpansion, usePageContext, useProps, useRuntime, useSdk };
+export { type AgentWindowController, type ComponentSdk, type FillViewportOptions, type HostLocation, type ModalHost, ModalWidth, type NavigateOptions, type OpenAgentWindowOptions, type OpenModalOptions, type OverlayController, PageContext, type RuntimeContextValue, RuntimeProvider, type RuntimeValue, useAgentWindow, useApiBaseUrl, useAuthToken, useComponentModal, useFillViewportHeight, useHostLocation, useModalHost, useNavigate, useOpenCall, useOverlayExpansion, usePageContext, useProps, useRuntime, useSdk };

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 import { AccountClient, AgentClient, ConversationClient, DataClient, FunctionsClient, KnowledgeClient, MetaClient, StorageClient } from '@proteos/sdk';
 import { ModalWidth, PageContext } from './protocol.js';
-export { AuthRefreshMessage, COMPONENT_OVERLAY_Z_INDEX, DataInvalidateMessage, Envelope, ErrorMessage, EscapePressedMessage, HostMessage, InitMessage, MESSAGE_SOURCE, ModalClosedMessage, ModalResultMessage, NavigateMessage, OpenCallMessage, OpenModalMessage, OpenPeekMessage, OverlayRect, OverlayRectMessage, OverlayStateMessage, ReadyMessage, ResizeMessage, RuntimeMessage, isHostMessage, isRuntimeMessage } from './protocol.js';
+export { AuthRefreshMessage, COMPONENT_OVERLAY_Z_INDEX, CloseAgentWindowMessage, DataInvalidateMessage, Envelope, ErrorMessage, EscapePressedMessage, HostMessage, InitMessage, MESSAGE_SOURCE, ModalClosedMessage, ModalResultMessage, NavigateMessage, OpenAgentWindowMessage, OpenCallMessage, OpenModalMessage, OpenPeekMessage, OverlayRect, OverlayRectMessage, OverlayStateMessage, ReadyMessage, ResizeMessage, RuntimeMessage, isHostMessage, isRuntimeMessage } from './protocol.js';
 
 /** Options for {@link RuntimeContextValue.navigate}. */
 interface NavigateOptions {
@@ -24,6 +24,27 @@ interface OpenModalOptions {
      *  padded body. */
     height?: number;
 }
+/** What {@link AgentWindowController.open} opens the host's agent window to. */
+interface OpenAgentWindowOptions {
+    /** Resume this session (its agent comes with it). */
+    sessionId?: string;
+    /** Start a fresh session with this agent. Ignored when `sessionId` is set,
+     *  and when the host surface pins its agent. Without it (and without a
+     *  session) the window's currently selected agent is used. */
+    agentKey?: string;
+    /** A message to send — into the resumed session, or as the first message
+     *  of the fresh one. */
+    prompt?: string;
+}
+/**
+ * The host's agent session window (the floating assistant), driven from a
+ * component. `open()` posts OPEN_AGENT_WINDOW, `close()` posts
+ * CLOSE_AGENT_WINDOW — closing minimizes; the session and its stream live on.
+ */
+interface AgentWindowController {
+    open: (options?: OpenAgentWindowOptions) => void;
+    close: () => void;
+}
 /**
  * Manual control over iframe overlay promotion. The runtime already detects
  * overlays automatically (anything portaled to the iframe's `document.body` —
@@ -102,6 +123,9 @@ interface RuntimeContextValue extends RuntimeValue {
     /** Open another component in a host-rendered modal; resolves with the value
      *  that component closed with (`undefined` if dismissed). */
     openModal: (componentSlug: string, props?: Record<string, unknown>, options?: OpenModalOptions) => Promise<unknown>;
+    /** Open / minimize the host's agent session window (posts OPEN_AGENT_WINDOW
+     *  / CLOSE_AGENT_WINDOW). */
+    agentWindow: AgentWindowController;
 }
 /**
  * Provides the runtime value + derived helpers to a component subtree. Mounted
@@ -159,6 +183,23 @@ declare function useNavigate(): (to: string, options?: NavigateOptions) => void;
  * `ConversationBriefReview`'s `onOpenCall` from `@proteos/ui`.
  */
 declare function useOpenCall(): (conversationBriefId: string) => void;
+/**
+ * Open or minimize the HOST's agent session window (the floating assistant)
+ * from a component — the iframe cannot render it itself.
+ *
+ * ```ts
+ * const agentWindow = useAgentWindow()
+ * agentWindow.open()                                   // just open it
+ * agentWindow.open({ sessionId })                      // resume a session
+ * agentWindow.open({ agentKey: 'sales-bot', prompt })  // fresh session, prompt sent
+ * agentWindow.close()                                  // minimize (session lives on)
+ * ```
+ *
+ * `sessionId` wins over `agentKey` (the session already has an agent); a
+ * `prompt` goes into whichever session the window lands on. Ignored on public
+ * pages, and by preview hosts.
+ */
+declare function useAgentWindow(): AgentWindowController;
 /** The API origin SDK calls resolve against (for building raw asset URLs). */
 declare function useApiBaseUrl(): string;
 /**
@@ -249,4 +290,4 @@ interface FillViewportOptions {
  */
 declare function useFillViewportHeight(options?: FillViewportOptions): number | null;
 
-export { type ComponentSdk, type FillViewportOptions, type HostLocation, type ModalHost, ModalWidth, type NavigateOptions, type OpenModalOptions, type OverlayController, PageContext, type RuntimeContextValue, RuntimeProvider, type RuntimeValue, useApiBaseUrl, useAuthToken, useComponentModal, useFillViewportHeight, useHostLocation, useModalHost, useNavigate, useOpenCall, useOverlayExpansion, usePageContext, useProps, useRuntime, useSdk };
+export { type AgentWindowController, type ComponentSdk, type FillViewportOptions, type HostLocation, type ModalHost, ModalWidth, type NavigateOptions, type OpenAgentWindowOptions, type OpenModalOptions, type OverlayController, PageContext, type RuntimeContextValue, RuntimeProvider, type RuntimeValue, useAgentWindow, useApiBaseUrl, useAuthToken, useComponentModal, useFillViewportHeight, useHostLocation, useModalHost, useNavigate, useOpenCall, useOverlayExpansion, usePageContext, useProps, useRuntime, useSdk };

package/dist/index.js

@@ -1,5 +1,5 @@
-import { MESSAGE_SOURCE, isHostMessage } from './chunk-HODSL6ER.js';
-export { COMPONENT_OVERLAY_Z_INDEX, MESSAGE_SOURCE, isHostMessage, isRuntimeMessage } from './chunk-HODSL6ER.js';
+import { MESSAGE_SOURCE, isHostMessage } from './chunk-NOCSMXCW.js';
+export { COMPONENT_OVERLAY_Z_INDEX, MESSAGE_SOURCE, isHostMessage, isRuntimeMessage } from './chunk-NOCSMXCW.js';
 import { createContext, useMemo, useContext, useCallback, useState, useEffect } from 'react';
 import { jsx } from 'react/jsx-runtime';
 
@@ -20,6 +20,24 @@ function openCall(conversationBriefId) {
   };
   window.parent?.postMessage(envelope, "*");
 }
+function openAgentWindow(options) {
+  const envelope = {
+    source: MESSAGE_SOURCE,
+    type: "OPEN_AGENT_WINDOW",
+    ...options?.sessionId !== void 0 ? { sessionId: options.sessionId } : {},
+    ...options?.agentKey !== void 0 ? { agentKey: options.agentKey } : {},
+    ...options?.prompt !== void 0 ? { prompt: options.prompt } : {}
+  };
+  window.parent?.postMessage(envelope, "*");
+}
+function closeAgentWindow() {
+  const envelope = {
+    source: MESSAGE_SOURCE,
+    type: "CLOSE_AGENT_WINDOW"
+  };
+  window.parent?.postMessage(envelope, "*");
+}
+var agentWindow = { open: openAgentWindow, close: closeAgentWindow };
 function navigate(to, options) {
   if (options?.peek) postOpenPeek(to);
   else postNavigate(to);
@@ -96,7 +114,7 @@ function postModalResult(requestId, result) {
 }
 function RuntimeProvider({ value, children }) {
   const ctx = useMemo(
-    () => ({ ...value, navigate, openCall, openModal }),
+    () => ({ ...value, navigate, openCall, openModal, agentWindow }),
     [value]
   );
   return /* @__PURE__ */ jsx(RuntimeContext.Provider, { value: ctx, children });
@@ -125,6 +143,9 @@ function useNavigate() {
 function useOpenCall() {
   return useRuntime().openCall;
 }
+function useAgentWindow() {
+  return useRuntime().agentWindow;
+}
 function useApiBaseUrl() {
   return useRuntime().apiBaseUrl;
 }
@@ -205,6 +226,6 @@ function useFillViewportHeight(options = {}) {
   return height;
 }
 
-export { RuntimeProvider, useApiBaseUrl, useAuthToken, useComponentModal, useFillViewportHeight, useHostLocation, useModalHost, useNavigate, useOpenCall, useOverlayExpansion, usePageContext, useProps, useRuntime, useSdk };
+export { RuntimeProvider, useAgentWindow, useApiBaseUrl, useAuthToken, useComponentModal, useFillViewportHeight, useHostLocation, useModalHost, useNavigate, useOpenCall, useOverlayExpansion, usePageContext, useProps, useRuntime, useSdk };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/context.tsx","../src/hooks.ts"],"names":["useMemo"],"mappings":"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","file":"index.js","sourcesContent":["import type {\n  AccountClient,\n  AgentClient,\n  ConversationClient,\n  DataClient,\n  FunctionsClient,\n  KnowledgeClient,\n  MetaClient,\n  StorageClient,\n} from '@proteos/sdk'\nimport { createContext, type ReactNode, useMemo } from 'react'\n\nimport {\n  type Envelope,\n  isHostMessage,\n  MESSAGE_SOURCE,\n  type ModalResultMessage,\n  type ModalWidth,\n  type NavigateMessage,\n  type OpenCallMessage,\n  type OpenModalMessage,\n  type OpenPeekMessage,\n  type PageContext,\n} from './protocol'\n\n/** Options for {@link RuntimeContextValue.navigate}. */\nexport interface NavigateOptions {\n  /** Open the target in a peek (slide-over) panel instead of full-page. */\n  peek?: boolean\n}\n\n/** Options for {@link RuntimeContextValue.openModal}. */\nexport interface OpenModalOptions {\n  /** Heading rendered in the modal chrome. */\n  title?: string\n  /** Panel width: `sm` 384px, `md` 512px, `lg` 672px (default), `xl` 896px. */\n  width?: ModalWidth\n  /** Height of the component's frame, in px. Pass it whenever you know it: the\n   *  modal then opens at its final size instead of growing once the component\n   *  has loaded. The frame is capped at the viewport, scrolls its own content,\n   *  and sits edge to edge in the panel — so the component owns its padding\n   *  (`ModalBody` / `ModalFooter` from `@proteos/ui` carry the standard one).\n   *  Leave it out and the frame grows with its content inside the host's\n   *  padded body. */\n  height?: number\n}\n\n/**\n * Manual control over iframe overlay promotion. The runtime already detects\n * overlays automatically (anything portaled to the iframe's `document.body` —\n * every `@proteos/ui` overlay qualifies), so components need this only for\n * custom portal targets, or to promote a frame *before* opening an overlay.\n * Calls are reference-counted: every `expand()` needs its `collapse()`.\n */\nexport interface OverlayController {\n  expand: () => void\n  collapse: () => void\n  isExpanded: () => boolean\n}\n\n/**\n * The authenticated `@proteos/sdk` clients the runtime injects. Same instances\n * the host app uses — pre-wired with a refreshing bearer token, so a component\n * never touches auth headers.\n */\nexport interface ComponentSdk {\n  account: AccountClient\n  agents: AgentClient\n  /**\n   * Conversations, messages, contacts, connections (conversation-service) —\n   * e.g. the DraftMessageComposer review surface. Plural per the platform's\n   * resource-naming rule; the web app's own `useSdk().conversation` predates\n   * it (documented asymmetry).\n   */\n  conversations: ConversationClient\n  data: DataClient\n  functions: FunctionsClient\n  knowledge: KnowledgeClient\n  meta: MetaClient\n  storage: StorageClient\n}\n\n/**\n * The raw runtime payload the shell hands a component at INIT. The shell builds\n * this; component authors read it through the hooks.\n */\nexport interface RuntimeValue {\n  /**\n   * The injected sdk clients. On an authenticated page these are the full,\n   * bearer-wired clients. On a PUBLIC page (`isPublic: true`) only\n   * `functions.actions.invokePublic` reaches the platform — every other\n   * client throws on use (there is no token, and the server rejects\n   * unauthenticated calls anyway).\n   */\n  sdk: ComponentSdk\n  /** Liquid-resolved props (a snapshot — not a live binding). */\n  props: Record<string, unknown>\n  /** Page context snapshot: the host record, entity, and URL params. */\n  pageCtx: PageContext\n  /** API origin SDK calls + asset URLs resolve against. */\n  apiBaseUrl: string\n  /** Current bearer token getter (escape hatch for raw fetches). Returns ''\n   *  on public pages. */\n  getToken: () => string\n  /** True when rendering on an unauthenticated public page. */\n  isPublic?: boolean\n  /** Org id, set in public mode (public API routes carry it in the path). */\n  orgId?: string\n  /** Set when this component is the content of a host component modal — the\n   *  correlation id it closes with. See `useModalHost()`. */\n  modalRequestId?: string\n  /** Overlay promotion controller, provided by the shell. Absent on older\n   *  shells / non-promoting hosts, in which case `useOverlayExpansion()`\n   *  no-ops. */\n  overlay?: OverlayController\n}\n\n/** Runtime value plus the derived helpers the hooks expose. */\nexport interface RuntimeContextValue extends RuntimeValue {\n  /** Navigate the host SPA to an in-app path (posts a NAVIGATE message), or\n   *  open it in a peek panel with `{ peek: true }` (posts OPEN_PEEK). */\n  navigate: (to: string, options?: NavigateOptions) => void\n  /** Ask the host to open a prepared call from a conversation brief (posts\n   *  OPEN_CALL): the host previews the brief and dials through its softphone. */\n  openCall: (conversationBriefId: string) => void\n  /** Open another component in a host-rendered modal; resolves with the value\n   *  that component closed with (`undefined` if dismissed). */\n  openModal: (\n    componentSlug: string,\n    props?: Record<string, unknown>,\n    options?: OpenModalOptions,\n  ) => Promise<unknown>\n}\n\nexport const RuntimeContext = createContext<RuntimeContextValue | null>(null)\n\n/** Post a NAVIGATE envelope to the host. The host only honours relative,\n *  in-app targets (it ignores absolute/external URLs). */\nfunction postNavigate(to: string): void {\n  const envelope: Envelope<NavigateMessage> = { source: MESSAGE_SOURCE, type: 'NAVIGATE', to }\n  window.parent?.postMessage(envelope, '*')\n}\n\n/** Post an OPEN_PEEK envelope to the host — open the in-app path in a peek\n *  panel. Same relative-path contract as {@link postNavigate}. */\nfunction postOpenPeek(to: string): void {\n  const envelope: Envelope<OpenPeekMessage> = { source: MESSAGE_SOURCE, type: 'OPEN_PEEK', to }\n  window.parent?.postMessage(envelope, '*')\n}\n\n/** Post OPEN_CALL — the host previews the conversation brief and owns the dial. */\nfunction openCall(conversationBriefId: string): void {\n  const envelope: Envelope<OpenCallMessage> = {\n    source: MESSAGE_SOURCE,\n    type: 'OPEN_CALL',\n    conversationBriefId,\n  }\n  window.parent?.postMessage(envelope, '*')\n}\n\n/** Navigate full-page (default) or into a peek panel (`{ peek: true }`). */\nfunction navigate(to: string, options?: NavigateOptions): void {\n  if (options?.peek) postOpenPeek(to)\n  else postNavigate(to)\n}\n\n// ── Component modals ────────────────────────────────────────────────────────\n// One module-level listener + a pending map, rather than a listener per call:\n// the SDK is an import-mapped singleton, so this is per-iframe state.\n\nconst pendingModals = new Map<string, (result: unknown) => void>()\nlet modalListenerAttached = false\n\nfunction ensureModalListener(): void {\n  if (modalListenerAttached) return\n  modalListenerAttached = true\n  window.addEventListener('message', (event: MessageEvent) => {\n    const data: unknown = event.data\n    if (!isHostMessage(data) || data.type !== 'MODAL_CLOSED') return\n    const resolve = pendingModals.get(data.requestId)\n    // An unknown requestId is someone else's modal (or a stale reply) — drop it.\n    if (!resolve) return\n    pendingModals.delete(data.requestId)\n    resolve(data.result)\n  })\n}\n\n// How long after a modal closed the opener still claims the focus the host\n// hands back. Past that, focus arriving on the frame is something else.\nconst FOCUS_RESTORE_WINDOW_MS = 1000\n\n/** Puts focus back on the control that opened a modal.\n *\n *  The host returns focus to this FRAME when its dialog closes, but not to the\n *  control inside it: the frame is inert while the dialog is up, which drops\n *  the focus it held, so it comes back on `<body>`. Only this side knows which\n *  control it was.\n *\n *  The reply (MODAL_CLOSED) arrives before the dialog has finished closing —\n *  the frame may still be inert then and refuse focus — so this waits for the\n *  frame to actually receive it. */\nfunction restoreFocus(opener: HTMLElement | null): void {\n  if (!opener?.isConnected) return\n  const isUnplaced = () =>\n    document.activeElement === null || document.activeElement === document.body\n  if (document.hasFocus() && isUnplaced()) {\n    opener.focus({ preventScroll: true })\n    return\n  }\n  const onFocus = () => {\n    stop()\n    // Something in here took focus in the meantime — leave it be.\n    if (opener.isConnected && isUnplaced()) opener.focus({ preventScroll: true })\n  }\n  const timer = window.setTimeout(stop, FOCUS_RESTORE_WINDOW_MS)\n  function stop(): void {\n    window.clearTimeout(timer)\n    window.removeEventListener('focus', onFocus)\n  }\n  window.addEventListener('focus', onFocus)\n}\n\nfunction newRequestId(): string {\n  if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {\n    return crypto.randomUUID()\n  }\n  return `modal_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`\n}\n\n/** Post OPEN_MODAL and resolve when the host answers MODAL_CLOSED. */\nfunction openModal(\n  componentSlug: string,\n  props?: Record<string, unknown>,\n  options?: OpenModalOptions,\n): Promise<unknown> {\n  ensureModalListener()\n  const requestId = newRequestId()\n  const envelope: Envelope<OpenModalMessage> = {\n    source: MESSAGE_SOURCE,\n    type: 'OPEN_MODAL',\n    requestId,\n    componentSlug,\n    ...(props !== undefined ? { props } : {}),\n    ...(options?.title !== undefined ? { title: options.title } : {}),\n    ...(options?.width !== undefined ? { width: options.width } : {}),\n    ...(options?.height !== undefined ? { height: options.height } : {}),\n  }\n  const opener = document.activeElement instanceof HTMLElement ? document.activeElement : null\n  return new Promise<unknown>((resolve) => {\n    pendingModals.set(requestId, (result) => {\n      restoreFocus(opener)\n      resolve(result)\n    })\n    window.parent?.postMessage(envelope, '*')\n  })\n}\n\n/** Post MODAL_RESULT — the component inside a host modal closing with a value. */\nexport function postModalResult(requestId: string, result?: unknown): void {\n  const envelope: Envelope<ModalResultMessage> = {\n    source: MESSAGE_SOURCE,\n    type: 'MODAL_RESULT',\n    requestId,\n    ...(result !== undefined ? { result } : {}),\n  }\n  window.parent?.postMessage(envelope, '*')\n}\n\n/**\n * Provides the runtime value + derived helpers to a component subtree. Mounted\n * by the component-runtime shell around the loaded component — authors never\n * render this themselves. Lives in `@proteos/component-sdk` (a shared,\n * import-mapped singleton) so the context the shell provides is the very same\n * context the component's hooks read, across the bundle boundary.\n */\nexport function RuntimeProvider({ value, children }: { value: RuntimeValue; children: ReactNode }) {\n  // The shell builds `value` once at INIT (a stable state object — clients,\n  // props and pageCtx are all set once), so memoizing on its identity recreates\n  // the context only when the runtime genuinely re-inits.\n  const ctx = useMemo<RuntimeContextValue>(\n    () => ({ ...value, navigate, openCall, openModal }),\n    [value],\n  )\n  return <RuntimeContext.Provider value={ctx}>{children}</RuntimeContext.Provider>\n}\n","import { useCallback, useContext, useEffect, useMemo, useState } from 'react'\n\nimport {\n  type ComponentSdk,\n  type NavigateOptions,\n  type OpenModalOptions,\n  type OverlayController,\n  postModalResult,\n  RuntimeContext,\n  type RuntimeContextValue,\n} from './context'\nimport type { PageContext } from './protocol'\n\n/**\n * Low-level escape hatch: the whole runtime context (sdk, props, pageCtx,\n * apiBaseUrl, getToken, navigate). Prefer the focused hooks below. Throws a\n * clear error if used outside the component runtime.\n */\nexport function useRuntime(): RuntimeContextValue {\n  const ctx = useContext(RuntimeContext)\n  if (!ctx) {\n    throw new Error(\n      '@proteos/component-sdk: hooks must run inside the Proteos component runtime. ' +\n        'This usually means the component is rendered outside its iframe, or a ' +\n        'second copy of @proteos/component-sdk was bundled instead of using the ' +\n        'runtime-provided one (keep it external).',\n    )\n  }\n  return ctx\n}\n\n/** The authenticated SDK clients (account / agents / conversations / data / functions / knowledge / meta / storage). */\nexport function useSdk(): ComponentSdk {\n  return useRuntime().sdk\n}\n\n/** The component's Liquid-resolved props (a snapshot, not a live binding). */\nexport function useProps<T extends Record<string, unknown> = Record<string, unknown>>(): T {\n  return useRuntime().props as T\n}\n\n/**\n * The full page context: host `record`, `entity`, and URL `params`. The\n * `record` is a snapshot taken at mount (`undefined` on record-less platform\n * pages) — fetch via `useSdk().data` for anything that must stay fresh.\n */\nexport function usePageContext(): PageContext {\n  return useRuntime().pageCtx\n}\n\n/**\n * Navigate the host SPA to an in-app path, e.g.\n * `navigate('/org/acme/record/task/123')`. The host ignores absolute/external\n * URLs. Build org/app-prefixed paths with `useHostLocation().appBasePath`.\n *\n * Pass `{ peek: true }` to open the path in a peek (slide-over) panel instead\n * of full-page navigation — e.g. `navigate(path, { peek: true })`. The host\n * peeks what it can (today: platform pages) and falls back to full navigation.\n */\nexport function useNavigate(): (to: string, options?: NavigateOptions) => void {\n  return useRuntime().navigate\n}\n\n/**\n * Open a prepared call from a conversation brief id: the HOST previews the brief and\n * places the call through its softphone (an iframe cannot dial). Pair it with\n * `ConversationBriefReview`'s `onOpenCall` from `@proteos/ui`.\n */\nexport function useOpenCall(): (conversationBriefId: string) => void {\n  return useRuntime().openCall\n}\n\n/** The API origin SDK calls resolve against (for building raw asset URLs). */\nexport function useApiBaseUrl(): string {\n  return useRuntime().apiBaseUrl\n}\n\nconst NOOP_OVERLAY: OverlayController = {\n  expand: () => {\n    console.warn(\n      '@proteos/component-sdk: useOverlayExpansion() has no effect — this runtime ' +\n        'does not support overlay promotion (older shell or non-promoting host).',\n    )\n  },\n  collapse: () => {},\n  isExpanded: () => false,\n}\n\n/**\n * Manual overlay promotion — lifts the whole component iframe over the rest of\n * the page so an overlay can escape the frame's box.\n *\n * You rarely need this. Every `@proteos/ui` overlay (Modal, Popover, Menu,\n * Select, Tooltip, …) portals to the iframe document's `<body>`, which the\n * runtime watches — those promote automatically, with no code. Reach for this\n * hook only when you portal somewhere else yourself, or want the frame lifted\n * *before* the overlay mounts. Reference-counted: pair every `expand()` with a\n * `collapse()`.\n */\nexport function useOverlayExpansion(): OverlayController {\n  return useRuntime().overlay ?? NOOP_OVERLAY\n}\n\n/**\n * Open ANOTHER component in a modal the host renders above everything — the\n * cross-component flow (a picker, a wizard step, a confirm dialog shared by\n * several components). Resolves with whatever that component closed with, or\n * `undefined` if the user dismissed it.\n *\n * ```ts\n * const openModal = useComponentModal()\n * const picked = await openModal(\n *   'contact-picker',\n *   { entity: 'contact' },\n *   { title: 'Pick a contact', width: 'md', height: 480 },\n * )\n * ```\n *\n * Pass `height` whenever you know it — the modal opens at its final size\n * instead of growing after the component loads (see {@link OpenModalOptions}).\n * One modal per component at a time: a second call while the first is still\n * open resolves `undefined` straight away.\n *\n * String props are Liquid-rendered by the host against this component's page\n * scope, like the props of a page-placed component.\n *\n * For an overlay that is part of THIS component, just render a `<Modal>` from\n * `@proteos/ui` — it promotes automatically.\n */\nexport function useComponentModal(): (\n  componentSlug: string,\n  props?: Record<string, unknown>,\n  options?: OpenModalOptions,\n) => Promise<unknown> {\n  return useRuntime().openModal\n}\n\nexport interface ModalHost {\n  /** True when this component is rendered as the content of a host modal. */\n  isInModal: boolean\n  /** Close the host modal, resolving the opener's promise with `result`.\n   *  No-op outside a modal. */\n  close: (result?: unknown) => void\n}\n\n/**\n * For a component that is being shown INSIDE a host modal (opened by another\n * component's `useComponentModal()`): close it and hand a value back.\n * `isInModal` is false on ordinary page-hosted mounts, so one component can\n * serve both roles.\n */\nexport function useModalHost(): ModalHost {\n  const requestId = useRuntime().modalRequestId\n  const close = useCallback(\n    (result?: unknown) => {\n      if (requestId === undefined) return\n      postModalResult(requestId, result)\n    },\n    [requestId],\n  )\n  return useMemo(() => ({ isInModal: requestId !== undefined, close }), [requestId, close])\n}\n\n/**\n * A getter for the current bearer token. Returns a function (not the token)\n * because the token is refreshed in place — read it at call time for a raw\n * `fetch`. Most components never need this; prefer `useSdk()`.\n */\nexport function useAuthToken(): () => string {\n  return useRuntime().getToken\n}\n\nexport interface HostLocation {\n  /** The host tab's pathname (same-origin read), or null if unavailable. */\n  pathname: string | null\n  /** The org id parsed from `/org/<orgId>/…`, or null. */\n  orgId: string | null\n  /** The `/org/<orgId>/app/<appId>` prefix, or null when not on an app page. */\n  appBasePath: string | null\n}\n\nfunction readHostLocation(): HostLocation {\n  const empty: HostLocation = { pathname: null, orgId: null, appBasePath: null }\n  try {\n    const parentWindow = window.parent\n    if (!parentWindow || parentWindow === window) return empty\n    const pathname = parentWindow.location.pathname\n    const appMatch = pathname.match(/^\\/org\\/[^/]+\\/app\\/[^/]+/)\n    const orgMatch = pathname.match(/^\\/org\\/([^/]+)\\//)\n    return {\n      pathname,\n      orgId: orgMatch ? (orgMatch[1] ?? null) : null,\n      appBasePath: appMatch ? appMatch[0] : null,\n    }\n  } catch {\n    // Cross-origin (untrusted-component future) or detached — fall back to null.\n    return empty\n  }\n}\n\n/**\n * Read the host tab's location (same-origin) — the org id and `/org/.../app/...`\n * prefix needed to build navigation targets on platform pages. Read once on\n * mount (the iframe re-inits when the host route changes).\n */\nexport function useHostLocation(): HostLocation {\n  const [loc] = useState(readHostLocation)\n  return loc\n}\n\nexport interface FillViewportOptions {\n  /** Gap left below the component (px). Default 24. */\n  bottomMargin?: number\n  /** Floor for the computed height (px). Default 320. */\n  minHeight?: number\n}\n\n/**\n * Compute a \"fill the rest of the viewport\" height for full-bleed layouts\n * (boards, canvases). The runtime auto-sizes the iframe to its content, so a\n * component can't use its own `vh` units (circular). The iframe is same-origin,\n * so this measures the parent viewport minus the iframe's offset instead.\n * Returns `null` when it can't measure (fall back to natural height).\n */\nexport function useFillViewportHeight(options: FillViewportOptions = {}): number | null {\n  const { bottomMargin = 24, minHeight = 320 } = options\n  const [height, setHeight] = useState<number | null>(null)\n\n  useEffect(() => {\n    function compute(): void {\n      try {\n        const frame = window.frameElement\n        const parentWindow = window.parent\n        if (!frame || !parentWindow || parentWindow === window) return\n        const available =\n          parentWindow.innerHeight - frame.getBoundingClientRect().top - bottomMargin\n        setHeight(Math.max(available, minHeight))\n      } catch {\n        setHeight(null) // cross-origin or detached — fall back to natural height\n      }\n    }\n    compute()\n    try {\n      window.parent.addEventListener('resize', compute)\n      return () => window.parent.removeEventListener('resize', compute)\n    } catch {\n      return\n    }\n  }, [bottomMargin, minHeight])\n\n  return height\n}\n"]}
+{"version":3,"sources":["../src/context.tsx","../src/hooks.ts"],"names":["useMemo"],"mappings":"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","file":"index.js","sourcesContent":["import type {\n  AccountClient,\n  AgentClient,\n  ConversationClient,\n  DataClient,\n  FunctionsClient,\n  KnowledgeClient,\n  MetaClient,\n  StorageClient,\n} from '@proteos/sdk'\nimport { createContext, type ReactNode, useMemo } from 'react'\n\nimport {\n  type CloseAgentWindowMessage,\n  type Envelope,\n  isHostMessage,\n  MESSAGE_SOURCE,\n  type ModalResultMessage,\n  type ModalWidth,\n  type NavigateMessage,\n  type OpenAgentWindowMessage,\n  type OpenCallMessage,\n  type OpenModalMessage,\n  type OpenPeekMessage,\n  type PageContext,\n} from './protocol'\n\n/** Options for {@link RuntimeContextValue.navigate}. */\nexport interface NavigateOptions {\n  /** Open the target in a peek (slide-over) panel instead of full-page. */\n  peek?: boolean\n}\n\n/** Options for {@link RuntimeContextValue.openModal}. */\nexport interface OpenModalOptions {\n  /** Heading rendered in the modal chrome. */\n  title?: string\n  /** Panel width: `sm` 384px, `md` 512px, `lg` 672px (default), `xl` 896px. */\n  width?: ModalWidth\n  /** Height of the component's frame, in px. Pass it whenever you know it: the\n   *  modal then opens at its final size instead of growing once the component\n   *  has loaded. The frame is capped at the viewport, scrolls its own content,\n   *  and sits edge to edge in the panel — so the component owns its padding\n   *  (`ModalBody` / `ModalFooter` from `@proteos/ui` carry the standard one).\n   *  Leave it out and the frame grows with its content inside the host's\n   *  padded body. */\n  height?: number\n}\n\n/** What {@link AgentWindowController.open} opens the host's agent window to. */\nexport interface OpenAgentWindowOptions {\n  /** Resume this session (its agent comes with it). */\n  sessionId?: string\n  /** Start a fresh session with this agent. Ignored when `sessionId` is set,\n   *  and when the host surface pins its agent. Without it (and without a\n   *  session) the window's currently selected agent is used. */\n  agentKey?: string\n  /** A message to send — into the resumed session, or as the first message\n   *  of the fresh one. */\n  prompt?: string\n}\n\n/**\n * The host's agent session window (the floating assistant), driven from a\n * component. `open()` posts OPEN_AGENT_WINDOW, `close()` posts\n * CLOSE_AGENT_WINDOW — closing minimizes; the session and its stream live on.\n */\nexport interface AgentWindowController {\n  open: (options?: OpenAgentWindowOptions) => void\n  close: () => void\n}\n\n/**\n * Manual control over iframe overlay promotion. The runtime already detects\n * overlays automatically (anything portaled to the iframe's `document.body` —\n * every `@proteos/ui` overlay qualifies), so components need this only for\n * custom portal targets, or to promote a frame *before* opening an overlay.\n * Calls are reference-counted: every `expand()` needs its `collapse()`.\n */\nexport interface OverlayController {\n  expand: () => void\n  collapse: () => void\n  isExpanded: () => boolean\n}\n\n/**\n * The authenticated `@proteos/sdk` clients the runtime injects. Same instances\n * the host app uses — pre-wired with a refreshing bearer token, so a component\n * never touches auth headers.\n */\nexport interface ComponentSdk {\n  account: AccountClient\n  agents: AgentClient\n  /**\n   * Conversations, messages, contacts, connections (conversation-service) —\n   * e.g. the DraftMessageComposer review surface. Plural per the platform's\n   * resource-naming rule; the web app's own `useSdk().conversation` predates\n   * it (documented asymmetry).\n   */\n  conversations: ConversationClient\n  data: DataClient\n  functions: FunctionsClient\n  knowledge: KnowledgeClient\n  meta: MetaClient\n  storage: StorageClient\n}\n\n/**\n * The raw runtime payload the shell hands a component at INIT. The shell builds\n * this; component authors read it through the hooks.\n */\nexport interface RuntimeValue {\n  /**\n   * The injected sdk clients. On an authenticated page these are the full,\n   * bearer-wired clients. On a PUBLIC page (`isPublic: true`) only\n   * `functions.actions.invokePublic` reaches the platform — every other\n   * client throws on use (there is no token, and the server rejects\n   * unauthenticated calls anyway).\n   */\n  sdk: ComponentSdk\n  /** Liquid-resolved props (a snapshot — not a live binding). */\n  props: Record<string, unknown>\n  /** Page context snapshot: the host record, entity, and URL params. */\n  pageCtx: PageContext\n  /** API origin SDK calls + asset URLs resolve against. */\n  apiBaseUrl: string\n  /** Current bearer token getter (escape hatch for raw fetches). Returns ''\n   *  on public pages. */\n  getToken: () => string\n  /** True when rendering on an unauthenticated public page. */\n  isPublic?: boolean\n  /** Org id, set in public mode (public API routes carry it in the path). */\n  orgId?: string\n  /** Set when this component is the content of a host component modal — the\n   *  correlation id it closes with. See `useModalHost()`. */\n  modalRequestId?: string\n  /** Overlay promotion controller, provided by the shell. Absent on older\n   *  shells / non-promoting hosts, in which case `useOverlayExpansion()`\n   *  no-ops. */\n  overlay?: OverlayController\n}\n\n/** Runtime value plus the derived helpers the hooks expose. */\nexport interface RuntimeContextValue extends RuntimeValue {\n  /** Navigate the host SPA to an in-app path (posts a NAVIGATE message), or\n   *  open it in a peek panel with `{ peek: true }` (posts OPEN_PEEK). */\n  navigate: (to: string, options?: NavigateOptions) => void\n  /** Ask the host to open a prepared call from a conversation brief (posts\n   *  OPEN_CALL): the host previews the brief and dials through its softphone. */\n  openCall: (conversationBriefId: string) => void\n  /** Open another component in a host-rendered modal; resolves with the value\n   *  that component closed with (`undefined` if dismissed). */\n  openModal: (\n    componentSlug: string,\n    props?: Record<string, unknown>,\n    options?: OpenModalOptions,\n  ) => Promise<unknown>\n  /** Open / minimize the host's agent session window (posts OPEN_AGENT_WINDOW\n   *  / CLOSE_AGENT_WINDOW). */\n  agentWindow: AgentWindowController\n}\n\nexport const RuntimeContext = createContext<RuntimeContextValue | null>(null)\n\n/** Post a NAVIGATE envelope to the host. The host only honours relative,\n *  in-app targets (it ignores absolute/external URLs). */\nfunction postNavigate(to: string): void {\n  const envelope: Envelope<NavigateMessage> = { source: MESSAGE_SOURCE, type: 'NAVIGATE', to }\n  window.parent?.postMessage(envelope, '*')\n}\n\n/** Post an OPEN_PEEK envelope to the host — open the in-app path in a peek\n *  panel. Same relative-path contract as {@link postNavigate}. */\nfunction postOpenPeek(to: string): void {\n  const envelope: Envelope<OpenPeekMessage> = { source: MESSAGE_SOURCE, type: 'OPEN_PEEK', to }\n  window.parent?.postMessage(envelope, '*')\n}\n\n/** Post OPEN_CALL — the host previews the conversation brief and owns the dial. */\nfunction openCall(conversationBriefId: string): void {\n  const envelope: Envelope<OpenCallMessage> = {\n    source: MESSAGE_SOURCE,\n    type: 'OPEN_CALL',\n    conversationBriefId,\n  }\n  window.parent?.postMessage(envelope, '*')\n}\n\n/** Post OPEN_AGENT_WINDOW — only the fields that were given ride the wire. */\nfunction openAgentWindow(options?: OpenAgentWindowOptions): void {\n  const envelope: Envelope<OpenAgentWindowMessage> = {\n    source: MESSAGE_SOURCE,\n    type: 'OPEN_AGENT_WINDOW',\n    ...(options?.sessionId !== undefined ? { sessionId: options.sessionId } : {}),\n    ...(options?.agentKey !== undefined ? { agentKey: options.agentKey } : {}),\n    ...(options?.prompt !== undefined ? { prompt: options.prompt } : {}),\n  }\n  window.parent?.postMessage(envelope, '*')\n}\n\n/** Post CLOSE_AGENT_WINDOW — minimize the host's agent window. */\nfunction closeAgentWindow(): void {\n  const envelope: Envelope<CloseAgentWindowMessage> = {\n    source: MESSAGE_SOURCE,\n    type: 'CLOSE_AGENT_WINDOW',\n  }\n  window.parent?.postMessage(envelope, '*')\n}\n\nconst agentWindow: AgentWindowController = { open: openAgentWindow, close: closeAgentWindow }\n\n/** Navigate full-page (default) or into a peek panel (`{ peek: true }`). */\nfunction navigate(to: string, options?: NavigateOptions): void {\n  if (options?.peek) postOpenPeek(to)\n  else postNavigate(to)\n}\n\n// ── Component modals ────────────────────────────────────────────────────────\n// One module-level listener + a pending map, rather than a listener per call:\n// the SDK is an import-mapped singleton, so this is per-iframe state.\n\nconst pendingModals = new Map<string, (result: unknown) => void>()\nlet modalListenerAttached = false\n\nfunction ensureModalListener(): void {\n  if (modalListenerAttached) return\n  modalListenerAttached = true\n  window.addEventListener('message', (event: MessageEvent) => {\n    const data: unknown = event.data\n    if (!isHostMessage(data) || data.type !== 'MODAL_CLOSED') return\n    const resolve = pendingModals.get(data.requestId)\n    // An unknown requestId is someone else's modal (or a stale reply) — drop it.\n    if (!resolve) return\n    pendingModals.delete(data.requestId)\n    resolve(data.result)\n  })\n}\n\n// How long after a modal closed the opener still claims the focus the host\n// hands back. Past that, focus arriving on the frame is something else.\nconst FOCUS_RESTORE_WINDOW_MS = 1000\n\n/** Puts focus back on the control that opened a modal.\n *\n *  The host returns focus to this FRAME when its dialog closes, but not to the\n *  control inside it: the frame is inert while the dialog is up, which drops\n *  the focus it held, so it comes back on `<body>`. Only this side knows which\n *  control it was.\n *\n *  The reply (MODAL_CLOSED) arrives before the dialog has finished closing —\n *  the frame may still be inert then and refuse focus — so this waits for the\n *  frame to actually receive it. */\nfunction restoreFocus(opener: HTMLElement | null): void {\n  if (!opener?.isConnected) return\n  const isUnplaced = () =>\n    document.activeElement === null || document.activeElement === document.body\n  if (document.hasFocus() && isUnplaced()) {\n    opener.focus({ preventScroll: true })\n    return\n  }\n  const onFocus = () => {\n    stop()\n    // Something in here took focus in the meantime — leave it be.\n    if (opener.isConnected && isUnplaced()) opener.focus({ preventScroll: true })\n  }\n  const timer = window.setTimeout(stop, FOCUS_RESTORE_WINDOW_MS)\n  function stop(): void {\n    window.clearTimeout(timer)\n    window.removeEventListener('focus', onFocus)\n  }\n  window.addEventListener('focus', onFocus)\n}\n\nfunction newRequestId(): string {\n  if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {\n    return crypto.randomUUID()\n  }\n  return `modal_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`\n}\n\n/** Post OPEN_MODAL and resolve when the host answers MODAL_CLOSED. */\nfunction openModal(\n  componentSlug: string,\n  props?: Record<string, unknown>,\n  options?: OpenModalOptions,\n): Promise<unknown> {\n  ensureModalListener()\n  const requestId = newRequestId()\n  const envelope: Envelope<OpenModalMessage> = {\n    source: MESSAGE_SOURCE,\n    type: 'OPEN_MODAL',\n    requestId,\n    componentSlug,\n    ...(props !== undefined ? { props } : {}),\n    ...(options?.title !== undefined ? { title: options.title } : {}),\n    ...(options?.width !== undefined ? { width: options.width } : {}),\n    ...(options?.height !== undefined ? { height: options.height } : {}),\n  }\n  const opener = document.activeElement instanceof HTMLElement ? document.activeElement : null\n  return new Promise<unknown>((resolve) => {\n    pendingModals.set(requestId, (result) => {\n      restoreFocus(opener)\n      resolve(result)\n    })\n    window.parent?.postMessage(envelope, '*')\n  })\n}\n\n/** Post MODAL_RESULT — the component inside a host modal closing with a value. */\nexport function postModalResult(requestId: string, result?: unknown): void {\n  const envelope: Envelope<ModalResultMessage> = {\n    source: MESSAGE_SOURCE,\n    type: 'MODAL_RESULT',\n    requestId,\n    ...(result !== undefined ? { result } : {}),\n  }\n  window.parent?.postMessage(envelope, '*')\n}\n\n/**\n * Provides the runtime value + derived helpers to a component subtree. Mounted\n * by the component-runtime shell around the loaded component — authors never\n * render this themselves. Lives in `@proteos/component-sdk` (a shared,\n * import-mapped singleton) so the context the shell provides is the very same\n * context the component's hooks read, across the bundle boundary.\n */\nexport function RuntimeProvider({ value, children }: { value: RuntimeValue; children: ReactNode }) {\n  // The shell builds `value` once at INIT (a stable state object — clients,\n  // props and pageCtx are all set once), so memoizing on its identity recreates\n  // the context only when the runtime genuinely re-inits.\n  const ctx = useMemo<RuntimeContextValue>(\n    () => ({ ...value, navigate, openCall, openModal, agentWindow }),\n    [value],\n  )\n  return <RuntimeContext.Provider value={ctx}>{children}</RuntimeContext.Provider>\n}\n","import { useCallback, useContext, useEffect, useMemo, useState } from 'react'\n\nimport {\n  type AgentWindowController,\n  type ComponentSdk,\n  type NavigateOptions,\n  type OpenModalOptions,\n  type OverlayController,\n  postModalResult,\n  RuntimeContext,\n  type RuntimeContextValue,\n} from './context'\nimport type { PageContext } from './protocol'\n\n/**\n * Low-level escape hatch: the whole runtime context (sdk, props, pageCtx,\n * apiBaseUrl, getToken, navigate). Prefer the focused hooks below. Throws a\n * clear error if used outside the component runtime.\n */\nexport function useRuntime(): RuntimeContextValue {\n  const ctx = useContext(RuntimeContext)\n  if (!ctx) {\n    throw new Error(\n      '@proteos/component-sdk: hooks must run inside the Proteos component runtime. ' +\n        'This usually means the component is rendered outside its iframe, or a ' +\n        'second copy of @proteos/component-sdk was bundled instead of using the ' +\n        'runtime-provided one (keep it external).',\n    )\n  }\n  return ctx\n}\n\n/** The authenticated SDK clients (account / agents / conversations / data / functions / knowledge / meta / storage). */\nexport function useSdk(): ComponentSdk {\n  return useRuntime().sdk\n}\n\n/** The component's Liquid-resolved props (a snapshot, not a live binding). */\nexport function useProps<T extends Record<string, unknown> = Record<string, unknown>>(): T {\n  return useRuntime().props as T\n}\n\n/**\n * The full page context: host `record`, `entity`, and URL `params`. The\n * `record` is a snapshot taken at mount (`undefined` on record-less platform\n * pages) — fetch via `useSdk().data` for anything that must stay fresh.\n */\nexport function usePageContext(): PageContext {\n  return useRuntime().pageCtx\n}\n\n/**\n * Navigate the host SPA to an in-app path, e.g.\n * `navigate('/org/acme/record/task/123')`. The host ignores absolute/external\n * URLs. Build org/app-prefixed paths with `useHostLocation().appBasePath`.\n *\n * Pass `{ peek: true }` to open the path in a peek (slide-over) panel instead\n * of full-page navigation — e.g. `navigate(path, { peek: true })`. The host\n * peeks what it can (today: platform pages) and falls back to full navigation.\n */\nexport function useNavigate(): (to: string, options?: NavigateOptions) => void {\n  return useRuntime().navigate\n}\n\n/**\n * Open a prepared call from a conversation brief id: the HOST previews the brief and\n * places the call through its softphone (an iframe cannot dial). Pair it with\n * `ConversationBriefReview`'s `onOpenCall` from `@proteos/ui`.\n */\nexport function useOpenCall(): (conversationBriefId: string) => void {\n  return useRuntime().openCall\n}\n\n/**\n * Open or minimize the HOST's agent session window (the floating assistant)\n * from a component — the iframe cannot render it itself.\n *\n * ```ts\n * const agentWindow = useAgentWindow()\n * agentWindow.open()                                   // just open it\n * agentWindow.open({ sessionId })                      // resume a session\n * agentWindow.open({ agentKey: 'sales-bot', prompt })  // fresh session, prompt sent\n * agentWindow.close()                                  // minimize (session lives on)\n * ```\n *\n * `sessionId` wins over `agentKey` (the session already has an agent); a\n * `prompt` goes into whichever session the window lands on. Ignored on public\n * pages, and by preview hosts.\n */\nexport function useAgentWindow(): AgentWindowController {\n  return useRuntime().agentWindow\n}\n\n/** The API origin SDK calls resolve against (for building raw asset URLs). */\nexport function useApiBaseUrl(): string {\n  return useRuntime().apiBaseUrl\n}\n\nconst NOOP_OVERLAY: OverlayController = {\n  expand: () => {\n    console.warn(\n      '@proteos/component-sdk: useOverlayExpansion() has no effect — this runtime ' +\n        'does not support overlay promotion (older shell or non-promoting host).',\n    )\n  },\n  collapse: () => {},\n  isExpanded: () => false,\n}\n\n/**\n * Manual overlay promotion — lifts the whole component iframe over the rest of\n * the page so an overlay can escape the frame's box.\n *\n * You rarely need this. Every `@proteos/ui` overlay (Modal, Popover, Menu,\n * Select, Tooltip, …) portals to the iframe document's `<body>`, which the\n * runtime watches — those promote automatically, with no code. Reach for this\n * hook only when you portal somewhere else yourself, or want the frame lifted\n * *before* the overlay mounts. Reference-counted: pair every `expand()` with a\n * `collapse()`.\n */\nexport function useOverlayExpansion(): OverlayController {\n  return useRuntime().overlay ?? NOOP_OVERLAY\n}\n\n/**\n * Open ANOTHER component in a modal the host renders above everything — the\n * cross-component flow (a picker, a wizard step, a confirm dialog shared by\n * several components). Resolves with whatever that component closed with, or\n * `undefined` if the user dismissed it.\n *\n * ```ts\n * const openModal = useComponentModal()\n * const picked = await openModal(\n *   'contact-picker',\n *   { entity: 'contact' },\n *   { title: 'Pick a contact', width: 'md', height: 480 },\n * )\n * ```\n *\n * Pass `height` whenever you know it — the modal opens at its final size\n * instead of growing after the component loads (see {@link OpenModalOptions}).\n * One modal per component at a time: a second call while the first is still\n * open resolves `undefined` straight away.\n *\n * String props are Liquid-rendered by the host against this component's page\n * scope, like the props of a page-placed component.\n *\n * For an overlay that is part of THIS component, just render a `<Modal>` from\n * `@proteos/ui` — it promotes automatically.\n */\nexport function useComponentModal(): (\n  componentSlug: string,\n  props?: Record<string, unknown>,\n  options?: OpenModalOptions,\n) => Promise<unknown> {\n  return useRuntime().openModal\n}\n\nexport interface ModalHost {\n  /** True when this component is rendered as the content of a host modal. */\n  isInModal: boolean\n  /** Close the host modal, resolving the opener's promise with `result`.\n   *  No-op outside a modal. */\n  close: (result?: unknown) => void\n}\n\n/**\n * For a component that is being shown INSIDE a host modal (opened by another\n * component's `useComponentModal()`): close it and hand a value back.\n * `isInModal` is false on ordinary page-hosted mounts, so one component can\n * serve both roles.\n */\nexport function useModalHost(): ModalHost {\n  const requestId = useRuntime().modalRequestId\n  const close = useCallback(\n    (result?: unknown) => {\n      if (requestId === undefined) return\n      postModalResult(requestId, result)\n    },\n    [requestId],\n  )\n  return useMemo(() => ({ isInModal: requestId !== undefined, close }), [requestId, close])\n}\n\n/**\n * A getter for the current bearer token. Returns a function (not the token)\n * because the token is refreshed in place — read it at call time for a raw\n * `fetch`. Most components never need this; prefer `useSdk()`.\n */\nexport function useAuthToken(): () => string {\n  return useRuntime().getToken\n}\n\nexport interface HostLocation {\n  /** The host tab's pathname (same-origin read), or null if unavailable. */\n  pathname: string | null\n  /** The org id parsed from `/org/<orgId>/…`, or null. */\n  orgId: string | null\n  /** The `/org/<orgId>/app/<appId>` prefix, or null when not on an app page. */\n  appBasePath: string | null\n}\n\nfunction readHostLocation(): HostLocation {\n  const empty: HostLocation = { pathname: null, orgId: null, appBasePath: null }\n  try {\n    const parentWindow = window.parent\n    if (!parentWindow || parentWindow === window) return empty\n    const pathname = parentWindow.location.pathname\n    const appMatch = pathname.match(/^\\/org\\/[^/]+\\/app\\/[^/]+/)\n    const orgMatch = pathname.match(/^\\/org\\/([^/]+)\\//)\n    return {\n      pathname,\n      orgId: orgMatch ? (orgMatch[1] ?? null) : null,\n      appBasePath: appMatch ? appMatch[0] : null,\n    }\n  } catch {\n    // Cross-origin (untrusted-component future) or detached — fall back to null.\n    return empty\n  }\n}\n\n/**\n * Read the host tab's location (same-origin) — the org id and `/org/.../app/...`\n * prefix needed to build navigation targets on platform pages. Read once on\n * mount (the iframe re-inits when the host route changes).\n */\nexport function useHostLocation(): HostLocation {\n  const [loc] = useState(readHostLocation)\n  return loc\n}\n\nexport interface FillViewportOptions {\n  /** Gap left below the component (px). Default 24. */\n  bottomMargin?: number\n  /** Floor for the computed height (px). Default 320. */\n  minHeight?: number\n}\n\n/**\n * Compute a \"fill the rest of the viewport\" height for full-bleed layouts\n * (boards, canvases). The runtime auto-sizes the iframe to its content, so a\n * component can't use its own `vh` units (circular). The iframe is same-origin,\n * so this measures the parent viewport minus the iframe's offset instead.\n * Returns `null` when it can't measure (fall back to natural height).\n */\nexport function useFillViewportHeight(options: FillViewportOptions = {}): number | null {\n  const { bottomMargin = 24, minHeight = 320 } = options\n  const [height, setHeight] = useState<number | null>(null)\n\n  useEffect(() => {\n    function compute(): void {\n      try {\n        const frame = window.frameElement\n        const parentWindow = window.parent\n        if (!frame || !parentWindow || parentWindow === window) return\n        const available =\n          parentWindow.innerHeight - frame.getBoundingClientRect().top - bottomMargin\n        setHeight(Math.max(available, minHeight))\n      } catch {\n        setHeight(null) // cross-origin or detached — fall back to natural height\n      }\n    }\n    compute()\n    try {\n      window.parent.addEventListener('resize', compute)\n      return () => window.parent.removeEventListener('resize', compute)\n    } catch {\n      return\n    }\n  }, [bottomMargin, minHeight])\n\n  return height\n}\n"]}

package/dist/protocol.cjs

@@ -1,24 +1,24 @@
 'use strict';
 
-var chunk3VUWWDED_cjs = require('./chunk-3VUWWDED.cjs');
+var chunkHD5ADY7F_cjs = require('./chunk-HD5ADY7F.cjs');
 
 
 
 Object.defineProperty(exports, "COMPONENT_OVERLAY_Z_INDEX", {
   enumerable: true,
-  get: function () { return chunk3VUWWDED_cjs.COMPONENT_OVERLAY_Z_INDEX; }
+  get: function () { return chunkHD5ADY7F_cjs.COMPONENT_OVERLAY_Z_INDEX; }
 });
 Object.defineProperty(exports, "MESSAGE_SOURCE", {
   enumerable: true,
-  get: function () { return chunk3VUWWDED_cjs.MESSAGE_SOURCE; }
+  get: function () { return chunkHD5ADY7F_cjs.MESSAGE_SOURCE; }
 });
 Object.defineProperty(exports, "isHostMessage", {
   enumerable: true,
-  get: function () { return chunk3VUWWDED_cjs.isHostMessage; }
+  get: function () { return chunkHD5ADY7F_cjs.isHostMessage; }
 });
 Object.defineProperty(exports, "isRuntimeMessage", {
   enumerable: true,
-  get: function () { return chunk3VUWWDED_cjs.isRuntimeMessage; }
+  get: function () { return chunkHD5ADY7F_cjs.isRuntimeMessage; }
 });
 //# sourceMappingURL=protocol.cjs.map
 //# sourceMappingURL=protocol.cjs.map

package/dist/protocol.d.cts

@@ -190,16 +190,36 @@ interface ModalResultMessage {
     requestId: string;
     result?: unknown;
 }
+/** Ask the host to open its agent session window (the floating assistant).
+ *
+ *  - `sessionId` set: the window resumes THAT session (its agent is read from
+ *    the session). A `prompt` is sent into it.
+ *  - no `sessionId`: a fresh session with `agentKey` (or the agent currently
+ *    selected in the window); a `prompt` is sent as its first message. With
+ *    neither field the window just opens as it is.
+ *
+ *  Ignored on public pages (there is no signed-in user to run an agent as). */
+interface OpenAgentWindowMessage {
+    type: 'OPEN_AGENT_WINDOW';
+    sessionId?: string;
+    agentKey?: string;
+    prompt?: string;
+}
+/** Ask the host to minimize its agent session window. The active session and
+ *  its stream stay alive — reopening resumes it. */
+interface CloseAgentWindowMessage {
+    type: 'CLOSE_AGENT_WINDOW';
+}
 interface ErrorMessage {
     type: 'ERROR';
     message: string;
     stack?: string;
 }
-type RuntimeMessage = ReadyMessage | ResizeMessage | NavigateMessage | OpenPeekMessage | OpenCallMessage | OverlayStateMessage | OpenModalMessage | ModalResultMessage | EscapePressedMessage | ErrorMessage;
+type RuntimeMessage = ReadyMessage | ResizeMessage | NavigateMessage | OpenPeekMessage | OpenCallMessage | OverlayStateMessage | OpenModalMessage | ModalResultMessage | EscapePressedMessage | OpenAgentWindowMessage | CloseAgentWindowMessage | ErrorMessage;
 type Envelope<T> = T & {
     source: typeof MESSAGE_SOURCE;
 };
 declare function isHostMessage(data: unknown): data is Envelope<HostMessage>;
 declare function isRuntimeMessage(data: unknown): data is Envelope<RuntimeMessage>;
 
-export { type AuthRefreshMessage, COMPONENT_OVERLAY_Z_INDEX, type DataInvalidateMessage, type Envelope, type ErrorMessage, type EscapePressedMessage, type HostMessage, type InitMessage, MESSAGE_SOURCE, type ModalClosedMessage, type ModalResultMessage, type ModalWidth, type NavigateMessage, type OpenCallMessage, type OpenModalMessage, type OpenPeekMessage, type OverlayRect, type OverlayRectMessage, type OverlayStateMessage, type PageContext, type ReadyMessage, type ResizeMessage, type RuntimeMessage, isHostMessage, isRuntimeMessage };
+export { type AuthRefreshMessage, COMPONENT_OVERLAY_Z_INDEX, type CloseAgentWindowMessage, type DataInvalidateMessage, type Envelope, type ErrorMessage, type EscapePressedMessage, type HostMessage, type InitMessage, MESSAGE_SOURCE, type ModalClosedMessage, type ModalResultMessage, type ModalWidth, type NavigateMessage, type OpenAgentWindowMessage, type OpenCallMessage, type OpenModalMessage, type OpenPeekMessage, type OverlayRect, type OverlayRectMessage, type OverlayStateMessage, type PageContext, type ReadyMessage, type ResizeMessage, type RuntimeMessage, isHostMessage, isRuntimeMessage };

package/dist/protocol.d.ts

@@ -190,16 +190,36 @@ interface ModalResultMessage {
     requestId: string;
     result?: unknown;
 }
+/** Ask the host to open its agent session window (the floating assistant).
+ *
+ *  - `sessionId` set: the window resumes THAT session (its agent is read from
+ *    the session). A `prompt` is sent into it.
+ *  - no `sessionId`: a fresh session with `agentKey` (or the agent currently
+ *    selected in the window); a `prompt` is sent as its first message. With
+ *    neither field the window just opens as it is.
+ *
+ *  Ignored on public pages (there is no signed-in user to run an agent as). */
+interface OpenAgentWindowMessage {
+    type: 'OPEN_AGENT_WINDOW';
+    sessionId?: string;
+    agentKey?: string;
+    prompt?: string;
+}
+/** Ask the host to minimize its agent session window. The active session and
+ *  its stream stay alive — reopening resumes it. */
+interface CloseAgentWindowMessage {
+    type: 'CLOSE_AGENT_WINDOW';
+}
 interface ErrorMessage {
     type: 'ERROR';
     message: string;
     stack?: string;
 }
-type RuntimeMessage = ReadyMessage | ResizeMessage | NavigateMessage | OpenPeekMessage | OpenCallMessage | OverlayStateMessage | OpenModalMessage | ModalResultMessage | EscapePressedMessage | ErrorMessage;
+type RuntimeMessage = ReadyMessage | ResizeMessage | NavigateMessage | OpenPeekMessage | OpenCallMessage | OverlayStateMessage | OpenModalMessage | ModalResultMessage | EscapePressedMessage | OpenAgentWindowMessage | CloseAgentWindowMessage | ErrorMessage;
 type Envelope<T> = T & {
     source: typeof MESSAGE_SOURCE;
 };
 declare function isHostMessage(data: unknown): data is Envelope<HostMessage>;
 declare function isRuntimeMessage(data: unknown): data is Envelope<RuntimeMessage>;
 
-export { type AuthRefreshMessage, COMPONENT_OVERLAY_Z_INDEX, type DataInvalidateMessage, type Envelope, type ErrorMessage, type EscapePressedMessage, type HostMessage, type InitMessage, MESSAGE_SOURCE, type ModalClosedMessage, type ModalResultMessage, type ModalWidth, type NavigateMessage, type OpenCallMessage, type OpenModalMessage, type OpenPeekMessage, type OverlayRect, type OverlayRectMessage, type OverlayStateMessage, type PageContext, type ReadyMessage, type ResizeMessage, type RuntimeMessage, isHostMessage, isRuntimeMessage };
+export { type AuthRefreshMessage, COMPONENT_OVERLAY_Z_INDEX, type CloseAgentWindowMessage, type DataInvalidateMessage, type Envelope, type ErrorMessage, type EscapePressedMessage, type HostMessage, type InitMessage, MESSAGE_SOURCE, type ModalClosedMessage, type ModalResultMessage, type ModalWidth, type NavigateMessage, type OpenAgentWindowMessage, type OpenCallMessage, type OpenModalMessage, type OpenPeekMessage, type OverlayRect, type OverlayRectMessage, type OverlayStateMessage, type PageContext, type ReadyMessage, type ResizeMessage, type RuntimeMessage, isHostMessage, isRuntimeMessage };

package/dist/protocol.js

@@ -1,3 +1,3 @@
-export { COMPONENT_OVERLAY_Z_INDEX, MESSAGE_SOURCE, isHostMessage, isRuntimeMessage } from './chunk-HODSL6ER.js';
+export { COMPONENT_OVERLAY_Z_INDEX, MESSAGE_SOURCE, isHostMessage, isRuntimeMessage } from './chunk-NOCSMXCW.js';
 //# sourceMappingURL=protocol.js.map
 //# sourceMappingURL=protocol.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proteos/component-sdk",
-  "version": "0.59.2",
+  "version": "0.61.0",
   "license": "Apache-2.0",
   "description": "Typed runtime hooks for authoring Proteos custom components — the SDK you import inside a component bundle.",
   "repository": {
@@ -42,7 +42,7 @@
     "src"
   ],
   "dependencies": {
-    "@proteos/sdk": "^0.59.2"
+    "@proteos/sdk": "^0.61.0"
   },
   "peerDependencies": {
     "@tanstack/react-query": ">=5.0.0",

package/src/context.tsx

@@ -11,12 +11,14 @@ import type {
 import { createContext, type ReactNode, useMemo } from 'react'
 
 import {
+  type CloseAgentWindowMessage,
   type Envelope,
   isHostMessage,
   MESSAGE_SOURCE,
   type ModalResultMessage,
   type ModalWidth,
   type NavigateMessage,
+  type OpenAgentWindowMessage,
   type OpenCallMessage,
   type OpenModalMessage,
   type OpenPeekMessage,
@@ -45,6 +47,29 @@ export interface OpenModalOptions {
   height?: number
 }
 
+/** What {@link AgentWindowController.open} opens the host's agent window to. */
+export interface OpenAgentWindowOptions {
+  /** Resume this session (its agent comes with it). */
+  sessionId?: string
+  /** Start a fresh session with this agent. Ignored when `sessionId` is set,
+   *  and when the host surface pins its agent. Without it (and without a
+   *  session) the window's currently selected agent is used. */
+  agentKey?: string
+  /** A message to send — into the resumed session, or as the first message
+   *  of the fresh one. */
+  prompt?: string
+}
+
+/**
+ * The host's agent session window (the floating assistant), driven from a
+ * component. `open()` posts OPEN_AGENT_WINDOW, `close()` posts
+ * CLOSE_AGENT_WINDOW — closing minimizes; the session and its stream live on.
+ */
+export interface AgentWindowController {
+  open: (options?: OpenAgentWindowOptions) => void
+  close: () => void
+}
+
 /**
  * Manual control over iframe overlay promotion. The runtime already detects
  * overlays automatically (anything portaled to the iframe's `document.body` —
@@ -130,6 +155,9 @@ export interface RuntimeContextValue extends RuntimeValue {
     props?: Record<string, unknown>,
     options?: OpenModalOptions,
   ) => Promise<unknown>
+  /** Open / minimize the host's agent session window (posts OPEN_AGENT_WINDOW
+   *  / CLOSE_AGENT_WINDOW). */
+  agentWindow: AgentWindowController
 }
 
 export const RuntimeContext = createContext<RuntimeContextValue | null>(null)
@@ -158,6 +186,29 @@ function openCall(conversationBriefId: string): void {
   window.parent?.postMessage(envelope, '*')
 }
 
+/** Post OPEN_AGENT_WINDOW — only the fields that were given ride the wire. */
+function openAgentWindow(options?: OpenAgentWindowOptions): void {
+  const envelope: Envelope<OpenAgentWindowMessage> = {
+    source: MESSAGE_SOURCE,
+    type: 'OPEN_AGENT_WINDOW',
+    ...(options?.sessionId !== undefined ? { sessionId: options.sessionId } : {}),
+    ...(options?.agentKey !== undefined ? { agentKey: options.agentKey } : {}),
+    ...(options?.prompt !== undefined ? { prompt: options.prompt } : {}),
+  }
+  window.parent?.postMessage(envelope, '*')
+}
+
+/** Post CLOSE_AGENT_WINDOW — minimize the host's agent window. */
+function closeAgentWindow(): void {
+  const envelope: Envelope<CloseAgentWindowMessage> = {
+    source: MESSAGE_SOURCE,
+    type: 'CLOSE_AGENT_WINDOW',
+  }
+  window.parent?.postMessage(envelope, '*')
+}
+
+const agentWindow: AgentWindowController = { open: openAgentWindow, close: closeAgentWindow }
+
 /** Navigate full-page (default) or into a peek panel (`{ peek: true }`). */
 function navigate(to: string, options?: NavigateOptions): void {
   if (options?.peek) postOpenPeek(to)
@@ -278,7 +329,7 @@ export function RuntimeProvider({ value, children }: { value: RuntimeValue; chil
   // props and pageCtx are all set once), so memoizing on its identity recreates
   // the context only when the runtime genuinely re-inits.
   const ctx = useMemo<RuntimeContextValue>(
-    () => ({ ...value, navigate, openCall, openModal }),
+    () => ({ ...value, navigate, openCall, openModal, agentWindow }),
     [value],
   )
   return <RuntimeContext.Provider value={ctx}>{children}</RuntimeContext.Provider>

package/src/hooks.test.tsx

@@ -4,6 +4,7 @@ import { afterEach, describe, expect, it, vi } from 'vitest'
 
 import { RuntimeProvider, type RuntimeValue } from './context'
 import {
+  useAgentWindow,
   useApiBaseUrl,
   useComponentModal,
   useModalHost,
@@ -75,6 +76,40 @@ describe('runtime hooks', () => {
     )
   })
 
+  it('useAgentWindow posts OPEN_AGENT_WINDOW with only the fields given, and CLOSE_AGENT_WINDOW', () => {
+    const post = vi.spyOn(window.parent, 'postMessage').mockImplementation(() => {})
+    const { result } = renderHook(() => useAgentWindow(), { wrapper: wrapper(makeValue()) })
+
+    result.current.open()
+    expect(post).toHaveBeenLastCalledWith(
+      { source: MESSAGE_SOURCE, type: 'OPEN_AGENT_WINDOW' },
+      '*',
+    )
+
+    result.current.open({ sessionId: 'sess_1', prompt: 'Summarize this' })
+    expect(post).toHaveBeenLastCalledWith(
+      {
+        source: MESSAGE_SOURCE,
+        type: 'OPEN_AGENT_WINDOW',
+        sessionId: 'sess_1',
+        prompt: 'Summarize this',
+      },
+      '*',
+    )
+
+    result.current.open({ agentKey: 'sales-bot' })
+    expect(post).toHaveBeenLastCalledWith(
+      { source: MESSAGE_SOURCE, type: 'OPEN_AGENT_WINDOW', agentKey: 'sales-bot' },
+      '*',
+    )
+
+    result.current.close()
+    expect(post).toHaveBeenLastCalledWith(
+      { source: MESSAGE_SOURCE, type: 'CLOSE_AGENT_WINDOW' },
+      '*',
+    )
+  })
+
   it('useOverlayExpansion drives the shell controller', () => {
     const overlay = { expand: vi.fn(), collapse: vi.fn(), isExpanded: () => true }
     const { result } = renderHook(() => useOverlayExpansion(), {

package/src/hooks.ts

@@ -1,6 +1,7 @@
 import { useCallback, useContext, useEffect, useMemo, useState } from 'react'
 
 import {
+  type AgentWindowController,
   type ComponentSdk,
   type NavigateOptions,
   type OpenModalOptions,
@@ -70,6 +71,26 @@ export function useOpenCall(): (conversationBriefId: string) => void {
   return useRuntime().openCall
 }
 
+/**
+ * Open or minimize the HOST's agent session window (the floating assistant)
+ * from a component — the iframe cannot render it itself.
+ *
+ * ```ts
+ * const agentWindow = useAgentWindow()
+ * agentWindow.open()                                   // just open it
+ * agentWindow.open({ sessionId })                      // resume a session
+ * agentWindow.open({ agentKey: 'sales-bot', prompt })  // fresh session, prompt sent
+ * agentWindow.close()                                  // minimize (session lives on)
+ * ```
+ *
+ * `sessionId` wins over `agentKey` (the session already has an agent); a
+ * `prompt` goes into whichever session the window lands on. Ignored on public
+ * pages, and by preview hosts.
+ */
+export function useAgentWindow(): AgentWindowController {
+  return useRuntime().agentWindow
+}
+
 /** The API origin SDK calls resolve against (for building raw asset URLs). */
 export function useApiBaseUrl(): string {
   return useRuntime().apiBaseUrl

package/src/index.ts

@@ -8,8 +8,10 @@
 import './global'
 
 export type {
+  AgentWindowController,
   ComponentSdk,
   NavigateOptions,
+  OpenAgentWindowOptions,
   OpenModalOptions,
   OverlayController,
   RuntimeContextValue,
@@ -18,6 +20,7 @@ export type {
 export { RuntimeProvider } from './context'
 export type { FillViewportOptions, HostLocation, ModalHost } from './hooks'
 export {
+  useAgentWindow,
   useApiBaseUrl,
   useAuthToken,
   useComponentModal,
@@ -34,6 +37,7 @@ export {
 } from './hooks'
 export {
   type AuthRefreshMessage,
+  type CloseAgentWindowMessage,
   COMPONENT_OVERLAY_Z_INDEX,
   type DataInvalidateMessage,
   type Envelope,
@@ -48,6 +52,7 @@ export {
   type ModalResultMessage,
   type ModalWidth,
   type NavigateMessage,
+  type OpenAgentWindowMessage,
   type OpenCallMessage,
   type OpenModalMessage,
   type OpenPeekMessage,

package/src/protocol.ts

@@ -221,6 +221,28 @@ export interface ModalResultMessage {
   result?: unknown
 }
 
+/** Ask the host to open its agent session window (the floating assistant).
+ *
+ *  - `sessionId` set: the window resumes THAT session (its agent is read from
+ *    the session). A `prompt` is sent into it.
+ *  - no `sessionId`: a fresh session with `agentKey` (or the agent currently
+ *    selected in the window); a `prompt` is sent as its first message. With
+ *    neither field the window just opens as it is.
+ *
+ *  Ignored on public pages (there is no signed-in user to run an agent as). */
+export interface OpenAgentWindowMessage {
+  type: 'OPEN_AGENT_WINDOW'
+  sessionId?: string
+  agentKey?: string
+  prompt?: string
+}
+
+/** Ask the host to minimize its agent session window. The active session and
+ *  its stream stay alive — reopening resumes it. */
+export interface CloseAgentWindowMessage {
+  type: 'CLOSE_AGENT_WINDOW'
+}
+
 export interface ErrorMessage {
   type: 'ERROR'
   message: string
@@ -237,6 +259,8 @@ export type RuntimeMessage =
   | OpenModalMessage
   | ModalResultMessage
   | EscapePressedMessage
+  | OpenAgentWindowMessage
+  | CloseAgentWindowMessage
   | ErrorMessage
 
 // Wire envelope: the message plus the source discriminator.