om-memory-system 3.0.0

package/dist/shared/api/portability-schemas.d.ts

@@ -0,0 +1,56 @@
+import { z } from "zod";
+export declare const PORTABILITY_SCHEMA_VERSION: 1;
+export declare const ExportedMemorySchema: z.ZodObject<{
+    id: z.ZodString;
+    content: z.ZodString;
+    type: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    createdAt: z.ZodNumber;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    isPinned: z.ZodOptional<z.ZodBoolean>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    displayName: z.ZodOptional<z.ZodString>;
+    userName: z.ZodOptional<z.ZodString>;
+    userEmail: z.ZodOptional<z.ZodString>;
+    projectPath: z.ZodOptional<z.ZodString>;
+    projectName: z.ZodOptional<z.ZodString>;
+    gitRepoUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const MemoryExportDocumentSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    exportedAt: z.ZodString;
+    plugin: z.ZodObject<{
+        package: z.ZodString;
+        version: z.ZodString;
+    }, z.core.$strip>;
+    source: z.ZodObject<{
+        containerTag: z.ZodString;
+        scope: z.ZodLiteral<"project">;
+        scopeHash: z.ZodString;
+        projectPath: z.ZodOptional<z.ZodString>;
+        projectName: z.ZodOptional<z.ZodString>;
+        gitRepoUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    embedding: z.ZodObject<{
+        model: z.ZodString;
+        dimensions: z.ZodNumber;
+    }, z.core.$strip>;
+    memories: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        content: z.ZodString;
+        type: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        createdAt: z.ZodNumber;
+        updatedAt: z.ZodOptional<z.ZodNumber>;
+        isPinned: z.ZodOptional<z.ZodBoolean>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        displayName: z.ZodOptional<z.ZodString>;
+        userName: z.ZodOptional<z.ZodString>;
+        userEmail: z.ZodOptional<z.ZodString>;
+        projectPath: z.ZodOptional<z.ZodString>;
+        projectName: z.ZodOptional<z.ZodString>;
+        gitRepoUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ExportedMemory = z.infer<typeof ExportedMemorySchema>;
+export type MemoryExportDocument = z.infer<typeof MemoryExportDocumentSchema>;

package/dist/shared/api/portability-schemas.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+export const PORTABILITY_SCHEMA_VERSION = 1;
+export const ExportedMemorySchema = z.object({
+    id: z.string().min(1),
+    content: z.string().min(1),
+    type: z.string().optional(),
+    tags: z.array(z.string()).optional(),
+    createdAt: z.number().int().nonnegative(),
+    updatedAt: z.number().int().nonnegative().optional(),
+    isPinned: z.boolean().optional(),
+    metadata: z.record(z.string(), z.unknown()).optional(),
+    displayName: z.string().optional(),
+    userName: z.string().optional(),
+    userEmail: z.string().optional(),
+    projectPath: z.string().optional(),
+    projectName: z.string().optional(),
+    gitRepoUrl: z.string().optional(),
+});
+export const MemoryExportDocumentSchema = z.object({
+    schemaVersion: z.literal(PORTABILITY_SCHEMA_VERSION),
+    exportedAt: z.string().min(1),
+    plugin: z.object({
+        package: z.string(),
+        version: z.string(),
+    }),
+    source: z.object({
+        containerTag: z.string().min(1),
+        scope: z.literal("project"),
+        scopeHash: z.string().regex(/^[a-f0-9]{16}$/),
+        projectPath: z.string().optional(),
+        projectName: z.string().optional(),
+        gitRepoUrl: z.string().optional(),
+    }),
+    embedding: z.object({
+        model: z.string(),
+        dimensions: z.number().int().positive(),
+    }),
+    memories: z.array(ExportedMemorySchema),
+});

package/dist/shared/api/schemas.d.ts

@@ -0,0 +1,295 @@
+import { z } from "zod";
+/** Envelope used by all JSON API responses. */
+export declare const ApiResultSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    data: z.ZodOptional<z.ZodUnknown>;
+    error: z.ZodOptional<z.ZodString>;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const TagInfoSchema: z.ZodObject<{
+    tag: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    displayName: z.ZodOptional<z.ZodString>;
+    userName: z.ZodOptional<z.ZodString>;
+    userEmail: z.ZodOptional<z.ZodString>;
+    projectPath: z.ZodOptional<z.ZodString>;
+    projectName: z.ZodOptional<z.ZodString>;
+    gitRepoUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const MemoryItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodEnum<{
+        memory: "memory";
+        prompt: "prompt";
+    }>;
+    content: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodOptional<z.ZodString>;
+    displayName: z.ZodOptional<z.ZodString>;
+    projectPath: z.ZodOptional<z.ZodString>;
+    projectName: z.ZodOptional<z.ZodString>;
+    gitRepoUrl: z.ZodOptional<z.ZodString>;
+    userName: z.ZodOptional<z.ZodString>;
+    userEmail: z.ZodOptional<z.ZodString>;
+    memoryType: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    isPinned: z.ZodOptional<z.ZodBoolean>;
+    linkedPromptId: z.ZodOptional<z.ZodString>;
+    linkedMemoryId: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    similarity: z.ZodOptional<z.ZodNumber>;
+    isContext: z.ZodOptional<z.ZodBoolean>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const PaginatedMemoriesSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodEnum<{
+            memory: "memory";
+            prompt: "prompt";
+        }>;
+        content: z.ZodString;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodOptional<z.ZodString>;
+        displayName: z.ZodOptional<z.ZodString>;
+        projectPath: z.ZodOptional<z.ZodString>;
+        projectName: z.ZodOptional<z.ZodString>;
+        gitRepoUrl: z.ZodOptional<z.ZodString>;
+        userName: z.ZodOptional<z.ZodString>;
+        userEmail: z.ZodOptional<z.ZodString>;
+        memoryType: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        isPinned: z.ZodOptional<z.ZodBoolean>;
+        linkedPromptId: z.ZodOptional<z.ZodString>;
+        linkedMemoryId: z.ZodOptional<z.ZodString>;
+        sessionId: z.ZodOptional<z.ZodString>;
+        similarity: z.ZodOptional<z.ZodNumber>;
+        isContext: z.ZodOptional<z.ZodBoolean>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+    page: z.ZodNumber;
+    pageSize: z.ZodNumber;
+    totalPages: z.ZodNumber;
+}, z.core.$strip>;
+export declare const ProfileItemSchema: z.ZodObject<{
+    category: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    confidence: z.ZodOptional<z.ZodNumber>;
+    frequency: z.ZodOptional<z.ZodNumber>;
+    evidence: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodString]>>;
+    steps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const ProfileDataSchema: z.ZodObject<{
+    preferences: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        category: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        confidence: z.ZodOptional<z.ZodNumber>;
+        frequency: z.ZodOptional<z.ZodNumber>;
+        evidence: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodString]>>;
+        steps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+    patterns: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        category: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        confidence: z.ZodOptional<z.ZodNumber>;
+        frequency: z.ZodOptional<z.ZodNumber>;
+        evidence: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodString]>>;
+        steps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+    workflows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        category: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        confidence: z.ZodOptional<z.ZodNumber>;
+        frequency: z.ZodOptional<z.ZodNumber>;
+        evidence: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodString]>>;
+        steps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const UserProfileSchema: z.ZodObject<{
+    exists: z.ZodBoolean;
+    message: z.ZodOptional<z.ZodString>;
+    id: z.ZodOptional<z.ZodString>;
+    userId: z.ZodOptional<z.ZodString>;
+    displayName: z.ZodOptional<z.ZodString>;
+    userName: z.ZodOptional<z.ZodString>;
+    userEmail: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodNumber>;
+    totalPromptsAnalyzed: z.ZodOptional<z.ZodNumber>;
+    lastAnalyzedAt: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodOptional<z.ZodString>;
+    profileData: z.ZodOptional<z.ZodObject<{
+        preferences: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            category: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            confidence: z.ZodOptional<z.ZodNumber>;
+            frequency: z.ZodOptional<z.ZodNumber>;
+            evidence: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodString]>>;
+            steps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+        patterns: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            category: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            confidence: z.ZodOptional<z.ZodNumber>;
+            frequency: z.ZodOptional<z.ZodNumber>;
+            evidence: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodString]>>;
+            steps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+        workflows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            category: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            confidence: z.ZodOptional<z.ZodNumber>;
+            frequency: z.ZodOptional<z.ZodNumber>;
+            evidence: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodString]>>;
+            steps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const CleanupChangesSchema: z.ZodObject<{
+    merged: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        ids: z.ZodArray<z.ZodString>;
+        result: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    removed: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        reason: z.ZodString;
+    }, z.core.$strip>>>;
+    kept: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const PendingCleanupSchema: z.ZodObject<{
+    old: z.ZodOptional<z.ZodObject<{
+        preferences: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            category: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            confidence: z.ZodOptional<z.ZodNumber>;
+            frequency: z.ZodOptional<z.ZodNumber>;
+            evidence: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodString]>>;
+            steps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+        patterns: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            category: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            confidence: z.ZodOptional<z.ZodNumber>;
+            frequency: z.ZodOptional<z.ZodNumber>;
+            evidence: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodString]>>;
+            steps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+        workflows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            category: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            confidence: z.ZodOptional<z.ZodNumber>;
+            frequency: z.ZodOptional<z.ZodNumber>;
+            evidence: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodString]>>;
+            steps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    new: z.ZodOptional<z.ZodObject<{
+        preferences: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            category: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            confidence: z.ZodOptional<z.ZodNumber>;
+            frequency: z.ZodOptional<z.ZodNumber>;
+            evidence: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodString]>>;
+            steps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+        patterns: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            category: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            confidence: z.ZodOptional<z.ZodNumber>;
+            frequency: z.ZodOptional<z.ZodNumber>;
+            evidence: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodString]>>;
+            steps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+        workflows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            category: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            confidence: z.ZodOptional<z.ZodNumber>;
+            frequency: z.ZodOptional<z.ZodNumber>;
+            evidence: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodString]>>;
+            steps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    changes: z.ZodObject<{
+        merged: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            ids: z.ZodArray<z.ZodString>;
+            result: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        removed: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            reason: z.ZodString;
+        }, z.core.$strip>>>;
+        kept: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const AICleanupRequestSchema: z.ZodObject<{
+    userId: z.ZodOptional<z.ZodString>;
+    includeIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    profileVersion: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const ApplyCleanupRequestSchema: z.ZodObject<{
+    userId: z.ZodOptional<z.ZodString>;
+    profile: z.ZodOptional<z.ZodObject<{
+        preferences: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            category: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            confidence: z.ZodOptional<z.ZodNumber>;
+            frequency: z.ZodOptional<z.ZodNumber>;
+            evidence: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodString]>>;
+            steps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+        patterns: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            category: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            confidence: z.ZodOptional<z.ZodNumber>;
+            frequency: z.ZodOptional<z.ZodNumber>;
+            evidence: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodString]>>;
+            steps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+        workflows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            category: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            confidence: z.ZodOptional<z.ZodNumber>;
+            frequency: z.ZodOptional<z.ZodNumber>;
+            evidence: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodString]>>;
+            steps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    acceptedMerged: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodString>>>;
+    acceptedRemoved: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const UpdateProfileItemRequestSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        preferences: "preferences";
+        patterns: "patterns";
+        workflows: "workflows";
+    }>;
+    index: z.ZodNumber;
+    action: z.ZodEnum<{
+        delete: "delete";
+        edit: "edit";
+    }>;
+    category: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    steps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const AddMemoryRequestSchema: z.ZodObject<{
+    content: z.ZodString;
+    containerTag: z.ZodString;
+    type: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    displayName: z.ZodOptional<z.ZodString>;
+    userName: z.ZodOptional<z.ZodString>;
+    userEmail: z.ZodOptional<z.ZodString>;
+    projectPath: z.ZodOptional<z.ZodString>;
+    projectName: z.ZodOptional<z.ZodString>;
+    gitRepoUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const UpdateMemoryRequestSchema: z.ZodObject<{
+    content: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const BulkIdsRequestSchema: z.ZodObject<{
+    ids: z.ZodArray<z.ZodString>;
+    cascade: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;

package/dist/shared/api/schemas.js

@@ -0,0 +1,134 @@
+import { z } from "zod";
+/** Envelope used by all JSON API responses. */
+export const ApiResultSchema = z.object({
+    success: z.boolean(),
+    data: z.unknown().optional(),
+    error: z.string().optional(),
+    message: z.string().optional(),
+});
+export const TagInfoSchema = z.object({
+    tag: z.string(),
+    tags: z.array(z.string()).optional(),
+    displayName: z.string().optional(),
+    userName: z.string().optional(),
+    userEmail: z.string().optional(),
+    projectPath: z.string().optional(),
+    projectName: z.string().optional(),
+    gitRepoUrl: z.string().optional(),
+});
+export const MemoryItemSchema = z.object({
+    id: z.string(),
+    type: z.enum(["memory", "prompt"]),
+    content: z.string(),
+    createdAt: z.string(),
+    updatedAt: z.string().optional(),
+    displayName: z.string().optional(),
+    projectPath: z.string().optional(),
+    projectName: z.string().optional(),
+    gitRepoUrl: z.string().optional(),
+    userName: z.string().optional(),
+    userEmail: z.string().optional(),
+    memoryType: z.string().optional(),
+    tags: z.array(z.string()).optional(),
+    isPinned: z.boolean().optional(),
+    linkedPromptId: z.string().optional(),
+    linkedMemoryId: z.string().optional(),
+    sessionId: z.string().optional(),
+    similarity: z.number().optional(),
+    isContext: z.boolean().optional(),
+    metadata: z.record(z.string(), z.unknown()).optional(),
+});
+export const PaginatedMemoriesSchema = z.object({
+    items: z.array(MemoryItemSchema),
+    total: z.number(),
+    page: z.number(),
+    pageSize: z.number(),
+    totalPages: z.number(),
+});
+export const ProfileItemSchema = z.object({
+    category: z.string().optional(),
+    description: z.string().optional(),
+    confidence: z.number().optional(),
+    frequency: z.number().optional(),
+    evidence: z.union([z.array(z.string()), z.string()]).optional(),
+    steps: z.array(z.string()).optional(),
+});
+export const ProfileDataSchema = z.object({
+    preferences: z.array(ProfileItemSchema).optional(),
+    patterns: z.array(ProfileItemSchema).optional(),
+    workflows: z.array(ProfileItemSchema).optional(),
+});
+export const UserProfileSchema = z.object({
+    exists: z.boolean(),
+    message: z.string().optional(),
+    id: z.string().optional(),
+    userId: z.string().optional(),
+    displayName: z.string().optional(),
+    userName: z.string().optional(),
+    userEmail: z.string().optional(),
+    version: z.number().optional(),
+    totalPromptsAnalyzed: z.number().optional(),
+    lastAnalyzedAt: z.string().optional(),
+    createdAt: z.string().optional(),
+    profileData: ProfileDataSchema.optional(),
+});
+export const CleanupChangesSchema = z.object({
+    merged: z
+        .array(z.object({
+        ids: z.array(z.string()),
+        result: z.string().optional(),
+    }))
+        .optional(),
+    removed: z
+        .array(z.object({
+        id: z.string(),
+        reason: z.string(),
+    }))
+        .optional(),
+    kept: z.array(z.string()).optional(),
+});
+export const PendingCleanupSchema = z.object({
+    old: ProfileDataSchema.optional(),
+    new: ProfileDataSchema.optional(),
+    changes: CleanupChangesSchema,
+});
+export const AICleanupRequestSchema = z.object({
+    userId: z.string().optional(),
+    includeIds: z.array(z.string()).optional(),
+    profileVersion: z.number().int().nonnegative().optional(),
+});
+export const ApplyCleanupRequestSchema = z.object({
+    userId: z.string().optional(),
+    profile: ProfileDataSchema.optional(),
+    acceptedMerged: z.array(z.array(z.string())).optional(),
+    acceptedRemoved: z.array(z.string()).optional(),
+});
+export const UpdateProfileItemRequestSchema = z.object({
+    type: z.enum(["preferences", "patterns", "workflows"]),
+    index: z.number().int().nonnegative(),
+    action: z.enum(["edit", "delete"]),
+    category: z.string().optional(),
+    description: z.string().optional(),
+    steps: z.array(z.string()).optional(),
+});
+export const AddMemoryRequestSchema = z.object({
+    content: z.string().min(1),
+    containerTag: z.string().min(1),
+    type: z.string().optional(),
+    tags: z.array(z.string()).optional(),
+    displayName: z.string().optional(),
+    userName: z.string().optional(),
+    userEmail: z.string().optional(),
+    projectPath: z.string().optional(),
+    projectName: z.string().optional(),
+    gitRepoUrl: z.string().optional(),
+});
+export const UpdateMemoryRequestSchema = z.object({
+    content: z.string().optional(),
+    type: z.string().optional(),
+    tags: z.array(z.string()).optional(),
+});
+export const BulkIdsRequestSchema = z.object({
+    ids: z.array(z.string()).min(1),
+    cascade: z.boolean().optional(),
+});

package/dist/shared/api/types.d.ts

@@ -0,0 +1,28 @@
+import type { z } from "zod";
+import type { AddMemoryRequestSchema, AICleanupRequestSchema, ApiResultSchema, ApplyCleanupRequestSchema, BulkIdsRequestSchema, CleanupChangesSchema, MemoryItemSchema, PaginatedMemoriesSchema, PendingCleanupSchema, ProfileDataSchema, ProfileItemSchema, TagInfoSchema, UpdateMemoryRequestSchema, UpdateProfileItemRequestSchema, UserProfileSchema } from "./schemas.js";
+export type ApiResult<T = unknown> = Omit<z.infer<typeof ApiResultSchema>, "data"> & {
+    data?: T;
+};
+export type TagInfo = z.infer<typeof TagInfoSchema>;
+export type MemoryItem = z.infer<typeof MemoryItemSchema>;
+export type PaginatedMemories = z.infer<typeof PaginatedMemoriesSchema>;
+export type MemoryGroup = {
+    isPair: true;
+    memory: MemoryItem;
+    prompt: MemoryItem;
+} | {
+    isPair: false;
+    type: "memory" | "prompt";
+    item: MemoryItem;
+};
+export type ProfileItem = z.infer<typeof ProfileItemSchema>;
+export type ProfileData = z.infer<typeof ProfileDataSchema>;
+export type UserProfile = z.infer<typeof UserProfileSchema>;
+export type CleanupChanges = z.infer<typeof CleanupChangesSchema>;
+export type PendingCleanup = z.infer<typeof PendingCleanupSchema>;
+export type AICleanupRequest = z.infer<typeof AICleanupRequestSchema>;
+export type ApplyCleanupRequest = z.infer<typeof ApplyCleanupRequestSchema>;
+export type UpdateProfileItemRequest = z.infer<typeof UpdateProfileItemRequestSchema>;
+export type AddMemoryRequest = z.infer<typeof AddMemoryRequestSchema>;
+export type UpdateMemoryRequest = z.infer<typeof UpdateMemoryRequestSchema>;
+export type BulkIdsRequest = z.infer<typeof BulkIdsRequestSchema>;

package/dist/shared/api/types.js

@@ -0,0 +1 @@
+export {};

package/dist/types/index.d.ts

@@ -0,0 +1,27 @@
+export type MemoryType = string;
+export type MemoryHost = "opencode" | "pi";
+export type MemorySourceType = "live-capture" | "history-import";
+export interface MemoryMetadata {
+    type?: MemoryType;
+    source?: "manual" | "auto-capture" | "import" | "api";
+    tool?: string;
+    sessionID?: string;
+    host?: MemoryHost;
+    hostSessionId?: string;
+    sourceType?: MemorySourceType;
+    sourceEntryIds?: string[];
+    sourceTimestamp?: number;
+    sourceFile?: string;
+    importId?: string;
+    reasoning?: string;
+    captureTimestamp?: number;
+    promptId?: string;
+    displayName?: string;
+    userName?: string;
+    userEmail?: string;
+    projectPath?: string;
+    projectName?: string;
+    gitRepoUrl?: string;
+    [key: string]: unknown;
+}
+export type AIProviderType = "openai-chat" | "openai-responses" | "anthropic" | "minimax" | "google-gemini" | "orcarouter";

package/dist/types/index.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/context-limit.d.ts

@@ -0,0 +1,10 @@
+/** UTF-8 byte length of a string. */
+export declare function utf8ByteLength(text: string): number;
+/** Decode a UTF-8 byte slice without splitting multi-byte characters. */
+export declare function sliceUtf8Bytes(text: string, start: number, end?: number): string;
+/**
+ * Truncate text to at most `maxBytes` UTF-8 bytes.
+ * Prefers keeping the start and end (head + tail) when space allows,
+ * so summaries retain both opening context and closing conclusions.
+ */
+export declare function truncateToMaxBytes(text: string, maxBytes: number, marker?: string): string;

package/dist/utils/context-limit.js

@@ -0,0 +1,43 @@
+const encoder = new TextEncoder();
+const decoder = new TextDecoder();
+/** UTF-8 byte length of a string. */
+export function utf8ByteLength(text) {
+    return encoder.encode(text).byteLength;
+}
+/** Decode a UTF-8 byte slice without splitting multi-byte characters. */
+export function sliceUtf8Bytes(text, start, end) {
+    const bytes = encoder.encode(text);
+    let from = Math.max(0, Math.min(start, bytes.length));
+    let to = Math.min(bytes.length, end ?? bytes.length);
+    if (to <= from)
+        return "";
+    // If `from` lands inside a multi-byte character, advance to the next lead byte.
+    while (from < to && (bytes[from] & 0xc0) === 0x80) {
+        from++;
+    }
+    // If `to` lands inside a multi-byte character, back up to that character's start.
+    while (to > from && (bytes[to] & 0xc0) === 0x80) {
+        to--;
+    }
+    return decoder.decode(bytes.subarray(from, to));
+}
+/**
+ * Truncate text to at most `maxBytes` UTF-8 bytes.
+ * Prefers keeping the start and end (head + tail) when space allows,
+ * so summaries retain both opening context and closing conclusions.
+ */
+export function truncateToMaxBytes(text, maxBytes, marker = "\n[... truncated ...]\n") {
+    if (maxBytes <= 0)
+        return "";
+    if (utf8ByteLength(text) <= maxBytes)
+        return text;
+    const markerBytes = utf8ByteLength(marker);
+    if (maxBytes <= markerBytes) {
+        return sliceUtf8Bytes(text, 0, maxBytes);
+    }
+    const available = maxBytes - markerBytes;
+    const headBytes = Math.floor(available / 2);
+    const tailBytes = available - headBytes;
+    const totalBytes = utf8ByteLength(text);
+    return sliceUtf8Bytes(text, 0, headBytes) + marker + sliceUtf8Bytes(text, totalBytes - tailBytes);
+}

package/dist/utils/math.d.ts

@@ -0,0 +1,7 @@
+export declare function cosineSimilarity(a: Float32Array, b: Float32Array): number;
+/**
+ * Cosine similarity for number[] (JSON-stored centroids), otherwise
+ * identical to the Float32Array version above.
+ */
+export declare function cosineSimilarityNumbers(a: number[], b: number[]): number;
+export declare function l2Normalize(vec: number[]): number[];