@graphrefly/ts 0.0.1 → 0.0.2

package/dist/orchestration/work-queue.d.ts

@@ -1,16 +1,127 @@
 import { DataIssue } from '../data/index.js';
-import { d as Graph } from '../graph-D-1-SQeC.js';
-import { N as Node } from '../types-BsJvElYZ.js';
-import { ProcessEffectRequest } from './index.js';
-import { WorkQueueRecord, WorkQueueCommand } from '../work-queue/index.js';
+import { d as Graph } from '../graph-ho5sotHP.js';
+import { N as Node } from '../types-C9NOgNJw.js';
+import { c as ProcessEffectRequest } from '../process-types-C9uMYz3i.js';
+import { W as WorkQueueCommand, j as WorkQueueDerivedState, a as WorkQueueRecord } from '../types-BRNKoFHj.js';
+import { S as SourceRef, a as AgentRuntimeAuditRecord } from '../agent-runtime-types-core-hU299uIC.js';
+import { S as ScheduledReadinessRequested, a as ScheduledReadinessReady, b as ScheduledReadinessOverdue } from '../scheduled-readiness-5rwQlyjV.js';
 import '../core/index.js';
 import '../messages-CAzUPPJM.js';
 import '../codec-BB7p8fJc.js';
-import '../describe-BpyJuWkw.js';
-import '../resilience-Dig3Q7n0.js';
-import '../agent-runtime-BesGDZcB.js';
-import '../work-item-runtime-C3M79vE9.js';
-import '../messaging/index.js';
+import '../describe-B_A5fbXH.js';
+import '../types-CTsQ8Ww4.js';
+
+type WorkQueueScheduledReadinessScheduleKind = "work-admitted" | "work-scheduled" | "retry-scheduled" | "lease-expiration";
+type WorkQueueScheduledReadinessStatusState = "translated" | "issue";
+interface WorkQueueScheduledReadinessStatus {
+    readonly kind: "work-queue-scheduled-readiness-status";
+    readonly statusId: string;
+    readonly queueId?: string;
+    readonly workId?: string;
+    readonly recordSeq?: number;
+    readonly state: WorkQueueScheduledReadinessStatusState;
+    readonly scheduleKind?: WorkQueueScheduledReadinessScheduleKind;
+    readonly scheduleId?: string;
+    readonly readyAtMs?: number;
+    readonly deadlineMs?: number;
+    readonly sourceRefs?: readonly SourceRef[];
+    readonly issueCodes?: readonly string[];
+    readonly metadata?: Record<string, unknown>;
+}
+interface WorkQueueScheduledReadinessViews {
+    readonly schedulesById: ReadonlyMap<string, ScheduledReadinessRequested>;
+    readonly statusById: ReadonlyMap<string, WorkQueueScheduledReadinessStatus>;
+}
+interface WorkQueueScheduledReadinessBundle {
+    readonly readinessSchedules: Node<ScheduledReadinessRequested>;
+    readonly status: Node<WorkQueueScheduledReadinessStatus>;
+    readonly issues: Node<DataIssue>;
+    readonly audit: Node<AgentRuntimeAuditRecord>;
+    readonly views: Node<WorkQueueScheduledReadinessViews>;
+}
+type WorkQueueReadinessCandidateKind = "claim-eligible" | "lease-expiration-eligible";
+interface WorkQueueReadinessCandidate {
+    readonly kind: "work-queue-readiness-candidate";
+    readonly candidateId: string;
+    readonly candidateKind: WorkQueueReadinessCandidateKind;
+    readonly queueId: string;
+    readonly workId: string;
+    readonly scheduleId: string;
+    readonly readyAtMs: number;
+    readonly nowMs: number;
+    readonly originRecordSeq?: number;
+    readonly originRecordKind?: string;
+    readonly leaseId?: string;
+    readonly attempt?: number;
+    readonly workerId?: string;
+    readonly leaseExpiresAtMs?: number;
+    readonly sourceRefs?: readonly SourceRef[];
+    readonly metadata?: Record<string, unknown>;
+}
+type WorkQueueReadinessHandoffStatusState = "candidate" | "ignored-stale" | "ignored-superseded" | "ignored-terminal" | "overdue" | "pending-origin" | "issue";
+interface WorkQueueReadinessHandoffStatus {
+    readonly kind: "work-queue-readiness-handoff-status";
+    readonly statusId: string;
+    readonly state: WorkQueueReadinessHandoffStatusState;
+    readonly queueId?: string;
+    readonly workId?: string;
+    readonly scheduleId?: string;
+    readonly candidateId?: string;
+    readonly candidateKind?: WorkQueueReadinessCandidateKind;
+    readonly readyAtMs?: number;
+    readonly nowMs?: number;
+    readonly currentState?: WorkQueueDerivedState;
+    readonly sourceRefs?: readonly SourceRef[];
+    readonly issueCodes?: readonly string[];
+    readonly metadata?: Record<string, unknown>;
+}
+interface WorkQueueReadinessHandoffViews {
+    readonly candidatesById: ReadonlyMap<string, WorkQueueReadinessCandidate>;
+    readonly statusById: ReadonlyMap<string, WorkQueueReadinessHandoffStatus>;
+}
+interface WorkQueueReadinessHandoffBundle {
+    readonly candidates: Node<WorkQueueReadinessCandidate>;
+    readonly status: Node<WorkQueueReadinessHandoffStatus>;
+    readonly issues: Node<DataIssue>;
+    readonly audit: Node<AgentRuntimeAuditRecord>;
+    readonly views: Node<WorkQueueReadinessHandoffViews>;
+}
+interface WorkQueueLeaseExpirationCommandBundle<T = unknown> {
+    readonly commands: Node<WorkQueueCommand<T>>;
+    readonly status: Node<WorkQueueReadinessHandoffStatus>;
+    readonly views: Node<WorkQueueReadinessHandoffViews>;
+}
+/**
+ * Translate workQueue-local delayed eligibility records into D432 shared readiness schedules.
+ *
+ * The projector is intentionally visibility-only: it never claims work, expires leases, cancels,
+ * completes, fails, mutates queue records, or starts timers. D433 consumption/materialization stays
+ * owned by later workQueue domain projectors.
+ */
+declare function workQueueScheduledReadinessProjector<T = unknown>(graph: Graph, opts: {
+    readonly name?: string;
+    readonly records: Node<WorkQueueRecord<T>>;
+}): WorkQueueScheduledReadinessBundle;
+/**
+ * Consume D433 shared readiness through workQueue-owned handoff material.
+ *
+ * Ready facts only produce queue-domain candidates/status. They do not claim work, expire leases,
+ * cancel, complete, fail, or append workQueue records. Lease expiration candidates can be lowered
+ * separately into the existing mutation-bearing expire-leases command path.
+ */
+declare function workQueueReadinessHandoffProjector<T = unknown>(graph: Graph, opts: {
+    readonly name?: string;
+    readonly records: Node<WorkQueueRecord<T>>;
+    readonly ready: Node<ScheduledReadinessReady>;
+    readonly overdue?: Node<ScheduledReadinessOverdue>;
+}): WorkQueueReadinessHandoffBundle;
+/**
+ * Lower only lease-expiration readiness candidates into existing workQueue expire-leases commands.
+ */
+declare function workQueueLeaseExpirationCommandProjector<T = unknown>(graph: Graph, opts: {
+    readonly name?: string;
+    readonly candidates: Node<WorkQueueReadinessCandidate>;
+}): WorkQueueLeaseExpirationCommandBundle<T>;
 
 /**
  * Optional orchestration-over-workQueue recipe (D349/D353).
@@ -82,4 +193,4 @@ declare function processEffectSubmitCommand<TEffect>(effect: ProcessEffectReques
     readonly metadata?: Record<string, unknown>;
 }): WorkQueueCommand<OrchestrationQueuedEffectPayload<TEffect>>;
 
-export { type OrchestrationQueueAuditRecord, type OrchestrationQueueEvidence, type OrchestrationQueueStatus, type OrchestrationQueuedEffectPayload, type OrchestrationWorkQueueRecipeBundle, type OrchestrationWorkQueueRecipeOptions, orchestrationWorkQueueRecipe, processEffectSubmitCommand };
+export { type OrchestrationQueueAuditRecord, type OrchestrationQueueEvidence, type OrchestrationQueueStatus, type OrchestrationQueuedEffectPayload, type OrchestrationWorkQueueRecipeBundle, type OrchestrationWorkQueueRecipeOptions, type WorkQueueLeaseExpirationCommandBundle, type WorkQueueReadinessCandidate, type WorkQueueReadinessCandidateKind, type WorkQueueReadinessHandoffBundle, type WorkQueueReadinessHandoffStatus, type WorkQueueReadinessHandoffStatusState, type WorkQueueReadinessHandoffViews, type WorkQueueScheduledReadinessBundle, type WorkQueueScheduledReadinessScheduleKind, type WorkQueueScheduledReadinessStatus, type WorkQueueScheduledReadinessStatusState, type WorkQueueScheduledReadinessViews, orchestrationWorkQueueRecipe, processEffectSubmitCommand, workQueueLeaseExpirationCommandProjector, workQueueReadinessHandoffProjector, workQueueScheduledReadinessProjector };