harnery 0.30.0 → 0.31.0

package/dist/core/governor/state.d.ts

@@ -0,0 +1,116 @@
+import { type WorkRecord } from "../work/read.js";
+import type { WorkflowSpecialistProfile } from "../workflow/types.js";
+import { type CreateGovernorReplanningInput, type GovernorPlanRecord, type GovernorReplanningPolicy } from "./plan-types.js";
+export declare const GOVERNOR_INTENT_SCHEMA_VERSION: 1;
+export interface GovernorLimits {
+    max_cycles: number;
+    max_runtime_ms: number;
+    max_parallel_work: number;
+    max_total_attempts: number;
+    max_agents_per_work: number;
+    agent_concurrency: number;
+}
+export interface GovernorAutomationPolicy {
+    accept_passing_proof: boolean;
+    resume_approved: boolean;
+    retry_blocked: boolean;
+}
+export interface GovernorMission {
+    objective: string;
+    acceptance: string[];
+    max_milestones: number;
+}
+export interface CreateGovernorMissionInput {
+    objective: string;
+    acceptance: readonly string[];
+    maxMilestones?: number;
+}
+export interface GovernorIntent {
+    schema_version: typeof GOVERNOR_INTENT_SCHEMA_VERSION;
+    id: string;
+    title: string;
+    root_work_id: string;
+    specialists: Record<string, WorkflowSpecialistProfile>;
+    limits: GovernorLimits;
+    automation: GovernorAutomationPolicy;
+    mission?: GovernorMission;
+    replanning?: GovernorReplanningPolicy;
+    created_at: string;
+}
+export type GovernorState = "ready" | "running" | "awaiting_attention" | "blocked" | "budget_exhausted" | "succeeded";
+export type GovernorNextAction = "run" | "wait_for_run" | "resolve_approval" | "review" | "retry" | "replan" | "plan_initial" | "plan_milestone" | "review_plan" | "retry_plan" | "none";
+export interface GovernorProjection {
+    id: string;
+    title: string;
+    root_work_id: string;
+    root_materialized: boolean;
+    state: GovernorState;
+    reason: string;
+    next_action: GovernorNextAction;
+    work_ids: string[];
+    ready_work: string[];
+    resumable_work: string[];
+    retryable_work: string[];
+    attention_work: string[];
+    /** Work stopped because a human must rule, with the docket id when the script
+     * named one. Empty in the ordinary case. A reader that wants to tell an
+     * operator what is actually waiting on them should start here. */
+    decision_blocked_work: Array<{
+        work_id: string;
+        decision_id?: string;
+    }>;
+    attempts_used: number;
+    attempts_remaining: number;
+    specialists: string[];
+    plan_generation: number;
+    replans_used: number;
+    replans_remaining: number;
+    milestones_completed: number;
+    milestones_remaining: number;
+    pending_plan_id?: string;
+    attention_plan_id?: string;
+    latest_plan_status?: GovernorPlanRecord["status"];
+    /**
+     * How consumed (charged) replans that did not advance the graph broke down,
+     * present only when at least one replan was spent by a planner run that
+     * produced no proposal. `reviewer_rejection` counts replans where a proposal
+     * was produced and independent review rejected it (review-round exhaustion,
+     * reviewer attention, or review failure); `planner_no_proposal` counts replans
+     * where the planner run produced no reviewable proposal at all. Absent when a
+     * goal has no planner no-proposal history, so goals that only ever reached
+     * review project exactly as before this field existed.
+     */
+    replan_consumption?: {
+        reviewer_rejection: number;
+        planner_no_proposal: number;
+    };
+    governed_work_ids: string[];
+}
+export interface GovernorRecord {
+    intent: GovernorIntent;
+    projection: GovernorProjection;
+    work: WorkRecord[];
+    plans: GovernorPlanRecord[];
+}
+export interface CreateGovernorInput {
+    coordRoot: string;
+    rootWorkId?: string;
+    specialists: Readonly<Record<string, WorkflowSpecialistProfile>>;
+    title?: string;
+    id?: string;
+    limits?: Partial<GovernorLimits>;
+    automation?: Partial<GovernorAutomationPolicy>;
+    mission?: CreateGovernorMissionInput;
+    replanning?: CreateGovernorReplanningInput;
+}
+export declare function createGovernor(input: CreateGovernorInput): GovernorRecord;
+export declare function readGovernor(coordRoot: string, goalId: string): GovernorRecord;
+/** @internal Runner seam; ignores the lease held by this governor process. */
+export declare function readGovernorIgnoringLease(coordRoot: string, goalId: string): GovernorRecord;
+export declare function listGovernors(coordRoot: string): GovernorRecord[];
+export declare function collectGovernorWork(coordRoot: string, rootWorkId: string): WorkRecord[];
+export declare function assertGovernorId(goalId: string): void;
+export declare function newGovernorId(): string;
+/** @internal Runner seam; one exclusive crash-recoverable governor lease. */
+export declare function acquireGovernorLease(coordRoot: string, goalId: string): () => void;
+//# sourceMappingURL=state.d.ts.map

package/dist/core/governor/state.d.ts.map

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