@mono-agent/agent-app 0.19.1 → 0.20.0

package/dist/cron-control-store.d.ts

@@ -0,0 +1,91 @@
+import { type AgentStreamEvent } from "@mono-agent/agent-contracts";
+import type { CronFiringIdentity, CronJobResult, CronRunTrigger } from "@mono-agent/cron-adapter";
+import type { CronOperatorRunDetail, CronOperatorRunPage, CronOperatorRunSummary } from "@mono-agent/operator-adapter";
+export interface CronControlPaths {
+    readonly root: string;
+    readonly marker: string;
+    readonly database: string;
+    readonly lease: string;
+}
+export type CronControlInspection = {
+    readonly status: "absent";
+} | {
+    readonly status: "initializing";
+} | {
+    readonly status: "ready";
+    readonly overrides: ReadonlyMap<string, boolean>;
+} | {
+    readonly status: "degraded";
+    readonly reason: string;
+};
+export type CronControlInitializationCheckpoint = "parent_ready" | "initializing_root_ready" | "initializing_marker_file_ready" | "initializing_marker_ready" | "database_file_ready" | "database_schema_ready" | "lease_file_ready" | "lease_schema_ready" | "permissions_ready" | "ready_marker_ready" | "published";
+export interface OpenCronControlStoreOptions {
+    readonly now?: () => Date;
+    /** Test seam for simulating process death after one durable initialization boundary. */
+    readonly onInitializationCheckpoint?: (checkpoint: CronControlInitializationCheckpoint) => void | Promise<void>;
+}
+export declare class CronControlStoreError extends Error {
+    readonly kind: "corrupt" | "insecure" | "lease_conflict" | "idempotency_conflict" | "replay_expired";
+    constructor(kind: CronControlStoreError["kind"], message: string, options?: ErrorOptions);
+}
+export interface CronControlStore {
+    readonly paths: CronControlPaths;
+    overrides(): ReadonlyMap<string, boolean>;
+    syncConfiguredJobs(jobIds: readonly string[]): void;
+    knownJobIds(): readonly string[];
+    allocateFiring(input: {
+        readonly jobId: string;
+        readonly scheduledAt: string;
+        readonly observedAt: string;
+        readonly trigger: CronRunTrigger;
+    }): CronFiringIdentity;
+    replayRunNowAction(input: {
+        readonly jobId: string;
+        readonly idempotencyKey: string;
+        readonly requestHash: string;
+    }): CronOperatorRunSummary | undefined;
+    runNowAction(input: {
+        readonly jobId: string;
+        readonly idempotencyKey: string;
+        readonly requestHash: string;
+        readonly observedAt: string;
+    }): {
+        readonly firing: CronFiringIdentity;
+        readonly run?: CronOperatorRunSummary;
+        readonly replayed: boolean;
+    };
+    replayEnabledAction(input: {
+        readonly jobId: string;
+        readonly idempotencyKey: string;
+        readonly requestHash: string;
+    }): boolean | undefined;
+    setEnabledAction(input: {
+        readonly jobId: string;
+        readonly enabled: boolean;
+        readonly idempotencyKey: string;
+        readonly requestHash: string;
+    }): {
+        readonly enabled: boolean;
+        readonly replayed: boolean;
+    };
+    markStarted(firing: CronFiringIdentity, startedAt: string): void;
+    appendEvent(firing: CronFiringIdentity, event: AgentStreamEvent): void;
+    recordResult(result: CronJobResult): void;
+    getRun(runId: string): CronOperatorRunDetail | undefined;
+    getRunSummary(runId: string): CronOperatorRunSummary | undefined;
+    lastRun(jobId: string): CronOperatorRunSummary | undefined;
+    runs(jobId: string, limit: number, before?: string): CronOperatorRunPage;
+    audit(input: {
+        readonly action: string;
+        readonly jobId?: string;
+        readonly outcome: string;
+        readonly idempotencyKey?: string;
+        readonly detail?: Readonly<Record<string, unknown>>;
+    }): void;
+    close(): Promise<void>;
+}
+export declare function resolveCronControlPaths(cwd: string): CronControlPaths;
+export declare function inspectCronControlStore(cwd: string): Promise<CronControlInspection>;
+export declare function openCronControlStore(cwd: string, options?: OpenCronControlStoreOptions): Promise<CronControlStore>;
+export declare function cronActionRequestHash(value: unknown): string;
+//# sourceMappingURL=cron-control-store.d.ts.map

package/dist/cron-control-store.d.ts.map

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