@cerebriline/core 4.100.246 → 4.100.247

package/dist/services/storage/file-team-store.d.ts

@@ -1,8 +1,7 @@
 import type { TeamRuntimeState, TeamTeammateSpec } from "@cerebriline/shared";
 import type { TeamEvent } from "../../extensions/tools/team";
-import type { TeamStore } from "../../types/storage";
-import { type TeamEventsRetention } from "./team-events-retention";
-export interface FileTeamStoreOptions extends TeamEventsRetention {
+import type { TeamPersistenceBatch, TeamStore } from "../../types/storage";
+export interface FileTeamStoreOptions {
     teamDir?: string;
 }
 export interface TeamRuntimeLoadResult {
@@ -12,7 +11,6 @@ export interface TeamRuntimeLoadResult {
 }
 export declare class FileTeamStore implements TeamStore {
     private readonly teamDirPath;
-    private readonly eventsPrune;
     constructor(options?: FileTeamStoreOptions);
     /** Nothing is held open between calls; present so both stores close alike. */
     close(): void;
@@ -22,6 +20,14 @@ export declare class FileTeamStore implements TeamStore {
     readHistory(teamName: string, limit?: number): unknown[];
     loadRuntime(teamName: string): TeamRuntimeLoadResult;
     handleTeamEvent(teamName: string, event: TeamEvent): void;
+    /**
+     * The file store cannot apply deltas, so it rewrites `state.json` once per
+     * batch. Batching plus compacted run results keep that file small.
+     */
+    persistBatch(teamName: string, batch: TeamPersistenceBatch): void;
+    private appendHistory;
+    /** Keep the newest `retentionPerTeam` lines once the file grows too big. */
+    private compactHistoryIfNeeded;
     persistRuntime(teamName: string, state: TeamRuntimeState, teammates: TeamTeammateSpec[]): void;
     markInProgressRunsInterrupted(teamName: string, reason: string): string[];
     private ensureTeamDir;

package/dist/services/storage/sqlite-team-store.d.ts

@@ -1,8 +1,7 @@
 import { type TeamRuntimeState, type TeamTeammateSpec } from "@cerebriline/shared";
 import type { TeamEvent } from "../../extensions/tools/team";
-import type { TeamStore } from "../../types/storage";
-import { type TeamEventsRetention } from "./team-events-retention";
-export interface SqliteTeamStoreOptions extends TeamEventsRetention {
+import type { TeamPersistenceBatch, TeamStore } from "../../types/storage";
+export interface SqliteTeamStoreOptions {
     teamDir?: string;
 }
 export interface TeamRuntimeLoadResult {
@@ -10,11 +9,20 @@ export interface TeamRuntimeLoadResult {
     teammates: TeamTeammateSpec[];
     interruptedRunIds: string[];
 }
+/** Durable event rows kept per team (history tool reads newest-first). */
+export declare const TEAM_EVENT_RETENTION_PER_TEAM = 2000;
+/** Event rows older than this are pruned regardless of count. */
+export declare const TEAM_EVENT_RETENTION_MS: number;
+export interface SqliteTeamStoreTuning {
+    eventRetentionPerTeam?: number;
+    eventRetentionMs?: number;
+}
 export declare class SqliteTeamStore implements TeamStore {
     private readonly teamDirPath;
     private db;
-    private readonly eventsPrune;
-    constructor(options?: SqliteTeamStoreOptions);
+    private readonly retentionPerTeam;
+    private readonly retentionMs;
+    constructor(options?: SqliteTeamStoreOptions & SqliteTeamStoreTuning);
     init(): void;
     /**
      * Releases the database handle. The next call reopens it, so a store that
@@ -26,17 +34,52 @@ export declare class SqliteTeamStore implements TeamStore {
     private dbPath;
     private getRawDb;
     private ensureSchema;
+    /**
+     * Moves any non-empty `state_json` into entity rows, then clears it.
+     * v2+ builds only ever write `''`, so a non-empty value was written by an
+     * older build (e.g. after an image rollback). Runs on every open, not just
+     * the v2 migration, so those writes are recovered after re-upgrading.
+     * Caller owns the transaction.
+     */
+    private importLegacySnapshots;
+    /**
+     * v2 migration (one-time, transactional):
+     * - adds `data_json` to entity tables and new members/mailbox/mission-log
+     *   tables, so state is rebuilt from rows instead of `state_json`;
+     * - moves each existing snapshot into rows, compacting run results;
+     * - deletes telemetry events and strips transcripts from retained ones;
+     * - clears `state_json` (the column stays for downgrade-safe schema).
+     * Run `vacuum()` afterwards to give the space back to the OS.
+     */
+    private migrateToV2;
     private run;
     private queryOne;
     private queryAll;
     /** Runs `work` in a single SQLite transaction (rollback on any error). */
     private withTransaction;
     listTeamNames(): string[];
+    /** Rebuild state from per-entity rows. Cost is O(live entities). */
     readState(teamName: string): TeamRuntimeState | undefined;
     readHistory(teamName: string, limit?: number): unknown[];
     loadRuntime(teamName: string): TeamRuntimeLoadResult;
     appendTeamEvent(teamName: string, eventType: string, payload: unknown, correlationId?: string): void;
+    /**
+     * Incremental write: appends events and upserts only changed entities in
+     * one transaction. Cost is O(changes in batch), independent of history.
+     */
+    persistBatch(teamName: string, batch: TeamPersistenceBatch): void;
+    /** Full rewrite, expressed as a reset delta (no `state_json` blob). */
     persistRuntime(teamName: string, state: TeamRuntimeState, teammates: TeamTeammateSpec[]): void;
+    private writeTeammates;
+    private writeDelta;
+    /** Cap `team_events` per team by count and by age. */
+    private pruneTeamEvents;
+    /**
+     * Return free pages to the OS after the v2 migration or heavy pruning.
+     * VACUUM rewrites the whole file, so it is explicit, not automatic.
+     */
+    vacuum(): void;
     markInProgressRunsInterrupted(teamName: string, reason: string): string[];
+    /** Legacy single-event path: telemetry is dropped, payloads compacted. */
     handleTeamEvent(teamName: string, event: TeamEvent): void;
 }

package/dist/services/storage/team-store.d.ts

@@ -10,6 +10,7 @@ export declare function createLocalTeamStore(options?: SqliteTeamStoreOptions):
     readHistory(teamName: string, limit?: number): unknown[];
     loadRuntime(teamName: string): ReturnType<FileTeamStore["loadRuntime"]>;
     handleTeamEvent: FileTeamStore["handleTeamEvent"];
+    persistBatch: FileTeamStore["persistBatch"];
     persistRuntime: FileTeamStore["persistRuntime"];
     markInProgressRunsInterrupted: FileTeamStore["markInProgressRunsInterrupted"];
     close(): void;

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

@@ -14,12 +14,17 @@ export interface TelemetryAgentIdentityProperties {
     teamAgentId?: string;
 }
 export declare const CORE_TELEMETRY_EVENTS: {
+    readonly SCHEDULE: {
+        readonly RUN_STARTED: "schedule.run_started";
+        readonly RUN_FINISHED: "schedule.run_finished";
+    };
     readonly CLIENT: {
         readonly EXTENSION_ACTIVATED: "user.extension_activated";
     };
     readonly SESSION: {
         readonly STARTED: "session.started";
         readonly ENDED: "session.ended";
+        readonly ERROR_RECORDED: "session.error_recorded";
     };
     readonly AGENT: {
         readonly UNEXPECTED_REASONING_TOKENS: "agent.reasoning.unexpected_tokens";
@@ -38,6 +43,7 @@ export declare const CORE_TELEMETRY_EVENTS: {
         readonly CREATED: "task.created";
         readonly RESTARTED: "task.restarted";
         readonly COMPLETED: "task.completed";
+        readonly GIT_SNAPSHOT: "task.git_snapshot";
         readonly CONVERSATION_TURN: "task.conversation_turn";
         readonly TOKEN_USAGE: "task.tokens";
         readonly MODE_SWITCH: "task.mode";
@@ -50,6 +56,7 @@ export declare const CORE_TELEMETRY_EVENTS: {
         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 MENTION_USED: "task.mention_used";
         readonly MENTION_FAILED: "task.mention_failed";
@@ -64,6 +71,7 @@ export declare const CORE_TELEMETRY_EVENTS: {
     };
     readonly HOOKS: {
         readonly DISCOVERY_COMPLETED: "hooks.discovery_completed";
+        readonly DETACHED_RUNTIME: "hooks.detached_runtime";
     };
     readonly WORKSPACE: {
         readonly INITIALIZED: "workspace.initialized";
@@ -96,6 +104,46 @@ export interface RunCommandsTimeoutTelemetryProperties {
     tool_call_id?: string;
 }
 export { captureAgentUnexpectedReasoningTokens, captureTaskLifecycleEvent, type CaptureAgentUnexpectedReasoningTokensInput, type CaptureTaskLifecycleEventInput, };
+export interface GitSnapshotProperties {
+    schema_version: 1;
+    /** Actual Core session ID; ulid duplicates it for existing export consumers. */
+    sessionId: string;
+    ulid: string;
+    providerId: string;
+    workspace_id: string;
+    /** VS Code workspace-folder count at observation start, not Git repo count; 0 with no folders, even outside Git. */
+    workspace_root_count: number;
+    observation_window_id: string;
+    observation_sequence: number;
+    /** ISO observation-start time, after the model response. Git reads are not atomic. */
+    observed_at: string;
+    /** Background observation triggered by this response; tools may execute during the read. */
+    boundary: "model_call";
+    runId?: string;
+    iteration?: number;
+    agentId?: string;
+    /** Surfaced response's backend ID, when available; never synthesized or inherited from an earlier request. */
+    request_id?: string;
+    request_id_status: "present" | "missing";
+    git: {
+        /** partial: status hit its timeout/output cap but separate reads recovered HEAD and/or branch. */
+        state: "ok" | "unborn" | "non_git" | "unavailable" | "partial";
+        head_sha?: string;
+        branch?: string;
+        /** Any staged/unstaged/untracked changes. All four flags are absent for partial/non_git/unavailable, not false. */
+        dirty?: boolean;
+        /** Index changes, including unmerged entries; does not imply commit readiness. */
+        staged?: boolean;
+        /** Worktree changes, including unmerged entries. */
+        unstaged?: boolean;
+        /** Non-ignored untracked files. */
+        untracked?: boolean;
+        remote_url?: string;
+        remote_state?: "ok" | "none" | "unsupported" | "unavailable";
+    };
+}
+/** Ordinary telemetry: use a consent-aware service, never captureRequired. */
+export declare function captureGitSnapshot(telemetry: ITelemetryService | undefined, properties: GitSnapshotProperties): void;
 export interface WorkspaceInitializedProperties {
     root_count: number;
     vcs_types: ReadonlyArray<string>;
@@ -181,15 +229,23 @@ export declare function identifyAccount(telemetry: ITelemetryService | undefined
     organizationName?: string;
     memberId?: string;
 }): void;
+/**
+ * Restore anonymous process identity after an account signs out.
+ *
+ * Account properties are explicitly set to undefined so they replace values
+ * previously merged into a long-lived telemetry service. Implementations
+ * remove undefined attributes before export.
+ */
+export declare function clearAccountTelemetryIdentity(telemetry: ITelemetryService | undefined, anonymousDistinctId?: string): void;
 export declare function captureTaskCreated(telemetry: ITelemetryService | undefined, properties: {
     ulid: string;
-    apiProvider?: string;
-    openAiCompatibleDomain?: string;
+    provider?: string;
+    model?: string;
 } & Partial<TelemetryAgentIdentityProperties>): void;
 export declare function captureTaskRestarted(telemetry: ITelemetryService | undefined, properties: {
     ulid: string;
-    apiProvider?: string;
-    openAiCompatibleDomain?: string;
+    provider?: string;
+    model?: string;
 } & Partial<TelemetryAgentIdentityProperties>): void;
 /**
  * Distinguishes the trigger that produced a `task.completed` telemetry event.
@@ -206,7 +262,7 @@ export type TaskCompletedSource = "submit_and_exit" | "shutdown";
 export declare function captureTaskCompleted(telemetry: ITelemetryService | undefined, properties: {
     ulid: string;
     provider?: string;
-    modelId?: string;
+    model?: string;
     mode?: string;
     durationMs?: number;
     source?: TaskCompletedSource;
@@ -222,11 +278,14 @@ export declare function captureTokenUsage(telemetry: ITelemetryService | undefin
     ulid: string;
     /** Uncached input tokens only — disjoint from the cache buckets. */
     tokensIn: number;
+    /** Non-reasoning output tokens only — reasoningTokenCount is disjoint from this. */
     tokensOut: number;
     cacheWriteTokens?: number;
     cacheReadTokens?: number;
     /** This request's cost delta, not a running total. */
     totalCost?: number;
+    /** Reasoning/thinking tokens for this request, reported separately since they're no longer folded into tokensOut. */
+    reasoningTokenCount?: number;
     provider?: string;
     model: string;
 } & Partial<TelemetryAgentIdentityProperties>): void;
@@ -316,6 +375,20 @@ export declare function captureSubagentExecution(telemetry: ITelemetryService |
     errorMessage?: string;
     type?: "agent" | "team";
 } & Partial<TelemetryAgentIdentityProperties>): void;
+/**
+ * Records how long a fire-and-forget hook ran. Detached hooks are never
+ * awaited, so their runtime is otherwise invisible — this is the evidence for
+ * whether any of them could safely be made blocking. `exited: false` marks a
+ * censored observation: the hook was still running when the observation
+ * window closed, so treat `durationMs` as a lower bound and count these
+ * separately rather than averaging them in.
+ */
+export declare function captureDetachedHookRuntime(telemetry: ITelemetryService | undefined, event: {
+    hookName: string;
+    durationMs: number;
+    exitCode: number | null;
+    exited: boolean;
+}): void;
 export declare function captureHookDiscovery(telemetry: ITelemetryService | undefined, hookName: string, globalCount: number, workspaceCount: number): void;
 /**
  * Identifies which compaction implementation produced a
@@ -394,3 +467,22 @@ export interface CaptureCompactionBudgetEmergencyProperties {
     modelId?: string;
 }
 export declare function captureCompactionBudgetEmergency(telemetry: ITelemetryService | undefined, properties: CaptureCompactionBudgetEmergencyProperties & Partial<TelemetryAgentIdentityProperties>): void;
+/** A terminal failure was recorded as a display-only transcript entry. */
+export declare function captureSessionErrorRecorded(telemetry: ITelemetryService | undefined, details: {
+    sessionId?: string;
+    provider: string;
+    model: string;
+    source: "result" | "thrown";
+}): void;
+/** Bounded scheduler diagnostics; never include prompts, paths, or raw errors. */
+export declare function captureScheduleRun(telemetry: ITelemetryService | undefined, input: {
+    triggerKind: "one_off" | "schedule" | "event" | "manual" | "retry";
+    attemptCount: number;
+    startDelayMs: number;
+} & ({
+    phase: "started";
+} | {
+    phase: "finished";
+    outcome: "success" | "failed" | "timeout" | "superseded" | "cancelled";
+    durationMs: number;
+})): void;

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

@@ -2,3 +2,4 @@ export { resolveCoreDeviceId, resolveCoreDistinctId } from "./distinct-id";
 export type { ITelemetryAdapter, TelemetryArray, TelemetryMetadata, TelemetryObject, TelemetryPrimitive, TelemetryProperties, TelemetryValue, } from "./ITelemetryAdapter";
 export { OpenTelemetryAdapter, type OpenTelemetryAdapterOptions, } from "./OpenTelemetryAdapter";
 export { type ConfiguredTelemetryHandle, type CreateOpenTelemetryTelemetryServiceOptions, createConfiguredTelemetryHandle, createConfiguredTelemetryService, createOpenTelemetryTelemetryService, OpenTelemetryProvider, type OpenTelemetryProviderOptions, } from "./OpenTelemetryProvider";
+export { type ClientTelemetryContext, createClientScopedTelemetryService, createScopedTelemetryService, resolveClientTelemetryProperties, } from "./scoped-telemetry";

package/dist/services/telemetry/index.js

@@ -1 +1 @@
-import{existsSync as N,mkdirSync as G,readFileSync as v,writeFileSync as u}from"node:fs";import{resolve as b}from"node:path";import{resolveSessionDataDir as S}from"@cerebriline/shared/storage";import{nanoid as g}from"nanoid";import*as c from"node-machine-id";var m="machine-id",C,w=!1;function B(){if(!w)C=h(),w=!0;return C??q()}function X(f){let P=f?.trim();if(P)return P;let A=h();if(A)return A;return q()}function d(){let f=c;return f.machineIdSync??f.default?.machineIdSync}function h(){try{let f=d();if(!f)return;return f().trim()||void 0}catch{return}}function q(){let f=S(),P=b(f,m);try{if(N(P)){let O=v(P,"utf8").trim();if(O.length>0)return O}}catch{}let A=`cl-${g()}`;try{G(f,{recursive:!0}),u(P,A,"utf8")}catch{}return A}class Y{name;metadata;meter;logger;enabled;distinctId;commonProperties;counters=new Map;histograms=new Map;gauges=new Map;gaugeValues=new Map;meterProvider;loggerProvider;constructor(f){this.name=f.name??"OpenTelemetryAdapter",this.metadata={...f.metadata},this.meterProvider=f.meterProvider,this.loggerProvider=f.loggerProvider,this.meter=f.meterProvider?.getMeter("cline")??null,this.logger=f.loggerProvider?.getLogger("cline")??null,this.enabled=f.enabled??!0,this.distinctId=f.distinctId,this.commonProperties=f.commonProperties?{...f.commonProperties}:{}}emit(f,P){if(!this.isEnabled())return;this.emitLog(f,P,!1)}emitRequired(f,P){this.emitLog(f,P,!0)}recordCounter(f,P,A,O,j=!1){if(!this.meter||!j&&!this.isEnabled())return;let H=this.counters.get(f);if(!H)H=this.meter.createCounter(f,O?{description:O}:void 0),this.counters.set(f,H);H.add(P,this.flattenProperties(this.buildAttributes(A)))}recordHistogram(f,P,A,O,j=!1){if(!this.meter||!j&&!this.isEnabled())return;let H=this.histograms.get(f);if(!H)H=this.meter.createHistogram(f,O?{description:O}:void 0),this.histograms.set(f,H);H.record(P,this.flattenProperties(this.buildAttributes(A)))}recordGauge(f,P,A,O,j=!1){if(!this.meter||!j&&!this.isEnabled())return;let H=this.buildAttributes(A),J=JSON.stringify(H),K=this.gaugeValues.get(f);if(P===null){if(K){if(K.delete(J),K.size===0)this.gaugeValues.delete(f),this.gauges.delete(f)}return}let T=K;if(!T)T=new Map,this.gaugeValues.set(f,T);if(!this.gauges.has(f)){let W=this.meter.createObservableGauge(f,O?{description:O}:void 0);W.addCallback((R)=>{for(let M of this.snapshotGaugeSeries(f))R.observe(M.value,this.flattenProperties(M.attributes))}),this.gauges.set(f,W)}T.set(J,{value:P,attributes:H})}isEnabled(){return typeof this.enabled==="function"?this.enabled():this.enabled}setDistinctId(f){this.distinctId=f}setCommonProperties(f){this.commonProperties={...f}}updateCommonProperties(f){this.commonProperties={...this.commonProperties,...f}}async flush(){await Promise.all([this.meterProvider?.forceFlush?.(),this.loggerProvider?.forceFlush?.()])}async dispose(){await Promise.all([this.meterProvider?.shutdown?.(),this.loggerProvider?.shutdown?.()])}emitLog(f,P,A){if(!this.logger)return;let O=this.flattenProperties(this.buildAttributes(P,A));this.logger.emit({severityText:"INFO",body:f,attributes:O})}buildAttributes(f,P=!1){return{...this.commonProperties,...this.metadata,...f,...this.distinctId?{distinct_id:this.distinctId}:{},...P?{_required:!0}:{}}}snapshotGaugeSeries(f){let P=this.gaugeValues.get(f);if(!P)return[];return Array.from(P.values(),(A)=>({value:A.value,attributes:A.attributes?{...A.attributes}:void 0}))}flattenProperties(f,P="",A=new WeakSet,O=0){if(!f)return{};let j={},H=100,J=10;for(let[K,T]of Object.entries(f)){if(K==="__proto__"||K==="constructor"||K==="prototype")continue;let W=P?`${P}.${K}`:K;if(T===null||T===void 0){j[W]=String(T);continue}if(Array.isArray(T)){let R=T.length>H?T.slice(0,H):T;try{j[W]=JSON.stringify(R)}catch{j[W]="[UnserializableArray]"}if(T.length>H)j[`${W}_truncated`]=!0,j[`${W}_original_length`]=T.length;continue}if(typeof T==="object"){if(T instanceof Date){j[W]=T.toISOString();continue}if(T instanceof Error){j[W]=T.message;continue}if(A.has(T)){j[W]="[Circular]";continue}if(O>=J){j[W]="[MaxDepthExceeded]";continue}A.add(T),Object.assign(j,this.flattenProperties(T,W,A,O+1));continue}if(r(T)){j[W]=T;continue}try{j[W]=JSON.stringify(T)}catch{j[W]=String(T)}}return j}}function r(f){return typeof f==="string"||typeof f==="number"||typeof f==="boolean"}import{metrics as Of,trace as jf}from"@opentelemetry/api";import{logs as Hf}from"@opentelemetry/api-logs";import{OTLPLogExporter as Tf}from"@opentelemetry/exporter-logs-otlp-http";import{OTLPMetricExporter as $f}from"@opentelemetry/exporter-metrics-otlp-http";import{OTLPTraceExporter as Jf}from"@opentelemetry/exporter-trace-otlp-http";import{resourceFromAttributes as Wf}from"@opentelemetry/resources";import{BatchLogRecordProcessor as Kf,ConsoleLogRecordExporter as Xf,LoggerProvider as Yf}from"@opentelemetry/sdk-logs";import{ConsoleMetricExporter as Zf,MeterProvider as Qf,PeriodicExportingMetricReader as y}from"@opentelemetry/sdk-metrics";import{BatchSpanProcessor as Rf,ConsoleSpanExporter as Bf,SimpleSpanProcessor as Ff}from"@opentelemetry/sdk-trace-base";import{NodeTracerProvider as Vf}from"@opentelemetry/sdk-trace-node";import{ATTR_SERVICE_NAME as Uf,ATTR_SERVICE_VERSION as _f}from"@opentelemetry/semantic-conventions";import{mkdirSync as rf,readFileSync as l,statSync as n,writeFileSync as lf}from"node:fs";import{CONFIGURABLE_MODEL_TOOL_NAMES as p}from"@cerebriline/shared";import{resolveGlobalSettingsPath as a}from"@cerebriline/shared/storage";import{z as $}from"zod";import{AGENT_UNEXPECTED_REASONING_TOKENS_EVENT as zf,captureAgentUnexpectedReasoningTokens as xf,captureTaskLifecycleEvent as Nf,SDK_ERROR_TELEMETRY_EVENT as Gf,TASK_CANCELLED_EVENT as vf,TASK_FIRST_CHUNK_RECEIVED_EVENT as uf,TASK_PROVIDER_REQUEST_STARTED_EVENT as bf,TASK_PROVIDER_STREAM_FAILED_EVENT as Sf,TASK_PROVIDER_STREAM_STARTED_EVENT as gf}from"@cerebriline/shared";var F=$.preprocess((f)=>Array.isArray(f)?f.filter((P)=>typeof P==="string").map((P)=>P.trim()).filter(Boolean):void 0,$.array($.string()).optional()).transform((f)=>{if(!f)return;let P=[...new Set(f)].sort((A,O)=>A.localeCompare(O));return P.length>0?P:void 0}),i=$.enum(["basic","agentic"]).catch("agentic"),s=$.partialRecord($.enum(p),$.object({enabled:$.boolean()}).strip()).optional(),o=$.record($.string(),$.object({enabled:$.boolean()}).strip()).optional().catch(void 0),t=$.enum(["plan","act"]),E=$.object({telemetryOptOut:$.boolean().default(!1).catch(!1),autoUpdateEnabled:$.boolean().default(!0).catch(!0),compactionStrategy:i.optional(),compactionEnabled:$.boolean().optional().catch(void 0),planActMode:t.optional().catch(void 0),toolAutoApprove:$.boolean().optional().catch(void 0),tuiTheme:$.string().optional().catch(void 0),disabledTools:F.optional(),tools:s,disabledPlugins:F.optional(),disabledAgentPlugins:F.optional(),bundledSkills:o}).strip().transform((f)=>{let P={autoUpdateEnabled:f.autoUpdateEnabled,telemetryOptOut:f.telemetryOptOut};if(f.compactionStrategy)P.compactionStrategy=f.compactionStrategy;if(f.compactionEnabled!==void 0)P.compactionEnabled=f.compactionEnabled;if(f.planActMode)P.planActMode=f.planActMode;if(f.toolAutoApprove!==void 0)P.toolAutoApprove=f.toolAutoApprove;if(f.tuiTheme?.trim())P.tuiTheme=f.tuiTheme.trim();if(f.disabledTools?.length)P.disabledTools=f.disabledTools;if(f.tools&&Object.keys(f.tools).length>0)P.tools=f.tools;if(f.disabledPlugins?.length)P.disabledPlugins=f.disabledPlugins;if(f.disabledAgentPlugins?.length)P.disabledAgentPlugins=f.disabledAgentPlugins;if(f.bundledSkills&&Object.keys(f.bundledSkills).length>0)P.bundledSkills=f.bundledSkills;return P});function Z(){return E.parse({})}var V;function e(f){if(f.disabledTools)Object.freeze(f.disabledTools);if(f.tools){for(let P of Object.values(f.tools))Object.freeze(P);Object.freeze(f.tools)}if(f.disabledPlugins)Object.freeze(f.disabledPlugins);if(f.disabledAgentPlugins)Object.freeze(f.disabledAgentPlugins);return Object.freeze(f)}function ff(f){let P;try{P=l(f,"utf8")}catch{return Z()}try{let A=E.safeParse(JSON.parse(P));return A.success?A.data:Z()}catch{return Z()}}function Pf(){let f=a(),P=n(f,{throwIfNoEntry:!1}),A=P?.mtimeMs??0,O=P?.size??0,j=V;if(j&&j.path===f&&j.mtimeMs===A&&j.size===O)return j;let H=e(P?ff(f):Z());return V={path:f,mtimeMs:A,size:O,value:H},V}function Af(){return Pf().value}function I(){return Af().telemetryOptOut}class U{name;logger;enabled;constructor(f={}){this.name=f.name??"TelemetryLoggerSink",this.logger=f.logger,this.enabled=f.enabled??!0}emit(f,P){if(!this.isEnabled())return;this.logger?.log("telemetry.event",{telemetrySink:this.name,event:f,properties:P})}emitRequired(f,P){this.logger?.log("telemetry.required_event",{telemetrySink:this.name,severity:"warn",event:f,properties:P})}recordCounter(f,P,A,O,j){if(!j&&!this.isEnabled())return;this.logger?.debug("telemetry.metric",{telemetrySink:this.name,instrument:"counter",name:f,value:P,attributes:A,description:O,required:j===!0})}recordHistogram(f,P,A,O,j){if(!j&&!this.isEnabled())return;this.logger?.debug("telemetry.metric",{telemetrySink:this.name,instrument:"histogram",name:f,value:P,attributes:A,description:O,required:j===!0})}recordGauge(f,P,A,O,j){if(!j&&!this.isEnabled())return;this.logger?.debug("telemetry.metric",{telemetrySink:this.name,instrument:"gauge",name:f,value:P,attributes:A,description:O,required:j===!0})}isEnabled(){return typeof this.enabled==="function"?this.enabled():this.enabled}async flush(){}async dispose(){}}class Q{adapters;metadata;distinctId;deviceId;commonProperties;constructor(f={}){if(this.adapters=[...f.adapters??[]],f.logger)this.adapters.push(new U({logger:f.logger}));this.metadata={...f.metadata??{}},this.distinctId=f.distinctId,this.deviceId=f.deviceId??B(),this.commonProperties={...f.commonProperties??{}}}addAdapter(f){this.adapters.push(f)}setDistinctId(f){this.distinctId=f}setMetadata(f){this.metadata={...f}}updateMetadata(f){this.metadata={...this.metadata,...f}}setCommonProperties(f){this.commonProperties={...f}}updateCommonProperties(f){this.commonProperties={...this.commonProperties,...f}}isEnabled(){return this.adapters.some((f)=>f.isEnabled())}capture(f){let P=this.buildAttributes(f.properties);for(let A of this.adapters)A.emit(f.event,P)}captureRequired(f,P){let A=this.buildAttributes(P);for(let O of this.adapters)O.emitRequired(f,A)}recordCounter(f,P,A,O,j=!1){let H=this.buildAttributes(A);for(let J of this.adapters)J.recordCounter(f,P,H,O,j)}recordHistogram(f,P,A,O,j=!1){let H=this.buildAttributes(A);for(let J of this.adapters)J.recordHistogram(f,P,H,O,j)}recordGauge(f,P,A,O,j=!1){let H=this.buildAttributes(A);for(let J of this.adapters)J.recordGauge(f,P,H,O,j)}async flush(){await Promise.all(this.adapters.map((f)=>f.flush()))}async dispose(){await Promise.all(this.adapters.map((f)=>f.dispose()))}buildAttributes(f){return{...this.commonProperties,...f,...this.metadata,...this.distinctId?{distinct_id:this.distinctId}:{},device_id:this.deviceId}}}class D{distinctId;metadata;commonProperties;constructor(f={}){this.distinctId=f.distinctId,this.metadata={...f.metadata??{}},this.commonProperties={...f.commonProperties??{}}}setDistinctId(f){this.distinctId=f}setMetadata(f){this.metadata={...f}}updateMetadata(f){this.metadata={...this.metadata,...f}}setCommonProperties(f){this.commonProperties={...f}}updateCommonProperties(f){this.commonProperties={...this.commonProperties,...f}}isEnabled(){return!1}capture(f){this.resolveProperties(f.properties)}captureRequired(f,P){this.resolveProperties(P)}recordCounter(){}recordHistogram(){}recordGauge(){}async flush(){}async dispose(){}resolveProperties(f){return{...this.commonProperties,...f,...this.metadata,...this.distinctId?{distinct_id:this.distinctId}:{}}}}class L{meterProvider;loggerProvider;tracerProvider;options;constructor(f={}){this.options=f;let P=Wf({[Uf]:f.serviceName??"cline",...f.serviceVersion?{[_f]:f.serviceVersion}:{}});if(this.meterProvider=this.createMeterProvider(P),this.loggerProvider=this.createLoggerProvider(P),this.tracerProvider=this.createTracerProvider(P),this.meterProvider)Of.setGlobalMeterProvider(this.meterProvider);if(this.loggerProvider)Hf.setGlobalLoggerProvider(this.loggerProvider);if(this.tracerProvider)this.tracerProvider.register()}getTracer(f="cline",P){return jf.getTracer(f,P??this.options.serviceVersion)}createAdapter(f){return new Y({...f,meterProvider:this.meterProvider,loggerProvider:this.loggerProvider})}createTelemetryService(f){let P=this.createAdapter({name:f.name,enabled:this.options.enabled,metadata:f.metadata});return new Q({...f,adapters:[P],distinctId:X(f.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(f){let P=_(this.options.metricsExporter);if(P.length===0)return null;let A=Math.max(1000,this.options.metricExportIntervalMs??this.options.metricExportInterval??60000),O=Math.min(30000,Math.floor(A*0.8)),j=P.map((H)=>Cf(H,{endpoint:this.options.otlpEndpoint,headers:this.options.otlpHeaders,insecure:this.options.otlpInsecure??!1,protocol:"http/json",interval:A,timeout:O})).filter((H)=>H!==null);if(j.length===0)return null;return new Qf({resource:f,readers:j})}createTracerProvider(f){let P=_(this.options.tracesExporter);if(P.length===0)return null;let A=this.options.otlpTracesEndpoint??this.options.otlpEndpoint,O=this.options.otlpTracesHeaders??this.options.otlpHeaders,j=[];for(let H of P){let J=Mf(H,{endpoint:A,headers:O,insecure:this.options.otlpInsecure??!1,protocol:"http/json"});if(J)j.push(J)}if(j.length===0)return null;return new Vf({resource:f,spanProcessors:j})}createLoggerProvider(f){let P=_(this.options.logsExporter);if(P.length===0)return null;let A=P.map((O)=>{let j=kf(O,{endpoint:this.options.otlpEndpoint,headers:this.options.otlpHeaders,insecure:this.options.otlpInsecure??!1,protocol:"http/json"});if(!j)return null;return new Kf(j,{maxQueueSize:this.options.logMaxQueueSize??2048,maxExportBatchSize:this.options.logBatchSize??512,scheduledDelayMillis:this.options.logBatchTimeoutMs??this.options.logBatchTimeout??5000})}).filter((O)=>O!==null);if(A.length===0)return null;return new Yf({resource:f,processors:A})}}function z(f){let P=new L(f),A=P.createTelemetryService(f),O=()=>{A.captureRequired("telemetry.provider_created",{provider:"opentelemetry",enabled:f.enabled??!0,logsExporter:Array.isArray(f.logsExporter)?f.logsExporter.join(","):f.logsExporter,metricsExporter:Array.isArray(f.metricsExporter)?f.metricsExporter.join(","):f.metricsExporter,tracesExporter:Array.isArray(f.tracesExporter)?f.tracesExporter.join(","):f.tracesExporter,otlpProtocol:f.otlpProtocol,hasOtlpEndpoint:Boolean(f.otlpEndpoint),serviceName:f.serviceName,serviceVersion:f.serviceVersion})};if(!f.deferProviderCreatedEvent)O();return{provider:P,telemetry:A,emitProviderCreated:O}}function x(f){if(I())return{telemetry:new D(f)};if(f.enabled!==!0)return{telemetry:new Q({...f,distinctId:X(f.distinctId)})};return z(f)}function Lf(f){let{telemetry:P,provider:A,emitProviderCreated:O}=x(f);return{telemetry:P,provider:A,flush:async()=>{let J=A;if(J&&typeof J.forceFlush==="function")try{await J.forceFlush()}catch{}},dispose:async()=>{await Promise.allSettled([P.dispose(),A?.dispose()])},...f.deferProviderCreatedEvent&&O?{emitProviderCreated:O}:{}}}function _(f){if(!f)return[];return(Array.isArray(f)?f:f.split(",")).map((A)=>A.trim()).filter((A)=>A==="console"||A==="otlp")}function kf(f,P){if(f==="console")return new Xf;if(!P.endpoint)return null;let A=k(P.endpoint,"/v1/logs");return new Tf({url:A,headers:P.headers})}function Mf(f,P){if(f==="console")return new Ff(new Bf);if(!P.endpoint)return null;let A=k(P.endpoint,"/v1/traces");return new Rf(new Jf({url:A,headers:P.headers}))}function Cf(f,P){if(f==="console")return new y({exporter:new Zf,exportIntervalMillis:P.interval,exportTimeoutMillis:P.timeout});if(!P.endpoint)return null;let A=k(P.endpoint,"/v1/metrics");return new y({exporter:new $f({url:A,headers:P.headers}),exportIntervalMillis:P.interval,exportTimeoutMillis:P.timeout})}function k(f,P){let A=new URL(f),O=A.pathname.endsWith("/")?A.pathname.slice(0,-1):A.pathname;return A.pathname=O.endsWith(P)?O:`${O}${P}`,A.toString()}export{X as resolveCoreDistinctId,B as resolveCoreDeviceId,z as createOpenTelemetryTelemetryService,x as createConfiguredTelemetryService,Lf as createConfiguredTelemetryHandle,L as OpenTelemetryProvider,Y as OpenTelemetryAdapter};
+import{existsSync as g,mkdirSync as u,readFileSync as c,writeFileSync as m}from"node:fs";import{resolve as d}from"node:path";import{resolveSessionDataDir as l}from"@cerebriline/shared/storage";import{nanoid as p}from"nanoid";import*as r from"node-machine-id";var a="machine-id",q,h=!1;function R(){if(!h)q=E(),h=!0;return q??z()}function Y(f){let j=f?.trim();if(j)return j;let $=E();if($)return $;return z()}function n(){let f=r;return f.machineIdSync??f.default?.machineIdSync}function E(){try{let f=n();if(!f)return;return f().trim()||void 0}catch{return}}function z(){let f=l(),j=d(f,a);try{if(g(j)){let A=c(j,"utf8").trim();if(A.length>0)return A}}catch{}let $=`cl-${p()}`;try{u(f,{recursive:!0}),m(j,$,"utf8")}catch{}return $}class B{name;metadata;meter;logger;enabled;distinctId;commonProperties;counters=new Map;histograms=new Map;gauges=new Map;gaugeValues=new Map;meterProvider;loggerProvider;constructor(f){this.name=f.name??"OpenTelemetryAdapter",this.metadata={...f.metadata},this.meterProvider=f.meterProvider,this.loggerProvider=f.loggerProvider,this.meter=f.meterProvider?.getMeter("cline")??null,this.logger=f.loggerProvider?.getLogger("cline")??null,this.enabled=f.enabled??!0,this.distinctId=f.distinctId,this.commonProperties=f.commonProperties?{...f.commonProperties}:{}}emit(f,j){if(!this.isEnabled())return;this.emitLog(f,j,!1)}emitRequired(f,j){this.emitLog(f,j,!0)}recordCounter(f,j,$,A,J=!1){if(!this.meter||!J&&!this.isEnabled())return;let W=this.counters.get(f);if(!W)W=this.meter.createCounter(f,A?{description:A}:void 0),this.counters.set(f,W);W.add(j,this.flattenProperties(this.buildAttributes($)))}recordHistogram(f,j,$,A,J=!1){if(!this.meter||!J&&!this.isEnabled())return;let W=this.histograms.get(f);if(!W)W=this.meter.createHistogram(f,A?{description:A}:void 0),this.histograms.set(f,W);W.record(j,this.flattenProperties(this.buildAttributes($)))}recordGauge(f,j,$,A,J=!1){if(!this.meter||!J&&!this.isEnabled())return;let W=this.buildAttributes($),H=JSON.stringify(W),X=this.gaugeValues.get(f);if(j===null){if(X){if(X.delete(H),X.size===0)this.gaugeValues.delete(f),this.gauges.delete(f)}return}let O=X;if(!O)O=new Map,this.gaugeValues.set(f,O);if(!this.gauges.has(f)){let Z=this.meter.createObservableGauge(f,A?{description:A}:void 0);Z.addCallback((Q)=>{for(let w of this.snapshotGaugeSeries(f))Q.observe(w.value,this.flattenProperties(w.attributes))}),this.gauges.set(f,Z)}O.set(H,{value:j,attributes:W})}isEnabled(){return typeof this.enabled==="function"?this.enabled():this.enabled}setDistinctId(f){this.distinctId=f}setCommonProperties(f){this.commonProperties={...f}}updateCommonProperties(f){this.commonProperties={...this.commonProperties,...f}}async flush(){await Promise.all([this.meterProvider?.forceFlush?.(),this.loggerProvider?.forceFlush?.()])}async dispose(){await Promise.all([this.meterProvider?.shutdown?.(),this.loggerProvider?.shutdown?.()])}emitLog(f,j,$){if(!this.logger)return;let A=this.flattenProperties(this.buildAttributes(j,$));this.logger.emit({severityText:"INFO",body:f,attributes:A})}buildAttributes(f,j=!1){return{...this.commonProperties,...this.metadata,...f,...this.distinctId?{distinct_id:this.distinctId}:{},...j?{_required:!0}:{}}}snapshotGaugeSeries(f){let j=this.gaugeValues.get(f);if(!j)return[];return Array.from(j.values(),($)=>({value:$.value,attributes:$.attributes?{...$.attributes}:void 0}))}flattenProperties(f,j="",$=new WeakSet,A=0){if(!f)return{};let J={},W=100,H=10;for(let[X,O]of Object.entries(f)){if(X==="__proto__"||X==="constructor"||X==="prototype")continue;let Z=j?`${j}.${X}`:X;if(O===null||O===void 0){J[Z]=String(O);continue}if(Array.isArray(O)){let Q=O.length>W?O.slice(0,W):O;try{J[Z]=JSON.stringify(Q)}catch{J[Z]="[UnserializableArray]"}if(O.length>W)J[`${Z}_truncated`]=!0,J[`${Z}_original_length`]=O.length;continue}if(typeof O==="object"){if(O instanceof Date){J[Z]=O.toISOString();continue}if(O instanceof Error){J[Z]=O.message;continue}if($.has(O)){J[Z]="[Circular]";continue}if(A>=H){J[Z]="[MaxDepthExceeded]";continue}$.add(O),Object.assign(J,this.flattenProperties(O,Z,$,A+1));continue}if(s(O)){J[Z]=O;continue}try{J[Z]=JSON.stringify(O)}catch{J[Z]=String(O)}}return J}}function s(f){return typeof f==="string"||typeof f==="number"||typeof f==="boolean"}import{LangfuseAttributesSpanProcessor as Xf}from"@cerebriline/llms";import{markOtlpTraceRelayProvider as Zf}from"@cerebriline/shared";import{metrics as Kf,trace as Pf}from"@opentelemetry/api";import{logs as Qf}from"@opentelemetry/api-logs";import{OTLPLogExporter as Tf}from"@opentelemetry/exporter-logs-otlp-http";import{OTLPMetricExporter as Yf}from"@opentelemetry/exporter-metrics-otlp-http";import{OTLPTraceExporter as Bf}from"@opentelemetry/exporter-trace-otlp-http";import{resourceFromAttributes as Ff}from"@opentelemetry/resources";import{BatchLogRecordProcessor as Vf,ConsoleLogRecordExporter as Rf,LoggerProvider as Uf}from"@opentelemetry/sdk-logs";import{ConsoleMetricExporter as Lf,MeterProvider as kf,PeriodicExportingMetricReader as G}from"@opentelemetry/sdk-metrics";import{BatchSpanProcessor as Cf,ConsoleSpanExporter as _f,SimpleSpanProcessor as Mf}from"@opentelemetry/sdk-trace-base";import{NodeTracerProvider as wf}from"@opentelemetry/sdk-trace-node";import{ATTR_SERVICE_NAME as qf,ATTR_SERVICE_VERSION as hf}from"@opentelemetry/semantic-conventions";import{mkdirSync as f0,readFileSync as i,statSync as o,writeFileSync as j0}from"node:fs";import{CONFIGURABLE_MODEL_TOOL_NAMES as t}from"@cerebriline/shared";import{resolveGlobalSettingsPath as e}from"@cerebriline/shared/storage";import{z as K}from"zod";import{AGENT_UNEXPECTED_REASONING_TOKENS_EVENT as uf,captureAgentUnexpectedReasoningTokens as cf,captureTaskLifecycleEvent as mf,SDK_ERROR_TELEMETRY_EVENT as df,TASK_CANCELLED_EVENT as lf,TASK_FIRST_CHUNK_RECEIVED_EVENT as pf,TASK_MAX_TOKENS_RECOVERY_EVENT as rf,TASK_PROVIDER_REQUEST_STARTED_EVENT as af,TASK_PROVIDER_STREAM_FAILED_EVENT as nf,TASK_PROVIDER_STREAM_STARTED_EVENT as sf}from"@cerebriline/shared";var U=K.preprocess((f)=>Array.isArray(f)?f.filter((j)=>typeof j==="string").map((j)=>j.trim()).filter(Boolean):void 0,K.array(K.string()).optional()).transform((f)=>{if(!f)return;let j=[...new Set(f)].sort(($,A)=>$.localeCompare(A));return j.length>0?j:void 0}),ff=K.enum(["basic","agentic"]).catch("agentic"),jf=K.partialRecord(K.enum(t),K.object({enabled:K.boolean()}).strip()).optional(),$f=K.record(K.string(),K.object({enabled:K.boolean()}).strip()).optional().catch(void 0),Af=K.enum(["plan","act"]),D=K.object({telemetryOptOut:K.boolean().default(!1).catch(!1),autoUpdateEnabled:K.boolean().default(!0).catch(!0),compactionStrategy:ff.optional(),compactionEnabled:K.boolean().optional().catch(void 0),planActMode:Af.optional().catch(void 0),toolAutoApprove:K.boolean().optional().catch(void 0),tuiTheme:K.string().optional().catch(void 0),disabledTools:U.optional(),tools:jf,disabledPlugins:U.optional(),disabledAgentPlugins:U.optional(),bundledSkills:$f}).strip().transform((f)=>{let j={autoUpdateEnabled:f.autoUpdateEnabled,telemetryOptOut:f.telemetryOptOut};if(f.compactionStrategy)j.compactionStrategy=f.compactionStrategy;if(f.compactionEnabled!==void 0)j.compactionEnabled=f.compactionEnabled;if(f.planActMode)j.planActMode=f.planActMode;if(f.toolAutoApprove!==void 0)j.toolAutoApprove=f.toolAutoApprove;if(f.tuiTheme?.trim())j.tuiTheme=f.tuiTheme.trim();if(f.disabledTools?.length)j.disabledTools=f.disabledTools;if(f.tools&&Object.keys(f.tools).length>0)j.tools=f.tools;if(f.disabledPlugins?.length)j.disabledPlugins=f.disabledPlugins;if(f.disabledAgentPlugins?.length)j.disabledAgentPlugins=f.disabledAgentPlugins;if(f.bundledSkills&&Object.keys(f.bundledSkills).length>0)j.bundledSkills=f.bundledSkills;return j});function F(){return D.parse({})}var L;function Jf(f){if(f.disabledTools)Object.freeze(f.disabledTools);if(f.tools){for(let j of Object.values(f.tools))Object.freeze(j);Object.freeze(f.tools)}if(f.disabledPlugins)Object.freeze(f.disabledPlugins);if(f.disabledAgentPlugins)Object.freeze(f.disabledAgentPlugins);return Object.freeze(f)}function Hf(f){let j;try{j=i(f,"utf8")}catch{return{value:F(),loadFailed:!0}}try{let $=D.safeParse(JSON.parse(j));return $.success?{value:$.data,loadFailed:!1}:{value:F(),loadFailed:!0}}catch{return{value:F(),loadFailed:!0}}}function Wf(){let f=e(),j=o(f,{throwIfNoEntry:!1}),$=j?.mtimeMs??0,A=j?.size??0,J=L;if(J&&J.path===f&&J.mtimeMs===$&&J.size===A)return J;let W=j?Hf(f):{value:F(),loadFailed:!1},H=Jf(W.value);return L={path:f,mtimeMs:$,size:A,value:H,loadFailed:W.loadFailed},L}function Of(){return Wf().value}function I(){return Of().telemetryOptOut}class k{name;logger;enabled;constructor(f={}){this.name=f.name??"TelemetryLoggerSink",this.logger=f.logger,this.enabled=f.enabled??!0}emit(f,j){if(!this.isEnabled())return;this.logger?.log("telemetry.event",{telemetrySink:this.name,event:f,properties:j})}emitRequired(f,j){this.logger?.log("telemetry.required_event",{telemetrySink:this.name,severity:"warn",event:f,properties:j})}recordCounter(f,j,$,A,J){if(!J&&!this.isEnabled())return;this.logger?.debug("telemetry.metric",{telemetrySink:this.name,instrument:"counter",name:f,value:j,attributes:$,description:A,required:J===!0})}recordHistogram(f,j,$,A,J){if(!J&&!this.isEnabled())return;this.logger?.debug("telemetry.metric",{telemetrySink:this.name,instrument:"histogram",name:f,value:j,attributes:$,description:A,required:J===!0})}recordGauge(f,j,$,A,J){if(!J&&!this.isEnabled())return;this.logger?.debug("telemetry.metric",{telemetrySink:this.name,instrument:"gauge",name:f,value:j,attributes:$,description:A,required:J===!0})}isEnabled(){return typeof this.enabled==="function"?this.enabled():this.enabled}async flush(){}async dispose(){}}class V{adapters;metadata;distinctId;deviceId;commonProperties;constructor(f={}){if(this.adapters=[...f.adapters??[]],f.logger)this.adapters.push(new k({logger:f.logger}));this.metadata={...f.metadata??{}},this.distinctId=f.distinctId,this.deviceId=f.deviceId??R(),this.commonProperties={...f.commonProperties??{}}}addAdapter(f){this.adapters.push(f)}setDistinctId(f){this.distinctId=f}setMetadata(f){this.metadata={...f}}updateMetadata(f){this.metadata={...this.metadata,...f}}setCommonProperties(f){this.commonProperties={...f}}updateCommonProperties(f){this.commonProperties={...this.commonProperties,...f}}isEnabled(){return this.adapters.some((f)=>f.isEnabled())}capture(f){let j=this.buildAttributes(f.properties);for(let $ of this.adapters)$.emit(f.event,j)}captureRequired(f,j){let $=this.buildAttributes(j);for(let A of this.adapters)A.emitRequired(f,$)}recordCounter(f,j,$,A,J=!1){let W=this.buildAttributes($);for(let H of this.adapters)H.recordCounter(f,j,W,A,J)}recordHistogram(f,j,$,A,J=!1){let W=this.buildAttributes($);for(let H of this.adapters)H.recordHistogram(f,j,W,A,J)}recordGauge(f,j,$,A,J=!1){let W=this.buildAttributes($);for(let H of this.adapters)H.recordGauge(f,j,W,A,J)}async flush(){await Promise.all(this.adapters.map((f)=>f.flush()))}async dispose(){await Promise.all(this.adapters.map((f)=>f.dispose()))}buildAttributes(f){let j=typeof f?.distinct_id==="string"&&f.distinct_id.trim()?f.distinct_id.trim():this.distinctId,$={...this.commonProperties,...this.metadata,...f,...j?{distinct_id:j}:{},device_id:this.deviceId};return Object.fromEntries(Object.entries($).filter(([,A])=>A!==void 0))}}class x{distinctId;metadata;commonProperties;constructor(f={}){this.distinctId=f.distinctId,this.metadata={...f.metadata??{}},this.commonProperties={...f.commonProperties??{}}}setDistinctId(f){this.distinctId=f}setMetadata(f){this.metadata={...f}}updateMetadata(f){this.metadata={...this.metadata,...f}}setCommonProperties(f){this.commonProperties={...f}}updateCommonProperties(f){this.commonProperties={...this.commonProperties,...f}}isEnabled(){return!1}capture(f){this.resolveProperties(f.properties)}captureRequired(f,j){this.resolveProperties(j)}recordCounter(){}recordHistogram(){}recordGauge(){}async flush(){}async dispose(){}resolveProperties(f){let j=typeof f?.distinct_id==="string"&&f.distinct_id.trim()?f.distinct_id.trim():this.distinctId,$={...this.commonProperties,...this.metadata,...f,...j?{distinct_id:j}:{}};return Object.fromEntries(Object.entries($).filter(([,A])=>A!==void 0))}}class _{meterProvider;loggerProvider;tracerProvider;options;constructor(f={}){this.options=f;let j=Ff({[qf]:f.serviceName??"cline",...f.serviceVersion?{[hf]:f.serviceVersion}:{}});if(this.meterProvider=this.createMeterProvider(j),this.loggerProvider=this.createLoggerProvider(j),this.tracerProvider=this.createTracerProvider(j),this.meterProvider)Kf.setGlobalMeterProvider(this.meterProvider);if(this.loggerProvider)Qf.setGlobalLoggerProvider(this.loggerProvider);if(this.tracerProvider)this.tracerProvider.register()}getTracer(f="cline",j){return Pf.getTracer(f,j??this.options.serviceVersion)}createAdapter(f){return new B({...f,meterProvider:this.meterProvider,loggerProvider:this.loggerProvider})}createTelemetryService(f){let j=this.createAdapter({name:f.name,enabled:this.options.enabled,metadata:f.metadata});return new V({...f,adapters:[j],distinctId:Y(f.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(f){let j=C(this.options.metricsExporter);if(j.length===0)return null;let $=Math.max(1000,this.options.metricExportIntervalMs??this.options.metricExportInterval??60000),A=Math.min(30000,Math.floor($*0.8)),J=j.map((W)=>If(W,{endpoint:this.options.otlpEndpoint,headers:this.options.otlpHeaders,insecure:this.options.otlpInsecure??!1,protocol:"http/json",interval:$,timeout:A})).filter((W)=>W!==null);if(J.length===0)return null;return new kf({resource:f,readers:J})}createTracerProvider(f){let j=C(this.options.tracesExporter);if(j.length===0)return null;let $=this.options.otlpTracesEndpoint??this.options.otlpEndpoint,A=this.options.otlpTracesHeaders??this.options.otlpHeaders,J=[],W=!1;for(let X of j){let O=Df(X,{endpoint:$,headers:A,insecure:this.options.otlpInsecure??!1,protocol:"http/json"});if(O){if(J.push(O),X!=="console")W=!0}}if(J.length===0)return null;let H=new wf({resource:f,spanProcessors:W?[new Xf,...J]:J});if(W)Zf(H);return H}createLoggerProvider(f){let j=C(this.options.logsExporter);if(j.length===0)return null;let $=j.map((A)=>{let J=zf(A,{endpoint:this.options.otlpEndpoint,headers:this.options.otlpHeaders,insecure:this.options.otlpInsecure??!1,protocol:"http/json"});if(!J)return null;return new Vf(J,{maxQueueSize:this.options.logMaxQueueSize??2048,maxExportBatchSize:this.options.logBatchSize??512,scheduledDelayMillis:this.options.logBatchTimeoutMs??this.options.logBatchTimeout??5000})}).filter((A)=>A!==null);if($.length===0)return null;return new Uf({resource:f,processors:$})}}function N(f){let j=new _(f),$=j.createTelemetryService(f),A=()=>{$.captureRequired("telemetry.provider_created",{provider:"opentelemetry",enabled:f.enabled??!0,logsExporter:Array.isArray(f.logsExporter)?f.logsExporter.join(","):f.logsExporter,metricsExporter:Array.isArray(f.metricsExporter)?f.metricsExporter.join(","):f.metricsExporter,tracesExporter:Array.isArray(f.tracesExporter)?f.tracesExporter.join(","):f.tracesExporter,otlpProtocol:f.otlpProtocol,hasOtlpEndpoint:Boolean(f.otlpEndpoint),serviceName:f.serviceName,serviceVersion:f.serviceVersion})};if(!f.deferProviderCreatedEvent)A();return{provider:j,telemetry:$,emitProviderCreated:A}}function y(f){if(I())return{telemetry:new x(f)};if(f.enabled!==!0)return{telemetry:new V({...f,distinctId:Y(f.distinctId)})};return N(f)}function Ef(f){let{telemetry:j,provider:$,emitProviderCreated:A}=y(f);return{telemetry:j,provider:$,flush:async()=>{let H=$;if(H&&typeof H.forceFlush==="function")try{await H.forceFlush()}catch{}},dispose:async()=>{await Promise.allSettled([j.dispose(),$?.dispose()])},...f.deferProviderCreatedEvent&&A?{emitProviderCreated:A}:{}}}function C(f){if(!f)return[];return(Array.isArray(f)?f:f.split(",")).map(($)=>$.trim()).filter(($)=>$==="console"||$==="otlp")}function zf(f,j){if(f==="console")return new Rf;if(!j.endpoint)return null;let $=M(j.endpoint,"/v1/logs");return new Tf({url:$,headers:j.headers})}function Df(f,j){if(f==="console")return new Mf(new _f);if(!j.endpoint)return null;let $=M(j.endpoint,"/v1/traces");return new Cf(new Bf({url:$,headers:j.headers}))}function If(f,j){if(f==="console")return new G({exporter:new Lf,exportIntervalMillis:j.interval,exportTimeoutMillis:j.timeout});if(!j.endpoint)return null;let $=M(j.endpoint,"/v1/metrics");return new G({exporter:new Yf({url:$,headers:j.headers}),exportIntervalMillis:j.interval,exportTimeoutMillis:j.timeout})}function M(f,j){let $=new URL(f),A=$.pathname.endsWith("/")?$.pathname.slice(0,-1):$.pathname;return $.pathname=A.endsWith(j)?A:`${A}${j}`,$.toString()}import{SESSION_STATUS_VALUES as D0}from"@cerebriline/shared";var T={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 b(f){let j=[f?.name,f?.platform].filter(($)=>typeof $==="string").join(" ").toLowerCase();if(!j)return;if(j.includes("vscode")||j.includes("visual studio code"))return T.VSCODE;if(j.includes("jetbrains")||j.includes("webstorm")||j.includes("intellij")||j.includes("pycharm")||j.includes("goland")||j.includes("clion")||j.includes("rider")||j.includes("android studio"))return T.JETBRAINS;if(j.includes("neovim"))return T.NEOVIM;if(j.includes("kanban"))return T.KANBAN;if(j.includes("desktop"))return T.DESKTOP;if(j.includes("cline-platform"))return T.WEB;if(j.includes("cline-cli")||j.includes("cline-acp"))return T.CLI;if(j.includes("cline-sdk")||j.includes("cline-core"))return T.CORE;return}function P(f){let j=f?.trim();return j?j:void 0}function S(f){let j=f.client,$=b(j)??P(f.source),A=P(j.version),J=P(j.platform)??P(j.name),W=P(j.platformVersion)??A,H={cline_type:$,extension_version:A,platform:J,platform_version:W};if(f.user?.accountId===void 0)return H;let X=typeof f.user.accountId==="string"?P(f.user.accountId):void 0;return{...H,distinct_id:X??P(f.user.distinctId),user_id:X,account_id:X,account_email:X?P(f.user.email):void 0,organization_id:X?P(f.user.organizationId):void 0}}function v(f,j){let $={},A={},J,W=(H)=>({...j,...A,...$,...H,...J?{distinct_id:J}:{}});return{setDistinctId(H){J=P(H)},setMetadata(H){$={...H}},updateMetadata(H){$={...$,...H}},setCommonProperties(H){A={...H}},updateCommonProperties(H){A={...A,...H}},isEnabled:()=>f.isEnabled(),capture:(H)=>f.capture({event:H.event,properties:W(H.properties)}),captureRequired:(H,X)=>f.captureRequired(H,W(X)),recordCounter:(H,X,O,Z,Q)=>f.recordCounter(H,X,W(O),Z,Q),recordHistogram:(H,X,O,Z,Q)=>f.recordHistogram(H,X,W(O),Z,Q),recordGauge:(H,X,O,Z,Q)=>f.recordGauge(H,X,W(O),Z,Q),flush:()=>f.flush(),dispose:async()=>{}}}function Gf(f,j){return v(f,S(j))}export{Y as resolveCoreDistinctId,R as resolveCoreDeviceId,S as resolveClientTelemetryProperties,v as createScopedTelemetryService,N as createOpenTelemetryTelemetryService,y as createConfiguredTelemetryService,Ef as createConfiguredTelemetryHandle,Gf as createClientScopedTelemetryService,_ as OpenTelemetryProvider,B as OpenTelemetryAdapter};

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

@@ -0,0 +1,31 @@
+import type { ClientContext, ITelemetryService, TelemetryProperties, UserContext } from "@cerebriline/shared";
+/**
+ * Client identity that can safely cross a runtime boundary and be attached to
+ * telemetry emitted by the process that actually executes a session.
+ */
+export interface ClientTelemetryContext {
+    client: ClientContext;
+    source?: string;
+    user?: UserContext;
+}
+/**
+ * Converts the shared client context into the established cross-surface
+ * analytics dimensions. Event-specific fields still take precedence.
+ */
+export declare function resolveClientTelemetryProperties(context: ClientTelemetryContext): TelemetryProperties;
+/**
+ * A non-owning view over a host telemetry service. It adds immutable
+ * per-session properties without mutating the host singleton, which is
+ * essential for a Hub process that can execute sessions from several clients
+ * concurrently.
+ *
+ * The returned view never disposes the parent. The process that created the
+ * parent telemetry service remains responsible for its lifecycle.
+ */
+export declare function createScopedTelemetryService(parent: ITelemetryService, properties: TelemetryProperties): ITelemetryService;
+/**
+ * Scopes a host telemetry singleton to one runtime client. This is the
+ * reusable bridge used by Hub-hosted sessions; local clients that already
+ * provide their own telemetry service do not need it.
+ */
+export declare function createClientScopedTelemetryService(parent: ITelemetryService, context: ClientTelemetryContext): ITelemetryService;

package/dist/services/workspace/workspace-manifest.d.ts

@@ -1,4 +1,38 @@
 import type { WorkspaceInfo } from "@cerebriline/shared";
+export type GitCommand = (args: readonly string[], options: {
+    cwd: string;
+    signal?: AbortSignal;
+}) => Promise<{
+    stdout: string;
+    stderr?: string;
+}>;
+export declare function gitCommandErrorMessage(error: unknown): string;
+export declare function gitCommandExitCode(error: unknown): number | undefined;
+/**
+ * Shared Git queries, without metadata fallback or cloud-handoff policy.
+ * Display branches retain simple-git's detached/unborn semantics; symbolic
+ * branches are strict and preserve Git exit codes for callers that require one.
+ * Commands are lazy so metadata reads never collect status or contact a remote.
+ * Structured display queries use simple-git; raw queries use the injectable
+ * runner to retain exit codes, timeouts, and cancellation for strict checks.
+ */
+export declare function createWorkspaceGitReader(input: {
+    cwd: string;
+    git?: GitCommand;
+    signal?: AbortSignal;
+}): {
+    isInsideWorkTree(): Promise<boolean>;
+    remotes: () => import("simple-git").Response<import("simple-git").RemoteWithRefs[]>;
+    displayBranch: () => Promise<string>;
+    symbolicBranch: () => Promise<string>;
+    headSha: () => Promise<string>;
+    workspacePrefix: () => Promise<string>;
+    worktreeStatus: () => Promise<string>;
+    branchRemote: (branch: string) => Promise<string>;
+    branchMergeRef: (branch: string) => Promise<string>;
+    remoteUrl: (remote: string) => Promise<string>;
+    remoteRefs: (remote: string, ref: string) => Promise<string>;
+};
 export interface WorkspaceInfoDiagnostics {
     info: WorkspaceInfo;
     vcsType: "git" | "none";

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

@@ -2,6 +2,11 @@ import type { ITelemetryService, WorkspaceInfo } from "@cerebriline/shared";
 export interface WorkspaceLifecycleTelemetryInput {
     telemetry?: ITelemetryService;
     rootPath: string;
+    /**
+     * Optional client identity used for de-duplication in a shared runtime
+     * process. The same workspace still emits once per client surface.
+     */
+    dedupeScope?: string;
     workspaceInfo?: WorkspaceInfo;
     rootCount?: number;
     vcsType?: "git" | "none";

package/dist/session/fork-metadata.d.ts

@@ -0,0 +1,7 @@
+export declare function createForkSessionMetadata(input: {
+    metadata?: Record<string, unknown> | null;
+    forkedFromSessionId: string;
+    forkedAt: string;
+    source: string;
+    beforeRunCount?: number;
+}): Record<string, unknown>;

package/dist/session/models/session-compaction.d.ts

@@ -18,5 +18,12 @@ export declare function createSessionCompactionState(input: {
     systemPrompt?: string;
     updatedAt?: string;
 }): SessionCompactionState;
-export declare function projectSessionCompactionState(state: SessionCompactionState, sourceMessages: readonly MessageWithMetadata[]): MessageWithMetadata[] | undefined;
+export declare function projectSessionCompactionState(state: SessionCompactionState, sourceMessages: readonly MessageWithMetadata[], 
+/**
+ * The same transcript as it is about to be sent, when a stage ahead of
+ * compaction rewrote a message in it. The state is matched against
+ * `sourceMessages`; the tail that follows the compacted part is taken from
+ * here, so the rewrite is not undone by the projection.
+ */
+tailMessages?: readonly MessageWithMetadata[]): MessageWithMetadata[] | undefined;
 export declare function parseSessionCompactionState(value: unknown): SessionCompactionState | undefined;

package/dist/session/services/message-builder.d.ts

@@ -8,7 +8,7 @@
  * tool-result truncation and outdated-file-content rewrite for compaction.
  * Per-instance caches make this host state.
  */
-import { type MediaBudgetOptions, type Message } from "@cerebriline/shared";
+import { type MediaBudgetOptions, type Message, type ToolResultContent } from "@cerebriline/shared";
 export declare const DEFAULT_MAX_TOOL_RESULT_CHARS = 32000;
 export declare const DEFAULT_MAX_FILE_CONTENT_CHARS = 50000;
 export declare const DEFAULT_MAX_TOTAL_TEXT_BYTES = 6000000;
@@ -49,6 +49,10 @@ export declare const MESSAGE_BUILDER_LIMIT_ENV: {
     readonly minOutdatedRewriteBytes: "CLINE_MESSAGE_BUILDER_MIN_OUTDATED_REWRITE_BYTES";
 };
 export interface MessageBuilderOptions {
+    /** Synchronous Core-owned recovery lookup; undefined leaves the normal result projection unchanged. */
+    getToolResultRecovery?: (result: ToolResultContent) => {
+        uri?: string;
+    } | undefined;
     maxToolResultChars?: number;
     maxFileContentChars?: number;
     maxTotalTextBytes?: number;
@@ -67,6 +71,9 @@ export declare function getMessageBuilderOptionsFromEnv(env?: Record<string, str
  * Builds an API-safe message copy without mutating original conversation history.
  */
 export declare class MessageBuilder {
+    private readonly recoveryNotices;
+    private readonly getToolResultRecovery?;
+    private recoveryNoticeBytes;
     private indexedMessageCount;
     private indexedTailRef;
     private readonly toolNameByIdCache;

package/dist/session/services/persistence-service.d.ts

@@ -52,6 +52,7 @@ export declare class UnifiedSessionPersistenceService {
         title?: string | null;
     }): Promise<{
         updated: boolean;
+        metadata?: Record<string, unknown> | null;
     }>;
     queueSpawnRequest(event: HookEventPayload): Promise<void>;
     upsertSubagentSession(input: import("../models/session-row").UpsertSubagentInput): Promise<string | undefined>;
@@ -73,7 +74,9 @@ export declare class UnifiedSessionPersistenceService {
     handleSubAgentEnd(rootSessionId: string, context: SubAgentEndContext): Promise<void>;
     private isPidAlive;
     private reconcileDeadRunningSession;
-    listSessions(limit?: number): Promise<SessionRow[]>;
+    listSessions(limit?: number, options?: {
+        rootOnly?: boolean;
+    }): Promise<SessionRow[]>;
     /**
      * Lightweight, effectively unbounded listing of session ids + metadata
      * (no manifest reads, no dead-session reconciliation). listSessions caps

package/dist/session/services/tool-result-cache.d.ts

@@ -0,0 +1,30 @@
+import type { ImageContent } from "@cerebriline/shared";
+export declare const TOOL_RESULT_CACHE_MAX_BYTES: number;
+export declare const TOOL_RESULT_CACHE_IDLE_ITERATIONS = 5;
+export declare const TOOL_RESULT_CACHE_MISS = "Cache not found. Make a new tool call for the latest result again if needed. DO NOT repeat side-effecting actions to recover output.";
+/** Session-owned volatile text cache. Looking up a URI never extends its lifetime. */
+export declare class ToolResultCache {
+    private readonly sessionId;
+    private readonly maxBytes;
+    private readonly entries;
+    private readonly referencesByToolCall;
+    private iteration;
+    private bytes;
+    constructor(sessionId: string, maxBytes?: number);
+    store(toolCallId: string, text: string): string | undefined;
+    uriFor(toolCallId: string): string | undefined;
+    read(uri: string): string;
+    advanceIteration(): void;
+    clear(): void;
+    private remove;
+}
+/** Size and truncate the persisted representation sent to the model. */
+export declare function prepareToolResultPreview(content: unknown): {
+    text: string | undefined;
+    images: ImageContent[];
+};
+/** YAML is only the readable recovery copy, not the truncation threshold. */
+export declare function prepareToolResultRecovery(output: unknown): {
+    text: string | undefined;
+    images: ImageContent[];
+};

package/dist/session/session-versioning-service.d.ts

@@ -1,4 +1,5 @@
 import type * as LlmsProviders from "@cerebriline/llms";
+import type { ITelemetryService } from "@cerebriline/shared";
 import type { CheckpointEntry, CheckpointMetadata } from "../hooks/checkpoint-hooks";
 import type { RestoreSessionInput } from "../runtime/host/runtime-host";
 import type { SessionRecord } from "../types/sessions";
@@ -44,6 +45,13 @@ export interface SessionCheckpointRestoreInput<TRestoreStartInput, TStartInput,
     applyWorkspaceCheckpoint?: (cwd: string, checkpoint: CheckpointEntry) => Promise<void>;
     beginWorkspaceRestoreTransaction?: (cwd: string) => Promise<WorktreeRestoreTransaction>;
     retainCheckpointRefs?: (cwd: string, sessionId: string, history: CheckpointEntry[]) => Promise<void>;
+    /**
+     * Emits one `checkpoint.restore` event per restore attempt. Restores are
+     * rare and destructive, so field visibility matters: outcome, duration
+     * (the worktree transaction hashes all untracked files), and the
+     * checkpoint kind. Never file paths or contents.
+     */
+    telemetry?: Pick<ITelemetryService, "capture">;
 }
 export declare class SessionVersioningService {
     restoreCheckpoint<TRestoreStartInput, TStartInput, TStartResult>(input: SessionCheckpointRestoreInput<TRestoreStartInput, TStartInput, TStartResult>): Promise<SessionCheckpointRestoreResult<TStartResult>>;

package/dist/session/stores/session-manifest-store.d.ts

@@ -31,12 +31,10 @@ export declare class SessionManifestStore {
         path: string;
         manifest?: SessionManifest;
     };
+    readSessionRowFromManifest(sessionId: string): SessionRow | undefined;
     /**
      * Resolve the session row backing a message write, re-adopting it from the
-     * on-disk manifest when the DB row is missing (session artifacts restored
-     * or copied while the session DB was rebuilt). Sessions with neither a row
-     * nor a manifest throw so message writes cannot silently recreate
-     * orphaned session files.
+     * on-disk manifest when the index was rebuilt or the artifacts were restored.
      */
     private resolveSessionRow;
     persistSessionMessages(sessionId: string, messages: LlmsProviders.MessageWithMetadata[], systemPrompt?: string): Promise<void>;