Skip to main content

mcp_twill/
lib.rs

1//! Build MCP servers from one authoritative catalog of typed operations.
2//!
3//! Twill compiles command declarations into planning, native MCP surfaces,
4//! help, schemas, permissions, resources, tasks, results, and host-facing
5//! projections. Structured arguments remain JSON values; command templates
6//! only place those values into CLI-shaped operation syntax and never become
7//! shell programs.
8
9pub mod ambient_resources;
10pub mod argument_schemas;
11pub mod builder;
12pub mod catalog;
13pub mod contract;
14pub mod conversation_identity;
15pub mod error;
16pub mod event;
17pub mod help;
18pub mod model;
19pub mod native_surfaces;
20pub mod presentation;
21pub mod registry;
22pub mod resource;
23pub mod response;
24pub mod results;
25pub mod rmcp_adapter;
26pub mod runtime;
27pub mod stateless;
28mod stateless_wire;
29pub mod tasks;
30mod tasks_extension_wire;
31pub mod template;
32pub mod types;
33
34pub use ambient_resources::*;
35pub use argument_schemas::*;
36pub use builder::*;
37pub use catalog::*;
38pub use contract::{
39    ContractViolation, check_confirmation_projection, check_native_surface_projection,
40    check_resource_binding_projection, verify_catalog_coverage,
41};
42pub use conversation_identity::{
43    CONVERSATION_IDENTITY_META_KEY, ConversationIdentity, InvocationContext,
44};
45pub use error::{FrameworkError, PreResolvedWorkspaceProblem, Result, WorkspaceMetadataProblem};
46pub use event::{EventSink, FrameworkEvent, InMemoryEventSink, NoopEventSink, PlanFacts};
47pub use help::{HelpDetail, HelpRequest, HelpResult, HelpTopic};
48pub use mcp_workspace_resolver::{
49    HostWorkspaceRoot, HostWorkspaceRootError, HostWorkspaceRootsObservation,
50};
51pub use model::*;
52pub use native_surfaces::*;
53pub use presentation::*;
54pub use registry::{CommandHandler, CommandRegistry, HandlerFuture};
55pub use resource::{
56    Grant, Granted, Listed, Listing, ReadResource, Release, Res, ResolveResource,
57    ResolvedResources, Resource, ResourceOutput, ResourceRefusal,
58};
59pub use response::*;
60pub use results::*;
61pub use rmcp_adapter::{
62    CliMcpServer, CliMcpServerConfig, ConversationIdentityCompatibility,
63    HostNativeConfirmationMode, HostNativeExecution, HostNativeExecutionOutcome,
64    NativeMcpInitializeProjection, NativeMcpServerIdentity, WorkspaceMetadataCompatibility,
65};
66pub use runtime::RuntimeIdentity;
67pub use stateless::{StatelessMcpHttpBody, StatelessMcpHttpService, StatelessMcpService};
68pub use tasks::*;
69pub use template::{CommandTemplate, TemplateToken};
70pub use types::{Field, FieldShape, TypeDecl, Variant};