docdex 0.2.47 → 0.2.49

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.2.49
+- Generate installer-managed MCP URLs with `127.0.0.1` so client configs match the daemon bind default.
+- Update packaged MCP examples and add regression coverage for the postinstall URL helpers.
+
+## 0.2.48
+- Exclude paid or expensive mcoda agents from automatic local delegation target selection.
+- Document the zero-cost local delegation rule in the packaged agent guidance.
+
 ## 0.2.47
 - Bump release metadata to 0.2.47.
 

package/README.md

@@ -141,7 +141,7 @@ If you need to configure your client manually:
 {
   "mcpServers": {
     "docdex": {
-      "url": "http://localhost:28491/v1/mcp/sse"
+      "url": "http://127.0.0.1:28491/v1/mcp/sse"
     }
   }
 }
@@ -155,7 +155,7 @@ If you need to configure your client manually:
   "mcpServers": {
     "docdex": {
       "type": "http",
-      "url": "http://localhost:28491/v1/mcp"
+      "url": "http://127.0.0.1:28491/v1/mcp"
     }
   }
 }
@@ -166,7 +166,7 @@ If you need to configure your client manually:
 
 ```toml
 [mcp_servers]
-docdex = { url = "http://localhost:28491/v1/mcp" }
+docdex = { url = "http://127.0.0.1:28491/v1/mcp" }
 
 ```
 

package/assets/agents.md

@@ -1,4 +1,4 @@
----- START OF DOCDEX INFO V0.2.47 ----
+---- START OF DOCDEX INFO V0.2.49 ----
 Docdex URL: http://127.0.0.1:28491
 Use this base URL for Docdex HTTP endpoints.
 Health check endpoint: `GET /healthz` (not `/v1/health`).
@@ -109,6 +109,7 @@ For mcoda agents, also consider:
 - `max_complexity`: do not assign tasks above this ceiling.
 - `rating`: prefer higher-rated agents for reliability.
 - `cost_per_million`: USD per 1M tokens; prefer lower cost when ratings/complexity match.
+- Automatic local target selection must exclude mcoda agents that are paid (`cost_per_million > 0`) or otherwise matched by `docs/expensive_models.json`, unless the user explicitly overrides the target.
 - `usage`: best-fit role (for example `code_writer` or `code_reviewer`); use this for quick matching.
 - `reasoning_rating`: reasoning score out of 10; prefer higher for complex reasoning tasks.
 - `health_status`: only use agents marked `healthy` (treat `-` as unknown).
@@ -388,7 +389,7 @@ Delegation is mandatory for eligible tasks. If you are expensive and delegation
 - Enforces the product's cost-control policy; skipping delegation is a regression.
 
 1. Determine if you are expensive: load `docs/expensive_models.json` and match your `agent_id`, `agent_slug`, `model`, or adapter type. If you match, continue; if not and you are clearly local/cheap, skip delegation. If unsure, default to expensive.
-2. Check config: Only delegate when `[llm.delegation].enabled` is true or `auto_enable` is true with an eligible local model/agent (and `task_type` is allowed). If uncertain, attempt delegation and handle the error.
+2. Check config: Only delegate when `[llm.delegation].enabled` is true or `auto_enable` is true with an eligible local model/agent (and `task_type` is allowed). For automatic mcoda selection, eligible means healthy and not paid/expensive unless the user explicitly overrides the target. If uncertain, attempt delegation and handle the error.
 3. Choose task type: Use one of `GENERATE_TESTS`, `WRITE_DOCSTRING`, `SCAFFOLD_BOILERPLATE`, `REFACTOR_SIMPLE`, `FORMAT_CODE`.
 4. Call the tool: `docdex_local_completion` with `task_type`, `instruction`, and minimal `context` (smallest necessary snippet).
 5. Validate output: If the local output is invalid or empty, fall back to the primary agent or handle with the paid model.

package/lib/postinstall_setup.js

@@ -75,11 +75,11 @@ function daemonLockPaths() {
 }
 
 function configUrlForPort(port) {
-  return `http://localhost:${port}/sse`;
+  return `http://${DEFAULT_HOST}:${port}/sse`;
 }
 
 function configStreamableUrlForPort(port) {
-  return `http://localhost:${port}/v1/mcp`;
+  return `http://${DEFAULT_HOST}:${port}/v1/mcp`;
 }
 
 function isPortAvailable(port, host) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docdex",
-  "version": "0.2.47",
+  "version": "0.2.49",
   "mcpName": "io.github.bekirdag/docdex",
   "description": "Local-first documentation and code indexer with HTTP/MCP search, AST, and agent memory.",
   "bin": {