@crewx/sdk 0.9.0-rc.4 → 0.9.0-rc.41

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 (70) hide show
  1. package/README.md +1 -1
  2. package/dist/config/canonicalize-agent-options.d.ts +16 -0
  3. package/dist/config/global-settings.d.ts +19 -0
  4. package/dist/config/models.generated.d.ts +22 -0
  5. package/dist/config/models.remote.d.ts +4 -0
  6. package/dist/config/overdrive.d.ts +29 -0
  7. package/dist/config/pricing.d.ts +8 -8
  8. package/dist/config/pricing.generated.d.ts +2 -0
  9. package/dist/config/pricing.remote.d.ts +4 -0
  10. package/dist/config/pricing.types.d.ts +5 -0
  11. package/dist/config/timeout.config.d.ts +3 -0
  12. package/dist/config/wi-boards.d.ts +15 -0
  13. package/dist/esm/index.js +125 -82
  14. package/dist/esm/plugins/index.js +118 -71
  15. package/dist/esm/repository/index.js +122 -75
  16. package/dist/esm/testing/index.js +1 -1
  17. package/dist/events/types.d.ts +2 -0
  18. package/dist/facade/Crewx.d.ts +12 -0
  19. package/dist/index.browser.d.ts +1 -1
  20. package/dist/index.browser.js +2 -2
  21. package/dist/index.d.ts +17 -6
  22. package/dist/index.js +126 -83
  23. package/dist/internal/windows-spawn.d.ts +10 -0
  24. package/dist/migrations/0008_careful_black_bird.sql +17 -0
  25. package/dist/migrations/0009_hot_dark_phoenix.sql +1 -0
  26. package/dist/migrations/0010_analyze_stats.sql +6 -0
  27. package/dist/migrations/0011_far_black_tarantula.sql +1 -0
  28. package/dist/migrations/0012_blue_turbo.sql +23 -0
  29. package/dist/migrations/0013_hesitant_adam_destine.sql +15 -0
  30. package/dist/migrations/meta/0008_snapshot.json +1327 -0
  31. package/dist/migrations/meta/0009_snapshot.json +1335 -0
  32. package/dist/migrations/meta/0010_snapshot.json +1335 -0
  33. package/dist/migrations/meta/0011_snapshot.json +1342 -0
  34. package/dist/migrations/meta/0012_snapshot.json +1494 -0
  35. package/dist/migrations/meta/0013_snapshot.json +1592 -0
  36. package/dist/migrations/meta/_journal.json +42 -0
  37. package/dist/plugin/types.d.ts +1 -0
  38. package/dist/plugins/index.js +118 -71
  39. package/dist/provider/acp/adapters/claude.d.ts +0 -4
  40. package/dist/provider/acp/connection.d.ts +4 -0
  41. package/dist/provider/acp/meta.d.ts +4 -0
  42. package/dist/provider/bridge.d.ts +13 -1
  43. package/dist/provider/cli/adapter.types.d.ts +1 -0
  44. package/dist/provider/cli/adapters/claude.d.ts +0 -1
  45. package/dist/provider/cli/adapters/cli-knob.util.d.ts +2 -0
  46. package/dist/provider/cli/meta.d.ts +10 -2
  47. package/dist/provider/errors.d.ts +1 -0
  48. package/dist/provider/idle-watchdog.d.ts +19 -0
  49. package/dist/provider/models.d.ts +23 -0
  50. package/dist/provider/order.d.ts +1 -0
  51. package/dist/provider/parse-usage.d.ts +6 -0
  52. package/dist/provider/provider-selection.d.ts +8 -0
  53. package/dist/repository/agent-suggestion.repository.d.ts +34 -0
  54. package/dist/repository/index.d.ts +7 -1
  55. package/dist/repository/index.js +122 -75
  56. package/dist/repository/notification.repository.d.ts +58 -0
  57. package/dist/repository/task.repository.d.ts +79 -0
  58. package/dist/repository/thread.repository.d.ts +16 -2
  59. package/dist/repository/usage-report.repository.d.ts +27 -0
  60. package/dist/schema/agent-suggestions.d.ts +199 -0
  61. package/dist/schema/index.d.ts +3 -0
  62. package/dist/schema/notifications.d.ts +303 -0
  63. package/dist/schema/usage-reports.d.ts +252 -0
  64. package/dist/testing/index.d.ts +2 -0
  65. package/dist/testing/index.js +1 -1
  66. package/dist/types/index.d.ts +141 -3
  67. package/dist/utils/id.d.ts +1 -1
  68. package/package.json +3 -2
  69. package/templates/agents/default.yaml +175 -117
  70. package/templates/documents/crewx-manual.md +138 -138
@@ -0,0 +1,58 @@
1
+ import { BaseSqliteRepository } from './base-sqlite-repository.js';
2
+ import { notifications, notification_reads } from '../schema/index.js';
3
+ export declare const DEFAULT_NOTIFICATION_CAP = 500;
4
+ export type NotificationRow = typeof notifications.$inferSelect;
5
+ export type NewNotification = typeof notifications.$inferInsert;
6
+ export type NotificationReadRow = typeof notification_reads.$inferSelect;
7
+ export type NotificationLevel = 'info' | 'warning' | 'critical';
8
+ export type NotificationSource = 'agent' | 'system';
9
+ export interface CreateNotificationInput {
10
+ workspaceId: string;
11
+ agentId?: string | null;
12
+ taskId?: string | null;
13
+ threadId?: string | null;
14
+ source?: NotificationSource;
15
+ level?: NotificationLevel;
16
+ title: string;
17
+ body?: string | null;
18
+ targetUserId?: string | null;
19
+ metadata?: string | null;
20
+ }
21
+ export interface NotificationListItem extends NotificationRow {
22
+ read: boolean;
23
+ read_at: string | null;
24
+ }
25
+ export interface ListNotificationsParams {
26
+ workspaceId: string;
27
+ userId: string;
28
+ limit?: number;
29
+ }
30
+ export interface UserScope {
31
+ workspaceId: string;
32
+ userId: string;
33
+ }
34
+ export interface MarkReadParams {
35
+ notificationId: string;
36
+ workspaceId: string;
37
+ userId: string;
38
+ }
39
+ export declare const DEFAULT_LIST_LIMIT = 50;
40
+ export declare class NotificationRepository extends BaseSqliteRepository {
41
+ private readonly dbPath?;
42
+ private readonly cap;
43
+ constructor(opts?: {
44
+ dbPath?: string;
45
+ dbRoot?: string;
46
+ cap?: number;
47
+ });
48
+ resolveDbPath(): string;
49
+ private openHandle;
50
+ create(input: CreateNotificationInput): {
51
+ id: string;
52
+ };
53
+ private enforceCap;
54
+ list(params: ListNotificationsParams): NotificationListItem[];
55
+ unreadCount(params: UserScope): number;
56
+ markRead(params: MarkReadParams): boolean;
57
+ markAllRead(params: UserScope): number;
58
+ }
@@ -2,6 +2,12 @@ import { BaseSqliteRepository } from './base-sqlite-repository.js';
2
2
  import { tasks } from '../schema/index.js';
3
3
  export type TaskRow = typeof tasks.$inferSelect;
4
4
  export type NewTask = typeof tasks.$inferInsert;
5
+ export type TaskListRow = Pick<TaskRow, 'id' | 'thread_id' | 'agent_id' | 'status' | 'parent_task_id' | 'started_at' | 'completed_at' | 'duration_ms' | 'input_tokens' | 'output_tokens' | 'cost_usd' | 'error'>;
6
+ export interface WorkflowCardRow {
7
+ taskId: string;
8
+ workflowRunId?: string;
9
+ raw?: string;
10
+ }
5
11
  export interface AgentUsageRow {
6
12
  agentId: string;
7
13
  workspaceId: string | null;
@@ -32,8 +38,44 @@ export interface ProviderUsageRow {
32
38
  activeDurationMs: number;
33
39
  lastActiveAt: string | null;
34
40
  }
41
+ export interface ModelUsageRow {
42
+ model: string;
43
+ provider: string;
44
+ totalTasks: number;
45
+ inputTokens: number;
46
+ outputTokens: number;
47
+ cachedInputTokens: number;
48
+ costUsd: number;
49
+ totalTokens: number;
50
+ activeDurationMs: number;
51
+ lastActiveAt: string | null;
52
+ }
53
+ export interface ReportTaskRow {
54
+ threadId: string | null;
55
+ agentId: string;
56
+ startedAt: string;
57
+ status: string;
58
+ error: string | null;
59
+ exitCode: number | null;
60
+ }
61
+ export type TaskEvidenceRow = Pick<TaskRow, 'id' | 'agent_id' | 'status' | 'prompt' | 'started_at' | 'completed_at' | 'thread_id'>;
62
+ export interface ThreadChainTurn {
63
+ id: string;
64
+ agentId: string;
65
+ status: string;
66
+ prompt: string;
67
+ startedAt: string;
68
+ completedAt: string | null;
69
+ }
70
+ export interface ThreadChain {
71
+ threadId: string;
72
+ targetAgentTurnCount: number;
73
+ turns: ThreadChainTurn[];
74
+ }
75
+ export declare const PID_NULL_REAP_GRACE_MS: number;
35
76
  export declare class TaskRepository extends BaseSqliteRepository {
36
77
  private readonly dbPath?;
78
+ private readonly pidNullObservedSince;
37
79
  constructor(opts?: {
38
80
  dbPath?: string;
39
81
  dbRoot?: string;
@@ -89,6 +131,7 @@ export declare class TaskRepository extends BaseSqliteRepository {
89
131
  pid?: number;
90
132
  };
91
133
  reapOrphanedTasks(): number;
134
+ reapRunningWorkflowTasks(graceMs?: number): number;
92
135
  findTaskStatus(taskId: string, workspaceId?: string): TaskRow | undefined;
93
136
  findChildTasks(parentTaskId: string, workspaceId?: string): TaskRow[];
94
137
  getWorkspaceUsageSummary(workspaceId?: string): Array<{
@@ -104,6 +147,9 @@ export declare class TaskRepository extends BaseSqliteRepository {
104
147
  costUsd: number;
105
148
  };
106
149
  findTasksByThread(threadId: string, workspaceId?: string): TaskRow[];
150
+ private parseWorkflowCardMetadata;
151
+ private extractThreadIdFromCommand;
152
+ batchFetchWorkflowCards(threadIds: string[], workspaceId?: string): Map<string, WorkflowCardRow>;
107
153
  findAllTasks(params: {
108
154
  workspaceId?: string;
109
155
  agentId?: string;
@@ -124,7 +170,40 @@ export declare class TaskRepository extends BaseSqliteRepository {
124
170
  getAgentUsage(from: string, to: string, workspace?: string): AgentUsageRow[];
125
171
  getAgentUsageTrendRaw(from: string, to: string, workspace?: string): TrendRow[];
126
172
  findTaskForStop(taskId: string, workspaceId: string): TaskRow | undefined;
173
+ findLatestTaskByMetadata(opts: {
174
+ agentId: string;
175
+ workspaceId: string;
176
+ metaKey: string;
177
+ metaValue: string;
178
+ }): {
179
+ id: string;
180
+ thread_id: string | null;
181
+ status: string;
182
+ result: string | null;
183
+ error: string | null;
184
+ started_at: string;
185
+ completed_at: string | null;
186
+ } | null;
127
187
  markTaskFailed(taskId: string, error: string, workspaceId?: string): void;
128
188
  findTasksByPromptHint(hint: string, workspaceId?: string): TaskRow[];
129
189
  getProviderUsage(from: string, to: string, workspace?: string): ProviderUsageRow[];
190
+ getModelUsage(from: string, to: string, workspace?: string): ModelUsageRow[];
191
+ getTasksForReport(from: string, to: string, workspace?: string): ReportTaskRow[];
192
+ findTaskEvidence(params: {
193
+ workspaceId?: string;
194
+ agents?: string[];
195
+ statuses?: string[];
196
+ from?: string;
197
+ to?: string;
198
+ limit?: number;
199
+ order?: 'ASC' | 'DESC';
200
+ }): TaskEvidenceRow[];
201
+ findThreadChains(params: {
202
+ targetAgentId: string;
203
+ workspaceId?: string;
204
+ from?: string;
205
+ to?: string;
206
+ maxThreads?: number;
207
+ maxTurnsPerThread?: number;
208
+ }): ThreadChain[];
130
209
  }
@@ -1,6 +1,6 @@
1
1
  import { BaseSqliteRepository } from './base-sqlite-repository.js';
2
2
  import { threads } from '../schema/index.js';
3
- import type { TaskRow } from './task.repository.js';
3
+ import type { TaskRow, TaskListRow } from './task.repository.js';
4
4
  export type ThreadRow = typeof threads.$inferSelect;
5
5
  export type NewThread = typeof threads.$inferInsert;
6
6
  export declare class ThreadRepository extends BaseSqliteRepository {
@@ -14,6 +14,7 @@ export declare class ThreadRepository extends BaseSqliteRepository {
14
14
  private validateWorkspaceId;
15
15
  private topLevelTaskPredicateSql;
16
16
  findAllThreads(workspaceId?: string): ThreadRow[];
17
+ findThreadsByIdsOrTitles(ids: string[], workspaceId?: string): ThreadRow[];
17
18
  findThreadById(threadId: string, workspaceId?: string): ThreadRow | undefined;
18
19
  threadExists(threadId: string, workspaceId?: string): boolean;
19
20
  aggregateTaskStats(threadId: string, workspaceId?: string): {
@@ -30,7 +31,9 @@ export declare class ThreadRepository extends BaseSqliteRepository {
30
31
  task: TaskRow;
31
32
  children: TaskRow[];
32
33
  } | undefined;
33
- batchFetchTasks(threadIds: string[], workspaceId?: string): Map<string, TaskRow[]>;
34
+ private batchFetchTasksQuery;
35
+ batchFetchTasks(threadIds: string[], workspaceId?: string): Map<string, TaskListRow[]>;
36
+ explainBatchFetchTasksPlan(threadIds: string[], workspaceId?: string): string[];
34
37
  updateThreadTitle(threadId: string, title: string, workspaceId?: string): void;
35
38
  upsertThread(threadId: string, opts: {
36
39
  platform: string;
@@ -63,4 +66,15 @@ export declare class ThreadRepository extends BaseSqliteRepository {
63
66
  toggleStar(threadId: string, workspaceId?: string): {
64
67
  starred: boolean;
65
68
  } | null;
69
+ resolveOverdriveForRequest(threadId: string, workspaceId: string | undefined, action: 'enable-count' | 'enable-latch' | 'disable' | 'use-current', opts?: {
70
+ turns?: number;
71
+ defaultTurns?: number;
72
+ updatedBy?: string;
73
+ consumeCurrent?: boolean;
74
+ }): {
75
+ applied: boolean;
76
+ appliedMode?: 'count' | 'latch';
77
+ state: 'off' | 'count' | 'latch';
78
+ remaining: number;
79
+ } | null;
66
80
  }
@@ -0,0 +1,27 @@
1
+ import { BaseSqliteRepository } from './base-sqlite-repository.js';
2
+ import { usage_reports } from '../schema/index.js';
3
+ export type UsageReportRow = typeof usage_reports.$inferSelect;
4
+ export type NewUsageReport = typeof usage_reports.$inferInsert;
5
+ export interface PublishReportInput {
6
+ id: string;
7
+ workspaceId: string;
8
+ month: string;
9
+ generatedAt: string;
10
+ sourceRange: string;
11
+ tier: string;
12
+ totalTokens: number;
13
+ totalCostUsd: number;
14
+ payload: string;
15
+ }
16
+ export declare class UsageReportRepository extends BaseSqliteRepository {
17
+ private readonly dbPath?;
18
+ constructor(opts?: {
19
+ dbPath?: string;
20
+ dbRoot?: string;
21
+ });
22
+ resolveDbPath(): string;
23
+ private openHandle;
24
+ publish(input: PublishReportInput): UsageReportRow;
25
+ findByMonth(workspaceId: string, month: string): UsageReportRow | undefined;
26
+ listByWorkspace(workspaceId: string): UsageReportRow[];
27
+ }
@@ -0,0 +1,199 @@
1
+ export declare const agent_suggestions: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
2
+ name: "agent_suggestions";
3
+ schema: undefined;
4
+ columns: {
5
+ id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
6
+ name: "id";
7
+ tableName: "agent_suggestions";
8
+ dataType: "string";
9
+ columnType: "SQLiteText";
10
+ data: string;
11
+ driverParam: string;
12
+ notNull: true;
13
+ hasDefault: false;
14
+ isPrimaryKey: true;
15
+ isAutoincrement: false;
16
+ hasRuntimeDefault: false;
17
+ enumValues: [string, ...string[]];
18
+ baseColumn: never;
19
+ identity: undefined;
20
+ generated: undefined;
21
+ }, {}, {
22
+ length: number | undefined;
23
+ }>;
24
+ workspace_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
25
+ name: "workspace_id";
26
+ tableName: "agent_suggestions";
27
+ dataType: "string";
28
+ columnType: "SQLiteText";
29
+ data: string;
30
+ driverParam: string;
31
+ notNull: true;
32
+ hasDefault: false;
33
+ isPrimaryKey: false;
34
+ isAutoincrement: false;
35
+ hasRuntimeDefault: false;
36
+ enumValues: [string, ...string[]];
37
+ baseColumn: never;
38
+ identity: undefined;
39
+ generated: undefined;
40
+ }, {}, {
41
+ length: number | undefined;
42
+ }>;
43
+ agent_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
44
+ name: "agent_id";
45
+ tableName: "agent_suggestions";
46
+ dataType: "string";
47
+ columnType: "SQLiteText";
48
+ data: string;
49
+ driverParam: string;
50
+ notNull: true;
51
+ hasDefault: false;
52
+ isPrimaryKey: false;
53
+ isAutoincrement: false;
54
+ hasRuntimeDefault: false;
55
+ enumValues: [string, ...string[]];
56
+ baseColumn: never;
57
+ identity: undefined;
58
+ generated: undefined;
59
+ }, {}, {
60
+ length: number | undefined;
61
+ }>;
62
+ task_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
63
+ name: "task_id";
64
+ tableName: "agent_suggestions";
65
+ dataType: "string";
66
+ columnType: "SQLiteText";
67
+ data: string;
68
+ driverParam: string;
69
+ notNull: false;
70
+ hasDefault: false;
71
+ isPrimaryKey: false;
72
+ isAutoincrement: false;
73
+ hasRuntimeDefault: false;
74
+ enumValues: [string, ...string[]];
75
+ baseColumn: never;
76
+ identity: undefined;
77
+ generated: undefined;
78
+ }, {}, {
79
+ length: number | undefined;
80
+ }>;
81
+ type: import("drizzle-orm/sqlite-core").SQLiteColumn<{
82
+ name: "type";
83
+ tableName: "agent_suggestions";
84
+ dataType: "string";
85
+ columnType: "SQLiteText";
86
+ data: string;
87
+ driverParam: string;
88
+ notNull: true;
89
+ hasDefault: false;
90
+ isPrimaryKey: false;
91
+ isAutoincrement: false;
92
+ hasRuntimeDefault: false;
93
+ enumValues: [string, ...string[]];
94
+ baseColumn: never;
95
+ identity: undefined;
96
+ generated: undefined;
97
+ }, {}, {
98
+ length: number | undefined;
99
+ }>;
100
+ status: import("drizzle-orm/sqlite-core").SQLiteColumn<{
101
+ name: "status";
102
+ tableName: "agent_suggestions";
103
+ dataType: "string";
104
+ columnType: "SQLiteText";
105
+ data: string;
106
+ driverParam: string;
107
+ notNull: true;
108
+ hasDefault: true;
109
+ isPrimaryKey: false;
110
+ isAutoincrement: false;
111
+ hasRuntimeDefault: false;
112
+ enumValues: [string, ...string[]];
113
+ baseColumn: never;
114
+ identity: undefined;
115
+ generated: undefined;
116
+ }, {}, {
117
+ length: number | undefined;
118
+ }>;
119
+ payload: import("drizzle-orm/sqlite-core").SQLiteColumn<{
120
+ name: "payload";
121
+ tableName: "agent_suggestions";
122
+ dataType: "string";
123
+ columnType: "SQLiteText";
124
+ data: string;
125
+ driverParam: string;
126
+ notNull: true;
127
+ hasDefault: false;
128
+ isPrimaryKey: false;
129
+ isAutoincrement: false;
130
+ hasRuntimeDefault: false;
131
+ enumValues: [string, ...string[]];
132
+ baseColumn: never;
133
+ identity: undefined;
134
+ generated: undefined;
135
+ }, {}, {
136
+ length: number | undefined;
137
+ }>;
138
+ applied_commit_sha: import("drizzle-orm/sqlite-core").SQLiteColumn<{
139
+ name: "applied_commit_sha";
140
+ tableName: "agent_suggestions";
141
+ dataType: "string";
142
+ columnType: "SQLiteText";
143
+ data: string;
144
+ driverParam: string;
145
+ notNull: false;
146
+ hasDefault: false;
147
+ isPrimaryKey: false;
148
+ isAutoincrement: false;
149
+ hasRuntimeDefault: false;
150
+ enumValues: [string, ...string[]];
151
+ baseColumn: never;
152
+ identity: undefined;
153
+ generated: undefined;
154
+ }, {}, {
155
+ length: number | undefined;
156
+ }>;
157
+ created_at: import("drizzle-orm/sqlite-core").SQLiteColumn<{
158
+ name: "created_at";
159
+ tableName: "agent_suggestions";
160
+ dataType: "string";
161
+ columnType: "SQLiteText";
162
+ data: string;
163
+ driverParam: string;
164
+ notNull: true;
165
+ hasDefault: false;
166
+ isPrimaryKey: false;
167
+ isAutoincrement: false;
168
+ hasRuntimeDefault: false;
169
+ enumValues: [string, ...string[]];
170
+ baseColumn: never;
171
+ identity: undefined;
172
+ generated: undefined;
173
+ }, {}, {
174
+ length: number | undefined;
175
+ }>;
176
+ updated_at: import("drizzle-orm/sqlite-core").SQLiteColumn<{
177
+ name: "updated_at";
178
+ tableName: "agent_suggestions";
179
+ dataType: "string";
180
+ columnType: "SQLiteText";
181
+ data: string;
182
+ driverParam: string;
183
+ notNull: true;
184
+ hasDefault: false;
185
+ isPrimaryKey: false;
186
+ isAutoincrement: false;
187
+ hasRuntimeDefault: false;
188
+ enumValues: [string, ...string[]];
189
+ baseColumn: never;
190
+ identity: undefined;
191
+ generated: undefined;
192
+ }, {}, {
193
+ length: number | undefined;
194
+ }>;
195
+ };
196
+ dialect: "sqlite";
197
+ }>;
198
+ export type AgentSuggestion = typeof agent_suggestions.$inferSelect;
199
+ export type NewAgentSuggestion = typeof agent_suggestions.$inferInsert;
@@ -6,3 +6,6 @@ export * from './tool-calls.js';
6
6
  export * from './thread-boxes.js';
7
7
  export * from './request-logs.js';
8
8
  export * from './usage-limit-snapshots.js';
9
+ export * from './usage-reports.js';
10
+ export * from './notifications.js';
11
+ export * from './agent-suggestions.js';