anyclaude-sdk 0.7.2 → 0.7.3

package/dist/query.js

@@ -3,7 +3,7 @@
 // Returns an AsyncGenerator<SDKMessage>. Accepts either a single string prompt
 // or an async iterable of SDKUserMessage (for multi-turn / interactive use).
 import { runAgent } from './agent.js';
-import { track, telemetryEnabled } from './telemetry.js';
+import { track, telemetryEnabled, tokenBucket } from './telemetry.js';
 import { profileForModel } from './llm/profiles.js';
 export function query(options) {
     const prompt = typeof options.prompt === 'string'
@@ -59,17 +59,18 @@ export function query(options) {
         settings: options.settings,
         skills: options.skills,
     });
-    gen.interrupt = () => abortController.abort();
-    // Anonymous, aggregate adoption signal — one event per public run. Fire-and-forget,
-    // never blocks the generator, no-ops unless enabled + a collector is configured.
-    // Only booleans + a coarse model-family bucket leave the process (see telemetry.ts).
+    // Anonymous, aggregate adoption signal. Fire-and-forget, never blocks, no-ops
+    // unless enabled + a collector is configured. Only booleans + coarse buckets
+    // (model family, token-volume bucket) ever leave the process — see telemetry.ts.
     const telemetry = {
         disabled: options.disableTelemetry,
         ...options.telemetry,
     };
-    if (telemetryEnabled(telemetry)) {
+    const modelFamily = profileForModel(options.model).name;
+    const enabled = telemetryEnabled(telemetry);
+    if (enabled) {
         track('run', {
-            model_family: profileForModel(options.model).name,
+            model_family: modelFamily,
             client_workspace_tools: !!options.clientWorkspaceTools,
             client_tools: !!options.clientTools?.length,
             survivor: options.maxDurationMs != null,
@@ -83,7 +84,29 @@ export function query(options) {
             resumed: !!options.continueRun || !!options.resume,
         }, telemetry);
     }
-    return gen;
+    if (!enabled) {
+        gen.interrupt = () => abortController.abort();
+        return gen;
+    }
+    // Wrap to emit one `run_end` with a coarse token-volume bucket when the run
+    // finishes (tokens aren't known until the `result` message). Pass-through only.
+    const wrapped = (async function* () {
+        let totalTokens = 0;
+        try {
+            for await (const m of gen) {
+                if (m.type === 'result' && m.usage) {
+                    const u = m.usage;
+                    totalTokens = (u.input_tokens || 0) + (u.output_tokens || 0);
+                }
+                yield m;
+            }
+        }
+        finally {
+            track('run_end', { model_family: modelFamily, tokens_bucket: tokenBucket(totalTokens) }, telemetry);
+        }
+    })();
+    wrapped.interrupt = () => abortController.abort();
+    return wrapped;
 }
 /** Wrap a single text prompt into the async-iterable form runAgent expects. */
 export async function* singlePrompt(text) {

package/dist/telemetry.d.ts

@@ -6,6 +6,8 @@ export interface TelemetryOptions {
     /** Collector URL. Defaults to `ANYCLAUDE_TELEMETRY_URL` then the built-in default. */
     url?: string;
 }
+/** Coarse token-volume bucket — never an exact count, so a single run isn't fingerprintable. */
+export declare function tokenBucket(total: number): string;
 /** Resolve whether telemetry may run, honoring every documented opt-out. */
 export declare function telemetryEnabled(opts?: TelemetryOptions): boolean;
 /** Coarse runtime bucket — never anything machine-identifying. */

package/dist/telemetry.js

@@ -24,7 +24,21 @@ const DEFAULT_TELEMETRY_URL = 'https://anyclaude-telemetry.puter.work';
 // Only these prop keys are ever transmitted, and only with safe value types.
 // Booleans pass through; these specific string keys pass through as-is (they are
 // coarse buckets we set ourselves — never free-form / user data).
-const ALLOWED_STRING_KEYS = new Set(['model_family', 'event_detail']);
+const ALLOWED_STRING_KEYS = new Set(['model_family', 'event_detail', 'tokens_bucket']);
+/** Coarse token-volume bucket — never an exact count, so a single run isn't fingerprintable. */
+export function tokenBucket(total) {
+    if (!Number.isFinite(total) || total <= 0)
+        return '0';
+    if (total < 1_000)
+        return '<1k';
+    if (total < 10_000)
+        return '1k-10k';
+    if (total < 100_000)
+        return '10k-100k';
+    if (total < 1_000_000)
+        return '100k-1m';
+    return '1m+';
+}
 function readEnv(name) {
     const p = globalThis.process;
     return p?.env?.[name];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "anyclaude-sdk",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "description": "Standalone, browser-compatible SDK providing Claude Code agent capabilities (tools, tool loop, multi-turn, MCP, sub-agents, sessions) against any OpenAI/Anthropic-compatible LLM endpoint. Runs in the browser (WebContainer), Node, and Bun — no backend required.",
   "type": "module",
   "main": "./dist/index.js",