pi-codex-image-gen 0.1.5 → 0.1.7

package/CHANGELOG.md

@@ -6,6 +6,18 @@ This project follows the spirit of [Keep a Changelog](https://keepachangelog.com
 
 ## [Unreleased]
 
+## [0.1.7] - 2026-05-10
+
+### Added
+
+- Install/update telemetry ping to `mocito.dev`, gated by Pi telemetry/offline settings and deduplicated per package version.
+
+## [0.1.6] - 2026-05-09
+
+### Changed
+
+- Switched development, CI, and publish workflows from Bun to npm with `package-lock.json` for better Pi package consistency.
+
 ## [0.1.5] - 2026-05-07
 
 ### Added

package/CONTRIBUTING.md

@@ -5,8 +5,8 @@ Thanks for your interest in contributing to `pi-codex-image-gen`.
 ## Development setup
 
 ```bash
-bun install
-bun run check
+npm install
+npm run check
 ```
 
 The package is source-distributed: Pi loads the TypeScript extension file directly. There is no build step for runtime use.
@@ -41,8 +41,8 @@ python3 skills/imagegen/scripts/remove_chroma_key.py --help
 
 Before opening a pull request:
 
-- Run `bun run check`.
-- Run `bun run pack:dry-run` and confirm the package contents are intentional.
+- Run `npm run check`.
+- Run `npm run pack:dry-run` and confirm the package contents are intentional.
 - Update `README.md` if user-facing behavior changes.
 - Update `CHANGELOG.md` for notable changes.
 - Keep examples and paths generic; do not commit machine-specific paths or credentials.

package/README.md

@@ -67,6 +67,8 @@ Project config overrides global config. Example:
 | ---------------------------- | ------------------------------------------------ |
 | `PI_CODEX_IMAGE_SAVE_MODE`   | Overrides the `save` config key.                 |
 | `PI_CODEX_IMAGE_SAVE_DIR`    | Overrides the `saveDir` config key (custom mode).|
+| `PI_OFFLINE=1`               | Disables install/update telemetry.              |
+| `PI_TELEMETRY=0`             | Disables install/update telemetry.              |
 
 ## Save modes
 

package/index.ts

@@ -13,6 +13,7 @@ import { StringEnum } from "@earendil-works/pi-ai";
 import { type ExtensionAPI, getAgentDir, withFileMutationQueue } from "@earendil-works/pi-coding-agent";
 import { type Static, Type } from "typebox";
 
+const PACKAGE_NAME = "pi-codex-image-gen";
 const PROVIDER = "openai-codex";
 const DEFAULT_MODEL = "gpt-5.5";
 const CODEX_RESPONSES_URL = "https://chatgpt.com/backend-api/codex/responses";
@@ -21,6 +22,8 @@ const DEFAULT_SAVE_MODE = "global";
 const OPENAI_BETA_HEADER = "responses=experimental";
 const MAX_RETRIES = 3;
 const BASE_DELAY_MS = 1000;
+const INSTALL_TELEMETRY_URL = "https://mocito.dev/api/report-install";
+const INSTALL_TELEMETRY_TIMEOUT_MS = 5000;
 
 const SAVE_MODES = ["none", "project", "global", "custom"] as const;
 type SaveMode = (typeof SAVE_MODES)[number];
@@ -85,6 +88,10 @@ interface ParsedCodexResponse {
 	usage?: unknown;
 }
 
+interface InstallTelemetryState {
+	lastReportedVersion?: string;
+}
+
 // --- #11: Typed SSE event discriminated union ---
 
 type CodexSseEvent =
@@ -147,6 +154,55 @@ function loadConfig(cwd: string): ExtensionConfig {
 	return { ...globalConfig, ...projectConfig };
 }
 
+function isTruthyEnvFlag(value: string | undefined): boolean {
+	if (!value) return false;
+	return value === "1" || value.toLowerCase() === "true" || value.toLowerCase() === "yes";
+}
+
+function isInstallTelemetryEnabled(): boolean {
+	if (isTruthyEnvFlag(process.env.PI_OFFLINE)) return false;
+	if (process.env.PI_TELEMETRY !== undefined) return isTruthyEnvFlag(process.env.PI_TELEMETRY);
+	const settings = readConfigFile(join(getAgentDir(), "settings.json")) as { enableInstallTelemetry?: unknown };
+	return settings.enableInstallTelemetry !== false;
+}
+
+function getPackageVersion(): string {
+	try {
+		const packageJson = JSON.parse(readFileSync(new URL("./package.json", import.meta.url), "utf8")) as { version?: unknown };
+		return typeof packageJson.version === "string" && packageJson.version.length > 0 ? packageJson.version : "0.0.0";
+	} catch {
+		return "0.0.0";
+	}
+}
+
+function getInstallTelemetryUserAgent(version: string): string {
+	const runtimeVersions = process.versions as NodeJS.ProcessVersions & { bun?: string };
+	const runtime = runtimeVersions.bun ? `bun/${runtimeVersions.bun}` : `node/${process.version}`;
+	return `${PACKAGE_NAME}/${version} (${process.platform}; ${runtime}; ${process.arch})`;
+}
+
+async function reportInstallTelemetry(): Promise<void> {
+	try {
+		if (!isInstallTelemetryEnabled()) return;
+
+		const version = getPackageVersion();
+		const statePath = join(getAgentDir(), "extensions", "codex-image-gen-install.json");
+		const state = readConfigFile(statePath) as InstallTelemetryState;
+		if (state.lastReportedVersion === version) return;
+
+		await mkdir(join(getAgentDir(), "extensions"), { recursive: true });
+		await writeFile(statePath, `${JSON.stringify({ lastReportedVersion: version }, null, 2)}\n`);
+
+		const params = new URLSearchParams({ tool: PACKAGE_NAME, version });
+		await fetch(`${INSTALL_TELEMETRY_URL}?${params.toString()}`, {
+			headers: { "User-Agent": getInstallTelemetryUserAgent(version) },
+			signal: AbortSignal.timeout(INSTALL_TELEMETRY_TIMEOUT_MS),
+		});
+	} catch {
+		// Best-effort telemetry: ignore settings, filesystem, and network failures.
+	}
+}
+
 // --- Path helpers ---
 
 function resolveUnderCwd(cwd: string, path: string): string {
@@ -385,6 +441,8 @@ async function requestImage(
 // --- Extension entry point ---
 
 export default function codexImageGen(pi: ExtensionAPI) {
+	void reportInstallTelemetry();
+
 	pi.registerTool({
 		name: "codex_generate_image",
 		label: "Codex Image",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-codex-image-gen",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Image generation for Pi using the ChatGPT Images 2.0 model.",
   "type": "module",
   "license": "Apache-2.0",