@hale-bopp/valentino-engine 2.2.0 → 2.3.0

package/dist/core/cockpit-api.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Cockpit API — Intent-to-action layer for the Valentino Conversational Cockpit.
+ * Feature #778 (Il Sarto Parla), PBI #779 (Phase 0).
+ *
+ * Wraps editor.ts CRUD operations with a structured intent-based interface
+ * that an LLM can produce and an operator can review.
+ *
+ * Pure functions, no I/O, no LLM client — the consumer wires in the LLM.
+ */
+import type { PageSpecV1, SectionSpec } from './types.js';
+export type CockpitActionAddSection = {
+    action: 'add-section';
+    section: SectionSpec;
+    atIndex?: number;
+};
+export type CockpitActionEditSection = {
+    action: 'edit-section';
+    sectionIndex: number;
+    patch: Record<string, unknown>;
+};
+export type CockpitActionRemoveSection = {
+    action: 'remove-section';
+    sectionIndex: number;
+};
+export type CockpitActionMoveSection = {
+    action: 'move-section';
+    fromIndex: number;
+    toIndex: number;
+};
+export type CockpitActionEditPage = {
+    action: 'edit-page';
+    patch: Partial<Omit<PageSpecV1, 'version' | 'sections'>>;
+};
+export type CockpitActionQuery = {
+    action: 'query';
+    query: CockpitQuery;
+};
+export type CockpitAction = CockpitActionAddSection | CockpitActionEditSection | CockpitActionRemoveSection | CockpitActionMoveSection | CockpitActionEditPage | CockpitActionQuery;
+export type CockpitQuery = {
+    type: 'list-sections';
+} | {
+    type: 'get-section';
+    index: number;
+} | {
+    type: 'describe-page';
+} | {
+    type: 'list-section-types';
+} | {
+    type: 'get-editor-schema';
+    sectionType: string;
+} | {
+    type: 'validate';
+};
+export type CockpitWarning = {
+    source: 'editor' | 'rhythm' | 'integrity' | 'validation';
+    message: string;
+};
+export type CockpitActionResult = {
+    success: boolean;
+    spec: PageSpecV1;
+    warnings: CockpitWarning[];
+    /** For query actions, the query result data */
+    data?: unknown;
+};
+/**
+ * Execute a cockpit action on a PageSpec.
+ * Returns the (possibly updated) spec + validation warnings.
+ *
+ * All mutations are immutable — the original spec is never modified.
+ * All mutations are validated post-execution (rhythm, integrity, spec validation).
+ */
+export declare function executeCockpitAction(spec: PageSpecV1, action: CockpitAction): CockpitActionResult;
+export type CockpitBatchResult = {
+    spec: PageSpecV1;
+    results: CockpitActionResult[];
+    totalWarnings: number;
+};
+/**
+ * Execute multiple cockpit actions in sequence.
+ * Each action operates on the result of the previous one.
+ * Stops on first failure unless `continueOnError` is true.
+ */
+export declare function executeCockpitBatch(spec: PageSpecV1, actions: CockpitAction[], continueOnError?: boolean): CockpitBatchResult;
+/**
+ * Generate a human-readable description of a cockpit action.
+ * Useful for showing the operator what the LLM intends to do before executing.
+ */
+export declare function describeCockpitAction(action: CockpitAction): string;
+/**
+ * Registry of all valid section types for the cockpit.
+ * Used for validation and LLM context.
+ */
+export declare const COCKPIT_SECTION_TYPES: readonly string[];
+/**
+ * Validate that a cockpit action is structurally correct before execution.
+ * Returns a list of validation errors (empty = valid).
+ */
+export declare function validateCockpitAction(action: CockpitAction, spec: PageSpecV1): string[];
+//# sourceMappingURL=cockpit-api.d.ts.map

package/dist/core/cockpit-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cockpit-api.d.ts","sourceRoot":"","sources":["../../src/core/cockpit-api.ts"],"names":[],"mappings":"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"}

package/dist/core/cockpit-api.js

@@ -0,0 +1,269 @@
+/**
+ * Cockpit API — Intent-to-action layer for the Valentino Conversational Cockpit.
+ * Feature #778 (Il Sarto Parla), PBI #779 (Phase 0).
+ *
+ * Wraps editor.ts CRUD operations with a structured intent-based interface
+ * that an LLM can produce and an operator can review.
+ *
+ * Pure functions, no I/O, no LLM client — the consumer wires in the LLM.
+ */
+import { validatePageSpec } from './page-spec.js';
+import { addSection, removeSection, moveSection, applySectionPatch, applyPagePatch, generateEditorSchema, getEditableSectionTypes, } from './editor.js';
+import { probeRhythm } from './rhythm.js';
+import { probeSectionIntegrity } from './section-integrity.js';
+// ---------------------------------------------------------------------------
+// Validation — pre-flight + post-flight checks
+// ---------------------------------------------------------------------------
+function collectWarnings(spec, editorWarnings) {
+    const warnings = [];
+    for (const w of editorWarnings) {
+        warnings.push({ source: 'editor', message: `${w.field}: ${w.message}` });
+    }
+    if (!validatePageSpec(spec)) {
+        warnings.push({ source: 'validation', message: 'PageSpecV1 validation failed' });
+    }
+    const rhythmResult = probeRhythm(spec);
+    for (const w of rhythmResult.warnings) {
+        warnings.push({ source: 'rhythm', message: w.message });
+    }
+    const integrityResult = probeSectionIntegrity(spec.sections);
+    for (const w of integrityResult.warnings) {
+        warnings.push({ source: 'integrity', message: w.message });
+    }
+    return warnings;
+}
+// ---------------------------------------------------------------------------
+// Query execution
+// ---------------------------------------------------------------------------
+function executeQuery(spec, query) {
+    switch (query.type) {
+        case 'list-sections':
+            return {
+                success: true,
+                spec,
+                warnings: [],
+                data: spec.sections.map((s, i) => ({
+                    index: i,
+                    type: s.type,
+                    ...(('titleKey' in s && s.titleKey) ? { titleKey: s.titleKey } : {}),
+                })),
+            };
+        case 'get-section': {
+            const section = spec.sections[query.index];
+            if (!section) {
+                return {
+                    success: false,
+                    spec,
+                    warnings: [{ source: 'editor', message: `Section index ${query.index} out of bounds` }],
+                };
+            }
+            return { success: true, spec, warnings: [], data: section };
+        }
+        case 'describe-page':
+            return {
+                success: true,
+                spec,
+                warnings: [],
+                data: {
+                    id: spec.id,
+                    profile: spec.profile,
+                    titleKey: spec.titleKey,
+                    themeId: spec.themeId,
+                    sectionCount: spec.sections.length,
+                    sectionTypes: spec.sections.map(s => s.type),
+                },
+            };
+        case 'list-section-types':
+            return {
+                success: true,
+                spec,
+                warnings: [],
+                data: getEditableSectionTypes(),
+            };
+        case 'get-editor-schema': {
+            const schema = generateEditorSchema(query.sectionType);
+            if (!schema) {
+                return {
+                    success: false,
+                    spec,
+                    warnings: [{ source: 'editor', message: `Unknown section type: ${query.sectionType}` }],
+                };
+            }
+            return { success: true, spec, warnings: [], data: schema };
+        }
+        case 'validate': {
+            const warnings = collectWarnings(spec, []);
+            return {
+                success: warnings.length === 0,
+                spec,
+                warnings,
+                data: { valid: warnings.length === 0, warningCount: warnings.length },
+            };
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Action execution — the core cockpit engine
+// ---------------------------------------------------------------------------
+/**
+ * Execute a cockpit action on a PageSpec.
+ * Returns the (possibly updated) spec + validation warnings.
+ *
+ * All mutations are immutable — the original spec is never modified.
+ * All mutations are validated post-execution (rhythm, integrity, spec validation).
+ */
+export function executeCockpitAction(spec, action) {
+    switch (action.action) {
+        case 'add-section': {
+            const newSpec = addSection(spec, action.section, action.atIndex);
+            const warnings = collectWarnings(newSpec, []);
+            return { success: true, spec: newSpec, warnings };
+        }
+        case 'edit-section': {
+            const { spec: newSpec, warnings: editorWarnings } = applySectionPatch(spec, action.sectionIndex, action.patch);
+            const warnings = collectWarnings(newSpec, editorWarnings);
+            return { success: editorWarnings.length === 0, spec: newSpec, warnings };
+        }
+        case 'remove-section': {
+            if (action.sectionIndex < 0 || action.sectionIndex >= spec.sections.length) {
+                return {
+                    success: false,
+                    spec,
+                    warnings: [{ source: 'editor', message: `Section index ${action.sectionIndex} out of bounds` }],
+                };
+            }
+            const newSpec = removeSection(spec, action.sectionIndex);
+            const warnings = collectWarnings(newSpec, []);
+            return { success: true, spec: newSpec, warnings };
+        }
+        case 'move-section': {
+            const newSpec = moveSection(spec, action.fromIndex, action.toIndex);
+            if (newSpec === spec) {
+                return {
+                    success: false,
+                    spec,
+                    warnings: [{ source: 'editor', message: `Invalid move: ${action.fromIndex} → ${action.toIndex}` }],
+                };
+            }
+            const warnings = collectWarnings(newSpec, []);
+            return { success: true, spec: newSpec, warnings };
+        }
+        case 'edit-page': {
+            const newSpec = applyPagePatch(spec, action.patch);
+            const warnings = collectWarnings(newSpec, []);
+            return { success: true, spec: newSpec, warnings };
+        }
+        case 'query':
+            return executeQuery(spec, action.query);
+    }
+}
+/**
+ * Execute multiple cockpit actions in sequence.
+ * Each action operates on the result of the previous one.
+ * Stops on first failure unless `continueOnError` is true.
+ */
+export function executeCockpitBatch(spec, actions, continueOnError = false) {
+    let currentSpec = spec;
+    const results = [];
+    let totalWarnings = 0;
+    for (const action of actions) {
+        const result = executeCockpitAction(currentSpec, action);
+        results.push(result);
+        totalWarnings += result.warnings.length;
+        currentSpec = result.spec;
+        if (!result.success && !continueOnError)
+            break;
+    }
+    return { spec: currentSpec, results, totalWarnings };
+}
+// ---------------------------------------------------------------------------
+// Action description — human-readable summary for operator review
+// ---------------------------------------------------------------------------
+/**
+ * Generate a human-readable description of a cockpit action.
+ * Useful for showing the operator what the LLM intends to do before executing.
+ */
+export function describeCockpitAction(action) {
+    switch (action.action) {
+        case 'add-section':
+            return `Add ${action.section.type} section${action.atIndex != null ? ` at position ${action.atIndex}` : ' at the end'}`;
+        case 'edit-section':
+            return `Edit section #${action.sectionIndex}: update ${Object.keys(action.patch).join(', ')}`;
+        case 'remove-section':
+            return `Remove section #${action.sectionIndex}`;
+        case 'move-section':
+            return `Move section from position ${action.fromIndex} to ${action.toIndex}`;
+        case 'edit-page':
+            return `Edit page properties: ${Object.keys(action.patch).join(', ')}`;
+        case 'query':
+            return `Query: ${action.query.type}`;
+    }
+}
+// ---------------------------------------------------------------------------
+// Action parsing — parse natural language intent into structured action
+// ---------------------------------------------------------------------------
+/**
+ * Registry of all valid section types for the cockpit.
+ * Used for validation and LLM context.
+ */
+export const COCKPIT_SECTION_TYPES = [
+    'hero', 'cards', 'comparison', 'cta', 'form', 'manifesto', 'spacer',
+    'showcase-intro', 'component-showcase',
+    'agent-dashboard', 'agent-graph', 'agent-list',
+    'data-list', 'action-form',
+    'stats', 'how-it-works',
+    'advisor', 'mermaid-diagram', 'valentino-catalog',
+];
+/**
+ * Validate that a cockpit action is structurally correct before execution.
+ * Returns a list of validation errors (empty = valid).
+ */
+export function validateCockpitAction(action, spec) {
+    const errors = [];
+    switch (action.action) {
+        case 'add-section':
+            if (!action.section || !action.section.type) {
+                errors.push('add-section requires a section with a type');
+            }
+            else if (!COCKPIT_SECTION_TYPES.includes(action.section.type)) {
+                errors.push(`Unknown section type: ${action.section.type}`);
+            }
+            if (action.atIndex != null && (action.atIndex < 0 || action.atIndex > spec.sections.length)) {
+                errors.push(`atIndex ${action.atIndex} out of bounds (0..${spec.sections.length})`);
+            }
+            break;
+        case 'edit-section':
+            if (action.sectionIndex < 0 || action.sectionIndex >= spec.sections.length) {
+                errors.push(`sectionIndex ${action.sectionIndex} out of bounds (0..${spec.sections.length - 1})`);
+            }
+            if (!action.patch || Object.keys(action.patch).length === 0) {
+                errors.push('edit-section requires a non-empty patch');
+            }
+            break;
+        case 'remove-section':
+            if (action.sectionIndex < 0 || action.sectionIndex >= spec.sections.length) {
+                errors.push(`sectionIndex ${action.sectionIndex} out of bounds (0..${spec.sections.length - 1})`);
+            }
+            break;
+        case 'move-section':
+            if (action.fromIndex < 0 || action.fromIndex >= spec.sections.length) {
+                errors.push(`fromIndex ${action.fromIndex} out of bounds`);
+            }
+            if (action.toIndex < 0 || action.toIndex >= spec.sections.length) {
+                errors.push(`toIndex ${action.toIndex} out of bounds`);
+            }
+            break;
+        case 'edit-page':
+            if (!action.patch || Object.keys(action.patch).length === 0) {
+                errors.push('edit-page requires a non-empty patch');
+            }
+            break;
+        case 'query':
+            if (!action.query || !action.query.type) {
+                errors.push('query requires a query with a type');
+            }
+            break;
+    }
+    return errors;
+}
+//# sourceMappingURL=cockpit-api.js.map

package/dist/core/cockpit-api.js.map

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

package/dist/core/cockpit-repl.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Cockpit REPL — Interactive conversational loop for operators.
+ * Feature #778 (Il Sarto Parla), PBI #780 (Phase 1).
+ *
+ * Reads operator input, parses intent, executes action, shows results.
+ * Uses Node readline for terminal I/O.
+ */
+import type { PageSpecV1 } from './types.js';
+import type { IntentLlmCallback } from './intent-parser.js';
+export type ReplOptions = {
+    /** Initial page spec to work with */
+    spec: PageSpecV1;
+    /** Optional LLM callback for smarter intent parsing */
+    llm?: IntentLlmCallback;
+    /** Optional callback when spec changes (e.g., auto-save) */
+    onSpecChange?: (spec: PageSpecV1) => void;
+    /** Custom prompt string (default: "valentino> ") */
+    prompt?: string;
+    /** Output stream (default: process.stdout) */
+    output?: NodeJS.WritableStream;
+    /** Input stream (default: process.stdin) */
+    input?: NodeJS.ReadableStream;
+};
+export type ReplSession = {
+    /** Current page spec */
+    spec: PageSpecV1;
+    /** Action history for undo */
+    history: PageSpecV1[];
+    /** Number of actions executed */
+    actionCount: number;
+};
+/**
+ * Process a single REPL input line.
+ * Returns the output text to display.
+ * Mutates session in-place (spec, history, actionCount).
+ */
+export declare function processReplInput(input: string, session: ReplSession, llm?: IntentLlmCallback): Promise<{
+    output: string;
+    exit: boolean;
+}>;
+/**
+ * Start the interactive REPL.
+ * This is the main entry point for `valentino cockpit --interactive`.
+ */
+export declare function startRepl(options: ReplOptions): Promise<void>;
+/**
+ * Create a REPL session without starting I/O.
+ * Useful for testing or embedding in other tools.
+ */
+export declare function createReplSession(spec: PageSpecV1): ReplSession;
+//# sourceMappingURL=cockpit-repl.d.ts.map

package/dist/core/cockpit-repl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cockpit-repl.d.ts","sourceRoot":"","sources":["../../src/core/cockpit-repl.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAa5D,MAAM,MAAM,WAAW,GAAG;IACtB,qCAAqC;IACrC,IAAI,EAAE,UAAU,CAAC;IACjB,uDAAuD;IACvD,GAAG,CAAC,EAAE,iBAAiB,CAAC;IACxB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IAC1C,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC/B,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACtB,wBAAwB;IACxB,IAAI,EAAE,UAAU,CAAC;IACjB,8BAA8B;IAC9B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC;AA0FF;;;;GAIG;AACH,wBAAsB,gBAAgB,CAClC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,WAAW,EACpB,GAAG,CAAC,EAAE,iBAAiB,GACxB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAmF5C;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA2CnE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,CAM/D"}

package/dist/core/cockpit-repl.js

@@ -0,0 +1,217 @@
+/**
+ * Cockpit REPL — Interactive conversational loop for operators.
+ * Feature #778 (Il Sarto Parla), PBI #780 (Phase 1).
+ *
+ * Reads operator input, parses intent, executes action, shows results.
+ * Uses Node readline for terminal I/O.
+ */
+import { createInterface } from 'readline';
+import { executeCockpitAction, validateCockpitAction, } from './cockpit-api.js';
+import { parseIntent } from './intent-parser.js';
+// ---------------------------------------------------------------------------
+// Output formatting
+// ---------------------------------------------------------------------------
+function formatWarnings(warnings) {
+    if (warnings.length === 0)
+        return '';
+    return warnings.map(w => {
+        const icon = w.source === 'validation' ? '  \u274C' : '  \u26A0 ';
+        return `${icon} [${w.source}] ${w.message}`;
+    }).join('\n');
+}
+function formatQueryData(data) {
+    if (data === null || data === undefined)
+        return '';
+    if (Array.isArray(data)) {
+        return data.map((item, i) => {
+            if (typeof item === 'object' && item !== null) {
+                const parts = Object.entries(item).map(([k, v]) => `${k}: ${v}`);
+                return `  ${i}. ${parts.join(', ')}`;
+            }
+            return `  ${i}. ${item}`;
+        }).join('\n');
+    }
+    if (typeof data === 'object') {
+        return Object.entries(data)
+            .map(([k, v]) => `  ${k}: ${JSON.stringify(v)}`)
+            .join('\n');
+    }
+    return String(data);
+}
+function formatResult(result) {
+    const parts = [];
+    if (result.success) {
+        parts.push('  \u2705 Done');
+    }
+    else {
+        parts.push('  \u274C Failed');
+    }
+    const warningText = formatWarnings(result.warnings);
+    if (warningText)
+        parts.push(warningText);
+    if (result.data !== undefined) {
+        parts.push(formatQueryData(result.data));
+    }
+    return parts.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Built-in commands
+// ---------------------------------------------------------------------------
+const BUILTIN_COMMANDS = {
+    'help': 'Show available commands',
+    'undo': 'Undo last action',
+    'history': 'Show action history count',
+    'json': 'Print current spec as JSON',
+    'save': 'Print spec JSON (pipe to file)',
+    'exit': 'Exit the cockpit',
+    'quit': 'Exit the cockpit',
+};
+function showHelp() {
+    return [
+        '',
+        '  Valentino Cockpit — Il Sarto Parla',
+        '',
+        '  Parla in linguaggio naturale (IT/EN):',
+        '    "mostrami le sezioni"        \u2192 lista sezioni',
+        '    "descrivi la pagina"          \u2192 panoramica pagina',
+        '    "valida"                      \u2192 validazione completa',
+        '    "aggiungi una sezione stats"  \u2192 aggiunge stats',
+        '    "rimuovi la cta"             \u2192 rimuove prima CTA',
+        '    "sposta sezione 3 a 1"       \u2192 riordina',
+        '    "cambia il titolo dell\'hero in X" \u2192 modifica campo',
+        '',
+        '  Comandi built-in:',
+        ...Object.entries(BUILTIN_COMMANDS).map(([cmd, desc]) => `    ${cmd.padEnd(12)} ${desc}`),
+        '',
+    ].join('\n');
+}
+// ---------------------------------------------------------------------------
+// REPL engine
+// ---------------------------------------------------------------------------
+/**
+ * Process a single REPL input line.
+ * Returns the output text to display.
+ * Mutates session in-place (spec, history, actionCount).
+ */
+export async function processReplInput(input, session, llm) {
+    const trimmed = input.trim();
+    if (!trimmed) {
+        return { output: '', exit: false };
+    }
+    // Built-in commands
+    switch (trimmed.toLowerCase()) {
+        case 'help':
+        case '?':
+            return { output: showHelp(), exit: false };
+        case 'exit':
+        case 'quit':
+        case 'esci':
+            return { output: '  Arrivederci.', exit: true };
+        case 'undo':
+        case 'annulla': {
+            if (session.history.length === 0) {
+                return { output: '  Nothing to undo.', exit: false };
+            }
+            session.spec = session.history.pop();
+            return { output: '  \u2705 Undo successful.', exit: false };
+        }
+        case 'history':
+        case 'cronologia':
+            return { output: `  ${session.actionCount} actions executed, ${session.history.length} undoable.`, exit: false };
+        case 'json':
+        case 'save':
+            return { output: JSON.stringify(session.spec, null, 2), exit: false };
+    }
+    // Parse intent
+    const parseResult = await parseIntent(trimmed, session.spec, llm);
+    if (!parseResult.intent) {
+        return {
+            output: '  \u2753 Non ho capito. Prova "help" per vedere i comandi disponibili.',
+            exit: false,
+        };
+    }
+    const { action, confidence, description } = parseResult.intent;
+    // Show what we understood
+    let output = `  \u2192 ${description}`;
+    if (confidence === 'low') {
+        output += ' (low confidence)';
+    }
+    if (parseResult.fallbackReason) {
+        output += `\n  \u26A0  Fallback: ${parseResult.fallbackReason}`;
+    }
+    // Pre-flight validation
+    const preErrors = validateCockpitAction(action, session.spec);
+    if (preErrors.length > 0) {
+        output += '\n  \u274C Validation errors:';
+        for (const e of preErrors) {
+            output += `\n     ${e}`;
+        }
+        return { output, exit: false };
+    }
+    // For mutations: save undo point
+    if (action.action !== 'query') {
+        session.history.push(structuredClone(session.spec));
+    }
+    // Execute
+    const result = executeCockpitAction(session.spec, action);
+    output += '\n' + formatResult(result);
+    // Update spec
+    if (result.success && action.action !== 'query') {
+        session.spec = result.spec;
+        session.actionCount++;
+    }
+    return { output, exit: false };
+}
+/**
+ * Start the interactive REPL.
+ * This is the main entry point for `valentino cockpit --interactive`.
+ */
+export async function startRepl(options) {
+    const promptStr = options.prompt || 'valentino> ';
+    const output = options.output || process.stdout;
+    const session = {
+        spec: structuredClone(options.spec),
+        history: [],
+        actionCount: 0,
+    };
+    const rl = createInterface({
+        input: options.input || process.stdin,
+        output: output,
+        prompt: promptStr,
+    });
+    output.write('\n  \uD83C\uDFA8 Valentino Cockpit — Il Sarto Parla\n');
+    output.write(`  Page: ${session.spec.id} (${session.spec.sections.length} sections)\n`);
+    output.write('  Type "help" for commands, or speak naturally.\n\n');
+    rl.prompt();
+    rl.on('line', async (line) => {
+        const { output: text, exit } = await processReplInput(line, session, options.llm);
+        if (text)
+            output.write(text + '\n');
+        if (exit) {
+            if (options.onSpecChange && session.actionCount > 0) {
+                options.onSpecChange(session.spec);
+            }
+            rl.close();
+            return;
+        }
+        output.write('\n');
+        rl.prompt();
+    });
+    rl.on('close', () => {
+        if (options.onSpecChange && session.actionCount > 0) {
+            options.onSpecChange(session.spec);
+        }
+    });
+}
+/**
+ * Create a REPL session without starting I/O.
+ * Useful for testing or embedding in other tools.
+ */
+export function createReplSession(spec) {
+    return {
+        spec: structuredClone(spec),
+        history: [],
+        actionCount: 0,
+    };
+}
+//# sourceMappingURL=cockpit-repl.js.map