@zhin.js/agent 1.1.13 → 1.1.14

package/lib/workroom/workroom-scheduler.d.ts

@@ -0,0 +1,135 @@
+import type { WorkroomEvent } from './kernel-contracts.js';
+export type WorkroomSponsorLane = 'urgent' | 'high' | 'normal' | 'low';
+export type WorkroomTaskPreemptibility = 'checkpointable' | 'atomic';
+export interface WorkroomSchedulerPolicySnapshotInput {
+    readonly policyRef: string;
+    readonly revision: number;
+    readonly pinnedAtSequence: number;
+    readonly capacity: number;
+    readonly agingStepMs: number;
+    readonly starvationBoundMs: Readonly<Record<WorkroomSponsorLane, number>>;
+    readonly preemptionDeadlineMs: number;
+}
+export interface WorkroomSchedulerPolicySnapshot extends WorkroomSchedulerPolicySnapshotInput {
+    readonly version: 1;
+    readonly comparatorVersion: 1;
+    readonly digest: string;
+}
+export interface WorkroomDispatchTaskDecision {
+    readonly version: 1;
+    readonly type: 'dispatch_task';
+    readonly decisionId: string;
+    readonly digest: string;
+    readonly projectId: string;
+    readonly runId: string;
+    readonly expectedSequence: number;
+    readonly taskKey: string;
+    readonly taskRevision: number;
+    readonly role: string;
+    readonly sponsorLane: WorkroomSponsorLane;
+    readonly reason: 'scheduler_order' | 'starvation_bound' | 'preemption_reservation';
+    readonly policy: Readonly<{
+        ref: string;
+        revision: number;
+        digest: string;
+    }>;
+}
+export interface WorkroomPreemptionPrepareDecision {
+    readonly version: 1;
+    readonly type: 'prepare_preemption';
+    readonly decisionId: string;
+    readonly digest: string;
+    readonly projectId: string;
+    readonly runId: string;
+    readonly expectedSequence: number;
+    readonly victimTaskKey: string;
+    readonly victimTaskRevision: number;
+    readonly reservedTaskKey: string;
+    readonly reservedTaskRevision: number;
+    readonly assignmentId: string;
+    readonly assignmentAttempt: number;
+    readonly assignmentFence: number;
+    readonly assignmentEnvelopeDigest: string;
+    readonly owner: string;
+    readonly requestedAt: number;
+    readonly deadline: number;
+    readonly takeoverFence: number;
+    readonly reason: 'higher_priority' | 'starvation_bound';
+    readonly allowedSuccessors: readonly ['replan', 'cancel_run'];
+    readonly policy: Readonly<{
+        ref: string;
+        revision: number;
+        digest: string;
+    }>;
+}
+export type WorkroomScheduleDecision = WorkroomDispatchTaskDecision | WorkroomPreemptionPrepareDecision;
+export declare function parseWorkroomDispatchTaskDecision(value: unknown): WorkroomDispatchTaskDecision;
+export declare function parseWorkroomPreemptionPrepareDecision(value: unknown): WorkroomPreemptionPrepareDecision;
+export interface WorkroomPriorityChangeProposalInput {
+    readonly projectId: string;
+    readonly runId: string;
+    readonly taskKey: string;
+    readonly taskRevision: number;
+    readonly expectedSequence: number;
+    readonly currentLane: WorkroomSponsorLane;
+    readonly requestedLane: WorkroomSponsorLane;
+    readonly localRank: number;
+    readonly principalId: string;
+    readonly authority: 'sponsor' | 'orchestrator';
+    readonly authorityRef: string;
+    readonly deadline: number;
+}
+export interface WorkroomPriorityChangeProposal extends WorkroomPriorityChangeProposalInput {
+    readonly version: 1;
+    readonly type: 'priority_change';
+    readonly owner: string;
+    readonly allowedSuccessors: readonly ['restore', 'rebase', 'cancel_run'];
+    readonly proposalId: string;
+    readonly digest: string;
+}
+export interface WorkroomScheduledTaskSnapshot {
+    readonly taskRevision: number;
+    readonly sponsorLane: WorkroomSponsorLane;
+    readonly localRank: number;
+}
+/** Content-free Kernel facts required to project one Portfolio Capacity Request. */
+export interface WorkroomScheduledTaskCapacitySnapshot {
+    readonly taskKey: string;
+    readonly taskRevision: number;
+    readonly role: string;
+    readonly preemptibility: WorkroomTaskPreemptibility;
+    readonly status: ScheduledTaskProjection['status'];
+}
+interface ScheduledTaskProjection {
+    readonly key: string;
+    readonly revision: number;
+    readonly role: string;
+    readonly sponsorLane: WorkroomSponsorLane;
+    readonly localRank: number;
+    readonly deadline?: number;
+    readonly enqueuedAt: number;
+    readonly enqueueSequence: number;
+    readonly dependsOn: readonly string[];
+    readonly preemptibility: WorkroomTaskPreemptibility;
+    readonly status: 'ready' | 'blocked' | 'executing' | 'awaiting_acceptance' | 'accepted' | 'failed' | 'cancelled';
+    readonly blockers: ReadonlyMap<string, Readonly<{
+        owner: string;
+        deadline: number;
+        allowedSuccessors: readonly string[];
+    }>>;
+}
+export declare function createWorkroomSchedulerPolicySnapshot(input: WorkroomSchedulerPolicySnapshotInput): WorkroomSchedulerPolicySnapshot;
+export declare function assertWorkroomSchedulerPolicySnapshot(value: WorkroomSchedulerPolicySnapshot, pinnedAtSequence?: number): void;
+/** Pure `Journal facts + pinned policy -> one typed decision` boundary. */
+export declare function decideWorkroomSchedule(events: readonly WorkroomEvent[]): WorkroomScheduleDecision | null;
+/**
+ * Creates a typed proposal only. The Sponsor/Orchestrator principal and
+ * authorityRef must be injected by a trusted role-scoped command port before
+ * a Kernel CAS adapter may persist it.
+ */
+export declare function proposeWorkroomPriorityChange(input: WorkroomPriorityChangeProposalInput): WorkroomPriorityChangeProposal;
+export declare function parseWorkroomPriorityChangeProposal(value: unknown): WorkroomPriorityChangeProposal;
+export declare function getWorkroomScheduledTaskSnapshot(events: readonly WorkroomEvent[], taskKey: string): WorkroomScheduledTaskSnapshot;
+export declare function getWorkroomScheduledTaskCapacitySnapshot(events: readonly WorkroomEvent[], taskKey: string): WorkroomScheduledTaskCapacitySnapshot;
+export {};
+//# sourceMappingURL=workroom-scheduler.d.ts.map

package/lib/workroom/workroom-scheduler.d.ts.map

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