autokeren 0.1.0__tar.gz

autokeren-0.1.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,48 @@
+---
+name: Bug report
+about: Laporkan bug untuk membantu kami memperbaikinya
+title: "[BUG] "
+labels: bug
+assignees: ""
+---
+
+## Deskripsi bug
+
+Deskripsi singkat dan jelas mengenai bug tersebut.
+
+## Langkah reproduksi
+
+1. Jalankan '...'
+2. Masukkan '...'
+3. Lihat error
+
+## Perilaku yang diharapkan
+
+Deskripsi perilaku yang seharusnya terjadi.
+
+## Perilaku aktual
+
+Deskripsi perilaku yang terjadi.
+
+## Environment
+
+- OS: [mis. Ubuntu 24.04]
+- Python version: [mis. 3.12.4]
+- autokeren version: [mis. 0.1.0]
+- Cara install: [pip / dari source]
+
+## Konfigurasi
+
+```yaml
+# Tempel config.yaml yang relevan (HAPUS api_token dan account_id sebelum mengirim)
+```
+
+## Log / Output
+
+```
+Tempel output atau pesan error di sini
+```
+
+## Konteks tambahan
+
+Informasi lain yang relevan.

autokeren-0.1.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,27 @@
+---
+name: Feature request
+about: Usulkan fitur atau peningkatan untuk autokeren
+title: "[FEAT] "
+labels: enhancement
+assignees: ""
+---
+
+## Ringkasan fitur
+
+Deskripsi singkat fitur yang diusulkan.
+
+## Motivasi
+
+Mengapa fitur ini dibutuhkan? Masalah apa yang dipecahkan atau diperbaiki?
+
+## Solusi yang diusulkan
+
+Deskripsikan bagaimana fitur ini seharusnya bekerja.
+
+## Alternatif yang dipertimbangkan
+
+Alternatif lain yang sudah dipertimbangkan dan alasannya.
+
+## Konteks tambahan
+
+Screenshot, mockup, referensi, atau informasi lain yang relevan.

autokeren-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,28 @@
+## Deskripsi
+
+Deskripsi singkat mengenai perubahan pada pull request ini.
+
+## Tipe perubahan
+
+- [ ] Bug fix (non-breaking change yang memperbaiki issue)
+- [ ] Fitur baru (non-breaking change yang menambah fitur)
+- [ ] Breaking change (perubahan yang menyebabkan fitur eksisting tidak kompatibel)
+- [ ] Dokumentasi
+- [ ] Refactor / chore
+
+## Checklist
+
+- [ ] Kode mengikuti style guide (`ruff check .` bersih)
+- [ ] Type checking lolos (`mypy autokeren`)
+- [ ] Test ditambahkan untuk perubahan baru
+- [ ] Semua test lolos (`pytest`)
+- [ ] Dokumentasi diperbarui bila perlu (README, CHANGELOG, AGENTS.md)
+- [ ] Tidak ada credentials/token yang ter-commit
+
+## Testing
+
+Deskripsikan bagaimana perubahan ini diuji.
+
+## Issue terkait
+
+Closes #<issue-number>

autokeren-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,36 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint-and-test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Lint with ruff
+        run: ruff check .
+
+      - name: Type check with mypy
+        run: mypy autokeren
+
+      - name: Test with pytest
+        run: pytest -q

autokeren-0.1.0/.gitignore

@@ -0,0 +1,71 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+env/
+venv/
+ENV/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Secrets / runtime config
+*.secret
+*.key
+*.pem
+.env
+.env.*
+*.env
+config.yaml
+!config.example.yaml
+
+# Logs
+*.log
+logs/
+
+# Coverage / test artifacts
+.coverage
+htmlcov/
+.pytest_cache/
+.mypy_cache/
+
+# Private docs (internal only, jangan push ke public repo)
+docs/private/
+
+# Signing module (internal only, exclude dari open source)
+autokeren/signing.py
+
+# Test artifacts / generated workers
+*.worker.js
+*-worker.js
+worker.js
+worker.js.bak-*
+toko-*/

autokeren-0.1.0/AGENTS.md

@@ -0,0 +1,81 @@
+# AGENTS.md
+
+Panduan untuk AI agent yang bekerja di codebase autokeren.
+
+## Project Overview
+
+autokeren adalah Cloudflare-first agentic coding CLI yang dibangun dengan Python. Agent loop membaca input user, memanggil model Cloudflare Workers AI (Kimi K2.7-Code primary, GLM 5.2 secondary), mengeksekusi tool calls, dan mengembalikan hasil sampai task selesai. Dirancang untuk stack Cloudflare-first dengan tools native untuk KV, D1, Pages/Workers deploy, Camofox e2e, dan tmux supervision.
+
+## Tech Stack
+
+- Python 3.11+
+- `httpx` untuk HTTP/2 streaming ke Cloudflare Workers AI
+- `rich` untuk terminal UI
+- `pydantic` untuk config dan tool schemas
+- `pyyaml` / `strictyaml` untuk config YAML
+- `pyfiglet` untuk banner
+- standard library untuk core tools (pathlib, subprocess, re, hashlib)
+
+## Code Conventions
+
+- **ruff** dengan `line-length = 120`.
+- **mypy** strict. Semua code baru harus type-safe.
+- **Tidak menambahkan komentar kode** kecuali diminta eksplisit.
+- **UI text dalam Bahasa Indonesia** mengikuti konvensi yang sudah ada (pesan error, deskripsi tool, output command).
+- Gunakan `from __future__ import annotations` di modul yang memakai type hints modern.
+- Konvensi commit: Conventional Commits (`feat:`, `fix:`, `docs:`, `test:`, `chore:`).
+
+## Architecture
+
+Modul inti dan tanggung jawabnya:
+
+| Modul | Tanggung Jawab |
+|---|---|
+| `agent.py` | Core agentic loop: model call, tool dispatch, iterasi sampai selesai |
+| `cli.py` | Entry point, argument parsing, slash-command dispatch, interactive REPL |
+| `config.py` | Load + validasi `config.yaml` (pydantic) |
+| `context.py` | Session memory: simpan pesan, track token usage vs context window |
+| `memory.py` | Cross-session persistent memory per-project (`memory.md`) |
+| `session.py` | Save/resume session state ke disk |
+| `prompts.py` | Build system prompt (AGENTS.md, memory, tool schemas) |
+| `ui.py` | Rich-based terminal UI: panel, streaming, status, banner |
+| `utils.py` | Helper: redact, sanitize_filename, is_dangerous_command, human_size |
+| `models/` | Cloudflare AI client (`cloudflare.py`), router/fallback (`router.py`), retry + circuit breaker (`retry.py`) |
+| `tools/` | `base.py` (Tool ABC + ToolResult + ToolRegistry), 18 tool implementasi |
+
+### Tool System
+
+Setiap tool mewarisi `Tool` (ABC) di `autokeren/tools/base.py` dengan atribut:
+
+- `name`, `description`, `parameters` (JSON schema), `requires_permission`
+- `run(**kwargs) -> ToolResult`
+- `needs_permission(**kwargs)` dan `permission_desc(**kwargs)` untuk dynamic permission
+
+`ToolRegistry` mengelola registrasi, lookup, schema generation, permission check, dan eksekusi dengan error handling.
+
+### Model Layer
+
+`models/cloudflare.py` — HTTP client ke Workers AI dengan streaming.
+`models/router.py` — pilih primary/secondary model, fallback otomatis.
+`models/retry.py` — exponential backoff + circuit breaker.
+
+## Testing
+
+- Framework: `pytest`.
+- Tests harus cepat dan **tanpa external API call**. Mock network bila perlu.
+- Gunakan `tmp_path` + `monkeypatch` untuk isolasi filesystem dan env var (mis. `AUTOKEREN_CONFIG_DIR` untuk `MemoryManager`).
+- Sebelum commit, ketiga command berikut harus lolos:
+
+```bash
+ruff check .
+mypy autokeren
+pytest
+```
+
+## Aturan Penting
+
+- **Jangan pernah mengubah signature tool yang sudah ada** tanpa pertimbangan matang. Agent dan config bergantung pada `name`, `parameters`, dan `run` kwargs.
+- **Selalu jalankan `ruff check .` dan `mypy autokeren`** setelah mengubah code. Keduanya harus bersih.
+- Saat menambah tool baru, daftarkan di `autokeren/tools/__init__.py` dan tambahkan ke `__all__`.
+- Jangan hardcode credentials. Baca dari config atau env var (`CLOUDFLARE_ACCOUNT_ID`, `CLOUDFLARE_API_TOKEN`).
+- Gunakan `redact()` dari `autokeren.utils` saat mencetak token/API key.

autokeren-0.1.0/CHANGELOG.md

@@ -0,0 +1,37 @@
+# Changelog
+
+Semua perubahan penting pada autokeren didokumentasikan di sini.
+
+Format berdasarkan [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), dan project mengikuti [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-07-04
+
+### Added
+
+- Initial release.
+- Core agentic loop (`agent.py`) dengan multi-iteration tool dispatch.
+- Cloudflare Workers AI client dengan HTTP/2 streaming output.
+- Multi-model fallback otomatis: Kimi K2.7-Code (primary) dan GLM 5.2 (secondary).
+- Retry dengan exponential backoff, jitter, dan circuit breaker.
+- Permission system dengan shell allowlist dan dangerous-command blocklist.
+- Cross-session memory per-project (`MemoryManager` + `remember` tool).
+- Session save/resume (`session.py`, perintah `/save` dan `/resume`).
+- Context tracking dengan token usage dan perintah `/compact` (manual + auto-compact).
+- AGENTS.md support: instruksi per-project dimuat otomatis ke system prompt.
+- Indonesian localization untuk seluruh UI text.
+- 18 tools bawaan:
+  - File: `read_file`, `write_file`, `patch_file`, `list_files`
+  - Shell: `run_shell`
+  - Search: `search_code`
+  - Web: `fetch_url`
+  - Git: `git_status`, `git_diff`, `git_commit`
+  - Cloudflare: `cf_deploy`, `cf_build_next`, `cf_kv`, `cf_d1`
+  - Camofox: `camofox` (browser e2e automation)
+  - Tmux: `tmux` (long-running supervisor)
+  - Productivity: `todo`, `remember`
+- Slash commands: `/help`, `/q`, `/status`, `/compact`, `/reset`, `/memory`, `/save`, `/resume`, `/sessions`.
+- Rich-based terminal UI dengan banner, panel, dan streaming.
+- Transparent YAML config (`config.example.yaml`).
+- PyPI packaging via hatchling.
+
+[0.1.0]: https://github.com/autokeren/autokeren/releases/tag/v0.1.0

autokeren-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,100 @@
+# Contributing to autokeren
+
+Terima kasih sudah tertarik berkontribusi ke autokeren. Dokumen ini menjelaskan cara setup environment, code style, dan proses pull request.
+
+## Setup Development Environment
+
+Prasyarat: Python 3.11+ dan git.
+
+```bash
+git clone https://github.com/autokeren/autokeren.git
+cd autokeren
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev]"
+```
+
+Verifikasi instalasi:
+
+```bash
+autokeren --help
+```
+
+## Code Style
+
+- **ruff** untuk linting dan formatting, dengan `line-length = 120`.
+- **mypy** untuk type checking (mode strict dianjurkan).
+- Tidak menambahkan komentar kode kecuali diminta.
+- UI text dalam Bahasa Indonesia mengikuti konvensi yang sudah ada.
+
+## Linting & Type Checking
+
+Jalankan sebelum commit:
+
+```bash
+ruff check .
+mypy autokeren
+```
+
+## Menjalankan Tests
+
+```bash
+pytest
+```
+
+Tests harus cepat dan tidak memanggil external API. Gunakan `tmp_path` dan `monkeypatch` untuk isolasi filesystem dan environment.
+
+## Commit Message Convention
+
+Gunakan [Conventional Commits](https://www.conventionalcommits.org/):
+
+- `feat:` fitur baru
+- `fix:` perbaikan bug
+- `docs:` perubahan dokumentasi
+- `test:` penambahan/perbaikan test
+- `chore:` maintenance, dependency update, config
+- `refactor:` refactor tanpa perubahan perilaku
+
+Contoh:
+
+```
+feat: tambah tool cf_kv untuk baca/tulis Cloudflare KV
+fix: streaming text di dalam Panel bukan plain text
+docs: perbarui README dengan commands reference
+```
+
+## Pull Request Process
+
+1. Fork repository dan buat branch dari `main` (`feat/nama-fitur` atau `fix/desc-bug`).
+2. Pastikan `ruff check .`, `mypy autokeren`, dan `pytest` lolos.
+3. Tulis test untuk perubahan baru bila memungkinkan.
+4. Update dokumentasi (README, CHANGELOG) bila perilaku pengguna berubah.
+5. Buat pull request dengan deskripsi jelas mengenai apa yang diubah dan mengapa.
+6. Pastikan CI hijau sebelum review.
+
+## Project Structure
+
+```
+autokeren/
+├── autokeren/
+│   ├── agent.py          # core agentic loop
+│   ├── cli.py            # entry point + command parsing
+│   ├── config.py         # YAML config loader (pydantic)
+│   ├── context.py        # session memory + token tracking
+│   ├── memory.py         # cross-session persistent memory
+│   ├── prompts.py        # system prompt builder
+│   ├── session.py        # save/resume sessions
+│   ├── ui.py             # rich terminal UI
+│   ├── utils.py          # small helpers
+│   ├── models/           # Cloudflare AI client + router + retry
+│   └── tools/            # Tool base + registry + 18 tools
+├── tests/
+├── docs/
+│   └── ARCHITECTURE.md
+├── pyproject.toml
+└── README.md
+```
+
+## Pertanyaan?
+
+Buka [issue](https://github.com/autokeren/autokeren/issues) untuk diskusi sebelum mengerjakan fitur besar.

autokeren-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Autokeren
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.