@qduc/term2 0.1.4 → 0.1.5

package/dist/utils/token-usage.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Token usage normalization and extraction utilities.
+ * Ported from backend/src/lib/utils/usage.js
+ */
+export interface NormalizedUsage {
+    prompt_tokens?: number;
+    completion_tokens?: number;
+    total_tokens?: number;
+    reasoning_tokens?: number;
+    prompt_ms?: number;
+    completion_ms?: number;
+}
+export declare function normalizeUsage(usage: any): NormalizedUsage | undefined;
+export declare function extractUsage(payload: any): NormalizedUsage | undefined;
+export declare function formatFooterUsage(usage: NormalizedUsage | null | undefined): string;
+//# sourceMappingURL=token-usage.d.ts.map

package/dist/utils/token-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-usage.d.ts","sourceRoot":"","sources":["../../source/utils/token-usage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AA6BD,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG,GAAG,eAAe,GAAG,SAAS,CAiFtE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,GAAG,GAAG,eAAe,GAAG,SAAS,CAgCtE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAgBnF"}

package/dist/utils/token-usage.js

@@ -0,0 +1,110 @@
+/**
+ * Token usage normalization and extraction utilities.
+ * Ported from backend/src/lib/utils/usage.js
+ */
+function toNumber(value) {
+    if (value == null)
+        return undefined;
+    const asNumber = Number(value);
+    if (!Number.isFinite(asNumber))
+        return undefined;
+    return asNumber;
+}
+function coalesceNumber(...values) {
+    for (const value of values) {
+        const num = toNumber(value);
+        if (num != null)
+            return num;
+    }
+    return undefined;
+}
+function sumNumbers(...values) {
+    let total = 0;
+    let found = false;
+    for (const value of values) {
+        const num = toNumber(value);
+        if (num == null)
+            continue;
+        total += num;
+        found = true;
+    }
+    return found ? total : undefined;
+}
+export function normalizeUsage(usage) {
+    if (!usage || typeof usage !== 'object')
+        return undefined;
+    const promptTokens = coalesceNumber(usage.prompt_tokens, usage.input_tokens, usage.input_token_count, usage.prompt_token_count, usage.promptTokenCount, usage.inputTokenCount, usage.inputTokens, // Agents SDK
+    usage.prompt_n !== undefined && usage.prompt_n != null
+        ? (toNumber(usage.cache_n) || 0) + toNumber(usage.prompt_n)
+        : undefined);
+    const completionTokens = coalesceNumber(usage.completion_tokens, usage.output_tokens, usage.output_token_count, usage.completion_token_count, usage.candidatesTokenCount, usage.outputTokenCount, usage.outputTokens, // Agents SDK
+    usage.predicted_n);
+    const cacheCreationTokens = coalesceNumber(usage.cache_creation_input_tokens, usage.cacheCreationInputTokens);
+    const cacheReadTokens = coalesceNumber(usage.cache_read_input_tokens, usage.cacheReadInputTokens);
+    const totalTokens = coalesceNumber(usage.total_tokens, usage.total_token_count, usage.totalTokenCount, usage.totalTokens) ??
+        sumNumbers(promptTokens, completionTokens, cacheCreationTokens, cacheReadTokens);
+    const reasoningTokens = coalesceNumber(usage.reasoning_tokens, usage.reasoning_token_count, usage?.completion_tokens_details?.reasoning_tokens, usage?.output_tokens_details?.reasoning_tokens, usage.thoughtsTokenCount, usage.thoughts_token_count);
+    const promptMs = coalesceNumber(usage.prompt_ms, usage.promptMs);
+    const completionMs = coalesceNumber(usage.completion_ms, usage.completionMs, usage.predicted_ms, usage.predictedMs, usage.output_ms, usage.outputMs);
+    const mapped = {};
+    if (promptTokens != null)
+        mapped.prompt_tokens = promptTokens;
+    if (completionTokens != null)
+        mapped.completion_tokens = completionTokens;
+    if (totalTokens != null)
+        mapped.total_tokens = totalTokens;
+    if (reasoningTokens != null)
+        mapped.reasoning_tokens = reasoningTokens;
+    if (promptMs != null)
+        mapped.prompt_ms = promptMs;
+    if (completionMs != null)
+        mapped.completion_ms = completionMs;
+    return Object.keys(mapped).length > 0 ? mapped : undefined;
+}
+export function extractUsage(payload) {
+    if (!payload || typeof payload !== 'object')
+        return undefined;
+    const results = [];
+    const direct = normalizeUsage(payload.usage);
+    if (direct)
+        results.push(direct);
+    const metadata = normalizeUsage(payload.usageMetadata || payload.usage_metadata);
+    if (metadata)
+        results.push(metadata);
+    const nested = normalizeUsage(payload.response?.usage);
+    if (nested)
+        results.push(nested);
+    const timings = normalizeUsage(payload.timings);
+    if (timings)
+        results.push(timings);
+    // Fallback search for any usage field in the payload itself
+    const self = normalizeUsage(payload);
+    if (self)
+        results.push(self);
+    if (results.length === 0)
+        return undefined;
+    const merged = {};
+    for (let i = results.length - 1; i >= 0; i--) {
+        Object.assign(merged, results[i]);
+    }
+    // Re-normalize to fix up computed total_tokens if components were merged from different sources
+    return normalizeUsage(merged);
+}
+export function formatFooterUsage(usage) {
+    if (!usage)
+        return '';
+    const parts = [];
+    if (usage.prompt_tokens != null) {
+        parts.push(`${usage.prompt_tokens.toLocaleString()} in`);
+    }
+    if (usage.completion_tokens != null) {
+        parts.push(`${usage.completion_tokens.toLocaleString()} out`);
+    }
+    if (usage.total_tokens != null) {
+        parts.push(`${usage.total_tokens.toLocaleString()} total`);
+    }
+    if (parts.length === 0)
+        return '';
+    return `Tok: ${parts.join(' / ')}`;
+}
+//# sourceMappingURL=token-usage.js.map

package/dist/utils/token-usage.js.map

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

package/dist/utils/token-usage.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=token-usage.test.d.ts.map

package/dist/utils/token-usage.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-usage.test.d.ts","sourceRoot":"","sources":["../../source/utils/token-usage.test.ts"],"names":[],"mappings":""}

package/dist/utils/token-usage.test.js

@@ -0,0 +1,38 @@
+import test from 'ava';
+import { normalizeUsage, extractUsage, formatFooterUsage } from './token-usage.js';
+test('normalizeUsage handles multiple formats', t => {
+    // OpenAI style
+    t.deepEqual(normalizeUsage({ prompt_tokens: 10, completion_tokens: 20, total_tokens: 30 }), {
+        prompt_tokens: 10,
+        completion_tokens: 20,
+        total_tokens: 30
+    });
+    // Agents SDK style
+    t.deepEqual(normalizeUsage({ inputTokens: 5, outputTokens: 15, totalTokens: 20 }), {
+        prompt_tokens: 5,
+        completion_tokens: 15,
+        total_tokens: 20
+    });
+    // Mixed/partial
+    t.deepEqual(normalizeUsage({ input_tokens: 100 }), {
+        prompt_tokens: 100,
+        total_tokens: 100
+    });
+});
+test('extractUsage finds usage in nested locations', t => {
+    const payload = {
+        usage: { prompt_tokens: 1, total_tokens: 3 },
+        response: { usage: { completion_tokens: 2, total_tokens: 3 } }
+    };
+    t.deepEqual(extractUsage(payload), {
+        prompt_tokens: 1,
+        completion_tokens: 2,
+        total_tokens: 3
+    });
+});
+test('formatFooterUsage returns formatted string', t => {
+    t.is(formatFooterUsage({ prompt_tokens: 1200, completion_tokens: 350, total_tokens: 1550 }), 'Tok: 1,200 in / 350 out / 1,550 total');
+    t.is(formatFooterUsage({ total_tokens: 100 }), 'Tok: 100 total');
+    t.is(formatFooterUsage(null), '');
+});
+//# sourceMappingURL=token-usage.test.js.map

package/dist/utils/token-usage.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-usage.test.js","sourceRoot":"","sources":["../../source/utils/token-usage.test.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,KAAK,CAAC;AACvB,OAAO,EAAC,cAAc,EAAE,YAAY,EAAE,iBAAiB,EAAC,MAAM,kBAAkB,CAAC;AAEjF,IAAI,CAAC,yCAAyC,EAAE,CAAC,CAAC,EAAE;IAChD,eAAe;IACf,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,EAAC,aAAa,EAAE,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAC,CAAC,EAAE;QACtF,aAAa,EAAE,EAAE;QACjB,iBAAiB,EAAE,EAAE;QACrB,YAAY,EAAE,EAAE;KACnB,CAAC,CAAC;IAEH,mBAAmB;IACnB,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,EAAC,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAC,CAAC,EAAE;QAC7E,aAAa,EAAE,CAAC;QAChB,iBAAiB,EAAE,EAAE;QACrB,YAAY,EAAE,EAAE;KACnB,CAAC,CAAC;IAEH,gBAAgB;IAChB,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,EAAC,YAAY,EAAE,GAAG,EAAC,CAAC,EAAE;QAC7C,aAAa,EAAE,GAAG;QAClB,YAAY,EAAE,GAAG;KACpB,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,8CAA8C,EAAE,CAAC,CAAC,EAAE;IACrD,MAAM,OAAO,GAAG;QACZ,KAAK,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE;QAC5C,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,iBAAiB,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,EAAE;KACjE,CAAC;IACF,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE;QAC/B,aAAa,EAAE,CAAC;QAChB,iBAAiB,EAAE,CAAC;QACpB,YAAY,EAAE,CAAC;KAClB,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,4CAA4C,EAAE,CAAC,CAAC,EAAE;IACnD,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC,EAAC,aAAa,EAAE,IAAI,EAAE,iBAAiB,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,EAAC,CAAC,EAAE,uCAAuC,CAAC,CAAC;IACpI,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC,EAAC,YAAY,EAAE,GAAG,EAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;IAC/D,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC,CAAC,CAAC"}

package/dist/utils/trim-tool-output.d.ts

@@ -0,0 +1,2 @@
+export declare const trimToolOutput: (output: unknown, maxLines?: number, maxCharacters?: number) => string;
+//# sourceMappingURL=trim-tool-output.d.ts.map

package/dist/utils/trim-tool-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trim-tool-output.d.ts","sourceRoot":"","sources":["../../source/utils/trim-tool-output.ts"],"names":[],"mappings":"AAmDA,eAAO,MAAM,cAAc,GACvB,QAAQ,OAAO,EACf,WAAW,MAAM,EACjB,gBAAgB,MAAM,KACvB,MAgBF,CAAC"}

package/dist/utils/trim-tool-output.js

@@ -0,0 +1,52 @@
+import { trimOutput } from './output-trim.js';
+const tryParseJson = (value) => {
+    if (!value.trim()) {
+        return null;
+    }
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return null;
+    }
+};
+const trimStringValue = (value, maxLines, maxCharacters) => {
+    if (!value) {
+        return value;
+    }
+    return trimOutput(value, maxLines, maxCharacters);
+};
+const trimJsonStrings = (value, maxLines, maxCharacters) => {
+    if (typeof value === 'string') {
+        return trimStringValue(value, maxLines, maxCharacters);
+    }
+    if (Array.isArray(value)) {
+        return value.map(entry => trimJsonStrings(entry, maxLines, maxCharacters));
+    }
+    if (value && typeof value === 'object') {
+        const record = value;
+        const next = {};
+        for (const [key, entry] of Object.entries(record)) {
+            next[key] = trimJsonStrings(entry, maxLines, maxCharacters);
+        }
+        return next;
+    }
+    return value;
+};
+export const trimToolOutput = (output, maxLines, maxCharacters) => {
+    if (typeof output !== 'string') {
+        return String(output ?? '');
+    }
+    const parsed = tryParseJson(output);
+    if (parsed !== null) {
+        const trimmed = trimJsonStrings(parsed, maxLines, maxCharacters);
+        try {
+            return JSON.stringify(trimmed);
+        }
+        catch {
+            return trimStringValue(output, maxLines, maxCharacters);
+        }
+    }
+    return trimStringValue(output, maxLines, maxCharacters);
+};
+//# sourceMappingURL=trim-tool-output.js.map

package/dist/utils/trim-tool-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trim-tool-output.js","sourceRoot":"","sources":["../../source/utils/trim-tool-output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAE5C,MAAM,YAAY,GAAG,CAAC,KAAa,EAAkB,EAAE;IACnD,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,IAAI,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CACpB,KAAa,EACb,QAAiB,EACjB,aAAsB,EAChB,EAAE;IACR,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,OAAO,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;AACtD,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CACpB,KAAc,EACd,QAAiB,EACjB,aAAsB,EACf,EAAE;IACT,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CACrB,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,CAClD,CAAC;IACN,CAAC;IAED,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,KAAgC,CAAC;QAChD,MAAM,IAAI,GAA4B,EAAE,CAAC;QACzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAChD,IAAI,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAC1B,MAAe,EACf,QAAiB,EACjB,aAAsB,EAChB,EAAE;IACR,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClB,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QACjE,IAAI,CAAC;YACD,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QAC5D,CAAC;IACL,CAAC;IAED,OAAO,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;AAC5D,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@qduc/term2",
-    "version": "0.1.4",
+    "version": "0.1.5",
     "description": "A terminal-based AI assistant that can help you get things done on your computer",
     "license": "MIT",
     "author": "qduc",
@@ -48,6 +48,7 @@
     "dependencies": {
         "@mozilla/readability": "^0.6.0",
         "@openai/agents": "^0.4.3",
+        "@qduc/web-fetch": "^0.1.0",
         "@types/ssh2": "^1.15.5",
         "bash-parser": "^0.5.0",
         "env-paths": "^3.0.0",

package/{README.md → readme.md}

@@ -5,13 +5,16 @@
 
 A powerful terminal-based AI assistant that helps you get things done on your computer through natural conversation.
 
+**Why term2?** Unlike proprietary alternatives, term2 is **open-source (MIT)**, works with **any AI provider** (OpenAI, OpenRouter, local self-hosted, etc.), requires **no subscription**, and uniquely supports **remote server management via SSH** — all while giving you full control over what commands execute on your system.
+
 ## Demo
 
 https://github.com/user-attachments/assets/ac960d65-f7c8-453a-9440-91f6397ae842
 
 ## Features
 
--   🎭 **Three Operating Modes** - Default (full-power), Lite (fast & safe), and Mentor (collaborative problem-solving)
+-   🎭 **Three Operating Modes** - Default (full-power), Lite (fast & safe), and Mentor (get help from a smarter model on complex problems)
+-   🌍 **Open Source** - MIT licensed, hackable, auditable, community-driven
 -   🤖 **Multi-Provider Support** - Works with OpenAI, OpenRouter, and OpenAI-compatible APIs
 -   🔒 **Safe Execution** - Every command requires your explicit approval with diff preview
 -   🛠️ **Advanced Tools** - Shell execution, file patching, search/replace, grep, find files, file reading, web search, and mentor consultation
@@ -24,6 +27,24 @@ https://github.com/user-attachments/assets/ac960d65-f7c8-453a-9440-91f6397ae842
 -   🔄 **Retry Logic** - Automatic recovery from tool hallucinations and upstream errors
 -   🌐 **SSH Mode** - Execute commands and edit files on remote servers over SSH
 
+## Why term2 vs Alternatives?
+
+| | **term2** | Claude Code | Warp |
+|---|:---:|:---:|:---:|
+| **Open Source** | ✅ MIT | ❌ Proprietary | ❌ Proprietary |
+| **Cost** | Pay-per-use | $20-200/mo | Freemium |
+| **AI Providers** | Any (OpenAI, OpenRouter, local, etc.) | Anthropic only | selected models only |
+| **SSH Remote** | ✅ Native | ❌ No | ✅ Yes |
+| **Mentor Mode** | ✅ Built-in | ❌ No | ❌ No |
+| **Self-Hostable** | ✅ | ❌ | ❌ |
+
+**term2 gives you:**
+- **Freedom** — No vendor lock-in. Use any AI provider or model you prefer.
+- **Transparency** — Open source means you can audit every line of code.
+- **Cost Control** — Pay only for API usage, no monthly subscriptions.
+- **Remote Work** — Troubleshoot and manage remote servers without installing anything on remote hosts.
+- **Safety** — Every command requires explicit approval with diff previews before execution.
+
 ## Installation
 
 **Requirements:**