Extension System

# extension.toml
id = "my-extension"
name = "My Extension"
version = "0.1.0"
schema_version = 1
description = "A custom extension for Glass"
repository = "https://github.com/user/my-extension"
authors = ["Your Name <[email protected]>"]

// From crates/extension/src/extension_manifest.rs
pub struct ExtensionManifest {
    pub id: Arc<str>,
    pub name: String,
    pub version: Arc<str>,
    pub schema_version: SchemaVersion,
    pub description: Option<String>,
    pub repository: Option<String>,
    pub authors: Vec<String>,
    // ...
}

pub fn provides(&self) -> BTreeSet<ExtensionProvides> {
    // Returns set of features this extension provides
}

pub enum ExtensionProvides {
    Themes,
    IconThemes,
    Languages,
    Grammars,
    LanguageServers,
    ContextServers,
    AgentServers,
    Snippets,
    DebugAdapters,
}

# extension.toml
[[languages]]
path = "languages/rust.json"

// languages/rust.json
{
  "name": "Rust",
  "grammar": "rust",
  "path_suffixes": ["rs"],
  "line_comments": ["// "],
  "block_comment": ["/* ", " */"]
}

[grammars.rust]
repository = "https://github.com/tree-sitter/tree-sitter-rust"
commit = "v0.20.4"

[language_servers.rust-analyzer]
name = "rust-analyzer"
languages = ["Rust"]

// From crates/extension/src/extension.rs
async fn language_server_command(
    &self,
    language_server_id: LanguageServerName,
    language_name: LanguageName,
    worktree: Arc<dyn WorktreeDelegate>,
) -> Result<Command>

async fn language_server_initialization_options(
    &self,
    language_server_id: LanguageServerName,
    language_name: LanguageName,
    worktree: Arc<dyn WorktreeDelegate>,
) -> Result<Option<String>>

async fn language_server_workspace_configuration(
    &self,
    language_server_id: LanguageServerName,
    worktree: Arc<dyn WorktreeDelegate>,
) -> Result<Option<String>>

async fn language_server_additional_initialization_options(
    &self,
    language_server_id: LanguageServerName,
    target_language_server_id: LanguageServerName,
    worktree: Arc<dyn WorktreeDelegate>,
) -> Result<Option<String>>

themes = ["themes/my-theme.json"]
icon_themes = ["icon-themes/my-icons.json"]

snippets = "snippets"
# or
snippets = ["snippets/rust.json", "snippets/common.json"]

pub enum ExtensionSnippets {
    Single(PathBuf),
    Multiple(Vec<PathBuf>),
}

[debug_adapters.lldb]
name = "lldb-dap"
languages = ["Rust", "C", "C++"]

async fn get_dap_binary(
    &self,
    dap_name: Arc<str>,
    config: DebugTaskDefinition,
    user_installed_path: Option<PathBuf>,
    worktree: Arc<dyn WorktreeDelegate>,
) -> Result<DebugAdapterBinary>

async fn dap_request_kind(
    &self,
    dap_name: Arc<str>,
    config: serde_json::Value,
) -> Result<StartDebuggingRequestArgumentsRequest>

[slash_commands.my-command]
name = "my-command"
description = "Custom slash command"

async fn run_slash_command(
    &self,
    command: SlashCommand,
    arguments: Vec<String>,
    worktree: Option<Arc<dyn WorktreeDelegate>>,
) -> Result<SlashCommandOutput>

async fn complete_slash_command_argument(
    &self,
    command: SlashCommand,
    arguments: Vec<String>,
) -> Result<Vec<SlashCommandArgumentCompletion>>

[context_servers.my-context]
command = "./context-server"

async fn context_server_command(
    &self,
    context_server_id: Arc<str>,
    project: Arc<dyn ProjectDelegate>,
) -> Result<Command>

async fn context_server_configuration(
    &self,
    context_server_id: Arc<str>,
    project: Arc<dyn ProjectDelegate>,
) -> Result<Option<ContextServerConfiguration>>

pub fn allow_exec(
    &self,
    desired_command: &str,
    desired_args: &[impl AsRef<str> + std::fmt::Debug],
) -> Result<()>

[[capabilities]]
type = "process-exec"
command = "node"
args = ["--version"]

// From extension capabilities
pub enum ExtensionCapability {
    ProcessExec(ProcessExecCapability),
    NpmInstallPackage(NpmInstallPackageCapability),
    DownloadFile(DownloadFileCapability),
}

pub fn parse_wasm_extension_version(
    extension_id: &str,
    wasm_bytes: &[u8]
) -> Result<Version>

// Custom section: zed:api-version
// Contains the API version the extension was built against

// From extension_events
pub fn init(cx: &mut App)