Skip to content

Beautiful, AI-native markdown IDE and LLM wiki

fix(ok): explain locked agent connections in dev builds (PRD-8953) (#5427)

tim-inkeepb67209dac2fd
diff --git a/.changeset/dev-build-agent-connections-copy.md b/.changeset/dev-build-agent-connections-copy.md
new file mode 100644
index 000000000..d6a7e9519
--- /dev/null
+++ b/.changeset/dev-build-agent-connections-copy.md
@@ -0,0 +1,5 @@
+---
+"@inkeep/open-knowledge": patch
+---
+
+Agent connections in a development build now explain that the build can't connect agents so it leaves your installed app's setup alone, instead of saying the feature is unavailable.
diff --git a/packages/app/src/components/settings/AgentConnectionDialogs.dom.test.tsx b/packages/app/src/components/settings/AgentConnectionDialogs.dom.test.tsx
index 4f9208d6e..68f52aa91 100644
--- a/packages/app/src/components/settings/AgentConnectionDialogs.dom.test.tsx
+++ b/packages/app/src/components/settings/AgentConnectionDialogs.dom.test.tsx
@@ -1171,6 +1171,26 @@ describe('a failed save names its reason', () => {
expect(text).toContain('Managing agent connections is unavailable in this build.');
});
+ test('a dev build explains the lock in the save dialog instead of saying "unavailable"', async () => {
+ const before = snapshotWith();
+ const apply = vi.fn(async (intents: readonly ApplyIntent[]) => {
+ if (intents.length === 0) return result(before);
+ return {
+ ok: false,
+ unavailable: true,
+ devBuild: true,
+ error: 'Managing AI tool connections is unavailable in this build.',
+ report: EMPTY_REPORT,
+ snapshot: before,
+ } satisfies ApplyAgentConnectionsResult;
+ });
+ const text = await saveAndReadAlert('claude', apply);
+ expect(text).toContain(
+ "This development build can't connect agents, so it won't change the agent setup of your installed OpenKnowledge app.",
+ );
+ expect(text).not.toContain('unavailable in this build');
+ });
+
test('an unexplained failure still shows the host error text under the generic line', async () => {
const before = snapshotWith();
const apply = vi.fn(async (intents: readonly ApplyIntent[]) => {
diff --git a/packages/app/src/components/settings/AgentConnectionDialogs.tsx b/packages/app/src/components/settings/AgentConnectionDialogs.tsx
index 5b559f7e0..e04552c26 100644
--- a/packages/app/src/components/settings/AgentConnectionDialogs.tsx
+++ b/packages/app/src/components/settings/AgentConnectionDialogs.tsx
@@ -640,7 +640,9 @@ function ApplyFailureAlert({
if (result.unavailable === true) {
return (
<p role="alert" className="text-sm text-destructive">
- {t`Managing agent connections is unavailable in this build.`}
+ {result.devBuild === true
+ ? t`This development build can't connect agents, so it won't change the agent setup of your installed OpenKnowledge app.`
+ : t`Managing agent connections is unavailable in this build.`}
</p>
);
}
diff --git a/packages/app/src/components/settings/AgentConnectionsSection.dom.test.tsx b/packages/app/src/components/settings/AgentConnectionsSection.dom.test.tsx
index 2c40e86b6..5d1cca10d 100644
--- a/packages/app/src/components/settings/AgentConnectionsSection.dom.test.tsx
+++ b/packages/app/src/components/settings/AgentConnectionsSection.dom.test.tsx
@@ -1976,6 +1976,23 @@ describe('a host that cannot manage connections', () => {
}
});
+ test('a dev build explains why instead of saying "unavailable"', async () => {
+ renderSection(async () => ({
+ ok: false,
+ unavailable: true,
+ devBuild: true,
+ error: 'Managing AI tool connections is unavailable in this build.',
+ report: EMPTY_REPORT,
+ snapshot: snapshotWith([]),
+ }));
+
+ const notice = await screen.findByTestId('configure-agents-read-only');
+ expect(notice.textContent).toContain(
+ "This development build can't connect agents, so it won't change the agent setup of your installed OpenKnowledge app.",
+ );
+ expect(notice.textContent).not.toContain('unavailable in this build');
+ });
+
test('a read-only build hides the cleanup link even when files are on disk', async () => {
terminalLaunchValue = { installedClis: { claude: true, pi: false } };
reloadEnabledAgentsFromStorage();
diff --git a/packages/app/src/components/settings/AgentConnectionsSection.tsx b/packages/app/src/components/settings/AgentConnectionsSection.tsx
index 64362c6f7..be77783e0 100644
--- a/packages/app/src/components/settings/AgentConnectionsSection.tsx
+++ b/packages/app/src/components/settings/AgentConnectionsSection.tsx
@@ -516,6 +516,7 @@ export function AgentConnectionsSection({
const [snapshot, setSnapshot] = useState<HostSnapshot | null>(null);
const [readFailed, setReadFailed] = useState(false);
const [readOnly, setReadOnly] = useState(false);
+ const [devBuild, setDevBuild] = useState(false);
const [reloadInstallState, setReloadInstallState] = useState(0);
const [configureId, setConfigureId] = useState<AgentId | null>(null);
const [removeId, setRemoveId] = useState<AgentId | null>(null);
@@ -559,6 +560,7 @@ export function AgentConnectionsSection({
if (result.snapshot !== null) setSnapshot(result.snapshot);
setReadFailed(!readProducedFacts(result.snapshot));
setReadOnly(result.unavailable === true);
+ setDevBuild(result.devBuild === true);
})
.catch(() => {
if (active && requestVersion.current === version) setReadFailed(true);
@@ -584,6 +586,7 @@ export function AgentConnectionsSection({
if (result.snapshot !== null) setSnapshot(result.snapshot);
setReadFailed(!readProducedFacts(result.snapshot));
if (result.unavailable === true) setReadOnly(true);
+ if (result.devBuild === true) setDevBuild(true);
return result;
}
@@ -1122,7 +1125,11 @@ export function AgentConnectionsSection({
data-testid="configure-agents-read-only"
>
<TriangleAlert aria-hidden className="size-4 shrink-0" />
- <span>{t`Managing agent connections is unavailable in this build.`}</span>
+ <span>
+ {devBuild
+ ? t`This development build can't connect agents, so it won't change the agent setup of your installed OpenKnowledge app.`
+ : t`Managing agent connections is unavailable in this build.`}
+ </span>
</div>
) : null}
diff --git a/packages/app/src/lib/agent-connections.test.ts b/packages/app/src/lib/agent-connections.test.ts
index cce224353..3a11ad5b9 100644
--- a/packages/app/src/lib/agent-connections.test.ts
+++ b/packages/app/src/lib/agent-connections.test.ts
@@ -243,6 +243,22 @@ describe('what a refused desktop apply carries back', () => {
});
});
+ test('keeps the dev-build flag', async () => {
+ const apply = vi.fn(async () => ({
+ ok: false as const,
+ error: 'Managing AI tool connections is unavailable in this build.',
+ unavailable: true,
+ devBuild: true,
+ report: EMPTY_REPORT,
+ snapshot: SNAPSHOT,
+ }));
+ vi.stubGlobal('window', { okDesktop: { agentIntegrations: { apply } } });
+
+ const result = await applyAgentConnectionIntents([]);
+
+ expect(result).toMatchObject({ unavailable: true, devBuild: true });
+ });
+
test('keeps a thrown bridge error as text', async () => {
const apply = vi.fn(async () => {
throw new Error('bridge exploded');
diff --git a/packages/app/src/lib/agent-connections.ts b/packages/app/src/lib/agent-connections.ts
index 03f9d01f8..54fcb6200 100644
--- a/packages/app/src/lib/agent-connections.ts
+++ b/packages/app/src/lib/agent-connections.ts
@@ -11,6 +11,7 @@ export interface ApplyAgentConnectionsResult {
readonly snapshot: HostSnapshot | null;
readonly error?: string;
readonly unavailable?: boolean;
+ readonly devBuild?: boolean;
}
const EMPTY_REPORT: ApplyReport = { actions: [], conflicts: [], withheld: [] };
@@ -40,6 +41,7 @@ async function requestAgentConnectionIntents(
snapshot: result.snapshot,
error: result.error,
...(result.unavailable === true ? { unavailable: true } : {}),
+ ...(result.devBuild === true ? { devBuild: true } : {}),
};
} catch (err) {
return {
diff --git a/packages/app/src/locales/ar/messages.json b/packages/app/src/locales/ar/messages.json
index e51fd2380..32d776339 100644
--- a/packages/app/src/locales/ar/messages.json
+++ b/packages/app/src/locales/ar/messages.json
@@ -1140,6 +1140,9 @@
"AT0e50": ["الاحتفاظ بكليهما"],
"ATGYL1": ["عنوان البريد الإلكتروني"],
"AUMPjj": ["مسافة للقفز، سهم لأسفل للانحناء. هذه هي اللعبة كلها."],
+ "AUORpp": [
+ "لا يمكن لإصدار التطوير هذا ربط الوكلاء، لذا لن يغيّر إعداد الوكلاء في تطبيق OpenKnowledge المثبّت لديك."
+ ],
"AUV-TY": ["يفكّر"],
"AVW-K9": ["فشل تحميل الصفحات اليتيمة"],
"AWOSPo": ["تكبير"],
diff --git a/packages/app/src/locales/ar/messages.po b/packages/app/src/locales/ar/messages.po
index e729f06c8..3b7f69b16 100644
--- a/packages/app/src/locales/ar/messages.po
+++ b/packages/app/src/locales/ar/messages.po
@@ -15109,6 +15109,11 @@ msgstr "تعذّر إعداد هذا لأن إدخال خادم MCP الذي ي
msgid "This deletes the MCP server entries and skill files listed below. The agent will lose access to your documents until you add it again."
msgstr "يحذف هذا إدخالات خادم MCP وملفات المهارات المدرجة أدناه. سيفقد الوكيل إمكانية الوصول إلى مستنداتك حتى تضيفه مرة أخرى."
+#: src/components/settings/AgentConnectionDialogs.tsx
+#: src/components/settings/AgentConnectionsSection.tsx
+msgid "This development build can't connect agents, so it won't change the agent setup of your installed OpenKnowledge app."
+msgstr "لا يمكن لإصدار التطوير هذا ربط الوكلاء، لذا لن يغيّر إعداد الوكلاء في تطبيق OpenKnowledge المثبّت لديك."
+
#. placeholder {0}: connection.label
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "This disconnects {0} from OpenKnowledge."
diff --git a/packages/app/src/locales/bn/messages.json b/packages/app/src/locales/bn/messages.json
index efcf99ee2..5993c4edf 100644
--- a/packages/app/src/locales/bn/messages.json
+++ b/packages/app/src/locales/bn/messages.json
@@ -956,6 +956,9 @@
"AT0e50": ["দুটোই রাখুন"],
"ATGYL1": ["ইমেইল ঠিকানা"],
"AUMPjj": ["লাফাতে স্পেস, নিচু হতে নিচের তির। খেলাটা এটুকুই।"],
+ "AUORpp": [
+ "এই ডেভেলপমেন্ট বিল্ড এজেন্ট সংযোগ করতে পারে না, তাই এটি আপনার ইনস্টল করা OpenKnowledge অ্যাপের এজেন্ট সেটআপ পরিবর্তন করবে না।"
+ ],
"AUV-TY": ["ভাবছে"],
"AVW-K9": ["অনাথ পাতা লোড করতে ব্যর্থ"],
"AWOSPo": ["বড় করুন"],
diff --git a/packages/app/src/locales/bn/messages.po b/packages/app/src/locales/bn/messages.po
index 1aafe981f..1a2365661 100644
--- a/packages/app/src/locales/bn/messages.po
+++ b/packages/app/src/locales/bn/messages.po
@@ -15105,6 +15105,11 @@ msgstr "এটি সেট আপ করা যায়নি কারণ এ
msgid "This deletes the MCP server entries and skill files listed below. The agent will lose access to your documents until you add it again."
msgstr "এটি নিচে তালিকাভুক্ত MCP সার্ভার এন্ট্রি ও স্কিল ফাইল মুছে দেয়। আবার যোগ না করা পর্যন্ত এজেন্ট আপনার নথিতে প্রবেশাধিকার হারাবে।"
+#: src/components/settings/AgentConnectionDialogs.tsx
+#: src/components/settings/AgentConnectionsSection.tsx
+msgid "This development build can't connect agents, so it won't change the agent setup of your installed OpenKnowledge app."
+msgstr "এই ডেভেলপমেন্ট বিল্ড এজেন্ট সংযোগ করতে পারে না, তাই এটি আপনার ইনস্টল করা OpenKnowledge অ্যাপের এজেন্ট সেটআপ পরিবর্তন করবে না।"
+
#. placeholder {0}: connection.label
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "This disconnects {0} from OpenKnowledge."
diff --git a/packages/app/src/locales/en/messages.json b/packages/app/src/locales/en/messages.json
index f96762422..1d110d5b6 100644
--- a/packages/app/src/locales/en/messages.json
+++ b/packages/app/src/locales/en/messages.json
@@ -987,6 +987,9 @@
"AT0e50": ["Keep both"],
"ATGYL1": ["Email address"],
"AUMPjj": ["Space to jump, down arrow to duck. That is the whole game."],
+ "AUORpp": [
+ "This development build can't connect agents, so it won't change the agent setup of your installed OpenKnowledge app."
+ ],
"AUV-TY": ["Thinking"],
"AVW-K9": ["Failed to load orphan pages"],
"AWOSPo": ["Zoom in"],
diff --git a/packages/app/src/locales/en/messages.po b/packages/app/src/locales/en/messages.po
index 64ef23dc6..dddfd355c 100644
--- a/packages/app/src/locales/en/messages.po
+++ b/packages/app/src/locales/en/messages.po
@@ -15109,6 +15109,11 @@ msgstr "This could not be set up because the MCP server entry it needs was not w
msgid "This deletes the MCP server entries and skill files listed below. The agent will lose access to your documents until you add it again."
msgstr "This deletes the MCP server entries and skill files listed below. The agent will lose access to your documents until you add it again."
+#: src/components/settings/AgentConnectionDialogs.tsx
+#: src/components/settings/AgentConnectionsSection.tsx
+msgid "This development build can't connect agents, so it won't change the agent setup of your installed OpenKnowledge app."
+msgstr "This development build can't connect agents, so it won't change the agent setup of your installed OpenKnowledge app."
+
#. placeholder {0}: connection.label
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "This disconnects {0} from OpenKnowledge."
diff --git a/packages/app/src/locales/es/messages.json b/packages/app/src/locales/es/messages.json
index 847373ecf..bbb600b4c 100644
--- a/packages/app/src/locales/es/messages.json
+++ b/packages/app/src/locales/es/messages.json
@@ -1154,6 +1154,9 @@
"AT0e50": ["Conservar ambos"],
"ATGYL1": ["Dirección de correo"],
"AUMPjj": ["Espacio para saltar, flecha abajo para agacharse. Ese es todo el juego."],
+ "AUORpp": [
+ "Esta versión de desarrollo no puede conectar agentes, así que no cambiará la configuración de agentes de tu app OpenKnowledge instalada."
+ ],
"AUV-TY": ["Pensando"],
"AVW-K9": ["No se pudieron cargar las páginas huérfanas"],
"AWOSPo": ["Acercar"],
diff --git a/packages/app/src/locales/es/messages.po b/packages/app/src/locales/es/messages.po
index 3aab897ad..f765d5e2d 100644
--- a/packages/app/src/locales/es/messages.po
+++ b/packages/app/src/locales/es/messages.po
@@ -15109,6 +15109,11 @@ msgstr "No se pudo configurar porque la entrada del servidor MCP que necesita no
msgid "This deletes the MCP server entries and skill files listed below. The agent will lose access to your documents until you add it again."
msgstr "Esto elimina las entradas del servidor MCP y los archivos de habilidades que se indican abajo. El agente perderá el acceso a tus documentos hasta que vuelvas a añadirlo."
+#: src/components/settings/AgentConnectionDialogs.tsx
+#: src/components/settings/AgentConnectionsSection.tsx
+msgid "This development build can't connect agents, so it won't change the agent setup of your installed OpenKnowledge app."
+msgstr "Esta versión de desarrollo no puede conectar agentes, así que no cambiará la configuración de agentes de tu app OpenKnowledge instalada."
+
#. placeholder {0}: connection.label
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "This disconnects {0} from OpenKnowledge."
diff --git a/packages/app/src/locales/fr/messages.json b/packages/app/src/locales/fr/messages.json
index 0ce6e7076..cc485f41d 100644
--- a/packages/app/src/locales/fr/messages.json
+++ b/packages/app/src/locales/fr/messages.json
@@ -1183,6 +1183,9 @@
"AT0e50": ["Conserver les deux"],
"ATGYL1": ["Adresse e-mail"],
"AUMPjj": ["Espace pour sauter, flèche bas pour s'accroupir. C'est tout le jeu."],
+ "AUORpp": [
+ "Cette version de développement ne peut pas connecter d'agents, elle ne modifiera donc pas la configuration des agents de votre application OpenKnowledge installée."
+ ],
"AUV-TY": ["Réflexion"],
"AVW-K9": ["Échec du chargement des pages orphelines"],
"AWOSPo": ["Zoom avant"],
diff --git a/packages/app/src/locales/fr/messages.po b/packages/app/src/locales/fr/messages.po
index 409150ef6..27de09b7c 100644
--- a/packages/app/src/locales/fr/messages.po
+++ b/packages/app/src/locales/fr/messages.po
@@ -15109,6 +15109,11 @@ msgstr "La configuration a échoué, car l'entrée de serveur MCP nécessaire n'
msgid "This deletes the MCP server entries and skill files listed below. The agent will lose access to your documents until you add it again."
msgstr "Cela supprime les entrées du serveur MCP et les fichiers de compétences ci-dessous. L'agent perdra l'accès à vos documents jusqu'à ce que vous l'ajoutiez à nouveau."
+#: src/components/settings/AgentConnectionDialogs.tsx
+#: src/components/settings/AgentConnectionsSection.tsx
+msgid "This development build can't connect agents, so it won't change the agent setup of your installed OpenKnowledge app."
+msgstr "Cette version de développement ne peut pas connecter d'agents, elle ne modifiera donc pas la configuration des agents de votre application OpenKnowledge installée."
+
#. placeholder {0}: connection.label
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "This disconnects {0} from OpenKnowledge."
diff --git a/packages/app/src/locales/hi/messages.json b/packages/app/src/locales/hi/messages.json
index ad9725936..85850b613 100644
--- a/packages/app/src/locales/hi/messages.json
+++ b/packages/app/src/locales/hi/messages.json
@@ -960,6 +960,9 @@
"AT0e50": ["दोनों रखें"],
"ATGYL1": ["ईमेल पता"],
"AUMPjj": ["कूदने के लिए स्पेस, झुकने के लिए नीचे तीर। बस इतना ही खेल है।"],
+ "AUORpp": [
+ "यह डेवलपमेंट बिल्ड एजेंट कनेक्ट नहीं कर सकता, इसलिए यह आपके इंस्टॉल किए गए OpenKnowledge ऐप का एजेंट सेटअप नहीं बदलेगा।"
+ ],
"AUV-TY": ["सोच रहा है"],
"AVW-K9": ["अनाथ पेज लोड करने में विफल"],
"AWOSPo": ["बड़ा करें"],
diff --git a/packages/app/src/locales/hi/messages.po b/packages/app/src/locales/hi/messages.po
index 1d14d7edd..1e3598a0b 100644
--- a/packages/app/src/locales/hi/messages.po
+++ b/packages/app/src/locales/hi/messages.po
@@ -15105,6 +15105,11 @@ msgstr "इसे सेट अप नहीं किया जा सका
msgid "This deletes the MCP server entries and skill files listed below. The agent will lose access to your documents until you add it again."
msgstr "यह नीचे दी गई MCP सर्वर प्रविष्टियाँ और स्किल फ़ाइलें मिटा देता है। दोबारा जोड़ने तक एजेंट आपके दस्तावेज़ों तक पहुँच खो देगा।"
+#: src/components/settings/AgentConnectionDialogs.tsx
+#: src/components/settings/AgentConnectionsSection.tsx
+msgid "This development build can't connect agents, so it won't change the agent setup of your installed OpenKnowledge app."
+msgstr "यह डेवलपमेंट बिल्ड एजेंट कनेक्ट नहीं कर सकता, इसलिए यह आपके इंस्टॉल किए गए OpenKnowledge ऐप का एजेंट सेटअप नहीं बदलेगा।"
+
#. placeholder {0}: connection.label
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "This disconnects {0} from OpenKnowledge."
diff --git a/packages/app/src/locales/id/messages.json b/packages/app/src/locales/id/messages.json
index 07f16de7c..7b3b6f30c 100644
--- a/packages/app/src/locales/id/messages.json
+++ b/packages/app/src/locales/id/messages.json
@@ -993,6 +993,9 @@
"AT0e50": ["Simpan keduanya"],
"ATGYL1": ["Alamat surel"],
"AUMPjj": ["Spasi untuk melompat, panah bawah untuk menunduk. Hanya itu permainannya."],
+ "AUORpp": [
+ "Build pengembangan ini tidak dapat menghubungkan agen, jadi tidak akan mengubah pengaturan agen di aplikasi OpenKnowledge yang terpasang."
+ ],
"AUV-TY": ["Berpikir"],
"AVW-K9": ["Gagal memuat halaman yatim"],
"AWOSPo": ["Perbesar"],
diff --git a/packages/app/src/locales/id/messages.po b/packages/app/src/locales/id/messages.po
index c42ea0e18..dede9c847 100644
--- a/packages/app/src/locales/id/messages.po
+++ b/packages/app/src/locales/id/messages.po
@@ -15105,6 +15105,11 @@ msgstr "Ini tidak dapat disiapkan karena entri server MCP yang diperlukan tidak
msgid "This deletes the MCP server entries and skill files listed below. The agent will lose access to your documents until you add it again."
msgstr "Tindakan ini menghapus entri server MCP dan file keterampilan yang tercantum di bawah. Agen akan kehilangan akses ke dokumen Anda sampai Anda menambahkannya lagi."
+#: src/components/settings/AgentConnectionDialogs.tsx
+#: src/components/settings/AgentConnectionsSection.tsx
+msgid "This development build can't connect agents, so it won't change the agent setup of your installed OpenKnowledge app."
+msgstr "Build pengembangan ini tidak dapat menghubungkan agen, jadi tidak akan mengubah pengaturan agen di aplikasi OpenKnowledge yang terpasang."
+
#. placeholder {0}: connection.label
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "This disconnects {0} from OpenKnowledge."
diff --git a/packages/app/src/locales/ko/messages.json b/packages/app/src/locales/ko/messages.json
index 1dbfb1d51..4e6b92092 100644
--- a/packages/app/src/locales/ko/messages.json
+++ b/packages/app/src/locales/ko/messages.json
@@ -958,6 +958,9 @@
"AT0e50": ["둘 다 유지"],
"ATGYL1": ["이메일 주소"],
"AUMPjj": ["스페이스로 점프하고 아래쪽 화살표로 숙입니다. 게임은 이것이 전부입니다."],
+ "AUORpp": [
+ "이 개발 빌드는 에이전트를 연결할 수 없으므로 설치된 OpenKnowledge 앱의 에이전트 설정을 변경하지 않습니다."
+ ],
"AUV-TY": ["생각 중"],
"AVW-K9": ["고아 페이지 불러오기 실패"],
"AWOSPo": ["확대"],
diff --git a/packages/app/src/locales/ko/messages.po b/packages/app/src/locales/ko/messages.po
index 2ff8d90a1..2034d5552 100644
--- a/packages/app/src/locales/ko/messages.po
+++ b/packages/app/src/locales/ko/messages.po
@@ -15109,6 +15109,11 @@ msgstr "필요한 MCP 서버 항목이 기록되지 않아 설정할 수 없었
msgid "This deletes the MCP server entries and skill files listed below. The agent will lose access to your documents until you add it again."
msgstr "아래 나열된 MCP 서버 항목과 스킬 파일을 삭제합니다. 다시 추가할 때까지 에이전트가 문서에 접근할 수 없습니다."
+#: src/components/settings/AgentConnectionDialogs.tsx
+#: src/components/settings/AgentConnectionsSection.tsx
+msgid "This development build can't connect agents, so it won't change the agent setup of your installed OpenKnowledge app."
+msgstr "이 개발 빌드는 에이전트를 연결할 수 없으므로 설치된 OpenKnowledge 앱의 에이전트 설정을 변경하지 않습니다."
+
#. placeholder {0}: connection.label
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "This disconnects {0} from OpenKnowledge."
diff --git a/packages/app/src/locales/pl/messages.json b/packages/app/src/locales/pl/messages.json
index 448b86649..4c2d57346 100644
--- a/packages/app/src/locales/pl/messages.json
+++ b/packages/app/src/locales/pl/messages.json
@@ -1191,6 +1191,9 @@
"AT0e50": ["Zachowaj oba"],
"ATGYL1": ["Adres e-mail"],
"AUMPjj": ["Spacja do skoku, strzałka w dół, żeby się schować. To cała gra."],
+ "AUORpp": [
+ "Ta wersja deweloperska nie może łączyć agentów, więc nie zmieni konfiguracji agentów w zainstalowanej aplikacji OpenKnowledge."
+ ],
"AUV-TY": ["Myślenie"],
"AVW-K9": ["Nie udało się wczytać stron osieroconych"],
"AWOSPo": ["Powiększ"],
diff --git a/packages/app/src/locales/pl/messages.po b/packages/app/src/locales/pl/messages.po
index 3ca531e2b..ec9bcaf61 100644
--- a/packages/app/src/locales/pl/messages.po
+++ b/packages/app/src/locales/pl/messages.po
@@ -15109,6 +15109,11 @@ msgstr "Nie udało się tego skonfigurować, ponieważ nie zapisano wymaganego w
msgid "This deletes the MCP server entries and skill files listed below. The agent will lose access to your documents until you add it again."
msgstr "Operacja usuwa wpisy serwera MCP i pliki umiejętności wymienione poniżej. Agent straci dostęp do Twoich dokumentów, dopóki nie dodasz go ponownie."
+#: src/components/settings/AgentConnectionDialogs.tsx
+#: src/components/settings/AgentConnectionsSection.tsx
+msgid "This development build can't connect agents, so it won't change the agent setup of your installed OpenKnowledge app."
+msgstr "Ta wersja deweloperska nie może łączyć agentów, więc nie zmieni konfiguracji agentów w zainstalowanej aplikacji OpenKnowledge."
+
#. placeholder {0}: connection.label
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "This disconnects {0} from OpenKnowledge."
diff --git a/packages/app/src/locales/pseudo/messages.json b/packages/app/src/locales/pseudo/messages.json
index c760422c6..2ce57878f 100644
--- a/packages/app/src/locales/pseudo/messages.json
+++ b/packages/app/src/locales/pseudo/messages.json
@@ -987,6 +987,9 @@
"AT0e50": ["Ķēēƥ ƀōţĥ"],
"ATGYL1": ["Ēḿàĩĺ àďďŕēśś"],
"AUMPjj": ["Śƥàćē ţō Ĵũḿƥ, ďōŵń àŕŕōŵ ţō ďũćķ. Ţĥàţ ĩś ţĥē ŵĥōĺē ĝàḿē."],
+ "AUORpp": [
+ "Ţĥĩś ďēvēĺōƥḿēńţ ƀũĩĺď ćàń'ţ ćōńńēćţ àĝēńţś, śō ĩţ ŵōń'ţ ćĥàńĝē ţĥē àĝēńţ śēţũƥ ōƒ ŷōũŕ ĩńśţàĺĺēď ŌƥēńĶńōŵĺēďĝē àƥƥ."
+ ],
"AUV-TY": ["Ţĥĩńķĩńĝ"],
"AVW-K9": ["Ƒàĩĺēď ţō ĺōàď ōŕƥĥàń ƥàĝēś"],
"AWOSPo": ["Źōōḿ ĩń"],
diff --git a/packages/app/src/locales/pseudo/messages.po b/packages/app/src/locales/pseudo/messages.po
index 3c187ce52..b2a8fbe08 100644
--- a/packages/app/src/locales/pseudo/messages.po
+++ b/packages/app/src/locales/pseudo/messages.po
@@ -15105,6 +15105,11 @@ msgstr ""
msgid "This deletes the MCP server entries and skill files listed below. The agent will lose access to your documents until you add it again."
msgstr ""
+#: src/components/settings/AgentConnectionDialogs.tsx
+#: src/components/settings/AgentConnectionsSection.tsx
+msgid "This development build can't connect agents, so it won't change the agent setup of your installed OpenKnowledge app."
+msgstr ""
+
#. placeholder {0}: connection.label
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "This disconnects {0} from OpenKnowledge."
diff --git a/packages/app/src/locales/pt-BR/messages.json b/packages/app/src/locales/pt-BR/messages.json
index 741bd753b..431f1d48e 100644
--- a/packages/app/src/locales/pt-BR/messages.json
+++ b/packages/app/src/locales/pt-BR/messages.json
@@ -1140,6 +1140,9 @@
"AT0e50": ["Manter os dois"],
"ATGYL1": ["Endereço de e-mail"],
"AUMPjj": ["Espaço para pular, seta para baixo para agachar. É esse o jogo inteiro."],
+ "AUORpp": [
+ "Esta versão de desenvolvimento não pode conectar agentes, então não vai alterar a configuração de agentes do seu app OpenKnowledge instalado."
+ ],
"AUV-TY": ["Pensando"],
"AVW-K9": ["Falha ao carregar as páginas órfãs"],
"AWOSPo": ["Aproximar"],
diff --git a/packages/app/src/locales/pt-BR/messages.po b/packages/app/src/locales/pt-BR/messages.po
index 8d6eceb90..5f24cbfdd 100644
--- a/packages/app/src/locales/pt-BR/messages.po
+++ b/packages/app/src/locales/pt-BR/messages.po
@@ -15105,6 +15105,11 @@ msgstr "Não foi possível configurar porque a entrada do servidor MCP necessár
msgid "This deletes the MCP server entries and skill files listed below. The agent will lose access to your documents until you add it again."
msgstr "Isso exclui as entradas do servidor MCP e os arquivos de habilidades listados abaixo. O agente perderá o acesso aos seus documentos até que você o adicione novamente."
+#: src/components/settings/AgentConnectionDialogs.tsx
+#: src/components/settings/AgentConnectionsSection.tsx
+msgid "This development build can't connect agents, so it won't change the agent setup of your installed OpenKnowledge app."
+msgstr "Esta versão de desenvolvimento não pode conectar agentes, então não vai alterar a configuração de agentes do seu app OpenKnowledge instalado."
+
#. placeholder {0}: connection.label
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "This disconnects {0} from OpenKnowledge."
diff --git a/packages/app/src/locales/ur/messages.json b/packages/app/src/locales/ur/messages.json
index 72fccf93c..da8c0d7c9 100644
--- a/packages/app/src/locales/ur/messages.json
+++ b/packages/app/src/locales/ur/messages.json
@@ -999,6 +999,9 @@
"AT0e50": ["دونوں رکھیں"],
"ATGYL1": ["ای میل پتہ"],
"AUMPjj": ["چھلانگ کے لیے اسپیس، جھکنے کے لیے نیچے کا تیر۔ بس یہی پورا کھیل ہے۔"],
+ "AUORpp": [
+ "یہ ڈیولپمنٹ بلڈ ایجنٹس کو منسلک نہیں کر سکتا، اس لیے یہ آپ کی انسٹال شدہ OpenKnowledge ایپ کا ایجنٹ سیٹ اپ تبدیل نہیں کرے گا۔"
+ ],
"AUV-TY": ["سوچ رہا ہے"],
"AVW-K9": ["یتیم صفحات لوڈ نہیں ہو سکے"],
"AWOSPo": ["بڑا کریں"],
diff --git a/packages/app/src/locales/ur/messages.po b/packages/app/src/locales/ur/messages.po
index cb048aedf..aa0717649 100644
--- a/packages/app/src/locales/ur/messages.po
+++ b/packages/app/src/locales/ur/messages.po
@@ -15109,6 +15109,11 @@ msgstr "اسے سیٹ اپ نہیں کیا جا سکا کیونکہ اس کے ل
msgid "This deletes the MCP server entries and skill files listed below. The agent will lose access to your documents until you add it again."
msgstr "یہ ذیل میں درج MCP سرور اندراجات اور اسکل فائلیں حذف کر دیتا ہے۔ دوبارہ شامل کرنے تک ایجنٹ آپ کی دستاویزات تک رسائی کھو دے گا۔"
+#: src/components/settings/AgentConnectionDialogs.tsx
+#: src/components/settings/AgentConnectionsSection.tsx
+msgid "This development build can't connect agents, so it won't change the agent setup of your installed OpenKnowledge app."
+msgstr "یہ ڈیولپمنٹ بلڈ ایجنٹس کو منسلک نہیں کر سکتا، اس لیے یہ آپ کی انسٹال شدہ OpenKnowledge ایپ کا ایجنٹ سیٹ اپ تبدیل نہیں کرے گا۔"
+
#. placeholder {0}: connection.label
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "This disconnects {0} from OpenKnowledge."
diff --git a/packages/app/src/locales/zh-Hans/messages.json b/packages/app/src/locales/zh-Hans/messages.json
index 948becd67..fbed03bfe 100644
--- a/packages/app/src/locales/zh-Hans/messages.json
+++ b/packages/app/src/locales/zh-Hans/messages.json
@@ -867,6 +867,7 @@
"AT0e50": ["两个都保留"],
"ATGYL1": ["邮箱地址"],
"AUMPjj": ["空格跳跃,下方向键下蹲。整个游戏就这么简单。"],
+ "AUORpp": ["此开发版本无法连接智能体,因此不会更改你已安装的 OpenKnowledge 应用的智能体设置。"],
"AUV-TY": ["思考中"],
"AVW-K9": ["加载孤立页面失败"],
"AWOSPo": ["放大"],
diff --git a/packages/app/src/locales/zh-Hans/messages.po b/packages/app/src/locales/zh-Hans/messages.po
index c83854dad..7ebd2963e 100644
--- a/packages/app/src/locales/zh-Hans/messages.po
+++ b/packages/app/src/locales/zh-Hans/messages.po
@@ -15109,6 +15109,11 @@ msgstr "无法完成设置,因为它所需的 MCP 服务器条目未写入。"
msgid "This deletes the MCP server entries and skill files listed below. The agent will lose access to your documents until you add it again."
msgstr "这会删除下方列出的 MCP 服务器条目和技能文件。在重新添加之前,智能体将无法访问你的文档。"
+#: src/components/settings/AgentConnectionDialogs.tsx
+#: src/components/settings/AgentConnectionsSection.tsx
+msgid "This development build can't connect agents, so it won't change the agent setup of your installed OpenKnowledge app."
+msgstr "此开发版本无法连接智能体,因此不会更改你已安装的 OpenKnowledge 应用的智能体设置。"
+
#. placeholder {0}: connection.label
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "This disconnects {0} from OpenKnowledge."
diff --git a/packages/app/src/locales/zh-Hant/messages.json b/packages/app/src/locales/zh-Hant/messages.json
index 615361e91..d8c5b2560 100644
--- a/packages/app/src/locales/zh-Hant/messages.json
+++ b/packages/app/src/locales/zh-Hant/messages.json
@@ -867,6 +867,9 @@
"AT0e50": ["兩個都保留"],
"ATGYL1": ["電子郵件地址"],
"AUMPjj": ["空白鍵跳躍,下方向鍵蹲下。整個遊戲就這麼簡單。"],
+ "AUORpp": [
+ "此開發版本無法連接智慧代理,因此不會變更你已安裝的 OpenKnowledge 應用程式的智慧代理設定。"
+ ],
"AUV-TY": ["思考中"],
"AVW-K9": ["載入孤立頁面失敗"],
"AWOSPo": ["放大"],
diff --git a/packages/app/src/locales/zh-Hant/messages.po b/packages/app/src/locales/zh-Hant/messages.po
index 2bb1d3ecb..20b99bddc 100644
--- a/packages/app/src/locales/zh-Hant/messages.po
+++ b/packages/app/src/locales/zh-Hant/messages.po
@@ -15109,6 +15109,11 @@ msgstr "無法完成設定,因為它所需的 MCP 伺服器項目未寫入。"
msgid "This deletes the MCP server entries and skill files listed below. The agent will lose access to your documents until you add it again."
msgstr "這會刪除下方列出的 MCP 伺服器項目和技能檔案。在重新新增之前,智慧代理將無法存取你的文件。"
+#: src/components/settings/AgentConnectionDialogs.tsx
+#: src/components/settings/AgentConnectionsSection.tsx
+msgid "This development build can't connect agents, so it won't change the agent setup of your installed OpenKnowledge app."
+msgstr "此開發版本無法連接智慧代理,因此不會變更你已安裝的 OpenKnowledge 應用程式的智慧代理設定。"
+
#. placeholder {0}: connection.label
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "This disconnects {0} from OpenKnowledge."
diff --git a/packages/core/src/desktop-bridge.ts b/packages/core/src/desktop-bridge.ts
index 23900e8b1..5eb18461c 100644
--- a/packages/core/src/desktop-bridge.ts
+++ b/packages/core/src/desktop-bridge.ts
@@ -468,6 +468,7 @@ export type OkAgentIntegrationsApplyResult =
readonly ok: false;
readonly error: string;
readonly unavailable?: boolean;
+ readonly devBuild?: boolean;
readonly report: ApplyReport;
readonly snapshot: HostSnapshot;
};
diff --git a/packages/desktop/src/main/agent-registry-apply.test.ts b/packages/desktop/src/main/agent-registry-apply.test.ts
index e28e9429a..8e708c931 100644
--- a/packages/desktop/src/main/agent-registry-apply.test.ts
+++ b/packages/desktop/src/main/agent-registry-apply.test.ts
@@ -786,6 +786,7 @@ function delegateFor(
surfaces: AgentRegistryWriterSurfaces,
opts: {
available?: boolean;
+ devBuild?: boolean;
projectDir?: string | null;
states?: Record<string, SurfaceState>;
snapshot?: () => Promise<HostSnapshot>;
@@ -793,6 +794,7 @@ function delegateFor(
) {
const delegate = createAgentIntegrationsApplyDelegate({
available: opts.available ?? true,
+ devBuild: opts.devBuild,
surfaces,
resolveProjectDir: () => (opts.projectDir === undefined ? PROJECT : opts.projectDir),
snapshot: opts.snapshot ?? (async () => snapshotWith(opts.states ?? {})),
@@ -834,6 +836,17 @@ describe('the batch arm of the AI-tools channel', () => {
const result = await apply({ intents: [want(CLAUDE_PROJECT_MCP)] });
expect(result).toMatchObject({ ok: false, unavailable: true });
+ expect(result).not.toHaveProperty('devBuild');
+ expect(surfaces.calls.projectWrites).toEqual([]);
+ });
+
+ test('an unavailable dev build says it is a dev build', async () => {
+ const surfaces = makeSurfaces();
+ const apply = delegateFor(surfaces, { available: false, devBuild: true });
+
+ const result = await apply({ intents: [want(CLAUDE_PROJECT_MCP)] });
+
+ expect(result).toMatchObject({ ok: false, unavailable: true, devBuild: true });
expect(surfaces.calls.projectWrites).toEqual([]);
});
diff --git a/packages/desktop/src/main/agent-registry-apply.ts b/packages/desktop/src/main/agent-registry-apply.ts
index ab10c5a8d..821e6b765 100644
--- a/packages/desktop/src/main/agent-registry-apply.ts
+++ b/packages/desktop/src/main/agent-registry-apply.ts
@@ -336,6 +336,7 @@ const DEFAULT_LOGGER: AgentIntegrationsLogger = {
export interface AgentIntegrationsApplyDelegateOpts {
available: boolean;
+ devBuild?: boolean;
surfaces: AgentRegistryWriterSurfaces;
resolveProjectDir(event: IpcMainInvokeEvent): string | null;
snapshot(projectDir: string | null): Promise<HostSnapshot>;
@@ -356,7 +357,13 @@ const EMPTY_SNAPSHOT: HostSnapshot = {
export function createAgentIntegrationsApplyDelegate(
opts: AgentIntegrationsApplyDelegateOpts,
): AgentIntegrationsApplyDelegate {
- const { available, surfaces, resolveProjectDir, logger = DEFAULT_LOGGER } = opts;
+ const {
+ available,
+ devBuild = false,
+ surfaces,
+ resolveProjectDir,
+ logger = DEFAULT_LOGGER,
+ } = opts;
async function safeSnapshot(projectDir: string | null): Promise<HostSnapshot> {
try {
@@ -391,6 +398,7 @@ export function createAgentIntegrationsApplyDelegate(
ok: false,
error: 'Managing AI tool connections is unavailable in this build.',
unavailable: true,
+ ...(devBuild ? { devBuild: true } : {}),
report: EMPTY_REPORT,
snapshot,
};
diff --git a/packages/desktop/src/main/index.ts b/packages/desktop/src/main/index.ts
index 012d69779..c5f61ea67 100644
--- a/packages/desktop/src/main/index.ts
+++ b/packages/desktop/src/main/index.ts
@@ -289,7 +289,7 @@ import { createBootBudgetDirSizeProbe } from './fs-walk-budget.ts';
import { ensureGitAvailable } from './git-preflight-handler.ts';
import { readCanonicalGitHubRemoteUrl } from './git-remote.ts';
import { failedOpenHolder, promptHolderStop } from './holder-stop-prompt.ts';
-import { classifyInstallShape } from './install-shape.ts';
+import { agentConnectionsAvailability, isSupportedInstallShape } from './install-shape.ts';
import {
combineInstanceLabels,
formatInstanceAppName,
@@ -2580,8 +2580,7 @@ async function runApplicationMenuRefresh(): Promise<void> {
}
function supportedPackagedInstall(): boolean {
- const kind = classifyInstallShape(process.platform, app.getPath('exe'), process.env).kind;
- return kind !== 'appimage' && kind !== 'unsupported';
+ return isSupportedInstallShape(process.platform, app.getPath('exe'), process.env);
}
function desktopSelfUninstallAvailable(): boolean {
@@ -5611,12 +5610,12 @@ function projectDirForSender(event: IpcMainInvokeEvent): string | null {
function registerIntegrationsSettingsIpc(): void {
const integrationsLogger = getLogger('integrations-settings');
- const available =
- process.env.OK_RECLAIM_DISABLE !== '1' &&
- (app.isPackaged || process.env.OK_M6B_FORCE === '1') &&
- !['appimage', 'unsupported'].includes(
- classifyInstallShape(process.platform, app.getPath('exe'), process.env).kind,
- );
+ const { available, devBuild } = agentConnectionsAvailability(
+ app.isPackaged,
+ process.platform,
+ app.getPath('exe'),
+ process.env,
+ );
const applyLogger = getLogger('agent-integrations-apply');
registerIntegrationsSettings({
home: osHomedir(),
@@ -5624,6 +5623,7 @@ function registerIntegrationsSettingsIpc(): void {
ipcMain,
applyBatch: createAgentIntegrationsApplyDelegate({
available,
+ devBuild,
surfaces: { global: globalMcpWriterSurface(), project: projectWriterSurface() },
resolveProjectDir: projectDirForSender,
snapshot: (projectDir) => {
@@ -5761,10 +5761,12 @@ function registerIntegrationsSettingsIpc(): void {
function registerProjectIntegrationsSettingsIpc(): void {
const projectLogger = getLogger('project-integrations-settings');
- const available =
- process.env.OK_RECLAIM_DISABLE !== '1' &&
- (app.isPackaged || process.env.OK_M6B_FORCE === '1') &&
- supportedPackagedInstall();
+ const { available } = agentConnectionsAvailability(
+ app.isPackaged,
+ process.platform,
+ app.getPath('exe'),
+ process.env,
+ );
const tildifyHomePath = (path: string): string => {
const home = osHomedir();
return path.startsWith(`${home}/`) ? `~${path.slice(home.length)}` : path;
diff --git a/packages/desktop/src/main/install-shape.test.ts b/packages/desktop/src/main/install-shape.test.ts
index 479bef233..8fee868d4 100644
--- a/packages/desktop/src/main/install-shape.test.ts
+++ b/packages/desktop/src/main/install-shape.test.ts
@@ -1,6 +1,6 @@
import { describe, expect, test } from 'vitest';
import { wrapperPathInBundle } from './bundle-paths.ts';
-import { classifyInstallShape } from './install-shape.ts';
+import { agentConnectionsAvailability, classifyInstallShape } from './install-shape.ts';
describe('classifyInstallShape', () => {
test('darwin bundle → mac-bundle with Contents/Resources wrapper', () => {
@@ -81,3 +81,55 @@ describe('wrapperPathInBundle per-platform layouts', () => {
);
});
});
+
+describe('agentConnectionsAvailability', () => {
+ const devExe = '/repo/node_modules/electron/dist/Electron.app/Contents/MacOS/Electron';
+ const packagedExe = '/Applications/OpenKnowledge.app/Contents/MacOS/OpenKnowledge';
+
+ test.each([
+ ['plain unpackaged build', false, 'darwin', devExe, {}, { available: false, devBuild: true }],
+ [
+ 'unpackaged build forced open',
+ false,
+ 'darwin',
+ devExe,
+ { OK_M6B_FORCE: '1' },
+ { available: true, devBuild: false },
+ ],
+ [
+ 'unpackaged build locked by OK_RECLAIM_DISABLE',
+ false,
+ 'darwin',
+ devExe,
+ { OK_RECLAIM_DISABLE: '1' },
+ { available: false, devBuild: false },
+ ],
+ [
+ 'unpackaged build forced open but locked by OK_RECLAIM_DISABLE',
+ false,
+ 'darwin',
+ devExe,
+ { OK_M6B_FORCE: '1', OK_RECLAIM_DISABLE: '1' },
+ { available: false, devBuild: false },
+ ],
+ [
+ 'unpackaged build forced open but locked by install shape',
+ false,
+ 'linux',
+ '/tmp/.mount_ok/openknowledge',
+ { OK_M6B_FORCE: '1', APPIMAGE: '/home/u/OK.AppImage' },
+ { available: false, devBuild: false },
+ ],
+ ['packaged build', true, 'darwin', packagedExe, {}, { available: true, devBuild: false }],
+ [
+ 'packaged build in an unsupported shape',
+ true,
+ 'darwin',
+ '/usr/local/bin/OpenKnowledge',
+ {},
+ { available: false, devBuild: false },
+ ],
+ ] as const)('%s', (_label, isPackaged, platform, exe, env, expected) => {
+ expect(agentConnectionsAvailability(isPackaged, platform, exe, env)).toEqual(expected);
+ });
+});
diff --git a/packages/desktop/src/main/install-shape.ts b/packages/desktop/src/main/install-shape.ts
index 5e53cda19..04ba32cac 100644
--- a/packages/desktop/src/main/install-shape.ts
+++ b/packages/desktop/src/main/install-shape.ts
@@ -39,3 +39,23 @@ export function classifyInstallShape(
}
return { kind: 'unsupported' };
}
+
+export function isSupportedInstallShape(
+ platform: string,
+ executablePath: string,
+ env: Record<string, string | undefined>,
+): boolean {
+ const { kind } = classifyInstallShape(platform, executablePath, env);
+ return kind !== 'appimage' && kind !== 'unsupported';
+}
+
+export function agentConnectionsAvailability(
+ isPackaged: boolean,
+ platform: string,
+ executablePath: string,
+ env: Record<string, string | undefined>,
+): { available: boolean; devBuild: boolean } {
+ if (env.OK_RECLAIM_DISABLE === '1') return { available: false, devBuild: false };
+ if (!isPackaged && env.OK_M6B_FORCE !== '1') return { available: false, devBuild: true };
+ return { available: isSupportedInstallShape(platform, executablePath, env), devBuild: false };
+}
diff --git a/packages/desktop/src/shared/ipc-channels.ts b/packages/desktop/src/shared/ipc-channels.ts
index 6e88360c4..492e04b82 100644
--- a/packages/desktop/src/shared/ipc-channels.ts
+++ b/packages/desktop/src/shared/ipc-channels.ts
@@ -364,6 +364,7 @@ export type AgentIntegrationsApplyResult =
readonly ok: false;
readonly error: string;
readonly unavailable?: boolean;
+ readonly devBuild?: boolean;
readonly report: ApplyReport;
readonly snapshot: HostSnapshot;
};