lemma-sdk 0.2.32 → 0.2.34

package/README.md

@@ -63,9 +63,9 @@ import {
   useAgentRun,
   useConversationMessages,
   useConversations,
+  useRecordForm,
   useRecords,
-  useSchemaForm,
-  useWorkflowStart,
+  useWorkflowRun,
 } from "lemma-sdk/react";
 ```
 
@@ -76,13 +76,14 @@ import {
 | Auth | `AuthGuard`, `useAuth`, `useCurrentUser`, `usePodAccess` | Stable | Gate an app, read signed-in user state, or request pod access. |
 | Tables | `useTables`, `useTable`, `useRecords`, `useRecord`, `useJoinedRecords`, `useRelatedRecords`, `useReverseRelatedRecords`, `useReferencingRecords` | Stable | Build custom table browsers, details views, related-record views, and relational reads. |
 | Record mutations | `useCreateRecord`, `useUpdateRecord`, `useDeleteRecord`, `useBulkRecords` | Stable | Create, update, delete, or bulk-delete rows from headless UI. Function-backed mutations via `createVia`/`updateVia` options. |
-| Record forms | `useRecordSchema`, `useRecordForm`, `useForeignKeyOptions`, `useSchemaForm` | Stable | Render schema-driven forms, enum fields, and foreign-key selectors. `useRecordForm` supports `submitVia: "function"`, `visibleFields`, `hiddenFields`. |
+| Record forms | `useRecordSchema`, `useRecordForm`, `useForeignKeyOptions`, `useSchemaForm` | Stable | Render schema-driven record forms, enum fields, and foreign-key selectors. `useRecordForm` is the canonical table-bound form hook; `useSchemaForm` remains available for raw JSON-schema flows. |
+| Files | `useFiles`, `useFile`, `useFileSearch`, `useFileTree`, `useFilePreview` | Stable | Browse datastore folders, resolve file metadata, search indexed files, load directory trees, and preview converted or raw file content. |
 | Assistant | `useConversations`, `useConversation`, `useConversationMessages`, `useAssistantRun`, `useAssistantSession`, `useAssistantRuntime`, `useAssistantController` | Stable except controller/runtime | Build custom chat, conversation lists, streaming output, and final-output views. |
 | Agents | `useAgentRun`, `useAgentRuns`, `useAgentInputSchema`, `useTaskSession` | Stable except raw session | Start agent tasks, submit follow-up input, read task history, and inspect input/output schemas. |
 | Workflows | `useWorkflowStart`, `useWorkflowRun`, `useWorkflowRuns`, `useWorkflowResume` | Stable | Start, poll, resume, cancel, retry, and inspect workflow runs. |
 | Workflow compatibility | `useFlowSession`, `useFlowRunHistory` | Deprecated naming | Kept for existing callers; prefer workflow-named hooks for new code. |
 | Functions | `useFunctionRun`, `useFunctionRuns`, `useFunctionSession` | Stable except raw session | Run functions, poll function runs, and list function history. |
-| Members and org | `useMembers`, `useOrganizationMembers` | Stable | Read pod and organization member lists. `useMembers` is intentionally read-only. |
+| Members and org | `useMembers`, `useAddPodMember`, `useUpdatePodMemberRole`, `useRemovePodMember`, `useOrganizationMembers` | Stable | Read pod and organization members, add existing org members into a pod, update pod roles, and remove pod access. The current checked-in client does not yet expose direct email-to-pod invites. |
 
 ### Common Hook Shapes
 
@@ -215,23 +216,37 @@ Lemma UI lives in the registry, not in `lemma-sdk/react`.
 After running `npx lemma-sdk init-shadcn`, install blocks like:
 
 ```bash
-npx shadcn@latest add @lemma/lemma-records-page
-npx shadcn@latest add @lemma/lemma-agent-runner-page
-npx shadcn@latest add @lemma/lemma-workflow-launcher-page
-npx shadcn@latest add @lemma/lemma-function-runner-page
+npx shadcn@latest add @lemma/lemma-records-view
+npx shadcn@latest add @lemma/lemma-detail-panel
+npx shadcn@latest add @lemma/lemma-record-form
+npx shadcn@latest add @lemma/lemma-global-search
+npx shadcn@latest add @lemma/lemma-file-browser
+npx shadcn@latest add @lemma/lemma-file-viewer
+npx shadcn@latest add @lemma/lemma-document-workspace
+npx shadcn@latest add @lemma/lemma-document-creator
+npx shadcn@latest add @lemma/lemma-document-viewer
+npx shadcn@latest add @lemma/lemma-document-editor
+npx shadcn@latest add @lemma/lemma-members
+npx shadcn@latest add @lemma/lemma-comments
+npx shadcn@latest add @lemma/lemma-insights
+npx shadcn@latest add @lemma/lemma-assistant-experience
 ```
 
+Those commands are representative. The registry currently ships 22 canonical blocks.
+
 Current registry items:
 
 | Area | Items |
 | --- | --- |
-| Assistant | `lemma-assistant-experience`, `lemma-assistant-embedded` |
-| Schema | `lemma-schema-form` |
-| Tables | `lemma-table-picker`, `lemma-record-picker`, `lemma-record-filters-bar`, `lemma-records-table`, `lemma-record-details-card`, `lemma-record-form`, `lemma-related-records-table`, `lemma-reverse-related-records-table`, `lemma-bulk-actions-bar`, `lemma-records-page` |
-| Agents | `lemma-agent-run-panel`, `lemma-agent-output-card`, `lemma-agent-messages`, `lemma-agent-runner-page` |
-| Workflows | `lemma-workflow-start-form`, `lemma-workflow-history`, `lemma-workflow-run-status`, `lemma-workflow-run-details`, `lemma-workflow-launcher-page` |
-| Members and access | `lemma-members-table`, `lemma-member-picker`, `lemma-org-member-picker`, `lemma-pod-access-card` |
-| Functions | `lemma-function-run-panel`, `lemma-function-run-history`, `lemma-function-runner-page` |
+| Assistant | `lemma-assistant-experience` |
+| Navigation | `lemma-breadcrumbs`, `lemma-global-search`, `lemma-page-tree` |
+| Records | `lemma-records-view`, `lemma-detail-panel`, `lemma-record-form`, `lemma-status-flow` |
+| Files | `lemma-file-browser`, `lemma-file-viewer` |
+| Documents | `lemma-document-workspace`, `lemma-document-creator`, `lemma-document-viewer`, `lemma-document-editor`, `lemma-markdown-editor` |
+| People | `lemma-members`, `lemma-notification-bell`, `lemma-user-menu` |
+| Analytics | `lemma-insights` |
+| Collaboration | `lemma-activity-feed`, `lemma-comments` |
+| Automation | `lemma-workflow-runner` |
 
 The registry is currently served from jsDelivr against this public repo:
 
@@ -240,54 +255,166 @@ The registry is currently served from jsDelivr against this public repo:
 
 For more stable installs, pin the registry URL to a tag or commit SHA instead of `@main`.
 
+Blocks that install a CSS file, such as records view, should be imported by your app's global stylesheet:
+
+```css
+@import "@/styles/lemma-records-view.css";
+```
+
 ### Records Workspace Customization
 
 The records blocks are meant to be configured with props before you reach for a fork.
 
-`lemma-records-page` supports:
+`lemma-records-view` supports:
+
+- `preset="triage" | "issues" | "crm" | "docs"` for opinionated defaults without installing duplicate workflow blocks
+- `defaultView` and `availableViews` across `grid`, `list`, `grouped`, `kanban`, `linear`, `calendar`, `timeline`, and `matrix`
+- `tableName`, `visibleColumns`, and `hiddenFields` for schema-aware display
+- `pinnedColumns`, `columnWidths`, `columnLabels`, `primaryField`, `defaultSort`, and `paginationMode` for stronger operator-table defaults
+- `groupBy`, `calendarField`, `timelineField`, `matrixRowsBy`, and `matrixColumnsBy` for consolidated view configuration
+- `renderCell` and `renderCard` for custom record rendering
+- `foreignKeyLabels` for human-readable FK values in cards, detail views, and create/edit forms
+- `detailTabs`, `detailFieldGroups`, `detailRelatedRecords`, `detailSectionLabels`, and `detailSectionVisibility` for canonical detail composition
+- `quickActions`, `bulkActions`, `detailActions`, `quickActionMode`, and `onQuickActionSuccess` for direct, function, or workflow-backed actions
+- `onCreateOptions` and `onUpdateOptions` for function-backed mutations, including conditional field and section visibility in the create sheet
+- `createMode="sheet" | "modal" | "page"` and `detailMode="sheet" | "modal" | "page" | "inline"` for app-specific interaction patterns
+- `headerActions`, `emptyState`, `onRecordClick`, `renderFilesTab`, `renderCommentsTab`, and `renderActivityTab` for app-specific extensions
+- `appearance="default" | "minimal" | "borderless" | "contained"` and `density="compact" | "comfortable" | "spacious"` for host-level block chrome; `minimal` is the cardless mode
+
+`lemma-detail-panel` supports:
+
+- standalone record detail rendering outside the full records workspace, using the same canonical detail internals as `lemma-records-view`
+- `mode`, `variant`, and `layout` controls for embedded, sheet, modal, or full-page use
+- built-in detail tabs plus custom `tabs`, `relatedRecords`, and `renderFiles` / `renderComments` / `renderActivity` sections
+- direct, function-backed, and workflow-aware `actions`, plus `updateVia` / `updateFunctionName` for inline edits
+- shared `appearance`, `density`, and `radius` controls for use in inline, sheet, modal, or page layouts
+
+`lemma-record-form` supports:
+
+- `mode="inline" | "modal" | "sheet"`
+- `submitVia="direct" | "function"` and `submitFunctionName`
+- `submitFunctionInput` when the backing function expects a different payload shape
+- `hiddenFields`, `visibleFields`, `fieldOrder`, and `fieldGroups`
+- searchable FK inputs through the shared `record-form-fields` control layer
+- `fieldVisibility` and `sectionVisibility` for conditional forms
+- `foreignKeyLabels` for FK select labels
+- `initialValues`, `onSuccess`, and `onClose`
+- `appearance`, `density`, and `radius` using the same values as `lemma-records-view`
+
+`lemma-insights` supports:
+
+- table-backed count, sum, average, and grouped chart cards
+- bar, line, area, pie, and funnel charts with count/sum/avg aggregation
+- `aggregationMode="client" | "function"` with optional `aggregateFunctionName` for shared server-side aggregation
+- chart descriptions, value/category formatters, limits, sorting, empty states, and optional footers
+- function-backed stats and charts
+- shared `appearance`, `density`, `radius`, and card-column controls
+
+`lemma-global-search` supports:
+
+- configured `tables[]` with `searchFields`, `displayField`, `subtitleField`, `href`, `onSelect`, and `openMode`
+- optional file search with `searchMethod`, `href`, `onSelect`, and `openMode`
+- progressive table/file result groups, smooth loading/error source states, hidden empty sources, keyboard navigation, and built-in `cmd/ctrl+k` handling
+- `minQueryLength`, `debounceMs`, `appearance`, `density`, trigger label, and placeholder customization
+- assistant handoff by `assistantName`, with optional query/results message shaping and conversation routing
+
+Navigation blocks support:
+
+- route, record, and file-path breadcrumb builders through `lemma-breadcrumbs`
+- self-referential page hierarchies through `lemma-page-tree`, with selection, expansion, and create/reorder hooks
+
+File blocks support:
+
+- datastore folder navigation and path breadcrumbs through `lemma-file-browser`
+- pod-level file browsing and search, not only record-linked attachments
+- upload, download, search, rename, move, folder creation, picker mode, and composition-friendly link actions
+- selection-aware file browsing so `lemma-file-browser` can drive a paired workspace preview
+- image, PDF, text, markdown, converted HTML, metadata, and breadcrumb-aware previews through `lemma-file-viewer`
 
-- capability toggles such as `allowCreate`, `allowEdit`, `allowSelection`, `allowBulkDelete`, `allowSearch`, `allowFilters`, `allowSorting`, `allowPageSizeSelect`, and `allowColumnVisibility`
-- layout toggles such as `showTablePicker`, `showRecordPicker`, and `showRecordDetails`
-- column control through `columns`, `hiddenColumnNames`, `defaultHiddenColumnNames`, and `onHiddenColumnNamesChange`
-- non-`id` primary keys through `recordIdField` or `getRecordId`
-- record-form overrides through `recordFormHiddenFields`, `recordFormFieldOrder`, `recordFormFieldLabels`, `recordFormFieldDescriptions`, `createFormTitle`, `editFormTitle`, `createSubmitLabel`, and `editSubmitLabel`
+Document blocks support:
 
-`lemma-records-table` supports richer column definitions:
+- Notion/Coda-style block documents through `lemma-document-workspace`, with Tiptap JSON content, page/modal modes, title and summary chrome, file/reference/assistant blocks, save state, metadata, backlinks, and assistant-context rails
+- docstore-native creation through `lemma-document-workspace` or the simpler `lemma-document-creator`, with folder targeting, title/summary setup, pod-file metadata, and `mode="page" | "modal"`
+- long-form reading surfaces through `lemma-document-workspace` or `lemma-document-viewer`, with full-page and modal presentation, metadata, backlinks, references, and assistant-context rails
+- long-form authoring through `lemma-document-workspace` or `lemma-document-editor`, with full-page and modal presentation, title/summary chrome, save-state affordances, outline, references, and assistant-context rails
+- a clean separation between richer document UX and the lower-level pod file workspace, while keeping pod files as the primary document store and avoiding embedded-first document editing
 
-- `label`, `description`, `type`, `width`, `minWidth`, `align`
-- `searchable`, `hideable`, `hidden`
-- `renderCell(...)` for custom cell output
-- per-row buttons through `rowActions`
+People blocks support:
+
+- `LemmaMemberChip`, `LemmaAvatarGroup`, `LemmaMemberSelect`, and `LemmaUserField`
+- a stock `LemmaMembers` admin workspace for pod membership, role changes, removal, and add-from-organization flows via `organizationId`, `allowAdd`, `allowRoleEdit`, and `allowRemove`
+- pod member labels for owner, creator, assignee, participant, and author fields
+- searchable member picking backed by `useMembers`
+
+Workflow primitives support:
+
+- lifecycle/status rendering and transitions through `lemma-status-flow`
+- read-only tracker layouts and compact step progress through `lemma-status-flow`
+- workflow run inspection through `lemma-workflow-runner`
+- reusable history and collaboration surfaces through `lemma-activity-feed` and `lemma-comments`
+- table-backed defaults with escape hatches for custom action payloads and render slots
+
+`lemma-markdown-editor` supports:
+
+- write, preview, and split modes
+- controlled and uncontrolled values
+- GitHub-flavored markdown preview via `react-markdown` and `remark-gfm`
+- a lightweight interim editing lane for plain markdown notes beside the richer block-native `lemma-document-workspace`
+
+Assistant blocks support:
+
+- assistant-name-first configuration through `assistantName`
+- shared `appearance` and `density` controls on the assistant experience surface
+- `chromeStyle`, `statusPlacement`, `radius`, model picker, conversation list, and render overrides for deeper customization
+
+Shell blocks support:
+
+- `lemma-notification-bell` for unread counts, popover inboxes, and mark-as-read flows
+- `lemma-user-menu` for current-user presentation, custom menu actions, and sign-out affordances
 
 ```tsx
-import { LemmaRecordsPage } from "@/components/lemma/lemma-records-page";
-import type { LemmaRecordsTableColumn } from "@/components/lemma/lemma-records-table";
-
-const columns: LemmaRecordsTableColumn[] = [
-  { name: "item_id", label: "Item ID", hideable: false, width: 180 },
-  { name: "group_id", label: "Group", width: 160 },
-  { name: "name", label: "Name", minWidth: 320, searchable: true },
-  {
-    name: "sellable",
-    label: "Sellable",
-    type: "boolean",
-    width: 120,
-    align: "center",
-    renderCell: ({ value }) => (value ? "Yes" : "No"),
-  },
-];
-
-<LemmaRecordsPage
-  allowColumnVisibility
-  allowCreate
-  allowEdit
-  columns={columns}
-  createButtonLabel="New SKU"
-  defaultHiddenColumnNames={["group_id"]}
-  editSubmitLabel="Save SKU"
-  recordFormFieldLabels={{ item_id: "Item ID" }}
-  recordIdField="item_id"
-  tableName="catalog_items"
+import { LemmaRecordsView } from "@/components/lemma/lemma-records-view";
+import { LemmaGlobalSearch } from "@/components/lemma/lemma-global-search";
+
+<LemmaRecordsView
+  client={client}
+  podId={podId}
+  tableName="deals"
+  preset="crm"
+  hiddenFields={["id", "created_at", "updated_at"]}
+  foreignKeyLabels={{ company_id: "name" }}
+  appearance="minimal"
+  density="compact"
+  createMode="sheet"
+  onCreateOptions={{
+    submitVia: "function",
+    submitFunctionName: "create-deal",
+  }}
+/>;
+
+<LemmaGlobalSearch
+  client={client}
+  podId={podId}
+  tables={[
+    {
+      tableName: "deals",
+      label: "Deals",
+      searchFields: ["name", "status", "source"],
+      displayField: "name",
+      subtitleField: "status",
+      href: (record) => `/deals?record=${record.id}`,
+    },
+  ]}
+  files={{ enabled: true, openMode: "new-tab" }}
+  assistant={{
+    assistantName: "sales-copilot",
+    label: "Ask CRM",
+    resultLimit: 8,
+  }}
+  minQueryLength={3}
+  debounceMs={450}
+  appearance="minimal"
+  density="compact"
 />;
 ```
 
@@ -328,6 +455,15 @@ npm run build
 npm run registry:build
 ```
 
+To build the canonical example desk:
+
+```bash
+cd examples/inbox-crm
+npm run build
+```
+
+`examples/inbox-crm` now mirrors the kept registry surface only. Its local `src/components/lemma` folder is a copied install target of the current canonical registry blocks, and `src/main.tsx` demonstrates those blocks in one routed operator desk.
+
 This repo includes:
 
 - `registry.json` for registry source definitions

package/dist/browser/lemma-client.js

@@ -1742,8 +1742,8 @@ class DesksNamespace {
         this.client = client;
         this.http = http;
         this.podId = podId;
-        this.html = {
-            get: (name) => this.client.request(() => DesksService_js_1.DesksService.deskHtmlGet(this.podId(), name)),
+        this.assets = {
+            get: (name, path) => this.http.request("GET", `/pods/${this.podId()}/desks/${name}/assets${path ? `/${path.replace(/^\/+/, "")}` : ""}`),
         };
         this.bundle = {
             upload: (name, payload) => this.client.request(() => DesksService_js_1.DesksService.deskBundleUpload(this.podId(), name, payload)),
@@ -1751,6 +1751,9 @@ class DesksNamespace {
         this.source = {
             download: (name) => this.http.requestBytes("GET", `/pods/${this.podId()}/desks/${name}/source/archive`),
         };
+        this.dist = {
+            download: (name) => this.http.requestBytes("GET", `/pods/${this.podId()}/desks/${name}/dist/archive`),
+        };
     }
     list(options = {}) {
         return this.client.request(() => DesksService_js_1.DesksService.deskList(this.podId(), options.limit ?? 100, options.pageToken));
@@ -1910,16 +1913,16 @@ class DesksService {
         });
     }
     /**
-     * Get Desk HTML
+     * Download Desk Dist Archive
      * @param podId
      * @param deskName
      * @returns any Successful Response
      * @throws ApiError
      */
-    static deskHtmlGet(podId, deskName) {
+    static deskDistArchiveGet(podId, deskName) {
         return (0, request_js_1.request)(OpenAPI_js_1.OpenAPI, {
             method: 'GET',
-            url: '/pods/{pod_id}/desks/{desk_name}/html',
+            url: '/pods/{pod_id}/desks/{desk_name}/dist/archive',
             path: {
                 'pod_id': podId,
                 'desk_name': deskName,
@@ -2002,6 +2005,15 @@ class FilesNamespace {
                 return this.client.request(() => FilesService_js_1.FilesService.fileFolderCreate(this.podId(), payload));
             },
         };
+        this.converted = {
+            get: (path) => this.client.request(() => FilesService_js_1.FilesService.fileConvertedGet(this.podId(), path)),
+            render: (path) => this.client.request(() => FilesService_js_1.FilesService.fileConvertedRender(this.podId(), path)),
+            download: (path, artifact = "document.md") => {
+                const encodedPath = encodeURIComponent(path);
+                const encodedArtifact = encodeURIComponent(artifact);
+                return this.http.requestBytes("GET", `/pods/${this.podId()}/datastore/files/converted/download?path=${encodedPath}&artifact=${encodedArtifact}`);
+            },
+        };
     }
     list(options = {}) {
         const directoryPath = options.directoryPath ?? options.parentId ?? "/";
@@ -2024,6 +2036,9 @@ class FilesNamespace {
         const encodedPath = encodeURIComponent(path);
         return this.http.requestBytes("GET", `/pods/${this.podId()}/datastore/files/download?path=${encodedPath}`);
     }
+    tree(options = {}) {
+        return this.client.request(() => FilesService_js_1.FilesService.fileTree(this.podId(), options.rootPath ?? "/", options.filesPerDirectory ?? 3));
+    }
     upload(file, options = {}) {
         const payload = {
             data: file,
@@ -3873,7 +3888,7 @@ class PodSurfacesNamespace {
         return this.client.request(() => AssistantSurfacesService_js_1.AssistantSurfacesService.assistantSurfaceGet(podId, surfaceId));
     }
     updateConfig(podId, surfaceId, payload) {
-        return this.client.request(() => AssistantSurfacesService_js_1.AssistantSurfacesService.assistantSurfaceUpdateConfig(podId, surfaceId, payload));
+        return this.client.request(() => AssistantSurfacesService_js_1.AssistantSurfacesService.assistantSurfaceUpdate(podId, surfaceId, payload));
     }
     toggle(podId, surfaceId, isActive) {
         return this.client.request(() => AssistantSurfacesService_js_1.AssistantSurfacesService.assistantSurfaceToggle(podId, surfaceId, { is_active: isActive }));
@@ -3891,7 +3906,6 @@ const request_js_1 = require("./openapi_client/core/request.js");
 class AssistantSurfacesService {
     /**
      * List Surfaces
-     * List configured surfaces in a pod.
      * @param podId
      * @param limit
      * @param pageToken
@@ -3916,7 +3930,6 @@ class AssistantSurfacesService {
     }
     /**
      * Create Surface
-     * Create a new surface for an assistant.
      * @param podId
      * @param requestBody
      * @returns any Successful Response
@@ -3936,9 +3949,28 @@ class AssistantSurfacesService {
             },
         });
     }
+    /**
+     * Get Surface Platform Checklist
+     * @param podId
+     * @param platform
+     * @returns SurfacePlatformSetupGuideResponse Successful Response
+     * @throws ApiError
+     */
+    static assistantSurfacePlatformChecklist(podId, platform) {
+        return (0, request_js_1.request)(OpenAPI_js_1.OpenAPI, {
+            method: 'GET',
+            url: '/pods/{pod_id}/surfaces/platforms/{platform}/checklist',
+            path: {
+                'pod_id': podId,
+                'platform': platform,
+            },
+            errors: {
+                422: `Validation Error`,
+            },
+        });
+    }
     /**
      * Get Surface
-     * Get a specific surface configuration.
      * @param podId
      * @param surfaceId
      * @returns any Successful Response
@@ -3959,17 +3991,16 @@ class AssistantSurfacesService {
     }
     /**
      * Update Surface
-     * Update a surface configuration.
      * @param podId
      * @param surfaceId
      * @param requestBody
      * @returns any Successful Response
      * @throws ApiError
      */
-    static assistantSurfaceUpdateConfig(podId, surfaceId, requestBody) {
+    static assistantSurfaceUpdate(podId, surfaceId, requestBody) {
         return (0, request_js_1.request)(OpenAPI_js_1.OpenAPI, {
             method: 'PATCH',
-            url: '/pods/{pod_id}/surfaces/{surface_id}/config',
+            url: '/pods/{pod_id}/surfaces/{surface_id}',
             path: {
                 'pod_id': podId,
                 'surface_id': surfaceId,
@@ -3981,9 +4012,28 @@ class AssistantSurfacesService {
             },
         });
     }
+    /**
+     * Get Admin Consent Info
+     * @param podId
+     * @param surfaceId
+     * @returns AdminConsentInfoResponse Successful Response
+     * @throws ApiError
+     */
+    static assistantSurfaceAdminConsentInfo(podId, surfaceId) {
+        return (0, request_js_1.request)(OpenAPI_js_1.OpenAPI, {
+            method: 'GET',
+            url: '/pods/{pod_id}/surfaces/{surface_id}/admin-consent',
+            path: {
+                'pod_id': podId,
+                'surface_id': surfaceId,
+            },
+            errors: {
+                422: `Validation Error`,
+            },
+        });
+    }
     /**
      * Toggle Surface
-     * Toggle a surface active state.
      * @param podId
      * @param surfaceId
      * @param requestBody
@@ -4005,6 +4055,26 @@ class AssistantSurfacesService {
             },
         });
     }
+    /**
+     * Get Webhook Url
+     * @param podId
+     * @param surfaceId
+     * @returns any Successful Response
+     * @throws ApiError
+     */
+    static assistantSurfaceWebhookUrl(podId, surfaceId) {
+        return (0, request_js_1.request)(OpenAPI_js_1.OpenAPI, {
+            method: 'GET',
+            url: '/pods/{pod_id}/surfaces/{surface_id}/webhook-url',
+            path: {
+                'pod_id': podId,
+                'surface_id': surfaceId,
+            },
+            errors: {
+                422: `Validation Error`,
+            },
+        });
+    }
 }
 exports.AssistantSurfacesService = AssistantSurfacesService;
 
@@ -5003,7 +5073,7 @@ class WorkflowsService {
      * @param podId
      * @param workflowName
      * @param requestBody
-     * @returns FlowInstallEntity Successful Response
+     * @returns FlowInstallResponse Successful Response
      * @throws ApiError
      */
     static workflowInstallCreate(podId, workflowName, requestBody) {

package/dist/index.d.ts

@@ -12,8 +12,10 @@ export { parseTaskStreamEvent, upsertTaskMessage } from "./task-events.js";
 export type { ParsedTaskStreamEvent } from "./task-events.js";
 export { parseAssistantStreamEvent, upsertConversationMessage } from "./assistant-events.js";
 export type { ParsedAssistantStreamEvent } from "./assistant-events.js";
-export { buildRecordFormValues, buildRecordPayload, buildRecordSchemaFields, formatRecordValueForForm, getEditableRecordFields, getRecordFieldKind, } from "./record-form.js";
+export { DEFAULT_RECORD_FORM_HIDDEN_FIELDS, buildRecordFormValues, buildRecordPayload, buildRecordSchemaFields, formatRecordValueForForm, getEditableRecordFields, getRecordFieldKind, orderRecordSchemaFields, } from "./record-form.js";
 export type { BuildRecordPayloadOptions, BuildRecordPayloadResult, RecordSchemaField, RecordSchemaFieldKind, } from "./record-form.js";
+export { buildDefaultRecordDetailFieldGroups, detectRecordDescriptionColumn, detectRecordStatusColumn, detectRecordTitleColumn, formatRecordDateDisplayValue, formatRecordDisplayValue, formatRecordPlainValue, humanizeRecordFieldName, isDefaultRecordDetailHiddenField, } from "./record-display.js";
+export type { RecordDetailFieldGroupDefinition } from "./record-display.js";
 export { buildSchemaFormFields, buildSchemaFormPayload, buildSchemaFormValues, formatSchemaFieldValueForForm, } from "./schema-form.js";
 export type { BuildSchemaFormPayloadResult, JsonSchemaLike, JsonSchemaPrimitiveType, SchemaFormField, SchemaFormFieldKind, } from "./schema-form.js";
 export { buildJoinedRecordsQuery, parseForeignKeyReference, } from "./datastore-query.js";

package/dist/index.js

@@ -6,6 +6,7 @@ export { readSSE, parseSSEJson } from "./streams.js";
 export { normalizeRunStatus, isTerminalTaskStatus, isTerminalFunctionStatus, isTerminalFlowStatus, sleep, nextBackoffDelay, } from "./run-utils.js";
 export { parseTaskStreamEvent, upsertTaskMessage } from "./task-events.js";
 export { parseAssistantStreamEvent, upsertConversationMessage } from "./assistant-events.js";
-export { buildRecordFormValues, buildRecordPayload, buildRecordSchemaFields, formatRecordValueForForm, getEditableRecordFields, getRecordFieldKind, } from "./record-form.js";
+export { DEFAULT_RECORD_FORM_HIDDEN_FIELDS, buildRecordFormValues, buildRecordPayload, buildRecordSchemaFields, formatRecordValueForForm, getEditableRecordFields, getRecordFieldKind, orderRecordSchemaFields, } from "./record-form.js";
+export { buildDefaultRecordDetailFieldGroups, detectRecordDescriptionColumn, detectRecordStatusColumn, detectRecordTitleColumn, formatRecordDateDisplayValue, formatRecordDisplayValue, formatRecordPlainValue, humanizeRecordFieldName, isDefaultRecordDetailHiddenField, } from "./record-display.js";
 export { buildSchemaFormFields, buildSchemaFormPayload, buildSchemaFormValues, formatSchemaFieldValueForForm, } from "./schema-form.js";
 export { buildJoinedRecordsQuery, parseForeignKeyReference, } from "./datastore-query.js";

package/dist/namespaces/desks.d.ts

@@ -16,8 +16,8 @@ export declare class DesksNamespace {
     get(name: string): Promise<import("../types.js").DeskResponse>;
     update(name: string, payload: UpdateDeskRequest): Promise<import("../types.js").DeskResponse>;
     delete(name: string): Promise<import("../types.js").DeskMessageResponse>;
-    readonly html: {
-        get: (name: string) => Promise<string>;
+    readonly assets: {
+        get: (name: string, path?: string) => Promise<string>;
     };
     readonly bundle: {
         upload: (name: string, payload: DeskBundleUploadRequest) => Promise<import("../types.js").DeskBundleUploadResponse>;
@@ -25,4 +25,7 @@ export declare class DesksNamespace {
     readonly source: {
         download: (name: string) => Promise<Blob>;
     };
+    readonly dist: {
+        download: (name: string) => Promise<Blob>;
+    };
 }

package/dist/namespaces/desks.js

@@ -23,8 +23,8 @@ export class DesksNamespace {
     delete(name) {
         return this.client.request(() => DesksService.deskDelete(this.podId(), name));
     }
-    html = {
-        get: (name) => this.client.request(() => DesksService.deskHtmlGet(this.podId(), name)),
+    assets = {
+        get: (name, path) => this.http.request("GET", `/pods/${this.podId()}/desks/${name}/assets${path ? `/${path.replace(/^\/+/, "")}` : ""}`),
     };
     bundle = {
         upload: (name, payload) => this.client.request(() => DesksService.deskBundleUpload(this.podId(), name, payload)),
@@ -32,4 +32,7 @@ export class DesksNamespace {
     source = {
         download: (name) => this.http.requestBytes("GET", `/pods/${this.podId()}/desks/${name}/source/archive`),
     };
+    dist = {
+        download: (name) => this.http.requestBytes("GET", `/pods/${this.podId()}/desks/${name}/dist/archive`),
+    };
 }

package/dist/namespaces/files.d.ts

@@ -1,5 +1,7 @@
 import type { GeneratedClientAdapter } from "../generated.js";
 import type { HttpClient } from "../http.js";
+import type { ConvertedFileResponse } from "../openapi_client/models/ConvertedFileResponse.js";
+import type { DirectoryTreeResponse } from "../openapi_client/models/DirectoryTreeResponse.js";
 import { SearchMethod } from "../openapi_client/models/SearchMethod.js";
 export declare class FilesNamespace {
     private readonly client;
@@ -19,6 +21,10 @@ export declare class FilesNamespace {
         searchMethod?: SearchMethod;
     }): Promise<import("../types.js").FileSearchResponse>;
     download(path: string): Promise<Blob>;
+    tree(options?: {
+        rootPath?: string;
+        filesPerDirectory?: number;
+    }): Promise<DirectoryTreeResponse>;
     upload(file: Blob, options?: {
         name?: string;
         directoryPath?: string;
@@ -42,4 +48,9 @@ export declare class FilesNamespace {
             description?: string;
         }) => Promise<import("../types.js").FileResponse>;
     };
+    readonly converted: {
+        get: (path: string) => Promise<ConvertedFileResponse>;
+        render: (path: string) => Promise<string>;
+        download: (path: string, artifact?: string) => Promise<Blob>;
+    };
 }

package/dist/namespaces/files.js

@@ -59,6 +59,9 @@ export class FilesNamespace {
         const encodedPath = encodeURIComponent(path);
         return this.http.requestBytes("GET", `/pods/${this.podId()}/datastore/files/download?path=${encodedPath}`);
     }
+    tree(options = {}) {
+        return this.client.request(() => FilesService.fileTree(this.podId(), options.rootPath ?? "/", options.filesPerDirectory ?? 3));
+    }
     upload(file, options = {}) {
         const payload = {
             data: file,
@@ -96,4 +99,13 @@ export class FilesNamespace {
             return this.client.request(() => FilesService.fileFolderCreate(this.podId(), payload));
         },
     };
+    converted = {
+        get: (path) => this.client.request(() => FilesService.fileConvertedGet(this.podId(), path)),
+        render: (path) => this.client.request(() => FilesService.fileConvertedRender(this.podId(), path)),
+        download: (path, artifact = "document.md") => {
+            const encodedPath = encodeURIComponent(path);
+            const encodedArtifact = encodeURIComponent(artifact);
+            return this.http.requestBytes("GET", `/pods/${this.podId()}/datastore/files/converted/download?path=${encodedPath}&artifact=${encodedArtifact}`);
+        },
+    };
 }

package/dist/namespaces/pod-surfaces.js

@@ -14,7 +14,7 @@ export class PodSurfacesNamespace {
         return this.client.request(() => AssistantSurfacesService.assistantSurfaceGet(podId, surfaceId));
     }
     updateConfig(podId, surfaceId, payload) {
-        return this.client.request(() => AssistantSurfacesService.assistantSurfaceUpdateConfig(podId, surfaceId, payload));
+        return this.client.request(() => AssistantSurfacesService.assistantSurfaceUpdate(podId, surfaceId, payload));
     }
     toggle(podId, surfaceId, isActive) {
         return this.client.request(() => AssistantSurfacesService.assistantSurfaceToggle(podId, surfaceId, { is_active: isActive }));

package/dist/namespaces/workflows.d.ts

@@ -23,7 +23,7 @@ export declare class WorkflowsNamespace {
         update: (workflowName: string, graph: WorkflowGraphUpdateRequest) => Promise<import("../types.js").FlowResponse>;
     };
     readonly installs: {
-        create: (workflowName: string, payload?: WorkflowInstallRequest) => Promise<import("../types.js").FlowInstallEntity>;
+        create: (workflowName: string, payload?: WorkflowInstallRequest) => Promise<import("../types.js").FlowInstallResponse>;
         delete: (workflowName: string, installId: string) => Promise<void>;
     };
     private postRunAction;