Migrating from templates

​

Agent code

// Before
const answer = await ctx.ask({ template: 'form', title, params: { prompt, inputs } });
answer.values.name;

// Now
import { form } from '@getcliqio/cliq-sdk/hugs';
const answer = await ctx.ask(form, { title, params: { prompt, inputs } });
answer.value.name;          // `values` still works

• The hug is the first argument — its definition, its name, or nothing (the phase’s hug.name, else form). template is refused with HugRefusedError, which shows how to write it now.
• Every answer is checked against the hug’s definition before your code sees it.
• ctx.attach(paths) replaces passing artifact blocks for the page to show: it returns attachments for ctx.ask.
• Rebuild agents that bundle cliq-sdk.

​

team.yml

• Nothing changes for form and approval.
• The gate’s review.template_params is now review.params (approve_label, reject_label, show_comment); template_params is refused as an unknown key.
• A phase may name a hug: hug: { name: review-batch }.

​

LLM phases

​

Answering

• On CliqHub, the response is drawn by the Hug’s hug, in a frame. After you answer, the page shows your answer as sent, with Change answer. Someone who can see a Hug but wasn’t sent it sees the responses, not a form.
• Locally, cliq run no longer asks in the terminal: it opens cliqd’s Hug page in your browser (--no-open to print the link). Scripts answer with cliqd’s hugs/respond (Troubleshooting).

​

Hugs open during the switch