feat(agents): generic externally-writable custom collections (comments as first consumer)#4551

Open

balegas wants to merge 35 commits into

mainfrom

vbalegas/custom-state

Commits on Jun 11, 2026

docs: design for generic writable custom collections

balegas
and
claude
committed
docs: implementation plan for generic writable custom collections

balegas
and
claude
committed
feat(agents-runtime): add writable flag to CollectionDefinition
balegas
committed
feat(agents-runtime): materialize principal header into virtual column

balegas
and
claude
committed
fix(agents-runtime): strip principal virtual column before client write-back

balegas
and
claude
committed
feat(agents-runtime): emit writable_collections at entity-type registration

balegas
and
claude
committed
feat(agents-server): add writable_collections to entity type
balegas
committed
feat(agents-server): persist and resolve writable_collections

balegas
and
claude
committed
fix(agents-server): persist writable_collections as jsonb column

balegas
and
claude
committed
feat(agents-server): generic writeCollection with principal-header stamping

balegas
and
claude
committed
refactor: rename writable collections to externally writable

balegas
and
claude
committed
fix(agents-server): add fork-work-lock guard to writeCollection

balegas
and
claude
committed
feat(agents-server): POST /collections/:collection generic write route

balegas
and
claude
committed
feat(agents-runtime): comments collection on generic externally-writable interface

balegas
and
claude
committed
feat(agents): declare comments as externally-writable state on horton and worker

balegas
and
claude
committed
feat(agents-runtime): project comments collection into timeline via _principal

balegas
and
claude
committed
fix(agents-runtime): use named imports for CommentTargetValue and CommentSnapshotValue

balegas
and
claude
committed
feat(agents-server-ui): comments UI on generic externally-writable collection

balegas
and
claude
committed
fix(agents-runtime): align timeline fallback sentinel with ~ convention
balegas
committed
chore: changeset for generic externally-writable collections
balegas
committed
fix(agents-server-ui): stamp _principal on optimistic comments for immediate author display

balegas
and
claude
committed
fix(agents-server-ui): register comments custom collection on entity streams

balegas
and
claude
committed
refactor(agents): move comments timeline projection out of the runtime

balegas
and
claude
committed
refactor(agents): drop principalColumn configurability, fix _principal as a reserved virtual column

balegas
and
claude
committed
refactor(agents-server-ui): comments visibility via live query, shared fork-from-here hook

balegas
and
claude
committed
refactor(agents-server-ui): dedupe formatSender, move comment helpers to lib

balegas
and
claude
committed
fix(agents): tolerate legacy principalColumn in registration, misc review cleanups

balegas
and
claude
committed
chore(agents-server): renumber externally-writable-collections migration to 0016 after rebase

balegas
and
claude
committed
fix(agents-server-ui): carry error discriminant on comment timeline rows

balegas
and
claude
committed
chore: drop design spec doc from PR

balegas
and
claude
committed
refactor(agents-runtime): rename timeline extraSources to customSources

balegas
and
claude
committed
test(agents-server): cover schema rejection on writeCollection; refresh changeset wording

balegas
and
claude
committed
chore: bump changeset entries to patch per team convention

balegas
and
claude
committed
feat(agents): gate comments per-agent via comments/v1 contract

balegas
and
claude
committed

Commits on Jun 12, 2026

chore: shorten changeset message

balegas
and
claude
committed