@ghostlytools/cli 1.5.4 → 1.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (58) hide show
  1. package/README.md +4 -0
  2. package/SKILL.md +24 -3
  3. package/dist/assets/{api-ButrHieZ.js → api--A27YnXu.js} +2 -2
  4. package/dist/assets/{api-DDmune9b.js → api-Dt0zan2-.js} +9 -9
  5. package/dist/assets/{api-DDmune9b.js.map → api-Dt0zan2-.js.map} +1 -1
  6. package/dist/assets/{apiKit-DfFlJhXO.js → apiKit-Bic3_V6V.js} +2 -2
  7. package/dist/assets/{apiKit-DfFlJhXO.js.map → apiKit-Bic3_V6V.js.map} +1 -1
  8. package/dist/assets/{apps-CpQVuYqT.js → apps-mKn2UJOu.js} +2 -2
  9. package/dist/assets/{apps-CpQVuYqT.js.map → apps-mKn2UJOu.js.map} +1 -1
  10. package/dist/assets/{apps-BVnNpB2f.js → apps-wz_jQ_JD.js} +1 -1
  11. package/dist/assets/{arkade-C9Ne-zJb.js → arkade-Ds-kFF3w.js} +2 -2
  12. package/dist/assets/{arkade-C9Ne-zJb.js.map → arkade-Ds-kFF3w.js.map} +1 -1
  13. package/dist/assets/{backup-DavZrUf6.js → backup-BgM_lskM.js} +1 -1
  14. package/dist/assets/{backup-MN2sZQeW.js → backup-BzhzeQMo.js} +4 -4
  15. package/dist/assets/{backup-MN2sZQeW.js.map → backup-BzhzeQMo.js.map} +1 -1
  16. package/dist/assets/buttons-D6kjMAsr.js +2 -0
  17. package/dist/assets/{buttons-DIWDW2n5.js → buttons-Dq4tuXEE.js} +3 -3
  18. package/dist/assets/{buttons-DIWDW2n5.js.map → buttons-Dq4tuXEE.js.map} +1 -1
  19. package/dist/assets/{envelope-ByeUit1N.js → envelope-PwD8vda7.js} +2 -2
  20. package/dist/assets/{envelope-ByeUit1N.js.map → envelope-PwD8vda7.js.map} +1 -1
  21. package/dist/assets/{groupFiles-DVxX0O1g.js → groupFiles-BxZ0R_e2.js} +3 -3
  22. package/dist/assets/groupFiles-BxZ0R_e2.js.map +1 -0
  23. package/dist/assets/{host-AB2Cr46b.js → host-BUk43Gs5.js} +8 -8
  24. package/dist/assets/{host-AB2Cr46b.js.map → host-BUk43Gs5.js.map} +1 -1
  25. package/dist/assets/{hyperdhtRelay-BcrwJRtb.js → hyperdhtRelay-C3TF3MYd.js} +2 -2
  26. package/dist/assets/{hyperdhtRelay-BcrwJRtb.js.map → hyperdhtRelay-C3TF3MYd.js.map} +1 -1
  27. package/dist/assets/{irohWeb-B5j2rgWj.js → irohWeb-3j4AE5iy.js} +2 -2
  28. package/dist/assets/{irohWeb-B5j2rgWj.js.map → irohWeb-3j4AE5iy.js.map} +1 -1
  29. package/dist/assets/{main-AHz1dbsm.js → main-CRpIo2aG.js} +17 -17
  30. package/dist/assets/{main-AHz1dbsm.js.map → main-CRpIo2aG.js.map} +1 -1
  31. package/dist/assets/{mainline-afyQ77bv.js → mainline-DOZO9JX0.js} +2 -2
  32. package/dist/assets/{mainline-afyQ77bv.js.map → mainline-DOZO9JX0.js.map} +1 -1
  33. package/dist/assets/{networkReason-DWzsMN8E.js → networkReason-CmuzZ0iS.js} +2 -2
  34. package/dist/assets/{networkReason-DWzsMN8E.js.map → networkReason-CmuzZ0iS.js.map} +1 -1
  35. package/dist/assets/{nwc-DYXTp8UX.js → nwc-C4scgLOx.js} +3 -3
  36. package/dist/assets/{nwc-DYXTp8UX.js.map → nwc-C4scgLOx.js.map} +1 -1
  37. package/dist/assets/{nwcProvider-B4k6mYJl.js → nwcProvider-DNqnRGj4.js} +2 -2
  38. package/dist/assets/{nwcProvider-B4k6mYJl.js.map → nwcProvider-DNqnRGj4.js.map} +1 -1
  39. package/dist/assets/{registry-Ccru6KBP.js → registry-4cyOe4FI.js} +1 -1
  40. package/dist/assets/{registry-wSZHgbsv.js → registry-C-UBjvCc.js} +3 -3
  41. package/dist/assets/{registry-wSZHgbsv.js.map → registry-C-UBjvCc.js.map} +1 -1
  42. package/dist/assets/{resolve-BPJnMtLC.js → resolve-BTQyQYzW.js} +2 -2
  43. package/dist/assets/{resolve-BPJnMtLC.js.map → resolve-BTQyQYzW.js.map} +1 -1
  44. package/dist/assets/{server-DPzt5V2x.js → server-CwR20_p5.js} +35 -19
  45. package/dist/assets/{server-DPzt5V2x.js.map → server-CwR20_p5.js.map} +1 -1
  46. package/dist/assets/{src-CFeRBeHz.js → src-D3M3UPVO.js} +14 -4
  47. package/dist/assets/src-D3M3UPVO.js.map +1 -0
  48. package/dist/assets/{usdt-CBh78JVF.js → usdt-Bet4_yNL.js} +3 -3
  49. package/dist/assets/{usdt-CBh78JVF.js.map → usdt-Bet4_yNL.js.map} +1 -1
  50. package/dist/assets/{words-DC8BQvPO.js → words-CHas8X7A.js} +2 -2
  51. package/dist/assets/{words-DC8BQvPO.js.map → words-CHas8X7A.js.map} +1 -1
  52. package/dist/ghostly.mjs +1 -1
  53. package/examples/claude-code-agent.sh +4 -1
  54. package/package.json +4 -4
  55. package/skills/ghostly/SKILL.md +9 -4
  56. package/dist/assets/buttons-DC20Q2no.js +0 -2
  57. package/dist/assets/groupFiles-DVxX0O1g.js.map +0 -1
  58. package/dist/assets/src-CFeRBeHz.js.map +0 -1
package/README.md CHANGED
@@ -418,6 +418,10 @@ ghostly listen --type call. # call.incoming … call.connected {"
418
418
  node examples/call-echo.mjs greeting.wav # a program that answers, greets, then echoes after 1 s
419
419
  ```
420
420
 
421
+ A whole voice agent on this socket: [ghostly-voice-agent](https://github.com/MiguelMedeiros/ghostly-voice-agent) answers calls with
422
+ speech to text, Claude and text to speech, stops talking when the caller talks, and hands real work to another agent.
423
+ Its `AGENTS.md` is the guide for an AI agent that sets it up.
424
+
421
425
  **The audio.** The socket is `<profile>/calls/<call>.sock` (0600), or `ghostly-calls-<hash>/<call>.sock` in
422
426
  `$XDG_RUNTIME_DIR`, else in `/tmp/ghostly-calls-<uid>-<hash>/` (a folder of yours alone, 0700), when that path is too long; `call start`, `call answer`, `call list` and the
423
427
  `call.connected` event name it. It carries raw PCM,
package/SKILL.md CHANGED
@@ -37,6 +37,23 @@ Ghostly app (web, extension, desktop) through an invite, like any other contact.
37
37
 
38
38
  Read step 11 (safety) before you answer anyone.
39
39
 
40
+ ## How to behave in a chat
41
+
42
+ Your owner sees what you do only through the chat, so on every message (a `turn`, step 5) from them:
43
+
44
+ 1. **React 👀 at once:** `ghostly react owner <messageId> 👀`, before anything else. It tells them you saw it.
45
+ 2. **Show what you are doing:** `ghostly typing owner --kind thinking --status "Reading the CI logs" --for 600`
46
+ (40 characters, no links). Change it at each step; a message you send ends it.
47
+ 3. **Answer, quoting their message:** `ghostly send owner --reply <messageId> --stdin`, your answer on stdin. Short:
48
+ the answer first, then a few bullets if needed.
49
+ 4. **A pure ack is a reaction:** if the whole answer is "ok", swap 👀 for a fitting emoji
50
+ (`ghostly react owner <messageId> 👍`, it replaces yours) instead of sending a message.
51
+ 5. **Ask with buttons when they must decide** (see "Buttons" below), and act on the press, never on the text.
52
+ 6. **Work that takes minutes gets a task card** (step 10), kept current, not a stream of status texts.
53
+
54
+ In a group, the same with `ghostly group react <group> <messageId> 👀` and `ghostly group typing <group> --kind thinking`.
55
+ `<messageId>` is the turn's `messageId`. The same rules as the owner skill's loop (`skills/ghostly/SKILL.md`).
56
+
40
57
  ## When to use
41
58
 
42
59
  - A person should be able to message the agent from the Ghostly app, and the agent should answer.
@@ -137,7 +154,7 @@ stored under, which its sender chose most of, is `untrusted.messageId`: an id is
137
154
 
138
155
  ### 6. Answer: `--stdin` and `--reply`
139
156
 
140
- A hook (`on-turn.sh`) that answers every turn as a reply:
157
+ A hook (`on-turn.sh`) that reacts 👀, shows it is thinking and answers every turn as a reply:
141
158
 
142
159
  ```bash
143
160
  #!/usr/bin/env bash
@@ -145,6 +162,8 @@ set -euo pipefail
145
162
  turn="$(cat)"
146
163
  chat="$(jq -r '.chat // empty' <<<"$turn")"; group="$(jq -r '.group // empty' <<<"$turn")"
147
164
  id="$(jq -r .messageId <<<"$turn")"
165
+ if [ -n "$chat" ]; then ghostly react "$chat" "$id" 👀 >/dev/null || true
166
+ else ghostly group react "$group" "$id" 👀 >/dev/null 2>&1 || true; fi
148
167
  if [ -n "$chat" ]; then ghostly typing "$chat" --kind thinking --status "Thinking" --for 600 >/dev/null || true
149
168
  else ghostly group typing "$group" --kind thinking --status "Thinking" --for 600 >/dev/null 2>&1 || true; fi
150
169
  answer="$(my-agent <<<"$turn")" # a model with no tools reads the turn as data (step 11)
@@ -354,8 +373,10 @@ ghostly service add docs http://127.0.0.1:8080 # a web app on this machine
354
373
  ghostly service share <service id> alice # alice may open it; nobody else
355
374
  ```
356
375
 
357
- A call's audio is raw PCM on its own Unix socket, 48 kHz by default; see `examples/call-echo.mjs`. Making an identity
358
- proof needs a person who holds the key: leave that to the owner.
376
+ A call's audio is raw PCM on its own Unix socket, 48 kHz by default; see `examples/call-echo.mjs`. To answer calls by
377
+ voice, clone [ghostly-voice-agent](https://github.com/MiguelMedeiros/ghostly-voice-agent) rather than writing one: it listens, transcribes, asks Claude
378
+ and speaks the reply (ElevenLabs), and its `AGENTS.md` walks an agent through the setup. Making an identity proof
379
+ needs a person who holds the key: leave that to the owner.
359
380
 
360
381
  ## Rules the CLI enforces
361
382
 
@@ -1,3 +1,3 @@
1
- import { a as findChat, s as findGroup } from "./apiKit-DfFlJhXO.js";
2
- import { a as hideStateSecrets, i as groupSendRefused, n as SETTABLE, o as mentionsFor, r as callApi, s as redactSettings, t as API_METHODS } from "./api-DDmune9b.js";
1
+ import { a as findChat, s as findGroup } from "./apiKit-Bic3_V6V.js";
2
+ import { a as hideStateSecrets, i as groupSendRefused, n as SETTABLE, o as mentionsFor, r as callApi, s as redactSettings, t as API_METHODS } from "./api-Dt0zan2-.js";
3
3
  export { API_METHODS, SETTABLE, callApi, findChat, findGroup, groupSendRefused, hideStateSecrets, mentionsFor, redactSettings };
@@ -1,15 +1,15 @@
1
- import { Do as GhostlyHttpError, Ec as APP_PERMISSIONS, Ir as sanitizeTypingStatus, Nr as TYPING_KINDS, Pr as TYPING_REFRESH_MS, Qa as appCardId, Uc as isAppRef, Wi as identityStatement, Wn as GROUP_FILE_LIMITS, Xa as STATUS_CARD_LIMITS, Y as groupName, Yc as readImageMeta, _a as voiceDownloadName, _u as toBase64Url, ca as sanitizeFileName, da as VOICE_LIMITS, dl as ownInviteRefusal, du as sanitizeAvatar, eo as cardLine, fa as VOICE_METER, ga as parseVoiceMeta, gu as randomBytes$1, jc as isAppUrl, jo as LIMITS, la as sanitizeMime, ll as inviteLink, ma as downsamplePeaks, ni as APP_DATA_MAX_BYTES, no as checkStatusCard, pa as baseMime, ua as PLAYABLE_AUDIO, uu as MAX_AVATAR_LENGTH, va as voiceLevel, xo as AWAITING_PEER_MS, zc as appRef } from "./src-CFeRBeHz.js";
1
+ import { Do as GhostlyHttpError, Ec as APP_PERMISSIONS, Ir as sanitizeTypingStatus, Nr as TYPING_KINDS, Pr as TYPING_REFRESH_MS, Qa as appCardId, Uc as isAppRef, Wi as identityStatement, Wn as GROUP_FILE_LIMITS, Xa as STATUS_CARD_LIMITS, Y as groupName, Yc as readImageMeta, _a as voiceDownloadName, _u as toBase64Url, ca as sanitizeFileName, da as VOICE_LIMITS, dl as ownInviteRefusal, du as sanitizeAvatar, eo as cardLine, fa as VOICE_METER, ga as parseVoiceMeta, gu as randomBytes$1, jc as isAppUrl, jo as LIMITS, la as sanitizeMime, ll as inviteLink, ma as downsamplePeaks, ni as APP_DATA_MAX_BYTES, no as checkStatusCard, pa as baseMime, ua as PLAYABLE_AUDIO, uu as MAX_AVATAR_LENGTH, va as voiceLevel, xo as AWAITING_PEER_MS, zc as appRef } from "./src-D3M3UPVO.js";
2
2
  import { u as fileStore } from "./idb-BlH8-O3R.js";
3
- import { O as waitingGroupFile, T as removeStored, U as iceServerProblem, W as iceServerSetting, i as groupOfFile, l as replyRef, n as groupFileId, v as paymentNetwork } from "./groupFiles-DVxX0O1g.js";
3
+ import { O as waitingGroupFile, T as removeStored, U as iceServerProblem, W as iceServerSetting, i as groupOfFile, l as replyRef, n as groupFileId, v as paymentNetwork } from "./groupFiles-BxZ0R_e2.js";
4
4
  import { f as FILE_BYTES_STEP, o as fileBytes, s as fileBytesOf } from "./fileBytes-BMEBas7S.js";
5
- import { t as IDENTITY_PROVIDERS } from "./registry-wSZHgbsv.js";
6
- import { a as waitForEdit, c as findSecret, i as pressable, n as buttonsCard, o as waitForGroupFrame, s as waitForMessage, t as BUTTON_METHODS } from "./buttons-DIWDW2n5.js";
7
- import { a as WALLET_TYPES, c as DESTRUCTIVE_CALLS, d as ENGINE_READS, f as READ_PARAMS, i as TRANSPORT_NAMES, l as ENGINE_METHODS, m as engineParamsProblem, n as CHAT_METHODS, r as PAY_METHODS, s as withStoredIds, t as ADDRESS_TYPES, u as ENGINE_PARAMS } from "./words-DC8BQvPO.js";
5
+ import { t as IDENTITY_PROVIDERS } from "./registry-C-UBjvCc.js";
6
+ import { a as waitForEdit, c as findSecret, i as pressable, n as buttonsCard, o as waitForGroupFrame, s as waitForMessage, t as BUTTON_METHODS } from "./buttons-Dq4tuXEE.js";
7
+ import { a as WALLET_TYPES, c as DESTRUCTIVE_CALLS, d as ENGINE_READS, f as READ_PARAMS, i as TRANSPORT_NAMES, l as ENGINE_METHODS, m as engineParamsProblem, n as CHAT_METHODS, r as PAY_METHODS, s as withStoredIds, t as ADDRESS_TYPES, u as ENGINE_PARAMS } from "./words-CHas8X7A.js";
8
8
  import { i as localFileError, r as asCliError, t as CliError } from "./errors-CzXgR8Cc.js";
9
- import { _ as state, a as findChat, d as list, f as messageOf, g as sentAt, h as oneOf, i as chatOrGroup, l as groupOf, m as num, n as bool, o as findChatOrGroup, p as node, r as chatOf, s as findGroup, u as inviteTaken, v as str, y as waitForState } from "./apiKit-DfFlJhXO.js";
9
+ import { _ as state, a as findChat, d as list, f as messageOf, g as sentAt, h as oneOf, i as chatOrGroup, l as groupOf, m as num, n as bool, o as findChatOrGroup, p as node, r as chatOf, s as findGroup, u as inviteTaken, v as str, y as waitForState } from "./apiKit-Bic3_V6V.js";
10
10
  import { a as checkShownName } from "./profiles-CEnZfN78.js";
11
- import { t as BACKUP_METHODS } from "./backup-MN2sZQeW.js";
12
- import { o as checkedBundle } from "./apps-CpQVuYqT.js";
11
+ import { t as BACKUP_METHODS } from "./backup-BzhzeQMo.js";
12
+ import { o as checkedBundle } from "./apps-mKn2UJOu.js";
13
13
  import { generateMnemonic } from "@scure/bip39";
14
14
  import { wordlist } from "@scure/bip39/wordlists/english.js";
15
15
  import { openAsBlob, readFileSync, renameSync, writeFileSync } from "node:fs";
@@ -4663,4 +4663,4 @@ async function callApi(ctx, method, params = {}) {
4663
4663
  //#endregion
4664
4664
  export { flushCardUpdates as _, hideStateSecrets as a, paymentJson as c, nodeLocalFetch as d, chatJson as f, resumeHolds as g, groupMessageJson as h, groupSendRefused as i, reportAppFrames as l, groupJson as m, SETTABLE as n, mentionsFor as o, chatMessageJson as p, callApi as r, redactSettings as s, API_METHODS as t, servedApps as u };
4665
4665
 
4666
- //# sourceMappingURL=api-DDmune9b.js.map
4666
+ //# sourceMappingURL=api-Dt0zan2-.js.map