Aperta Gift

Cancel the whole gift at the person's explicit request, before any revision is approved. Deletes the giver's notes and all revisions. Never use this for 'I don't like this design' — that is gift_decline_revision.

gift_cancel

The link to continue on aperta-designs.com with the approved design already in place: the person signs in, the design is saved to their account, and they confirm the order details. Only after approval. Give the link as is; never build one.

gift_order_handoff

Called by the jewelry view only: records that the person interacted with the shown piece. Changes nothing.

gift_widget_event

Called by the jewelry view only, when the browser cannot show the 3D piece: a picture of the shown revision. Changes nothing.

gift_piece_snapshot

Lock one exact, validated, already shown revision as the person's design — only after they explicitly said yes to that revision (e.g. "זה שלי"). A positive reaction is not approval. If several revisions exist, name the one being locked and confirm first.

gift_approve_revision

Record that the person does not want this revision as it is. This is design feedback, not a cancellation: the gift stays open and the next revision builds on what they said.

gift_decline_revision

Open or resume the gift with the code the person received. Returns who it is from and their message (show it early when present), what the giver shared and how each item may be used, the design state to resume from, and drawingContract — Aperta's measured image prompt and drawing rules, with which every image of the piece is drawn. Call this first in every conversation, and gift_next at the start of every later message. Before the first design, ask two or three short questions about what the piece should express, then whether they are ready to see it — saying that once the layout appears Aperta checks it and shows the result, and if it does not appear by itself they tap Aperta's card (or say "continue"). On yes — and for every change — call gift_prepare_design with intent and proportion and pass its imagePrompt to the image tool as the prompt, word for word (never empty, never an edit of an earlier image); then gift_submit_design with it at once if you can still act in this turn, and the ready revision is shown with it. If ChatGPT ended your turn at the image: on their next message, gift_next first; unless they ask to change the drawing, that means gift_submit_design with it before anything else. Each answer's guidance field says what to do next.

gift_open

Call this right before every drawing — the first and each change — with intent (the direction in English, in shapes and lines only — no object words like bracelet or cuff, no colours or materials) and proportion (length ÷ height of the band, within drawing.ratioRange: higher is longer and more delicate, lower has more presence). It returns imagePrompt: the complete prompt for the image tool, to pass word for word. Without intent and proportion it returns the drawing contract alone (gift_open's drawingContract). Also returns the piece's length, the range of proportions to draw in (the band's width follows the proportion you draw), Aperta's measured image prompt, the image rules and the manufacturing floors. Never ask the person for a size or a width: the exact size is taken on the order page after approval. Calling it again is harmless.

gift_prepare_design

One validated revision's details and its view link (a page on aperta-designs.com with the rolled 3D piece and the exact flat layout) — for hosts without the jewelry view, or to compare revisions.

gift_get_revision

Save structured working notes from the conversation: preference dimensions, what the person confirmed themselves, the current direction in 1–3 sentences, what to keep and what to change, the language, and whether to use the giver's hints. Not a transcript.

gift_update_session