@character-foundry/character-foundry 0.1.3 → 0.1.5

package/dist/voxta.d.cts

@@ -0,0 +1,1349 @@
+import { z } from 'zod';
+
+/**
+ * Binary Data Utilities
+ *
+ * Universal binary data operations using Uint8Array.
+ * Works in both Node.js and browser environments.
+ */
+/**
+ * Universal binary data type (works in both environments)
+ */
+export type BinaryData = Uint8Array;
+declare const CCv3CharacterBookSchema: z.ZodObject<{
+	name: z.ZodOptional<z.ZodString>;
+	description: z.ZodOptional<z.ZodString>;
+	scan_depth: z.ZodOptional<z.ZodNumber>;
+	token_budget: z.ZodOptional<z.ZodNumber>;
+	recursive_scanning: z.ZodOptional<z.ZodBoolean>;
+	extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+	entries: z.ZodArray<z.ZodObject<{
+		keys: z.ZodArray<z.ZodString, "many">;
+		content: z.ZodString;
+		enabled: z.ZodBoolean;
+		insertion_order: z.ZodNumber;
+		case_sensitive: z.ZodOptional<z.ZodBoolean>;
+		name: z.ZodOptional<z.ZodString>;
+		priority: z.ZodOptional<z.ZodNumber>;
+		id: z.ZodOptional<z.ZodNumber>;
+		comment: z.ZodOptional<z.ZodString>;
+		selective: z.ZodOptional<z.ZodBoolean>;
+		secondary_keys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+		constant: z.ZodOptional<z.ZodBoolean>;
+		position: z.ZodOptional<z.ZodEnum<[
+			"before_char",
+			"after_char"
+		]>>;
+		extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+		automation_id: z.ZodOptional<z.ZodString>;
+		role: z.ZodOptional<z.ZodEnum<[
+			"system",
+			"user",
+			"assistant"
+		]>>;
+		group: z.ZodOptional<z.ZodString>;
+		scan_frequency: z.ZodOptional<z.ZodNumber>;
+		probability: z.ZodOptional<z.ZodNumber>;
+		use_regex: z.ZodOptional<z.ZodBoolean>;
+		depth: z.ZodOptional<z.ZodNumber>;
+		selective_logic: z.ZodOptional<z.ZodEnum<[
+			"AND",
+			"NOT"
+		]>>;
+	}, "strip", z.ZodTypeAny, {
+		keys: string[];
+		content: string;
+		enabled: boolean;
+		insertion_order: number;
+		name?: string | undefined;
+		extensions?: Record<string, unknown> | undefined;
+		case_sensitive?: boolean | undefined;
+		priority?: number | undefined;
+		id?: number | undefined;
+		comment?: string | undefined;
+		selective?: boolean | undefined;
+		secondary_keys?: string[] | undefined;
+		constant?: boolean | undefined;
+		position?: "before_char" | "after_char" | undefined;
+		automation_id?: string | undefined;
+		role?: "system" | "user" | "assistant" | undefined;
+		group?: string | undefined;
+		scan_frequency?: number | undefined;
+		probability?: number | undefined;
+		use_regex?: boolean | undefined;
+		depth?: number | undefined;
+		selective_logic?: "AND" | "NOT" | undefined;
+	}, {
+		keys: string[];
+		content: string;
+		enabled: boolean;
+		insertion_order: number;
+		name?: string | undefined;
+		extensions?: Record<string, unknown> | undefined;
+		case_sensitive?: boolean | undefined;
+		priority?: number | undefined;
+		id?: number | undefined;
+		comment?: string | undefined;
+		selective?: boolean | undefined;
+		secondary_keys?: string[] | undefined;
+		constant?: boolean | undefined;
+		position?: "before_char" | "after_char" | undefined;
+		automation_id?: string | undefined;
+		role?: "system" | "user" | "assistant" | undefined;
+		group?: string | undefined;
+		scan_frequency?: number | undefined;
+		probability?: number | undefined;
+		use_regex?: boolean | undefined;
+		depth?: number | undefined;
+		selective_logic?: "AND" | "NOT" | undefined;
+	}>, "many">;
+}, "strip", z.ZodTypeAny, {
+	entries: {
+		keys: string[];
+		content: string;
+		enabled: boolean;
+		insertion_order: number;
+		name?: string | undefined;
+		extensions?: Record<string, unknown> | undefined;
+		case_sensitive?: boolean | undefined;
+		priority?: number | undefined;
+		id?: number | undefined;
+		comment?: string | undefined;
+		selective?: boolean | undefined;
+		secondary_keys?: string[] | undefined;
+		constant?: boolean | undefined;
+		position?: "before_char" | "after_char" | undefined;
+		automation_id?: string | undefined;
+		role?: "system" | "user" | "assistant" | undefined;
+		group?: string | undefined;
+		scan_frequency?: number | undefined;
+		probability?: number | undefined;
+		use_regex?: boolean | undefined;
+		depth?: number | undefined;
+		selective_logic?: "AND" | "NOT" | undefined;
+	}[];
+	name?: string | undefined;
+	description?: string | undefined;
+	scan_depth?: number | undefined;
+	token_budget?: number | undefined;
+	recursive_scanning?: boolean | undefined;
+	extensions?: Record<string, unknown> | undefined;
+}, {
+	entries: {
+		keys: string[];
+		content: string;
+		enabled: boolean;
+		insertion_order: number;
+		name?: string | undefined;
+		extensions?: Record<string, unknown> | undefined;
+		case_sensitive?: boolean | undefined;
+		priority?: number | undefined;
+		id?: number | undefined;
+		comment?: string | undefined;
+		selective?: boolean | undefined;
+		secondary_keys?: string[] | undefined;
+		constant?: boolean | undefined;
+		position?: "before_char" | "after_char" | undefined;
+		automation_id?: string | undefined;
+		role?: "system" | "user" | "assistant" | undefined;
+		group?: string | undefined;
+		scan_frequency?: number | undefined;
+		probability?: number | undefined;
+		use_regex?: boolean | undefined;
+		depth?: number | undefined;
+		selective_logic?: "AND" | "NOT" | undefined;
+	}[];
+	name?: string | undefined;
+	description?: string | undefined;
+	scan_depth?: number | undefined;
+	token_budget?: number | undefined;
+	recursive_scanning?: boolean | undefined;
+	extensions?: Record<string, unknown> | undefined;
+}>;
+declare const CCv3DataSchema: z.ZodObject<{
+	spec: z.ZodLiteral<"chara_card_v3">;
+	spec_version: z.ZodLiteral<"3.0">;
+	data: z.ZodObject<{
+		name: z.ZodDefault<z.ZodString>;
+		description: z.ZodDefault<z.ZodString>;
+		personality: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+		scenario: z.ZodDefault<z.ZodString>;
+		first_mes: z.ZodDefault<z.ZodString>;
+		mes_example: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+		creator: z.ZodDefault<z.ZodString>;
+		character_version: z.ZodDefault<z.ZodString>;
+		tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+		group_only_greetings: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+		creator_notes: z.ZodOptional<z.ZodString>;
+		system_prompt: z.ZodOptional<z.ZodString>;
+		post_history_instructions: z.ZodOptional<z.ZodString>;
+		alternate_greetings: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+		character_book: z.ZodNullable<z.ZodOptional<z.ZodObject<{
+			name: z.ZodOptional<z.ZodString>;
+			description: z.ZodOptional<z.ZodString>;
+			scan_depth: z.ZodOptional<z.ZodNumber>;
+			token_budget: z.ZodOptional<z.ZodNumber>;
+			recursive_scanning: z.ZodOptional<z.ZodBoolean>;
+			extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+			entries: z.ZodArray<z.ZodObject<{
+				keys: z.ZodArray<z.ZodString, "many">;
+				content: z.ZodString;
+				enabled: z.ZodBoolean;
+				insertion_order: z.ZodNumber;
+				case_sensitive: z.ZodOptional<z.ZodBoolean>;
+				name: z.ZodOptional<z.ZodString>;
+				priority: z.ZodOptional<z.ZodNumber>;
+				id: z.ZodOptional<z.ZodNumber>;
+				comment: z.ZodOptional<z.ZodString>;
+				selective: z.ZodOptional<z.ZodBoolean>;
+				secondary_keys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+				constant: z.ZodOptional<z.ZodBoolean>;
+				position: z.ZodOptional<z.ZodEnum<[
+					"before_char",
+					"after_char"
+				]>>;
+				extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+				automation_id: z.ZodOptional<z.ZodString>;
+				role: z.ZodOptional<z.ZodEnum<[
+					"system",
+					"user",
+					"assistant"
+				]>>;
+				group: z.ZodOptional<z.ZodString>;
+				scan_frequency: z.ZodOptional<z.ZodNumber>;
+				probability: z.ZodOptional<z.ZodNumber>;
+				use_regex: z.ZodOptional<z.ZodBoolean>;
+				depth: z.ZodOptional<z.ZodNumber>;
+				selective_logic: z.ZodOptional<z.ZodEnum<[
+					"AND",
+					"NOT"
+				]>>;
+			}, "strip", z.ZodTypeAny, {
+				keys: string[];
+				content: string;
+				enabled: boolean;
+				insertion_order: number;
+				name?: string | undefined;
+				extensions?: Record<string, unknown> | undefined;
+				case_sensitive?: boolean | undefined;
+				priority?: number | undefined;
+				id?: number | undefined;
+				comment?: string | undefined;
+				selective?: boolean | undefined;
+				secondary_keys?: string[] | undefined;
+				constant?: boolean | undefined;
+				position?: "before_char" | "after_char" | undefined;
+				automation_id?: string | undefined;
+				role?: "system" | "user" | "assistant" | undefined;
+				group?: string | undefined;
+				scan_frequency?: number | undefined;
+				probability?: number | undefined;
+				use_regex?: boolean | undefined;
+				depth?: number | undefined;
+				selective_logic?: "AND" | "NOT" | undefined;
+			}, {
+				keys: string[];
+				content: string;
+				enabled: boolean;
+				insertion_order: number;
+				name?: string | undefined;
+				extensions?: Record<string, unknown> | undefined;
+				case_sensitive?: boolean | undefined;
+				priority?: number | undefined;
+				id?: number | undefined;
+				comment?: string | undefined;
+				selective?: boolean | undefined;
+				secondary_keys?: string[] | undefined;
+				constant?: boolean | undefined;
+				position?: "before_char" | "after_char" | undefined;
+				automation_id?: string | undefined;
+				role?: "system" | "user" | "assistant" | undefined;
+				group?: string | undefined;
+				scan_frequency?: number | undefined;
+				probability?: number | undefined;
+				use_regex?: boolean | undefined;
+				depth?: number | undefined;
+				selective_logic?: "AND" | "NOT" | undefined;
+			}>, "many">;
+		}, "strip", z.ZodTypeAny, {
+			entries: {
+				keys: string[];
+				content: string;
+				enabled: boolean;
+				insertion_order: number;
+				name?: string | undefined;
+				extensions?: Record<string, unknown> | undefined;
+				case_sensitive?: boolean | undefined;
+				priority?: number | undefined;
+				id?: number | undefined;
+				comment?: string | undefined;
+				selective?: boolean | undefined;
+				secondary_keys?: string[] | undefined;
+				constant?: boolean | undefined;
+				position?: "before_char" | "after_char" | undefined;
+				automation_id?: string | undefined;
+				role?: "system" | "user" | "assistant" | undefined;
+				group?: string | undefined;
+				scan_frequency?: number | undefined;
+				probability?: number | undefined;
+				use_regex?: boolean | undefined;
+				depth?: number | undefined;
+				selective_logic?: "AND" | "NOT" | undefined;
+			}[];
+			name?: string | undefined;
+			description?: string | undefined;
+			scan_depth?: number | undefined;
+			token_budget?: number | undefined;
+			recursive_scanning?: boolean | undefined;
+			extensions?: Record<string, unknown> | undefined;
+		}, {
+			entries: {
+				keys: string[];
+				content: string;
+				enabled: boolean;
+				insertion_order: number;
+				name?: string | undefined;
+				extensions?: Record<string, unknown> | undefined;
+				case_sensitive?: boolean | undefined;
+				priority?: number | undefined;
+				id?: number | undefined;
+				comment?: string | undefined;
+				selective?: boolean | undefined;
+				secondary_keys?: string[] | undefined;
+				constant?: boolean | undefined;
+				position?: "before_char" | "after_char" | undefined;
+				automation_id?: string | undefined;
+				role?: "system" | "user" | "assistant" | undefined;
+				group?: string | undefined;
+				scan_frequency?: number | undefined;
+				probability?: number | undefined;
+				use_regex?: boolean | undefined;
+				depth?: number | undefined;
+				selective_logic?: "AND" | "NOT" | undefined;
+			}[];
+			name?: string | undefined;
+			description?: string | undefined;
+			scan_depth?: number | undefined;
+			token_budget?: number | undefined;
+			recursive_scanning?: boolean | undefined;
+			extensions?: Record<string, unknown> | undefined;
+		}>>>;
+		extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+		assets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+			type: z.ZodEnum<[
+				"icon",
+				"background",
+				"emotion",
+				"user_icon",
+				"sound",
+				"video",
+				"custom",
+				"x-risu-asset"
+			]>;
+			uri: z.ZodString;
+			name: z.ZodString;
+			ext: z.ZodString;
+		}, "strip", z.ZodTypeAny, {
+			name: string;
+			type: "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset";
+			uri: string;
+			ext: string;
+		}, {
+			name: string;
+			type: "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset";
+			uri: string;
+			ext: string;
+		}>, "many">>;
+		nickname: z.ZodOptional<z.ZodString>;
+		creator_notes_multilingual: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+		source: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+		creation_date: z.ZodOptional<z.ZodNumber>;
+		modification_date: z.ZodOptional<z.ZodNumber>;
+	}, "strip", z.ZodTypeAny, {
+		name: string;
+		description: string;
+		personality: string | null;
+		scenario: string;
+		first_mes: string;
+		mes_example: string | null;
+		tags: string[];
+		creator: string;
+		character_version: string;
+		group_only_greetings: string[];
+		extensions?: Record<string, unknown> | undefined;
+		creator_notes?: string | undefined;
+		system_prompt?: string | undefined;
+		post_history_instructions?: string | undefined;
+		alternate_greetings?: string[] | undefined;
+		character_book?: {
+			entries: {
+				keys: string[];
+				content: string;
+				enabled: boolean;
+				insertion_order: number;
+				name?: string | undefined;
+				extensions?: Record<string, unknown> | undefined;
+				case_sensitive?: boolean | undefined;
+				priority?: number | undefined;
+				id?: number | undefined;
+				comment?: string | undefined;
+				selective?: boolean | undefined;
+				secondary_keys?: string[] | undefined;
+				constant?: boolean | undefined;
+				position?: "before_char" | "after_char" | undefined;
+				automation_id?: string | undefined;
+				role?: "system" | "user" | "assistant" | undefined;
+				group?: string | undefined;
+				scan_frequency?: number | undefined;
+				probability?: number | undefined;
+				use_regex?: boolean | undefined;
+				depth?: number | undefined;
+				selective_logic?: "AND" | "NOT" | undefined;
+			}[];
+			name?: string | undefined;
+			description?: string | undefined;
+			scan_depth?: number | undefined;
+			token_budget?: number | undefined;
+			recursive_scanning?: boolean | undefined;
+			extensions?: Record<string, unknown> | undefined;
+		} | null | undefined;
+		assets?: {
+			name: string;
+			type: "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset";
+			uri: string;
+			ext: string;
+		}[] | undefined;
+		nickname?: string | undefined;
+		creator_notes_multilingual?: Record<string, string> | undefined;
+		source?: string[] | undefined;
+		creation_date?: number | undefined;
+		modification_date?: number | undefined;
+	}, {
+		name?: string | undefined;
+		description?: string | undefined;
+		extensions?: Record<string, unknown> | undefined;
+		personality?: string | null | undefined;
+		scenario?: string | undefined;
+		first_mes?: string | undefined;
+		mes_example?: string | null | undefined;
+		creator_notes?: string | undefined;
+		system_prompt?: string | undefined;
+		post_history_instructions?: string | undefined;
+		alternate_greetings?: string[] | undefined;
+		character_book?: {
+			entries: {
+				keys: string[];
+				content: string;
+				enabled: boolean;
+				insertion_order: number;
+				name?: string | undefined;
+				extensions?: Record<string, unknown> | undefined;
+				case_sensitive?: boolean | undefined;
+				priority?: number | undefined;
+				id?: number | undefined;
+				comment?: string | undefined;
+				selective?: boolean | undefined;
+				secondary_keys?: string[] | undefined;
+				constant?: boolean | undefined;
+				position?: "before_char" | "after_char" | undefined;
+				automation_id?: string | undefined;
+				role?: "system" | "user" | "assistant" | undefined;
+				group?: string | undefined;
+				scan_frequency?: number | undefined;
+				probability?: number | undefined;
+				use_regex?: boolean | undefined;
+				depth?: number | undefined;
+				selective_logic?: "AND" | "NOT" | undefined;
+			}[];
+			name?: string | undefined;
+			description?: string | undefined;
+			scan_depth?: number | undefined;
+			token_budget?: number | undefined;
+			recursive_scanning?: boolean | undefined;
+			extensions?: Record<string, unknown> | undefined;
+		} | null | undefined;
+		tags?: string[] | undefined;
+		creator?: string | undefined;
+		character_version?: string | undefined;
+		group_only_greetings?: string[] | undefined;
+		assets?: {
+			name: string;
+			type: "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset";
+			uri: string;
+			ext: string;
+		}[] | undefined;
+		nickname?: string | undefined;
+		creator_notes_multilingual?: Record<string, string> | undefined;
+		source?: string[] | undefined;
+		creation_date?: number | undefined;
+		modification_date?: number | undefined;
+	}>;
+}, "strip", z.ZodTypeAny, {
+	data: {
+		name: string;
+		description: string;
+		personality: string | null;
+		scenario: string;
+		first_mes: string;
+		mes_example: string | null;
+		tags: string[];
+		creator: string;
+		character_version: string;
+		group_only_greetings: string[];
+		extensions?: Record<string, unknown> | undefined;
+		creator_notes?: string | undefined;
+		system_prompt?: string | undefined;
+		post_history_instructions?: string | undefined;
+		alternate_greetings?: string[] | undefined;
+		character_book?: {
+			entries: {
+				keys: string[];
+				content: string;
+				enabled: boolean;
+				insertion_order: number;
+				name?: string | undefined;
+				extensions?: Record<string, unknown> | undefined;
+				case_sensitive?: boolean | undefined;
+				priority?: number | undefined;
+				id?: number | undefined;
+				comment?: string | undefined;
+				selective?: boolean | undefined;
+				secondary_keys?: string[] | undefined;
+				constant?: boolean | undefined;
+				position?: "before_char" | "after_char" | undefined;
+				automation_id?: string | undefined;
+				role?: "system" | "user" | "assistant" | undefined;
+				group?: string | undefined;
+				scan_frequency?: number | undefined;
+				probability?: number | undefined;
+				use_regex?: boolean | undefined;
+				depth?: number | undefined;
+				selective_logic?: "AND" | "NOT" | undefined;
+			}[];
+			name?: string | undefined;
+			description?: string | undefined;
+			scan_depth?: number | undefined;
+			token_budget?: number | undefined;
+			recursive_scanning?: boolean | undefined;
+			extensions?: Record<string, unknown> | undefined;
+		} | null | undefined;
+		assets?: {
+			name: string;
+			type: "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset";
+			uri: string;
+			ext: string;
+		}[] | undefined;
+		nickname?: string | undefined;
+		creator_notes_multilingual?: Record<string, string> | undefined;
+		source?: string[] | undefined;
+		creation_date?: number | undefined;
+		modification_date?: number | undefined;
+	};
+	spec: "chara_card_v3";
+	spec_version: "3.0";
+}, {
+	data: {
+		name?: string | undefined;
+		description?: string | undefined;
+		extensions?: Record<string, unknown> | undefined;
+		personality?: string | null | undefined;
+		scenario?: string | undefined;
+		first_mes?: string | undefined;
+		mes_example?: string | null | undefined;
+		creator_notes?: string | undefined;
+		system_prompt?: string | undefined;
+		post_history_instructions?: string | undefined;
+		alternate_greetings?: string[] | undefined;
+		character_book?: {
+			entries: {
+				keys: string[];
+				content: string;
+				enabled: boolean;
+				insertion_order: number;
+				name?: string | undefined;
+				extensions?: Record<string, unknown> | undefined;
+				case_sensitive?: boolean | undefined;
+				priority?: number | undefined;
+				id?: number | undefined;
+				comment?: string | undefined;
+				selective?: boolean | undefined;
+				secondary_keys?: string[] | undefined;
+				constant?: boolean | undefined;
+				position?: "before_char" | "after_char" | undefined;
+				automation_id?: string | undefined;
+				role?: "system" | "user" | "assistant" | undefined;
+				group?: string | undefined;
+				scan_frequency?: number | undefined;
+				probability?: number | undefined;
+				use_regex?: boolean | undefined;
+				depth?: number | undefined;
+				selective_logic?: "AND" | "NOT" | undefined;
+			}[];
+			name?: string | undefined;
+			description?: string | undefined;
+			scan_depth?: number | undefined;
+			token_budget?: number | undefined;
+			recursive_scanning?: boolean | undefined;
+			extensions?: Record<string, unknown> | undefined;
+		} | null | undefined;
+		tags?: string[] | undefined;
+		creator?: string | undefined;
+		character_version?: string | undefined;
+		group_only_greetings?: string[] | undefined;
+		assets?: {
+			name: string;
+			type: "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset";
+			uri: string;
+			ext: string;
+		}[] | undefined;
+		nickname?: string | undefined;
+		creator_notes_multilingual?: Record<string, string> | undefined;
+		source?: string[] | undefined;
+		creation_date?: number | undefined;
+		modification_date?: number | undefined;
+	};
+	spec: "chara_card_v3";
+	spec_version: "3.0";
+}>;
+/**
+ * Character book (lorebook) for v3 cards
+ */
+export type CCv3CharacterBook = z.infer<typeof CCv3CharacterBookSchema>;
+/**
+ * Character Card v3 full structure
+ */
+export type CCv3Data = z.infer<typeof CCv3DataSchema>;
+/**
+ * Normalized Card Types
+ *
+ * Unified view of card data regardless of source format.
+ * This is a computed/virtual representation, not stored.
+ */
+/**
+ * Normalized card representation
+ * Provides unified access to card data from any format
+ */
+export interface NormalizedCard {
+	name: string;
+	description: string;
+	personality: string;
+	scenario: string;
+	firstMes: string;
+	mesExample: string;
+	systemPrompt?: string;
+	postHistoryInstructions?: string;
+	alternateGreetings: string[];
+	groupOnlyGreetings: string[];
+	tags: string[];
+	creator?: string;
+	creatorNotes?: string;
+	characterVersion?: string;
+	characterBook?: CCv3CharacterBook;
+	extensions: Record<string, unknown>;
+}
+/**
+ * Voxta Types
+ *
+ * Type definitions for Voxta package format.
+ */
+/**
+ * Valid compression levels
+ */
+export type CompressionLevel = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
+/**
+ * Voxta resource kind enumeration
+ * Used in EntryResource, ThumbnailResource, and Collection references
+ */
+export declare enum VoxtaResourceKind {
+	Character = 1,
+	Book = 2,
+	Scenario = 3
+}
+/**
+ * Voxta resource reference
+ */
+export interface VoxtaResourceRef {
+	Kind: VoxtaResourceKind | number;
+	Id: string;
+}
+/**
+ * Voxta package metadata
+ */
+export interface VoxtaPackage {
+	$type: "package";
+	Id: string;
+	Name: string;
+	Version: string;
+	Description?: string;
+	Creator?: string;
+	ExplicitContent?: boolean;
+	EntryResource?: VoxtaResourceRef;
+	ThumbnailResource?: VoxtaResourceRef;
+	DateCreated?: string;
+	DateModified?: string;
+}
+/**
+ * Voxta TTS configuration
+ */
+export interface VoxtaTtsConfig {
+	Voice: {
+		parameters: {
+			VoiceBackend?: string;
+			VoiceId?: string;
+			Gender?: string;
+			Filename?: string;
+			FinetuneVoice?: string;
+			[key: string]: unknown;
+		};
+		label: string;
+	};
+	Service: {
+		ServiceName: string;
+		ServiceId: string;
+	};
+}
+/**
+ * Voxta script
+ */
+export interface VoxtaScript {
+	Name: string;
+	Content: string;
+}
+/**
+ * Voxta character
+ */
+export interface VoxtaCharacter {
+	$type: "character";
+	Id: string;
+	Name: string;
+	Label?: string;
+	Version?: string;
+	PackageId?: string;
+	Description?: string;
+	Personality?: string;
+	Profile?: string;
+	Scenario?: string;
+	FirstMessage?: string;
+	AlternativeFirstMessages?: string[];
+	MessageExamples?: string;
+	SystemPrompt?: string;
+	PostHistoryInstructions?: string;
+	Context?: string;
+	Instructions?: string;
+	UserNameOverride?: string;
+	UserDescriptionOverride?: string;
+	Creator?: string;
+	CreatorNotes?: string;
+	Tags?: string[];
+	ExplicitContent?: boolean;
+	Culture?: string;
+	ImportedFrom?: string;
+	MemoryBooks?: string[];
+	DefaultScenarios?: string[];
+	TextToSpeech?: VoxtaTtsConfig[];
+	ChatStyle?: number;
+	EnableThinkingSpeech?: boolean;
+	NotifyUserAwayReturn?: boolean;
+	TimeAware?: boolean;
+	UseMemory?: boolean;
+	MaxTokens?: number;
+	MaxSentences?: number;
+	SystemPromptOverrideType?: number;
+	ClimaxSensitivity?: number;
+	PleasureDecay?: number;
+	Scripts?: VoxtaScript[];
+	Augmentations?: unknown[];
+	Thumbnail?: {
+		RandomizedETag?: string;
+		ContentType?: string;
+	};
+	DateCreated?: string;
+	DateModified?: string;
+}
+/**
+ * Voxta book item
+ */
+export interface VoxtaBookItem {
+	Id: string;
+	Keywords: string[];
+	Text: string;
+	Weight?: number;
+	Deleted?: boolean;
+	CreatedAt?: string;
+	LastUpdated?: string;
+	DeletedAt?: string;
+}
+/**
+ * Voxta book (lorebook)
+ */
+export interface VoxtaBook {
+	$type: "book";
+	Id: string;
+	Name: string;
+	Version?: string;
+	PackageId?: string;
+	Description?: string;
+	ExplicitContent?: boolean;
+	Creator?: string;
+	Items: VoxtaBookItem[];
+	DateCreated?: string;
+	DateModified?: string;
+}
+/**
+ * Voxta collection item (reference to a resource)
+ */
+export interface VoxtaCollectionItem {
+	Resource: VoxtaResourceRef;
+}
+/**
+ * Voxta collection folder (organizational grouping)
+ */
+export interface VoxtaCollectionFolder {
+	Name: string;
+	Description?: string;
+	/** Kind of resources in this folder (1=Character, 2=Book, 3=Scenario) */
+	Kind: VoxtaResourceKind | number;
+	Items: VoxtaCollectionItem[];
+	/** Nested folders (if any) */
+	Folders?: VoxtaCollectionFolder[];
+}
+/**
+ * Voxta collection root structure
+ */
+export interface VoxtaCollectionRoot {
+	Folders: VoxtaCollectionFolder[];
+}
+/**
+ * Voxta collection - organizes resources into themed groups
+ */
+export interface VoxtaCollection {
+	$type: "collection";
+	Id: string;
+	Name: string;
+	Version?: string;
+	PackageId?: string;
+	ExplicitContent?: boolean;
+	Root: VoxtaCollectionRoot;
+	Thumbnail?: {
+		RandomizedETag?: string;
+		ContentType?: string;
+	};
+	DateCreated?: string;
+	DateModified?: string;
+}
+/**
+ * Voxta scenario action
+ */
+export interface VoxtaAction {
+	Name: string;
+	Layer?: string;
+	Arguments?: unknown[];
+	FinalLayer?: boolean;
+	Timing?: number;
+	Description?: string;
+	Disabled?: boolean;
+	Once?: boolean;
+	FlagsFilter?: string;
+	EvaluateNextEvent?: boolean;
+	Effect?: {
+		SetFlags?: string[];
+		Script?: string;
+		Event?: string;
+		Story?: string;
+		Secret?: string;
+		Instructions?: string;
+		MaxSentences?: number;
+		MaxTokens?: number;
+		[key: string]: unknown;
+	};
+}
+/**
+ * Voxta scenario event (similar to action but for event triggers)
+ */
+export interface VoxtaEvent {
+	Id?: string;
+	Name: string;
+	Layer?: string;
+	Timing?: number;
+	Description?: string;
+	Arguments?: unknown[];
+	Disabled?: boolean;
+	FinalLayer?: boolean;
+	Once?: boolean;
+	FlagsFilter?: string;
+	EvaluateNextEvent?: boolean;
+	Effect?: {
+		SetFlags?: string[];
+		Script?: string;
+		Event?: string;
+		Story?: string;
+		Secret?: string;
+		Instructions?: string;
+		MaxSentences?: number;
+		MaxTokens?: number;
+		[key: string]: unknown;
+	};
+}
+/**
+ * Voxta scenario context (conditional context blocks)
+ */
+export interface VoxtaContext {
+	Name: string;
+	Text: string;
+	FlagsFilter?: string;
+	Disabled?: boolean;
+}
+/**
+ * Voxta scenario role - maps characters to scenario slots
+ */
+export interface VoxtaRole {
+	Name: string;
+	Description?: string;
+	DefaultCharacterId: string;
+	EnabledOnStart?: boolean;
+}
+/**
+ * Voxta impersonation (user persona override)
+ */
+export interface VoxtaImpersonation {
+	Name: string;
+	Description?: string;
+}
+/**
+ * Voxta scenario
+ */
+export interface VoxtaScenario {
+	$type: "scenario";
+	Id: string;
+	Name: string;
+	Version?: string;
+	ParentId?: string;
+	PackageId?: string;
+	Client?: string;
+	Creator?: string;
+	Description?: string;
+	Template?: string;
+	Messages?: string;
+	SystemPrompt?: string;
+	SystemPromptOverrideType?: number;
+	Roles?: VoxtaRole[];
+	NarratorCharacterId?: string;
+	Impersonation?: VoxtaImpersonation;
+	SharedScripts?: VoxtaScript[];
+	Actions?: VoxtaAction[];
+	Events?: VoxtaEvent[];
+	Contexts?: VoxtaContext[];
+	ExplicitContent?: boolean;
+	ChatFlow?: number;
+	ChatStyle?: number;
+	MemoryBooks?: string[];
+	Thumbnail?: {
+		ETag?: number;
+		RandomizedETag?: string;
+		ContentType?: string;
+	};
+	DateCreated?: string;
+	DateModified?: string;
+	UserId?: string;
+	AppControlled?: boolean;
+	Locked?: boolean;
+}
+/**
+ * Extracted Voxta asset
+ */
+export interface ExtractedVoxtaAsset {
+	path: string;
+	buffer: BinaryData;
+	characterId?: string;
+}
+/**
+ * Extracted Voxta character with assets
+ */
+export interface ExtractedVoxtaCharacter {
+	id: string;
+	data: VoxtaCharacter;
+	thumbnail?: BinaryData;
+	assets: ExtractedVoxtaAsset[];
+}
+/**
+ * Extracted Voxta scenario
+ */
+export interface ExtractedVoxtaScenario {
+	id: string;
+	data: VoxtaScenario;
+	thumbnail?: BinaryData;
+}
+/**
+ * Extracted Voxta book
+ */
+export interface ExtractedVoxtaBook {
+	id: string;
+	data: VoxtaBook;
+}
+/**
+ * Extracted Voxta collection with assets
+ */
+export interface ExtractedVoxtaCollection {
+	id: string;
+	data: VoxtaCollection;
+	thumbnail?: BinaryData;
+}
+/**
+ * Voxta export type
+ * - 'package': Has package.json with full metadata
+ * - 'scenario': Has Scenarios/ folder but no package.json (scenario export)
+ * - 'character': Only has Characters/ folder (single/multi character export)
+ * - 'collection': Has Collections/ folder (bundled content with organization)
+ */
+export type VoxtaExportType = "package" | "scenario" | "character" | "collection";
+/**
+ * Complete extracted Voxta data
+ */
+export interface VoxtaData {
+	package?: VoxtaPackage;
+	characters: ExtractedVoxtaCharacter[];
+	scenarios: ExtractedVoxtaScenario[];
+	books: ExtractedVoxtaBook[];
+	collections: ExtractedVoxtaCollection[];
+	/**
+	 * Type of export detected:
+	 * - 'package': Has package.json
+	 * - 'scenario': Has Scenarios/ but no package.json
+	 * - 'character': Only Characters/ (no package.json or Scenarios/)
+	 * - 'collection': Has Collections/ folder
+	 */
+	exportType: VoxtaExportType;
+}
+/**
+ * Options for Voxta extraction
+ */
+export interface VoxtaReadOptions {
+	maxFileSize?: number;
+	maxAssetSize?: number;
+	maxTotalSize?: number;
+}
+/**
+ * Asset to include in Voxta export
+ */
+export interface VoxtaWriteAsset {
+	type: string;
+	name: string;
+	ext: string;
+	data: BinaryData;
+	tags?: string[];
+	isMain?: boolean;
+}
+/**
+ * Options for building Voxta package
+ */
+export interface VoxtaWriteOptions {
+	compressionLevel?: CompressionLevel;
+	includePackageJson?: boolean;
+	characterId?: string;
+	packageId?: string;
+	/** Scenario to include - uses scenario.Id as the key */
+	scenario?: VoxtaScenario;
+	/** Scenario thumbnail */
+	scenarioThumbnail?: BinaryData;
+}
+/**
+ * Result of building a Voxta package
+ */
+export interface VoxtaBuildResult {
+	buffer: BinaryData;
+	assetCount: number;
+	totalSize: number;
+	characterId: string;
+	/** Scenario ID if a scenario was included */
+	scenarioId?: string;
+}
+/**
+ * Voxta extension data stored in CCv3 extensions
+ */
+export interface VoxtaExtensionData {
+	id: string;
+	version?: string;
+	packageId?: string;
+	label?: string;
+	textToSpeech?: VoxtaTtsConfig[];
+	appearance?: string;
+	context?: string;
+	instructions?: string;
+	userNameOverride?: string;
+	userDescriptionOverride?: string;
+	culture?: string;
+	importedFrom?: string;
+	chatSettings?: {
+		chatStyle?: number;
+		enableThinkingSpeech?: boolean;
+		notifyUserAwayReturn?: boolean;
+		timeAware?: boolean;
+		useMemory?: boolean;
+		maxTokens?: number;
+		maxSentences?: number;
+		systemPromptOverrideType?: number;
+	};
+	simulationSettings?: {
+		climaxSensitivity?: number;
+		pleasureDecay?: number;
+	};
+	scripts?: VoxtaScript[];
+	augmentations?: unknown[];
+	scenario?: {
+		actions?: VoxtaAction[];
+		sharedScripts?: VoxtaScript[];
+	};
+	original?: Partial<VoxtaCharacter>;
+}
+/**
+ * Loss report for Voxta export
+ */
+export interface VoxtaLossReport {
+	lostFields: string[];
+	lostAssets: string[];
+	warnings: string[];
+	reason: string;
+}
+/**
+ * Voxta Reader
+ *
+ * Extracts and parses .voxpkg files.
+ */
+/**
+ * Check if data is a Voxta package
+ */
+export declare function isVoxta(data: BinaryData): boolean;
+/**
+ * Extract and parse a Voxta package
+ */
+export declare function readVoxta(data: BinaryData, options?: VoxtaReadOptions): VoxtaData;
+/**
+ * Async version of readVoxta
+ */
+export declare function readVoxtaAsync(data: BinaryData, options?: VoxtaReadOptions): Promise<VoxtaData>;
+/**
+ * Voxta Writer
+ *
+ * Creates .voxpkg files from CCv3 card data.
+ */
+/**
+ * Build a Voxta package from CCv3 card data
+ */
+export declare function writeVoxta(card: CCv3Data, assets: VoxtaWriteAsset[], options?: VoxtaWriteOptions): VoxtaBuildResult;
+/**
+ * Async version of writeVoxta
+ */
+export declare function writeVoxtaAsync(card: CCv3Data, assets: VoxtaWriteAsset[], options?: VoxtaWriteOptions): Promise<VoxtaBuildResult>;
+/**
+ * Voxta <-> CCv3 Mapping
+ *
+ * Conversion utilities between Voxta format and CCv3 format.
+ */
+/**
+ * Convert a Voxta character to CCv3 format
+ */
+export declare function voxtaToCCv3(character: VoxtaCharacter, books?: VoxtaBook[]): CCv3Data;
+/**
+ * Convert CCv3 card to Voxta character format
+ */
+export declare function ccv3ToVoxta(card: CCv3Data): VoxtaCharacter;
+/**
+ * Convert CCv3 lorebook to Voxta book format
+ */
+export declare function ccv3LorebookToVoxtaBook(card: CCv3Data): VoxtaBook | null;
+/**
+ * Macro Conversion
+ *
+ * Converts between Voxta-style macros (with spaces) and standard macros.
+ *
+ * Voxta uses: {{ user }}, {{ char }}
+ * Standard uses: {{user}}, {{char}}
+ */
+/**
+ * Convert Voxta-style macros to standard format (no spaces)
+ */
+export declare function voxtaToStandard(text: string): string;
+/**
+ * Convert standard macros to Voxta-style format (with spaces)
+ */
+export declare function standardToVoxta(text: string): string;
+/**
+ * Editable CCv3 fields (subset that can be changed in editors)
+ */
+export type CCv3Edits = Partial<CCv3Data["data"]>;
+/**
+ * Merge partial CCv3 edits into an existing Voxta character.
+ *
+ * This function applies only the fields present in `edits` to the original
+ * character, preserving Voxta-specific fields like Scripts, TTS, and
+ * Augmentations that CCv3 cannot represent.
+ *
+ * @param original - The original extracted Voxta character
+ * @param edits - Partial CCv3 data fields to apply
+ * @returns Updated VoxtaCharacter with edits merged
+ */
+export declare function mergeCharacterEdits(original: ExtractedVoxtaCharacter | VoxtaCharacter, edits: CCv3Edits): VoxtaCharacter;
+/**
+ * Merge partial CCv3 lorebook edits into an existing Voxta book.
+ *
+ * @param original - The original extracted Voxta book
+ * @param edits - CCv3 character_book to merge
+ * @returns Updated VoxtaBook with edits merged
+ */
+export declare function mergeBookEdits(original: ExtractedVoxtaBook | VoxtaBook, edits: CCv3CharacterBook): VoxtaBook;
+/**
+ * Delta changes to apply to a Voxta package
+ */
+export interface VoxtaDeltas {
+	/** Updated characters by ID */
+	characters?: Map<string, VoxtaCharacter>;
+	/** Updated books by ID */
+	books?: Map<string, VoxtaBook>;
+	/** Updated package metadata (optional) */
+	package?: Partial<VoxtaPackage>;
+}
+/**
+ * Options for applying deltas
+ */
+export interface ApplyDeltaOptions {
+	compressionLevel?: CompressionLevel;
+}
+/**
+ * Apply delta changes to an existing Voxta package.
+ *
+ * This performs a minimal update - only files that have changed are rewritten.
+ * All other files (assets, scenarios, unchanged characters/books) are preserved
+ * exactly as they were in the original package.
+ *
+ * @param originalBuffer - The original .voxpkg file buffer
+ * @param deltas - Changes to apply
+ * @param options - Compression options
+ * @returns New package buffer with changes applied
+ */
+export declare function applyVoxtaDeltas(originalBuffer: BinaryData, deltas: VoxtaDeltas, options?: ApplyDeltaOptions): Uint8Array;
+/**
+ * Async version of applyVoxtaDeltas
+ */
+export declare function applyVoxtaDeltasAsync(originalBuffer: BinaryData, deltas: VoxtaDeltas, options?: ApplyDeltaOptions): Promise<Uint8Array>;
+/**
+ * Character info in package manifest
+ */
+export interface ManifestCharacter {
+	id: string;
+	name: string;
+}
+/**
+ * Book info in package manifest
+ */
+export interface ManifestBook {
+	id: string;
+	name: string;
+	/** Character IDs that reference this book */
+	usedBy: string[];
+}
+/**
+ * Scenario info in package manifest
+ */
+export interface ManifestScenario {
+	id: string;
+	name: string;
+}
+/**
+ * Package manifest for UI display
+ */
+export interface PackageManifest {
+	packageId?: string;
+	packageName?: string;
+	characters: ManifestCharacter[];
+	books: ManifestBook[];
+	scenarios: ManifestScenario[];
+}
+/**
+ * Get a manifest summary of a Voxta package for UI display.
+ *
+ * This provides a quick overview of package contents with relationship
+ * information (which characters use which books).
+ *
+ * @param data - Extracted Voxta data from readVoxta()
+ * @returns Package manifest for UI display
+ */
+export declare function getPackageManifest(data: VoxtaData): PackageManifest;
+/**
+ * Options for extracting a character package
+ */
+export interface ExtractCharacterOptions {
+	compressionLevel?: CompressionLevel;
+	/** Include books referenced by the character */
+	includeBooks?: boolean;
+	/** New package name (defaults to character name) */
+	packageName?: string;
+}
+/**
+ * Extract a single character from a multi-character package.
+ *
+ * Creates a new standalone .voxpkg containing just the specified character,
+ * their assets, and optionally their referenced books.
+ *
+ * NOTE: Scenarios are NOT extracted since they may contain scripts that
+ * reference other characters in the package.
+ *
+ * @param originalBuffer - The original .voxpkg file buffer
+ * @param characterId - ID of the character to extract
+ * @param options - Extraction options
+ * @returns New package buffer with just the specified character
+ */
+export declare function extractCharacterPackage(originalBuffer: BinaryData, characterId: string, options?: ExtractCharacterOptions): Uint8Array;
+/**
+ * Options for adding a character to a package
+ */
+export interface AddCharacterOptions {
+	compressionLevel?: CompressionLevel;
+	/** Books to include with the character */
+	books?: VoxtaBook[];
+	/** Assets to include (path relative to character dir -> data) */
+	assets?: Map<string, BinaryData>;
+	/** Thumbnail image */
+	thumbnail?: BinaryData;
+}
+/**
+ * Add a character to an existing Voxta package.
+ *
+ * @param originalBuffer - The original .voxpkg file buffer
+ * @param character - The character to add
+ * @param options - Options including books and assets
+ * @returns New package buffer with the character added
+ */
+export declare function addCharacterToPackage(originalBuffer: BinaryData, character: VoxtaCharacter, options?: AddCharacterOptions): Uint8Array;
+/**
+ * Voxta Loss Reporting
+ *
+ * Documents what data is lost when exporting to Voxta format.
+ */
+/**
+ * Check what would be lost when exporting a card to Voxta format
+ */
+export declare function checkVoxtaLoss(card: NormalizedCard): VoxtaLossReport;
+/**
+ * Check if export would be lossless
+ */
+export declare function isVoxtaExportLossless(card: NormalizedCard): boolean;
+/**
+ * Format loss report as human-readable string
+ */
+export declare function formatVoxtaLossReport(report: VoxtaLossReport): string;
+/**
+ * Voxta Asset Enricher
+ *
+ * Analyzes Voxta asset paths to extract semantic tags and types.
+ * e.g. "Avatars/Default/happy_idle_01.webp" -> tags: [emotion:happy, state:idle, variant:01]
+ */
+export interface EnrichedAssetMetadata {
+	type: "icon" | "sound" | "custom";
+	tags: string[];
+}
+/**
+ * Extract metadata from a Voxta asset path/filename
+ */
+export declare function enrichVoxtaAsset(asset: ExtractedVoxtaAsset): EnrichedAssetMetadata;
+
+export {};