copilotkit 2.0.4 → 2.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "copilotkit",
-  "version": "2.0.4",
+  "version": "2.1.0",
   "type": "module",
   "bin": {
     "copilotkit": "./index.js"

package/src/config.d.ts

@@ -15,6 +15,18 @@ export declare function setOpsApiUrl(url: string): void;
 export declare function getOpsFrontendUrl(): string;
 /** Override the ops frontend URL at runtime. */
 export declare function setOpsFrontendUrl(url: string): void;
+/**
+ * Resolves the telemetry sink ingest endpoint URL.
+ *
+ * Honors the `COPILOTKIT_TELEMETRY_ENDPOINT` env var when set, otherwise falls
+ * back to the build-time default baked in via esbuild `define`. When neither
+ * is available (unbundled execution like `tsx` or unit tests), returns the
+ * production endpoint as a final fallback — the caller is expected to also
+ * gate sends on dev-mode detection via {@link getBuildInfo}.
+ *
+ * @returns Absolute URL of the telemetry ingest endpoint.
+ */
+export declare function getTelemetryEndpointUrl(): string;
 /**
  * Build identity for this CLI binary.
  *
@@ -22,6 +34,9 @@ export declare function setOpsFrontendUrl(url: string): void;
  * - `buildNumber` — GitHub Actions run id of the build, or `"dev"` for local builds.
  *   Maps back to a workflow run at github.com/<repo>/actions/runs/<buildNumber>.
  * - `commitSha` — git commit the binary was built from, or `"dev"` for local builds.
+ *
+ * Falls back to `"dev"` when running outside an esbuild bundle (e.g., `tsx`
+ * or vitest), so callers do not crash with a `ReferenceError`.
  */
 export declare function getBuildInfo(): {
     version: string;

package/src/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../apps/cli/src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,kDAAkD;AAClD,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,2CAA2C;AAC3C,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,gDAAgD;AAChD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEnD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB,CAMA"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../apps/cli/src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAcH,kDAAkD;AAClD,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,2CAA2C;AAC3C,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,gDAAgD;AAChD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEnD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAQhD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,IAAI;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB,CAMA"}

package/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../apps/cli/src/index.ts"],"names":[],"mappings":";AAoOA;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAIzE;AAgPD;;GAEG;AACH,wBAAsB,IAAI,CAAC,OAAO,WAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiEzE;AAkBD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,SAAS,EAAE,MAAM,GAChB,OAAO,CAMT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../apps/cli/src/index.ts"],"names":[],"mappings":";AAgPA;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAIzE;AA8QD;;GAEG;AACH,wBAAsB,IAAI,CAAC,OAAO,WAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoFzE;AAkBD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,SAAS,EAAE,MAAM,GAChB,OAAO,CAMT"}

package/src/services/telemetry/event-properties.d.ts

@@ -0,0 +1,102 @@
+/** Bounded enum of `command` values emitted on telemetry events. */
+export type TelemetryCommand = "init" | "login" | "logout" | "license" | "whoami" | "docs" | "help" | "version" | "unknown";
+/** Bounded enum of `outcome` values emitted on telemetry events. */
+export type TelemetryOutcome = "started" | "succeeded" | "failed";
+/** Bounded enum of `error_code` values emitted on failed events. */
+export type TelemetryErrorCode = "validation" | "auth" | "network" | "timeout" | "prerequisite_missing" | "template_fetch" | "git" | "filesystem" | "user_aborted" | "unknown";
+/**
+ * Minimal session payload read from the auth store when building base
+ * properties. Decouples this module from the full {@link StoredAuth} shape.
+ */
+export interface TelemetryAuthSnapshot {
+    userId: string;
+    email: string;
+}
+/**
+ * Build identity payload mirroring the shape of {@link getBuildInfo}.
+ */
+export interface TelemetryBuildInfo {
+    version: string;
+    buildNumber: string;
+    commitSha: string;
+}
+/** Injectable dependencies for {@link buildBaseProperties}. */
+export interface BaseDeps {
+    installationId: string;
+    sessionId: string;
+    buildInfo: TelemetryBuildInfo;
+    auth: TelemetryAuthSnapshot | null;
+    env: NodeJS.ProcessEnv;
+    nodeVersion: string;
+    platform: NodeJS.Platform | string;
+    arch: string;
+}
+/** Output shape of {@link buildBaseProperties}. */
+export interface BaseProperties {
+    installation_id: string;
+    session_id: string;
+    cli_version: string;
+    cli_build_number: string;
+    cli_commit_sha: string;
+    node_version: string;
+    platform: string;
+    arch: string;
+    is_ci: boolean;
+    is_authenticated: boolean;
+    clerk_user_id?: string;
+    email_hash?: string;
+}
+/**
+ * Detects whether the current process is running in a CI environment.
+ *
+ * @param env - Process environment variables.
+ * @returns `true` when any known CI indicator env var is set to a non-empty value.
+ */
+export declare function detectCi(env: NodeJS.ProcessEnv): boolean;
+/**
+ * Truncated SHA-256 hash of an email for PII-free correlation.
+ *
+ * Matches the wire format used by ops-api at
+ * `apps/ops-api/src/services/telemetry-sink.service.ts:68-70`.
+ *
+ * @param email - The email to hash.
+ * @returns A 16-character lowercase hex string.
+ */
+export declare function hashEmail(email: string): string;
+/**
+ * Builds the base property set emitted on every telemetry event.
+ *
+ * @param deps - Build identity, auth snapshot, env, and platform info.
+ * @returns The base properties object.
+ */
+export declare function buildBaseProperties(deps: BaseDeps): BaseProperties;
+/**
+ * Flag shape for {@link subcommandForInit}.
+ */
+export interface InitSubcommandFlags {
+    intelligence?: boolean;
+    framework?: string;
+}
+/**
+ * Derives the bounded `subcommand` property for the init/create command.
+ *
+ * Returns `"interactive"` when neither branching flag is set, `"intelligence"`
+ * for the intelligence branch, the framework value when `--framework` is set
+ * to a known {@link AgentFramework}, and `"invalid"` when an unknown framework
+ * value is supplied (to avoid leaking arbitrary user-typed strings).
+ *
+ * @param flags - The parsed init flags.
+ * @returns The bounded subcommand value.
+ */
+export declare function subcommandForInit(flags: InitSubcommandFlags): string;
+/**
+ * Classifies an unknown error value into a bounded {@link TelemetryErrorCode}.
+ *
+ * Inspects `Error.name`, status codes on `ApiClientError`-shaped errors, and
+ * `AbortError` for timeouts. Never returns or emits the raw error message.
+ *
+ * @param err - The thrown value.
+ * @returns A bounded error code suitable for the `error_code` property.
+ */
+export declare function classifyError(err: unknown): TelemetryErrorCode;
+//# sourceMappingURL=event-properties.d.ts.map

package/src/services/telemetry/event-properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-properties.d.ts","sourceRoot":"","sources":["../../../../../../apps/cli/src/services/telemetry/event-properties.ts"],"names":[],"mappings":"AAGA,oEAAoE;AACpE,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,OAAO,GACP,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,MAAM,GACN,MAAM,GACN,SAAS,GACT,SAAS,CAAC;AAEd,oEAAoE;AACpE,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAElE,oEAAoE;AACpE,MAAM,MAAM,kBAAkB,GAC1B,YAAY,GACZ,MAAM,GACN,SAAS,GACT,SAAS,GACT,sBAAsB,GACtB,gBAAgB,GAChB,KAAK,GACL,YAAY,GACZ,cAAc,GACd,SAAS,CAAC;AAEd;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,+DAA+D;AAC/D,MAAM,WAAW,QAAQ;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACnC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,gBAAgB,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAaD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAKxD;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,CAoBlE;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAQpE;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,CA6B9D"}

package/src/services/telemetry/index.d.ts

@@ -0,0 +1,48 @@
+import { type TelemetryEvent, type TelemetryEventProperties, type TelemetryService } from "./telemetry.service.js";
+/**
+ * Lazily constructs and returns the process-wide telemetry service.
+ *
+ * Generates a fresh `session_id` on first call, resolves opt-out state, and
+ * persists the anonymous `installation_id` if not already present.
+ *
+ * @returns The singleton telemetry service.
+ */
+export declare function getTelemetry(): TelemetryService;
+/**
+ * Records a telemetry event through the process-wide singleton.
+ *
+ * @param event - The event payload to send.
+ */
+export declare function recordTelemetryEvent(event: TelemetryEvent): void;
+/**
+ * Awaits in-flight telemetry sends up to a bounded timeout. No-op when the
+ * singleton has not been initialised.
+ *
+ * @param timeoutMs - Optional override for the flush ceiling.
+ */
+export declare function flushTelemetry(timeoutMs?: number): Promise<void>;
+/**
+ * Flushes telemetry then exits the process with the given code. Use this in
+ * place of bare `process.exit(N)` calls anywhere an event may have just been
+ * recorded.
+ *
+ * @param code - The exit code to use.
+ */
+export declare function exitWithFlush(code: number): Promise<never>;
+/**
+ * Wraps an async command runner with a `started` event on entry and a
+ * `succeeded` or `failed` event on exit. The wrapped function's return value
+ * and rejections pass through unchanged.
+ *
+ * @param base - The event properties common to both started and finished
+ *   events (typically `{ command, subcommand?, scope? }`).
+ * @param fn - The command runner to wrap.
+ * @returns The result of `fn`.
+ */
+export declare function withTelemetry<T>(base: Omit<TelemetryEventProperties, "outcome" | "duration_ms" | "error_code">, fn: () => Promise<T>): Promise<T>;
+/**
+ * Test-only helper that drops the singleton so each test sees a fresh state.
+ * Not part of the public production surface.
+ */
+export declare function __resetTelemetryForTests(): void;
+//# sourceMappingURL=index.d.ts.map

package/src/services/telemetry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../apps/cli/src/services/telemetry/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,wBAAwB,EAE7B,KAAK,gBAAgB,EACtB,MAAM,wBAAwB,CAAC;AA2BhC;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI,gBAAgB,CA4B/C;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAEhE;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,SAAS,GAAE,MAAiC,GAC3C,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAGhE;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACnC,IAAI,EAAE,IAAI,CAAC,wBAAwB,EAAE,SAAS,GAAG,aAAa,GAAG,YAAY,CAAC,EAC9E,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAoBZ;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}

package/src/services/telemetry/installation-id.d.ts

@@ -0,0 +1,22 @@
+/** Config-store key under which the persistent installation id is stored. */
+export declare const INSTALLATION_ID_KEY = "telemetry.installationId";
+/** Minimal config-store surface used to persist the installation id. */
+export interface ConfigStoreReadWrite {
+    get<T>(key: string): T | undefined;
+    set(key: string, value: unknown): void;
+}
+/** Injectable dependencies for {@link getOrCreateInstallationId}. */
+export interface InstallationIdDeps {
+    configStore: ConfigStoreReadWrite;
+    /** Injectable UUID generator for deterministic tests. Defaults to crypto. */
+    generateId?: () => string;
+}
+/**
+ * Reads the persistent anonymous installation id, generating and persisting
+ * a fresh UUID v4 on first call.
+ *
+ * @param deps - Injectable config store and id generator.
+ * @returns The installation id as a string.
+ */
+export declare function getOrCreateInstallationId(deps: InstallationIdDeps): string;
+//# sourceMappingURL=installation-id.d.ts.map

package/src/services/telemetry/installation-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installation-id.d.ts","sourceRoot":"","sources":["../../../../../../apps/cli/src/services/telemetry/installation-id.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB,6BAA6B,CAAC;AAE9D,wEAAwE;AACxE,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IACnC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CACxC;AAED,qEAAqE;AACrE,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,oBAAoB,CAAC;IAClC,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAS1E"}

package/src/services/telemetry/opt-out.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Resolves whether telemetry should be disabled for this process.
+ *
+ * Honors, in order of precedence:
+ * 1. The `DO_NOT_TRACK` env var (consoledonottrack.com standard).
+ * 2. The `COPILOTKIT_TELEMETRY_DISABLED` env var.
+ * 3. A persisted `telemetry.optOut` boolean in {@link ConfigStoreReader}.
+ *
+ * Env values are matched case-insensitively against `1 | true | yes | on`.
+ * Empty or unset values are treated as not-set.
+ */
+/** Minimal config-store surface used to read the persisted opt-out flag. */
+export interface ConfigStoreReader {
+    get<T>(key: string): T | undefined;
+}
+/**
+ * Resolves the effective opt-out state for the current process.
+ *
+ * @param env - Process environment variables (defaults to `process.env`).
+ * @param configStore - Persistent config store with `telemetry.optOut`.
+ * @returns `true` when telemetry should be disabled.
+ */
+export declare function resolveOptOut(env: NodeJS.ProcessEnv, configStore: ConfigStoreReader): boolean;
+//# sourceMappingURL=opt-out.d.ts.map

package/src/services/telemetry/opt-out.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opt-out.d.ts","sourceRoot":"","sources":["../../../../../../apps/cli/src/services/telemetry/opt-out.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,4EAA4E;AAC5E,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;CACpC;AAaD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,WAAW,EAAE,iBAAiB,GAC7B,OAAO,CAIT"}

package/src/services/telemetry/telemetry.service.d.ts

@@ -0,0 +1,74 @@
+import type { BaseProperties, TelemetryCommand, TelemetryErrorCode, TelemetryOutcome } from "./event-properties.js";
+/** Wire-shape event name; one allowlist entry covers every CLI event. */
+export declare const CLI_TELEMETRY_EVENT_NAME: "cli.command.invoked";
+/** Per-event property keys that may appear in addition to base properties. */
+export interface TelemetryEventProperties {
+    command: TelemetryCommand;
+    outcome: TelemetryOutcome;
+    subcommand?: string;
+    scope?: "org" | "user";
+    duration_ms?: number;
+    error_code?: TelemetryErrorCode;
+}
+/** Full event payload accepted by {@link TelemetryService.recordEvent}. */
+export interface TelemetryEvent {
+    properties: TelemetryEventProperties;
+}
+/** Maximum concurrent in-flight requests; excess events are dropped. */
+export declare const MAX_INFLIGHT = 32;
+/** Per-request hard timeout for the outbound POST. */
+export declare const DEFAULT_PER_REQUEST_TIMEOUT_MS = 2000;
+/** Default flush timeout used by {@link TelemetryService.flush}. */
+export declare const DEFAULT_FLUSH_TIMEOUT_MS = 1500;
+/**
+ * Minimal logger surface used by the telemetry service. Mirrors the subset of
+ * the CLI's `writeCliLog` signature so callers can pass a thin wrapper.
+ */
+export interface TelemetryLogger {
+    debug: (payload: Record<string, unknown>) => void;
+    warn: (payload: Record<string, unknown>) => void;
+    error: (payload: Record<string, unknown>) => void;
+}
+/** Injectable dependencies for {@link createTelemetryService}. */
+export interface TelemetryServiceDeps {
+    /** Master on/off; when `false`, `recordEvent` is a synchronous no-op. */
+    enabled: boolean;
+    /** Absolute URL of the telemetry ingest endpoint. */
+    endpointUrl: string;
+    /** Producer of the base properties merged into every event. */
+    buildBaseProperties: () => BaseProperties;
+    /** Structured logger for diagnostic events. */
+    logger: TelemetryLogger;
+    /** Injectable fetch for tests. Defaults to global `fetch`. */
+    fetch?: typeof fetch;
+    /** Per-request hard timeout. Defaults to {@link DEFAULT_PER_REQUEST_TIMEOUT_MS}. */
+    perRequestTimeoutMs?: number;
+    /** Cap on in-flight requests. Defaults to {@link MAX_INFLIGHT}. */
+    maxInFlight?: number;
+}
+/** Public surface of the telemetry service. */
+export interface TelemetryService {
+    /**
+     * Synchronously schedules a telemetry event for fire-and-forget delivery.
+     * Returns `void` and never throws — callers must not `await` this.
+     */
+    recordEvent(event: TelemetryEvent): void;
+    /**
+     * Awaits all in-flight requests up to a bounded timeout, then resolves.
+     * Safe to call multiple times; resolves immediately when the queue is empty.
+     */
+    flush(timeoutMs?: number): Promise<void>;
+}
+/**
+ * Constructs a CLI telemetry service.
+ *
+ * Sends `{ event: "cli.command.invoked", properties }` to the configured
+ * endpoint as fire-and-forget POSTs, with a bounded in-flight queue and a
+ * per-request `AbortController`. All failures are swallowed and logged via
+ * the injected `logger`.
+ *
+ * @param deps - Injectable configuration and collaborators.
+ * @returns The telemetry service instance.
+ */
+export declare function createTelemetryService(deps: TelemetryServiceDeps): TelemetryService;
+//# sourceMappingURL=telemetry.service.d.ts.map

package/src/services/telemetry/telemetry.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.service.d.ts","sourceRoot":"","sources":["../../../../../../apps/cli/src/services/telemetry/telemetry.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEpH,yEAAyE;AACzE,eAAO,MAAM,wBAAwB,EAAG,qBAA8B,CAAC;AAEvE,8EAA8E;AAC9E,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,kBAAkB,CAAC;CACjC;AAED,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,wBAAwB,CAAC;CACtC;AAED,wEAAwE;AACxE,eAAO,MAAM,YAAY,KAAK,CAAC;AAE/B,sDAAsD;AACtD,eAAO,MAAM,8BAA8B,OAAQ,CAAC;AAEpD,oEAAoE;AACpE,eAAO,MAAM,wBAAwB,OAAQ,CAAC;AAE9C;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAClD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACjD,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACnD;AAED,kEAAkE;AAClE,MAAM,WAAW,oBAAoB;IACnC,yEAAyE;IACzE,OAAO,EAAE,OAAO,CAAC;IACjB,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,mBAAmB,EAAE,MAAM,cAAc,CAAC;IAC1C,+CAA+C;IAC/C,MAAM,EAAE,eAAe,CAAC;IACxB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,oFAAoF;IACpF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,+CAA+C;AAC/C,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IAEzC;;;OAGG;IACH,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,oBAAoB,GAAG,gBAAgB,CA6FnF"}