@cursor/july 0.1.99 → 0.1.101

package/src/internal/null-kv-storage.ts

@@ -1,74 +0,0 @@
-/**
- * The inert KV half of hosted v2 storage.
- *
- * The control-plane KV proxy (`/internal/agent-serve/storage/*`) authorizes a
- * request by mapping the caller's pod service account to a row in the v1
- * deployment table. Architecture v2 registers its deployments in the factory
- * control plane instead, so every proxy call from a v2 pod answers
- * `403 No Agent Serve deployment is bound to this service account`. The
- * lazy-restore path deliberately propagates read failures (a store outage must
- * not read as "unknown continuation token"), so those 403s fail follow-up
- * deliveries outright.
- *
- * This backend stands in for the proxy until it can resolve v2 deployments:
- * writes are dropped, reads are definitive misses, and lists are empty. It is
- * paired with the framework file store (see framework-file-storage.ts), which
- * authorizes by store source id rather than by deployment row and therefore
- * still carries session records, event transcripts, and the continuation
- * index — the state sessions are restored from.
- *
- * Author KV is the one thing that must not silently accept writes here, since
- * handlers read their own writes back. {@link AUTHOR_KV_UNSUPPORTED} marks the
- * definition so `ctx.host.kv` falls back to `--state-root` disk instead, the
- * same fallback a deployment with no configured backend gets.
- */
-
-import type { StorageConfig } from "../storage.js";
-import type { JsonValue } from "../types.js";
-
-/**
- * Marker stamped on a definition whose KV core cannot serve `ctx.host.kv`,
- * even though `get` is present for framework session state. Explicit
- * `unique symbol` annotation required for `--isolatedDeclarations` (TS9010).
- */
-export const AUTHOR_KV_UNSUPPORTED: unique symbol = Symbol.for(
-  "@cursor/july.storage.author-kv-unsupported"
-);
-
-/** True when `value` was built from {@link nullKvStorage}. */
-export function isAuthorKvUnsupported(value: unknown): boolean {
-  return (
-    typeof value === "object" &&
-    value !== null &&
-    (value as Record<symbol, unknown>)[AUTHOR_KV_UNSUPPORTED] === true
-  );
-}
-
-type NullKvStorageMethods = Required<
-  Pick<StorageConfig, "put" | "get" | "delete" | "list">
-> & {
-  readonly [AUTHOR_KV_UNSUPPORTED]: true;
-};
-
-/**
- * A KV core that stores nothing. `get` resolving `undefined` is honest here
- * rather than dangerous: nothing was ever written, so a miss cannot shadow a
- * session that exists elsewhere.
- *
- * No `cas` group and no `listNewest`: conditional writes over a store that
- * forgets would report a lock acquired, and write-time ordering means nothing
- * without writes.
- */
-export function nullKvStorage(): NullKvStorageMethods {
-  return {
-    [AUTHOR_KV_UNSUPPORTED]: true,
-    put(): void {},
-    get(): JsonValue | undefined {
-      return undefined;
-    },
-    delete(): void {},
-    list(): [] {
-      return [];
-    },
-  };
-}