@pxlabz/tasq-sdk 0.1.12 → 0.1.14

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 CHANGED
@@ -90,8 +90,32 @@ 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;
95
+ /** Who created the task; null when that member has since been removed. */
96
+ creator: TaskCreator | null;
93
97
  labels: TaskLabelRef[];
94
98
  };
99
+ type TaskCreator = {
100
+ memberId: string;
101
+ name: string | null;
102
+ kind: "user" | "agent";
103
+ };
104
+ /**
105
+ * A task's approval (6.3). `approver` is null when the person asked has since
106
+ * left the workspace; the request still stands.
107
+ */
108
+ type TaskApproval = {
109
+ state: "requested" | "approved" | "changes_requested" | "rejected";
110
+ approver: {
111
+ memberId: string;
112
+ name: string | null;
113
+ } | null;
114
+ requestedAt: string | null;
115
+ decidedAt: string | null;
116
+ };
117
+ /** What `task.decide` takes: approve, ask for changes, or reject. */
118
+ type TaskApprovalDecision = "approve" | "changes" | "reject";
95
119
  type SubtaskProgress = {
96
120
  total: number;
97
121
  completed: number;
@@ -199,6 +223,9 @@ type TeamRef = {
199
223
  identifier: string;
200
224
  };
201
225
  type ProjectStatus = "backlog" | "planned" | "in_progress" | "completed" | "cancelled";
226
+ /** A project's health, as called by its latest sent update (7.5). */
227
+ declare const PROJECT_HEALTH_VALUES: readonly ["on_track", "at_risk", "off_track"];
228
+ type ProjectHealth = (typeof PROJECT_HEALTH_VALUES)[number];
202
229
  type ProjectListItem = {
203
230
  id: string;
204
231
  workspaceId: string;
@@ -217,6 +244,28 @@ type ProjectListItem = {
217
244
  teams: TeamRef[];
218
245
  lead: PersonRef | null;
219
246
  members: PersonRef[];
247
+ /** Null until a project update has been sent. Drafts never move it. */
248
+ health: ProjectHealth | null;
249
+ /** When the latest sent update went out. */
250
+ latestUpdateAt: string | null;
251
+ /** Whether the calling member starred it. Always false for an agent key. */
252
+ starred: boolean;
253
+ /** Active initiatives the project belongs to, by name. */
254
+ initiatives: InitiativeRef[];
255
+ };
256
+ type InitiativeRef = {
257
+ id: string;
258
+ name: string;
259
+ };
260
+ type InitiativeStatus = "active" | "archived";
261
+ /** One row of `GET /workspaces/:slug/initiatives`, archived ones included. */
262
+ type InitiativeListItem = {
263
+ id: string;
264
+ name: string;
265
+ status: InitiativeStatus;
266
+ ownerMemberId: string | null;
267
+ projectIds: string[];
268
+ createdAt: string;
220
269
  };
221
270
  type ProjectMilestone = {
222
271
  id: string;
@@ -235,6 +284,25 @@ type ProjectDetail = ProjectListItem & {
235
284
  /** Project threads, same shape as task detail comments (D-2). */
236
285
  comments: TaskComment[];
237
286
  };
287
+ /** Who wrote a project update. Null once the author has left. */
288
+ type ProjectUpdateAuthor = {
289
+ memberId: string;
290
+ name: string;
291
+ kind: "user" | "agent";
292
+ };
293
+ /** One row of `GET /workspaces/:slug/projects/:projectId/updates`, newest first. */
294
+ type ProjectUpdateListItem = {
295
+ id: string;
296
+ projectId: string;
297
+ health: ProjectHealth;
298
+ body: string;
299
+ author: ProjectUpdateAuthor | null;
300
+ actorType: "user" | "agent";
301
+ /** Null while the update is a draft. */
302
+ sentAt: string | null;
303
+ createdAt: string;
304
+ updatedAt: string;
305
+ };
238
306
  type CycleState = "upcoming" | "active" | "completed";
239
307
  type CycleListItem = {
240
308
  id: string;
@@ -415,16 +483,22 @@ type AgentEventsResponse = {
415
483
  */
416
484
  type NotificationItem = {
417
485
  id: string;
418
- kind: "agent_reply" | "thread_reply" | "release_ready";
486
+ kind: "agent_reply" | "thread_reply" | "release_ready" | "approval_requested" | "approval_decided";
419
487
  /** Exactly one of `taskId` / `projectId` is set: the entity the thread is on. */
420
488
  taskId: string | null;
421
489
  taskKey: string | null;
490
+ /** The task's title when `taskId` is set. */
491
+ taskTitle: string | null;
422
492
  projectId: string | null;
423
493
  /** Name of the project a project thread is on; null for a task thread. */
424
494
  projectName: string | null;
425
495
  /** The thread the comment belongs to: the root comment's id (D-1). */
426
496
  threadId: string | null;
427
497
  commentId: string | null;
498
+ /** The linked comment as plain text, ~200 characters cut on a word. */
499
+ excerpt: string | null;
500
+ /** Set only on `approval_decided`: the decision that row announced. */
501
+ decision: "approved" | "changes_requested" | "rejected" | null;
428
502
  /** Set only on `release_ready`: the release and how to name it (B-04d D-1). */
429
503
  releaseId: string | null;
430
504
  releaseNumber: number | null;
@@ -438,6 +512,72 @@ type NotificationsResponse = {
438
512
  notifications: NotificationItem[];
439
513
  unreadCount: number;
440
514
  };
515
+ /** Who did something in the workspace activity feed. */
516
+ type ActivityFeedActor = {
517
+ memberId: string | null;
518
+ name: string;
519
+ kind: "user" | "agent" | "system";
520
+ };
521
+ /** What an activity feed row is about. `key` is the task key on a task. */
522
+ type ActivityFeedSubject = {
523
+ type: "task" | "project" | "initiative" | "project_update" | "team" | "other";
524
+ id: string;
525
+ key: string | null;
526
+ title: string;
527
+ projectId: string | null;
528
+ };
529
+ /**
530
+ * One row of `GET /workspaces/:slug/activity`. `summary` is a verb phrase
531
+ * with neither actor nor subject, so a row reads "{actor} {summary} {subject}".
532
+ */
533
+ type ActivityFeedItem = {
534
+ /** `a:<activity id>` or `e:<event id>`. */
535
+ id: string;
536
+ occurredAt: string;
537
+ actor: ActivityFeedActor;
538
+ summary: string;
539
+ subject: ActivityFeedSubject;
540
+ };
541
+ /** `GET /workspaces/:slug/activity`, newest first. */
542
+ type ActivityFeedResponse = {
543
+ items: ActivityFeedItem[];
544
+ nextCursor: string | null;
545
+ };
546
+ /** An approval asked of the caller. */
547
+ type WaitingApproval = {
548
+ taskId: string;
549
+ taskKey: string;
550
+ title: string;
551
+ projectId: string | null;
552
+ projectName: string | null;
553
+ requestedAt: string | null;
554
+ requestedBy: {
555
+ memberId: string;
556
+ name: string;
557
+ kind: "user" | "agent";
558
+ } | null;
559
+ };
560
+ /** An unsent agent draft on a project the caller leads. */
561
+ type WaitingDraft = {
562
+ updateId: string;
563
+ projectId: string;
564
+ projectName: string;
565
+ health: ProjectHealth;
566
+ bodyExcerpt: string;
567
+ author: {
568
+ memberId: string;
569
+ name: string;
570
+ kind: "agent";
571
+ };
572
+ createdAt: string;
573
+ };
574
+ /** `GET /workspaces/:slug/waiting` — people only. */
575
+ type WaitingResponse = {
576
+ approvals: WaitingApproval[];
577
+ drafts: WaitingDraft[];
578
+ /** Unsent agent-authored updates across the workspace, by agent member id. */
579
+ draftsByAgent: Record<string, number>;
580
+ };
441
581
  /**
442
582
  * One row of `GET /workspaces/:slug/members`, narrowed to what the CLI needs
443
583
  * to turn an `--mention <name>` into an agent id. The route returns more per
@@ -699,7 +839,7 @@ type DispatchResponse<TName extends ActionName> = {
699
839
  result: ActionWireOutputMap[TName];
700
840
  invalidates: Array<Array<string>>;
701
841
  };
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";
842
+ 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
843
  type ActionInputMap = Omit<ActionParsedInputMap, "cycle.create" | "cycle.update"> & {
704
844
  "cycle.create": DatesAsInput<{
705
845
  teamIdentifier: string;
@@ -714,7 +854,7 @@ type ActionInputMap = Omit<ActionParsedInputMap, "cycle.create" | "cycle.update"
714
854
  description?: string | null | undefined;
715
855
  startDate?: Date | undefined;
716
856
  endDate?: Date | undefined;
717
- status?: "completed" | "upcoming" | "active" | undefined;
857
+ status?: "completed" | "active" | "upcoming" | undefined;
718
858
  }>;
719
859
  };
720
860
  type ActionParsedInputMap = {
@@ -782,6 +922,14 @@ type ActionParsedInputMap = {
782
922
  taskId: string;
783
923
  parentTaskId: string | null;
784
924
  };
925
+ "task.requestApproval": {
926
+ taskId: string;
927
+ approverId: string;
928
+ };
929
+ "task.decide": {
930
+ taskId: string;
931
+ decision: "approve" | "changes" | "reject";
932
+ };
785
933
  "task.addLabel": {
786
934
  taskId: string;
787
935
  labelId: string;
@@ -850,6 +998,52 @@ type ActionParsedInputMap = {
850
998
  projectId: string;
851
999
  leadId: string | null;
852
1000
  };
1001
+ "project.star": {
1002
+ projectId: string;
1003
+ };
1004
+ "project.unstar": {
1005
+ projectId: string;
1006
+ };
1007
+ "initiative.create": {
1008
+ name: string;
1009
+ ownerMemberId?: string | null | undefined;
1010
+ };
1011
+ "initiative.update": {
1012
+ initiativeId: string;
1013
+ name?: string | undefined;
1014
+ status?: "active" | "archived" | undefined;
1015
+ ownerMemberId?: string | null | undefined;
1016
+ };
1017
+ "initiative.delete": {
1018
+ initiativeId: string;
1019
+ };
1020
+ "initiative.linkProject": {
1021
+ initiativeId: string;
1022
+ projectId: string;
1023
+ };
1024
+ "initiative.unlinkProject": {
1025
+ initiativeId: string;
1026
+ projectId: string;
1027
+ };
1028
+ "projectUpdate.create": {
1029
+ projectId: string;
1030
+ health: "on_track" | "at_risk" | "off_track";
1031
+ body: string;
1032
+ send?: boolean | undefined;
1033
+ };
1034
+ "projectUpdate.update": {
1035
+ updateId: string;
1036
+ health?: "on_track" | "at_risk" | "off_track" | undefined;
1037
+ body?: string | undefined;
1038
+ };
1039
+ "projectUpdate.send": {
1040
+ updateId: string;
1041
+ health?: "on_track" | "at_risk" | "off_track" | undefined;
1042
+ body?: string | undefined;
1043
+ };
1044
+ "projectUpdate.delete": {
1045
+ updateId: string;
1046
+ };
853
1047
  "milestone.create": {
854
1048
  projectId: string;
855
1049
  name: string;
@@ -885,7 +1079,7 @@ type ActionParsedInputMap = {
885
1079
  description?: string | null | undefined;
886
1080
  startDate?: Date | undefined;
887
1081
  endDate?: Date | undefined;
888
- status?: "completed" | "upcoming" | "active" | undefined;
1082
+ status?: "completed" | "active" | "upcoming" | undefined;
889
1083
  };
890
1084
  "cycle.delete": {
891
1085
  cycleId: string;
@@ -1037,6 +1231,10 @@ type ActionWireOutputMap = {
1037
1231
  parentTaskId: string | null;
1038
1232
  dueDate: string | null;
1039
1233
  startDate: string | null;
1234
+ approverId: string | null;
1235
+ approvalState: TaskApprovalStateValue;
1236
+ approvalRequestedAt: string | null;
1237
+ decidedAt: string | null;
1040
1238
  sortOrder: number;
1041
1239
  archivedAt: string | null;
1042
1240
  createdAt: string;
@@ -1087,6 +1285,10 @@ type ActionWireOutputMap = {
1087
1285
  parentTaskId: string | null;
1088
1286
  dueDate: string | null;
1089
1287
  startDate: string | null;
1288
+ approverId: string | null;
1289
+ approvalState: TaskApprovalStateValue;
1290
+ approvalRequestedAt: string | null;
1291
+ decidedAt: string | null;
1090
1292
  sortOrder: number;
1091
1293
  archivedAt: string | null;
1092
1294
  createdAt: string;
@@ -1134,6 +1336,10 @@ type ActionWireOutputMap = {
1134
1336
  parentTaskId: string | null;
1135
1337
  dueDate: string | null;
1136
1338
  startDate: string | null;
1339
+ approverId: string | null;
1340
+ approvalState: TaskApprovalStateValue;
1341
+ approvalRequestedAt: string | null;
1342
+ decidedAt: string | null;
1137
1343
  sortOrder: number;
1138
1344
  archivedAt: string | null;
1139
1345
  createdAt: string;
@@ -1188,6 +1394,10 @@ type ActionWireOutputMap = {
1188
1394
  parentTaskId: string | null;
1189
1395
  dueDate: string | null;
1190
1396
  startDate: string | null;
1397
+ approverId: string | null;
1398
+ approvalState: TaskApprovalStateValue;
1399
+ approvalRequestedAt: string | null;
1400
+ decidedAt: string | null;
1191
1401
  sortOrder: number;
1192
1402
  archivedAt: string | null;
1193
1403
  createdAt: string;
@@ -1237,6 +1447,10 @@ type ActionWireOutputMap = {
1237
1447
  parentTaskId: string | null;
1238
1448
  dueDate: string | null;
1239
1449
  startDate: string | null;
1450
+ approverId: string | null;
1451
+ approvalState: TaskApprovalStateValue;
1452
+ approvalRequestedAt: string | null;
1453
+ decidedAt: string | null;
1240
1454
  sortOrder: number;
1241
1455
  archivedAt: string | null;
1242
1456
  createdAt: string;
@@ -1283,6 +1497,10 @@ type ActionWireOutputMap = {
1283
1497
  parentTaskId: string | null;
1284
1498
  dueDate: string | null;
1285
1499
  startDate: string | null;
1500
+ approverId: string | null;
1501
+ approvalState: TaskApprovalStateValue;
1502
+ approvalRequestedAt: string | null;
1503
+ decidedAt: string | null;
1286
1504
  sortOrder: number;
1287
1505
  archivedAt: string | null;
1288
1506
  createdAt: string;
@@ -1330,6 +1548,10 @@ type ActionWireOutputMap = {
1330
1548
  parentTaskId: string | null;
1331
1549
  dueDate: string | null;
1332
1550
  startDate: string | null;
1551
+ approverId: string | null;
1552
+ approvalState: TaskApprovalStateValue;
1553
+ approvalRequestedAt: string | null;
1554
+ decidedAt: string | null;
1333
1555
  sortOrder: number;
1334
1556
  archivedAt: string | null;
1335
1557
  createdAt: string;
@@ -1377,6 +1599,10 @@ type ActionWireOutputMap = {
1377
1599
  parentTaskId: string | null;
1378
1600
  dueDate: string | null;
1379
1601
  startDate: string | null;
1602
+ approverId: string | null;
1603
+ approvalState: TaskApprovalStateValue;
1604
+ approvalRequestedAt: string | null;
1605
+ decidedAt: string | null;
1380
1606
  sortOrder: number;
1381
1607
  archivedAt: string | null;
1382
1608
  createdAt: string;
@@ -1443,6 +1669,10 @@ type ActionWireOutputMap = {
1443
1669
  parentTaskId: string | null;
1444
1670
  dueDate: string | null;
1445
1671
  startDate: string | null;
1672
+ approverId: string | null;
1673
+ approvalState: TaskApprovalStateValue;
1674
+ approvalRequestedAt: string | null;
1675
+ decidedAt: string | null;
1446
1676
  sortOrder: number;
1447
1677
  archivedAt: string | null;
1448
1678
  createdAt: string;
@@ -1489,6 +1719,10 @@ type ActionWireOutputMap = {
1489
1719
  parentTaskId: string | null;
1490
1720
  dueDate: string | null;
1491
1721
  startDate: string | null;
1722
+ approverId: string | null;
1723
+ approvalState: TaskApprovalStateValue;
1724
+ approvalRequestedAt: string | null;
1725
+ decidedAt: string | null;
1492
1726
  sortOrder: number;
1493
1727
  archivedAt: string | null;
1494
1728
  createdAt: string;
@@ -1534,6 +1768,10 @@ type ActionWireOutputMap = {
1534
1768
  parentTaskId: string | null;
1535
1769
  dueDate: string | null;
1536
1770
  startDate: string | null;
1771
+ approverId: string | null;
1772
+ approvalState: TaskApprovalStateValue;
1773
+ approvalRequestedAt: string | null;
1774
+ decidedAt: string | null;
1537
1775
  sortOrder: number;
1538
1776
  archivedAt: string | null;
1539
1777
  createdAt: string;
@@ -1586,6 +1824,10 @@ type ActionWireOutputMap = {
1586
1824
  parentTaskId: string | null;
1587
1825
  dueDate: string | null;
1588
1826
  startDate: string | null;
1827
+ approverId: string | null;
1828
+ approvalState: TaskApprovalStateValue;
1829
+ approvalRequestedAt: string | null;
1830
+ decidedAt: string | null;
1589
1831
  sortOrder: number;
1590
1832
  archivedAt: string | null;
1591
1833
  createdAt: string;
@@ -1631,6 +1873,10 @@ type ActionWireOutputMap = {
1631
1873
  parentTaskId: string | null;
1632
1874
  dueDate: string | null;
1633
1875
  startDate: string | null;
1876
+ approverId: string | null;
1877
+ approvalState: TaskApprovalStateValue;
1878
+ approvalRequestedAt: string | null;
1879
+ decidedAt: string | null;
1634
1880
  sortOrder: number;
1635
1881
  archivedAt: string | null;
1636
1882
  createdAt: string;
@@ -1676,6 +1922,10 @@ type ActionWireOutputMap = {
1676
1922
  parentTaskId: string | null;
1677
1923
  dueDate: string | null;
1678
1924
  startDate: string | null;
1925
+ approverId: string | null;
1926
+ approvalState: TaskApprovalStateValue;
1927
+ approvalRequestedAt: string | null;
1928
+ decidedAt: string | null;
1679
1929
  sortOrder: number;
1680
1930
  archivedAt: string | null;
1681
1931
  createdAt: string;
@@ -1686,6 +1936,113 @@ type ActionWireOutputMap = {
1686
1936
  previousMilestoneId: string | null;
1687
1937
  effectiveAt: string;
1688
1938
  };
1939
+ "task.requestApproval": {
1940
+ task: {
1941
+ id: string;
1942
+ teamId: string;
1943
+ number: number;
1944
+ title: string;
1945
+ description: string | null;
1946
+ descriptionDocument: {
1947
+ version: 1;
1948
+ content: {
1949
+ [x: string]: any;
1950
+ type?: string | undefined;
1951
+ attrs?: {
1952
+ [x: string]: any;
1953
+ } | undefined;
1954
+ content?: any[] | undefined;
1955
+ marks?: {
1956
+ [x: string]: any;
1957
+ type: string;
1958
+ attrs?: {
1959
+ [x: string]: any;
1960
+ } | undefined;
1961
+ }[] | undefined;
1962
+ text?: string | undefined;
1963
+ };
1964
+ } | null;
1965
+ statusId: string;
1966
+ priority: PriorityValue;
1967
+ estimateValue: number | null;
1968
+ estimateSettingsRevisionId: string | null;
1969
+ assigneeId: string | null;
1970
+ creatorId: string | null;
1971
+ projectId: string | null;
1972
+ cycleId: string | null;
1973
+ cycleAssignmentSource: "manual" | "automatic" | "carryover";
1974
+ milestoneId: string | null;
1975
+ parentTaskId: string | null;
1976
+ dueDate: string | null;
1977
+ startDate: string | null;
1978
+ approverId: string | null;
1979
+ approvalState: TaskApprovalStateValue;
1980
+ approvalRequestedAt: string | null;
1981
+ decidedAt: string | null;
1982
+ sortOrder: number;
1983
+ archivedAt: string | null;
1984
+ createdAt: string;
1985
+ updatedAt: string;
1986
+ };
1987
+ previousApproverId: string | null;
1988
+ previousApprovalState: TaskApprovalStateValue;
1989
+ };
1990
+ "task.decide": {
1991
+ task: {
1992
+ id: string;
1993
+ teamId: string;
1994
+ number: number;
1995
+ title: string;
1996
+ description: string | null;
1997
+ descriptionDocument: {
1998
+ version: 1;
1999
+ content: {
2000
+ [x: string]: any;
2001
+ type?: string | undefined;
2002
+ attrs?: {
2003
+ [x: string]: any;
2004
+ } | undefined;
2005
+ content?: any[] | undefined;
2006
+ marks?: {
2007
+ [x: string]: any;
2008
+ type: string;
2009
+ attrs?: {
2010
+ [x: string]: any;
2011
+ } | undefined;
2012
+ }[] | undefined;
2013
+ text?: string | undefined;
2014
+ };
2015
+ } | null;
2016
+ statusId: string;
2017
+ priority: PriorityValue;
2018
+ estimateValue: number | null;
2019
+ estimateSettingsRevisionId: string | null;
2020
+ assigneeId: string | null;
2021
+ creatorId: string | null;
2022
+ projectId: string | null;
2023
+ cycleId: string | null;
2024
+ cycleAssignmentSource: "manual" | "automatic" | "carryover";
2025
+ milestoneId: string | null;
2026
+ parentTaskId: string | null;
2027
+ dueDate: string | null;
2028
+ startDate: string | null;
2029
+ approverId: string | null;
2030
+ approvalState: TaskApprovalStateValue;
2031
+ approvalRequestedAt: string | null;
2032
+ decidedAt: string | null;
2033
+ sortOrder: number;
2034
+ archivedAt: string | null;
2035
+ createdAt: string;
2036
+ updatedAt: string;
2037
+ };
2038
+ previousApprovalState: TaskApprovalStateValue;
2039
+ statusMove: {
2040
+ previousStatusId: string;
2041
+ previousStatusCategory: StatusCategoryValue;
2042
+ statusCategory: StatusCategoryValue;
2043
+ effectiveAt: string;
2044
+ } | null;
2045
+ };
1689
2046
  "task.addLabel": {
1690
2047
  taskId: string;
1691
2048
  labelId: string;
@@ -1735,6 +2092,10 @@ type ActionWireOutputMap = {
1735
2092
  parentTaskId: string | null;
1736
2093
  dueDate: string | null;
1737
2094
  startDate: string | null;
2095
+ approverId: string | null;
2096
+ approvalState: TaskApprovalStateValue;
2097
+ approvalRequestedAt: string | null;
2098
+ decidedAt: string | null;
1738
2099
  sortOrder: number;
1739
2100
  archivedAt: string | null;
1740
2101
  createdAt: string;
@@ -1782,6 +2143,10 @@ type ActionWireOutputMap = {
1782
2143
  parentTaskId: string | null;
1783
2144
  dueDate: string | null;
1784
2145
  startDate: string | null;
2146
+ approverId: string | null;
2147
+ approvalState: TaskApprovalStateValue;
2148
+ approvalRequestedAt: string | null;
2149
+ decidedAt: string | null;
1785
2150
  sortOrder: number;
1786
2151
  archivedAt: string | null;
1787
2152
  createdAt: string;
@@ -1980,6 +2345,108 @@ type ActionWireOutputMap = {
1980
2345
  updatedAt: string;
1981
2346
  };
1982
2347
  };
2348
+ "project.star": {
2349
+ projectId: string;
2350
+ starred: boolean;
2351
+ };
2352
+ "project.unstar": {
2353
+ projectId: string;
2354
+ starred: boolean;
2355
+ };
2356
+ "initiative.create": {
2357
+ initiative: {
2358
+ id: string;
2359
+ workspaceId: string;
2360
+ name: string;
2361
+ status: InitiativeStatusValue;
2362
+ ownerMemberId: string | null;
2363
+ createdAt: string;
2364
+ updatedAt: string;
2365
+ };
2366
+ };
2367
+ "initiative.update": {
2368
+ initiative: {
2369
+ id: string;
2370
+ workspaceId: string;
2371
+ name: string;
2372
+ status: InitiativeStatusValue;
2373
+ ownerMemberId: string | null;
2374
+ createdAt: string;
2375
+ updatedAt: string;
2376
+ };
2377
+ };
2378
+ "initiative.delete": {
2379
+ initiativeId: string;
2380
+ };
2381
+ "initiative.linkProject": {
2382
+ initiative: {
2383
+ id: string;
2384
+ workspaceId: string;
2385
+ name: string;
2386
+ status: InitiativeStatusValue;
2387
+ ownerMemberId: string | null;
2388
+ createdAt: string;
2389
+ updatedAt: string;
2390
+ };
2391
+ projectId: string;
2392
+ linked: boolean;
2393
+ };
2394
+ "initiative.unlinkProject": {
2395
+ initiative: {
2396
+ id: string;
2397
+ workspaceId: string;
2398
+ name: string;
2399
+ status: InitiativeStatusValue;
2400
+ ownerMemberId: string | null;
2401
+ createdAt: string;
2402
+ updatedAt: string;
2403
+ };
2404
+ projectId: string;
2405
+ unlinked: boolean;
2406
+ };
2407
+ "projectUpdate.create": {
2408
+ update: {
2409
+ id: string;
2410
+ projectId: string;
2411
+ health: "on_track" | "at_risk" | "off_track";
2412
+ body: string;
2413
+ authorMemberId: string | null;
2414
+ actorType: "user" | "agent" | "system";
2415
+ sentAt: string | null;
2416
+ createdAt: string;
2417
+ updatedAt: string;
2418
+ };
2419
+ };
2420
+ "projectUpdate.update": {
2421
+ update: {
2422
+ id: string;
2423
+ projectId: string;
2424
+ health: "on_track" | "at_risk" | "off_track";
2425
+ body: string;
2426
+ authorMemberId: string | null;
2427
+ actorType: "user" | "agent" | "system";
2428
+ sentAt: string | null;
2429
+ createdAt: string;
2430
+ updatedAt: string;
2431
+ };
2432
+ };
2433
+ "projectUpdate.send": {
2434
+ update: {
2435
+ id: string;
2436
+ projectId: string;
2437
+ health: "on_track" | "at_risk" | "off_track";
2438
+ body: string;
2439
+ authorMemberId: string | null;
2440
+ actorType: "user" | "agent" | "system";
2441
+ sentAt: string | null;
2442
+ createdAt: string;
2443
+ updatedAt: string;
2444
+ };
2445
+ };
2446
+ "projectUpdate.delete": {
2447
+ deletedUpdateId: string;
2448
+ projectId: string;
2449
+ };
1983
2450
  "milestone.create": {
1984
2451
  milestone: {
1985
2452
  id: string;
@@ -2062,7 +2529,7 @@ type ActionWireOutputMap = {
2062
2529
  source: "legacy" | "generated" | "override";
2063
2530
  cadenceRevisionId: string | null;
2064
2531
  cadenceSequence: number | null;
2065
- status: "completed" | "upcoming" | "active";
2532
+ status: "completed" | "active" | "upcoming";
2066
2533
  startedAt: string | null;
2067
2534
  reportMode: "count" | "effort" | null;
2068
2535
  estimateSettingsRevisionId: string | null;
@@ -2095,7 +2562,7 @@ type ActionWireOutputMap = {
2095
2562
  source: "legacy" | "generated" | "override";
2096
2563
  cadenceRevisionId: string | null;
2097
2564
  cadenceSequence: number | null;
2098
- status: "completed" | "upcoming" | "active";
2565
+ status: "completed" | "active" | "upcoming";
2099
2566
  startedAt: string | null;
2100
2567
  reportMode: "count" | "effort" | null;
2101
2568
  estimateSettingsRevisionId: string | null;
@@ -2124,7 +2591,7 @@ type ActionWireOutputMap = {
2124
2591
  source: "legacy" | "generated" | "override";
2125
2592
  cadenceRevisionId: string | null;
2126
2593
  cadenceSequence: number | null;
2127
- status: "completed" | "upcoming" | "active";
2594
+ status: "completed" | "active" | "upcoming";
2128
2595
  startedAt: string | null;
2129
2596
  reportMode: "count" | "effort" | null;
2130
2597
  estimateSettingsRevisionId: string | null;
@@ -2333,7 +2800,7 @@ type ActionWireOutputMap = {
2333
2800
  source: "legacy" | "generated" | "override";
2334
2801
  cadenceRevisionId: string | null;
2335
2802
  cadenceSequence: number | null;
2336
- status: "completed" | "upcoming" | "active";
2803
+ status: "completed" | "active" | "upcoming";
2337
2804
  startedAt: string | null;
2338
2805
  reportMode: "count" | "effort" | null;
2339
2806
  estimateSettingsRevisionId: string | null;
@@ -2362,7 +2829,7 @@ type ActionWireOutputMap = {
2362
2829
  source: "legacy" | "generated" | "override";
2363
2830
  cadenceRevisionId: string | null;
2364
2831
  cadenceSequence: number | null;
2365
- status: "completed" | "upcoming" | "active";
2832
+ status: "completed" | "active" | "upcoming";
2366
2833
  startedAt: string | null;
2367
2834
  reportMode: "count" | "effort" | null;
2368
2835
  estimateSettingsRevisionId: string | null;
@@ -2391,7 +2858,7 @@ type ActionWireOutputMap = {
2391
2858
  source: "legacy" | "generated" | "override";
2392
2859
  cadenceRevisionId: string | null;
2393
2860
  cadenceSequence: number | null;
2394
- status: "completed" | "upcoming" | "active";
2861
+ status: "completed" | "active" | "upcoming";
2395
2862
  startedAt: string | null;
2396
2863
  reportMode: "count" | "effort" | null;
2397
2864
  estimateSettingsRevisionId: string | null;
@@ -2627,6 +3094,10 @@ type TaskRecord = {
2627
3094
  parentTaskId: string | null;
2628
3095
  dueDate: string | null;
2629
3096
  startDate: string | null;
3097
+ approverId: string | null;
3098
+ approvalState: TaskApprovalStateValue;
3099
+ approvalRequestedAt: Date | null;
3100
+ decidedAt: Date | null;
2630
3101
  sortOrder: number;
2631
3102
  archivedAt: Date | null;
2632
3103
  createdAt: Date;
@@ -2645,6 +3116,16 @@ type ProjectRecord = {
2645
3116
  createdAt: Date;
2646
3117
  updatedAt: Date;
2647
3118
  };
3119
+ type InitiativeStatusValue = "active" | "archived";
3120
+ type InitiativeRecord = {
3121
+ id: string;
3122
+ workspaceId: string;
3123
+ name: string;
3124
+ status: InitiativeStatusValue;
3125
+ ownerMemberId: string | null;
3126
+ createdAt: Date;
3127
+ updatedAt: Date;
3128
+ };
2648
3129
  type CycleRecord = {
2649
3130
  id: string;
2650
3131
  teamId: string;
@@ -2656,7 +3137,7 @@ type CycleRecord = {
2656
3137
  source: "legacy" | "generated" | "override";
2657
3138
  cadenceRevisionId: string | null;
2658
3139
  cadenceSequence: number | null;
2659
- status: "completed" | "upcoming" | "active";
3140
+ status: "completed" | "active" | "upcoming";
2660
3141
  startedAt: Date | null;
2661
3142
  reportMode: "count" | "effort" | null;
2662
3143
  estimateSettingsRevisionId: string | null;
@@ -2745,6 +3226,7 @@ type AgentPolicyRecord = {
2745
3226
  };
2746
3227
  type PriorityValue = "urgent" | "high" | "medium" | "low" | "none";
2747
3228
  type StatusCategoryValue = "backlog" | "completed" | "cancelled" | "unstarted" | "started";
3229
+ type TaskApprovalStateValue = "none" | "requested" | "approved" | "changes_requested" | "rejected";
2748
3230
 
2749
3231
  /**
2750
3232
  * Token prefixes, duplicated from `@tasq/contracts/agents`.
@@ -2814,10 +3296,56 @@ declare class TasqClient {
2814
3296
  readonly tasks: {
2815
3297
  list: (slug: string, filters?: TaskListFilters) => Promise<TaskListItem[]>;
2816
3298
  get: (slug: string, taskId: string) => Promise<TaskDetail>;
3299
+ /**
3300
+ * Ask a person to sign off on a task (6.3). Asking again while a
3301
+ * request stands replaces the approver. The approver cannot be an agent.
3302
+ */
3303
+ requestApproval: (slug: string, taskId: string, approverId: string) => Promise<DispatchResponse<"task.requestApproval">>;
3304
+ /**
3305
+ * The approver's answer (6.3). `approve` also moves the task to the next
3306
+ * status in its team's category order. Person credentials only: no
3307
+ * agent policy can include it.
3308
+ */
3309
+ decide: (slug: string, taskId: string, decision: TaskApprovalDecision) => Promise<DispatchResponse<"task.decide">>;
2817
3310
  };
2818
3311
  readonly projects: {
2819
3312
  list: (slug: string) => Promise<ProjectListItem[]>;
2820
3313
  get: (slug: string, projectId: string) => Promise<ProjectDetail>;
3314
+ /**
3315
+ * Pin a project to the caller's own sidebar. People only: an agent
3316
+ * key is refused by policy whatever its preset.
3317
+ */
3318
+ star: (slug: string, input: ActionInputMap["project.star"]) => Promise<DispatchResponse<"project.star">>;
3319
+ unstar: (slug: string, input: ActionInputMap["project.unstar"]) => Promise<DispatchResponse<"project.unstar">>;
3320
+ };
3321
+ /**
3322
+ * Initiatives group projects across teams. Any member reads them; every
3323
+ * write is admin-level, so an agent key (always a member) cannot make one.
3324
+ */
3325
+ readonly initiatives: {
3326
+ list: (slug: string) => Promise<InitiativeListItem[]>;
3327
+ create: (slug: string, input: ActionInputMap["initiative.create"]) => Promise<DispatchResponse<"initiative.create">>;
3328
+ update: (slug: string, input: ActionInputMap["initiative.update"]) => Promise<DispatchResponse<"initiative.update">>;
3329
+ delete: (slug: string, input: ActionInputMap["initiative.delete"]) => Promise<DispatchResponse<"initiative.delete">>;
3330
+ linkProject: (slug: string, input: ActionInputMap["initiative.linkProject"]) => Promise<DispatchResponse<"initiative.linkProject">>;
3331
+ unlinkProject: (slug: string, input: ActionInputMap["initiative.unlinkProject"]) => Promise<DispatchResponse<"initiative.unlinkProject">>;
3332
+ };
3333
+ /**
3334
+ * Project updates: a health call and a body for the project's client (7.5).
3335
+ *
3336
+ * `draft` is what an agent calls; an agent's update is always a draft
3337
+ * whatever it passes. `send` is people only: no agent policy can grant it,
3338
+ * because nothing an agent drafts goes to a client without a person
3339
+ * approving it.
3340
+ */
3341
+ readonly projectUpdates: {
3342
+ /** Every update on the project, drafts included, newest first. */
3343
+ list: (slug: string, projectId: string) => Promise<ProjectUpdateListItem[]>;
3344
+ draft: (slug: string, input: Omit<ActionInputMap["projectUpdate.create"], "send">) => Promise<DispatchResponse<"projectUpdate.create">>;
3345
+ create: (slug: string, input: ActionInputMap["projectUpdate.create"]) => Promise<DispatchResponse<"projectUpdate.create">>;
3346
+ update: (slug: string, input: ActionInputMap["projectUpdate.update"]) => Promise<DispatchResponse<"projectUpdate.update">>;
3347
+ send: (slug: string, input: ActionInputMap["projectUpdate.send"]) => Promise<DispatchResponse<"projectUpdate.send">>;
3348
+ delete: (slug: string, input: ActionInputMap["projectUpdate.delete"]) => Promise<DispatchResponse<"projectUpdate.delete">>;
2821
3349
  };
2822
3350
  readonly threads: {
2823
3351
  /**
@@ -2895,6 +3423,17 @@ declare class TasqClient {
2895
3423
  unread?: boolean;
2896
3424
  }) => Promise<NotificationsResponse>;
2897
3425
  };
3426
+ readonly activity: {
3427
+ /** The workspace activity feed, newest first; page with `nextCursor`. */
3428
+ list: (slug: string, query?: {
3429
+ limit?: number;
3430
+ before?: string;
3431
+ }) => Promise<ActivityFeedResponse>;
3432
+ };
3433
+ readonly waiting: {
3434
+ /** Approvals and agent drafts waiting on the caller. People only. */
3435
+ get: (slug: string) => Promise<WaitingResponse>;
3436
+ };
2898
3437
  readonly auth: {
2899
3438
  /** The principal behind the current credential. */
2900
3439
  me: () => Promise<CurrentUser>;
@@ -2954,4 +3493,4 @@ declare class TasqPolicyDeniedError extends TasqApiError {
2954
3493
  constructor(status: number, body: ErrorBody);
2955
3494
  }
2956
3495
 
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 };
3496
+ export { AGENT_ISOLATION_VALUES, AGENT_KEY_PREFIX, type ActionInputMap, type ActionName, type ActionWireOutputMap, type ActivityFeedActor, type ActivityFeedItem, type ActivityFeedResponse, type ActivityFeedSubject, 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 TaskCreator, 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 WaitingApproval, type WaitingDraft, type WaitingResponse, 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
  /**
@@ -337,6 +387,19 @@ var TasqClient = class _TasqClient {
337
387
  { unread: query.unread === true ? 1 : void 0 }
338
388
  )
339
389
  };
390
+ activity = {
391
+ /** The workspace activity feed, newest first; page with `nextCursor`. */
392
+ list: (slug, query = {}) => this.#get(
393
+ `/workspaces/${encodeURIComponent(slug)}/activity`,
394
+ { limit: query.limit, before: query.before }
395
+ )
396
+ };
397
+ waiting = {
398
+ /** Approvals and agent drafts waiting on the caller. People only. */
399
+ get: (slug) => this.#get(
400
+ `/workspaces/${encodeURIComponent(slug)}/waiting`
401
+ )
402
+ };
340
403
  auth = {
341
404
  /** The principal behind the current credential. */
342
405
  me: async () => (await this.#get("/auth/me")).user,
@@ -369,6 +432,11 @@ var TasqClient = class _TasqClient {
369
432
  };
370
433
 
371
434
  // src/types.ts
435
+ var PROJECT_HEALTH_VALUES = [
436
+ "on_track",
437
+ "at_risk",
438
+ "off_track"
439
+ ];
372
440
  var THREAD_CONTEXT_MESSAGE_LIMIT = 50;
373
441
  var THREAD_CONTEXT_ACTIVITY_LIMIT = 20;
374
442
  var THREAD_CONTEXT_DESCRIPTION_MAX = 8e3;
@@ -393,6 +461,7 @@ export {
393
461
  AGENT_KEY_PREFIX,
394
462
  MAX_AGENT_WAKES_PER_MESSAGE,
395
463
  MAX_CONSECUTIVE_AGENT_MESSAGES,
464
+ PROJECT_HEALTH_VALUES,
396
465
  RELEASE_CONTEXT_TASK_LIMIT,
397
466
  RELEASE_DISPOSITIONS,
398
467
  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\tActivityFeedResponse,\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\tWaitingResponse,\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 activity = {\n\t\t/** The workspace activity feed, newest first; page with `nextCursor`. */\n\t\tlist: (\n\t\t\tslug: string,\n\t\t\tquery: { limit?: number; before?: string } = {},\n\t\t): Promise<ActivityFeedResponse> =>\n\t\t\tthis.#get<ActivityFeedResponse>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/activity`,\n\t\t\t\t{ limit: query.limit, before: query.before },\n\t\t\t),\n\t};\n\n\treadonly waiting = {\n\t\t/** Approvals and agent drafts waiting on the caller. People only. */\n\t\tget: (slug: string): Promise<WaitingResponse> =>\n\t\t\tthis.#get<WaitingResponse>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/waiting`,\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\t/** Who created the task; null when that member has since been removed. */\n\tcreator: TaskCreator | null;\n\tlabels: TaskLabelRef[];\n};\n\nexport type TaskCreator = {\n\tmemberId: string;\n\tname: string | null;\n\tkind: \"user\" | \"agent\";\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\t/** The task's title when `taskId` is set. */\n\ttaskTitle: 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/** The linked comment as plain text, ~200 characters cut on a word. */\n\texcerpt: string | null;\n\t/** Set only on `approval_decided`: the decision that row announced. */\n\tdecision: \"approved\" | \"changes_requested\" | \"rejected\" | 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/** Who did something in the workspace activity feed. */\nexport type ActivityFeedActor = {\n\tmemberId: string | null;\n\tname: string;\n\tkind: \"user\" | \"agent\" | \"system\";\n};\n\n/** What an activity feed row is about. `key` is the task key on a task. */\nexport type ActivityFeedSubject = {\n\ttype: \"task\" | \"project\" | \"initiative\" | \"project_update\" | \"team\" | \"other\";\n\tid: string;\n\tkey: string | null;\n\ttitle: string;\n\tprojectId: string | null;\n};\n\n/**\n * One row of `GET /workspaces/:slug/activity`. `summary` is a verb phrase\n * with neither actor nor subject, so a row reads \"{actor} {summary} {subject}\".\n */\nexport type ActivityFeedItem = {\n\t/** `a:<activity id>` or `e:<event id>`. */\n\tid: string;\n\toccurredAt: string;\n\tactor: ActivityFeedActor;\n\tsummary: string;\n\tsubject: ActivityFeedSubject;\n};\n\n/** `GET /workspaces/:slug/activity`, newest first. */\nexport type ActivityFeedResponse = {\n\titems: ActivityFeedItem[];\n\tnextCursor: string | null;\n};\n\n/** An approval asked of the caller. */\nexport type WaitingApproval = {\n\ttaskId: string;\n\ttaskKey: string;\n\ttitle: string;\n\tprojectId: string | null;\n\tprojectName: string | null;\n\trequestedAt: string | null;\n\trequestedBy: {\n\t\tmemberId: string;\n\t\tname: string;\n\t\tkind: \"user\" | \"agent\";\n\t} | null;\n};\n\n/** An unsent agent draft on a project the caller leads. */\nexport type WaitingDraft = {\n\tupdateId: string;\n\tprojectId: string;\n\tprojectName: string;\n\thealth: ProjectHealth;\n\tbodyExcerpt: string;\n\tauthor: { memberId: string; name: string; kind: \"agent\" };\n\tcreatedAt: string;\n};\n\n/** `GET /workspaces/:slug/waiting` — people only. */\nexport type WaitingResponse = {\n\tapprovals: WaitingApproval[];\n\tdrafts: WaitingDraft[];\n\t/** Unsent agent-authored updates across the workspace, by agent member id. */\n\tdraftsByAgent: Record<string, 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":[]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@pxlabz/tasq-sdk",
3
- "version": "0.1.12",
3
+ "version": "0.1.14",
4
4
  "description": "Typed client for the Tasq API: tasks, projects, cycles, and agent actions",
5
5
  "keywords": [
6
6
  "tasq",