@hypercli.com/sdk 2026.6.26 → 2026.8.11

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 (106) hide show
  1. package/README.md +181 -1
  2. package/dist/agent-slots.d.ts +17 -0
  3. package/dist/agent-slots.d.ts.map +1 -0
  4. package/dist/agent-slots.js +18 -0
  5. package/dist/agent-slots.js.map +1 -0
  6. package/dist/agent.d.ts +67 -12
  7. package/dist/agent.d.ts.map +1 -1
  8. package/dist/agent.js +220 -28
  9. package/dist/agent.js.map +1 -1
  10. package/dist/agents.d.ts +690 -82
  11. package/dist/agents.d.ts.map +1 -1
  12. package/dist/agents.js +2595 -225
  13. package/dist/agents.js.map +1 -1
  14. package/dist/browser.d.ts +4 -2
  15. package/dist/browser.d.ts.map +1 -1
  16. package/dist/browser.js +10 -3
  17. package/dist/browser.js.map +1 -1
  18. package/dist/channels.d.ts +156 -0
  19. package/dist/channels.d.ts.map +1 -0
  20. package/dist/channels.js +110 -0
  21. package/dist/channels.js.map +1 -0
  22. package/dist/client.d.ts +2 -0
  23. package/dist/client.d.ts.map +1 -1
  24. package/dist/client.js +14 -4
  25. package/dist/client.js.map +1 -1
  26. package/dist/config.d.ts +1 -1
  27. package/dist/config.js +2 -2
  28. package/dist/config.js.map +1 -1
  29. package/dist/connectors.d.ts +79 -0
  30. package/dist/connectors.d.ts.map +1 -0
  31. package/dist/connectors.js +2 -0
  32. package/dist/connectors.js.map +1 -0
  33. package/dist/errors.d.ts +4 -1
  34. package/dist/errors.d.ts.map +1 -1
  35. package/dist/errors.js +9 -2
  36. package/dist/errors.js.map +1 -1
  37. package/dist/hermes/gateway.d.ts +194 -0
  38. package/dist/hermes/gateway.d.ts.map +1 -0
  39. package/dist/hermes/gateway.js +209 -0
  40. package/dist/hermes/gateway.js.map +1 -0
  41. package/dist/http.d.ts +16 -3
  42. package/dist/http.d.ts.map +1 -1
  43. package/dist/http.js +196 -63
  44. package/dist/http.js.map +1 -1
  45. package/dist/index.d.ts +15 -5
  46. package/dist/index.d.ts.map +1 -1
  47. package/dist/index.js +13 -4
  48. package/dist/index.js.map +1 -1
  49. package/dist/job/base.d.ts +6 -0
  50. package/dist/job/base.d.ts.map +1 -1
  51. package/dist/job/base.js +7 -1
  52. package/dist/job/base.js.map +1 -1
  53. package/dist/keys.d.ts +21 -5
  54. package/dist/keys.d.ts.map +1 -1
  55. package/dist/keys.js +62 -3
  56. package/dist/keys.js.map +1 -1
  57. package/dist/openclaw/channels.d.ts +86 -0
  58. package/dist/openclaw/channels.d.ts.map +1 -0
  59. package/dist/openclaw/channels.js +290 -0
  60. package/dist/openclaw/channels.js.map +1 -0
  61. package/dist/openclaw/connectors.d.ts +61 -0
  62. package/dist/openclaw/connectors.d.ts.map +1 -0
  63. package/dist/openclaw/connectors.js +174 -0
  64. package/dist/openclaw/connectors.js.map +1 -0
  65. package/dist/openclaw/gateway.d.ts +682 -16
  66. package/dist/openclaw/gateway.d.ts.map +1 -1
  67. package/dist/openclaw/gateway.js +1794 -187
  68. package/dist/openclaw/gateway.js.map +1 -1
  69. package/dist/openclaw/skills.d.ts +106 -0
  70. package/dist/openclaw/skills.d.ts.map +1 -0
  71. package/dist/openclaw/skills.js +575 -0
  72. package/dist/openclaw/skills.js.map +1 -0
  73. package/dist/openclaw/slack.d.ts +818 -0
  74. package/dist/openclaw/slack.d.ts.map +1 -0
  75. package/dist/openclaw/slack.js +536 -0
  76. package/dist/openclaw/slack.js.map +1 -0
  77. package/dist/openclaw/whatsapp.d.ts +63 -0
  78. package/dist/openclaw/whatsapp.d.ts.map +1 -0
  79. package/dist/openclaw/whatsapp.js +264 -0
  80. package/dist/openclaw/whatsapp.js.map +1 -0
  81. package/dist/renders.js +11 -11
  82. package/dist/renders.js.map +1 -1
  83. package/dist/skills.d.ts +126 -0
  84. package/dist/skills.d.ts.map +1 -0
  85. package/dist/skills.js +2 -0
  86. package/dist/skills.js.map +1 -0
  87. package/dist/user.d.ts +15 -2
  88. package/dist/user.d.ts.map +1 -1
  89. package/dist/user.js +51 -4
  90. package/dist/user.js.map +1 -1
  91. package/dist/voice-session.d.ts +74 -0
  92. package/dist/voice-session.d.ts.map +1 -0
  93. package/dist/voice-session.js +255 -0
  94. package/dist/voice-session.js.map +1 -0
  95. package/dist/voice.d.ts +27 -3
  96. package/dist/voice.d.ts.map +1 -1
  97. package/dist/voice.js +89 -6
  98. package/dist/voice.js.map +1 -1
  99. package/dist/workspaces.d.ts +181 -0
  100. package/dist/workspaces.d.ts.map +1 -0
  101. package/dist/workspaces.js +495 -0
  102. package/dist/workspaces.js.map +1 -0
  103. package/dist/x402.d.ts.map +1 -1
  104. package/dist/x402.js +1 -2
  105. package/dist/x402.js.map +1 -1
  106. package/package.json +42 -2
package/dist/voice.js CHANGED
@@ -1,6 +1,21 @@
1
+ /**
2
+ * Voice capability API
3
+ */
4
+ import { getAgentsWsUrlFromProductBase } from './config.js';
5
+ import { VoiceSession } from './voice-session.js';
6
+ export { VoiceSession, VoiceStreamError, } from './voice-session.js';
1
7
  function encodeBase64(bytes) {
2
8
  const data = bytes instanceof Uint8Array ? bytes : new Uint8Array(bytes);
3
- return Buffer.from(data).toString('base64');
9
+ if (typeof Buffer !== 'undefined') {
10
+ return Buffer.from(data).toString('base64');
11
+ }
12
+ // Browser fallback: btoa over chunked binary string (avoids arg-limit blowups)
13
+ let binary = '';
14
+ const CHUNK = 0x8000;
15
+ for (let i = 0; i < data.length; i += CHUNK) {
16
+ binary += String.fromCharCode(...data.subarray(i, i + CHUNK));
17
+ }
18
+ return btoa(binary);
4
19
  }
5
20
  export class VoiceAPI {
6
21
  http;
@@ -8,15 +23,15 @@ export class VoiceAPI {
8
23
  this.http = http;
9
24
  }
10
25
  async tts(options) {
11
- return this.http.postBytes('/agents/voice/tts', {
26
+ return this.http.postBytes('/voice/tts', {
12
27
  text: options.text,
13
- voice: options.voice ?? 'Chelsie',
28
+ voice: options.voice ?? 'serena',
14
29
  language: options.language ?? 'auto',
15
30
  response_format: options.responseFormat ?? 'mp3',
16
- });
31
+ }, options.signal ? { signal: options.signal } : {});
17
32
  }
18
33
  async clone(options) {
19
- return this.http.postBytes('/agents/voice/clone', {
34
+ return this.http.postBytes('/voice/clone', {
20
35
  text: options.text,
21
36
  ref_audio_base64: encodeBase64(options.refAudio),
22
37
  language: options.language ?? 'auto',
@@ -25,12 +40,80 @@ export class VoiceAPI {
25
40
  });
26
41
  }
27
42
  async design(options) {
28
- return this.http.postBytes('/agents/voice/design', {
43
+ return this.http.postBytes('/voice/design', {
29
44
  text: options.text,
30
45
  instruct: options.description,
31
46
  language: options.language ?? 'auto',
32
47
  response_format: options.responseFormat ?? 'mp3',
33
48
  });
34
49
  }
50
+ /**
51
+ * Create a streaming VoiceSession over /ws/voice (call open() or use ttsStream()).
52
+ */
53
+ connect(options) {
54
+ return new VoiceSession({
55
+ wsUrl: getAgentsWsUrlFromProductBase(this.http.base),
56
+ credential: this.http.credential,
57
+ timeoutMs: options?.timeoutMs,
58
+ });
59
+ }
60
+ /**
61
+ * One-shot streaming TTS: opens a session, speaks, closes.
62
+ */
63
+ async *ttsStream(options) {
64
+ const session = this.connect({ timeoutMs: options.timeoutMs });
65
+ await session.open();
66
+ try {
67
+ yield* session.speak({
68
+ text: options.text,
69
+ voice: options.voice,
70
+ language: options.language,
71
+ format: options.responseFormat,
72
+ chunks: true,
73
+ });
74
+ }
75
+ finally {
76
+ session.close();
77
+ }
78
+ }
79
+ /**
80
+ * One-shot streaming voice clone: opens a session, speaks, closes.
81
+ */
82
+ async *cloneStream(options) {
83
+ const session = this.connect({ timeoutMs: options.timeoutMs });
84
+ await session.open();
85
+ try {
86
+ yield* session.speakClone({
87
+ text: options.text,
88
+ refAudio: options.refAudio,
89
+ language: options.language,
90
+ xVectorOnly: options.xVectorOnly,
91
+ format: options.responseFormat,
92
+ chunks: true,
93
+ });
94
+ }
95
+ finally {
96
+ session.close();
97
+ }
98
+ }
99
+ /**
100
+ * One-shot streaming voice design: opens a session, speaks, closes.
101
+ */
102
+ async *designStream(options) {
103
+ const session = this.connect({ timeoutMs: options.timeoutMs });
104
+ await session.open();
105
+ try {
106
+ yield* session.speakDesign({
107
+ text: options.text,
108
+ description: options.description,
109
+ language: options.language,
110
+ format: options.responseFormat,
111
+ chunks: true,
112
+ });
113
+ }
114
+ finally {
115
+ session.close();
116
+ }
117
+ }
35
118
  }
36
119
  //# sourceMappingURL=voice.js.map
package/dist/voice.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"voice.js","sourceRoot":"","sources":["../src/voice.ts"],"names":[],"mappings":"AA2BA,SAAS,YAAY,CAAC,KAA+B;IACnD,MAAM,IAAI,GAAG,KAAK,YAAY,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IACzE,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,OAAO,QAAQ;IACC;IAApB,YAAoB,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAExC,KAAK,CAAC,GAAG,CAAC,OAAmB;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,mBAAmB,EAAE;YAC9C,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;YACjC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,MAAM;YACpC,eAAe,EAAE,OAAO,CAAC,cAAc,IAAI,KAAK;SACjD,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,OAAqB;QAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,qBAAqB,EAAE;YAChD,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,gBAAgB,EAAE,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC;YAChD,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,MAAM;YACpC,aAAa,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI;YAC1C,eAAe,EAAE,OAAO,CAAC,cAAc,IAAI,KAAK;SACjD,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAsB;QACjC,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,sBAAsB,EAAE;YACjD,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,QAAQ,EAAE,OAAO,CAAC,WAAW;YAC7B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,MAAM;YACpC,eAAe,EAAE,OAAO,CAAC,cAAc,IAAI,KAAK;SACjD,CAAC,CAAC;IACL,CAAC;CACF"}
1
+ {"version":3,"file":"voice.js","sourceRoot":"","sources":["../src/voice.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,181 @@
1
+ export declare function deriveWorkspacesApiBase(agentsApiBase?: string): string;
2
+ export interface Workspace {
3
+ id: string;
4
+ name: string;
5
+ slug: string;
6
+ description: string | null;
7
+ displayName: string | null;
8
+ displaySlug: string | null;
9
+ role: string | null;
10
+ createdAt: string | null;
11
+ updatedAt: string | null;
12
+ }
13
+ export interface WorkspaceAgentAssociation {
14
+ workspaceId: string;
15
+ agentId: string;
16
+ role: string;
17
+ expiresAt: string | null;
18
+ }
19
+ export interface WorkspaceGrant {
20
+ id: string;
21
+ workspaceId: string;
22
+ subjectType: string;
23
+ subjectId: string;
24
+ role: string;
25
+ displayName: string | null;
26
+ displaySlug: string | null;
27
+ isOwner: boolean;
28
+ expiresAt: string | null;
29
+ revokedAt: string | null;
30
+ }
31
+ export type WorkspaceAccessVisibility = 'all-direct-access' | 'current-access-only';
32
+ export interface WorkspaceAccessEntry {
33
+ workspaceId: string;
34
+ subjectType: string;
35
+ subjectId: string;
36
+ role: string;
37
+ displayName: string | null;
38
+ displaySlug: string | null;
39
+ grants: WorkspaceGrant[];
40
+ }
41
+ export interface WorkspaceAccessSnapshot {
42
+ workspace: Workspace;
43
+ currentRole: string | null;
44
+ visibility: WorkspaceAccessVisibility;
45
+ capturedAt: string;
46
+ entries: WorkspaceAccessEntry[] | null;
47
+ grants: WorkspaceGrant[] | null;
48
+ }
49
+ export interface WorkspaceFile {
50
+ id: string;
51
+ workspaceId: string;
52
+ path: string;
53
+ displayName: string;
54
+ currentVersionId: string | null;
55
+ fileState: string;
56
+ uploadStatus: string | null;
57
+ processingState: string | null;
58
+ keywords: string[];
59
+ summary: string | null;
60
+ }
61
+ export interface WorkspaceFileSearchResult extends WorkspaceFile {
62
+ matchReasons: string[];
63
+ keywordScore: number;
64
+ vectorScore: number | null;
65
+ score: number;
66
+ }
67
+ export interface WorkspaceManifest {
68
+ workspaceId: string;
69
+ workspaceName: string;
70
+ workspaceSlug: string;
71
+ snapshotId: string;
72
+ basePath: string;
73
+ markdownFiles: Array<Record<string, any>>;
74
+ }
75
+ export interface WorkspaceDownloadUrl {
76
+ fileId: string;
77
+ path: string;
78
+ version: number;
79
+ url: string | null;
80
+ downloadCommand: string;
81
+ }
82
+ export interface WorkspaceFileBytes {
83
+ content: Uint8Array;
84
+ path: string;
85
+ name: string;
86
+ }
87
+ export interface WorkspaceSubjectOptions {
88
+ /** @deprecated Workspaces identity is resolved from the bearer credential. */
89
+ userId?: string;
90
+ /** @deprecated Workspaces identity is resolved from the bearer credential. */
91
+ agentId?: string;
92
+ }
93
+ export declare class WorkspacesAPI {
94
+ private apiBase;
95
+ private apiKey;
96
+ private timeout;
97
+ private uploadTimeout;
98
+ constructor(apiKey: string, options?: {
99
+ apiBase?: string;
100
+ agentsApiBase?: string;
101
+ timeout?: number;
102
+ uploadTimeout?: number;
103
+ });
104
+ private headers;
105
+ private authHeaders;
106
+ private request;
107
+ list(subject?: WorkspaceSubjectOptions): Promise<Workspace[]>;
108
+ get(workspaceRef: string, subject?: WorkspaceSubjectOptions): Promise<Workspace>;
109
+ accessSnapshot(workspaceRef: string, subject?: WorkspaceSubjectOptions): Promise<WorkspaceAccessSnapshot>;
110
+ /** @deprecated Compatibility projection. Use accessSnapshot() for grant-level access details. */
111
+ listAgents(workspaceRef: string, subject?: WorkspaceSubjectOptions): Promise<WorkspaceAgentAssociation[]>;
112
+ search(query: string, subject?: WorkspaceSubjectOptions, options?: {
113
+ vector?: boolean;
114
+ }): Promise<Workspace[]>;
115
+ create(body: {
116
+ name: string;
117
+ slug?: string;
118
+ description?: string;
119
+ }, subject?: WorkspaceSubjectOptions): Promise<Workspace>;
120
+ update(workspaceRef: string, body: {
121
+ name?: string;
122
+ slug?: string;
123
+ description?: string;
124
+ }, subject?: WorkspaceSubjectOptions): Promise<Workspace>;
125
+ delete(workspaceRef: string, subject?: WorkspaceSubjectOptions): Promise<void>;
126
+ grant(workspaceRef: string, body: {
127
+ subjectType: 'user' | 'agent';
128
+ subjectId: string;
129
+ role?: 'viewer' | 'contributor' | 'admin';
130
+ displayName?: string;
131
+ displaySlug?: string;
132
+ expiresAt?: string | null;
133
+ }, subject?: WorkspaceSubjectOptions): Promise<WorkspaceGrant>;
134
+ listGrants(workspaceRef: string, subject?: WorkspaceSubjectOptions): Promise<WorkspaceGrant[]>;
135
+ updateGrant(workspaceRef: string, grantId: string, body: {
136
+ role?: 'viewer' | 'contributor' | 'admin';
137
+ expiresAt?: string | null;
138
+ }, subject?: WorkspaceSubjectOptions): Promise<WorkspaceGrant>;
139
+ revokeGrant(workspaceRef: string, grantId: string, subject?: WorkspaceSubjectOptions): Promise<void>;
140
+ registerFile(workspaceRef: string, body: {
141
+ path: string;
142
+ sourceFilename?: string;
143
+ sourceContentType?: string;
144
+ sourceSizeBytes?: number;
145
+ sourceSha256?: string;
146
+ sourceEtag?: string;
147
+ keywords?: string[];
148
+ }, subject?: WorkspaceSubjectOptions): Promise<WorkspaceFile>;
149
+ uploadFile(workspaceRef: string, file: Blob, options?: {
150
+ path?: string;
151
+ filename?: string;
152
+ sourceEtag?: string;
153
+ }, subject?: WorkspaceSubjectOptions): Promise<WorkspaceFile>;
154
+ getFile(workspaceRef: string, fileRef: string, subject?: WorkspaceSubjectOptions): Promise<WorkspaceFile>;
155
+ updateFile(workspaceRef: string, fileRef: string, body: {
156
+ displayName?: string;
157
+ keywords?: string[];
158
+ summary?: string | null;
159
+ }, subject?: WorkspaceSubjectOptions): Promise<WorkspaceFile>;
160
+ regenerateFile(workspaceRef: string, fileRef: string, subject?: WorkspaceSubjectOptions): Promise<WorkspaceFile>;
161
+ waitUntilProcessed(workspaceRef: string, fileRef: string, subject?: WorkspaceSubjectOptions, options?: {
162
+ timeoutMs?: number;
163
+ pollIntervalMs?: number;
164
+ }): Promise<WorkspaceFile>;
165
+ listFiles(workspaceRef: string, subject?: WorkspaceSubjectOptions): Promise<WorkspaceFile[]>;
166
+ searchFiles(workspaceRef: string, query: string, subject?: WorkspaceSubjectOptions, options?: {
167
+ vector?: boolean;
168
+ }): Promise<WorkspaceFileSearchResult[]>;
169
+ manifest(workspaceRef: string, subject?: WorkspaceSubjectOptions): Promise<WorkspaceManifest>;
170
+ downloadUrl(workspaceRef: string, fileRef: string, subject?: WorkspaceSubjectOptions): Promise<WorkspaceDownloadUrl>;
171
+ downloadFileBytes(workspaceRef: string, fileRef: string, subject?: WorkspaceSubjectOptions, options?: {
172
+ raw?: boolean;
173
+ index?: number;
174
+ }): Promise<WorkspaceFileBytes>;
175
+ deleteFile(workspaceRef: string, fileRef: string, subject?: WorkspaceSubjectOptions): Promise<void>;
176
+ markdownFile(workspaceRef: string, fileRef: string, subject?: WorkspaceSubjectOptions): Promise<{
177
+ markdownFile: Record<string, any>;
178
+ markdown: string;
179
+ }>;
180
+ }
181
+ //# sourceMappingURL=workspaces.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workspaces.d.ts","sourceRoot":"","sources":["../src/workspaces.ts"],"names":[],"mappings":"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"}