Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
chore(pump-watch): retire the GitHub Actions upstream watch and run it as a local script scoped to official packages
nirholasaacd33a4163c
diff --git a/.github/workflows/pump-upstream-watch.yml b/.github/workflows/pump-upstream-watch.ymldeleted file mode 100644index 055cfe0be..000000000--- a/.github/workflows/pump-upstream-watch.yml+++ /dev/null@@ -1,43 +0,0 @@-name: Pump.fun upstream watch--on:- schedule:- - cron: "37 7 * * *"- workflow_dispatch:--permissions:- contents: read- issues: write--jobs:- watch:- runs-on: ubuntu-latest- steps:- - uses: actions/checkout@v4- - uses: actions/setup-node@v4- with:- node-version: 22- cache: npm- - name: Compare npm and GitHub upstreams- id: watch- continue-on-error: true- env:- PUMP_WATCH_GITHUB_TOKEN: ${{ github.token }}- run: |- set +e- node scripts/pump-upstream-watch.mjs > pump-upstream-report.md- status=$?- cat pump-upstream-report.md >> "$GITHUB_STEP_SUMMARY"- exit "$status"- - name: Open or refresh upstream drift issue- if: steps.watch.outcome == 'failure'- env:- GH_TOKEN: ${{ github.token }}- run: |- title="Pump.fun upstream release needs review"- existing=$(gh issue list --state open --search "$title in:title" --json number --jq '.[0].number // empty')- if [ -n "$existing" ]; then- gh issue edit "$existing" --body-file pump-upstream-report.md- else- gh issue create --title "$title" --body-file pump-upstream-report.md --label dependencies- fidiff --git a/docs/ops/pump-upstream-watch.md b/docs/ops/pump-upstream-watch.mdindex 068f69bae..850d87c90 100644--- a/docs/ops/pump-upstream-watch.md+++ b/docs/ops/pump-upstream-watch.md@@ -1,11 +1,12 @@# Pump.fun upstream watch-This is the operating contract for keeping three.ws and the public `nirholas`-Pump.fun ecosystem current with official npm packages and public repositories.+This is the operating contract for keeping three.ws current with the official+Pump.fun npm packages and public repositories.-## Automated signal+## The check-Run the same check locally that GitHub runs every day:+Run it locally whenever a Pump.fun dependency is in question, and before any+wave of SDK work:```bashnpm run pump:watch@@ -15,10 +16,10 @@ The command discovers every current `@pump-fun/*` npm package, compares their`latest` tags and every public repository under `pump-fun` with`data/pump-upstream-baseline.json`. A new package, package version, removedpackage, new repository, removed repository, or repository push exits with-status 2 and prints a review report. `.github/workflows/pump-upstream-watch.yml`-runs it daily and opens or refreshes one GitHub issue instead of creating-duplicate alerts. Dependabot separately opens dependency pull requests for-`@pump-fun/*`.+status 2 and prints a review report. Nothing runs it on a schedule: this repo+uses no GitHub Actions, and the check writes its baseline back into the repo, so+it belongs in a local run that a human reviews and commits. Dependabot+separately opens dependency pull requests for `@pump-fun/*`.After reviewing and integrating an upstream change, acknowledge the exactstate in the same pull request:@@ -33,41 +34,6 @@ IDL refreshes are deterministic and use the official public docs first:npm run pump:refresh-idls```-## Manual audit - 2026-09-14--The audit queried all 309 public `nirholas` repositories, selected 32 whose-name, description, or topics mentioned Pump.fun, memecoins, Solana launching,-or creator rewards, then searched their checked-out public source. Twenty-seven-contained Pump.fun code or documentation:--- SDK and transaction builders: `pump-fun-sdk`, `pump-swap-sdk`,- `pumpfun-rust-client`, `agent-payments-sdk`, `atomic`, `pumpvault`,- `solana-sniper-mcp`.-- Monitoring, claims, and market intelligence: `pumpkit`,- `pumpfun-claims-bot`, `pumpfun-github-claims`, `pumpfun-creator-rewards`,- `alerts-mcp`, `pumpfun-mcp`, `pump-fun-workers`, `oracle-model`, `kol-quest`,- `visualize-web3-realtime`, `boosty`.-- Agent, launch, and UI surfaces: `three.ws`, `avatar-agent-mcp`,- `solana-launchpad-ui`, `launch-relay`, `clash-mcp`, `pump-fun-skills`,- `memescope-monday-directory`, `analyze-memecoin-socials`,- `robinhood-chain-alerts`.--The package consumers needing follow-on repository-specific updates were:--| Public repository | Observed dependency before this wave |-|---|---|-| `pump-fun-sdk` | `@pump-fun/pump-swap-sdk ^1.19.0` |-| `pumpvault` | `@pump-fun/pump-sdk ^1.36.0`, swap SDK `^1.16.0` |-| `solana-sniper-mcp` | Pump SDK `^1.36.0`, swap SDK `^1.19.0` |-| `agent-payments-sdk` | Pump SDK `^1.35.0` in the standalone public checkout |-| `atomic` | `@nirholas/pump-sdk ^1.30.0` |-| `avatar-agent-mcp` | `@nirholas/pump-sdk ^1.30.0` |-| `pumpkit` | `@nirholas/pump-sdk ^1.30.0` |--Repository names alone are not treated as proof of an integration. The five-description/topic candidates with no matching public source were excluded from-the implementation inventory.-## Current upstream feature boundary`@pump-fun/pump-sdk 2.0.0` adds protocol-native holder-reward coins, deprecatesdiff --git a/scripts/pump-upstream-watch.mjs b/scripts/pump-upstream-watch.mjsindex b5d409d46..e1f88a2dd 100644--- a/scripts/pump-upstream-watch.mjs+++ b/scripts/pump-upstream-watch.mjs@@ -77,60 +77,6 @@ async function officialRepoState() {);}-async function nirholasCandidates() {- const repos = [];- for (let page = 1; page <= 4; page += 1) {- const batch = await fetchJson(- `https://api.github.com/users/nirholas/repos?per_page=100&page=${page}&type=public`,- { github: true },- );- repos.push(...batch);- if (batch.length < 100) break;- }- const relevant = /pump|memecoin|solana launch|creator reward/i;- return repos- .filter((repo) => repo.name === 'three.ws' || relevant.test(`${repo.name} ${repo.description ?? ''} ${(repo.topics ?? []).join(' ')}`))- .map((repo) => ({- name: repo.name,- url: repo.html_url,- updatedAt: repo.updated_at,- archived: repo.archived,- }))- .sort((a, b) => a.name.localeCompare(b.name));-}--async function nirholasCodeConsumers() {- if (!githubToken) return [];- const queries = [- 'user:nirholas "@pump-fun/"',- 'user:nirholas "@nirholas/pump-sdk"',- 'user:nirholas "pump.fun"',- ];- const found = new Map();- for (const query of queries) {- try {- const result = await fetchJson(- `https://api.github.com/search/code?per_page=100&q=${encodeURIComponent(query)}`,- { github: true },- );- for (const item of result.items ?? []) {- const repo = item.repository;- if (repo?.owner?.login === 'nirholas' && !repo.private) {- found.set(repo.name, {- name: repo.name,- url: repo.html_url,- updatedAt: repo.updated_at,- archived: repo.archived,- });- }- }- } catch (error) {- process.stderr.write(`pump:watch: GitHub code search skipped (${error.message})\n`);- }- }- return [...found.values()];-}-function readDeclaredVersions() {const manifests = ['package.json',@@ -183,22 +129,12 @@ function markdown(report) {for (const [name, value] of Object.entries(report.repositories)) {lines.push(`| [pump-fun/${name}](${value.url}) | ${value.pushedAt} | ${value.archived ? 'archived' : 'active'} |`);}- lines.push('', `## nirholas public Pump.fun surface (${report.nirholasCandidates.length} candidates)`, '');- lines.push(report.nirholasCandidates.map((repo) => `[${repo.name}](${repo.url})`).join(', ') || 'None found.');lines.push('', '## Drift', '');lines.push(...(report.changes.length ? report.changes.map((change) => `- ${change}`) : ['No upstream drift detected.']));return `${lines.join('\n')}\n`;}-const [packages, repositories, candidates, codeConsumers] = await Promise.all([- npmState(),- officialRepoState(),- nirholasCandidates(),- nirholasCodeConsumers(),-]);-const candidateMap = new Map(candidates.map((repo) => [repo.name, repo]));-for (const repo of codeConsumers) candidateMap.set(repo.name, repo);-const allCandidates = [...candidateMap.values()].sort((a, b) => a.name.localeCompare(b.name));+const [packages, repositories] = await Promise.all([npmState(), officialRepoState()]);const current = { packages, repositories };let baseline = { packages: {}, repositories: {} };try {@@ -211,7 +147,6 @@ const report = {packages,repositories,localConsumers: readDeclaredVersions(),- nirholasCandidates: allCandidates,changes: diffState(baseline, current),};