@lunora/server 1.0.0-alpha.23 → 1.0.0-alpha.24

package/dist/types.d.mts

@@ -684,6 +684,21 @@ interface ScheduledJob {
   /** Routing hint forwarded so dispatch lands on the right shard. */
   shardKey?: string;
 }
+/**
+* A schedulable durable-workflow reference — the generated `workflows.<name>` /
+* `agents.<name>` object, which carries its `WORKFLOW_*`/`AGENT_*` binding and
+* stable name. Structural mirror of `@lunora/scheduler`'s `WorkflowReference` so
+* `ctx.scheduler` can target a workflow/agent without a dependency on
+* `@lunora/scheduler` / `@lunora/workflow`. A scheduled workflow target starts a
+* fresh instance on fire (the args become its `params`).
+*/
+interface SchedulableWorkflowReference {
+  /** The `WORKFLOW_*`/`AGENT_*` binding name (present on a generated ref). */
+  readonly binding?: string;
+  readonly isLunoraWorkflow: true;
+  /** The workflow/agent export/stable name (present on a generated ref). */
+  readonly name?: string;
+}
 interface Scheduler {
   /** Cancel a pending job by id. `cancelled` is `false` when no such job exists. */
   cancel: (id: string) => Promise<{
@@ -693,8 +708,15 @@ interface Scheduler {
   get: (id: string) => Promise<ScheduledJob | null>;
   /** List all pending scheduled jobs. */
   list: () => Promise<ScheduledJob[]>;
-  runAfter: (delayMs: number, functionPath: string, args?: Record<string, unknown>) => Promise<string>;
-  runAt: (timestampMs: number, functionPath: string, args?: Record<string, unknown>) => Promise<string>;
+  /**
+  * Schedule a one-shot run `delayMs` from now. `target` is a function path
+  * (`"ns:fn"`) dispatched as a one-shot, or a generated `workflows.&lt;name>` /
+  * `agents.&lt;name>` reference which starts a fresh durable instance on fire
+  * (the args become its `params`).
+  */
+  runAfter: (delayMs: number, target: SchedulableWorkflowReference | string, args?: Record<string, unknown>) => Promise<string>;
+  /** Like {@link Scheduler.runAfter} but fires at an absolute epoch-ms timestamp. */
+  runAt: (timestampMs: number, target: SchedulableWorkflowReference | string, args?: Record<string, unknown>) => Promise<string>;
 }
 /**
 * A workflow instance's lifecycle status. Clean public mirror of

package/dist/types.d.ts

@@ -684,6 +684,21 @@ interface ScheduledJob {
   /** Routing hint forwarded so dispatch lands on the right shard. */
   shardKey?: string;
 }
+/**
+* A schedulable durable-workflow reference — the generated `workflows.<name>` /
+* `agents.<name>` object, which carries its `WORKFLOW_*`/`AGENT_*` binding and
+* stable name. Structural mirror of `@lunora/scheduler`'s `WorkflowReference` so
+* `ctx.scheduler` can target a workflow/agent without a dependency on
+* `@lunora/scheduler` / `@lunora/workflow`. A scheduled workflow target starts a
+* fresh instance on fire (the args become its `params`).
+*/
+interface SchedulableWorkflowReference {
+  /** The `WORKFLOW_*`/`AGENT_*` binding name (present on a generated ref). */
+  readonly binding?: string;
+  readonly isLunoraWorkflow: true;
+  /** The workflow/agent export/stable name (present on a generated ref). */
+  readonly name?: string;
+}
 interface Scheduler {
   /** Cancel a pending job by id. `cancelled` is `false` when no such job exists. */
   cancel: (id: string) => Promise<{
@@ -693,8 +708,15 @@ interface Scheduler {
   get: (id: string) => Promise<ScheduledJob | null>;
   /** List all pending scheduled jobs. */
   list: () => Promise<ScheduledJob[]>;
-  runAfter: (delayMs: number, functionPath: string, args?: Record<string, unknown>) => Promise<string>;
-  runAt: (timestampMs: number, functionPath: string, args?: Record<string, unknown>) => Promise<string>;
+  /**
+  * Schedule a one-shot run `delayMs` from now. `target` is a function path
+  * (`"ns:fn"`) dispatched as a one-shot, or a generated `workflows.&lt;name>` /
+  * `agents.&lt;name>` reference which starts a fresh durable instance on fire
+  * (the args become its `params`).
+  */
+  runAfter: (delayMs: number, target: SchedulableWorkflowReference | string, args?: Record<string, unknown>) => Promise<string>;
+  /** Like {@link Scheduler.runAfter} but fires at an absolute epoch-ms timestamp. */
+  runAt: (timestampMs: number, target: SchedulableWorkflowReference | string, args?: Record<string, unknown>) => Promise<string>;
 }
 /**
 * A workflow instance's lifecycle status. Clean public mirror of

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/server",
-  "version": "1.0.0-alpha.23",
+  "version": "1.0.0-alpha.24",
   "description": "Server primitives for Lunora: defineSchema, defineTable, query, mutation, and action",
   "keywords": [
     "backend",
@@ -63,7 +63,7 @@
   },
   "dependencies": {
     "@lunora/errors": "1.0.0-alpha.4",
-    "@lunora/scheduler": "1.0.0-alpha.8",
+    "@lunora/scheduler": "1.0.0-alpha.9",
     "@lunora/values": "1.0.0-alpha.7",
     "drizzle-orm": "^0.45.2",
     "hono": "^4.12.28"