Skip to content

0.1.1

Latest

Choose a tag to compare

@github-actions github-actions released this 01 Nov 11:24
· 101 commits to master since this release

Added

  • Server() builds a server that passes tmux neither -L nor -S, so tmux
    picks the server: the one in TMUX inside tmux, and its default socket
    elsewhere. It takes tmuxExecutable, configurationFile and environment,
    the last being where the two variables are read from. LIBTMUX_SOCKET_PATH
    (passed as -S) or LIBTMUX_SOCKET (passed as -L) names another, the path
    wins when both are set, and a variable that is empty or only whitespace counts
    as unset. Server(socketPath:) and Server(socketName:) leave both
    variables unread. (#93)

Changed

  • Breaking. Endpoint gained a tmuxChoice case, which is the
    Server.endpoint of a server that names no socket. A switch over
    Endpoint that lists only .socketName and .socketPath stops compiling;
    add a case for it, and read a socket from an endpoint only when it has one.
    (#93)

  • tmux-workspace with no -S or -L uses the socket LIBTMUX_SOCKET_PATH
    and then LIBTMUX_SOCKET name, and with neither passes tmux no socket, where
    it used to pass the TMUX socket as -S and, outside tmux, refused to run.
    Outside tmux it now acts on tmux's default socket, which is your own server
    unless the environment says otherwise; name -L for a server of its own. An
    attached load inside tmux, load --append and freeze without a session
    name still use the TMUX socket, and shell passes tmuxp a socket a variable
    chose, because tmuxp reads neither variable. (#93)

  • Breaking. libtmux-mcp with neither socket variable passes tmux no
    socket and serves
    the server tmux picks, where it used to start a daemon of its own on the
    socket libtmux-mcp, from a bundled configuration, grant it teardown and
    stop it when stdio ended. That daemon, the bundled configuration and the
    default teardown are gone; name teardown in LIBTMUX_TOOLSETS to grant
    it. Setting both variables is no longer an error: the path wins. An empty
    variable no longer fails startup, it counts as unset. tmux://capabilities
    reports socket-path, socket-name or tmux-choice as socketProvenance,
    where it said operator-current or default-dedicated, and names the
    socket in attachCommand once a server runs. (#93)

  • Breaking. ServerConfiguration no longer has an
    isDefaultDedicatedMinimal property, and its socketName is nil unless
    LIBTMUX_SOCKET is set, where it was libtmux-mcp. ToolAuthority no
    longer takes or stores usedExplicitToolsets; drop the argument. (#93)

  • This package's own test run must be started with Scripts/swift-test, which
    takes swift test's arguments. It removes TMUX, TMUX_PANE and every
    LIBTMUX_SOCKET* variable, gives the run a private TMUX_TMPDIR under
    /tmp/libtmux-swift-test/, and stops any tmux server the run left behind,
    failing the run when it finds one. A bare swift test of this package is
    refused by the first fixture it reaches. A package that depends on
    TmuxFixture is held to the same rules only when its run sets
    LIBTMUX_TEST_SANDBOX, as the script does. (#92)

  • tmuxExecutablePath() in TmuxFixture takes LIBTMUX_TMUX_BIN, then the
    first tmux on PATH, then /usr/bin/tmux, /usr/local/bin/tmux and
    /opt/homebrew/bin/tmux. It used to skip PATH and take the first of those
    three, so a suite started without the variable tested /usr/bin/tmux even
    when a newer tmux came first on PATH, and cases that need a newer tmux
    skipped. A bare name in the variable is now searched for on PATH, as
    Server searches for its tmuxExecutable. Set LIBTMUX_TMUX_BIN to keep
    testing one binary. (#96)

  • JSON layouts (layout-json) require tmux 3.8, the first release that
    accepts one. Server.selectLayout(_:_:), Server.validateLayouts(_:) and
    the MCP select_layout tool refuse one on an older tmux before the layout
    command is sent. A version probe may run first. The refusal names tmux 3.8
    as the minimum; upgrade to tmux 3.8 to apply a JSON layout.

    A raw select-layout, including one sent over a ControlSession, now
    refuses a JSON layout before it is sent on tmux below 3.8, and a malformed
    { operand on tmux 3.4 through versions below 3.8; tmux used to reject
    both after the send. (#82)

  • CI tests tmux 3.3a and 3.8 on a push and a pull request. A tag, which is a
    release, and a workflow_dispatch with scope: full test every release
    from 3.3a through 3.8, the pinned master and the refusal lanes. A dispatch
    also takes tmux-ref (a release, tag, branch or commit), swift and
    tmate, and the required job reports whether every planned job passed.
    (#89)