@pxlabz/tasq-sdk 0.1.12 → 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 +461 -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
|
@@ -90,8 +90,25 @@ type TaskListItem = {
|
|
|
90
90
|
startDate: string | null;
|
|
91
91
|
status: TaskStatusRef;
|
|
92
92
|
assignee: MemberRef | null;
|
|
93
|
+
/** 6.3: where a sign-off stands; null until someone asks for one. */
|
|
94
|
+
approval: TaskApproval | null;
|
|
93
95
|
labels: TaskLabelRef[];
|
|
94
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";
|
|
95
112
|
type SubtaskProgress = {
|
|
96
113
|
total: number;
|
|
97
114
|
completed: number;
|
|
@@ -199,6 +216,9 @@ type TeamRef = {
|
|
|
199
216
|
identifier: string;
|
|
200
217
|
};
|
|
201
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];
|
|
202
222
|
type ProjectListItem = {
|
|
203
223
|
id: string;
|
|
204
224
|
workspaceId: string;
|
|
@@ -217,6 +237,28 @@ type ProjectListItem = {
|
|
|
217
237
|
teams: TeamRef[];
|
|
218
238
|
lead: PersonRef | null;
|
|
219
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;
|
|
220
262
|
};
|
|
221
263
|
type ProjectMilestone = {
|
|
222
264
|
id: string;
|
|
@@ -235,6 +277,25 @@ type ProjectDetail = ProjectListItem & {
|
|
|
235
277
|
/** Project threads, same shape as task detail comments (D-2). */
|
|
236
278
|
comments: TaskComment[];
|
|
237
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
|
+
};
|
|
238
299
|
type CycleState = "upcoming" | "active" | "completed";
|
|
239
300
|
type CycleListItem = {
|
|
240
301
|
id: string;
|
|
@@ -415,7 +476,7 @@ type AgentEventsResponse = {
|
|
|
415
476
|
*/
|
|
416
477
|
type NotificationItem = {
|
|
417
478
|
id: string;
|
|
418
|
-
kind: "agent_reply" | "thread_reply" | "release_ready";
|
|
479
|
+
kind: "agent_reply" | "thread_reply" | "release_ready" | "approval_requested" | "approval_decided";
|
|
419
480
|
/** Exactly one of `taskId` / `projectId` is set: the entity the thread is on. */
|
|
420
481
|
taskId: string | null;
|
|
421
482
|
taskKey: string | null;
|
|
@@ -699,7 +760,7 @@ type DispatchResponse<TName extends ActionName> = {
|
|
|
699
760
|
result: ActionWireOutputMap[TName];
|
|
700
761
|
invalidates: Array<Array<string>>;
|
|
701
762
|
};
|
|
702
|
-
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";
|
|
703
764
|
type ActionInputMap = Omit<ActionParsedInputMap, "cycle.create" | "cycle.update"> & {
|
|
704
765
|
"cycle.create": DatesAsInput<{
|
|
705
766
|
teamIdentifier: string;
|
|
@@ -714,7 +775,7 @@ type ActionInputMap = Omit<ActionParsedInputMap, "cycle.create" | "cycle.update"
|
|
|
714
775
|
description?: string | null | undefined;
|
|
715
776
|
startDate?: Date | undefined;
|
|
716
777
|
endDate?: Date | undefined;
|
|
717
|
-
status?: "completed" | "
|
|
778
|
+
status?: "completed" | "active" | "upcoming" | undefined;
|
|
718
779
|
}>;
|
|
719
780
|
};
|
|
720
781
|
type ActionParsedInputMap = {
|
|
@@ -782,6 +843,14 @@ type ActionParsedInputMap = {
|
|
|
782
843
|
taskId: string;
|
|
783
844
|
parentTaskId: string | null;
|
|
784
845
|
};
|
|
846
|
+
"task.requestApproval": {
|
|
847
|
+
taskId: string;
|
|
848
|
+
approverId: string;
|
|
849
|
+
};
|
|
850
|
+
"task.decide": {
|
|
851
|
+
taskId: string;
|
|
852
|
+
decision: "approve" | "changes" | "reject";
|
|
853
|
+
};
|
|
785
854
|
"task.addLabel": {
|
|
786
855
|
taskId: string;
|
|
787
856
|
labelId: string;
|
|
@@ -850,6 +919,52 @@ type ActionParsedInputMap = {
|
|
|
850
919
|
projectId: string;
|
|
851
920
|
leadId: string | null;
|
|
852
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
|
+
};
|
|
853
968
|
"milestone.create": {
|
|
854
969
|
projectId: string;
|
|
855
970
|
name: string;
|
|
@@ -885,7 +1000,7 @@ type ActionParsedInputMap = {
|
|
|
885
1000
|
description?: string | null | undefined;
|
|
886
1001
|
startDate?: Date | undefined;
|
|
887
1002
|
endDate?: Date | undefined;
|
|
888
|
-
status?: "completed" | "
|
|
1003
|
+
status?: "completed" | "active" | "upcoming" | undefined;
|
|
889
1004
|
};
|
|
890
1005
|
"cycle.delete": {
|
|
891
1006
|
cycleId: string;
|
|
@@ -1037,6 +1152,10 @@ type ActionWireOutputMap = {
|
|
|
1037
1152
|
parentTaskId: string | null;
|
|
1038
1153
|
dueDate: string | null;
|
|
1039
1154
|
startDate: string | null;
|
|
1155
|
+
approverId: string | null;
|
|
1156
|
+
approvalState: TaskApprovalStateValue;
|
|
1157
|
+
approvalRequestedAt: string | null;
|
|
1158
|
+
decidedAt: string | null;
|
|
1040
1159
|
sortOrder: number;
|
|
1041
1160
|
archivedAt: string | null;
|
|
1042
1161
|
createdAt: string;
|
|
@@ -1087,6 +1206,10 @@ type ActionWireOutputMap = {
|
|
|
1087
1206
|
parentTaskId: string | null;
|
|
1088
1207
|
dueDate: string | null;
|
|
1089
1208
|
startDate: string | null;
|
|
1209
|
+
approverId: string | null;
|
|
1210
|
+
approvalState: TaskApprovalStateValue;
|
|
1211
|
+
approvalRequestedAt: string | null;
|
|
1212
|
+
decidedAt: string | null;
|
|
1090
1213
|
sortOrder: number;
|
|
1091
1214
|
archivedAt: string | null;
|
|
1092
1215
|
createdAt: string;
|
|
@@ -1134,6 +1257,10 @@ type ActionWireOutputMap = {
|
|
|
1134
1257
|
parentTaskId: string | null;
|
|
1135
1258
|
dueDate: string | null;
|
|
1136
1259
|
startDate: string | null;
|
|
1260
|
+
approverId: string | null;
|
|
1261
|
+
approvalState: TaskApprovalStateValue;
|
|
1262
|
+
approvalRequestedAt: string | null;
|
|
1263
|
+
decidedAt: string | null;
|
|
1137
1264
|
sortOrder: number;
|
|
1138
1265
|
archivedAt: string | null;
|
|
1139
1266
|
createdAt: string;
|
|
@@ -1188,6 +1315,10 @@ type ActionWireOutputMap = {
|
|
|
1188
1315
|
parentTaskId: string | null;
|
|
1189
1316
|
dueDate: string | null;
|
|
1190
1317
|
startDate: string | null;
|
|
1318
|
+
approverId: string | null;
|
|
1319
|
+
approvalState: TaskApprovalStateValue;
|
|
1320
|
+
approvalRequestedAt: string | null;
|
|
1321
|
+
decidedAt: string | null;
|
|
1191
1322
|
sortOrder: number;
|
|
1192
1323
|
archivedAt: string | null;
|
|
1193
1324
|
createdAt: string;
|
|
@@ -1237,6 +1368,10 @@ type ActionWireOutputMap = {
|
|
|
1237
1368
|
parentTaskId: string | null;
|
|
1238
1369
|
dueDate: string | null;
|
|
1239
1370
|
startDate: string | null;
|
|
1371
|
+
approverId: string | null;
|
|
1372
|
+
approvalState: TaskApprovalStateValue;
|
|
1373
|
+
approvalRequestedAt: string | null;
|
|
1374
|
+
decidedAt: string | null;
|
|
1240
1375
|
sortOrder: number;
|
|
1241
1376
|
archivedAt: string | null;
|
|
1242
1377
|
createdAt: string;
|
|
@@ -1283,6 +1418,10 @@ type ActionWireOutputMap = {
|
|
|
1283
1418
|
parentTaskId: string | null;
|
|
1284
1419
|
dueDate: string | null;
|
|
1285
1420
|
startDate: string | null;
|
|
1421
|
+
approverId: string | null;
|
|
1422
|
+
approvalState: TaskApprovalStateValue;
|
|
1423
|
+
approvalRequestedAt: string | null;
|
|
1424
|
+
decidedAt: string | null;
|
|
1286
1425
|
sortOrder: number;
|
|
1287
1426
|
archivedAt: string | null;
|
|
1288
1427
|
createdAt: string;
|
|
@@ -1330,6 +1469,10 @@ type ActionWireOutputMap = {
|
|
|
1330
1469
|
parentTaskId: string | null;
|
|
1331
1470
|
dueDate: string | null;
|
|
1332
1471
|
startDate: string | null;
|
|
1472
|
+
approverId: string | null;
|
|
1473
|
+
approvalState: TaskApprovalStateValue;
|
|
1474
|
+
approvalRequestedAt: string | null;
|
|
1475
|
+
decidedAt: string | null;
|
|
1333
1476
|
sortOrder: number;
|
|
1334
1477
|
archivedAt: string | null;
|
|
1335
1478
|
createdAt: string;
|
|
@@ -1377,6 +1520,10 @@ type ActionWireOutputMap = {
|
|
|
1377
1520
|
parentTaskId: string | null;
|
|
1378
1521
|
dueDate: string | null;
|
|
1379
1522
|
startDate: string | null;
|
|
1523
|
+
approverId: string | null;
|
|
1524
|
+
approvalState: TaskApprovalStateValue;
|
|
1525
|
+
approvalRequestedAt: string | null;
|
|
1526
|
+
decidedAt: string | null;
|
|
1380
1527
|
sortOrder: number;
|
|
1381
1528
|
archivedAt: string | null;
|
|
1382
1529
|
createdAt: string;
|
|
@@ -1443,6 +1590,10 @@ type ActionWireOutputMap = {
|
|
|
1443
1590
|
parentTaskId: string | null;
|
|
1444
1591
|
dueDate: string | null;
|
|
1445
1592
|
startDate: string | null;
|
|
1593
|
+
approverId: string | null;
|
|
1594
|
+
approvalState: TaskApprovalStateValue;
|
|
1595
|
+
approvalRequestedAt: string | null;
|
|
1596
|
+
decidedAt: string | null;
|
|
1446
1597
|
sortOrder: number;
|
|
1447
1598
|
archivedAt: string | null;
|
|
1448
1599
|
createdAt: string;
|
|
@@ -1489,6 +1640,10 @@ type ActionWireOutputMap = {
|
|
|
1489
1640
|
parentTaskId: string | null;
|
|
1490
1641
|
dueDate: string | null;
|
|
1491
1642
|
startDate: string | null;
|
|
1643
|
+
approverId: string | null;
|
|
1644
|
+
approvalState: TaskApprovalStateValue;
|
|
1645
|
+
approvalRequestedAt: string | null;
|
|
1646
|
+
decidedAt: string | null;
|
|
1492
1647
|
sortOrder: number;
|
|
1493
1648
|
archivedAt: string | null;
|
|
1494
1649
|
createdAt: string;
|
|
@@ -1534,6 +1689,10 @@ type ActionWireOutputMap = {
|
|
|
1534
1689
|
parentTaskId: string | null;
|
|
1535
1690
|
dueDate: string | null;
|
|
1536
1691
|
startDate: string | null;
|
|
1692
|
+
approverId: string | null;
|
|
1693
|
+
approvalState: TaskApprovalStateValue;
|
|
1694
|
+
approvalRequestedAt: string | null;
|
|
1695
|
+
decidedAt: string | null;
|
|
1537
1696
|
sortOrder: number;
|
|
1538
1697
|
archivedAt: string | null;
|
|
1539
1698
|
createdAt: string;
|
|
@@ -1586,6 +1745,10 @@ type ActionWireOutputMap = {
|
|
|
1586
1745
|
parentTaskId: string | null;
|
|
1587
1746
|
dueDate: string | null;
|
|
1588
1747
|
startDate: string | null;
|
|
1748
|
+
approverId: string | null;
|
|
1749
|
+
approvalState: TaskApprovalStateValue;
|
|
1750
|
+
approvalRequestedAt: string | null;
|
|
1751
|
+
decidedAt: string | null;
|
|
1589
1752
|
sortOrder: number;
|
|
1590
1753
|
archivedAt: string | null;
|
|
1591
1754
|
createdAt: string;
|
|
@@ -1631,6 +1794,10 @@ type ActionWireOutputMap = {
|
|
|
1631
1794
|
parentTaskId: string | null;
|
|
1632
1795
|
dueDate: string | null;
|
|
1633
1796
|
startDate: string | null;
|
|
1797
|
+
approverId: string | null;
|
|
1798
|
+
approvalState: TaskApprovalStateValue;
|
|
1799
|
+
approvalRequestedAt: string | null;
|
|
1800
|
+
decidedAt: string | null;
|
|
1634
1801
|
sortOrder: number;
|
|
1635
1802
|
archivedAt: string | null;
|
|
1636
1803
|
createdAt: string;
|
|
@@ -1676,6 +1843,10 @@ type ActionWireOutputMap = {
|
|
|
1676
1843
|
parentTaskId: string | null;
|
|
1677
1844
|
dueDate: string | null;
|
|
1678
1845
|
startDate: string | null;
|
|
1846
|
+
approverId: string | null;
|
|
1847
|
+
approvalState: TaskApprovalStateValue;
|
|
1848
|
+
approvalRequestedAt: string | null;
|
|
1849
|
+
decidedAt: string | null;
|
|
1679
1850
|
sortOrder: number;
|
|
1680
1851
|
archivedAt: string | null;
|
|
1681
1852
|
createdAt: string;
|
|
@@ -1686,6 +1857,113 @@ type ActionWireOutputMap = {
|
|
|
1686
1857
|
previousMilestoneId: string | null;
|
|
1687
1858
|
effectiveAt: string;
|
|
1688
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
|
+
};
|
|
1689
1967
|
"task.addLabel": {
|
|
1690
1968
|
taskId: string;
|
|
1691
1969
|
labelId: string;
|
|
@@ -1735,6 +2013,10 @@ type ActionWireOutputMap = {
|
|
|
1735
2013
|
parentTaskId: string | null;
|
|
1736
2014
|
dueDate: string | null;
|
|
1737
2015
|
startDate: string | null;
|
|
2016
|
+
approverId: string | null;
|
|
2017
|
+
approvalState: TaskApprovalStateValue;
|
|
2018
|
+
approvalRequestedAt: string | null;
|
|
2019
|
+
decidedAt: string | null;
|
|
1738
2020
|
sortOrder: number;
|
|
1739
2021
|
archivedAt: string | null;
|
|
1740
2022
|
createdAt: string;
|
|
@@ -1782,6 +2064,10 @@ type ActionWireOutputMap = {
|
|
|
1782
2064
|
parentTaskId: string | null;
|
|
1783
2065
|
dueDate: string | null;
|
|
1784
2066
|
startDate: string | null;
|
|
2067
|
+
approverId: string | null;
|
|
2068
|
+
approvalState: TaskApprovalStateValue;
|
|
2069
|
+
approvalRequestedAt: string | null;
|
|
2070
|
+
decidedAt: string | null;
|
|
1785
2071
|
sortOrder: number;
|
|
1786
2072
|
archivedAt: string | null;
|
|
1787
2073
|
createdAt: string;
|
|
@@ -1980,6 +2266,108 @@ type ActionWireOutputMap = {
|
|
|
1980
2266
|
updatedAt: string;
|
|
1981
2267
|
};
|
|
1982
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
|
+
};
|
|
1983
2371
|
"milestone.create": {
|
|
1984
2372
|
milestone: {
|
|
1985
2373
|
id: string;
|
|
@@ -2062,7 +2450,7 @@ type ActionWireOutputMap = {
|
|
|
2062
2450
|
source: "legacy" | "generated" | "override";
|
|
2063
2451
|
cadenceRevisionId: string | null;
|
|
2064
2452
|
cadenceSequence: number | null;
|
|
2065
|
-
status: "completed" | "
|
|
2453
|
+
status: "completed" | "active" | "upcoming";
|
|
2066
2454
|
startedAt: string | null;
|
|
2067
2455
|
reportMode: "count" | "effort" | null;
|
|
2068
2456
|
estimateSettingsRevisionId: string | null;
|
|
@@ -2095,7 +2483,7 @@ type ActionWireOutputMap = {
|
|
|
2095
2483
|
source: "legacy" | "generated" | "override";
|
|
2096
2484
|
cadenceRevisionId: string | null;
|
|
2097
2485
|
cadenceSequence: number | null;
|
|
2098
|
-
status: "completed" | "
|
|
2486
|
+
status: "completed" | "active" | "upcoming";
|
|
2099
2487
|
startedAt: string | null;
|
|
2100
2488
|
reportMode: "count" | "effort" | null;
|
|
2101
2489
|
estimateSettingsRevisionId: string | null;
|
|
@@ -2124,7 +2512,7 @@ type ActionWireOutputMap = {
|
|
|
2124
2512
|
source: "legacy" | "generated" | "override";
|
|
2125
2513
|
cadenceRevisionId: string | null;
|
|
2126
2514
|
cadenceSequence: number | null;
|
|
2127
|
-
status: "completed" | "
|
|
2515
|
+
status: "completed" | "active" | "upcoming";
|
|
2128
2516
|
startedAt: string | null;
|
|
2129
2517
|
reportMode: "count" | "effort" | null;
|
|
2130
2518
|
estimateSettingsRevisionId: string | null;
|
|
@@ -2333,7 +2721,7 @@ type ActionWireOutputMap = {
|
|
|
2333
2721
|
source: "legacy" | "generated" | "override";
|
|
2334
2722
|
cadenceRevisionId: string | null;
|
|
2335
2723
|
cadenceSequence: number | null;
|
|
2336
|
-
status: "completed" | "
|
|
2724
|
+
status: "completed" | "active" | "upcoming";
|
|
2337
2725
|
startedAt: string | null;
|
|
2338
2726
|
reportMode: "count" | "effort" | null;
|
|
2339
2727
|
estimateSettingsRevisionId: string | null;
|
|
@@ -2362,7 +2750,7 @@ type ActionWireOutputMap = {
|
|
|
2362
2750
|
source: "legacy" | "generated" | "override";
|
|
2363
2751
|
cadenceRevisionId: string | null;
|
|
2364
2752
|
cadenceSequence: number | null;
|
|
2365
|
-
status: "completed" | "
|
|
2753
|
+
status: "completed" | "active" | "upcoming";
|
|
2366
2754
|
startedAt: string | null;
|
|
2367
2755
|
reportMode: "count" | "effort" | null;
|
|
2368
2756
|
estimateSettingsRevisionId: string | null;
|
|
@@ -2391,7 +2779,7 @@ type ActionWireOutputMap = {
|
|
|
2391
2779
|
source: "legacy" | "generated" | "override";
|
|
2392
2780
|
cadenceRevisionId: string | null;
|
|
2393
2781
|
cadenceSequence: number | null;
|
|
2394
|
-
status: "completed" | "
|
|
2782
|
+
status: "completed" | "active" | "upcoming";
|
|
2395
2783
|
startedAt: string | null;
|
|
2396
2784
|
reportMode: "count" | "effort" | null;
|
|
2397
2785
|
estimateSettingsRevisionId: string | null;
|
|
@@ -2627,6 +3015,10 @@ type TaskRecord = {
|
|
|
2627
3015
|
parentTaskId: string | null;
|
|
2628
3016
|
dueDate: string | null;
|
|
2629
3017
|
startDate: string | null;
|
|
3018
|
+
approverId: string | null;
|
|
3019
|
+
approvalState: TaskApprovalStateValue;
|
|
3020
|
+
approvalRequestedAt: Date | null;
|
|
3021
|
+
decidedAt: Date | null;
|
|
2630
3022
|
sortOrder: number;
|
|
2631
3023
|
archivedAt: Date | null;
|
|
2632
3024
|
createdAt: Date;
|
|
@@ -2645,6 +3037,16 @@ type ProjectRecord = {
|
|
|
2645
3037
|
createdAt: Date;
|
|
2646
3038
|
updatedAt: Date;
|
|
2647
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
|
+
};
|
|
2648
3050
|
type CycleRecord = {
|
|
2649
3051
|
id: string;
|
|
2650
3052
|
teamId: string;
|
|
@@ -2656,7 +3058,7 @@ type CycleRecord = {
|
|
|
2656
3058
|
source: "legacy" | "generated" | "override";
|
|
2657
3059
|
cadenceRevisionId: string | null;
|
|
2658
3060
|
cadenceSequence: number | null;
|
|
2659
|
-
status: "completed" | "
|
|
3061
|
+
status: "completed" | "active" | "upcoming";
|
|
2660
3062
|
startedAt: Date | null;
|
|
2661
3063
|
reportMode: "count" | "effort" | null;
|
|
2662
3064
|
estimateSettingsRevisionId: string | null;
|
|
@@ -2745,6 +3147,7 @@ type AgentPolicyRecord = {
|
|
|
2745
3147
|
};
|
|
2746
3148
|
type PriorityValue = "urgent" | "high" | "medium" | "low" | "none";
|
|
2747
3149
|
type StatusCategoryValue = "backlog" | "completed" | "cancelled" | "unstarted" | "started";
|
|
3150
|
+
type TaskApprovalStateValue = "none" | "requested" | "approved" | "changes_requested" | "rejected";
|
|
2748
3151
|
|
|
2749
3152
|
/**
|
|
2750
3153
|
* Token prefixes, duplicated from `@tasq/contracts/agents`.
|
|
@@ -2814,10 +3217,56 @@ declare class TasqClient {
|
|
|
2814
3217
|
readonly tasks: {
|
|
2815
3218
|
list: (slug: string, filters?: TaskListFilters) => Promise<TaskListItem[]>;
|
|
2816
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">>;
|
|
2817
3231
|
};
|
|
2818
3232
|
readonly projects: {
|
|
2819
3233
|
list: (slug: string) => Promise<ProjectListItem[]>;
|
|
2820
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">>;
|
|
2821
3270
|
};
|
|
2822
3271
|
readonly threads: {
|
|
2823
3272
|
/**
|
|
@@ -2954,4 +3403,4 @@ declare class TasqPolicyDeniedError extends TasqApiError {
|
|
|
2954
3403
|
constructor(status: number, body: ErrorBody);
|
|
2955
3404
|
}
|
|
2956
3405
|
|
|
2957
|
-
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/** 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\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":[]}
|