Handbook

Task `playwright_sharepoint_page_health` v1

Deprecated — use sharepoint_probe_library_health.

Updated

Task playwright_sharepoint_page_health v1

Deprecated — use sharepoint_probe_library_health.

Summary

Read-only probe of a SharePoint library page through an attached Playwright session. Returns readiness signals (offline, sign-in, row counts) without harvesting items.

Inputs

Field Type Required Notes
session_ref string yes Registered session handle
url string no Explicit navigation URL
query object no May include site_url, library_path

Output

Field Type Required
schema_version string yes
ready boolean yes
offline boolean yes
sign_in_required boolean yes
row_count integer yes
file_row_count integer yes
hints array yes
warnings array no

Read-only policy

Navigate and evaluate read-only health scripts only; no writes or Copilot UI automation.

Examples

{
  "session_ref": "health-session",
  "url": "https://contoso.sharepoint.com/sites/Engineering/Forms/AllItems.aspx"
}

{
  "schema_version": "1",
  "ready": true,
  "offline": false,
  "sign_in_required": false,
  "row_count": 2,
  "file_row_count": 2,
  "hints": [],
  "warnings": []
}

Failure modes

Kind When
not_attached Invalid session_ref or session not bound.
policy_denied URL disallowed by read-only navigation policy.
navigation_error Approved navigation failed.
unsupported_operation Session lacks evaluate_readonly.
SchemaFailure Output wire JSON does not match contract.json.

Verification

Offline tests with EvaluatingFakePlaywrightSession in tests/playwright/test_playwright_sharepoint_tasks.py.

Changelog

Version Notes
v1 Initial SharePoint page health probe task.