@lowdefy/docs-content 0.0.0-experimental-20260928120643 → 6.1.0

package/README.md

@@ -6,7 +6,6 @@ Lowdefy documentation extracted as markdown, for serving to AI coding agents via
 
 - `content/<section>/<slug>.md` — one markdown file per docs page (concepts, tutorial, operators, actions, connections, blocks, ...).
 - `index.json` — manifest of all docs: `{ version, docs: [{ slug, title, section, path, kind?, typeName? }] }`. `kind`/`typeName` map a plugin type (e.g. operator `_get`) to its doc.
-- `hazards.json` — framework-level hazards served by the dev MCP alongside schemas, docs and config lookups: `[{ id, appliesTo: { kinds?, types?, when? }, message, see }]`. This file is hand-authored and committed, not generated — `pnpm docs:content` wipes `content/` but leaves it untouched. Add an entry only for a behaviour verified in the framework source.
 
 ## Regenerating content
 

package/content/actions/link.md

@@ -9,8 +9,6 @@
   input?: object,
   newTab?:boolean,
   pageId?: string,
-  replace?: boolean,
-  scroll?: boolean,
   url?: string,
   urlQuery? object
 }): void
@@ -32,8 +30,6 @@ The pageId of a page in the app to link to.
 - `input: object`: Object to set as the input for the linked page.
 - `newTab: boolean`: Open the link in a new tab.
 - `pageId: string`: The pageId of a page in the app to link to.
-- `replace: boolean`: Replace the current browser history entry instead of pushing a new one, so the browser back button skips this navigation. Defaults to `false`.
-- `scroll: boolean`: Scroll to the top of the page after navigating. Set to `false` to keep the current scroll position, for example when a same-page link only updates the `urlQuery`. Defaults to `true`.
 - `url: string`: Link to an external url.
 - `urlQuery: object`: Object to set as the urlQuery for the linked page.
 
@@ -109,19 +105,6 @@ The pageId of a page in the app to link to.
         _args: row.id
 ```
 
-###### Reflect state into the urlQuery without moving the page:
-```yaml
-- id: sync_url
-  type: Link
-  params:
-    pageId: my_page_id
-    urlQuery:
-      selected:
-        _state: selected_id
-    replace: true
-    scroll: false
-```
-
 ###### Go to the previous page:
 ```yaml
 - id: link_back

package/content/actions/login.md

@@ -10,7 +10,7 @@
     pageId?: string
     url?: string
     urlQuery?: object
-  } | false
+  }
   providerId?: string,
 }): void
 ```
@@ -19,46 +19,28 @@ The `Login` action is used to start the user login flow. If only one provider is
 
 The authorization url usually hosts a page where the user can input their credentials. After the user has logged in successfully, the user is redirected to the `api/auth/callback/[provider_id]` route in the Lowdefy app, where the rest of the authorization code flow is completed.
 
-The `callbackUrl` parameter of the Login action specifies where the user lands after login is complete. Three sources are consulted, in order:
-
-1. The `callbackUrl` param, if given.
-2. The `?callbackUrl=` query parameter, which Lowdefy sets when it redirects an unauthenticated user to the sign-in page - so a user who was bounced there returns to the page they asked for.
-3. The app's home page.
-
-If none of the three resolves - an app with no `homePageId` whose menu offers the signed-out user no page to fall back on - the action throws rather than staying silently on the sign-in page.
-
-To sign in without navigating at all, set `callbackUrl: false`. This is for a login form in a modal or an embedded panel, where the session store re-renders the page with the new user in place. It is not valid for magic-link or social/OAuth sign-in, which redirect through a hop Lowdefy does not control.
-
-A sign-in the auth server rejects - a wrong password, an expired or already-used link, an invalid code - is an expected outcome, not an app error. The action throws a `UserError`: `catch` actions on the event still run and the error message still displays, but it is logged to the browser console only and is never reported to the server. The auth server's response is available to `catch` actions as `_actions.<actionId>.error.metaData`, with a `code` (for example `INVALID_EMAIL_OR_PASSWORD`) and the HTTP `status`. A network failure or a server fault is still thrown as an action error and reported.
+The `callbackUrl` parameters of the Login action specify where the user is redirected after login is complete. If `callbackUrl` parameters not set, the user will return to the page from which the action was called.
 
 #### Parameters
 
 ###### object
 - `authUrl: object`:
   - `urlQuery: object`: Query parameters to set for the authorization URL.
-- `callbackUrl: object | false`: Set to `false` to sign in without navigating. As an object:
+- `callbackUrl: object`:
   - `home: boolean`: Redirect to the home page after the login flow is complete.
   - `pageId: string`: The pageId of the page to redirect to after the login flow is complete.
-  - `url: string`: The URL to redirect to after the login flow is complete. An absolute URL is not `basePath`-prefixed, so it can be an external landing page.
+  - `url: string`: The URL to redirect to after the login flow is complete.
   - `urlQuery: object`: The urlQuery to set for the page the user is redirected to after login.
 - `providerId: string`: The ID of the provider that should be used for login. If not set and only one provider is configured the configured provider will be used. Else the user will be redirected to a sign in page where they can choose a provider.
 
 #### Examples
 
-###### Login and land on the home page (or the page the user was bounced from):
+###### Login and return to the same page:
 ```yaml
 - id: login
   type: Login
 ```
 
-###### Login in a modal, without navigating:
-```yaml
-- id: login
-  type: Login
-  params:
-    callbackUrl: false
-```
-
 ###### Login with the google provider:
 ```yaml
 - id: login_with_google

package/content/actions/logout.md

@@ -14,16 +14,16 @@
 
 When the `Logout` action is called, the user data and authorization cookies are cleared by the app.
 
-The `callbackUrl` parameter of the Logout action specifies where the user lands after logout is complete. Unlike the `Login` action it has no default and does not read the `?callbackUrl=` query: with no `callbackUrl` the page is reloaded and the server re-applies the page's auth rules, which sends a signed-out user off a protected page to the sign-in page. Defaulting to the home page instead could land them on a page they may no longer see.
+The `callbackUrl` parameters of the Logout action specify where the user is redirected after logout is complete. If `callbackUrl` parameters not set, the user will return to the page from which the action was called.
 
 #### Parameters
 
 ###### object
 - `callbackUrl: object`:
-  - `home: boolean`: Redirect to the home page after the logout flow is complete.
-  - `pageId: string`: The pageId of the page to redirect to after the logout flow is complete.
-  - `url: string`: The URL to redirect to after the logout flow is complete. An absolute URL is not `basePath`-prefixed, so it can be an external logout landing page.
-  - `urlQuery: object`: The urlQuery to set for the page the user is redirected to after logout.
+  - `home: boolean`: Redirect to the home page after the login flow is complete.
+  - `pageId: string`: The pageId of the page to redirect to after the login flow is complete.
+  - `url: string`: The URL to redirect to after the login flow is complete.
+  - `urlQuery: object`: The urlQuery to set for the page the user is redirected to after login.
 - `redirect: boolean`: If set to `false` the user session will be cleared, but the page will not be reloaded.
 
 #### Examples

package/content/actions/pdfmake.md

@@ -28,7 +28,7 @@ The `PdfMake` action is used to generate and download a PDF file from a set of d
   type: Button
   properties:
     title: Download PDF
-    icon: download
+    icon: AiOutlineDownload
   events:
     onClick:
       - id: make_pdf
@@ -53,7 +53,7 @@ The `PdfMake` action is used to generate and download a PDF file from a set of d
     textAlign: center
   properties:
     title: Generate & Download PDF
-    icon: download
+    icon: AiOutlineDownload
     color: '#6293F8'
   events:
     onMount:

package/content/actions/setdarkmode.md

@@ -33,8 +33,8 @@ The preference is persisted to `localStorage` and triggers re-rendering of the r
       _if:
         test:
           _media: darkMode
-        then: Sun
-        else: Moon
+        then: AiOutlineSun
+        else: AiOutlineMoon
   events:
     onClick:
       - id: toggle

package/content/agents/agent-properties.md

@@ -22,7 +22,7 @@ properties:
 
 ## Generation Settings
 
-- `maxOutputTokens: integer`: Maximum tokens the model can generate per step. Defaults to the connection's `maxOutputTokens`.
+- `maxOutputTokens: integer`: Maximum tokens the model can generate per step.
 - `temperature: number`: Sampling temperature between `0` and `2`. Lower values are more deterministic, higher values more creative. Default depends on the provider.
 - `topP: number`: Nucleus sampling probability between `0` and `1`. Alternative to temperature — use one or the other.
 - `topK: integer`: Only sample from the top K token options (not supported by all providers).
@@ -156,15 +156,13 @@ properties:
 ## Timeouts and Retries
 
 - `maxRetries: integer`: Default: `2` - Maximum retries on provider errors. Set to `0` to disable.
-- `timeout: number | object`: Timeout configuration. Defaults to the connection's `timeout`.
+- `timeout: number | object`: Timeout configuration.
   - As a number: total timeout in milliseconds.
   - As an object with granular control:
     - `totalMs: number`: Total timeout across all steps.
     - `stepMs: number`: Timeout per step.
     - `chunkMs: number`: Timeout between stream chunks.
 
-A chat turn keeps running when the client disconnects, so its `onFinish` hooks still save the whole conversation; `timeout` and `maxSteps` are what bound it. A `CallAgent` step is cancelled with the routine that runs it: when its request closes or the server's request timeout (`config.requestTimeout`) answers first.
-
 ## Provider-Specific Properties
 
 - `providerOptions: object`: Pass provider-specific options directly to the AI SDK. Use this for options not covered by the properties above.

package/content/agents/agentchat.md

@@ -66,9 +66,9 @@ The `AgentChat` block renders a streaming AI chat interface. It connects to a [L
 | Property | Type | Default | Description |
 | --- | --- | --- | --- |
 | `agentId` | string | | __Required__ - The `id` of the agent to connect to. |
-| `conversationId` | string | | Active conversation ID. When this changes, messages are cleared. If left empty, the block auto-mints a stable id for the session and surfaces it via `onConversationStart`, so every turn posts a consistent id. App-supplied ids are always authoritative. |
-| `messages` | array | | Load messages externally. `undefined` = no sync, `null` = clear, array = load. |
-| `feedbackValues` | object | | Ratings already recorded for messages in this conversation, keyed by message id, each `like` or `dislike`. The block does not persist a rating, so without this a reload or a conversation switch shows every message unrated even where your app stored it. A rating clicked this visit takes precedence, so the thumb still responds immediately and a rating the user has just withdrawn is not re-lit by a stale value. |
+| `conversationId` | string | | Active conversation ID. When this changes, any in-flight reply is aborted (so it stops emitting `onDataPart` and tool events into the page) and messages are cleared. If left empty, the block auto-mints a stable id for the session and surfaces it via `onConversationStart`, so every turn posts a consistent id. App-supplied ids are always authoritative. |
+| `messages` | array | | Load messages externally. `undefined` = no sync, `null` = clear, array = load. Re-synced whenever the array's length, last message id or `conversationId` changes. |
+| `loading` | boolean | `false` | The app is still loading this conversation's transcript (for example, reading it from a database after a conversation switch). While `true`, a skeleton replaces the message area, suggestions are hidden and the composer is disabled, so nothing can be sent into a conversation whose messages have not synced yet. Drive it from state alongside `messages`, for the window before the transcript has synced — not while a reply is streaming, since a disabled composer also hides the stop control. |
 | `urlQuery` | object | | Query parameters sent with each request. Available server-side via `_payload`. |
 | `sharedState` | object | | Two-way bridge between page state and the agent. See [Shared State](#shared-state). |
 | `height` | string | `'calc(100dvh - 170px)'` | CSS height of the chat container. Only applies when `display` is `'inline'`. |
@@ -195,8 +195,6 @@ Customize message appearance by role:
     - `avatar: string`: Avatar image URL.
     - `variant: string`: `'filled'`, `'outlined'`, `'shadow'`, or `'borderless'`.
     - `shape: string`: `'default'`, `'round'`, or `'corner'`.
-    - `styles: object`: Inline styles per bubble part — `root`, `content`, `body`, `header`, `footer`, `avatar`, `extra`. This is how to recolour a bubble: the `filled` background and the `outlined` border come from the theme's `colorPrimary`, and a page stylesheet cannot override them.
-    - `classNames: object`: Class names per bubble part, same keys as `styles`.
   - `user: object`: Same properties as `assistant`.
 
 ```yaml
@@ -218,8 +216,6 @@ messageDisplay:
   - `placeholder: string`: Default: `'Type a message...'` — Input placeholder. When `config.i18n` is configured, falls back to the localized `agent.sender.placeholder` builtin key. See the [i18n concept page](/i18n) for the full list of localizable agent UI keys (tool approval buttons, message actions, tool-result captions, etc.).
   - `submitType: string`: Default: `'enter'` - Submit key. `'enter'` or `'shiftEnter'`.
   - `allowSpeech: boolean`: Default: `false` - Enable speech input.
-  - `styles: object`: Inline styles per composer part — `root`, `prefix`, `input`, `suffix`, `footer`, `switch`, `content`. This is how to recolour the composer border, which the theme sets and a page stylesheet cannot override.
-  - `classNames: object`: Class names per composer part, same keys as `styles`.
 
 #### File Attachments
 
@@ -257,7 +253,7 @@ sender:
   switches:
     - key: deep_research
       label: Deep Research
-      icon: search
+      icon: AiOutlineSearch
       default: false
     - key: use_knowledge_base
       label: Use Knowledge Base
@@ -331,7 +327,7 @@ With the curated form above, the agent can read `legal_name` and `registration_n
 | `onToolResult` | A tool returns a result. | `toolName`, `toolCallId`, `output`, `error` |
 | `onError` | A streaming error occurs. | `message` |
 | `onStop` | User stops generation. | `messages` |
-| `onFeedback` | User clicks thumbs up/down. `rating` is `like` or `dislike`, or `default` when the user clicks the selected thumb again to clear the rating — branch on it explicitly rather than treating anything that is not `like` as a dislike. | `messageId`, `messageContent`, `rating` |
+| `onFeedback` | User clicks thumbs up/down. | `messageId`, `messageContent`, `rating` |
 | `onRegenerate` | User clicks regenerate. | `messageId`, `messages` |
 | `onDeleteMessage` | User deletes a message. | `messageId`, `content`, `messages` |
 | `onEditMessage` | User edits and resubmits. | `messageId`, `originalContent`, `newContent`, `messages` |
@@ -339,7 +335,6 @@ With the curated form above, the agent can read `legal_name` and `registration_n
 | `onSwitchChange` | User toggles a sender switch. | `key`, `checked` |
 | `onTitleGenerated` | A `data-chat-title` data part arrives — emitted automatically when the agent's [`generateTitle`](/agent-properties) property is set, or manually from an `onFinish` hook. | `title` |
 | `onDataPart` | Any data part arrives from the server. | `type`, `data`, `id` |
-| `onLinkClick` | User clicks a link in a message. Wiring this event suppresses the default navigation for plain left clicks, so the app can open the target in place; modified clicks (new tab, middle click) always navigate. | `href`, `text` |
 
 ###### Validate messages before sending:
 ```yaml
@@ -371,16 +366,6 @@ events:
         type: success
 ```
 
-Saving is only half of it — the block does not persist a rating, so a
-reload or a conversation switch shows the message unrated again. Pass
-what you stored back through `feedbackValues`, keyed by message id:
-
-```yaml
-properties:
-  feedbackValues:
-    _request: saved_feedback_for_conversation
-```
-
 ###### Adapt behavior based on sender switches:
 ```yaml
 events:
@@ -448,7 +433,7 @@ Control the chat programmatically using [`CallMethod`](/CallMethod):
   type: Button
   properties:
     title: New Chat
-    icon: add
+    icon: AiOutlinePlus
   events:
     onClick:
       - id: new_id

package/content/agents/agentconversations.md

@@ -25,13 +25,13 @@ The block does not manage data — you load conversations from your database and
       _state: activeConversationId
     creation:
       label: New Chat
-      icon: add
+      icon: AiOutlinePlus
     menu:
       - key: rename
         label: Rename
       - key: delete
         label: Delete
-        icon: delete
+        icon: AiOutlineDelete
         danger: true
     groupable:
       collapsible: true