fa-mcp-sdk 0.11.12 → 0.11.14

package/cli-template/.claude/skills/create-mcp-wizard/SKILL.md

@@ -185,7 +185,7 @@ with an auth error, surface it to the user; do not attempt API-token workarounds
 Collect GitLab credentials — prefer values already in the accompanying text, ask only for what's
 missing:
 
-- `baseUrl` — e.g. `https://gitlab.finam.ru/api/v4`
+- `baseUrl` — e.g. `https://gitlab.corp.com/api/v4`
 - `token` — GitLab private token with `api` scope
 - `group` — group name or full path (e.g. `mcp-servers` or `ai/mcp`), OR `groupId` numeric
 

package/cli-template/.claude/skills/create-mcp-wizard/scripts/gitlab-push.js

@@ -7,7 +7,7 @@
  * Finally runs `git init / add / commit / remote add / push -u origin <branch>`.
  *
  * Environment / flags:
- *   --base-url  <url>    (e.g. https://gitlab.finam.ru/api/v4) — required
+ *   --base-url  <url>    (e.g. https://gitlab.corp.com/api/v4) — required
  *   --token     <tok>    GitLab private token — required
  *   --group     <name>   Group name or full path (e.g. "mcp-servers") — required unless --group-id is given
  *   --group-id  <n>      Numeric group id — overrides --group lookup
@@ -54,7 +54,7 @@ function die (msg, code = 1) {
   process.exit(code);
 }
 
-if (!baseUrl)     die('Missing --base-url (or GITLAB_BASE_URL). Example: https://gitlab.finam.ru/api/v4');
+if (!baseUrl)     die('Missing --base-url (or GITLAB_BASE_URL). Example: https://gitlab.corp.com/api/v4');
 if (!token)       die('Missing --token (or GITLAB_TOKEN).');
 if (!projectName) die('Missing --name (project name).');
 if (!groupId && !groupArg) die('Missing --group or --group-id.');
@@ -154,4 +154,4 @@ function gitPush (remoteUrl) {
   } catch (e) {
     die(e.message);
   }
-})();
+})();

package/cli-template/package.json

@@ -58,7 +58,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "dotenv": "^17.4.1",
-    "fa-mcp-sdk": "^0.11.12"
+    "fa-mcp-sdk": "^0.11.14"
   },
   "devDependencies": {
     "@types/express": "^5.0.6",

package/dist/core/web/static/agent-tester/script.js

@@ -800,6 +800,22 @@ class McpAgentTester {
     }
 
     this.refreshToolListAppIcons();
+    this.applyAppModeVisibility();
+  }
+
+  /**
+   * Show the Inspector tab only while MCP Apps mode is ON. When the mode is
+   * turned off while the Inspector tab is active, fall back to the Chat tab so
+   * the user is not left on a hidden pane.
+   */
+  applyAppModeVisibility() {
+    const appEl = document.querySelector('.app');
+    if (appEl) {
+      appEl.classList.toggle('apps-mode-on', !!this.appMode);
+    }
+    if (!this.appMode && this.activeTab === 'inspector') {
+      this.switchTab('chat');
+    }
   }
 
   /**
@@ -1395,6 +1411,7 @@ class McpAgentTester {
       this.appModeToggle.addEventListener('change', () => this.handleAppModeToggle());
       this.updateAppModeToggleAvailability();
     }
+    this.applyAppModeVisibility();
 
     this.mcpConnectionForm.addEventListener('submit', (e) => this.handleMcpConnection(e));
 

package/dist/core/web/static/agent-tester/styles.css

@@ -1110,6 +1110,17 @@ body {
 .inspector-section {
   padding: 8px 14px 14px;
   border-bottom: 1px solid var(--border);
+  min-height: 0;
+  overflow-y: auto;
+}
+
+/* App Tools list gets the larger share; UI Resources the smaller. Both scroll. */
+.inspector-tools .inspector-section:nth-of-type(1) {
+  flex: 2 1 0;
+}
+
+.inspector-tools .inspector-section:nth-of-type(2) {
+  flex: 1 1 0;
 }
 
 .inspector-section h4 {
@@ -1259,8 +1270,11 @@ body {
 }
 
 /* Inspector tab visibility tied to MCP Apps mode */
-.app:not([data-active-tab]) .app-only-tab,
-.tabs-bar .app-only-tab {
+.app-only-tab {
+  display: none;
+}
+
+.app.apps-mode-on .app-only-tab {
   display: inline-flex;
 }
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "fa-mcp-sdk",
   "productName": "FA MCP SDK",
-  "version": "0.11.12",
+  "version": "0.11.14",
   "description": "Core infrastructure and templates for building Model Context Protocol (MCP) servers with TypeScript",
   "type": "module",
   "main": "dist/core/index.js",

package/cli-template/.gitlab-ci.yml

@@ -1,135 +0,0 @@
-stages:
-  - lint
-  - test-build
-  - build-image
-  - deploy
-
-# ── CI: Merge Request checks ──────────────────────────────────────
-
-.node-template: &node-template
-  image: node:22-alpine
-  tags:
-    - docker
-  before_script:
-    - yarn install --frozen-lockfile
-  cache:
-    key:
-      files:
-        - yarn.lock
-    paths:
-      - node_modules/
-  rules:
-    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
-
-lint:
-  <<: *node-template
-  stage: lint
-  script:
-    - yarn lint
-
-test-build:
-  <<: *node-template
-  stage: test-build
-  script:
-    - yarn build
-
-# ── CD: Build Docker Image ────────────────────────────────────────
-
-build-image:
-  stage: build-image
-  image: docker:27
-  services:
-    - docker:27-dind
-  tags:
-    - docker
-  script:
-    - docker compose -f deploy/docker/docker-compose.yml up -d --build --force-recreate app
-  rules:
-    - if: '$CI_COMMIT_BRANCH == "master"'
-      when: manual
-
-# ── CD: Deploy ────────────────────────────────────────────────────
-# Замените <SERVER_TAG> на тег вашего сервера, <BRANCH> на целевую ветку,
-# <DEPLOY_DIR> на путь к проекту на сервере.
-
-# deploy_<instance>:
-#   stage: deploy
-#   tags:
-#     - <SERVER_TAG>
-#   variables:
-#     HOST_PORT: {{port}}
-#   environment:
-#     name: <instance>
-#   script:
-#     - docker compose -f deploy/docker/docker-compose.yml --env-file .env up -d --build --force-recreate app
-#     - |
-#       echo "Waiting for health check..."
-#       for i in $(seq 1 60); do
-#         if docker compose -f deploy/docker/docker-compose.yml exec -T app wget -q -O /dev/null http://localhost:{{port}}/health 2>/dev/null; then
-#           echo "Health check passed after ${i}s"
-#           break
-#         fi
-#         if [ "$i" -eq 60 ]; then
-#           echo "Health check failed after 60s"
-#           docker compose -f deploy/docker/docker-compose.yml logs --tail=50 app
-#           exit 1
-#         fi
-#         sleep 1
-#       done
-#     - docker compose -f deploy/docker/docker-compose.yml logs --tail=50 app
-#   rules:
-#     - if: '$CI_COMMIT_BRANCH == "<BRANCH>"'
-#       when: manual
-
-# stop_<instance>:
-#   stage: deploy
-#   tags:
-#     - <SERVER_TAG>
-#   environment:
-#     name: <instance>
-#   script:
-#     - docker compose -f deploy/docker/docker-compose.yml down
-#   rules:
-#     - if: '$CI_COMMIT_BRANCH == "<BRANCH>"'
-#       when: manual
-
-# restart_<instance>:
-#   stage: deploy
-#   tags:
-#     - <SERVER_TAG>
-#   variables:
-#     HOST_PORT: {{port}}
-#   environment:
-#     name: <instance>
-#   script:
-#     - docker compose -f deploy/docker/docker-compose.yml --env-file .env restart app
-#     - |
-#       echo "Waiting for health check..."
-#       for i in $(seq 1 60); do
-#         if docker compose -f deploy/docker/docker-compose.yml exec -T app wget -q -O /dev/null http://localhost:{{port}}/health 2>/dev/null; then
-#           echo "Health check passed after ${i}s"
-#           break
-#         fi
-#         if [ "$i" -eq 60 ]; then
-#           echo "Health check failed after 60s"
-#           docker compose -f deploy/docker/docker-compose.yml logs --tail=100 app
-#           exit 1
-#         fi
-#         sleep 1
-#       done
-#     - docker compose -f deploy/docker/docker-compose.yml logs --tail=100 app
-#   rules:
-#     - if: '$CI_COMMIT_BRANCH == "<BRANCH>"'
-#       when: manual
-
-# logs_<instance>:
-#   stage: deploy
-#   tags:
-#     - <SERVER_TAG>
-#   environment:
-#     name: <instance>
-#   script:
-#     - docker compose -f deploy/docker/docker-compose.yml logs --tail=100 app
-#   rules:
-#     - if: '$CI_COMMIT_BRANCH == "<BRANCH>"'
-#       when: manual

package/cli-template/deploy/gitlab-runner/.env.example

@@ -1,16 +0,0 @@
-# ── GitLab Runner version ─────────────────────────────────
-GITLAB_VERSION=v18.10.3
-HELPER_VERSION=v18.10.3
-
-# ── GitLab connection ─────────────────────────────────────
-GITLAB_URL=https://gitlab.finam.ru/
-RUNNER_TAGS={{project.name}},docker
-
-# ── Runner identity ──────────────────────────────────────
-RUNNER_NAME={{project.name}}
-RUNNER_TOKEN=
-
-# ── Project directory on host ─────────────────────────────
-# Absolute or relative path to the project root on the server.
-# Defaults to ../../ (two levels up from this directory).
-# PROJECT_DIR=/var/opt/node/{{project.name}}

package/cli-template/deploy/gitlab-runner/README.md

@@ -1,65 +0,0 @@
-# GitLab Runner Setup
-
-Docker-based GitLab Runner for CI/CD pipelines. Uses Docker executor with Docker-out-of-Docker (DooD) pattern.
-
-## How It Works
-
-1. `start.sh` validates `.env`, resolves `PROJECT_DIR`, starts the runner container
-2. `entrypoint.sh` substitutes variables in `config.toml.template` → `config.toml`, starts `gitlab-runner run`
-3. Runner registers with GitLab, listens for CI jobs matching its tags
-
-## Setup
-
-```bash
-# 1. Copy environment template
-cp .env.example .env
-
-# 2. Get runner token from GitLab UI:
-#    Settings → CI/CD → Runners → New project runner
-#    Set tags, then copy the token
-
-# 3. Fill .env with your token and settings
-# Required: GITLAB_URL, RUNNER_NAME, RUNNER_TOKEN
-
-# 4. Start the runner
-bash start.sh
-```
-
-## Environment Variables
-
-| Variable | Required | Default | Description |
-|----------|----------|---------|-------------|
-| `GITLAB_VERSION` | yes | v18.10.3 | GitLab Runner Docker image version |
-| `HELPER_VERSION` | yes | v18.10.3 | GitLab Runner Helper image version |
-| `GITLAB_URL` | yes | — | GitLab instance URL |
-| `RUNNER_TAGS` | no | {{project.name}},docker | Comma-separated tags for job matching |
-| `RUNNER_NAME` | yes | — | Runner hostname and container name |
-| `RUNNER_TOKEN` | yes | — | Authentication token from GitLab UI |
-| `PROJECT_DIR` | no | ../../ | Absolute path to project on host |
-
-## Management Commands
-
-```bash
-# Start
-bash start.sh
-
-# View logs
-docker compose logs -f
-
-# Check status
-docker compose exec gitlab-runner gitlab-runner status
-
-# Stop
-docker compose down
-
-# Restart
-docker compose restart
-```
-
-## Infrastructure
-
-- **Network:** `gitlab-network` (bridge)
-- **DNS:** Corporate DNS servers (10.77.96.10, 10.77.196.10)
-- **Executor:** Docker with `docker:27` default image
-- **Volumes:** Docker socket, daemon.json, project directory, /cache
-- **Healthcheck:** `gitlab-runner status` every 60s

package/cli-template/deploy/gitlab-runner/config/config.toml.template

@@ -1,26 +0,0 @@
-concurrent = 2
-check_interval = 0
-shutdown_timeout = 0
-sentry_dsn = ""
-
-[session_server]
-  session_timeout = 1800
-
-[[runners]]
-  name = "__RUNNER_NAME__"
-  url = "__GITLAB_URL__"
-  token = "__RUNNER_TOKEN__"
-  executor = "docker"
-  tag_list = "__RUNNER_TAGS__"
-  [runners.docker]
-    tls_verify = false
-    image = "docker:27"
-    privileged = true
-    disable_entrypoint_overwrite = false
-    oom_kill_disable = false
-    disable_cache = false
-    volumes = ["/var/run/docker.sock:/var/run/docker.sock", "/etc/docker/daemon.json:/etc/docker/daemon.json", "__PROJECT_DIR__:__PROJECT_DIR__", "/cache"]
-    shm_size = 0
-    network_mtu = 0
-    pull_policy = ["if-not-present"]
-    helper_image = "gitlab/gitlab-runner-helper:__HELPER_VERSION__"

package/cli-template/deploy/gitlab-runner/docker-compose.yml

@@ -1,39 +0,0 @@
-name: {{project.name}}-runner
-
-services:
-  gitlab-runner:
-    image: gitlab/gitlab-runner:${GITLAB_VERSION}
-    hostname: ${RUNNER_NAME}
-    container_name: ${RUNNER_NAME}
-    environment:
-      - TZ=Europe/Moscow
-      - RUNNER_NAME=${RUNNER_NAME}
-      - RUNNER_TOKEN=${RUNNER_TOKEN}
-      - PROJECT_DIR=${PROJECT_DIR}
-      - GITLAB_URL=${GITLAB_URL}
-      - GITLAB_VERSION=${GITLAB_VERSION}
-      - RUNNER_TAGS=${RUNNER_TAGS}
-      - HELPER_VERSION=${HELPER_VERSION}
-    dns:
-      - 10.77.96.10
-      - 10.77.196.10
-    restart: always
-    entrypoint: ["/bin/sh", "/entrypoint.sh"]
-    volumes:
-      - './config:/etc/gitlab-runner'
-      - './entrypoint.sh:/entrypoint.sh:ro'
-      - '/var/run/docker.sock:/var/run/docker.sock'
-      - '/etc/docker/daemon.json:/etc/docker/daemon.json'
-    healthcheck:
-      test: ["CMD", "gitlab-runner", "status"]
-      interval: 1m
-      timeout: 10s
-      retries: 3
-      start_period: 30s
-    networks:
-      - gitlab
-
-networks:
-  gitlab:
-    name: gitlab-network
-    driver: bridge

package/cli-template/deploy/gitlab-runner/entrypoint.sh

@@ -1,27 +0,0 @@
-#!/bin/sh
-set -e
-
-TEMPLATE="/etc/gitlab-runner/config.toml.template"
-CONFIG="/etc/gitlab-runner/config.toml"
-
-if [ -z "$RUNNER_TOKEN" ]; then
-  echo "ERROR: RUNNER_TOKEN is required" >&2
-  exit 1
-fi
-
-if [ -z "$PROJECT_DIR" ]; then
-  echo "ERROR: PROJECT_DIR is required" >&2
-  exit 1
-fi
-
-sed \
-  -e "s|__RUNNER_NAME__|${RUNNER_NAME}|g" \
-  -e "s|__RUNNER_TOKEN__|${RUNNER_TOKEN}|g" \
-  -e "s|__PROJECT_DIR__|${PROJECT_DIR}|g" \
-  -e "s|__RUNNER_TAGS__|${RUNNER_TAGS}|g" \
-  -e "s|__GITLAB_URL__|${GITLAB_URL}|g" \
-  -e "s|__GITLAB_VERSION__|${GITLAB_VERSION}|g" \
-  -e "s|__HELPER_VERSION__|${HELPER_VERSION}|g" \
-  "$TEMPLATE" > "$CONFIG"
-
-exec gitlab-runner run

package/cli-template/deploy/gitlab-runner/start.sh

@@ -1,47 +0,0 @@
-#!/bin/bash
-set -e
-cd "$(dirname "$0")"
-
-# Проверка наличия .env файла
-if [ ! -f .env ]; then
-    echo "ERROR: .env file not found in $(pwd)"
-    echo "Copy .env.example to .env and fill in the values:"
-    echo "  cp .env.example .env"
-    exit 1
-fi
-
-# Загружаем .env в текущий shell
-set -a
-. .env
-set +a
-
-# Проверка обязательных переменных
-required_vars=(
-    "GITLAB_URL"
-    "RUNNER_NAME"
-    "RUNNER_TOKEN"
-)
-missing=()
-for var in "${required_vars[@]}"; do
-    if [ -z "${!var}" ]; then
-        missing+=("$var")
-    fi
-done
-if [ ${#missing[@]} -gt 0 ]; then
-    echo "ERROR: Required variables not set in .env:"
-    for var in "${missing[@]}"; do
-        echo "  - $var"
-    done
-    exit 1
-fi
-
-# PROJECT_DIR: если не задан — два уровня вверх (корень проекта)
-if [ -z "$PROJECT_DIR" ]; then
-    PROJECT_DIR="../.."
-fi
-
-# Резолвим в абсолютный путь
-PROJECT_DIR=$(cd "$PROJECT_DIR" && pwd)
-export PROJECT_DIR
-
-exec docker compose up -d "$@"