@xpert-ai/xpert-sdk 0.4.1 → 0.4.3

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.
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sandbox-runtime.test.mjs","sourceRoot":"","sources":["../../src/tests/sandbox-runtime.test.ts"],"names":[],"mappings":"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"}
@@ -83,4 +83,150 @@ export type RemoveMessage = BaseMessage & {
83
83
  type: "remove";
84
84
  };
85
85
  export type Message = HumanMessage | AIMessage | ToolMessage | SystemMessage | FunctionMessage | RemoveMessage;
86
+ /** API wire types owned by the SDK; importing them must not require a UI package. */
87
+ export type FileRevision = {
88
+ sha256: string;
89
+ size: number;
90
+ };
91
+ export type FileChangeResource = {
92
+ type: 'file_change';
93
+ first: {
94
+ artifactId: string;
95
+ artifactVersionId: string;
96
+ };
97
+ last: {
98
+ artifactId: string;
99
+ artifactVersionId: string;
100
+ };
101
+ };
102
+ export type FileChangeSetResource = {
103
+ type: 'file_change_set';
104
+ messageId: string;
105
+ changes: {
106
+ workspacePath: string;
107
+ resource?: FileChangeResource;
108
+ }[];
109
+ };
110
+ export type ChatTaskSummaryResourceReference = {
111
+ type: 'message';
112
+ messageId: string;
113
+ } | {
114
+ type: 'workspace_file';
115
+ workspacePath: string;
116
+ fileAssetId?: string;
117
+ storageFileId?: string;
118
+ } | {
119
+ type: 'artifact';
120
+ artifactId: string;
121
+ artifactVersionId?: string;
122
+ } | FileChangeResource | FileChangeSetResource | {
123
+ type: 'browser';
124
+ serviceId?: string;
125
+ url?: string;
126
+ } | {
127
+ type: 'url';
128
+ url: string;
129
+ };
130
+ export type ChatFileChange = {
131
+ id: string;
132
+ workspacePath: string;
133
+ title: string;
134
+ operation: 'added' | 'modified' | 'deleted' | 'unknown';
135
+ before?: FileRevision | null;
136
+ after?: FileRevision | null;
137
+ resource?: FileChangeResource;
138
+ coverage: 'observed' | 'legacy';
139
+ messageId?: string;
140
+ startedAt?: string;
141
+ updatedAt?: string;
142
+ };
143
+ export type FileChangeLineStats = {
144
+ status: 'ready';
145
+ added: number;
146
+ removed: number;
147
+ } | {
148
+ status: 'unavailable';
149
+ };
150
+ export type MessageFileChangeStats = {
151
+ messageId: string;
152
+ items: {
153
+ workspacePath: string;
154
+ resource?: FileChangeResource;
155
+ stats: FileChangeLineStats;
156
+ }[];
157
+ };
158
+ export type ChatTaskSummaryOutputKind = 'file' | 'image' | 'document' | 'spreadsheet' | 'presentation' | 'site' | 'url' | 'mcp_app';
159
+ export type ChatTaskSummaryOutputStatus = 'pending' | 'running' | 'success' | 'error';
160
+ export type ChatTaskSummaryOutput = {
161
+ id: string;
162
+ kind: ChatTaskSummaryOutputKind;
163
+ title: string;
164
+ description?: string;
165
+ status?: ChatTaskSummaryOutputStatus;
166
+ resource?: ChatTaskSummaryResourceReference;
167
+ messageId?: string;
168
+ updatedAt?: string;
169
+ /** Only host-verified, explicitly presented files get message-end cards. */
170
+ origin?: 'tool' | 'integration' | 'legacy';
171
+ workspacePath?: string;
172
+ mimeType?: string;
173
+ size?: number;
174
+ sha256?: string;
175
+ };
176
+ export type ChatTaskSummarySourceKind = 'attachment' | 'code' | 'quote' | 'image' | 'web_page' | 'file_element' | 'knowledge' | 'skill' | 'plugin' | 'sub_agent';
177
+ export type ChatTaskSummarySource = {
178
+ id: string;
179
+ kind: ChatTaskSummarySourceKind;
180
+ title: string;
181
+ description?: string;
182
+ resource?: ChatTaskSummaryResourceReference;
183
+ messageId?: string;
184
+ updatedAt?: string;
185
+ };
186
+ export type ChatTaskSummaryPlan = {
187
+ title: string;
188
+ excerpt: string;
189
+ messageId?: string;
190
+ updatedAt?: string;
191
+ };
192
+ export type ChatTaskSummaryTodoStatus = 'pending' | 'in_progress' | 'completed';
193
+ export type ChatTaskSummaryTodoItem = {
194
+ id: string;
195
+ content: string;
196
+ status: ChatTaskSummaryTodoStatus;
197
+ };
198
+ export type ChatTaskSummaryTodos = {
199
+ componentId: string;
200
+ title?: string;
201
+ items: ChatTaskSummaryTodoItem[];
202
+ messageId?: string;
203
+ updatedAt?: string;
204
+ };
205
+ /** Snapshot produced by the runtime after successfully loading skill instructions. */
206
+ export type ChatSkillUsage = {
207
+ skillId: string;
208
+ name: string;
209
+ version: string;
210
+ source: {
211
+ type: 'workspace' | 'project' | 'assistant' | 'plugin';
212
+ id: string;
213
+ };
214
+ activation: 'read';
215
+ toolCallId: string;
216
+ executionId?: string;
217
+ loadedAt: string;
218
+ };
219
+ /** Compact message summary. Raw tool output and private file contents are excluded. */
220
+ export type ChatTaskSummaryContribution = {
221
+ version: 1;
222
+ plan?: ChatTaskSummaryPlan;
223
+ todos?: ChatTaskSummaryTodos;
224
+ outputs?: ChatTaskSummaryOutput[];
225
+ sources?: ChatTaskSummarySource[];
226
+ skillUsages?: ChatSkillUsage[];
227
+ fileActivityVersion?: 1;
228
+ fileActivityToolCallId?: string;
229
+ fileChangeCoverage?: 'bounded' | 'partial' | 'unavailable';
230
+ fileChanges?: ChatFileChange[];
231
+ };
86
232
  export {};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@xpert-ai/xpert-sdk",
3
- "version": "0.4.1",
3
+ "version": "0.4.3",
4
4
  "description": "SDK Core functionality package",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",