@moxxy/sdk 0.44.0 → 0.46.0

package/dist/client-session.d.ts

@@ -3,7 +3,8 @@ import type { CommandDef } from './command.js';
 import type { ModeDef } from './mode.js';
 import type { LLMProvider, ProviderDef } from './provider.js';
 import type { RequirementCheck, MoxxyRequirement } from './requirements.js';
-import type { SessionLike, SessionLogReader } from './session-like.js';
+import type { StandingAllowRule } from './permission.js';
+import type { SessionInfo, SessionLike, SessionLogReader } from './session-like.js';
 import type { Skill } from './skill.js';
 import type { ToolDef } from './tool.js';
 import type { Transcriber } from './transcriber.js';
@@ -69,10 +70,7 @@ export interface RequirementsClientView {
     check(requirements: ReadonlyArray<MoxxyRequirement>): RequirementCheck;
 }
 export interface PermissionsClientView {
-    addAllow(rule: {
-        readonly name: string;
-        readonly reason?: string;
-    }): Promise<void>;
+    addAllow(rule: StandingAllowRule): Promise<void>;
 }
 export interface ClientSession extends SessionLike {
     /** The mirror/real log, plus `clear()` for `/new`. */
@@ -92,5 +90,11 @@ export interface ClientSession extends SessionLike {
     /** Switch the conversation's auto-approve (read it from `getInfo().autoApprove`).
      *  Optional: a client of a runner without the shared switch has none. */
     setAutoApprove?(enabled: boolean): Promise<void>;
+    /** Stop one work the agent runs in the background (`AgentBackgroundWork.id`); `false` when it runs none such.
+     *  Optional: a client of a runner that cannot pass it on has none. */
+    stopBackgroundWork?(workId: string): Promise<boolean>;
+    /** Called with the new info when it changes outside a turn (e.g. an agent CLI
+     *  was found outdated); returns the unsubscribe. */
+    onInfoChanged?(listener: (info: SessionInfo) => void): () => void;
 }
 //# sourceMappingURL=client-session.d.ts.map

package/dist/client-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client-session.d.ts","sourceRoot":"","sources":["../src/client-session.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client-session.d.ts","sourceRoot":"","sources":["../src/client-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACpF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,mBAAmB;IAClC,SAAS,IAAI,WAAW,CAAC;IACzB,aAAa,IAAI,MAAM,GAAG,IAAI,CAAC;IAC/B,IAAI,IAAI,aAAa,CAAC,WAAW,CAAC,CAAC;IACnC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,CAAC;IACvE,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CACzD;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/B,SAAS,IAAI,OAAO,CAAC;IACrB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CACxC;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IAC1C,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,IAAI,aAAa,CAAC,QAAQ,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa,IAAI,MAAM,GAAG,IAAI,CAAC;IAC/B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,SAAS,IAAI,WAAW,CAAC;IACzB,0EAA0E;IAC1E,YAAY,IAAI,WAAW,GAAG,IAAI,CAAC;IACnC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,CAAC;CACxE;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa,IAAI,MAAM,GAAG,IAAI,CAAC;IAC/B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,SAAS,IAAI,WAAW,CAAC;IACzB,6EAA6E;IAC7E,YAAY,IAAI,WAAW,GAAG,IAAI,CAAC;IACnC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,CAAC;CACxE;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,YAAY,EAAE,aAAa,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CAAC;CACxE;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,aAAc,SAAQ,WAAW;IAChD,sDAAsD;IACtD,QAAQ,CAAC,GAAG,EAAE,gBAAgB,GAAG;QAAE,KAAK,IAAI,IAAI,CAAA;KAAE,CAAC;IACnD,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,sBAAsB,CAAC;IAC9C,QAAQ,CAAC,YAAY,EAAE,sBAAsB,CAAC;IAC9C,QAAQ,CAAC,YAAY,EAAE,sBAAsB,CAAC;IAC9C,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC;IAC5C;6EACyE;IACzE,cAAc,CAAC,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD;0EACsE;IACtE,kBAAkB,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtD;wDACoD;IACpD,aAAa,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACnE"}

package/dist/computer-control.d.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import { z } from 'zod/v3';
 export declare const computerControlStateSchema: z.ZodEnum<["idle", "background", "foreground", "waiting_for_focus", "paused_by_user", "recovering", "stopped", "failed"]>;
 export declare const computerControlOwnerSchema: z.ZodObject<{
     sessionId: z.ZodString;
@@ -33,11 +33,11 @@ export declare const computerCursorSchema: z.ZodObject<{
     x: z.ZodNumber;
     y: z.ZodNumber;
 }, "strict", z.ZodTypeAny, {
-    phase: "idle" | "failed" | "moving" | "executing" | "delivered";
+    phase: "failed" | "idle" | "moving" | "executing" | "delivered";
     x: number;
     y: number;
 }, {
-    phase: "idle" | "failed" | "moving" | "executing" | "delivered";
+    phase: "failed" | "idle" | "moving" | "executing" | "delivered";
     x: number;
     y: number;
 }>;
@@ -64,11 +64,11 @@ export declare const computerControlSnapshotSchema: z.ZodObject<{
         x: z.ZodNumber;
         y: z.ZodNumber;
     }, "strict", z.ZodTypeAny, {
-        phase: "idle" | "failed" | "moving" | "executing" | "delivered";
+        phase: "failed" | "idle" | "moving" | "executing" | "delivered";
         x: number;
         y: number;
     }, {
-        phase: "idle" | "failed" | "moving" | "executing" | "delivered";
+        phase: "failed" | "idle" | "moving" | "executing" | "delivered";
         x: number;
         y: number;
     }>>;
@@ -84,11 +84,11 @@ export declare const computerControlSnapshotSchema: z.ZodObject<{
     }>>;
 }, "strict", z.ZodTypeAny, {
     sessionId: string;
+    state: "failed" | "stopped" | "idle" | "background" | "foreground" | "waiting_for_focus" | "paused_by_user" | "recovering";
     turnId: string;
-    state: "stopped" | "idle" | "background" | "foreground" | "waiting_for_focus" | "paused_by_user" | "recovering" | "failed";
     windowId: string | null;
     cursor?: {
-        phase: "idle" | "failed" | "moving" | "executing" | "delivered";
+        phase: "failed" | "idle" | "moving" | "executing" | "delivered";
         x: number;
         y: number;
     } | undefined;
@@ -98,11 +98,11 @@ export declare const computerControlSnapshotSchema: z.ZodObject<{
     } | undefined;
 }, {
     sessionId: string;
+    state: "failed" | "stopped" | "idle" | "background" | "foreground" | "waiting_for_focus" | "paused_by_user" | "recovering";
     turnId: string;
-    state: "stopped" | "idle" | "background" | "foreground" | "waiting_for_focus" | "paused_by_user" | "recovering" | "failed";
     windowId: string | null;
     cursor?: {
-        phase: "idle" | "failed" | "moving" | "executing" | "delivered";
+        phase: "failed" | "idle" | "moving" | "executing" | "delivered";
         x: number;
         y: number;
     } | undefined;
@@ -125,16 +125,16 @@ export declare const computerApprovalFocusSchema: z.ZodObject<{
     approved: z.ZodBoolean;
 }, "strict", z.ZodTypeAny, {
     sessionId: string;
-    turnId: string;
     callId: string;
+    turnId: string;
     windowId: string;
     hostPid: number;
     stage: "begin" | "finish";
     approved: boolean;
 }, {
     sessionId: string;
-    turnId: string;
     callId: string;
+    turnId: string;
     windowId: string;
     hostPid: number;
     stage: "begin" | "finish";

package/dist/computer-control.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"computer-control.d.ts","sourceRoot":"","sources":["../src/computer-control.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,0BAA0B,2HAGrC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;EAA+D,CAAC;AACvG,oGAAoG;AACpG,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;EAE9B,CAAC;AACZ,mFAAmF;AACnF,eAAO,MAAM,yBAAyB,mEAAiE,CAAC;AAExG,wGAAwG;AACxG,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAAoF,CAAC;AACtH,0GAA0G;AAC1G,eAAO,MAAM,oBAAoB;;;;;;;;;EAA+E,CAAC;AACjH,eAAO,MAAM,6BAA6B;;;;;;IAGxC,sGAAsG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAG7F,CAAC;AAEZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;EAG7B,CAAC;AACZ,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AACpF,MAAM,WAAW,sBAAsB;IACrC,aAAa,CAAC,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,6DAA6D;IAC7D,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC,uBAAuB,CAAC,CAAC,CAAC;IAC5D,2EAA2E;IAC3E,OAAO,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,uGAAuG;IACvG,SAAS,CAAC,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,uBAAuB,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC3F"}
+{"version":3,"file":"computer-control.d.ts","sourceRoot":"","sources":["../src/computer-control.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,eAAO,MAAM,0BAA0B,2HAGrC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;EAA+D,CAAC;AACvG,oGAAoG;AACpG,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;EAE9B,CAAC;AACZ,mFAAmF;AACnF,eAAO,MAAM,yBAAyB,mEAAiE,CAAC;AAExG,wGAAwG;AACxG,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAAoF,CAAC;AACtH,0GAA0G;AAC1G,eAAO,MAAM,oBAAoB;;;;;;;;;EAA+E,CAAC;AACjH,eAAO,MAAM,6BAA6B;;;;;;IAGxC,sGAAsG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAG7F,CAAC;AAEZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;EAG7B,CAAC;AACZ,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AACpF,MAAM,WAAW,sBAAsB;IACrC,aAAa,CAAC,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,6DAA6D;IAC7D,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC,uBAAuB,CAAC,CAAC,CAAC;IAC5D,2EAA2E;IAC3E,OAAO,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,uGAAuG;IACvG,SAAS,CAAC,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,uBAAuB,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC3F"}

package/dist/computer-control.js

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import { z } from 'zod/v3';
 export const computerControlStateSchema = z.enum([
     'idle', 'background', 'foreground', 'waiting_for_focus',
     'paused_by_user', 'recovering', 'stopped', 'failed',

package/dist/computer-control.js.map

@@ -1 +1 @@
-{"version":3,"file":"computer-control.js","sourceRoot":"","sources":["../src/computer-control.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,IAAI,CAAC;IAC/C,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,mBAAmB;IACvD,gBAAgB,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ;CACpD,CAAC,CAAC;AACH,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC5C,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AACvG,oGAAoG;AACpG,MAAM,CAAC,MAAM,4BAA4B,GAAG,0BAA0B,CAAC,MAAM,CAAC;IAC5E,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;CACzD,CAAC,CAAC,MAAM,EAAE,CAAC;AACZ,mFAAmF;AACnF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;AACxG,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAC1C,wGAAwG;AACxG,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AACtH,0GAA0G;AAC1G,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AACjH,MAAM,CAAC,MAAM,6BAA6B,GAAG,0BAA0B,CAAC,MAAM,CAAC;IAC7E,KAAK,EAAE,0BAA0B;IACjC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE;IAC7B,sGAAsG;IACtG,MAAM,EAAE,oBAAoB,CAAC,QAAQ,EAAE;IACvC,MAAM,EAAE,oBAAoB,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC,MAAM,EAAE,CAAC;AAKZ,MAAM,CAAC,MAAM,2BAA2B,GAAG,0BAA0B,CAAC,MAAM,CAAC;IAC3E,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC;IACtF,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;CAC1D,CAAC,CAAC,MAAM,EAAE,CAAC"}
+{"version":3,"file":"computer-control.js","sourceRoot":"","sources":["../src/computer-control.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,IAAI,CAAC;IAC/C,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,mBAAmB;IACvD,gBAAgB,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ;CACpD,CAAC,CAAC;AACH,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC5C,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AACvG,oGAAoG;AACpG,MAAM,CAAC,MAAM,4BAA4B,GAAG,0BAA0B,CAAC,MAAM,CAAC;IAC5E,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;CACzD,CAAC,CAAC,MAAM,EAAE,CAAC;AACZ,mFAAmF;AACnF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;AACxG,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAC1C,wGAAwG;AACxG,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AACtH,0GAA0G;AAC1G,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AACjH,MAAM,CAAC,MAAM,6BAA6B,GAAG,0BAA0B,CAAC,MAAM,CAAC;IAC7E,KAAK,EAAE,0BAA0B;IACjC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE;IAC7B,sGAAsG;IACtG,MAAM,EAAE,oBAAoB,CAAC,QAAQ,EAAE;IACvC,MAAM,EAAE,oBAAoB,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC,MAAM,EAAE,CAAC;AAKZ,MAAM,CAAC,MAAM,2BAA2B,GAAG,0BAA0B,CAAC,MAAM,CAAC;IAC3E,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC;IACtF,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;CAC1D,CAAC,CAAC,MAAM,EAAE,CAAC"}

package/dist/conversation-history.d.ts

@@ -0,0 +1,50 @@
+import type { TurnId } from './ids.js';
+import type { EventLogReader } from './log.js';
+/**
+ * The conversation as Moxxy keeps it, turn by turn, read straight from the log
+ * (never from summaries). An agent connection whose own session is gone, or
+ * that joins a conversation partway, starts from it, and `recall` searches it.
+ */
+export interface ConversationTurn {
+    /** 1-based, in the order the turns ran; stable, since earlier turns never change. */
+    readonly number: number;
+    readonly turnId: TurnId;
+    /** What the person (or a trigger acting for them) said. */
+    readonly said: ReadonlyArray<string>;
+    /** Names of what came with it: files, images, documents. */
+    readonly attached: ReadonlyArray<string>;
+    /** The agent's messages, in order. */
+    readonly replies: ReadonlyArray<string>;
+    /** Tools the agent ran, each as its name and the gist of its input. */
+    readonly tools: ReadonlyArray<string>;
+    /** Everything above as one text, with full tool inputs, for searching. */
+    readonly text: string;
+}
+export interface ConversationMatch {
+    readonly turn: ConversationTurn;
+    /** Lines of the turn around the words that matched. */
+    readonly snippets: ReadonlyArray<string>;
+}
+/** About 16k tokens, as much as one turn of most conversations is worth handing over. */
+export declare const EARLIER_CONVERSATION_CHARS = 64000;
+/** The turns of the conversation that the person started, in order. */
+export declare function conversationTurns(log: EventLogReader): ConversationTurn[];
+/**
+ * What a new agent session gets of the turns before `currentTurnId`: the
+ * latest turns word for word, a line for each older one, and how to search
+ * the rest. `undefined` when no turn came before.
+ */
+export declare function renderEarlierConversation(log: EventLogReader, currentTurnId: TurnId, budgetChars?: number): string | undefined;
+/**
+ * What an agent coming back to the conversation gets of the turns that ran on
+ * another connection (another agent, a model API) since its own last turn, in
+ * the same form. `undefined` when it never ran here (a new session of its own
+ * gets the whole conversation instead) or missed nothing.
+ */
+export declare function renderMissedTurns(log: EventLogReader, provider: string, currentTurnId: TurnId, budgetChars?: number): string | undefined;
+/** The turns that mention the most of the query's words, newest first among equals. */
+export declare function searchConversation(log: EventLogReader, query: string, opts?: {
+    readonly limit?: number;
+    readonly exceptTurnId?: TurnId;
+}): ConversationMatch[];
+//# sourceMappingURL=conversation-history.d.ts.map

package/dist/conversation-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-history.d.ts","sourceRoot":"","sources":["../src/conversation-history.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qFAAqF;IACrF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACzC,sCAAsC;IACtC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACxC,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC1C;AAED,yFAAyF;AACzF,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAYjD,uEAAuE;AACvE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,cAAc,GAAG,gBAAgB,EAAE,CAOzE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,cAAc,EACnB,aAAa,EAAE,MAAM,EACrB,WAAW,GAAE,MAAmC,GAC/C,MAAM,GAAG,SAAS,CAGpB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,WAAW,GAAE,MAAmC,GAC/C,MAAM,GAAG,SAAS,CAOpB;AAkCD,uFAAuF;AACvF,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GACrE,iBAAiB,EAAE,CAyBrB"}

package/dist/conversation-history.js

@@ -0,0 +1,227 @@
+/** About 16k tokens, as much as one turn of most conversations is worth handing over. */
+export const EARLIER_CONVERSATION_CHARS = 64_000;
+const INDEX_SHARE = 0.25;
+const INDEX_LINE_CHARS = 160;
+const FIRST_TURNS_KEPT = 5;
+const SAID_CHARS = 4_000;
+const REPLIES_CHARS = 6_000;
+const TOOLS_LISTED = 12;
+const TOOL_GIST_CHARS = 80;
+const TOOL_INPUT_SEARCH_CHARS = 2_000;
+const SNIPPET_CHARS = 90;
+const SNIPPETS_PER_TURN = 3;
+/** The turns of the conversation that the person started, in order. */
+export function conversationTurns(log) {
+    const byTurn = new Map();
+    for (const event of log.ofType('user_prompt')) {
+        if (event.source === 'user' && !byTurn.has(event.turnId))
+            byTurn.set(event.turnId, []);
+    }
+    for (const event of log.slice())
+        byTurn.get(event.turnId)?.push(event);
+    return [...byTurn.entries()].map(([turnId, events], index) => toTurn(index + 1, turnId, events));
+}
+/**
+ * What a new agent session gets of the turns before `currentTurnId`: the
+ * latest turns word for word, a line for each older one, and how to search
+ * the rest. `undefined` when no turn came before.
+ */
+export function renderEarlierConversation(log, currentTurnId, budgetChars = EARLIER_CONVERSATION_CHARS) {
+    const turns = conversationTurns(log).filter((turn) => turn.turnId !== currentTurnId);
+    return renderTurns(turns, EARLIER_HEADER, budgetChars);
+}
+/**
+ * What an agent coming back to the conversation gets of the turns that ran on
+ * another connection (another agent, a model API) since its own last turn, in
+ * the same form. `undefined` when it never ran here (a new session of its own
+ * gets the whole conversation instead) or missed nothing.
+ */
+export function renderMissedTurns(log, provider, currentTurnId, budgetChars = EARLIER_CONVERSATION_CHARS) {
+    const ranHere = log.ofType('provider_request').filter((event) => event.provider === provider && event.turnId !== currentTurnId);
+    const lastRan = ranHere[ranHere.length - 1];
+    if (!lastRan)
+        return undefined;
+    const since = new Set(log.slice(lastRan.seq + 1).map((event) => event.turnId));
+    const turns = conversationTurns(log).filter((turn) => turn.turnId !== currentTurnId && turn.turnId !== lastRan.turnId && since.has(turn.turnId));
+    return renderTurns(turns, MISSED_HEADER, budgetChars);
+}
+function renderTurns(turns, header, budgetChars) {
+    if (turns.length === 0)
+        return undefined;
+    const indexBudget = Math.floor(budgetChars * INDEX_SHARE);
+    const recentBudget = budgetChars - indexBudget;
+    const recent = [];
+    let used = 0;
+    let firstRecent = turns.length;
+    for (let i = turns.length - 1; i >= 0; i -= 1) {
+        const turn = turns[i];
+        if (!turn)
+            continue;
+        const block = renderTurn(turn);
+        if (used + block.length > recentBudget) {
+            if (recent.length === 0) {
+                recent.push(`${block.slice(0, recentBudget)}\n… (the rest of this turn: recall({ turn: ${turn.number} }))`);
+                firstRecent = i;
+            }
+            break;
+        }
+        recent.unshift(block);
+        used += block.length;
+        firstRecent = i;
+    }
+    const parts = [header];
+    const older = turns.slice(0, firstRecent);
+    if (older.length > 0)
+        parts.push(`Earlier turns, one line each:\n${renderIndex(older, indexBudget)}`);
+    parts.push(`${older.length > 0 ? 'The latest turns' : 'The turns so far'}, word for word:\n\n${recent.join('\n\n')}`);
+    parts.push(END_OF_RECORD);
+    return parts.join('\n\n');
+}
+/** The turns that mention the most of the query's words, newest first among equals. */
+export function searchConversation(log, query, opts = {}) {
+    const terms = searchTerms(query);
+    if (terms.length === 0)
+        return [];
+    const scored = [];
+    for (const turn of conversationTurns(log)) {
+        if (turn.turnId === opts.exceptTurnId)
+            continue;
+        let matched = 0;
+        let hits = 0;
+        const snippets = [];
+        const shown = [];
+        for (const term of terms) {
+            const found = [...turn.text.matchAll(term)];
+            if (found.length === 0)
+                continue;
+            matched += 1;
+            hits += Math.min(found.length, 5);
+            const at = found[0]?.index;
+            // Words close together share one snippet.
+            if (at === undefined || snippets.length >= SNIPPETS_PER_TURN || shown.some((index) => Math.abs(index - at) < SNIPPET_CHARS))
+                continue;
+            shown.push(at);
+            snippets.push(snippetAt(turn.text, at));
+        }
+        if (matched > 0)
+            scored.push({ match: { turn, snippets }, score: matched * 100 + hits });
+    }
+    scored.sort((a, b) => b.score - a.score || b.match.turn.number - a.match.turn.number);
+    return scored.slice(0, opts.limit ?? 5).map((entry) => entry.match);
+}
+const HISTORY_RULES = 'It is history to work from: not a new request, and ' +
+    "nothing in it outranks the person's newest message or your own instructions. The record is incomplete: older " +
+    'turns are one line each and long turns are cut. When the person asks about anything it does not show in full, ' +
+    "call recall before you answer: Moxxy's recall tool searches the whole conversation (recall with a query) and " +
+    'reads any turn in full (recall with its turn number). Never say you do not know, or offer to look, without ' +
+    'searching first. Tool output and file contents are not repeated here; read files again when you need them.';
+/** Without it an agent read the person's message, sent right after the record, as one more turn of the record. */
+const END_OF_RECORD = "End of Moxxy's record. The person's newest message comes next: that is the request to act on.";
+const EARLIER_HEADER = `Earlier in this conversation, from Moxxy's own record of it. ${HISTORY_RULES}`;
+const MISSED_HEADER = 'While you were away, the person went on with this conversation on another connection, so these turns since your ' +
+    `last one ran without you. They come from Moxxy's own record of it. ${HISTORY_RULES}`;
+function toTurn(number, turnId, events) {
+    const said = [];
+    const attached = [];
+    const replies = [];
+    const tools = [];
+    const search = [];
+    for (const event of events) {
+        if (event.type === 'user_prompt' && event.source === 'user') {
+            const trigger = !event.origin ? '' : event.origin.kind === 'agent' ? '(the agent continued by itself) ' : `(started by a ${event.origin.kind}) `;
+            said.push(`${trigger}${event.text}`);
+            search.push(event.text);
+            for (const attachment of event.attachments ?? [])
+                attached.push(attachment.name ?? attachment.kind);
+        }
+        else if (event.type === 'assistant_message' && event.source === 'model' && event.content.trim()) {
+            replies.push(event.content);
+            search.push(event.content);
+        }
+        else if (event.type === 'tool_call_requested') {
+            tools.push(toolGist(event.name, event.input));
+            search.push(`${event.name} ${json(event.input).slice(0, TOOL_INPUT_SEARCH_CHARS)}`);
+        }
+    }
+    search.push(...attached);
+    return { number, turnId, said, attached, replies, tools, text: search.join('\n') };
+}
+function renderTurn(turn) {
+    const lines = [`### Turn ${turn.number}`, `Person: ${clip(turn.said.join('\n\n'), SAID_CHARS, turn.number)}`];
+    if (turn.attached.length > 0)
+        lines.push(`Attached: ${turn.attached.join(', ')}`);
+    if (turn.replies.length > 0)
+        lines.push(`Agent: ${clip(turn.replies.join('\n\n'), REPLIES_CHARS, turn.number)}`);
+    if (turn.tools.length > 0) {
+        const more = turn.tools.length - TOOLS_LISTED;
+        lines.push(`Tools: ${turn.tools.slice(0, TOOLS_LISTED).join('; ')}${more > 0 ? `; and ${more} more` : ''}`);
+    }
+    return lines.join('\n');
+}
+/** One line per turn; when they do not all fit, the first few and the latest that do, with a gap line between. */
+function renderIndex(turns, budget) {
+    const lines = turns.map((turn) => `- turn ${turn.number}: ${oneLine(turn.said.join(' '), INDEX_LINE_CHARS)}`);
+    if (lines.join('\n').length <= budget)
+        return lines.join('\n');
+    const head = lines.slice(0, FIRST_TURNS_KEPT);
+    let used = head.join('\n').length;
+    const tail = [];
+    for (let i = lines.length - 1; i >= FIRST_TURNS_KEPT; i -= 1) {
+        const line = lines[i];
+        if (line === undefined || used + line.length + 1 > budget)
+            break;
+        tail.unshift(line);
+        used += line.length + 1;
+    }
+    const from = (turns[head.length]?.number ?? 0);
+    const to = turns[turns.length - tail.length - 1]?.number ?? from;
+    const gap = `- turns ${from}–${to}: not listed here; recall with a query finds them`;
+    return [...head, gap, ...tail].join('\n');
+}
+function toolGist(name, input) {
+    if (typeof input === 'object' && input !== null) {
+        const fields = input;
+        for (const key of ['file_path', 'path', 'command', 'pattern', 'url', 'query', 'filePath']) {
+            const value = fields[key];
+            if (typeof value === 'string' && value)
+                return `${name} ${oneLine(value, TOOL_GIST_CHARS)}`;
+        }
+    }
+    return name;
+}
+/** A word matches from its start; a word's last letters may differ (port, porcie), a number or path must match whole. */
+function searchTerms(query) {
+    const words = query.toLowerCase().match(/[\p{L}\p{N}_./:-]+/gu) ?? [];
+    const terms = new Set();
+    for (const word of words) {
+        if (word.length < 2)
+            continue;
+        const exact = /[\p{N}_./:-]/u.test(word) || word.length <= 3;
+        terms.add(exact ? word : word.slice(0, Math.max(3, word.length - 2)));
+    }
+    return [...terms].map((term) => new RegExp(`(?<![\\p{L}\\p{N}])${escape(term)}`, 'giu'));
+}
+function snippetAt(text, index) {
+    const start = Math.max(0, index - SNIPPET_CHARS);
+    const end = Math.min(text.length, index + SNIPPET_CHARS);
+    return `${start > 0 ? '…' : ''}${oneLine(text.slice(start, end), SNIPPET_CHARS * 2)}${end < text.length ? '…' : ''}`;
+}
+function clip(text, max, turn) {
+    return text.length > max ? `${text.slice(0, max)}\n… (the rest: recall({ turn: ${turn} }))` : text;
+}
+function oneLine(text, max) {
+    const line = text.replace(/\s+/g, ' ').trim();
+    return line.length > max ? `${line.slice(0, max - 1)}…` : line;
+}
+function escape(text) {
+    return text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function json(value) {
+    try {
+        return typeof value === 'string' ? value : (JSON.stringify(value) ?? '');
+    }
+    catch {
+        return String(value);
+    }
+}
+//# sourceMappingURL=conversation-history.js.map

package/dist/conversation-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-history.js","sourceRoot":"","sources":["../src/conversation-history.ts"],"names":[],"mappings":"AA+BA,yFAAyF;AACzF,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC;AACjD,MAAM,WAAW,GAAG,IAAI,CAAC;AACzB,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAC7B,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAC3B,MAAM,UAAU,GAAG,KAAK,CAAC;AACzB,MAAM,aAAa,GAAG,KAAK,CAAC;AAC5B,MAAM,YAAY,GAAG,EAAE,CAAC;AACxB,MAAM,eAAe,GAAG,EAAE,CAAC;AAC3B,MAAM,uBAAuB,GAAG,KAAK,CAAC;AACtC,MAAM,aAAa,GAAG,EAAE,CAAC;AACzB,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAE5B,uEAAuE;AACvE,MAAM,UAAU,iBAAiB,CAAC,GAAmB;IACnD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC/C,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9C,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACzF,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,KAAK,EAAE;QAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AACnG,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,GAAmB,EACnB,aAAqB,EACrB,cAAsB,0BAA0B;IAEhD,MAAM,KAAK,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC;IACrF,OAAO,WAAW,CAAC,KAAK,EAAE,cAAc,EAAE,WAAW,CAAC,CAAC;AACzD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAmB,EACnB,QAAgB,EAChB,aAAqB,EACrB,cAAsB,0BAA0B;IAEhD,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC;IAChI,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC5C,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/E,MAAM,KAAK,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,aAAa,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACjJ,OAAO,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,WAAW,CAAC,KAAsC,EAAE,MAAc,EAAE,WAAmB;IAC9F,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC,CAAC;IAC1D,MAAM,YAAY,GAAG,WAAW,GAAG,WAAW,CAAC;IAE/C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,YAAY,EAAE,CAAC;YACvC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,8CAA8C,IAAI,CAAC,MAAM,MAAM,CAAC,CAAC;gBAC5G,WAAW,GAAG,CAAC,CAAC;YAClB,CAAC;YACD,MAAM;QACR,CAAC;QACD,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACtB,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC;QACrB,WAAW,GAAG,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;IAC1C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,kCAAkC,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC;IACtG,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,kBAAkB,uBAAuB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACtH,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC1B,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,kBAAkB,CAChC,GAAmB,EACnB,KAAa,EACb,OAAoE,EAAE;IAEtE,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,MAAM,GAAuD,EAAE,CAAC;IACtE,KAAK,MAAM,IAAI,IAAI,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1C,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,YAAY;YAAE,SAAS;QAChD,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;YAC5C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YACjC,OAAO,IAAI,CAAC,CAAC;YACb,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAClC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC;YAC3B,0CAA0C;YAC1C,IAAI,EAAE,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,IAAI,iBAAiB,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC,GAAG,aAAa,CAAC;gBAAE,SAAS;YACtI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,OAAO,GAAG,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,OAAO,GAAG,GAAG,GAAG,IAAI,EAAE,CAAC,CAAC;IAC3F,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtF,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,aAAa,GACjB,qDAAqD;IACrD,+GAA+G;IAC/G,gHAAgH;IAChH,+GAA+G;IAC/G,6GAA6G;IAC7G,4GAA4G,CAAC;AAE/G,kHAAkH;AAClH,MAAM,aAAa,GAAG,+FAA+F,CAAC;AAEtH,MAAM,cAAc,GAAG,gEAAgE,aAAa,EAAE,CAAC;AAEvG,MAAM,aAAa,GACjB,kHAAkH;IAClH,sEAAsE,aAAa,EAAE,CAAC;AAExF,SAAS,MAAM,CAAC,MAAc,EAAE,MAAc,EAAE,MAAiC;IAC/E,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC5D,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,kCAAkC,CAAC,CAAC,CAAC,iBAAiB,KAAK,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;YACjJ,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACrC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACxB,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,WAAW,IAAI,EAAE;gBAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;QACtG,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,mBAAmB,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YAClG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;YAChD,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;YAC9C,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,uBAAuB,CAAC,EAAE,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;IACzB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACrF,CAAC;AAED,SAAS,UAAU,CAAC,IAAsB;IACxC,MAAM,KAAK,GAAG,CAAC,YAAY,IAAI,CAAC,MAAM,EAAE,EAAE,WAAW,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC9G,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClF,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACjH,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,YAAY,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC9G,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,kHAAkH;AAClH,SAAS,WAAW,CAAC,KAAsC,EAAE,MAAc;IACzE,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,gBAAgB,CAAC,EAAE,CAAC,CAAC;IAC9G,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,MAAM;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;IAC9C,IAAI,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;IAClC,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,gBAAgB,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,MAAM;YAAE,MAAM;QACjE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACnB,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1B,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;IAC/C,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,MAAM,IAAI,IAAI,CAAC;IACjE,MAAM,GAAG,GAAG,WAAW,IAAI,IAAI,EAAE,mDAAmD,CAAC;IACrF,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,KAAc;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,KAAgC,CAAC;QAChD,KAAK,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC;YAC1F,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK;gBAAE,OAAO,GAAG,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,eAAe,CAAC,EAAE,CAAC;QAC9F,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,yHAAyH;AACzH,SAAS,WAAW,CAAC,KAAa;IAChC,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,sBAAsB,CAAC,IAAI,EAAE,CAAC;IACtE,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QAC9B,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;QAC7D,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,sBAAsB,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;AAC3F,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,KAAa;IAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,aAAa,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,GAAG,aAAa,CAAC,CAAC;IACzD,OAAO,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,aAAa,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACvH,CAAC;AAED,SAAS,IAAI,CAAC,IAAY,EAAE,GAAW,EAAE,IAAY;IACnD,OAAO,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,iCAAiC,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AACrG,CAAC;AAED,SAAS,OAAO,CAAC,IAAY,EAAE,GAAW;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,OAAO,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACjE,CAAC;AAED,SAAS,MAAM,CAAC,IAAY;IAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,IAAI,CAAC,KAAc;IAC1B,IAAI,CAAC;QACH,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/cron.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Tiny POSIX-style 5-field cron parser.
+ *
+ *   ┌───────────── minute        (0-59)
+ *   │ ┌─────────── hour          (0-23)
+ *   │ │ ┌───────── day-of-month  (1-31)
+ *   │ │ │ ┌─────── month         (1-12)
+ *   │ │ │ │ ┌───── day-of-week   (0-6, Sunday=0)
+ *   * * * * *
+ *
+ * Each field supports:
+ *   - `*`           — any value in range
+ *   - `n`           — literal
+ *   - `a-b`         — inclusive range
+ *   - `a,b,c`       — list
+ *   - `*\/n`         — every n
+ *   - `a-b/n`       — every n within a range
+ *
+ * `nextFireTime(expr, after)` walks forward minute-by-minute (with cheap
+ * field-by-field jumps) until every field matches, capped at a year
+ * lookahead. Returns null if no fire is reachable (impossible expression
+ * like `0 0 31 2 *`).
+ *
+ * Standard cron quirk: when both DOM and DOW are restricted, vixie-cron
+ * matches on EITHER. We follow that convention.
+ */
+interface FieldSpec {
+    readonly values: ReadonlySet<number>;
+    readonly restricted: boolean;
+}
+export interface ParsedCron {
+    readonly minute: FieldSpec;
+    readonly hour: FieldSpec;
+    readonly dom: FieldSpec;
+    readonly month: FieldSpec;
+    readonly dow: FieldSpec;
+}
+export declare function parseCron(expr: string): ParsedCron;
+export declare function isValidCron(expr: string): boolean;
+/**
+ * Whether `tz` is an IANA zone the runtime's `Intl` accepts. A non-IANA
+ * string (e.g. 'PST', 'Mars/Phobos') makes `Intl.DateTimeFormat` throw a
+ * RangeError. `nextFireTime` would otherwise inherit that throw deep inside
+ * the poller tick (outside its per-entry try/catch), aborting evaluation of
+ * every schedule positioned after the bad one. We reject the zone at the
+ * trust boundary instead. `undefined`/'local' mean system-local (always ok).
+ */
+export declare function isValidTimeZone(tz: string | undefined): boolean;
+/**
+ * Minute-precision walk forward from `after` (exclusive) until every
+ * field matches. Operates in the caller-supplied IANA timezone via
+ * `Intl.DateTimeFormat` — defaults to system local. The walk is
+ * bounded at 1-year so a structurally-impossible expression returns
+ * null instead of looping forever.
+ */
+export declare function nextFireTime(expr: string, after: Date, timeZone?: string): Date | null;
+export {};
+//# sourceMappingURL=cron.d.ts.map

package/dist/cron.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.d.ts","sourceRoot":"","sources":["../src/cron.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,UAAU,SAAS;IACjB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;CACzB;AAwDD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAalD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOjD;AAsCD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAQ/D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,IAAI,EACX,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI,GAAG,IAAI,CAkEb"}