@tokcalc/mcp-server 0.1.3 → 0.2.0-alpha.1

package/src/lib/track.ts

@@ -1,31 +0,0 @@
-/**
- * Plausible Analytics custom event tracking.
- *
- * Usage:
- *   track("shared_scenario", { tab: "calculator" })
- *   track("switched_tab", { tab: "build-vs-buy" })
- *   track("toggled_feature", { feature: "continuous_batching", enabled: true })
- *
- * The window.plausible function is set up by the init script in layout.tsx.
- * If Plausible isn't loaded yet (e.g., during SSR or ad-blocker), calls are
- * silently no-ops — no errors thrown.
- *
- * Custom events show up in your Plausible dashboard under "Custom Events"
- * (may need to be enabled in Plausible site settings → "Custom events").
- */
-
-type EventProps = Record<string, string | number | boolean | undefined>;
-
-export function track(eventName: string, props?: EventProps): void {
-  if (typeof window === "undefined") return;
-
-  // Cast window to access the plausible function we set up via init script
-  const w = window as Window & {
-    plausible?: (eventName: string, options?: { props?: EventProps }) => void;
-  };
-
-  if (typeof w.plausible === "function") {
-    w.plausible(eventName, props ? { props } : undefined);
-  }
-  // Silent no-op if Plausible isn't loaded (SSR, ad-blocker, dev mode)
-}

package/src/lib/url-state.ts

@@ -1,256 +0,0 @@
-/**
- * URL-hash state serialization for tokcalc.
- *
- * Format: `#t=<tab>&<key>=<value>&...`
- * - Compact keys to keep URLs short
- * - Empty/optional values omitted entirely (not encoded as `&=`
- * - Booleans encoded as `1`/`0` (omitted when false)
- * - All numbers as-is (NaN → omitted)
- *
- * Two state namespaces:
- * - Calculator tab:  m/g/q/n/b/p/o/c/s/k/cb/cbm/r/cp/ch/ct/cpr
- * - Build vs Buy tab: sm/sg/sq/sn/sp/u/b/i/o/r/ap/am
- *
- * The `t` key (tab) determines which namespace is active.
- */
-
-export type Tab = "calculator" | "build-vs-buy" | "reference";
-
-/** Calculator tab state — shape mirrors the useState vars in page.tsx */
-export interface CalcTabState {
-  modelId: string;
-  gpuId: string;
-  quantization: string;
-  numGpus: number;
-  batchSize: number;
-  promptTokens: number;
-  outputTokens: number;
-  gpuHourlyCost: number | "";
-  useSpeculative: boolean;
-  speculativeBoost: number;
-  useContinuousBatching: boolean;
-  continuousBatchingMultiplier: number;
-  reasoningTokens: number;
-  cachePrefixTokens: number;
-  cacheHitRate: number;
-  cacheTTL: string;
-  cacheProvider: string;
-  engineId?: string;
-}
-
-/** Build-vs-Buy tab state — shape mirrors BuildVsBuyTab useState vars */
-export interface BvbTabState {
-  shModel: string;
-  shGpu: string;
-  shQuant: string;
-  shNumGpus: number;
-  shGpuPrice: number | "";
-  utilization: number;
-  batchSize: number;
-  inputTokens: number;
-  outputTokens: number;
-  reqsPerDay: number;
-  apiProvider: string;
-  apiModel: string;
-}
-
-/** Parse the URL hash into a structured state object. */
-export function parseUrlHash(hash: string): {
-  tab: Tab;
-  calc?: Partial<CalcTabState>;
-  bvb?: Partial<BvbTabState>;
-} {
-  // Strip leading `#`
-  const stripped = hash.startsWith("#") ? hash.slice(1) : hash;
-  if (!stripped) return { tab: "calculator" };
-
-  const params = new URLSearchParams(stripped);
-  const tabParam = params.get("t");
-  const tab: Tab =
-    tabParam === "build-vs-buy" ? "build-vs-buy" :
-    tabParam === "reference" ? "reference" :
-    "calculator";
-
-  if (tab === "calculator") {
-    return {
-      tab,
-      calc: {
-        modelId: params.get("m") ?? undefined,
-        gpuId: params.get("g") ?? undefined,
-        quantization: params.get("q") ?? undefined,
-        numGpus: numOrUndef(params.get("n")),
-        batchSize: numOrUndef(params.get("b")),
-        promptTokens: numOrUndef(params.get("p")),
-        outputTokens: numOrUndef(params.get("o")),
-        gpuHourlyCost: numOrUndefOrEmpty(params.get("c")),
-        useSpeculative: boolOrUndef(params.get("s")),
-        speculativeBoost: numOrUndef(params.get("k")),
-        useContinuousBatching: boolOrUndef(params.get("cb")),
-        continuousBatchingMultiplier: numOrUndef(params.get("cbm")),
-        reasoningTokens: numOrUndef(params.get("r")),
-        cachePrefixTokens: numOrUndef(params.get("cp")),
-        cacheHitRate: numOrUndef(params.get("ch")),
-        cacheTTL: params.get("ct") ?? undefined,
-        cacheProvider: params.get("cpr") ?? undefined,
-        engineId: params.get("e") ?? undefined,
-      } as Partial<CalcTabState>,
-    };
-  }
-
-  if (tab === "build-vs-buy") {
-    return {
-      tab,
-      bvb: {
-        shModel: params.get("sm") ?? undefined,
-        shGpu: params.get("sg") ?? undefined,
-        shQuant: params.get("sq") ?? undefined,
-        shNumGpus: numOrUndef(params.get("sn")),
-        shGpuPrice: numOrUndefOrEmpty(params.get("sp")),
-        utilization: numOrUndef(params.get("u")),
-        batchSize: numOrUndef(params.get("b")),
-        inputTokens: numOrUndef(params.get("i")),
-        outputTokens: numOrUndef(params.get("o")),
-        reqsPerDay: numOrUndef(params.get("r")),
-        apiProvider: params.get("ap") ?? undefined,
-        apiModel: params.get("am") ?? undefined,
-      } as Partial<BvbTabState>,
-    };
-  }
-
-  return { tab };
-}
-
-/** Serialize Calculator tab state to a URL hash (without leading `#`). */
-export function serializeCalcState(s: CalcTabState): string {
-  const p = new URLSearchParams();
-  p.set("t", "calculator");
-  if (s.modelId) p.set("m", s.modelId);
-  if (s.gpuId) p.set("g", s.gpuId);
-  if (s.quantization) p.set("q", s.quantization);
-  if (s.numGpus !== 1) p.set("n", String(s.numGpus));
-  if (s.batchSize !== 1) p.set("b", String(s.batchSize));
-  if (s.promptTokens !== 500) p.set("p", String(s.promptTokens));
-  if (s.outputTokens !== 200) p.set("o", String(s.outputTokens));
-  if (s.gpuHourlyCost !== "") p.set("c", String(s.gpuHourlyCost));
-  if (s.useSpeculative) { p.set("s", "1"); p.set("k", String(s.speculativeBoost)); }
-  if (s.useContinuousBatching) { p.set("cb", "1"); p.set("cbm", String(s.continuousBatchingMultiplier)); }
-  if (s.reasoningTokens > 0) p.set("r", String(s.reasoningTokens));
-  if (s.cachePrefixTokens > 0) {
-    p.set("cp", String(s.cachePrefixTokens));
-    p.set("ch", String(s.cacheHitRate));
-    if (s.cacheTTL !== "5m") p.set("ct", s.cacheTTL);
-    if (s.cacheProvider !== "self-hosted") p.set("cpr", s.cacheProvider);
-  }
-  if (s.engineId && s.engineId !== "generic") p.set("e", s.engineId);
-  return p.toString();
-}
-
-/** Serialize Build-vs-Buy tab state to a URL hash (without leading `#`). */
-export function serializeBvbState(s: BvbTabState): string {
-  const p = new URLSearchParams();
-  p.set("t", "build-vs-buy");
-  if (s.shModel) p.set("sm", s.shModel);
-  if (s.shGpu) p.set("sg", s.shGpu);
-  if (s.shQuant) p.set("sq", s.shQuant);
-  if (s.shNumGpus !== 1) p.set("sn", String(s.shNumGpus));
-  if (s.shGpuPrice !== "") p.set("sp", String(s.shGpuPrice));
-  if (s.utilization !== 50) p.set("u", String(s.utilization));
-  if (s.batchSize !== 8) p.set("b", String(s.batchSize));
-  if (s.inputTokens !== 500) p.set("i", String(s.inputTokens));
-  if (s.outputTokens !== 200) p.set("o", String(s.outputTokens));
-  if (s.reqsPerDay !== 1000) p.set("r", String(s.reqsPerDay));
-  if (s.apiProvider !== "openai") p.set("ap", s.apiProvider);
-  if (s.apiModel !== "gpt-4o-mini") p.set("am", s.apiModel);
-  return p.toString();
-}
-
-/** Write a hash to the URL without adding a history entry. */
-export function writeUrlHash(hash: string): void {
-  if (typeof window === "undefined") return;
-  const newUrl = `${window.location.pathname}${window.location.search}#${hash}`;
-  window.history.replaceState(null, "", newUrl);
-}
-
-/** Copy current URL to clipboard. Returns true on success. */
-export async function copyCurrentUrlToClipboard(): Promise<boolean> {
-  if (typeof navigator === "undefined" || !navigator.clipboard) return false;
-  try {
-    await navigator.clipboard.writeText(window.location.href);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/* ============================================================
-   LOCALSTORAGE PERSISTENCE (Phase A bonus)
-   ============================================================
-   On unmount (page unload), write the current state to localStorage.
-   On mount, if no URL hash exists, restore from localStorage.
-   URL hash always wins — explicit shares override persistence.
-*/
-
-const STORAGE_KEY_CALC = "tokcalc:calc-state:v1";
-const STORAGE_KEY_BVB = "tokcalc:bvb-state:v1";
-
-/** Save Calculator tab state to localStorage. Silently fails on error. */
-export function saveCalcToStorage(s: CalcTabState): void {
-  if (typeof window === "undefined") return;
-  try {
-    window.localStorage.setItem(STORAGE_KEY_CALC, JSON.stringify(s));
-  } catch {
-    // Quota exceeded or disabled — non-fatal
-  }
-}
-
-/** Save Build-vs-Buy tab state to localStorage. Silently fails on error. */
-export function saveBvbToStorage(s: BvbTabState): void {
-  if (typeof window === "undefined") return;
-  try {
-    window.localStorage.setItem(STORAGE_KEY_BVB, JSON.stringify(s));
-  } catch {
-    // Quota exceeded or disabled — non-fatal
-  }
-}
-
-/** Read saved Calculator state from localStorage (or null if none). */
-export function loadCalcFromStorage(): Partial<CalcTabState> | null {
-  if (typeof window === "undefined") return null;
-  try {
-    const raw = window.localStorage.getItem(STORAGE_KEY_CALC);
-    return raw ? JSON.parse(raw) : null;
-  } catch {
-    return null;
-  }
-}
-
-/** Read saved Build-vs-Buy state from localStorage (or null if none). */
-export function loadBvbFromStorage(): Partial<BvbTabState> | null {
-  if (typeof window === "undefined") return null;
-  try {
-    const raw = window.localStorage.getItem(STORAGE_KEY_BVB);
-    return raw ? JSON.parse(raw) : null;
-  } catch {
-    return null;
-  }
-}
-
-/* ---------- internal helpers ---------- */
-
-function numOrUndef(v: string | null): number | undefined {
-  if (v === null || v === "") return undefined;
-  const n = Number(v);
-  return Number.isFinite(n) ? n : undefined;
-}
-
-function numOrUndefOrEmpty(v: string | null): number | "" | undefined {
-  if (v === null) return undefined;
-  if (v === "") return "";
-  const n = Number(v);
-  return Number.isFinite(n) ? n : undefined;
-}
-
-function boolOrUndef(v: string | null): boolean | undefined {
-  if (v === null) return undefined;
-  return v === "1" || v === "true";
-}

package/src/lib/utils.ts

@@ -1,6 +0,0 @@
-import { clsx, type ClassValue } from "clsx"
-import { twMerge } from "tailwind-merge"
-
-export function cn(...inputs: ClassValue[]) {
-  return twMerge(clsx(inputs))
-}

package/tailwind.config.ts

@@ -1,64 +0,0 @@
-import type { Config } from "tailwindcss";
-import tailwindcssAnimate from "tailwindcss-animate";
-
-const config: Config = {
-    darkMode: "class",
-    content: [
-    "./pages/**/*.{js,ts,jsx,tsx,mdx}",
-    "./components/**/*.{js,ts,jsx,tsx,mdx}",
-    "./app/**/*.{js,ts,jsx,tsx,mdx}",
-  ],
-  theme: {
-  	extend: {
-  		colors: {
-  			background: 'hsl(var(--background))',
-  			foreground: 'hsl(var(--foreground))',
-  			card: {
-  				DEFAULT: 'hsl(var(--card))',
-  				foreground: 'hsl(var(--card-foreground))'
-  			},
-  			popover: {
-  				DEFAULT: 'hsl(var(--popover))',
-  				foreground: 'hsl(var(--popover-foreground))'
-  			},
-  			primary: {
-  				DEFAULT: 'hsl(var(--primary))',
-  				foreground: 'hsl(var(--primary-foreground))'
-  			},
-  			secondary: {
-  				DEFAULT: 'hsl(var(--secondary))',
-  				foreground: 'hsl(var(--secondary-foreground))'
-  			},
-  			muted: {
-  				DEFAULT: 'hsl(var(--muted))',
-  				foreground: 'hsl(var(--muted-foreground))'
-  			},
-  			accent: {
-  				DEFAULT: 'hsl(var(--accent))',
-  				foreground: 'hsl(var(--accent-foreground))'
-  			},
-  			destructive: {
-  				DEFAULT: 'hsl(var(--destructive))',
-  				foreground: 'hsl(var(--destructive-foreground))'
-  			},
-  			border: 'hsl(var(--border))',
-  			input: 'hsl(var(--input))',
-  			ring: 'hsl(var(--ring))',
-  			chart: {
-  				'1': 'hsl(var(--chart-1))',
-  				'2': 'hsl(var(--chart-2))',
-  				'3': 'hsl(var(--chart-3))',
-  				'4': 'hsl(var(--chart-4))',
-  				'5': 'hsl(var(--chart-5))'
-  			}
-  		},
-  		borderRadius: {
-  			lg: 'var(--radius)',
-  			md: 'calc(var(--radius) - 2px)',
-  			sm: 'calc(var(--radius) - 4px)'
-  		}
-  	}
-  },
-  plugins: [tailwindcssAnimate],
-};
-export default config;

package/tests/database-runtime-build.sh

@@ -1,75 +0,0 @@
-#!/bin/bash
-
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "$0")/../.zscripts" && pwd)"
-TEST_ROOT="$(mktemp -d)"
-trap 'rm -rf "$TEST_ROOT"' EXIT
-
-FAKE_BIN="$TEST_ROOT/bin"
-mkdir -p "$FAKE_BIN"
-cat >"$FAKE_BIN/bun" <<'EOF'
-#!/bin/bash
-set -euo pipefail
-
-if [ "$#" -ne 2 ] || [ "$1" != "run" ] || [ "$2" != "db:push" ]; then
-    echo "unexpected bun invocation: $*" >&2
-    exit 1
-fi
-
-case "${DATABASE_URL:-}" in
-    file:*) db_path="${DATABASE_URL#file:}" ;;
-    *)
-        echo "DATABASE_URL must be an absolute SQLite file URL" >&2
-        exit 1
-        ;;
-esac
-
-case "$db_path" in
-    /*) ;;
-    *)
-        echo "database path must be absolute: $db_path" >&2
-        exit 1
-        ;;
-esac
-
-mkdir -p "$(dirname "$db_path")"
-if [ ! -f "$db_path" ]; then
-    printf 'initialized\n' >"$db_path"
-fi
-printf '%s\n' "$DATABASE_URL" >>"${DB_PUSH_CALLS:?}"
-EOF
-chmod +x "$FAKE_BIN/bun"
-
-export PATH="$FAKE_BIN:$PATH"
-export DB_PUSH_CALLS="$TEST_ROOT/db-push-calls"
-
-# 没有 Preview 数据库时，应只在部署产物中初始化空库，不修改项目目录。
-EMPTY_PROJECT="$TEST_ROOT/empty-project"
-EMPTY_BUILD="$TEST_ROOT/empty-build"
-mkdir -p "$EMPTY_PROJECT"
-
-PROJECT_DIR="$EMPTY_PROJECT" BUILD_DIR="$EMPTY_BUILD" \
-    bash "$SCRIPT_DIR/database-runtime-build.sh"
-
-test -f "$EMPTY_BUILD/db/custom.db"
-test "$(cat "$EMPTY_BUILD/db/custom.db")" = "initialized"
-test ! -e "$EMPTY_PROJECT/db/custom.db"
-
-# 有 Preview 数据库时，应保留数据和同目录文件，再对产物执行 schema 同步。
-EXISTING_PROJECT="$TEST_ROOT/existing-project"
-EXISTING_BUILD="$TEST_ROOT/existing-build"
-mkdir -p "$EXISTING_PROJECT/db"
-printf 'preview-data\n' >"$EXISTING_PROJECT/db/custom.db"
-printf 'sidecar\n' >"$EXISTING_PROJECT/db/README.txt"
-
-PROJECT_DIR="$EXISTING_PROJECT" BUILD_DIR="$EXISTING_BUILD" \
-    bash "$SCRIPT_DIR/database-runtime-build.sh"
-
-test "$(cat "$EXISTING_BUILD/db/custom.db")" = "preview-data"
-test "$(cat "$EXISTING_BUILD/db/README.txt")" = "sidecar"
-test "$(wc -l <"$DB_PUSH_CALLS" | tr -d ' ')" = "2"
-grep -Fx "file:$EMPTY_BUILD/db/custom.db" "$DB_PUSH_CALLS"
-grep -Fx "file:$EXISTING_BUILD/db/custom.db" "$DB_PUSH_CALLS"
-
-echo "database runtime build tests passed"

package/tests/python-runtime-build.sh

@@ -1,64 +0,0 @@
-#!/bin/bash
-
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "$0")/../.zscripts" && pwd)"
-TEST_ROOT="$(mktemp -d)"
-trap 'rm -rf "$TEST_ROOT"' EXIT
-
-PROJECT_DIR="$TEST_ROOT/project"
-BUILD_DIR="$TEST_ROOT/build"
-mkdir -p \
-    "$PROJECT_DIR/scripts" \
-    "$PROJECT_DIR/.venv" \
-    "$BUILD_DIR/next-service-dist"
-
-cat >"$PROJECT_DIR/requirements.txt" <<'EOF'
-EOF
-cat >"$PROJECT_DIR/scripts/report.py" <<'EOF'
-print("report")
-EOF
-cat >"$PROJECT_DIR/.venv/should-not-copy.py" <<'EOF'
-ignored
-EOF
-
-PROJECT_DIR="$PROJECT_DIR" BUILD_DIR="$BUILD_DIR" \
-    bash "$SCRIPT_DIR/python-runtime-build.sh"
-
-test -f "$BUILD_DIR/next-service-dist/scripts/report.py"
-test ! -e "$BUILD_DIR/next-service-dist/.venv/should-not-copy.py"
-
-PYPROJECT_DIR="$TEST_ROOT/pyproject-app"
-PYPROJECT_BUILD="$TEST_ROOT/pyproject-build"
-mkdir -p "$PYPROJECT_DIR" "$PYPROJECT_BUILD/next-service-dist"
-cat >"$PYPROJECT_DIR/pyproject.toml" <<'EOF'
-[project]
-name = "deploy-test"
-version = "0.1.0"
-requires-python = ">=3.12"
-dependencies = []
-EOF
-cat >"$PYPROJECT_DIR/app.py" <<'EOF'
-print("pyproject app")
-EOF
-
-PROJECT_DIR="$PYPROJECT_DIR" BUILD_DIR="$PYPROJECT_BUILD" \
-    bash "$SCRIPT_DIR/python-runtime-build.sh"
-test -f "$PYPROJECT_BUILD/next-service-dist/app.py"
-test -f "$PYPROJECT_BUILD/python-runtime/requirements.txt"
-
-NODE_ONLY_PROJECT="$TEST_ROOT/node-only"
-NODE_ONLY_BUILD="$TEST_ROOT/node-only-build"
-mkdir -p "$NODE_ONLY_PROJECT/mini-services/python-worker" "$NODE_ONLY_BUILD"
-cat >"$NODE_ONLY_PROJECT/package.json" <<'EOF'
-{"name": "node-only"}
-EOF
-cat >"$NODE_ONLY_PROJECT/mini-services/python-worker/main.py" <<'EOF'
-print("unsupported preview-only service")
-EOF
-
-PROJECT_DIR="$NODE_ONLY_PROJECT" BUILD_DIR="$NODE_ONLY_BUILD" \
-    bash "$SCRIPT_DIR/python-runtime-build.sh"
-test ! -e "$NODE_ONLY_BUILD/python-runtime"
-
-echo "python runtime build tests passed"

package/tests/python-runtime-container.sh

@@ -1,31 +0,0 @@
-#!/bin/bash
-
-set -euo pipefail
-
-RUNNER_IMAGE="${RUNNER_IMAGE:-z-ai-python-deploy-runner:test}"
-SCRIPT_DIR="$(cd "$(dirname "$0")/../.zscripts" && pwd)"
-TEST_ROOT="$(mktemp -d)"
-trap 'rm -rf "$TEST_ROOT"' EXIT
-
-PROJECT_DIR="$TEST_ROOT/project"
-BUILD_DIR="$TEST_ROOT/build"
-mkdir -p "$PROJECT_DIR" "$BUILD_DIR/next-service-dist"
-
-cat >"$PROJECT_DIR/requirements.txt" <<'EOF'
-idna==3.10
-EOF
-cat >"$PROJECT_DIR/check_runtime.py" <<'EOF'
-import idna
-
-assert idna.__version__ == "3.10"
-print("python artifact import passed")
-EOF
-
-PROJECT_DIR="$PROJECT_DIR" BUILD_DIR="$BUILD_DIR" \
-    bash "$SCRIPT_DIR/python-runtime-build.sh"
-
-docker run --rm \
-    --entrypoint sh \
-    -v "$BUILD_DIR:/app" \
-    "$RUNNER_IMAGE" \
-    -c 'PYTHONPATH=/app/python-runtime/site-packages:/app/next-service-dist python /app/next-service-dist/check_runtime.py'