/**
 * Plugin-Install Handoff Context Generator
 *
 * NOTE: This is the legacy plugin-INSTALL handoff (renamed from
 * `handoff-context.ts` in 0867 to free that name for the cross-tool work
 * handoff). It is unrelated to `work-handoff.ts` / `handoff-doc-format.ts`.
 *
 * Generates context information for session handoff, enabling users
 * to continue their work in a new session after plugin installation.
 *
 * The context includes:
 * - Summary of what was accomplished
 * - Original user intent
 * - List of installed plugins
 * - Available skills from those plugins
 * - Suggested continuation prompt
 *
 * @module core/session/install-handoff-context
 */
/**
 * A skill/command available from an installed plugin
 */
export interface Skill {
    /** Skill name (e.g., "sw:increment") */
    name: string;
    /** Description of what the skill does */
    description: string;
    /** Category for grouping (e.g., "workflow", "frontend", "sync") */
    category: string;
}
/**
 * Options for generating handoff context
 */
export interface HandoffContextOptions {
    /** List of installed plugins */
    plugins: string[];
    /** Project path where plugins were installed */
    projectPath?: string;
    /** Original user intent/task */
    originalIntent?: string;
    /** User's home directory for path normalization */
    userHome?: string;
}
/**
 * Generated handoff context
 */
export interface HandoffContext {
    /** Summary of session accomplishments */
    summary: string;
    /** Original user intent */
    originalIntent?: string;
    /** List of installed plugins */
    plugins: string[];
    /** Full project path */
    projectPath?: string;
    /** Normalized path (with ~ for home) */
    normalizedPath?: string;
    /** Available skills from installed plugins */
    availableSkills: Skill[];
    /** Suggested prompt to continue in new session */
    continuationPrompt: string;
}
/**
 * Generate handoff context for session continuation
 *
 * Creates a structured context object containing all the information
 * needed to continue work in a new session.
 *
 * @param options - Context generation options
 * @returns Generated handoff context
 *
 * @example
 * ```typescript
 * const context = generateHandoffContext({
 *   plugins: ['sw', 'frontend'],
 *   projectPath: '/path/to/project',
 *   originalIntent: 'Create React dashboard'
 * });
 * console.log(context.continuationPrompt);
 * ```
 */
export declare function generateHandoffContext(options: HandoffContextOptions): HandoffContext;
/**
 * Format handoff context as copy-paste ready text
 *
 * Creates a formatted text block that users can copy and paste
 * into a new session to provide context.
 *
 * @param options - Context generation options
 * @returns Formatted text ready for copy-paste
 *
 * @example
 * ```typescript
 * const text = formatHandoffText({
 *   plugins: ['sw', 'frontend'],
 *   projectPath: '/path/to/project',
 *   originalIntent: 'Create React dashboard'
 * });
 * console.log(text); // Copy-paste ready context
 * ```
 */
export declare function formatHandoffText(options: HandoffContextOptions): string;
//# sourceMappingURL=install-handoff-context.d.ts.map