yappr 0.1.0

package/dist/src/x/types.d.ts

@@ -0,0 +1,61 @@
+export type PublicMetrics = {
+    retweet_count?: number;
+    reply_count?: number;
+    like_count?: number;
+    quote_count?: number;
+    bookmark_count?: number;
+};
+export type Tweet = {
+    id: string;
+    text: string;
+    created_at: string;
+    author_id: string;
+    conversation_id: string;
+    in_reply_to_user_id?: string | null;
+    in_reply_to_screen_name?: string | null;
+    referenced_tweets?: {
+        type: string;
+        id: string;
+    }[];
+    entities?: {
+        mentions?: {
+            username: string;
+        }[];
+        media?: {
+            type?: string;
+            media_url_https?: string;
+            features?: {
+                all?: {
+                    tags?: {
+                        screen_name: string;
+                    }[];
+                };
+            };
+        }[];
+    };
+    media_metadata?: {
+        media_key?: string;
+        media_url?: string;
+    }[];
+    public_metrics?: PublicMetrics;
+    author?: {
+        id: string;
+        username: string;
+        name: string;
+        description?: string;
+        public_metrics?: {
+            followers_count?: number;
+            following_count?: number;
+            tweet_count?: number;
+            listed_count?: number;
+            like_count?: number;
+            media_count?: number;
+        };
+    };
+};
+export type SearchResponse = {
+    data: Tweet[];
+    meta?: {
+        next_token?: string;
+    };
+};

package/dist/src/x/types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/x402.d.ts

@@ -0,0 +1,6 @@
+export type Signer = {
+    address: `0x${string}`;
+    signTypedData: (args: unknown) => Promise<`0x${string}`>;
+};
+export declare function createBankrSigner(apiKey: string, address: `0x${string}`): Signer;
+export declare function createPayFetch(signer: Signer, baseFetch?: typeof fetch): typeof fetch;

package/dist/src/x402.js

@@ -0,0 +1,11 @@
+import { wrapFetchWithPayment, x402Client, x402HTTPClient } from "@x402/fetch";
+import { registerExactEvmScheme } from "@x402/evm/exact/client";
+import { bankrSignTypedData } from "./bankr.js";
+export function createBankrSigner(apiKey, address) {
+    return { address, signTypedData: (args) => bankrSignTypedData(apiKey, args) };
+}
+export function createPayFetch(signer, baseFetch = fetch) {
+    const client = new x402Client();
+    registerExactEvmScheme(client, { signer });
+    return wrapFetchWithPayment(baseFetch, new x402HTTPClient(client));
+}

package/dist/src/yappr.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/yappr.js

@@ -0,0 +1,85 @@
+// Entry point. Wires everything together and starts the two long-running loops:
+// the mention poller (reply pipeline) and the treasury cycle (self-funding). Boot
+// order: validate config → load hooks/skills/prompts from config/ → init the Bankr
+// wallet → start polling → run a startup treasury/claim cycle → schedule the rest.
+import { log } from "./log.js";
+import { config } from "./config.js";
+import { envNumber } from "./util.js";
+import { initBankr } from "./wallet.js";
+import { loadPrompts } from "./llm/prompts.js";
+import { setPrompts, loadModelPricing } from "./llm/index.js";
+import { recordEarned } from "./stats.js";
+import { createPoller } from "./reply/poller.js";
+import { getTreasury } from "./treasury/index.js";
+import { startTreasury, runTreasuryCycle } from "./treasury/cycle.js";
+import { loadHooks } from "./hooks/loader.js";
+import { loadSkills } from "./skills/loader.js";
+import { initSkills } from "./skills/registry.js";
+import { startCron } from "./cron/runner.js";
+async function main() {
+    if (config.burnBps + config.devTokenBps > 10000) {
+        throw new Error(`BURN_BPS (${config.burnBps}) + DEV_TOKEN_BPS (${config.devTokenBps}) exceeds 10000`);
+    }
+    if (config.devWethBps > 10000) {
+        throw new Error(`DEV_WETH_BPS (${config.devWethBps}) exceeds 10000`);
+    }
+    await loadHooks();
+    log.info("initialising Bankr signer");
+    const address = await initBankr();
+    log.info({ address }, "Bankr wallet ready");
+    const skills = await loadSkills();
+    initSkills(skills);
+    log.info({ count: skills.length, names: skills.map((s) => s.name) }, "skills loaded");
+    const prompts = await loadPrompts(skills);
+    setPrompts(prompts);
+    log.info("prompts loaded");
+    // Warm the LLM pricing cache (USD per 1M tokens) so every completion can be costed
+    // from its token usage and recorded as inference spend.
+    await loadModelPricing();
+    const treasury = getTreasury();
+    const poller = createPoller(log);
+    await poller.start();
+    // First treasury/claim cycle runs a short delay after launch (not at t=0). Right at
+    // boot the wallet/Bankr fee indexer isn't always ready, so the claimable-fee check
+    // could report "no fees" before freshly-accrued fees became visible — then a later
+    // cycle would do the claim, making the boot log look wrong. The hourly scheduler below
+    // runs independently. (`runTreasuryCycle` self-catches, so this never crashes boot.)
+    const startupCycleDelayMs = envNumber("STARTUP_TREASURY_DELAY_MS", 10_000);
+    log.info({ delayMs: startupCycleDelayMs }, "scheduling startup treasury cycle");
+    const startupCycle = setTimeout(() => {
+        void runTreasuryCycle(treasury, log).catch((err) => log.error({ err }, "startup treasury cycle failed"));
+    }, startupCycleDelayMs);
+    const stopTreasury = startTreasury(treasury, log);
+    log.info("treasury scheduler started");
+    // Cron scheduler — replays stored prompts (config/skills/cron creates them)
+    // through the agent loop on their schedule. See src/cron/runner.ts.
+    const stopCron = startCron(log);
+    // Poll all-time earnings (creator fees, WETH) from Bankr and record into the
+    // ledger. A cheap read-only call; default cadence one minute.
+    const pollEarnings = async () => {
+        try {
+            recordEarned(await treasury.lifetimeEarned());
+        }
+        catch (err) {
+            log.warn({ err }, "earnings poll failed");
+        }
+    };
+    await pollEarnings();
+    const earningsTimer = setInterval(() => void pollEarnings(), envNumber("EARNINGS_POLL_INTERVAL_MS", 60_000));
+    log.info("yappr is running");
+    for (const sig of ["SIGINT", "SIGTERM"]) {
+        process.once(sig, () => {
+            log.info({ sig }, "shutting down");
+            poller.stop();
+            stopTreasury();
+            stopCron();
+            clearTimeout(startupCycle);
+            clearInterval(earningsTimer);
+            process.exit(0);
+        });
+    }
+}
+main().catch((err) => {
+    log.error(err, "fatal startup error");
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "yappr",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "pre-publish",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "bin": {
+    "yappr": "dist/src/cli/index.js"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "exports": {
+    ".": {
+      "development": "./src/index.ts",
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/etherlect/yappr.git"
+  },
+  "homepage": "https://github.com/etherlect/yappr#readme",
+  "bugs": "https://github.com/etherlect/yappr/issues",
+  "dependencies": {
+    "@inquirer/prompts": "^8.5.2",
+    "@types/better-sqlite3": "^7.6.13",
+    "@x402/evm": "^2.13.0",
+    "@x402/fetch": "^2.13.0",
+    "asciichart": "^1.5.25",
+    "better-sqlite3": "^12.10.0",
+    "cli-truncate": "^6.0.0",
+    "dotenv": "^16.4.5",
+    "jiti": "^2.7.0",
+    "node-ssh": "^13.0.0",
+    "ora": "^9.4.0",
+    "pino": "^10.3.1",
+    "pino-pretty": "^11.3.0",
+    "playwright-core": "^1.60.0",
+    "string-width": "^8.2.1",
+    "viem": "^2.0.0"
+  },
+  "devDependencies": {
+    "@bankr/cli": "^0.3.1",
+    "@types/asciichart": "^1.5.8",
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  }
+}