@adonis-agora/durable 0.50.0 → 0.51.0

package/skills/durable-workflows/SKILL.md

@@ -132,12 +132,14 @@ Schemas are **any Standard Schema** (zod 3.24+/4, valibot, arktype, effect
 schema, …) — the package depends on none of them. They fit every schema slot:
 `@Step({ input, output })` / `defineStep` (with an unannotated handler the types
 are inferred from the schema), `static workflow = { inputSchema }` (validated at
-`start`, nothing created on failure; the schema's output value is the run's
-input), and `static workflow = { searchAttributes }` (every
+`start`, nothing created on failure; the run stores the input as sent and
+`run` receives the schema's output, re-parsed before every turn — keep the schema
+deterministic and bump `version` when it changes), and `static workflow = { searchAttributes }` (every
 `ctx.upsertSearchAttributes` is validated against the merged attributes; type
 the ctx as `WorkflowCtx<InferSearchAttributes<typeof schema>>` and read back with
 `attributesOf(WorkflowClass, run)`). A failure is a `SchemaValidationError`
-(`FatalError`, code `schema_validation`, issues in `details.issues`) — never
+(`FatalError`, code `invalid_input` / `invalid_output` — `schema_validation` for a
+`searchAttributes` write — issues in `details.issues`) — never
 retried.
 
 ```ts
@@ -291,6 +293,16 @@ export default class DailyReportWorkflow extends BaseWorkflow {
 }
 ```
 
+In `config/durable.ts`, name the workflow with a lazy import, as Adonis does for
+controllers — never a direct class import, which can hang the boot (a service the
+workflow imports awaits `app.booted` while the config is still loading):
+
+```ts
+schedules: [
+  { key: 'daily-report', workflow: () => import('#workflows/daily_report_workflow'), cron: '0 2 * * *' },
+]
+```
+
 Each schedule window starts exactly once across a fleet via an idempotent
 time-bucket run id.