Skip to content

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.

feat(desktop): skip the live-fill smoke checks with a clear notice when the venue feed blocks this network, and document Linux installers and signing owner steps

nirholas429b809e6934
diff --git a/apps/desktop/README.md b/apps/desktop/README.md
index 46f283e96..e57d12e7a 100644
--- a/apps/desktop/README.md
+++ b/apps/desktop/README.md
@@ -85,6 +85,17 @@ npm run dist:win # nsis
npm run dist:linux # AppImage + deb
```
+Linux output lands in `dist/` (`three.ws-Desktop-<version>-linux-x86_64.AppImage`
+and `-linux-amd64.deb`). The macOS and Windows installers build unsigned until
+the owner supplies the Apple Developer ID certificate (`CSC_LINK`,
+`CSC_KEY_PASSWORD`) and notarization key (`APPLE_API_KEY`, `APPLE_API_KEY_ID`,
+`APPLE_API_ISSUER`) and a Windows code-signing certificate. Auto-update only trusts signed releases, so those are
+the remaining owner steps; `npm run release:mac` is the one command once they exist.
+
+`npm run smoke:runtime` reaches the venue's public launch feed. If your network
+is blocked from it, the smoke prints `SKIP` for the fill checks and still
+verifies create, pause, kill and log hygiene.
+
## How it works
```
diff --git a/apps/desktop/scripts/smoke-runtime.mjs b/apps/desktop/scripts/smoke-runtime.mjs
index ed1883632..e3d150f36 100644
--- a/apps/desktop/scripts/smoke-runtime.mjs
+++ b/apps/desktop/scripts/smoke-runtime.mjs
@@ -9,6 +9,7 @@ import { mkdtempSync, readFileSync, rmSync, existsSync } from 'node:fs';
import { tmpdir } from 'node:os';
import { join } from 'node:path';
import { createLocalRuntime } from '../src/runtime/index.js';
+import { createPumpFeed } from '../src/runtime/feed.js';
const dir = mkdtempSync(join(tmpdir(), 'three-ws-runtime-smoke-'));
const events = [];
@@ -27,15 +28,21 @@ try {
});
check('agent created with a keychain-store address', Boolean(agent.address) && keystore.address(agent.id) === agent.address, agent.address);
+ // The fill checks need real launches. When the venue's public feed is
+ // unreachable from this network (it answers 403 to some hosts), say so and
+ // skip them rather than reporting a runtime fault that is not one.
+ const feedLive = (await createPumpFeed().launches({ limit: 5 })).length > 0;
+ if (!feedLive) console.log('SKIP live launch feed unreachable from this network: fill checks not run');
+
await runtime.tick();
const after = runtime.getAgent(agent.id);
const receipts = runtime.receipts({ agentId: agent.id });
const positions = runtime.positions({ agentId: agent.id });
check('scheduler pass finished without error', after.status === 'idle', after.status + (after.detail ? ` (${after.detail})` : ''));
- check('paper buy filled from live feed data', receipts.some((r) => r.kind === 'buy' && r.mode === 'paper' && r.tokens > 0 && r.signature === null), `${receipts.length} receipt(s)`);
- check('position opened', positions.some((p) => p.status === 'open'), `${positions.length} position(s)`);
- check('status events emitted', events.includes('status') && events.includes('receipt'));
+ if (feedLive) check('paper buy filled from live feed data', receipts.some((r) => r.kind === 'buy' && r.mode === 'paper' && r.tokens > 0 && r.signature === null), `${receipts.length} receipt(s)`);
+ if (feedLive) check('position opened', positions.some((p) => p.status === 'open'), `${positions.length} position(s)`);
+ check('status events emitted', events.includes('status') && (!feedLive || events.includes('receipt')));
runtime.pause(agent.id);
check('pause holds the agent', runtime.getAgent(agent.id).status === 'paused');