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
import { describe, it, expect } from 'vitest';
import {
entryKey,
pendingEntries,
formatTelegramMessage,
formatTweet,
weightedLength,
classifyXError,
xFilterReason,
loadXFilter,
pushTelegramLane,
pushXLane,
} from '../api/_lib/changelog-push.js';
const day = (offset) => new Date(Date.now() + offset * 86400000).toISOString().slice(0, 10);
const entry = (over = {}) => ({
date: day(0),
title: 'A test release',
summary: 'Something shipped.',
tags: ['feature'],
...over,
});
describe('entryKey', () => {
it('is date:title', () => {
expect(entryKey({ date: '2026-07-16', title: 'X' })).toBe('2026-07-16:X');
});
});
describe('pendingEntries', () => {
it('filters posted, launches, and entries older than the cutoff', () => {
const feed = {
entries: [
entry({ title: 'fresh' }),
entry({ title: 'already posted' }),
entry({ title: 'a launch', type: 'launch' }),
entry({ title: 'ancient', date: day(-30) }),
],
};
const posted = new Set([`${day(0)}:already posted`]);
const { pending, backlog } = pendingEntries(feed, posted, 10);
expect(pending.map((e) => e.title)).toEqual(['fresh']);
expect(backlog).toBe(1);
});
it('posts a repeated entry once, so a duplicated feed line is not a repeated announcement', () => {
// The posted-set only suppresses entries sent on an earlier tick, so two
// feed entries sharing one key both survive it and the send loop posts
// each. data/changelog.json has carried such pairs.
const feed = {
entries: [entry({ title: 'shipped twice' }), entry({ title: 'shipped twice' }), entry({ title: 'other' })],
};
const { pending, backlog } = pendingEntries(feed, new Set(), 10);
expect(pending.map((e) => e.title)).toEqual(['shipped twice', 'other']);
expect(backlog).toBe(2);
});
it('sorts chronologically and slices oldest-first by default, newest-first with newestWin', () => {
const feed = {
entries: [
entry({ title: 'today', date: day(0) }),
entry({ title: 'yesterday', date: day(-1) }),
entry({ title: 'two days ago', date: day(-2) }),
],
};
const none = new Set();
expect(pendingEntries(feed, none, 2).pending.map((e) => e.title)).toEqual(['two days ago', 'yesterday']);
expect(pendingEntries(feed, none, 2, { newestWin: true }).pending.map((e) => e.title)).toEqual(['yesterday', 'today']);
});
});
describe('formatTelegramMessage', () => {
it('escapes HTML and carries the detail link, date, and hashtags', () => {
const msg = formatTelegramMessage(entry({ title: 'A <b>bold</b> & brave release', tags: ['fix', 'infra'] }));
expect(msg).toContain('A <b>bold</b> & brave release');
expect(msg).toContain(`https://three.ws/changelog/${day(0)}-a-b-bold-b-brave-release`);
expect(msg).toContain('#fix #infra');
expect(msg).toContain(day(0));
});
});
describe('formatTweet', () => {
it('keeps a short entry intact and appends the detail URL', () => {
const t = formatTweet(entry());
expect(t).toContain('A test release');
expect(t).toContain('Something shipped.');
expect(t).toMatch(/https:\/\/three\.ws\/changelog\/\S+$/);
});
it('trims a long summary to the 280 weighted-char budget on a word boundary', () => {
const t = formatTweet(entry({ summary: 'word '.repeat(200).trim() }));
// Weigh the t.co-wrapped URL at 23 like X does.
const weighted = weightedLength(t.replace(/https:\/\/\S+$/, 'x'.repeat(23)));
expect(weighted).toBeLessThanOrEqual(280);
expect(t).toContain('…');
});
});
describe('the X filter', () => {
const filter = loadXFilter();
const verdict = (over) => xFilterReason(entry(over), filter);
it('passes a plain product feature', () => {
expect(verdict({ title: 'Text avatars now wear what you describe', summary: 'Describe an outfit and the avatar wears it.', tags: ['feature'] })).toBeNull();
});
it('keeps agent wallets, x402, funds, and keys off X', () => {
expect(verdict({ title: 'Agents now buy real work from brand-new wallets', tags: ['feature'] })).not.toBeNull();
expect(verdict({ summary: 'Paid calls settle over x402.', tags: ['feature'] })).not.toBeNull();
expect(verdict({ summary: 'The pool only pays from wallets that hold funds.', tags: ['improvement'] })).not.toBeNull();
expect(verdict({ summary: 'Rotate your API keys from the dashboard.', tags: ['feature'] })).not.toBeNull();
});
it('skips security work, bare fixes, and plumbing', () => {
expect(verdict({ tags: ['security', 'feature'] })).not.toBeNull();
expect(verdict({ tags: ['fix'] })).not.toBeNull();
expect(verdict({ tags: ['infra', 'docs'] })).not.toBeNull();
});
it('allows $THREE and blocks any other ticker', () => {
expect(verdict({ summary: 'Every coin on the launchpad is bought with $THREE.', tags: ['feature'] })).toBeNull();
expect(verdict({ summary: 'Now quoting $ABC next to the chart.', tags: ['feature'] })).not.toBeNull();
});
});
describe('classifyXError', () => {
const now = 1_800_000_000_000;
it('backs off until the exhausted 24h window resets, not the 15-minute one', () => {
const err = {
code: 429,
rateLimit: { limit: 200, remaining: 150, reset: now / 1000 + 900, userDay: { limit: 17, remaining: 0, reset: now / 1000 + 36_000 } },
};
expect(classifyXError(err, now)).toEqual({ kind: 'rate_limited', until: now + 36_000_000 });
});
it('falls back to a fixed wait when a 429 carries no usable reset', () => {
const verdict = classifyXError({ code: 429 }, now);
expect(verdict.kind).toBe('rate_limited');
expect(verdict.until).toBeGreaterThan(now);
});
it('recognizes duplicate content and a deleted reply target', () => {
expect(classifyXError({ code: 403, data: { detail: 'You are not allowed to create a Tweet with duplicate content.' } }).kind).toBe('duplicate');
expect(classifyXError({ code: 403, data: { detail: 'You attempted to reply to a Tweet that is deleted or not visible to you.' } }).kind).toBe('thread_gone');
});
it('treats auth and unknown failures as fatal so they surface', () => {
expect(classifyXError({ code: 401, data: { title: 'Unauthorized' } }).kind).toBe('fatal');
expect(classifyXError(new Error('socket hang up')).kind).toBe('fatal');
});
});
describe('lanes without credentials', () => {
it('report not_configured without touching network or db', async () => {
const saved = {};
for (const k of ['TELEGRAM_BOT_TOKEN', 'TELEGRAM_CHANGELOG_CHAT_ID', 'X_API_KEY', 'X_API_SECRET', 'X_ACCESS_TOKEN', 'X_ACCESS_SECRET']) {
saved[k] = process.env[k];
delete process.env[k];
}
try {
expect(await pushTelegramLane({ entries: [entry()] })).toEqual({ skipped: 'not_configured' });
expect(await pushXLane({ entries: [entry()] })).toEqual({ skipped: 'not_configured' });
} finally {
for (const [k, v] of Object.entries(saved)) if (v !== undefined) process.env[k] = v;
}
});
});