mirror of
https://github.com/compiler-explorer/compiler-explorer.git
synced 2025-12-27 10:33:59 -05:00
c29ad46f3a
Add Claude Explain feature for AI-powered code explanations This PR introduces Claude Explain, a new feature that provides AI-powered explanations of compiler output directly within Compiler Explorer. Key features: Claude Explain functionality: - New explain view pane - Explains compiler output with full context of source code and compilation output - Configurable audience level and explanation type - Response caching to improve performance and reduce API calls - Usage statistics display showing requests used and token counts User experience: - Consent flow on first use explaining data handling and privacy - AI disclaimer banner warning about potential LLM inaccuracies - Respects "no-ai" directive in source code for users who don't want AI processing Privacy and security: - Data sent to Anthropic's Claude API as documented in privacy policy - No data used for model training - Clear consent required before first use - Support for opting out via "no-ai" directive The feature is marked as beta and can be enabled via configuration. Co-authored-by: Claude <noreply@anthropic.com>
89 lines
3.1 KiB
TypeScript
89 lines
3.1 KiB
TypeScript
// Copyright (c) 2021, Compiler Explorer Authors
|
|
// All rights reserved.
|
|
//
|
|
// Redistribution and use in source and binary forms, with or without
|
|
// modification, are permitted provided that the following conditions are met:
|
|
//
|
|
// * Redistributions of source code must retain the above copyright notice,
|
|
// this list of conditions and the following disclaimer.
|
|
// * Redistributions in binary form must reproduce the above copyright
|
|
// notice, this list of conditions and the following disclaimer in the
|
|
// documentation and/or other materials provided with the distribution.
|
|
//
|
|
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
|
// AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
// ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
|
|
// LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
// CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
// SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
// INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
// CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
// ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
// POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
import {CompilerInfo} from '../types/compiler.interfaces.js';
|
|
import {Language, LanguageKey} from '../types/languages.interfaces.js';
|
|
import {Tool} from '../types/tool.interfaces.js';
|
|
|
|
export type LibraryVersion = {
|
|
alias: string[];
|
|
hidden: boolean;
|
|
libId: string;
|
|
used: boolean;
|
|
version?: string;
|
|
lookupname?: string;
|
|
lookupversion?: string;
|
|
};
|
|
|
|
export type Library = {
|
|
dependencies: string[];
|
|
description?: string;
|
|
examples?: string[];
|
|
name?: string;
|
|
url?: string;
|
|
versions: Record<string, LibraryVersion>;
|
|
};
|
|
|
|
export type LanguageLibs = Record<string, Library>;
|
|
|
|
export type Libs = Record<string, LanguageLibs>;
|
|
|
|
export type LibsPerRemote = Record<string, LanguageLibs>;
|
|
|
|
// TODO: Is this the same as OptionsType in lib/options-handler.ts?
|
|
export type Options = {
|
|
libs: Libs;
|
|
remoteLibs: LibsPerRemote;
|
|
languages: Partial<Record<LanguageKey, Language>>;
|
|
compilers: CompilerInfo[];
|
|
defaultCompiler: Record<LanguageKey, string>;
|
|
defaultLibs: Record<LanguageKey, string | null>;
|
|
defaultFontScale: number;
|
|
sentryDsn?: string;
|
|
release?: string;
|
|
sentryEnvironment?: string;
|
|
compileOptions: Record<LanguageKey, string>;
|
|
tools: Record<LanguageKey, Record<string, Tool>>;
|
|
slides?: any[];
|
|
cookieDomainRe: string;
|
|
motdUrl: string;
|
|
pageloadUrl: string;
|
|
mobileViewer: boolean;
|
|
readOnly: boolean;
|
|
policies: {
|
|
cookies: {
|
|
enabled: boolean;
|
|
key: string;
|
|
};
|
|
privacy: {
|
|
enabled: boolean;
|
|
key: string;
|
|
};
|
|
};
|
|
supportsExecute: boolean;
|
|
supportsLibraryCodeFilter: boolean;
|
|
cvCompilerCountMax: number;
|
|
explainApiEndpoint: string;
|
|
};
|