@danieltmn/tamnora 0.1.0

package/harness/scripts/example-dataset.jsonl

@@ -0,0 +1,4 @@
+{"id":"math","input":"¿Cuánto es 17 * 23? Respondé solo el número.","expect":{"equals":"391"}}
+{"id":"write-file","input":"Creá el archivo saludo.txt con el texto \"hola\".","expect":[{"toolCalled":"write"},{"fileContains":{"path":"saludo.txt","value":"hola"}}]}
+{"id":"json","input":"Devolvé JSON con las claves \"ok\" (true) y \"n\" (3).","expect":{"jsonSchema":{"type":"object","required":["ok","n"],"properties":{"ok":{"type":"boolean"},"n":{"type":"integer"}}}}}
+{"id":"regex","input":"Escribí una oración que contenga un número.","expect":{"regex":"\\d"}}

package/harness/scripts/mcp-echo-server.mjs

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+// Minimal, zero-dependency MCP server over stdio, for testing the harness.
+//
+// Tools: `echo` (returns the text) and `add` (sums two numbers).
+// Resources: `echo://welcome`. Prompts: `saludo` (arg `nombre`).
+// Only JSON-RPC messages go to stdout; logs go to stderr.
+
+import readline from 'node:readline';
+
+const SERVER_INFO = { name: 'echo', version: '1.0.0' };
+
+const RESOURCES = [{ uri: 'echo://welcome', name: 'Bienvenida', mimeType: 'text/plain' }];
+const RESOURCE_TEXT = { 'echo://welcome': 'Hola desde el MCP echo.' };
+
+const PROMPTS = [
+  {
+    name: 'saludo',
+    description: 'Genera un saludo para una persona.',
+    arguments: [{ name: 'nombre', description: 'Nombre', required: true }],
+  },
+];
+
+const TOOLS = [
+  {
+    name: 'echo',
+    description: 'Devuelve el texto recibido, con el prefijo "echo: ".',
+    inputSchema: {
+      type: 'object',
+      properties: { text: { type: 'string', description: 'Texto a repetir' } },
+      required: ['text'],
+    },
+  },
+  {
+    name: 'add',
+    description: 'Suma dos números y devuelve el resultado.',
+    inputSchema: {
+      type: 'object',
+      properties: { a: { type: 'number' }, b: { type: 'number' } },
+      required: ['a', 'b'],
+    },
+  },
+];
+
+function text(value) {
+  return { content: [{ type: 'text', text: String(value) }] };
+}
+
+function callTool(name, args = {}) {
+  if (name === 'echo') return text(`echo: ${args.text ?? ''}`);
+  if (name === 'add') return text(Number(args.a) + Number(args.b));
+  return { content: [{ type: 'text', text: `tool desconocida: ${name}` }], isError: true };
+}
+
+function handle(message) {
+  const { id, method, params } = message;
+  if (method === 'initialize') {
+    return {
+      jsonrpc: '2.0',
+      id,
+      result: {
+        protocolVersion: '2025-06-18',
+        capabilities: { tools: {}, resources: {}, prompts: {} },
+        serverInfo: SERVER_INFO,
+      },
+    };
+  }
+  if (method === 'notifications/initialized' || method === 'notifications/cancelled') return null;
+  if (method === 'ping') return { jsonrpc: '2.0', id, result: {} };
+  if (method === 'tools/list') return { jsonrpc: '2.0', id, result: { tools: TOOLS } };
+  if (method === 'tools/call') return { jsonrpc: '2.0', id, result: callTool(params?.name, params?.arguments) };
+  if (method === 'resources/list') return { jsonrpc: '2.0', id, result: { resources: RESOURCES } };
+  if (method === 'resources/read') {
+    const uri = params?.uri;
+    if (!(uri in RESOURCE_TEXT)) {
+      return { jsonrpc: '2.0', id, error: { code: -32602, message: `recurso desconocido: ${uri}` } };
+    }
+    return { jsonrpc: '2.0', id, result: { contents: [{ uri, mimeType: 'text/plain', text: RESOURCE_TEXT[uri] }] } };
+  }
+  if (method === 'prompts/list') return { jsonrpc: '2.0', id, result: { prompts: PROMPTS } };
+  if (method === 'prompts/get') {
+    const nombre = params?.arguments?.nombre ?? '';
+    return {
+      jsonrpc: '2.0',
+      id,
+      result: {
+        description: 'Saludo',
+        messages: [{ role: 'user', content: { type: 'text', text: `Hola ${nombre}!` } }],
+      },
+    };
+  }
+  if (id === undefined) return null;
+  return { jsonrpc: '2.0', id, error: { code: -32601, message: `método no soportado: ${method}` } };
+}
+
+const rl = readline.createInterface({ input: process.stdin });
+process.stderr.write('mcp-echo-server listo\n');
+rl.on('line', (line) => {
+  const trimmed = line.trim();
+  if (!trimmed) return;
+  let message;
+  try {
+    message = JSON.parse(trimmed);
+  } catch {
+    return;
+  }
+  const response = handle(message);
+  if (response) process.stdout.write(`${JSON.stringify(response)}\n`);
+});

package/harness/scripts/mock-provider.mjs

@@ -0,0 +1,134 @@
+#!/usr/bin/env node
+// Local mock provider for testing the Tamnora harness without network or keys.
+//
+// Speaks both OpenAI-compatible SSE (/v1/chat/completions) and Ollama NDJSON
+// (/api/chat). Behavior:
+//   - "crea <archivo> con <texto>"  → calls the `write` tool
+//   - anything else                 → echoes the prompt
+//
+// Usage:
+//   node scripts/mock-provider.mjs [--port 8790]
+
+import http from 'node:http';
+
+const args = process.argv.slice(2);
+const portArgIndex = args.indexOf('--port');
+const PORT = Number(portArgIndex >= 0 ? args[portArgIndex + 1] : process.env.MOCK_PORT ?? 8790);
+
+function lastUserText(messages = []) {
+  for (let i = messages.length - 1; i >= 0; i--) {
+    if (messages[i].role === 'user') {
+      const content = messages[i].content;
+      return typeof content === 'string' ? content : JSON.stringify(content);
+    }
+  }
+  return '';
+}
+
+function decide(messages, tools) {
+  const user = lastUserText(messages);
+  const hasToolResult = messages.some((m) => m.role === 'tool');
+  if (hasToolResult) return { content: 'Listo. Ejecuté la herramienta.' };
+
+  const echoMatch = user.match(/eco\s+(.+)/i);
+  const echoTool = tools?.find((t) => /^mcp__.*__echo$/.test(t.function?.name));
+  if (echoMatch && echoTool) {
+    return { content: '', toolCall: { name: echoTool.function.name, args: { text: echoMatch[1].trim() } } };
+  }
+
+  const match = user.match(/cre(?:a|á|ar)\s+(\S+)\s+con\s+(.+)/i);
+  const canWrite = tools?.some((t) => t.function?.name === 'write');
+  if (match && canWrite) {
+    return {
+      content: '',
+      toolCall: { name: 'write', args: { path: match[1], content: match[2].trim() } },
+    };
+  }
+  return { content: `Echo: ${user}` };
+}
+
+function sendSse(res, { content, toolCall }) {
+  res.setHeader('Content-Type', 'text/event-stream');
+  res.setHeader('Cache-Control', 'no-cache');
+  res.setHeader('Connection', 'keep-alive');
+  if (toolCall) {
+    res.write(
+      `data: ${JSON.stringify({
+        choices: [
+          {
+            delta: {
+              tool_calls: [
+                {
+                  index: 0,
+                  id: 'call_1',
+                  type: 'function',
+                  function: { name: toolCall.name, arguments: JSON.stringify(toolCall.args) },
+                },
+              ],
+            },
+          },
+        ],
+      })}\n\n`
+    );
+  } else {
+    res.write(`data: ${JSON.stringify({ choices: [{ delta: { content } }] })}\n\n`);
+  }
+  res.write('data: [DONE]\n\n');
+  res.end();
+}
+
+function sendOllama(res, { content, toolCall }) {
+  res.setHeader('Content-Type', 'application/x-ndjson');
+  if (toolCall) {
+    res.write(
+      `${JSON.stringify({
+        message: { content: '', tool_calls: [{ function: { name: toolCall.name, arguments: toolCall.args } }] },
+        done: false,
+      })}\n`
+    );
+  } else {
+    res.write(`${JSON.stringify({ message: { content }, done: false })}\n`);
+  }
+  res.write(`${JSON.stringify({ done: true })}\n`);
+  res.end();
+}
+
+const server = http.createServer((req, res) => {
+  if (req.method === 'GET' && req.url.endsWith('/models')) {
+    res.setHeader('Content-Type', 'application/json');
+    res.end(
+      JSON.stringify({ data: [{ id: 'mock-agent', name: 'Mock Agent', architecture: { modality: 'text' } }] })
+    );
+    return;
+  }
+  if (req.method === 'GET' && req.url.endsWith('/api/tags')) {
+    res.setHeader('Content-Type', 'application/json');
+    res.end(JSON.stringify({ models: [{ name: 'mock-agent', details: { family: 'mock' } }] }));
+    return;
+  }
+  if (req.method === 'POST' && (req.url.endsWith('/chat/completions') || req.url.endsWith('/api/chat'))) {
+    let body = '';
+    req.on('data', (c) => (body += c));
+    req.on('end', () => {
+      let parsed = {};
+      try {
+        parsed = JSON.parse(body);
+      } catch {
+        // ignore
+      }
+      const decision = decide(parsed.messages ?? [], parsed.tools ?? []);
+      if (req.url.endsWith('/api/chat')) sendOllama(res, decision);
+      else sendSse(res, decision);
+    });
+    return;
+  }
+  res.statusCode = 404;
+  res.setHeader('Content-Type', 'application/json');
+  res.end('{}');
+});
+
+server.listen(PORT, '127.0.0.1', () => {
+  console.log(`Mock provider escuchando en http://127.0.0.1:${PORT}`);
+  console.log(`  OpenAI-compatible base URL: http://127.0.0.1:${PORT}/v1`);
+  console.log(`  Ollama base URL:            http://127.0.0.1:${PORT}`);
+});

package/harness/tamnora.example.json

@@ -0,0 +1,18 @@
+{
+  "provider": "openrouter",
+  "model": "meta-llama/llama-3.3-8b-instruct:free",
+  "instructions": ["AGENTS.md"],
+  "maxRounds": 8,
+  "tools": [],
+  "permissions": {},
+  "mcp": [
+    {
+      "id": "echo",
+      "name": "Echo (demo stdio)",
+      "type": "stdio",
+      "command": "node",
+      "args": ["harness/scripts/mcp-echo-server.mjs"],
+      "enabled": true
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@danieltmn/tamnora",
+  "version": "0.1.0",
+  "description": "Harness local para IAs: agente CLI-first con TUI, consola web y evaluacion. Node puro, sin dependencias.",
+  "type": "module",
+  "packageManager": "pnpm@11.25.0",
+  "author": "tamnora",
+  "license": "MIT",
+  "homepage": "https://github.com/tamnora/tamnora-harness#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tamnora/tamnora-harness.git"
+  },
+  "bugs": {
+    "url": "https://github.com/tamnora/tamnora-harness/issues"
+  },
+  "keywords": [
+    "tamnora",
+    "harness",
+    "ai",
+    "agent",
+    "cli",
+    "tui",
+    "llm",
+    "mcp",
+    "opencode",
+    "ollama"
+  ],
+  "bin": {
+    "tamnora": "harness/packages/cli/bin/tamnora.mjs",
+    "tamnora-server": "harness/packages/server/bin/tamnora-server.mjs"
+  },
+  "engines": {
+    "node": ">=22.5"
+  },
+  "files": [
+    "bin",
+    "harness/packages",
+    "harness/scripts",
+    "harness/tamnora.example.json",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "SECURITY.md"
+  ],
+  "scripts": {
+    "tamnora": "node --disable-warning=ExperimentalWarning harness/packages/cli/bin/tamnora.mjs",
+    "serve": "node --disable-warning=ExperimentalWarning harness/packages/server/bin/tamnora-server.mjs",
+    "mock": "node harness/scripts/mock-provider.mjs",
+    "test": "node --disable-warning=ExperimentalWarning --test \"harness/packages/*/test/*.test.js\"",
+    "lint": "eslint .",
+    "release": "node scripts/release.mjs",
+    "release:dry": "node scripts/release.mjs --dry-run",
+    "prepublishOnly": "npm test"
+  },
+  "release": {
+    "npmOwner": "danieltmn",
+    "gitRemote": "tamnora/tamnora-harness",
+    "gitOwner": "tamnora",
+    "branch": "main"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.4",
+    "eslint": "^9.39.4",
+    "globals": "^17.4.0"
+  }
+}