librecoding 0.6.0__tar.gz → 0.7.0__tar.gz

{librecoding-0.6.0 → librecoding-0.7.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.5
 Name: librecoding
-Version: 0.6.0
-Summary: Agent library: prompt -> tools -> results in files2/
+Version: 0.7.0
+Summary: Agent library: chat prompts answered, file prompts processed files/ -> files2/
 Author: ar
 License-Expression: MIT
 Keywords: agent,ai,librecoding

{librecoding-0.6.0 → librecoding-0.7.0}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "hatchling.build"
 
 [project]
 name = "librecoding"
-version = "0.6.0"
-description = "Agent library: prompt -> tools -> results in files2/"
+version = "0.7.0"
+description = "Agent library: chat prompts answered, file prompts processed files/ -> files2/"
 readme = "README.md"
 requires-python = ">=3.10"
 license = "MIT"

librecoding-0.7.0/src/librecoding/__init__.py

@@ -0,0 +1,464 @@
+"""librecoding: обычный промпт -> ответ; промпт про файлы -> files/ -> files2/."""
+
+from __future__ import annotations
+
+import json
+import os
+import re
+import shutil
+import subprocess
+import sys
+import urllib.error
+import urllib.request
+from pathlib import Path
+from types import ModuleType
+
+from .core import greet
+
+__version__ = "0.7.0"
+
+API_URL = "https://openrouter.ai/api/v1/chat/completions"
+DEFAULT_MODEL = "deepseek/deepseek-v4.1-flash"
+KEY_FILE = Path.home() / ".config" / "librecoding" / "api_key"
+
+IN_DIR_NAME = "files"
+OUT_DIR_NAME = "files2"
+PROMPT = "Введи промпт: "
+PAUSE_TEXT = "Нажми Enter, чтобы закрыть..."
+
+MAX_STEPS = 15
+TOOL_LIMIT = 12000
+
+CHAT_SYSTEM = (
+    "Ты - полезный ассистент. Отвечай по-русски, кратко и по делу. "
+    "Не создавай файлы, не вызывай инструменты, ничего не сохраняй."
+)
+
+AGENT_SYSTEM = f"""Ты - агент библиотеки librecoding. Рабочая папка = папка запущенного скрипта.
+
+Папки:
+  {IN_DIR_NAME}/  - ТОЛЬКО ЧТЕНИЕ: входные файлы пользователя.
+  {OUT_DIR_NAME}/ - сюда сохраняй ВСЕ результаты.
+
+Инструменты: list_files, read_file, write_file, run_python (cwd = рабочая папка, openpyxl установлен).
+
+Правила:
+1. Всё создаваемое клади ТОЛЬКО в {OUT_DIR_NAME}/, имя - как у исходника, если не сказано иное.
+2. В {IN_DIR_NAME}/ НИКОГДА ничего не записывай, не изменяй, не удаляй.
+3. Для xlsx/csv не выдумывай данные - только run_python.
+4. Финальный ответ: 1-3 строки по-русски, что сделал и какие файлы создал."""
+
+TOOLS = [
+    {
+        "type": "function",
+        "function": {
+            "name": "list_files",
+            "description": f"Показать файлы во входной папке {IN_DIR_NAME}/.",
+            "parameters": {"type": "object", "properties": {}, "required": []},
+        },
+    },
+    {
+        "type": "function",
+        "function": {
+            "name": "read_file",
+            "description": f"Прочитать файл из {IN_DIR_NAME}/ (текст или предпросмотр таблицы).",
+            "parameters": {
+                "type": "object",
+                "properties": {"name": {"type": "string"}},
+                "required": ["name"],
+            },
+        },
+    },
+    {
+        "type": "function",
+        "function": {
+            "name": "write_file",
+            "description": f"Записать текстовый файл в {OUT_DIR_NAME}/.",
+            "parameters": {
+                "type": "object",
+                "properties": {"name": {"type": "string"}, "content": {"type": "string"}},
+                "required": ["name", "content"],
+            },
+        },
+    },
+    {
+        "type": "function",
+        "function": {
+            "name": "run_python",
+            "description": (
+                "Выполнить Python-код в рабочей папке (cwd). Пути: "
+                f"'{IN_DIR_NAME}/...' и '{OUT_DIR_NAME}/...'. openpyxl установлен. "
+                f"Результаты только в {OUT_DIR_NAME}/."
+            ),
+            "parameters": {"type": "object", "properties": {"code": {"type": "string"}}, "required": ["code"]},
+        },
+    },
+]
+
+_state = {"key": None, "model": DEFAULT_MODEL}
+
+
+def set_api_key(key: str) -> None:
+    _state["key"] = key.strip()
+
+
+def set_model(model: str) -> None:
+    _state["model"] = model
+
+
+def get_model() -> str:
+    return _state["model"]
+
+
+def _api_key() -> str:
+    if _state["key"]:
+        return _state["key"]
+    env = os.environ.get("OPENROUTER_API_KEY", "").strip()
+    if env:
+        return env
+    if KEY_FILE.is_file():
+        for line in KEY_FILE.read_text(encoding="utf-8").splitlines():
+            line = line.strip()
+            if line and not line.startswith("#"):
+                return line
+    raise RuntimeError(
+        "API-ключ OpenRouter не найден. Задай его так:\n"
+        f"  echo 'sk-or-v1-...' > {KEY_FILE}\n"
+        f"  chmod 600 {KEY_FILE}"
+    )
+
+
+def _caller_dir() -> Path:
+    path = getattr(sys.modules.get("__main__"), "__file__", None)
+    if path:
+        return Path(path).resolve().parent
+    if sys.argv and sys.argv[0]:
+        return Path(sys.argv[0]).resolve().parent
+    return Path.cwd()
+
+
+def in_dir(create: bool = False) -> Path:
+    """Входная папка files/. По умолчанию не создаётся."""
+    p = _caller_dir() / IN_DIR_NAME
+    if create:
+        p.mkdir(parents=True, exist_ok=True)
+    return p
+
+
+def out_dir(create: bool = True) -> Path:
+    """Выходная папка files2/."""
+    p = _caller_dir() / OUT_DIR_NAME
+    if create:
+        p.mkdir(parents=True, exist_ok=True)
+    return p
+
+
+def ensure_dirs(create_input: bool = False):
+    return in_dir(create=create_input), out_dir(create=True)
+
+
+def _safe(base: Path, name: str) -> Path:
+    base = base.resolve()
+    p = (base / name).resolve()
+    if base != p and base not in p.parents:
+        raise ValueError(f"путь вне папки: {name}")
+    return p
+
+
+def next_filename(directory=None) -> Path:
+    base = Path(directory) if directory else out_dir(create=False)
+    nums = [int(p.stem) for p in base.glob("*.txt") if p.stem.isdigit()]
+    return base / f"{max(nums, default=0) + 1}.txt"
+
+
+FILE_EXT_RE = re.compile(
+    r"\.(xlsx|xlsm|xls|csv|tsv|txt|md|json|docx|doc|pdf|zip|log|xml|ya?ml|py)\b", re.I
+)
+FILE_WORD_RE = re.compile(
+    r"(файл|папк|каталог|таблиц|документ|эксель|excel|xlsx|csv|docx|pdf|"
+    r"отсорт|сортир|переимен|выгруз|объедин|конверт|извлек|столбц|вложение|"
+    r"прочита|прочти|открой|сохрани|обработа|скопируй|перенеси)",
+    re.I,
+)
+
+
+def is_file_task(prompt: str, force=None) -> bool:
+    """True -> агент с инструментами, False -> просто ответ без файлов."""
+    if force is not None:
+        return bool(force)
+    low = str(prompt).lower()
+    if FILE_EXT_RE.search(low) or FILE_WORD_RE.search(low):
+        return True
+    d = in_dir()
+    if d.is_dir():
+        for f in d.iterdir():
+            if not f.is_file():
+                continue
+            stem, name = f.stem.lower(), f.name.lower()
+            if name in low or (len(stem) >= 3 and stem in low):
+                return True
+    return False
+
+
+def _api(payload: dict, timeout: int = 300) -> dict:
+    req = urllib.request.Request(
+        API_URL,
+        data=json.dumps(payload).encode("utf-8"),
+        headers={
+            "Authorization": f"Bearer {_api_key()}",
+            "Content-Type": "application/json",
+            "HTTP-Referer": "https://pypi.org/project/librecoding/",
+            "X-Title": "librecoding",
+        },
+        method="POST",
+    )
+    try:
+        with urllib.request.urlopen(req, timeout=timeout) as resp:
+            return json.loads(resp.read().decode("utf-8"))
+    except urllib.error.HTTPError as exc:
+        body = exc.read().decode("utf-8", "replace")[:400]
+        raise RuntimeError(f"OpenRouter HTTP {exc.code}: {body}") from None
+    except urllib.error.URLError as exc:
+        raise RuntimeError(f"нет сети / таймаут: {exc.reason}") from None
+
+
+def ask(prompt, model=None, temperature=0.7, timeout=300) -> str:
+    """Один запрос без инструментов и без файлов."""
+    data = _api(
+        {
+            "model": model or _state["model"],
+            "messages": [
+                {"role": "system", "content": CHAT_SYSTEM},
+                {"role": "user", "content": prompt},
+            ],
+            "temperature": temperature,
+        },
+        timeout=timeout,
+    )
+    try:
+        return data["choices"][0]["message"]["content"] or ""
+    except (KeyError, IndexError, TypeError):
+        raise RuntimeError(f"неожиданный ответ: {str(data)[:400]}") from None
+
+
+def _snapshot(d: Path) -> dict:
+    if not d.is_dir():
+        return {}
+    out = {}
+    for p in d.iterdir():
+        if p.is_file():
+            try:
+                st = p.stat()
+                out[p.name] = (st.st_size, st.st_mtime_ns)
+            except OSError:
+                pass
+    return out
+
+
+def _tool_list() -> str:
+    d = in_dir()
+    if not d.is_dir():
+        return f"папки {IN_DIR_NAME}/ нет. Попроси пользователя создать её и положить файлы."
+    files = sorted(p for p in d.iterdir() if p.is_file())
+    if not files:
+        return f"{IN_DIR_NAME}/ пуста"
+    return f"файлы в {IN_DIR_NAME}/:\n" + "\n".join(
+        f"  {p.name} ({p.stat().st_size} байт)" for p in files
+    )
+
+
+def _tool_read(name: str) -> str:
+    d = in_dir()
+    if not d.is_dir():
+        return f"папки {IN_DIR_NAME}/ нет"
+    p = _safe(d, name)
+    if not p.is_file():
+        return f"нет файла {name}. Есть: {[q.name for q in d.iterdir() if q.is_file()]}"
+    suffix = p.suffix.lower()
+    if suffix in {".xlsx", ".xlsm"}:
+        try:
+            from openpyxl import load_workbook
+        except ImportError:
+            return "openpyxl недоступен - используй run_python"
+        wb = load_workbook(p, read_only=True, data_only=True)
+        parts = []
+        for ws in wb.worksheets[:3]:
+            parts.append(f"--- лист '{ws.title}' ---")
+            for row in ws.iter_rows(min_row=1, max_row=min(ws.max_row or 0, 15), values_only=True):
+                parts.append(" | ".join("" if c is None else str(c) for c in row))
+        wb.close()
+        return "\n".join(parts)[:TOOL_LIMIT]
+    if suffix in {".csv", ".tsv", ".txt", ".md", ".json", ".py", ".log", ".xml", ".yml", ".yaml"}:
+        text = p.read_text(encoding="utf-8", errors="replace")
+        return text[:TOOL_LIMIT] + ("\n...[обрезано]" if len(text) > TOOL_LIMIT else "")
+    return f"бинарный файл ({suffix or 'без расширения'}) - работай через run_python"
+
+
+def _tool_write(name: str, content: str) -> str:
+    d = out_dir(create=True)
+    p = _safe(d, name)
+    p.parent.mkdir(parents=True, exist_ok=True)
+    p.write_text(content, encoding="utf-8")
+    return f"записано: {OUT_DIR_NAME}/{p.relative_to(d)}"
+
+
+def _tool_python(code: str, timeout: int = 240) -> str:
+    out = out_dir(create=True)
+    inp = in_dir()
+    before = _snapshot(inp)
+    try:
+        proc = subprocess.run(
+            [sys.executable, "-c", code],
+            cwd=_caller_dir(),
+            capture_output=True,
+            text=True,
+            timeout=timeout,
+        )
+    except subprocess.TimeoutExpired:
+        return f"таймаут {timeout}s - код выполнялся слишком долго"
+    after = _snapshot(inp)
+    notes = []
+    for name in sorted(set(after) - set(before)):
+        try:
+            dest = out / name
+            if dest.exists():
+                dest = out / f"{Path(name).stem}_from_{IN_DIR_NAME}{Path(name).suffix}"
+            shutil.move(str(inp / name), str(dest))
+            notes.append(f"{name} -> {OUT_DIR_NAME}/{dest.name}")
+        except Exception:
+            notes.append(f"не удалось перенести {name}")
+    for name in sorted(set(after) & set(before)):
+        if after[name] != before[name]:
+            notes.append(f"изменён {IN_DIR_NAME}/{name}")
+    res = f"exit={proc.returncode}\nstdout:\n{(proc.stdout or '')[-TOOL_LIMIT:] or '(пусто)'}"
+    err = (proc.stderr or "")[-4000:]
+    if err.strip():
+        res += f"\nstderr:\n{err}"
+    if notes:
+        res += (
+            f"\nВНИМАНИЕ: {IN_DIR_NAME}/ только для чтения. "
+            f"Перенесено в {OUT_DIR_NAME}/: {'; '.join(notes)}"
+        )
+    return res
+
+
+def _dispatch(name: str, args: dict) -> str:
+    try:
+        if name == "list_files":
+            return _tool_list()
+        if name == "read_file":
+            return _tool_read(str(args.get("name", "")))
+        if name == "write_file":
+            return _tool_write(str(args.get("name", "")), str(args.get("content", "")))
+        if name == "run_python":
+            return _tool_python(str(args.get("code", "")))
+        return f"неизвестный инструмент: {name}"
+    except Exception as exc:
+        return f"ОШИБКА: {type(exc).__name__}: {exc}"
+
+
+def run_agent(prompt, model=None, max_steps=MAX_STEPS, verbose=True, trace=None, file_mode=None) -> str:
+    """Обычный промпт -> текст. Промпт про файлы -> цикл с инструментами."""
+    mdl = model or _state["model"]
+    use_tools = is_file_task(prompt, force=file_mode)
+    if trace is not None:
+        trace.clear()
+        trace.update({"file_mode": use_tools, "tools": [], "steps": 0})
+    messages = [
+        {"role": "system", "content": AGENT_SYSTEM if use_tools else CHAT_SYSTEM},
+        {"role": "user", "content": str(prompt)},
+    ]
+    for step in range(1, max_steps + 1):
+        payload = {"model": mdl, "messages": messages}
+        if use_tools:
+            payload["tools"] = TOOLS
+        data = _api(payload)
+        try:
+            msg = data["choices"][0]["message"]
+        except (KeyError, IndexError, TypeError):
+            raise RuntimeError(f"неожиданный ответ: {str(data)[:400]}") from None
+        calls = (msg.get("tool_calls") or []) if use_tools else []
+        if not calls:
+            if trace is not None:
+                trace["steps"] = step
+            return (msg.get("content") or "").strip()
+        messages.append({"role": "assistant", "content": msg.get("content") or "", "tool_calls": calls})
+        for tc in calls:
+            fn = (tc.get("function") or {}).get("name", "?")
+            raw = (tc.get("function") or {}).get("arguments") or "{}"
+            try:
+                args = json.loads(raw)
+            except json.JSONDecodeError:
+                args = {}
+            if trace is not None:
+                trace["tools"].append(fn)
+            if verbose:
+                hint = args.get("name") or str(args.get("code", ""))[:45].replace("\n", " ")
+                print(f"  [{step}] {fn}({hint})")
+            result = _dispatch(fn, args)
+            messages.append({"role": "tool", "tool_call_id": tc.get("id", ""), "content": result[:TOOL_LIMIT]})
+    if trace is not None:
+        trace["steps"] = max_steps
+    return f"агент не уложился в {max_steps} шагов"
+
+
+def pause(prompt: str = PAUSE_TEXT) -> None:
+    """Ждёт Enter. Автоматически не вызывается."""
+    try:
+        input(prompt)
+    except (EOFError, KeyboardInterrupt):
+        print()
+
+
+def interactive(prompt=None, model=None, filename=None, save_answer=True, verbose=True, file_mode=None):
+    """Промпт -> ответ. Файловые задачи: files/ читать, писать только в files2/."""
+    if prompt is None:
+        try:
+            prompt = input(PROMPT).strip()
+        except (EOFError, KeyboardInterrupt):
+            print("\nнет ввода - выход.")
+            return None
+    prompt = str(prompt).strip()
+    if not prompt:
+        print("Пустой промпт - выход.")
+        return None
+    trace = {}
+    print("думаю...")
+    answer = (run_agent(prompt, model=model, verbose=verbose, trace=trace, file_mode=file_mode) or "").strip()
+
+    if not trace.get("file_mode"):
+        print(answer or "(пустой ответ)")
+        return None
+
+    d = out_dir(create=True)
+    target = None
+    if save_answer and answer:
+        target = d / (filename or next_filename(d).name)
+        target.write_text(answer + "\n", encoding="utf-8")
+    produced = sorted(p.name for p in d.iterdir() if p.is_file())
+    print(f"готово. {OUT_DIR_NAME}/: " + (", ".join(produced) if produced else "пусто"))
+    return target
+
+
+class _LibreCodingModule(ModuleType):
+    def __call__(self, obj=None, *args, **kwargs):
+        if callable(obj) and not args and not kwargs:
+            return obj
+        try:
+            if isinstance(obj, str):
+                kwargs["prompt"] = obj
+            return interactive(*args, **kwargs)
+        except Exception as exc:
+            print(f"Ошибка: {exc}", file=sys.stderr)
+            if os.environ.get("LIBRECODING_DEBUG"):
+                raise
+            return None
+
+
+sys.modules[__name__].__class__ = _LibreCodingModule
+
+__all__ = [
+    "greet", "ask", "run_agent", "interactive", "pause", "is_file_task",
+    "in_dir", "out_dir", "ensure_dirs", "next_filename",
+    "set_api_key", "set_model", "get_model",
+]

librecoding-0.6.0/src/librecoding/__init__.py

@@ -1,418 +0,0 @@
-"""librecoding - агент: промпт -> инструменты -> результат в files2/."""
-
-from __future__ import annotations
-
-import json
-import os
-import subprocess
-import sys
-import urllib.error
-import urllib.request
-from pathlib import Path
-from types import ModuleType
-
-from .core import greet
-
-__version__ = "0.6.0"
-
-API_URL = "https://openrouter.ai/api/v1/chat/completions"
-DEFAULT_MODEL = "deepseek/deepseek-v4.1-flash"
-KEY_FILE = Path.home() / ".config" / "librecoding" / "api_key"
-IN_DIR = "files"
-OUT_DIR = "files2"
-PROMPT = "Введи промпт: "
-PAUSE_TEXT = "Нажми Enter, чтобы закрыть..."
-
-MAX_STEPS = 12
-TOOL_LIMIT = 12000
-
-SYSTEM_PROMPT = f"""Ты — автономный агент библиотеки librecoding.
-Рабочая папка — та, где лежит запущенный скрипт.
-
-Структура:
-  {IN_DIR}/   — входные файлы пользователя, только чтение
-  {OUT_DIR}/  — сюда складывай всё, что создаёшь
-
-Инструменты:
-  list_files()              — что есть в {IN_DIR}/
-  read_file(name)           — текст или предпросмотр xlsx/csv
-  write_file(name, content) — записать текстовый файл в {OUT_DIR}/
-  run_python(code)          — выполнить Python-код, cwd = рабочая папка,
-                              openpyxl уже установлен
-
-Правила:
-1. Сначала list_files(), если точные имена файлов неизвестны.
-2. Для xlsx/xls/csv НИКОГДА не выдумывай содержимое — только run_python.
-3. Результат сохраняй в {OUT_DIR}/ с тем же именем, что исходник, если не сказано иначе.
-4. Файлы в {IN_DIR}/ не перезаписывай и не удаляй.
-5. Не задавай уточняющих вопросов — делай разумное предположение и выполняй.
-6. Финальный ответ — коротко по-русски: что сделал, какие файлы создал. Без кода."""
-
-TOOLS = [
-    {
-        "type": "function",
-        "function": {
-            "name": "list_files",
-            "description": f"Показать файлы во входной папке {IN_DIR}/.",
-            "parameters": {"type": "object", "properties": {}, "required": []},
-        },
-    },
-    {
-        "type": "function",
-        "function": {
-            "name": "read_file",
-            "description": f"Прочитать файл из {IN_DIR}/ (текст или предпросмотр таблицы).",
-            "parameters": {
-                "type": "object",
-                "properties": {"name": {"type": "string", "description": "имя файла в files/"}},
-                "required": ["name"],
-            },
-        },
-    },
-    {
-        "type": "function",
-        "function": {
-            "name": "write_file",
-            "description": f"Записать текстовый файл в {OUT_DIR}/.",
-            "parameters": {
-                "type": "object",
-                "properties": {
-                    "name": {"type": "string"},
-                    "content": {"type": "string"},
-                },
-                "required": ["name", "content"],
-            },
-        },
-    },
-    {
-        "type": "function",
-        "function": {
-            "name": "run_python",
-            "description": (
-                "Выполнить Python-код в рабочей папке (cwd). Относительные пути: "
-                f"'{IN_DIR}/...' и '{OUT_DIR}/...'. openpyxl установлен. "
-                f"Результаты сохраняй в {OUT_DIR}/. Возвращает stdout/stderr."
-            ),
-            "parameters": {
-                "type": "object",
-                "properties": {"code": {"type": "string"}},
-                "required": ["code"],
-            },
-        },
-    },
-]
-
-_state = {"key": None, "model": DEFAULT_MODEL}
-
-
-# --- настройки ----------------------------------------------------------
-
-def set_api_key(key: str) -> None:
-    """Задать ключ OpenRouter на время работы процесса."""
-    _state["key"] = key.strip()
-
-
-def set_model(model: str) -> None:
-    """Сменить модель, например 'deepseek/deepseek-chat'."""
-    _state["model"] = model
-
-
-def get_model() -> str:
-    return _state["model"]
-
-
-def _api_key() -> str:
-    """Ключ: set_api_key() -> OPENROUTER_API_KEY -> ~/.config/librecoding/api_key."""
-    if _state["key"]:
-        return _state["key"]
-    env = os.environ.get("OPENROUTER_API_KEY", "").strip()
-    if env:
-        return env
-    if KEY_FILE.is_file():
-        for line in KEY_FILE.read_text(encoding="utf-8").splitlines():
-            line = line.strip()
-            if line and not line.startswith("#"):
-                return line
-    raise RuntimeError(
-        "API-ключ OpenRouter не найден. Задай его так:\n"
-        f"  echo 'sk-or-v1-...' > {KEY_FILE}\n"
-        f"  chmod 600 {KEY_FILE}\n"
-        "  либо: export OPENROUTER_API_KEY=sk-or-v1-...\n"
-        "  либо: librecoding.set_api_key('sk-or-v1-...')"
-    )
-
-
-# --- пути ---------------------------------------------------------------
-
-def _caller_dir() -> Path:
-    """Папка запущенного скрипта (test.py), а не библиотеки."""
-    path = getattr(sys.modules.get("__main__"), "__file__", None)
-    if path:
-        return Path(path).resolve().parent
-    if sys.argv and sys.argv[0]:
-        return Path(sys.argv[0]).resolve().parent
-    return Path.cwd()
-
-
-def ensure_dirs() -> tuple[Path, Path]:
-    """Создать files/ и files2/ рядом со скриптом. Вернуть (in_dir, out_dir)."""
-    base = _caller_dir()
-    in_dir, out_dir = base / IN_DIR, base / OUT_DIR
-    in_dir.mkdir(parents=True, exist_ok=True)
-    out_dir.mkdir(parents=True, exist_ok=True)
-    return in_dir, out_dir
-
-
-def _safe(base: Path, name: str) -> Path:
-    """Не дать выйти за пределы папки через ../ или абсолютный путь."""
-    base = base.resolve()
-    p = (base / name).resolve()
-    if base != p and base not in p.parents:
-        raise ValueError(f"путь вне папки: {name}")
-    return p
-
-
-def next_filename(directory=None) -> Path:
-    """Следующее имя 1.txt, 2.txt, 3.txt ... (максимум + 1)."""
-    base = Path(directory) if directory else ensure_dirs()[1]
-    nums = [int(p.stem) for p in base.glob("*.txt") if p.stem.isdigit()]
-    return base / f"{max(nums, default=0) + 1}.txt"
-
-
-# --- сеть ---------------------------------------------------------------
-
-def _api(payload: dict, timeout: int = 300) -> dict:
-    req = urllib.request.Request(
-        API_URL,
-        data=json.dumps(payload).encode("utf-8"),
-        headers={
-            "Authorization": f"Bearer {_api_key()}",
-            "Content-Type": "application/json",
-            "HTTP-Referer": "https://pypi.org/project/librecoding/",
-            "X-Title": "librecoding",
-        },
-        method="POST",
-    )
-    try:
-        with urllib.request.urlopen(req, timeout=timeout) as resp:
-            return json.loads(resp.read().decode("utf-8"))
-    except urllib.error.HTTPError as exc:
-        body = exc.read().decode("utf-8", "replace")[:400]
-        raise RuntimeError(f"OpenRouter HTTP {exc.code}: {body}") from None
-    except urllib.error.URLError as exc:
-        raise RuntimeError(f"нет сети / таймаут: {exc.reason}") from None
-
-
-def ask(prompt, model=None, temperature=0.7, timeout=300) -> str:
-    """Один запрос без инструментов. Возвращает текст ответа."""
-    data = _api(
-        {
-            "model": model or _state["model"],
-            "messages": [{"role": "user", "content": prompt}],
-            "temperature": temperature,
-        },
-        timeout=timeout,
-    )
-    try:
-        return data["choices"][0]["message"]["content"] or ""
-    except (KeyError, IndexError, TypeError):
-        raise RuntimeError(f"неожиданный ответ: {str(data)[:400]}") from None
-
-
-# --- инструменты --------------------------------------------------------
-
-def _tool_list() -> str:
-    in_dir, _ = ensure_dirs()
-    files = sorted(p for p in in_dir.iterdir() if p.is_file())
-    if not files:
-        return f"{IN_DIR}/ пуста"
-    return f"файлы в {IN_DIR}/:\n" + "\n".join(
-        f"  {p.name} ({p.stat().st_size} байт)" for p in files
-    )
-
-
-def _tool_read(name: str) -> str:
-    in_dir, _ = ensure_dirs()
-    p = _safe(in_dir, name)
-    if not p.is_file():
-        return f"нет файла {name}. Список: {[q.name for q in in_dir.iterdir() if q.is_file()]}"
-
-    suffix = p.suffix.lower()
-    if suffix in {".xlsx", ".xlsm"}:
-        try:
-            from openpyxl import load_workbook
-        except ImportError:
-            return "openpyxl недоступен — используй run_python"
-        wb = load_workbook(p, read_only=True, data_only=True)
-        parts = []
-        for ws in wb.worksheets[:3]:
-            parts.append(f"--- лист '{ws.title}' ---")
-            for row in ws.iter_rows(min_row=1, max_row=min(ws.max_row or 0, 15), values_only=True):
-                parts.append(" | ".join("" if c is None else str(c) for c in row))
-        wb.close()
-        return "\n".join(parts)[:TOOL_LIMIT]
-
-    if suffix in {".csv", ".tsv", ".txt", ".md", ".json", ".py", ".log", ".xml", ".yml", ".yaml"}:
-        text = p.read_text(encoding="utf-8", errors="replace")
-        if len(text) > TOOL_LIMIT:
-            return text[:TOOL_LIMIT] + "\n...[обрезано]"
-        return text
-
-    return f"бинарный файл ({suffix or 'без расширения'}) — работай с ним через run_python"
-
-
-def _tool_write(name: str, content: str) -> str:
-    _, out_dir = ensure_dirs()
-    p = _safe(out_dir, name)
-    p.parent.mkdir(parents=True, exist_ok=True)
-    p.write_text(content, encoding="utf-8")
-    return f"записано: {OUT_DIR}/{p.relative_to(out_dir)}"
-
-
-def _tool_python(code: str, timeout: int = 180) -> str:
-    try:
-        proc = subprocess.run(
-            [sys.executable, "-c", code],
-            cwd=_caller_dir(),
-            capture_output=True,
-            text=True,
-            timeout=timeout,
-        )
-    except subprocess.TimeoutExpired:
-        return f"таймаут {timeout}s — код выполнялся слишком долго"
-    out = (proc.stdout or "")[-TOOL_LIMIT:]
-    err = (proc.stderr or "")[-4000:]
-    res = f"exit={proc.returncode}\nstdout:\n{out or '(пусто)'}"
-    if err.strip():
-        res += f"\nstderr:\n{err}"
-    return res
-
-
-def _dispatch(name: str, args: dict) -> str:
-    try:
-        if name == "list_files":
-            return _tool_list()
-        if name == "read_file":
-            return _tool_read(str(args.get("name", "")))
-        if name == "write_file":
-            return _tool_write(str(args.get("name", "")), str(args.get("content", "")))
-        if name == "run_python":
-            return _tool_python(str(args.get("code", "")))
-        return f"неизвестный инструмент: {name}"
-    except Exception as exc:
-        return f"ОШИБКА: {type(exc).__name__}: {exc}"
-
-
-# --- агент --------------------------------------------------------------
-
-def run_agent(prompt: str, model=None, max_steps=MAX_STEPS, verbose=True) -> str:
-    """Цикл: модель -> инструменты -> ответ. Возвращает финальный текст."""
-    mdl = model or _state["model"]
-    messages = [
-        {"role": "system", "content": SYSTEM_PROMPT},
-        {"role": "user", "content": prompt},
-    ]
-
-    for step in range(1, max_steps + 1):
-        data = _api({"model": mdl, "messages": messages, "tools": TOOLS})
-        try:
-            msg = data["choices"][0]["message"]
-        except (KeyError, IndexError, TypeError):
-            raise RuntimeError(f"неожиданный ответ: {str(data)[:400]}") from None
-
-        calls = msg.get("tool_calls") or []
-        if not calls:
-            return (msg.get("content") or "").strip()
-
-        assistant = {"role": "assistant", "content": msg.get("content") or ""}
-        assistant["tool_calls"] = calls
-        messages.append(assistant)
-
-        for tc in calls:
-            fn = (tc.get("function") or {}).get("name", "?")
-            raw = (tc.get("function") or {}).get("arguments") or "{}"
-            try:
-                args = json.loads(raw)
-            except json.JSONDecodeError:
-                args = {}
-            if verbose:
-                hint = args.get("name") or str(args.get("code", ""))[:45].replace("\n", " ")
-                print(f"  [{step}] {fn}({hint})")
-            result = _dispatch(fn, args)
-            messages.append(
-                {
-                    "role": "tool",
-                    "tool_call_id": tc.get("id", ""),
-                    "content": result[:TOOL_LIMIT],
-                }
-            )
-
-    return f"агент не уложился в {max_steps} шагов"
-
-
-# --- ввод/вывод ---------------------------------------------------------
-
-def pause(prompt: str = PAUSE_TEXT) -> None:
-    """Ждёт Enter. Больше не вызывается автоматом, оставлена для ручного использования."""
-    if not sys.stdin.isatty():
-        return
-    try:
-        input(prompt)
-    except (EOFError, KeyboardInterrupt):
-        print()
-
-
-def interactive(prompt=None, model=None, filename=None, save_answer=True, verbose=True):
-    """Создать files/ и files2/, принять промпт, выполнить агента, сохранить ответ в files2/N.txt."""
-    in_dir, out_dir = ensure_dirs()
-
-    if prompt is None:
-        if not sys.stdin.isatty():
-            raise RuntimeError("нужен интерактивный терминал или аргумент prompt")
-        try:
-            prompt = input(PROMPT).strip()
-        except (EOFError, KeyboardInterrupt):
-            print()
-            return None
-
-    prompt = str(prompt).strip()
-    if not prompt:
-        print("Пустой промпт — выход.")
-        return None
-
-    print(f"думаю... ({model or _state['model']})")
-    answer = run_agent(prompt, model=model, verbose=verbose)
-
-    target = None
-    if save_answer and answer:
-        target = out_dir / (filename or next_filename(out_dir).name)
-        target.write_text(answer + "\n", encoding="utf-8")
-
-    produced = sorted(p.name for p in out_dir.iterdir() if p.is_file())
-    print(f"готово. {OUT_DIR}/: {', '.join(produced) if produced else 'пусто'}")
-    return target
-
-
-# --- магия: модуль, который можно вызвать -------------------------------
-
-class _LibreCodingModule(ModuleType):
-    def __call__(self, obj=None, *args, **kwargs):
-        if callable(obj) and not args and not kwargs:
-            return obj                      # @librecoding -> режим декоратора
-        try:
-            if isinstance(obj, str):        # librecoding("готовый промпт")
-                kwargs["prompt"] = obj
-            return interactive(*args, **kwargs)
-        except Exception as exc:
-            print(f"Ошибка: {exc}", file=sys.stderr)
-            if os.environ.get("LIBRECODING_DEBUG"):
-                raise
-            return None
-
-
-sys.modules[__name__].__class__ = _LibreCodingModule
-
-__all__ = [
-    "greet", "ask", "run_agent", "interactive", "pause", "ensure_dirs", "next_filename",
-    "set_api_key", "set_model", "get_model",
-]