@claudebuddy/claudebuddy-agent-sdk 0.4.0

package/dist/utils/tokens.js

@@ -0,0 +1,140 @@
+/**
+ * Token Estimation & Counting
+ *
+ * Provides rough token estimation (character-based) and
+ * API-based exact counting when available.
+ */
+/**
+ * Rough token estimation: ~4 chars per token (conservative).
+ */
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+/**
+ * Estimate tokens for a message array.
+ */
+export function estimateMessagesTokens(messages) {
+    let total = 0;
+    for (const msg of messages) {
+        if (typeof msg.content === 'string') {
+            total += estimateTokens(msg.content);
+        }
+        else if (Array.isArray(msg.content)) {
+            for (const block of msg.content) {
+                if ('text' in block && typeof block.text === 'string') {
+                    total += estimateTokens(block.text);
+                }
+                else if ('content' in block && typeof block.content === 'string') {
+                    total += estimateTokens(block.content);
+                }
+                else {
+                    // tool_use, image, etc - rough estimate
+                    total += estimateTokens(JSON.stringify(block));
+                }
+            }
+        }
+    }
+    return total;
+}
+/**
+ * Estimate tokens for a system prompt.
+ */
+export function estimateSystemPromptTokens(systemPrompt) {
+    return estimateTokens(systemPrompt);
+}
+/**
+ * Count tokens from API usage response.
+ */
+export function getTokenCountFromUsage(usage) {
+    return (usage.input_tokens +
+        usage.output_tokens +
+        (usage.cache_creation_input_tokens || 0) +
+        (usage.cache_read_input_tokens || 0));
+}
+/**
+ * Get the context window size for a model.
+ */
+export function getContextWindowSize(model, contextWindowSize) {
+    if (contextWindowSize !== undefined)
+        return contextWindowSize;
+    // Anthropic model context windows
+    if (model.includes('opus-4') && model.includes('1m'))
+        return 1_000_000;
+    if (model.includes('opus-4'))
+        return 200_000;
+    if (model.includes('sonnet-4'))
+        return 200_000;
+    if (model.includes('haiku-4'))
+        return 200_000;
+    if (model.includes('claude-3'))
+        return 200_000;
+    // OpenAI model context windows
+    if (model.includes('gpt-4o'))
+        return 128_000;
+    if (model.includes('gpt-4-turbo'))
+        return 128_000;
+    if (model.includes('gpt-4-1'))
+        return 1_000_000;
+    if (model.includes('gpt-4'))
+        return 128_000;
+    if (model.includes('gpt-3.5'))
+        return 16_385;
+    if (model.includes('o1'))
+        return 200_000;
+    if (model.includes('o3'))
+        return 200_000;
+    if (model.includes('o4'))
+        return 200_000;
+    // DeepSeek models
+    if (model.includes('deepseek'))
+        return 128_000;
+    // Default
+    return 200_000;
+}
+/**
+ * Auto-compact buffer: trigger compaction when within this many tokens of the limit.
+ */
+export const AUTOCOMPACT_BUFFER_TOKENS = 13_000;
+/**
+ * Get the auto-compact threshold for a model.
+ */
+export function getAutoCompactThreshold(model, contextWindowSize) {
+    return getContextWindowSize(model, contextWindowSize) - AUTOCOMPACT_BUFFER_TOKENS;
+}
+/**
+ * Model pricing (USD per token).
+ */
+export const MODEL_PRICING = {
+    // Anthropic models
+    'claude-opus-4-6': { input: 15 / 1_000_000, output: 75 / 1_000_000 },
+    'claude-opus-4-5': { input: 15 / 1_000_000, output: 75 / 1_000_000 },
+    'claude-sonnet-4-6': { input: 3 / 1_000_000, output: 15 / 1_000_000 },
+    'claude-sonnet-4-5': { input: 3 / 1_000_000, output: 15 / 1_000_000 },
+    'claude-haiku-4-5': { input: 0.8 / 1_000_000, output: 4 / 1_000_000 },
+    'claude-3-5-sonnet': { input: 3 / 1_000_000, output: 15 / 1_000_000 },
+    'claude-3-5-haiku': { input: 0.8 / 1_000_000, output: 4 / 1_000_000 },
+    'claude-3-opus': { input: 15 / 1_000_000, output: 75 / 1_000_000 },
+    // OpenAI models
+    'gpt-4o': { input: 2.5 / 1_000_000, output: 10 / 1_000_000 },
+    'gpt-4o-mini': { input: 0.15 / 1_000_000, output: 0.6 / 1_000_000 },
+    'gpt-4-turbo': { input: 10 / 1_000_000, output: 30 / 1_000_000 },
+    'gpt-4-1': { input: 2 / 1_000_000, output: 8 / 1_000_000 },
+    'o1': { input: 15 / 1_000_000, output: 60 / 1_000_000 },
+    'o3': { input: 10 / 1_000_000, output: 40 / 1_000_000 },
+    'o4-mini': { input: 1.1 / 1_000_000, output: 4.4 / 1_000_000 },
+    // DeepSeek models
+    'deepseek-chat': { input: 0.27 / 1_000_000, output: 1.1 / 1_000_000 },
+    'deepseek-reasoner': { input: 0.55 / 1_000_000, output: 2.19 / 1_000_000 },
+};
+/**
+ * Estimate cost from usage and model.
+ */
+export function estimateCost(model, usage, pricing) {
+    if (pricing) {
+        return (usage.input_tokens * (pricing.input / 1_000_000) +
+            usage.output_tokens * (pricing.output / 1_000_000));
+    }
+    const resolved = Object.entries(MODEL_PRICING).find(([key]) => model.includes(key))?.[1] ?? { input: 3 / 1_000_000, output: 15 / 1_000_000 };
+    return (usage.input_tokens * resolved.input + usage.output_tokens * resolved.output);
+}
+//# sourceMappingURL=tokens.js.map

package/dist/utils/tokens.js.map

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

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@claudebuddy/claudebuddy-agent-sdk",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "author": {
+    "name": "LuckyGJX",
+    "url": "https://github.com/LuckyGJX"
+  },
+  "homepage": "https://github.com/claudebuddy/claudebuddy-agent-sdk",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/claudebuddy/claudebuddy-agent-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/claudebuddy/claudebuddy-agent-sdk/issues"
+  },
+  "version": "0.4.0",
+  "description": "Open-source Agent SDK. Runs the full agent loop in-process — no local CLI required. Deploy anywhere: cloud, serverless, Docker, CI/CD.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build",
+    "test": "npx tsx examples/01-simple-query.ts",
+    "test:all": "for f in examples/*.ts; do echo \"--- Running $f ---\"; npx tsx $f; echo; done",
+    "web": "npx tsx examples/web/server.ts",
+    "publish:npm": "npm publish --registry=https://registry.npmjs.org/",
+    "publish:github": "npm publish --registry=https://npm.pkg.github.com/"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.52.0",
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.23.0",
+    "zod-to-json-schema": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  },
+  "keywords": [
+    "open-agent-sdk",
+    "agent",
+    "sdk",
+    "ai",
+    "llm",
+    "tools",
+    "agentic",
+    "coding-agent",
+    "mcp"
+  ],
+  "license": "MIT"
+}