farming-code 2.2.29 → 2.2.32

package/backend/main-agent-skills.cjs

@@ -0,0 +1,309 @@
+// Generated by scripts/build-backend-runtime.ts. Do not edit.
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var main_agent_skills_exports = {};
+__export(main_agent_skills_exports, {
+  MAIN_AGENT_OPERATING_GUIDE: () => MAIN_AGENT_OPERATING_GUIDE,
+  MAIN_AGENT_SKILLS: () => MAIN_AGENT_SKILLS,
+  ensureMainAgentSkillFiles: () => ensureMainAgentSkillFiles,
+  getMainAgentSkillsCatalog: () => getMainAgentSkillsCatalog,
+  renderCanonicalAgentsFile: () => renderCanonicalAgentsFile,
+  renderCompatibilityFile: () => renderCompatibilityFile,
+  renderCompatibilityPointerFile: () => renderCompatibilityPointerFile,
+  renderMainAgentBootstrap: () => renderMainAgentBootstrap,
+  renderMainAgentOperatingGuide: () => renderMainAgentOperatingGuide,
+  renderMainAgentSkills: () => renderMainAgentSkills,
+  upsertManagedBlock: () => upsertManagedBlock
+});
+module.exports = __toCommonJS(main_agent_skills_exports);
+const fs = require("fs");
+const path = require("path");
+const MANAGED_BLOCK_START = "<!-- FARMING_MAIN_AGENT_SKILLS:START -->";
+const MANAGED_BLOCK_END = "<!-- FARMING_MAIN_AGENT_SKILLS:END -->";
+const REMOVED_MAIN_AGENT_SKILL_IDS = ["memory-report"];
+const MAIN_AGENT_OPERATING_GUIDE = [
+  {
+    title: "Mission",
+    lines: [
+      "You are the Farming Main Agent: an attention steward for the human, not a background log reader.",
+      "Your value is to keep track of what other agents are doing, notice when the human should care, and compress parallel work into clear next actions."
+    ]
+  },
+  {
+    title: "Startup routine",
+    lines: [
+      "On startup or resume, orient yourself with `farming list --json` and inspect `FARMING_PROJECT_WORKSPACE` / `FARMING_MAIN_WORKSPACE` before proposing work.",
+      "Do not spawn child agents just because you can. Wait for a concrete user goal, or ask one short clarification if the goal is too vague to route safely."
+    ]
+  },
+  {
+    title: "Observing agents",
+    lines: [
+      "Poll at a low frequency and look for state changes, not raw terminal chatter.",
+      "Use `farming output <agent-id> --tail <n>` only for agents that are blocked, newly finished, noisy, or directly relevant to the current user question.",
+      "Classify agents as running, waiting for input, blocked, failed, complete, stale, or safe to ignore; include the agent id behind each claim."
+    ]
+  },
+  {
+    title: "Delegating work",
+    lines: [
+      "Spawn child agents only when parallelism clearly helps a user goal.",
+      "Give each child a narrow workspace, task, success criteria, forbidden scope, and required evidence or tests.",
+      "Keep the default fanout small; prefer 2-4 focused children over many overlapping agents."
+    ]
+  },
+  {
+    title: "Intervening",
+    lines: [
+      "Use `farming send` to unblock or redirect a child agent with specific instructions.",
+      "Do not issue destructive commands, broad rewrites, permission changes, or high-risk cleanup without summarizing the risk and getting user confirmation.",
+      "Kill agents only when they are clearly done, duplicated, stuck beyond recovery, or the user asks."
+    ]
+  },
+  {
+    title: "Reporting to the human",
+    lines: [
+      "Report in short status summaries: What changed, who needs attention, what is done, and what you will do next.",
+      "Do not paste long logs. Quote or summarize only the evidence needed for a decision.",
+      "When multiple agents disagree, deduplicate findings, rank by severity, and name the evidence gap before deciding."
+    ]
+  }
+];
+const MAIN_AGENT_SKILLS = [
+  {
+    id: "browser-resource",
+    name: "\u7CFB\u7EDF\u6D4F\u89C8\u5668\u64CD\u4F5C",
+    trigger: "\u7528\u6237\u8981\u6C42\u6253\u5F00\u3001\u67E5\u770B\u6216\u64CD\u4F5C Farming Project \u4E0B\u7684 Browser Resource\uFF0C\u6216\u8005\u9700\u8981\u7ED5\u8FC7\u9759\u6001 HTML Viewer \u9650\u5236\u9A8C\u8BC1\u771F\u5B9E\u7F51\u9875\u65F6",
+    summary: "\u901A\u8FC7 Farming Browser ID \u64CD\u4F5C\u7528\u6237\u5F53\u524D\u770B\u5230\u7684\u540C\u4E00\u4E2A\u7CFB\u7EDF\u6D4F\u89C8\u5668\uFF1B\u5148\u8D70 Browser \u7684\u6E10\u8FDB\u5F0F\u5E2E\u52A9\u548C\u6807\u51C6 Workflow\uFF0C\u53EA\u5728\u9700\u8981\u65F6\u5C55\u5F00\u5177\u4F53\u95EE\u9898\u57DF\u4E0E\u539F\u5B50\u547D\u4EE4\u3002",
+    commands: [
+      "farming capabilities",
+      "farming browser list",
+      "farming browser help workflow",
+      "farming browser help <lifecycle|navigation|interaction|inspection|debugging|state|files>"
+    ]
+  },
+  {
+    id: "computer-resource",
+    name: "\u9694\u79BB\u7535\u8111\u64CD\u4F5C",
+    trigger: "\u7528\u6237\u8981\u6C42\u64CD\u4F5C\u5B8C\u6574\u684C\u9762\u3001\u7CFB\u7EDF\u7A97\u53E3\u3001\u6D4F\u89C8\u5668\u5DE5\u5177\u680F\u3001\u6743\u9650\u5F39\u7A97\u6216\u975E\u7F51\u9875\u5E94\u7528\uFF0C\u5E76\u4E14 Farming Computer \u80FD\u529B\u53EF\u7528\u65F6",
+    summary: "\u4F7F\u7528\u5F53\u524D Agent \u81EA\u5DF1\u62E5\u6709\u3001\u7528\u6237\u53EF\u89C2\u5BDF\u548C\u63A5\u7BA1\u7684\u9694\u79BB Computer\uFF1B\u5148\u89C2\u5BDF\u518D\u64CD\u4F5C\uFF0C\u64CD\u4F5C\u540E\u590D\u6838\uFF0C\u4E0D\u76F2\u76EE\u91CD\u653E\u8D85\u65F6\u5199\u64CD\u4F5C\u3002",
+    commands: [
+      "farming capabilities",
+      "farming computer list",
+      "farming computer open",
+      "farming computer help workflow"
+    ]
+  },
+  {
+    id: "pest-control",
+    name: "\u7267\u573A\u9664\u866B\u8BA1\u5212",
+    trigger: "\u7528\u6237\u8981\u6C42\u5BF9\u67D0\u4E2A\u76EE\u5F55\u3001\u4ED3\u5E93\u6216\u6A21\u5757\u4F53\u7CFB\u505A\u7CFB\u7EDF\u6027 bug \u6392\u67E5\u3001\u9664\u866B\u3001\u6DF1\u6316\u6F5C\u5728\u7F3A\u9677\u65F6",
+    summary: [
+      "Main Agent \u5148\u53EA\u8BFB\u68B3\u7406\u76EE\u6807\u76EE\u5F55\u7ED3\u6784\uFF0C\u5212\u5206\u6A21\u5757\u8FB9\u754C\uFF0C\u660E\u786E\u6A21\u5757\u95F4\u534F\u8BAE\u3001\u6570\u636E\u6D41\u3001\u8C03\u7528\u5173\u7CFB\u548C\u5171\u4EAB\u7EA6\u675F\u3002",
+      "\u968F\u540E\u4E3A\u6BCF\u4E2A\u6A21\u5757\u542F\u52A8\u4E00\u4E2A\u5B50 Agent \u6DF1\u6316\u6F5C\u5728 bug\uFF1B\u6BCF\u4E2A\u5B50 Agent \u5FC5\u987B\u805A\u7126\u81EA\u5DF1\u7684\u6A21\u5757\uFF0C\u540C\u65F6\u68C0\u67E5\u4E0E\u76F8\u90BB\u6A21\u5757\u534F\u8BAE\u662F\u5426\u7834\u574F\u3002",
+      "Main Agent \u8D1F\u8D23\u6C47\u603B\u5B50 Agent \u53D1\u73B0\uFF0C\u53BB\u91CD\u3001\u5206\u7EA7\u3001\u5B89\u6392\u53EF\u9A8C\u8BC1\u4FEE\u590D\u6216\u7ED9\u7528\u6237\u786E\u8BA4\u9AD8\u98CE\u9669\u6539\u52A8\u3002"
+    ].join(" "),
+    commands: [
+      'farming spawn --workspace <repo> --task "\u6A21\u5757\uFF1A<name>\u3002\u8BF7\u6DF1\u6316\u8BE5\u6A21\u5757\u6F5C\u5728 bug\uFF0C\u91CD\u70B9\u68C0\u67E5\u8FB9\u754C\u6761\u4EF6\u3001\u9519\u8BEF\u5904\u7406\u3001\u5E76\u53D1/\u72B6\u6001\u4E00\u81F4\u6027\u3001\u534F\u8BAE\u8FDD\u7EA6\u548C\u6D4B\u8BD5\u7F3A\u53E3\uFF1B\u4E0D\u8981\u4FEE\u6539\u5176\u4ED6\u6A21\u5757\uFF0C\u5148\u62A5\u544A\u53EF\u9A8C\u8BC1\u53D1\u73B0\u3002" -- <coding-agent-command>',
+      'farming list --parent "$FARMING_AGENT_ID"',
+      "farming output <agent-id> --tail 2000",
+      'farming send <agent-id> "\u8BF7\u57FA\u4E8E\u5DF2\u786E\u8BA4\u7684\u6A21\u5757\u534F\u8BAE\u7EE7\u7EED\u68C0\u67E5\u4EA4\u4E92\u8FB9\u754C\uFF0C\u5E76\u7ED9\u51FA\u6700\u5C0F\u53EF\u9A8C\u8BC1\u4FEE\u590D\u5EFA\u8BAE"',
+      "farming kill <agent-id>"
+    ]
+  }
+];
+function getMainAgentSkillsCatalog() {
+  return MAIN_AGENT_SKILLS.map((skill) => ({
+    id: skill.id,
+    name: skill.name,
+    trigger: skill.trigger,
+    summary: skill.summary,
+    commands: skill.commands
+  }));
+}
+function renderMainAgentOperatingGuide() {
+  const lines = [
+    "# Farming Main Agent Operating Contract",
+    ""
+  ];
+  MAIN_AGENT_OPERATING_GUIDE.forEach((section) => {
+    lines.push(`## ${section.title}`);
+    section.lines.forEach((line) => {
+      lines.push(`- ${line}`);
+    });
+    lines.push("");
+  });
+  return lines.join("\n").trim();
+}
+function renderMainAgentSkills() {
+  const lines = [
+    "# Farming Main Agent Skills",
+    "",
+    "You are the Farming Main Agent.",
+    "Run `farming skills` any time you need to review these skills.",
+    "Use these skills when the user asks for Farming-specific machine context.",
+    ""
+  ];
+  MAIN_AGENT_SKILLS.forEach((skill, index) => {
+    lines.push(`${index + 1}. ${skill.name} (${skill.id})`);
+    lines.push(`Trigger: ${skill.trigger}`);
+    lines.push(`Behavior: ${skill.summary}`);
+    lines.push("Commands:");
+    skill.commands.forEach((command) => {
+      lines.push(`- ${command}`);
+    });
+    lines.push("");
+  });
+  lines.push("Rules:");
+  lines.push("- `farming browser` lists and operates only Browser Resources owned by this Agent; follow `farming browser help workflow`, and reveal only the help topic or command needed for the current step.");
+  lines.push("- `farming computer` operates only the isolated Computer owned by this Agent; observe before and after actions, and never replay an uncertain mutation without observing first.");
+  lines.push("- Use \u201C\u7267\u573A\u9664\u866B\u8BA1\u5212\u201D when the user asks for systematic bug hunting across a directory or module tree.");
+  lines.push("- Before spawning child agents for pest control, map modules and module protocols first; do not send overlapping or vague tasks.");
+  lines.push("- Keep child agents scoped to their assigned module and require evidence, reproduction notes, or tests for each bug claim.");
+  lines.push("- For high-risk writes, destructive operations, or broad refactors, summarize the finding and ask the user before proceeding.");
+  return [
+    renderMainAgentOperatingGuide(),
+    "",
+    lines.join("\n")
+  ].join("\n");
+}
+function renderCanonicalAgentsFile() {
+  return [
+    "# Farming Main Agent",
+    "",
+    "This directory is a Farming-managed Main Agent workspace.",
+    "",
+    "Read this file before acting. You are the Farming Main Agent, not a project-local child agent.",
+    "Use the local `farming` CLI to inspect your abilities and coordinate work.",
+    "",
+    "Useful commands:",
+    "- `farming skills`",
+    '- `farming spawn --workspace <repo> --task "<module bug hunt task>" -- <coding-agent-command>`',
+    '- `farming list --parent "$FARMING_AGENT_ID"`',
+    "- `farming output <agent-id> --tail 2000`",
+    '- `farming send <agent-id> "<follow-up instruction>"`',
+    "- `farming kill <agent-id>`",
+    "",
+    "Environment:",
+    "- `FARMING_MAIN_WORKSPACE` points at this Farming identity workspace.",
+    "- `FARMING_PROJECT_WORKSPACE` points at the user-selected project workspace when available.",
+    "- `FARMING_SKILLS_FILE` points at the detailed Farming skills file.",
+    "",
+    renderMainAgentSkills()
+  ].join("\n");
+}
+function renderCompatibilityFile(targetName = "AGENTS.md") {
+  return [
+    `# Farming Main Agent (${targetName})`,
+    "",
+    `This file is a compatibility entrypoint for ${targetName}.`,
+    "It intentionally includes the full Farming Main Agent identity inline, because some coding CLIs read only their own memory filename and may not follow a pointer to AGENTS.md.",
+    "",
+    renderCanonicalAgentsFile()
+  ].join("\n");
+}
+function renderCompatibilityPointerFile(targetName = "AGENTS.md") {
+  return [
+    "# Farming Main Agent",
+    "",
+    `This is a compatibility entrypoint for ${targetName}.`,
+    "",
+    "The canonical Farming Main Agent instructions are in `AGENTS.md`.",
+    "Read `AGENTS.md`, then run `farming skills` if you need the current skill list.",
+    ""
+  ].join("\n");
+}
+function renderMainAgentBootstrap() {
+  return [
+    renderMainAgentSkills(),
+    "",
+    "Bootstrap note: remember these Farming skills for future user requests."
+  ].join("\n");
+}
+function upsertManagedBlock(existingContent, block) {
+  const start = existingContent.indexOf(MANAGED_BLOCK_START);
+  const end = existingContent.indexOf(MANAGED_BLOCK_END);
+  if (start !== -1 && end !== -1 && end > start) {
+    const before = existingContent.slice(0, start).replace(/\s+$/g, "");
+    const after = existingContent.slice(end + MANAGED_BLOCK_END.length).replace(/^\s+/g, "");
+    return [before, block.trim(), after].filter(Boolean).join("\n\n") + "\n";
+  }
+  return [existingContent.trim(), block.trim()].filter(Boolean).join("\n\n") + "\n";
+}
+function writeManagedSkillFile(filePath, block) {
+  let existing = "";
+  try {
+    existing = fs.readFileSync(filePath, "utf8");
+  } catch {
+    existing = "";
+  }
+  fs.writeFileSync(filePath, upsertManagedBlock(existing, block));
+}
+function ensureMainAgentSkillFiles(farmingDir) {
+  if (!farmingDir) return;
+  fs.mkdirSync(farmingDir, { recursive: true });
+  const skillsText = renderMainAgentSkills() + "\n";
+  const skillsDir = path.join(farmingDir, "skills");
+  fs.mkdirSync(skillsDir, { recursive: true });
+  fs.writeFileSync(path.join(farmingDir, "FARMING_MAIN_AGENT_SKILLS.md"), skillsText);
+  fs.writeFileSync(path.join(farmingDir, "AGENTS.md"), `${renderCanonicalAgentsFile()}
+`);
+  fs.writeFileSync(path.join(skillsDir, "index.json"), JSON.stringify(MAIN_AGENT_SKILLS, null, 2) + "\n");
+  MAIN_AGENT_SKILLS.forEach((skill) => {
+    const lines = [
+      `# ${skill.name}`,
+      "",
+      `ID: ${skill.id}`,
+      "",
+      `Trigger: ${skill.trigger}`,
+      "",
+      `Behavior: ${skill.summary}`,
+      "",
+      "Commands:",
+      ...skill.commands.map((command) => `- ${command}`),
+      ""
+    ];
+    fs.writeFileSync(path.join(skillsDir, `${skill.id}.md`), lines.join("\n"));
+  });
+  REMOVED_MAIN_AGENT_SKILL_IDS.forEach((skillId) => {
+    fs.rmSync(path.join(skillsDir, `${skillId}.md`), { force: true });
+  });
+  ["CLAUDE.md", "QWEN.md"].forEach((filename) => {
+    writeManagedSkillFile(path.join(farmingDir, filename), [
+      MANAGED_BLOCK_START,
+      renderCompatibilityFile(filename).trim(),
+      MANAGED_BLOCK_END,
+      ""
+    ].join("\n"));
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MAIN_AGENT_OPERATING_GUIDE,
+  MAIN_AGENT_SKILLS,
+  ensureMainAgentSkillFiles,
+  getMainAgentSkillsCatalog,
+  renderCanonicalAgentsFile,
+  renderCompatibilityFile,
+  renderCompatibilityPointerFile,
+  renderMainAgentBootstrap,
+  renderMainAgentOperatingGuide,
+  renderMainAgentSkills,
+  upsertManagedBlock
+});

package/backend/main-page-session.cjs

@@ -0,0 +1,132 @@
+// 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 main_page_session_exports = {};
+__export(main_page_session_exports, {
+  AUTO_RESUME_AGENT_SESSION_PROVIDERS: () => AUTO_RESUME_AGENT_SESSION_PROVIDERS,
+  findActiveAgentClaimingSession: () => findActiveAgentClaimingSession,
+  mainPageAgentSessionFromKey: () => mainPageAgentSessionFromKey,
+  mainPageAgentSessionKey: () => mainPageAgentSessionKey,
+  mainPageAgentSessionsToAutoResume: () => mainPageAgentSessionsToAutoResume,
+  mainPageSessionProviderForCommand: () => mainPageSessionProviderForCommand,
+  resumedAgentSource: () => resumedAgentSource
+});
+module.exports = __toCommonJS(main_page_session_exports);
+var path = __toESM(require("path"));
+var import_cli_agents = require("./cli-agents.cjs");
+var import_provider_session_id = require("./provider-session-id.cjs");
+const AUTO_RESUME_AGENT_SESSION_PROVIDERS = /* @__PURE__ */ new Set(["codex", "claude", "opencode", "qoder", "qwen"]);
+function normalizeMainPageSessionProvider(provider) {
+  const normalized = String(provider || "").trim().toLowerCase();
+  return AUTO_RESUME_AGENT_SESSION_PROVIDERS.has(normalized) ? normalized : "";
+}
+function isSafeSessionId(sessionId) {
+  return (0, import_provider_session_id.isSafeProviderSessionId)(sessionId);
+}
+function mainPageAgentSessionKey(provider, sessionId, providerHomeId = "") {
+  const normalizedProvider = normalizeMainPageSessionProvider(provider);
+  const normalizedSessionId = String(sessionId || "").trim();
+  if (!normalizedProvider || !normalizedSessionId) return "";
+  const homeId = String(providerHomeId || "").trim();
+  if (homeId && homeId !== "default") return `agent-session:${normalizedProvider}:home:${homeId}:${normalizedSessionId}`;
+  return `agent-session:${normalizedProvider}:${normalizedSessionId}`;
+}
+function mainPageAgentSessionFromKey(key) {
+  const match = String(key || "").match(/^agent-session:([^:]+):(.+)$/);
+  if (!match) return null;
+  const provider = normalizeMainPageSessionProvider(match[1]);
+  let providerHomeId = "default";
+  let sessionId = String(match[2] || "").trim();
+  const homeMatch = sessionId.match(/^home:([A-Za-z0-9._-]+):(.+)$/);
+  if (homeMatch) {
+    providerHomeId = homeMatch[1];
+    sessionId = String(homeMatch[2] || "").trim();
+  }
+  if (!provider || !isSafeSessionId(sessionId)) {
+    return null;
+  }
+  return providerHomeId && providerHomeId !== "default" ? { provider, providerHomeId, sessionId } : { provider, sessionId };
+}
+function mainPageAgentSessionsToAutoResume(settings) {
+  const keys = Array.isArray(settings?.mainPageSessionKeys) ? settings.mainPageSessionKeys : [];
+  const seen = /* @__PURE__ */ new Set();
+  const sessions = [];
+  keys.forEach((key) => {
+    const session = mainPageAgentSessionFromKey(key);
+    if (!session) return;
+    const dedupeKey = `${session.provider}:${session.providerHomeId || "default"}:${session.sessionId}`;
+    if (seen.has(dedupeKey)) return;
+    seen.add(dedupeKey);
+    sessions.push(session);
+  });
+  return sessions;
+}
+function resumedAgentSource(provider, sessionId, providerHomeId = "") {
+  const homeId = String(providerHomeId || "").trim();
+  return homeId && homeId !== "default" ? `${provider}-history:home:${homeId}:${sessionId}` : `${provider}-history:${sessionId}`;
+}
+function mainPageSessionProviderForCommand(command) {
+  const executable = (0, import_cli_agents.parseCommand)(command).find((token) => token !== "env" && !/^[A-Za-z_][A-Za-z0-9_]*=/.test(token));
+  const basename = path.basename(executable || "");
+  if (basename === "qodercli") return "qoder";
+  if (basename === "qwen") return "qwen";
+  return normalizeMainPageSessionProvider(basename);
+}
+function isActiveAgent(agent) {
+  return Boolean(agent && agent.archived !== true && agent.status !== "dead" && agent.status !== "stopped");
+}
+function findActiveAgentClaimingSession(agents, provider, session) {
+  const normalizedProvider = normalizeMainPageSessionProvider(provider);
+  const sessionId = String(session && (session.id || session.sessionId) || "").trim();
+  if (!normalizedProvider || !isSafeSessionId(sessionId) || !Array.isArray(agents)) return null;
+  const providerHomeId = String(session && session.providerHomeId || "default").trim() || "default";
+  const sessionKey = mainPageAgentSessionKey(normalizedProvider, sessionId, providerHomeId);
+  const legacySessionKey = mainPageAgentSessionKey(normalizedProvider, sessionId);
+  const exactSource = resumedAgentSource(normalizedProvider, sessionId, providerHomeId);
+  const legacySource = resumedAgentSource(normalizedProvider, sessionId);
+  return agents.find((agent) => {
+    if (!isActiveAgent(agent)) return false;
+    if (agent.providerSessionTemporary === true) return false;
+    if (agent.providerSessionKey === sessionKey || providerHomeId === "default" && agent.providerSessionKey === legacySessionKey) return true;
+    if (agent.providerSessionProvider === normalizedProvider && agent.providerSessionId === sessionId && (String(agent.providerHomeId || "default").trim() || "default") === providerHomeId) {
+      return true;
+    }
+    return agent.source === exactSource || providerHomeId === "default" && agent.source === legacySource;
+  }) || null;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AUTO_RESUME_AGENT_SESSION_PROVIDERS,
+  findActiveAgentClaimingSession,
+  mainPageAgentSessionFromKey,
+  mainPageAgentSessionKey,
+  mainPageAgentSessionsToAutoResume,
+  mainPageSessionProviderForCommand,
+  resumedAgentSource
+});

package/backend/native-pty-controller-generation.cjs

@@ -0,0 +1,139 @@
+// 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 native_pty_controller_generation_exports = {};
+__export(native_pty_controller_generation_exports, {
+  allocateNativePtyControllerGeneration: () => allocateNativePtyControllerGeneration,
+  allocateNativePtyRuntimeGeneration: () => allocateNativePtyRuntimeGeneration,
+  compareNativePtyRuntimeEpochs: () => compareNativePtyRuntimeEpochs,
+  formatNativePtyRuntimeEpoch: () => formatNativePtyRuntimeEpoch,
+  nativePtyRuntimeEpochGeneration: () => nativePtyRuntimeEpochGeneration,
+  positiveGeneration: () => positiveGeneration
+});
+module.exports = __toCommonJS(native_pty_controller_generation_exports);
+var crypto = __toESM(require("crypto"));
+var fs = __toESM(require("fs"));
+var path = __toESM(require("path"));
+var storageLayout = __toESM(require("./storage-layout.cjs"));
+const LOCK_RETRY_MS = 10;
+const LOCK_TIMEOUT_MS = 5e3;
+const STALE_LOCK_MS = 3e4;
+function delay(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function positiveGeneration(value) {
+  const parsed = Math.floor(Number(value));
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : 0;
+}
+function fileSystemError(error) {
+  return typeof error === "object" && error !== null;
+}
+async function acquireGenerationLock(lockDir) {
+  const deadline = Date.now() + LOCK_TIMEOUT_MS;
+  while (Date.now() < deadline) {
+    try {
+      await fs.promises.mkdir(lockDir);
+      return;
+    } catch (error) {
+      if (!fileSystemError(error) || error.code !== "EEXIST") throw error;
+      try {
+        const stat = await fs.promises.stat(lockDir);
+        if (Date.now() - stat.mtimeMs > STALE_LOCK_MS) {
+          await fs.promises.rm(lockDir, { recursive: true, force: true });
+          continue;
+        }
+      } catch (statError) {
+        if (!fileSystemError(statError) || statError.code !== "ENOENT") throw statError;
+      }
+      await delay(LOCK_RETRY_MS);
+    }
+  }
+  throw new Error("Timed out allocating native PTY controller generation");
+}
+async function allocateGeneration(generationFile, lockDir) {
+  const root = path.dirname(generationFile);
+  await fs.promises.mkdir(root, { recursive: true });
+  await acquireGenerationLock(lockDir);
+  try {
+    let current = 0;
+    try {
+      current = positiveGeneration(await fs.promises.readFile(generationFile, "utf8"));
+    } catch (error) {
+      if (!fileSystemError(error) || error.code !== "ENOENT") throw error;
+    }
+    const generation = current + 1;
+    const temporary = `${generationFile}.${process.pid}.${crypto.randomUUID()}.tmp`;
+    await fs.promises.writeFile(temporary, `${generation}
+`, { mode: 384 });
+    await fs.promises.rename(temporary, generationFile);
+    return generation;
+  } finally {
+    await fs.promises.rm(lockDir, { recursive: true, force: true });
+  }
+}
+async function allocateNativePtyControllerGeneration(configDir) {
+  const root = path.resolve(configDir);
+  const generationFile = storageLayout.nativePtyControllerGenerationFile(root);
+  const lockDir = storageLayout.nativePtyControllerGenerationLockDir(root);
+  return allocateGeneration(generationFile, lockDir);
+}
+async function allocateNativePtyRuntimeGeneration(configDir) {
+  const root = path.resolve(configDir);
+  return allocateGeneration(
+    storageLayout.nativePtyRuntimeGenerationFile(root),
+    storageLayout.nativePtyRuntimeGenerationLockDir(root)
+  );
+}
+function formatNativePtyRuntimeEpoch(generation, id = crypto.randomUUID()) {
+  const normalized = positiveGeneration(generation);
+  if (!normalized) throw new Error("Native PTY runtime generation must be positive");
+  return `farming-runtime-v1:${String(normalized).padStart(20, "0")}:${id}`;
+}
+function nativePtyRuntimeEpochGeneration(runtimeEpoch) {
+  const match = /^farming-runtime-v1:(\d{20}):/.exec(String(runtimeEpoch || ""));
+  if (!match) return null;
+  const generation = Number(match[1]);
+  return Number.isSafeInteger(generation) && generation > 0 ? generation : null;
+}
+function compareNativePtyRuntimeEpochs(left, right) {
+  if (left === right) return 0;
+  const leftGeneration = nativePtyRuntimeEpochGeneration(left);
+  const rightGeneration = nativePtyRuntimeEpochGeneration(right);
+  if (leftGeneration === null || rightGeneration === null || leftGeneration === rightGeneration) return null;
+  return leftGeneration < rightGeneration ? -1 : 1;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  allocateNativePtyControllerGeneration,
+  allocateNativePtyRuntimeGeneration,
+  compareNativePtyRuntimeEpochs,
+  formatNativePtyRuntimeEpoch,
+  nativePtyRuntimeEpochGeneration,
+  positiveGeneration
+});