@timefly/opencode-plugin 0.2.8 → 0.2.10

package/README.md

@@ -104,26 +104,24 @@ OpenCode plugins run inside the OpenCode process. There is no built-in TimeFly U
 
 ## How sync works
 
-Unlike the VS Code extension (which syncs on a timer every ~2 minutes), the OpenCode plugin syncs **on every event** — there is no background interval.
+The SDK batches OpenCode events before sending them to TimeFly. This keeps VPS load predictable as usage grows.
 
-### Timing — when does data leave your machine?
+| Setting | Default | Behavior |
+|---------|---------|----------|
+| Debounce | 5s | Flush pending events 5 seconds after the last event in a burst |
+| Max batch | 50 events | Flush immediately when the in-memory buffer is full |
+| Immediate flush | `session_end` | Session totals are sent right away |
 
-| Trigger | What happens |
-|---------|----------------|
-| LLM request (`chat.params`) | Immediate sync attempt |
-| Assistant turn completes | Immediate sync attempt |
-| Tool call / result | Immediate sync attempt |
-| Session start / end | Immediate sync attempt |
-| Next event after failure | Retries queued events first, then sends new ones |
+Typical flow during a coding session:
 
-**Typical flow during a coding session:**
+1. You send a prompt → `llm_request` is queued
+2. Model responds → `turn_complete`, tool events, etc. join the same batch
+3. After ~5s idle (or 50 events), one gzip `POST /ai/sync` sends the batch
+4. `session_end` flushes immediately so session totals are not delayed
 
-1. You send a prompt → `llm_request` syncs (~instant)
-2. Model responds → `turn_complete` + `llm_response` sync (~instant when turn finishes)
-3. Agent runs tools → each `tool_call` / `tool_result` syncs
-4. Session goes idle → `session_end` with session totals syncs
+Compared with the old per-event sync model, one active agent turn usually produces **1–2 HTTP requests** instead of **10–15+**.
 
-So sync frequency = **how active OpenCode is**, not a fixed cron. A busy session with 10 tool calls and 3 LLM turns can produce 20+ HTTP requests in a few minutes.
+Unlike the VS Code extension (timer every ~2 minutes), OpenCode still syncs in near real time — just batched within each active burst.
 
 ### What each sync request does
 

package/dist/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":";AAuJA,eAAO,MAAM,UAAU,GAAI,eAAe,MAAM,EAAE,KAAG,OAAO,CAAC,IAAI,CAGhE,CAAA"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":";AA6JA,eAAO,MAAM,UAAU,GAAI,eAAe,MAAM,EAAE,KAAG,OAAO,CAAC,IAAI,CAGhE,CAAA"}

package/dist/install.js

@@ -2,7 +2,7 @@
 import { mkdir, readFile, rm, writeFile } from 'node:fs/promises';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { resolveDefaultAuthFilePath } from '@timefly/ai-sdk';
+import { resolveDefaultAuthFilePath, parseJsonText } from '@timefly/ai-sdk';
 const PLUGIN_PACKAGE_LATEST = '@timefly/opencode-plugin@latest';
 const TIMEFLY_PLUGIN_PATTERN = /^@timefly\/opencode-plugin(?:@|$)/;
 const PRICING_URL = 'https://timefly.dev/pricing';
@@ -54,11 +54,14 @@ const clearOpenCodePluginCache = () => {
         .catch(() => undefined);
 };
 const readConfigFile = (configPath) => readFile(configPath, 'utf8')
-    .then((configContent) => JSON.parse(configContent))
+    .then((configContent) => parseJsonText(configContent, {}))
     .catch((error) => {
     if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
         return {};
     }
+    if (error instanceof SyntaxError) {
+        throw new Error(`Invalid OpenCode config at ${configPath}. If you edited it with PowerShell, remove the UTF-8 BOM or delete the file and run setup-opencode again.`);
+    }
     throw error;
 });
 const resolvePluginEntry = (options) => options.useLocalPath ? localPluginPath.replaceAll('\\', '/') : PLUGIN_PACKAGE_LATEST;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@timefly/opencode-plugin",
-	"version": "0.2.8",
+	"version": "0.2.10",
 	"description": "TimeFly telemetry plugin for OpenCode — sessions, tokens, models, and tools",
 	"type": "module",
 	"bin": "./dist/cli.js",
@@ -50,14 +50,14 @@
 	},
 	"license": "MIT",
 	"dependencies": {
-		"@timefly/ai-sdk": "^0.2.1"
+		"@timefly/ai-sdk": "^0.2.3"
 	},
 	"peerDependencies": {
 		"@opencode-ai/plugin": ">=1.0.0"
 	},
 	"devDependencies": {
 		"@opencode-ai/plugin": "^1.17.7",
-		"@timefly/ai-sdk": "0.2.1",
+		"@timefly/ai-sdk": "workspace:*",
 		"@types/bun": "^1.3.14",
 		"@types/node": "^22.15.21",
 		"typescript": "^5.9.3"