farming-code 2.2.28 → 2.2.29

package/backend/config-manager.js

@@ -85,9 +85,13 @@ const PERSISTED_SETTING_KEYS = new Set([
   'theme',
   'appearance',
   'language',
+  'restReminderIntervalSeconds',
   'heartbeatInterval',
   'dangerouslySkipAgentPermissionsByDefault',
   'browserExtensionEnabled',
+  'browserSource',
+  'browserExecutablePath',
+  'browserExternalCdpUrl',
   'crtSkinEffectsEnabled',
   'crtDynamicHeatEnabled',
   'crtTerminalFontSize',
@@ -317,9 +321,13 @@ class ConfigManager {
         theme: 'terminal',
         appearance: 'system',
         language: 'en',
+        restReminderIntervalSeconds: null,
         heartbeatInterval: 1000,
         dangerouslySkipAgentPermissionsByDefault: false,
         browserExtensionEnabled: false,
+        browserSource: process.env.FARMING_BROWSER_CDP_URL ? 'external-cdp' : 'system',
+        browserExecutablePath: process.env.FARMING_BROWSER_EXECUTABLE || '',
+        browserExternalCdpUrl: process.env.FARMING_BROWSER_CDP_URL || 'http://127.0.0.1:9222',
         crtSkinEffectsEnabled: true,
         crtDynamicHeatEnabled: false,
         crtTerminalFontSize: DEFAULT_CRT_TERMINAL_FONT_SIZE,
@@ -355,9 +363,13 @@ class ConfigManager {
       theme: 'terminal',
       appearance: 'system',
       language: 'en',
+      restReminderIntervalSeconds: null,
       heartbeatInterval: 1000,
       dangerouslySkipAgentPermissionsByDefault: false,
       browserExtensionEnabled: false,
+      browserSource: process.env.FARMING_BROWSER_CDP_URL ? 'external-cdp' : 'system',
+      browserExecutablePath: process.env.FARMING_BROWSER_EXECUTABLE || '',
+      browserExternalCdpUrl: process.env.FARMING_BROWSER_CDP_URL || 'http://127.0.0.1:9222',
       crtSkinEffectsEnabled: true,
       crtDynamicHeatEnabled: false,
       crtTerminalFontSize: DEFAULT_CRT_TERMINAL_FONT_SIZE,
@@ -419,7 +431,14 @@ class ConfigManager {
     this.runHistoryStore.init({ legacyTaskHistory });
     this.settings.appearance = this.normalizeAppearance(this.settings.appearance);
     this.settings.language = this.normalizeLanguage(this.settings.language);
+    this.settings.restReminderIntervalSeconds = this.normalizeRestReminderIntervalSeconds(
+      this.settings.restReminderIntervalSeconds,
+    );
     this.settings.browserExtensionEnabled = this.settings.browserExtensionEnabled === true;
+    this.settings.browserSource = this.normalizeBrowserSource(this.settings.browserSource);
+    this.settings.browserExecutablePath = this.normalizeBrowserSetting(this.settings.browserExecutablePath);
+    this.settings.browserExternalCdpUrl = this.normalizeBrowserSetting(this.settings.browserExternalCdpUrl)
+      || 'http://127.0.0.1:9222';
     this.settings.crtSkinEffectsEnabled = this.settings.crtSkinEffectsEnabled !== false;
     this.settings.crtDynamicHeatEnabled = this.settings.crtDynamicHeatEnabled === true;
     this.settings.crtTerminalFontSize = this.normalizeCrtTerminalFontSize(this.settings.crtTerminalFontSize);
@@ -452,6 +471,16 @@ class ConfigManager {
     );
   }
 
+  normalizeRestReminderIntervalSeconds(value) {
+    if (value === null || value === undefined || value === '') return null;
+    const seconds = Number(value);
+    if (!Number.isInteger(seconds)) return null;
+    if (seconds === 0 || seconds === 5) return seconds;
+    return seconds >= 60 && seconds <= 240 * 60 && seconds % 60 === 0
+      ? seconds
+      : null;
+  }
+
   normalizeCrtTerminalFontSize(value) {
     const fontSize = Number(value);
     if (!Number.isFinite(fontSize)) return DEFAULT_CRT_TERMINAL_FONT_SIZE;
@@ -579,6 +608,14 @@ class ConfigManager {
     return ['en', 'zh'].includes(language) ? language : 'en';
   }
 
+  normalizeBrowserSource(source) {
+    return source === 'external-cdp' ? source : 'system';
+  }
+
+  normalizeBrowserSetting(value) {
+    return String(value || '').trim().slice(0, 2000);
+  }
+
   normalizeUpdateUrl(value) {
     const url = String(value || '').trim();
     if (!url) return DEFAULT_UPDATE_URL;
@@ -1070,7 +1107,14 @@ class ConfigManager {
     }
     nextSettings.appearance = this.normalizeAppearance(nextSettings.appearance);
     nextSettings.language = this.normalizeLanguage(nextSettings.language);
+    nextSettings.restReminderIntervalSeconds = this.normalizeRestReminderIntervalSeconds(
+      nextSettings.restReminderIntervalSeconds,
+    );
     nextSettings.browserExtensionEnabled = nextSettings.browserExtensionEnabled === true;
+    nextSettings.browserSource = this.normalizeBrowserSource(nextSettings.browserSource);
+    nextSettings.browserExecutablePath = this.normalizeBrowserSetting(nextSettings.browserExecutablePath);
+    nextSettings.browserExternalCdpUrl = this.normalizeBrowserSetting(nextSettings.browserExternalCdpUrl)
+      || 'http://127.0.0.1:9222';
     nextSettings.crtSkinEffectsEnabled = nextSettings.crtSkinEffectsEnabled !== false;
     nextSettings.crtDynamicHeatEnabled = nextSettings.crtDynamicHeatEnabled === true;
     nextSettings.crtTerminalFontSize = this.normalizeCrtTerminalFontSize(nextSettings.crtTerminalFontSize);

package/backend/data/LICENSE.agent-browser

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1.  Definitions.
+
+    "License" shall mean the terms and conditions for use, reproduction,
+    and distribution as defined by Sections 1 through 9 of this document.
+
+    "Licensor" shall mean the copyright owner or entity authorized by
+    the copyright owner that is granting the License.
+
+    "Legal Entity" shall mean the union of the acting entity and all
+    other entities that control, are controlled by, or are under common
+    control with that entity. For the purposes of this definition,
+    "control" means (i) the power, direct or indirect, to cause the
+    direction or management of such entity, whether by contract or
+    otherwise, or (ii) ownership of fifty percent (50%) or more of the
+    outstanding shares, or (iii) beneficial ownership of such entity.
+
+    "You" (or "Your") shall mean an individual or Legal Entity
+    exercising permissions granted by this License.
+
+    "Source" form shall mean the preferred form for making modifications,
+    including but not limited to software source code, documentation
+    source, and configuration files.
+
+    "Object" form shall mean any form resulting from mechanical
+    transformation or translation of a Source form, including but
+    not limited to compiled object code, generated documentation,
+    and conversions to other media types.
+
+    "Work" shall mean the work of authorship, whether in Source or
+    Object form, made available under the License, as indicated by a
+    copyright notice that is included in or attached to the work
+    (an example is provided in the Appendix below).
+
+    "Derivative Works" shall mean any work, whether in Source or Object
+    form, that is based on (or derived from) the Work and for which the
+    editorial revisions, annotations, elaborations, or other modifications
+    represent, as a whole, an original work of authorship. For the purposes
+    of this License, Derivative Works shall not include works that remain
+    separable from, or merely link (or bind by name) to the interfaces of,
+    the Work and Derivative Works thereof.
+
+    "Contribution" shall mean any work of authorship, including
+    the original version of the Work and any modifications or additions
+    to that Work or Derivative Works thereof, that is intentionally
+    submitted to Licensor for inclusion in the Work by the copyright owner
+    or by an individual or Legal Entity authorized to submit on behalf of
+    the copyright owner. For the purposes of this definition, "submitted"
+    means any form of electronic, verbal, or written communication sent
+    to the Licensor or its representatives, including but not limited to
+    communication on electronic mailing lists, source code control systems,
+    and issue tracking systems that are managed by, or on behalf of, the
+    Licensor for the purpose of discussing and improving the Work, but
+    excluding communication that is conspicuously marked or otherwise
+    designated in writing by the copyright owner as "Not a Contribution."
+
+    "Contributor" shall mean Licensor and any individual or Legal Entity
+    on behalf of whom a Contribution has been received by Licensor and
+    subsequently incorporated within the Work.
+
+2.  Grant of Copyright License. Subject to the terms and conditions of
+    this License, each Contributor hereby grants to You a perpetual,
+    worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+    copyright license to reproduce, prepare Derivative Works of,
+    publicly display, publicly perform, sublicense, and distribute the
+    Work and such Derivative Works in Source or Object form.
+
+3.  Grant of Patent License. Subject to the terms and conditions of
+    this License, each Contributor hereby grants to You a perpetual,
+    worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+    (except as stated in this section) patent license to make, have made,
+    use, offer to sell, sell, import, and otherwise transfer the Work,
+    where such license applies only to those patent claims licensable
+    by such Contributor that are necessarily infringed by their
+    Contribution(s) alone or by combination of their Contribution(s)
+    with the Work to which such Contribution(s) was submitted. If You
+    institute patent litigation against any entity (including a
+    cross-claim or counterclaim in a lawsuit) alleging that the Work
+    or a Contribution incorporated within the Work constitutes direct
+    or contributory patent infringement, then any patent licenses
+    granted to You under this License for that Work shall terminate
+    as of the date such litigation is filed.
+
+4.  Redistribution. You may reproduce and distribute copies of the
+    Work or Derivative Works thereof in any medium, with or without
+    modifications, and in Source or Object form, provided that You
+    meet the following conditions:
+
+    (a) You must give any other recipients of the Work or
+    Derivative Works a copy of this License; and
+
+    (b) You must cause any modified files to carry prominent notices
+    stating that You changed the files; and
+
+    (c) You must retain, in the Source form of any Derivative Works
+    that You distribute, all copyright, patent, trademark, and
+    attribution notices from the Source form of the Work,
+    excluding those notices that do not pertain to any part of
+    the Derivative Works; and
+
+    (d) If the Work includes a "NOTICE" text file as part of its
+    distribution, then any Derivative Works that You distribute must
+    include a readable copy of the attribution notices contained
+    within such NOTICE file, excluding those notices that do not
+    pertain to any part of the Derivative Works, in at least one
+    of the following places: within a NOTICE text file distributed
+    as part of the Derivative Works; within the Source form or
+    documentation, if provided along with the Derivative Works; or,
+    within a display generated by the Derivative Works, if and
+    wherever such third-party notices normally appear. The contents
+    of the NOTICE file are for informational purposes only and
+    do not modify the License. You may add Your own attribution
+    notices within Derivative Works that You distribute, alongside
+    or as an addendum to the NOTICE text from the Work, provided
+    that such additional attribution notices cannot be construed
+    as modifying the License.
+
+    You may add Your own copyright statement to Your modifications and
+    may provide additional or different license terms and conditions
+    for use, reproduction, or distribution of Your modifications, or
+    for any such Derivative Works as a whole, provided Your use,
+    reproduction, and distribution of the Work otherwise complies with
+    the conditions stated in this License.
+
+5.  Submission of Contributions. Unless You explicitly state otherwise,
+    any Contribution intentionally submitted for inclusion in the Work
+    by You to the Licensor shall be under the terms and conditions of
+    this License, without any additional terms or conditions.
+    Notwithstanding the above, nothing herein shall supersede or modify
+    the terms of any separate license agreement you may have executed
+    with Licensor regarding such Contributions.
+
+6.  Trademarks. This License does not grant permission to use the trade
+    names, trademarks, service marks, or product names of the Licensor,
+    except as required for reasonable and customary use in describing the
+    origin of the Work and reproducing the content of the NOTICE file.
+
+7.  Disclaimer of Warranty. Unless required by applicable law or
+    agreed to in writing, Licensor provides the Work (and each
+    Contributor provides its Contributions) on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+    implied, including, without limitation, any warranties or conditions
+    of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+    PARTICULAR PURPOSE. You are solely responsible for determining the
+    appropriateness of using or redistributing the Work and assume any
+    risks associated with Your exercise of permissions under this License.
+
+8.  Limitation of Liability. In no event and under no legal theory,
+    whether in tort (including negligence), contract, or otherwise,
+    unless required by applicable law (such as deliberate and grossly
+    negligent acts) or agreed to in writing, shall any Contributor be
+    liable to You for damages, including any direct, indirect, special,
+    incidental, or consequential damages of any character arising as a
+    result of this License or out of the use or inability to use the
+    Work (including but not limited to damages for loss of goodwill,
+    work stoppage, computer failure or malfunction, or any and all
+    other commercial damages or losses), even if such Contributor
+    has been advised of the possibility of such damages.
+
+9.  Accepting Warranty or Additional Liability. While redistributing
+    the Work or Derivative Works thereof, You may choose to offer,
+    and charge a fee for, acceptance of support, warranty, indemnity,
+    or other liability obligations and/or rights consistent with this
+    License. However, in accepting such obligations, You may act only
+    on Your own behalf and on Your sole responsibility, not on behalf
+    of any other Contributor, and only if You agree to indemnify,
+    defend, and hold each Contributor harmless for any liability
+    incurred by, or claims asserted against, such Contributor by reason
+    of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+Copyright 2025 Vercel Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/backend/data/runtime-dependency-manifest.json

@@ -0,0 +1,199 @@
+{
+  "schemaVersion": 1,
+  "dependencies": {
+    "codex": {
+      "version": "0.144.6",
+      "probe": {
+        "args": [
+          "--version"
+        ]
+      },
+      "artifacts": {
+        "darwin-arm64": {
+          "url": "https://registry.npmjs.org/@openai/codex/-/codex-0.144.6-darwin-arm64.tgz",
+          "integrity": "sha512-6zgvh70MzBNSeT17HEhSOrmmGGZGAKzSC7x6JAq+edkJkdPYA9P0I1tG7aJ49GlBkBxuC+MKBH1qm6+2Cghcww==",
+          "archive": "tgz",
+          "archivePrefix": "package/vendor/aarch64-apple-darwin",
+          "entry": "bin/codex"
+        },
+        "darwin-x64": {
+          "url": "https://registry.npmjs.org/@openai/codex/-/codex-0.144.6-darwin-x64.tgz",
+          "integrity": "sha512-THRyPG0zSU6M8NQAge1LHEHsJDnoH4BpKsfJHB/qe3Fm+Wf6zqAmWJFlOKzBm27m0K2Hq3za4Ac2I5p5i4yp/A==",
+          "archive": "tgz",
+          "archivePrefix": "package/vendor/x86_64-apple-darwin",
+          "entry": "bin/codex"
+        },
+        "linux-arm64": {
+          "url": "https://registry.npmjs.org/@openai/codex/-/codex-0.144.6-linux-arm64.tgz",
+          "integrity": "sha512-PGiLXMN+2IQRkf7tOLi64dMInjU1pRLbz0Rwfj/yt2Y97SZQqAjFQoi2wmswmqtqMDnfwCPTC1DRXVQkvU6T6Q==",
+          "archive": "tgz",
+          "archivePrefix": "package/vendor/aarch64-unknown-linux-musl",
+          "entry": "bin/codex"
+        },
+        "linux-arm64-musl": {
+          "url": "https://registry.npmjs.org/@openai/codex/-/codex-0.144.6-linux-arm64.tgz",
+          "integrity": "sha512-PGiLXMN+2IQRkf7tOLi64dMInjU1pRLbz0Rwfj/yt2Y97SZQqAjFQoi2wmswmqtqMDnfwCPTC1DRXVQkvU6T6Q==",
+          "archive": "tgz",
+          "archivePrefix": "package/vendor/aarch64-unknown-linux-musl",
+          "entry": "bin/codex"
+        },
+        "linux-x64": {
+          "url": "https://registry.npmjs.org/@openai/codex/-/codex-0.144.6-linux-x64.tgz",
+          "integrity": "sha512-4E7EnzCg0OnBxCyYnwJ+qnZwWHYe0YScr5ucKWbngE9u4+0XrpWELqq2Kn9jl5GZK8MDjU7PrJwFIwusHOHjuw==",
+          "archive": "tgz",
+          "archivePrefix": "package/vendor/x86_64-unknown-linux-musl",
+          "entry": "bin/codex"
+        },
+        "linux-x64-musl": {
+          "url": "https://registry.npmjs.org/@openai/codex/-/codex-0.144.6-linux-x64.tgz",
+          "integrity": "sha512-4E7EnzCg0OnBxCyYnwJ+qnZwWHYe0YScr5ucKWbngE9u4+0XrpWELqq2Kn9jl5GZK8MDjU7PrJwFIwusHOHjuw==",
+          "archive": "tgz",
+          "archivePrefix": "package/vendor/x86_64-unknown-linux-musl",
+          "entry": "bin/codex"
+        },
+        "win32-arm64": {
+          "url": "https://registry.npmjs.org/@openai/codex/-/codex-0.144.6-win32-arm64.tgz",
+          "integrity": "sha512-SpMjXJLW43JzMP0K62mVcYfmFcpk0BK4AOgYmWSfyZHs3iRtHMd0UYw7605n/9lwkT2EqbwQLT2omZFeKJFzwA==",
+          "archive": "tgz",
+          "archivePrefix": "package/vendor/aarch64-pc-windows-msvc",
+          "entry": "bin/codex.exe"
+        },
+        "win32-x64": {
+          "url": "https://registry.npmjs.org/@openai/codex/-/codex-0.144.6-win32-x64.tgz",
+          "integrity": "sha512-dN39VnjEthKz5io1RNWwZDtErdSn07nW3pGUgvlA6DMxgm/nuGaIAZO/sG/Hgxq/x5j9HteAENfrFgVkpZ0lFg==",
+          "archive": "tgz",
+          "archivePrefix": "package/vendor/x86_64-pc-windows-msvc",
+          "entry": "bin/codex.exe"
+        }
+      }
+    },
+    "claude": {
+      "version": "0.3.207",
+      "reportedVersion": "2.1.0",
+      "managedProbe": false,
+      "probe": {
+        "args": [
+          "--version"
+        ]
+      },
+      "artifacts": {
+        "darwin-arm64": {
+          "url": "https://registry.npmjs.org/@anthropic-ai/claude-agent-sdk-darwin-arm64/-/claude-agent-sdk-darwin-arm64-0.3.207.tgz",
+          "integrity": "sha512-08xSo1FDx8h0aLhL5tvcRxa2SMmcUV3aDWeZiEJVTclyiDAs61BgTjAxCg+SZcu1CndjJO8cfO0yM5dhamxz3g==",
+          "archive": "tgz",
+          "archivePrefix": "package",
+          "entry": "claude"
+        },
+        "darwin-x64": {
+          "url": "https://registry.npmjs.org/@anthropic-ai/claude-agent-sdk-darwin-x64/-/claude-agent-sdk-darwin-x64-0.3.207.tgz",
+          "integrity": "sha512-1o7K4EYqyCixZ/oeOZSh7AzSy6TM86xoOuf4VuORjPSS31hBnoqY0NGZd27+2VDs9LGtsdksmsTqcNGx9xd1hA==",
+          "archive": "tgz",
+          "archivePrefix": "package",
+          "entry": "claude"
+        },
+        "linux-arm64": {
+          "url": "https://registry.npmjs.org/@anthropic-ai/claude-agent-sdk-linux-arm64/-/claude-agent-sdk-linux-arm64-0.3.207.tgz",
+          "integrity": "sha512-X4uezYOifDiNTTmmugfRCdg3nNamrr1LFRY9hg30vWYTShL+bbN+nfC3KaFfSYCl4GTtsEEUbYdOTC2F3bBpcA==",
+          "archive": "tgz",
+          "archivePrefix": "package",
+          "entry": "claude"
+        },
+        "linux-arm64-musl": {
+          "url": "https://registry.npmjs.org/@anthropic-ai/claude-agent-sdk-linux-arm64-musl/-/claude-agent-sdk-linux-arm64-musl-0.3.207.tgz",
+          "integrity": "sha512-oPj+g2DslhH4Y9nCTs7al4t9wZv78FZwLFQwOCg99BXuz1o0ZOpKmxyvR7J9eBR+GPszeMMS8gYplQTiZC9o2w==",
+          "archive": "tgz",
+          "archivePrefix": "package",
+          "entry": "claude"
+        },
+        "linux-x64": {
+          "url": "https://registry.npmjs.org/@anthropic-ai/claude-agent-sdk-linux-x64/-/claude-agent-sdk-linux-x64-0.3.207.tgz",
+          "integrity": "sha512-Kg6BPH8Ee0ny/oEUWJmvT1jCRBne4jVpRSOMsJcYp1Fav1rMEgpU219oJJs+LWwx4ifuuLtNWedqJNnVw7mnKg==",
+          "archive": "tgz",
+          "archivePrefix": "package",
+          "entry": "claude"
+        },
+        "linux-x64-musl": {
+          "url": "https://registry.npmjs.org/@anthropic-ai/claude-agent-sdk-linux-x64-musl/-/claude-agent-sdk-linux-x64-musl-0.3.207.tgz",
+          "integrity": "sha512-uRv+D5oG/7EYr41FAJ9IPo2pZYBe2ZMaA6nSHCeizsgPxCSMtl5bNppmU21+jZJvo4hivObEgkGFERAhdGqygg==",
+          "archive": "tgz",
+          "archivePrefix": "package",
+          "entry": "claude"
+        },
+        "win32-arm64": {
+          "url": "https://registry.npmjs.org/@anthropic-ai/claude-agent-sdk-win32-arm64/-/claude-agent-sdk-win32-arm64-0.3.207.tgz",
+          "integrity": "sha512-9fWpUzfkXlPAg2tf8JpQe7w9avFaomAUbfAwyAmykQgSIf66LwaJjvI5hNqhNqczRKyfsXPn3ei2S5HKlmFP+Q==",
+          "archive": "tgz",
+          "archivePrefix": "package",
+          "entry": "claude.exe"
+        },
+        "win32-x64": {
+          "url": "https://registry.npmjs.org/@anthropic-ai/claude-agent-sdk-win32-x64/-/claude-agent-sdk-win32-x64-0.3.207.tgz",
+          "integrity": "sha512-YPjVT0q6aXEM2MgN4CI6/9fqiTXwETji+4NoPOzCYuqAkhXZqp30Jsk7/NHqYGNNSfURKrsuAoliKB0rsbpbjg==",
+          "archive": "tgz",
+          "archivePrefix": "package",
+          "entry": "claude.exe"
+        }
+      }
+    },
+    "agentBrowser": {
+      "version": "0.32.3",
+      "probe": {
+        "args": [
+          "--version"
+        ]
+      },
+      "artifacts": {
+        "darwin-arm64": {
+          "url": "https://registry.npmjs.org/agent-browser/-/agent-browser-0.32.3.tgz",
+          "integrity": "sha512-jwmqex/vEFNWx7X/W3JnZSWm5C+46SFKWDXYD7timGPCcvqHZtdVIBnKGUz7iCJYflQg4DrtxWUWzuin9+zoyA==",
+          "archive": "tgz",
+          "archiveEntry": "package/bin/agent-browser-darwin-arm64",
+          "entry": "agent-browser"
+        },
+        "darwin-x64": {
+          "url": "https://registry.npmjs.org/agent-browser/-/agent-browser-0.32.3.tgz",
+          "integrity": "sha512-jwmqex/vEFNWx7X/W3JnZSWm5C+46SFKWDXYD7timGPCcvqHZtdVIBnKGUz7iCJYflQg4DrtxWUWzuin9+zoyA==",
+          "archive": "tgz",
+          "archiveEntry": "package/bin/agent-browser-darwin-x64",
+          "entry": "agent-browser"
+        },
+        "linux-arm64": {
+          "url": "https://registry.npmjs.org/agent-browser/-/agent-browser-0.32.3.tgz",
+          "integrity": "sha512-jwmqex/vEFNWx7X/W3JnZSWm5C+46SFKWDXYD7timGPCcvqHZtdVIBnKGUz7iCJYflQg4DrtxWUWzuin9+zoyA==",
+          "archive": "tgz",
+          "archiveEntry": "package/bin/agent-browser-linux-arm64",
+          "entry": "agent-browser"
+        },
+        "linux-arm64-musl": {
+          "url": "https://registry.npmjs.org/agent-browser/-/agent-browser-0.32.3.tgz",
+          "integrity": "sha512-jwmqex/vEFNWx7X/W3JnZSWm5C+46SFKWDXYD7timGPCcvqHZtdVIBnKGUz7iCJYflQg4DrtxWUWzuin9+zoyA==",
+          "archive": "tgz",
+          "archiveEntry": "package/bin/agent-browser-linux-musl-arm64",
+          "entry": "agent-browser"
+        },
+        "linux-x64": {
+          "url": "https://registry.npmjs.org/agent-browser/-/agent-browser-0.32.3.tgz",
+          "integrity": "sha512-jwmqex/vEFNWx7X/W3JnZSWm5C+46SFKWDXYD7timGPCcvqHZtdVIBnKGUz7iCJYflQg4DrtxWUWzuin9+zoyA==",
+          "archive": "tgz",
+          "archiveEntry": "package/bin/agent-browser-linux-x64",
+          "entry": "agent-browser"
+        },
+        "linux-x64-musl": {
+          "url": "https://registry.npmjs.org/agent-browser/-/agent-browser-0.32.3.tgz",
+          "integrity": "sha512-jwmqex/vEFNWx7X/W3JnZSWm5C+46SFKWDXYD7timGPCcvqHZtdVIBnKGUz7iCJYflQg4DrtxWUWzuin9+zoyA==",
+          "archive": "tgz",
+          "archiveEntry": "package/bin/agent-browser-linux-musl-x64",
+          "entry": "agent-browser"
+        },
+        "win32-x64": {
+          "url": "https://registry.npmjs.org/agent-browser/-/agent-browser-0.32.3.tgz",
+          "integrity": "sha512-jwmqex/vEFNWx7X/W3JnZSWm5C+46SFKWDXYD7timGPCcvqHZtdVIBnKGUz7iCJYflQg4DrtxWUWzuin9+zoyA==",
+          "archive": "tgz",
+          "archiveEntry": "package/bin/agent-browser-win32-x64.exe",
+          "entry": "agent-browser.exe"
+        }
+      }
+    }
+  },
+  "manifestId": "e84575670b5e7bb7b429a960ac6b6c17ae21ed8cb4ab25836cec8c582091ef5f"
+}

package/backend/data/runtime-dependency-sources.json

@@ -0,0 +1,5 @@
+{
+  "schemaVersion": 1,
+  "authoritativeNpmRegistry": "https://registry.npmjs.org/",
+  "defaultNpmMirror": "https://registry.npmmirror.com/"
+}

package/backend/executable-discovery.js

@@ -86,6 +86,13 @@ function clearExecutableVersionCache() {
 
 function getPreferredExecutableCandidates(agentName, pathEnv = process.env.PATH || '') {
   const pathCandidates = getPathDirectories(pathEnv).map((dir) => path.join(dir, agentName));
+  if (agentName === 'claude') {
+    return [
+      process.env.FARMING_CLAUDE_BIN || '',
+      process.env.CLAUDE_CODE_EXECUTABLE || '',
+      ...pathCandidates,
+    ].filter(Boolean);
+  }
   if (agentName !== 'codex') return pathCandidates;
 
   return [

package/backend/farming-agent-bootstrap.zh_cn.md

@@ -1,5 +1,7 @@
 你由 Farming 启动并托管。Farming 是一个供用户同时运行、观察和管理多个 AI 编程 Agent 的工作区，统一承载 Agent 对话、终端、项目文件，以及可由用户和 Agent 共同使用的扩展资源。
 
-Farming 可能为当前会话提供系统浏览器、Agent 协作等能力。能力是否可用以 `farming capabilities` 的实时结果为准，不要自行假设。
+Farming 可能为当前会话提供系统浏览器、Agent 协作等能力。能力是否可用以 `"$FARMING_CLI_BIN_DIR/farming" capabilities` 的实时结果为准，不要自行假设。必须通过 `"$FARMING_CLI_BIN_DIR/farming"` 调用托管当前 Agent 的 Farming 实例；不要依赖 Shell 的 `PATH`，因为登录 Shell 可能把另一个 Farming 安装解析为 `farming`。下文帮助文本中的 `farming` 均代表这个精确入口。
 
-当任务需要查看或操作网页时，你可以主动查询能力，并自行决定是否创建新的 Farming Browser 或连接已有 Browser。Farming Browser 会显示在用户界面中，用户和你操作的是同一个浏览器会话。只启用完成当前任务所需的能力。
+Farming 将 `agent-browser` 封装为 Farming Browser：Agent 可以通过结构化快照和操作命令更好地查看、调试和操作网页，用户也能在 Farming Viewer 中看到并理解同一个浏览器会话的进展，必要时直接接管。
+
+当任务涉及打开、查看、调试或操作网页时，先运行 `"$FARMING_CLI_BIN_DIR/farming" capabilities`。Browser 可用时，Farming Browser 是默认浏览器路径：必须优先使用它，先复用当前 Project 的已有 Browser，或按需创建新的 Browser，并把需要用户复查的最终页面留在该 Browser 中。这样会创建 Farming 内可点击、可接管的共享 Browser Resource。不要改用 Provider 自带的通用 Browser、Chrome、Playwright、Puppeteer、Computer Use 或其他仅 Agent 可见的浏览器工具；只有 Farming Browser 不可用、任务明确需要尚未支持的能力，或用户明确指定其他工具时才例外。先用 `"$FARMING_CLI_BIN_DIR/farming" browser list` 发现 Browser；需要标准流程时运行 `"$FARMING_CLI_BIN_DIR/farming" browser help workflow`，只在当前步骤需要时再展开某个帮助主题或具体子命令。