Skip to content

feat(core): add local operation selector and update docs#543

Draft
samchon wants to merge 6 commits into
mainfrom
feat/claude-code-study
Draft

feat(core): add local operation selector and update docs#543
samchon wants to merge 6 commits into
mainfrom
feat/claude-code-study

Conversation

@samchon

@samchon samchon commented May 22, 2026

Copy link
Copy Markdown
Member

What changed

  • Added a dependency-free local operation index in @agentica/core.
  • Added IAgenticaSelectorConfig and config.selector support for llm/standard, local, hybrid, and auto selection modes.
  • Wired selector modes into the existing select orchestration while keeping the default behavior as the existing LLM selector.
  • Added focused tests for tokenization, weighted search, direct select:<operation> routing, required terms, schema/parameter matching, metadata hints, hidden operations, and registry versioning.
  • Updated .wiki with the implementation record, AutoBe in-memory RAG notes, external references, verification strategy, roadmap, and worklog.
  • Updated website docs and snippets to match current selector, event, history, and vector selector APIs.
  • Excluded .wiki notes from root ESLint so research/working-memory markdown is not parsed as CI-gated source documentation.

Implementation notes

  • local mode retrieves candidates from AgenticaOperationIndex and pushes them directly into the selection stack.
  • hybrid mode narrows candidates locally, then asks the existing LLM selector to choose from that reduced catalog.
  • auto mode keeps the LLM selector for smaller catalogs and switches to hybrid once 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.
  • MicroAgentica is unchanged.

Documentation

  • Added /docs/core/selector.
  • Rewrote core configuration, event, and history docs around the current public API.
  • Reworked vector selector docs around @agentica/vector-selector, BootAgenticaVectorSelector, SQLite, PostgreSQL, and custom strategies.
  • Removed stale @agentica/pg-vector-selector, agent.on("text"), AgenticaHistory.Text, and p.selections references from website docs/snippets.
  • Added OpenAI official references for Function Calling, Tool Search, and Structured Outputs where relevant.

Validation

  • pnpm --filter @agentica/core exec vitest run src/selector/AgenticaOperationIndex.spec.ts
  • pnpm --filter @agentica/core exec tsc --noEmit
  • pnpm --filter @agentica/core test -- --run
  • pnpm --filter @agentica/core lint (passes with existing JSDoc warnings in packages/core/src/functional/*)
  • pnpm lint:root
  • pnpm dlx npm-run-all2 -p lint:* --aggregate-output (passes with existing warnings)
  • git diff --check
  • stale-reference grep for removed selector/event/history names
  • pnpm --filter @agentica/website exec next build

CI status

All PR checks are passing on head 20f342ec.

@pkg-pr-new

pkg-pr-new Bot commented May 22, 2026

Copy link
Copy Markdown

Open in StackBlitz

@agentica/benchmark

npm i https://pkg.pr.new/@agentica/benchmark@543

@agentica/chat

npm i https://pkg.pr.new/@agentica/chat@543

agentica

npm i https://pkg.pr.new/agentica@543

@agentica/core

npm i https://pkg.pr.new/@agentica/core@543

create-agentica

npm i https://pkg.pr.new/create-agentica@543

@agentica/rpc

npm i https://pkg.pr.new/@agentica/rpc@543

@agentica/vector-selector

npm i https://pkg.pr.new/@agentica/vector-selector@543

commit: d74b0dc

@samchon samchon changed the title [codex] document Claude Code architecture study feat(core): add local operation selector and update docs May 24, 2026
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