Lenso portable Plugin Runtime SDK

This crate is the domain-neutral lowering layer used by product SDKs. It turns one generated JSON Capability dispatcher into a Wasm Component or a trusted Process implementation. It intentionally contains no Agent Tool, Ingress, authentication, or other product semantics.

Plugin projects normally depend on it through the lenso facade name:

[dependencies]
lenso = { package = "lenso-plugin-sdk", version = "0.4.6" }

Migrating from 0.1

Version 0.1 incorrectly exposed Agent-specific AgentTool and export_agent_tool! interfaces from the Runtime SDK. Those interfaces were removed rather than retained as compatibility aliases. Agent Tool authors use the product SDK and the same annotations as a linked native Plugin:

#[lenso::plugin]
#[derive(Clone, Copy, Debug, Default)]
struct TextTools {}

#[lenso_agent_tool_sdk::tool_provider]
impl TextTools {
    #[tool(
        name = "uppercase",
        description = "Convert text to uppercase.",
        execution = "parallel_safe"
    )]
    fn uppercase(arguments: Arguments) -> Result<ExecuteResponse, ExecuteError> {
        // Business implementation.
    }
}

Cargo metadata selects wasm, process, or both outputs. Plugin business code does not implement transport framing or a target-specific Agent Tool trait.

Native Process output uses the complete-object lenso.process-stdio@2 profile. Generated glue validates Host initialization, constructs one Plugin object, reports invocation settlement separately from its result, and attempts stop once after the Host drains admitted work. --lenso-describe prints the generated descriptor for build tooling without starting the runtime session.

Plugins with dependencies construct one complete object from exact named routes. The Capability client is generated from the contract, so business code does not copy Capability identities or route IDs:

const REQUIREMENTS: &[lenso::Requirement] = &[
    lenso::Requirement::one::<DocumentStoreClient>("destination"),
    lenso::Requirement::one::<DocumentStoreClient>("source"),
];

struct SyncPlugin {
    source: DocumentStoreClient,
    destination: DocumentStoreClient,
}

impl lenso::Plugin for SyncPlugin {
    const CONFIGURATION_SCHEMA: Option<&'static str> =
        Some(include_str!("../sync-config.schema.json"));

    fn requirements() -> &'static [lenso::Requirement] {
        REQUIREMENTS
    }

    fn create(context: lenso::CreateContext) -> Result<Self, String> {
        Ok(Self {
            source: context.dependencies().one("source")?.client()?,
            destination: context.dependencies().one("destination")?.client()?,
        })
    }

    fn stop(&self, context: lenso::Ctx) -> Result<(), String> {
        // Optional cleanup through the same exact dependency routes.
        Ok(())
    }
}

Each provider invocation receives a fresh lenso::Ctx; dependency calls inherit that invocation's cancellation, budget, permissions, and parent scope. Process Plugins publish CONFIGURATION_SCHEMA and support these named outbound calls. The current Wasm export remains for Plugins without configuration or dependencies until its Host Imports world is upgraded to the same Authoring V2 contract.