1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
//! Platform-agnostic asset loading for MCP servers.
//!
//! This module provides a unified API for loading assets (files, resources, databases)
//! that works across all deployment targets: local development, AWS Lambda,
//! Google Cloud Run, and Cloudflare Workers.
//!
//! # Overview
//!
//! Assets are files bundled with your MCP server deployment. Common use cases:
//! - `SQLite` databases
//! - Markdown resource files
//! - Configuration files
//! - Prompt templates
//! - Static data files
//!
//! # Configuration
//!
//! Assets are configured in `pmcp.toml`:
//!
//! ```toml
//! [deploy.assets]
//! include = [
//! "chinook.db",
//! "resources/**/*.md",
//! "config/*.toml",
//! ]
//! exclude = ["**/*.tmp"]
//! ```
//!
//! # Usage
//!
//! ```rust,ignore
//! use pmcp::assets;
//!
//! // Load asset as bytes
//! let db_bytes = assets::load("chinook.db")?;
//!
//! // Load asset as string (UTF-8)
//! let guide = assets::load_string("resources/guide.md")?;
//!
//! // Get filesystem path (extracts to temp on serverless platforms)
//! let db_path = assets::path("chinook.db")?;
//! let conn = Connection::open(&db_path)?;
//!
//! // Check if asset exists
//! if assets::exists("config/override.toml") {
//! let config = assets::load_string("config/override.toml")?;
//! }
//!
//! // List assets matching a pattern
//! for asset in assets::list("resources/**/*.md")? {
//! println!("Found: {}", asset);
//! }
//! ```
//!
//! # Platform Behavior
//!
//! | Platform | Asset Location | `path()` Behavior |
//! |----------|----------------|-------------------|
//! | Local dev | Workspace root | Returns original path |
//! | AWS Lambda | `$LAMBDA_TASK_ROOT` | Returns path in package |
//! | Cloud Run | `/app/assets/` | Returns path in image |
//! | Cloudflare | Bundled/KV | Extracts to memory/temp |
//!
//! # Performance
//!
//! - Assets loaded via `load()` are cached in memory after first access
//! - The `path()` function extracts embedded assets to a temp directory once
//! - Use `load()` for small files, `path()` for large files or when a path is required
pub use ;
/// Result type for asset operations.
pub type Result<T> = Result;