@salimassili/ai-costguard 2.0.0 → 2.0.1

package/examples/integrations/openai-agent-loop.mjs

@@ -1,44 +1,44 @@
-import { guard, GuardError } from '@salimassili/ai-costguard';
-
-const fakeOpenAI = {
-  chat: {
-    completions: {
-      create: async (request) => ({
-        id: `mock-${request.messages.length}`,
-        choices: [{ message: { content: 'mocked OpenAI response' } }],
-        usage: { prompt_tokens: 24, completion_tokens: request.max_tokens ?? 16 },
-      }),
-    },
-  },
-};
-
-const openai = guard(fakeOpenAI, {
-  budget: 1,
-  loopSimilarityThreshold: 0.9,
-  loopMinRepeats: 2,
-  scope: { projectId: 'openai-agent-demo', sessionId: 'run-1' },
-});
-
-let blocked = false;
-
-for (let step = 1; step <= 3; step++) {
-  try {
-    await openai.chat.completions.create({
-      model: 'gpt-4o-mini',
-      messages: [{ role: 'user', content: 'inspect the same failing tool result and try to continue' }],
-      max_tokens: 64,
-    });
-  } catch (error) {
-    if (error instanceof GuardError) {
-      blocked = true;
-      console.log(JSON.stringify({ blocked, step, code: error.code }, null, 2));
-      break;
-    }
-
-    throw error;
-  }
-}
-
-if (!blocked) {
-  throw new Error('Expected loop protection to block the repeated agent prompt.');
-}
+import { guard, GuardError } from '@salimassili/ai-costguard';
+
+const fakeOpenAI = {
+  chat: {
+    completions: {
+      create: async (request) => ({
+        id: `mock-${request.messages.length}`,
+        choices: [{ message: { content: 'mocked OpenAI response' } }],
+        usage: { prompt_tokens: 24, completion_tokens: request.max_tokens ?? 16 },
+      }),
+    },
+  },
+};
+
+const openai = guard(fakeOpenAI, {
+  budget: 1,
+  loopSimilarityThreshold: 0.9,
+  loopMinRepeats: 2,
+  scope: { projectId: 'openai-agent-demo', sessionId: 'run-1' },
+});
+
+let blocked = false;
+
+for (let step = 1; step <= 3; step++) {
+  try {
+    await openai.chat.completions.create({
+      model: 'gpt-4o-mini',
+      messages: [{ role: 'user', content: 'inspect the same failing tool result and try to continue' }],
+      max_tokens: 64,
+    });
+  } catch (error) {
+    if (error instanceof GuardError) {
+      blocked = true;
+      console.log(JSON.stringify({ blocked, step, code: error.code }, null, 2));
+      break;
+    }
+
+    throw error;
+  }
+}
+
+if (!blocked) {
+  throw new Error('Expected loop protection to block the repeated agent prompt.');
+}

package/examples/integrations/vercel-ai-chatbot.mjs

@@ -1,29 +1,29 @@
-import { guardFunction, GuardError } from '@salimassili/ai-costguard';
-
-async function mockGenerateText(request) {
-  return {
-    text: `mocked answer for ${request.prompt}`,
-    usage: { prompt_tokens: 40, completion_tokens: request.max_tokens ?? 80 },
-  };
-}
-
-const generateText = guardFunction(mockGenerateText, {
-  budget: 0.001,
-  scope: { projectId: 'vercel-chatbot-demo', sessionId: 'chat-123' },
-});
-
-try {
-  const result = await generateText({
-    model: 'gpt-4o-mini',
-    prompt: 'Answer the user in one paragraph.',
-    max_tokens: 80,
-  });
-
-  console.log(JSON.stringify({ ok: true, text: result.text }, null, 2));
-} catch (error) {
-  if (error instanceof GuardError) {
-    console.log(JSON.stringify({ ok: false, code: error.code }, null, 2));
-  } else {
-    throw error;
-  }
-}
+import { guardFunction, GuardError } from '@salimassili/ai-costguard';
+
+async function mockGenerateText(request) {
+  return {
+    text: `mocked answer for ${request.prompt}`,
+    usage: { prompt_tokens: 40, completion_tokens: request.max_tokens ?? 80 },
+  };
+}
+
+const generateText = guardFunction(mockGenerateText, {
+  budget: 0.001,
+  scope: { projectId: 'vercel-chatbot-demo', sessionId: 'chat-123' },
+});
+
+try {
+  const result = await generateText({
+    model: 'gpt-4o-mini',
+    prompt: 'Answer the user in one paragraph.',
+    max_tokens: 80,
+  });
+
+  console.log(JSON.stringify({ ok: true, text: result.text }, null, 2));
+} catch (error) {
+  if (error instanceof GuardError) {
+    console.log(JSON.stringify({ ok: false, code: error.code }, null, 2));
+  } else {
+    throw error;
+  }
+}

package/package.json

@@ -1,74 +1,76 @@
-{
-  "name": "@salimassili/ai-costguard",
-  "version": "2.0.0",
-  "description": "Local-first runtime safety layer for AI agents that blocks runaway costs, loops, retries, and budget overruns before API calls execute.",
-  "type": "module",
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "sideEffects": false,
-  "bin": {
-    "aifw": "./dist/cli.js",
-    "ai-costguard": "./dist/cli.js"
-  },
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
-    },
-    "./pro": {
-      "types": "./dist/pro.d.ts",
-      "import": "./dist/pro.js",
-      "default": "./dist/pro.js"
-    },
-    "./pricing": {
-      "types": "./dist/pricing/index.d.ts",
-      "import": "./dist/pricing/index.js",
-      "default": "./dist/pricing/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "docs/DASHBOARD.md",
+{
+  "name": "@salimassili/ai-costguard",
+  "version": "2.0.1",
+  "description": "Local-first runtime safety layer for AI agents that blocks runaway costs, loops, retries, and budget overruns before API calls execute.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "bin": {
+    "aifw": "dist/cli.js",
+    "ai-costguard": "dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./pro": {
+      "types": "./dist/pro.d.ts",
+      "import": "./dist/pro.js",
+      "default": "./dist/pro.js"
+    },
+    "./pricing": {
+      "types": "./dist/pricing/index.d.ts",
+      "import": "./dist/pricing/index.js",
+      "default": "./dist/pricing/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "docs/DASHBOARD.md",
     "docs/INTEGRATIONS.md",
     "docs/BENCHMARKS.md",
     "examples/integrations",
     "benchmarks/run.mjs",
-    "README.md",
-    "CHANGELOG.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "clean": "rimraf dist",
-    "build": "npm run clean && tsc",
-    "typecheck": "tsc --noEmit",
-    "test": "npm run build && node --test --experimental-test-coverage --test-coverage-include=dist/**/*.js --test-coverage-lines=80 --test-coverage-functions=80 --test-coverage-branches=70 \"test/**/*.test.mjs\"",
-    "smoke": "node test/smoke-examples.mjs",
+    "benchmarks/token-accuracy.mjs",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "npm run clean && tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "npm run build && node --test --experimental-test-coverage --test-coverage-include=dist/**/*.js --test-coverage-lines=80 --test-coverage-functions=80 --test-coverage-branches=70 \"test/**/*.test.mjs\"",
+    "smoke": "node test/smoke-examples.mjs",
     "benchmark": "node benchmarks/run.mjs",
-    "preflight": "node scripts/preflight.js",
-    "prepublishOnly": "npm run preflight"
-  },
-  "keywords": [
-    "ai",
-    "openai",
-    "llm",
-    "cost-control",
-    "agent",
-    "runtime-safety",
-    "ai-agents",
-    "budget-guard"
-  ],
-  "author": "Salim Assili",
-  "license": "MIT",
-  "engines": {
-    "node": ">=18"
-  },
-  "devDependencies": {
-    "rimraf": "^5.0.10",
-    "typescript": "^5.3.3"
-  },
-  "optionalDependencies": {
-    "ioredis": "^5.10.1"
-  }
-}
+    "benchmark:tokens": "node benchmarks/token-accuracy.mjs",
+    "preflight": "node scripts/preflight.js",
+    "prepublishOnly": "npm run preflight"
+  },
+  "keywords": [
+    "ai",
+    "openai",
+    "llm",
+    "cost-control",
+    "agent",
+    "runtime-safety",
+    "ai-agents",
+    "budget-guard"
+  ],
+  "author": "Salim Assili",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "rimraf": "^5.0.10",
+    "typescript": "^5.3.3"
+  },
+  "optionalDependencies": {
+    "ioredis": "^5.10.1"
+  }
+}