@voce-engine/core 0.1.0-rc.1

package/dist/m6.d.ts

@@ -0,0 +1,182 @@
+import type { ArtifactHandle, AssetSink, Budget, CleanupReceipt, ComparisonReport, ComparisonSnapshot, EvaluationReplayStatus, EvaluationReport, ExecutionRun, HumanAcceptance, HumanAcceptanceAnnotation, HumanAcceptanceDecision, JsonObject, ProviderError, ProviderRequestEnvelope, ProviderResponseEnvelope, ProviderSubmissionLookup, ProviderTransport, ProviderTransportContext, RemoteCallAuthorization, RemoteCallRun, ReportArtifact, SemanticReviewFinding, SemanticReviewReport, SemanticReviewRequest, SemanticReviewer, StaticTraceReportModel, StaticTraceStep, StepReceipt, StructuralValidationArtifactInput, StructuralValidationFinding, StructuralValidationInput, StructuralValidationReport, VersionPin } from '@voce-engine/contracts';
+import { ARTIFACT_REPLAY_RESULT_SCHEMA_VERSION } from '@voce-engine/contracts';
+export declare const M6_RUNTIME_VERSION = "voce.adapters-evaluation-runtime/v1alpha1";
+export declare const STATIC_REPORT_VERSION = "voce.static-trace-report/v1alpha1";
+export declare const FIXED_M6_TIME = "2026-01-01T00:00:00.000Z";
+export interface ProviderCallRecord {
+    requestId: string;
+    requestHash: string;
+    adapterId: string;
+    profileDigest: string;
+    destination: string;
+    region?: string;
+    inputHash: string;
+    idempotencyKey: string;
+}
+export interface RecordingMockResponse {
+    requestHash?: string;
+    response: ProviderResponseEnvelope;
+}
+export interface RecordingMockTransportOptions {
+    responses?: ProviderResponseEnvelope[];
+    lookups?: ProviderResponseEnvelope[];
+}
+export declare class ProviderTransportError extends Error {
+    readonly code: string;
+    readonly safeDetails?: JsonObject;
+    constructor(code: string, message: string, safeDetails?: JsonObject);
+}
+export declare function computeArtifactBytesHash(bytes: Uint8Array): string;
+export declare function computeProviderRequestEnvelopeHash(request: ProviderRequestEnvelope): string;
+export declare function computeProviderResponseEnvelopeHash(response: ProviderResponseEnvelope): string;
+export declare function computeProviderErrorHash(error: ProviderError): string;
+export declare function computeProviderSubmissionLookupHash(request: ProviderSubmissionLookup): string;
+export declare class DisabledProviderTransport implements ProviderTransport {
+    readonly id = "voce.disabled-transport";
+    readonly mode: "offline";
+    send(request: ProviderRequestEnvelope, context: ProviderTransportContext): Promise<ProviderResponseEnvelope>;
+    lookup(request: ProviderSubmissionLookup, context: ProviderTransportContext): Promise<ProviderResponseEnvelope>;
+}
+export declare function createProviderSubmissionLookup(request: ProviderRequestEnvelope, providerRequestId?: string): ProviderSubmissionLookup;
+export declare class RecordingMockTransport implements ProviderTransport {
+    readonly id = "voce.recording-mock-transport";
+    readonly mode: "offline";
+    readonly calls: ProviderCallRecord[];
+    readonly lookupCalls: ProviderCallRecord[];
+    private readonly responses;
+    private readonly lookups;
+    private readonly sentRequests;
+    private readonly sendCounts;
+    private readonly lookupCounts;
+    constructor(options?: RecordingMockTransportOptions | ProviderResponseEnvelope[]);
+    enqueue(response: ProviderResponseEnvelope): void;
+    enqueueLookup(response: ProviderResponseEnvelope): void;
+    private consume;
+    send(request: ProviderRequestEnvelope, context: ProviderTransportContext): Promise<ProviderResponseEnvelope>;
+    lookup(request: ProviderSubmissionLookup, context: ProviderTransportContext): Promise<ProviderResponseEnvelope>;
+}
+export interface SeedreamAdapterConfig {
+    endpoint: string;
+    credentialRef: string;
+    model: string;
+    modelVersion: string;
+    adapter: VersionPin;
+    profile: VersionPin;
+    destination: string;
+    region?: string;
+    endpointProfile?: 'domestic' | 'overseas';
+    transport?: ProviderTransport;
+    assetSink: AssetSink;
+    resolver?: (artifact: ArtifactHandle) => Promise<Uint8Array | undefined>;
+}
+export type SeedreamImageInput = string | ArtifactHandle | Uint8Array;
+export interface SeedreamGenerateInput {
+    prompt: string;
+    image?: SeedreamImageInput | SeedreamImageInput[];
+    n?: number;
+    sequential_image_generation?: unknown;
+    output_format?: 'png' | 'jpeg';
+    size?: string;
+    watermark?: boolean;
+    referenceArtifacts?: StructuralValidationArtifactInput[];
+    [key: string]: unknown;
+}
+export interface SeedreamGenerationResult {
+    status: 'succeeded' | 'failed' | 'submission_unknown';
+    artifacts: ArtifactHandle[];
+    response: ProviderResponseEnvelope;
+    lookup?: ProviderSubmissionLookup;
+    failureCode?: string;
+}
+export declare function validateSeedreamConfig(config: SeedreamAdapterConfig): void;
+export declare function buildSeedreamRequest(input: SeedreamGenerateInput, config: SeedreamAdapterConfig, authorization?: RemoteCallAuthorization): ProviderRequestEnvelope;
+export declare class SeedreamAdapter {
+    readonly config: SeedreamAdapterConfig;
+    readonly id: string;
+    readonly version: VersionPin;
+    readonly digest: string;
+    readonly profileDigest: string;
+    readonly offline: boolean;
+    private readonly transport;
+    constructor(config: SeedreamAdapterConfig);
+    buildRequest(input: SeedreamGenerateInput, authorization?: RemoteCallAuthorization): ProviderRequestEnvelope;
+    generate(input: SeedreamGenerateInput, authorization: RemoteCallAuthorization, context?: Omit<ProviderTransportContext, 'authorization'>): Promise<SeedreamGenerationResult>;
+    lookup(lookup: ProviderSubmissionLookup, authorization: RemoteCallAuthorization, context?: Omit<ProviderTransportContext, 'authorization'>): Promise<SeedreamGenerationResult>;
+}
+export declare function createSeedreamAdapter(config: SeedreamAdapterConfig): SeedreamAdapter;
+export declare function computeStructuralValidationInputHash(input: StructuralValidationInput): string;
+export declare function computeStructuralValidationFindingHash(findingValue: StructuralValidationFinding): string;
+export declare function computeStructuralValidationReportHash(report: StructuralValidationReport): string;
+export declare function validateStructuralImage(input: StructuralValidationInput): StructuralValidationReport;
+export declare const structuralValidate: typeof validateStructuralImage;
+export declare class StructuralImageValidator {
+    validate(input: StructuralValidationInput): StructuralValidationReport;
+}
+export declare function computeSemanticReviewRequestHash(request: SemanticReviewRequest): string;
+export declare function computeSemanticReviewFindingHash(findingValue: SemanticReviewFinding): string;
+export declare function computeSemanticReviewReportHash(report: SemanticReviewReport): string;
+export interface FixtureSemanticReviewerOptions {
+    findings?: SemanticReviewFinding[];
+    warnings?: string[];
+}
+export declare class FixtureSemanticReviewer implements SemanticReviewer {
+    private readonly options;
+    readonly id = "voce.fixture-semantic-reviewer";
+    readonly version: VersionPin;
+    constructor(options?: FixtureSemanticReviewerOptions);
+    review(request: SemanticReviewRequest, authorization: RemoteCallAuthorization): Promise<SemanticReviewReport>;
+}
+export interface SemanticReviewExecution {
+    report: SemanticReviewReport;
+    remoteCallRun: RemoteCallRun;
+    receipt: StepReceipt;
+}
+export declare function executeSemanticReview(reviewer: SemanticReviewer, request: SemanticReviewRequest, authorization: RemoteCallAuthorization): Promise<SemanticReviewExecution>;
+export declare function computeHumanAcceptanceAnnotationHash(annotation: HumanAcceptanceAnnotation): string;
+export declare function computeHumanAcceptanceDecisionHash(decision: HumanAcceptanceDecision): string;
+export declare function createHumanAcceptanceDecision(input: Omit<HumanAcceptanceDecision, 'decisionHash'>): HumanAcceptanceDecision;
+export interface EvaluationCompilerInput {
+    run: Pick<ExecutionRun, 'id' | 'technicalOutcome' | 'state' | 'contextHash' | 'pipelinePlanHash' | 'promptArtifactHash'>;
+    structural?: StructuralValidationReport;
+    semanticProposal?: SemanticReviewReport;
+    humanAcceptance?: HumanAcceptance | HumanAcceptanceDecision;
+    cleanup?: CleanupReceipt[];
+    replay?: EvaluationReplayStatus;
+    artifacts?: ArtifactHandle[];
+    sourceHashes?: Record<string, string>;
+}
+export declare function computeEvaluationReportHash(report: EvaluationReport): string;
+export declare function compileEvaluationReport(input: EvaluationCompilerInput): EvaluationReport;
+export declare const compileEvaluation: typeof compileEvaluationReport;
+export declare function compareSnapshots(input: {
+    caseId: string;
+    beforeRevision: number;
+    afterRevision: number;
+    before: ComparisonSnapshot;
+    after: ComparisonSnapshot;
+}): ComparisonReport;
+export declare const compare: typeof compareSnapshots;
+export declare function computeComparisonReportHash(report: ComparisonReport): string;
+export declare function computeStaticTraceReportModelHash(model: StaticTraceReportModel): string;
+export declare function renderStaticTraceReport(model: StaticTraceReportModel): ReportArtifact;
+export declare const createStaticTraceReport: typeof renderStaticTraceReport;
+export declare function writeStaticTraceReport(model: StaticTraceReportModel, outputPath: string): Promise<ReportArtifact>;
+export declare function traceModelFromExecution(input: {
+    run: ExecutionRun;
+    receipts: StepReceipt[];
+    cleanup: CleanupReceipt[];
+    reconciliation: RemoteCallRun[];
+    steps?: StaticTraceStep[];
+    artifacts?: ArtifactHandle[];
+    structural?: StructuralValidationReport;
+    semanticProposal?: SemanticReviewReport;
+    humanAcceptance?: HumanAcceptanceDecision;
+    budgets?: Budget[];
+    destinations?: string[];
+    comparison?: ComparisonReport;
+    warnings?: string[];
+    constraintHash?: string;
+    referencePlanHash?: string;
+    promptHash?: string;
+}): StaticTraceReportModel;
+export { ARTIFACT_REPLAY_RESULT_SCHEMA_VERSION };