get_extraction_status
Check if a channel's messages are fully extracted before trusting retrieval results. Get counts per extraction state: pending, extracting, done, failed.
Instructions
Report how far fact EXTRACTION has progressed for a channel's messages, as a count per status. Call it to judge whether a channel's knowledge is fully ingested before you trust retrieval results, or to track progress after triggering a sync.
Distinguish from get_job_status: this counts MESSAGES by extraction state (corpus readiness); get_job_status reports the lifecycle of one async JOB by job_id. Use this for "is this channel done extracting?"; use get_job_status for "did my trigger_sync/refresh_wiki job finish?".
When to use: gauge corpus completeness, or detect a backlog (high
pending) or failures (non-zero failed) before relying on
ask_channel/search_channel_facts.
Prerequisites: a channel_id from list_channels.
Returns (instant, read-only): {channel_id, counts: {pending, extracting, done, failed}, total} where each count is the number of
messages in that state and total is their sum. No side effects.
Error modes (returned as dicts): 'authentication_missing' (no principal); 'channel_access_denied' (token lacks access to channel_id); 'extraction_status_failed' (internal error reading the queue).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| channel_id | Yes | Channel id whose extraction progress to report. Get it from list_channels (e.g. 'ch-eng'). Required. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||