@pxlabz/tasq-sdk 0.1.11 → 0.1.13
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.
- package/dist/index.d.ts +463 -12
- package/dist/index.js +58 -2
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/dist/index.d.ts
CHANGED
|
@@ -77,6 +77,8 @@ type TaskListItem = {
|
|
|
77
77
|
milestoneId: string | null;
|
|
78
78
|
/** 5.5: the task this is a subtask of, one level only (D-2). */
|
|
79
79
|
parentTaskId: string | null;
|
|
80
|
+
/** The parent's key, so a subtask shown away from its parent can name it. */
|
|
81
|
+
parentIdentifier: string | null;
|
|
80
82
|
/**
|
|
81
83
|
* 5.5: how many subtasks this task has and how many are done, the `n/m` a
|
|
82
84
|
* client shows. Cancelled and archived subtasks are in neither number.
|
|
@@ -88,8 +90,25 @@ type TaskListItem = {
|
|
|
88
90
|
startDate: string | null;
|
|
89
91
|
status: TaskStatusRef;
|
|
90
92
|
assignee: MemberRef | null;
|
|
93
|
+
/** 6.3: where a sign-off stands; null until someone asks for one. */
|
|
94
|
+
approval: TaskApproval | null;
|
|
91
95
|
labels: TaskLabelRef[];
|
|
92
96
|
};
|
|
97
|
+
/**
|
|
98
|
+
* A task's approval (6.3). `approver` is null when the person asked has since
|
|
99
|
+
* left the workspace; the request still stands.
|
|
100
|
+
*/
|
|
101
|
+
type TaskApproval = {
|
|
102
|
+
state: "requested" | "approved" | "changes_requested" | "rejected";
|
|
103
|
+
approver: {
|
|
104
|
+
memberId: string;
|
|
105
|
+
name: string | null;
|
|
106
|
+
} | null;
|
|
107
|
+
requestedAt: string | null;
|
|
108
|
+
decidedAt: string | null;
|
|
109
|
+
};
|
|
110
|
+
/** What `task.decide` takes: approve, ask for changes, or reject. */
|
|
111
|
+
type TaskApprovalDecision = "approve" | "changes" | "reject";
|
|
93
112
|
type SubtaskProgress = {
|
|
94
113
|
total: number;
|
|
95
114
|
completed: number;
|
|
@@ -197,6 +216,9 @@ type TeamRef = {
|
|
|
197
216
|
identifier: string;
|
|
198
217
|
};
|
|
199
218
|
type ProjectStatus = "backlog" | "planned" | "in_progress" | "completed" | "cancelled";
|
|
219
|
+
/** A project's health, as called by its latest sent update (7.5). */
|
|
220
|
+
declare const PROJECT_HEALTH_VALUES: readonly ["on_track", "at_risk", "off_track"];
|
|
221
|
+
type ProjectHealth = (typeof PROJECT_HEALTH_VALUES)[number];
|
|
200
222
|
type ProjectListItem = {
|
|
201
223
|
id: string;
|
|
202
224
|
workspaceId: string;
|
|
@@ -215,6 +237,28 @@ type ProjectListItem = {
|
|
|
215
237
|
teams: TeamRef[];
|
|
216
238
|
lead: PersonRef | null;
|
|
217
239
|
members: PersonRef[];
|
|
240
|
+
/** Null until a project update has been sent. Drafts never move it. */
|
|
241
|
+
health: ProjectHealth | null;
|
|
242
|
+
/** When the latest sent update went out. */
|
|
243
|
+
latestUpdateAt: string | null;
|
|
244
|
+
/** Whether the calling member starred it. Always false for an agent key. */
|
|
245
|
+
starred: boolean;
|
|
246
|
+
/** Active initiatives the project belongs to, by name. */
|
|
247
|
+
initiatives: InitiativeRef[];
|
|
248
|
+
};
|
|
249
|
+
type InitiativeRef = {
|
|
250
|
+
id: string;
|
|
251
|
+
name: string;
|
|
252
|
+
};
|
|
253
|
+
type InitiativeStatus = "active" | "archived";
|
|
254
|
+
/** One row of `GET /workspaces/:slug/initiatives`, archived ones included. */
|
|
255
|
+
type InitiativeListItem = {
|
|
256
|
+
id: string;
|
|
257
|
+
name: string;
|
|
258
|
+
status: InitiativeStatus;
|
|
259
|
+
ownerMemberId: string | null;
|
|
260
|
+
projectIds: string[];
|
|
261
|
+
createdAt: string;
|
|
218
262
|
};
|
|
219
263
|
type ProjectMilestone = {
|
|
220
264
|
id: string;
|
|
@@ -233,6 +277,25 @@ type ProjectDetail = ProjectListItem & {
|
|
|
233
277
|
/** Project threads, same shape as task detail comments (D-2). */
|
|
234
278
|
comments: TaskComment[];
|
|
235
279
|
};
|
|
280
|
+
/** Who wrote a project update. Null once the author has left. */
|
|
281
|
+
type ProjectUpdateAuthor = {
|
|
282
|
+
memberId: string;
|
|
283
|
+
name: string;
|
|
284
|
+
kind: "user" | "agent";
|
|
285
|
+
};
|
|
286
|
+
/** One row of `GET /workspaces/:slug/projects/:projectId/updates`, newest first. */
|
|
287
|
+
type ProjectUpdateListItem = {
|
|
288
|
+
id: string;
|
|
289
|
+
projectId: string;
|
|
290
|
+
health: ProjectHealth;
|
|
291
|
+
body: string;
|
|
292
|
+
author: ProjectUpdateAuthor | null;
|
|
293
|
+
actorType: "user" | "agent";
|
|
294
|
+
/** Null while the update is a draft. */
|
|
295
|
+
sentAt: string | null;
|
|
296
|
+
createdAt: string;
|
|
297
|
+
updatedAt: string;
|
|
298
|
+
};
|
|
236
299
|
type CycleState = "upcoming" | "active" | "completed";
|
|
237
300
|
type CycleListItem = {
|
|
238
301
|
id: string;
|
|
@@ -413,7 +476,7 @@ type AgentEventsResponse = {
|
|
|
413
476
|
*/
|
|
414
477
|
type NotificationItem = {
|
|
415
478
|
id: string;
|
|
416
|
-
kind: "agent_reply" | "thread_reply" | "release_ready";
|
|
479
|
+
kind: "agent_reply" | "thread_reply" | "release_ready" | "approval_requested" | "approval_decided";
|
|
417
480
|
/** Exactly one of `taskId` / `projectId` is set: the entity the thread is on. */
|
|
418
481
|
taskId: string | null;
|
|
419
482
|
taskKey: string | null;
|
|
@@ -697,7 +760,7 @@ type DispatchResponse<TName extends ActionName> = {
|
|
|
697
760
|
result: ActionWireOutputMap[TName];
|
|
698
761
|
invalidates: Array<Array<string>>;
|
|
699
762
|
};
|
|
700
|
-
type ActionName = "task.create" | "task.assign" | "task.bulkSetCycle" | "task.move" | "task.setPriority" | "task.setEstimate" | "task.setDates" | "task.update" | "task.setProject" | "task.setCycle" | "task.setMilestone" | "task.setParent" | "task.addLabel" | "task.removeLabel" | "task.archive" | "task.unarchive" | "comment.add" | "notification.markRead" | "project.create" | "project.update" | "project.archive" | "project.unarchive" | "project.addTeam" | "project.removeTeam" | "project.addMember" | "project.removeMember" | "project.setLead" | "milestone.create" | "milestone.update" | "milestone.delete" | "milestone.reorder" | "milestone.promote" | "cycle.create" | "cycle.update" | "cycle.delete" | "status.create" | "status.update" | "status.reorder" | "status.delete" | "label.create" | "label.update" | "label.delete" | "team.cycleCadence.save" | "team.estimateSettings.save" | "team.agentSettings.save" | "team.cycleLifecycle.apply" | "team.setKind" | "team.setModules" | "release.saveNarrative" | "agent.create" | "agent.setPolicy" | "agent.issueKey" | "agent.revokeKey" | "agent.pause" | "agent.resume" | "agent.remove";
|
|
763
|
+
type ActionName = "task.create" | "task.assign" | "task.bulkSetCycle" | "task.move" | "task.setPriority" | "task.setEstimate" | "task.setDates" | "task.update" | "task.setProject" | "task.setCycle" | "task.setMilestone" | "task.setParent" | "task.requestApproval" | "task.decide" | "task.addLabel" | "task.removeLabel" | "task.archive" | "task.unarchive" | "comment.add" | "notification.markRead" | "project.create" | "project.update" | "project.archive" | "project.unarchive" | "project.addTeam" | "project.removeTeam" | "project.addMember" | "project.removeMember" | "project.setLead" | "project.star" | "project.unstar" | "initiative.create" | "initiative.update" | "initiative.delete" | "initiative.linkProject" | "initiative.unlinkProject" | "projectUpdate.create" | "projectUpdate.update" | "projectUpdate.send" | "projectUpdate.delete" | "milestone.create" | "milestone.update" | "milestone.delete" | "milestone.reorder" | "milestone.promote" | "cycle.create" | "cycle.update" | "cycle.delete" | "status.create" | "status.update" | "status.reorder" | "status.delete" | "label.create" | "label.update" | "label.delete" | "team.cycleCadence.save" | "team.estimateSettings.save" | "team.agentSettings.save" | "team.cycleLifecycle.apply" | "team.setKind" | "team.setModules" | "release.saveNarrative" | "agent.create" | "agent.setPolicy" | "agent.issueKey" | "agent.revokeKey" | "agent.pause" | "agent.resume" | "agent.remove";
|
|
701
764
|
type ActionInputMap = Omit<ActionParsedInputMap, "cycle.create" | "cycle.update"> & {
|
|
702
765
|
"cycle.create": DatesAsInput<{
|
|
703
766
|
teamIdentifier: string;
|
|
@@ -712,7 +775,7 @@ type ActionInputMap = Omit<ActionParsedInputMap, "cycle.create" | "cycle.update"
|
|
|
712
775
|
description?: string | null | undefined;
|
|
713
776
|
startDate?: Date | undefined;
|
|
714
777
|
endDate?: Date | undefined;
|
|
715
|
-
status?: "completed" | "
|
|
778
|
+
status?: "completed" | "active" | "upcoming" | undefined;
|
|
716
779
|
}>;
|
|
717
780
|
};
|
|
718
781
|
type ActionParsedInputMap = {
|
|
@@ -780,6 +843,14 @@ type ActionParsedInputMap = {
|
|
|
780
843
|
taskId: string;
|
|
781
844
|
parentTaskId: string | null;
|
|
782
845
|
};
|
|
846
|
+
"task.requestApproval": {
|
|
847
|
+
taskId: string;
|
|
848
|
+
approverId: string;
|
|
849
|
+
};
|
|
850
|
+
"task.decide": {
|
|
851
|
+
taskId: string;
|
|
852
|
+
decision: "approve" | "changes" | "reject";
|
|
853
|
+
};
|
|
783
854
|
"task.addLabel": {
|
|
784
855
|
taskId: string;
|
|
785
856
|
labelId: string;
|
|
@@ -848,6 +919,52 @@ type ActionParsedInputMap = {
|
|
|
848
919
|
projectId: string;
|
|
849
920
|
leadId: string | null;
|
|
850
921
|
};
|
|
922
|
+
"project.star": {
|
|
923
|
+
projectId: string;
|
|
924
|
+
};
|
|
925
|
+
"project.unstar": {
|
|
926
|
+
projectId: string;
|
|
927
|
+
};
|
|
928
|
+
"initiative.create": {
|
|
929
|
+
name: string;
|
|
930
|
+
ownerMemberId?: string | null | undefined;
|
|
931
|
+
};
|
|
932
|
+
"initiative.update": {
|
|
933
|
+
initiativeId: string;
|
|
934
|
+
name?: string | undefined;
|
|
935
|
+
status?: "active" | "archived" | undefined;
|
|
936
|
+
ownerMemberId?: string | null | undefined;
|
|
937
|
+
};
|
|
938
|
+
"initiative.delete": {
|
|
939
|
+
initiativeId: string;
|
|
940
|
+
};
|
|
941
|
+
"initiative.linkProject": {
|
|
942
|
+
initiativeId: string;
|
|
943
|
+
projectId: string;
|
|
944
|
+
};
|
|
945
|
+
"initiative.unlinkProject": {
|
|
946
|
+
initiativeId: string;
|
|
947
|
+
projectId: string;
|
|
948
|
+
};
|
|
949
|
+
"projectUpdate.create": {
|
|
950
|
+
projectId: string;
|
|
951
|
+
health: "on_track" | "at_risk" | "off_track";
|
|
952
|
+
body: string;
|
|
953
|
+
send?: boolean | undefined;
|
|
954
|
+
};
|
|
955
|
+
"projectUpdate.update": {
|
|
956
|
+
updateId: string;
|
|
957
|
+
health?: "on_track" | "at_risk" | "off_track" | undefined;
|
|
958
|
+
body?: string | undefined;
|
|
959
|
+
};
|
|
960
|
+
"projectUpdate.send": {
|
|
961
|
+
updateId: string;
|
|
962
|
+
health?: "on_track" | "at_risk" | "off_track" | undefined;
|
|
963
|
+
body?: string | undefined;
|
|
964
|
+
};
|
|
965
|
+
"projectUpdate.delete": {
|
|
966
|
+
updateId: string;
|
|
967
|
+
};
|
|
851
968
|
"milestone.create": {
|
|
852
969
|
projectId: string;
|
|
853
970
|
name: string;
|
|
@@ -883,7 +1000,7 @@ type ActionParsedInputMap = {
|
|
|
883
1000
|
description?: string | null | undefined;
|
|
884
1001
|
startDate?: Date | undefined;
|
|
885
1002
|
endDate?: Date | undefined;
|
|
886
|
-
status?: "completed" | "
|
|
1003
|
+
status?: "completed" | "active" | "upcoming" | undefined;
|
|
887
1004
|
};
|
|
888
1005
|
"cycle.delete": {
|
|
889
1006
|
cycleId: string;
|
|
@@ -1035,6 +1152,10 @@ type ActionWireOutputMap = {
|
|
|
1035
1152
|
parentTaskId: string | null;
|
|
1036
1153
|
dueDate: string | null;
|
|
1037
1154
|
startDate: string | null;
|
|
1155
|
+
approverId: string | null;
|
|
1156
|
+
approvalState: TaskApprovalStateValue;
|
|
1157
|
+
approvalRequestedAt: string | null;
|
|
1158
|
+
decidedAt: string | null;
|
|
1038
1159
|
sortOrder: number;
|
|
1039
1160
|
archivedAt: string | null;
|
|
1040
1161
|
createdAt: string;
|
|
@@ -1085,6 +1206,10 @@ type ActionWireOutputMap = {
|
|
|
1085
1206
|
parentTaskId: string | null;
|
|
1086
1207
|
dueDate: string | null;
|
|
1087
1208
|
startDate: string | null;
|
|
1209
|
+
approverId: string | null;
|
|
1210
|
+
approvalState: TaskApprovalStateValue;
|
|
1211
|
+
approvalRequestedAt: string | null;
|
|
1212
|
+
decidedAt: string | null;
|
|
1088
1213
|
sortOrder: number;
|
|
1089
1214
|
archivedAt: string | null;
|
|
1090
1215
|
createdAt: string;
|
|
@@ -1132,6 +1257,10 @@ type ActionWireOutputMap = {
|
|
|
1132
1257
|
parentTaskId: string | null;
|
|
1133
1258
|
dueDate: string | null;
|
|
1134
1259
|
startDate: string | null;
|
|
1260
|
+
approverId: string | null;
|
|
1261
|
+
approvalState: TaskApprovalStateValue;
|
|
1262
|
+
approvalRequestedAt: string | null;
|
|
1263
|
+
decidedAt: string | null;
|
|
1135
1264
|
sortOrder: number;
|
|
1136
1265
|
archivedAt: string | null;
|
|
1137
1266
|
createdAt: string;
|
|
@@ -1186,6 +1315,10 @@ type ActionWireOutputMap = {
|
|
|
1186
1315
|
parentTaskId: string | null;
|
|
1187
1316
|
dueDate: string | null;
|
|
1188
1317
|
startDate: string | null;
|
|
1318
|
+
approverId: string | null;
|
|
1319
|
+
approvalState: TaskApprovalStateValue;
|
|
1320
|
+
approvalRequestedAt: string | null;
|
|
1321
|
+
decidedAt: string | null;
|
|
1189
1322
|
sortOrder: number;
|
|
1190
1323
|
archivedAt: string | null;
|
|
1191
1324
|
createdAt: string;
|
|
@@ -1235,6 +1368,10 @@ type ActionWireOutputMap = {
|
|
|
1235
1368
|
parentTaskId: string | null;
|
|
1236
1369
|
dueDate: string | null;
|
|
1237
1370
|
startDate: string | null;
|
|
1371
|
+
approverId: string | null;
|
|
1372
|
+
approvalState: TaskApprovalStateValue;
|
|
1373
|
+
approvalRequestedAt: string | null;
|
|
1374
|
+
decidedAt: string | null;
|
|
1238
1375
|
sortOrder: number;
|
|
1239
1376
|
archivedAt: string | null;
|
|
1240
1377
|
createdAt: string;
|
|
@@ -1281,6 +1418,10 @@ type ActionWireOutputMap = {
|
|
|
1281
1418
|
parentTaskId: string | null;
|
|
1282
1419
|
dueDate: string | null;
|
|
1283
1420
|
startDate: string | null;
|
|
1421
|
+
approverId: string | null;
|
|
1422
|
+
approvalState: TaskApprovalStateValue;
|
|
1423
|
+
approvalRequestedAt: string | null;
|
|
1424
|
+
decidedAt: string | null;
|
|
1284
1425
|
sortOrder: number;
|
|
1285
1426
|
archivedAt: string | null;
|
|
1286
1427
|
createdAt: string;
|
|
@@ -1328,6 +1469,10 @@ type ActionWireOutputMap = {
|
|
|
1328
1469
|
parentTaskId: string | null;
|
|
1329
1470
|
dueDate: string | null;
|
|
1330
1471
|
startDate: string | null;
|
|
1472
|
+
approverId: string | null;
|
|
1473
|
+
approvalState: TaskApprovalStateValue;
|
|
1474
|
+
approvalRequestedAt: string | null;
|
|
1475
|
+
decidedAt: string | null;
|
|
1331
1476
|
sortOrder: number;
|
|
1332
1477
|
archivedAt: string | null;
|
|
1333
1478
|
createdAt: string;
|
|
@@ -1375,6 +1520,10 @@ type ActionWireOutputMap = {
|
|
|
1375
1520
|
parentTaskId: string | null;
|
|
1376
1521
|
dueDate: string | null;
|
|
1377
1522
|
startDate: string | null;
|
|
1523
|
+
approverId: string | null;
|
|
1524
|
+
approvalState: TaskApprovalStateValue;
|
|
1525
|
+
approvalRequestedAt: string | null;
|
|
1526
|
+
decidedAt: string | null;
|
|
1378
1527
|
sortOrder: number;
|
|
1379
1528
|
archivedAt: string | null;
|
|
1380
1529
|
createdAt: string;
|
|
@@ -1441,6 +1590,10 @@ type ActionWireOutputMap = {
|
|
|
1441
1590
|
parentTaskId: string | null;
|
|
1442
1591
|
dueDate: string | null;
|
|
1443
1592
|
startDate: string | null;
|
|
1593
|
+
approverId: string | null;
|
|
1594
|
+
approvalState: TaskApprovalStateValue;
|
|
1595
|
+
approvalRequestedAt: string | null;
|
|
1596
|
+
decidedAt: string | null;
|
|
1444
1597
|
sortOrder: number;
|
|
1445
1598
|
archivedAt: string | null;
|
|
1446
1599
|
createdAt: string;
|
|
@@ -1487,6 +1640,10 @@ type ActionWireOutputMap = {
|
|
|
1487
1640
|
parentTaskId: string | null;
|
|
1488
1641
|
dueDate: string | null;
|
|
1489
1642
|
startDate: string | null;
|
|
1643
|
+
approverId: string | null;
|
|
1644
|
+
approvalState: TaskApprovalStateValue;
|
|
1645
|
+
approvalRequestedAt: string | null;
|
|
1646
|
+
decidedAt: string | null;
|
|
1490
1647
|
sortOrder: number;
|
|
1491
1648
|
archivedAt: string | null;
|
|
1492
1649
|
createdAt: string;
|
|
@@ -1532,6 +1689,10 @@ type ActionWireOutputMap = {
|
|
|
1532
1689
|
parentTaskId: string | null;
|
|
1533
1690
|
dueDate: string | null;
|
|
1534
1691
|
startDate: string | null;
|
|
1692
|
+
approverId: string | null;
|
|
1693
|
+
approvalState: TaskApprovalStateValue;
|
|
1694
|
+
approvalRequestedAt: string | null;
|
|
1695
|
+
decidedAt: string | null;
|
|
1535
1696
|
sortOrder: number;
|
|
1536
1697
|
archivedAt: string | null;
|
|
1537
1698
|
createdAt: string;
|
|
@@ -1584,6 +1745,10 @@ type ActionWireOutputMap = {
|
|
|
1584
1745
|
parentTaskId: string | null;
|
|
1585
1746
|
dueDate: string | null;
|
|
1586
1747
|
startDate: string | null;
|
|
1748
|
+
approverId: string | null;
|
|
1749
|
+
approvalState: TaskApprovalStateValue;
|
|
1750
|
+
approvalRequestedAt: string | null;
|
|
1751
|
+
decidedAt: string | null;
|
|
1587
1752
|
sortOrder: number;
|
|
1588
1753
|
archivedAt: string | null;
|
|
1589
1754
|
createdAt: string;
|
|
@@ -1629,6 +1794,10 @@ type ActionWireOutputMap = {
|
|
|
1629
1794
|
parentTaskId: string | null;
|
|
1630
1795
|
dueDate: string | null;
|
|
1631
1796
|
startDate: string | null;
|
|
1797
|
+
approverId: string | null;
|
|
1798
|
+
approvalState: TaskApprovalStateValue;
|
|
1799
|
+
approvalRequestedAt: string | null;
|
|
1800
|
+
decidedAt: string | null;
|
|
1632
1801
|
sortOrder: number;
|
|
1633
1802
|
archivedAt: string | null;
|
|
1634
1803
|
createdAt: string;
|
|
@@ -1674,6 +1843,10 @@ type ActionWireOutputMap = {
|
|
|
1674
1843
|
parentTaskId: string | null;
|
|
1675
1844
|
dueDate: string | null;
|
|
1676
1845
|
startDate: string | null;
|
|
1846
|
+
approverId: string | null;
|
|
1847
|
+
approvalState: TaskApprovalStateValue;
|
|
1848
|
+
approvalRequestedAt: string | null;
|
|
1849
|
+
decidedAt: string | null;
|
|
1677
1850
|
sortOrder: number;
|
|
1678
1851
|
archivedAt: string | null;
|
|
1679
1852
|
createdAt: string;
|
|
@@ -1684,6 +1857,113 @@ type ActionWireOutputMap = {
|
|
|
1684
1857
|
previousMilestoneId: string | null;
|
|
1685
1858
|
effectiveAt: string;
|
|
1686
1859
|
};
|
|
1860
|
+
"task.requestApproval": {
|
|
1861
|
+
task: {
|
|
1862
|
+
id: string;
|
|
1863
|
+
teamId: string;
|
|
1864
|
+
number: number;
|
|
1865
|
+
title: string;
|
|
1866
|
+
description: string | null;
|
|
1867
|
+
descriptionDocument: {
|
|
1868
|
+
version: 1;
|
|
1869
|
+
content: {
|
|
1870
|
+
[x: string]: any;
|
|
1871
|
+
type?: string | undefined;
|
|
1872
|
+
attrs?: {
|
|
1873
|
+
[x: string]: any;
|
|
1874
|
+
} | undefined;
|
|
1875
|
+
content?: any[] | undefined;
|
|
1876
|
+
marks?: {
|
|
1877
|
+
[x: string]: any;
|
|
1878
|
+
type: string;
|
|
1879
|
+
attrs?: {
|
|
1880
|
+
[x: string]: any;
|
|
1881
|
+
} | undefined;
|
|
1882
|
+
}[] | undefined;
|
|
1883
|
+
text?: string | undefined;
|
|
1884
|
+
};
|
|
1885
|
+
} | null;
|
|
1886
|
+
statusId: string;
|
|
1887
|
+
priority: PriorityValue;
|
|
1888
|
+
estimateValue: number | null;
|
|
1889
|
+
estimateSettingsRevisionId: string | null;
|
|
1890
|
+
assigneeId: string | null;
|
|
1891
|
+
creatorId: string | null;
|
|
1892
|
+
projectId: string | null;
|
|
1893
|
+
cycleId: string | null;
|
|
1894
|
+
cycleAssignmentSource: "manual" | "automatic" | "carryover";
|
|
1895
|
+
milestoneId: string | null;
|
|
1896
|
+
parentTaskId: string | null;
|
|
1897
|
+
dueDate: string | null;
|
|
1898
|
+
startDate: string | null;
|
|
1899
|
+
approverId: string | null;
|
|
1900
|
+
approvalState: TaskApprovalStateValue;
|
|
1901
|
+
approvalRequestedAt: string | null;
|
|
1902
|
+
decidedAt: string | null;
|
|
1903
|
+
sortOrder: number;
|
|
1904
|
+
archivedAt: string | null;
|
|
1905
|
+
createdAt: string;
|
|
1906
|
+
updatedAt: string;
|
|
1907
|
+
};
|
|
1908
|
+
previousApproverId: string | null;
|
|
1909
|
+
previousApprovalState: TaskApprovalStateValue;
|
|
1910
|
+
};
|
|
1911
|
+
"task.decide": {
|
|
1912
|
+
task: {
|
|
1913
|
+
id: string;
|
|
1914
|
+
teamId: string;
|
|
1915
|
+
number: number;
|
|
1916
|
+
title: string;
|
|
1917
|
+
description: string | null;
|
|
1918
|
+
descriptionDocument: {
|
|
1919
|
+
version: 1;
|
|
1920
|
+
content: {
|
|
1921
|
+
[x: string]: any;
|
|
1922
|
+
type?: string | undefined;
|
|
1923
|
+
attrs?: {
|
|
1924
|
+
[x: string]: any;
|
|
1925
|
+
} | undefined;
|
|
1926
|
+
content?: any[] | undefined;
|
|
1927
|
+
marks?: {
|
|
1928
|
+
[x: string]: any;
|
|
1929
|
+
type: string;
|
|
1930
|
+
attrs?: {
|
|
1931
|
+
[x: string]: any;
|
|
1932
|
+
} | undefined;
|
|
1933
|
+
}[] | undefined;
|
|
1934
|
+
text?: string | undefined;
|
|
1935
|
+
};
|
|
1936
|
+
} | null;
|
|
1937
|
+
statusId: string;
|
|
1938
|
+
priority: PriorityValue;
|
|
1939
|
+
estimateValue: number | null;
|
|
1940
|
+
estimateSettingsRevisionId: string | null;
|
|
1941
|
+
assigneeId: string | null;
|
|
1942
|
+
creatorId: string | null;
|
|
1943
|
+
projectId: string | null;
|
|
1944
|
+
cycleId: string | null;
|
|
1945
|
+
cycleAssignmentSource: "manual" | "automatic" | "carryover";
|
|
1946
|
+
milestoneId: string | null;
|
|
1947
|
+
parentTaskId: string | null;
|
|
1948
|
+
dueDate: string | null;
|
|
1949
|
+
startDate: string | null;
|
|
1950
|
+
approverId: string | null;
|
|
1951
|
+
approvalState: TaskApprovalStateValue;
|
|
1952
|
+
approvalRequestedAt: string | null;
|
|
1953
|
+
decidedAt: string | null;
|
|
1954
|
+
sortOrder: number;
|
|
1955
|
+
archivedAt: string | null;
|
|
1956
|
+
createdAt: string;
|
|
1957
|
+
updatedAt: string;
|
|
1958
|
+
};
|
|
1959
|
+
previousApprovalState: TaskApprovalStateValue;
|
|
1960
|
+
statusMove: {
|
|
1961
|
+
previousStatusId: string;
|
|
1962
|
+
previousStatusCategory: StatusCategoryValue;
|
|
1963
|
+
statusCategory: StatusCategoryValue;
|
|
1964
|
+
effectiveAt: string;
|
|
1965
|
+
} | null;
|
|
1966
|
+
};
|
|
1687
1967
|
"task.addLabel": {
|
|
1688
1968
|
taskId: string;
|
|
1689
1969
|
labelId: string;
|
|
@@ -1733,6 +2013,10 @@ type ActionWireOutputMap = {
|
|
|
1733
2013
|
parentTaskId: string | null;
|
|
1734
2014
|
dueDate: string | null;
|
|
1735
2015
|
startDate: string | null;
|
|
2016
|
+
approverId: string | null;
|
|
2017
|
+
approvalState: TaskApprovalStateValue;
|
|
2018
|
+
approvalRequestedAt: string | null;
|
|
2019
|
+
decidedAt: string | null;
|
|
1736
2020
|
sortOrder: number;
|
|
1737
2021
|
archivedAt: string | null;
|
|
1738
2022
|
createdAt: string;
|
|
@@ -1780,6 +2064,10 @@ type ActionWireOutputMap = {
|
|
|
1780
2064
|
parentTaskId: string | null;
|
|
1781
2065
|
dueDate: string | null;
|
|
1782
2066
|
startDate: string | null;
|
|
2067
|
+
approverId: string | null;
|
|
2068
|
+
approvalState: TaskApprovalStateValue;
|
|
2069
|
+
approvalRequestedAt: string | null;
|
|
2070
|
+
decidedAt: string | null;
|
|
1783
2071
|
sortOrder: number;
|
|
1784
2072
|
archivedAt: string | null;
|
|
1785
2073
|
createdAt: string;
|
|
@@ -1978,6 +2266,108 @@ type ActionWireOutputMap = {
|
|
|
1978
2266
|
updatedAt: string;
|
|
1979
2267
|
};
|
|
1980
2268
|
};
|
|
2269
|
+
"project.star": {
|
|
2270
|
+
projectId: string;
|
|
2271
|
+
starred: boolean;
|
|
2272
|
+
};
|
|
2273
|
+
"project.unstar": {
|
|
2274
|
+
projectId: string;
|
|
2275
|
+
starred: boolean;
|
|
2276
|
+
};
|
|
2277
|
+
"initiative.create": {
|
|
2278
|
+
initiative: {
|
|
2279
|
+
id: string;
|
|
2280
|
+
workspaceId: string;
|
|
2281
|
+
name: string;
|
|
2282
|
+
status: InitiativeStatusValue;
|
|
2283
|
+
ownerMemberId: string | null;
|
|
2284
|
+
createdAt: string;
|
|
2285
|
+
updatedAt: string;
|
|
2286
|
+
};
|
|
2287
|
+
};
|
|
2288
|
+
"initiative.update": {
|
|
2289
|
+
initiative: {
|
|
2290
|
+
id: string;
|
|
2291
|
+
workspaceId: string;
|
|
2292
|
+
name: string;
|
|
2293
|
+
status: InitiativeStatusValue;
|
|
2294
|
+
ownerMemberId: string | null;
|
|
2295
|
+
createdAt: string;
|
|
2296
|
+
updatedAt: string;
|
|
2297
|
+
};
|
|
2298
|
+
};
|
|
2299
|
+
"initiative.delete": {
|
|
2300
|
+
initiativeId: string;
|
|
2301
|
+
};
|
|
2302
|
+
"initiative.linkProject": {
|
|
2303
|
+
initiative: {
|
|
2304
|
+
id: string;
|
|
2305
|
+
workspaceId: string;
|
|
2306
|
+
name: string;
|
|
2307
|
+
status: InitiativeStatusValue;
|
|
2308
|
+
ownerMemberId: string | null;
|
|
2309
|
+
createdAt: string;
|
|
2310
|
+
updatedAt: string;
|
|
2311
|
+
};
|
|
2312
|
+
projectId: string;
|
|
2313
|
+
linked: boolean;
|
|
2314
|
+
};
|
|
2315
|
+
"initiative.unlinkProject": {
|
|
2316
|
+
initiative: {
|
|
2317
|
+
id: string;
|
|
2318
|
+
workspaceId: string;
|
|
2319
|
+
name: string;
|
|
2320
|
+
status: InitiativeStatusValue;
|
|
2321
|
+
ownerMemberId: string | null;
|
|
2322
|
+
createdAt: string;
|
|
2323
|
+
updatedAt: string;
|
|
2324
|
+
};
|
|
2325
|
+
projectId: string;
|
|
2326
|
+
unlinked: boolean;
|
|
2327
|
+
};
|
|
2328
|
+
"projectUpdate.create": {
|
|
2329
|
+
update: {
|
|
2330
|
+
id: string;
|
|
2331
|
+
projectId: string;
|
|
2332
|
+
health: "on_track" | "at_risk" | "off_track";
|
|
2333
|
+
body: string;
|
|
2334
|
+
authorMemberId: string | null;
|
|
2335
|
+
actorType: "user" | "agent" | "system";
|
|
2336
|
+
sentAt: string | null;
|
|
2337
|
+
createdAt: string;
|
|
2338
|
+
updatedAt: string;
|
|
2339
|
+
};
|
|
2340
|
+
};
|
|
2341
|
+
"projectUpdate.update": {
|
|
2342
|
+
update: {
|
|
2343
|
+
id: string;
|
|
2344
|
+
projectId: string;
|
|
2345
|
+
health: "on_track" | "at_risk" | "off_track";
|
|
2346
|
+
body: string;
|
|
2347
|
+
authorMemberId: string | null;
|
|
2348
|
+
actorType: "user" | "agent" | "system";
|
|
2349
|
+
sentAt: string | null;
|
|
2350
|
+
createdAt: string;
|
|
2351
|
+
updatedAt: string;
|
|
2352
|
+
};
|
|
2353
|
+
};
|
|
2354
|
+
"projectUpdate.send": {
|
|
2355
|
+
update: {
|
|
2356
|
+
id: string;
|
|
2357
|
+
projectId: string;
|
|
2358
|
+
health: "on_track" | "at_risk" | "off_track";
|
|
2359
|
+
body: string;
|
|
2360
|
+
authorMemberId: string | null;
|
|
2361
|
+
actorType: "user" | "agent" | "system";
|
|
2362
|
+
sentAt: string | null;
|
|
2363
|
+
createdAt: string;
|
|
2364
|
+
updatedAt: string;
|
|
2365
|
+
};
|
|
2366
|
+
};
|
|
2367
|
+
"projectUpdate.delete": {
|
|
2368
|
+
deletedUpdateId: string;
|
|
2369
|
+
projectId: string;
|
|
2370
|
+
};
|
|
1981
2371
|
"milestone.create": {
|
|
1982
2372
|
milestone: {
|
|
1983
2373
|
id: string;
|
|
@@ -2060,7 +2450,7 @@ type ActionWireOutputMap = {
|
|
|
2060
2450
|
source: "legacy" | "generated" | "override";
|
|
2061
2451
|
cadenceRevisionId: string | null;
|
|
2062
2452
|
cadenceSequence: number | null;
|
|
2063
|
-
status: "completed" | "
|
|
2453
|
+
status: "completed" | "active" | "upcoming";
|
|
2064
2454
|
startedAt: string | null;
|
|
2065
2455
|
reportMode: "count" | "effort" | null;
|
|
2066
2456
|
estimateSettingsRevisionId: string | null;
|
|
@@ -2093,7 +2483,7 @@ type ActionWireOutputMap = {
|
|
|
2093
2483
|
source: "legacy" | "generated" | "override";
|
|
2094
2484
|
cadenceRevisionId: string | null;
|
|
2095
2485
|
cadenceSequence: number | null;
|
|
2096
|
-
status: "completed" | "
|
|
2486
|
+
status: "completed" | "active" | "upcoming";
|
|
2097
2487
|
startedAt: string | null;
|
|
2098
2488
|
reportMode: "count" | "effort" | null;
|
|
2099
2489
|
estimateSettingsRevisionId: string | null;
|
|
@@ -2122,7 +2512,7 @@ type ActionWireOutputMap = {
|
|
|
2122
2512
|
source: "legacy" | "generated" | "override";
|
|
2123
2513
|
cadenceRevisionId: string | null;
|
|
2124
2514
|
cadenceSequence: number | null;
|
|
2125
|
-
status: "completed" | "
|
|
2515
|
+
status: "completed" | "active" | "upcoming";
|
|
2126
2516
|
startedAt: string | null;
|
|
2127
2517
|
reportMode: "count" | "effort" | null;
|
|
2128
2518
|
estimateSettingsRevisionId: string | null;
|
|
@@ -2331,7 +2721,7 @@ type ActionWireOutputMap = {
|
|
|
2331
2721
|
source: "legacy" | "generated" | "override";
|
|
2332
2722
|
cadenceRevisionId: string | null;
|
|
2333
2723
|
cadenceSequence: number | null;
|
|
2334
|
-
status: "completed" | "
|
|
2724
|
+
status: "completed" | "active" | "upcoming";
|
|
2335
2725
|
startedAt: string | null;
|
|
2336
2726
|
reportMode: "count" | "effort" | null;
|
|
2337
2727
|
estimateSettingsRevisionId: string | null;
|
|
@@ -2360,7 +2750,7 @@ type ActionWireOutputMap = {
|
|
|
2360
2750
|
source: "legacy" | "generated" | "override";
|
|
2361
2751
|
cadenceRevisionId: string | null;
|
|
2362
2752
|
cadenceSequence: number | null;
|
|
2363
|
-
status: "completed" | "
|
|
2753
|
+
status: "completed" | "active" | "upcoming";
|
|
2364
2754
|
startedAt: string | null;
|
|
2365
2755
|
reportMode: "count" | "effort" | null;
|
|
2366
2756
|
estimateSettingsRevisionId: string | null;
|
|
@@ -2389,7 +2779,7 @@ type ActionWireOutputMap = {
|
|
|
2389
2779
|
source: "legacy" | "generated" | "override";
|
|
2390
2780
|
cadenceRevisionId: string | null;
|
|
2391
2781
|
cadenceSequence: number | null;
|
|
2392
|
-
status: "completed" | "
|
|
2782
|
+
status: "completed" | "active" | "upcoming";
|
|
2393
2783
|
startedAt: string | null;
|
|
2394
2784
|
reportMode: "count" | "effort" | null;
|
|
2395
2785
|
estimateSettingsRevisionId: string | null;
|
|
@@ -2625,6 +3015,10 @@ type TaskRecord = {
|
|
|
2625
3015
|
parentTaskId: string | null;
|
|
2626
3016
|
dueDate: string | null;
|
|
2627
3017
|
startDate: string | null;
|
|
3018
|
+
approverId: string | null;
|
|
3019
|
+
approvalState: TaskApprovalStateValue;
|
|
3020
|
+
approvalRequestedAt: Date | null;
|
|
3021
|
+
decidedAt: Date | null;
|
|
2628
3022
|
sortOrder: number;
|
|
2629
3023
|
archivedAt: Date | null;
|
|
2630
3024
|
createdAt: Date;
|
|
@@ -2643,6 +3037,16 @@ type ProjectRecord = {
|
|
|
2643
3037
|
createdAt: Date;
|
|
2644
3038
|
updatedAt: Date;
|
|
2645
3039
|
};
|
|
3040
|
+
type InitiativeStatusValue = "active" | "archived";
|
|
3041
|
+
type InitiativeRecord = {
|
|
3042
|
+
id: string;
|
|
3043
|
+
workspaceId: string;
|
|
3044
|
+
name: string;
|
|
3045
|
+
status: InitiativeStatusValue;
|
|
3046
|
+
ownerMemberId: string | null;
|
|
3047
|
+
createdAt: Date;
|
|
3048
|
+
updatedAt: Date;
|
|
3049
|
+
};
|
|
2646
3050
|
type CycleRecord = {
|
|
2647
3051
|
id: string;
|
|
2648
3052
|
teamId: string;
|
|
@@ -2654,7 +3058,7 @@ type CycleRecord = {
|
|
|
2654
3058
|
source: "legacy" | "generated" | "override";
|
|
2655
3059
|
cadenceRevisionId: string | null;
|
|
2656
3060
|
cadenceSequence: number | null;
|
|
2657
|
-
status: "completed" | "
|
|
3061
|
+
status: "completed" | "active" | "upcoming";
|
|
2658
3062
|
startedAt: Date | null;
|
|
2659
3063
|
reportMode: "count" | "effort" | null;
|
|
2660
3064
|
estimateSettingsRevisionId: string | null;
|
|
@@ -2743,6 +3147,7 @@ type AgentPolicyRecord = {
|
|
|
2743
3147
|
};
|
|
2744
3148
|
type PriorityValue = "urgent" | "high" | "medium" | "low" | "none";
|
|
2745
3149
|
type StatusCategoryValue = "backlog" | "completed" | "cancelled" | "unstarted" | "started";
|
|
3150
|
+
type TaskApprovalStateValue = "none" | "requested" | "approved" | "changes_requested" | "rejected";
|
|
2746
3151
|
|
|
2747
3152
|
/**
|
|
2748
3153
|
* Token prefixes, duplicated from `@tasq/contracts/agents`.
|
|
@@ -2812,10 +3217,56 @@ declare class TasqClient {
|
|
|
2812
3217
|
readonly tasks: {
|
|
2813
3218
|
list: (slug: string, filters?: TaskListFilters) => Promise<TaskListItem[]>;
|
|
2814
3219
|
get: (slug: string, taskId: string) => Promise<TaskDetail>;
|
|
3220
|
+
/**
|
|
3221
|
+
* Ask a person to sign off on a task (6.3). Asking again while a
|
|
3222
|
+
* request stands replaces the approver. The approver cannot be an agent.
|
|
3223
|
+
*/
|
|
3224
|
+
requestApproval: (slug: string, taskId: string, approverId: string) => Promise<DispatchResponse<"task.requestApproval">>;
|
|
3225
|
+
/**
|
|
3226
|
+
* The approver's answer (6.3). `approve` also moves the task to the next
|
|
3227
|
+
* status in its team's category order. Person credentials only: no
|
|
3228
|
+
* agent policy can include it.
|
|
3229
|
+
*/
|
|
3230
|
+
decide: (slug: string, taskId: string, decision: TaskApprovalDecision) => Promise<DispatchResponse<"task.decide">>;
|
|
2815
3231
|
};
|
|
2816
3232
|
readonly projects: {
|
|
2817
3233
|
list: (slug: string) => Promise<ProjectListItem[]>;
|
|
2818
3234
|
get: (slug: string, projectId: string) => Promise<ProjectDetail>;
|
|
3235
|
+
/**
|
|
3236
|
+
* Pin a project to the caller's own sidebar. People only: an agent
|
|
3237
|
+
* key is refused by policy whatever its preset.
|
|
3238
|
+
*/
|
|
3239
|
+
star: (slug: string, input: ActionInputMap["project.star"]) => Promise<DispatchResponse<"project.star">>;
|
|
3240
|
+
unstar: (slug: string, input: ActionInputMap["project.unstar"]) => Promise<DispatchResponse<"project.unstar">>;
|
|
3241
|
+
};
|
|
3242
|
+
/**
|
|
3243
|
+
* Initiatives group projects across teams. Any member reads them; every
|
|
3244
|
+
* write is admin-level, so an agent key (always a member) cannot make one.
|
|
3245
|
+
*/
|
|
3246
|
+
readonly initiatives: {
|
|
3247
|
+
list: (slug: string) => Promise<InitiativeListItem[]>;
|
|
3248
|
+
create: (slug: string, input: ActionInputMap["initiative.create"]) => Promise<DispatchResponse<"initiative.create">>;
|
|
3249
|
+
update: (slug: string, input: ActionInputMap["initiative.update"]) => Promise<DispatchResponse<"initiative.update">>;
|
|
3250
|
+
delete: (slug: string, input: ActionInputMap["initiative.delete"]) => Promise<DispatchResponse<"initiative.delete">>;
|
|
3251
|
+
linkProject: (slug: string, input: ActionInputMap["initiative.linkProject"]) => Promise<DispatchResponse<"initiative.linkProject">>;
|
|
3252
|
+
unlinkProject: (slug: string, input: ActionInputMap["initiative.unlinkProject"]) => Promise<DispatchResponse<"initiative.unlinkProject">>;
|
|
3253
|
+
};
|
|
3254
|
+
/**
|
|
3255
|
+
* Project updates: a health call and a body for the project's client (7.5).
|
|
3256
|
+
*
|
|
3257
|
+
* `draft` is what an agent calls; an agent's update is always a draft
|
|
3258
|
+
* whatever it passes. `send` is people only: no agent policy can grant it,
|
|
3259
|
+
* because nothing an agent drafts goes to a client without a person
|
|
3260
|
+
* approving it.
|
|
3261
|
+
*/
|
|
3262
|
+
readonly projectUpdates: {
|
|
3263
|
+
/** Every update on the project, drafts included, newest first. */
|
|
3264
|
+
list: (slug: string, projectId: string) => Promise<ProjectUpdateListItem[]>;
|
|
3265
|
+
draft: (slug: string, input: Omit<ActionInputMap["projectUpdate.create"], "send">) => Promise<DispatchResponse<"projectUpdate.create">>;
|
|
3266
|
+
create: (slug: string, input: ActionInputMap["projectUpdate.create"]) => Promise<DispatchResponse<"projectUpdate.create">>;
|
|
3267
|
+
update: (slug: string, input: ActionInputMap["projectUpdate.update"]) => Promise<DispatchResponse<"projectUpdate.update">>;
|
|
3268
|
+
send: (slug: string, input: ActionInputMap["projectUpdate.send"]) => Promise<DispatchResponse<"projectUpdate.send">>;
|
|
3269
|
+
delete: (slug: string, input: ActionInputMap["projectUpdate.delete"]) => Promise<DispatchResponse<"projectUpdate.delete">>;
|
|
2819
3270
|
};
|
|
2820
3271
|
readonly threads: {
|
|
2821
3272
|
/**
|
|
@@ -2952,4 +3403,4 @@ declare class TasqPolicyDeniedError extends TasqApiError {
|
|
|
2952
3403
|
constructor(status: number, body: ErrorBody);
|
|
2953
3404
|
}
|
|
2954
3405
|
|
|
2955
|
-
export { AGENT_ISOLATION_VALUES, AGENT_KEY_PREFIX, type ActionInputMap, type ActionName, type ActionWireOutputMap, type AgentEvent, type AgentEventsQuery, type AgentEventsResponse, type AgentIsolation, type AgentPolicyDetail, type AgentPolicyRecord, type AgentRecord, type CliTokenIssued, type CommentRecord, type CurrentUser, type CycleListFilters, type CycleListItem, type CycleRecord, type DispatchResponse, type LabelListItem, type LabelRecord, MAX_AGENT_WAKES_PER_MESSAGE, MAX_CONSECUTIVE_AGENT_MESSAGES, type MentionActorRef, type NotificationItem, type NotificationsResponse, type PriorityValue, type ProjectDetail, type ProjectListItem, type ProjectRecord, RELEASE_CONTEXT_TASK_LIMIT, RELEASE_DISPOSITIONS, RELEASE_NARRATIVE_EXCERPT_MAX, RELEASE_NARRATIVE_MAX, type Release, type ReleaseContext, type ReleaseCounts, type ReleaseDiff, type ReleaseDisposition, type ReleaseNarrativeAuthor, type ReleasePreviousSummary, type ReleaseSummary, type ReleaseTask, SUPPRESSED_REASONS, type StatusCategory, type StatusCategoryValue, type SuppressedReason, THREAD_CONTEXT_ACTIVITY_LIMIT, THREAD_CONTEXT_DESCRIPTION_MAX, THREAD_CONTEXT_MESSAGE_LIMIT, type TaskComment, type TaskDetail, type TaskListFilters, type TaskListItem, type TaskRecord, TasqApiError, type TasqAuth, TasqClient, type TasqClientOptions, TasqPolicyDeniedError, TasqRateLimitError, type TasqRequestOptions, TasqValidationError, type TasqValidationIssue, type TeamAgentSettingsRecord, type TeamAgentSettingsResponse, type TeamDetail, type TeamListItem, type TeamRecord, type TeamStatus, type ThreadContext, type ThreadContextActivity, type ThreadContextEntity, type ThreadContextMessage, type ThreadContextParticipant, USER_TOKEN_PREFIX, type WakeOutcome, type WorkspaceDetail, type WorkspaceMemberListItem, type WorkspaceSummary };
|
|
3406
|
+
export { AGENT_ISOLATION_VALUES, AGENT_KEY_PREFIX, type ActionInputMap, type ActionName, type ActionWireOutputMap, type AgentEvent, type AgentEventsQuery, type AgentEventsResponse, type AgentIsolation, type AgentPolicyDetail, type AgentPolicyRecord, type AgentRecord, type CliTokenIssued, type CommentRecord, type CurrentUser, type CycleListFilters, type CycleListItem, type CycleRecord, type DispatchResponse, type InitiativeListItem, type InitiativeRecord, type InitiativeRef, type InitiativeStatus, type InitiativeStatusValue, type LabelListItem, type LabelRecord, MAX_AGENT_WAKES_PER_MESSAGE, MAX_CONSECUTIVE_AGENT_MESSAGES, type MentionActorRef, type NotificationItem, type NotificationsResponse, PROJECT_HEALTH_VALUES, type PriorityValue, type ProjectDetail, type ProjectHealth, type ProjectListItem, type ProjectRecord, type ProjectUpdateAuthor, type ProjectUpdateListItem, RELEASE_CONTEXT_TASK_LIMIT, RELEASE_DISPOSITIONS, RELEASE_NARRATIVE_EXCERPT_MAX, RELEASE_NARRATIVE_MAX, type Release, type ReleaseContext, type ReleaseCounts, type ReleaseDiff, type ReleaseDisposition, type ReleaseNarrativeAuthor, type ReleasePreviousSummary, type ReleaseSummary, type ReleaseTask, SUPPRESSED_REASONS, type StatusCategory, type StatusCategoryValue, type SuppressedReason, THREAD_CONTEXT_ACTIVITY_LIMIT, THREAD_CONTEXT_DESCRIPTION_MAX, THREAD_CONTEXT_MESSAGE_LIMIT, type TaskApproval, type TaskApprovalDecision, type TaskComment, type TaskDetail, type TaskListFilters, type TaskListItem, type TaskRecord, TasqApiError, type TasqAuth, TasqClient, type TasqClientOptions, TasqPolicyDeniedError, TasqRateLimitError, type TasqRequestOptions, TasqValidationError, type TasqValidationIssue, type TeamAgentSettingsRecord, type TeamAgentSettingsResponse, type TeamDetail, type TeamListItem, type TeamRecord, type TeamStatus, type ThreadContext, type ThreadContextActivity, type ThreadContextEntity, type ThreadContextMessage, type ThreadContextParticipant, USER_TOKEN_PREFIX, type WakeOutcome, type WorkspaceDetail, type WorkspaceMemberListItem, type WorkspaceSummary };
|
package/dist/index.js
CHANGED
|
@@ -214,7 +214,18 @@ var TasqClient = class _TasqClient {
|
|
|
214
214
|
)).tasks,
|
|
215
215
|
get: async (slug, taskId) => (await this.#get(
|
|
216
216
|
`/workspaces/${encodeURIComponent(slug)}/tasks/${encodeURIComponent(taskId)}`
|
|
217
|
-
)).task
|
|
217
|
+
)).task,
|
|
218
|
+
/**
|
|
219
|
+
* Ask a person to sign off on a task (6.3). Asking again while a
|
|
220
|
+
* request stands replaces the approver. The approver cannot be an agent.
|
|
221
|
+
*/
|
|
222
|
+
requestApproval: (slug, taskId, approverId) => this.dispatch("task.requestApproval", slug, { taskId, approverId }),
|
|
223
|
+
/**
|
|
224
|
+
* The approver's answer (6.3). `approve` also moves the task to the next
|
|
225
|
+
* status in its team's category order. Person credentials only: no
|
|
226
|
+
* agent policy can include it.
|
|
227
|
+
*/
|
|
228
|
+
decide: (slug, taskId, decision) => this.dispatch("task.decide", slug, { taskId, decision })
|
|
218
229
|
};
|
|
219
230
|
projects = {
|
|
220
231
|
list: async (slug) => (await this.#get(
|
|
@@ -222,7 +233,46 @@ var TasqClient = class _TasqClient {
|
|
|
222
233
|
)).projects,
|
|
223
234
|
get: async (slug, projectId) => (await this.#get(
|
|
224
235
|
`/workspaces/${encodeURIComponent(slug)}/projects/${encodeURIComponent(projectId)}`
|
|
225
|
-
)).project
|
|
236
|
+
)).project,
|
|
237
|
+
/**
|
|
238
|
+
* Pin a project to the caller's own sidebar. People only: an agent
|
|
239
|
+
* key is refused by policy whatever its preset.
|
|
240
|
+
*/
|
|
241
|
+
star: (slug, input) => this.dispatch("project.star", slug, input),
|
|
242
|
+
unstar: (slug, input) => this.dispatch("project.unstar", slug, input)
|
|
243
|
+
};
|
|
244
|
+
/**
|
|
245
|
+
* Initiatives group projects across teams. Any member reads them; every
|
|
246
|
+
* write is admin-level, so an agent key (always a member) cannot make one.
|
|
247
|
+
*/
|
|
248
|
+
initiatives = {
|
|
249
|
+
list: async (slug) => (await this.#get(
|
|
250
|
+
`/workspaces/${encodeURIComponent(slug)}/initiatives`
|
|
251
|
+
)).initiatives,
|
|
252
|
+
create: (slug, input) => this.dispatch("initiative.create", slug, input),
|
|
253
|
+
update: (slug, input) => this.dispatch("initiative.update", slug, input),
|
|
254
|
+
delete: (slug, input) => this.dispatch("initiative.delete", slug, input),
|
|
255
|
+
linkProject: (slug, input) => this.dispatch("initiative.linkProject", slug, input),
|
|
256
|
+
unlinkProject: (slug, input) => this.dispatch("initiative.unlinkProject", slug, input)
|
|
257
|
+
};
|
|
258
|
+
/**
|
|
259
|
+
* Project updates: a health call and a body for the project's client (7.5).
|
|
260
|
+
*
|
|
261
|
+
* `draft` is what an agent calls; an agent's update is always a draft
|
|
262
|
+
* whatever it passes. `send` is people only: no agent policy can grant it,
|
|
263
|
+
* because nothing an agent drafts goes to a client without a person
|
|
264
|
+
* approving it.
|
|
265
|
+
*/
|
|
266
|
+
projectUpdates = {
|
|
267
|
+
/** Every update on the project, drafts included, newest first. */
|
|
268
|
+
list: async (slug, projectId) => (await this.#get(
|
|
269
|
+
`/workspaces/${encodeURIComponent(slug)}/projects/${encodeURIComponent(projectId)}/updates`
|
|
270
|
+
)).updates,
|
|
271
|
+
draft: (slug, input) => this.dispatch("projectUpdate.create", slug, input),
|
|
272
|
+
create: (slug, input) => this.dispatch("projectUpdate.create", slug, input),
|
|
273
|
+
update: (slug, input) => this.dispatch("projectUpdate.update", slug, input),
|
|
274
|
+
send: (slug, input) => this.dispatch("projectUpdate.send", slug, input),
|
|
275
|
+
delete: (slug, input) => this.dispatch("projectUpdate.delete", slug, input)
|
|
226
276
|
};
|
|
227
277
|
threads = {
|
|
228
278
|
/**
|
|
@@ -369,6 +419,11 @@ var TasqClient = class _TasqClient {
|
|
|
369
419
|
};
|
|
370
420
|
|
|
371
421
|
// src/types.ts
|
|
422
|
+
var PROJECT_HEALTH_VALUES = [
|
|
423
|
+
"on_track",
|
|
424
|
+
"at_risk",
|
|
425
|
+
"off_track"
|
|
426
|
+
];
|
|
372
427
|
var THREAD_CONTEXT_MESSAGE_LIMIT = 50;
|
|
373
428
|
var THREAD_CONTEXT_ACTIVITY_LIMIT = 20;
|
|
374
429
|
var THREAD_CONTEXT_DESCRIPTION_MAX = 8e3;
|
|
@@ -393,6 +448,7 @@ export {
|
|
|
393
448
|
AGENT_KEY_PREFIX,
|
|
394
449
|
MAX_AGENT_WAKES_PER_MESSAGE,
|
|
395
450
|
MAX_CONSECUTIVE_AGENT_MESSAGES,
|
|
451
|
+
PROJECT_HEALTH_VALUES,
|
|
396
452
|
RELEASE_CONTEXT_TASK_LIMIT,
|
|
397
453
|
RELEASE_DISPOSITIONS,
|
|
398
454
|
RELEASE_NARRATIVE_EXCERPT_MAX,
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/prefixes.ts","../src/errors.ts","../src/client.ts","../src/types.ts"],"sourcesContent":["/**\n * Token prefixes, duplicated from `@tasq/contracts/agents`.\n *\n * They are re-declared here rather than re-exported because contracts is\n * private: tsup's dts bundler leaves a `@tasq/contracts/agents` import in the\n * emitted `.d.ts`, which a published consumer cannot resolve.\n * `src/prefixes.equality.ts` asserts these stay in step with contracts.\n */\n\n/** Plaintext prefix of an agent API key. */\nexport const AGENT_KEY_PREFIX = \"tq_ag_\";\n\n/** Plaintext prefix of a user (CLI) token. */\nexport const USER_TOKEN_PREFIX = \"tq_us_\";\n","/** Shape of the API's error envelope: `{ error: { code, message, details? } }`. */\ntype ErrorBody = {\n\tcode: string;\n\tmessage: string;\n\tdetails?: unknown;\n};\n\n/** Every failure the client raises for a non-2xx response. */\nexport class TasqApiError extends Error {\n\treadonly code: string;\n\treadonly status: number;\n\treadonly details: unknown;\n\n\tconstructor(status: number, body: ErrorBody) {\n\t\tsuper(body.message);\n\t\tthis.name = \"TasqApiError\";\n\t\tthis.code = body.code;\n\t\tthis.status = status;\n\t\tthis.details = body.details;\n\t}\n}\n\ntype RateLimitDetails = {\n\tlimit?: number;\n\tremaining?: number;\n\tresetAt?: string;\n};\n\n/** A `429 RATE_LIMITED`. `retryAfterSeconds` is never negative. */\nexport class TasqRateLimitError extends TasqApiError {\n\treadonly retryAfterSeconds: number;\n\treadonly resetAt: Date | undefined;\n\treadonly limit: number | undefined;\n\treadonly remaining: number | undefined;\n\n\tconstructor(status: number, body: ErrorBody, retryAfterHeader: string | null) {\n\t\tsuper(status, body);\n\t\tthis.name = \"TasqRateLimitError\";\n\n\t\tconst details = (body.details ?? {}) as RateLimitDetails;\n\n\t\tthis.limit = details.limit;\n\t\tthis.remaining = details.remaining;\n\t\tthis.resetAt =\n\t\t\tdetails.resetAt === undefined ? undefined : new Date(details.resetAt);\n\n\t\tconst fromHeader = Number(retryAfterHeader);\n\n\t\tif (retryAfterHeader !== null && Number.isFinite(fromHeader)) {\n\t\t\tthis.retryAfterSeconds = Math.max(0, fromHeader);\n\t\t} else if (this.resetAt !== undefined) {\n\t\t\tconst ms = this.resetAt.getTime() - Date.now();\n\n\t\t\tthis.retryAfterSeconds = Math.max(0, Math.ceil(ms / 1000));\n\t\t} else {\n\t\t\tthis.retryAfterSeconds = 0;\n\t\t}\n\t}\n}\n\nexport type TasqValidationIssue = {\n\tpath: (string | number)[];\n\tmessage: string;\n};\n\n/** A `400 VALIDATION_ERROR`. `issues` mirrors the API's Zod issue list. */\nexport class TasqValidationError extends TasqApiError {\n\treadonly issues: TasqValidationIssue[];\n\n\tconstructor(status: number, body: ErrorBody) {\n\t\tsuper(status, body);\n\t\tthis.name = \"TasqValidationError\";\n\t\tthis.issues = Array.isArray(body.details)\n\t\t\t? (body.details as TasqValidationIssue[])\n\t\t\t: [];\n\t}\n}\n\n/** A `403 AGENT_ACTION_DENIED`: the agent's policy does not allow the action. */\nexport class TasqPolicyDeniedError extends TasqApiError {\n\t/** The rejected action name, when the API reported one. */\n\treadonly action: string | undefined;\n\t/** The policy version quoted in the message, when the API quoted one. */\n\treadonly policyVersion: number | undefined;\n\n\tconstructor(status: number, body: ErrorBody) {\n\t\tsuper(status, body);\n\t\tthis.name = \"TasqPolicyDeniedError\";\n\t\tthis.action = actionFromDetails(body.details);\n\t\tthis.policyVersion = policyVersionFromMessage(body.message);\n\t}\n}\n\nfunction actionFromDetails(details: ErrorBody[\"details\"]): string | undefined {\n\tif (!Array.isArray(details)) return undefined;\n\n\tconst issues = details as TasqValidationIssue[];\n\n\tfor (const issue of issues) {\n\t\tif (issue.path[0] === \"action\") return issue.message;\n\t}\n\n\treturn undefined;\n}\n\nfunction policyVersionFromMessage(message: string): number | undefined {\n\tconst match = /policy v(?:ersion )?(\\d+)/i.exec(message);\n\n\tif (!match?.[1]) return undefined;\n\n\treturn Number(match[1]);\n}\n\n/**\n * Raised before any request when the client has no credential but the called\n * method needs one. Shaped like an API error so callers map it uniformly.\n */\nexport function noCredentialError(): TasqApiError {\n\treturn new TasqApiError(0, {\n\t\tcode: \"NO_CREDENTIAL\",\n\t\tmessage:\n\t\t\t\"No credential configured. Run `tasq auth login`, or set TASQ_API_KEY.\",\n\t});\n}\n\n/** Build the right error subclass for a failed response. */\nexport function toTasqError(\n\tstatus: number,\n\tbody: ErrorBody,\n\tretryAfterHeader: string | null,\n): TasqApiError {\n\tif (status === 429 || body.code === \"RATE_LIMITED\") {\n\t\treturn new TasqRateLimitError(status, body, retryAfterHeader);\n\t}\n\n\tif (body.code === \"VALIDATION_ERROR\") {\n\t\treturn new TasqValidationError(status, body);\n\t}\n\n\tif (body.code === \"AGENT_ACTION_DENIED\") {\n\t\treturn new TasqPolicyDeniedError(status, body);\n\t}\n\n\treturn new TasqApiError(status, body);\n}\n","import type {\n\tActionInputMap,\n\tActionName,\n\tDispatchResponse,\n} from \"./contracts\";\nimport { AGENT_KEY_PREFIX, USER_TOKEN_PREFIX } from \"./prefixes\";\nimport { noCredentialError, type TasqApiError, toTasqError } from \"./errors\";\nimport type {\n\tAgentPolicyDetail,\n\tCliTokenIssued,\n\tCurrentUser,\n\tCycleListFilters,\n\tCycleListItem,\n\tLabelListItem,\n\tProjectDetail,\n\tProjectListItem,\n\tRelease,\n\tReleaseContext,\n\tReleaseDiff,\n\tReleaseSummary,\n\tTaskDetail,\n\tTaskListFilters,\n\tTaskListItem,\n\tThreadContext,\n\tAgentEventsResponse,\n\tNotificationsResponse,\n\tTeamAgentSettingsResponse,\n\tTeamDetail,\n\tTeamListItem,\n\tWorkspaceDetail,\n\tWorkspaceMemberListItem,\n\tWorkspaceSummary,\n} from \"./types\";\n\n/** Either an agent key (`tq_ag_…`) or a user token (`tq_us_…`). */\nexport type TasqAuth = { agentKey: string } | { userToken: string };\n\nexport type TasqClientOptions = {\n\t/** Origin of the API, with or without a trailing slash. `/api` is appended. */\n\tbaseUrl: string;\n\t/**\n\t * Omit to build an anonymous client. Only `auth.requestMagicLink` and\n\t * `auth.verifyCliCode` work without one; everything else throws\n\t * `NO_CREDENTIAL` before reaching the network.\n\t */\n\tauth?: TasqAuth;\n\t/** Injectable for tests and for runtimes with a non-global `fetch`. */\n\tfetch?: typeof fetch;\n};\n\ntype QueryValue = string | number | boolean | undefined;\n\n/** Cancellation and a ceiling, for the calls that can block. */\nexport type TasqRequestOptions = {\n\tsignal?: AbortSignal;\n\ttimeoutMs?: number;\n};\n\nexport type AgentEventsQuery = {\n\t/** Seconds to hold the connection open, 0-25. The server clamps. */\n\twait?: number;\n\t/** Event ids to acknowledge before this poll selects. */\n\tack?: ReadonlyArray<string>;\n\tlimit?: number;\n};\n\nfunction assertPrefix(token: string, prefix: string, label: string): void {\n\tif (!token.startsWith(prefix)) {\n\t\tthrow new Error(\n\t\t\t`Invalid ${label}: expected a token starting with \"${prefix}\".`,\n\t\t);\n\t}\n}\n\nfunction credential(auth: TasqAuth | undefined): string | undefined {\n\tif (auth === undefined) return undefined;\n\n\tif (\"agentKey\" in auth) {\n\t\tassertPrefix(auth.agentKey, AGENT_KEY_PREFIX, \"agent key\");\n\n\t\treturn auth.agentKey;\n\t}\n\n\tassertPrefix(auth.userToken, USER_TOKEN_PREFIX, \"user token\");\n\n\treturn auth.userToken;\n}\n\nfunction normaliseBaseUrl(baseUrl: string): string {\n\treturn `${baseUrl.replace(/\\/+$/, \"\")}/api`;\n}\n\nfunction queryString(params: Record<string, QueryValue> | undefined): string {\n\tif (!params) return \"\";\n\n\tconst search = new URLSearchParams();\n\n\tfor (const [key, value] of Object.entries(params)) {\n\t\tif (value === undefined) continue;\n\n\t\tsearch.set(key, String(value));\n\t}\n\n\tconst encoded = search.toString();\n\n\treturn encoded === \"\" ? \"\" : `?${encoded}`;\n}\n\n/**\n * `releases.context` reads as JSON or as the rendered Markdown prompt; the\n * return type follows `format` rather than widening to a union at every call\n * site.\n */\ntype ReleaseContextRead = {\n\t(\n\t\tslug: string,\n\t\treleaseId: string,\n\t\toptions?: { format?: \"json\" } & TasqRequestOptions,\n\t): Promise<ReleaseContext>;\n\t(\n\t\tslug: string,\n\t\treleaseId: string,\n\t\toptions: { format: \"markdown\" } & TasqRequestOptions,\n\t): Promise<string>;\n};\n\nexport class TasqClient {\n\treadonly #baseUrl: string;\n\treadonly #token: string | undefined;\n\treadonly #fetch: typeof fetch;\n\n\t/** A client with no credential, for the two anonymous auth calls. */\n\tstatic anonymous(baseUrl: string, fetchImpl?: typeof fetch): TasqClient {\n\t\treturn new TasqClient({ baseUrl, fetch: fetchImpl });\n\t}\n\n\tconstructor(options: TasqClientOptions) {\n\t\tthis.#baseUrl = normaliseBaseUrl(options.baseUrl);\n\t\tthis.#token = credential(options.auth);\n\t\tthis.#fetch = options.fetch ?? globalThis.fetch;\n\t}\n\n\tasync #request<T>(\n\t\tpath: string,\n\t\tinit: RequestInit & { anonymous?: boolean; timeoutMs?: number } = {},\n\t): Promise<T> {\n\t\tconst { anonymous = false, timeoutMs, ...requestInit } = init;\n\t\tconst headers = new Headers(requestInit.headers);\n\n\t\tif (!anonymous) {\n\t\t\tif (this.#token === undefined) throw noCredentialError();\n\n\t\t\theaders.set(\"authorization\", `Bearer ${this.#token}`);\n\t\t}\n\n\t\tif (requestInit.body !== undefined && !headers.has(\"content-type\")) {\n\t\t\theaders.set(\"content-type\", \"application/json\");\n\t\t}\n\n\t\theaders.set(\"accept\", \"application/json\");\n\n\t\t// A long poll needs both a caller's cancel (Ctrl-C in the CLI) and a\n\t\t// ceiling of its own. `AbortSignal.any` folds the two into one so the\n\t\t// caller's signal is still what fetch sees when no timeout is asked for.\n\t\tconst timeout =\n\t\t\ttimeoutMs === undefined ? undefined : AbortSignal.timeout(timeoutMs);\n\n\t\tconst signals = [requestInit.signal, timeout].filter(\n\t\t\t(candidate): candidate is AbortSignal => candidate != null,\n\t\t);\n\n\t\tconst signal =\n\t\t\tsignals.length === 0\n\t\t\t\t? undefined\n\t\t\t\t: signals.length === 1\n\t\t\t\t\t? signals[0]\n\t\t\t\t\t: AbortSignal.any(signals);\n\n\t\tconst response = await this.#fetch(`${this.#baseUrl}${path}`, {\n\t\t\t...requestInit,\n\t\t\theaders,\n\t\t\tsignal,\n\t\t});\n\n\t\tif (!response.ok) {\n\t\t\tthrow await this.#toError(response);\n\t\t}\n\n\t\treturn (await response.json()) as T;\n\t}\n\n\t/**\n\t * A read whose body is Markdown rather than JSON.\n\t *\n\t * The export and the `format=markdown` context are documents, not\n\t * envelopes, so they are read as text. Errors still arrive as the JSON\n\t * envelope every other route uses, so the failure path is `#toError`'s,\n\t * unchanged.\n\t */\n\tasync #text(\n\t\tpath: string,\n\t\tparams?: Record<string, QueryValue>,\n\t\toptions?: TasqRequestOptions,\n\t): Promise<string> {\n\t\tconst headers = new Headers({ accept: \"text/markdown\" });\n\n\t\tif (this.#token === undefined) throw noCredentialError();\n\n\t\theaders.set(\"authorization\", `Bearer ${this.#token}`);\n\n\t\tconst timeout =\n\t\t\toptions?.timeoutMs === undefined\n\t\t\t\t? undefined\n\t\t\t\t: AbortSignal.timeout(options.timeoutMs);\n\n\t\tconst signals = [options?.signal, timeout].filter(\n\t\t\t(candidate): candidate is AbortSignal => candidate != null,\n\t\t);\n\n\t\tconst signal =\n\t\t\tsignals.length === 0\n\t\t\t\t? undefined\n\t\t\t\t: signals.length === 1\n\t\t\t\t\t? signals[0]\n\t\t\t\t\t: AbortSignal.any(signals);\n\n\t\tconst response = await this.#fetch(\n\t\t\t`${this.#baseUrl}${path}${queryString(params)}`,\n\t\t\t{ headers, signal },\n\t\t);\n\n\t\tif (!response.ok) throw await this.#toError(response);\n\n\t\treturn await response.text();\n\t}\n\n\tasync #toError(response: Response): Promise<TasqApiError> {\n\t\tconst retryAfter = response.headers.get(\"retry-after\");\n\n\t\tconst fallback = {\n\t\t\tcode: `HTTP_${response.status}`,\n\t\t\tmessage: `Request failed with status ${response.status}`,\n\t\t};\n\n\t\tconst envelope = (await response.json().catch(() => null)) as {\n\t\t\terror?: { code?: string; message?: string; details?: unknown };\n\t\t} | null;\n\n\t\tconst error = envelope?.error;\n\n\t\tconst body =\n\t\t\terror?.code === undefined\n\t\t\t\t? fallback\n\t\t\t\t: {\n\t\t\t\t\t\tcode: error.code,\n\t\t\t\t\t\tmessage: error.message ?? fallback.message,\n\t\t\t\t\t\tdetails: error.details,\n\t\t\t\t\t};\n\n\t\treturn toTasqError(response.status, body, retryAfter);\n\t}\n\n\t#get<T>(\n\t\tpath: string,\n\t\tparams?: Record<string, QueryValue>,\n\t\toptions?: TasqRequestOptions,\n\t): Promise<T> {\n\t\treturn this.#request<T>(`${path}${queryString(params)}`, options);\n\t}\n\n\treadonly workspaces = {\n\t\tlist: async (): Promise<WorkspaceSummary[]> =>\n\t\t\t(await this.#get<{ workspaces: WorkspaceSummary[] }>(\"/workspaces\"))\n\t\t\t\t.workspaces,\n\n\t\tget: async (slug: string): Promise<WorkspaceDetail> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ workspace: WorkspaceDetail }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}`,\n\t\t\t\t)\n\t\t\t).workspace,\n\t};\n\n\treadonly tasks = {\n\t\tlist: async (\n\t\t\tslug: string,\n\t\t\tfilters?: TaskListFilters,\n\t\t): Promise<TaskListItem[]> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ tasks: TaskListItem[] }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/tasks`,\n\t\t\t\t\tfilters,\n\t\t\t\t)\n\t\t\t).tasks,\n\n\t\tget: async (slug: string, taskId: string): Promise<TaskDetail> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ task: TaskDetail }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/tasks/${encodeURIComponent(taskId)}`,\n\t\t\t\t)\n\t\t\t).task,\n\t};\n\n\treadonly projects = {\n\t\tlist: async (slug: string): Promise<ProjectListItem[]> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ projects: ProjectListItem[] }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/projects`,\n\t\t\t\t)\n\t\t\t).projects,\n\n\t\tget: async (slug: string, projectId: string): Promise<ProjectDetail> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ project: ProjectDetail }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/projects/${encodeURIComponent(projectId)}`,\n\t\t\t\t)\n\t\t\t).project,\n\t};\n\n\treadonly threads = {\n\t\t/**\n\t\t * The context bundle for one thread: the entity it hangs off, the\n\t\t * transcript, recent activity, and the participants (D-6).\n\t\t *\n\t\t * Authorized by the entity's own read rule, so a read-only agent may\n\t\t * pull it. Lists are capped per D-8 with `truncated` flags.\n\t\t */\n\t\tcontext: (\n\t\t\tslug: string,\n\t\t\tthreadId: string,\n\t\t\toptions?: TasqRequestOptions,\n\t\t): Promise<ThreadContext> =>\n\t\t\tthis.#get<ThreadContext>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/threads/${encodeURIComponent(threadId)}/context`,\n\t\t\t\tundefined,\n\t\t\t\toptions,\n\t\t\t),\n\t};\n\n\treadonly cycles = {\n\t\tlist: async (\n\t\t\tslug: string,\n\t\t\tfilters?: CycleListFilters,\n\t\t): Promise<CycleListItem[]> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ cycles: CycleListItem[] }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/cycles`,\n\t\t\t\t\tfilters,\n\t\t\t\t)\n\t\t\t).cycles,\n\n\t};\n\n\treadonly teams = {\n\t\tlist: async (slug: string): Promise<TeamListItem[]> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ teams: TeamListItem[] }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/teams`,\n\t\t\t\t)\n\t\t\t).teams,\n\n\t\t/** The only read that carries a team's statuses. */\n\t\tget: async (slug: string, identifier: string): Promise<TeamDetail> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ team: TeamDetail }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/teams/${encodeURIComponent(identifier)}`,\n\t\t\t\t)\n\t\t\t).team,\n\n\t\t/**\n\t\t * Whether agents on this team may wake each other, plus the loop and\n\t\t * fan-out limits that stand behind the open setting (B-04c D-1).\n\t\t *\n\t\t * Read-only here on purpose: saving the setting is admin-only and web-only\n\t\t * (D-8), so no agent key can reach it.\n\t\t */\n\t\tagentSettings: (\n\t\t\tslug: string,\n\t\t\tidentifier: string,\n\t\t): Promise<TeamAgentSettingsResponse> =>\n\t\t\tthis.#get<TeamAgentSettingsResponse>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/teams/${encodeURIComponent(identifier)}/agent-settings`,\n\t\t\t),\n\t};\n\n\treadonly labels = {\n\t\tlist: async (slug: string): Promise<LabelListItem[]> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ labels: LabelListItem[] }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/labels`,\n\t\t\t\t)\n\t\t\t).labels,\n\t};\n\n\treadonly agents = {\n\t\tpolicy: (slug: string, agentId: string): Promise<AgentPolicyDetail> =>\n\t\t\tthis.#get<AgentPolicyDetail>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/agents/${encodeURIComponent(agentId)}/policy`,\n\t\t\t),\n\n\t\t/**\n\t\t * Long-poll for mentions addressed to the agent behind this key.\n\t\t *\n\t\t * The same call acks: ids passed as `ack` are marked before the select\n\t\t * runs, so a runner's next poll is also its acknowledgement of the last\n\t\t * batch (D-5). Agent keys only.\n\t\t */\n\t\tevents: (\n\t\t\tslug: string,\n\t\t\tquery: AgentEventsQuery = {},\n\t\t\toptions?: TasqRequestOptions,\n\t\t): Promise<AgentEventsResponse> =>\n\t\t\tthis.#get<AgentEventsResponse>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/agents/me/events`,\n\t\t\t\t{\n\t\t\t\t\twait: query.wait,\n\t\t\t\t\tlimit: query.limit,\n\t\t\t\t\tack:\n\t\t\t\t\t\tquery.ack === undefined || query.ack.length === 0\n\t\t\t\t\t\t\t? undefined\n\t\t\t\t\t\t\t: query.ack.join(\",\"),\n\t\t\t\t},\n\t\t\t\toptions,\n\t\t\t),\n\t};\n\n\t/**\n\t * Releases: the structural record of a cycle close, and the narrative an\n\t * agent or a person attaches to it (B-04d).\n\t *\n\t * Reads are authorized by the workspace role guard rather than a policy\n\t * action, so a read-only agent may pull the context it needs; the write\n\t * goes through `release.saveNarrative` like every other action.\n\t */\n\treadonly releases = {\n\t\tlist: async (\n\t\t\tslug: string,\n\t\t\tteamIdentifier?: string,\n\t\t): Promise<ReleaseSummary[]> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ releases: ReleaseSummary[] }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/releases`,\n\t\t\t\t\t{ team: teamIdentifier },\n\t\t\t\t)\n\t\t\t).releases,\n\n\t\tget: async (slug: string, releaseId: string): Promise<Release> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ release: Release }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/releases/${encodeURIComponent(releaseId)}`,\n\t\t\t\t)\n\t\t\t).release,\n\n\t\t/**\n\t\t * The context bundle a narrator writes from.\n\t\t *\n\t\t * `format: \"markdown\"` returns the server-rendered prompt as a string,\n\t\t * which is what a harness pastes into a model; the default returns the\n\t\t * bundle, for a runner that branches on the fields itself.\n\t\t */\n\t\tcontext: ((\n\t\t\tslug: string,\n\t\t\treleaseId: string,\n\t\t\toptions: { format?: \"json\" | \"markdown\" } & TasqRequestOptions = {},\n\t\t): Promise<ReleaseContext | string> => {\n\t\t\tconst path = `/workspaces/${encodeURIComponent(slug)}/releases/${encodeURIComponent(releaseId)}/context`;\n\n\t\t\treturn options.format === \"markdown\"\n\t\t\t\t? this.#text(path, { format: \"markdown\" }, options)\n\t\t\t\t: this.#get<ReleaseContext>(path, undefined, options);\n\t\t}) as ReleaseContextRead,\n\n\t\tdiff: async (slug: string, releaseId: string): Promise<ReleaseDiff> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ releaseId: string; diff: ReleaseDiff }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/releases/${encodeURIComponent(releaseId)}/diff`,\n\t\t\t\t)\n\t\t\t).diff,\n\n\t\t/** The release as a Markdown document, the same body the web export serves. */\n\t\texport: (slug: string, releaseId: string): Promise<string> =>\n\t\t\tthis.#text(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/releases/${encodeURIComponent(releaseId)}/export`,\n\t\t\t),\n\n\t\t/** Last write wins; the author and timestamp move with the body (D-3). */\n\t\tsaveNarrative: (\n\t\t\tslug: string,\n\t\t\tinput: { releaseId: string; narrative: string },\n\t\t): Promise<DispatchResponse<\"release.saveNarrative\">> =>\n\t\t\tthis.dispatch(\"release.saveNarrative\", slug, input),\n\t};\n\n\treadonly members = {\n\t\tlist: async (slug: string): Promise<WorkspaceMemberListItem[]> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ members: WorkspaceMemberListItem[] }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/members`,\n\t\t\t\t)\n\t\t\t).members,\n\t};\n\n\treadonly notifications = {\n\t\tlist: (\n\t\t\tslug: string,\n\t\t\tquery: { unread?: boolean } = {},\n\t\t): Promise<NotificationsResponse> =>\n\t\t\tthis.#get<NotificationsResponse>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/notifications`,\n\t\t\t\t{ unread: query.unread === true ? 1 : undefined },\n\t\t\t),\n\t};\n\n\treadonly auth = {\n\t\t/** The principal behind the current credential. */\n\t\tme: async (): Promise<CurrentUser> =>\n\t\t\t(await this.#get<{ user: CurrentUser }>(\"/auth/me\")).user,\n\n\t\t/** Step one of CLI login: mail a sign-in code. Needs no credential. */\n\t\trequestMagicLink: async (input: { email: string }): Promise<void> => {\n\t\t\tawait this.#request<unknown>(\"/auth/magic-link\", {\n\t\t\t\tmethod: \"POST\",\n\t\t\t\tbody: JSON.stringify({ email: input.email }),\n\t\t\t\tanonymous: true,\n\t\t\t});\n\t\t},\n\n\t\t/** Step two: exchange the code for a `tq_us_…` token. Needs no credential. */\n\t\tverifyCliCode: (input: {\n\t\t\temail: string;\n\t\t\tcode: string;\n\t\t\tlabel: string;\n\t\t}): Promise<CliTokenIssued> =>\n\t\t\tthis.#request<CliTokenIssued>(\"/auth/cli/verify-code\", {\n\t\t\t\tmethod: \"POST\",\n\t\t\t\tbody: JSON.stringify(input),\n\t\t\t\tanonymous: true,\n\t\t\t}),\n\n\t\t/** Revoke the user token this client authenticates with. */\n\t\trevokeUserToken: async (): Promise<void> => {\n\t\t\tawait this.#request<unknown>(\"/auth/cli/token\", { method: \"DELETE\" });\n\t\t},\n\t};\n\n\t/** Run a write action. The API validates `input`; the SDK does not. */\n\tdispatch<TName extends ActionName>(\n\t\taction: TName,\n\t\tslug: string,\n\t\tinput: ActionInputMap[TName],\n\t): Promise<DispatchResponse<TName>> {\n\t\treturn this.#request<DispatchResponse<TName>>(\n\t\t\t`/workspaces/${encodeURIComponent(slug)}/actions`,\n\t\t\t{ method: \"POST\", body: JSON.stringify({ action, input }) },\n\t\t);\n\t}\n}\n","/**\n * Response shapes for the read routes the client wraps.\n *\n * These are hand-declared rather than re-exported from `AppType`. Deriving\n * them with `InferResponseType` typechecks, but neither tsup's `dts.resolve`\n * nor `tsc --declaration` expands a type alias on emit: the published\n * `.d.ts` kept a live `hono/client` import and a dangling `AppType`\n * reference that no consumer can resolve, and some inferred members (the\n * cycle `status` field) print as an absolute path into `apps/api`.\n *\n * So the shapes live here, and `types.equality.ts` asserts each one is\n * structurally identical to what the route actually returns. A handler\n * change breaks `bun run typecheck`, which is the drift guard the derived\n * version was there to provide.\n *\n * All timestamps are ISO-8601 strings: this is the JSON-serialised form.\n */\n\nimport type { TeamKind, TeamLabels, TeamModules } from \"./contracts\";\n\nexport type WorkspaceRole = \"owner\" | \"admin\" | \"member\";\n\nexport type WorkspaceSummary = {\n\tid: string;\n\tname: string;\n\tslug: string;\n\trole: WorkspaceRole;\n\tjoinedAt: string;\n\tcreatedAt: string;\n\tupdatedAt: string;\n};\n\nexport type WorkspaceDetail = {\n\tid: string;\n\tname: string;\n\tslug: string;\n\trole: WorkspaceRole;\n\tcreatedAt: string;\n\tupdatedAt: string;\n};\n\nexport type MemberRef = {\n\tmemberId: string;\n\tname: string | null;\n\temail: string | null;\n};\n\nexport type PersonRef = {\n\tid: string;\n\tname: string | null;\n\temail: string | null;\n};\n\nexport type TaskStatusRef = {\n\tid: string;\n\tname: string;\n\tcolor: string;\n\tcategory: string;\n\tposition: number;\n};\n\nexport type TaskLabelRef = {\n\tid: string;\n\tname: string;\n\tcolor: string;\n};\n\nexport type TaskListItem = {\n\tid: string;\n\tidentifier: string;\n\tnumber: number;\n\ttitle: string;\n\tpriority: string;\n\testimateValue: number | null;\n\testimateSettingsRevisionId: string | null;\n\tsortOrder: number;\n\tarchivedAt: string | null;\n\tcreatedAt: string;\n\tupdatedAt: string;\n\tteamId: string;\n\tteamIdentifier: string;\n\t/** 5.2: the team's kind and modules, so a client can hide a surface. */\n\tteamKind: TeamKind;\n\tteamModules: TeamModules;\n\tprojectId: string | null;\n\tmilestoneId: string | null;\n\t/** 5.5: the task this is a subtask of, one level only (D-2). */\n\tparentTaskId: string | null;\n\t/**\n\t * 5.5: how many subtasks this task has and how many are done, the `n/m` a\n\t * client shows. Cancelled and archived subtasks are in neither number.\n\t */\n\tsubtaskProgress: SubtaskProgress;\n\tcycleId: string | null;\n\t/** All-day `YYYY-MM-DD` dates, never instants (D-5). */\n\tdueDate: string | null;\n\tstartDate: string | null;\n\tstatus: TaskStatusRef;\n\tassignee: MemberRef | null;\n\tlabels: TaskLabelRef[];\n};\n\nexport type SubtaskProgress = { total: number; completed: number };\n\nexport type NamedRef = { id: string; name: string };\n\nexport type TaskComment = {\n\tid: string;\n\tbody: string;\n\t/** The comment this one replies to. One level of threading only (D-3). */\n\tparentId: string | null;\n\tcreatedAt: string;\n\tupdatedAt: string;\n\t/** Null when the author's membership is gone. */\n\tauthorType: \"user\" | \"agent\" | null;\n\tmentions: Array<{ agentId: string; name: string | null }>;\n\tauthor: MemberRef | null;\n};\n\nexport type TaskActivityEntry = {\n\tid: string;\n\taction: string;\n\tfieldChanged: string | null;\n\toldValue: string | null;\n\tnewValue: string | null;\n\tcreatedAt: string;\n\tactorType: \"user\" | \"agent\" | \"system\";\n\tactor: MemberRef | null;\n};\n\nexport type EstimateScale = \"fibonacci\" | \"linear\";\n\nexport type TaskEstimateEditing =\n\t| {\n\t\t\tenabled: true;\n\t\t\tscale: EstimateScale;\n\t\t\tvalues: number[];\n\t\t\trevisionId: string;\n\t\t\tepoch: string;\n\t\t}\n\t| { enabled: false };\n\n/** A TipTap JSON document. Kept opaque so no editor types reach consumers. */\n/** A JSON value carried by a description node attribute. */\nexport type DescriptionAttrValue =\n\t| string\n\t| number\n\t| boolean\n\t| null\n\t| DescriptionAttrValue[]\n\t| { [key: string]: DescriptionAttrValue };\n\nexport type DescriptionAttrs = { [key: string]: DescriptionAttrValue };\n\nexport type DescriptionMark = { type: string; attrs?: DescriptionAttrs };\n\nexport type DescriptionNode = {\n\ttype?: string;\n\ttext?: string;\n\tattrs?: DescriptionAttrs;\n\tmarks?: DescriptionMark[];\n\tcontent?: DescriptionNode[];\n};\n\nexport type DescriptionDocumentJson = {\n\tversion: 1;\n\tcontent: DescriptionNode;\n};\n\nexport type TaskDetail = TaskListItem & {\n\tdescription: string | null;\n\tdescriptionDocument: DescriptionDocumentJson | null;\n\tdescriptionMarkdown: string | null;\n\testimateEditing: TaskEstimateEditing;\n\tproject: NamedRef | null;\n\tmilestone: NamedRef | null;\n\tcycle: NamedRef | null;\n\t/** 5.5: this task's subtasks, unarchived, oldest first. */\n\tsubtasks: TaskListItem[];\n\t/** 5.5: set when this task is itself a subtask. */\n\tparent: { id: string; identifier: string; title: string } | null;\n\tcomments: TaskComment[];\n\tactivityLog: TaskActivityEntry[];\n};\n\nexport type TaskCounts = {\n\tbacklog: number;\n\tunstarted: number;\n\tstarted: number;\n\tcompleted: number;\n\tcancelled: number;\n\ttotal: number;\n};\n\nexport type EffortByTeam = {\n\tteamId: string;\n\tteamIdentifier: string;\n\tmode: \"count\" | \"effort\";\n\tscale: EstimateScale | null;\n\tpoints: number;\n\tunestimatedTasks: number;\n};\n\nexport type TeamRef = { id: string; name: string; identifier: string };\n\nexport type ProjectStatus =\n\t| \"backlog\"\n\t| \"planned\"\n\t| \"in_progress\"\n\t| \"completed\"\n\t| \"cancelled\";\n\nexport type ProjectListItem = {\n\tid: string;\n\tworkspaceId: string;\n\tname: string;\n\tdescription: string | null;\n\tstatus: ProjectStatus;\n\tstartDate: string | null;\n\ttargetDate: string | null;\n\tleadId: string | null;\n\tarchivedAt: string | null;\n\tcreatedAt: string;\n\tupdatedAt: string;\n\ttaskCounts: TaskCounts;\n\tcompletionPercentage: number;\n\teffortByTeam: EffortByTeam[];\n\tteams: TeamRef[];\n\tlead: PersonRef | null;\n\tmembers: PersonRef[];\n};\n\nexport type ProjectMilestone = {\n\tid: string;\n\tname: string;\n\tdescription: string | null;\n\ttargetDate: string | null;\n\tposition: number;\n\ttaskCounts: TaskCounts;\n\tcompletionPercentage: number;\n\tisCurrent: boolean;\n\teffortByTeam: EffortByTeam[];\n};\n\nexport type ProjectDetail = ProjectListItem & {\n\tmilestones: ProjectMilestone[];\n\ttasks: TaskListItem[];\n\t/** Project threads, same shape as task detail comments (D-2). */\n\tcomments: TaskComment[];\n};\n\nexport type CycleState = \"upcoming\" | \"active\" | \"completed\";\n\nexport type CycleListItem = {\n\tid: string;\n\tteamId: string;\n\tteamIdentifier: string;\n\tteamName: string;\n\tname: string;\n\tdescription: string | null;\n\tstartDate: string;\n\tendDate: string;\n\tdateConvention: \"legacy\" | \"exclusive\";\n\tsource: \"legacy\" | \"generated\" | \"override\";\n\tcadenceRevisionId: string | null;\n\tcadenceSequence: number | null;\n\tcadenceTimezone: string | null;\n\tstatus: CycleState;\n\tstate: CycleState;\n\tlegacyStatus: \"upcoming\" | \"active\" | \"completed\";\n\tstateSource: \"transition_markers\" | \"planned_dates\";\n\tstartedAt: string | null;\n\tcontractFrozenAt: string | null;\n\tclosedAt: string | null;\n\treportMode: \"count\" | \"effort\";\n\treportEffectiveStartedAt: string;\n\treportingContractState: \"frozen\" | \"derived\" | \"provisional\";\n\testimateSettingsRevisionId: string | null;\n\testimateScale: EstimateScale | null;\n\testimateEpoch: string | null;\n\thistoryObservedSince: string;\n\thistoryComplete: boolean;\n\thistoryCoverage: { level: \"partial\" | \"complete\"; observedSince: string };\n\ttaskCounts: TaskCounts;\n\tcompletionPercentage: number;\n\teffort?: { readonly points: number; readonly unestimatedTasks: number };\n\tcreatedAt: string;\n\tupdatedAt: string;\n};\n\nexport type TeamListItem = {\n\tid: string;\n\tworkspaceId: string;\n\tname: string;\n\tidentifier: string;\n\tkind: TeamKind;\n\tmodules: TeamModules;\n\t/** 5.7: display words for this team's kind (D-7). */\n\tlabels: TeamLabels;\n\tmemberCount: number;\n\tcreatedAt: string;\n\tupdatedAt: string;\n};\n\nexport type StatusCategory =\n\t| \"backlog\"\n\t| \"unstarted\"\n\t| \"started\"\n\t| \"completed\"\n\t| \"cancelled\";\n\nexport type TeamStatus = {\n\tid: string;\n\tname: string;\n\tcolor: string;\n\tposition: number;\n\tcategory: StatusCategory;\n};\n\n/** `GET /workspaces/:slug/teams/:identifier` — the only read with statuses. */\nexport type TeamDetail = {\n\tid: string;\n\tworkspaceId: string;\n\tname: string;\n\tidentifier: string;\n\tkind: TeamKind;\n\tmodules: TeamModules;\n\tlabels: TeamLabels;\n\tcreatedAt: string;\n\tupdatedAt: string;\n\tstatuses: TeamStatus[];\n};\n\nexport type LabelListItem = {\n\tid: string;\n\tworkspaceId: string;\n\tname: string;\n\tcolor: string;\n\tcreatedAt: string;\n\tupdatedAt: string;\n};\n\nexport type AgentPolicyPresetName = \"read_only\" | \"triage\" | \"full\" | \"custom\";\n\nexport type AgentPolicyDetail = {\n\tpolicy: {\n\t\tid: string;\n\t\tversion: number;\n\t\tpreset: AgentPolicyPresetName;\n\t\tallowedActions: string[];\n\t};\n\tallowable: string[];\n\thistory: {\n\t\tversion: number;\n\t\tpreset: AgentPolicyPresetName;\n\t\tcreatedAt: string;\n\t\tcreatedByName: string | null;\n\t}[];\n};\n\nexport type CurrentUser = {\n\tid: string;\n\temail: string;\n\tname: string | null;\n\tavatarUrl: string | null;\n\tcreatedAt: string;\n};\n\n/** Filters accepted by `GET /workspaces/:slug/tasks`. */\nexport type TaskListFilters = {\n\tteam?: string;\n\tstatus?: string;\n\tassignee?: string;\n\tpriority?: string;\n\tproject?: string;\n\tcycle?: string;\n\t/** `overdue`, `today`, `week`, or `none` for tasks with no due date. */\n\tdue?: string;\n\t/** `due` orders by due date, dated tasks first. */\n\tsort?: string;\n\tq?: string;\n\tincludeArchived?: boolean;\n};\n\n/** Filters accepted by `GET /workspaces/:slug/cycles`. */\nexport type CycleListFilters = {\n\tteam?: string;\n};\n\n/** `POST /auth/cli/verify-code` response. */\nexport type CliTokenIssued = {\n\ttoken: string;\n\texpiresAt: string;\n\tuser: { id: string; email: string; name: string | null };\n};\n\n/** Who wrote the comment behind an event or a notification. */\nexport type MentionActorRef = {\n\tmemberId: string;\n\ttype: \"user\" | \"agent\";\n\tname: string | null;\n};\n\n/**\n * One row of `GET /workspaces/:slug/agents/me/events`.\n *\n * `mention` is a request addressed to the agent; `thread_message` is a later\n * human message in a thread the agent already joined (D-4). Ids only (D-6):\n * every read from these ids passes the policy layer.\n */\nexport type AgentEvent = {\n\tid: string;\n\tkind: \"mention\" | \"thread_message\" | \"cycle_closed\";\n\tworkspace: string;\n\t/** Exactly one of `taskId` / `projectId` is set: the entity the thread is on. */\n\ttaskId: string | null;\n\ttaskKey: string | null;\n\tprojectId: string | null;\n\t/** The thread the comment belongs to: the root comment's id (D-1). */\n\tthreadId: string | null;\n\tcommentId: string | null;\n\t/** Set only on `cycle_closed`: the release to narrate (B-04d D-2). */\n\treleaseId: string | null;\n\tmentionedBy: MentionActorRef | null;\n\tdeliveryCount: number;\n\tcreatedAt: string;\n};\n\n/** `GET /workspaces/:slug/agents/me/events` */\nexport type AgentEventsResponse = {\n\tevents: AgentEvent[];\n\tacked: string[];\n};\n\n/**\n * One row of `GET /workspaces/:slug/notifications`.\n *\n * `agent_reply` is a direct reply to the human's own message; `thread_reply`\n * is an agent message in a thread the human participates in (D-9).\n */\nexport type NotificationItem = {\n\tid: string;\n\tkind: \"agent_reply\" | \"thread_reply\" | \"release_ready\";\n\t/** Exactly one of `taskId` / `projectId` is set: the entity the thread is on. */\n\ttaskId: string | null;\n\ttaskKey: string | null;\n\tprojectId: string | null;\n\t/** Name of the project a project thread is on; null for a task thread. */\n\tprojectName: string | null;\n\t/** The thread the comment belongs to: the root comment's id (D-1). */\n\tthreadId: string | null;\n\tcommentId: string | null;\n\t/** Set only on `release_ready`: the release and how to name it (B-04d D-1). */\n\treleaseId: string | null;\n\treleaseNumber: number | null;\n\treleaseTeamIdentifier: string | null;\n\tactor: MentionActorRef | null;\n\treadAt: string | null;\n\tcreatedAt: string;\n};\n\n/** `GET /workspaces/:slug/notifications` */\nexport type NotificationsResponse = {\n\tnotifications: NotificationItem[];\n\tunreadCount: number;\n};\n\n/**\n * One row of `GET /workspaces/:slug/members`, narrowed to what the CLI needs\n * to turn an `--mention <name>` into an agent id. The route returns more per\n * agent (policy, keys); those members are left off deliberately so the SDK\n * does not promise a shape the CLI never reads.\n */\nexport type WorkspaceMemberListItem = {\n\tid: string;\n\tagentId: string | null;\n\ttype: \"user\" | \"agent\";\n\tname: string | null;\n\temail: string | null;\n\trole: \"owner\" | \"admin\" | \"member\";\n};\n\n// ---------------------------------------------------------------------------\n// Thread context (B-04 slice 2, D-6/D-8).\n// ---------------------------------------------------------------------------\n\n/** Last N messages returned in a thread transcript (D-8). */\nexport const THREAD_CONTEXT_MESSAGE_LIMIT = 50;\n\n/** Last N activity rows returned for the entity (D-8). */\nexport const THREAD_CONTEXT_ACTIVITY_LIMIT = 20;\n\n/** Entity description is cut at this many characters (D-8). */\nexport const THREAD_CONTEXT_DESCRIPTION_MAX = 8000;\n\nexport type ThreadContextEntity =\n\t| {\n\t\t\ttype: \"task\";\n\t\t\tid: string;\n\t\t\t/** The human task key, e.g. `ENG-248`. */\n\t\t\tkey: string | null;\n\t\t\ttitle: string;\n\t\t\tstatus: string | null;\n\t\t\tdescription: string | null;\n\t\t\tdescriptionTruncated: boolean;\n\t\t\tproject: { id: string; name: string } | null;\n\t\t}\n\t| {\n\t\t\ttype: \"project\";\n\t\t\tid: string;\n\t\t\tkey: null;\n\t\t\ttitle: string;\n\t\t\tstatus: string | null;\n\t\t\tdescription: string | null;\n\t\t\tdescriptionTruncated: boolean;\n\t\t\tteams: Array<{ id: string; identifier: string; name: string }>;\n\t\t};\n\nexport type ThreadContextMessage = {\n\tid: string;\n\tauthorType: \"user\" | \"agent\" | null;\n\tauthorName: string | null;\n\tbody: string;\n\tcreatedAt: string;\n};\n\nexport type ThreadContextActivity = {\n\tid: string;\n\tkind: string;\n\tactorName: string | null;\n\tsummary: string;\n\tcreatedAt: string;\n};\n\nexport type ThreadContextParticipant = {\n\tmemberId: string;\n\ttype: \"user\" | \"agent\";\n\tname: string | null;\n\tjoinedVia: \"author\" | \"mention\";\n};\n\n/** `GET /workspaces/:slug/threads/:threadId/context` */\nexport type ThreadContext = {\n\tthreadId: string;\n\tentity: ThreadContextEntity;\n\tthread: {\n\t\t/** Oldest first, capped at `THREAD_CONTEXT_MESSAGE_LIMIT`. */\n\t\tmessages: Array<ThreadContextMessage>;\n\t\t/** Messages in the thread, including any the cap dropped. */\n\t\ttotal: number;\n\t\ttruncated: boolean;\n\t};\n\trecentActivity: Array<ThreadContextActivity>;\n\tparticipants: Array<ThreadContextParticipant>;\n};\n\n// ---------------------------------------------------------------------------\n// Agent isolation and loop safety (B-04c, D-1/D-4/D-5/D-6).\n// ---------------------------------------------------------------------------\n\n/** Whether agents on a team may wake each other. No setting means `isolated`. */\nexport const AGENT_ISOLATION_VALUES = [\"isolated\", \"open\"] as const;\n\nexport type AgentIsolation = (typeof AGENT_ISOLATION_VALUES)[number];\n\n/**\n * Why a wake was recorded `suppressed` instead of delivered. Precedence when\n * several apply: `isolation` > `loop_cap` > `fanout_cap`.\n */\nexport const SUPPRESSED_REASONS = [\n\t\"isolation\",\n\t\"fanout_cap\",\n\t\"loop_cap\",\n] as const;\n\nexport type SuppressedReason = (typeof SUPPRESSED_REASONS)[number];\n\n/** One message wakes at most this many agents (D-4). */\nexport const MAX_AGENT_WAKES_PER_MESSAGE = 10;\n\n/**\n * A thread stops waking agents after this many agent messages in a row\n * without a person posting (D-5).\n */\nexport const MAX_CONSECUTIVE_AGENT_MESSAGES = 5;\n\n/**\n * One agent's outcome for a message, as `comment.add` reports it. `reason` is\n * null exactly when the wake is `pending`.\n */\nexport type WakeOutcome = {\n\tagentId: string;\n\tstate: \"pending\" | \"suppressed\";\n\treason: SuppressedReason | null;\n};\n\n/** The stored current setting for a team; absent until somebody saves one. */\nexport type TeamAgentSettingsRecord = {\n\tteamId: string;\n\tcurrentRevisionId: string;\n\trevision: number;\n\tisolation: AgentIsolation;\n\t/** The agent woken on a cycle close, if any (B-04d D-2). */\n\treleaseNarratorMemberId: string | null;\n\tcreatedAt: string;\n\tupdatedAt: string;\n};\n\n/** `GET /workspaces/:slug/teams/:identifier/agent-settings` */\nexport type TeamAgentSettingsResponse = {\n\tsettings: TeamAgentSettingsRecord | null;\n\t/** The effective setting: `isolated` when there is no row. */\n\tisolation: AgentIsolation;\n\tlimits: {\n\t\tmaxWakesPerMessage: number;\n\t\tmaxConsecutiveAgentMessages: number;\n\t};\n};\n\n// ---------------------------------------------------------------------------\n// Releases (B-04d, D-1/D-3/D-4).\n// ---------------------------------------------------------------------------\n\n/** How a task ended the cycle. Orthogonal to `addedMidCycle`. */\nexport const RELEASE_DISPOSITIONS = [\n\t\"shipped\",\n\t\"carried_over\",\n\t\"dropped\",\n] as const;\n\nexport type ReleaseDisposition = (typeof RELEASE_DISPOSITIONS)[number];\n\n/** A narrative is capped here on the way in (D-3). */\nexport const RELEASE_NARRATIVE_MAX = 50_000;\n\n/** Narrative excerpt length in a list row and in the previous-release summary. */\nexport const RELEASE_NARRATIVE_EXCERPT_MAX = 500;\n\n/** Each context list is cut at this many tasks. */\nexport const RELEASE_CONTEXT_TASK_LIMIT = 100;\n\nexport type ReleaseTask = {\n\tsourceTaskId: string;\n\ttaskIdentifier: string;\n\ttitle: string;\n\tstatusName: string;\n\tstatusCategory: string;\n\tdisposition: ReleaseDisposition;\n\taddedMidCycle: boolean;\n};\n\n/** Who wrote the narrative currently on a release. */\nexport type ReleaseNarrativeAuthor = {\n\tmemberId: string | null;\n\ttype: \"user\" | \"agent\" | \"system\" | null;\n\tname: string | null;\n\tupdatedAt: string;\n};\n\nexport type ReleaseCounts = {\n\tshipped: number;\n\tcarriedOver: number;\n\tdropped: number;\n\taddedMidCycle: number;\n\ttotal: number;\n};\n\n/** One row of `GET /workspaces/:slug/releases`. */\nexport type ReleaseSummary = {\n\tid: string;\n\tnumber: number;\n\tteamId: string;\n\tteamIdentifier: string;\n\tcycleId: string;\n\tcycleName: string | null;\n\tclosedAt: string;\n\tcounts: ReleaseCounts;\n\t/** First `RELEASE_NARRATIVE_EXCERPT_MAX` characters, or null when unwritten. */\n\tnarrativeExcerpt: string | null;\n\tnarrativeTruncated: boolean;\n\tnarrativeAuthor: ReleaseNarrativeAuthor | null;\n\tcreatedAt: string;\n};\n\n/** `GET /workspaces/:slug/releases/:releaseId` */\nexport type Release = ReleaseSummary & {\n\tcycleStartDate: string | null;\n\tcycleEndDate: string | null;\n\tnarrative: string | null;\n\ttasks: ReleaseTask[];\n};\n\n/**\n * The change between a release and the previous release of the same team\n * (D-4). Keyed by `sourceTaskId`, so a task that moved between cycles is\n * followed across them.\n */\nexport type ReleaseDiff = {\n\tpreviousReleaseId: string | null;\n\tpreviousReleaseNumber: number | null;\n\t/** In this release, not in the previous one. */\n\tadded: ReleaseTask[];\n\t/** Shipped in this release, whatever it was in the previous one. */\n\tcompleted: ReleaseTask[];\n\t/** Carried over in both: still unfinished after two cycles. */\n\tcarried: ReleaseTask[];\n\t/** Present in the previous release, absent from this one. */\n\tdropped: ReleaseTask[];\n};\n\n/** The previous release, as the context bundle summarizes it. */\nexport type ReleasePreviousSummary = {\n\tid: string;\n\tnumber: number;\n\tclosedAt: string;\n\tcounts: ReleaseCounts;\n\tnarrativeExcerpt: string | null;\n\tnarrativeTruncated: boolean;\n};\n\n/**\n * `GET /workspaces/:slug/releases/:releaseId/context`\n *\n * One read that hands a narrator everything it needs to write the narrative.\n * Every list is capped at `RELEASE_CONTEXT_TASK_LIMIT`; `counts` carries the\n * full totals, so a renderer can say \"showing N of M\".\n */\nexport type ReleaseContext = {\n\treleaseId: string;\n\tnumber: number;\n\tteam: { id: string; identifier: string; name: string };\n\tcycle: {\n\t\tid: string;\n\t\tname: string | null;\n\t\tstartDate: string | null;\n\t\tendDate: string | null;\n\t};\n\tclosedAt: string;\n\tcounts: ReleaseCounts;\n\tshipped: ReleaseTask[];\n\tcarriedOver: ReleaseTask[];\n\tdropped: ReleaseTask[];\n\taddedMidCycle: ReleaseTask[];\n\ttruncated: boolean;\n\tprevious: ReleasePreviousSummary | null;\n\tdiff: ReleaseDiff;\n};\n"],"mappings":"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","names":[]}
|
|
1
|
+
{"version":3,"sources":["../src/prefixes.ts","../src/errors.ts","../src/client.ts","../src/types.ts"],"sourcesContent":["/**\n * Token prefixes, duplicated from `@tasq/contracts/agents`.\n *\n * They are re-declared here rather than re-exported because contracts is\n * private: tsup's dts bundler leaves a `@tasq/contracts/agents` import in the\n * emitted `.d.ts`, which a published consumer cannot resolve.\n * `src/prefixes.equality.ts` asserts these stay in step with contracts.\n */\n\n/** Plaintext prefix of an agent API key. */\nexport const AGENT_KEY_PREFIX = \"tq_ag_\";\n\n/** Plaintext prefix of a user (CLI) token. */\nexport const USER_TOKEN_PREFIX = \"tq_us_\";\n","/** Shape of the API's error envelope: `{ error: { code, message, details? } }`. */\ntype ErrorBody = {\n\tcode: string;\n\tmessage: string;\n\tdetails?: unknown;\n};\n\n/** Every failure the client raises for a non-2xx response. */\nexport class TasqApiError extends Error {\n\treadonly code: string;\n\treadonly status: number;\n\treadonly details: unknown;\n\n\tconstructor(status: number, body: ErrorBody) {\n\t\tsuper(body.message);\n\t\tthis.name = \"TasqApiError\";\n\t\tthis.code = body.code;\n\t\tthis.status = status;\n\t\tthis.details = body.details;\n\t}\n}\n\ntype RateLimitDetails = {\n\tlimit?: number;\n\tremaining?: number;\n\tresetAt?: string;\n};\n\n/** A `429 RATE_LIMITED`. `retryAfterSeconds` is never negative. */\nexport class TasqRateLimitError extends TasqApiError {\n\treadonly retryAfterSeconds: number;\n\treadonly resetAt: Date | undefined;\n\treadonly limit: number | undefined;\n\treadonly remaining: number | undefined;\n\n\tconstructor(status: number, body: ErrorBody, retryAfterHeader: string | null) {\n\t\tsuper(status, body);\n\t\tthis.name = \"TasqRateLimitError\";\n\n\t\tconst details = (body.details ?? {}) as RateLimitDetails;\n\n\t\tthis.limit = details.limit;\n\t\tthis.remaining = details.remaining;\n\t\tthis.resetAt =\n\t\t\tdetails.resetAt === undefined ? undefined : new Date(details.resetAt);\n\n\t\tconst fromHeader = Number(retryAfterHeader);\n\n\t\tif (retryAfterHeader !== null && Number.isFinite(fromHeader)) {\n\t\t\tthis.retryAfterSeconds = Math.max(0, fromHeader);\n\t\t} else if (this.resetAt !== undefined) {\n\t\t\tconst ms = this.resetAt.getTime() - Date.now();\n\n\t\t\tthis.retryAfterSeconds = Math.max(0, Math.ceil(ms / 1000));\n\t\t} else {\n\t\t\tthis.retryAfterSeconds = 0;\n\t\t}\n\t}\n}\n\nexport type TasqValidationIssue = {\n\tpath: (string | number)[];\n\tmessage: string;\n};\n\n/** A `400 VALIDATION_ERROR`. `issues` mirrors the API's Zod issue list. */\nexport class TasqValidationError extends TasqApiError {\n\treadonly issues: TasqValidationIssue[];\n\n\tconstructor(status: number, body: ErrorBody) {\n\t\tsuper(status, body);\n\t\tthis.name = \"TasqValidationError\";\n\t\tthis.issues = Array.isArray(body.details)\n\t\t\t? (body.details as TasqValidationIssue[])\n\t\t\t: [];\n\t}\n}\n\n/** A `403 AGENT_ACTION_DENIED`: the agent's policy does not allow the action. */\nexport class TasqPolicyDeniedError extends TasqApiError {\n\t/** The rejected action name, when the API reported one. */\n\treadonly action: string | undefined;\n\t/** The policy version quoted in the message, when the API quoted one. */\n\treadonly policyVersion: number | undefined;\n\n\tconstructor(status: number, body: ErrorBody) {\n\t\tsuper(status, body);\n\t\tthis.name = \"TasqPolicyDeniedError\";\n\t\tthis.action = actionFromDetails(body.details);\n\t\tthis.policyVersion = policyVersionFromMessage(body.message);\n\t}\n}\n\nfunction actionFromDetails(details: ErrorBody[\"details\"]): string | undefined {\n\tif (!Array.isArray(details)) return undefined;\n\n\tconst issues = details as TasqValidationIssue[];\n\n\tfor (const issue of issues) {\n\t\tif (issue.path[0] === \"action\") return issue.message;\n\t}\n\n\treturn undefined;\n}\n\nfunction policyVersionFromMessage(message: string): number | undefined {\n\tconst match = /policy v(?:ersion )?(\\d+)/i.exec(message);\n\n\tif (!match?.[1]) return undefined;\n\n\treturn Number(match[1]);\n}\n\n/**\n * Raised before any request when the client has no credential but the called\n * method needs one. Shaped like an API error so callers map it uniformly.\n */\nexport function noCredentialError(): TasqApiError {\n\treturn new TasqApiError(0, {\n\t\tcode: \"NO_CREDENTIAL\",\n\t\tmessage:\n\t\t\t\"No credential configured. Run `tasq auth login`, or set TASQ_API_KEY.\",\n\t});\n}\n\n/** Build the right error subclass for a failed response. */\nexport function toTasqError(\n\tstatus: number,\n\tbody: ErrorBody,\n\tretryAfterHeader: string | null,\n): TasqApiError {\n\tif (status === 429 || body.code === \"RATE_LIMITED\") {\n\t\treturn new TasqRateLimitError(status, body, retryAfterHeader);\n\t}\n\n\tif (body.code === \"VALIDATION_ERROR\") {\n\t\treturn new TasqValidationError(status, body);\n\t}\n\n\tif (body.code === \"AGENT_ACTION_DENIED\") {\n\t\treturn new TasqPolicyDeniedError(status, body);\n\t}\n\n\treturn new TasqApiError(status, body);\n}\n","import type {\n\tActionInputMap,\n\tActionName,\n\tDispatchResponse,\n} from \"./contracts\";\nimport { AGENT_KEY_PREFIX, USER_TOKEN_PREFIX } from \"./prefixes\";\nimport { noCredentialError, type TasqApiError, toTasqError } from \"./errors\";\nimport type {\n\tAgentPolicyDetail,\n\tCliTokenIssued,\n\tCurrentUser,\n\tCycleListFilters,\n\tCycleListItem,\n\tInitiativeListItem,\n\tLabelListItem,\n\tProjectDetail,\n\tProjectListItem,\n\tProjectUpdateListItem,\n\tRelease,\n\tReleaseContext,\n\tReleaseDiff,\n\tReleaseSummary,\n\tTaskApprovalDecision,\n\tTaskDetail,\n\tTaskListFilters,\n\tTaskListItem,\n\tThreadContext,\n\tAgentEventsResponse,\n\tNotificationsResponse,\n\tTeamAgentSettingsResponse,\n\tTeamDetail,\n\tTeamListItem,\n\tWorkspaceDetail,\n\tWorkspaceMemberListItem,\n\tWorkspaceSummary,\n} from \"./types\";\n\n/** Either an agent key (`tq_ag_…`) or a user token (`tq_us_…`). */\nexport type TasqAuth = { agentKey: string } | { userToken: string };\n\nexport type TasqClientOptions = {\n\t/** Origin of the API, with or without a trailing slash. `/api` is appended. */\n\tbaseUrl: string;\n\t/**\n\t * Omit to build an anonymous client. Only `auth.requestMagicLink` and\n\t * `auth.verifyCliCode` work without one; everything else throws\n\t * `NO_CREDENTIAL` before reaching the network.\n\t */\n\tauth?: TasqAuth;\n\t/** Injectable for tests and for runtimes with a non-global `fetch`. */\n\tfetch?: typeof fetch;\n};\n\ntype QueryValue = string | number | boolean | undefined;\n\n/** Cancellation and a ceiling, for the calls that can block. */\nexport type TasqRequestOptions = {\n\tsignal?: AbortSignal;\n\ttimeoutMs?: number;\n};\n\nexport type AgentEventsQuery = {\n\t/** Seconds to hold the connection open, 0-25. The server clamps. */\n\twait?: number;\n\t/** Event ids to acknowledge before this poll selects. */\n\tack?: ReadonlyArray<string>;\n\tlimit?: number;\n};\n\nfunction assertPrefix(token: string, prefix: string, label: string): void {\n\tif (!token.startsWith(prefix)) {\n\t\tthrow new Error(\n\t\t\t`Invalid ${label}: expected a token starting with \"${prefix}\".`,\n\t\t);\n\t}\n}\n\nfunction credential(auth: TasqAuth | undefined): string | undefined {\n\tif (auth === undefined) return undefined;\n\n\tif (\"agentKey\" in auth) {\n\t\tassertPrefix(auth.agentKey, AGENT_KEY_PREFIX, \"agent key\");\n\n\t\treturn auth.agentKey;\n\t}\n\n\tassertPrefix(auth.userToken, USER_TOKEN_PREFIX, \"user token\");\n\n\treturn auth.userToken;\n}\n\nfunction normaliseBaseUrl(baseUrl: string): string {\n\treturn `${baseUrl.replace(/\\/+$/, \"\")}/api`;\n}\n\nfunction queryString(params: Record<string, QueryValue> | undefined): string {\n\tif (!params) return \"\";\n\n\tconst search = new URLSearchParams();\n\n\tfor (const [key, value] of Object.entries(params)) {\n\t\tif (value === undefined) continue;\n\n\t\tsearch.set(key, String(value));\n\t}\n\n\tconst encoded = search.toString();\n\n\treturn encoded === \"\" ? \"\" : `?${encoded}`;\n}\n\n/**\n * `releases.context` reads as JSON or as the rendered Markdown prompt; the\n * return type follows `format` rather than widening to a union at every call\n * site.\n */\ntype ReleaseContextRead = {\n\t(\n\t\tslug: string,\n\t\treleaseId: string,\n\t\toptions?: { format?: \"json\" } & TasqRequestOptions,\n\t): Promise<ReleaseContext>;\n\t(\n\t\tslug: string,\n\t\treleaseId: string,\n\t\toptions: { format: \"markdown\" } & TasqRequestOptions,\n\t): Promise<string>;\n};\n\nexport class TasqClient {\n\treadonly #baseUrl: string;\n\treadonly #token: string | undefined;\n\treadonly #fetch: typeof fetch;\n\n\t/** A client with no credential, for the two anonymous auth calls. */\n\tstatic anonymous(baseUrl: string, fetchImpl?: typeof fetch): TasqClient {\n\t\treturn new TasqClient({ baseUrl, fetch: fetchImpl });\n\t}\n\n\tconstructor(options: TasqClientOptions) {\n\t\tthis.#baseUrl = normaliseBaseUrl(options.baseUrl);\n\t\tthis.#token = credential(options.auth);\n\t\tthis.#fetch = options.fetch ?? globalThis.fetch;\n\t}\n\n\tasync #request<T>(\n\t\tpath: string,\n\t\tinit: RequestInit & { anonymous?: boolean; timeoutMs?: number } = {},\n\t): Promise<T> {\n\t\tconst { anonymous = false, timeoutMs, ...requestInit } = init;\n\t\tconst headers = new Headers(requestInit.headers);\n\n\t\tif (!anonymous) {\n\t\t\tif (this.#token === undefined) throw noCredentialError();\n\n\t\t\theaders.set(\"authorization\", `Bearer ${this.#token}`);\n\t\t}\n\n\t\tif (requestInit.body !== undefined && !headers.has(\"content-type\")) {\n\t\t\theaders.set(\"content-type\", \"application/json\");\n\t\t}\n\n\t\theaders.set(\"accept\", \"application/json\");\n\n\t\t// A long poll needs both a caller's cancel (Ctrl-C in the CLI) and a\n\t\t// ceiling of its own. `AbortSignal.any` folds the two into one so the\n\t\t// caller's signal is still what fetch sees when no timeout is asked for.\n\t\tconst timeout =\n\t\t\ttimeoutMs === undefined ? undefined : AbortSignal.timeout(timeoutMs);\n\n\t\tconst signals = [requestInit.signal, timeout].filter(\n\t\t\t(candidate): candidate is AbortSignal => candidate != null,\n\t\t);\n\n\t\tconst signal =\n\t\t\tsignals.length === 0\n\t\t\t\t? undefined\n\t\t\t\t: signals.length === 1\n\t\t\t\t\t? signals[0]\n\t\t\t\t\t: AbortSignal.any(signals);\n\n\t\tconst response = await this.#fetch(`${this.#baseUrl}${path}`, {\n\t\t\t...requestInit,\n\t\t\theaders,\n\t\t\tsignal,\n\t\t});\n\n\t\tif (!response.ok) {\n\t\t\tthrow await this.#toError(response);\n\t\t}\n\n\t\treturn (await response.json()) as T;\n\t}\n\n\t/**\n\t * A read whose body is Markdown rather than JSON.\n\t *\n\t * The export and the `format=markdown` context are documents, not\n\t * envelopes, so they are read as text. Errors still arrive as the JSON\n\t * envelope every other route uses, so the failure path is `#toError`'s,\n\t * unchanged.\n\t */\n\tasync #text(\n\t\tpath: string,\n\t\tparams?: Record<string, QueryValue>,\n\t\toptions?: TasqRequestOptions,\n\t): Promise<string> {\n\t\tconst headers = new Headers({ accept: \"text/markdown\" });\n\n\t\tif (this.#token === undefined) throw noCredentialError();\n\n\t\theaders.set(\"authorization\", `Bearer ${this.#token}`);\n\n\t\tconst timeout =\n\t\t\toptions?.timeoutMs === undefined\n\t\t\t\t? undefined\n\t\t\t\t: AbortSignal.timeout(options.timeoutMs);\n\n\t\tconst signals = [options?.signal, timeout].filter(\n\t\t\t(candidate): candidate is AbortSignal => candidate != null,\n\t\t);\n\n\t\tconst signal =\n\t\t\tsignals.length === 0\n\t\t\t\t? undefined\n\t\t\t\t: signals.length === 1\n\t\t\t\t\t? signals[0]\n\t\t\t\t\t: AbortSignal.any(signals);\n\n\t\tconst response = await this.#fetch(\n\t\t\t`${this.#baseUrl}${path}${queryString(params)}`,\n\t\t\t{ headers, signal },\n\t\t);\n\n\t\tif (!response.ok) throw await this.#toError(response);\n\n\t\treturn await response.text();\n\t}\n\n\tasync #toError(response: Response): Promise<TasqApiError> {\n\t\tconst retryAfter = response.headers.get(\"retry-after\");\n\n\t\tconst fallback = {\n\t\t\tcode: `HTTP_${response.status}`,\n\t\t\tmessage: `Request failed with status ${response.status}`,\n\t\t};\n\n\t\tconst envelope = (await response.json().catch(() => null)) as {\n\t\t\terror?: { code?: string; message?: string; details?: unknown };\n\t\t} | null;\n\n\t\tconst error = envelope?.error;\n\n\t\tconst body =\n\t\t\terror?.code === undefined\n\t\t\t\t? fallback\n\t\t\t\t: {\n\t\t\t\t\t\tcode: error.code,\n\t\t\t\t\t\tmessage: error.message ?? fallback.message,\n\t\t\t\t\t\tdetails: error.details,\n\t\t\t\t\t};\n\n\t\treturn toTasqError(response.status, body, retryAfter);\n\t}\n\n\t#get<T>(\n\t\tpath: string,\n\t\tparams?: Record<string, QueryValue>,\n\t\toptions?: TasqRequestOptions,\n\t): Promise<T> {\n\t\treturn this.#request<T>(`${path}${queryString(params)}`, options);\n\t}\n\n\treadonly workspaces = {\n\t\tlist: async (): Promise<WorkspaceSummary[]> =>\n\t\t\t(await this.#get<{ workspaces: WorkspaceSummary[] }>(\"/workspaces\"))\n\t\t\t\t.workspaces,\n\n\t\tget: async (slug: string): Promise<WorkspaceDetail> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ workspace: WorkspaceDetail }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}`,\n\t\t\t\t)\n\t\t\t).workspace,\n\t};\n\n\treadonly tasks = {\n\t\tlist: async (\n\t\t\tslug: string,\n\t\t\tfilters?: TaskListFilters,\n\t\t): Promise<TaskListItem[]> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ tasks: TaskListItem[] }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/tasks`,\n\t\t\t\t\tfilters,\n\t\t\t\t)\n\t\t\t).tasks,\n\n\t\tget: async (slug: string, taskId: string): Promise<TaskDetail> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ task: TaskDetail }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/tasks/${encodeURIComponent(taskId)}`,\n\t\t\t\t)\n\t\t\t).task,\n\n\t\t/**\n\t\t * Ask a person to sign off on a task (6.3). Asking again while a\n\t\t * request stands replaces the approver. The approver cannot be an agent.\n\t\t */\n\t\trequestApproval: (\n\t\t\tslug: string,\n\t\t\ttaskId: string,\n\t\t\tapproverId: string,\n\t\t): Promise<DispatchResponse<\"task.requestApproval\">> =>\n\t\t\tthis.dispatch(\"task.requestApproval\", slug, { taskId, approverId }),\n\n\t\t/**\n\t\t * The approver's answer (6.3). `approve` also moves the task to the next\n\t\t * status in its team's category order. Person credentials only: no\n\t\t * agent policy can include it.\n\t\t */\n\t\tdecide: (\n\t\t\tslug: string,\n\t\t\ttaskId: string,\n\t\t\tdecision: TaskApprovalDecision,\n\t\t): Promise<DispatchResponse<\"task.decide\">> =>\n\t\t\tthis.dispatch(\"task.decide\", slug, { taskId, decision }),\n\t};\n\n\treadonly projects = {\n\t\tlist: async (slug: string): Promise<ProjectListItem[]> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ projects: ProjectListItem[] }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/projects`,\n\t\t\t\t)\n\t\t\t).projects,\n\n\t\tget: async (slug: string, projectId: string): Promise<ProjectDetail> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ project: ProjectDetail }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/projects/${encodeURIComponent(projectId)}`,\n\t\t\t\t)\n\t\t\t).project,\n\n\t\t/**\n\t\t * Pin a project to the caller's own sidebar. People only: an agent\n\t\t * key is refused by policy whatever its preset.\n\t\t */\n\t\tstar: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"project.star\"],\n\t\t): Promise<DispatchResponse<\"project.star\">> =>\n\t\t\tthis.dispatch(\"project.star\", slug, input),\n\n\t\tunstar: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"project.unstar\"],\n\t\t): Promise<DispatchResponse<\"project.unstar\">> =>\n\t\t\tthis.dispatch(\"project.unstar\", slug, input),\n\t};\n\n\t/**\n\t * Initiatives group projects across teams. Any member reads them; every\n\t * write is admin-level, so an agent key (always a member) cannot make one.\n\t */\n\treadonly initiatives = {\n\t\tlist: async (slug: string): Promise<InitiativeListItem[]> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ initiatives: InitiativeListItem[] }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/initiatives`,\n\t\t\t\t)\n\t\t\t).initiatives,\n\n\t\tcreate: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"initiative.create\"],\n\t\t): Promise<DispatchResponse<\"initiative.create\">> =>\n\t\t\tthis.dispatch(\"initiative.create\", slug, input),\n\n\t\tupdate: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"initiative.update\"],\n\t\t): Promise<DispatchResponse<\"initiative.update\">> =>\n\t\t\tthis.dispatch(\"initiative.update\", slug, input),\n\n\t\tdelete: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"initiative.delete\"],\n\t\t): Promise<DispatchResponse<\"initiative.delete\">> =>\n\t\t\tthis.dispatch(\"initiative.delete\", slug, input),\n\n\t\tlinkProject: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"initiative.linkProject\"],\n\t\t): Promise<DispatchResponse<\"initiative.linkProject\">> =>\n\t\t\tthis.dispatch(\"initiative.linkProject\", slug, input),\n\n\t\tunlinkProject: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"initiative.unlinkProject\"],\n\t\t): Promise<DispatchResponse<\"initiative.unlinkProject\">> =>\n\t\t\tthis.dispatch(\"initiative.unlinkProject\", slug, input),\n\t};\n\n\t/**\n\t * Project updates: a health call and a body for the project's client (7.5).\n\t *\n\t * `draft` is what an agent calls; an agent's update is always a draft\n\t * whatever it passes. `send` is people only: no agent policy can grant it,\n\t * because nothing an agent drafts goes to a client without a person\n\t * approving it.\n\t */\n\treadonly projectUpdates = {\n\t\t/** Every update on the project, drafts included, newest first. */\n\t\tlist: async (\n\t\t\tslug: string,\n\t\t\tprojectId: string,\n\t\t): Promise<ProjectUpdateListItem[]> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ updates: ProjectUpdateListItem[] }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/projects/${encodeURIComponent(projectId)}/updates`,\n\t\t\t\t)\n\t\t\t).updates,\n\n\t\tdraft: (\n\t\t\tslug: string,\n\t\t\tinput: Omit<ActionInputMap[\"projectUpdate.create\"], \"send\">,\n\t\t): Promise<DispatchResponse<\"projectUpdate.create\">> =>\n\t\t\tthis.dispatch(\"projectUpdate.create\", slug, input),\n\n\t\tcreate: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"projectUpdate.create\"],\n\t\t): Promise<DispatchResponse<\"projectUpdate.create\">> =>\n\t\t\tthis.dispatch(\"projectUpdate.create\", slug, input),\n\n\t\tupdate: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"projectUpdate.update\"],\n\t\t): Promise<DispatchResponse<\"projectUpdate.update\">> =>\n\t\t\tthis.dispatch(\"projectUpdate.update\", slug, input),\n\n\t\tsend: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"projectUpdate.send\"],\n\t\t): Promise<DispatchResponse<\"projectUpdate.send\">> =>\n\t\t\tthis.dispatch(\"projectUpdate.send\", slug, input),\n\n\t\tdelete: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"projectUpdate.delete\"],\n\t\t): Promise<DispatchResponse<\"projectUpdate.delete\">> =>\n\t\t\tthis.dispatch(\"projectUpdate.delete\", slug, input),\n\t};\n\n\treadonly threads = {\n\t\t/**\n\t\t * The context bundle for one thread: the entity it hangs off, the\n\t\t * transcript, recent activity, and the participants (D-6).\n\t\t *\n\t\t * Authorized by the entity's own read rule, so a read-only agent may\n\t\t * pull it. Lists are capped per D-8 with `truncated` flags.\n\t\t */\n\t\tcontext: (\n\t\t\tslug: string,\n\t\t\tthreadId: string,\n\t\t\toptions?: TasqRequestOptions,\n\t\t): Promise<ThreadContext> =>\n\t\t\tthis.#get<ThreadContext>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/threads/${encodeURIComponent(threadId)}/context`,\n\t\t\t\tundefined,\n\t\t\t\toptions,\n\t\t\t),\n\t};\n\n\treadonly cycles = {\n\t\tlist: async (\n\t\t\tslug: string,\n\t\t\tfilters?: CycleListFilters,\n\t\t): Promise<CycleListItem[]> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ cycles: CycleListItem[] }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/cycles`,\n\t\t\t\t\tfilters,\n\t\t\t\t)\n\t\t\t).cycles,\n\n\t};\n\n\treadonly teams = {\n\t\tlist: async (slug: string): Promise<TeamListItem[]> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ teams: TeamListItem[] }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/teams`,\n\t\t\t\t)\n\t\t\t).teams,\n\n\t\t/** The only read that carries a team's statuses. */\n\t\tget: async (slug: string, identifier: string): Promise<TeamDetail> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ team: TeamDetail }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/teams/${encodeURIComponent(identifier)}`,\n\t\t\t\t)\n\t\t\t).team,\n\n\t\t/**\n\t\t * Whether agents on this team may wake each other, plus the loop and\n\t\t * fan-out limits that stand behind the open setting (B-04c D-1).\n\t\t *\n\t\t * Read-only here on purpose: saving the setting is admin-only and web-only\n\t\t * (D-8), so no agent key can reach it.\n\t\t */\n\t\tagentSettings: (\n\t\t\tslug: string,\n\t\t\tidentifier: string,\n\t\t): Promise<TeamAgentSettingsResponse> =>\n\t\t\tthis.#get<TeamAgentSettingsResponse>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/teams/${encodeURIComponent(identifier)}/agent-settings`,\n\t\t\t),\n\t};\n\n\treadonly labels = {\n\t\tlist: async (slug: string): Promise<LabelListItem[]> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ labels: LabelListItem[] }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/labels`,\n\t\t\t\t)\n\t\t\t).labels,\n\t};\n\n\treadonly agents = {\n\t\tpolicy: (slug: string, agentId: string): Promise<AgentPolicyDetail> =>\n\t\t\tthis.#get<AgentPolicyDetail>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/agents/${encodeURIComponent(agentId)}/policy`,\n\t\t\t),\n\n\t\t/**\n\t\t * Long-poll for mentions addressed to the agent behind this key.\n\t\t *\n\t\t * The same call acks: ids passed as `ack` are marked before the select\n\t\t * runs, so a runner's next poll is also its acknowledgement of the last\n\t\t * batch (D-5). Agent keys only.\n\t\t */\n\t\tevents: (\n\t\t\tslug: string,\n\t\t\tquery: AgentEventsQuery = {},\n\t\t\toptions?: TasqRequestOptions,\n\t\t): Promise<AgentEventsResponse> =>\n\t\t\tthis.#get<AgentEventsResponse>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/agents/me/events`,\n\t\t\t\t{\n\t\t\t\t\twait: query.wait,\n\t\t\t\t\tlimit: query.limit,\n\t\t\t\t\tack:\n\t\t\t\t\t\tquery.ack === undefined || query.ack.length === 0\n\t\t\t\t\t\t\t? undefined\n\t\t\t\t\t\t\t: query.ack.join(\",\"),\n\t\t\t\t},\n\t\t\t\toptions,\n\t\t\t),\n\t};\n\n\t/**\n\t * Releases: the structural record of a cycle close, and the narrative an\n\t * agent or a person attaches to it (B-04d).\n\t *\n\t * Reads are authorized by the workspace role guard rather than a policy\n\t * action, so a read-only agent may pull the context it needs; the write\n\t * goes through `release.saveNarrative` like every other action.\n\t */\n\treadonly releases = {\n\t\tlist: async (\n\t\t\tslug: string,\n\t\t\tteamIdentifier?: string,\n\t\t): Promise<ReleaseSummary[]> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ releases: ReleaseSummary[] }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/releases`,\n\t\t\t\t\t{ team: teamIdentifier },\n\t\t\t\t)\n\t\t\t).releases,\n\n\t\tget: async (slug: string, releaseId: string): Promise<Release> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ release: Release }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/releases/${encodeURIComponent(releaseId)}`,\n\t\t\t\t)\n\t\t\t).release,\n\n\t\t/**\n\t\t * The context bundle a narrator writes from.\n\t\t *\n\t\t * `format: \"markdown\"` returns the server-rendered prompt as a string,\n\t\t * which is what a harness pastes into a model; the default returns the\n\t\t * bundle, for a runner that branches on the fields itself.\n\t\t */\n\t\tcontext: ((\n\t\t\tslug: string,\n\t\t\treleaseId: string,\n\t\t\toptions: { format?: \"json\" | \"markdown\" } & TasqRequestOptions = {},\n\t\t): Promise<ReleaseContext | string> => {\n\t\t\tconst path = `/workspaces/${encodeURIComponent(slug)}/releases/${encodeURIComponent(releaseId)}/context`;\n\n\t\t\treturn options.format === \"markdown\"\n\t\t\t\t? this.#text(path, { format: \"markdown\" }, options)\n\t\t\t\t: this.#get<ReleaseContext>(path, undefined, options);\n\t\t}) as ReleaseContextRead,\n\n\t\tdiff: async (slug: string, releaseId: string): Promise<ReleaseDiff> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ releaseId: string; diff: ReleaseDiff }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/releases/${encodeURIComponent(releaseId)}/diff`,\n\t\t\t\t)\n\t\t\t).diff,\n\n\t\t/** The release as a Markdown document, the same body the web export serves. */\n\t\texport: (slug: string, releaseId: string): Promise<string> =>\n\t\t\tthis.#text(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/releases/${encodeURIComponent(releaseId)}/export`,\n\t\t\t),\n\n\t\t/** Last write wins; the author and timestamp move with the body (D-3). */\n\t\tsaveNarrative: (\n\t\t\tslug: string,\n\t\t\tinput: { releaseId: string; narrative: string },\n\t\t): Promise<DispatchResponse<\"release.saveNarrative\">> =>\n\t\t\tthis.dispatch(\"release.saveNarrative\", slug, input),\n\t};\n\n\treadonly members = {\n\t\tlist: async (slug: string): Promise<WorkspaceMemberListItem[]> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ members: WorkspaceMemberListItem[] }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/members`,\n\t\t\t\t)\n\t\t\t).members,\n\t};\n\n\treadonly notifications = {\n\t\tlist: (\n\t\t\tslug: string,\n\t\t\tquery: { unread?: boolean } = {},\n\t\t): Promise<NotificationsResponse> =>\n\t\t\tthis.#get<NotificationsResponse>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/notifications`,\n\t\t\t\t{ unread: query.unread === true ? 1 : undefined },\n\t\t\t),\n\t};\n\n\treadonly auth = {\n\t\t/** The principal behind the current credential. */\n\t\tme: async (): Promise<CurrentUser> =>\n\t\t\t(await this.#get<{ user: CurrentUser }>(\"/auth/me\")).user,\n\n\t\t/** Step one of CLI login: mail a sign-in code. Needs no credential. */\n\t\trequestMagicLink: async (input: { email: string }): Promise<void> => {\n\t\t\tawait this.#request<unknown>(\"/auth/magic-link\", {\n\t\t\t\tmethod: \"POST\",\n\t\t\t\tbody: JSON.stringify({ email: input.email }),\n\t\t\t\tanonymous: true,\n\t\t\t});\n\t\t},\n\n\t\t/** Step two: exchange the code for a `tq_us_…` token. Needs no credential. */\n\t\tverifyCliCode: (input: {\n\t\t\temail: string;\n\t\t\tcode: string;\n\t\t\tlabel: string;\n\t\t}): Promise<CliTokenIssued> =>\n\t\t\tthis.#request<CliTokenIssued>(\"/auth/cli/verify-code\", {\n\t\t\t\tmethod: \"POST\",\n\t\t\t\tbody: JSON.stringify(input),\n\t\t\t\tanonymous: true,\n\t\t\t}),\n\n\t\t/** Revoke the user token this client authenticates with. */\n\t\trevokeUserToken: async (): Promise<void> => {\n\t\t\tawait this.#request<unknown>(\"/auth/cli/token\", { method: \"DELETE\" });\n\t\t},\n\t};\n\n\t/** Run a write action. The API validates `input`; the SDK does not. */\n\tdispatch<TName extends ActionName>(\n\t\taction: TName,\n\t\tslug: string,\n\t\tinput: ActionInputMap[TName],\n\t): Promise<DispatchResponse<TName>> {\n\t\treturn this.#request<DispatchResponse<TName>>(\n\t\t\t`/workspaces/${encodeURIComponent(slug)}/actions`,\n\t\t\t{ method: \"POST\", body: JSON.stringify({ action, input }) },\n\t\t);\n\t}\n}\n","/**\n * Response shapes for the read routes the client wraps.\n *\n * These are hand-declared rather than re-exported from `AppType`. Deriving\n * them with `InferResponseType` typechecks, but neither tsup's `dts.resolve`\n * nor `tsc --declaration` expands a type alias on emit: the published\n * `.d.ts` kept a live `hono/client` import and a dangling `AppType`\n * reference that no consumer can resolve, and some inferred members (the\n * cycle `status` field) print as an absolute path into `apps/api`.\n *\n * So the shapes live here, and `types.equality.ts` asserts each one is\n * structurally identical to what the route actually returns. A handler\n * change breaks `bun run typecheck`, which is the drift guard the derived\n * version was there to provide.\n *\n * All timestamps are ISO-8601 strings: this is the JSON-serialised form.\n */\n\nimport type { TeamKind, TeamLabels, TeamModules } from \"./contracts\";\n\nexport type WorkspaceRole = \"owner\" | \"admin\" | \"member\";\n\nexport type WorkspaceSummary = {\n\tid: string;\n\tname: string;\n\tslug: string;\n\trole: WorkspaceRole;\n\tjoinedAt: string;\n\tcreatedAt: string;\n\tupdatedAt: string;\n};\n\nexport type WorkspaceDetail = {\n\tid: string;\n\tname: string;\n\tslug: string;\n\trole: WorkspaceRole;\n\tcreatedAt: string;\n\tupdatedAt: string;\n};\n\nexport type MemberRef = {\n\tmemberId: string;\n\tname: string | null;\n\temail: string | null;\n};\n\nexport type PersonRef = {\n\tid: string;\n\tname: string | null;\n\temail: string | null;\n};\n\nexport type TaskStatusRef = {\n\tid: string;\n\tname: string;\n\tcolor: string;\n\tcategory: string;\n\tposition: number;\n};\n\nexport type TaskLabelRef = {\n\tid: string;\n\tname: string;\n\tcolor: string;\n};\n\nexport type TaskListItem = {\n\tid: string;\n\tidentifier: string;\n\tnumber: number;\n\ttitle: string;\n\tpriority: string;\n\testimateValue: number | null;\n\testimateSettingsRevisionId: string | null;\n\tsortOrder: number;\n\tarchivedAt: string | null;\n\tcreatedAt: string;\n\tupdatedAt: string;\n\tteamId: string;\n\tteamIdentifier: string;\n\t/** 5.2: the team's kind and modules, so a client can hide a surface. */\n\tteamKind: TeamKind;\n\tteamModules: TeamModules;\n\tprojectId: string | null;\n\tmilestoneId: string | null;\n\t/** 5.5: the task this is a subtask of, one level only (D-2). */\n\tparentTaskId: string | null;\n\t/** The parent's key, so a subtask shown away from its parent can name it. */\n\tparentIdentifier: string | null;\n\t/**\n\t * 5.5: how many subtasks this task has and how many are done, the `n/m` a\n\t * client shows. Cancelled and archived subtasks are in neither number.\n\t */\n\tsubtaskProgress: SubtaskProgress;\n\tcycleId: string | null;\n\t/** All-day `YYYY-MM-DD` dates, never instants (D-5). */\n\tdueDate: string | null;\n\tstartDate: string | null;\n\tstatus: TaskStatusRef;\n\tassignee: MemberRef | null;\n\t/** 6.3: where a sign-off stands; null until someone asks for one. */\n\tapproval: TaskApproval | null;\n\tlabels: TaskLabelRef[];\n};\n\n/**\n * A task's approval (6.3). `approver` is null when the person asked has since\n * left the workspace; the request still stands.\n */\nexport type TaskApproval = {\n\tstate: \"requested\" | \"approved\" | \"changes_requested\" | \"rejected\";\n\tapprover: { memberId: string; name: string | null } | null;\n\trequestedAt: string | null;\n\tdecidedAt: string | null;\n};\n\n/** What `task.decide` takes: approve, ask for changes, or reject. */\nexport type TaskApprovalDecision = \"approve\" | \"changes\" | \"reject\";\n\nexport type SubtaskProgress = { total: number; completed: number };\n\nexport type NamedRef = { id: string; name: string };\n\nexport type TaskComment = {\n\tid: string;\n\tbody: string;\n\t/** The comment this one replies to. One level of threading only (D-3). */\n\tparentId: string | null;\n\tcreatedAt: string;\n\tupdatedAt: string;\n\t/** Null when the author's membership is gone. */\n\tauthorType: \"user\" | \"agent\" | null;\n\tmentions: Array<{ agentId: string; name: string | null }>;\n\tauthor: MemberRef | null;\n};\n\nexport type TaskActivityEntry = {\n\tid: string;\n\taction: string;\n\tfieldChanged: string | null;\n\toldValue: string | null;\n\tnewValue: string | null;\n\tcreatedAt: string;\n\tactorType: \"user\" | \"agent\" | \"system\";\n\tactor: MemberRef | null;\n};\n\nexport type EstimateScale = \"fibonacci\" | \"linear\";\n\nexport type TaskEstimateEditing =\n\t| {\n\t\t\tenabled: true;\n\t\t\tscale: EstimateScale;\n\t\t\tvalues: number[];\n\t\t\trevisionId: string;\n\t\t\tepoch: string;\n\t\t}\n\t| { enabled: false };\n\n/** A TipTap JSON document. Kept opaque so no editor types reach consumers. */\n/** A JSON value carried by a description node attribute. */\nexport type DescriptionAttrValue =\n\t| string\n\t| number\n\t| boolean\n\t| null\n\t| DescriptionAttrValue[]\n\t| { [key: string]: DescriptionAttrValue };\n\nexport type DescriptionAttrs = { [key: string]: DescriptionAttrValue };\n\nexport type DescriptionMark = { type: string; attrs?: DescriptionAttrs };\n\nexport type DescriptionNode = {\n\ttype?: string;\n\ttext?: string;\n\tattrs?: DescriptionAttrs;\n\tmarks?: DescriptionMark[];\n\tcontent?: DescriptionNode[];\n};\n\nexport type DescriptionDocumentJson = {\n\tversion: 1;\n\tcontent: DescriptionNode;\n};\n\nexport type TaskDetail = TaskListItem & {\n\tdescription: string | null;\n\tdescriptionDocument: DescriptionDocumentJson | null;\n\tdescriptionMarkdown: string | null;\n\testimateEditing: TaskEstimateEditing;\n\tproject: NamedRef | null;\n\tmilestone: NamedRef | null;\n\tcycle: NamedRef | null;\n\t/** 5.5: this task's subtasks, unarchived, oldest first. */\n\tsubtasks: TaskListItem[];\n\t/** 5.5: set when this task is itself a subtask. */\n\tparent: { id: string; identifier: string; title: string } | null;\n\tcomments: TaskComment[];\n\tactivityLog: TaskActivityEntry[];\n};\n\nexport type TaskCounts = {\n\tbacklog: number;\n\tunstarted: number;\n\tstarted: number;\n\tcompleted: number;\n\tcancelled: number;\n\ttotal: number;\n};\n\nexport type EffortByTeam = {\n\tteamId: string;\n\tteamIdentifier: string;\n\tmode: \"count\" | \"effort\";\n\tscale: EstimateScale | null;\n\tpoints: number;\n\tunestimatedTasks: number;\n};\n\nexport type TeamRef = { id: string; name: string; identifier: string };\n\nexport type ProjectStatus =\n\t| \"backlog\"\n\t| \"planned\"\n\t| \"in_progress\"\n\t| \"completed\"\n\t| \"cancelled\";\n\n/** A project's health, as called by its latest sent update (7.5). */\nexport const PROJECT_HEALTH_VALUES = [\n\t\"on_track\",\n\t\"at_risk\",\n\t\"off_track\",\n] as const;\n\nexport type ProjectHealth = (typeof PROJECT_HEALTH_VALUES)[number];\n\nexport type ProjectListItem = {\n\tid: string;\n\tworkspaceId: string;\n\tname: string;\n\tdescription: string | null;\n\tstatus: ProjectStatus;\n\tstartDate: string | null;\n\ttargetDate: string | null;\n\tleadId: string | null;\n\tarchivedAt: string | null;\n\tcreatedAt: string;\n\tupdatedAt: string;\n\ttaskCounts: TaskCounts;\n\tcompletionPercentage: number;\n\teffortByTeam: EffortByTeam[];\n\tteams: TeamRef[];\n\tlead: PersonRef | null;\n\tmembers: PersonRef[];\n\t/** Null until a project update has been sent. Drafts never move it. */\n\thealth: ProjectHealth | null;\n\t/** When the latest sent update went out. */\n\tlatestUpdateAt: string | null;\n\t/** Whether the calling member starred it. Always false for an agent key. */\n\tstarred: boolean;\n\t/** Active initiatives the project belongs to, by name. */\n\tinitiatives: InitiativeRef[];\n};\n\nexport type InitiativeRef = { id: string; name: string };\n\nexport type InitiativeStatus = \"active\" | \"archived\";\n\n/** One row of `GET /workspaces/:slug/initiatives`, archived ones included. */\nexport type InitiativeListItem = {\n\tid: string;\n\tname: string;\n\tstatus: InitiativeStatus;\n\townerMemberId: string | null;\n\tprojectIds: string[];\n\tcreatedAt: string;\n};\n\nexport type ProjectMilestone = {\n\tid: string;\n\tname: string;\n\tdescription: string | null;\n\ttargetDate: string | null;\n\tposition: number;\n\ttaskCounts: TaskCounts;\n\tcompletionPercentage: number;\n\tisCurrent: boolean;\n\teffortByTeam: EffortByTeam[];\n};\n\nexport type ProjectDetail = ProjectListItem & {\n\tmilestones: ProjectMilestone[];\n\ttasks: TaskListItem[];\n\t/** Project threads, same shape as task detail comments (D-2). */\n\tcomments: TaskComment[];\n};\n\n/** Who wrote a project update. Null once the author has left. */\nexport type ProjectUpdateAuthor = {\n\tmemberId: string;\n\tname: string;\n\tkind: \"user\" | \"agent\";\n};\n\n/** One row of `GET /workspaces/:slug/projects/:projectId/updates`, newest first. */\nexport type ProjectUpdateListItem = {\n\tid: string;\n\tprojectId: string;\n\thealth: ProjectHealth;\n\tbody: string;\n\tauthor: ProjectUpdateAuthor | null;\n\tactorType: \"user\" | \"agent\";\n\t/** Null while the update is a draft. */\n\tsentAt: string | null;\n\tcreatedAt: string;\n\tupdatedAt: string;\n};\n\nexport type CycleState = \"upcoming\" | \"active\" | \"completed\";\n\nexport type CycleListItem = {\n\tid: string;\n\tteamId: string;\n\tteamIdentifier: string;\n\tteamName: string;\n\tname: string;\n\tdescription: string | null;\n\tstartDate: string;\n\tendDate: string;\n\tdateConvention: \"legacy\" | \"exclusive\";\n\tsource: \"legacy\" | \"generated\" | \"override\";\n\tcadenceRevisionId: string | null;\n\tcadenceSequence: number | null;\n\tcadenceTimezone: string | null;\n\tstatus: CycleState;\n\tstate: CycleState;\n\tlegacyStatus: \"upcoming\" | \"active\" | \"completed\";\n\tstateSource: \"transition_markers\" | \"planned_dates\";\n\tstartedAt: string | null;\n\tcontractFrozenAt: string | null;\n\tclosedAt: string | null;\n\treportMode: \"count\" | \"effort\";\n\treportEffectiveStartedAt: string;\n\treportingContractState: \"frozen\" | \"derived\" | \"provisional\";\n\testimateSettingsRevisionId: string | null;\n\testimateScale: EstimateScale | null;\n\testimateEpoch: string | null;\n\thistoryObservedSince: string;\n\thistoryComplete: boolean;\n\thistoryCoverage: { level: \"partial\" | \"complete\"; observedSince: string };\n\ttaskCounts: TaskCounts;\n\tcompletionPercentage: number;\n\teffort?: { readonly points: number; readonly unestimatedTasks: number };\n\tcreatedAt: string;\n\tupdatedAt: string;\n};\n\nexport type TeamListItem = {\n\tid: string;\n\tworkspaceId: string;\n\tname: string;\n\tidentifier: string;\n\tkind: TeamKind;\n\tmodules: TeamModules;\n\t/** 5.7: display words for this team's kind (D-7). */\n\tlabels: TeamLabels;\n\tmemberCount: number;\n\tcreatedAt: string;\n\tupdatedAt: string;\n};\n\nexport type StatusCategory =\n\t| \"backlog\"\n\t| \"unstarted\"\n\t| \"started\"\n\t| \"completed\"\n\t| \"cancelled\";\n\nexport type TeamStatus = {\n\tid: string;\n\tname: string;\n\tcolor: string;\n\tposition: number;\n\tcategory: StatusCategory;\n};\n\n/** `GET /workspaces/:slug/teams/:identifier` — the only read with statuses. */\nexport type TeamDetail = {\n\tid: string;\n\tworkspaceId: string;\n\tname: string;\n\tidentifier: string;\n\tkind: TeamKind;\n\tmodules: TeamModules;\n\tlabels: TeamLabels;\n\tcreatedAt: string;\n\tupdatedAt: string;\n\tstatuses: TeamStatus[];\n};\n\nexport type LabelListItem = {\n\tid: string;\n\tworkspaceId: string;\n\tname: string;\n\tcolor: string;\n\tcreatedAt: string;\n\tupdatedAt: string;\n};\n\nexport type AgentPolicyPresetName = \"read_only\" | \"triage\" | \"full\" | \"custom\";\n\nexport type AgentPolicyDetail = {\n\tpolicy: {\n\t\tid: string;\n\t\tversion: number;\n\t\tpreset: AgentPolicyPresetName;\n\t\tallowedActions: string[];\n\t};\n\tallowable: string[];\n\thistory: {\n\t\tversion: number;\n\t\tpreset: AgentPolicyPresetName;\n\t\tcreatedAt: string;\n\t\tcreatedByName: string | null;\n\t}[];\n};\n\nexport type CurrentUser = {\n\tid: string;\n\temail: string;\n\tname: string | null;\n\tavatarUrl: string | null;\n\tcreatedAt: string;\n};\n\n/** Filters accepted by `GET /workspaces/:slug/tasks`. */\nexport type TaskListFilters = {\n\tteam?: string;\n\tstatus?: string;\n\tassignee?: string;\n\tpriority?: string;\n\tproject?: string;\n\tcycle?: string;\n\t/** `overdue`, `today`, `week`, or `none` for tasks with no due date. */\n\tdue?: string;\n\t/** `due` orders by due date, dated tasks first. */\n\tsort?: string;\n\tq?: string;\n\tincludeArchived?: boolean;\n};\n\n/** Filters accepted by `GET /workspaces/:slug/cycles`. */\nexport type CycleListFilters = {\n\tteam?: string;\n};\n\n/** `POST /auth/cli/verify-code` response. */\nexport type CliTokenIssued = {\n\ttoken: string;\n\texpiresAt: string;\n\tuser: { id: string; email: string; name: string | null };\n};\n\n/** Who wrote the comment behind an event or a notification. */\nexport type MentionActorRef = {\n\tmemberId: string;\n\ttype: \"user\" | \"agent\";\n\tname: string | null;\n};\n\n/**\n * One row of `GET /workspaces/:slug/agents/me/events`.\n *\n * `mention` is a request addressed to the agent; `thread_message` is a later\n * human message in a thread the agent already joined (D-4). Ids only (D-6):\n * every read from these ids passes the policy layer.\n */\nexport type AgentEvent = {\n\tid: string;\n\tkind: \"mention\" | \"thread_message\" | \"cycle_closed\";\n\tworkspace: string;\n\t/** Exactly one of `taskId` / `projectId` is set: the entity the thread is on. */\n\ttaskId: string | null;\n\ttaskKey: string | null;\n\tprojectId: string | null;\n\t/** The thread the comment belongs to: the root comment's id (D-1). */\n\tthreadId: string | null;\n\tcommentId: string | null;\n\t/** Set only on `cycle_closed`: the release to narrate (B-04d D-2). */\n\treleaseId: string | null;\n\tmentionedBy: MentionActorRef | null;\n\tdeliveryCount: number;\n\tcreatedAt: string;\n};\n\n/** `GET /workspaces/:slug/agents/me/events` */\nexport type AgentEventsResponse = {\n\tevents: AgentEvent[];\n\tacked: string[];\n};\n\n/**\n * One row of `GET /workspaces/:slug/notifications`.\n *\n * `agent_reply` is a direct reply to the human's own message; `thread_reply`\n * is an agent message in a thread the human participates in (D-9).\n */\nexport type NotificationItem = {\n\tid: string;\n\tkind:\n\t\t| \"agent_reply\"\n\t\t| \"thread_reply\"\n\t\t| \"release_ready\"\n\t\t| \"approval_requested\"\n\t\t| \"approval_decided\";\n\t/** Exactly one of `taskId` / `projectId` is set: the entity the thread is on. */\n\ttaskId: string | null;\n\ttaskKey: string | null;\n\tprojectId: string | null;\n\t/** Name of the project a project thread is on; null for a task thread. */\n\tprojectName: string | null;\n\t/** The thread the comment belongs to: the root comment's id (D-1). */\n\tthreadId: string | null;\n\tcommentId: string | null;\n\t/** Set only on `release_ready`: the release and how to name it (B-04d D-1). */\n\treleaseId: string | null;\n\treleaseNumber: number | null;\n\treleaseTeamIdentifier: string | null;\n\tactor: MentionActorRef | null;\n\treadAt: string | null;\n\tcreatedAt: string;\n};\n\n/** `GET /workspaces/:slug/notifications` */\nexport type NotificationsResponse = {\n\tnotifications: NotificationItem[];\n\tunreadCount: number;\n};\n\n/**\n * One row of `GET /workspaces/:slug/members`, narrowed to what the CLI needs\n * to turn an `--mention <name>` into an agent id. The route returns more per\n * agent (policy, keys); those members are left off deliberately so the SDK\n * does not promise a shape the CLI never reads.\n */\nexport type WorkspaceMemberListItem = {\n\tid: string;\n\tagentId: string | null;\n\ttype: \"user\" | \"agent\";\n\tname: string | null;\n\temail: string | null;\n\trole: \"owner\" | \"admin\" | \"member\";\n};\n\n// ---------------------------------------------------------------------------\n// Thread context (B-04 slice 2, D-6/D-8).\n// ---------------------------------------------------------------------------\n\n/** Last N messages returned in a thread transcript (D-8). */\nexport const THREAD_CONTEXT_MESSAGE_LIMIT = 50;\n\n/** Last N activity rows returned for the entity (D-8). */\nexport const THREAD_CONTEXT_ACTIVITY_LIMIT = 20;\n\n/** Entity description is cut at this many characters (D-8). */\nexport const THREAD_CONTEXT_DESCRIPTION_MAX = 8000;\n\nexport type ThreadContextEntity =\n\t| {\n\t\t\ttype: \"task\";\n\t\t\tid: string;\n\t\t\t/** The human task key, e.g. `ENG-248`. */\n\t\t\tkey: string | null;\n\t\t\ttitle: string;\n\t\t\tstatus: string | null;\n\t\t\tdescription: string | null;\n\t\t\tdescriptionTruncated: boolean;\n\t\t\tproject: { id: string; name: string } | null;\n\t\t}\n\t| {\n\t\t\ttype: \"project\";\n\t\t\tid: string;\n\t\t\tkey: null;\n\t\t\ttitle: string;\n\t\t\tstatus: string | null;\n\t\t\tdescription: string | null;\n\t\t\tdescriptionTruncated: boolean;\n\t\t\tteams: Array<{ id: string; identifier: string; name: string }>;\n\t\t};\n\nexport type ThreadContextMessage = {\n\tid: string;\n\tauthorType: \"user\" | \"agent\" | null;\n\tauthorName: string | null;\n\tbody: string;\n\tcreatedAt: string;\n};\n\nexport type ThreadContextActivity = {\n\tid: string;\n\tkind: string;\n\tactorName: string | null;\n\tsummary: string;\n\tcreatedAt: string;\n};\n\nexport type ThreadContextParticipant = {\n\tmemberId: string;\n\ttype: \"user\" | \"agent\";\n\tname: string | null;\n\tjoinedVia: \"author\" | \"mention\";\n};\n\n/** `GET /workspaces/:slug/threads/:threadId/context` */\nexport type ThreadContext = {\n\tthreadId: string;\n\tentity: ThreadContextEntity;\n\tthread: {\n\t\t/** Oldest first, capped at `THREAD_CONTEXT_MESSAGE_LIMIT`. */\n\t\tmessages: Array<ThreadContextMessage>;\n\t\t/** Messages in the thread, including any the cap dropped. */\n\t\ttotal: number;\n\t\ttruncated: boolean;\n\t};\n\trecentActivity: Array<ThreadContextActivity>;\n\tparticipants: Array<ThreadContextParticipant>;\n};\n\n// ---------------------------------------------------------------------------\n// Agent isolation and loop safety (B-04c, D-1/D-4/D-5/D-6).\n// ---------------------------------------------------------------------------\n\n/** Whether agents on a team may wake each other. No setting means `isolated`. */\nexport const AGENT_ISOLATION_VALUES = [\"isolated\", \"open\"] as const;\n\nexport type AgentIsolation = (typeof AGENT_ISOLATION_VALUES)[number];\n\n/**\n * Why a wake was recorded `suppressed` instead of delivered. Precedence when\n * several apply: `isolation` > `loop_cap` > `fanout_cap`.\n */\nexport const SUPPRESSED_REASONS = [\n\t\"isolation\",\n\t\"fanout_cap\",\n\t\"loop_cap\",\n] as const;\n\nexport type SuppressedReason = (typeof SUPPRESSED_REASONS)[number];\n\n/** One message wakes at most this many agents (D-4). */\nexport const MAX_AGENT_WAKES_PER_MESSAGE = 10;\n\n/**\n * A thread stops waking agents after this many agent messages in a row\n * without a person posting (D-5).\n */\nexport const MAX_CONSECUTIVE_AGENT_MESSAGES = 5;\n\n/**\n * One agent's outcome for a message, as `comment.add` reports it. `reason` is\n * null exactly when the wake is `pending`.\n */\nexport type WakeOutcome = {\n\tagentId: string;\n\tstate: \"pending\" | \"suppressed\";\n\treason: SuppressedReason | null;\n};\n\n/** The stored current setting for a team; absent until somebody saves one. */\nexport type TeamAgentSettingsRecord = {\n\tteamId: string;\n\tcurrentRevisionId: string;\n\trevision: number;\n\tisolation: AgentIsolation;\n\t/** The agent woken on a cycle close, if any (B-04d D-2). */\n\treleaseNarratorMemberId: string | null;\n\tcreatedAt: string;\n\tupdatedAt: string;\n};\n\n/** `GET /workspaces/:slug/teams/:identifier/agent-settings` */\nexport type TeamAgentSettingsResponse = {\n\tsettings: TeamAgentSettingsRecord | null;\n\t/** The effective setting: `isolated` when there is no row. */\n\tisolation: AgentIsolation;\n\tlimits: {\n\t\tmaxWakesPerMessage: number;\n\t\tmaxConsecutiveAgentMessages: number;\n\t};\n};\n\n// ---------------------------------------------------------------------------\n// Releases (B-04d, D-1/D-3/D-4).\n// ---------------------------------------------------------------------------\n\n/** How a task ended the cycle. Orthogonal to `addedMidCycle`. */\nexport const RELEASE_DISPOSITIONS = [\n\t\"shipped\",\n\t\"carried_over\",\n\t\"dropped\",\n] as const;\n\nexport type ReleaseDisposition = (typeof RELEASE_DISPOSITIONS)[number];\n\n/** A narrative is capped here on the way in (D-3). */\nexport const RELEASE_NARRATIVE_MAX = 50_000;\n\n/** Narrative excerpt length in a list row and in the previous-release summary. */\nexport const RELEASE_NARRATIVE_EXCERPT_MAX = 500;\n\n/** Each context list is cut at this many tasks. */\nexport const RELEASE_CONTEXT_TASK_LIMIT = 100;\n\nexport type ReleaseTask = {\n\tsourceTaskId: string;\n\ttaskIdentifier: string;\n\ttitle: string;\n\tstatusName: string;\n\tstatusCategory: string;\n\tdisposition: ReleaseDisposition;\n\taddedMidCycle: boolean;\n};\n\n/** Who wrote the narrative currently on a release. */\nexport type ReleaseNarrativeAuthor = {\n\tmemberId: string | null;\n\ttype: \"user\" | \"agent\" | \"system\" | null;\n\tname: string | null;\n\tupdatedAt: string;\n};\n\nexport type ReleaseCounts = {\n\tshipped: number;\n\tcarriedOver: number;\n\tdropped: number;\n\taddedMidCycle: number;\n\ttotal: number;\n};\n\n/** One row of `GET /workspaces/:slug/releases`. */\nexport type ReleaseSummary = {\n\tid: string;\n\tnumber: number;\n\tteamId: string;\n\tteamIdentifier: string;\n\tcycleId: string;\n\tcycleName: string | null;\n\tclosedAt: string;\n\tcounts: ReleaseCounts;\n\t/** First `RELEASE_NARRATIVE_EXCERPT_MAX` characters, or null when unwritten. */\n\tnarrativeExcerpt: string | null;\n\tnarrativeTruncated: boolean;\n\tnarrativeAuthor: ReleaseNarrativeAuthor | null;\n\tcreatedAt: string;\n};\n\n/** `GET /workspaces/:slug/releases/:releaseId` */\nexport type Release = ReleaseSummary & {\n\tcycleStartDate: string | null;\n\tcycleEndDate: string | null;\n\tnarrative: string | null;\n\ttasks: ReleaseTask[];\n};\n\n/**\n * The change between a release and the previous release of the same team\n * (D-4). Keyed by `sourceTaskId`, so a task that moved between cycles is\n * followed across them.\n */\nexport type ReleaseDiff = {\n\tpreviousReleaseId: string | null;\n\tpreviousReleaseNumber: number | null;\n\t/** In this release, not in the previous one. */\n\tadded: ReleaseTask[];\n\t/** Shipped in this release, whatever it was in the previous one. */\n\tcompleted: ReleaseTask[];\n\t/** Carried over in both: still unfinished after two cycles. */\n\tcarried: ReleaseTask[];\n\t/** Present in the previous release, absent from this one. */\n\tdropped: ReleaseTask[];\n};\n\n/** The previous release, as the context bundle summarizes it. */\nexport type ReleasePreviousSummary = {\n\tid: string;\n\tnumber: number;\n\tclosedAt: string;\n\tcounts: ReleaseCounts;\n\tnarrativeExcerpt: string | null;\n\tnarrativeTruncated: boolean;\n};\n\n/**\n * `GET /workspaces/:slug/releases/:releaseId/context`\n *\n * One read that hands a narrator everything it needs to write the narrative.\n * Every list is capped at `RELEASE_CONTEXT_TASK_LIMIT`; `counts` carries the\n * full totals, so a renderer can say \"showing N of M\".\n */\nexport type ReleaseContext = {\n\treleaseId: string;\n\tnumber: number;\n\tteam: { id: string; identifier: string; name: string };\n\tcycle: {\n\t\tid: string;\n\t\tname: string | null;\n\t\tstartDate: string | null;\n\t\tendDate: string | null;\n\t};\n\tclosedAt: string;\n\tcounts: ReleaseCounts;\n\tshipped: ReleaseTask[];\n\tcarriedOver: ReleaseTask[];\n\tdropped: ReleaseTask[];\n\taddedMidCycle: ReleaseTask[];\n\ttruncated: boolean;\n\tprevious: ReleasePreviousSummary | null;\n\tdiff: ReleaseDiff;\n};\n"],"mappings":"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","names":[]}
|