@dsh-agentic-roleplay/state 0.3.3 → 0.3.4

package/lib/index.d.ts

@@ -2487,6 +2487,20 @@ interface RoutineWindowSpec {
   position?: string;
   interruptible?: boolean;
 }
+/** One day on which a character does something other than its routine says: it takes the place of the routine's windows on that date and is dropped when the same date is set again. */
+interface RoutineExceptionSpec {
+  character: string;
+  /** The date, `YYYY-MM-DD`, in the story's time zone. */
+  date: string;
+  activity: string;
+  /** `HH:MM`; the whole day when left out. */
+  from?: string;
+  to?: string;
+  location?: string;
+  feature?: string;
+  position?: string;
+  interruptible?: boolean;
+}
 /** Sets the recurring day of a character, replacing what it had. */
 interface RoutineSet {
   character: string;
@@ -2506,6 +2520,7 @@ interface RecordsEdit {
   engagements?: NewEngagementSpec[];
   engagementEdits?: EngagementEditSpec[];
   routines?: RoutineSet[];
+  routineExceptions?: RoutineExceptionSpec[];
   /** Things the world does when their conditions come true, only by the agent whose work that is. */
   triggers?: TriggerDefinition[];
   states?: StatePatch[];

package/lib/index.js

@@ -1487,6 +1487,12 @@ const MAX_PLAN_STEPS = 8;
 const MAX_LIST_ENTRY = 240;
 const present$1 = (value) => value !== void 0 && value.trim() !== "";
 const list$1 = (value) => value ?? [];
+const FULL_DATE = /^\d{4}-\d{2}-\d{2}$/;
+const isExceptionOn = (on, date) => on.length === 1 && on[0] === date;
+const ALL_DAY = {
+	from: "00:00",
+	to: "23:59"
+};
 /** Checks the goals, engagements and routines of an edit, and says what they would write. Problems are added to the context's. */
 function prepareAgenda(target, edit, context) {
 	const { idOf, placeKnown, problems } = context;
@@ -1652,6 +1658,39 @@ function prepareAgenda(target, edit, context) {
 				character,
 				windows
 			}];
+		}),
+		exceptions: list$1(edit.routineExceptions).flatMap((spec, index) => {
+			const where = `routine_exceptions[${index}]`;
+			const character = idOf(spec.character, where);
+			if (!FULL_DATE.test(spec.date)) problems.push(`${where}.date: "${spec.date}" is not a date (YYYY-MM-DD)`);
+			else problems.push(...dayTokenProblems([spec.date], `${where}.date`));
+			if (!present$1(spec.activity)) problems.push(`${where}: say what the character does that day`);
+			if (spec.from === void 0 !== (spec.to === void 0)) problems.push(`${where}: give both from and to, or neither for the whole day`);
+			const start = parseTimeOfDay(spec.from ?? ALL_DAY.from);
+			const end = parseTimeOfDay(spec.to ?? ALL_DAY.to);
+			if (start === void 0) problems.push(`${where}.from: "${spec.from}" is not a time of day (HH:MM)`);
+			if (end === void 0) problems.push(`${where}.to: "${spec.to}" is not a time of day (HH:MM)`);
+			if (start !== void 0 && start === end) problems.push(`${where}: it starts and ends at the same time`);
+			if (spec.location !== void 0) {
+				placeKnown(spec.location, `${where}.location`);
+				const place = context.places.get(spec.location);
+				if (spec.feature !== void 0 && place !== void 0 && !place.features.some((feature) => feature.key === spec.feature)) problems.push(`${where}: ${place.name} has no feature "${spec.feature}"`);
+			} else if (spec.feature !== void 0) problems.push(`${where}: a feature needs a location`);
+			if (character === void 0 || start === void 0 || end === void 0) return [];
+			return [{
+				character,
+				window: {
+					days: [],
+					on: [spec.date],
+					start,
+					end,
+					activity: spec.activity.trim(),
+					interruptible: spec.interruptible ?? true,
+					...spec.location === void 0 ? {} : { location: spec.location },
+					...spec.feature === void 0 ? {} : { featureKey: spec.feature },
+					...spec.position === void 0 || spec.position.trim() === "" ? {} : { position: spec.position.trim() }
+				}
+			}];
 		})
 	};
 }
@@ -1698,6 +1737,17 @@ function writeAgenda(target, prepared, turn, placeId) {
 		})));
 		writes += 1;
 	}
+	for (const { character, window } of prepared.exceptions) {
+		const date = window.on[0];
+		const kept = target.routines.list(character).filter((existing) => !isExceptionOn(existing.on, date));
+		if (kept.length + 1 > 24) throw new InvalidEditError([`routine_exceptions: the character's day already has 24 windows`]);
+		const { location, ...rest } = window;
+		target.routines.replace(character, [{
+			...rest,
+			...location === void 0 ? {} : { locationId: placeId(location) }
+		}, ...kept]);
+		writes += 1;
+	}
 	return writes;
 }
 //#endregion
@@ -3553,6 +3603,17 @@ function parseRecordsEdit(value) {
 			}
 			return [parsed.definition];
 		}),
+		routineExceptions: array("routine_exceptions").map((entry) => defined({
+			character: text(entry, "character") ?? "",
+			date: text(entry, "date") ?? "",
+			activity: text(entry, "activity") ?? "",
+			from: text(entry, "from"),
+			to: text(entry, "to"),
+			location: text(entry, "location"),
+			feature: text(entry, "feature"),
+			position: text(entry, "position"),
+			interruptible: bool(entry, "interruptible")
+		})),
 		routines: array("routines").map((entry) => ({
 			character: text(entry, "character") ?? "",
 			windows: Array.isArray(entry["windows"]) ? entry["windows"].filter(isObject$1).map((window) => defined({
@@ -4229,6 +4290,42 @@ function recordsEditSchema(options = {}) {
 				additionalProperties: false
 			}
 		},
+		routine_exceptions: {
+			type: "array",
+			description: "A day on which a character does something other than its routine says (ill in bed, away on an errand, a day off): the date (YYYY-MM-DD, story-local), what it does and where; it takes the place of the routine on that date only. Setting the same date again replaces it.",
+			items: {
+				type: "object",
+				properties: {
+					character,
+					date: {
+						type: "string",
+						description: "YYYY-MM-DD."
+					},
+					activity: {
+						type: "string",
+						description: "What it does that day: \"keeps to bed with a fever\"."
+					},
+					from: {
+						type: "string",
+						description: "HH:MM; leave out with to for the whole day."
+					},
+					to: {
+						type: "string",
+						description: "HH:MM."
+					},
+					location: placeKey,
+					feature: { type: "string" },
+					position: { type: "string" },
+					interruptible: { type: "boolean" }
+				},
+				required: [
+					"character",
+					"date",
+					"activity"
+				],
+				additionalProperties: false
+			}
+		},
 		engagement_edits: {
 			type: "array",
 			description: "An engagement that moved on (the ids are in read_records): it was kept, missed, cancelled, or put off. Give only what changes.",