HansaChat

Documentation

Sporočila in reakcije

Branje, iskanje, pošiljanje, urejanje in brisanje sporočil ter dodajanje reakcij.

Branje

hansa chat messages list --channel general --limit 50
hansa chat messages get --message <message-id>
hansa chat messages search --query "standup notes" --channel general

--limit sprejme 1–100. Namesto po straneh se po zgodovini pomikate s zaporednimi številkami kanala, ki ostanejo stabilne:

hansa chat messages list --channel general --before-sequence 120
hansa chat messages list --channel general --after-sequence 100
hansa chat messages list --channel general --around-message <message-id>

Odgovor vključuje meta z naslednjim kazalcem (next_before_sequence ali next_after_sequence), tako da skripte lahko zanesljivo prehodijo zgodovino.

Pošiljanje

hansa chat messages send --channel general --text "Deploy finished."

Navadno besedilo se samodejno pretvori v bogat format dokumenta delovnega prostora. Za neposreden nadzor lahko podate JSON dokumenta:

hansa chat messages send --channel general --content-json '{"type":"doc","content":[…]}'
hansa chat messages send --channel general --content-file message.json

Dodatne možnosti: --parent <message-id> za odgovor, --mention <user-id> (ponovljivo) za omembo oseb in --file <file-id> (ponovljivo) za prilogo naloženih datotek (glejte vabila in nalaganje datotek).

Pošiljanje je namerno ne-idempotentno. Vsak klic ustvari novo sporočilo — dvakratni zagon ukaza pošlje dve sporočili. To je tisto, kar skripte, ki objavljajo obvestila, običajno želijo; vse ostalo v CLI konvergira k zaželenemu stanju.

Urejanje in brisanje

hansa chat messages edit --message <id> --text "Deploy finished successfully."
hansa chat messages delete --message <id>

Dvojno urejanje iste vsebine je drugič brez učinka, brisanje že izbrisanega sporočila pa uspe nespremenjeno. Oba ukaza počakata, da je sprememba vidna prek API-ja; z --no-wait se takoj vrnejo s sprejetim ukazom.

Reakcije

hansa chat reactions set --message <id> --emoji "👍" --present=true
hansa chat reactions set --message <id> --emoji "👍" --present=false

CLI zaledje pokliče samo, kadar se zahtevana prisotnost razlikuje od trenutnega stanja, zato so ponovljeni ukazi varni.