@evo-dev/core 0.0.1-alpha.2 → 0.0.1-alpha.20

package/src/evolution/imports/types.ts

@@ -0,0 +1,226 @@
+export const TRAJECTORY_IMPORT_PREVIEW_SCHEMA_VERSION = 1 as const;
+export const TRAJECTORY_IMPORT_DIAGNOSTIC_POLICY_VERSION = 1 as const;
+
+export type TrajectoryImportSource =
+  | "claude-code"
+  | "codex"
+  | "hermes"
+  | "letta-code"
+  | "openclaw"
+  | "openhands";
+
+export type CanonicalImportRecordType =
+  | "meta"
+  | "user"
+  | "reasoning"
+  | "assistant"
+  | "assistant-tool-call"
+  | "tool";
+
+export type CanonicalImportSourceIdentityKind = "native" | "location" | "content" | "synthetic";
+
+export interface CanonicalImportSnapshot {
+  source: TrajectoryImportSource;
+  explicitSourceId: string | null;
+  inputBytes: number;
+  inputFingerprint: string;
+  normalizer: {
+    package: "@letta-ai/trajectory";
+    version: string;
+    canonicalSchemaVersion: number;
+    canonicalConfigHash: string;
+  };
+  groups: Array<{
+    sourceGroupId: string;
+    records: Array<{
+      recordId: string;
+      contentHash: string;
+      sourceOrderId: string;
+      componentIndex: number;
+      sourceIdentityKind: CanonicalImportSourceIdentityKind;
+      recordType: CanonicalImportRecordType;
+      recordJson: string;
+    }>;
+  }>;
+  diagnostics: Array<{ code: string }>;
+}
+
+export type TrajectoryImportDiagnosticSeverity = "info" | "warning" | "blocker";
+
+export interface TrajectoryImportIndexRecordV1 {
+  schemaVersion: 1;
+  kind: "trajectory-import-index-record";
+  stableRecordKeyHash: string;
+  contentDigest: string;
+  ordinal: number;
+  sourceIdentityKind: CanonicalImportSourceIdentityKind;
+  recordType: CanonicalImportRecordType;
+}
+
+export interface TrajectoryImportGenerationContractV1 {
+  normalizerVersion: string;
+  canonicalSchemaVersion: number;
+  canonicalConfigHash: string;
+}
+
+export interface TrajectoryImportPreviousSnapshotV1 {
+  sourceKey: string;
+  generationId: string;
+  initialInputFingerprint: string;
+  generationContract: TrajectoryImportGenerationContractV1;
+  snapshotId: string;
+  records: TrajectoryImportIndexRecordV1[];
+}
+
+export interface TrajectoryImportMaterializationPreviewV1 {
+  selectedRecords: number;
+  estimatedSegments: number;
+  truncatedSegments: number;
+  credentialRedactions: number;
+  estimatedTriggers: number;
+  retentionDays: number;
+}
+
+export interface TrajectoryImportDownstreamPreviewV1 {
+  semanticProcessing: "queue-only" | "automation-eligible";
+  automationKnowledge: boolean;
+  automationSemanticKnowledge: boolean;
+  mayInvokeConfiguredProviderAfterApply: boolean;
+}
+
+export interface TrajectoryImportPreviewV1 {
+  schemaVersion: 1;
+  kind: "trajectory-import-preview";
+  id: string;
+  source: TrajectoryImportSource;
+  sourceKey: string;
+  projectKey: string | null;
+  scope: {
+    roleId: string | null;
+  };
+  input: {
+    bytes: number;
+    fingerprint: string;
+    pathHash: string;
+  };
+  normalizer: {
+    version: string;
+    canonicalSchemaVersion: number;
+    canonicalConfigHash: string;
+  };
+  contracts: {
+    diagnosticPolicyVersion: number;
+    materializerVersion: number;
+    materializerConfigHash: string;
+  };
+  generationId: string;
+  snapshotId: string;
+  previousSnapshotId: string | null;
+  records: {
+    total: number;
+    new: number;
+    unchanged: number;
+    changed: number;
+    missing: number;
+    recordTypes: Record<CanonicalImportRecordType, number>;
+    identityKinds: Record<CanonicalImportSourceIdentityKind, number>;
+  };
+  diagnostics: Array<{
+    code: string;
+    severity: TrajectoryImportDiagnosticSeverity;
+    count: number;
+  }>;
+  materialization: TrajectoryImportMaterializationPreviewV1 | null;
+  downstream: TrajectoryImportDownstreamPreviewV1;
+  blockers: string[];
+  canApply: boolean;
+  rawContentStored: false;
+}
+
+export interface CreateTrajectoryImportPreviewInput {
+  snapshot: CanonicalImportSnapshot;
+  projectKey?: string | null;
+  roleId?: string | null;
+  pathHash: string;
+  previous?: TrajectoryImportPreviousSnapshotV1 | null;
+}
+
+export interface TrajectoryImportPreviewBuildResult {
+  preview: TrajectoryImportPreviewV1;
+  comparisonSnapshot: TrajectoryImportPreviousSnapshotV1;
+}
+
+export type TrajectoryImportApplyState = "staged" | "materializing" | "completed";
+
+export interface TrajectoryImportManifestV1 {
+  schemaVersion: 1;
+  kind: "trajectory-import-manifest";
+  source: TrajectoryImportSource;
+  sourceKey: string;
+  projectKey: string;
+  scope: {
+    roleId: string | null;
+  };
+  currentGenerationId: string;
+  initialInputFingerprint: string;
+  generationContract: TrajectoryImportGenerationContractV1;
+  currentSnapshotId: string;
+  previousSnapshotId: string | null;
+  currentPreviewId: string;
+  currentInputFingerprint: string;
+  currentInputBytes: number;
+  currentIndexDigest: string;
+  stagedAt: string;
+  applyState: TrajectoryImportApplyState;
+  latestMaterializedSnapshotId: string | null;
+  rawContentStored: false;
+}
+
+export interface TrajectoryImportReceiptV1 {
+  schemaVersion: 1;
+  kind: "trajectory-import-receipt";
+  previewId: string;
+  sourceKey: string;
+  generationId: string;
+  snapshotId: string;
+  operation: "stage" | "materialize";
+  outcome: "staged" | "completed";
+  counts: {
+    total: number;
+    new: number;
+    unchanged: number;
+    changed: number;
+    missing: number;
+  };
+  createdAt: string;
+  rawContentStored: false;
+}
+
+export interface StageTrajectoryImportInput {
+  homeDir: string;
+  preview: TrajectoryImportPreviewV1;
+  comparisonSnapshot: TrajectoryImportPreviousSnapshotV1;
+  now?: string;
+}
+
+export interface StageTrajectoryImportResult {
+  status: "staged" | "unchanged";
+  manifest: TrajectoryImportManifestV1;
+  receipt: TrajectoryImportReceiptV1;
+  stateWrites: string[];
+}
+
+export interface TrajectoryImportMaterializationProgressV1 {
+  schemaVersion: 1;
+  kind: "trajectory-import-materialization-progress";
+  previewId: string;
+  sourceKey: string;
+  generationId: string;
+  snapshotId: string;
+  expectedSegmentIds: string[];
+  completedSegmentIds: string[];
+  expectedTriggerIds: string[];
+  completedTriggerIds: string[];
+  updatedAt: string;
+  rawContentStored: false;
+}