seedcode-cli 7.2.5__tar.gz → 8.2.5__tar.gz

{seedcode_cli-7.2.5 → seedcode_cli-8.2.5}/.gitignore

@@ -73,4 +73,3 @@ opencode.txt
 V6.2.0/
 newupdatec6.2.5/
 WEBSITE/
-.venv-disttest/

{seedcode_cli-7.2.5 → seedcode_cli-8.2.5}/LICENSE

@@ -80,3 +80,11 @@ Your company is any legal entity, sole proprietorship, or other kind of organiza
 Your licenses are all the licenses granted to you for the software under these terms.
 
 Use means anything you do with the software requiring one of your licenses.
+
+
+______________
+
+
+
+
+Copyright © 2026 Al Shahriar Sowan

{seedcode_cli-7.2.5 → seedcode_cli-8.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: seedcode-cli
-Version: 7.2.5
+Version: 8.2.5
 Summary: Seed Code — a premium terminal-based AI coding assistant. Plant ideas. Grow code.
 Project-URL: Homepage, https://github.com/Alshahriar-07/seedcode-cli
 Project-URL: Repository, https://github.com/Alshahriar-07/seedcode-cli
@@ -54,10 +54,21 @@ Description-Content-Type: text/markdown
 > ### Faster. Smaller. Smarter. Workspace-aware.
 > *Plant ideas. Grow code.*
 
-Seed Code is a premium terminal-based AI coding assistant. v7.2.5 pairs
-streaming chat and permission-gated desktop control with **Code Mode** — a
-workspace-aware coding agent backed by persistent `.seedcode` project memory
-— behind the Seed Code startup logo and a compact block of live session state.
+Seed Code is a premium terminal-based AI coding assistant and task runner.
+v8.2.5 exposes exactly **two modes** — **Chat Mode** and **Agent Mode** — over a
+multi-provider, multi-model engine, behind the Seed Code startup logo and a
+compact block of live session state.
+
+| Mode | What it does |
+| --- | --- |
+| **Chat Mode** | Conversation: questions, explanations, brainstorming. Never acts on your project. |
+| **Agent Mode** | The unified autonomous workspace/coding agent: inspect, plan, edit, run, verify and keep working until the task is verified, using every available tool. |
+
+The retired **Code Mode** and **Assist Mode** are no longer separate modes;
+their capabilities now belong to Agent Mode. Agent Mode automatically activates
+the workspace coding capability (`.seedcode` project memory + index, the
+plan → execute → verify session loop). `/codemode`, `/assist` and `/desktop`
+remain accepted aliases, but nothing in the UI presents a third mode.
 
 - **Providers:** choose **OpenRouter**, **Ollama** (started automatically when
   you select it), or any number of your own **Custom** OpenAI-compatible
@@ -66,13 +77,25 @@ workspace-aware coding agent backed by persistent `.seedcode` project memory
 - **Reliable by design:** provider health is tracked, a failing request fails
   over to the next healthy provider without restarting the task, and a lost
   connection pauses the session instead of failing it.
-- **Professional startup screen:** the Seed Code ANSI logo with the live
-  provider, model, mode and status beneath it, behind a responsive bordered
-  panel, with an ASCII fallback for consoles that cannot draw the block art.
-- **Step-by-step tasks:** Code, Assist and Agent Mode show a live task flow
-  (analyze → inspect → plan → implement → test → verify) that reflects what
-  the agent really did, and hands the prompt back when the task ends.
-- **Version:** 7.2.5 (`seedcode --version`)
+- **Seed Code ASCII logo, preserved:** the fixed header leads with the exact
+  Seed Code block logo and tagline, followed by the live Provider / Model /
+  Mode / Status / Workspace / Context / key state. The header is never
+  reprinted — every value updates in place the moment it changes — and the
+  branding is never replaced by plain text or clipped to fit.
+- **Professional message composer:** the fixed bottom region carries the
+  `You >` prompt, which is display only and never part of the message itself.
+  Multiline input keeps its continuations aligned under the prompt, `Enter`
+  sends, `Shift+Enter` inserts a newline, and history, paste, long prompts,
+  Unicode and terminal resize all work.
+- **`AI > ◌ Thinking…` before every answer:** a lightweight animated indicator
+  appears the instant you send a message and is replaced by streaming output.
+  It is a UI state only — it never blocks or delays the agent.
+- **Live activity, no checklist:** Agent Mode decides its own execution
+  sequence and shows an activity stream (`AI > ⚙ Running pytest`,
+  `AI > ✓ Tests passed`) whose lines appear only when the underlying operation
+  really starts. There is no manual to-do list to create or manage, and
+  completing a task never closes the application.
+- **Version:** 8.2.5 (`seedcode --version`)
 
 ## Installation
 
@@ -86,7 +109,6 @@ seedcode
 
 ```bash
 pip install seedcode-cli
-seedcode
 ```
 
 Requires **Python 3.10 or newer**. The wheel exposes the `seedcode` console
@@ -132,8 +154,8 @@ Python required) and both run the same CLI:
 
 | Download | What it is |
 | --- | --- |
-| `SeedCode-CLI-Setup-7.2.5.exe` | **Setup installer (recommended).** A wizard that installs to Program Files, adds Seed Code to the system `PATH`, creates a Start Menu shortcut with an optional desktop shortcut, verifies the installation before reporting success, and ships a clean uninstaller that never deletes your project data silently. |
-| `SeedCode-CLI-7.2.5-windows-x64.exe` | **Standalone executable.** A single portable `seedcode.exe` — no installation and no admin rights. The Windows IRM installer above downloads exactly this file. Run it directly from wherever you put it. |
+| `SeedCode-CLI-Setup-8.2.5.exe` | **Setup installer (recommended).** A wizard that installs to Program Files, adds Seed Code to the system `PATH`, creates a Start Menu shortcut with an optional desktop shortcut, verifies the installation before reporting success, and ships a clean uninstaller that never deletes your project data silently. |
+| `SeedCode-CLI-8.2.5-windows-x64.exe` | **Standalone executable.** A single portable `seedcode.exe` — no installation and no admin rights. The Windows IRM installer above downloads exactly this file. Run it directly from wherever you put it. |
 
 Both are published on the
 [Releases page](https://github.com/Alshahriar-07/seedcode-cli/releases) with
@@ -142,7 +164,7 @@ their SHA256 in `SHA256SUMS.txt`.
 After installing by any route:
 
 ```bash
-seedcode --version    # -> Seed Code CLI 7.2.5
+seedcode --version    # -> Seed Code CLI 8.2.5
 ```
 
 > **`seedcode` not recognized?** Open a *new* terminal. `PATH` changes only
@@ -165,31 +187,85 @@ seedcode
 seedcode
 ```
 
-You land on the Seed Code dashboard — the structured startup panel: branding
-on the left, a divider, and the live session state on the right. The ASCII
-logo is permanently gone (the brand is plain text); the layout, sections and
-status indicators stay:
+You land in the persistent Seed Code workspace: a fixed header carrying the
+Seed Code ASCII logo, a scrolling conversation region and a fixed message
+composer. The header is a live dashboard — it never scrolls away, and its
+values (provider, model, mode, status, workspace, context budget and the masked
+API key) update in place the moment they change.
+
+```text
+╭─ Seed Code CLI v8.2.5 ───────────────────────────────────────────────────────────────────────╮
+│    ▄█████ ▄▄▄▄▄ ▄▄▄▄▄ ▄▄▄▄    ▄█████  ▄▄▄  ▄▄▄▄  ▄▄▄▄▄   ▄█████ ██     ██                    │
+│    ▀▀▀▄▄▄ ██▄▄  ██▄▄  ██▀██   ██     ██▀██ ██▀██ ██▄▄    ██     ██     ██                    │
+│    █████▀ ██▄▄▄ ██▄▄▄ ████▀   ▀█████ ▀███▀ ████▀ ██▄▄▄   ▀█████ ██████ ██                    │
+│    Plant ideas. Grow code.                                                                   │
+│ OpenRouter · cohere/north-mini-code:free · Agent Mode                             ◌ Thinking │
+│ Workspace D:\my-project                         Context   16,384                             │
+│ API Key   sk-or-v1...e031                                                                    │
+╰──────────────────────────────────────────────────────────────────────────────────────────────╯
+──────────────────────────────────── Conversation ────────────────────────────────────────────
+You > Build the authentication system.
+
+AI > ◌ Thinking...
+
+AI > I found the issue in the authentication middleware.
+
+┌─────────────────────────────────────────| Message |──────────────────────────────────────────┐
+│ › Build a login system using the existing authentication architecture.                       │
+│                                                                                              │
+└──────────────────────────────────────────────────────────────────────────────────────────────┘
+  Enter ↵ send  ·  Shift+Enter newline
+```
+
+The header adapts to the terminal: wide terminals get the full panel with the
+logo; below 76 columns — where the 70-column block art cannot be drawn without
+clipping — the *metadata* re-flows into a compact panel and then into plain
+lines. The logo is omitted whole rather than truncated, and no line is ever
+wider than the screen. A console that cannot encode the block glyphs gets the
+wordmark form of the same layout.
+
+The composer is a real, bounded multiline text editor: prompt_toolkit draws its
+`┌─ Message ─┐` frame around the text buffer, so typed text can never escape the
+border. Long lines wrap inside it and taller content scrolls internally. It has
+**no** prompt prefix of its own — the message you type is exactly the message
+that is sent (the `You >` in the conversation is only the history label).
+`Enter` sends, `Shift+Enter` inserts a newline, and `↑`/`↓` move the cursor
+inside a multiline message (walking the input history only at the edges). The
+conversation follows the bottom until you scroll up — at which point the footer
+shows `↓ n new` instead of pulling you back down.
+
+Provider, model, mode and status are shown exactly once, in the header
+dashboard itself — there is no second toolbar repeating them. Switch provider,
+model or mode with `/provider`, `/model`, `/mode` or the `Ctrl+K` command
+palette.
+
+Below is the rendering used when the persistent interface is not available — a
+piped host, `SEEDCODE_NO_TUI=1`, or a console that cannot draw it:
 
 ```text
-╭─ Seed Code CLI v7.2.5 ───────────────────────────────────────────────────────────────────────╮
+╭─ Seed Code CLI v8.2.5 ───────────────────────────────────────────────────────────────────────╮
+│    ▄█████ ▄▄▄▄▄ ▄▄▄▄▄ ▄▄▄▄    ▄█████  ▄▄▄  ▄▄▄▄  ▄▄▄▄▄   ▄█████ ██     ██                    │
+│    ▀▀▀▄▄▄ ██▄▄  ██▄▄  ██▀██   ██     ██▀██ ██▀██ ██▄▄    ██     ██     ██                    │
+│    █████▀ ██▄▄▄ ██▄▄▄ ████▀   ▀█████ ▀███▀ ████▀ ██▄▄▄   ▀█████ ██████ ██                    │
 │                                                                                              │
-│   Seed Code                                │ Seed Code  |  Eagox Studio                      │
-│   AI CODING AGENT                          │ Plant ideas. Grow code.                         │
-│                                            │ Provider   Default                              │
-│                                            │ Model      cohere/north-mini-code:free          │
-│                                            │ Mode       Chat  •  ● Ready                     │
+│ Seed Code CLI v8.2.5                                                                         │
+│ Plant ideas. Grow code.                                                                      │
+│ Provider   OpenRouter                                                                        │
+│ Model      cohere/north-mini-code:free                                                       │
+│ Mode       Chat                                                                              │
+│ Status     ● Ready                                                                           │
+│ API Key    **********                                                                        │
 ╰──────────────────────────────────────────────────────────────────────────────────────────────╯
-Commands  /help  /status  /codemode  /assist  /provider  /model
+Commands  /help  /status  /codemode  /agent  /provider  /model
 You >
 ```
 
 The panel is 96 columns wide on a wide terminal — wide enough that the whole
-`cohere/north-mini-code:free` model name fits without clipping — and kept
-deliberately short (one blank row under the title, then the live rows; no
-padding rows to scroll past). Narrower terminals slide the info section left
-so the whole model name still fits (80 columns shows it in full), then fall
-back to a compact one-row panel, then to plain lines. Consoles that cannot
-draw (or encode) the glyphs get the same layout in ASCII.
+`cohere/north-mini-code:free` model name fits without clipping. Below 78
+columns the block logo cannot be drawn un-clipped, so the dashboard switches
+to the text wordmark; below 64 columns it becomes a compact one-row panel, and
+below 40 columns plain lines. Consoles that cannot draw (or encode) the glyphs
+get the same layout in ASCII.
 
 The `API Key` row appears **only** for providers that actually require a key,
 so Default and Ollama never show one. `cohere/north-mini-code:free` is the
@@ -250,12 +326,14 @@ Switch with `/provider` — the picker groups choices by what they need
 provider's backend, current model, and key state. Pick models with `/model`
 (OpenRouter filters `free` vs `pro` models; FreeModel offers Auto mode).
 
-## Assist Mode and permissions
+## Agent Mode and permissions
 
-Assist Mode lets the model act on your project through the tool engine:
+Agent Mode lets the model act on your project through the tool engine: a
+multi-step task that uses real tools, verifies what it did, and reports what
+actually happened instead of claiming success:
 
 ```text
-/assist on
+/agent on
 ```
 
 Permission modes (view/set with `/permission`):
@@ -267,25 +345,26 @@ Permission modes (view/set with `/permission`):
 | `desktop` | Add desktop automation capability after confirmation |
 | `full_system` | Allow broader computer and filesystem actions after confirmation |
 
-## Code Mode
+## Workspace coding (part of Agent Mode)
 
-Code Mode is Assist Mode sharpened into a real coding agent for the current
-project. Your working directory becomes the **workspace**:
+Agent Mode is a real coding agent for the current project. Your working
+directory becomes the **workspace**:
 
 ```text
-/codemode on        # treat the CWD as the workspace, enable .seedcode memory
-/codemode off       # back to the previous mode (memory stays on disk)
+/agent on           # enable Agent Mode; the workspace capability is automatic
+/codemode on        # explicitly (re)activate the workspace capability
+/codemode off       # deactivate it (memory stays on disk)
 /codemode status    # workspace, memory, and index state
 ```
 
-In Code Mode the agent consults the project index, finds relevant files with
+In Agent Mode the agent consults the project index, finds relevant files with
 targeted searches, reads only what it needs, plans, edits, runs a relevant
 command or test, and reports what changed. File operations stay inside the
 workspace root.
 
-### Persistent task execution (v7.1.0)
+### Persistent task execution
 
-Code Mode is a **long-running agent**, not one model call. A request becomes a
+Agent Mode is a **long-running agent**, not one model call. A request becomes a
 plan (a task graph with dependencies and acceptance criteria), and the session
 runs task after task until each one is *verified*:
 
@@ -350,7 +429,7 @@ nothing reads `no tool activity recorded`, never a success.
 
 ### `.seedcode` project memory
 
-Enabling Code Mode creates a `.seedcode/` directory in the project root:
+Enabling the workspace capability (`/agent on` or `/codemode on`) creates a `.seedcode/` directory in the project root:
 
 ```text
 my-project/
@@ -359,7 +438,7 @@ my-project/
 │   ├── index/        per-file summaries + a file map (incremental, hashed)
 │   ├── context/      reusable project context (conventions, snippets)
 │   ├── sessions/     compact per-session summaries (never raw transcripts)
-│   ├── checkpoints/  resumable Code Mode session state
+│   ├── checkpoints/  resumable agent session state
 │   ├── plan.json     the current task graph
 │   └── config.json   safe project configuration
 ├── src/
@@ -373,15 +452,16 @@ my-project/
 - **Not source code** — `.seedcode/` is excluded from workspace search,
   indexing, and the agent's project view.
 
-## Task flow (Code / Assist / Agent Mode)
+## Task flow (Agent Mode)
 
-Every task in Code Mode, Assist Mode or Agent Mode is shown as a compact live
-flow, and each step changes state only when the work behind it really
-happened. Code Mode shows the protocol header, the plan as a checklist, and a
-single live action line:
+Every Agent Mode task is shown as a live flow, and each line appears only when
+the work behind it really happened. In the persistent interface the header
+carries the status and the conversation carries the activity stream; in the
+sequential console Agent Mode additionally shows the plan as a checklist. Both
+reflect what the agent really did:
 
 ```text
-╭─ SEEDCODE 7.2.5 • CODE MODE ────────────────╮
+╭─ SEEDCODE 8.2.5 • AGENT MODE ───────────────╮
 │ ● RUNNING   Task 3/8   Build authentication │
 │   ████████████░░░░  72% • 4m 32s • 18 calls │
 │ → Running: pytest tests/auth                │
@@ -400,10 +480,10 @@ the session moves into those phases. The panel re-fits itself on every refresh,
 so resizing the terminal mid-session cannot leave a panel wider than the
 screen — it degrades to a single status line when the space runs out.
 
-Assist Mode and Agent Mode keep the step-by-step flow:
+Agent Mode keeps the event-driven step flow:
 
 ```text
-Task  ·  Code Mode
+Task  ·  Agent Mode
 Fix authentication persistence
 ✓ Analyze project  request understood
 ✓ Inspect files  read_file seedcode/config.py
@@ -427,7 +507,7 @@ count:
 Ready for next task.
 ```
 
-A whole Code Mode project closes with the evidence that verified it, not a
+A whole agent project closes with the evidence that verified it, not a
 restatement of the model's replies:
 
 ```text
@@ -478,20 +558,20 @@ The agent runs commands through the tool engine's `run_command` tool:
 | `/provider` | Switch the active AI provider |
 | `/apikey` | Add, replace, remove, or validate a provider key |
 | `/model` | Browse and select the provider's model catalogue |
-| `/mode` | Show or switch the mode: `chat` / `assist` / `code` / `agent` |
+| `/mode` | Show or switch the mode: `chat` / `agent` (`code` is an alias for Agent) |
 | `/chat` | Switch to plain Chat Mode (`/chat on`) |
-| `/agent` | Enable or disable Assist Mode (alias `/assist`) |
-| `/codemode` | Workspace-aware Code Mode (`on` / `off` / `status`) |
-| `/workspace` | Show the active Code Mode workspace |
-| `/session` | Inspect the Code Mode session: state, evidence, per-task records |
-| `/pause` | Pause the running Code Mode session (state is kept) |
+| `/agent` | Select Agent Mode (`on` / `off`; aliases `/assist`, `/desktop`) |
+| `/codemode` | Agent Mode workspace capability (`on` / `off` / `status`) |
+| `/workspace` | Show the active Agent Mode workspace |
+| `/session` | Inspect the agent session: state, evidence, per-task records |
+| `/pause` | Pause the running agent session (state is kept) |
 | `/resume` | Resume a paused session from its checkpoint |
-| `/stop` | Safely stop the running Code Mode session |
-| `/permission` | View or set the Assist permission mode (alias `/permissions`) |
+| `/stop` | Safely stop the running agent session |
+| `/permission` | View or set the Agent Mode permission level (alias `/permissions`) |
 | `/computer` | Show Computer Engine status and permissions |
 | `/screenshot` | Capture a screenshot |
 | `/windows` | List open windows |
-| `/tools` | List tools available in Assist Mode |
+| `/tools` | List the tools available to the agent modes |
 | `/index` | Show a compact project tree |
 | `/files` | Search project files |
 | `/history` | Browse saved sessions |
@@ -503,9 +583,36 @@ The agent runs commands through the tool engine's `run_command` tool:
 | `/version` | Show the Seed Code version |
 | `/exit` | Leave the current chat (opens the main menu) |
 
-Keyboard shortcuts: `Ctrl+K` command palette, `Ctrl+P` project file search,
-`Ctrl+R` history, `Ctrl+,` settings, `Ctrl+/` shortcut reference,
-`Ctrl+L` clear.
+### Persistent interface (TUI)
+
+Running `seedcode` on an interactive console opens the persistent workspace.
+The three regions are fixed: the header never scrolls away, only the
+conversation scrolls, and the composer stays at the bottom.
+
+| Key | Action |
+| --- | --- |
+| `Enter` | Send the message |
+| `Shift+Enter` (or `Ctrl+J` / `Alt+Enter`) | Insert a newline without sending |
+| `↑` / `↓` | Walk the input history |
+| `Ctrl+C` | Cancel the running turn (or clear the composer when idle) |
+| `Esc` | Clear the composer / deny a pending permission prompt |
+| `Ctrl+K` | Command palette |
+| `Ctrl+P` | Project file search |
+| `Ctrl+R` | Saved session history |
+| `Ctrl+,` | Settings |
+| `Ctrl+/` | Shortcut reference |
+| `Ctrl+L` | Clear the conversation |
+| `PageUp` / `PageDown`, `Ctrl+Home` / `Ctrl+End` | Scroll the conversation |
+| Mouse wheel | Scroll the conversation |
+| `Ctrl+D` | Exit |
+
+Only the conversation scrolls, and output is repainted incrementally: there is
+no clear-screen-and-redraw loop, so the header and composer stay stable while a
+model streams, the thinking indicator animates, commands run, tool events
+appear, or the terminal is resized.
+
+Set `SEEDCODE_NO_TUI=1` to use the sequential console instead (as the
+`SEEDCODE_PLAIN` mode and piped hosts do automatically).
 
 All exit paths are clean: `/exit` → menu, menu → Exit, `Ctrl+C` (cancels a
 response or the current line), and `Ctrl+D`/EOF. No traceback appears on
@@ -563,7 +670,7 @@ health.
 
 - **Windows:** full experience — desktop control, one-click installer,
   standalone EXE. Primary platform.
-- **Linux / macOS:** terminal chat, providers, project tools, Code Mode.
+- **Linux / macOS:** terminal chat, providers, project tools, Agent Mode workspace.
   Install with the `install.sh` command above — it installs the official
   Python wheel, so **Python 3.10+ (with pip)** is required. No prebuilt
   Linux/macOS binary is published in this release.
@@ -595,21 +702,21 @@ stage fails loudly on a version mismatch, so a stale binary can never ship.
 
 Details: [`scripts/windows/README.md`](scripts/windows/README.md).
 
-### Release artifacts (v7.2.5)
+### Release artifacts (v8.2.5)
 
-Release: [v7.2.5](https://github.com/Alshahriar-07/seedcode-cli/releases/tag/v7.2.5)
+Release: [v8.2.5](https://github.com/Alshahriar-07/seedcode-cli/releases/tag/v8.2.5)
 
 | Artifact | Purpose |
 | --- | --- |
-| `SeedCode-CLI-Setup-7.2.5.exe` | Windows installer (Inno Setup) |
-| `SeedCode-CLI-7.2.5-windows-x64.exe` | Standalone Windows EXE — downloaded by the Windows IRM installer |
-| `seedcode_cli-7.2.5-py3-none-any.whl` | Python wheel — downloaded by the Linux IRM installer |
-| `seedcode_cli-7.2.5.tar.gz` | Python source distribution |
+| `SeedCode-CLI-Setup-8.2.5.exe` | Windows installer (Inno Setup) |
+| `SeedCode-CLI-8.2.5-windows-x64.exe` | Standalone Windows EXE — downloaded by the Windows IRM installer |
+| `seedcode_cli-8.2.5-py3-none-any.whl` | Python wheel — downloaded by the Linux IRM installer |
+| `seedcode_cli-8.2.5.tar.gz` | Python source distribution |
 | `SHA256SUMS.txt` | SHA256 checksums; verified by both installers |
 
-Built artifacts are collected in `dist/release/7.2.5/` during a release
+Built artifacts are collected in `dist/release/8.2.5/` during a release
 build. Publishing (GitHub Release) is a separate step; the remote installers
-read the release named `v7.2.5`.
+read the release named `v8.2.5`.
 
 ### The remote installers
 
@@ -658,14 +765,14 @@ read the release named `v7.2.5`.
 - The release build consumes the local `.env` only during packaging; the
   secret never enters source control, logs, manifests, or package metadata.
 
-Review permissions before enabling Assist Mode — especially in unfamiliar
+Review permissions before enabling Agent Mode — especially in unfamiliar
 projects or with sensitive applications.
 
 ## Credits
 
 - **Created by:** Al Shahriar Sowan — <https://alshahriarsayon.vercel.app/>
 - **Studio:** Eagox Studio — <https://eagoxstudio.vercel.app/>
-- **Contact:** github@eagox.studio
+- **Contact:** seedcode.ai@gmail.com
 
 ## License