@lovable.dev/workflows-sdk 0.0.0-dev.53 → 0.0.0-dev.55

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -76,7 +76,11 @@ and returns assistant text. Pass a provider-prefixed `model` and either `prompt`
76
76
  or nonempty text-only user/assistant `messages`. Optional `system` supplies system
77
77
  instructions; `maxTokens` defaults to 4096. Use a unique `options.id` and a literal
78
78
  `options.meta.description`, with item-based template IDs for repeated calls.
79
- Compatible OpenAI and Gemini Chat Completions text models are supported.
79
+ Compatible OpenAI and Gemini Chat Completions models and Claude Messages models
80
+ are supported for text generation. Claude uses the separate `system` field and
81
+ returns joined text blocks; thinking blocks are excluded. Its token budget includes
82
+ thinking. Token-limit or context-window truncation fails the step with a truncation
83
+ error. Refusals, tool requests, paused turns, and responses without text also fail.
80
84
  Streaming, tools, images, and structured output are outside this API.
81
85
 
82
86
  The Gateway SDK reads the app's server-side `LOVABLE_API_KEY`; the generated
@@ -95,15 +99,16 @@ bun -e 'import { listModels } from "@lovable.dev/ai-gateway"; console.log(JSON.s
95
99
 
96
100
  Require `workspace_models: "included"`; missing markers, public catalogs, and
97
101
  invalid credentials do not establish project access. Choose an exact eligible
98
- OpenAI or Gemini model ID whose `supported_surfaces` includes `chat-completions`
99
- and `modalities.output` includes `text`. Use the project's resolved default when
100
- compatible, then run `bunx ai-gateway generate --model <model-id>` and inspect its
101
- Chat Completions contract for text support. Discovery happens while authoring,
102
- not on every workflow run.
102
+ model ID whose `modalities.output` includes `text`. Its `supported_surfaces` must
103
+ include `chat-completions` for `openai/...` and `google/gemini-...`, or `messages`
104
+ for `anthropic/claude-...`. Use the project's resolved default when compatible,
105
+ then run `bunx ai-gateway generate --model <model-id>` and inspect the matching
106
+ surface's text contract. Discovery happens while authoring, not on every workflow run.
103
107
 
104
108
  Run LLM workflows through the generated `/steps` route. The standalone
105
109
  `createTanStackWorkflowHandler` uses TanStack's runtime and does not support LLM steps.
106
110
  Real app-side calls require SDK `0.0.0-dev.49` or newer.
111
+ Claude support requires SDK `0.0.0-dev.54` or newer.
107
112
 
108
113
  Both `ctx.approve` and `ctx.waitForEvent` require `timeoutMs`: a duration in
109
114
  milliseconds, written as a finite numeric literal of at least 60000 (one minute) (for example,
@@ -225,8 +230,10 @@ meta: {
225
230
 
226
231
  Declare schedules with `defineSchedule({ id, workflow, cadence, timeZone,
227
232
  input })` and include them in the collection's `triggers`. The workflow must be
228
- part of the same collection, and schedule IDs must be unique. This API declares
229
- schedules; Lovable execution is not available yet.
233
+ part of the same collection, and schedule IDs must be unique. Schedules run on
234
+ the published app only: publishing registers them, and the preview never runs
235
+ them. Each publish replaces the app's schedules with the ones its workflows
236
+ declare.
230
237
 
231
238
  ```ts
232
239
  const morning = defineSchedule({
@@ -251,12 +258,17 @@ const morning = defineSchedule({
251
258
  `at` lists and runs at every selected hour on every selected weekday. Hours are
252
259
  whole numbers from 0 through 23; schedules do not accept minute or raw-cron
253
260
  fields. `timeZone` is required and accepts `"UTC"` or a canonical IANA region
254
- such as `"America/New_York"`. A scheduled hour is approximate: Lovable chooses
255
- a stable offset within the corresponding scheduling window.
261
+ such as `"America/New_York"`. A run starts at a fixed offset of 0 to 3599
262
+ seconds after its scheduled hour. Lovable picks the offset for each schedule
263
+ and keeps it, so `daily({ at: [9] })` starts at the same time between 09:00 and
264
+ 09:59 every day.
256
265
 
257
266
  `overlapPolicy` controls what happens when a schedule becomes due while its
258
267
  previous run is active. `skip` drops it, `allow` starts another run, and
259
268
  `buffer-one` starts the earliest missed run after the active run finishes.
269
+ Lovable supports only `skip` today. If any schedule of a workflow declares
270
+ `allow` or `buffer-one`, publishing registers none of that workflow's
271
+ schedules.
260
272
 
261
273
  ## Build integration
262
274
 
@@ -1,4 +1,4 @@
1
- import { loadTypeScript, t as workflowHandlerSource } from "./graph-CM_9qQRY.js";
1
+ import { loadTypeScript, t as workflowHandlerSource } from "./graph-B8nm_0lL.js";
2
2
  //#region src/manifests/branch-metadata.ts
3
3
  const optionsArgument = {
4
4
  step: 2,
@@ -1,4 +1,4 @@
1
- import { loadTypeScript, t as workflowHandlerSource } from "./graph-CM_9qQRY.js";
1
+ import { loadTypeScript, t as workflowHandlerSource } from "./graph-B8nm_0lL.js";
2
2
  //#region src/manifests/context-escapes.ts
3
3
  const durableMethods = /* @__PURE__ */ new Set([
4
4
  "step",
@@ -1,4 +1,4 @@
1
- import { loadTypeScript, t as workflowHandlerSource } from "./graph-CM_9qQRY.js";
1
+ import { loadTypeScript, t as workflowHandlerSource } from "./graph-B8nm_0lL.js";
2
2
  //#region src/manifests/duplicate-ids.ts
3
3
  /** Where an explicit `{ id }` would sit for each operation. */
4
4
  const optionsArgument = {
@@ -6626,7 +6626,7 @@ function listValueFromJson(listValue, json) {
6626
6626
  }
6627
6627
  //#endregion
6628
6628
  //#region package.json
6629
- var version = "0.0.0-dev.53";
6629
+ var version = "0.0.0-dev.55";
6630
6630
  //#endregion
6631
6631
  //#region src/proto/lovable/appworkflows/v1/workflow_manifest_pb.ts
6632
6632
  /**
@@ -6839,15 +6839,15 @@ function serializeSchema(schema, direction, label) {
6839
6839
  }
6840
6840
  }
6841
6841
  async function generateManifests(definition, options = {}) {
6842
- const { extractWorkflowGraph } = await import("./graph-CM_9qQRY.js");
6843
- const { findBranchMetadataIssues } = await import("./branch-metadata-CNODXoto.js");
6844
- const { findWorkflowContextEscapes } = await import("./context-escapes-BNHZCoPP.js");
6845
- const { findDuplicateOperationIds } = await import("./duplicate-ids-x8RBlqqt.js");
6842
+ const { extractWorkflowGraph } = await import("./graph-B8nm_0lL.js");
6843
+ const { findBranchMetadataIssues } = await import("./branch-metadata-DwHXcGhW.js");
6844
+ const { findWorkflowContextEscapes } = await import("./context-escapes-DXcshuq_.js");
6845
+ const { findDuplicateOperationIds } = await import("./duplicate-ids-CjHjQ-8X.js");
6846
6846
  const { DURABLE_ID_REQUIRED } = await import("./durable-ids-Cx341nJQ.js").then((n) => n.n);
6847
- const { findNestedDurableOperations } = await import("./nested-operations-uuh9dqQ4.js");
6848
- const { findOperationDescriptionIssues } = await import("./operation-descriptions-CckzdTDh.js");
6849
- const { findStepMetadataIssues } = await import("./step-metadata-DKOzeqh8.js");
6850
- const { findWaitDeadlineIssues } = await import("./wait-deadlines-Cm5bsMxr.js");
6847
+ const { findNestedDurableOperations } = await import("./nested-operations-BV4UlbjT.js");
6848
+ const { findOperationDescriptionIssues } = await import("./operation-descriptions-Cx_MM5Np.js");
6849
+ const { findStepMetadataIssues } = await import("./step-metadata-DbjEAD0E.js");
6850
+ const { findWaitDeadlineIssues } = await import("./wait-deadlines-DE0s1vnw.js");
6851
6851
  const { WAIT_DEADLINE_REQUIRED } = await import("./wait-deadlines-DpK-Fgnd.js");
6852
6852
  const collection = registerWorkflows(definition);
6853
6853
  const manifests = [];
@@ -1,4 +1,4 @@
1
- import { C as WorkflowManifestWaitForEventNodeV1Schema, S as WorkflowManifestUuidNodeV1Schema, _ as WorkflowManifestSleepNodeV1Schema, a as WorkflowManifestConnectorNodeV1Schema, b as WorkflowManifestStepNodeV1Schema, c as WorkflowManifestGraphV1Schema, d as WorkflowManifestNowNodeV1Schema, f as WorkflowManifestOrderEdgeV1Schema, g as WorkflowManifestRepeatedStepV1Schema, h as WorkflowManifestRepeatedLlmV1Schema, i as WorkflowManifestBranchNodeV1Schema, l as WorkflowManifestLlmNodeV1Schema, m as WorkflowManifestRepeatedConnectorV1Schema, n as WorkflowManifestApproveNodeV1Schema, o as WorkflowManifestGraphEdgeV1Schema, p as WorkflowManifestParallelNodeV1Schema, r as WorkflowManifestBranchEdgeV1Schema, s as WorkflowManifestGraphNodeV1Schema, u as WorkflowManifestLoopNodeV1Schema, v as WorkflowManifestSleepUntilNodeV1Schema, w as create, x as WorkflowManifestUnknownNodeV1Schema, y as WorkflowManifestStepExecutionPolicyV1Schema } from "./generate-Cn2I_zLU.js";
1
+ import { C as WorkflowManifestWaitForEventNodeV1Schema, S as WorkflowManifestUuidNodeV1Schema, _ as WorkflowManifestSleepNodeV1Schema, a as WorkflowManifestConnectorNodeV1Schema, b as WorkflowManifestStepNodeV1Schema, c as WorkflowManifestGraphV1Schema, d as WorkflowManifestNowNodeV1Schema, f as WorkflowManifestOrderEdgeV1Schema, g as WorkflowManifestRepeatedStepV1Schema, h as WorkflowManifestRepeatedLlmV1Schema, i as WorkflowManifestBranchNodeV1Schema, l as WorkflowManifestLlmNodeV1Schema, m as WorkflowManifestRepeatedConnectorV1Schema, n as WorkflowManifestApproveNodeV1Schema, o as WorkflowManifestGraphEdgeV1Schema, p as WorkflowManifestParallelNodeV1Schema, r as WorkflowManifestBranchEdgeV1Schema, s as WorkflowManifestGraphNodeV1Schema, u as WorkflowManifestLoopNodeV1Schema, v as WorkflowManifestSleepUntilNodeV1Schema, w as create, x as WorkflowManifestUnknownNodeV1Schema, y as WorkflowManifestStepExecutionPolicyV1Schema } from "./generate-DOuPyG-r.js";
2
2
  import { n as assertLlmOptions, t as assertLlmModel } from "./llm-validation-DdDO6csU.js";
3
3
  //#region src/manifests/handler-source.ts
4
4
  const nativeFunctionSource = /\{\s*\[native code\]\s*\}\s*$/;
package/dist/index.js CHANGED
@@ -1,8 +1,8 @@
1
1
  import { t as DURABLE_ID_REQUIRED } from "./durable-ids-Cx341nJQ.js";
2
- import { A as daily, D as registerWorkflows, E as createWorkflow, M as weekly, O as workflowVersions, T as createMiddleware, j as hourly, k as defineSchedule, t as generateManifests } from "./generate-Cn2I_zLU.js";
2
+ import { A as daily, D as registerWorkflows, E as createWorkflow, M as weekly, O as workflowVersions, T as createMiddleware, j as hourly, k as defineSchedule, t as generateManifests } from "./generate-DOuPyG-r.js";
3
3
  import { n as assertLlmOptions, r as assertLlmRequest } from "./llm-validation-DdDO6csU.js";
4
4
  import { WorkflowRequestParseError, inMemoryRunStore, parseWorkflowRequest, runWorkflow } from "@tanstack/workflow-core";
5
- import { generateChatCompletion } from "@lovable.dev/ai-gateway";
5
+ import { generateChatCompletion, generateMessage } from "@lovable.dev/ai-gateway";
6
6
  //#region src/stacks/tanstack/sse.ts
7
7
  const HEADERS = {
8
8
  "content-type": "text/event-stream; charset=utf-8",
@@ -203,6 +203,7 @@ function assertConnectorOptions(options) {
203
203
  //#endregion
204
204
  //#region src/runtime/llm.ts
205
205
  const completeChat = generateChatCompletion;
206
+ const completeMessage = generateMessage;
206
207
  function chatRequest(request) {
207
208
  const messages = request.prompt !== void 0 ? [{
208
209
  role: "user",
@@ -224,10 +225,34 @@ function chatRequest(request) {
224
225
  max_tokens: maxTokens,
225
226
  modalities: ["text"]
226
227
  };
227
- throw new Error("ctx.llm requires an OpenAI or Gemini model with Chat Completions text support");
228
+ throw new Error("ctx.llm requires an OpenAI or Gemini Chat Completions model, or a Claude Messages model");
229
+ }
230
+ function claudeText(response) {
231
+ if (response === null || typeof response !== "object" || !("content" in response) || !Array.isArray(response.content) || "stop_reason" in response && (response.stop_reason === "refusal" || response.stop_reason === "tool_use" || response.stop_reason === "pause_turn")) throw new Error("AI Gateway returned no assistant text");
232
+ if ("stop_reason" in response && (response.stop_reason === "max_tokens" || response.stop_reason === "model_context_window_exceeded")) throw new Error(`AI Gateway returned truncated Claude text (${response.stop_reason})`);
233
+ const text = response.content.map((block) => {
234
+ if (block === null || typeof block !== "object" || !("type" in block)) throw new Error("AI Gateway returned no assistant text");
235
+ if (block.type !== "text") return "";
236
+ if (!("text" in block) || typeof block.text !== "string") throw new Error("AI Gateway returned no assistant text");
237
+ return block.text;
238
+ }).join("");
239
+ if (text.trim() === "") throw new Error("AI Gateway returned no assistant text");
240
+ return text;
228
241
  }
229
242
  async function generateLlmText(request, options) {
230
243
  assertLlmRequest(request);
244
+ if (request.model.startsWith("anthropic/claude-")) return claudeText(await completeMessage({
245
+ model: request.model,
246
+ messages: request.prompt !== void 0 ? [{
247
+ role: "user",
248
+ content: request.prompt
249
+ }] : request.messages,
250
+ ...request.system === void 0 ? {} : { system: request.system },
251
+ max_tokens: request.maxTokens ?? 4096
252
+ }, {
253
+ ...options,
254
+ maxRetries: 0
255
+ }));
231
256
  const message = (await completeChat(chatRequest(request), {
232
257
  ...options,
233
258
  maxRetries: 0
@@ -1,4 +1,4 @@
1
- import { loadTypeScript, t as workflowHandlerSource } from "./graph-CM_9qQRY.js";
1
+ import { loadTypeScript, t as workflowHandlerSource } from "./graph-B8nm_0lL.js";
2
2
  //#region src/manifests/nested-operations.ts
3
3
  const durableMethods = [
4
4
  "step",
@@ -1,4 +1,4 @@
1
- import { loadTypeScript, t as workflowHandlerSource } from "./graph-CM_9qQRY.js";
1
+ import { loadTypeScript, t as workflowHandlerSource } from "./graph-B8nm_0lL.js";
2
2
  //#region src/manifests/operation-descriptions.ts
3
3
  const optionsArgument = {
4
4
  approve: 0,
@@ -1,4 +1,4 @@
1
- import { loadTypeScript, t as workflowHandlerSource } from "./graph-CM_9qQRY.js";
1
+ import { loadTypeScript, t as workflowHandlerSource } from "./graph-B8nm_0lL.js";
2
2
  //#region src/manifests/step-metadata.ts
3
3
  async function findStepMetadataIssues(handler) {
4
4
  const api = await loadTypeScript();
package/dist/vite.js CHANGED
@@ -1,4 +1,4 @@
1
- import { t as generateManifests } from "./generate-Cn2I_zLU.js";
1
+ import { t as generateManifests } from "./generate-DOuPyG-r.js";
2
2
  import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
3
3
  import { createServer } from "vite";
4
4
  import { lstat, mkdir, mkdtemp, readdir, rename, rm, writeFile } from "node:fs/promises";
@@ -1,4 +1,4 @@
1
- import { loadTypeScript, t as workflowHandlerSource } from "./graph-CM_9qQRY.js";
1
+ import { loadTypeScript, t as workflowHandlerSource } from "./graph-B8nm_0lL.js";
2
2
  //#region src/manifests/wait-deadlines.ts
3
3
  const optionsArgument = {
4
4
  approve: 0,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lovable.dev/workflows-sdk",
3
- "version": "0.0.0-dev.53",
3
+ "version": "0.0.0-dev.55",
4
4
  "publishConfig": {
5
5
  "access": "public",
6
6
  "tag": "dev",
@@ -31,7 +31,7 @@
31
31
  "dependencies": {
32
32
  "@standard-schema/spec": "^1.1.0",
33
33
  "@tanstack/workflow-core": "0.0.4",
34
- "@lovable.dev/ai-gateway": "0.1.10"
34
+ "@lovable.dev/ai-gateway": "0.1.11"
35
35
  },
36
36
  "devDependencies": {
37
37
  "@bufbuild/protobuf": "^2.10.1",