@proteos/component-sdk 0.60.0 → 0.75.0

package/dist/{chunk-HODSL6ER.js → chunk-IYXDPNMJ.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-IYXDPNMJ.js.map
+//# sourceMappingURL=chunk-IYXDPNMJ.js.map

package/dist/chunk-IYXDPNMJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/protocol.ts"],"names":[],"mappings":";AAYO,IAAM,cAAA,GAAiB;AAuBvB,IAAM,yBAAA,GAA4B;AAmYlC,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-IYXDPNMJ.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\nimport type { PageAction } from '@proteos/sdk'\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\n/** What the viewer is doing with the record on the host page.\n *\n *  - `view`   — a read-only record page, or a page without a record\n *               (platform, kiosk, public, previews).\n *  - `create` — the form for a record that is not saved yet (`record` holds\n *               the seed values only, no `id`).\n *  - `edit`   — the form over an existing record (`record` is the SAVED row;\n *               in-flight edits are not reflected).\n *\n *  Inside an action's / workflow's invoke dialog (a trigger page) `mode` is\n *  `create` while the person fills the params and `view` once the run is on\n *  its way; `phase` says where the run is.\n *\n *  A snapshot like `record`: the host remounts the frame when the page\n *  switches between view and edit, so a new INIT carries the new mode. Also\n *  the Liquid scope key `mode` when props are resolved. */\nexport type PageMode = 'view' | 'create' | 'edit'\n\n/** Where an invocation is in the invoke dialog's lifecycle — set only on a\n *  trigger page (the dialog of an action / workflow); absent everywhere else.\n *\n *  - `input`   — the form over the params (`record` = the seeded params).\n *  - `running` — the run is in flight (`record` = the submitted params;\n *                `params.execution` for a workflow).\n *  - `result`  — the run ended (`record` = the params plus the action's\n *                returns; `params.result` / `params.execution`).\n *\n *  Also the Liquid scope key `phase`. */\nexport type TriggerPhase = 'input' | 'running' | 'result'\n\nexport interface PageContext {\n  record?: Record<string, unknown>\n  entity?: { slug: string; [key: string]: unknown }\n  params?: Record<string, unknown>\n  mode: PageMode\n  phase?: TriggerPhase\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  /** Content hash (hex SHA-256) of the component's deployed bundle, from the\n   *  component's `bundle_checksum`. The runtime appends it as `?v=` to the\n   *  bundle request so the server can mark the response immutable — the\n   *  browser then serves every later mount from its cache without a round\n   *  trip. Absent when the host does not know it yet (metadata still\n   *  loading, or a row deployed before checksum stamping); the bundle then\n   *  revalidates as before. */\n  bundleVersion?: string\n  /** Key under which the runtime shares its query cache with sibling and\n   *  successor frames of the same component through the host (same\n   *  origin): the host warms a new frame from the last state a frame with\n   *  this key left behind. Covers the slug AND the resolved props, so two\n   *  placements configured differently never share. Absent on hosts that\n   *  do not keep a store (previews, public pages). */\n  cacheKey?: 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\n/** How a RUN_PAGE_ACTION ended, by what the button did:\n *\n *  - `done`        — the run went through: an action's `returns` (null when it\n *                    returned none), a workflow's accepted `executionId`, the\n *                    record an intent created / updated.\n *  - `failed`      — the invocation failed and the person closed the error.\n *  - `cancelled`   — the person stepped out before anything ran or saved.\n *  - `handed_over` — an `agent` / `link` button: the chat or the tab is open;\n *                    what happens there is not reported back.\n *  - `unavailable` — nothing was opened: `invalid` (the action does not parse),\n *                    `hidden` (its `visible_when` does not match, an intent\n *                    has no record to act on, a link no address to open),\n *                    `busy` (another page action is still open), `unsupported`\n *                    (a public page, a host without page actions — a preview —\n *                    or an agent button where there is no agent window). */\nexport type PageActionOutcome =\n  | { status: 'done'; kind: 'action'; returns: Record<string, unknown> | null }\n  | { status: 'done'; kind: 'workflow'; executionId: string }\n  | {\n      status: 'done'\n      kind: 'intent'\n      mode: 'create' | 'update'\n      entitySlug: string\n      recordId: string\n      title: string\n    }\n  | { status: 'failed'; error: { code: string; message: string } }\n  | { status: 'cancelled' }\n  | { status: 'handed_over'; kind: 'agent' | 'link' }\n  | { status: 'unavailable'; reason: 'invalid' | 'hidden' | 'busy' | 'unsupported' }\n\n/** Resolution of a RUN_PAGE_ACTION request, once the run's flow is over. */\nexport interface PageActionSettledMessage {\n  type: 'PAGE_ACTION_SETTLED'\n  requestId: string\n  outcome: PageActionOutcome\n}\n\nexport type HostMessage =\n  | InitMessage\n  | AuthRefreshMessage\n  | DataInvalidateMessage\n  | OverlayRectMessage\n  | ModalClosedMessage\n  | PageActionSettledMessage\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  /** Model-only context sent with `prompt`; never rendered. */\n  context?: 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\n/** A record write the component made through its sdk (`data.records.*`)\n *  succeeded. Posted by the runtime shell — not by component code — so the\n *  host can refresh what it shows of that entity and, when the component\n *  sits in a surface that reports edits (the Ava workspace), tell the agent.\n *  `patch` is what was submitted, `record` what the server returned. */\nexport interface RecordWrittenMessage {\n  type: 'RECORD_WRITTEN'\n  entitySlug: string\n  operation: 'create' | 'update' | 'delete' | 'batch_upsert'\n  recordId?: string\n  patch?: Record<string, unknown>\n  record?: Record<string, unknown>\n  /** Rows in a batch upsert. */\n  count?: number\n}\n\n/** A record a page action acts on, as the component names it. */\nexport interface PageActionRecord {\n  entitySlug: string\n  recordId: string\n  /** Shown when the person picks among several records for an intent. */\n  title?: string\n  /** The entity's display name, shown beside `title` in that pick. */\n  entityName?: string\n}\n\n/** What the component knows that the button needs — layered over what the\n *  host already knows about the page. */\nexport interface PageActionContext {\n  /** Merged over the page scope (`record`, `entity`, `params`, `mode`,\n   *  `current_user`) the action's Liquid templates render against — `params`\n   *  / `inputs` prefill, `prompt`, `context`, `entity`, `record`, `url`.\n   *  Shallow: a key given here replaces the page's. `current_user` is always\n   *  the host's. */\n  scope?: Record<string, unknown>\n  /** The records the button acts on. Default: the page record (none on a page\n   *  without one).\n   *\n   *  - `action` with entity scope — the one record it is invoked on.\n   *  - `action` with entity_batch scope — every record, in ONE invocation.\n   *  - `intent` `update_record` without a `record` — the records of the\n   *    intent's entity it may update: one is updated, several are offered\n   *    to pick from. */\n  records?: PageActionRecord[]\n}\n\n/** Ask the host to run a page action — the same button a page or list toolbar\n *  carries, defined inline by the component. The host dispatches it exactly\n *  as a toolbar press (invoke dialog, record proposal review, agent window,\n *  new tab) and answers PAGE_ACTION_SETTLED with the same `requestId` once\n *  the flow is over.\n *\n *  One page action at a time: while one is open (from any component) the\n *  host answers further requests `unavailable: busy`. */\nexport interface RunPageActionMessage {\n  type: 'RUN_PAGE_ACTION'\n  /** Correlates the eventual PAGE_ACTION_SETTLED. Generated by the runtime. */\n  requestId: string\n  action: PageAction\n  context?: PageActionContext\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  | RecordWrittenMessage\n  | RunPageActionMessage\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-3VUWWDED.cjs → chunk-Q7PTW7DD.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-Q7PTW7DD.cjs.map
+//# sourceMappingURL=chunk-Q7PTW7DD.cjs.map

package/dist/chunk-Q7PTW7DD.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/protocol.ts"],"names":[],"mappings":";;;AAYO,IAAM,cAAA,GAAiB;AAuBvB,IAAM,yBAAA,GAA4B;AAmYlC,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-Q7PTW7DD.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\nimport type { PageAction } from '@proteos/sdk'\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\n/** What the viewer is doing with the record on the host page.\n *\n *  - `view`   — a read-only record page, or a page without a record\n *               (platform, kiosk, public, previews).\n *  - `create` — the form for a record that is not saved yet (`record` holds\n *               the seed values only, no `id`).\n *  - `edit`   — the form over an existing record (`record` is the SAVED row;\n *               in-flight edits are not reflected).\n *\n *  Inside an action's / workflow's invoke dialog (a trigger page) `mode` is\n *  `create` while the person fills the params and `view` once the run is on\n *  its way; `phase` says where the run is.\n *\n *  A snapshot like `record`: the host remounts the frame when the page\n *  switches between view and edit, so a new INIT carries the new mode. Also\n *  the Liquid scope key `mode` when props are resolved. */\nexport type PageMode = 'view' | 'create' | 'edit'\n\n/** Where an invocation is in the invoke dialog's lifecycle — set only on a\n *  trigger page (the dialog of an action / workflow); absent everywhere else.\n *\n *  - `input`   — the form over the params (`record` = the seeded params).\n *  - `running` — the run is in flight (`record` = the submitted params;\n *                `params.execution` for a workflow).\n *  - `result`  — the run ended (`record` = the params plus the action's\n *                returns; `params.result` / `params.execution`).\n *\n *  Also the Liquid scope key `phase`. */\nexport type TriggerPhase = 'input' | 'running' | 'result'\n\nexport interface PageContext {\n  record?: Record<string, unknown>\n  entity?: { slug: string; [key: string]: unknown }\n  params?: Record<string, unknown>\n  mode: PageMode\n  phase?: TriggerPhase\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  /** Content hash (hex SHA-256) of the component's deployed bundle, from the\n   *  component's `bundle_checksum`. The runtime appends it as `?v=` to the\n   *  bundle request so the server can mark the response immutable — the\n   *  browser then serves every later mount from its cache without a round\n   *  trip. Absent when the host does not know it yet (metadata still\n   *  loading, or a row deployed before checksum stamping); the bundle then\n   *  revalidates as before. */\n  bundleVersion?: string\n  /** Key under which the runtime shares its query cache with sibling and\n   *  successor frames of the same component through the host (same\n   *  origin): the host warms a new frame from the last state a frame with\n   *  this key left behind. Covers the slug AND the resolved props, so two\n   *  placements configured differently never share. Absent on hosts that\n   *  do not keep a store (previews, public pages). */\n  cacheKey?: 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\n/** How a RUN_PAGE_ACTION ended, by what the button did:\n *\n *  - `done`        — the run went through: an action's `returns` (null when it\n *                    returned none), a workflow's accepted `executionId`, the\n *                    record an intent created / updated.\n *  - `failed`      — the invocation failed and the person closed the error.\n *  - `cancelled`   — the person stepped out before anything ran or saved.\n *  - `handed_over` — an `agent` / `link` button: the chat or the tab is open;\n *                    what happens there is not reported back.\n *  - `unavailable` — nothing was opened: `invalid` (the action does not parse),\n *                    `hidden` (its `visible_when` does not match, an intent\n *                    has no record to act on, a link no address to open),\n *                    `busy` (another page action is still open), `unsupported`\n *                    (a public page, a host without page actions — a preview —\n *                    or an agent button where there is no agent window). */\nexport type PageActionOutcome =\n  | { status: 'done'; kind: 'action'; returns: Record<string, unknown> | null }\n  | { status: 'done'; kind: 'workflow'; executionId: string }\n  | {\n      status: 'done'\n      kind: 'intent'\n      mode: 'create' | 'update'\n      entitySlug: string\n      recordId: string\n      title: string\n    }\n  | { status: 'failed'; error: { code: string; message: string } }\n  | { status: 'cancelled' }\n  | { status: 'handed_over'; kind: 'agent' | 'link' }\n  | { status: 'unavailable'; reason: 'invalid' | 'hidden' | 'busy' | 'unsupported' }\n\n/** Resolution of a RUN_PAGE_ACTION request, once the run's flow is over. */\nexport interface PageActionSettledMessage {\n  type: 'PAGE_ACTION_SETTLED'\n  requestId: string\n  outcome: PageActionOutcome\n}\n\nexport type HostMessage =\n  | InitMessage\n  | AuthRefreshMessage\n  | DataInvalidateMessage\n  | OverlayRectMessage\n  | ModalClosedMessage\n  | PageActionSettledMessage\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  /** Model-only context sent with `prompt`; never rendered. */\n  context?: 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\n/** A record write the component made through its sdk (`data.records.*`)\n *  succeeded. Posted by the runtime shell — not by component code — so the\n *  host can refresh what it shows of that entity and, when the component\n *  sits in a surface that reports edits (the Ava workspace), tell the agent.\n *  `patch` is what was submitted, `record` what the server returned. */\nexport interface RecordWrittenMessage {\n  type: 'RECORD_WRITTEN'\n  entitySlug: string\n  operation: 'create' | 'update' | 'delete' | 'batch_upsert'\n  recordId?: string\n  patch?: Record<string, unknown>\n  record?: Record<string, unknown>\n  /** Rows in a batch upsert. */\n  count?: number\n}\n\n/** A record a page action acts on, as the component names it. */\nexport interface PageActionRecord {\n  entitySlug: string\n  recordId: string\n  /** Shown when the person picks among several records for an intent. */\n  title?: string\n  /** The entity's display name, shown beside `title` in that pick. */\n  entityName?: string\n}\n\n/** What the component knows that the button needs — layered over what the\n *  host already knows about the page. */\nexport interface PageActionContext {\n  /** Merged over the page scope (`record`, `entity`, `params`, `mode`,\n   *  `current_user`) the action's Liquid templates render against — `params`\n   *  / `inputs` prefill, `prompt`, `context`, `entity`, `record`, `url`.\n   *  Shallow: a key given here replaces the page's. `current_user` is always\n   *  the host's. */\n  scope?: Record<string, unknown>\n  /** The records the button acts on. Default: the page record (none on a page\n   *  without one).\n   *\n   *  - `action` with entity scope — the one record it is invoked on.\n   *  - `action` with entity_batch scope — every record, in ONE invocation.\n   *  - `intent` `update_record` without a `record` — the records of the\n   *    intent's entity it may update: one is updated, several are offered\n   *    to pick from. */\n  records?: PageActionRecord[]\n}\n\n/** Ask the host to run a page action — the same button a page or list toolbar\n *  carries, defined inline by the component. The host dispatches it exactly\n *  as a toolbar press (invoke dialog, record proposal review, agent window,\n *  new tab) and answers PAGE_ACTION_SETTLED with the same `requestId` once\n *  the flow is over.\n *\n *  One page action at a time: while one is open (from any component) the\n *  host answers further requests `unavailable: busy`. */\nexport interface RunPageActionMessage {\n  type: 'RUN_PAGE_ACTION'\n  /** Correlates the eventual PAGE_ACTION_SETTLED. Generated by the runtime. */\n  requestId: string\n  action: PageAction\n  context?: PageActionContext\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  | RecordWrittenMessage\n  | RunPageActionMessage\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,42 +1,71 @@
 'use strict';
 
-var chunk3VUWWDED_cjs = require('./chunk-3VUWWDED.cjs');
+var chunkQ7PTW7DD_cjs = require('./chunk-Q7PTW7DD.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: chunkQ7PTW7DD_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: chunkQ7PTW7DD_cjs.MESSAGE_SOURCE, type: "OPEN_PEEK", to };
   window.parent?.postMessage(envelope, "*");
 }
 function openCall(conversationBriefId) {
   const envelope = {
-    source: chunk3VUWWDED_cjs.MESSAGE_SOURCE,
+    source: chunkQ7PTW7DD_cjs.MESSAGE_SOURCE,
     type: "OPEN_CALL",
     conversationBriefId
   };
   window.parent?.postMessage(envelope, "*");
 }
+function openAgentWindow(options) {
+  const envelope = {
+    source: chunkQ7PTW7DD_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 } : {},
+    ...options?.context !== void 0 ? { context: options.context } : {}
+  };
+  window.parent?.postMessage(envelope, "*");
+}
+function closeAgentWindow() {
+  const envelope = {
+    source: chunkQ7PTW7DD_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);
 }
 var pendingModals = /* @__PURE__ */ new Map();
-var modalListenerAttached = false;
-function ensureModalListener() {
-  if (modalListenerAttached) return;
-  modalListenerAttached = true;
+var pendingPageActions = /* @__PURE__ */ new Map();
+var replyListenerAttached = false;
+function ensureReplyListener() {
+  if (replyListenerAttached) return;
+  replyListenerAttached = true;
   window.addEventListener("message", (event) => {
     const data = event.data;
-    if (!chunk3VUWWDED_cjs.isHostMessage(data) || data.type !== "MODAL_CLOSED") return;
-    const resolve = pendingModals.get(data.requestId);
-    if (!resolve) return;
-    pendingModals.delete(data.requestId);
-    resolve(data.result);
+    if (!chunkQ7PTW7DD_cjs.isHostMessage(data)) return;
+    if (data.type === "MODAL_CLOSED") {
+      const resolve = pendingModals.get(data.requestId);
+      if (!resolve) return;
+      pendingModals.delete(data.requestId);
+      resolve(data.result);
+      return;
+    }
+    if (data.type === "PAGE_ACTION_SETTLED") {
+      const resolve = pendingPageActions.get(data.requestId);
+      if (!resolve) return;
+      pendingPageActions.delete(data.requestId);
+      resolve(data.outcome);
+    }
   });
 }
 var FOCUS_RESTORE_WINDOW_MS = 1e3;
@@ -62,13 +91,13 @@ function newRequestId() {
   if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
     return crypto.randomUUID();
   }
-  return `modal_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
+  return `request_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
 }
 function openModal(componentSlug, props, options) {
-  ensureModalListener();
+  ensureReplyListener();
   const requestId = newRequestId();
   const envelope = {
-    source: chunk3VUWWDED_cjs.MESSAGE_SOURCE,
+    source: chunkQ7PTW7DD_cjs.MESSAGE_SOURCE,
     type: "OPEN_MODAL",
     requestId,
     componentSlug,
@@ -86,9 +115,28 @@ function openModal(componentSlug, props, options) {
     window.parent?.postMessage(envelope, "*");
   });
 }
+function runPageAction(action, context) {
+  ensureReplyListener();
+  const requestId = newRequestId();
+  const envelope = {
+    source: chunkQ7PTW7DD_cjs.MESSAGE_SOURCE,
+    type: "RUN_PAGE_ACTION",
+    requestId,
+    action,
+    ...context !== void 0 ? { context } : {}
+  };
+  const opener = document.activeElement instanceof HTMLElement ? document.activeElement : null;
+  return new Promise((resolve) => {
+    pendingPageActions.set(requestId, (outcome) => {
+      restoreFocus(opener);
+      resolve(outcome);
+    });
+    window.parent?.postMessage(envelope, "*");
+  });
+}
 function postModalResult(requestId, result) {
   const envelope = {
-    source: chunk3VUWWDED_cjs.MESSAGE_SOURCE,
+    source: chunkQ7PTW7DD_cjs.MESSAGE_SOURCE,
     type: "MODAL_RESULT",
     requestId,
     ...result !== void 0 ? { result } : {}
@@ -97,7 +145,7 @@ function postModalResult(requestId, result) {
 }
 function RuntimeProvider({ value, children }) {
   const ctx = react.useMemo(
-    () => ({ ...value, navigate, openCall, openModal }),
+    () => ({ ...value, navigate, openCall, openModal, agentWindow, runPageAction }),
     [value]
   );
   return /* @__PURE__ */ jsxRuntime.jsx(RuntimeContext.Provider, { value: ctx, children });
@@ -126,6 +174,9 @@ function useNavigate() {
 function useOpenCall() {
   return useRuntime().openCall;
 }
+function useAgentWindow() {
+  return useRuntime().agentWindow;
+}
 function useApiBaseUrl() {
   return useRuntime().apiBaseUrl;
 }
@@ -145,6 +196,9 @@ function useOverlayExpansion() {
 function useComponentModal() {
   return useRuntime().openModal;
 }
+function usePageAction() {
+  return useRuntime().runPageAction;
+}
 function useModalHost() {
   const requestId = useRuntime().modalRequestId;
   const close = react.useCallback(
@@ -208,21 +262,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 chunkQ7PTW7DD_cjs.COMPONENT_OVERLAY_Z_INDEX; }
 });
 Object.defineProperty(exports, "MESSAGE_SOURCE", {
   enumerable: true,
-  get: function () { return chunk3VUWWDED_cjs.MESSAGE_SOURCE; }
+  get: function () { return chunkQ7PTW7DD_cjs.MESSAGE_SOURCE; }
 });
 Object.defineProperty(exports, "isHostMessage", {
   enumerable: true,
-  get: function () { return chunk3VUWWDED_cjs.isHostMessage; }
+  get: function () { return chunkQ7PTW7DD_cjs.isHostMessage; }
 });
 Object.defineProperty(exports, "isRuntimeMessage", {
   enumerable: true,
-  get: function () { return chunk3VUWWDED_cjs.isRuntimeMessage; }
+  get: function () { return chunkQ7PTW7DD_cjs.isRuntimeMessage; }
 });
 exports.RuntimeProvider = RuntimeProvider;
+exports.useAgentWindow = useAgentWindow;
 exports.useApiBaseUrl = useApiBaseUrl;
 exports.useAuthToken = useAuthToken;
 exports.useComponentModal = useComponentModal;
@@ -232,6 +287,7 @@ exports.useModalHost = useModalHost;
 exports.useNavigate = useNavigate;
 exports.useOpenCall = useOpenCall;
 exports.useOverlayExpansion = useOverlayExpansion;
+exports.usePageAction = usePageAction;
 exports.usePageContext = usePageContext;
 exports.useProps = useProps;
 exports.useRuntime = useRuntime;

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":"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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  PageAction,\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 PageActionContext,\n  type PageActionOutcome,\n  type PageContext,\n  type RunPageActionMessage,\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  /** Context handed to the model alongside `prompt` (what the component knows:\n   *  the record on screen, a selection …). Read by the model, never shown in\n   *  the chat; sent only together with a `prompt`. Not for secrets. */\n  context?: 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  /** Run a page action defined inline (posts RUN_PAGE_ACTION); resolves with\n   *  how its flow ended. */\n  runPageAction: (action: PageAction, context?: PageActionContext) => Promise<PageActionOutcome>\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    ...(options?.context !== undefined ? { context: options.context } : {}),\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// ── Host requests (component modals, page actions) ──────────────────────────\n// One module-level listener + a pending map per request kind, rather than a\n// listener per call: the SDK is an import-mapped singleton, so this is\n// per-iframe state.\n\nconst pendingModals = new Map<string, (result: unknown) => void>()\nconst pendingPageActions = new Map<string, (outcome: PageActionOutcome) => void>()\nlet replyListenerAttached = false\n\nfunction ensureReplyListener(): void {\n  if (replyListenerAttached) return\n  replyListenerAttached = true\n  window.addEventListener('message', (event: MessageEvent) => {\n    const data: unknown = event.data\n    if (!isHostMessage(data)) return\n    // An unknown requestId is someone else's request (or a stale reply) — drop it.\n    if (data.type === 'MODAL_CLOSED') {\n      const resolve = pendingModals.get(data.requestId)\n      if (!resolve) return\n      pendingModals.delete(data.requestId)\n      resolve(data.result)\n      return\n    }\n    if (data.type === 'PAGE_ACTION_SETTLED') {\n      const resolve = pendingPageActions.get(data.requestId)\n      if (!resolve) return\n      pendingPageActions.delete(data.requestId)\n      resolve(data.outcome)\n    }\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 `request_${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  ensureReplyListener()\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 RUN_PAGE_ACTION and resolve when the host answers PAGE_ACTION_SETTLED.\n *  The host's dialogs take focus, so it goes back to the pressed control\n *  afterwards — as for a modal. */\nfunction runPageAction(\n  action: PageAction,\n  context?: PageActionContext,\n): Promise<PageActionOutcome> {\n  ensureReplyListener()\n  const requestId = newRequestId()\n  const envelope: Envelope<RunPageActionMessage> = {\n    source: MESSAGE_SOURCE,\n    type: 'RUN_PAGE_ACTION',\n    requestId,\n    action,\n    ...(context !== undefined ? { context } : {}),\n  }\n  const opener = document.activeElement instanceof HTMLElement ? document.activeElement : null\n  return new Promise<PageActionOutcome>((resolve) => {\n    pendingPageActions.set(requestId, (outcome) => {\n      restoreFocus(opener)\n      resolve(outcome)\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, runPageAction }),\n    [value],\n  )\n  return <RuntimeContext.Provider value={ctx}>{children}</RuntimeContext.Provider>\n}\n","import type { PageAction } from '@proteos/sdk'\nimport { 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 { PageActionContext, PageActionOutcome, 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`, URL `params`, the viewer as\n * `current_user` (absent on public pages) and the page `mode`\n * (`'view' | 'create' | 'edit'` — what the viewer is doing with the record).\n * The `record` is a snapshot taken at mount (`undefined` on record-less\n * platform pages) — fetch via `useSdk().data` for anything that must stay\n * fresh. `mode` is a snapshot too: the host remounts the frame when the page\n * switches between view and edit.\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\n/**\n * Run a page action from a component's own button — the very `PageAction` a\n * page or list toolbar carries, defined inline. The HOST runs it exactly as a\n * toolbar press: `action` / `workflow` open the invoke dialog, `intent`\n * prepares a record proposal for review, `agent` opens the agent window,\n * `link` opens a new tab. Resolves once that flow is over.\n *\n * ```ts\n * const runPageAction = usePageAction()\n * const outcome = await runPageAction(\n *   {\n *     kind: 'intent',\n *     intent: 'update_record',\n *     entity: 'deal',\n *     label: 'Update deal',\n *     icon: 'Sparkles',\n *     prompt: 'Apply what was agreed',\n *     context: '{{ notes }}',\n *   },\n *   { scope: { notes }, records: [{ entitySlug: 'deal', recordId: deal.id }] },\n * )\n * if (outcome.status === 'done' && outcome.kind === 'intent') refetch()\n * ```\n *\n * The action's Liquid templates render against the page scope (`record`,\n * `entity`, `params`, `mode`, `current_user`) with `context.scope` merged over\n * it; `context.records` says what it acts on (default: the page record). See\n * {@link PageActionContext} and {@link PageActionOutcome}. `visible_when`\n * still applies — an action whose rule does not match resolves\n * `unavailable: hidden` without opening anything. One page action at a time;\n * public pages and previews resolve `unavailable: unsupported`.\n */\nexport function usePageAction(): (\n  action: PageAction,\n  context?: PageActionContext,\n) => Promise<PageActionOutcome> {\n  return useRuntime().runPageAction\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

@@ -1,8 +1,8 @@
 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';
+import { AccountClient, AgentClient, ConversationClient, DataClient, FunctionsClient, KnowledgeClient, MetaClient, StorageClient, PageAction } from '@proteos/sdk';
+import { ModalWidth, PageContext, PageActionContext, PageActionOutcome } 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, PageActionRecord, PageActionSettledMessage, PageMode, ReadyMessage, ResizeMessage, RunPageActionMessage, RuntimeMessage, TriggerPhase, isHostMessage, isRuntimeMessage } from './protocol.cjs';
 
 /** Options for {@link RuntimeContextValue.navigate}. */
 interface NavigateOptions {
@@ -24,6 +24,31 @@ 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;
+    /** Context handed to the model alongside `prompt` (what the component knows:
+     *  the record on screen, a selection …). Read by the model, never shown in
+     *  the chat; sent only together with a `prompt`. Not for secrets. */
+    context?: 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 +127,12 @@ 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;
+    /** Run a page action defined inline (posts RUN_PAGE_ACTION); resolves with
+     *  how its flow ended. */
+    runPageAction: (action: PageAction, context?: PageActionContext) => Promise<PageActionOutcome>;
 }
 /**
  * Provides the runtime value + derived helpers to a component subtree. Mounted
@@ -138,9 +169,13 @@ declare function useSdk(): ComponentSdk;
 /** The component's Liquid-resolved props (a snapshot, not a live binding). */
 declare function useProps<T extends Record<string, unknown> = Record<string, unknown>>(): T;
 /**
- * The full page context: host `record`, `entity`, and URL `params`. The
- * `record` is a snapshot taken at mount (`undefined` on record-less platform
- * pages) — fetch via `useSdk().data` for anything that must stay fresh.
+ * The full page context: host `record`, `entity`, URL `params`, the viewer as
+ * `current_user` (absent on public pages) and the page `mode`
+ * (`'view' | 'create' | 'edit'` — what the viewer is doing with the record).
+ * The `record` is a snapshot taken at mount (`undefined` on record-less
+ * platform pages) — fetch via `useSdk().data` for anything that must stay
+ * fresh. `mode` is a snapshot too: the host remounts the frame when the page
+ * switches between view and edit.
  */
 declare function usePageContext(): PageContext;
 /**
@@ -159,6 +194,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;
 /**
@@ -200,6 +252,39 @@ declare function useOverlayExpansion(): OverlayController;
  * `@proteos/ui` — it promotes automatically.
  */
 declare function useComponentModal(): (componentSlug: string, props?: Record<string, unknown>, options?: OpenModalOptions) => Promise<unknown>;
+/**
+ * Run a page action from a component's own button — the very `PageAction` a
+ * page or list toolbar carries, defined inline. The HOST runs it exactly as a
+ * toolbar press: `action` / `workflow` open the invoke dialog, `intent`
+ * prepares a record proposal for review, `agent` opens the agent window,
+ * `link` opens a new tab. Resolves once that flow is over.
+ *
+ * ```ts
+ * const runPageAction = usePageAction()
+ * const outcome = await runPageAction(
+ *   {
+ *     kind: 'intent',
+ *     intent: 'update_record',
+ *     entity: 'deal',
+ *     label: 'Update deal',
+ *     icon: 'Sparkles',
+ *     prompt: 'Apply what was agreed',
+ *     context: '{{ notes }}',
+ *   },
+ *   { scope: { notes }, records: [{ entitySlug: 'deal', recordId: deal.id }] },
+ * )
+ * if (outcome.status === 'done' && outcome.kind === 'intent') refetch()
+ * ```
+ *
+ * The action's Liquid templates render against the page scope (`record`,
+ * `entity`, `params`, `mode`, `current_user`) with `context.scope` merged over
+ * it; `context.records` says what it acts on (default: the page record). See
+ * {@link PageActionContext} and {@link PageActionOutcome}. `visible_when`
+ * still applies — an action whose rule does not match resolves
+ * `unavailable: hidden` without opening anything. One page action at a time;
+ * public pages and previews resolve `unavailable: unsupported`.
+ */
+declare function usePageAction(): (action: PageAction, context?: PageActionContext) => Promise<PageActionOutcome>;
 interface ModalHost {
     /** True when this component is rendered as the content of a host modal. */
     isInModal: boolean;
@@ -249,4 +334,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, PageActionContext, PageActionOutcome, PageContext, type RuntimeContextValue, RuntimeProvider, type RuntimeValue, useAgentWindow, useApiBaseUrl, useAuthToken, useComponentModal, useFillViewportHeight, useHostLocation, useModalHost, useNavigate, useOpenCall, useOverlayExpansion, usePageAction, usePageContext, useProps, useRuntime, useSdk };