Nifty

Release notes

Annotation update. Every tool now sets readOnlyHint, destructiveHint, idempotentHint and openWorldHint explicitly to true or false. Justifications (RO/DE/ID/OW): Read tools, RO=true DE=false ID=true OW=false: search_inventory, get_inventory_item, get_inventory_summary, get_labels, get_pending_edits, get_action_status, get_account_settings, get_edit_item_instructions, search_orders, search_expenses, get_analytics_overview, get_profit_and_loss_report, search_categories, get_category_attributes, search_attribute_members. They only read the user's data or the marketplace taxonomy stored in Nifty; nothing is written and no marketplace is contacted. get_item_images RO=true DE=false ID=true OW=true: read-only, but photos hosted by a marketplace are downloaded from the marketplace's servers. load_dynamic_attributes RO=true DE=false ID=true OW=true: read-only, but calls the marketplace's API live with the user's connected account. Write tools: edit_item RO=false DE=true ID=true OW=false: stages edits in Nifty only (nothing goes live until apply); replaces any pending value for the same field and can stage attribute clears; same input gives the same staged state. discard_pending_edits RO=false DE=true ID=true OW=false: permanently discards unapplied staged edits; repeating discards nothing more; Nifty only. apply_item_edits_action RO=false DE=true ID=false OW=true: overwrites the item's live values with the staged edits and republishes its live marketplace listings; a repeat while edits are pending sends another update. add_draft_listing RO=false DE=false ID=true OW=false: adds new draft listings in Nifty only, never changes existing listings; a repeat for the same marketplace is refused. publish_drafts_action RO=false DE=false ID=false OW=true: creates new public listings on marketplaces from existing drafts; never deletes, delists or overwrites a live listing; each call is a new publish attempt that consumes publish credits. add_labels_action RO=false DE=false ID=true OW=false: only adds item-label links; existing links are skipped. remove_labels_action RO=false DE=true ID=true OW=false: removes item-label links; repeating removes nothing more. create_label_action RO=false DE=false ID=false OW=false: creates a new label; touches nothing existing. update_label_action RO=false DE=true ID=true OW=false: overwrites a label's name, color and description. delete_label_action RO=false DE=true ID=true OW=false: deletes a label and removes it from every item. set_favorite_action RO=false DE=true ID=true OW=false: overwrites the items' favorite flag (false removes it). set_private_notes_action RO=false DE=true ID=true OW=false: replaces the items' private notes (empty clears them). All write tools except apply_item_edits_action and publish_drafts_action act only on the user's data in Nifty.

Declared in the saved package. Remote tools may change independently.