@messenger-box/platform-server 10.0.3-alpha.2 → 10.0.3-alpha.202

package/lib/preferences/settings/chat-settings.d.ts

@@ -0,0 +1,248 @@
+/**
+ * Chat Configuration Settings
+ *
+ * VS Code–style chat configuration for the messenger inbox.
+ * Follows the same pattern as post-settings.ts and channel-settings.ts:
+ *   1. A prefix constant
+ *   2. A typed const object with dotted key paths
+ *   3. An IConfigurationPropertySchema map with type/default/description/scope
+ *
+ * These settings are registered via the BaseConfigurationsMigration system
+ * and can be read/written via the configuration-registry / GraphQL layer.
+ *
+ * Aligned with: https://github.com/microsoft/vscode/blob/main/src/vs/workbench/contrib/chat/common/constants.ts
+ *               https://github.com/microsoft/vscode/blob/main/src/vs/workbench/contrib/chat/browser/chat.contribution.ts
+ */
+import { IConfigurationPropertySchema } from '@adminide-stack/core';
+export declare const CHAT_SETTINGS_PREFIX = "chat";
+export declare enum ChatConfiguration {
+    AIDisabled = "chat.disableAIFeatures",
+    AllowAnonymousAccess = "chat.allowAnonymousAccess",
+    PluginsEnabled = "chat.plugins.enabled",
+    PluginPaths = "chat.plugins.paths",
+    PluginMarketplaces = "chat.plugins.marketplaces",
+    ExtensionUnificationEnabled = "chat.extensionUnification.enabled",
+    AgentEnabled = "chat.agent.enabled",
+    AgentMaxRequests = "chat.agent.maxRequests",
+    PlanAgentDefaultModel = "chat.planAgent.defaultModel",
+    ExploreAgentDefaultModel = "chat.exploreAgent.defaultModel",
+    RequestQueueingDefaultAction = "chat.requestQueuing.defaultAction",
+    AgentStatusEnabled = "chat.agentsControl.enabled",
+    AgentSessionProjectionEnabled = "chat.agentSessionProjection.enabled",
+    EditorAssociations = "chat.editorAssociations",
+    EditModeHidden = "chat.editMode.hidden",
+    Edits2Enabled = "chat.edits2.enabled",
+    EditRequests = "chat.editRequests",
+    EditingAutoAcceptDelay = "chat.editing.autoAcceptDelay",
+    EditingConfirmRemoval = "chat.editing.confirmEditRequestRemoval",
+    EditingConfirmRetry = "chat.editing.confirmEditRequestRetry",
+    ExplainChangesEnabled = "chat.editing.explainChanges.enabled",
+    FontSize = "chat.fontSize",
+    FontFamily = "chat.fontFamily",
+    EditorFontSize = "chat.editor.fontSize",
+    EditorFontFamily = "chat.editor.fontFamily",
+    EditorFontWeight = "chat.editor.fontWeight",
+    EditorWordWrap = "chat.editor.wordWrap",
+    EditorLineHeight = "chat.editor.lineHeight",
+    UnifiedAgentsBar = "chat.unifiedAgentsBar.enabled",
+    InlineReferencesStyle = "chat.inlineReferences.style",
+    ShowCodeBlockProgressAnimation = "chat.agent.codeBlockProgress",
+    RestoreLastPanelSession = "chat.restoreLastPanelSession",
+    AgentsControlClickBehavior = "chat.agentsControl.clickBehavior",
+    TipsEnabled = "chat.tips.enabled",
+    UpvoteAnimation = "chat.upvoteAnimation",
+    StatusWidgetAnonymous = "chat.statusWidget.anonymous",
+    ExtensionToolsEnabled = "chat.extensionTools.enabled",
+    RepoInfoEnabled = "chat.repoInfo.enabled",
+    UsagesToolEnabled = "chat.tools.usagesTool.enabled",
+    RenameToolEnabled = "chat.tools.renameTool.enabled",
+    AutoReply = "chat.autoReply",
+    GlobalAutoApprove = "chat.tools.global.autoApprove",
+    AutoApproveEdits = "chat.tools.edits.autoApprove",
+    AutoApprovedUrls = "chat.tools.urls.autoApprove",
+    EligibleForAutoApproval = "chat.tools.eligibleForAutoApproval",
+    AutoExpandToolFailures = "chat.tools.autoExpandFailures",
+    ThinkingStyle = "chat.agent.thinkingStyle",
+    ThinkingGenerateTitles = "chat.agent.thinking.generateTitles",
+    ThinkingCollapsedTools = "chat.agent.thinking.collapsedTools",
+    TerminalToolsInThinking = "chat.agent.thinking.terminalTools",
+    SimpleTerminalCollapsible = "chat.tools.terminal.simpleCollapsible",
+    ThinkingPhrases = "chat.agent.thinking.phrases",
+    EnableMath = "chat.math.enabled",
+    CheckpointsEnabled = "chat.checkpoints.enabled",
+    CheckpointsShowFileChanges = "chat.checkpoints.showFileChanges",
+    TodosShowWidget = "chat.tools.todos.showWidget",
+    ExitAfterDelegation = "chat.exitAfterDelegation",
+    SubagentToolCustomAgents = "chat.customAgentInSubagent.enabled",
+    UndoRequestsRestoreInput = "chat.undoRequests.restoreInput",
+    SendElementsEnabled = "chat.sendElementsToChat.enabled",
+    SendElementsAttachCSS = "chat.sendElementsToChat.attachCSS",
+    SendElementsAttachImages = "chat.sendElementsToChat.attachImages",
+    NotifyWindowOnConfirmation = "chat.notifyWindowOnConfirmation",
+    NotifyWindowOnResponseReceived = "chat.notifyWindowOnResponseReceived",
+    ChatViewSessionsEnabled = "chat.viewSessions.enabled",
+    ChatViewSessionsGrouping = "chat.viewSessions.grouping",
+    ChatViewSessionsOrientation = "chat.viewSessions.orientation",
+    ChatViewProgressBadgeEnabled = "chat.viewProgressBadge.enabled",
+    ChatContextUsageEnabled = "chat.contextUsage.enabled",
+    DetectParticipantEnabled = "chat.detectParticipant.enabled",
+    ImplicitContextEnabled = "chat.implicitContext.enabled",
+    ImplicitContextSuggestedContext = "chat.implicitContext.suggestedContext",
+    InstructionsFilesLocations = "chat.instructionsFilesLocations",
+    PromptFilesLocations = "chat.promptFilesLocations",
+    ModeFilesLocations = "chat.modeFilesLocations",
+    AgentFilesLocations = "chat.agentFilesLocations",
+    AgentSkillsLocations = "chat.agentSkillsLocations",
+    HookFilesLocations = "chat.hookFilesLocations",
+    PromptFilesRecommendations = "chat.promptFilesRecommendations",
+    UseAgentsMdFile = "chat.useAgentsMdFile",
+    UseNestedAgentsMdFiles = "chat.useNestedAgentsMdFiles",
+    UseClaudeMdFile = "chat.useClaudeMdFile",
+    UseAgentSkills = "chat.useAgentSkills",
+    UseSkillAdherencePrompt = "chat.useSkillAdherencePrompt",
+    IncludeApplyingInstructions = "chat.includeApplyingInstructions",
+    IncludeReferencedInstructions = "chat.includeReferencedInstructions",
+    UseHooks = "chat.useHooks",
+    UseClaudeHooks = "chat.useClaudeHooks",
+    McpAccess = "chat.mcp.access",
+    McpAutoStart = "chat.mcp.autostart",
+    McpAppsEnabled = "chat.mcp.apps.enabled",
+    McpDiscovery = "chat.mcp.discovery.enabled",
+    McpGalleryEnabled = "chat.mcp.gallery.enabled",
+    McpGalleryServiceUrl = "chat.mcp.gallery.serviceUrl",
+    McpServerSampling = "chat.mcp.serverSampling",
+    InlineChatFinishOnType = "inlineChat.finishOnType",
+    InlineChatHoldToSpeech = "inlineChat.holdToSpeech",
+    InlineChatEnableV2 = "inlineChat.enableV2",
+    InlineChatDefaultModel = "inlineChat.defaultModel",
+    InlineChatNotebookAgent = "inlineChat.notebookAgent",
+    InlineChatAffordance = "inlineChat.affordance",
+    InlineChatRenderMode = "inlineChat.renderMode",
+    InlineChatFixDiagnostics = "inlineChat.fixDiagnostics",
+    TerminalEnableAutoApprove = "chat.tools.terminal.enableAutoApprove",
+    TerminalAutoApprove = "chat.tools.terminal.autoApprove",
+    TerminalAutoApproveWorkspaceNpmScripts = "chat.tools.terminal.autoApproveWorkspaceNpmScripts",
+    TerminalIgnoreDefaultAutoApproveRules = "chat.tools.terminal.ignoreDefaultAutoApproveRules",
+    TerminalBlockDetectedFileWrites = "chat.tools.terminal.blockDetectedFileWrites",
+    TerminalShellIntegrationTimeout = "chat.tools.terminal.shellIntegrationTimeout",
+    TerminalAutoReplyToPrompts = "chat.tools.terminal.autoReplyToPrompts",
+    TerminalOutputLocation = "chat.tools.terminal.outputLocation",
+    TerminalSandboxEnabled = "chat.tools.terminal.sandbox.enabled",
+    TerminalSandboxNetwork = "chat.tools.terminal.sandbox.network",
+    TerminalSandboxLinuxFileSystem = "chat.tools.terminal.sandbox.linuxFileSystem",
+    TerminalSandboxMacFileSystem = "chat.tools.terminal.sandbox.macFileSystem",
+    TerminalPreventShellHistory = "chat.tools.terminal.preventShellHistory",
+    TerminalEnforceTimeoutFromModel = "chat.tools.terminal.enforceTimeoutFromModel",
+    TerminalProfileLinux = "chat.tools.terminal.terminalProfile.linux",
+    TerminalProfileMacOs = "chat.tools.terminal.terminalProfile.osx",
+    TerminalProfileWindows = "chat.tools.terminal.terminalProfile.windows",
+    GrowthNotificationEnabled = "chat.growthNotification.enabled",
+    ChatCustomizationMenuEnabled = "chat.customizationsMenu.enabled",
+    ChatCustomizationUserStoragePath = "chat.customizationsMenu.userStoragePath"
+}
+/** The kind of agent mode the user has selected. */
+export declare enum ChatModeKind {
+    Ask = "ask",
+    Edit = "edit",
+    Agent = "agent"
+}
+/** Display mode for the "thinking" UI. */
+export declare enum ThinkingDisplayMode {
+    Collapsed = "collapsed",
+    CollapsedPreview = "collapsedPreview",
+    FixedScrolling = "fixedScrolling"
+}
+/** How collapsed tools are shown alongside thinking output. */
+export declare enum CollapsedToolsDisplayMode {
+    Off = "off",
+    WithThinking = "withThinking",
+    Always = "always"
+}
+/** When the chat window sends desktop/tab notifications. */
+export declare enum ChatNotificationMode {
+    Off = "off",
+    WindowNotFocused = "windowNotFocused",
+    Always = "always"
+}
+/** Behaviour when the user clicks the agents control bar. */
+export declare enum AgentsControlClickBehavior {
+    Default = "default",
+    Cycle = "cycle"
+}
+/** Inline references render style. */
+export declare enum InlineReferencesStyle {
+    Box = "box",
+    Link = "link"
+}
+/** Sessions grouping strategy in the chat view. */
+export declare enum ChatViewSessionsGrouping {
+    None = "none",
+    Date = "date",
+    Agent = "agent"
+}
+/** Sessions list orientation. */
+export declare enum ChatViewSessionsOrientation {
+    Stacked = "stacked",
+    SideBySide = "sideBySide"
+}
+/** Upvote animation style. */
+export declare enum UpvoteAnimationStyle {
+    Off = "off",
+    Confetti = "confetti",
+    FloatingThumbs = "floatingThumbs",
+    PulseWave = "pulseWave",
+    RadiantLines = "radiantLines"
+}
+/** Edit-request display mode. */
+export declare enum EditRequestsMode {
+    Inline = "inline",
+    Hover = "hover",
+    Input = "input",
+    None = "none"
+}
+/** MCP access level. */
+export declare enum McpAccessValue {
+    None = "none",
+    Registry = "registry",
+    All = "all"
+}
+/** MCP auto-start preference. */
+export declare enum McpAutoStartValue {
+    Never = "never",
+    OnlyNew = "onlyNew",
+    NewAndOutdated = "newAndOutdated"
+}
+/** Inline chat affordance display mode. */
+export declare enum InlineChatAffordanceMode {
+    Off = "off",
+    Gutter = "gutter",
+    Editor = "editor"
+}
+/** Inline chat render mode. */
+export declare enum InlineChatRenderModeValue {
+    Zone = "zone",
+    Hover = "hover"
+}
+/** Terminal tool output location. */
+export declare enum TerminalOutputLocation {
+    Terminal = "terminal",
+    Chat = "chat"
+}
+/** Terminal block detected file writes mode. */
+export declare enum TerminalBlockFileWritesMode {
+    Never = "never",
+    OutsideWorkspace = "outsideWorkspace",
+    All = "all"
+}
+export declare function validateChatMode(mode: unknown): ChatModeKind | undefined;
+export declare function isChatMode(mode: unknown): mode is ChatModeKind;
+export declare const ChatSettings: {
+    [path: string]: IConfigurationPropertySchema;
+};
+export type ChatSettingsValues = {
+    [K in ChatConfiguration]: unknown;
+};
+/**
+ * Build a typed defaults object from the schema map.
+ */
+export declare function getChatSettingsDefaults(): ChatSettingsValues;