@kmlckj/aios-agent-server-sdk 0.0.0-stage → 0.0.1

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 (134) hide show
  1. package/EVENTS.md +88 -0
  2. package/README.md +628 -2
  3. package/capabilities.json +2398 -0
  4. package/dist/cli/daemon/preferences.d.ts +67 -0
  5. package/dist/cli/daemon/protocol.d.ts +26 -0
  6. package/dist/cli/daemon/resource-limits.d.ts +39 -0
  7. package/dist/core/auth/platform-client.d.ts +59 -0
  8. package/dist/core/host/runtime-dependencies.d.ts +26 -0
  9. package/dist/core/skills/skill-bindings.d.ts +19 -0
  10. package/dist/core/skills/skill-versions.d.ts +31 -0
  11. package/dist/electron/main/bundled-runtime-tools.d.ts +24 -0
  12. package/dist/events.js +1 -0
  13. package/dist/index.js +55 -0
  14. package/dist/sdk/src/auth.d.ts +43 -0
  15. package/dist/sdk/src/authorization-events.d.ts +16 -0
  16. package/dist/sdk/src/authorization.d.ts +10 -0
  17. package/dist/sdk/src/communication.d.ts +9 -0
  18. package/dist/sdk/src/diagnostics.d.ts +24 -0
  19. package/dist/sdk/src/errors.d.ts +4 -0
  20. package/dist/sdk/src/events.d.ts +4 -0
  21. package/dist/sdk/src/file-api.d.ts +29 -0
  22. package/dist/sdk/src/file-storage.d.ts +34 -0
  23. package/dist/sdk/src/index.d.ts +257 -0
  24. package/dist/sdk/src/local-connection.d.ts +9 -0
  25. package/dist/sdk/src/managed-host.d.ts +32 -0
  26. package/dist/sdk/src/native-status.d.ts +59 -0
  27. package/dist/sdk/src/platform.d.ts +35 -0
  28. package/dist/sdk/src/runtime-control.d.ts +111 -0
  29. package/dist/sdk/src/runtime-integrity.d.ts +10 -0
  30. package/dist/sdk/src/tool-reference.d.ts +11 -0
  31. package/dist/sdk/src/tool-result.d.ts +36 -0
  32. package/dist/sdk/src/tool-server.d.ts +14 -0
  33. package/dist/sdk/src/transport.d.ts +25 -0
  34. package/dist/sdk/src/types.d.ts +492 -0
  35. package/dist/shared/account-context-api.d.ts +47 -0
  36. package/dist/shared/action-center-api.d.ts +50 -0
  37. package/dist/shared/agent-capabilities.d.ts +42 -0
  38. package/dist/shared/agent-hooks.d.ts +10 -0
  39. package/dist/shared/agent-team.d.ts +17 -0
  40. package/dist/shared/artifact-evidence.d.ts +18 -0
  41. package/dist/shared/automation-api.d.ts +112 -0
  42. package/dist/shared/client-downloads-api.d.ts +20 -0
  43. package/dist/shared/cloud-assistant-api.d.ts +1020 -0
  44. package/dist/shared/cloud-task-event-api.d.ts +22 -0
  45. package/dist/shared/collaboration-api.d.ts +16 -0
  46. package/dist/shared/collaboration-automation-api.d.ts +55 -0
  47. package/dist/shared/collaboration-deep-link.d.ts +18 -0
  48. package/dist/shared/collaboration-event-api.d.ts +19 -0
  49. package/dist/shared/collaboration-plan-api.d.ts +159 -0
  50. package/dist/shared/collaboration-project-api.d.ts +206 -0
  51. package/dist/shared/collaboration-resource-api.d.ts +41 -0
  52. package/dist/shared/collaboration-task-api.d.ts +372 -0
  53. package/dist/shared/computer-use-api.d.ts +80 -0
  54. package/dist/shared/computer-use-handshake.d.ts +19 -0
  55. package/dist/shared/computer-use-protocol.d.ts +488 -0
  56. package/dist/shared/context-usage.d.ts +15 -0
  57. package/dist/shared/desktop-api.d.ts +449 -0
  58. package/dist/shared/desktop-diagnostics-api.d.ts +56 -0
  59. package/dist/shared/desktop-language.d.ts +3 -0
  60. package/dist/shared/desktop-mcp-service-api.d.ts +157 -0
  61. package/dist/shared/document-session-api.d.ts +91 -0
  62. package/dist/shared/enterprise-knowledge-api.d.ts +103 -0
  63. package/dist/shared/enterprise-project-api.d.ts +26 -0
  64. package/dist/shared/execution-activity.d.ts +3 -0
  65. package/dist/shared/execution-context.d.ts +37 -0
  66. package/dist/shared/execution-identity.d.ts +7 -0
  67. package/dist/shared/execution-profile.d.ts +6 -0
  68. package/dist/shared/execution-target.d.ts +71 -0
  69. package/dist/shared/expert-team-api.d.ts +54 -0
  70. package/dist/shared/feedback-api.d.ts +20 -0
  71. package/dist/shared/git-api.d.ts +227 -0
  72. package/dist/shared/git-http-api.d.ts +12 -0
  73. package/dist/shared/hosted-git-api.d.ts +132 -0
  74. package/dist/shared/js-agent-hooks.d.ts +23 -0
  75. package/dist/shared/local-custom-model-api.d.ts +55 -0
  76. package/dist/shared/local-environment-api.d.ts +110 -0
  77. package/dist/shared/local-mcp-server-api.d.ts +91 -0
  78. package/dist/shared/local-memory.d.ts +165 -0
  79. package/dist/shared/local-plugin-api.d.ts +26 -0
  80. package/dist/shared/local-runtime-api.d.ts +32 -0
  81. package/dist/shared/local-skill-api.d.ts +42 -0
  82. package/dist/shared/local-task-api.d.ts +658 -0
  83. package/dist/shared/local-task-command-client.d.ts +55 -0
  84. package/dist/shared/local-task-command.d.ts +91 -0
  85. package/dist/shared/local-task-event-projection.d.ts +29 -0
  86. package/dist/shared/local-task-projection.d.ts +29 -0
  87. package/dist/shared/local-workspace.d.ts +9 -0
  88. package/dist/shared/managed-authorization.d.ts +70 -0
  89. package/dist/shared/memory-customization.d.ts +32 -0
  90. package/dist/shared/model-routing.d.ts +31 -0
  91. package/dist/shared/model-selection.d.ts +11 -0
  92. package/dist/shared/my-expert-api.d.ts +119 -0
  93. package/dist/shared/navigation-api.d.ts +20 -0
  94. package/dist/shared/office-window-api.d.ts +81 -0
  95. package/dist/shared/platform-branding-api.d.ts +66 -0
  96. package/dist/shared/plugin-market-api.d.ts +120 -0
  97. package/dist/shared/profession-market-api.d.ts +96 -0
  98. package/dist/shared/project-local-skill-api.d.ts +8 -0
  99. package/dist/shared/remote-connection-api.d.ts +97 -0
  100. package/dist/shared/remote-connection.d.ts +62 -0
  101. package/dist/shared/remote-installation-api.d.ts +50 -0
  102. package/dist/shared/remote-tasks-api.d.ts +118 -0
  103. package/dist/shared/runtime-tuning.d.ts +44 -0
  104. package/dist/shared/scene-case-api.d.ts +42 -0
  105. package/dist/shared/security-center-api.d.ts +74 -0
  106. package/dist/shared/sensitive-protection-api.d.ts +71 -0
  107. package/dist/shared/session-policy.d.ts +26 -0
  108. package/dist/shared/shortcut-api.d.ts +7 -0
  109. package/dist/shared/skill-activation-api.d.ts +8 -0
  110. package/dist/shared/skill-asset-api.d.ts +12 -0
  111. package/dist/shared/skill-market-api.d.ts +119 -0
  112. package/dist/shared/skill-upload.d.ts +16 -0
  113. package/dist/shared/speech-recognition-api.d.ts +12 -0
  114. package/dist/shared/storage-integrity.d.ts +15 -0
  115. package/dist/shared/target-bridge-protocol.d.ts +67 -0
  116. package/dist/shared/target-environments.d.ts +15 -0
  117. package/dist/shared/target-resources.d.ts +105 -0
  118. package/dist/shared/task-initialization-api.d.ts +44 -0
  119. package/dist/shared/task-menu-api.d.ts +27 -0
  120. package/dist/shared/task-operation.d.ts +19 -0
  121. package/dist/shared/task-path-policy.d.ts +14 -0
  122. package/dist/shared/task-resource-manifest.d.ts +33 -0
  123. package/dist/shared/task-storage-recovery.d.ts +33 -0
  124. package/dist/shared/task-terminal-api.d.ts +48 -0
  125. package/dist/shared/team-control.d.ts +60 -0
  126. package/dist/shared/tool-activity.d.ts +18 -0
  127. package/dist/shared/update-api.d.ts +65 -0
  128. package/dist/shared/usage-statistics-api.d.ts +18 -0
  129. package/dist/shared/worktree-api.d.ts +188 -0
  130. package/examples/business-assistant.mjs +19 -0
  131. package/examples/common.mjs +51 -0
  132. package/examples/platform-assistant.mjs +9 -0
  133. package/examples/standalone-assistant.mjs +16 -0
  134. package/package.json +20 -4
@@ -0,0 +1,1020 @@
1
+ import type { ModelReasoningEffort, ModelReasoningConfig } from './model-selection.js';
2
+ import type { ContextUsageSnapshot } from './context-usage.js';
3
+ import type { EnterpriseProjectCapabilityPage, EnterpriseProjectSearchRequest } from './enterprise-project-api.js';
4
+ export type AssistantHubItemType = 'AGENT' | 'PROJECT';
5
+ export type PersonalAgentRuntimeLocation = 'PLATFORM' | 'LOCAL';
6
+ export interface AssistantHubItem {
7
+ type: AssistantHubItemType;
8
+ id: string;
9
+ key: string;
10
+ name: string;
11
+ description: string | null;
12
+ avatarUrl: string | null;
13
+ status: string | null;
14
+ pinned: boolean;
15
+ sortOrder: number;
16
+ lastPreview: string | null;
17
+ lastAt: string | null;
18
+ hasUnread: boolean;
19
+ unreadCount: number;
20
+ online: boolean;
21
+ }
22
+ export interface AssistantHubList {
23
+ items: AssistantHubItem[];
24
+ total: number;
25
+ }
26
+ export interface PersonalAgentProfile {
27
+ id: string;
28
+ ownerUserId: string;
29
+ profileKey: string;
30
+ name: string;
31
+ description: string | null;
32
+ avatarUrl: string | null;
33
+ runtimeLocation: PersonalAgentRuntimeLocation;
34
+ runtimeProvider: string;
35
+ bridgeClientId: string | null;
36
+ bridgeConnected: boolean;
37
+ professionId: string | null;
38
+ professionName: string | null;
39
+ isDefault: boolean;
40
+ pinned: boolean;
41
+ status: string;
42
+ sortOrder: number;
43
+ lastReplyPreview: string | null;
44
+ lastReplyAt: string | null;
45
+ hasUnread: boolean;
46
+ unreadCount: number;
47
+ createdAt: string | null;
48
+ updatedAt: string | null;
49
+ }
50
+ export interface PersonalAgentList {
51
+ items: PersonalAgentProfile[];
52
+ total: number;
53
+ }
54
+ export interface PersonalAgentSkill {
55
+ id: string;
56
+ profileKey: string;
57
+ skillId: string;
58
+ tenantId?: string | null;
59
+ sourceType: string;
60
+ sourcePath: string | null;
61
+ enabled: boolean;
62
+ sortOrder: number;
63
+ name: string;
64
+ description: string | null;
65
+ iconUrl: string | null;
66
+ mySkillEnabled: boolean;
67
+ }
68
+ export type PersonalAgentPluginSource = 'PLATFORM' | 'ENTERPRISE';
69
+ export interface PersonalAgentPluginTool {
70
+ toolId: string;
71
+ name: string;
72
+ functionName: string;
73
+ description: string;
74
+ inputSchema: Record<string, unknown>;
75
+ }
76
+ export interface PersonalAgentPlugin {
77
+ publishRecordId: string;
78
+ pluginId: string;
79
+ name: string;
80
+ description: string;
81
+ iconUrl: string | null;
82
+ source: PersonalAgentPluginSource;
83
+ resourceVersion: string;
84
+ enabled: boolean;
85
+ tools: PersonalAgentPluginTool[];
86
+ }
87
+ export interface PersonalAgentPluginConfig {
88
+ version: number;
89
+ plugins: PersonalAgentPlugin[];
90
+ }
91
+ export interface AvailablePersonalSkill {
92
+ skillId: string;
93
+ tenantId: string | null;
94
+ name: string;
95
+ description: string | null;
96
+ iconUrl: string | null;
97
+ sourceType: 'MY' | 'ENTERPRISE' | 'PLATFORM';
98
+ sourceLabel: string;
99
+ categoryCode: string | null;
100
+ enabled: boolean;
101
+ }
102
+ export interface AvailablePersonalSkillCategory {
103
+ code: string;
104
+ name: string;
105
+ }
106
+ export interface AvailablePersonalSkillQuery {
107
+ source?: AvailablePersonalSkill['sourceType'];
108
+ keyword?: string;
109
+ categoryCode?: string;
110
+ pageSize?: number;
111
+ }
112
+ export interface AddPersonalAgentSkillRequest {
113
+ skillId: string;
114
+ tenantId?: string;
115
+ sourceType: AvailablePersonalSkill['sourceType'];
116
+ name: string;
117
+ description?: string;
118
+ iconUrl?: string;
119
+ }
120
+ export interface PersonalAgentMessageChannel {
121
+ id: string;
122
+ profileKey: string;
123
+ channel: string;
124
+ displayName: string;
125
+ enabled: boolean;
126
+ status: string;
127
+ revision: number;
128
+ }
129
+ export interface PersonalAgentChannelAuthorization {
130
+ sessionId: string;
131
+ accountId: string;
132
+ status: string;
133
+ phase: string;
134
+ qrUrl: string | null;
135
+ qrPayload: string | null;
136
+ message: string | null;
137
+ }
138
+ export interface UpdatePersonalAgentRequest {
139
+ profileKey: string;
140
+ name?: string;
141
+ description?: string;
142
+ pinned?: boolean;
143
+ runtimeProvider?: string;
144
+ }
145
+ export interface ProfessionCategory {
146
+ code: string;
147
+ name: string;
148
+ description: string | null;
149
+ iconUrl: string | null;
150
+ count: number;
151
+ }
152
+ export interface ProfessionTemplate {
153
+ id: string;
154
+ name: string;
155
+ summary: string | null;
156
+ iconUrl: string | null;
157
+ categoryCode: string | null;
158
+ categoryName: string | null;
159
+ }
160
+ export interface ProfessionSearchResult {
161
+ items: ProfessionTemplate[];
162
+ total: number;
163
+ page: number;
164
+ pageSize: number;
165
+ hasNext: boolean;
166
+ }
167
+ export interface ProfessionSearchQuery {
168
+ keyword?: string;
169
+ categoryCode?: string;
170
+ page?: number;
171
+ pageSize?: number;
172
+ }
173
+ export interface CreateCloudAgentRequest {
174
+ name: string;
175
+ description: string;
176
+ professionId: string;
177
+ runtimeLocation: 'PLATFORM';
178
+ runtimeProvider: string;
179
+ }
180
+ export interface CreateLocalAgentPairingRequest {
181
+ profileKey?: string;
182
+ name: string;
183
+ description: string;
184
+ }
185
+ export interface LocalAgentPairing {
186
+ pairingId: string;
187
+ profileKey: string | null;
188
+ profile: PersonalAgentProfile | null;
189
+ pairCode: string | null;
190
+ patToken?: string | null;
191
+ command: string | null;
192
+ handshakeUrl?: string | null;
193
+ status: string;
194
+ expiresAt: string;
195
+ expiresInSeconds: number | null;
196
+ connectedAt: string | null;
197
+ lastSeenAt: string | null;
198
+ runtimeProvider: string | null;
199
+ deviceName: string | null;
200
+ bridgeClientId?: string | null;
201
+ }
202
+ export interface CollaborationProject {
203
+ id: string;
204
+ ownerUserId: string;
205
+ name: string;
206
+ description: string | null;
207
+ status: string;
208
+ pinned: boolean;
209
+ sortOrder: number;
210
+ agentCount: number;
211
+ memberCount: number;
212
+ viewerRole: CollaborationMemberRole;
213
+ lastMessagePreview: string | null;
214
+ lastMessageAt: string | null;
215
+ createdAt: string | null;
216
+ updatedAt: string | null;
217
+ }
218
+ export interface CollaborationProjectList {
219
+ items: CollaborationProject[];
220
+ total: number;
221
+ }
222
+ export type CollaborationMemberRole = 'OWNER' | 'ADMIN' | 'MEMBER' | 'VIEWER' | string;
223
+ export interface CollaborationMember {
224
+ id: string;
225
+ projectId: string;
226
+ userId: string;
227
+ displayName: string | null;
228
+ username: string | null;
229
+ avatarUrl: string | null;
230
+ role: CollaborationMemberRole;
231
+ pinned: boolean;
232
+ sortOrder: number;
233
+ createdAt: string | null;
234
+ updatedAt: string | null;
235
+ }
236
+ export interface CollaborationAgent {
237
+ id: string;
238
+ projectId: string;
239
+ ownerUserId: string;
240
+ profileKey: string;
241
+ displayName: string | null;
242
+ avatarUrl: string | null;
243
+ agentKind: string | null;
244
+ enabled: boolean;
245
+ sortOrder: number;
246
+ createdAt: string | null;
247
+ updatedAt: string | null;
248
+ }
249
+ export interface CollaborationAgentSkill {
250
+ tenantId?: string | null;
251
+ bindingId: string;
252
+ projectId: string;
253
+ agentId: string;
254
+ agentName: string | null;
255
+ agentAvatarUrl: string | null;
256
+ ownerUserId: string;
257
+ profileKey: string;
258
+ skillId: string;
259
+ sourceType: string;
260
+ sourcePath: string | null;
261
+ enabled: boolean;
262
+ sortOrder: number;
263
+ name: string;
264
+ description: string | null;
265
+ iconUrl: string | null;
266
+ mySkillEnabled: boolean;
267
+ }
268
+ export type CollaborationSenderType = 'USER' | 'AGENT' | 'SYSTEM' | 'TOOL' | string;
269
+ export interface CollaborationMessage {
270
+ id: string;
271
+ projectId: string;
272
+ sessionId: string;
273
+ turnId: string | null;
274
+ senderType: CollaborationSenderType;
275
+ senderUserId: string | null;
276
+ senderProfileKey: string | null;
277
+ senderName: string | null;
278
+ senderAvatarUrl: string | null;
279
+ content: string;
280
+ status: string;
281
+ createdAt: string;
282
+ updatedAt: string | null;
283
+ richContent?: CloudChatRichContent;
284
+ attachments?: CloudChatAttachment[];
285
+ skillReferences?: CloudChatSkillReference[];
286
+ conversationReference?: CloudChatConversationReference;
287
+ }
288
+ export interface CollaborationMessageList {
289
+ items: CollaborationMessage[];
290
+ total: number;
291
+ }
292
+ export interface CollaborationTurn {
293
+ id: string;
294
+ profileKey: string;
295
+ turnId: string;
296
+ sourceSessionId: string | null;
297
+ status: string;
298
+ errorMessage: string | null;
299
+ startedAt: string | null;
300
+ finishedAt: string | null;
301
+ createdAt: string | null;
302
+ }
303
+ export interface CollaborationTurnList {
304
+ items: CollaborationTurn[];
305
+ total: number;
306
+ }
307
+ export interface UpdateCollaborationProjectRequest {
308
+ projectId: string;
309
+ name?: string;
310
+ description?: string;
311
+ status?: string;
312
+ }
313
+ export interface UpdateProjectPinRequest {
314
+ projectId: string;
315
+ pinned: boolean;
316
+ }
317
+ export interface UpdateCollaborationAgentRequest {
318
+ projectId: string;
319
+ agentId: string;
320
+ displayName?: string;
321
+ enabled?: boolean;
322
+ sortOrder?: number;
323
+ }
324
+ export interface AddCollaborationAgentRequest {
325
+ projectId: string;
326
+ ownerUserId: string;
327
+ profileKey: string;
328
+ displayName: string;
329
+ agentKind: 'cloud_personal_agent' | 'local_agent';
330
+ sortOrder: number;
331
+ }
332
+ export interface RemoveCollaborationAgentRequest {
333
+ projectId: string;
334
+ agentId: string;
335
+ }
336
+ export interface ProjectMessageQuery {
337
+ projectId: string;
338
+ sessionId?: string;
339
+ limit?: number;
340
+ offset?: number;
341
+ }
342
+ export interface ProjectSendMessageRequest {
343
+ projectId: string;
344
+ sessionId: string;
345
+ content: string;
346
+ model?: string;
347
+ thinkingEnabled?: boolean;
348
+ reasoningEffort?: ModelReasoningEffort;
349
+ attachments?: CloudUploadedAttachment[];
350
+ references?: CloudMessageReference[];
351
+ richContent?: CloudChatRichContent;
352
+ }
353
+ export interface ProjectCancelTurnRequest {
354
+ projectId: string;
355
+ turnId: string;
356
+ }
357
+ export type CloudFileSource = 'agent' | 'project';
358
+ export interface CloudFileListQuery {
359
+ directory?: string;
360
+ keyword?: string;
361
+ }
362
+ export interface CloudFileEntry {
363
+ id: string;
364
+ source: CloudFileSource;
365
+ name: string;
366
+ path: string;
367
+ directory: boolean;
368
+ sizeBytes: number;
369
+ mediaType: string | null;
370
+ createdAt: string | null;
371
+ updatedAt?: string | null;
372
+ createdBy?: string | null;
373
+ updatedBy?: string | null;
374
+ children?: CloudFileEntry[];
375
+ }
376
+ export interface CloudFileList {
377
+ items: CloudFileEntry[];
378
+ total: number;
379
+ usedBytes: number | null;
380
+ totalBytes: number | null;
381
+ }
382
+ export type CloudFileTarget = {
383
+ source: 'agent';
384
+ profileKey: string;
385
+ path: string;
386
+ } | {
387
+ source: 'project';
388
+ projectId: string;
389
+ artifactId: string;
390
+ };
391
+ export type CloudFileContainer = {
392
+ source: 'agent';
393
+ profileKey: string;
394
+ directory: string;
395
+ } | {
396
+ source: 'project';
397
+ projectId: string;
398
+ directory: string;
399
+ };
400
+ export interface UploadCloudFileRequest {
401
+ container: CloudFileContainer;
402
+ fileName: string;
403
+ mediaType: string;
404
+ data: ArrayBuffer;
405
+ }
406
+ export interface CreateCloudDirectoryRequest {
407
+ container: CloudFileContainer;
408
+ name: string;
409
+ }
410
+ export interface RenameCloudFileRequest {
411
+ target: CloudFileTarget;
412
+ directory: boolean;
413
+ currentPath: string;
414
+ newName: string;
415
+ }
416
+ export interface SaveCloudFileRequest {
417
+ target: CloudFileTarget;
418
+ fileName: string;
419
+ mediaType: string;
420
+ data: ArrayBuffer;
421
+ }
422
+ export type CloudFileDataSource = CloudFileTarget | {
423
+ source: 'url';
424
+ url: string;
425
+ };
426
+ export interface CloudFileContent {
427
+ mediaType: string;
428
+ text: string | null;
429
+ dataUrl: string | null;
430
+ truncated: boolean;
431
+ }
432
+ export interface DownloadCloudFileRequest {
433
+ target: CloudFileDataSource;
434
+ fileName: string;
435
+ }
436
+ export type ScheduleTriggerType = 'ONCE' | 'DAILY' | 'CRON';
437
+ export interface WorkbenchSchedule {
438
+ scheduleId: string;
439
+ userId: string;
440
+ profileKey: string;
441
+ content: string;
442
+ triggerType: ScheduleTriggerType;
443
+ triggerAt: string;
444
+ timezone: string;
445
+ enabled: boolean;
446
+ createdAt: string | null;
447
+ updatedAt: string | null;
448
+ }
449
+ export interface WorkbenchScheduleRun {
450
+ runId: string;
451
+ scheduleId: string;
452
+ profileKey: string;
453
+ plannedTriggerAt: string;
454
+ triggerKey: string;
455
+ status: string;
456
+ resultContent: string | null;
457
+ errorMessage: string | null;
458
+ startedAt: string | null;
459
+ finishedAt: string | null;
460
+ createdAt: string | null;
461
+ }
462
+ export interface SaveScheduleRequest {
463
+ scheduleId?: string;
464
+ profileKey: string;
465
+ content: string;
466
+ triggerType: ScheduleTriggerType;
467
+ triggerAt: string;
468
+ timezone: string;
469
+ enabled: boolean;
470
+ }
471
+ export type ScheduleQueryScope = {
472
+ profileKey: string;
473
+ allProfiles?: never;
474
+ } | {
475
+ allProfiles: true;
476
+ profileKey?: never;
477
+ };
478
+ export type ScheduleListQuery = ScheduleQueryScope & {
479
+ enabled?: boolean;
480
+ limit?: number;
481
+ offset?: number;
482
+ };
483
+ export type ScheduleRunQuery = ScheduleQueryScope & {
484
+ from: string;
485
+ before: string;
486
+ limit?: number;
487
+ offset?: number;
488
+ };
489
+ export interface HistorySearchItem {
490
+ sessionId: string;
491
+ sessionTitle: string | null;
492
+ isMain: boolean;
493
+ preview: string;
494
+ message: CloudChatMessage;
495
+ }
496
+ export interface HistorySearchRequest {
497
+ profileKey: string;
498
+ keyword: string;
499
+ limit?: number;
500
+ offset?: number;
501
+ }
502
+ export interface HistoryAroundRequest {
503
+ profileKey: string;
504
+ messageId: string;
505
+ before?: number;
506
+ after?: number;
507
+ }
508
+ export interface CreateChatShareRequest {
509
+ sourceType: 'PERSONAL_AGENT' | 'COLLABORATION_PROJECT';
510
+ profileKey?: string;
511
+ projectId?: string;
512
+ sessionId: string;
513
+ messageIds: string[];
514
+ allowFileAccess: boolean;
515
+ }
516
+ export interface ChatShare {
517
+ shareId: string;
518
+ shareUrl: string;
519
+ title: string;
520
+ allowFileAccess: boolean;
521
+ messageCount: number;
522
+ createdAt: string | null;
523
+ }
524
+ export interface CreateProjectAgentRequest {
525
+ ownerUserId: string;
526
+ profileKey: string;
527
+ displayName: string;
528
+ agentKind: 'cloud_personal_agent' | 'local_agent';
529
+ sortOrder: number;
530
+ }
531
+ export interface CreateCollaborationProjectRequest {
532
+ name: string;
533
+ description?: string;
534
+ agents: CreateProjectAgentRequest[];
535
+ idempotencyKey?: string;
536
+ }
537
+ export type CloudAssistantSelection = {
538
+ type: 'agent';
539
+ profileKey: string;
540
+ } | {
541
+ type: 'project';
542
+ projectId: string;
543
+ };
544
+ export type CloudChatRole = 'system' | 'user' | 'assistant' | 'tool';
545
+ export type CloudChatMessageStatus = 'complete' | 'streaming' | 'failed';
546
+ export type CloudChatRichTokenType = 'agent' | 'member' | 'skill' | 'enterprise_project' | 'collection' | 'attachment';
547
+ export type CloudChatRichSegment = {
548
+ type: 'text';
549
+ text: string;
550
+ } | {
551
+ type: CloudChatRichTokenType;
552
+ id: string;
553
+ name: string;
554
+ avatarUrl?: string | null;
555
+ source?: string | null;
556
+ tenantId?: string | null;
557
+ profileKey?: string | null;
558
+ agentId?: string | null;
559
+ ownerUserId?: string | null;
560
+ previewUrl?: string | null;
561
+ downloadUrl?: string | null;
562
+ mediaType?: string | null;
563
+ sizeBytes?: number | null;
564
+ reference?: Record<string, unknown> | null;
565
+ };
566
+ export interface CloudChatRichContent {
567
+ version: 1;
568
+ segments: CloudChatRichSegment[];
569
+ }
570
+ export type CloudMessageReference = {
571
+ type: 'conversation';
572
+ message_ids: string[];
573
+ } | {
574
+ type: 'platform_skill';
575
+ skill_id: string;
576
+ tenant_id?: string;
577
+ } | {
578
+ type: 'system_skill';
579
+ skill_id: string;
580
+ } | {
581
+ type: 'local_skill';
582
+ path: string;
583
+ } | {
584
+ type: 'remote_file';
585
+ url: string;
586
+ name: string;
587
+ mime_type?: string;
588
+ size?: number;
589
+ source: 'enterprise_knowledge';
590
+ knowledge_base_id: string;
591
+ document_id: string;
592
+ } | {
593
+ type: 'url';
594
+ url: string;
595
+ };
596
+ export interface CloudCollectionItem {
597
+ id: string;
598
+ title: string;
599
+ type: 'link' | 'image' | 'text' | 'pdf' | 'file';
600
+ source: string;
601
+ sourceUrl: string | null;
602
+ summary: string;
603
+ sizeLabel: string | null;
604
+ previewUrl: string | null;
605
+ }
606
+ export interface CloudCollectionList {
607
+ items: CloudCollectionItem[];
608
+ }
609
+ export interface CreateCloudFileCollectionRequest {
610
+ fileName: string;
611
+ mediaType: string;
612
+ sourcePath: string;
613
+ data: ArrayBuffer;
614
+ }
615
+ export interface AvailableChatModel {
616
+ reasoningConfig?: ModelReasoningConfig | null;
617
+ modelId: string;
618
+ modelCode: string;
619
+ displayName: string;
620
+ avatarUrl: string | null;
621
+ providerCode: string | null;
622
+ description: string | null;
623
+ categoryCode: string | null;
624
+ categoryName: string | null;
625
+ capabilityCode: string | null;
626
+ callMode: string | null;
627
+ async: boolean;
628
+ requiredHeaders: string[];
629
+ tagText: string | null;
630
+ tagNameText: string | null;
631
+ sourceTagCode: string | null;
632
+ sourceTagName: string | null;
633
+ sourceTagColor: string | null;
634
+ tools: string | null;
635
+ inputCapabilities: string | null;
636
+ outputCapabilities: string | null;
637
+ generalScore?: number | null;
638
+ codingScore?: number | null;
639
+ webScore?: number | null;
640
+ officeScore?: number | null;
641
+ researchScore?: number | null;
642
+ multimodalScore?: number | null;
643
+ standardInputPrice?: number | null;
644
+ standardOutputPrice?: number | null;
645
+ priceUnit?: string | null;
646
+ priceCurrency?: string | null;
647
+ modelExperience: boolean;
648
+ functionCalling: boolean;
649
+ structuredOutput: boolean;
650
+ webSearch: boolean;
651
+ prefixCompletion: boolean;
652
+ cacheContext: boolean;
653
+ batchInference: boolean;
654
+ modelFinetune: boolean;
655
+ maxInputLength: string | null;
656
+ maxOutputLength: string | null;
657
+ maxInputLengthThinking: string | null;
658
+ maxOutputLengthThinking: string | null;
659
+ contextLength: string | null;
660
+ rpmLimit: number | null;
661
+ tpmLimit: number | null;
662
+ platformEnabled: boolean;
663
+ comingOffline: boolean;
664
+ availableEnabled: boolean;
665
+ recommended: boolean;
666
+ reason: string | null;
667
+ sortOrder: number;
668
+ updatedAt: string | null;
669
+ }
670
+ export interface CloudChatAttachment {
671
+ id: string;
672
+ name: string;
673
+ mediaType: string;
674
+ sizeBytes: number;
675
+ sourcePath?: string;
676
+ previewUrl?: string;
677
+ downloadUrl?: string;
678
+ }
679
+ export interface CloudChatSkillReference {
680
+ tenantId?: string | null;
681
+ id: string;
682
+ name: string;
683
+ iconUrl?: string | null;
684
+ }
685
+ export interface CloudChatConversationReference {
686
+ id: string;
687
+ messageIds: string[];
688
+ senderName: string;
689
+ summary: string;
690
+ createdAt?: string;
691
+ role?: 'user' | 'assistant';
692
+ }
693
+ export interface CloudChatSession {
694
+ id: string;
695
+ title: string;
696
+ model: string;
697
+ state: string;
698
+ turnCount: number;
699
+ isMain: boolean;
700
+ createdAt: string;
701
+ updatedAt: string;
702
+ lastActiveAt: string;
703
+ contextUsage?: ContextUsageSnapshot;
704
+ }
705
+ export interface CloudChatMessage {
706
+ id: string;
707
+ role: CloudChatRole;
708
+ content: string;
709
+ thinkingContent?: string;
710
+ thinkingComplete?: boolean;
711
+ historyInteraction?: {
712
+ kind: 'approval' | 'user_input' | 'elicitation';
713
+ title: string;
714
+ request: string;
715
+ response: string;
716
+ status: 'approved' | 'denied' | 'submitted' | 'cancelled' | 'timed_out';
717
+ };
718
+ createdAt: string;
719
+ status: CloudChatMessageStatus;
720
+ turnId?: string;
721
+ senderName?: string;
722
+ senderAvatarUrl?: string | null;
723
+ senderProfileKey?: string | null;
724
+ richContent?: CloudChatRichContent;
725
+ attachments?: CloudChatAttachment[];
726
+ skillReferences?: CloudChatSkillReference[];
727
+ conversationReference?: CloudChatConversationReference;
728
+ }
729
+ export interface CloudChatHistoryPage {
730
+ messages: CloudChatMessage[];
731
+ total: number;
732
+ limit: number;
733
+ offset: number;
734
+ }
735
+ export interface AgentHistoryRequest {
736
+ profileKey: string;
737
+ sessionId: string;
738
+ isMain: boolean;
739
+ limit?: number;
740
+ offset?: number;
741
+ }
742
+ export interface AgentSendMessageRequest {
743
+ profileKey: string;
744
+ sessionId: string;
745
+ isMain: boolean;
746
+ content: string;
747
+ model?: string;
748
+ thinkingEnabled?: boolean;
749
+ reasoningEffort?: ModelReasoningEffort;
750
+ attachments?: CloudUploadedAttachment[];
751
+ references?: CloudMessageReference[];
752
+ richContent?: CloudChatRichContent;
753
+ clientMessageId?: string;
754
+ }
755
+ export interface CloudUploadedAttachment {
756
+ artifactId?: string;
757
+ projectId?: string;
758
+ accessUrl?: string;
759
+ fileName: string;
760
+ filePath: string;
761
+ fileUrl: string;
762
+ previewUrl: string;
763
+ downloadUrl: string;
764
+ mediaType: string;
765
+ sizeBytes: number;
766
+ createdAt: string;
767
+ expiresAt: number;
768
+ expiresInSeconds: number;
769
+ }
770
+ export interface UploadAgentAttachmentRequest {
771
+ profileKey: string;
772
+ sessionId: string;
773
+ fileName: string;
774
+ mediaType: string;
775
+ data: ArrayBuffer;
776
+ }
777
+ export interface UploadProjectAttachmentRequest {
778
+ projectId: string;
779
+ fileName: string;
780
+ mediaType: string;
781
+ data: ArrayBuffer;
782
+ }
783
+ export interface AgentSendMessageResult {
784
+ messageId: string;
785
+ status: 'accepted' | 'queued';
786
+ }
787
+ export interface AgentCancelRequest {
788
+ profileKey: string;
789
+ sessionId: string;
790
+ isMain: boolean;
791
+ }
792
+ export type CloudChatStreamPayload = {
793
+ type: 'text-delta';
794
+ text: string;
795
+ } | {
796
+ type: 'thinking-delta';
797
+ text: string;
798
+ } | {
799
+ type: 'thinking-complete';
800
+ } | {
801
+ type: 'state';
802
+ state: string;
803
+ } | {
804
+ type: 'status';
805
+ message: string;
806
+ } | {
807
+ type: 'context-usage';
808
+ usage: ContextUsageSnapshot;
809
+ } | {
810
+ type: 'tool-start';
811
+ name: string;
812
+ } | {
813
+ type: 'tool-result';
814
+ name: string;
815
+ output: string;
816
+ failed: boolean;
817
+ } | {
818
+ type: 'interaction-changed';
819
+ interaction?: PersonalAgentInteraction;
820
+ interactionId: string;
821
+ status: PersonalAgentInteractionStatus;
822
+ } | {
823
+ type: 'complete';
824
+ finalText: string;
825
+ } | {
826
+ type: 'message-upsert';
827
+ message: CloudChatMessage;
828
+ clientMessageId?: string;
829
+ } | {
830
+ type: 'error';
831
+ message: string;
832
+ retryable: boolean;
833
+ };
834
+ export type PersonalAgentInteractionStatus = 'pending' | 'resolving' | 'resolved';
835
+ export type PersonalAgentInteractionKind = 'approval' | 'user_input';
836
+ export interface PersonalAgentInteractionOption {
837
+ id: string;
838
+ label: string;
839
+ description?: string;
840
+ decision?: 'approve' | 'deny';
841
+ }
842
+ export interface PersonalAgentInteraction {
843
+ id: string;
844
+ profileKey: string;
845
+ sessionId: string;
846
+ kind: PersonalAgentInteractionKind;
847
+ status: PersonalAgentInteractionStatus;
848
+ title: string;
849
+ description?: string;
850
+ toolCallId?: string;
851
+ requestId?: string;
852
+ interactionType?: 'question' | 'elicitation';
853
+ options?: PersonalAgentInteractionOption[];
854
+ allowOther?: boolean;
855
+ secret?: boolean;
856
+ formSchema?: Record<string, unknown> | unknown[];
857
+ mode?: string;
858
+ serverName?: string;
859
+ url?: string;
860
+ cancelable?: boolean;
861
+ createdAt?: string;
862
+ }
863
+ export interface ListPersonalAgentInteractionsRequest {
864
+ profileKey: string;
865
+ sessionId: string;
866
+ }
867
+ export interface ResolvePersonalAgentInteractionRequest extends ListPersonalAgentInteractionsRequest {
868
+ interactionId: string;
869
+ kind: PersonalAgentInteractionKind;
870
+ decision?: 'approve' | 'deny' | 'submit' | 'cancel';
871
+ toolCallId?: string;
872
+ requestId?: string;
873
+ interactionType?: 'question' | 'elicitation';
874
+ optionId?: string;
875
+ response?: string | Record<string, unknown>;
876
+ }
877
+ export interface AgentEventSubscriptionRequest {
878
+ profileKey: string;
879
+ sessionId: string;
880
+ isMain: boolean;
881
+ objectKey: string;
882
+ }
883
+ export interface ProjectEventSubscriptionRequest {
884
+ projectId: string;
885
+ sessionId: string;
886
+ objectKey: string;
887
+ }
888
+ export type CloudAssistantEventSubscriptionRequest = AgentEventSubscriptionRequest | ProjectEventSubscriptionRequest;
889
+ export interface CloudChatStreamEvent {
890
+ subscriptionId: string;
891
+ objectKey: string;
892
+ sessionId: string;
893
+ sequence: number;
894
+ streamKey?: string;
895
+ senderName?: string;
896
+ senderAvatarUrl?: string | null;
897
+ payload: CloudChatStreamPayload;
898
+ }
899
+ export interface CloudAssistantApi {
900
+ enterpriseProjects: {
901
+ search: (request: EnterpriseProjectSearchRequest) => Promise<EnterpriseProjectCapabilityPage>;
902
+ };
903
+ hub: {
904
+ list: () => Promise<AssistantHubList>;
905
+ };
906
+ agents: {
907
+ list: () => Promise<PersonalAgentList>;
908
+ listProfessionCategories: () => Promise<ProfessionCategory[]>;
909
+ searchProfessions: (query?: ProfessionSearchQuery) => Promise<ProfessionSearchResult>;
910
+ createCloud: (request: CreateCloudAgentRequest) => Promise<PersonalAgentProfile>;
911
+ createPairing: (request: CreateLocalAgentPairingRequest) => Promise<LocalAgentPairing>;
912
+ getPairing: (pairingId: string) => Promise<LocalAgentPairing>;
913
+ cancelPairing: (pairingId: string) => Promise<void>;
914
+ get: (profileKey: string) => Promise<PersonalAgentProfile>;
915
+ delete: (profileKey: string) => Promise<void>;
916
+ markRead: (profileKey: string) => Promise<PersonalAgentProfile>;
917
+ update: (request: UpdatePersonalAgentRequest) => Promise<PersonalAgentProfile>;
918
+ listSkills: (profileKey: string) => Promise<PersonalAgentSkill[]>;
919
+ listAvailableSkills: (query?: AvailablePersonalSkillQuery) => Promise<AvailablePersonalSkill[]>;
920
+ listAvailableSkillCategories: () => Promise<AvailablePersonalSkillCategory[]>;
921
+ addSkill: (profileKey: string, request: AddPersonalAgentSkillRequest) => Promise<PersonalAgentSkill>;
922
+ setSkillEnabled: (profileKey: string, bindingId: string, enabled: boolean) => Promise<PersonalAgentSkill>;
923
+ deleteSkill: (profileKey: string, bindingId: string) => Promise<void>;
924
+ listPlugins: (profileKey: string) => Promise<PersonalAgentPluginConfig>;
925
+ addPlugin: (profileKey: string, plugin: PersonalAgentPlugin) => Promise<PersonalAgentPluginConfig>;
926
+ setPluginEnabled: (profileKey: string, pluginId: string, enabled: boolean) => Promise<PersonalAgentPluginConfig>;
927
+ deletePlugin: (profileKey: string, pluginId: string) => Promise<PersonalAgentPluginConfig>;
928
+ listMessageChannels: (profileKey: string) => Promise<PersonalAgentMessageChannel[]>;
929
+ createWeixinMessageChannel: (profileKey: string) => Promise<PersonalAgentMessageChannel>;
930
+ updateMessageChannel: (profileKey: string, accountId: string, enabled: boolean, revision: number) => Promise<PersonalAgentMessageChannel>;
931
+ startMessageChannelAuthorization: (profileKey: string, accountId: string) => Promise<PersonalAgentChannelAuthorization>;
932
+ refreshMessageChannelAuthorization: (profileKey: string, accountId: string, sessionId: string) => Promise<PersonalAgentChannelAuthorization>;
933
+ };
934
+ projects: {
935
+ list: () => Promise<CollaborationProjectList>;
936
+ get: (projectId: string) => Promise<CollaborationProject>;
937
+ create: (request: CreateCollaborationProjectRequest) => Promise<CollaborationProject>;
938
+ update: (request: UpdateCollaborationProjectRequest) => Promise<CollaborationProject>;
939
+ delete: (projectId: string) => Promise<void>;
940
+ listMembers: (projectId: string) => Promise<CollaborationMember[]>;
941
+ listAgents: (projectId: string) => Promise<CollaborationAgent[]>;
942
+ listAgentSkills: (projectId: string) => Promise<CollaborationAgentSkill[]>;
943
+ updatePin: (request: UpdateProjectPinRequest) => Promise<CollaborationMember>;
944
+ updateAgent: (request: UpdateCollaborationAgentRequest) => Promise<CollaborationAgent>;
945
+ addAgent: (request: AddCollaborationAgentRequest) => Promise<CollaborationAgent>;
946
+ removeAgent: (request: RemoveCollaborationAgentRequest) => Promise<void>;
947
+ listMessages: (query: ProjectMessageQuery) => Promise<CollaborationMessageList>;
948
+ sendMessage: (request: ProjectSendMessageRequest) => Promise<CollaborationMessage>;
949
+ listTurns: (query: ProjectMessageQuery) => Promise<CollaborationTurnList>;
950
+ cancelTurn: (request: ProjectCancelTurnRequest) => Promise<void>;
951
+ };
952
+ chat: {
953
+ listSessions: (profileKey: string) => Promise<CloudChatSession[]>;
954
+ getHistory: (request: AgentHistoryRequest) => Promise<CloudChatHistoryPage>;
955
+ send: (request: AgentSendMessageRequest) => Promise<AgentSendMessageResult>;
956
+ cancel: (request: AgentCancelRequest) => Promise<void>;
957
+ listInteractions: (request: ListPersonalAgentInteractionsRequest) => Promise<PersonalAgentInteraction[]>;
958
+ resolveInteraction: (request: ResolvePersonalAgentInteractionRequest) => Promise<void>;
959
+ };
960
+ files: {
961
+ listAgent: (profileKey: string, query?: CloudFileListQuery) => Promise<CloudFileList>;
962
+ listProject: (projectId: string, query?: CloudFileListQuery) => Promise<CloudFileList>;
963
+ readContent: (target: CloudFileTarget) => Promise<CloudFileContent>;
964
+ readBinary: (source: CloudFileDataSource) => Promise<ArrayBuffer>;
965
+ getDownloadUrl: (target: CloudFileTarget) => Promise<string>;
966
+ upload: (request: UploadCloudFileRequest) => Promise<void>;
967
+ createDirectory: (request: CreateCloudDirectoryRequest) => Promise<void>;
968
+ rename: (request: RenameCloudFileRequest) => Promise<void>;
969
+ delete: (target: CloudFileTarget & {
970
+ directory: boolean;
971
+ }) => Promise<void>;
972
+ save: (request: SaveCloudFileRequest) => Promise<void>;
973
+ uploadAgentAttachment: (request: UploadAgentAttachmentRequest) => Promise<CloudUploadedAttachment>;
974
+ uploadProjectAttachment: (request: UploadProjectAttachmentRequest) => Promise<CloudUploadedAttachment>;
975
+ download: (request: DownloadCloudFileRequest) => Promise<{
976
+ canceled: boolean;
977
+ path?: string;
978
+ }>;
979
+ };
980
+ collections: {
981
+ list: () => Promise<CloudCollectionList>;
982
+ createFile: (request: CreateCloudFileCollectionRequest) => Promise<CloudCollectionItem>;
983
+ };
984
+ models: {
985
+ listText: () => Promise<AvailableChatModel[]>;
986
+ listLocalAgentText: () => Promise<AvailableChatModel[]>;
987
+ };
988
+ schedules: {
989
+ list: (query: ScheduleListQuery) => Promise<{
990
+ items: WorkbenchSchedule[];
991
+ total: number;
992
+ }>;
993
+ get: (scheduleId: string, profileKey: string) => Promise<WorkbenchSchedule>;
994
+ create: (request: SaveScheduleRequest) => Promise<WorkbenchSchedule>;
995
+ update: (request: SaveScheduleRequest & {
996
+ scheduleId: string;
997
+ }) => Promise<WorkbenchSchedule>;
998
+ delete: (scheduleId: string, profileKey: string) => Promise<void>;
999
+ listRuns: (scheduleId: string, profileKey: string) => Promise<WorkbenchScheduleRun[]>;
1000
+ listRunsByWindow: (query: ScheduleRunQuery) => Promise<WorkbenchScheduleRun[]>;
1001
+ };
1002
+ historySearch: {
1003
+ search: (request: HistorySearchRequest) => Promise<{
1004
+ items: HistorySearchItem[];
1005
+ total: number;
1006
+ }>;
1007
+ around: (request: HistoryAroundRequest) => Promise<{
1008
+ messages: CloudChatMessage[];
1009
+ anchorMessageId: string;
1010
+ }>;
1011
+ };
1012
+ chatShares: {
1013
+ create: (request: CreateChatShareRequest) => Promise<ChatShare>;
1014
+ };
1015
+ events: {
1016
+ subscribe: (request: CloudAssistantEventSubscriptionRequest) => Promise<string>;
1017
+ unsubscribe: (subscriptionId: string) => Promise<void>;
1018
+ onEvent: (listener: (event: CloudChatStreamEvent) => void) => () => void;
1019
+ };
1020
+ }