Skip to content

docs: v0.17 completeness — stores, examples, module docs#28

Merged
johnnichev merged 1 commit intomainfrom
docs/v0.17-completeness
Mar 23, 2026
Merged

docs: v0.17 completeness — stores, examples, module docs#28
johnnichev merged 1 commit intomainfrom
docs/v0.17-completeness

Conversation

@johnnichev
Copy link
Copy Markdown
Owner

Summary

  • RedisKnowledgeStore and SupabaseKnowledgeStore — completes the 4-backend knowledge store suite
  • 7 example scripts (43-49) for token budget, cancellation, approval gate, SimpleStepObserver, token estimation, model switching, knowledge stores
  • 4 new module docs: BUDGET.md, CANCELLATION.md, TOKEN_ESTIMATION.md, MODEL_SWITCHING.md
  • Updated KNOWLEDGE.md with v0.17.4 store enhancements
  • mkdocs.yml: new "Runtime Controls" nav section
  • Count fixes: 2113 tests, 49 examples across all docs and landing page
  • Private docs updated: comparison-table.md, competitive-gaps.md, growth-track.md

Test plan

  • 31 new tests for Redis/Supabase stores (all mocked, no external deps)
  • Full suite: 1997 passed, 0 failures
  • mkdocs build: clean
  • Pre-commit hooks: all pass

🤖 Generated with Claude Code

Code:
- RedisKnowledgeStore (knowledge_store_redis.py) — 15 tests
- SupabaseKnowledgeStore (knowledge_store_supabase.py) — 16 tests

Documentation:
- 4 new module docs: BUDGET.md, CANCELLATION.md, TOKEN_ESTIMATION.md,
  MODEL_SWITCHING.md
- Updated KNOWLEDGE.md with v0.17.4 store enhancements
- mkdocs.yml: new "Runtime Controls" nav section
- Updated counts: 2113 tests, 49 examples across all docs

Examples:
- 43_token_budget.py, 44_cancellation.py, 45_approval_gate.py,
  46_simple_observer.py, 47_token_estimation.py, 48_model_switching.py,
  49_knowledge_stores.py
@johnnichev johnnichev merged commit 9e48962 into main Mar 23, 2026
1 check passed
@johnnichev johnnichev deleted the docs/v0.17-completeness branch March 23, 2026 00:03
johnnichev added a commit that referenced this pull request Mar 24, 2026
Agent core observers (6 fixes):
- astream() cancellation/budget paths now build proper results with
  trace steps and async observer events (#14)
- arun() fires async observers for cancel/budget/max-iter (#15)
- _aexecute_tools_parallel fires async observer events (#16)
- _aexecute_tools_parallel tracks tool_usage/tool_tokens (#17)
- _acheck_policy fires async on_policy_decision observer (#10M)
- astream() max-iter path fires async on_run_end (#12M)

Tools + providers (7 fixes):
- Anthropic empty content list guard (#19)
- Bool rejected for int/float params (#20)
- ToolRegistry.tool() has screen_output/terminal/requires_approval (#21)
- MultiMCPClient list_all_tools() copies tools before prefixing (#22)
- Streamable-http 3-tuple unpacking robust handling (#23)
- _serialize_result returns "" for None (#24)
- StructuredOutputEvaluator handles __slots__ (#45)

RAG (6 fixes):
- SQLiteVectorStore search documented limitation (#25)
- InMemoryVectorStore max_documents warning (#26)
- Pinecone metadata.get instead of .pop (#27)
- ContextualChunker None content guard (#28)
- Filter overfetch: top_k*4 when filter present (#29)
- OpenAI embed_texts batching at 2048 (#30)

Memory (5 fixes):
- FileKnowledgeStore reads under lock (#32)
- SQLiteSessionStore WAL mode (#33)
- SQLiteKnowledgeStore indexes on query columns (#34)
- query() LIMIT after TTL filter (#35)
- Redis save() category update in pipeline (#36)

Evals (4 fixes):
- 16 LLM evaluators fail on unparseable score (#37)
- XSS fix: textContent instead of innerHTML (#38)
- Donut SVG 360° arc: two semicircles (#39)
- Suite completed counter under threading.Lock (#46)

Security (5 fixes):
- REWRITE/WARN guardrails tracked in trace (#40)
- SSN regex requires consistent separators (#41)
- Topic guardrail Unicode normalization (#42)
- Coherence usage tracked in agent costs (#43)
- Coherence fail_closed option (#44)

Full suite: 2013 passed.
johnnichev added a commit that referenced this pull request Mar 24, 2026
HIGH fixes recovered:
- Bug #22: MultiMCPClient copy.copy(tool) before prefix mutation
- Bug #26: InMemoryVectorStore max_documents capacity warning
- Bug #27: Pinecone metadata.get not .pop (stops mutating response)
- Bug #28: ContextualChunker (content or "").strip() None guard
- Bug #29: InMemoryVectorStore overfetch top_k*4 when filter present
- Bug #36: Redis save() category srem moved into pipeline
- Bug #38: XSS fix — createElement/textContent replaces innerHTML
- Bug #41: SSN regex uses strict alternation (?:\d{3}-\d{2}-\d{4}|\d{9})

LOW fix:
- Bug #35: KnowledgeMemory.remember() uses UTC consistently
- Fixed naive/aware datetime comparison in prune_old_logs
- Updated tests to use UTC dates

Full suite: 2013 passed.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant