@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 +61 -1
- package/dist/{branch-metadata-6HOnn-8N.js → branch-metadata-CNODXoto.js} +1 -1
- package/dist/{context-escapes-BCvLh-Lp.js → context-escapes-BNHZCoPP.js} +1 -1
- package/dist/{duplicate-ids-CONqQni3.js → duplicate-ids-x8RBlqqt.js} +1 -1
- package/dist/{generate-DWDmQEg6.js → generate-Cn2I_zLU.js} +9 -9
- package/dist/{graph-hyLFsA4e.js → graph-CM_9qQRY.js} +1 -1
- package/dist/index.d.ts +14 -5
- package/dist/index.js +75 -43
- package/dist/{nested-operations-Cmv5FgCH.js → nested-operations-uuh9dqQ4.js} +1 -1
- package/dist/{operation-descriptions-up__3vhJ.js → operation-descriptions-CckzdTDh.js} +1 -1
- package/dist/{step-metadata-ChbAFlXH.js → step-metadata-DKOzeqh8.js} +1 -1
- package/dist/vite.js +1 -1
- package/dist/{wait-deadlines-C3mjgUjl.js → wait-deadlines-Cm5bsMxr.js} +1 -1
- package/package.json +2 -2
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.
|
|
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-
|
|
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.
|
|
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-
|
|
6843
|
-
const { findBranchMetadataIssues } = await import("./branch-metadata-
|
|
6844
|
-
const { findWorkflowContextEscapes } = await import("./context-escapes-
|
|
6845
|
-
const { findDuplicateOperationIds } = await import("./duplicate-ids-
|
|
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-
|
|
6848
|
-
const { findOperationDescriptionIssues } = await import("./operation-descriptions-
|
|
6849
|
-
const { findStepMetadataIssues } = await import("./step-metadata-
|
|
6850
|
-
const { findWaitDeadlineIssues } = await import("./wait-deadlines-
|
|
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-
|
|
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<"
|
|
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-
|
|
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
|
|
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
|
|
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
|
|
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-
|
|
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-
|
|
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";
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@lovable.dev/workflows-sdk",
|
|
3
|
-
"version": "0.0.0-dev.
|
|
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.
|
|
34
|
+
"@lovable.dev/ai-gateway": "0.1.10"
|
|
35
35
|
},
|
|
36
36
|
"devDependencies": {
|
|
37
37
|
"@bufbuild/protobuf": "^2.10.1",
|