@softr/sdk 0.0.89-alpha.1 → 0.0.89-alpha.3

package/dist/agent/agent-fns.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import * as _tanstack_react_start0 from "@tanstack/react-start";
+import * as _tanstack_react_start8 from "@tanstack/react-start";
 
 //#region src/agent/agent-fns.d.ts
 
@@ -15,7 +15,7 @@ type Agent = z.infer<typeof agentSchema>;
  * The agents the visitor may chat with in this app. The builder attaches them
  * in Studio, and each one's visibility settings decide who sees it.
  */
-declare const listAgents: _tanstack_react_start0.OptionalFetcher<undefined, undefined, Promise<{
+declare const listAgents: _tanstack_react_start8.OptionalFetcher<undefined, undefined, Promise<{
   id: string;
   title: string;
   avatar?: string | null | undefined;

package/dist/agent/use-agent-chat.d.ts

@@ -34,7 +34,10 @@ type AgentQuestion = {
   }>;
   multiSelect: boolean;
 };
-/** One piece of a message, in the order the agent produced it. */
+/**
+ * One piece of a message, in the order the agent produced it. A tool waiting for
+ * the visitor comes last, below the text that asks for it, until they answer.
+ */
 type AgentBlock = {
   type: "text";
   text: string;

package/dist/agent/use-agent-chat.js

@@ -262,11 +262,11 @@ function useAgentChat(agentId, options = {}) {
 		reset
 	]);
 	return {
-		messages: live === null ? messages : [...messages, {
+		messages: (live === null ? messages : [...messages, {
 			id: "live",
 			role: "assistant",
 			blocks: live
-		}],
+		}]).map(waitingLast),
 		status,
 		loading,
 		error,
@@ -281,6 +281,15 @@ function useAgentChat(agentId, options = {}) {
 		connect
 	};
 }
+const waitsForVisitor = (b) => b.type === "tool" && (b.status === "awaiting-approval" || b.status === "awaiting-connection" || b.status === "connecting");
+function waitingLast(message) {
+	if (!message.blocks.some(waitsForVisitor)) return message;
+	const blocks = [...message.blocks.filter((b) => !waitsForVisitor(b)), ...message.blocks.filter(waitsForVisitor)];
+	return {
+		...message,
+		blocks
+	};
+}
 const CONNECT_TIMEOUT_MS = 5 * 6e4;
 const CONNECT_RETRY_MS = 3e3;
 function popupFeatures(width, height) {
@@ -449,18 +458,22 @@ function fromHistory(history) {
 	});
 }
 const CHAT_GONE_MESSAGE = "This chat is no longer available. Start a new one.";
-const chatKey = (agentId, userId) => `softr-agent-chat:${agentId}:${userId ?? "visitor"}`;
+const VISITOR = "visitor";
+const chatKey = (agentId, userId) => `softr-code-app:agent-chat:${agentId}:${userId ?? VISITOR}`;
+function chatStore(key) {
+	return key.endsWith(`:${VISITOR}`) ? sessionStorage : localStorage;
+}
 function savedChatId(key) {
 	try {
-		return localStorage.getItem(key);
+		return chatStore(key).getItem(key);
 	} catch {
 		return null;
 	}
 }
 function saveChatId(key, chatId) {
 	try {
-		if (chatId) localStorage.setItem(key, chatId);
-		else localStorage.removeItem(key);
+		if (chatId) chatStore(key).setItem(key, chatId);
+		else chatStore(key).removeItem(key);
 	} catch {}
 }
 async function failureMessage(res) {

package/dist/auth/isomorphic.d.ts

@@ -2,9 +2,9 @@ import { User } from "./user.js";
 import { Formatting } from "../formatting.js";
 import { Permissions } from "./permissions.js";
 import { SoftrContext } from "./context.js";
-import * as react6 from "react";
+import * as react0 from "react";
 import { ReactNode } from "react";
-import * as _tanstack_react_start8 from "@tanstack/react-start";
+import * as _tanstack_react_start0 from "@tanstack/react-start";
 
 //#region src/auth/isomorphic.d.ts
 
@@ -22,7 +22,7 @@ import * as _tanstack_react_start8 from "@tanstack/react-start";
  *   requestMiddleware: [softrAuthMiddleware()],
  * }))
  */
-declare function softrAuthMiddleware(): _tanstack_react_start8.RequestMiddlewareAfterServer<{}, readonly [_tanstack_react_start8.RequestMiddlewareAfterServer<{}, undefined, undefined>, _tanstack_react_start8.RequestMiddlewareAfterServer<{}, undefined, undefined>, _tanstack_react_start8.RequestMiddlewareAfterServer<{}, undefined, undefined>, _tanstack_react_start8.RequestMiddlewareAfterServer<{}, undefined, undefined>], {
+declare function softrAuthMiddleware(): _tanstack_react_start0.RequestMiddlewareAfterServer<{}, readonly [_tanstack_react_start0.RequestMiddlewareAfterServer<{}, undefined, undefined>, _tanstack_react_start0.RequestMiddlewareAfterServer<{}, undefined, undefined>, _tanstack_react_start0.RequestMiddlewareAfterServer<{}, undefined, undefined>, _tanstack_react_start0.RequestMiddlewareAfterServer<{}, undefined, undefined>], {
   user: User | null;
   permissions: Permissions;
   formatting: Formatting;
@@ -36,7 +36,7 @@ declare function softrAuthMiddleware(): _tanstack_react_start8.RequestMiddleware
  *   beforeLoad: async () => await getSoftrContext(),
  * })
  */
-declare const getSoftrContext: _tanstack_react_start8.OptionalFetcher<undefined, undefined, Promise<SoftrContext>>;
+declare const getSoftrContext: _tanstack_react_start0.OptionalFetcher<undefined, undefined, Promise<SoftrContext>>;
 /**
  * The context to hand `createRouter`, before any request has resolved one.
  *
@@ -84,7 +84,7 @@ type AuthOptions = {
  *   staleTime: 60_000,
  * })
  */
-declare const getAuthSettings: _tanstack_react_start8.OptionalFetcher<undefined, undefined, Promise<AuthOptions>>;
+declare const getAuthSettings: _tanstack_react_start0.OptionalFetcher<undefined, undefined, Promise<AuthOptions>>;
 /**
  * Makes the auth options readable with {@link useAuthSettings} anywhere below.
  *
@@ -104,7 +104,7 @@ declare function AuthSettingsProvider({
 }: {
   value: AuthOptions;
   children?: ReactNode;
-}): react6.JSX.Element;
+}): react0.JSX.Element;
 /**
  * Which ways in this app offers. Requires an {@link AuthSettingsProvider}
  * above it.

package/dist/default-error-overlay.d.ts

@@ -1,4 +1,4 @@
-import * as react5 from "react";
+import * as react6 from "react";
 
 //#region src/default-error-overlay.d.ts
 type Props = {
@@ -8,6 +8,6 @@ type Props = {
 declare function DefaultErrorOverlay({
   error,
   reset
-}: Props): react5.JSX.Element;
+}: Props): react6.JSX.Element;
 //#endregion
 export { DefaultErrorOverlay };

package/dist/mcp.d.ts

@@ -1,5 +1,5 @@
 import { DatasourceAction } from "./action.js";
-import * as _tanstack_react_start15 from "@tanstack/react-start";
+import * as _tanstack_react_start0 from "@tanstack/react-start";
 
 //#region src/mcp.d.ts
 
@@ -31,6 +31,6 @@ type SoftrMcpOptions = {
  *   ],
  * }))
  */
-declare function softrMcpMiddleware(options?: SoftrMcpOptions): _tanstack_react_start15.RequestMiddlewareAfterServer<{}, undefined, undefined>;
+declare function softrMcpMiddleware(options?: SoftrMcpOptions): _tanstack_react_start0.RequestMiddlewareAfterServer<{}, undefined, undefined>;
 //#endregion
 export { softrMcpMiddleware };

package/dist/package.js

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "0.0.89-alpha.1";
+var version = "0.0.89-alpha.3";
 
 //#endregion
 export { version };

package/dist/pwa.d.ts

@@ -1,4 +1,4 @@
-import * as react3 from "react";
+import * as react4 from "react";
 import "@tanstack/react-start";
 
 //#region src/pwa.d.ts
@@ -23,7 +23,7 @@ import "@tanstack/react-start";
  *   )
  * }
  */
-declare function SoftrPwaHead(): react3.FunctionComponentElement<react3.FragmentProps>;
+declare function SoftrPwaHead(): react4.FunctionComponentElement<react4.FragmentProps>;
 type PwaPlatform = "ios" | "android" | "desktop";
 type PwaInstall = {
   available: false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softr/sdk",
-  "version": "0.0.89-alpha.1",
+  "version": "0.0.89-alpha.3",
   "type": "module",
   "exports": {
     ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" },

package/skills/softr-sdk/SKILL.md

@@ -9,7 +9,7 @@ description: >-
 metadata:
   type: core
   library: softr-sdk
-  library_version: 0.0.89-alpha.1
+  library_version: 0.0.89-alpha.3
 ---
 
 # Softr SDK core
@@ -86,7 +86,7 @@ Calling a connected third-party API (Slack, Stripe, Gmail, Google Calendar, …)
 Opening the app to an AI assistant over MCP?
   load softr-sdk/mcp
 
-Adding a chat with one of the app's Softr agents?
+Adding a chat with one of the app's Softr agents, or a Connect button for the visitor's account it needs?
   load softr-sdk/agent-chat
 
 Adding an install button, or making the app installable?

package/skills/softr-sdk/agent-chat/SKILL.md

@@ -3,14 +3,16 @@ name: agent-chat
 description: >-
   Let visitors chat with one of the app's Softr agents: listAgents() from
   @softr/sdk gives the agents the visitor may use, and useAgentChat(agentId, {
-  record }) returns the messages, the reply as it streams, and
-  send, stop, approve and reject, with no UI. Build the chat from the app's own
+  record }) returns the messages, the reply as it streams, past chats, and
+  send, stop, approve, reject and connect, with no UI. Load it for an agent
+  chat panel, approving the agent's actions, or connecting the visitor's own
+  account (Gmail, Slack…) that a tool needs. Build the chat from the app's own
   components. The agent acts on the app's data through the app's MCP, so
   softrMcpMiddleware must list the actions it may use.
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.89-alpha.1
+  library_version: 0.0.89-alpha.3
 ---
 
 **Boundary.** `listAgents` and `useAgentChat` live on `@softr/sdk`. `listAgents` runs in a route loader, `useAgentChat` in a component. Neither needs a route, server function or registration of its own. It chats as the signed-in visitor, or anonymously when no one is signed in.
@@ -56,12 +58,12 @@ function AgentPanel({ agentId, ticket }: { agentId: string; ticket: Ticket | nul
 
 ## What the hook returns
 
-- `messages`: the whole chat, oldest first. While the agent answers, its reply is the last message and grows as it streams.
+- `messages`: the whole chat, oldest first. While the agent answers, its reply is the last message and grows as it streams. A tool waiting for Approve or Connect comes last in its message, so render blocks in the order given.
 - `status`: `thinking` until the first part of the reply arrives, `replying` until it ends, then `idle`. Show a typing hint while it's `thinking`.
 - `loading`: `true` while a past chat loads. Show a spinner, not the empty-chat greeting.
 - `error`: why the last request failed, or `null`.
 - `send(text)`, `stop()`, `newChat()`.
-- `listChats()` resolves to the visitor's past chats, `{ id, title }[]`, with `title` `null` until the agent names the chat. `openChat(id)` loads one. `chatId` is the open one, `null` for a new chat. The open chat is kept in the browser for each visitor, so the hook reopens it after a remount or a reload.
+- `listChats()` resolves to the visitor's past chats, `{ id, title }[]`, with `title` `null` until the agent names the chat. `openChat(id)` loads one. `chatId` is the open one, `null` for a new chat. The open chat is kept in the browser for each signed-in user, so the hook reopens it after a remount or a reload. A signed-out visitor keeps it only until the tab closes.
 - `approve(toolCallId, scope?)` and `reject(toolCallId)` answer a tool waiting for approval. `scope` is `ONCE` (default), `SESSION` for the rest of this chat, or `USER` for always.
 - `connect(toolCallId)` signs the visitor in to a tool's `integration` in a popup. Call it straight from the click, or the browser blocks the popup.
 
@@ -92,8 +94,9 @@ Classic Softr apps ship a chat panel. Visitors expect the same from yours:
 - Text renders as Markdown, tables included.
 - The input says "Ask {agent title}…". Enter sends. Shift+Enter adds a line.
 - A line under the input: "AI can make mistakes. Please double-check responses."
-- A question with one choice sends on click. One with `multiSelect` or several questions sends once all are answered. An answered question stays locked.
+- An answered question stays locked.
 - Approve offers the three scopes: once, for this chat, always for this agent.
+- A tool's `input` is JSON. Show it readable: one `Label: value` line per field, with line breaks kept, never the raw JSON. Leave out `thought`, `input`, `error` or the duration when it's empty.
 - A tool that needs the visitor's account shows a Connect button.
 
 ## Context
@@ -112,12 +115,10 @@ The agent reads and changes data through the app's own MCP, as the visitor who i
 
 **Rendering only `text` blocks.** A tool waiting for approval never shows, and the agent waits forever. Render every block type.
 
-**The hook inside a panel that unmounts when it closes.** Closing it stops a reply that is still coming. Call `useAgentChat` in the component that owns the open state, such as the layout, and pass `chat` into the panel. Keep the selected agent there too, or closing the panel resets it.
+**The hook inside a panel that unmounts when it closes.** Closing it stops a reply that is still coming. Call `useAgentChat` in the component that owns the open state, such as `AppLayout` in `src/routes/_app.tsx`, and pass `chat` into the panel. Keep the selected agent there too, or closing the panel resets it.
 
 **An agent id written by hand.** The chat fails on the first message, and an agent hidden from the visitor still shows. Take the id from `listAgents`.
 
-**Expecting the agent to change data with no MCP wired.** It answers but can't act. List the actions it needs in `softrMcpMiddleware`.
-
 ## References
 
 - [mcp/SKILL.md](../mcp/SKILL.md): the actions the agent may call

package/skills/softr-sdk/auth/SKILL.md

@@ -9,7 +9,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.89-alpha.1
+  library_version: 0.0.89-alpha.3
 ---
 
 **Boundary.** `auth` lives on `@softr/sdk/server` and runs only inside a `createServerFn` handler — importing it into a component fails the build.

package/skills/softr-sdk/charts-and-metrics/SKILL.md

@@ -9,7 +9,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.89-alpha.1
+  library_version: 0.0.89-alpha.3
 ---
 
 **Boundary.** `ds` lives on `@softr/sdk/server` and runs only inside a `createServerFn` handler or a server-side route hook — importing it into a component fails the build. `defineQuery` and every type come from `@softr/sdk` and can be imported anywhere.

package/skills/softr-sdk/current-user/SKILL.md

@@ -9,7 +9,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.89-alpha.1
+  library_version: 0.0.89-alpha.3
 ---
 
 # The current user

package/skills/softr-sdk/file-uploads/SKILL.md

@@ -7,7 +7,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.89-alpha.1
+  library_version: 0.0.89-alpha.3
 ---
 
 **Boundary.** `upload` lives on `@softr/sdk/server` and runs inside server functions. `useFileUpload` and `FileItem` live on `@softr/sdk` and run in components. `FileAttachment` comes from `@softr/sdk` and can be imported anywhere.

package/skills/softr-sdk/formatting/SKILL.md

@@ -8,7 +8,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.89-alpha.1
+  library_version: 0.0.89-alpha.3
 ---
 
 # Dates, times and numbers

package/skills/softr-sdk/integrations/SKILL.md

@@ -7,7 +7,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.89-alpha.1
+  library_version: 0.0.89-alpha.3
 ---
 
 **Boundary.** `integration` lives on `@softr/sdk/server` and runs only inside a `createServerFn` handler — importing it into a component fails the build. `defineIntegration` and every type come from `@softr/sdk` and can be imported anywhere.

package/skills/softr-sdk/mcp/SKILL.md

@@ -9,7 +9,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.89-alpha.1
+  library_version: 0.0.89-alpha.3
 ---
 
 **Boundary.** `softrMcpMiddleware` lives on `@softr/sdk` and is registered once, in `src/start.ts`. The actions you hand it are the same `defineQuery` / `defineMutation` values the app's own pages use — declared wherever they already live, not duplicated for MCP.

package/skills/softr-sdk/pwa/SKILL.md

@@ -9,7 +9,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.89-alpha.1
+  library_version: 0.0.89-alpha.3
 ---
 
 # Installing the app

package/skills/softr-sdk/record-mutations/SKILL.md

@@ -8,7 +8,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.89-alpha.1
+  library_version: 0.0.89-alpha.3
 ---
 
 **Boundary.** `ds` lives on `@softr/sdk/server` and runs only inside a `createServerFn` handler — importing it into a component fails the build. `defineMutation` and every type come from `@softr/sdk` and can be imported anywhere.

package/skills/softr-sdk/record-queries/SKILL.md

@@ -9,7 +9,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.89-alpha.1
+  library_version: 0.0.89-alpha.3
 ---
 
 **Boundary.** `ds` lives on `@softr/sdk/server` and runs only inside a `createServerFn` handler or a server-side route hook — importing it into a component fails the build. The same holds for any helper that calls `ds`: declare it inside the handler. A function at module level that calls `ds` keeps the server-only import in the browser bundle, and every page stops loading until it moves. `defineQuery` and every type come from `@softr/sdk` and can be imported anywhere.

package/skills/softr-sdk/region-visibility/SKILL.md

@@ -9,7 +9,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.89-alpha.1
+  library_version: 0.0.89-alpha.3
 ---
 
 **Boundary.** `Audience` and `defineVisibility` come from `@softr/sdk` and work anywhere.

package/skills/softr-sdk/routes-and-visibility/SKILL.md

@@ -9,7 +9,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.89-alpha.1
+  library_version: 0.0.89-alpha.3
 ---
 
 **Boundary.** `definePage`, `pageHead`, the access functions and the error predicates come from `@softr/sdk` and work anywhere.

package/skills/softr-sdk/workflows/SKILL.md

@@ -9,7 +9,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.89-alpha.1
+  library_version: 0.0.89-alpha.3
 ---
 
 **Boundary.** `workflow` lives on `@softr/sdk/server` and runs only inside a `createServerFn` handler — importing it into a component fails the build. `defineWorkflow` and every type come from `@softr/sdk` and can be imported anywhere.