@tickrmeter/ai-usage 0.1.2 → 0.1.3

package/README.md

@@ -15,7 +15,7 @@ Privacy-preserving personal subscription monitoring for Codex / ChatGPT and Clau
 4. The helper detects the Codex desktop app, Codex CLI, and Claude Code, uploads normalized limit metadata, and installs a user-scoped five-minute sync using Task Scheduler, launchd, or a systemd user timer (cron fallback).
 
 The initial `npx` command installs a fixed copy under `~/.tickrmeter-ai/app`. Scheduled runs invoke that fixed version, never `npx ...@latest`.
-On Windows, Task Scheduler invokes that installed Node CLI directly. The helper does not install or execute hidden VBS, WScript, or PowerShell wrappers.
+On Windows, a standard per-user Startup entry starts the installed Node CLI once at sign-in. The CLI launches one background agent that performs the five-minute sync without recurring console windows. The helper does not install or execute hidden VBS, WScript, or PowerShell wrappers.
 
 ## Commands
 

package/dist/agent.js

@@ -0,0 +1,108 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runBackgroundAgent = exports.runAgentLoop = exports.stopBackgroundAgent = exports.startBackgroundAgent = exports.AGENT_INTERVAL_MS = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const child_process_1 = require("child_process");
+const scheduler_1 = require("./scheduler");
+const storage_1 = require("./storage");
+const sync_1 = require("./sync");
+exports.AGENT_INTERVAL_MS = 5 * 60 * 1000;
+const agentPidPath = () => path_1.default.join((0, storage_1.getDataDir)(), "agent.pid");
+const readAgentPid = () => {
+    try {
+        const value = Number(fs_1.default.readFileSync(agentPidPath(), "utf8").trim());
+        return Number.isInteger(value) && value > 0 ? value : null;
+    }
+    catch {
+        return null;
+    }
+};
+const isProcessRunning = (pid) => {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error?.code === "EPERM";
+    }
+};
+const clearAgentPid = (expectedPid) => {
+    if (expectedPid !== undefined && readAgentPid() !== expectedPid)
+        return;
+    fs_1.default.rmSync(agentPidPath(), { force: true });
+};
+const startBackgroundAgent = (spawner = child_process_1.spawn, nodePath = (0, scheduler_1.resolveNodePath)(), cliPath = (0, storage_1.getInstalledCliPath)()) => {
+    const existingPid = readAgentPid();
+    if (existingPid && isProcessRunning(existingPid))
+        return { started: false, pid: existingPid };
+    clearAgentPid();
+    const child = spawner(nodePath, [cliPath, "agent"], {
+        detached: true,
+        windowsHide: true,
+        stdio: "ignore",
+    });
+    if (!child.pid)
+        throw new Error("AI_USAGE_AGENT_START_FAILED");
+    (0, storage_1.atomicWriteFile)(agentPidPath(), `${child.pid}\n`);
+    child.unref();
+    return { started: true, pid: child.pid };
+};
+exports.startBackgroundAgent = startBackgroundAgent;
+const stopBackgroundAgent = () => {
+    const pid = readAgentPid();
+    if (!pid)
+        return { stopped: false };
+    if (pid !== process.pid && isProcessRunning(pid)) {
+        try {
+            process.kill(pid);
+        }
+        catch {
+            // The agent also exits when the bridge config is removed.
+        }
+    }
+    clearAgentPid(pid);
+    return { stopped: true };
+};
+exports.stopBackgroundAgent = stopBackgroundAgent;
+const wait = (milliseconds) => new Promise((resolve) => setTimeout(resolve, milliseconds));
+const runAgentLoop = async (syncer = sync_1.syncPersonalUsage, shouldContinue = () => Boolean((0, storage_1.readConfig)()), sleeper = wait, intervalMs = exports.AGENT_INTERVAL_MS) => {
+    while (shouldContinue()) {
+        await sleeper(intervalMs);
+        if (!shouldContinue())
+            break;
+        try {
+            await syncer();
+        }
+        catch {
+            // A temporary provider/network error must not stop future syncs.
+        }
+    }
+};
+exports.runAgentLoop = runAgentLoop;
+const runBackgroundAgent = async () => {
+    const existingPid = readAgentPid();
+    if (existingPid && existingPid !== process.pid && isProcessRunning(existingPid))
+        return;
+    (0, storage_1.atomicWriteFile)(agentPidPath(), `${process.pid}\n`);
+    const cleanup = () => clearAgentPid(process.pid);
+    process.once("exit", cleanup);
+    process.once("SIGINT", () => {
+        cleanup();
+        process.exit(0);
+    });
+    process.once("SIGTERM", () => {
+        cleanup();
+        process.exit(0);
+    });
+    try {
+        await (0, exports.runAgentLoop)();
+    }
+    finally {
+        cleanup();
+    }
+};
+exports.runBackgroundAgent = runBackgroundAgent;

package/dist/cli.js

@@ -2,6 +2,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const claude_1 = require("./claude");
+const agent_1 = require("./agent");
 const codex_1 = require("./codex");
 const http_1 = require("./http");
 const scheduler_1 = require("./scheduler");
@@ -61,6 +62,8 @@ const connect = async (code, server) => {
         console.log(`Claude Code capture not installed: ${claudeInstall.code}`);
     const report = await (0, sync_1.syncPersonalUsage)();
     report.providers.forEach(printProvider);
+    if (process.platform === "win32")
+        (0, agent_1.startBackgroundAgent)();
     if (!report.uploaded.length)
         console.log("No provider snapshot was available yet. Run tickrmeter-ai doctor for setup help.");
 };
@@ -73,6 +76,8 @@ const sync = async () => {
             (0, scheduler_1.ensureScheduler)();
     }
     const report = await (0, sync_1.syncPersonalUsage)();
+    if (process.platform === "win32")
+        (0, agent_1.startBackgroundAgent)();
     console.log(report.uploaded.length ? `Uploaded: ${report.uploaded.join(", ")}` : "No snapshots available to upload.");
     report.providers.filter((provider) => !provider.ok).forEach(printProvider);
 };
@@ -120,6 +125,7 @@ const disconnect = async () => {
             console.log("Bridge could not be revoked online; local credentials will still be removed.");
         }
     }
+    (0, agent_1.stopBackgroundAgent)();
     (0, scheduler_1.uninstallScheduler)();
     (0, claude_1.uninstallClaudeStatusLine)();
     (0, storage_1.removeLocalBridgeCredential)();
@@ -149,6 +155,10 @@ const main = async () => {
         return doctor();
     if (command === "disconnect")
         return disconnect();
+    if (command === "start-agent")
+        return (0, agent_1.startBackgroundAgent)();
+    if (command === "agent")
+        return (0, agent_1.runBackgroundAgent)();
     return help();
 };
 main().catch((error) => {

package/dist/scheduler.js

@@ -3,17 +3,19 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.uninstallScheduler = exports.ensureScheduler = exports.installScheduler = exports.buildCronLine = exports.buildSystemdTimer = exports.buildSystemdService = exports.buildLaunchAgentPlist = exports.buildWindowsTaskArgs = exports.getFixedSyncCommand = exports.resolveNodePath = exports.SCHEDULER_VERSION = exports.CRON_MARKER = exports.SYSTEMD_NAME = exports.LAUNCH_AGENT_LABEL = exports.WINDOWS_TASK_NAME = void 0;
+exports.uninstallScheduler = exports.ensureScheduler = exports.installScheduler = exports.buildCronLine = exports.buildSystemdTimer = exports.buildSystemdService = exports.buildLaunchAgentPlist = exports.buildWindowsRunArgs = exports.getFixedAgentStartCommand = exports.getFixedSyncCommand = exports.resolveNodePath = exports.SCHEDULER_VERSION = exports.CRON_MARKER = exports.SYSTEMD_NAME = exports.LAUNCH_AGENT_LABEL = exports.WINDOWS_RUN_VALUE_NAME = exports.WINDOWS_RUN_KEY = exports.WINDOWS_TASK_NAME = void 0;
 const fs_1 = __importDefault(require("fs"));
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
 const child_process_1 = require("child_process");
 const storage_1 = require("./storage");
 exports.WINDOWS_TASK_NAME = "TickrMeter AI Usage Sync";
+exports.WINDOWS_RUN_KEY = "HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Run";
+exports.WINDOWS_RUN_VALUE_NAME = "TickrMeter AI Usage";
 exports.LAUNCH_AGENT_LABEL = "com.tickrmeter.ai-usage";
 exports.SYSTEMD_NAME = "tickrmeter-ai-usage";
 exports.CRON_MARKER = "# TickrMeter AI Usage Sync";
-exports.SCHEDULER_VERSION = 3;
+exports.SCHEDULER_VERSION = 5;
 const quoteShell = (value) => `"${value.replace(/"/g, '\\"')}"`;
 const resolveNodePath = (nodePath = process.execPath) => {
     try {
@@ -26,20 +28,21 @@ const resolveNodePath = (nodePath = process.execPath) => {
 exports.resolveNodePath = resolveNodePath;
 const getFixedSyncCommand = (nodePath = (0, exports.resolveNodePath)(), cliPath = (0, storage_1.getInstalledCliPath)()) => `${quoteShell(nodePath)} ${quoteShell(cliPath)} sync`;
 exports.getFixedSyncCommand = getFixedSyncCommand;
+const getFixedAgentStartCommand = (nodePath = (0, exports.resolveNodePath)(), cliPath = (0, storage_1.getInstalledCliPath)()) => `${quoteShell(nodePath)} ${quoteShell(cliPath)} start-agent`;
+exports.getFixedAgentStartCommand = getFixedAgentStartCommand;
 const legacyWindowsSyncScriptPath = () => path_1.default.join((0, storage_1.getDataDir)(), "sync-hidden.vbs");
-const buildWindowsTaskArgs = (command = (0, exports.getFixedSyncCommand)()) => [
-    "/Create",
-    "/TN",
-    exports.WINDOWS_TASK_NAME,
-    "/TR",
+const buildWindowsRunArgs = (command = (0, exports.getFixedAgentStartCommand)()) => [
+    "ADD",
+    exports.WINDOWS_RUN_KEY,
+    "/V",
+    exports.WINDOWS_RUN_VALUE_NAME,
+    "/T",
+    "REG_SZ",
+    "/D",
     command,
-    "/SC",
-    "MINUTE",
-    "/MO",
-    "5",
     "/F",
 ];
-exports.buildWindowsTaskArgs = buildWindowsTaskArgs;
+exports.buildWindowsRunArgs = buildWindowsRunArgs;
 const buildLaunchAgentPlist = (nodePath = (0, exports.resolveNodePath)(), cliPath = (0, storage_1.getInstalledCliPath)()) => `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0"><dict>
@@ -100,11 +103,12 @@ const installCron = (runner = run) => {
 const installScheduler = (platform = process.platform, runner = run) => {
     let kind;
     if (platform === "win32") {
-        const result = runner("schtasks", (0, exports.buildWindowsTaskArgs)());
+        const result = runner("reg", (0, exports.buildWindowsRunArgs)());
         if (result.status !== 0)
             throw new Error("AI_USAGE_SCHEDULER_INSTALL_FAILED");
+        runner("schtasks", ["/Delete", "/TN", exports.WINDOWS_TASK_NAME, "/F"]);
         fs_1.default.rmSync(legacyWindowsSyncScriptPath(), { force: true });
-        kind = "windows-task";
+        kind = "windows-startup";
     }
     else if (platform === "darwin") {
         const file = launchAgentPath();
@@ -145,7 +149,8 @@ exports.ensureScheduler = ensureScheduler;
 const uninstallScheduler = (runner = run) => {
     const state = (0, storage_1.readState)();
     const kind = state.scheduler?.kind;
-    if (kind === "windows-task") {
+    if (state.scheduler?.platform === "win32") {
+        runner("reg", ["DELETE", exports.WINDOWS_RUN_KEY, "/V", exports.WINDOWS_RUN_VALUE_NAME, "/F"]);
         runner("schtasks", ["/Delete", "/TN", exports.WINDOWS_TASK_NAME, "/F"]);
     }
     fs_1.default.rmSync(legacyWindowsSyncScriptPath(), { force: true });

package/dist/storage.js

@@ -7,7 +7,7 @@ exports.removeLocalBridgeCredential = exports.installFixedCliCopy = exports.writ
 const fs_1 = __importDefault(require("fs"));
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
-exports.CLI_VERSION = "0.1.2";
+exports.CLI_VERSION = "0.1.3";
 const getDataDir = () => process.env.TICKRMETER_AI_HOME || path_1.default.join(os_1.default.homedir(), ".tickrmeter-ai");
 exports.getDataDir = getDataDir;
 const getConfigPath = () => path_1.default.join((0, exports.getDataDir)(), "config.json");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tickrmeter/ai-usage",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Privacy-preserving TickrMeter personal AI usage bridge",
   "license": "UNLICENSED",
   "publishConfig": {