@ph0ny/cli 0.1.0 → 0.2.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 (76) hide show
  1. package/README.md +93 -20
  2. package/SKILL.md +73 -0
  3. package/bin/phony.js +3 -1
  4. package/dist/commands/account.d.ts +9 -0
  5. package/dist/commands/account.d.ts.map +1 -0
  6. package/dist/commands/account.js +48 -0
  7. package/dist/commands/account.js.map +1 -0
  8. package/dist/commands/agents.d.ts +1 -0
  9. package/dist/commands/agents.d.ts.map +1 -1
  10. package/dist/commands/agents.js +48 -29
  11. package/dist/commands/agents.js.map +1 -1
  12. package/dist/commands/call.d.ts +10 -8
  13. package/dist/commands/call.d.ts.map +1 -1
  14. package/dist/commands/call.js +87 -31
  15. package/dist/commands/call.js.map +1 -1
  16. package/dist/commands/contacts.d.ts.map +1 -1
  17. package/dist/commands/contacts.js +5 -1
  18. package/dist/commands/contacts.js.map +1 -1
  19. package/dist/commands/observability.d.ts.map +1 -1
  20. package/dist/commands/observability.js +2 -10
  21. package/dist/commands/observability.js.map +1 -1
  22. package/dist/commands/raw.d.ts.map +1 -1
  23. package/dist/commands/raw.js +1 -0
  24. package/dist/commands/raw.js.map +1 -1
  25. package/dist/commands/synthesize.d.ts +3 -0
  26. package/dist/commands/synthesize.d.ts.map +1 -0
  27. package/dist/commands/synthesize.js +71 -0
  28. package/dist/commands/synthesize.js.map +1 -0
  29. package/dist/commands/transcribe.d.ts +3 -0
  30. package/dist/commands/transcribe.d.ts.map +1 -0
  31. package/dist/commands/transcribe.js +47 -0
  32. package/dist/commands/transcribe.js.map +1 -0
  33. package/dist/commands/translate-job.d.ts +6 -0
  34. package/dist/commands/translate-job.d.ts.map +1 -0
  35. package/dist/commands/translate-job.js +73 -0
  36. package/dist/commands/translate-job.js.map +1 -0
  37. package/dist/commands/translate-options.d.ts +42 -0
  38. package/dist/commands/translate-options.d.ts.map +1 -0
  39. package/dist/commands/translate-options.js +147 -0
  40. package/dist/commands/translate-options.js.map +1 -0
  41. package/dist/commands/translate.d.ts +3 -0
  42. package/dist/commands/translate.d.ts.map +1 -0
  43. package/dist/commands/translate.js +77 -0
  44. package/dist/commands/translate.js.map +1 -0
  45. package/dist/commands/video.d.ts +13 -0
  46. package/dist/commands/video.d.ts.map +1 -0
  47. package/dist/commands/video.js +83 -0
  48. package/dist/commands/video.js.map +1 -0
  49. package/dist/commands/voices.d.ts.map +1 -1
  50. package/dist/commands/voices.js +27 -43
  51. package/dist/commands/voices.js.map +1 -1
  52. package/dist/index.d.ts +10 -4
  53. package/dist/index.d.ts.map +1 -1
  54. package/dist/index.js +70 -54
  55. package/dist/index.js.map +1 -1
  56. package/dist/lib/agent-payload.d.ts +27 -12
  57. package/dist/lib/agent-payload.d.ts.map +1 -1
  58. package/dist/lib/agent-payload.js +33 -20
  59. package/dist/lib/agent-payload.js.map +1 -1
  60. package/dist/lib/call-payload.d.ts +6 -0
  61. package/dist/lib/call-payload.d.ts.map +1 -1
  62. package/dist/lib/call-payload.js +14 -0
  63. package/dist/lib/call-payload.js.map +1 -1
  64. package/dist/lib/call-trace.d.ts +14 -0
  65. package/dist/lib/call-trace.d.ts.map +1 -0
  66. package/dist/lib/call-trace.js +30 -0
  67. package/dist/lib/call-trace.js.map +1 -0
  68. package/dist/lib/errors.d.ts +7 -4
  69. package/dist/lib/errors.d.ts.map +1 -1
  70. package/dist/lib/errors.js +11 -10
  71. package/dist/lib/errors.js.map +1 -1
  72. package/package.json +13 -11
  73. package/dist/commands/campaign.d.ts +0 -11
  74. package/dist/commands/campaign.d.ts.map +0 -1
  75. package/dist/commands/campaign.js +0 -26
  76. package/dist/commands/campaign.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"voices.js","sourceRoot":"","sources":["../../src/commands/voices.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACtC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAChF,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAE9E,MAAM,UAAU,mBAAmB;IACjC,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,qCAAqC,CAAC,CAAA;IAEpF,GAAG;SACA,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,aAAa,CAAC;SAC1B,MAAM,CAAC,kBAAkB,EAAE,uBAAuB,CAAC;SACnD,MAAM,CAAC,aAAa,EAAE,sBAAsB,CAAC;SAC7C,MAAM,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;SAChD,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,OAAqF,EAAE,EAAE;QAC1G,MAAM,MAAM,GAAG,eAAe,EAAE,CAAA;QAChC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC;YAC7C,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC;YAC7C,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC;YACjD,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAA;QACF,IAAI,OAAO,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC,IAAI,CAAC,CAAA;QACxC,UAAU,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACrE,KAAK,CAAC,EAAE;YACR,KAAK,CAAC,IAAI;YACV,KAAK,CAAC,QAAQ;YACd,KAAK,CAAC,UAAU,IAAI,GAAG;SACxB,CAAC,CAAC,CAAA;IACL,CAAC,CAAC,CAAC,CAAA;IAEL,GAAG;SACA,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,aAAa,CAAC;SAC1B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;SAC5B,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,EAAU,EAAE,OAA2B,EAAE,EAAE;QAC5D,MAAM,MAAM,GAAG,eAAe,EAAE,CAAA;QAChC,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;QACjD,IAAI,OAAO,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC,KAAK,CAAC,CAAA;QACzC,aAAa,CAAC;YACZ,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,MAAM,EAAE,KAAK,CAAC,QAAQ;YACtB,OAAO,EAAE,KAAK,CAAC,UAAU;SAC1B,CAAC,CAAA;IACJ,CAAC,CAAC,CAAC,CAAA;IAEL,GAAG;SACA,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,mDAAmD,CAAC;SAChE,cAAc,CAAC,eAAe,EAAE,YAAY,CAAC;SAC7C,cAAc,CAAC,wBAAwB,EAAE,sBAAsB,CAAC;SAChE,MAAM,CAAC,sBAAsB,EAAE,mBAAmB,CAAC;SACnD,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,OAAoF,EAAE,EAAE;QACzG,MAAM,MAAM,GAAG,eAAe,EAAE,CAAA;QAChC,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAA;QACpE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE;YACxD,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC,CAAA;QACF,IAAI,OAAO,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC,MAAM,CAAC,CAAA;QAC1C,OAAO,CAAC,gBAAgB,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,MAAM,CAAC,KAAK,CAAC,IAAI,aAAa,MAAM,CAAC,OAAO,EAAE,CAAC,CAAA;IAC7F,CAAC,CAAC,CAAC,CAAA;IAEL,GAAG;SACA,OAAO,CAAC,YAAY,CAAC;SACrB,WAAW,CAAC,8BAA8B,CAAC;SAC3C,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC;SACjC,cAAc,CAAC,eAAe,EAAE,oBAAoB,CAAC;SACrD,MAAM,CAAC,mBAAmB,EAAE,+BAA+B,CAAC;SAC5D,MAAM,CAAC,uBAAuB,EAAE,uBAAuB,CAAC;SACxD,MAAM,CAAC,aAAa,EAAE,cAAc,CAAC;SACrC,MAAM,CAAC,aAAa,EAAE,cAAc,CAAC;SACrC,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,OAAe,EAAE,OAOnC,EAAE,EAAE;QACH,MAAM,MAAM,GAAG,eAAe,EAAE,CAAA;QAChC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE;YAC7D,OAAO;YACP,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,IAAI,KAAK,CAA2C;YAC3E,QAAQ,EAAE,OAAO,CAAC,QAAiB;YACnC,KAAK,EAAE,kBAAkB,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC;YACxD,KAAK,EAAE,kBAAkB,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC;SACzD,CAAC,CAAA;QACF,IAAI,OAAO,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC,MAAM,CAAC,CAAA;QAC1C,aAAa,CAAC;YACZ,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,UAAU,EAAE,MAAM,CAAC,cAAc;YACjC,KAAK,EAAE,MAAM,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC;YACxE,MAAM,EAAE,MAAM,CAAC,WAAW;SAC3B,CAAC,CAAA;IACJ,CAAC,CAAC,CAAC,CAAA;IAEL,GAAG;SACA,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,uBAAuB,CAAC;SACpC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;SAC5B,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,EAAU,EAAE,OAA2B,EAAE,EAAE;QAC5D,MAAM,MAAM,GAAG,eAAe,EAAE,CAAA;QAChC,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;QACtC,IAAI,OAAO,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;QACzD,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAA;IAChC,CAAC,CAAC,CAAC,CAAA;IAEL,OAAO,GAAG,CAAA;AACZ,CAAC"}
1
+ {"version":3,"file":"voices.js","sourceRoot":"","sources":["../../src/commands/voices.ts"],"names":[],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -1,11 +1,17 @@
1
1
  /**
2
- * Phony CLI — agents, keys, and outbound calls over the Phony Voice API.
2
+ * Phony CLI — speech, agents, keys and outbound calls over the Phony Voice API.
3
3
  *
4
- * Designed to be driven by autonomous LLM agents:
5
- * - every read/list command supports --json (2-space, no colors)
4
+ * Designed to be driven by autonomous LLM agents (AGENT_HELP below is the
5
+ * contract, printed under `phony --help`; FOOTER summarizes it on every other screen):
6
+ * - every command supports --json (2-space, no colors)
6
7
  * - no interactive prompts
7
8
  * - no secret values via argv (PHONY_API_KEY / ~/.phony/config.json only)
8
9
  * - exit codes: 0 success, 1 runtime failure, 2 usage/compliance error
9
10
  */
10
- import 'dotenv/config';
11
+ import { Command } from 'commander';
12
+ /** The whole command tree; bin/phony.js runs it through main(). */
13
+ export declare function createProgram(): Command;
14
+ /** Commander's own parse errors on the exit-code contract: help and version 0, the rest 2 (usage). */
15
+ export declare function exitCodeOf(err: unknown): number | undefined;
16
+ export declare function main(): Promise<void>;
11
17
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,eAAe,CAAA"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,OAAO,EAAqB,MAAM,WAAW,CAAA;AAwCtD,mEAAmE;AACnE,wBAAgB,aAAa,IAAI,OAAO,CA6BvC;AAED,sGAAsG;AACtG,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAI3D;AAED,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAW1C"}
package/dist/index.js CHANGED
@@ -1,20 +1,20 @@
1
1
  /**
2
- * Phony CLI — agents, keys, and outbound calls over the Phony Voice API.
2
+ * Phony CLI — speech, agents, keys and outbound calls over the Phony Voice API.
3
3
  *
4
- * Designed to be driven by autonomous LLM agents:
5
- * - every read/list command supports --json (2-space, no colors)
4
+ * Designed to be driven by autonomous LLM agents (AGENT_HELP below is the
5
+ * contract, printed under `phony --help`; FOOTER summarizes it on every other screen):
6
+ * - every command supports --json (2-space, no colors)
6
7
  * - no interactive prompts
7
8
  * - no secret values via argv (PHONY_API_KEY / ~/.phony/config.json only)
8
9
  * - exit codes: 0 success, 1 runtime failure, 2 usage/compliance error
9
10
  */
10
- import 'dotenv/config';
11
+ import { config as loadDotenv } from 'dotenv';
11
12
  import { createRequire } from 'node:module';
12
- import { Command } from 'commander';
13
+ import { Command, Help } from 'commander';
13
14
  import { createAuthCommand } from './commands/auth.js';
14
15
  import { createKeysCommand } from './commands/keys.js';
15
16
  import { createAgentsCommand } from './commands/agents.js';
16
17
  import { createCallCommand } from './commands/call.js';
17
- import { createCampaignCommand } from './commands/campaign.js';
18
18
  import { createKnowledgeCommand } from './commands/knowledge.js';
19
19
  import { createVoicesCommand } from './commands/voices.js';
20
20
  import { createProvidersCommand } from './commands/providers.js';
@@ -27,61 +27,77 @@ import { createProductsCommand } from './commands/products.js';
27
27
  import { createDomainsCommand } from './commands/domains.js';
28
28
  import { createConversationsCommand } from './commands/conversations.js';
29
29
  import { createRawCommand } from './commands/raw.js';
30
+ import { createVideoCommand } from './commands/video.js';
31
+ import { createTranslateCommand } from './commands/translate.js';
32
+ import { createTranscribeCommand } from './commands/transcribe.js';
33
+ import { createSynthesizeCommand } from './commands/synthesize.js';
34
+ import { createCreditsCommand, createPhoneNumbersCommand, createPricingCommand } from './commands/account.js';
30
35
  import { EXIT_OK, EXIT_USAGE } from './lib/exit.js';
31
36
  const require = createRequire(import.meta.url);
32
37
  const packageJson = require('../package.json');
33
- const program = new Command();
34
- program
35
- .name('phony')
36
- .description('CLI for the Phony Voice API')
37
- .version(packageJson.version ?? '0.0.0');
38
- program.addCommand(createAuthCommand());
39
- program.addCommand(createKeysCommand());
40
- program.addCommand(createAgentsCommand());
41
- program.addCommand(createKnowledgeCommand());
42
- program.addCommand(createVoicesCommand());
43
- program.addCommand(createProvidersCommand());
44
- program.addCommand(createToolsCommand());
45
- program.addCommand(createTestsCommand());
46
- program.addCommand(createCallCommand());
47
- program.addCommand(createTasksCommand());
48
- program.addCommand(createConversationsCommand());
49
- program.addCommand(createContactsCommand());
50
- program.addCommand(createProductsCommand());
51
- program.addCommand(createDomainsCommand());
52
- program.addCommand(createObservabilityCommand());
53
- program.addCommand(createCampaignCommand());
54
- program.addCommand(createRawCommand());
55
- // Map commander's own parse errors onto our exit-code contract: help/version
56
- // exit 0, every malformed-invocation error exits 2 (usage). Commander prints
57
- // the message itself, so we only translate the code. Applied to every command
58
- // in the tree so missing-required-option on a leaf subcommand also exits 2.
59
- applyExitOverride(program);
60
- function applyExitOverride(command) {
61
- command.exitOverride();
62
- for (const child of command.commands) {
63
- applyExitOverride(child);
64
- }
38
+ // Printed once, under `phony --help`; every other screen gets the one-line FOOTER.
39
+ const AGENT_HELP = `
40
+ Credentials: PHONY_API_KEY, else the active profile in ~/.phony/config.json.
41
+ PHONY_BASE_URL overrides the API (default https://api.ph0ny.com).
42
+ Output: --json prints one JSON document on stdout; errors add {"error":{...}}.
43
+ Nothing prompts. A failure always prints one line, its cause, on stderr.
44
+ Exit codes:
45
+ 0 success
46
+ 1 runtime failure: the API, the network or the job failed
47
+ 2 usage: bad or missing arguments, no API key, missing consent;
48
+ retrying the same command will not succeed`;
49
+ const FOOTER = '\nKey: PHONY_API_KEY. --json: one JSON document on stdout. Exit 0 ok, 1 failed, 2 usage.';
50
+ /** The whole command tree; bin/phony.js runs it through main(). */
51
+ export function createProgram() {
52
+ const program = new Command()
53
+ .name('phony')
54
+ .description('CLI for the ph0ny Voice API: transcribe, translate, synthesize, agents and calls')
55
+ .version(packageJson.version ?? '0.0.0')
56
+ .addHelpText('after', AGENT_HELP);
57
+ for (const command of [
58
+ createTranscribeCommand(), createTranslateCommand(), createSynthesizeCommand(), createAuthCommand(), createKeysCommand(),
59
+ createAgentsCommand(), createKnowledgeCommand(), createVoicesCommand(), createVideoCommand(), createProvidersCommand(),
60
+ createToolsCommand(), createTestsCommand(), createCallCommand(), createTasksCommand(), createConversationsCommand(),
61
+ createContactsCommand(), createProductsCommand(), createDomainsCommand(), createObservabilityCommand(),
62
+ createCreditsCommand(), createPricingCommand(), createPhoneNumbersCommand(), createRawCommand(),
63
+ ])
64
+ program.addCommand(command);
65
+ // Throw commander's parse errors (main() maps them to exit codes) on every
66
+ // command in the tree, so missing-required-option on a leaf also exits 2;
67
+ // mark every requiredOption "(required)" in help; and end every screen below
68
+ // the top level with the one-line footer.
69
+ const configure = (command) => {
70
+ command.exitOverride();
71
+ command.configureHelp({
72
+ ...command.configureHelp(),
73
+ optionDescription: (option) => `${Help.prototype.optionDescription.call(new Help(), option)}${option.mandatory ? ' (required)' : ''}`,
74
+ });
75
+ if (command !== program)
76
+ command.addHelpText('after', FOOTER);
77
+ command.commands.forEach(configure);
78
+ };
79
+ configure(program);
80
+ return program;
81
+ }
82
+ /** Commander's own parse errors on the exit-code contract: help and version 0, the rest 2 (usage). */
83
+ export function exitCodeOf(err) {
84
+ if (!(err instanceof Error) || typeof err.code !== 'string')
85
+ return undefined;
86
+ const { code } = err;
87
+ return code === 'commander.helpDisplayed' || code === 'commander.version' || code === 'commander.help' ? EXIT_OK : EXIT_USAGE;
65
88
  }
66
- async function main() {
89
+ export async function main() {
90
+ // A .env in the working directory may set PHONY_API_KEY. Quiet, because dotenv
91
+ // 16.6 otherwise logs to stdout and would corrupt --json output.
92
+ loadDotenv({ quiet: true });
67
93
  try {
68
- await program.parseAsync(process.argv);
94
+ await createProgram().parseAsync(process.argv);
69
95
  }
70
96
  catch (err) {
71
- if (isCommanderError(err)) {
72
- if (err.code === 'commander.helpDisplayed' || err.code === 'commander.version' || err.code === 'commander.help') {
73
- process.exit(EXIT_OK);
74
- }
75
- process.exit(EXIT_USAGE);
76
- }
77
- throw err;
97
+ const code = exitCodeOf(err);
98
+ if (code === undefined)
99
+ process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}\n`);
100
+ process.exit(code ?? 1);
78
101
  }
79
102
  }
80
- function isCommanderError(err) {
81
- return err instanceof Error && typeof err.code === 'string';
82
- }
83
- main().catch((err) => {
84
- process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}\n`);
85
- process.exit(1);
86
- });
87
103
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
@@ -1,28 +1,43 @@
1
1
  /**
2
2
  * Pure builders for `phony agents create|update`.
3
3
  *
4
- * An agent body comes from EITHER --file <json> (full body) OR discrete flags
5
- * (--name/--system-prompt/--voice/--llm). The two are mutually exclusive to
6
- * avoid silent precedence surprises. Field names mirror the agents route schema
7
- * (name, systemPrompt, voiceId, llmProvider).
4
+ * An agent body comes from EITHER --file <json> (full body) OR discrete flags.
5
+ * The two are mutually exclusive to avoid silent precedence surprises. Field
6
+ * names mirror the agents route schema (CreateAgentSchema in
7
+ * infra/voice-api/src/routes/agents.ts), which drops a key it does not know, so
8
+ * a create --file key outside CREATE_AGENT_KEYS is refused here instead.
8
9
  */
9
- import { type LLMProviderType } from '@ph0ny/sdk';
10
- export interface AgentFlagInput {
10
+ import { type AgentLLMProviderType } from '@ph0ny/sdk';
11
+ /** Every key POST /v1/agents takes. */
12
+ export declare const CREATE_AGENT_KEYS: readonly ["id", "developerId", "name", "description", "agentKind", "systemPrompt", "firstMessage", "voiceId", "ttsProvider", "ttsModel", "sttProvider", "llmProvider", "llmModel", "libraryId", "collectionId", "styleProfile", "promptByModel", "language", "temperature", "maxTokens", "contactCaptureEnabled", "contactCaptureFields", "metadata"];
13
+ /** Discrete flag (commander's camelCase name) -> body field. */
14
+ declare const FLAG_FIELDS: {
15
+ readonly name: "name";
16
+ readonly systemPrompt: "systemPrompt";
17
+ readonly firstMessage: "firstMessage";
18
+ readonly language: "language";
19
+ readonly kind: "agentKind";
20
+ readonly voice: "voiceId";
21
+ readonly ttsProvider: "ttsProvider";
22
+ readonly ttsModel: "ttsModel";
23
+ readonly llm: "llmProvider";
24
+ readonly llmModel: "llmModel";
25
+ };
26
+ export type AgentFlagInput = {
11
27
  file?: Record<string, unknown>;
12
- name?: string;
13
- systemPrompt?: string;
14
- voice?: string;
15
- llm?: string;
16
- }
28
+ } & {
29
+ [flag in keyof typeof FLAG_FIELDS]?: string;
30
+ };
17
31
  export interface AgentBody {
18
32
  name?: string;
19
33
  systemPrompt?: string;
20
34
  voiceId?: string;
21
- llmProvider?: LLMProviderType;
35
+ llmProvider?: AgentLLMProviderType;
22
36
  [key: string]: unknown;
23
37
  }
24
38
  /** Build the create body. `name` is required (from --file or --name). */
25
39
  export declare function buildCreateAgentBody(input: AgentFlagInput): AgentBody;
26
40
  /** Build the update body. At least one mutable field is required. */
27
41
  export declare function buildUpdateAgentBody(input: AgentFlagInput): AgentBody;
42
+ export {};
28
43
  //# sourceMappingURL=agent-payload.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"agent-payload.d.ts","sourceRoot":"","sources":["../../src/lib/agent-payload.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,YAAY,CAAA;AAGhE,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,eAAe,CAAA;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAkBD,yEAAyE;AACzE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CAerE;AAED,qEAAqE;AACrE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CAUrE"}
1
+ {"version":3,"file":"agent-payload.d.ts","sourceRoot":"","sources":["../../src/lib/agent-payload.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAsC,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAG1F,uCAAuC;AACvC,eAAO,MAAM,iBAAiB,uVAIpB,CAAA;AAEV,gEAAgE;AAChE,QAAA,MAAM,WAAW;;;;;;;;;;;CAGP,CAAA;AAEV,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG;KAAG,IAAI,IAAI,MAAM,OAAO,WAAW,CAAC,CAAC,EAAE,MAAM;CAAE,CAAA;AAEjH,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,oBAAoB,CAAA;IAClC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAoBD,yEAAyE;AACzE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CAmBrE;AAED,qEAAqE;AACrE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CAUrE"}
@@ -1,27 +1,39 @@
1
1
  /**
2
2
  * Pure builders for `phony agents create|update`.
3
3
  *
4
- * An agent body comes from EITHER --file <json> (full body) OR discrete flags
5
- * (--name/--system-prompt/--voice/--llm). The two are mutually exclusive to
6
- * avoid silent precedence surprises. Field names mirror the agents route schema
7
- * (name, systemPrompt, voiceId, llmProvider).
4
+ * An agent body comes from EITHER --file <json> (full body) OR discrete flags.
5
+ * The two are mutually exclusive to avoid silent precedence surprises. Field
6
+ * names mirror the agents route schema (CreateAgentSchema in
7
+ * infra/voice-api/src/routes/agents.ts), which drops a key it does not know, so
8
+ * a create --file key outside CREATE_AGENT_KEYS is refused here instead.
8
9
  */
9
- import { LLM_PROVIDERS } from '@ph0ny/sdk';
10
+ import { LLM_PROVIDERS, S2S_AGENT_PROVIDERS } from '@ph0ny/sdk';
10
11
  import { UsageError } from './exit.js';
12
+ /** Every key POST /v1/agents takes. */
13
+ export const CREATE_AGENT_KEYS = [
14
+ 'id', 'developerId', 'name', 'description', 'agentKind', 'systemPrompt', 'firstMessage', 'voiceId', 'ttsProvider',
15
+ 'ttsModel', 'sttProvider', 'llmProvider', 'llmModel', 'libraryId', 'collectionId', 'styleProfile', 'promptByModel',
16
+ 'language', 'temperature', 'maxTokens', 'contactCaptureEnabled', 'contactCaptureFields', 'metadata',
17
+ ];
18
+ /** Discrete flag (commander's camelCase name) -> body field. */
19
+ const FLAG_FIELDS = {
20
+ name: 'name', systemPrompt: 'systemPrompt', firstMessage: 'firstMessage', language: 'language', kind: 'agentKind',
21
+ voice: 'voiceId', ttsProvider: 'ttsProvider', ttsModel: 'ttsModel', llm: 'llmProvider', llmModel: 'llmModel',
22
+ };
11
23
  function assertLlmProvider(value) {
12
- if (!LLM_PROVIDERS.includes(value)) {
13
- throw new UsageError(`--llm must be one of: ${LLM_PROVIDERS.join(', ')} (got "${value}").`, 'INVALID_LLM');
24
+ const allowed = [...LLM_PROVIDERS, ...S2S_AGENT_PROVIDERS];
25
+ if (!allowed.includes(value)) {
26
+ throw new UsageError(`--llm must be one of: ${allowed.join(', ')} (got "${value}").`, 'INVALID_LLM');
14
27
  }
15
28
  return value;
16
29
  }
17
30
  function bodyFromFlags(input) {
18
31
  const body = {};
19
- if (input.name !== undefined)
20
- body.name = input.name;
21
- if (input.systemPrompt !== undefined)
22
- body.systemPrompt = input.systemPrompt;
23
- if (input.voice !== undefined)
24
- body.voiceId = input.voice;
32
+ for (const [flag, field] of Object.entries(FLAG_FIELDS)) {
33
+ const value = input[flag];
34
+ if (value !== undefined)
35
+ body[field] = value;
36
+ }
25
37
  if (input.llm !== undefined)
26
38
  body.llmProvider = assertLlmProvider(input.llm);
27
39
  return body;
@@ -29,9 +41,13 @@ function bodyFromFlags(input) {
29
41
  /** Build the create body. `name` is required (from --file or --name). */
30
42
  export function buildCreateAgentBody(input) {
31
43
  if (input.file && hasAnyFlag(input)) {
32
- throw new UsageError('Use either --file or discrete flags (--name/--system-prompt/--voice/--llm), not both.', 'CONFLICTING_ARGS');
44
+ throw new UsageError('Use either --file or discrete flags, not both.', 'CONFLICTING_ARGS');
33
45
  }
34
46
  if (input.file) {
47
+ const unknown = Object.keys(input.file).filter((key) => !CREATE_AGENT_KEYS.includes(key));
48
+ if (unknown.length) {
49
+ throw new UsageError(`--file has keys POST /v1/agents does not take: ${unknown.join(', ')}. It takes: ${CREATE_AGENT_KEYS.join(', ')}.`, 'UNKNOWN_FIELD');
50
+ }
35
51
  if (typeof input.file.name !== 'string' || input.file.name.length === 0) {
36
52
  throw new UsageError('--file body must include a non-empty "name".', 'MISSING_ARG');
37
53
  }
@@ -46,20 +62,17 @@ export function buildCreateAgentBody(input) {
46
62
  /** Build the update body. At least one mutable field is required. */
47
63
  export function buildUpdateAgentBody(input) {
48
64
  if (input.file && hasAnyFlag(input)) {
49
- throw new UsageError('Use either --file or discrete flags (--name/--system-prompt/--voice/--llm), not both.', 'CONFLICTING_ARGS');
65
+ throw new UsageError('Use either --file or discrete flags, not both.', 'CONFLICTING_ARGS');
50
66
  }
51
67
  if (input.file)
52
68
  return input.file;
53
69
  const body = bodyFromFlags(input);
54
70
  if (Object.keys(body).length === 0) {
55
- throw new UsageError('Nothing to update. Provide --file or at least one of --name/--system-prompt/--voice/--llm.', 'MISSING_ARG');
71
+ throw new UsageError('Nothing to update. Provide --file or at least one flag.', 'MISSING_ARG');
56
72
  }
57
73
  return body;
58
74
  }
59
75
  function hasAnyFlag(input) {
60
- return (input.name !== undefined ||
61
- input.systemPrompt !== undefined ||
62
- input.voice !== undefined ||
63
- input.llm !== undefined);
76
+ return Object.keys(FLAG_FIELDS).some((flag) => input[flag] !== undefined);
64
77
  }
65
78
  //# sourceMappingURL=agent-payload.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"agent-payload.js","sourceRoot":"","sources":["../../src/lib/agent-payload.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAwB,MAAM,YAAY,CAAA;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAkBtC,SAAS,iBAAiB,CAAC,KAAa;IACtC,IAAI,CAAE,aAAmC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,UAAU,CAAC,yBAAyB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,KAAK,KAAK,EAAE,aAAa,CAAC,CAAA;IAC5G,CAAC;IACD,OAAO,KAAwB,CAAA;AACjC,CAAC;AAED,SAAS,aAAa,CAAC,KAAqB;IAC1C,MAAM,IAAI,GAAc,EAAE,CAAA;IAC1B,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAA;IACpD,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS;QAAE,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,CAAA;IAC5E,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;QAAE,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,KAAK,CAAA;IACzD,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS;QAAE,IAAI,CAAC,WAAW,GAAG,iBAAiB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC5E,OAAO,IAAI,CAAA;AACb,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,oBAAoB,CAAC,KAAqB;IACxD,IAAI,KAAK,CAAC,IAAI,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,UAAU,CAAC,uFAAuF,EAAE,kBAAkB,CAAC,CAAA;IACnI,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,IAAI,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,UAAU,CAAC,8CAA8C,EAAE,aAAa,CAAC,CAAA;QACrF,CAAC;QACD,OAAO,KAAK,CAAC,IAAiB,CAAA;IAChC,CAAC;IACD,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAA;IACjC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACf,MAAM,IAAI,UAAU,CAAC,qDAAqD,EAAE,aAAa,CAAC,CAAA;IAC5F,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,oBAAoB,CAAC,KAAqB;IACxD,IAAI,KAAK,CAAC,IAAI,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,UAAU,CAAC,uFAAuF,EAAE,kBAAkB,CAAC,CAAA;IACnI,CAAC;IACD,IAAI,KAAK,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC,IAAiB,CAAA;IAC9C,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAA;IACjC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,UAAU,CAAC,4FAA4F,EAAE,aAAa,CAAC,CAAA;IACnI,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,SAAS,UAAU,CAAC,KAAqB;IACvC,OAAO,CACL,KAAK,CAAC,IAAI,KAAK,SAAS;QACxB,KAAK,CAAC,YAAY,KAAK,SAAS;QAChC,KAAK,CAAC,KAAK,KAAK,SAAS;QACzB,KAAK,CAAC,GAAG,KAAK,SAAS,CACxB,CAAA;AACH,CAAC"}
1
+ {"version":3,"file":"agent-payload.js","sourceRoot":"","sources":["../../src/lib/agent-payload.ts"],"names":[],"mappings":"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"}
@@ -11,6 +11,8 @@ export interface CallStartInput {
11
11
  to?: string;
12
12
  from?: string;
13
13
  goal?: string;
14
+ purpose?: string;
15
+ callerName?: string;
14
16
  ivrHints?: string;
15
17
  successSchema?: Record<string, unknown>;
16
18
  dryRun?: boolean;
@@ -22,9 +24,13 @@ export interface OutboundStartPayload {
22
24
  fromNumber: string;
23
25
  mission: {
24
26
  goal: string;
27
+ purpose?: string;
25
28
  successSchema?: Record<string, unknown>;
26
29
  ivrHints?: string[];
27
30
  };
31
+ callerProfile?: {
32
+ userName: string;
33
+ };
28
34
  userConsentRecorded: true;
29
35
  dryRun?: boolean;
30
36
  }
@@ -1 +1 @@
1
- {"version":3,"file":"call-payload.d.ts","sourceRoot":"","sources":["../../src/lib/call-payload.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACvC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAA;QACZ,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QACvC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KACpB,CAAA;IACD,mBAAmB,EAAE,IAAI,CAAA;IACzB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAI7D;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,GAAG,SAAS,CAI3E;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,cAAc,GAAG,oBAAoB,CA+BrF"}
1
+ {"version":3,"file":"call-payload.d.ts","sourceRoot":"","sources":["../../src/lib/call-payload.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACvC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QACvC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KACpB,CAAA;IACD,aAAa,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;IACpC,mBAAmB,EAAE,IAAI,CAAA;IACzB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAI7D;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,GAAG,SAAS,CAI3E;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,cAAc,GAAG,oBAAoB,CA6CrF"}
@@ -44,6 +44,13 @@ export function buildOutboundStartPayload(input) {
44
44
  assertE164(input.to, '--to');
45
45
  assertE164(input.from, '--from');
46
46
  const mission = { goal: input.goal };
47
+ if (input.purpose !== undefined) {
48
+ const purpose = input.purpose.trim();
49
+ if (purpose.length < 3 || purpose.length > 100) {
50
+ throw new UsageError('--purpose must be 3 to 100 characters.', 'INVALID_ARG');
51
+ }
52
+ mission.purpose = purpose;
53
+ }
47
54
  if (input.successSchema)
48
55
  mission.successSchema = input.successSchema;
49
56
  const ivrHints = parseIvrHints(input.ivrHints);
@@ -56,6 +63,13 @@ export function buildOutboundStartPayload(input) {
56
63
  mission,
57
64
  userConsentRecorded: true,
58
65
  };
66
+ if (input.callerName !== undefined) {
67
+ const userName = input.callerName.trim();
68
+ if (userName.length < 1 || userName.length > 120) {
69
+ throw new UsageError('--caller-name must be 1 to 120 characters.', 'INVALID_ARG');
70
+ }
71
+ payload.callerProfile = { userName };
72
+ }
59
73
  if (input.dryRun === true)
60
74
  payload.dryRun = true;
61
75
  return payload;
@@ -1 +1 @@
1
- {"version":3,"file":"call-payload.js","sourceRoot":"","sources":["../../src/lib/call-payload.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAEtC,6DAA6D;AAC7D,MAAM,IAAI,GAAG,mBAAmB,CAAA;AA0BhC,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,KAAa;IACrD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,UAAU,CAAC,GAAG,KAAK,mDAAmD,KAAK,IAAI,EAAE,cAAc,CAAC,CAAA;IAC5G,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,aAAa,CAAC,GAAuB;IACnD,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAA;IAC1B,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACjE,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;AAC7C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAqB;IAC7D,IAAI,KAAK,CAAC,eAAe,KAAK,IAAI,EAAE,CAAC;QACnC,MAAM,IAAI,UAAU,CAClB,iKAAiK,EACjK,kBAAkB,CACnB,CAAA;IACH,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,KAAK;QAAE,MAAM,IAAI,UAAU,CAAC,uBAAuB,EAAE,aAAa,CAAC,CAAA;IAC9E,IAAI,CAAC,KAAK,CAAC,EAAE;QAAE,MAAM,IAAI,UAAU,CAAC,sBAAsB,EAAE,aAAa,CAAC,CAAA;IAC1E,IAAI,CAAC,KAAK,CAAC,IAAI;QAAE,MAAM,IAAI,UAAU,CAAC,wBAAwB,EAAE,aAAa,CAAC,CAAA;IAC9E,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,UAAU,CAAC,+EAA+E,EAAE,aAAa,CAAC,CAAA;IACtH,CAAC;IAED,UAAU,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAA;IAC5B,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAEhC,MAAM,OAAO,GAAoC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAA;IACrE,IAAI,KAAK,CAAC,aAAa;QAAE,OAAO,CAAC,aAAa,GAAG,KAAK,CAAC,aAAa,CAAA;IACpE,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IAC9C,IAAI,QAAQ;QAAE,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAEzC,MAAM,OAAO,GAAyB;QACpC,OAAO,EAAE,KAAK,CAAC,KAAK;QACpB,QAAQ,EAAE,KAAK,CAAC,EAAE;QAClB,UAAU,EAAE,KAAK,CAAC,IAAI;QACtB,OAAO;QACP,mBAAmB,EAAE,IAAI;KAC1B,CAAA;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI;QAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAA;IAChD,OAAO,OAAO,CAAA;AAChB,CAAC"}
1
+ {"version":3,"file":"call-payload.js","sourceRoot":"","sources":["../../src/lib/call-payload.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ import type { ObservabilitySessionDetail } from '@ph0ny/sdk';
2
+ /** Read the same observed stages that were exported to OTLP; never fill missing clocks with zero. */
3
+ export declare function callWaterfall(detail: ObservabilitySessionDetail): {
4
+ sessionId: string | null;
5
+ callId: string | null;
6
+ turns: {
7
+ turnIndex: number;
8
+ stages: (Record<string, unknown> & {
9
+ offsetMs: number | null;
10
+ })[];
11
+ unmeasured: string[];
12
+ }[];
13
+ };
14
+ //# sourceMappingURL=call-trace.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"call-trace.d.ts","sourceRoot":"","sources":["../../src/lib/call-trace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAA;AAI5D,qGAAqG;AACrG,wBAAgB,aAAa,CAAC,MAAM,EAAE,0BAA0B;;;;;;sBAoBU,MAAM,GAAG,IAAI;;;;EAKtF"}
@@ -0,0 +1,30 @@
1
+ const STAGES = ['call.speech_end_to_transcript', 'call.model.first_token', 'call.model', 'call.voice.first_audio', 'call.audio.played'];
2
+ /** Read the same observed stages that were exported to OTLP; never fill missing clocks with zero. */
3
+ export function callWaterfall(detail) {
4
+ const turns = new Map();
5
+ for (const event of detail.events) {
6
+ const data = event.data;
7
+ if (event.type === 'turn.completed' && typeof data?.turnIndex === 'number' && !turns.has(data.turnIndex)) {
8
+ turns.set(data.turnIndex, []);
9
+ }
10
+ if (event.type !== 'call.stage' || !data || typeof data.turnIndex !== 'number' || typeof data.name !== 'string')
11
+ continue;
12
+ const stages = turns.get(data.turnIndex) ?? [];
13
+ stages.push(data);
14
+ turns.set(data.turnIndex, stages);
15
+ }
16
+ return {
17
+ sessionId: detail.session.sessionId,
18
+ callId: detail.session.callId,
19
+ turns: [...turns].sort(([a], [b]) => a - b).map(([turnIndex, stages]) => {
20
+ stages.sort((a, b) => Number(a.startedAtMs) - Number(b.startedAtMs));
21
+ const origin = stages.find(stage => stage.name === 'call.turn')?.startedAtMs;
22
+ return {
23
+ turnIndex,
24
+ stages: stages.map((stage) => ({ ...stage, offsetMs: typeof origin === 'number' && typeof stage.startedAtMs === 'number' ? stage.startedAtMs - origin : null })),
25
+ unmeasured: STAGES.filter(name => !stages.some(stage => stage.name === name)),
26
+ };
27
+ }),
28
+ };
29
+ }
30
+ //# sourceMappingURL=call-trace.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"call-trace.js","sourceRoot":"","sources":["../../src/lib/call-trace.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GAAG,CAAC,+BAA+B,EAAE,wBAAwB,EAAE,YAAY,EAAE,wBAAwB,EAAE,mBAAmB,CAAC,CAAA;AAEvI,qGAAqG;AACrG,MAAM,UAAU,aAAa,CAAC,MAAkC;IAC9D,MAAM,KAAK,GAAG,IAAI,GAAG,EAA0C,CAAA;IAC/D,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAA;QACvB,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,IAAI,OAAO,IAAI,EAAE,SAAS,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACzG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;QAC/B,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;YAAE,SAAQ;QACzH,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAA;QAC9C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACjB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;IACnC,CAAC;IACD,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS;QACnC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;QAC7B,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,EAAE;YACtE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAA;YACpE,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,EAAE,WAAW,CAAA;YAC5E,OAAO;gBACL,SAAS;gBACT,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAyD,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;gBACvN,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;aAC9E,CAAA;QACH,CAAC,CAAC;KACH,CAAA;AACH,CAAC"}
@@ -2,9 +2,9 @@
2
2
  * Central error formatting + exit-code mapping.
3
3
  *
4
4
  * Every command action runs inside `run()`. It converts SDK exceptions,
5
- * usage errors, and bare errors into a single message line (human mode) or a
6
- * `{ error: { code, message, status? } }` object (--json), then exits with the
7
- * code the error class dictates. No stack traces ever reach stdout/stderr.
5
+ * usage errors, and bare errors into one message line on stderr, plus a
6
+ * `{ error: { code, message, status? } }` object on stdout under --json, then
7
+ * exits with the code the error class dictates. No stack traces are printed.
8
8
  */
9
9
  interface FormattedError {
10
10
  code: string;
@@ -14,7 +14,10 @@ interface FormattedError {
14
14
  }
15
15
  export declare function formatError(err: unknown): FormattedError;
16
16
  export declare function exitCodeFor(err: unknown): number;
17
- /** Print an error (human or JSON) and exit with the mapped code. */
17
+ /**
18
+ * Print an error and exit with the mapped code. The cause is always one line on
19
+ * stderr; with --json the same error is also the JSON object on stdout.
20
+ */
18
21
  export declare function handleError(err: unknown, json?: boolean): never;
19
22
  /**
20
23
  * Wrap a command action so any thrown error is formatted, printed, and mapped
@@ -1 +1 @@
1
- {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAgBxD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAGhD;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,UAAQ,GAAG,KAAK,CAS7D;AAED;;;GAGG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,OAAO,EAAE,EACrC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAC3C,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAW/B"}
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAgBxD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAGhD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,UAAQ,GAAG,KAAK,CAO7D;AAED;;;GAGG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,OAAO,EAAE,EACrC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAC3C,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAW/B"}
@@ -2,9 +2,9 @@
2
2
  * Central error formatting + exit-code mapping.
3
3
  *
4
4
  * Every command action runs inside `run()`. It converts SDK exceptions,
5
- * usage errors, and bare errors into a single message line (human mode) or a
6
- * `{ error: { code, message, status? } }` object (--json), then exits with the
7
- * code the error class dictates. No stack traces ever reach stdout/stderr.
5
+ * usage errors, and bare errors into one message line on stderr, plus a
6
+ * `{ error: { code, message, status? } }` object on stdout under --json, then
7
+ * exits with the code the error class dictates. No stack traces are printed.
8
8
  */
9
9
  import chalk from 'chalk';
10
10
  import { VoiceApiException } from '@ph0ny/sdk';
@@ -32,16 +32,17 @@ export function exitCodeFor(err) {
32
32
  return EXIT_USAGE;
33
33
  return EXIT_FAILURE;
34
34
  }
35
- /** Print an error (human or JSON) and exit with the mapped code. */
35
+ /**
36
+ * Print an error and exit with the mapped code. The cause is always one line on
37
+ * stderr; with --json the same error is also the JSON object on stdout.
38
+ */
36
39
  export function handleError(err, json = false) {
37
40
  const formatted = formatError(err);
38
- if (json) {
41
+ if (json)
39
42
  printJson({ error: formatted });
40
- }
41
- else {
42
- const status = formatted.status ? chalk.dim(` (HTTP ${formatted.status})`) : '';
43
- process.stderr.write(`${chalk.red('Error')} ${chalk.dim(formatted.code)}${status}: ${formatted.message}\n`);
44
- }
43
+ const status = formatted.status ? chalk.dim(` (HTTP ${formatted.status})`) : '';
44
+ const message = formatted.message.replace(/\s*\n\s*/g, ' ');
45
+ process.stderr.write(`${chalk.red('Error')} ${chalk.dim(formatted.code)}${status}: ${message}\n`);
45
46
  process.exit(exitCodeFor(err));
46
47
  }
47
48
  /**