@geotechcli/core 0.2.0

package/dist/llm/middleware/persistent-usage.js

@@ -0,0 +1,108 @@
+// ---------------------------------------------------------------------------
+// Persistent CLI Usage Store — file-backed, survives process restarts
+//
+// Stores counters in ~/.geotechcli/usage.json so the unregistered 5-call
+// limit and monthly quotas are enforced across CLI sessions.
+// ---------------------------------------------------------------------------
+import { readFileSync, writeFileSync, existsSync, mkdirSync, chmodSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir, platform } from 'node:os';
+const CONFIG_DIR = process.env.GEOTECHCLI_CONFIG_DIR ?? join(homedir(), '.geotechcli');
+const USAGE_FILE = join(CONFIG_DIR, 'usage.json');
+function ensureDir() {
+    if (!existsSync(CONFIG_DIR)) {
+        mkdirSync(CONFIG_DIR, { recursive: true });
+        if (platform() !== 'win32') {
+            try {
+                chmodSync(CONFIG_DIR, 0o700);
+            }
+            catch { /* best effort */ }
+        }
+    }
+}
+function loadData() {
+    ensureDir();
+    if (!existsSync(USAGE_FILE)) {
+        return { records: {}, version: 1 };
+    }
+    try {
+        const raw = readFileSync(USAGE_FILE, 'utf-8');
+        const data = JSON.parse(raw);
+        return data;
+    }
+    catch {
+        return { records: {}, version: 1 };
+    }
+}
+function saveData(data) {
+    ensureDir();
+    try {
+        writeFileSync(USAGE_FILE, JSON.stringify(data, null, 2), 'utf-8');
+        if (platform() !== 'win32') {
+            try {
+                chmodSync(USAGE_FILE, 0o600);
+            }
+            catch { /* best effort */ }
+        }
+    }
+    catch {
+        // Silently fail — CLI should not crash on usage persistence failure
+    }
+}
+function isExpired(record) {
+    const monthMs = 30 * 24 * 60 * 60 * 1000;
+    return Date.now() - record.periodStart > monthMs;
+}
+// ---------------------------------------------------------------------------
+// FileUsageStore — implements UsageStore interface
+// ---------------------------------------------------------------------------
+export class FileUsageStore {
+    async get(identifier) {
+        const data = loadData();
+        const record = data.records[identifier] ?? null;
+        if (!record)
+            return null;
+        // Reset if period expired
+        if (isExpired(record)) {
+            record.llmCalls = 0;
+            record.visionCalls = 0;
+            record.agentCalls = 0;
+            record.periodStart = Date.now();
+            data.records[identifier] = record;
+            saveData(data);
+        }
+        return record;
+    }
+    async set(identifier, record) {
+        const data = loadData();
+        data.records[identifier] = record;
+        saveData(data);
+    }
+    async increment(identifier, field) {
+        const data = loadData();
+        let record = data.records[identifier];
+        if (!record) {
+            record = {
+                identifier,
+                tier: 'free',
+                llmCalls: 0,
+                visionCalls: 0,
+                agentCalls: 0,
+                periodStart: Date.now(),
+                lastCallTimestamp: Date.now(),
+            };
+        }
+        if (isExpired(record)) {
+            record.llmCalls = 0;
+            record.visionCalls = 0;
+            record.agentCalls = 0;
+            record.periodStart = Date.now();
+        }
+        record[field] += 1;
+        record.lastCallTimestamp = Date.now();
+        data.records[identifier] = record;
+        saveData(data);
+        return record;
+    }
+}
+//# sourceMappingURL=persistent-usage.js.map

package/dist/llm/middleware/persistent-usage.js.map

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

package/dist/llm/middleware/retry.d.ts

@@ -0,0 +1,7 @@
+export interface RetryOptions {
+    maxRetries?: number;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+}
+export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/llm/middleware/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/llm/middleware/retry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAQD,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,CAAC,CAAC,CA8BZ"}

package/dist/llm/middleware/retry.js

@@ -0,0 +1,29 @@
+const DEFAULT_OPTIONS = {
+    maxRetries: 3,
+    baseDelayMs: 1000,
+    maxDelayMs: 10_000,
+};
+export async function withRetry(fn, options) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    let lastError;
+    for (let attempt = 0; attempt <= opts.maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            lastError = err instanceof Error ? err : new Error(String(err));
+            // Don't retry on auth errors or client errors (4xx except 429)
+            if (lastError.message.includes('(401)') || lastError.message.includes('(403)')) {
+                throw lastError;
+            }
+            if (attempt === opts.maxRetries) {
+                break;
+            }
+            // Exponential backoff with jitter
+            const delay = Math.min(opts.baseDelayMs * Math.pow(2, attempt) + Math.random() * 500, opts.maxDelayMs);
+            await new Promise((resolve) => setTimeout(resolve, delay));
+        }
+    }
+    throw lastError ?? new Error('Retry failed with no error captured.');
+}
+//# sourceMappingURL=retry.js.map

package/dist/llm/middleware/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../../src/llm/middleware/retry.ts"],"names":[],"mappings":"AAMA,MAAM,eAAe,GAA2B;IAC9C,UAAU,EAAE,CAAC;IACb,WAAW,EAAE,IAAI;IACjB,UAAU,EAAE,MAAM;CACnB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,EAAoB,EACpB,OAAsB;IAEtB,MAAM,IAAI,GAAG,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,EAAE,CAAC;IAChD,IAAI,SAA4B,CAAC;IAEjC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QAC5D,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,SAAS,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAEhE,+DAA+D;YAC/D,IAAI,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/E,MAAM,SAAS,CAAC;YAClB,CAAC;YAED,IAAI,OAAO,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChC,MAAM;YACR,CAAC;YAED,kCAAkC;YAClC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,EAC7D,IAAI,CAAC,UAAU,CAChB,CAAC;YAEF,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,MAAM,SAAS,IAAI,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;AACvE,CAAC"}

package/dist/llm/providers/anthropic.d.ts

@@ -0,0 +1,10 @@
+import type { ProviderAdapter, CompletionRequest, CompletionResponse, LLMConfig } from '../types.js';
+export declare class AnthropicAdapter implements ProviderAdapter {
+    readonly name: "anthropic";
+    readonly defaultModel = "claude-sonnet-4-20250514";
+    readonly defaultVisionModel = "claude-sonnet-4-20250514";
+    private readonly baseUrl;
+    constructor(baseUrl?: string);
+    complete(request: CompletionRequest, config: LLMConfig): Promise<CompletionResponse>;
+}
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/llm/providers/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../src/llm/providers/anthropic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACV,MAAM,aAAa,CAAC;AAcrB,qBAAa,gBAAiB,YAAW,eAAe;IACtD,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAU;IACrC,QAAQ,CAAC,YAAY,8BAA8B;IACnD,QAAQ,CAAC,kBAAkB,8BAA8B;IAEzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,CAAC,EAAE,MAAM;IAItB,QAAQ,CACZ,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,kBAAkB,CAAC;CAqH/B"}

package/dist/llm/providers/anthropic.js

@@ -0,0 +1,107 @@
+export class AnthropicAdapter {
+    name = 'anthropic';
+    defaultModel = 'claude-sonnet-4-20250514';
+    defaultVisionModel = 'claude-sonnet-4-20250514';
+    baseUrl;
+    constructor(baseUrl) {
+        this.baseUrl = baseUrl ?? 'https://api.anthropic.com/v1';
+    }
+    async complete(request, config) {
+        if (!config.apiKey) {
+            throw new Error('Anthropic API key is required. Set it via config or ANTHROPIC_API_KEY env var.');
+        }
+        const model = request.model ?? config.modelId ?? this.defaultModel;
+        // Anthropic separates system from messages
+        let systemPrompt;
+        const messages = [];
+        for (const msg of request.messages) {
+            if (msg.role === 'system') {
+                systemPrompt =
+                    typeof msg.content === 'string'
+                        ? msg.content
+                        : msg.content
+                            .filter((p) => p.type === 'text')
+                            .map((p) => p.text)
+                            .join('\n');
+                continue;
+            }
+            if (typeof msg.content === 'string') {
+                messages.push({ role: msg.role, content: msg.content });
+            }
+            else {
+                // Convert to Anthropic multimodal format
+                const parts = msg.content.map((part) => {
+                    if (part.type === 'text') {
+                        return { type: 'text', text: part.text ?? '' };
+                    }
+                    // Anthropic expects base64 images differently
+                    const url = part.image_url?.url ?? '';
+                    if (url.startsWith('data:')) {
+                        const match = url.match(/^data:(image\/\w+);base64,(.+)$/);
+                        if (match) {
+                            return {
+                                type: 'image',
+                                source: {
+                                    type: 'base64',
+                                    media_type: match[1],
+                                    data: match[2],
+                                },
+                            };
+                        }
+                    }
+                    return {
+                        type: 'image',
+                        source: { type: 'url', url },
+                    };
+                });
+                messages.push({ role: msg.role, content: parts });
+            }
+        }
+        const body = {
+            model,
+            messages,
+            max_tokens: request.maxTokens ?? 4096,
+        };
+        if (systemPrompt) {
+            body.system = systemPrompt;
+        }
+        if (request.temperature !== undefined) {
+            body.temperature = request.temperature;
+        }
+        const url = `${this.baseUrl}/messages`;
+        const start = Date.now();
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'x-api-key': config.apiKey,
+                'anthropic-version': '2023-06-01',
+            },
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(config.timeout ?? 60_000),
+        });
+        if (!res.ok) {
+            const errText = await res.text().catch(() => 'Unknown error');
+            throw new Error(`Anthropic API error (${res.status}): ${errText}`);
+        }
+        const data = (await res.json());
+        const latencyMs = Date.now() - start;
+        const text = data.content
+            ?.filter((c) => c.type === 'text')
+            .map((c) => c.text)
+            .join('') ?? '';
+        return {
+            text,
+            usage: {
+                promptTokens: data.usage?.input_tokens ?? 0,
+                completionTokens: data.usage?.output_tokens ?? 0,
+                totalTokens: (data.usage?.input_tokens ?? 0) +
+                    (data.usage?.output_tokens ?? 0),
+            },
+            model: data.model ?? model,
+            provider: 'anthropic',
+            latencyMs,
+        };
+    }
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/llm/providers/anthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../../src/llm/providers/anthropic.ts"],"names":[],"mappings":"AAmBA,MAAM,OAAO,gBAAgB;IAClB,IAAI,GAAG,WAAoB,CAAC;IAC5B,YAAY,GAAG,0BAA0B,CAAC;IAC1C,kBAAkB,GAAG,0BAA0B,CAAC;IAExC,OAAO,CAAS;IAEjC,YAAY,OAAgB;QAC1B,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,8BAA8B,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,OAA0B,EAC1B,MAAiB;QAEjB,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CACb,gFAAgF,CACjF,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GACT,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC;QAEvD,2CAA2C;QAC3C,IAAI,YAAgC,CAAC;QACrC,MAAM,QAAQ,GAA8C,EAAE,CAAC;QAE/D,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACnC,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC1B,YAAY;oBACV,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;wBAC7B,CAAC,CAAC,GAAG,CAAC,OAAO;wBACb,CAAC,CAAC,GAAG,CAAC,OAAO;6BACR,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;6BAChC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;6BAClB,IAAI,CAAC,IAAI,CAAC,CAAC;gBACpB,SAAS;YACX,CAAC;YAED,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YAC1D,CAAC;iBAAM,CAAC;gBACN,yCAAyC;gBACzC,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;oBACrC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;wBACzB,OAAO,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;oBAC1D,CAAC;oBACD,8CAA8C;oBAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,IAAI,EAAE,CAAC;oBACtC,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;wBAC5B,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CACrB,iCAAiC,CAClC,CAAC;wBACF,IAAI,KAAK,EAAE,CAAC;4BACV,OAAO;gCACL,IAAI,EAAE,OAAgB;gCACtB,MAAM,EAAE;oCACN,IAAI,EAAE,QAAiB;oCACvB,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;oCACpB,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;iCACf;6BACF,CAAC;wBACJ,CAAC;oBACH,CAAC;oBACD,OAAO;wBACL,IAAI,EAAE,OAAgB;wBACtB,MAAM,EAAE,EAAE,IAAI,EAAE,KAAc,EAAE,GAAG,EAAE;qBACtC,CAAC;gBACJ,CAAC,CAAC,CAAC;gBACH,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;QAED,MAAM,IAAI,GAA4B;YACpC,KAAK;YACL,QAAQ;YACR,UAAU,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;SACtC,CAAC;QAEF,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC;QAC7B,CAAC;QACD,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACtC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACzC,CAAC;QAED,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,WAAW,CAAC;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEzB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,WAAW,EAAE,MAAM,CAAC,MAAM;gBAC1B,mBAAmB,EAAE,YAAY;aAClC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAC1B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC;SACtD,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,CAAC;YAC9D,MAAM,IAAI,KAAK,CACb,wBAAwB,GAAG,CAAC,MAAM,MAAM,OAAO,EAAE,CAClD,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAsB,CAAC;QACrD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QAErC,MAAM,IAAI,GACR,IAAI,CAAC,OAAO;YACV,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;aACjC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAClB,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QAEpB,OAAO;YACL,IAAI;YACJ,KAAK,EAAE;gBACL,YAAY,EAAE,IAAI,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC;gBAC3C,gBAAgB,EAAE,IAAI,CAAC,KAAK,EAAE,aAAa,IAAI,CAAC;gBAChD,WAAW,EACT,CAAC,IAAI,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC,CAAC;oBAC/B,CAAC,IAAI,CAAC,KAAK,EAAE,aAAa,IAAI,CAAC,CAAC;aACnC;YACD,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,KAAK;YAC1B,QAAQ,EAAE,WAAW;YACrB,SAAS;SACV,CAAC;IACJ,CAAC;CACF"}

package/dist/llm/providers/hosted-beta.d.ts

@@ -0,0 +1,10 @@
+import type { ProviderAdapter, CompletionRequest, CompletionResponse, LLMConfig } from '../types.js';
+export declare class HostedBetaAdapter implements ProviderAdapter {
+    readonly name: "hosted-beta";
+    readonly defaultModel: string;
+    readonly defaultVisionModel: string;
+    private readonly baseUrl;
+    constructor(baseUrl?: string);
+    complete(request: CompletionRequest, config: LLMConfig): Promise<CompletionResponse>;
+}
+//# sourceMappingURL=hosted-beta.d.ts.map

package/dist/llm/providers/hosted-beta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-beta.d.ts","sourceRoot":"","sources":["../../../src/llm/providers/hosted-beta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EAEV,MAAM,aAAa,CAAC;AAmFrB,qBAAa,iBAAkB,YAAW,eAAe;IACvD,QAAQ,CAAC,IAAI,EAAG,aAAa,CAAU;IACvC,QAAQ,CAAC,YAAY,SAAqB;IAC1C,QAAQ,CAAC,kBAAkB,SAA4B;IAEvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,CAAC,EAAE,MAAM;IAOtB,QAAQ,CACZ,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,kBAAkB,CAAC;CA8D/B"}

package/dist/llm/providers/hosted-beta.js

@@ -0,0 +1,106 @@
+import { DEFAULT_LLM_MODEL, DEFAULT_LLM_VISION_MODEL, GEOTECHCLI_VERSION, } from '../../meta/index.js';
+function inferCallType(request) {
+    const hasVisionInput = request.messages.some((message) => Array.isArray(message.content) &&
+        message.content.some((part) => part.type === 'image_url'));
+    if (hasVisionInput) {
+        return 'vision';
+    }
+    const hasAssistantTurns = request.messages.some((message) => message.role === 'assistant');
+    if (hasAssistantTurns || request.messages.length > 2) {
+        return 'agent';
+    }
+    return 'text';
+}
+function readMessageContent(content) {
+    if (typeof content === 'string') {
+        return content;
+    }
+    if (!Array.isArray(content)) {
+        return '';
+    }
+    return content
+        .map((part) => (part.type === 'text' ? part.text ?? '' : ''))
+        .join('\n')
+        .trim();
+}
+function formatHostedBetaError(status, data, fallback) {
+    const message = data.error?.message?.trim() || fallback;
+    const detail = data.error?.detail?.trim();
+    const remaining = typeof data.error?.remaining === 'number'
+        ? ` Remaining today: ${data.error.remaining}.`
+        : '';
+    const retryAfter = typeof data.error?.retry_after_seconds === 'number'
+        ? ` Retry in about ${data.error.retry_after_seconds}s.`
+        : '';
+    if (status === 429) {
+        return `${message}${remaining}${retryAfter}`.trim();
+    }
+    return detail ? `${message} ${detail}`.trim() : message;
+}
+export class HostedBetaAdapter {
+    name = 'hosted-beta';
+    defaultModel = DEFAULT_LLM_MODEL;
+    defaultVisionModel = DEFAULT_LLM_VISION_MODEL;
+    baseUrl;
+    constructor(baseUrl) {
+        this.baseUrl =
+            baseUrl ??
+                process.env.GEOTECHCLI_PROXY_URL?.trim() ??
+                'https://beta.geotechcli.com/api/proxy';
+    }
+    async complete(request, config) {
+        const callType = inferCallType(request);
+        const effectiveBaseUrl = config.baseUrl?.trim() ||
+            process.env.GEOTECHCLI_PROXY_URL?.trim() ||
+            this.baseUrl;
+        const model = request.model ??
+            config.modelId ??
+            (callType === 'vision' ? this.defaultVisionModel : this.defaultModel);
+        const body = {
+            messages: request.messages,
+            model,
+            temperature: request.temperature,
+            maxTokens: request.maxTokens,
+            jsonMode: request.jsonMode ?? false,
+        };
+        const start = Date.now();
+        const res = await fetch(effectiveBaseUrl, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'X-Geotech-Client': 'geotechcli',
+                'X-Geotech-Client-Version': GEOTECHCLI_VERSION,
+                'X-Geotech-Call-Type': callType,
+            },
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(config.timeout ?? 60_000),
+        });
+        let data = {};
+        let fallbackError = 'Hosted beta AI request failed.';
+        try {
+            data = (await res.json());
+        }
+        catch {
+            fallbackError = await res.text().catch(() => fallbackError);
+        }
+        if (!res.ok) {
+            throw new Error(formatHostedBetaError(res.status, data, fallbackError));
+        }
+        const choice = data.choices?.[0];
+        if (!choice?.message) {
+            throw new Error('Hosted beta AI returned no completion choices.');
+        }
+        return {
+            text: readMessageContent(choice.message.content),
+            usage: {
+                promptTokens: data.usage?.prompt_tokens ?? 0,
+                completionTokens: data.usage?.completion_tokens ?? 0,
+                totalTokens: data.usage?.total_tokens ?? 0,
+            },
+            model: data.model ?? model,
+            provider: 'hosted-beta',
+            latencyMs: Date.now() - start,
+        };
+    }
+}
+//# sourceMappingURL=hosted-beta.js.map

package/dist/llm/providers/hosted-beta.js.map

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

package/dist/llm/providers/huggingface.d.ts

@@ -0,0 +1,37 @@
+import type { ProviderAdapter, CompletionRequest, CompletionResponse, LLMConfig } from '../types.js';
+/**
+ * Hugging Face Inference Providers adapter.
+ *
+ * Uses the OpenAI-compatible router at https://router.huggingface.co/v1
+ * backed by 15+ providers (Cerebras, Together, Groq, Sambanova, etc.)
+ *
+ * Users can specify ANY model from the Hugging Face Hub:
+ *   - meta-llama/Llama-3.1-8B-Instruct
+ *   - mistralai/Mistral-7B-Instruct-v0.3
+ *   - Qwen/Qwen2.5-VL-7B-Instruct (vision)
+ *   - deepseek-ai/DeepSeek-V3
+ *   - google/gemma-2-27b-it
+ *   - etc.
+ *
+ * Append :provider to force a specific backend:
+ *   - meta-llama/Llama-3.1-8B-Instruct:cerebras
+ *   - meta-llama/Llama-3.1-8B-Instruct:together
+ *
+ * Append :fastest or :cheapest for automatic routing:
+ *   - meta-llama/Llama-3.1-8B-Instruct:fastest
+ *   - meta-llama/Llama-3.1-8B-Instruct:cheapest
+ *
+ * Authentication: HF token (hf_xxx) from https://huggingface.co/settings/tokens
+ * Required permission: "Make calls to Inference Providers"
+ *
+ * In strong beta, this provider can be used directly with the user's own token.
+ */
+export declare class HuggingFaceAdapter implements ProviderAdapter {
+    readonly name: "huggingface";
+    readonly defaultModel = "meta-llama/Llama-3.1-8B-Instruct";
+    readonly defaultVisionModel = "Qwen/Qwen2.5-VL-7B-Instruct";
+    private readonly baseUrl;
+    constructor(baseUrl?: string);
+    complete(request: CompletionRequest, config: LLMConfig): Promise<CompletionResponse>;
+}
+//# sourceMappingURL=huggingface.d.ts.map

package/dist/llm/providers/huggingface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"huggingface.d.ts","sourceRoot":"","sources":["../../../src/llm/providers/huggingface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACV,MAAM,aAAa,CAAC;AAmBrB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,kBAAmB,YAAW,eAAe;IACxD,QAAQ,CAAC,IAAI,EAAG,aAAa,CAAU;IACvC,QAAQ,CAAC,YAAY,sCAAsC;IAC3D,QAAQ,CAAC,kBAAkB,iCAAiC;IAE5D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,CAAC,EAAE,MAAM;IAKtB,QAAQ,CACZ,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,kBAAkB,CAAC;CA4H/B"}

package/dist/llm/providers/huggingface.js

@@ -0,0 +1,133 @@
+/**
+ * Hugging Face Inference Providers adapter.
+ *
+ * Uses the OpenAI-compatible router at https://router.huggingface.co/v1
+ * backed by 15+ providers (Cerebras, Together, Groq, Sambanova, etc.)
+ *
+ * Users can specify ANY model from the Hugging Face Hub:
+ *   - meta-llama/Llama-3.1-8B-Instruct
+ *   - mistralai/Mistral-7B-Instruct-v0.3
+ *   - Qwen/Qwen2.5-VL-7B-Instruct (vision)
+ *   - deepseek-ai/DeepSeek-V3
+ *   - google/gemma-2-27b-it
+ *   - etc.
+ *
+ * Append :provider to force a specific backend:
+ *   - meta-llama/Llama-3.1-8B-Instruct:cerebras
+ *   - meta-llama/Llama-3.1-8B-Instruct:together
+ *
+ * Append :fastest or :cheapest for automatic routing:
+ *   - meta-llama/Llama-3.1-8B-Instruct:fastest
+ *   - meta-llama/Llama-3.1-8B-Instruct:cheapest
+ *
+ * Authentication: HF token (hf_xxx) from https://huggingface.co/settings/tokens
+ * Required permission: "Make calls to Inference Providers"
+ *
+ * In strong beta, this provider can be used directly with the user's own token.
+ */
+export class HuggingFaceAdapter {
+    name = 'huggingface';
+    defaultModel = 'meta-llama/Llama-3.1-8B-Instruct';
+    defaultVisionModel = 'Qwen/Qwen2.5-VL-7B-Instruct';
+    baseUrl;
+    constructor(baseUrl) {
+        // router.huggingface.co auto-selects the fastest provider for any model
+        this.baseUrl = baseUrl ?? 'https://router.huggingface.co/v1';
+    }
+    async complete(request, config) {
+        if (!config.apiKey) {
+            throw new Error('Hugging Face token is required. Get one at https://huggingface.co/settings/tokens\n' +
+                'Set it via: geotech config set llm.api_key hf_your_token');
+        }
+        if (!config.apiKey.startsWith('hf_')) {
+            throw new Error('Invalid Hugging Face token format. HF tokens start with "hf_".\n' +
+                'Get a token at https://huggingface.co/settings/tokens');
+        }
+        const effectiveBaseUrl = config.baseUrl ?? this.baseUrl;
+        const model = request.model ?? config.modelId ?? this.defaultModel;
+        // Build messages in OpenAI-compatible format (HF supports this natively)
+        const messages = request.messages.map((msg) => {
+            if (typeof msg.content === 'string') {
+                return { role: msg.role, content: msg.content };
+            }
+            // Multimodal: HF supports OpenAI vision format directly
+            return {
+                role: msg.role,
+                content: msg.content.map((part) => {
+                    if (part.type === 'text') {
+                        return { type: 'text', text: part.text ?? '' };
+                    }
+                    return {
+                        type: 'image_url',
+                        image_url: {
+                            url: part.image_url?.url ?? '',
+                            detail: part.image_url?.detail ?? 'auto',
+                        },
+                    };
+                }),
+            };
+        });
+        const body = {
+            model,
+            messages,
+            stream: false,
+        };
+        if (request.temperature !== undefined) {
+            body.temperature = request.temperature;
+        }
+        if (request.maxTokens !== undefined) {
+            body.max_tokens = request.maxTokens;
+        }
+        if (request.jsonMode) {
+            body.response_format = { type: 'json_object' };
+        }
+        const url = `${effectiveBaseUrl}/chat/completions`;
+        const start = Date.now();
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${config.apiKey}`,
+            },
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(config.timeout ?? 90_000),
+        });
+        if (!res.ok) {
+            const errText = await res.text().catch(() => 'Unknown error');
+            // Friendly error messages for common HF issues
+            if (res.status === 401 || res.status === 403) {
+                throw new Error('Hugging Face authentication failed. Check your token has "Make calls to Inference Providers" permission.\n' +
+                    'Manage tokens at: https://huggingface.co/settings/tokens');
+            }
+            if (res.status === 404) {
+                throw new Error(`Model "${model}" not found on Hugging Face Inference Providers.\n` +
+                    'Browse available models at: https://huggingface.co/models?pipeline_tag=text-generation');
+            }
+            if (res.status === 429) {
+                throw new Error('Hugging Face rate limit reached. Wait a moment and retry, or use a HF PRO account for higher limits.');
+            }
+            if (res.status === 503) {
+                throw new Error(`Model "${model}" is currently loading or unavailable. Try again in 30-60 seconds, or use a different model.`);
+            }
+            throw new Error(`Hugging Face API error (${res.status}): ${errText}`);
+        }
+        const data = (await res.json());
+        const latencyMs = Date.now() - start;
+        const choice = data.choices?.[0];
+        if (!choice) {
+            throw new Error('Hugging Face API returned no choices.');
+        }
+        return {
+            text: choice.message.content,
+            usage: {
+                promptTokens: data.usage?.prompt_tokens ?? 0,
+                completionTokens: data.usage?.completion_tokens ?? 0,
+                totalTokens: data.usage?.total_tokens ?? 0,
+            },
+            model: data.model ?? model,
+            provider: 'huggingface',
+            latencyMs,
+        };
+    }
+}
+//# sourceMappingURL=huggingface.js.map

package/dist/llm/providers/huggingface.js.map

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

package/dist/llm/providers/openai-compatible.d.ts

@@ -0,0 +1,27 @@
+import type { ProviderAdapter, CompletionRequest, CompletionResponse, LLMConfig, LLMProvider } from '../types.js';
+/**
+ * OpenAI-compatible adapter.
+ *
+ * Works with:
+ *   - OpenAI proper (api.openai.com)
+ *   - Qwen on VPS via vLLM / Ollama (any OpenAI-compatible server)
+ *   - Together, Groq, Fireworks, Deepseek, etc.
+ *
+ * This is the adapter used when Zhipu credits expire and you swap
+ * to Qwen 3.5 4B on your VPS. Just change the baseUrl and modelId
+ * in config — zero code changes needed.
+ */
+export declare class OpenAICompatibleAdapter implements ProviderAdapter {
+    readonly name: LLMProvider;
+    readonly defaultModel: string;
+    readonly defaultVisionModel: string;
+    private readonly baseUrl;
+    constructor(options?: {
+        name?: LLMProvider;
+        baseUrl?: string;
+        defaultModel?: string;
+        defaultVisionModel?: string;
+    });
+    complete(request: CompletionRequest, config: LLMConfig): Promise<CompletionResponse>;
+}
+//# sourceMappingURL=openai-compatible.d.ts.map

package/dist/llm/providers/openai-compatible.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-compatible.d.ts","sourceRoot":"","sources":["../../../src/llm/providers/openai-compatible.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,WAAW,EACZ,MAAM,aAAa,CAAC;AAmBrB;;;;;;;;;;;GAWG;AACH,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IAEpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,CAAC,EAAE;QACpB,IAAI,CAAC,EAAE,WAAW,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;KAC7B;IAOK,QAAQ,CACZ,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,kBAAkB,CAAC;CAyF/B"}