@character-foundry/character-foundry 0.1.3 → 0.1.5

package/dist/schemas.d.ts

@@ -1,2 +1,2178 @@
-export * from '@character-foundry/schemas';
-//# sourceMappingURL=schemas.d.ts.map
+import { z } from 'zod';
+
+/**
+ * Character Card v3 Types
+ *
+ * Based on: https://github.com/kwaroran/character-card-spec-v3
+ */
+/**
+ * Lorebook entry schema for v3 cards
+ */
+export declare const CCv3LorebookEntrySchema: 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;
+}>;
+/**
+ * Character book (lorebook) schema for v3 cards
+ */
+export 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;
+}>;
+/**
+ * Character Card v3 inner data structure schema.
+ *
+ * Note: Fields like group_only_greetings, creator, character_version, and tags
+ * are technically "required" per V3 spec but rarely present in wild cards.
+ * We use .default() to make parsing lenient while still producing valid output.
+ */
+export declare const CCv3DataInnerSchema: 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;
+}>;
+/**
+ * Character Card v3 full structure schema
+ */
+export 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";
+}>;
+/**
+ * Lorebook entry for v3 cards
+ */
+export type CCv3LorebookEntry = z.infer<typeof CCv3LorebookEntrySchema>;
+/**
+ * Character book (lorebook) for v3 cards
+ */
+export type CCv3CharacterBook = z.infer<typeof CCv3CharacterBookSchema>;
+/**
+ * Character Card v3 inner data structure
+ */
+export type CCv3DataInner = z.infer<typeof CCv3DataInnerSchema>;
+/**
+ * Character Card v3 full structure
+ */
+export type CCv3Data = z.infer<typeof CCv3DataSchema>;
+/**
+ * Check if data is a v3 card
+ */
+export declare function isV3Card(data: unknown): data is CCv3Data;
+/**
+ * Parse and validate a v3 card
+ */
+export declare function parseV3Card(data: unknown): CCv3Data;
+/**
+ * Parse and validate v3 card inner data
+ */
+export declare function parseV3DataInner(data: unknown): CCv3DataInner;
+/**
+ * Get v3 card inner data
+ */
+export declare function getV3Data(card: CCv3Data): CCv3DataInner;
+/**
+ * Check if data looks like a V3 card structurally (without strict validation).
+ * More lenient than isV3Card - just checks structure, not full schema validity.
+ */
+export declare function looksLikeV3Card(data: unknown): data is {
+	spec: string;
+	data: Record<string, unknown>;
+};
+/**
+ * Common Types
+ *
+ * Shared types used across all card formats.
+ */
+/**
+ * ISO 8601 date string schema
+ */
+export declare const ISO8601Schema: z.ZodString;
+/**
+ * UUID string schema
+ */
+export declare const UUIDSchema: z.ZodString;
+/**
+ * Card specification version schema
+ */
+export declare const SpecSchema: z.ZodEnum<[
+	"v2",
+	"v3"
+]>;
+/**
+ * Source format identifier schema
+ */
+export declare const SourceFormatSchema: z.ZodEnum<[
+	"png_v2",
+	"png_v3",
+	"json_v2",
+	"json_v3",
+	"charx",
+	"charx_risu",
+	"charx_jpeg",
+	"voxta"
+]>;
+/**
+ * Original JSON shape schema
+ */
+export declare const OriginalShapeSchema: z.ZodEnum<[
+	"wrapped",
+	"unwrapped",
+	"legacy"
+]>;
+/**
+ * Asset type identifier schema
+ */
+export declare const AssetTypeSchema: z.ZodEnum<[
+	"icon",
+	"background",
+	"emotion",
+	"user_icon",
+	"sound",
+	"video",
+	"custom",
+	"x-risu-asset"
+]>;
+/**
+ * Asset descriptor schema (v3 spec)
+ */
+export declare const AssetDescriptorSchema: 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;
+}>;
+/**
+ * Extracted asset with binary data schema
+ */
+export declare const ExtractedAssetSchema: z.ZodObject<{
+	descriptor: 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;
+	}>;
+	data: z.ZodType<Uint8Array<ArrayBuffer>, z.ZodTypeDef, Uint8Array<ArrayBuffer>>;
+	mimeType: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+	descriptor: {
+		name: string;
+		type: "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset";
+		uri: string;
+		ext: string;
+	};
+	data: Uint8Array<ArrayBuffer>;
+	mimeType: string;
+}, {
+	descriptor: {
+		name: string;
+		type: "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset";
+		uri: string;
+		ext: string;
+	};
+	data: Uint8Array<ArrayBuffer>;
+	mimeType: string;
+}>;
+/**
+ * ISO 8601 date string
+ */
+export type ISO8601 = z.infer<typeof ISO8601Schema>;
+/**
+ * UUID string
+ */
+export type UUID = z.infer<typeof UUIDSchema>;
+/**
+ * Card specification version
+ */
+export type Spec = z.infer<typeof SpecSchema>;
+/**
+ * Source format identifier
+ */
+export type SourceFormat = z.infer<typeof SourceFormatSchema>;
+/**
+ * Original JSON shape
+ */
+export type OriginalShape = z.infer<typeof OriginalShapeSchema>;
+/**
+ * Asset type identifier
+ */
+export type AssetType = z.infer<typeof AssetTypeSchema>;
+/**
+ * Asset descriptor (v3 spec)
+ */
+export type AssetDescriptor = z.infer<typeof AssetDescriptorSchema>;
+/**
+ * Extracted asset with binary data
+ */
+export type ExtractedAsset = z.infer<typeof ExtractedAssetSchema>;
+/**
+ * Character Card v2 Types
+ *
+ * Based on: https://github.com/malfoyslastname/character-card-spec-v2
+ */
+/**
+ * Lorebook entry schema for v2 cards
+ */
+export declare const CCv2LorebookEntrySchema: z.ZodObject<{
+	keys: z.ZodArray<z.ZodString, "many">;
+	content: z.ZodString;
+	enabled: z.ZodBoolean;
+	insertion_order: z.ZodNumber;
+	extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+	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"
+	]>>;
+}, "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;
+}, {
+	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;
+}>;
+/**
+ * Character book (lorebook) schema for v2 cards
+ */
+export declare const CCv2CharacterBookSchema: 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;
+		extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+		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"
+		]>>;
+	}, "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;
+	}, {
+		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;
+	}>, "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;
+	}[];
+	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;
+	}[];
+	name?: string | undefined;
+	description?: string | undefined;
+	scan_depth?: number | undefined;
+	token_budget?: number | undefined;
+	recursive_scanning?: boolean | undefined;
+	extensions?: Record<string, unknown> | undefined;
+}>;
+/**
+ * Character Card v2 data structure schema
+ */
+export declare const CCv2DataSchema: 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_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;
+			extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+			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"
+			]>>;
+		}, "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;
+		}, {
+			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;
+		}>, "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;
+		}[];
+		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;
+		}[];
+		name?: string | undefined;
+		description?: string | undefined;
+		scan_depth?: number | undefined;
+		token_budget?: number | undefined;
+		recursive_scanning?: boolean | undefined;
+		extensions?: Record<string, unknown> | undefined;
+	}>>>;
+	tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+	creator: z.ZodOptional<z.ZodString>;
+	character_version: z.ZodOptional<z.ZodString>;
+	extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+	name: string;
+	description: string;
+	personality: string | null;
+	scenario: string;
+	first_mes: string;
+	mes_example: string | null;
+	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;
+		}[];
+		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;
+}, {
+	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;
+		}[];
+		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;
+}>;
+/**
+ * Wrapped v2 card format schema (modern tools)
+ */
+export declare const CCv2WrappedSchema: z.ZodObject<{
+	spec: z.ZodLiteral<"chara_card_v2">;
+	spec_version: z.ZodLiteral<"2.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_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;
+				extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+				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"
+				]>>;
+			}, "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;
+			}, {
+				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;
+			}>, "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;
+			}[];
+			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;
+			}[];
+			name?: string | undefined;
+			description?: string | undefined;
+			scan_depth?: number | undefined;
+			token_budget?: number | undefined;
+			recursive_scanning?: boolean | undefined;
+			extensions?: Record<string, unknown> | undefined;
+		}>>>;
+		tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+		creator: z.ZodOptional<z.ZodString>;
+		character_version: z.ZodOptional<z.ZodString>;
+		extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+	}, "strip", z.ZodTypeAny, {
+		name: string;
+		description: string;
+		personality: string | null;
+		scenario: string;
+		first_mes: string;
+		mes_example: string | null;
+		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;
+			}[];
+			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;
+	}, {
+		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;
+			}[];
+			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;
+	}>;
+}, "strip", z.ZodTypeAny, {
+	data: {
+		name: string;
+		description: string;
+		personality: string | null;
+		scenario: string;
+		first_mes: string;
+		mes_example: string | null;
+		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;
+			}[];
+			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;
+	};
+	spec: "chara_card_v2";
+	spec_version: "2.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;
+			}[];
+			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;
+	};
+	spec: "chara_card_v2";
+	spec_version: "2.0";
+}>;
+/**
+ * Lorebook entry for v2 cards
+ */
+export type CCv2LorebookEntry = z.infer<typeof CCv2LorebookEntrySchema>;
+/**
+ * Character book (lorebook) for v2 cards
+ */
+export type CCv2CharacterBook = z.infer<typeof CCv2CharacterBookSchema>;
+/**
+ * Character Card v2 data structure
+ */
+export type CCv2Data = z.infer<typeof CCv2DataSchema>;
+/**
+ * Wrapped v2 card format (modern tools)
+ */
+export type CCv2Wrapped = z.infer<typeof CCv2WrappedSchema>;
+/**
+ * Check if data is a wrapped v2 card
+ */
+export declare function isWrappedV2(data: unknown): data is CCv2Wrapped;
+/**
+ * Check if data looks like v2 card data (wrapped or unwrapped)
+ */
+export declare function isV2CardData(data: unknown): data is CCv2Data | CCv2Wrapped;
+/**
+ * Parse and validate a wrapped v2 card
+ */
+export declare function parseWrappedV2(data: unknown): CCv2Wrapped;
+/**
+ * Parse and validate v2 card data
+ */
+export declare function parseV2Data(data: unknown): CCv2Data;
+/**
+ * Check if data looks like a wrapped V2 card structurally (without strict validation).
+ * This is more lenient than isWrappedV2 - it just checks structure, not full schema validity.
+ */
+export declare function looksLikeWrappedV2(data: unknown): data is {
+	spec: string;
+	data: Record<string, unknown>;
+};
+/**
+ * Get v2 card data from wrapped or unwrapped format.
+ *
+ * Uses structural check instead of strict Zod validation to handle
+ * malformed cards that have the right structure but missing/invalid fields.
+ * The caller (e.g., ccv2ToCCv3) handles defaulting missing fields.
+ */
+export declare function getV2Data(card: CCv2Data | CCv2Wrapped): CCv2Data;
+/**
+ * RisuAI Extension Types
+ *
+ * These extensions are preserved as opaque blobs.
+ * We do NOT interpret or transform the script contents.
+ */
+/**
+ * Risu emotions mapping (v2 style)
+ * Format: [name, uri][]
+ */
+export type RisuEmotions = [
+	string,
+	string
+][];
+/**
+ * Risu additional assets (v3 style)
+ * Format: [name, uri, type][]
+ */
+export type RisuAdditionalAssets = [
+	string,
+	string,
+	string
+][];
+/**
+ * Risu depth prompt configuration
+ */
+export interface RisuDepthPrompt {
+	depth: number;
+	prompt: string;
+}
+/**
+ * Risu extensions in card.extensions.risuai
+ * Preserved as opaque - we don't interpret script contents
+ */
+export interface RisuExtensions {
+	emotions?: RisuEmotions;
+	additionalAssets?: RisuAdditionalAssets;
+	triggerscript?: unknown;
+	customScripts?: unknown;
+	vits?: Record<string, string>;
+	depth_prompt?: RisuDepthPrompt;
+	[key: string]: unknown;
+}
+/**
+ * CharX x_meta entry (PNG chunk metadata preservation)
+ */
+export interface CharxMetaEntry {
+	type?: string;
+	[key: string]: unknown;
+}
+/**
+ * Check if card has Risu extensions
+ */
+export declare function hasRisuExtensions(extensions?: Record<string, unknown>): boolean;
+/**
+ * Check if card has Risu scripts (triggerscript or customScripts)
+ */
+export declare function hasRisuScripts(extensions?: Record<string, unknown>): boolean;
+/**
+ * Check if card has depth prompt
+ * Checks both SillyTavern style (extensions.depth_prompt) and Risu style (extensions.risuai.depth_prompt)
+ */
+export declare function hasDepthPrompt(extensions?: Record<string, unknown>): boolean;
+/**
+ * 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>;
+}
+/**
+ * Create empty normalized card with defaults
+ */
+export declare function createEmptyNormalizedCard(): NormalizedCard;
+/**
+ * Derived features extracted from card (not stored in card)
+ */
+export interface DerivedFeatures {
+	hasAlternateGreetings: boolean;
+	alternateGreetingsCount: number;
+	hasLorebook: boolean;
+	lorebookEntriesCount: number;
+	hasEmbeddedImages: boolean;
+	embeddedImagesCount: number;
+	hasGallery: boolean;
+	hasRisuExtensions: boolean;
+	hasRisuScripts: boolean;
+	hasDepthPrompt: boolean;
+	hasVoxtaAppearance: boolean;
+	tokens: {
+		description: number;
+		personality: number;
+		scenario: number;
+		firstMes: number;
+		mesExample: number;
+		systemPrompt: number;
+		total: number;
+	};
+}
+/**
+ * Create empty derived features
+ */
+export declare function createEmptyFeatures(): DerivedFeatures;
+/**
+ * Format Detection
+ *
+ * Detect card specification version from JSON data.
+ */
+/**
+ * Result from detailed spec detection
+ */
+export interface SpecDetectionResult {
+	/** Detected spec version */
+	spec: Spec | null;
+	/** Confidence level of detection */
+	confidence: "high" | "medium" | "low";
+	/** What fields/values indicated this spec */
+	indicators: string[];
+	/** Anomalies or inconsistencies detected */
+	warnings: string[];
+}
+/**
+ * Detect card spec version from parsed JSON
+ * Returns 'v2', 'v3', or null if not recognized
+ */
+export declare function detectSpec(data: unknown): Spec | null;
+/**
+ * Detailed spec detection with confidence and reasoning.
+ * Useful for debugging and logging.
+ */
+export declare function detectSpecDetailed(data: unknown): SpecDetectionResult;
+/**
+ * Check if card has a lorebook
+ */
+export declare function hasLorebook(data: unknown): boolean;
+/**
+ * Check if data looks like a valid card structure
+ */
+export declare function looksLikeCard(data: unknown): boolean;
+/**
+ * Card Normalizer
+ *
+ * Handles normalization of malformed card data from various sources.
+ * Fixes common issues like wrong spec values, misplaced fields, missing required fields.
+ */
+/**
+ * CardNormalizer - handles normalization of malformed card data
+ */
+export declare const CardNormalizer: {
+	/**
+	 * Normalize card data to valid schema format.
+	 *
+	 * Handles:
+	 * - Fixing spec/spec_version values
+	 * - Moving misplaced fields to correct locations
+	 * - Adding missing required fields with defaults
+	 * - Handling hybrid formats (fields at root AND in data object)
+	 *
+	 * @param data - Raw card data (potentially malformed)
+	 * @param spec - Target spec version
+	 * @returns Normalized card data (does not mutate input)
+	 */
+	normalize(data: unknown, spec: "v2" | "v3"): CCv2Wrapped | CCv3Data;
+	/**
+	 * Normalize a character book (lorebook).
+	 *
+	 * Handles:
+	 * - Ensuring required fields exist
+	 * - Converting numeric position values to string enums
+	 * - Moving V3-only fields to extensions for V2 compatibility
+	 *
+	 * @param book - Raw character book data
+	 * @param spec - Target spec version
+	 * @returns Normalized character book
+	 */
+	normalizeCharacterBook(book: Record<string, unknown>, spec: "v2" | "v3"): CCv2CharacterBook | CCv3CharacterBook;
+	/**
+	 * Normalize a single lorebook entry.
+	 *
+	 * Handles:
+	 * - Converting numeric position to string enum
+	 * - Moving V3-only fields to extensions for V2
+	 * - Ensuring required fields exist
+	 *
+	 * @param entry - Raw entry data
+	 * @param spec - Target spec version
+	 * @returns Normalized entry
+	 */
+	normalizeEntry(entry: Record<string, unknown>, spec: "v2" | "v3"): CCv2LorebookEntry | CCv3LorebookEntry;
+	/**
+	 * Fix CharacterTavern timestamp format (milliseconds -> seconds).
+	 *
+	 * CCv3 spec requires timestamps in seconds (Unix epoch).
+	 * CharacterTavern exports timestamps in milliseconds.
+	 *
+	 * @param data - V3 card data
+	 * @returns Card data with fixed timestamps (does not mutate input)
+	 */
+	fixTimestamps(data: CCv3Data): CCv3Data;
+	/**
+	 * Internal: fix timestamps in data object
+	 */
+	fixTimestampsInner(data: Record<string, unknown>): Record<string, unknown>;
+	/**
+	 * Auto-detect spec and normalize.
+	 *
+	 * @param data - Raw card data
+	 * @returns Normalized card data, or null if not a valid card
+	 */
+	autoNormalize(data: unknown): CCv2Wrapped | CCv3Data | null;
+};
+/**
+ * Validation Utilities
+ *
+ * Helper functions for Zod validation with Foundry error integration.
+ */
+/**
+ * Convert Zod error to human-readable message
+ */
+export declare function zodErrorToMessage(zodError: z.ZodError, context?: string): string;
+/**
+ * Get the first error field from Zod error
+ */
+export declare function getFirstErrorField(zodError: z.ZodError): string | undefined;
+/**
+ * Safe parse with detailed error information
+ */
+export declare function safeParse<T>(schema: z.ZodSchema<T>, data: unknown): {
+	success: true;
+	data: T;
+} | {
+	success: false;
+	error: string;
+	field?: string;
+};
+export type CharacterBook = CCv3CharacterBook;
+export type LorebookEntry = CCv3LorebookEntry;
+
+export {};