@character-foundry/character-foundry 0.4.2 → 0.4.3-dev.1766103111

package/dist/schemas.d.ts

@@ -24,7 +24,8 @@ export declare const CCv3LorebookEntrySchema: z.ZodObject<{
 	position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 		z.ZodEnum<[
 			"before_char",
-			"after_char"
+			"after_char",
+			"in_chat"
 		]>,
 		z.ZodNumber,
 		z.ZodLiteral<"">
@@ -67,7 +68,8 @@ export declare const CCv3LorebookEntrySchema: z.ZodObject<{
 	position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 		z.ZodEnum<[
 			"before_char",
-			"after_char"
+			"after_char",
+			"in_chat"
 		]>,
 		z.ZodNumber,
 		z.ZodLiteral<"">
@@ -110,7 +112,8 @@ export declare const CCv3LorebookEntrySchema: z.ZodObject<{
 	position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 		z.ZodEnum<[
 			"before_char",
-			"after_char"
+			"after_char",
+			"in_chat"
 		]>,
 		z.ZodNumber,
 		z.ZodLiteral<"">
@@ -139,13 +142,14 @@ export declare const CCv3LorebookEntrySchema: z.ZodObject<{
 	]>>;
 }, z.ZodTypeAny, "passthrough">>;
 /**
- * Character book (lorebook) schema for v3 cards
+ * Character book (lorebook) schema for v3 cards.
+ * Uses preprocessing for numeric fields that often come as strings in wild data.
  */
 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>;
+	scan_depth: z.ZodEffects<z.ZodOptional<z.ZodNumber>, number | undefined, unknown>;
+	token_budget: z.ZodEffects<z.ZodOptional<z.ZodNumber>, number | undefined, unknown>;
 	recursive_scanning: z.ZodOptional<z.ZodBoolean>;
 	extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 	entries: z.ZodArray<z.ZodObject<{
@@ -164,7 +168,8 @@ export declare const CCv3CharacterBookSchema: z.ZodObject<{
 		position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 			z.ZodEnum<[
 				"before_char",
-				"after_char"
+				"after_char",
+				"in_chat"
 			]>,
 			z.ZodNumber,
 			z.ZodLiteral<"">
@@ -207,7 +212,8 @@ export declare const CCv3CharacterBookSchema: z.ZodObject<{
 		position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 			z.ZodEnum<[
 				"before_char",
-				"after_char"
+				"after_char",
+				"in_chat"
 			]>,
 			z.ZodNumber,
 			z.ZodLiteral<"">
@@ -250,7 +256,8 @@ export declare const CCv3CharacterBookSchema: z.ZodObject<{
 		position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 			z.ZodEnum<[
 				"before_char",
-				"after_char"
+				"after_char",
+				"in_chat"
 			]>,
 			z.ZodNumber,
 			z.ZodLiteral<"">
@@ -295,7 +302,8 @@ export declare const CCv3CharacterBookSchema: z.ZodObject<{
 		position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 			z.ZodEnum<[
 				"before_char",
-				"after_char"
+				"after_char",
+				"in_chat"
 			]>,
 			z.ZodNumber,
 			z.ZodLiteral<"">
@@ -346,7 +354,8 @@ export declare const CCv3CharacterBookSchema: z.ZodObject<{
 		position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 			z.ZodEnum<[
 				"before_char",
-				"after_char"
+				"after_char",
+				"in_chat"
 			]>,
 			z.ZodNumber,
 			z.ZodLiteral<"">
@@ -376,8 +385,8 @@ export declare const CCv3CharacterBookSchema: z.ZodObject<{
 	}, z.ZodTypeAny, "passthrough">[];
 	name?: string | undefined;
 	description?: string | undefined;
-	scan_depth?: number | undefined;
-	token_budget?: number | undefined;
+	scan_depth?: unknown;
+	token_budget?: unknown;
 	recursive_scanning?: boolean | undefined;
 	extensions?: Record<string, unknown> | undefined;
 }>;
@@ -406,8 +415,8 @@ export declare const CCv3DataInnerSchema: z.ZodObject<{
 	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>;
+		scan_depth: z.ZodEffects<z.ZodOptional<z.ZodNumber>, number | undefined, unknown>;
+		token_budget: z.ZodEffects<z.ZodOptional<z.ZodNumber>, number | undefined, unknown>;
 		recursive_scanning: z.ZodOptional<z.ZodBoolean>;
 		extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 		entries: z.ZodArray<z.ZodObject<{
@@ -426,7 +435,8 @@ export declare const CCv3DataInnerSchema: z.ZodObject<{
 			position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 				z.ZodEnum<[
 					"before_char",
-					"after_char"
+					"after_char",
+					"in_chat"
 				]>,
 				z.ZodNumber,
 				z.ZodLiteral<"">
@@ -469,7 +479,8 @@ export declare const CCv3DataInnerSchema: z.ZodObject<{
 			position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 				z.ZodEnum<[
 					"before_char",
-					"after_char"
+					"after_char",
+					"in_chat"
 				]>,
 				z.ZodNumber,
 				z.ZodLiteral<"">
@@ -512,7 +523,8 @@ export declare const CCv3DataInnerSchema: z.ZodObject<{
 			position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 				z.ZodEnum<[
 					"before_char",
-					"after_char"
+					"after_char",
+					"in_chat"
 				]>,
 				z.ZodNumber,
 				z.ZodLiteral<"">
@@ -557,7 +569,8 @@ export declare const CCv3DataInnerSchema: z.ZodObject<{
 			position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 				z.ZodEnum<[
 					"before_char",
-					"after_char"
+					"after_char",
+					"in_chat"
 				]>,
 				z.ZodNumber,
 				z.ZodLiteral<"">
@@ -608,7 +621,8 @@ export declare const CCv3DataInnerSchema: z.ZodObject<{
 			position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 				z.ZodEnum<[
 					"before_char",
-					"after_char"
+					"after_char",
+					"in_chat"
 				]>,
 				z.ZodNumber,
 				z.ZodLiteral<"">
@@ -638,14 +652,14 @@ export declare const CCv3DataInnerSchema: z.ZodObject<{
 		}, z.ZodTypeAny, "passthrough">[];
 		name?: string | undefined;
 		description?: string | undefined;
-		scan_depth?: number | undefined;
-		token_budget?: number | undefined;
+		scan_depth?: unknown;
+		token_budget?: unknown;
 		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<[
+		type: z.ZodEffects<z.ZodEnum<[
 			"icon",
 			"background",
 			"emotion",
@@ -654,7 +668,7 @@ export declare const CCv3DataInnerSchema: z.ZodObject<{
 			"video",
 			"custom",
 			"x-risu-asset"
-		]>;
+		]>, "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset", unknown>;
 		uri: z.ZodString;
 		name: z.ZodString;
 		ext: z.ZodString;
@@ -665,15 +679,15 @@ export declare const CCv3DataInnerSchema: z.ZodObject<{
 		ext: string;
 	}, {
 		name: string;
-		type: "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset";
 		uri: string;
 		ext: string;
+		type?: unknown;
 	}>, "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>;
+	creation_date: z.ZodEffects<z.ZodOptional<z.ZodNumber>, number | undefined, unknown>;
+	modification_date: z.ZodEffects<z.ZodOptional<z.ZodNumber>, number | undefined, unknown>;
 }, "strip", z.ZodTypeAny, {
 	name: string;
 	description: string;
@@ -707,7 +721,8 @@ export declare const CCv3DataInnerSchema: z.ZodObject<{
 			position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 				z.ZodEnum<[
 					"before_char",
-					"after_char"
+					"after_char",
+					"in_chat"
 				]>,
 				z.ZodNumber,
 				z.ZodLiteral<"">
@@ -782,7 +797,8 @@ export declare const CCv3DataInnerSchema: z.ZodObject<{
 			position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 				z.ZodEnum<[
 					"before_char",
-					"after_char"
+					"after_char",
+					"in_chat"
 				]>,
 				z.ZodNumber,
 				z.ZodLiteral<"">
@@ -812,8 +828,8 @@ export declare const CCv3DataInnerSchema: z.ZodObject<{
 		}, z.ZodTypeAny, "passthrough">[];
 		name?: string | undefined;
 		description?: string | undefined;
-		scan_depth?: number | undefined;
-		token_budget?: number | undefined;
+		scan_depth?: unknown;
+		token_budget?: unknown;
 		recursive_scanning?: boolean | undefined;
 		extensions?: Record<string, unknown> | undefined;
 	} | null | undefined;
@@ -823,15 +839,15 @@ export declare const CCv3DataInnerSchema: z.ZodObject<{
 	group_only_greetings?: string[] | undefined;
 	assets?: {
 		name: string;
-		type: "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset";
 		uri: string;
 		ext: string;
+		type?: unknown;
 	}[] | undefined;
 	nickname?: string | undefined;
 	creator_notes_multilingual?: Record<string, string> | undefined;
 	source?: string[] | undefined;
-	creation_date?: number | undefined;
-	modification_date?: number | undefined;
+	creation_date?: unknown;
+	modification_date?: unknown;
 }>;
 /**
  * Character Card v3 full structure schema
@@ -857,8 +873,8 @@ export declare const CCv3DataSchema: z.ZodObject<{
 		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>;
+			scan_depth: z.ZodEffects<z.ZodOptional<z.ZodNumber>, number | undefined, unknown>;
+			token_budget: z.ZodEffects<z.ZodOptional<z.ZodNumber>, number | undefined, unknown>;
 			recursive_scanning: z.ZodOptional<z.ZodBoolean>;
 			extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 			entries: z.ZodArray<z.ZodObject<{
@@ -877,7 +893,8 @@ export declare const CCv3DataSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -920,7 +937,8 @@ export declare const CCv3DataSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -963,7 +981,8 @@ export declare const CCv3DataSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -1008,7 +1027,8 @@ export declare const CCv3DataSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -1059,7 +1079,8 @@ export declare const CCv3DataSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -1089,14 +1110,14 @@ export declare const CCv3DataSchema: z.ZodObject<{
 			}, z.ZodTypeAny, "passthrough">[];
 			name?: string | undefined;
 			description?: string | undefined;
-			scan_depth?: number | undefined;
-			token_budget?: number | undefined;
+			scan_depth?: unknown;
+			token_budget?: unknown;
 			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<[
+			type: z.ZodEffects<z.ZodEnum<[
 				"icon",
 				"background",
 				"emotion",
@@ -1105,7 +1126,7 @@ export declare const CCv3DataSchema: z.ZodObject<{
 				"video",
 				"custom",
 				"x-risu-asset"
-			]>;
+			]>, "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset", unknown>;
 			uri: z.ZodString;
 			name: z.ZodString;
 			ext: z.ZodString;
@@ -1116,15 +1137,15 @@ export declare const CCv3DataSchema: z.ZodObject<{
 			ext: string;
 		}, {
 			name: string;
-			type: "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset";
 			uri: string;
 			ext: string;
+			type?: unknown;
 		}>, "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>;
+		creation_date: z.ZodEffects<z.ZodOptional<z.ZodNumber>, number | undefined, unknown>;
+		modification_date: z.ZodEffects<z.ZodOptional<z.ZodNumber>, number | undefined, unknown>;
 	}, "strip", z.ZodTypeAny, {
 		name: string;
 		description: string;
@@ -1158,7 +1179,8 @@ export declare const CCv3DataSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -1233,7 +1255,8 @@ export declare const CCv3DataSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -1263,8 +1286,8 @@ export declare const CCv3DataSchema: z.ZodObject<{
 			}, z.ZodTypeAny, "passthrough">[];
 			name?: string | undefined;
 			description?: string | undefined;
-			scan_depth?: number | undefined;
-			token_budget?: number | undefined;
+			scan_depth?: unknown;
+			token_budget?: unknown;
 			recursive_scanning?: boolean | undefined;
 			extensions?: Record<string, unknown> | undefined;
 		} | null | undefined;
@@ -1274,15 +1297,15 @@ export declare const CCv3DataSchema: z.ZodObject<{
 		group_only_greetings?: string[] | undefined;
 		assets?: {
 			name: string;
-			type: "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset";
 			uri: string;
 			ext: string;
+			type?: unknown;
 		}[] | undefined;
 		nickname?: string | undefined;
 		creator_notes_multilingual?: Record<string, string> | undefined;
 		source?: string[] | undefined;
-		creation_date?: number | undefined;
-		modification_date?: number | undefined;
+		creation_date?: unknown;
+		modification_date?: unknown;
 	}>;
 }, "strip", z.ZodTypeAny, {
 	data: {
@@ -1318,7 +1341,8 @@ export declare const CCv3DataSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -1397,7 +1421,8 @@ export declare const CCv3DataSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -1427,8 +1452,8 @@ export declare const CCv3DataSchema: z.ZodObject<{
 			}, z.ZodTypeAny, "passthrough">[];
 			name?: string | undefined;
 			description?: string | undefined;
-			scan_depth?: number | undefined;
-			token_budget?: number | undefined;
+			scan_depth?: unknown;
+			token_budget?: unknown;
 			recursive_scanning?: boolean | undefined;
 			extensions?: Record<string, unknown> | undefined;
 		} | null | undefined;
@@ -1438,15 +1463,15 @@ export declare const CCv3DataSchema: z.ZodObject<{
 		group_only_greetings?: string[] | undefined;
 		assets?: {
 			name: string;
-			type: "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset";
 			uri: string;
 			ext: string;
+			type?: unknown;
 		}[] | undefined;
 		nickname?: string | undefined;
 		creator_notes_multilingual?: Record<string, string> | undefined;
 		source?: string[] | undefined;
-		creation_date?: number | undefined;
-		modification_date?: number | undefined;
+		creation_date?: unknown;
+		modification_date?: unknown;
 	};
 	spec: "chara_card_v3";
 	spec_version: "3.0";
@@ -1496,6 +1521,21 @@ export declare function looksLikeV3Card(data: unknown): data is {
  *
  * Shared types used across all card formats.
  */
+/**
+ * Preprocess timestamp values to Unix seconds.
+ * Handles: ISO strings, numeric strings, milliseconds, and numbers.
+ * Returns undefined for invalid/negative values (defensive).
+ */
+export declare function preprocessTimestamp(val: unknown): number | undefined;
+/**
+ * Preprocess numeric values that may come as strings.
+ * Returns undefined for invalid values.
+ */
+export declare function preprocessNumeric(val: unknown): number | undefined;
+/**
+ * Preprocess asset type - coerce unknown types to 'custom'.
+ */
+export declare function preprocessAssetType(val: unknown): string;
 /**
  * ISO 8601 date string schema
  */
@@ -1533,9 +1573,10 @@ export declare const OriginalShapeSchema: z.ZodEnum<[
 	"legacy"
 ]>;
 /**
- * Asset type identifier schema
+ * Asset type identifier schema.
+ * Uses preprocessing to coerce unknown types to 'custom' for forward compatibility.
  */
-export declare const AssetTypeSchema: z.ZodEnum<[
+export declare const AssetTypeSchema: z.ZodEffects<z.ZodEnum<[
 	"icon",
 	"background",
 	"emotion",
@@ -1544,12 +1585,12 @@ export declare const AssetTypeSchema: z.ZodEnum<[
 	"video",
 	"custom",
 	"x-risu-asset"
-]>;
+]>, "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset", unknown>;
 /**
  * Asset descriptor schema (v3 spec)
  */
 export declare const AssetDescriptorSchema: z.ZodObject<{
-	type: z.ZodEnum<[
+	type: z.ZodEffects<z.ZodEnum<[
 		"icon",
 		"background",
 		"emotion",
@@ -1558,7 +1599,7 @@ export declare const AssetDescriptorSchema: z.ZodObject<{
 		"video",
 		"custom",
 		"x-risu-asset"
-	]>;
+	]>, "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset", unknown>;
 	uri: z.ZodString;
 	name: z.ZodString;
 	ext: z.ZodString;
@@ -1569,16 +1610,16 @@ export declare const AssetDescriptorSchema: z.ZodObject<{
 	ext: string;
 }, {
 	name: string;
-	type: "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset";
 	uri: string;
 	ext: string;
+	type?: unknown;
 }>;
 /**
  * Extracted asset with binary data schema
  */
 export declare const ExtractedAssetSchema: z.ZodObject<{
 	descriptor: z.ZodObject<{
-		type: z.ZodEnum<[
+		type: z.ZodEffects<z.ZodEnum<[
 			"icon",
 			"background",
 			"emotion",
@@ -1587,7 +1628,7 @@ export declare const ExtractedAssetSchema: z.ZodObject<{
 			"video",
 			"custom",
 			"x-risu-asset"
-		]>;
+		]>, "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset", unknown>;
 		uri: z.ZodString;
 		name: z.ZodString;
 		ext: z.ZodString;
@@ -1598,9 +1639,9 @@ export declare const ExtractedAssetSchema: z.ZodObject<{
 		ext: string;
 	}, {
 		name: string;
-		type: "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset";
 		uri: string;
 		ext: string;
+		type?: unknown;
 	}>;
 	data: z.ZodType<Uint8Array<ArrayBuffer>, z.ZodTypeDef, Uint8Array<ArrayBuffer>>;
 	mimeType: z.ZodString;
@@ -1616,9 +1657,9 @@ export declare const ExtractedAssetSchema: z.ZodObject<{
 }, {
 	descriptor: {
 		name: string;
-		type: "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset";
 		uri: string;
 		ext: string;
+		type?: unknown;
 	};
 	data: Uint8Array<ArrayBuffer>;
 	mimeType: string;
@@ -1680,7 +1721,8 @@ export declare const CCv2LorebookEntrySchema: z.ZodObject<{
 	position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 		z.ZodEnum<[
 			"before_char",
-			"after_char"
+			"after_char",
+			"in_chat"
 		]>,
 		z.ZodNumber,
 		z.ZodLiteral<"">
@@ -1702,7 +1744,8 @@ export declare const CCv2LorebookEntrySchema: z.ZodObject<{
 	position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 		z.ZodEnum<[
 			"before_char",
-			"after_char"
+			"after_char",
+			"in_chat"
 		]>,
 		z.ZodNumber,
 		z.ZodLiteral<"">
@@ -1724,20 +1767,22 @@ export declare const CCv2LorebookEntrySchema: z.ZodObject<{
 	position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 		z.ZodEnum<[
 			"before_char",
-			"after_char"
+			"after_char",
+			"in_chat"
 		]>,
 		z.ZodNumber,
 		z.ZodLiteral<"">
 	]>>>;
 }, z.ZodTypeAny, "passthrough">>;
 /**
- * Character book (lorebook) schema for v2 cards
+ * Character book (lorebook) schema for v2 cards.
+ * Uses preprocessing for numeric fields that often come as strings in wild data.
  */
 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>;
+	scan_depth: z.ZodEffects<z.ZodOptional<z.ZodNumber>, number | undefined, unknown>;
+	token_budget: z.ZodEffects<z.ZodOptional<z.ZodNumber>, number | undefined, unknown>;
 	recursive_scanning: z.ZodOptional<z.ZodBoolean>;
 	extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 	entries: z.ZodArray<z.ZodObject<{
@@ -1757,7 +1802,8 @@ export declare const CCv2CharacterBookSchema: z.ZodObject<{
 		position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 			z.ZodEnum<[
 				"before_char",
-				"after_char"
+				"after_char",
+				"in_chat"
 			]>,
 			z.ZodNumber,
 			z.ZodLiteral<"">
@@ -1779,7 +1825,8 @@ export declare const CCv2CharacterBookSchema: z.ZodObject<{
 		position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 			z.ZodEnum<[
 				"before_char",
-				"after_char"
+				"after_char",
+				"in_chat"
 			]>,
 			z.ZodNumber,
 			z.ZodLiteral<"">
@@ -1801,7 +1848,8 @@ export declare const CCv2CharacterBookSchema: z.ZodObject<{
 		position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 			z.ZodEnum<[
 				"before_char",
-				"after_char"
+				"after_char",
+				"in_chat"
 			]>,
 			z.ZodNumber,
 			z.ZodLiteral<"">
@@ -1825,7 +1873,8 @@ export declare const CCv2CharacterBookSchema: z.ZodObject<{
 		position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 			z.ZodEnum<[
 				"before_char",
-				"after_char"
+				"after_char",
+				"in_chat"
 			]>,
 			z.ZodNumber,
 			z.ZodLiteral<"">
@@ -1855,7 +1904,8 @@ export declare const CCv2CharacterBookSchema: z.ZodObject<{
 		position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 			z.ZodEnum<[
 				"before_char",
-				"after_char"
+				"after_char",
+				"in_chat"
 			]>,
 			z.ZodNumber,
 			z.ZodLiteral<"">
@@ -1863,8 +1913,8 @@ export declare const CCv2CharacterBookSchema: z.ZodObject<{
 	}, z.ZodTypeAny, "passthrough">[];
 	name?: string | undefined;
 	description?: string | undefined;
-	scan_depth?: number | undefined;
-	token_budget?: number | undefined;
+	scan_depth?: unknown;
+	token_budget?: unknown;
 	recursive_scanning?: boolean | undefined;
 	extensions?: Record<string, unknown> | undefined;
 }>;
@@ -1885,8 +1935,8 @@ export declare const CCv2DataSchema: z.ZodObject<{
 	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>;
+		scan_depth: z.ZodEffects<z.ZodOptional<z.ZodNumber>, number | undefined, unknown>;
+		token_budget: z.ZodEffects<z.ZodOptional<z.ZodNumber>, number | undefined, unknown>;
 		recursive_scanning: z.ZodOptional<z.ZodBoolean>;
 		extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 		entries: z.ZodArray<z.ZodObject<{
@@ -1906,7 +1956,8 @@ export declare const CCv2DataSchema: z.ZodObject<{
 			position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 				z.ZodEnum<[
 					"before_char",
-					"after_char"
+					"after_char",
+					"in_chat"
 				]>,
 				z.ZodNumber,
 				z.ZodLiteral<"">
@@ -1928,7 +1979,8 @@ export declare const CCv2DataSchema: z.ZodObject<{
 			position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 				z.ZodEnum<[
 					"before_char",
-					"after_char"
+					"after_char",
+					"in_chat"
 				]>,
 				z.ZodNumber,
 				z.ZodLiteral<"">
@@ -1950,7 +2002,8 @@ export declare const CCv2DataSchema: z.ZodObject<{
 			position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 				z.ZodEnum<[
 					"before_char",
-					"after_char"
+					"after_char",
+					"in_chat"
 				]>,
 				z.ZodNumber,
 				z.ZodLiteral<"">
@@ -1974,7 +2027,8 @@ export declare const CCv2DataSchema: z.ZodObject<{
 			position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 				z.ZodEnum<[
 					"before_char",
-					"after_char"
+					"after_char",
+					"in_chat"
 				]>,
 				z.ZodNumber,
 				z.ZodLiteral<"">
@@ -2004,7 +2058,8 @@ export declare const CCv2DataSchema: z.ZodObject<{
 			position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 				z.ZodEnum<[
 					"before_char",
-					"after_char"
+					"after_char",
+					"in_chat"
 				]>,
 				z.ZodNumber,
 				z.ZodLiteral<"">
@@ -2012,8 +2067,8 @@ export declare const CCv2DataSchema: z.ZodObject<{
 		}, z.ZodTypeAny, "passthrough">[];
 		name?: string | undefined;
 		description?: string | undefined;
-		scan_depth?: number | undefined;
-		token_budget?: number | undefined;
+		scan_depth?: unknown;
+		token_budget?: unknown;
 		recursive_scanning?: boolean | undefined;
 		extensions?: Record<string, unknown> | undefined;
 	}>>>;
@@ -2051,7 +2106,8 @@ export declare const CCv2DataSchema: z.ZodObject<{
 			position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 				z.ZodEnum<[
 					"before_char",
-					"after_char"
+					"after_char",
+					"in_chat"
 				]>,
 				z.ZodNumber,
 				z.ZodLiteral<"">
@@ -2097,7 +2153,8 @@ export declare const CCv2DataSchema: z.ZodObject<{
 			position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 				z.ZodEnum<[
 					"before_char",
-					"after_char"
+					"after_char",
+					"in_chat"
 				]>,
 				z.ZodNumber,
 				z.ZodLiteral<"">
@@ -2105,8 +2162,8 @@ export declare const CCv2DataSchema: z.ZodObject<{
 		}, z.ZodTypeAny, "passthrough">[];
 		name?: string | undefined;
 		description?: string | undefined;
-		scan_depth?: number | undefined;
-		token_budget?: number | undefined;
+		scan_depth?: unknown;
+		token_budget?: unknown;
 		recursive_scanning?: boolean | undefined;
 		extensions?: Record<string, unknown> | undefined;
 	} | null | undefined;
@@ -2134,8 +2191,8 @@ export declare const CCv2WrappedSchema: z.ZodObject<{
 		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>;
+			scan_depth: z.ZodEffects<z.ZodOptional<z.ZodNumber>, number | undefined, unknown>;
+			token_budget: z.ZodEffects<z.ZodOptional<z.ZodNumber>, number | undefined, unknown>;
 			recursive_scanning: z.ZodOptional<z.ZodBoolean>;
 			extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 			entries: z.ZodArray<z.ZodObject<{
@@ -2155,7 +2212,8 @@ export declare const CCv2WrappedSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -2177,7 +2235,8 @@ export declare const CCv2WrappedSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -2199,7 +2258,8 @@ export declare const CCv2WrappedSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -2223,7 +2283,8 @@ export declare const CCv2WrappedSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -2253,7 +2314,8 @@ export declare const CCv2WrappedSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -2261,8 +2323,8 @@ export declare const CCv2WrappedSchema: z.ZodObject<{
 			}, z.ZodTypeAny, "passthrough">[];
 			name?: string | undefined;
 			description?: string | undefined;
-			scan_depth?: number | undefined;
-			token_budget?: number | undefined;
+			scan_depth?: unknown;
+			token_budget?: unknown;
 			recursive_scanning?: boolean | undefined;
 			extensions?: Record<string, unknown> | undefined;
 		}>>>;
@@ -2300,7 +2362,8 @@ export declare const CCv2WrappedSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -2346,7 +2409,8 @@ export declare const CCv2WrappedSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -2354,8 +2418,8 @@ export declare const CCv2WrappedSchema: z.ZodObject<{
 			}, z.ZodTypeAny, "passthrough">[];
 			name?: string | undefined;
 			description?: string | undefined;
-			scan_depth?: number | undefined;
-			token_budget?: number | undefined;
+			scan_depth?: unknown;
+			token_budget?: unknown;
 			recursive_scanning?: boolean | undefined;
 			extensions?: Record<string, unknown> | undefined;
 		} | null | undefined;
@@ -2394,7 +2458,8 @@ export declare const CCv2WrappedSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -2444,7 +2509,8 @@ export declare const CCv2WrappedSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -2452,8 +2518,8 @@ export declare const CCv2WrappedSchema: z.ZodObject<{
 			}, z.ZodTypeAny, "passthrough">[];
 			name?: string | undefined;
 			description?: string | undefined;
-			scan_depth?: number | undefined;
-			token_budget?: number | undefined;
+			scan_depth?: unknown;
+			token_budget?: unknown;
 			recursive_scanning?: boolean | undefined;
 			extensions?: Record<string, unknown> | undefined;
 		} | null | undefined;