@agentdeck/shared 0.1.0 → 0.2.3

package/dist/llm-settings.js.map

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

package/dist/net-utils.d.ts

@@ -1,3 +1,4 @@
-/** Return the first non-internal IPv4 LAN address, or '127.0.0.1' as fallback. */
+/** Return the default-route IPv4 (preferred), else the first non-internal IPv4
+ * LAN address, or '127.0.0.1' as fallback. */
 export declare function getLanIp(): string;
 //# sourceMappingURL=net-utils.d.ts.map

package/dist/net-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"net-utils.d.ts","sourceRoot":"","sources":["../src/net-utils.ts"],"names":[],"mappings":"AAEA,kFAAkF;AAClF,wBAAgB,QAAQ,IAAI,MAAM,CAQjC"}
+{"version":3,"file":"net-utils.d.ts","sourceRoot":"","sources":["../src/net-utils.ts"],"names":[],"mappings":"AAiEA;8CAC8C;AAC9C,wBAAgB,QAAQ,IAAI,MAAM,CAsCjC"}

package/dist/net-utils.js

@@ -1,11 +1,108 @@
 import { networkInterfaces } from 'os';
-/** Return the first non-internal IPv4 LAN address, or '127.0.0.1' as fallback. */
+import { execFileSync } from 'node:child_process';
+/**
+ * IPv4 of the *default-route* interface — the one the OS actually uses to reach
+ * the LAN/internet. On a dual-homed host (e.g. en0 + en1 on the same subnet),
+ * the raw interface scan below can return an arbitrary secondary address that a
+ * remote device can't reliably reach; the default route is the stable, correct
+ * one to advertise (pairing URL / mDNS / TRMNL BYOS URL). Returns null when the
+ * platform's routing tool is unavailable (→ caller falls back to the heuristic).
+ */
+let routeCache = null;
+function defaultRouteIp() {
+    const now = Date.now();
+    // Short cache: cheap enough to re-probe often (keeps mDNS IP-change detection
+    // responsive) without spawning `route` on every connect.
+    if (routeCache && now - routeCache.at < 3000)
+        return routeCache.ip;
+    let iface = null;
+    let directIp = null;
+    try {
+        if (process.platform === 'darwin') {
+            const out = execFileSync('route', ['-n', 'get', 'default'], { timeout: 1000, encoding: 'utf8' });
+            iface = out.match(/interface:\s*(\S+)/)?.[1] ?? null;
+        }
+        else if (process.platform === 'linux') {
+            const out = execFileSync('ip', ['route', 'get', '1.1.1.1'], { timeout: 1000, encoding: 'utf8' });
+            iface = out.match(/\bdev\s+(\S+)/)?.[1] ?? null;
+        }
+        else if (process.platform === 'win32') {
+            // Windows interface names are friendly strings ("Wi-Fi", "vEthernet (...)"),
+            // so the name-pattern heuristic below can't tell a host-only Hyper-V/WSL
+            // virtual switch (172.x, no gateway) from the real LAN adapter — and on a
+            // Hyper-V host the real LAN IP itself lives on a "vEthernet (External Switch)".
+            // `route print -4 0.0.0.0` resolves this by emitting the *source interface IP*
+            // of each default route directly in the Interface column; pick the lowest
+            // metric so VPN/host-only adapters lose to the physical route.
+            const out = execFileSync('route', ['print', '-4', '0.0.0.0'], { timeout: 1000, encoding: 'utf8' });
+            let bestMetric = Infinity;
+            for (const line of out.split('\n')) {
+                // Network  Netmask  Gateway  Interface  Metric
+                const m = line.trim().match(/^0\.0\.0\.0\s+0\.0\.0\.0\s+\S+\s+(\d+\.\d+\.\d+\.\d+)\s+(\d+)/);
+                if (!m)
+                    continue;
+                const candidate = m[1];
+                const metric = parseInt(m[2], 10);
+                if (candidate === '0.0.0.0' || candidate.startsWith('169.254.'))
+                    continue;
+                if (metric < bestMetric) {
+                    bestMetric = metric;
+                    directIp = candidate;
+                }
+            }
+        }
+    }
+    catch {
+        /* route tool missing / non-POSIX → null, fall back to the heuristic */
+    }
+    let ip = directIp;
+    if (!ip && iface) {
+        for (const net of networkInterfaces()[iface] ?? []) {
+            if (net.family === 'IPv4' && !net.internal && !net.address.startsWith('169.254.')) {
+                ip = net.address;
+                break;
+            }
+        }
+    }
+    routeCache = { ip, at: now };
+    return ip;
+}
+/** Return the default-route IPv4 (preferred), else the first non-internal IPv4
+ * LAN address, or '127.0.0.1' as fallback. */
 export function getLanIp() {
+    const primary = defaultRouteIp();
+    if (primary)
+        return primary;
     const nets = networkInterfaces();
-    for (const name of Object.keys(nets)) {
+    // Sort interfaces: physical wired (en1, en2...) first, then en0, then other non-virtual, then virtual.
+    const sortedNames = Object.keys(nets).sort((a, b) => {
+        const isPhysA = /^(en|eth|wlan)\d+/i.test(a);
+        const isPhysB = /^(en|eth|wlan)\d+/i.test(b);
+        if (isPhysA && !isPhysB)
+            return -1;
+        if (!isPhysA && isPhysB)
+            return 1;
+        if (isPhysA && isPhysB) {
+            // Prioritize en1, en2... over en0 for wired-first setups
+            if (a === 'en0' && b !== 'en0')
+                return 1;
+            if (b === 'en0' && a !== 'en0')
+                return -1;
+            return a.localeCompare(b);
+        }
+        const isVirtA = /^(utun|bridge|vboxnet|docker|lo|gif|stf|awdl|llw|ap)\d*/i.test(a);
+        const isVirtB = /^(utun|bridge|vboxnet|docker|lo|gif|stf|awdl|llw|ap)\d*/i.test(b);
+        if (!isVirtA && isVirtB)
+            return -1;
+        if (isVirtA && !isVirtB)
+            return 1;
+        return a.localeCompare(b);
+    });
+    for (const name of sortedNames) {
         for (const net of nets[name] ?? []) {
-            if (net.family === 'IPv4' && !net.internal)
+            if (net.family === 'IPv4' && !net.internal && !net.address.startsWith('169.254.')) {
                 return net.address;
+            }
         }
     }
     return '127.0.0.1';

package/dist/net-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"net-utils.js","sourceRoot":"","sources":["../src/net-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,IAAI,CAAC;AAEvC,kFAAkF;AAClF,MAAM,UAAU,QAAQ;IACtB,MAAM,IAAI,GAAG,iBAAiB,EAAE,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACnC,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ;gBAAE,OAAO,GAAG,CAAC,OAAO,CAAC;QACjE,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}
+{"version":3,"file":"net-utils.js","sourceRoot":"","sources":["../src/net-utils.ts"],"names":[],"mappings":"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"}

package/dist/pricing.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Model pricing table for APME cost tracking.
+ *
+ * Each `ModelEvent` in a SessionSample is priced at ingestion so cost is a
+ * first-class, per-unit signal (not a post-hoc estimate). Local models (MLX,
+ * on-device Foundation Models) are $0 — that is the whole point of the
+ * local-first judge: guilt-free全数 evaluation.
+ *
+ * IMPORTANT — these rates are best-effort public list prices and are the ONE
+ * place to correct pricing. They are intentionally overridable at runtime so a
+ * code change is never required to fix a rate:
+ *   - `setPricingOverrides({...})` merges a partial table (e.g. loaded from
+ *     ~/.agentdeck/settings.json → apme.pricing) over the defaults.
+ *   - Unknown models fall back to `UNKNOWN_PRICE` ($0) and are flagged via
+ *     `isPricedModel()` so the dashboard can mark cost as "unpriced" rather
+ *     than silently showing $0 as if the call were free.
+ *
+ * Rates are $/million-tokens (USD). Verified model IDs come from the Anthropic
+ * `claude-api` reference; dollar figures should be confirmed against
+ * https://anthropic.com/pricing before relying on absolute cost numbers.
+ */
+export interface ModelPrice {
+    /** USD per 1M input tokens. */
+    inPerMtok: number;
+    /** USD per 1M output tokens. */
+    outPerMtok: number;
+    /** Coarse provider tag for scorecard grouping / "subscription vs marginal". */
+    provider?: string;
+}
+export declare const UNKNOWN_PRICE: ModelPrice;
+/** Merge a partial pricing table over the defaults (e.g. from user settings). */
+export declare function setPricingOverrides(table: Record<string, ModelPrice> | null | undefined): void;
+/** Normalize a raw model id to its pricing key. Strips provider prefixes and
+ *  date suffixes so "anthropic/claude-opus-4-8-20260101" → "claude-opus-4-8". */
+export declare function normalizeModelId(model: string): string;
+/** Local models (MLX, Foundation Models, Ollama, any explicit local: prefix). */
+export declare function isLocalModel(model: string): boolean;
+/** Look up the price record for a model (override → default → local → unknown). */
+export declare function priceFor(model: string | null | undefined): ModelPrice;
+/** True when we have a real (non-$0-fallback) rate or a known-free local model. */
+export declare function isPricedModel(model: string | null | undefined): boolean;
+export declare function providerFor(model: string | null | undefined): string;
+/** Compute USD cost for a single model call. Rounds to 6 dp (≈$0.000001). */
+export declare function priceUsd(model: string | null | undefined, inputTokens: number, outputTokens: number): number;
+//# sourceMappingURL=pricing.d.ts.map

package/dist/pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../src/pricing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,UAAU;IACzB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,aAAa,EAAE,UAAiE,CAAC;AAyB9F,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAE9F;AAED;iFACiF;AACjF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQtD;AAED,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAInD;AAED,mFAAmF;AACnF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,UAAU,CAKrE;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAKvE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAEpE;AAED,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAI5G"}

package/dist/pricing.js

@@ -0,0 +1,93 @@
+/**
+ * Model pricing table for APME cost tracking.
+ *
+ * Each `ModelEvent` in a SessionSample is priced at ingestion so cost is a
+ * first-class, per-unit signal (not a post-hoc estimate). Local models (MLX,
+ * on-device Foundation Models) are $0 — that is the whole point of the
+ * local-first judge: guilt-free全数 evaluation.
+ *
+ * IMPORTANT — these rates are best-effort public list prices and are the ONE
+ * place to correct pricing. They are intentionally overridable at runtime so a
+ * code change is never required to fix a rate:
+ *   - `setPricingOverrides({...})` merges a partial table (e.g. loaded from
+ *     ~/.agentdeck/settings.json → apme.pricing) over the defaults.
+ *   - Unknown models fall back to `UNKNOWN_PRICE` ($0) and are flagged via
+ *     `isPricedModel()` so the dashboard can mark cost as "unpriced" rather
+ *     than silently showing $0 as if the call were free.
+ *
+ * Rates are $/million-tokens (USD). Verified model IDs come from the Anthropic
+ * `claude-api` reference; dollar figures should be confirmed against
+ * https://anthropic.com/pricing before relying on absolute cost numbers.
+ */
+export const UNKNOWN_PRICE = { inPerMtok: 0, outPerMtok: 0, provider: 'unknown' };
+const ZERO_LOCAL = { inPerMtok: 0, outPerMtok: 0, provider: 'local' };
+/**
+ * Default rates. Anthropic family rates use the long-standing public tier list
+ * prices (Opus $15/$75, Sonnet $3/$15, Haiku $1/$5 per Mtok). Confirm/adjust
+ * before treating absolute USD figures as authoritative — see file header.
+ */
+const DEFAULT_PRICING = {
+    // ── Anthropic ──
+    'claude-fable-5': { inPerMtok: 20, outPerMtok: 100, provider: 'anthropic' },
+    'claude-mythos-5': { inPerMtok: 20, outPerMtok: 100, provider: 'anthropic' },
+    'claude-opus-4-8': { inPerMtok: 15, outPerMtok: 75, provider: 'anthropic' },
+    'claude-opus-4-7': { inPerMtok: 15, outPerMtok: 75, provider: 'anthropic' },
+    'claude-opus-4-6': { inPerMtok: 15, outPerMtok: 75, provider: 'anthropic' },
+    'claude-sonnet-4-6': { inPerMtok: 3, outPerMtok: 15, provider: 'anthropic' },
+    'claude-sonnet-4-5': { inPerMtok: 3, outPerMtok: 15, provider: 'anthropic' },
+    'claude-haiku-4-5': { inPerMtok: 1, outPerMtok: 5, provider: 'anthropic' },
+    // ── OpenAI (Codex) — confirm before trusting absolute USD ──
+    'gpt-5-codex': { inPerMtok: 1.25, outPerMtok: 10, provider: 'openai' },
+    'gpt-5': { inPerMtok: 1.25, outPerMtok: 10, provider: 'openai' },
+};
+let overrides = {};
+/** Merge a partial pricing table over the defaults (e.g. from user settings). */
+export function setPricingOverrides(table) {
+    overrides = table ? { ...table } : {};
+}
+/** Normalize a raw model id to its pricing key. Strips provider prefixes and
+ *  date suffixes so "anthropic/claude-opus-4-8-20260101" → "claude-opus-4-8". */
+export function normalizeModelId(model) {
+    let m = model.trim().toLowerCase();
+    // provider prefix: "anthropic/claude-…", "openai/gpt-…", "openrouter:…"
+    const slash = m.lastIndexOf('/');
+    if (slash >= 0 && !m.startsWith('mlx:') && !m.startsWith('local:'))
+        m = m.slice(slash + 1);
+    // date suffix: "-20260101" or "-2026-01-01"
+    m = m.replace(/-\d{8}$/, '').replace(/-\d{4}-\d{2}-\d{2}$/, '');
+    return m;
+}
+/** Local models (MLX, Foundation Models, Ollama, any explicit local: prefix). */
+export function isLocalModel(model) {
+    const m = model.trim().toLowerCase();
+    return m.startsWith('mlx:') || m.startsWith('local:') || m.startsWith('ollama:')
+        || m === 'foundationmodels' || m === 'foundation-models' || m === 'apple-fm';
+}
+/** Look up the price record for a model (override → default → local → unknown). */
+export function priceFor(model) {
+    if (!model)
+        return UNKNOWN_PRICE;
+    if (isLocalModel(model))
+        return ZERO_LOCAL;
+    const key = normalizeModelId(model);
+    return overrides[key] ?? overrides[model] ?? DEFAULT_PRICING[key] ?? DEFAULT_PRICING[model] ?? UNKNOWN_PRICE;
+}
+/** True when we have a real (non-$0-fallback) rate or a known-free local model. */
+export function isPricedModel(model) {
+    if (!model)
+        return false;
+    if (isLocalModel(model))
+        return true; // known $0, not "missing"
+    const key = normalizeModelId(model);
+    return Boolean(overrides[key] ?? overrides[model] ?? DEFAULT_PRICING[key] ?? DEFAULT_PRICING[model]);
+}
+export function providerFor(model) {
+    return priceFor(model).provider ?? 'unknown';
+}
+/** Compute USD cost for a single model call. Rounds to 6 dp (≈$0.000001). */
+export function priceUsd(model, inputTokens, outputTokens) {
+    const p = priceFor(model);
+    const usd = (inputTokens / 1_000_000) * p.inPerMtok + (outputTokens / 1_000_000) * p.outPerMtok;
+    return Math.round(usd * 1_000_000) / 1_000_000;
+}
+//# sourceMappingURL=pricing.js.map

package/dist/pricing.js.map

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