pi-codex-image-gen 0.1.6 → 0.1.8

package/CHANGELOG.md

@@ -6,6 +6,18 @@ This project follows the spirit of [Keep a Changelog](https://keepachangelog.com
 
 ## [Unreleased]
 
+## [0.1.8] - 2026-05-10
+
+### Fixed
+
+- Disable install/update telemetry automatically in CI environments.
+
+## [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

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,23 @@ 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 CI_ENV_VARS = [
+	"CI",
+	"GITHUB_ACTIONS",
+	"GITLAB_CI",
+	"CIRCLECI",
+	"BUILDKITE",
+	"JENKINS_URL",
+	"TEAMCITY_VERSION",
+	"TF_BUILD",
+	"BITBUCKET_BUILD_NUMBER",
+	"APPVEYOR",
+	"TRAVIS",
+	"DRONE",
+	"CODEBUILD_BUILD_ID",
+] as const;
 
 const SAVE_MODES = ["none", "project", "global", "custom"] as const;
 type SaveMode = (typeof SAVE_MODES)[number];
@@ -85,6 +103,10 @@ interface ParsedCodexResponse {
 	usage?: unknown;
 }
 
+interface InstallTelemetryState {
+	lastReportedVersion?: string;
+}
+
 // --- #11: Typed SSE event discriminated union ---
 
 type CodexSseEvent =
@@ -147,6 +169,63 @@ 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 isCiEnvironment(): boolean {
+	return CI_ENV_VARS.some((name) => {
+		const value = process.env[name];
+		return value !== undefined && value !== "" && value !== "0" && value.toLowerCase() !== "false";
+	});
+}
+
+function isInstallTelemetryEnabled(): boolean {
+	if (isCiEnvironment()) return false;
+	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 +464,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.6",
+  "version": "0.1.8",
   "description": "Image generation for Pi using the ChatGPT Images 2.0 model.",
   "type": "module",
   "license": "Apache-2.0",