farming-code 2.2.29 → 2.2.32

package/backend/farming-session-store.cjs

@@ -0,0 +1,651 @@
+// Generated by scripts/build-backend-runtime.ts. Do not edit.
+"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 farming_session_store_exports = {};
+__export(farming_session_store_exports, {
+  AGENT_RECORD_VERSION: () => AGENT_RECORD_VERSION,
+  AGENT_STATE_VERSION: () => AGENT_STATE_VERSION,
+  FarmingSessionStore: () => FarmingSessionStore,
+  MAX_MAIN_PAGE_SESSION_KEYS: () => MAX_MAIN_PAGE_SESSION_KEYS,
+  SESSION_INDEX_VERSION: () => SESSION_INDEX_VERSION,
+  parseProviderSessionKey: () => parseProviderSessionKey
+});
+module.exports = __toCommonJS(farming_session_store_exports);
+var import_atomic_json_store = require("./atomic-json-store.cjs");
+var import_agent_runtime_binding = require("./agent-runtime-binding.cjs");
+var import_agent_lifecycle_journal = require("./agent-lifecycle-journal.cjs");
+var storageLayout = __toESM(require("./storage-layout.cjs"));
+const crypto = require("crypto");
+const fs = require("fs");
+const path = require("path");
+const { isDeepStrictEqual } = require("util");
+function objectRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+const AGENT_RECORD_ID_PREFIX = "agent";
+const AGENT_RECORD_VERSION = 1;
+const AGENT_STATE_VERSION = 1;
+const SESSION_INDEX_VERSION = 2;
+const MAX_MAIN_PAGE_SESSION_KEYS = 50;
+const AGENT_STATE_FIELDS = [
+  "acpState",
+  "acpError",
+  "acpStopReason",
+  "acpPendingPermission",
+  "acpPendingPermissions",
+  "acpPendingElicitation",
+  "acpPendingElicitations",
+  "acpActiveElicitations",
+  "acpSessionUpdatedAt",
+  "acpSessionRevision",
+  "jsonCliState",
+  "jsonCliError",
+  "jsonCliTranscriptUpdatedAt",
+  "attentionSeq",
+  "readAttentionSeq",
+  "attentionUpdatedAt",
+  "readAttentionAt",
+  "attentionReason",
+  "attentionOutputEpoch",
+  "attentionOutputSeq",
+  "readOutputEpoch",
+  "readOutputSeq",
+  "unread",
+  "composerCommands"
+];
+const AGENT_STATE_FIELD_SET = new Set(AGENT_STATE_FIELDS);
+const PRODUCT_STATE_FIELDS = [
+  "projectWorkspace",
+  "task",
+  "workflowTemplate",
+  "pinned",
+  "projectOrder",
+  "pinnedOrder",
+  "attentionSeq",
+  "readAttentionSeq",
+  "attentionUpdatedAt",
+  "readAttentionAt",
+  "attentionReason",
+  "attentionOutputEpoch",
+  "attentionOutputSeq",
+  "readOutputEpoch",
+  "readOutputSeq",
+  "customTitle"
+];
+function now() {
+  return Date.now();
+}
+function createAgentRecordId() {
+  const stamp = now().toString(36);
+  const random = crypto.randomBytes(6).toString("hex");
+  return `${AGENT_RECORD_ID_PREFIX}_${stamp}_${random}`;
+}
+function safeSessionFileName(id) {
+  const value = String(id || "").trim();
+  return /^(?:agent|fsess)_[A-Za-z0-9_-]+$/.test(value) ? `${value}.json` : "";
+}
+function isLegacySessionId(id) {
+  return /^fsess_[A-Za-z0-9_-]+$/.test(String(id || "").trim());
+}
+function isAgentRecordId(id) {
+  return /^agent_[A-Za-z0-9_-]+$/.test(String(id || "").trim());
+}
+function agentRecordIdFor(agent) {
+  if (agent && Object.prototype.hasOwnProperty.call(agent, "persistentSessionId")) {
+    return typeof agent.persistentSessionId === "string" ? agent.persistentSessionId : "";
+  }
+  return typeof agent?.agentRecordId === "string" ? agent.agentRecordId : "";
+}
+function cloneJson(value) {
+  if (value === void 0) return value;
+  return JSON.parse(JSON.stringify(value));
+}
+function sameJson(left, right) {
+  return isDeepStrictEqual(left, right);
+}
+function withoutUpdatedAt(value) {
+  const copy = { ...value || {} };
+  delete copy.updatedAt;
+  return copy;
+}
+function parseProviderSessionKey(key) {
+  const match = String(key || "").match(/^agent-session:([^:]+):(.+)$/);
+  if (!match) return null;
+  const provider = String(match[1] || "").trim().toLowerCase();
+  let sessionId = String(match[2] || "").trim();
+  let providerHomeId = "default";
+  const homeMatch = sessionId.match(/^home:([A-Za-z0-9._-]+):(.+)$/);
+  if (homeMatch) {
+    providerHomeId = homeMatch[1];
+    sessionId = String(homeMatch[2] || "").trim();
+  }
+  if (!provider || !sessionId) return null;
+  return { provider, providerHomeId, sessionId };
+}
+class FarmingSessionStore {
+  configDir;
+  sessionsDir;
+  indexFile;
+  normalizeMainPageSessionKeys;
+  writeJson;
+  index;
+  legacyProviderSessionRecords;
+  providerSessionRecords;
+  constructor(configDir, options = {}) {
+    this.configDir = configDir;
+    this.sessionsDir = storageLayout.sessionsDir(configDir);
+    this.indexFile = storageLayout.sessionIndexFile(configDir);
+    this.normalizeMainPageSessionKeys = typeof options.normalizeMainPageSessionKeys === "function" ? options.normalizeMainPageSessionKeys : (keys) => (Array.isArray(keys) ? keys.filter((key) => typeof key === "string") : []).slice(0, MAX_MAIN_PAGE_SESSION_KEYS);
+    this.writeJson = typeof options.writeJson === "function" ? options.writeJson : (file, value) => (0, import_atomic_json_store.atomicWriteJson)(file, value, { mode: 384 });
+    this.index = null;
+    this.legacyProviderSessionRecords = {};
+    this.providerSessionRecords = /* @__PURE__ */ new Map();
+  }
+  init({ legacyMainPageSessionKeys = [] } = {}) {
+    fs.mkdirSync(this.sessionsDir, { recursive: true });
+    this.index = this.readIndex();
+    this.reconcileProviderSessionIndex();
+    let nextMainPageSessionKeys = this.index.mainPageSessionKeys;
+    if (!Array.isArray(this.index.mainPageSessionKeys) || this.index.mainPageSessionKeys.length === 0) {
+      const migrated = this.filterRecoverableMainPageSessionKeys(legacyMainPageSessionKeys);
+      if (migrated.length > 0) {
+        nextMainPageSessionKeys = migrated;
+      }
+    }
+    nextMainPageSessionKeys = this.filterRecoverableMainPageSessionKeys(nextMainPageSessionKeys);
+    nextMainPageSessionKeys.forEach((sessionKey) => {
+      if (this.getRecordForProviderSessionKey(sessionKey)) return;
+      this.ensureRecordForProviderSessionKey(sessionKey, {
+        archived: false,
+        lastSeenAt: now()
+      });
+    });
+    this.writeIndex({ ...this.index, mainPageSessionKeys: nextMainPageSessionKeys });
+    this.legacyProviderSessionRecords = {};
+  }
+  reconcileProviderSessionIndex() {
+    const recordsByProviderKey = /* @__PURE__ */ new Map();
+    const records = this.listStoredAgentRecords();
+    const successors = this.legacySuccessors(records);
+    for (const record of records) {
+      if (successors.has(record.id)) continue;
+      const sessionKey = String(record?.providerSessionKey || "");
+      if (!record || record.kind !== "agent" || !parseProviderSessionKey(sessionKey)) continue;
+      const matches = recordsByProviderKey.get(sessionKey) || [];
+      matches.push(record);
+      recordsByProviderKey.set(sessionKey, matches);
+    }
+    const providerSessionRecords = /* @__PURE__ */ new Map();
+    for (const [sessionKey, records2] of recordsByProviderKey) {
+      if (records2.length > 1) {
+        const ids = records2.map((record) => record.id).sort().join(", ");
+        throw new Error(`Conflicting Farming session records for ${sessionKey}: ${ids}`);
+      }
+      providerSessionRecords.set(sessionKey, records2[0].id);
+    }
+    for (const [sessionKey, id] of Object.entries(this.legacyProviderSessionRecords)) {
+      if (providerSessionRecords.has(sessionKey)) continue;
+      const record = this.readRecord(id);
+      if (!record || successors.has(record.id)) continue;
+      if (record.providerSessionKey && record.providerSessionKey !== sessionKey) {
+        throw new Error(`Farming session ${id} is indexed as ${sessionKey} but bound to ${record.providerSessionKey}`);
+      }
+      providerSessionRecords.set(sessionKey, record.id);
+    }
+    this.providerSessionRecords = providerSessionRecords;
+  }
+  filterRecoverableMainPageSessionKeys(keys) {
+    return this.normalizeMainPageSessionKeys(keys).filter((sessionKey) => {
+      const record = this.getRecordForProviderSessionKey(sessionKey);
+      if (!record) return true;
+      if (record.archived === true) return false;
+      const entries = (0, import_agent_lifecycle_journal.lifecycleJournal)(record).entries;
+      const latest = entries.length > 0 ? entries[entries.length - 1] : null;
+      return !(latest && ["delete", "archive"].includes(latest.type) && latest.state === "succeeded");
+    });
+  }
+  readIndex() {
+    try {
+      if (fs.existsSync(this.indexFile)) {
+        const parsed = objectRecord(JSON.parse(fs.readFileSync(this.indexFile, "utf8")));
+        this.legacyProviderSessionRecords = this.normalizeProviderSessionRecords(parsed?.providerSessionRecords);
+        return this.normalizeIndex(parsed);
+      }
+    } catch (error) {
+      console.warn("Failed to read Farming session index:", error instanceof Error ? error.message : error);
+    }
+    return this.normalizeIndex({});
+  }
+  normalizeIndex(index) {
+    return {
+      version: SESSION_INDEX_VERSION,
+      mainPageSessionKeys: this.normalizeMainPageSessionKeys(index?.mainPageSessionKeys),
+      updatedAt: typeof index?.updatedAt === "number" ? index.updatedAt : now()
+    };
+  }
+  normalizeProviderSessionRecords(providerSessionRecords) {
+    const normalizedProviderSessionRecords = {};
+    Object.entries(
+      providerSessionRecords && typeof providerSessionRecords === "object" && !Array.isArray(providerSessionRecords) ? providerSessionRecords : {}
+    ).forEach(([key, id]) => {
+      if (!parseProviderSessionKey(key)) return;
+      if (!safeSessionFileName(id)) return;
+      normalizedProviderSessionRecords[key] = String(id);
+    });
+    return normalizedProviderSessionRecords;
+  }
+  ensureIndex() {
+    if (!this.index) this.init();
+    if (!this.index) throw new Error("Farming session index initialization failed");
+    return this.index;
+  }
+  writeIndex(index = this.ensureIndex()) {
+    const nextIndex = this.normalizeIndex({ ...index, updatedAt: now() });
+    this.writeJson(this.indexFile, nextIndex);
+    this.index = nextIndex;
+    return nextIndex;
+  }
+  sessionFile(id) {
+    const fileName = safeSessionFileName(id);
+    return fileName ? path.join(this.sessionsDir, fileName) : "";
+  }
+  agentStateFile(id) {
+    return isAgentRecordId(id) ? storageLayout.agentStateFile(this.configDir, String(id)) : "";
+  }
+  readMetadataRecord(id) {
+    const file = this.sessionFile(id);
+    if (!file) return null;
+    try {
+      if (!fs.existsSync(file)) return null;
+      const parsed = objectRecord(JSON.parse(fs.readFileSync(file, "utf8")));
+      return parsed;
+    } catch {
+      return null;
+    }
+  }
+  readAgentState(id) {
+    const file = this.agentStateFile(id);
+    if (!file) return null;
+    try {
+      if (!fs.existsSync(file)) return null;
+      const parsed = objectRecord(JSON.parse(fs.readFileSync(file, "utf8")));
+      if (!parsed || typeof parsed !== "object" || parsed.agentRecordId !== id || parsed.agentStateVersion !== AGENT_STATE_VERSION) {
+        return null;
+      }
+      return {
+        ...parsed,
+        agentRecordId: id,
+        agentStateVersion: AGENT_STATE_VERSION
+      };
+    } catch {
+      return null;
+    }
+  }
+  readRecord(id) {
+    const metadata = this.readMetadataRecord(id);
+    if (!metadata) return null;
+    if (!isAgentRecordId(id)) return metadata;
+    const state = this.readAgentState(id);
+    if (!state) return { ...metadata, agentRecordId: id };
+    const merged = { ...metadata, agentRecordId: id };
+    AGENT_STATE_FIELDS.forEach((field) => {
+      if (Object.prototype.hasOwnProperty.call(state, field)) merged[field] = cloneJson(state[field]);
+    });
+    return merged;
+  }
+  splitAgentRecord(record, id) {
+    const metadata = {};
+    const state = {
+      agentStateVersion: AGENT_STATE_VERSION,
+      agentRecordId: id,
+      kind: "agent-state"
+    };
+    Object.entries(record || {}).forEach(([field, value]) => {
+      if (AGENT_STATE_FIELD_SET.has(field)) state[field] = cloneJson(value);
+      else metadata[field] = cloneJson(value);
+    });
+    metadata.id = id;
+    metadata.agentRecordId = id;
+    metadata.kind = "agent";
+    metadata.recordVersion = AGENT_RECORD_VERSION;
+    return { metadata, state };
+  }
+  promoteIndexRecordId(previousId, nextId) {
+    if (!previousId || previousId === nextId) return;
+    for (const [key, id] of this.providerSessionRecords) {
+      if (id === previousId) this.providerSessionRecords.set(key, nextId);
+    }
+  }
+  writeRecord(record) {
+    if (!record || !safeSessionFileName(record.id)) return "";
+    const previousId = record.id;
+    const id = isLegacySessionId(previousId) ? createAgentRecordId() : previousId;
+    if (!isAgentRecordId(id)) return "";
+    const promoted = id !== previousId;
+    const nextRecord = {
+      ...record,
+      id,
+      agentRecordId: id,
+      ...promoted ? { legacyRecordId: previousId } : {}
+    };
+    const { metadata, state } = this.splitAgentRecord(nextRecord, id);
+    const existingMetadata = this.readMetadataRecord(id);
+    const existingState = this.readAgentState(id);
+    const metadataChanged = !existingMetadata || !sameJson(withoutUpdatedAt(existingMetadata), withoutUpdatedAt(metadata));
+    const stateChanged = !existingState || !sameJson(withoutUpdatedAt(existingState), withoutUpdatedAt(state));
+    if (stateChanged) {
+      state.updatedAt = now();
+      this.writeJson(this.agentStateFile(id), state);
+    }
+    if (metadataChanged) {
+      metadata.updatedAt = now();
+      this.writeJson(this.sessionFile(id), metadata);
+    }
+    if (promoted) this.promoteIndexRecordId(previousId, id);
+    return id;
+  }
+  listStoredAgentRecords() {
+    let names = [];
+    try {
+      names = fs.readdirSync(this.sessionsDir);
+    } catch {
+      return [];
+    }
+    return names.filter((name) => name.endsWith(".json") && !name.endsWith(".state.json")).map((name) => name.slice(0, -5)).filter((id) => safeSessionFileName(id)).map((id) => this.readRecord(id)).filter((record) => record !== null && record.kind === "agent");
+  }
+  legacySuccessors(records) {
+    const successors = /* @__PURE__ */ new Map();
+    for (const record of Array.isArray(records) ? records : []) {
+      const legacyId = String(record?.legacyRecordId || "").trim();
+      if (!isLegacySessionId(legacyId)) continue;
+      const previous = successors.get(legacyId);
+      if (previous && previous !== record.id) {
+        throw new Error(`Conflicting Agent record successors for ${legacyId}: ${previous}, ${record.id}`);
+      }
+      successors.set(legacyId, record.id);
+    }
+    return successors;
+  }
+  providerSessionKeyForAgent(agent) {
+    if (!agent || agent.providerSessionTemporary === true) return "";
+    if (typeof agent.providerSessionKey === "string" && agent.providerSessionKey) {
+      return agent.providerSessionKey;
+    }
+    if (agent.providerSessionProvider && agent.providerSessionId) {
+      const homeId = typeof agent.providerHomeId === "string" ? agent.providerHomeId.trim() : "";
+      return homeId && homeId !== "default" ? `agent-session:${agent.providerSessionProvider}:home:${homeId}:${agent.providerSessionId}` : `agent-session:${agent.providerSessionProvider}:${agent.providerSessionId}`;
+    }
+    return "";
+  }
+  recordPatchFromAgent(agent) {
+    const providerSessionKey = this.providerSessionKeyForAgent(agent);
+    const parsed = parseProviderSessionKey(providerSessionKey);
+    return {
+      runtimeAgentId: typeof agent.id === "string" ? agent.id : "",
+      command: typeof agent.command === "string" ? agent.command : "",
+      forkCommand: typeof agent.forkCommand === "string" ? agent.forkCommand : "",
+      cwd: typeof agent.cwd === "string" ? agent.cwd : "",
+      projectWorkspace: typeof agent.projectWorkspace === "string" ? agent.projectWorkspace : "",
+      mainWorkspace: typeof agent.mainWorkspace === "string" ? agent.mainWorkspace : "",
+      source: typeof agent.source === "string" ? agent.source : "",
+      parentAgentId: typeof agent.parentAgentId === "string" ? agent.parentAgentId : "",
+      forkRequestId: typeof agent.forkRequestId === "string" ? agent.forkRequestId : "",
+      provider: parsed ? parsed.provider : typeof agent.providerSessionProvider === "string" ? agent.providerSessionProvider : "",
+      providerHomeId: parsed ? parsed.providerHomeId : typeof agent.providerHomeId === "string" ? agent.providerHomeId : "",
+      providerHomePath: typeof agent.providerHomePath === "string" ? agent.providerHomePath : "",
+      providerSessionId: parsed ? parsed.sessionId : typeof agent.providerSessionId === "string" ? agent.providerSessionId : "",
+      providerSessionKey,
+      providerSessionTemporary: agent.providerSessionTemporary === true,
+      providerSessionSource: typeof agent.providerSessionSource === "string" ? agent.providerSessionSource : "",
+      providerSessionResolvedAt: typeof agent.providerSessionResolvedAt === "number" ? agent.providerSessionResolvedAt : null,
+      providerSessionTitle: typeof agent.providerSessionTitle === "string" ? agent.providerSessionTitle : "",
+      providerSessionWorkspace: typeof agent.providerSessionWorkspace === "string" ? agent.providerSessionWorkspace : "",
+      forkedFromProviderSessionId: typeof agent.forkedFromProviderSessionId === "string" ? agent.forkedFromProviderSessionId : "",
+      terminalInputReceived: agent.terminalInputReceived === true,
+      structuredRuntimeProcess: agent.structuredRuntimeProcess && typeof agent.structuredRuntimeProcess === "object" ? JSON.parse(JSON.stringify(agent.structuredRuntimeProcess)) : null,
+      legacyAcpProcessExitAcknowledgedAt: typeof agent.legacyAcpProcessExitAcknowledgedAt === "number" ? agent.legacyAcpProcessExitAcknowledgedAt : null,
+      ...agent.lifecycleJournal ? { lifecycleJournal: (0, import_agent_lifecycle_journal.lifecycleJournal)(agent) } : {},
+      ...(0, import_agent_runtime_binding.legacyRuntimeMetadata)(agent),
+      engine: typeof agent.engineName === "string" ? agent.engineName : "",
+      category: typeof agent.category === "string" ? agent.category : "",
+      task: typeof agent.task === "string" ? agent.task : "",
+      workflowTemplate: typeof agent.workflowTemplate === "string" ? agent.workflowTemplate : "",
+      wantsMain: agent.wantsMain === true,
+      pinned: agent.pinned === true,
+      projectOrder: typeof agent.projectOrder === "number" && Number.isFinite(agent.projectOrder) ? agent.projectOrder : null,
+      pinnedOrder: typeof agent.pinnedOrder === "number" && Number.isFinite(agent.pinnedOrder) ? agent.pinnedOrder : null,
+      attentionSeq: typeof agent.attentionSeq === "number" && Number.isFinite(agent.attentionSeq) ? Math.max(0, Math.floor(agent.attentionSeq)) : 0,
+      readAttentionSeq: typeof agent.readAttentionSeq === "number" && Number.isFinite(agent.readAttentionSeq) ? Math.max(0, Math.floor(agent.readAttentionSeq)) : 0,
+      attentionUpdatedAt: typeof agent.attentionUpdatedAt === "number" ? agent.attentionUpdatedAt : null,
+      readAttentionAt: typeof agent.readAttentionAt === "number" ? agent.readAttentionAt : null,
+      attentionReason: typeof agent.attentionReason === "string" ? agent.attentionReason : "",
+      attentionOutputEpoch: typeof agent.attentionOutputEpoch === "string" ? agent.attentionOutputEpoch : "",
+      attentionOutputSeq: typeof agent.attentionOutputSeq === "number" ? agent.attentionOutputSeq : null,
+      readOutputEpoch: typeof agent.readOutputEpoch === "string" ? agent.readOutputEpoch : "",
+      readOutputSeq: typeof agent.readOutputSeq === "number" ? agent.readOutputSeq : null,
+      composerCommands: Array.isArray(agent.composerCommands) ? cloneJson(agent.composerCommands) : [],
+      archived: agent.archived === true,
+      archivedAt: typeof agent.archivedAt === "number" ? agent.archivedAt : null,
+      ...typeof agent.customTitle === "string" && agent.customTitle ? { customTitle: agent.customTitle } : {},
+      title: typeof agent.customTitle === "string" && agent.customTitle ? agent.customTitle : typeof agent.providerSessionTitle === "string" && agent.providerSessionTitle ? agent.providerSessionTitle : typeof agent.sessionTitle === "string" ? agent.sessionTitle : "",
+      startedAt: typeof agent.startedAt === "number" ? agent.startedAt : null
+    };
+  }
+  ensureRecordForProviderSessionKey(sessionKey, patch = {}, preferredId = "") {
+    const parsed = parseProviderSessionKey(sessionKey);
+    if (!parsed) return "";
+    if (parsed.provider === "opencode") {
+      const conflictingBinding = this.listStoredAgentRecords().find((record2) => {
+        const existing2 = parseProviderSessionKey(record2.providerSessionKey);
+        return existing2?.provider === "opencode" && existing2.sessionId === parsed.sessionId && existing2.providerHomeId !== parsed.providerHomeId;
+      });
+      if (conflictingBinding) {
+        const error = new Error(
+          `OpenCode session ${parsed.sessionId} is already bound to Agent Home "${String(conflictingBinding.providerHomeId || "default")}"`
+        );
+        error.code = "AGENT_HOME_SESSION_CONFLICT";
+        error.status = 409;
+        throw error;
+      }
+    }
+    this.ensureIndex();
+    const indexedId = this.providerSessionRecords.get(sessionKey);
+    const existingId = typeof indexedId === "string" ? indexedId : "";
+    const normalizedPreferredId = safeSessionFileName(preferredId) ? preferredId : "";
+    const preferredRecord = normalizedPreferredId ? this.readRecord(normalizedPreferredId) : null;
+    if (!safeSessionFileName(existingId) && preferredRecord?.providerSessionTemporary !== true && preferredRecord?.providerSessionKey && preferredRecord.providerSessionKey !== sessionKey) {
+      throw new Error(
+        `Farming session ${normalizedPreferredId} is already bound to ${preferredRecord.providerSessionKey}`
+      );
+    }
+    const id = safeSessionFileName(existingId) ? existingId : normalizedPreferredId || createAgentRecordId();
+    const existing = this.readRecord(id) || {};
+    const record = {
+      id,
+      kind: "agent",
+      createdAt: typeof existing.createdAt === "number" ? existing.createdAt : now(),
+      visibleOnMainPage: existing.visibleOnMainPage === true,
+      archived: existing.archived === true,
+      ...existing,
+      ...patch,
+      provider: parsed.provider,
+      providerHomeId: parsed.providerHomeId,
+      providerSessionId: parsed.sessionId,
+      providerSessionKey: sessionKey,
+      providerSessionTemporary: false,
+      updatedAt: now()
+    };
+    delete record.visibleOnMainPage;
+    if (typeof record.customTitle === "string" && record.customTitle) {
+      record.title = record.customTitle;
+    }
+    const writtenId = this.writeRecord(record);
+    for (const [key, recordId] of this.providerSessionRecords) {
+      if (key !== sessionKey && recordId === writtenId) this.providerSessionRecords.delete(key);
+    }
+    this.providerSessionRecords.set(sessionKey, writtenId);
+    return writtenId;
+  }
+  ensureRecordForAgent(agent, patch = {}) {
+    const providerSessionKey = this.providerSessionKeyForAgent(agent);
+    if (providerSessionKey) {
+      const preferredId2 = agentRecordIdFor(agent);
+      const previousId = safeSessionFileName(preferredId2) ? preferredId2 : "";
+      const previous = previousId ? this.readRecord(previousId) : null;
+      const canonical = this.getRecordForProviderSessionKey(providerSessionKey);
+      const agentPatch = this.recordPatchFromAgent(agent);
+      if (canonical && previousId && canonical.id !== previousId) {
+        PRODUCT_STATE_FIELDS.forEach((field) => {
+          if (Object.prototype.hasOwnProperty.call(canonical, field)) {
+            agentPatch[field] = canonical[field];
+          } else if (previous && Object.prototype.hasOwnProperty.call(previous, field)) {
+            agentPatch[field] = previous[field];
+          }
+        });
+      }
+      const id2 = this.ensureRecordForProviderSessionKey(providerSessionKey, {
+        ...agentPatch,
+        ...patch
+      }, preferredId2 || "");
+      if (previousId && previousId !== id2) {
+        const promotedFromPrevious = this.readRecord(id2)?.legacyRecordId === previousId;
+        if (!promotedFromPrevious && previous && (previous.providerSessionTemporary === true || !previous.providerSessionKey)) {
+          const mergedId = this.writeRecord({
+            ...previous,
+            runtimeAgentId: "",
+            visibleOnMainPage: false,
+            archived: true,
+            archivedAt: now(),
+            mergedInto: id2,
+            updatedAt: now()
+          });
+          if (mergedId && mergedId !== previousId) this.promoteIndexRecordId(previousId, mergedId);
+        }
+      }
+      return id2;
+    }
+    const preferredId = agentRecordIdFor(agent);
+    const existingId = safeSessionFileName(preferredId) ? preferredId : "";
+    const id = existingId || createAgentRecordId();
+    const existing = this.readRecord(id) || {};
+    const record = {
+      id,
+      kind: "agent",
+      createdAt: typeof existing.createdAt === "number" ? existing.createdAt : now(),
+      visibleOnMainPage: existing.visibleOnMainPage === true,
+      archived: existing.archived === true,
+      ...existing,
+      ...this.recordPatchFromAgent(agent || {}),
+      ...patch,
+      updatedAt: now()
+    };
+    return this.writeRecord(record);
+  }
+  setProviderSessionDisplayState(sessionKey, patch = {}) {
+    const displayPatch = {};
+    if (typeof patch.pinned === "boolean") displayPatch.displayPinned = patch.pinned;
+    return this.ensureRecordForProviderSessionKey(sessionKey, displayPatch);
+  }
+  rememberMainPageSessionKey(sessionKey, patch = {}) {
+    const id = this.ensureRecordForProviderSessionKey(sessionKey, {
+      ...patch,
+      archived: false,
+      lastSeenAt: now()
+    });
+    if (!id) return this.getMainPageSessionKeys();
+    const index = this.ensureIndex();
+    const nextIndex = this.writeIndex({ ...index, mainPageSessionKeys: this.normalizeMainPageSessionKeys([
+      sessionKey,
+      ...index.mainPageSessionKeys.filter((key) => key !== sessionKey)
+    ]) });
+    return nextIndex.mainPageSessionKeys.slice();
+  }
+  rememberAgent(agent) {
+    const providerSessionKey = this.providerSessionKeyForAgent(agent);
+    const id = this.ensureRecordForAgent(agent, providerSessionKey ? { archived: false } : {});
+    if (providerSessionKey) {
+      this.rememberMainPageSessionKey(providerSessionKey, this.recordPatchFromAgent(agent));
+    }
+    return id;
+  }
+  setMainPageSessionKeys(keys) {
+    const normalized = this.normalizeMainPageSessionKeys(keys);
+    const index = this.ensureIndex();
+    normalized.forEach((key) => {
+      this.ensureRecordForProviderSessionKey(key, {
+        archived: false,
+        lastSeenAt: now()
+      });
+    });
+    return this.writeIndex({ ...index, mainPageSessionKeys: normalized }).mainPageSessionKeys.slice();
+  }
+  removeMainPageSessionKey(sessionKey) {
+    const index = this.ensureIndex();
+    if (!index.mainPageSessionKeys.includes(sessionKey)) return false;
+    this.writeIndex({
+      ...index,
+      mainPageSessionKeys: index.mainPageSessionKeys.filter((key) => key !== sessionKey)
+    });
+    return true;
+  }
+  removeMainPageSessionKeys(keys) {
+    const index = this.ensureIndex();
+    const requested = new Set(Array.isArray(keys) ? keys : []);
+    const removed = index.mainPageSessionKeys.filter((key) => requested.has(key));
+    if (removed.length === 0) return [];
+    this.writeIndex({
+      ...index,
+      mainPageSessionKeys: index.mainPageSessionKeys.filter((key) => !requested.has(key))
+    });
+    return removed;
+  }
+  getMainPageSessionKeys() {
+    return this.ensureIndex().mainPageSessionKeys.slice();
+  }
+  getRecordForProviderSessionKey(sessionKey) {
+    this.ensureIndex();
+    const id = this.providerSessionRecords.get(sessionKey);
+    return safeSessionFileName(id) ? this.readRecord(String(id)) : null;
+  }
+  listAgentRecords() {
+    this.ensureIndex();
+    const records = this.listStoredAgentRecords();
+    const successors = this.legacySuccessors(records);
+    return records.filter((record) => !successors.has(record.id));
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AGENT_RECORD_VERSION,
+  AGENT_STATE_VERSION,
+  FarmingSessionStore,
+  MAX_MAIN_PAGE_SESSION_KEYS,
+  SESSION_INDEX_VERSION,
+  parseProviderSessionKey
+});