feat(core): add local operation selector and update docs#543
Draft
samchon wants to merge 6 commits into
Draft
Conversation
@agentica/benchmark
@agentica/chat
agentica
@agentica/core
create-agentica
@agentica/rpc
@agentica/vector-selector
commit: |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What changed
@agentica/core.IAgenticaSelectorConfigandconfig.selectorsupport forllm/standard,local,hybrid, andautoselection modes.select:<operation>routing, required terms, schema/parameter matching, metadata hints, hidden operations, and registry versioning..wikiwith the implementation record, AutoBe in-memory RAG notes, external references, verification strategy, roadmap, and worklog..wikinotes from root ESLint so research/working-memory markdown is not parsed as CI-gated source documentation.Implementation notes
localmode retrieves candidates fromAgenticaOperationIndexand pushes them directly into the selection stack.hybridmode narrows candidates locally, then asks the existing LLM selector to choose from that reduced catalog.automode keeps the LLM selector for smaller catalogs and switches tohybridonce the estimated schema character threshold is reached.fallback: "llm"preserves standard selector behavior when local search finds no candidates;fallback: "none"returns no local selection.MicroAgenticais unchanged.Documentation
/docs/core/selector.@agentica/vector-selector,BootAgenticaVectorSelector, SQLite, PostgreSQL, and custom strategies.@agentica/pg-vector-selector,agent.on("text"),AgenticaHistory.Text, andp.selectionsreferences from website docs/snippets.Validation
pnpm --filter @agentica/core exec vitest run src/selector/AgenticaOperationIndex.spec.tspnpm --filter @agentica/core exec tsc --noEmitpnpm --filter @agentica/core test -- --runpnpm --filter @agentica/core lint(passes with existing JSDoc warnings inpackages/core/src/functional/*)pnpm lint:rootpnpm dlx npm-run-all2 -p lint:* --aggregate-output(passes with existing warnings)git diff --checkpnpm --filter @agentica/website exec next buildCI status
All PR checks are passing on head
20f342ec.