@cline/core 0.0.95 → 0.2.0-nightly.1793312794

package/dist/remote/remote-environments.d.ts

@@ -139,6 +139,7 @@ export declare class RemoteEnvironmentService {
     private validateDirectory;
     private execRemote;
     private execRemoteAllowFailure;
+    private buildCommandArgs;
     private buildSshArgs;
     private buildTunnelArgs;
     private destination;

package/dist/runtime/config/agent-runtime-config-builder.d.ts

@@ -47,6 +47,8 @@ export interface CreateAgentRuntimeConfigInput {
     readonly hooks?: Partial<AgentRuntimeHooks>;
     /** Host-owned context pipeline invoked before runtime model hooks. */
     readonly prepareTurn?: (context: AgentRuntimePrepareTurnContext) => Promise<AgentRuntimePrepareTurnResult | undefined> | AgentRuntimePrepareTurnResult | undefined;
+    /** Host-derived diagnostics merged into the run-end telemetry. */
+    readonly runEndTelemetryProperties?: AgentRuntimeConfig["runEndTelemetryProperties"];
     /** Seed messages (usually `session.conversation.getMessages()`). */
     readonly initialMessages?: readonly AgentMessage[];
     /**

package/dist/runtime/host/local-runtime-host.d.ts

@@ -1,7 +1,9 @@
 import type * as LlmsProviders from "@cline/llms";
 import { type AgentConfig, type AgentResult, type BasicLogger, type ITelemetryService } from "@cline/shared";
 import type { ConnectorsRequest } from "../../extensions/composio/composio-meta-tools";
+import type { McpAppResourceReadRequest, McpAppToolBinding, McpAppToolCallRequest, McpResourceReadResult, McpToolCallResult } from "../../extensions/mcp";
 import type { HookEventPayload } from "../../hooks";
+import { type PluginCommandsApi } from "../../services/plugin-command-api";
 import { ProviderSettingsManager } from "../../services/storage/provider-settings-manager";
 import { type SessionCompactionState } from "../../session/models/session-compaction";
 import type { CoreSessionConfig } from "../../types/config";
@@ -35,6 +37,8 @@ export interface LocalRuntimeHostOptions {
 export declare class LocalRuntimeHost implements RuntimeHost {
     readonly runtimeAddress: undefined;
     readonly pendingPrompts: PendingPromptsServiceApi;
+    readonly pluginCommands: PluginCommandsApi;
+    private readonly pluginCommandManager;
     private readonly sessionService;
     private readonly runtimeBuilder;
     private readonly createAgentInstance;
@@ -61,11 +65,16 @@ export declare class LocalRuntimeHost implements RuntimeHost {
     constructor(options: LocalRuntimeHostOptions);
     private applyInitialOAuthCredentials;
     startSession(input: StartSessionInput): Promise<StartSessionResult>;
+    private liveSessionStartResult;
     private startResolvedSession;
     restoreSession(input: RestoreSessionInput): Promise<RestoreSessionResult>;
     runTurn(input: SendSessionInput): Promise<AgentResult | undefined>;
     getAccumulatedUsage(sessionId: string): Promise<SessionUsageSummary | undefined>;
     abort(sessionId: string, reason?: unknown): Promise<void>;
+    resolveMcpAppTool(sessionId: string, toolName: string): Promise<McpAppToolBinding | undefined>;
+    readMcpAppResource(sessionId: string, request: McpAppResourceReadRequest): Promise<McpResourceReadResult>;
+    callMcpAppTool(sessionId: string, request: McpAppToolCallRequest): Promise<McpToolCallResult>;
+    private requireMcpApps;
     proceedWhileRunning(sessionId: string, toolCallId?: string): Promise<number>;
     stopSession(sessionId: string): Promise<void>;
     dispose(reason?: string): Promise<void>;
@@ -168,6 +177,7 @@ export declare class LocalRuntimeHost implements RuntimeHost {
     private updateStatus;
     private runWithAuthRetry;
     private syncOAuthCredentials;
+    private withSessionPluginCommands;
     private getSessionOrThrow;
     private resolveAbsoluteFilePaths;
     private getSessionAgentTelemetryIdentity;

package/dist/runtime/host/runtime-host.d.ts

@@ -1,5 +1,6 @@
 import type * as LlmsProviders from "@cline/llms";
 import type { AgentMode, AgentResult, RuntimeConfigExtensionKind } from "@cline/shared";
+import type { McpAppResourceReadRequest, McpAppToolBinding, McpAppToolCallRequest, McpResourceReadResult, McpToolCallResult } from "../../extensions/mcp";
 import type { HookEventPayload } from "../../hooks";
 import type { CheckpointEntry } from "../../hooks/checkpoint-hooks";
 import type { ProviderSettings } from "../../services/llms/provider-settings";
@@ -170,6 +171,11 @@ export interface SessionModelRuntimeService {
 export interface SessionConnectionRuntimeService {
     updateSessionConnection(sessionId: string, updates: SessionConnectionUpdate): Promise<void>;
 }
+export interface McpAppsRuntimeService {
+    resolveMcpAppTool(sessionId: string, toolName: string): Promise<McpAppToolBinding | undefined>;
+    readMcpAppResource(sessionId: string, request: McpAppResourceReadRequest): Promise<McpResourceReadResult>;
+    callMcpAppTool(sessionId: string, request: McpAppToolCallRequest): Promise<McpToolCallResult>;
+}
 export interface CommandExecutionRuntimeService {
     proceedWhileRunning(sessionId: string, toolCallId?: string): Promise<number>;
 }

package/dist/runtime/orchestration/runtime-oauth-token-manager.d.ts

@@ -1,5 +1,6 @@
 import type { ITelemetryService } from "@cline/shared";
 import { ProviderSettingsManager } from "../../services/storage/provider-settings-manager";
+import type { ProviderSettings } from "../../types/provider-settings";
 type ManagedOAuthProviderId = string;
 export declare class OAuthReauthRequiredError extends Error {
     readonly providerId: ManagedOAuthProviderId;
@@ -13,10 +14,12 @@ export type RuntimeOAuthResolution = {
 export declare class RuntimeOAuthTokenManager {
     private readonly providerSettingsManager;
     private readonly telemetry?;
+    private readonly onCredentialsRefreshed?;
     private readonly refreshInFlight;
     constructor(options?: {
         providerSettingsManager?: ProviderSettingsManager;
         telemetry?: ITelemetryService;
+        onCredentialsRefreshed?: (previous: ProviderSettings, next: ProviderSettings) => void;
     });
     resolveProviderApiKey(input: {
         providerId: string;

package/dist/runtime/orchestration/session-runtime-orchestrator.d.ts

@@ -135,6 +135,8 @@ export declare class SessionRuntime {
     private activeTrackerWork;
     /** True when tracker logic has issued an abort for the active run. */
     private trackerAbortInFlight;
+    /** Why the tracker stopped the run; returned as stop control from the hooks. */
+    private trackerStopReason;
     private readonly handleExternalAbort;
     constructor(config: AgentConfig, deps?: SessionRuntimeOrchestratorDeps);
     getAgentId(): string;
@@ -203,11 +205,18 @@ export declare class SessionRuntime {
      * Idempotent: subsequent calls are no-ops once the registry has
      * been activated.
      */
+    private extensionInitialization?;
+    initializeExtensions(): Promise<void>;
     private ensureExtensionsInitialized;
     private createRuntimeHooks;
     private createRuntimePrepareTurn;
     private prepareMessagesForModelRequest;
-    private prepareProviderMessagesForApi;
+    /**
+     * Projects canonical messages into the provider-request shape: extension
+     * message builders, then `MessageBuilder.buildForApi` (tool-result
+     * truncation, repairs). Produces the `apiMessages` given to `prepareTurn`.
+     */
+    prepareProviderMessagesForApi(messages: MessageWithMetadata[]): Promise<MessageWithMetadata[]>;
     private handleRuntimeEvent;
     private syncConversationFromRuntimeMessage;
     private emitLegacyEvent;

package/dist/runtime/orchestration/session-runtime.d.ts

@@ -1,6 +1,7 @@
 import type { AgentConfig, AgentEvent, AgentHooks, AgentResult, AgentTool, BasicLogger, ITelemetryService, ModelTool, RuntimeConfigExtensionKind, ToolApprovalRequest, ToolApprovalResult } from "@cline/shared";
 import type { AgentPluginPackageMcpServer, AgentPluginPackageSkill } from "../../extensions/agent-plugin";
 import type { UserInstructionConfigService } from "../../extensions/config";
+import type { McpAppsRuntime } from "../../extensions/mcp";
 import type { RunCommandExecutionController, ToolExecutors } from "../../extensions/tools";
 import type { AgentTeamsRuntime, DelegatedAgentConfigProvider, SubAgentEndContext, SubAgentStartContext, TeamEvent } from "../../extensions/tools/team";
 import type { WorkspaceManager } from "../../services/workspace/workspace-manager";
@@ -29,6 +30,7 @@ export interface BuiltRuntime {
     extensions?: AgentConfig["extensions"];
     completionPolicy?: AgentConfig["completionPolicy"];
     registerLeadAgent?: (agent: LeadAgentHandle) => void;
+    mcpApps?: McpAppsRuntime;
     shutdown: (reason: string) => Promise<void> | void;
 }
 export interface RuntimeBuilderInput {

package/dist/runtime/tools/subprocess-sandbox.d.ts

@@ -1,4 +1,11 @@
+export interface SubprocessSandboxLauncher {
+    command: string;
+    /** Host-specific arguments placed before the bootstrap file path. */
+    argsPrefix: string[];
+}
 export interface SubprocessSandboxOptions {
+    /** A compiled host can dispatch a bootstrap with its embedded filesystem mounted. */
+    launcher?: SubprocessSandboxLauncher;
     /** Inline script to execute via `node -e`. Mutually exclusive with {@link bootstrapFile}. */
     bootstrapScript?: string;
     /** Path to a JavaScript file to execute via `node <file>`. Mutually exclusive with {@link bootstrapScript}. */
@@ -20,10 +27,24 @@ export interface SandboxCallOptions {
     timeoutMs?: number;
 }
 export declare const CLINE_JS_RUNTIME_PATH_ENV = "CLINE_JS_RUNTIME_PATH";
+/**
+ * Whether `execPath` is this process's own `bun build --compile` executable.
+ * Such a binary can still act as the plain `bun` runtime for a child process
+ * when spawned with `BUN_BE_BUN=1`, so packaged hosts (the desktop sidecar, a
+ * compiled CLI) need neither node nor bun installed on the user's machine.
+ */
+export declare function isCompiledBunExecutable(execPath: string | undefined, host?: {
+    isBunRuntime?: boolean;
+    selfExecPath?: string;
+}): boolean;
 export declare function resolveSubprocessRuntimeExecutable(options?: {
     env?: NodeJS.ProcessEnv;
     execPath?: string;
     runtimeExecutable?: string;
+    host?: {
+        isBunRuntime?: boolean;
+        selfExecPath?: string;
+    };
 }): string;
 export declare function buildSubprocessSandboxCommand(args: string[], options?: {
     env?: NodeJS.ProcessEnv;
@@ -31,6 +52,7 @@ export declare function buildSubprocessSandboxCommand(args: string[], options?:
     name?: string;
     execPath?: string;
     runtimeExecutable?: string;
+    launcher?: SubprocessSandboxLauncher;
 }): string[];
 export declare class SubprocessSandbox {
     private readonly options;

package/dist/services/cloud-handoff/git-preparation.d.ts

@@ -0,0 +1,22 @@
+export type HandoffGitPlan = {
+    id: string;
+    root: string;
+    workspaceRelativePath: string;
+    repoUrl: string;
+    remote: string;
+    branch: string;
+    sourceBranch: string;
+    headSha: string;
+    treeSha: string;
+    files: Array<{
+        path: string;
+        status: string;
+    }>;
+    commits: string[];
+};
+export type HandoffGitPreview = Pick<HandoffGitPlan, "id" | "repoUrl" | "remote" | "branch" | "sourceBranch" | "files" | "commits">;
+export type HandoffGitPublication = Omit<HandoffGitPlan, "sourceBranch" | "files" | "commits">;
+export declare function previewHandoffGit(plan: HandoffGitPlan): HandoffGitPreview;
+export declare function inspectHandoffGit(cwd: string, onCaptured?: () => void): Promise<HandoffGitPlan>;
+export declare function verifyPublishedHandoffGit(plan: HandoffGitPublication, headSha: string): Promise<void>;
+export declare function applyHandoffGit(plan: HandoffGitPublication): Promise<string>;

package/dist/services/global-settings.d.ts

@@ -26,6 +26,7 @@ export declare const GlobalSettingsSchema: z.ZodPipe<z.ZodObject<{
     }>>>;
     toolAutoApprove: z.ZodCatch<z.ZodOptional<z.ZodBoolean>>;
     tuiTheme: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+    cloudModelId: z.ZodCatch<z.ZodOptional<z.ZodString>>;
     disabledTools: z.ZodOptional<z.ZodPipe<z.ZodPreprocess<z.ZodOptional<z.ZodArray<z.ZodString>>, unknown>, z.ZodTransform<string[] | undefined, string[] | undefined>>>;
     tools: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
         web_search: "web_search";
@@ -42,6 +43,7 @@ export declare const GlobalSettingsSchema: z.ZodPipe<z.ZodObject<{
     planActMode?: GlobalPlanActMode;
     toolAutoApprove?: boolean;
     tuiTheme?: string;
+    cloudModelId?: string;
     disabledTools?: string[];
     tools?: ModelToolSettings;
     disabledPlugins?: string[];
@@ -54,6 +56,7 @@ export declare const GlobalSettingsSchema: z.ZodPipe<z.ZodObject<{
     planActMode?: "plan" | "act" | undefined;
     toolAutoApprove?: boolean | undefined;
     tuiTheme?: string | undefined;
+    cloudModelId?: string | undefined;
     disabledTools?: string[] | undefined;
     tools?: Partial<Record<"web_search", {
         enabled: boolean;
@@ -92,6 +95,9 @@ export declare function readToolAutoApproveGlobally(): boolean | undefined;
  */
 export declare function readTuiThemeGlobally(): string | undefined;
 export declare function setTuiThemeGlobally(tuiTheme: string): void;
+/** The cloud session model the user explicitly picked, if any. */
+export declare function readCloudModelIdGlobally(): string | undefined;
+export declare function setCloudModelIdGlobally(cloudModelId: string): void;
 export declare function setToolAutoApproveGlobally(toolAutoApprove: boolean): void;
 export declare function resolveDisabledToolNames(disabledToolNames?: ReadonlyArray<string>): Set<string>;
 export declare function resolveDisabledPluginPaths(disabledPluginPaths?: ReadonlyArray<string>): Set<string>;

package/dist/services/llms/cline-recommended-models.d.ts

@@ -12,6 +12,8 @@ export interface ClineRecommendedModelsData {
     recommended: ClineRecommendedModel[];
     free: ClineRecommendedModel[];
     clinePass: ClineRecommendedModel[];
+    /** Free models offered only to cloud sessions (ClineFree). */
+    clineCloud?: ClineRecommendedModel[];
 }
 type ModelsCatalog = Record<string, Record<string, ModelInfo>>;
 export interface FetchClineRecommendedModelsOptions {

package/dist/services/local-runtime-bootstrap.d.ts

@@ -61,6 +61,7 @@ export interface LocalRuntimeBootstrap {
     pluginSandboxShutdown?: () => Promise<void>;
     /** Plugins the session asked for but does not have (failed or disabled). */
     pluginIssues: SessionPluginIssue[];
+    pluginCommandError?: string;
     runtimeBuilderInput: RuntimeBuilderInput;
 }
 export declare function prepareLocalRuntimeBootstrap(options: PrepareLocalRuntimeBootstrapOptions): Promise<LocalRuntimeBootstrap>;

package/dist/services/plugin-command-api.d.ts

@@ -0,0 +1,47 @@
+import type { AgentExtensionCommand, AgentExtensionCommandResult, ITelemetryService } from "@cline/shared";
+import { type TelemetryAgentIdentityProperties } from "./telemetry/core-events";
+export interface PluginSlashCommand {
+    name: string;
+    description?: string;
+}
+export interface PluginCommandResult {
+    reply?: string;
+    submitPrompt?: string;
+}
+export interface PluginCommandTarget {
+    workspacePath: string;
+    /** Use the resident session's plugins, including their session-local state. */
+    sessionId?: string;
+}
+export interface PluginCommandCatalog extends PluginCommandTarget {
+    status: "ready" | "error";
+    commands: PluginSlashCommand[];
+    error?: string;
+}
+/**
+ * Owned by the runtime. Clients neither load plugins nor own their sandboxes.
+ * Every call checks plugin sources, so re-listing is how clients stay current.
+ */
+export interface PluginCommandsApi {
+    list(target: PluginCommandTarget): Promise<PluginCommandCatalog>;
+    run(input: PluginCommandTarget & {
+        prompt: string;
+    }): Promise<PluginCommandResult | undefined>;
+}
+export interface PluginCommandsRuntimeService {
+    readonly pluginCommands: PluginCommandsApi;
+}
+export declare function normalizePluginCommandName(name: string): string;
+export declare function parsePluginCommand(input: string): {
+    name: string;
+    input: string;
+} | undefined;
+export declare function normalizePluginCommandResult(result: AgentExtensionCommandResult | undefined): PluginCommandResult;
+export declare function listPluginCommands(commands: readonly AgentExtensionCommand[]): PluginSlashCommand[];
+export declare function executePluginCommand(commands: readonly AgentExtensionCommand[], prompt: string, context?: {
+    telemetry?: ITelemetryService;
+    sessionId?: string;
+    modelId?: string;
+    provider?: string;
+    agentIdentity?: TelemetryAgentIdentityProperties;
+}): Promise<PluginCommandResult | undefined>;

package/dist/services/plugin-commands.d.ts

@@ -1,28 +1,26 @@
-import { type BasicLogger } from "@cline/shared";
-export interface PluginSlashCommand {
-    /** Normalized token: lowercase, no leading slash. */
-    name: string;
-    description?: string;
+import { type BasicLogger, type ITelemetryService } from "@cline/shared";
+import { resolveAndLoadAgentPlugins } from "../extensions/plugin/plugin-config-loader";
+import { type PluginCommandCatalog, type PluginCommandResult, type PluginCommandTarget } from "./plugin-command-api";
+/** Runtime-owned workspace catalogs. Session execution uses the session registry instead. */
+export declare class PluginCommandManager {
+    private readonly options;
+    private readonly entries;
+    private disposed;
+    constructor(options?: {
+        logger?: BasicLogger;
+        telemetry?: ITelemetryService;
+        load?: typeof resolveAndLoadAgentPlugins;
+    });
+    list(target: PluginCommandTarget): Promise<PluginCommandCatalog>;
+    run(input: PluginCommandTarget & {
+        prompt: string;
+    }): Promise<PluginCommandResult | undefined>;
+    dispose(): Promise<void>;
+    private withEntry;
+    private release;
+    /** Fingerprint discoverable entries and their import graphs. The entry list
+     * already excludes plugins disabled in settings, so other settings do not
+     * participate. Runtime output beside a plugin is not source either. */
+    private fingerprint;
+    private refresh;
 }
-export interface PluginCommandResult {
-    reply?: string;
-    submitPrompt?: string;
-}
-/**
- * Executes plugin-registered slash commands (`api.registerCommand`) for one
- * workspace. Plugins are loaded on first use and kept alive so repeated
- * commands answer instantly; the loaded set is refreshed when plugin module
- * paths or mtimes change (installs, updates, toggles).
- */
-export interface PluginCommandService {
-    listCommands(): Promise<PluginSlashCommand[]>;
-    /** Runs `/name input`. Resolves undefined when no plugin declares `name`. */
-    run(name: string, input: string): Promise<PluginCommandResult | undefined>;
-    shutdown(): Promise<void>;
-}
-export declare function normalizePluginCommandName(name: string): string;
-export declare function createPluginCommandService(options: {
-    cwd: string;
-    workspacePath?: string;
-    logger?: BasicLogger;
-}): PluginCommandService;

package/dist/services/skills-cli.d.ts

@@ -0,0 +1,2 @@
+export declare const SKILLS_CLI_VERSION: string;
+export declare const SKILLS_CLI_PACKAGE: string;

package/dist/services/telemetry/core-events.d.ts

@@ -52,12 +52,14 @@ export declare const CORE_TELEMETRY_EVENTS: {
         readonly DIFF_EDIT_FAILED: "task.diff_edit_failed";
         readonly PROVIDER_API_ERROR: "task.provider_api_error";
         readonly MISTAKE_LIMIT_REACHED: "task.mistake_limit_reached";
+        readonly CAPABILITY_OWNER_GONE: "task.capability_owner_gone";
         readonly PROVIDER_REQUEST_STARTED: "task.provider_request_started";
         readonly PROVIDER_STREAM_STARTED: "task.provider_stream_started";
         readonly FIRST_CHUNK_RECEIVED: "task.first_chunk_received";
         readonly PROVIDER_STREAM_FAILED: "task.provider_stream_failed";
         readonly MAX_TOKENS_RECOVERY: "task.max_tokens_recovery";
         readonly CANCELLED: "task.cancelled";
+        readonly RUN_IDLE: "task.run_idle";
         readonly MENTION_USED: "task.mention_used";
         readonly MENTION_FAILED: "task.mention_failed";
         readonly MENTION_SEARCH_RESULTS: "task.mention_search_results";
@@ -334,6 +336,30 @@ export declare function captureMistakeLimitReached(telemetry: ITelemetryService
     consecutiveMistakes: number;
     maxConsecutiveMistakes: number;
 } & Partial<TelemetryAgentIdentityProperties>): void;
+/**
+ * Records when a run's hook, client tool, or other client callback fails
+ * because the app that owns it disconnected or left the task.
+ */
+export declare function captureCapabilityOwnerGone(telemetry: ITelemetryService | undefined, properties: {
+    sessionId: string;
+    capabilityName: string;
+    /** disconnected / detached: failed before asking; cancelled_while_waiting: the app left mid-request. */
+    reason: "disconnected" | "detached" | "cancelled_while_waiting";
+}): void;
+/**
+ * At most once per agent run, while it is still running and has emitted no
+ * runtime event (stream deltas included) for `idleMs`. Sent while stuck so
+ * hangs the user escapes by quitting the app are still counted.
+ */
+export declare function captureRunIdle(telemetry: ITelemetryService | undefined, properties: {
+    ulid?: string;
+    agentId: string;
+    runId: string;
+    idleMs: number;
+    /** Runtime event type that preceded the silence. */
+    lastEventType: string;
+    isSubagent: boolean;
+}): void;
 export declare function captureRunCommandsTimeout(telemetry: ITelemetryService | undefined, properties: RunCommandsTimeoutTelemetryProperties): void;
 export interface PlanModeCommandBlockedTelemetryProperties {
     tool_name: "run_commands";

package/dist/services/telemetry/index.js

@@ -1 +1 @@
-import{existsSync as F,mkdirSync as H,readFileSync as V,writeFileSync as B}from"node:fs";import{resolve as z}from"node:path";import{resolveSessionDataDir as j}from"@cline/shared/storage";import{nanoid as W}from"nanoid";import*as q from"node-machine-id";var Y="machine-id",O,C=!1;function v(){if(!C)O=x(),C=!0;return O??R()}function f(e){let t=e?.trim();if(t)return t;let r=x();if(r)return r;return R()}function X(){let e=q;return e.machineIdSync??e.default?.machineIdSync}function x(){try{let e=X();if(!e)return;return e().trim()||void 0}catch{return}}function R(){let e=j(),t=z(e,Y);try{if(F(t)){let i=V(t,"utf8").trim();if(i.length>0)return i}}catch{}let r=`cl-${W()}`;try{H(e,{recursive:!0}),B(t,r,"utf8")}catch{}return r}import{SeverityNumber as g}from"@opentelemetry/api-logs";class y{name;metadata;meter;logger;enabled;distinctId;commonProperties;counters=new Map;histograms=new Map;gauges=new Map;gaugeValues=new Map;meterProvider;loggerProvider;constructor(e){this.name=e.name??"OpenTelemetryAdapter",this.metadata={...e.metadata},this.meterProvider=e.meterProvider,this.loggerProvider=e.loggerProvider,this.meter=e.meterProvider?.getMeter("cline")??null,this.logger=e.loggerProvider?.getLogger("cline")??null,this.enabled=e.enabled??!0,this.distinctId=e.distinctId,this.commonProperties=e.commonProperties?{...e.commonProperties}:{}}emit(e,t){if(!this.isEnabled())return;this.emitLog(e,t,!1)}emitRequired(e,t){this.emitLog(e,t,!0)}recordCounter(e,t,r,i,o=!1){if(!this.meter||!o&&!this.isEnabled())return;let s=this.counters.get(e);if(!s)s=this.meter.createCounter(e,i?{description:i}:void 0),this.counters.set(e,s);s.add(t,this.flattenProperties(this.buildAttributes(r)))}recordHistogram(e,t,r,i,o=!1){if(!this.meter||!o&&!this.isEnabled())return;let s=this.histograms.get(e);if(!s)s=this.meter.createHistogram(e,i?{description:i}:void 0),this.histograms.set(e,s);s.record(t,this.flattenProperties(this.buildAttributes(r)))}recordGauge(e,t,r,i,o=!1){if(!this.meter||!o&&!this.isEnabled())return;let s=this.buildAttributes(r),n=JSON.stringify(s),d=this.gaugeValues.get(e);if(t===null){if(d){if(d.delete(n),d.size===0)this.gaugeValues.delete(e),this.gauges.delete(e)}return}let a=d;if(!a)a=new Map,this.gaugeValues.set(e,a);if(!this.gauges.has(e)){let l=this.meter.createObservableGauge(e,i?{description:i}:void 0);l.addCallback((m)=>{for(let A of this.snapshotGaugeSeries(e))m.observe(A.value,this.flattenProperties(A.attributes))}),this.gauges.set(e,l)}a.set(n,{value:t,attributes:s})}isEnabled(){return typeof this.enabled==="function"?this.enabled():this.enabled}setDistinctId(e){this.distinctId=e}setCommonProperties(e){this.commonProperties={...e}}updateCommonProperties(e){this.commonProperties={...this.commonProperties,...e}}async flush(){await Promise.all([this.meterProvider?.forceFlush?.(),this.loggerProvider?.forceFlush?.()])}async dispose(){await Promise.all([this.meterProvider?.shutdown?.(),this.loggerProvider?.shutdown?.()])}emitLog(e,t,r){if(!this.logger)return;let i=this.flattenProperties(this.buildAttributes(t,r)),o=J(i.severity);this.logger.emit({severityText:o.text,severityNumber:o.number,body:e,attributes:i})}buildAttributes(e,t=!1){return{...this.commonProperties,...this.metadata,...e,...this.distinctId?{distinct_id:this.distinctId}:{},...t?{_required:!0}:{}}}snapshotGaugeSeries(e){let t=this.gaugeValues.get(e);if(!t)return[];return Array.from(t.values(),(r)=>({value:r.value,attributes:r.attributes?{...r.attributes}:void 0}))}flattenProperties(e,t="",r=new WeakSet,i=0){if(!e)return{};let o={},s=100,n=10;for(let[d,a]of Object.entries(e)){if(d==="__proto__"||d==="constructor"||d==="prototype")continue;let l=t?`${t}.${d}`:d;if(a===null||a===void 0){o[l]=String(a);continue}if(Array.isArray(a)){let m=a.length>s?a.slice(0,s):a;try{o[l]=JSON.stringify(m)}catch{o[l]="[UnserializableArray]"}if(a.length>s)o[`${l}_truncated`]=!0,o[`${l}_original_length`]=a.length;continue}if(typeof a==="object"){if(a instanceof Date){o[l]=a.toISOString();continue}if(a instanceof Error){o[l]=a.message;continue}if(r.has(a)){o[l]="[Circular]";continue}if(i>=n){o[l]="[MaxDepthExceeded]";continue}r.add(a),Object.assign(o,this.flattenProperties(a,l,r,i+1));continue}if(Q(a)){o[l]=a;continue}try{o[l]=JSON.stringify(a)}catch{o[l]=String(a)}}return o}}function J(e){switch(typeof e==="string"?e.toLowerCase():e){case"trace":return{text:"TRACE",number:g.TRACE};case"debug":return{text:"DEBUG",number:g.DEBUG};case"warn":case"warning":return{text:"WARN",number:g.WARN};case"error":return{text:"ERROR",number:g.ERROR};case"fatal":return{text:"FATAL",number:g.FATAL};default:return{text:"INFO",number:g.INFO}}}function Q(e){return typeof e==="string"||typeof e==="number"||typeof e==="boolean"}import{LangfuseAttributesSpanProcessor as ce}from"@cline/llms";import{markOtlpTraceRelayProvider as ue}from"@cline/shared";import{metrics as me,trace as pe}from"@opentelemetry/api";import{logs as ge}from"@opentelemetry/api-logs";import{OTLPLogExporter as fe}from"@opentelemetry/exporter-logs-otlp-http";import{OTLPMetricExporter as ye}from"@opentelemetry/exporter-metrics-otlp-http";import{OTLPTraceExporter as Te}from"@opentelemetry/exporter-trace-otlp-http";import{resourceFromAttributes as Se}from"@opentelemetry/resources";import{BatchLogRecordProcessor as ve,ConsoleLogRecordExporter as be,LoggerProvider as Ee}from"@opentelemetry/sdk-logs";import{ConsoleMetricExporter as he,MeterProvider as Pe,PeriodicExportingMetricReader as N}from"@opentelemetry/sdk-metrics";import{BatchSpanProcessor as _e,ConsoleSpanExporter as Ie,SimpleSpanProcessor as Ae}from"@opentelemetry/sdk-trace-base";import{NodeTracerProvider as Oe}from"@opentelemetry/sdk-trace-node";import{ATTR_SERVICE_NAME as Ce,ATTR_SERVICE_VERSION as xe}from"@opentelemetry/semantic-conventions";import{mkdirSync as rt,readFileSync as Z,statSync as ee,writeFileSync as it}from"node:fs";import{CONFIGURABLE_MODEL_TOOL_NAMES as te}from"@cline/shared";import{resolveGlobalSettingsPath as re}from"@cline/shared/storage";import{z as c}from"zod";import{AGENT_UNEXPECTED_REASONING_TOKENS_EVENT as Be,captureAgentUnexpectedReasoningTokens as ze,captureTaskLifecycleEvent as je,SDK_ERROR_TELEMETRY_EVENT as We,TASK_CANCELLED_EVENT as qe,TASK_FIRST_CHUNK_RECEIVED_EVENT as Ye,TASK_MAX_TOKENS_RECOVERY_EVENT as Xe,TASK_PROVIDER_REQUEST_STARTED_EVENT as $e,TASK_PROVIDER_STREAM_FAILED_EVENT as Je,TASK_PROVIDER_STREAM_STARTED_EVENT as Qe}from"@cline/shared";var b=c.preprocess((e)=>Array.isArray(e)?e.filter((t)=>typeof t==="string").map((t)=>t.trim()).filter(Boolean):void 0,c.array(c.string()).optional()).transform((e)=>{if(!e)return;let t=[...new Set(e)].sort((r,i)=>r.localeCompare(i));return t.length>0?t:void 0}),ie=c.enum(["basic","agentic"]).catch("agentic"),oe=c.partialRecord(c.enum(te),c.object({enabled:c.boolean()}).strip()).optional(),ne=c.enum(["plan","act"]),M=c.object({telemetryOptOut:c.boolean().default(!1).catch(!1),autoUpdateEnabled:c.boolean().default(!0).catch(!0),compactionStrategy:ie.optional(),compactionEnabled:c.boolean().optional().catch(void 0),planActMode:ne.optional().catch(void 0),toolAutoApprove:c.boolean().optional().catch(void 0),tuiTheme:c.string().optional().catch(void 0),disabledTools:b.optional(),tools:oe,disabledPlugins:b.optional(),disabledAgentPlugins:b.optional()}).strip().transform((e)=>{let t={autoUpdateEnabled:e.autoUpdateEnabled,telemetryOptOut:e.telemetryOptOut};if(e.compactionStrategy)t.compactionStrategy=e.compactionStrategy;if(e.compactionEnabled!==void 0)t.compactionEnabled=e.compactionEnabled;if(e.planActMode)t.planActMode=e.planActMode;if(e.toolAutoApprove!==void 0)t.toolAutoApprove=e.toolAutoApprove;if(e.tuiTheme?.trim())t.tuiTheme=e.tuiTheme.trim();if(e.disabledTools?.length)t.disabledTools=e.disabledTools;if(e.tools&&Object.keys(e.tools).length>0)t.tools=e.tools;if(e.disabledPlugins?.length)t.disabledPlugins=e.disabledPlugins;if(e.disabledAgentPlugins?.length)t.disabledAgentPlugins=e.disabledAgentPlugins;return t});function T(){return M.parse({})}var E;function se(e){if(e.disabledTools)Object.freeze(e.disabledTools);if(e.tools){for(let t of Object.values(e.tools))Object.freeze(t);Object.freeze(e.tools)}if(e.disabledPlugins)Object.freeze(e.disabledPlugins);if(e.disabledAgentPlugins)Object.freeze(e.disabledAgentPlugins);return Object.freeze(e)}function ae(e){let t;try{t=Z(e,"utf8")}catch{return{value:T(),loadFailed:!0}}try{let r=M.safeParse(JSON.parse(t));return r.success?{value:r.data,loadFailed:!1}:{value:T(),loadFailed:!0}}catch{return{value:T(),loadFailed:!0}}}function de(){let e=re(),t=ee(e,{throwIfNoEntry:!1}),r=t?.mtimeMs??0,i=t?.size??0,o=E;if(o&&o.path===e&&o.mtimeMs===r&&o.size===i)return o;let s=t?ae(e):{value:T(),loadFailed:!1},n=se(s.value);return E={path:e,mtimeMs:r,size:i,value:n,loadFailed:s.loadFailed},E}function le(){return de().value}function D(){return le().telemetryOptOut}class h{name;logger;enabled;constructor(e={}){this.name=e.name??"TelemetryLoggerSink",this.logger=e.logger,this.enabled=e.enabled??!0}emit(e,t){if(!this.isEnabled())return;this.logger?.log("telemetry.event",{telemetrySink:this.name,event:e,properties:t})}emitRequired(e,t){this.logger?.log("telemetry.required_event",{telemetrySink:this.name,severity:"warn",event:e,properties:t})}recordCounter(e,t,r,i,o){if(!o&&!this.isEnabled())return;this.logger?.debug("telemetry.metric",{telemetrySink:this.name,instrument:"counter",name:e,value:t,attributes:r,description:i,required:o===!0})}recordHistogram(e,t,r,i,o){if(!o&&!this.isEnabled())return;this.logger?.debug("telemetry.metric",{telemetrySink:this.name,instrument:"histogram",name:e,value:t,attributes:r,description:i,required:o===!0})}recordGauge(e,t,r,i,o){if(!o&&!this.isEnabled())return;this.logger?.debug("telemetry.metric",{telemetrySink:this.name,instrument:"gauge",name:e,value:t,attributes:r,description:i,required:o===!0})}isEnabled(){return typeof this.enabled==="function"?this.enabled():this.enabled}async flush(){}async dispose(){}}class S{adapters;metadata;distinctId;deviceId;commonProperties;constructor(e={}){if(this.adapters=[...e.adapters??[]],e.logger)this.adapters.push(new h({logger:e.logger}));this.metadata={...e.metadata??{}},this.distinctId=e.distinctId,this.deviceId=e.deviceId??v(),this.commonProperties={...e.commonProperties??{}}}addAdapter(e){this.adapters.push(e)}setDistinctId(e){this.distinctId=e}setMetadata(e){this.metadata={...e}}updateMetadata(e){this.metadata={...this.metadata,...e}}setCommonProperties(e){this.commonProperties={...e}}updateCommonProperties(e){this.commonProperties={...this.commonProperties,...e}}isEnabled(){return this.adapters.some((e)=>e.isEnabled())}capture(e){let t=this.buildAttributes(e.properties);for(let r of this.adapters)r.emit(e.event,t)}captureRequired(e,t){let r=this.buildAttributes(t);for(let i of this.adapters)i.emitRequired(e,r)}recordCounter(e,t,r,i,o=!1){let s=this.buildAttributes(r);for(let n of this.adapters)n.recordCounter(e,t,s,i,o)}recordHistogram(e,t,r,i,o=!1){let s=this.buildAttributes(r);for(let n of this.adapters)n.recordHistogram(e,t,s,i,o)}recordGauge(e,t,r,i,o=!1){let s=this.buildAttributes(r);for(let n of this.adapters)n.recordGauge(e,t,s,i,o)}async flush(){await Promise.all(this.adapters.map((e)=>e.flush()))}async dispose(){await Promise.all(this.adapters.map((e)=>e.dispose()))}buildAttributes(e){let t=typeof e?.distinct_id==="string"&&e.distinct_id.trim()?e.distinct_id.trim():this.distinctId,r={...this.commonProperties,...this.metadata,...e,...t?{distinct_id:t}:{},device_id:this.deviceId};return Object.fromEntries(Object.entries(r).filter(([,i])=>i!==void 0))}}class k{distinctId;metadata;commonProperties;constructor(e={}){this.distinctId=e.distinctId,this.metadata={...e.metadata??{}},this.commonProperties={...e.commonProperties??{}}}setDistinctId(e){this.distinctId=e}setMetadata(e){this.metadata={...e}}updateMetadata(e){this.metadata={...this.metadata,...e}}setCommonProperties(e){this.commonProperties={...e}}updateCommonProperties(e){this.commonProperties={...this.commonProperties,...e}}isEnabled(){return!1}capture(e){this.resolveProperties(e.properties)}captureRequired(e,t){this.resolveProperties(t)}recordCounter(){}recordHistogram(){}recordGauge(){}async flush(){}async dispose(){}resolveProperties(e){let t=typeof e?.distinct_id==="string"&&e.distinct_id.trim()?e.distinct_id.trim():this.distinctId,r={...this.commonProperties,...this.metadata,...e,...t?{distinct_id:t}:{}};return Object.fromEntries(Object.entries(r).filter(([,i])=>i!==void 0))}}class _{meterProvider;loggerProvider;tracerProvider;options;constructor(e={}){this.options=e;let t=Se({...e.resourceAttributes,[Ce]:e.serviceName??"cline",...e.serviceVersion?{[xe]:e.serviceVersion}:{}});if(this.meterProvider=this.createMeterProvider(t),this.loggerProvider=this.createLoggerProvider(t),this.tracerProvider=this.createTracerProvider(t),this.meterProvider)me.setGlobalMeterProvider(this.meterProvider);if(this.loggerProvider)ge.setGlobalLoggerProvider(this.loggerProvider);if(this.tracerProvider)this.tracerProvider.register()}getTracer(e="cline",t){return pe.getTracer(e,t??this.options.serviceVersion)}createAdapter(e){return new y({...e,meterProvider:this.meterProvider,loggerProvider:this.loggerProvider})}createTelemetryService(e){let t=this.createAdapter({name:e.name,enabled:this.options.enabled,metadata:e.metadata});return new S({...e,adapters:[t],distinctId:f(e.distinctId)})}async forceFlush(){await Promise.all([this.meterProvider?.forceFlush?.(),this.loggerProvider?.forceFlush?.(),this.tracerProvider?.forceFlush?.()])}async dispose(){await Promise.all([this.meterProvider?.shutdown?.(),this.loggerProvider?.shutdown?.(),this.tracerProvider?.shutdown?.()])}createMeterProvider(e){let t=P(this.options.metricsExporter);if(t.length===0)return null;let r=Math.max(1000,this.options.metricExportIntervalMs??this.options.metricExportInterval??60000),i=Math.min(30000,Math.floor(r*0.8)),o=t.map((s)=>Ne(s,{endpoint:this.options.otlpEndpoint,headers:this.options.otlpHeaders,insecure:this.options.otlpInsecure??!1,protocol:"http/json",interval:r,timeout:i})).filter((s)=>s!==null);if(o.length===0)return null;return new Pe({resource:e,readers:o})}createTracerProvider(e){let t=P(this.options.tracesExporter);if(t.length===0)return null;let r=this.options.otlpTracesEndpoint??this.options.otlpEndpoint,i=this.options.otlpTracesHeaders??this.options.otlpHeaders,o=[],s=!1;for(let d of t){let a=De(d,{endpoint:r,headers:i,insecure:this.options.otlpInsecure??!1,protocol:"http/json"});if(a){if(o.push(a),d!=="console")s=!0}}if(o.length===0)return null;let n=new Oe({resource:e,spanProcessors:s?[new ce,...o]:o});if(s)ue(n);return n}createLoggerProvider(e){let t=P(this.options.logsExporter);if(t.length===0)return null;let r=t.map((i)=>{let o=Me(i,{endpoint:this.options.otlpEndpoint,headers:this.options.otlpHeaders,insecure:this.options.otlpInsecure??!1,protocol:"http/json"});if(!o)return null;return new ve(o,{maxQueueSize:this.options.logMaxQueueSize??2048,maxExportBatchSize:this.options.logBatchSize??512,scheduledDelayMillis:this.options.logBatchTimeoutMs??this.options.logBatchTimeout??5000})}).filter((i)=>i!==null);if(r.length===0)return null;return new Ee({resource:e,processors:r})}}function L(e){let t=new _(e),r=t.createTelemetryService(e),i=()=>{r.captureRequired("telemetry.provider_created",{provider:"opentelemetry",enabled:e.enabled??!0,logsExporter:Array.isArray(e.logsExporter)?e.logsExporter.join(","):e.logsExporter,metricsExporter:Array.isArray(e.metricsExporter)?e.metricsExporter.join(","):e.metricsExporter,tracesExporter:Array.isArray(e.tracesExporter)?e.tracesExporter.join(","):e.tracesExporter,otlpProtocol:e.otlpProtocol,hasOtlpEndpoint:Boolean(e.otlpEndpoint),serviceName:e.serviceName,serviceVersion:e.serviceVersion})};if(!e.deferProviderCreatedEvent)i();return{provider:t,telemetry:r,emitProviderCreated:i}}function w(e){if(D())return{telemetry:new k(e)};if(e.enabled!==!0)return{telemetry:new S({...e,distinctId:f(e.distinctId)})};return L(e)}function Re(e){let{telemetry:t,provider:r,emitProviderCreated:i}=w(e);return{telemetry:t,provider:r,flush:async()=>{let n=r;if(n&&typeof n.forceFlush==="function")try{await n.forceFlush()}catch{}},dispose:async()=>{await Promise.allSettled([t.dispose(),r?.dispose()])},...e.deferProviderCreatedEvent&&i?{emitProviderCreated:i}:{}}}function P(e){if(!e)return[];return(Array.isArray(e)?e:e.split(",")).map((r)=>r.trim()).filter((r)=>r==="console"||r==="otlp")}function Me(e,t){if(e==="console")return new be;if(!t.endpoint)return null;let r=I(t.endpoint,"/v1/logs");return new fe({url:r,headers:t.headers})}function De(e,t){if(e==="console")return new Ae(new Ie);if(!t.endpoint)return null;let r=I(t.endpoint,"/v1/traces");return new _e(new Te({url:r,headers:t.headers}))}function Ne(e,t){if(e==="console")return new N({exporter:new he,exportIntervalMillis:t.interval,exportTimeoutMillis:t.timeout});if(!t.endpoint)return null;let r=I(t.endpoint,"/v1/metrics");return new N({exporter:new ye({url:r,headers:t.headers}),exportIntervalMillis:t.interval,exportTimeoutMillis:t.timeout})}function I(e,t){let r=new URL(e),i=r.pathname.endsWith("/")?r.pathname.slice(0,-1):r.pathname;return r.pathname=i.endsWith(t)?i:`${i}${t}`,r.toString()}import{SESSION_STATUS_VALUES as Dt}from"@cline/shared";var p={CORE:"core",CLI:"cli",SUBAGENT:"subagent",DESKTOP:"desktop",KANBAN:"kanban",API:"api",WEB:"web",VSCODE:"vscode",ENTERPRISE:"enterprise",IDE:"ide",JETBRAINS:"jetbrains",NEOVIM:"neovim",UNKNOWN:"unknown"};function G(e){let t=[e?.name,e?.platform].filter((r)=>typeof r==="string").join(" ").toLowerCase();if(!t)return;if(t.includes("vscode")||t.includes("visual studio code"))return p.VSCODE;if(t.includes("jetbrains")||t.includes("webstorm")||t.includes("intellij")||t.includes("pycharm")||t.includes("goland")||t.includes("clion")||t.includes("rider")||t.includes("android studio"))return p.JETBRAINS;if(t.includes("neovim"))return p.NEOVIM;if(t.includes("kanban"))return p.KANBAN;if(t.includes("desktop"))return p.DESKTOP;if(t.includes("cline-platform"))return p.WEB;if(t.includes("cline-cli")||t.includes("cline-acp"))return p.CLI;if(t.includes("cline-sdk")||t.includes("cline-core"))return p.CORE;return}function u(e){let t=e?.trim();return t?t:void 0}function U(e){let t=e.client,r=G(t)??u(e.source),i=u(t.version),o=u(t.platform)??u(t.name),s=u(t.platformVersion)??i,n={cline_type:r,extension_version:i,platform:o,platform_version:s};if(e.user?.accountId===void 0)return n;let d=typeof e.user.accountId==="string"?u(e.user.accountId):void 0;return{...n,distinct_id:d??u(e.user.distinctId),user_id:d,account_id:d,account_email:d?u(e.user.email):void 0,organization_id:d?u(e.user.organizationId):void 0}}function K(e,t){let r={},i={},o,s=(n)=>({...t,...i,...r,...n,...o?{distinct_id:o}:{}});return{setDistinctId(n){o=u(n)},setMetadata(n){r={...n}},updateMetadata(n){r={...r,...n}},setCommonProperties(n){i={...n}},updateCommonProperties(n){i={...i,...n}},isEnabled:()=>e.isEnabled(),capture:(n)=>e.capture({event:n.event,properties:s(n.properties)}),captureRequired:(n,d)=>e.captureRequired(n,s(d)),recordCounter:(n,d,a,l,m)=>e.recordCounter(n,d,s(a),l,m),recordHistogram:(n,d,a,l,m)=>e.recordHistogram(n,d,s(a),l,m),recordGauge:(n,d,a,l,m)=>e.recordGauge(n,d,s(a),l,m),flush:()=>e.flush(),dispose:async()=>{}}}function ke(e,t){return K(e,U(t))}export{y as OpenTelemetryAdapter,_ as OpenTelemetryProvider,ke as createClientScopedTelemetryService,Re as createConfiguredTelemetryHandle,w as createConfiguredTelemetryService,L as createOpenTelemetryTelemetryService,K as createScopedTelemetryService,U as resolveClientTelemetryProperties,v as resolveCoreDeviceId,f as resolveCoreDistinctId};
+import{existsSync as F,mkdirSync as H,readFileSync as V,writeFileSync as B}from"node:fs";import{resolve as z}from"node:path";import{resolveSessionDataDir as j}from"@cline/shared/storage";import{nanoid as W}from"nanoid";import*as q from"node-machine-id";var Y="machine-id",O,C=!1;function v(){if(!C)O=R(),C=!0;return O??x()}function f(e){let t=e?.trim();if(t)return t;let r=R();if(r)return r;return x()}function X(){let e=q;return e.machineIdSync??e.default?.machineIdSync}function R(){try{let e=X();if(!e)return;return e().trim()||void 0}catch{return}}function x(){let e=j(),t=z(e,Y);try{if(F(t)){let i=V(t,"utf8").trim();if(i.length>0)return i}}catch{}let r=`cl-${W()}`;try{H(e,{recursive:!0}),B(t,r,"utf8")}catch{}return r}import{SeverityNumber as g}from"@opentelemetry/api-logs";class y{name;metadata;meter;logger;enabled;distinctId;commonProperties;counters=new Map;histograms=new Map;gauges=new Map;gaugeValues=new Map;meterProvider;loggerProvider;constructor(e){this.name=e.name??"OpenTelemetryAdapter",this.metadata={...e.metadata},this.meterProvider=e.meterProvider,this.loggerProvider=e.loggerProvider,this.meter=e.meterProvider?.getMeter("cline")??null,this.logger=e.loggerProvider?.getLogger("cline")??null,this.enabled=e.enabled??!0,this.distinctId=e.distinctId,this.commonProperties=e.commonProperties?{...e.commonProperties}:{}}emit(e,t){if(!this.isEnabled())return;this.emitLog(e,t,!1)}emitRequired(e,t){this.emitLog(e,t,!0)}recordCounter(e,t,r,i,o=!1){if(!this.meter||!o&&!this.isEnabled())return;let s=this.counters.get(e);if(!s)s=this.meter.createCounter(e,i?{description:i}:void 0),this.counters.set(e,s);s.add(t,this.flattenProperties(this.buildAttributes(r)))}recordHistogram(e,t,r,i,o=!1){if(!this.meter||!o&&!this.isEnabled())return;let s=this.histograms.get(e);if(!s)s=this.meter.createHistogram(e,i?{description:i}:void 0),this.histograms.set(e,s);s.record(t,this.flattenProperties(this.buildAttributes(r)))}recordGauge(e,t,r,i,o=!1){if(!this.meter||!o&&!this.isEnabled())return;let s=this.buildAttributes(r),n=JSON.stringify(s),d=this.gaugeValues.get(e);if(t===null){if(d){if(d.delete(n),d.size===0)this.gaugeValues.delete(e),this.gauges.delete(e)}return}let a=d;if(!a)a=new Map,this.gaugeValues.set(e,a);if(!this.gauges.has(e)){let l=this.meter.createObservableGauge(e,i?{description:i}:void 0);l.addCallback((m)=>{for(let A of this.snapshotGaugeSeries(e))m.observe(A.value,this.flattenProperties(A.attributes))}),this.gauges.set(e,l)}a.set(n,{value:t,attributes:s})}isEnabled(){return typeof this.enabled==="function"?this.enabled():this.enabled}setDistinctId(e){this.distinctId=e}setCommonProperties(e){this.commonProperties={...e}}updateCommonProperties(e){this.commonProperties={...this.commonProperties,...e}}async flush(){await Promise.all([this.meterProvider?.forceFlush?.(),this.loggerProvider?.forceFlush?.()])}async dispose(){await Promise.all([this.meterProvider?.shutdown?.(),this.loggerProvider?.shutdown?.()])}emitLog(e,t,r){if(!this.logger)return;let i=this.flattenProperties(this.buildAttributes(t,r)),o=J(i.severity);this.logger.emit({severityText:o.text,severityNumber:o.number,body:e,attributes:i})}buildAttributes(e,t=!1){return{...this.commonProperties,...this.metadata,...e,...this.distinctId?{distinct_id:this.distinctId}:{},...t?{_required:!0}:{}}}snapshotGaugeSeries(e){let t=this.gaugeValues.get(e);if(!t)return[];return Array.from(t.values(),(r)=>({value:r.value,attributes:r.attributes?{...r.attributes}:void 0}))}flattenProperties(e,t="",r=new WeakSet,i=0){if(!e)return{};let o={},s=100,n=10;for(let[d,a]of Object.entries(e)){if(d==="__proto__"||d==="constructor"||d==="prototype")continue;let l=t?`${t}.${d}`:d;if(a===null||a===void 0){o[l]=String(a);continue}if(Array.isArray(a)){let m=a.length>s?a.slice(0,s):a;try{o[l]=JSON.stringify(m)}catch{o[l]="[UnserializableArray]"}if(a.length>s)o[`${l}_truncated`]=!0,o[`${l}_original_length`]=a.length;continue}if(typeof a==="object"){if(a instanceof Date){o[l]=a.toISOString();continue}if(a instanceof Error){o[l]=a.message;continue}if(r.has(a)){o[l]="[Circular]";continue}if(i>=n){o[l]="[MaxDepthExceeded]";continue}r.add(a),Object.assign(o,this.flattenProperties(a,l,r,i+1));continue}if(Q(a)){o[l]=a;continue}try{o[l]=JSON.stringify(a)}catch{o[l]=String(a)}}return o}}function J(e){switch(typeof e==="string"?e.toLowerCase():e){case"trace":return{text:"TRACE",number:g.TRACE};case"debug":return{text:"DEBUG",number:g.DEBUG};case"warn":case"warning":return{text:"WARN",number:g.WARN};case"error":return{text:"ERROR",number:g.ERROR};case"fatal":return{text:"FATAL",number:g.FATAL};default:return{text:"INFO",number:g.INFO}}}function Q(e){return typeof e==="string"||typeof e==="number"||typeof e==="boolean"}import{LangfuseAttributesSpanProcessor as ce}from"@cline/llms";import{markOtlpTraceRelayProvider as ue}from"@cline/shared";import{metrics as me,trace as pe}from"@opentelemetry/api";import{logs as ge}from"@opentelemetry/api-logs";import{OTLPLogExporter as fe}from"@opentelemetry/exporter-logs-otlp-http";import{OTLPMetricExporter as ye}from"@opentelemetry/exporter-metrics-otlp-http";import{OTLPTraceExporter as Te}from"@opentelemetry/exporter-trace-otlp-http";import{resourceFromAttributes as Se}from"@opentelemetry/resources";import{BatchLogRecordProcessor as ve,ConsoleLogRecordExporter as be,LoggerProvider as Ee}from"@opentelemetry/sdk-logs";import{ConsoleMetricExporter as he,MeterProvider as Pe,PeriodicExportingMetricReader as N}from"@opentelemetry/sdk-metrics";import{BatchSpanProcessor as _e,ConsoleSpanExporter as Ie,SimpleSpanProcessor as Ae}from"@opentelemetry/sdk-trace-base";import{NodeTracerProvider as Oe}from"@opentelemetry/sdk-trace-node";import{ATTR_SERVICE_NAME as Ce,ATTR_SERVICE_VERSION as Re}from"@opentelemetry/semantic-conventions";import{mkdirSync as rt,readFileSync as Z,statSync as ee,writeFileSync as it}from"node:fs";import{CONFIGURABLE_MODEL_TOOL_NAMES as te}from"@cline/shared";import{resolveGlobalSettingsPath as re}from"@cline/shared/storage";import{z as c}from"zod";import{AGENT_UNEXPECTED_REASONING_TOKENS_EVENT as Be,captureAgentUnexpectedReasoningTokens as ze,captureTaskLifecycleEvent as je,SDK_ERROR_TELEMETRY_EVENT as We,TASK_CANCELLED_EVENT as qe,TASK_FIRST_CHUNK_RECEIVED_EVENT as Ye,TASK_MAX_TOKENS_RECOVERY_EVENT as Xe,TASK_PROVIDER_REQUEST_STARTED_EVENT as $e,TASK_PROVIDER_STREAM_FAILED_EVENT as Je,TASK_PROVIDER_STREAM_STARTED_EVENT as Qe}from"@cline/shared";var b=c.preprocess((e)=>Array.isArray(e)?e.filter((t)=>typeof t==="string").map((t)=>t.trim()).filter(Boolean):void 0,c.array(c.string()).optional()).transform((e)=>{if(!e)return;let t=[...new Set(e)].sort((r,i)=>r.localeCompare(i));return t.length>0?t:void 0}),ie=c.enum(["basic","agentic"]).catch("agentic"),oe=c.partialRecord(c.enum(te),c.object({enabled:c.boolean()}).strip()).optional(),ne=c.enum(["plan","act"]),M=c.object({telemetryOptOut:c.boolean().default(!1).catch(!1),autoUpdateEnabled:c.boolean().default(!0).catch(!0),compactionStrategy:ie.optional(),compactionEnabled:c.boolean().optional().catch(void 0),planActMode:ne.optional().catch(void 0),toolAutoApprove:c.boolean().optional().catch(void 0),tuiTheme:c.string().optional().catch(void 0),cloudModelId:c.string().optional().catch(void 0),disabledTools:b.optional(),tools:oe,disabledPlugins:b.optional(),disabledAgentPlugins:b.optional()}).strip().transform((e)=>{let t={autoUpdateEnabled:e.autoUpdateEnabled,telemetryOptOut:e.telemetryOptOut};if(e.compactionStrategy)t.compactionStrategy=e.compactionStrategy;if(e.compactionEnabled!==void 0)t.compactionEnabled=e.compactionEnabled;if(e.planActMode)t.planActMode=e.planActMode;if(e.toolAutoApprove!==void 0)t.toolAutoApprove=e.toolAutoApprove;if(e.tuiTheme?.trim())t.tuiTheme=e.tuiTheme.trim();if(e.cloudModelId?.trim())t.cloudModelId=e.cloudModelId.trim();if(e.disabledTools?.length)t.disabledTools=e.disabledTools;if(e.tools&&Object.keys(e.tools).length>0)t.tools=e.tools;if(e.disabledPlugins?.length)t.disabledPlugins=e.disabledPlugins;if(e.disabledAgentPlugins?.length)t.disabledAgentPlugins=e.disabledAgentPlugins;return t});function T(){return M.parse({})}var E;function se(e){if(e.disabledTools)Object.freeze(e.disabledTools);if(e.tools){for(let t of Object.values(e.tools))Object.freeze(t);Object.freeze(e.tools)}if(e.disabledPlugins)Object.freeze(e.disabledPlugins);if(e.disabledAgentPlugins)Object.freeze(e.disabledAgentPlugins);return Object.freeze(e)}function ae(e){let t;try{t=Z(e,"utf8")}catch{return{value:T(),loadFailed:!0}}try{let r=M.safeParse(JSON.parse(t));return r.success?{value:r.data,loadFailed:!1}:{value:T(),loadFailed:!0}}catch{return{value:T(),loadFailed:!0}}}function de(){let e=re(),t=ee(e,{throwIfNoEntry:!1}),r=t?.mtimeMs??0,i=t?.size??0,o=E;if(o&&o.path===e&&o.mtimeMs===r&&o.size===i)return o;let s=t?ae(e):{value:T(),loadFailed:!1},n=se(s.value);return E={path:e,mtimeMs:r,size:i,value:n,loadFailed:s.loadFailed},E}function le(){return de().value}function D(){return le().telemetryOptOut}class h{name;logger;enabled;constructor(e={}){this.name=e.name??"TelemetryLoggerSink",this.logger=e.logger,this.enabled=e.enabled??!0}emit(e,t){if(!this.isEnabled())return;this.logger?.log("telemetry.event",{telemetrySink:this.name,event:e,properties:t})}emitRequired(e,t){this.logger?.log("telemetry.required_event",{telemetrySink:this.name,severity:"warn",event:e,properties:t})}recordCounter(e,t,r,i,o){if(!o&&!this.isEnabled())return;this.logger?.debug("telemetry.metric",{telemetrySink:this.name,instrument:"counter",name:e,value:t,attributes:r,description:i,required:o===!0})}recordHistogram(e,t,r,i,o){if(!o&&!this.isEnabled())return;this.logger?.debug("telemetry.metric",{telemetrySink:this.name,instrument:"histogram",name:e,value:t,attributes:r,description:i,required:o===!0})}recordGauge(e,t,r,i,o){if(!o&&!this.isEnabled())return;this.logger?.debug("telemetry.metric",{telemetrySink:this.name,instrument:"gauge",name:e,value:t,attributes:r,description:i,required:o===!0})}isEnabled(){return typeof this.enabled==="function"?this.enabled():this.enabled}async flush(){}async dispose(){}}class S{adapters;metadata;distinctId;deviceId;commonProperties;constructor(e={}){if(this.adapters=[...e.adapters??[]],e.logger)this.adapters.push(new h({logger:e.logger}));this.metadata={...e.metadata??{}},this.distinctId=e.distinctId,this.deviceId=e.deviceId??v(),this.commonProperties={...e.commonProperties??{}}}addAdapter(e){this.adapters.push(e)}setDistinctId(e){this.distinctId=e}setMetadata(e){this.metadata={...e}}updateMetadata(e){this.metadata={...this.metadata,...e}}setCommonProperties(e){this.commonProperties={...e}}updateCommonProperties(e){this.commonProperties={...this.commonProperties,...e}}isEnabled(){return this.adapters.some((e)=>e.isEnabled())}capture(e){let t=this.buildAttributes(e.properties);for(let r of this.adapters)r.emit(e.event,t)}captureRequired(e,t){let r=this.buildAttributes(t);for(let i of this.adapters)i.emitRequired(e,r)}recordCounter(e,t,r,i,o=!1){let s=this.buildAttributes(r);for(let n of this.adapters)n.recordCounter(e,t,s,i,o)}recordHistogram(e,t,r,i,o=!1){let s=this.buildAttributes(r);for(let n of this.adapters)n.recordHistogram(e,t,s,i,o)}recordGauge(e,t,r,i,o=!1){let s=this.buildAttributes(r);for(let n of this.adapters)n.recordGauge(e,t,s,i,o)}async flush(){await Promise.all(this.adapters.map((e)=>e.flush()))}async dispose(){await Promise.all(this.adapters.map((e)=>e.dispose()))}buildAttributes(e){let t=typeof e?.distinct_id==="string"&&e.distinct_id.trim()?e.distinct_id.trim():this.distinctId,r={...this.commonProperties,...this.metadata,...e,...t?{distinct_id:t}:{},device_id:this.deviceId};return Object.fromEntries(Object.entries(r).filter(([,i])=>i!==void 0))}}class k{distinctId;metadata;commonProperties;constructor(e={}){this.distinctId=e.distinctId,this.metadata={...e.metadata??{}},this.commonProperties={...e.commonProperties??{}}}setDistinctId(e){this.distinctId=e}setMetadata(e){this.metadata={...e}}updateMetadata(e){this.metadata={...this.metadata,...e}}setCommonProperties(e){this.commonProperties={...e}}updateCommonProperties(e){this.commonProperties={...this.commonProperties,...e}}isEnabled(){return!1}capture(e){this.resolveProperties(e.properties)}captureRequired(e,t){this.resolveProperties(t)}recordCounter(){}recordHistogram(){}recordGauge(){}async flush(){}async dispose(){}resolveProperties(e){let t=typeof e?.distinct_id==="string"&&e.distinct_id.trim()?e.distinct_id.trim():this.distinctId,r={...this.commonProperties,...this.metadata,...e,...t?{distinct_id:t}:{}};return Object.fromEntries(Object.entries(r).filter(([,i])=>i!==void 0))}}class _{meterProvider;loggerProvider;tracerProvider;options;constructor(e={}){this.options=e;let t=Se({...e.resourceAttributes,[Ce]:e.serviceName??"cline",...e.serviceVersion?{[Re]:e.serviceVersion}:{}});if(this.meterProvider=this.createMeterProvider(t),this.loggerProvider=this.createLoggerProvider(t),this.tracerProvider=this.createTracerProvider(t),this.meterProvider)me.setGlobalMeterProvider(this.meterProvider);if(this.loggerProvider)ge.setGlobalLoggerProvider(this.loggerProvider);if(this.tracerProvider)this.tracerProvider.register()}getTracer(e="cline",t){return pe.getTracer(e,t??this.options.serviceVersion)}createAdapter(e){return new y({...e,meterProvider:this.meterProvider,loggerProvider:this.loggerProvider})}createTelemetryService(e){let t=this.createAdapter({name:e.name,enabled:this.options.enabled,metadata:e.metadata});return new S({...e,adapters:[t],distinctId:f(e.distinctId)})}async forceFlush(){await Promise.all([this.meterProvider?.forceFlush?.(),this.loggerProvider?.forceFlush?.(),this.tracerProvider?.forceFlush?.()])}async dispose(){await Promise.all([this.meterProvider?.shutdown?.(),this.loggerProvider?.shutdown?.(),this.tracerProvider?.shutdown?.()])}createMeterProvider(e){let t=P(this.options.metricsExporter);if(t.length===0)return null;let r=Math.max(1000,this.options.metricExportIntervalMs??this.options.metricExportInterval??60000),i=Math.min(30000,Math.floor(r*0.8)),o=t.map((s)=>Ne(s,{endpoint:this.options.otlpEndpoint,headers:this.options.otlpHeaders,insecure:this.options.otlpInsecure??!1,protocol:"http/json",interval:r,timeout:i})).filter((s)=>s!==null);if(o.length===0)return null;return new Pe({resource:e,readers:o})}createTracerProvider(e){let t=P(this.options.tracesExporter);if(t.length===0)return null;let r=this.options.otlpTracesEndpoint??this.options.otlpEndpoint,i=this.options.otlpTracesHeaders??this.options.otlpHeaders,o=[],s=!1;for(let d of t){let a=De(d,{endpoint:r,headers:i,insecure:this.options.otlpInsecure??!1,protocol:"http/json"});if(a){if(o.push(a),d!=="console")s=!0}}if(o.length===0)return null;let n=new Oe({resource:e,spanProcessors:s?[new ce,...o]:o});if(s)ue(n);return n}createLoggerProvider(e){let t=P(this.options.logsExporter);if(t.length===0)return null;let r=t.map((i)=>{let o=Me(i,{endpoint:this.options.otlpEndpoint,headers:this.options.otlpHeaders,insecure:this.options.otlpInsecure??!1,protocol:"http/json"});if(!o)return null;return new ve(o,{maxQueueSize:this.options.logMaxQueueSize??2048,maxExportBatchSize:this.options.logBatchSize??512,scheduledDelayMillis:this.options.logBatchTimeoutMs??this.options.logBatchTimeout??5000})}).filter((i)=>i!==null);if(r.length===0)return null;return new Ee({resource:e,processors:r})}}function L(e){let t=new _(e),r=t.createTelemetryService(e),i=()=>{r.captureRequired("telemetry.provider_created",{provider:"opentelemetry",enabled:e.enabled??!0,logsExporter:Array.isArray(e.logsExporter)?e.logsExporter.join(","):e.logsExporter,metricsExporter:Array.isArray(e.metricsExporter)?e.metricsExporter.join(","):e.metricsExporter,tracesExporter:Array.isArray(e.tracesExporter)?e.tracesExporter.join(","):e.tracesExporter,otlpProtocol:e.otlpProtocol,hasOtlpEndpoint:Boolean(e.otlpEndpoint),serviceName:e.serviceName,serviceVersion:e.serviceVersion})};if(!e.deferProviderCreatedEvent)i();return{provider:t,telemetry:r,emitProviderCreated:i}}function w(e){if(D())return{telemetry:new k(e)};if(e.enabled!==!0)return{telemetry:new S({...e,distinctId:f(e.distinctId)})};return L(e)}function xe(e){let{telemetry:t,provider:r,emitProviderCreated:i}=w(e);return{telemetry:t,provider:r,flush:async()=>{let n=r;if(n&&typeof n.forceFlush==="function")try{await n.forceFlush()}catch{}},dispose:async()=>{await Promise.allSettled([t.dispose(),r?.dispose()])},...e.deferProviderCreatedEvent&&i?{emitProviderCreated:i}:{}}}function P(e){if(!e)return[];return(Array.isArray(e)?e:e.split(",")).map((r)=>r.trim()).filter((r)=>r==="console"||r==="otlp")}function Me(e,t){if(e==="console")return new be;if(!t.endpoint)return null;let r=I(t.endpoint,"/v1/logs");return new fe({url:r,headers:t.headers})}function De(e,t){if(e==="console")return new Ae(new Ie);if(!t.endpoint)return null;let r=I(t.endpoint,"/v1/traces");return new _e(new Te({url:r,headers:t.headers}))}function Ne(e,t){if(e==="console")return new N({exporter:new he,exportIntervalMillis:t.interval,exportTimeoutMillis:t.timeout});if(!t.endpoint)return null;let r=I(t.endpoint,"/v1/metrics");return new N({exporter:new ye({url:r,headers:t.headers}),exportIntervalMillis:t.interval,exportTimeoutMillis:t.timeout})}function I(e,t){let r=new URL(e),i=r.pathname.endsWith("/")?r.pathname.slice(0,-1):r.pathname;return r.pathname=i.endsWith(t)?i:`${i}${t}`,r.toString()}import{SESSION_STATUS_VALUES as Dt}from"@cline/shared";var p={CORE:"core",CLI:"cli",SUBAGENT:"subagent",DESKTOP:"desktop",KANBAN:"kanban",API:"api",WEB:"web",VSCODE:"vscode",ENTERPRISE:"enterprise",IDE:"ide",JETBRAINS:"jetbrains",NEOVIM:"neovim",UNKNOWN:"unknown"};function G(e){let t=[e?.name,e?.platform].filter((r)=>typeof r==="string").join(" ").toLowerCase();if(!t)return;if(t.includes("vscode")||t.includes("visual studio code"))return p.VSCODE;if(t.includes("jetbrains")||t.includes("webstorm")||t.includes("intellij")||t.includes("pycharm")||t.includes("goland")||t.includes("clion")||t.includes("rider")||t.includes("android studio"))return p.JETBRAINS;if(t.includes("neovim"))return p.NEOVIM;if(t.includes("kanban"))return p.KANBAN;if(t.includes("desktop"))return p.DESKTOP;if(t.includes("cline-platform"))return p.WEB;if(t.includes("cline-cli")||t.includes("cline-acp"))return p.CLI;if(t.includes("cline-sdk")||t.includes("cline-core"))return p.CORE;return}function u(e){let t=e?.trim();return t?t:void 0}function U(e){let t=e.client,r=G(t)??u(e.source),i=u(t.version),o=u(t.platform)??u(t.name),s=u(t.platformVersion)??i,n={cline_type:r,extension_version:i,platform:o,platform_version:s};if(e.user?.accountId===void 0)return n;let d=typeof e.user.accountId==="string"?u(e.user.accountId):void 0;return{...n,distinct_id:d??u(e.user.distinctId),user_id:d,account_id:d,account_email:d?u(e.user.email):void 0,organization_id:d?u(e.user.organizationId):void 0}}function K(e,t){let r={},i={},o,s=(n)=>({...t,...i,...r,...n,...o?{distinct_id:o}:{}});return{setDistinctId(n){o=u(n)},setMetadata(n){r={...n}},updateMetadata(n){r={...r,...n}},setCommonProperties(n){i={...n}},updateCommonProperties(n){i={...i,...n}},isEnabled:()=>e.isEnabled(),capture:(n)=>e.capture({event:n.event,properties:s(n.properties)}),captureRequired:(n,d)=>e.captureRequired(n,s(d)),recordCounter:(n,d,a,l,m)=>e.recordCounter(n,d,s(a),l,m),recordHistogram:(n,d,a,l,m)=>e.recordHistogram(n,d,s(a),l,m),recordGauge:(n,d,a,l,m)=>e.recordGauge(n,d,s(a),l,m),flush:()=>e.flush(),dispose:async()=>{}}}function ke(e,t){return K(e,U(t))}export{y as OpenTelemetryAdapter,_ as OpenTelemetryProvider,ke as createClientScopedTelemetryService,xe as createConfiguredTelemetryHandle,w as createConfiguredTelemetryService,L as createOpenTelemetryTelemetryService,K as createScopedTelemetryService,U as resolveClientTelemetryProperties,v as resolveCoreDeviceId,f as resolveCoreDistinctId};

package/dist/services/telemetry/run-health.d.ts

@@ -0,0 +1,40 @@
+import type { AgentRuntimeEvent, ITelemetryService, TelemetryProperties } from "@cline/shared";
+/** Silence (no runtime event, stream deltas included) before a run reports `task.run_idle`. */
+export declare const RUN_IDLE_REPORT_MS = 60000;
+/**
+ * Stall diagnostics for one agent run, derived only from its runtime events.
+ * `endProperties()` enriches the run's `agent.run-finished` /
+ * `agent.run-failed` telemetry; `task.run_idle` is sent while the run is
+ * still stuck.
+ */
+export declare class RunHealthObserver {
+    private readonly telemetry;
+    private readonly context;
+    private lastEventAt;
+    private lastEventType;
+    private maxIdleMs;
+    private maxIdleAfter;
+    private idleReported;
+    private agentId;
+    private runId;
+    private finishReason?;
+    private turnStarted;
+    /** The current turn streamed something but has no assistant message yet. */
+    private turnHadOutput;
+    /** The current turn's assistant message, once the runtime accepts one. */
+    private turnMessage?;
+    private idleTimer?;
+    constructor(telemetry: ITelemetryService, context: {
+        sessionId?: string;
+        isSubagent: boolean;
+        providerId?: string;
+        modelId?: string;
+    });
+    observe(event: AgentRuntimeEvent): void;
+    /** Read once when the run ends; stops the idle check. */
+    endProperties(): TelemetryProperties;
+    dispose(): void;
+    private recordGap;
+    /** One pending timer per run, re-armed from the last event rather than per event. */
+    private scheduleIdleCheck;
+}

package/dist/services/telemetry/stall-signals.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Stall signals ported from the offline (Python) stall detector, so the harness
+ * can label runs live and send only the verdict, never the text.
+ *
+ * Python's `\w`/`\b` match letters in any script; JS's match ASCII only, even
+ * with the `u` flag, so spots that meet non-ASCII words use `\p{L}` instead.
+ */
+export type StallBumpKind = "probe" | "nudge" | "greeting" | "none";
+export type StallTextSignature = "empty_turn" | "api_error" | "truncated_text" | "async_promise" | "intent_without_action" | "none";
+export declare function classifyBumpText(prompt: string): StallBumpKind;
+/** Signature of a run's final text-only assistant turn. */
+export declare function classifyFinalTurnText(rawText: string): StallTextSignature;

package/dist/types/config.d.ts

@@ -38,6 +38,7 @@ export interface CoreRuntimeFeatures {
     enableSpawnAgent: boolean;
     enableAgentTeams: boolean;
     disableMcpSettingsTools?: boolean;
+    mcpApps?: boolean;
     yolo?: boolean;
 }
 export type CoreCompactionMode = "auto" | "manual" | "overflow_recovery";

package/dist/types/session.d.ts

@@ -24,6 +24,8 @@ export type ActiveSession = {
     agent: SessionRuntime;
     started: boolean;
     aborting: boolean;
+    /** Epoch ms the last turn ended; labels the next input for stall analysis. */
+    lastTurnEndedAt?: number;
     interactive: boolean;
     persistedMessages?: LlmsProviders.MessageWithMetadata[];
     compactionState?: SessionCompactionState;
@@ -33,7 +35,12 @@ export type ActiveSession = {
     teamRunWaiters: Array<() => void>;
     pendingPrompts: PendingPrompt[];
     drainingPendingPrompts: boolean;
+    /** Set by the queue drain on the one input it replays; consumed by runTurn. */
+    replayingQueuedPrompt?: boolean;
     pluginSandboxShutdown?: () => Promise<void>;
+    pluginCommandError?: string;
+    pluginCommandTail?: Promise<unknown>;
+    pluginCommandsClosing?: boolean;
     turnUsageBaseline?: SessionAccumulatedUsage;
     turnAggregateUsageBaseline?: SessionAccumulatedUsage;
     turnPrimaryUsage?: SessionAccumulatedUsage;