Repository navigation
feat(automations): read the stream of activities over the API, MCP and the assistant - #428
Merged
Merged
Conversation
…d the assistant
GET /api/v1/activities (newest first, with filters and paging),
/activities/kinds and /activities/{id}; the MCP tools timeline and
event_kinds; and the assistant's timeline tool. Each person sees only
their namespaces and the activities meant for them.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01RFQUkVmALkdhRqXY1yFxW5
16 of 22 tasks
adeelahmad
added a commit
that referenced
this pull request
Oct 15, 2026
… in progress (#430) The stream of activities (#425 to #428) merged: agents read it through the API, MCP's timeline tool and the assistant. Say so under Automate it, with automations that act on it labelled in progress, add the open Settings section (#429) to In progress, and link the automations page from the docs index. Claude-Session: https://claude.ai/code/session_01HDx7PPUauyjMn1LZs8JAsS Co-authored-by: Adeel Ahmad <noreply@anthropic.com>
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.
Requested by Adeel · project thread
Description
Before: the stream of activities (new assets and the event log) could only be read from Python inside the server.
After: people and agents read it the same way.
GET /api/v1/activitieslists what happened, newest first, as Activity Streams 2.0 activities with a Lens kind, filtered by kinds, actor, namespace, tag, time, words or a match tree, and paged withnext;GET /api/v1/activities/kindsis the kinds catalog (label, source, parent and children, a JSON Schema with field titles, untrusted fields, a sample);GET /api/v1/activities/{id}is one activity. Agents get the same through the MCP toolstimelineandevent_kindsand the assistant'stimelinetool. Everyone sees only what their namespaces and each activity's audience allow; an app signed in by an admin over OAuth reads every namespace but not what is for admins alone.How: thin routes over
events.page/events.get/events.kindswith response models (fields a source leaves out stay out, so the API's JSON equals what MCP gives), the MCP tools call the routes' helpers, and the assistant tool keeps to the conversation's namespaces and the recordings it may read. Fourth part of workflow studio module M1.Motivation and Context
Workflow studio plan (
/mnt/project-files/workflow-studio/plan.md, M1 step 4); differences from the plan are in/mnt/project-files/workflow-studio/m1-notes.md.Types of changes
!in the title)Checklist:
make hookschecks it on commit).docs/accordingly.## UnreleasedinCHANGELOG.md. (n/a: the title says it)Done questions (AGENTS.md)
timelineandevent_kinds, the assistant'stimeline, and the REST routes.lens.untrusted; the assistant tool stays in its conversation's namespaces.tests/api/test_activities.py(newest first, visibility per person, filters, paging, errors, kinds; MCP and the assistant give the same as the API; a follower in two processes handles each new asset once); docs/api.md, docs/mcp.md, docs/assistant.md, docs/automations.md;openapi.jsonand the client regenerated withmake openapi's commands.events.page,matchtrees, the MCP tool and assistant Toolbox patterns,Access.readable/nsid.🤖 Generated with Claude Code
https://claude.ai/code/session_01RFQUkVmALkdhRqXY1yFxW5
Generated by Claude Code