@aigne/afs-scheduler 1.12.0-beta.5

package/dist/scheduler-provider.d.cts

@@ -0,0 +1,95 @@
+import { SchedulerProviderOptions, TickResult } from "./types.cjs";
+import { TaskStore } from "./task-store.cjs";
+import { AFSAccessMode, AFSEntry, AFSExecResult, AFSExplainResult, AFSListOptions, AFSListResult, AFSReadOptions, AFSReadResult, AFSRoot, ProviderManifest } from "@aigne/afs";
+import { AFSBaseProvider, RouteContext } from "@aigne/afs/provider";
+
+//#region src/scheduler-provider.d.ts
+declare class AFSScheduler extends AFSBaseProvider {
+  static manifest(): ProviderManifest;
+  readonly name: string;
+  readonly description?: string;
+  readonly accessMode: AFSAccessMode;
+  /** @internal — exposed for conformance test pre-population */
+  readonly store: TaskStore;
+  private executor;
+  private jobExecutor?;
+  private root;
+  private readonly options;
+  private readonly persistence;
+  constructor(options?: SchedulerProviderOptions);
+  onMount(root: AFSRoot, _mountPath?: string): void;
+  /** Await all pending snapshot writes. Use before reading persisted state. */
+  flush(): Promise<void>;
+  read(path: string, options?: AFSReadOptions): Promise<AFSReadResult>;
+  list(path: string, options?: AFSListOptions): Promise<AFSListResult>;
+  readRoot(ctx: RouteContext): AFSEntry | undefined;
+  readTasks(ctx: RouteContext): AFSEntry | undefined;
+  readTask(ctx: RouteContext<{
+    id: string;
+  }>): AFSEntry | undefined;
+  readTaskField(ctx: RouteContext<{
+    id: string;
+    field: string;
+  }>): AFSEntry | undefined;
+  readHistory(ctx: RouteContext): AFSEntry | undefined;
+  readHistoryTask(ctx: RouteContext<{
+    id: string;
+  }>): AFSEntry | undefined;
+  readHistoryTaskField(ctx: RouteContext<{
+    id: string;
+    field: string;
+  }>): AFSEntry | undefined;
+  readSchedules(ctx: RouteContext): AFSEntry | undefined;
+  readSchedule(ctx: RouteContext<{
+    id: string;
+  }>): AFSEntry | undefined;
+  readJobs(ctx: RouteContext): AFSEntry | undefined;
+  readJob(ctx: RouteContext<{
+    id: string;
+  }>): Promise<AFSEntry | undefined>;
+  readCapabilities(ctx: RouteContext): AFSEntry | undefined;
+  listRoot(ctx: RouteContext): AFSListResult;
+  listTasks(ctx: RouteContext): AFSListResult;
+  listHistory(ctx: RouteContext): AFSListResult;
+  listSchedules(ctx: RouteContext): AFSListResult;
+  listJobsHandler(ctx: RouteContext): AFSListResult;
+  readRootMeta(ctx: RouteContext): AFSEntry | undefined;
+  readTasksMeta(ctx: RouteContext): AFSEntry | undefined;
+  readHistoryMeta(ctx: RouteContext): AFSEntry | undefined;
+  readSchedulesMeta(ctx: RouteContext): AFSEntry | undefined;
+  readJobsMeta(ctx: RouteContext): AFSEntry | undefined;
+  explainRoot(): AFSExplainResult;
+  explainPath(ctx: RouteContext<{
+    path: string;
+  }>): AFSExplainResult;
+  listActions(ctx: RouteContext): AFSListResult;
+  execDispatch(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execCancel(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execRetry(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSchedule(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execUnschedule(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execHeartbeat(_ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execClaim(_ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSubmit(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSubmitJob(_ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execCancelJob(_ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  /**
+   * Evaluate cron schedules and scan for expired deadlines.
+   * Call from Worker `scheduled()` handler or `setInterval` in non-Worker environments.
+   */
+  tick(): Promise<TickResult>;
+  private getScheduledTaskTimeoutMs;
+  private getEffectiveDeadline;
+  private getCallerKey;
+  private checkTaskOwner;
+  private checkScheduleOwner;
+  private executeTask;
+  private checkTaskBudget;
+  private completeProc;
+  private dispatchMapTask;
+  private onJobTaskComplete;
+  private readEntryField;
+}
+//#endregion
+export { AFSScheduler };
+//# sourceMappingURL=scheduler-provider.d.cts.map

package/dist/scheduler-provider.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler-provider.d.cts","names":[],"sources":["../src/scheduler-provider.ts"],"mappings":"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"}

package/dist/scheduler-provider.d.mts

@@ -0,0 +1,95 @@
+import { SchedulerProviderOptions, TickResult } from "./types.mjs";
+import { TaskStore } from "./task-store.mjs";
+import { AFSAccessMode, AFSEntry, AFSExecResult, AFSExplainResult, AFSListOptions, AFSListResult, AFSReadOptions, AFSReadResult, AFSRoot, ProviderManifest } from "@aigne/afs";
+import { AFSBaseProvider, RouteContext } from "@aigne/afs/provider";
+
+//#region src/scheduler-provider.d.ts
+declare class AFSScheduler extends AFSBaseProvider {
+  static manifest(): ProviderManifest;
+  readonly name: string;
+  readonly description?: string;
+  readonly accessMode: AFSAccessMode;
+  /** @internal — exposed for conformance test pre-population */
+  readonly store: TaskStore;
+  private executor;
+  private jobExecutor?;
+  private root;
+  private readonly options;
+  private readonly persistence;
+  constructor(options?: SchedulerProviderOptions);
+  onMount(root: AFSRoot, _mountPath?: string): void;
+  /** Await all pending snapshot writes. Use before reading persisted state. */
+  flush(): Promise<void>;
+  read(path: string, options?: AFSReadOptions): Promise<AFSReadResult>;
+  list(path: string, options?: AFSListOptions): Promise<AFSListResult>;
+  readRoot(ctx: RouteContext): AFSEntry | undefined;
+  readTasks(ctx: RouteContext): AFSEntry | undefined;
+  readTask(ctx: RouteContext<{
+    id: string;
+  }>): AFSEntry | undefined;
+  readTaskField(ctx: RouteContext<{
+    id: string;
+    field: string;
+  }>): AFSEntry | undefined;
+  readHistory(ctx: RouteContext): AFSEntry | undefined;
+  readHistoryTask(ctx: RouteContext<{
+    id: string;
+  }>): AFSEntry | undefined;
+  readHistoryTaskField(ctx: RouteContext<{
+    id: string;
+    field: string;
+  }>): AFSEntry | undefined;
+  readSchedules(ctx: RouteContext): AFSEntry | undefined;
+  readSchedule(ctx: RouteContext<{
+    id: string;
+  }>): AFSEntry | undefined;
+  readJobs(ctx: RouteContext): AFSEntry | undefined;
+  readJob(ctx: RouteContext<{
+    id: string;
+  }>): Promise<AFSEntry | undefined>;
+  readCapabilities(ctx: RouteContext): AFSEntry | undefined;
+  listRoot(ctx: RouteContext): AFSListResult;
+  listTasks(ctx: RouteContext): AFSListResult;
+  listHistory(ctx: RouteContext): AFSListResult;
+  listSchedules(ctx: RouteContext): AFSListResult;
+  listJobsHandler(ctx: RouteContext): AFSListResult;
+  readRootMeta(ctx: RouteContext): AFSEntry | undefined;
+  readTasksMeta(ctx: RouteContext): AFSEntry | undefined;
+  readHistoryMeta(ctx: RouteContext): AFSEntry | undefined;
+  readSchedulesMeta(ctx: RouteContext): AFSEntry | undefined;
+  readJobsMeta(ctx: RouteContext): AFSEntry | undefined;
+  explainRoot(): AFSExplainResult;
+  explainPath(ctx: RouteContext<{
+    path: string;
+  }>): AFSExplainResult;
+  listActions(ctx: RouteContext): AFSListResult;
+  execDispatch(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execCancel(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execRetry(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSchedule(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execUnschedule(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execHeartbeat(_ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execClaim(_ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSubmit(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSubmitJob(_ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execCancelJob(_ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  /**
+   * Evaluate cron schedules and scan for expired deadlines.
+   * Call from Worker `scheduled()` handler or `setInterval` in non-Worker environments.
+   */
+  tick(): Promise<TickResult>;
+  private getScheduledTaskTimeoutMs;
+  private getEffectiveDeadline;
+  private getCallerKey;
+  private checkTaskOwner;
+  private checkScheduleOwner;
+  private executeTask;
+  private checkTaskBudget;
+  private completeProc;
+  private dispatchMapTask;
+  private onJobTaskComplete;
+  private readEntryField;
+}
+//#endregion
+export { AFSScheduler };
+//# sourceMappingURL=scheduler-provider.d.mts.map

package/dist/scheduler-provider.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler-provider.d.mts","names":[],"sources":["../src/scheduler-provider.ts"],"mappings":"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"}