swink-agent 0.8.0

Core scaffolding for running LLM-powered agentic loops
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171

name: CI

on:
  push:
    branches: [main]
  pull_request:
  schedule:
    # MSRV check: weekly Monday 6am UTC. Rarely breaks from normal changes;
    # catching it weekly is enough. Also runs on main pushes (releases).
    - cron: '0 6 * * 1'

jobs:
  # ── Primary gate: runs on every PR and main push ────────────────────────
  check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6

      - uses: dtolnay/rust-toolchain@29eef336d9b2848a0b548edc03f92a220660cdb8 # stable
        with:
          components: clippy, rustfmt

      - uses: Swatinem/rust-cache@e18b497796c12c097a38f9edb9d0641fb99eee32 # v2

      - run: cargo fmt --check

      - name: Spell check
        uses: crate-ci/typos@cf5f1c29a8ac336af8568821ec41919923b05a83 # v1

      - run: cargo clippy --workspace -- -D warnings

      - uses: cargo-bins/cargo-binstall@f8ce4d55b131f4a1e373b8747ca6b6a54133ae5a # v1.18.0

      - run: cargo binstall --no-confirm --force --locked cargo-nextest

      - run: cargo nextest run --workspace

      - name: Test (testkit features)
        run: cargo test --workspace --features testkit

      - run: cargo build --examples --workspace

      - run: cargo test --workspace --doc

      - run: cargo test -p swink-agent --no-default-features

      - name: Check docs
        run: cargo doc --no-deps --workspace
        env:
          RUSTDOCFLAGS: "-D warnings"

  # ── Feature matrix: consolidated from features + feature-smoke + all-features ─
  features:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6

      - uses: dtolnay/rust-toolchain@29eef336d9b2848a0b548edc03f92a220660cdb8 # stable

      - uses: Swatinem/rust-cache@e18b497796c12c097a38f9edb9d0641fb99eee32 # v2

      - uses: cargo-bins/cargo-binstall@f8ce4d55b131f4a1e373b8747ca6b6a54133ae5a # v1.18.0

      - run: cargo binstall --no-confirm --force cargo-hack

      # Each-feature check (excludes local-llm: metal/accelerate/mkl need macOS)
      - name: cargo hack (each feature)
        run: cargo hack check --workspace --each-feature --no-dev-deps --exclude swink-agent-local-llm

      # Feature-smoke sentinels
      - name: Adapters no-default-features sentinel
        run: cargo test -p swink-agent-adapters --no-default-features --test no_default_features

      - name: Adapters anthropic feature smoke
        run: cargo check -p swink-agent-adapters --no-default-features --features anthropic

      - name: Adapters gemini feature smoke
        run: cargo check -p swink-agent-adapters --no-default-features --features gemini

      - name: Local LLM no-default-features sentinel
        run: cargo test -p swink-agent-local-llm --no-default-features --test no_default_features

      - name: Local LLM gemma4 feature smoke
        run: cargo check -p swink-agent-local-llm --no-default-features --features gemma4

      # All-features workspace test
      - name: Test (all features)
        run: cargo test --workspace --all-features --exclude swink-agent-local-llm

      - name: Build policies example (all features)
        run: cargo build -p swink-agent-policies --all-features --example with_policies

      - name: Build TUI example (all features)
        run: cargo build -p swink-agent-tui --all-features --example custom_agent

  # ── Dependency policy ───────────────────────────────────────────────────
  deny:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6

      - uses: EmbarkStudios/cargo-deny-action@175dc7fd4fb85ec8f46948fb98f44db001149081 # v2

  # ── Platform smoke: macOS + Windows on main push only ───────────────────
  # PRs are validated on Ubuntu; cross-platform issues are caught on the
  # post-merge main push. Saves ~10 min of runner time per PR.
  check-platform:
    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
    strategy:
      fail-fast: false
      matrix:
        os: [macos-latest, windows-latest]
    runs-on: ${{ matrix.os }}
    steps:
      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6

      - uses: dtolnay/rust-toolchain@29eef336d9b2848a0b548edc03f92a220660cdb8 # stable
        with:
          components: clippy, rustfmt

      - uses: Swatinem/rust-cache@e18b497796c12c097a38f9edb9d0641fb99eee32 # v2

      - run: cargo fmt --check

      - run: cargo clippy --workspace -- -D warnings

      - uses: cargo-bins/cargo-binstall@f8ce4d55b131f4a1e373b8747ca6b6a54133ae5a # v1.18.0

      - run: cargo binstall --no-confirm --force cargo-nextest

      - run: cargo nextest run --workspace

      - run: cargo test --workspace --doc

      - name: Check docs
        run: cargo doc --no-deps --workspace
        env:
          RUSTDOCFLAGS: "-D warnings"

  # ── Semver: only on main push (release boundary) ────────────────────────
  semver:
    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6

      - uses: dtolnay/rust-toolchain@29eef336d9b2848a0b548edc03f92a220660cdb8 # stable

      - uses: Swatinem/rust-cache@e18b497796c12c097a38f9edb9d0641fb99eee32 # v2

      - uses: cargo-bins/cargo-binstall@f8ce4d55b131f4a1e373b8747ca6b6a54133ae5a # v1.18.0

      - run: cargo binstall --no-confirm --force cargo-semver-checks

      - name: Fetch main branch for baseline
        run: git fetch origin main

      - run: cargo semver-checks --workspace --exclude swink-agent-local-llm --baseline-rev origin/main

  # ── MSRV: weekly schedule + main push ───────────────────────────────────
  msrv:
    if: github.event_name == 'schedule' || (github.event_name == 'push' && github.ref == 'refs/heads/main')
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6

      - uses: dtolnay/rust-toolchain@98e1b82157cd469e843cb7f524c1313b4ad9492c # 1.88

      - uses: Swatinem/rust-cache@e18b497796c12c097a38f9edb9d0641fb99eee32 # v2

      - run: cargo build --workspace