openmerit 0.1.4 → 0.1.6-preview.0

package/dist/core/src/index.d.ts

@@ -0,0 +1,101 @@
+import type { AnyIntentResult, AutomationPlan, AutomationSignal, CandidateAssessment, FrontierSnapshot, HarnessCapability, HarnessDescriptor, HarnessDispatchReceipt, HarnessWakeupRequest, TaskProfile, ImprovementCycleState, IntentLifecycleUpdate, IntentKind, OpenMeritIntent, OpenMeritProjectConfig, OpenMeritProjectState, ObservabilityCoverage, JsonValue, SupervisedGraduationPolicy } from "../../protocol/src/index.ts";
+import type { OpenMeritStore } from "./store.ts";
+export { OPENMERIT_DIRECTORY, ProjectStore, type AuditEventExporter, type OpenMeritStore, type ProjectStoreOptions, } from "./store.ts";
+export interface HarnessAdapter {
+    readonly descriptor: HarnessDescriptor;
+    dispatch(intent: OpenMeritIntent): Promise<HarnessDispatchReceipt>;
+    scheduleWakeup?(request: HarnessWakeupRequest): Promise<HarnessDispatchReceipt>;
+}
+export interface IntentFactoryOptions {
+    readonly taskProfileId?: string;
+    readonly authorizationPolicyId?: string;
+    readonly policy?: SupervisedGraduationPolicy;
+    readonly id?: string;
+    readonly requestedAt?: string;
+    readonly evaluationSpend?: number;
+    readonly targetId?: string;
+    readonly additionalConstraints?: Readonly<Record<string, JsonValue>>;
+}
+export declare function createOpenMeritIntent(kind: IntentKind, options?: IntentFactoryOptions): OpenMeritIntent;
+export declare function missingHarnessCapabilities(descriptor: HarnessDescriptor, kind: IntentKind): readonly HarnessCapability[];
+export declare function validateHarnessDescriptor(descriptor: HarnessDescriptor): VerificationResult;
+export declare function dispatchToHarness(adapter: HarnessAdapter, intent: OpenMeritIntent): Promise<HarnessDispatchReceipt>;
+export declare function startedStage(kind: IntentKind): ImprovementCycleState["stage"];
+export declare function completedStage(kind: IntentKind, succeeded: boolean): ImprovementCycleState["stage"];
+export interface VerificationResult {
+    readonly valid: boolean;
+    readonly errors: readonly string[];
+}
+export interface ResultInterpretation extends VerificationResult {
+    readonly nextStage?: ImprovementCycleState["stage"];
+    readonly config?: OpenMeritProjectConfig;
+    readonly cyclePatch?: Partial<ImprovementCycleState>;
+}
+export declare function validateObservabilityCoverage(profile: TaskProfile, coverage: ObservabilityCoverage, requireReady: boolean): readonly string[];
+export declare function interpretIntentResult(intent: OpenMeritIntent, result: AnyIntentResult, cycle: ImprovementCycleState, config: OpenMeritProjectConfig): ResultInterpretation;
+export type OrchestrationDecision = {
+    readonly action: "issue_intent";
+    readonly intentKind: IntentKind;
+    readonly reason: string;
+} | {
+    readonly action: "await_user";
+    readonly reason: string;
+} | {
+    readonly action: "observe";
+    readonly reason: string;
+};
+export declare function nextImprovementAction(state: ImprovementCycleState): OrchestrationDecision;
+export declare function verifyFrontierSnapshot(profile: TaskProfile, assessments: readonly CandidateAssessment[], snapshot: FrontierSnapshot): VerificationResult;
+export interface IssuedIntent {
+    readonly intent: OpenMeritIntent;
+    readonly state: OpenMeritProjectState;
+    readonly receipt: HarnessDispatchReceipt;
+}
+export interface CoordinatorIssueOptions {
+    readonly additionalConstraints?: Readonly<Record<string, JsonValue>>;
+}
+export interface AcceptedIntentResult {
+    readonly intentKind: IntentKind;
+    readonly state: OpenMeritProjectState;
+    readonly interpretation: ResultInterpretation;
+    readonly automation: {
+        readonly plan: AutomationPlan;
+        readonly receipt?: HarnessDispatchReceipt;
+    };
+}
+export interface ObservationResult {
+    readonly state: OpenMeritProjectState;
+    readonly assessmentDue: boolean;
+}
+export interface CatalogChangeResult {
+    readonly state: OpenMeritProjectState;
+    readonly changed: boolean;
+    readonly reassessmentDue: boolean;
+}
+export interface AutomationSignalResult {
+    readonly state: OpenMeritProjectState;
+    readonly duplicate: boolean;
+    readonly decision: OrchestrationDecision;
+}
+export declare function buildAutomationPlan(state: OpenMeritProjectState, descriptor: HarnessDescriptor): AutomationPlan;
+/** Harness-neutral durable coordinator. Adapters transport jobs; this class owns lifecycle state. */
+export declare class OpenMeritCoordinator {
+    private readonly store;
+    private readonly adapter;
+    constructor(store: OpenMeritStore, adapter: HarnessAdapter);
+    issue(kind: IntentKind, options?: CoordinatorIssueOptions): Promise<IssuedIntent>;
+    reconcileAutomation(now?: string): Promise<{
+        readonly plan: AutomationPlan;
+        readonly receipt?: HarnessDispatchReceipt;
+    }>;
+    acceptResult(result: AnyIntentResult): Promise<AcceptedIntentResult>;
+    recordLifecycle(update: IntentLifecycleUpdate): Promise<void>;
+    recordTaskObservation(details?: Readonly<Record<string, JsonValue>>): Promise<ObservationResult>;
+    assessBaseline(now?: string): Promise<{
+        readonly state: OpenMeritProjectState;
+        readonly errors: readonly string[];
+        readonly decision: OrchestrationDecision;
+    }>;
+    recordAutomationSignal(signal: AutomationSignal): Promise<AutomationSignalResult>;
+    recordModelCatalogFingerprint(fingerprint: string): Promise<CatalogChangeResult>;
+}