Skip to content

v2.11.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 23 May 12:44
· 1102 commits to main since this release
v2.11.0
79c0266

run402 v2.11.0 — Astro SSR runtime

The agent-side surface for the Astro SSR runtime + ISR cache that landed on the gateway as v1.52. Pairs with @run402/functions@2.6.0 and @run402/astro@1.0.0-alpha.1.

SDK (@run402/sdk@2.11.0)

New 22nd namespace: r.cache — origin-cache inspection and invalidation:

  • r.cache.invalidate(url) — single URL, sub-second freshness
  • r.cache.invalidatePrefix({ host, prefix }) — path-prefix bulk
  • r.cache.invalidateAll({ host }) — wipe a host's cache
  • r.cache.invalidateMany(urls) — batch
  • r.cache.inspect(url, { locale?, releaseId? }) — peek without warming the cache; returns { status: 'HIT' | 'MISS', cachedAt, expiresAt, contentSha256, writtenUnderGeneration }

Project-scoped (server-validated; cross-project hosts throw R402_CACHE_INVALIDATION_HOST_FORBIDDEN). Generation-guarded — in-flight MISS renders started before an invalidate cannot overwrite the freshly-cleared state.

CLI (run402@2.11.0)

Five new top-level commands, all agent-DX shortcuts for the SSR loop:

  • run402 cache invalidate <url> (also --prefix, --all) — same surface as the SDK
  • run402 cache inspect <url> (also --locale, --release-id, --json)
  • run402 init astro — scaffolds an Astro 5/6 project wired to Run402 (astro.config.mjs with @run402/astro 1.0 preset, [slug].astro SSR template wired to the DB, layouts, .env.example)
  • run402 dev — runs npx astro dev with .env.local and Run402 credentials in scope
  • run402 doctor — 5 health checks (credentials, allowance, project, network, SDK build), --json for machine-readable output, exit 1 on fail
  • run402 logs --request-id req_XYZ — fetch logs for a specific request id across every function in the project (parallel scan, timestamp-ascending merge)

MCP (run402-mcp@2.11.0)

Lockstep-published. No new MCP tools yet for cache — the SDK r.cache namespace is the canonical surface; MCP host agents can call into it via the existing mcp__run402_sdk boundary or shell out to the CLI.

Compat / breaking

None. All additions are additive — existing SDK methods, CLI commands, and MCP tools are unchanged.

Doc updates

The whole agent-doc surface was refreshed in lockstep:

  • AGENTS.md — bumped 21 → 22 namespaces; new architecture section on v1.52 ISR cache substrate, generation guard, ALS taint
  • README.md — same bump; new Astro SSR + cache pitch paragraph
  • SKILL.md + openclaw/SKILL.md — new 'Astro SSR runtime + ISR cache' pattern subsection
  • llms.txt — new vision bullet
  • cli/llms-cli.txt — 5 new command sections + R402_* SSR Runtime Error Codes table
  • sdk/llms-sdk.txt — r.cache namespace section with CacheInvalidateResult / CacheInspectResult types
  • sdk/README.md + astro/README.md + astro/CHANGELOG.md — namespace catalog, v1.0 SSR preset

Schema fix: release-spec.v1.json caught up with shipped i18n.unknownLocalePolicy (was a separate drift; fixed in v2.11.0).

Assets 2
Loading