openclaw/docs/start
Peter Steinberger 1e9d918037
feat(sdk): always persist media facts and ship facts-first replacements for legacy Media* surfaces (#113355)
* feat(sdk): always persist media facts and ship facts-first replacements for legacy Media* surfaces

PR 1 of the media legacy retirement program (audit-frozen, 4 PRs).

- Every media-bearing user turn now persists normalized __openclaw.media
  facts unconditionally while continuing to emit the legacy top-level
  Media* projection byte-identically (dual-write bridge; the conditional
  shouldPersistStructuredMediaEntries gate now always includes media).
- New replacement APIs, shipped before any removal: typed hook media
  facts (media[], originalMedia[], mediaStagingPending) on message
  events; {{AttachmentPath}}/{{AttachmentUrl}}/{{AttachmentContentType}}/
  {{AttachmentDir}}/{{AttachmentIndex}} template variables; focused
  openclaw/plugin-sdk/media-local-roots subpath split out of the
  deprecated agent-media-payload facade.
- Every legacy surface carries @deprecated naming its replacement, under
  one named compatibility record media-legacy-projection with the
  operator-approved removeAfter 2026-10-01 (two release trains; deletion
  additionally gates on a clean published-plugin artifact sweep).
- Generic transcript append invariant documented; SDK migration, hooks,
  and configuration docs updated to the facts-first path.

Writer golden matrix proves legacy bytes and model prompt bytes are
unchanged while nested facts become unconditional. 2,189 broad media
tests green; SDK api-baseline regenerated on fresh-env Testbox.

* feat(sdk): register media-local-roots subpath exports and deprecation metadata

Completes PR 1: package export map for openclaw/plugin-sdk/media-local-roots
plus the deprecated-subpath inventory and doc metadata entries for the
media-legacy-projection record.

* chore(sdk): track media-local-roots entrypoint and deprecated-export budgets

* fix(sdk): keep deprecated MSTeams buildMediaPayload re-export through the compat window

Deleting shipped runtime-api re-exports belongs to retirement PR 4 after
the media-legacy-projection window; PR 1 only deprecates. Also formats
the migration-guide schedule table.

* docs: regenerate docs map for media migration additions
2026-07-24 10:42:17 -07:00
..
bootstrapping.md fix(bootstrap): let users name new agents (#112009) 2026-07-20 20:12:59 -06:00
docs-directory.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
getting-started.md fix(sqlite): reject runtimes vulnerable to WAL corruption (#106065) 2026-07-13 13:59:00 +08:00
hubs.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
lore.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
onboarding-overview.md feat(setup): rename Crestodian to OpenClaw system agent 2026-07-14 11:03:02 -07:00
onboarding-redesign.md feat(wizard): narrate app-recommendation scan phases in the progress spinner (#112414) 2026-07-21 22:13:36 -07:00
onboarding.md fix(onboard): verify imported and local inference (#112028) 2026-07-20 21:35:22 -07:00
openclaw.md feat(sdk): always persist media facts and ship facts-first replacements for legacy Media* surfaces (#113355) 2026-07-24 10:42:17 -07:00
quickstart.md docs: add Related sections to remaining platform, reference template, and misc pages 2026-04-23 20:40:15 -07:00
setup.md fix(sqlite): reject runtimes vulnerable to WAL corruption (#106065) 2026-07-13 13:59:00 +08:00
showcase.md docs: add X-verified builds and devtools to showcase 2026-07-06 08:16:12 -07:00
wizard-cli-automation.md refactor(config): config-surface reduction tranche 3 — product consolidations (review request) (#111527) 2026-07-21 20:28:43 -07:00
wizard-cli-reference.md feat(channels): add channel-owned setup contracts (#112176) 2026-07-22 19:57:42 -04:00
wizard.md refactor(config): config-surface reduction tranche 3 — product consolidations (review request) (#111527) 2026-07-21 20:28:43 -07:00