@danieltmn/tamnora 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -5,6 +5,53 @@ Todos los cambios relevantes de este proyecto se documentan en este archivo.
 El formato sigue [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/)
 y el proyecto usa [Versionado Semantico](https://semver.org/lang/es/).
 
+## [0.2.0] - 2026-10-02
+
+### Agregado
+
+- Consola: eliminar sesiones (menu por sesion) y proyectos (borra las sesiones
+  de esa carpeta, nunca los archivos). `GET/DELETE /api/projects` y
+  `deleteSessionsByCwd`/`listProjects` en el Store.
+- Atajo `Ctrl+.` para alternar **Plan / Build** en la consola y la TUI (el modo
+  `agent` pasa a mostrarse como "Build"); en la TUI tambien `/modo`.
+- Apartado **ajustes** en la consola: alta/baja/edicion de **servidores MCP**
+  (se combinan con `mcp[]` de tamnora.json y se recargan al guardar) y de
+  **skills** (`<casa>/skills/<slug>/SKILL.md`), con habilitar/deshabilitar. Las
+  skills habilitadas se inyectan al system prompt.
+- Tools de agente para el chat: `list_mcp`, `install_mcp`, `remove_mcp`,
+  `list_skills` e `install_skill` (contenido o URL). Instalar/eliminar piden
+  aprobacion (permiso `ask`); en modo plan no se exponen.
+- **Preview** de la app en desarrollo y **procs**: deteccion de comandos de dev
+  (`package.json`, composer/artisan, PHP), arranque/parada de procesos con lista
+  blanca (`processes.allow`) y su log. Preview local (`127.0.0.1:<puerto>`) o
+  remoto con un **tunel** aparte (`POST /api/preview/tunnel`).
+- **Telegram**: bot por long polling (`telegram.token`/`allowedChatIds` o
+  `TAMNORA_TELEGRAM_TOKEN`) que mapea cada chat a una sesion y reenvia al agente
+  con streaming; comandos `/new`, `/status`, `/model`, `/provider`, `/mode`,
+  `/stop`, `/help`.
+- `startTunnel`/`parseTunnelmoleUrls` movidos al core (los usa el server y el CLI).
+
+### Arreglado
+
+- La consola en Windows fuerza UTF-8 (`chcp 65001`) al arrancar, para que no se
+  pierdan acentos ni la ñ. Nuevo `document.md` con la referencia completa.
+- Los proveedores custom ya se resuelven bien en la CLI, la TUI y la evaluacion:
+  antes `runTurn`/`judge`/`runDataset` no pasaban `customProviders`, el adapter
+  caia al de OpenRouter e ignoraba el `baseUrl` (un provider propio terminaba
+  pegandole a `openrouter.ai`).
+- Los fallos de red al llamar a un proveedor muestran
+  `No se pudo conectar con <host>...` en vez del crudo `fetch failed` (el error
+  conserva el `code` para seguir siendo reintentable).
+
+### Pendiente
+
+- Publicar el fix de proveedores custom como patch (`npm run release -- patch`)
+  para que `npm i -g @danieltmn/tamnora` lo incluya; la 0.1.0 publicada todavia
+  tiene el bug.
+- Confirmar el proveedor Xiaomi (`mimo-v2.6-flash`): en la prueba respondio
+  `429 Too Many Requests` (cuota/rate limit del endpoint), no del harness.
+- Cerrar la revision del sitio en `website/` (contenido ya alineado al harness).
+
 ## [0.1.0] - 2026-10-01
 
 ### Agregado

package/harness/packages/cli/src/cli.js

@@ -14,6 +14,7 @@ import { updateCommand } from './commands/update.js';
 import { autostartCommand } from './commands/autostart.js';
 import { doctorCommand } from './commands/doctor.js';
 import { tuiCommand } from './commands/tui.js';
+import { ensureUtf8Console } from './lib/util.js';
 import { color } from './ui/color.js';
 
 const COMMANDS = {
@@ -43,6 +44,7 @@ function readVersion() {
 }
 
 export async function runCli(argv) {
+  ensureUtf8Console();
   const [command, ...rest] = argv;
 
   if (command === '-h' || command === '--help' || command === 'help') {

package/harness/packages/cli/src/commands/eval.js

@@ -62,6 +62,7 @@ export async function evalCommand(argv) {
   const providerId = resolved.providerId;
   const baseUrl = resolved.baseUrl;
   const apiKey = resolved.apiKey;
+  const customProviders = resolved.customProviders;
   const models = (values.model?.length ? values.model : [resolved.model]).filter(Boolean);
   if (!models.length) {
     console.error(color.red('Falta el modelo (usá --model, Ajustes o "model" en tamnora.json).'));
@@ -74,6 +75,7 @@ export async function evalCommand(argv) {
     model: values['judge-model'] || config.judgeModel,
     baseUrl,
     apiKey,
+    customProviders,
   });
 
   const enabledTools = values['no-tools']
@@ -104,6 +106,7 @@ export async function evalCommand(argv) {
     providerId,
     baseUrl,
     apiKey,
+    customProviders,
     systemPrompt,
     rootDir: cwd,
     trials,

package/harness/packages/cli/src/commands/repl.js

@@ -34,6 +34,7 @@ export async function replCommand(argv) {
   let model = resolved.model;
   const baseUrl = resolved.baseUrl;
   const apiKey = resolved.apiKey;
+  const customProviders = resolved.customProviders;
   if (!model) {
     console.error(color.red('Falta el modelo (usá --model, Ajustes o "model" en tamnora.json).'));
     store.close();
@@ -140,6 +141,7 @@ export async function replCommand(argv) {
         model,
         baseUrl,
         apiKey,
+        customProviders,
         systemPrompt,
         history,
         input: text,

package/harness/packages/cli/src/commands/run.js

@@ -36,7 +36,7 @@ export async function runCommand(argv) {
   const config = await loadConfig(cwd);
   const instructions = await loadInstructions(cwd, config.instructions);
   const store = new Store(databasePath(cwd));
-  const { providerId, model, baseUrl, apiKey } = resolveCliProvider(store, config, {
+  const { providerId, model, baseUrl, apiKey, customProviders } = resolveCliProvider(store, config, {
     provider: values.provider,
     model: values.model,
   });
@@ -101,6 +101,7 @@ export async function runCommand(argv) {
       model,
       baseUrl,
       apiKey,
+      customProviders,
       systemPrompt: buildSystemPrompt(instructions, values.system),
       history,
       input: prompt,

package/harness/packages/cli/src/commands/tui.js

@@ -28,7 +28,7 @@ export async function tuiCommand(argv) {
   const cwd = values.dir ? path.resolve(values.dir) : process.cwd();
   const config = await loadConfig(cwd);
   const store = new Store(databasePath(cwd));
-  const { providerId, model, baseUrl, apiKey } = resolveCliProvider(store, config, {
+  const { providerId, model, baseUrl, apiKey, customProviders } = resolveCliProvider(store, config, {
     provider: values.provider,
     model: values.model,
   });
@@ -63,11 +63,14 @@ export async function tuiCommand(argv) {
         : undefined;
 
   const mode = resolveMode(values.mode || store.getSetting('activeMode') || 'agent');
-  const enabled = mode.tools
-    ? baseEnabled
-      ? baseEnabled.filter((tool) => mode.tools.includes(tool))
-      : mode.tools
-    : baseEnabled;
+  const enabledFor = (m) =>
+    m.tools ? (baseEnabled ? baseEnabled.filter((tool) => m.tools.includes(tool)) : m.tools) : baseEnabled;
+  const promptFor = (m) =>
+    buildSystemPrompt(instructions, [values.system, m.systemPrompt].filter(Boolean).join('\n\n'));
+  const modeContext = (id) => {
+    const m = resolveMode(id);
+    return { label: m.label, enabled: enabledFor(m), systemPrompt: promptFor(m) };
+  };
 
   const sessionId = store.createSession({ title: 'Consola', provider: providerId, model, cwd });
 
@@ -76,11 +79,15 @@ export async function tuiCommand(argv) {
     model,
     baseUrl,
     apiKey,
-    systemPrompt: buildSystemPrompt(instructions, [values.system, mode.systemPrompt].filter(Boolean).join('\n\n')),
+    customProviders,
+    modeId: mode.id,
+    modeContext,
+    onModeChange: (id) => store.setSetting('activeMode', id),
+    systemPrompt: promptFor(mode),
     maxRounds: num(values['max-steps'], config.maxRounds),
     toolOptions: {
       root: cwd,
-      enabled,
+      enabled: enabledFor(mode),
       permissions: config.permissions,
       mcp,
       yes: Boolean(values.yes),
@@ -95,9 +102,9 @@ function printHelp() {
 
 Consola full-screen (estilo opencode/codex). Atajos:
   enter      enviar        ↑ / ↓     historial
-  ← →        mover cursor  home/end  inicio / fin
-  pgup/pgdn  scroll        ctrl+l    limpiar
-  ctrl+c     cancelar / salir        /salir  /limpiar
+   ← → mover cursor  home/end  inicio / fin
+   pgup/pgdn  scroll        ctrl+l    limpiar
+   ctrl+.     alternar Plan / Build   /modo  /salir  /limpiar
 
 Opciones:
   --provider <id>   Proveedor (por defecto: el activo)

package/harness/packages/cli/src/lib/runtime.js

@@ -22,6 +22,7 @@ export function resolveCliProvider(store, config, { provider, model } = {}) {
     model: activeModel,
     baseUrl: settings.baseUrl,
     apiKey: resolveApiKey(settings.apiKey, process.env),
+    customProviders,
     settings,
   };
 }
@@ -46,6 +47,7 @@ export async function runTurn({
   model,
   baseUrl,
   apiKey,
+  customProviders = [],
   systemPrompt,
   history = [],
   input,
@@ -57,7 +59,7 @@ export async function runTurn({
   toolContext = {},
   onEvent,
 }) {
-  const { provider, config } = resolveProviderRuntime({ providerId, apiKey, baseUrl });
+  const { provider, config } = resolveProviderRuntime({ providerId, apiKey, baseUrl, customProviders });
 
   const messages = [
     { role: 'system', content: systemPrompt },

package/harness/packages/cli/src/lib/tunnel.js

@@ -1,113 +1,2 @@
-import { spawn } from 'node:child_process';
-
-/**
- * Tuneles publicos. v1 soporta tunnelmole (gratis, sin cuenta; URL aleatoria)
- * via `npx --yes tunnelmole <puerto>`.
- */
-
-function killTree(child) {
-  if (!child || child.killed) return;
-  const pid = child.pid;
-  try {
-    if (process.platform === 'win32' && pid) {
-      spawn('taskkill', ['/PID', String(pid), '/T', '/F'], { windowsHide: true });
-    } else {
-      if (pid) {
-        try {
-          process.kill(-pid, 'SIGTERM');
-        } catch {
-          /* sin grupo */
-        }
-      }
-      try {
-        child.kill('SIGTERM');
-      } catch {
-        /* ya murio */
-      }
-    }
-  } catch {
-    /* ya murio */
-  }
-}
-
-export function parseTunnelmoleUrls(text) {
-  const urls = [...new Set(String(text).match(/https?:\/\/[a-z0-9-]+\.tunnelmole\.net/gi) || [])];
-  return {
-    https: urls.find((u) => u.startsWith('https')) || '',
-    http: urls.find((u) => u.startsWith('http:')) || '',
-  };
-}
-
-function spawnTunnel(bin, args, opts = {}) {
-  const log = opts.log || (() => {});
-  const parse = opts.parse || (() => ({ https: '', http: '' }));
-  const timeoutMs = opts.timeoutMs || 90000;
-  const label = opts.label || bin;
-  return new Promise((resolve, reject) => {
-    let child;
-    try {
-      child = spawn(bin, args, {
-        stdio: ['ignore', 'pipe', 'pipe'],
-        windowsHide: true,
-        shell: process.platform === 'win32',
-        detached: process.platform !== 'win32',
-      });
-    } catch (err) {
-      reject(new Error(`no se pudo iniciar ${label}: ${err.message}`));
-      return;
-    }
-    let buf = '';
-    let settled = false;
-    const timer = setTimeout(() => {
-      if (settled) return;
-      settled = true;
-      killTree(child);
-      reject(new Error(`${label} no devolvio URL (${Math.round(timeoutMs / 1000)} s).`));
-    }, timeoutMs);
-    const feed = (data) => {
-      buf += String(data);
-      if (opts.verbose) process.stdout.write(String(data));
-      const urls = parse(buf);
-      const url = urls.https || urls.http;
-      if (url) {
-        if (settled) return;
-        settled = true;
-        clearTimeout(timer);
-        log(`${label}: ${url} -> localhost:${opts.port}`);
-        resolve({ url, provider: opts.provider, pid: child.pid, stop: () => killTree(child) });
-      }
-    };
-    child.stdout.on('data', feed);
-    child.stderr.on('data', feed);
-    child.on('error', (err) => {
-      if (settled) return;
-      settled = true;
-      clearTimeout(timer);
-      reject(new Error(`${label}: ${err.message}`));
-    });
-    child.on('exit', (code) => {
-      if (settled) return;
-      settled = true;
-      clearTimeout(timer);
-      reject(new Error(`${label} termino (codigo ${code})${buf ? `: ${buf.slice(0, 200).trim()}` : ''}`));
-    });
-  });
-}
-
-export function startTunnelmole(port, opts = {}) {
-  return spawnTunnel('npx', ['--yes', 'tunnelmole', String(port)], {
-    ...opts,
-    port,
-    provider: 'tunnelmole',
-    label: 'tunnelmole',
-    parse: parseTunnelmoleUrls,
-  });
-}
-
-/** Devuelve { url, provider, pid, stop }. provider 'none' no abre nada. */
-export async function startTunnel(port, provider = 'tunnelmole', opts = {}) {
-  const p = String(provider || 'tunnelmole').toLowerCase();
-  if (p === 'none' || p === 'off' || p === '') return { url: '', provider: 'none', pid: 0, stop: () => {} };
-  if (p === 'tunnelmole' || p === 'tmole') return startTunnelmole(port, opts);
-  throw new Error(`proveedor de tunel no soportado: ${provider}`);
-}
+// Movido al core para que tambien lo use el server; se mantiene el import.
+export * from '../../../core/src/tunnel.js';

package/harness/packages/cli/src/lib/util.js

@@ -22,3 +22,5 @@ export function num(value, fallback) {
   const n = Number(value);
   return Number.isFinite(n) ? n : fallback;
 }
+
+export { ensureUtf8Console } from '../../../core/src/index.js';

package/harness/packages/cli/src/tui/app.js

@@ -12,12 +12,24 @@ export function runTui({
   model,
   baseUrl,
   apiKey,
+  customProviders = [],
+  modeId = 'agent',
+  modeContext,
+  onModeChange,
   systemPrompt,
   maxRounds,
   toolOptions,
   store,
   sessionId,
 }) {
+  let mode = modeId;
+  const readMode = (id) =>
+    modeContext
+      ? modeContext(id)
+      : { systemPrompt, enabled: toolOptions.enabled, label: id };
+  let activeMode = readMode(mode);
+  let modePrompt = activeMode.systemPrompt ?? systemPrompt;
+  let modeEnabled = activeMode.enabled;
   const state = {
     header: { provider: providerId, model, cwd: toolOptions.root },
     messages: [],
@@ -59,7 +71,23 @@ export function runTui({
       draw();
     });
 
-  const { definitions, execute } = createTools({ ...toolOptions, onAsk });
+  const buildTools = () => createTools({ ...toolOptions, enabled: modeEnabled, onAsk });
+  let toolset = buildTools();
+
+  function setMode(id) {
+    mode = id;
+    activeMode = readMode(id);
+    modePrompt = activeMode.systemPrompt ?? systemPrompt;
+    modeEnabled = activeMode.enabled;
+    toolset = buildTools();
+    onModeChange?.(id);
+  }
+
+  function toggleMode() {
+    setMode(mode === 'plan' ? 'agent' : 'plan');
+    addMessage('assistant', `Modo ${activeMode.label ?? mode}${mode === 'plan' ? ' (solo lectura)' : ''}.`);
+    draw();
+  }
 
   function draw() {
     if (closed) return;
@@ -104,6 +132,15 @@ export function runTui({
     const text = state.input.trim();
     if (!text) return;
     if (text === '/salir' || text === '/exit' || text === '/quit') return shutdown(0);
+    if (text === '/modo' || text === '/mode') return toggleMode();
+    const modeArg = text.match(/^\/(?:modo|mode)\s+(plan|agent|build)$/i);
+    if (modeArg) {
+      const id = modeArg[1].toLowerCase() === 'build' ? 'agent' : modeArg[1].toLowerCase();
+      setMode(id);
+      addMessage('assistant', `Modo ${activeMode.label ?? id}.`);
+      draw();
+      return;
+    }
     if (text === '/limpiar' || text === '/clear') {
       state.input = '';
       state.messages = [];
@@ -128,13 +165,14 @@ export function runTui({
         model,
         baseUrl,
         apiKey,
-        systemPrompt,
+        customProviders,
+        systemPrompt: modePrompt,
         history: conv,
         input: text,
         maxRounds,
         signal: controller.signal,
-        tools: definitions,
-        execute,
+        tools: toolset.definitions,
+        execute: toolset.execute,
         onEvent(event) {
           if (event.type === 'text') {
             sawText = true;
@@ -243,6 +281,9 @@ export function runTui({
       case 'clear':
         state.messages = [];
         break;
+      case 'toggle-mode':
+        toggleMode();
+        return;
       case 'enter':
         submit();
         return;

package/harness/packages/cli/src/tui/keys.js

@@ -18,6 +18,9 @@ const ESCAPE_ACTIONS = {
   '\x1b[3~': 'delete',
   '\x1b[5~': 'pageup',
   '\x1b[6~': 'pagedown',
+  // Ctrl+. (Kitty keyboard protocol / xterm modifyOtherKeys)
+  '\x1b[46;5u': 'toggle-mode',
+  '\x1b[27;5;46~': 'toggle-mode',
 };
 
 const FINAL_BYTE = /[@-~]/;

package/harness/packages/cli/test/tui.test.js

@@ -30,6 +30,11 @@ test('parseKeys handles editing and navigation keys', () => {
   assert.deepEqual(parseKeys('\x05'), [{ type: 'end' }]);
 });
 
+test('parseKeys maps Ctrl+. (Plan/Build) from kitty and xterm sequences', () => {
+  assert.deepEqual(parseKeys('\x1b[46;5u'), [{ type: 'toggle-mode' }]);
+  assert.deepEqual(parseKeys('\x1b[27;5;46~'), [{ type: 'toggle-mode' }]);
+});
+
 test('parseKeys reads bracketed paste as a single action', () => {
   assert.deepEqual(parseKeys('\x1b[200~hola mundo\x1b[201~'), [{ type: 'paste', value: 'hola mundo' }]);
   assert.deepEqual(parseKeys('\x1b[200~a\nb\x1b[201~'), [{ type: 'paste', value: 'a\nb' }]);

package/harness/packages/core/src/agent/modes.js

@@ -4,7 +4,7 @@
 export const MODES = {
   agent: {
     id: 'agent',
-    label: 'Agent',
+    label: 'Build',
     description: 'Lee, escribe y ejecuta comandos en el workspace.',
     tools: null,
     systemPrompt: '',

package/harness/packages/core/src/config/index.js

@@ -12,6 +12,9 @@ export const DEFAULT_CONFIG = {
   permissions: {},
   mcp: [],
   server: { host: '127.0.0.1', port: 4517 },
+  processes: { enabled: true, allow: [] },
+  preview: { provider: 'tunnelmole' },
+  telegram: { token: '', allowedChatIds: [] },
 };
 
 /** Directory (relative to the project) where harness state lived historically. */

package/harness/packages/core/src/console.js

@@ -0,0 +1,18 @@
+import { spawnSync } from 'node:child_process';
+
+let utf8Ready = false;
+
+/**
+ * En Windows la consola suele arrancar en cp850/cp437 y los acentos y la ñ se
+ * pierden. Cambia el code page a UTF-8 (65001) una sola vez, solo en TTY.
+ */
+export function ensureUtf8Console() {
+  if (utf8Ready || process.platform !== 'win32') return;
+  utf8Ready = true;
+  if (!process.stdout.isTTY) return;
+  try {
+    spawnSync('chcp.com', ['65001'], { stdio: 'ignore', windowsHide: true });
+  } catch {
+    /* no pasa nada si no esta disponible */
+  }
+}

package/harness/packages/core/src/eval/judge.js

@@ -6,11 +6,11 @@ import { extractJson } from './scorers.js';
  * The judge model receives the criteria and the candidate output and must
  * reply with JSON: { "passed": boolean, "reason": string }.
  *
- * @param {{providerId?:string, model?:string, baseUrl?:string, apiKey?:string}} opts
+ * @param {{providerId?:string, model?:string, baseUrl?:string, apiKey?:string, customProviders?:object[]}} opts
  */
-export function createJudge({ providerId, model, baseUrl, apiKey } = {}) {
+export function createJudge({ providerId, model, baseUrl, apiKey, customProviders = [] } = {}) {
   if (!model) return null;
-  const { provider, config } = resolveProviderRuntime({ providerId, apiKey, baseUrl });
+  const { provider, config } = resolveProviderRuntime({ providerId, apiKey, baseUrl, customProviders });
 
   return async ({ criteria, output, input }) => {
     const prompt =

package/harness/packages/core/src/eval/runner.js

@@ -53,6 +53,7 @@ async function pool(items, limit, worker) {
  * @param {string} opts.providerId
  * @param {string} [opts.baseUrl]
  * @param {string} [opts.apiKey]
+ * @param {object[]} [opts.customProviders]
  * @param {string} [opts.systemPrompt]
  * @param {string} [opts.rootDir] - base dir for task fixtures
  * @param {number} [opts.trials]
@@ -72,6 +73,7 @@ export async function runDataset({
   providerId,
   baseUrl,
   apiKey,
+  customProviders = [],
   systemPrompt,
   rootDir = process.cwd(),
   trials = 1,
@@ -107,6 +109,7 @@ export async function runDataset({
           model,
           baseUrl: task.baseUrl ?? baseUrl,
           apiKey: task.apiKey ?? apiKey,
+          customProviders: task.customProviders ?? customProviders,
           systemPrompt: task.systemPrompt || systemPrompt,
           tools: tools.definitions.length ? tools.definitions : undefined,
         },

package/harness/packages/core/src/index.js

@@ -1,4 +1,5 @@
 export { getEnv, envValue } from './env.js';
+export { ensureUtf8Console } from './console.js';
 export { MAX_TOOL_ROUNDS, runAgent, parseToolArguments } from './agent/runAgent.js';
 export { estimateTokens, trimContext } from './agent/context.js';
 export { diffLines } from './tools/diff.js';
@@ -70,3 +71,6 @@ export { summarize } from './eval/report.js';
 export { runScorers, validateSchema, extractJson, SCORERS } from './eval/scorers.js';
 export { createJudge } from './eval/judge.js';
 export { createTaskWorkspace, normalizeExpect } from './eval/task.js';
+export { parseSkillMarkdown, loadSkills, mergeSkills, buildSkillsPrompt } from './skills/index.js';
+export { parseTunnelmoleUrls, startTunnelmole, startTunnel } from './tunnel.js';
+export { detectProcs, packageManager, DEFAULT_PROCESS_ALLOW } from './procs/detect.js';

package/harness/packages/core/src/procs/detect.js

@@ -0,0 +1,69 @@
+// Deteccion de como correr el proyecto en desarrollo (dev server) a partir de
+// package.json, composer/artisan y entrypoints PHP.
+
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+
+export const DEFAULT_PROCESS_ALLOW = [
+  'npm',
+  'node',
+  'npx',
+  'pnpm',
+  'yarn',
+  'bun',
+  'bunx',
+  'php',
+  'python',
+  'python3',
+  'composer',
+];
+
+const SCRIPT_ORDER = ['dev', 'start', 'serve', 'preview'];
+
+function readJson(file) {
+  try {
+    return JSON.parse(readFileSync(file, 'utf8'));
+  } catch {
+    return null;
+  }
+}
+
+/** Package manager por `packageManager` o por lockfile (default npm). */
+export function packageManager(dir) {
+  const pkg = readJson(path.join(dir, 'package.json'));
+  if (pkg?.packageManager) return String(pkg.packageManager).split('@')[0];
+  if (existsSync(path.join(dir, 'pnpm-lock.yaml'))) return 'pnpm';
+  if (existsSync(path.join(dir, 'yarn.lock'))) return 'yarn';
+  if (existsSync(path.join(dir, 'bun.lockb')) || existsSync(path.join(dir, 'bun.lock'))) return 'bun';
+  return 'npm';
+}
+
+/** Devuelve chips `{ label, command, args, cwd }` para arrancar el proyecto. */
+export function detectProcs(dir) {
+  const chips = [];
+  const pkg = readJson(path.join(dir, 'package.json'));
+  if (pkg?.scripts && typeof pkg.scripts === 'object') {
+    const pm = packageManager(dir);
+    const names = SCRIPT_ORDER.filter((name) => pkg.scripts[name]);
+    if (!names.length) {
+      const first = Object.keys(pkg.scripts)[0];
+      if (first) names.push(first);
+    }
+    for (const name of names) chips.push({ label: `${name} (${pm})`, command: pm, args: ['run', name], cwd: dir });
+  }
+
+  if (existsSync(path.join(dir, 'artisan'))) {
+    chips.push({ label: 'artisan serve', command: 'php', args: ['artisan', 'serve'], cwd: dir });
+  } else if (readJson(path.join(dir, 'composer.json'))?.scripts?.dev) {
+    chips.push({ label: 'composer dev', command: 'composer', args: ['run', 'dev'], cwd: dir });
+  }
+
+  for (const rel of ['public/index.php', 'backend/public/index.php', 'index.php']) {
+    if (!existsSync(path.join(dir, rel))) continue;
+    const docroot = path.dirname(rel) === '.' ? '.' : path.dirname(rel);
+    chips.push({ label: `php -S (${rel})`, command: 'php', args: ['-S', '127.0.0.1:8000', '-t', docroot], cwd: dir });
+    break;
+  }
+
+  return chips;
+}

package/harness/packages/core/src/providers/ollama.js

@@ -1,5 +1,5 @@
 import { readNDJSON } from './stream.js';
-import { joinUrl, providerError, sortModels } from './utils.js';
+import { joinUrl, providerError, providerFetch, sortModels } from './utils.js';
 
 const OLLAMA_BASE_URL = 'http://localhost:11434';
 
@@ -46,7 +46,7 @@ export const ollamaProvider = {
   requiresKey: false,
 
   async listModels({ baseUrl }) {
-    const res = await fetch(joinUrl(baseUrl, '/api/tags'));
+    const res = await providerFetch(joinUrl(baseUrl, '/api/tags'));
     if (!res.ok) throw new Error(`No se pudo conectar con Ollama (HTTP ${res.status})`);
     const data = await res.json();
     return sortModels((data.models ?? []).map(toOllamaModel).filter((m) => m.id));
@@ -56,7 +56,7 @@ export const ollamaProvider = {
     const body = { model, messages: toOllamaMessages(messages), stream: true };
     if (tools?.length) body.tools = tools;
 
-    const res = await fetch(joinUrl(baseUrl, '/api/chat'), {
+    const res = await providerFetch(joinUrl(baseUrl, '/api/chat'), {
       method: 'POST',
       signal,
       headers: { 'Content-Type': 'application/json' },

package/harness/packages/core/src/providers/openaiCompatible.js

@@ -1,5 +1,5 @@
 import { readOpenAISSE } from './stream.js';
-import { joinUrl, authHeaders, providerError, normalizeModel, sortModels } from './utils.js';
+import { joinUrl, authHeaders, providerError, providerFetch, normalizeModel, sortModels } from './utils.js';
 
 /**
  * Generic adapter for any OpenAI-compatible chat completions API
@@ -12,7 +12,7 @@ export const openaiCompatibleProvider = {
   requiresKey: true,
 
   async listModels({ baseUrl, apiKey, headers }) {
-    const res = await fetch(joinUrl(baseUrl, '/models'), {
+    const res = await providerFetch(joinUrl(baseUrl, '/models'), {
       headers: authHeaders({ apiKey, headers }),
     });
     if (!res.ok) throw new Error(`No se pudo listar modelos (HTTP ${res.status})`);
@@ -38,7 +38,7 @@ export const openaiCompatibleProvider = {
 };
 
 export async function requestStream({ url, headers, providerLabel, model, body, signal, onEvent }) {
-  const res = await fetch(url, {
+  const res = await providerFetch(url, {
     method: 'POST',
     signal,
     headers: { ...headers, 'Content-Type': 'application/json' },