@pegma/support-desk-application 0.1.0 → 0.2.0

package/dist/resolution-learning-records.d.ts

@@ -0,0 +1,154 @@
+import type { IsoTimestamp } from "@pegma/spine";
+import type { EntityKey } from "@pegma/storage-core";
+import type { ResolutionEvidence, ResolutionLearningCandidate, ResolutionLearningClaimFence, ResolutionLearningDeliveryRequest, ResolutionLearningModelBinding, ResolutionLearningOptions, ResolutionLearningProcessing, ResolutionLearningSourceReference, ResolutionLearningTarget, ResolutionProductContext } from "./resolution-learning-types.js";
+export interface ResolutionLearningDestination {
+    readonly articleId: string;
+    readonly sourceGeneration: number;
+    readonly stepId: string;
+    readonly requestHash: string;
+    readonly acceptance: "unknown" | "accepted";
+    readonly reconciliation: "pending" | "blocked" | "confirmed";
+    readonly lastReconciliation?: {
+        readonly fingerprint: string;
+        readonly disposition: "blocked" | "retired" | "unaffected_publication" | "write_rejected";
+        readonly observedAt: string;
+        readonly proof?: {
+            readonly kind: "terminal_receipt" | "revision_fence" | "trusted_cancellation";
+            readonly binding: string;
+        };
+    };
+}
+export interface ResolutionLearningReview {
+    readonly sourceGeneration: number;
+    readonly sourceBindingHash: string;
+    readonly target: ResolutionLearningTarget;
+    readonly decision: "approve" | "reject";
+    readonly policyVersion: string;
+    readonly reviewerId: string;
+    readonly reviewedAt: IsoTimestamp;
+    readonly reason?: string;
+}
+export interface ResolutionLearningReviewRecord extends ResolutionLearningReview {
+    readonly kind: "resolution_learning_review";
+    readonly partition: string;
+    readonly id: string;
+    readonly ticketId: string;
+}
+export interface ResolutionLearningSourceRecord {
+    readonly kind: "resolution_learning_source";
+    readonly partition: string;
+    readonly id: "learning-source";
+    readonly ticketId: string;
+    readonly sourceId: string;
+    readonly resolutionCycle: number;
+    readonly sourceGeneration: number;
+    readonly workGeneration: number;
+    readonly generationCount: number;
+    readonly reviewBindingCount: number;
+    readonly state: "unverified" | "eligible" | "held" | "withdrawn";
+    readonly createdAt: IsoTimestamp;
+    readonly updatedAt: IsoTimestamp;
+    readonly heldReason?: string;
+    readonly resolvedAt?: IsoTimestamp;
+    readonly acceptedTicketRevision?: number;
+    readonly proofIdentity?: string;
+    readonly sourceBindingHash?: string;
+    readonly evidenceFingerprint?: string;
+    readonly productContextFingerprint?: string;
+    readonly evidence?: ResolutionEvidence;
+    readonly product?: ResolutionProductContext;
+    readonly pendingProofReference?: string;
+    readonly destinations: readonly ResolutionLearningDestination[];
+    readonly reconciliationPending: boolean;
+}
+export interface ResolutionLearningAttempt {
+    readonly preparedClaimGeneration: number;
+    readonly stepId: string;
+    readonly requestHash: string;
+    readonly binding: ResolutionLearningModelBinding;
+    readonly accounting: "not_called" | "accounted" | "unknown";
+    readonly processing?: ResolutionLearningProcessing;
+}
+export interface ResolutionLearningWorkRecord {
+    readonly kind: "resolution_learning_work";
+    readonly partition: string;
+    readonly id: string;
+    readonly ticketId: string;
+    readonly sourceGeneration: number;
+    readonly resolutionCycle: number;
+    readonly sourceBindingHash: string;
+    readonly workGeneration: number;
+    readonly acceptedTicketRevision: number;
+    readonly workingSolutionMessageIds: readonly string[];
+    readonly createdAt: IsoTimestamp;
+    readonly deadline: IsoTimestamp;
+    readonly evidence?: ResolutionEvidence;
+    readonly product?: ResolutionProductContext;
+    readonly status: "pending" | "claimed" | "retry" | "candidate" | "prepared" | "completed" | "held" | "unknown" | "superseded";
+    readonly stage: "model" | "kb_delivery";
+    readonly modelAttempts: readonly ResolutionLearningAttempt[];
+    readonly claimGeneration: number;
+    readonly claim?: ResolutionLearningClaimFence;
+    readonly leaseUntil?: IsoTimestamp;
+    readonly retryAt?: IsoTimestamp;
+    readonly stepId?: string;
+    readonly requestHash?: string;
+    readonly candidate?: ResolutionLearningCandidate;
+    readonly candidateHash?: string;
+    readonly exactRequest?: ResolutionLearningDeliveryRequest;
+    readonly withdrawnRequest?: Omit<ResolutionLearningDeliveryRequest, "draftPayload">;
+    readonly usageTombstones?: readonly {
+        readonly stepId: string;
+        readonly requestHash: string;
+        readonly usageReservationId: string;
+        readonly accounting: "not_called" | "accounted" | "unknown";
+    }[];
+    readonly verifiedCheckReceipt?: string;
+    readonly checkPolicyVersion?: string;
+    readonly targetDecisionHash?: string;
+    readonly acknowledgement?: {
+        readonly id: string;
+        readonly generation: number;
+        readonly articleRevision: number;
+        readonly contentHash: string;
+        readonly state: string;
+    };
+    readonly target?: ResolutionLearningTarget;
+    readonly heldReason?: string;
+    readonly lastCompletion?: {
+        readonly fingerprint: string;
+    };
+    readonly lastFinish?: {
+        readonly fingerprint: string;
+    };
+}
+export interface ResolvedResolutionLearningOptions {
+    readonly enabled: boolean;
+    readonly productContext?: ResolutionLearningOptions["productContext"];
+    readonly testReceipts?: ResolutionLearningOptions["testReceipts"];
+    readonly checks?: ResolutionLearningOptions["checks"];
+    readonly trustTimeoutMilliseconds: number;
+    readonly maxGenerations: number;
+    readonly maxTargets: number;
+    readonly maxReviewBindings: number;
+    readonly maxModelAttempts: number;
+    readonly maxLeaseMilliseconds: number;
+    readonly maxWorkMilliseconds: number;
+}
+export declare const resolutionLearningRecordBytes = 60000;
+export declare const resolutionLearningCandidateBytes = 16000;
+export declare function maximumResolutionLearningSourceBytes(source: ResolutionLearningSourceRecord): number;
+export declare function safeLearningSnapshot<T>(value: T): T;
+export declare const resolutionLearningSourceKey: (ticketId: string) => EntityKey;
+export declare const resolutionLearningWorkKey: (ticketId: string, generation: number) => EntityKey;
+export declare function resolutionLearningReviewKey(source: ResolutionLearningSourceRecord, target: ResolutionLearningTarget, policyVersion: string): Promise<EntityKey>;
+export declare function resolveResolutionLearningOptions(input: ResolutionLearningOptions | undefined): ResolvedResolutionLearningOptions;
+export declare function validateResolutionProduct(value: unknown): asserts value is ResolutionProductContext;
+export declare function validateResolutionEvidence(value: unknown): asserts value is ResolutionEvidence;
+export declare function validateResolutionCandidate(value: unknown): asserts value is ResolutionLearningCandidate;
+export declare function validateResolutionReferences(value: unknown): asserts value is readonly ResolutionLearningSourceReference[];
+export declare function validateResolutionRequest(value: unknown): asserts value is ResolutionLearningDeliveryRequest;
+export declare function validateResolutionTarget(value: unknown): asserts value is ResolutionLearningTarget;
+/** Decoding checks the physical envelope as strictly as writes. */
+export declare function assertResolutionLearningRecord(value: unknown, key: EntityKey): asserts value is ResolutionLearningSourceRecord | ResolutionLearningWorkRecord | ResolutionLearningReviewRecord;
+//# sourceMappingURL=resolution-learning-records.d.ts.map

package/dist/resolution-learning-records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolution-learning-records.d.ts","sourceRoot":"","sources":["../src/resolution-learning-records.ts"],"names":[],"mappings":"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"}