@yagr/agent 0.2.12 → 0.2.13

package/dist/runtime/run-engine.js

@@ -1,17 +1,20 @@
 import { randomUUID } from 'node:crypto';
-import { generateText, streamText } from 'ai';
+import { generateText, streamText, InvalidToolArgumentsError } from 'ai';
 import { createLanguageModel } from '../llm/create-language-model.js';
-import { resolveModelContextProfile } from '../llm/create-language-model.js';
+import { resolveLanguageModelConfig, resolveModelContextProfile } from '../llm/create-language-model.js';
+import { getProviderPlugin } from '../llm/provider-plugin.js';
 import { buildTools } from '../tools/index.js';
+import { resolveWorkflowOpenLink } from '../gateway/workflow-links.js';
+import { resolveWorkflowDiagramFromFilePath } from '../tools/present-workflow-result.js';
 import { evaluateCompletionGate } from './completion-gate.js';
 import { compactConversationContext } from './context-compaction.js';
 import { analyzeRunOutcome, formatObservedAction } from './outcome.js';
-import { createDefaultRuntimeHooks, wrapToolsWithRuntimeHooks } from './policy-hooks.js';
-import { blockingStateForRequiredActions, collectRequiredActions } from './required-actions.js';
-const INSPECT_MAX_STEPS = 4;
-const EXECUTE_MAX_STEPS = 10;
-const EXECUTE_RECOVERY_MAX_STEPS = 6;
+import { createDefaultRuntimeHooksForStrategy, wrapToolsWithRuntimeHooks } from './policy-hooks.js';
+import { blockingStateForRequiredActions, collectRequiredActions, splitRequiredActions } from './required-actions.js';
+import { resolveToolRuntimeStrategy } from './tool-runtime-strategy.js';
 const MAX_EXECUTION_ATTEMPTS = 3;
+const MAX_COMPLETION_REPAIR_ATTEMPTS = 1;
+const MAX_BLOCKER_CAPTURE_ATTEMPTS = 1;
 const PHASE_ORDER = ['inspect', 'plan', 'edit', 'validate', 'sync', 'verify', 'summarize'];
 const STREAM_FILTER_HOLDBACK = 256;
 /**
@@ -33,11 +36,11 @@ class RepetitiveAssistantOutputError extends Error {
 function isRepetitiveAssistantOutputError(error) {
     return error instanceof RepetitiveAssistantOutputError;
 }
-function providerOptionsForRun(provider) {
-    if (provider === 'openai' || provider === 'groq') {
-        return { openai: { strictSchemas: false } };
-    }
-    return undefined;
+function isSyntheticWriteWorkspaceFileIntent(intent) {
+    return intent.tool === 'writeWorkspaceFile';
+}
+function isSyntheticN8nacIntent(intent) {
+    return intent.tool !== 'writeWorkspaceFile';
 }
 function createAbortError(message = 'Yagr run stopped by user.') {
     const error = new Error(message);
@@ -59,25 +62,184 @@ function throwIfAborted(signal) {
 function wrapInternal(text) {
     return `${INTERNAL_TAG_OPEN}${text}${INTERNAL_TAG_CLOSE}`;
 }
-function createPhasePrompt(phase, userPrompt) {
+function looksLikeRawToolIntentText(text) {
+    const trimmed = text.trim();
+    if (!trimmed.startsWith('{')) {
+        return false;
+    }
+    const blocks = extractJsonObjectBlocks(trimmed);
+    if (blocks.length === 0) {
+        return false;
+    }
+    return blocks.join('') === trimmed && blocks.every((block) => {
+        try {
+            const parsed = JSON.parse(block);
+            return typeof parsed.action === 'string' || parsed.tool === 'writeWorkspaceFile';
+        }
+        catch {
+            return false;
+        }
+    });
+}
+function extractJsonObjectBlocks(text) {
+    const blocks = [];
+    let depth = 0;
+    let inString = false;
+    let escaping = false;
+    let start = -1;
+    for (let index = 0; index < text.length; index += 1) {
+        const character = text[index];
+        if (escaping) {
+            escaping = false;
+            continue;
+        }
+        if (character === '\\') {
+            escaping = true;
+            continue;
+        }
+        if (character === '"') {
+            inString = !inString;
+            continue;
+        }
+        if (inString) {
+            continue;
+        }
+        if (character === '{') {
+            if (depth === 0) {
+                start = index;
+            }
+            depth += 1;
+            continue;
+        }
+        if (character === '}') {
+            depth -= 1;
+            if (depth === 0 && start >= 0) {
+                blocks.push(text.slice(start, index + 1));
+                start = -1;
+            }
+        }
+    }
+    return blocks;
+}
+function parseSyntheticToolIntents(text) {
+    const intents = [];
+    for (const block of extractJsonObjectBlocks(text)) {
+        try {
+            const parsed = JSON.parse(block);
+            if (parsed.tool === 'writeWorkspaceFile') {
+                if (typeof parsed.path !== 'string' || typeof parsed.content !== 'string') {
+                    continue;
+                }
+                intents.push({
+                    tool: 'writeWorkspaceFile',
+                    path: parsed.path,
+                    content: parsed.content,
+                    mode: parsed.mode === 'create' || parsed.mode === 'append' ? parsed.mode : 'overwrite',
+                });
+                continue;
+            }
+            if (typeof parsed.action !== 'string') {
+                continue;
+            }
+            intents.push({
+                tool: typeof parsed.tool === 'string' ? parsed.tool : 'n8nac',
+                action: parsed.action,
+                filename: typeof parsed.filename === 'string' ? parsed.filename : undefined,
+                validateFile: typeof parsed.validateFile === 'string' ? parsed.validateFile : undefined,
+                workflowId: typeof parsed.workflowId === 'string' ? parsed.workflowId : undefined,
+                listScope: typeof parsed.listScope === 'string' ? parsed.listScope : undefined,
+                n8nHost: typeof parsed.n8nHost === 'string' ? parsed.n8nHost : undefined,
+                n8nApiKey: typeof parsed.n8nApiKey === 'string' || parsed.n8nApiKey === null ? parsed.n8nApiKey : undefined,
+                projectId: typeof parsed.projectId === 'string' || parsed.projectId === null ? parsed.projectId : undefined,
+                projectName: typeof parsed.projectName === 'string' || parsed.projectName === null ? parsed.projectName : undefined,
+                projectIndex: typeof parsed.projectIndex === 'number' ? parsed.projectIndex : undefined,
+                skillsArgs: typeof parsed.skillsArgs === 'string' || parsed.skillsArgs === null ? parsed.skillsArgs : undefined,
+                skillsArgv: Array.isArray(parsed.skillsArgv) ? parsed.skillsArgv.filter((value) => typeof value === 'string') : undefined,
+                syncFolder: typeof parsed.syncFolder === 'string' || parsed.syncFolder === null ? parsed.syncFolder : undefined,
+                resolveMode: typeof parsed.resolveMode === 'string' || parsed.resolveMode === null ? parsed.resolveMode : undefined,
+            });
+        }
+        catch {
+            continue;
+        }
+    }
+    return intents;
+}
+async function maybeExecuteSyntheticToolIntents(state, options, strategy, tools, phaseResult) {
+    if (!['weak', 'none'].includes(strategy.capabilityProfile.toolCalling)) {
+        return false;
+    }
+    if (phaseResult.toolCalls.length > 0) {
+        return false;
+    }
+    const intents = parseSyntheticToolIntents(phaseResult.text)
+        .filter((intent) => (isSyntheticWriteWorkspaceFileIntent(intent)
+        || (isSyntheticN8nacIntent(intent) && ['validate', 'push', 'verify'].includes(intent.action))))
+        .slice(0, strategy.capabilityProfile.toolCalling === 'none' ? 4 : 3);
+    if (intents.length === 0) {
+        return false;
+    }
+    for (const intent of intents) {
+        if (isSyntheticWriteWorkspaceFileIntent(intent)) {
+            const writeTool = tools.writeWorkspaceFile;
+            const args = {
+                path: intent.path,
+                content: intent.content,
+                mode: intent.mode ?? 'overwrite',
+            };
+            const result = await writeTool.execute(args, undefined);
+            await recordStep(state, options, {
+                stepType: 'tool-result',
+                finishReason: 'tool-calls',
+                toolCalls: [{ toolName: 'writeWorkspaceFile', args }],
+                toolResults: [{ toolName: 'writeWorkspaceFile', result }],
+                text: '',
+            });
+            continue;
+        }
+        if (!isSyntheticN8nacIntent(intent)) {
+            continue;
+        }
+        const args = {
+            ...intent,
+            validateFile: intent.validateFile || (intent.action === 'validate' ? intent.filename : undefined),
+        };
+        const n8nacTool = tools.n8nac;
+        const result = await n8nacTool.execute(args, undefined);
+        await recordStep(state, options, {
+            stepType: 'tool-result',
+            finishReason: 'tool-calls',
+            toolCalls: [{ toolName: 'n8nac', args }],
+            toolResults: [{ toolName: 'n8nac', result }],
+            text: '',
+        });
+    }
+    return true;
+}
+function createPhasePrompt(phase, userPrompt, strategy) {
+    const toolUseInstruction = strategy.tooling.toolCallMode === 'disabled'
+        ? 'Do not call tools in this phase. Reason from the current context only.'
+        : 'Use tools to inspect the workspace, existing workflow files, examples, and n8nac workspace status when needed.';
     if (phase === 'inspect') {
         return wrapInternal([
             'Yagr internal phase: inspect.',
             'Analyze the request and gather only the context needed to execute it correctly.',
-            'Use tools to inspect the workspace, existing workflow files, examples, and n8nac workspace status when needed.',
+            toolUseInstruction,
             'Do not reread the workspace AGENT.md or AGENTS.md file during inspect unless a specific later detail is missing from the current context.',
             'Favor correctness over speed in this phase. If an example or rule is likely to determine the right implementation, read it before acting.',
             'Do not claim completion in this phase.',
+            ...strategy.inspectDirectives,
             `Original request: ${userPrompt}`,
         ].join('\n'));
     }
-    return wrapInternal([
-        'Yagr internal phase: execute.',
-        'Complete the task end-to-end using the gathered context.',
-        'When appropriate, author or edit workflow files, validate them, sync them, verify them, and then summarize what changed.',
+    return [
+        'Complete the following task end-to-end.',
+        'Author or edit workflow files, validate them, push them to n8n, and verify the deployment.',
+        'You must call at least one tool to make progress — do not respond with text alone.',
         'Ask the user only when a specific missing value blocks execution.',
-        `Original request: ${userPrompt}`,
-    ].join('\n'));
+        ...strategy.executeDirectives,
+        `Task: ${userPrompt}`,
+    ].join('\n');
 }
 function trimAssistantVisibleText(text, maxChars = 12_000) {
     return text.length <= maxChars ? text : text.slice(-maxChars);
@@ -265,46 +427,306 @@ function collectToolNames(journal) {
     }
     return [...names].map((toolName) => ({ toolName }));
 }
-function buildGroundedSummary(_prompt, finishReason, journal, requiredActions) {
+function hasObservedToolCall(journal, toolNames) {
+    const wanted = new Set(toolNames);
+    for (const entry of journal) {
+        if (entry.type !== 'step' || !entry.step) {
+            continue;
+        }
+        if (entry.step.toolCalls.some((toolCall) => wanted.has(toolCall.toolName))) {
+            return true;
+        }
+    }
+    return false;
+}
+function collectPresentedWorkflow(result) {
+    if (!result || typeof result !== 'object') {
+        return undefined;
+    }
+    const record = result;
+    const workflowId = typeof record.workflowId === 'string' ? record.workflowId : undefined;
+    const workflowUrl = typeof record.workflowUrl === 'string' ? record.workflowUrl : undefined;
+    const title = typeof record.title === 'string' ? record.title : undefined;
+    if (!workflowId && !workflowUrl && !title) {
+        return undefined;
+    }
+    return { workflowId, workflowUrl, title };
+}
+function collectWorkflowPresentationFromOutcome(outcome) {
+    const workflowId = outcome.successfulVerify?.workflowId ?? outcome.successfulPush?.workflowId;
+    const workflowUrl = outcome.successfulVerify?.workflowUrl ?? outcome.successfulPush?.workflowUrl;
+    const title = outcome.successfulVerify?.title ?? outcome.successfulPush?.title;
+    if (!workflowId && !workflowUrl && !title) {
+        return undefined;
+    }
+    return { workflowId, workflowUrl, title };
+}
+function extractWorkflowLabel(outcome, journal) {
+    const successfulPushTarget = outcome.successfulPush?.filename;
+    const workflowFilePath = successfulPushTarget
+        || outcome.writtenFiles.find((filePath) => filePath.endsWith('.workflow.ts'))
+        || outcome.updatedFiles.find((filePath) => filePath.endsWith('.workflow.ts'));
+    if (!workflowFilePath) {
+        return undefined;
+    }
+    const baseName = workflowFilePath.split('/').pop() ?? workflowFilePath;
+    return baseName.replace(/\.workflow\.ts$/i, '');
+}
+function extractPresentedWorkflowFromJournal(journal) {
+    for (let index = journal.length - 1; index >= 0; index -= 1) {
+        const entry = journal[index];
+        if (entry.type !== 'step' || !entry.step) {
+            continue;
+        }
+        for (let toolIndex = entry.step.toolCalls.length - 1; toolIndex >= 0; toolIndex -= 1) {
+            if (entry.step.toolCalls[toolIndex]?.toolName !== 'presentWorkflowResult') {
+                continue;
+            }
+            const presented = collectPresentedWorkflow(entry.step.toolResults[toolIndex]?.result);
+            if (presented) {
+                return presented;
+            }
+        }
+    }
+    return undefined;
+}
+async function maybeEmitSyntheticWorkflowEmbed(outcome, journal, onToolEvent) {
+    if (!onToolEvent) {
+        return;
+    }
+    const presentedWorkflow = extractPresentedWorkflowFromJournal(journal);
+    if (presentedWorkflow?.workflowUrl) {
+        return;
+    }
+    const fallbackWorkflow = collectWorkflowPresentationFromOutcome(outcome);
+    if (!fallbackWorkflow?.workflowId || !fallbackWorkflow.workflowUrl) {
+        return;
+    }
+    const workflowLink = resolveWorkflowOpenLink(fallbackWorkflow.workflowUrl);
+    const pushTarget = outcome.successfulPush?.filename;
+    const diagram = (pushTarget ? resolveWorkflowDiagramFromFilePath(pushTarget) : undefined)
+        || [
+            '<workflow-map>',
+            `// Workflow : ${fallbackWorkflow.title || fallbackWorkflow.workflowId || 'Workflow'}`,
+            '// ROUTING MAP',
+            '// Diagram unavailable in source; link card synthesized from successful push/verify facts.',
+            '</workflow-map>',
+        ].join('\n');
+    await onToolEvent({
+        type: 'embed',
+        toolName: 'presentWorkflowResult',
+        kind: 'workflow',
+        workflowId: fallbackWorkflow.workflowId,
+        url: workflowLink.openUrl,
+        targetUrl: workflowLink.targetUrl,
+        title: fallbackWorkflow.title,
+        diagram,
+    });
+}
+export function buildGroundedSummary(_prompt, finishReason, journal, requiredActions) {
     const lines = [];
     const outcome = analyzeRunOutcome(journal);
-    if (outcome.writtenFiles.length > 0) {
-        lines.push(`Fichiers crees ou reecrits: ${outcome.writtenFiles.join(', ')}`);
+    const { blocking: blockingRequiredActions, followUp: followUpRequiredActions } = splitRequiredActions(requiredActions);
+    const workflowLabel = extractWorkflowLabel(outcome, journal);
+    const presentedWorkflow = extractPresentedWorkflowFromJournal(journal) ?? collectWorkflowPresentationFromOutcome(outcome);
+    const presentedWorkflowUrl = presentedWorkflow?.workflowUrl;
+    if (outcome.hasWorkflowWrites && outcome.successfulPush) {
+        const workflowName = presentedWorkflow?.title || workflowLabel || 'the workflow';
+        const completionBits = [
+            `The workflow ${workflowName === 'the workflow' ? workflowName : `\`${workflowName}\``} is ready`,
+            outcome.successfulValidate ? 'validated' : undefined,
+            outcome.successfulPush ? 'pushed to n8n' : undefined,
+            outcome.successfulVerify ? 'verified' : undefined,
+        ].filter(Boolean);
+        if (completionBits.length > 0) {
+            lines.push(`${completionBits.join(', ')}.`);
+        }
+        if (presentedWorkflowUrl) {
+            lines.push(`Workflow link: ${presentedWorkflowUrl}`);
+        }
     }
-    if (outcome.updatedFiles.length > 0) {
-        lines.push(`Fichiers modifies: ${outcome.updatedFiles.join(', ')}`);
+    if (lines.length === 0 && presentedWorkflowUrl) {
+        const workflowName = presentedWorkflow.title || workflowLabel || 'the workflow';
+        lines.push(workflowName === 'the workflow'
+            ? 'The workflow is ready.'
+            : `The workflow \`${workflowName}\` is ready.`);
+        lines.push(`Workflow link: ${presentedWorkflowUrl}`);
     }
-    if (outcome.successfulActions.length > 0) {
-        lines.push(`Actions n8nac reussies: ${outcome.successfulActions.map(formatObservedAction).join(', ')}`);
+    else if (lines.length === 0 && presentedWorkflow?.title) {
+        lines.push(`The workflow \`${presentedWorkflow.title}\` is ready.`);
     }
-    if (outcome.unresolvedFailedActions.length > 0) {
-        lines.push(`Actions n8nac en echec: ${outcome.unresolvedFailedActions.map(formatObservedAction).join(', ')}`);
+    if (lines.length > 0 && presentedWorkflowUrl && !lines.some((line) => line.includes(presentedWorkflowUrl))) {
+        lines.push(`Workflow link: ${presentedWorkflowUrl}`);
     }
-    if (requiredActions.length > 0) {
-        lines.push(`Actions requises en attente: ${requiredActions.map((action) => `${action.title} [${action.kind}]`).join(', ')}`);
+    if (lines.length === 0 && outcome.writtenFiles.length > 0) {
+        lines.push('The task changed local files, but the final result is not fully confirmed yet.');
+    }
+    if (lines.length === 0 && outcome.updatedFiles.length > 0) {
+        lines.push('The task updated local files, but the final result is not fully confirmed yet.');
+    }
+    if (outcome.blockingUnresolvedFailedActions.length > 0) {
+        lines.push('The run stopped because some execution steps still need correction.');
+    }
+    if (blockingRequiredActions.length > 0 && !(outcome.successfulPush && outcome.successfulVerify)) {
+        lines.push(`Pending required actions: ${blockingRequiredActions.map((action) => action.title).join(', ')}`);
+    }
+    if (followUpRequiredActions.length > 0 && (outcome.successfulPush || outcome.successfulVerify || presentedWorkflowUrl)) {
+        lines.push(`Next steps: ${followUpRequiredActions.map((action) => action.title).join(', ')}`);
     }
     if (outcome.hasWorkflowWrites && !outcome.successfulValidate) {
-        lines.push('La validation du workflow n’a pas ete confirmee.');
+        lines.push('Workflow validation was not confirmed.');
     }
     if (outcome.hasWorkflowWrites && !outcome.successfulPush) {
-        lines.push('Le push vers n8n n’a pas ete confirme.');
+        lines.push('Push to n8n was not confirmed.');
     }
     if (outcome.hasWorkflowWrites && !outcome.successfulVerify) {
-        lines.push('La verification distante n’a pas ete confirmee.');
+        lines.push('Remote verification was not confirmed.');
+    }
+    if (outcome.hasWorkflowWrites && outcome.blockingUnresolvedFailedActions.length > 0) {
+        lines.push('The run stopped while some actions were still failing. More fixes are needed or an external blocker is still present.');
+    }
+    if (lines.length === 0 && finishReason !== 'stop') {
+        lines.push(`The run ended with reason: ${finishReason}.`);
+    }
+    if (lines.length === 0) {
+        lines.push('The task did not reach a grounded terminal result yet.');
+    }
+    return lines.join('\n');
+}
+export function shouldForceGroundedFinalAnswer(journal, requiredActions = []) {
+    const outcome = analyzeRunOutcome(journal);
+    const presentedWorkflow = extractPresentedWorkflowFromJournal(journal) ?? collectWorkflowPresentationFromOutcome(outcome);
+    const { blocking: blockingRequiredActions, followUp: followUpRequiredActions } = splitRequiredActions(requiredActions);
+    if (blockingRequiredActions.length > 0) {
+        return true;
+    }
+    if (presentedWorkflow?.workflowUrl) {
+        return true;
+    }
+    if (followUpRequiredActions.length > 0) {
+        return true;
+    }
+    return Boolean(outcome.hasWorkflowWrites && (outcome.successfulPush || outcome.successfulVerify));
+}
+export function finalAnswerSatisfiesGroundedWorkflowFacts(text, journal) {
+    const normalizedText = sanitizeAssistantOutput(text);
+    if (!normalizedText) {
+        return false;
+    }
+    const outcome = analyzeRunOutcome(journal);
+    const presentedWorkflow = extractPresentedWorkflowFromJournal(journal) ?? collectWorkflowPresentationFromOutcome(outcome);
+    if (presentedWorkflow?.workflowUrl && !normalizedText.includes(presentedWorkflow.workflowUrl)) {
+        return false;
+    }
+    return true;
+}
+function buildFinalAnswerFacts(finishReason, journal, requiredActions) {
+    const outcome = analyzeRunOutcome(journal);
+    const { blocking: blockingRequiredActions, followUp: followUpRequiredActions } = splitRequiredActions(requiredActions);
+    const workflowLabel = extractWorkflowLabel(outcome, journal);
+    const presentedWorkflow = extractPresentedWorkflowFromJournal(journal) ?? collectWorkflowPresentationFromOutcome(outcome);
+    const lines = [];
+    lines.push(`finish_reason=${finishReason}`);
+    lines.push(`workflow_writes=${outcome.hasWorkflowWrites ? 'yes' : 'no'}`);
+    lines.push(`validate_confirmed=${outcome.successfulValidate ? 'yes' : 'no'}`);
+    lines.push(`push_confirmed=${outcome.successfulPush ? 'yes' : 'no'}`);
+    lines.push(`verify_confirmed=${outcome.successfulVerify ? 'yes' : 'no'}`);
+    if (workflowLabel) {
+        lines.push(`workflow_label=${workflowLabel}`);
+    }
+    if (presentedWorkflow?.title) {
+        lines.push(`workflow_title=${presentedWorkflow.title}`);
+    }
+    if (presentedWorkflow?.workflowUrl) {
+        lines.push(`workflow_url=${presentedWorkflow.workflowUrl}`);
+    }
+    if (outcome.writtenFiles.length > 0) {
+        lines.push(`written_files=${outcome.writtenFiles.join(', ')}`);
+    }
+    if (outcome.updatedFiles.length > 0) {
+        lines.push(`updated_files=${outcome.updatedFiles.join(', ')}`);
+    }
+    if (outcome.successfulActions.length > 0) {
+        lines.push(`successful_actions=${outcome.successfulActions.map(formatObservedAction).join(', ')}`);
     }
-    if (outcome.hasWorkflowWrites && outcome.unresolvedFailedActions.length > 0) {
-        lines.push('Le run s’est arrete alors que certaines actions avaient encore echoue. Une correction supplementaire reste necessaire ou un bloqueur externe persiste.');
+    if (outcome.blockingUnresolvedFailedActions.length > 0) {
+        lines.push(`blocking_failed_actions=${outcome.blockingUnresolvedFailedActions.map(formatObservedAction).join(', ')}`);
     }
-    if (finishReason !== 'stop') {
-        lines.push(`Le run s’est termine avec la raison: ${finishReason}.`);
+    if (blockingRequiredActions.length > 0) {
+        lines.push(`blocking_required_actions=${blockingRequiredActions.map((action) => `${action.title} [${action.kind}]`).join(', ')}`);
+    }
+    if (followUpRequiredActions.length > 0) {
+        lines.push(`follow_up_actions=${followUpRequiredActions.map((action) => `${action.title} [${action.kind}]`).join(', ')}`);
     }
     return lines.join('\n');
 }
-function ensureFinalText(prompt, finishReason, journal, existingText, requiredActions, completionAccepted) {
+function buildCompletionRepairPrompt() {
+    return wrapInternal([
+        'Yagr internal completion repair pass.',
+        'The previous attempt ended without a concrete result or a structured blocker.',
+        'Do not apologize and do not summarize a failure yet.',
+        'Continue working until you either produce a real result or raise requestRequiredAction for the missing user input, permission, or external dependency that blocks progress.',
+        'Do not treat follow-up runtime configuration or post-deploy setup as a blocking reason to stop if you can still build, validate, save, or deploy the current artifact.',
+        'If the artifact can be delivered now but still needs later setup, prefer delivering it and raise requestRequiredAction with blocking=false for the next step.',
+        'A plain-text statement that the task could not be completed is not an acceptable stopping point.',
+    ].join(' '));
+}
+function buildBlockerCapturePrompt() {
+    return wrapInternal([
+        'Yagr internal blocker capture pass.',
+        'The run still has no concrete result and no structured blocker.',
+        'If progress is blocked on missing user input, permission, or an external dependency, call requestRequiredAction now.',
+        'Do not answer with plain prose. Emit only the required action through the tool.',
+    ].join(' '));
+}
+async function ensureFinalText(prompt, finishReason, journal, existingText, requiredActions, completionAccepted, options, strategy) {
     const sanitizedText = sanitizeAssistantOutput(existingText);
-    if (completionAccepted && sanitizedText) {
+    const forceGroundedFinalAnswer = shouldForceGroundedFinalAnswer(journal, requiredActions);
+    if (completionAccepted && !forceGroundedFinalAnswer && sanitizedText && !looksLikeRawToolIntentText(sanitizedText)) {
         return sanitizedText;
     }
+    const finalAnswerFacts = buildFinalAnswerFacts(finishReason, journal, requiredActions);
+    try {
+        const result = await generateText({
+            abortSignal: options.abortSignal,
+            model: createLanguageModel(options),
+            system: [
+                'You are writing the final answer to the user after an agent run.',
+                'Use only the grounded facts you are given.',
+                'Do not restate requested features, plans, or design goals as if they were implemented unless the grounded facts explicitly confirm them.',
+                'Do not mention internal prompts, phases, journals, or tool names such as n8nac, list, skills, validate, push, or verify unless the user explicitly asked for internals.',
+                'If the workflow is ready, say so briefly and include the workflow URL if it is useful.',
+                'If follow-up setup is still needed after delivery, present it briefly as a next step rather than as a blocker.',
+                'Do not describe UI elements, cards, banners, embeds, diagrams, or presentation widgets.',
+                'If the task is not complete, explain the real blocker briefly and concretely.',
+                'Never invent success. Never mention unsupported details.',
+                'Keep the answer concise and user-facing.',
+            ].join('\n'),
+            messages: [
+                {
+                    role: 'user',
+                    content: [
+                        `Original user request (context only, not proof of completion):\n${prompt}`,
+                        '',
+                        `Grounded run facts:\n${finalAnswerFacts}`,
+                        '',
+                        'Write the final user-facing answer now using only the grounded run facts.',
+                    ].join('\n'),
+                },
+            ],
+            maxSteps: 1,
+            providerOptions: strategy.providerOptions,
+        });
+        const finalText = sanitizeAssistantOutput(result.text);
+        if (finalText
+            && !looksLikeRawToolIntentText(finalText)
+            && finalAnswerSatisfiesGroundedWorkflowFacts(finalText, journal)) {
+            return finalText;
+        }
+    }
+    catch {
+        // Fall through to the last-resort grounded summary.
+    }
     return buildGroundedSummary(prompt, finishReason, journal, requiredActions)
         || 'Run stopped before producing a grounded result.';
 }
@@ -394,7 +816,7 @@ function shouldAttemptRecovery(outcome, attemptNumber, requiredActions) {
     if (requiredActions.length > 0) {
         return false;
     }
-    if (outcome.unresolvedFailedActions.length > 0) {
+    if (outcome.blockingUnresolvedFailedActions.length > 0) {
         return true;
     }
     if (outcome.hasWorkflowWrites && (!outcome.successfulValidate || !outcome.successfulPush)) {
@@ -412,11 +834,25 @@ function buildRecoveryPrompt(outcome, attemptNumber) {
         missingChecks.push('push');
     }
     if (outcome.hasWorkflowWrites && !outcome.successfulVerify) {
-        missingChecks.push('verification distante');
+        missingChecks.push('remote verification');
+    }
+    // When the workflow file was already written but deployment steps are still
+    // missing and there are no failed actions, give a plain direct instruction
+    // instead of a confusing "inspect failing tool output" message.  Some models
+    // (e.g. Gemini) do not respond to internal-tagged prompts in recovery passes
+    // when no concrete error is present.
+    if (outcome.hasWorkflowWrites && missingChecks.length > 0 && !failedActions) {
+        const writtenFile = outcome.writtenFiles.find((f) => f.endsWith('.workflow.ts')) ?? outcome.writtenFiles[0];
+        const fileNote = writtenFile ? ` (${writtenFile})` : '';
+        return [
+            `The workflow file${fileNote} was written successfully.`,
+            `The following deployment steps are still needed: ${missingChecks.join(', ')}.`,
+            'Use the n8nac tool to complete them now. Do not stop until push succeeds.',
+        ].join(' ');
     }
     const issues = [
-        failedActions ? `Actions en echec: ${failedActions}.` : '',
-        missingChecks.length > 0 ? `Etapes non confirmees: ${missingChecks.join(', ')}.` : '',
+        failedActions ? `Failed actions: ${failedActions}.` : '',
+        missingChecks.length > 0 ? `Unconfirmed steps: ${missingChecks.join(', ')}.` : '',
     ].filter(Boolean).join(' ');
     return wrapInternal([
         `Yagr internal recovery pass ${attemptNumber}.`,
@@ -426,17 +862,63 @@ function buildRecoveryPrompt(outcome, attemptNumber) {
         'Only stop if a genuine blocker remains that cannot be resolved locally in this run.',
     ].join(' '));
 }
-async function executePhase(state, options, systemPrompt, tools, messages, maxSteps) {
+/**
+ * Attempt to repair a malformed tool call where the model emitted an unquoted string value.
+ * This primarily handles `writeWorkspaceFile` when a model writes raw TypeScript code as the
+ * `content` field without JSON-string-encoding it. The closing `}` of the JSON object is always
+ * the last character in the args string, so `lastIndexOf('}')` reliably isolates it.
+ *
+ * Returns a corrected JSON args string, or `null` if the pattern is not recognised.
+ */
+function tryRepairToolArgs(toolName, rawArgs) {
+    if (toolName !== 'writeWorkspaceFile')
+        return null;
+    const pathMatch = /"path"\s*:\s*"((?:[^"\\]|\\.)*)"/.exec(rawArgs);
+    if (!pathMatch)
+        return null;
+    const path = pathMatch[1];
+    const modeMatch = /"mode"\s*:\s*"(create|overwrite|append)"/.exec(rawArgs);
+    const mode = modeMatch?.[1] ?? 'overwrite';
+    const contentKeyIdx = rawArgs.indexOf('"content"');
+    if (contentKeyIdx === -1)
+        return null;
+    const colonIdx = rawArgs.indexOf(':', contentKeyIdx + 9);
+    if (colonIdx === -1)
+        return null;
+    let valueStart = colonIdx + 1;
+    while (valueStart < rawArgs.length && /[ \t]/.test(rawArgs[valueStart]))
+        valueStart++;
+    // If content is already a quoted JSON string the parse failure is a different issue
+    if (rawArgs[valueStart] === '"')
+        return null;
+    // The very last '}' in the string is the JSON object closing brace
+    const lastBrace = rawArgs.lastIndexOf('}');
+    if (lastBrace <= valueStart)
+        return null;
+    let rawContent = rawArgs.slice(valueStart, lastBrace);
+    // Strip a trailing mode field that the model may have appended after the raw content
+    rawContent = rawContent.replace(/,\s*"mode"\s*:\s*"(?:create|overwrite|append)"\s*$/, '').trim();
+    return JSON.stringify({ path, content: rawContent, mode });
+}
+async function executePhase(state, options, strategy, systemPrompt, tools, messages, maxSteps) {
     throwIfAborted(options.abortSignal);
-    if (options.provider === 'mistral' || options.provider === 'copilot-proxy' || options.provider === 'openai-proxy') {
+    const modelInvocationTools = strategy.tooling.toolCallMode === 'disabled' ? undefined : tools;
+    const repairToolCall = async ({ toolCall, error }) => {
+        if (!InvalidToolArgumentsError.isInstance(error))
+            return null;
+        const repairedArgs = tryRepairToolArgs(toolCall.toolName, toolCall.args);
+        return repairedArgs !== null ? { ...toolCall, args: repairedArgs } : null;
+    };
+    if (strategy.executionMode === 'generate') {
         const result = await generateText({
             abortSignal: options.abortSignal,
             model: createLanguageModel(options),
             system: systemPrompt,
-            tools,
+            ...(modelInvocationTools ? { tools: modelInvocationTools } : {}),
             messages,
             maxSteps,
-            providerOptions: providerOptionsForRun(options.provider),
+            providerOptions: strategy.providerOptions,
+            experimental_repairToolCall: repairToolCall,
         });
         for (const step of result.steps) {
             await recordStep(state, options, {
@@ -454,9 +936,6 @@ async function executePhase(state, options, systemPrompt, tools, messages, maxSt
             });
         }
         const finalText = sanitizeAssistantOutput(result.text);
-        if (finalText) {
-            await options.onTextDelta?.(finalText);
-        }
         return {
             text: finalText,
             finishReason: String(result.finishReason),
@@ -471,11 +950,12 @@ async function executePhase(state, options, systemPrompt, tools, messages, maxSt
         abortSignal: options.abortSignal,
         model: createLanguageModel(options),
         system: systemPrompt,
-        tools,
+        ...(modelInvocationTools ? { tools: modelInvocationTools } : {}),
         messages,
         maxSteps,
-        toolCallStreaming: shouldUseToolCallStreaming(options.provider),
-        providerOptions: providerOptionsForRun(options.provider),
+        toolCallStreaming: strategy.toolCallStreaming,
+        providerOptions: strategy.providerOptions,
+        experimental_repairToolCall: repairToolCall,
         onStepFinish: async (stepResult) => {
             recordedSteps += 1;
             for (const toolCall of stepResult.toolCalls) {
@@ -524,9 +1004,6 @@ async function executePhase(state, options, systemPrompt, tools, messages, maxSt
         result.toolCalls,
     ]);
     const finalText = sanitizeAssistantOutput(resolved[0]);
-    if (finalText) {
-        await options.onTextDelta?.(finalText);
-    }
     return {
         text: finalText,
         finishReason: String(resolved[1]),
@@ -535,12 +1012,6 @@ async function executePhase(state, options, systemPrompt, tools, messages, maxSt
         responseMessages: response.messages,
     };
 }
-function shouldUseToolCallStreaming(provider) {
-    if (provider === 'mistral') {
-        return false;
-    }
-    return true;
-}
 async function transitionPhase(state, options, phase, status, message) {
     if (status === 'started') {
         state.currentPhase = phase;
@@ -609,15 +1080,25 @@ export class YagrRunEngine {
             role: 'user',
             content: prompt,
         };
-        const runtimeHooks = [...createDefaultRuntimeHooks(), ...(options.runtimeHooks ?? [])];
+        const resolvedModelConfig = resolveLanguageModelConfig(options);
+        await getProviderPlugin(resolvedModelConfig.provider).metadata?.primeModelMetadata?.({
+            model: resolvedModelConfig.model,
+            apiKey: resolvedModelConfig.apiKey,
+            baseUrl: resolvedModelConfig.baseUrl,
+        });
+        const runtimeStrategy = resolveToolRuntimeStrategy(resolvedModelConfig.provider, resolvedModelConfig.model);
+        const runtimeHooks = [...createDefaultRuntimeHooksForStrategy(runtimeStrategy), ...(options.runtimeHooks ?? [])];
         const baseTools = buildTools(this.engine, {
             onToolEvent: withRuntimeToolEvents(state, options),
+        }, {
+            allowedToolNames: runtimeStrategy.tooling.availableToolNames,
         });
         const tools = wrapToolsWithRuntimeHooks(baseTools, runtimeHooks, () => ({
             runId: state.runId,
             phase: state.currentPhase,
             state: state.currentAgentState,
         }), options.satisfiedRequiredActionIds);
+        const modelInvocationTools = runtimeStrategy.tooling.toolCallMode === 'disabled' ? undefined : tools;
         const persistedMessages = [currentUserMessage];
         let executionContext = [...this.history, currentUserMessage];
         await emitJournal(state, options, {
@@ -633,16 +1114,22 @@ export class YagrRunEngine {
             executionContext = await maybeCompactMessages(state, options, this.systemPrompt, prompt, executionContext);
             const inspectInstruction = {
                 role: 'user',
-                content: createPhasePrompt('inspect', prompt),
+                content: createPhasePrompt('inspect', prompt, runtimeStrategy),
             };
             const inspectResult = await generateText({
                 abortSignal: options.abortSignal,
                 model: createLanguageModel(options),
                 system: this.systemPrompt,
-                tools,
+                ...(modelInvocationTools ? { tools: modelInvocationTools } : {}),
                 messages: [...executionContext, inspectInstruction],
-                maxSteps: Math.min(options.maxSteps ?? 8, INSPECT_MAX_STEPS),
-                providerOptions: providerOptionsForRun(options.provider),
+                maxSteps: Math.min(options.maxSteps ?? 8, runtimeStrategy.inspectMaxSteps),
+                providerOptions: runtimeStrategy.providerOptions,
+                experimental_repairToolCall: async ({ toolCall, error }) => {
+                    if (!InvalidToolArgumentsError.isInstance(error))
+                        return null;
+                    const repairedArgs = tryRepairToolArgs(toolCall.toolName, toolCall.args);
+                    return repairedArgs !== null ? { ...toolCall, args: repairedArgs } : null;
+                },
             });
             for (const step of inspectResult.steps) {
                 await recordStep(state, options, {
@@ -662,34 +1149,47 @@ export class YagrRunEngine {
             if (state.currentPhase === 'inspect') {
                 await transitionPhase(state, options, 'inspect', 'completed', 'Inspection completed.');
             }
+            // Save base context before adding inspect history.  The execute phase
+            // starts from this clean base to avoid context-length issues that cause
+            // some models (notably Gemini) to return empty completions when faced
+            // with accumulated inspect tool-result messages.
+            const executeBaseContext = [...executionContext];
             executionContext.push(...sanitizeAssistantResponseMessages(inspectResult.response.messages));
             throwIfAborted(options.abortSignal);
-            await transitionPhase(state, options, 'plan', 'started', 'Preparing execution plan.');
-            await transitionPhase(state, options, 'plan', 'completed', 'Execution plan ready.');
+            if (getPhaseIndex(state.currentPhase) <= getPhaseIndex('plan')) {
+                await transitionPhase(state, options, 'plan', 'started', 'Preparing execution plan.');
+                await transitionPhase(state, options, 'plan', 'completed', 'Execution plan ready.');
+            }
             const executeInstruction = {
                 role: 'user',
-                content: createPhasePrompt('execute', prompt),
+                content: createPhasePrompt('execute', prompt, runtimeStrategy),
             };
-            let executeMessages = [...executionContext, executeInstruction];
+            let executeMessages = [...executeBaseContext, executeInstruction];
             let text = '';
             let finishReason = 'stop';
             let steps = 0;
             let toolCalls = [];
             let responseMessages = [];
+            let lastExecutionResponseMessages = [];
+            let blockerCaptureAttempts = 0;
             for (let attemptNumber = 1; attemptNumber <= MAX_EXECUTION_ATTEMPTS; attemptNumber += 1) {
                 throwIfAborted(options.abortSignal);
                 executeMessages = await maybeCompactMessages(state, options, this.systemPrompt, prompt, executeMessages);
-                const phaseResult = await executePhase(state, options, this.systemPrompt, tools, executeMessages, attemptNumber === 1 ? (options.maxSteps ?? EXECUTE_MAX_STEPS) : Math.min(options.maxSteps ?? EXECUTE_MAX_STEPS, EXECUTE_RECOVERY_MAX_STEPS));
+                const phaseResult = await executePhase(state, options, runtimeStrategy, this.systemPrompt, tools, executeMessages, attemptNumber === 1
+                    ? (options.maxSteps ?? runtimeStrategy.executeMaxSteps)
+                    : Math.min(options.maxSteps ?? runtimeStrategy.executeMaxSteps, runtimeStrategy.recoveryMaxSteps));
                 if (phaseResult.text) {
                     text = phaseResult.text;
                 }
                 finishReason = phaseResult.finishReason;
                 steps += phaseResult.steps;
                 toolCalls = phaseResult.toolCalls;
-                responseMessages = [...responseMessages, ...sanitizeAssistantResponseMessages(phaseResult.responseMessages)];
+                lastExecutionResponseMessages = sanitizeAssistantResponseMessages(phaseResult.responseMessages);
+                responseMessages = [...responseMessages, ...lastExecutionResponseMessages];
+                const executedSyntheticIntents = await maybeExecuteSyntheticToolIntents(state, options, runtimeStrategy, tools, phaseResult);
                 const outcome = analyzeRunOutcome(state.journal);
                 const requiredActions = collectRequiredActions(state.journal);
-                if (!shouldAttemptRecovery(outcome, attemptNumber, requiredActions)) {
+                if (!shouldAttemptRecovery(outcome, attemptNumber, requiredActions) || executedSyntheticIntents) {
                     break;
                 }
                 throwIfAborted(options.abortSignal);
@@ -699,31 +1199,129 @@ export class YagrRunEngine {
                     status: 'started',
                     message: `Recovery pass ${attemptNumber + 1} triggered after failed or incomplete execution steps.`,
                 });
-                executeMessages = [
-                    ...executeMessages,
-                    ...sanitizeAssistantResponseMessages(phaseResult.responseMessages),
-                    {
-                        role: 'user',
-                        content: buildRecoveryPrompt(outcome, attemptNumber + 1),
-                    },
-                ];
+                // If the model's response was completely absent or stripped (e.g. empty
+                // stop), appending the recovery prompt to the existing execute history
+                // creates a long conversation that some models (e.g. Gemini) refuse to
+                // continue.  Instead, restart from the clean base context so the
+                // recovery prompt is the only new instruction the model sees.  This
+                // mirrors the short context that the inspect phase uses, which those
+                // models always respond to.
+                const sanitizedPriorResponse = sanitizeAssistantResponseMessages(phaseResult.responseMessages);
+                executeMessages = sanitizedPriorResponse.length === 0
+                    ? [
+                        ...executeBaseContext,
+                        {
+                            role: 'user',
+                            content: buildRecoveryPrompt(outcome, attemptNumber + 1),
+                        },
+                    ]
+                    : [
+                        ...executeMessages,
+                        ...sanitizedPriorResponse,
+                        {
+                            role: 'user',
+                            content: buildRecoveryPrompt(outcome, attemptNumber + 1),
+                        },
+                    ];
             }
             persistedMessages.push(...responseMessages);
             steps += inspectResult.steps.length;
             throwIfAborted(options.abortSignal);
-            const requiredActions = collectRequiredActions(state.journal);
-            const completionDecision = await evaluateCompletionGate({
-                text,
-                finishReason,
-                requiredActions,
-                satisfiedRequiredActionIds: options.satisfiedRequiredActionIds,
-                hasWorkflowWrites: analyzeRunOutcome(state.journal).hasWorkflowWrites,
-                successfulValidate: Boolean(analyzeRunOutcome(state.journal).successfulValidate),
-                successfulPush: Boolean(analyzeRunOutcome(state.journal).successfulPush),
-                unresolvedFailureCount: analyzeRunOutcome(state.journal).unresolvedFailedActions.length,
-                hooks: runtimeHooks,
-                context: buildRuntimeContext(state),
-            });
+            let completionRepairAttempts = 0;
+            let completionDecision;
+            let finalOutcome;
+            let requiredActions;
+            for (;;) {
+                requiredActions = collectRequiredActions(state.journal);
+                finalOutcome = analyzeRunOutcome(state.journal);
+                completionDecision = await evaluateCompletionGate({
+                    text,
+                    finishReason,
+                    requiredActions,
+                    satisfiedRequiredActionIds: options.satisfiedRequiredActionIds,
+                    attemptedMaterialWork: hasObservedToolCall(state.journal, runtimeStrategy.tooling.executionCriticalToolNames),
+                    hasConcreteResult: Boolean(finalOutcome.hasWorkflowWrites
+                        || finalOutcome.successfulValidate
+                        || finalOutcome.successfulPush
+                        || finalOutcome.successfulVerify
+                        || extractPresentedWorkflowFromJournal(state.journal)),
+                    hasWorkflowWrites: finalOutcome.hasWorkflowWrites,
+                    successfulValidate: Boolean(finalOutcome.successfulValidate),
+                    successfulPush: Boolean(finalOutcome.successfulPush),
+                    successfulVerify: Boolean(finalOutcome.successfulVerify),
+                    unresolvedFailureCount: finalOutcome.blockingUnresolvedFailedActions.length,
+                    hooks: runtimeHooks,
+                    context: buildRuntimeContext(state),
+                });
+                if (!completionDecision.accepted
+                    && completionDecision.needsContinuation
+                    && completionRepairAttempts < MAX_COMPLETION_REPAIR_ATTEMPTS) {
+                    completionRepairAttempts += 1;
+                    throwIfAborted(options.abortSignal);
+                    executeMessages = await maybeCompactMessages(state, options, this.systemPrompt, prompt, executeMessages);
+                    executeMessages = [
+                        ...executeMessages,
+                        ...lastExecutionResponseMessages,
+                        {
+                            role: 'user',
+                            content: buildCompletionRepairPrompt(),
+                        },
+                    ];
+                    const phaseResult = await executePhase(state, options, runtimeStrategy, this.systemPrompt, tools, executeMessages, Math.min(options.maxSteps ?? runtimeStrategy.executeMaxSteps, runtimeStrategy.recoveryMaxSteps));
+                    if (phaseResult.text) {
+                        text = phaseResult.text;
+                    }
+                    finishReason = phaseResult.finishReason;
+                    steps += phaseResult.steps;
+                    toolCalls = phaseResult.toolCalls;
+                    lastExecutionResponseMessages = sanitizeAssistantResponseMessages(phaseResult.responseMessages);
+                    responseMessages = [...responseMessages, ...lastExecutionResponseMessages];
+                    persistedMessages.push(...lastExecutionResponseMessages);
+                    await maybeExecuteSyntheticToolIntents(state, options, runtimeStrategy, tools, phaseResult);
+                    continue;
+                }
+                if (!completionDecision.accepted
+                    && completionDecision.needsContinuation
+                    && completionDecision.requiredActions.length === 0
+                    && blockerCaptureAttempts < MAX_BLOCKER_CAPTURE_ATTEMPTS) {
+                    blockerCaptureAttempts += 1;
+                    throwIfAborted(options.abortSignal);
+                    executeMessages = await maybeCompactMessages(state, options, this.systemPrompt, prompt, executeMessages);
+                    executeMessages = [
+                        ...executeMessages,
+                        ...lastExecutionResponseMessages,
+                        {
+                            role: 'user',
+                            content: buildBlockerCapturePrompt(),
+                        },
+                    ];
+                    const blockerTools = {
+                        requestRequiredAction: tools.requestRequiredAction,
+                    };
+                    const phaseResult = await executePhase(state, options, runtimeStrategy, this.systemPrompt, blockerTools, executeMessages, 1);
+                    if (phaseResult.text) {
+                        text = phaseResult.text;
+                    }
+                    finishReason = phaseResult.finishReason;
+                    steps += phaseResult.steps;
+                    toolCalls = phaseResult.toolCalls;
+                    lastExecutionResponseMessages = sanitizeAssistantResponseMessages(phaseResult.responseMessages);
+                    responseMessages = [...responseMessages, ...lastExecutionResponseMessages];
+                    persistedMessages.push(...lastExecutionResponseMessages);
+                    continue;
+                }
+                break;
+            }
+            if (!completionDecision.accepted
+                && completionDecision.needsContinuation
+                && completionDecision.requiredActions.length === 0) {
+                completionDecision = {
+                    ...completionDecision,
+                    state: 'failed_terminal',
+                    reasons: ['Run ended without a concrete result and without a structured blocker.'],
+                    needsContinuation: false,
+                };
+            }
             for (const requiredAction of completionDecision.requiredActions) {
                 await emitJournal(state, options, {
                     type: 'state',
@@ -735,7 +1333,11 @@ export class YagrRunEngine {
                 });
             }
             throwIfAborted(options.abortSignal);
-            text = ensureFinalText(prompt, finishReason, state.journal, text, completionDecision.requiredActions, completionDecision.accepted);
+            await maybeEmitSyntheticWorkflowEmbed(finalOutcome, state.journal, options.onToolEvent);
+            text = await ensureFinalText(prompt, finishReason, state.journal, text, completionDecision.requiredActions, completionDecision.accepted, options, runtimeStrategy);
+            if (text) {
+                await options.onTextDelta?.(text);
+            }
             if (state.currentPhase && state.currentPhase !== 'summarize') {
                 await transitionPhase(state, options, state.currentPhase, 'completed', `${state.currentPhase} phase completed.`);
             }