mirror of
https://github.com/Kaelio/ktx.git
synced 2026-06-07 07:55:13 +02:00
* docs(specs): design research-agent MCP tools and ktx mcp daemon Adds the 2026-05-14 design spec for exposing four new MCP tools (discover_data, entity_details, dictionary_search, sql_execution), shipping a ktx-research skill, and introducing an HTTP-only ktx mcp daemon so external agents can use KTX as a research-capable context layer. * Refine research-agent MCP tools spec after adversarial review iteration 1 * Refine research-agent MCP tools spec after adversarial review iteration 2 * Refine research-agent MCP tools spec after adversarial review iteration 3 * Refine spec: drop connectionName compat carve-out and ground summary/snippet provenance per kind * feat(daemon): validate read-only SQL with sqlglot * feat(context): expose read-only SQL validation port * feat(context): register MCP sql execution tool * feat(context): execute MCP SQL through validated connector path * test(context): update SQL analysis port fixtures * docs: add research-agent MCP sql execution foundation plan * feat(context): add scan-backed entity details service * feat(context): register MCP entity details tool * feat(context): expose local MCP entity details * test(context): align entity details scan fixtures * docs: add research-agent MCP entity_details plan * feat(context): add dictionary search service * feat(context): register MCP dictionary search tool * feat(context): expose local MCP dictionary search * docs: add research-agent MCP dictionary_search plan * feat: add MCP discover data service * feat: expose discover data MCP tool * feat: wire local discover data MCP port * docs: add research-agent MCP discover_data plan * feat(cli): add mcp http security helpers * feat(cli): host mcp over streamable http * feat(cli): manage mcp daemon lifecycle * feat(cli): add ktx mcp commands * fix(cli): stabilize mcp daemon verification * docs: add research-agent MCP http daemon plan * feat(cli): install KTX research skill * feat(cli): configure MCP clients in setup agents * feat(cli): support Claude local MCP setup scope * docs: add research-agent MCP setup-agents plan * refactor(context): use connectionId in warehouse verification tools * docs(context): update ingest verification prompts for connectionId * docs: add research-agent MCP ingest contract convergence plan * chore: build runtime artifacts in conductor setup --------- Co-authored-by: Andrey Avtomonov <7889985+andreybavt@users.noreply.github.com>
145 lines
3.7 KiB
Bash
Executable file
145 lines
3.7 KiB
Bash
Executable file
#!/bin/bash
|
|
# conductor-setup.sh - Runs once when Conductor creates a KTX workspace.
|
|
#
|
|
# Prepares the standalone pnpm + uv workspace and builds the local CLI.
|
|
|
|
set -e
|
|
set -o pipefail
|
|
|
|
read_required_uv_version() {
|
|
local project_file="$1"
|
|
|
|
if [ ! -f "$project_file" ]; then
|
|
return 1
|
|
fi
|
|
|
|
sed -nE 's/^[[:space:]]*required-version[[:space:]]*=[[:space:]]*"([^"]+)".*/\1/p' "$project_file" | head -n 1
|
|
}
|
|
|
|
uv_version() {
|
|
local uv_bin="$1"
|
|
|
|
"$uv_bin" --version 2>/dev/null | awk '{print $2}'
|
|
}
|
|
|
|
install_workspace_uv() {
|
|
local required_version="$1"
|
|
local install_dir="$PWD/.context/bin/uv-$required_version"
|
|
|
|
mkdir -p "$install_dir"
|
|
|
|
if [ ! -x "$install_dir/uv" ] || [ "$(uv_version "$install_dir/uv")" != "$required_version" ]; then
|
|
echo "Installing workspace-local uv $required_version..." >&2
|
|
curl -LsSf "https://astral.sh/uv/$required_version/install.sh" |
|
|
env UV_INSTALL_DIR="$install_dir" UV_NO_MODIFY_PATH=1 sh >&2
|
|
fi
|
|
|
|
printf '%s\n' "$install_dir/uv"
|
|
}
|
|
|
|
resolve_uv_for_project() {
|
|
local project_file="$1"
|
|
local required_version
|
|
local system_uv
|
|
local system_version
|
|
local workspace_uv
|
|
|
|
required_version="$(read_required_uv_version "$project_file" || true)"
|
|
required_version="${required_version#==}"
|
|
|
|
if [ -z "$required_version" ]; then
|
|
command -v uv
|
|
return
|
|
fi
|
|
|
|
if ! [[ "$required_version" =~ ^[0-9]+[.][0-9]+[.][0-9]+$ ]]; then
|
|
echo "WARNING: Unsupported uv required-version '$required_version'; using uv from PATH." >&2
|
|
command -v uv
|
|
return
|
|
fi
|
|
|
|
if command -v uv >/dev/null 2>&1; then
|
|
system_uv="$(command -v uv)"
|
|
system_version="$(uv_version "$system_uv")"
|
|
|
|
if [ "$system_version" = "$required_version" ]; then
|
|
printf '%s\n' "$system_uv"
|
|
return
|
|
fi
|
|
|
|
echo "Found uv $system_version at $system_uv; $project_file requires uv $required_version." >&2
|
|
else
|
|
echo "uv is not installed on PATH; $project_file requires uv $required_version." >&2
|
|
fi
|
|
|
|
workspace_uv="$(install_workspace_uv "$required_version")"
|
|
|
|
if [ "$(uv_version "$workspace_uv")" != "$required_version" ]; then
|
|
echo "ERROR: Expected uv $required_version at $workspace_uv, got $("$workspace_uv" --version 2>&1 || true)." >&2
|
|
return 1
|
|
fi
|
|
|
|
printf '%s\n' "$workspace_uv"
|
|
}
|
|
|
|
link_shared_path() {
|
|
local source_path="$1"
|
|
local link_path="$2"
|
|
|
|
if [ ! -e "$source_path" ] && [ ! -L "$source_path" ]; then
|
|
return 1
|
|
fi
|
|
|
|
if [ -L "$link_path" ]; then
|
|
ln -sfn "$source_path" "$link_path"
|
|
echo "Linked $link_path"
|
|
return 0
|
|
fi
|
|
|
|
if [ -e "$link_path" ]; then
|
|
echo "Skipping $link_path symlink because $link_path already exists and is not a symlink." >&2
|
|
return 1
|
|
fi
|
|
|
|
ln -s "$source_path" "$link_path"
|
|
echo "Linked $link_path"
|
|
}
|
|
|
|
link_agent_overlays() {
|
|
if [ -n "${CONDUCTOR_ROOT_PATH:-}" ]; then
|
|
link_shared_path "$CONDUCTOR_ROOT_PATH/.agents" .agents || true
|
|
link_shared_path "$CONDUCTOR_ROOT_PATH/.claude" .claude || true
|
|
fi
|
|
}
|
|
|
|
echo "=== Conductor KTX workspace setup ==="
|
|
|
|
link_agent_overlays
|
|
|
|
if [ -n "${CONDUCTOR_ROOT_PATH:-}" ] && [ -f "$CONDUCTOR_ROOT_PATH/.env" ]; then
|
|
ln -sf "$CONDUCTOR_ROOT_PATH/.env" .env
|
|
echo "Linked .env"
|
|
fi
|
|
|
|
KTX_UV_BIN="$(resolve_uv_for_project "pyproject.toml")"
|
|
export PATH="$(dirname "$KTX_UV_BIN"):$PATH"
|
|
|
|
echo "Installing KTX Python dependencies..."
|
|
uv sync --all-packages --all-groups
|
|
|
|
echo "Installing KTX JS dependencies..."
|
|
pnpm install --frozen-lockfile --prefer-offline
|
|
|
|
echo "Rebuilding native JS dependencies..."
|
|
pnpm run native:rebuild
|
|
|
|
echo "Building KTX packages..."
|
|
pnpm run build
|
|
|
|
echo "Building KTX runtime artifacts..."
|
|
pnpm run artifacts:build
|
|
|
|
echo "Running KTX setup doctor..."
|
|
node packages/cli/dist/bin.js status --no-input
|
|
|
|
echo "=== Setup complete ==="
|