@tulex-cli/tulex-code 0.1.1

package/dist/src/services/prompt-processors/shellProcessor.js

@@ -0,0 +1,146 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ApprovalMode, checkCommandPermissions, escapeShellArg, getShellConfiguration, ShellExecutionService, flatMapTextParts, checkArgumentSafety, } from '@tulex-cli/tulex-cli-core';
+import { SHELL_INJECTION_TRIGGER, SHORTHAND_ARGS_PLACEHOLDER, } from './types.js';
+import { extractInjections } from './injectionParser.js';
+import { themeManager } from '../../ui/themes/theme-manager.js';
+export class ConfirmationRequiredError extends Error {
+    commandsToConfirm;
+    constructor(message, commandsToConfirm) {
+        super(message);
+        this.commandsToConfirm = commandsToConfirm;
+        this.name = 'ConfirmationRequiredError';
+    }
+}
+/**
+ * Handles prompt interpolation, including shell command execution (`!{...}`)
+ * and context-aware argument injection (`{{args}}`).
+ *
+ * This processor ensures that:
+ * 1. `{{args}}` outside `!{...}` are replaced with raw input.
+ * 2. `{{args}}` inside `!{...}` are replaced with shell-escaped input.
+ * 3. Shell commands are executed securely after argument substitution.
+ * 4. Parsing correctly handles nested braces.
+ */
+export class ShellProcessor {
+    commandName;
+    constructor(commandName) {
+        this.commandName = commandName;
+    }
+    async process(prompt, context) {
+        return flatMapTextParts(prompt, (text) => this.processString(text, context));
+    }
+    async processString(prompt, context) {
+        const userArgsRaw = context.invocation?.args || '';
+        if (!prompt.includes(SHELL_INJECTION_TRIGGER)) {
+            return [
+                { text: prompt.replaceAll(SHORTHAND_ARGS_PLACEHOLDER, userArgsRaw) },
+            ];
+        }
+        const config = context.services.config;
+        if (!config) {
+            throw new Error(`Security configuration not loaded. Cannot verify shell command permissions for '${this.commandName}'. Aborting.`);
+        }
+        const { sessionShellAllowlist } = context.session;
+        const injections = extractInjections(prompt, SHELL_INJECTION_TRIGGER, this.commandName);
+        // If extractInjections found no closed blocks (and didn't throw), treat as raw.
+        if (injections.length === 0) {
+            return [
+                { text: prompt.replaceAll(SHORTHAND_ARGS_PLACEHOLDER, userArgsRaw) },
+            ];
+        }
+        const { shell } = getShellConfiguration();
+        const userArgsEscaped = escapeShellArg(userArgsRaw, shell);
+        // Check safety of the value that will be used for $ARGUMENTS (after removing outer quotes)
+        let userArgsForArgumentsPlaceholder = userArgsRaw.replace(/^'([\s\S]*?)'$/, '$1');
+        const argumentSafety = checkArgumentSafety(userArgsForArgumentsPlaceholder);
+        if (!argumentSafety.isSafe) {
+            userArgsForArgumentsPlaceholder = userArgsEscaped;
+        }
+        const resolvedInjections = injections.map((injection) => {
+            const command = injection.content;
+            if (command === '') {
+                return { ...injection, resolvedCommand: undefined };
+            }
+            const resolvedCommand = command
+                .replaceAll(SHORTHAND_ARGS_PLACEHOLDER, userArgsEscaped) // Replace {{args}}
+                .replaceAll('$ARGUMENTS', userArgsForArgumentsPlaceholder);
+            return { ...injection, resolvedCommand };
+        });
+        const commandsToConfirm = new Set();
+        for (const injection of resolvedInjections) {
+            const command = injection.resolvedCommand;
+            if (!command)
+                continue;
+            // Security check on the final, escaped command string.
+            const { allAllowed, disallowedCommands, blockReason, isHardDenial } = await checkCommandPermissions(command, config, sessionShellAllowlist);
+            // Determine if this command is explicitly auto-approved via PermissionManager
+            const pm = config.getPermissionManager?.();
+            const isAllowedBySettings = pm
+                ? (await pm.isCommandAllowed(command)) === 'allow'
+                : false;
+            if (!allAllowed) {
+                if (isHardDenial) {
+                    throw new Error(`${this.commandName} cannot be run. Blocked command: "${command}". Reason: ${blockReason || 'Blocked by configuration.'}`);
+                }
+                // If the command is allowed by settings, skip confirmation.
+                if (isAllowedBySettings) {
+                    continue;
+                }
+                // If not a hard denial, respect YOLO mode and auto-approve.
+                if (config.getApprovalMode() === ApprovalMode.YOLO) {
+                    continue;
+                }
+                disallowedCommands.forEach((uc) => commandsToConfirm.add(uc));
+            }
+        }
+        // Handle confirmation requirements.
+        if (commandsToConfirm.size > 0) {
+            throw new ConfirmationRequiredError('Shell command confirmation required', Array.from(commandsToConfirm));
+        }
+        let processedPrompt = '';
+        let lastIndex = 0;
+        for (const injection of resolvedInjections) {
+            // Append the text segment BEFORE the injection, substituting {{args}} with RAW input.
+            const segment = prompt.substring(lastIndex, injection.startIndex);
+            processedPrompt += segment.replaceAll(SHORTHAND_ARGS_PLACEHOLDER, userArgsRaw);
+            // Execute the resolved command (which already has ESCAPED input).
+            if (injection.resolvedCommand) {
+                const activeTheme = themeManager.getActiveTheme();
+                const shellExecutionConfig = {
+                    ...config.getShellExecutionConfig(),
+                    defaultFg: activeTheme.colors.Foreground,
+                    defaultBg: activeTheme.colors.Background,
+                };
+                const { result } = await ShellExecutionService.execute(injection.resolvedCommand, config.getTargetDir(), () => { }, new AbortController().signal, config.getShouldUseNodePtyShell(), shellExecutionConfig);
+                const executionResult = await result;
+                // Handle Spawn Errors
+                if (executionResult.error && !executionResult.aborted) {
+                    throw new Error(`Failed to start shell command in '${this.commandName}': ${executionResult.error.message}. Command: ${injection.resolvedCommand}`);
+                }
+                // Append the output, making stderr explicit for the model.
+                processedPrompt += executionResult.output;
+                // Append a status message if the command did not succeed.
+                if (executionResult.aborted) {
+                    processedPrompt += `\n[Shell command '${injection.resolvedCommand}' aborted]`;
+                }
+                else if (executionResult.exitCode !== 0 &&
+                    executionResult.exitCode !== null) {
+                    processedPrompt += `\n[Shell command '${injection.resolvedCommand}' exited with code ${executionResult.exitCode}]`;
+                }
+                else if (executionResult.signal !== null) {
+                    processedPrompt += `\n[Shell command '${injection.resolvedCommand}' terminated by signal ${executionResult.signal}]`;
+                }
+            }
+            lastIndex = injection.endIndex;
+        }
+        // Append the remaining text AFTER the last injection, substituting {{args}} with RAW input.
+        const finalSegment = prompt.substring(lastIndex);
+        processedPrompt += finalSegment.replaceAll(SHORTHAND_ARGS_PLACEHOLDER, userArgsRaw);
+        return [{ text: processedPrompt }];
+    }
+}
+//# sourceMappingURL=shellProcessor.js.map

package/dist/src/services/prompt-processors/shellProcessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shellProcessor.js","sourceRoot":"","sources":["../../../../src/services/prompt-processors/shellProcessor.ts"],"names":[],"mappings":"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"}

package/dist/src/services/prompt-processors/types.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { CommandContext } from '../../ui/commands/types.js';
+import type { PartUnion } from '@google/genai';
+/**
+ * Defines the input/output type for prompt processors.
+ */
+export type PromptPipelineContent = PartUnion[];
+/**
+ * Defines the interface for a prompt processor, a module that can transform
+ * a prompt string before it is sent to the model. Processors are chained
+ * together to create a processing pipeline.
+ */
+export interface IPromptProcessor {
+    /**
+     * Processes a prompt input (which may contain text and multi-modal parts),
+     * applying a specific transformation as part of a pipeline.
+     *
+     * @param prompt The current state of the prompt string. This may have been
+     *   modified by previous processors in the pipeline.
+     * @param context The full command context, providing access to invocation
+     *   details (like `context.invocation.raw` and `context.invocation.args`),
+     *   application services, and UI handlers.
+     * @returns A promise that resolves to the transformed prompt string, which
+     *   will be passed to the next processor or, if it's the last one, sent to the model.
+     */
+    process(prompt: PromptPipelineContent, context: CommandContext): Promise<PromptPipelineContent>;
+}
+/**
+ * The placeholder string for shorthand argument injection in custom commands.
+ * When used outside of !{...}, arguments are injected raw.
+ * When used inside !{...}, arguments are shell-escaped.
+ */
+export declare const SHORTHAND_ARGS_PLACEHOLDER = "{{args}}";
+/**
+ * The trigger string for shell command injection in custom commands.
+ */
+export declare const SHELL_INJECTION_TRIGGER = "!{";
+/**
+ * The trigger string for at file injection in custom commands.
+ */
+export declare const AT_FILE_INJECTION_TRIGGER = "@{";

package/dist/src/services/prompt-processors/types.js

@@ -0,0 +1,20 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * The placeholder string for shorthand argument injection in custom commands.
+ * When used outside of !{...}, arguments are injected raw.
+ * When used inside !{...}, arguments are shell-escaped.
+ */
+export const SHORTHAND_ARGS_PLACEHOLDER = '{{args}}';
+/**
+ * The trigger string for shell command injection in custom commands.
+ */
+export const SHELL_INJECTION_TRIGGER = '!{';
+/**
+ * The trigger string for at file injection in custom commands.
+ */
+export const AT_FILE_INJECTION_TRIGGER = '@{';
+//# sourceMappingURL=types.js.map

package/dist/src/services/prompt-processors/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/services/prompt-processors/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkCH;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,UAAU,CAAC;AAErD;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAE5C;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAC"}

package/dist/src/services/test-commands/example.md

@@ -0,0 +1,5 @@
+---
+description: Example markdown command
+---
+
+This is an example prompt from a markdown file.

package/dist/src/services/tips/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { TipHistory } from './tipHistory.js';
+export { TipHistory } from './tipHistory.js';
+export { selectTip } from './tipScheduler.js';
+export { tipRegistry, type ContextualTip, type TipContext, type TipTrigger, } from './tipRegistry.js';
+export declare function getTipHistory(): TipHistory;

package/dist/src/services/tips/index.js

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { TipHistory } from './tipHistory.js';
+export { TipHistory } from './tipHistory.js';
+export { selectTip } from './tipScheduler.js';
+export { tipRegistry, } from './tipRegistry.js';
+/**
+ * Shared TipHistory singleton for the session. Loaded once on first access
+ * so both startup tips and post-response tips share the same state.
+ */
+let _tipHistory = null;
+export function getTipHistory() {
+    if (!_tipHistory) {
+        _tipHistory = TipHistory.load();
+    }
+    return _tipHistory;
+}
+//# sourceMappingURL=index.js.map

package/dist/src/services/tips/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/tips/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EACL,WAAW,GAIZ,MAAM,kBAAkB,CAAC;AAE1B;;;GAGG;AACH,IAAI,WAAW,GAAsB,IAAI,CAAC;AAC1C,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,WAAW,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;IAClC,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/src/services/tips/tipHistory.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+interface TipHistoryEntry {
+    totalShown: number;
+    lastSessionTimestamp: number;
+}
+interface TipHistoryData {
+    sessionCount: number;
+    tips: Record<string, TipHistoryEntry>;
+}
+export declare class TipHistory {
+    /** In-session tracking: tipId → prompt count when last shown */
+    private sessionShown;
+    private data;
+    private filePath;
+    constructor(data: TipHistoryData, filePath: string);
+    get sessionCount(): number;
+    /**
+     * Check if a tip has cooled down enough to be shown again.
+     */
+    isCooledDown(tipId: string, cooldownPrompts: number, currentPromptCount: number): boolean;
+    /**
+     * Get a recency score for LRU sorting. Lower = shown longer ago (or never).
+     * Tips shown in this session get a high score (shown recently).
+     * Tips never shown in this session fall back to cross-session
+     * lastSessionTimestamp for true recency-based rotation.
+     */
+    getLastShown(tipId: string): number;
+    /**
+     * Normalize a persisted tip entry so corrupted values cannot crash mutations.
+     */
+    private normalizeEntry;
+    /**
+     * Record that a tip was shown at the given prompt count.
+     */
+    recordShown(tipId: string, currentPromptCount: number): void;
+    /**
+     * Persist history to disk.
+     */
+    private persist;
+    /**
+     * Load history from disk, incrementing session count.
+     */
+    static load(): TipHistory;
+}
+export {};

package/dist/src/services/tips/tipHistory.js

@@ -0,0 +1,138 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Tip history tracking — in-session cooldown and cross-session persistence.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { atomicWriteFileSync, Storage } from '@tulex-cli/tulex-cli-core';
+export class TipHistory {
+    /** In-session tracking: tipId → prompt count when last shown */
+    sessionShown = new Map();
+    data;
+    filePath;
+    constructor(data, filePath) {
+        this.data = data;
+        this.filePath = filePath;
+    }
+    get sessionCount() {
+        return this.data.sessionCount;
+    }
+    /**
+     * Check if a tip has cooled down enough to be shown again.
+     */
+    isCooledDown(tipId, cooldownPrompts, currentPromptCount) {
+        const lastShown = this.sessionShown.get(tipId);
+        if (lastShown === undefined)
+            return true;
+        return currentPromptCount - lastShown >= cooldownPrompts;
+    }
+    /**
+     * Get a recency score for LRU sorting. Lower = shown longer ago (or never).
+     * Tips shown in this session get a high score (shown recently).
+     * Tips never shown in this session fall back to cross-session
+     * lastSessionTimestamp for true recency-based rotation.
+     */
+    getLastShown(tipId) {
+        if (this.sessionShown.has(tipId)) {
+            // Use a base larger than persisted epoch-millisecond timestamps so any
+            // session-shown tip sorts after cross-session-only tips, while still
+            // preserving prompt-count ordering within the current session.
+            return (Number.MAX_SAFE_INTEGER -
+                1_000_000 +
+                (this.sessionShown.get(tipId) ?? 0));
+        }
+        // Use the persisted last-shown timestamp for cross-session recency
+        return this.normalizeEntry(this.data.tips[tipId]).lastSessionTimestamp;
+    }
+    /**
+     * Normalize a persisted tip entry so corrupted values cannot crash mutations.
+     */
+    normalizeEntry(raw) {
+        if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
+            return { totalShown: 0, lastSessionTimestamp: 0 };
+        }
+        const candidate = raw;
+        return {
+            totalShown: typeof candidate.totalShown === 'number' &&
+                Number.isFinite(candidate.totalShown)
+                ? candidate.totalShown
+                : 0,
+            lastSessionTimestamp: typeof candidate.lastSessionTimestamp === 'number' &&
+                Number.isFinite(candidate.lastSessionTimestamp)
+                ? candidate.lastSessionTimestamp
+                : 0,
+        };
+    }
+    /**
+     * Record that a tip was shown at the given prompt count.
+     */
+    recordShown(tipId, currentPromptCount) {
+        this.sessionShown.set(tipId, currentPromptCount);
+        const entry = this.normalizeEntry(this.data.tips[tipId]);
+        entry.totalShown++;
+        entry.lastSessionTimestamp = Date.now();
+        this.data.tips[tipId] = entry;
+        this.persist();
+    }
+    /**
+     * Persist history to disk.
+     */
+    persist() {
+        try {
+            const dir = path.dirname(this.filePath);
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            atomicWriteFileSync(this.filePath, JSON.stringify(this.data, null, 2), {
+                mode: 0o600,
+                forceMode: true,
+                noFollow: true,
+            });
+        }
+        catch {
+            // Silently ignore write errors — tips are non-critical
+        }
+    }
+    /**
+     * Load history from disk, incrementing session count.
+     */
+    static load() {
+        const filePath = path.join(Storage.getGlobalQwenDir(), 'tip_history.json');
+        let data = { sessionCount: 0, tips: {} };
+        try {
+            if (fs.existsSync(filePath)) {
+                const raw = fs.readFileSync(filePath, 'utf-8');
+                const parsed = JSON.parse(raw);
+                if (typeof parsed === 'object' &&
+                    parsed !== null &&
+                    typeof parsed.sessionCount === 'number') {
+                    data = {
+                        sessionCount: Number.isFinite(parsed.sessionCount) && parsed.sessionCount >= 0
+                            ? Math.floor(parsed.sessionCount)
+                            : 0,
+                        tips: parsed.tips ?? {},
+                    };
+                }
+            }
+        }
+        catch {
+            // Ignore read/parse errors — start fresh
+        }
+        // Increment session count for this startup
+        data.sessionCount++;
+        data.tips =
+            typeof data.tips === 'object' &&
+                data.tips !== null &&
+                !Array.isArray(data.tips)
+                ? data.tips
+                : {};
+        const history = new TipHistory(data, filePath);
+        history.persist();
+        return history;
+    }
+}
+//# sourceMappingURL=tipHistory.js.map

package/dist/src/services/tips/tipHistory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tipHistory.js","sourceRoot":"","sources":["../../../../src/services/tips/tipHistory.ts"],"names":[],"mappings":"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"}

package/dist/src/services/tips/tipHistory.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/services/tips/tipHistory.test.js

@@ -0,0 +1,102 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, describe, it, expect } from 'vitest';
+import { TipHistory } from './tipHistory.js';
+const tempPaths = [];
+function tmpPath() {
+    const p = join(tmpdir(), `test-tip-history-${Date.now()}-${Math.random().toString(36).slice(2)}.json`);
+    tempPaths.push(p);
+    return p;
+}
+afterEach(() => {
+    for (const p of tempPaths) {
+        rmSync(p, { force: true });
+    }
+    tempPaths.length = 0;
+});
+function createHistory(sessionCount = 1) {
+    return new TipHistory({ sessionCount, tips: {} }, tmpPath());
+}
+describe('TipHistory', () => {
+    describe('isCooledDown', () => {
+        it('returns true when tip was never shown', () => {
+            const history = createHistory();
+            expect(history.isCooledDown('any-tip', 5, 10)).toBe(true);
+        });
+        it('returns false when within cooldown period', () => {
+            const history = createHistory();
+            history.recordShown('tip-a', 3);
+            // currentPrompt=5, lastShown=3, diff=2 < cooldown=5
+            expect(history.isCooledDown('tip-a', 5, 5)).toBe(false);
+        });
+        it('returns true when cooldown period has passed', () => {
+            const history = createHistory();
+            history.recordShown('tip-a', 3);
+            // currentPrompt=8, lastShown=3, diff=5 >= cooldown=5
+            expect(history.isCooledDown('tip-a', 5, 8)).toBe(true);
+        });
+        it('returns true when cooldownPrompts is 0 even if just shown', () => {
+            const history = createHistory();
+            history.recordShown('tip-a', 5);
+            // cooldown=0, currentPrompt=5, lastShown=5, diff=0 >= 0
+            expect(history.isCooledDown('tip-a', 0, 5)).toBe(true);
+        });
+        it('handles exact boundary (diff equals cooldown)', () => {
+            const history = createHistory();
+            history.recordShown('tip-a', 3);
+            // diff = 6 - 3 = 3 >= cooldown 3
+            expect(history.isCooledDown('tip-a', 3, 6)).toBe(true);
+        });
+    });
+    describe('getLastShown', () => {
+        it('returns 0 for never-shown tip', () => {
+            const history = createHistory();
+            expect(history.getLastShown('unknown')).toBe(0);
+        });
+        it('returns high score after recordShown (session-shown offset)', () => {
+            const history = createHistory();
+            history.recordShown('tip-a', 7);
+            // Session-shown tips get Number.MAX_SAFE_INTEGER - 1_000_000 + promptCount
+            expect(history.getLastShown('tip-a')).toBe(Number.MAX_SAFE_INTEGER - 1_000_000 + 7);
+        });
+        it('updates on subsequent recordShown calls', () => {
+            const history = createHistory();
+            history.recordShown('tip-a', 3);
+            history.recordShown('tip-a', 10);
+            expect(history.getLastShown('tip-a')).toBe(Number.MAX_SAFE_INTEGER - 1_000_000 + 10);
+        });
+        it('falls back to lastSessionTimestamp from cross-session data when session has no record', () => {
+            const history = new TipHistory({
+                sessionCount: 5,
+                tips: { 'tip-x': { totalShown: 3, lastSessionTimestamp: 1000 } },
+            }, tmpPath());
+            // No sessionShown record, so fallback to lastSessionTimestamp=1000
+            expect(history.getLastShown('tip-x')).toBe(1000);
+        });
+        it('session-shown tips always sort after cross-session-only tips', () => {
+            const history = new TipHistory({
+                sessionCount: 5,
+                tips: {
+                    'tip-old': { totalShown: 999, lastSessionTimestamp: Date.now() },
+                },
+            }, tmpPath());
+            history.recordShown('tip-new', 0);
+            // tip-old: cross-session only → 999
+            // tip-new: session-shown → 1_000_000
+            expect(history.getLastShown('tip-old')).toBeLessThan(history.getLastShown('tip-new'));
+        });
+    });
+    describe('sessionCount', () => {
+        it('exposes sessionCount from data', () => {
+            const history = createHistory(42);
+            expect(history.sessionCount).toBe(42);
+        });
+    });
+});
+//# sourceMappingURL=tipHistory.test.js.map

package/dist/src/services/tips/tipHistory.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tipHistory.test.js","sourceRoot":"","sources":["../../../../src/services/tips/tipHistory.test.ts"],"names":[],"mappings":"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"}

package/dist/src/services/tips/tipRegistry.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Contextual tip registry — defines tips, their conditions, and display rules.
+ */
+import { type CompactionThresholds } from '@tulex-cli/tulex-cli-core';
+export type TipTrigger = 'startup' | 'post-response';
+export interface TipContext {
+    lastPromptTokenCount: number;
+    contextWindowSize: number;
+    sessionPromptCount: number;
+    sessionCount: number;
+    platform: string;
+    /**
+     * Three-tier auto-compaction thresholds, computed by callers via
+     * `computeThresholds(contextWindowSize)`. Optional for backward compat;
+     * context-* tip checks return false when missing.
+     */
+    thresholds?: CompactionThresholds;
+}
+export interface ContextualTip {
+    id: string;
+    content: string;
+    trigger: TipTrigger;
+    isRelevant: (ctx: TipContext) => boolean;
+    cooldownPrompts: number;
+    priority: number;
+}
+export declare const tipRegistry: ContextualTip[];