@qilin-agent/schedule 0.0.0-stage → 3.1.4

package/lib/typert.remote-client.d.ts

@@ -0,0 +1,30 @@
+/* Generated by @qilin-agent/typert-generator from the Host FaceModel — do not edit. */
+import type {
+  RemoteResult,
+  TypertRemoteContribution,
+} from '@qilin-agent/typert-protocol'
+import type { ScheduleCatalogEntry, ScheduleDeleteRequest, ScheduleDeleteResult, ScheduleDeliveryHistoryRequest, ScheduleDeliveryHistoryResult, ScheduleListRequest, ScheduleRecord, ScheduleUpdateRequest, ScheduleUpdateResult } from '@qilin-agent/schedule/client'
+
+declare module '@qilin-agent/typert-protocol' {
+  interface TypertRemoteNamespace$7363686564756c65 {
+    catalog: () => Promise<RemoteResult<ScheduleCatalogEntry[]>>
+    delete: (request: ScheduleDeleteRequest, signal?: AbortSignal) => Promise<RemoteResult<ScheduleDeleteResult>>
+    history: (request: ScheduleDeliveryHistoryRequest) => Promise<RemoteResult<ScheduleDeliveryHistoryResult>>
+    list: (request: ScheduleListRequest) => Promise<RemoteResult<ScheduleRecord[]>>
+    update: (request: ScheduleUpdateRequest, signal?: AbortSignal) => Promise<RemoteResult<ScheduleUpdateResult>>
+  }
+  interface TypertRemoteMap {
+    'schedule/catalog': () => Promise<RemoteResult<ScheduleCatalogEntry[]>>
+    'schedule/delete': (request: ScheduleDeleteRequest, signal?: AbortSignal) => Promise<RemoteResult<ScheduleDeleteResult>>
+    'schedule/history': (request: ScheduleDeliveryHistoryRequest) => Promise<RemoteResult<ScheduleDeliveryHistoryResult>>
+    'schedule/list': (request: ScheduleListRequest) => Promise<RemoteResult<ScheduleRecord[]>>
+    'schedule/update': (request: ScheduleUpdateRequest, signal?: AbortSignal) => Promise<RemoteResult<ScheduleUpdateResult>>
+  }
+  interface TypertRemoteNamespaceMap {
+    'schedule': TypertRemoteNamespace$7363686564756c65
+  }
+}
+
+export declare const TYPERT_REMOTE: TypertRemoteContribution
+export default TYPERT_REMOTE
+//# sourceMappingURL=typert.remote-client.d.ts.map

package/lib/typert.remote-client.js

@@ -0,0 +1,480 @@
+/* Generated by @qilin-agent/typert-generator from the Host FaceModel — do not edit. */
+import { z } from 'zod'
+
+let _qilin_agent_schedule_schedule_catalog_result$schema$value
+const _qilin_agent_schedule_schedule_catalog_result$schema = () => (_qilin_agent_schedule_schedule_catalog_result$schema$value ??= z.array(z.union([z.intersection(z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'kind': z.literal("after").readonly(),
+  'title': z.string().readonly(),
+  'prompt': z.string().readonly(),
+  'afterSeconds': z.number().readonly(),
+  'scheduledAt': z.string().readonly(),
+}), z.object({
+  'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
+  'status': z.union([z.literal("active"), z.literal("inactive")]).readonly(),
+  'lastDelivery': z.object({
+  'scheduledAt': z.string().readonly(),
+  'deliveredAt': z.string().readonly(),
+  'messageId': z.intersection(z.string(), z.unknown()).readonly(),
+}).readonly().optional(),
+})), z.intersection(z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'kind': z.literal("at").readonly(),
+  'title': z.string().readonly(),
+  'prompt': z.string().readonly(),
+  'scheduledAt': z.string().readonly(),
+}), z.object({
+  'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
+  'status': z.union([z.literal("active"), z.literal("inactive")]).readonly(),
+  'lastDelivery': z.object({
+  'scheduledAt': z.string().readonly(),
+  'deliveredAt': z.string().readonly(),
+  'messageId': z.intersection(z.string(), z.unknown()).readonly(),
+}).readonly().optional(),
+})), z.intersection(z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'kind': z.literal("every").readonly(),
+  'title': z.string().readonly(),
+  'prompt': z.string().readonly(),
+  'everySeconds': z.number().readonly(),
+  'scheduledAt': z.string().readonly(),
+}), z.object({
+  'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
+  'status': z.union([z.literal("active"), z.literal("inactive")]).readonly(),
+  'lastDelivery': z.object({
+  'scheduledAt': z.string().readonly(),
+  'deliveredAt': z.string().readonly(),
+  'messageId': z.intersection(z.string(), z.unknown()).readonly(),
+}).readonly().optional(),
+})), z.intersection(z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'kind': z.literal("daily").readonly(),
+  'title': z.string().readonly(),
+  'prompt': z.string().readonly(),
+  'time': z.string().readonly(),
+  'timeZone': z.string().readonly(),
+  'scheduledAt': z.string().readonly(),
+}), z.object({
+  'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
+  'status': z.union([z.literal("active"), z.literal("inactive")]).readonly(),
+  'lastDelivery': z.object({
+  'scheduledAt': z.string().readonly(),
+  'deliveredAt': z.string().readonly(),
+  'messageId': z.intersection(z.string(), z.unknown()).readonly(),
+}).readonly().optional(),
+})), z.intersection(z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'kind': z.literal("weekly").readonly(),
+  'title': z.string().readonly(),
+  'prompt': z.string().readonly(),
+  'time': z.string().readonly(),
+  'timeZone': z.string().readonly(),
+  'weekdays': z.array(z.number()).readonly(),
+  'scheduledAt': z.string().readonly(),
+}), z.object({
+  'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
+  'status': z.union([z.literal("active"), z.literal("inactive")]).readonly(),
+  'lastDelivery': z.object({
+  'scheduledAt': z.string().readonly(),
+  'deliveredAt': z.string().readonly(),
+  'messageId': z.intersection(z.string(), z.unknown()).readonly(),
+}).readonly().optional(),
+})), z.intersection(z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'kind': z.literal("cron").readonly(),
+  'title': z.string().readonly(),
+  'prompt': z.string().readonly(),
+  'expression': z.string().readonly(),
+  'timeZone': z.string().readonly(),
+  'scheduledAt': z.string().readonly(),
+}), z.object({
+  'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
+  'status': z.union([z.literal("active"), z.literal("inactive")]).readonly(),
+  'lastDelivery': z.object({
+  'scheduledAt': z.string().readonly(),
+  'deliveredAt': z.string().readonly(),
+  'messageId': z.intersection(z.string(), z.unknown()).readonly(),
+}).readonly().optional(),
+}))])))
+let _qilin_agent_schedule_schedule_delete_parameter_0$schema$value
+const _qilin_agent_schedule_schedule_delete_parameter_0$schema = () => (_qilin_agent_schedule_schedule_delete_parameter_0$schema$value ??= z.object({
+  'id': z.intersection(z.string(), z.unknown()),
+  'sessionId': z.intersection(z.string(), z.unknown()),
+}))
+let _qilin_agent_schedule_schedule_delete_result$schema$value
+const _qilin_agent_schedule_schedule_delete_result$schema = () => (_qilin_agent_schedule_schedule_delete_result$schema$value ??= z.union([z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'deleted': z.literal(true).readonly(),
+}), z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'deleted': z.literal(false).readonly(),
+  'code': z.literal("schedule_not_found").readonly(),
+})]))
+let _qilin_agent_schedule_schedule_history_parameter_0$schema$value
+const _qilin_agent_schedule_schedule_history_parameter_0$schema = () => (_qilin_agent_schedule_schedule_history_parameter_0$schema$value ??= z.object({
+  'limit': z.number(),
+  'before': z.intersection(z.string(), z.unknown()).optional(),
+  'id': z.intersection(z.string(), z.unknown()),
+  'sessionId': z.intersection(z.string(), z.unknown()),
+}))
+let _qilin_agent_schedule_schedule_history_result$schema$value
+const _qilin_agent_schedule_schedule_history_result$schema = () => (_qilin_agent_schedule_schedule_history_result$schema$value ??= z.union([z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'records': z.array(z.object({
+  'prompt': z.string().readonly().optional(),
+  'scheduledAt': z.string().readonly(),
+  'deliveredAt': z.string().readonly(),
+  'messageId': z.intersection(z.string(), z.unknown()).readonly(),
+})).readonly(),
+  'earlierRecordsUnavailable': z.boolean().readonly(),
+  'earlierRecordsPruned': z.boolean().readonly(),
+  'retention': z.object({
+  'days': z.number().readonly(),
+  'records': z.number().readonly(),
+}).readonly(),
+  'nextBefore': z.intersection(z.string(), z.unknown()).readonly().optional(),
+}), z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'code': z.union([z.literal("schedule_not_found"), z.literal("delivery_cursor_not_found")]).readonly(),
+})]))
+let _qilin_agent_schedule_schedule_list_parameter_0$schema$value
+const _qilin_agent_schedule_schedule_list_parameter_0$schema = () => (_qilin_agent_schedule_schedule_list_parameter_0$schema$value ??= z.object({
+  'sessionId': z.intersection(z.string(), z.unknown()),
+}))
+let _qilin_agent_schedule_schedule_list_result$schema$value
+const _qilin_agent_schedule_schedule_list_result$schema = () => (_qilin_agent_schedule_schedule_list_result$schema$value ??= z.array(z.union([z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'kind': z.literal("after").readonly(),
+  'title': z.string().readonly(),
+  'prompt': z.string().readonly(),
+  'afterSeconds': z.number().readonly(),
+  'scheduledAt': z.string().readonly(),
+}), z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'kind': z.literal("at").readonly(),
+  'title': z.string().readonly(),
+  'prompt': z.string().readonly(),
+  'scheduledAt': z.string().readonly(),
+}), z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'kind': z.literal("every").readonly(),
+  'title': z.string().readonly(),
+  'prompt': z.string().readonly(),
+  'everySeconds': z.number().readonly(),
+  'scheduledAt': z.string().readonly(),
+}), z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'kind': z.literal("daily").readonly(),
+  'title': z.string().readonly(),
+  'prompt': z.string().readonly(),
+  'time': z.string().readonly(),
+  'timeZone': z.string().readonly(),
+  'scheduledAt': z.string().readonly(),
+}), z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'kind': z.literal("weekly").readonly(),
+  'title': z.string().readonly(),
+  'prompt': z.string().readonly(),
+  'time': z.string().readonly(),
+  'timeZone': z.string().readonly(),
+  'weekdays': z.array(z.number()).readonly(),
+  'scheduledAt': z.string().readonly(),
+}), z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'kind': z.literal("cron").readonly(),
+  'title': z.string().readonly(),
+  'prompt': z.string().readonly(),
+  'expression': z.string().readonly(),
+  'timeZone': z.string().readonly(),
+  'scheduledAt': z.string().readonly(),
+})])))
+let _qilin_agent_schedule_schedule_update_parameter_0$schema$value
+const _qilin_agent_schedule_schedule_update_parameter_0$schema = () => (_qilin_agent_schedule_schedule_update_parameter_0$schema$value ??= z.object({
+  'expected': z.union([z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'kind': z.literal("after").readonly(),
+  'title': z.string().readonly(),
+  'prompt': z.string().readonly(),
+  'afterSeconds': z.number().readonly(),
+  'scheduledAt': z.string().readonly(),
+}), z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'kind': z.literal("at").readonly(),
+  'title': z.string().readonly(),
+  'prompt': z.string().readonly(),
+  'scheduledAt': z.string().readonly(),
+}), z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'kind': z.literal("every").readonly(),
+  'title': z.string().readonly(),
+  'prompt': z.string().readonly(),
+  'everySeconds': z.number().readonly(),
+  'scheduledAt': z.string().readonly(),
+}), z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'kind': z.literal("daily").readonly(),
+  'title': z.string().readonly(),
+  'prompt': z.string().readonly(),
+  'time': z.string().readonly(),
+  'timeZone': z.string().readonly(),
+  'scheduledAt': z.string().readonly(),
+}), z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'kind': z.literal("weekly").readonly(),
+  'title': z.string().readonly(),
+  'prompt': z.string().readonly(),
+  'time': z.string().readonly(),
+  'timeZone': z.string().readonly(),
+  'weekdays': z.array(z.number()).readonly(),
+  'scheduledAt': z.string().readonly(),
+}), z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'kind': z.literal("cron").readonly(),
+  'title': z.string().readonly(),
+  'prompt': z.string().readonly(),
+  'expression': z.string().readonly(),
+  'timeZone': z.string().readonly(),
+  'scheduledAt': z.string().readonly(),
+})]).readonly(),
+  'change': z.union([z.object({
+  'kind': z.literal("at").readonly(),
+  'at': z.union([z.string(), z.object({
+  'date': z.string().readonly(),
+  'time': z.string().readonly(),
+  'time_zone': z.string().readonly(),
+})]).readonly(),
+}), z.object({
+  'kind': z.literal("every").readonly(),
+  'every_seconds': z.number().readonly(),
+}), z.object({
+  'kind': z.literal("daily").readonly(),
+  'daily': z.object({
+  'time': z.string().readonly(),
+  'time_zone': z.string().readonly(),
+}).readonly(),
+}), z.object({
+  'kind': z.literal("weekly").readonly(),
+  'weekly': z.object({
+  'time': z.string().readonly(),
+  'time_zone': z.string().readonly(),
+  'weekdays': z.array(z.number()).readonly(),
+}).readonly(),
+}), z.object({
+  'kind': z.literal("cron").readonly(),
+  'cron': z.object({
+  'expression': z.string().readonly(),
+  'time_zone': z.string().readonly(),
+}).readonly(),
+})]).readonly().optional(),
+  'id': z.intersection(z.string(), z.unknown()),
+  'sessionId': z.intersection(z.string(), z.unknown()),
+  'title': z.string().readonly().optional(),
+  'prompt': z.string().readonly().optional(),
+}))
+let _qilin_agent_schedule_schedule_update_result$schema$value
+const _qilin_agent_schedule_schedule_update_result$schema = () => (_qilin_agent_schedule_schedule_update_result$schema$value ??= z.union([z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'updated': z.boolean().readonly(),
+  'record': z.union([z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'kind': z.literal("after").readonly(),
+  'title': z.string().readonly(),
+  'prompt': z.string().readonly(),
+  'afterSeconds': z.number().readonly(),
+  'scheduledAt': z.string().readonly(),
+}), z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'kind': z.literal("at").readonly(),
+  'title': z.string().readonly(),
+  'prompt': z.string().readonly(),
+  'scheduledAt': z.string().readonly(),
+}), z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'kind': z.literal("every").readonly(),
+  'title': z.string().readonly(),
+  'prompt': z.string().readonly(),
+  'everySeconds': z.number().readonly(),
+  'scheduledAt': z.string().readonly(),
+}), z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'kind': z.literal("daily").readonly(),
+  'title': z.string().readonly(),
+  'prompt': z.string().readonly(),
+  'time': z.string().readonly(),
+  'timeZone': z.string().readonly(),
+  'scheduledAt': z.string().readonly(),
+}), z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'kind': z.literal("weekly").readonly(),
+  'title': z.string().readonly(),
+  'prompt': z.string().readonly(),
+  'time': z.string().readonly(),
+  'timeZone': z.string().readonly(),
+  'weekdays': z.array(z.number()).readonly(),
+  'scheduledAt': z.string().readonly(),
+}), z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'kind': z.literal("cron").readonly(),
+  'title': z.string().readonly(),
+  'prompt': z.string().readonly(),
+  'expression': z.string().readonly(),
+  'timeZone': z.string().readonly(),
+  'scheduledAt': z.string().readonly(),
+})]).readonly(),
+}), z.object({
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'updated': z.literal(false).readonly(),
+  'code': z.union([z.literal("schedule_not_found"), z.literal("schedule_ended"), z.literal("schedule_conflict")]).readonly(),
+}), z.object({
+  'code': z.literal("invalid_prompt").readonly(),
+  'message': z.string().readonly(),
+}), z.object({
+  'code': z.literal("invalid_selector").readonly(),
+  'message': z.string().readonly(),
+}), z.object({
+  'code': z.literal("invalid_rule").readonly(),
+  'message': z.string().readonly(),
+}), z.object({
+  'code': z.literal("invalid_time_zone").readonly(),
+  'message': z.string().readonly(),
+}), z.object({
+  'code': z.literal("not_future").readonly(),
+  'message': z.string().readonly(),
+}), z.object({
+  'code': z.literal("time_out_of_range").readonly(),
+  'message': z.string().readonly(),
+}), z.object({
+  'code': z.literal("frequency_too_high").readonly(),
+  'message': z.string().readonly(),
+}), z.object({
+  'code': z.literal("subagent_session").readonly(),
+  'message': z.string().readonly(),
+}), z.object({
+  'code': z.literal("internal_error").readonly(),
+  'message': z.string().readonly(),
+})]))
+
+export const TYPERT_REMOTE = {
+  package: '@qilin-agent/schedule',
+  descriptors: [
+    {
+      id: '@qilin-agent/schedule#schedule/catalog',
+      service: 'schedule',
+      namespace: 'schedule',
+      method: 'catalog',
+      invocation: { kind: 'direct' },
+      parameters: [
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@qilin-agent/schedule#schedule/catalog:result',
+        create: _qilin_agent_schedule_schedule_catalog_result$schema,
+      },
+      sourceLocation: {"file":"packages/schedule/schedule/src/index.ts","line":281,"column":9},
+    },
+    {
+      id: '@qilin-agent/schedule#schedule/delete',
+      service: 'schedule',
+      namespace: 'schedule',
+      method: 'delete',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          wire: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@qilin-agent/schedule/client#ScheduleDeleteRequest',
+            create: _qilin_agent_schedule_schedule_delete_parameter_0$schema,
+          },
+        },
+      ],
+      cancellation: { parameter: 'signal' },
+      result: {
+        mode: 'strict',
+        typeSymbol: '@qilin-agent/schedule/client#ScheduleDeleteResult',
+        create: _qilin_agent_schedule_schedule_delete_result$schema,
+      },
+      sourceLocation: {"file":"packages/schedule/schedule/src/index.ts","line":320,"column":9},
+    },
+    {
+      id: '@qilin-agent/schedule#schedule/history',
+      service: 'schedule',
+      namespace: 'schedule',
+      method: 'history',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          wire: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@qilin-agent/schedule/client#ScheduleDeliveryHistoryRequest',
+            create: _qilin_agent_schedule_schedule_history_parameter_0$schema,
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@qilin-agent/schedule/client#ScheduleDeliveryHistoryResult',
+        create: _qilin_agent_schedule_schedule_history_result$schema,
+      },
+      sourceLocation: {"file":"packages/schedule/schedule/src/index.ts","line":299,"column":9},
+    },
+    {
+      id: '@qilin-agent/schedule#schedule/list',
+      service: 'schedule',
+      namespace: 'schedule',
+      method: 'list',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          wire: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@qilin-agent/schedule/client#ScheduleListRequest',
+            create: _qilin_agent_schedule_schedule_list_parameter_0$schema,
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@qilin-agent/schedule#schedule/list:result',
+        create: _qilin_agent_schedule_schedule_list_result$schema,
+      },
+      sourceLocation: {"file":"packages/schedule/schedule/src/index.ts","line":267,"column":9},
+    },
+    {
+      id: '@qilin-agent/schedule#schedule/update',
+      service: 'schedule',
+      namespace: 'schedule',
+      method: 'update',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          wire: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@qilin-agent/schedule/client#ScheduleUpdateRequest',
+            create: _qilin_agent_schedule_schedule_update_parameter_0$schema,
+          },
+        },
+      ],
+      cancellation: { parameter: 'signal' },
+      result: {
+        mode: 'strict',
+        typeSymbol: '@qilin-agent/schedule/client#ScheduleUpdateResult',
+        create: _qilin_agent_schedule_schedule_update_result$schema,
+      },
+      sourceLocation: {"file":"packages/schedule/schedule/src/index.ts","line":347,"column":9},
+    },
+  ],
+}
+
+export default TYPERT_REMOTE

package/lib/types/client.d.ts

@@ -0,0 +1,3 @@
+/** Browser-safe Schedule vocabulary. @module @qilin-agent/schedule/client */
+export type * from './types.ts';
+//# sourceMappingURL=client.d.ts.map

package/lib/types/client.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client.js.map

package/lib/types/delivery-history.d.ts

@@ -0,0 +1,24 @@
+/** Saved delivery interpretation and identity-based pagination without Session reads. */
+import type { ScheduleTask } from './storage.ts';
+import type { DeliveryRetentionBounds, ScheduleDeliveryHistoryRequest, ScheduleDeliveryHistoryResult, ScheduleDeliveryReceipt } from './types.ts';
+/**
+ * Prepare one real inbox acknowledgment for the same task write as its status and target.
+ * Prunes to the configured window and record cap here, on the only write path: the
+ * domain publishes one whole-unit document per write, so an unbounded array would
+ * grow that document with every acknowledgment. The read path states no bound of
+ * its own, because a whole-unit document over the schema's limits refuses to open.
+ * @param task - Task supplying the immutable sent prompt and retained history.
+ * @param receipt - Acknowledgment obtained after successful Session flush.
+ * @param bounds - Configured retention window and record cap for the appended history.
+ * @returns Receipt and retained history; the caller publishes them only after task persistence.
+ */
+export declare function appendDelivery(task: ScheduleTask, receipt: ScheduleDeliveryReceipt, bounds: DeliveryRetentionBounds): Required<Pick<ScheduleTask, 'lastDelivery' | 'deliveryHistory'>>;
+/**
+ * Read one newest-first page in append order, independent of wall-clock ordering.
+ * @param task - Task already checked against the requested Session binding.
+ * @param request - Validated explicit page size and optional exclusive message cursor.
+ * @param retention - Current configured limits shared with the delivery writer.
+ * @returns Copied delivery records or a cursor-not-found result.
+ */
+export declare function deliveryHistoryPage(task: ScheduleTask, request: ScheduleDeliveryHistoryRequest, retention: DeliveryRetentionBounds): ScheduleDeliveryHistoryResult;
+//# sourceMappingURL=delivery-history.d.ts.map

package/lib/types/delivery-history.js

@@ -0,0 +1,66 @@
+/** Milliseconds in one day, the unit the retention window is stated in. */
+const DAY_MS = 86_400_000;
+/**
+ * Read retained history; missing history exposes only the actual legacy receipt.
+ * @param task - Immutable stored task.
+ * @returns Oldest-first retained deliveries without changing storage.
+ */
+function deliveryHistoryOf(task) {
+    return task.deliveryHistory ?? {
+        records: task.lastDelivery === undefined ? [] : [task.lastDelivery],
+        earlierRecordsUnavailable: true,
+    };
+}
+/**
+ * Prepare one real inbox acknowledgment for the same task write as its status and target.
+ * Prunes to the configured window and record cap here, on the only write path: the
+ * domain publishes one whole-unit document per write, so an unbounded array would
+ * grow that document with every acknowledgment. The read path states no bound of
+ * its own, because a whole-unit document over the schema's limits refuses to open.
+ * @param task - Task supplying the immutable sent prompt and retained history.
+ * @param receipt - Acknowledgment obtained after successful Session flush.
+ * @param bounds - Configured retention window and record cap for the appended history.
+ * @returns Receipt and retained history; the caller publishes them only after task persistence.
+ */
+export function appendDelivery(task, receipt, bounds) {
+    const history = deliveryHistoryOf(task);
+    const appended = [...history.records, { ...receipt, prompt: task.record.prompt }];
+    const floor = Date.parse(receipt.deliveredAt) - bounds.days * DAY_MS;
+    const retained = appended
+        .filter(record => Date.parse(record.deliveredAt) >= floor)
+        .slice(-bounds.records);
+    return {
+        lastDelivery: receipt,
+        deliveryHistory: {
+            records: retained,
+            earlierRecordsUnavailable: history.earlierRecordsUnavailable || retained.length !== appended.length,
+            earlierRecordsPruned: history.earlierRecordsPruned === true || retained.length !== appended.length,
+        },
+    };
+}
+/**
+ * Read one newest-first page in append order, independent of wall-clock ordering.
+ * @param task - Task already checked against the requested Session binding.
+ * @param request - Validated explicit page size and optional exclusive message cursor.
+ * @param retention - Current configured limits shared with the delivery writer.
+ * @returns Copied delivery records or a cursor-not-found result.
+ */
+export function deliveryHistoryPage(task, request, retention) {
+    const history = deliveryHistoryOf(task);
+    const end = request.before === undefined
+        ? history.records.length
+        : history.records.findIndex(record => record.messageId === request.before);
+    if (end === -1)
+        return { id: request.id, code: 'delivery_cursor_not_found' };
+    const start = Math.max(0, end - request.limit);
+    const records = history.records.slice(start, end).reverse().map(({ prompt, ...receipt }) => ({
+        ...receipt, ...(prompt === undefined ? {} : { prompt }),
+    }));
+    const oldest = records.at(-1);
+    return {
+        id: request.id, records, earlierRecordsUnavailable: history.earlierRecordsUnavailable,
+        earlierRecordsPruned: history.earlierRecordsPruned === true, retention: { ...retention },
+        ...(oldest !== undefined && start > 0 ? { nextBefore: oldest.messageId } : {}),
+    };
+}
+//# sourceMappingURL=delivery-history.js.map