Tribal: Check Ingest Job Status
tribal_job_statusCheck the progress of an ingest job and retrieve its completion status, with optional blocking until the job finishes.
Instructions
Check the progress of an ingest job submitted via tribal_ingest.
Job lifecycle: queued → extracting → triaging → relating → completed/failed
Terminal states:
"completed": Pipeline ran to conclusion. Check outcome for details:
"success": All candidates triaged successfully and relations committed.
"partial": Some triage tasks failed permanently; the relation task ran on a subset.
"empty": Relation task ran with zero items to relate (all duplicates or all triage failures). If tasks_failed > 0, the pipeline likely failed at triage; treat as degraded rather than "nothing new".
"failed": Pipeline could not complete. outcome = "failure". Check error context.
Set wait_seconds to block until the job completes or the timeout expires. This collapses ingest + poll into a single round-trip for fast operations. With wait_seconds=0 (default), returns immediately with current status.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job_id | Yes | Job ID returned by tribal_ingest. | |
| wait_seconds | No | If > 0, the server blocks until the job reaches a final status (completed or failed) or the timeout expires, whichever comes first. Returns current status either way. Use this to collapse ingest + poll into fewer round-trips for fast operations. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| batch_size | No | Number of knowledge candidates extracted. Set after extraction completes. | |
| created_at | Yes | ||
| items_created | Yes | New knowledge items stored (novel content). | |
| job_id | Yes | ||
| observations_created | Yes | Duplicate observations recorded (strengthens existing items). | |
| outcome | No | Final result. Only set when status is 'completed' or 'failed'. | |
| status | Yes | Current lifecycle state. | |
| tasks_completed | Yes | Triage tasks completed successfully. | |
| tasks_failed | Yes | Triage tasks that failed permanently. | |
| updated_at | Yes |