package ein:plugin;

// SPDX-License-Identifier: Apache-2.0
// Copyright 2026 Mason Stallmo

interface process {
    // Runs a shell command and returns its output.
    //
    // `timeout-seconds` bounds how long the command may run before it is
    // killed, and `none` takes the host's default. The host clamps it to its
    // own maximum.
    //
    // The host caps the output. A command killed at its deadline still returns
    // what it wrote before then, which usually shows why it hung.
    spawn: func(args: string, timeout-seconds: option<u32>) -> result<string, string>;
}