@sctg/cline-core 3.84.0-beta.20260524130712

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (230) hide show
  1. package/README.md +110 -0
  2. package/dist/ClineCore.d.ts +283 -0
  3. package/dist/account/cline-account-service.d.ts +37 -0
  4. package/dist/account/index.d.ts +3 -0
  5. package/dist/account/rpc.d.ts +40 -0
  6. package/dist/account/types.d.ts +98 -0
  7. package/dist/auth/bounded-ttl-cache.d.ts +13 -0
  8. package/dist/auth/client.d.ts +30 -0
  9. package/dist/auth/cline.d.ts +64 -0
  10. package/dist/auth/codex.d.ts +43 -0
  11. package/dist/auth/oca.d.ts +28 -0
  12. package/dist/auth/server.d.ts +54 -0
  13. package/dist/auth/types.d.ts +103 -0
  14. package/dist/auth/utils.d.ts +32 -0
  15. package/dist/cline-core/automation.d.ts +34 -0
  16. package/dist/cline-core/runtime-services.d.ts +5 -0
  17. package/dist/cline-core/start-input.d.ts +10 -0
  18. package/dist/cline-core/telemetry.d.ts +10 -0
  19. package/dist/cline-core/types.d.ts +221 -0
  20. package/dist/cron/events/cron-event-ingress.d.ts +37 -0
  21. package/dist/cron/reports/cron-report-writer.d.ts +40 -0
  22. package/dist/cron/runner/cron-materializer.d.ts +35 -0
  23. package/dist/cron/runner/cron-runner.d.ts +47 -0
  24. package/dist/cron/runner/resource-limiter.d.ts +8 -0
  25. package/dist/cron/schedule/scheduler.d.ts +12 -0
  26. package/dist/cron/service/cron-service.d.ts +56 -0
  27. package/dist/cron/service/schedule-command-service.d.ts +9 -0
  28. package/dist/cron/service/schedule-service.d.ts +98 -0
  29. package/dist/cron/specs/cron-reconciler.d.ts +61 -0
  30. package/dist/cron/specs/cron-spec-parser.d.ts +26 -0
  31. package/dist/cron/specs/cron-watcher.d.ts +22 -0
  32. package/dist/cron/store/cron-schema.d.ts +2 -0
  33. package/dist/cron/store/sqlite-cron-store.d.ts +240 -0
  34. package/dist/extensions/config/index.d.ts +7 -0
  35. package/dist/extensions/config/runtime-commands.d.ts +11 -0
  36. package/dist/extensions/config/skill-frontmatter-toggle.d.ts +11 -0
  37. package/dist/extensions/config/unified-config-file-watcher.d.ts +77 -0
  38. package/dist/extensions/config/user-instruction-config-loader.d.ts +64 -0
  39. package/dist/extensions/config/user-instruction-plugin.d.ts +25 -0
  40. package/dist/extensions/config/user-instruction-service.d.ts +23 -0
  41. package/dist/extensions/context/agentic-compaction.d.ts +12 -0
  42. package/dist/extensions/context/basic-compaction.d.ts +8 -0
  43. package/dist/extensions/context/compaction-shared.d.ts +61 -0
  44. package/dist/extensions/context/compaction.d.ts +38 -0
  45. package/dist/extensions/index.d.ts +5 -0
  46. package/dist/extensions/mcp/client.d.ts +9 -0
  47. package/dist/extensions/mcp/config-loader.d.ts +25 -0
  48. package/dist/extensions/mcp/index.d.ts +11 -0
  49. package/dist/extensions/mcp/manager.d.ts +23 -0
  50. package/dist/extensions/mcp/name-transform.d.ts +2 -0
  51. package/dist/extensions/mcp/oauth.d.ts +48 -0
  52. package/dist/extensions/mcp/policies.d.ts +14 -0
  53. package/dist/extensions/mcp/tools.d.ts +3 -0
  54. package/dist/extensions/mcp/types.d.ts +111 -0
  55. package/dist/extensions/plugin/plugin-config-loader.d.ts +40 -0
  56. package/dist/extensions/plugin/plugin-load-report.d.ts +18 -0
  57. package/dist/extensions/plugin/plugin-loader.d.ts +22 -0
  58. package/dist/extensions/plugin/plugin-module-import.d.ts +4 -0
  59. package/dist/extensions/plugin/plugin-sandbox.d.ts +36 -0
  60. package/dist/extensions/plugin/plugin-targeting.d.ts +6 -0
  61. package/dist/extensions/plugin-sandbox-bootstrap.js +1 -0
  62. package/dist/extensions/tools/constants.d.ts +24 -0
  63. package/dist/extensions/tools/definitions.d.ts +102 -0
  64. package/dist/extensions/tools/executors/apply-patch-parser.d.ts +68 -0
  65. package/dist/extensions/tools/executors/apply-patch.d.ts +28 -0
  66. package/dist/extensions/tools/executors/bash.d.ts +49 -0
  67. package/dist/extensions/tools/executors/editor.d.ts +31 -0
  68. package/dist/extensions/tools/executors/file-read.d.ts +40 -0
  69. package/dist/extensions/tools/executors/index.d.ts +50 -0
  70. package/dist/extensions/tools/executors/search.d.ts +50 -0
  71. package/dist/extensions/tools/executors/web-fetch.d.ts +58 -0
  72. package/dist/extensions/tools/helpers.d.ts +15 -0
  73. package/dist/extensions/tools/index.d.ts +59 -0
  74. package/dist/extensions/tools/model-tool-routing.d.ts +33 -0
  75. package/dist/extensions/tools/presets.d.ts +132 -0
  76. package/dist/extensions/tools/runtime.d.ts +24 -0
  77. package/dist/extensions/tools/schemas.d.ts +241 -0
  78. package/dist/extensions/tools/team/delegated-agent.d.ts +43 -0
  79. package/dist/extensions/tools/team/index.d.ts +2 -0
  80. package/dist/extensions/tools/team/multi-agent.d.ts +230 -0
  81. package/dist/extensions/tools/team/projections.d.ts +8 -0
  82. package/dist/extensions/tools/team/runtime.d.ts +4 -0
  83. package/dist/extensions/tools/team/spawn-agent-tool.d.ts +84 -0
  84. package/dist/extensions/tools/team/subagent-prompts.d.ts +3 -0
  85. package/dist/extensions/tools/team/team-tools.d.ts +35 -0
  86. package/dist/extensions/tools/types.d.ts +254 -0
  87. package/dist/hooks/checkpoint-hooks.d.ts +45 -0
  88. package/dist/hooks/hook-extension.d.ts +2 -0
  89. package/dist/hooks/hook-file-config.d.ts +24 -0
  90. package/dist/hooks/hook-file-hooks.d.ts +21 -0
  91. package/dist/hooks/index.d.ts +5 -0
  92. package/dist/hooks/subprocess-runner.d.ts +21 -0
  93. package/dist/hooks/subprocess.d.ts +68 -0
  94. package/dist/hub/client/connect.d.ts +14 -0
  95. package/dist/hub/client/index.d.ts +88 -0
  96. package/dist/hub/client/session-client.d.ts +118 -0
  97. package/dist/hub/client/ui-client.d.ts +45 -0
  98. package/dist/hub/daemon/entry.d.ts +1 -0
  99. package/dist/hub/daemon/entry.js +722 -0
  100. package/dist/hub/daemon/index.d.ts +9 -0
  101. package/dist/hub/daemon/runtime-handlers.d.ts +12 -0
  102. package/dist/hub/daemon/start-shared-server.d.ts +18 -0
  103. package/dist/hub/discovery/defaults.d.ts +16 -0
  104. package/dist/hub/discovery/index.d.ts +30 -0
  105. package/dist/hub/discovery/workspace.d.ts +3 -0
  106. package/dist/hub/index.d.ts +32 -0
  107. package/dist/hub/index.js +719 -0
  108. package/dist/hub/runtime-host/hub-runtime-host.d.ts +76 -0
  109. package/dist/hub/runtime-host/remote-runtime-host.d.ts +9 -0
  110. package/dist/hub/server/browser-websocket.d.ts +19 -0
  111. package/dist/hub/server/command-transport.d.ts +7 -0
  112. package/dist/hub/server/handlers/approval-handlers.d.ts +17 -0
  113. package/dist/hub/server/handlers/capability-handlers.d.ts +12 -0
  114. package/dist/hub/server/handlers/client-handlers.d.ts +6 -0
  115. package/dist/hub/server/handlers/context.d.ts +57 -0
  116. package/dist/hub/server/handlers/run-handlers.d.ts +5 -0
  117. package/dist/hub/server/handlers/session-event-projector.d.ts +7 -0
  118. package/dist/hub/server/handlers/session-handlers.d.ts +20 -0
  119. package/dist/hub/server/hub-client-contributions.d.ts +19 -0
  120. package/dist/hub/server/hub-notifications.d.ts +7 -0
  121. package/dist/hub/server/hub-schedule-events.d.ts +2 -0
  122. package/dist/hub/server/hub-server-logging.d.ts +2 -0
  123. package/dist/hub/server/hub-server-options.d.ts +55 -0
  124. package/dist/hub/server/hub-server-transport.d.ts +37 -0
  125. package/dist/hub/server/hub-session-records.d.ts +9 -0
  126. package/dist/hub/server/hub-websocket-server.d.ts +6 -0
  127. package/dist/hub/server/index.d.ts +4 -0
  128. package/dist/hub/server/native-transport.d.ts +16 -0
  129. package/dist/index.d.ts +104 -0
  130. package/dist/index.js +717 -0
  131. package/dist/remote-config/integration.d.ts +17 -0
  132. package/dist/runtime/capabilities/index.d.ts +2 -0
  133. package/dist/runtime/capabilities/normalize-runtime-capabilities.d.ts +2 -0
  134. package/dist/runtime/capabilities/runtime-capabilities.d.ts +6 -0
  135. package/dist/runtime/config/agent-message-codec.d.ts +6 -0
  136. package/dist/runtime/config/agent-runtime-config-builder.d.ts +80 -0
  137. package/dist/runtime/host/history.d.ts +19 -0
  138. package/dist/runtime/host/host.d.ts +7 -0
  139. package/dist/runtime/host/local/agent-event-bridge.d.ts +30 -0
  140. package/dist/runtime/host/local/session-record.d.ts +6 -0
  141. package/dist/runtime/host/local/session-service-invoker.d.ts +4 -0
  142. package/dist/runtime/host/local/spawn-tool.d.ts +15 -0
  143. package/dist/runtime/host/local/user-files.d.ts +1 -0
  144. package/dist/runtime/host/local-runtime-host.d.ts +127 -0
  145. package/dist/runtime/host/runtime-host-support.d.ts +20 -0
  146. package/dist/runtime/host/runtime-host.d.ts +169 -0
  147. package/dist/runtime/orchestration/runtime-builder.d.ts +6 -0
  148. package/dist/runtime/orchestration/runtime-event-adapter.d.ts +101 -0
  149. package/dist/runtime/orchestration/runtime-oauth-token-manager.d.ts +30 -0
  150. package/dist/runtime/orchestration/session-runtime-orchestrator.d.ts +218 -0
  151. package/dist/runtime/orchestration/session-runtime.d.ts +58 -0
  152. package/dist/runtime/orchestration/user-input-builder.d.ts +15 -0
  153. package/dist/runtime/safety/loop-detection.d.ts +58 -0
  154. package/dist/runtime/safety/mistake-tracker.d.ts +68 -0
  155. package/dist/runtime/safety/rules.d.ts +6 -0
  156. package/dist/runtime/tools/subprocess-sandbox.d.ts +43 -0
  157. package/dist/runtime/tools/tool-approval.d.ts +9 -0
  158. package/dist/runtime/turn-queue/pending-prompt-service.d.ts +69 -0
  159. package/dist/services/agent-events.d.ts +34 -0
  160. package/dist/services/config.d.ts +2 -0
  161. package/dist/services/global-settings.d.ts +34 -0
  162. package/dist/services/llms/cline-recommended-models.d.ts +19 -0
  163. package/dist/services/llms/configured-provider-registry.d.ts +27 -0
  164. package/dist/services/llms/handler-factory.d.ts +3 -0
  165. package/dist/services/llms/provider-defaults.d.ts +28 -0
  166. package/dist/services/llms/provider-settings.d.ts +250 -0
  167. package/dist/services/llms/runtime-config.d.ts +3 -0
  168. package/dist/services/llms/runtime-registry.d.ts +19 -0
  169. package/dist/services/llms/runtime-types.d.ts +84 -0
  170. package/dist/services/local-runtime-bootstrap.d.ts +45 -0
  171. package/dist/services/plugin-tools.d.ts +28 -0
  172. package/dist/services/providers/local-provider-registry.d.ts +230 -0
  173. package/dist/services/providers/local-provider-service.d.ts +70 -0
  174. package/dist/services/providers/model-source.d.ts +3 -0
  175. package/dist/services/providers/provider-config-fields.d.ts +37 -0
  176. package/dist/services/session-artifacts.d.ts +17 -0
  177. package/dist/services/session-data.d.ts +51 -0
  178. package/dist/services/session-telemetry.d.ts +15 -0
  179. package/dist/services/storage/file-team-store.d.ts +28 -0
  180. package/dist/services/storage/provider-settings-legacy-migration.d.ts +38 -0
  181. package/dist/services/storage/provider-settings-manager.d.ts +23 -0
  182. package/dist/services/storage/sqlite-session-store.d.ts +30 -0
  183. package/dist/services/storage/sqlite-team-store.d.ts +34 -0
  184. package/dist/services/storage/team-store.d.ts +15 -0
  185. package/dist/services/telemetry/ITelemetryAdapter.d.ts +54 -0
  186. package/dist/services/telemetry/OpenTelemetryAdapter.d.ts +43 -0
  187. package/dist/services/telemetry/OpenTelemetryProvider.d.ts +83 -0
  188. package/dist/services/telemetry/TelemetryLoggerSink.d.ts +27 -0
  189. package/dist/services/telemetry/TelemetryService.d.ts +34 -0
  190. package/dist/services/telemetry/core-events.d.ts +276 -0
  191. package/dist/services/telemetry/distinct-id.d.ts +1 -0
  192. package/dist/services/telemetry/index.d.ts +3 -0
  193. package/dist/services/telemetry/index.js +1 -0
  194. package/dist/services/usage.d.ts +19 -0
  195. package/dist/services/workspace/file-indexer.d.ts +5 -0
  196. package/dist/services/workspace/index.d.ts +4 -0
  197. package/dist/services/workspace/mention-enricher.d.ts +13 -0
  198. package/dist/services/workspace/workspace-manager.d.ts +27 -0
  199. package/dist/services/workspace/workspace-manifest.d.ts +31 -0
  200. package/dist/services/workspace/workspace-telemetry.d.ts +18 -0
  201. package/dist/session/checkpoint-restore.d.ts +20 -0
  202. package/dist/session/models/session-graph.d.ts +15 -0
  203. package/dist/session/models/session-manifest.d.ts +31 -0
  204. package/dist/session/models/session-row.d.ts +92 -0
  205. package/dist/session/services/file-session-service.d.ts +10 -0
  206. package/dist/session/services/message-builder.d.ts +66 -0
  207. package/dist/session/services/persistence-service.d.ts +59 -0
  208. package/dist/session/services/session-service.d.ts +15 -0
  209. package/dist/session/session-snapshot.d.ts +59 -0
  210. package/dist/session/session-versioning-service.d.ts +48 -0
  211. package/dist/session/stores/conversation-store.d.ts +29 -0
  212. package/dist/session/stores/session-manifest-store.d.ts +23 -0
  213. package/dist/session/stores/team-persistence-store.d.ts +23 -0
  214. package/dist/session/team/index.d.ts +2 -0
  215. package/dist/session/team/team-child-session-manager.d.ts +35 -0
  216. package/dist/session/team/team-session-coordinator.d.ts +13 -0
  217. package/dist/settings/index.d.ts +2 -0
  218. package/dist/settings/settings-service.d.ts +6 -0
  219. package/dist/settings/types.d.ts +43 -0
  220. package/dist/types/chat-schema.d.ts +163 -0
  221. package/dist/types/common.d.ts +24 -0
  222. package/dist/types/config.d.ts +167 -0
  223. package/dist/types/events.d.ts +89 -0
  224. package/dist/types/provider-settings.d.ts +19 -0
  225. package/dist/types/session.d.ts +122 -0
  226. package/dist/types/sessions.d.ts +38 -0
  227. package/dist/types/storage.d.ts +36 -0
  228. package/dist/types.d.ts +32 -0
  229. package/dist/version.d.ts +1 -0
  230. package/package.json +80 -0
@@ -0,0 +1,19 @@
1
+ import { ProviderSettingsManager } from "../storage/provider-settings-manager";
2
+ export interface ClineRecommendedModel {
3
+ id: string;
4
+ name: string;
5
+ description: string;
6
+ tags: string[];
7
+ }
8
+ export interface ClineRecommendedModelsData {
9
+ recommended: ClineRecommendedModel[];
10
+ free: ClineRecommendedModel[];
11
+ }
12
+ export interface FetchClineRecommendedModelsOptions {
13
+ baseUrl?: string;
14
+ fetchImpl?: typeof fetch;
15
+ providerSettingsManager?: Pick<ProviderSettingsManager, "getProviderSettings">;
16
+ timeoutMs?: number;
17
+ }
18
+ export declare const FALLBACK_CLINE_RECOMMENDED_MODELS: ClineRecommendedModelsData;
19
+ export declare function fetchClineRecommendedModels(options?: FetchClineRecommendedModelsOptions): Promise<ClineRecommendedModelsData>;
@@ -0,0 +1,27 @@
1
+ import type { ProviderConfig } from "./provider-settings";
2
+ import type { BuiltInProviderSummary, CreateHandlerInput, ProviderConfigDefaults, ProviderSelectionConfig, RegisteredProviderSummary } from "./runtime-types";
3
+ interface RegisterConfiguredProviderInput {
4
+ id: string;
5
+ models: readonly string[];
6
+ defaultModel?: string;
7
+ defaults?: ProviderConfigDefaults;
8
+ }
9
+ export declare function toBuiltInProviderSummary(input: {
10
+ collection: BuiltInProviderSummary["id"] extends string ? {
11
+ provider: Pick<import("@cline/llms").ProviderInfo, "id" | "name" | "description" | "protocol" | "baseUrl" | "capabilities" | "env" | "defaultModelId">;
12
+ models: Record<string, unknown>;
13
+ } : never;
14
+ }): BuiltInProviderSummary;
15
+ export declare class ConfiguredProviderRegistry {
16
+ private readonly providers;
17
+ register(input: RegisterConfiguredProviderInput): void;
18
+ registerSelectionConfig(provider: ProviderSelectionConfig): void;
19
+ registerModel(providerId: string, modelId: string): void;
20
+ createHandlerConfig(input: CreateHandlerInput): ProviderConfig;
21
+ list(): RegisteredProviderSummary[];
22
+ getModels(providerId: string): string[];
23
+ hasProvider(providerId: string): boolean;
24
+ hasModel(providerId: string, modelId: string): boolean;
25
+ private require;
26
+ }
27
+ export {};
@@ -0,0 +1,3 @@
1
+ import type { AgentConfig, AgentModel, BasicLogger, ITelemetryService, ModelInfo } from "@cline/shared";
2
+ export declare function resolveKnownModelsFromConfig(config: AgentConfig): Record<string, ModelInfo> | undefined;
3
+ export declare function createAgentModelFromConfig(config: AgentConfig, logger: BasicLogger | undefined, telemetry?: ITelemetryService): AgentModel;
@@ -0,0 +1,28 @@
1
+ /** biome-ignore-all lint/style/noNonNullAssertion: static */
2
+ import * as Llms from "@cline/llms";
3
+ import type { ModelCatalogConfig, ModelInfo, ProviderCapability, ProviderConfig } from "./provider-settings";
4
+ export interface BuiltInProviderManifest {
5
+ id: string;
6
+ baseUrl: string;
7
+ modelsSourceUrl?: string;
8
+ modelId: string;
9
+ knownModels?: Record<string, ModelInfo>;
10
+ capabilities?: Llms.CatalogProviderCapability[];
11
+ env?: readonly string[];
12
+ client: Llms.ProviderClient;
13
+ protocol?: Llms.ProviderProtocol;
14
+ }
15
+ export interface ProviderDefaults {
16
+ baseUrl?: string;
17
+ modelId: string;
18
+ knownModels?: Record<string, ModelInfo>;
19
+ capabilities?: ProviderCapability[];
20
+ }
21
+ export declare const DEFAULT_MODELS_CATALOG_URL = "https://models.dev/api.json";
22
+ export declare function clearPublicModelsCatalogCache(): void;
23
+ export declare function getLiveModelsCatalog(options?: Pick<ModelCatalogConfig, "url" | "cacheTtlMs">): Promise<Record<string, Record<string, ModelInfo>>>;
24
+ export declare function clearLiveModelsCatalogCache(url?: string): void;
25
+ export declare function clearPrivateModelsCatalogCache(): void;
26
+ export declare const OPENAI_COMPATIBLE_PROVIDERS: Record<string, ProviderDefaults>;
27
+ export declare function getProviderConfig(providerId: string): ProviderDefaults | undefined;
28
+ export declare function resolveProviderConfig(providerId: string, modelCatalog?: ModelCatalogConfig, config?: ProviderConfig): Promise<ProviderDefaults | undefined>;
@@ -0,0 +1,250 @@
1
+ import * as Llms from "@cline/llms";
2
+ import { z } from "zod";
3
+ import { type ProviderDefaults } from "./provider-defaults";
4
+ export type ModelInfo = Llms.ModelInfo;
5
+ export type ProviderClient = Llms.ProviderClient;
6
+ export type ProviderProtocol = Llms.ProviderProtocol;
7
+ export type ProviderId = Llms.ProviderId;
8
+ export type ProviderCapability = Llms.ProviderCapability;
9
+ export type ProviderConfig = Llms.ProviderConfig;
10
+ export type BuiltInProviderId = Llms.BuiltInProviderId;
11
+ export declare const BUILT_IN_PROVIDER: typeof Llms.BUILT_IN_PROVIDER;
12
+ export declare const BUILT_IN_PROVIDER_IDS: [Llms.BUILT_IN_PROVIDER, ...Llms.BUILT_IN_PROVIDER[]];
13
+ export declare const isBuiltInProviderId: typeof Llms.isBuiltInProviderId;
14
+ export declare const normalizeProviderId: typeof Llms.normalizeProviderId;
15
+ export type ProviderDefaultsConfig = ProviderDefaults;
16
+ export declare const ProviderIdSchema: z.ZodString;
17
+ export declare const ProviderProtocolSchema: z.ZodEnum<{
18
+ "openai-responses": "openai-responses";
19
+ anthropic: "anthropic";
20
+ gemini: "gemini";
21
+ "openai-r1": "openai-r1";
22
+ "ai-sdk": "ai-sdk";
23
+ "openai-chat": "openai-chat";
24
+ }>;
25
+ export declare const ProviderClientSchema: z.ZodEnum<{
26
+ custom: "custom";
27
+ anthropic: "anthropic";
28
+ bedrock: "bedrock";
29
+ gemini: "gemini";
30
+ vertex: "vertex";
31
+ openai: "openai";
32
+ "openai-r1": "openai-r1";
33
+ "ai-sdk": "ai-sdk";
34
+ "ai-sdk-community": "ai-sdk-community";
35
+ "openai-compatible": "openai-compatible";
36
+ fetch: "fetch";
37
+ }>;
38
+ export declare const AuthSettingsSchema: z.ZodObject<{
39
+ apiKey: z.ZodOptional<z.ZodString>;
40
+ accessToken: z.ZodOptional<z.ZodString>;
41
+ refreshToken: z.ZodOptional<z.ZodString>;
42
+ expiresAt: z.ZodOptional<z.ZodNumber>;
43
+ accountId: z.ZodOptional<z.ZodString>;
44
+ }, z.core.$strip>;
45
+ export type AuthSettings = z.infer<typeof AuthSettingsSchema>;
46
+ export declare const ReasoningSettingsSchema: z.ZodObject<{
47
+ enabled: z.ZodOptional<z.ZodBoolean>;
48
+ effort: z.ZodOptional<z.ZodEnum<{
49
+ low: "low";
50
+ medium: "medium";
51
+ high: "high";
52
+ xhigh: "xhigh";
53
+ none: "none";
54
+ }>>;
55
+ budgetTokens: z.ZodOptional<z.ZodNumber>;
56
+ }, z.core.$strip>;
57
+ export type ReasoningSettings = z.infer<typeof ReasoningSettingsSchema>;
58
+ export declare const AwsSettingsSchema: z.ZodObject<{
59
+ accessKey: z.ZodOptional<z.ZodString>;
60
+ secretKey: z.ZodOptional<z.ZodString>;
61
+ sessionToken: z.ZodOptional<z.ZodString>;
62
+ region: z.ZodOptional<z.ZodString>;
63
+ profile: z.ZodOptional<z.ZodString>;
64
+ authentication: z.ZodOptional<z.ZodEnum<{
65
+ "api-key": "api-key";
66
+ profile: "profile";
67
+ iam: "iam";
68
+ apikey: "apikey";
69
+ }>>;
70
+ usePromptCache: z.ZodOptional<z.ZodBoolean>;
71
+ useCrossRegionInference: z.ZodOptional<z.ZodBoolean>;
72
+ useGlobalInference: z.ZodOptional<z.ZodBoolean>;
73
+ endpoint: z.ZodOptional<z.ZodString>;
74
+ customModelBaseId: z.ZodOptional<z.ZodString>;
75
+ }, z.core.$strip>;
76
+ export type AwsSettings = z.infer<typeof AwsSettingsSchema>;
77
+ export declare const GcpSettingsSchema: z.ZodObject<{
78
+ projectId: z.ZodOptional<z.ZodString>;
79
+ region: z.ZodOptional<z.ZodString>;
80
+ }, z.core.$strip>;
81
+ export type GcpSettings = z.infer<typeof GcpSettingsSchema>;
82
+ export declare const AzureSettingsSchema: z.ZodObject<{
83
+ apiVersion: z.ZodOptional<z.ZodString>;
84
+ useIdentity: z.ZodOptional<z.ZodBoolean>;
85
+ }, z.core.$strip>;
86
+ export type AzureSettings = z.infer<typeof AzureSettingsSchema>;
87
+ export declare const SapSettingsSchema: z.ZodObject<{
88
+ clientId: z.ZodOptional<z.ZodString>;
89
+ clientSecret: z.ZodOptional<z.ZodString>;
90
+ tokenUrl: z.ZodOptional<z.ZodString>;
91
+ resourceGroup: z.ZodOptional<z.ZodString>;
92
+ deploymentId: z.ZodOptional<z.ZodString>;
93
+ useOrchestrationMode: z.ZodOptional<z.ZodBoolean>;
94
+ api: z.ZodOptional<z.ZodEnum<{
95
+ orchestration: "orchestration";
96
+ "foundation-models": "foundation-models";
97
+ }>>;
98
+ defaultSettings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
99
+ }, z.core.$strip>;
100
+ export type SapSettings = z.infer<typeof SapSettingsSchema>;
101
+ export declare const OcaSettingsSchema: z.ZodObject<{
102
+ mode: z.ZodOptional<z.ZodEnum<{
103
+ internal: "internal";
104
+ external: "external";
105
+ }>>;
106
+ usePromptCache: z.ZodOptional<z.ZodBoolean>;
107
+ }, z.core.$strip>;
108
+ export type OcaSettings = z.infer<typeof OcaSettingsSchema>;
109
+ export declare const ModelCatalogSettingsSchema: z.ZodObject<{
110
+ loadLatestOnInit: z.ZodOptional<z.ZodBoolean>;
111
+ loadPrivateOnAuth: z.ZodOptional<z.ZodBoolean>;
112
+ url: z.ZodOptional<z.ZodString>;
113
+ cacheTtlMs: z.ZodOptional<z.ZodNumber>;
114
+ failOnError: z.ZodOptional<z.ZodBoolean>;
115
+ }, z.core.$strip>;
116
+ export type ModelCatalogSettings = z.infer<typeof ModelCatalogSettingsSchema>;
117
+ export type ModelCatalogConfig = ModelCatalogSettings;
118
+ export declare const ProviderSettingsSchema: z.ZodObject<{
119
+ provider: z.ZodString;
120
+ apiKey: z.ZodOptional<z.ZodString>;
121
+ auth: z.ZodOptional<z.ZodObject<{
122
+ apiKey: z.ZodOptional<z.ZodString>;
123
+ accessToken: z.ZodOptional<z.ZodString>;
124
+ refreshToken: z.ZodOptional<z.ZodString>;
125
+ expiresAt: z.ZodOptional<z.ZodNumber>;
126
+ accountId: z.ZodOptional<z.ZodString>;
127
+ }, z.core.$strip>>;
128
+ model: z.ZodOptional<z.ZodString>;
129
+ protocol: z.ZodOptional<z.ZodEnum<{
130
+ "openai-responses": "openai-responses";
131
+ anthropic: "anthropic";
132
+ gemini: "gemini";
133
+ "openai-r1": "openai-r1";
134
+ "ai-sdk": "ai-sdk";
135
+ "openai-chat": "openai-chat";
136
+ }>>;
137
+ client: z.ZodOptional<z.ZodEnum<{
138
+ custom: "custom";
139
+ anthropic: "anthropic";
140
+ bedrock: "bedrock";
141
+ gemini: "gemini";
142
+ vertex: "vertex";
143
+ openai: "openai";
144
+ "openai-r1": "openai-r1";
145
+ "ai-sdk": "ai-sdk";
146
+ "ai-sdk-community": "ai-sdk-community";
147
+ "openai-compatible": "openai-compatible";
148
+ fetch: "fetch";
149
+ }>>;
150
+ routingProviderId: z.ZodOptional<z.ZodString>;
151
+ maxTokens: z.ZodOptional<z.ZodNumber>;
152
+ contextWindow: z.ZodOptional<z.ZodNumber>;
153
+ baseUrl: z.ZodOptional<z.ZodString>;
154
+ headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
155
+ timeout: z.ZodOptional<z.ZodNumber>;
156
+ reasoning: z.ZodOptional<z.ZodObject<{
157
+ enabled: z.ZodOptional<z.ZodBoolean>;
158
+ effort: z.ZodOptional<z.ZodEnum<{
159
+ low: "low";
160
+ medium: "medium";
161
+ high: "high";
162
+ xhigh: "xhigh";
163
+ none: "none";
164
+ }>>;
165
+ budgetTokens: z.ZodOptional<z.ZodNumber>;
166
+ }, z.core.$strip>>;
167
+ aws: z.ZodOptional<z.ZodObject<{
168
+ accessKey: z.ZodOptional<z.ZodString>;
169
+ secretKey: z.ZodOptional<z.ZodString>;
170
+ sessionToken: z.ZodOptional<z.ZodString>;
171
+ region: z.ZodOptional<z.ZodString>;
172
+ profile: z.ZodOptional<z.ZodString>;
173
+ authentication: z.ZodOptional<z.ZodEnum<{
174
+ "api-key": "api-key";
175
+ profile: "profile";
176
+ iam: "iam";
177
+ apikey: "apikey";
178
+ }>>;
179
+ usePromptCache: z.ZodOptional<z.ZodBoolean>;
180
+ useCrossRegionInference: z.ZodOptional<z.ZodBoolean>;
181
+ useGlobalInference: z.ZodOptional<z.ZodBoolean>;
182
+ endpoint: z.ZodOptional<z.ZodString>;
183
+ customModelBaseId: z.ZodOptional<z.ZodString>;
184
+ }, z.core.$strip>>;
185
+ gcp: z.ZodOptional<z.ZodObject<{
186
+ projectId: z.ZodOptional<z.ZodString>;
187
+ region: z.ZodOptional<z.ZodString>;
188
+ }, z.core.$strip>>;
189
+ azure: z.ZodOptional<z.ZodObject<{
190
+ apiVersion: z.ZodOptional<z.ZodString>;
191
+ useIdentity: z.ZodOptional<z.ZodBoolean>;
192
+ }, z.core.$strip>>;
193
+ sap: z.ZodOptional<z.ZodObject<{
194
+ clientId: z.ZodOptional<z.ZodString>;
195
+ clientSecret: z.ZodOptional<z.ZodString>;
196
+ tokenUrl: z.ZodOptional<z.ZodString>;
197
+ resourceGroup: z.ZodOptional<z.ZodString>;
198
+ deploymentId: z.ZodOptional<z.ZodString>;
199
+ useOrchestrationMode: z.ZodOptional<z.ZodBoolean>;
200
+ api: z.ZodOptional<z.ZodEnum<{
201
+ orchestration: "orchestration";
202
+ "foundation-models": "foundation-models";
203
+ }>>;
204
+ defaultSettings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
205
+ }, z.core.$strip>>;
206
+ oca: z.ZodOptional<z.ZodObject<{
207
+ mode: z.ZodOptional<z.ZodEnum<{
208
+ internal: "internal";
209
+ external: "external";
210
+ }>>;
211
+ usePromptCache: z.ZodOptional<z.ZodBoolean>;
212
+ }, z.core.$strip>>;
213
+ region: z.ZodOptional<z.ZodString>;
214
+ apiLine: z.ZodOptional<z.ZodEnum<{
215
+ china: "china";
216
+ international: "international";
217
+ }>>;
218
+ capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
219
+ tools: "tools";
220
+ reasoning: "reasoning";
221
+ streaming: "streaming";
222
+ "prompt-cache": "prompt-cache";
223
+ "computer-use": "computer-use";
224
+ oauth: "oauth";
225
+ vision: "vision";
226
+ popular: "popular";
227
+ }>>>;
228
+ modelCatalog: z.ZodOptional<z.ZodObject<{
229
+ loadLatestOnInit: z.ZodOptional<z.ZodBoolean>;
230
+ loadPrivateOnAuth: z.ZodOptional<z.ZodBoolean>;
231
+ url: z.ZodOptional<z.ZodString>;
232
+ cacheTtlMs: z.ZodOptional<z.ZodNumber>;
233
+ failOnError: z.ZodOptional<z.ZodBoolean>;
234
+ }, z.core.$strip>>;
235
+ }, z.core.$strip>;
236
+ export type ProviderSettings = z.infer<typeof ProviderSettingsSchema>;
237
+ export interface ToProviderConfigOptions {
238
+ includeKnownModels?: boolean;
239
+ }
240
+ export declare function parseSettings(input: unknown): ProviderSettings;
241
+ export declare function safeParseSettings(input: unknown): ReturnType<typeof ProviderSettingsSchema.safeParse>;
242
+ export declare function toProviderConfig(settings: ProviderSettings, options?: ToProviderConfigOptions): ProviderConfig;
243
+ export declare function createProviderConfig(input: unknown): ProviderConfig;
244
+ export declare function safeCreateProviderConfig(input: unknown): {
245
+ success: true;
246
+ config: ProviderConfig;
247
+ } | {
248
+ success: false;
249
+ error: z.ZodError;
250
+ };
@@ -0,0 +1,3 @@
1
+ import type { LlmsConfig } from "./runtime-types";
2
+ export declare function defineLlmsConfig(config: LlmsConfig): LlmsConfig;
3
+ export declare function loadLlmsConfigFromFile(configPath: string): Promise<LlmsConfig>;
@@ -0,0 +1,19 @@
1
+ import type { ApiHandler } from "@cline/llms";
2
+ import type { BuiltInProviderSummary, CreateHandlerInput, LlmsConfig, LlmsSdk, RegisterBuiltinProviderInput, RegisteredProviderSummary, RegisterModelInput, RegisterProviderInput } from "./runtime-types";
3
+ export declare class DefaultLlmsSdk implements LlmsSdk {
4
+ private readonly configuredProviders;
5
+ constructor(config: LlmsConfig);
6
+ createHandler(input: CreateHandlerInput): ApiHandler;
7
+ createHandlerAsync(input: CreateHandlerInput): Promise<ApiHandler>;
8
+ registerProvider(input: RegisterProviderInput): void;
9
+ registerBuiltinProvider(input: RegisterBuiltinProviderInput): void;
10
+ registerModel(input: RegisterModelInput): void;
11
+ getProviders(): RegisteredProviderSummary[];
12
+ getBuiltInProviderIds(): import("@cline/llms").BUILT_IN_PROVIDER[];
13
+ getBuiltInProviders(): Promise<BuiltInProviderSummary[]>;
14
+ getModels(providerId: string): string[];
15
+ isProviderConfigured(providerId: string): boolean;
16
+ isModelConfigured(providerId: string, modelId: string): boolean;
17
+ private applyConfig;
18
+ }
19
+ export declare function createLlmsSdk(config: LlmsConfig): LlmsSdk;
@@ -0,0 +1,84 @@
1
+ import type { ApiHandler, BuiltInProviderId, HandlerFactory, LazyHandlerFactory, ModelCollection, ModelInfo, CatalogProviderCapability as ModelProviderCapability, ProviderClient, ProviderConfig, ProviderInfo, ProviderProtocol } from "@cline/llms";
2
+ import type { ProviderCapability } from "./provider-settings";
3
+ export type ProviderConfigDefaults = Omit<ProviderConfig, "providerId" | "modelId">;
4
+ export interface ProviderSelectionConfig {
5
+ id: string;
6
+ models: string[];
7
+ defaultModel?: string;
8
+ builtinProviderId?: BuiltInProviderId;
9
+ apiKey?: string;
10
+ apiKeyEnv?: string;
11
+ baseUrl?: string;
12
+ headers?: Record<string, string>;
13
+ timeoutMs?: number;
14
+ capabilities?: ProviderCapability[];
15
+ settings?: ProviderConfigDefaults;
16
+ }
17
+ export interface AdditionalModelConfig {
18
+ providerId: string;
19
+ modelId: string;
20
+ info: ModelInfo;
21
+ }
22
+ export interface CustomProviderConfig {
23
+ collection: ModelCollection;
24
+ defaults?: ProviderConfigDefaults;
25
+ handlerFactory?: HandlerFactory;
26
+ asyncHandlerFactory?: LazyHandlerFactory;
27
+ }
28
+ export interface LlmsConfig {
29
+ providers: ProviderSelectionConfig[];
30
+ models?: AdditionalModelConfig[];
31
+ customProviders?: CustomProviderConfig[];
32
+ }
33
+ export interface CreateHandlerInput {
34
+ providerId: string;
35
+ modelId?: string;
36
+ overrides?: ProviderConfigDefaults;
37
+ }
38
+ export interface RegisteredProviderSummary {
39
+ id: string;
40
+ models: string[];
41
+ defaultModel: string;
42
+ }
43
+ export interface BuiltInProviderSummary extends Pick<ProviderInfo, "id" | "name" | "description" | "protocol" | "baseUrl" | "capabilities" | "env"> {
44
+ models: string[];
45
+ defaultModel: string;
46
+ modelCount: number;
47
+ }
48
+ export interface RegisterBuiltinProviderInput {
49
+ id: string;
50
+ builtinProviderId: BuiltInProviderId;
51
+ models: Record<string, ModelInfo>;
52
+ name?: string;
53
+ description?: string;
54
+ protocol?: ProviderProtocol;
55
+ baseUrl?: string;
56
+ client?: ProviderClient;
57
+ capabilities?: ModelProviderCapability[];
58
+ env?: string[];
59
+ defaultModel?: string;
60
+ defaults?: ProviderConfigDefaults;
61
+ exposeModels?: string[];
62
+ }
63
+ export interface RegisterProviderInput extends CustomProviderConfig {
64
+ exposeModels?: string[];
65
+ defaultModel?: string;
66
+ }
67
+ export interface RegisterModelInput {
68
+ providerId: string;
69
+ modelId: string;
70
+ info: ModelInfo;
71
+ }
72
+ export interface LlmsSdk {
73
+ createHandler(input: CreateHandlerInput): ApiHandler;
74
+ createHandlerAsync(input: CreateHandlerInput): Promise<ApiHandler>;
75
+ registerProvider(input: RegisterProviderInput): void;
76
+ registerBuiltinProvider(input: RegisterBuiltinProviderInput): void;
77
+ registerModel(input: RegisterModelInput): void;
78
+ getProviders(): RegisteredProviderSummary[];
79
+ getBuiltInProviderIds(): BuiltInProviderId[];
80
+ getBuiltInProviders(): Promise<BuiltInProviderSummary[]>;
81
+ getModels(providerId: string): string[];
82
+ isProviderConfigured(providerId: string): boolean;
83
+ isModelConfigured(providerId: string, modelId: string): boolean;
84
+ }
@@ -0,0 +1,45 @@
1
+ import type { AgentConfig, AgentHooks, AgentTool, ITelemetryService, ToolApprovalRequest, ToolApprovalResult, WorkspaceInfo } from "@cline/shared";
2
+ import type { TeamEvent } from "../extensions/tools/team";
3
+ import type { RuntimeCapabilities } from "../runtime/capabilities";
4
+ import type { LocalRuntimeStartOptions, StartSessionInput } from "../runtime/host/runtime-host";
5
+ import type { RuntimeBuilderInput } from "../runtime/orchestration/session-runtime";
6
+ import type { CoreSessionConfig } from "../types/config";
7
+ import { type ProviderConfig } from "../types/provider-settings";
8
+ import type { ProviderSettingsManager } from "./storage/provider-settings-manager";
9
+ export interface PrepareLocalRuntimeBootstrapOptions {
10
+ input: StartSessionInput;
11
+ localRuntime?: LocalRuntimeStartOptions;
12
+ sessionId: string;
13
+ providerSettingsManager: ProviderSettingsManager;
14
+ defaultTelemetry?: ITelemetryService;
15
+ defaultCapabilities?: RuntimeCapabilities;
16
+ defaultToolPolicies?: AgentConfig["toolPolicies"];
17
+ /**
18
+ * Host-level default `fetch` threaded into `ProviderConfig.fetch` so the
19
+ * AI gateway providers can use a custom HTTP implementation.
20
+ */
21
+ defaultFetch?: typeof fetch;
22
+ onPluginEvent: (event: {
23
+ name: string;
24
+ payload?: unknown;
25
+ }) => void;
26
+ onTeamEvent: (event: TeamEvent) => void;
27
+ createSpawnTool: () => AgentTool;
28
+ readSessionMetadata: () => Promise<Record<string, unknown> | undefined>;
29
+ writeSessionMetadata: (metadata: Record<string, unknown>) => Promise<void> | void;
30
+ }
31
+ export interface LocalRuntimeBootstrap {
32
+ effectiveInput: StartSessionInput;
33
+ config: CoreSessionConfig;
34
+ providerConfig: ProviderConfig;
35
+ workspaceMetadata: string;
36
+ /** Structured git + path metadata generated alongside workspaceMetadata. */
37
+ workspaceInfo: WorkspaceInfo;
38
+ extensions: AgentConfig["extensions"];
39
+ hooks: AgentHooks | undefined;
40
+ toolPolicies: AgentConfig["toolPolicies"];
41
+ requestToolApproval?: (request: ToolApprovalRequest) => Promise<ToolApprovalResult> | ToolApprovalResult;
42
+ pluginSandboxShutdown?: () => Promise<void>;
43
+ runtimeBuilderInput: RuntimeBuilderInput;
44
+ }
45
+ export declare function prepareLocalRuntimeBootstrap(options: PrepareLocalRuntimeBootstrapOptions): Promise<LocalRuntimeBootstrap>;
@@ -0,0 +1,28 @@
1
+ import type { PluginInitializationFailure, PluginInitializationWarning } from "../extensions/plugin/plugin-load-report";
2
+ export interface PluginToolSummary {
3
+ name: string;
4
+ pluginName: string;
5
+ path: string;
6
+ source: "workspace-plugin" | "global-plugin";
7
+ enabled: boolean;
8
+ description?: string;
9
+ }
10
+ export interface ListPluginToolsResult {
11
+ tools: PluginToolSummary[];
12
+ failures: PluginInitializationFailure[];
13
+ warnings: PluginInitializationWarning[];
14
+ }
15
+ export declare function listPluginToolsWithDiagnostics(input: {
16
+ workspacePath: string;
17
+ cwd?: string;
18
+ disabledToolNames?: ReadonlyArray<string>;
19
+ providerId?: string;
20
+ modelId?: string;
21
+ }): Promise<ListPluginToolsResult>;
22
+ export declare function listPluginTools(input: {
23
+ workspacePath: string;
24
+ cwd?: string;
25
+ disabledToolNames?: ReadonlyArray<string>;
26
+ providerId?: string;
27
+ modelId?: string;
28
+ }): Promise<PluginToolSummary[]>;