@softr/sdk 0.0.78-alpha.0 → 0.0.78-alpha.2

package/dist/core/ai.d.ts

@@ -8,9 +8,16 @@ interface AiFile {
   /** The file's type when the URL does not say, such as `application/pdf`. */
   mimeType?: string;
 }
+/** One earlier turn of a conversation. */
+interface AiMessage {
+  role: 'user' | 'assistant';
+  content: string;
+}
 interface AiGenerateInit {
   /** What the model is and the rules it answers under. */
   system?: string;
+  /** The earlier turns of a conversation, oldest first, before the prompt. Leave out for a one-shot call. */
+  messages?: ReadonlyArray<AiMessage>;
   /** What it is asked, with the facts it is given. */
   prompt: string;
   /**
@@ -22,6 +29,13 @@ interface AiGenerateInit {
   files?: ReadonlyArray<AiFile>;
   /** A cap on the answer's length, in tokens; Softr caps it further. */
   maxOutputTokens?: number;
+  /**
+   * How hard a reasoning model thinks before it answers. A model that does not reason ignores it;
+   * the catalog says which do. Left out, the provider's default applies.
+   */
+  reasoning?: 'low' | 'medium' | 'high';
+  /** How varied the answer is, 0 to 1: 0 for an extraction, higher for a draft. A low default when left out. */
+  temperature?: number;
   signal?: AbortSignal;
 }
 interface AiUsage {
@@ -59,4 +73,4 @@ declare const ai: {
   stream: typeof aiStream;
 };
 //#endregion
-export { AiAnswer, AiError, AiFile, AiGenerateInit, AiUsage, ai };
+export { AiAnswer, AiError, AiFile, AiGenerateInit, AiMessage, AiUsage, ai };

package/dist/core/ai.js

@@ -18,10 +18,13 @@ var AiError = class extends Error {
 function body(init) {
 	return JSON.stringify({
 		system: init.system,
+		messages: init.messages,
 		prompt: init.prompt,
 		schema: init.schema,
 		files: init.files,
-		maxOutputTokens: init.maxOutputTokens
+		maxOutputTokens: init.maxOutputTokens,
+		reasoning: init.reasoning,
+		temperature: init.temperature
 	});
 }
 async function post(action, path, init) {
@@ -41,7 +44,7 @@ async function post(action, path, init) {
 }
 /** Runs the action once and answers when the model is done. */
 async function aiGenerate(action, init) {
-	return await (await post(action, "ai/generate", init)).json();
+	return await (await post(action, "softr-ai/generate", init)).json();
 }
 /**
 * Runs the action and answers while the model writes. The returned `Response` body is a stream of
@@ -50,7 +53,7 @@ async function aiGenerate(action, init) {
 * place. Hand it to the browser as a `Response` with `Content-Type: text/event-stream`.
 */
 async function aiStream(action, init) {
-	return post(action, "ai/generate/stream", init);
+	return post(action, "softr-ai/generate/stream", init);
 }
 const ai = {
 	generate: aiGenerate,

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

@@ -1,4 +1,4 @@
-import * as react0 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): react0.JSX.Element;
+}: Props): react6.JSX.Element;
 //#endregion
 export { DefaultErrorOverlay };

package/dist/formatting.d.ts

@@ -1,4 +1,4 @@
-import * as react3 from "react";
+import * as react0 from "react";
 import { ReactNode } from "react";
 import { z } from "zod";
 
@@ -94,7 +94,7 @@ declare function FormattingScope({
   /** A BCP 47 locale, such as `de-DE`. It drops the app's fixed date format inside the scope. */
   locale?: string;
   children?: ReactNode;
-}): react3.FunctionComponentElement<react3.ProviderProps<Scope>>;
+}): react0.FunctionComponentElement<react0.ProviderProps<Scope>>;
 /**
  * A date in the app's format, safe to render on the server. A timestamp whose
  * zone is not known yet renders `fallback` until the browser supplies it, so
@@ -115,6 +115,6 @@ declare function FormattedDate({
   time?: boolean;
   /** What renders while the visitor's zone is unknown. */
   fallback?: ReactNode;
-}): react3.FunctionComponentElement<react3.FragmentProps>;
+}): react0.FunctionComponentElement<react0.FragmentProps>;
 //#endregion
 export { DateOptions, DateParts, DateSeparator, DateValue, FixedDateFormat, FormattedDate, Formatting, FormattingScope, WeekDay, formatDate, formatDateTime, formatNumber, useFormatting };

package/dist/index.d.ts

@@ -3,7 +3,7 @@ import { ActionPermissions, SoftrDatasources, defineAiAction, defineComments, de
 import { FileAttachment } from "./core/file-upload.js";
 import { FileItem, useFileUpload } from "./core/use-file-upload.js";
 import { CommentAttachmentInput, CommentMention, CommentThread, CommentView } from "./comments/comments.js";
-import { AiAnswer, AiFile, AiGenerateInit, AiUsage } from "./core/ai.js";
+import { AiAnswer, AiFile, AiGenerateInit, AiMessage, AiUsage } from "./core/ai.js";
 import { DateOptions, DateParts, DateSeparator, DateValue, FixedDateFormat, FormattedDate, Formatting, FormattingScope, WeekDay, formatDate, formatDateTime, formatNumber, useFormatting } from "./formatting.js";
 import { SoftrContext } from "./auth/context.js";
 import { AuthSettings } from "./auth/platform.js";
@@ -19,4 +19,4 @@ import { useUserTimezone } from "./timezone.js";
 import { PwaInstall, PwaPlatform, SoftrPwaHead, usePwaInstall } from "./pwa.js";
 import { DefaultErrorOverlay } from "./default-error-overlay.js";
 import { Audience } from "./route/audience.js";
-export { type ActionPermissions, type AiAnswer, type AiFile, type AiGenerateInit, type AiUsage, Audience, type AuthOptions, type AuthSettings, AuthSettingsProvider, type CommentAttachmentInput, type CommentMention, type CommentThread, type CommentView, type DateOptions, type DateParts, type DateSeparator, type DateValue, DefaultErrorOverlay, type FieldShape, type FileAttachment, type FileItem, type FixedDateFormat, FormattedDate, type Formatting, FormattingScope, type Page, type PageSettings, type PwaInstall, type PwaPlatform, type SoftrContext, type SoftrDatasources, type SoftrFieldRegistry, SoftrPwaHead, type SoftrUserGroupId, type SoftrUserGroups, type User, type WeekDay, assertRouteAccess, checkAccess, defineAiAction, defineComments, defineIntegration, defineMutation, definePage, defineQuery, defineVisibility, defineWorkflow, fieldShape, formatDate, formatDateTime, formatDuration, formatField, formatNumber, formatValue, getAuthSettings, getSoftrContext, guardRoute, initialSoftrContext, isAccessError, isAlreadyAuthenticatedError, isAuthorized, isForbiddenError, isUnauthenticatedError, pageHead, registerSoftrFields, softrAuthMiddleware, softrMcpMiddleware, toReturnPath, useAuthSettings, useCurrentUser, useFileUpload, useFormatting, useOverrides, usePwaInstall, useUserTimezone };
+export { type ActionPermissions, type AiAnswer, type AiFile, type AiGenerateInit, type AiMessage, type AiUsage, Audience, type AuthOptions, type AuthSettings, AuthSettingsProvider, type CommentAttachmentInput, type CommentMention, type CommentThread, type CommentView, type DateOptions, type DateParts, type DateSeparator, type DateValue, DefaultErrorOverlay, type FieldShape, type FileAttachment, type FileItem, type FixedDateFormat, FormattedDate, type Formatting, FormattingScope, type Page, type PageSettings, type PwaInstall, type PwaPlatform, type SoftrContext, type SoftrDatasources, type SoftrFieldRegistry, SoftrPwaHead, type SoftrUserGroupId, type SoftrUserGroups, type User, type WeekDay, assertRouteAccess, checkAccess, defineAiAction, defineComments, defineIntegration, defineMutation, definePage, defineQuery, defineVisibility, defineWorkflow, fieldShape, formatDate, formatDateTime, formatDuration, formatField, formatNumber, formatValue, getAuthSettings, getSoftrContext, guardRoute, initialSoftrContext, isAccessError, isAlreadyAuthenticatedError, isAuthorized, isForbiddenError, isUnauthenticatedError, pageHead, registerSoftrFields, softrAuthMiddleware, softrMcpMiddleware, toReturnPath, useAuthSettings, useCurrentUser, useFileUpload, useFormatting, useOverrides, usePwaInstall, useUserTimezone };

package/dist/package.js

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

package/dist/pwa.d.ts

@@ -1,4 +1,4 @@
-import * as react1 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(): react1.FunctionComponentElement<react1.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.78-alpha.0",
+  "version": "0.0.78-alpha.2",
   "type": "module",
   "exports": {
     ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" },

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

@@ -12,7 +12,7 @@ description: >-
 metadata:
   type: sub-skill
   library: softr-sdk
-  library_version: 0.0.78-alpha.0
+  library_version: 0.0.78-alpha.2
 ---
 
 **Boundary.** `ai` lives on `@softr/sdk/server` and runs only inside a `createServerFn` handler — importing it into a component fails the build. `defineAiAction` and every type come from `@softr/sdk` and can be imported anywhere.
@@ -55,6 +55,9 @@ Declare one action per feature — the summary and the extraction are two action
 - `schema` — a JSON schema the answer has to match. With it the model is asked for JSON only, and the answer comes back parsed in `json` as well as written in `text`.
 - `files` — documents and images the model reads, each as `{ url, mimeType? }`: an `https` URL Softr may fetch, one of the app's own uploads as a rule.
 - `maxOutputTokens` — a cap on the answer's length. Softr caps it further.
+- `messages` — the earlier turns of a conversation, oldest first, each `{ role: 'user' | 'assistant', content }`. The prompt is the newest turn. Leave out for a one-shot call.
+- `reasoning` — `'low'`, `'medium'` or `'high'`: how hard a reasoning model thinks before it answers. The catalog says which models reason; the others ignore it. Leave out for the provider's default.
+- `temperature` — 0 to 1: how varied the answer is. `0` for an extraction or a classification, around `0.7` for a draft. A low default when left out.
 
 The answer is `{ text, json, usage, model }`: `text` as the model wrote it, `json` parsed when a schema was given and the model kept to it, `null` otherwise.
 
@@ -102,6 +105,26 @@ const extractInvoice = createServerFn({ method: 'POST' })
 
 The file's URL comes from the app's own upload: load the Softr SDK `file-uploads` guidance for that half. `readInvoice` names a model whose `bestFor` reads PDF documents.
 
+## A conversation
+
+A chat sends its earlier turns in `messages` and the new one as `prompt`. The app keeps the turns; the model holds nothing between calls.
+
+```ts
+const reply = createServerFn({ method: 'POST' })
+  .validator(z.object({ turns: z.array(z.object({ role: z.enum(['user', 'assistant']), content: z.string() })), prompt: z.string() }))
+  .handler(async ({ data }) => {
+    const answer = await ai.generate(supportChat, {
+      system: 'You answer questions about the order the user is looking at.',
+      messages: data.turns,
+      prompt: data.prompt,
+      temperature: 0.5,
+    })
+    return answer.text
+  })
+```
+
+A chat the user watches being written streams instead, with the same `messages`: see the next section.
+
 ## Streaming: an answer the user watches being written
 
 A chat, an assistant, a long draft shown as it is typed — never buffer these: the user would watch a blank panel until the last token. `ai.stream(action, init)` takes the same `init` and answers with a `Response` whose body is a stream of Server-Sent Events. Hand it to the browser from the server function, unchanged: