@cline/shared 0.0.93 → 0.0.94-nightly.1792204233

package/dist/runtime/hub-daemon-env.d.ts

@@ -2,6 +2,43 @@ export declare const CLINE_RUN_AS_HUB_DAEMON_ENV = "CLINE_RUN_AS_HUB_DAEMON";
 export declare const CLINE_CONNECTOR_CLI_LAUNCH_ENV = "CLINE_CONNECTOR_CLI_LAUNCH";
 export declare const CLINE_CONNECTOR_STARTING_INSTANCE_ENV = "CLINE_CONNECTOR_STARTING_INSTANCE";
 export declare const CLINE_CONNECTOR_SUPERVISED_ENV = "CLINE_CONNECTOR_SUPERVISED";
+export declare const CLINE_HUB_LAUNCHER_CLIENT_ENV = "CLINE_HUB_LAUNCHER_CLIENT";
+export declare const CLINE_HUB_LAUNCHER_VERSION_ENV = "CLINE_HUB_LAUNCHER_VERSION";
+export declare const CLINE_HUB_LAUNCHER_TRANSPORT_ENV = "CLINE_HUB_LAUNCHER_TRANSPORT";
+/**
+ * Which Cline client started a Hub daemon. The daemon is one shared process
+ * per machine and any client attaches to it, so a session's own client
+ * identity (desktop, CLI, extension) says nothing about whose build is
+ * hosting it. The spawner stamps this into the daemon's environment and the
+ * daemon publishes it as OTel resource attributes, so a trace from a desktop
+ * session can be read as "served by the hub the CLI started" (or vice versa).
+ */
+export interface HubLauncherIdentity {
+    /** Client name of the spawner, e.g. `cline-desktop`, `cline-cli`. */
+    client: string;
+    version?: string;
+    /** `local` for a daemon on the client's own machine, `ssh` for a remote one. */
+    transport?: "local" | "ssh";
+}
+/**
+ * Stamp the launcher identity onto a daemon environment. A launcher already
+ * in `env` is kept as a whole: an embedding host (the desktop app running
+ * `cline-cli hub ensure`) stamps itself before handing the spawn to the CLI,
+ * and filling in fields it left unset from the CLI's identity would pair the
+ * host's name with another build's version.
+ */
+export declare function withHubLauncherIdentity<T extends Record<string, string | undefined>>(env: T, identity: HubLauncherIdentity | undefined): T;
+/**
+ * Take the launcher stamp out of a daemon's environment, returning it.
+ *
+ * Same hazard as {@link claimHubDaemonProcess}: everything a hub-hosted
+ * session spawns inherits the daemon's environment. A shell command that
+ * starts its own hub (`cline hub ensure --discovery-path ...`) would
+ * otherwise keep the outer hub's stamp, and a local CLI hub started inside
+ * an SSH-hosted session would report the desktop launcher and `ssh`.
+ */
+export declare function claimHubLauncherIdentity(env?: Record<string, string | undefined>): HubLauncherIdentity | undefined;
+export declare function readHubLauncherIdentity(env?: Record<string, string | undefined>): HubLauncherIdentity | undefined;
 export interface ConnectorCliLaunchSpec {
     launcher: string;
     connectArgsPrefix: string[];

package/dist/services/telemetry-selfcheck.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Builds the `--telemetry-selfcheck` report (see index.ts). CI runs the
+ * packaged CLI and desktop backend with that flag and fails the publish unless the report
+ * shows telemetry enabled with a usable OTLP endpoint, so the checks here
+ * define what a release-grade build must prove.
+ */
+export type TelemetrySelfcheckConfig = {
+    enabled?: boolean;
+    otlpEndpoint?: string;
+    logsExporter?: string;
+    metricsExporter?: string;
+    tracesExporter?: string;
+};
+export type TelemetrySelfcheckReport = {
+    telemetry_selfcheck: true;
+    enabled: boolean;
+    /**
+     * The OTLP endpoint host when the endpoint is a usable http(s) URL,
+     * `""` when no endpoint was inlined, or `"invalid-endpoint-url"` when
+     * the endpoint cannot work at runtime (unparseable, hostless, or a
+     * non-http scheme the OTLP http/json exporters cannot speak).
+     */
+    otlp_endpoint_host: string;
+    logs_exporter: string;
+    metrics_exporter: string;
+    /**
+     * `""` when no traces exporter was inlined. Without one the host never
+     * registers a tracer provider, so cline-provider spans (the Langfuse
+     * relay) are silently never emitted; release gates require `"otlp"`.
+     */
+    traces_exporter: string;
+};
+export declare function buildTelemetrySelfcheckReport(config: TelemetrySelfcheckConfig): TelemetrySelfcheckReport;

package/dist/services/telemetry.d.ts

@@ -41,6 +41,8 @@ export declare const TASK_CANCELLED_EVENT = "task.cancelled";
 export declare const TASK_MAX_TOKENS_RECOVERY_EVENT = "task.max_tokens_recovery";
 export interface CaptureTaskLifecycleEventInput {
     event: string;
+    /** One issued model request; AI SDK transport retries share this identity. */
+    modelRequestId?: string;
     sessionId?: string;
     ulid?: string;
     agentId?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cline/shared",
-	"version": "0.0.93",
+	"version": "0.0.94-nightly.1792204233",
 	"description": "Shared utilities, types, and schemas for Cline packages",
 	"repository": {
 		"type": "git",