lowdown-proxy 0.1.3 → 0.1.5

package/README.md

@@ -1,33 +1,33 @@
 # lowdown-proxy
 
-Agents should not have to trust an agent/tool they've never interacted with.
+Agents should not have to trust anyone they've never interacted with.
 
-`lowdown-proxy`는 MCP 클라이언트와 서버 사이를 투명하게 통과하는 stdio 프록시입니다.
-통신 내용은 그대로 전달하면서, 동시에 어떤 도구가 호출됐고 성공/실패했는지, 얼마나
-걸렸는지를 자동으로 기록합니다.
+`lowdown-proxy` records interactions between AI agents, tools, and services — and makes
+that history queryable by anyone. Before choosing a tool, calling an API, or delegating
+to another agent, you can ask: *what has the community seen from this one?*
 
-기록된 데이터는 다른 에이전트가 "이 도구를 써도 되는가"를 판단할 때 참고할 수 있는
-최소한의 공통 근거가 됩니다.
+A transparent stdio proxy for MCP servers is the first entry point. The reputation layer
+is open to any agent, tool, or service — not just MCP.
 
-자세한 배경과 설계 원칙은 [DESIGN.md](./DESIGN.md)를 참고하세요.
+See [DESIGN.md](./DESIGN.md) for background and design principles.
 
-## 설치 없이 실행
+## Quick start
 
 ```bash
 npx lowdown-proxy -- npx some-mcp-server
 ```
 
-기존 MCP 클라이언트 설정에서 서버를 감싸기만 하면 됩니다.
+Wrap any MCP server in your client config:
 
 ```jsonc
-// 기존
+// before
 {
   "mcpServers": {
     "search": { "command": "npx", "args": ["search-mcp-server"] }
   }
 }
 
-// lowdown-proxy로 감싼 뒤
+// after
 {
   "mcpServers": {
     "search": {
@@ -38,37 +38,86 @@ npx lowdown-proxy -- npx some-mcp-server
 }
 ```
 
-## 옵션
+## Options
 
-| 플래그 | 설명 | 기본값 |
+| Flag | Description | Default |
 |---|---|---|
-| `--actor` | 호출 주체 식별자 | `anonymous` |
-| `--target` | 기록될 대상 이름 (도구 식별자) | 실행 명령어 문자열 |
+| `--actor` | Identifier of the calling agent | `anonymous` |
+| `--target` | Label for the target tool | command string |
 | `--source` | `organic` \| `seeded` \| `synthetic` | `organic` |
 
-## 환경변수
+## Environment variables
 
-기록 기능을 쓰려면 아래 두 값이 필요합니다. 없어도 프록시는 정상 동작합니다
-(패스스루가 최우선, 기록은 부가 기능).
+Required for recording. The proxy works as a pure pass-through without them.
 
 ```bash
 export LOWDOWN_SUPABASE_URL="https://xxxx.supabase.co"
 export LOWDOWN_SUPABASE_KEY="..."
 ```
 
-## 설계 원칙 (요약)
+## Public API
 
-- **패스스루 우선**: 기록 로직이 실패하거나 느려도 실제 MCP 통신은 절대 막지 않습니다.
-- **사실만 기록**: v0는 성공/실패/지연시간만 기록합니다. 품질 판단(별점 등)은 범위 밖입니다.
-- **출처 구분**: 모든 기록은 `organic`(자연 유입) / `seeded`(직접 심은 트래픽) /
-  `synthetic`(합성 벤치마크)으로 태깅됩니다. 나중에 "실제 수요가 있었는가"를 검증할 때
-  이 구분이 핵심 근거가 됩니다.
+No auth required.
+
+```bash
+# Get reputation of a tool
+curl https://lowdown-proxy.vercel.app/api/reputation/brave-search
+
+# Record an interaction
+curl -X POST https://lowdown-proxy.vercel.app/api/interactions \
+  -H "Content-Type: application/json" \
+  -d '{"actor":"agent:my-bot","target":"mcp:modelcontextprotocol/brave-search","target_type":"tool","task_type":"web_search","outcome":"success"}'
+```
+
+Example response:
+
+```json
+{
+  "target": "brave-search",
+  "target_type": "tool",
+  "interactions": 30,
+  "success_rate": 0.933,
+  "confidence": "medium"
+}
+```
+
+Fuzzy matching supported — short names like `brave-search`, `fetch`, `github` resolve automatically.
+
+## Design principles
 
-## 상태
+- **Pass-through first**: recording never blocks or degrades MCP communication.
+- **Facts only**: v0 records success/failure and latency. Quality judgments are out of scope.
+- **Provenance always tagged**: every record carries `organic` / `seeded` / `synthetic` so bootstrap data and real traffic are always distinguishable.
 
-이 프로젝트는 2026년 9월 시작된 **30일 공개 실험**입니다. 확장 계획과 소거된 방향들은
-[DESIGN.md](./DESIGN.md)에 정리되어 있습니다.
+## Status
+
+30-day public experiment, started September 2026.
+See [DESIGN.md](./DESIGN.md) for what's in scope and what's been ruled out.
 
 ## License
 
 MIT
+
+---
+
+## 한국어
+
+한 번도 거래한 적 없는 상대를 에이전트가 무조건 신뢰할 필요는 없습니다.
+
+`lowdown-proxy`는 AI 에이전트, 도구, 서비스 사이의 상호작용을 기록하고,
+그 이력을 누구나 조회할 수 있게 만듭니다. 도구를 선택하거나, API를 호출하거나,
+다른 에이전트에게 작업을 위임하기 전에 물어볼 수 있습니다:
+*커뮤니티는 이 상대에 대해 무엇을 봤는가?*
+
+MCP 서버를 감싸는 stdio 프록시가 첫 번째 진입점입니다.
+평판 레이어는 MCP에 국한되지 않고 모든 에이전트, 도구, 서비스에 열려 있습니다.
+
+기록된 데이터는 다른 에이전트가 판단할 때 참고할 수 있는 최소한의 공통 근거가 됩니다.
+
+### 설계 원칙 (요약)
+
+- **패스스루 우선**: 기록 로직이 실패하거나 느려도 실제 MCP 통신은 절대 막지 않습니다.
+- **사실만 기록**: v0는 성공/실패/지연시간만 기록합니다. 품질 판단은 범위 밖입니다.
+- **출처 구분**: 모든 기록은 `organic` / `seeded` / `synthetic`으로 태깅됩니다.
+
+자세한 배경과 설계 원칙은 [DESIGN.md](./DESIGN.md)를 참고하세요.

package/dist/node-identity.js

@@ -0,0 +1,25 @@
+import { randomUUID } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+export function getNodeId() {
+    const dir = join(homedir(), ".lowdown");
+    const file = join(dir, "node.json");
+    if (existsSync(file)) {
+        try {
+            const data = JSON.parse(readFileSync(file, "utf-8"));
+            if (data.node_id)
+                return data.node_id;
+        }
+        catch {
+            // 파일 손상 시 새로 생성
+        }
+    }
+    const identity = {
+        node_id: "ld_" + randomUUID().replace(/-/g, "").slice(0, 12),
+        created_at: new Date().toISOString(),
+    };
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(file, JSON.stringify(identity, null, 2), "utf-8");
+    return identity.node_id;
+}

package/dist/proxy.js

@@ -1,6 +1,7 @@
 import { spawn } from "node:child_process";
 import { createInterface } from "node:readline";
 import { recordInteraction } from "./supabase.js";
+import { getNodeId } from "./node-identity.js";
 /**
  * lowdown-proxy 핵심 로직.
  *
@@ -10,6 +11,7 @@ import { recordInteraction } from "./supabase.js";
  * - tool_execution 성공(JSON-RPC 에러 없음)과 실제 결과 품질은 다른 문제 — v0는 전자만 다룬다.
  */
 export function runProxy(opts) {
+    const nodeId = getNodeId();
     const child = spawn(opts.command, opts.args, {
         stdio: ["pipe", "pipe", "inherit"], // stderr는 그대로 상위로 흘려보냄(디버깅용)
     });
@@ -56,6 +58,7 @@ export function runProxy(opts) {
                     outcome,
                     latency_ms,
                     source: opts.source,
+                    node_id: nodeId,
                 };
                 // fire-and-forget — 응답 전달을 기다리게 하지 않음
                 void recordInteraction(record);

package/dist/supabase.js

@@ -37,6 +37,7 @@ export async function recordInteraction(record) {
             outcome: record.outcome,
             latency_ms: record.latency_ms ?? null,
             source: record.source ?? "organic",
+            node_id: record.node_id ?? null,
         });
         if (error && process.env.LOWDOWN_DEBUG) {
             console.error("[lowdown] interaction 기록 실패:", error.message);

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "lowdown-proxy",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "mcpName": "io.github.PetShopBros/lowdown-proxy",
-  "description": "Transparent stdio proxy that records MCP tool call interactions for the Lowdown reputation experiment.",
+  "description": "Record and query AI agent/tool/service interactions. Shared reputation layer for the multi-agent ecosystem.",
   "type": "module",
   "bin": {
-    "lowdown-proxy": "./dist/cli.js",
-    "lowdown-mcp": "./dist/mcp-server.js"
+    "lowdown-proxy": "dist/cli.js",
+    "lowdown-mcp": "dist/mcp-server.js"
   },
   "main": "./dist/cli.js",
   "files": [
@@ -18,9 +18,11 @@
   },
   "keywords": [
     "mcp",
-    "agent",
+    "ai-agent",
     "reputation",
     "interaction",
+    "proxy",
+    "trust",
     "lowdown"
   ],
   "license": "MIT",
@@ -38,4 +40,4 @@
   "engines": {
     "node": ">=18"
   }
-}
+}