@deepseek-ai/dsh-schedule 0.1.7-alpha.2 → 0.1.7-rc.2

package/lib/invariant.js

@@ -1,3 +1,4 @@
+import "@js-temporal/polyfill";
 import { SessionLogOffset } from "@deepseek-ai/dsh-session";
 const MIN_FOUR_DIGIT_YEAR_MS = Date.parse("0001-01-01T00:00:00.000Z");
 const MAX_FOUR_DIGIT_YEAR_MS = Date.parse("9999-12-31T23:59:59.999Z");
@@ -30,9 +31,45 @@ function isRecord(value) {
 }
 /** Require exactly the named durable object keys. */
 function hasExactKeys(value, expected) {
-	const keys = Object.keys(value).sort();
-	const wanted = [...expected].sort();
-	return keys.length === wanted.length && keys.every((key, index) => key === wanted[index]);
+	const allowed = new Set(expected);
+	return expected.every((key) => key in value) && Object.keys(value).every((key) => allowed.has(key));
+}
+/** Require the named durable keys while admitting further optional members. */
+function hasExactKeysWithOptional(value, required, optional) {
+	const allowed = new Set([...required, ...optional]);
+	return required.every((key) => key in value) && Object.keys(value).every((key) => allowed.has(key));
+}
+/** Stable diagnostic for a title that is missing or empty after trimming. */
+const REQUIRED_TITLE_MESSAGE = "title is required and must be non-empty after trimming.";
+/**
+* Validate one required stored title at the durable boundary.
+*
+* Only records written after titles became required are read: a missing,
+* blank-after-trim, untrimmed, or over-long stored title is invalid, and no name
+* is derived from the instruction.
+* @param value - Untrusted durable title field.
+* @returns The stored title; an invalid title throws ScheduleLogError.
+*/
+function decodeStoredTitle(value) {
+	if (typeof value !== "string" || value.trim().length === 0) throw new ScheduleLogError(REQUIRED_TITLE_MESSAGE);
+	if (value.length > 120) throw new ScheduleLogError(`title must be at most 120 characters`);
+	if (value.trim() !== value) throw new ScheduleLogError("title must be a trimmed string");
+	return value;
+}
+/**
+* Decode the stored title of one historical `schedule/change` create record.
+*
+* A version-1 event written before names existed has no `title` member, so the
+* key set is required without it and the absent member decodes as undefined. A
+* present title stays subject to the canonical stored form.
+* @param value - Untrusted durable record already known to be an object.
+* @param expected - Exact keys the record may carry; `title` is optional within them.
+* @param message - Diagnostic naming the record's keys.
+* @returns The stored title, or undefined when the historical record predates it.
+*/
+function decodeHistoricalRecordTitle(value, expected, message) {
+	if (!hasExactKeysWithOptional(value, expected.filter((key) => key !== "title"), ["title"])) throw new ScheduleLogError(message);
+	return value["title"] === void 0 ? void 0 : decodeStoredTitle(value["title"]);
 }
 /** Validate one stable session-local id at the durable boundary. */
 function decodeId(value) {
@@ -48,13 +85,16 @@ function decodeInstant(value) {
 }
 /** Decode the exact v1 after record shape. */
 function decodeAfterRecord(value) {
-	if (!isRecord(value) || !hasExactKeys(value, [
+	/* v8 ignore next -- decodeLegacyScheduleRecord rejects a non-object before it dispatches here. */
+	if (!isRecord(value)) throw new ScheduleLogError("after schedule must be an object");
+	const title = decodeHistoricalRecordTitle(value, [
 		"id",
 		"kind",
+		"title",
 		"prompt",
 		"afterSeconds",
 		"scheduledAt"
-	])) throw new ScheduleLogError("after schedule must contain exactly id, kind, prompt, afterSeconds, and scheduledAt");
+	], "after schedule must contain exactly id, kind, title, prompt, afterSeconds, and scheduledAt");
 	const prompt = value["prompt"];
 	if (typeof prompt !== "string" || prompt.length === 0 || prompt.trim() !== prompt) throw new ScheduleLogError("after prompt must be non-empty and already trimmed");
 	const afterSeconds = value["afterSeconds"];
@@ -62,6 +102,7 @@ function decodeAfterRecord(value) {
 	return Object.freeze({
 		id: decodeId(value["id"]),
 		kind: "after",
+		...title === void 0 ? {} : { title },
 		prompt,
 		afterSeconds,
 		scheduledAt: decodeInstant(value["scheduledAt"])
@@ -69,45 +110,60 @@ function decodeAfterRecord(value) {
 }
 /** Decode the exact v1 absolute one-shot record shape. */
 function decodeAtRecord(value) {
-	if (!isRecord(value) || !hasExactKeys(value, [
+	/* v8 ignore next -- decodeLegacyScheduleRecord rejects a non-object before it dispatches here. */
+	if (!isRecord(value)) throw new ScheduleLogError("at schedule must be an object");
+	const title = decodeHistoricalRecordTitle(value, [
 		"id",
 		"kind",
+		"title",
 		"prompt",
 		"scheduledAt"
-	])) throw new ScheduleLogError("at schedule must contain exactly id, kind, prompt, and scheduledAt");
+	], "at schedule must contain exactly id, kind, title, prompt, and scheduledAt");
 	const prompt = value["prompt"];
 	if (typeof prompt !== "string" || prompt.length === 0 || prompt.trim() !== prompt) throw new ScheduleLogError("at prompt must be non-empty and already trimmed");
 	return Object.freeze({
 		id: decodeId(value["id"]),
 		kind: "at",
+		...title === void 0 ? {} : { title },
 		prompt,
 		scheduledAt: decodeInstant(value["scheduledAt"])
 	});
 }
 /** Decode the exact v1 fixed-rate record shape. */
 function decodeEveryRecord(value) {
-	if (!isRecord(value) || !hasExactKeys(value, [
+	/* v8 ignore next -- decodeLegacyScheduleRecord rejects a non-object before it dispatches here. */
+	if (!isRecord(value)) throw new ScheduleLogError("every schedule must be an object");
+	const title = decodeHistoricalRecordTitle(value, [
 		"id",
 		"kind",
+		"title",
 		"prompt",
 		"everySeconds",
 		"scheduledAt"
-	])) throw new ScheduleLogError("every schedule must contain exactly id, kind, prompt, everySeconds, and scheduledAt");
+	], "every schedule must contain exactly id, kind, title, prompt, everySeconds, and scheduledAt");
 	const prompt = value["prompt"];
 	if (typeof prompt !== "string" || prompt.length === 0 || prompt.trim() !== prompt) throw new ScheduleLogError("every prompt must be non-empty and already trimmed");
 	const everySeconds = value["everySeconds"];
 	const interval = typeof everySeconds === "number" ? everySeconds * 1e3 : NaN;
-	if (!Number.isSafeInteger(everySeconds) || everySeconds < 300 || !Number.isSafeInteger(interval)) throw new ScheduleLogError(`everySeconds must be a safe integer of at least 300`);
+	if (!Number.isSafeInteger(everySeconds) || everySeconds < 60 || !Number.isSafeInteger(interval)) throw new ScheduleLogError(`everySeconds must be a safe integer of at least 60`);
 	return Object.freeze({
 		id: decodeId(value["id"]),
 		kind: "every",
+		...title === void 0 ? {} : { title },
 		prompt,
 		everySeconds,
 		scheduledAt: decodeInstant(value["scheduledAt"])
 	});
 }
-/** Decode one current durable record variant by its exact discriminator. */
-function decodeScheduleRecord(value) {
+/**
+* Decode only the variants admitted by historical version-1 Session events.
+*
+* A record written before titles existed decodes without that member, so the
+* fold keeps reading a log that the current creation path could not write.
+* @param value - Untrusted durable JSON record from a Session event.
+* @returns Detached frozen record, without a title when the event omitted it.
+*/
+function decodeLegacyScheduleRecord(value) {
 	if (!isRecord(value)) throw new ScheduleLogError("schedule record must be an object");
 	switch (value["kind"]) {
 		case "after": return decodeAfterRecord(value);
@@ -134,7 +190,7 @@ function decodeScheduleChange(value) {
 			return Object.freeze({
 				version: 1,
 				operation: "create",
-				schedule: decodeScheduleRecord(value["schedule"])
+				schedule: decodeLegacyScheduleRecord(value["schedule"])
 			});
 		case "delete":
 			if (!hasExactKeys(value, [
@@ -212,9 +268,8 @@ function dispatchedRecord(record, change) {
 /**
 * Apply already-decoded Schedule changes to one complete fold value.
 *
-* This is the single transition authority shared by full-log replay and the
-* incremental Session projection. One mutable Map/Set pair spans the whole
-* batch; the returned arrays are materialized and frozen once.
+* The transition authority for full-log replay. One mutable Map/Set pair spans
+* the whole batch; the returned arrays are materialized and frozen once.
 * @param folded - complete active records and used-id history before the changes.
 * @param changes - strictly decoded durable mutations in log order.
 * @returns the complete fold value after every mutation.
@@ -285,7 +340,14 @@ function validate(events, fail) {
 		fail(error.message);
 	}
 }
-/** Install replay and pre-append validation for the owned event stream. */
+/**
+* Install replay and pre-append validation for the owned event stream.
+*
+* The durable task table is not asserted here: `scheduleDomain` validates every stored
+* record through its table schema when the domain opens, and its only writer stores each
+* task under `task.record.id`, so a check of the write payload would observe the same value
+* the writer had just built.
+*/
 const install = Object.assign((ctx, fail) => {
 	for (const session of ctx.sessions.list()) validate(session.ownEvents(), fail);
 	ctx.on("session/created", (session) => {

package/lib/typert.host.d.ts

@@ -0,0 +1,3 @@
+/* Generated by @deepseek-ai/dsh-typert-generator from FaceModel — do not edit. */
+
+export declare const TYPERT: unknown