@extentos/mcp-server 0.5.10 → 0.6.1

package/dist/tools/handlers/assistantConfig.js

@@ -0,0 +1,222 @@
+// MCP read tools for the per-project "Agent" (assistant) settings + managed-
+// gateway usage — the read-only first slice of the agent MCP access surface
+// (shared-context/decisions-in-flight/mcp-per-project-access-policy.md).
+//
+//   getAssistantConfig — read the dashboard-managed Agent config (realtime
+//                        model / voice / memory model / memory mode) + the
+//                        catalog of valid options for each.
+//   getGatewayUsage    — read account-scoped managed-gateway usage + exact
+//                        cost over a window (metadata only — never content).
+//
+// Both are ACCOUNT-SCOPED reads: they hit the dedicated /api/agent/* backend
+// routes which resolve the account from the ~/.extentos/auth.json Bearer
+// (resolveIdentity), NOT the package-keyed SDK routes (/api/assistant-config),
+// which verify an attestation JWT on any Bearer and would reject the account
+// token. A 401 here genuinely means "no linked account" — run extentos-mcp login.
+//
+// Writes (setAssistantConfig) + the per-project access policy that gates them are
+// the NEXT slice; these two are pure reads and need no policy machinery.
+import { backendFetch } from "../util/backendClient.js";
+import { okResponse, errorResponse } from "../response.js";
+import { REALTIME_MODELS, VOICES, COMPACTION_MODELS, WITHIN_SESSION_MEMORY_MODES, DASHBOARD_DEFAULTS, SDK_HARD_DEFAULTS, } from "../data/assistantCatalog.js";
+function parseAppPackage(raw) {
+    if (!raw || typeof raw !== "object") {
+        return {
+            error: errorResponse({
+                code: "invalid_arguments",
+                message: "Requires an object argument with `appPackage`.",
+                fixHint: 'Pass { appPackage: "com.example.myapp" }.',
+                retryable: false,
+            }),
+        };
+    }
+    const v = raw.appPackage;
+    if (typeof v !== "string" || v.trim().length === 0) {
+        return {
+            error: errorResponse({
+                code: "invalid_arguments",
+                message: "`appPackage` is required and must be a non-empty string (the app's package / bundle id).",
+                fixHint: "Pass the developer's package/bundle id, e.g. com.example.myapp.",
+                retryable: false,
+            }),
+        };
+    }
+    return { value: v.trim() };
+}
+function accountRequired(action) {
+    return errorResponse({
+        code: "account_required",
+        message: `${action} needs a linked Extentos account. Run \`extentos-mcp login\` ` +
+            "(or `npx -p @extentos/mcp-server extentos-mcp login`) and approve in the browser, then retry.",
+        fixHint: "Run `extentos-mcp login`, approve in the browser, then retry.",
+        retryable: false,
+    });
+}
+function backendError(what, status, errorText) {
+    return errorResponse({
+        code: "backend_error",
+        message: `${what} (HTTP ${status}).${errorText ? ` ${errorText}` : ""}`,
+        fixHint: "Check the MCP can reach api.extentos.com and that the /api/agent/* routes are deployed. Retry if the failure looks transient.",
+        retryable: status === 0 || status >= 500,
+    });
+}
+// 403 from a governed /api/agent/* route = the project owner restricted this
+// capability (set it below the level this call needs) in the dashboard's MCP
+// access controls. Default is Read+Write, so this only fires after a deliberate
+// tighten.
+function permissionDenied(message, fixHint) {
+    return errorResponse({ code: "permission_denied", message, fixHint, retryable: false });
+}
+export async function handleGetAssistantConfig(raw) {
+    const pkg = parseAppPackage(raw);
+    if ("error" in pkg)
+        return pkg.error;
+    const res = await backendFetch(`/api/agent/config?appPackage=${encodeURIComponent(pkg.value)}`);
+    if (res.status === 401)
+        return accountRequired("Reading the Agent (assistant) config");
+    if (res.status === 403)
+        return permissionDenied("Reading this project's Agent config is restricted — the owner set Assistant-config access to Off in the dashboard.", "Ask the project owner to set Assistant config to Read or Read+Write in the project's MCP access controls.");
+    if (!res.ok)
+        return backendError(`Failed to read Agent config for ${pkg.value}`, res.status, res.errorText);
+    const config = res.data?.config ?? null;
+    const options = {
+        realtimeModel: REALTIME_MODELS.map((o) => ({ id: o.id, label: o.label, description: o.description })),
+        voice: VOICES.map((o) => ({ id: o.id, label: o.label })),
+        compactionModel: COMPACTION_MODELS.map((o) => ({ id: o.id, label: o.label, description: o.description })),
+        withinSessionMemory: WITHIN_SESSION_MEMORY_MODES.map((o) => ({ id: o.id, label: o.label, description: o.description })),
+    };
+    return okResponse({
+        managed: config !== null,
+        projectInstallId: pkg.value,
+        config,
+        dashboardDefaults: DASHBOARD_DEFAULTS,
+        sdkHardDefaults: SDK_HARD_DEFAULTS,
+        options,
+        precedenceNote: "Runtime precedence: a value set in app code (AssistantProvider.OpenAi(model = …, voice = …)) wins over this dashboard-managed config, which wins over the SDK hard defaults. This tool shows the dashboard-managed layer only — it cannot see code-set values. These settings are consumed by the Android SDK today; iOS reads them after the assistant iOS sweep.",
+        summary: config
+            ? `${pkg.value} has a dashboard-managed Agent config — realtime: ${config.realtimeModel}, voice: ${config.voice}, memory model: ${config.compactionModel}, memory mode: ${config.withinSessionMemory}.`
+            : `${pkg.value} has NO dashboard-managed Agent config. Unless the app code sets them, the SDK uses its hard defaults (realtime ${SDK_HARD_DEFAULTS.realtimeModel}, voice ${SDK_HARD_DEFAULTS.voice}, memory model ${SDK_HARD_DEFAULTS.compactionModel}, memory mode ${SDK_HARD_DEFAULTS.withinSessionMemory}). Set them in the dashboard's Agent section, or change them here with setAssistantConfig.`,
+    });
+}
+export async function handleGetGatewayUsage(raw) {
+    const pkg = parseAppPackage(raw);
+    if ("error" in pkg)
+        return pkg.error;
+    const obj = raw;
+    let days = 30;
+    if (obj.days !== undefined) {
+        if (typeof obj.days !== "number" || !Number.isFinite(obj.days)) {
+            return errorResponse({
+                code: "invalid_arguments",
+                message: "`days` must be a number between 1 and 365 when provided.",
+                fixHint: "Omit `days` for the default 30-day window, or pass e.g. days: 7.",
+                retryable: false,
+            });
+        }
+        days = Math.min(365, Math.max(1, Math.trunc(obj.days)));
+    }
+    const res = await backendFetch(`/api/agent/usage?appPackage=${encodeURIComponent(pkg.value)}&days=${days}`);
+    if (res.status === 401)
+        return accountRequired("Reading managed-gateway usage");
+    if (res.status === 403)
+        return permissionDenied("Reading this project's usage is restricted — the owner set Analytics access to Off in the dashboard.", "Ask the project owner to set Analytics to Read in the project's MCP access controls.");
+    if (!res.ok)
+        return backendError(`Failed to read gateway usage for ${pkg.value}`, res.status, res.errorText);
+    const d = res.data;
+    if (!d) {
+        return errorResponse({
+            code: "backend_error",
+            message: "Gateway usage response was empty.",
+            fixHint: "Retry; if it persists, check the /api/agent/usage route is deployed.",
+            retryable: true,
+        });
+    }
+    const topModel = d.byModel[0]?.model ?? "—";
+    return okResponse({
+        projectInstallId: pkg.value,
+        window: d.window,
+        totals: d.totals,
+        byModel: d.byModel,
+        creditBalanceUsd: d.creditBalanceUsd,
+        summary: d.hasData
+            ? `${pkg.value}: ${d.totals.responses} managed-gateway response(s) over the last ${d.window.days}d — ${d.totals.totalTokens.toLocaleString()} tokens, $${d.totals.costUsd.toFixed(4)}${d.creditBalanceUsd != null ? `; credit balance $${d.creditBalanceUsd.toFixed(2)}` : ""}. Top model: ${topModel}.`
+            : `${pkg.value}: no managed-gateway usage in the last ${d.window.days}d. Only managed-gateway + dashboard-vault-BYOK sessions are metered — a code-direct setOpenaiApiKey() bypass goes straight to OpenAI and never reaches Extentos.`,
+    });
+}
+// Catalog per writable field — the MCP-side gate so an agent gets a helpful
+// "valid ids are…" error instead of a backend rejection. The backend re-checks
+// the policy gate; field validity is enforced here (and at the schema enum).
+const CATALOG_BY_FIELD = {
+    realtimeModel: REALTIME_MODELS,
+    voice: VOICES,
+    compactionModel: COMPACTION_MODELS,
+    withinSessionMemory: WITHIN_SESSION_MEMORY_MODES,
+};
+export async function handleSetAssistantConfig(raw) {
+    const pkg = parseAppPackage(raw);
+    if ("error" in pkg)
+        return pkg.error;
+    const obj = raw;
+    // Collect + validate the provided fields against the catalog (partial update).
+    const provided = {};
+    for (const field of ["realtimeModel", "voice", "compactionModel", "withinSessionMemory"]) {
+        const v = obj[field];
+        if (v === undefined)
+            continue;
+        if (typeof v !== "string" || v.trim().length === 0) {
+            return errorResponse({
+                code: "invalid_arguments",
+                message: `\`${field}\` must be a non-empty string when provided.`,
+                fixHint: `Pass a valid ${field} id, or omit it.`,
+                retryable: false,
+            });
+        }
+        const id = v.trim();
+        const catalog = CATALOG_BY_FIELD[field];
+        if (!catalog.some((o) => o.id === id)) {
+            return errorResponse({
+                code: "invalid_arguments",
+                message: `\`${field}\`: "${id}" is not a valid option. Valid ids: ${catalog.map((o) => o.id).join(", ")}.`,
+                fixHint: "Call getAssistantConfig to see the catalog of valid options for each field.",
+                retryable: false,
+            });
+        }
+        provided[field] = id;
+    }
+    if (Object.keys(provided).length === 0) {
+        return errorResponse({
+            code: "invalid_arguments",
+            message: "Provide at least one field to change: realtimeModel, voice, compactionModel, or withinSessionMemory.",
+            fixHint: 'e.g. { appPackage: "com.example.app", realtimeModel: "gpt-realtime-mini" }.',
+            retryable: false,
+        });
+    }
+    const res = await backendFetch("/api/agent/config", {
+        method: "POST",
+        body: { appPackage: pkg.value, ...provided },
+    });
+    if (res.status === 401)
+        return accountRequired("Changing the Agent (assistant) config");
+    if (res.status === 403) {
+        return permissionDenied(res.data?.message ??
+            "Changing this project's Agent config via MCP is restricted — the owner set Assistant-config access below Read+Write.", "Ask the project owner to set Assistant config to Read+Write in the project's MCP access controls, then retry.");
+    }
+    if (!res.ok)
+        return backendError(`Failed to update Agent config for ${pkg.value}`, res.status, res.errorText);
+    const config = res.data?.config ?? null;
+    const costNote = res.data?.costNote ?? null;
+    return okResponse({
+        status: "ok",
+        projectInstallId: pkg.value,
+        changed: provided,
+        config,
+        costNote,
+        summary: `Updated ${pkg.value} Agent config (${Object.keys(provided).join(", ")}).` +
+            (config
+                ? ` Now: realtime ${config.realtimeModel}, voice ${config.voice}, memory model ${config.compactionModel}, mode ${config.withinSessionMemory}.`
+                : "") +
+            (costNote ? ` Cost impact — ${costNote}` : "") +
+            " Takes effect on the Android SDK's next assistant session (code-set values still win); iOS after the assistant sweep.",
+    });
+}
+//# sourceMappingURL=assistantConfig.js.map

package/dist/tools/handlers/assistantConfig.js.map

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

package/dist/tools/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AA+BhD,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAE9E,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CA4BhD,CAAC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAoChD,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAE9E,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CA+BhD,CAAC"}

package/dist/tools/registry.js

@@ -6,6 +6,7 @@ import { handleCreateSimulatorSession } from "./handlers/createSimulatorSession.
 import { handleEnsureSimulatorBrowser } from "./handlers/ensureSimulatorBrowser.js";
 import { handleGenerateConnectionModule } from "./handlers/generateConnectionModule.js";
 import { handleGetConnectionPageConfig, handleSetConnectionPageConfig, handleRegenerateConnectionPageFile, handleAdoptConnectionPageFile, } from "./handlers/connectionPageConfig.js";
+import { handleGetAssistantConfig, handleGetGatewayUsage, handleSetAssistantConfig, } from "./handlers/assistantConfig.js";
 import { handleGetCapabilityGuide } from "./handlers/getCapabilityGuide.js";
 import { handleGetCodeExample } from "./handlers/getCodeExample.js";
 import { handleGetCredentialGuide } from "./handlers/getCredentialGuide.js";
@@ -34,6 +35,9 @@ export const handlers = {
     setConnectionPageConfig: handleSetConnectionPageConfig,
     regenerateConnectionPageFile: handleRegenerateConnectionPageFile,
     adoptConnectionPageFile: handleAdoptConnectionPageFile,
+    getAssistantConfig: handleGetAssistantConfig,
+    setAssistantConfig: handleSetAssistantConfig,
+    getGatewayUsage: handleGetGatewayUsage,
     getCapabilityGuide: handleGetCapabilityGuide,
     getCodeExample: handleGetCodeExample,
     getCredentialGuide: handleGetCredentialGuide,

package/dist/tools/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,yEAAyE;AACzE,yEAAyE;AAGzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AACxF,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,EAC7B,kCAAkC,EAClC,6BAA6B,GAC9B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAC;AACtF,OAAO,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AACxF,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAI9E,MAAM,CAAC,MAAM,QAAQ,GAAgC;IACnD,gBAAgB,EAAE,sBAAsB;IACxC,sBAAsB,EAAE,4BAA4B;IACpD,sBAAsB,EAAE,4BAA4B;IACpD,wBAAwB,EAAE,8BAA8B;IACxD,uBAAuB,EAAE,6BAA6B;IACtD,uBAAuB,EAAE,6BAA6B;IACtD,4BAA4B,EAAE,kCAAkC;IAChE,uBAAuB,EAAE,6BAA6B;IACtD,kBAAkB,EAAE,wBAAwB;IAC5C,cAAc,EAAE,oBAAoB;IACpC,kBAAkB,EAAE,wBAAwB;IAC5C,eAAe,EAAE,qBAAqB;IACtC,WAAW,EAAE,iBAAiB;IAC9B,cAAc,EAAE,oBAAoB;IACpC,WAAW,EAAE,iBAAiB;IAC9B,eAAe,EAAE,qBAAqB;IACtC,sBAAsB,EAAE,4BAA4B;IACpD,kBAAkB,EAAE,wBAAwB;IAC5C,uBAAuB,EAAE,6BAA6B;IACtD,wBAAwB,EAAE,8BAA8B;IACxD,gBAAgB,EAAE,sBAAsB;IACxC,kBAAkB,EAAE,wBAAwB;IAC5C,gBAAgB,EAAE,sBAAsB;IACxC,UAAU,EAAE,gBAAgB;IAC5B,YAAY,EAAE,kBAAkB;IAChC,WAAW,EAAE,iBAAiB;IAC9B,mBAAmB,EAAE,yBAAyB;CAC/C,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@extentos/mcp-server",
-  "version": "0.5.10",
+  "version": "0.6.1",
   "description": "Extentos MCP server — deterministic tools for building Meta-glasses apps.",
   "type": "module",
   "bin": {
@@ -24,6 +24,11 @@
     "parity:connection-page": "node scripts/connection-page-parity.mjs",
     "parity:dat-version": "node scripts/dat-version-parity.mjs",
     "parity:device-catalog": "node scripts/device-catalog-parity.mjs",
+    "parity:assistant-catalog": "node scripts/assistant-catalog-parity.mjs",
+    "docs:reference": "node scripts/generate-docs-reference.mjs",
+    "docs:errors": "node scripts/generate-errors-reference.mjs",
+    "docs:generate": "npm run build && node scripts/generate-docs-reference.mjs && node scripts/generate-errors-reference.mjs",
+    "docs:check": "npm run docs:generate && git -C .. diff --exit-code -- content/docs/reference/mcp-tools.mdx content/docs/reference/errors.mdx",
     "prepublishOnly": "npm run build"
   },
   "keywords": [