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

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
@@ -65,6 +65,7 @@ Every durable operation needs a static, user-facing description:
65
65
  | --- | --- |
66
66
  | `ctx.step` | Third argument: `meta.description` |
67
67
  | `ctx.llm` | Second argument: `meta.description` |
68
+ | `ctx.connector` | Third argument: `meta.description` |
68
69
  | `ctx.sleep`, `ctx.sleepUntil` | Second argument: `meta.description` |
69
70
  | `ctx.waitForEvent` | Second argument: `meta.description` |
70
71
  | `ctx.now`, `ctx.uuid` | First argument: `meta.description` |
@@ -129,6 +130,63 @@ Keep durable control flow in the workflow handler. Do not pass, alias,
129
130
  destructure, or return `ctx`, and do not detach methods such as `ctx.step`.
130
131
  Pass extracted data such as `ctx.input.customerId` to helpers instead.
131
132
 
133
+ ### Connector callbacks
134
+
135
+ SDK `0.0.0-dev.52` is the first version that executes
136
+ `ctx.connector(stepId, callback, options)` through the generated `/steps` route.
137
+ Use it for gateway-backed App connectors: a connection linked to the app,
138
+ shared across workflow runs. App User Connectors, which act for individual app
139
+ users, are outside this authoring flow.
140
+
141
+ ```ts
142
+ const messages = await ctx.connector("read-messages", ({ signal }) => readMessages(signal), {
143
+ connectorId: "slack", connectionId: "std_REPLACE_WITH_LINKED_CONNECTION_ID",
144
+ meta: { description: "Read recent channel messages" },
145
+ });
146
+ ```
147
+
148
+ Keep `connectorId` and `connectionId` as nonempty string literals in the inline
149
+ options object. They identify the declared step in the manifest and run history;
150
+ credentials enforce access. They cannot vary by workflow input or loop item.
151
+ Use a new workflow version when changing the connection; replay rejects saved
152
+ results or failures whose connector identity differs.
153
+
154
+ The callback receives the normal step context, including `signal`. It owns
155
+ server-side credential access, URL, method, headers, encoding, `fetch`, and
156
+ provider errors. Check both HTTP success and the provider's success fields
157
+ before returning. Forward `signal` to I/O. Return compact JSON-serializable
158
+ data, including plain strings; there is no response envelope. A callback that
159
+ returns `undefined` records and returns `null`. Return parsed data or text,
160
+ never a `Response` or credentials.
161
+
162
+ Select and link an App connection with Lovable's existing connector tools.
163
+ `standard_connectors--get_connection_secrets` takes the connection's `std_...`
164
+ ID and returns exact secret names and generated-app routing, never secret
165
+ values. Follow that routing and run its read-only App credential check before
166
+ using the workflow. Secret names depend on the connection; do not derive them
167
+ from `connectorId`. Keep gateway credentials separate from
168
+ `LOVABLE_WORKFLOWS_KEY`, which authenticates the workflow endpoint.
169
+
170
+ Connector retries inherit `defaultStepRetry`. An inline `retry` replaces that
171
+ default and requires `maxAttempts`; use literal `backoff: "fixed"` or
172
+ `"exponential"` and optional `baseMs`. The engine records custom-policy flags
173
+ but does not invoke `shouldRetry` or backoff callbacks; custom backoff uses
174
+ exponential delays. `timeout` is a positive number of
175
+ milliseconds per attempt. Let the workflow engine retry: disable additional
176
+ client retries and avoid retry loops inside the callback. An external write
177
+ can repeat if its result is lost before persistence; use a provider idempotency
178
+ key derived from stable run input when the provider supports one.
179
+
180
+ Discovery, unselected branches, and completed-step replay never invoke the
181
+ callback. Saved final failures throw into the handler's `try/catch`. The
182
+ standalone `createTanStackWorkflowHandler` does not support connector callbacks.
183
+ See the [Slack digest example](examples/src/lib/workflows/slack-digest/index.ts)
184
+ for a connector read followed by an LLM summary and a saved code-step result.
185
+ The example uses hosted-app gateway authentication. Replace its marked
186
+ connection ID and secret name with the tool output, adapt routing/authentication
187
+ to that output, and select a model through the discovery procedure above before
188
+ running it.
189
+
132
190
  ### Repeated steps
133
191
 
134
192
  A step inside a loop or callback needs `meta.group` with a stable ID and
@@ -142,7 +200,9 @@ ctx.step(`process-${item.id}`, () => processItem(item), {
142
200
 
143
201
  For dynamic sequential work, await one step directly as the only statement in
144
202
  a `for...of` loop. For dynamic parallel work, use a mapped `Promise.all()`.
145
- Both forms support `ctx.step` and `ctx.llm`; see [order summaries](examples/src/lib/workflows/order-summaries/index.ts).
203
+ Both forms support `ctx.step`, `ctx.llm`, and `ctx.connector`; see [order summaries](examples/src/lib/workflows/order-summaries/index.ts).
204
+ Repeated connector steps keep the same literal connector and connection IDs
205
+ while each item gets a unique step ID.
146
206
  Use a different group ID for each repeated callsite, and derive item IDs from
147
207
  workflow input or saved step results so replay reaches the same operations.
148
208
  Fixed `Promise.all([stepA, stepB])` branches and ordinary sequential steps do
@@ -1,4 +1,4 @@
1
- import { loadTypeScript, t as workflowHandlerSource } from "./graph-hyLFsA4e.js";
1
+ import { loadTypeScript, t as workflowHandlerSource } from "./graph-CM_9qQRY.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-hyLFsA4e.js";
1
+ import { loadTypeScript, t as workflowHandlerSource } from "./graph-CM_9qQRY.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-hyLFsA4e.js";
1
+ import { loadTypeScript, t as workflowHandlerSource } from "./graph-CM_9qQRY.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.51";
6629
+ var version = "0.0.0-dev.53";
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-hyLFsA4e.js");
6843
- const { findBranchMetadataIssues } = await import("./branch-metadata-6HOnn-8N.js");
6844
- const { findWorkflowContextEscapes } = await import("./context-escapes-BCvLh-Lp.js");
6845
- const { findDuplicateOperationIds } = await import("./duplicate-ids-CONqQni3.js");
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");
6846
6846
  const { DURABLE_ID_REQUIRED } = await import("./durable-ids-Cx341nJQ.js").then((n) => n.n);
6847
- const { findNestedDurableOperations } = await import("./nested-operations-Cmv5FgCH.js");
6848
- const { findOperationDescriptionIssues } = await import("./operation-descriptions-up__3vhJ.js");
6849
- const { findStepMetadataIssues } = await import("./step-metadata-ChbAFlXH.js");
6850
- const { findWaitDeadlineIssues } = await import("./wait-deadlines-C3mjgUjl.js");
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");
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-DWDmQEg6.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-Cn2I_zLU.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.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import { AccumulateExtensions, AnyMiddleware, AnyWorkflowDefinition, AnyWorkflowDefinition as AnyWorkflowDefinition$1, ApprovalResult, ApproveOptions as ApproveOptions$1, CreateWorkflowConfig, Ctx as Ctx$1, InferSchema, RunStore, SchemaInput, StepContext, StepOptions, WaitForEventOptions as WaitForEventOptions$1, WorkflowBuilder, WorkflowDefinition, WorkflowDefinition as WorkflowDefinition$1, WorkflowEvent, WorkflowInput, WorkflowInput as WorkflowInput$1, WorkflowMetadata, WorkflowOutput, WorkflowState, createMiddleware } from "@tanstack/workflow-core";
1
+ import { AccumulateExtensions, AnyMiddleware, AnyWorkflowDefinition, AnyWorkflowDefinition as AnyWorkflowDefinition$1, ApprovalResult, ApproveOptions as ApproveOptions$1, CreateWorkflowConfig, Ctx as Ctx$1, InferSchema, RunStore, SchemaInput, StepContext, StepContext as StepContext$1, StepOptions, StepOptions as StepOptions$1, WaitForEventOptions as WaitForEventOptions$1, WorkflowBuilder, WorkflowDefinition, WorkflowDefinition as WorkflowDefinition$1, WorkflowEvent, WorkflowInput, WorkflowInput as WorkflowInput$1, WorkflowMetadata, WorkflowOutput, WorkflowState, createMiddleware } from "@tanstack/workflow-core";
2
2
  //#region src/core/step-metadata.d.ts
3
3
  interface WorkflowStepGroup {
4
4
  id: string;
@@ -16,6 +16,14 @@ type WorkflowStepMetadata = WorkflowOperationMetadata & {
16
16
  group?: WorkflowStepGroup;
17
17
  };
18
18
  //#endregion
19
+ //#region src/core/connector.d.ts
20
+ interface ConnectorStepOptions extends StepOptions$1 {
21
+ connectorId: string;
22
+ connectionId: string;
23
+ meta: WorkflowStepMetadata;
24
+ }
25
+ type ConnectorStep = <T>(stepId: string, callback: (stepCtx: StepContext$1) => T | Promise<T>, options: ConnectorStepOptions) => Promise<T extends void ? null : T>;
26
+ //#endregion
19
27
  //#region src/core/llm.d.ts
20
28
  type LlmRequest = {
21
29
  model: string;
@@ -100,6 +108,7 @@ type WaitForEventOptions<TPayload = unknown> = Omit<WaitForEventOptions$1<TPaylo
100
108
  deadline?: never;
101
109
  };
102
110
  type Ctx<TInput = unknown, TState = Record<string, unknown>, TExtensions = unknown> = Omit<Ctx$1<TInput, TState>, "approve" | "waitForEvent"> & {
111
+ connector: ConnectorStep;
103
112
  llm: LlmStep;
104
113
  approve: (options: ApproveOptions) => Promise<ApprovalResult>;
105
114
  waitForEvent: <TPayload = unknown>(name: string, options: WaitForEventOptions<TPayload>) => Promise<TPayload>;
@@ -894,7 +903,7 @@ declare function createTanStackWorkflowHandler(collection: WorkflowCollection, o
894
903
  //#endregion
895
904
  //#region src/runtime/types.d.ts
896
905
  /** Durable operations a replay can answer from the memo. */
897
- type StepKind = "step" | "llm" | "sleep" | "waitForEvent" | "approve" | "now" | "uuid";
906
+ type StepKind = "step" | "llm" | "connector" | "sleep" | "waitForEvent" | "approve" | "now" | "uuid";
898
907
  /**
899
908
  * One settled durable operation. The memo is the whole run state: the caller
900
909
  * carries it between calls, so no run store is involved.
@@ -949,7 +958,7 @@ interface ReplayOutcome {
949
958
  error?: string;
950
959
  }
951
960
  interface StepReference {
952
- kind: "step" | "llm";
961
+ kind: "step" | "llm" | "connector";
953
962
  stepId: string;
954
963
  }
955
964
  //#endregion
@@ -986,7 +995,7 @@ type StepsDisposition = "advanced" | "fork" | "waiting" | "completed" | "failed"
986
995
  interface StepsResponse {
987
996
  disposition: StepsDisposition;
988
997
  memoDelta: MemoEntry[];
989
- executed?: StepResult<"step" | "llm">;
998
+ executed?: StepResult<StepReference["kind"]>;
990
999
  workflowVersion: string;
991
1000
  runId: string;
992
1001
  inputHash: string;
@@ -1007,4 +1016,4 @@ declare function createStepsHandler(collection: WorkflowCollection, options?: St
1007
1016
  */
1008
1017
  declare function toServerSentEventsResponse(events: AsyncIterable<WorkflowEvent>): Response;
1009
1018
  //#endregion
1010
- export { type AnyWorkflowDefinition, type ApproveOptions, type Cadence, type Ctx, type LlmRequest, type LlmStep, type LlmStepOptions, type MemoEntry, type NextStep, type OverlapPolicy, type ReplayOutcome, type ResolvedSchedule, type ResolvedTrigger, type ScheduleDefinition, type StepContext, type StepIntent, type StepKind, type StepOptions, type StepReference, type StepResult, type StepsDisposition, type StepsHandler, type StepsHandlerOptions, type StepsRequest, type StepsResponse, type TanStackWorkflowHandler, type TanStackWorkflowHandlerOptions, type TriggerDefinition, type WaitForEventOptions, type Weekday, type WorkflowBranchMetadata, type WorkflowCollection, type WorkflowDefinition, type WorkflowInput, type WorkflowManifest, type WorkflowOperationMetadata, type WorkflowOutput, type WorkflowState, type WorkflowStepGroup, type WorkflowStepMetadata, type WorkflowsDefinition, createMiddleware, createStepsHandler, createTanStackWorkflowHandler, createWorkflow, daily, defineSchedule, generateManifests, hourly, registerWorkflows, toServerSentEventsResponse, weekly };
1019
+ export { type AnyWorkflowDefinition, type ApproveOptions, type Cadence, type ConnectorStep, type ConnectorStepOptions, type Ctx, type LlmRequest, type LlmStep, type LlmStepOptions, type MemoEntry, type NextStep, type OverlapPolicy, type ReplayOutcome, type ResolvedSchedule, type ResolvedTrigger, type ScheduleDefinition, type StepContext, type StepIntent, type StepKind, type StepOptions, type StepReference, type StepResult, type StepsDisposition, type StepsHandler, type StepsHandlerOptions, type StepsRequest, type StepsResponse, type TanStackWorkflowHandler, type TanStackWorkflowHandlerOptions, type TriggerDefinition, type WaitForEventOptions, type Weekday, type WorkflowBranchMetadata, type WorkflowCollection, type WorkflowDefinition, type WorkflowInput, type WorkflowManifest, type WorkflowOperationMetadata, type WorkflowOutput, type WorkflowState, type WorkflowStepGroup, type WorkflowStepMetadata, type WorkflowsDefinition, createMiddleware, createStepsHandler, createTanStackWorkflowHandler, createWorkflow, daily, defineSchedule, generateManifests, hourly, registerWorkflows, toServerSentEventsResponse, weekly };
package/dist/index.js CHANGED
@@ -1,5 +1,5 @@
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-DWDmQEg6.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";
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
5
  import { generateChatCompletion } from "@lovable.dev/ai-gateway";
@@ -126,41 +126,6 @@ async function hashInput(input) {
126
126
  return [...new Uint8Array(digest)].slice(0, 16).map((byte) => byte.toString(16).padStart(2, "0")).join("");
127
127
  }
128
128
  //#endregion
129
- //#region src/runtime/llm.ts
130
- const completeChat = generateChatCompletion;
131
- function chatRequest(request) {
132
- const messages = request.prompt !== void 0 ? [{
133
- role: "user",
134
- content: request.prompt
135
- }] : request.messages;
136
- const conversation = [...request.system === void 0 ? [] : [{
137
- role: "system",
138
- content: request.system
139
- }], ...messages];
140
- const maxTokens = request.maxTokens ?? 4096;
141
- if (request.model.startsWith("openai/")) return {
142
- model: request.model,
143
- messages: conversation,
144
- max_completion_tokens: maxTokens
145
- };
146
- if (request.model.startsWith("google/gemini-")) return {
147
- model: request.model,
148
- messages: conversation,
149
- max_tokens: maxTokens,
150
- modalities: ["text"]
151
- };
152
- throw new Error("ctx.llm requires an OpenAI or Gemini model with Chat Completions text support");
153
- }
154
- async function generateLlmText(request, options) {
155
- assertLlmRequest(request);
156
- const message = (await completeChat(chatRequest(request), {
157
- ...options,
158
- maxRetries: 0
159
- }))?.choices?.[0]?.message;
160
- if (message?.refusal || typeof message?.content !== "string" || message.content.trim() === "") throw new Error("AI Gateway returned no assistant text");
161
- return message.content;
162
- }
163
- //#endregion
164
129
  //#region src/runtime/operations.ts
165
130
  var ReplayOperations = class {
166
131
  memo;
@@ -191,6 +156,10 @@ var ReplayOperations = class {
191
156
  this.error = `memo has ${answered.kind} "${stepId}", replay produced ${kind}`;
192
157
  return;
193
158
  }
159
+ if (kind === "connector" && (answered.meta?.connectorId !== meta?.connectorId || answered.meta?.connectionId !== meta?.connectionId)) {
160
+ this.error = `memo has a different connectorId or connectionId for connector "${stepId}"`;
161
+ return;
162
+ }
194
163
  const recordedGroupId = groupId(answered.meta);
195
164
  if (recordedGroupId !== void 0 && recordedGroupId !== groupId(meta)) {
196
165
  this.error = `memo has group "${recordedGroupId}" for step "${stepId}", replay produced a different group`;
@@ -212,6 +181,9 @@ var ReplayOperations = class {
212
181
  };
213
182
  }
214
183
  };
184
+ function isRunnableKind(kind) {
185
+ return kind === "step" || kind === "llm" || kind === "connector";
186
+ }
215
187
  function groupId(meta) {
216
188
  const group = meta?.group;
217
189
  if (group === null || typeof group !== "object") return void 0;
@@ -219,12 +191,58 @@ function groupId(meta) {
219
191
  return typeof id === "string" ? id : void 0;
220
192
  }
221
193
  //#endregion
194
+ //#region src/core/connector.ts
195
+ function assertConnectorOptions(options) {
196
+ if (options === null || typeof options !== "object") throw new Error("@lovable.dev/workflows-sdk: ctx.connector() requires an options object");
197
+ const fields = options;
198
+ for (const field of ["connectorId", "connectionId"]) {
199
+ const value = fields[field];
200
+ if (typeof value !== "string" || !value.trim()) throw new Error(`@lovable.dev/workflows-sdk: ctx.connector() requires a nonempty ${field}`);
201
+ }
202
+ }
203
+ //#endregion
204
+ //#region src/runtime/llm.ts
205
+ const completeChat = generateChatCompletion;
206
+ function chatRequest(request) {
207
+ const messages = request.prompt !== void 0 ? [{
208
+ role: "user",
209
+ content: request.prompt
210
+ }] : request.messages;
211
+ const conversation = [...request.system === void 0 ? [] : [{
212
+ role: "system",
213
+ content: request.system
214
+ }], ...messages];
215
+ const maxTokens = request.maxTokens ?? 4096;
216
+ if (request.model.startsWith("openai/")) return {
217
+ model: request.model,
218
+ messages: conversation,
219
+ max_completion_tokens: maxTokens
220
+ };
221
+ if (request.model.startsWith("google/gemini-")) return {
222
+ model: request.model,
223
+ messages: conversation,
224
+ max_tokens: maxTokens,
225
+ modalities: ["text"]
226
+ };
227
+ throw new Error("ctx.llm requires an OpenAI or Gemini model with Chat Completions text support");
228
+ }
229
+ async function generateLlmText(request, options) {
230
+ assertLlmRequest(request);
231
+ const message = (await completeChat(chatRequest(request), {
232
+ ...options,
233
+ maxRetries: 0
234
+ }))?.choices?.[0]?.message;
235
+ if (message?.refusal || typeof message?.content !== "string" || message.content.trim() === "") throw new Error("AI Gateway returned no assistant text");
236
+ return message.content;
237
+ }
238
+ //#endregion
222
239
  //#region src/runtime/replay.ts
223
240
  /** How long a pass waits for handler work that is not a durable operation. */
224
241
  const DEFAULT_SETTLE_MS = 5e3;
225
242
  const EXECUTABLE = /* @__PURE__ */ new Set([
226
243
  "step",
227
244
  "llm",
245
+ "connector",
228
246
  "now",
229
247
  "uuid"
230
248
  ]);
@@ -270,7 +288,7 @@ async function replay(options) {
270
288
  function record(entry) {
271
289
  settled.set(entry.stepId, entry);
272
290
  lastProgress = Date.now();
273
- if (entry.kind === "step" || entry.kind === "llm") pass.stepsSettled += 1;
291
+ if (isRunnableKind(entry.kind)) pass.stepsSettled += 1;
274
292
  const result = {
275
293
  seq: entry.seq,
276
294
  stepId: entry.stepId,
@@ -338,6 +356,22 @@ async function replay(options) {
338
356
  const state = { ...workflow.initialize?.({ input }) };
339
357
  const runtime = runtimeContext();
340
358
  const signal = options.signal ?? new AbortController().signal;
359
+ function connector(id, callback, stepOptions) {
360
+ assertConnectorOptions(stepOptions);
361
+ return durable("connector", id, async () => {
362
+ const result = await callback({
363
+ id,
364
+ attempt: 1,
365
+ runtime,
366
+ signal
367
+ });
368
+ return result === void 0 ? null : result;
369
+ }, void 0, {
370
+ ...stepOptions.meta,
371
+ connectorId: stepOptions.connectorId,
372
+ connectionId: stepOptions.connectionId
373
+ });
374
+ }
341
375
  const llm = (request, stepOptions) => {
342
376
  assertLlmOptions(stepOptions);
343
377
  return durable("llm", stepOptions.id, () => generateLlmText(request, {
@@ -355,6 +389,7 @@ async function replay(options) {
355
389
  state,
356
390
  signal,
357
391
  runtime,
392
+ connector,
358
393
  llm,
359
394
  step: (id, fn, stepOptions) => durable("step", id, async () => fn({
360
395
  id,
@@ -519,7 +554,7 @@ async function authorizeProjectRequest(request, getProjectSecret) {
519
554
  function disposition(outcome) {
520
555
  if (outcome.status === "completed") return "completed";
521
556
  if (outcome.status === "failed") return "failed";
522
- if (!outcome.steps.some((step) => step.kind === "step" || step.kind === "llm")) return "waiting";
557
+ if (!outcome.steps.some((step) => isRunnableKind(step.kind))) return "waiting";
523
558
  return outcome.steps.length > 1 ? "fork" : "advanced";
524
559
  }
525
560
  function memoDelta(before, after) {
@@ -584,7 +619,7 @@ function parseBody(value) {
584
619
  if (new Set(body.memo.map((entry) => entry.stepId)).size !== body.memo.length) return "memo entries must be unique per stepId";
585
620
  }
586
621
  if (body.action !== void 0 && body.action !== "advance" && body.action !== "execute") return "action must be \"advance\" or \"execute\"";
587
- if (body.action === "execute" && !isStepReference(body.step)) return "step must be a { kind: \"step\" | \"llm\", stepId } reference when action is \"execute\"";
622
+ if (body.action === "execute" && !isStepReference(body.step)) return "step must be a { kind: \"step\" | \"llm\" | \"connector\", stepId } reference when action is \"execute\"";
588
623
  if (body.action !== "execute" && body.step !== void 0) return "step is only valid when action is \"execute\"";
589
624
  if (body.memo !== void 0 && body.memo.length > 0 && !("input" in value)) return "input must be sent with every call, including a resume";
590
625
  return body;
@@ -594,12 +629,9 @@ async function readBody(request) {
594
629
  if (!text.trim()) return {};
595
630
  return JSON.parse(text);
596
631
  }
597
- function isRunnableKind(kind) {
598
- return kind === "step" || kind === "llm";
599
- }
600
632
  function isStepReference(value) {
601
633
  const step = value;
602
- return typeof step === "object" && step !== null && (step.kind === "step" || step.kind === "llm") && typeof step.stepId === "string";
634
+ return typeof step === "object" && step !== null && isRunnableKind(step.kind) && typeof step.stepId === "string";
603
635
  }
604
636
  function prepare(collection, options) {
605
637
  return {
@@ -1,4 +1,4 @@
1
- import { loadTypeScript, t as workflowHandlerSource } from "./graph-hyLFsA4e.js";
1
+ import { loadTypeScript, t as workflowHandlerSource } from "./graph-CM_9qQRY.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-hyLFsA4e.js";
1
+ import { loadTypeScript, t as workflowHandlerSource } from "./graph-CM_9qQRY.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-hyLFsA4e.js";
1
+ import { loadTypeScript, t as workflowHandlerSource } from "./graph-CM_9qQRY.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-DWDmQEg6.js";
1
+ import { t as generateManifests } from "./generate-Cn2I_zLU.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-hyLFsA4e.js";
1
+ import { loadTypeScript, t as workflowHandlerSource } from "./graph-CM_9qQRY.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.51",
3
+ "version": "0.0.0-dev.53",
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.9"
34
+ "@lovable.dev/ai-gateway": "0.1.10"
35
35
  },
36
36
  "devDependencies": {
37
37
  "@bufbuild/protobuf": "^2.10.1",