@jossuealcala/madre 0.4.1 → 0.5.0

package/src/runtime-detection.mjs

@@ -38,6 +38,55 @@ const definitions = [
   },
 ];
 
+const OFFICIAL_DESTINATIONS = {
+  codex: { label: 'OpenAI', hosts: ['api.openai.com'], variable: 'OPENAI_BASE_URL' },
+  claude: { label: 'Anthropic', hosts: ['api.anthropic.com'], variable: 'ANTHROPIC_BASE_URL' },
+};
+
+const enabled = (value) => /^(1|true|yes)$/i.test(String(value ?? '').trim());
+
+function customRoutesAllowed(agentId, env) {
+  const raw = String(env.PULSE_ALLOW_CUSTOM_AGENT_ENDPOINTS ?? '').trim().toLowerCase();
+  if (/^(1|true|all)$/.test(raw)) return true;
+  return raw.split(',').map((item) => item.trim()).includes(agentId);
+}
+
+function routeHost(value) {
+  try { return new URL(value).hostname.toLowerCase(); } catch { return null; }
+}
+
+// A CLI owns its network connection, but MADRE owns the document handed to that CLI. Name the
+// actual destination without ever returning a credential, path or query string. Unknown base URLs
+// are held at the door until the human explicitly trusts that agent's endpoint.
+export function agentRouteFromEnvironment(agentId, env = process.env) {
+  if (agentId === 'claude' && enabled(env.CLAUDE_CODE_USE_BEDROCK)) {
+    return { kind: 'provider', destination: 'Amazon Bedrock', source: 'CLAUDE_CODE_USE_BEDROCK', host: null, custom: false, allowed: true };
+  }
+  if (agentId === 'claude' && enabled(env.CLAUDE_CODE_USE_VERTEX)) {
+    return { kind: 'provider', destination: 'Google Vertex AI', source: 'CLAUDE_CODE_USE_VERTEX', host: null, custom: false, allowed: true };
+  }
+  if (agentId === 'claude' && enabled(env.CLAUDE_CODE_USE_FOUNDRY)) {
+    return { kind: 'provider', destination: 'Microsoft Foundry', source: 'CLAUDE_CODE_USE_FOUNDRY', host: null, custom: false, allowed: true };
+  }
+
+  const official = OFFICIAL_DESTINATIONS[agentId];
+  if (!official) return null;
+  const raw = String(env[official.variable] ?? '').trim();
+  if (!raw) return { kind: 'official', destination: official.label, source: null, host: null, custom: false, allowed: true };
+  const host = routeHost(raw);
+  const isOfficial = Boolean(host && official.hosts.some((candidate) => host === candidate || host.endsWith(`.${candidate}`)));
+  if (isOfficial) return { kind: 'official', destination: official.label, source: official.variable, host, custom: false, allowed: true };
+  const allowed = customRoutesAllowed(agentId, env);
+  return {
+    kind: 'custom',
+    destination: host ? `custom endpoint · ${host}` : 'custom endpoint',
+    source: official.variable,
+    host,
+    custom: true,
+    allowed,
+  };
+}
+
 async function executable(path) {
   try {
     await access(path, constants.X_OK);
@@ -99,6 +148,7 @@ export async function detectAgents({ env = process.env } = {}) {
       adapter: definition.adapter ?? null,
       path,
       version: path ? await readVersion(path, definition.versionArgs) : null,
+      route: agentRouteFromEnvironment(definition.id, env),
     };
   }));
 }

package/src/server.mjs

@@ -47,6 +47,9 @@ import { applyKey, keyPlanFor } from './credentials.mjs';
 import { loadConfig as readConfig, updateConfig } from './config.mjs';
 import { Privacy, normalizeTerms, privacySettings } from './privacy.mjs';
 import { checkForUpdate, detectInstall, updateCommand, releaseUrl, applyCommand } from './updates.mjs';
+
+// Where a person reads the module contract, in the language the room is speaking.
+const SDK_PAGE = { es: 'https://madre.run/sdk/', en: 'https://madre.run/en/sdk/' };
 import { moduleUpdate } from './modules/updates.mjs';
 import { adoptStrays, chatIndex, chatLedger, createChat, deleteChat, isChatId, listChats, openChat as openChatIndex, projectFloor, renameChat, touchChat, MAIN_CHAT } from './chats.mjs';
 import { spawn } from 'node:child_process';
@@ -193,7 +196,7 @@ export async function createPulseServer({
   const install = detectInstall({ projectRoot: canonicalProjectRoot });
   async function versionView({ force = false } = {}) {
     const check = await checkForUpdate({ name: PACKAGE.name, current: PACKAGE.version, cacheFile: join(root, 'updates.json'), fetchImpl: reportFetch, enabled: updatesEnabled(), force });
-    return { project: canonicalProjectRoot, ...check, name: PACKAGE.name, install, command: updateCommand(install, PACKAGE.name, check.latest ?? 'latest'), release: check.latest ? releaseUrl(PACKAGE.repository, check.latest) : null, envWins: process.env.PULSE_UPDATE_CHECK !== undefined };
+    return { project: canonicalProjectRoot, ...check, name: PACKAGE.name, install, command: updateCommand(install, PACKAGE.name, check.latest ?? 'latest'), release: check.latest ? releaseUrl(PACKAGE.repository, check.latest, roomLanguage()) : null, envWins: process.env.PULSE_UPDATE_CHECK !== undefined };
   }
   // Keeping the day's cache warm. MODULES is served from what is already on disk, so the looking
   // happens after the screen is answered, never in front of it: at most once an hour per room,
@@ -250,7 +253,7 @@ export async function createPulseServer({
     else if (!fifth.ready && index >= 0) { agents.splice(index, 1); changed = true; }
     if (room) {
       room.setInvoker(MADRE_ADAPTER, fifth.ready ? madreInvoker({ memory, ollama: () => ({ ...ollama, chatModel: ollama.madreModel ?? ollama.chatModel }), fetchImpl: reportFetch }) : null);
-      if (changed) await room.record('agents.updated', { agents: agents.map((agent) => ({ id: agent.id, label: agent.label, detected: agent.detected, ready: agent.ready, version: agent.version, local: Boolean(agent.local) })), removed: fifth.ready ? [] : [MADRE_AGENT_ID], reason: fifth.ready ? `@madre is in the room · ${fifth.version}` : '@madre left the room: Ollama has no chat model running' });
+      if (changed) await room.record('agents.updated', { agents: agents.map((agent) => ({ id: agent.id, label: agent.label, detected: agent.detected, ready: agent.ready, version: agent.version, local: Boolean(agent.local), route: agent.route ?? null })), removed: fifth.ready ? [] : [MADRE_AGENT_ID], reason: fifth.ready ? `@madre is in the room · ${fifth.version}` : '@madre left the room: Ollama has no chat model running' });
       // That a local model is running is not the same as it being of use on this project, and
       // the second thing is the one a person needs told. Said once per model, in the room, with
       // the one button that settles it — the crew line above fires only when the crew CHANGES,
@@ -465,7 +468,7 @@ export async function createPulseServer({
       const index = agents.findIndex((item) => item.id === next.id);
       if (index === -1) { agents.push(next); changed = true; continue; }
       const before = agents[index];
-      if (before.detected !== next.detected || before.ready !== next.ready || before.version !== next.version || before.path !== next.path) {
+      if (before.detected !== next.detected || before.ready !== next.ready || before.version !== next.version || before.path !== next.path || JSON.stringify(before.route ?? null) !== JSON.stringify(next.route ?? null)) {
         agents[index] = { ...before, ...next };
         changed = true;
       }
@@ -473,7 +476,7 @@ export async function createPulseServer({
     await refreshSessions();
     if (changed && announce) {
       await room.record('agents.updated', {
-        agents: agents.map((agent) => ({ id: agent.id, label: agent.label, detected: agent.detected, ready: agent.ready, version: agent.version, local: Boolean(agent.local) })),
+        agents: agents.map((agent) => ({ id: agent.id, label: agent.label, detected: agent.detected, ready: agent.ready, version: agent.version, local: Boolean(agent.local), route: agent.route ?? null })),
         removed: [],
         reason: 'the room looked again for the agents on this computer',
       });
@@ -846,7 +849,7 @@ export async function createPulseServer({
         response.writeHead(200, { 'content-type': 'text/html; charset=utf-8' });
         return response.end(html);
       }
-      if (request.method === 'GET' && ['/app.js', '/brands.js', '/troubleshooting.js', '/inquiry.js', '/i18n.js', '/es.js', '/resay.js'].includes(url.pathname)) {
+      if (request.method === 'GET' && ['/app.js', '/brands.js', '/troubleshooting.js', '/inquiry.js', '/i18n.js', '/es.js', '/resay.js', '/syntax.js'].includes(url.pathname)) {
         const js = await readFile(join(publicDirectory, url.pathname.slice(1)));
         response.writeHead(200, { 'content-type': 'text/javascript; charset=utf-8' });
         return response.end(js);
@@ -1474,7 +1477,7 @@ export async function createPulseServer({
       if (request.method === 'GET' && url.pathname === '/api/extensions') {
         const extensions = await describeModules(await moduleContext());
         void warmModuleUpdates(extensions);
-        return sendJson(response, 200, { installing, extensions, failures: loadFailures, folders: moduleFolders({ stateRoot: root, projectRoot: canonicalProjectRoot }), sdk: 'https://github.com/jossuealcacao-exe/madre/blob/main/docs/SDK.md' });
+        return sendJson(response, 200, { installing, extensions, failures: loadFailures, folders: moduleFolders({ stateRoot: root, projectRoot: canonicalProjectRoot }), sdk: SDK_PAGE[roomLanguage()] ?? SDK_PAGE.es });
       }
       // The human installs a module file an agent wrote (or they did): checked first, then copied into the chosen folder.
       if (request.method === 'POST' && url.pathname === '/api/extensions/install-file') {

package/src/updates.mjs

@@ -51,7 +51,15 @@ export function applyCommand({ install, name, version, port, projectRoot }) {
   }
 }
 
-export function releaseUrl(repository, version) {
+// Where a person reads what a version brought. The product's own house, in the language the room
+// is speaking — a release page on a code host is written for people who already work there, and
+// whoever pressed this button only wanted to know what changed. The repository stays the fallback
+// for a build with no house to point at.
+export const CHANGES_PAGE = { es: 'https://madre.run/cambios/', en: 'https://madre.run/en/changelog/' };
+
+export function releaseUrl(repository, version, language = 'es') {
+  const page = CHANGES_PAGE[language] ?? CHANGES_PAGE.es;
+  if (page) return version ? `${page}#v${version}` : page;
   const url = String(repository?.url ?? repository ?? '').replace(/^git\+/, '').replace(/\.git$/, '');
   return url ? `${url}/releases/tag/v${version}` : null;
 }