🎉 Anna 1.1.0-beta.139 → beta.145 — Open-Source Developer Docs, Sharper Structured Sampling… and Something Big Brewing

Hey Anna app developers! :waving_hand:

This batch moves the developer docs into a public repo you can contribute to,
squashes a stack of forum-reported bugs (#248, #250, #254, #256 — thank you! :folded_hands:),
and quietly lays some very interesting groundwork we can’t fully talk about yet… :shushing_face:
Let’s dive in! :rocket:


:sparkles: New Features

  • :books: Developer docs are now open-source (beta.139, forum #248) — The entire developer documentation (guides + API reference) moved out of the platform into the public anna-developer-docs repository. Spot a typo? Missing example? Wrong field description? Open a PR — published bundles flow to the live docs site automatically, with integrity checks so a bad bundle can never partially apply. Docs built with you, not just for you! :blue_heart:

  • :robot: Machine-verified capability reference (beta.139) — Schema bundle 0.20.0 exports acl/capabilities.json: the exact server-side whitelists for host_capabilities and permissions. The docs CI validates every capability string in the reference against it — no more hand-copied capability lists silently drifting from reality. What’s documented is what’s enforced! :bullseye:

  • :label: Review cards show the exact candidate version (beta.140) — First-time submissions no longer show v— in the review queue. Both review tracks (first publish & release re-review) now display your pinned candidate version with an explicit “Install v<candidate>” button, so reviewers always know exactly which build they’re testing — even after a re-submit.

  • :high_voltage: Faster reviews (beta.141) — App Store review powers are no longer super-admin-only: a dedicated review permission group now lets more team members approve and test your submissions. Shorter queues, faster feedback for you! :person_running:


:bug: Bug Fixes

  • :key: BYOK third-party app/complete no longer 500s (beta.140, forum #256) — A missing module logger crashed every request that hit a BYOK model in third-party direct-connect mode — regardless of provider or model. Fixed, and locked in with a full-stack integration regression test so it can’t sneak back.

  • :hammer_and_wrench: session.run platform tools NameError fixed (beta.140, forum #254) — A PEP 563 annotation-resolution clash made agent sessions crash when invoking certain platform tools. All lazy-loaded tool factories now use module-level type names, with a regression test that resolves type hints for every platform tool.

  • :locked: Executa edit no longer silently downgrades visibility (beta.140, forum #248) — Saving the edit dialog used to reset your Executa’s visibility to private (the form never pre-filled the current value!) and wrote visibility directly, bypassing the paid-tier and downgrade-unbind guards. The dialog now pre-fills correctly and visibility changes go through the same guarded path as everywhere else.

  • :receipt: json_schema sampling works on Cloud Agents (beta.141, forum #250) — Structured-output sampling failed reliably on Cloud Agents due to two stacked upstream quirks: a hard requirement that “json” appear in the prompt, and a model silently downgrading json_schema to json_object. Fixed with corrected capability flags (so your onUnsupported strategy actually kicks in), an auto-injected system hint when needed, and much better error messages — including diagnostic pointers when a plugin returns an empty error shell. Structured output you can trust! :triangular_ruler:

  • :detective: Dev-born apps no longer hidden from the review queue (beta.138/139) — If you ran anna-app dev before publishing, your submitted app could silently vanish from the reviewer queue (while remaining visible via direct link — extra confusing!). An over-eager is_dev filter is gone; the dev-first workflow now flows through review exactly like publish-first.


:crystal_ball: One More Thing…

Sharp-eyed developers may notice a few curious things in this batch: anna-app-core
jumped to 0.19.0
, the schema bundle rolled to 0.21.0, and there’s a mysterious
new form_factors field lurking in the manifest schema… :eyes:

We can’t say much yet. What we can say: your Anna apps are about to break free
of the desktop, and it’s roughly two weeks away. If you’ve ever wished your
users could reach your app from anywhere — start thinking about what your UI
would look like on a smaller canvas. That’s all the hints you get for now. :zipper_mouth_face::mobile_phone::sparkles:

Stay tuned — the announcement will be worth it. We promise.


:puzzle_piece: Compatibility Notes

  • :green_circle: Everything is additive — no manifest changes required. Existing apps keep working unchanged.
  • :package: anna-app-core 0.19.0 and CLI 0.1.50 are safe, drop-in updates — the new schema fields are optional and dormant (for now :wink:).
  • :books: Doc fixes and improvements now happen in the public anna-developer-docs repo — PRs welcome!

:open_mailbox_with_raised_flag: Feedback Welcome!

Sent your first docs PR? Finally seeing real error messages from structured
sampling? Got a guess about what’s coming? :eyes: Drop your questions, feedback, and
wild theories below — this batch was powered by your forum reports
(#248, #250, #254, #256 :flexed_biceps:). Happy building! :purple_heart::sparkles:

Git Doc: anna-developer-docs/docs at main · Anna-Partners/anna-developer-docs · GitHub