@kadoa/mcp 0.5.31 → 0.5.32

package/README.md

@@ -62,11 +62,9 @@ Point your client to `https://mcp.kadoa.com/mcp` with OAuth authentication.
 | Tool | Description |
 |------|-------------|
 | `scrape` | Immediately fetch one URL as markdown or raw HTML (shown only for enabled workspaces) |
-| `list_inbox` | List personal unread Inbox items across workflows, optionally including read history |
-| `mark_inbox_item_read` | Acknowledge one Inbox item without performing its underlying workflow action |
 | `create_workflow` | Create an agentic navigation workflow from a prompt |
 | `create_realtime_monitor` | Create an asynchronous realtime monitoring workflow after persisting notification channels; returns workflow/session/thread/job IDs |
-| `list_workflows` | List workflows with status, Assistant session availability, template version drift, and realtime freshness or health |
+| `list_workflows` | List workflows with status, Assistant session availability, template version drift, realtime health, and `awaitingUserInput`; filter with `statusFilters: ["group:attention"]` for everything waiting on you |
 | `get_workflow` | Get canonical intent, Assistant/session, template ownership, run health, schedule, location, monitoring, and validation details |
 | `request_workflow_update` | Ask the workflow Assistant to change extraction intent, navigation, sourcing, pagination, or generated behavior without changing the workflow ID |
 | `get_workflow_assistant` | Get the workflow Assistant's current activity and any pending clarification question |
@@ -90,10 +88,9 @@ Point your client to `https://mcp.kadoa.com/mcp` with OAuth authentication.
 
 ## Workflow controls and behavior
 
-For detailed customer guidance, see the [Kadoa documentation](https://docs.kadoa.com/docs/introduction), including [workflows](https://docs.kadoa.com/docs/workflows/overview), [Workflow Assistant](https://docs.kadoa.com/docs/sdk/workflows/assistant), [Personal Inbox](https://docs.kadoa.com/docs/sdk/inbox), [notifications](https://docs.kadoa.com/docs/notifications), and [templates](https://docs.kadoa.com/docs/templates).
+For detailed customer guidance, see the [Kadoa documentation](https://docs.kadoa.com/docs/introduction), including [workflows](https://docs.kadoa.com/docs/workflows/overview), [Workflow Assistant](https://docs.kadoa.com/docs/sdk/workflows/assistant), [notifications](https://docs.kadoa.com/docs/notifications), and [templates](https://docs.kadoa.com/docs/templates).
 
 - **Assistant work vs. schedule:** `interrupt_workflow_assistant`, `resume_workflow_assistant`, and `stop_workflow_assistant` control the Assistant session only; they do not pause scheduled workflow runs. Use `pause_workflow` to stop an active workflow's schedule and `approve_workflow` to activate it again.
-- **Inbox acknowledgement:** `mark_inbox_item_read` only acknowledges an item. For an Assistant question, inspect it with `get_workflow_assistant`, then use `answer_workflow_assistant_question` to answer and resume; use `resume_workflow_assistant` only for an idle or interrupted Assistant.
 - **Run history:** `list_workflow_runs` filters by `status` (`success`, `failed`, or `in_progress`) and supports 1-based `page` and `limit` pagination.
 - **Notifications:** `create_realtime_monitor` requires at least one email, webhook, Slack, or WebSocket notification channel. Notifications are optional when creating a standard one-time or scheduled workflow with `create_workflow`.
 - **Template changes:** `update_template` changes template name and description only. To change template-controlled configuration, create an immutable version with `create_template_version`, then roll it out to linked workflows with `apply_template_version`.
@@ -114,17 +111,6 @@ its own when a site blocks bots. Ask for HTML when you need the raw source.
 
 The `scrape` tool is available only to workspaces enabled for the Scrape API. Use a workflow instead for structured extraction, recurring runs, monitoring, or multi-page navigation.
 
-### Review work that needs attention
-
-```
-> You: What needs my attention in Kadoa?
-
-Claude calls list_inbox and shows unread questions and review items across
-workflows. For an Assistant question, it calls get_workflow_assistant to load
-the authoritative question before asking whether you want to answer it.
-Marking the Inbox item read only acknowledges it.
-```
-
 ### Create and run a workflow
 
 ```
@@ -181,6 +167,24 @@ one-time or scheduled workflow fails, call run_workflow again with the same
 workflow ID and configuration - never delete and recreate it just to retry.
 ```
 
+### Review work that needs attention
+
+```
+> You: What needs my attention in Kadoa?
+
+Claude calls list_workflows with statusFilters ["group:attention"], which
+returns the same workflows the dashboard shows under "Needs your attention".
+A row's awaitingUserInput.prompt holds the Assistant's question when there is
+one; a row with awaitingUserInput but no prompt is a setup the user left
+unfinished; a row with displayState PREVIEW and no awaitingUserInput is
+preview data to review or approve. Claude answers a question with
+get_workflow_assistant then answer_workflow_assistant_question, resumes an
+unfinished setup with resume_workflow_assistant or request_workflow_update,
+and approves preview data with approve_workflow. Workflows with an open
+support ticket are excluded from this group and appear under group:support
+instead.
+```
+
 ### Update deterministic workflow settings
 
 ```