Files
common-workflow/.github/workflows/agent-marketplace-release.yaml
T

244 lines
8.2 KiB
YAML

name: Agent marketplace release
on:
workflow_call:
inputs:
target_branch:
description: Branch that receives release-please changes.
required: false
type: string
default: main
skill_root:
description: Canonical skill directory relative to the repository root.
required: false
type: string
default: skills
claude_marketplace_file:
description: Claude marketplace manifest relative to the repository root.
required: false
type: string
default: .claude-plugin/marketplace.json
claude_plugin_file:
description: Claude plugin manifest relative to the repository root.
required: false
type: string
default: .claude-plugin/plugin.json
codex_plugin_root:
description: Codex plugin root relative to the repository root.
required: false
type: string
default: plugins/marketplace
cursor_plugin_root:
description: Cursor plugin root relative to the repository root.
required: false
type: string
default: plugins/marketplace
release_config_file:
description: Release Please configuration file.
required: false
type: string
default: release-please-config.json
release_manifest_file:
description: Release Please manifest file.
required: false
type: string
default: .release-please-manifest.json
package_paths:
description: Space-separated paths to package into the release archive.
required: false
type: string
default: skills .claude-plugin .cursor-plugin .agents plugins README.md CHANGELOG.md
archive_name:
description: Prefix used for the release archive.
required: false
type: string
default: agent-marketplace
claude_plugin_name:
description: Claude plugin name used in the installation summary.
required: false
type: string
default: marketplace
claude_marketplace_name:
description: Claude marketplace name used in the installation summary.
required: false
type: string
default: marketplace
codex_marketplace_name:
description: Codex marketplace name shown in the installation summary.
required: false
type: string
default: marketplace
cursor_plugin_name:
description: Cursor plugin name shown in the installation summary.
required: false
type: string
default: marketplace
publish_gitea:
description: Upload the released archive to Gitea and write its URL to the summary.
required: false
type: boolean
default: false
gitea_url:
description: Base URL of the Gitea instance.
required: false
type: string
default: ""
gitea_user:
description: Gitea user or organization that owns the generic package.
required: false
type: string
default: ""
secrets:
GITHUB_PAT:
description: Optional GitHub token for release-please pull requests.
required: false
GITEA_TOKEN:
description: Gitea token with permission to publish generic packages.
required: false
permissions:
contents: write
pull-requests: write
concurrency:
group: release-please
cancel-in-progress: false
jobs:
release-please:
runs-on: ubuntu-latest
outputs:
release_created: ${{ steps.release.outputs.release_created }}
tag_name: ${{ steps.release.outputs.tag_name }}
version: ${{ steps.release.outputs.version }}
steps:
- name: Create or update release PR
id: release
uses: googleapis/release-please-action@v4
with:
token: ${{ secrets.GITHUB_PAT || github.token }}
target-branch: ${{ inputs.target_branch }}
config-file: ${{ inputs.release_config_file }}
manifest-file: ${{ inputs.release_manifest_file }}
publish:
needs: release-please
if: needs.release-please.outputs.release_created == 'true'
runs-on: ubuntu-latest
permissions:
contents: write
steps:
- name: Check out released version
uses: actions/checkout@v4
with:
ref: ${{ needs.release-please.outputs.tag_name }}
- name: Validate released marketplace
uses: walter-base/common-workflow/actions/validate-agent-marketplace@master
with:
skill_root: ${{ inputs.skill_root }}
claude_marketplace_file: ${{ inputs.claude_marketplace_file }}
claude_plugin_file: ${{ inputs.claude_plugin_file }}
codex_plugin_root: ${{ inputs.codex_plugin_root }}
cursor_plugin_root: ${{ inputs.cursor_plugin_root }}
- name: Build release archive
env:
VERSION: ${{ needs.release-please.outputs.version }}
PACKAGE_PATHS: ${{ inputs.package_paths }}
ARCHIVE_NAME: ${{ inputs.archive_name }}
shell: bash
run: |
dir="${ARCHIVE_NAME}-${VERSION}"
mkdir -p "dist/${dir}"
for path in ${PACKAGE_PATHS}; do
cp -R "$path" "dist/${dir}/"
done
tar -czf "dist/${dir}.tar.gz" -C dist "${dir}"
- name: Upload archive to Gitea
if: inputs.publish_gitea
env:
ARCHIVE_NAME: ${{ inputs.archive_name }}
GITEA_URL: ${{ inputs.gitea_url }}
GITEA_USER: ${{ inputs.gitea_user }}
GITEA_TOKEN: ${{ secrets.GITEA_TOKEN }}
VERSION: ${{ needs.release-please.outputs.version }}
run: |
: "${GITEA_URL:?Set gitea_url when publish_gitea is enabled}"
: "${GITEA_USER:?Set gitea_user when publish_gitea is enabled}"
: "${GITEA_TOKEN:?Pass GITEA_TOKEN when publish_gitea is enabled}"
archive="${ARCHIVE_NAME}-${VERSION}.tar.gz"
package_url="${GITEA_URL%/}/api/packages/${GITEA_USER}/generic/${ARCHIVE_NAME}/${VERSION}/${archive}"
curl --fail-with-body --retry 3 \
--user "${GITEA_USER}:${GITEA_TOKEN}" \
--upload-file "dist/${archive}" \
"$package_url"
cat >> "$GITHUB_STEP_SUMMARY" <<EOF
# Agent Marketplace ${VERSION}
Download the marketplace archive from Gitea:
${package_url}
```bash
curl --user "GITEA_USER:GITEA_TOKEN" \\
--output "${archive}" \\
"${package_url}"
```
EOF
- name: Upload archive to GitHub Release
if: ${{ !inputs.publish_gitea }}
uses: softprops/action-gh-release@v2
with:
tag_name: ${{ needs.release-please.outputs.tag_name }}
files: dist/${{ inputs.archive_name }}-*.tar.gz
- name: Write GitHub installation summary
if: ${{ !inputs.publish_gitea }}
env:
VERSION: ${{ needs.release-please.outputs.version }}
TAG: ${{ needs.release-please.outputs.tag_name }}
REPOSITORY: ${{ github.repository }}
SERVER_URL: ${{ github.server_url }}
SKILL_ROOT: ${{ inputs.skill_root }}
CLAUDE_PLUGIN_NAME: ${{ inputs.claude_plugin_name }}
CLAUDE_MARKETPLACE_NAME: ${{ inputs.claude_marketplace_name }}
CODEX_MARKETPLACE_NAME: ${{ inputs.codex_marketplace_name }}
CURSOR_PLUGIN_NAME: ${{ inputs.cursor_plugin_name }}
run: |
cat >> "$GITHUB_STEP_SUMMARY" <<EOF
# Agent marketplace ${VERSION}
Release tag: \`${TAG}\`
## Claude Code
```bash
claude plugin marketplace add ${REPOSITORY}@${TAG}
claude plugin install ${CLAUDE_PLUGIN_NAME}@${CLAUDE_MARKETPLACE_NAME}
```
## Codex
```bash
codex plugin marketplace add ${REPOSITORY} --ref ${TAG}
codex
# In Codex, run: /plugins and install ${CODEX_MARKETPLACE_NAME}.
```
## OpenCode
```bash
npx skills add ${SERVER_URL}/${REPOSITORY}/tree/${TAG}/${SKILL_ROOT} --agent opencode --skill '*'
```
## Cursor
```bash
npx skills add ${SERVER_URL}/${REPOSITORY}/tree/${TAG}/${SKILL_ROOT} --agent cursor --skill '*'
```
EOF