mcp-server-opencode 1.1.4 → 1.2.0

package/build/src/modules/shared/usage-limits.js

@@ -0,0 +1,296 @@
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+/** Page scraped for the OpenCode Go quota table. */
+const FETCH_URL = "https://opencode.ai/docs/es/go/";
+/** Same page, anchored at the section we read — shown as the citation. */
+export const USAGE_LIMITS_SOURCE_URL = "https://opencode.ai/docs/es/go/#límites-de-uso";
+const DEFAULT_TTL_MS = 24 * 60 * 60 * 1000;
+const FETCH_TIMEOUT_MS = 10_000;
+const CACHE_FILE_NAME = "usage-limits.json";
+/** Requests per 5h above which a model is treated as effectively cheap. */
+const HIGH_VOLUME_MIN = 3_000;
+/** Requests per 5h below which a model is treated as scarce. */
+const BALANCED_MIN = 500;
+/** Header cell that identifies the quota table (Spanish or English docs). */
+const QUOTA_HEADER = /peticiones por 5\s*horas|requests per 5\s*hours/i;
+/** Heading that opens the usage-limits section. */
+const SECTION_HEADING = /^(l[ií]mites de uso|usage limits)$/i;
+/** How many lines after the header may still be header cells. */
+const HEADER_SCAN_WINDOW = 8;
+const COUNT_PATTERN = /^\d{1,3}(?:,\d{3})*$|^\d+$/;
+const EMPTY_CELL_PATTERN = /^[-–—]$/;
+const SPEND_PATTERN = /\$\s?\d+(?:[.,]\d+)?/g;
+/**
+ * Resolve where the daily snapshot is persisted.
+ *
+ * Precedence: `OPENCODE_MCP_CACHE_DIR` > `XDG_CACHE_HOME` > `~/.cache`, always
+ * under an `opencode-mcp/` subdirectory. Read lazily so tests can redirect it.
+ */
+export function getCachePath() {
+    const override = process.env.OPENCODE_MCP_CACHE_DIR?.trim();
+    if (override)
+        return join(override, CACHE_FILE_NAME);
+    const xdg = process.env.XDG_CACHE_HOME?.trim();
+    const base = xdg ? xdg : join(homedir(), ".cache");
+    return join(base, "opencode-mcp", CACHE_FILE_NAME);
+}
+/** Snapshot lifetime in ms; `OPENCODE_MCP_LIMITS_TTL_MS` overrides the 24h default. */
+export function getCacheTtlMs() {
+    const raw = process.env.OPENCODE_MCP_LIMITS_TTL_MS?.trim();
+    if (!raw)
+        return DEFAULT_TTL_MS;
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed) || parsed < 0)
+        return DEFAULT_TTL_MS;
+    return parsed;
+}
+/**
+ * Return the OpenCode Go usage limits, fetching the docs at most once a day.
+ *
+ * A fresh cache entry short-circuits the network. On a fetch or parse failure
+ * a stale cache entry is still returned, so an offline start degrades to
+ * yesterday's numbers instead of no numbers at all. Returns `null` only when
+ * there is neither a usable cache nor a usable response.
+ */
+export async function getUsageLimits() {
+    const cached = readCache();
+    if (cached && !isStale(cached))
+        return cached;
+    const fetched = await fetchUsageLimits();
+    if (!fetched)
+        return cached;
+    writeCache(fetched);
+    return fetched;
+}
+function isStale(limits) {
+    const fetchedAt = Date.parse(limits.fetchedAt);
+    if (Number.isNaN(fetchedAt))
+        return true;
+    return Date.now() - fetchedAt >= getCacheTtlMs();
+}
+async function fetchUsageLimits() {
+    let html;
+    try {
+        const response = await fetch(FETCH_URL, {
+            signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+            headers: { accept: "text/html" },
+        });
+        if (!response.ok)
+            return null;
+        html = await response.text();
+    }
+    catch {
+        return null;
+    }
+    const parsed = parseUsageLimits(html);
+    if (!parsed)
+        return null;
+    return {
+        source: USAGE_LIMITS_SOURCE_URL,
+        fetchedAt: new Date().toISOString(),
+        ...parsed,
+    };
+}
+/**
+ * Pull the spend budget and the per-model request estimates out of the docs
+ * HTML. Returns `null` when the quota table is missing or unrecognisable, so a
+ * page redesign falls back to the cache instead of injecting garbage.
+ */
+export function parseUsageLimits(html) {
+    const lines = htmlToLines(html);
+    const headerIndex = lines.findIndex((line) => QUOTA_HEADER.test(line));
+    if (headerIndex === -1)
+        return null;
+    const models = parseQuotaRows(lines, headerIndex);
+    if (models.length === 0)
+        return null;
+    return { spendBudget: parseSpendBudget(lines, headerIndex), models };
+}
+/** Strip scripts, styles and tags, leaving one trimmed text node per line. */
+function htmlToLines(html) {
+    return html
+        .replace(/<script[\s\S]*?<\/script>/gi, " ")
+        .replace(/<style[\s\S]*?<\/style>/gi, " ")
+        .replace(/<[^>]+>/g, "\n")
+        .split("\n")
+        .map(decodeEntities)
+        .map((line) => line.replace(/\s+/g, " ").trim())
+        .filter((line) => line.length > 0);
+}
+const ENTITIES = {
+    amp: "&",
+    lt: "<",
+    gt: ">",
+    quot: '"',
+    apos: "'",
+    nbsp: " ",
+};
+function decodeEntities(text) {
+    return text.replace(/&(#x?[0-9a-f]+|[a-z]+);/gi, (match, entity) => {
+        const lowered = entity.toLowerCase();
+        if (lowered.startsWith("#x"))
+            return codePointToChar(Number.parseInt(entity.slice(2), 16));
+        if (lowered.startsWith("#"))
+            return codePointToChar(Number.parseInt(entity.slice(1), 10));
+        return ENTITIES[lowered] ?? match;
+    });
+}
+function codePointToChar(codePoint) {
+    try {
+        return String.fromCodePoint(codePoint);
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * Read the table as flat text: every row is a model name followed by three
+ * count cells, so a row is anything with three numeric-ish lines behind it.
+ */
+function parseQuotaRows(lines, headerIndex) {
+    let index = headerIndex + 1;
+    const scanLimit = Math.min(lines.length, headerIndex + 1 + HEADER_SCAN_WINDOW);
+    while (index < scanLimit && !isRowStart(lines, index))
+        index++;
+    const rows = [];
+    while (isRowStart(lines, index)) {
+        rows.push({
+            model: lines[index],
+            perFiveHours: toCount(lines[index + 1]),
+            perWeek: toCount(lines[index + 2]),
+            perMonth: toCount(lines[index + 3]),
+        });
+        index += 4;
+    }
+    return rows;
+}
+function isRowStart(lines, index) {
+    const name = lines[index];
+    if (name === undefined || isCountCell(name))
+        return false;
+    return (isCountCell(lines[index + 1]) && isCountCell(lines[index + 2]) && isCountCell(lines[index + 3]));
+}
+function isCountCell(cell) {
+    if (cell === undefined)
+        return false;
+    return COUNT_PATTERN.test(cell) || EMPTY_CELL_PATTERN.test(cell);
+}
+function toCount(cell) {
+    if (!COUNT_PATTERN.test(cell))
+        return null;
+    return Number(cell.replace(/,/g, ""));
+}
+/**
+ * The three dollar figures stated above the table, in doc order.
+ *
+ * Anchored on the LAST heading before the table: the page repeats the section
+ * title in its navigation, and the subscription price ($5 first month, $10/mo)
+ * sits between that nav copy and the real section.
+ */
+function parseSpendBudget(lines, headerIndex) {
+    let start = 0;
+    for (let index = headerIndex - 1; index >= 0; index--) {
+        if (SECTION_HEADING.test(lines[index])) {
+            start = index;
+            break;
+        }
+    }
+    const amounts = lines
+        .slice(start, headerIndex)
+        .join(" ")
+        .match(SPEND_PATTERN)
+        ?.map((amount) => amount.replace(/\s/g, ""));
+    return {
+        fiveHours: amounts?.[0] ?? null,
+        weekly: amounts?.[1] ?? null,
+        monthly: amounts?.[2] ?? null,
+    };
+}
+function readCache() {
+    try {
+        const parsed = JSON.parse(readFileSync(getCachePath(), "utf8"));
+        if (typeof parsed?.fetchedAt !== "string" || !Array.isArray(parsed?.models))
+            return null;
+        if (parsed.models.length === 0)
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+function writeCache(limits) {
+    const path = getCachePath();
+    try {
+        mkdirSync(join(path, ".."), { recursive: true });
+        writeFileSync(path, `${JSON.stringify(limits, null, 2)}\n`, "utf8");
+    }
+    catch {
+        // A read-only cache directory must not stop the server from starting; the
+        // only cost is re-fetching on the next boot.
+    }
+}
+const TIER_ORDER = ["high-volume", "balanced", "scarce", "unlisted"];
+// Keyed by the exact `tier` value that opencode_list_agents reports per model,
+// so the reading agent can match the JSON value to its guidance literally.
+const TIER_GUIDE = {
+    "high-volume": "3,000+ req/5h — default: exploration, mechanical edits, boilerplate, docs, tests, simple fixes",
+    balanced: "500-2,999 req/5h — standard features, non-trivial debugging, code review",
+    scarce: "under 500 req/5h — architecture, cross-cutting refactors, hard debugging; use only for the step that needs it",
+    unlisted: "no published estimate (quota is null) — treat as scarce until confirmed",
+};
+/** Bucket a model by its 5h request estimate. Thresholds live here only. */
+export function quotaTier(perFiveHours) {
+    if (perFiveHours === null)
+        return "unlisted";
+    if (perFiveHours >= HIGH_VOLUME_MIN)
+        return "high-volume";
+    if (perFiveHours >= BALANCED_MIN)
+        return "balanced";
+    return "scarce";
+}
+/**
+ * Index the snapshot by slugified display name so a live model id from an
+ * OpenCode server (`mimo-v2.5`) joins onto the docs row (`MiMo-V2.5`).
+ *
+ * Verified against a real server: all 22 `opencode-go` model ids match this
+ * way. Ids with no row (the free/preview models on the `opencode` provider)
+ * are simply absent, which callers report as "no published quota".
+ */
+export function quotaByModelId(limits) {
+    return new Map(limits.models.map((model) => [slugifyModelName(model.model), model]));
+}
+function slugifyModelName(name) {
+    return name.toLowerCase().replace(/\s+/g, "-");
+}
+/**
+ * Render the live half of the quota guidance: where the numbers came from and
+ * the shared dollar budget every model spends against.
+ *
+ * The per-model numbers deliberately stay OUT of the instructions —
+ * opencode_list_agents reports them per model, keyed by the real model id,
+ * which is the only form the agent can act on.
+ */
+export function formatUsageLimits(limits) {
+    return [
+        `OpenCode Go usage limits — source: ${limits.source} (checked ${limits.fetchedAt.slice(0, 10)})`,
+        renderBudget(limits.spendBudget),
+    ].join("\n");
+}
+/** Render the static tier legend, one line per `tier` value list_agents emits. */
+export function formatTierGuide() {
+    return TIER_ORDER.map((tier) => `- ${tier}: ${TIER_GUIDE[tier]}`).join("\n");
+}
+function renderBudget(budget) {
+    const parts = [
+        budget.fiveHours ? `${budget.fiveHours} per 5 hours` : null,
+        budget.weekly ? `${budget.weekly} per week` : null,
+        budget.monthly ? `${budget.monthly} per month` : null,
+    ].filter((part) => part !== null);
+    const shared = "Every model draws from the SAME dollar budget, so an expensive model drains it in far fewer requests.";
+    if (parts.length === 0)
+        return `Shared spend budget across all models. ${shared}`;
+    return `Shared spend budget: ${parts.join(", ")}. ${shared}`;
+}
+//# sourceMappingURL=usage-limits.js.map

package/build/src/modules/shared/usage-limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-limits.js","sourceRoot":"","sources":["../../../../src/modules/shared/usage-limits.ts"],"names":[],"mappings":"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"}

package/build/src/modules/tools/cancel_task.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cancel_task.d.ts","sourceRoot":"","sources":["../../../../src/modules/tools/cancel_task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,QAiC3D"}
+{"version":3,"file":"cancel_task.d.ts","sourceRoot":"","sources":["../../../../src/modules/tools/cancel_task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,QAqC3D"}

package/build/src/modules/tools/cancel_task.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { jsonError, jsonResult } from "../shared/mcp-result.js";
 import { clientForTask } from "../shared/opencode-client.js";
+import { markTaskCancelled } from "../shared/task-registry.js";
 export function registerOpencodeCancelTask(server) {
     server.registerTool("opencode_cancel_task", {
         description: "Cancel a delegated task by aborting its OpenCode session",
@@ -15,6 +16,10 @@ export function registerOpencodeCancelTask(server) {
         const { client, sessionId } = resolved;
         try {
             await client.session.abort({ path: { id: sessionId } });
+            // Aborting alone leaves no trace: the session's last assistant message
+            // still carries a completed timestamp, so status derivation would
+            // report `completed` for a task the caller deliberately killed.
+            markTaskCancelled(task_id);
             return jsonResult({
                 task_id,
                 session_id: sessionId,

package/build/src/modules/tools/cancel_task.js.map

@@ -1 +1 @@
-{"version":3,"file":"cancel_task.js","sourceRoot":"","sources":["../../../../src/modules/tools/cancel_task.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,MAAM,UAAU,0BAA0B,CAAC,MAAiB;IAC1D,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,WAAW,EAAE,0DAA0D;QACvE,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;SACzD;KACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACpB,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,SAAS,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC;QAEvC,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;YAExD,OAAO,UAAU,CAAC;gBAChB,OAAO;gBACP,UAAU,EAAE,SAAS;gBACrB,MAAM,EAAE,WAAW;aACpB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,SAAS,CAAC;gBACf,OAAO;gBACP,MAAM,EAAE,OAAO;gBACf,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAChE,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"cancel_task.js","sourceRoot":"","sources":["../../../../src/modules/tools/cancel_task.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE/D,MAAM,UAAU,0BAA0B,CAAC,MAAiB;IAC1D,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,WAAW,EAAE,0DAA0D;QACvE,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;SACzD;KACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACpB,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,SAAS,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC;QAEvC,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;YACxD,uEAAuE;YACvE,kEAAkE;YAClE,gEAAgE;YAChE,iBAAiB,CAAC,OAAO,CAAC,CAAC;YAE3B,OAAO,UAAU,CAAC;gBAChB,OAAO;gBACP,UAAU,EAAE,SAAS;gBACrB,MAAM,EAAE,WAAW;aACpB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,SAAS,CAAC;gBACf,OAAO;gBACP,MAAM,EAAE,OAAO;gBACf,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAChE,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/src/modules/tools/get_task_result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get_task_result.d.ts","sourceRoot":"","sources":["../../../../src/modules/tools/get_task_result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,QAgD9D"}
+{"version":3,"file":"get_task_result.d.ts","sourceRoot":"","sources":["../../../../src/modules/tools/get_task_result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAuBzE,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,QA8E9D"}

package/build/src/modules/tools/get_task_result.js

@@ -1,6 +1,14 @@
 import { z } from "zod";
 import { jsonError, jsonResult } from "../shared/mcp-result.js";
-import { clientForTask, lastAssistantEntry } from "../shared/opencode-client.js";
+import { assistantEntries, buildProgress, CANCELLED_TASK_MESSAGE, clientForTask, EMPTY_TURN_MESSAGE, hasWork, sessionParts, } from "../shared/opencode-client.js";
+import { getTask } from "../shared/task-registry.js";
+/** Concatenate every TextPart in a turn, in order. */
+function joinText(parts) {
+    return parts
+        .filter((part) => part.type === "text")
+        .map((part) => part.text)
+        .join("");
+}
 export function registerOpencodeGetTaskResult(server) {
     server.registerTool("opencode_get_task_result", {
         description: "Get the final result of a completed task",
@@ -14,7 +22,20 @@ export function registerOpencodeGetTaskResult(server) {
         }
         const { client, sessionId } = resolved;
         try {
-            const entry = await lastAssistantEntry(client, sessionId);
+            const entries = await assistantEntries(client, sessionId);
+            const entry = entries.at(-1);
+            // An aborted session keeps its completed timestamp, so without this a
+            // deliberately killed task reads as a normal success.
+            if (getTask(task_id)?.cancelledAt !== undefined) {
+                const text = joinText(entry?.parts ?? []);
+                return jsonResult({
+                    task_id,
+                    status: "cancelled",
+                    result: text === "" ? null : text,
+                    message: CANCELLED_TASK_MESSAGE,
+                    progress: buildProgress(entry?.parts ?? [], sessionParts(entries)),
+                });
+            }
             if (!entry) {
                 return jsonResult({ task_id, status: "pending", result: null });
             }
@@ -29,11 +50,25 @@ export function registerOpencodeGetTaskResult(server) {
             if (!entry.info.time.completed) {
                 return jsonResult({ task_id, status: "running", result: null });
             }
-            const text = entry.parts
-                .filter((part) => part.type === "text")
-                .map((part) => part.text)
-                .join("");
-            return jsonResult({ task_id, status: "completed", result: text });
+            // Side-effect evidence, not just text: `completed` with an empty
+            // files_touched on a task whose whole purpose was writing files is the
+            // signal a caller needs to catch a no-op before building on top of it.
+            const progress = buildProgress(entry.parts, sessionParts(entries));
+            if (!hasWork(entry.parts)) {
+                return jsonResult({
+                    task_id,
+                    status: "empty",
+                    result: null,
+                    message: EMPTY_TURN_MESSAGE,
+                    progress,
+                });
+            }
+            return jsonResult({
+                task_id,
+                status: "completed",
+                result: joinText(entry.parts),
+                progress,
+            });
         }
         catch (error) {
             return jsonError({

package/build/src/modules/tools/get_task_result.js.map

@@ -1 +1 @@
-{"version":3,"file":"get_task_result.js","sourceRoot":"","sources":["../../../../src/modules/tools/get_task_result.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEjF,MAAM,UAAU,6BAA6B,CAAC,MAAiB;IAC7D,MAAM,CAAC,YAAY,CACjB,0BAA0B,EAC1B;QACE,WAAW,EAAE,0CAA0C;QACvD,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;SACvE;KACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACpB,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,SAAS,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;QACrD,CAAC;QACD,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC;QAEvC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YAC1D,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,UAAU,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAClE,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACrB,OAAO,UAAU,CAAC;oBAChB,OAAO;oBACP,MAAM,EAAE,QAAQ;oBAChB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI;oBAC5B,MAAM,EAAE,IAAI;iBACb,CAAC,CAAC;YACL,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;gBAC/B,OAAO,UAAU,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAClE,CAAC;YAED,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK;iBACrB,MAAM,CAAC,CAAC,IAAI,EAAkD,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;iBACtF,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;iBACxB,IAAI,CAAC,EAAE,CAAC,CAAC;YAEZ,OAAO,UAAU,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,SAAS,CAAC;gBACf,OAAO;gBACP,MAAM,EAAE,OAAO;gBACf,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAChE,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"get_task_result.js","sourceRoot":"","sources":["../../../../src/modules/tools/get_task_result.ts"],"names":[],"mappings":"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"}

package/build/src/modules/tools/list_agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list_agents.d.ts","sourceRoot":"","sources":["../../../../src/modules/tools/list_agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA8CzE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,QAgD3D"}
+{"version":3,"file":"list_agents.d.ts","sourceRoot":"","sources":["../../../../src/modules/tools/list_agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAyEzE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,QAqD3D"}

package/build/src/modules/tools/list_agents.js

@@ -2,6 +2,7 @@ import { createOpencodeClient } from "@opencode-ai/sdk";
 import { z } from "zod";
 import { jsonError, jsonResult } from "../shared/mcp-result.js";
 import { getServer } from "../shared/server-registry.js";
+import { getUsageLimits, quotaByModelId, quotaTier, } from "../shared/usage-limits.js";
 // Current opencode servers report the built-in flag as `native`; the SDK types
 // still declare the older `builtIn` field, so check both.
 function isNativeAgent(agent) {
@@ -15,13 +16,25 @@ function toAgentSummary(agent) {
         ...(agent.model ? { model: `${agent.model.providerID}/${agent.model.modelID}` } : {}),
     };
 }
-function toProviderSummary(provider) {
+function toProviderSummary(provider, quotas) {
     return {
         provider: provider.id,
         name: provider.name,
-        models: Object.keys(provider.models),
+        models: Object.keys(provider.models).map((id) => toModelSummary(id, quotas.get(id))),
     };
 }
+function toModelSummary(id, quota) {
+    if (!quota)
+        return { id, quota: null };
+    return { id, quota: { per_5h: quota.perFiveHours, tier: quotaTier(quota.perFiveHours) } };
+}
+// Tells the caller whether a `quota: null` means "not an OpenCode Go model" or
+// "we never got the table" — the two are indistinguishable per model.
+function toQuotaSnapshot(limits) {
+    if (!limits)
+        return null;
+    return { source: limits.source, checked: limits.fetchedAt.slice(0, 10) };
+}
 function errorMessage(error) {
     if (error instanceof Error)
         return error.message;
@@ -43,9 +56,12 @@ export function registerOpencodeListAgents(server) {
         }
         try {
             const client = createOpencodeClient({ baseUrl: instance.baseUrl });
-            const [agentsResult, providersResult] = await Promise.all([
+            // getUsageLimits() reads a once-a-day snapshot from disk, so this adds
+            // no network round-trip on a warm cache and never throws.
+            const [agentsResult, providersResult, limits] = await Promise.all([
                 client.app.agents(),
                 client.config.providers(),
+                getUsageLimits(),
             ]);
             const failure = agentsResult.error ?? providersResult.error;
             if (failure) {
@@ -54,6 +70,7 @@ export function registerOpencodeListAgents(server) {
             const allAgents = agentsResult.data ?? [];
             const providers = providersResult.data?.providers ?? [];
             const defaults = providersResult.data?.default ?? {};
+            const quotas = limits ? quotaByModelId(limits) : new Map();
             return jsonResult({
                 server_id,
                 agents: {
@@ -62,7 +79,8 @@ export function registerOpencodeListAgents(server) {
                 },
                 models: {
                     defaults,
-                    providers: providers.map(toProviderSummary),
+                    quota_snapshot: toQuotaSnapshot(limits),
+                    providers: providers.map((provider) => toProviderSummary(provider, quotas)),
                 },
             });
         }

package/build/src/modules/tools/list_agents.js.map

@@ -1 +1 @@
-{"version":3,"file":"list_agents.js","sourceRoot":"","sources":["../../../../src/modules/tools/list_agents.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"list_agents.js","sourceRoot":"","sources":["../../../../src/modules/tools/list_agents.ts"],"names":[],"mappings":"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"}

package/build/src/modules/tools/start_server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start_server.d.ts","sourceRoot":"","sources":["../../../../src/modules/tools/start_server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,QAgD5D"}
+{"version":3,"file":"start_server.d.ts","sourceRoot":"","sources":["../../../../src/modules/tools/start_server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYzE,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,QAyE5D"}

package/build/src/modules/tools/start_server.js

@@ -1,6 +1,7 @@
 import { randomUUID } from "node:crypto";
-import { createOpencodeServer } from "@opencode-ai/sdk";
+import { createOpencodeClient, createOpencodeServer } from "@opencode-ai/sdk";
 import { z } from "zod";
+import { buildServerConfig, getExternalDirectoryPolicy, startPermissionResponder, } from "../shared/permissions.js";
 import { registerServer } from "../shared/server-registry.js";
 const DEFAULT_PORT = 4096;
 export function registerOpencodeStartServer(server) {
@@ -11,14 +12,29 @@ export function registerOpencodeStartServer(server) {
         },
     }, async ({ port }) => {
         try {
+            const policy = getExternalDirectoryPolicy();
             // The server inherits this process' cwd, so its project worktree is the
             // directory the MCP host was launched in — no cwd argument needed.
             const instance = await createOpencodeServer({
                 hostname: "127.0.0.1",
                 port: port ?? DEFAULT_PORT,
+                config: buildServerConfig(policy),
             });
             const serverId = randomUUID();
-            registerServer({ serverId, baseUrl: instance.url, close: instance.close });
+            // Nothing can approve a permission prompt behind a headless server, so
+            // an unanswered `ask` wedges the agent forever. The responder answers
+            // every request, which is what keeps tasks from hanging indefinitely.
+            const responder = startPermissionResponder(createOpencodeClient({ baseUrl: instance.url }), {
+                policy,
+            });
+            registerServer({
+                serverId,
+                baseUrl: instance.url,
+                close: () => {
+                    responder.stop();
+                    instance.close();
+                },
+            });
             return {
                 content: [
                     {
@@ -27,6 +43,10 @@ export function registerOpencodeStartServer(server) {
                             server_id: serverId,
                             baseUrl: instance.url,
                             status: "running",
+                            permissions: {
+                                external_directory: policy,
+                                auto_approved: true,
+                            },
                         }),
                     },
                 ],

package/build/src/modules/tools/start_server.js.map

@@ -1 +1 @@
-{"version":3,"file":"start_server.js","sourceRoot":"","sources":["../../../../src/modules/tools/start_server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,MAAM,YAAY,GAAG,IAAI,CAAC;AAE1B,MAAM,UAAU,2BAA2B,CAAC,MAAiB;IAC3D,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,WAAW,EAAE,4EAA4E;QACzF,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;SAClF;KACF,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACjB,IAAI,CAAC;YACH,wEAAwE;YACxE,mEAAmE;YACnE,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC;gBAC1C,QAAQ,EAAE,WAAW;gBACrB,IAAI,EAAE,IAAI,IAAI,YAAY;aAC3B,CAAC,CAAC;YACH,MAAM,QAAQ,GAAG,UAAU,EAAE,CAAC;YAC9B,cAAc,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;YAE3E,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,SAAS,EAAE,QAAQ;4BACnB,OAAO,EAAE,QAAQ,CAAC,GAAG;4BACrB,MAAM,EAAE,SAAS;yBAClB,CAAC;qBACH;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,MAAM,EAAE,OAAO;4BACf,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;yBAChE,CAAC;qBACH;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"start_server.js","sourceRoot":"","sources":["../../../../src/modules/tools/start_server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,MAAM,YAAY,GAAG,IAAI,CAAC;AAE1B,MAAM,UAAU,2BAA2B,CAAC,MAAiB;IAC3D,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,WAAW,EAAE,4EAA4E;QACzF,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;SAClF;KACF,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACjB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,0BAA0B,EAAE,CAAC;YAE5C,wEAAwE;YACxE,mEAAmE;YACnE,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC;gBAC1C,QAAQ,EAAE,WAAW;gBACrB,IAAI,EAAE,IAAI,IAAI,YAAY;gBAC1B,MAAM,EAAE,iBAAiB,CAAC,MAAM,CAAC;aAClC,CAAC,CAAC;YACH,MAAM,QAAQ,GAAG,UAAU,EAAE,CAAC;YAE9B,uEAAuE;YACvE,sEAAsE;YACtE,sEAAsE;YACtE,MAAM,SAAS,GAAG,wBAAwB,CACxC,oBAAoB,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,EAC/C;gBACE,MAAM;aACP,CACF,CAAC;YAEF,cAAc,CAAC;gBACb,QAAQ;gBACR,OAAO,EAAE,QAAQ,CAAC,GAAG;gBACrB,KAAK,EAAE,GAAG,EAAE;oBACV,SAAS,CAAC,IAAI,EAAE,CAAC;oBACjB,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACnB,CAAC;aACF,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,SAAS,EAAE,QAAQ;4BACnB,OAAO,EAAE,QAAQ,CAAC,GAAG;4BACrB,MAAM,EAAE,SAAS;4BACjB,WAAW,EAAE;gCACX,kBAAkB,EAAE,MAAM;gCAC1B,aAAa,EAAE,IAAI;6BACpB;yBACF,CAAC;qBACH;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,MAAM,EAAE,OAAO;4BACf,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;yBAChE,CAAC;qBACH;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-server-opencode",
-  "version": "1.1.4",
+  "version": "1.2.0",
   "description": "MCP server that lets any MCP host (Claude Code, Codex CLI, Cursor, etc.) drive OpenCode and delegate tasks asynchronously to its agents",
   "main": "./build/src/index.js",
   "types": "./build/src/index.d.ts",
@@ -47,7 +47,8 @@
     "publish": "npm publish --access public"
   },
   "files": [
-    "build"
+    "build",
+    "CHANGELOG.md"
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",