Source code
Revision control
Copy as Markdown
Other Tools
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
/**
* Defines the agent commands that may be triggered when a slash is typed.
* Commands listed here will be available in the palette, but the AgentUI will
* still need to register handlers.
*/
/**
* Command ids, as they are typed without the leading "/"
*/
export const AGENT_COMMANDS = Object.freeze({
WATCH: "watch",
});
/**
* @typedef {object} AgentCommandItem
* @property {string} l10nId - Palette label
* @property {string} descriptionL10nId - Palette description
* @property {string} icon - Palette icon
*/
/**
* Palette metadata per command, keyed by its id, in the order the palette
* lists them
*
* @type {Map<Values<typeof AGENT_COMMANDS>, AgentCommandItem>}
*/
export const AGENT_COMMAND_ITEMS = new Map([
[
AGENT_COMMANDS.WATCH,
{
l10nId: "smartbar-command-watch-label",
descriptionL10nId: "smartbar-command-watch-description",
icon: "chrome://browser/content/aiwindow/assets/agent-watch.svg",
},
],
]);
// A leading "/" plus the command id, with the rest of the input as the prompt
const COMMAND_REGEX = /^\/(\w+)\b\s*(.*)$/s;
/**
* @typedef {object} ParsedAgentCommand
* @property {Values<typeof AGENT_COMMANDS>} command - The lowercased command id, without the leading "/"
* @property {string} prompt - The text following the command
* @property {string} raw - The trimmed input the command was parsed from
*/
/**
* Parses a leading command keyword from raw smartbar input
*
* @param {string} value - Raw smartbar input
* @returns {?ParsedAgentCommand} Null when there is no leading command
*/
export function parseAgentCommand(value) {
const raw = value.trim();
const match = COMMAND_REGEX.exec(raw);
if (!match) {
return null;
}
return {
command: /** @type {Values<typeof AGENT_COMMANDS>} */ (
match[1].toLowerCase()
),
prompt: match[2].trim(),
raw,
};
}