@interf/compiler 0.7.3 → 0.9.1

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

@@ -0,0 +1,134 @@
+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 "../compiler/lib/schema.js";
+import type { SourceDatasetConfig } from "../project-model/lib/schema.js";
+import { type ActionProposalCreateRequest, type ActionProposalPlan, type ActionProposalResource, type CompileRunCreateRequest, type CompileRunResource, type DatasetResource, 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 WorkflowAuthoringCreateRequest, type WorkflowAuthoringResult, type WorkflowPackageResource } from "./lib/schema.js";
+export interface LocalServiceCompileRunContext {
+    runId: string;
+    sourcePath: string;
+    compiledPath: string;
+    datasetConfig: SourceDatasetConfig;
+    events: RunEventSink;
+}
+export interface LocalServiceTestRunContext {
+    runId: string;
+    sourcePath: string;
+    compiledPath: string;
+    datasetConfig: SourceDatasetConfig;
+}
+export interface LocalServiceJobRunContext {
+    runId: string;
+    sourcePath: string;
+    emit(event: LocalJobEventAppendRequest): void;
+}
+export interface LocalServiceActionPlanningContext {
+    sourcePath: string;
+    datasets: SourceDatasetConfig[];
+    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>;
+    createWorkflowAuthoringRun(request: WorkflowAuthoringCreateRequest, context: LocalServiceJobRunContext): Promise<WorkflowAuthoringResult>;
+}
+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;
+    listDatasets(): DatasetResource[];
+    getDataset(datasetName: string): DatasetResource | null;
+    listPreparations(): PreparationResource[];
+    getPreparation(preparationName: string): PreparationResource | null;
+    listPreparationReadiness(): PreparationReadinessState[];
+    getPreparationReadiness(preparationName: string): PreparationReadinessState | null;
+    listReadiness(): ReadinessState[];
+    getReadiness(datasetName: string): ReadinessState | null;
+    computeDatasetReadiness(dataset: SourceDatasetConfig): ReadinessState;
+    listSourceFiles(datasetName?: string | null): SourceFileResource[];
+    listWorkspaceFiles(): WorkspaceFileResource[];
+    listWorkflowPackages(): WorkflowPackageResource[];
+    getWorkflowPackage(workflowId: string): WorkflowPackageResource | null;
+    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>;
+    createDatasetSetupRun(requestValue: unknown): Promise<LocalJobRunResource>;
+    createWorkflowAuthoringRun(requestValue: unknown): Promise<LocalJobRunResource>;
+    listPortableContexts(): PortableContextResource[];
+    getPortableContext(datasetName: string): PortableContextResource | null;
+    listCompileRuns(): CompileRunResource[];
+    listCompileRunsForDataset(datasetName: 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[];
+    listTestRunsForDataset(datasetName: string): TestRunResource[];
+    getTestRun(runId: string): TestRunResource | null;
+    createTestRun(requestValue: unknown): Promise<TestRunResource>;
+    private runCompileInBackground;
+    private runTestInBackground;
+    private runReadinessCheckDraftInBackground;
+    private runWorkflowAuthoringInBackground;
+    private jobRunContext;
+    private defaultDatasetName;
+    private planActionProposal;
+    private buildDatasetSetupRequest;
+    private buildActionProposal;
+    private submitActionProposal;
+    private resolveDatasetConfig;
+    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;