Godot AI Sidebar v2.7.1

Godot AI Sidebar v2.7.1

Install: unpack the archive into your project root so you get
addons/godot_sidebar_ai/, then enable Godot AI Sidebar under
Project -> Project Settings -> Plugins.

Godot 4.7+ required. GDScript projects only.

---

Fix: AGY CLI no longer freezes the editor on the first request

When the Antigravity CLI (agy) provider was used, the first request could block
the editor for several seconds while the agy subprocess finished its
stream-json init handshake.

Root cause: OS.execute_with_pipe() returns in about 8 ms, but agy does not
read stdin until it has emitted its init event (measured 4-23 s). Windows uses
a limited pipe buffer (about 4 KB), so writing a large request before the
handshake completed blocked store_string() on the main thread. Measured on a
~15 KB payload: 14,253 ms of editor freeze, to the point where the text
caret stopped blinking.

What changed:

• An explicit readiness state machine (STARTING -> INITIALIZING -> READY) plus
  a readiness_changed signal. READY is now driven by the real
  {"event":"init"} line from agy stdout instead of being assumed.
• All stdin writes funnel through a single _write_payload, and nothing is
  written before READY. A request issued early is held as a pending request
  and sent automatically once the handshake completes.
• A generation counter invalidates late init notifications from a previous
  process, so a model switch or restart cannot falsely mark the new process as
  ready.
• If the reader loop ends while a request is still pending, the user is now told
  instead of the request failing silently.
• UI: only the status badge text changes ("AGY hazirlaniyor..." / "AGY
  preparing..."); the thinking timer is untouched.

The reader-thread / call_deferred architecture, the pipe structure and the
stop_process() body were left unchanged. No writer thread was added and
non-blocking IO was not used.

Measured result on the same ~15 KB payload: cold 14,253.7 ms -> 2.5 ms,
warm 11.9 ms -> 1.9 ms. A real Godot GUI cold request measured 30.5 ms.

---

Also in this release: track Godot .uid files and icon import metadata

Godot 4.4+ generates a persistent .uid identity for every .gd script, and
these are meant to be version-controlled, because otherwise script references can
break. 56 .uid files were already tracked; the remaining 75 files plus the icon
import metadata are now tracked as well.

Metadata only - no source code or configuration changed.

---

Verification

Verified on a clean checkout of the v2.7.1 tag (no config.json, no local
provider settings):

• Static compile and scene load: 130/130 GDScript, 4/4 scenes, exit code 0
• Test suite: 55 suites / 336 assertions, 0 failures, exit code 0

---

Known limitations

• No vision over AGY CLI - the agy stream-json interface does not accept
  image data. Use an OpenAI-compatible provider for image analysis.
• Godot 4.7+ and GDScript only.

---

Note on the version string

This release is tagged and published from the current main without modifying
shipped plugin files, so the version field inside
addons/godot_sidebar_ai/plugin.cfg still reads 2.7.0. This is a metadata
string only; the archive content is the tagged v2.7.1 tree.

---

Released under GPL-3.0. Copyright (C) 2026 Halil Emre.

Godot AI Sidebar v2.7.0

Godot AI Sidebar v2.7.0

Install: unpack the archive into your project root so you get
addons/godot_sidebar_ai/, then enable Godot AI Sidebar under
Project -> Project Settings -> Plugins.

Godot 4.7+ required. GDScript projects only.

---

Highlights

AI-native UI layout telemetry (inspect_ui_layout)
The agent can inspect the Control/Container hierarchy of both your edited scene
and its own sidebar, with cumulative container overflow checking
(UI_CONTAINER_OVERFLOW), effective-visibility filtering, and theme/StyleBox
analysis.

Headless static compiler & scene validator (typecheck.ps1)
Compiles and loads every GDScript and scene under addons/ and tests/ without
opening the editor, in about 1.5 seconds. Wired to Ctrl+Shift+B in VS Code.

Centralized design system (AISidebarTheme)
Deep slate / midnight dark token architecture, semantic colour tokens, ghost
buttons, focus borders and inline state indicators.

---

Also in this release

Everything from 2.1.0 through 2.6.0 is included, since no archive was published
for those versions:

• Clarification (ask_user) - the agent pauses and asks when a request is
  genuinely ambiguous, rather than guessing. Includes a dedicated
  WAITING_FOR_CLARIFICATION state and inline option buttons.
• Chat persistence & history - sessions stored as isolated JSON under
  user://sidebar_ai_chats/, with search, rename and delete. API keys are never
  written to a session file.
• Surgical script editing (replace_file_content) - line-level diffs with
  GDScript validation before anything reaches disk.
• Live SSE streaming, @mention autocompletion, queued messages,
  context compaction, and runtime inspection
  (inspect_runtime_tree, inspect_runtime_node).
• Antigravity CLI provider - talk to an agy session over a persistent
  subprocess, with no HTTP layer and no API key.

---

Correctness fix in this version

supports_vision() previously returned false for any model id that did not
match a hardcoded keyword list. Models routed through aliases such as a or
code therefore had image input silently disabled even when the backing model
supported it. Capability detection is now a pure function, honours an explicit
vision_capable setting, and defers to the server for unrecognised model ids
instead of blocking them.

---

Verification

• Static compile & scene load: 129/129 GDScript, 4/4 scenes
• Test suite: 55 suites / 331 assertions, 0 failures
• Verified on both a clean checkout (no config.json) and a working tree with
  local provider settings.

---

Known limitations

• AGY CLI startup latency - starting an agy session can briefly block the
  editor while the subprocess initialises its stdio pipes. Under active
  investigation.
• No vision over AGY CLI - the agy stream-json interface does not accept
  image data. Use an OpenAI-compatible provider for image analysis.
• Godot 4.7+ and GDScript only.

---

Released under GPL-3.0. Copyright (C) 2026 Halil Emre.

Godot AI Sidebar v1.0.0

🚀 Godot AI Sidebar v1.0.0 (Stable Release)

Godot Engine 4.7 için tam entegre otonom yapay zeka asistanı.

🌟 Özellikler

• ⚡ Editör Sol Dock Entegrasyonu: Godot 4.7 sol dock paneline yerleşir, motoru terk etmeden AI ile çalışmanızı sağlar.
• ↩️ Tam Undo / Redo (Ctrl+Z) Desteği: AI tarafından yapılan tüm değişiklikler Godot'nun yerel UndoRedo sistemine kaydedilir.
• 🛡️ Güvenlik & Permission Policy: project.godot, .git/** ve eklenti sistem dosyalarının güvenliği garanti altındadır.
• 🔍 Progressive Tool Discovery: Yüzlerce aracı tek seferde prompta yüklemek yerine search_tools ile dinamik keşif.
• 🌐 9Router & Çoklu Model Desteği: Yerel ve bulut tabanlı modellerle tam uyumlu.
• 🇹🇷 🇬🇧 Çift Dil Desteği: Türkçe ve İngilizce tek tıkla geçiş.

📦 Kurulum

1. godot-ai-sidebar-v1.0.0.zip dosyasını indirin.
2. ZIP içindeki addons/godot_sidebar_ai/ klasörünü Godot projenizin addons/ dizinine çıkartın.
3. Godot Editöründe Project -> Project Settings -> Plugins sekmesine gidin.
4. Godot AI Sidebar eklentisini Enable (Etkin) yapın.
5. Sol panelde beliren AI paneline tıklayıp Ayarlar (⚙️) butonundan API adresinizi yapılandırın.