Handbook

Task `playwright_normalize_sharepoint_url` v1

Deprecated — use sharepoint_normalize_library_url (same runner; removed next release).

Updated

Task playwright_normalize_sharepoint_url v1

Deprecated — use sharepoint_normalize_library_url (same runner; removed next release).

Summary

Pure URL normalization for SharePoint document libraries: resolves entry_url, reader_root, and site_top from a site or Forms link. No browser session and no LLM.

Inputs

Field Type Required Notes
site_url string yes Site or library Forms URL
library_path string no Optional library segment under the site

Output

Field Type Required
schema_version string yes
entry_url string yes
reader_root string yes
site_top string yes

Read-only policy

No navigation, credentials, or mutation — deterministic string transforms only.

Examples

{
  "site_url": "https://contoso.sharepoint.com/sites/Engineering"
}

{
  "schema_version": "1",
  "entry_url": "https://contoso.sharepoint.com/sites/Engineering/Shared%20Documents/Forms/AllItems.aspx",
  "reader_root": "https://contoso.sharepoint.com/sites/Engineering/Shared%20Documents",
  "site_top": "https://contoso.sharepoint.com/sites/Engineering"
}

Failure modes

Kind When
invalid_query Missing or unparseable site_url.
SchemaFailure Output wire JSON does not match contract.json.

Verification

Offline unit tests in tests/playwright/test_sharepoint_urls.py and tests/playwright/test_playwright_sharepoint_tasks.py.

Changelog

Version Notes
v1 Initial SharePoint URL normalization task.