forkit-ai-footprints 0.2.0

package/dist/server.js

@@ -0,0 +1,308 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startAiFootprintsServer = startAiFootprintsServer;
+const node_crypto_1 = __importDefault(require("node:crypto"));
+const node_http_1 = __importDefault(require("node:http"));
+const census_1 = require("./census");
+const agents_1 = require("./agents");
+const share_page_1 = require("./share-page");
+const local_device_1 = require("./local-device");
+const monitor_1 = require("./monitor");
+const providers_1 = require("./providers");
+const runtime_activity_1 = require("./runtime-activity");
+const sharing_1 = require("./sharing");
+const insights_1 = require("./insights");
+const localization_1 = require("./localization");
+function securityHeaders(contentType) {
+    return {
+        'cache-control': 'no-store',
+        'content-security-policy': "default-src 'none'; img-src data:; style-src 'unsafe-inline'; script-src 'unsafe-inline'; connect-src 'self'; base-uri 'none'; form-action 'none'; frame-ancestors 'self'",
+        'content-type': contentType,
+        'referrer-policy': 'no-referrer',
+        'x-content-type-options': 'nosniff',
+        'x-frame-options': 'SAMEORIGIN',
+    };
+}
+function sendText(response, status, contentType, body) {
+    response.writeHead(status, securityHeaders(contentType));
+    response.end(body);
+}
+function sendJson(response, status, value) {
+    sendText(response, status, 'application/json; charset=utf-8', JSON.stringify(value));
+}
+async function startAiFootprintsServer(options = {}) {
+    const hostname = options.hostname ?? '127.0.0.1';
+    const requestedPort = options.port ?? 47811;
+    const scan = options.scan ?? (() => (0, census_1.runCensus)());
+    const recordScan = options.recordScan ?? ((generatedAt) => (0, local_device_1.recordLocalScan)({ now: () => new Date(generatedAt) }));
+    const sessionToken = node_crypto_1.default.randomBytes(24).toString('hex');
+    const nativeToken = options.nativeToken ?? process.env.FORKIT_AI_FOOTPRINTS_NATIVE_TOKEN ?? null;
+    const runtimeProviders = (0, providers_1.createDefaultProviders)();
+    let loadedRuntimeCache = new Set();
+    let loadedRuntimeCacheAt = 0;
+    const monitor = options.monitor ?? new monitor_1.ActivityMonitor({
+        classifyProcesses: async (entries) => {
+            const now = Date.now();
+            if (now - loadedRuntimeCacheAt >= 3000) {
+                loadedRuntimeCache = await (0, runtime_activity_1.loadedRuntimeSignatures)(runtimeProviders, new Date(now).toISOString());
+                loadedRuntimeCacheAt = now;
+            }
+            return [
+                ...(0, agents_1.classifyAgentProcessTrees)(entries, process.pid),
+                ...(0, runtime_activity_1.classifyLoadedRuntimeProcesses)(entries, loadedRuntimeCache, process.pid),
+            ];
+        },
+    });
+    let currentReport = await scan();
+    let localDevice = await recordScan(currentReport.generated_at);
+    currentReport.privacy.local_state_written = true;
+    currentReport.privacy.local_state_scope = 'device-journal-only';
+    let scanning = false;
+    const streams = new Set();
+    let origin = '';
+    let closing = null;
+    let currentLocale = 'en';
+    function browserAuthorized(request) {
+        return request.headers.origin === origin
+            && request.headers['x-forkit-footprints-session'] === sessionToken;
+    }
+    function nativeAuthorized(request) {
+        return typeof nativeToken === 'string' && nativeToken.length >= 32
+            && request.headers['x-forkit-footprints-native'] === nativeToken;
+    }
+    function stopStreams() {
+        for (const stream of streams) {
+            clearInterval(stream.timer);
+            stream.response.end();
+        }
+        streams.clear();
+    }
+    function browserSnapshot(snapshot = monitor.snapshot()) {
+        return {
+            ...snapshot,
+            insights: (0, insights_1.buildLocalInsights)(snapshot, {
+                model_record_count: currentReport.summary.model_count,
+                confirmed_running_model_count: currentReport.summary.confirmed_running_model_count,
+            }, 60, currentLocale).map((insight) => insight.text),
+        };
+    }
+    const server = node_http_1.default.createServer(async (request, response) => {
+        const host = request.headers.host ?? '';
+        if (!origin || host !== new URL(origin).host) {
+            sendText(response, 421, 'text/plain; charset=utf-8', 'Invalid local host.');
+            return;
+        }
+        const requestUrl = new URL(request.url ?? '/', origin);
+        const pathname = requestUrl.pathname;
+        if (request.method === 'GET' && (pathname === '/' || pathname === '/index.html')) {
+            const requestedLocale = requestUrl.searchParams.get('lang');
+            currentLocale = requestedLocale === 'en' || requestedLocale === 'de'
+                ? requestedLocale
+                : (0, localization_1.normalizeLocale)(request.headers['accept-language']);
+            sendText(response, 200, 'text/html; charset=utf-8', (0, share_page_1.renderCensusSharePage)(currentReport, {
+                localDeviceLabel: localDevice.device_label,
+                locale: currentLocale,
+                rescan: {
+                    endpoint: '/api/scan',
+                    monitor_start_endpoint: '/api/monitor/start',
+                    monitor_stop_endpoint: '/api/monitor/stop',
+                    monitor_stream_endpoint: '/api/monitor/stream',
+                    monitor_clear_endpoint: '/api/monitor/clear',
+                    contribution_preview_endpoint: '/api/contribution/preview',
+                    locale_endpoint: '/api/ui/locale',
+                    session_token: sessionToken,
+                },
+            }));
+            return;
+        }
+        const browserControl = pathname.startsWith('/api/') && browserAuthorized(request);
+        const nativeControl = pathname.startsWith('/api/native/') && nativeAuthorized(request);
+        if (request.method === 'POST' && pathname === '/api/monitor/stream') {
+            if (!browserControl) {
+                sendJson(response, 403, { error: 'LOCAL_SESSION_REQUIRED' });
+                return;
+            }
+            response.writeHead(200, {
+                ...securityHeaders('application/x-ndjson; charset=utf-8'),
+                'content-security-policy': "default-src 'none'",
+            });
+            const send = () => response.write(`${JSON.stringify(browserSnapshot())}\n`);
+            send();
+            const timer = setInterval(send, 750);
+            timer.unref();
+            const stream = { timer, response };
+            streams.add(stream);
+            request.on('close', () => {
+                clearInterval(timer);
+                streams.delete(stream);
+            });
+            return;
+        }
+        if (request.method === 'POST' && pathname === '/api/scan') {
+            if (!browserControl) {
+                sendJson(response, 403, { error: 'LOCAL_SESSION_REQUIRED' });
+                return;
+            }
+            if (scanning) {
+                sendJson(response, 409, { error: 'SCAN_IN_PROGRESS' });
+                return;
+            }
+            scanning = true;
+            try {
+                currentReport = await scan();
+                localDevice = await recordScan(currentReport.generated_at);
+                currentReport.privacy.local_state_written = true;
+                currentReport.privacy.local_state_scope = 'device-journal-only';
+                sendJson(response, 200, (0, share_page_1.buildLocalScanView)(currentReport));
+            }
+            catch {
+                sendJson(response, 500, { error: 'LOCAL_SCAN_FAILED' });
+            }
+            finally {
+                scanning = false;
+            }
+            return;
+        }
+        const startPath = pathname === '/api/monitor/start' || pathname === '/api/native/start';
+        if (request.method === 'POST' && startPath) {
+            if (!(browserControl || nativeControl)) {
+                sendJson(response, 403, { error: 'LOCAL_SESSION_REQUIRED' });
+                return;
+            }
+            try {
+                const snapshot = await monitor.start();
+                sendJson(response, 200, nativeControl ? snapshot : browserSnapshot(snapshot));
+            }
+            catch {
+                sendJson(response, 500, { error: 'MONITOR_START_FAILED' });
+            }
+            return;
+        }
+        const stopPath = pathname === '/api/monitor/stop' || pathname === '/api/native/stop';
+        if (request.method === 'POST' && stopPath) {
+            if (!(browserControl || nativeControl)) {
+                sendJson(response, 403, { error: 'LOCAL_SESSION_REQUIRED' });
+                return;
+            }
+            const snapshot = monitor.stop();
+            sendJson(response, 200, nativeControl ? snapshot : browserSnapshot(snapshot));
+            return;
+        }
+        if (request.method === 'POST' && pathname === '/api/monitor/clear') {
+            if (!browserControl) {
+                sendJson(response, 403, { error: 'LOCAL_SESSION_REQUIRED' });
+                return;
+            }
+            sendJson(response, 200, browserSnapshot(monitor.clearHistory()));
+            return;
+        }
+        if (request.method === 'POST' && pathname === '/api/ui/locale') {
+            if (!browserControl) {
+                sendJson(response, 403, { error: 'LOCAL_SESSION_REQUIRED' });
+                return;
+            }
+            let raw = '';
+            for await (const chunk of request) {
+                raw += String(chunk);
+                if (raw.length > 128) {
+                    sendJson(response, 413, { error: 'INVALID_LOCALE' });
+                    return;
+                }
+            }
+            try {
+                const value = JSON.parse(raw);
+                if (value.locale !== 'en' && value.locale !== 'de')
+                    throw new Error('INVALID_LOCALE');
+                currentLocale = value.locale;
+                sendJson(response, 200, { locale: currentLocale });
+            }
+            catch {
+                sendJson(response, 400, { error: 'INVALID_LOCALE' });
+            }
+            return;
+        }
+        if (request.method === 'POST' && pathname === '/api/contribution/preview') {
+            if (!browserControl) {
+                sendJson(response, 403, { error: 'LOCAL_SESSION_REQUIRED' });
+                return;
+            }
+            try {
+                sendJson(response, 200, (0, sharing_1.buildAnonymousAiFootprintPreview)(currentReport, monitor.snapshot()));
+            }
+            catch (error) {
+                sendJson(response, 409, { error: error instanceof Error ? error.message : 'CONTRIBUTION_PREVIEW_UNAVAILABLE' });
+            }
+            return;
+        }
+        if (request.method === 'POST' && pathname === '/api/native/status') {
+            if (!nativeControl) {
+                sendJson(response, 403, { error: 'NATIVE_CONTROL_REQUIRED' });
+                return;
+            }
+            sendJson(response, 200, { ...monitor.snapshot(), ui_locale: currentLocale });
+            return;
+        }
+        if (request.method === 'POST' && pathname === '/api/native/quit') {
+            if (!nativeControl) {
+                sendJson(response, 403, { error: 'NATIVE_CONTROL_REQUIRED' });
+                return;
+            }
+            const summary = monitor.stop();
+            sendJson(response, 200, summary);
+            setImmediate(() => { void closeService(); });
+            return;
+        }
+        sendText(response, 404, 'text/plain; charset=utf-8', 'Not found.');
+    });
+    async function listen(port) {
+        await new Promise((resolve, reject) => {
+            const onError = (error) => {
+                server.off('listening', onListening);
+                reject(error);
+            };
+            const onListening = () => {
+                server.off('error', onError);
+                resolve();
+            };
+            server.once('error', onError);
+            server.once('listening', onListening);
+            server.listen(port, hostname);
+        });
+    }
+    try {
+        await listen(requestedPort);
+    }
+    catch (error) {
+        if (error.code !== 'EADDRINUSE' || requestedPort === 0)
+            throw error;
+        await listen(0);
+    }
+    const address = server.address();
+    origin = `http://${hostname}:${address.port}`;
+    function closeService() {
+        if (closing)
+            return closing;
+        closing = new Promise((resolve, reject) => {
+            monitor.stop();
+            stopStreams();
+            if (!server.listening) {
+                resolve();
+                return;
+            }
+            server.close((error) => error ? reject(error) : resolve());
+            server.closeIdleConnections();
+        });
+        return closing;
+    }
+    return {
+        server,
+        url: `${origin}/`,
+        sessionToken,
+        monitor,
+        close: closeService,
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/share-page.d.ts

@@ -0,0 +1,75 @@
+import type { CensusReport } from './types';
+import { type UiLocale } from './localization';
+export interface CensusShareSnapshot {
+    generated_date: string;
+    architecture_label: string;
+    model_record_count: number;
+    verified_runtime_count: number;
+    detected_agent_product_count: number;
+    detected_agent_process_count: number;
+    confirmed_running_model_count: number;
+    model_storage_bytes: number;
+    model_storage_decimal_display: string;
+    model_storage_binary_display: string;
+    model_storage_display: string;
+    model_storage_file_count: number;
+    model_storage_complete: boolean;
+    model_storage_measurement: 'recognized-logical-file-bytes';
+    external_request_count: 0;
+    product_version: string;
+    node_major: number;
+}
+export interface CensusLocalDetails {
+    agents: Array<{
+        name: string;
+        kind: string;
+        process_count: number;
+    }>;
+    runtimes: Array<{
+        name: string;
+        model_count: number;
+        loaded_model_count: number;
+    }>;
+    models: Array<{
+        name: string;
+        source: string;
+        loaded: boolean;
+    }>;
+    tools: Array<{
+        name: string;
+        status: 'configured' | 'online';
+    }>;
+    technical: {
+        runtime_probes: Array<{
+            name: string;
+            state: string;
+            error_code: string | null;
+        }>;
+        warnings: Array<{
+            code: string;
+            message: string;
+        }>;
+    };
+}
+export interface LocalScanView extends CensusShareSnapshot {
+    local_details: CensusLocalDetails;
+}
+export interface LocalRescanOptions {
+    endpoint: string;
+    monitor_start_endpoint: string;
+    monitor_stop_endpoint: string;
+    monitor_stream_endpoint: string;
+    monitor_clear_endpoint: string;
+    contribution_preview_endpoint: string;
+    locale_endpoint: string;
+    session_token: string;
+}
+export interface AiFootprintPageOptions {
+    rescan?: LocalRescanOptions;
+    localDeviceLabel?: string;
+    locale?: UiLocale;
+}
+export declare function buildCensusShareSnapshot(report: CensusReport): CensusShareSnapshot;
+export declare function buildLocalScanView(report: CensusReport): LocalScanView;
+export declare function renderCensusSharePage(report: CensusReport, options?: AiFootprintPageOptions): string;
+//# sourceMappingURL=share-page.d.ts.map

package/dist/share-page.js

@@ -0,0 +1,167 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCensusShareSnapshot = buildCensusShareSnapshot;
+exports.buildLocalScanView = buildLocalScanView;
+exports.renderCensusSharePage = renderCensusSharePage;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const localization_1 = require("./localization");
+function escapeHtml(value) {
+    return String(value).replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;').replaceAll('"', '&quot;').replaceAll("'", '&#039;');
+}
+function safeScriptJson(value) { return JSON.stringify(value).replaceAll('<', '\\u003c'); }
+function formatDecimalStorage(bytes) {
+    if (bytes <= 0)
+        return '0 B';
+    const units = ['B', 'KB', 'MB', 'GB', 'TB', 'PB'];
+    let value = bytes;
+    let unit = 0;
+    while (unit < units.length - 1 && value >= 1000) {
+        value /= 1000;
+        unit += 1;
+    }
+    return `${value.toFixed(value < 10 && unit > 1 ? 2 : value < 100 ? 1 : 0)} ${units[unit]}`;
+}
+function formatBinaryStorage(bytes) {
+    if (bytes <= 0)
+        return '0 B';
+    const units = ['B', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB'];
+    let value = bytes;
+    let unit = 0;
+    while (unit < units.length - 1 && value >= 1024) {
+        value /= 1024;
+        unit += 1;
+    }
+    return `${value.toFixed(value < 10 && unit > 1 ? 2 : value < 100 ? 1 : 0)} ${units[unit]}`;
+}
+function validateRescanOptions(rescan) {
+    for (const value of [rescan.endpoint, rescan.monitor_start_endpoint, rescan.monitor_stop_endpoint, rescan.monitor_stream_endpoint, rescan.monitor_clear_endpoint, rescan.contribution_preview_endpoint, rescan.locale_endpoint]) {
+        if (!value.startsWith('/') || value.startsWith('//'))
+            throw new Error('INVALID_LOCAL_RESCAN_OPTIONS');
+    }
+    if (!/^[a-f0-9]{48}$/.test(rescan.session_token))
+        throw new Error('INVALID_LOCAL_RESCAN_OPTIONS');
+}
+function runtimeLabel(name) {
+    if (name === 'ollama')
+        return 'Ollama';
+    if (name === 'lmstudio')
+        return 'LM Studio';
+    if (name === 'openai-compatible')
+        return 'OpenAI-compatible';
+    return name;
+}
+function sourceLabel(model) {
+    if (model.runtime === 'ollama')
+        return 'Ollama';
+    if (model.runtime === 'lmstudio')
+        return 'LM Studio';
+    if (model.location_hint === 'huggingface-cache')
+        return 'Hugging Face cache';
+    return model.source === 'filesystem' ? 'Local model files' : runtimeLabel(model.runtime);
+}
+function iconDataUrl(file) {
+    try {
+        return `data:image/png;base64,${node_fs_1.default.readFileSync(node_path_1.default.join(__dirname, 'assets', file)).toString('base64')}`;
+    }
+    catch {
+        return null;
+    }
+}
+function buildCensusShareSnapshot(report) {
+    const decimal = formatDecimalStorage(report.summary.storage_bytes);
+    const binary = formatBinaryStorage(report.summary.storage_bytes);
+    return {
+        generated_date: new Intl.DateTimeFormat('en-US', { year: 'numeric', month: 'short', day: 'numeric', timeZone: 'UTC' }).format(new Date(report.generated_at)),
+        architecture_label: report.system.architecture === 'arm64' ? 'Apple Silicon' : report.system.architecture === 'x64' ? 'Intel Mac' : report.system.architecture,
+        model_record_count: report.summary.model_count,
+        verified_runtime_count: report.summary.available_runtime_count,
+        detected_agent_product_count: report.summary.agent_product_count,
+        detected_agent_process_count: report.summary.agent_process_count,
+        confirmed_running_model_count: report.summary.confirmed_running_model_count,
+        model_storage_bytes: report.summary.storage_bytes,
+        model_storage_decimal_display: decimal,
+        model_storage_binary_display: binary,
+        model_storage_display: decimal === binary ? decimal : `${decimal} · ${binary}`,
+        model_storage_file_count: report.summary.storage_file_count,
+        model_storage_complete: report.summary.storage_complete,
+        model_storage_measurement: report.summary.storage_measurement,
+        external_request_count: report.privacy.external_requests_made,
+        product_version: report.product_version,
+        node_major: report.system.node_major,
+    };
+}
+function buildLocalScanView(report) {
+    return {
+        ...buildCensusShareSnapshot(report),
+        local_details: {
+            agents: report.agents.map((agent) => ({ name: agent.name, kind: agent.kind, process_count: agent.instance_count })),
+            runtimes: report.runtimes.filter((runtime) => runtime.name !== 'filesystem' && runtime.status === 'available').map((runtime) => ({
+                name: runtimeLabel(runtime.name), model_count: runtime.model_count,
+                loaded_model_count: report.models.filter((model) => model.runtime === runtime.name && model.evidence_status === 'confirmed-running').length,
+            })),
+            models: report.models.map((model) => ({ name: model.name, source: sourceLabel(model), loaded: model.evidence_status === 'confirmed-running' })),
+            tools: report.tools.map((tool) => ({ name: tool.name, status: tool.evidence_status })),
+            technical: {
+                runtime_probes: report.runtimes.filter((runtime) => runtime.name !== 'filesystem').map((runtime) => ({
+                    name: runtimeLabel(runtime.name), state: runtime.evidence_status, error_code: runtime.error_code,
+                })),
+                warnings: report.warnings.map((warning) => ({ code: warning.code, message: warning.message })),
+            },
+        },
+    };
+}
+function renderCensusSharePage(report, options = {}) {
+    const snapshot = buildCensusShareSnapshot(report);
+    const rescan = options.rescan;
+    if (rescan)
+        validateRescanOptions(rescan);
+    const view = rescan ? buildLocalScanView(report) : null;
+    const locale = options.locale ?? 'en';
+    const t = (key, values = {}) => escapeHtml((0, localization_1.uiText)(locale, key, values));
+    const device = escapeHtml(options.localDeviceLabel ?? (locale === 'de' ? 'Dieses Gerät' : 'This device'));
+    const lightIcon = iconDataUrl('forkit-icon-light.png');
+    const darkIcon = iconDataUrl('forkit-icon-dark.png');
+    const brand = lightIcon ? `<picture><source media="(prefers-color-scheme:dark)" srcset="${darkIcon ?? lightIcon}"><img class="brand-icon" src="${lightIcon}" alt=""></picture>` : '<span class="brand-fallback">F</span>';
+    return `<!doctype html>
+<html lang="${locale}"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta name="color-scheme" content="light dark"><title>Forkit AI Footprint</title>
+<style>
+:root{--bg:#f3eee5;--paper:rgba(255,253,248,.88);--ink:#282624;--muted:#716c64;--line:rgba(42,38,34,.13);--teal:#007f82;--teal2:#d8ecea;--orange:#df8c27;--green:#247f67;--idle:#d8d1c7;--shadow:0 24px 70px rgba(36,32,28,.08)}
+@media(prefers-color-scheme:dark){:root{--bg:#171817;--paper:rgba(35,36,34,.92);--ink:#f2ecdf;--muted:#aaa49a;--line:rgba(242,236,223,.13);--teal:#67beb8;--teal2:#203b39;--orange:#e2af23;--green:#62b99e;--idle:#45423e;--shadow:0 24px 70px rgba(0,0,0,.25)}}
+*{box-sizing:border-box}html{background:var(--bg)}body{margin:0;color:var(--ink);background:radial-gradient(circle at 0 0,rgba(223,140,39,.15),transparent 32rem),radial-gradient(circle at 100% 0,rgba(0,128,128,.14),transparent 34rem),var(--bg);font-family:Inter,ui-sans-serif,-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;-webkit-font-smoothing:antialiased}button,input{font:inherit}[hidden]{display:none!important}.shell{width:min(1040px,calc(100% - 36px));margin:auto;padding:22px 0 30px}.nav{display:flex;align-items:center;justify-content:space-between;margin-bottom:26px}.brand{display:flex;align-items:center;gap:10px;font-weight:830;letter-spacing:-.03em}.brand-icon,.brand-fallback{width:42px;height:42px;border-radius:11px;object-fit:contain}.brand-fallback{display:grid;place-items:center;color:#fff;background:linear-gradient(145deg,var(--teal),var(--orange))}.private{font-size:12px;color:var(--muted)}.private::before{content:'';display:inline-block;width:8px;height:8px;margin-right:8px;border-radius:50%;background:var(--green)}
+.card{border:1px solid var(--line);border-radius:24px;background:var(--paper);box-shadow:var(--shadow);backdrop-filter:blur(18px)}.activity{padding:28px}.topline{display:flex;justify-content:space-between;gap:16px;align-items:start}.eyebrow{margin:0 0 9px;color:var(--teal);font-size:10px;font-weight:850;letter-spacing:.16em;text-transform:uppercase}h1,h2,h3,p{margin-top:0}.state-title{margin:0;font-size:clamp(33px,5vw,58px);line-height:.98;letter-spacing:-.055em}.state-copy{max-width:710px;margin:13px 0 0;color:var(--muted);font-size:13px;line-height:1.55}.badge{display:inline-flex;min-height:31px;align-items:center;padding:0 12px;border-radius:999px;background:var(--idle);font-size:10px;font-weight:850;white-space:nowrap}.badge.working{color:#fff;background:var(--green)}.metrics{display:grid;grid-template-columns:repeat(3,1fr);gap:10px;margin-top:23px}.metric{min-height:104px;padding:16px;border:1px solid var(--line);border-radius:17px;background:rgba(255,255,255,.18)}.metric-label{color:var(--muted);font-size:9px;font-weight:800;letter-spacing:.1em;text-transform:uppercase}.metric-value{margin-top:12px;font-size:26px;font-weight:820;letter-spacing:-.04em}.metric-note{margin-top:5px;color:var(--muted);font-size:9px;line-height:1.4}.context{display:flex;gap:20px;margin-top:15px;padding:12px 14px;border-radius:14px;background:var(--teal2);font-size:11px}.timeline{display:flex;height:13px;gap:2px;margin-top:18px;overflow:hidden;border-radius:999px;background:var(--idle)}.segment{min-width:4px;height:100%}.segment.working-now{background:var(--green)}.segment.open-idle{background:var(--orange)}.segment.not-running{background:var(--idle)}.legend{display:flex;gap:15px;margin-top:8px;color:var(--muted);font-size:9px}.legend i{display:inline-block;width:7px;height:7px;margin-right:5px;border-radius:50%}.legend .work{background:var(--green)}.legend .idle{background:var(--orange)}
+.actions{display:flex;flex-wrap:wrap;gap:9px;margin-top:18px}.button{min-height:43px;padding:0 17px;border:1px solid var(--teal);border-radius:12px;color:#fff;background:var(--teal);font-weight:780;cursor:pointer}.button.secondary{border-color:var(--line);color:var(--ink);background:transparent}.button:disabled{cursor:not-allowed;opacity:.48}.grid{display:grid;grid-template-columns:1fr 1fr;gap:14px;margin-top:14px}.panel{padding:23px}.panel h2{margin-bottom:8px;font-size:24px;letter-spacing:-.04em}.panel-copy{color:var(--muted);font-size:11px;line-height:1.5}.insights{margin-top:14px}.insight-list{display:grid;grid-template-columns:repeat(3,1fr);gap:9px;margin:14px 0 0;padding:0;list-style:none}.insight-list li{min-height:86px;padding:15px;border:1px solid var(--line);border-radius:15px;font-size:14px;font-weight:720;line-height:1.4}.guess-row{display:grid;grid-template-columns:1fr auto;gap:8px;margin-top:16px}.guess-row input{min-height:44px;border:1px solid var(--line);border-radius:12px;padding:0 13px;color:var(--ink);background:transparent;font-weight:760}.footprint-metrics{display:grid;grid-template-columns:repeat(3,1fr);gap:9px;margin-top:16px}.footprint-metrics .metric{min-height:92px}.footprint-metrics .metric-value{font-size:22px}.detail-list{display:grid;gap:9px;margin:12px 0 0;padding:0;list-style:none}.detail-list li{font-size:10px;color:var(--muted);line-height:1.45}.detail-list strong{display:block;color:var(--ink);font-size:11px}.privacy{margin-top:14px;padding:18px 20px}.privacy summary{cursor:pointer;font-size:12px;font-weight:800}.detail-grid{display:grid;grid-template-columns:repeat(3,1fr);gap:10px;margin-top:14px}.detail-box{padding:15px;border:1px solid var(--line);border-radius:15px}.detail-box h3{font-size:13px}.payload{max-height:220px;overflow:auto;padding:13px;border:1px solid var(--line);border-radius:12px;background:rgba(0,0,0,.05);font:10px/1.5 ui-monospace,SFMono-Regular,Menlo,monospace;white-space:pre-wrap;word-break:break-word}.footer{display:flex;justify-content:space-between;gap:20px;margin-top:20px;padding:0 4px;color:var(--muted);font-size:9px;line-height:1.5}
+dialog{width:min(760px,calc(100% - 28px));border:0;border-radius:24px;padding:0;color:var(--ink);background:var(--paper);box-shadow:0 40px 100px rgba(0,0,0,.34)}dialog::backdrop{background:rgba(20,20,18,.62)}.dialog-body{padding:22px}.share-canvas{display:block;width:100%;height:auto;border-radius:16px}.share-actions{display:flex;gap:8px;flex-wrap:wrap;margin-top:12px}
+@media(max-width:760px){.grid{grid-template-columns:1fr}.metrics{grid-template-columns:repeat(3,1fr)}.insight-list,.detail-grid{grid-template-columns:1fr}.topline{display:block}.badge{margin-top:14px}.footer{display:block}.footer span{display:block;margin-top:5px}}@media(max-width:440px){.shell{width:calc(100% - 20px)}.activity,.panel{padding:18px}.metrics,.footprint-metrics{grid-template-columns:1fr}.state-title{font-size:38px}.private{max-width:120px;text-align:right}}
+</style></head><body><main class="shell">
+<header class="nav"><div class="brand">${brand}<span>Forkit AI Footprint</span></div><div><button class="button secondary" id="locale-en" type="button" aria-pressed="${locale === 'en'}">EN</button> <button class="button secondary" id="locale-de" type="button" aria-pressed="${locale === 'de'}">DE</button></div><div class="private">${t('localDevice')}</div></header>
+<section class="card activity"><div class="topline"><div><p class="eyebrow">${t('activityNow')}</p><h1 class="state-title" id="activity-title">${t('monitoringOff')}</h1><p class="state-copy" id="activity-copy">${t('startHelp')}</p></div><span class="badge" id="activity-badge">${t('stopped')}</span></div>
+<div class="context" id="context" hidden><span id="chat-context"></span><span id="workspace-context"></span></div>
+<div class="metrics"><div class="metric"><div class="metric-label">${t('observed')}</div><div class="metric-value" id="observed">0s</div><div class="metric-note">${t('validAwake')}</div></div><div class="metric"><div class="metric-label">${t('aiActive')}</div><div class="metric-value" id="active">0s</div><div class="metric-note">${t('supportedWork')}</div></div><div class="metric"><div class="metric-label">${t('activityRatio')}</div><div class="metric-value" id="ratio">—</div><div class="metric-note">${t('ratioNote')}</div></div></div>
+<div class="timeline" id="timeline" aria-label="${t('activityNow')}"></div><div class="legend"><span><i class="work"></i>${t('working')}</span><span><i class="idle"></i>${t('openIdleLegend')}</span></div>
+${rescan ? `<div class="actions"><button class="button" id="monitor-button" type="button">${t('startMonitoring')}</button><button class="button secondary" id="clear-button" type="button">${t('clearHistory')}</button></div>` : ''}</section>
+<section class="card panel insights" id="insights"><p class="eyebrow" id="insight-eyebrow">${t('earlyObservation')}</p><h2 id="insight-heading">${t('earlyObservationCopy')}</h2><ul class="insight-list" id="insight-list"></ul></section>
+<section class="card panel insights" id="compare-panel"><p class="eyebrow">${t('optionalComparison')}</p><h2 id="compare-title">${t('comparisonQuestion')}</h2><p class="panel-copy" id="compare-copy">${t('comparisonCopy')}</p><p class="panel-copy" id="compare-progress"></p><button class="button secondary" id="review-payload" type="button" disabled>${t('seeGlobal')}</button><div id="consent" hidden><p class="panel-copy"><strong>${t('reviewSharing')}</strong> ${t('payloadIntro')}</p><pre class="payload" id="payload"></pre><div class="actions"><button class="button" id="global-consent" type="button" disabled>${t('shareCompare')}</button><button class="button secondary" id="keep-local" type="button">${t('keepLocal')}</button></div><p class="panel-copy">${t('noIdentity')}</p></div><p class="panel-copy" id="global-result" hidden></p></section>
+<section class="card panel insights"><p class="eyebrow">${t('footprint')}</p><div class="footprint-metrics"><div class="metric"><div class="metric-label">${t('modelRecordsLabel')}</div><div class="metric-value" id="models">${snapshot.model_record_count}</div><div class="metric-note" id="loaded">${snapshot.confirmed_running_model_count ? t('loaded', { count: snapshot.confirmed_running_model_count }) : ''}</div></div><div class="metric"><div class="metric-label">${t('modelStorage')}</div><div class="metric-value" id="storage">${escapeHtml(snapshot.model_storage_decimal_display)}</div><div class="metric-note" id="storage-note">${escapeHtml(snapshot.model_storage_binary_display)} · ${t('recognizedBytes')}</div></div><div class="metric"><div class="metric-label">${t('localEngines')}</div><div class="metric-value" id="engines">${snapshot.verified_runtime_count}</div><div class="metric-note">${t('verifiedAvailable')}</div></div></div><div class="actions"><button class="button" id="share-button" type="button">${t('createShare')}</button>${rescan ? `<button class="button secondary" id="scan-button" type="button">${t('scanAgain')}</button>` : ''}</div><p class="panel-copy" id="scan-status"></p></section>
+${rescan ? `<details class="card privacy"><summary>${t('technical')}</summary><div class="detail-grid"><section class="detail-box" id="runtime-box"><h3>${t('engines')}</h3><ul class="detail-list" id="runtime-list"></ul></section><section class="detail-box" id="model-box"><h3>${t('modelsDevice')}</h3><ul class="detail-list" id="model-list"></ul></section><section class="detail-box" id="app-box"><h3>${t('appsTools')}</h3><ul class="detail-list" id="app-list"></ul></section><section class="detail-box"><h3>${t('measurementBoundary')}</h3><ul class="detail-list"><li><strong>${t('activityMeasurement')}</strong>${t('workingBoundary')}</li><li><strong>${t('storage')}</strong>${t('storageBoundary')}</li></ul></section><section class="detail-box"><h3>${t('forkitResources')}</h3><ul class="detail-list"><li><strong id="overhead">—</strong><span id="overhead-note">${t('measuredLocally')}</span></li></ul></section></div></details>` : ''}
+<footer class="footer"><span>${device} · ${escapeHtml(snapshot.generated_date)} · ${escapeHtml(snapshot.architecture_label)}</span><span>${t('noPrivateFooter')}</span></footer></main>
+<dialog id="share-dialog"><div class="dialog-body"><p class="eyebrow">${t('shareTitle')}</p><h2 id="share-heading">${t('shareHeading')}</h2><canvas class="share-canvas" id="share-canvas" width="1080" height="1080"></canvas><div class="share-actions"><button class="button" id="native-share">${t('share')}</button><button class="button secondary" id="download-share">${t('savePng')}</button><button class="button secondary" id="copy-image">${t('copyImage')}</button><button class="button secondary" id="copy-share">${t('copyCaption')}</button><button class="button secondary" id="close-share">${t('close')}</button></div><p class="panel-copy" id="share-status">${t('sharePrivacy')}</p></div></dialog>
+<script>
+const initial=${safeScriptJson(view ?? snapshot)},config=${rescan ? safeScriptJson(rescan) : 'null'},copy=${safeScriptJson(localization_1.UI_COPY[locale])},locale=${safeScriptJson(locale)},shareLogo=${safeScriptJson(lightIcon)};let footprint={...initial},monitor={lifecycle:'stopped',observed_seconds:0,active_seconds:0,activity_ratio:null,products:[],timeline:[],insights:[],overhead:{current_cpu_percent:null,current_memory_bytes:0,history_bytes:0,sample_count:0,median_cpu_percent:null,p95_cpu_percent:null,max_memory_bytes:0}};const $=id=>document.getElementById(id),text=(key,values={})=>Object.entries(values).reduce((v,[k,x])=>v.replaceAll('{'+k+'}',String(x)),copy[key]),localeTag=locale==='de'?'de-DE':'en-US',format=new Intl.NumberFormat(localeTag),seconds=n=>{const whole=Math.max(0,Math.floor(n));return whole<60?format.format(whole)+(locale==='de'?' Sek.':'s'):whole<3600?format.format(Math.floor(whole/60))+(locale==='de'?' Min. ':'m ')+format.format(whole%60)+(locale==='de'?' Sek.':'s'):format.format(Math.floor(whole/3600))+(locale==='de'?' Std. ':'h ')+format.format(Math.floor((whole%3600)/60))+(locale==='de'?' Min.':'m')},pct=n=>n===null?'—':format.format(Math.round(n*100))+' %',bytes=n=>n<1000000?format.format(Math.round(n/1000))+' KB':format.format(Number((n/1000000).toFixed(1)))+' MB',storage=(n,binary=false)=>{if(!n)return'0 B';const base=binary?1024:1000,units=binary?['B','KiB','MiB','GiB','TiB','PiB']:['B','KB','MB','GB','TB','PB'];let value=n,unit=0;while(unit<units.length-1&&value>=base){value/=base;unit++}const digits=value<10&&unit>1?2:value<100?1:0;return new Intl.NumberFormat(localeTag,{minimumFractionDigits:digits,maximumFractionDigits:digits}).format(value)+' '+units[unit]};
+function auth(url,options={}){return fetch(url,{...options,method:options.method||'POST',headers:{...(options.headers||{}),'content-type':'application/json','x-forkit-footprints-session':config.session_token}})}function names(items){return items.map(item=>item.name)}function list(items){return new Intl.ListFormat(locale==='de'?'de-DE':'en-US',{style:'long',type:'conjunction'}).format(items)}function add(ul,title,detail){const li=document.createElement('li'),strong=document.createElement('strong');strong.textContent=title;li.append(strong,document.createTextNode(detail));ul.append(li)}
+function renderMonitor(){const working=monitor.products.filter(p=>p.state==='working-now'),open=monitor.products.filter(p=>p.state==='open-idle'),badge=$('activity-badge');badge.className='badge';if(monitor.lifecycle==='stopped'){badge.textContent=text('stopped');$('activity-title').textContent=monitor.observed_seconds?text('monitoringStopped'):text('monitoringOff');$('activity-copy').textContent=monitor.observed_seconds?text('summaryPreserved'):text('startHelp');$('monitor-button')&&($('monitor-button').textContent=text('startMonitoring'))}else if(working.length){badge.textContent=text('workingNow');badge.classList.add('working');$('activity-title').textContent=list(names(working));$('activity-copy').textContent=text('workingEvidence');$('monitor-button')&&($('monitor-button').textContent=text('stopMonitoring'))}else if(open.length){badge.textContent=text('openIdle');$('activity-title').textContent=list(names(open));$('activity-copy').textContent=text('idleEvidence');$('monitor-button')&&($('monitor-button').textContent=text('stopMonitoring'))}else{badge.textContent=text('notRunning');$('activity-title').textContent=text('noApp');$('activity-copy').textContent=text('noAppHelp');$('monitor-button')&&($('monitor-button').textContent=text('stopMonitoring'))}
+$('observed').textContent=seconds(monitor.observed_seconds);$('active').textContent=seconds(monitor.active_seconds);$('ratio').textContent=pct(monitor.activity_ratio);if($('overhead')){$('overhead').textContent=monitor.overhead.current_cpu_percent===null?text('warmingUp'):format.format(Number(monitor.overhead.current_cpu_percent.toFixed(1)))+' % CPU';$('overhead-note').textContent=bytes(monitor.overhead.current_memory_bytes)+' RAM · '+bytes(monitor.overhead.history_bytes)}const ctx=[...working,...open].find(p=>p.context&&(p.context.chat||p.context.workspace))?.context;$('context').hidden=!ctx;if(ctx){$('chat-context').textContent=ctx.chat?'Chat · '+ctx.chat:'';$('workspace-context').textContent=ctx.workspace?'Workspace · '+ctx.workspace:''}
+const timeline=$('timeline');timeline.replaceChildren();const total=Math.max(1,monitor.timeline.reduce((n,s)=>n+Math.max(1,new Date(s.ended_at)-new Date(s.started_at)),0));for(const s of monitor.timeline){const el=document.createElement('span');el.className='segment '+s.state;el.style.flex=String(Math.max(1,new Date(s.ended_at)-new Date(s.started_at))/total);timeline.append(el)}const insightList=$('insight-list');insightList.replaceChildren();for(const value of monitor.insights||[]){const li=document.createElement('li');li.textContent=value;insightList.append(li)}const early=monitor.observed_seconds<60;$('insight-eyebrow').textContent=early?text('earlyObservation'):text('observation');$('insight-heading').textContent=early?text('earlyObservationCopy'):text('observationShows');insightList.hidden=early;$('review-payload').disabled=monitor.observed_seconds<600;const remaining=Math.max(0,600-monitor.observed_seconds);$('compare-progress').textContent=remaining?text('globalProgress',{remaining:seconds(remaining)}):''}
+function renderDetails(){if(!config||!footprint.local_details)return;$('storage').textContent=storage(footprint.model_storage_bytes);$('storage-note').textContent=storage(footprint.model_storage_bytes,true)+' · '+text('recognizedBytes');const d=footprint.local_details,rl=$('runtime-list'),ml=$('model-list'),al=$('app-list'),loaded=d.models.filter(m=>m.loaded),onlineTools=d.tools.filter(t=>t.status==='online');for(const x of [rl,ml,al])x.replaceChildren();for(const r of d.runtimes)add(rl,r.name,r.loaded_model_count?text('modelsLoaded',{count:r.loaded_model_count,models:r.loaded_model_count===1?text('model'):text('models')}):text('verifiedAvailable'));for(const m of loaded)add(ml,m.name,text('loaded',{count:''}).trim());for(const a of d.agents)add(al,a.name,text('processActivity'));const seen=new Set(d.agents.map(a=>a.name));for(const tool of onlineTools.filter(v=>!seen.has(v.name)))add(al,tool.name,text('processActivity'));$('runtime-box').hidden=!d.runtimes.length;$('model-box').hidden=!loaded.length;$('app-box').hidden=!d.agents.length&&!onlineTools.length}
+function activeToolNames(){return [...new Set(monitor.products.filter(p=>p.active_seconds>0).map(p=>p.name))]}function primaryInsight(){if(monitor.insights?.length)return monitor.insights[0];if(monitor.observed_seconds)return text('activeShareFallback',{ratio:pct(monitor.activity_ratio)});return text('footprintFallback',{count:footprint.model_record_count,records:footprint.model_record_count===1?text('modelRecord'):text('modelRecords')})}function shareCaption(){const first=text('captionFirst',{ratio:pct(monitor.activity_ratio)}),tools=activeToolNames(),details=[monitor.observed_seconds?text('shareActivity',{observed:seconds(monitor.observed_seconds),active:seconds(monitor.active_seconds),ratio:pct(monitor.activity_ratio)}):'',tools.length?text('shareTool',{tools:list(tools)}):'',text('shareModels',{count:footprint.model_record_count,models:footprint.model_record_count===1?text('model'):text('models'),storage:storage(footprint.model_storage_bytes)})].filter(Boolean).join(' ');return first+'\\n\\n'+details+'\\n\\n'+text('captionQuestion')+'\\n\\nforkit.dev/ai-footprint'}
+function wrap(x,value,left,top,maxWidth,lineHeight,maxLines){const words=value.split(' '),lines=[];let line='';for(const word of words){const next=line?line+' '+word:word;if(x.measureText(next).width>maxWidth&&line){lines.push(line);line=word}else line=next}if(line)lines.push(line);for(let i=0;i<Math.min(lines.length,maxLines);i++)x.fillText(lines[i],left,top+i*lineHeight)}async function draw(){const c=$('share-canvas'),x=c.getContext('2d'),g=x.createLinearGradient(0,0,1080,1080);g.addColorStop(0,'#f6e7d6');g.addColorStop(.56,'#f3eee5');g.addColorStop(1,'#cce9e6');x.fillStyle=g;x.fillRect(0,0,1080,1080);x.fillStyle='rgba(255,253,248,.76)';x.beginPath();x.roundRect(42,42,996,996,38);x.fill();if(shareLogo){const image=await new Promise(resolve=>{const v=new Image();v.onload=()=>resolve(v);v.onerror=()=>resolve(null);v.src=shareLogo});if(image)x.drawImage(image,78,72,82,82)}x.fillStyle='#007f82';x.font='800 25px Inter,sans-serif';x.fillText(text('myFootprint'),78,205);const activity=monitor.observed_seconds?pct(monitor.activity_ratio):format.format(footprint.model_record_count);x.fillStyle='#282624';x.font='900 168px Inter,sans-serif';x.fillText(activity,72,405);x.fillStyle='#007f82';x.font='850 30px Inter,sans-serif';x.fillText(monitor.observed_seconds?text('shareActive'):text('localModels'),82,454);x.fillStyle='rgba(0,127,130,.11)';x.beginPath();x.roundRect(76,520,928,212,28);x.fill();const tools=activeToolNames(),toolValue=tools.length===1?tools[0]:tools.length?format.format(tools.length)+' '+text('activeTools').toLowerCase():'—';x.fillStyle='#716c64';x.font='800 18px Inter,sans-serif';x.fillText(tools.length===1?text('activeTool'):text('activeTools'),108,574);x.fillStyle='#282624';x.font='850 51px Inter,sans-serif';wrap(x,toolValue,108,643,400,54,1);x.fillStyle='#716c64';x.font='800 18px Inter,sans-serif';x.fillText(text('localModels'),570,574);x.fillStyle='#282624';x.font='850 51px Inter,sans-serif';x.fillText(format.format(footprint.model_record_count),570,643);x.strokeStyle='rgba(40,38,36,.12)';x.lineWidth=2;x.beginPath();x.moveTo(530,552);x.lineTo(530,700);x.stroke();x.fillStyle='#282624';x.font='750 29px Inter,sans-serif';wrap(x,text('deviceQuestion'),78,830,880,38,2);x.fillStyle='#716c64';x.font='600 20px Inter,sans-serif';x.fillText('forkit.dev/ai-footprint',78,946);x.textAlign='right';x.fillText(text('observedLocally'),1000,946);x.textAlign='left'}
+for(const next of ['en','de'])$('locale-'+next).addEventListener('click',()=>{localStorage.setItem('forkit-footprints-locale',next);const url=new URL(location.href);url.searchParams.set('lang',next);location.href=url.href});const preferred=localStorage.getItem('forkit-footprints-locale');if(preferred&&preferred!==locale){const url=new URL(location.href);url.searchParams.set('lang',preferred);location.replace(url.href)}
+const dialog=$('share-dialog');$('share-button').addEventListener('click',async()=>{$('share-heading').textContent=primaryInsight();await draw();dialog.showModal()});$('close-share').addEventListener('click',()=>dialog.close());async function blob(){await draw();return new Promise(resolve=>$('share-canvas').toBlob(resolve,'image/png'))}$('download-share').addEventListener('click',async()=>{const b=await blob();if(!b)return;const u=URL.createObjectURL(b),a=document.createElement('a');a.href=u;a.download='my-forkit-ai-footprint.png';a.click();setTimeout(()=>URL.revokeObjectURL(u),1000)});$('copy-share').addEventListener('click',async()=>{await navigator.clipboard.writeText(shareCaption());$('copy-share').textContent=text('copied')});$('copy-image').addEventListener('click',async()=>{const b=await blob();try{await navigator.clipboard.write([new ClipboardItem({'image/png':b})]);$('copy-image').textContent=text('copied')}catch{$('share-status').textContent=text('copyUnavailable')}});$('native-share').addEventListener('click',async()=>{const b=await blob();if(!b)return;const f=new File([b],'my-forkit-ai-footprint.png',{type:'image/png'});if(navigator.share&&(!navigator.canShare||navigator.canShare({files:[f]})))await navigator.share({title:text('shareTitle'),text:shareCaption(),files:[f]});else await navigator.clipboard.writeText(shareCaption())});
+if(config){void auth(config.locale_endpoint,{body:JSON.stringify({locale})});$('monitor-button').addEventListener('click',async()=>{const endpoint=monitor.lifecycle==='monitoring'?config.monitor_stop_endpoint:config.monitor_start_endpoint;const r=await auth(endpoint);if(r.ok){monitor=await r.json();renderMonitor()}});$('clear-button').addEventListener('click',async()=>{if(!confirm(text('clearConfirm')))return;const r=await auth(config.monitor_clear_endpoint);if(r.ok){monitor=await r.json();renderMonitor()}});$('scan-button').addEventListener('click',async()=>{const b=$('scan-button');b.disabled=true;$('scan-status').textContent=text('scanning');try{const r=await auth(config.endpoint);if(!r.ok)throw 0;footprint=await r.json();renderDetails();$('scan-status').textContent=text('refreshed')}catch{$('scan-status').textContent=text('scanFailed')}finally{b.disabled=false}});$('review-payload').addEventListener('click',async()=>{const r=await auth(config.contribution_preview_endpoint);if(!r.ok)return;$('payload').textContent=JSON.stringify(await r.json(),null,2);$('consent').hidden=false});$('keep-local').addEventListener('click',()=>{$('consent').hidden=true});(async()=>{try{const r=await auth(config.monitor_stream_endpoint);if(!r.ok||!r.body)return;const reader=r.body.getReader(),decoder=new TextDecoder();let buf='';while(true){const part=await reader.read();if(part.done)break;buf+=decoder.decode(part.value,{stream:true});const lines=buf.split('\\n');buf=lines.pop()||'';for(const line of lines)if(line){monitor=JSON.parse(line);renderMonitor()}}}catch{}})();renderDetails()}
+renderMonitor();
+</script></body></html>`;
+}
+//# sourceMappingURL=share-page.js.map

package/dist/sharing.d.ts

@@ -0,0 +1,35 @@
+import type { MonitorSnapshot } from './monitor';
+import type { CensusReport } from './types';
+export declare const MINIMUM_COMPARISON_SECONDS = 600;
+export interface AnonymousAiFootprintContribution {
+    schema_version: '2.0';
+    observation: {
+        valid_seconds: number;
+        ai_active_seconds: number;
+        activity_ratio: number;
+    };
+    counts: {
+        supported_apps_observed_working: number;
+        supported_app_categories: string[];
+        local_models_discovered: number;
+        local_models_loaded: number;
+        verified_local_runtimes_available: number;
+    };
+    model_storage_bytes: number;
+    system: {
+        platform: 'darwin';
+        architecture: string;
+        os_major: number;
+    };
+    versions: {
+        scanner: string;
+        node_major: number;
+        monitor_schema: '1.0';
+    };
+}
+export declare function buildAnonymousAiFootprintPreview(report: CensusReport, monitor: MonitorSnapshot, options?: {
+    osMajor?: number;
+}): AnonymousAiFootprintContribution;
+/** Consent is separate from local preview construction. This never uploads. */
+export declare function authorizeAnonymousAiFootprintContribution(payload: AnonymousAiFootprintContribution, consent: boolean): AnonymousAiFootprintContribution;
+//# sourceMappingURL=sharing.d.ts.map