agentosity 0.1.0

package/bin/agentosity.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { main } from "../src/index.js";
+
+main(process.argv.slice(2)).catch((err) => {
+  console.error(err?.message ?? err);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "agentosity",
+  "version": "0.1.0",
+  "description": "Agentosity — AI-native is a number now. Automatic attendance for your AI agents (stdio MCP lifecycle + activity probes) + human clock-out CLI.",
+  "type": "module",
+  "bin": {
+    "agentosity": "./bin/agentosity.js"
+  },
+  "files": ["bin", "src"],
+  "engines": { "node": ">=18" },
+  "keywords": ["mcp", "agent", "agent-hours", "claude-code", "codex", "xiabanbang"],
+  "homepage": "https://agentosity.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/realethanyang/agentosity.git",
+    "directory": "packages/cli"
+  },
+  "license": "MIT"
+}

package/src/api.js

@@ -0,0 +1,32 @@
+import { apiBase, loadConfig } from "./config.js";
+
+function authHeaders() {
+  const t = loadConfig().accessToken;
+  return t ? { Authorization: `Bearer ${t}` } : {};
+}
+
+/** 所有请求 best-effort:考勤进程绝不能因为网络问题影响宿主 harness */
+export async function post(path, body, { timeoutMs = 8000 } = {}) {
+  try {
+    const res = await fetch(`${apiBase()}${path}`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", ...authHeaders() },
+      body: JSON.stringify(body),
+      signal: AbortSignal.timeout(timeoutMs),
+    });
+    return await res.json();
+  } catch {
+    return null;
+  }
+}
+
+export async function get(path, { timeoutMs = 8000 } = {}) {
+  try {
+    const res = await fetch(`${apiBase()}${path}`, {
+      signal: AbortSignal.timeout(timeoutMs),
+    });
+    return await res.json();
+  } catch {
+    return null;
+  }
+}

package/src/config.js

@@ -0,0 +1,31 @@
+import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { randomUUID } from "node:crypto";
+
+const DIR = join(homedir(), ".agentosity");
+const FILE = join(DIR, "config.json");
+
+export function loadConfig() {
+  try {
+    return JSON.parse(readFileSync(FILE, "utf8"));
+  } catch {
+    return {};
+  }
+}
+
+export function saveConfig(patch) {
+  const cfg = { ...loadConfig(), ...patch };
+  if (!cfg.deviceId) cfg.deviceId = randomUUID();
+  mkdirSync(DIR, { recursive: true });
+  writeFileSync(FILE, JSON.stringify(cfg, null, 2));
+  return cfg;
+}
+
+export function apiBase() {
+  return (
+    process.env.AGENTOSITY_API ||
+    loadConfig().apiBase ||
+    "https://agentosity.com"
+  );
+}

package/src/index.js

@@ -0,0 +1,135 @@
+import { execFileSync } from "node:child_process";
+import { loadConfig, saveConfig, apiBase } from "./config.js";
+import { post, get } from "./api.js";
+import { serve } from "./mcp.js";
+
+export async function main(argv) {
+  const cmd = argv[0] ?? "help";
+  switch (cmd) {
+    case "serve": {
+      const cfg = loadConfig();
+      serve({ company: argv[1] || cfg.company });
+      return; // 常驻,直到 harness 关闭
+    }
+    case "init":
+      return init(argv.slice(1).join(" ").trim());
+    case "clockout":
+      return clockout();
+    case "status":
+      return status();
+    case "login":
+      return login(argv[1], argv[2]);
+    default:
+      console.log(`agentosity — AI-native is a number now.
+
+用法:
+  npx agentosity init <公司名>    绑定公司 + 给 harness 装上自动考勤
+  npx agentosity clockout         人类下班打卡
+  npx agentosity status           看榜:在岗 Agent / Agent 加班榜
+  npx agentosity login <邮箱>     发验证码;再跑 login <邮箱> <验证码> 完成登录
+  npx agentosity serve            (由 harness 自动拉起)stdio MCP 考勤进程
+`);
+  }
+}
+
+async function init(company) {
+  if (!company) {
+    console.error("用法:npx agentosity init <公司名>");
+    process.exit(1);
+  }
+  const cfg = saveConfig({ company });
+  console.log(`✅ 已绑定公司:${company}`);
+
+  // Claude Code:有 claude CLI 就直接装
+  let claudeOk = false;
+  try {
+    execFileSync("claude", ["mcp", "add", "--scope", "user", "agentosity", "--", "npx", "-y", "agentosity", "serve"], {
+      stdio: "pipe",
+      timeout: 15000,
+    });
+    claudeOk = true;
+    console.log("✅ Claude Code:已注册 MCP 考勤(全局)");
+  } catch {
+    /* 没装 claude CLI,走手动 */
+  }
+
+  console.log(`
+从现在起,你的 Agent 会话会自动打卡考勤——模型零参与,只上报时长,不读任何内容。
+
+${claudeOk ? "" : `Claude Code 手动配置:
+  claude mcp add --scope user agentosity -- npx -y agentosity serve
+`}Codex CLI(~/.codex/config.toml 追加):
+  [mcp_servers.agentosity]
+  command = "npx"
+  args = ["-y", "agentosity", "serve"]
+
+其他支持 stdio MCP 的 harness 同理:命令 npx,参数 -y agentosity serve
+
+看榜:${apiBase()}/agents
+设备 ID:${cfg.deviceId}
+`);
+}
+
+async function login(email, code) {
+  if (!email) {
+    console.error("用法:npx agentosity login <邮箱>,收到验证码后再跑 login <邮箱> <验证码>");
+    process.exit(1);
+  }
+  if (!code) {
+    const r = await post("/api/auth/send", { email });
+    if (r?.ok) console.log(`✅ 验证码已发到 ${email},收到后跑:npx agentosity login ${email} <验证码>`);
+    else {
+      console.error(`发送失败:${r?.error ?? "网络不可达"}`);
+      process.exit(1);
+    }
+    return;
+  }
+  const cfg = saveConfig({}); // 确保 deviceId 存在
+  const r = await post("/api/auth/verify", { email, code, deviceId: cfg.deviceId });
+  if (r?.ok) {
+    saveConfig({ email: r.email, accessToken: r.access_token });
+    console.log(`✅ 已登录 ${r.email},这台设备的历史记录已并入账号`);
+  } else {
+    console.error(`登录失败:${r?.error ?? "验证码不对或已过期"}`);
+    process.exit(1);
+  }
+}
+
+async function clockout() {
+  const cfg = loadConfig();
+  if (!cfg.company) {
+    console.error("还没绑定公司,先跑:npx agentosity init <公司名>");
+    process.exit(1);
+  }
+  const list = await get(`/api/companies?q=${encodeURIComponent(cfg.company)}`);
+  const match = list?.find?.((c) => c.name === cfg.company) ?? list?.[0];
+  if (!match) {
+    console.error(`找不到公司「${cfg.company}」,检查网络或重新 init`);
+    process.exit(1);
+  }
+  const r = await post("/api/checkin", { companyId: match.id, deviceId: cfg.deviceId });
+  if (r?.ok) {
+    console.log(`✅ 下班快乐!${cfg.company} · ${r.clocked_local}`);
+    if (r.note) console.log(`   ${r.note}`);
+    console.log(`   明早 10:00 揭榜:${apiBase()}/me`);
+  } else {
+    console.error(`打卡失败:${r?.error ?? "网络不可达"}`);
+    process.exit(1);
+  }
+}
+
+async function status() {
+  const d = await get("/api/agents");
+  if (!d?.live) {
+    console.error("拿不到数据,检查网络");
+    process.exit(1);
+  }
+  console.log(`🤖 此刻全网 ${d.live.total} 个 Agent 在岗\n`);
+  console.log("Agent 加班榜(近 7 天,Active Agent-Hours):");
+  (d.board ?? []).slice(0, 10).forEach((r, i) => {
+    const live = r.live_now > 0 ? ` · ● 在岗 ${r.live_now}` : "";
+    console.log(
+      `${String(i + 1).padStart(2)}. ${r.name} — ${r.active_hours}h · 会话 ${r.sessions} · 加班 ${r.overtime_hours}h · Leverage ${r.leverage ?? "—"}${live}`
+    );
+  });
+}

package/src/mcp.js

@@ -0,0 +1,161 @@
+import { createInterface } from "node:readline";
+import { post, get } from "./api.js";
+import { detectHarness, createProbe } from "./probes.js";
+
+const TICK_MS = parseInt(process.env.AGENTOSITY_TICK_MS ?? "", 10) || 15_000; // 活跃度采样间隔
+const HEARTBEAT_MS = parseInt(process.env.AGENTOSITY_HB_MS ?? "", 10) || 60_000; // 上报间隔;服务端以最后心跳结算,误差 ≤1min
+
+/**
+ * stdio MCP 考勤服务:harness 拉起本进程即上班,杀掉即下班。
+ * 模型零参与:initialize 握手 = start,stdin EOF / SIGTERM = end(遗言),心跳为准。
+ */
+export function serve({ company }) {
+  const startMs = Date.now();
+  let sessionId = null;
+  let startPromise = null;
+  let harness = "unknown";
+  let probe = null;
+  let probeLabel = "none";
+  let activeSeconds = 0;
+  let lastTick = Date.now();
+  let ended = false;
+
+  const write = (msg) => process.stdout.write(JSON.stringify(msg) + "\n");
+
+  function startSession() {
+    if (!company || startPromise) return;
+    startPromise = post("/api/agent/start", { company, harness, probe: probeLabel }).then((r) => {
+      if (r?.session_id) sessionId = r.session_id;
+    });
+  }
+
+  const tickTimer = setInterval(() => {
+    const now = Date.now();
+    if (probe) {
+      try {
+        const s = probe.sample();
+        probeLabel = s.probe;
+        if (s.active) {
+          activeSeconds = Math.min(
+            activeSeconds + Math.round((now - lastTick) / 1000),
+            Math.round((now - startMs) / 1000) // 活跃时长不可能超过在岗墙钟
+          );
+        }
+      } catch {
+        /* 探针永不致命 */
+      }
+    }
+    lastTick = now;
+  }, TICK_MS);
+
+  const hbTimer = setInterval(() => {
+    if (sessionId) {
+      post("/api/agent/heartbeat", {
+        session_id: sessionId,
+        active_seconds: activeSeconds,
+        probe: probeLabel,
+      });
+    }
+  }, HEARTBEAT_MS);
+
+  async function endSession(code = 0) {
+    if (ended) return;
+    ended = true;
+    clearInterval(tickTimer);
+    clearInterval(hbTimer);
+    // start 可能还在途(会话开得快关得也快时):先等它落地,才能报 end
+    if (startPromise) {
+      await Promise.race([startPromise, new Promise((r) => setTimeout(r, 3000))]);
+    }
+    if (sessionId) {
+      // 遗言:harness 关闭时抢发,超时就放弃(服务端有心跳兜底)
+      await post(
+        "/api/agent/end",
+        { session_id: sessionId, active_seconds: activeSeconds },
+        { timeoutMs: 2500 }
+      );
+    }
+    process.exit(code);
+  }
+  process.on("SIGTERM", () => endSession());
+  process.on("SIGINT", () => endSession());
+  process.on("SIGHUP", () => endSession());
+
+  const rl = createInterface({ input: process.stdin, terminal: false });
+  rl.on("close", () => endSession());
+
+  rl.on("line", async (line) => {
+    let msg;
+    try {
+      msg = JSON.parse(line);
+    } catch {
+      return;
+    }
+    try {
+      await handle(msg);
+    } catch {
+      if (msg?.id !== undefined) {
+        write({ jsonrpc: "2.0", id: msg.id, error: { code: -32603, message: "Internal error" } });
+      }
+    }
+  });
+
+  async function handle(msg) {
+    switch (msg.method) {
+      case "initialize": {
+        harness = detectHarness(msg.params?.clientInfo);
+        probe = createProbe(harness, startMs);
+        write({
+          jsonrpc: "2.0",
+          id: msg.id,
+          result: {
+            protocolVersion: msg.params?.protocolVersion ?? "2024-11-05",
+            capabilities: { tools: {} },
+            serverInfo: { name: "agentosity", version: "0.1.0" },
+          },
+        });
+        startSession();
+        break;
+      }
+      case "notifications/initialized":
+      case "notifications/cancelled":
+        break;
+      case "ping":
+        write({ jsonrpc: "2.0", id: msg.id, result: {} });
+        break;
+      case "tools/list":
+        write({
+          jsonrpc: "2.0",
+          id: msg.id,
+          result: {
+            tools: [
+              {
+                name: "agentosity_status",
+                description:
+                  "查看下班榜 / Agentosity 实时榜单:当前在岗 Agent 数、Agent 加班榜前五。打卡是自动的,此工具仅供查询。",
+                inputSchema: { type: "object", properties: {} },
+              },
+            ],
+          },
+        });
+        break;
+      case "tools/call": {
+        let text = "暂时拿不到榜单数据(网络不可达)。考勤不受影响,打卡是自动的。";
+        const d = await get("/api/agents");
+        if (d?.live) {
+          const rows = (d.board ?? [])
+            .slice(0, 5)
+            .map((r, i) => `${i + 1}. ${r.name} — Active ${r.active_hours}h · 在岗 ${r.live_now}`)
+            .join("\n");
+          text = `此刻全网 ${d.live.total} 个 Agent 在岗。\n\nAgent 加班榜(近 7 天):\n${rows}`;
+        }
+        write({ jsonrpc: "2.0", id: msg.id, result: { content: [{ type: "text", text }] } });
+        break;
+      }
+      default:
+        if (msg.id !== undefined) {
+          write({ jsonrpc: "2.0", id: msg.id, error: { code: -32601, message: "Method not found" } });
+        }
+    }
+  }
+}

package/src/probes.js

@@ -0,0 +1,145 @@
+import { readdirSync, statSync, openSync, readSync, closeSync, fstatSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { execFileSync } from "node:child_process";
+
+/**
+ * 活跃度探针:回答"此刻 Agent 是否在干活"。
+ * 三信号取并集:会话文件最近有写入 / 尾巴是在途工具调用 / harness 有活跃子进程。
+ * 只 stat 文件、只解析最后一行的事件类型字段,绝不读取对话内容。
+ */
+
+const RECENT_WRITE_MS = 90_000; // 距上次写盘 90s 内视为活跃(覆盖流式输出间隙)
+
+export function detectHarness(clientInfo) {
+  const n = (clientInfo?.name ?? "").toLowerCase();
+  if (n.includes("claude")) return "claude-code";
+  if (n.includes("codex")) return "codex";
+  if (n.includes("gemini")) return "gemini-cli";
+  if (n.includes("cursor")) return "cursor";
+  if (n.includes("cline")) return "cline";
+  return n || "unknown";
+}
+
+/** Claude Code:~/.claude/projects/<cwd-slug>/<session>.jsonl */
+function claudeSessionDir() {
+  const slug = process.cwd().replace(/[/.\s_]/g, "-");
+  return join(homedir(), ".claude", "projects", slug);
+}
+
+/** Codex:~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl */
+function codexSessionDir() {
+  const d = new Date();
+  return join(
+    homedir(), ".codex", "sessions",
+    String(d.getFullYear()),
+    String(d.getMonth() + 1).padStart(2, "0"),
+    String(d.getDate()).padStart(2, "0")
+  );
+}
+
+export function createProbe(harness, processStartMs) {
+  const state = {
+    kind: "none",
+    file: null,
+    lastMtimeMs: 0,
+    lastWriteAt: 0,
+  };
+
+  const dirOf = { "claude-code": claudeSessionDir, codex: codexSessionDir }[harness];
+
+  function bindFile() {
+    if (state.file || !dirOf) return;
+    try {
+      const dir = dirOf();
+      const candidates = readdirSync(dir)
+        .filter((f) => f.endsWith(".jsonl"))
+        .map((f) => {
+          const p = join(dir, f);
+          const st = statSync(p);
+          return { p, birth: st.birthtimeMs || st.ctimeMs, mtime: st.mtimeMs };
+        })
+        // 会话文件在首条消息时才创建,允许比进程启动早 2 分钟(时钟偏差)之后的任何时间
+        .filter((c) => c.birth >= processStartMs - 120_000)
+        .sort((a, b) => b.birth - a.birth);
+      if (candidates.length > 0) {
+        state.file = candidates[0].p;
+        state.kind = "file-mtime";
+        state.lastMtimeMs = candidates[0].mtime;
+        state.lastWriteAt = Date.now();
+      }
+    } catch {
+      /* 目录不存在/无权限 → 保持降级 */
+    }
+  }
+
+  /** 信号 1:文件最近有写入 */
+  function recentWrite() {
+    if (!state.file) return false;
+    try {
+      const st = statSync(state.file);
+      if (st.mtimeMs > state.lastMtimeMs) {
+        state.lastMtimeMs = st.mtimeMs;
+        state.lastWriteAt = Date.now();
+      }
+      return Date.now() - state.lastWriteAt < RECENT_WRITE_MS;
+    } catch {
+      state.file = null; // 文件消失 → 解绑重找
+      state.kind = "none";
+      return false;
+    }
+  }
+
+  /** 信号 2:尾巴状态 — 最后一个事件是发起工具调用且尚无结果 → 工具在途 */
+  function toolInFlight() {
+    if (!state.file) return false;
+    try {
+      const fd = openSync(state.file, "r");
+      const size = fstatSync(fd).size;
+      const len = Math.min(size, 64 * 1024);
+      const buf = Buffer.alloc(len);
+      readSync(fd, buf, 0, len, size - len);
+      closeSync(fd);
+      const lines = buf.toString("utf8").split("\n").filter((l) => l.trim());
+      const last = lines[lines.length - 1];
+      if (!last) return false;
+      // 只判断事件形态,不读内容:tool_use 出现且其后无 tool_result
+      const lastToolUse = last.lastIndexOf('"tool_use"');
+      const lastToolResult = last.lastIndexOf('"tool_result"');
+      return lastToolUse > -1 && lastToolUse > lastToolResult;
+    } catch {
+      return false;
+    }
+  }
+
+  /** 信号 3:harness(父进程)有除本进程外的子进程在跑(长工具调用) */
+  function childActive() {
+    try {
+      const out = execFileSync("pgrep", ["-P", String(process.ppid)], {
+        encoding: "utf8",
+        timeout: 3000,
+      });
+      const others = out
+        .split("\n")
+        .map((s) => parseInt(s, 10))
+        .filter((pid) => pid && pid !== process.pid);
+      return others.length > 0;
+    } catch {
+      return false; // pgrep 无匹配时 exit 1,也走这里 → 视为无子进程
+    }
+  }
+
+  return {
+    /** 每个 tick 调用:返回 { active, probe } */
+    sample() {
+      bindFile();
+      const signals = {
+        write: recentWrite(),
+        inflight: toolInFlight(),
+        child: childActive(),
+      };
+      const probe = state.kind === "file-mtime" ? "file-mtime" : "proc-tree";
+      return { active: signals.write || signals.inflight || signals.child, probe, signals };
+    },
+  };
+}