Repository navigation
v0.0.90
Types can now carry guidance for agents and app builders, marfa types check judges a folder of type definitions offline, and an owner can extend any key's life and see every webhook.
Breaking: A type registration that names compatible_with is now refused 400 invalid_schema; remove the key, and use parent where a type's items should read as another type. A type's description over 200 characters, or a field's over 300, is refused, and an edge type property of type array with no items_type, or of type enum with no enum_values, is refused. Types and edge types already stored keep reading and restore as they were, but the next replacement of a type must bring its descriptions within the limits.
Server
- Added: A type can carry optional
guidance, Markdown of up to 1,000 characters that tells an agent or an app builder how to use it.GET /types/{id}also returns the guidance of the types above it. Adding, changing or removing guidance needsschema.write. Docs - Added: A status word can carry a description of up to 120 characters, read on every type that inherits it.
- Added: An owner can extend a live key's life: a caller with
keys.managecan sendPATCH /keys/{id}with a laterexpires_at, ornull, for any key, including one an app made. The key keeps its secret, and a caller with its own expiry can't extend a key past it. Docs - Added: A credential with both
keys.manageandwebhooks.managecan list, read and delete every webhook subscription, whichever app or key made it, including one whose key was revoked or expired. Only a subscription's maker can change it or redeliver. Docs - Changed: Search ranks an item whose title matches the query above one that only mentions it elsewhere. Docs
- Changed: Descriptions have length limits: a type's at most 200 characters, and a field's or an entry member's at most 300.
- Fixed:
POST /edge-typesrefuses an edge property that a type's field would also be refused for: anarraywith noitems_type, anenumwith noenum_values, orenum_valueson a property that is not an enum. Before, these registered, and such anenumtook any string. Docs - Removed:
compatible_withon types. A type's items are read as another type only through itsparent.
CLI
- Added:
marfa types check FOLDERjudges a folder of<id>.jsontype definitions as a server would at registration, with no server, key or network, and exits non-zero when one is refused. Docs - Added:
marfa types register,replaceandnormalizewith--file PATH.jsonsendPATH.mdbeside it as the type's guidance, andmarfa types getprints a type's guidance and that of the types above it. - Added:
marfa keys updatewith--expires-at,--expires-inor--no-expiryextends a key's life with an owner key that holdskeys.manage.
Core
- Changed: Search on the device ranks a title match above a body match, as the server does.
Full changelog: v0.0.89...v0.0.90