Skip to content

Introducing modular blocks architecture and reorganize study agents - #10

Merged
wilhelm-tiger merged 1 commit into
masterfrom
minimal-agent
Jul 30, 2026
Merged

Introducing modular blocks architecture and reorganize study agents#10
wilhelm-tiger merged 1 commit into
masterfrom
minimal-agent

Conversation

@wilhelm-tiger

@wilhelm-tiger wilhelm-tiger commented Jul 17, 2026

Copy link
Copy Markdown
Owner

This PR introduces the packages/study directory, establishing a multi-language learning path for building AI agents from scratch. It adopts an industrial, modular architecture inspired by LlamaIndex, providing both minimal baselines and pluggable components (Blocks) for TypeScript, Python, Go, and Rust.

  • New Study Path: Created a comprehensive curriculum for learning agent development across four languages.

  • Minimal Baselines: Established agent-*-minimal packages in each language to serve as pure, bare-bones entry points for Milestone 1

  • Modular Blocks: Introduced packages/study/agent-*-blocks to house reusable components:

    • AgentEngine: A core orchestrator with lifecycle hooks.
    • ChatMemoryBuffer: A pluggable memory component (Milestone 2).
  • Architectural Manifest: Added packages/study/AGENTS.md to enforce design consistency and LlamaIndex-inspired patterns.

  • Documentation:

    • Added a new Build from scratch section to the documentation.
    • Completed tutorials for Milestone 1 (Chat Loop) and Milestone 2 (Memory and Context).

@github-actions github-actions Bot added the size/L L: 250-999 lines changed label Jul 17, 2026
@github-actions

github-actions Bot commented Jul 17, 2026

Copy link
Copy Markdown

馃搳 PR Size: size/XL

  • Lines changed: 1666
  • Additions: +1659
  • Deletions: -7
  • Files changed: 45

@github-actions

github-actions Bot commented Jul 17, 2026

Copy link
Copy Markdown

Size Change: -4 B (0%)

Total Size: 35.2 MB

Filename Size Change
./bundle/chunk-4MY22GNE.js 0 B -13.1 kB (removed) 馃弳
./bundle/chunk-BACR3TCD.js 0 B -3.43 kB (removed) 馃弳
./bundle/chunk-CL44IT6O.js 0 B -49.2 kB (removed) 馃弳
./bundle/chunk-FEVB3A75.js 0 B -16.6 MB (removed) 馃弳
./bundle/chunk-IV4AD27B.js 0 B -661 kB (removed) 馃弳
./bundle/chunk-IVY6X6TD.js 0 B -3.65 MB (removed) 馃弳
./bundle/chunk-L2V7ATQQ.js 0 B -3.77 kB (removed) 馃弳
./bundle/chunk-TPQXKG3I.js 0 B -19.5 kB (removed) 馃弳
./bundle/core-IN4QTBGX.js 0 B -50.1 kB (removed) 馃弳
./bundle/devtoolsService-3YPS2SZP.js 0 B -147 kB (removed) 馃弳
./bundle/gemini-S42XCLZ4.js 0 B -590 kB (removed) 馃弳
./bundle/interactiveCli-IJE3EGJI.js 0 B -1.3 MB (removed) 馃弳
./bundle/liteRtServerManager-AGSMJ4OV.js 0 B -2.08 kB (removed) 馃弳
./bundle/oauth2-provider-SEPR72QE.js 0 B -9.12 kB (removed) 馃弳
./bundle/chunk-3QGX3ZEU.js 19.5 kB +19.5 kB (new file) 馃啎
./bundle/chunk-AP4FL5IQ.js 661 kB +661 kB (new file) 馃啎
./bundle/chunk-GEHFJ2YN.js 49.2 kB +49.2 kB (new file) 馃啎
./bundle/chunk-KXEPKMTN.js 3.77 kB +3.77 kB (new file) 馃啎
./bundle/chunk-LWWCSRHZ.js 13.1 kB +13.1 kB (new file) 馃啎
./bundle/chunk-OI6NPEAQ.js 3.43 kB +3.43 kB (new file) 馃啎
./bundle/chunk-TGWOGJ6Q.js 16.6 MB +16.6 MB (new file) 馃啎
./bundle/chunk-U6IDUZKI.js 3.65 MB +3.65 MB (new file) 馃啎
./bundle/core-Q764MCEC.js 50.1 kB +50.1 kB (new file) 馃啎
./bundle/devtoolsService-54AUKYVX.js 147 kB +147 kB (new file) 馃啎
./bundle/gemini-ZLH45Y4C.js 590 kB +590 kB (new file) 馃啎
./bundle/interactiveCli-M37AKWHV.js 1.3 MB +1.3 MB (new file) 馃啎
./bundle/liteRtServerManager-VNIEME4A.js 2.08 kB +2.08 kB (new file) 馃啎
./bundle/oauth2-provider-EC2PFFA4.js 9.12 kB +9.12 kB (new file) 馃啎
鈩癸笍 View Unchanged
Filename Size Change
./bundle/bundled/third_party/index.js 8 MB 0 B
./bundle/chunk-34MYV7JD.js 2.45 kB 0 B
./bundle/chunk-5AUYMPVF.js 858 B 0 B
./bundle/chunk-5PS3AYFU.js 1.18 kB 0 B
./bundle/chunk-664ZODQF.js 124 kB 0 B
./bundle/chunk-DAHVX5MI.js 206 kB 0 B
./bundle/chunk-IUUIT4SU.js 56.5 kB 0 B
./bundle/chunk-L5V3KIDT.js 1.62 kB 0 B
./bundle/chunk-TUDYL3X4.js 40.3 kB 0 B
./bundle/cleanup-C7YQPRJ3.js 0 B -902 B (removed) 馃弳
./bundle/devtools-TYCPOPV3.js 683 kB 0 B
./bundle/events-XB7DADIJ.js 418 B 0 B
./bundle/examples/hooks/scripts/on-start.js 188 B 0 B
./bundle/examples/mcp-server/example.js 1.43 kB 0 B
./bundle/gemini.js 5.38 kB 0 B
./bundle/getMachineId-bsd-TXG52NKR.js 1.55 kB 0 B
./bundle/getMachineId-darwin-7OE4DDZ6.js 1.55 kB 0 B
./bundle/getMachineId-linux-SHIFKOOX.js 1.34 kB 0 B
./bundle/getMachineId-unsupported-5U5DOEYY.js 1.06 kB 0 B
./bundle/getMachineId-win-6KLLGOI4.js 1.72 kB 0 B
./bundle/https-proxy-agent-AVGR4LHR.js 490 B 0 B
./bundle/multipart-parser-E7RMVJWU.js 11.7 kB 0 B
./bundle/multipart-parser-KPBZEGQU.js 11.7 kB 0 B
./bundle/sandbox-macos-permissive-open.sb 827 B 0 B
./bundle/sandbox-macos-permissive-proxied.sb 1.25 kB 0 B
./bundle/sandbox-macos-restrictive-open.sb 3.3 kB 0 B
./bundle/sandbox-macos-restrictive-proxied.sb 3.5 kB 0 B
./bundle/sandbox-macos-strict-open.sb 4.75 kB 0 B
./bundle/sandbox-macos-strict-proxied.sb 4.96 kB 0 B
./bundle/src-65GKNWUJ.js 45.4 kB 0 B
./bundle/src-U45KTUYT.js 45.7 kB 0 B
./bundle/src-XZYPU6PJ.js 352 kB 0 B
./bundle/start-CJONTVUZ.js 0 B -622 B (removed) 馃弳
./bundle/tree-sitter-7U6MW5PS.js 274 kB 0 B
./bundle/tree-sitter-bash-34ZGLXVX.js 1.84 MB 0 B
./bundle/worker/worker-entry.js 363 kB 0 B
./bundle/cleanup-PVMWOLOA.js 902 B +902 B (new file) 馃啎
./bundle/start-3T52CR2W.js 622 B +622 B (new file) 馃啎

compressed-size-action

@github-actions github-actions Bot added size/XL XL: >=1000 lines changed and removed size/L L: 250-999 lines changed labels Jul 29, 2026
@wilhelm-tiger
wilhelm-tiger force-pushed the minimal-agent branch 2 times, most recently from fb23c1e to 08f5c33 Compare July 29, 2026 06:48
@wilhelm-tiger wilhelm-tiger changed the title Minimal agent Introducing modular blocks architecture and reorganize study agents Jul 29, 2026
@wilhelm-tiger
wilhelm-tiger merged commit ec1495c into master Jul 30, 2026
27 checks passed
@wilhelm-tiger
wilhelm-tiger deleted the minimal-agent branch July 30, 2026 01:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/XL XL: >=1000 lines changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant