@codingame/monaco-vscode-chat-service-override 18.4.0 → 19.0.0

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/parsers/promptHeader/metadata/base/enum.js

@@ -0,0 +1,63 @@
+
+import { PromptStringMetadata } from './string.js';
+import { localize } from '@codingame/monaco-vscode-api/vscode/vs/nls';
+import { assert } from '@codingame/monaco-vscode-api/vscode/vs/base/common/assert';
+import { isOneOf } from '@codingame/monaco-vscode-api/vscode/vs/base/common/types';
+import { PromptMetadataError } from '../../diagnostics.js';
+import { FrontMatterSequence } from '../../../../codecs/base/frontMatterCodec/tokens/frontMatterSequence.js';
+import { FrontMatterString } from '../../../../codecs/base/frontMatterCodec/tokens/frontMatterString.js';
+import '../../../../codecs/base/simpleCodec/tokens/at.js';
+import '../../../../codecs/base/simpleCodec/tokens/tab.js';
+import '../../../../codecs/base/simpleCodec/tokens/dash.js';
+import '../../../../codecs/base/simpleCodec/tokens/hash.js';
+import '../../../../codecs/base/simpleCodec/tokens/colon.js';
+import '../../../../codecs/base/simpleCodec/tokens/quote.js';
+import '../../../../codecs/base/simpleCodec/tokens/slash.js';
+import '../../../../codecs/base/simpleCodec/tokens/space.js';
+import '../../../../codecs/base/simpleCodec/tokens/comma.js';
+import '../../../../codecs/base/simpleCodec/tokens/formFeed.js';
+import '../../../../codecs/base/simpleCodec/tokens/dollarSign.js';
+import '../../../../codecs/base/simpleCodec/tokens/verticalTab.js';
+import '../../../../codecs/base/simpleCodec/tokens/doubleQuote.js';
+import '../../../../codecs/base/simpleCodec/tokens/exclamationMark.js';
+import '../../../../codecs/base/simpleCodec/tokens/brackets.js';
+import '../../../../codecs/base/simpleCodec/tokens/curlyBraces.js';
+import '../../../../codecs/base/simpleCodec/tokens/parentheses.js';
+import '../../../../codecs/base/simpleCodec/tokens/angleBrackets.js';
+
+class PromptEnumMetadata extends PromptStringMetadata {
+    constructor(validValues, expectedRecordName, recordToken, languageId) {
+        super(expectedRecordName, recordToken, languageId);
+        this.validValues = validValues;
+    }
+    get value() {
+        return this.enumValue;
+    }
+    validate() {
+        super.validate();
+        if (this.valueToken === undefined) {
+            return this.issues;
+        }
+        assert(this.valueToken instanceof FrontMatterString
+            || this.valueToken instanceof FrontMatterSequence, `Record token must be 'string', got '${this.valueToken}'.`);
+        const { cleanText } = this.valueToken;
+        if (isOneOf(cleanText, this.validValues)) {
+            this.enumValue = cleanText;
+            return this.issues;
+        }
+        this.issues.push(( new PromptMetadataError(this.valueToken.range, ( localize(
+            5345,
+            "The '{0}' metadata must be one of {1}, got '{2}'.",
+            this.recordName,
+            ( this.validValues
+                .map((value) => {
+                return `'${value}'`;
+            })).join(' | '),
+            cleanText
+        )))));
+        delete this.valueToken;
+        return this.issues;
+    }
+}
+
+export { PromptEnumMetadata };

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/parsers/promptHeader/metadata/base/record.d.ts

@@ -0,0 +1,23 @@
+import { Range } from "@codingame/monaco-vscode-api/vscode/vs/editor/common/core/range";
+import { PromptMetadataDiagnostic, PromptMetadataError, PromptMetadataWarning } from "../../diagnostics.js";
+import { FrontMatterRecord } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/promptSyntax/codecs/base/frontMatterCodec/tokens/index";
+type TMetadataPrimitive = string | boolean;
+type TMetadataValue = TMetadataPrimitive | TMetadataPrimitive[];
+export interface IMetadataRecord<T extends TMetadataValue> {
+    readonly value: T | undefined;
+}
+export declare abstract class PromptMetadataRecord<TValue extends TMetadataValue> implements IMetadataRecord<TValue> {
+    protected readonly expectedRecordName: string;
+    protected readonly recordToken: FrontMatterRecord;
+    protected readonly languageId: string;
+    protected readonly issues: PromptMetadataDiagnostic[];
+    get range(): Range;
+    constructor(expectedRecordName: string, recordToken: FrontMatterRecord, languageId: string);
+    get recordName(): string;
+    abstract validate(): readonly PromptMetadataDiagnostic[];
+    get diagnostics(): readonly PromptMetadataDiagnostic[];
+    abstract get value(): TValue | undefined;
+    get errorDiagnostics(): readonly PromptMetadataError[];
+    get warningDiagnostics(): readonly PromptMetadataWarning[];
+}
+export {};

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/parsers/promptHeader/metadata/base/record.js

@@ -0,0 +1,37 @@
+
+import { assert } from '@codingame/monaco-vscode-api/vscode/vs/base/common/assert';
+import { PromptMetadataError, PromptMetadataWarning } from '../../diagnostics.js';
+
+class PromptMetadataRecord {
+    get range() {
+        return this.recordToken.range;
+    }
+    constructor(expectedRecordName, recordToken, languageId) {
+        this.expectedRecordName = expectedRecordName;
+        this.recordToken = recordToken;
+        this.languageId = languageId;
+        const recordName = recordToken.nameToken.text;
+        assert(recordName === expectedRecordName, `Record name must be '${expectedRecordName}', got '${recordName}'.`);
+        this.issues = [];
+    }
+    get recordName() {
+        return this.recordToken.nameToken.text;
+    }
+    get diagnostics() {
+        return this.issues;
+    }
+    get errorDiagnostics() {
+        return this.diagnostics
+            .filter((diagnostic) => {
+            return (diagnostic instanceof PromptMetadataError);
+        });
+    }
+    get warningDiagnostics() {
+        return this.diagnostics
+            .filter((diagnostic) => {
+            return (diagnostic instanceof PromptMetadataWarning);
+        });
+    }
+}
+
+export { PromptMetadataRecord };

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/parsers/promptHeader/metadata/base/string.d.ts

@@ -0,0 +1,10 @@
+import { PromptMetadataRecord } from "./record.js";
+import { PromptMetadataDiagnostic } from "../../diagnostics.js";
+import { FrontMatterSequence } from "../../../../codecs/base/frontMatterCodec/tokens/frontMatterSequence.js";
+import { FrontMatterRecord, FrontMatterString } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/promptSyntax/codecs/base/frontMatterCodec/tokens/index";
+export declare abstract class PromptStringMetadata extends PromptMetadataRecord<string> {
+    protected valueToken: FrontMatterString | FrontMatterSequence | undefined;
+    get value(): string | undefined;
+    constructor(expectedRecordName: string, recordToken: FrontMatterRecord, languageId: string);
+    validate(): readonly PromptMetadataDiagnostic[];
+}

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/parsers/promptHeader/metadata/base/string.js

@@ -0,0 +1,54 @@
+
+import { PromptMetadataRecord } from './record.js';
+import { localize } from '@codingame/monaco-vscode-api/vscode/vs/nls';
+import { PromptMetadataError } from '../../diagnostics.js';
+import { FrontMatterSequence } from '../../../../codecs/base/frontMatterCodec/tokens/frontMatterSequence.js';
+import '@codingame/monaco-vscode-api/vscode/vs/base/common/errors';
+import { FrontMatterString } from '../../../../codecs/base/frontMatterCodec/tokens/frontMatterString.js';
+import '../../../../codecs/base/simpleCodec/tokens/at.js';
+import '../../../../codecs/base/simpleCodec/tokens/tab.js';
+import '../../../../codecs/base/simpleCodec/tokens/dash.js';
+import '../../../../codecs/base/simpleCodec/tokens/hash.js';
+import '../../../../codecs/base/simpleCodec/tokens/colon.js';
+import '../../../../codecs/base/simpleCodec/tokens/quote.js';
+import '../../../../codecs/base/simpleCodec/tokens/slash.js';
+import '../../../../codecs/base/simpleCodec/tokens/space.js';
+import '../../../../codecs/base/simpleCodec/tokens/comma.js';
+import '../../../../codecs/base/simpleCodec/tokens/formFeed.js';
+import '../../../../codecs/base/simpleCodec/tokens/dollarSign.js';
+import '../../../../codecs/base/simpleCodec/tokens/verticalTab.js';
+import '../../../../codecs/base/simpleCodec/tokens/doubleQuote.js';
+import '../../../../codecs/base/simpleCodec/tokens/exclamationMark.js';
+import '../../../../codecs/base/simpleCodec/tokens/brackets.js';
+import '../../../../codecs/base/simpleCodec/tokens/curlyBraces.js';
+import '../../../../codecs/base/simpleCodec/tokens/parentheses.js';
+import '../../../../codecs/base/simpleCodec/tokens/angleBrackets.js';
+
+class PromptStringMetadata extends PromptMetadataRecord {
+    get value() {
+        return this.valueToken?.cleanText;
+    }
+    constructor(expectedRecordName, recordToken, languageId) {
+        super(expectedRecordName, recordToken, languageId);
+    }
+    validate() {
+        const { valueToken } = this.recordToken;
+        const isString = (valueToken instanceof FrontMatterString);
+        const isSequence = (valueToken instanceof FrontMatterSequence);
+        if (isString || isSequence) {
+            this.valueToken = valueToken;
+            return this.issues;
+        }
+        this.issues.push(( new PromptMetadataError(valueToken.range, ( localize(
+            5346,
+            "The '{0}' metadata must be a '{1}', got '{2}'.",
+            this.recordName,
+            'string',
+            (valueToken.valueTypeName.toString())
+        )))));
+        delete this.valueToken;
+        return this.issues;
+    }
+}
+
+export { PromptStringMetadata };

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/parsers/promptHeader/metadata/description.d.ts

@@ -0,0 +1,7 @@
+import { PromptStringMetadata } from "./base/string.js";
+import { FrontMatterRecord, FrontMatterToken } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/promptSyntax/codecs/base/frontMatterCodec/tokens/index";
+export declare class PromptDescriptionMetadata extends PromptStringMetadata {
+    get recordName(): string;
+    constructor(recordToken: FrontMatterRecord, languageId: string);
+    static isDescriptionRecord(token: FrontMatterToken): boolean;
+}

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/parsers/promptHeader/metadata/description.js

@@ -0,0 +1,43 @@
+
+import { PromptStringMetadata } from './base/string.js';
+import '@codingame/monaco-vscode-api/vscode/vs/base/common/errors';
+import '../../../codecs/base/simpleCodec/tokens/at.js';
+import '../../../codecs/base/simpleCodec/tokens/tab.js';
+import '../../../codecs/base/simpleCodec/tokens/dash.js';
+import '../../../codecs/base/simpleCodec/tokens/hash.js';
+import '../../../codecs/base/simpleCodec/tokens/colon.js';
+import '../../../codecs/base/simpleCodec/tokens/quote.js';
+import '../../../codecs/base/simpleCodec/tokens/slash.js';
+import '../../../codecs/base/simpleCodec/tokens/space.js';
+import '../../../codecs/base/simpleCodec/tokens/comma.js';
+import '../../../codecs/base/simpleCodec/tokens/formFeed.js';
+import '../../../codecs/base/simpleCodec/tokens/dollarSign.js';
+import '../../../codecs/base/simpleCodec/tokens/verticalTab.js';
+import '../../../codecs/base/simpleCodec/tokens/doubleQuote.js';
+import '../../../codecs/base/simpleCodec/tokens/exclamationMark.js';
+import '../../../codecs/base/simpleCodec/tokens/brackets.js';
+import '../../../codecs/base/simpleCodec/tokens/curlyBraces.js';
+import '../../../codecs/base/simpleCodec/tokens/parentheses.js';
+import '../../../codecs/base/simpleCodec/tokens/angleBrackets.js';
+import { FrontMatterRecord } from '../../../codecs/base/frontMatterCodec/tokens/frontMatterRecord.js';
+
+const RECORD_NAME = 'description';
+class PromptDescriptionMetadata extends PromptStringMetadata {
+    get recordName() {
+        return RECORD_NAME;
+    }
+    constructor(recordToken, languageId) {
+        super(RECORD_NAME, recordToken, languageId);
+    }
+    static isDescriptionRecord(token) {
+        if ((token instanceof FrontMatterRecord) === false) {
+            return false;
+        }
+        if (token.nameToken.text === RECORD_NAME) {
+            return true;
+        }
+        return false;
+    }
+}
+
+export { PromptDescriptionMetadata };

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/parsers/promptHeader/metadata/mode.d.ts

@@ -0,0 +1,7 @@
+import { ChatModeKind } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/constants";
+import { PromptEnumMetadata } from "./base/enum.js";
+import { FrontMatterRecord, FrontMatterToken } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/promptSyntax/codecs/base/frontMatterCodec/tokens/index";
+export declare class PromptModeMetadata extends PromptEnumMetadata<ChatModeKind> {
+    constructor(recordToken: FrontMatterRecord, languageId: string);
+    static isModeRecord(token: FrontMatterToken): boolean;
+}

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/parsers/promptHeader/metadata/mode.js

@@ -0,0 +1,41 @@
+
+import { ChatModeKind } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/constants';
+import { PromptEnumMetadata } from './base/enum.js';
+import '@codingame/monaco-vscode-api/vscode/vs/base/common/errors';
+import '../../../codecs/base/simpleCodec/tokens/at.js';
+import '../../../codecs/base/simpleCodec/tokens/tab.js';
+import '../../../codecs/base/simpleCodec/tokens/dash.js';
+import '../../../codecs/base/simpleCodec/tokens/hash.js';
+import '../../../codecs/base/simpleCodec/tokens/colon.js';
+import '../../../codecs/base/simpleCodec/tokens/quote.js';
+import '../../../codecs/base/simpleCodec/tokens/slash.js';
+import '../../../codecs/base/simpleCodec/tokens/space.js';
+import '../../../codecs/base/simpleCodec/tokens/comma.js';
+import '../../../codecs/base/simpleCodec/tokens/formFeed.js';
+import '../../../codecs/base/simpleCodec/tokens/dollarSign.js';
+import '../../../codecs/base/simpleCodec/tokens/verticalTab.js';
+import '../../../codecs/base/simpleCodec/tokens/doubleQuote.js';
+import '../../../codecs/base/simpleCodec/tokens/exclamationMark.js';
+import '../../../codecs/base/simpleCodec/tokens/brackets.js';
+import '../../../codecs/base/simpleCodec/tokens/curlyBraces.js';
+import '../../../codecs/base/simpleCodec/tokens/parentheses.js';
+import '../../../codecs/base/simpleCodec/tokens/angleBrackets.js';
+import { FrontMatterRecord } from '../../../codecs/base/frontMatterCodec/tokens/frontMatterRecord.js';
+
+const RECORD_NAME = 'mode';
+class PromptModeMetadata extends PromptEnumMetadata {
+    constructor(recordToken, languageId) {
+        super([ChatModeKind.Ask, ChatModeKind.Edit, ChatModeKind.Agent], RECORD_NAME, recordToken, languageId);
+    }
+    static isModeRecord(token) {
+        if ((token instanceof FrontMatterRecord) === false) {
+            return false;
+        }
+        if (token.nameToken.text === RECORD_NAME) {
+            return true;
+        }
+        return false;
+    }
+}
+
+export { PromptModeMetadata };

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/parsers/promptHeader/metadata/model.d.ts

@@ -0,0 +1,7 @@
+import { FrontMatterRecord, FrontMatterToken } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/promptSyntax/codecs/base/frontMatterCodec/tokens/index";
+import { PromptStringMetadata } from "./base/string.js";
+export declare class PromptModelMetadata extends PromptStringMetadata {
+    get recordName(): string;
+    constructor(recordToken: FrontMatterRecord, languageId: string);
+    static isModelRecord(token: FrontMatterToken): boolean;
+}

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/parsers/promptHeader/metadata/model.js

@@ -0,0 +1,43 @@
+
+import '@codingame/monaco-vscode-api/vscode/vs/base/common/errors';
+import '../../../codecs/base/simpleCodec/tokens/at.js';
+import '../../../codecs/base/simpleCodec/tokens/tab.js';
+import '../../../codecs/base/simpleCodec/tokens/dash.js';
+import '../../../codecs/base/simpleCodec/tokens/hash.js';
+import '../../../codecs/base/simpleCodec/tokens/colon.js';
+import '../../../codecs/base/simpleCodec/tokens/quote.js';
+import '../../../codecs/base/simpleCodec/tokens/slash.js';
+import '../../../codecs/base/simpleCodec/tokens/space.js';
+import '../../../codecs/base/simpleCodec/tokens/comma.js';
+import '../../../codecs/base/simpleCodec/tokens/formFeed.js';
+import '../../../codecs/base/simpleCodec/tokens/dollarSign.js';
+import '../../../codecs/base/simpleCodec/tokens/verticalTab.js';
+import '../../../codecs/base/simpleCodec/tokens/doubleQuote.js';
+import '../../../codecs/base/simpleCodec/tokens/exclamationMark.js';
+import '../../../codecs/base/simpleCodec/tokens/brackets.js';
+import '../../../codecs/base/simpleCodec/tokens/curlyBraces.js';
+import '../../../codecs/base/simpleCodec/tokens/parentheses.js';
+import '../../../codecs/base/simpleCodec/tokens/angleBrackets.js';
+import { FrontMatterRecord } from '../../../codecs/base/frontMatterCodec/tokens/frontMatterRecord.js';
+import { PromptStringMetadata } from './base/string.js';
+
+const RECORD_NAME = 'model';
+class PromptModelMetadata extends PromptStringMetadata {
+    get recordName() {
+        return RECORD_NAME;
+    }
+    constructor(recordToken, languageId) {
+        super(RECORD_NAME, recordToken, languageId);
+    }
+    static isModelRecord(token) {
+        if ((token instanceof FrontMatterRecord) === false) {
+            return false;
+        }
+        if (token.nameToken.text === RECORD_NAME) {
+            return true;
+        }
+        return false;
+    }
+}
+
+export { PromptModelMetadata };

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/parsers/promptHeader/metadata/tools.d.ts

@@ -0,0 +1,15 @@
+import { PromptMetadataRecord } from "./base/record.js";
+import { PromptMetadataDiagnostic } from "../diagnostics.js";
+import { FrontMatterArray, FrontMatterRecord, FrontMatterToken } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/promptSyntax/codecs/base/frontMatterCodec/tokens/index";
+import { Range } from "@codingame/monaco-vscode-api/vscode/vs/editor/common/core/range";
+export declare class PromptToolsMetadata extends PromptMetadataRecord<string[]> {
+    get value(): string[] | undefined;
+    get recordName(): string;
+    protected valueToken: FrontMatterArray | undefined;
+    private validToolNames;
+    constructor(recordToken: FrontMatterRecord, languageId: string);
+    validate(): readonly PromptMetadataDiagnostic[];
+    getToolRange(toolName: string): Range | undefined;
+    private validateToolName;
+    static isToolsRecord(token: FrontMatterToken): boolean;
+}

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/parsers/promptHeader/metadata/tools.js

@@ -0,0 +1,98 @@
+
+import { PromptMetadataRecord } from './base/record.js';
+import { localize } from '@codingame/monaco-vscode-api/vscode/vs/nls';
+import { PromptMetadataError, PromptMetadataWarning } from '../diagnostics.js';
+import { FrontMatterSequence } from '../../../codecs/base/frontMatterCodec/tokens/frontMatterSequence.js';
+import { FrontMatterArray } from '../../../codecs/base/frontMatterCodec/tokens/frontMatterArray.js';
+import { FrontMatterString } from '../../../codecs/base/frontMatterCodec/tokens/frontMatterString.js';
+import '../../../codecs/base/simpleCodec/tokens/at.js';
+import '../../../codecs/base/simpleCodec/tokens/tab.js';
+import '../../../codecs/base/simpleCodec/tokens/dash.js';
+import '../../../codecs/base/simpleCodec/tokens/hash.js';
+import '@codingame/monaco-vscode-api/vscode/vs/base/common/errors';
+import '../../../codecs/base/simpleCodec/tokens/colon.js';
+import '../../../codecs/base/simpleCodec/tokens/quote.js';
+import '../../../codecs/base/simpleCodec/tokens/slash.js';
+import '../../../codecs/base/simpleCodec/tokens/space.js';
+import '../../../codecs/base/simpleCodec/tokens/comma.js';
+import '../../../codecs/base/simpleCodec/tokens/formFeed.js';
+import '../../../codecs/base/simpleCodec/tokens/dollarSign.js';
+import '../../../codecs/base/simpleCodec/tokens/verticalTab.js';
+import '../../../codecs/base/simpleCodec/tokens/doubleQuote.js';
+import '../../../codecs/base/simpleCodec/tokens/exclamationMark.js';
+import '../../../codecs/base/simpleCodec/tokens/brackets.js';
+import '../../../codecs/base/simpleCodec/tokens/curlyBraces.js';
+import '../../../codecs/base/simpleCodec/tokens/parentheses.js';
+import '../../../codecs/base/simpleCodec/tokens/angleBrackets.js';
+import { FrontMatterRecord } from '../../../codecs/base/frontMatterCodec/tokens/frontMatterRecord.js';
+
+const RECORD_NAME = 'tools';
+class PromptToolsMetadata extends PromptMetadataRecord {
+    get value() {
+        if (this.validToolNames === undefined) {
+            return [];
+        }
+        return [...( this.validToolNames.keys())];
+    }
+    get recordName() {
+        return RECORD_NAME;
+    }
+    constructor(recordToken, languageId) {
+        super(RECORD_NAME, recordToken, languageId);
+    }
+    validate() {
+        const { valueToken } = this.recordToken;
+        if ((valueToken instanceof FrontMatterArray) === false) {
+            this.issues.push(( new PromptMetadataError(valueToken.range, ( localize(
+                5347,
+                "Must be an array of tool names, got '{0}'.",
+                (valueToken.valueTypeName.toString())
+            )))));
+            delete this.valueToken;
+            return this.issues;
+        }
+        this.valueToken = valueToken;
+        this.validToolNames = ( new Map());
+        for (const item of this.valueToken.items) {
+            this.issues.push(...this.validateToolName(item, this.validToolNames));
+        }
+        return this.issues;
+    }
+    getToolRange(toolName) {
+        return this.validToolNames?.get(toolName);
+    }
+    validateToolName(valueToken, validToolNames) {
+        const issues = [];
+        if ((valueToken instanceof FrontMatterString) === false &&
+            (valueToken instanceof FrontMatterSequence) === false) {
+            issues.push(( new PromptMetadataWarning(valueToken.range, ( localize(
+                5348,
+                "Unexpected tool name '{0}', expected a string literal.",
+                valueToken.text
+            )))));
+            return issues;
+        }
+        const cleanToolName = valueToken.cleanText.trim();
+        if (cleanToolName.length === 0) {
+            issues.push(( new PromptMetadataWarning(valueToken.range, ( localize(5349, "Tool name cannot be empty.")))));
+            return issues;
+        }
+        if (( validToolNames.has(cleanToolName))) {
+            issues.push(( new PromptMetadataWarning(valueToken.range, ( localize(5350, "Duplicate tool name '{0}'.", cleanToolName)))));
+            return issues;
+        }
+        validToolNames.set(cleanToolName, valueToken.range);
+        return issues;
+    }
+    static isToolsRecord(token) {
+        if ((token instanceof FrontMatterRecord) === false) {
+            return false;
+        }
+        if (token.nameToken.text === RECORD_NAME) {
+            return true;
+        }
+        return false;
+    }
+}
+
+export { PromptToolsMetadata };

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/parsers/promptHeader/modeHeader.d.ts

@@ -0,0 +1,16 @@
+import { HeaderBase, IHeaderMetadata, type TDehydrated } from "./headerBase.js";
+import { PromptsType } from "@codingame/monaco-vscode-c465110a-57c0-59d7-a6b2-be0a4db7e517-common/vscode/vs/workbench/contrib/chat/common/promptSyntax/promptTypes";
+import { FrontMatterRecord } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/promptSyntax/codecs/base/frontMatterCodec/tokens/index";
+import { PromptModelMetadata } from "./metadata/model.js";
+import { PromptToolsMetadata } from "./metadata/tools.js";
+interface IModeMetadata extends IHeaderMetadata {
+    tools: PromptToolsMetadata;
+    model: PromptModelMetadata;
+}
+export type TModeMetadata = Partial<TDehydrated<IModeMetadata>> & {
+    promptType: PromptsType.mode;
+};
+export declare class ModeHeader extends HeaderBase<IModeMetadata> {
+    protected handleToken(token: FrontMatterRecord): boolean;
+}
+export {};

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/parsers/promptHeader/modeHeader.js

@@ -0,0 +1,24 @@
+
+import { HeaderBase } from './headerBase.js';
+import { PromptModelMetadata } from './metadata/model.js';
+import { PromptToolsMetadata } from './metadata/tools.js';
+
+class ModeHeader extends HeaderBase {
+    handleToken(token) {
+        if (PromptToolsMetadata.isToolsRecord(token)) {
+            const metadata = ( new PromptToolsMetadata(token, this.languageId));
+            this.issues.push(...metadata.validate());
+            this.meta.tools = metadata;
+            return true;
+        }
+        if (PromptModelMetadata.isModelRecord(token)) {
+            const metadata = ( new PromptModelMetadata(token, this.languageId));
+            this.issues.push(...metadata.validate());
+            this.meta.model = metadata;
+            return true;
+        }
+        return false;
+    }
+}
+
+export { ModeHeader };

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/parsers/promptHeader/promptHeader.d.ts

@@ -0,0 +1,19 @@
+import { HeaderBase, IHeaderMetadata, type TDehydrated } from "./headerBase.js";
+import { PromptsType } from "@codingame/monaco-vscode-c465110a-57c0-59d7-a6b2-be0a4db7e517-common/vscode/vs/workbench/contrib/chat/common/promptSyntax/promptTypes";
+import { FrontMatterRecord } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/promptSyntax/codecs/base/frontMatterCodec/tokens/index";
+import { PromptModelMetadata } from "./metadata/model.js";
+import { PromptToolsMetadata } from "./metadata/tools.js";
+import { PromptModeMetadata } from "./metadata/mode.js";
+export interface IPromptMetadata extends IHeaderMetadata {
+    tools: PromptToolsMetadata;
+    mode: PromptModeMetadata;
+    model: PromptModelMetadata;
+}
+export type TPromptMetadata = Partial<TDehydrated<IPromptMetadata>> & {
+    promptType: PromptsType.prompt;
+};
+export declare class PromptHeader extends HeaderBase<IPromptMetadata> {
+    protected handleToken(token: FrontMatterRecord): boolean;
+    private get toolsAndModeCompatible();
+    private validateToolsAndModeCompatibility;
+}

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/parsers/promptHeader/promptHeader.js

@@ -0,0 +1,62 @@
+
+import { ChatModeKind } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/constants';
+import { localize } from '@codingame/monaco-vscode-api/vscode/vs/nls';
+import { PromptMetadataWarning } from './diagnostics.js';
+import { assert } from '@codingame/monaco-vscode-api/vscode/vs/base/common/assert';
+import { assertDefined } from '@codingame/monaco-vscode-api/vscode/vs/base/common/types';
+import { HeaderBase } from './headerBase.js';
+import { PromptModelMetadata } from './metadata/model.js';
+import { PromptToolsMetadata } from './metadata/tools.js';
+import { PromptModeMetadata } from './metadata/mode.js';
+
+class PromptHeader extends HeaderBase {
+    handleToken(token) {
+        if (PromptToolsMetadata.isToolsRecord(token)) {
+            const metadata = ( new PromptToolsMetadata(token, this.languageId));
+            this.issues.push(...metadata.validate());
+            this.meta.tools = metadata;
+            this.validateToolsAndModeCompatibility();
+            return true;
+        }
+        if (PromptModeMetadata.isModeRecord(token)) {
+            const metadata = ( new PromptModeMetadata(token, this.languageId));
+            this.issues.push(...metadata.validate());
+            this.meta.mode = metadata;
+            this.validateToolsAndModeCompatibility();
+            return true;
+        }
+        if (PromptModelMetadata.isModelRecord(token)) {
+            const metadata = ( new PromptModelMetadata(token, this.languageId));
+            this.issues.push(...metadata.validate());
+            this.meta.model = metadata;
+            return true;
+        }
+        return false;
+    }
+    get toolsAndModeCompatible() {
+        const { tools, mode } = this.meta;
+        if (tools === undefined) {
+            return true;
+        }
+        if (mode?.value === undefined) {
+            return true;
+        }
+        return (mode.value === ChatModeKind.Agent);
+    }
+    validateToolsAndModeCompatibility() {
+        if (this.toolsAndModeCompatible === true) {
+            return;
+        }
+        const { tools, mode } = this.meta;
+        assertDefined(tools, 'Tools metadata must have been present.');
+        assertDefined(mode, 'Mode metadata must have been present.');
+        assert(mode.value !== ChatModeKind.Agent, 'Mode metadata must not be agent mode.');
+        this.issues.push(( new PromptMetadataWarning(tools.range, ( localize(
+            5351,
+            "Tools can only be used when in 'agent' mode, but the mode is set to '{0}'. The tools will be ignored.",
+            mode.value
+        )))));
+    }
+}
+
+export { PromptHeader };

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/parsers/promptParser.d.ts

@@ -0,0 +1,12 @@
+import { URI } from "@codingame/monaco-vscode-api/vscode/vs/base/common/uri";
+import { IPromptContentsProvider } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/promptSyntax/contentProviders/types";
+import { ILogService } from "@codingame/monaco-vscode-api/vscode/vs/platform/log/common/log.service";
+import { BasePromptParser, IPromptParserOptions } from "./basePromptParser.js";
+import { IModelService } from "@codingame/monaco-vscode-api/vscode/vs/editor/common/services/model.service";
+import { IInstantiationService } from "@codingame/monaco-vscode-api/vscode/vs/platform/instantiation/common/instantiation";
+import { IWorkbenchEnvironmentService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/services/environment/common/environmentService.service";
+export declare class PromptParser extends BasePromptParser<IPromptContentsProvider> {
+    private readonly contentsProvider;
+    constructor(uri: URI, options: IPromptParserOptions, logService: ILogService, modelService: IModelService, instaService: IInstantiationService, envService: IWorkbenchEnvironmentService);
+    toString(): string;
+}