@graphrefly/ts 0.0.0 → 0.0.2

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

@@ -0,0 +1,196 @@
+import { DataIssue } from '../data/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-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).
+ *
+ * Queue lifecycle remains disposition evidence. This module maps visible
+ * ProcessEffectRequest facts to queue commands and maps terminal queue records
+ * back to graph-visible orchestration evidence/status/issue facts.
+ */
+
+interface OrchestrationQueuedEffectPayload<TEffect = unknown> {
+    readonly kind: "orchestration-queued-effect";
+    readonly effect: ProcessEffectRequest<TEffect>;
+    readonly idempotencyKey?: string;
+    readonly sourceRefs?: readonly string[];
+    readonly policyRefs?: readonly string[];
+    readonly metadata?: Record<string, unknown>;
+}
+interface OrchestrationQueueEvidence {
+    readonly kind: "orchestration-queue-evidence";
+    readonly evidenceId: string;
+    readonly effectId: string;
+    readonly effectType: string;
+    readonly workId: string;
+    readonly queueRecordKind: WorkQueueRecord["kind"];
+    readonly result?: unknown;
+    readonly error?: unknown;
+    readonly recordedAtMs: number;
+}
+interface OrchestrationQueueStatus {
+    readonly kind: "orchestration-queue-status";
+    readonly state: "evidence-recorded" | "mapping-issue";
+    readonly effectId?: string;
+    readonly effectType?: string;
+    readonly workId?: string;
+    readonly queueRecordKind?: WorkQueueRecord["kind"];
+    readonly evidenceId?: string;
+    readonly issues?: readonly DataIssue[];
+}
+interface OrchestrationQueueAuditRecord {
+    readonly kind: "orchestration-queue-audit";
+    readonly seq: number;
+    readonly outcome: "mapped" | "issue";
+    readonly effectId?: string;
+    readonly effectType?: string;
+    readonly workId?: string;
+    readonly queueRecordKind?: WorkQueueRecord["kind"];
+    readonly evidenceId?: string;
+}
+interface OrchestrationWorkQueueRecipeOptions<TEffect = unknown> {
+    readonly name?: string;
+    readonly effectRequests?: Node<ProcessEffectRequest<TEffect>>;
+    readonly records: Node<WorkQueueRecord<OrchestrationQueuedEffectPayload<TEffect>>>;
+}
+interface OrchestrationWorkQueueRecipeBundle<TEffect = unknown> {
+    readonly submitCommands?: Node<WorkQueueCommand<OrchestrationQueuedEffectPayload<TEffect>>>;
+    readonly evidence: Node<OrchestrationQueueEvidence>;
+    readonly status: Node<OrchestrationQueueStatus>;
+    readonly issues: Node<DataIssue>;
+    readonly audit: Node<OrchestrationQueueAuditRecord>;
+}
+/** Build the optional D349 orchestration workQueue recipe. */
+declare function orchestrationWorkQueueRecipe<TEffect = unknown>(graph: Graph, opts: OrchestrationWorkQueueRecipeOptions<TEffect>): OrchestrationWorkQueueRecipeBundle<TEffect>;
+declare function processEffectSubmitCommand<TEffect>(effect: ProcessEffectRequest<TEffect>, opts?: {
+    readonly workId?: string;
+    readonly commandId?: string;
+    readonly idempotencyKey?: string;
+    readonly sourceRefs?: readonly string[];
+    readonly policyRefs?: readonly string[];
+    readonly metadata?: Record<string, unknown>;
+}): WorkQueueCommand<OrchestrationQueuedEffectPayload<TEffect>>;
+
+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 };