@anthropic-field/core 0.1.0

package/dist/src/policy/utils.js

@@ -0,0 +1,45 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Escapes a string for use in a regular expression.
+ */
+export function escapeRegex(text) {
+    return text.replace(/[-[\]{}()*+?.,\\^$|#\s"]/g, '\\$&');
+}
+/**
+ * Builds a list of args patterns for policy matching.
+ *
+ * This function handles the transformation of command prefixes and regexes into
+ * the internal argsPattern representation used by the PolicyEngine.
+ *
+ * @param argsPattern An optional raw regex string for arguments.
+ * @param commandPrefix An optional command prefix (or list of prefixes) to allow.
+ * @param commandRegex An optional command regex string to allow.
+ * @returns An array of string patterns (or undefined) for the PolicyEngine.
+ */
+export function buildArgsPatterns(argsPattern, commandPrefix, commandRegex) {
+    if (commandPrefix) {
+        const prefixes = Array.isArray(commandPrefix)
+            ? commandPrefix
+            : [commandPrefix];
+        // Expand command prefixes to multiple patterns.
+        // We append [\\s"] to ensure we match whole words only (e.g., "git" but not
+        // "github"). Since we match against JSON stringified args, the value is
+        // always followed by a space or a closing quote.
+        return prefixes.map((prefix) => {
+            const jsonPrefix = JSON.stringify(prefix).slice(1, -1);
+            // We allow [\s], ["], or the specific sequence [\"] (for escaped quotes
+            // in JSON). We do NOT allow generic [\\], which would match "git\status"
+            // -> "gitstatus".
+            return `"command":"${escapeRegex(jsonPrefix)}(?:[\\s"]|\\\\")`;
+        });
+    }
+    if (commandRegex) {
+        return [`"command":"${commandRegex}`];
+    }
+    return [argsPattern];
+}
+//# sourceMappingURL=utils.js.map

package/dist/src/policy/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/policy/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI,CAAC,OAAO,CAAC,2BAA2B,EAAE,MAAM,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAC/B,WAAoB,EACpB,aAAiC,EACjC,YAAqB;IAErB,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC;YAC3C,CAAC,CAAC,aAAa;YACf,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;QAEpB,gDAAgD;QAChD,4EAA4E;QAC5E,wEAAwE;QACxE,iDAAiD;QACjD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACvD,wEAAwE;YACxE,yEAAyE;YACzE,kBAAkB;YAClB,OAAO,cAAc,WAAW,CAAC,UAAU,CAAC,kBAAkB,CAAC;QACjE,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,CAAC,cAAc,YAAY,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,CAAC,WAAW,CAAC,CAAC;AACvB,CAAC"}

package/dist/src/prompts/mcp-prompts.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '../config/config.js';
+import type { DiscoveredMCPPrompt } from '../tools/mcp-client.js';
+export declare function getMCPServerPrompts(config: Config, serverName: string): DiscoveredMCPPrompt[];

package/dist/src/prompts/mcp-prompts.js

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export function getMCPServerPrompts(config, serverName) {
+    const promptRegistry = config.getPromptRegistry();
+    if (!promptRegistry) {
+        return [];
+    }
+    return promptRegistry.getPromptsByServer(serverName);
+}
+//# sourceMappingURL=mcp-prompts.js.map

package/dist/src/prompts/mcp-prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-prompts.js","sourceRoot":"","sources":["../../../src/prompts/mcp-prompts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,UAAU,mBAAmB,CACjC,MAAc,EACd,UAAkB;IAElB,MAAM,cAAc,GAAG,MAAM,CAAC,iBAAiB,EAAE,CAAC;IAClD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,cAAc,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;AACvD,CAAC"}

package/dist/src/prompts/prompt-registry.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { DiscoveredMCPPrompt } from '../tools/mcp-client.js';
+export declare class PromptRegistry {
+    private prompts;
+    /**
+     * Registers a prompt definition.
+     * @param prompt - The prompt object containing schema and execution logic.
+     */
+    registerPrompt(prompt: DiscoveredMCPPrompt): void;
+    /**
+     * Returns an array of all registered and discovered prompt instances.
+     */
+    getAllPrompts(): DiscoveredMCPPrompt[];
+    /**
+     * Get the definition of a specific prompt.
+     */
+    getPrompt(name: string): DiscoveredMCPPrompt | undefined;
+    /**
+     * Returns an array of prompts registered from a specific MCP server.
+     */
+    getPromptsByServer(serverName: string): DiscoveredMCPPrompt[];
+    /**
+     * Clears all the prompts from the registry.
+     */
+    clear(): void;
+    /**
+     * Removes all prompts from a specific server.
+     */
+    removePromptsByServer(serverName: string): void;
+}

package/dist/src/prompts/prompt-registry.js

@@ -0,0 +1,64 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { debugLogger } from '../utils/debugLogger.js';
+export class PromptRegistry {
+    prompts = new Map();
+    /**
+     * Registers a prompt definition.
+     * @param prompt - The prompt object containing schema and execution logic.
+     */
+    registerPrompt(prompt) {
+        if (this.prompts.has(prompt.name)) {
+            const newName = `${prompt.serverName}_${prompt.name}`;
+            debugLogger.warn(`Prompt with name "${prompt.name}" is already registered. Renaming to "${newName}".`);
+            this.prompts.set(newName, { ...prompt, name: newName });
+        }
+        else {
+            this.prompts.set(prompt.name, prompt);
+        }
+    }
+    /**
+     * Returns an array of all registered and discovered prompt instances.
+     */
+    getAllPrompts() {
+        return Array.from(this.prompts.values()).sort((a, b) => a.name.localeCompare(b.name));
+    }
+    /**
+     * Get the definition of a specific prompt.
+     */
+    getPrompt(name) {
+        return this.prompts.get(name);
+    }
+    /**
+     * Returns an array of prompts registered from a specific MCP server.
+     */
+    getPromptsByServer(serverName) {
+        const serverPrompts = [];
+        for (const prompt of this.prompts.values()) {
+            if (prompt.serverName === serverName) {
+                serverPrompts.push(prompt);
+            }
+        }
+        return serverPrompts.sort((a, b) => a.name.localeCompare(b.name));
+    }
+    /**
+     * Clears all the prompts from the registry.
+     */
+    clear() {
+        this.prompts.clear();
+    }
+    /**
+     * Removes all prompts from a specific server.
+     */
+    removePromptsByServer(serverName) {
+        for (const [name, prompt] of this.prompts.entries()) {
+            if (prompt.serverName === serverName) {
+                this.prompts.delete(name);
+            }
+        }
+    }
+}
+//# sourceMappingURL=prompt-registry.js.map

package/dist/src/prompts/prompt-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-registry.js","sourceRoot":"","sources":["../../../src/prompts/prompt-registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,MAAM,OAAO,cAAc;IACjB,OAAO,GAAqC,IAAI,GAAG,EAAE,CAAC;IAE9D;;;OAGG;IACH,cAAc,CAAC,MAA2B;QACxC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,OAAO,GAAG,GAAG,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YACtD,WAAW,CAAC,IAAI,CACd,qBAAqB,MAAM,CAAC,IAAI,yCAAyC,OAAO,IAAI,CACrF,CAAC;YACF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACrD,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAC7B,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,UAAkB;QACnC,MAAM,aAAa,GAA0B,EAAE,CAAC;QAChD,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,IAAI,MAAM,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;gBACrC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;QACD,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACpE,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,qBAAqB,CAAC,UAAkB;QACtC,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YACpD,IAAI,MAAM,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;gBACrC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/src/prompts/promptProvider.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '../config/config.js';
+/**
+ * Orchestrates prompt generation by gathering context and building options.
+ */
+export declare class PromptProvider {
+    /**
+     * Generates the core system prompt.
+     */
+    getCoreSystemPrompt(config: Config, userMemory?: string, interactiveOverride?: boolean): string;
+    getCompressionPrompt(): string;
+    private withSection;
+    private maybeWriteSystemMd;
+}

package/dist/src/prompts/promptProvider.js

@@ -0,0 +1,129 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import process from 'node:process';
+import { GEMINI_DIR } from '../utils/paths.js';
+import { ApprovalMode } from '../policy/types.js';
+import * as snippets from './snippets.js';
+import { resolvePathFromEnv, applySubstitutions, isSectionEnabled, } from './utils.js';
+import { CodebaseInvestigatorAgent } from '../agents/codebase-investigator.js';
+import { isGitRepository } from '../utils/gitUtils.js';
+import { PLAN_MODE_TOOLS, WRITE_TODOS_TOOL_NAME, READ_FILE_TOOL_NAME, } from '../tools/tool-names.js';
+import { resolveModel, isPreviewModel } from '../config/models.js';
+/**
+ * Orchestrates prompt generation by gathering context and building options.
+ */
+export class PromptProvider {
+    /**
+     * Generates the core system prompt.
+     */
+    getCoreSystemPrompt(config, userMemory, interactiveOverride) {
+        const systemMdResolution = resolvePathFromEnv(process.env['GEMINI_SYSTEM_MD']);
+        const interactiveMode = interactiveOverride ?? config.isInteractive();
+        const approvalMode = config.getApprovalMode?.() ?? ApprovalMode.DEFAULT;
+        const isPlanMode = approvalMode === ApprovalMode.PLAN;
+        const skills = config.getSkillManager().getSkills();
+        const toolNames = config.getToolRegistry().getAllToolNames();
+        const desiredModel = resolveModel(config.getActiveModel(), config.getPreviewFeatures());
+        const isGemini3 = isPreviewModel(desiredModel);
+        // --- Context Gathering ---
+        const planOptions = isPlanMode
+            ? {
+                planModeToolsList: PLAN_MODE_TOOLS.filter((t) => new Set(toolNames).has(t))
+                    .map((t) => `- \`${t}\``)
+                    .join('\n'),
+                plansDir: config.storage.getProjectTempPlansDir(),
+            }
+            : undefined;
+        let basePrompt;
+        // --- Template File Override ---
+        if (systemMdResolution.value && !systemMdResolution.isDisabled) {
+            let systemMdPath = path.resolve(path.join(GEMINI_DIR, 'system.md'));
+            if (!systemMdResolution.isSwitch) {
+                systemMdPath = systemMdResolution.value;
+            }
+            if (!fs.existsSync(systemMdPath)) {
+                throw new Error(`missing system prompt file '${systemMdPath}'`);
+            }
+            basePrompt = fs.readFileSync(systemMdPath, 'utf8');
+            const skillsPrompt = snippets.renderAgentSkills(skills.map((s) => ({
+                name: s.name,
+                description: s.description,
+                location: s.location,
+            })));
+            basePrompt = applySubstitutions(basePrompt, config, skillsPrompt);
+        }
+        else {
+            // --- Standard Composition ---
+            const options = {
+                preamble: this.withSection('preamble', () => ({
+                    interactive: interactiveMode,
+                })),
+                coreMandates: this.withSection('coreMandates', () => ({
+                    interactive: interactiveMode,
+                    isGemini3,
+                    hasSkills: skills.length > 0,
+                })),
+                agentContexts: this.withSection('agentContexts', () => config.getAgentRegistry().getDirectoryContext()),
+                agentSkills: this.withSection('agentSkills', () => skills.map((s) => ({
+                    name: s.name,
+                    description: s.description,
+                    location: s.location,
+                })), skills.length > 0),
+                hookContext: isSectionEnabled('hookContext') || undefined,
+                primaryWorkflows: this.withSection('primaryWorkflows', () => ({
+                    interactive: interactiveMode,
+                    enableCodebaseInvestigator: toolNames.includes(CodebaseInvestigatorAgent.name),
+                    enableWriteTodosTool: toolNames.includes(WRITE_TODOS_TOOL_NAME),
+                }), !isPlanMode),
+                operationalGuidelines: this.withSection('operationalGuidelines', () => ({
+                    interactive: interactiveMode,
+                    isGemini3,
+                    enableShellEfficiency: config.getEnableShellOutputEfficiency(),
+                })),
+                sandbox: this.withSection('sandbox', () => getSandboxMode()),
+                gitRepo: this.withSection('git', () => ({ interactive: interactiveMode }), isGitRepository(process.cwd()) ? true : false),
+                finalReminder: this.withSection('finalReminder', () => ({
+                    readFileToolName: READ_FILE_TOOL_NAME,
+                })),
+            };
+            basePrompt = snippets.getCoreSystemPrompt(options);
+        }
+        // --- Finalization (Shell) ---
+        const finalPrompt = snippets.renderFinalShell(basePrompt, userMemory, planOptions);
+        // Sanitize erratic newlines from composition
+        const sanitizedPrompt = finalPrompt.replace(/\n{3,}/g, '\n\n');
+        // Write back to file if requested
+        this.maybeWriteSystemMd(sanitizedPrompt, systemMdResolution, path.resolve(path.join(GEMINI_DIR, 'system.md')));
+        return sanitizedPrompt;
+    }
+    getCompressionPrompt() {
+        return snippets.getCompressionPrompt();
+    }
+    withSection(key, factory, guard = true) {
+        return guard && isSectionEnabled(key) ? factory() : undefined;
+    }
+    maybeWriteSystemMd(basePrompt, resolution, defaultPath) {
+        const writeSystemMdResolution = resolvePathFromEnv(process.env['GEMINI_WRITE_SYSTEM_MD']);
+        if (writeSystemMdResolution.value && !writeSystemMdResolution.isDisabled) {
+            const writePath = writeSystemMdResolution.isSwitch
+                ? defaultPath
+                : writeSystemMdResolution.value;
+            fs.mkdirSync(path.dirname(writePath), { recursive: true });
+            fs.writeFileSync(writePath, basePrompt);
+        }
+    }
+}
+// --- Internal Context Helpers ---
+function getSandboxMode() {
+    if (process.env['SANDBOX'] === 'sandbox-exec')
+        return 'macos-seatbelt';
+    if (process.env['SANDBOX'])
+        return 'generic';
+    return 'outside';
+}
+//# sourceMappingURL=promptProvider.js.map

package/dist/src/prompts/promptProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptProvider.js","sourceRoot":"","sources":["../../../src/prompts/promptProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,GAEjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEnE;;GAEG;AACH,MAAM,OAAO,cAAc;IACzB;;OAEG;IACH,mBAAmB,CACjB,MAAc,EACd,UAAmB,EACnB,mBAA6B;QAE7B,MAAM,kBAAkB,GAAG,kBAAkB,CAC3C,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAChC,CAAC;QAEF,MAAM,eAAe,GAAG,mBAAmB,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QACtE,MAAM,YAAY,GAAG,MAAM,CAAC,eAAe,EAAE,EAAE,IAAI,YAAY,CAAC,OAAO,CAAC;QACxE,MAAM,UAAU,GAAG,YAAY,KAAK,YAAY,CAAC,IAAI,CAAC;QACtD,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC,SAAS,EAAE,CAAC;QACpD,MAAM,SAAS,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC,eAAe,EAAE,CAAC;QAE7D,MAAM,YAAY,GAAG,YAAY,CAC/B,MAAM,CAAC,cAAc,EAAE,EACvB,MAAM,CAAC,kBAAkB,EAAE,CAC5B,CAAC;QACF,MAAM,SAAS,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;QAE/C,4BAA4B;QAC5B,MAAM,WAAW,GAAiD,UAAU;YAC1E,CAAC,CAAC;gBACE,iBAAiB,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAC9C,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAC1B;qBACE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;qBACxB,IAAI,CAAC,IAAI,CAAC;gBACb,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,sBAAsB,EAAE;aAClD;YACH,CAAC,CAAC,SAAS,CAAC;QAEd,IAAI,UAAkB,CAAC;QAEvB,iCAAiC;QACjC,IAAI,kBAAkB,CAAC,KAAK,IAAI,CAAC,kBAAkB,CAAC,UAAU,EAAE,CAAC;YAC/D,IAAI,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;YACpE,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,CAAC;gBACjC,YAAY,GAAG,kBAAkB,CAAC,KAAK,CAAC;YAC1C,CAAC;YACD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;gBACjC,MAAM,IAAI,KAAK,CAAC,+BAA+B,YAAY,GAAG,CAAC,CAAC;YAClE,CAAC;YACD,UAAU,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YACnD,MAAM,YAAY,GAAG,QAAQ,CAAC,iBAAiB,CAC7C,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACjB,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ;aACrB,CAAC,CAAC,CACJ,CAAC;YACF,UAAU,GAAG,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;QACpE,CAAC;aAAM,CAAC;YACN,+BAA+B;YAC/B,MAAM,OAAO,GAAiC;gBAC5C,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;oBAC5C,WAAW,EAAE,eAAe;iBAC7B,CAAC,CAAC;gBACH,YAAY,EAAE,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC;oBACpD,WAAW,EAAE,eAAe;oBAC5B,SAAS;oBACT,SAAS,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC;iBAC7B,CAAC,CAAC;gBACH,aAAa,EAAE,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE,GAAG,EAAE,CACpD,MAAM,CAAC,gBAAgB,EAAE,CAAC,mBAAmB,EAAE,CAChD;gBACD,WAAW,EAAE,IAAI,CAAC,WAAW,CAC3B,aAAa,EACb,GAAG,EAAE,CACH,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACjB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ;iBACrB,CAAC,CAAC,EACL,MAAM,CAAC,MAAM,GAAG,CAAC,CAClB;gBACD,WAAW,EAAE,gBAAgB,CAAC,aAAa,CAAC,IAAI,SAAS;gBACzD,gBAAgB,EAAE,IAAI,CAAC,WAAW,CAChC,kBAAkB,EAClB,GAAG,EAAE,CAAC,CAAC;oBACL,WAAW,EAAE,eAAe;oBAC5B,0BAA0B,EAAE,SAAS,CAAC,QAAQ,CAC5C,yBAAyB,CAAC,IAAI,CAC/B;oBACD,oBAAoB,EAAE,SAAS,CAAC,QAAQ,CAAC,qBAAqB,CAAC;iBAChE,CAAC,EACF,CAAC,UAAU,CACZ;gBACD,qBAAqB,EAAE,IAAI,CAAC,WAAW,CACrC,uBAAuB,EACvB,GAAG,EAAE,CAAC,CAAC;oBACL,WAAW,EAAE,eAAe;oBAC5B,SAAS;oBACT,qBAAqB,EAAE,MAAM,CAAC,8BAA8B,EAAE;iBAC/D,CAAC,CACH;gBACD,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,cAAc,EAAE,CAAC;gBAC5D,OAAO,EAAE,IAAI,CAAC,WAAW,CACvB,KAAK,EACL,GAAG,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC,EACxC,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAC9C;gBACD,aAAa,EAAE,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC;oBACtD,gBAAgB,EAAE,mBAAmB;iBACtC,CAAC,CAAC;aACJ,CAAC;YAEF,UAAU,GAAG,QAAQ,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;QACrD,CAAC;QAED,+BAA+B;QAC/B,MAAM,WAAW,GAAG,QAAQ,CAAC,gBAAgB,CAC3C,UAAU,EACV,UAAU,EACV,WAAW,CACZ,CAAC;QAEF,6CAA6C;QAC7C,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAE/D,kCAAkC;QAClC,IAAI,CAAC,kBAAkB,CACrB,eAAe,EACf,kBAAkB,EAClB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CACjD,CAAC;QAEF,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,oBAAoB;QAClB,OAAO,QAAQ,CAAC,oBAAoB,EAAE,CAAC;IACzC,CAAC;IAEO,WAAW,CACjB,GAAW,EACX,OAAgB,EAChB,QAAiB,IAAI;QAErB,OAAO,KAAK,IAAI,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAChE,CAAC;IAEO,kBAAkB,CACxB,UAAkB,EAClB,UAAwB,EACxB,WAAmB;QAEnB,MAAM,uBAAuB,GAAG,kBAAkB,CAChD,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CACtC,CAAC;QACF,IAAI,uBAAuB,CAAC,KAAK,IAAI,CAAC,uBAAuB,CAAC,UAAU,EAAE,CAAC;YACzE,MAAM,SAAS,GAAG,uBAAuB,CAAC,QAAQ;gBAChD,CAAC,CAAC,WAAW;gBACb,CAAC,CAAC,uBAAuB,CAAC,KAAK,CAAC;YAClC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3D,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;CACF;AAED,mCAAmC;AAEnC,SAAS,cAAc;IACrB,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,cAAc;QAAE,OAAO,gBAAgB,CAAC;IACvE,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7C,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/src/prompts/snippets.d.ts

@@ -0,0 +1,76 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export interface SystemPromptOptions {
+    preamble?: PreambleOptions;
+    coreMandates?: CoreMandatesOptions;
+    agentContexts?: string;
+    agentSkills?: AgentSkillOptions[];
+    hookContext?: boolean;
+    primaryWorkflows?: PrimaryWorkflowsOptions;
+    operationalGuidelines?: OperationalGuidelinesOptions;
+    sandbox?: SandboxMode;
+    gitRepo?: GitRepoOptions;
+    finalReminder?: FinalReminderOptions;
+}
+export interface PreambleOptions {
+    interactive: boolean;
+}
+export interface CoreMandatesOptions {
+    interactive: boolean;
+    isGemini3: boolean;
+    hasSkills: boolean;
+}
+export interface PrimaryWorkflowsOptions {
+    interactive: boolean;
+    enableCodebaseInvestigator: boolean;
+    enableWriteTodosTool: boolean;
+}
+export interface OperationalGuidelinesOptions {
+    interactive: boolean;
+    isGemini3: boolean;
+    enableShellEfficiency: boolean;
+}
+export type SandboxMode = 'macos-seatbelt' | 'generic' | 'outside';
+export interface GitRepoOptions {
+    interactive: boolean;
+}
+export interface FinalReminderOptions {
+    readFileToolName: string;
+}
+export interface ApprovalModePlanOptions {
+    planModeToolsList: string;
+    plansDir: string;
+}
+export interface AgentSkillOptions {
+    name: string;
+    description: string;
+    location: string;
+}
+/**
+ * Composes the core system prompt from its constituent subsections.
+ * Adheres to the minimal complexity principle by using simple interpolation of function calls.
+ */
+export declare function getCoreSystemPrompt(options: SystemPromptOptions): string;
+/**
+ * Wraps the base prompt with user memory and approval mode plans.
+ */
+export declare function renderFinalShell(basePrompt: string, userMemory?: string, planOptions?: ApprovalModePlanOptions): string;
+export declare function renderPreamble(options?: PreambleOptions): string;
+export declare function renderCoreMandates(options?: CoreMandatesOptions): string;
+export declare function renderAgentContexts(contexts?: string): string;
+export declare function renderAgentSkills(skills?: AgentSkillOptions[]): string;
+export declare function renderHookContext(enabled?: boolean): string;
+export declare function renderPrimaryWorkflows(options?: PrimaryWorkflowsOptions): string;
+export declare function renderOperationalGuidelines(options?: OperationalGuidelinesOptions): string;
+export declare function renderSandbox(mode?: SandboxMode): string;
+export declare function renderGitRepo(options?: GitRepoOptions): string;
+export declare function renderFinalReminder(options?: FinalReminderOptions): string;
+export declare function renderUserMemory(memory?: string): string;
+export declare function renderApprovalModePlan(options?: ApprovalModePlanOptions): string;
+/**
+ * Provides the system prompt for history compression.
+ */
+export declare function getCompressionPrompt(): string;