Skip to content

feat(repo-chat): declare tools as data — first exemplar of the creator way (#51) - #61

Merged
serge-ivo merged 1 commit into
mainfrom
feat/repo-chat-declarative-tools
Aug 1, 2026
Merged

feat(repo-chat): declare tools as data — first exemplar of the creator way (#51)#61
serge-ivo merged 1 commit into
mainfrom
feat/repo-chat-declarative-tools

Conversation

@serge-ivo

Copy link
Copy Markdown
Contributor

Dogfoods PR #59 on a live agent. Part of epic #58 (first-party exemplary agents mature the platform).

What

Migration 0050 sets repo-chat's capabilities.tools to ["search_knowledge","list_knowledge","read_knowledge"] explicitly — instead of leaning on the hardcoded repo-surface special-case in toolNamesFor.

repo-chat becomes the first agent built the "creator way": its toolset is declared data, not a platform conditional. That makes it the reference example a future creator copies, and it decouples the agent from the surface special-cases (a step toward eventually deleting them).

Behavior-preserving (by design)

BASE + read-only KB is exactly what the repo surface already resolved to. Proven by a new test that resolves the post-migration config through agentCapabilitiestoolNamesFor and asserts an identical tool set to the surface default. The surface stays ["repo"], so the Repo tab and technical response style are unchanged.

Validation

  • json_set migration checked with sqlite3: tools set, surfaces + identity preserved (nested patch, no clobber).
  • Idempotent; no-op on databases without the agent.
  • workers/api/src/agent-do-tools.test.ts — 14 tests pass; typecheck clean.

Next in #51

Formalize the declarative agent schema (identity/prompt/guardrails/model/tools/surfaces as one validated shape) informed by this exercise, then a "view/fork source" example-gallery so exemplars are visible to creators.

…r way (#51)

Migration 0050 sets repo-chat's capabilities.tools to its read-only KB set
explicitly, instead of leaning on the hardcoded `repo`-surface special-case in
toolNamesFor. repo-chat becomes the first agent built the "creator way" (declared
data, not platform conditionals) — the reference example future creators copy.

Behavior-preserving: BASE + read-only KB is exactly what the repo surface already
resolved to (proven by a new test that resolves the post-migration config and
asserts an identical tool set); the surface stays ["repo"] so the Repo tab +
technical response style are unchanged. Migration validated with sqlite3
(tools set, surfaces + identity preserved).

Part of #58.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@serge-ivo
serge-ivo merged commit 965779c into main Aug 1, 2026
1 check passed
@serge-ivo
serge-ivo deleted the feat/repo-chat-declarative-tools branch August 1, 2026 02:42
serge-ivo pushed a commit that referenced this pull request Aug 1, 2026
Mark the tool catalog (#59) + repo-chat dogfood (#61) + agent-definition schema
(#62) as landed/in-progress across the strategy doc, the third-party plan, and the
README's repo-chat row (now the first "creator way" exemplar).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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.

2 participants