convex 1.34.0 → 1.35.0

package/src/server/impl/registration_impl.ts

@@ -11,6 +11,7 @@ import { GenericDataModel } from "../data_model.js";
 import {
   ActionBuilder,
   DefaultFunctionArgs,
+  FunctionVisibility,
   GenericActionCtx,
   GenericMutationCtx,
   GenericQueryCtx,
@@ -39,10 +40,15 @@ import { parseArgs } from "../../common/index.js";
 import { performAsyncSyscall } from "./syscall.js";
 import { asObjectValidator } from "../../values/validator.js";
 import { getFunctionAddress } from "../components/paths.js";
+import {
+  setupQueryMeta,
+  setupMutationMeta,
+  setupActionMeta,
+} from "./meta_impl.js";
 
 async function invokeMutation<
   F extends (ctx: GenericMutationCtx<GenericDataModel>, ...args: any) => any,
->(func: F, argsStr: string) {
+>(func: F, argsStr: string, visibility: FunctionVisibility) {
   // TODO(presley): Change the function signature and propagate the requestId from Rust.
   // Ok, to mock it out for now, since queries are only running in V8.
   const requestId = "";
@@ -52,6 +58,7 @@ async function invokeMutation<
     auth: setupAuth(requestId),
     storage: setupStorageWriter(requestId),
     scheduler: setupMutationScheduler(),
+    meta: setupMutationMeta(visibility),
 
     runQuery: (reference: any, args?: any) => runUdf("query", reference, args),
     runMutation: (reference: any, args?: any) =>
@@ -247,7 +254,7 @@ export const mutationGeneric: MutationBuilder<any, "public"> = ((
   assertNotBrowser();
   func.isMutation = true;
   func.isPublic = true;
-  func.invokeMutation = (argsStr) => invokeMutation(handler, argsStr);
+  func.invokeMutation = (argsStr) => invokeMutation(handler, argsStr, "public");
   func.exportArgs = exportArgs(functionDefinition);
   func.exportReturns = exportReturns(functionDefinition);
   func._handler = handler;
@@ -308,7 +315,8 @@ export const internalMutationGeneric: MutationBuilder<any, "internal"> = ((
   assertNotBrowser();
   func.isMutation = true;
   func.isInternal = true;
-  func.invokeMutation = (argsStr) => invokeMutation(handler, argsStr);
+  func.invokeMutation = (argsStr) =>
+    invokeMutation(handler, argsStr, "internal");
   func.exportArgs = exportArgs(functionDefinition);
   func.exportReturns = exportReturns(functionDefinition);
   func._handler = handler;
@@ -317,7 +325,7 @@ export const internalMutationGeneric: MutationBuilder<any, "internal"> = ((
 
 async function invokeQuery<
   F extends (ctx: GenericQueryCtx<GenericDataModel>, ...args: any) => any,
->(func: F, argsStr: string) {
+>(func: F, argsStr: string, visibility: FunctionVisibility) {
   // TODO(presley): Change the function signature and propagate the requestId from Rust.
   // Ok, to mock it out for now, since queries are only running in V8.
   const requestId = "";
@@ -326,6 +334,7 @@ async function invokeQuery<
     db: setupReader(),
     auth: setupAuth(requestId),
     storage: setupStorageReader(requestId),
+    meta: setupQueryMeta(visibility),
     runQuery: (reference: any, args?: any) => runUdf("query", reference, args),
   };
   const result = await invokeFunction(func, queryCtx, args as any);
@@ -403,7 +412,7 @@ export const queryGeneric: QueryBuilder<any, "public"> = ((
   assertNotBrowser();
   func.isQuery = true;
   func.isPublic = true;
-  func.invokeQuery = (argsStr) => invokeQuery(handler, argsStr);
+  func.invokeQuery = (argsStr) => invokeQuery(handler, argsStr, "public");
   func.exportArgs = exportArgs(functionDefinition);
   func.exportReturns = exportReturns(functionDefinition);
   func._handler = handler;
@@ -470,7 +479,8 @@ export const internalQueryGeneric: QueryBuilder<any, "internal"> = ((
   assertNotBrowser();
   func.isQuery = true;
   func.isInternal = true;
-  func.invokeQuery = (argsStr) => invokeQuery(handler as any, argsStr);
+  func.invokeQuery = (argsStr) =>
+    invokeQuery(handler as any, argsStr, "internal");
   func.exportArgs = exportArgs(functionDefinition);
   func.exportReturns = exportReturns(functionDefinition);
   func._handler = handler;
@@ -479,7 +489,7 @@ export const internalQueryGeneric: QueryBuilder<any, "internal"> = ((
 
 async function invokeAction<
   F extends (ctx: GenericActionCtx<GenericDataModel>, ...args: any) => any,
->(func: F, requestId: string, argsStr: string) {
+>(func: F, requestId: string, argsStr: string, visibility: FunctionVisibility) {
   const args = jsonToConvex(JSON.parse(argsStr));
   const calls = setupActionCalls(requestId);
   const ctx = {
@@ -488,6 +498,7 @@ async function invokeAction<
     scheduler: setupActionScheduler(requestId),
     storage: setupStorageActionWriter(requestId),
     vectorSearch: setupActionVectorSearch(requestId) as any,
+    meta: setupActionMeta(visibility),
   };
   const result = await invokeFunction(func, ctx, args as any);
   return JSON.stringify(convexToJson(result === undefined ? null : result));
@@ -577,7 +588,7 @@ export const actionGeneric: ActionBuilder<any, "public"> = ((
   func.isAction = true;
   func.isPublic = true;
   func.invokeAction = (requestId, argsStr) =>
-    invokeAction(handler, requestId, argsStr);
+    invokeAction(handler, requestId, argsStr, "public");
   func.exportArgs = exportArgs(functionDefinition);
   func.exportReturns = exportReturns(functionDefinition);
   func._handler = handler;
@@ -650,7 +661,7 @@ export const internalActionGeneric: ActionBuilder<any, "internal"> = ((
   func.isAction = true;
   func.isInternal = true;
   func.invokeAction = (requestId, argsStr) =>
-    invokeAction(handler, requestId, argsStr);
+    invokeAction(handler, requestId, argsStr, "internal");
   func.exportArgs = exportArgs(functionDefinition);
   func.exportReturns = exportReturns(functionDefinition);
   func._handler = handler;
@@ -670,6 +681,7 @@ async function invokeHttpAction<
     storage: setupStorageActionWriter(requestId),
     scheduler: setupActionScheduler(requestId),
     vectorSearch: setupActionVectorSearch(requestId) as any,
+    meta: setupActionMeta("public"),
   };
   return await invokeFunction(func, ctx, [request]);
 }

package/src/server/index.ts

@@ -103,6 +103,14 @@ export {
   internalMutationGeneric,
   internalQueryGeneric,
 } from "./impl/registration_impl.js";
+export type {
+  TransactionMetric,
+  TransactionMetrics,
+  FunctionMetadata,
+  QueryMeta,
+  MutationMeta,
+  ActionMeta,
+} from "./meta.js";
 export type { IndexRange, IndexRangeBuilder } from "./index_range_builder.js";
 export * from "./pagination.js";
 export type { OrderedQuery, Query, QueryInitializer } from "./query.js";

package/src/server/meta.ts

@@ -0,0 +1,76 @@
+import { FunctionType } from "./api.js";
+import { FunctionVisibility } from "./registration.js";
+
+/**
+ * Used and remaining amounts for a single transaction limit.
+ *
+ * @public
+ */
+export type TransactionMetric = {
+  used: number;
+  remaining: number;
+};
+
+/**
+ * The remaining headroom for a transaction before hitting limits.
+ *
+ * See https://docs.convex.dev/production/state/limits
+ *
+ * @public
+ */
+export type TransactionMetrics = {
+  bytesRead: TransactionMetric;
+  bytesWritten: TransactionMetric;
+  databaseQueries: TransactionMetric;
+  documentsRead: TransactionMetric;
+  documentsWritten: TransactionMetric;
+  functionsScheduled: TransactionMetric;
+  scheduledFunctionArgsBytes: TransactionMetric;
+};
+
+/**
+ * Metadata about the currently executing Convex function.
+ *
+ * @public
+ */
+export type FunctionMetadata = {
+  /**
+   * The name of the function, in the format `"path/to/module:functionName"`
+   */
+  name: string;
+  /**
+   * The path of the component this function belongs to.
+   * This is an empty string `""` for the app.
+   */
+  componentPath: string;
+  /** Whether it's a query, mutation, or action. */
+  type: FunctionType;
+  /** Whether the function is public or internal. */
+  visibility: FunctionVisibility;
+};
+
+/**
+ * Extra context available in Convex query functions.
+ *
+ * @public
+ */
+export interface QueryMeta {
+  getFunctionMetadata(): Promise<FunctionMetadata>;
+  getTransactionMetrics(): Promise<TransactionMetrics>;
+}
+
+/**
+ * Extra context available in Convex mutation functions.
+ *
+ * @public
+ */
+export interface MutationMeta extends QueryMeta {}
+
+/**
+ * Extra context available in Convex action functions.
+ *
+ * @public
+ */
+export interface ActionMeta {
+  getFunctionMetadata(): Promise<FunctionMetadata>;
+}

package/src/server/registration.ts

@@ -8,6 +8,7 @@ import {
   StorageReader,
   StorageWriter,
 } from "./index.js";
+import { ActionMeta, MutationMeta, QueryMeta } from "./meta.js";
 import {
   FunctionReference,
   FunctionReturnType,
@@ -147,6 +148,9 @@ export interface GenericMutationCtx<DataModel extends GenericDataModel> {
     mutation: Mutation,
     ...args: OptionalRestArgs<Mutation>
   ) => Promise<FunctionReturnType<Mutation>>;
+
+  /** @internal */
+  meta: MutationMeta;
 }
 
 /**
@@ -238,6 +242,9 @@ export interface GenericQueryCtx<DataModel extends GenericDataModel> {
     query: Query,
     ...args: OptionalRestArgs<Query>
   ) => Promise<FunctionReturnType<Query>>;
+
+  /** @internal */
+  meta: QueryMeta;
 }
 
 /**
@@ -398,6 +405,9 @@ export interface GenericActionCtx<DataModel extends GenericDataModel> {
       VectorSearchQuery<NamedTableInfo<DataModel, TableName>, IndexName>
     >,
   ): Promise<Array<{ _id: Id<TableName>; _score: number }>>;
+
+  /** @internal */
+  meta: ActionMeta;
 }
 
 /**

package/src/server/schema.test.ts

@@ -7,8 +7,16 @@ import {
   defineSchema,
   defineTable,
   DataModelFromSchemaDefinition,
+  GenericSchema,
+  SchemaDefinition,
 } from "./schema.js";
 import { v, Infer } from "../values/validator.js";
+import {
+  AnyDataModel,
+  GenericDataModel,
+  IndexNames,
+  NamedTableInfo,
+} from "./data_model.js";
 
 describe("DataModelFromSchemaDefinition", () => {
   test("defineSchema produces the correct data model for basic types", () => {
@@ -405,7 +413,7 @@ describe("DataModelFromSchemaDefinition", () => {
       [tableName: string]: {
         document: any;
         fieldPaths: string;
-        indexes: {};
+        indexes: SystemIndexes;
         searchIndexes: {};
         vectorIndexes: {};
       };
@@ -890,6 +898,75 @@ describe("defineSchema/defineTable expose table validators", () => {
   });
 });
 
+describe("GenericSchema assignability", () => {
+  test("DataModelFromSchemaDefinition<GenericSchema> extends GenericDataModel", () => {
+    type GenericDM = DataModelFromSchemaDefinition<
+      SchemaDefinition<GenericSchema, boolean>
+    >;
+    type _check = GenericDM extends GenericDataModel ? true : false;
+    assert<Equals<_check, true>>();
+  });
+
+  test("a specific schema’s DataModel extends GenericDataModel", () => {
+    const specificSchema = defineSchema({
+      users: defineTable({ name: v.string() }).index("by_name", ["name"]),
+    });
+    type SpecificDM = DataModelFromSchemaDefinition<typeof specificSchema>;
+
+    // This is the key assignability check: specific DataModels must extend
+    // GenericDataModel so that generic code can accept any schema.
+    type _check = SpecificDM extends GenericDataModel ? true : false;
+    assert<Equals<_check, true>>();
+  });
+
+  test("SchemaDefinition<SpecificSchema> extends SchemaDefinition<GenericSchema, boolean>", () => {
+    const specificSchema = defineSchema({
+      messages: defineTable({ body: v.string() }),
+    });
+    type SpecificSD = typeof specificSchema;
+    type GenericSD = SchemaDefinition<GenericSchema, boolean>;
+
+    type _check = SpecificSD extends GenericSD ? true : false;
+    assert<Equals<_check, true>>();
+  });
+
+  test("specific DM from boolean-strict schema extends generic DM", () => {
+    // This mirrors the convexTest() return type: Schema is specific, but
+    // StrictTableNameTypes is widened to boolean.
+    const specificSchema = defineSchema({
+      users: defineTable({ name: v.string() }).index("by_name", ["name"]),
+    });
+    type SpecificDM = DataModelFromSchemaDefinition<
+      SchemaDefinition<(typeof specificSchema)["tables"], boolean>
+    >;
+    type GenericDM = DataModelFromSchemaDefinition<
+      SchemaDefinition<GenericSchema, boolean>
+    >;
+
+    // The specific DM must extend the generic DM for TestConvex covariance.
+    type _check = SpecificDM extends GenericDM ? true : false;
+    assert<Equals<_check, true>>();
+  });
+
+  test("AnyDataModel exposes system indexes", () => {
+    // AnyDataModel is used as the DataModel when no schema is defined.
+    // Verify that system indexes (by_id, by_creation_time) are available,
+    // since every table always has them.
+    type AnyTable = NamedTableInfo<AnyDataModel, string>;
+    type AnyIndexNames = IndexNames<AnyTable>;
+    type _check = "by_id" | "by_creation_time" extends AnyIndexNames
+      ? true
+      : false;
+    assert<Equals<_check, true>>();
+  });
+
+  // SpecificDM extends GenericDM because:
+  // 1. GenericSchema uses TableDefinition defaults (Validator<any,any,any>)
+  //    producing document: any and fieldPaths: any
+  // 2. AnyDataModel includes SystemIndexes, so the loose variant's index
+  //    signature satisfies GenericDM's SystemIndexes requirement
+});
+
 test("defineTable fails if it can’t export the validator", () => {
   const table = defineTable(
     // @ts-expect-error

package/dist/cjs/cli/lib/ai/config.js

@@ -1,144 +0,0 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var config_exports = {};
-__export(config_exports, {
-  aiFilesSchema: () => aiFilesSchema,
-  readAiConfig: () => readAiConfig,
-  writeAiConfig: () => writeAiConfig,
-  writeAiDisabledToProjectConfig: () => writeAiDisabledToProjectConfig
-});
-module.exports = __toCommonJS(config_exports);
-var Sentry = __toESM(require("@sentry/node"), 1);
-var import_fs = require("fs");
-var import_path = __toESM(require("path"), 1);
-var import_zod = require("zod");
-var import_paths = require("./paths.js");
-const aiFilesStateSchema = import_zod.z.object({
-  guidelinesHash: import_zod.z.string().nullable(),
-  agentsMdSectionHash: import_zod.z.string().nullable(),
-  claudeMdHash: import_zod.z.string().nullable(),
-  // Commit SHA from get-convex/agent-skills that was current when skills were
-  // last installed. Used to detect when newer skills are available.
-  agentSkillsSha: import_zod.z.string().nullable(),
-  // Names of skills installed by `npx skills add`, used by `remove` to
-  // only remove Convex-managed skills.
-  installedSkillNames: import_zod.z.array(import_zod.z.string()).default([])
-});
-const aiFilesProjectConfigSchema = import_zod.z.object({
-  aiFiles: import_zod.z.object({
-    disableStalenessMessage: import_zod.z.boolean().default(false)
-  }).default({ disableStalenessMessage: false })
-}).passthrough();
-const aiFilesSchema = aiFilesStateSchema;
-const EMPTY_AI_STATE = {
-  guidelinesHash: null,
-  agentsMdSectionHash: null,
-  claudeMdHash: null,
-  agentSkillsSha: null,
-  installedSkillNames: []
-};
-async function readAiDisabledFromProjectConfig(projectDir) {
-  let raw;
-  try {
-    raw = await import_fs.promises.readFile(import_path.default.join(projectDir, "convex.json"), "utf8");
-  } catch {
-    return false;
-  }
-  try {
-    const parsed = aiFilesProjectConfigSchema.parse(JSON.parse(raw));
-    return parsed.aiFiles.disableStalenessMessage;
-  } catch (err) {
-    Sentry.captureException(err);
-    return false;
-  }
-}
-async function writeAiDisabledToProjectConfig(disableStalenessMessage, projectDir) {
-  const filePath = import_path.default.join(projectDir, "convex.json");
-  let existing = {};
-  try {
-    existing = JSON.parse(await import_fs.promises.readFile(filePath, "utf8"));
-  } catch {
-  }
-  const base = existing !== null && typeof existing === "object" && !Array.isArray(existing) ? existing : {};
-  const aiFilesValue = base.aiFiles !== null && typeof base.aiFiles === "object" && !Array.isArray(base.aiFiles) ? base.aiFiles : {};
-  const { $schema, ...rest } = base;
-  const next = {
-    $schema: $schema ?? "node_modules/convex/schemas/convex.schema.json",
-    ...rest,
-    aiFiles: {
-      ...aiFilesValue,
-      disableStalenessMessage
-    }
-  };
-  await import_fs.promises.writeFile(filePath, JSON.stringify(next, null, 2) + "\n", "utf8");
-}
-async function readAiConfig(projectDir, convexDir) {
-  const disableStalenessMessage = await readAiDisabledFromProjectConfig(projectDir);
-  let rawState;
-  try {
-    rawState = await import_fs.promises.readFile(
-      (0, import_paths.aiFilesStatePathForConvexDir)(convexDir),
-      "utf8"
-    );
-  } catch {
-    return disableStalenessMessage ? { ...EMPTY_AI_STATE, disableStalenessMessage } : null;
-  }
-  try {
-    const state = aiFilesStateSchema.parse(JSON.parse(rawState));
-    return {
-      ...state,
-      disableStalenessMessage
-    };
-  } catch (err) {
-    Sentry.captureException(err);
-    return null;
-  }
-}
-async function writeAiConfig(config, projectDir, convexDir, options) {
-  const state = aiFilesStateSchema.parse({
-    guidelinesHash: config.guidelinesHash,
-    agentsMdSectionHash: config.agentsMdSectionHash,
-    claudeMdHash: config.claudeMdHash,
-    agentSkillsSha: config.agentSkillsSha,
-    installedSkillNames: config.installedSkillNames
-  });
-  await import_fs.promises.writeFile(
-    (0, import_paths.aiFilesStatePathForConvexDir)(convexDir),
-    JSON.stringify(state, null, 2) + "\n",
-    "utf8"
-  );
-  const persistMode = options?.persistDisabledPreference ?? "ifTrue";
-  if (persistMode === "always" || persistMode === "ifTrue" && config.disableStalenessMessage) {
-    await writeAiDisabledToProjectConfig(
-      config.disableStalenessMessage,
-      projectDir
-    );
-  }
-}
-//# sourceMappingURL=config.js.map

package/dist/cjs/cli/lib/ai/config.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../../src/cli/lib/ai/config.ts"],
-  "sourcesContent": ["import * as Sentry from \"@sentry/node\";\n// Use raw fs (not ctx.fs) so these operations run asynchronously and don't\n// interfere with the file-watcher used by `convex dev`.\n// eslint-disable-next-line no-restricted-imports\nimport { promises as fs } from \"fs\";\nimport path from \"path\";\nimport { z } from \"zod\";\nimport { aiFilesStatePathForConvexDir } from \"./paths.js\";\n\nconst aiFilesStateSchema = z.object({\n  guidelinesHash: z.string().nullable(),\n  agentsMdSectionHash: z.string().nullable(),\n  claudeMdHash: z.string().nullable(),\n  // Commit SHA from get-convex/agent-skills that was current when skills were\n  // last installed. Used to detect when newer skills are available.\n  agentSkillsSha: z.string().nullable(),\n  // Names of skills installed by `npx skills add`, used by `remove` to\n  // only remove Convex-managed skills.\n  installedSkillNames: z.array(z.string()).default([]),\n});\n\nconst aiFilesProjectConfigSchema = z\n  .object({\n    aiFiles: z\n      .object({\n        disableStalenessMessage: z.boolean().default(false),\n      })\n      .default({ disableStalenessMessage: false }),\n  })\n  .passthrough();\n\nexport const aiFilesSchema = aiFilesStateSchema;\n\ntype AiFilesState = z.infer<typeof aiFilesStateSchema>;\nexport type AiFilesConfig = AiFilesState & {\n  disableStalenessMessage: boolean;\n};\n\nconst EMPTY_AI_STATE: AiFilesState = {\n  guidelinesHash: null,\n  agentsMdSectionHash: null,\n  claudeMdHash: null,\n  agentSkillsSha: null,\n  installedSkillNames: [],\n};\n\nasync function readAiDisabledFromProjectConfig(\n  projectDir: string,\n): Promise<boolean> {\n  let raw: string;\n  try {\n    raw = await fs.readFile(path.join(projectDir, \"convex.json\"), \"utf8\");\n  } catch {\n    return false;\n  }\n  try {\n    const parsed = aiFilesProjectConfigSchema.parse(JSON.parse(raw));\n    return parsed.aiFiles.disableStalenessMessage;\n  } catch (err) {\n    Sentry.captureException(err);\n    return false;\n  }\n}\n\nexport async function writeAiDisabledToProjectConfig(\n  disableStalenessMessage: boolean,\n  projectDir: string,\n): Promise<void> {\n  const filePath = path.join(projectDir, \"convex.json\");\n  let existing: unknown = {};\n  try {\n    existing = JSON.parse(await fs.readFile(filePath, \"utf8\"));\n  } catch {\n    // Use a minimal object when convex.json doesn't exist yet or is unreadable.\n  }\n  const base =\n    existing !== null &&\n    typeof existing === \"object\" &&\n    !Array.isArray(existing)\n      ? (existing as Record<string, unknown>)\n      : {};\n  const aiFilesValue =\n    base.aiFiles !== null &&\n    typeof base.aiFiles === \"object\" &&\n    !Array.isArray(base.aiFiles)\n      ? (base.aiFiles as Record<string, unknown>)\n      : {};\n  const { $schema, ...rest } = base;\n  const next: Record<string, unknown> = {\n    $schema: $schema ?? \"node_modules/convex/schemas/convex.schema.json\",\n    ...rest,\n    aiFiles: {\n      ...aiFilesValue,\n      disableStalenessMessage,\n    },\n  };\n  await fs.writeFile(filePath, JSON.stringify(next, null, 2) + \"\\n\", \"utf8\");\n}\n\nexport async function readAiConfig(\n  projectDir: string,\n  convexDir: string,\n): Promise<AiFilesConfig | null> {\n  const disableStalenessMessage =\n    await readAiDisabledFromProjectConfig(projectDir);\n  let rawState: string;\n  try {\n    rawState = await fs.readFile(\n      aiFilesStatePathForConvexDir(convexDir),\n      \"utf8\",\n    );\n  } catch {\n    // No state file means AI files are not installed, unless the user has\n    // explicitly disabled install/staleness messages in convex.json.\n    return disableStalenessMessage\n      ? { ...EMPTY_AI_STATE, disableStalenessMessage }\n      : null;\n  }\n  try {\n    const state = aiFilesStateSchema.parse(JSON.parse(rawState));\n    return {\n      ...state,\n      disableStalenessMessage,\n    };\n  } catch (err) {\n    Sentry.captureException(err);\n    return null;\n  }\n}\n\nexport async function writeAiConfig(\n  config: AiFilesConfig,\n  projectDir: string,\n  convexDir: string,\n  options?: { persistDisabledPreference?: \"ifTrue\" | \"always\" | \"never\" },\n): Promise<void> {\n  const state = aiFilesStateSchema.parse({\n    guidelinesHash: config.guidelinesHash,\n    agentsMdSectionHash: config.agentsMdSectionHash,\n    claudeMdHash: config.claudeMdHash,\n    agentSkillsSha: config.agentSkillsSha,\n    installedSkillNames: config.installedSkillNames,\n  });\n  await fs.writeFile(\n    aiFilesStatePathForConvexDir(convexDir),\n    JSON.stringify(state, null, 2) + \"\\n\",\n    \"utf8\",\n  );\n  const persistMode = options?.persistDisabledPreference ?? \"ifTrue\";\n  if (\n    persistMode === \"always\" ||\n    (persistMode === \"ifTrue\" && config.disableStalenessMessage)\n  ) {\n    await writeAiDisabledToProjectConfig(\n      config.disableStalenessMessage,\n      projectDir,\n    );\n  }\n}\n"],
-  "mappings": "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",
-  "names": ["fs", "path"]
-}