systemprompt-api 0.51.0

//! Bridge plugin-file endpoint (`GET /v1/bridge/plugins/{id}/{*path}`).
//!
//! Bytes are assembled live from the same `plugin_bundles` pipeline the gateway
//! hashes into the signed manifest, so every file the bridge fetches is
//! byte-identical to its manifest hash. Serving a pre-generated static plugin
//! tree here would drift from that hash and fail bridge-side verification.
//!
//! Copyright (c) systemprompt.io — Business Source License 1.1.
//! See <https://systemprompt.io> for licensing details.

use std::path::{Component, Path};
use std::sync::Arc;

use axum::body::Body;
use axum::extract::Path as AxumPath;
use axum::http::{HeaderMap, StatusCode, header};
use axum::response::Response;
use systemprompt_config::ProfileBootstrap;
use systemprompt_identifiers::JwtToken;
use systemprompt_marketplace::{CatalogContent, ManifestService, NoopTrace, plugin_bundles_cached};
use systemprompt_models::bridge::ids::PluginId;
use systemprompt_models::services::ServicesConfig;
use systemprompt_runtime::AppContext;

use super::bridge_data;
use super::messages::extract_credential;
use crate::services::middleware::JwtContextExtractor;

type HttpError = (StatusCode, String);

pub async fn handle(
    jwt_extractor: Arc<JwtContextExtractor>,
    ctx: AppContext,
    headers: HeaderMap,
    AxumPath((plugin_id, relative_path)): AxumPath<(String, String)>,
) -> Result<Response, HttpError> {
    let user = authenticate(&jwt_extractor, &headers).await?;

    if !relative_path_is_safe(&relative_path) {
        tracing::warn!(
            plugin_id = %plugin_id,
            path = %relative_path,
            "bridge: rejected non-canonical plugin file path"
        );
        return Err((StatusCode::BAD_REQUEST, "Invalid path".to_owned()));
    }

    let id = PluginId::try_new(&plugin_id).map_err(|e| {
        tracing::debug!(error = %e, plugin_id = %plugin_id, "bridge: malformed plugin id");
        (StatusCode::NOT_FOUND, "Plugin not found".to_owned())
    })?;

    let services = bridge_data::load_services_config().map_err(|e| internal("services", &e))?;
    let profile = ProfileBootstrap::get().map_err(|e| internal("profile", &e))?;
    let catalog = CatalogContent::load_cached(
        &services,
        ctx.app_paths().system().services(),
        &profile.server.api_external_url,
    )
    .map_err(|e| internal("catalog", &e))?;

    if !plugin_is_granted(&ctx, &services, &catalog, &id, &user.id).await? {
        tracing::warn!(
            plugin_id = %plugin_id,
            user_id = %user.id,
            "bridge: refused a plugin bundle the caller was not granted"
        );
        return Err((StatusCode::NOT_FOUND, "Plugin not found".to_owned()));
    }

    let bundles = plugin_bundles_cached(&services, &catalog.as_content())
        .map_err(|e| internal("bundle", &e))?;
    let bundle = bundles
        .get(&id)
        .ok_or_else(|| (StatusCode::NOT_FOUND, "Plugin not found".to_owned()))?;
    let file = bundle
        .get(relative_path.as_str())
        .ok_or_else(|| (StatusCode::NOT_FOUND, "File not found".to_owned()))?;

    let mut response = Response::new(Body::from(file.bytes.clone()));
    response.headers_mut().insert(
        header::CONTENT_TYPE,
        header::HeaderValue::from_static(content_type(&relative_path)),
    );
    Ok(response)
}

fn internal(stage: &'static str, e: &dyn std::fmt::Display) -> HttpError {
    tracing::error!(error = %e, stage, "bridge: plugin bundle assembly failed");
    (
        StatusCode::INTERNAL_SERVER_ERROR,
        "Plugin bundle unavailable".to_owned(),
    )
}

async fn authenticate(
    jwt_extractor: &JwtContextExtractor,
    headers: &HeaderMap,
) -> Result<systemprompt_traits::AuthUser, HttpError> {
    let credential = extract_credential(headers).ok_or_else(|| {
        (
            StatusCode::UNAUTHORIZED,
            "Missing Authorization or x-api-key credential".to_owned(),
        )
    })?;
    jwt_extractor
        .decode_for_gateway(&JwtToken::new(credential))
        .await
        .map(|(_, user)| user)
        .map_err(|e| (StatusCode::UNAUTHORIZED, e.to_string()))
}

async fn plugin_is_granted(
    ctx: &AppContext,
    services: &ServicesConfig,
    catalog: &CatalogContent,
    plugin_id: &PluginId,
    user_id: &systemprompt_identifiers::UserId,
) -> Result<bool, HttpError> {
    let candidate = ManifestService::assemble_candidate_from_catalog(
        catalog.clone(),
        services,
        ctx.app_paths().system().services(),
        ctx.marketplace_filter().as_ref(),
        user_id,
        &mut NoopTrace,
    )
    .await
    .map_err(|e| internal("candidate", &e))?;

    Ok(candidate.plugins.iter().any(|p| &p.id == plugin_id))
}

pub fn relative_path_is_safe(relative: &str) -> bool {
    !relative.is_empty()
        && Path::new(relative)
            .components()
            .all(|c| matches!(c, Component::Normal(_) | Component::CurDir))
}

pub fn content_type(relative_path: &str) -> &'static str {
    systemprompt_models::mime::http_content_type(Path::new(relative_path))
}