@voce-engine/core 0.1.0-rc.1

package/dist/m5.d.ts

@@ -0,0 +1,183 @@
+import type { ArtifactHandle, ArtifactReplayResult, CompilationContext, CompensationReceipt, ConstraintIR, CleanupReceipt, Evaluation, ExecutionAuthorization, ExecutionRun, ExecutionTraceProjection, HumanAcceptance, JsonObject, PipelinePlan, PipelineStep, PromptCandidateIR, PromptCompilationInput, PromptGuardInput, PromptGuardResult, PromptIR, PromptOptimizationInput, PromptOptimizer, PromptTransformation, ProviderAdapter, ProviderRenderRequest, ProviderRenderResult, ReferencePlan, RemoteCallRun, RemoteCallAuthorization, StepReceipt, VersionPin } from '@voce-engine/contracts';
+export declare const PROMPT_COMPILER_VERSION = "voce.prompt-compiler/v1alpha1";
+export declare const PROMPT_OPTIMIZER_VERSION = "voce.deterministic-prompt-optimizer/v1alpha1";
+export declare const PROMPT_GUARD_VERSION = "voce.prompt-guard/v1alpha1";
+export declare const MOCK_PROVIDER_ADAPTER_VERSION = "voce.mock-provider-adapter/v1alpha1";
+export declare const EXECUTION_RUNTIME_VERSION = "voce.offline-execution-runtime/v1alpha1";
+export declare const FIXED_M5_TIME = "2026-01-01T00:00:00.000Z";
+export declare function computePromptIRHash(prompt: PromptIR): string;
+export declare const computePromptIRSignature: typeof computePromptIRHash;
+export declare function computePromptTransformationHash(transformation: PromptTransformation): string;
+export declare function computePromptCandidateHash(candidate: PromptCandidateIR): string;
+export declare function computePromptGuardResultHash(result: PromptGuardResult): string;
+export declare class PromptCompiler {
+    compile(input: PromptCompilationInput): PromptIR;
+}
+export declare const DeterministicPromptCompiler: typeof PromptCompiler;
+export declare function compilePromptIR(input: PromptCompilationInput): PromptIR;
+export declare const compilePrompt: typeof compilePromptIR;
+export interface PromptCandidateOptions {
+    optimizer?: VersionPin;
+    mode?: 'strict' | 'balanced' | 'creative';
+    warnings?: string[];
+}
+export declare function createPromptCandidateIR(prompt: PromptIR, transformations?: PromptTransformation[], options?: PromptCandidateOptions): PromptCandidateIR;
+export declare class DeterministicPromptOptimizer implements PromptOptimizer {
+    optimize(input: PromptOptimizationInput): PromptCandidateIR;
+}
+export declare const BaselinePromptOptimizer: typeof DeterministicPromptOptimizer;
+export declare const OfflinePromptOptimizer: typeof DeterministicPromptOptimizer;
+export declare function optimizePromptIR(input: PromptOptimizationInput): PromptCandidateIR;
+export declare function optimizePromptIRWithFallback(input: PromptOptimizationInput): PromptCandidateIR;
+export declare const optimizePromptSafely: typeof optimizePromptIRWithFallback;
+export declare class PromptGuard {
+    guard(input: PromptGuardInput): PromptGuardResult;
+}
+export declare const DeterministicPromptGuard: typeof PromptGuard;
+export declare function guardPromptCandidate(input: PromptGuardInput): PromptGuardResult;
+export declare const guardPrompt: typeof guardPromptCandidate;
+export interface ProviderRenderInput {
+    promptIR: PromptIR;
+    candidate?: PromptCandidateIR;
+    guardResult?: PromptGuardResult;
+    caseId?: string;
+    caseRevision?: number;
+    contextHash?: string;
+    pipelinePlanHash?: string;
+}
+export declare function computeProviderRenderRequestHash(request: ProviderRenderRequest): string;
+export declare function createProviderRenderRequest(input: ProviderRenderInput): ProviderRenderRequest;
+export declare const renderProviderRequest: typeof createProviderRenderRequest;
+export declare const OFFLINE_EXECUTION_INPUT_SCHEMA_VERSION: "voce.offline-execution-input/v1alpha1";
+export interface OfflineExecutionOptions {
+    now?: string;
+    failStepIds?: string[];
+    unknownStepIds?: string[];
+    retryableFailureStepIds?: string[];
+    cancelBeforeStepId?: string;
+    workerRestartAfterStepId?: string;
+    cleanupFailureIds?: string[];
+    compensationFailureIds?: string[];
+    maximumCleanupRetries?: number;
+}
+export interface OfflineExecutionInput {
+    schemaVersion: typeof OFFLINE_EXECUTION_INPUT_SCHEMA_VERSION;
+    context: CompilationContext;
+    contextHash: string;
+    constraintIR: ConstraintIR;
+    referencePlan: ReferencePlan;
+    pipelinePlan: PipelinePlan;
+    outputContract: PromptCompilationInput['outputContract'];
+    promptArtifact: PromptIR | PromptCandidateIR;
+    promptGuardResult?: PromptGuardResult;
+    executionAuthorization: ExecutionAuthorization;
+    remoteCallAuthorizations: RemoteCallAuthorization[];
+    options?: OfflineExecutionOptions;
+}
+export interface OfflineExecutionResult {
+    status: 'blocked' | 'completed' | 'failed' | 'submission_unknown' | 'cancelled' | 'needs_review';
+    code: string;
+    reasons: string[];
+    executionRun?: ExecutionRun;
+    run?: ExecutionRun;
+    events: import('@voce-engine/contracts').StepEvent[];
+    receipts: StepReceipt[];
+    remoteCallRuns: RemoteCallRun[];
+    cleanupReceipts: CleanupReceipt[];
+    compensationReceipts: CompensationReceipt[];
+    evaluation?: Evaluation;
+    humanAcceptance?: HumanAcceptance;
+    trace?: ExecutionTraceProjection;
+}
+export interface MockStepExecutionContext {
+    runId: string;
+    step: PipelineStep;
+    promptArtifactHash: string;
+    referencePlanHash: string;
+    outputContract: OfflineExecutionInput['outputContract'];
+    attempt: number;
+    options: OfflineExecutionOptions;
+}
+export interface MockStepExecutionResult {
+    status: 'succeeded' | 'failed' | 'submission_unknown' | 'cancelled';
+    outputArtifacts: ArtifactHandle[];
+    metadata: JsonObject;
+    providerRequestId?: string;
+    failureCode?: string;
+    actualCost?: number;
+    actualBytes?: number;
+}
+export interface OfflineStepAdapter {
+    id: string;
+    version: VersionPin;
+    digest: string;
+    profileDigest?: string;
+    executeStep(context: MockStepExecutionContext): MockStepExecutionResult;
+    reconcileStep?(context: MockStepExecutionContext): MockStepExecutionResult;
+}
+export declare function computeExecutionDataTransferDigest(plan: PipelinePlan): string;
+export declare function computeExecutionBudgetDigest(plan: PipelinePlan): string;
+export declare function computeExecutionStepInputHash(step: PipelineStep, contextHash: string, pipelinePlanHash: string, referencePlanHash: string, promptArtifactHashValue: string, referenceContentHashes?: string[]): string;
+export interface MockProviderAdapterOptions {
+    failStepIds?: string[];
+    unknownStepIds?: string[];
+    retryableFailureStepIds?: string[];
+    version?: VersionPin;
+    digest?: string;
+    profileDigest?: string;
+}
+export declare class MockProviderAdapter implements ProviderAdapter, OfflineStepAdapter {
+    readonly id: string;
+    readonly version: VersionPin;
+    readonly digest: string;
+    readonly profileDigest?: string;
+    readonly offline = true;
+    private readonly options;
+    constructor(options?: MockProviderAdapterOptions, id?: string);
+    render(request: ProviderRenderRequest): ProviderRenderResult;
+    executeStep(context: MockStepExecutionContext): MockStepExecutionResult;
+    reconcileStep(context: MockStepExecutionContext): MockStepExecutionResult;
+}
+export declare class MockGeneratorAdapter extends MockProviderAdapter {
+    constructor(options?: MockProviderAdapterOptions);
+}
+export declare class MockPostprocessorAdapter extends MockProviderAdapter {
+    constructor(options?: MockProviderAdapterOptions);
+}
+export declare class MockNormalizerAdapter extends MockProviderAdapter {
+    constructor(options?: MockProviderAdapterOptions);
+}
+export declare class MockStructuralValidatorAdapter extends MockProviderAdapter {
+    constructor(options?: MockProviderAdapterOptions);
+}
+export declare function computeExecutionRunHash(run: ExecutionRun): string;
+export declare function computeExecutionTraceHash(trace: ExecutionTraceProjection): string;
+export declare function projectExecutionTrace(trace: ExecutionTraceProjection): ExecutionTraceProjection;
+export declare const deterministicTraceProjection: typeof projectExecutionTrace;
+export declare function serializeExecutionTrace(trace: ExecutionTraceProjection): string;
+export declare const executionTraceJson: typeof serializeExecutionTrace;
+export declare class OfflineExecutionRuntime {
+    private readonly adapters;
+    private readonly records;
+    constructor(adapter?: OfflineStepAdapter, adapters?: OfflineStepAdapter[]);
+    private executeRegisteredStep;
+    execute(input: OfflineExecutionInput): OfflineExecutionResult;
+    get(runId: string): OfflineExecutionResult | undefined;
+    run(input: OfflineExecutionInput): OfflineExecutionResult;
+    dispatch(input: OfflineExecutionInput): OfflineExecutionResult;
+    reconcile(runId: string, state: 'running' | 'validating' | 'completed' | 'failed' | 'cancelled'): OfflineExecutionResult;
+    cancel(runId: string): OfflineExecutionResult;
+    cancelRun(runId: string): OfflineExecutionResult;
+    acceptHumanAcceptance(runId: string, reviewerId?: string): OfflineExecutionResult;
+    declineHumanAcceptance(runId: string, reasonCode?: string, reviewerId?: string): OfflineExecutionResult;
+    getTrace(runId: string): ExecutionTraceProjection | undefined;
+}
+export declare function createOfflineExecutionRuntime(adapter?: OfflineStepAdapter, adapters?: OfflineStepAdapter[]): OfflineExecutionRuntime;
+export declare function createMockRuntimeForPlan(plan: PipelinePlan, options?: MockProviderAdapterOptions): OfflineExecutionRuntime;
+export declare const OfflineExecutionEngine: typeof OfflineExecutionRuntime;
+export declare function executeOffline(input: OfflineExecutionInput, runtime?: OfflineExecutionRuntime): OfflineExecutionResult;
+export declare const executePipeline: typeof executeOffline;
+export declare const runOfflineExecution: typeof executeOffline;
+export declare function replayArtifacts(artifacts: ArtifactHandle[], traceHash?: string): ArtifactReplayResult;
+export declare function replayArtifact(artifact: ArtifactHandle, traceHash?: string): ArtifactReplayResult;
+export declare const replayArtifactHandles: typeof replayArtifacts;