funera 0.3.0

Flexible and security-oriented LLM agent framework for Rust — ReAct loop, tools, skills, middleware, security
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

name: CD

on:
  workflow_dispatch:
    inputs:
      bump:
        description: 'Version bump level'
        required: true
        type: choice
        default: patch
        options:
          - patch
          - minor
          - major
      skip_bump:
        description: 'Skip version bump (publish current version only)'
        required: false
        type: boolean
        default: false

env:
  CARGO_TERM_COLOR: always

concurrency: release

jobs:
  release:
    environment: crates.io
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write

    steps:
      - uses: actions/checkout@v4
        with:
          token: ${{ secrets.GITHUB_TOKEN }}
          fetch-depth: 0

      - uses: Swatinem/rust-cache@v2

      - name: Configure git
        run: |
          git config user.name "github-actions[bot]"
          git config user.email "github-actions[bot]@users.noreply.github.com"

      - name: Install cargo-release
        uses: taiki-e/install-action@v2
        with:
          tool: cargo-release

      - name: Bump version
        if: ${{ !inputs.skip_bump }}
        run: cargo release ${{ inputs.bump }} --execute --no-confirm

      - name: Verify formatting
        run: cargo fmt --check --all

      - name: Run clippy
        run: cargo clippy --all-features -- -D warnings

      - name: Test funera_core
        run: cargo test --lib --all-features -p funera-core

      - name: Test funera-orchestrate
        run: cargo test --lib --features deepseek,tool,security,sandbox,middleware,skill,funera-builtin-tools -p funera-orchestrate

      - name: Build docs
        run: cargo doc --no-deps --all-features

      - name: Semver check
        uses: obi1kenobi/cargo-semver-checks-action@v2
        continue-on-error: true

      - name: Cleanup semver-check artifacts
        if: always()
        run: rm -rf semver-checks

      # `main` is protected by the `main-protect` ruleset (pushes must come
      # through a pull request; only repository admins may bypass), so a direct
      # `git push origin main` is declined. Instead: push the release commit to
      # a `release/vX.Y.Z` branch, open a PR, and merge it through the normal
      # protected flow. Tags are not protected and are pushed afterwards.
      - name: Open release PR and merge
        if: ${{ !inputs.skip_bump }}
        run: |
          # `cargo pkgid` yields `funera-core@X.Y.Z`; extract the bare version
          # so tags/branches are named vX.Y.Z (no `vfunera-core@` prefix).
          VERSION="$(cargo metadata --no-deps --format-version 1 | jq -r '.packages[] | select(.name == "funera-core") | .version')"
          BRANCH="release/v${VERSION}"
          git push origin "HEAD:${BRANCH}"
          PR_URL="$(gh pr create --base main --head "${BRANCH}" \
            --title "chore: release v${VERSION}" \
            --body "Automated release prepared by the CD workflow (version bump to v${VERSION}).")"
          gh pr merge --merge --delete-branch "${PR_URL}"
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

      - name: Push tag
        if: ${{ !inputs.skip_bump }}
        run: |
          VERSION="$(cargo metadata --no-deps --format-version 1 | jq -r '.packages[] | select(.name == "funera-core") | .version')"
          git push origin "refs/tags/v${VERSION}"

      - name: Publish funera_core
        run: cargo publish -p funera-core --token ${{ secrets.CARGO_REGISTRY_TOKEN }}

      - name: Publish funera_builtin_tools
        run: |
          sleep 15
          cargo publish -p funera-builtin-tools --token ${{ secrets.CARGO_REGISTRY_TOKEN }}

      - name: Publish funera-orchestrate
        run: |
          sleep 15
          cargo publish -p funera-orchestrate --token ${{ secrets.CARGO_REGISTRY_TOKEN }}

      - name: Publish funera (root crate)
        run: |
          sleep 15
          cargo publish --token ${{ secrets.CARGO_REGISTRY_TOKEN }}

      - name: Create GitHub Release
        run: |
          VERSION="$(cargo metadata --no-deps --format-version 1 | jq -r '.packages[] | select(.name == "funera-core") | .version')"
          git fetch --tags
          gh release create "v$VERSION" --generate-notes
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}