aven-ai 0.0.2 → 0.0.3

package/dist/modules/agent/prompts/project-instructions.js

@@ -0,0 +1,121 @@
+import { open, readdir } from 'node:fs/promises';
+import { relative, resolve, sep } from 'node:path';
+import { StringDecoder } from 'node:string_decoder';
+export const defaultProjectInstructionLimits = {
+    maxFiles: 32,
+    maxFileBytes: 16 * 1024,
+    maxTotalBytes: 64 * 1024,
+};
+const maxReportedOmittedPaths = 32;
+const ignoredDirectories = new Set([
+    '.cache',
+    '.git',
+    '.next',
+    'build',
+    'coverage',
+    'dist',
+    'node_modules',
+    'target',
+    'vendor',
+]);
+const displayPath = (projectRoot, path) => {
+    const value = relative(projectRoot, path).split(sep).join('/');
+    return value || 'AGENTS.md';
+};
+const instructionScope = (path) => {
+    const parts = path.split('/');
+    parts.pop();
+    return parts.length === 0 ? '.' : parts.join('/');
+};
+const pathDepth = (path) => path.split('/').length;
+const positiveLimit = (value, fallback) => Number.isSafeInteger(value) && value > 0 ? value : fallback;
+const resolveLimits = (limits) => ({
+    maxFiles: positiveLimit(limits.maxFiles ?? 0, defaultProjectInstructionLimits.maxFiles),
+    maxFileBytes: positiveLimit(limits.maxFileBytes ?? 0, defaultProjectInstructionLimits.maxFileBytes),
+    maxTotalBytes: positiveLimit(limits.maxTotalBytes ?? 0, defaultProjectInstructionLimits.maxTotalBytes),
+});
+const utf8Prefix = (buffer, maximum) => {
+    const decoder = new StringDecoder('utf8');
+    return decoder.write(buffer.subarray(0, maximum));
+};
+const readPrefix = async (path, maximum) => {
+    const handle = await open(path, 'r');
+    try {
+        const buffer = Buffer.alloc(maximum + 1);
+        const { bytesRead } = await handle.read(buffer, 0, buffer.length, 0);
+        const truncated = bytesRead > maximum;
+        return {
+            content: truncated ? utf8Prefix(buffer, maximum) : buffer.subarray(0, bytesRead).toString('utf8'),
+            truncated,
+        };
+    }
+    finally {
+        await handle.close();
+    }
+};
+const discoverInstructionPaths = async (projectRoot, warnings) => {
+    const discovered = [];
+    const visit = async (directory) => {
+        let entries;
+        try {
+            entries = await readdir(directory, { withFileTypes: true });
+        }
+        catch (error) {
+            warnings.push(`Could not inspect ${displayPath(projectRoot, directory)}: ${error instanceof Error ? error.message : String(error)}`);
+            return;
+        }
+        entries.sort((left, right) => left.name.localeCompare(right.name));
+        for (const entry of entries) {
+            if (entry.isSymbolicLink())
+                continue;
+            const path = resolve(directory, entry.name);
+            if (entry.isDirectory()) {
+                if (!ignoredDirectories.has(entry.name))
+                    await visit(path);
+                continue;
+            }
+            if (entry.isFile() && entry.name === 'AGENTS.md') {
+                discovered.push({ absolute: path, display: displayPath(projectRoot, path) });
+            }
+        }
+    };
+    await visit(projectRoot);
+    return discovered.sort((left, right) => pathDepth(left.display) - pathDepth(right.display) || left.display.localeCompare(right.display));
+};
+export const loadProjectInstructions = async (projectRoot, overrides = {}) => {
+    const limits = resolveLimits(overrides);
+    const warnings = [];
+    const candidates = await discoverInstructionPaths(projectRoot, warnings);
+    const files = [];
+    const omittedPaths = [];
+    let totalBytes = 0;
+    for (const [index, candidate] of candidates.entries()) {
+        if (files.length >= limits.maxFiles || totalBytes >= limits.maxTotalBytes) {
+            const omittedCandidates = candidates.slice(index);
+            omittedPaths.push(...omittedCandidates.slice(0, maxReportedOmittedPaths).map((item) => item.display));
+            const additionalCount = omittedCandidates.length - omittedPaths.length;
+            if (additionalCount > 0) {
+                warnings.push(`${additionalCount} additional AGENTS.md files were omitted from the prompt.`);
+            }
+            break;
+        }
+        try {
+            const remaining = limits.maxTotalBytes - totalBytes;
+            const maximum = Math.min(limits.maxFileBytes, remaining);
+            const result = await readPrefix(candidate.absolute, maximum);
+            const contentBytes = Buffer.byteLength(result.content);
+            files.push({
+                path: candidate.display,
+                scope: instructionScope(candidate.display),
+                content: result.content,
+                truncated: result.truncated,
+            });
+            totalBytes += contentBytes;
+        }
+        catch (error) {
+            warnings.push(`Could not read ${candidate.display}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    return { files, omittedPaths, warnings };
+};
+//# sourceMappingURL=project-instructions.js.map

package/dist/modules/agent/prompts/project-instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-instructions.js","sourceRoot":"","sources":["../../../../src/modules/agent/prompts/project-instructions.ts"],"names":[],"mappings":"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"}

package/dist/modules/agent/prompts/system.d.ts

@@ -1,2 +1,13 @@
-export declare const buildSystemPrompt: (projectRoot: string) => string;
+import type { ProjectInstructionBundle } from './project-instructions.js';
+export type SystemPromptContext = {
+    lexa: {
+        skill: string;
+        version: string;
+    };
+    projectRoot: string;
+    platform: string;
+    shell: string;
+    projectInstructions: ProjectInstructionBundle;
+};
+export declare const buildSystemPrompt: (context: SystemPromptContext) => string;
 //# sourceMappingURL=system.d.ts.map

package/dist/modules/agent/prompts/system.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../../src/modules/agent/prompts/system.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,iBAAiB,gBAAiB,MAAM,KAAG,MAC2C,CAAC"}
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../../src/modules/agent/prompts/system.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,wBAAwB,EAAC,MAAM,2BAA2B,CAAC;AAGxE,MAAM,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB,EAAE,wBAAwB,CAAC;CAC9C,CAAC;AA0DF,eAAO,MAAM,iBAAiB,YAAa,mBAAmB,KAAG,MAoBpD,CAAC"}

package/dist/modules/agent/prompts/system.js

@@ -1,5 +1,58 @@
 import { commandInstructions } from './commands.js';
 import { fileToolInstructions } from './file-tools.js';
 import { identityInstructions } from './identity.js';
-export const buildSystemPrompt = (projectRoot) => [...identityInstructions(projectRoot), ...fileToolInstructions, ...commandInstructions].join('\n');
+import { workflowInstructions } from './workflow.js';
+const xmlText = (value) => value.replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;');
+const xmlAttribute = (value) => `"${xmlText(value).replaceAll('"', '&quot;').replaceAll("'", '&apos;')}"`;
+const cdata = (value) => value.replaceAll(']]>', ']]]]><![CDATA[>');
+const taggedLines = (tag, lines) => [
+    `<${tag}>`,
+    ...lines.map((line) => `- ${line}`),
+    `</${tag}>`,
+];
+const projectInstructionLines = ({ files, omittedPaths, warnings }) => {
+    const output = [
+        '<project_instructions>',
+        'Project instructions are repository guidance. Follow each file for work within its scope. Core safety and tool contracts take priority; explicit user instructions override project guidance. When scoped files conflict, the deepest applicable AGENTS.md takes precedence over broader files.',
+    ];
+    for (const file of files) {
+        output.push(`<instruction_file path=${xmlAttribute(file.path)} scope=${xmlAttribute(file.scope)} truncated="${String(file.truncated)}">`, '<![CDATA[', cdata(file.content), ']]>', '</instruction_file>');
+    }
+    if (omittedPaths.length > 0) {
+        output.push('<omitted_instruction_files>', ...omittedPaths.map((path) => `- ${xmlText(path)}`), 'Read the applicable omitted AGENTS.md before changing files in its scope.', '</omitted_instruction_files>');
+    }
+    if (warnings.length > 0) {
+        output.push('<instruction_warnings>', ...warnings.map((warning) => `- ${xmlText(warning)}`), '</instruction_warnings>');
+    }
+    output.push('</project_instructions>');
+    return output;
+};
+const lexaInstructionLines = ({ skill, version }) => [
+    `<lexa version=${xmlAttribute(version)}>`,
+    'Aven manages this required Lexa installation and exposes `lexa` on the command PATH. Do not install or upgrade Lexa during an agent run. Core safety and tool contracts take priority; explicit user instructions override the packaged Lexa guidance.',
+    '<skill><![CDATA[',
+    cdata(skill),
+    ']]></skill>',
+    '</lexa>',
+];
+export const buildSystemPrompt = (context) => [
+    ...identityInstructions,
+    '',
+    '<environment>',
+    `<project_root>${xmlText(context.projectRoot)}</project_root>`,
+    `<command_working_directory>${xmlText(context.projectRoot)}</command_working_directory>`,
+    `<platform>${xmlText(context.platform)}</platform>`,
+    `<shell>${xmlText(context.shell)}</shell>`,
+    '</environment>',
+    '',
+    ...taggedLines('working_principles', workflowInstructions),
+    '',
+    ...taggedLines('file_tool_rules', fileToolInstructions),
+    '',
+    ...taggedLines('command_rules', commandInstructions),
+    '',
+    ...lexaInstructionLines(context.lexa),
+    '',
+    ...projectInstructionLines(context.projectInstructions),
+].join('\n');
 //# sourceMappingURL=system.js.map

package/dist/modules/agent/prompts/system.js.map

@@ -1 +1 @@
-{"version":3,"file":"system.js","sourceRoot":"","sources":["../../../../src/modules/agent/prompts/system.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,mBAAmB,EAAC,MAAM,eAAe,CAAC;AAClD,OAAO,EAAC,oBAAoB,EAAC,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAC,oBAAoB,EAAC,MAAM,eAAe,CAAC;AAEnD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,WAAmB,EAAU,EAAE,CAChE,CAAC,GAAG,oBAAoB,CAAC,WAAW,CAAC,EAAE,GAAG,oBAAoB,EAAE,GAAG,mBAAmB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}
+{"version":3,"file":"system.js","sourceRoot":"","sources":["../../../../src/modules/agent/prompts/system.ts"],"names":[],"mappings":"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"}

package/dist/modules/agent/prompts/workflow.d.ts

@@ -0,0 +1,2 @@
+export declare const workflowInstructions: readonly string[];
+//# sourceMappingURL=workflow.d.ts.map

package/dist/modules/agent/prompts/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../../../src/modules/agent/prompts/workflow.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAUjD,CAAC"}

package/dist/modules/agent/prompts/workflow.js

@@ -0,0 +1,12 @@
+export const workflowInstructions = [
+    'Ground statements about the repository in inspected files or command results.',
+    'Follow the user-requested scope and preserve unrelated existing changes.',
+    'For explanation, review, or status requests, inspect and report without modifying files unless the user also requests a change.',
+    'For diagnosis requests, determine and explain the root cause before proposing or implementing a fix.',
+    'For implementation requests, inspect the relevant code, implement the complete scoped change, and verify it proportionally.',
+    'Prefer established project patterns and existing files over unnecessary abstractions or new files.',
+    'When an operation fails, use the returned error and agent guidance to change the approach; do not repeat an unchanged failing operation.',
+    'Do not claim success unless relevant tool and command results confirm it.',
+    'Keep the final response concise and state what changed and how it was verified.',
+];
+//# sourceMappingURL=workflow.js.map

package/dist/modules/agent/prompts/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../../../src/modules/agent/prompts/workflow.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAsB;IACtD,+EAA+E;IAC/E,0EAA0E;IAC1E,iIAAiI;IACjI,sGAAsG;IACtG,6HAA6H;IAC7H,oGAAoG;IACpG,0IAA0I;IAC1I,2EAA2E;IAC3E,iFAAiF;CACjF,CAAC"}

package/dist/modules/agent/services/agent-recovery.d.ts

@@ -0,0 +1,16 @@
+export declare const FAILURE_WARNING_THRESHOLD = 3;
+export declare const FAILURE_STOP_THRESHOLD = 5;
+export declare const LOOP_WARNING_THRESHOLD = 3;
+export declare const LOOP_STOP_THRESHOLD = 5;
+type LoopMatch = {
+    patternLength: number;
+    repetitions: number;
+};
+export declare const canonicalToolSignature: (toolName: string, args: string) => string;
+export declare const repeatingSuffix: (sequence: readonly string[]) => LoopMatch | undefined;
+export declare const createAgentRecovery: () => {
+    hook: import("@anvia/core/hooks").PromptHook<unknown>;
+    middleware: import("@anvia/core").AgentMiddleware<unknown>;
+};
+export {};
+//# sourceMappingURL=agent-recovery.d.ts.map

package/dist/modules/agent/services/agent-recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-recovery.d.ts","sourceRoot":"","sources":["../../../../src/modules/agent/services/agent-recovery.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,sBAAsB,IAAI,CAAC;AACxC,eAAO,MAAM,sBAAsB,IAAI,CAAC;AACxC,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAIrC,KAAK,SAAS,GAAG;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACpB,CAAC;AA+BF,eAAO,MAAM,sBAAsB,aAAc,MAAM,QAAQ,MAAM,KAAG,MAQvE,CAAC;AAEF,eAAO,MAAM,eAAe,aAAc,SAAS,MAAM,EAAE,KAAG,SAAS,GAAG,SAqBzE,CAAC;AA2CF,eAAO,MAAM,mBAAmB;;;CAgD/B,CAAC"}

package/dist/modules/agent/services/agent-recovery.js

@@ -0,0 +1,143 @@
+import { createHook, createMiddleware } from '@anvia/core';
+export const FAILURE_WARNING_THRESHOLD = 3;
+export const FAILURE_STOP_THRESHOLD = 5;
+export const LOOP_WARNING_THRESHOLD = 3;
+export const LOOP_STOP_THRESHOLD = 5;
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const parseRecord = (value) => {
+    try {
+        const parsed = JSON.parse(value);
+        return isRecord(parsed) ? parsed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+};
+const canonicalValue = (value) => {
+    if (Array.isArray(value))
+        return value.map(canonicalValue);
+    if (!isRecord(value))
+        return value;
+    return Object.fromEntries(Object.keys(value)
+        .sort()
+        .map((key) => [key, canonicalValue(value[key])]));
+};
+export const canonicalToolSignature = (toolName, args) => {
+    let normalized = args.trim();
+    try {
+        normalized = canonicalValue(JSON.parse(args));
+    }
+    catch {
+        // Malformed arguments still need a stable signature for repetition checks.
+    }
+    return `${toolName}:${typeof normalized === 'string' ? normalized : JSON.stringify(normalized)}`;
+};
+export const repeatingSuffix = (sequence) => {
+    let best;
+    for (let patternLength = 1; patternLength <= Math.floor(sequence.length / LOOP_WARNING_THRESHOLD); patternLength++) {
+        const patternStart = sequence.length - patternLength;
+        const pattern = sequence.slice(patternStart);
+        let repetitions = 1;
+        for (let end = patternStart; end >= patternLength; end -= patternLength) {
+            const candidate = sequence.slice(end - patternLength, end);
+            if (!candidate.every((item, index) => item === pattern[index]))
+                break;
+            repetitions += 1;
+        }
+        if (repetitions >= LOOP_WARNING_THRESHOLD &&
+            (!best ||
+                repetitions > best.repetitions ||
+                (repetitions === best.repetitions && patternLength < best.patternLength))) {
+            best = { patternLength, repetitions };
+        }
+    }
+    return best;
+};
+const failureReason = (toolName, result) => {
+    const parsed = parseRecord(result);
+    if (!parsed)
+        return 'The tool returned an unstructured or malformed result.';
+    if (parsed.status === 'error')
+        return typeof parsed.error === 'string' ? parsed.error : 'The tool reported an error.';
+    if (toolName === 'ExecCommand') {
+        if (parsed.timedOut === true)
+            return 'The command timed out.';
+        if (typeof parsed.signal === 'number' && parsed.signal !== 0)
+            return `The command exited after signal ${parsed.signal}.`;
+        if (typeof parsed.exitCode !== 'number')
+            return 'The command result did not include a valid exit code.';
+        if (parsed.exitCode !== 0)
+            return `The command exited with code ${parsed.exitCode}.`;
+        return undefined;
+    }
+    if (toolName === 'Read') {
+        return parsed.status === 'success' || parsed.status === 'unchanged'
+            ? undefined
+            : 'Read returned an unexpected result shape.';
+    }
+    if (toolName === 'Edit' || toolName === 'Write') {
+        return parsed.status === 'success' ? undefined : `${toolName} returned an unexpected result shape.`;
+    }
+    return undefined;
+};
+const failureGuidance = (toolName, reason, failureCount) => {
+    const attemptsRemaining = Math.max(0, FAILURE_STOP_THRESHOLD - failureCount);
+    const warning = failureCount >= FAILURE_WARNING_THRESHOLD
+        ? 'Do not repeat the same call unchanged; inspect the error and choose a materially different approach.'
+        : 'Inspect the error, correct the arguments or approach, and retry only when there is a concrete reason it should succeed.';
+    return `${toolName} failed (${failureCount}/${FAILURE_STOP_THRESHOLD}): ${reason} ${warning} Attempts remaining before this run stops: ${attemptsRemaining}.`;
+};
+const loopGuidance = ({ patternLength, repetitions }) => `A repeating tool-call pattern of length ${patternLength} has occurred ${repetitions} times. The repeated call was skipped. Change tools, arguments, or strategy before continuing.`;
+const guidedResult = (toolName, result, guidance) => {
+    const parsed = parseRecord(result);
+    if (parsed)
+        return JSON.stringify({ ...parsed, agent_guidance: guidance });
+    return JSON.stringify({ status: 'error', tool: toolName, error: result, agent_guidance: guidance });
+};
+export const createAgentRecovery = () => {
+    const state = {
+        failures: new Map(),
+        toolCalls: [],
+        loopsByCall: new Map(),
+    };
+    const middleware = createMiddleware({
+        onToolOutput: ({ toolName, result, internalCallId }) => {
+            const loop = state.loopsByCall.get(internalCallId);
+            state.loopsByCall.delete(internalCallId);
+            const reason = failureReason(toolName, result);
+            if (!reason && !loop) {
+                state.failures.delete(toolName);
+                return undefined;
+            }
+            const failureCount = (state.failures.get(toolName) ?? 0) + 1;
+            state.failures.set(toolName, failureCount);
+            if (failureCount >= FAILURE_STOP_THRESHOLD && !state.stopReason) {
+                state.stopReason = `${toolName} failed ${failureCount} consecutive times.`;
+            }
+            const guidance = [
+                loop ? loopGuidance(loop) : '',
+                failureGuidance(toolName, reason ?? 'The repeated call was skipped.', failureCount),
+            ]
+                .filter(Boolean)
+                .join(' ');
+            return guidedResult(toolName, result, guidance);
+        },
+    });
+    const hook = createHook({
+        onTurnStart: ({ run }) => (state.stopReason ? run.cancel(state.stopReason) : undefined),
+        onToolCall: ({ toolName, args, internalCallId, tool }) => {
+            const signature = canonicalToolSignature(toolName, args);
+            state.toolCalls.push(signature);
+            const loop = repeatingSuffix(state.toolCalls);
+            if (!loop)
+                return undefined;
+            state.loopsByCall.set(internalCallId, loop);
+            if (loop.repetitions >= LOOP_STOP_THRESHOLD && !state.stopReason) {
+                state.stopReason = `A repeating tool-call pattern occurred ${loop.repetitions} times.`;
+            }
+            return tool.skip(loopGuidance(loop));
+        },
+    });
+    return { hook, middleware };
+};
+//# sourceMappingURL=agent-recovery.js.map

package/dist/modules/agent/services/agent-recovery.js.map

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

package/dist/modules/agent/services/prompt-turn-executor.d.ts

@@ -3,10 +3,12 @@ import type { SqliteMemoryStore } from '@anvia/memory-sqlite';
 import type { RuntimeEvent } from '../types.js';
 import type { SubmitRequest } from '../types.js';
 import type { FileToolService } from '../tools/files/file-tool-service.js';
-import type { PtyRunner } from '../../../libs/pty/index.js';
+import { type PtyRunner } from '../../../libs/pty/index.js';
+import type { LexaRuntime } from '../../../libs/lexa/index.js';
+export declare const MAX_AGENT_TURNS = 50;
 export declare class PromptTurnExecutor {
     #private;
-    constructor(projectRoot: string, memory: SqliteMemoryStore, pty: PtyRunner, files: FileToolService);
+    constructor(projectRoot: string, memory: SqliteMemoryStore, pty: PtyRunner, files: FileToolService, lexa: LexaRuntime);
     run(request: SubmitRequest, signal: AbortSignal, model: CompletionModel, sessionId: string): AsyncIterable<RuntimeEvent>;
 }
 //# sourceMappingURL=prompt-turn-executor.d.ts.map

package/dist/modules/agent/services/prompt-turn-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-turn-executor.d.ts","sourceRoot":"","sources":["../../../../src/modules/agent/services/prompt-turn-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,eAAe,EAAC,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,aAAa,CAAC;AAG/C,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,qCAAqC,CAAC;AACzE,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,4BAA4B,CAAC;AAK1D,qBAAa,kBAAkB;;IAM9B,YAAY,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAKjG;IAEM,GAAG,CACT,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,eAAe,EACtB,SAAS,EAAE,MAAM,GACf,aAAa,CAAC,YAAY,CAAC,CA6D7B;CACD"}
+{"version":3,"file":"prompt-turn-executor.d.ts","sourceRoot":"","sources":["../../../../src/modules/agent/services/prompt-turn-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,eAAe,EAAC,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,aAAa,CAAC;AAG/C,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAc,KAAK,SAAS,EAAC,MAAM,4BAA4B,CAAC;AAMvE,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,6BAA6B,CAAC;AAE7D,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC,qBAAa,kBAAkB;;IAO9B,YACC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,iBAAiB,EACzB,GAAG,EAAE,SAAS,EACd,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,WAAW,EAOjB;IAEM,GAAG,CACT,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,eAAe,EACtB,SAAS,EAAE,MAAM,GACf,aAAa,CAAC,YAAY,CAAC,CA0E7B;CACD"}

package/dist/modules/agent/services/prompt-turn-executor.js

@@ -1,28 +1,46 @@
 import { AgentBuilder } from '@anvia/core';
 import { createExecCommandTool } from '../tools/exec-command.js';
 import { createFileTools } from '../tools/files/create-file-tools.js';
+import { activeShell } from '../../../libs/pty/index.js';
 import { safeErrorMessage } from '../../../utils/safe-error.js';
 import { eventToRuntimeEvents } from '../events/stream-event-adapter.js';
 import { buildSystemPrompt } from '../prompts/system.js';
+import { loadProjectInstructions } from '../prompts/project-instructions.js';
+import { createAgentRecovery } from './agent-recovery.js';
+export const MAX_AGENT_TURNS = 50;
 export class PromptTurnExecutor {
     #files;
     #memory;
     #projectRoot;
     #pty;
-    constructor(projectRoot, memory, pty, files) {
+    #lexa;
+    constructor(projectRoot, memory, pty, files, lexa) {
         this.#projectRoot = projectRoot;
         this.#memory = memory;
         this.#pty = pty;
         this.#files = files;
+        this.#lexa = lexa;
     }
     async *run(request, signal, model, sessionId) {
         yield { type: 'status.changed', status: 'thinking' };
+        const projectInstructions = await loadProjectInstructions(this.#projectRoot);
+        if (signal.aborted)
+            throw signal.reason ?? new Error('Aborted');
+        const recovery = createAgentRecovery();
         const tools = [createExecCommandTool(this.#pty, signal), ...createFileTools(this.#files, signal)];
         const agent = new AgentBuilder('aven', model)
-            .instructions(buildSystemPrompt(this.#projectRoot))
+            .instructions(buildSystemPrompt({
+            lexa: this.#lexa,
+            projectRoot: this.#projectRoot,
+            platform: process.platform,
+            shell: activeShell(),
+            projectInstructions,
+        }))
             .tools(tools)
+            .middleware(recovery.middleware)
+            .hook(recovery.hook)
             .memory(this.#memory, { savePolicy: 'turn' })
-            .defaultMaxTurns(8)
+            .defaultMaxTurns(MAX_AGENT_TURNS)
             .build();
         const streamedTurn = agent
             .session(sessionId, { metadata: { projectRoot: this.#projectRoot } })

package/dist/modules/agent/services/prompt-turn-executor.js.map

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

package/dist/modules/agent/tools/exec-command.d.ts

@@ -9,5 +9,6 @@ export declare const createExecCommandTool: (pty: PtyRunner, signal: AbortSignal
     timedOut: boolean;
     truncated: boolean;
     output: string;
+    agent_guidance?: string | undefined;
 }>;
 //# sourceMappingURL=exec-command.d.ts.map

package/dist/modules/agent/tools/exec-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exec-command.d.ts","sourceRoot":"","sources":["../../../../src/modules/agent/tools/exec-command.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,4BAA4B,CAAC;AAG1D,eAAO,MAAM,qBAAqB,QAAS,SAAS,UAAU,WAAW;;;;;;;;;;EAOtE,CAAC"}
+{"version":3,"file":"exec-command.d.ts","sourceRoot":"","sources":["../../../../src/modules/agent/tools/exec-command.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,4BAA4B,CAAC;AAG1D,eAAO,MAAM,qBAAqB,QAAS,SAAS,UAAU,WAAW;;;;;;;;;;;EAOtE,CAAC"}

package/dist/modules/agent/tools/files/contracts.d.ts

@@ -23,6 +23,7 @@ export declare const readResultSchema: z.ZodUnion<readonly [z.ZodObject<{
     num_lines: z.ZodNumber;
     total_lines: z.ZodNumber;
     truncated: z.ZodBoolean;
+    agent_guidance: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>, z.ZodObject<{
     status: z.ZodLiteral<"unchanged">;
     tool: z.ZodLiteral<"Read">;
@@ -31,6 +32,7 @@ export declare const readResultSchema: z.ZodUnion<readonly [z.ZodObject<{
     num_lines: z.ZodNumber;
     total_lines: z.ZodNumber;
     message: z.ZodString;
+    agent_guidance: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>, z.ZodObject<{
     status: z.ZodLiteral<"error">;
     tool: z.ZodEnum<{
@@ -40,6 +42,7 @@ export declare const readResultSchema: z.ZodUnion<readonly [z.ZodObject<{
     }>;
     file_path: z.ZodString;
     error: z.ZodString;
+    agent_guidance: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>]>;
 export declare const editResultSchema: z.ZodUnion<readonly [z.ZodObject<{
     status: z.ZodLiteral<"success">;
@@ -48,6 +51,7 @@ export declare const editResultSchema: z.ZodUnion<readonly [z.ZodObject<{
     replacements: z.ZodNumber;
     operation_id: z.ZodString;
     message: z.ZodString;
+    agent_guidance: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>, z.ZodObject<{
     status: z.ZodLiteral<"error">;
     tool: z.ZodEnum<{
@@ -57,6 +61,7 @@ export declare const editResultSchema: z.ZodUnion<readonly [z.ZodObject<{
     }>;
     file_path: z.ZodString;
     error: z.ZodString;
+    agent_guidance: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>]>;
 export declare const writeResultSchema: z.ZodUnion<readonly [z.ZodObject<{
     status: z.ZodLiteral<"success">;
@@ -68,6 +73,7 @@ export declare const writeResultSchema: z.ZodUnion<readonly [z.ZodObject<{
     }>;
     operation_id: z.ZodString;
     message: z.ZodString;
+    agent_guidance: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>, z.ZodObject<{
     status: z.ZodLiteral<"error">;
     tool: z.ZodEnum<{
@@ -77,6 +83,7 @@ export declare const writeResultSchema: z.ZodUnion<readonly [z.ZodObject<{
     }>;
     file_path: z.ZodString;
     error: z.ZodString;
+    agent_guidance: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>]>;
 export declare const fileToolResultSchema: z.ZodUnion<readonly [z.ZodObject<{
     status: z.ZodLiteral<"success">;
@@ -87,6 +94,7 @@ export declare const fileToolResultSchema: z.ZodUnion<readonly [z.ZodObject<{
     num_lines: z.ZodNumber;
     total_lines: z.ZodNumber;
     truncated: z.ZodBoolean;
+    agent_guidance: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>, z.ZodObject<{
     status: z.ZodLiteral<"unchanged">;
     tool: z.ZodLiteral<"Read">;
@@ -95,6 +103,7 @@ export declare const fileToolResultSchema: z.ZodUnion<readonly [z.ZodObject<{
     num_lines: z.ZodNumber;
     total_lines: z.ZodNumber;
     message: z.ZodString;
+    agent_guidance: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>, z.ZodObject<{
     status: z.ZodLiteral<"success">;
     tool: z.ZodLiteral<"Edit">;
@@ -102,6 +111,7 @@ export declare const fileToolResultSchema: z.ZodUnion<readonly [z.ZodObject<{
     replacements: z.ZodNumber;
     operation_id: z.ZodString;
     message: z.ZodString;
+    agent_guidance: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>, z.ZodObject<{
     status: z.ZodLiteral<"success">;
     tool: z.ZodLiteral<"Write">;
@@ -112,6 +122,7 @@ export declare const fileToolResultSchema: z.ZodUnion<readonly [z.ZodObject<{
     }>;
     operation_id: z.ZodString;
     message: z.ZodString;
+    agent_guidance: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>, z.ZodObject<{
     status: z.ZodLiteral<"error">;
     tool: z.ZodEnum<{
@@ -121,6 +132,7 @@ export declare const fileToolResultSchema: z.ZodUnion<readonly [z.ZodObject<{
     }>;
     file_path: z.ZodString;
     error: z.ZodString;
+    agent_guidance: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>]>;
 export type ReadInput = z.infer<typeof readInputSchema>;
 export type EditInput = z.infer<typeof editInputSchema>;

package/dist/modules/agent/tools/files/contracts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../../../../src/modules/agent/tools/files/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,eAAO,MAAM,eAAe;;;;kBAMlB,CAAC;AAEX,eAAO,MAAM,eAAe;;;;;kBAOlB,CAAC;AAEX,eAAO,MAAM,gBAAgB;;;kBAKnB,CAAC;AA0DX,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;oBAAqE,CAAC;AACnG,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;oBAAgD,CAAC;AAC9E,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;oBAAiD,CAAC;AAChF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAM/B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../../../../src/modules/agent/tools/files/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAItB,eAAO,MAAM,eAAe;;;;kBAMlB,CAAC;AAEX,eAAO,MAAM,eAAe;;;;;kBAOlB,CAAC;AAEX,eAAO,MAAM,gBAAgB;;;kBAKnB,CAAC;AA+DX,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAAqE,CAAC;AACnG,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;oBAAgD,CAAC;AAC9E,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;oBAAiD,CAAC;AAChF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAM/B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}