@sctg/cline-shared 3.84.0-beta.20260524130712

package/dist/prompt/cline.d.ts

@@ -0,0 +1,24 @@
+import type { WorkspaceContext } from "../extensions/context";
+import type { WorkspaceInfo } from "../session/workspace";
+export declare function processWorkspaceInfo(info: WorkspaceInfo): string;
+/**
+ * Options for building the Cline system prompt.
+ *
+ * Extends WorkspaceContext so callers can spread an ExtensionContext.workspace
+ * directly. `workspaceRoot` is accepted as an alias for `rootPath` to support
+ * existing call sites that set it explicitly.
+ */
+export interface ClineSystemPromptOptions extends Omit<WorkspaceContext, "rootPath"> {
+    /**
+     * Workspace root path. Accepts either `rootPath` (from WorkspaceContext/WorkspaceInfo)
+     * or `workspaceRoot` (legacy alias) — whichever is provided will be used.
+     */
+    rootPath?: string;
+    /** Alias for rootPath — kept for backwards compatibility with existing call sites */
+    workspaceRoot?: string;
+    /** Per-request system prompt override */
+    overridePrompt?: string;
+    /** Provider ID — used to gate Cline-specific metadata injection */
+    providerId?: string;
+}
+export declare function buildClineSystemPrompt(options: ClineSystemPromptOptions): string;

package/dist/prompt/format.d.ts

@@ -0,0 +1,11 @@
+export declare function formatFileContentBlock(path: string, content: string): string;
+export declare function formatUserInputBlock(input: string, mode?: "act" | "plan" | "yolo"): string;
+export declare function formatUserCommandBlock(input: string, slash: string): string;
+export type UserCommandEnvelope = {
+    slash: string;
+    content: string;
+};
+export declare function parseUserCommandEnvelope(input?: string): UserCommandEnvelope | undefined;
+export declare function normalizeUserInput(input?: string): string;
+export declare function formatDisplayUserInput(input?: string): string;
+export declare function xmlTagsRemoval(input?: string, tag?: string): string;

package/dist/prompt/system.d.ts

@@ -0,0 +1,2 @@
+export declare const DEFAULT_CLINE_SYSTEM_PROMPT = "You are Cline, an AI coding agent. Your primary goal is to assist users with various coding tasks by leveraging your knowledge and the tools at your disposal. Given the user's prompt, you should use the tools available to you to answer user's question.\n\nAlways gather all the necessary context before starting to work on a task. For example, if you are generating a unit test or new code, make sure you understand the requirement, the naming conventions, frameworks and libraries used and aligned in the current codebase, and the environment and commands used to run and test the code etc. Always validate the new unit test at the end including running the code if possible for live feedback.\nReview each question carefully and answer it with detailed, accurate information.\nIf you need more information, use one of the available tools or ask for clarification instead of making assumptions or lies.\n\nEnvironment you are running in:\n<env>\n1. Platform: {{PLATFORM_NAME}}\n2. Date: {{CURRENT_DATE}}\n3. IDE: {{IDE_NAME}}\n4. Working Directory: {{CWD}}\n</env>\n\nRemember:\n- Always adhere to existing code conventions and patterns.\n- Use only libraries and frameworks that are confirmed to be in use in the current codebase.\n- Provide complete and functional code without omissions or placeholders.\n- Be explicit about any assumptions or limitations in your solution.\n- Always show your planning process before executing any task. This will help ensure that you have a clear understanding of the requirements and that your approach aligns with the user's needs.\n- Always use absolute paths when referring to files.\n- Always verify the files you have edited or created at the end of the task to ensure they are completed and working as expected.\n\nBegin by analyzing the user's input and gathering any necessary additional context. Then, present your plan at the start of your response along with tool calls before proceeding with the task. It's OK for this section to be quite long.\n\nREMEMBER, be helpful and proactive! Don't ask for permission to do something when you can do it! Do not indicates you will be using a tool unless you are actually going to use it.\n\nIMPORTANT: Always includes tool calls in your response until the task is completed. Response without tool calls will considered as completed with final answer.\n\nWhen you have completed the task, please provide a summary of what you did and any relevant information that the user should know. This will help ensure that the user understands the changes made and can easily follow up if they have any questions or need further assistance. Do not indicate that you will perform an action without actually doing it. Always provide the final result in your response. Always validate your answer with checking the code and running it if possible. \n\nIf user asked a simple question without any coding context, answer it directly without using any tools.\n{{CLINE_RULES}}\n{{CLINE_METADATA}}";
+export declare const YOLO_CLINE_SYSTEM_PROMPT = "You are Cline, a careful and helpful coding agent that works in the background.\nYou are tasked to solve an issue reported by the user who you cannot communicate with directly.\nYour goal is to utilize the tools at your disposal to investigate and answer the question according to user's instructions with the aim to verify that the issue is resolved.\n\nRULES:\n- Always match output format exactly as shown in examples or existing files.\n- Use only libraries and frameworks that are confirmed and compatible to be in use in the current codebase.\n- Provide complete and functional code without omissions or placeholders.\n- Always show your planning process without repeating yourself before executing any task. This will help ensure that you have a clear understanding of the requirements and that your approach aligns with the user's request.\n- Always use absolute paths when referring to files.\n- Always verify the files you have edited or created at the end of the task to ensure they are completed and working as expected.\n\nEnvironment you are running in:\n<env>\n1. Platform: {{PLATFORM_NAME}}\n2. Date: {{CURRENT_DATE}}\n3. IDE: {{IDE_NAME}}\n4. Working Directory: {{CWD}}\n</env>\n\nIMPORTANT: \n- When the user describes a bug, unexpected behavior, or provides a bug report, your primary goal is to produce a correct fix in the source code that resolves the issue. \n- A correct fix means the underlying behavior is fixed \u2014 not just the symptoms addressed superficially. \n- After applying your fix, you must run the relevant test suite to confirm your changes actually resolve the problem. If tests fail, analyze the failures, revise your fix, and re-run until tests pass. \n- Do not consider the task complete until the test suite related to the files you have touched passes.\n- Always includes tool calls in your response until the task is completed. You should only end the task when all the requirements are met by calling the 'submit_and_exit' tool.\n- Response without the submit_and_exit tool call will considered not completed and the task will continue.\n{{CLINE_RULES}}\n{{CLINE_METADATA}}";

package/dist/remote-config/artifact-store.d.ts

@@ -0,0 +1,13 @@
+import type { RemoteConfigBundle, RemoteConfigBundleStore, RemoteConfigManagedArtifactStore } from "./bundle";
+export declare class FileRemoteConfigBundleStore implements RemoteConfigBundleStore {
+    private readonly filePath;
+    constructor(filePath: string);
+    read(): Promise<RemoteConfigBundle | undefined>;
+    write(bundle: RemoteConfigBundle): Promise<void>;
+    clear(): Promise<void>;
+}
+export declare class FileSystemRemoteConfigManagedArtifactStore implements RemoteConfigManagedArtifactStore {
+    writeText(filePath: string, contents: string): Promise<void>;
+    remove(targetPath: string): Promise<void>;
+    removeChildren(directoryPath: string): Promise<void>;
+}

package/dist/remote-config/blob-storage.d.ts

@@ -0,0 +1,47 @@
+import type { PromptUploading, RemoteConfig } from "./schema";
+export interface RemoteConfigBlobStoreSettings {
+    bucket: string;
+    adapterType: "s3" | "r2" | "azure";
+    accessKeyId: string;
+    secretAccessKey: string;
+    region?: string;
+    endpoint?: string;
+    accountId?: string;
+}
+export interface RemoteConfigBlobStoreTarget {
+    bucket: string;
+    adapterType: "s3" | "r2" | "azure";
+    region?: string;
+    endpoint?: string;
+    accountId?: string;
+}
+export interface RemoteConfigBlobStorageAdapter {
+    write(path: string, value: string): Promise<void>;
+}
+export interface RemoteConfigSessionBlobUploadMetadata {
+    version: 1;
+    storage: RemoteConfigBlobStoreTarget;
+    keyPrefix?: string;
+    userDistinctId?: string;
+}
+export interface RemoteConfigSessionMetadataRow {
+    metadata?: Record<string, unknown> | null;
+}
+export interface RemoteConfigSessionMessagesUploadInput {
+    sessionId: string;
+    path: string;
+    contents: string;
+    row?: RemoteConfigSessionMetadataRow;
+}
+export interface RemoteConfigSessionMessagesArtifactUploader {
+    uploadMessagesFile(input: RemoteConfigSessionMessagesUploadInput): Promise<void>;
+}
+export declare const REMOTE_CONFIG_SESSION_BLOB_UPLOAD_METADATA_KEY = "enterprise.blobUpload";
+export declare function resolveBlobStoreSettingsFromPromptUploading(promptUploading: PromptUploading | undefined): RemoteConfigBlobStoreSettings | undefined;
+export declare function resolveBlobStoreSettingsFromRemoteConfig(remoteConfig: RemoteConfig | undefined): RemoteConfigBlobStoreSettings | undefined;
+export declare function buildRemoteConfigSessionBlobUploadMetadata(remoteConfig: RemoteConfig | undefined, userDistinctId?: string): RemoteConfigSessionBlobUploadMetadata | undefined;
+export declare function registerRemoteConfigSessionBlobUpload(sessionId: string, remoteConfig: RemoteConfig | undefined, userDistinctId?: string): RemoteConfigSessionBlobUploadMetadata | undefined;
+export declare function clearRemoteConfigSessionBlobUpload(sessionId: string): void;
+export declare function createRemoteConfigBlobStorageAdapter(settings: RemoteConfigBlobStoreSettings): RemoteConfigBlobStorageAdapter | undefined;
+export declare function readRemoteConfigSessionBlobUploadMetadata(row: RemoteConfigSessionMetadataRow | undefined): RemoteConfigSessionBlobUploadMetadata | undefined;
+export declare function createRemoteConfigSessionMessagesArtifactUploader(): RemoteConfigSessionMessagesArtifactUploader;

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

@@ -0,0 +1,136 @@
+import type { AgentExtension } from "../agents/types";
+import type { BasicLogger } from "../logging/logger";
+import type { OpenTelemetryClientConfig } from "../services/telemetry";
+import type { GlobalInstructionsFile, RemoteConfig } from "./schema";
+export interface RemoteConfigIdentityClaims {
+    subject: string;
+    email?: string;
+    roles?: string[];
+    groups?: string[];
+    organizationId?: string;
+    projectIds?: string[];
+    rawClaims?: Record<string, unknown>;
+}
+export type RemoteConfigManagedInstructionKind = "rule" | "workflow" | "skill";
+export interface RemoteConfigManagedInstructionFile {
+    id: string;
+    name: string;
+    kind: RemoteConfigManagedInstructionKind;
+    contents: string;
+    alwaysEnabled?: boolean;
+    description?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface RemoteConfigBundle {
+    source: string;
+    version: string;
+    remoteConfig?: RemoteConfig;
+    managedInstructions?: RemoteConfigManagedInstructionFile[];
+    telemetry?: Record<string, unknown>;
+    claims?: RemoteConfigIdentityClaims;
+    metadata?: Record<string, unknown>;
+}
+export interface RemoteConfigProjectContext {
+    projectId?: string;
+    workspaceId?: string;
+    organizationId?: string;
+}
+export interface RemoteConfigSyncContext {
+    workspacePath: string;
+    rootPath?: string;
+    context?: RemoteConfigProjectContext;
+    logger?: BasicLogger;
+    signal?: AbortSignal;
+    now?: number;
+}
+export interface RemoteConfigControlPlaneFetchInput extends RemoteConfigSyncContext {
+}
+export interface RemoteConfigControlPlane {
+    name: string;
+    fetchBundle(input: RemoteConfigControlPlaneFetchInput): Promise<RemoteConfigBundle | undefined>;
+}
+export interface RemoteConfigBundleStore {
+    read(): Promise<RemoteConfigBundle | undefined>;
+    write(bundle: RemoteConfigBundle): Promise<void>;
+    clear(): Promise<void>;
+}
+export interface RemoteConfigManagedArtifactStore {
+    writeText(filePath: string, contents: string): Promise<void>;
+    remove(targetPath: string): Promise<void>;
+    removeChildren(directoryPath: string): Promise<void>;
+}
+export interface RemoteConfigManagedPaths {
+    pluginName: string;
+    pluginPath: string;
+    workflowsPath: string;
+    skillsPath: string;
+    bundleCachePath: string;
+    manifestPath: string;
+    rulesFilePath: string;
+}
+export interface RemoteConfigMaterializationInput {
+    bundle: RemoteConfigBundle;
+    paths: RemoteConfigManagedPaths;
+    artifactStore: RemoteConfigManagedArtifactStore;
+}
+export interface RemoteConfigMaterializedInstructionFile {
+    kind: RemoteConfigManagedInstructionKind;
+    filePath: string;
+    id: string;
+    name: string;
+}
+export interface RemoteConfigMaterializationResult {
+    paths: RemoteConfigManagedPaths;
+    rulesFilePath?: string;
+    files: RemoteConfigMaterializedInstructionFile[];
+}
+export interface RemoteConfigPolicyMaterializer {
+    materialize(input: RemoteConfigMaterializationInput): Promise<RemoteConfigMaterializationResult>;
+}
+export interface RemoteConfigTelemetryAdapter {
+    name: string;
+    resolveTelemetry(bundle: RemoteConfigBundle, context: RemoteConfigSyncContext): Promise<Partial<OpenTelemetryClientConfig> | undefined> | Partial<OpenTelemetryClientConfig> | undefined;
+}
+export interface RemoteConfigClaimsMapper<TRole extends string = string> {
+    mapClaimsToRoles(claims: RemoteConfigIdentityClaims): TRole[];
+}
+export interface RemoteConfigSyncServiceOptions {
+    controlPlane: RemoteConfigControlPlane;
+    bundleStore: RemoteConfigBundleStore;
+    materializer: RemoteConfigPolicyMaterializer;
+    artifactStore: RemoteConfigManagedArtifactStore;
+    telemetryAdapter?: RemoteConfigTelemetryAdapter;
+    claimsMapper?: RemoteConfigClaimsMapper;
+    logger?: BasicLogger;
+}
+export interface RemoteConfigSyncResult {
+    bundle: RemoteConfigBundle;
+    materialized: RemoteConfigMaterializationResult;
+    telemetry?: Partial<OpenTelemetryClientConfig>;
+    roles: string[];
+    claims?: RemoteConfigIdentityClaims;
+}
+export interface PrepareRemoteConfigRuntimeOptions extends RemoteConfigSyncContext {
+    pluginName?: string;
+    controlPlane?: RemoteConfigControlPlane;
+    bundleStore?: RemoteConfigBundleStore;
+    artifactStore?: RemoteConfigManagedArtifactStore;
+    materializer?: RemoteConfigPolicyMaterializer;
+    telemetryAdapter?: RemoteConfigTelemetryAdapter;
+    claimsMapper?: RemoteConfigClaimsMapper;
+    useCachedBundle?: boolean;
+    requireBundle?: boolean;
+}
+export interface PreparedRemoteConfigRuntime {
+    pluginName: string;
+    pluginDefinition: AgentExtension;
+    paths: RemoteConfigManagedPaths;
+    bundle?: RemoteConfigBundle;
+    telemetry?: Partial<OpenTelemetryClientConfig>;
+    roles: string[];
+    claims?: RemoteConfigIdentityClaims;
+    usedCachedBundle: boolean;
+    workflowsDirectories: readonly string[];
+    skillsDirectories: readonly string[];
+}
+export declare function remoteConfigInstructionToManagedFile(kind: Extract<RemoteConfigManagedInstructionKind, "rule" | "workflow">, file: GlobalInstructionsFile, suffix: string): RemoteConfigManagedInstructionFile;

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

@@ -0,0 +1,5 @@
+/**
+ * URI scheme for opening remote rules/workflows in the editor.
+ * Used to construct URIs like: remote://rule/{name} or remote://workflow/{name}
+ */
+export declare const REMOTE_URI_SCHEME = "remote://";

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

@@ -0,0 +1,9 @@
+export * from "./artifact-store";
+export * from "./blob-storage";
+export * from "./bundle";
+export * from "./constants";
+export * from "./materializer";
+export * from "./paths";
+export * from "./runtime";
+export * from "./schema";
+export * from "./telemetry";