@interf/compiler 0.7.3 → 0.9.3

package/dist/packages/local-service/runtime.d.ts

@@ -0,0 +1,130 @@
+import { type ArtifactRef, type CompileRun, type InterfRunEvent, type ProofRecord } from "../execution/lib/schema.js";
+import { type RunEventSink } from "../execution/events.js";
+import { type ReadinessState } from "../contracts/lib/schema.js";
+import type { SourcePreparationConfig } from "../project-model/lib/schema.js";
+import { type ActionProposalCreateRequest, type ActionProposalPlan, type ActionProposalResource, type CompileRunCreateRequest, type CompileRunResource, type MethodResource, type LocalServiceHealth, type LocalJobEvent, type LocalJobEventAppendRequest, type LocalExecutorStatus, type LocalJobRunResource, type LocalRunHandlerResult, type PortableContextResource, type PreparationReadinessState, type PreparationResource, type ReadinessCheckDraftCreateRequest, type ReadinessCheckDraftResult, type RunObservabilityResource, type SourceFileResource, type WorkspaceFileResource, type TestRunCreateRequest, type TestRunResource, type MethodAuthoringCreateRequest, type MethodAuthoringResult } from "./lib/schema.js";
+export interface LocalServiceCompileRunContext {
+    runId: string;
+    sourcePath: string;
+    compiledPath: string;
+    preparationConfig: SourcePreparationConfig;
+    events: RunEventSink;
+}
+export interface LocalServiceTestRunContext {
+    runId: string;
+    sourcePath: string;
+    compiledPath: string;
+    preparationConfig: SourcePreparationConfig;
+}
+export interface LocalServiceJobRunContext {
+    runId: string;
+    sourcePath: string;
+    emit(event: LocalJobEventAppendRequest): void;
+}
+export interface LocalServiceActionPlanningContext {
+    sourcePath: string;
+    preparations: SourcePreparationConfig[];
+    preparationHealth: Array<{
+        name: string;
+        readiness_checks: number;
+        portable_context_ready: boolean;
+        can_check_readiness: boolean;
+        recommended_next_actions: string[];
+    }>;
+    sourceFolders: Array<{
+        value: string;
+        label: string;
+        hint: string;
+    }>;
+    recentProposals: ActionProposalResource[];
+}
+export interface LocalServiceRunHandlers {
+    planActionProposal(request: ActionProposalCreateRequest, context: LocalServiceActionPlanningContext): Promise<ActionProposalPlan>;
+    createCompileRun(request: CompileRunCreateRequest, context: LocalServiceCompileRunContext): Promise<LocalRunHandlerResult>;
+    createTestRun(request: TestRunCreateRequest, context: LocalServiceTestRunContext): Promise<LocalRunHandlerResult>;
+    createReadinessCheckDraft(request: ReadinessCheckDraftCreateRequest, context: LocalServiceJobRunContext): Promise<ReadinessCheckDraftResult>;
+    createMethodAuthoringRun(request: MethodAuthoringCreateRequest, context: LocalServiceJobRunContext): Promise<MethodAuthoringResult>;
+}
+export interface LocalServiceRuntimeOptions {
+    rootPath: string;
+    host: string;
+    port: number;
+    packageVersion?: string;
+    startedAt?: string;
+    handlers?: Partial<LocalServiceRunHandlers>;
+}
+export declare class LocalServiceRuntime {
+    readonly rootPath: string;
+    readonly host: string;
+    readonly port: number;
+    readonly startedAt: string;
+    readonly packageVersion?: string;
+    readonly handlers: Partial<LocalServiceRunHandlers>;
+    constructor(options: LocalServiceRuntimeOptions);
+    health(): LocalServiceHealth;
+    listPreparations(): PreparationResource[];
+    getPreparation(preparationName: string): PreparationResource | null;
+    listPreparationReadiness(): PreparationReadinessState[];
+    getPreparationReadiness(preparationName: string): PreparationReadinessState | null;
+    listReadiness(): ReadinessState[];
+    getReadiness(preparationName: string): ReadinessState | null;
+    computePreparationReadiness(preparation: SourcePreparationConfig): ReadinessState;
+    listSourceFiles(preparationName?: string | null): SourceFileResource[];
+    listWorkspaceFiles(): WorkspaceFileResource[];
+    listMethods(): MethodResource[];
+    getMethod(methodId: string): MethodResource | null;
+    listJobs(): LocalJobRunResource[];
+    getJob(runId: string): LocalJobRunResource | null;
+    getJobEvents(runId: string): LocalJobEvent[] | null;
+    getExecutorStatus(): LocalExecutorStatus;
+    selectExecutor(requestValue: unknown): LocalExecutorStatus;
+    listActionProposals(): ActionProposalResource[];
+    getActionProposal(proposalId: string): ActionProposalResource | null;
+    createActionProposal(requestValue: unknown): Promise<ActionProposalResource>;
+    decideActionProposal(proposalId: string, requestValue: unknown): Promise<ActionProposalResource | null>;
+    listRunObservability(): RunObservabilityResource[];
+    getRunObservability(runId: string): RunObservabilityResource | null;
+    createJobRun(requestValue: unknown): LocalJobRunResource;
+    appendJobRunEvent(runId: string, requestValue: unknown): LocalJobRunResource | null;
+    createReadinessCheckDraftRun(requestValue: unknown): Promise<LocalJobRunResource>;
+    createPreparationSetupRun(requestValue: unknown): Promise<LocalJobRunResource>;
+    createMethodAuthoringRun(requestValue: unknown): Promise<LocalJobRunResource>;
+    listPortableContexts(): PortableContextResource[];
+    getPortableContext(preparationName: string): PortableContextResource | null;
+    listCompileRuns(): CompileRunResource[];
+    listCompileRunsForPreparation(preparationName: string): CompileRun[];
+    getCompileRun(runId: string): CompileRunResource | null;
+    getCompileRunEvents(runId: string): InterfRunEvent[] | null;
+    getCompileRunProof(runId: string): ProofRecord[] | null;
+    getCompileRunArtifacts(runId: string): ArtifactRef[] | null;
+    createCompileRun(requestValue: unknown): Promise<CompileRunResource>;
+    listTestRuns(): TestRunResource[];
+    listTestRunsForPreparation(preparationName: string): TestRunResource[];
+    getTestRun(runId: string): TestRunResource | null;
+    createTestRun(requestValue: unknown): Promise<TestRunResource>;
+    private runCompileInBackground;
+    private runTestInBackground;
+    private runReadinessCheckDraftInBackground;
+    private runMethodAuthoringInBackground;
+    private jobRunContext;
+    private defaultPreparationName;
+    private planActionProposal;
+    private buildPreparationSetupRequest;
+    private buildActionProposal;
+    private submitActionProposal;
+    private resolvePreparationConfig;
+    private ensureCompiledForRun;
+    private readCompileRun;
+    private writeCompileRun;
+    private writeJobRun;
+    private writeActionProposal;
+    private setJobRunResult;
+    private recordCompileRunEvent;
+    private refreshCompileRunFromRuntime;
+    private emitRuntimeDerivedEvents;
+    private readLatestComparison;
+    private checksEvaluatedEvent;
+    private readinessUpdatedEvent;
+    private writeTestRun;
+}
+export declare function createLocalServiceRuntime(options: LocalServiceRuntimeOptions): LocalServiceRuntime;