@ai-matrx/applets 0.2.7

package/dist/react.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react/index.ts","../src/react/context.tsx","../src/types.ts","../src/react/data.ts","../src/react/jobs.ts","../src/react/surface.ts","../src/react/nav.tsx","../src/react/nesting.tsx"],"sourcesContent":["/**\n * `@ai-matrx/applets/react` — what Applet code imports (CONTRACTS §2). One\n * module, in the frame. Every hook returns `status` and an `error` carrying\n * the system's own sentence; none throws into React.\n */\nexport { AppletFrame, type AppletFrameProps, type FrameRenderers, type PageActionHandler, newQueryClient } from \"./context\";\nexport {\n  useRows,\n  useRow,\n  useColumns,\n  useSources,\n  type RowsState,\n  type RowState,\n  type ColumnsState,\n  type SourcesState,\n} from \"./data\";\nexport { useJob, useJobs, type JobState, type JobStatus, type JobInfo, type JobsState, type JobRun } from \"./jobs\";\nexport { useValue, useAction, defineActions, type ActionState } from \"./surface\";\nexport { usePage, navigate, Link, Pages, matchPage, type PageState, type LinkProps, type PagesLayout, type PagesProps } from \"./nav\";\nexport { Applet, Kind, DataPage, type AppletProps, type KindProps, type DataPageProps } from \"./nesting\";\n","/**\n * The frame: `<AppletFrame host>` and the per-frame machinery every hook reads\n * (CONTRACTS §1–§2). One frame per mounted Applet; a nested Applet gets its own\n * frame over the child host, sharing the parent's query cache (keys carry the\n * hostId, so aliases never collide across nesting).\n *\n * The engine is TanStack Query, one QueryClient per frame tree. Rows go through\n * ONE engine, `@ai-matrx/records/data/react`, which the frame mounts with\n * `DataPortProvider` (port `host.data`, events `host.events`, portKey `hostId`).\n */\nimport * as React from \"react\";\nimport { QueryClient, QueryClientProvider } from \"@tanstack/react-query\";\nimport { DataPortProvider, type DataScope } from \"@ai-matrx/records/data/react\";\n\nimport type {\n  ActionContext,\n  AppletChannel,\n  AppletError,\n  AppletRecord,\n  DataEvents,\n  DataPort,\n  EventMessage,\n  NavLocation,\n  PageActionEvent,\n  RecordsError,\n  RecordsResult,\n  Result,\n  RowsEvent,\n  Viewer,\n} from \"../types\";\nimport { fail, PAGE_ACTION_STREAM, toAppletError } from \"../types\";\n\n// ─── event hub: one host subscription per stream, many listeners ──────────\n\ntype Listener = (payload: unknown) => void;\n\ninterface StreamEntry {\n  listeners: Set<Listener>;\n  subscriptionId: string | null;\n  ready: Promise<void>;\n}\n\n/**\n * Routes `{ subscriptionId, payload }` messages to listeners by stream. A\n * stream is subscribed at the host ONCE however many hooks listen, and\n * released when the last listener leaves.\n */\nexport class EventHub {\n  private readonly streams = new Map<string, StreamEntry>();\n  private readonly bySubscription = new Map<string, string>();\n  private detach: (() => void) | null = null;\n\n  constructor(private readonly channel: AppletChannel) {}\n\n  subscribe(stream: string, listener: Listener): { unsubscribe: () => void; ready: Promise<void> } {\n    if (!this.detach) this.detach = this.channel.receive((m) => this.deliver(m));\n    let entry = this.streams.get(stream);\n    if (!entry) {\n      const created: StreamEntry = { listeners: new Set(), subscriptionId: null, ready: Promise.resolve() };\n      created.ready = this.channel.events.on(stream, null).then(\n        ({ subscriptionId }) => {\n          if (this.streams.get(stream) !== created) {\n            void this.channel.events.off(subscriptionId);\n            return;\n          }\n          created.subscriptionId = subscriptionId;\n          this.bySubscription.set(subscriptionId, stream);\n        },\n        (err: unknown) => {\n          void this.channel.reportError({ ...toAppletError(err), where: `events.on(${stream})` });\n        },\n      );\n      this.streams.set(stream, created);\n      entry = created;\n    }\n    const current = entry;\n    current.listeners.add(listener);\n    return {\n      ready: current.ready,\n      unsubscribe: () => {\n        current.listeners.delete(listener);\n        if (current.listeners.size > 0 || this.streams.get(stream) !== current) return;\n        this.streams.delete(stream);\n        if (current.subscriptionId) {\n          this.bySubscription.delete(current.subscriptionId);\n          void this.channel.events.off(current.subscriptionId);\n        }\n        if (this.streams.size === 0 && this.detach) {\n          this.detach();\n          this.detach = null;\n        }\n      },\n    };\n  }\n\n  private deliver(message: EventMessage): void {\n    const stream = this.bySubscription.get(message.subscriptionId);\n    if (!stream) return;\n    for (const l of [...(this.streams.get(stream)?.listeners ?? [])]) l(message.payload);\n  }\n}\n\n/**\n * `host.events` in the shape records' data layer listens on (`DataEvents`):\n * one `rows:<alias>` subscription at the host however many hooks listen.\n */\nexport function frameDataEvents(hub: EventHub): DataEvents {\n  return {\n    on(event, listener) {\n      return hub.subscribe(event, (payload) => listener(payload as RowsEvent)).unsubscribe;\n    },\n  };\n}\n\nfunction dataScopeFor(channel: AppletChannel, hub: EventHub): DataScope {\n  return { port: channel.data, portKey: channel.hostId, events: frameDataEvents(hub) };\n}\n\n// ─── the context ──────────────────────────────────────────────────────────\n\nexport type PageActionHandler = (input: unknown, ctx: ActionContext) => unknown | Promise<unknown>;\n\nexport interface FrameRenderers {\n  /** Renders a kind envelope's data. The real one comes from `@ai-matrx/content-ir-react`. */\n  renderKind?: (kind: string, value: unknown) => React.ReactNode;\n  /** Renders a table-built page from its `pages.definition`. */\n  renderDataPage?: (id: string, definition: unknown) => React.ReactNode;\n  /** Renders a nested Applet over its child host (`mountApplet` supplies this). */\n  renderApplet?: (child: AppletChannel) => React.ReactNode;\n  /** The component for one of the record's page files (`mountApplet` supplies this). */\n  pageComponent?: (file: string) => React.ComponentType<Record<string, unknown>> | null;\n}\n\nexport interface FrameContextValue extends FrameRenderers {\n  channel: AppletChannel;\n  hub: EventHub;\n  queryClient: QueryClient;\n  /**\n   * What records' data layer reads through: `port = host.data`, `events` =\n   * `host.events` over this frame's hub, `portKey = hostId` (so nested Applets\n   * never share a cache entry).\n   */\n  dataScope: DataScope;\n  /** Handlers `defineActions` registered for this frame's page Actions. */\n  actions: Map<string, PageActionHandler>;\n  parent: FrameContextValue | null;\n  /** False only for the detached stand-in a hook gets outside any frame. */\n  attached: boolean;\n}\n\n/**\n * The context object lives on `globalThis` so the ESM and CJS builds, and the\n * copies `/react` and `/frame` each carry, all share ONE context.\n */\nconst CONTEXT_KEY = Symbol.for(\"ai-matrx.applets.frameContext\");\nfunction frameContext(): React.Context<FrameContextValue | null> {\n  const g = globalThis as unknown as Record<symbol, React.Context<FrameContextValue | null> | undefined>;\n  let ctx = g[CONTEXT_KEY];\n  if (!ctx) {\n    ctx = React.createContext<FrameContextValue | null>(null);\n    ctx.displayName = \"AppletFrame\";\n    g[CONTEXT_KEY] = ctx;\n  }\n  return ctx;\n}\n\nexport function newQueryClient(): QueryClient {\n  return new QueryClient({\n    defaultOptions: {\n      // Events keep the cache true (rows:<alias>, value:<name>, run:<id>), so a key is requested once.\n      queries: { staleTime: Number.POSITIVE_INFINITY, retry: false, refetchOnWindowFocus: false, refetchOnReconnect: false },\n      mutations: { retry: false },\n    },\n  });\n}\n\n// ─── detached: what a hook gets outside every frame (it never throws) ─────\n\nconst DETACHED_KEY = Symbol.for(\"ai-matrx.applets.detached\");\nconst NO_FRAME: AppletError = {\n  code: \"no_frame\",\n  message: \"This part of the Applet is not inside an AppletFrame.\",\n  retryable: false,\n};\n\nconst NO_FRAME_DATA: RecordsError = { code: \"not_supported\", message: NO_FRAME.message, diagnostic: NO_FRAME.code };\n\nfunction detachedChannel(): AppletChannel {\n  const refuse = async <T,>(): Promise<Result<T>> => ({ ok: false, error: NO_FRAME });\n  const refuseData = async <T,>(): Promise<RecordsResult<T>> => ({ ok: false, error: NO_FRAME_DATA });\n  const reject = async <T,>(): Promise<T> => {\n    throw NO_FRAME;\n  };\n  return {\n    hostId: \"detached\",\n    viewer: reject<Viewer>,\n    record: reject<AppletRecord>,\n    child: reject<{ hostId: string }>,\n    kinds: { definition: refuse, component: refuse },\n    pages: { definition: refuse },\n    data: {\n      sources: refuseData,\n      columns: refuseData,\n      list: refuseData,\n      get: refuseData,\n      create: refuseData,\n      update: refuseData,\n      archive: refuseData,\n      restore: refuseData,\n    } satisfies DataPort,\n    intelligence: {\n      describe: refuse,\n      run: refuse,\n      result: refuse,\n      answer: refuse,\n      rejoin: refuse,\n      listRuns: refuse,\n      createSoft: refuse,\n    },\n    surface: {\n      mount: refuse,\n      unmount: async () => undefined,\n      getValue: async () => undefined,\n      setValue: reject<void>,\n      listActions: async () => [],\n      runAction: refuse,\n      completeAction: async () => undefined,\n    },\n    nav: { go: reject<void>, current: async (): Promise<NavLocation> => ({ path: [], params: {} }) },\n    events: { on: reject<{ subscriptionId: string }>, off: async () => undefined },\n    reportError: async () => undefined,\n    receive: () => () => undefined,\n    forHost: () => null,\n  };\n}\n\nfunction detachedFrame(): FrameContextValue {\n  const g = globalThis as unknown as Record<symbol, FrameContextValue | undefined>;\n  let frame = g[DETACHED_KEY];\n  if (!frame) {\n    const channel = detachedChannel();\n    const hub = new EventHub(channel);\n    frame = { channel, hub, queryClient: newQueryClient(), dataScope: dataScopeFor(channel, hub), actions: new Map(), parent: null, attached: false };\n    g[DETACHED_KEY] = frame;\n  }\n  return frame;\n}\n\n/** The frame a hook runs in; a refusing stand-in outside every frame. */\nexport function useFrame(): FrameContextValue {\n  return React.useContext(frameContext()) ?? detachedFrame();\n}\n\n/** The nearest frame, or null outside every frame. */\nexport function useOptionalFrame(): FrameContextValue | null {\n  return React.useContext(frameContext());\n}\n\n// ─── shared query keys ────────────────────────────────────────────────────\n\nexport const keys = {\n  root: (hostId: string) => [\"applets\", hostId] as const,\n  record: (hostId: string) => [\"applets\", hostId, \"record\"] as const,\n  viewer: (hostId: string) => [\"applets\", hostId, \"viewer\"] as const,\n  nav: (hostId: string) => [\"applets\", hostId, \"nav\"] as const,\n};\n\nexport function recordQuery(channel: AppletChannel) {\n  return { queryKey: keys.record(channel.hostId), queryFn: () => channel.record() };\n}\nexport function viewerQuery(channel: AppletChannel) {\n  return { queryKey: keys.viewer(channel.hostId), queryFn: () => channel.viewer() };\n}\n\n// ─── the frame live registry (for the context-free `navigate`) ───────────\n\nconst FRAMES_KEY = Symbol.for(\"ai-matrx.applets.frames\");\nexport function liveFrames(): FrameContextValue[] {\n  const g = globalThis as unknown as Record<symbol, FrameContextValue[] | undefined>;\n  let list = g[FRAMES_KEY];\n  if (!list) {\n    list = [];\n    g[FRAMES_KEY] = list;\n  }\n  return list;\n}\n\n// ─── <AppletFrame> ────────────────────────────────────────────────────────\n\nexport interface AppletFrameProps extends FrameRenderers {\n  host: AppletChannel;\n  /** Defaults to the parent frame's client, else a new one for this frame. */\n  queryClient?: QueryClient;\n  children?: React.ReactNode;\n}\n\n/**\n * Mounts one Applet: provides its host to every hook below, joins its surface\n * to the runtime chain (`applets/<id>` under the parent frame's surface), and\n * routes page-Action runs to the handlers `defineActions` registered.\n */\nexport function AppletFrame({ host, queryClient, children, ...renderers }: AppletFrameProps): React.ReactElement {\n  const parent = useOptionalFrame();\n  const Context = frameContext();\n  const [frame] = React.useState<FrameContextValue>(() => {\n    const hub = new EventHub(host);\n    const value: FrameContextValue = {\n      channel: host,\n      hub,\n      queryClient: queryClient ?? parent?.queryClient ?? newQueryClient(),\n      dataScope: dataScopeFor(host, hub),\n      actions: new Map(),\n      parent,\n      attached: true,\n    };\n    const inherit = <K extends keyof FrameRenderers>(key: K): void => {\n      const own = renderers[key] ?? (key === \"renderKind\" || key === \"renderDataPage\" ? parent?.[key] : undefined);\n      if (own !== undefined) value[key] = own as FrameContextValue[K];\n    };\n    inherit(\"renderKind\");\n    inherit(\"renderDataPage\");\n    inherit(\"renderApplet\");\n    inherit(\"pageComponent\");\n    return value;\n  });\n\n  // Register for `navigate`, join the surface chain, route page Actions.\n  React.useEffect(() => {\n    const frames = liveFrames();\n    frames.push(frame);\n    let cancelled = false;\n    let mountId: string | null = null;\n    void (async () => {\n      try {\n        const record = await frame.queryClient.fetchQuery(recordQuery(host));\n        const parentName = parent ? (await parent.queryClient.fetchQuery(recordQuery(parent.channel))).surfaceName : null;\n        if (cancelled) return;\n        const mounted = await host.surface.mount(record.surfaceName, parentName);\n        if (!mounted.ok) {\n          void host.reportError({ ...mounted.error, where: \"surface.mount\" });\n          return;\n        }\n        if (cancelled) void host.surface.unmount(mounted.data.mountId);\n        else mountId = mounted.data.mountId;\n      } catch (err) {\n        void host.reportError({ ...toAppletError(err), where: \"AppletFrame mount\" });\n      }\n    })();\n    const { unsubscribe } = frame.hub.subscribe(PAGE_ACTION_STREAM, (payload) => {\n      void routePageAction(frame, payload as PageActionEvent);\n    });\n    return () => {\n      cancelled = true;\n      unsubscribe();\n      if (mountId) void host.surface.unmount(mountId);\n      const i = frames.indexOf(frame);\n      if (i >= 0) frames.splice(i, 1);\n    };\n  }, [frame, host, parent]);\n\n  const { port, events, portKey } = frame.dataScope;\n  const body = (\n    <Context.Provider value={frame}>\n      <DataPortProvider port={port} portKey={portKey} queryClient={frame.queryClient} {...(events ? { events } : {})}>\n        {children}\n      </DataPortProvider>\n    </Context.Provider>\n  );\n  return parent?.queryClient === frame.queryClient ? body : <QueryClientProvider client={frame.queryClient}>{body}</QueryClientProvider>;\n}\n\nasync function routePageAction(frame: FrameContextValue, event: PageActionEvent): Promise<void> {\n  const { channel } = frame;\n  const handler = frame.actions.get(event.action);\n  if (!handler) {\n    await channel.surface.completeAction(event.runId, fail(\"action_unhandled\", `This page has no handler for \"${event.action}\".`));\n    return;\n  }\n  let viewerId: string | null = null;\n  try {\n    viewerId = (await frame.queryClient.fetchQuery(viewerQuery(channel))).userId;\n  } catch {\n    viewerId = null;\n  }\n  try {\n    const data = await handler(event.input, { runId: event.runId, by: event.by ?? \"applet\", viewerId });\n    await channel.surface.completeAction(event.runId, { ok: true, data });\n  } catch (err) {\n    await channel.surface.completeAction(event.runId, { ok: false, error: toAppletError(err) });\n  }\n}\n","/**\n * The Applets contract types (CONTRACTS v2 §0, §1, §3, §4, §6, §8).\n *\n * One owner per type. Types another package owns are RE-EXPORTED from it,\n * never redefined; types whose owner has not exported them yet are written\n * here structurally, each naming its owner and contract section, and are\n * replaced by a re-export the release the owner ships them.\n *\n * Framework-free: no React, no runtime imports. Every import below is a type.\n */\nimport type { EntityRefWithWords, Uuid as RecordsUuid } from \"@ai-matrx/records\";\nimport type { IntelligencePort as AgentsIntelligencePort } from \"@ai-matrx/agents/intelligence\";\nimport type { ActionResult, SurfacePort as AlchemySurfacePort } from \"@ai-matrx/alchemy/actions\";\nimport type { ScopeSpec } from \"@ai-matrx/code-runtime\";\nimport type { DataPort, DataSource, WhereClause } from \"@ai-matrx/records/data\";\nimport type { RecordsError } from \"@ai-matrx/records\";\n\n// ─── §0 — owned elsewhere, re-exported ─────────────────────────────────────\n\n/** `@ai-matrx/records` — a UUID string. */\nexport type Uuid = RecordsUuid;\n\n/** `@ai-matrx/records` (AP-3) — every link everywhere reads as `EntityRef[]` (`EntityRefWithWords`). */\nexport type EntityRef = EntityRefWithWords;\n\n/** `@ai-matrx/agents/intelligence` (AP-1). */\nexport type {\n  RunRef,\n  ServedInput,\n  RunEvent,\n  KindEnvelope,\n  MandateDescription,\n  RunRequest,\n  RunResult,\n  RunListing,\n  SoftMandateSpec,\n} from \"@ai-matrx/agents/intelligence\";\n\n/** `@ai-matrx/alchemy/actions` (AP-2). */\nexport type {\n  ActionDeclaration,\n  ActionInfo,\n  ActionContext,\n  ActionCaller,\n  ActionPolicy,\n  ActionRuns,\n} from \"@ai-matrx/alchemy/actions\";\n\n/** `@ai-matrx/code-runtime` (AP-5). */\nexport type { ScopeSpec, CompileResult, Finding } from \"@ai-matrx/code-runtime\";\n\n/**\n * `@ai-matrx/content-ir` — a registered kind slug. content-ir types it as a\n * plain string and exports no named alias; this is that string.\n */\nexport type KindRef = string;\n\n// ─── §0 — owned here ───────────────────────────────────────────────────────\n\n/**\n * The system's own sentence. Superset of `RecordsError` in the sense of the\n * contract: `code` + the store's `message`, plus `retryable`.\n */\nexport interface AppletError {\n  code: string;\n  message: string;\n  retryable: boolean;\n  diagnostic?: string;\n}\n\n/** Never throws: every port call and every hook write answers one of these. */\nexport type Result<T> = { ok: true; data: T } | { ok: false; error: AppletError };\n\nexport type Status = \"idle\" | \"loading\" | \"ready\" | \"saving\" | \"error\";\n\n// ─── §0/§4 — owned by @ai-matrx/records (AP-3), re-exported ──────────────\n//\n// AP-3 owns Column, Row, Values, Filter, Query, Page and DataPort (CONTRACTS\n// §0 and §4); `@ai-matrx/records/data` exports them. The frame sees only the\n// port (`DataPort`, no `subscribe`); `HostDataPort` is the host's producer\n// (amendment 2.2) and never crosses the channel.\n\nexport type {\n  Column,\n  Row,\n  Values,\n  Query,\n  Page,\n  DataPort,\n  HostDataPort,\n  RowsEvent,\n  DataSource,\n  DataEvents,\n  WhereClause,\n  WhereOp,\n  Lane,\n} from \"@ai-matrx/records/data\";\n\n/** CONTRACTS §4 one `where` clause — records' `WhereClause`. */\nexport type Filter = WhereClause;\n\n/** One source an Applet declared (CONTRACTS §2 `useSources`, §4 `sources()`) — records' `DataSource`. */\nexport type SourceInfo = DataSource;\n\n/** A refusal in the store's words (`RecordsError`) — what a DataPort answers. */\nexport type { RecordsError, RecordsResult } from \"@ai-matrx/records\";\n\n// ─── §3 / §6 — the ports as the host exposes them ──────────────────────────\n\n/**\n * CONTRACTS §3 `IntelligencePort` (owner `@ai-matrx/agents`, AP-1) as a host\n * port: the agents package's port minus its in-process `events` listener —\n * across the doorway, run events arrive on the host's `run:<requestId>`\n * stream instead (no port takes a function).\n */\nexport type IntelligencePort = Omit<AgentsIntelligencePort, \"events\">;\n\n/** CONTRACTS §6 `SurfacePort` (owner `@ai-matrx/alchemy`, AP-2). Events: `value:<name>`. */\nexport type SurfacePort = AlchemySurfacePort;\n\n/**\n * The payload of the `actions` event stream: a `runs: \"page\"` Action routed to\n * the frame (CONTRACTS §6). The frame answers with `surface.completeAction`.\n * `by` is a superset field so the handler's `ActionContext` is truthful.\n */\nexport interface PageActionEvent {\n  action: string;\n  input: unknown;\n  runId: string;\n  by?: \"person\" | \"agent\" | \"applet\" | \"automation\";\n}\n\n/** The stream page-Action runs arrive on. */\nexport const PAGE_ACTION_STREAM = \"actions\";\n/** The stream a host announces route changes on (payload: `NavLocation`). */\nexport const NAV_STREAM = \"nav\";\n\nexport const rowsStream = (alias: string): string => `rows:${alias}`;\nexport const runStream = (requestId: string): string => `run:${requestId}`;\nexport const valueStream = (name: string): string => `value:${name}`;\n\n/** Re-exported so hosts can type completeAction answers without importing alchemy. */\nexport type ActionAnswer<T = unknown> = ActionResult<T>;\n\n// ─── §8 — the Applet record ────────────────────────────────────────────────\n\nexport interface AppletPage {\n  path: string;\n  title: string;\n  file: string;\n  parent?: string;\n}\n\nexport interface AppletMandate {\n  alias: string;\n  key: string;\n}\n\nexport type AppletSource =\n  | { alias: string; table_id: Uuid; organization_id: Uuid }\n  | { alias: string; entity: string };\n\n/** CONTRACTS §8 `AppletRecord` (owner `@ai-matrx/applets`, AP-0). */\nexport interface AppletRecord {\n  id: Uuid;\n  version: number;\n  organizationId: Uuid;\n  slug: string;\n  published: boolean;\n  files: Record<string, string>;\n  entry: string;\n  scope: ScopeSpec;\n  pages: AppletPage[];\n  mandates: AppletMandate[];\n  sources: AppletSource[];\n  parentId: Uuid | null;\n  /** `applets/<id>` */\n  surfaceName: string;\n}\n\n// ─── §1 — the doorway ──────────────────────────────────────────────────────\n\nexport interface Viewer {\n  userId: Uuid | null;\n  organizationIds: Uuid[];\n  activeOrganizationId: Uuid | null;\n  guest: boolean;\n}\n\nexport interface NavLocation {\n  path: string[];\n  params: Record<string, string>;\n}\n\nexport interface KindComponentSource {\n  files: Record<string, string>;\n  entry: string;\n}\n\n/**\n * CONTRACTS §1 `AppletHost`. Every call is an async request with JSON in and\n * JSON out (kind envelopes allowed), scoped to ONE mounted Applet.\n */\nexport interface AppletHost {\n  viewer(): Promise<Viewer>;\n  record(): Promise<AppletRecord>;\n  child(appletId: Uuid): Promise<{ hostId: string }>;\n  kinds: {\n    definition(slug: string): Promise<Result<unknown>>;\n    component(slug: string, platform: string): Promise<Result<KindComponentSource | null>>;\n  };\n  pages: { definition(pageId: Uuid): Promise<Result<unknown>> };\n  data: DataPort;\n  intelligence: IntelligencePort;\n  surface: SurfacePort;\n  nav: { go(to: string): Promise<void>; current(): Promise<NavLocation> };\n  events: {\n    on(stream: string, filter: unknown): Promise<{ subscriptionId: string }>;\n    off(subscriptionId: string): Promise<void>;\n  };\n  reportError(err: AppletError & { where: string }): Promise<void>;\n}\n\n/** What the frame receives for each event (CONTRACTS §1). */\nexport interface EventMessage {\n  subscriptionId: string;\n  payload: unknown;\n}\n\n/**\n * The frame's side of the doorway: the contract's `AppletHost` plus the two\n * things §1 says the CHANNEL supplies — receiving `{ subscriptionId, payload }`\n * messages, and addressing a child host by the `hostId` that `child()` answered.\n * An in-page host implements these in memory; a sandbox host maps them onto a\n * message channel. Neither is a port: nothing here crosses the doorway as data.\n */\nexport interface AppletChannel extends AppletHost {\n  readonly hostId: string;\n  /** Subscribe to every event message for this host. Returns an unsubscribe. */\n  receive(listener: (message: EventMessage) => void): () => void;\n  /** The scoped host for a `hostId` that `child()` answered. */\n  forHost(hostId: string): AppletChannel | null;\n}\n\n// ─── helpers every half uses ───────────────────────────────────────────────\n\nexport function ok<T>(data: T): Result<T> {\n  return { ok: true, data };\n}\n\nexport function fail<T = never>(code: string, message: string, retryable = false, diagnostic?: string): Result<T> {\n  const error: AppletError = { code, message, retryable };\n  if (diagnostic !== undefined) error.diagnostic = diagnostic;\n  return { ok: false, error };\n}\n\n/**\n * A DataPort refusal (`RecordsError`) as the §0 `AppletError`: the store's code\n * and sentence verbatim, `retryable` true only where a second try could change\n * the answer (the call never reached the store, or ran out of time).\n */\nexport function fromRecordsError(error: RecordsError): AppletError {\n  const out: AppletError = { code: error.code, message: error.message, retryable: error.code === \"unreachable\" || error.code === \"timed_out\" };\n  if (error.diagnostic !== undefined) out.diagnostic = error.diagnostic;\n  return out;\n}\n\n/** Any thrown value → an `AppletError`, keeping a system sentence when there is one. */\nexport function toAppletError(err: unknown, code = \"internal\"): AppletError {\n  if (err && typeof err === \"object\") {\n    const o = err as Record<string, unknown>;\n    if (typeof o.code === \"string\" && typeof o.message === \"string\") {\n      const out: AppletError = { code: o.code, message: o.message, retryable: o.retryable === true };\n      if (typeof o.diagnostic === \"string\") out.diagnostic = o.diagnostic;\n      return out;\n    }\n    if (err instanceof Error) return { code, message: err.message, retryable: false };\n  }\n  return { code, message: String(err), retryable: false };\n}\n","/**\n * The data hooks (CONTRACTS §2, over §4's DataPort): `useRows`, `useRow`,\n * `useColumns`, `useSources` and their writes.\n *\n * ONE ENGINE, RECORDS'. Every hook here is a thin wrapper over\n * `@ai-matrx/records/data/react` (AP-3 owns the frame-side data layer, §4):\n * one cache entry and one request per key, keyset pages, optimistic writes\n * rolled back with the store's own sentence, every update carrying the row's\n * `_version`, and `rows:<alias>` events re-reading only the ids they name.\n * This file only reshapes records' answers into §2's (`status`, an\n * `AppletError`, `Result<T>`). `AppletFrame` mounts `DataPortProvider` with\n * `port = host.data`, `events = host.events` and `portKey = hostId`.\n */\nimport * as React from \"react\";\nimport {\n  useDataColumns,\n  useDataMutations,\n  useDataRow,\n  useDataRows,\n  useDataSources,\n  type DataMutations,\n  type DataScope,\n} from \"@ai-matrx/records/data/react\";\n\nimport type { AppletChannel, AppletError, Column, Query, RecordsResult, Result, Row, SourceInfo, Status, Uuid, Values } from \"../types\";\nimport { fromRecordsError, toAppletError } from \"../types\";\nimport { useFrame, type FrameContextValue } from \"./context\";\n\n/** A port answer → data, or the error thrown into Query (never into React). */\nasync function unwrap<T>(answer: Promise<Result<T>>): Promise<T> {\n  const r = await answer;\n  if (!r.ok) throw r.error;\n  return r.data;\n}\n\nfunction asAppletError(err: unknown): AppletError | null {\n  return err == null ? null : toAppletError(err);\n}\n\nfunction queryStatus(q: { status: \"pending\" | \"error\" | \"success\"; fetchStatus: \"fetching\" | \"paused\" | \"idle\" }, saving: boolean): Status {\n  if (q.status === \"error\") return \"error\";\n  if (saving) return \"saving\";\n  if (q.status === \"pending\") return q.fetchStatus === \"idle\" ? \"idle\" : \"loading\";\n  return \"ready\";\n}\n\nfunction toResult<T>(answer: RecordsResult<T>): Result<T> {\n  return answer.ok ? answer : { ok: false, error: fromRecordsError(answer.error) };\n}\n\n/** Outside every frame there is no DataPortProvider: the detached stand-in's port is passed explicitly. */\nfunction scopeOf(frame: FrameContextValue): DataScope | undefined {\n  return frame.attached ? undefined : frame.dataScope;\n}\n\nfunction readStatus(loading: boolean, failed: boolean, saving: boolean): Status {\n  if (failed) return \"error\";\n  if (saving) return \"saving\";\n  return loading ? \"loading\" : \"ready\";\n}\n\n// ─── the writer every data hook shares ───────────────────────────────────\n\ninterface Writer {\n  saving: boolean;\n  error: AppletError | null;\n  create(values: Values): Promise<Result<Row>>;\n  update(id: Uuid, patch: Values, baseVersion?: number): Promise<Result<Row>>;\n  archive(id: Uuid): Promise<Result<void>>;\n  restore(id: Uuid): Promise<Result<void>>;\n}\n\n/** Records' optimistic mutations, answered as `Result` and tracked for `status` / `error`. */\nfunction useWriter(frame: FrameContextValue, alias: string): Writer {\n  const mutations: DataMutations = useDataMutations(alias, scopeOf(frame));\n  const [pending, setPending] = React.useState(0);\n  const [writeError, setWriteError] = React.useState<AppletError | null>(null);\n\n  const track = async <T,>(work: () => Promise<RecordsResult<T>>): Promise<Result<T>> => {\n    setPending((n) => n + 1);\n    try {\n      const answer = toResult(await work());\n      setWriteError(answer.ok ? null : answer.error);\n      return answer;\n    } catch (err) {\n      const error = toAppletError(err);\n      setWriteError(error);\n      return { ok: false, error };\n    } finally {\n      setPending((n) => n - 1);\n    }\n  };\n\n  return {\n    saving: pending > 0,\n    error: writeError,\n    create: (values) => track(() => mutations.create(values)),\n    update: (id, patch, baseVersion) =>\n      track(async () => {\n        if (baseVersion !== undefined) return mutations.update(id, patch, { baseVersion });\n        // Records sends the version a loaded page drew; a row this frame never drew is read first.\n        const first = await mutations.update(id, patch);\n        if (first.ok || first.error.code !== \"stale_read\") return first;\n        const read = await frame.channel.data.get(alias, id);\n        if (!read.ok) return read;\n        if (!read.data) return { ok: false, error: { code: \"not_found\", message: \"This record is not here any more.\" } };\n        return mutations.update(id, patch, { baseVersion: read.data._version });\n      }),\n    archive: (id) => track(() => mutations.archive(id)),\n    restore: (id) => track(() => mutations.restore(id)),\n  };\n}\n\n// ─── hooks ────────────────────────────────────────────────────────────────\n\nexport interface RowsState {\n  rows: Row[];\n  total: number | null;\n  status: Status;\n  error: AppletError | null;\n  hasMore: boolean;\n  loadMore(): void;\n  /** Rows others wrote that belong somewhere in this (deep, filtered or sorted) list; `refresh()` reads them in. */\n  newer: number;\n  /** Read this list again from the store. */\n  refresh(): void;\n  create(values: Values): Promise<Result<Row>>;\n  update(id: Uuid, patch: Values): Promise<Result<Row>>;\n  archive(id: Uuid): Promise<Result<void>>;\n  restore(id: Uuid): Promise<Result<void>>;\n}\n\n/** The rows of one declared source (an alias), paged by keyset cursor. */\nexport function useRows(source: string, q?: Query): RowsState {\n  const frame = useFrame();\n  const list = useDataRows(source, q ?? {}, scopeOf(frame));\n  const writer = useWriter(frame, source);\n  return {\n    rows: list.rows,\n    total: list.total,\n    status: readStatus(list.loading, list.error !== null, writer.saving),\n    error: (list.error ? fromRecordsError(list.error) : null) ?? writer.error,\n    hasMore: list.hasMore,\n    loadMore: list.loadMore,\n    newer: list.newer,\n    refresh: list.refresh,\n    create: writer.create,\n    update: (id, patch) => writer.update(id, patch, list.rows.find((r) => r._id === id)?._version),\n    archive: writer.archive,\n    restore: writer.restore,\n  };\n}\n\nexport interface RowState {\n  row: Row | null;\n  status: Status;\n  error: AppletError | null;\n  update(patch: Values): Promise<Result<Row>>;\n  archive(): Promise<Result<void>>;\n  /** Read this row again from the store. */\n  refresh(): void;\n}\n\n/** One row of a source, sharing the list caches (an update shows in both). */\nexport function useRow(source: string, id: Uuid): RowState {\n  const frame = useFrame();\n  const one = useDataRow(source, id, scopeOf(frame));\n  const writer = useWriter(frame, source);\n  const row = one.data ?? null;\n  return {\n    row,\n    status: readStatus(one.loading, one.error !== null, writer.saving),\n    error: (one.error ? fromRecordsError(one.error) : null) ?? writer.error,\n    update: (patch) => writer.update(id, patch, row?._version),\n    archive: () => writer.archive(id),\n    refresh: one.refresh,\n  };\n}\n\nexport interface ColumnsState {\n  columns: Column[];\n  status: Status;\n  error: AppletError | null;\n}\n\nexport function useColumns(source: string): ColumnsState {\n  const frame = useFrame();\n  const q = useDataColumns(source, scopeOf(frame));\n  return { columns: q.data ?? [], status: readStatus(q.loading, q.error !== null, false), error: q.error ? fromRecordsError(q.error) : null };\n}\n\nexport interface SourcesState {\n  sources: SourceInfo[];\n  status: Status;\n  error: AppletError | null;\n}\n\nexport function useSources(): SourcesState {\n  const frame = useFrame();\n  const q = useDataSources(scopeOf(frame));\n  return { sources: q.data ?? [], status: readStatus(q.loading, q.error !== null, false), error: q.error ? fromRecordsError(q.error) : null };\n}\n\nexport { unwrap, queryStatus, asAppletError };\nexport type { AppletChannel };\n","/**\n * The intelligence hooks (CONTRACTS §2, over §3's IntelligencePort): `useJob`\n * runs one of the Applet's declared jobs by ALIAS (the record's `mandates`\n * maps alias → key) and streams it through the host's `run:<requestId>`\n * events; `useJobs` lists them.\n */\nimport * as React from \"react\";\nimport { useQuery } from \"@tanstack/react-query\";\n\nimport type { AppletError, KindEnvelope, Result, RunEvent, RunRef, ServedInput } from \"../types\";\nimport { runStream, toAppletError } from \"../types\";\nimport { recordQuery, useFrame, viewerQuery } from \"./context\";\nimport { asAppletError, queryStatus, unwrap } from \"./data\";\nimport type { Status } from \"../types\";\n\nexport type JobStatus = \"idle\" | \"resolving\" | \"running\" | \"needs_input\" | \"done\" | \"error\";\n\nexport interface JobRun {\n  ref: RunRef;\n  startedAt: string;\n  status: string;\n}\n\nexport interface JobState {\n  run(variables?: Record<string, unknown>, opts?: { userInput?: string }): Promise<Result<RunRef>>;\n  status: JobStatus;\n  error: AppletError | null;\n  text: string;\n  result: KindEnvelope | null;\n  inputs: ServedInput[];\n  answer(values: Record<string, unknown>): Promise<Result<void>>;\n  runs: JobRun[];\n}\n\ninterface RunState {\n  status: JobStatus;\n  error: AppletError | null;\n  text: string;\n  result: KindEnvelope | null;\n  inputs: ServedInput[];\n}\n\nconst IDLE: RunState = { status: \"idle\", error: null, text: \"\", result: null, inputs: [] };\nconst TERMINAL = new Set([\"done\", \"complete\", \"completed\", \"succeeded\", \"success\"]);\n\ntype Action =\n  | { type: \"reset\"; status: JobStatus }\n  | { type: \"event\"; event: RunEvent }\n  | { type: \"fail\"; error: AppletError }\n  | { type: \"status\"; status: JobStatus }\n  | { type: \"catch-up\"; text: string; envelope: KindEnvelope | null };\n\nfunction reduce(state: RunState, action: Action): RunState {\n  switch (action.type) {\n    case \"reset\":\n      return { ...IDLE, status: action.status };\n    case \"fail\":\n      return { ...state, status: \"error\", error: action.error };\n    case \"status\":\n      return { ...state, status: action.status };\n    case \"catch-up\":\n      if (state.status === \"done\") return state;\n      return { ...state, status: \"done\", result: action.envelope, text: state.text || action.text };\n    case \"event\": {\n      const e = action.event;\n      switch (e.type) {\n        case \"text\":\n          return { ...state, text: state.text + e.delta };\n        case \"status\":\n          if (TERMINAL.has(e.status)) return { ...state, status: \"done\" };\n          if (e.status === \"error\" || e.status === \"failed\") return { ...state, status: \"error\" };\n          return state.status === \"done\" ? state : { ...state, status: \"running\" };\n        case \"needs_input\":\n          return { ...state, status: \"needs_input\", inputs: e.inputs };\n        case \"result\":\n          return { ...state, status: \"done\", result: e.envelope };\n        case \"error\":\n          return { ...state, status: \"error\", error: e.error };\n      }\n    }\n  }\n  return state;\n}\n\nconst runsKey = (hostId: string, key: string) => [\"applets\", hostId, \"runs\", key] as const;\n\n/** Run one declared job by alias; stream its text, typed result and questions. */\nexport function useJob(alias: string): JobState {\n  const frame = useFrame();\n  const { channel, queryClient: qc, hub } = frame;\n  const [state, dispatch] = React.useReducer(reduce, IDLE);\n  const refRef = React.useRef<RunRef | null>(null);\n  const unsubscribeRef = React.useRef<(() => void) | null>(null);\n\n  React.useEffect(\n    () => () => {\n      unsubscribeRef.current?.();\n      unsubscribeRef.current = null;\n    },\n    [],\n  );\n\n  const record = useQuery({ ...recordQuery(channel) }, qc);\n  const key = record.data?.mandates.find((m) => m.alias === alias)?.key ?? null;\n  const appletId = record.data?.id;\n  const runs = useQuery<JobRun[], AppletError>(\n    {\n      queryKey: runsKey(channel.hostId, key ?? \"\"),\n      queryFn: () => unwrap(channel.intelligence.listRuns(key ?? \"\", appletId)),\n      enabled: key !== null,\n    },\n    qc,\n  );\n\n  const run = async (variables?: Record<string, unknown>, opts?: { userInput?: string }): Promise<Result<RunRef>> => {\n    unsubscribeRef.current?.();\n    unsubscribeRef.current = null;\n    dispatch({ type: \"reset\", status: \"resolving\" });\n    try {\n      const rec = await qc.fetchQuery(recordQuery(channel));\n      const mandate = rec.mandates.find((m) => m.alias === alias);\n      if (!mandate) {\n        const error: AppletError = { code: \"job_not_found\", message: `This Applet has no job named \"${alias}\".`, retryable: false };\n        dispatch({ type: \"fail\", error });\n        return { ok: false, error };\n      }\n      const viewer = await qc.fetchQuery(viewerQuery(channel));\n      const req: Parameters<typeof channel.intelligence.run>[0] = {\n        key: mandate.key,\n        organizationId: viewer.activeOrganizationId,\n        appletId: rec.id,\n        surfaceName: rec.surfaceName,\n      };\n      if (variables !== undefined) req.variables = variables;\n      if (opts?.userInput !== undefined) req.userInput = opts.userInput;\n      const started = await channel.intelligence.run(req);\n      if (!started.ok) {\n        dispatch({ type: \"fail\", error: started.error });\n        return started;\n      }\n      const ref = started.data;\n      refRef.current = ref;\n      dispatch({ type: \"status\", status: \"running\" });\n      let finished = false;\n      const sub = hub.subscribe(runStream(ref.requestId), (payload) => {\n        const event = payload as RunEvent;\n        dispatch({ type: \"event\", event });\n        if (!finished && (event.type === \"result\" || event.type === \"error\" || (event.type === \"status\" && TERMINAL.has(event.status)))) {\n          finished = true;\n          void qc.invalidateQueries({ queryKey: runsKey(channel.hostId, mandate.key) });\n        }\n      });\n      unsubscribeRef.current = sub.unsubscribe;\n      await sub.ready;\n      // Anything that finished before the subscription landed is read once.\n      const now = await channel.intelligence.result(ref);\n      if (now.ok && !finished && (now.data.envelope !== null || TERMINAL.has(now.data.status))) {\n        finished = true;\n        dispatch({ type: \"catch-up\", text: now.data.text, envelope: now.data.envelope });\n      }\n      void qc.invalidateQueries({ queryKey: runsKey(channel.hostId, mandate.key) });\n      return started;\n    } catch (err) {\n      const error = toAppletError(err);\n      dispatch({ type: \"fail\", error });\n      return { ok: false, error };\n    }\n  };\n\n  const answer = async (values: Record<string, unknown>): Promise<Result<void>> => {\n    const ref = refRef.current;\n    if (!ref) return { ok: false, error: { code: \"no_run\", message: \"There is no run waiting for an answer.\", retryable: false } };\n    dispatch({ type: \"status\", status: \"running\" });\n    const answered = await channel.intelligence.answer(ref, values);\n    if (!answered.ok) dispatch({ type: \"fail\", error: answered.error });\n    return answered;\n  };\n\n  return { run, answer, runs: runs.data ?? [], ...state };\n}\n\nexport interface JobInfo {\n  alias: string;\n  key: string;\n  label: string;\n  goal: string;\n  outputKind: string | null;\n}\n\nexport interface JobsState {\n  jobs: JobInfo[];\n  status: Status;\n  error: AppletError | null;\n}\n\n/** Every job the Applet declares, described by the server. */\nexport function useJobs(): JobsState {\n  const { channel, queryClient } = useFrame();\n  const q = useQuery<JobInfo[], AppletError>(\n    {\n      queryKey: [\"applets\", channel.hostId, \"jobs\"],\n      queryFn: async () => {\n        const rec = await queryClient.fetchQuery(recordQuery(channel));\n        return Promise.all(\n          rec.mandates.map(async (m): Promise<JobInfo> => {\n            const d = await channel.intelligence.describe(m.key);\n            if (!d.ok) throw d.error;\n            return { alias: m.alias, key: m.key, label: d.data.label, goal: d.data.goal, outputKind: d.data.outputKind };\n          }),\n        );\n      },\n    },\n    queryClient,\n  );\n  return { jobs: q.data ?? [], status: queryStatus(q, false), error: asAppletError(q.error) };\n}\n","/**\n * Surface hooks (CONTRACTS §2, over §6's SurfacePort): `useValue` (a frame-side\n * mirror; writes reach the host asynchronously), `useAction` (run an Action by\n * name), and `defineActions` (this Applet's `runs: \"page\"` handlers — the frame\n * routes each page-Action run to them and answers with `completeAction`).\n */\nimport * as React from \"react\";\nimport { useQuery } from \"@tanstack/react-query\";\n\nimport type { AppletError, Result, Status } from \"../types\";\nimport { toAppletError, valueStream } from \"../types\";\nimport { useFrame, type PageActionHandler } from \"./context\";\n\nconst valueKey = (hostId: string, name: string) => [\"applets\", hostId, \"value\", name] as const;\n\n/** A surface value: `[value, set]`. `set` shows at once and is written to the host after. */\nexport function useValue<T>(name: string): [T, (next: T) => void] {\n  const frame = useFrame();\n  const { channel, queryClient: qc, hub } = frame;\n  const q = useQuery<unknown>({ queryKey: valueKey(channel.hostId, name), queryFn: async () => (await channel.surface.getValue(name)) ?? null }, qc);\n  React.useEffect(() => {\n    const { unsubscribe } = hub.subscribe(valueStream(name), (payload) => {\n      qc.setQueryData(valueKey(channel.hostId, name), payload ?? null);\n    });\n    return unsubscribe;\n  }, [hub, qc, channel, name]);\n  const set = (next: T): void => {\n    qc.setQueryData(valueKey(channel.hostId, name), next);\n    channel.surface.setValue(name, next).catch((err: unknown) => {\n      void channel.reportError({ ...toAppletError(err), where: `setValue(${name})` });\n    });\n  };\n  return [(q.data ?? undefined) as T, set];\n}\n\nexport interface ActionState {\n  run(input?: unknown): Promise<Result<unknown>>;\n  status: Status;\n  error: AppletError | null;\n}\n\n/**\n * Run an Action on this Applet's surface chain by name. A press in Applet code\n * is a person's, so runs are `by: \"person\"` unless the caller says otherwise.\n */\nexport function useAction(name: string, options?: { by?: \"person\" | \"agent\" | \"applet\" | \"automation\" }): ActionState {\n  const { channel } = useFrame();\n  const [status, setStatus] = React.useState<Status>(\"idle\");\n  const [error, setError] = React.useState<AppletError | null>(null);\n  const run = async (input?: unknown): Promise<Result<unknown>> => {\n    setStatus(\"loading\");\n    try {\n      const answer = await channel.surface.runAction(name, input ?? null, options?.by ?? \"person\");\n      if (answer.ok) {\n        setError(null);\n        setStatus(\"ready\");\n        return answer;\n      }\n      const err: AppletError = { code: answer.error.code, message: answer.error.message, retryable: answer.error.retryable };\n      if (answer.error.diagnostic !== undefined) err.diagnostic = answer.error.diagnostic;\n      setError(err);\n      setStatus(\"error\");\n      return { ok: false, error: err };\n    } catch (thrown) {\n      const err = toAppletError(thrown);\n      setError(err);\n      setStatus(\"error\");\n      return { ok: false, error: err };\n    }\n  };\n  return { run, status, error };\n}\n\n/**\n * This Applet's page-Action handlers. Call it in a component body under the\n * frame (it registers on mount and on every render, and leaves on unmount).\n */\nexport function defineActions(handlers: Record<string, PageActionHandler>): void {\n  const frame = useFrame();\n  const latest = React.useRef(handlers);\n  latest.current = handlers;\n  const names = Object.keys(handlers).sort().join(\"\\u0000\");\n  React.useEffect(() => {\n    const registered = names.split(\"\\u0000\").filter(Boolean);\n    for (const name of registered) {\n      frame.actions.set(name, (input, ctx) => {\n        const handler = latest.current[name];\n        if (!handler) throw { code: \"action_unhandled\", message: `This page has no handler for \"${name}\".`, retryable: false };\n        return handler(input, ctx);\n      });\n    }\n    return () => {\n      for (const name of registered) frame.actions.delete(name);\n    };\n  }, [frame, names]);\n}\n","/**\n * Navigation and pages (CONTRACTS §2): `usePage`, `navigate`, `<Link>`, and\n * `<Pages layout>` — the optional helper over the record's page list. An Applet\n * is never limited to one page: tabs, a sidebar or a menu, or none at all.\n */\nimport * as React from \"react\";\nimport { useQuery } from \"@tanstack/react-query\";\nimport { Select, Tabs } from \"@ai-matrx/design-system/controls\";\n\nimport type { AppletPage, NavLocation } from \"../types\";\nimport { NAV_STREAM, toAppletError } from \"../types\";\nimport { keys, liveFrames, recordQuery, useFrame, type FrameContextValue } from \"./context\";\n\nfunction parse(to: string): NavLocation {\n  const [pathPart = \"\", queryPart = \"\"] = to.split(\"?\");\n  const params: Record<string, string> = {};\n  for (const pair of queryPart.split(\"&\").filter(Boolean)) {\n    const [k = \"\", v = \"\"] = pair.split(\"=\");\n    params[decodeURIComponent(k)] = decodeURIComponent(v);\n  }\n  return { path: pathPart.split(\"/\").filter(Boolean), params };\n}\n\nfunction go(frame: FrameContextValue, to: string): void {\n  // Shown at once; the host's answer (and its `nav` events) keep it true.\n  frame.queryClient.setQueryData(keys.nav(frame.channel.hostId), parse(to));\n  frame.channel.nav.go(to).catch((err: unknown) => {\n    void frame.channel.reportError({ ...toAppletError(err), where: `nav.go(${to})` });\n  });\n}\n\n/**\n * Go somewhere. Outside a component it uses the outermost mounted frame (the\n * page's route); inside one, `usePage().navigate` is bound to its own frame.\n * With no frame mounted it says so in the console and does nothing.\n */\nexport function navigate(to: string): void {\n  const roots = liveFrames().filter((f) => f.parent === null);\n  const frame = roots[roots.length - 1];\n  if (!frame) {\n    console.error(`[applets] navigate(\"${to}\") was called with no AppletFrame mounted.`);\n    return;\n  }\n  go(frame, to);\n}\n\nfunction useLocation(frame: FrameContextValue): NavLocation {\n  const { channel, queryClient: qc, hub } = frame;\n  const q = useQuery({ queryKey: keys.nav(channel.hostId), queryFn: () => channel.nav.current() }, qc);\n  React.useEffect(() => {\n    const { unsubscribe } = hub.subscribe(NAV_STREAM, (payload) => {\n      qc.setQueryData(keys.nav(channel.hostId), payload as NavLocation);\n    });\n    return unsubscribe;\n  }, [hub, qc, channel]);\n  return q.data ?? { path: [], params: {} };\n}\n\nfunction segments(path: string): string[] {\n  return path.split(\"/\").filter(Boolean);\n}\n\n/** The page whose path matches (`:name` segments capture params); most specific wins. */\nexport function matchPage(pages: readonly AppletPage[], path: readonly string[]): { page: AppletPage; params: Record<string, string> } | null {\n  let best: { page: AppletPage; params: Record<string, string>; score: number } | null = null;\n  for (const page of pages) {\n    const want = segments(page.path);\n    if (want.length !== path.length) continue;\n    const params: Record<string, string> = {};\n    let score = 0;\n    let hit = true;\n    want.forEach((w, i) => {\n      const got = path[i] ?? \"\";\n      if (w.startsWith(\":\")) params[w.slice(1)] = got;\n      else if (w === got) score += 1;\n      else hit = false;\n    });\n    if (hit && (!best || score > best.score)) best = { page, params, score };\n  }\n  return best ? { page: best.page, params: best.params } : null;\n}\n\nexport interface PageState {\n  path: string[];\n  page: { path: string; title: string };\n  params: Record<string, string>;\n  /** Bound to this frame (superset of the contract). */\n  navigate(to: string): void;\n}\n\nexport function usePage(): PageState {\n  const frame = useFrame();\n  const location = useLocation(frame);\n  const record = useQuery({ ...recordQuery(frame.channel) }, frame.queryClient);\n  const pages = record.data?.pages ?? [];\n  const matched = matchPage(pages, location.path) ?? (location.path.length === 0 && pages[0] ? { page: pages[0], params: {} } : null);\n  return {\n    path: location.path,\n    page: matched ? { path: matched.page.path, title: matched.page.title } : { path: `/${location.path.join(\"/\")}`, title: \"\" },\n    params: { ...location.params, ...(matched?.params ?? {}) },\n    navigate: (to) => go(frame, to),\n  };\n}\n\nexport interface LinkProps extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, \"href\"> {\n  to: string;\n}\n\nexport function Link({ to, onClick, children, ...rest }: LinkProps): React.ReactElement {\n  const frame = useFrame();\n  return (\n    <a\n      {...rest}\n      href={to}\n      onClick={(event) => {\n        onClick?.(event);\n        if (event.defaultPrevented || event.button !== 0 || event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) return;\n        event.preventDefault();\n        go(frame, to);\n      }}\n    >\n      {children}\n    </a>\n  );\n}\n\nexport type PagesLayout = \"tabs\" | \"sidebar\" | \"menu\" | \"none\";\n\nexport interface PagesProps {\n  layout?: PagesLayout;\n  /** Page components by file, when no `mountApplet` frame supplies them. */\n  components?: Record<string, React.ComponentType<Record<string, unknown>>>;\n}\n\n/** The top-level page a page belongs to (itself, or its parent chain's root). */\nfunction topOf(pages: readonly AppletPage[], page: AppletPage): AppletPage {\n  let current = page;\n  for (let guard = 0; current.parent && guard < pages.length; guard += 1) {\n    const up = pages.find((p) => p.path === current.parent);\n    if (!up) break;\n    current = up;\n  }\n  return current;\n}\n\n/** The record's pages with a navigation layout, rendering the page the route matches. */\nexport function Pages({ layout = \"tabs\", components }: PagesProps): React.ReactElement {\n  const frame = useFrame();\n  const location = useLocation(frame);\n  const record = useQuery({ ...recordQuery(frame.channel) }, frame.queryClient);\n  const pages = record.data?.pages ?? [];\n  const top = pages.filter((p) => !p.parent);\n  const matched = matchPage(pages, location.path)?.page ?? (location.path.length === 0 ? top[0] : undefined);\n  const selected = matched ? topOf(pages, matched).path : null;\n  const open = (path: string): void => go(frame, path);\n\n  const Component = matched ? (components?.[matched.file] ?? frame.pageComponent?.(matched.file) ?? null) : null;\n  const body = matched ? (\n    Component ? (\n      <Component />\n    ) : (\n      <div data-applet-stand-in=\"page\" className=\"text-sm text-muted-foreground\">\n        Page file {matched.file} is not compiled in this frame\n      </div>\n    )\n  ) : record.isPending ? null : (\n    <div data-applet-stand-in=\"no-page\" className=\"text-sm text-muted-foreground\">\n      No page at /{location.path.join(\"/\")}\n    </div>\n  );\n\n  let navigation: React.ReactNode = null;\n  if (layout === \"tabs\" && top.length > 0) {\n    navigation = <Tabs aria-label=\"Pages\" value={selected} onValueChange={open} data={top.map((p) => ({ value: p.path, label: p.title }))} />;\n  } else if (layout === \"menu\" && top.length > 0) {\n    navigation = <Select aria-label=\"Pages\" value={selected ?? top[0]?.path ?? \"\"} onValueChange={open} options={top.map((p) => ({ value: p.path, label: p.title }))} />;\n  } else if (layout === \"sidebar\") {\n    navigation = (\n      <nav aria-label=\"Pages\" className=\"flex w-48 shrink-0 flex-col gap-1 border-r border-border p-2\">\n        {top.map((p) => (\n          <button\n            key={p.path}\n            type=\"button\"\n            aria-current={p.path === selected ? \"page\" : undefined}\n            data-state={p.path === selected ? \"on\" : \"off\"}\n            className=\"rounded-md px-2 py-1 text-left text-sm text-foreground data-[state=off]:text-muted-foreground data-[state=on]:bg-muted\"\n            onClick={() => open(p.path)}\n          >\n            {p.title}\n          </button>\n        ))}\n      </nav>\n    );\n  }\n\n  return (\n    <div data-applet-pages={layout} className={layout === \"sidebar\" ? \"flex h-full min-h-0\" : \"flex h-full min-h-0 flex-col\"}>\n      {navigation}\n      <div className=\"min-h-0 flex-1\">{body}</div>\n    </div>\n  );\n}\n","/**\n * Nesting and kinds (CONTRACTS §2): `<Applet id>` mounts a nested Applet over\n * its own child host (`host.child`), so names never collide across nesting;\n * `<Kind>` and `<DataPage>` delegate to renderers the frame's host supplies.\n * Each one renders a visible stand-in when its renderer is absent — never\n * nothing.\n */\nimport * as React from \"react\";\n\nimport type { AppletChannel, AppletError } from \"../types\";\nimport { toAppletError } from \"../types\";\nimport { useFrame } from \"./context\";\n\nfunction StandIn({ what, children }: { what: string; children: React.ReactNode }): React.ReactElement {\n  return (\n    <div data-applet-stand-in={what} className=\"rounded-md border border-dashed border-border p-2 text-sm text-muted-foreground\">\n      {children}\n    </div>\n  );\n}\n\nexport interface AppletProps {\n  id: string;\n}\n\n/** A nested Applet, on its own scoped host. */\nexport function Applet({ id }: AppletProps): React.ReactElement {\n  const frame = useFrame();\n  const [child, setChild] = React.useState<AppletChannel | null>(null);\n  const [error, setError] = React.useState<AppletError | null>(null);\n  React.useEffect(() => {\n    let cancelled = false;\n    frame.channel.child(id).then(\n      ({ hostId }) => {\n        if (cancelled) return;\n        const scoped = frame.channel.forHost(hostId);\n        if (scoped) setChild(scoped);\n        else setError({ code: \"host_not_found\", message: `The host for Applet ${id} did not answer.`, retryable: true });\n      },\n      (err: unknown) => {\n        if (!cancelled) setError(toAppletError(err));\n      },\n    );\n    return () => {\n      cancelled = true;\n    };\n  }, [frame, id]);\n  if (error) return <StandIn what=\"applet-error\">{error.message}</StandIn>;\n  if (!child) return <div data-applet-loading={id} aria-busy=\"true\" />;\n  if (!frame.renderApplet) return <StandIn what=\"applet\">Applet {id} needs mountApplet to render</StandIn>;\n  return <>{frame.renderApplet(child)}</>;\n}\n\nexport interface KindProps {\n  kind: string;\n  value: unknown;\n}\n\n/**\n * A kind, rendered in the frame. The real renderer comes from\n * `@ai-matrx/content-ir-react` and is handed to `<AppletFrame renderKind>` by\n * the host; this component only delegates to it.\n */\nexport function Kind({ kind, value }: KindProps): React.ReactElement {\n  const frame = useFrame();\n  if (frame.renderKind) return <>{frame.renderKind(kind, value)}</>;\n  return <StandIn what={`kind:${kind}`}>No renderer for kind {kind} in this frame</StandIn>;\n}\n\nexport interface DataPageProps {\n  id: string;\n}\n\n/** A table-built page, by id, rendered by the host's `renderDataPage`. */\nexport function DataPage({ id }: DataPageProps): React.ReactElement {\n  const frame = useFrame();\n  const [state, setState] = React.useState<{ definition: unknown } | { error: AppletError } | null>(null);\n  React.useEffect(() => {\n    let cancelled = false;\n    void frame.channel.pages.definition(id).then((r) => {\n      if (!cancelled) setState(r.ok ? { definition: r.data } : { error: r.error });\n    });\n    return () => {\n      cancelled = true;\n    };\n  }, [frame, id]);\n  if (!state) return <div data-applet-loading={id} aria-busy=\"true\" />;\n  if (\"error\" in state) return <StandIn what=\"data-page-error\">{state.error.message}</StandIn>;\n  if (!frame.renderDataPage) return <StandIn what=\"data-page\">Page {id} needs a host page renderer</StandIn>;\n  return <>{frame.renderDataPage(id, state.definition)}</>;\n}\n"],"mappings":"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","names":["React","import_react","React","import_react_query","React","import_react_query","React","import_react_query","import_jsx_runtime","React","import_jsx_runtime"]}

package/dist/react.d.cts

@@ -0,0 +1,178 @@
+import { S as Status, A as AppletError, R as Result, U as Uuid, c as SourceInfo, P as PageActionHandler, d as AppletPage } from './context-Dz3PWsJd.cjs';
+export { e as AppletFrame, f as AppletFrameProps, F as FrameRenderers, n as newQueryClient } from './context-Dz3PWsJd.cjs';
+import { Column, Row, Values, Query } from '@ai-matrx/records/data';
+import { RunRef, KindEnvelope, ServedInput } from '@ai-matrx/agents/intelligence';
+import * as React from 'react';
+import '@tanstack/react-query';
+import '@ai-matrx/records';
+import '@ai-matrx/alchemy/actions';
+import '@ai-matrx/code-runtime';
+
+interface RowsState {
+    rows: Row[];
+    total: number | null;
+    status: Status;
+    error: AppletError | null;
+    hasMore: boolean;
+    loadMore(): void;
+    /** Rows others wrote that belong somewhere in this (deep, filtered or sorted) list; `refresh()` reads them in. */
+    newer: number;
+    /** Read this list again from the store. */
+    refresh(): void;
+    create(values: Values): Promise<Result<Row>>;
+    update(id: Uuid, patch: Values): Promise<Result<Row>>;
+    archive(id: Uuid): Promise<Result<void>>;
+    restore(id: Uuid): Promise<Result<void>>;
+}
+/** The rows of one declared source (an alias), paged by keyset cursor. */
+declare function useRows(source: string, q?: Query): RowsState;
+interface RowState {
+    row: Row | null;
+    status: Status;
+    error: AppletError | null;
+    update(patch: Values): Promise<Result<Row>>;
+    archive(): Promise<Result<void>>;
+    /** Read this row again from the store. */
+    refresh(): void;
+}
+/** One row of a source, sharing the list caches (an update shows in both). */
+declare function useRow(source: string, id: Uuid): RowState;
+interface ColumnsState {
+    columns: Column[];
+    status: Status;
+    error: AppletError | null;
+}
+declare function useColumns(source: string): ColumnsState;
+interface SourcesState {
+    sources: SourceInfo[];
+    status: Status;
+    error: AppletError | null;
+}
+declare function useSources(): SourcesState;
+
+type JobStatus = "idle" | "resolving" | "running" | "needs_input" | "done" | "error";
+interface JobRun {
+    ref: RunRef;
+    startedAt: string;
+    status: string;
+}
+interface JobState {
+    run(variables?: Record<string, unknown>, opts?: {
+        userInput?: string;
+    }): Promise<Result<RunRef>>;
+    status: JobStatus;
+    error: AppletError | null;
+    text: string;
+    result: KindEnvelope | null;
+    inputs: ServedInput[];
+    answer(values: Record<string, unknown>): Promise<Result<void>>;
+    runs: JobRun[];
+}
+/** Run one declared job by alias; stream its text, typed result and questions. */
+declare function useJob(alias: string): JobState;
+interface JobInfo {
+    alias: string;
+    key: string;
+    label: string;
+    goal: string;
+    outputKind: string | null;
+}
+interface JobsState {
+    jobs: JobInfo[];
+    status: Status;
+    error: AppletError | null;
+}
+/** Every job the Applet declares, described by the server. */
+declare function useJobs(): JobsState;
+
+/** A surface value: `[value, set]`. `set` shows at once and is written to the host after. */
+declare function useValue<T>(name: string): [T, (next: T) => void];
+interface ActionState {
+    run(input?: unknown): Promise<Result<unknown>>;
+    status: Status;
+    error: AppletError | null;
+}
+/**
+ * Run an Action on this Applet's surface chain by name. A press in Applet code
+ * is a person's, so runs are `by: "person"` unless the caller says otherwise.
+ */
+declare function useAction(name: string, options?: {
+    by?: "person" | "agent" | "applet" | "automation";
+}): ActionState;
+/**
+ * This Applet's page-Action handlers. Call it in a component body under the
+ * frame (it registers on mount and on every render, and leaves on unmount).
+ */
+declare function defineActions(handlers: Record<string, PageActionHandler>): void;
+
+/**
+ * Navigation and pages (CONTRACTS §2): `usePage`, `navigate`, `<Link>`, and
+ * `<Pages layout>` — the optional helper over the record's page list. An Applet
+ * is never limited to one page: tabs, a sidebar or a menu, or none at all.
+ */
+
+/**
+ * Go somewhere. Outside a component it uses the outermost mounted frame (the
+ * page's route); inside one, `usePage().navigate` is bound to its own frame.
+ * With no frame mounted it says so in the console and does nothing.
+ */
+declare function navigate(to: string): void;
+/** The page whose path matches (`:name` segments capture params); most specific wins. */
+declare function matchPage(pages: readonly AppletPage[], path: readonly string[]): {
+    page: AppletPage;
+    params: Record<string, string>;
+} | null;
+interface PageState {
+    path: string[];
+    page: {
+        path: string;
+        title: string;
+    };
+    params: Record<string, string>;
+    /** Bound to this frame (superset of the contract). */
+    navigate(to: string): void;
+}
+declare function usePage(): PageState;
+interface LinkProps extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, "href"> {
+    to: string;
+}
+declare function Link({ to, onClick, children, ...rest }: LinkProps): React.ReactElement;
+type PagesLayout = "tabs" | "sidebar" | "menu" | "none";
+interface PagesProps {
+    layout?: PagesLayout;
+    /** Page components by file, when no `mountApplet` frame supplies them. */
+    components?: Record<string, React.ComponentType<Record<string, unknown>>>;
+}
+/** The record's pages with a navigation layout, rendering the page the route matches. */
+declare function Pages({ layout, components }: PagesProps): React.ReactElement;
+
+/**
+ * Nesting and kinds (CONTRACTS §2): `<Applet id>` mounts a nested Applet over
+ * its own child host (`host.child`), so names never collide across nesting;
+ * `<Kind>` and `<DataPage>` delegate to renderers the frame's host supplies.
+ * Each one renders a visible stand-in when its renderer is absent — never
+ * nothing.
+ */
+
+interface AppletProps {
+    id: string;
+}
+/** A nested Applet, on its own scoped host. */
+declare function Applet({ id }: AppletProps): React.ReactElement;
+interface KindProps {
+    kind: string;
+    value: unknown;
+}
+/**
+ * A kind, rendered in the frame. The real renderer comes from
+ * `@ai-matrx/content-ir-react` and is handed to `<AppletFrame renderKind>` by
+ * the host; this component only delegates to it.
+ */
+declare function Kind({ kind, value }: KindProps): React.ReactElement;
+interface DataPageProps {
+    id: string;
+}
+/** A table-built page, by id, rendered by the host's `renderDataPage`. */
+declare function DataPage({ id }: DataPageProps): React.ReactElement;
+
+export { type ActionState, Applet, type AppletProps, type ColumnsState, DataPage, type DataPageProps, type JobInfo, type JobRun, type JobState, type JobStatus, type JobsState, Kind, type KindProps, Link, type LinkProps, PageActionHandler, type PageState, Pages, type PagesLayout, type PagesProps, type RowState, type RowsState, type SourcesState, defineActions, matchPage, navigate, useAction, useColumns, useJob, useJobs, usePage, useRow, useRows, useSources, useValue };

package/dist/react.d.ts

@@ -0,0 +1,178 @@
+import { S as Status, A as AppletError, R as Result, U as Uuid, c as SourceInfo, P as PageActionHandler, d as AppletPage } from './context-Dz3PWsJd.js';
+export { e as AppletFrame, f as AppletFrameProps, F as FrameRenderers, n as newQueryClient } from './context-Dz3PWsJd.js';
+import { Column, Row, Values, Query } from '@ai-matrx/records/data';
+import { RunRef, KindEnvelope, ServedInput } from '@ai-matrx/agents/intelligence';
+import * as React from 'react';
+import '@tanstack/react-query';
+import '@ai-matrx/records';
+import '@ai-matrx/alchemy/actions';
+import '@ai-matrx/code-runtime';
+
+interface RowsState {
+    rows: Row[];
+    total: number | null;
+    status: Status;
+    error: AppletError | null;
+    hasMore: boolean;
+    loadMore(): void;
+    /** Rows others wrote that belong somewhere in this (deep, filtered or sorted) list; `refresh()` reads them in. */
+    newer: number;
+    /** Read this list again from the store. */
+    refresh(): void;
+    create(values: Values): Promise<Result<Row>>;
+    update(id: Uuid, patch: Values): Promise<Result<Row>>;
+    archive(id: Uuid): Promise<Result<void>>;
+    restore(id: Uuid): Promise<Result<void>>;
+}
+/** The rows of one declared source (an alias), paged by keyset cursor. */
+declare function useRows(source: string, q?: Query): RowsState;
+interface RowState {
+    row: Row | null;
+    status: Status;
+    error: AppletError | null;
+    update(patch: Values): Promise<Result<Row>>;
+    archive(): Promise<Result<void>>;
+    /** Read this row again from the store. */
+    refresh(): void;
+}
+/** One row of a source, sharing the list caches (an update shows in both). */
+declare function useRow(source: string, id: Uuid): RowState;
+interface ColumnsState {
+    columns: Column[];
+    status: Status;
+    error: AppletError | null;
+}
+declare function useColumns(source: string): ColumnsState;
+interface SourcesState {
+    sources: SourceInfo[];
+    status: Status;
+    error: AppletError | null;
+}
+declare function useSources(): SourcesState;
+
+type JobStatus = "idle" | "resolving" | "running" | "needs_input" | "done" | "error";
+interface JobRun {
+    ref: RunRef;
+    startedAt: string;
+    status: string;
+}
+interface JobState {
+    run(variables?: Record<string, unknown>, opts?: {
+        userInput?: string;
+    }): Promise<Result<RunRef>>;
+    status: JobStatus;
+    error: AppletError | null;
+    text: string;
+    result: KindEnvelope | null;
+    inputs: ServedInput[];
+    answer(values: Record<string, unknown>): Promise<Result<void>>;
+    runs: JobRun[];
+}
+/** Run one declared job by alias; stream its text, typed result and questions. */
+declare function useJob(alias: string): JobState;
+interface JobInfo {
+    alias: string;
+    key: string;
+    label: string;
+    goal: string;
+    outputKind: string | null;
+}
+interface JobsState {
+    jobs: JobInfo[];
+    status: Status;
+    error: AppletError | null;
+}
+/** Every job the Applet declares, described by the server. */
+declare function useJobs(): JobsState;
+
+/** A surface value: `[value, set]`. `set` shows at once and is written to the host after. */
+declare function useValue<T>(name: string): [T, (next: T) => void];
+interface ActionState {
+    run(input?: unknown): Promise<Result<unknown>>;
+    status: Status;
+    error: AppletError | null;
+}
+/**
+ * Run an Action on this Applet's surface chain by name. A press in Applet code
+ * is a person's, so runs are `by: "person"` unless the caller says otherwise.
+ */
+declare function useAction(name: string, options?: {
+    by?: "person" | "agent" | "applet" | "automation";
+}): ActionState;
+/**
+ * This Applet's page-Action handlers. Call it in a component body under the
+ * frame (it registers on mount and on every render, and leaves on unmount).
+ */
+declare function defineActions(handlers: Record<string, PageActionHandler>): void;
+
+/**
+ * Navigation and pages (CONTRACTS §2): `usePage`, `navigate`, `<Link>`, and
+ * `<Pages layout>` — the optional helper over the record's page list. An Applet
+ * is never limited to one page: tabs, a sidebar or a menu, or none at all.
+ */
+
+/**
+ * Go somewhere. Outside a component it uses the outermost mounted frame (the
+ * page's route); inside one, `usePage().navigate` is bound to its own frame.
+ * With no frame mounted it says so in the console and does nothing.
+ */
+declare function navigate(to: string): void;
+/** The page whose path matches (`:name` segments capture params); most specific wins. */
+declare function matchPage(pages: readonly AppletPage[], path: readonly string[]): {
+    page: AppletPage;
+    params: Record<string, string>;
+} | null;
+interface PageState {
+    path: string[];
+    page: {
+        path: string;
+        title: string;
+    };
+    params: Record<string, string>;
+    /** Bound to this frame (superset of the contract). */
+    navigate(to: string): void;
+}
+declare function usePage(): PageState;
+interface LinkProps extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, "href"> {
+    to: string;
+}
+declare function Link({ to, onClick, children, ...rest }: LinkProps): React.ReactElement;
+type PagesLayout = "tabs" | "sidebar" | "menu" | "none";
+interface PagesProps {
+    layout?: PagesLayout;
+    /** Page components by file, when no `mountApplet` frame supplies them. */
+    components?: Record<string, React.ComponentType<Record<string, unknown>>>;
+}
+/** The record's pages with a navigation layout, rendering the page the route matches. */
+declare function Pages({ layout, components }: PagesProps): React.ReactElement;
+
+/**
+ * Nesting and kinds (CONTRACTS §2): `<Applet id>` mounts a nested Applet over
+ * its own child host (`host.child`), so names never collide across nesting;
+ * `<Kind>` and `<DataPage>` delegate to renderers the frame's host supplies.
+ * Each one renders a visible stand-in when its renderer is absent — never
+ * nothing.
+ */
+
+interface AppletProps {
+    id: string;
+}
+/** A nested Applet, on its own scoped host. */
+declare function Applet({ id }: AppletProps): React.ReactElement;
+interface KindProps {
+    kind: string;
+    value: unknown;
+}
+/**
+ * A kind, rendered in the frame. The real renderer comes from
+ * `@ai-matrx/content-ir-react` and is handed to `<AppletFrame renderKind>` by
+ * the host; this component only delegates to it.
+ */
+declare function Kind({ kind, value }: KindProps): React.ReactElement;
+interface DataPageProps {
+    id: string;
+}
+/** A table-built page, by id, rendered by the host's `renderDataPage`. */
+declare function DataPage({ id }: DataPageProps): React.ReactElement;
+
+export { type ActionState, Applet, type AppletProps, type ColumnsState, DataPage, type DataPageProps, type JobInfo, type JobRun, type JobState, type JobStatus, type JobsState, Kind, type KindProps, Link, type LinkProps, PageActionHandler, type PageState, Pages, type PagesLayout, type PagesProps, type RowState, type RowsState, type SourcesState, defineActions, matchPage, navigate, useAction, useColumns, useJob, useJobs, usePage, useRow, useRows, useSources, useValue };