Conversation sessions need a queryable product scope for project-bound transcripts
Nobody has claimed this yet.
Assessment
- Difficulty
- 5/5
- Estimated time
- Over a week
- Newbie friendliness
- 50/100
- Issue type
- Feature
- Clarity
- Mostly clear
- Activity status
- Quiet
- Tech stack
- php
- Domain
- backend-api-design
Research direction
Start with the create/list ability definitions in src/Transcripts/register-agents-conversation-session-abilities.php:201-204 and 595-598, then trace persistence and filtering in src/Transcripts/class-wp-agent-cpt-conversation-store.php:151 and 225-256. Define a product-neutral scope or constrained metadata contract, then verify that callers can create scoped sessions and that the list/bootstrap path returns only the requested scope.
Written by the indexing model from the issue text.
Description
Problem
WordPress Build can store product target metadata on chat sessions, but the generic conversation-session list path only filters by owner, agent, and context. A product cannot ask for "the latest chat session for project X" through the canonical session surface.
Evidence
src/Transcripts/register-agents-conversation-session-abilities.php:201-204accepts arbitrarymetadataon create.src/Transcripts/register-agents-conversation-session-abilities.php:595-598documents metadata as JSON-serializable product-specific data.src/Transcripts/class-wp-agent-cpt-conversation-store.php:236-256lists sessions with owner/workspace plus optionalagent_slugandcontextfilters only.src/Transcripts/class-wp-agent-cpt-conversation-store.php:151andsrc/Transcripts/class-wp-agent-cpt-conversation-store.php:225persist metadata as opaque JSON, so nested product keys are not queryable by the generic list.
Needed Primitive
Add a runtime-neutral way to scope/query conversation sessions, for example:
- a canonical
session_scope/thread_scopestring on session create/list; or - a constrained metadata filter/index contract for namespaced product keys.
Acceptance Criteria
- A caller can create a session scoped to an opaque product key like
wp-build-project:123without Agents API knowing what that means. - The list/bootstrap path can return sessions for that scope only.
- The shape remains product-neutral and works for non-WordPress-Build callers.
Downstream WP Build issue will link here; the product need is project-scoped transcripts so switching projects switches/restores the right chat.
- Dominant language
- PHP
- Stars
- 33
- Forks
- 8
- Avg merge
- 1h 39m
- Merged PRs (30d)
- 30
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from Automattic/agents-api
-
enhancement
Difficulty 4/5 3-5 days Newbie friendliness 45/100
Automattic/agents-api#552 ·
-
enhancement
Difficulty 5/5 Over a week Newbie friendliness 45/100
Automattic/agents-api#551 ·
-
enhancement
Difficulty 4/5 3-5 days Newbie friendliness 68/100
Automattic/agents-api#550 ·
-
enhancement
Difficulty 5/5 Over a week Newbie friendliness 45/100
Automattic/agents-api#549 ·
-
Difficulty 5/5 Over a week Newbie friendliness 28/100
Automattic/agents-api#529 ·
All issues in Automattic/agents-api
Similar issues
-
priority: p3
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
googleapis/librarian#7636 ·
-
0. Needs triage bug
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
nextcloud/fulltextsearch#1011 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
phpstan/phpstan-doctrine#794 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
Automattic/static-site-importer#1767 ·