@cline/core 0.0.38 → 0.0.39

package/dist/remote-config/integration.d.ts

@@ -0,0 +1,17 @@
+import { type AgentExtension, buildRemoteConfigSessionBlobUploadMetadata, type ITelemetryService, type OpenTelemetryClientConfig, type PreparedRemoteConfigRuntime, type PrepareRemoteConfigRuntimeOptions, REMOTE_CONFIG_SESSION_BLOB_UPLOAD_METADATA_KEY, readRemoteConfigSessionBlobUploadMetadata, registerRemoteConfigSessionBlobUpload } from "@cline/shared";
+import type { ClineCoreStartInput } from "../cline-core/types";
+import type { CreateOpenTelemetryTelemetryServiceOptions } from "../services/telemetry/OpenTelemetryProvider";
+import type { SessionMessagesArtifactUploader } from "../types/session";
+export interface PrepareRemoteConfigCoreIntegrationOptions extends PrepareRemoteConfigRuntimeOptions {
+    telemetryService?: Omit<CreateOpenTelemetryTelemetryServiceOptions, keyof OpenTelemetryClientConfig>;
+}
+export interface PreparedRemoteConfigCoreIntegration {
+    prepared: PreparedRemoteConfigRuntime;
+    extensions: AgentExtension[];
+    telemetry?: ITelemetryService;
+    applyToStartSessionInput(input: ClineCoreStartInput): ClineCoreStartInput;
+    dispose(): Promise<void>;
+}
+export declare function createRemoteConfigSessionMessagesArtifactUploader(): SessionMessagesArtifactUploader;
+export declare function prepareRemoteConfigCoreIntegration(options: PrepareRemoteConfigCoreIntegrationOptions): Promise<PreparedRemoteConfigCoreIntegration>;
+export { buildRemoteConfigSessionBlobUploadMetadata, REMOTE_CONFIG_SESSION_BLOB_UPLOAD_METADATA_KEY, readRemoteConfigSessionBlobUploadMetadata, registerRemoteConfigSessionBlobUpload, };

package/dist/runtime/host/local/agent-event-bridge.d.ts

@@ -8,6 +8,7 @@ import type { SessionAccumulatedUsage } from "../runtime-host";
 export interface AgentEventBridgeDeps {
     getSession(sessionId: string): ActiveSession | undefined;
     usageBySession: Map<string, SessionAccumulatedUsage>;
+    aggregateUsageBySession: Map<string, SessionAccumulatedUsage>;
     emit(event: CoreSessionEvent): void;
     persistMessages: AgentEventContext["persistMessages"];
     enqueuePendingPrompt(sessionId: string, entry: {

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

@@ -10,7 +10,7 @@ import { RuntimeOAuthTokenManager } from "../orchestration/runtime-oauth-token-m
 import type { RuntimeBuilder } from "../orchestration/session-runtime";
 import { SessionRuntime } from "../orchestration/session-runtime-orchestrator";
 import { type SessionBackend } from "./local/session-record";
-import type { PendingPromptsServiceApi, RestoreSessionInput, RestoreSessionResult, RuntimeHost, RuntimeHostSubscribeOptions, SendSessionInput, SessionAccumulatedUsage, StartSessionInput, StartSessionResult } from "./runtime-host";
+import type { PendingPromptsServiceApi, RestoreSessionInput, RestoreSessionResult, RuntimeHost, RuntimeHostSubscribeOptions, SendSessionInput, SessionUsageSummary, StartSessionInput, StartSessionResult } from "./runtime-host";
 export interface LocalRuntimeHostOptions {
     distinctId?: string;
     sessionService: SessionBackend;
@@ -44,6 +44,7 @@ export declare class LocalRuntimeHost implements RuntimeHost {
     private readonly events;
     private readonly sessions;
     private readonly usageBySession;
+    private readonly aggregateUsageBySession;
     private readonly subAgentStarts;
     private readonly pendingPromptsController;
     private readonly eventBridge;
@@ -52,7 +53,7 @@ export declare class LocalRuntimeHost implements RuntimeHost {
     startSession(input: StartSessionInput): Promise<StartSessionResult>;
     restoreSession(input: RestoreSessionInput): Promise<RestoreSessionResult>;
     runTurn(input: SendSessionInput): Promise<AgentResult | undefined>;
-    getAccumulatedUsage(sessionId: string): Promise<SessionAccumulatedUsage | undefined>;
+    getAccumulatedUsage(sessionId: string): Promise<SessionUsageSummary | undefined>;
     abort(sessionId: string, reason?: unknown): Promise<void>;
     stopSession(sessionId: string): Promise<void>;
     dispose(reason?: string): Promise<void>;
@@ -107,6 +108,9 @@ export declare class LocalRuntimeHost implements RuntimeHost {
     private getSessionOrThrow;
     private resolveAbsoluteFilePaths;
     private getSessionAgentTelemetryIdentity;
+    private seedAggregateUsageFromArtifacts;
+    private summarizePersistedTeammateUsage;
+    private withPersistedAggregateUsageFloor;
     private emitStatus;
     private emitSessionSnapshot;
     private emit;

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

@@ -78,6 +78,10 @@ export interface SessionAccumulatedUsage {
     cacheWriteTokens: number;
     totalCost: number;
 }
+export interface SessionUsageSummary {
+    usage?: SessionAccumulatedUsage;
+    aggregateUsage?: SessionAccumulatedUsage;
+}
 export interface PendingPromptMutationResult {
     sessionId: string;
     prompts: SessionPendingPrompt[];
@@ -107,7 +111,7 @@ export interface PendingPromptsRuntimeService {
     readonly pendingPrompts: PendingPromptsServiceApi;
 }
 export interface SessionUsageRuntimeService {
-    getAccumulatedUsage(sessionId: string): Promise<SessionAccumulatedUsage | undefined>;
+    getAccumulatedUsage(sessionId: string): Promise<SessionUsageSummary | undefined>;
 }
 export interface SessionModelRuntimeService {
     updateSessionModel(sessionId: string, modelId: string): Promise<void>;

package/dist/services/agent-events.d.ts

@@ -10,6 +10,7 @@ export interface AgentEventContext {
     config: CoreSessionConfig;
     liveSession: ActiveSession | undefined;
     usageBySession: Map<string, SessionAccumulatedUsage>;
+    aggregateUsageBySession: Map<string, SessionAccumulatedUsage>;
     persistMessages: (sessionId: string, messages: unknown[], systemPrompt?: string) => void;
     emit: (event: CoreSessionEvent) => void;
 }

package/dist/services/llms/provider-settings.d.ts

@@ -18,22 +18,22 @@ export declare const ProviderProtocolSchema: z.ZodEnum<{
     "openai-responses": "openai-responses";
     anthropic: "anthropic";
     gemini: "gemini";
-    "openai-chat": "openai-chat";
     "openai-r1": "openai-r1";
     "ai-sdk": "ai-sdk";
+    "openai-chat": "openai-chat";
 }>;
 export declare const ProviderClientSchema: z.ZodEnum<{
     custom: "custom";
     anthropic: "anthropic";
+    bedrock: "bedrock";
     gemini: "gemini";
+    vertex: "vertex";
+    openai: "openai";
     "openai-r1": "openai-r1";
     "ai-sdk": "ai-sdk";
     "ai-sdk-community": "ai-sdk-community";
-    openai: "openai";
     "openai-compatible": "openai-compatible";
-    bedrock: "bedrock";
     fetch: "fetch";
-    vertex: "vertex";
 }>;
 export declare const AuthSettingsSchema: z.ZodObject<{
     apiKey: z.ZodOptional<z.ZodString>;
@@ -47,8 +47,8 @@ export declare const ReasoningSettingsSchema: z.ZodObject<{
     enabled: z.ZodOptional<z.ZodBoolean>;
     effort: z.ZodOptional<z.ZodEnum<{
         low: "low";
-        high: "high";
         medium: "medium";
+        high: "high";
         xhigh: "xhigh";
         none: "none";
     }>>;
@@ -62,9 +62,9 @@ export declare const AwsSettingsSchema: z.ZodObject<{
     region: z.ZodOptional<z.ZodString>;
     profile: z.ZodOptional<z.ZodString>;
     authentication: z.ZodOptional<z.ZodEnum<{
-        iam: "iam";
         "api-key": "api-key";
         profile: "profile";
+        iam: "iam";
     }>>;
     usePromptCache: z.ZodOptional<z.ZodBoolean>;
     useCrossRegionInference: z.ZodOptional<z.ZodBoolean>;
@@ -99,8 +99,8 @@ export declare const SapSettingsSchema: z.ZodObject<{
 export type SapSettings = z.infer<typeof SapSettingsSchema>;
 export declare const OcaSettingsSchema: z.ZodObject<{
     mode: z.ZodOptional<z.ZodEnum<{
-        external: "external";
         internal: "internal";
+        external: "external";
     }>>;
     usePromptCache: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
@@ -129,22 +129,22 @@ export declare const ProviderSettingsSchema: z.ZodObject<{
         "openai-responses": "openai-responses";
         anthropic: "anthropic";
         gemini: "gemini";
-        "openai-chat": "openai-chat";
         "openai-r1": "openai-r1";
         "ai-sdk": "ai-sdk";
+        "openai-chat": "openai-chat";
     }>>;
     client: z.ZodOptional<z.ZodEnum<{
         custom: "custom";
         anthropic: "anthropic";
+        bedrock: "bedrock";
         gemini: "gemini";
+        vertex: "vertex";
+        openai: "openai";
         "openai-r1": "openai-r1";
         "ai-sdk": "ai-sdk";
         "ai-sdk-community": "ai-sdk-community";
-        openai: "openai";
         "openai-compatible": "openai-compatible";
-        bedrock: "bedrock";
         fetch: "fetch";
-        vertex: "vertex";
     }>>;
     routingProviderId: z.ZodOptional<z.ZodString>;
     maxTokens: z.ZodOptional<z.ZodNumber>;
@@ -156,8 +156,8 @@ export declare const ProviderSettingsSchema: z.ZodObject<{
         enabled: z.ZodOptional<z.ZodBoolean>;
         effort: z.ZodOptional<z.ZodEnum<{
             low: "low";
-            high: "high";
             medium: "medium";
+            high: "high";
             xhigh: "xhigh";
             none: "none";
         }>>;
@@ -170,9 +170,9 @@ export declare const ProviderSettingsSchema: z.ZodObject<{
         region: z.ZodOptional<z.ZodString>;
         profile: z.ZodOptional<z.ZodString>;
         authentication: z.ZodOptional<z.ZodEnum<{
-            iam: "iam";
             "api-key": "api-key";
             profile: "profile";
+            iam: "iam";
         }>>;
         usePromptCache: z.ZodOptional<z.ZodBoolean>;
         useCrossRegionInference: z.ZodOptional<z.ZodBoolean>;
@@ -203,8 +203,8 @@ export declare const ProviderSettingsSchema: z.ZodObject<{
     }, z.core.$strip>>;
     oca: z.ZodOptional<z.ZodObject<{
         mode: z.ZodOptional<z.ZodEnum<{
-            external: "external";
             internal: "internal";
+            external: "external";
         }>>;
         usePromptCache: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
@@ -215,9 +215,9 @@ export declare const ProviderSettingsSchema: z.ZodObject<{
     }>>;
     capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         tools: "tools";
+        reasoning: "reasoning";
         streaming: "streaming";
         "prompt-cache": "prompt-cache";
-        reasoning: "reasoning";
         "computer-use": "computer-use";
         oauth: "oauth";
         vision: "vision";

package/dist/services/usage.d.ts

@@ -8,6 +8,7 @@ export declare function accumulateUsageTotals(baseline: SessionAccumulatedUsage,
     cacheWriteTokens?: number;
     totalCost?: number;
 }): SessionAccumulatedUsage;
+export declare function sumUsageTotals(usages: Iterable<SessionAccumulatedUsage>): SessionAccumulatedUsage;
 export declare function summarizeUsageFromMessages(messages: LlmsProviders.Message[]): SessionAccumulatedUsage;
 /**
  * Current model context-window usage, derived from the latest assistant LLM

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

@@ -8,10 +8,10 @@ export declare const SessionManifestSchema: z.ZodObject<{
     ended_at: z.ZodOptional<z.ZodString>;
     exit_code: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     status: z.ZodEnum<{
-        running: "running";
-        completed: "completed";
         failed: "failed";
+        running: "running";
         cancelled: "cancelled";
+        completed: "completed";
     }>;
     interactive: z.ZodBoolean;
     provider: z.ZodString;

package/dist/session/session-snapshot.d.ts

@@ -47,11 +47,13 @@ export interface CoreSessionSnapshot {
     };
     messages?: LlmsProviders.Message[];
     usage?: SessionAccumulatedUsage;
+    aggregateUsage?: SessionAccumulatedUsage;
     checkpoint?: CoreSessionCheckpointSnapshot;
 }
 export declare function createCoreSessionSnapshot(input: {
     session: SessionRecord;
     messages?: LlmsProviders.Message[];
     usage?: SessionAccumulatedUsage;
+    aggregateUsage?: SessionAccumulatedUsage;
 }): CoreSessionSnapshot;
 export declare function coreSessionSnapshotToRecord(snapshot: CoreSessionSnapshot): SessionRecord;

package/dist/types/chat-schema.d.ts

@@ -21,32 +21,32 @@ export declare const ChatSessionConfigSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const ChatSessionStatusSchema: z.ZodEnum<{
     error: "error";
-    idle: "idle";
+    failed: "failed";
     running: "running";
+    cancelled: "cancelled";
     completed: "completed";
-    failed: "failed";
+    idle: "idle";
     starting: "starting";
     stopping: "stopping";
-    cancelled: "cancelled";
 }>;
 export declare const ChatMessageRoleSchema: z.ZodEnum<{
-    system: "system";
-    status: "status";
     error: "error";
     user: "user";
     assistant: "assistant";
     tool: "tool";
+    status: "status";
+    system: "system";
 }>;
 export declare const ChatMessageSchema: z.ZodObject<{
     id: z.ZodString;
     sessionId: z.ZodNullable<z.ZodString>;
     role: z.ZodEnum<{
-        system: "system";
-        status: "status";
         error: "error";
         user: "user";
         assistant: "assistant";
         tool: "tool";
+        status: "status";
+        system: "system";
     }>;
     content: z.ZodString;
     createdAt: z.ZodNumber;
@@ -82,13 +82,13 @@ export declare const ChatViewStateSchema: z.ZodObject<{
     sessionId: z.ZodNullable<z.ZodString>;
     status: z.ZodEnum<{
         error: "error";
-        idle: "idle";
+        failed: "failed";
         running: "running";
+        cancelled: "cancelled";
         completed: "completed";
-        failed: "failed";
+        idle: "idle";
         starting: "starting";
         stopping: "stopping";
-        cancelled: "cancelled";
     }>;
     config: z.ZodObject<{
         workspaceRoot: z.ZodString;
@@ -114,12 +114,12 @@ export declare const ChatViewStateSchema: z.ZodObject<{
         id: z.ZodString;
         sessionId: z.ZodNullable<z.ZodString>;
         role: z.ZodEnum<{
-            system: "system";
-            status: "status";
             error: "error";
             user: "user";
             assistant: "assistant";
             tool: "tool";
+            status: "status";
+            system: "system";
         }>;
         content: z.ZodString;
         createdAt: z.ZodNumber;

package/dist/types/session.d.ts

@@ -31,6 +31,9 @@ export type ActiveSession = {
     drainingPendingPrompts: boolean;
     pluginSandboxShutdown?: () => Promise<void>;
     turnUsageBaseline?: SessionAccumulatedUsage;
+    turnAggregateUsageBaseline?: SessionAccumulatedUsage;
+    turnPrimaryUsage?: SessionAccumulatedUsage;
+    turnUsageByAgent?: Map<string, SessionAccumulatedUsage>;
     /**
      * Set to `true` once the assistant successfully invoked the canonical
      * completion tool (`submit_and_exit`) for this session. Used to:

package/dist/types/sessions.d.ts

@@ -1,5 +1,12 @@
 import type { SessionLineage, SessionRuntimeRecordShape } from "@cline/shared";
 import type { SessionSource, SessionStatus } from "./common";
+export interface SessionUsageMetadata {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+    totalCost: number;
+}
 export interface SessionRef extends SessionLineage {
     sessionId: string;
 }
@@ -10,6 +17,9 @@ export interface SessionRecord extends SessionRef, Omit<SessionRuntimeRecordShap
 export interface SessionHistoryMetadata extends Record<string, unknown> {
     title?: string;
     totalCost?: number;
+    aggregatedAgentsCost?: number;
+    usage?: SessionUsageMetadata;
+    aggregateUsage?: SessionUsageMetadata;
     checkpoint?: {
         latest?: {
             ref?: string;

package/dist/types.d.ts

@@ -9,7 +9,7 @@ export type { BuiltinToolAvailabilityContext, ToolCatalogEntry, } from "./extens
 export { getCoreAcpToolNames, getCoreBuiltinToolCatalog, getCoreDefaultEnabledToolIds, getCoreHeadlessToolNames, resolveCoreSelectedToolIds, TEAM_TOOL_NAMES, } from "./extensions/tools";
 export type { RuntimeCapabilities } from "./runtime/capabilities";
 export type { SessionBackend } from "./runtime/host/host";
-export type { PendingPromptMutationResult, PendingPromptsDeleteInput, PendingPromptsListInput, PendingPromptsRuntimeService, PendingPromptsServiceApi, PendingPromptsUpdateInput, RuntimeHost, RuntimeHost as SessionHost, RuntimeHostMode, SendSessionInput, SessionAccumulatedUsage, StartSessionInput, StartSessionResult, } from "./runtime/host/runtime-host";
+export type { PendingPromptMutationResult, PendingPromptsDeleteInput, PendingPromptsListInput, PendingPromptsRuntimeService, PendingPromptsServiceApi, PendingPromptsUpdateInput, RuntimeHost, RuntimeHost as SessionHost, RuntimeHostMode, SendSessionInput, SessionAccumulatedUsage, SessionUsageSummary, StartSessionInput, StartSessionResult, } from "./runtime/host/runtime-host";
 export type { BuiltRuntime as RuntimeEnvironment, RuntimeBuilder, RuntimeBuilderInput, SessionRuntime, } from "./runtime/orchestration/session-runtime";
 export type { SandboxCallOptions, SubprocessSandboxOptions, } from "./runtime/tools/subprocess-sandbox";
 export { SubprocessSandbox } from "./runtime/tools/subprocess-sandbox";

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@cline/core",
 	"description": "Cline Core SDK for Node Runtime",
-	"version": "0.0.38",
+	"version": "0.0.39",
 	"repository": {
 		"type": "git",
 		"url": "https://github.com/cline/sdk",
@@ -16,22 +16,18 @@
 	},
 	"exports": {
 		".": {
-			"development": "./src/index.ts",
 			"types": "./dist/index.d.ts",
 			"import": "./dist/index.js"
 		},
 		"./hub": {
-			"development": "./src/hub/index.ts",
 			"types": "./dist/hub/index.d.ts",
 			"import": "./dist/hub/index.js"
 		},
 		"./hub/daemon-entry": {
-			"development": "./src/hub/daemon/entry.ts",
 			"types": "./dist/hub/daemon/entry.d.ts",
 			"import": "./dist/hub/daemon/entry.js"
 		},
 		"./telemetry": {
-			"development": "./src/services/telemetry/index.ts",
 			"types": "./dist/services/telemetry/index.d.ts",
 			"import": "./dist/services/telemetry/index.js"
 		}
@@ -48,9 +44,9 @@
 		"test:watch": "vitest --config vitest.config.ts"
 	},
 	"dependencies": {
-		"@cline/agents": "workspace:*",
-		"@cline/shared": "workspace:*",
-		"@cline/llms": "workspace:*",
+		"@cline/agents": "0.0.39",
+		"@cline/shared": "0.0.39",
+		"@cline/llms": "0.0.39",
 		"@opentelemetry/api": "^1.9.0",
 		"@opentelemetry/api-logs": "^0.214.0",
 		"@opentelemetry/exporter-logs-otlp-http": "^0.214.0",