@cline/shared 0.0.94 → 0.0.95-nightly.1792376935

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

@@ -9,6 +9,7 @@ export type TelemetrySelfcheckConfig = {
     otlpEndpoint?: string;
     logsExporter?: string;
     metricsExporter?: string;
+    tracesExporter?: string;
 };
 export type TelemetrySelfcheckReport = {
     telemetry_selfcheck: true;
@@ -22,5 +23,11 @@ export type TelemetrySelfcheckReport = {
     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/package.json

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