pm-orchestrator-runner 1.0.0

package/dist/mediation/real-llm-mediation-layer.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Real LLM Mediation Layer
+ *
+ * Uses REAL LLM API calls (no stubs/mocks) to:
+ * 1. Generate natural language questions from structured reason codes
+ * 2. Normalize free-form user input into structured tasks
+ *
+ * ARCHITECTURAL RULES:
+ * - This layer sits ABOVE Runner Core
+ * - Runner Core returns ONLY structured signals (no conversational text)
+ * - This layer generates ALL human-readable text via LLM
+ * - Output structure is ALWAYS stable regardless of LLM text variation
+ */
+import { LLMClient, LLMProvider } from './llm-client';
+import { ClarificationReason, RunnerSignal, ParsedUserResponse, NormalizedTask, MediationOutput } from './llm-mediation-layer';
+/**
+ * Configuration for Real LLM Mediation Layer
+ */
+export interface RealLLMConfig {
+    provider?: LLMProvider;
+    model?: string;
+    temperature?: number;
+}
+/**
+ * Real LLM Mediation Layer
+ *
+ * IMPORTANT: This class makes REAL API calls to LLM providers.
+ * - No stubs or mocks
+ * - temperature > 0 for non-deterministic output
+ * - Output varies every call, but structure remains stable
+ */
+export declare class RealLLMMediationLayer {
+    private readonly client;
+    constructor(config?: RealLLMConfig);
+    /**
+     * Get the LLM client (for testing/inspection)
+     */
+    getClient(): LLMClient;
+    /**
+     * Process Runner signal and generate appropriate output using LLM
+     *
+     * @param signal - Structured signal from Runner Core
+     * @returns Mediation output with LLM-generated question
+     */
+    processRunnerSignal(signal: RunnerSignal): Promise<MediationOutput>;
+    /**
+     * Parse and normalize user response using LLM
+     *
+     * @param userInput - Raw user input string
+     * @param context - Context from previous clarification
+     * @returns Parsed user response (structure is stable regardless of LLM variation)
+     */
+    parseUserResponse(userInput: string, context: {
+        clarification_reason?: ClarificationReason;
+        target_file?: string;
+        original_prompt?: string;
+    }): Promise<ParsedUserResponse>;
+    /**
+     * Normalize user response into explicit task for Runner
+     *
+     * @param originalPrompt - Original user prompt
+     * @param signal - Runner signal that triggered clarification
+     * @param parsedResponse - Parsed user response
+     * @returns Normalized task (structure is always stable)
+     */
+    normalizeToTask(originalPrompt: string, signal: RunnerSignal, parsedResponse: ParsedUserResponse): Promise<NormalizedTask | null>;
+    /**
+     * Generate question via LLM from clarification reason
+     *
+     * Each call may produce different text, but conveys the same meaning.
+     */
+    private generateQuestion;
+    /**
+     * Generate status message via LLM
+     */
+    private generateStatusMessage;
+    /**
+     * Generate explicit prompt for Runner
+     */
+    private generateExplicitPrompt;
+    /**
+     * Get human-readable description for clarification reason
+     */
+    private getReasonDescription;
+    /**
+     * Get suggested responses for clarification reason
+     */
+    private getSuggestedResponses;
+    /**
+     * Build prompt for parsing user response
+     */
+    private buildParsePrompt;
+    /**
+     * Parse LLM classification response into ParsedUserResponse
+     *
+     * This is the NORMALIZATION step - ensures stable structure regardless of LLM variation
+     */
+    private parseClassificationResponse;
+    /**
+     * Generate alternative file name (deterministic, no LLM)
+     */
+    private generateAlternativeName;
+}
+//# sourceMappingURL=real-llm-mediation-layer.d.ts.map

package/dist/mediation/real-llm-mediation-layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"real-llm-mediation-layer.d.ts","sourceRoot":"","sources":["../../src/mediation/real-llm-mediation-layer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAElB,cAAc,EACd,eAAe,EAChB,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;gBAEvB,MAAM,CAAC,EAAE,aAAa;IAQlC;;OAEG;IACH,SAAS,IAAI,SAAS;IAItB;;;;;OAKG;IACG,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC;IAqBzE;;;;;;OAMG;IACG,iBAAiB,CACrB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;QAAE,oBAAoB,CAAC,EAAE,mBAAmB,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,GACtG,OAAO,CAAC,kBAAkB,CAAC;IA4B9B;;;;;;;OAOG;IACG,eAAe,CACnB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,YAAY,EACpB,cAAc,EAAE,kBAAkB,GACjC,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IA6DjC;;;;OAIG;YACW,gBAAgB;IA0B9B;;OAEG;YACW,qBAAqB;IA8BnC;;OAEG;YACW,sBAAsB;IAiBpC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAY7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAoBxB;;;;OAIG;IACH,OAAO,CAAC,2BAA2B;IAgCnC;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAehC"}

package/dist/mediation/real-llm-mediation-layer.js

@@ -0,0 +1,322 @@
+"use strict";
+/**
+ * Real LLM Mediation Layer
+ *
+ * Uses REAL LLM API calls (no stubs/mocks) to:
+ * 1. Generate natural language questions from structured reason codes
+ * 2. Normalize free-form user input into structured tasks
+ *
+ * ARCHITECTURAL RULES:
+ * - This layer sits ABOVE Runner Core
+ * - Runner Core returns ONLY structured signals (no conversational text)
+ * - This layer generates ALL human-readable text via LLM
+ * - Output structure is ALWAYS stable regardless of LLM text variation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RealLLMMediationLayer = void 0;
+const llm_client_1 = require("./llm-client");
+/**
+ * Real LLM Mediation Layer
+ *
+ * IMPORTANT: This class makes REAL API calls to LLM providers.
+ * - No stubs or mocks
+ * - temperature > 0 for non-deterministic output
+ * - Output varies every call, but structure remains stable
+ */
+class RealLLMMediationLayer {
+    client;
+    constructor(config) {
+        this.client = llm_client_1.LLMClient.fromEnv(config?.provider ?? 'openai', config?.model, { temperature: config?.temperature ?? 0.7 });
+    }
+    /**
+     * Get the LLM client (for testing/inspection)
+     */
+    getClient() {
+        return this.client;
+    }
+    /**
+     * Process Runner signal and generate appropriate output using LLM
+     *
+     * @param signal - Structured signal from Runner Core
+     * @returns Mediation output with LLM-generated question
+     */
+    async processRunnerSignal(signal) {
+        // If no clarification needed, generate status message via LLM
+        if (!signal.clarification_needed) {
+            const statusMessage = await this.generateStatusMessage(signal);
+            return {
+                needs_user_input: false,
+                status_message: statusMessage,
+            };
+        }
+        // Generate question via LLM based on clarification reason
+        const question = await this.generateQuestion(signal);
+        const suggestedResponses = this.getSuggestedResponses(signal.clarification_reason);
+        return {
+            needs_user_input: true,
+            question,
+            suggested_responses: suggestedResponses,
+        };
+    }
+    /**
+     * Parse and normalize user response using LLM
+     *
+     * @param userInput - Raw user input string
+     * @param context - Context from previous clarification
+     * @returns Parsed user response (structure is stable regardless of LLM variation)
+     */
+    async parseUserResponse(userInput, context) {
+        const prompt = this.buildParsePrompt(userInput, context);
+        const response = await this.client.chat([
+            {
+                role: 'system',
+                content: `You are a response parser. Analyze the user's response and classify it into exactly one of these types:
+- "overwrite": User wants to overwrite an existing file
+- "new_name": User wants to create with a new/different name
+- "cancel": User wants to cancel the operation
+- "specify_file": User specified a file name or path
+- "specify_action": User specified what action to take
+- "unknown": Cannot determine user's intent
+
+Respond with ONLY a JSON object in this exact format:
+{"type": "<type>", "file_name": "<extracted_file_name_if_any>", "action": "<extracted_action_if_any>"}
+
+Do not include any explanation, only the JSON.`,
+            },
+            {
+                role: 'user',
+                content: prompt,
+            },
+        ]);
+        return this.parseClassificationResponse(response.content, userInput);
+    }
+    /**
+     * Normalize user response into explicit task for Runner
+     *
+     * @param originalPrompt - Original user prompt
+     * @param signal - Runner signal that triggered clarification
+     * @param parsedResponse - Parsed user response
+     * @returns Normalized task (structure is always stable)
+     */
+    async normalizeToTask(originalPrompt, signal, parsedResponse) {
+        if (parsedResponse.type === 'cancel') {
+            return null;
+        }
+        const context = {
+            original_prompt: originalPrompt,
+            clarification_reason: signal.clarification_reason,
+            user_response: parsedResponse.raw_input,
+        };
+        // Map parsed response to normalized task
+        // This mapping is DETERMINISTIC - no LLM involved
+        // Structure is always stable regardless of how we got here
+        switch (parsedResponse.type) {
+            case 'overwrite':
+                return {
+                    explicit_prompt: await this.generateExplicitPrompt('overwrite', signal.target_file, originalPrompt),
+                    target_file: signal.target_file,
+                    action: 'overwrite',
+                    original_context: context,
+                };
+            case 'new_name':
+                const newFileName = parsedResponse.new_file_name || this.generateAlternativeName(signal.target_file);
+                return {
+                    explicit_prompt: await this.generateExplicitPrompt('create_new', newFileName, originalPrompt),
+                    target_file: newFileName,
+                    action: 'create_new',
+                    original_context: context,
+                };
+            case 'specify_file':
+                return {
+                    explicit_prompt: await this.generateExplicitPrompt('create', parsedResponse.new_file_name, originalPrompt),
+                    target_file: parsedResponse.new_file_name,
+                    action: 'create',
+                    original_context: context,
+                };
+            case 'specify_action':
+                return {
+                    explicit_prompt: parsedResponse.specified_action || originalPrompt,
+                    action: 'modify',
+                    original_context: context,
+                };
+            default:
+                // Unknown response - return original prompt with context
+                return {
+                    explicit_prompt: originalPrompt,
+                    action: 'create',
+                    original_context: context,
+                };
+        }
+    }
+    // ============================================================
+    // Private LLM-powered methods
+    // ============================================================
+    /**
+     * Generate question via LLM from clarification reason
+     *
+     * Each call may produce different text, but conveys the same meaning.
+     */
+    async generateQuestion(signal) {
+        const reasonDescription = this.getReasonDescription(signal.clarification_reason);
+        const response = await this.client.chat([
+            {
+                role: 'system',
+                content: `You are a helpful assistant that generates natural Japanese questions.
+Generate a clear, polite question to ask the user for clarification.
+The question should be natural and conversational.
+Respond with ONLY the question text, no explanations.`,
+            },
+            {
+                role: 'user',
+                content: `Generate a Japanese question for this situation:
+
+Reason: ${reasonDescription}
+${signal.target_file ? `Target file: ${signal.target_file}` : ''}
+${signal.original_prompt ? `Original request: ${signal.original_prompt}` : ''}
+
+Generate a natural Japanese question to ask the user.`,
+            },
+        ]);
+        return response.content.trim();
+    }
+    /**
+     * Generate status message via LLM
+     */
+    async generateStatusMessage(signal) {
+        if (!signal.execution_result) {
+            return 'タスクを処理中です。';
+        }
+        const result = signal.execution_result;
+        let context = `Status: ${result.status}`;
+        if (result.verified_files && result.verified_files.length > 0) {
+            const existingFiles = result.verified_files.filter(f => f.exists).map(f => f.path);
+            if (existingFiles.length > 0) {
+                context += `\nCreated files: ${existingFiles.join(', ')}`;
+            }
+        }
+        const response = await this.client.chat([
+            {
+                role: 'system',
+                content: `You are a helpful assistant that generates natural Japanese status messages.
+Generate a brief, clear status message based on the task result.
+Respond with ONLY the message text, no explanations.`,
+            },
+            {
+                role: 'user',
+                content: `Generate a Japanese status message for this result:\n${context}`,
+            },
+        ]);
+        return response.content.trim();
+    }
+    /**
+     * Generate explicit prompt for Runner
+     */
+    async generateExplicitPrompt(action, targetFile, originalPrompt) {
+        // For simplicity and stability, use template-based prompts
+        // This ensures the structure passed to Runner is always predictable
+        switch (action) {
+            case 'overwrite':
+                return `${targetFile} を上書きして作成してください。元のリクエスト: ${originalPrompt}`;
+            case 'create_new':
+                return `${targetFile} を新規作成してください。元のリクエスト: ${originalPrompt}`;
+            case 'create':
+                return `${targetFile} を作成してください。元のリクエスト: ${originalPrompt}`;
+        }
+    }
+    /**
+     * Get human-readable description for clarification reason
+     */
+    getReasonDescription(reason) {
+        switch (reason) {
+            case 'target_file_exists':
+                return 'A file with the same name already exists. Need to decide whether to overwrite or create with a new name.';
+            case 'target_file_ambiguous':
+                return 'Cannot determine which file to target from the request. Need the user to specify a file name or path.';
+            case 'target_action_ambiguous':
+                return 'Cannot determine what action to take. Need the user to clarify what they want to do.';
+            case 'missing_required_info':
+                return 'Missing required information to proceed. Need the user to provide more details.';
+            default:
+                return 'Need clarification from the user.';
+        }
+    }
+    /**
+     * Get suggested responses for clarification reason
+     */
+    getSuggestedResponses(reason) {
+        switch (reason) {
+            case 'target_file_exists':
+                return ['overwrite', 'new', 'cancel'];
+            case 'target_file_ambiguous':
+            case 'target_action_ambiguous':
+            case 'missing_required_info':
+            default:
+                return [];
+        }
+    }
+    /**
+     * Build prompt for parsing user response
+     */
+    buildParsePrompt(userInput, context) {
+        let prompt = `User input: "${userInput}"\n\n`;
+        if (context.clarification_reason) {
+            prompt += `Context: We asked about "${this.getReasonDescription(context.clarification_reason)}"\n`;
+        }
+        if (context.target_file) {
+            prompt += `Target file: ${context.target_file}\n`;
+        }
+        if (context.original_prompt) {
+            prompt += `Original request: ${context.original_prompt}\n`;
+        }
+        prompt += '\nClassify this response into one of the types.';
+        return prompt;
+    }
+    /**
+     * Parse LLM classification response into ParsedUserResponse
+     *
+     * This is the NORMALIZATION step - ensures stable structure regardless of LLM variation
+     */
+    parseClassificationResponse(llmResponse, rawInput) {
+        try {
+            // Extract JSON from response (LLM might include extra text)
+            const jsonMatch = llmResponse.match(/\{[^}]+\}/);
+            if (!jsonMatch) {
+                return { type: 'unknown', raw_input: rawInput };
+            }
+            const parsed = JSON.parse(jsonMatch[0]);
+            // Validate and normalize type
+            const validTypes = ['overwrite', 'new_name', 'cancel', 'specify_file', 'specify_action', 'unknown'];
+            const type = validTypes.includes(parsed.type)
+                ? parsed.type
+                : 'unknown';
+            return {
+                type,
+                new_file_name: parsed.file_name || undefined,
+                specified_action: parsed.action || undefined,
+                raw_input: rawInput,
+            };
+        }
+        catch {
+            // If JSON parsing fails, return unknown
+            return { type: 'unknown', raw_input: rawInput };
+        }
+    }
+    /**
+     * Generate alternative file name (deterministic, no LLM)
+     */
+    generateAlternativeName(originalFile) {
+        if (!originalFile) {
+            return 'new_file.txt';
+        }
+        const ext = originalFile.includes('.')
+            ? originalFile.substring(originalFile.lastIndexOf('.'))
+            : '';
+        const baseName = originalFile.includes('.')
+            ? originalFile.substring(0, originalFile.lastIndexOf('.'))
+            : originalFile;
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-').substring(0, 19);
+        return `${baseName}_${timestamp}${ext}`;
+    }
+}
+exports.RealLLMMediationLayer = RealLLMMediationLayer;
+//# sourceMappingURL=real-llm-mediation-layer.js.map

package/dist/mediation/real-llm-mediation-layer.js.map

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

package/dist/mediation/verdict-reporter.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Verdict Reporter
+ *
+ * Separates verdicts for different test categories:
+ * - REPL: COMPLETE if core tests pass (no API key required)
+ * - Real LLM: COMPLETE only if:
+ *   1. GATE: OPEN (LLM_TEST_MODE=1 + API key present)
+ *   2. At least one successful LLM evidence exists
+ *   3. Evidence integrity verified
+ *
+ * This ensures honest reporting - Real LLM cannot be marked COMPLETE
+ * without actual API calls being made and verified.
+ */
+export interface VerdictResult {
+    category: 'REPL' | 'REAL_LLM';
+    verdict: 'COMPLETE' | 'INCOMPLETE' | 'SKIPPED';
+    reason: string;
+    details: {
+        gate_status?: 'OPEN' | 'CLOSED';
+        real_calls_made: boolean;
+        evidence_count?: number;
+        evidence_verified?: boolean;
+        skip_reason?: string;
+    };
+}
+export interface CombinedVerdict {
+    repl: VerdictResult;
+    real_llm: VerdictResult;
+    summary: string;
+}
+export interface ExecutionGate {
+    canExecute: boolean;
+    skipReason?: string;
+    provider?: string;
+    envVar?: string;
+}
+/**
+ * Check execution gate for Real LLM tests
+ */
+export declare function checkExecutionGate(): ExecutionGate;
+/**
+ * Generate REPL verdict (based on core test pass rate)
+ */
+export declare function generateREPLVerdict(coreTestsPassed: boolean): VerdictResult;
+/**
+ * Generate Real LLM verdict (requires gate open + evidence)
+ */
+export declare function generateRealLLMVerdict(gate: ExecutionGate, evidenceCount?: number, evidenceVerified?: boolean): VerdictResult;
+/**
+ * Generate combined verdict with formatted output
+ */
+export declare function generateCombinedVerdict(coreTestsPassed: boolean, evidenceCount?: number, evidenceVerified?: boolean): CombinedVerdict;
+/**
+ * Format verdict summary for console output
+ */
+export declare function formatVerdictSummary(repl: VerdictResult, real_llm: VerdictResult): string;
+/**
+ * Print verdict to console
+ */
+export declare function printVerdict(verdict: CombinedVerdict): void;
+//# sourceMappingURL=verdict-reporter.d.ts.map

package/dist/mediation/verdict-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verdict-reporter.d.ts","sourceRoot":"","sources":["../../src/mediation/verdict-reporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,GAAG,UAAU,CAAC;IAC9B,OAAO,EAAE,UAAU,GAAG,YAAY,GAAG,SAAS,CAAC;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE;QACP,WAAW,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;QAChC,eAAe,EAAE,OAAO,CAAC;QACzB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,aAAa,CA2BlD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,eAAe,EAAE,OAAO,GAAG,aAAa,CAW3E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,aAAa,EACnB,aAAa,GAAE,MAAU,EACzB,gBAAgB,GAAE,OAAe,GAChC,aAAa,CA2Df;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,OAAO,EACxB,aAAa,GAAE,MAAU,EACzB,gBAAgB,GAAE,OAAe,GAChC,eAAe,CAUjB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,GAAG,MAAM,CAsCzF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAE3D"}