@cursor/july 0.1.1 → 0.1.2

package/dist/internal/eval-run-store.js

@@ -21,36 +21,47 @@ import { discoverEvals, filterDiscoveredEvals, runDiscoveredEvals, } from "./eva
 const INTERRUPTED_BATCH_ERROR = "Eval run interrupted (serve process exited before completion)";
 const INTERRUPTED_CASE_ERROR = "Eval case interrupted (serve process exited before completion)";
 export class EvalRunStore {
-    constructor(projectRoot, logger) {
+    constructor(projectRoot, logger, 
+    /**
+     * Project-wide sink from `agent/storage.ts` (`defineStorage`),
+     * used when `evals.config.ts` sets no `persistRuns` of its own.
+     */
+    fallbackPersistence) {
         this.projectRoot = projectRoot;
         this.logger = logger;
+        this.fallbackPersistence = fallbackPersistence;
         this.runs = new Map();
         this.hydrated = false;
         /** Per-run persist chain so intermediate saves cannot overwrite a later final write. */
         this.persistChains = new Map();
     }
+    /** `evals.config.ts` `persistRuns` wins; `defineStorage` is fallback. */
+    resolvePersist(config) {
+        var _a;
+        return (_a = config.persistRuns) !== null && _a !== void 0 ? _a : this.fallbackPersistence;
+    }
     list() {
         return __awaiter(this, void 0, void 0, function* () {
-            yield this.ensureHydrated();
+            yield this.hydrate();
             const { evals, config } = yield discoverEvals(this.projectRoot);
             return {
                 evals: evals.map((e) => (Object.assign(Object.assign({ id: e.id, fileId: e.fileId }, (e.definition.description === undefined
                     ? {}
                     : { description: e.definition.description })), (e.definition.tags === undefined ? {} : { tags: e.definition.tags })))),
-                config: snapshotListConfig(config),
+                config: snapshotListConfig(config, this.resolvePersist(config) !== undefined),
             };
         });
     }
     get(runId) {
         return __awaiter(this, void 0, void 0, function* () {
-            yield this.ensureHydrated();
+            yield this.hydrate();
             return this.runs.get(runId);
         });
     }
     /** Newest-first snapshots for playground rehydrate after navigation/reload. */
     listRuns() {
         return __awaiter(this, void 0, void 0, function* () {
-            yield this.ensureHydrated();
+            yield this.hydrate();
             return this.sortedRuns();
         });
     }
@@ -61,7 +72,7 @@ export class EvalRunStore {
      */
     listRunsWithActive() {
         return __awaiter(this, void 0, void 0, function* () {
-            yield this.ensureHydrated();
+            yield this.hydrate();
             const activeRunId = this.activeRunId;
             return Object.assign({ runs: this.sortedRuns() }, (activeRunId === undefined ? {} : { activeRunId }));
         });
@@ -71,7 +82,7 @@ export class EvalRunStore {
     }
     start() {
         return __awaiter(this, arguments, void 0, function* (input = {}) {
-            yield this.ensureHydrated();
+            yield this.hydrate();
             if (this.activeRunId !== undefined) {
                 const active = this.runs.get(this.activeRunId);
                 if (active !== undefined && active.status === "running") {
@@ -103,12 +114,12 @@ export class EvalRunStore {
                     done: 0,
                 },
                 cases,
-                config: snapshotRunConfig(config),
+                config: snapshotRunConfig(config, this.resolvePersist(config) !== undefined),
             };
             this.runs.set(runId, snapshot);
             this.activeRunId = runId;
             yield this.pruneOldRuns(config);
-            yield this.enqueuePersist(snapshot, config.persistRuns);
+            yield this.enqueuePersist(snapshot, this.resolvePersist(config));
             this.logger(`[agent-serve] eval run ${runId}: starting ${cases.length} case(s)`);
             void this.execute(runId, Object.assign(Object.assign({ baseUrl: loopbackUrl, evals: selected, config }, (input.bearerToken === undefined
                 ? {}
@@ -119,7 +130,14 @@ export class EvalRunStore {
     sortedRuns() {
         return [...this.runs.values()].sort((a, b) => b.startedAt.localeCompare(a.startedAt));
     }
-    ensureHydrated() {
+    /**
+     * Hydrate playground eval history from durable persistence
+     * (`evals.config.ts` `persistRuns`, else the `defineStorage`
+     * fallback). Called eagerly from the serve startup restore step —
+     * alongside session restore — and lazily as a safety net by every read.
+     * Idempotent; concurrent callers share one pass.
+     */
+    hydrate() {
         return __awaiter(this, void 0, void 0, function* () {
             if (this.hydrated) {
                 return;
@@ -134,7 +152,7 @@ export class EvalRunStore {
         return __awaiter(this, void 0, void 0, function* () {
             try {
                 const { config } = yield discoverEvals(this.projectRoot);
-                const persist = config.persistRuns;
+                const persist = this.resolvePersist(config);
                 if (persist === undefined) {
                     this.hydrated = true;
                     return;
@@ -187,7 +205,7 @@ export class EvalRunStore {
                     continue;
                 }
                 this.runs.delete(stale.runId);
-                yield this.persistDelete(stale.runId, config.persistRuns);
+                yield this.persistDelete(stale.runId, this.resolvePersist(config));
             }
         });
     }
@@ -283,7 +301,7 @@ export class EvalRunStore {
                         this.applyCaseResult(runId, result);
                         const run = this.runs.get(runId);
                         if (run !== undefined) {
-                            void this.enqueuePersist(run, opts.config.persistRuns);
+                            void this.enqueuePersist(run, this.resolvePersist(opts.config));
                         }
                     } }));
                 const run = this.runs.get(runId);
@@ -292,7 +310,7 @@ export class EvalRunStore {
                 }
                 run.status = "completed";
                 run.finishedAt = new Date().toISOString();
-                yield this.enqueuePersist(run, opts.config.persistRuns);
+                yield this.enqueuePersist(run, this.resolvePersist(opts.config));
                 this.logger(`[agent-serve] eval run ${runId}: done — ${run.summary.passed} passed, ${run.summary.failed} failed`);
             }
             catch (error) {
@@ -303,7 +321,7 @@ export class EvalRunStore {
                 run.status = "failed";
                 run.finishedAt = new Date().toISOString();
                 run.error = error instanceof Error ? error.message : String(error);
-                yield this.enqueuePersist(run, opts.config.persistRuns);
+                yield this.enqueuePersist(run, this.resolvePersist(opts.config));
                 this.logger(`[agent-serve] eval run ${runId}: failed — ${run.error}`);
             }
             finally {
@@ -365,13 +383,13 @@ function markInterruptedRun(run) {
         }
     }
 }
-function snapshotListConfig(config) {
+function snapshotListConfig(config, durableRuns) {
     return Object.assign(Object.assign(Object.assign({}, (config.maxConcurrency === undefined
         ? {}
-        : { maxConcurrency: config.maxConcurrency })), (config.timeoutMs === undefined ? {} : { timeoutMs: config.timeoutMs })), { maxPlaygroundRuns: resolveEvalMaxPlaygroundRuns(config.maxPlaygroundRuns), durableRuns: config.persistRuns !== undefined });
+        : { maxConcurrency: config.maxConcurrency })), (config.timeoutMs === undefined ? {} : { timeoutMs: config.timeoutMs })), { maxPlaygroundRuns: resolveEvalMaxPlaygroundRuns(config.maxPlaygroundRuns), durableRuns });
 }
-function snapshotRunConfig(config) {
-    const list = snapshotListConfig(config);
+function snapshotRunConfig(config, durableRuns) {
+    const list = snapshotListConfig(config, durableRuns);
     return Object.assign(Object.assign(Object.assign({}, (list.maxConcurrency === undefined
         ? {}
         : { maxConcurrency: list.maxConcurrency })), (list.timeoutMs === undefined ? {} : { timeoutMs: list.timeoutMs })), { maxPlaygroundRuns: list.maxPlaygroundRuns, durableRuns: list.durableRuns });

package/dist/internal/handleAgentServeTrigger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handleAgentServeTrigger.d.ts","sourceRoot":"","sources":["../../src/internal/handleAgentServeTrigger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,WAAW,6BAA6B;IAC5C,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,OAAO,EAAE,oBAAoB,CAAC;IAC9B,uEAAuE;IACvE,IAAI,EAAE,kBAAkB,CAAC;CAC1B;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,QAAQ,CAAC;IACf,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,6BAA6B,EAAE,CAAC;CAC1C;AAED,MAAM,MAAM,sBAAsB,GAAG,4BAA4B,CAAC;AAElE,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,6BAA6B,EAAE,CAAC;CAC1C;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACpD,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,kBAAkB,CAAC;KAC7D,CAAC,CAAC;CACJ,GAAG,6BAA6B,EAAE,CAkBlC;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,uBAAuB,CAAC,CAYlC"}
+{"version":3,"file":"handleAgentServeTrigger.d.ts","sourceRoot":"","sources":["../../src/internal/handleAgentServeTrigger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,WAAW,6BAA6B;IAC5C,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,OAAO,EAAE,oBAAoB,CAAC;IAC9B,uEAAuE;IACvE,IAAI,EAAE,kBAAkB,CAAC;CAC1B;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,QAAQ,CAAC;IACf,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,6BAA6B,EAAE,CAAC;CAC1C;AAED,MAAM,MAAM,sBAAsB,GAAG,4BAA4B,CAAC;AAElE,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,6BAA6B,EAAE,CAAC;CAC1C;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACpD,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,kBAAkB,CAAC;KAC7D,CAAC,CAAC;CACJ,GAAG,6BAA6B,EAAE,CAgBlC;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,uBAAuB,CAAC,CAYlC"}

package/dist/internal/handleAgentServeTrigger.js

@@ -26,19 +26,17 @@ import { dispatchGitHubWebhook, getGitHubChannelOptions, } from "../channels/git
 export function collectGitHubTriggerTargets(input) {
     const targets = [];
     for (const mount of input.mounts) {
-        const github = mount.channels.find((channel) => channel.id === "github");
-        if (github === undefined) {
-            continue;
-        }
-        const options = getGitHubChannelOptions(github.definition);
-        if (options === undefined) {
-            continue;
+        for (const channel of mount.channels) {
+            const options = getGitHubChannelOptions(channel.definition);
+            if (options === undefined) {
+                continue;
+            }
+            targets.push({
+                slug: mount.slug,
+                options,
+                args: mount.buildHandlerArgs(channel.id),
+            });
         }
-        targets.push({
-            slug: mount.slug,
-            options,
-            args: mount.buildHandlerArgs("github"),
-        });
     }
     return targets;
 }

package/dist/internal/host-platforms.d.ts

@@ -2,6 +2,7 @@
  * Host-side GitHub + Slack clients shared across tools, channel routes,
  * schedules, and channel packs — same injection pattern as MCP.
  */
+import type { GitHubChannelCredentials } from "../channels/github/types.js";
 import type { HostGitHubClient, HostSlackClient } from "../types.js";
 export interface HostPlatforms {
     github: HostGitHubClient;
@@ -12,13 +13,16 @@ export interface HostPlatforms {
  * `app` = GitHub App installation token (preferred in production).
  * `env` / `gh` = local PAT / CLI fallbacks when App creds are unset.
  */
-export type HostGitHubAuthSource = "app" | "env" | "gh" | "unavailable";
+export type HostGitHubAuthSource = "app" | "cursor-account" | "env" | "gh" | "unavailable";
+export interface HostPlatformsOptions {
+    githubCredentials?: GitHubChannelCredentials;
+}
 /**
  * Build host platforms from ambient credentials. Prefer App installation
  * auth when configured; otherwise fall back to PAT / `gh auth` for local
  * testing. Webhook-scoped calls should still prefer `ctx.github`.
  */
-export declare function createHostPlatforms(): HostPlatforms;
+export declare function createHostPlatforms(options?: HostPlatformsOptions): HostPlatforms;
 /**
  * Detect ambient host GitHub auth without throwing.
  * Order matches {@link createGitHubOctokit}: App installation, then
@@ -36,5 +40,6 @@ export declare function resolveHostGitHubAuthSource(): Promise<HostGitHubAuthSou
 export declare function warmupHostGitHubAuth(options: {
     logger: (line: string) => void;
     github?: HostGitHubClient;
+    authSource?: HostGitHubAuthSource;
 }): Promise<HostGitHubAuthSource>;
 //# sourceMappingURL=host-platforms.d.ts.map

package/dist/internal/host-platforms.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host-platforms.d.ts","sourceRoot":"","sources":["../../src/internal/host-platforms.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAErE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,eAAe,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,aAAa,CAAC;AAExE;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CA4BnD;AAED;;;;GAIG;AACH,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAejF;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE;IAClD,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA8ChC"}
+{"version":3,"file":"host-platforms.d.ts","sourceRoot":"","sources":["../../src/internal/host-platforms.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAE5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAErE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,eAAe,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAC5B,KAAK,GACL,gBAAgB,GAChB,KAAK,GACL,IAAI,GACJ,aAAa,CAAC;AAElB,MAAM,WAAW,oBAAoB;IACnC,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;CAC9C;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,oBAAyB,GACjC,aAAa,CA8Bf;AAED;;;;GAIG;AACH,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAejF;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE;IAClD,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,UAAU,CAAC,EAAE,oBAAoB,CAAC;CACnC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAgDhC"}

package/dist/internal/host-platforms.js

@@ -20,13 +20,15 @@ import { tryResolveBotToken } from "../channels/slack/credentials.js";
  * auth when configured; otherwise fall back to PAT / `gh auth` for local
  * testing. Webhook-scoped calls should still prefer `ctx.github`.
  */
-export function createHostPlatforms() {
+export function createHostPlatforms(options = {}) {
     let octokitPromise;
     let slackPromise;
     return {
         github: {
             getOctokit: () => {
-                octokitPromise !== null && octokitPromise !== void 0 ? octokitPromise : (octokitPromise = createGitHubOctokit({}));
+                octokitPromise !== null && octokitPromise !== void 0 ? octokitPromise : (octokitPromise = createGitHubOctokit({
+                    credentials: options.githubCredentials,
+                }));
                 return octokitPromise;
             },
         },
@@ -76,7 +78,8 @@ export function resolveHostGitHubAuthSource() {
  */
 export function warmupHostGitHubAuth(options) {
     return __awaiter(this, void 0, void 0, function* () {
-        const source = yield resolveHostGitHubAuthSource();
+        var _a;
+        const source = (_a = options.authSource) !== null && _a !== void 0 ? _a : (yield resolveHostGitHubAuthSource());
         if (source === "unavailable") {
             options.logger("[agent-serve] GitHub auth: unavailable (set GITHUB_APP_ID + GITHUB_APP_PRIVATE_KEY + GITHUB_APP_INSTALLATION_ID, or GITHUB_TOKEN / GH_TOKEN, or run `gh auth login`)");
             return source;
@@ -90,13 +93,15 @@ export function warmupHostGitHubAuth(options) {
                 options.logger(`[agent-serve] GitHub auth: failed to export GH_TOKEN for gh CLI: ${error instanceof Error ? error.message : String(error)}`);
             }
         }
-        const label = source === "app"
-            ? exportedGhToken
-                ? "GitHub App installation token (also exported as GH_TOKEN for gh CLI)"
-                : "GitHub App installation token"
-            : source === "env"
-                ? "GITHUB_TOKEN/GH_TOKEN"
-                : "gh auth token";
+        const label = source === "cursor-account"
+            ? "Cursor account repo-scoped credential (also exported as GH_TOKEN for gh CLI)"
+            : source === "app"
+                ? exportedGhToken
+                    ? "GitHub App installation token (also exported as GH_TOKEN for gh CLI)"
+                    : "GitHub App installation token"
+                : source === "env"
+                    ? "GITHUB_TOKEN/GH_TOKEN"
+                    : "gh auth token";
         if (options.github === undefined) {
             options.logger(`[agent-serve] GitHub auth: ${label}`);
             return source;

package/dist/internal/hosting.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Client-side mirrors of the Agent Serve hosting validation rules
+ * (backend/server/src/agentServe/agentServeShared.ts). Shared by discovery
+ * (`hosting` block diagnostics on `agentkit validate`) and the deploy /
+ * secrets CLI verbs (actionable errors before any network call). The
+ * backend stays authoritative — these exist so mistakes fail fast and
+ * locally with the same grammar the server enforces.
+ */
+/** `hosting.egressDomains` cap (backend caps the deploy body at 20). */
+export declare const MAX_EGRESS_DOMAINS = 20;
+/** Max secrets per deployment. */
+export declare const MAX_SECRETS = 32;
+/** Max secret value size in bytes. */
+export declare const MAX_SECRET_VALUE_BYTES = 4096;
+/** Max secret name length. */
+export declare const MAX_SECRET_NAME_LENGTH = 64;
+/** Secret names the platform injects; user writes are rejected. */
+export declare const RESERVED_SECRET_NAME_PREFIX = "CURSOR_";
+/** Returns a human error message, or undefined when the domain is valid. */
+export declare function validateEgressDomain(domain: string): string | undefined;
+/**
+ * Returns a human error message, or undefined when the name is a valid
+ * secret name. Grammar only — reserved names are checked separately so the
+ * manifest's declarative `secretNames` can mention them with a softer
+ * diagnostic than the hard write-time rejection.
+ */
+export declare function validateSecretName(name: string): string | undefined;
+/** True when the platform reserves this name (`CURSOR_*`); writes are rejected. */
+export declare function isReservedSecretName(name: string): boolean;
+/**
+ * Human error for a secret name a user is trying to write or delete:
+ * grammar plus the reserved `CURSOR_*` prefix.
+ */
+export declare function validateSettableSecretName(name: string): string | undefined;
+/** `owner/name` — mirrors the backend's cursor-event repo grammar. */
+export declare function isValidCursorEventRepo(repo: string): boolean;
+//# sourceMappingURL=hosting.d.ts.map

package/dist/internal/hosting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosting.d.ts","sourceRoot":"","sources":["../../src/internal/hosting.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,wEAAwE;AACxE,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,kCAAkC;AAClC,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,sCAAsC;AACtC,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAC3C,8BAA8B;AAC9B,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,mEAAmE;AACnE,eAAO,MAAM,2BAA2B,YAAY,CAAC;AASrD,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKvE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQnE;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAS3E;AAID,sEAAsE;AACtE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D"}

package/dist/internal/hosting.js

@@ -0,0 +1,67 @@
+/**
+ * Client-side mirrors of the Agent Serve hosting validation rules
+ * (backend/server/src/agentServe/agentServeShared.ts). Shared by discovery
+ * (`hosting` block diagnostics on `agentkit validate`) and the deploy /
+ * secrets CLI verbs (actionable errors before any network call). The
+ * backend stays authoritative — these exist so mistakes fail fast and
+ * locally with the same grammar the server enforces.
+ */
+/** `hosting.egressDomains` cap (backend caps the deploy body at 20). */
+export const MAX_EGRESS_DOMAINS = 20;
+/** Max secrets per deployment. */
+export const MAX_SECRETS = 32;
+/** Max secret value size in bytes. */
+export const MAX_SECRET_VALUE_BYTES = 4096;
+/** Max secret name length. */
+export const MAX_SECRET_NAME_LENGTH = 64;
+/** Secret names the platform injects; user writes are rejected. */
+export const RESERVED_SECRET_NAME_PREFIX = "CURSOR_";
+const SECRET_NAME_PATTERN = /^[A-Z][A-Z0-9_]*$/;
+// Lowercase hostname with >=2 labels, an alphabetic TLD, and at most one
+// leading `*.` wildcard. Labels: alphanumeric with interior hyphens.
+const EGRESS_DOMAIN_PATTERN = /^(\*\.)?([a-z0-9]([a-z0-9-]*[a-z0-9])?\.)+[a-z]+$/;
+/** Returns a human error message, or undefined when the domain is valid. */
+export function validateEgressDomain(domain) {
+    if (EGRESS_DOMAIN_PATTERN.test(domain)) {
+        return undefined;
+    }
+    return `Invalid egress domain ${JSON.stringify(domain)}: use a lowercase hostname with at least two labels and an alphabetic TLD (e.g. "api.example.com"), optionally with a single leading "*." wildcard.`;
+}
+/**
+ * Returns a human error message, or undefined when the name is a valid
+ * secret name. Grammar only — reserved names are checked separately so the
+ * manifest's declarative `secretNames` can mention them with a softer
+ * diagnostic than the hard write-time rejection.
+ */
+export function validateSecretName(name) {
+    if (name.length > MAX_SECRET_NAME_LENGTH) {
+        return `Secret name ${JSON.stringify(name)} is too long (max ${MAX_SECRET_NAME_LENGTH} characters).`;
+    }
+    if (!SECRET_NAME_PATTERN.test(name)) {
+        return `Invalid secret name ${JSON.stringify(name)}: use UPPER_SNAKE_CASE starting with a letter (${SECRET_NAME_PATTERN}).`;
+    }
+    return undefined;
+}
+/** True when the platform reserves this name (`CURSOR_*`); writes are rejected. */
+export function isReservedSecretName(name) {
+    return name.startsWith(RESERVED_SECRET_NAME_PREFIX);
+}
+/**
+ * Human error for a secret name a user is trying to write or delete:
+ * grammar plus the reserved `CURSOR_*` prefix.
+ */
+export function validateSettableSecretName(name) {
+    const nameError = validateSecretName(name);
+    if (nameError !== undefined) {
+        return nameError;
+    }
+    if (isReservedSecretName(name)) {
+        return `Secret name ${JSON.stringify(name)} is platform-reserved (CURSOR_*); the platform injects those values automatically.`;
+    }
+    return undefined;
+}
+const CURSOR_EVENT_REPO_PATTERN = /^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/;
+/** `owner/name` — mirrors the backend's cursor-event repo grammar. */
+export function isValidCursorEventRepo(repo) {
+    return CURSOR_EVENT_REPO_PATTERN.test(repo) && !repo.includes("..");
+}

package/dist/internal/reminder-runner.d.ts

@@ -25,6 +25,13 @@ export declare class ReminderRunner {
     get storeRoot(): string;
     /** Start deadline timers for armed reminders (call after restore). */
     start(): Promise<void>;
+    /**
+     * Pull reminder records from `defineStorage` into `<stateRoot>/reminders`
+     * when local disk is empty for that id. Failures are logged and skipped.
+     */
+    private hydrateFromStorage;
+    /** Persist locally and mirror into the authored storage sink when present. */
+    private persist;
     stop(): void;
     create(input: ReminderCreateInput): Promise<ReminderInfo>;
     list(filter?: {

package/dist/internal/reminder-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reminder-runner.d.ts","sourceRoot":"","sources":["../../src/internal/reminder-runner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAEV,mBAAmB,EAGnB,YAAY,EAEb,MAAM,aAAa,CAAC;AASrB,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,qBAAa,oBAAqB,SAAQ,KAAK;IAG3C,QAAQ,CAAC,oBAAoB,EAAE,MAAM,EAAE;IAFzC,YACE,UAAU,EAAE,MAAM,EACT,oBAAoB,EAAE,MAAM,EAAE,EAIxC;CACF;AAyDD,qBAAa,cAAc;IAUvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAVzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,uEAAuE;IACvE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAC9D,OAAO,CAAC,OAAO,CAAS;IAExB,YACmB,MAAM,EAAE,aAAa,EACrB,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAe,EAG3D;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,sEAAsE;IAChE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CA4B3B;IAED,IAAI,IAAI,IAAI,CAOX;IAEK,MAAM,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CA8D9D;IAEK,IAAI,CAAC,MAAM,CAAC,EAAE;QAClB,MAAM,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;QAClC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CA4B1B;IAEK,MAAM,CACV,EAAE,EAAE,MAAM,EACV,MAAM,SAAoB,GACzB,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAkBnC;IAED,iFAAiF;IAC3E,qBAAqB,CACzB,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAUjB;IAED,uDAAuD;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAC1C,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAQD;IAED,OAAO,CAAC,QAAQ;IA4ChB,OAAO,CAAC,UAAU;YAQJ,IAAI;YAiHJ,aAAa;IAY3B,OAAO,CAAC,eAAe;IAsBvB;;;OAGG;YACW,mBAAmB;YAcnB,aAAa;YAcb,YAAY;IA0C1B,OAAO,CAAC,gBAAgB;IAyDxB,OAAO,CAAC,iBAAiB;YAeX,MAAM;YAYN,SAAS;CAoFxB;AAGD,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"reminder-runner.d.ts","sourceRoot":"","sources":["../../src/internal/reminder-runner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAEV,mBAAmB,EAGnB,YAAY,EAEb,MAAM,aAAa,CAAC;AASrB,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,qBAAa,oBAAqB,SAAQ,KAAK;IAG3C,QAAQ,CAAC,oBAAoB,EAAE,MAAM,EAAE;IAFzC,YACE,UAAU,EAAE,MAAM,EACT,oBAAoB,EAAE,MAAM,EAAE,EAIxC;CACF;AAyDD,qBAAa,cAAc;IAUvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAVzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,uEAAuE;IACvE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAC9D,OAAO,CAAC,OAAO,CAAS;IAExB,YACmB,MAAM,EAAE,aAAa,EACrB,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAe,EAG3D;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,sEAAsE;IAChE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CA+B3B;IAED;;;OAGG;YACW,kBAAkB;IA+BhC,8EAA8E;YAChE,OAAO;IAKrB,IAAI,IAAI,IAAI,CAOX;IAEK,MAAM,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CA8D9D;IAEK,IAAI,CAAC,MAAM,CAAC,EAAE;QAClB,MAAM,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;QAClC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CA4B1B;IAEK,MAAM,CACV,EAAE,EAAE,MAAM,EACV,MAAM,SAAoB,GACzB,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAkBnC;IAED,iFAAiF;IAC3E,qBAAqB,CACzB,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAUjB;IAED,uDAAuD;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAC1C,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAQD;IAED,OAAO,CAAC,QAAQ;IA4ChB,OAAO,CAAC,UAAU;YAQJ,IAAI;YAiHJ,aAAa;IAY3B,OAAO,CAAC,eAAe;IAsBvB;;;OAGG;YACW,mBAAmB;YAcnB,aAAa;YAcb,YAAY;IA0C1B,OAAO,CAAC,gBAAgB;IAyDxB,OAAO,CAAC,iBAAiB;YAeX,MAAM;YAYN,SAAS;CAoFxB;AAGD,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/internal/reminder-runner.js

@@ -91,6 +91,9 @@ export class ReminderRunner {
             if (this.started)
                 return;
             this.started = true;
+            // Materialize sink-backed reminders onto local disk before arming
+            // (local wins when both sides have the same id).
+            yield this.hydrateFromStorage();
             const armed = yield this.store.listArmed();
             let restored = 0;
             let disarmedOrphan = 0;
@@ -114,6 +117,47 @@ export class ReminderRunner {
             }
         });
     }
+    /**
+     * Pull reminder records from `defineStorage` into `<stateRoot>/reminders`
+     * when local disk is empty for that id. Failures are logged and skipped.
+     */
+    hydrateFromStorage() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const storage = this.engine.storage;
+            if (storage === undefined || !storage.canBulkRestore) {
+                return;
+            }
+            let hydrated = 0;
+            try {
+                const remote = yield storage.listReminders();
+                for (const record of remote) {
+                    const local = yield this.store.get(record.id);
+                    if (local !== undefined) {
+                        continue;
+                    }
+                    // Local write only — re-mirroring would just echo the sink.
+                    yield this.store.save(record);
+                    hydrated += 1;
+                }
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                this.logger(`[agent-serve] reminders: storage hydrate failed: ${message}`);
+                return;
+            }
+            if (hydrated > 0) {
+                this.logger(`[agent-serve] reminders: hydrated ${hydrated} reminder(s) from storage`);
+            }
+        });
+    }
+    /** Persist locally and mirror into the authored storage sink when present. */
+    persist(record) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            yield this.store.save(record);
+            (_a = this.engine.storage) === null || _a === void 0 ? void 0 : _a.reminder(record);
+        });
+    }
     stop() {
         this.started = false;
         for (const timer of this.timers.values()) {
@@ -168,7 +212,7 @@ export class ReminderRunner {
                 createdAt: now,
                 updatedAt: now,
             };
-            yield this.store.save(record);
+            yield this.persist(record);
             this.handlers.set(id, {
                 run: input.run,
                 untilFn,
@@ -216,7 +260,7 @@ export class ReminderRunner {
             }
             this.clearTimer(id);
             const updated = Object.assign(Object.assign({}, record), { status: "cancelled", disarmReason: reason, updatedAt: new Date().toISOString() });
-            yield this.store.save(updated);
+            yield this.persist(updated);
             this.handlers.delete(id);
             return toInfo(updated);
         });
@@ -518,7 +562,7 @@ export class ReminderRunner {
         return __awaiter(this, void 0, void 0, function* () {
             this.clearTimer(record.id);
             const updated = Object.assign(Object.assign({}, record), { status: "disarmed", disarmReason: reason, updatedAt: new Date().toISOString() });
-            yield this.store.save(updated);
+            yield this.persist(updated);
             this.handlers.delete(record.id);
         });
     }
@@ -552,14 +596,14 @@ export class ReminderRunner {
                     scheduleKind: reschedule.delay !== undefined ? "delay" : "at", scheduleValue: reschedule.delay !== undefined
                         ? String(reschedule.delay)
                         : String(reschedule.at), updatedAt: new Date().toISOString() });
-                yield this.store.save(updated);
+                yield this.persist(updated);
                 this.armTimer(updated);
                 return;
             }
             if (oneShot) {
                 this.clearTimer(current.id);
                 const updated = Object.assign(Object.assign({}, current), { fireCount: current.fireCount + 1, status: "completed", disarmReason: "one_shot_complete", updatedAt: new Date().toISOString() });
-                yield this.store.save(updated);
+                yield this.persist(updated);
                 this.handlers.delete(current.id);
                 return;
             }
@@ -575,7 +619,7 @@ export class ReminderRunner {
                 throw new Error(`Reminder "${current.id}" has recurring status with scheduleKind=${current.scheduleKind}`);
             }
             const updated = Object.assign(Object.assign({}, current), { fireCount: current.fireCount + 1, nextFireAtMs, updatedAt: new Date().toISOString() });
-            yield this.store.save(updated);
+            yield this.persist(updated);
             this.armTimer(updated);
         });
     }

package/dist/internal/reminder-store.d.ts

@@ -44,6 +44,8 @@ export interface ReminderRecord {
     createdAt: string;
     updatedAt: string;
 }
+/** Narrow a sink value to a {@link ReminderRecord} (startup hydrate). */
+export declare function isReminderRecord(value: unknown): value is ReminderRecord;
 export declare class ReminderStore {
     private readonly rootDir;
     constructor(rootDir: string);

package/dist/internal/reminder-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reminder-store.d.ts","sourceRoot":"","sources":["../../src/internal/reminder-store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,eAAO,MAAM,yBAAyB,EAAG,CAAU,CAAC;AAEpD,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,yDAAyD;AACzD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,yBAAyB,CAAC;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,YAAY,EAAE,oBAAoB,CAAC;IACnC,4EAA4E;IAC5E,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,aAAa,EAAE,OAAO,CAAC;IACvB,yEAAyE;IACzE,UAAU,EAAE,OAAO,CAAC;IACpB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,OAAO;IAApC,YAA6B,OAAO,EAAE,MAAM,EAAI;IAEhD,OAAO,CAAC,QAAQ;IAIV,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAEhC;IAEK,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAiBtC;IAEK,SAAS,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAG3C;IAEK,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAsBzD;IAEK,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAYhD;IAEK,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtC;CACF"}
+{"version":3,"file":"reminder-store.d.ts","sourceRoot":"","sources":["../../src/internal/reminder-store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,eAAO,MAAM,yBAAyB,EAAG,CAAU,CAAC;AAEpD,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,yDAAyD;AACzD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,yBAAyB,CAAC;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,YAAY,EAAE,oBAAoB,CAAC;IACnC,4EAA4E;IAC5E,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,aAAa,EAAE,OAAO,CAAC;IACvB,yEAAyE;IACzE,UAAU,EAAE,OAAO,CAAC;IACpB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAkBxE;AAED,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,OAAO;IAApC,YAA6B,OAAO,EAAE,MAAM,EAAI;IAEhD,OAAO,CAAC,QAAQ;IAIV,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAEhC;IAEK,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAiBtC;IAEK,SAAS,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAG3C;IAEK,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAsBzD;IAEK,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAYhD;IAEK,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtC;CACF"}

package/dist/internal/reminder-store.js

@@ -18,6 +18,24 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 import { mkdir, readdir, readFile, rename, rm, writeFile, } from "node:fs/promises";
 import { join } from "node:path";
 export const REMINDER_SNAPSHOT_VERSION = 1;
+/** Narrow a sink value to a {@link ReminderRecord} (startup hydrate). */
+export function isReminderRecord(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        return false;
+    }
+    const record = value;
+    return (record.version === REMINDER_SNAPSHOT_VERSION &&
+        typeof record.id === "string" &&
+        record.id !== "" &&
+        typeof record.purpose === "string" &&
+        typeof record.channelId === "string" &&
+        typeof record.continuationToken === "string" &&
+        typeof record.scheduleKind === "string" &&
+        typeof record.scheduleValue === "string" &&
+        typeof record.status === "string" &&
+        typeof record.nextFireAtMs === "number" &&
+        Number.isFinite(record.nextFireAtMs));
+}
 export class ReminderStore {
     constructor(rootDir) {
         this.rootDir = rootDir;

package/dist/internal/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/internal/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAOhB,YAAY,EACb,MAAM,aAAa,CAAC;AAkFrB,OAAO,EAAE,KAAK,WAAW,EAAmB,MAAM,iBAAiB,CAAC;AAapE,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;CACvB;AAYD,6EAA6E;AAC7E,MAAM,WAAW,0BAA0B;IACzC,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,UAAU,EAAE,EACpB,OAAO,GAAE,YAAY,GAAG,0BAA+B,GACtD,OAAO,CAAC,gBAAgB,CAAC,CAmf3B"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/internal/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2BH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAOhB,YAAY,EACb,MAAM,aAAa,CAAC;AAmFrB,OAAO,EAAE,KAAK,WAAW,EAAmB,MAAM,iBAAiB,CAAC;AAapE,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;CACvB;AAYD,6EAA6E;AAC7E,MAAM,WAAW,0BAA0B;IACzC,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,UAAU,EAAE,EACpB,OAAO,GAAE,YAAY,GAAG,0BAA+B,GACtD,OAAO,CAAC,gBAAgB,CAAC,CAolB3B"}