gameye-mcp 0.3.2 → 0.5.0

package/dist/env.js

@@ -3,10 +3,20 @@
 // The Gameye environment is a property of the server process, never of a
 // single tool call: an agent cannot switch to production mid-conversation.
 // Users who need both environments run two named server entries.
+import { parseDurationMs } from "./limits.js";
 export const KNOWN_HOSTS = {
     sandbox: "https://api.sandbox-gameye.gameye.net",
     production: "https://api.production-gameye.gameye.net",
 };
+export const DEFAULT_LIMITS = {
+    maxSessions: 5,
+    maxTtl: "4h",
+    maxTtlMs: 4 * 3_600_000,
+    maxLaunches: 20,
+    stopOwnOnly: false,
+};
+/** Shortest GAMEYE_MAX_TTL: the default TTL a launch without one gets (DEFAULT_SESSION_TTL). */
+const MIN_MAX_TTL_MS = 30 * 60_000;
 /** Per-request timeout used when GAMEYE_TIMEOUT_MS is not set. */
 export const DEFAULT_TIMEOUT_MS = 30_000;
 export class ConfigError extends Error {
@@ -20,6 +30,20 @@ function nonEmpty(value) {
     const trimmed = value?.trim();
     return trimmed ? trimmed : undefined;
 }
+/** A whole value like `${user_config.api_token}`: a host placeholder that was never filled in. */
+const UNEXPANDED_PLACEHOLDER = /^\$\{[^}]*\}$/;
+/**
+ * The configured token, or undefined when it is missing, blank or an unexpanded
+ * host placeholder. Any of those starts the server in no-token mode.
+ */
+function resolveToken(raw) {
+    const value = nonEmpty(raw);
+    if (value === undefined || UNEXPANDED_PLACEHOLDER.test(value))
+        return undefined;
+    return value;
+}
+/** The one stderr line printed at start in no-token mode. Never mentions a token value. */
+export const NO_TOKEN_NOTICE = "No GAMEYE_API_TOKEN set: account tools will refuse until a token is set and the server is restarted.";
 function parseTimeoutMs(raw) {
     const value = nonEmpty(raw);
     if (value === undefined)
@@ -30,6 +54,35 @@ function parseTimeoutMs(raw) {
     }
     return ms;
 }
+function parsePositiveInt(name, raw, fallback) {
+    const value = nonEmpty(raw);
+    if (value === undefined)
+        return fallback;
+    const n = /^\d+$/.test(value) ? Number(value) : NaN;
+    if (!Number.isSafeInteger(n) || n <= 0) {
+        throw new ConfigError(`${name} must be a positive whole number (got "${value}"). Leave it unset for ${fallback}.`);
+    }
+    return n;
+}
+function parseLimits(env) {
+    const maxSessions = parsePositiveInt("GAMEYE_MAX_SESSIONS", env.GAMEYE_MAX_SESSIONS, DEFAULT_LIMITS.maxSessions);
+    const maxLaunches = parsePositiveInt("GAMEYE_MAX_LAUNCHES", env.GAMEYE_MAX_LAUNCHES, DEFAULT_LIMITS.maxLaunches);
+    let { maxTtl, maxTtlMs } = DEFAULT_LIMITS;
+    const rawTtl = nonEmpty(env.GAMEYE_MAX_TTL);
+    if (rawTtl !== undefined) {
+        const ms = parseDurationMs(rawTtl);
+        if (ms === undefined || ms < MIN_MAX_TTL_MS) {
+            throw new ConfigError(`GAMEYE_MAX_TTL must be a duration of at least 30m, like 2h or 90m (got "${rawTtl}"). Leave it unset for ${DEFAULT_LIMITS.maxTtl}.`);
+        }
+        maxTtl = rawTtl;
+        maxTtlMs = ms;
+    }
+    const rawOwn = nonEmpty(env.GAMEYE_STOP_OWN_ONLY);
+    if (rawOwn !== undefined && rawOwn !== "1" && rawOwn !== "0") {
+        throw new ConfigError(`GAMEYE_STOP_OWN_ONLY must be 1 or 0 (got "${rawOwn}"). Leave it unset to allow stopping any session the token can see.`);
+    }
+    return { maxSessions, maxTtl, maxTtlMs, maxLaunches, stopOwnOnly: rawOwn === "1" };
+}
 /** Lowercase a hostname and drop a trailing root dot (`example.com.` is the same host as `example.com`). */
 function normalizeHostname(hostname) {
     return hostname.toLowerCase().replace(/\.$/, "");
@@ -48,18 +101,17 @@ function matchKnownTier(url) {
 /**
  * Resolve the server configuration from an environment object.
  * Pure: throws ConfigError on any invalid combination and never touches process state.
+ * A missing token is not an error: it resolves with `hasToken: false`.
  */
 export function resolveConfig(env) {
-    const token = nonEmpty(env.GAMEYE_API_TOKEN);
-    if (!token) {
-        throw new ConfigError("GAMEYE_API_TOKEN is required. Set it in your MCP server configuration:\n" +
-            '  "env": { "GAMEYE_API_TOKEN": "<your token>" }');
-    }
+    const token = resolveToken(env.GAMEYE_API_TOKEN);
+    const auth = token === undefined ? { hasToken: false } : { token, hasToken: true };
     if (nonEmpty(env.GAMEYE_API_ENDPOINT)) {
         throw new ConfigError("GAMEYE_API_ENDPOINT is no longer supported. Use GAMEYE_ENV=sandbox|production " +
             "(default sandbox), or GAMEYE_API_URL for a non-standard https host.");
     }
     const timeoutMs = parseTimeoutMs(env.GAMEYE_TIMEOUT_MS);
+    const limits = parseLimits(env);
     const rawEnv = nonEmpty(env.GAMEYE_ENV);
     let tier = "sandbox";
     if (rawEnv !== undefined) {
@@ -71,7 +123,7 @@ export function resolveConfig(env) {
     const rawUrl = nonEmpty(env.GAMEYE_API_URL);
     if (rawUrl === undefined) {
         const baseUrl = KNOWN_HOSTS[tier];
-        return { environment: tier, baseUrl, host: new URL(baseUrl).host, token, timeoutMs };
+        return { environment: tier, baseUrl, host: new URL(baseUrl).host, ...auth, timeoutMs, limits };
     }
     let url;
     try {
@@ -90,10 +142,10 @@ export function resolveConfig(env) {
                 `Set GAMEYE_ENV=${knownTier} to use ${knownTier}, or remove GAMEYE_API_URL.`);
         }
         const baseUrl = KNOWN_HOSTS[knownTier];
-        return { environment: knownTier, baseUrl, host: new URL(baseUrl).host, token, timeoutMs };
+        return { environment: knownTier, baseUrl, host: new URL(baseUrl).host, ...auth, timeoutMs, limits };
     }
     const baseUrl = `${url.origin}${url.pathname}`.replace(/\/+$/, "");
-    return { environment: "custom", baseUrl, host: url.host, token, timeoutMs };
+    return { environment: "custom", baseUrl, host: url.host, ...auth, timeoutMs, limits };
 }
 /** Resolve from process.env, printing a clear message and exiting 1 on any error. */
 export function loadConfigOrExit(env = process.env) {
@@ -110,5 +162,5 @@ export function loadConfigOrExit(env = process.env) {
 }
 /** The line every tool result starts with, e.g. `[sandbox · api.sandbox-gameye.gameye.net]`. */
 export function resultPrefix(config) {
-    return `[${config.environment} · ${config.host}]`;
+    return `[${config.environment} · ${config.host}${config.hasToken === false ? " · no token" : ""}]`;
 }

package/dist/generated/skills.d.ts

@@ -0,0 +1,39 @@
+export interface BundledSkill {
+    /** Directory and frontmatter name, e.g. "gameye-containerize". */
+    name: string;
+    description: string;
+    /** The skill's own metadata.version. */
+    version: string;
+    /** "SKILL.md" and "references/<file>.md", keyed by path relative to the skill. */
+    files: Readonly<Record<string, string>>;
+}
+export interface ContainerContractItem {
+    /** The item's number in gameye-containerize "The container contract". */
+    number: number;
+    text: string;
+}
+export declare const TEMPLATE_ENGINES: readonly ["unreal", "unity", "godot", "web"];
+export declare const TEMPLATE_KINDS: readonly ["dockerfile", "shutdown-hook"];
+export type TemplateEngine = (typeof TEMPLATE_ENGINES)[number];
+export type TemplateKind = (typeof TEMPLATE_KINDS)[number];
+export interface BundledTemplate {
+    engine: TemplateEngine;
+    kind: TemplateKind;
+    /** The engine skill that publishes it, e.g. "gameye-godot-server". */
+    skill: string;
+    /** The heading of the section the markers sit in. */
+    section: string;
+    /** The fence's info string, e.g. "dockerfile". */
+    language: string;
+    /** The fenced block's content exactly as published, without the fence lines. */
+    code: string;
+    /** Prose inside the marker pair beside the fence, e.g. the engine version it was tested on. */
+    note?: string;
+}
+export declare const BUNDLED_SKILLS_PACK_VERSION = "1.7.0";
+export declare const BUNDLED_SKILLS_TAG = "v1.7.0";
+export declare const BUNDLED_SKILLS_COMMIT = "aeb5b8fbe1251b89b6368de8fa48a39850de93a1";
+export declare const BUNDLED_SKILLS: readonly BundledSkill[];
+export declare const CONTAINER_CONTRACT: readonly ContainerContractItem[];
+/** Template blocks marked <!-- gameye-template: engine/kind --> in the pinned engine skills. */
+export declare const BUNDLED_TEMPLATES: readonly BundledTemplate[];