Skip to content

v0.0.90

Choose a tag to compare

@github-actions github-actions released this 21 Nov 15:19
1449b7e

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 needs schema.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.manage can send PATCH /keys/{id} with a later expires_at, or null, 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.manage and webhooks.manage can 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-types refuses an edge property that a type's field would also be refused for: an array with no items_type, an enum with no enum_values, or enum_values on a property that is not an enum. Before, these registered, and such an enum took any string. Docs
  • Removed: compatible_with on types. A type's items are read as another type only through its parent.

CLI

  • Added: marfa types check FOLDER judges a folder of <id>.json type 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, replace and normalize with --file PATH.json send PATH.md beside it as the type's guidance, and marfa types get prints a type's guidance and that of the types above it.
  • Added: marfa keys update with --expires-at, --expires-in or --no-expiry extends a key's life with an owner key that holds keys.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