@clinebot/core 0.0.37 → 0.0.38

package/dist/services/providers/local-provider-registry.d.ts

@@ -6,11 +6,11 @@ export declare const StoredModelEntrySchema: z.ZodObject<{
     id: z.ZodOptional<z.ZodString>;
     name: z.ZodOptional<z.ZodString>;
     capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        reasoning: "reasoning";
-        tools: "tools";
         images: "images";
+        tools: "tools";
         streaming: "streaming";
         "prompt-cache": "prompt-cache";
+        reasoning: "reasoning";
         "reasoning-effort": "reasoning-effort";
         "computer-use": "computer-use";
         "global-endpoint": "global-endpoint";
@@ -49,10 +49,10 @@ export declare const StoredProviderMetadataSchema: z.ZodObject<{
         vertex: "vertex";
     }>>;
     capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        reasoning: "reasoning";
         tools: "tools";
         streaming: "streaming";
         "prompt-cache": "prompt-cache";
+        reasoning: "reasoning";
         "computer-use": "computer-use";
         temperature: "temperature";
         files: "files";
@@ -90,10 +90,10 @@ export declare const StoredProviderEntrySchema: z.ZodObject<{
             vertex: "vertex";
         }>>;
         capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-            reasoning: "reasoning";
             tools: "tools";
             streaming: "streaming";
             "prompt-cache": "prompt-cache";
+            reasoning: "reasoning";
             "computer-use": "computer-use";
             temperature: "temperature";
             files: "files";
@@ -108,11 +108,11 @@ export declare const StoredProviderEntrySchema: z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
         name: z.ZodOptional<z.ZodString>;
         capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-            reasoning: "reasoning";
-            tools: "tools";
             images: "images";
+            tools: "tools";
             streaming: "streaming";
             "prompt-cache": "prompt-cache";
+            reasoning: "reasoning";
             "reasoning-effort": "reasoning-effort";
             "computer-use": "computer-use";
             "global-endpoint": "global-endpoint";
@@ -155,10 +155,10 @@ export declare const StoredModelsFileSchema: z.ZodObject<{
                 vertex: "vertex";
             }>>;
             capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-                reasoning: "reasoning";
                 tools: "tools";
                 streaming: "streaming";
                 "prompt-cache": "prompt-cache";
+                reasoning: "reasoning";
                 "computer-use": "computer-use";
                 temperature: "temperature";
                 files: "files";
@@ -173,11 +173,11 @@ export declare const StoredModelsFileSchema: z.ZodObject<{
             id: z.ZodOptional<z.ZodString>;
             name: z.ZodOptional<z.ZodString>;
             capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-                reasoning: "reasoning";
-                tools: "tools";
                 images: "images";
+                tools: "tools";
                 streaming: "streaming";
                 "prompt-cache": "prompt-cache";
+                reasoning: "reasoning";
                 "reasoning-effort": "reasoning-effort";
                 "computer-use": "computer-use";
                 "global-endpoint": "global-endpoint";
@@ -216,4 +216,3 @@ export declare function registerConfiguredProvidersFromSettings(state: StoredPro
 export declare function registerCustomProvider(providerId: string, entry: StoredProviderEntry): void;
 export declare function ensureCustomProvidersLoadedSync(manager: ProviderSettingsManager): void;
 export declare function ensureCustomProvidersLoaded(manager: ProviderSettingsManager): Promise<void>;
-//# sourceMappingURL=local-provider-registry.d.ts.map

package/dist/services/providers/local-provider-service.d.ts

@@ -1,5 +1,5 @@
-import type { AddProviderActionRequest, OAuthProviderId, ProviderCapability, ProviderListItem, ProviderModel, SaveProviderSettingsActionRequest } from "@clinebot/shared";
-import type { ProviderClient, ProviderConfig, ProviderProtocol, ProviderSettings } from "../../llms/provider-settings";
+import { type AddProviderActionRequest, type OAuthProviderId, type ProviderCapability, type ProviderListItem, type ProviderModel, type SaveProviderSettingsActionRequest } from "@clinebot/shared";
+import type { ProviderClient, ProviderConfig, ProviderProtocol, ProviderSettings } from "../../services/llms/provider-settings";
 import type { ProviderSettingsManager } from "../storage/provider-settings-manager";
 export { ensureCustomProvidersLoaded } from "./local-provider-registry";
 export interface UpdateLocalProviderRequest {
@@ -49,6 +49,11 @@ export declare function saveLocalProviderSettings(manager: ProviderSettingsManag
     enabled: boolean;
     settingsPath: string;
 };
+export declare function refreshProviderModelsFromSource(manager: ProviderSettingsManager, providerId: string): Promise<{
+    providerId: string;
+    refreshed: boolean;
+    modelsCount?: number;
+}>;
 export declare function normalizeOAuthProvider(provider: string): OAuthProviderId;
 export declare function loginLocalProvider(providerId: OAuthProviderId, existing: ProviderSettings | undefined, openUrl: (url: string) => void): Promise<{
     access: string;
@@ -63,4 +68,32 @@ export declare function saveLocalProviderOAuthCredentials(manager: ProviderSetti
     accountId?: string;
 }): ProviderSettings;
 export declare function resolveLocalClineAuthToken(settings: ProviderSettings | undefined): string | undefined;
-//# sourceMappingURL=local-provider-service.d.ts.map
+export type ProviderConfigFieldKey = "apiKey" | "baseUrl";
+export interface ProviderConfigFieldRequirement {
+    defaultValue?: string;
+}
+export interface ProviderConfigFields {
+    providerId: string;
+    authMethod: "api-key" | "oauth";
+    fields: Partial<Record<ProviderConfigFieldKey, ProviderConfigFieldRequirement>>;
+}
+/**
+ * Project a provider into the inputs a configure-dialog should render.
+ *
+ * No fields are marked "required" — `llms` no longer pre-flights credentials,
+ * so a missing API key surfaces as the provider's own auth error rather than
+ * a synthetic SDK failure. UIs may still require fields client-side if they
+ * want, but the runtime does not.
+ *
+ * - OAuth providers (`cline`, `oca`, `openai-codex`) return `authMethod:
+ *   "oauth"` with no fields; the configure UI should route to the OAuth
+ *   login flow instead.
+ * - All other providers return `apiKey`. Built-in local/proxy-style providers
+ *   with user-supplied endpoints, plus user-added providers with saved
+ *   endpoints, also return a pre-filled `baseUrl` field.
+ *
+ * Returns the same fallback shape for unknown providers (single `apiKey`
+ * input, no default base URL) so callers can render a reasonable configure
+ * dialog without per-id branches.
+ */
+export declare function getProviderConfigFields(providerId: string): ProviderConfigFields;

package/dist/services/providers/model-source.d.ts

@@ -0,0 +1,3 @@
+export declare function extractModelIdsFromPayload(payload: unknown, providerId: string): string[];
+export declare function fetchModelIdsFromSource(url: string, providerId: string): Promise<string[]>;
+export declare function resolveModelsSourceUrl(baseUrl: string | undefined, defaultBaseUrl: string | undefined, modelsSourceUrl: string | undefined): string | undefined;

package/dist/services/session-artifacts.d.ts

@@ -15,4 +15,3 @@ export declare class SessionArtifacts {
     removeDir(dir: string): void;
     subagentArtifactPaths(sessionId: string, subAgentId: string, activeTeamTaskSessionId?: string): SessionArtifactPaths;
 }
-//# sourceMappingURL=session-artifacts.d.ts.map

package/dist/services/session-data.d.ts

@@ -1,7 +1,7 @@
 import type * as LlmsProviders from "@clinebot/llms";
 import type { AgentConfig, AgentEvent, AgentResult } from "@clinebot/shared";
-import { type SessionManifest } from "../session/session-manifest";
-import type { SessionRow } from "../session/session-row";
+import { type SessionManifest } from "../session/models/session-manifest";
+import type { SessionRow } from "../session/models/session-row";
 import type { SessionStatus } from "../types/common";
 import type { StoredMessageWithMetadata } from "../types/session";
 import type { SessionRecord } from "../types/sessions";
@@ -49,4 +49,3 @@ export declare function buildManifestFromRow(row: SessionRow, overrides?: {
 export declare function withOccRetry<TFetch, TResult>(load: () => Promise<TFetch | undefined>, update: (loaded: TFetch) => Promise<TResult>, maxRetries: number): Promise<TResult | {
     updated: false;
 }>;
-//# sourceMappingURL=session-data.d.ts.map

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

@@ -13,4 +13,3 @@ export declare function captureHookDiscoveryTelemetry(telemetry: ITelemetryServi
     workspacePath: string;
 }): void;
 export declare function emitMentionTelemetry(telemetry: ITelemetryService | undefined, enriched: Awaited<ReturnType<typeof enrichPromptWithMentions>>): void;
-//# sourceMappingURL=session-telemetry.d.ts.map

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

@@ -26,4 +26,3 @@ export declare class FileTeamStore implements TeamStore {
     private historyPath;
     private readEnvelope;
 }
-//# sourceMappingURL=file-team-store.d.ts.map

package/dist/services/storage/provider-settings-legacy-migration.d.ts

@@ -36,4 +36,3 @@ export type LegacyClineUserInfo = {
  */
 export declare function resolveLegacyClineAuth(rawAccountData: string | undefined): ProviderSettings["auth"] | undefined;
 export declare function migrateLegacyProviderSettings(options: MigrateLegacyProviderSettingsOptions): MigrateLegacyProviderSettingsResult;
-//# sourceMappingURL=provider-settings-legacy-migration.d.ts.map

package/dist/services/storage/provider-settings-manager.d.ts

@@ -1,4 +1,4 @@
-import { type ProviderConfig, type ProviderSettings, type ProviderTokenSource, type StoredProviderSettings } from "../../types/provider-settings";
+import { type ProviderConfig, type ProviderSettings, type ProviderTokenSource, type StoredProviderSettings, type ToProviderConfigOptions } from "../../types/provider-settings";
 export interface ProviderSettingsManagerOptions {
     filePath?: string;
     dataDir?: string;
@@ -17,8 +17,7 @@ export declare class ProviderSettingsManager {
     saveProviderSettings(settings: unknown, options?: SaveProviderSettingsOptions): StoredProviderSettings;
     getProviderSettings(providerId: string): ProviderSettings | undefined;
     getLastUsedProviderSettings(): ProviderSettings | undefined;
-    getProviderConfig(providerId: string): ProviderConfig | undefined;
-    getLastUsedProviderConfig(): ProviderConfig | undefined;
+    getProviderConfig(providerId: string, options?: ToProviderConfigOptions): ProviderConfig | undefined;
+    getLastUsedProviderConfig(options?: ToProviderConfigOptions): ProviderConfig | undefined;
     refreshCatalog(): Promise<void>;
 }
-//# sourceMappingURL=provider-settings-manager.d.ts.map

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

@@ -28,4 +28,3 @@ export declare class SqliteSessionStore implements SessionStore {
     list(limit?: number): SessionRecord[];
     delete(sessionId: string, cascade?: boolean): boolean;
 }
-//# sourceMappingURL=sqlite-session-store.d.ts.map

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

@@ -32,4 +32,3 @@ export declare class SqliteTeamStore implements TeamStore {
     markInProgressRunsInterrupted(teamName: string, reason: string): string[];
     handleTeamEvent(teamName: string, event: TeamEvent): void;
 }
-//# sourceMappingURL=sqlite-team-store.d.ts.map

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

@@ -13,4 +13,3 @@ export declare function createLocalTeamStore(options?: SqliteTeamStoreOptions):
     persistRuntime: FileTeamStore["persistRuntime"];
     markInProgressRunsInterrupted: FileTeamStore["markInProgressRunsInterrupted"];
 };
-//# sourceMappingURL=team-store.d.ts.map

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

@@ -52,4 +52,3 @@ export interface ITelemetryAdapter {
     /** Release all resources held by the adapter. */
     dispose(): Promise<void>;
 }
-//# sourceMappingURL=ITelemetryAdapter.d.ts.map

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

@@ -41,4 +41,3 @@ export declare class OpenTelemetryAdapter implements ITelemetryAdapter {
     private snapshotGaugeSeries;
     private flattenProperties;
 }
-//# sourceMappingURL=OpenTelemetryAdapter.d.ts.map

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

@@ -48,5 +48,36 @@ export declare function createConfiguredTelemetryService(options: CreateOpenTele
     provider?: OpenTelemetryProvider;
     telemetry: ITelemetryService;
 };
+/**
+ * Telemetry service plus the lifecycle closures (`flush`, `dispose`) every
+ * host needs to drive the underlying provider during shutdown. Returned by
+ * {@link createConfiguredTelemetryHandle} so detached daemons, the VS Code
+ * extension, and the CLI can share one canonical implementation of the
+ * "best-effort flush; settle dispose" semantics instead of each
+ * re-implementing the same closures.
+ */
+export interface ConfiguredTelemetryHandle {
+    readonly telemetry: ITelemetryService;
+    /**
+     * The underlying OpenTelemetry provider, when telemetry is enabled.
+     * `undefined` when telemetry is disabled or opted out so callers can
+     * detect the inactive case without inspecting `enabled` themselves.
+     */
+    readonly provider?: OpenTelemetryProvider;
+    /**
+     * Best-effort flush of any pending telemetry batches. Errors are
+     * swallowed so callers can `await` this in shutdown paths without
+     * blocking deactivation on a misbehaving exporter.
+     */
+    flush: () => Promise<void>;
+    /** Disposes the telemetry service and its provider concurrently. */
+    dispose: () => Promise<void>;
+}
+/**
+ * Builds a {@link ConfiguredTelemetryHandle} so hosts (CLI, VS Code, hub
+ * daemon) share one canonical flush/dispose implementation. Without a
+ * shared helper each host re-derived the same closures and they tended
+ * to drift; this factory keeps the lifecycle uniform across hosts.
+ */
+export declare function createConfiguredTelemetryHandle(options: CreateOpenTelemetryTelemetryServiceOptions): ConfiguredTelemetryHandle;
 export {};
-//# sourceMappingURL=OpenTelemetryProvider.d.ts.map

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

@@ -25,4 +25,3 @@ export declare class TelemetryLoggerSink implements ITelemetryAdapter {
     flush(): Promise<void>;
     dispose(): Promise<void>;
 }
-//# sourceMappingURL=TelemetryLoggerSink.d.ts.map

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

@@ -32,4 +32,3 @@ export declare class TelemetryService implements ITelemetryService {
     dispose(): Promise<void>;
     private buildAttributes;
 }
-//# sourceMappingURL=TelemetryService.d.ts.map

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

@@ -1,4 +1,4 @@
-import type { ITelemetryService } from "@clinebot/shared";
+import type { ITelemetryService, TelemetryProperties } from "@clinebot/shared";
 export type TelemetryAgentKind = "root" | "subagent" | "team_lead" | "team_teammate";
 export interface TelemetryAgentIdentityProperties {
     agentId: string;
@@ -14,7 +14,7 @@ export interface TelemetryAgentIdentityProperties {
 }
 export declare const CORE_TELEMETRY_EVENTS: {
     readonly CLIENT: {
-        readonly STARTED: "extension.activated";
+        readonly EXTENSION_ACTIVATED: "user.extension_activated";
     };
     readonly SESSION: {
         readonly STARTED: "session.started";
@@ -25,6 +25,7 @@ export declare const CORE_TELEMETRY_EVENTS: {
         readonly AUTH_SUCCEEDED: "user.auth_succeeded";
         readonly AUTH_FAILED: "user.auth_failed";
         readonly AUTH_LOGGED_OUT: "user.auth_logged_out";
+        readonly TELEMETRY_OPT_OUT: "user.opt_out";
     };
     readonly TASK: {
         readonly CREATED: "task.created";
@@ -48,11 +49,41 @@ export declare const CORE_TELEMETRY_EVENTS: {
     readonly HOOKS: {
         readonly DISCOVERY_COMPLETED: "hooks.discovery_completed";
     };
+    readonly WORKSPACE: {
+        readonly INITIALIZED: "workspace.initialized";
+        readonly INIT_ERROR: "workspace.init_error";
+        readonly PATH_RESOLVED: "workspace.path_resolved";
+    };
 };
+export interface WorkspaceInitializedProperties {
+    root_count: number;
+    vcs_types: ReadonlyArray<string>;
+    init_duration_ms?: number;
+    feature_flag_enabled?: boolean;
+    is_remote_workspace?: boolean;
+}
+export interface WorkspaceInitErrorProperties {
+    fallback_to_single_root: boolean;
+    workspace_count?: number;
+}
+export interface WorkspacePathResolvedProperties {
+    ulid: string;
+    context: string;
+    resolution_type: "hint_provided" | "fallback_to_primary" | "cross_workspace_search";
+    hint_type?: "workspace_name" | "workspace_path" | "invalid";
+    resolution_success?: boolean;
+    target_workspace_index?: number;
+    is_multi_root_enabled?: boolean;
+}
+export declare function captureExtensionActivated(telemetry: ITelemetryService | undefined): void;
+export declare function captureWorkspaceInitialized(telemetry: ITelemetryService | undefined, properties: WorkspaceInitializedProperties): void;
+export declare function captureWorkspaceInitError(telemetry: ITelemetryService | undefined, error: Error | string, properties: WorkspaceInitErrorProperties): void;
+export declare function captureWorkspacePathResolved(telemetry: ITelemetryService | undefined, properties: WorkspacePathResolvedProperties): void;
 export declare function captureAuthStarted(telemetry: ITelemetryService | undefined, provider?: string): void;
 export declare function captureAuthSucceeded(telemetry: ITelemetryService | undefined, provider?: string): void;
 export declare function captureAuthFailed(telemetry: ITelemetryService | undefined, provider?: string, errorMessage?: string): void;
 export declare function captureAuthLoggedOut(telemetry: ITelemetryService | undefined, provider?: string, reason?: string): void;
+export declare function captureTelemetryOptOut(telemetry: ITelemetryService | undefined, properties?: TelemetryProperties): void;
 export declare function identifyAccount(telemetry: ITelemetryService | undefined, account: {
     id?: string;
     email?: string;
@@ -71,12 +102,25 @@ export declare function captureTaskRestarted(telemetry: ITelemetryService | unde
     apiProvider?: string;
     openAiCompatibleDomain?: string;
 } & Partial<TelemetryAgentIdentityProperties>): void;
+/**
+ * Distinguishes the trigger that produced a `task.completed` telemetry event.
+ *
+ * - `submit_and_exit`: the assistant explicitly declared completion by
+ *   invoking the canonical completion tool. Parity with original Cline's
+ *   `attempt_completion`-anchored emission.
+ * - `shutdown`: the session lifecycle completed (typically a non-interactive
+ *   single-run that finished without an explicit completion tool). Acts as a
+ *   safety-net so we still report completed runs that never observed
+ *   `submit_and_exit`.
+ */
+export type TaskCompletedSource = "submit_and_exit" | "shutdown";
 export declare function captureTaskCompleted(telemetry: ITelemetryService | undefined, properties: {
     ulid: string;
     provider?: string;
     modelId?: string;
     mode?: string;
     durationMs?: number;
+    source?: TaskCompletedSource;
 } & Partial<TelemetryAgentIdentityProperties>): void;
 export declare function captureConversationTurnEvent(telemetry: ITelemetryService | undefined, properties: {
     ulid: string;
@@ -152,4 +196,3 @@ export declare function captureSubagentExecution(telemetry: ITelemetryService |
     type?: "agent" | "team";
 } & Partial<TelemetryAgentIdentityProperties>): void;
 export declare function captureHookDiscovery(telemetry: ITelemetryService | undefined, hookName: string, globalCount: number, workspaceCount: number): void;
-//# sourceMappingURL=core-events.d.ts.map

package/dist/services/telemetry/distinct-id.d.ts

@@ -1,2 +1 @@
 export declare function resolveCoreDistinctId(explicitDistinctId?: string): string;
-//# sourceMappingURL=distinct-id.d.ts.map

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

@@ -1,4 +1,3 @@
 export type { ITelemetryAdapter, TelemetryArray, TelemetryMetadata, TelemetryObject, TelemetryPrimitive, TelemetryProperties, TelemetryValue, } from "./ITelemetryAdapter";
 export { OpenTelemetryAdapter, type OpenTelemetryAdapterOptions, } from "./OpenTelemetryAdapter";
-export { type CreateOpenTelemetryTelemetryServiceOptions, createConfiguredTelemetryService, createOpenTelemetryTelemetryService, OpenTelemetryProvider, type OpenTelemetryProviderOptions, } from "./OpenTelemetryProvider";
-//# sourceMappingURL=index.d.ts.map
+export { type ConfiguredTelemetryHandle, type CreateOpenTelemetryTelemetryServiceOptions, createConfiguredTelemetryHandle, createConfiguredTelemetryService, createOpenTelemetryTelemetryService, OpenTelemetryProvider, type OpenTelemetryProviderOptions, } from "./OpenTelemetryProvider";

package/dist/services/telemetry/index.js

@@ -0,0 +1 @@
+class u{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,l,a=!1){if(!this.meter||!a&&!this.isEnabled())return;let i=this.counters.get(e);if(!i)i=this.meter.createCounter(e,l?{description:l}:void 0),this.counters.set(e,i);i.add(t,this.flattenProperties(this.buildAttributes(r)))}recordHistogram(e,t,r,l,a=!1){if(!this.meter||!a&&!this.isEnabled())return;let i=this.histograms.get(e);if(!i)i=this.meter.createHistogram(e,l?{description:l}:void 0),this.histograms.set(e,i);i.record(t,this.flattenProperties(this.buildAttributes(r)))}recordGauge(e,t,r,l,a=!1){if(!this.meter||!a&&!this.isEnabled())return;let i=this.buildAttributes(r),s=JSON.stringify(i),g=this.gaugeValues.get(e);if(t===null){if(g){if(g.delete(s),g.size===0)this.gaugeValues.delete(e),this.gauges.delete(e)}return}let d=g;if(!d)d=new Map,this.gaugeValues.set(e,d);if(!this.gauges.has(e)){let n=this.meter.createObservableGauge(e,l?{description:l}:void 0);n.addCallback((m)=>{for(let o of this.snapshotGaugeSeries(e))m.observe(o.value,this.flattenProperties(o.attributes))}),this.gauges.set(e,n)}d.set(s,{value:t,attributes:i})}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 l=this.flattenProperties(this.buildAttributes(t,r));this.logger.emit({severityText:"INFO",body:e,attributes:l})}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,l=0){if(!e)return{};let a={},i=100,s=10;for(let[g,d]of Object.entries(e)){if(g==="__proto__"||g==="constructor"||g==="prototype")continue;let n=t?`${t}.${g}`:g;if(d===null||d===void 0){a[n]=String(d);continue}if(Array.isArray(d)){let m=d.length>i?d.slice(0,i):d;try{a[n]=JSON.stringify(m)}catch{a[n]="[UnserializableArray]"}if(d.length>i)a[`${n}_truncated`]=!0,a[`${n}_original_length`]=d.length;continue}if(typeof d==="object"){if(d instanceof Date){a[n]=d.toISOString();continue}if(d instanceof Error){a[n]=d.message;continue}if(r.has(d)){a[n]="[Circular]";continue}if(l>=s){a[n]="[MaxDepthExceeded]";continue}r.add(d),Object.assign(a,this.flattenProperties(d,n,r,l+1));continue}if(z(d)){a[n]=d;continue}try{a[n]=JSON.stringify(d)}catch{a[n]=String(d)}}return a}}function z(e){return typeof e==="string"||typeof e==="number"||typeof e==="boolean"}import{metrics as M,trace as L}from"@opentelemetry/api";import{logs as C}from"@opentelemetry/api-logs";import{OTLPLogExporter as N}from"@opentelemetry/exporter-logs-otlp-http";import{OTLPMetricExporter as V}from"@opentelemetry/exporter-metrics-otlp-http";import{OTLPTraceExporter as Y}from"@opentelemetry/exporter-trace-otlp-http";import{resourceFromAttributes as R}from"@opentelemetry/resources";import{BatchLogRecordProcessor as _,ConsoleLogRecordExporter as p,LoggerProvider as E}from"@opentelemetry/sdk-logs";import{ConsoleMetricExporter as ee,MeterProvider as te,PeriodicExportingMetricReader as w}from"@opentelemetry/sdk-metrics";import{BatchSpanProcessor as re,ConsoleSpanExporter as ae,SimpleSpanProcessor as le}from"@opentelemetry/sdk-trace-base";import{NodeTracerProvider as ie}from"@opentelemetry/sdk-trace-node";import{ATTR_SERVICE_NAME as de,ATTR_SERVICE_VERSION as ne}from"@opentelemetry/semantic-conventions";import{mkdirSync as ye,readFileSync as J,writeFileSync as ce}from"node:fs";import{resolveGlobalSettingsPath as W}from"@clinebot/shared/storage";import{z as f}from"zod";var v=f.preprocess((e)=>Array.isArray(e)?e.filter((t)=>typeof t==="string").map((t)=>t.trim()).filter(Boolean):void 0,f.array(f.string()).optional()).transform((e)=>{if(!e)return;let t=[...new Set(e)].sort((r,l)=>r.localeCompare(l));return t.length>0?t:void 0}),O=f.object({telemetryOptOut:f.boolean().default(!1).catch(!1),disabledTools:v.optional(),disabledPlugins:v.optional()}).strip().transform((e)=>{let t={telemetryOptOut:e.telemetryOptOut};if(e.disabledTools?.length)t.disabledTools=e.disabledTools;if(e.disabledPlugins?.length)t.disabledPlugins=e.disabledPlugins;return t});function G(){return O.parse({})}function $(){let e=W(),t;try{t=JSON.parse(J(e,"utf8"))}catch{return G()}let r=O.safeParse(t);return r.success?r.data:G()}function S(){return $().telemetryOptOut}import{existsSync as F,mkdirSync as B,readFileSync as I,writeFileSync as K}from"node:fs";import{resolve as U}from"node:path";import{resolveSessionDataDir as Q}from"@clinebot/shared/storage";import{nanoid as X}from"nanoid";import*as Z from"node-machine-id";var k="machine-id";function P(e){let t=e?.trim();if(t)return t;let r=D();if(r)return r;return q()}function x(){let e=Z;return e.machineIdSync??e.default?.machineIdSync}function D(){try{let e=x();if(!e)return;return e().trim()||void 0}catch{return}}function q(){let e=Q(),t=U(e,k);try{if(F(t)){let l=I(t,"utf8").trim();if(l.length>0)return l}}catch{}let r=`cl-${X()}`;try{B(e,{recursive:!0}),K(t,r,"utf8")}catch{}return r}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,l,a){if(!a&&!this.isEnabled())return;this.logger?.debug("telemetry.metric",{telemetrySink:this.name,instrument:"counter",name:e,value:t,attributes:r,description:l,required:a===!0})}recordHistogram(e,t,r,l,a){if(!a&&!this.isEnabled())return;this.logger?.debug("telemetry.metric",{telemetrySink:this.name,instrument:"histogram",name:e,value:t,attributes:r,description:l,required:a===!0})}recordGauge(e,t,r,l,a){if(!a&&!this.isEnabled())return;this.logger?.debug("telemetry.metric",{telemetrySink:this.name,instrument:"gauge",name:e,value:t,attributes:r,description:l,required:a===!0})}isEnabled(){return typeof this.enabled==="function"?this.enabled():this.enabled}async flush(){}async dispose(){}}class b{adapters;metadata;distinctId;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.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 l of this.adapters)l.emitRequired(e,r)}recordCounter(e,t,r,l,a=!1){let i=this.buildAttributes(r);for(let s of this.adapters)s.recordCounter(e,t,i,l,a)}recordHistogram(e,t,r,l,a=!1){let i=this.buildAttributes(r);for(let s of this.adapters)s.recordHistogram(e,t,i,l,a)}recordGauge(e,t,r,l,a=!1){let i=this.buildAttributes(r);for(let s of this.adapters)s.recordGauge(e,t,i,l,a)}async flush(){await Promise.all(this.adapters.map((e)=>e.flush()))}async dispose(){await Promise.all(this.adapters.map((e)=>e.dispose()))}buildAttributes(e){return{...this.commonProperties,...e,...this.metadata,...this.distinctId?{distinct_id:this.distinctId}:{}}}}class T{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){return{...this.commonProperties,...e,...this.metadata,...this.distinctId?{distinct_id:this.distinctId}:{}}}}class c{meterProvider;loggerProvider;tracerProvider;options;constructor(e={}){this.options=e;let t=R({[de]:e.serviceName??"cline",...e.serviceVersion?{[ne]:e.serviceVersion}:{}});if(this.meterProvider=this.createMeterProvider(t),this.loggerProvider=this.createLoggerProvider(t),this.tracerProvider=this.createTracerProvider(t),this.meterProvider)M.setGlobalMeterProvider(this.meterProvider);if(this.loggerProvider)C.setGlobalLoggerProvider(this.loggerProvider);if(this.tracerProvider)this.tracerProvider.register()}getTracer(e="cline",t){return L.getTracer(e,t??this.options.serviceVersion)}createAdapter(e){return new u({...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 b({...e,adapters:[t],distinctId:P(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=y(this.options.metricsExporter);if(t.length===0)return null;let r=Math.max(1000,this.options.metricExportIntervalMs??this.options.metricExportInterval??60000),l=Math.min(30000,Math.floor(r*0.8)),a=t.map((i)=>ue(i,{endpoint:this.options.otlpEndpoint,headers:this.options.otlpHeaders,insecure:this.options.otlpInsecure??!1,protocol:"http/json",interval:r,timeout:l})).filter((i)=>i!==null);if(a.length===0)return null;return new te({resource:e,readers:a})}createTracerProvider(e){let t=y(this.options.tracesExporter);if(t.length===0)return null;let r=this.options.otlpTracesEndpoint??this.options.otlpEndpoint,l=this.options.otlpTracesHeaders??this.options.otlpHeaders,a=[];for(let i of t){let s=fe(i,{endpoint:r,headers:l,insecure:this.options.otlpInsecure??!1,protocol:"http/json"});if(s)a.push(s)}if(a.length===0)return null;return new ie({resource:e,spanProcessors:a})}createLoggerProvider(e){let t=y(this.options.logsExporter);if(t.length===0)return null;let r=t.map((l)=>{let a=ge(l,{endpoint:this.options.otlpEndpoint,headers:this.options.otlpHeaders,insecure:this.options.otlpInsecure??!1,protocol:"http/json"});if(!a)return null;return new _(a,{maxQueueSize:this.options.logMaxQueueSize??2048,maxExportBatchSize:this.options.logBatchSize??512,scheduledDelayMillis:this.options.logBatchTimeoutMs??this.options.logBatchTimeout??5000})}).filter((l)=>l!==null);if(r.length===0)return null;return new E({resource:e,processors:r})}}function H(e){let t=new c(e),r=t.createTelemetryService(e);return 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}),{provider:t,telemetry:r}}function j(e){if(S())return{telemetry:new T(e)};if(e.enabled!==!0)return{telemetry:new b({...e,distinctId:P(e.distinctId)})};return H(e)}function se(e){let{telemetry:t,provider:r}=j(e);return{telemetry:t,provider:r,flush:async()=>{let i=r;if(i&&typeof i.forceFlush==="function")try{await i.forceFlush()}catch{}},dispose:async()=>{await Promise.allSettled([t.dispose(),r?.dispose()])}}}function y(e){if(!e)return[];return(Array.isArray(e)?e:e.split(",")).map((r)=>r.trim()).filter((r)=>r==="console"||r==="otlp")}function ge(e,t){if(e==="console")return new p;if(!t.endpoint)return null;let r=A(t.endpoint,"/v1/logs");return new N({url:r,headers:t.headers})}function fe(e,t){if(e==="console")return new le(new ae);if(!t.endpoint)return null;let r=A(t.endpoint,"/v1/traces");return new re(new Y({url:r,headers:t.headers}))}function ue(e,t){if(e==="console")return new w({exporter:new ee,exportIntervalMillis:t.interval,exportTimeoutMillis:t.timeout});if(!t.endpoint)return null;let r=A(t.endpoint,"/v1/metrics");return new w({exporter:new V({url:r,headers:t.headers}),exportIntervalMillis:t.interval,exportTimeoutMillis:t.timeout})}function A(e,t){let r=new URL(e),l=r.pathname.endsWith("/")?r.pathname.slice(0,-1):r.pathname;return r.pathname=l.endsWith(t)?l:`${l}${t}`,r.toString()}export{H as createOpenTelemetryTelemetryService,j as createConfiguredTelemetryService,se as createConfiguredTelemetryHandle,c as OpenTelemetryProvider,u as OpenTelemetryAdapter};

package/dist/services/usage.d.ts

@@ -1,4 +1,5 @@
-import type { SessionAccumulatedUsage } from "../runtime/runtime-host";
+import type * as LlmsProviders from "@clinebot/llms";
+import type { SessionAccumulatedUsage } from "../runtime/host/runtime-host";
 export declare function createInitialAccumulatedUsage(): SessionAccumulatedUsage;
 export declare function accumulateUsageTotals(baseline: SessionAccumulatedUsage, usage: {
     inputTokens?: number;
@@ -7,4 +8,11 @@ export declare function accumulateUsageTotals(baseline: SessionAccumulatedUsage,
     cacheWriteTokens?: number;
     totalCost?: number;
 }): SessionAccumulatedUsage;
-//# sourceMappingURL=usage.d.ts.map
+export declare function summarizeUsageFromMessages(messages: LlmsProviders.Message[]): SessionAccumulatedUsage;
+/**
+ * Current model context-window usage, derived from the latest assistant LLM
+ * call. Provider usage is normalized so `inputTokens` is already the full
+ * prompt size, including any cache-read/cache-write portions. Do not add cache
+ * fields back on top.
+ */
+export declare function getCurrentContextSize(messages: readonly LlmsProviders.Message[]): number | undefined;

package/dist/services/workspace/file-indexer.d.ts

@@ -3,4 +3,3 @@ export interface FastFileIndexOptions {
 }
 export declare function getFileIndex(cwd: string, options?: FastFileIndexOptions): Promise<Set<string>>;
 export declare function prewarmFileIndex(cwd: string, options?: FastFileIndexOptions): Promise<void>;
-//# sourceMappingURL=file-indexer.d.ts.map

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

@@ -2,4 +2,3 @@ export type { FastFileIndexOptions } from "./file-indexer";
 export { getFileIndex, prewarmFileIndex } from "./file-indexer";
 export type { MentionEnricherOptions, MentionEnrichmentResult, } from "./mention-enricher";
 export { enrichPromptWithMentions } from "./mention-enricher";
-//# sourceMappingURL=index.d.ts.map

package/dist/services/workspace/mention-enricher.d.ts

@@ -11,4 +11,3 @@ export interface MentionEnrichmentResult {
     ignoredMentions: string[];
 }
 export declare function enrichPromptWithMentions(input: string, cwd: string, options?: MentionEnricherOptions): Promise<MentionEnrichmentResult>;
-//# sourceMappingURL=mention-enricher.d.ts.map

package/dist/{session → services/workspace}/workspace-manager.d.ts

@@ -25,4 +25,3 @@ export declare class InMemoryWorkspaceManager implements WorkspaceManager {
     getManifest(): WorkspaceManifest;
     private emit;
 }
-//# sourceMappingURL=workspace-manager.d.ts.map

package/dist/services/{workspace-manifest.d.ts → workspace/workspace-manifest.d.ts}

@@ -1,6 +1,25 @@
 import type { WorkspaceInfo } from "@clinebot/shared";
+export interface WorkspaceInfoDiagnostics {
+    info: WorkspaceInfo;
+    vcsType: "git" | "none";
+    error?: {
+        errorType: string;
+        message: string;
+    };
+}
+export interface BuiltWorkspaceMetadata {
+    workspaceInfo: WorkspaceInfo;
+    workspaceMetadata: string;
+    durationMs: number;
+    vcsType: "git" | "none";
+    initError?: {
+        errorType: string;
+        message: string;
+    };
+}
 export declare function normalizeWorkspacePath(workspacePath: string): string;
 export declare function generateWorkspaceInfo(workspacePath: string): Promise<WorkspaceInfo>;
+export declare function generateWorkspaceInfoWithDiagnostics(workspacePath: string): Promise<WorkspaceInfoDiagnostics>;
 export declare function buildWorkspaceMetadata(cwd: string): Promise<string>;
 /**
  * Generate workspace metadata as both a structured `WorkspaceInfo` object and
@@ -9,8 +28,4 @@ export declare function buildWorkspaceMetadata(cwd: string): Promise<string>;
  * Use this instead of calling `buildWorkspaceMetadata` + `generateWorkspaceInfo`
  * separately so the git I/O only happens once.
  */
-export declare function buildWorkspaceMetadataWithInfo(cwd: string): Promise<{
-    workspaceInfo: WorkspaceInfo;
-    workspaceMetadata: string;
-}>;
-//# sourceMappingURL=workspace-manifest.d.ts.map
+export declare function buildWorkspaceMetadataWithInfo(cwd: string): Promise<BuiltWorkspaceMetadata>;

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

@@ -0,0 +1,18 @@
+import type { ITelemetryService, WorkspaceInfo } from "@clinebot/shared";
+export interface WorkspaceLifecycleTelemetryInput {
+    telemetry?: ITelemetryService;
+    rootPath: string;
+    workspaceInfo?: WorkspaceInfo;
+    rootCount?: number;
+    vcsType?: "git" | "none";
+    vcsTypes?: ReadonlyArray<string>;
+    durationMs?: number;
+    initError?: {
+        errorType: string;
+        message: string;
+    };
+    featureFlagEnabled?: boolean;
+    isRemoteWorkspace?: boolean;
+}
+export declare function emitWorkspaceLifecycleTelemetry(input: WorkspaceLifecycleTelemetryInput): void;
+export declare function resetWorkspaceTelemetryForTests(): void;

package/dist/session/checkpoint-restore.d.ts

@@ -0,0 +1,20 @@
+import type * as LlmsProviders from "@clinebot/llms";
+import type { CheckpointEntry, CheckpointMetadata } from "../hooks/checkpoint-hooks";
+import type { SessionRecord } from "../types/sessions";
+export interface CheckpointRestorePlan {
+    checkpoint: CheckpointEntry;
+    messages?: LlmsProviders.Message[];
+    cwd: string;
+}
+export declare function readSessionCheckpointHistory(session: Pick<SessionRecord, "metadata"> | undefined): CheckpointEntry[];
+export declare function createRestoredCheckpointMetadata(session: Pick<SessionRecord, "metadata"> | undefined, runCount: number): CheckpointMetadata | undefined;
+export declare function trimMessagesToCheckpoint(messages: LlmsProviders.Message[], runCount: number): LlmsProviders.Message[];
+export declare function trimMessagesBeforeCheckpoint(messages: LlmsProviders.Message[], runCount: number): LlmsProviders.Message[];
+export declare function createCheckpointRestorePlan(input: {
+    session: SessionRecord;
+    messages?: LlmsProviders.Message[];
+    checkpointRunCount: number;
+    cwd?: string;
+    restoreMessages?: boolean;
+}): CheckpointRestorePlan;
+export declare function applyCheckpointToWorktree(cwd: string, checkpoint: CheckpointEntry): Promise<void>;

package/dist/session/{session-graph.d.ts → models/session-graph.d.ts}

@@ -1,5 +1,5 @@
-import type { HookEventPayload } from "../hooks";
-import type { SessionStatus } from "../types/common";
+import type { HookEventPayload } from "../../hooks";
+import type { SessionStatus } from "../../types/common";
 export declare function sanitizeSessionToken(value: string): string;
 export declare function makeSubSessionId(rootSessionId: string, agentId: string): string;
 export declare function makeTeamTaskSubSessionId(rootSessionId: string, agentId: string): string;
@@ -13,4 +13,3 @@ export declare function parseSubSessionId(sessionId: string): {
     agentId: string;
 } | null;
 export declare function deriveSubsessionStatus(event: HookEventPayload): SessionStatus;
-//# sourceMappingURL=session-graph.d.ts.map

package/dist/session/{session-manifest.d.ts → models/session-manifest.d.ts}

@@ -27,4 +27,3 @@ export declare const SessionManifestSchema: z.ZodObject<{
     messages_path: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type SessionManifest = z.infer<typeof SessionManifestSchema>;
-//# sourceMappingURL=session-manifest.d.ts.map

package/dist/session/{session-row.d.ts → models/session-row.d.ts}

@@ -1,6 +1,6 @@
 import type { TeamTeammateSpec } from "@clinebot/shared";
-import type { AgentTeamsRuntime } from "../extensions/tools/team";
-import type { SessionSource, SessionStatus } from "../types/common";
+import type { AgentTeamsRuntime } from "../../extensions/tools/team";
+import type { SessionSource, SessionStatus } from "../../types/common";
 import type { SessionManifest } from "./session-manifest";
 export interface SessionRow {
     sessionId: string;
@@ -90,4 +90,3 @@ export interface PersistedTeamEnvelope {
     teammates: TeamTeammateSpec[];
 }
 export declare function reviveTeamStateDates(state: TeamRuntimeState): TeamRuntimeState;
-//# sourceMappingURL=session-row.d.ts.map

package/dist/session/{file-session-service.d.ts → services/file-session-service.d.ts}

@@ -1,4 +1,4 @@
-import type { SessionMessagesArtifactUploader } from "../types/session";
+import type { SessionMessagesArtifactUploader } from "../../types/session";
 import { UnifiedSessionPersistenceService } from "./persistence-service";
 export declare class FileSessionService extends UnifiedSessionPersistenceService {
     constructor(sessionsDir?: string, options?: {
@@ -6,4 +6,3 @@ export declare class FileSessionService extends UnifiedSessionPersistenceService
     });
     ensureSessionsDir(): string;
 }
-//# sourceMappingURL=file-session-service.d.ts.map