The Memory Layer for AI Agents - Drop-in memory infrastructure for AI agents and apps. Context that persists. Built for production.
Python agentic-memoryagentic-memory-systemagentsaiai-agentschatgptgenaillmlong-term-memorymemorymemory-managementpythonragstate-management
ci: route all release publishing through a single Release Router workflow (#5475)
Saket Aryan437f0b5495f5
diff --git a/.github/workflows/cd.yml b/.github/workflows/cd.ymlindex efb7c958b..c7346b52f 100644--- a/.github/workflows/cd.yml+++ b/.github/workflows/cd.yml@@ -1,20 +1,33 @@name: Publish Python π distributions π¦ to PyPI and TestPyPI+# Dispatched by release.yml (Release Router) when a release tagged v* is+# published. Can also be dispatched manually to re-publish a tag.on:- release:- types: [published]+ workflow_dispatch:+ inputs:+ tag:+ description: 'Release tag to build and publish (e.g. v1.2.3)'+ required: true+ type: string+ prerelease:+ description: 'Unused for PyPI (pre-releases are expressed in the version itself); accepted for router uniformity'+ required: false+ type: boolean+ default: falsejobs:build-n-publish:name: Build and publish Python π distributions π¦ to PyPI and TestPyPI# Pure SDK version tags only (v1.2.3) β excludes package-prefixed tags# like vercel-ai-v* that also start with 'v'- if: startsWith(github.event.release.tag_name, 'v') && !contains(github.event.release.tag_name, '-v')+ if: startsWith(inputs.tag, 'v') && !contains(inputs.tag, '-v')runs-on: ubuntu-latestpermissions:id-token: writesteps:- uses: actions/checkout@v2+ with:+ ref: ${{ inputs.tag }}- name: Set up Pythonuses: actions/setup-python@v2@@ -41,7 +54,6 @@ jobs:# packages_dir: dist/- name: Publish distribution π¦ to PyPI- if: startsWith(github.ref, 'refs/tags/v') && !contains(github.ref, '-v')uses: pypa/gh-action-pypi-publish@release/v1with:packages_dir: dist/diff --git a/.github/workflows/cli-node-cd.yml b/.github/workflows/cli-node-cd.ymlindex c583abb52..35694b6ff 100644--- a/.github/workflows/cli-node-cd.yml+++ b/.github/workflows/cli-node-cd.yml@@ -1,13 +1,25 @@name: Publish @mem0/cli π¦ to npm+# Dispatched by release.yml (Release Router) when a release tagged+# cli-node-v* is published. Can also be dispatched manually to re-publish+# a tag.on:- release:- types: [published]+ workflow_dispatch:+ inputs:+ tag:+ description: 'Release tag to build and publish (e.g. cli-node-v0.2.0)'+ required: true+ type: string+ prerelease:+ description: 'Publish under the version preid dist-tag instead of latest'+ required: false+ type: boolean+ default: falsejobs:build-n-publish:name: Build and publish @mem0/cli π¦ to npm- if: startsWith(github.event.release.tag_name, 'cli-node-v')+ if: startsWith(inputs.tag, 'cli-node-v')runs-on: ubuntu-latestpermissions:id-token: write@@ -16,6 +28,8 @@ jobs:working-directory: cli/nodesteps:- uses: actions/checkout@v4+ with:+ ref: ${{ inputs.tag }}- name: Install pnpmuses: pnpm/action-setup@v4@@ -38,7 +52,7 @@ jobs:- name: Publish to npmrun: |- if [ "${{ github.event.release.prerelease }}" = "true" ]; then+ if [ "${{ inputs.prerelease }}" = "true" ]; thenPREID=$(node -p "require('./package.json').version.split('-')[1].split('.')[0]")npx npm@latest publish --provenance --access public --tag "$PREID"elsediff --git a/.github/workflows/cli-python-cd.yml b/.github/workflows/cli-python-cd.ymlindex 316bc1df2..b0ef33144 100644--- a/.github/workflows/cli-python-cd.yml+++ b/.github/workflows/cli-python-cd.yml@@ -1,13 +1,24 @@name: Publish mem0-cli π distributions π¦ to PyPI+# Dispatched by release.yml (Release Router) when a release tagged cli-v* is+# published. Can also be dispatched manually to re-publish a tag.on:- release:- types: [published]+ workflow_dispatch:+ inputs:+ tag:+ description: 'Release tag to build and publish (e.g. cli-v0.2.0)'+ required: true+ type: string+ prerelease:+ description: 'Unused for PyPI (pre-releases are expressed in the version itself); accepted for router uniformity'+ required: false+ type: boolean+ default: falsejobs:build-n-publish:name: Build and publish mem0-cli π¦ to PyPI- if: startsWith(github.event.release.tag_name, 'cli-v')+ if: startsWith(inputs.tag, 'cli-v')runs-on: ubuntu-latestpermissions:id-token: write@@ -16,6 +27,8 @@ jobs:working-directory: cli/pythonsteps:- uses: actions/checkout@v4+ with:+ ref: ${{ inputs.tag }}- name: Set up Pythonuses: actions/setup-python@v5diff --git a/.github/workflows/openclaw-cd.yml b/.github/workflows/openclaw-cd.ymlindex 8a0d0e7e0..cc9aaf874 100644--- a/.github/workflows/openclaw-cd.yml+++ b/.github/workflows/openclaw-cd.yml@@ -1,13 +1,25 @@name: Publish @mem0/openclaw-mem0 π¦ to npm+# Dispatched by release.yml (Release Router) when a release tagged+# openclaw-v* is published. Can also be dispatched manually to re-publish+# a tag.on:- release:- types: [published]+ workflow_dispatch:+ inputs:+ tag:+ description: 'Release tag to build and publish (e.g. openclaw-v0.5.0)'+ required: true+ type: string+ prerelease:+ description: 'Publish under the version preid dist-tag instead of latest'+ required: false+ type: boolean+ default: falsejobs:build-n-publish:name: Build and publish @mem0/openclaw-mem0 π¦ to npm- if: startsWith(github.event.release.tag_name, 'openclaw-v')+ if: startsWith(inputs.tag, 'openclaw-v')runs-on: ubuntu-latestpermissions:id-token: write@@ -16,6 +28,8 @@ jobs:working-directory: openclawsteps:- uses: actions/checkout@v4+ with:+ ref: ${{ inputs.tag }}- name: Install pnpmuses: pnpm/action-setup@v4@@ -38,7 +52,7 @@ jobs:- name: Publish to npmrun: |- if [ "${{ github.event.release.prerelease }}" = "true" ]; then+ if [ "${{ inputs.prerelease }}" = "true" ]; thenPREID=$(node -p "require('./package.json').version.split('-')[1].split('.')[0]")npx npm@latest publish --provenance --access public --tag "$PREID"elsediff --git a/.github/workflows/opencode-plugin-cd.yml b/.github/workflows/opencode-plugin-cd.ymlindex 746569aa8..dd1a293d9 100644--- a/.github/workflows/opencode-plugin-cd.yml+++ b/.github/workflows/opencode-plugin-cd.yml@@ -1,13 +1,25 @@name: Publish @mem0/opencode-plugin π¦ to npm+# Dispatched by release.yml (Release Router) when a release tagged+# opencode-v* is published. Can also be dispatched manually to re-publish+# a tag.on:- release:- types: [published]+ workflow_dispatch:+ inputs:+ tag:+ description: 'Release tag to build and publish (e.g. opencode-v0.2.0)'+ required: true+ type: string+ prerelease:+ description: 'Publish under the version preid dist-tag instead of latest'+ required: false+ type: boolean+ default: falsejobs:build-n-publish:name: Build and publish @mem0/opencode-plugin π¦ to npm- if: startsWith(github.event.release.tag_name, 'opencode-v')+ if: startsWith(inputs.tag, 'opencode-v')runs-on: ubuntu-latestpermissions:id-token: write@@ -16,6 +28,8 @@ jobs:working-directory: mem0-plugin/.opencode-pluginsteps:- uses: actions/checkout@v4+ with:+ ref: ${{ inputs.tag }}- name: Install Bunuses: oven-sh/setup-bun@v2@@ -36,7 +50,7 @@ jobs:- name: Publish to npmrun: |- if [ "${{ github.event.release.prerelease }}" = "true" ]; then+ if [ "${{ inputs.prerelease }}" = "true" ]; thenPREID=$(node -p "require('./package.json').version.split('-')[1].split('.')[0]")npx npm@latest publish --provenance --access public --tag "$PREID"elsediff --git a/.github/workflows/pi-agent-plugin-cd.yml b/.github/workflows/pi-agent-plugin-cd.ymlindex fb09e9684..f32bb7196 100644--- a/.github/workflows/pi-agent-plugin-cd.yml+++ b/.github/workflows/pi-agent-plugin-cd.yml@@ -1,13 +1,25 @@name: Publish @mem0/pi-agent-plugin π¦ to npm+# Dispatched by release.yml (Release Router) when a release tagged+# pi-agent-v* is published. Can also be dispatched manually to re-publish+# a tag.on:- release:- types: [published]+ workflow_dispatch:+ inputs:+ tag:+ description: 'Release tag to build and publish (e.g. pi-agent-v0.1.1)'+ required: true+ type: string+ prerelease:+ description: 'Publish under the version preid dist-tag instead of latest'+ required: false+ type: boolean+ default: falsejobs:build-n-publish:name: Build and publish @mem0/pi-agent-plugin π¦ to npm- if: startsWith(github.event.release.tag_name, 'pi-agent-v')+ if: startsWith(inputs.tag, 'pi-agent-v')runs-on: ubuntu-latestpermissions:id-token: write@@ -16,6 +28,8 @@ jobs:working-directory: pi-agent-pluginsteps:- uses: actions/checkout@v4+ with:+ ref: ${{ inputs.tag }}- name: Install pnpmuses: pnpm/action-setup@v4@@ -38,7 +52,7 @@ jobs:- name: Publish to npmrun: |- if [ "${{ github.event.release.prerelease }}" = "true" ]; then+ if [ "${{ inputs.prerelease }}" = "true" ]; thenPREID=$(node -p "require('./package.json').version.split('-')[1].split('.')[0]")npx npm@latest publish --provenance --access public --tag "$PREID"elsediff --git a/.github/workflows/release.yml b/.github/workflows/release.ymlnew file mode 100644index 000000000..5be797b7b--- /dev/null+++ b/.github/workflows/release.yml@@ -0,0 +1,68 @@+name: Release Router π¦++# Single entry point for all release publishing.+#+# Package CD workflows no longer listen to release events themselves β this+# router inspects the release tag and dispatches only the matching pipeline,+# so each release produces one routed run instead of one real run plus seven+# skipped ones.+#+# Re-publishing a release (e.g. after fixing registry settings) does NOT+# require deleting and recreating it anymore β manually dispatch the+# package's CD workflow from the tag instead:+#+# gh workflow run <package>-cd.yml --ref refs/tags/<tag> -f tag=<tag>+#+# Note: dispatching runs the workflow file as it exists at the given ref, so+# this router can only dispatch tags created after the workflow_dispatch+# conversion landed on main. For older tags, dispatch manually from main.++on:+ release:+ types: [published]++permissions:+ actions: write++jobs:+ route:+ name: Route ${{ github.event.release.tag_name }} to its CD pipeline+ runs-on: ubuntu-latest+ steps:+ - name: Match tag prefix to CD workflow+ id: match+ env:+ TAG: ${{ github.event.release.tag_name }}+ run: |+ # Specific package prefixes first; the bare v* (Python SDK) arm+ # must stay last so prefixed tags that also start with 'v'+ # (vercel-ai-v*) can never be routed to the Python pipeline.+ case "$TAG" in+ ts-v*) workflow="ts-sdk-cd.yml" ;;+ cli-node-v*) workflow="cli-node-cd.yml" ;;+ cli-v*) workflow="cli-python-cd.yml" ;;+ vercel-ai-v*) workflow="vercel-ai-cd.yml" ;;+ openclaw-v*) workflow="openclaw-cd.yml" ;;+ opencode-v*) workflow="opencode-plugin-cd.yml" ;;+ pi-agent-v*) workflow="pi-agent-plugin-cd.yml" ;;+ v*) workflow="cd.yml" ;;+ *)+ echo "::error::Release tag '$TAG' does not match any known package prefix β nothing will be published. See the tag prefix table in AGENTS.md."+ exit 1+ ;;+ esac+ echo "workflow=$workflow" >> "$GITHUB_OUTPUT"+ echo ":outbox_tray: Routed \`$TAG\` β \`$workflow\`" >> "$GITHUB_STEP_SUMMARY"++ - name: Dispatch ${{ steps.match.outputs.workflow }}+ env:+ GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}+ TAG: ${{ github.event.release.tag_name }}+ run: |+ # --ref points at the tag so the dispatched run builds (and signs+ # provenance for) the exact tagged commit.+ gh workflow run "${{ steps.match.outputs.workflow }}" \+ --repo "$GITHUB_REPOSITORY" \+ --ref "refs/tags/$TAG" \+ -f tag="$TAG" \+ -f prerelease="${{ github.event.release.prerelease }}"diff --git a/.github/workflows/ts-sdk-cd.yml b/.github/workflows/ts-sdk-cd.ymlindex 8b7202ee9..07218d3db 100644--- a/.github/workflows/ts-sdk-cd.yml+++ b/.github/workflows/ts-sdk-cd.yml@@ -1,13 +1,24 @@name: Publish mem0ai π¦ to npm+# Dispatched by release.yml (Release Router) when a release tagged ts-v* is+# published. Can also be dispatched manually to re-publish a tag.on:- release:- types: [published]+ workflow_dispatch:+ inputs:+ tag:+ description: 'Release tag to build and publish (e.g. ts-v2.1.0)'+ required: true+ type: string+ prerelease:+ description: 'Publish under the version preid dist-tag instead of latest'+ required: false+ type: boolean+ default: falsejobs:build-n-publish:name: Build and publish mem0ai π¦ to npm- if: startsWith(github.event.release.tag_name, 'ts-v')+ if: startsWith(inputs.tag, 'ts-v')runs-on: ubuntu-latestpermissions:id-token: write@@ -16,6 +27,8 @@ jobs:working-directory: mem0-tssteps:- uses: actions/checkout@v4+ with:+ ref: ${{ inputs.tag }}- name: Install pnpmuses: pnpm/action-setup@v4@@ -38,7 +51,7 @@ jobs:- name: Publish to npmrun: |- if [ "${{ github.event.release.prerelease }}" = "true" ]; then+ if [ "${{ inputs.prerelease }}" = "true" ]; thenPREID=$(node -p "require('./package.json').version.split('-')[1].split('.')[0]")npx npm@latest publish --provenance --access public --tag "$PREID"elsediff --git a/.github/workflows/vercel-ai-cd.yml b/.github/workflows/vercel-ai-cd.ymlindex 172afc288..18dd4b31d 100644--- a/.github/workflows/vercel-ai-cd.yml+++ b/.github/workflows/vercel-ai-cd.yml@@ -1,13 +1,25 @@name: Publish @mem0/vercel-ai-provider π¦ to npm+# Dispatched by release.yml (Release Router) when a release tagged+# vercel-ai-v* is published. Can also be dispatched manually to re-publish+# a tag.on:- release:- types: [published]+ workflow_dispatch:+ inputs:+ tag:+ description: 'Release tag to build and publish (e.g. vercel-ai-v2.0.7)'+ required: true+ type: string+ prerelease:+ description: 'Publish under the version preid dist-tag instead of latest'+ required: false+ type: boolean+ default: falsejobs:build-n-publish:name: Build and publish @mem0/vercel-ai-provider π¦ to npm- if: startsWith(github.event.release.tag_name, 'vercel-ai-v')+ if: startsWith(inputs.tag, 'vercel-ai-v')runs-on: ubuntu-latestpermissions:id-token: write@@ -16,6 +28,8 @@ jobs:working-directory: vercel-ai-sdksteps:- uses: actions/checkout@v4+ with:+ ref: ${{ inputs.tag }}- name: Install pnpmuses: pnpm/action-setup@v4@@ -38,7 +52,7 @@ jobs:- name: Publish to npmrun: |- if [ "${{ github.event.release.prerelease }}" = "true" ]; then+ if [ "${{ inputs.prerelease }}" = "true" ]; thenPREID=$(node -p "require('./package.json').version.split('-')[1].split('.')[0]")npx npm@latest publish --provenance --access public --tag "$PREID"elsediff --git a/AGENTS.md b/AGENTS.mdindex 4d4c25978..40efa7e41 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -418,8 +418,11 @@ To add a new LLM, embedding, vector store, or reranker provider:### CD Workflows (automated publishing)+Publishing is routed through a single entry point: **`release.yml` (Release Router)** is the only workflow that listens to `release: published` events. It matches the release tag prefix and dispatches the corresponding package workflow via `workflow_dispatch`, so each release produces exactly one routed run (no skipped runs from the other pipelines).+| Workflow | File | Tag Prefix | Target ||----------|------|------------|--------|+| Release Router | `release.yml` | (all releases) | dispatches the matching workflow below || Python SDK | `cd.yml` | `v*` | PyPI (`mem0ai`) || TypeScript SDK | `ts-sdk-cd.yml` | `ts-v*` | npm (`mem0ai`) || Python CLI | `cli-python-cd.yml` | `cli-v*` | PyPI (`mem0-cli`) |@@ -429,8 +432,11 @@ To add a new LLM, embedding, vector store, or reranker provider:| OpenCode Plugin | `opencode-plugin-cd.yml` | `opencode-v*` | npm (`@mem0/opencode-plugin`) || Pi Agent Plugin | `pi-agent-plugin-cd.yml` | `pi-agent-v*` | npm (`@mem0/pi-agent-plugin`) |+- Package CD workflows are `workflow_dispatch`-only (inputs: `tag`, `prerelease`); they check out and build the given tag. Registry trusted-publisher settings stay pinned to each package's own workflow filename.- All publishing uses **OIDC trusted publishing** β no tokens or secrets required.- First publish of a new npm package must be done manually; OIDC works for subsequent versions.+- To re-publish a release (e.g. after a registry settings fix), do **not** delete/recreate the GitHub release β manually dispatch the package workflow instead: `gh workflow run <package>-cd.yml --ref refs/tags/<tag> -f tag=<tag>`.+- When adding a new package: add its CD workflow (`workflow_dispatch` with `tag`/`prerelease` inputs), then register its tag prefix in the `case` block in `release.yml`. Keep the bare `v*` arm last.### Utility Workflows