open-agents-ai 0.187.235 → 0.187.236

package/dist/index.js

@@ -292355,11 +292355,11 @@ ${CONTENT_BG_SEQ}`);
               self2.cycleFocus();
               return;
             }
-            if (key?.ctrl && key?.shift && key?.name === "b") {
-              self2.armBlockSelection();
+            if (key?.ctrl && key?.shift && key?.name === "c") {
+              self2.copySelection();
               return;
             }
-            if (s2 === "\x1B[66;6u") {
+            if (key?.ctrl && key?.shift && key?.name === "b") {
               self2.armBlockSelection();
               return;
             }
@@ -292475,6 +292475,8 @@ ${CONTENT_BG_SEQ}`);
         di.on("shiftdown", () => self2.scrollContentDown(3));
         di.on("tab-empty", () => self2.cycleFocus());
         di.on("ctrl-backslash", () => self2.cycleFocus());
+        di.on("ctrl-shift-c", () => self2.copySelection());
+        di.on("ctrl-shift-b", () => self2.armBlockSelection());
         di.on("up", () => {
           if (self2._suggestions.length > 0) {
             self2.suggestUp();
@@ -315053,8 +315055,28 @@ var init_direct_input = __esm({
               return;
             }
             return;
-          case "u":
+          case "u": {
+            const parts = params.split(";");
+            const codepoint = parseInt(parts[0] ?? "0");
+            const modifiers = parseInt(parts[1] ?? "1");
+            const hasCtrl = modifiers - 1 & 4;
+            const hasShift = modifiers - 1 & 1;
+            if (hasCtrl && hasShift) {
+              if (codepoint === 67) {
+                this.emit("ctrl-shift-c");
+                return;
+              }
+              if (codepoint === 66) {
+                this.emit("ctrl-shift-b");
+                return;
+              }
+              if (codepoint === 86) {
+                this.emit("ctrl-shift-v");
+                return;
+              }
+            }
             return;
+          }
         }
       }
       /** Handle SS3 sequence: \x1BO {final} (some terminals use this for arrows/Home/End) */
@@ -323553,6 +323575,201 @@ function handleVersion(res) {
 function handleMetrics(res) {
   textResponse(res, 200, formatMetrics(), "text/plain; version=0.0.4; charset=utf-8");
 }
+function handleHelp(req2, res) {
+  const version4 = getVersion3();
+  const host = req2.headers.host ?? "localhost:11435";
+  const base3 = `http://${host}`;
+  const help = {
+    name: "Open Agents",
+    version: version4,
+    description: "AI coding agent powered entirely by open-weight models. OpenAI-compatible API with full agentic tool-calling, text selection, MCP integration, and multi-model orchestration. No API keys required for local use.",
+    quickstart: {
+      chat: `curl ${base3}/v1/chat/completions -d '{"model":"auto","messages":[{"role":"user","content":"Hello"}]}'`,
+      models: `curl ${base3}/v1/models`,
+      stream: `curl ${base3}/v1/chat/completions -d '{"model":"auto","stream":true,"messages":[{"role":"user","content":"List files in the project"}]}'`,
+      run_task: `curl -X POST ${base3}/v1/run -d '{"task":"Fix the failing tests","model":"auto"}'`
+    },
+    endpoints: {
+      discovery: {
+        "GET /help": "This guide — human and agent-friendly API reference",
+        "GET /docs": "Interactive Swagger UI (browser)",
+        "GET /openapi.json": "Full OpenAPI 3.0 specification (machine-readable)",
+        "GET /health": "Liveness probe",
+        "GET /health/ready": "Readiness probe (checks backend reachability)",
+        "GET /version": "Package version, Node.js version, platform",
+        "GET /metrics": "Prometheus-format metrics"
+      },
+      inference: {
+        "GET /v1/models": "List all available models (local + sponsored, with prefixes)",
+        "POST /v1/chat/completions": "OpenAI-compatible chat completion (supports streaming via stream:true)",
+        "POST /v1/embeddings": "Generate embeddings",
+        "POST /v1/generate": "Ollama-compatible text generation",
+        "GET /api/tags": "Ollama-compatible model listing",
+        "POST /api/chat": "Ollama-compatible chat",
+        "POST /api/embed": "Ollama-compatible embeddings"
+      },
+      agentic: {
+        "POST /v1/chat": "Stateful agentic chat — full tool access (file_read, shell, grep, etc.), SSE streaming",
+        "GET /v1/chat/sessions": "List active chat sessions",
+        "POST /v1/run": "Spawn autonomous task execution",
+        "GET /v1/runs": "List all runs",
+        "GET /v1/runs/:id": "Get run status and details",
+        "GET /v1/runs/:id/output": "Get run output/logs",
+        "DELETE /v1/runs/:id": "Cancel a running task"
+      },
+      tools_and_skills: {
+        "GET /v1/tools": "List available agentic tools",
+        "GET /v1/skills": "List available skills (slash commands)",
+        "GET /v1/skills/:name": "Get skill details and content",
+        "GET /v1/commands": "List slash commands",
+        "POST /v1/commands/:cmd": "Execute a slash command",
+        "GET /v1/agents": "List available agent types"
+      },
+      mcp: {
+        "GET /v1/mcps": "List connected MCP (Model Context Protocol) servers",
+        "GET /v1/mcps/:name": "Get MCP server details and available tools",
+        "POST /v1/mcps/:name/call": "Call a tool on an MCP server — body: {tool, args}"
+      },
+      memory: {
+        "GET /v1/memory": "Memory system summary",
+        "POST /v1/memory/search": "Search episodic memory",
+        "POST /v1/memory/write": "Write to memory store",
+        "GET /v1/memory/episodes": "List stored episodes",
+        "GET /v1/memory/failures": "List failure patterns"
+      },
+      workspace: {
+        "GET /v1/files": "List directory contents (query: ?path=src/)",
+        "POST /v1/files/read": "Read file content — body: {path}",
+        "GET /v1/system": "OS info, GPU detection, installed tools",
+        "GET /v1/context": "Current conversation context",
+        "POST /v1/context/compact": "Compact session history"
+      },
+      config: {
+        "GET /v1/config": "Current daemon configuration",
+        "PATCH /v1/config": "Update configuration (admin scope required)",
+        "GET /v1/config/model": "Current model",
+        "PUT /v1/config/model": "Set model — body: {model}",
+        "GET /v1/config/endpoint": "Current backend endpoint",
+        "PUT /v1/config/endpoint": "Set backend endpoint — body: {endpoint}"
+      },
+      monitoring: {
+        "GET /v1/events": "Server-Sent Events stream (task lifecycle, todo changes)",
+        "GET /v1/usage": "Token usage summary",
+        "GET /v1/audit": "Query audit log (query: ?since=, ?action=, ?limit=)",
+        "GET /v1/cost": "Cost tracking per endpoint"
+      },
+      voice_and_vision: {
+        "POST /v1/voice/tts": "Text-to-speech synthesis",
+        "POST /v1/voice/asr": "Automatic speech recognition",
+        "POST /v1/vision/describe": "Describe an image (vision pipeline)"
+      }
+    },
+    mcp_integration: {
+      description: "Open Agents can act as an MCP client — connect to external MCP servers and expose their tools through the /v1/mcps/* endpoints. Any AI agent or IDE that speaks the Model Context Protocol can discover and invoke these tools remotely.",
+      discovery: `curl ${base3}/v1/mcps`,
+      call_tool: `curl -X POST ${base3}/v1/mcps/YOUR_SERVER/call -d '{"tool":"tool_name","args":{"key":"value"}}'`
+    },
+    for_ai_agents: {
+      description: "If you are an AI agent or coding assistant consuming this API, here is how to get started:",
+      steps: [
+        `1. GET ${base3}/v1/models — discover available models`,
+        `2. POST ${base3}/v1/chat/completions — send messages (OpenAI-compatible format)`,
+        `3. GET ${base3}/v1/tools — see what agentic tools are available`,
+        `4. POST ${base3}/v1/chat — use the agentic chat endpoint for tool-calling tasks`,
+        `5. GET ${base3}/v1/mcps — discover connected MCP servers and their tools`,
+        `6. GET ${base3}/v1/skills — browse available skills for specialized tasks`
+      ],
+      tips: [
+        "Set stream:true in chat requests for real-time token streaming via SSE",
+        "Use model:'auto' to let the server pick the best available model",
+        "The /v1/chat endpoint supports full agentic tool-calling (file I/O, shell, grep, etc.)",
+        "Use /v1/events for real-time notifications of task progress and system events",
+        "Bearer tokens are optional for localhost access; required for remote/LAN access"
+      ]
+    },
+    authentication: {
+      local: "No authentication required for loopback (127.0.0.1) access",
+      remote: "Set OA_API_KEY or OA_API_KEYS env var; pass as Authorization: Bearer <key>",
+      scopes: {
+        read: "GET endpoints — model listing, file browsing, status queries",
+        run: "POST endpoints — task execution, chat, tool invocation",
+        admin: "Config writes, profile management, audit access"
+      }
+    },
+    links: {
+      docs: `${base3}/docs`,
+      openapi: `${base3}/openapi.json`,
+      health: `${base3}/health`,
+      web_ui: base3
+    }
+  };
+  const accept = req2.headers.accept ?? "";
+  if (accept.includes("text/plain") || accept.includes("text/markdown")) {
+    const md = renderHelpMarkdown(help);
+    textResponse(res, 200, md, "text/plain; charset=utf-8");
+  } else {
+    jsonResponse(res, 200, help);
+  }
+}
+function renderHelpMarkdown(help) {
+  const h = help;
+  const version4 = h.version;
+  const base3 = h.links?.web_ui ?? "http://localhost:11435";
+  const qs = h.quickstart;
+  const agents = h.for_ai_agents;
+  let out = `# Open Agents v${version4}
+
+`;
+  out += `${h.description}
+
+`;
+  out += `## Quick Start
+
+`;
+  for (const [label, cmd] of Object.entries(qs)) {
+    out += `  ${label}:
+    ${cmd}
+
+`;
+  }
+  out += `## Endpoints
+
+`;
+  const endpoints = h.endpoints;
+  for (const [category, routes] of Object.entries(endpoints)) {
+    out += `### ${category}
+`;
+    for (const [route, desc] of Object.entries(routes)) {
+      out += `  ${route.padEnd(36)} ${desc}
+`;
+    }
+    out += `
+`;
+  }
+  out += `## For AI Agents
+
+`;
+  for (const step of agents.steps) out += `  ${step}
+`;
+  out += `
+`;
+  for (const tip of agents.tips) out += `  - ${tip}
+`;
+  out += `
+`;
+  out += `## Links
+
+`;
+  out += `  Interactive docs:  ${base3}/docs
+`;
+  out += `  OpenAPI spec:      ${base3}/openapi.json
+`;
+  out += `  Web UI:            ${base3}
+`;
+  out += `  Health check:      ${base3}/health
+`;
+  return out;
+}
 async function handleV1Models(res, ollamaUrl) {
   try {
     const models = await fetchAggregatedModels();
@@ -325169,6 +325386,10 @@ async function handleRequest(req2, res, ollamaUrl, verbose) {
       handleMetrics(res);
       return;
     }
+    if (pathname === "/help" && method === "GET") {
+      handleHelp(req2, res);
+      return;
+    }
     if (pathname === "/openapi.json" && method === "GET") {
       jsonResponse(res, 200, getOpenApiSpec());
       return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "open-agents-ai",
-  "version": "0.187.235",
+  "version": "0.187.236",
   "description": "AI coding agent powered by open-source models (Ollama/vLLM) — interactive TUI with agentic tool-calling loop",
   "type": "module",
   "main": "./dist/index.js",