Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
85 commits
Select commit Hold shift + click to select a range
3300269
feat(ai-workspace): register the AI Workspace experiment and admin sc…
whyisjake Sep 3, 2026
1968408
feat(ai-workspace): add a permission-filtered content search ability
whyisjake Sep 3, 2026
cfe6a98
feat(ai-workspace): forward-port PHP AI Client streaming via the SDK …
whyisjake Sep 3, 2026
74d7bd9
feat(ai-workspace): add a streaming transport and Anthropic SSE mapping
whyisjake Sep 3, 2026
60f1a6b
docs(ai-workspace): reconcile the plan with what the branch built
whyisjake Sep 3, 2026
6da8e0b
feat(ai-workspace): add the turn endpoint and permission-filtered too…
whyisjake Sep 3, 2026
95eab07
feat(ai-workspace): add the transcript UI, streaming client and SSE e…
whyisjake Sep 3, 2026
271faaa
feat(ai-workspace): render tool post results as a DataViews table in …
whyisjake Sep 3, 2026
3f3353e
feat(ai-workspace): return an editor URL for posts the user can edit
whyisjake Sep 3, 2026
2bbd4d8
fix(ai-workspace): make function-calling detection and streaming actu…
whyisjake Sep 3, 2026
c1cf3f4
fix(ai-workspace): choose the streaming model deliberately and keep t…
whyisjake Sep 4, 2026
cb41c37
feat(ai-workspace): add propose-then-confirm draft creation
whyisjake Sep 4, 2026
e0080db
feat(ai-workspace): add the block editor handoff into the workspace
whyisjake Sep 4, 2026
287d94e
feat(ai-workspace): give the workspace its own chrome and a way in
whyisjake Sep 4, 2026
58f93eb
fix(ai-workspace): size the AI mark in the editor menu item
whyisjake Sep 4, 2026
2edcf49
docs(ai-workspace): add retrieval legibility and a read tool to the plan
whyisjake Sep 4, 2026
0e841a0
fix(ai-workspace): make the transcript and code blocks scrollable
whyisjake Sep 4, 2026
7a628ee
test(ai-workspace): mock Anthropic and sequence tool-calling turns in…
whyisjake Sep 4, 2026
02a9a97
docs(ai-workspace): document the AI Workspace experiment
whyisjake Sep 4, 2026
e7a727d
fix(ai-workspace): stop advertising a tool the assistant cannot call,…
whyisjake Sep 4, 2026
3ef738f
AI Workspace: add a read-only ability for reading post bodies (U14)
whyisjake Sep 4, 2026
64eb4b0
AI Workspace: report what retrieval withheld, measured not inferred (…
whyisjake Sep 4, 2026
c5bf1d1
chore(ai-workspace): keep the planning artifact out of the repository
whyisjake Sep 4, 2026
3e0866b
fix(ai-workspace): silence an EscapeOutput false positive on thrown e…
whyisjake Sep 4, 2026
31e9adb
fix(sdk-overlay): widen the prefixed-import guard to every PSR namespace
whyisjake Sep 4, 2026
a2d7fa3
feat(ai-workspace): render the retrieval trace, and make full-screen …
whyisjake Sep 4, 2026
b7aa204
fix(ai-workspace): stop the streaming guard fatalling, and never redi…
whyisjake Sep 4, 2026
4eb99df
fix(ai-workspace): filter model-authored draft content before it is s…
whyisjake Sep 4, 2026
f2c13c2
fix(ai-workspace): stop the retrieval trace stating two numbers it ca…
whyisjake Sep 4, 2026
b7bf74a
fix(ai-workspace): keep a stopped turn stopped, and let a failed requ…
whyisjake Sep 4, 2026
265687f
fix(ai-workspace): report the cap that ran, hide the model's thinking…
whyisjake Sep 5, 2026
51df732
fix(ai-workspace): answer every tool call, not only the ones we recog…
whyisjake Sep 5, 2026
ff822fa
fix(ai-workspace): render inside the admin chrome instead of taking t…
whyisjake Sep 5, 2026
45c8969
fix(ai-workspace): keep the line breaks a model wrote inside a paragraph
whyisjake Sep 5, 2026
38e45e6
docs(ai-workspace): describe the screen the plugin actually ships
whyisjake Sep 5, 2026
970929f
fix(ai-workspace): keep a numbered list counting when prose splits it
whyisjake Sep 9, 2026
86085aa
fix(ai-workspace): let the sanitizer test run on multisite
whyisjake Sep 10, 2026
059df5e
feat(ai-workspace): add the tool-admission probe and declaration acce…
whyisjake Sep 9, 2026
89997c5
feat(ai-workspace): admit tools by declaration, on top of a curated f…
whyisjake Sep 9, 2026
fc8172d
feat(ai-workspace): tell the model what its surface actually is
whyisjake Sep 9, 2026
7bd5fb4
feat(abilities-explorer): show and control what the assistant can call
whyisjake Sep 9, 2026
0eef6cf
docs(ai-workspace): describe a tool surface that can grow
whyisjake Sep 9, 2026
0db2ed7
fix(ai-workspace): keep declared abilities off the model until #354
whyisjake Sep 10, 2026
9df9945
docs(ai-workspace): tighten the admission docblocks
whyisjake Sep 10, 2026
6907ef8
fix(abilities-explorer): stop the surface column swamping the table
whyisjake Sep 10, 2026
08da892
feat(abilities-explorer): name every surface an ability is exposed on
whyisjake Sep 10, 2026
276e3ef
fix(abilities-explorer): inherit MCP exposure from the general public…
whyisjake Sep 10, 2026
f3f971e
feat(ai-workspace): resolve admission through the unified public flag
whyisjake Sep 10, 2026
1a18049
fix(ai-workspace): withhold the abilities that read people's data
whyisjake Sep 10, 2026
5227db9
fix(abilities-explorer): stop repeating the reason nobody needs
whyisjake Sep 10, 2026
dcfff18
fix(ai-workspace): withhold the users ability under its new name too
whyisjake Sep 11, 2026
a220496
docs(ai-workspace): follow the content ability to its new name
whyisjake Sep 11, 2026
f931c31
fix(ai-workspace): declare the streaming model only when its parent e…
whyisjake Sep 23, 2026
fa27c32
test(ai-workspace): skip the general public flag tests on WordPress 7.0
whyisjake Sep 23, 2026
0c96aab
Abilities Explorer: move to DataViews and REST (#1074)
whyisjake Sep 29, 2026
e2e9360
Merge branch 'develop' into feat/ai-workspace
whyisjake Sep 30, 2026
68425d6
refactor(ai-workspace): answer every turn buffered until the PHP AI C…
whyisjake Sep 30, 2026
225802b
fix(ai-workspace): leave unsigned thinking out of replayed conversations
whyisjake Oct 1, 2026
5389d99
Merge branch 'develop' into feat/ai-workspace
whyisjake Oct 29, 2026
859ff98
test: keep the workspace tests working on WordPress 7.2
whyisjake Oct 29, 2026
1aba89a
Merge develop into feat/ai-workspace
whyisjake Nov 5, 2026
204db25
AI Workspace: give the composer one hint that names the send shortcut…
whyisjake Nov 5, 2026
a18c83d
AI Workspace: sit in the admin frame and fill the viewport (#1245)
whyisjake Nov 5, 2026
acc5abe
AI Workspace: show "New space" only once a conversation exists (#1239)
whyisjake Nov 6, 2026
ffbd58b
AI Workspace: collapse long code blocks and copy from a corner icon (…
whyisjake Nov 6, 2026
85633ee
AI Workspace: end the turn on a proposal and follow up once (#1254)
whyisjake Nov 6, 2026
b193382
AI Workspace: let the assistant ask a question with choices (#1288)
whyisjake Nov 6, 2026
a39d776
AI Workspace: make the proposal card's next step obvious (#1294)
whyisjake Nov 6, 2026
10708da
AI Workspace: list, filter and count posts for the demo prompts (#1296)
whyisjake Nov 6, 2026
f799620
AI Workspace: propose a block template and create it on approval (#1298)
whyisjake Nov 6, 2026
594e59f
AI Workspace: word the starter prompts so each one reaches a result (…
whyisjake Nov 6, 2026
f92515d
Merge branch 'develop' into feat/ai-workspace
whyisjake Nov 6, 2026
8ae510f
test(abilities-explorer): expect the Exposed in column in the default…
whyisjake Nov 6, 2026
26ace3f
Merge #1300 from feat/ai-workspace into the develop sync
whyisjake Nov 6, 2026
7edee04
AI Workspace: keep chats, with routes to list, rename, archive and de…
whyisjake Nov 6, 2026
fa40f00
AI Workspace: a Chats panel to reopen, rename, archive and delete pas…
whyisjake Nov 6, 2026
39f8f95
Update our test to use `prepare_input` instead of `coerce_input` (#1343)
dkotter Nov 10, 2026
3505baa
fix(ai-workspace): match the settings screen's notice when no connect…
whyisjake Nov 12, 2026
d1b8ba2
Merge develop into feat/ai-workspace
whyisjake Nov 12, 2026
57fcee7
AI Workspace: propose changes to existing posts and the site title, a…
whyisjake Nov 13, 2026
2cce4d4
AI Workspace: answer site questions and link to the right admin scree…
whyisjake Nov 13, 2026
93dd2ae
AI Workspace: AI suggestions and "Ask AI" in the Command Palette (#1316)
whyisjake Nov 13, 2026
1af9b02
AI Workspace: agent audit trail, chats in personal-data export and er…
whyisjake Nov 13, 2026
5832360
AI Workspace: document it as the one agent (#1318)
whyisjake Nov 13, 2026
e752260
AI Workspace: a top-level Workspace menu, spaces rather than chats
whyisjake Nov 18, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .wp-env.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@
"core": null,
"plugins": [
".",
"https://downloads.wordpress.org/plugin/ai-provider-for-anthropic.zip",
"https://downloads.wordpress.org/plugin/ai-provider-for-google.zip",
"https://downloads.wordpress.org/plugin/ai-provider-for-openai.zip"
],
Expand Down
1 change: 1 addition & 0 deletions .wp-env.test.json
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@
"plugins": [
".",
"./tests/e2e-testing",
"https://downloads.wordpress.org/plugin/ai-provider-for-anthropic.zip",
"https://downloads.wordpress.org/plugin/ai-provider-for-google.zip",
"https://downloads.wordpress.org/plugin/ai-provider-for-openai.zip"
],
Expand Down
24 changes: 24 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,30 @@
All notable changes to this project will be documented in this file, per [the Keep a Changelog standard](http://keepachangelog.com/), and will adhere to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased] - TBD
### Added
- New Experiment: AI Workspace; a dedicated `Tools → AI Workspace` screen where you hold a multi-step, site-aware conversation with an assistant. The assistant can search your content under your own capabilities, renders post results as a table, and writes nothing until you approve a proposal, which shows the exact values -- including the post status -- that will be written ([#282](https://github.com/WordPress/ai/issues/282)).
- New `ai/search-content` Ability that runs a bounded, capability-filtered full-text search across the post types exposed to abilities, returning titles and excerpts rather than post bodies. Registered by the AI Workspace experiment, so it is also available to the REST `abilities` endpoints, the Abilities Explorer and MCP clients ([#282](https://github.com/WordPress/ai/issues/282)).
- New `ai/get-site-info` Ability that returns the site's name, tagline, home URL, language, timezone, date and time formats, active theme and whether it is a block theme, plus the WordPress and PHP versions for users who can view Site Health (`view_site_health_checks`). It never returns the admin email, the WordPress address, database details or the plugin list, which is why the AI Workspace offers it while withholding the broad `core/get-environment-info` and `core/settings-get` ([#1287](https://github.com/WordPress/ai/issues/1287)).
- New `ai/find-admin-screens` Ability that answers "where do I…" with links: given a short description such as "hide my site from google", it returns up to five matching admin screens from a curated map of core screens, only those the current user can open, each linked with `admin_url()`. Matching runs on the server with no model call, and the map is filterable through `wpai_admin_screens` ([#1287](https://github.com/WordPress/ai/issues/1287)).
- The AI Workspace can propose changes to things that already exist: a post's title, excerpt or content (`ai/propose-post-changes`), and the site title or tagline (`ai/propose-site-identity`). Nothing changes until the person approves. The card shows each current value beside the new one, says when a change goes live as soon as it is approved, and lets the person edit a value first. Approving is strictly one-time, and a value that changed since it was proposed is left alone and reported. This brings in the Site Agent's write actions from [#1214](https://github.com/WordPress/ai/pull/1214) as part of the AI Workspace ([#1287](https://github.com/WordPress/ai/issues/1287)).
- The command palette (Cmd/Ctrl+K) suggests admin screens with AI when a search finds nothing of its own, and offers "Ask AI: <search>" to carry the question into the AI Workspace, unsent. It is part of the AI Workspace experiment rather than an experiment of its own, bringing in [#1250](https://github.com/WordPress/ai/pull/1250) ([#1287](https://github.com/WordPress/ai/issues/1287)).
- Every AI Workspace tool call, including a withheld one, and every proposal event (created, edited, declined, expired, failed, or refused because its chat was deleted) is recorded in the AI Request Log under a new `agent` type, and the log screen gains a `denied` status. No row records post content or option values ([#1287](https://github.com/WordPress/ai/issues/1287)).
- Saved AI Workspace chats are included in `Tools → Export Personal Data` and removed by `Tools → Erase Personal Data`, archived chats included, whether or not the experiment is on ([#1287](https://github.com/WordPress/ai/issues/1287)).
- A Wapuu shows while an AI Workspace turn runs, finishes or fails, from the set Jeffrey Paul (@jeffpaul) posted, derived from Kazuko Kaneuchi's original Wapuu. With reduced motion it is a still frame ([#1287](https://github.com/WordPress/ai/issues/1287)).
- The AI Workspace's tool surface is no longer a fixed list. An ability exposed to the surface -- through `meta.public`, or by naming the `ai-workspace` channel -- and annotated `readonly: true`, `destructive: false`, `open_world: false` -- can be offered to the assistant alongside the three that ship with it. Admission defaults to refusing: an ability that is not public, and has not opted in, is never offered. Declaration-based admission is itself switched **off** until [#354](https://github.com/WordPress/ai/issues/354) settles the channel name, so the shipped surface is still the three curated abilities; `add_filter( 'wpai_workspace_tool_admission_enabled', '__return_true' )`, or the `WPAI_WORKSPACE_TOOL_ADMISSION` constant, turns it on to try it. A short list of core abilities that read personal data, settings or environment detail is never admitted whatever they declare, filterable through `wpai_workspace_withheld_abilities`. Exposure and the annotations are both the ability author's self-attestation, and the effect class is a declared intent rather than an enforced property: the site owner's Explorer controls and the execute-time `permission_callback` remain the boundaries ([#1003](https://github.com/WordPress/ai/issues/1003)).
- The Abilities Explorer shows which abilities the AI Workspace assistant can call, the exact description text the model receives, and why any other ability is excluded. A site owner can remove an ability from the surface or switch the policy off entirely and return to the three that ship ([#1003](https://github.com/WordPress/ai/issues/1003)).

### Developer
- `wpai_workspace_tool_candidates` may add an ability that carries no declaration, but no longer bypasses the effect-class check: an ability that is not `readonly`, is `destructive`, or may reach outside the site is dropped from the surface even when a filter adds it. The three abilities that ship are exempt, so `ai/propose-drafts` keeps its place ([#1003](https://github.com/WordPress/ai/issues/1003)).
- New temporary filter `wpai_workspace_tool_admission_enabled` (and the matching `WPAI_WORKSPACE_TOOL_ADMISSION` constant) switches declaration-based admission on ahead of [#354](https://github.com/WordPress/ai/issues/354); both are removed when it lands. Separate from the site owner's admission-policy off switch on the Abilities Explorer, which stays ([#1003](https://github.com/WordPress/ai/issues/1003)).
- The site owner's tool removals are applied wherever the workspace builds its candidate list, rather than through a filter registered by the workspace experiment's bootstrap, so a removal holds on a site that runs the Abilities Explorer without the workspace ([#1003](https://github.com/WordPress/ai/issues/1003)).
- New filters for the AI Workspace: `wpai_workspace_tool_candidates` (the ability allowlist offered to the model), `wpai_workspace_max_rounds`, `wpai_workspace_system_instruction`, `wpai_workspace_stream_emitter` and `wpai_has_function_calling_support` ([#282](https://github.com/WordPress/ai/issues/282)).
- New `wpai_agent_event` action, fired for every AI Workspace agent event with its operation, status, context and error message, whether or not AI Request Logging is on. It covers agent turns and approvals, not direct MCP calls to an ability ([#1287](https://github.com/WordPress/ai/issues/1287)).
- New filters `wpai_workspace_write_proposals_enabled` (default `true`), which turns off the proposals that change existing content, and `wpai_workspace_proposal_kinds`, the list of proposal types the tools, turn rules and system instruction are built from ([#1287](https://github.com/WordPress/ai/issues/1287)).
- The AI Workspace's own abilities (`ai/propose-*` and `ai/ask-user`) declare `meta.mcp.public` as false, so MCP clients are no longer offered tools that only work inside a workspace turn. An override on the MCP Access screen still wins ([#1287](https://github.com/WordPress/ai/issues/1287)).
- `ai/read-content-bodies` accepts `raw: true` to return a post's stored block markup, only for posts the user can edit ([#1287](https://github.com/WordPress/ai/issues/1287)).
- AI Workspace tool-call and write rows in the AI Request Log now use the `agent` type; rows logged before keep the `ability` type ([#1287](https://github.com/WordPress/ai/issues/1287)).
- Documented how to run the PHP and e2e suites in one session: `npm run test:php` reinstalls WordPress in the shared test environment and deactivates the plugins, so they must be re-activated before `npm run test:e2e` ([#282](https://github.com/WordPress/ai/issues/282)).

## [1.5.0] - 2026-10-29
### Added
Expand Down
1 change: 1 addition & 0 deletions CREDITS.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,3 +20,4 @@ The following software libraries are utilized in this repository.

* [c2pa-node](https://github.com/contentauth/c2pa-node) test fixtures (`XCA.jpg`, `A.jpg`) by Adobe, licensed MIT. Used as real-world signed JPEG assets in `tests/fixtures/c2pa/` to verify the JPEG APP11 manifest reader.
* [HTML to MD](https://github.com/dmsnell/html-to-md) by Dennis Snell. Used to convert HTML to Markdown.
* Wapuu working sprites (`src/experiments/ai-workspace/assets/wapuu/`), from the set [Jeffrey Paul (@jeffpaul)](https://github.com/jeffpaul) shared on [#1287](https://github.com/WordPress/ai/issues/1287). The sprites are derived from the [original Wapuu](https://wapu.us/wapuu-history-origin/) by Kazuko Kaneuchi, licensed under GPL-2.0-or-later. Used for the AI Workspace's busy, done and error states.
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,6 +57,7 @@ Everything is opt-in and off by default. Features are stable and supported; Expe

* **[Abilities Explorer](docs/experiments/abilities-explorer.md)** – Discover, inspect, test, and document all abilities registered via the WordPress Abilities API.
* **[AI Request Logging](docs/experiments/ai-request-logging.md)** – Logs AI requests for observability and debugging.
* **[AI Workspace](docs/experiments/ai-workspace.md)** - Hold a multi-step conversation about your own site under Tools. The assistant searches and reads your content, answers questions about the site, links the admin screen for a task, and proposes new drafts and templates or changes to posts and the site title and tagline, which happen only once you approve them. It also adds an AI fallback and an "Ask AI" row to the command palette.
* **[Alt Text Generation](docs/experiments/alt-text-generation.md)** - Generates descriptive alt text for images using AI vision models.
* **[Block Container Label Generation](docs/experiments/block-container-label-generation.md)** - Generates short List View labels for Group, Columns, and other container blocks.
* **[Comment Moderation](docs/experiments/comment-moderation.md)** (runs automatically) - Automatically moderate comments based on toxicity detection and sentiment analysis, and give each comment a value score. Includes guest comments by default.
Expand Down Expand Up @@ -108,7 +109,6 @@ Overview of planned features:

* **AI Playground** – Experiment with different AI models and providers.
* **Content Assistant** – AI-powered writing and editing in Gutenberg.
* **Site Agent** – Natural language WordPress administration.
* **Workflow Automation** – AI-driven task automation.

## Developer Experience
Expand Down
2 changes: 1 addition & 1 deletion composer.json
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@
"scripts": {
"format": "phpcbf --standard=phpcs.xml.dist",
"lint": "phpcs --standard=phpcs.xml.dist",
"phpstan": "phpstan analyse --memory-limit=1G",
"phpstan": "phpstan analyse --memory-limit=2G",
"test": "phpunit --strict-coverage"
},
"scripts-descriptions": {
Expand Down
22 changes: 18 additions & 4 deletions docs/TESTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,17 +54,31 @@ While specific examples are provided in the "Post Duplication Feature" strategy,
### Local Development

```bash
# Run all tests
composer test
# Run the PHP suite. This is the command to use.
npm run test:php

# Run static analysis (fast, focuses on type safety)
composer phpstan
```

**Run the PHP suite through `npm run test:php`, not through `phpunit` directly.**
That script scopes the run to the `.wp-env.test.json` environment, which has its
own database. Invoking `vendor/bin/phpunit` or `composer test` inside the default
`wp-env` container instead resolves `DB_NAME` to the development site's own
database, and the WordPress test bootstrap then reinstalls WordPress over it —
deactivating plugins, deleting posts, and clearing options including provider
credentials. The suite passes while doing it, so the damage is silent.

### Running both suites in one session

# Run the current PHPUnit suite defined in phpunit.xml.dist
vendor/bin/phpunit -c phpunit.xml.dist
`npm run test:php` reinstalls WordPress in the shared `wp-env` test environment, which **deactivates the plugins**. A `npm run test:e2e` run that follows it then fails in its `enableExperiment()` helper, because the settings screen it relies on is gone. Re-activate the plugins between the two suites:

```bash
npm run wp-env:test run cli -- wp plugin activate ai ai-provider-for-anthropic ai-provider-for-google ai-provider-for-openai
```

Running the e2e suite first, as [CONTRIBUTING.md](../CONTRIBUTING.md) does, avoids the problem entirely.

### CI/CD Pipeline

Automated testing in CI should run the currently configured unit and end-to-end suites on every push and pull request.
Expand Down
Loading
Loading