{"_id":"@blueagent/reputation","_rev":"2-98b6831f5fa6428b4615d7a6186062a6","name":"@blueagent/reputation","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@blueagent/reputation","version":"0.1.0","_id":"@blueagent/reputation@0.1.0","maintainers":[{"name":"madebyshun","email":"ststudios.hr@gmail.com"}],"dist":{"shasum":"89ce1236b976aaf396d2cdff97d37b5776512db9","tarball":"https://registry.npmjs.org/@blueagent/reputation/-/reputation-0.1.0.tgz","fileCount":32,"integrity":"sha512-Rz2uO/eJBowzE2F8qhFSF866xKphOaJ6ZuHgm2VFb15e83LRpRcfFRbLZ9CP4AvPNPNDcnvu0ffk9dD+4JjE6w==","signatures":[{"sig":"MEUCIFYZq5v4BmVbU4kYCgJzQDwnbNA/uDppQqoxTyYr6XT0AiEA32h4UM26k8V46I1Y43ppK1b0hIvsfytGUt2wny9Po2s=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":59771},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=18"},"gitHead":"5d965e5ac1195ea65dde62ff19e0790cd113652c","scripts":{"dev":"tsc --watch","build":"tsc"},"_npmUser":{"name":"madebyshun","email":"ststudios.hr@gmail.com"},"_npmVersion":"10.9.4","description":"Blue Agent Reputation System — Builder Score, Agent Score, Work Hub","directories":{},"_nodeVersion":"22.22.1","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/reputation_0.1.0_1778225087373_0.4611498388033761","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@blueagent/reputation","version":"0.1.1","description":"Blue Agent Reputation System — Builder Score, Agent Score, Work Hub","main":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"tsc","dev":"tsc --watch"},"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.0.0"},"engines":{"node":">=18"},"_id":"@blueagent/reputation@0.1.1","gitHead":"de6d421b6d0d1dfe8ca214423034db0579fb10b6","_nodeVersion":"22.22.1","_npmVersion":"10.9.4","dist":{"integrity":"sha512-b8g4z7qJpUu4PW8/oAJswn+ENCz07yjFEloE6y4rV1dpx4LUMo6nJmipp5GGGNCC6GJk4hKYRuaLoRshY+Sl2w==","shasum":"49dba54138be2db60cd53c72b9e550726bef0f99","tarball":"https://registry.npmjs.org/@blueagent/reputation/-/reputation-0.1.1.tgz","fileCount":32,"unpackedSize":63709,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIFNokYV1lgjwWN7Ps0IHQd2GLV11maRT7xLyg3YyDh7fAiEA7bjQ03Ssdp6GZqlgWls2D5Mx07WcZ+2BjKa4z5s0nXU="}]},"_npmUser":{"name":"madebyshun","email":"ststudios.hr@gmail.com"},"directories":{},"maintainers":[{"name":"madebyshun","email":"ststudios.hr@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/reputation_0.1.1_1778771825320_0.34481418352695137"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-08T07:24:47.241Z","modified":"2026-05-14T15:17:05.640Z","0.1.0":"2026-05-08T07:24:47.536Z","0.1.1":"2026-05-14T15:17:05.475Z"},"description":"Blue Agent Reputation System — Builder Score, Agent Score, Work Hub","maintainers":[{"name":"madebyshun","email":"ststudios.hr@gmail.com"}],"readme":"# @blueagent/reputation\n\nBlue Agent Reputation System — Builder Score, Agent Score, and Work Hub.\n\nBuilt by [Blocky Studio](https://blocky.studio).\n\n## Install\n\n```bash\nnpm install @blueagent/reputation\n```\n\nRequires `BANKR_API_KEY` in your environment. All scoring calls go through Bankr LLM.\n\n---\n\n## Three systems\n\n### 1. Builder Score\n\nScore any X/Twitter handle on 5 dimensions (total 100 pts). Returns a tier, dimension breakdown, and summary.\n\n**Dimensions:**\n| Dimension  | Max | What it measures |\n|---|---|---|\n| activity   | 25  | Posting frequency, streak, consistency |\n| social     | 25  | Followers, engagement rate, mentions |\n| uniqueness | 20  | Niche clarity, differentiation in bio/content |\n| thesis     | 20  | Vision clarity, pinned content, project description |\n| community  | 10  | Replies, retweets, builder interactions |\n\n**Tiers:**\n| Score  | Tier     |\n|---|---|\n| 0–40   | Explorer |\n| 41–60  | Builder  |\n| 61–75  | Maker    |\n| 76–90  | Legend   |\n| 91–100 | Founder  |\n\n```typescript\nimport { scoreBuilder } from \"@blueagent/reputation\";\n\nconst result = await scoreBuilder(\"madebyshun\");\nconsole.log(result.score);       // 72\nconsole.log(result.tier);        // \"Maker\"\nconsole.log(result.dimensions);  // { activity: 18, social: 20, ... }\nconsole.log(result.summary);     // \"Sharp builder focused on Base...\"\nconsole.log(result.badge);       // \"https://blueagent.dev/badge/builder/madebyshun\"\n```\n\n---\n\n### 2. Agent Score\n\nScore any AI agent by X handle, npm package, GitHub repo, or x402 endpoint. Returns a tier, dimension breakdown, strengths, and gaps.\n\n**Dimensions:**\n| Dimension        | Max | What it measures |\n|---|---|---|\n| skillDepth       | 25  | SKILL.md/CLAUDE.md, grounded knowledge, tool count |\n| onchainActivity  | 25  | Wallet txs, x402 revenue, Base deployments |\n| reliability      | 20  | Uptime, response rate, error rate |\n| interoperability | 20  | MCP server, npm package, API endpoints, AgentKit compat |\n| reputation       | 10  | npm downloads, GitHub stars, community mentions |\n\n**Tiers:**\n| Score  | Tier        |\n|---|---|\n| 0–40   | Bot         |\n| 41–60  | Agent       |\n| 61–75  | Pro Agent   |\n| 76–90  | Elite Agent |\n| 91–100 | Sovereign   |\n\n**Input formats:**\n- `@handle` or `handle` — X/Twitter handle\n- `npm:@scope/package` — npm package name\n- `github.com/user/repo` — GitHub repository\n- `https://...` — x402 endpoint URL (pinged for liveness)\n\n```typescript\nimport { scoreAgent } from \"@blueagent/reputation\";\n\n// By X handle\nconst r1 = await scoreAgent(\"@blocky_agent\");\n\n// By npm package\nconst r2 = await scoreAgent(\"npm:@blueagent/skill\");\n\n// By GitHub repo\nconst r3 = await scoreAgent(\"github.com/coinbase/agentkit\");\n\n// By endpoint\nconst r4 = await scoreAgent(\"https://api.blueagent.dev/v1/analyze\");\n\nconsole.log(r2.score);       // 68\nconsole.log(r2.tier);        // \"Pro Agent\"\nconsole.log(r2.strengths);   // [\"Strong MCP integration\", \"Published npm package\"]\nconsole.log(r2.gaps);        // [\"No onchain wallet activity detected\"]\nconsole.log(r2.badge);       // \"https://blueagent.dev/badge/agent/@blueagent%2Fskill\"\n```\n\n---\n\n### 3. Task Hub\n\nPost, accept, and complete work tasks with USDC rewards on Base. 5% fee goes to the Blue Agent treasury on task completion.\n\n**Task flow:**\n1. Poster calls `createTask()` — task goes to `open`\n2. Doer calls `acceptTask()` — task moves to `in_progress`\n3. Doer calls `submitTask()` with proof — task moves to `completed`\n\n**Fee:** 5% of reward to treasury (`0xf31f59e7b8b58555f7871f71973a394c8f1bffe5`) on Base. Doer receives 95%.\n\n**Proof types:** `tx_hash` | `github_link` | `npm_link` | `url`\n\n**Categories:** `audit` | `content` | `art` | `data` | `dev`\n\n```typescript\nimport {\n  createTask, acceptTask, submitTask, listTasks,\n  getFeeAmount, getDoerAmount, TREASURY\n} from \"@blueagent/reputation\";\n\n// Post a task\nconst task = createTask({\n  title: \"Audit ERC-20 token contract\",\n  description: \"Review for reentrancy, overflow, and access control issues\",\n  category: \"audit\",\n  reward: 50,        // 50 USDC\n  poster: \"0xYourAddress\",\n  deadline: \"2026-06-01T00:00:00Z\",\n  proof_required: \"github_link\",\n});\n\nconsole.log(task.id);      // \"task_a1b2c3d4\"\nconsole.log(task.status);  // \"open\"\n\n// Accept the task\nconst accepted = acceptTask(task.id, \"0xDoerAddress\");\n\n// Submit with proof\nconst completed = submitTask(task.id, \"0xDoerAddress\", \"https://github.com/...\");\n\n// Fee breakdown\nconsole.log(getFeeAmount(50));  // 2.5 USDC → treasury\nconsole.log(getDoerAmount(50)); // 47.5 USDC → doer\nconsole.log(TREASURY);          // \"0xf31f59e7b8b58555f7871f71973a394c8f1bffe5\"\n\n// List open tasks in \"dev\" category\nconst devTasks = listTasks({ category: \"dev\", status: \"open\" });\n```\n\n---\n\n## Score reward system\n\nEvery task completion awards reputation points:\n- **Poster**: +2 Reputation\n- **Doer**: +5 Skill Depth\n\n---\n\n## Notes\n\n- Scoring uses Bankr LLM (`https://llm.bankr.bot/v1/messages`). Set `BANKR_API_KEY` in your environment.\n- Task Hub is in-memory by default. Replace with a DB or onchain store for production.\n- All USDC rewards are on Base (chain ID 8453).\n- Treasury address is verified on Basescan: `0xf31f59e7b8b58555f7871f71973a394c8f1bffe5`\n","readmeFilename":"README.md"}