zai-cli 0.1.0__tar.gz

zai_cli-0.1.0/CHANGELOG.md

@@ -0,0 +1,94 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and the project uses [Semantic Versioning](https://semver.org/).
+
+## [0.1.0] - 2026-06-23
+
+### Added
+
+- General DuckDuckGo HTML search adapter with structured results and bounded
+  response handling.
+- Ruff, MyPy, and dependency-audit CI gates.
+- A single package-version source in `zai/__init__.py`.
+- Installed-wheel smoke tests across Linux, Windows, and macOS.
+- Concurrent session persistence and invalid-schema recovery tests.
+- Python 3.14 CI coverage and expanded MyPy checks for persistence modules.
+- Deterministic streaming tests for six provider transports and HTTP status
+  validation for Ollama and OpenRouter streams.
+- Vision input verification with 10 MB and 40-megapixel limits, plus explicit
+  Gemini-to-Groq fallback diagnostics.
+- File/code execution through the active Python interpreter and deterministic
+  watch-mode lifecycle, filtering, and cooldown tests.
+- Command-level coverage for built-in/plugin skills and Git status, log, diff,
+  commit, and review workflows.
+- Command-level coverage for search, files, execution, repository questions,
+  vision, and browser utilities.
+- Command-level coverage for MCP, plugin, and hook integration management.
+- Command-level coverage for setup, models, memory, sessions, and undo
+  management.
+- Release preflight checks for version/changelog consistency, built-in command
+  package data, artifact names/content, and a mandatory real repository URL
+  before publication.
+- Verified project, issue tracker, and changelog URLs in package metadata.
+- User-defined model aliases with validated provider transports, model IDs,
+  context windows, interactive completion, and fallback support.
+- `zai model add`, `remove`, `info`, and `test` commands, plus configuration
+  schema migration.
+- `zai model configure` with per-model timeout and retry policies for built-in
+  and custom aliases, normalized under configuration schema version 3.
+- Normalized provider failures for authentication, quota, missing models,
+  timeout, network, and malformed responses, with the final fallback failure
+  retained in the user-facing error.
+- Provider/model identity in successful chat, agent, and repository outputs.
+- Global `--debug` traceback diagnostics and `--plain` non-streaming one-shot
+  output for scripts and CI.
+- Cooperative cancellation tokens across provider fallback, agent turns,
+  subprocess execution, MCP requests, and plugin tool boundaries.
+- Opt-in live integration coverage for provider-native tool calls, browser
+  screenshots, and filesystem MCP tool execution.
+- The `zai-cli` distribution while retaining the `zai` command and Python
+  import package.
+- Interactive and one-off AI chat with configurable provider fallback.
+- Project-scoped file tools, command execution, repository maps, and context
+  management.
+- Persistent sessions with search, rename, delete, resume, and Markdown/JSON
+  export.
+- Inspectable multi-step undo, redo, retention limits, and conflict detection.
+- Built-in skills, hooks, MCP integrations, and fingerprint-trusted plugins.
+- Public-web browser automation with SSRF and filesystem boundary checks.
+- Persistent terminal history, completion, multiline input, and cancellation.
+
+### Security
+
+- Required validated plugin manifests and allowlisted permission declarations
+  before local or packaged plugin code can load.
+- Bound plugin trust fingerprints to both code and manifest content, and added
+  explicit install/enable confirmations.
+- Disabled browser downloads and rejected oversized top-level browser
+  documents when their declared size exceeds 2 MB.
+- Limited web-search responses to 1 MB.
+- Restricted model-controlled filesystem writes to the active project.
+- Validated native tool-call schemas and retained legacy compatibility.
+- Executed commands without a shell and blocked destructive command patterns.
+- Prevented implicit plugin execution and unsafe browser destinations.
+
+### Known limitations
+
+- Live provider, browser, and MCP checks require external credentials or
+  services and are not part of the default test suite.
+- Browser automation requires Playwright and a separately installed Chromium
+  browser.
+- Cooperative cancellation depends on provider SDK support.
+- TestPyPI and PyPI publication require ownership of the selected package name
+  and configured trusted-publishing environments.
+
+### Validation
+
+- 440 non-live tests pass with a 75% CI coverage floor.
+- Python 3.10 through 3.14 are covered by CI.
+- Wheel and source distributions pass Twine metadata validation.
+- Live Groq chat/tool calls, DuckDuckGo search, Playwright scrape/screenshot,
+  and filesystem MCP tool execution pass on Windows.

zai_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 zai contributors
+
+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.

zai_cli-0.1.0/MANIFEST.in

@@ -0,0 +1,2 @@
+include CHANGELOG.md
+include scripts/release_preflight.py