@character-foundry/character-foundry 0.1.3 → 0.1.5

package/dist/lorebook.d.ts

@@ -1,2 +1,1008 @@
-export * from '@character-foundry/lorebook';
-//# sourceMappingURL=lorebook.d.ts.map
+import { z } from 'zod';
+
+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;
+}>;
+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";
+}>;
+/**
+ * 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 full structure
+ */
+export type CCv3Data = z.infer<typeof CCv3DataSchema>;
+/**
+ * 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;
+/**
+ * Lorebook Types
+ *
+ * Type definitions for lorebook handling across formats.
+ */
+/**
+ * Known lorebook formats
+ */
+export type LorebookFormat = "ccv3" | "sillytavern" | "agnai" | "risu" | "wyvern" | "unknown";
+/**
+ * Result of parsing a standalone lorebook file
+ */
+export interface ParsedLorebook {
+	/** Normalized CCv3 format */
+	book: CCv3CharacterBook;
+	/** Original format detected */
+	originalFormat: LorebookFormat;
+	/** Raw original data for round-trip preservation */
+	originalShape: unknown;
+}
+/**
+ * Reference to a linked/external lorebook found in card extensions
+ */
+export interface LorebookRef {
+	/** Source URL */
+	url: string;
+	/** Platform identifier */
+	platform: string;
+	/** ID on source platform */
+	id?: string;
+	/** Display name if available */
+	name?: string;
+}
+/**
+ * A downloaded/fetched linked lorebook with source tracking
+ */
+export interface LinkedLorebook {
+	/** Source URL */
+	source: string;
+	/** Platform identifier */
+	platform: string;
+	/** ID on source platform */
+	sourceId?: string;
+	/** When it was fetched (ISO timestamp) */
+	fetchedAt: string;
+	/** Display name */
+	name?: string;
+	/** The actual lorebook content */
+	book: CCv3CharacterBook;
+}
+/**
+ * Source metadata stamped on entries from linked lorebooks
+ * Stored in entry.extensions.lorebookSource
+ */
+export interface EntrySourceMeta {
+	/** Source URL of the linked lorebook */
+	linkedFrom: string;
+	/** Platform identifier */
+	platform: string;
+	/** When the lorebook was fetched */
+	fetchedAt: string;
+	/** Original entry ID/name in source */
+	originalEntryId?: string;
+	/** Lorebook name for display */
+	lorebookName?: string;
+}
+/**
+ * A card's complete lorebook collection (multiple books, never merged)
+ */
+export interface LorebookCollection {
+	/** Embedded lorebooks (directly in card) - can be multiple */
+	embedded: CCv3CharacterBook[];
+	/** Linked lorebooks (fetched from external sources) */
+	linked: LinkedLorebook[];
+}
+/**
+ * Extended entry with source tracking
+ */
+export interface TrackedEntry extends CCv3LorebookEntry {
+	extensions?: {
+		lorebookSource?: EntrySourceMeta;
+		[key: string]: unknown;
+	};
+}
+/**
+ * SillyTavern world_info format (for reference)
+ */
+export interface SillyTavernWorldInfo {
+	entries: Record<string, SillyTavernEntry>;
+	name?: string;
+	description?: string;
+}
+export interface SillyTavernEntry {
+	uid: number;
+	key: string[];
+	keysecondary?: string[];
+	comment?: string;
+	content: string;
+	constant?: boolean;
+	selective?: boolean;
+	selectiveLogic?: number;
+	order?: number;
+	position?: number;
+	disable?: boolean;
+	excludeRecursion?: boolean;
+	probability?: number;
+	useProbability?: boolean;
+	depth?: number;
+	group?: string;
+	scanDepth?: number;
+	caseSensitive?: boolean;
+	matchWholeWords?: boolean;
+	automationId?: string;
+	role?: number;
+	vectorized?: boolean;
+	groupOverride?: boolean;
+	groupWeight?: number;
+	sticky?: number;
+	cooldown?: number;
+	delay?: number;
+}
+/**
+ * Agnai lorebook format (for reference)
+ */
+export interface AgnaiLorebook {
+	kind: "memory";
+	name: string;
+	description?: string;
+	entries: AgnaiEntry[];
+}
+export interface AgnaiEntry {
+	name: string;
+	entry: string;
+	keywords: string[];
+	priority: number;
+	weight: number;
+	enabled: boolean;
+}
+/**
+ * Lorebook Parser
+ *
+ * Parse standalone lorebook files from various formats.
+ */
+/**
+ * Parse a standalone lorebook file
+ *
+ * Detects format and normalizes to CCv3 character_book structure.
+ * Preserves original shape for round-trip.
+ */
+export declare function parseLorebook(data: BinaryData): ParsedLorebook;
+/**
+ * Detect the format of a lorebook JSON object
+ */
+export declare function detectLorebookFormat(data: unknown): LorebookFormat;
+/**
+ * Normalize any lorebook format to CCv3 character_book
+ */
+export declare function normalizeToCC3(data: unknown, format: LorebookFormat): CCv3CharacterBook;
+/**
+ * Lorebook Extractor
+ *
+ * Extract linked lorebook references from cards and
+ * separate linked entries from embedded entries.
+ */
+/**
+ * Extract linked lorebook references from card extensions
+ *
+ * Looks for lorebook URLs/IDs in various extension patterns:
+ * - extensions.chub.linked_lorebooks
+ * - extensions.world_infos
+ * - extensions.linked_lorebooks
+ * - etc.
+ */
+export declare function extractLorebookRefs(card: CCv3Data): LorebookRef[];
+/**
+ * Separate embedded entries from linked entries in a character_book
+ *
+ * Uses entry.extensions.lorebookSource to identify linked entries.
+ * Returns the collection with embedded and linked separated.
+ */
+export declare function extractLinkedEntries(book: CCv3CharacterBook): {
+	embedded: CCv3CharacterBook;
+	linked: Map<string, CCv3CharacterBook>;
+};
+/**
+ * Get all lorebooks from a card as a collection
+ *
+ * This extracts:
+ * 1. The embedded character_book (may be empty)
+ * 2. Any additional embedded lorebooks from extensions
+ * 3. Separates linked entries if they have source metadata
+ */
+export declare function getLorebookCollection(card: CCv3Data): LorebookCollection;
+/**
+ * Lorebook Inserter
+ *
+ * Stamp entries with source metadata when inserting linked lorebooks.
+ * Keeps lorebooks separate - never smooshes to one giant lorebook.
+ */
+/**
+ * Stamp all entries in a lorebook with source metadata
+ *
+ * Used when fetching a linked lorebook to mark where entries came from.
+ * This allows later extraction/separation of linked vs embedded entries.
+ */
+export declare function stampEntriesWithSource(book: CCv3CharacterBook, source: Omit<EntrySourceMeta, "originalEntryId">): CCv3CharacterBook;
+/**
+ * Create a LinkedLorebook from a fetched book with source info
+ *
+ * This is used after downloading/fetching a lorebook from an external source.
+ * The book is stamped with source metadata for later extraction.
+ */
+export declare function createLinkedLorebook(book: CCv3CharacterBook, sourceUrl: string, platform: string, sourceId?: string): LinkedLorebook;
+/**
+ * Add a linked lorebook to a card's collection
+ *
+ * Does NOT merge into character_book - keeps it separate.
+ * Stores in extensions.additional_lorebooks array.
+ */
+export declare function addLinkedLorebookToCard(card: CCv3Data, linkedBook: LinkedLorebook): CCv3Data;
+/**
+ * Add an embedded lorebook to a card
+ *
+ * Adds to extensions.additional_lorebooks if character_book already exists.
+ * Otherwise sets as the main character_book.
+ */
+export declare function addEmbeddedLorebookToCard(card: CCv3Data, book: CCv3CharacterBook): CCv3Data;
+/**
+ * Remove a lorebook from a card by name
+ *
+ * Checks both character_book and additional_lorebooks.
+ */
+export declare function removeLorebookFromCard(card: CCv3Data, lorebookName: string): CCv3Data;
+/**
+ * Remove linked entries from a card that came from a specific source
+ *
+ * Useful when unlinking/removing a linked lorebook.
+ * Removes entries from ALL lorebooks in the card that have matching source.
+ */
+export declare function removeLinkedEntriesBySource(card: CCv3Data, sourceUrl: string): CCv3Data;
+/**
+ * Replace a lorebook in a card
+ *
+ * Matches by name. Updates in place without changing position.
+ */
+export declare function replaceLorebookInCard(card: CCv3Data, updatedBook: CCv3CharacterBook): CCv3Data;
+/**
+ * Rebuild a card's lorebooks from a LorebookCollection
+ *
+ * Replaces all lorebooks in the card with the collection contents.
+ * Useful after editing operations.
+ */
+export declare function setLorebookCollection(card: CCv3Data, collection: LorebookCollection): CCv3Data;
+/**
+ * Lorebook Handler
+ *
+ * Format conversion and serialization utilities.
+ */
+/**
+ * Convert a CCv3 character_book to a specific format
+ *
+ * Preserves original shape if available for round-trip fidelity.
+ */
+export declare function convertLorebook(book: CCv3CharacterBook, targetFormat: LorebookFormat, originalShape?: unknown): unknown;
+/**
+ * Serialize a lorebook to JSON string
+ */
+export declare function serializeLorebook(book: CCv3CharacterBook, format?: LorebookFormat, originalShape?: unknown, pretty?: boolean): string;
+/**
+ * Round-trip a parsed lorebook back to its original format
+ */
+export declare function serializeParsedLorebook(parsed: ParsedLorebook, pretty?: boolean): string;
+/**
+ * Merge two lorebooks by combining their entries
+ *
+ * Note: This combines entries from two books into one.
+ * Use with caution - the design preference is to keep lorebooks separate.
+ * This is provided for cases where merging is explicitly desired.
+ */
+export declare function mergeLorebooks(bookA: CCv3CharacterBook, bookB: CCv3CharacterBook, name?: string): CCv3CharacterBook;
+/**
+ * Find entries matching keys (for lookup/search)
+ */
+export declare function findEntriesByKeys(book: CCv3CharacterBook, searchKeys: string[], options?: {
+	caseSensitive?: boolean;
+	matchAll?: boolean;
+}): CCv3LorebookEntry[];
+/**
+ * Find entry by name or ID
+ */
+export declare function findEntryByNameOrId(book: CCv3CharacterBook, nameOrId: string | number): CCv3LorebookEntry | undefined;
+/**
+ * Update an entry in a lorebook
+ */
+export declare function updateEntry(book: CCv3CharacterBook, entryId: number | string, updates: Partial<CCv3LorebookEntry>): CCv3CharacterBook;
+/**
+ * Add a new entry to a lorebook
+ */
+export declare function addEntry(book: CCv3CharacterBook, entry: Omit<CCv3LorebookEntry, "id" | "insertion_order">): CCv3CharacterBook;
+/**
+ * Remove an entry from a lorebook
+ */
+export declare function removeEntry(book: CCv3CharacterBook, entryId: number | string): CCv3CharacterBook;
+/**
+ * Reorder entries in a lorebook
+ */
+export declare function reorderEntries(book: CCv3CharacterBook, entryIds: (number | string)[]): CCv3CharacterBook;
+
+export {};