@terminals-tech/agent-zero 1.0.0

package/dist/utils/persistentRateLimiter.js

@@ -0,0 +1,128 @@
+/**
+ * Persistent Rate Limiter
+ *
+ * Rate limiting with persistent storage via Vault.
+ * Survives process restarts and shares state across instances.
+ */
+/**
+ * Sliding window rate limiter with persistent storage.
+ * Stores request timestamps in vault and debounces writes for performance.
+ */
+export class PersistentSlidingWindowLimiter {
+    timestamps = [];
+    maxRequests;
+    windowMs;
+    vault;
+    vaultKey;
+    persistTimer = null;
+    dirty = false;
+    constructor(vault, key, maxRequests, windowMs) {
+        this.vault = vault;
+        this.vaultKey = `ratelimit:${key}`;
+        this.maxRequests = maxRequests;
+        this.windowMs = windowMs;
+    }
+    /**
+     * Load persisted state from vault.
+     * Must be called before using the limiter.
+     */
+    async load() {
+        const stored = await this.vault.retrieve(this.vaultKey);
+        if (stored) {
+            const state = JSON.parse(stored);
+            // Prune stale timestamps on load
+            this.timestamps = state.timestamps.filter(t => Date.now() - t < this.windowMs);
+        }
+        // Debounced persist every 5s to reduce I/O
+        this.persistTimer = setInterval(() => void this.flush(), 5000);
+    }
+    /**
+     * Check if a request is allowed and record it.
+     * @returns true if request is allowed, false if rate limit exceeded
+     */
+    allow() {
+        const now = Date.now();
+        this.timestamps = this.timestamps.filter(t => now - t < this.windowMs);
+        if (this.timestamps.length >= this.maxRequests) {
+            return false;
+        }
+        this.timestamps.push(now);
+        this.dirty = true;
+        return true;
+    }
+    /**
+     * Get remaining request quota.
+     */
+    remaining() {
+        const now = Date.now();
+        this.timestamps = this.timestamps.filter(t => now - t < this.windowMs);
+        return Math.max(0, this.maxRequests - this.timestamps.length);
+    }
+    /**
+     * Force persist current state to vault.
+     */
+    async flush() {
+        if (!this.dirty)
+            return;
+        this.dirty = false;
+        const now = Date.now();
+        this.timestamps = this.timestamps.filter(t => now - t < this.windowMs);
+        await this.vault.store(this.vaultKey, JSON.stringify({ timestamps: this.timestamps }));
+    }
+    /**
+     * Clean up resources and persist final state.
+     */
+    async destroy() {
+        if (this.persistTimer) {
+            clearInterval(this.persistTimer);
+            this.persistTimer = null;
+        }
+        await this.flush();
+    }
+}
+/**
+ * Cooldown-based rate limiter with persistent storage.
+ * Enforces minimum time between actions.
+ */
+export class PersistentCooldownLimiter {
+    lastAction = 0;
+    cooldownMs;
+    vault;
+    vaultKey;
+    constructor(vault, key, cooldownMs) {
+        this.vault = vault;
+        this.vaultKey = `cooldown:${key}`;
+        this.cooldownMs = cooldownMs;
+    }
+    /**
+     * Load persisted state from vault.
+     * Must be called before using the limiter.
+     */
+    async load() {
+        const stored = await this.vault.retrieve(this.vaultKey);
+        if (stored) {
+            const state = JSON.parse(stored);
+            this.lastAction = state.lastAction || 0;
+        }
+    }
+    /**
+     * Check if an action is allowed and record it.
+     * @returns true if action is allowed, false if still in cooldown
+     */
+    async allow() {
+        const now = Date.now();
+        if (now - this.lastAction < this.cooldownMs) {
+            return false;
+        }
+        this.lastAction = now;
+        await this.vault.store(this.vaultKey, JSON.stringify({ lastAction: this.lastAction }));
+        return true;
+    }
+    /**
+     * Get remaining cooldown time in milliseconds.
+     */
+    remainingMs() {
+        return Math.max(0, this.cooldownMs - (Date.now() - this.lastAction));
+    }
+}
+//# sourceMappingURL=persistentRateLimiter.js.map

package/dist/utils/persistentRateLimiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistentRateLimiter.js","sourceRoot":"","sources":["../../src/utils/persistentRateLimiter.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "@terminals-tech/agent-zero",
+  "version": "1.0.0",
+  "description": "Secure primitives for autonomous systems. Kuramoto coherence, thermodynamic routing, capability-based security, encrypted vault. Built by systems intelligence.",
+  "type": "module",
+  "main": "dist/primitives/index.js",
+  "types": "dist/primitives/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/primitives/index.js",
+      "types": "./dist/primitives/index.d.ts"
+    },
+    "./runtime": {
+      "import": "./dist/runtime/index.js",
+      "types": "./dist/runtime/index.d.ts"
+    },
+    "./security": {
+      "import": "./dist/security/index.js",
+      "types": "./dist/security/index.d.ts"
+    },
+    "./resonance": {
+      "import": "./dist/resonance/index.js",
+      "types": "./dist/resonance/index.d.ts"
+    },
+    "./routing": {
+      "import": "./dist/routing/index.js",
+      "types": "./dist/routing/index.d.ts"
+    }
+  },
+  "bin": {
+    "agent-zero": "./bin/agent-zero.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "build:skill": "tsc && cp SKILL.md skill.json dist/",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "rail": "node dist/rail/index.js",
+    "test": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "agent",
+    "multi-agent",
+    "kuramoto",
+    "thermodynamic-routing",
+    "capability-security",
+    "encrypted-vault",
+    "phase-synchronization",
+    "agent-coordination",
+    "terminals-tech",
+    "agent-zero"
+  ],
+  "author": "terminals.tech",
+  "license": "MIT",
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.35.0",
+    "@electric-sql/pglite": "^0.2.0",
+    "@hapi/boom": "^10.0.1",
+    "@terminals-tech/core": "^0.1.1",
+    "@terminals-tech/embeddings": "^0.1.0",
+    "@terminals-tech/graph": "^0.1.0",
+    "@whiskeysockets/baileys": "^6.7.0",
+    "agent-twitter-client": "^0.0.18",
+    "chalk": "^5.3.0",
+    "dotenv": "^17.2.3",
+    "eventemitter3": "^5.0.1",
+    "grammy": "^1.30.0",
+    "qrcode-terminal": "^0.12.0",
+    "ws": "^8.18.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/qrcode-terminal": "^0.12.2",
+    "@types/ws": "^8.5.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.0.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wheattoast11/agent-zero-openclaw"
+  },
+  "homepage": "https://terminals.tech"
+}